mirror of
https://github.com/fish-shell/fish-shell.git
synced 2024-12-04 09:13:39 +08:00
02d82dcf85
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.
52 lines
1.3 KiB
ReStructuredText
52 lines
1.3 KiB
ReStructuredText
.. _cmd-pushd:
|
|
|
|
pushd - push directory to directory stack
|
|
=========================================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
::
|
|
|
|
pushd [DIRECTORY]
|
|
|
|
Description
|
|
-----------
|
|
|
|
The ``pushd`` function adds ``DIRECTORY`` to the top of the directory stack and makes it the current working directory. :ref:`popd <cmd-popd>` will pop it off and return to the original directory.
|
|
|
|
Without arguments, it exchanges the top two directories in the stack.
|
|
|
|
``pushd +NUMBER`` rotates the stack counter-clockwise i.e. from bottom to top
|
|
|
|
``pushd -NUMBER`` rotates clockwise i.e. top to bottom.
|
|
|
|
See also ``dirs`` and ``dirs -c``.
|
|
|
|
You may be interested in the :ref:`cdh <cmd-cdh>` command which provides a more intuitive way to navigate to recently visited directories.
|
|
|
|
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
|
|
|
|
pushd /tmp/
|
|
# Working directory is now /tmp
|
|
# Directory stack contains /tmp /usr/src /usr/src/fish-shell
|
|
|
|
pushd +1
|
|
# Working directory is now /usr/src
|
|
# Directory stack contains /usr/src /usr/src/fish-shell /tmp
|
|
|
|
popd
|
|
# Working directory is now /usr/src/fish-shell
|
|
# Directory stack contains /usr/src/fish-shell /tmp
|