Re: [PATCH v5 10/52] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

From: kernel test robot
Date: Tue Oct 06 2020 - 17:18:46 EST


Hi Mauro,

I love your patch! Perhaps something to improve:

[auto build test WARNING on next-20201002]
[cannot apply to linuxtv-media/master sound/for-next hnaz-linux-mm/master linus/master v5.9-rc8 v5.9-rc7 v5.9-rc6 v5.9-rc8]
[If your patch is applied to the wrong git tree, kindly drop us a note.
And when submitting patch, we suggest to use '--base' as documented in
https://git-scm.com/docs/git-format-patch]

url: https://github.com/0day-ci/linux/commits/Mauro-Carvalho-Chehab/Fix-html-build-with-Sphinx-3-1-and-above/20201006-221320
base: 2172e358cd1713c5b7c31361ac465edfe55e455c
config: s390-randconfig-r026-20201006 (attached as .config)
compiler: clang version 12.0.0 (https://github.com/llvm/llvm-project 1127662c6dc2a276839c75a42238b11a3ad00f32)
reproduce (this is a W=1 build):
wget https://raw.githubusercontent.com/intel/lkp-tests/master/sbin/make.cross -O ~/bin/make.cross
chmod +x ~/bin/make.cross
# install s390 cross compiling tool for clang build
# apt-get install binutils-s390x-linux-gnu
# https://github.com/0day-ci/linux/commit/1e803a8bf8df1d859a79217b12708785e20f44d4
git remote add linux-review https://github.com/0day-ci/linux
git fetch --no-tags linux-review Mauro-Carvalho-Chehab/Fix-html-build-with-Sphinx-3-1-and-above/20201006-221320
git checkout 1e803a8bf8df1d859a79217b12708785e20f44d4
# save the attached .config to linux build tree
COMPILER_INSTALL_PATH=$HOME/0day COMPILER=clang make.cross ARCH=s390

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <lkp@xxxxxxxxx>

All warnings (new ones prefixed by >>):

>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
drivers/base/attribute_container.c:304: warning: Function parameter or member 'fn' not described in 'attribute_container_device_trigger_safe'
drivers/base/attribute_container.c:304: warning: Function parameter or member 'undo' not described in 'attribute_container_device_trigger_safe'
drivers/base/attribute_container.c:357: warning: Function parameter or member 'fn' not described in 'attribute_container_device_trigger'
drivers/base/attribute_container.c:471: warning: Function parameter or member 'cont' not described in 'attribute_container_add_class_device_adapter'
drivers/base/attribute_container.c:471: warning: Function parameter or member 'dev' not described in 'attribute_container_add_class_device_adapter'
drivers/base/attribute_container.c:471: warning: Function parameter or member 'classdev' not described in 'attribute_container_add_class_device_adapter'
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
drivers/base/platform-msi.c:330: warning: Function parameter or member 'is_tree' not described in '__platform_msi_create_device_domain'
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
drivers/dma-buf/dma-heap.c:43: warning: Function parameter or member 'priv' not described in 'dma_heap'
drivers/dma-buf/dma-heap.c:43: warning: Function parameter or member 'heap_devt' not described in 'dma_heap'
drivers/dma-buf/dma-heap.c:43: warning: Function parameter or member 'list' not described in 'dma_heap'
drivers/dma-buf/dma-heap.c:43: warning: Function parameter or member 'heap_cdev' not described in 'dma_heap'
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
drivers/mtd/mtdcore.c:1592: warning: Function parameter or member 'section' not described in 'mtd_ooblayout_find_eccregion'
drivers/mtd/mtdcore.c:1592: warning: Excess function parameter 'sectionp' description in 'mtd_ooblayout_find_eccregion'
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
drivers/mtd/mtdpart.c:300: warning: Function parameter or member 'mtd' not described in '__mtd_del_partition'
drivers/mtd/mtdpart.c:300: warning: Excess function parameter 'priv' description in '__mtd_del_partition'
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
fs/ntfs/dir.c:21: warning: Incorrect use of kernel-doc format: * The little endian Unicode string $I30 as a global constant.
fs/ntfs/dir.c:23: warning: cannot understand function prototype: 'ntfschar I30[5] = '
fs/ntfs/dir.c:1489: warning: Function parameter or member 'start' not described in 'ntfs_dir_fsync'
fs/ntfs/dir.c:1489: warning: Function parameter or member 'end' not described in 'ntfs_dir_fsync'
fs/ntfs/dir.c:1489: warning: Excess function parameter 'dentry' description in 'ntfs_dir_fsync'
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
fs/ntfs/namei.c:265: warning: cannot understand function prototype: 'const struct inode_operations ntfs_dir_inode_ops = '
fs/ntfs/namei.c:386: warning: cannot understand function prototype: 'const struct export_operations ntfs_export_ops = '
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
fs/ntfs/runlist.c:16: warning: Incorrect use of kernel-doc format: * ntfs_rl_mm - runlist memmove
fs/ntfs/runlist.c:22: warning: Function parameter or member 'base' not described in 'ntfs_rl_mm'
fs/ntfs/runlist.c:22: warning: Function parameter or member 'dst' not described in 'ntfs_rl_mm'
fs/ntfs/runlist.c:22: warning: Function parameter or member 'src' not described in 'ntfs_rl_mm'
fs/ntfs/runlist.c:22: warning: Function parameter or member 'size' not described in 'ntfs_rl_mm'
fs/ntfs/runlist.c:35: warning: Function parameter or member 'dstbase' not described in 'ntfs_rl_mc'
fs/ntfs/runlist.c:35: warning: Function parameter or member 'dst' not described in 'ntfs_rl_mc'
fs/ntfs/runlist.c:35: warning: Function parameter or member 'srcbase' not described in 'ntfs_rl_mc'
fs/ntfs/runlist.c:35: warning: Function parameter or member 'src' not described in 'ntfs_rl_mc'
fs/ntfs/runlist.c:35: warning: Function parameter or member 'size' not described in 'ntfs_rl_mc'
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
fs/ntfs/unistr.c:87: warning: Function parameter or member 'name1_len' not described in 'ntfs_collate_names'
fs/ntfs/unistr.c:87: warning: Function parameter or member 'name2_len' not described in 'ntfs_collate_names'
--
>> Warning: Sphinx version not found. Using default (Sphinx version 1.2.0)
fs/jffs2/nodemgmt.c:72: warning: Function parameter or member 'sumsize' not described in 'jffs2_do_reserve_space'
fs/jffs2/nodemgmt.c:72: warning: Excess function parameter 'prio' description in 'jffs2_do_reserve_space'
fs/jffs2/nodemgmt.c:503: warning: Function parameter or member 'ofs' not described in 'jffs2_add_physical_node_ref'
fs/jffs2/nodemgmt.c:503: warning: Function parameter or member 'ic' not described in 'jffs2_add_physical_node_ref'
fs/jffs2/nodemgmt.c:503: warning: Excess function parameter 'new' description in 'jffs2_add_physical_node_ref'
..

---
0-DAY CI Kernel Test Service, Intel Corporation
https://lists.01.org/hyperkitty/list/kbuild-all@xxxxxxxxxxxx

Attachment: .config.gz
Description: application/gzip