util: Improve documentation of wl_argument
authorYong Bakos <ybakos@humanoriented.com>
Sat, 12 Nov 2016 18:11:21 +0000 (10:11 -0800)
committerPekka Paalanen <pekka.paalanen@collabora.co.uk>
Fri, 18 Nov 2016 15:10:21 +0000 (17:10 +0200)
commit9ac70f4349bfa4f934b96cdff4eaa88d5811b5a5
treedd06190494cb6ab8dcff7f160f10cb6792e9afae
parent2d328a4559152ed11e52bdbd85689d7b2239596a
util: Improve documentation of wl_argument

Standardize the doxygen comment format, add clarity to the writing, decouple
the description from specifics of usage, add see-also's, and massage the union
member type comments.

Signed-off-by: Yong Bakos <ybakos@humanoriented.com>
Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
src/wayland-util.h