[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Info Problem



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 <bijan@psq.com>
http://www.crasseux.com

Attachment: signature.asc
Description: Digital signature


Reply to: