Re: linux-next: build warning after merge of the jc_docs tree

From: Jonathan Corbet
Date: Mon Dec 14 2020 - 15:19:00 EST


On Tue, 15 Dec 2020 06:51:43 +1100
Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx> wrote:

> On Mon, 16 Nov 2020 17:03:03 +1100 Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx> wrote:
> >
> > After merging the jc_docs tree, today's linux-next build (htmldocs)
> > produced this warning:
> >
> > Documentation/translations/zh_CN/filesystems/tmpfs.rst:5: WARNING: undefined label: tmpfs_index (if the link has no caption the label must precede a section header)
> >
> > Introduced by commit
> >
> > 09028e60fcea ("doc: zh_CN: add translatation for tmpfs")
>
> I am still getting this warning.

OK, enough of that; I've just tacked on the following patch to address
this problem, thanks for the report.

Thanks,

jon

From 47e44ed01434e51e2e42b188482d837c01e5d16e Mon Sep 17 00:00:00 2001
From: Jonathan Corbet <corbet@xxxxxxx>
Date: Mon, 14 Dec 2020 13:14:22 -0700
Subject: [PATCH] docs: fix broken cross reference in translations/zh_CN

Commit 09028e60fcea ("doc: zh_CN: add translatation for tmpfs") introduced
a cross reference without adding the appropriate target tag, leading to
this docs-build warning:

Documentation/translations/zh_CN/filesystems/tmpfs.rst:5: WARNING: undefined label: tmpfs_index (if the link has no caption the label must precede a section header)

With automarkup, we don't actually need an explicit reference here at all,
so just take it out.

Reported-by: Stephen Rothwell <sfr@xxxxxxxxxxxxxxxx>
Fixes: 09028e60fcea ("doc: zh_CN: add translatation for tmpfs")
Signed-off-by: Jonathan Corbet <corbet@xxxxxxx>
---
Documentation/translations/zh_CN/filesystems/tmpfs.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/translations/zh_CN/filesystems/tmpfs.rst b/Documentation/translations/zh_CN/filesystems/tmpfs.rst
index cf3ccab20e50..6fd9d83b2db5 100644
--- a/Documentation/translations/zh_CN/filesystems/tmpfs.rst
+++ b/Documentation/translations/zh_CN/filesystems/tmpfs.rst
@@ -2,7 +2,7 @@

.. include:: ../disclaimer-zh_CN.rst

-:Original: :ref:`Documentation/filesystems/tmpfs.rst <tmpfs_index>`
+:Original: Documentation/filesystems/tmpfs.rst

translated by Wang Qing<wangqing@xxxxxxxx>

--
2.28.0