1. 25 3月, 2010 2 次提交
  2. 13 3月, 2010 1 次提交
  3. 27 2月, 2010 2 次提交
  4. 02 12月, 2009 1 次提交
    • J
      tracing: Add DEFINE_EVENT(), DEFINE_SINGLE_EVENT() support to docbook · 3a9089fd
      Jason Baron 提交于
      The introduction of the new 'DECLARE_EVENT_CLASS()' obviates the
      need for the 'TRACE_EVENT()' macro in some cases. Thus, docbook
      style comments that used to live with 'TRACE_EVENT()' are now
      moved to 'DEFINE_EVENT()'. Thus, we need to make the docbook
      system understand the new 'DEFINE_EVENT()' macro. In addition
      I've tried to futureproof the patch, by also adding support for
      'DEFINE_SINGLE_EVENT()', since there has been discussion about
      renaming: TRACE_EVENT() -> DEFINE_SINGLE_EVENT().
      
      Without this patch the tracepoint docbook fails to build.
      
      I've verified that this patch correctly builds the tracepoint
      docbook which currently covers signals, and irqs.
      
      Changes in v2:
       - properly indent perl 'if' statements
      Signed-off-by: NJason Baron <jbaron@redhat.com>
      Acked-by: NSteven Rostedt <rostedt@goodmis.org>
      Acked-by: NRandy Dunlap <randy.dunlap@oracle.com>
      Cc: William Cohen <wcohen@redhat.com>
      Cc: Frederic Weisbecker <fweisbec@gmail.com>
      Cc: Mathieu Desnoyers <mathieu.desnoyers@polymtl.ca>
      Cc: Masami Hiramatsu <mhiramat@redhat.com>
      LKML-Reference: <200912011718.nB1HIn7t011371@int-mx04.intmail.prod.int.phx2.redhat.com>
      Signed-off-by: NIngo Molnar <mingo@elte.hu>
      3a9089fd
  5. 19 9月, 2009 1 次提交
  6. 02 7月, 2009 1 次提交
  7. 20 6月, 2009 2 次提交
  8. 10 6月, 2009 1 次提交
  9. 03 5月, 2009 1 次提交
  10. 01 5月, 2009 1 次提交
  11. 12 2月, 2009 1 次提交
    • R
      kernel-doc: fix syscall wrapper processing · b4870bc5
      Randy Dunlap 提交于
      Fix kernel-doc processing of SYSCALL wrappers.
      
      The SYSCALL wrapper patches played havoc with kernel-doc for
      syscalls.  Syscalls that were scanned for DocBook processing
      reported warnings like this one, for sys_tgkill:
      
      Warning(kernel/signal.c:2285): No description found for parameter 'tgkill'
      Warning(kernel/signal.c:2285): No description found for parameter 'pid_t'
      Warning(kernel/signal.c:2285): No description found for parameter 'int'
      
      because the macro parameters all "look like" function parameters,
      although they are not:
      
      /**
       *  sys_tgkill - send signal to one specific thread
       *  @tgid: the thread group ID of the thread
       *  @pid: the PID of the thread
       *  @sig: signal to be sent
       *
       *  This syscall also checks the @tgid and returns -ESRCH even if the PID
       *  exists but it's not belonging to the target process anymore. This
       *  method solves the problem of threads exiting and PIDs getting reused.
       */
      SYSCALL_DEFINE3(tgkill, pid_t, tgid, pid_t, pid, int, sig)
      {
      ...
      
      This patch special-cases the handling SYSCALL_DEFINE* function
      prototypes by expanding them to
      	long sys_foobar(type1 arg1, type1 arg2, ...)
      Signed-off-by: NRandy Dunlap <randy.dunlap@oracle.com>
      Signed-off-by: NAndrew Morton <akpm@linux-foundation.org>
      Signed-off-by: NLinus Torvalds <torvalds@linux-foundation.org>
      b4870bc5
  12. 20 12月, 2008 1 次提交
  13. 02 12月, 2008 1 次提交
  14. 27 10月, 2008 1 次提交
  15. 23 9月, 2008 1 次提交
  16. 06 8月, 2008 1 次提交
  17. 26 7月, 2008 1 次提交
    • R
      kernel-doc: handle/strip __init · 74fc5c65
      Randy Dunlap 提交于
      Handle __init in functions with kernel-doc notation by stripping the
      __init away from the output doc.  This is already being done for
      "__devinit".  This patch fixes these kernel-doc error/aborts:
      
      Error(linux-next-20080619//drivers/usb/gadget/config.c:132): cannot understand prototype: 'struct usb_descriptor_header **__init usb_copy_descriptors(struct usb_descriptor_header **src) '
      Error(linux-next-20080619//drivers/usb/gadget/config.c:182): cannot understand prototype: 'struct usb_endpoint_descriptor *__init usb_find_endpoint( 	struct usb_descriptor_header **src, 	struct usb_descriptor_header **copy, 	struct usb_endpoint_descriptor *match ) '
      Signed-off-by: NRandy Dunlap <randy.dunlap@oracle.com>
      Cc: David Brownell <dbrownell@users.sourceforge.net>
      Signed-off-by: NSam Ravnborg <sam@ravnborg.org>
      74fc5c65
  18. 20 5月, 2008 1 次提交
  19. 28 4月, 2008 2 次提交
  20. 14 3月, 2008 1 次提交
  21. 24 2月, 2008 1 次提交
    • R
      kernel-doc: fix function-pointer-parameter parsing · 00d62961
      Richard Kennedy 提交于
      When running "make htmldocs" I'm seeing some non-fatal perl errors caused
      by trying to parse the callback function definitions in blk-core.c.
      
      The errors are "Use of uninitialized value in concatenation (.)..."
      in combination with:
      Warning(linux-2.6.25-rc2/block/blk-core.c:1877): No description found for parameter ''
      
      The function pointers are defined without a * i.e.
      int (drv_callback)(struct request *)
      
      The compiler is happy with them, but kernel-doc isn't.
      
      This patch teaches create_parameterlist in kernel-doc to parse this type of
      function pointer definition, but is it the right way to fix the problem ?
      The problem only seems to occur in blk-core.c.
      
      However with the patch applied, kernel-doc finds the correct parameter
      description for the callback in blk_end_request_callback, which is doesn't
      normally.
      
      I thought it would be a bit odd to change to code to use the more normal
      form of function pointers just to get the documentation to work, so I fixed
      kernel-doc instead - even though this is teaching it to understand code
      that might go away (The comment for blk_end_request_callback says that it
      should not be used and will removed at some point).
      Signed-off-by: NRichard Kennedy <richard@rsk.demon.co.uk>
      Signed-off-by: NRandy Dunlap <randy.dunlap@oracle.com>
      Signed-off-by: NAndrew Morton <akpm@linux-foundation.org>
      Signed-off-by: NLinus Torvalds <torvalds@linux-foundation.org>
      00d62961
  22. 15 2月, 2008 1 次提交
  23. 08 2月, 2008 3 次提交
  24. 29 1月, 2008 4 次提交
  25. 17 10月, 2007 1 次提交
    • R
      kernel-doc: fix doc blocks and html · 6b5b55f6
      Randy Dunlap 提交于
      Johannes Berg reports (Thanks!) that &struct names are not highlighted in
      html output format when they are inside a DOC: block.
      
      DOC: blocks were not escaped thru xml_escape() like other kernel-doc
      comments were.  Fixed that.
      
      However, that left a problem with <p> ($blankline_html) being processed
      thru xml_escape(), converting it to &lt;p&gt;, which isn't good for the
      generated html output (the <p> should remain unchanged), so this patch also
      introduces the notion of "local" kernel-doc meta-characters
      ('\\\\mnemonic:'), which are converted to html just before writing the
      stream to its output file.
      
      Please report any problems that you (anyone) see in "highlighting" in any
      output mode (text, man, html, xml).
      
      Also update copyright to include me.
      Signed-off-by: NRandy Dunlap <randy.dunlap@oracle.com>
      Cc: Johannes Berg <johannes@sipsolutions.net>
      Signed-off-by: NAndrew Morton <akpm@linux-foundation.org>
      Signed-off-by: NLinus Torvalds <torvalds@linux-foundation.org>
      6b5b55f6
  26. 20 7月, 2007 3 次提交
  27. 10 5月, 2007 1 次提交
  28. 09 5月, 2007 2 次提交
    • B
      kill warnings when building mandocs · 53f049fa
      Borislav Petkov 提交于
      This patch shuts warnings of the sort:
      
      make -C /mnt/samsung_200/sam/kernel/trees/21-rc6/build \
      	KBUILD_SRC=/mnt/samsung_200/sam/kernel/trees/21-rc6 \
      	KBUILD_EXTMOD="" -f /mnt/samsung_200/sam/kernel/trees/21-rc6/Makefile mandocs
      make -f /mnt/samsung_200/sam/kernel/trees/21-rc6/scripts/Makefile.build obj=scripts/basic
      make -f /mnt/samsung_200/sam/kernel/trees/21-rc6/scripts/Makefile.build obj=Documentation/DocBook mandocs
        SRCTREE=/mnt/samsung_200/sam/kernel/trees/21-rc6/ /mnt/samsung_200/sam/kernel/trees/21-rc6/build/scripts/basic/docproc doc /mnt/samsung_200/sam/kernel/trees/21-rc6/Documentation/DocBook/wanbook.tmpl >Documentation/DocBook/wanbook.xml
        if grep -q refentry Documentation/DocBook/wanbook.xml; then xmlto man -m /mnt/samsung_200/sam/kernel/trees/21-rc6/Documentation/DocBook/stylesheet.xsl -o Documentation/DocBook/man Documentation/DocBook/wanbook.xml ; gzip -f Documentation/DocBook/man/*.9; fi
      Note: meta version: No productnumber or alternative     sppp_close
      Note: meta version: No refmiscinfo@class=version        sppp_close
      Note: Writing sppp_close.9
      Note: meta version: No productnumber or alternative     sppp_open
      Note: meta version: No refmiscinfo@class=version        sppp_open
      
      by adding a RefMiscInfo xml tag in the form of the current kernel version
      to the function, struct and enum definitions in files included by
      kernel-doc when building 'mandocs'.  However, the version string appears
      truncated on the manpage due to some constraints in the xml DTD for the man
      header, I believe, for the troff output is truncated too.
      Signed-off-by: NBorislav Petkov <bbpetkov@yahoo.de>
      Cc: "Randy.Dunlap" <rdunlap@xenotime.net>
      Signed-off-by: NAndrew Morton <akpm@linux-foundation.org>
      Signed-off-by: NLinus Torvalds <torvalds@linux-foundation.org>
      53f049fa
    • R
      kernel-doc: html mode struct highlights · 3eb014a1
      Randy Dunlap 提交于
      Johannes Berg reported that struct names are not highlighted
      (bold, italic, etc.) in html kernel-doc output.  (Also not in
      text-mode output, but I don't see that changing.)
      
      This patch adds the following:
      - highlight struct names in html output mode
      - highlight environment var. names in html output mode
      - indent struct fields in the original struct layout
      Signed-off-by: NRandy Dunlap <randy.dunlap@oracle.com>
      Cc: Johannes Berg <johannes@sipsolutions.net>
      Signed-off-by: NAndrew Morton <akpm@linux-foundation.org>
      Signed-off-by: NLinus Torvalds <torvalds@linux-foundation.org>
      3eb014a1