Let gtk-doc grok GSEAL

View: New views
2 Messages — Rating Filter:   Alert me  

Let gtk-doc grok GSEAL

by Tim Janik-2 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message


Hi Stefan,

as mentioned during the last IRC meeting:
   http://live.gnome.org/GTK%2B/Meetings?action=AttachFile&do=view&target=20080722.txt

It'd be nice if gtk-doc
understood the GSEAL macros. I guess the handling would be best, if:
- GSEAL(field); is treated like /*<private>*/ field;
- optionally, gtk-doc could ignore GSEAL(), so we can still generate
   docs for older gtk versions where some unsealed fields are treated
   as public read-only API.

Could you please look into supporting this?

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

Re: Let gtk-doc grok GSEAL

by Bugzilla from ensonic@hora-obscura.de :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

hi,

Tim Janik schrieb:

>
> Hi Stefan,
>
> as mentioned during the last IRC meeting:
>  
> http://live.gnome.org/GTK%2B/Meetings?action=AttachFile&do=view&target=20080722.txt 
>
>
> It'd be nice if gtk-doc
> understood the GSEAL macros. I guess the handling would be best, if:
> - GSEAL(field); is treated like /*<private>*/ field;
> - optionally, gtk-doc could ignore GSEAL(), so we can still generate
>   docs for older gtk versions where some unsealed fields are treated
>   as public read-only API.

Hmm, I don't see why this is needed. Can't you just add /*<private>*/ before the
sealed vars? Imho that the intention of GSEAL(). The reason I am a bit reluctant
is that the whole parse is a fragile construct of regexp. I know that this isn't
the best apprach to c-parsing, but its what it uses. I am trying to only gently
modify it.

Stefan

>
> Could you please look into supporting this?
>
> ---
> ciaoTJ

_______________________________________________
gtk-devel-list mailing list
gtk-devel-list@...
http://mail.gnome.org/mailman/listinfo/gtk-devel-list
LightInTheBox - Buy quality products at wholesale price