# This build doesn't use problem matchers or check annotations

# It also does not run 'make check', as sphinx-lint is not installed into the

# environment.

build_doc_oldest_supported_sphinx:

name: 'Docs (Oldest Sphinx)'

runs-on: ubuntu-latest

timeout-minutes: 60

steps:

- uses: actions/checkout@v3

- name: 'Set up Python'

uses: actions/setup-python@v4

with:

python-version: '3.11' # known to work with Sphinx 3.2

cache: 'pip'

cache-dependency-path: 'Doc/requirements-oldest-sphinx.txt'

- name: 'Install build dependencies'

run: make -C Doc/ venv REQUIREMENTS="requirements-oldest-sphinx.txt"

- name: 'Build HTML documentation'

run: make -C Doc/ SPHINXOPTS="-q" SPHINXERRORHANDLING="-W --keep-going" html

REQUIREMENTS = requirements.txt

$(VENVDIR)/bin/python3 -m pip install --upgrade pip; \

$(VENVDIR)/bin/python3 -m pip install -r $(REQUIREMENTS); \

:param ~sqlite3.Connection factory:

:rtype: ~sqlite3.Connection

:param ~sqlite3.Connection target:

# Requirements to build the Python documentation, for the oldest supported

# Sphinx version.

#

# We pin Sphinx and all of its dependencies to ensure a consistent environment.

blurb

python-docs-theme>=2022.1

# Generated from:

# pip install "Sphinx~=3.2.0" "docutils<0.17" "Jinja2<3" "MarkupSafe<2"

# pip freeze

#

# Sphinx 3.2 comes from ``needs_sphinx = '3.2'`` in ``Doc/conf.py``.

# Docutils<0.17, Jinja2<3, and MarkupSafe<2 are additionally specified as

# Sphinx 3.2 is incompatible with newer releases of these packages.

Sphinx==3.2.1

alabaster==0.7.13

Babel==2.12.1

certifi==2022.12.7

charset-normalizer==3.1.0

colorama==0.4.6

docutils==0.16

idna==3.4

imagesize==1.4.1

Jinja2==2.11.3

MarkupSafe==1.1.1

packaging==23.1

Pygments==2.15.1

requests==2.29.0

snowballstemmer==2.2.0

sphinxcontrib-applehelp==1.0.4

sphinxcontrib-devhelp==1.0.2

sphinxcontrib-htmlhelp==2.0.1

sphinxcontrib-jsmath==1.0.1

sphinxcontrib-qthelp==1.0.3

sphinxcontrib-serializinghtml==1.1.5

urllib3==1.26.15