r7635 - in trunk/BOOK: . general/genlib general/sysutils introduction/welcome

ken at linuxfromscratch.org ken at linuxfromscratch.org
Sun Nov 30 11:10:23 PST 2008


Author: ken
Date: 2008-11-30 12:10:23 -0700 (Sun, 30 Nov 2008)
New Revision: 7635

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/genlib/dbus-bindings.xml
   trunk/BOOK/general/sysutils/dbus.xml
   trunk/BOOK/introduction/welcome/changelog.xml
Log:
dbus and dbus-glib.

Modified: trunk/BOOK/general/genlib/dbus-bindings.xml
===================================================================
--- trunk/BOOK/general/genlib/dbus-bindings.xml	2008-11-30 14:49:27 UTC (rev 7634)
+++ trunk/BOOK/general/genlib/dbus-bindings.xml	2008-11-30 19:10:23 UTC (rev 7635)
@@ -6,9 +6,9 @@
 
   <!ENTITY dbus-glib-download-http "http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-&dbus-glib-version;.tar.gz">
   <!ENTITY dbus-glib-download-ftp  " ">
-  <!ENTITY dbus-glib-md5sum        "0923d825a0aff2e4eb23338b630286fb">
-  <!ENTITY dbus-glib-size          "654 KB">
-  <!ENTITY dbus-glib-buildsize     "9 MB">
+  <!ENTITY dbus-glib-md5sum        "d3b716a7e798faa1c6a867675f00306a">
+  <!ENTITY dbus-glib-size          "652 KB">
+  <!ENTITY dbus-glib-buildsize     "9.1 MB">
   <!ENTITY dbus-glib-time          "0.2 SBU">
 
   <!ENTITY dbus-python-download-http "http://dbus.freedesktop.org/releases/dbus-python/dbus-python-&dbus-python-version;.tar.gz">

Modified: trunk/BOOK/general/sysutils/dbus.xml
===================================================================
--- trunk/BOOK/general/sysutils/dbus.xml	2008-11-30 14:49:27 UTC (rev 7634)
+++ trunk/BOOK/general/sysutils/dbus.xml	2008-11-30 19:10:23 UTC (rev 7635)
@@ -5,11 +5,12 @@
   %general-entities;
 
   <!ENTITY dbus-download-http "http://dbus.freedesktop.org/releases/dbus/dbus-&dbus-version;.tar.gz">
-  <!ENTITY dbus-download-ftp  "&gentoo-ftp-repo;/dbus-&dbus-version;.tar.gz">
-  <!ENTITY dbus-md5sum        "0552a9b54beb4a044951b7cdbc8fc855">
-  <!ENTITY dbus-size          "1.3 MB">
-  <!ENTITY dbus-buildsize     "39.5 MB (includes building and installing all docs)">
-  <!ENTITY dbus-time          "0.3 SBU (additional 0.7 SBU to run the test suite)">
+  <!--<!ENTITY dbus-download-ftp  "&gentoo-ftp-repo;/dbus-&dbus-version;.tar.gz">-->
+  <!ENTITY dbus-download-ftp  " ">
+  <!ENTITY dbus-md5sum        "2e643910a09f44b000a0d76038637999">
+  <!ENTITY dbus-size          "1.5 MB">
+  <!ENTITY dbus-buildsize     "24 MB">
+  <!ENTITY dbus-time          "0.5 SBU">
 ]>
 
 <sect1 id="dbus" xreflabel="D-BUS-&dbus-version;">
@@ -70,9 +71,8 @@
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional"><xref linkend="x-window-system"/>,
-    <xref linkend="doxygen"/> (to generate the API documentation), and
-    <ulink url="http://cyberelk.net/tim/xmlto/">xmlto</ulink>
-    (to generate HTML documentation and manuals)</para>
+    <xref linkend="doxygen"/> (to generate the API documentation)
+    </para>
 
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/dbus"/></para>
@@ -111,7 +111,7 @@
     will have to be built twice in this situation. If you would like to run
     the unit tests, issue the following commands:</para>
 
-<screen><userinput>./configure --enable-tests &&
+<screen><userinput>./configure --enable-tests --enable-asserts &&
 make &&
 make check &&
 make distclean</userinput></screen>
@@ -129,20 +129,15 @@
     <para>The <option>--enable-doxygen-docs</option> parameter does not work
     properly. If you have <application>Doxygen</application> installed and you
     wish to build the API documentation, issue
-    <command>doxygen</command>.</para>
+    <command>doxygen Doxyfile</command>.</para>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install &&
 install -v -m755 -d /usr/share/doc/dbus-&dbus-version; &&
-install -v -m644 doc/{TODO,*.{dtd,xml,xsl,txt,c}} \
-    /usr/share/doc/dbus-&dbus-version;</userinput></screen>
+install -v -m644 doc/{TODO,*.{dtd,html,xml,xsl,txt,c}} \
+    /usr/share/doc/dbus-&dbus-version; &&</userinput></screen>
 
-    <para>If you built the HTML documentation, install it by issuing the
-    following commands as the <systemitem class="username">root</systemitem> user:</para>
-
-<screen role="root"><userinput>install -v -m644 doc/*.html /usr/share/doc/dbus-&dbus-version;</userinput></screen>
-
     <para>If you built the API documentation, install it by issuing the
     following commands as the <systemitem class="username">root</systemitem> user:</para>
 
@@ -164,6 +159,19 @@
     instead of the <filename class="directory">/usr/var</filename>
     directory.</para>
 
+    <para><parameter>--enable-tests</parameter>: Build extra parts of the code
+    to support testing. Configure will end with a NOTE warning about this.</para>
+
+    <para><parameter>--enable-asserts</parameter>: Enable debugging code to run
+    assertions for statements normally assumed to be true. This prevents a
+    warning that '<parameter>--enable-tests</parameter>' on its own is only useful
+    for profiling and might not give true results for all tests, but adds its own
+    NOTE that this should not be used in a production build.
+    </para>
+
+    <para><parameter>--disable-static</parameter>: Prevent the static libraries
+    being built.</para>
+
   </sect2>
 
   <sect2 role="configuration">
@@ -220,6 +228,16 @@
 </busconfig></literal>
 EOF</userinput></screen>
 
+      <para>Many packages will refuse to run if the file
+      <literal>/var/lib/dbus/machine-id</literal> does not exist, and
+      complain that <application>dbus</application> has not been properly
+      installed. To prevent this, run the following command as the
+       <systemitem class="username">root</systemitem> user:</para>
+
+<screen><userinput>dbus-uuidgen --ensure</userinput></screen>
+
+      <para>This will create a unique identifier for the machine.</para>
+
     </sect3>
 
     <sect3  id="dbus-init">

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2008-11-30 14:49:27 UTC (rev 7634)
+++ trunk/BOOK/general.ent	2008-11-30 19:10:23 UTC (rev 7635)
@@ -123,7 +123,7 @@
 <!ENTITY iso-codes-version            "1.2">
 <!ENTITY gmime-version                "2.2.10">
 <!ENTITY libidn-version               "0.6.14">
-<!ENTITY dbus-glib-version            "0.74">
+<!ENTITY dbus-glib-version            "0.76">
 <!ENTITY dbus-python-version          "0.82.0">
 <!ENTITY dbus-qt3-version             "0.62">
 <!ENTITY libpthread-stubs-version     "0.1">
@@ -200,7 +200,7 @@
 <!ENTITY mc-version                   "4.6.1">
 <!ENTITY sysstat-version              "7.0.4">
 <!ENTITY apache-ant-version           "1.7.0">
-<!ENTITY dbus-version                 "1.0.2">
+<!ENTITY dbus-version                 "1.2.4">
 <!ENTITY hal-version                  "0.5.9.1">
 <!ENTITY unrar-version                "3.7.8">
 

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2008-11-30 14:49:27 UTC (rev 7634)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2008-11-30 19:10:23 UTC (rev 7635)
@@ -46,6 +46,9 @@
         <listitem>
           <para>[ken] - Update to libIDL-0.8.11.</para>
         </listitem>
+        <listitem>
+          <para>[ken] - Update to dbus-1.2.4 and dbus-glib-0.76.</para>
+        </listitem>
       </itemizedlist>
     </listitem>
 




More information about the blfs-book mailing list