1. 15 9月, 2010 17 次提交
  2. 14 9月, 2010 11 次提交
  3. 13 9月, 2010 10 次提交
  4. 12 9月, 2010 2 次提交
    • R
      docbook: skip files with no docs since they generate scary warnings · 39d70939
      Randy Dunlap 提交于
      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: NRandy Dunlap <randy.dunlap@oracle.com>
      Signed-off-by: NLinus Torvalds <torvalds@linux-foundation.org>
      39d70939
    • J
      docbook: warn on unused doc entries · eda603f6
      Johannes Berg 提交于
      When you don't use !E or !I but only !F, then it's very easy to miss
      including some functions, structs etc.  in documentation.  To help
      finding which ones were missed, allow printing out the unused ones as
      warnings.
      
      For example, using this on mac80211 yields a lot of warnings like this:
      
        Warning: didn't use docs for DOC: mac80211 workqueue
        Warning: didn't use docs for ieee80211_max_queues
        Warning: didn't use docs for ieee80211_bss_change
        Warning: didn't use docs for ieee80211_bss_conf
      
      when generating the documentation for it.
      Signed-off-by: NJohannes Berg <johannes.berg@intel.com>
      Signed-off-by: NRandy Dunlap <randy.dunlap@oracle.com>
      Signed-off-by: NLinus Torvalds <torvalds@linux-foundation.org>
      eda603f6