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 chapter/section pointers. On Mon, Apr 19, 2010 at 6:35 AM, Chas Williams (CONTRACTOR) < c...@cmf.nrl.navy.mil> wrote: > In message <4bcb8e43.8030...@secure-endpoints.com>,Jeffrey Altman writes: > >into a source form (including consistent formatting and > >indexing) that could be used by contributors to submit > >changes. All of the documentation that we have is now > >in DocBook format and the man pages are in Perl POD format. > ... > >It has only been in the 18 months that the XML sources > >have been available in this easy to edit form. It has > >been my hope that with the improved source format availability > >that a broader range of users and administrators would > >contribute to the depth, breadth, and usability of the > >available documentation. > > the formatting isnt entirely consistent. it is close however. it was > inconsistent in the original html, i tried to correct it somewhat in > the xml but alas i am only a human. someone really needs to write (and > i was going to do it) a document that decribes what tags should be used > in the various examples. > > other projects have similar style guides and i really think it would help > people out. learning docbook is pretty easy but applying it consistently > is not easy. > > on a general note, people might be intimidated by the sheer volume of > documentation. usually, it is not enough documentation when it comes > to open source projects. openafs is one of the few to my knowledge that > actually has a pretty complete set of documentation. some of the docs > are outdated now, but at one point is was correct and consistent. > _______________________________________________ > OpenAFS-doc mailing list > openafs-...@openafs.org > https://lists.openafs.org/mailman/listinfo/openafs-doc >
