Re: [Ksummit-discuss] [TECH TOPIC] Documentation

Joe Perches <[email protected]> Thu, 09 Jul 2020 04:42:58 -0700
Newsgroups org.linuxfoundation.lists.ksummit-discuss,dev.linux.lists.ksummit
Message-ID <[email protected]>
On Thu, 2020-07-09 at 12:21 +0200, Mauro Carvalho Chehab wrote:
> Em Thu, 18 Jun 2020 07:40:22 -0700
> Joe Perches <[email protected]> escreveu:
> 
> > On Thu, 2020-06-18 at 12:04 +0300, Mike Rapoport wrote:
> > > if a patch breaks the sync between the code and the
> > > kerneldoc can it be detected by checkpatch.pl?  
> > 
> > No, it can not.  Not directly.
> 
> Well, perhaps checkpatch.pl could run:
> 
> 	./scripts/kernel-doc -none
> 
> if it finds "/**" on a patch, showing the warnings produced by it, if any.

checkpatch runs on patches.
Use the tools that are designed for this instead.

> > As there already is an existing tool, that tool
> > should be used when possible.


_______________________________________________
Ksummit-discuss mailing list
[email protected]
https://lists.linuxfoundation.org/mailman/listinfo/ksummit-discuss