On Mon, Oct 30, 2017 at 12:40:20PM +0900, Masahiro Yamada wrote: > 2017-10-28 4:41 GMT+09:00 Matthew Wilcox <willy@xxxxxxxxxxxxx>: > > Implement a '-none' output mode for kernel-doc which will only output > > warning messages, and suppresses the warning message about there being > > no kernel-doc in the file. Add it to the rule to build .o files from .c > > files, so it will check all .c files that have been modified. > > > > Adds about 1300 warnings to my build, but will hopefully discourage > > people from introducing more kerneldoc mistakes. > > Basically, I think this is good, > but it is controversial to sprinkle warnings by default. Yes, it is. I just got three nastygrams from 01.org ;-) But if it's not turned on by default, then people aren't going to notice when they introduce new warnings. I think it needs to be up to someone like Andrew or Linus to decide when to add these warnings by default. Maybe we should do something like you have below for now, then work on cleaning up a few hundred of these warnings, then enable this by default? Thanks for looking at this! > Maybe, > > ifeq ($(KBUILD_ENABLE_EXTRA_GCC_CHECKS),) > cmd_checkdoc = $(srctree)/scripts/kernel-doc -none $< ; > endif > > > so that this is checked only when W=... is given? -- 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
