:pushd top-level command

$Revision: 5.0.2.3 $

Arguments: &optional dir

This command and the related :popd and :cd work just like their Unix C shell counterparts. :pushd changes the current directory to dir and adds it to the directory stack. If no argument is supplied, :pushd changes to the directory at the top of the directory stack and swaps the top two directories on the stack. :popd pops the current directory off the directory stack and changes the current directory to the directory that was next on that stack. :cd changes the current directory to dir (if supplied) or to the user's home directory (if dir is not supplied). On Windows, the home directory is taken to be C:\.

:pushd, :cd, and :popd all change the value of cl:*default-pathname-defaults* to have directory component the new current directory.

dir will be treated as a string but need not be surrounded in quotation marks.

See also excl:chdir (which is like :cd but does not change the value of cl:*default-pathname-defaults*) and excl:current-directory.

See also :dirs, which prints the stack of directories and :pwd, which prints the full path of the current directory.

The minimal abbreviation of :pushd is :pu.

See top_level.htm for more information on top-level commands.

The general documentation description is in introduction.htm. The index in index.htm.