X-Git-Url: https://git.openafs.org/?p=openafs.git;a=blobdiff_plain;f=doc%2Fman-pages%2FREADME;h=50bec679d6d017e3894a5f565dcdaf5365a2da6f;hp=2dd0c4a9bfac7e344b46e11b379d9d9fbc9e3106;hb=fed1cdb02241f6cffee9cdcb5d334f227fd011bb;hpb=6321cca1a5bdda2c9e8d9688d220eff0edd850f9 diff --git a/doc/man-pages/README b/doc/man-pages/README index 2dd0c4a..50bec67 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.