aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorFelix Willgerodt <felix.willgerodt@intel.com>2021-06-16 13:06:11 +0200
committerFelix Willgerodt <felix.willgerodt@intel.com>2021-06-16 13:55:25 +0200
commitcdb2186c9fa91b7f0b224eaaa3681db8dd196251 (patch)
tree2716afa5b943981e2b5c2721e98f5b556d4cecb8 /gdb
parent8457e5ecc45295bc9550c4f705a276d5ca90d908 (diff)
downloadgdb-cdb2186c9fa91b7f0b224eaaa3681db8dd196251.zip
gdb-cdb2186c9fa91b7f0b224eaaa3681db8dd196251.tar.gz
gdb-cdb2186c9fa91b7f0b224eaaa3681db8dd196251.tar.bz2
btrace, doc: Clarify record function-call-history documentation.
The documentation for 'record function-call-history' mentions lines instead of functions when talking about the number of functions printed, as currently there is only one line printed per function. Yet the code actually handles this on function granularity not on line basis. Future patches will extend the number of lines printed per function. This also makes it consistent with the 'record instruction-history' command, where multiple lines can be printed per instruction. gdb/doc/ChangeLog: 2021-06-16 Felix Willgerodt <felix.willgerodt@intel.com> * gdb.texinfo (Process Record and Replay): Stop mentioning lines for "record function-call-history" and "set record function-call-history-size".
Diffstat (limited to 'gdb')
-rw-r--r--gdb/doc/gdb.texinfo29
1 files changed, 14 insertions, 15 deletions
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index d09b86c..7cdc83b 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -7926,15 +7926,14 @@ instruction-history} command.
@kindex record function-call-history
@kindex rec function-call-history
@item record function-call-history
-Prints the execution history at function granularity. It prints one
-line for each sequence of instructions that belong to the same
-function giving the name of that function, the source lines
-for this instruction sequence (if the @code{/l} modifier is
-specified), and the instructions numbers that form the sequence (if
-the @code{/i} modifier is specified). The function names are indented
-to reflect the call stack depth if the @code{/c} modifier is
-specified. The @code{/l}, @code{/i}, and @code{/c} modifiers can be
-given together.
+Prints the execution history at function granularity. For each sequence
+of instructions that belong to the same function, it prints the name of
+that function, the source lines for this instruction sequence (if the
+@code{/l} modifier is specified), and the instructions numbers that form
+the sequence (if the @code{/i} modifier is specified). The function names
+are indented to reflect the call stack depth if the @code{/c} modifier is
+specified. The @code{/l}, @code{/i}, and @code{/c} modifiers can be given
+together.
@smallexample
(@value{GDBP}) @b{list 1, 10}
@@ -7954,7 +7953,7 @@ given together.
3 bar inst 11,13 at foo.c:9,10
@end smallexample
-By default, ten lines are printed. This can be changed using the
+By default, ten functions are printed. This can be changed using the
@code{set record function-call-history-size} command. Functions are
printed in execution order. There are several ways to specify what
to print:
@@ -7970,10 +7969,10 @@ function number @var{func}. If @var{n} is preceded with @code{-},
prints @var{n} functions before function number @var{func}.
@item record function-call-history
-Prints ten more functions after the last ten-line print.
+Prints ten more functions after the last ten-function print.
@item record function-call-history -
-Prints ten more functions before the last ten-line print.
+Prints ten more functions before the last ten-function print.
@item record function-call-history @var{begin}, @var{end}
Prints functions beginning with function number @var{begin} until
@@ -7984,12 +7983,12 @@ This command may not be available for all recording methods.
@item set record function-call-history-size @var{size}
@itemx set record function-call-history-size unlimited
-Define how many lines to print in the
+Define how many functions to print in the
@code{record function-call-history} command. The default value is 10.
-A size of @code{unlimited} means unlimited lines.
+A size of @code{unlimited} means unlimited functions.
@item show record function-call-history-size
-Show how many lines to print in the
+Show how many functions to print in the
@code{record function-call-history} command.
@end table