On Thu, 22 Sep 2016 22:11:39 -0700 Bryce Harrington <br...@osg.samsung.com> wrote:
> On Thu, Sep 22, 2016 at 09:59:37PM -0500, Yong Bakos wrote: > > From: Yong Bakos <yba...@humanoriented.com> > > > > Add doxygen comment blocks to all wl_list methods. > > > > Signed-off-by: Yong Bakos <yba...@humanoriented.com> > > Reviewed-by: Bryce Harrington <br...@osg.samsung.com> > > One extremely minor wording suggestion below only if you do another rev. > But this all looks extremely good; will be nice to get the wl_list > documentation shaped up, thanks. > > Bryce > > > --- > > v6: Change description to doubly-linked list (pq) > > v5: Change description to linked-list [err] > > Clarify uses of `wl_list_init` (pq) > > v4: Fix variable name in sample code. (pq) > > Remove implemenetation details of pointer state. (pq) > > Remove note about __typeof__ entirely. > > - it's not helpful as a note or a code comment either > > Change sample code indentation to just spaces. (pq) > > Use _list suffix for list in sample code. (pq) > > Use 'iterate' instead of enumerate, for consistency. (pq) > > Note that only removing 'pos' is safe for *_safe methods. (pq, giucam) > > v3: Standardize on term 'element', to match param names, tests, and other > > text. > > Use 'relates' for macros (instead of 'memberof'). > > v2: Refine the writing for clarity. > > Add dox for wl_list macros, omitted in v1. > > Add notices for unsafe operations and invalid states (giucam, pq) > > src/wayland-util.h | 224 > > +++++++++++++++++++++++++++++++++++++++++++---------- > > 1 file changed, 184 insertions(+), 40 deletions(-) > > > > +/** > > + * Inserts all of the elements of one list into another, after the element > > + * represented by \p list. > > + * > > + * \note This leaves \p other itself in an invalid state. > > Might read better if you take the word 'itself' out? > Hi, I made the change Bryce suggested and pushed the result: 454df51..f7e1dcc master -> master Thanks, pq
pgp8dMvnr1qCm.pgp
Description: OpenPGP digital signature
_______________________________________________ wayland-devel mailing list wayland-devel@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/wayland-devel