diff --git a/doc/man-pages/README b/doc/man-pages/README index 2dd0c4a9bf..50bec679d6 100644 --- 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 b156e14547..f5b8a8d67b 100644 --- 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; }