[blfs-book] r10326 - in trunk/BOOK: general/genlib general/prog introduction/welcome

andy at linuxfromscratch.org andy at linuxfromscratch.org
Wed Jun 13 05:23:53 PDT 2012


Author: andy
Date: 2012-06-13 06:23:48 -0600 (Wed, 13 Jun 2012)
New Revision: 10326

Modified:
   trunk/BOOK/general/genlib/libatomic_ops.xml
   trunk/BOOK/general/prog/gc.xml
   trunk/BOOK/introduction/welcome/changelog.xml
Log:
gc-7.2

Modified: trunk/BOOK/general/genlib/libatomic_ops.xml
===================================================================
--- trunk/BOOK/general/genlib/libatomic_ops.xml	2012-06-13 11:31:48 UTC (rev 10325)
+++ trunk/BOOK/general/genlib/libatomic_ops.xml	2012-06-13 12:23:48 UTC (rev 10326)
@@ -79,6 +79,7 @@
 <screen><userinput>sed -i 's#AC_PROG_RANLIB#AC_LIBTOOL_DLOPEN\nAC_PROG_LIBTOOL#' configure.ac &&
 sed -i 's#b_L#b_LTL#;s#\.a#.la#g;s#_a_#_la_#' src/Makefile.am &&
 sed -i 's#\.a#.so#g;s#\.\./src/#../src/.libs/#g' tests/Makefile.am &&
+sed -i 's#pkgdata#doc#' doc/Makefile.am &&
 autoreconf -i &&
 ./configure --prefix=/usr --disable-static \
   --docdir=/usr/share/doc/libatomic_ops-&libatomic_ops-version; &&
@@ -98,7 +99,8 @@
 
     <para>
       <command>sed -i 's#AC_PROG_RANLIB ...</command>: These seds massage the
-      autotool files so that a shared library is built and the tests pass.
+      autotool files so that a shared library is built, the tests pass and the
+      docs are installed where we want.
     </para>
 
     <para>

Modified: trunk/BOOK/general/prog/gc.xml
===================================================================
--- trunk/BOOK/general/prog/gc.xml	2012-06-13 11:31:48 UTC (rev 10325)
+++ trunk/BOOK/general/prog/gc.xml	2012-06-13 12:23:48 UTC (rev 10326)
@@ -4,10 +4,11 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-  <!ENTITY gc-download-http "http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc-&gc-version;.tar.gz">
+  <!ENTITY gc-download-http
+    "http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc-&gc-version;.tar.gz">
   <!ENTITY gc-download-ftp  "&gentoo-ftp-repo;/gc-&gc-version;.tar.gz">
-  <!ENTITY gc-md5sum        "2ff9924c7249ef7f736ecfe6f08f3f9b">
-  <!ENTITY gc-size          "1 MB">
+  <!ENTITY gc-md5sum        "d17aecedef3d73e75387fb63558fa4eb">
+  <!ENTITY gc-size          "1.3 MB">
   <!ENTITY gc-buildsize     "13 MB">
   <!ENTITY gc-time          "0.2 SBU">
 ]>
@@ -29,20 +30,21 @@
   <sect2 role="package">
     <title>Introduction to GC</title>
 
-    <para>The <application>GC</application> package contains the
-    Boehm-Demers-Weiser conservative garbage collector, which can be used as a
-    garbage collecting replacement for the C malloc function or C++ new
-    operator. It allows you to allocate memory basically as you normally would,
-    without explicitly deallocating memory that is no longer useful. The
-    collector automatically recycles memory when it determines that it can no
-    longer be otherwise accessed. The collector is also used by a number of
-    programming language implementations that either use C as intermediate
-    code, want to facilitate easier interoperation with C libraries, or just
-    prefer the simple collector interface. Alternatively, the garbage collector
-    may be used as a leak detector for C or C++ programs, though that is not
-    its primary goal.</para>
+    <para>
+      The <application>GC</application> package contains the Boehm-Demers-Weiser
+      conservative garbage collector, which can be used as a garbage collecting
+      replacement for the C malloc function or C++ new operator. It allows you
+      to allocate memory basically as you normally would, without explicitly
+      deallocating memory that is no longer useful. The collector automatically
+      recycles memory when it determines that it can no longer be otherwise
+      accessed. The collector is also used by a number of programming language
+      implementations that either use C as intermediate code, want to facilitate
+      easier interoperation with C libraries, or just prefer the simple
+      collector interface. Alternatively, the garbage collector may be used as a
+      leak detector for C or C++ programs, though that is not its primary goal.
+    </para>
 
-    &lfs70_checked;
+    &lfs71_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
@@ -66,58 +68,77 @@
       </listitem>
     </itemizedlist>
 
-    <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gc"/></para>
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="libatomic_ops"/> (Gc contains a copy of
+      Libatomic_ops-&gc-version; which it will compile and statically link if
+      configure doesn't find Libatomic_ops installed on your system).
+    </para>
 
+    <para condition="html" role="usernotes">
+      User Notes: <ulink url="&blfs-wiki;/gc"/>
+    </para>
   </sect2>
 
   <sect2 role="installation">
     <title>Installation of GC</title>
 
-    <para>Install <application>GC</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>GC</application> by running the following commands:
+    </para>
 
-<screen><userinput>./configure --prefix=/usr            \
-            --datadir=/usr/share/doc \
-            --enable-cplusplus &&
+<screen><userinput>sed -i 's#pkgdata#doc#' doc/doc.am && autoreconf  &&
+./configure --prefix=/usr --enable-cplusplus      \
+  --disable-static --docdir=/usr/share/doc/gc-&gc-version; &&
 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>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install &&
 install -v -m644 doc/gc.man /usr/share/man/man3/gc_malloc.3 &&
-ln -v -s gc_malloc.3 /usr/share/man/man3/gc.3 </userinput></screen>
-
+ln -sfv gc_malloc.3 /usr/share/man/man3/gc.3 </userinput></screen>
   </sect2>
 
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><parameter>--datadir=/usr/share/doc</parameter>: This parameter
-    changes the installation path of the documentation to
-    <filename class='directory'>/usr/share/doc/gc</filename> instead of
-    <filename class='directory'>/usr/share/gc</filename>.</para>
+    <para>
+      <command>sed -i 's#pkgdata#doc#' doc/doc.am</command>,
+      <command>autoreconf</command> and
+      <option>--docdir=/usr/share/doc/gc-&gc-version;</option>: These commands
+      allow us to install the documentation in a versioned directory.
+    </para>
 
-    <para><parameter>--enable-cplusplus</parameter>: This parameter forces
-    the building and installation of the C++ library along with the standard
-    C library.</para>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/static-libraries.xml"/>
 
+    <para>
+      <parameter>--enable-cplusplus</parameter>: This parameter enables the
+      building and installing the C++ library along with the standard C library.
+    </para>
   </sect2>
 
   <sect2 role="content">
     <title>Contents</title>
 
     <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
       <segtitle>Installed Libraries</segtitle>
       <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>None</seg>
-        <seg>libcord.{a,so}, libgc.{so,a}, and libgccpp.{so,a}</seg>
-        <seg>/usr/include/gc and /usr/share/doc/gc</seg>
+        <seg>
+          libcord.so,
+          libgc.so and
+          libgccpp.so
+        </seg>
+        <seg>
+          /usr/include/gc and
+          /usr/share/doc/gc
+        </seg>
       </seglistitem>
     </segmentedlist>
 
@@ -127,29 +148,29 @@
       <?dbhtml list-presentation="table"?>
 
       <varlistentry id="libgc">
-        <term><filename class='libraryfile'>libgc.{so,a}</filename></term>
+        <term><filename class='libraryfile'>libgc.so</filename></term>
         <listitem>
-          <para>contains a C interface to the conservative garbage collector,
-          primarily designed to replace the C malloc function.</para>
+          <para>
+            contains a C interface to the conservative garbage collector,
+            primarily designed to replace the C malloc function.
+          </para>
           <indexterm zone="gc libgc">
-            <primary sortas="c-libgc">libgc.{so,a}</primary>
+            <primary sortas="c-libgc">libgc.so</primary>
           </indexterm>
         </listitem>
       </varlistentry>
 
       <varlistentry id="libgccpp">
-        <term><filename class='libraryfile'>libgccpp.{so,a}</filename></term>
+        <term><filename class='libraryfile'>libgccpp.so</filename></term>
         <listitem>
-          <para>contains a C++ interface to the conservative garbage
-          collector.</para>
+          <para>
+            contains a C++ interface to the conservative garbage collector.
+          </para>
           <indexterm zone="gc libgccpp">
-            <primary sortas="c-libgccpp">libgccpp.{so,a}</primary>
+            <primary sortas="c-libgccpp">libgccpp.so</primary>
           </indexterm>
         </listitem>
       </varlistentry>
-
     </variablelist>
-
   </sect2>
-
 </sect1>

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2012-06-13 11:31:48 UTC (rev 10325)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2012-06-13 12:23:48 UTC (rev 10326)
@@ -47,6 +47,9 @@
         <listitem>
           <para>[abenton] - Updated Libatomic_Ops to 7.2.</para>
         </listitem>
+        <listitem>
+          <para>[abenton] - Updated Gc to 7.2.</para>
+        </listitem>
       </itemizedlist>
     </listitem>
 




More information about the blfs-book mailing list