1. 01 Oct, 2010 14 commits
  2. 27 Sep, 2010 23 commits
  3. 12 Sep, 2010 1 commit
  4. 11 Sep, 2010 2 commits
    • Randy Dunlap's avatar
      docbook: skip files with no docs since they generate scary warnings · 39d70939
      Randy Dunlap authored
      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: default avatarRandy Dunlap <randy.dunlap@oracle.com>
      Signed-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
      39d70939
    • Johannes Berg's avatar
      docbook: warn on unused doc entries · eda603f6
      Johannes Berg authored
      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: default avatarJohannes Berg <johannes.berg@intel.com>
      Signed-off-by: default avatarRandy Dunlap <randy.dunlap@oracle.com>
      Signed-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
      eda603f6