[dax:idr-2016-12-13 6/6] htmldocs: lib/idr.c:223: warning: No description found for parameter 'start'

[kbuild test robot <fengguang.wu@intel.com>]

[-- Attachment #1: Type: text/plain, Size: 3958 bytes --]

tree:   git://git.infradead.org/users/willy/linux-dax.git idr-2016-12-13
head:   4b63236cd97a3986ef687ca52000a8ad51f59727
commit: 4b63236cd97a3986ef687ca52000a8ad51f59727 [6/6] Reimplement IDR and IDA using the radix tree
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   lib/crc32.c:148: warning: No description found for parameter 'tab)[256]'
   lib/crc32.c:148: warning: Excess function parameter 'tab' description in 'crc32_le_generic'
   lib/crc32.c:293: warning: No description found for parameter 'tab)[256]'
   lib/crc32.c:293: warning: Excess function parameter 'tab' description in 'crc32_be_generic'
   lib/crc32.c:1: warning: no structured comments found
>> lib/idr.c:223: warning: No description found for parameter 'start'
>> lib/idr.c:223: warning: No description found for parameter 'id'
>> lib/idr.c:223: warning: Excess function parameter 'starting_id' description in 'ida_get_new_above'
>> lib/idr.c:223: warning: Excess function parameter 'p_id' description in 'ida_get_new_above'
   lib/idr.c:1: warning: no structured comments found
       Was looking for 'IDA description'.
>> lib/idr.c:223: warning: No description found for parameter 'start'
>> lib/idr.c:223: warning: No description found for parameter 'id'
>> lib/idr.c:223: warning: Excess function parameter 'starting_id' description in 'ida_get_new_above'
>> lib/idr.c:223: warning: Excess function parameter 'p_id' description in 'ida_get_new_above'
   drivers/pci/msi.c:623: warning: No description found for parameter 'affd'
   drivers/pci/msi.c:623: warning: Excess function parameter 'affinity' description in 'msi_capability_init'

vim +/start +223 lib/idr.c

5d542ec7 Matthew Wilcox 2016-12-13  207   * @starting_id: id to start search at
5d542ec7 Matthew Wilcox 2016-12-13  208   * @p_id: pointer to the allocated handle
5d542ec7 Matthew Wilcox 2016-12-13  209   *
5d542ec7 Matthew Wilcox 2016-12-13  210   * Allocate new ID above or equal to @starting_id.  It should be called
4b63236c Matthew Wilcox 2016-12-10  211   * with any required locks to ensure that concurrent calls to
4b63236c Matthew Wilcox 2016-12-10  212   * ida_get_new_above() / ida_get_new() / ida_remove() are not allowed.
4b63236c Matthew Wilcox 2016-12-10  213   * Consider using ida_simple_get() if you do not have complex locking
4b63236c Matthew Wilcox 2016-12-10  214   * requirements.
5d542ec7 Matthew Wilcox 2016-12-13  215   *
5d542ec7 Matthew Wilcox 2016-12-13  216   * If memory is required, it will return %-EAGAIN, you should unlock
5d542ec7 Matthew Wilcox 2016-12-13  217   * and go back to the ida_pre_get() call.  If the ida is full, it will
5d542ec7 Matthew Wilcox 2016-12-13  218   * return %-ENOSPC.
5d542ec7 Matthew Wilcox 2016-12-13  219   *
5d542ec7 Matthew Wilcox 2016-12-13  220   * @p_id returns a value in the range @starting_id ... %0x7fffffff.
5d542ec7 Matthew Wilcox 2016-12-13  221   */
4b63236c Matthew Wilcox 2016-12-10  222  int ida_get_new_above(struct ida *ida, int start, int *id)
5d542ec7 Matthew Wilcox 2016-12-13 @223  {
4b63236c Matthew Wilcox 2016-12-10  224  	struct radix_tree_root *root = &ida->ida_rt;
4b63236c Matthew Wilcox 2016-12-10  225  	void **slot;
4b63236c Matthew Wilcox 2016-12-10  226  	struct radix_tree_iter iter;
5d542ec7 Matthew Wilcox 2016-12-13  227  	struct ida_bitmap *bitmap;
4b63236c Matthew Wilcox 2016-12-10  228  	unsigned long index;
4b63236c Matthew Wilcox 2016-12-10  229  	unsigned bit;
4b63236c Matthew Wilcox 2016-12-10  230  	int new;
4b63236c Matthew Wilcox 2016-12-10  231  

:::::: The code at line 223 was first introduced by commit
:::::: 5d542ec764108582e62ead046d20c053ac619b50 Revert "reimplement IDR and IDA using the radix tree"

:::::: TO: Matthew Wilcox <mawilcox@microsoft.com>
:::::: CC: Matthew Wilcox <mawilcox@microsoft.com>

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

[-- Attachment #2: .config.gz --]
[-- Type: application/gzip, Size: 6469 bytes --]