Add v21 release notes, minor documentation update.

docs/autojump.1

@@ -103,6 +103,26 @@ export\ AUTOJUMP_KEEP_SYMLINKS=1
 .RE
 .SS ADVANCED USAGE
 .IP \[bu] 2
+Using Multiple Arguments
+.RS 2
+.PP
+Let\[aq]s assume the following database:
+.IP
+.nf
+\f[C]
+30\ \ \ /home/user/mail/inbox
+10\ \ \ /home/user/work/inbox
+\f[]
+.fi
+.PP
+\f[C]j\ in\f[] would jump into /home/user/mail/inbox as the higher
+weighted entry.
+However you can pass multiple arguments to autojump to prefer a
+different entry.
+In the above example, \f[C]j\ w\ in\f[] would then jump you into
+/home/user/work/inbox.
+.RE
+.IP \[bu] 2
 Change Directory Weight
 .RS 2
 .PP
@@ -126,12 +146,6 @@ with \f[C]-\f[].
 If you want to jump a directory called \f[C]--music\f[], try using
 \f[C]j\ music\f[] instead of \f[C]j\ --music\f[].
 .IP \[bu] 2
-zsh (bug #86)
-.RS 2
-.PP
-Tab completion does not work.
-.RE
-.IP \[bu] 2
 jumpapplet (bug #59)
 .RS 2
 .PP

docs/body.md

@@ -38,6 +38,15 @@ Options must be passed to 'autojump' and not the 'j' wrapper function.
 
 ## ADVANCED USAGE
 
+- Using Multiple Arguments
+
+    Let's assume the following database:
+
+        30   /home/user/mail/inbox
+        10   /home/user/work/inbox
+
+    `j in` would jump into /home/user/mail/inbox as the higher weighted entry. However you can pass multiple arguments to autojump to prefer a different entry. In the above example, `j w in` would then jump you into /home/user/work/inbox.
+
 - Change Directory Weight
 
     To manually change a directory's key weight, you can edit the file _$XDG_DATA_HOME/autojump/autojump.txt_. Each entry has two columns. The first is the key weight and the second is the path:
@@ -50,10 +59,6 @@ Options must be passed to 'autojump' and not the 'j' wrapper function.
 
 - The jump function `j` does not support directories that begin with `-`. If you want to jump a directory called `--music`, try using `j music` instead of `j --music`.
 
-- zsh (bug #86)
-
-    Tab completion does not work.
-
 - jumpapplet (bug #59)
 
     Does not work in Gnome 3 shell or LDXE.