old-cross-binutils/gdb/doc
Gary Benson ef0b411a11 Add max-completions parameter, and implement tab-completion limiting.
This commit adds a new exception, MAX_COMPLETIONS_REACHED_ERROR, to be
thrown whenever the completer has generated too many candidates to
be useful.  A new user-settable variable, "max_completions", is added
to control this behaviour.  A top-level completion limit is added to
complete_line_internal, as the final check to ensure the user never
sees too many completions.  An additional limit is added to
default_make_symbol_completion_list_break_on, to halt time-consuming
symbol table expansions.

gdb/ChangeLog:

	PR cli/9007
	PR cli/11920
	PR cli/15548
	* cli/cli-cmds.c (complete_command): Notify user if max-completions
	reached.
	* common/common-exceptions.h (enum errors)
	<MAX_COMPLETIONS_REACHED_ERROR>: New value.
	* completer.h (get_max_completions_reached_message): New declaration.
	(max_completions): Likewise.
	(completion_tracker_t): New typedef.
	(new_completion_tracker): New declaration.
	(make_cleanup_free_completion_tracker): Likewise.
	(maybe_add_completion_enum): New enum.
	(maybe_add_completion): New declaration.
	(throw_max_completions_reached_error): Likewise.
	* completer.c (max_completions): New global variable.
	(new_completion_tracker): New function.
	(free_completion_tracker): Likewise.
	(make_cleanup_free_completion_tracker): Likewise.
	(maybe_add_completions): Likewise.
	(throw_max_completions_reached_error): Likewise.
	(complete_line): Remove duplicates and limit result to max_completions
	entries.
	(get_max_completions_reached_message): New function.
	(gdb_display_match_list): Handle max_completions.
	(_initialize_completer): New declaration and function.
	* symtab.c: Include completer.h.
	(completion_tracker): New static variable.
	(completion_list_add_name): Call maybe_add_completion.
	(default_make_symbol_completion_list_break_on_1): Renamed from
	default_make_symbol_completion_list_break_on.  Maintain
	completion_tracker across calls to completion_list_add_name.
	(default_make_symbol_completion_list_break_on): New function.
	* top.c (init_main): Set rl_completion_display_matches_hook.
	* tui/tui-io.c: Include completer.h.
	(tui_old_rl_display_matches_hook): New static global.
	(tui_rl_display_match_list): Notify user if max-completions reached.
	(tui_setup_io): Save/restore rl_completion_display_matches_hook.
	* NEWS (New Options): Mention set/show max-completions.

gdb/doc/ChangeLog:

	* gdb.texinfo (Command Completion): Document new
	"set/show max-completions" option.

gdb/testsuite/ChangeLog:

	* gdb.base/completion.exp: Disable completion limiting for
	existing tests.  Add new tests to check completion limiting.
	* gdb.linespec/ls-errs.exp: Disable completion limiting.
2015-01-31 15:07:22 -08:00
..
a4rc.sed
agentexpr.texi Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
all-cfg.texi Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
annotate.texinfo Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
ChangeLog Add symbol lookup cache. 2015-01-31 13:29:33 -08:00
doxy-index.in Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
Doxyfile-base.in Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
Doxyfile-gdb-api.in Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
Doxyfile-gdb-xref.in Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
Doxyfile-gdbserver.in Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
fdl.texi
filter-for-doxygen Add Doxygen support to GDB 2014-02-10 19:10:34 -08:00
filter-params.pl Add Doxygen support to GDB 2014-02-10 19:10:34 -08:00
gdb.texinfo Add max-completions parameter, and implement tab-completion limiting. 2015-01-31 15:07:22 -08:00
gpl.texi
guile.texi Improve docs of objfile filename method. 2015-01-27 10:03:15 -08:00
lpsrc.sed
Makefile.in Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
observer.texi Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
psrc.sed
python.texi Add support for inlining scripts into .debug_gdb_scripts. 2015-01-31 12:01:13 -08:00
refcard.tex Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
stabs.texinfo Update year range in copyright notice of all files owned by the GDB project. 2015-01-01 13:32:14 +04:00
stack_frame.eps
stack_frame.pdf
stack_frame.png
stack_frame.svg
stack_frame.txt