u-boot.git/doc/sphinx, branch v2023.01

doc: update Sphinx requirements for certifi

2022-12-17T15:25:52+00:00

Upgrade to version 2022.12.7.

Signed-off-by: Heinrich Schuchardt

doc: update doc/sphinx/requirements.txt

2022-03-25T12:59:49+00:00

Pin all dependencies as reported by 'pip freeze'.

Signed-off-by: Heinrich Schuchardt

.readthedocs.yml: update the requirements

2022-01-15T09:57:21+00:00

Fix an error:
  This project needs at least Sphinx v2.4.4.

Signed-off-by: Heinrich Schuchardt

doc: require Sphinx 3.4.3

2021-10-21T01:46:03+00:00

For enums documented according to the requirements in chapter
"Structure, union, and enumeration documentation" of
https://www.kernel.org/doc/html/latest/doc-guide/kernel-doc.html
errors occur with Sphinx 2.4.4 which disappear with Sphinx 3.4.3,
e.g.
/builds/u-boot/custodians/u-boot-efi/doc/api/sysreset:6:
./include/sysreset.h:60:Unknown interpreted text role "enum".

Sphinx 3.4.3 is the version used by Debian in the current release.

Signed-off-by: Heinrich Schuchardt

doc: require Sphinx 2.4.4

2021-08-14T18:54:41+00:00

Require Sphinx 2.44 to build the documentation.
Remove all code related to earlier versions.

Signed-off-by: Heinrich Schuchardt

sphinx: Pin to docutils-0.16

2021-04-04T20:07:09+00:00

In newer docutils writers/latex2e/docutils.sty has a unicode character
in the comments which can in turn cause Python 3.6 at least to fail.
Pin to the previous docutils release for now.

Cc: Heinrich Schuchardt 
Signed-off-by: Tom Rini

doc: update Kernel documentation build system

2021-01-27T11:52:57+00:00

Update the documentation build system according to Linux v5.11-rc1.

Deactive the automarkup.py extension module which on Gitlab CI is
incompatible with Unicode.

With this patch we can build the HTML documentation using either of
Sphinx 2 and Sphinx 3.

Signed-off-by: Heinrich Schuchardt

Revert "doc: update Kernel documentation build system"

2021-01-23T17:51:37+00:00

Unfortunately we now see a number of now-fatal warnings about duplicate
labels.  It is often unclear how best to re-write the document in
question to not duplicate these otherwise logical headings.

This reverts commit 10a1df3cd43ba2fe893d5dd1aeb2e7109ef0007f.

Signed-off-by: Tom Rini

doc: update Kernel documentation build system

2021-01-23T14:53:17+00:00

Update the docomentation build system according to Linux v5.11-rc1.

With this patch we can build the HTML documentation using either of
Sphinx 2 and Sphinx 3.

Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Simon Glass 
[Fix warning in b4860qds.rst about "Switch Settings"]
Signed-off-by: Tom Rini

doc: Sphinx.override_domain() deprecated

2020-10-14T15:16:34+00:00

Sphinx.override_domain() is deprecated since Sphinx 1.8 and removed in
Sphinx 3.

Use Sphinx.add_domain(, override=True) instead.

Signed-off-by: Heinrich Schuchardt