Re: [OpenAFS] How to volunteer?

2007-04-10 Thread tedc
ReadIris can OCR the doc/pdf pdfs into .doc or WordML format.. ___ OpenAFS-info mailing list OpenAFS-info@openafs.org https://lists.openafs.org/mailman/listinfo/openafs-info

Re: [OpenAFS] How to volunteer?

2007-04-10 Thread Jim Rees
I just committed doc/README to the source tree. I'm sure it's incomplete and maybe even wrong, so please send corrections. I prefer actual text to vague statements. === What's in the "doc" subdirectory ** doc/html original ibm html doc, no longer used ** doc/man-pages pod sources for man pages

RE: [OpenAFS] How to volunteer?

2007-04-09 Thread ted creedon
Doesn't seem to be in the sources... Is it in the cvs tree? -Original Message- From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] On Behalf Of chas williams - CONTRACTOR Sent: Monday, April 09, 2007 12:35 PM To: Jim Rees Cc: OpenAFS-Info Subject: Re: [OpenAFS] How to volunteer?

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread Russ Allbery
"chas williams <- CONTRACTOR" <[EMAIL PROTECTED]>> writes: > i am not the doc guru, but > doc/htmloriginal ibm html doc > doc/man-pages pod sources for man pages (converted from > original ibm html source). > doc/xml xml sources for manu

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread Russ Allbery
Jim Rees <[EMAIL PROTECTED]> writes: > This information should be in the tree somewhere, probably either > README.DOC or doc/README. Right now if you look in the doc subdir it's > not clear what you're looking at. There should also be something about > doc/man-pages. > I'll create the file if w

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread Russ Allbery
Christopher D Clausen <[EMAIL PROTECTED]> writes: > Is the openafs-doc list being actively used? There don't seem to have > been any posts since Feb 2006. > https://lists.openafs.org/mailman/listinfo/openafs-doc > I would imagine that anyone working on documentation should be on this > list.

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread chas williams - CONTRACTOR
In message <[EMAIL PROTECTED]>,Jim Rees writes: >This information should be in the tree somewhere, probably either README.DOC >or doc/README. Right now if you look in the doc subdir it's not clear what >you're looking at. There should also be something about doc/man-pages. i am not the doc guru,

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread Jim Rees
chas williams - CONTRACTOR wrote: the ibm html documentation has been converted to xml (the preferred format). its in the cvs repository. its a straight conversion with little editing so the documentation still says 'AFS 3.6'. i didnt proof every single page so there might be a few erro

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread Christopher D. Clausen
Jason Edgecombe <[EMAIL PROTECTED]> wrote: > Russ Allbery wrote: >> Russ Allbery <[EMAIL PROTECTED]> writes: >>> Basically, please feel free to pick any of the documentation and >>> just let me know what you're working on. As you finish >>> modifications, the easiest way for me to process those ch

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread Jason Edgecombe
Russ Allbery wrote: Russ Allbery <[EMAIL PROTECTED]> writes: Basically, please feel free to pick any of the documentation and just let me know what you're working on. As you finish modifications, the easiest way for me to process those changes is as unified diffs, but if you want to send a

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread Russ Allbery
Russ Allbery <[EMAIL PROTECTED]> writes: > Basically, please feel free to pick any of the documentation and just > let me know what you're working on. As you finish modifications, the > easiest way for me to process those changes is as unified diffs, but if > you want to send a complete replaceme

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread Russ Allbery
Derrick J Brashear <[EMAIL PROTECTED]> writes: > Russ Allbery has been coordinating documentation work. Please talk to > him before you start on something if you'd like to avoid duplicating > effort. Hi Jason, I'm sorry about the delay. I was on vacation. Here's where we're currently at: The

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread chas williams - CONTRACTOR
ck J Brashear >Cc: Jason Edgecombe; OpenAFS-Info >Subject: Re: [OpenAFS] How to volunteer? > >the ibm html documentation has been converted to xml (the preferred >format). its in the cvs repository. its a straight conversion with >little editing so the documentation still says &#

RE: [OpenAFS] How to volunteer?

2007-04-09 Thread ted creedon
, April 09, 2007 7:34 AM To: Derrick J Brashear Cc: Jason Edgecombe; OpenAFS-Info Subject: Re: [OpenAFS] How to volunteer? the ibm html documentation has been converted to xml (the preferred format). its in the cvs repository. its a straight conversion with little editing so the documentation still

Re: [OpenAFS] How to volunteer?

2007-04-09 Thread chas williams - CONTRACTOR
the ibm html documentation has been converted to xml (the preferred format). its in the cvs repository. its a straight conversion with little editing so the documentation still says 'AFS 3.6'. i didnt proof every single page so there might be a few errors (mostly in tables, and command syntaxes

Re: [OpenAFS] How to volunteer?

2007-04-07 Thread Derrick J Brashear
Russ Allbery has been coordinating documentation work. Please talk to him before you start on something if you'd like to avoid duplicating effort. As to unit tests, that's an open question. We should probably start a discussion on openafs-devel about it On Sat, 7 Apr 2007, Jason Edgecombe wro

Re: [OpenAFS] How to volunteer?

2007-04-07 Thread Jason Edgecombe
ok, what format should the docs be converted to? So we need a manual for each hardware architecture like i386 or sparc? I can take a crack at the scripts, but I need an afs path or url for the location of the scripts. Jason ted creedon wrote: There are a number of perl scripts that work o

RE: [OpenAFS] How to volunteer?

2007-04-07 Thread ted creedon
There are a number of perl scripts that work on the IBM htm docs. Most of the docs are in LaTex format on my ftp server. The perl scripts need some improvement but the concept is sound. The Quick Beginnings manual needs to have selectable target architectures so one can emit a manual for the spec