Reference dirs builtin in pushd/popd (#5759)

pages/common/popd.md

@@ -0,0 +1,16 @@
+# popd
+
+> Remove a directory placed on the directory stack via the pushd shell built-in.
+> See also `pushd` to place a directory on the stack and `dirs` to display directory stack contents.
+
+- Remove the top directory from the stack and cd to it:
+
+`popd`
+
+- Remove the Nth directory (starting from zero to the left from the list printed with `dirs`):
+
+`popd +N`
+
+- Remove the Nth directory (starting from zero to the right from the list printed with `dirs`):
+
+`popd -N`

pages/common/pushd.md

@@ -0,0 +1,16 @@
+# pushd
+
+> Place a directory on a stack so it can be accessed later.
+> See also `popd` to switch back to original directory and `dirs` to display directory stack contents.
+
+- Switch to directory and push it on the stack:
+
+`pushd {{directory}}`
+
+- Switch first and second directories on the stack:
+
+`pushd`
+
+- Rotate stack by making the 5th element the top of the stack:
+
+`pushd +4`