gtk-doc and gobject introspection

[Philippe Rouquier]

Hi all,

I tried to add gobject introspection to Brasero. I used the specs from here http://live.gnome.org/GObjectIntrospection/Annotations. The problem now is that gtk-doc creates a crippled documentation in which the GObject Introspection annotations are mixed up with the documentation.
So I was wondering if gtk-doc actually supported the above specs?

Thanks,

Philippe
_______________________________________________
desktop-devel-list mailing list
desktop-devel-list@...
http://mail.gnome.org/mailman/listinfo/desktop-devel-list

[Iain Nicol]

Hi,

Philippe Rouquier wrote:
> I tried to add gobject introspection to Brasero. I used the specs from
> here http://live.gnome.org/GObjectIntrospection/Annotations. The problem
> now is that gtk-doc creates a crippled documentation in which the
> GObject Introspection annotations are mixed up with the documentation.

First, there is a gtk-doc list ;).

Second, I had to ask this recently[1].  Make sure you are running gtk-doc
1.12 (git).  Then you must add:

Stefan Kost said:
> <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
> to your master document? See [gtk-doc's]
> tests/annotations/docs/tester-docs.xml near to the end.


[1] http://mail.gnome.org/archives/gtk-doc-list/2009-October/msg00003.html

Regards,
--
Iain Nicol

_______________________________________________
desktop-devel-list mailing list
desktop-devel-list@...
http://mail.gnome.org/mailman/listinfo/desktop-devel-list

[Philippe Rouquier]

Le mardi 03 novembre 2009 à 16:57 +0000, Iain Nicol a écrit :

Hi,

Philippe Rouquier wrote:
> I tried to add gobject introspection to Brasero. I used the specs from
> here http://live.gnome.org/GObjectIntrospection/Annotations. The problem
> now is that gtk-doc creates a crippled documentation in which the
> GObject Introspection annotations are mixed up with the documentation.

First, there is a gtk-doc list ;).

Sorry, I was too lazy to find that out. I apologize for the noise.

Second, I had to ask this recently[1].  Make sure you are running gtk-doc 
1.12 (git).  Then you must add:

Stefan Kost said:
> <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
> to your master document? See [gtk-doc's]
> tests/annotations/docs/tester-docs.xml near to the end.


[1] http://mail.gnome.org/archives/gtk-doc-list/2009-October/msg00003.html

Regards,

Thanks a lot. I'll try that.

Regards,

Philippe
_______________________________________________
desktop-devel-list mailing list
desktop-devel-list@...
http://mail.gnome.org/mailman/listinfo/desktop-devel-list

[Stefan Kost]

hi,

Philippe Rouquier schrieb:

> Le mardi 03 novembre 2009 à 16:57 +0000, Iain Nicol a écrit :
>> Hi,
>>
>> Philippe Rouquier wrote:
>> > I tried to add gobject introspection to Brasero. I used the specs from
>> > here http://live.gnome.org/GObjectIntrospection/Annotations. The problem
>> > now is that gtk-doc creates a crippled documentation in which the
>> > GObject Introspection annotations are mixed up with the documentation.
>>
>> First, there is a gtk-doc list ;).
>>
>>    
> Sorry, I was too lazy to find that out. I apologize for the noise.
>> Second, I had to ask this recently[1].  Make sure you are running gtk-doc
>> 1.12 (git).  Then you must add:
>>
>> Stefan Kost said:
>> > <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
>> > to your master document? See [gtk-doc's]
>> > tests/annotations/docs/tester-docs.xml near to the end.
>>
>>
>> [1] http://mail.gnome.org/archives/gtk-doc-list/2009-October/msg00003.html
>>
>> Regards,
>>    
> Thanks a lot. I'll try that.
>
> Regards,
>
> Philippe

Also for eveyone, gtk-doc git tree has 'unit tests'. They serve as good
examples how you can do certain things.

Stefan

_______________________________________________
desktop-devel-list mailing list
desktop-devel-list@...
http://mail.gnome.org/mailman/listinfo/desktop-devel-list