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

2010-04-19 Thread Ted Creedon
I had the old IBM docs converted to LaTex several years ago. I published the Quick Start with switches for Linux, Unix, etc. in quarto handbook form (4 pages/sheet). and made myself a pocket book. Forgotten is all the sophisticated forward and reverse cross referencing and page numbering and chap

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

2010-04-19 Thread Chas Williams (CONTRACTOR)
In message ,Ted Creedon writes: >Forgotten is all the sophisticated forward and reverse cross referencing and >page numbering and chapter/section pointers. it is still there. btw, you cant reference by page numbers. this is a very strange idea. different media is going to have different page

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

2010-04-19 Thread Russ Allbery
"Chas Williams (CONTRACTOR)" writes: > it is still there. btw, you cant reference by page numbers. this is > a very strange idea. different media is going to have different page > numbers. references inside the admin reference manual were lost though. > however, that documents has changed en

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

2010-04-19 Thread Coy Hile
enafs-info-ad...@openafs.org [openafs-info-ad...@openafs.org] on behalf of Russ Allbery [...@stanford.edu] Sent: Monday, April 19, 2010 3:08 PM To: openafs-info@openafs.org Subject: Re: [OpenAFS] Re: [OpenAFS-Doc] Forwarded documentation rant "Chas Williams (CONTRACTOR)" writes: > it is

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

2010-04-19 Thread Chas Williams (CONTRACTOR)
In message <878w8jclb5@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

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

2010-04-19 Thread Russ Allbery
"Chas Williams (CONTRACTOR)" writes: > 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 det

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

2010-04-19 Thread Ted Creedon
When you get to progressive trifocals (after coding since 1962...) you will sympathize with those who are set in their ways. I completely understand why the newer generation prefers POD, etc.. It is less labor intensive to produce an acceptable result. There is a docbook 2 Latex that I intend to