mirror of
https://github.com/fish-shell/fish-shell
synced 2024-12-28 13:53:10 +00:00
3a23fdf359
Includes harmonizing the display of options and arguments, standardising terminology, using the envvar directive more broadly, adding help options to all commands that support them, simplifying some language, and tidying up multiple formatting issues. string documentation is not changed.
35 lines
942 B
ReStructuredText
35 lines
942 B
ReStructuredText
.. _cmd-help:
|
|
|
|
help - display fish documentation
|
|
=================================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. synopsis::
|
|
|
|
help [SECTION]
|
|
|
|
Description
|
|
-----------
|
|
|
|
``help`` displays the fish help documentation.
|
|
|
|
If a *SECTION* is specified, the help for that command is shown.
|
|
|
|
The **-h** or **--help** option displays help about using this command.
|
|
|
|
If the :envvar:`BROWSER`` environment variable is set, it will be used to display the documentation.
|
|
Otherwise, fish will search for a suitable browser.
|
|
To use a different browser than as described above, one can set the :envvar:`fish_help_browser` variable.
|
|
This variable may be set as a list, where the first element is the browser command and the rest are browser options.
|
|
|
|
Example
|
|
-------
|
|
|
|
``help fg`` shows the documentation for the :ref:`fg <cmd-fg>` builtin.
|
|
|
|
Notes
|
|
-----
|
|
|
|
Most builtin commands, including this one, display their help in the terminal when given the **--help** option.
|