STABLE14-man-page-todo-20060322

More to-do items for the documentation.

(cherry picked from commit db8d1da77aa792e0d042bf5dbe041c534350b277)

diff --git a/doc/man-pages/README b/doc/man-pages/README
index 50bec679d6d017e3894a5f565dcdaf5365a2da6f..1e384400aa08048ab531cfbc2a449303ce1f9cac 100644 (file)
--- a/doc/man-pages/README
+++ b/doc/man-pages/README
@@ -285,6 +285,15 @@ Known Problems
    * Provide a way to substitute the correct paths into the HTML output
      from Autoconf results.
 
+   * Currently, the man pages are built by regen.sh, which is somewhat
+     annoying since it takes a long time.  Figure out how better to do this
+     during the release process so that end users don't have to have
+     pod2man.
+
+   * Review the sections used for all man pages against what directories
+     the commands are installed into.  (In some cases, it may be better to
+     change the directory than the section of the man page.)
+
   If you notice other problems, please send them to the openafs-doc list
   even if you don't have time to fix them.  Someone else might, and we
   want to track all of the issues.