1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept xml:lang="en" id="GUID-4E45570C-A0EF-522C-BD67-FC31E4092740"><title>pushd</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>Change the current directory, and push the old current directory onto the directory stack. </p> <p><userinput>pushd [ -sLP ] [ arg ] </userinput> </p> <p>or </p> <p><userinput>pushd [ -sLP ] old new </userinput> </p> <p>Change the current directory to <codeph>arg</codeph>. If <codeph>arg</codeph> is not specified, change to the second directory on the stack (that is, exchange the top two entries), or change to <codeph>$HOME</codeph> if the <codeph>PUSHD_TO_HOME</codeph> option is set or if there is only one entry on the stack. Otherwise, <codeph>arg</codeph> is interpreted as it would be by <xref href="GUID-89E0E8FE-6575-5A30-B25F-A873F5C5F389.dita">cd</xref>.The meaning of old and new is the same as for <codeph>cd</codeph>. </p> <p><userinput>pushd [ -sLP ] {+|-}n</userinput> </p> <p>Changes directory by rotating the directory list. An argument of the form <codeph>+n</codeph> identifies a stack entry by counting from the left of the list shown by the <xref href="GUID-3F1FA838-4B65-5692-8B73-AFB9896E5F10.dita">dirs</xref> command, starting with zero. An argument of the form <codeph>-n</codeph> counts from the right. If the <codeph>PUSHD_MINUS</codeph> option is set, the meanings of <codeph>+</codeph> and <codeph>-</codeph> in this context are swapped. </p> <p>If the option <codeph>PUSHD_SILENT</codeph> is not set, the directory stack will be printed after a <codeph>pushd</codeph> is performed. </p> <p>The options <codeph>-s</codeph>, <codeph>-L</codeph> and <codeph>-P</codeph> have the same meanings as for the <xref href="GUID-89E0E8FE-6575-5A30-B25F-A873F5C5F389.dita">cd</xref> builtin. </p> </conbody></concept>