Re: [AD] Makedoc patch (was: 4.0.x branch)

[Stepan Roh <stepan@xxxxxxxxxx>]

On Sun, 17 Feb 2002, Bob wrote:

> Grzegorz Adam Hankiewicz wrote:
> [snip]
> > What are the advangates of using XML over _tx?
>
> It's not a hack? Other than that, it would allow us to generate better HTML

Why? XML has nothing to do with HTML generation, it just defines format
for storing text data. Generation is as complicated as with _tx (if you
don't want to depend on external software, which _tx is not).

> (I did give makehtml a try...can't understand a bloody thing in it :)
> You can also nest containers in XML, which is useful for grouping related
> things. It also looks nicer :)
>
> Peter recommeneded using Lisp-style expressions instead. It comes back to
> mostly the same though.
>
> Here are some samples:
> http://pages.infinit.net/voidstar/alt_alleg.txt
> http://www.alphalink.com.au/~tjaden/dev/alleg_sexp.txt

Both are non-standard hacks. Writing generators could take a long time.
Either keep _tx format or move to something standard like DocBook
SGML/DocBook XML. There is no need to reimplementing the wheel.

Have a nice day.

Stepan Roh