diff --git a/doc_src/pushd.txt b/doc_src/pushd.txt
index 25d939367..8fad3bd71 100644
--- a/doc_src/pushd.txt
+++ b/doc_src/pushd.txt
@@ -9,6 +9,13 @@ pushd [DIRECTORY]
 
 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.
 
+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`.
 
 \subsection pushd-example Example
 
@@ -21,7 +28,15 @@ pushd /usr/src/fish-shell
 # Working directory is now /usr/src/fish-shell
 # Directory stack contains /usr/src /usr/src/fish-shell
 
-popd
+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
+# 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
 \endfish