From: Yong Bakos <[email protected]> The Wayland docbook and the doxygen html docs had been presenting a number of private/inaccessible things as part of the public API, which is misleading.
For 1/3, a \private command was introduced since the function is a private wl_display member function. For the xsl rule, I did test both != 'private' and = 'public' (thinking of future flexibility) but the doc diff is the same and = 'public' is more direct. Note that I placed the \private marker between the \sa and \memberof to match the convention that \sa follows a long description and \memberof precedes the close of a doc comment. In 2-3/3, using the \cond command was sufficient and preferred. Yong Bakos (3): doc: Unpublish wl_display_get_additional_shm_formats doc: Unpublish wl_log* and wl_abort doc: Unpublish global_zombie_object and wl_interface_equal doc/publican/doxygen-to-publican.xsl | 2 +- src/wayland-server.c | 2 ++ src/wayland-util.c | 34 +++++++++++++++++----------------- 3 files changed, 20 insertions(+), 18 deletions(-) -- 2.7.2 _______________________________________________ wayland-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/wayland-devel
