<p dir="ltr">On 29 Dec 2015 3:20 pm, "Jonas Ådahl" <<a href="mailto:jadahl@gmail.com">jadahl@gmail.com</a>> wrote:<br>
><br>
> On Tue, Dec 29, 2015 at 01:56:14PM +0100, Nils Chr. Brause wrote:<br>
> > No.<br>
> > If we want Wayland to be successful and widely used it has to be well<br>
> > documented (which it still is far from). Turning off warnings about<br>
> > undocumented fields doesn't exactly help the documentation effort but<br>
> > rather impedes it.<br>
> ><br>
><br>
> There are a lot of these warnings, and I don't expect many of them to be<br>
> fixed because they are self explanatory non-public API which honestly<br>
> don't need any extra doxygen documentation. If you have ways to limit<br>
> these warnings to relevant parts (public API for example) I wouldn't<br>
> mind,</p>
<p dir="ltr">AFAIK, you can use EXCLUDE to exclude files, which only contain internal API and you can use \cond ... \endcond to exclude functions and structures inside a file.</p>
<p dir="ltr">> but as they are now it's just hundreds of warnings to ignore<br>
> forever.<br>
><br>
><br>
> Jonas<br>
><br>
> ><br>
> > On Tue, Dec 29, 2015 at 3:10 AM, Jonas Ådahl <<a href="mailto:jadahl@gmail.com">jadahl@gmail.com</a>> wrote:<br>
> > > There are lots of warnings about fields and other things not being<br>
> > > documented, and many of those will probably never be documented, so<br>
> > > stop warning about it.<br>
> > ><br>
> > > Signed-off-by: Jonas Ådahl <<a href="mailto:jadahl@gmail.com">jadahl@gmail.com</a>><br>
> > > ---<br>
> > > doc/doxygen/<a href="http://wayland.doxygen.in">wayland.doxygen.in</a> | 1 +<br>
> > > 1 file changed, 1 insertion(+)<br>
> > ><br>
> > > diff --git a/doc/doxygen/<a href="http://wayland.doxygen.in">wayland.doxygen.in</a> b/doc/doxygen/<a href="http://wayland.doxygen.in">wayland.doxygen.in</a><br>
> > > index fb76b12..6cb77de 100644<br>
> > > --- a/doc/doxygen/<a href="http://wayland.doxygen.in">wayland.doxygen.in</a><br>
> > > +++ b/doc/doxygen/<a href="http://wayland.doxygen.in">wayland.doxygen.in</a><br>
> > > @@ -14,3 +14,4 @@ EXPAND_ONLY_PREDEF = YES<br>
> > > DOT_MULTI_TARGETS = YES<br>
> > > ALIASES += comment{1}="/* \1 *<!-- -->/"<br>
> > > GENERATE_HTML = NO<br>
> > > +WARN_IF_UNDOCUMENTED = NO<br>
> > > --<br>
> > > 2.4.3<br>
> > ><br>
> > > _______________________________________________<br>
> > > wayland-devel mailing list<br>
> > > <a href="mailto:wayland-devel@lists.freedesktop.org">wayland-devel@lists.freedesktop.org</a><br>
> > > <a href="http://lists.freedesktop.org/mailman/listinfo/wayland-devel">http://lists.freedesktop.org/mailman/listinfo/wayland-devel</a><br>
</p>