Re: [Gtk2hs-users] Re: [Gtk2hs-devel] talking about API changes

[Duncan C. <dun...@wo...>]

On Fri, 2005-04-15 at 09:31 +0100, Axel Simon wrote:
> I think txt2tags is great since you don't need to learn much. Haddock is
> much more difficult to learn than txt2tags. Shall we give it a go and
> revisit the issue if it txt2tags doesn't deliver? It's probably easiest
> to convert txt2tags to something else rather than Latex or even DocBook.
> Hence if txt2tags doesn't work out it wouldn't be the end of the world.

So should we get on with adding a docs section to our cvs? Same cvs
section or it's own section? ie [cvs]/gtk2hs/docs or [cvs]/docs. I think
a new section would be better rather than mixing it up with existing
stuff.

We'll want a makefile to automate the -> xhtml and -> pdf output,
especially if we are going to add a preprocessor that adds markup for
Haskell code.

We could do the syntax highliting by using a Haskell program using HaXml
to post-process the xhtml file to modify all the <pre> code </pre>
sections to add syntax highlighting and docs hyperlinking markup.

Duncan