[lwn:docs-next 78/85] htmldocs: include/linux/device.h:1: warning: no structured comments found

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



tree:   git://git.lwn.net/linux-2.6 docs-next
head:   9e22ff439fa2e1201b168c001683f275afd46258
commit: aad800403a8761073511abb93075738302983956 [78/85] Documentation/core-api/device_link: Add initial documentation
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   make[3]: warning: jobserver unavailable: using -j1.  Add '+' to parent make rule.
   include/linux/init.h:1: warning: no structured comments found
   include/linux/kthread.h:26: warning: Excess function parameter '...' description in 'kthread_create'
   kernel/sys.c:1: warning: no structured comments found
>> include/linux/device.h:1: warning: no structured comments found
>> drivers/base/core.c:1: warning: no structured comments found
   Error: Cannot open file drivers/dma-buf/dma-fence.c
   Error: Cannot open file drivers/dma-buf/dma-fence.c
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -export drivers/dma-buf/dma-fence.c' failed with return code 2
   Error: Cannot open file include/linux/dma-fence.h
   Error: Cannot open file include/linux/dma-fence.h
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -internal include/linux/dma-fence.h' failed with return code 2
   drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
   Error: Cannot open file drivers/dma-buf/dma-fence-array.c
   Error: Cannot open file drivers/dma-buf/dma-fence-array.c
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -export drivers/dma-buf/dma-fence-array.c' failed with return code 2
   Error: Cannot open file include/linux/dma-fence-array.h
   Error: Cannot open file include/linux/dma-fence-array.h
   WARNING: kernel-doc 'scripts/kernel-doc -rst -enable-lineno -internal include/linux/dma-fence-array.h' failed with return code 2
   include/uapi/linux/vtpm_proxy.h:1: warning: no structured comments found
   drivers/char/tpm/tpm_vtpm_proxy.c:71: warning: No description found for parameter 'filp'
   drivers/char/tpm/tpm_vtpm_proxy.c:71: warning: No description found for parameter 'buf'
   drivers/char/tpm/tpm_vtpm_proxy.c:71: warning: No description found for parameter 'count'
   drivers/char/tpm/tpm_vtpm_proxy.c:71: warning: No description found for parameter 'off'
   drivers/char/tpm/tpm_vtpm_proxy.c:121: warning: No description found for parameter 'filp'
   drivers/char/tpm/tpm_vtpm_proxy.c:121: warning: No description found for parameter 'buf'
   drivers/char/tpm/tpm_vtpm_proxy.c:121: warning: No description found for parameter 'count'
   drivers/char/tpm/tpm_vtpm_proxy.c:121: warning: No description found for parameter 'off'
   drivers/char/tpm/tpm_vtpm_proxy.c:201: warning: No description found for parameter 'proxy_dev'
   drivers/char/tpm/tpm_vtpm_proxy.c:1: warning: no structured comments found
   include/sound/compress_driver.h:162: warning: No description found for parameter 'id[64]'
   include/sound/compress_driver.h:162: warning: No description found for parameter 'proc_root'
   include/sound/compress_driver.h:162: warning: No description found for parameter 'proc_info_entry'
   Documentation/core-api/assoc_array.rst:13: WARNING: Enumerated list ends without a blank line; unexpected unindent.
   Documentation/doc-guide/sphinx.rst:110: ERROR: Unknown target name: "sphinx c domain".
   include/net/mac80211.h:3207: ERROR: Unexpected indentation.
   include/net/mac80211.h:3210: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:3212: ERROR: Unexpected indentation.
   include/net/mac80211.h:3213: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:1772: ERROR: Unexpected indentation.
   include/net/mac80211.h:1776: WARNING: Block quote ends without a blank line; unexpected unindent.
   kernel/sched/fair.c:7259: WARNING: Inline emphasis start-string without end-string.
   kernel/time/timer.c:1240: ERROR: Unexpected indentation.
   kernel/time/timer.c:1242: ERROR: Unexpected indentation.
   kernel/time/timer.c:1243: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/linux/wait.h:121: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/linux/wait.h:124: ERROR: Unexpected indentation.
   include/linux/wait.h:126: WARNING: Block quote ends without a blank line; unexpected unindent.
   kernel/time/hrtimer.c:1021: WARNING: Block quote ends without a blank line; unexpected unindent.
   kernel/signal.c:317: WARNING: Inline literal start-string without end-string.
   drivers/base/firmware_class.c:1348: WARNING: Bullet list ends without a blank line; unexpected unindent.
   drivers/message/fusion/mptbase.c:5054: WARNING: Definition list ends without a blank line; unexpected unindent.
   drivers/tty/serial/serial_core.c:1893: WARNING: Definition list ends without a blank line; unexpected unindent.
   include/linux/spi/spi.h:369: ERROR: Unexpected indentation.
   drivers/usb/core/message.c:478: ERROR: Unexpected indentation.
   drivers/usb/core/message.c:479: WARNING: Block quote ends without a blank line; unexpected unindent.
   Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_type".
   Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_dir".
   Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_recip".
   Documentation/driver-api/usb.rst:689: ERROR: Unknown target name: "usbdevfs_urb_type".
   sound/pci/ac97/ac97_codec.c:1908: WARNING: Inline emphasis start-string without end-string.
   sound/soc/soc-core.c:2460: ERROR: Unknown target name: "snd_soc_daifmt".
   sound/core/jack.c:312: ERROR: Unknown target name: "snd_jack_btn".
   Documentation/translations/ko_KR/howto.rst:293: WARNING: Inline emphasis start-string without end-string.
   WARNING: dvipng command 'dvipng' cannot be run (needed for math display), check the imgmath_dvipng setting

vim +1 include/linux/device.h

^1da177e Linus Torvalds     2005-04-16 @1  /*
^1da177e Linus Torvalds     2005-04-16  2   * device.h - generic, centralized driver model
^1da177e Linus Torvalds     2005-04-16  3   *
^1da177e Linus Torvalds     2005-04-16  4   * Copyright (c) 2001-2003 Patrick Mochel <mochel@xxxxxxxx>
b4028437 Greg Kroah-Hartman 2009-05-11  5   * Copyright (c) 2004-2009 Greg Kroah-Hartman <gregkh@xxxxxxx>
b4028437 Greg Kroah-Hartman 2009-05-11  6   * Copyright (c) 2008-2009 Novell Inc.
^1da177e Linus Torvalds     2005-04-16  7   *
^1da177e Linus Torvalds     2005-04-16  8   * This file is released under the GPLv2
^1da177e Linus Torvalds     2005-04-16  9   *

:::::: The code at line 1 was first introduced by commit
:::::: 1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 Linux-2.6.12-rc2

:::::: TO: Linus Torvalds <torvalds@xxxxxxxxxxxxxxx>
:::::: CC: Linus Torvalds <torvalds@xxxxxxxxxxxxxxx>

---
0-DAY kernel test infrastructure                Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all                   Intel Corporation

Attachment: .config.gz
Description: application/gzip


[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux