From: Mauro Carvalho Chehab <mchehab+huawei@kernel•org>
To: Linux Doc Mailing List <linux-doc@vger•kernel.org>
Cc: Mauro Carvalho Chehab <mchehab+huawei@kernel•org>,
linux-kernel@vger•kernel.org, Jonathan Corbet <corbet@lwn•net>,
"David S. Miller" <davem@davemloft•net>,
Alexandru Elisei <alexandru.elisei@arm•com>,
Andrew Jones <drjones@redhat•com>, Andrew Lunn <andrew@lunn•ch>,
Anton Ivanov <anton.ivanov@cambridgegreys•com>,
Balbir Singh <sblbir@amazon•com>,
Bartosz Golaszewski <bgolaszewski@baylibre•com>,
Eugeniu Rosca <erosca@de•adit-jv.com>,
Geert Uytterhoeven <geert+renesas@glider•be>,
Jakub Kicinski <kuba@kernel•org>, Jeff Dike <jdike@addtoit•com>,
Linus Walleij <linus.walleij@linaro•org>,
Marc Zyngier <maz@kernel•org>,
Mathieu Poirier <mathieu.poirier@linaro•org>,
Paolo Bonzini <pbonzini@redhat•com>,
Richard Weinberger <richard@nod•at>,
Taehee Yoo <ap420073@gmail•com>,
Thomas Gleixner <tglx@linutronix•de>,
Ulrich Hecht <uli+renesas@fpond•eu>,
Wolfram Sang <wsa@kernel•org>,
kvm@vger•kernel.org, linux-gpio@vger•kernel.org,
linux-i2c@vger•kernel.org, linux-um@lists•infradead.org,
netdev@vger•kernel.org
Subject: [PATCH 0/6] Fix new html build warnings from next-20201001
Date: Fri, 2 Oct 2020 07:49:44 +0200 [thread overview]
Message-ID: <cover.1601616399.git.mchehab+huawei@kernel.org> (raw)
There are some new warnings when building the documentation from
yesterday's linux next. This small series fix them.
- patch 1 documents two new kernel-doc parameters on a net core file.
I used the commit log in order to help documenting them;
- patch 2 fixes some tags at UMLv2 howto;
- patches 3 and 5 add some new documents at the corresponding
index file.
- patch 4 changes kernel-doc script for it to recognize typedef enums.
Patch 4 should probably be merged via docs tree, but the others
are against stuff recently added at linux-next. So, the better is to
merge them directly at the trees which introduced the issue.
-
As a reference, the patches fixing all html build warnings are at:
https://git.linuxtv.org/mchehab/experimental.git/log/?h=sphinx3-fixes-v3
Such series also adds support for Sphinx versions 3.1 and above.
It should be noticed that, with Sphinx version 3 and above, there
are a few new warnings, because currently Sphinx assumes a
that names are unique for all C symbols. There are a few cases
where we have the same name for a function and for a struct at
the Kernel. Upstream is already working on a solution for that.
So, for now, I recomend doing html builds with version < 3.
Mauro Carvalho Chehab (6):
net: core: document two new elements of struct net_device
docs: vcpu.rst: fix some build warnings
docs: virt: user_mode_linux_howto_v2.rst: fix a literal block markup
docs: i2c: index.rst: add slave-testunit-backend.rst
scripts: kernel-doc: add support for typedef enum
docs: gpio: add a new document to its index.rst
Documentation/admin-guide/gpio/index.rst | 1 +
.../admin-guide/hw-vuln/l1d_flush.rst | 3 +--
Documentation/i2c/index.rst | 1 +
Documentation/virt/kvm/devices/vcpu.rst | 26 +++++++++----------
.../virt/uml/user_mode_linux_howto_v2.rst | 1 +
include/linux/netdevice.h | 5 ++++
scripts/kernel-doc | 15 ++++++++---
7 files changed, 33 insertions(+), 19 deletions(-)
--
2.26.2
next reply other threads:[~2020-10-02 5:50 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-10-02 5:49 Mauro Carvalho Chehab [this message]
2020-10-02 5:49 ` [PATCH 1/6] net: core: document two new elements of struct net_device Mauro Carvalho Chehab
2020-10-02 22:16 ` David Miller
2020-10-02 8:19 ` [PATCH 0/6] Fix new html build warnings from next-20201001 Marc Zyngier
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=cover.1601616399.git.mchehab+huawei@kernel.org \
--to=mchehab+huawei@kernel$(echo .)org \
--cc=alexandru.elisei@arm$(echo .)com \
--cc=andrew@lunn$(echo .)ch \
--cc=anton.ivanov@cambridgegreys$(echo .)com \
--cc=ap420073@gmail$(echo .)com \
--cc=bgolaszewski@baylibre$(echo .)com \
--cc=corbet@lwn$(echo .)net \
--cc=davem@davemloft$(echo .)net \
--cc=drjones@redhat$(echo .)com \
--cc=erosca@de$(echo .)adit-jv.com \
--cc=geert+renesas@glider$(echo .)be \
--cc=jdike@addtoit$(echo .)com \
--cc=kuba@kernel$(echo .)org \
--cc=kvm@vger$(echo .)kernel.org \
--cc=linus.walleij@linaro$(echo .)org \
--cc=linux-doc@vger$(echo .)kernel.org \
--cc=linux-gpio@vger$(echo .)kernel.org \
--cc=linux-i2c@vger$(echo .)kernel.org \
--cc=linux-kernel@vger$(echo .)kernel.org \
--cc=linux-um@lists$(echo .)infradead.org \
--cc=mathieu.poirier@linaro$(echo .)org \
--cc=maz@kernel$(echo .)org \
--cc=netdev@vger$(echo .)kernel.org \
--cc=pbonzini@redhat$(echo .)com \
--cc=richard@nod$(echo .)at \
--cc=sblbir@amazon$(echo .)com \
--cc=tglx@linutronix$(echo .)de \
--cc=uli+renesas@fpond$(echo .)eu \
--cc=wsa@kernel$(echo .)org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox