aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrew Burgess <andrew.burgess@embecosm.com>2021-01-28 09:58:43 +0000
committerAndrew Burgess <andrew.burgess@embecosm.com>2021-01-28 10:04:54 +0000
commit24cf63899bf363c761c344a47dae037fbba8d643 (patch)
tree562d0a9045fc5fadebd33ee0f57ceb80c403f7f3
parent2a7f6487d0a2f9a5f16d0f67904ac35100313eb1 (diff)
downloadgdb-24cf63899bf363c761c344a47dae037fbba8d643.zip
gdb-24cf63899bf363c761c344a47dae037fbba8d643.tar.gz
gdb-24cf63899bf363c761c344a47dae037fbba8d643.tar.bz2
gdb: update comment for execute_command_to_string
The function execute_command_to_string had two header comments, one in gdbcmd.h and one in top.c. This commit merges the two comments into one and places this comment in gdbcmd.h. The comment in top.c is updated to just reference gdbcmd.h. gdb/ChangeLog: * gdbcmd.h (execute_command_to_string): Update comment. * top.c (execute_command_to_string): Update header comment.
-rw-r--r--gdb/ChangeLog5
-rw-r--r--gdb/gdbcmd.h9
-rw-r--r--gdb/top.c4
3 files changed, 12 insertions, 6 deletions
diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index f16a4d6..46ba66d 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,8 @@
+2021-01-28 Andrew Burgess <andrew.burgess@embecosm.com>
+
+ * gdbcmd.h (execute_command_to_string): Update comment.
+ * top.c (execute_command_to_string): Update header comment.
+
2021-01-28 Tom de Vries <tdevries@suse.de>
PR breakpoints/27205
diff --git a/gdb/gdbcmd.h b/gdb/gdbcmd.h
index af6235f..f541ebd 100644
--- a/gdb/gdbcmd.h
+++ b/gdb/gdbcmd.h
@@ -134,9 +134,12 @@ extern struct cmd_list_element *save_cmdlist;
extern void execute_command (const char *, int);
-/* Execute command P and returns its output. If TERM_OUT,
- the output is built using terminal output behaviour such
- as cli_styling. */
+/* Run execute_command for P and FROM_TTY. Capture its output into the
+ returned string, do not display it to the screen. The global BATCH_FLAG
+ will temporarily be set to true. When TERM_OUT is true the output is
+ collected with terminal behaviour (e.g. with styling). When TERM_OUT is
+ false raw output will be collected (e.g. no styling). */
+
extern std::string execute_command_to_string (const char *p, int from_tty,
bool term_out);
extern void execute_command_to_ui_file (struct ui_file *file,
diff --git a/gdb/top.c b/gdb/top.c
index 08c4742..3be9507 100644
--- a/gdb/top.c
+++ b/gdb/top.c
@@ -716,9 +716,7 @@ execute_command_to_ui_file (struct ui_file *file, const char *p, int from_tty)
}
}
-/* Run execute_command for P and FROM_TTY. Capture its output into the
- returned string, do not display it to the screen. BATCH_FLAG will be
- temporarily set to true. */
+/* See gdbcmd.h. */
std::string
execute_command_to_string (const char *p, int from_tty,