fish-shell/doc_src/cmds/popd.rst

.. _cmd-popd:

popd - move through directory stack
===================================

Synopsis
--------

``popd``

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

``popd`` removes the top directory from the :ref:`directory stack <directory-stack>` and changes the working directory to the new top directory. Use :ref:`pushd <cmd-pushd>` to add directories to the stack.

Example
-------

::

    pushd /usr/src
    # Working directory is now /usr/src
    # Directory stack contains /usr/src

    pushd /usr/src/fish-shell
    # Working directory is now /usr/src/fish-shell
    # Directory stack contains /usr/src /usr/src/fish-shell

    popd
    # Working directory is now /usr/src
    # Directory stack contains /usr/src

See Also
--------

- the :ref:`dirs <cmd-dirs>` command to print the directory stack
- the :ref:`cdh <cmd-cdh>` command which provides a more intuitive way to navigate to recently visited directories.
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			`.. _cmd-popd:`

Switch command docs from \section to reStructuredText 2018-12-17 01:39:33 +00:00			`popd - move through directory stack`
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`
			`--------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
More synopsis work. A great leap forward 2021-12-22 01:24:47 +00:00			``popd``
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
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			``popd`` removes the top directory from the :ref:`directory stack <directory-stack>` and changes the working directory to the new top directory. Use :ref:`pushd <cmd-pushd>` to add directories to the stack.
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			`Example`
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
Switch \fish sections to rst format 2018-12-19 03:14:04 +00:00			`::`

			`pushd /usr/src`
			`# Working directory is now /usr/src`
			`# Directory stack contains /usr/src`
docs: whitespace cleanup in source Fixes some lint warnings. 2019-09-17 08:50:52 +00:00
Switch \fish sections to rst format 2018-12-19 03:14:04 +00:00			`pushd /usr/src/fish-shell`
			`# Working directory is now /usr/src/fish-shell`
			`# Directory stack contains /usr/src /usr/src/fish-shell`
docs: whitespace cleanup in source Fixes some lint warnings. 2019-09-17 08:50:52 +00:00
Switch \fish sections to rst format 2018-12-19 03:14:04 +00:00			`popd`
			`# Working directory is now /usr/src`
			`# Directory stack contains /usr/src`

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			`See Also`
			`--------`

			- the :ref:`dirs <cmd-dirs>` command to print the directory stack
			- the :ref:`cdh <cmd-cdh>` command which provides a more intuitive way to navigate to recently visited directories.