aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat
-rw-r--r--gdb/ChangeLog12
-rw-r--r--gdb/cli/cli-script.c49
-rw-r--r--gdb/cli/cli-script.h1
-rw-r--r--gdb/testsuite/ChangeLog4
-rw-r--r--gdb/testsuite/gdb.base/document.exp30
5 files changed, 89 insertions, 7 deletions
diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 91bf0a2..979d26e 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,15 @@
+2020-12-15 Rae Kim <rae.kim@gmail.com>
+
+ * cli/cli-script.c (do_document_command): Rename from
+ document_command. Handle multi-line input.
+ (multi_line_command_p): Handle document_control.
+ (build_command_line): Likewise.
+ (execute_control_command_1): Likewise.
+ (process_next_line): Likewise.
+ (document_command): Call do_document_command.
+ * cli/cli-script.h (enum command_control_type): Add
+ document_control.
+
2020-12-15 Tom Tromey <tom@tromey.com>
* stap-probe.c (stap_probe::evaluate_argument): Use
diff --git a/gdb/cli/cli-script.c b/gdb/cli/cli-script.c
index afa44af..c9c4a71 100644
--- a/gdb/cli/cli-script.c
+++ b/gdb/cli/cli-script.c
@@ -51,6 +51,9 @@ recurse_read_control_structure
static void do_define_command (const char *comname, int from_tty,
const counted_command_line *commands);
+static void do_document_command (const char *comname, int from_tty,
+ const counted_command_line *commands);
+
static const char *read_next_line ();
/* Level of control structure when reading. */
@@ -71,6 +74,9 @@ static cmd_list_element *if_cmd_element = nullptr;
/* Command element for the 'define' command. */
static cmd_list_element *define_cmd_element = nullptr;
+/* Command element for the 'document' command. */
+static cmd_list_element *document_cmd_element = nullptr;
+
/* Structure for arguments to user defined functions. */
class user_args
@@ -139,6 +145,7 @@ multi_line_command_p (enum command_control_type type)
case python_control:
case guile_control:
case define_control:
+ case document_control:
return 1;
default:
return 0;
@@ -159,6 +166,8 @@ build_command_line (enum command_control_type type, const char *args)
error (_("while command requires an argument."));
else if (type == define_control)
error (_("define command requires an argument."));
+ else if (type == document_control)
+ error (_("document command requires an argument."));
}
gdb_assert (args != NULL);
@@ -679,6 +688,12 @@ execute_control_command_1 (struct command_line *cmd, int from_tty)
ret = simple_control;
break;
+ case document_control:
+ print_command_trace ("document %s", cmd->line);
+ do_document_command (cmd->line, 0, &cmd->body_list_0);
+ ret = simple_control;
+ break;
+
case python_control:
case guile_control:
{
@@ -1019,6 +1034,8 @@ process_next_line (const char *p, struct command_line **command,
*command = build_command_line (commands_control, line_first_arg (p));
else if (cmd == define_cmd_element)
*command = build_command_line (define_control, line_first_arg (p));
+ else if (cmd == document_cmd_element)
+ *command = build_command_line (document_control, line_first_arg (p));
else if (cmd == python_cmd_element && !inline_cmd)
{
/* Note that we ignore the inline "python command" form
@@ -1508,8 +1525,13 @@ define_command (const char *comname, int from_tty)
do_define_command (comname, from_tty, nullptr);
}
+/* Document a user-defined command. If COMMANDS is NULL, then this is a
+ top-level call and the document will be read using read_command_lines.
+ Otherwise, it is a "document" command in an existing command and the
+ commands are provided. */
static void
-document_command (const char *comname, int from_tty)
+do_document_command (const char *comname, int from_tty,
+ const counted_command_line *commands)
{
struct cmd_list_element *c, **list;
const char *tem;
@@ -1524,10 +1546,16 @@ document_command (const char *comname, int from_tty)
if (c->theclass != class_user)
error (_("Command \"%s\" is built-in."), comfull);
- std::string prompt = string_printf ("Type documentation for \"%s\".",
- comfull);
- counted_command_line doclines = read_command_lines (prompt.c_str (),
- from_tty, 0, 0);
+ counted_command_line doclines;
+
+ if (commands == nullptr)
+ {
+ std::string prompt
+ = string_printf ("Type documentation for \"%s\".", comfull);
+ doclines = read_command_lines (prompt.c_str (), from_tty, 0, 0);
+ }
+ else
+ doclines = *commands;
xfree ((char *) c->doc);
@@ -1553,6 +1581,12 @@ document_command (const char *comname, int from_tty)
}
}
+static void
+document_command (const char *comname, int from_tty)
+{
+ do_document_command (comname, from_tty, nullptr);
+}
+
/* Implementation of the "define-prefix" command. */
static void
@@ -1676,11 +1710,12 @@ _initialize_cli_script ()
/* "document", "define" and "define-prefix" use command_completer,
as this helps the user to either type the command name and/or
its prefixes. */
- c = add_com ("document", class_support, document_command, _("\
+ document_cmd_element = add_com ("document", class_support, document_command,
+ _("\
Document a user-defined command.\n\
Give command name as argument. Give documentation on following lines.\n\
End with a line of just \"end\"."));
- set_cmd_completer (c, command_completer);
+ set_cmd_completer (document_cmd_element, command_completer);
define_cmd_element = add_com ("define", class_support, define_command, _("\
Define a new command name. Command name is argument.\n\
Definition appears on following lines, one command per line.\n\
diff --git a/gdb/cli/cli-script.h b/gdb/cli/cli-script.h
index fcae9ab..6ad6e61 100644
--- a/gdb/cli/cli-script.h
+++ b/gdb/cli/cli-script.h
@@ -45,6 +45,7 @@ enum command_control_type
guile_control,
while_stepping_control,
define_control,
+ document_control,
invalid_control
};
diff --git a/gdb/testsuite/ChangeLog b/gdb/testsuite/ChangeLog
index 0e6177b..549475a 100644
--- a/gdb/testsuite/ChangeLog
+++ b/gdb/testsuite/ChangeLog
@@ -1,3 +1,7 @@
+2020-12-15 Rae Kim <rae.kim@gmail.com>
+
+ * gdb.base/document.exp: New test.
+
2020-12-15 Tom Tromey <tromey@adacore.com>
* gdb.base/style.exp: Add deprecation tests.
diff --git a/gdb/testsuite/gdb.base/document.exp b/gdb/testsuite/gdb.base/document.exp
new file mode 100644
index 0000000..7e183f8
--- /dev/null
+++ b/gdb/testsuite/gdb.base/document.exp
@@ -0,0 +1,30 @@
+# Copyright 1998-2020 Free Software Foundation, Inc.
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+standard_testfile break.c break1.c
+
+if {[prepare_for_testing "failed to prepare" ${testfile} \
+ [list $srcfile $srcfile2] {debug nowarnings}]} {
+ return -1
+}
+
+# test document command used within user command.
+gdb_test_multiple "define do-document" "" {
+ -re "Type commands for definition of \"do-document\".\r\nEnd with a line saying just \"end\".\r\n>$" {
+ gdb_test "document do-document\nusage: do-document\nend\nend" "" "define do-document"
+ }
+}
+gdb_test_no_output "do-document" "invoke do-document"
+gdb_test "help do-document" "usage: do-document" "invoke help do-document"
generated by cgit v1.1 at 2024-11-27 10:41:55 +0000