Changeset d3970e1 for general/prog/dejagnu.xml

Timestamp:

03/03/2013 04:59:09 PM (11 years ago)

Author:

Randy McMurchy <randy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

af373d35

Parents:

fdb847da

Message:

Minor cleanup and tweaks to Programming packages

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11050 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• general/prog/dejagnu.xml (modified) (4 diffs)

general/prog/dejagnu.xml

@@ -31 +31 @@
     <title>Introduction to DejaGnu</title>
 
-    <para><application>DejaGnu</application> is a framework for running test
-    suites on GNU tools. It is written in <command>expect</command>, which
-    uses <application>Tcl</application> (Tool command language). It was installed
-    by LFS in the temprary /tools directory.  These instructions install it
-    permanently.</para>
+    <para>
+      <application>DejaGnu</application> is a framework for running test
+      suites on GNU tools. It is written in <command>expect</command>, which
+      uses <application>Tcl</application> (Tool command language). It was installed
+      by LFS in the temporary <filename class="directory">/tools</filename>
+      directory.  These instructions install it permanently.
+    </para>
 
     &lfs72_checked;
@@ -64 +66 @@
 
     <bridgehead renderas="sect4">Required (Run-time Only)</bridgehead>
-    <para role="required"><xref linkend="expect"/></para>
+    <para role="required">
+      <xref linkend="expect"/>
+    </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><xref linkend="docbook-utils"/></para>
+    <para role="optional">
+      <xref linkend="docbook-utils"/> and
+      <ulink url="http://sourceforge.net/projects/docbook2x/">docbook2X</ulink>
+      (both looked for by the <command>configure</command> script but not used
+      in the build)
+    </para>
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/dejagnu"/></para>
-
+      <ulink url="&blfs-wiki;/dejagnu"/>
+    </para>
   </sect2>
 
@@ -77 +86 @@
     <title>Installation of DejaGnu</title>
 
-    <para>Install <application>DejaGnu</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>DejaGnu</application> by running the following
+      commands:
+    </para>
 
-<screen><userinput>./configure --prefix=/usr</userinput></screen>
+<screen><userinput>./configure --prefix=/usr &amp;&amp;
+makeinfo --html --no-split -o doc/dejagnu.html doc/dejagnu.texi &amp;&amp;
+makeinfo --plaintext       -o doc/dejagnu.txt  doc/dejagnu.texi</userinput></screen>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      HTML and text documentation was created in the previous step. There
+      are different ways to create additional forms of documentation, if desired.
+      If you have <xref linkend="texlive"/> installed, create PDF and Postscript
+      docs in the <filename class="directory">doc</filename> directory by issuing
+      <command>make pdf ps</command>. If you have <xref linkend="docbook-utils"/>
+      installed, create PDF and Postscript docs in the top-level directory
+      by issuing <command>make dejagnu.{pdf,ps}</command>.
+    </para>
 
-<screen role="root"><userinput>make install</userinput></screen>
+    <para>
+      To test the results, issue <command>make check</command>.
+    </para>
 
-    <para>To test the installation, issue <command>make check</command> as
-    an unprivileged user.</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
+<screen role="root"><userinput>make install &amp;&amp;
+install -v -m755 -d /usr/share/doc/dejagnu-&dejagnu-version; &amp;&amp;
+install -v -m644    doc/dejagnu.{html,txt} \
+                    /usr/share/doc/dejagnu-&dejagnu-version;</userinput></screen>
   </sect2>
 
@@ -117 +145 @@
         <term><command>runtest</command></term>
         <listitem>
-          <para>is the <application>DejaGnu</application> test driver program. It is
-          used to control what tests to run, and variations on how to run them.</para>
+          <para>
+            is the <application>DejaGnu</application> test driver program. It is
+            used to control what tests to run, and variations on how to run them.
+          </para>
           <indexterm zone="dejagnu runtest">
             <primary sortas="b-runtest">runtest</primary>