* [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4
@ 2022-07-02 11:07 Mauro Carvalho Chehab
2022-07-02 11:07 ` [PATCH 04/12] docs: PCI: pci-vntb-function.rst: Properly include ascii artwork Mauro Carvalho Chehab
` (2 more replies)
0 siblings, 3 replies; 6+ messages in thread
From: Mauro Carvalho Chehab @ 2022-07-02 11:07 UTC (permalink / raw)
To: Linux Doc Mailing List
Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
Jonathan Corbet, David S. Miller, Krzysztof Wilczyński,
Theodore Ts'o, Alasdair Kergon, Andreas Dilger,
Brendan Higgins, Dipen Patel, Eric Dumazet, Jakub Kicinski,
Jaroslav Kysela, Johannes Berg, Mike Snitzer, Paolo Abeni,
Takashi Iwai, alsa-devel, dm-devel, kunit-dev, kvm, linux-ext4,
linux-kselftest, linux-pci, linux-tegra, linux-wireless, netdev
This series is against next-20220701. It fixes several warnings
that are currently produced while building html docs.
Each patch in this series is independent from the others, as
each one touches a different file.
Mauro Carvalho Chehab (12):
docs: ext4: blockmap.rst: fix a broken table
docs: tegra194-hte.rst: don't include gpiolib.c twice
docs: device-mapper: add a blank line at writecache.rst
docs: PCI: pci-vntb-function.rst: Properly include ascii artwork
docs: PCI: pci-vntb-howto.rst: fix a title markup
docs: virt: kvm: fix a title markup at api.rst
docs: ABI: sysfs-bus-nvdimm
kunit: test.h: fix a kernel-doc markup
net: mac80211: fix a kernel-doc markup
docs: alsa: alsa-driver-api.rst: remove a kernel-doc file
docs: arm: index.rst: add google/chromebook-boot-flow
docs: leds: index.rst: add leds-qcom-lpg to it
Documentation/ABI/testing/sysfs-bus-nvdimm | 2 ++
Documentation/PCI/endpoint/pci-vntb-function.rst | 2 +-
Documentation/PCI/endpoint/pci-vntb-howto.rst | 2 +-
Documentation/admin-guide/device-mapper/writecache.rst | 1 +
Documentation/arm/index.rst | 2 ++
Documentation/driver-api/hte/tegra194-hte.rst | 3 +--
Documentation/filesystems/ext4/blockmap.rst | 2 +-
Documentation/leds/index.rst | 1 +
Documentation/sound/kernel-api/alsa-driver-api.rst | 1 -
Documentation/virt/kvm/api.rst | 6 +++---
include/kunit/test.h | 2 +-
include/net/mac80211.h | 2 +-
12 files changed, 15 insertions(+), 11 deletions(-)
--
2.36.1
^ permalink raw reply [flat|nested] 6+ messages in thread
* [PATCH 04/12] docs: PCI: pci-vntb-function.rst: Properly include ascii artwork
2022-07-02 11:07 [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4 Mauro Carvalho Chehab
@ 2022-07-02 11:07 ` Mauro Carvalho Chehab
2022-07-12 19:57 ` Bjorn Helgaas
2022-07-02 11:07 ` [PATCH 05/12] docs: PCI: pci-vntb-howto.rst: fix a title markup Mauro Carvalho Chehab
2022-07-03 3:26 ` [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4 Bagas Sanjaya
2 siblings, 1 reply; 6+ messages in thread
From: Mauro Carvalho Chehab @ 2022-07-02 11:07 UTC (permalink / raw)
To: Linux Doc Mailing List
Cc: Mauro Carvalho Chehab, Jonathan Corbet,
Krzysztof Wilczyński, Mauro Carvalho Chehab, Bjorn Helgaas,
Kishon Vijay Abraham I, Lorenzo Pieralisi, linux-kernel,
linux-pci
Adjust identation and add a "::" in order to properly mark the
ascii artwork as a code block, fixing this warning:
Documentation/PCI/endpoint/pci-vntb-function.rst:82: WARNING: Unexpected indentation.
Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
---
To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover.
See [PATCH 00/12] at: https://lore.kernel.org/all/cover.1656759988.git.mchehab@kernel.org/
Documentation/PCI/endpoint/pci-vntb-function.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/PCI/endpoint/pci-vntb-function.rst b/Documentation/PCI/endpoint/pci-vntb-function.rst
index cad8013e8839..7b2ac70e2c57 100644
--- a/Documentation/PCI/endpoint/pci-vntb-function.rst
+++ b/Documentation/PCI/endpoint/pci-vntb-function.rst
@@ -58,7 +58,7 @@ It is same as PCI NTB Function driver
Scratchpad Registers:
---------------------
- It is appended after Config region.
+It is appended after Config region::
+--------------------------------------------------+ Base
| |
--
2.36.1
^ permalink raw reply related [flat|nested] 6+ messages in thread
* [PATCH 05/12] docs: PCI: pci-vntb-howto.rst: fix a title markup
2022-07-02 11:07 [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4 Mauro Carvalho Chehab
2022-07-02 11:07 ` [PATCH 04/12] docs: PCI: pci-vntb-function.rst: Properly include ascii artwork Mauro Carvalho Chehab
@ 2022-07-02 11:07 ` Mauro Carvalho Chehab
2022-07-12 19:58 ` Bjorn Helgaas
2022-07-03 3:26 ` [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4 Bagas Sanjaya
2 siblings, 1 reply; 6+ messages in thread
From: Mauro Carvalho Chehab @ 2022-07-02 11:07 UTC (permalink / raw)
To: Linux Doc Mailing List
Cc: Mauro Carvalho Chehab, Jonathan Corbet,
Krzysztof Wilczyński, Mauro Carvalho Chehab, Bjorn Helgaas,
Kishon Vijay Abraham I, Lorenzo Pieralisi, linux-kernel,
linux-pci
As warned by Sphinx:
Documentation/PCI/endpoint/pci-vntb-howto.rst:131: WARNING: Title underline too short.
Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
---
To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover.
See [PATCH 00/12] at: https://lore.kernel.org/all/cover.1656759988.git.mchehab@kernel.org/
Documentation/PCI/endpoint/pci-vntb-howto.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/PCI/endpoint/pci-vntb-howto.rst b/Documentation/PCI/endpoint/pci-vntb-howto.rst
index b4a679144692..31a0bae868f9 100644
--- a/Documentation/PCI/endpoint/pci-vntb-howto.rst
+++ b/Documentation/PCI/endpoint/pci-vntb-howto.rst
@@ -128,7 +128,7 @@ RootComplex Device
==================
lspci Output at Host side
-------------------------
+-------------------------
Note that the devices listed here correspond to the values populated in
"Creating pci-epf-ntb Device" section above::
--
2.36.1
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4
2022-07-02 11:07 [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4 Mauro Carvalho Chehab
2022-07-02 11:07 ` [PATCH 04/12] docs: PCI: pci-vntb-function.rst: Properly include ascii artwork Mauro Carvalho Chehab
2022-07-02 11:07 ` [PATCH 05/12] docs: PCI: pci-vntb-howto.rst: fix a title markup Mauro Carvalho Chehab
@ 2022-07-03 3:26 ` Bagas Sanjaya
2 siblings, 0 replies; 6+ messages in thread
From: Bagas Sanjaya @ 2022-07-03 3:26 UTC (permalink / raw)
To: Mauro Carvalho Chehab
Cc: Linux Doc Mailing List, Mauro Carvalho Chehab, linux-kernel,
Jonathan Corbet, David S. Miller, Krzysztof Wilczyński,
Theodore Ts'o, Alasdair Kergon, Andreas Dilger,
Brendan Higgins, Dipen Patel, Eric Dumazet, Jakub Kicinski,
Jaroslav Kysela, Johannes Berg, Mike Snitzer, Paolo Abeni,
Takashi Iwai, Gwendal Grignou, alsa-devel, dm-devel, kunit-dev,
kvm, linux-ext4, linux-kselftest, linux-pci, linux-tegra,
linux-wireless, netdev
On Sat, Jul 02, 2022 at 12:07:32PM +0100, Mauro Carvalho Chehab wrote:
> This series is against next-20220701. It fixes several warnings
> that are currently produced while building html docs.
>
> Each patch in this series is independent from the others, as
> each one touches a different file.
>
> Mauro Carvalho Chehab (12):
> docs: ext4: blockmap.rst: fix a broken table
> docs: tegra194-hte.rst: don't include gpiolib.c twice
> docs: device-mapper: add a blank line at writecache.rst
> docs: PCI: pci-vntb-function.rst: Properly include ascii artwork
> docs: PCI: pci-vntb-howto.rst: fix a title markup
> docs: virt: kvm: fix a title markup at api.rst
> docs: ABI: sysfs-bus-nvdimm
> kunit: test.h: fix a kernel-doc markup
> net: mac80211: fix a kernel-doc markup
> docs: alsa: alsa-driver-api.rst: remove a kernel-doc file
> docs: arm: index.rst: add google/chromebook-boot-flow
> docs: leds: index.rst: add leds-qcom-lpg to it
>
Hi Mauro,
Thanks for cleaning up these warning above. However, I have already
submitted some of these cleanups (pending reviews or integration):
[1]: https://lore.kernel.org/linux-doc/20220702042350.23187-1-bagasdotme@gmail.com/
[2]: https://lore.kernel.org/linux-doc/20220612000125.9777-1-bagasdotme@gmail.com/
[3]: https://lore.kernel.org/linux-doc/20220627095151.19339-1-bagasdotme@gmail.com/
[4]: https://lore.kernel.org/linux-doc/20220627082928.11239-1-bagasdotme@gmail.com/
There's still a warning left:
Documentation/ABI/testing/sysfs-bus-iio-sx9324:2: WARNING: Unexpected indentation.
But I think the Date: field that triggered the warning above looks OK.
Regardless of that, the build successed.
Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com>
--
An old man doll... just what I always wanted! - Clara
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH 04/12] docs: PCI: pci-vntb-function.rst: Properly include ascii artwork
2022-07-02 11:07 ` [PATCH 04/12] docs: PCI: pci-vntb-function.rst: Properly include ascii artwork Mauro Carvalho Chehab
@ 2022-07-12 19:57 ` Bjorn Helgaas
0 siblings, 0 replies; 6+ messages in thread
From: Bjorn Helgaas @ 2022-07-12 19:57 UTC (permalink / raw)
To: Mauro Carvalho Chehab
Cc: Linux Doc Mailing List, Jonathan Corbet,
Krzysztof Wilczyński, Mauro Carvalho Chehab, Bjorn Helgaas,
Kishon Vijay Abraham I, Lorenzo Pieralisi, linux-kernel,
linux-pci, Jon Mason, Frank Li
[+cc Jon, Frank]
On Sat, Jul 02, 2022 at 12:07:36PM +0100, Mauro Carvalho Chehab wrote:
> Adjust identation and add a "::" in order to properly mark the
> ascii artwork as a code block, fixing this warning:
>
> Documentation/PCI/endpoint/pci-vntb-function.rst:82: WARNING: Unexpected indentation.
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
The series that adds this doc appears to be being merged via Jon
(cc'd).
> ---
>
> To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover.
> See [PATCH 00/12] at: https://lore.kernel.org/all/cover.1656759988.git.mchehab@kernel.org/
>
> Documentation/PCI/endpoint/pci-vntb-function.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/PCI/endpoint/pci-vntb-function.rst b/Documentation/PCI/endpoint/pci-vntb-function.rst
> index cad8013e8839..7b2ac70e2c57 100644
> --- a/Documentation/PCI/endpoint/pci-vntb-function.rst
> +++ b/Documentation/PCI/endpoint/pci-vntb-function.rst
> @@ -58,7 +58,7 @@ It is same as PCI NTB Function driver
> Scratchpad Registers:
> ---------------------
>
> - It is appended after Config region.
> +It is appended after Config region::
>
> +--------------------------------------------------+ Base
> | |
> --
> 2.36.1
>
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH 05/12] docs: PCI: pci-vntb-howto.rst: fix a title markup
2022-07-02 11:07 ` [PATCH 05/12] docs: PCI: pci-vntb-howto.rst: fix a title markup Mauro Carvalho Chehab
@ 2022-07-12 19:58 ` Bjorn Helgaas
0 siblings, 0 replies; 6+ messages in thread
From: Bjorn Helgaas @ 2022-07-12 19:58 UTC (permalink / raw)
To: Mauro Carvalho Chehab
Cc: Linux Doc Mailing List, Jonathan Corbet,
Krzysztof Wilczyński, Mauro Carvalho Chehab, Bjorn Helgaas,
Kishon Vijay Abraham I, Lorenzo Pieralisi, linux-kernel,
linux-pci, Jon Mason, Frank Li
[+cc Jon, Frank]
On Sat, Jul 02, 2022 at 12:07:37PM +0100, Mauro Carvalho Chehab wrote:
> As warned by Sphinx:
> Documentation/PCI/endpoint/pci-vntb-howto.rst:131: WARNING: Title underline too short.
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Another for Jon.
> ---
>
> To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover.
> See [PATCH 00/12] at: https://lore.kernel.org/all/cover.1656759988.git.mchehab@kernel.org/
>
> Documentation/PCI/endpoint/pci-vntb-howto.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/PCI/endpoint/pci-vntb-howto.rst b/Documentation/PCI/endpoint/pci-vntb-howto.rst
> index b4a679144692..31a0bae868f9 100644
> --- a/Documentation/PCI/endpoint/pci-vntb-howto.rst
> +++ b/Documentation/PCI/endpoint/pci-vntb-howto.rst
> @@ -128,7 +128,7 @@ RootComplex Device
> ==================
>
> lspci Output at Host side
> -------------------------
> +-------------------------
>
> Note that the devices listed here correspond to the values populated in
> "Creating pci-epf-ntb Device" section above::
> --
> 2.36.1
>
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2022-07-12 19:58 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-07-02 11:07 [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4 Mauro Carvalho Chehab
2022-07-02 11:07 ` [PATCH 04/12] docs: PCI: pci-vntb-function.rst: Properly include ascii artwork Mauro Carvalho Chehab
2022-07-12 19:57 ` Bjorn Helgaas
2022-07-02 11:07 ` [PATCH 05/12] docs: PCI: pci-vntb-howto.rst: fix a title markup Mauro Carvalho Chehab
2022-07-12 19:58 ` Bjorn Helgaas
2022-07-03 3:26 ` [PATCH 00/12] Fix several documentation build warnings with Sphinx 2.4.4 Bagas Sanjaya
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).