2021-03-10 03:22:14

by Stephen Rothwell

[permalink] [raw]

Subject: linux-next: build warnings after merge of the jc_docs tree

---

Hi all,

After merging the jc_docs tree, today's linux-next build (htmldocs)
produced these warnings:

Documentation/translations/zh_CN/admin-guide/README.rst:3: WARNING: undefined label: linux kernel release 5.x (if the link has no caption the label must precede a section header)
Documentation/translations/zh_CN/admin-guide/unicode.rst:3: WARNING: undefined label: documentation/admin-guide/unicode.rst (if the link has no caption the label must precede a section header)

Introduced by commit

550c8399d017 ("docs/zh_CN: Add zh_CN/admin-guide/README.rst")

--
Cheers,
Stephen Rothwell

---

Attachments:

(No filename) (499.00 B)
OpenPGP digital signature

2021-03-10 08:35:39

by Wu XiangCheng

[permalink] [raw]

Subject: [PATCH] docs/zh_CN: fix original link unknown document warning

---

fix original link unknown document warning in zh_CN/admin-guide/README.rst
and admin-guide/unicode.rst which introduced by commit:

550c8399d017 ("docs/zh_CN: Add zh_CN/admin-guide/README.rst")

Reported-by: Stephen Rothwell <[email protected]>
Signed-off-by: Wu XiangCheng <[email protected]>
---
Sorry for the inconvenience. This is a fix patch.
Or I could re-submit the two original patches if you need.

Documentation/translations/zh_CN/admin-guide/README.rst | 2 +-
Documentation/translations/zh_CN/admin-guide/unicode.rst | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/translations/zh_CN/admin-guide/README.rst b/Documentation/translations/zh_CN/admin-guide/README.rst
index 939aee115e48..99b708a416d8 100644
--- a/Documentation/translations/zh_CN/admin-guide/README.rst
+++ b/Documentation/translations/zh_CN/admin-guide/README.rst
@@ -1,6 +1,6 @@
.. include:: ../disclaimer-zh_CN.rst

-:Original: :ref:`Documentation/admin-guide/README.rst <Linux kernel release 5.x>`
+:Original: :doc:`../../../admin-guide/README`

:译者:

diff --git a/Documentation/translations/zh_CN/admin-guide/unicode.rst b/Documentation/translations/zh_CN/admin-guide/unicode.rst
index ef7f3cb2c02e..814f9ecf562b 100644
--- a/Documentation/translations/zh_CN/admin-guide/unicode.rst
+++ b/Documentation/translations/zh_CN/admin-guide/unicode.rst
@@ -1,6 +1,6 @@
.. include:: ../disclaimer-zh_CN.rst

-:Original: :ref:`Documentation/admin-guide/unicode.rst`
+:Original: :doc:`../../../admin-guide/unicode`

:译者:

--
2.20.1

2021-03-15 23:57:53

by Jonathan Corbet

[permalink] [raw]

Subject: Re: [PATCH] docs/zh_CN: fix original link unknown document warning

---

Wu XiangCheng <[email protected]> writes:

> fix original link unknown document warning in zh_CN/admin-guide/README.rst
> and admin-guide/unicode.rst which introduced by commit:
>
> 550c8399d017 ("docs/zh_CN: Add zh_CN/admin-guide/README.rst")
>
> Reported-by: Stephen Rothwell <[email protected]>
> Signed-off-by: Wu XiangCheng <[email protected]>
> ---
> Sorry for the inconvenience. This is a fix patch.
> Or I could re-submit the two original patches if you need.
>
> Documentation/translations/zh_CN/admin-guide/README.rst | 2 +-
> Documentation/translations/zh_CN/admin-guide/unicode.rst | 2 +-
> 2 files changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/admin-guide/README.rst b/Documentation/translations/zh_CN/admin-guide/README.rst
> index 939aee115e48..99b708a416d8 100644
> --- a/Documentation/translations/zh_CN/admin-guide/README.rst
> +++ b/Documentation/translations/zh_CN/admin-guide/README.rst
> @@ -1,6 +1,6 @@
> .. include:: ../disclaimer-zh_CN.rst
>
> -:Original: :ref:`Documentation/admin-guide/README.rst <Linux kernel release 5.x>`
> +:Original: :doc:`../../../admin-guide/README`

It seems even better to just let automarkup do its thing:

:Original: Documentation/admin-guide/README.rst

I'll just put in a quick fix along those lines.

Thanks,

jon