html-style-todo-20060228

Some style sheet updates and lots of to-do updates based on feedback from
C. Alex North-Keys.

diff --git a/doc/man-pages/README b/doc/man-pages/README
index 2dd0c4a..50bec67 100644 (file)
--- a/doc/man-pages/README
+++ b/doc/man-pages/README
@@ -237,11 +237,6 @@ Known Problems
      default and says that the system must be rebooted after shutdown,
      which isn't the case at least on Linux.
 
-   * All of the paths in the man pages are the Transarc paths.  I'm not
-     sure how best to deal with the possibility of installing OpenAFS in
-     multiple different paths, but it would be good to at least
-     acknowledge the issue.
-
    * bos listkeys and the KeyFile man page assume that you're using the
      kaserver.
 
@@ -272,6 +267,24 @@ Known Problems
      and the same transform needs to be applied to the other pages.  See
      the fs intro page for the details.
 
+   * The references to the other OpenAFS manuals, such as the Quick Start
+     guide and the Admin Guide, should be links, probably to the documents
+     on openafs.org.
+
+   * There's no mention of the Kerberos v5 support.  At least, we need
+     some disclaimers under klog and friends talking about sites without
+     kaserver (and possibly without fakeka), and deprecation warnings
+     on the .krb varient commands.
+
+   * We need a way to add links to other man pages (kinit most notably)
+     without creating dangling links in the HTML output.  This probably
+     means that the HTML conversion script needs to generate at startup
+     a list of all valid man page link targets and not linkify the ones
+     that don't match a valid target.
+
+   * Provide a way to substitute the correct paths into the HTML output
+     from Autoconf results.
+
   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.

diff --git a/doc/man-pages/style.css b/doc/man-pages/style.css
index b156e14..f5b8a8d 100644 (file)
--- a/doc/man-pages/style.css
+++ b/doc/man-pages/style.css
@@ -17,14 +17,15 @@
 @media screen, tty, tv, projection {
   .noscreen { display: none; }
 
-  a:link    { color: #7070ff; text-decoration: underline; }
-  a:visited { color: #e030ff; text-decoration: underline; }
-  a:active  { color: #800000; text-decoration: underline; }
-  body.contentspage a            { text-decoration: none; }
+  a:link                      { text-decoration: none; }
+  a:visited                   { text-decoration: none; }
+  a:active                    { text-decoration: none; }
+  a:hover   { background: #fec; text-decoration: none; }
+  body.contentspage a         { text-decoration: none; }
   a.u { color: #000 !important; text-decoration: none; }
 
   body.pod {
-    margin: 0 5px;
+    margin:           0 5px;
     color:            #000;
     background-color: #fff;
   }
@@ -58,21 +59,21 @@
   }
   
   body.contentspage h1  {
-    color: #22f;
-    margin-left: 1em;
-    margin-right: 1em;
-    text-indent: -.9em;
-    font-family: Tahoma, Verdana, Helvetica, Arial, sans-serif;
-    font-weight: normal;
+    color:         #000;
+    margin-left:   1em;
+    margin-right:  1em;
+    text-indent:   -.9em;
+    font-family:   Tahoma, Verdana, Helvetica, Arial, sans-serif;
+    font-weight:   normal;
     border-top:    medium solid #000;
     border-bottom: medium solid #000;
-    text-align: center;
+    text-align:    center;
   }
 
   body.contentspage th {
-    font-weight: bold;
-    font-size: large;
-    text-align: left;
+    font-weight:   bold;
+    font-size:     large;
+    text-align:    left;
   }
 
   body.contentspage td { padding: 0 0.5em; }