lkml.org 
[lkml]   [2013]   [Dec]   [6]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
SubjectRe: [PATCH v3] checkpatch: add DT compatible string documentation checks
From
Date
On Fri, 2013-12-06 at 09:56 +0000, Andy Whitcroft wrote:
> On Wed, Dec 04, 2013 at 08:12:43AM -0800, Joe Perches wrote:
> > On Wed, 2013-12-04 at 10:03 -0600, Rob Herring wrote:
> > > From: Rob Herring <rob.herring@calxeda.com>
> > >
> > > This adds a simple check that any compatible strings in DeviceTree dts
> > > files are present in Documentation/devicetree/bindings. Vendor prefixes
> > > are also checked for existing in vendor-prefixes.txt These should be
> > > temporary checks until we have more sophisticated binding schema checking.
[]
> > > +# check for DT compatible documentation
> > > + if ($realfile =~ /\.dts/ && $rawline =~ /^\+\s*compatible\s*=/) {
> > > + my @compats = $rawline =~ /\"([a-zA-Z0-9\-\,\.\+_]+)\"/g;
> > > +
> > > + foreach my $compat (@compats) {
> > > + my $compat2 = $compat;
> > > + my $dt_path = "Documentation/devicetree/bindings/";
> > > + $compat2 =~ s/\,[a-z]*\-/\,<\.\*>\-/;
> > > + `grep -Erq "$compat|$compat2" $dt_path`;
> > > + if ( $? >> 8 ) {
> > > + WARN("UNDOCUMENTED_DT_STRING",
> > > + "DT compatible string \"$compat\" appears un-documented -- check $dt_path\n" . $herecurr);
> > > + }
> > > +
> > > + my $vendor = $compat;
> > > + my $vendor_path = $dt_path . "vendor-prefixes.txt";
> > > + $vendor =~ s/^([a-zA-Z0-9]+)\,.*/$1/;
> > > + `grep -Eq "$vendor" $vendor_path`;
> > > + if ( $? >> 8 ) {
> > > + WARN("UNDOCUMENTED_DT_STRING",
> > > + "DT compatible string vendor \"$vendor\" appears un-documented -- check $vendor_path\n" . $herecurr);
> > > + }
> > > + }
> > > + }
>
> So this only works if you are in the top of the tree at the time when
> you run it (unless I've missed something). So it might be appropraite
> to suppress this when the vendor-prefixes.txt file is not found.

I suppose it's useful to use the $root variable
on the file open too.

my $vendor_path = $root . '/' . $dt_path . "vendor-prefixes.txt";




\
 
 \ /
  Last update: 2013-12-06 18:01    [W:0.083 / U:1.812 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site