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=/