r5292 - in trunk/BOOK: . basicnet/textweb general/prog introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Mon Nov 21 16:30:37 PST 2005


Author: randy
Date: 2005-11-21 17:30:30 -0700 (Mon, 21 Nov 2005)
New Revision: 5292

Added:
   trunk/BOOK/general/prog/gc.xml
Modified:
   trunk/BOOK/basicnet/textweb/w3m.xml
   trunk/BOOK/general.ent
   trunk/BOOK/general/prog/prog.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
Log:
Added new package GC-6.5

Modified: trunk/BOOK/basicnet/textweb/w3m.xml
===================================================================
--- trunk/BOOK/basicnet/textweb/w3m.xml	2005-11-21 20:46:15 UTC (rev 5291)
+++ trunk/BOOK/basicnet/textweb/w3m.xml	2005-11-22 00:30:30 UTC (rev 5292)
@@ -57,8 +57,7 @@
     <bridgehead renderas="sect3">W3m Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
-    <para><ulink
-    url="http://www.hpl.hp.com/personal/Hans_Boehm/gc/">GC</ulink></para>
+    <para><xref linkend="gc"/></para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para><xref linkend="pkgconfig"/>,

Added: trunk/BOOK/general/prog/gc.xml
===================================================================
--- trunk/BOOK/general/prog/gc.xml	2005-11-21 20:46:15 UTC (rev 5291)
+++ trunk/BOOK/general/prog/gc.xml	2005-11-22 00:30:30 UTC (rev 5292)
@@ -0,0 +1,155 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+  <!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-ftp  "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/gc&gc-version;.tar.gz">
+  <!ENTITY gc-md5sum        "00bf95cdcbedfa7321d14e0133b31cdb">
+  <!ENTITY gc-size          "752 KB">
+  <!ENTITY gc-buildsize     "7.6 MB">
+  <!ENTITY gc-time          "0.2 SBU">
+]>
+
+<sect1 id="gc" xreflabel="GC-&gc-version;">
+  <?dbhtml filename="gc.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>GC-&gc-version;</title>
+
+  <indexterm zone="gc">
+    <primary sortas="a-GC">GC</primary>
+  </indexterm>
+
+  <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>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&gc-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&gc-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &gc-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &gc-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &gc-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &gc-time;</para>
+      </listitem>
+    </itemizedlist>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of GC</title>
+
+    <para>Install <application>GC</application> by running the following
+    commands:</para>
+
+<screen><userinput>sed -i "s|\$(datadir)/@PACKAGE@|&-6.5|" doc/Makefile.in &&
+./configure --prefix=/usr \
+    --datadir=/usr/share/doc --enable-cplusplus &&
+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 &&
+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>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><command>sed -i "s|\$(datadir)/@PACKAGE@|&-6.5|" ...</command>:
+    This command appends <quote>-6.5</quote> to the default documentation
+    installation path of
+    <filename class='directory'>/usr/share/doc/gc</filename>.</para>
+
+    <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><parameter>--enable-cplusplus</parameter>: This parameter forces
+    the building and installation of 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>libgc.[so,a] and libgccpp.[so,a]</seg>
+        <seg>/usr/include/gc and /usr/share/doc/gc-&gc-version;</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="libgc">
+        <term><filename class='libraryfile'>libgc.[so,a]</filename></term>
+        <listitem>
+          <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>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libgccpp">
+        <term><filename class='libraryfile'>libgccpp.[so,a]</filename></term>
+        <listitem>
+          <para>contains a C++ interface to the conservative garbage
+          collector.</para>
+          <indexterm zone="gc libgccpp">
+            <primary sortas="c-libgccpp">libgccpp.[so,a]</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/general/prog/gc.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/general/prog/prog.xml
===================================================================
--- trunk/BOOK/general/prog/prog.xml	2005-11-21 20:46:15 UTC (rev 5291)
+++ trunk/BOOK/general/prog/prog.xml	2005-11-22 00:30:30 UTC (rev 5292)
@@ -20,6 +20,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dejagnu.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="doxygen.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="expect.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gc.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc3.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="guile.xml"/>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2005-11-21 20:46:15 UTC (rev 5291)
+++ trunk/BOOK/general.ent	2005-11-22 00:30:30 UTC (rev 5292)
@@ -1,8 +1,8 @@
-<!ENTITY day          "21">
+<!ENTITY day          "22">
 <!ENTITY month        "11">
 <!ENTITY year         "2005">
 <!ENTITY version      "svn-&year;&month;&day;">
-<!ENTITY releasedate  "November &day;st, &year;">
+<!ENTITY releasedate  "November &day;nd, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
 <!ENTITY lfs-version  "development">          <!-- version|stable|testing|unstable|development] -->
@@ -146,6 +146,7 @@
 <!ENTITY dejagnu-version              "1.4.4">
 <!ENTITY doxygen-version              "1.4.4">
 <!ENTITY expect-version               "5.43.0">
+<!ENTITY gc-version                   "6.5">
 <!ENTITY gcc-version                  "4.0.1">
 <!ENTITY gcc3-version                 "3.3.6">
 <!ENTITY guile-version                "1.6.7">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-11-21 20:46:15 UTC (rev 5291)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-11-22 00:30:30 UTC (rev 5292)
@@ -42,6 +42,15 @@
 -->
 
     <listitem>
+      <para>November 22nd, 2005</para>
+      <itemizedlist>
+        <listitem>
+          <para>[randy] - Added new package GC-6.5.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>November 21st, 2005</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2005-11-21 20:46:15 UTC (rev 5291)
+++ trunk/BOOK/introduction/welcome/credits.xml	2005-11-22 00:30:30 UTC (rev 5292)
@@ -217,13 +217,13 @@
         <para>ALSA Tools, Apache Ant, cairo, Cyrus-SASL, D-BUS, DejaGnu,
         desktop-file-utils, DocBook DSSSL Stylesheets, DocBook-utils, Ethereal,
         Evince, Evolution Data Server, Exim (many additions), Expect, FOP,
-        FreeTTS, FriBidi, GCC (rewrite), GMime, gnome-audio, gnome-backgrounds,
-        gnome-menus, gnome-volume-manager, GNOME Doc Utils,
-        GNOME Keyring Manager, GnuCash (many
-        additions), HAL, Heimdal, HTML Tidy, ISO Codes, JadeTeX, Java Access
-        Bridge, LessTif (rewrite), libexif, libgail-gnome, libgnomecups,
-        libmpeg2, libmusicbrainz, MPlayer (extensive overhaul), Other
-        Programming Tools, PDL, Perl Modules, pilot-link, Poppler, PyXML,
+        FreeTTS, FriBidi, GC, GCC (rewrite), GMime, gnome-audio,
+        gnome-backgrounds, gnome-menus, gnome-volume-manager, GNOME Doc Utils,
+        GNOME Keyring Manager, GnuCash (many additions), HAL, Heimdal,
+        HTML Tidy, ISO Codes, JadeTeX, Java Access Bridge, LessTif (rewrite),
+        libexif, libgail-gnome, libgnomecups, libmpeg2, libmusicbrainz,
+        MPlayer (extensive overhaul), Other Programming Tools, PDL,
+        Perl Modules, pilot-link, Poppler, PyXML,
         Samba 3 (many additions), SANE (original instructions by Alex Kloss),
         Shadow (rewrite), SLIB, Sound Juicer, Stunnel, Sysstat,
         system-tools-backends, Totem and unixODBC:




More information about the blfs-book mailing list