tree:   https://git.kernel.org/pub/scm/linux/kernel/git/rafael/linux-pm.git device-links-test
head:   37c39b84114b777fdd8ed1a7074c7c0674180533
commit: 5821e59c7551e256b15e164f1c248602f49d1b68 [2/5] driver core: Functional dependencies tracking support
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/workqueue.h:392: warning: No description found for parameter '...'
   include/linux/workqueue.h:392: warning: Excess function parameter 'args' description in 'alloc_workqueue'
   include/linux/workqueue.h:413: warning: No description found for parameter '...'
   include/linux/workqueue.h:413: warning: Excess function parameter 'args' description in 'alloc_ordered_workqueue'
   include/linux/kthread.h:26: warning: No description found for parameter '...'
   kernel/sys.c:1: warning: no structured comments found

quoted

include/linux/device.h:727: warning: Enum value 'DL_STATE_NONE' not described in enum 'device_link_state'
include/linux/device.h:727: warning: Enum value 'DL_STATE_DORMANT' not described in enum 'device_link_state'
include/linux/device.h:727: warning: Enum value 'DL_STATE_AVAILABLE' not described in enum 'device_link_state'
include/linux/device.h:727: warning: Enum value 'DL_STATE_CONSUMER_PROBE' not described in enum 'device_link_state'
include/linux/device.h:727: warning: Enum value 'DL_STATE_ACTIVE' not described in enum 'device_link_state'
include/linux/device.h:727: warning: Enum value 'DL_STATE_SUPPLIER_UNBIND' not described in enum 'device_link_state'
include/linux/device.h:770: warning: Enum value 'DL_DEV_NO_DRIVER' not described in enum 'dl_dev_state'
include/linux/device.h:770: warning: Enum value 'DL_DEV_PROBING' not described in enum 'dl_dev_state'
include/linux/device.h:770: warning: Enum value 'DL_DEV_DRIVER_BOUND' not described in enum 'dl_dev_state'
include/linux/device.h:770: warning: Enum value 'DL_DEV_UNBINDING' not described in enum 'dl_dev_state'
include/linux/device.h:933: warning: No description found for parameter 'links'

   drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
   include/linux/fence-array.h:61: warning: No description found for parameter 'fence'
   include/sound/core.h:324: warning: No description found for parameter '...'
   include/sound/core.h:335: warning: No description found for parameter '...'
   include/sound/core.h:388: warning: No description found for parameter '...'
   include/media/media-entity.h:1054: warning: No description found for parameter '...'
   include/net/mac80211.h:2148: WARNING: Inline literal start-string without end-string.
   include/net/mac80211.h:2153: WARNING: Inline literal start-string without end-string.
   include/net/mac80211.h:3202: ERROR: Unexpected indentation.
   include/net/mac80211.h:3205: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:3207: ERROR: Unexpected indentation.
   include/net/mac80211.h:3208: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:1435: WARNING: Inline emphasis start-string without end-string.
   include/net/mac80211.h:1172: WARNING: Inline literal start-string without end-string.
   include/net/mac80211.h:1173: WARNING: Inline literal start-string without end-string.
   include/net/mac80211.h:814: ERROR: Unexpected indentation.
   include/net/mac80211.h:815: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:820: ERROR: Unexpected indentation.
   include/net/mac80211.h:821: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:2489: ERROR: Unexpected indentation.
   include/net/mac80211.h:1768: ERROR: Unexpected indentation.
   include/net/mac80211.h:1772: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/net/mac80211.h:1746: WARNING: Inline emphasis start-string without end-string.
   kernel/sched/fair.c:7247: WARNING: Inline emphasis start-string without end-string.
   kernel/time/timer.c:1230: ERROR: Unexpected indentation.
   kernel/time/timer.c:1232: ERROR: Unexpected indentation.
   kernel/time/timer.c:1233: 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.
   WARNING: dvipng command 'dvipng' cannot be run (needed for math display), check the imgmath_dvipng setting

vim +727 include/linux/device.h

   721		DL_STATE_DORMANT = 0,
   722		DL_STATE_AVAILABLE,
   723		DL_STATE_CONSUMER_PROBE,
   724		DL_STATE_ACTIVE,
   725		DL_STATE_SUPPLIER_UNBIND,
   726	};
 > 727	
   728	/*
   729	 * Device link flags.
   730	 *
   731	 * STATELESS: The core won't track the presence of supplier/consumer drivers.
   732	 * AUTOREMOVE: Remove this link automatically on consumer driver unbind.
   733	 */
   734	#define DL_FLAG_STATELESS	(1 << 0)
   735	#define DL_FLAG_AUTOREMOVE	(1 << 1)
   736	
   737	/**
   738	 * struct device_link - Device link representation.
   739	 * @supplier: The device on the supplier end of the link.
   740	 * @s_node: Hook to the supplier device's list of links to consumers.
   741	 * @consumer: The device on the consumer end of the link.
   742	 * @c_node: Hook to the consumer device's list of links to suppliers.
   743	 * @status: The state of the link (with respect to the presence of drivers).
   744	 * @flags: Link flags.
   745	 * @rcu_head: An RCU head to use for deferred execution of SRCU callbacks.
   746	 */
   747	struct device_link {
   748		struct device *supplier;
   749		struct list_head s_node;
   750		struct device *consumer;
   751		struct list_head c_node;
   752		enum device_link_state status;
   753		u32 flags;
   754		struct rcu_head rcu_head;
   755	};
   756	
   757	/**
   758	 * enum dl_dev_state - Device driver presence tracking information.
   759	 * @NO_DRIVER: There is no driver attached to the device.
   760	 * @PROBING: A driver is probing.
   761	 * @DRIVER_BOUND: The driver has been bound to the device.
   762	 * @UNBINDING: The driver is unbinding from the device.
   763	 */
   764	enum dl_dev_state {
   765		DL_DEV_NO_DRIVER = 0,
   766		DL_DEV_PROBING,
   767		DL_DEV_DRIVER_BOUND,
   768		DL_DEV_UNBINDING,
   769	};
 > 770	
   771	/**
   772	 * struct dev_links_info - Device data related to device links.
   773	 * @suppliers: List of links to supplier devices.

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