[OpenAFS] Re: [OpenAFS-Doc] Forwarded documentation rant

Chas Williams (CONTRACTOR) chas@cmf.nrl.navy.mil
Mon, 19 Apr 2010 15:41:15 -0400


In message <878w8jclb5.fsf@windlord.stanford.edu>,Russ Allbery writes:
>POD is capable of including enough information that you could get them
>back, and most of the high-level references are still there.  The
>low-level references (to specific sections of particular pieces of
>documentation) would need additional annotations.

yes, pod is but i dont believe any of the linkage tags where preserved
when the documentation was converted over from the .html.  i have
dreams of re-doing the conversion to get the links and diff between
the two trees to put the links back.

>On the other hand, I'm not sure how large the audience is for that work
>any more.  Printing things like this out has I think become a lot less

which is why i think the cross references between the man pages is 
somewhat useful.  when formatted as html it makes is easier to go
see the reference command -- just follow the link.  however, i dont
recall how much there was.  this would sort of determine whether or
not this would even be worth the effort.