formatting

diff --git a/brc b/brc
index 49c9a26120fe0ea5620c8fa4c53043479d3da712..07ba8cf12a011154e2d2969e8341edfe39d335a5 100644 (file)
--- a/brc
+++ b/brc
@@ -318,10 +318,12 @@ h() {
 # note.
 
 ## copy bash completion
-# Usage: ORIGINAL_COMMAND TARGET_COMMAND...
 #
 # It copies how the bash completion works from one command to other
-# commands.
+# commands. Generally just use within a .bashrc.
+#
+# Usage: ORIGINAL_COMMAND TARGET_COMMAND...
+#
 ccomp() {
   local c src
   src=$1
@@ -336,12 +338,15 @@ ccomp() {
   eval $c $*
 }
 
-## BEGIN directory history tracking and navigation.
+## BEGIN functions to change directory better than cd ##
+#
+# The functions:
 #
-# use c instead of cd (could alias to cd if you wanted). b to go back, f
-# to go forward, cl to list recent directories and choose one.
+# c: acts like cd, but stores directory history: you could alias to cd if you wanted.
+# b: go back
+# f: go forward, cl to list recent directories and choose one.
 #
-# The finer details you may want to skip:
+# Finer details you may want to skip:
 #
 # We also define bl to print the list of back and forward directories.
 #
@@ -537,6 +542,7 @@ bl() {
     fi
   done
 }
+## BEGIN functions to change directory better than cd ##
 
 # pee do. run args as a command with output copied to syslog.
 #