On Fri, Dec 05, 2003 at 11:41:27AM -0800, Karsten M. Self wrote: > > 5) It splits a programs docs into multiple pages. > > > > Again you can convert it to html all on one page. > > You brilliantly miss the somewhat minor point that the info document > *isn't* a single page, readily searchable, and accessible via a single > command-line statement, by default, and that the user has to go through > several nontrivial steps (particularly for the novice or naive user) to > extract another, more useful, format. I certainly went years without > knowing of such options.
Cool well if the only problem is that you people like man format better than info format I think I've found a solution. There is a little program called texi2roff which can convert Texinfo documentation to roff format. It should be possible to modify it to split a large Texinfo file into medium sized manpages. Sort of like the perl documentation. Then you have one manpage per topic. For example the documentation for emacs would be divided into a manpage about editing, a manpage about the screen, a manpage about major modes, etc. And the main manpage would list general options and the other manpages. Kind of like the perl documentation. Do you think this would be useful. I could probably write something like this over Christmas vacation. P.S. texi2roff can already take a huge texinfo manual like the gnu emacs one or the gcc one and format it as a large roff document. Which can be converted to ps by groff or viewed on the screen by nroff. I just want to make it practical by automatically splitting it up so that we don't end up with 1000 page manpages. Bijan -- Bijan Soleymani <[EMAIL PROTECTED]> http://www.crasseux.com
signature.asc
Description: Digital signature
