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/



Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/