Re: [PATCH v2] kernel-doc: improve "no structured comments found" error

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

 



On 06/07/2013 02:11:28 AM, Johannes Berg wrote:
From: Johannes Berg <johannes.berg@xxxxxxxxx>

When using '!Ffile function' in a docbook template, and the function
no longer exists, you get a "no structured comments found" error from
the kernel-doc processing script. It's useful to know which functions
it was looking for, so print them out in this case. Also do the same
for '!Pfile doc-section'

The same error also happens when using '!Efile' when some exported
functions aren't documented (in the same file.) There's a very large
number of such functions though, so don't print the message in this
case -- right now it would give ~850 messages.

Signed-off-by: Johannes Berg <johannes.berg@xxxxxxxxx>

Seems like a good idea, but it's not in the Documentation directory and life's too short to voluntarily maintain a 2600 line perl script.

I can say I have no objection to the change. :)

Rob--
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