Changeset d3970e1


Ignore:
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

Location:
general/prog
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • general/prog/dejagnu.xml

    rfdb847da rd3970e1  
    3131    <title>Introduction to DejaGnu</title>
    3232
    33     <para><application>DejaGnu</application> is a framework for running test
    34     suites on GNU tools. It is written in <command>expect</command>, which
    35     uses <application>Tcl</application> (Tool command language). It was installed
    36     by LFS in the temprary /tools directory.  These instructions install it
    37     permanently.</para>
     33    <para>
     34      <application>DejaGnu</application> is a framework for running test
     35      suites on GNU tools. It is written in <command>expect</command>, which
     36      uses <application>Tcl</application> (Tool command language). It was installed
     37      by LFS in the temporary <filename class="directory">/tools</filename>
     38      directory.  These instructions install it permanently.
     39    </para>
    3840
    3941    &lfs72_checked;
    … …  
    6466
    6567    <bridgehead renderas="sect4">Required (Run-time Only)</bridgehead>
    66     <para role="required"><xref linkend="expect"/></para>
     68    <para role="required">
     69      <xref linkend="expect"/>
     70    </para>
    6771
    6872    <bridgehead renderas="sect4">Optional</bridgehead>
    69     <para role="optional"><xref linkend="docbook-utils"/></para>
     73    <para role="optional">
     74      <xref linkend="docbook-utils"/> and
     75      <ulink url="http://sourceforge.net/projects/docbook2x/">docbook2X</ulink>
     76      (both looked for by the <command>configure</command> script but not used
     77      in the build)
     78    </para>
    7079
    7180    <para condition="html" role="usernotes">User Notes:
    72     <ulink url="&blfs-wiki;/dejagnu"/></para>
    73 
     81      <ulink url="&blfs-wiki;/dejagnu"/>
     82    </para>
    7483  </sect2>
    7584
    … …  
    7786    <title>Installation of DejaGnu</title>
    7887
    79     <para>Install <application>DejaGnu</application> by running the following
    80     commands:</para>
     88    <para>
     89      Install <application>DejaGnu</application> by running the following
     90      commands:
     91    </para>
    8192
    82 <screen><userinput>./configure --prefix=/usr</userinput></screen>
     93<screen><userinput>./configure --prefix=/usr &amp;&amp;
     94makeinfo --html --no-split -o doc/dejagnu.html doc/dejagnu.texi &amp;&amp;
     95makeinfo --plaintext       -o doc/dejagnu.txt  doc/dejagnu.texi</userinput></screen>
    8396
    84     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     97    <para>
     98      HTML and text documentation was created in the previous step. There
     99      are different ways to create additional forms of documentation, if desired.
     100      If you have <xref linkend="texlive"/> installed, create PDF and Postscript
     101      docs in the <filename class="directory">doc</filename> directory by issuing
     102      <command>make pdf ps</command>. If you have <xref linkend="docbook-utils"/>
     103      installed, create PDF and Postscript docs in the top-level directory
     104      by issuing <command>make dejagnu.{pdf,ps}</command>.
     105    </para>
    85106
    86 <screen role="root"><userinput>make install</userinput></screen>
     107    <para>
     108      To test the results, issue <command>make check</command>.
     109    </para>
    87110
    88     <para>To test the installation, issue <command>make check</command> as
    89     an unprivileged user.</para>
     111    <para>
     112      Now, as the <systemitem class="username">root</systemitem> user:
     113    </para>
    90114
     115<screen role="root"><userinput>make install &amp;&amp;
     116install -v -m755 -d /usr/share/doc/dejagnu-&dejagnu-version; &amp;&amp;
     117install -v -m644    doc/dejagnu.{html,txt} \
     118                    /usr/share/doc/dejagnu-&dejagnu-version;</userinput></screen>
    91119  </sect2>
    92120
    … …  
    117145        <term><command>runtest</command></term>
    118146        <listitem>
    119           <para>is the <application>DejaGnu</application> test driver program. It is
    120           used to control what tests to run, and variations on how to run them.</para>
     147          <para>
     148            is the <application>DejaGnu</application> test driver program. It is
     149            used to control what tests to run, and variations on how to run them.
     150          </para>
    121151          <indexterm zone="dejagnu runtest">
    122152            <primary sortas="b-runtest">runtest</primary>

  • general/prog/expect.xml

    rfdb847da rd3970e1  
    162162        kibitz, lpunlock, mkpasswd, passmass, rftp, rlogin-cwd, timed-read, timed-run,
    163163        unbuffer, weather, and optionally (if <application>Expect</application> was
    164         linked against <application>Tk</application>), expectk, multixterm,
     164        linked against <application>Tk</application>), multixterm,
    165165        tknewsbiff, tkpasswd, xkibitz, and xpstat</seg>
    166166        <seg>libexpect&expect-version;.so</seg>
    … …  
    357357      </varlistentry>
    358358
    359       <varlistentry id="expectk">
    360         <term><command>expectk</command></term>
    361         <listitem>
    362           <para>is a combination of <application>Expect</application> with
    363           <application>Tk</application> and should run any <command>wish</command>
    364           or <application>Expect</application> script.</para>
    365           <indexterm zone="expect expectk">
    366             <primary sortas="b-expectk">expectk</primary>
    367           </indexterm>
    368         </listitem>
    369       </varlistentry>
    370 
    371359      <varlistentry id="multixterm">
    372360        <term><command>multixterm</command></term>
    … …  
    395383        <listitem>
    396384          <para>is a script to change passwords using
    397           <command>expectk</command>.</para>
     385          <command>expect</command> and <application>Tk</application>.</para>
    398386          <indexterm zone="expect tkpasswd">
    399387            <primary sortas="b-tkpasswd">tkpasswd</primary>

  • general/prog/gdb.xml

    rfdb847da rd3970e1  
    1313]>
    1414
    15 <sect1 id="gdb" xreflabel="gdb-&gdb-version;">
     15<sect1 id="gdb" xreflabel="GDB-&gdb-version;">
    1616  <?dbhtml filename="gdb.html"?>
    1717
    … …  
    2121  </sect1info>
    2222
    23   <title>gdb-&gdb-version;</title>
     23  <title>GDB-&gdb-version;</title>
    2424
    2525  <indexterm zone="gdb">
    … …  
    2828
    2929  <sect2 role="package">
    30     <title>Introduction to gdb</title>
     30    <title>Introduction to GDB</title>
    3131
    32     <para><application>GDB</application>, the GNU Project debugger, allows you
    33     to see what is going on `inside' another program while it executes -- or
    34     what another program was doing at the moment it crashed.</para>
     32    <para>
     33      <application>GDB</application>, the GNU Project debugger, allows you
     34      to see what is going on <quote>inside</quote> another program while it
     35      executes -- or what another program was doing at the moment it crashed.
     36      Note that <application>GDB</application> is most effective when tracing
     37      programs and libraries that were built with debugging symbols and not
     38      stripped.
     39    </para>
    3540
    3641    &lfs72_checked;
    … …  
    5863    </itemizedlist>
    5964
    60     <bridgehead renderas="sect3">gdb Dependencies</bridgehead>
     65    <bridgehead renderas="sect3">GDB Dependencies</bridgehead>
    6166
    6267    <bridgehead renderas="sect4">Optional</bridgehead>
    … …  
    6671
    6772    <para condition="html" role="usernotes">User Notes:
    68     <ulink url="&blfs-wiki;/gdb"/></para>
     73      <ulink url="&blfs-wiki;/gdb"/>
     74    </para>
    6975
    7076  </sect2>
    7177
    7278  <sect2 role="installation">
    73     <title>Installation of gdb</title>
     79    <title>Installation of GDB</title>
    7480
    75     <para>Install <application>gdb</application> by running the following
    76     commands:</para>
     81    <para>
     82      Install <application>GDB</application> by running the following
     83      commands:
     84    </para>
    7785
    7886<screen><userinput>./configure --prefix=/usr &amp;&amp;
    7987make</userinput></screen>
    8088
    81     <para>To test the results, issue: <command>make check</command>.</para>
     89    <para>
     90      To test the results, issue: <command>make -k check</command>.
     91    </para>
    8292
    83     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     93    <para>
     94      Now, as the <systemitem class="username">root</systemitem> user:
     95    </para>
    8496
    8597<screen role="root"><userinput>make -C gdb install</userinput></screen>
    8698
    8799  </sect2>
     100
    88101<!--
    89102  <sect2 role="commands">
    … …  
    98111  </sect2>
    99112-->
     113
    100114  <sect2 role="content">
    101115    <title>Contents</title>
    … …  
    107121
    108122      <seglistitem>
    109         <seg>gdb, gdbserver, and gdbtui</seg>
     123        <seg>gdb and gdbserver</seg>
    110124        <seg>libinproctrace.so</seg>
    111         <seg>/usr/share/gdb/{python/gdb/command,syscalls}</seg>
     125        <seg>/usr/include/gdb, /usr/share/gdb, and
     126        /usr/share/doc/gdb-&gdb-version;</seg>
    112127      </seglistitem>
    113128    </segmentedlist>
    … …  
    121136        <term><command>gdb</command></term>
    122137        <listitem>
    123           <para>is the GNU Debugger.</para>
     138          <para>
     139            is the GNU Debugger.
     140          </para>
    124141          <indexterm zone="gdb gdb-prog">
    125142            <primary sortas="b-gdb-prog">gdb-prog</primary>
    … …  
    131148        <term><command>gdbserver</command></term>
    132149        <listitem>
    133           <para>is a remote server for the GNU debugger (it allows programs to be
    134           debugged from a different machine).</para>
     150          <para>
     151            is a remote server for the GNU debugger (it allows programs to be
     152            debugged from a different machine).
     153          </para>
    135154          <indexterm zone="gdb gdbserver">
    136155            <primary sortas="b-gdbserver">gdbserver</primary>
    … …  
    139158      </varlistentry>
    140159
    141       <varlistentry id="gdbtui">
    142         <term><command>gdbtui</command></term>
    143         <listitem>
    144           <para>is a text user interface for <application>gdb</application>.</para>
    145           <indexterm zone="gdb gdbtui">
    146             <primary sortas="b-gdbtui">gdbtui</primary>
    147           </indexterm>
    148         </listitem>
    149       </varlistentry>
    150 
    151       <!-- commenting, unless anyone feels able to describe this.
    152160      <varlistentry id="libinproctrace">
    153161        <term><filename class='libraryfile'>libinproctrace.so</filename></term>
    154162        <listitem>
    155           <para>contains functions that .....</para>
     163          <para>
     164            contains functions for the in-process tracing agent. The agent
     165            allows for installing fast tracepoints, listing static tracepoint
     166            markers, probing static tracepoints markers, and starting trace
     167            monitoring.
     168          </para>
    156169          <indexterm zone="gdb libinproctrace">
    157170            <primary sortas="c-libinproctrace">libinproctrace.so</primary>
    158171          </indexterm>
    159172        </listitem>
    160       </varlistentry> -->
     173      </varlistentry>
    161174
    162175    </variablelist>
Note: See TracChangeset for help on using the changeset viewer.