setup
 -----
 
-To set up a directory with symbolic links to the relevant .do files and other
-important files, run ./add_dir.sh DIRECTORY.
+To set up a directory with symbolic links to the relevant files in ./processor/,
+run ./add_dir.sh DIRECTORY.
 
 You can then enter the directory and run redo there. This will generate article
 .html files from all .md and .rst files, plus a ./index.html, and a ./feed.xml.
 also be generated a .uuid and a .intermediate file; furthermore, files with
 metadata used in ./feed.xml and ./index.html will be built and can be edited to
 customize the blog: ./url, ./author, ./uuid, ./title.) 
+
+bugs
+----
+
+Due to bad shell scripting in ./processor/index.html.do and
+./processor/feed.xml.do (see the FIXME notes there), source files whose names
+contain "$" break the redo processing.
 
 
 # Iterate through most recent entries (go by lastmod date of source files) to
 # build feed head "updated" element, and individual entries.
+# FIXME: This ls parsing is a bad way to loop through the sorted files. Besides,
+# $('\0') is a bashism.
 first_run=0
 files=`ls -1t *.rst *.md | head -10 | tr '\n' $'\0'`
 oldIFS="$IFS"
 
 printf "<title>%s</title>\n</head>\n<body>\n" "$blog_title"
 printf "<h1>%s</h1>\n<ul>\n" "$blog_title"
 
-# Iterate through entries sorted by lastmod of their source files, write entry
-# list. 
+# Iterate through entries sorted by lastmod of their source files, write entry.
+# FIXME: This ls parsing is a bad way to loop through the sorted files. Besides,
+# $('\0') is a bashism.
 first_run=0
 files=`ls -1t *.rst *.md | tr '\n' $'\0'`
 oldIFS="$IFS"