Update usage text for add-symbol-file, symbol-file, and load

This updates the usage text for the add-symbol-file, symbol-file, and
load commands.

gdb/ChangeLog
2017-11-29  Tom Tromey  <tom@tromey.com>

	* symfile.c (_initialize_symfile): Update usage text for
	add-symbol-file, symbol-file, load.
This commit is contained in:
Tom Tromey 2017-08-21 20:01:40 -06:00
parent 02ca603a48
commit 8ca2f0b9ac
2 changed files with 16 additions and 4 deletions

View File

@ -1,3 +1,8 @@
2017-11-29 Tom Tromey <tom@tromey.com>
* symfile.c (_initialize_symfile): Update usage text for
add-symbol-file, symbol-file, load.
2017-11-29 Tom Tromey <tom@tromey.com> 2017-11-29 Tom Tromey <tom@tromey.com>
* symfile.c (add_symbol_file_command): Error if some arguments to * symfile.c (add_symbol_file_command): Error if some arguments to

View File

@ -3878,10 +3878,16 @@ _initialize_symfile (void)
observer_attach_free_objfile (symfile_free_objfile); observer_attach_free_objfile (symfile_free_objfile);
#define READNOW_HELP \
"The '-readnow' option will cause GDB to read the entire symbol file\n\
immediately. This makes the command slower, but may make future operations\n\
faster."
c = add_cmd ("symbol-file", class_files, symbol_file_command, _("\ c = add_cmd ("symbol-file", class_files, symbol_file_command, _("\
Load symbol table from executable file FILE.\n\ Load symbol table from executable file FILE.\n\
Usage: symbol-file [-readnow] FILE\n\
The `file' command can also load symbol tables, as well as setting the file\n\ The `file' command can also load symbol tables, as well as setting the file\n\
to execute."), &cmdlist); to execute.\n" READNOW_HELP), &cmdlist);
set_cmd_completer (c, filename_completer); set_cmd_completer (c, filename_completer);
c = add_cmd ("add-symbol-file", class_files, add_symbol_file_command, _("\ c = add_cmd ("add-symbol-file", class_files, add_symbol_file_command, _("\
@ -3890,7 +3896,8 @@ Usage: add-symbol-file FILE ADDR [-readnow | -s SECT-NAME SECT-ADDR]...\n\
ADDR is the starting address of the file's text.\n\ ADDR is the starting address of the file's text.\n\
Each '-s' argument provides a section name and address, and\n\ Each '-s' argument provides a section name and address, and\n\
should be specified if the data and bss segments are not contiguous\n\ should be specified if the data and bss segments are not contiguous\n\
with the text. SECT-NAME is a section name to be loaded at SECT-ADDR."), with the text. SECT-NAME is a section name to be loaded at SECT-ADDR.\n"
READNOW_HELP),
&cmdlist); &cmdlist);
set_cmd_completer (c, filename_completer); set_cmd_completer (c, filename_completer);
@ -3906,10 +3913,10 @@ that lies within the boundaries of this symbol file in memory."),
c = add_cmd ("load", class_files, load_command, _("\ c = add_cmd ("load", class_files, load_command, _("\
Dynamically load FILE into the running program, and record its symbols\n\ Dynamically load FILE into the running program, and record its symbols\n\
for access from GDB.\n\ for access from GDB.\n\
Usage: load [FILE] [OFFSET]\n\
An optional load OFFSET may also be given as a literal address.\n\ An optional load OFFSET may also be given as a literal address.\n\
When OFFSET is provided, FILE must also be provided. FILE can be provided\n\ When OFFSET is provided, FILE must also be provided. FILE can be provided\n\
on its own.\n\ on its own."), &cmdlist);
Usage: load [FILE] [OFFSET]"), &cmdlist);
set_cmd_completer (c, filename_completer); set_cmd_completer (c, filename_completer);
add_prefix_cmd ("overlay", class_support, overlay_command, add_prefix_cmd ("overlay", class_support, overlay_command,