Re: [Qemu-devel] [PATCH 1/9] char.h: fix gtk-doc comment style

2018-08-30 Thread Markus Armbruster
Marc-André Lureau writes: > Use the gtk-doc function comment style, as documented in: > https://developer.gnome.org/gtk-doc-manual/stable/documenting_symbols.html.en I'm no friend of this style, but these headers use it already, except they get it wrong in places. Your subject's "fix" expresses

Re: [Qemu-devel] [PATCH 1/9] char.h: fix gtk-doc comment style

2018-08-29 Thread Daniel P . Berrangé
On Tue, Aug 28, 2018 at 12:23:14AM +0200, Marc-André Lureau wrote: > Use the gtk-doc function comment style, as documented in: > https://developer.gnome.org/gtk-doc-manual/stable/documenting_symbols.html.en I don't think we ever agreed what syntax we are supposed to be using for inline API docs in

[Qemu-devel] [PATCH 1/9] char.h: fix gtk-doc comment style

2018-08-27 Thread Marc-André Lureau
Use the gtk-doc function comment style, as documented in: https://developer.gnome.org/gtk-doc-manual/stable/documenting_symbols.html.en Signed-off-by: Marc-André Lureau --- include/chardev/char-fe.h | 81 ++- include/chardev/char.h| 61 +---