Changeset d3970e1 for general/prog/gdb.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/gdb.xml (modified) (10 diffs)

general/prog/gdb.xml

@@ -13 +13 @@
 ]>
 
-<sect1 id="gdb" xreflabel="gdb-&gdb-version;">
+<sect1 id="gdb" xreflabel="GDB-&gdb-version;">
   <?dbhtml filename="gdb.html"?>
 
@@ -21 +21 @@
   </sect1info>
 
-  <title>gdb-&gdb-version;</title>
+  <title>GDB-&gdb-version;</title>
 
   <indexterm zone="gdb">
@@ -28 +28 @@
 
   <sect2 role="package">
-    <title>Introduction to gdb</title>
+    <title>Introduction to GDB</title>
 
-    <para><application>GDB</application>, the GNU Project debugger, allows you
-    to see what is going on `inside' another program while it executes -- or
-    what another program was doing at the moment it crashed.</para>
+    <para>
+      <application>GDB</application>, the GNU Project debugger, allows you
+      to see what is going on <quote>inside</quote> another program while it
+      executes -- or what another program was doing at the moment it crashed.
+      Note that <application>GDB</application> is most effective when tracing
+      programs and libraries that were built with debugging symbols and not
+      stripped.
+    </para>
 
     &lfs72_checked;
@@ -58 +63 @@
     </itemizedlist>
 
-    <bridgehead renderas="sect3">gdb Dependencies</bridgehead>
+    <bridgehead renderas="sect3">GDB Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
@@ -66 +71 @@
 
     <para condition="html" role="usernotes">User Notes:
-    <ulink url="&blfs-wiki;/gdb"/></para>
+      <ulink url="&blfs-wiki;/gdb"/>
+    </para>
 
   </sect2>
 
   <sect2 role="installation">
-    <title>Installation of gdb</title>
+    <title>Installation of GDB</title>
 
-    <para>Install <application>gdb</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>GDB</application> by running the following
+      commands:
+    </para>
 
 <screen><userinput>./configure --prefix=/usr &amp;&amp;
 make</userinput></screen>
 
-    <para>To test the results, issue: <command>make check</command>.</para>
+    <para>
+      To test the results, issue: <command>make -k 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 -C gdb install</userinput></screen>
 
   </sect2>
+
 <!--
   <sect2 role="commands">
@@ -98 +111 @@
   </sect2>
 -->
+
   <sect2 role="content">
     <title>Contents</title>
@@ -107 +121 @@
 
       <seglistitem>
-        <seg>gdb, gdbserver, and gdbtui</seg>
+        <seg>gdb and gdbserver</seg>
         <seg>libinproctrace.so</seg>
-        <seg>/usr/share/gdb/{python/gdb/command,syscalls}</seg>
+        <seg>/usr/include/gdb, /usr/share/gdb, and
+        /usr/share/doc/gdb-&gdb-version;</seg>
       </seglistitem>
     </segmentedlist>
@@ -121 +136 @@
         <term><command>gdb</command></term>
         <listitem>
-          <para>is the GNU Debugger.</para>
+          <para>
+            is the GNU Debugger.
+          </para>
           <indexterm zone="gdb gdb-prog">
             <primary sortas="b-gdb-prog">gdb-prog</primary>
@@ -131 +148 @@
         <term><command>gdbserver</command></term>
         <listitem>
-          <para>is a remote server for the GNU debugger (it allows programs to be
-          debugged from a different machine).</para>
+          <para>
+            is a remote server for the GNU debugger (it allows programs to be
+            debugged from a different machine).
+          </para>
           <indexterm zone="gdb gdbserver">
             <primary sortas="b-gdbserver">gdbserver</primary>
@@ -139 +158 @@
       </varlistentry>
 
-      <varlistentry id="gdbtui">
-        <term><command>gdbtui</command></term>
-        <listitem>
-          <para>is a text user interface for <application>gdb</application>.</para>
-          <indexterm zone="gdb gdbtui">
-            <primary sortas="b-gdbtui">gdbtui</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <!-- commenting, unless anyone feels able to describe this.
       <varlistentry id="libinproctrace">
         <term><filename class='libraryfile'>libinproctrace.so</filename></term>
         <listitem>
-          <para>contains functions that .....</para>
+          <para>
+            contains functions for the in-process tracing agent. The agent
+            allows for installing fast tracepoints, listing static tracepoint
+            markers, probing static tracepoints markers, and starting trace
+            monitoring.
+          </para>
           <indexterm zone="gdb libinproctrace">
             <primary sortas="c-libinproctrace">libinproctrace.so</primary>
           </indexterm>
         </listitem>
-      </varlistentry> -->
+      </varlistentry>
 
     </variablelist>