[PATCH 3/8] doc: Remove wl_map from documentation

[Derek Foreman]

On 02/01/15 08:29 PM, Bill Spitzak wrote:
> This object is only in wayland-private.h so it's methods should not
> be in the documentation.
> ---
>  src/wayland-util.c |    4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/src/wayland-util.c b/src/wayland-util.c
> index b099882..db51ebb 100644
> --- a/src/wayland-util.c
> +++ b/src/wayland-util.c
> @@ -149,6 +149,8 @@ wl_array_copy(struct wl_array *array, struct wl_array *source)
>  	return 0;
>  }
>  
> +/** \cond */
> +

There's nothing between the cond and endcond, so this doesn't visible
change doc generation today?

I'm not sure this is the right thing to do - should we maybe have a
separate appendix for private functions instead of just throwing away
any doc (assuming it ever exists :)

The documentation may be useful to people working on wayland, not just
working with wayland...

>  union map_entry {
>  	uintptr_t next;
>  	void *data;
> @@ -361,6 +363,8 @@ wl_map_for_each(struct wl_map *map, wl_iterator_func_t func, void *data)
>  	for_each_helper(&map->server_entries, func, data);
>  }
>  
> +/** \endcond */
> +
>  static void
>  wl_log_stderr_handler(const char *fmt, va_list arg)
>  {
>