Re: [AD] new makedoc tool

[Peter Wang <tjaden@xxxxxxxxxx>]

On 2005-07-01, Elias Pschernig <elias@xxxxxxxxxx> wrote:
> On Sat, 2005-07-02 at 00:51 +1000, Peter Wang wrote:
> > Other than for debugging, is there much use in being able to read the
> > output?  You can run it through HTML Tidy (tidy -indent -xml) to get
> > indented output (though it wrecks non-freeform text) or view it through
> > Firefox to see the structure.
> 
> No, there's no real use, just looks prettier :)

I made it have indented output.  Lines aren't rewrapped though.

> > I've just written a word wrapping routine here, but I don't think it's
> > useful; makedoc lines are chopped every so often anyway.  Indenting tags
> 
> Useful for text output. The current way of copying ._tx lines 1:1 to the
> output surely never was a good idea.

At least it encourages makedoc authors to wrap their lines :)

> Great. I think that's all the important formats then. CHM/RTF/devhelp
> probably can be output through docbook or something already.

We should have a native HTML backend, but my HTML skills are so 1996.
It should not be hard for someone else to adapt the DocBook or XML
backends.

> How does the future path look? I guess, allegro._tx (and all the
> other ._tx) can be moved from the 4.3.x branch to the makedoc module or
> a separate docs module.

Any reason?

I'd like to hear what Grzegorz has to say, if he's listening.

Peter