Re: [PATCH wayland] util: Improve documentation of wl_iterator_result

2016-11-21 Thread Daniel Stone
Hi Yong, On 20 November 2016 at 17:26, Yong Bakos wrote: > Use declarative voice, remove the unnecessary doxygen \enum tag, and add > two see-also's. This keeps the output the same but makes the comment > voice consistent, a little more readable, and refers to documented > functions that use this

Re: [PATCH wayland] util: Improve documentation of wl_iterator_result

2016-11-20 Thread Peter Hutterer
On Sun, Nov 20, 2016 at 09:26:08AM -0800, Yong Bakos wrote: > From: Yong Bakos > > Use declarative voice, remove the unnecessary doxygen \enum tag, and add > two see-also's. This keeps the output the same but makes the comment > voice consistent, a little more readable, and refers to documented >

[PATCH wayland] util: Improve documentation of wl_iterator_result

2016-11-20 Thread Yong Bakos
From: Yong Bakos Use declarative voice, remove the unnecessary doxygen \enum tag, and add two see-also's. This keeps the output the same but makes the comment voice consistent, a little more readable, and refers to documented functions that use this enum type. Signed-off-by: Yong Bakos --- src