Re: Announce: Gjs documentation almost ready!

[Piñeiro <apinheiro igalia com>]

Oh, really awesome.

Not sure if you accept requests, but, could you add to the list of
documented modules libatspi [1]? Projects like gnome-shell are using the
gjs gobject-introspected bindings for that library, and the lack of gjs
documentation was already noted. Probably we could close this bug [2]
(comments there are welcome).

Again, thanks for this work

Best regards

[1] https://developer.gnome.org/libatspi/2.11/
[2] https://bugzilla.gnome.org/show_bug.cgi?id=703422#c2

On 02/26/2014 08:27 PM, Giovanni Campagna wrote:
> 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
> desktop-devel-list gnome org
> https://mail.gnome.org/mailman/listinfo/desktop-devel-list

-- 
----
Alejandro Piñeiro