From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mauro Carvalho Chehab Subject: [PATCH 00/17] Address several documentation build warnings Date: Tue, 17 Mar 2020 15:54:09 +0100 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=m.gmane-mx.org@lists.infradead.org To: Linux Doc Mailing List Cc: Andrew Lunn , Wolfram Sang , Peter Zijlstra , Catalin Marinas , Linus Walleij , Lai Jiangshan , Liam Girdwood , linux-ide@vger.kernel.org, linux-i2c@vger.kernel.org, Joel Fernandes , linux1394-devel@lists.sourceforge.net, Will Deacon , Jason Gunthorpe , Florian Fainelli , Jonathan Corbet , Mauro Carvalho Chehab , Russell King , Chanwoo Choi , Doug Ledford , MyungJoo Ham , linux-pci@vger.kernel.org, Darren Hart , Niranjana Vishwanathapura , Paul E. McKe List-Id: linux-i2c@vger.kernel.org This patch series is against next-20200317. It addresses several warnings on random places. It is worth noticing patch 07/17: It changes kernel-doc parser to accept a very common pattern on kernel-doc markups. This reduces a lot of warnings all over the tree. The remaining patches are just random fixes with the hope to address most warnings that are shown in red when building the documentation. Mauro Carvalho Chehab (17): docs: amu: supress some Sphinx warnings docs: arm64: booting.rst: get rid of some warnings docs: pci: boot-interrupts.rst: improve html output kernel: futex.c: get rid of a docs build warning devfreq: devfreq.h: get rid of some doc warnings firewire: firewire-cdev.hL get rid of a docs warning scripts: kernel-doc: proper handle @foo->bar() lib: bitmap.c: get rid of some doc warnings rcu: update.c: get rid of some doc warnings net: phy: sfp-bus.c: get rid of docs warnings net: core: dev.c: fix a documentation warning gpio: gpiolib.c: fix a doc warning i2c: include/linux/i2c.h: fix a doc warning infiniband: pa_vnic_encap.h: get rid of a warning ata: libata-core: fix a doc warning fs: inode.c: get rid of docs warnings regulator: driver.h: fix regulator_map_* function names Documentation/PCI/boot-interrupts.rst | 34 ++++++++++-------- Documentation/arm64/amu.rst | 5 +++ Documentation/arm64/booting.rst | 36 +++++++++++-------- drivers/ata/libata-core.c | 2 +- drivers/gpio/gpiolib.c | 2 +- .../infiniband/ulp/opa_vnic/opa_vnic_encap.h | 2 +- drivers/net/phy/sfp-bus.c | 32 +++++++++-------- fs/inode.c | 6 ++-- include/linux/devfreq.h | 6 ++-- include/linux/i2c.h | 4 +-- include/linux/regulator/driver.h | 4 +-- include/uapi/linux/firewire-cdev.h | 2 +- kernel/futex.c | 3 +- kernel/rcu/update.c | 8 ++--- lib/bitmap.c | 27 +++++++------- net/core/dev.c | 2 +- scripts/kernel-doc | 2 ++ 17 files changed, 101 insertions(+), 76 deletions(-) -- 2.24.1