Commit 39d709392ffc1d05f825191b07b7d865d434f282

Authored by Randy Dunlap
Committed by Linus Torvalds
1 parent eda603f6cd

docbook: skip files with no docs since they generate scary warnings

Fix docbook templates that reference files that do not contain the
expected kernel-doc notation.

Fixes these warnings:

  Warning(arch/x86/include/asm/unaligned.h): no structured comments found
  Warning(lib/vsprintf.c): no structured comments found

These cause errors in the generated html output, like below, so drop
these lines.

  Name
  arch/x86/include/asm/unaligned.h - Document generation inconsistency
  Oops
  Warning
  The template for this document tried to insert the structured comment from the file arch/x86/include/asm/unaligned.h at this point, but none was found. This dummy section is inserted to allow generation to continue.

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

Showing 2 changed files with 0 additions and 2 deletions Side-by-side Diff

Documentation/DocBook/device-drivers.tmpl
... ... @@ -46,7 +46,6 @@
46 46  
47 47 <sect1><title>Atomic and pointer manipulation</title>
48 48 !Iarch/x86/include/asm/atomic.h
49   -!Iarch/x86/include/asm/unaligned.h
50 49 </sect1>
51 50  
52 51 <sect1><title>Delaying, scheduling, and timer routines</title>
Documentation/DocBook/kernel-api.tmpl
... ... @@ -57,7 +57,6 @@
57 57 </para>
58 58  
59 59 <sect1><title>String Conversions</title>
60   -!Ilib/vsprintf.c
61 60 !Elib/vsprintf.c
62 61 </sect1>
63 62 <sect1><title>String Manipulation</title>