fish-shell/sphinx_doc_src/cmds/fish_vcs_prompt.rst
David Adam 02d82dcf85 docs: update all command synopsis formatting
Adds synopses for those commands missing them.

Moves all synopsis sections to code blocks. This improves the appearance, although highlighting as
fish code may not be the ideal appearance.
2019-09-17 17:59:04 +08:00

40 lines
1012 B
ReStructuredText

.. _cmd-fish_vcs_prompt:
fish_vcs_prompt - output version control system information for use in a prompt
===============================================================================
Synopsis
--------
::
function fish_prompt
echo -n (pwd)(fish_vcs_prompt) '$ '
end
Description
-----------
The ``fish_vcs_prompt`` function displays information about the current version control system (VCS) repository, if any.
It calls out to VCS-specific functions. The currently supported systems are:
- :ref:`fish_git_prompt <cmd-fish_git_prompt>`
- :ref:`fish_hg_prompt <cmd-fish_hg_prompt>`
- :ref:`fish_svn_prompt <cmd-fish_svn_prompt>`
If a VCS isn't installed, the respective function does nothing.
For more information, see the documentation for each of the functions above.
Example
-------
A simple prompt that displays all known VCS info::
function fish_prompt
...
set -g __fish_git_prompt_showupstream auto
printf '%s %s$' $PWD (fish_vcs_prompt)
end