search

vala-lang / valadoc-org

Build tools used to generate valadoc.org
https://valadoc.org
GNU Lesser General Public License v2.1
84 stars 25 forks source link

Mutter documenation #280

Open felix-andreas opened 4 years ago

felix-andreas commented 4 years ago

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.

tintou commented 4 years ago

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

felix-andreas commented 4 years ago

@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...

benwaffle commented 4 years ago

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.