diff mbox series

[v2] .readthedocs.yml: specify some minimum python requirements

Message ID 20200206163120.31899-1-alex.bennee@linaro.org
State New
Headers show
Series [v2] .readthedocs.yml: specify some minimum python requirements | expand

Commit Message

Alex Bennée Feb. 6, 2020, 4:31 p.m. UTC
QEMU is all about the Python 3 now so lets also hint that to
ReadTheDocs in its config file.

Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>

---
If anyone wants to include this is their next PR please do, otherwise
it will be a misc patch in my next series ;-)
---
 .readthedocs.yml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 .readthedocs.yml

Comments

Philippe Mathieu-Daudé Feb. 6, 2020, 5 p.m. UTC | #1
On 2/6/20 5:31 PM, Alex Bennée wrote:
> QEMU is all about the Python 3 now so lets also hint that to
> ReadTheDocs in its config file.
> 
> Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
> Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
> 
> ---
> If anyone wants to include this is their next PR please do, otherwise
> it will be a misc patch in my next series ;-)
> ---
>   .readthedocs.yml | 20 ++++++++++++++++++++
>   1 file changed, 20 insertions(+)
>   create mode 100644 .readthedocs.yml
> 
> diff --git a/.readthedocs.yml b/.readthedocs.yml
> new file mode 100644
> index 00000000000..8355dbc6343
> --- /dev/null
> +++ b/.readthedocs.yml
> @@ -0,0 +1,20 @@
> +# .readthedocs.yml
> +# Read the Docs configuration file
> +# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
> +
> +# Required
> +version: 2
> +
> +# Build documentation in the docs/ directory with Sphinx
> +sphinx:
> +  configuration: docs/conf.py
> +
> +# We want all the document formats
> +formats: all
> +
> +# For consistency, we require that QEMU's Sphinx extensions
> +# run with at least the same minimum version of Python that
> +# we require for other Python in our codebase (our conf.py
> +# enforces this, and some code needs it.)
> +python:
> +  version: 3.5
> 

I wonder if this could also help:

   submodules:
     exclude: all

See https://docs.readthedocs.io/en/stable/config-file/v2.html#submodules

Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>

Patch applied to my python-next tree:
https://gitlab.com/philmd/qemu/commits/python-next
diff mbox series

Patch

diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 00000000000..8355dbc6343
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,20 @@ 
+# .readthedocs.yml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# We want all the document formats
+formats: all
+
+# For consistency, we require that QEMU's Sphinx extensions
+# run with at least the same minimum version of Python that
+# we require for other Python in our codebase (our conf.py
+# enforces this, and some code needs it.)
+python:
+  version: 3.5