Add jc function, jump to a subdirectory of the current working directory.

Closes #156.

ChangeLog

@@ -2,13 +2,18 @@
 # Summary of release changes, see commit history for more details:
 # https://github.com/joelthelion/autojump/commits/master/
 
-* Release v21.1:
+* Release v21.2.0:
+
+	- Add `jc` command (jump child). Jumps to a subdirectory of the current
+	working directory.
+
+* Release v21.1.0:
 
   - install.sh is rewritten to add support for --path and --destdir options,
   making it easier for package maintainers to install autojump specifically into
   certain locations. Thanks to jjk-jacky for his contributions.
 
-* Release v21:
+* Release v21.0.0:
 
   - New mailing list for developer discussion and announcements:
 
@@ -83,7 +88,7 @@
 
   - Miscellaneous refactoring, bug fixes, documentation updates.
 
-* Release v20:
+* Release v20.0.0:
 
   - Python versions supported is now v2.7+ and v3.2+ due to rewrite using
   argparse.
@@ -112,13 +117,13 @@
 
   - Miscellaneous bug fixes.
 
-* Release v19:
+* Release v19.0.0:
 
   - prototype `cp` and `mv` directory tab completion
   - Debian post-installation instructions
   - minor Mac OS X fixes
 
-* Release v18:
+* Release v18.0.0:
 
   - add automated version numbering
   - performance tweaks to reduce filesystem checks

README.md

@@ -6,10 +6,15 @@ autojump - a faster way to navigate your filesystem
 SYNOPSIS
 --------
 
-Jump to a previously visited directory 'foobar':
+Jump to a previously visited directory that contains 'foo':
 
     j foo
 
+Jump to a previously visited subdirectory of the current working
+directory:
+
+    jc bar
+
 Show all database entries and their respective key weights:
 
     j --stat

bin/autojump

@@ -34,7 +34,7 @@ import re
 import shutil
 from tempfile import NamedTemporaryFile
 
-VERSION = 'release-v21.1.4'
+VERSION = 'release-v21.2.0'
 MAX_KEYWEIGHT = 1000
 MAX_STORED_PATHS = 1000
 COMPLETION_SEPARATOR = '__'

bin/autojump.bash

@@ -75,7 +75,7 @@ function j {
         return
     fi
 
-    new_path="$(autojump $@)"
+    new_path="$(autojump ${@})"
     if [ -d "${new_path}" ]; then
         echo -e "\\033[31m${new_path}\\033[0m"
         cd "${new_path}"
@@ -85,3 +85,11 @@ function j {
         false
     fi
 }
+
+function jc {
+    if [[ ${@} == -* ]]; then
+        j ${@}
+    else
+        j $(pwd) ${@}
+    fi
+}

bin/autojump.zsh

@@ -42,7 +42,7 @@ function j {
         return
     fi
 
-    local new_path="$(autojump $@)"
+    local new_path="$(autojump ${@})"
     if [ -d "${new_path}" ]; then
         echo -e "\\033[31m${new_path}\\033[0m"
         cd "${new_path}"
@@ -52,3 +52,11 @@ function j {
         false
     fi
 }
+
+function jc {
+    if [[ ${@} == -* ]]; then
+        j ${@}
+    else
+        j $(pwd) ${@}
+    fi
+}

docs/autojump.1

@@ -4,7 +4,7 @@
 autojump - a faster way to navigate your filesystem
 .SS SYNOPSIS
 .PP
-Jump to a previously visited directory \[aq]foobar\[aq]:
+Jump to a previously visited directory that contains \[aq]foo\[aq]:
 .IP
 .nf
 \f[C]
@@ -12,6 +12,15 @@ j\ foo
 \f[]
 .fi
 .PP
+Jump to a previously visited subdirectory of the current working
+directory:
+.IP
+.nf
+\f[C]
+jc\ bar
+\f[]
+.fi
+.PP
 Show all database entries and their respective key weights:
 .IP
 .nf

docs/header.md

@@ -3,10 +3,14 @@
 autojump - a faster way to navigate your filesystem
 
 ## SYNOPSIS
-Jump to a previously visited directory 'foobar':
+Jump to a previously visited directory that contains 'foo':
 
     j foo
 
+Jump to a previously visited subdirectory of the current working directory:
+
+    jc bar
+
 Show all database entries and their respective key weights:
 
     j --stat