From: Axel S. <A....@uk...> - 2002-10-20 14:28:46
|
Hi everyone, I thought I should give you an update on what I have done recently and to let you know that gtk2hs is actively evolving. A new release should be done soon to keep people interested... - under gtk/gdk/ there is a module called Drawable which enables you to draw into custom widgets (DrawingArea). I've added graphics contexts (GCs) as well and a small demo program under demo/graphics. What is lacking is the ability to render text (need more pango functions for that) and the allocation of colors is implicit (i.e. done on the fly each time you set a color) - under gendoc/ there is a first draft of a program which parses all the widget files and generates Docbook XML documentation. There is no Makefile magic yet and the process is rather involved, see the very end of this mail. Have a look at http://www.cs.ukc.ac.uk/people/staff/as49/gtk2hs to see how it looks like right now. There are some things that I'd like to do (nice, green tables for example), but where I just don't have clue how to do it (sylesheets?!). - Dan Grundy implemented a tool over the summer which translates the XML output of Glade (the user interface builder for Gtk) into Haskell code that constructs the GUI. The source of this project is not yet in the CVS but I hope I will manage to do this next weekend. If you have some minutes to spare and you would like to work on the documentation (or anything), please feel free to contact me for further information. Cheers, Axel. Building the documentation: in gendoc/ say ghc-5.04 --make Driver.hs -o gendoc in gtk/ say ../gendoc/gendoc general/Gtk.hs -Iabstract:buttons/:display/:embedding/:entry/:gdk/:general/:glib/:layout/:menuComboToolbar/:misc/:multiline/:ornaments/:pango/:scrolling/:treeList/:windows/ -xForeign -xMonad -xLocalData -xException -xIORef -xLocalControl -xBits -xUTFCForeign -xSignal -xChar -xMaybe -o ../gendoc/reference.xml (all on one line). Install Docbook XML in /usr/local/share/(xml|xsl), install xsltproc and say in gendoc/: export SGML_CATALOG_FILES=/usr/local/share/xml/catalog xsltproc --catalogs /usr/local/share/xsl/docbook/xhtml/chunk.xsl gtk2hs.xml which gives you loads of html files. |
From: Jens P. <pet...@re...> - 2002-10-21 02:52:23
|
Hi Axel, Axel Simon <A....@uk...> writes: > I thought I should give you an update on what I have done recently and to > let you know that gtk2hs is actively evolving. A new release should be > done soon to keep people interested... Great. > - under gtk/gdk/ there is a module called Drawable which enables you to > draw into custom widgets (DrawingArea). I've added graphics contexts (GCs) > as well and a small demo program under demo/graphics. What is lacking is > the ability to render text (need more pango functions for that) and the > allocation of colors is implicit (i.e. done on the fly each time you set a > color) Sounds fun. > - under gendoc/ there is a first draft of a program which parses all the > widget files and generates Docbook XML documentation. There is no Makefile > magic yet and the process is rather involved, see the very end of this > mail. Have a look at > > http://www.cs.ukc.ac.uk/people/staff/as49/gtk2hs > > to see how it looks like right now. I noticed you currently only have the mogul API appearing, I hope you're also planning to generate documentation for the gtk API too? > - Dan Grundy implemented a tool over the summer which translates the XML > output of Glade (the user interface builder for Gtk) into Haskell code > that constructs the GUI. The source of this project is not yet in the CVS > but I hope I will manage to do this next weekend. Look forward to seeing this. Cheers, Jens |
From: Axel S. <A....@uk...> - 2002-10-21 11:40:38
|
On Mon, Oct 21, 2002 at 11:51:19AM +0900, Jens Petersen wrote: > > - under gendoc/ there is a first draft of a program which parses all the > > widget files and generates Docbook XML documentation. There is no Makefile > > magic yet and the process is rather involved, see the very end of this > > mail. Have a look at > > > > http://www.cs.ukc.ac.uk/people/staff/as49/gtk2hs > > > > to see how it looks like right now. > > I noticed you currently only have the mogul API appearing, I > hope you're also planning to generate documentation for the > gtk API too? Mogul doesn't add a lot on top of Gtk, there are merely some convenience functions, so I would like every user to use Mogul. For the documentation I would like to write some introductory text for the library. This text will be bundled with the Mogul API. A second book will describe the Gtk stuff, but only as a reference. I intend to turn the "todo" sections into "implementation note" and they will only appear in the Gtk reference. This is my current plan (which I made up over the weekend). I know that people will probably be reluctant to use "Modul" when they don't see the reason for that. I hope to get that point across in the documentation. Cheers, Axel. |