fish-shell/doc_src/cmds/cdh.rst

.. _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
complete synopsis should just be a synopsis. 2021-12-11 08:41:09 +00:00			`.. _cmd-cdh:`
docs: Add labels to all commands This allows us to use :ref: references, which don't require hardcoding it as html [ci skip] 2019-03-31 09:05:09 +00:00
Switch command docs from \section to reStructuredText 2018-12-17 01:39:33 +00:00			`cdh - change to a recently visited directory`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`============================================`
Switch command docs from \section to reStructuredText 2018-12-17 01:39:33 +00:00
Migrate the 'synopsis' sections to .rst format 2018-12-18 01:58:24 +00:00			`Synopsis`
			`--------`

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 23:16:47 +00:00			``cdh`` [DIR]
Migrate the 'synopsis' sections to .rst format 2018-12-18 01:58:24 +00:00
Convert \\subsection sections into rst format 2018-12-19 02:44:30 +00:00			`Description`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`-----------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
cd, cdh, command, commandline Documentation. 2021-12-09 12:45:10 +00:00			``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``.
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
cd, cdh, command, commandline Documentation. 2021-12-09 12:45:10 +00:00			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.
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
Convert \\subsection sections into rst format 2018-12-19 02:44:30 +00:00			`See Also`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`--------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
doc: add section about directory history / stack This PR also adds "See Also" section in the related commands. 2020-04-04 11:01:53 +00:00			- 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