valadoc-org icon indicating copy to clipboard operation
valadoc-org copied to clipboard

Mutter documenation

Open felix-andreas opened this issue 5 years ago • 3 comments

Hi, I wanted to ask why there is no documentation for libmutter/meta? As the current reference manual of mutter is 5 years old, it is relatively difficult to fix bugs/add features to gala. I currently look into the header files of their git repo.

I couldn't find mutter/meta in the linked GIR/vapi files, so I assume their are some additional steps necessary in order to add the libmutter reference to valadoc.org.

felix-andreas avatar Mar 12 '20 11:03 felix-andreas

libmutter is an internal API and shouldn't be in valadoc.org in my opinion

tintou avatar Mar 12 '20 13:03 tintou

@tintou What do you mean by internal? Because it is only used by the window manager? What would be the problem if the API would be visible on valadoc.org? Sorry to bother you. I am sure you have a much stronger opinion on this topic than me. But I find it extremely difficult to contribute to gala, because the Meta namespace is not documented anywhere...

felix-andreas avatar Mar 12 '20 13:03 felix-andreas

Gala is an external user. All of the files are installed as public files - see at the bottom of this page https://www.archlinux.org/packages/extra/x86_64/mutter/ Nothing about it says internal.

benwaffle avatar Mar 12 '20 13:03 benwaffle