r5450 - in trunk/BOOK: . general/prog introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Tue Dec 20 06:28:57 PST 2005


Author: randy
Date: 2005-12-20 07:28:56 -0700 (Tue, 20 Dec 2005)
New Revision: 5450

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/prog/guile.xml
   trunk/BOOK/introduction/welcome/changelog.xml
Log:
Added documentation installation commands to the Guile instructions

Modified: trunk/BOOK/general/prog/guile.xml
===================================================================
--- trunk/BOOK/general/prog/guile.xml	2005-12-19 10:29:43 UTC (rev 5449)
+++ trunk/BOOK/general/prog/guile.xml	2005-12-20 14:28:56 UTC (rev 5450)
@@ -5,11 +5,11 @@
   %general-entities;
 
   <!ENTITY guile-download-http "http://ftp.gnu.org/pub/gnu/guile/guile-&guile-version;.tar.gz">
-  <!ENTITY guile-download-ftp "ftp://ftp.gnu.org/pub/gnu/guile/guile-&guile-version;.tar.gz">
-  <!ENTITY guile-md5sum "c2ff2a2231f0cbb2e838dd8701a587c5">
-  <!ENTITY guile-size "3.0 MB">
-  <!ENTITY guile-buildsize "37.4 MB">
-  <!ENTITY guile-time "0.86 SBU">
+  <!ENTITY guile-download-ftp  "ftp://ftp.gnu.org/pub/gnu/guile/guile-&guile-version;.tar.gz">
+  <!ENTITY guile-md5sum        "c2ff2a2231f0cbb2e838dd8701a587c5">
+  <!ENTITY guile-size          "3.0 MB">
+  <!ENTITY guile-buildsize     "37.4 MB (additional 32 MB to install all the docs)">
+  <!ENTITY guile-time          "0.9 SBU">
 ]>
 
 <sect1 id="guile" xreflabel="Guile-&guile-version;">
@@ -34,8 +34,8 @@
     <title>Introduction to Guile</title>
 
     <para>The <application>Guile</application> package contains the Project
-    GNU's extension language library. <application>Guile</application> also contains
-    a stand alone <application>Scheme</application> interpreter.</para>
+    GNU's extension language library. <application>Guile</application> also
+    contains a stand alone <application>Scheme</application> interpreter.</para>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
@@ -71,6 +71,11 @@
       </listitem>
     </itemizedlist>
 
+    <bridgehead renderas="sect3">Guile Dependencies</bridgehead>
+  
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="required"><xref linkend="tex"/></para>
+
   </sect2>
 
   <sect2 role="installation">
@@ -84,12 +89,51 @@
 ./configure --prefix=/usr &&
 make</userinput></screen>
 
+    <para>If you have <application>TeX</application> installed and wish to
+    build alternate formats of the documentation, issue the following
+    commands:</para>
+
+<screen><userinput>for DIRNAME in goops r5rs ref tutorial
+do
+  make -k -C doc/$DIRNAME pdf ps html
+done &&
+makeinfo --plaintext -o doc/goops/goops.txt doc/goops/goops.texi &&
+makeinfo --plaintext -o doc/r5rs/r5rs.txt doc/r5rs/r5rs.texi &&
+makeinfo --plaintext -o doc/ref/guile.txt doc/ref/guile.texi &&
+makeinfo --plaintext -o doc/tutorial/guile-tut.txt \
+    doc/tutorial/guile-tut.texi &&
+unset DIRNAME</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>
+<screen role="root"><userinput>make install &&
+find examples -name "Makefile*" -exec rm {} \; &&
+install -v -m755 -d /usr/share/doc/guile-&guile-version; &&
+cp -v -R examples /usr/share/doc/guile-&guile-version;</userinput></screen>
 
+    <para>If you built the alternate formats of the documentation, install it
+    using the following commands issued by the
+    <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>for DIRNAME in goops r5rs ref tutorial
+do
+  install -v -m755 -d /usr/share/doc/guile-&guile-version;/$DIRNAME/html
+  install -v -m644 doc/$DIRNAME/*.{pdf,ps,dvi,txt} \
+      /usr/share/doc/guile-&guile-version;/$DIRNAME
+  if [ -d doc/$DIRNAME/$DIRNAME.html ]; then
+    install -v -m644 doc/$DIRNAME/$DIRNAME.html/* \
+        /usr/share/doc/guile-&guile-version;/$DIRNAME/html
+  fi
+done &&
+
+install -v -m644 doc/goops/hierarchy.{eps,png} \
+    /usr/share/doc/guile-&guile-version;/goops &&
+install -v -m644 doc/ref/guile.html/* \
+    /usr/share/doc/guile-&guile-version;/ref/html &&
+install -v -m644 doc/tutorial/guile-tut.html/* \
+    /usr/share/doc/guile-&guile-version;/tutorial/html</userinput></screen>
   </sect2>
 
   <sect2 role="content">
@@ -106,7 +150,7 @@
         libguile-srfi-srfi-13-14-v-1.[so,a], libguile-srfi-srfi-4-v-1.[so,a], and
         optionally, libqthreads.[so,a]</seg>
         <seg>/usr/include/guile, /usr/include/guile-readline, /usr/include/libguile,
-        and /usr/share/guile</seg>
+        /usr/share/doc/guile-&guile-version;, and /usr/share/guile</seg>
       </seglistitem>
     </segmentedlist>
 

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2005-12-19 10:29:43 UTC (rev 5449)
+++ trunk/BOOK/general.ent	2005-12-20 14:28:56 UTC (rev 5450)
@@ -1,4 +1,4 @@
-<!ENTITY day          "19">
+<!ENTITY day          "20">
 <!ENTITY month        "12">
 <!ENTITY year         "2005">
 <!ENTITY version      "svn-&year;&month;&day;">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-12-19 10:29:43 UTC (rev 5449)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-12-20 14:28:56 UTC (rev 5450)
@@ -42,6 +42,16 @@
 -->
 
     <listitem>
+      <para>December 20th, 2005</para>
+      <itemizedlist>
+        <listitem>
+          <para>[randy] - Added documentation installation commands to the
+          Guile instructions.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>December 19th, 2005</para>
       <itemizedlist>
         <listitem>




More information about the blfs-book mailing list