[blfs-book] r11025 - in trunk/BOOK: . general/genlib general/sysutils introduction/welcome kde/core postlfs/filesystems postlfs/security

randy at higgs.linuxfromscratch.org randy at higgs.linuxfromscratch.org
Sun Feb 17 19:35:44 PST 2013


Author: randy
Date: Sun Feb 17 19:35:44 2013
New Revision: 11025

Log:
Minor fixes

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/genlib/libdbusmenuqt.xml
   trunk/BOOK/general/genlib/qca.xml
   trunk/BOOK/general/sysutils/redland.xml
   trunk/BOOK/general/sysutils/strigi.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/kde/core/akonadi.xml
   trunk/BOOK/kde/core/attica.xml
   trunk/BOOK/kde/core/kdelibs.xml
   trunk/BOOK/kde/core/oxygen-icons.xml
   trunk/BOOK/kde/core/polkit-qt.xml
   trunk/BOOK/kde/core/qimageblitz.xml
   trunk/BOOK/kde/core/shrdesktopontologies.xml
   trunk/BOOK/postlfs/filesystems/parted.xml
   trunk/BOOK/postlfs/security/polkit.xml

Modified: trunk/BOOK/general.ent
==============================================================================
--- trunk/BOOK/general.ent	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/general.ent	Sun Feb 17 19:35:44 2013	(r11025)
@@ -3,13 +3,13 @@
 $Date$
 -->
 
-<!ENTITY day          "13">                   <!-- Always 2 digits -->
+<!ENTITY day          "18">                   <!-- Always 2 digits -->
 <!ENTITY month        "02">                   <!-- Always 2 digits -->
 <!ENTITY year         "2013">
 <!ENTITY copyrightdate "2001-&year;">
 <!ENTITY copyholder   "The BLFS Development Team">
 <!ENTITY version      "&year;-&month;-&day;">
-<!ENTITY releasedate  "February 13th, &year;">
+<!ENTITY releasedate  "February 18th, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
 <!ENTITY lfs-version  "development">          <!-- version|testing|unstable|development] -->

Modified: trunk/BOOK/general/genlib/libdbusmenuqt.xml
==============================================================================
--- trunk/BOOK/general/genlib/libdbusmenuqt.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/general/genlib/libdbusmenuqt.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -29,8 +29,8 @@
   <sect2 role="package">
     <title>Introduction to libdbusmenu-qt</title>
 
-    <para>This library provides a Qt implementation of the DBusMenu specs which goal
-    is to expose menus on DBus.</para>
+    <para>This library provides a <application>Qt</application> implementation
+    of the DBusMenu specs, which goal is to expose menus on DBus.</para>
 
     &lfs72_checked;
 
@@ -95,6 +95,10 @@
       -DWITH_DOC=OFF .. &&
 make</userinput></screen>
 
+    <para>To test the results
+    (<ulink url="http://qjson.sourceforge.net/">Qjson</ulink> must be installed),
+    issue: <command>make check</command>.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
@@ -106,7 +110,7 @@
 
     <para><option>-DWITH_DOC=OFF</option>: This option is set to avoid building
     the API documentation. Omit it if you have <application>doxygen</application>
-    and want the documentation.</para>
+    installed and want the documentation.</para>
 
   </sect2>
 

Modified: trunk/BOOK/general/genlib/qca.xml
==============================================================================
--- trunk/BOOK/general/genlib/qca.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/general/genlib/qca.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -87,9 +87,12 @@
     commands:</para>
 
 <screen><userinput>sed -i '217s at set@this->set@' src/botantools/botan/botan/secmem.h &&
-./configure --prefix=&qt-dir; &&
+./configure --prefix=&qt-dir; \
+            --certstore-path=/etc/ssl/ca-bundle.crt &&
 make</userinput></screen>
 
+    <para>To test the results, issue <command>make test</command>.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
@@ -100,9 +103,13 @@
     <title>Command Explanations</title>
 
     <para><command>sed -i '217s at set@...</command>: This sed fixes compiling with
-    <application>GCC</application> 4.7. It is safe to omit when compiling with
+    <application>GCC</application> 4.7.x. It is safe to omit when compiling with
     older <application>GCC</application> versions.</para>
 
+    <para><parameter>--certstore-path=/etc/ssl/ca-bundle.crt</parameter>: Causes
+    the build to use the system-installed CA Certificates instead of a bundled
+    copy.</para>
+
   </sect2>
 
   <sect2 role="content">

Modified: trunk/BOOK/general/sysutils/redland.xml
==============================================================================
--- trunk/BOOK/general/sysutils/redland.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/general/sysutils/redland.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -90,6 +90,8 @@
 <screen><userinput>./configure --prefix=/usr --disable-static &&
 make</userinput></screen>
 
+    <para>To test the results, issue <command>make check</command>.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>

Modified: trunk/BOOK/general/sysutils/strigi.xml
==============================================================================
--- trunk/BOOK/general/sysutils/strigi.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/general/sysutils/strigi.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -94,6 +94,8 @@
 cmake -DCMAKE_INSTALL_PREFIX=/usr .. &&
 make</userinput></screen>
 
+    <para>To test the results, issue <command>make test</command>.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
@@ -109,9 +111,11 @@
       <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>deepfind, deepgrep, rdfindexer, strigiclient, strigicmd, strigidaemon and xmlindexer</seg>
-        <seg>libsearchclient.so, libstreamanalyzer.so, libstreams.so, libstrigihtmlgui.so,
-        libstrigiqtdbusclient.so and several in /usr/lib/strigi</seg>
+        <seg>deepfind, deepgrep, rdfindexer, strigiclient, strigicmd,
+        strigidaemon and xmlindexer</seg>
+        <seg>libsearchclient.so, libstreamanalyzer.so, libstreams.so,
+        libstrigihtmlgui.so, libstrigiqtdbusclient.so and several in
+        /usr/lib/strigi</seg>
         <seg>/usr/include/strigi, /usr/lib/strigi and /usr/share/strigi</seg>
       </seglistitem>
     </segmentedlist>

Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/introduction/welcome/changelog.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -45,6 +45,15 @@
 -->
 
     <listitem>
+      <para>February 18th, 2013</para>
+      <itemizedlist>
+        <listitem>
+          <para>[randy] - Minor fixes.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>February 13th, 2013</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/kde/core/akonadi.xml
==============================================================================
--- trunk/BOOK/kde/core/akonadi.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/kde/core/akonadi.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -74,9 +74,9 @@
     <xref linkend="automoc4"/>,
     <xref linkend="shared-mime-info"/>,
     <xref linkend="boost"/>,
-    <xref linkend="soprano"/> and one of:
+    <xref linkend="soprano"/>, and one of:
     <xref linkend="sqlite"/>,
-    <xref linkend="mysql"/> and
+    <xref linkend="mysql"/>, or
     <xref linkend="postgresql"/>
     </para>
 
@@ -100,6 +100,8 @@
       .. &&
 make</userinput></screen>
 
+    <para>To test the results,issue <command>make test</command>.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
@@ -113,11 +115,11 @@
     help <command>cmake</command> find <command>automoc4</command>.</para>
 
     <para><option>-DCMAKE_BUILD_TYPE=Release</option>: This switch is used to apply
-    higher level of compiler optimizations.</para>
+    a higher level of compiler optimizations.</para>
 
     <para><option>-DINSTALL_QSQLITE_IN_QT_PREFIX=TRUE</option>: This switch ensures
     that <application>Akonadi</application> SQLite extension is installed into
-    <application>Qt</application> plugins directory.</para>
+    the <application>Qt</application> plugins directory.</para>
 
   </sect2>
 

Modified: trunk/BOOK/kde/core/attica.xml
==============================================================================
--- trunk/BOOK/kde/core/attica.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/kde/core/attica.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -90,6 +90,8 @@
 cmake -DCMAKE_INSTALL_PREFIX=&kde-dir; .. &&
 make</userinput></screen>
 
+    <para>To test the results, issue <command>make test</command>.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>

Modified: trunk/BOOK/kde/core/kdelibs.xml
==============================================================================
--- trunk/BOOK/kde/core/kdelibs.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/kde/core/kdelibs.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -121,9 +121,10 @@
     <para>Fix file conflicts with <application>GNOME Menus</application> by running
     the following commands:</para>
 
-<screen><userinput>sed -e "s@{SYSCONF_INSTALL_DIR}/xdg/menus@& RENAME kde-applications.menu at g" \
-    -i kded/CMakeLists.txt &&
-sed -i "s at applications.menu@kde-&@g" kded/kbuildsycoca.cpp</userinput></screen>
+<screen><userinput>sed -i "s@{SYSCONF_INSTALL_DIR}/xdg/menus@& RENAME kde-applications.menu@" \
+        kded/CMakeLists.txt &&
+sed -i "s at applications.menu@kde-&@" \
+        kded/kbuildsycoca.cpp</userinput></screen>
 
     <para>Install <application>Kdelibs</application> by running the following
     commands:</para>
@@ -139,10 +140,16 @@
       .. &&
 make</userinput></screen>
 
+    <para>The unit regression tests are designed to be run after
+    <application>kdelibs</application> is installed.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
+  <para>To run the unit regression tests, you must have a current KDE session
+  running and issue <command>make test</command>.</para>
+
   </sect2>
 
   <sect2 role="commands">

Modified: trunk/BOOK/kde/core/oxygen-icons.xml
==============================================================================
--- trunk/BOOK/kde/core/oxygen-icons.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/kde/core/oxygen-icons.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -78,6 +78,10 @@
 cd build &&
 cmake -DCMAKE_INSTALL_PREFIX=&kde-dir; ..</userinput></screen>
 
+    <para>
+      This package does not come with a test suite.
+    </para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>

Modified: trunk/BOOK/kde/core/polkit-qt.xml
==============================================================================
--- trunk/BOOK/kde/core/polkit-qt.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/kde/core/polkit-qt.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -90,6 +90,10 @@
       cmake -DCMAKE_INSTALL_PREFIX=&kde-dir; .. &&
 make</userinput></screen>
 
+    <para>
+      This package does not come with a test suite.
+    </para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
@@ -99,7 +103,8 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><option>CMAKE_PREFIX_PATH=&qt-dir;</option>: This option is set to find automoc4</para>
+    <para><option>CMAKE_PREFIX_PATH=&qt-dir;</option>: This option is set to
+    find <command>automoc4</command>.</para>
 
   </sect2>
 

Modified: trunk/BOOK/kde/core/qimageblitz.xml
==============================================================================
--- trunk/BOOK/kde/core/qimageblitz.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/kde/core/qimageblitz.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -70,7 +70,8 @@
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-    <xref linkend="qt"/>
+    <xref linkend="qt"/> and
+    <xref linkend="cmake"/>
     </para>
 
     <para condition="html" role="usernotes">User Notes:
@@ -89,6 +90,10 @@
 cmake -DCMAKE_INSTALL_PREFIX=&kde-dir; .. &&
 make</userinput></screen>
 
+    <para>
+      This package does not come with a test suite.
+    </para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
@@ -137,4 +142,3 @@
   </sect2>
 
 </sect1>
-

Modified: trunk/BOOK/kde/core/shrdesktopontologies.xml
==============================================================================
--- trunk/BOOK/kde/core/shrdesktopontologies.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/kde/core/shrdesktopontologies.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -29,9 +29,10 @@
   <sect2 role="package">
     <title>Introduction to Shared-Desktop-Ontologies</title>
 
-    <para>The Shared desktop ontologies provide RDF vocabularies for the Semantic Desktop.
-    This includes basic ontologies like RDF and RDFS and all the Nepomuk ontologies like NRL,
-    NIE, or NFO which are also maintained and developed in this open-source project.</para>
+    <para>The Shared desktop ontologies provide RDF vocabularies for the
+    Semantic Desktop. This includes basic ontologies like RDF and RDFS and all
+    the Nepomuk ontologies like NRL, NIE, and NFO, which are also maintained
+    and developed in this open-source project.</para>
 
     &lfs72_checked;
 
@@ -57,37 +58,12 @@
       </listitem>
     </itemizedlist>
 
-<!--
-    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
-    <itemizedlist spacing='compact'>
-      <listitem>
-        <para>Required patch: <ulink
-        url="&patch-root;/shared-desktop-ontologies-&shared-desktop-ontologies-version;-fixes-1.patch"/></para>
-      </listitem>
-    </itemizedlist>
--->
-<!--
     <bridgehead renderas="sect3">Shared-desktop-ontologies Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-    <xref linkend="docbook-xsl"/>,
-    </para>
-
-
-    <bridgehead renderas="sect4">Recommended</bridgehead>
-    <para role="recommended">
-    <xref linkend="xine-lib"/>,
-    <xref linkend="gstreamer"/>
-    </para>
-
-    <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional">
-      <xref linkend='pulseaudio'/>
+      <xref linkend="cmake"/>
     </para>
--->
-
-
 
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/shared-desktop-ontologies"/></para>
@@ -97,26 +73,23 @@
   <sect2 role="installation">
     <title>Installation of Shared-desktop-ontologies</title>
 
-    <para>Install <application>Shared-desktop-ontologies</application> by running the following
-    commands:</para>
+    <para>Install <application>Shared-desktop-ontologies</application> by
+    running the following commands:</para>
 
 <screen><userinput>mkdir build &&
 cd build &&
 cmake -DCMAKE_INSTALL_PREFIX=&kde-dir; ..</userinput></screen>
 
+    <para>
+      This package does not come with a test suite.
+    </para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install</userinput></screen>
 
   </sect2>
-<!--
-  <sect2 role="commands">
-    <title>Command Explanations</title>
 
-    <para><option>- -xyz</option>: This option is set for ...</para>
-
-  </sect2>
--->
   <sect2 role="content">
     <title>Contents</title>
 
@@ -128,28 +101,10 @@
       <seglistitem>
         <seg>none</seg>
         <seg>none</seg>
-        <seg>&kde-dir;/share/ontology</seg>
+        <seg>&kde-dir;/share/ontology and
+        &kde-dir;/share/cmake/SharedDesktopOntologies</seg>
       </seglistitem>
     </segmentedlist>
-<!--
-    <variablelist>
-      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
-      <?dbfo list-presentation="list"?>
-      <?dbhtml list-presentation="table"?>
-
-      <varlistentry id="blitztest">
-        <term><command>blitztest</command></term>
-        <listitem>
-          <para>is a testing utility for shared-desktop-ontologies.</para>
-          <indexterm zone="shared-desktop-ontologies blitztest">
-            <primary sortas="b-blitztest">blitztest</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-    </variablelist>
--->
   </sect2>
 
 </sect1>
-

Modified: trunk/BOOK/postlfs/filesystems/parted.xml
==============================================================================
--- trunk/BOOK/postlfs/filesystems/parted.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/postlfs/filesystems/parted.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -81,7 +81,18 @@
     </para>
 
 <screen><userinput>./configure --prefix=/usr --disable-static &&
-make</userinput></screen>
+make &&
+
+make -C doc html                                       &&
+makeinfo --html      -o doc/html       doc/parted.texi &&
+makeinfo --plaintext -o doc/parted.txt doc/parted.texi</userinput></screen>
+
+    <para>If you have <xref linkend="texlive"/> installed and wish to create
+    PDF and Postcript documentation issue the following commands:</para>
+
+<screen><userinput>texi2pdf             -o doc/parted.pdf doc/parted.texi &&
+texi2dvi             -o doc/parted.dvi doc/parted.texi &&
+dvips                -o doc/parted.ps  doc/parted.dvi</userinput></screen>
 
     <para>To test the results, issue: <command>make check</command>.</para>
 
@@ -89,7 +100,19 @@
       Now, as the <systemitem class="username">root</systemitem> user:
     </para>
 
-<screen role="root"><userinput>make install</userinput></screen>
+<screen role="root"><userinput>make install &&
+install -v -m755 -d /usr/share/doc/${PACKAGE_NAME}-${PACKAGE_VERSION}/html &&
+install -v -m644    doc/html/* \
+                    /usr/share/doc/${PACKAGE_NAME}-${PACKAGE_VERSION}/html &&
+install -v -m644    doc/{FAT,API,parted.{txt,html}} \
+                    /usr/share/doc/${PACKAGE_NAME}-${PACKAGE_VERSION</userinput></screen>
+
+    <para>Install the optional PDF and Postscript documentation by issuing
+    the following command as the <systemitem class="username">root</systemitem>
+    user:</para>
+
+<screen role="root"><userinput>install -v -m644 doc/FAT doc/API doc/parted.{pdf,ps,dvi} \
+                    /usr/share/doc/${PACKAGE_NAME}-${PACKAGE_VERSION}</userinput></screen>
   </sect2>
 
   <sect2 role="commands">

Modified: trunk/BOOK/postlfs/security/polkit.xml
==============================================================================
--- trunk/BOOK/postlfs/security/polkit.xml	Wed Feb 13 15:00:45 2013	(r11024)
+++ trunk/BOOK/postlfs/security/polkit.xml	Sun Feb 17 19:35:44 2013	(r11025)
@@ -32,8 +32,8 @@
 
     <para>
       <application>Polkit</application> is a toolkit for defining and handling
-      authorizations. It is used for allowing unprivileged processes to speak
-      to privileged processes.
+      authorizations. It is used for allowing unprivileged processes to
+      comminicate with privileged processes.
     </para>
 
     &lfs72_checked;
@@ -101,7 +101,7 @@
 
     <note>
       <para>
-        If <xref linkend="libxslt"/> is installed then <xref linkend="DocBook"/>
+        If <xref linkend="libxslt"/> is installed, then <xref linkend="DocBook"/>
         and <xref linkend="docbook-xsl"/> are required. If you have installed
         <xref linkend="libxslt"/>, but you do not want to install any of the
         DocBook packages mentioned, you will need to use
@@ -191,12 +191,9 @@
       <para>
         If you have built <application>Polkit</application> with
         <application>Linux PAM</application> support, you need to modify
-        default PAM configuration file which was installed by default to get
-        <application>Polkit</application> to work correctly with BLFS.
-      </para>
-
-      <para>
-        Issue the following commands as the <systemitem class="username">root</systemitem>
+        the default PAM configuration file which was installed by default to get
+        <application>Polkit</application> to work correctly with BLFS. Issue the
+        following commands as the <systemitem class="username">root</systemitem>
         user to create the configuration file for <application>Linux PAM</application>:
       </para>
 



More information about the blfs-book mailing list