formatting

diff --git a/brc b/brc
index 07ba8cf12a011154e2d2969e8341edfe39d335a5..940e1aa74db0730b63c896c9f38186460e88e710 100644 (file)
--- a/brc
+++ b/brc
@@ -344,14 +344,15 @@ ccomp() {
 #
 # 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.
+# f: go forward
+# cl: list recent directories and optionally choose one.
 #
 # Finer details you may want to skip:
 #
-# We also define bl to print the list of back and forward directories.
+# bl: print the list of back and forward directories.
 #
-# We keep 2 stacks, forward and back. Unlike with a web browser, the
-# forward stack is not erased when going somewhere new.
+# We keep 2 stacks of directories, forward and back. Unlike with a web
+# browser, the forward stack is not erased when going somewhere new.
 #
 # Recent directories are stored in ~/.cdirs.
 #
@@ -453,7 +454,7 @@ f() {
   #   printf "%s\n" "${_dir_forward[-1]}"
   # fi
 }
-# cd list
+# cl = cd list
 cl() {
   local i line input start
   local -A buttondirs alines
@@ -500,8 +501,8 @@ cl() {
     c "${buttondirs[$input]}"
   fi
 }
-# list the back and forward directories. i tend to forget this exists
-# and use cl instead.
+# bl = back list. lists the back and forward directories. i tend to
+# forget this exists and use cl instead.
 bl() {
   local start i j max
   max=10