[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v2 1/8] qobject: Include API docs in docs/devel/qobject.html
From: |
Eduardo Habkost |
Subject: |
Re: [PATCH v2 1/8] qobject: Include API docs in docs/devel/qobject.html |
Date: |
Thu, 19 Nov 2020 13:03:49 -0500 |
CCing Peter, Sphinx documentation machinery maintainer.
On Thu, Nov 19, 2020 at 10:37:22AM +0100, Markus Armbruster wrote:
> Eduardo Habkost <ehabkost@redhat.com> writes:
>
> > Render existing doc comments at docs/devel/qobject.html.
> >
> > Signed-off-by: Eduardo Habkost <ehabkost@redhat.com>
> > ---
[...]
> > /**
> > - * qnum_destroy_obj(): Free all memory allocated by a
> > - * QNum object
> > + * qnum_destroy_obj(): Free all memory allocated by a QNum object
> > + *
> > + * @obj: QNum object to be destroyed
> > */
> > void qnum_destroy_obj(QObject *obj)
> > {
>
> Many lines of the form
>
> + * @foo: a foo
I hate them too.
>
> One of my reasons to dislike GTK-Doc. Oh well, it's what we're using.
It's not gtk-doc. It's kernel-doc who generates warnings
if some parameters are not documented, and maybe we should
silence them.
--
Eduardo
- [PATCH v2 0/8] qom: Use qlit to represent property defaults, Eduardo Habkost, 2020/11/16
- [PATCH v2 2/8] qnum: Make qnum_get_double() get const pointer, Eduardo Habkost, 2020/11/16
- [PATCH v2 1/8] qobject: Include API docs in docs/devel/qobject.html, Eduardo Habkost, 2020/11/16
- [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Eduardo Habkost, 2020/11/16
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Marc-André Lureau, 2020/11/17
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Eduardo Habkost, 2020/11/17
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Marc-André Lureau, 2020/11/17
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Markus Armbruster, 2020/11/19
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Eduardo Habkost, 2020/11/19
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Eduardo Habkost, 2020/11/19
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Markus Armbruster, 2020/11/20
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Markus Armbruster, 2020/11/20
- Re: [PATCH v2 3/8] qnum: QNumValue type for QNum value literals, Eduardo Habkost, 2020/11/20