[blfs-book] r9449 - in trunk/BOOK: general/genlib template

andy at linuxfromscratch.org andy at linuxfromscratch.org
Fri Feb 17 05:32:50 PST 2012


Author: andy
Date: 2012-02-17 06:32:38 -0700 (Fri, 17 Feb 2012)
New Revision: 9449

Modified:
   trunk/BOOK/general/genlib/pth.xml
   trunk/BOOK/template/README
Log:
Pth tweaks

Modified: trunk/BOOK/general/genlib/pth.xml
===================================================================
--- trunk/BOOK/general/genlib/pth.xml	2012-02-17 05:39:57 UTC (rev 9448)
+++ trunk/BOOK/general/genlib/pth.xml	2012-02-17 13:32:38 UTC (rev 9449)
@@ -4,8 +4,10 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-  <!ENTITY pth-download-http "http://ftp.gnu.org/gnu/pth/pth-&pth-version;.tar.gz">
-  <!ENTITY pth-download-ftp  "ftp://ftp.gnu.org/gnu/pth/pth-&pth-version;.tar.gz">
+  <!ENTITY pth-download-http
+  "http://ftp.gnu.org/gnu/pth/pth-&pth-version;.tar.gz">
+  <!ENTITY pth-download-ftp
+  "ftp://ftp.gnu.org/gnu/pth/pth-&pth-version;.tar.gz">
   <!ENTITY pth-md5sum        "9cb4a25331a4c4db866a31cbe507c793">
   <!ENTITY pth-size          "652 KB">
   <!ENTITY pth-buildsize     "5 MB">
@@ -62,7 +64,6 @@
 
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/pth"/></para>
-
   </sect2>
 
   <sect2 role="installation">
@@ -78,10 +79,11 @@
     <para>Install <application>Pth</application> by running the
     following commands:</para>
 
-<screen><userinput>./configure --prefix=/usr &&
+<screen><userinput>sed -i 's#$(LOBJS): Makefile#$(LOBJS): pth_p.h Makefile#' Makefile.in &&
+./configure --prefix=/usr --disable-static --mandir=/usr/share/man &&
 make</userinput></screen>
 
-    <para>To test the results, issue: <command>make check</command>.</para>
+    <para>To test the results, issue: <command>make test</command>.</para>
 
     <para>Now, as the <systemitem class="username">root</systemitem>
     user:</para>
@@ -90,7 +92,21 @@
 install -v -m755 -d /usr/share/doc/pth-&pth-version; &&
 install -v -m644    README PORTING SUPPORT TESTS \
                     /usr/share/doc/pth-&pth-version;</userinput></screen>
+  </sect2>
 
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><command>sed -i 's#$(LOBJS) ...</command>: This sed fixes a race
+    condition in the Makefile. It allows you to run <command>make</command> with
+    multiple jobs (eg, <command>make -j4</command>) <!-- how ironic that a
+    package for using multiple threads has this bug in its Makefile-->.</para>
+
+    <para><option>--disable-static</option>: This option stops it compiling a
+    static version of the library.</para>
+
+    <para><option>--mandir=/usr/share/man</option>: This option puts the man
+    pages in /usr/share/man and not /usr/man.</para>
   </sect2>
 
   <sect2 role="content">
@@ -103,7 +119,7 @@
 
       <seglistitem>
         <seg>pth-config</seg>
-        <seg>libpth.{so,a}</seg>
+        <seg>libpth.so</seg>
         <seg>/usr/share/doc/pth-&pth-version;</seg>
       </seglistitem>
     </segmentedlist>
@@ -127,18 +143,15 @@
       </varlistentry>
 
       <varlistentry id="libpth">
-        <term><filename class='libraryfile'>libpth.{so,a}</filename></term>
+        <term><filename class="libraryfile">libpth.so</filename></term>
         <listitem>
           <para>contains the API functions used by the GNU Portable Threads
           Library.</para>
           <indexterm zone="pth libpth">
-            <primary sortas="c-libpth">libpth.{so,a}</primary>
+            <primary sortas="c-libpth">libpth.so</primary>
           </indexterm>
         </listitem>
       </varlistentry>
-
     </variablelist>
-
   </sect2>
-
 </sect1>

Modified: trunk/BOOK/template/README
===================================================================
--- trunk/BOOK/template/README	2012-02-17 05:39:57 UTC (rev 9448)
+++ trunk/BOOK/template/README	2012-02-17 13:32:38 UTC (rev 9449)
@@ -5,3 +5,6 @@
 
 Makes a copy of the file and edit as needed.
 
+don't forget to:
+
+svn propset svn:keywords "LastChangedBy Date" path/to/new/page.xml




More information about the blfs-book mailing list