fish-shell/sphinx_doc_src/cmds/nextd.rst

.. _cmd-nextd:

nextd - move forward through directory history
==============================================

Synopsis
--------

nextd [ -l | --list ] [POS]


Description
-----------

``nextd`` moves forwards ``POS`` positions in the history of visited directories; if the end of the history has been hit, a warning is printed.

If the ``-l`` or ``--list`` flag is specified, the current directory history is also displayed.

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.

You may be interested in the :ref:`cdh <cmd-cdh>` command which provides a more intuitive way to navigate to recently visited directories.

Example
-------


::

    cd /usr/src
    # Working directory is now /usr/src
    
    cd /usr/src/fish-shell
    # Working directory is now /usr/src/fish-shell
    
    prevd
    # Working directory is now /usr/src
    
    nextd
    # Working directory is now /usr/src/fish-shell
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 17:05:09 +08:00			`.. _cmd-nextd:`

Switch command docs from \section to reStructuredText 2018-12-17 09:39:33 +08:00			`nextd - move forward through directory history`
Fix command section separator line lengths 2019-01-03 12:10:47 +08:00			`==============================================`
Switch command docs from \section to reStructuredText 2018-12-17 09:39:33 +08:00
Migrate the 'synopsis' sections to .rst format 2018-12-18 09:58:24 +08:00			`Synopsis`
			`--------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00
			`nextd [ -l \| --list ] [POS]`
Migrate the 'synopsis' sections to .rst format 2018-12-18 09:58:24 +08:00
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00
Convert \\subsection sections into rst format 2018-12-19 10:44:30 +08:00			`Description`
Fix command section separator line lengths 2019-01-03 12:10:47 +08:00			`-----------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00
Switch backticks to double backticks for rst compatibility 2018-12-20 04:02:45 +08:00			``nextd`` moves forwards ``POS`` positions in the history of visited directories; if the end of the history has been hit, a warning is printed.
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00
Switch backticks to double backticks for rst compatibility 2018-12-20 04:02:45 +08:00			If the ``-l`` or ``--list`` flag is specified, the current directory history is also displayed.
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00
Switch backticks to double backticks for rst compatibility 2018-12-20 04:02:45 +08: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.
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00
docs: More command labels [ci skip] 2019-03-31 17:28:13 +08:00			You may be interested in the :ref:`cdh <cmd-cdh>` command which provides a more intuitive way to navigate to recently visited directories.
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00
Convert \\subsection sections into rst format 2018-12-19 10:44:30 +08:00			`Example`
Fix command section separator line lengths 2019-01-03 12:10:47 +08:00			`-------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00


Switch \fish sections to rst format 2018-12-19 11:14:04 +08:00			`::`

			`cd /usr/src`
			`# Working directory is now /usr/src`

			`cd /usr/src/fish-shell`
			`# Working directory is now /usr/src/fish-shell`

			`prevd`
			`# Working directory is now /usr/src`

			`nextd`
			`# Working directory is now /usr/src/fish-shell`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-17 05:08:41 +08:00