[PATCH] docs: Disambiguate a pair of rST labels

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Because reStructuredText does not provide lexical scoping rules for
labels, resolution of targets that have duplicate declarations is
ambiguous and produces nondeterministic output.

To improve the reproducibility of the HTML documentation,
disambiguate two labels both previously titled "submit_improvements".

Link: https://github.com/sphinx-doc/sphinx/issues/13383
Signed-off-by: James Addison <jay@xxxxxxxxxxxxxx>
---
 Documentation/admin-guide/quickly-build-trimmed-linux.rst     | 4 ++--
 .../admin-guide/verify-bugs-and-bisect-regressions.rst        | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/admin-guide/quickly-build-trimmed-linux.rst
b/Documentation/admin-guide/quickly-build-trimmed-linux.rst
index 07cfd8863..2d1b6f750 100644
--- a/Documentation/admin-guide/quickly-build-trimmed-linux.rst
+++ b/Documentation/admin-guide/quickly-build-trimmed-linux.rst
@@ -347,7 +347,7 @@ again.

    [:ref:`details<uninstall>`]

-.. _submit_improvements:
+.. _submit_trimmed_build_improvements:

 Did you run into trouble following any of the above steps that is not
cleared up
 by the reference section below? Or do you have ideas how to improve the text?
@@ -1070,7 +1070,7 @@ complicated, and harder to follow.

 That being said: this of course is a balancing act. Hence, if you think an
 additional use-case is worth describing, suggest it to the maintainers of this
-document, as :ref:`described above <submit_improvements>`.
+document, as :ref:`described above <submit_trimmed_build_improvements>`.


 ..
diff --git a/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst
b/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst
index 03c551513..1b246d8a8 100644
--- a/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst
+++ b/Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst
@@ -267,7 +267,7 @@ culprit might be known already. For further
details on what actually qualifies
 as a regression check out Documentation/admin-guide/reporting-regressions.rst.

 If you run into any problems while following this guide or have ideas how to
-improve it, :ref:`please let the kernel developers know <submit_improvements>`.
+improve it, :ref:`please let the kernel developers know
<submit_regression_tracing_improvements>`.

 .. _introprep_bissbs:

@@ -1055,7 +1055,7 @@ follow these instructions.

 [:ref:`details <introoptional_bisref>`]

-.. _submit_improvements:
+.. _submit_regression_tracing_improvements:

 Conclusion
 ----------
-- 
2.47.2




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux