[OpenAFS] Documentation project comments

[Russ Allbery]

Esther Filderman <mizmoose@gmail.com> writes:
> On 6/10/05, chas williams - CONTRACTOR <chas@cmf.nrl.navy.mil> wrote:

>> is there any hope of someone doing something with the man pages?
>> yes, i am a dinosaur, i still like man pages.

> I think Russ Allbery was working on man pages a while ago. Oh, Russ,
> whatever happened?

Thanks for the kick; I got off doing other things for a while, but keep
thinking I should get back to this, particularly now that I'm helping with
the OpenAFS packages for Debian.

I'll mail Alf and ask if there's anything newer than the last time I
looked, and start plugging away at this.

So that people know, if I write the man pages I'll write them all in POD,
based initially on the web page reference manual, and then use pod2man to
convert them to man pages.  One of the many pod2html converters can then
also be used to convert them to web pages.  If anyone objects strongly to
that approach, speak up now.

I think I can pretty easily do a few and get them submitted so that we can
get started, and then the work becomes very parallelizable.

-- 
Russ Allbery (rra@stanford.edu)             <http://www.eyrie.org/~eagle/>