Warnings for documentation of private elements of a structure.

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi All,

I have very little idea how the internals of the kernel-doc processing
code work, but was wondering if it would be possible to suppress warnings
of the type:

 ./include/linux/iio/buffer.h:142: warning: Excess struct/union/enum/typedef member 'ref' description in 'iio_buffer'

when the member is there but has been marked private.

I don't really want to end up deliberately having different formatting
for documentation of internal structure elements and public API ones.

Obviously I can just ignore the warnings, but they do swamp any real issues
once you start dealing with large structures.

Any thoughts?

Jonathan
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux