c/p doc from wayland C implementation and format it to proper javadoc