This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
[RFA] Improve on-line help for thread_apply_command and thread_apply_all_command.
- From: Philippe Waroquiers <philippe dot waroquiers at skynet dot be>
- To: gdb-patches at sourceware dot org
- Cc: Philippe Waroquiers <philippe dot waroquiers at skynet dot be>
- Date: Fri, 20 Apr 2018 23:19:00 +0200
- Subject: [RFA] Improve on-line help for thread_apply_command and thread_apply_all_command.
- Ironport-phdr: 9a23:qn8wrhKPVnH5T9en3NmcpTZWNBhigK39O0sv0rFitYgeKf7xwZ3uMQTl6Ol3ixeRBMOHs6kC07KempujcFRI2YyGvnEGfc4EfD4+ouJSoTYdBtWYA1bwNv/gYn9yNs1DUFh44yPzahANS47xaFLIv3K98yMZFAnhOgppPOT1HZPZg9iq2+yo9JDffwtFiCChbb9uMR67sRjfus4KjIV4N60/0AHJonxGe+RXwWNnO1eelAvi68mz4ZBu7T1et+ou+MBcX6r6eb84TaFDAzQ9L281/szrugLdQgaJ+3ART38ZkhtMAwjC8RH6QpL8uTb0u+ZhxCWXO9D9QLYpUjqg8qhrUgflhicZOTAk/m/Zict+gblHrB69vRFz35TZbJ2JOPd4Y6jTfckaRW1EXstJTSJBAoK8b48OD+oZJeZXsZT2qFsUohukAgmsHf7vyj5WiX/sxq0xzuMsERnG3AwhG9IOsWzUrM3rO6sIX+G61rPIzTLab/NL2Dfy9pLIcgs6rPGXXrJxcczRxlczFw/flVqft5XoMjWI3eoOq2iW9+ltWf+1h2I5pAx9vCKjy8guh4XTiI8Z1FbJ/jhjzokvP923Ukt7bMahEJtXqi6VKZN7QtgnQ2F0oCY6zaAGuYKjcCgK1psnwxnfZuSCc4eV+B7jVOGRITJmi359ebK/gQi98VS4x+D/S8W4ykhGoyVbntXWuX0A1Qbf58aZRvdl+0euwzeP1wTd6uFeJkA0kLLWK4Yhwr4xkpoTsFzDHjfol0nsgq6ZbF8k+u+x6+T6Y7XpuIWcN5RvhwHlMaQvmsq/DvokMgQURGeU5/yw1Kf/8k3hXLVKkvo2n7HWsJ/HPssXv7a5DBVJ0ok/6xawESym3c8DnXkAMVJFYg6IgJbnOl7UOvD3E+2zg1O2kDdk3/rGJKHuAo3RLnjfl7fsZa59605dyAo3zNBf/4pUBa8bLPP9QEDxrtvYDgYkMwy13ennEs5925gFWWKMAq6ZNr3dsUOS6u00PebfLLMS7TnxIb097uLljXIisUQaYLOi0IQecn3+Ge5pcGuDZn+5utcAFWYSpgd2c+Xwj0SfUDNJfD7mR6I94jAjEI/gEo7ZQZmwgbGbxw+gHYxQa3wAAF3aQiSgTJmNR/pZMHHaGcRmiDFRDbU=
Add a Usage: line for thread_apply_command, in particular to mention
the thread ID list.
In thread_apply_command and thread_apply_all_command help, use
uppercase for arg names, as this style seems to be more standard.
2018-04-20 Philippe Waroquiers <philippe.waroquiers@skynet.be>
* thread.c (_initialize_thread): improve on-line help for
thread_apply_command and thread_apply_all_command.
---
gdb/thread.c | 8 +++++---
1 file changed, 5 insertions(+), 3 deletions(-)
diff --git a/gdb/thread.c b/gdb/thread.c
index 23aa5ba117..a09d7e0ba0 100644
--- a/gdb/thread.c
+++ b/gdb/thread.c
@@ -2028,15 +2028,17 @@ The new thread ID must be currently known."),
&thread_cmd_list, "thread ", 1, &cmdlist);
add_prefix_cmd ("apply", class_run, thread_apply_command,
- _("Apply a command to a list of threads."),
+ _("Apply a command to a list of threads.\n\
+Usage: thread apply ID... COMMAND\n\
+ID is a space-separated list of IDs of threads to apply COMMAND on."),
&thread_apply_list, "thread apply ", 1, &thread_cmd_list);
add_cmd ("all", class_run, thread_apply_all_command,
_("\
Apply a command to all threads.\n\
\n\
-Usage: thread apply all [-ascending] <command>\n\
--ascending: Call <command> for all threads in ascending order.\n\
+Usage: thread apply all [-ascending] COMMAND\n\
+-ascending: Call COMMAND for all threads in ascending order.\n\
The default is descending order.\
"),
&thread_apply_list);
--
2.11.0