fish-shell/doc_src/cmds/help.rst
Fabian Homborg fd45877848 docs: Link builtins
When we say "the XYZ command/builtin", we should typically include a
link. The exceptions are

- In the documentation for that command - no need to link to ulimit in
  the ulimit page
- When we've already linked before - not every thing needs to be
  clickable, or clicking it will cause the browser to mark fifty words
  as visited. This is roughly what wikipedia does for crosslinks.

[ci skip]
2020-03-21 15:31:25 +01:00

30 lines
853 B
ReStructuredText

.. _cmd-help:
help - display fish documentation
=================================
Synopsis
--------
::
help [SECTION]
Description
-----------
``help`` displays the fish help documentation.
If a ``SECTION`` is specified, the help for that command is shown.
If the BROWSER environment variable is set, it will be used to display the documentation. Otherwise, fish will search for a suitable browser.
If you prefer to use a different browser (other than as described above) for fish help, you can set the 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.
Note that most builtin commands display their help in the terminal when given the ``--help`` option.
Example
-------
``help fg`` shows the documentation for the :ref:`fg <cmd-fg>` builtin.