[asterisk-dev] Docs converted to TeX?

[Steven Critchfield]

On Tue, 2007-05-22 at 12:42 -0500, Eric "ManxPower" Wieling wrote:
> Russell Bryant wrote:
> > Eric "ManxPower" Wieling wrote:
> >> I discovered today that in -trunk all the docs have been converted to 
> >> TeX format.  Are these docs the only ones that will be in the release 
> >> tarball?  If so, I think it is a bad idea.
> >>
> >> We do not want to make people install yet another dependency to be 
> >> able to read the basic Asterisk documentation.
> > 
> > By the time Asterisk 1.6 comes around, I plan on editing the Asterisk 
> > release script to automatically include some user friendly format of the 
> > documentation in the tarball.  I am thinking HTML would probably be best.
> 
> Thank you.  Having a plaintext output would be nice as well.  I don't 
> run a GUI on my Asterisk boxes.  Having to download the HTML docs to a 
> machine with a GUI and a web browser would also be a hassle just to look 
> up 1 page of docs.  Even with things like URPMI/YUM/APT-GET, getting TeX 
> installed would be a significant hassle.

Umm, wouldn't you use w3m in text mode to view the html? Wouldn't being
able to jump to the appropriate section from an index be really worth
while. Of course maybe a conversion to some good ast-* man pages would
be good as well.
-- 
Steven Critchfield <critch at basesys.com>