\section pushd pushd - push directory to directory stack

\subsection pushd-synopsis Synopsis
\fish{syn}
pushd [DIRECTORY]
\endfish

\subsection pushd-description Description
The `pushd` function adds `DIRECTORY` to the top of the directory stack
and makes it the current working directory. <a href="#popd">`popd`</a> will pop it off and
return to the original directory.

\subsection pushd-example Example

\fish
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
\endfish