Re: GtkDoc infrastructure set in place
"Adrian E. Feiguin" <[email protected]> Tue, 04 Nov 2008 12:38:08 -0800
| Newsgroups | gmane.comp.scigraphica.gtkextra |
|---|---|
| Message-ID | <[email protected]> |
Hi Victor! Sorry for the silence, I've been traveling a lot, and I haven't had time to do much work. I'll take a look at these functions and I'll fill in the blanks. Thank you so much for the effort, you've done a great job and all your contributions (and enthousiasm) are highly appreciated. I agree that we have to finish this. I'll try to find some time this week, and take care of it. Best, <ADRIAN> Victor Mierla wrote: >I finished GtkPlot* GtkDoc definitions . >So at his moment GtkDoc infrastructure is quite _COMPLETE_ (not taking into >account a GtkPlot tutorial - as i have said , someone who knows about it has >to write it). > >First of all we need to complete all function explications! >ADRIAN, PLEASE HELP US HERE! > >we need also a documentation polish: fix various typos, wrong/missing >function definitions , reordering of functions appearance , more screenshots. > >Come on people, let's finish this one , so we can make a release of GtkExtra >3! > >Victor > >---------- Original Message ----------- >From: "Victor Mierla" <[email protected]> >To: [email protected] >Sent: Sun, 26 Oct 2008 21:15:42 +0200 >Subject: [gtkextra] GtkDoc infrastructure set in place > > > >>Adrian >> >>After a considerable hackathon , the infrastructure for GtkDoc >>reference and Docbook tutorials is set in place. >> >>This is status for porting docs to GtkDoc - my part as we agreed. >>- GtkBorderCombo : 100% >>- GtkCharSel : 100% >>- GtkCheckItem : 100% >>- GtkComboBox : 100% >>- GtkFileList : 100% >>- GtkFontCombo : 100% >>- GtkIconFileSelection : 100% >>- GtkIconList : 100% >>- GtkPSFont : 100% >>- GtkToggleCombo : 100% >> >>The GtkSheet tutorial was also ported to DocBook SGML. >> >>This porting implied quite extensive modifications of source code >>and configure.in , Makefile.am files and directory structures. So i >>suggest you rm -rf your local gtkextra-3 and cvs checkout it freshly >>from CVS. >> >>I also added initial support for Tiny C Compiler (tcc). Tcc is a >>little speed daemon compared to gcc , i got bored waiting for gcc to >>finish compiling GtkExtra and that's why i modified some .c files to >>compile under it. Modifications are marked with /* Tiny C Compiler support*/ >>With tcc GtkExtra is compiling 2.5xtimes faster than gcc. >> >>There are a couple of FIXME's in source code + there >>gtk_psfont_unref() twice. I commented the second one to allow >>gtkpsfont.c to compile. It would be nice if you could fix those. >> >>TODO list: >> >>TUTORIAL: >>- GtkSheet tutorial : implement gtkstyle.css . The standard style >>coming with docbook-utils package is pretty boring. I still have to >>find out how to integrate CSS style definition in gtkextra- >>tutorial.sgml file. For example C code snippets must have a >>different background color and there must be support for underline. - >> GtkPlot tutorial : For now it's STUB. Someone has to write it. >> >>REFERENCE: >>- GtkPlot* GtkDoc definitions in source code. I thought that Dan >>Gruhn would do it , but he didn't, so i will start working on it. >> >>SOURCE CODE: >>- finalise Tiny C Compiler support: This implies figuring out how to >>make libtool not pass --export-dynamic and --rpath to tcc.There is >>also a bug in tcc linker which complains about 2 identical symbols, >> but this can be resolved by using GNU LD. For now if you want to >>play with tcc, you must export CC=/usr/bin/tcc and editing libtool >>file and remove --export-dynamic and --rpath entries. - Not so near >>future: We need a new GtkSheet that is comparable with modern sheets >>(API and functionality). The new GtkSheet must support properties , >> multi-line and other stuff. This new GtkSheet will not be API- >>compatible with the old one . The new GtkSheet will start as a >>"fork" of the old one. >> >>SO if anyone wants to see how the docs looks now in the new format >>just do like this: >> >>cvs - >>d:pserver:[email protected]:/cvsroot/gtkextra >>login cvs -z3 - >>d:pserver:[email protected]:/cvsroot/gtkextra >>co -P gtkextra-3 autoreconf -i -f ./autogen.sh --enable-gtk-doc make >> >>and go to docs/reference/html and docs/tutorial. >>Be sure that you have docbook, gtk-doc and all dependencies >>installed(see README files for details) >> >>I will post another mail after i finished with GtkPlot* definitions >>in source code so Adrian can look at them so we could finalise the docs. >> >>Victor >> >>-------------------------------------------------- >> >>Flash.ro - Best free webmail service hosted by Idilis >>......................................................... >>Idilis - Internet Provider :: www.idilis.net >>Inchiriem conexiuni radio si in zone neracordate la coloana - >> Broadband Wireless Idilis - >> >>------------------------------------------------------------------------- >>This SF.Net email is sponsored by the Moblin Your Move Developer's challenge >>Build the coolest Linux based applications with Moblin SDK & win >>great prizes Grand prize is a trip for two to an Open Source event >>anywhere in the world http://moblin-contest.org/redirect.php? >> >> >banner_id=100&url=/ > > >>_______________________________________________ >>Scigraphica-gtkextra mailing list >>[email protected] >>https://lists.sourceforge.net/lists/listinfo/scigraphica-gtkextra >> >> >------- End of Original Message ------- > > >-------------------------------------------------- > >Flash.ro - Best free webmail service hosted by Idilis >......................................................... >Idilis - Internet Provider :: www.idilis.net >Inchiriem conexiuni radio si in zone neracordate la coloana - Broadband Wireless Idilis - > > > > >------------------------------------------------------------------------- >This SF.Net email is sponsored by the Moblin Your Move Developer's challenge >Build the coolest Linux based applications with Moblin SDK & win great prizes >Grand prize is a trip for two to an Open Source event anywhere in the world >http://moblin-contest.org/redirect.php?banner_id=100&url=/ >_______________________________________________ >Scigraphica-gtkextra mailing list >[email protected] >https://lists.sourceforge.net/lists/listinfo/scigraphica-gtkextra > > > ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/