* gdb.texinfo (Machine Code) <disassemble-next-line>: Improve and

	clarify the wording.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index e0f7a667eb8db500587b4aed188f4ae9c2930161..b4d1ba839f5a65d1cd1115c4f72814eb1215ae76 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2009-04-25  Eli Zaretskii  <eliz@gnu.org>
+
+       * gdb.texinfo (Machine Code) <disassemble-next-line>: Improve and
+       clarify the wording.
+
 2009-04-23  Tom Tromey  <tromey@redhat.com>
 
        * gdb.texinfo (Data Files): New node.

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 53fecf36fe1d6f57bb2504cf82c3adc65ff2a983..7ae9e1c2180c5af9750c97b884e094fbb905f618 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -6071,11 +6071,21 @@ Show the current setting of the disassembly flavor.
 @kindex show disassemble-next-line
 @item set disassemble-next-line
 @itemx show disassemble-next-line
-Control whether or not @value{GDBN} will disassemble next source line
-when execution stops.  If ON, GDB will display disassembly of the next
-source line when execution of the program being debugged stops.
-If AUTO, or there's no line info to determine the source line of the
-next instruction, display disassembly of next instruction instead.
+Control whether or not @value{GDBN} will disassemble the next source
+line or instruction when execution stops.  If ON, @value{GDBN} will
+display disassembly of the next source line when execution of the
+program being debugged stops.  This is @emph{in addition} to
+displaying the source line itself, which @value{GDBN} always does if
+possible.  If the next source line cannot be displayed for some reason
+(e.g., if @value{GDBN} cannot find the source file, or there's no line
+info in the debug info), @value{GDBN} will display disassembly of the
+next @emph{instruction} instead of showing the next source line.  If
+AUTO, @value{GDBN} will display disassembly of next instruction only
+if the source line cannot be displayed.  This setting causes
+@value{GDBN} to display some feedback when you step through a function
+with no line info or whose source file is unavailable.  The default is
+OFF, which means never display the disassembly of the next line or
+instruction.
 @end table