-- Sriram Ramkrishna (sriram.ramkrishna_@@[email protected] (remove _@@_)


On Wed, Feb 26, 2014 at 11:30 AM, Alberto Ruiz <[email protected]> wrote:

> I want to say publicly that everybody who does not invite Giovanni for a
> beer next GUADEC is a complete moron.
>
> I am Alberto Ruiz. And I approve this message.
>
>
+1 - Great job, Giovanni!  Really happy to see this!

sri


>
> 2014-02-26 20:27 GMT+01:00 Giovanni Campagna <[email protected]>:
>
> Hello desktop developers,
>>
>> as some of you may have noticed, there has been some activity on the
>> documentation generator for gobject-introspection, and in particular a
>> lot of improvements on the Gjs side.
>> Now the result are beginning to appear, and you can see them here:
>> https://people.gnome.org/~gcampagna/docs/
>>
>> In particular, what is interesting is that we blend in generated and
>> manually edited documentation. This allows us to remove all of GLib
>> and GObject that is not interesting or badly annotated, and it lets us
>> add things like GObject.Class (
>> https://people.gnome.org/~gcampagna/docs/GObject-2.0/GObject.Class.html
>> ), which is the gjs specific way to define new GTypes.
>> I hope to finish with the other overrides soon (the biggest ones are
>> GLib.Variant and Gio.DBus*, but there's some minor stuff), which
>> should solve one of the greatest hurdles in taking up gjs programming.
>> The sources for this generation are not hosted anywhere, because I
>> don't know if it makes sense to store generated (or semi-generated)
>> files in git. I think it does, at least for GLib and GObject, because
>> the update is always manual. cairo has the same problem, because we
>> bind it manually, and the "native" gjs modules need documentation too.
>>
>> Of course, this location is only temporary, and I hope we will move to
>> library-web at some point. This would also fix the styling, which
>> right now is "poor" (it's a pure yelp-build of the mallard docs).
>> The interesting part, though, is that the documentation, at least for
>> the schematic parts, is correct and existing.
>>
>> And naturally, help is welcome, but for now, enjoy!
>>
>> Giovanni
>> _______________________________________________
>> desktop-devel-list mailing list
>> [email protected]
>> https://mail.gnome.org/mailman/listinfo/desktop-devel-list
>>
>
>
>
> --
> Cheers,
> Alberto Ruiz
>
> _______________________________________________
> desktop-devel-list mailing list
> [email protected]
> https://mail.gnome.org/mailman/listinfo/desktop-devel-list
>
_______________________________________________
desktop-devel-list mailing list
[email protected]
https://mail.gnome.org/mailman/listinfo/desktop-devel-list

Reply via email to