fish-shell/doc_src/cmds/cdh.rst
Aaron Gyes af61ea1325 doc_src: Continue the slog through the letter F.
We are using only :: in a synopsis for fishscript examples given
of the command being documented.
2021-12-17 15:16:47 -08:00

29 lines
978 B
ReStructuredText

.. _cmd-cdh:
cdh - change to a recently visited directory
============================================
Synopsis
--------
``cdh`` [*DIR*]
Description
-----------
``cdh`` with no arguments presents a list of :ref:`recently visited directories <directory-history>`.
You can then select one of the entries by letter or number.
You can also press :kbd:`Tab` to use the completion pager to select an item from the list.
If you give it a single argument it is equivalent to ``cd DIR``.
Note that the ``cd`` command limits directory history to the 25 most recently visited directories.
The history is stored in the ``$dirprev`` and ``$dirnext`` variables which this command manipulates.
If you make those universal variables your ``cd`` history is shared among all fish instances.
See Also
--------
- the :ref:`dirh <cmd-dirh>` command to print the directory history
- the :ref:`prevd <cmd-prevd>` command to move backward
- the :ref:`nextd <cmd-nextd>` command to move forward