fish-shell/doc_src/cmds/help.rst
David Adam 3a23fdf359 docs: omnibus cleanup
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.
2022-03-12 00:21:13 +08:00

36 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.