From 82359ceb227c580f0263baab5902364340a7f711 Mon Sep 17 00:00:00 2001 From: Fabian Homborg Date: Wed, 14 Jun 2017 13:39:16 +0200 Subject: [PATCH] Update help completions - More topics - Some non-existent topics (todo/bugs) removed - Some rewording (no more "Help on") --- share/completions/help.fish | 92 +++++++++++++++++++++++++++---------- 1 file changed, 69 insertions(+), 23 deletions(-) diff --git a/share/completions/help.fish b/share/completions/help.fish index 85a8f750c..0239e67ac 100644 --- a/share/completions/help.fish +++ b/share/completions/help.fish @@ -2,27 +2,73 @@ if test -d "$__fish_datadir/man/man1/" complete -c help -x -a '(__fish_print_commands)' --description 'Help for this command' end -complete -c help -x -a syntax --description 'Introduction to the fish syntax' -complete -c help -x -a todo --description 'Incomplete aspects of fish' -complete -c help -x -a bugs --description 'Known fish bugs' +# Help topics +# This was semi-automated with `grep 'class="anchor"' -A1 /usr/share/doc/fish/index.html +# It's not fully automated since that requires parsing html with regex, +# and since this is by definition in sync - we ship the html, and we ship these completions. +complete -c help -x -a autosuggestions --description 'Autosuggestions' +complete -c help -x -a builtin-overview --description 'Builtin commands' +complete -c help -x -a cartesian-product --description 'Cartesian Products' +complete -c help -x -a color --description 'Setting syntax highlighting colors' +complete -c help -x -a combine --description 'Combining different expansions' +complete -c help -x -a completion --description 'How tab-completion works' +complete -c help -x -a completion-func --description 'Useful functions for writing completions' +complete -c help -x -a completion-own --description 'Writing your own completions' +complete -c help -x -a completion-path --description 'Where to put completions' +complete -c help -x -a debugging --description 'Debugging fish scripts' +complete -c help -x -a docs --description 'Help' +complete -c help -x -a editor --description 'Command line editor' +complete -c help -x -a emacs-mode --description 'Emacs mode commands' +complete -c help -x -a escapes --description 'Escaping characters' +complete -c help -x -a event --description 'Event handlers' +complete -c help -x -a expand --description 'Parameter expansion (Globbing)' +complete -c help -x -a expand-brace --description 'Brace expansion {a,b,c}' +complete -c help -x -a expand-command-substitution --description 'Command substitution' +complete -c help -x -a expand-command-substitution --description 'Command substitution (SUBCOMMAND)' +complete -c help -x -a expand-home --description 'Home directory expansion ~USER' +complete -c help -x -a expand-index-range --description 'Index range expansion' +complete -c help -x -a expand-process --description 'Process expansion %JOB' +complete -c help -x -a expand-variable --description 'Variable expansion $VARNAME' +complete -c help -x -a expand-wildcard --description 'Wildcard expansion *.*' +# Note: This is hard-coded in help.fish - it's not an anchor in the html. +complete -c help -x -a globbing --description 'Parameter expansion (Globbing)' +complete -c help -x -a greeting --description 'Configurable greeting' complete -c help -x -a history --description 'Help on how to reuse previously entered commands' - -complete -c help -x -a completion --description 'Help on how tab-completion works' -complete -c help -x -a job-control --description 'Help on how job control works' -complete -c help -x -a difference --description 'Summary on how fish differs from other shells' - -complete -c help -x -a prompt --description 'Help on how to set the prompt' -complete -c help -x -a title --description 'Help on how to set the titlebar message' -complete -c help -x -a killring --description 'Help on how to copy and paste' -complete -c help -x -a editor --description 'Help on editor shortcuts' -complete -c help -x -a variables --description 'Help on environment variables' -complete -c help -x -a color --description 'Help on setting syntax highlighting colors' - -complete -c help -x -a globbing --description 'Help on parameter expansion (Globbing)' -complete -c help -x -a expand --description 'Help on parameter expansion (Globbing)' -complete -c help -x -a expand-variable --description 'Help on variable expansion $VARNAME' -complete -c help -x -a expand-home --description 'Help on home directory expansion ~USER' -complete -c help -x -a expand-brace --description 'Help on brace expansion {a,b,c}' -complete -c help -x -a expand-wildcard --description 'Help on wildcard expansion *.*' -complete -c help -x -a expand-command-substitution --description 'Help on command substitution (SUBCOMMAND)' -complete -c help -x -a expand-process --description 'Help on process expansion %JOB' +complete -c help -x -a history-search --description 'Searchable history' +complete -c help -x -a identifiers --description 'Shell variable and function names' +complete -c help -x -a initialization --description 'Initialization files' +complete -c help -x -a introduction --description 'Introduction' +complete -c help -x -a issues --description 'Common issues with fish' +complete -c help -x -a job-control --description 'Running multiple programs' +complete -c help -x -a killring --description 'Copy and paste (Kill Ring)' +complete -c help -x -a more-help --description 'Further help and development' +complete -c help -x -a multiline --description 'Multiline editing' +complete -c help -x -a other --description 'Other features' +complete -c help -x -a piping --description 'Piping' +complete -c help -x -a prompt --description 'Programmable prompt' +complete -c help -x -a quotes --description 'Quotes' +complete -c help -x -a redirects --description 'Input/Output (IO) redirection' +complete -c help -x -a shared-binds --description 'Shared bindings' +complete -c help -x -a syntax --description 'Introduction to the fish syntax' +complete -c help -x -a syntax-background --description 'Background jobs' +complete -c help -x -a syntax-conditional --description 'Conditional execution of code and flow control' +complete -c help -x -a syntax-function --description 'Functions' +complete -c help -x -a syntax-function-autoloading --description 'Autoloading functions' +complete -c help -x -a syntax-function-wrappers --description 'Defining aliases' +complete -c help -x -a syntax-job-control --description 'Job control' +complete -c help -x -a syntax-words --description 'Some common words' +complete -c help -x -a title --description 'Programmable title' +complete -c help -x -a variables --description 'Shell variables' +complete -c help -x -a variables-arrays --description 'Arrays' +complete -c help -x -a variables-color --description 'Variables for changing highlighting colors' +complete -c help -x -a variables-export --description 'Exporting variables' +complete -c help -x -a variables-functions --description 'Variable scope for functions' +complete -c help -x -a variables-locale --description 'Locale variables' +complete -c help -x -a variables-scope --description 'Variable scope' +complete -c help -x -a variables-special --description 'Special variables' +complete -c help -x -a variables-status --description 'The status variable' +complete -c help -x -a variables-universal --description 'More on universal variables' +complete -c help -x -a vi-mode --description 'Vi mode commands' +complete -c help -x -a vi-mode-command --description 'Command mode' +complete -c help -x -a vi-mode-insert --description 'Insert mode' +complete -c help -x -a vi-mode-visual --description 'Visual mode'