docs: prevent warnings due to autosectionlabel
authorMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Fri, 20 Mar 2020 15:11:02 +0000 (16:11 +0100)
committerJonathan Corbet <corbet@lwn.net>
Fri, 20 Mar 2020 23:01:29 +0000 (17:01 -0600)
commitc44166fe5f38f0559eff1138cca094f3460e2345
treec3febd3655ced76c0a8666ead9d92dead378cc76
parent58ad30cf91f073a9fab4f8e238b025431343dbf3
docs: prevent warnings due to autosectionlabel

Changeset 58ad30cf91f0 ("docs: fix reference to core-api/namespaces.rst")
enabled a new feature at Sphinx: it will now generate index for each
document title, plus to each chapter inside it.

There's a drawback, though: one document cannot have two sections
with the same name anymore.

A followup patch will change the logic of autosectionlabel to
avoid most creating references for every single section title,
but still we need to be able to reference the chapters inside
a document.

There are a few places where there are two chapters with the
same name. This patch renames one of the chapters, in order to
avoid symbol conflict within the same document.

PS.: as I don't speach Chinese, I had some help from a friend
(Wen Liu) at the Chinese translation for "publishing patches"
for this document:

Documentation/translations/zh_CN/process/5.Posting.rst

Fixes: 58ad30cf91f0 ("docs: fix reference to core-api/namespaces.rst")
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/2bffb91e4a63d41bf5fae1c23e1e8b3bba0b8806.1584716446.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/driver-api/80211/mac80211-advanced.rst
Documentation/driver-api/dmaengine/index.rst
Documentation/filesystems/ecryptfs.rst
Documentation/kernel-hacking/hacking.rst
Documentation/media/kapi/v4l2-controls.rst
Documentation/networking/snmp_counter.rst
Documentation/powerpc/ultravisor.rst
Documentation/security/siphash.rst
Documentation/target/tcmu-design.rst
Documentation/translations/zh_CN/process/5.Posting.rst
Documentation/x86/intel-iommu.rst