Re: [AD] Makedoc patch (was: 4.0.x branch) |
[ Thread Index |
Date Index
| More lists.liballeg.org/allegro-developers Archives
]
On Sun, Feb 17, 2002 at 05:45:58PM +0100, Elias Pschernig wrote:
> For IE6, make sure you put the line @html_line_breaks_as_paragraphs
> somewhere into your allegro._tx (maybe this should be made default for
> the windows build?).
Hmmm... I'm not very sure about this, since it all looks ok to mee under Mozilla.
>
> Then you can do something like the attached patch. It puts the function
> definitions inside a <h3> and inside a <blockquote> for example. It looks
> not good though.. the best way would be to have each function in a separate
> HTML page I think.
>
> --
> Elias Pschernig
On Sun, Feb 17, 2002 at 07:54:34PM +0100, Stepan Roh wrote:
>
>
> 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
>
--
Grzegorz Adam Hankiewicz gradha@xxxxxxxxxx http://gradha.infierno.org/