Bump constraints.txt and document how it was generated

Signed-off-by: Christophe Bedard <[email protected]>

Author: christophebedard

constraints.txt

@@ -1,34 +1,27 @@
-alabaster==0.7.16
-atomicwrites==1.4.1
-attrs==25.3.0
+alabaster==1.0.0
 babel==2.17.0
-certifi==2025.4.26
-charset-normalizer==3.4.2
-click==8.1.8
+certifi==2025.10.5
+charset-normalizer==3.4.3
+click==8.3.0
 codespell==2.4.1
-doc8==1.1.2
+doc8==2.0.0
 docutils==0.21.2
 idna==3.10
 imagesize==1.4.1
 iniconfig==2.1.0
 Jinja2==3.1.6
-MarkupSafe==3.0.2
-more-itertools==10.7.0
+MarkupSafe==3.0.3
 packaging==25.0
-pbr==6.1.1
-pluggy==1.5.0
+pluggy==1.6.0
 polib==1.2.0
-py==1.11.0
-Pygments==2.19.1
-pytest==8.3.5
-PyYAML==6.0.2
-regex==2024.11.6
-requests==2.32.3
+Pygments==2.19.2
+pytest==8.4.2
+PyYAML==6.0.3
+regex==2025.9.18
+requests==2.32.5
 restructuredtext_lint==1.4.0
 roman-numerals-py==3.1.0
-setuptools==80.3.1
-six==1.17.0
-snowballstemmer==3.0.0.1
+snowballstemmer==3.0.1
 Sphinx==8.2.3
 sphinx-copybutton==0.5.2
 sphinx-lint==1.0.0
@@ -38,12 +31,12 @@ sphinx-tabs==3.4.7
 sphinx_tamer==0.2.0
 sphinxcontrib-applehelp==2.0.0
 sphinxcontrib-devhelp==2.0.0
-sphinxcontrib-googleanalytics==0.4
+sphinxcontrib-googleanalytics==0.5
 sphinxcontrib-htmlhelp==2.1.0
 sphinxcontrib-jquery==4.1
 sphinxcontrib-jsmath==1.0.1
 sphinxcontrib-mermaid==1.0.0
 sphinxcontrib-qthelp==2.0.0
 sphinxcontrib-serializinghtml==2.0.0
-stevedore==5.4.1
-urllib3==2.4.0
+stevedore==5.5.0
+urllib3==2.5.0

docker/image/Dockerfile

@@ -39,5 +39,15 @@ USER $user
 # Do not remove "make multiversion" from CMD, as it is the entrypoint for the container.
 CMD ["bash", "-c", "source /opt/ros2doc/bin/activate && make multiversion"]
 RUN python3 -m venv /opt/ros2doc
+# constraints.txt was generated with:
+#   $ cd ros2_documentation
+#   $ docker run -v $PWD:/ros2_documentation -it ubuntu:24.04
+#   (docker)$ cd /ros2_documentation
+#   (docker)$ apt update
+#   (docker)$ apt install -y python3-pip python3-venv
+#   (docker)$ python3 -m venv venv-constraints
+#   (docker)$ . ./venv-constraints/bin/activate
+#   (docker)$ pip3 install -U -r requirements.txt
+#   (docker)$ pip3 freeze > constraints.txt
 COPY requirements.txt constraints.txt .
 RUN . /opt/ros2doc/bin/activate && pip3 install -r requirements.txt -c constraints.txt