On Thu, May 12, 2016 at 03:52:36PM -0500, Yong Bakos wrote: > 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(-)
In checking the doxygen documentation, these changes all look good, and near as I can tell the routines in question are in fact private, so for all three patches: Reviewed-by: Bryce Harrington <[email protected]> And as we're now post-release I've gone ahead and pushed them to trunk. To ssh://git.freedesktop.org/git/wayland/wayland 98d94b5..a1bce0e master -> master Thanks, Bryce _______________________________________________ wayland-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/wayland-devel
