From e20628db512128d3a5c66360943462b83da5f049 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 19:25:44 +0200 Subject: Adding debian version 7.2.6-6. Signed-off-by: Daniel Baumann --- debian/.gitlab-ci.yml | 7 + debian/changelog | 2289 ++++++++++++++++++++ debian/clean | 12 + debian/control | 144 ++ debian/copyright | 85 + debian/dh-sphinxdoc/conf.py | 3 + debian/dh-sphinxdoc/dh_sphinxdoc | 616 ++++++ debian/dh-sphinxdoc/empty.rst | 0 debian/dh-sphinxdoc/index | 8 + debian/dh-sphinxdoc/install-js | 22 + debian/dh-sphinxdoc/sphinxdoc.pm | 8 + debian/gbp.conf | 2 + debian/jstest/jstest.py | 125 ++ debian/jstest/run-tests | 40 + debian/libjs-sphinxdoc.dirs | 1 + debian/libjs-sphinxdoc.install | 1 + debian/libjs-sphinxdoc.links | 2 + debian/patches/docutils_manpage_macros.diff | 22 + debian/patches/intersphinx_local.diff | 51 + .../move_sphinxcontrib_to_extras_require.diff | 40 + debian/patches/no_external_css.diff | 21 + debian/patches/python_3.11.7.diff | 77 + debian/patches/remove_contrib_references.diff | 79 + debian/patches/series | 11 + debian/patches/skip_tests_jsmath.diff | 36 + debian/patches/skip_tests_network.diff | 21 + debian/patches/skip_tests_serializinghtml.diff | 28 + debian/patches/support_old_search_indexes.diff | 48 + debian/patches/use_packaged_mathjax.diff | 20 + debian/python3-sphinx.install | 2 + debian/python3-sphinx.links | 4 + debian/python3-sphinx.preinst | 13 + debian/python3-sphinx.pyremove | 1 + debian/rules | 82 + debian/source/format | 1 + debian/source/lintian-overrides | 8 + debian/source/options | 2 + debian/sphinx-common.install | 9 + debian/sphinx-common.lintian-overrides | 3 + debian/sphinx-common.manpages | 5 + debian/sphinx-doc.doc-base | 12 + debian/sphinx-doc.docs | 3 + debian/sphinx-doc.links | 3 + debian/sphinx-doc.lintian-overrides | 4 + debian/tests/control | 27 + debian/tests/python3-sphinx | 10 + debian/tests/sphinx-doc | 18 + debian/upstream/metadata | 5 + debian/watch | 2 + 49 files changed, 4033 insertions(+) create mode 100644 debian/.gitlab-ci.yml create mode 100644 debian/changelog create mode 100644 debian/clean create mode 100644 debian/control create mode 100644 debian/copyright create mode 100644 debian/dh-sphinxdoc/conf.py create mode 100755 debian/dh-sphinxdoc/dh_sphinxdoc create mode 100644 debian/dh-sphinxdoc/empty.rst create mode 100644 debian/dh-sphinxdoc/index create mode 100755 debian/dh-sphinxdoc/install-js create mode 100644 debian/dh-sphinxdoc/sphinxdoc.pm create mode 100644 debian/gbp.conf create mode 100644 debian/jstest/jstest.py create mode 100755 debian/jstest/run-tests create mode 100644 debian/libjs-sphinxdoc.dirs create mode 100644 debian/libjs-sphinxdoc.install create mode 100644 debian/libjs-sphinxdoc.links create mode 100644 debian/patches/docutils_manpage_macros.diff create mode 100644 debian/patches/intersphinx_local.diff create mode 100644 debian/patches/move_sphinxcontrib_to_extras_require.diff create mode 100644 debian/patches/no_external_css.diff create mode 100644 debian/patches/python_3.11.7.diff create mode 100644 debian/patches/remove_contrib_references.diff create mode 100644 debian/patches/series create mode 100644 debian/patches/skip_tests_jsmath.diff create mode 100644 debian/patches/skip_tests_network.diff create mode 100644 debian/patches/skip_tests_serializinghtml.diff create mode 100644 debian/patches/support_old_search_indexes.diff create mode 100644 debian/patches/use_packaged_mathjax.diff create mode 100644 debian/python3-sphinx.install create mode 100644 debian/python3-sphinx.links create mode 100644 debian/python3-sphinx.preinst create mode 100644 debian/python3-sphinx.pyremove create mode 100755 debian/rules create mode 100644 debian/source/format create mode 100644 debian/source/lintian-overrides create mode 100644 debian/source/options create mode 100644 debian/sphinx-common.install create mode 100644 debian/sphinx-common.lintian-overrides create mode 100644 debian/sphinx-common.manpages create mode 100644 debian/sphinx-doc.doc-base create mode 100644 debian/sphinx-doc.docs create mode 100644 debian/sphinx-doc.links create mode 100644 debian/sphinx-doc.lintian-overrides create mode 100644 debian/tests/control create mode 100755 debian/tests/python3-sphinx create mode 100644 debian/tests/sphinx-doc create mode 100644 debian/upstream/metadata create mode 100644 debian/watch diff --git a/debian/.gitlab-ci.yml b/debian/.gitlab-ci.yml new file mode 100644 index 0000000..be2cea2 --- /dev/null +++ b/debian/.gitlab-ci.yml @@ -0,0 +1,7 @@ +include: + - https://salsa.debian.org/salsa-ci-team/pipeline/raw/master/salsa-ci.yml + - https://salsa.debian.org/salsa-ci-team/pipeline/raw/master/pipeline-jobs.yml + +variables: + SALSA_CI_REPROTEST_ENABLE_DIFFOSCOPE: 1 + SALSA_CI_REPROTEST_ARGS: --variations=-locales diff --git a/debian/changelog b/debian/changelog new file mode 100644 index 0000000..7bd47a6 --- /dev/null +++ b/debian/changelog @@ -0,0 +1,2289 @@ +sphinx (7.2.6-6) unstable; urgency=medium + + * Break old versions of python-flask-restful-doc and python-pylatex-doc + (closes: #1067424). + + -- Dmitry Shachnev Fri, 22 Mar 2024 00:19:02 +0300 + +sphinx (7.2.6-5) unstable; urgency=medium + + * Remove unused python3-distutils dependency (closes: #1065959). + + -- Dmitry Shachnev Mon, 11 Mar 2024 11:29:30 +0300 + +sphinx (7.2.6-4) unstable; urgency=medium + + * dh_sphinxdoc: Support zzzeeksphinx’ new way of setting content_root. + + -- Dmitry Shachnev Sun, 11 Feb 2024 20:08:39 +0300 + +sphinx (7.2.6-3) unstable; urgency=medium + + * Add a patch to fix build with Python 3.11.7+ (closes: #1058303). + + -- Dmitry Shachnev Tue, 19 Dec 2023 13:34:25 +0300 + +sphinx (7.2.6-2) unstable; urgency=medium + + * Upload to unstable. + + -- Dmitry Shachnev Sun, 05 Nov 2023 15:54:03 +0300 + +sphinx (7.2.6-1) experimental; urgency=medium + + * New upstream release. + * Refresh patches. + + -- Dmitry Shachnev Sat, 16 Sep 2023 16:57:25 +0300 + +sphinx (7.2.5-1) experimental; urgency=medium + + * New upstream release. + * Drop patches, applied upstream: + - timegm.diff + - include_normalize_path.diff + + -- Dmitry Shachnev Sat, 02 Sep 2023 20:41:15 +0300 + +sphinx (7.2.3-1) experimental; urgency=medium + + * New upstream release. + * Drop patches, included in the new release: + - highlight_search_terms.diff + - dont_hardcode_checksum.diff + - deterministic_default.diff + * Refresh and rebase other patches. + * Bump required python3-pygments version to 2.14. + * dh_sphinxdoc: Look for content_root data attribute, not url_root. + * Bump minimum versions in debian/dh-sphinxdoc/index. + * Update numbers in debian/jstest/run-tests. + * Amend support_old_search_indexes.diff to also support old search.html + templates which don't have data-content_root. + * Add a patch to use calendar.timegm() to convert UTC time to UNIX epoch. + * Add a patch to make tests pass when run from /tmp. + + -- Dmitry Shachnev Sat, 26 Aug 2023 23:45:20 +0300 + +sphinx (7.1.2-2) experimental; urgency=medium + + * Merge 5.3.0-7 upload from unstable. + * debian/tests/sphinx-doc: Remove no longer needed "export GTK_A11Y=none". + * Update highlight_search_terms.diff to version which was applied upstream. + + -- Dmitry Shachnev Sun, 13 Aug 2023 12:55:53 +0300 + +sphinx (7.1.2-1) experimental; urgency=medium + + * New upstream release. + + -- Dmitry Shachnev Thu, 03 Aug 2023 12:46:26 +0300 + +sphinx (7.1.1-1) experimental; urgency=medium + + * New upstream release. + * Update debian/watch: + - Support lowercase file name of the tarball. + - Stop validating signature, PyPI no longer supports them. + * Refresh patches for the new release. + * Add a patch to not hardcode expected JS/CSS checksums in tests. + * Backport upstream patch to avoid using builddir-based path as a default + value of a function argument (closes: #1025801). + + -- Dmitry Shachnev Sat, 29 Jul 2023 20:21:49 +0300 + +sphinx (7.0.1-1) experimental; urgency=medium + + * New upstream release. + * Drop patches: + - disable_js_version_check.diff (no longer needed) + - pygments_2.14.diff (included in the new release) + * Refresh and rebase other patches. + * Bump required versions: docutils to 0.18.1, requests to 2.25. + * Update debian/copyright. + * Remove references to no longer shipped jquery.js and underscore.js. + * Depend on python3-filelock for tests. + * Mark python3-html5lib and python3-pytest build-deps as . + * dh_sphinxdoc: Generate direct dependencies on libjs-jquery and + libjs-underscore for packages shipping jquery.js or underscore.js. + * debian/jstest: + - Switch from jQuery to native JavaScript API. + - Update numbers for the new release. + - Port from WebKitGTK to Qt WebEngine. This will allow us to run tests + on Debian infrastructure again, as Qt WebEngine does not require + isolation-machine. + * Break old versions of sphinx-rtd-theme. + + -- Dmitry Shachnev Sun, 21 May 2023 19:14:25 +0300 + +sphinx (5.3.0-7) unstable; urgency=medium + + * Backport upstream patch to fix bad relative path generated by imgmath + (closes: #1043267). + * Disable sphinx-doc test on arm64 and armhf. + + -- Dmitry Shachnev Sat, 12 Aug 2023 00:33:27 +0300 + +sphinx (5.3.0-6) unstable; urgency=medium + + * Update highlight_search_terms.diff to highlight terms synchronously, + to make the jstest more stable. + * Limit sphinx-doc test to architectures where Qt WebEngine is available. + + -- Dmitry Shachnev Sat, 05 Aug 2023 18:43:13 +0300 + +sphinx (5.3.0-5) unstable; urgency=medium + + * Add a patch to make test_build_manpage pass with docutils 0.19+dfsg-7. + * debian/jstest: Port from WebKitGTK to Qt WebEngine. This will allow us + to run tests on Debian infrastructure again, as Qt WebEngine does not + require isolation-machine. + + -- Dmitry Shachnev Sat, 05 Aug 2023 00:07:27 +0300 + +sphinx (5.3.0-4) unstable; urgency=medium + + [ Dmitry Shachnev ] + * Update highlight_search_terms.diff to fix race condition affecting jstest: + - Highlight all occurrences, not just the first one. + - Stop using the old search query from localstorage. + * Port jstest to the new API from webkit2gtk 2.40 (closes: #1033635, + LP: #2013095). + + [ Jeremy Bicha ] + * Set isolation-machine for sphinx-doc autopkgtest. This is needed for web + process sandbox, which is now mandatory. + * debian/tests/sphinx-doc: Set export GTK_A11Y=none. + + -- Dmitry Shachnev Wed, 29 Mar 2023 11:31:27 +0300 + +sphinx (5.3.0-3) unstable; urgency=medium + + * Backport upstream patch to update tests for Pygments 2.14 + (closes: #1028621). + * Bump Standards-Version to 4.6.2, no changes needed. + + -- Dmitry Shachnev Sat, 14 Jan 2023 14:04:03 +0400 + +sphinx (5.3.0-2) unstable; urgency=medium + + * Build with pybuild-plugin-pyproject (closes: #1025398). + * Upload to unstable. + + -- Dmitry Shachnev Mon, 05 Dec 2022 21:41:01 +0300 + +sphinx (5.3.0-1) experimental; urgency=medium + + * New upstream release. + * Rebase patches for the new release. + * Build-depend on flit. + * Let flit install scripts to /usr/bin and reverse symlinks. + * Update debian/dh-sphinxdoc/index. + * Remove sphinx/locale/.tx directory from python3-sphinx. + * Add a patch to highlight all search terms on search results page. + * Update numbers in debian/jstest/run-tests. + * Port jstest to GTK 4. + + -- Dmitry Shachnev Tue, 25 Oct 2022 17:29:19 +0300 + +sphinx (5.1.1-1) experimental; urgency=medium + + * New upstream release. + + -- Dmitry Shachnev Sat, 30 Jul 2022 10:45:51 +0300 + +sphinx (5.1.0-1) experimental; urgency=medium + + * New upstream release. + * Remove python3-importlib-metadata dependency again. + No longer needed because Debian dropped support for Python 3.9. + * Drop no_external_image.diff, indexsidebar.html has been removed. + * Refresh other patches. + * Update debian/source/lintian-overrides for Lintian pointed hints. + * Remove copyright section for no longer shipped porter.py. + * Update numbers in debian/jstest/run-tests. + * Bump python3-sphinx-tabs broken version to << 3.4.0. + * Add Adam Turner's key to debian/upstream/signing-key.asc. + + -- Dmitry Shachnev Sun, 24 Jul 2022 18:35:01 +0300 + +sphinx (5.0.2-1) experimental; urgency=medium + + * New upstream release. + * Refresh patches for the new release. + - Drop definfoenclose.diff, included in the new release. + * Use utils/babel_runner.py for compiling the translation files. + * Update debian/dh-sphinxdoc/index for the new version: + - Add _sphinx_javascript_frameworks_compat.js. + - Bump min-version to 5.0 for JS files that changed significantly. + * Parse the whole Search.setIndex argument as JSON. + * Add Sphinx.egg-info/entry_points.txt to debian/clean. + * Run JS tests with a real GTK window. Searchtools.js relies on setTimeout + to load every new search result, and WebKitGTK sets timeout to 1 second + after 5th request when the page is invisible. We have many search results, + so we get a timeout error unless we make it visible. + * Update numbers in debian/jstest/run-tests. + * Update debian/copyright. + * Bump Standards-Version to 4.6.1, no changes needed. + + -- Dmitry Shachnev Thu, 16 Jun 2022 20:56:55 +0300 + +sphinx (4.5.0-4) unstable; urgency=medium + + [ Dmitry Shachnev ] + * Backport upstream patch to stop using @definfoenclose texinfo command + (closes: #996151). + * Update jstest to use WebKit2 4.1. + + [ Simon Chopin ] + * Use full JSON unescaping in file names + + -- Dmitry Shachnev Thu, 16 Jun 2022 19:37:25 +0300 + +sphinx (4.5.0-3) unstable; urgency=medium + + * Hotfix: move python3-importlib-metadata from Suggests to Depends. + + -- Dmitry Shachnev Fri, 15 Apr 2022 19:31:16 +0300 + +sphinx (4.5.0-2) unstable; urgency=medium + + * Depend on python3-importlib-metadata, needed because we still support + Python 3.9 (closes: #1009382, #1009434, #1009445). + + -- Dmitry Shachnev Fri, 15 Apr 2022 14:21:33 +0300 + +sphinx (4.5.0-1) unstable; urgency=medium + + * New upstream release. + * Refresh patches for the new release. + * dh_sphinxdoc: Unescape unicode in file names (closes: #1008504). + * Upload to unstable. + + -- Dmitry Shachnev Sat, 02 Apr 2022 16:32:51 +0300 + +sphinx (4.4.0-1) experimental; urgency=medium + + * New upstream release. + * Remove debian/py3dist-overrides. Sphinx no longer uses pkg_resources. + * Amend intersphinx_local.diff to remove cross-references to ReadTheDocs. + * Refresh other patches. + * Update numbers in debian/jstest/run-tests. + * Add python3-setuptools to tests dependencies. + * Bump upstream copyright years in debian/copyright. + + -- Dmitry Shachnev Tue, 18 Jan 2022 14:17:46 +0300 + +sphinx (4.3.2-1) unstable; urgency=medium + + * New upstream release. + + -- Dmitry Shachnev Sun, 19 Dec 2021 15:55:13 +0300 + +sphinx (4.3.1-2) unstable; urgency=medium + + * dh_sphinxdoc: + - Stop taking Python 2 version of alabaster into account. + - Generate dependency on libjs-sphinxdoc ≥ 4.3 for searchtools.js. + - Loosen regex to detect searchindex.js loading (closes: #1001521). + * Add a patch to make searchtools.js support pre-4.3 search indexes + (closes: #1001509). + * Add Sphinx.egg-info/requires.txt and .mo files to debian/clean. + + -- Dmitry Shachnev Sun, 12 Dec 2021 21:44:32 +0300 + +sphinx (4.3.1-1) unstable; urgency=medium + + * New upstream release. + * Drop reproducible_restify.diff, applied in the new release. + * Refresh debian/patches/skip_tests_jsmath.diff. + * Update numbers in debian/jstest/run-tests. + + -- Dmitry Shachnev Sat, 27 Nov 2021 19:22:23 +0300 + +sphinx (4.2.0-5) unstable; urgency=medium + + * Remove Built-Using field from sphinx-doc. We do not incorporate any parts + of other source packages during sphinx-doc build. + * Run wrap-and-sort. + * Add a patch to make util.typing.restify sanitize unreproducible output + (closes: #996948). Thanks Chris Lamb! + * Update debian/source/lintian-overrides for Lintian 2.109. + + -- Dmitry Shachnev Sat, 23 Oct 2021 14:21:42 +0300 + +sphinx (4.2.0-4) unstable; urgency=medium + + * Team upload. + * Add new breaks on sphinx-tabs << 3.2.0 + + -- Michael R. Crusoe Sun, 10 Oct 2021 13:20:27 +0200 + +sphinx (4.2.0-3) unstable; urgency=medium + + * Team upload. + * Add new breaks on nbsphinx << 0.8.7 + * d/control: make use of ${perl:Depends} in sphinx-common and + ${sphinxdoc:Built-Using} in sphinx-doc + * Add salsa-ci file (routine-update) + + -- Michael R. Crusoe Sat, 09 Oct 2021 09:21:02 +0200 + +sphinx (4.2.0-2) unstable; urgency=medium + + * Upload to unstable (closes: #994114). + + -- Dmitry Shachnev Sat, 25 Sep 2021 21:33:30 +0300 + +sphinx (4.2.0-1) experimental; urgency=medium + + * New upstream release. + * Refresh debian/patches/remove_contrib_references.diff. + * Update numbers in debian/jstest/run-tests for the new release. + * Bump Standards-Version to 4.6.0, no changes needed. + + -- Dmitry Shachnev Sun, 12 Sep 2021 15:43:21 +0300 + +sphinx (4.1.2-1) experimental; urgency=medium + + * New upstream release. + * Refresh debian/patches/skip_tests_network.diff. + + -- Dmitry Shachnev Tue, 27 Jul 2021 20:24:27 +0300 + +sphinx (4.1.1-1) experimental; urgency=medium + + * New upstream release. + * Refresh patches for the new release. + * debian/jstest/run-tests: Update number of highlights for “examples”. + * Break python3-sphinxcontrib.serializinghtml < 1.1.5. + + -- Dmitry Shachnev Thu, 15 Jul 2021 13:59:17 +0300 + +sphinx (4.0.3-1) experimental; urgency=medium + + * New upstream release. + * dh_sphinxdoc: Use the last definition of DOCUMENTATION_OPTIONS, if + there are several of them. + * Refresh move_sphinxcontrib_to_extras_require.diff. + + -- Dmitry Shachnev Sat, 10 Jul 2021 13:35:22 +0300 + +sphinx (4.0.2-1) experimental; urgency=medium + + * New upstream release. + * Refresh move_sphinxcontrib_to_extras_require.diff. + * Revert the old build path in debian/sphinx-common.manpages. + + -- Dmitry Shachnev Fri, 21 May 2021 20:15:43 +0300 + +sphinx (4.0.1-1) experimental; urgency=medium + + * New upstream release. + * Refresh patches for the new release. + * Bump required python3-docutils version to 0.14. + * Add tex-gyre to Build-Depends, Suggests and autopkgtest dependencies. + * Update debian/sphinx-common.manpages for the new build path. + * Update numbers in debian/jstest/run-tests for the new release. + + -- Dmitry Shachnev Mon, 10 May 2021 21:35:39 +0300 + +sphinx (3.5.4-2) unstable; urgency=medium + + * dh_sphinxdoc: Use the last definition of DOCUMENTATION_OPTIONS, if + there are several of them. + * Upload to unstable. + + -- Dmitry Shachnev Sat, 21 Aug 2021 22:05:35 +0300 + +sphinx (3.5.4-1) experimental; urgency=medium + + * New upstream release. + * Refresh patches for the new release. + + -- Dmitry Shachnev Tue, 13 Apr 2021 15:16:49 +0300 + +sphinx (3.5.3-1) experimental; urgency=medium + + * New upstream release. + * Merge 3.4.3-2 upload from unstable. + + -- Dmitry Shachnev Sat, 20 Mar 2021 21:17:18 +0300 + +sphinx (3.5.2-1) experimental; urgency=medium + + * New upstream release. + + -- Dmitry Shachnev Sat, 06 Mar 2021 20:10:53 +0300 + +sphinx (3.5.1-2) experimental; urgency=medium + + * Move the minified stemmer JS files to the correct location. + * Document the license of stemmer JS files in debian/copyright. + + -- Dmitry Shachnev Tue, 23 Feb 2021 20:08:47 +0300 + +sphinx (3.5.1-1) experimental; urgency=medium + + * New upstream release. + * Refresh patches for the new release. + * Override Lintian source-is-missing warnings about stemmer JS files. + * Add debian/upstream/metadata file. + + -- Dmitry Shachnev Tue, 16 Feb 2021 20:11:51 +0300 + +sphinx (3.4.3-2) unstable; urgency=medium + + * dh_sphinxdoc: Fix the script tag regex used in singlehtml detection + (closes: #983858). + + -- Dmitry Shachnev Mon, 08 Mar 2021 21:40:25 +0300 + +sphinx (3.4.3-1) unstable; urgency=medium + + * New upstream release. + + -- Dmitry Shachnev Fri, 08 Jan 2021 20:11:19 +0300 + +sphinx (3.4.2-1) unstable; urgency=medium + + * New upstream release. + * Bump upstream copyright years in debian/copyright. + * Update debian/watch to version 4. + + -- Dmitry Shachnev Mon, 04 Jan 2021 20:17:45 +0300 + +sphinx (3.4.1-1) unstable; urgency=medium + + * New upstream release. + * Update debian/copyright. + * Upload to unstable. + + -- Dmitry Shachnev Sat, 26 Dec 2020 11:47:43 +0300 + +sphinx (3.4.0-1) experimental; urgency=medium + + * New upstream release. + * Rebase patches for the new release. + * Use packaged inventory from python-requests-doc. + * Stop exporting http_proxy for the python3-sphinx autopkgtest. + It breaks linkcheck tests which start a local HTTP server thread. + - Do not skip test_raises_for_invalid_status anymore. + - Skip test_build_sphinx_return_nonzero_status. It fails if trying to + access localhost.unexistentdomain results in 503 Server Error from + the proxy server. + * Bump Standards-Version to 4.5.1, no changes needed. + + -- Dmitry Shachnev Tue, 22 Dec 2020 15:16:26 +0300 + +sphinx (3.3.1-1) unstable; urgency=medium + + * New upstream release. + * Drop pygments_2.7.diff, included in the new release. + * Refresh other patches. + * Remove python3-sphinx.lintian-overrides, not needed with Lintian 2.92. + * Add test_raises_for_invalid_status to skip_tests_network.diff. + * Replace no_require_setuptools.diff with a debian/py3dist-overrides file. + That is a more compact way to specify that we do not need setuptools. + + -- Dmitry Shachnev Thu, 12 Nov 2020 20:05:30 +0300 + +sphinx (3.2.1-2) unstable; urgency=medium + + [ Dmitry Shachnev ] + * Drop no_snowballstemmer.diff and use python3-snowballstemmer as + upstream does, now that it is properly packaged. + * Backport upstream commit to make the tests pass with Pygments 2.7. + + [ Ondřej Nový ] + * d/control: Update Maintainer field with new Debian Python Team + contact address. + * d/control: Update Vcs-* fields with new Debian Python Team Salsa + layout. + + -- Dmitry Shachnev Sat, 10 Oct 2020 20:13:16 +0300 + +sphinx (3.2.1-1) unstable; urgency=medium + + * New upstream release. + - Fixes crashes when documenting extension modules (closes: #966983). + + -- Dmitry Shachnev Fri, 14 Aug 2020 14:06:07 +0300 + +sphinx (3.2.0-1) unstable; urgency=medium + + [ Debian Janitor ] + * Set field Upstream-Name in debian/copyright. + * Fix day-of-week for changelog entry 0.6.1-1. + + [ Dmitry Shachnev ] + * Merge 2.4.3-5 upload from unstable. + * Make dh_sphinxdoc generate stricter dependencies on libjs-sphinxdoc. + * New upstream release. + * Refresh patches for the new release. + * Update numbers in debian/jstest/run-tests for the new release. + * Remove python3-typed-ast from Build-Depends and tests dependencies, + now that we no longer need to test with Python 3.7. + * Upload to unstable. + + -- Dmitry Shachnev Sun, 09 Aug 2020 14:41:55 +0300 + +sphinx (3.1.2-1) experimental; urgency=medium + + * Bump python3-breathe Breaks to 4.15 (closes: #963653). + * New upstream release. + + -- Dmitry Shachnev Mon, 06 Jul 2020 21:57:28 +0300 + +sphinx (3.1.1-1) experimental; urgency=medium + + * New upstream release. + + -- Dmitry Shachnev Sun, 21 Jun 2020 14:26:39 +0300 + +sphinx (3.1.0-1) experimental; urgency=medium + + * New upstream release. + * Refresh patches for the new release. + * Specify Rules-Requires-Root: no. + + -- Dmitry Shachnev Tue, 09 Jun 2020 20:27:18 +0300 + +sphinx (3.0.4-1) experimental; urgency=medium + + * New upstream release. + * Drop patches, included in the new release: + - html5_docs.diff + - no_evaluate_debug.diff + - no_debug.diff + - autodoc_skip_mocked.diff + * Refresh and rebase other patches. + * Update numbers in debian/jstest/run-tests for the new release. + * Update the package description. + - Recommend build-depending on the new sphinx virtual package. + * Add a patch to use packaged intersphinx inventory for Python API. + - Also make sphinx-doc depend on python3-doc. + * Update to debhelper compat level 13. + * Stop excluding test_websupport.py which no longer exists. + + -- Dmitry Shachnev Tue, 02 Jun 2020 13:08:36 +0300 + +sphinx (2.4.3-5) unstable; urgency=medium + + * dh_sphinxdoc improvements: + - Make defer attribute of searchindex.js optional (closes: #966979). + - Allow for trailing whitespace in script src attribute, it is allowed + by the HTML specification. + - Add support for symlinking language_data.js for English (see #964013). + + -- Dmitry Shachnev Tue, 04 Aug 2020 21:52:28 +0300 + +sphinx (2.4.3-4) unstable; urgency=medium + + * Update autodoc_skip_mocked.diff to use safe_getattr instead of plain + getattr (based on upstream PR #7520). See #959558. + * Update the package description. + - Recommend build-depending on the new sphinx virtual package. + + -- Dmitry Shachnev Wed, 03 Jun 2020 11:32:20 +0300 + +sphinx (2.4.3-3) unstable; urgency=medium + + * Break python3-sphinx-celery < 2.0.0 (closes: #958985). + * Export http_proxy=http://127.0.0.1:9/ when running the autopkgtest. + * Make autodoc skip mocked objects (closes: #959558). + * Stop using alternatives, ship /usr/bin/sphinx-* symlinks directly. + * Make python3-sphinx provide sphinx virtual package (see #961206). + + -- Dmitry Shachnev Thu, 28 May 2020 11:51:15 +0300 + +sphinx (2.4.3-2) unstable; urgency=medium + + * Simplify debian/patches/html5_docs.diff for the new release. + * Break python3-breathe < 4.13 (closes: #955569). + * Backport two upstream patches to fix performance issues because of + debug calls. + * Clean up debian/clean, remove files no longer present upstream. + * Upload to unstable. + + -- Dmitry Shachnev Mon, 13 Apr 2020 16:07:18 +0300 + +sphinx (2.4.3-1) experimental; urgency=medium + + * New upstream release. + * Update to debhelper compat level 12. + + -- Dmitry Shachnev Wed, 26 Feb 2020 12:03:03 +0300 + +sphinx (2.4.1-1) experimental; urgency=medium + + [ Dmitry Shachnev ] + * New upstream release. + * Refresh patches for the new release. + * Depend on python3-typed-ast to make the tests pass with Python 3.7. + * dh_sphinxdoc: Add support for script tags without type="text/javascript". + * dh_sphinxdoc: Do not warn about sidebar.js file. + * Update numbers in debian/jstest/run-tests for the new release. + + [ Michael R. Crusoe ] + * Mark the -doc and -common binary packages as Multi-Arch: foreign. + + -- Dmitry Shachnev Mon, 17 Feb 2020 11:59:57 +0300 + +sphinx (2.3.1-1) experimental; urgency=medium + + [ Christoph Berg ] + * New upstream version 2.2.0. + * Remove obsolete patches: no_require_websupport.diff, + python2_test_get_module_source.diff, reproducible_download.diff, + docutils_0.15.diff, remove_websupport_assets.diff. + + [ Dmitry Shachnev ] + * New upstream version 2.3.1 (closes: #944913). + * Drop no_spaces_in_hyphenated_words.diff, applied in the new release. + * Drop debian/patches/python2_tests_import_hack.diff, this version of + Sphinx no longer supports Python 2. + * Refresh other patches. + * Drop Python 2 support from packaging. + * Update dependencies according to upstream setup.py: + - Bump required docutils version to 0.12. + - Bump required requests version to 2.5.0. + - Remove six from dependencies. + - Remove mock from tests dependencies. + * Patch out references to sphinxcontrib modules. + * Skip tests that require sphinxcontrib.jsmath module. + * Update dh_sphinxdoc for the new searchindex.js loading scheme. + * Use packaged MathJax for sphinx-doc. + * Build-Depend on and suggest fonts-freefont. The LaTeX writer now uses + this font for xelatex and lualatex. + * Update numbers in debian/jstest/run-tests for the new release. + * Skip tests that require sphinxcontrib.serializinghtml module (they were + run only during autopkgtest). + * Move sphinxcontrib modules to extras_require. + * Move python3-lib2to3 from Depends to Suggests. + * Update the Homepage field to use https. + * Bump Standards-Version to 4.5.0, no changes needed. + + -- Dmitry Shachnev Fri, 07 Feb 2020 14:15:40 +0300 + +sphinx (1.8.5-9) unstable; urgency=medium + + * Drop two python2 patches, no longer needed. + * jstest: Enable writing console messages to stdout. + * Make Sphinx' documentation use HTML 5 instead of XHTML, to fix WebKitGTK + parsing errors with shared-mime-info ≥ 0.11 (LP: #1871610). + + -- Dmitry Shachnev Thu, 09 Apr 2020 15:36:45 +0300 + +sphinx (1.8.5-8) unstable; urgency=medium + + * Drop Python 2 support; Closes: #938528 + + -- Sandro Tosi Fri, 27 Mar 2020 12:40:09 -0400 + +sphinx (1.8.5-7) unstable; urgency=medium + + * Make the autopkgtest depend on python3-all, and use py3versions -s + instead of -i. + * Update to debhelper compat level 12. + + -- Dmitry Shachnev Fri, 20 Mar 2020 14:33:53 +0300 + +sphinx (1.8.5-6) unstable; urgency=medium + + * Update dh_sphinxdoc for the new searchindex.js loading scheme + (closes: #953567). + * Bump Standards-Version to 4.5.0, no changes needed. + + -- Dmitry Shachnev Sat, 14 Mar 2020 12:11:42 +0300 + +sphinx (1.8.5-5) unstable; urgency=medium + + * Make sphinx-common provide dh-sequence-sphinxdoc (closes: #946899). + * Drop python-sphinxcontrib.websupport from autopkgtest dependencies, + to allow for its removal. + * Backport upstream patch to fix crashes with docutils 0.16. + + -- Dmitry Shachnev Sun, 12 Jan 2020 17:01:00 +0300 + +sphinx (1.8.5-4) unstable; urgency=medium + + * Remove extra underscore character from debian/sphinx-doc.doc-base. + * Run sphinx-doc autopkgtest on all architectures again (bug #931807 has + been fixed). + * Stop installing static files for websupport. These files are already + shipped by python[3]-sphinxcontrib.websupport, and there is no need to + have them in all -doc packages that do not use websupport. + * Backport upstream patch to fix spaces being added to hyphenated words + with text writer (closes: #944331). + * Add some generated files to debian/clean. + * Bump Standards-Version to 4.4.1, no changes needed. + + -- Dmitry Shachnev Thu, 05 Dec 2019 14:18:02 +0300 + +sphinx (1.8.5-3) unstable; urgency=medium + + [ Ondřej Nový ] + * Use debhelper-compat instead of debian/compat. + + [ Dmitry Shachnev ] + * Suggest texlive-plain-generic instead of texlive-generic-extra. + The latter package is no longer built, and iftex.sty is now shipped by + the former package. + * Backport upstream patch to fix test failure with docutils 0.15. + + -- Dmitry Shachnev Fri, 16 Aug 2019 22:08:42 +0300 + +sphinx (1.8.5-2) unstable; urgency=medium + + * Update debian/.gitlab-ci.yml to use salsa-pipeline. + * Add a patch to make generated download links reproducible. + * Skip sphinx-doc autopkgtest on ppc64el and s390x (because of #931807). + Based on a change applied by Dimitri John Ledkov in Ubuntu. + * Bump Standards-Version to 4.4.0, no changes needed. + * Upload to unstable. + + -- Dmitry Shachnev Sun, 14 Jul 2019 17:40:25 +0300 + +sphinx (1.8.5-1) experimental; urgency=medium + + * New upstream release. + * Drop reproducible_graphviz.diff, a better fix was applied upstream. + * Refresh skip_tests_network.diff. + + -- Dmitry Shachnev Sun, 10 Mar 2019 18:40:56 +0300 + +sphinx (1.8.4-1) unstable; urgency=medium + + * New upstream release. + * Ensure the graphviz filenames are reproducible (closes: #921513). + * Bump year in debian/copyright. + + -- Dmitry Shachnev Sat, 16 Feb 2019 16:55:01 +0300 + +sphinx (1.8.3-2) unstable; urgency=medium + + * Bump Standards-Version to 4.3.0, no changes needed. + * Upload to unstable. + + -- Dmitry Shachnev Sat, 26 Jan 2019 12:42:25 +0300 + +sphinx (1.8.3-1) experimental; urgency=medium + + * New upstream release. + * Drop language_data.js.diff, applied upstream. + * Refresh skip_tests_network.diff. + * Add a patch to make test_get_module_source() pass on Python 2. + + -- Dmitry Shachnev Wed, 09 Jan 2019 19:36:31 +0300 + +sphinx (1.8.2-1) experimental; urgency=medium + + * New upstream release. + * Drop mathjax_on_demand.diff, applied upstream. + * Backport upstream patch to make search work with custom templates, by + moving language data into a separate JS file (language_data.js.diff). + * Adapt dh_sphinxdoc for the introduction of language_data.js. + * Override Lintian false positive warning about todo.py extension. + + -- Dmitry Shachnev Sun, 11 Nov 2018 14:53:05 +0300 + +sphinx (1.8.1-1) experimental; urgency=medium + + * New upstream release. + * Drop patches, applied upstream: + - 0005-Fix-testsuite-to-not-rely-on-return-types.patch + - 0007-Fix-spelling-error-in-manpage.patch + - 0008-Call-object_description-recursively-for-dict-keys-an.patch + - 0009-Ensure-the-set-object-description-is-reproducible.patch + * Refresh and rebase the other patches. + * Drop numbers from the remaining patches, use consistent naming. + * Do not copy .doctrees/ during docs build, it is now in source tree. + * Make test_math_compat pass with Python 2, by adding sphinx.ext.mathbase + toplevel import (python2_tests_import_hack.diff). + * Add a patch to load MathJax.js only on demand (mathjax_on_demand.diff). + * Update debian/clean to clean .doctrees, .pytest_cache and tests/build. + * dh_sphinxdoc: + - Remove mention of “non-English searchtools.js”, all language-specific + stuff is now in documentation_options.js. + - Warn about missing SEARCH_LANGUAGE_STOP_WORDS. + * Update numbers in debian/jstest/run-tests for the new release. + * Remove obsolete section from debian/copyright. + + -- Dmitry Shachnev Mon, 29 Oct 2018 16:41:33 +0300 + +sphinx (1.7.9-1) unstable; urgency=medium + + * New upstream bugfix release. + * Drop 0012-Make-generated-texinfo-files-reproducible-by-sorting.patch, + applied upstream. + + -- Dmitry Shachnev Thu, 06 Sep 2018 13:11:38 +0300 + +sphinx (1.7.8-1) unstable; urgency=medium + + * New upstream bugfix release. + * Refresh 0009-Ensure-the-set-object-description-is-reproducible.patch. + * Make generated texinfo files reproducible (closes: #907352). + * Bump Standards-Version to 4.2.1, no changes needed. + + -- Dmitry Shachnev Fri, 31 Aug 2018 14:31:03 +0300 + +sphinx (1.7.7-1) unstable; urgency=medium + + * New upstream bugfix release. + * Refresh patches for the new release. + * Directly use PyStemmer for non-English search (without the wrapper). + * Bump Standards-Version to 4.2.0. + * Pass --verbose to pytest, as now required by Policy §4.9. + + -- Dmitry Shachnev Sat, 25 Aug 2018 11:14:54 +0300 + +sphinx (1.7.6-1) unstable; urgency=medium + + * New upstream bugfix release. + * Drop patches, applied upstream: + - 0011-Fix-5022-latex-crashed-with-docutils-package-provide.patch + - 0012-Fix-5048-crashed-with-numbered-toctree.patch + * Refresh other patches. + * Run “wrap-and-sort”. + * Recommend make (closes: #903260). + * Add back PYTHONWARNINGS=d, the pytest warnings have been fixed. + * Add a patch to remove use of external image from img.shields.io in + the documentation template. + * Bump Standards-Version to 4.1.5, no changes needed. + * Rely on dh_python{2,3} for generating most of package dependencies. + + -- Dmitry Shachnev Sun, 08 Jul 2018 16:22:44 +0300 + +sphinx (1.7.5-6) unstable; urgency=medium + + * Export LC_ALL=C.UTF-8 to make the build pass on the buildds. + + -- Dmitry Shachnev Thu, 05 Jul 2018 14:26:07 +0300 + +sphinx (1.7.5-5) unstable; urgency=medium + + * dh_sphinxdoc: Generate versioned dependencies on sphinx-rtd-theme-common. + * Switch to dh sequencer and pybuild buildsystem. + * Stop setting PYTHONWARNINGS=d. There are too many deprecation warnings + coming from pytest. + * Upload to unstable. + + -- Dmitry Shachnev Thu, 05 Jul 2018 13:00:27 +0300 + +sphinx (1.7.5-4) experimental; urgency=medium + + * Use the alternatives mechanism for managing scripts. + * Prefer Python 3 versions of the scripts (closes: #898009). + + -- Dmitry Shachnev Sat, 23 Jun 2018 00:45:15 +0300 + +sphinx (1.7.5-3) unstable; urgency=medium + + * Backport upstream patch to fix crash with numbered toctrees + (closes: #901769, thanks Robin Jarry for the bug report). + + -- Dmitry Shachnev Mon, 18 Jun 2018 15:28:44 +0300 + +sphinx (1.7.5-2) unstable; urgency=medium + + * dh_sphinxdoc: Fix for templates that do not use documentation_options.js + (closes: #901662, thanks Rebecca N. Palmer for the bug report). + + -- Dmitry Shachnev Sat, 16 Jun 2018 21:54:03 +0300 + +sphinx (1.7.5-1) unstable; urgency=medium + + [ Ondřej Nový ] + * d/control: Remove ancient X-Python-Version field + * d/control: Remove ancient X-Python3-Version field + + [ Dmitry Shachnev ] + * New upstream bugfix release. + * Backport upstream patch to support standalone roman module. + * dh_sphinxdoc: Support url_root in the new data-url_root attribute. + + -- Dmitry Shachnev Fri, 15 Jun 2018 17:45:33 +0300 + +sphinx (1.7.4-1) unstable; urgency=medium + + * New upstream bugfix release. + - Fixed crash with duplicated objects (closes: #896897). + + -- Dmitry Shachnev Wed, 25 Apr 2018 20:47:00 +0300 + +sphinx (1.7.3-1) unstable; urgency=medium + + * New upstream bugfix release. + * Refresh debian/patches/0003-skip_tests_network.diff. + * Set PYTHONPATH to $(CURDIR) when building our own documentation, + to make sure we are using the local version of Sphinx code. + + -- Dmitry Shachnev Mon, 23 Apr 2018 11:09:06 +0300 + +sphinx (1.7.2-4) unstable; urgency=medium + + [ Ondřej Nový ] + * d/tests: Use AUTOPKGTEST_TMP instead of ADTTMP + + [ Dmitry Shachnev ] + * Update autopkgtests to work with Sphinx 1.7 (closes: #895854). + + -- Dmitry Shachnev Wed, 18 Apr 2018 17:35:47 +0300 + +sphinx (1.7.2-3) unstable; urgency=medium + + * Remove setuptools from install_requires, it is not needed on Debian + (closes: #895738). + + -- Dmitry Shachnev Sun, 15 Apr 2018 21:43:18 +0300 + +sphinx (1.7.2-2) unstable; urgency=medium + + * Make python-sphinx depend on python-typing (closes: #895727). + + -- Dmitry Shachnev Sun, 15 Apr 2018 13:08:26 +0300 + +sphinx (1.7.2-1) unstable; urgency=medium + + [ Chris Lamb ] + * New upstream release. + * Pass -vv to pytest when running the testsuite. + * Patches: + - Apply patch series from https://github.com/sphinx-doc/sphinx/pull/4834 to + make the set output reproducible. (Closes: #895553) + - Don't use Google Fonts to avoid privacy breach. + - Fix "arbitary" spelling error in sphinx-quickstart(1) manpage. + - Fix testsuite to not rely on return types. + - Refresh and renumber all patches. + * Bump Standards-Version to 4.1.4. + * Add myself to Uploaders. + + [ Dmitry Shachnev ] + * Merge 1.6.7-2 upload from experimental to unstable. + + -- Chris Lamb Sat, 14 Apr 2018 19:32:39 +0100 + +sphinx (1.7.1-1) experimental; urgency=medium + + * New upstream release (closes: #890581). + - No longer bundles a copy of pgen2 (closes: #609485). + * Drop reproducible_epub.diff and text_section_numbering.diff, applied + in the new release. + * Refresh and rebase other patches. + * Build-depend and depend on python[3]-packaging. + * Update commands to build docs and run tests. + * All scripts are now setuptools entrypoints, update the code accordingly. + * Update debian/copyright. + * dh_sphinxdoc: Support standalone documentation_options.js files. + * Update numbers in debian/jstest/run-tests for the new release. + * Use upstream sphinx-autogen(1) manpage. + * Set PYTHONPATH to current directory when running the tests. + * Set PYTHONPATH when running the install-js script. + + -- Dmitry Shachnev Sun, 04 Mar 2018 12:20:20 +0300 + +sphinx (1.6.7-2) unstable; urgency=medium + + * Make python3-sphinx depend on python3-distutils (closes: #893620). + + -- Dmitry Shachnev Thu, 22 Mar 2018 18:07:32 +0300 + +sphinx (1.6.7-1) unstable; urgency=medium + + * New upstream bugfix release. + * Update Vcs fields for migration to salsa.debian.org. + * Update debhelper compat level to 11. + + -- Dmitry Shachnev Sun, 11 Feb 2018 22:08:38 +0300 + +sphinx (1.6.6-2) unstable; urgency=medium + + * Backport upstream patch to add optional section numbering in plain + text output (closes: #872868). + + -- Dmitry Shachnev Wed, 24 Jan 2018 21:51:28 +0300 + +sphinx (1.6.6-1) unstable; urgency=medium + + * New upstream release (closes: #881923). + * Drop reproducible_dicts.diff and reproducible_htmlhelp.diff, applied + in the new release. + * Refresh other patches. + * Remove trailing whitespace from debian/control and debian/rules. + * Rewrite debian/copyright using the machine-readable format 1.0. + * Bump Standards-Version to 4.1.3, no changes needed. + + -- Dmitry Shachnev Thu, 11 Jan 2018 16:07:07 +0300 + +sphinx (1.6.5-4) unstable; urgency=medium + + * Change python3.6-2to3 dependencies to python3-lib2to3. + * Backport upstream reproducibility fix for htmlhelp and qthelp builders + (reproducible_htmlhelp.diff; closes: #884010). + + -- Dmitry Shachnev Thu, 28 Dec 2017 14:04:30 +0300 + +sphinx (1.6.5-3) unstable; urgency=medium + + * Make python3-sphinx depend on python3.6-2to3, where lib2to3 is shipped + since python3.6 3.6.4~rc1-2. It will be replaced with a more generic + dependency later. + * Also build-depend on python3.6-2to3, to make the tests pass. + * Bump Standards-Version to 4.1.2, no changes needed. + + -- Dmitry Shachnev Fri, 15 Dec 2017 17:03:53 +0300 + +sphinx (1.6.5-2) unstable; urgency=medium + + * Backport two upstream patches to improve builds reproducibility: + - reproducible_dicts.diff to sort dictionary keys (closes: #877637). + - reproducible_epub.diff to make EPUB generation reproducible. + + -- Dmitry Shachnev Sun, 29 Oct 2017 19:12:40 +0300 + +sphinx (1.6.5-1) unstable; urgency=medium + + * New upstream release. + * Drop cpp_no_assert and sourcelink_suffix_fallback.diff, applied in the + new release. + * dh_sphinxdoc: In singlehtml check, consider only HTML files that use + doctools.js (closes: #872863). + + -- Dmitry Shachnev Mon, 23 Oct 2017 12:21:59 +0300 + +sphinx (1.6.4-2) unstable; urgency=medium + + * Add a note that dh_sphinxdoc does not actually build the documentation + to its manpage. + * Backport upstream patch to fix wrong AssertionError in C++ domain + (cpp_no_assert.diff; closes: #877014). + * Backport upstream patch to make searchtools.js work with pre-Sphinx 1.5 + templates (sourcelink_suffix_fallback.diff). + * Update dh_sphinxdoc for the above change: there is no more need to error + about missing SOURCELINK_SUFFIX. + * Bump Standards-Version to 4.1.1, no changes needed. + + -- Dmitry Shachnev Wed, 04 Oct 2017 11:53:44 +0700 + +sphinx (1.6.4-1) unstable; urgency=medium + + * New upstream release. + - Fixes incorrect return status in sphinx-build (closes: #876048). + * Drop upstream_fix_crash_on_parallel_build.diff, applied upstream. + * dh_sphinxdoc: Turn warning about missing SOURCELINK_SUFFIX to an error. + * Change sphinx-common trigger from interest to interest-noawait. + * Bump Standards-Version to 4.1.0, no changes needed. + * Use pkg-info.mk to retrieve the upstream version number. + * Use python3 to build our own documentation. + * Add support for nodoc build profile. + * Add python3-sphinxcontrib.websupport to build-dependencies for docs. + + -- Dmitry Shachnev Tue, 26 Sep 2017 17:47:54 +0300 + +sphinx (1.6.3-2) unstable; urgency=medium + + * Move sphinxcontrib-websupport from requirements to extras_require + in setuptools metadata (no_require_websupport.diff). + * Backport upstream patch to fix crash with new python2.7 + (upstream_fix_crash_on_parallel_build.diff; closes: #869098). + * dh_sphinxdoc: Add support for singlehtml builds (closes: #872863). + * Upload to unstable. + + -- Dmitry Shachnev Sun, 17 Sep 2017 20:52:27 +0300 + +sphinx (1.6.3-1) experimental; urgency=medium + + * New upstream release (closes: #866789). + * Update dependencies for the new release. + - Drop python[3]-whoosh and python[3]-sqlalchemy build-dependencies. + They were only needed for websupport tests, now skipped (see below). + - Add build-dependency on python-typing (Python 2 only). + - Add suggestion on latexmk, it is now used for LaTeX builds. + - Add build-dependency and suggestion on imagemagick-6.q16 and + librsvg2-bin, needed for imgconverter extension. + * Update autopkgtest dependencies. + - Add python[3]-sphinxcontrib.websupport. + - Add python[3]-sqlalchemy. + * Disable one more test that needs network in skip_tests_network.diff. + * Move libjs-sphinxdoc package to javascript section. + * Update numbers in debian/jstest/run-tests for the new release. + * Update debian/copyright from upstream LICENSE and AUTHORS files. + * Skip running websupport tests during build, to avoid build-dependency + loop with sphinxcontrib-websupport. + * Remove useless FIXME comment from debian/rules. + * Do not run tests with --verbose flag during build, to make the output + easier to read. + * Document the new --imported-members option in sphinx-autogen manpage. + + -- Dmitry Shachnev Sun, 06 Aug 2017 15:13:24 +0300 + +sphinx (1.5.6-2) unstable; urgency=medium + + * Drop Patch-Name headers, not needed with gbp-pq. + * Bump Standards-Version to 4.0.0, no changes needed. + * Upload to unstable. + + -- Dmitry Shachnev Sun, 09 Jul 2017 12:05:28 +0300 + +sphinx (1.5.6-1) experimental; urgency=medium + + * New upstream bugfix release. + * Update jstests for compatibility with WebKitGTK+ 2.16.2. + Now the title property can be no longer than 1000 characters, so we + cannot fetch the whole page using it. Instead, we compute the needed + numbers with JavaScript and then fetch them using the title property. + * Update debian/copyright for upstream LICENSE change. + + -- Dmitry Shachnev Mon, 15 May 2017 11:31:42 +0300 + +sphinx (1.5.5-1) experimental; urgency=medium + + * New upstream release. + * dh_sphinxdoc: Use a better message for missing sourcelink_suffix, and + downgrade this error to a warning. + * Clean some files which erroneously got into the upstream tarball. + * Sync debian/copyright with upstream AUTHORS file. + + -- Dmitry Shachnev Thu, 06 Apr 2017 23:27:29 +0300 + +sphinx (1.5.3-1) experimental; urgency=medium + + * New upstream release. + * Build-depend on texlive-luatex, to make xetex tests not be skipped. + * Convert from git-dpm to patches unapplied format. + + -- Dmitry Shachnev Wed, 15 Mar 2017 12:37:21 +0300 + +sphinx (1.5.2-2) experimental; urgency=medium + + * dh_sphinxdoc: Properly detect sourcelink_suffix and use it when looking + for source and HTML files. + + -- Dmitry Shachnev Tue, 24 Jan 2017 12:42:06 +0300 + +sphinx (1.5.2-1) experimental; urgency=medium + + * New upstream release. + - Drop fix_xapian_search.diff, applied upstream. + - Rebase other patches for test system changes to pytest. + * Bump python[3]-requests dependency to 2.4.0. + * Switch from nose to pytest, following upstream. + * Update one number in debian/jstest/run-tests for the new release. + + -- Dmitry Shachnev Sun, 22 Jan 2017 19:45:18 +0300 + +sphinx (1.5.1-1) experimental; urgency=medium + + * New upstream release. + * Drop docutils_0.13.diff, applied upstream. + * Rebase other patches. + * Bump X-Python-Version to 2.7 and X-Python3-Version to 3.4, following + upstream. + * Depend on python[3]-requests and build-depend on python[3]-html5lib. + * Build-depend and recommend python-enum34 (for autodoc extension). + * Drop texlive-generic-extra dependency, iftex is no longer used. + * Stop unbundling fncychap.sty (no longer bundled), iftex.sty and + newfloat.sty (no longer used). + * Skip test_meta_keys_are_handled_for_language_de, fails without snowball. + * Backport upstream change to fix Xapian search adapter crashes + (fix_xapian_search.diff). + * Skip tests that require internet access (skip_tests_network.diff). + * Update dh_sphinxdoc for upstream changes to document extensions. + * Update numbers in debian/jstest/run-tests for the new release. + * Move the new templates directory to sphinx-common package. + * Move the non-minified JS files to sphinx-common package. + * Add allow-stderr restriction for the sphinx-doc autopkgtest. + * Clean and do not install the sphinx/locale/.tx/config file. + + -- Dmitry Shachnev Fri, 23 Dec 2016 11:34:31 +0300 + +sphinx (1.4.9-2) unstable; urgency=medium + + * Backport upstream patch to add compatibility with docutils 0.13 + (docutils_0.13.diff). + + -- Dmitry Shachnev Sun, 11 Dec 2016 11:42:43 +0300 + +sphinx (1.4.9-1) unstable; urgency=medium + + * New upstream bugfix release (closes: #846149). + * Drop fix_autodoc_new_python.diff, applied upstream. + * Remove unwanted file sphinx/locale/.DS_Store in clean target. + + -- Dmitry Shachnev Tue, 29 Nov 2016 13:37:31 +0300 + +sphinx (1.4.8-2) unstable; urgency=medium + + * Relax the check in dh_sphinxdoc to allow different locations of + searchindex.js file (closes: #841141). + * Sort $(scripts) variable in Makefile, to fix a reproducibility issue. + * Backport upstream patch to fix autodoc failures with new Python 3.5 + and Python 3.6 snapshots (fix_autodoc_new_python.diff). Fixes FTBFS. + * Drop build-dependencies on python[3]-xapian (closes: #842903). + * Add more tests dependencies to the autopkgtests. + * Update dh_sphinxdoc manpage for the latest changes (closes: #836248). + + -- Dmitry Shachnev Thu, 17 Nov 2016 21:10:30 +0300 + +sphinx (1.4.8-1) unstable; urgency=medium + + * New upstream bugfix release. + * Stop running jstest during build (but still run it in the autopkgtest). + * Update debian/watch to track only stable versions. + * Make dh_sphinxdoc generate ${sphinxdoc:Built-Using} substvar (closes: + #836248). + * Call dh_strip_nondeterminism during build. + * Build-depend on python3-xapian again, now it is in unstable. + + -- Dmitry Shachnev Mon, 03 Oct 2016 17:24:50 +0300 + +sphinx (1.4.6-1) unstable; urgency=medium + + * New upstream bugfix release (closes: #835026). + * Bump python[3]-six dependency to 1.5, following upstream. + * dh_sphinxdoc: Include the list of packages in the error message about + documentation not found (closes: #833799). + + -- Dmitry Shachnev Wed, 24 Aug 2016 21:04:54 +0300 + +sphinx (1.4.5-1) unstable; urgency=medium + + * New upstream bugfix release. + * Drop upstream patches: + - fix_ltz_utcoffset.diff + - latex_code_robust.diff + + -- Dmitry Shachnev Wed, 13 Jul 2016 22:56:54 +0300 + +sphinx (1.4.4-3) unstable; urgency=medium + + * Backport upstream patch (latex_code_robust.diff) to fix the \code + command in generated LaTeX files (closes: #829118). + + -- Dmitry Shachnev Fri, 01 Jul 2016 20:59:46 +0300 + +sphinx (1.4.4-2) unstable; urgency=medium + + * Update Python 2 autopkgtest to not run tests that require Python 3. + * Add a patch to fix return type of LocalTimeZone.utcoffset when + SOURCE_DATE_EPOCH is set (fix_ltz_utcoffset.diff). + + -- Dmitry Shachnev Tue, 21 Jun 2016 17:33:28 +0300 + +sphinx (1.4.4-1) unstable; urgency=medium + + * New upstream bugfix release. + - Autodoc now removes all memory addresses (closes: #822197). + * Drop python3-xapian build-dependency for unstable upload: it is not + yet available in unstable. + * Build-depend on graphviz so that the corresponding tests are not + skipped. + * Do not install the bundled TeX files from texinput directory: + - fncychap.sty (available in texlive-latex-extra) + - iftex.sty (available in texlive-generic-extra) + - needspace.sty (available in texlive-latex-extra) + - newfloat.sty (available in texlive-latex-recommended) + * Suggest texlive-generic-extra instead (the other packages are already in + the Suggests list). + * Upload to unstable. + + -- Dmitry Shachnev Fri, 17 Jun 2016 18:42:56 +0300 + +sphinx (1.4.3-1) experimental; urgency=medium + + * New upstream bugfix release. + * Drop the following patches, applied upstream: + - 0004-Extend-SOURCE_DATE_EPOCH-support.patch + - 0005-Adapt-to-typing-private-API-change-in-Python-3.5.2.patch + - 0006-Make-custom-compile_catalog-command-work-with-Babel-.patch + - 0007-Load-compatibility-patch-for-LuaTeX-0.85.patch + - 0008-Make-Xapian-search-work-with-Python-3.patch + * Add Takeshi KOMIYA’s signing key to debian/upstream/signing-key.asc. + * Bump version number in sphinx-autogen manpage. + * Build-depend on texlive-generic-extra (for iftex package). + + -- Dmitry Shachnev Mon, 06 Jun 2016 19:47:32 +0300 + +sphinx (1.4.1-2) experimental; urgency=medium + + * Add a patch to make Xapian search tests pass with Python 3. + + -- Dmitry Shachnev Thu, 26 May 2016 13:45:43 +0300 + +sphinx (1.4.1-1) experimental; urgency=medium + + * New upstream release (closes: #824375). + * Drop the following patches, applied upstream: + - disable_distribute_setup.diff + - source_date_epoch.diff + - reproducible_grammar.diff + - reproducible_inventory.diff + - reproducible_js_locale.diff + - reproducible_searchindex.diff + * Refresh and rebase other patches. + * Update debian/watch to correctly mangle upstream alpha releases. + * Demote sphinx-rtd-theme to Suggests, it has become optional. + * Add dependency on python[3]-imagesize packages. + * Bump Pygments build- and test dependencies to 2.1.1. + * Demote python-sphinx recommendation of sphinx-doc to a suggestion. + * Refactor the command to run tests to better match upstream. + * Build-depend on dvipng to get the pngmath test run. + * Update numbers in jstest/run-tests for the new version. + * Add a patch from Alexis Bienvenüe to extend SOURCE_DATE_EPOCH support + (closes: #820895). + * Add a patch to fix a typing-related test failure with Python 3.5.2. + * Update debian/copyright based on upstream LICENSE and AUTHORS files. + * Add a patch to make compile_catalog code work with python-babel 2.3. + * Add a patch to support LuaTeX 0.85. + * Build-depend on texlive-luatex for tests. + * Adapt dh-sphinxdoc/install-js for doctools.js changes. + * Update sphinx-autogen manpage. + * Bump Standards-Version to 3.9.8, no changes needed. + * Build-depend on python3-xapian (closes: #649488). + + -- Dmitry Shachnev Tue, 17 May 2016 18:57:02 +0300 + +sphinx (1.3.6-2) unstable; urgency=medium + + * Use implementation of jstest from Iain Lane in hope it succeeds on + buildds. + + -- Dmitry Shachnev Thu, 03 Mar 2016 20:17:15 +0300 + +sphinx (1.3.6-1) unstable; urgency=medium + + * New upstream bugfix release. + * Port jstest to WebKit2 (closes: #814909). + * Remove the now obsolete debian/TODO file. + * Update debian/source/lintian-overrides for new Lintian versions. + * Use https in Vcs-Git field. + * Bump Standards-Version to 3.9.7, no changes needed. + + -- Dmitry Shachnev Wed, 02 Mar 2016 10:24:30 +0300 + +sphinx (1.3.5-1) unstable; urgency=medium + + * New upstream bugfix release. + * Build-depend on Pygments 2.1, the testsuite now requires it. + + -- Dmitry Shachnev Tue, 26 Jan 2016 12:57:34 +0300 + +sphinx (1.3.4-1) unstable; urgency=medium + + * New upstream bugfix release. + * Clean and ignore auto-generated files. + * jstest.py: Add gi.require_version() calls to fix warnings from PyGI. + * Bump version number in sphinx-autogen manpage. + + -- Dmitry Shachnev Thu, 14 Jan 2016 19:01:44 +0300 + +sphinx (1.3.3-1) unstable; urgency=medium + + * New upstream bugfix release. + + -- Dmitry Shachnev Thu, 03 Dec 2015 18:35:09 +0300 + +sphinx (1.3.2-1) unstable; urgency=medium + + * New upstream release. + * Drop the following patches, applied upstream: + - py35compat.diff + - no_theme_rename_warning.diff + - addto_only_babel.diff + - print_help.diff + - compat_css.diff + * Refresh and rebase other patches. + * Stop exporting SOURCE_DATE_EPOCH in debian/rules. + Debhelper does it automatically since version 9.20151004. + * Update sphinx-autogen.1 man page. + + -- Dmitry Shachnev Mon, 30 Nov 2015 18:31:36 +0300 + +sphinx (1.3.1-8) unstable; urgency=medium + + * Do not fail on removing SOURCES.txt file when it does not exist. + Fixes build with dh-python ≥ 2.20151103. + + -- Dmitry Shachnev Sun, 08 Nov 2015 16:13:14 +0300 + +sphinx (1.3.1-7) unstable; urgency=medium + + * Make libjs-sphinxdoc depend on libjs-jquery ≥ 1.11.1 and libjs-underscore + ≥ 1.3.1, as these are the versions used by upstream. + * Fix command in autopkgtests to make them pass. + * Update Vcs fields for Git migration. + + -- Dmitry Shachnev Sun, 18 Oct 2015 18:38:38 +0300 + +sphinx (1.3.1-6) unstable; urgency=medium + + * Update reproducibility patches to the latest version from Val Lorentz: + - Update reproducible_grammar.diff. + - Make searchindex generation deterministic (reproducible_searchindex.diff). + + -- Dmitry Shachnev Thu, 03 Sep 2015 16:54:07 +0300 + +sphinx (1.3.1-5) unstable; urgency=medium + + * Fix remaining reproducibility issues (closes: #795976): + - Export SOURCE_DATE_EPOCH in debian/rules. + - Set PYTHONHASHSEED=0 when generating grammar files. + - Make grammar generation deterministic (reproducible_grammar.diff). + - Make inventory generation deterministic (reproducible_inventory.diff). + - Make JavaScript locales deterministic (reproducible_js_locale.diff). + Many thanks to Val Lorentz for the patches. + * Drop XS-Testsuite header, no longer needed with dpkg ≥ 1.17.11. + + -- Dmitry Shachnev Thu, 20 Aug 2015 11:56:56 +0300 + +sphinx (1.3.1-4) unstable; urgency=medium + + * Fix message when calling sphinx-build without arguments + (print_help.diff; closes: #792715). + * Add compatibility default.css file (compat_css.diff). + * Upload to unstable. + + -- Dmitry Shachnev Sat, 15 Aug 2015 18:04:49 +0300 + +sphinx (1.3.1-3) experimental; urgency=medium + + * Update debian/TODO with the actual information. + * Backport upstream patch to disable warning about renamed default theme + (no_theme_rename_warning.diff). + * Backport upstream patch to not insert babel-specific code to generated + LaTeX files when babel is not in use (addto_only_babel.diff). + * Add support for $SOURCE_DATE_EPOCH environment variable, to make + the documentation builds reproducible (source_date_epoch.diff). + * dh_sphinxdoc: Symlink css3-mediaqueries.js, thanks to Jakub Wilk + for the patch (closes: #793045). + * dh_sphinxdoc: Add support for symlinking files specific to the RTD + theme (closes: #781849). + * Bump version number in sphinx-autogen manpage. + * Drop initialize_autodoc.diff, the bug seems to be fixed differently + upstream. + * Update bug URL in a comment in debian/rules for move to GitHub. + + -- Dmitry Shachnev Tue, 28 Jul 2015 22:19:39 +0300 + +sphinx (1.3.1-2) experimental; urgency=medium + + [ Dmitry Shachnev ] + * debian/patches/no_snowballstemmer.diff: Exclude snowballstemmer + from setup.py and egg-info requirements. + * Move the signing keys to debian/upstream/signing-key.asc. + + [ Barry Warsaw ] + * debian/patches/py35compat.diff: Python 3.5 compatibility. + + -- Dmitry Shachnev Tue, 30 Jun 2015 21:02:36 +0300 + +sphinx (1.3.1-1) experimental; urgency=medium + + [ Helmut Grohne ] + * Mark libjs-sphinxdoc Multi-Arch: foreign (closes: #779458). + + [ Dmitry Shachnev ] + * New upstream release. + - The codebase now works with Python 3 with no need to run 2to3. + - Output is now reproducible (closes: #776443). + * Remove patches: + - python3_test_build_dir.diff (no longer needed) + - parallel_2to3.diff (no longer needed) + - fix_latex_hlines.diff (applied upstream) + * Bump required versions of python, docutils and pygments. + * Build-depend and depend on: + - python[3]-six + - python[3]-babel + - python[3]-sphinx-rtd-theme + - python[3]-alabaster + * Add python[3]-mock to build-dependencies and test dependencies. + * Use upstream tarball, which now contains non-minified versions of + jquery.js and underscore.js. + * Update debian/watch to use pypi.debian.net redirector. + * Simplify debian/rules: + - Adjust for using upstream tarballs. + - Do not mention site-packages anymore. + * Update JS tests for the new version. + * Add a patch to skip JS libraries versions check. + * Drop 2to3 call from debian/tests/python3-sphinx. + * Properly clean up after running tests. + * Bring debian/copyright in sync with upstream AUTHORS file. + * Disable snowballstemmer-based search until upstream implements + it correctly (without JS blobs) and we get snowballstemmer packaged. + * Bump Standards-Version to 3.9.6, no changes needed. + * Override lintian false positive warnings about missing sources for + minified files (jquery.js, underscore.js, and css3-mediaqueries.js). + * debian/dh-sphinxdoc/install-js: Update list of files to be installed. + + -- Dmitry Shachnev Sat, 02 May 2015 22:18:56 +0300 + +sphinx (1.2.3+dfsg-1) unstable; urgency=medium + + * New upstream bugfix release. + * Drop websupport_todo.diff, applied upstream. + * Update date and version in sphinx-autogen.1. + * Add Takayuki Shimizukawa’s signing key to upstream-signing-key.pgp. + * Replace links to online docutils docs with links to packaged + docutils docs. + + -- Dmitry Shachnev Fri, 12 Sep 2014 11:49:40 +0400 + +sphinx (1.2.2+dfsg-4) unstable; urgency=medium + + * Build-depend on python3-whoosh, now when it is available. + * Drop sphinxcontrib_namespace.diff, all sphinxcontrib packages + are using dh_python2 now. Break old versions of issuetracker and + spelling packages. + * Update my e-mail address. + * Override false-positive Lintian errors about sourceless files. + * Generate compiled translations using compile_catalog command. + + -- Dmitry Shachnev Mon, 08 Sep 2014 12:58:18 +0400 + +sphinx (1.2.2+dfsg-3) unstable; urgency=medium + + * Remove obsolete Recommends: on python-simplejson and Suggests: + on jsmath. + * debian/patches/websupport_todo.diff: Make websupport work with + todolist directives (closes: #754408). + + -- Dmitry Shachnev Mon, 25 Aug 2014 13:50:20 +0400 + +sphinx (1.2.2+dfsg-2) unstable; urgency=medium + + * Downgrade error about documentation not found to a warning + (closes: #745690). + * Cleanup dh_compress arguments. + * Export NO_PKG_MANGLE, needed to build on Ubuntu. + * Update version number and URL in sphinx-autogen man page. + + -- Dmitry Shachnev Sun, 18 May 2014 15:13:18 +0400 + +sphinx (1.2.2+dfsg-1) unstable; urgency=low + + * New upstream bugfix release. + * Drop html_logo_path_fix.diff, applied upstream. + * Refresh and rebase other patches. + * Update numbers in jstest/run-tests to match docs updates in the new + version. + * Bump debhelper compatibility level to 9. + * Backport upstream patch to fix writing table hlines in LaTeX writer + (closes: #732585). + + -- Dmitry Shachnev Mon, 03 Mar 2014 20:28:04 +0400 + +sphinx (1.2.1+dfsg-3) unstable; urgency=medium + + * Add html_logo_path_fix.diff to fix path check for HTML logo, + backported from upstream hg (thanks James Cowgill, closes: #738741). + * Add missing xauth depencency for sphinx-doc autopkgtest. + + -- Dmitry Shachnev Thu, 13 Feb 2014 12:54:23 +0400 + +sphinx (1.2.1+dfsg-2) unstable; urgency=medium + + * Move Grammar files to /usr/share/sphinx, the code still expects + that thay are in that location (closes: #736239). + + -- Dmitry Shachnev Tue, 21 Jan 2014 19:47:34 +0400 + +sphinx (1.2.1+dfsg-1) unstable; urgency=medium + + * New upstream release. + * Drop fix_jinja_recursion.diff, applied upstream. + * Drop unversioned_grammar_pickle.diff, a different fix was applied + upstream. + * No longer move Grammar.txt and Grammar.pickle to shared location, + upstream is now shipping different versions of grammar for Python 2 + and Python 3. + + -- Dmitry Shachnev Mon, 20 Jan 2014 18:28:47 +0400 + +sphinx (1.2+dfsg-2) unstable; urgency=medium + + * Backport upstream patch (fix_jinja_recursion.diff) to fix infinite + recursion when building python-numpy docs. + * Add explicit build-dependency on dh-python. + * JS tests: use WebView.load_uri() instead of deprecated open(). + + -- Dmitry Shachnev Sun, 12 Jan 2014 13:00:20 +0400 + +sphinx (1.2+dfsg-1) unstable; urgency=low + + * Upload to unstable. + * New upstream stable release. + * Drop fix_setup_command_test.diff, applied upstream. + * Refresh sphinxcontrib_namespace.diff. + * Fix package names in Recommends: python(3)-imaging → python(3)-pil. + * Bump Standards-Version to 3.9.5, no changes needed. + * Bump python-all build-dependency to 2.6.6-3~. + * Verify upstream PGP signature in debian/watch. + + -- Dmitry Shachnev Wed, 18 Dec 2013 17:25:19 +0400 + +sphinx (1.2~b3+dfsg-2) experimental; urgency=low + + * Really switch from dh_pysupport to dh_python2. + * Remove unwanted files from python-sphinx package (closes: #726754). + * Remove useless imports in jstest/jstest.py. + + -- Dmitry Shachnev Mon, 21 Oct 2013 20:55:27 +0400 + +sphinx (1.2~b3+dfsg-1) experimental; urgency=low + + [ Dmitry Shachnev ] + * New upstream beta release. + - Correctly handles errors when repr()-ing objects (closes: #706581). + * Drop upstream patches. + * Refresh and rebase other patches. + * Add a patch to make sure setup_command tests can import sphinx module. + * Switch debian/watch to use HTTPS. + * JS tests: + - Port from deprecated static bindings and Python 2 to PyGI and + Python 3. Update the dependencies accordingly. + - Do not use web server, instead set a WebKit option that will allow + us to access files directly. Now the pages should load faster + (closes: #724472). + * Switch from deprecated dh_pysupport to dh_python2 (closes: #659196). + * Add XS-Testsuite header, and replace XS-Python-Version with preferred + X-Python-Version (closes: #685508). + * Add myself to Uploaders. + + [ Jakub Wilk ] + * Remove myself from Uploaders. + + -- Dmitry Shachnev Sat, 05 Oct 2013 19:29:41 +0400 + +sphinx (1.2~b1+dfsg-2) experimental; urgency=low + + * Export http_proxy=http://127.0.0.1:9/ in debian/rules to prevent Internet + access at build time. + * Use canonical URIs for Vcs-* fields. + * Add texinfo to Build-Depends. + * Add patch (fix_copying_imgs_singlehtml_builder.diff) to fix copying images + in the singlehtml builder (closes: #706563). + * Add patch (fix_globaltoc_and_hidden_toctree.diff) to fix combination of + globaltoc and hidden toctree causing an exception (closes: #706586). + * Add patch (fix_missing_citation_target_assert.diff) to fix missing + citation target causing AssertionError (closes: #706565). + * Rename skiptest_latex.diff as skiptest.diff; fix more cases when a missing + tool was silently ignored. + * Set Debian Python Modules Team as Maintainer; move myself to Uploaders. + + -- Jakub Wilk Tue, 04 Jun 2013 23:57:47 +0200 + +sphinx (1.2~b1+dfsg-1) experimental; urgency=low + + * New upstream beta release. + + Drop fix_nepali_po.diff; applied upstream. + + Drop fix_shorthandoff.diff; different fix applied upstream. + + Drop l10n_fixes.diff; applied upstream. + + Drop manpage_writer_docutils_0.10_api.diff; applied upstream. + + Drop pygments_byte_strings.diff; different fix applied upstream. + + Drop show_more_stack_frames.diff; an option to show full traceback (-T) + is now available. + + Drop sort_stopwords.diff; applied upstream. + + Drop support_python_3.3.diff; applied upstream. + + Drop test_build_html_rb.diff; applied upstream. + + Refresh other patches. + + Update integration tests for the JavaScript code. + + Update debian/copyright. + + Update debian/*.docs to take into account that README was renamed as + REAMDE.rst. + + Update version in sphinx-autogen manpage. + + This release fixes parsing C++11 “static constexpr” declarations + (closes: #693066). Thanks to Alexandre Duret-Lutz for the bug report and + the patch. + * Run tests under LC_ALL=C.UTF-8 to work around test failures. + * Make it impossible to accidentally build the source package with an + .orig.tar that includes jquery.js or underscore.js. + * Refactor debian/rules. + * When building our own documentation, run sphinx-build with the -T option. + * Use a dedicated script to extract JavaScript code for libjs-sphinxdoc. + * Add no_external_css.diff: don't use CSS files hosted on external sites. + + -- Jakub Wilk Mon, 29 Apr 2013 23:37:06 +0200 + +sphinx (1.1.3+dfsg-7) experimental; urgency=low + + * Backport upstream patch for fix compatibility with Docutils 0.10. + * Run 2to3 in parallel. + * Add DEP-8 tests for the documentation package. + + -- Jakub Wilk Wed, 19 Dec 2012 10:53:51 +0100 + +sphinx (1.1.3+dfsg-6) experimental; urgency=low + + [ Jakub Wilk ] + * DEP-8 tests: remove “Features: no-build-needed”; it's the default now. + * Bump standards version to 3.9.4; no changes needed. + * Pass -a to xvfb-run, so that it tries to get a free server number. + * Rebuild MO files from source. + + Update debian/rules. + + Add the rebuilt files to extend-diff-ignore. + * Make synopses in the patch header start with a lowercase latter and not + end with a full stop. + + [ Dmitry Shachnev ] + * debian/patches/l10n_fixes.diff: fix crashes and not working external + links in l10n mode (closes: #691719). + * debian/patches/sort_stopwords.diff: mark as applied upstream. + + -- Jakub Wilk Sat, 08 Dec 2012 14:38:19 +0100 + +sphinx (1.1.3+dfsg-5) experimental; urgency=low + + [ Jakub Wilk ] + * DEP-8 tests: use $ADTTMP. + * dh_sphinxdoc: ignore comments when analysing HTML files (closes: #682850). + Thanks to Dmitry Shachnev for the bug report. + * Add dvipng to Suggests (closes: #687273). Thanks to Matthias Klose for the + bug report. + * Set PYTHONHASHSEED=random in debian/rules and in DEP-8 tests. + * Backport upstream patch to fix encoding issues in test_build_html. Now + that this is fixed, stop running Python 3 tests under LC_ALL=C. + * Make “debian/rules binary-arch” no-op. + * Update version number in the sphinx-autogen manpage. + * Improve dh_sphinxdoc: + + Fix the --tmpdir option. Thanks to Andriy Senkovych for the bug report. + + Ignore references to JavaScript code that start with an URI scheme. + Thanks to Dmitry Shachnev for the bug report. + + Strip query (?...) and fragment (#...) components from JavaScript + references. Thanks to Dmitry Shachnev for the bug report. + * Sort stopwords in searchtools.js. Thanks to Dmitry Shachnev for the bug + report. + * Fix compatibility with Python 3.3. Thanks to Dmitry Shachnev for the bug + report and hunting down the upstream patch. + + [ Dmitry Shachnev ] + * Update Homepage field to point to http://sphinx-doc.org/. + * Build-depend of python3-all instead of python3. + + -- Jakub Wilk Thu, 08 Nov 2012 16:28:23 +0100 + +sphinx (1.1.3+dfsg-4) unstable; urgency=low + + * Add DEP-8 tests. + * LaTeX writer: fix generation of \shorthandoff (closes: #672586, + LP: #997891). Thanks to Melissa Draper for the bug report and the initial + patch. + + -- Jakub Wilk Thu, 24 May 2012 18:53:29 +0200 + +sphinx (1.1.3+dfsg-3) unstable; urgency=low + + * Validate *.po files at build time. Add gettext to Build-Depends. + * Add fix_nepali_po.diff: remove Nepali translations that must have been + wrong. + * Add pygments_byte_strings.diff: fix Unicode issues in + PygmentsBridge.highlight_block (closes: #660930). Thanks to Anton Gladky + for the bug report and the initial patch. + * Fix a typo in a patch description. + + -- Jakub Wilk Mon, 02 Apr 2012 22:17:49 +0200 + +sphinx (1.1.3+dfsg-2) unstable; urgency=low + + * Upload to unstable. + * Add skiptest_latex.diff: if LaTeX (or a required LaTeX package) is not + found when running test_build_latex, raise SkipTest instead of just + printing a message to stderr. + + -- Jakub Wilk Wed, 14 Mar 2012 20:31:19 +0100 + +sphinx (1.1.3+dfsg-1) experimental; urgency=low + + * New upstream release. + + Drop python3_test_syspath.diff, applied upstream. + + Update integration tests for the JavaScript code. + * Bump standards version to 3.9.3 (no changes needed). + + -- Jakub Wilk Mon, 12 Mar 2012 12:18:37 +0100 + +sphinx (1.1.2+dfsg-5) unstable; urgency=low + + * Don't run ‘python setup.py clean’ in the clean target (we nuke the whole + build subdirectory anyway). + * Move python-all and python-setuptools from Build-Depends to + Build-Depends-Indep, as it's not needed in the clean target anymore. + * Don't run dh_testroot in the clean target. There's a good chance that root + privileges are not needed (e.g. because binary target was run under + fakeroot), and even if they are actually needed, the target will fail + quickly. + * Run tests against Python 3: + + Add build-dependency on python3-nose, python3-docutils, + python3-pygments, python3-jinja2, python3-sqlalchemy. + + Add python3_test_syspath.diff to fix Python 3 sys.path for the test + runner. + + Add python3_test_build_dir.diff to hardcode Python 3 build directory in + the test runner to the one that the package uses. + + Add test running code debian/rules. Don't use --no-skip for the moment, + as some required packages don't exist yet (see #647441, #647439). Set + LC_ALL=C.UTF-8 to work around failures under LC_ALL=C (see + and ). + + -- Jakub Wilk Tue, 14 Feb 2012 00:13:35 +0100 + +sphinx (1.1.2+dfsg-4) unstable; urgency=low + + * Make the build actually fail if integration tests for the JavaScript + code fail. + * Don't remove *.egg-info in the clean target; add it to extend-diff-ignore + instead. + * Pass --no-guessing-deps to dh_python3. + + -- Jakub Wilk Sun, 05 Feb 2012 19:33:59 +0100 + +sphinx (1.1.2+dfsg-3) unstable; urgency=low + + * Upload to unstable (closes: #655637). + * Use xargs to iterate over all Python versions. + * Make sphinx-autogen initialize the sphinx.ext.autodoc module (hopefully + closes: #611078). + + -- Jakub Wilk Sun, 05 Feb 2012 17:59:55 +0100 + +sphinx (1.1.2+dfsg-2) experimental; urgency=low + + * Add sphinxcontrib_namespace.diff: create namespace package + ‘sphinxcontrib’. This allows python-sphinxcontrib.* packages, both those + using dh_python2 and those using python-support, to be co-importable. + * Add various texlive-* and libjs-mathjax to Suggests. + * Don't install SOURCES.txt into binary packages. + * dh_sphinxdoc: produce different diagnostic message when unknown JavaScript + script is being ignored than when it's a fatal error. Thanks to Sandro + Tosi for the bug report. + * Make the get-orig-source script create temporary files in /tmp (or + $TMPDIR). + * Revert all the changes to manual pages that accumulated over the years. + * Document that symlinking translations.js and non-English searchtools.js is + not supported (see bug #658238). + * Don't include websupport.js in libjs-jquery. Make dh_sphinxdoc remove this + file from binary package. + * dh_sphinxdoc: -X should now exclude a file if exists anywhere + in the path, so it can be used e.g. to exclude whole directories. + * Fix a typo in dh_sphinxdoc manual page. + + -- Jakub Wilk Fri, 03 Feb 2012 13:52:49 +0100 + +sphinx (1.1.2+dfsg-1) experimental; urgency=low + + * New upstream release (closes: #649048). + + Drop autosummary_1.0.6.patch for the time being (reopens: #611078). + + Drop docstring_parse.diff, applied upstream. + + Rename disable_ez_setup.diff to disable_distribute_setup.diff. + + Drop move_static_files_outside_site-packages.patch. Most of it was + applied upstream, the remaining bits are now taken care of in + debian/rules. + + Refresh other patches. + + Update integration tests for the JavaScript code. + + Bump minimum required versions: + - python-docutils to >= 0.7; + - python-pygments to >= 1.2; + - python-jinja2 to >= 2.3. + - python to >= 2.5. + + Add code to install also JavaScript files that are generated at build + time. Add websupport.js to dh_sphinxdoc index. + + Update debian/copyright. + * Texinfo output format is now supported (closes: #586747). + * Update version numbers in the manual pages. Add a build-time warning to be + emitted if they ever get out of date again. + * Build manual pages (except for sphinx-autogen.1) from reStructuredText + sources. + * Rephrase short package description, so that it's... shorter. + * New binary package: sphinx-common, containing manual pages, templates, + translations and other data files. + * New binary package: sphinx-doc, containing documentation. + + Conflict with previous versions python-sphinx. + + /usr/share/doc/python-sphinx/html used to be a directory, but is now a + symlink. Conflict with older versions of python-docutils, so that dpkg + can replace one with the other. Add lintian override. + * New binary package: python3-sphinx. + + Both python-sphinx and python3-sphinx provide sphinx-* scripts. The + scripts have: + #!/usr/bin/python3 shebang if only python3-sphinx is installed; + #!/usr/bin/python shebang otherwise. + + /usr/bin/sphinx-* are now symlinks and are managed by docutils-common + postinst/postrm maintainer scripts. + + Make sphinx-common conflict with older versions of python-sphinx that + were shipping /usr/bin/sphinx-* scripts. Add lintian override for + conflicts-with-version. + + Add build-dependency on python3 (needed for dh_python3) and + python3-setuptools. + + Add X-Python3-Version field. + * Improve debian/rules: + + Run dh_install with --fail-missing. + + Refactor the code responsible for moving data into a private directory. + Rename some variables to make them lowercase. Don't use CURDIR where + it's not necessary. + + Make it possible to rebuild the package without running clean target. + + Remove unneeded mkdir calls. + + Use a for loop in debian/rules to install all sphinx-* scripts. + + Run nosetests with --verbose --no-skip. + * Add build-dependency on the following packages (needed for the test + suite): python-sqlalchemy, python-whoosh, python-xapian. + * Use XS-Python-Version instead of debian/pyversions. + + -- Jakub Wilk Sun, 20 Nov 2011 15:56:50 +0100 + +sphinx (1.0.8+dfsg-2) unstable; urgency=low + + * Upload to unstable. + + -- Jakub Wilk Wed, 12 Oct 2011 00:34:20 +0200 + +sphinx (1.0.8+dfsg-1) experimental; urgency=low + + * New upstream release. + + Drop fix_jquery_1.5_incompatibility.diff, applied upstream. + + Drop fix_test_build_latex.diff, applied upstream. + + Refresh other patches. + * Export PYTHONWARNINGS=d in debian/rules to enable all warnings in Python + code. + + -- Jakub Wilk Wed, 28 Sep 2011 17:20:22 +0200 + +sphinx (1.0.7+dfsg-2) unstable; urgency=low + + * JavaScript test suite: don't hang if get_title() returns None. Thanks to + Ansgar Burchardt for the bug report. + * dh_sphinxdoc: + + Fix a typo in the manual page. + + Don't check for existence of source files if HAS_SOURCE is false + (closes: #641710). Thanks to Raphaël Hertzog for the bug report. + * Disable use of ez_setup in setup.py. + * Set myself as maintainer. Thanks to Mikhail Gusarov for his past work! + + -- Jakub Wilk Thu, 15 Sep 2011 13:53:16 +0200 + +sphinx (1.0.7+dfsg-1) unstable; urgency=medium + + * Strip jQuery and Underscore.js from the upstream tarball (closes: + #631535). + + Add get-orig-source target. + + Remove them from debian/copyright. + + Add build-dependency on libjs-underscore, + + Update watch file to deal with the +dfsg suffix. + * Unify multiple calls to dh_link. + * Use build/html as build directory for documentation. + * Add integration tests for the JavaScript code. They should allow us to + avoid bugs like #625208 or #628642 in the future. + + Build-depend on xvfb, xauth, python-webkit, libjs-jquery and + libjs-underscore. + * Add build-arch and build-indep targets to debian/rules. + * Add new tool, dh_sphinxdoc that aids shipping Sphinx-generated + documentation in Debian packages. + + Update debian/rules, debian/control and debian/*.links to use + dh_sphinxdoc. + + Use pod2man to generate manpage. Add dependency on perl. Update + debian/manpages and debian/clean. + * Move all JavaScript code into a separate package, libjs-sphinxdoc. + * Fix test_build_latex to not fail in a directory with special characters. + * Use debian/clean rather than listing files to clean directly in + debian/rules. + + -- Jakub Wilk Sun, 10 Jul 2011 22:43:16 +0200 + +sphinx (1.0.7-5) unstable; urgency=low + + [ Jakub Wilk ] + * Bump standards version to 3.9.2 (no changes needed). + * Bump minimum required version of jQuery to 1.4. + * Use python (>= 2.6.6-14~) as an alternative build-dependency to + python-simplejson. The latter package is only needed for python2.5, and + python-defaults 2.6.6-14 doesn't support it anymore. + * Include jQuery source (closes: #630973). + + Check at build time if versions of both jQuery copies match. + + [ Nikolaus Rath ] + * Backport upstream changesets a8b0ef275438 and de340a6098c7 to allow + extraction of function signature from docstring for extension modules. + (closes: #630409). The feature is disabled by default for the moment. + + -- Jakub Wilk Sun, 19 Jun 2011 14:44:49 +0200 + +sphinx (1.0.7-4) unstable; urgency=low + + * When Sphinx crashes, show 10 stack frames (instead of a single one). + * Backport upstream patch to fix incompatibility with jQuery >= 1.5 + (closes: #625208). Thanks to Tshepang Lekhonkhobe for the bug report. + + -- Jakub Wilk Thu, 19 May 2011 11:59:00 +0200 + +sphinx (1.0.7-3) unstable; urgency=low + + [ Mikhail Gusarov ] + * Change my email address. + + [ Jakub Wilk ] + * New upstream release (closes: #613207). + + Refresh patches. + + Revert changes to the autosummary extension introduced in 1.0.7 + (closes: #611078). + * Don't compress objects.inv. Thanks to Michael Fladischer for the bug + report. + * Remove *.egg-info in the clean target. + * Move pycode/Grammar.txt and ext/autosummary/templates/* out of + /usr/share/pyshared/ (closes: #609486). + * Stop embedding Python version in filename of grammar pickle. + * Ship grammar pickle in the binary package (closes: #613412). Thanks to + Frederic-Emmanuel Picca for the bug report. + * Drop preinst script to remove python-central leftovers; not needed + anymore. + * New upstream release. + * Update and significantly rewrite manual pages (closes: #593623). + * Switch to source format 3.0 (quilt). + + Drop README.source. + + Refresh patches. + + Update debian/rules. + + Drop quilt from build-depends. + * Update debian/copyright. + * Use DEP-3 format for patch headers. + * Run tests at build time. + + Add python-nose, python-simplejson and + texlive-{latex-{recommended,extra},fonts-recommended} to + Build-Depends-Indep. + + Patch test runner to import modules correctly and prevent it from + reading files in /usr/share/sphinx. + + Update debian/rules. + * Bump standards version to 3.9.1 (no changes needed). + * Add ‘set -e’ to a for loop in debian/rules. + + [ Piotr Ożarowski ] + * Minimum required versions bumped: + - python-jinja2 >= 2.2 + - python-docutils >= 0.5 + * move_static_files_outside_site-packages.patch updated + + [ Stefano Rivera ] + * Improve language and clarify options in manpages. + + -- Jakub Wilk Mon, 04 Apr 2011 13:50:56 +0200 + +sphinx (0.6.6-3) unstable; urgency=low + + * Add myself to uploaders. + * Fix formatting of the manual pages. + * Update and significantly rewrite the sphinx-build manual page + (closes: #593623). + * Bump standards version to 3.9.1 (no changes needed). + + -- Jakub Wilk Mon, 30 Aug 2010 00:26:04 +0200 + +sphinx (0.6.6-2) unstable; urgency=low + + * Team upload. + + [ Mikhail Gusarov ] + * Fix preinst script to correctly remove python-central remnants (Closes: + #559572). + + -- Jakub Wilk Fri, 06 Aug 2010 16:33:55 +0200 + +sphinx (0.6.6-1) unstable; urgency=low + + [ Piotr Ożarowski ] + * New upstream release + - disable_ez_setup.patch removed, no longer needed + - move_static_files_outside_site-packages.patch updated + * Bump Standards-Version to 3.8.4, no changes needed. + + -- Debian Python Modules Team Tue, 25 May 2010 22:30:46 +0200 + +sphinx (0.6.5-1) unstable; urgency=low + + [ Piotr Ożarowski ] + * New upstream release + + -- Debian Python Modules Team Mon, 29 Mar 2010 23:08:45 +0200 + +sphinx (0.6.4-1) unstable; urgency=low + + [ Piotr Ożarowski ] + * New upstream release + + -- Debian Python Modules Team Wed, 13 Jan 2010 23:26:40 +0100 + +sphinx (0.6.3-2) unstable; urgency=low + + [ Piotr Ożarowski ] + * Add preinst maintainer script to remove python-central leftovers; thanks to + Jakub Wilk for the report; Closes: #559572 + + [ Sandro Tosi ] + * debian/control + - added misc:Depends to the binary package Depends line + + -- Mikhail Gusarov Sun, 03 Jan 2010 22:37:20 +0600 + +sphinx (0.6.3-1) unstable; urgency=low + + * New upstream release (Closes: #545042): + - handle error when using autoclass with a non-class (Closes: #537165) + - all patches refreshed. + * Use debian/pyversions instead of X[SB]-Python-Version. + * Add doc-base file for manual. + * Bump Standards-Version, no changes needed. + + -- Mikhail Gusarov Fri, 04 Sep 2009 17:49:20 +0700 + +sphinx (0.6.2-1) unstable; urgency=low + + [ Piotr Ożarowski ] + * New upstream release (Closes: #527538) + - add_missing_sphinx-autogen and rfind-invocation patches removed, no + longer needed + - move_static_files_outside_site-packages.patch updated + * Standards-Version bumped to 3.8.2, no changes needed. + + -- Debian Python Modules Team Wed, 17 Jun 2009 19:32:26 +0200 + +sphinx (0.6.1-2) unstable; urgency=low + + [ Mikhail Gusarov ] + * Fix debian/README.source: s/dpatch/quilt/ (Closes: #523293). + * Add debian/rfind-invocation.patch, fixing breakage on python-werkzeug + docs. + + [ Piotr Ożarowski ] + * Install .mo files (Closes: #526027) + + -- Mikhail Gusarov Sun, 12 Apr 2009 14:37:30 +0700 + +sphinx (0.6.1-1) unstable; urgency=low + + [ Piotr Ożarowski ] + * New upstream release + + depend on python-jinja2 instead of python-jinja + * Add move_static_files_outside_site-packages patch + * Build depend on python-all (>= 2.5.4-1) (py_libdir is now used in + debian/rules) + * add_missing_sphinx-autogen.patch added (missing file will be added in next + upstream release) + + [ Jan Dittberner ] + * add man page debian/sphinx-autogen.1 + + -- Debian Python Modules Team Tue, 07 Apr 2009 18:24:25 +0100 + +sphinx (0.5.2-1) unstable; urgency=low + + [ Piotr Ożarowski ] + * New upstream release (Closes: #517735) + + bump python-jinja minimum required version to 1.2 + * Switch to python-support + * remove .pickle file in clean rule + * Standards-Version bumped to 3.8.1, no changes needed. + + -- Debian Python Modules Team Tue, 24 Mar 2009 21:26:26 +0100 + +sphinx (0.5.1-2) unstable; urgency=low + + [ Piotr Ożarowski ] + * Upload to unstable + * Add debian/README.source file + + -- Debian Python Modules Team Sat, 07 Feb 2009 15:31:02 +0100 + +sphinx (0.5.1-1) experimental; urgency=low + + [ Piotr Ożarowski ] + * New upstream release + + Closes: #507647 + + upload to experimental due to Lenny freeze, to ease testing rev. + dependencies + * Add disable_ez_setup patch (and quilt to build dependencies) so that it + will not try to download stuff that is already installed on the system + * Add jsmath to suggested packages (Closes: #507691) + + -- Debian Python Modules Team Wed, 17 Dec 2008 18:42:59 +0100 + +sphinx (0.5-1) experimental; urgency=low + + [ Sandro Tosi ] + * debian/control + - switch Vcs-Browser field to viewsvn + + [ Piotr Ożarowski ] + * New upstream release (upload to experimental due to Lenny freeze, to ease + testing rev. dependencies) + * Add python (>=2.6) | python-simplejson and python-imaging to Recommends + * Remove .doctrees directory from docs/html + * Bump python-jinja's required version to >= 1.1 + + -- Debian Python Modules Team Sun, 23 Nov 2008 21:49:50 +0100 + +sphinx (0.4.2-1) unstable; urgency=medium + + * New upstream version. Fixes bug with broken show-inheritance in + automodule (Closes: #492732) + * Urgency medium, fixes RC bug. + * Using jQuery from Debian package, not bundled one: + - Added dependency on libjs-jquery, + - Replaced jquery.js by symlink to /usr/share/javascript/jquery/jquery.js + + -- Mikhail Gusarov Tue, 29 Jul 2008 17:55:27 +0700 + +sphinx (0.4.1-2) unstable; urgency=low + + * debian/control: sphinx is not compatible with python 2.3, so + XS-Python-Version: >= 2.4 (Closes: #490537). + + -- Mikhail Gusarov Sat, 12 Jul 2008 20:13:12 +0700 + +sphinx (0.4.1-1) unstable; urgency=low + + * New upstream version. + * All patches removed, applied upstream: + - Removed quilt build-dep + - Removed quilt patch/unpatch targets in debian/rules. + + -- Mikhail Gusarov Wed, 09 Jul 2008 02:57:25 +0700 + +sphinx (0.4-1) unstable; urgency=low + + * New upstream version. + * Standards-Version bumped to 3.8.0, no changes needed. + * Vcs-{Svn,Browser} added. + + -- Mikhail Gusarov Mon, 23 Jun 2008 19:31:00 +0700 + +sphinx (0.3-2) unstable; urgency=medium + + * Added missing python-docutils dependency (Closes: #482916). + + -- Mikhail Gusarov Mon, 26 May 2008 04:44:14 +0700 + +sphinx (0.3-1) unstable; urgency=low + + * New upstream version. + * Fixed typo in package description (Closes: #479285). + * debhelper compatibility level bumped to 7: + - Updated debhelper dependency + - debian/rules: stamp files are removed automatically + * Removed empty debian/examples file. + + -- Mikhail Gusarov Sun, 04 May 2008 13:44:34 +0700 + +sphinx (0.2-1) unstable; urgency=low + + * New upstream version. + * sphinx no longer bundles jinja in tarball: + - nuked jinja removal code from debian/rules, + - added build-depencency to python-jinja for documentation generation, + - updated debian/copyright, removing information about jinja copyrights + + -- Mikhail Gusarov Thu, 01 May 2008 11:00:18 +0700 + +sphinx (0.1.61950-1) unstable; urgency=low + + * Initial release (Closes: #474782) + * Added patch disable-sphinx-web.patch, disabling installation of + sphinx-web, which is not yet ready. + * Added patch add_shebangs.patch, adding shebangs in sphinx-build and + sphinx-quickstart + * Added manpages for sphinx-build(1) and sphinx-quickstart(1). + * Removed bundled jinja instance. + + -- Mikhail Gusarov Sun, 20 Apr 2008 23:01:50 +0200 diff --git a/debian/clean b/debian/clean new file mode 100644 index 0000000..c96f3e7 --- /dev/null +++ b/debian/clean @@ -0,0 +1,12 @@ +.pytest_cache/ +Sphinx.egg-info/PKG-INFO +Sphinx.egg-info/SOURCES.txt +Sphinx.egg-info/entry_points.txt +Sphinx.egg-info/requires.txt +debian/dh-sphinxdoc/*.1 +debian/dh-sphinxdoc/.doctrees/ +doc/.doctrees/ +sphinx/locale/*/LC_MESSAGES/sphinx.js +sphinx/locale/*/LC_MESSAGES/sphinx.mo +sphinx/pycode/*.pickle +tests/build/ diff --git a/debian/control b/debian/control new file mode 100644 index 0000000..965d7de --- /dev/null +++ b/debian/control @@ -0,0 +1,144 @@ +Source: sphinx +Section: python +Priority: optional +Maintainer: Debian Python Team +Uploaders: Dmitry Shachnev +Homepage: https://www.sphinx-doc.org/ +Build-Depends: debhelper-compat (= 13) +Build-Depends-Indep: dh-python (>= 3.20180313~), + dpkg-dev (>= 1.17.14), + dvipng, + flit (>= 3.7), + fonts-freefont-otf, + graphviz, + imagemagick-6.q16, + libjs-jquery (>= 1.4), + libjs-underscore, + libjson-perl , + librsvg2-bin, + perl, + pybuild-plugin-pyproject, + python-requests-doc , + python3-alabaster (>= 0.7), + python3-all (>= 3.3.3-1~), + python3-babel (>= 1.3), + python3-doc , + python3-docutils (>= 0.18.1), + python3-filelock , + python3-html5lib , + python3-imagesize, + python3-jinja2 (>= 2.3), + python3-lib2to3, + python3-packaging, + python3-pygments (>= 2.14), + python3-pytest , + python3-requests (>= 2.25.0), + python3-setuptools, + python3-snowballstemmer (>= 1.1), + python3-sphinxcontrib.websupport , + tex-gyre, + texinfo, + texlive-fonts-recommended, + texlive-latex-extra, + texlive-latex-recommended, + texlive-luatex, + texlive-xetex +Rules-Requires-Root: no +Standards-Version: 4.6.2 +Vcs-Git: https://salsa.debian.org/python-team/packages/sphinx.git +Vcs-Browser: https://salsa.debian.org/python-team/packages/sphinx + +Package: python3-sphinx +Architecture: all +Depends: sphinx-common (= ${source:Version}), + ${misc:Depends}, + ${python3:Depends} +Recommends: make, python3-pil +Suggests: dvipng, + fonts-freefont-otf, + imagemagick-6.q16, + latexmk, + libjs-mathjax, + python3-lib2to3, + python3-sphinx-rtd-theme, + sphinx-doc, + tex-gyre, + texlive-fonts-recommended, + texlive-latex-extra, + texlive-latex-recommended, + texlive-plain-generic +Provides: sphinx (= ${binary:Version}) +Breaks: python-flask-restful-doc (<< 0.3.10-2), + python-pylatex-doc (<< 1.4.2-3), + python3-breathe (<< 4.15), + python3-nbsphinx (<< 0.8.7), + python3-sphinx-celery (<< 2.0.0), + python3-sphinx-rtd-theme (<< 1.2.0+dfsg-2~), + python3-sphinx-tabs (<< 3.4.0), + python3-sphinxcontrib.serializinghtml (<< 1.1.5), + python3-sphinxcontrib.websupport (<< 1.1.2) +Conflicts: python-sphinx +Description: documentation generator for Python projects + Sphinx is a tool for producing documentation for Python projects, using + reStructuredText as markup language. + . + Sphinx features: + * HTML, CHM, LaTeX output, + * Cross-referencing source code, + * Automatic indices, + * Code highlighting, using Pygments, + * Extensibility. Existing extensions: + - automatic testing of code snippets, + - including docstrings from Python modules. + . + Build-depend on sphinx if your package uses /usr/bin/sphinx-* + executables. Build-depend on python3-sphinx if your package uses + the Python API (for instance by calling python3 -m sphinx). + +Package: sphinx-common +Architecture: all +Multi-Arch: foreign +Depends: libjs-sphinxdoc (= ${source:Version}), + libjson-perl, + ${misc:Depends}, + ${perl:Depends} +Recommends: python3-sphinx +Conflicts: python-sphinx (<< 1.1) +Replaces: python-sphinx (<< 1.1) +Provides: dh-sequence-sphinxdoc +Description: documentation generator for Python projects - common data + Sphinx is a tool for producing documentation for Python projects, using + reStructuredText as markup language. + . + This package includes manual pages, templates, translations and other data + files. + +Package: sphinx-doc +Build-Profiles: +Section: doc +Architecture: all +Multi-Arch: foreign +Conflicts: python-sphinx (<< 1.1) +Replaces: python-sphinx (<< 1.1) +Depends: docutils-doc, + libjs-mathjax, + python-requests-doc, + python3-doc, + ${misc:Depends}, + ${sphinxdoc:Depends} +Description: documentation generator for Python projects - documentation + Sphinx is a tool for producing documentation for Python projects, using + reStructuredText as markup language. + . + This package includes documentation of Sphinx itself. + +Package: libjs-sphinxdoc +Section: javascript +Architecture: all +Multi-Arch: foreign +Depends: libjs-jquery (>= 1.11.1), libjs-underscore (>= 1.3.1), ${misc:Depends} +Description: JavaScript support for Sphinx documentation + Sphinx is a tool for producing documentation for Python projects, using + reStructuredText as markup language. + . + This package provides JavaScript code for documentation generated by Sphinx. diff --git a/debian/copyright b/debian/copyright new file mode 100644 index 0000000..80f793e --- /dev/null +++ b/debian/copyright @@ -0,0 +1,85 @@ +Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: Sphinx + +Files: * +Copyright: 2007-2023 the Sphinx team (see AUTHORS file) +License: BSD-2-clause + +Files: debian/dh-sphinxdoc/dh_sphinxdoc + debian/jstest/jstest.py +Copyright: 2011 Jakub Wilk + 2013-2024 Dmitry Shachnev +License: BSD-2-clause + +Files: sphinx/ext/apidoc.py +Copyright: 2008 Société des arts technologiques (SAT) + 2007-2023 the Sphinx team +License: BSD-2-clause + +Files: sphinx/ext/napoleon/docstring.py +Copyright: 2008 Stefan van der Walt + 2008 Pauli Virtanen + 2007-2023 the Sphinx team +License: BSD-2-clause + +Files: sphinx/search/minified-js/* + sphinx/search/non-minified-js/* +Copyright: 2001 Dr Martin Porter + 2004-2005 Richard Boulton + 2013 Yoshiki Shibukawa + 2006-2021 Olly Betts +License: BSD-3-clause + +Files: sphinx/themes/haiku/static/haiku.css_t +Copyright: 2008-2009 Haiku + 2007-2023 the Sphinx team +License: BSD-2-clause + +License: BSD-2-clause + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are + met: + . + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + . + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +License: BSD-3-clause + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are + met: + . + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + * Neither the name of the software nor the names of its contributors + may be used to endorse or promote products derived from this + software without specific prior written permission. + . + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/debian/dh-sphinxdoc/conf.py b/debian/dh-sphinxdoc/conf.py new file mode 100644 index 0000000..6d644b2 --- /dev/null +++ b/debian/dh-sphinxdoc/conf.py @@ -0,0 +1,3 @@ +master_doc = 'empty' +html_theme = 'classic' +html_theme_options = {'collapsiblesidebar': True} diff --git a/debian/dh-sphinxdoc/dh_sphinxdoc b/debian/dh-sphinxdoc/dh_sphinxdoc new file mode 100755 index 0000000..ccd4a5a --- /dev/null +++ b/debian/dh-sphinxdoc/dh_sphinxdoc @@ -0,0 +1,616 @@ +#!/usr/bin/perl + +# Copyright © 2011 Jakub Wilk +# © 2014-2024 Dmitry Shachnev +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are +# met: +# +# * Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# +# * Redistributions in binary form must reproduce the above copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +=head1 NAME + +dh_sphinxdoc - helps with packaging Sphinx-generated documentation + +=head1 SYNOPSIS + +dh_sphinxdoc [S>] [B<-X>I] [I...] + +=head1 DESCRIPTION + +B is a debhelper program that prepares Sphinx-generated +documentation for inclusion in a Debian package. More specifically: + +=over 4 + +=item * + +It checks if all the files referenced by F exist. + +=item * + +It replaces known F<*.js> files with symlinks to F +and generates B<${sphinxdoc:Depends}> substitution variable. + +=item * + +If the Sphinx RTD theme is used, it replaces known files from this theme with +symlinks to F, and adds B +to B<${sphinxdoc:Depends}>. + +=item * + +It provides a B<${sphinxdoc:Built-Using}> substitution variable, for tracking +files which could not be symlinked. Examples of such files are F<*.js> and F<*.css> +files that are generated from corresponding F<*.js_t> and F<*.css_t> templates, +and can vary depending on the used theme options (for instance, F file +is generated from F and is included in almost every Sphinx-generated +documentation). Currently, this variable will contain B and, if the default +theme is used, B, with their versions (other themes are not supported). + +=item * + +It removes the F<.doctrees> directory. + +=item * + +It removes the F<.buildinfo> file. + +=item * + +It removes the F file. + +=back + +Note that B does not build the documentation, it only performs +the above operations when the documentation is already installed into the +package build path. To build the docs, please use L command +or B syntax. + +You can pass B<--with sphinxdoc> to L to make it automatically call +B after B. + +=head1 OPTIONS + +=over 4 + +=item I + +By default, B scans your package looking for directories looking +like they contain Sphinx-generated documentation. However, if you explicitly +provide one or more directories, only they will be processed. If documentation +is not found at I, an error is raised. + +=item B<-X>I, B<--exclude=>I + +Exclude files that contain I anywhere in their filename from +being symlinked, removed or checked for existence. + +=back + +=head1 BUGS + +Symlinking translations.js is not supported. + +=cut + +use strict; +use warnings; + +use Digest::MD5; +use File::Basename; +use File::Find; +use Debian::Debhelper::Dh_Lib; +use JSON; + +my %packaged_js = (); +my @cruft_js = qw(websupport.js); + +sub md5($) +{ + my ($filename) = @_; + my $md5 = Digest::MD5->new; + open(F, '<', $filename) or error("cannot open $filename"); + $md5->addfile(*F); + close(F); + return $md5->digest; +} + +sub load_packaged_js() +{ + my %versions = (); + my $root = 'debian/libjs-sphinxdoc'; # It's tempting to use + # tmpdir('libjs-sphinxdoc') here, but it would break if the user passed + # --tmpdir to the command. + $root = '' unless -d $root; + my $path = "$root/usr/share/javascript/sphinxdoc"; + open(F, '<', "$path/index") or error("cannot open $path/index"); + while () + { + chomp; + next if /^(#|\s*$)/; + my ($js, $minver) = split(/\s+/, $_, 2); + unless (defined($minver)) + { + $js =~ m{^([0-9.]+)/} or error("syntax error in $path/index"); + $minver = $1; + } + $versions{$js} = $minver; + } + close(F); + find({ + wanted => sub { + my $js = $_; + my ($jsbase, $jsname) = m{([0-9.]+/(\S+[.]js))$} or return; + if ($jsbase =~ m{1\.0/(jquery|underscore)\.js}) + { + # These files are still shipped in libjs-sphinxdoc in order not to break + # symlinks in previously built -doc packages. They will be dropped in some + # future libjs-sphinxdoc version. After that, this check can be removed. + return; + } + my $version = $versions{$jsbase}; + defined($version) or error("$jsbase is not in the index; is it up-to-date?"); + delete $versions{$jsbase}; + my $md5; + if (-l $js) + { + # Follow the symlink, but only if points *outside* our own directory. + my $js_target = readlink($js); + $js_target =~ m{^(/|\Q../../\E)} or return; + unless ($js_target =~ m{^/}) + { + $js_target = "$js/../$js_target"; + while ($js_target =~ s{[^./][^/]+/[.][.]/}{}) {}; + } + $md5 = md5($js_target); + } + else + { + $js =~ s{^\Q$root\E}{} unless -f $js; + $md5 = md5($js); + } + $js =~ s{^\Q$root\E}{}; + my $data = [$js, "libjs-sphinxdoc (>= $version)"]; + $packaged_js{$md5} = $data; + $packaged_js{$jsname} = $data; + }, + no_chdir => 1 + }, $path); + map { error("$path/$_ is missing") } keys(%versions); + my %legacy_dependencies = ( + "/usr/share/javascript/jquery/jquery.js" => "libjs-jquery (>= 3.6.0)", + "/usr/share/javascript/jquery/jquery.min.js" => "libjs-jquery (>= 3.6.0)", + "/usr/share/javascript/underscore/underscore.js" => "libjs-underscore (>= 1.3.1)", + "/usr/share/javascript/underscore/underscore.min.js" => "libjs-underscore (>= 1.3.1)", + ); + while (my ($jsname, $dependency) = each %legacy_dependencies) + { + $packaged_js{md5($jsname)} = [$jsname, $dependency]; + $packaged_js{basename($jsname)} = [$jsname, $dependency]; + } +} + +sub looks_like_sphinx_doc($) +{ + my ($path) = @_; + return 0 unless -f "$path/searchindex.js"; + return 0 unless -f "$path/search.html"; + return 1; +} + +sub looks_like_sphinx_singlehtml_doc($) +{ + my ($path) = @_; + return 0 unless -d "$path/_static"; + return 0 if -f "$path/searchindex.js"; + + # There should be exactly one HTML file in singlehtml build. + my @html_files = glob("$path/*.html"); + my @sphinx_html_files; + foreach my $html_file (@html_files) + { + open(my $fh, '<', $html_file) or error("cannot open $html_file"); + while (my $line = <$fh>) + { + if ($line =~ //) + { + push @sphinx_html_files, $html_file; + last; + } + } + } + return 0 if @sphinx_html_files != 1; + return $sphinx_html_files[0]; +} + +sub sanity_check($$) +{ + local $/; + my ($path, $singlehtml_file) = @_; + my $searchfn; + my $index; + if ($singlehtml_file) + { + # There is no search.html in singlehtml build, so we take the main HTML + # file for sanity checking and retrieving JS files. + $searchfn = $singlehtml_file; + } + else + { + my $indexfn = "$path/searchindex.js"; + open(F, '<', $indexfn) or error("cannot open $indexfn"); + $index = ; + close(F); + $index =~ m{^Search[.]setIndex[(](.*)[)]$} or error("$indexfn doesn't look like a Sphinx search index"); + $index = decode_json($1); + $searchfn = "$path/search.html"; + } + open(F, '<', $searchfn) or error("cannot open $searchfn"); + my $search = ; + close F; + $search =~ s///g; # strip comments + my %js = (); + grep { + s/[?#].*//; + s/\s+$//; + $js{$_} = 1 unless m/^[a-z][a-z0-9.+-]*:/i or excludefile("$path/$_"); + } $search =~ m{}g; + my $documentation_options; + for my $line (split /^/, $search) + { + if ($line =~ "_static/documentation_options.js") + { + my $documentation_options_fn = "$path/_static/documentation_options.js"; + open(my $fh, '<', $documentation_options_fn) or error("cannot open $documentation_options_fn"); + $documentation_options = <$fh>; + close $fh; + } + if ($line =~ "var DOCUMENTATION_OPTIONS =") + { + $documentation_options = $search; + } + } + defined $documentation_options or error("DOCUMENTATION_OPTIONS not found"); + my $loads_searchindex = $search =~ m{}; + unless ($loads_searchindex) + { + # old style, used before Sphinx 2.0 + $loads_searchindex = $search =~ m/\QjQuery(function() { Search.loadIndex("\E/; + } + my ($has_source) = $documentation_options =~ m{HAS_SOURCE:\s*(true|false)}; + my ($sourcelink_suffix) = $documentation_options =~ m{SOURCELINK_SUFFIX:\s*'([^']*)'}; + $sourcelink_suffix = ".txt" unless defined $sourcelink_suffix; + my ($content_root) = $search =~ m{data-content_root="([^"]*)"}; + unless (defined $content_root) + { + # Support the way zzzeeksphinx is setting it. + ($content_root) = $search =~ m{document\.documentElement\.dataset\.content_root = '([^']*)';}; + } + unless (defined $content_root) + { + # We support fallback options using support_old_search_indexes.diff. + # Drop this block when that patch gets removed. + if ($documentation_options =~ /\QURL_ROOT: document.getElementById("documentation_options")\E/) + { + ($content_root) = $search =~ m{data-url_root="([^"]*)"}; + } + else + { + ($content_root) = $documentation_options =~ m{URL_ROOT:\s*'([^']*)'}; + } + } + %js or error("$searchfn does not include any JavaScript code"); + $singlehtml_file or $loads_searchindex or error("$searchfn does not load searchindex.js"); + defined $has_source or error("DOCUMENTATION_OPTIONS does not define HAS_SOURCE"); + defined $content_root or error("$searchfn top-level node does not have data-content_root attribute"); + $has_source = $has_source eq 'true'; + $content_root =~ m{^([a-z]+:/)?/} and error("content_root in $searchfn is not relative"); + for my $js (keys(%js)) + { + -f "$path/$js" or -l "$path/$js" or error("$path/$js is missing"); + } + unless ($singlehtml_file) + { + my $pages = $index->{"filenames"}; + for my $page (@$pages) + { + # Append sourcelink_suffix if the page name does not already end with it. + (my $sourcepage = $page) =~ s/(? 0 and @target > 0 or die; + if ($source[0] eq $target[0]) + { + # Make the symlink relative, as per Policy 10.5. + while (@source > 0 and @target > 0 and $source[0] eq $target[0]) + { + shift @source; + shift @target; + } + $target = ('../' x $#source) . join('/', @target); + } + else + { + # Keep the symlink absolute, as per Policy 10.5. + $target = $orig_target; + } + doit('ln', '-sf', $target, $orig_source); +} + +sub fix_symlinks($@) +{ + my %deps = (); + my ($path, @js) = @_; + for my $js (@js) + { + my $id = ''; + if (-l "$path/$js") + { + my $symlink_target = readlink("$path/$js"); + $symlink_target =~ m{/sphinxdoc/} and next; + $symlink_target =~ m{/javascript/\w+/(\w+)([.](min|lite|pack))?[.]js$} and $id = "$1.js"; + } + elsif (-f "$path/$js") + { + $id = md5("$path/$js"); + } + if (exists $packaged_js{$id}) + { + my ($target, $dependency) = @{$packaged_js{$id}}; + ln_sf($target, "$path/$js"); + $deps{$dependency} = 1; + } + else + { + unknown_javascript("$path/$js"); + } + } + return keys %deps; +} + +sub drop_cruft($) +{ + my ($path) = @_; + my $doctrees = "$path/.doctrees"; + my $buildinfo = "$path/.buildinfo"; + if (-d $doctrees and not excludefile($doctrees)) + { + doit('rm', '-rf', $doctrees); + } + if (-f $buildinfo and not excludefile($buildinfo)) + { + doit('rm', '-f', $buildinfo); + } + foreach my $js (@cruft_js) + { + my $js = "$path/_static/$js"; + if (-f $js and not excludefile($js)) + { + doit('rm', '-f', $js) if -f $js; + } + } +} + +sub process_rtd($) +{ + my ($path) = @_; + my $theme_is_rtd = 0; + if (-d "$path/_static/js" and -f "$path/_static/js/theme.js") + { + if (open(F, '<', "$path/_static/js/theme.js")) + { + while (my $line = ) { + if (index($line, "window.SphinxRtdTheme") != -1) + { + $theme_is_rtd = 1; + last; + } + } + close(F); + } + } + + my @deps; + my $target_dir = "/usr/share/sphinx_rtd_theme/static"; + if ($theme_is_rtd and -d $target_dir) + { + find({ + wanted => sub { + return if -d; + my $filename = $_; + substr($filename, 0, 1 + length $target_dir) = ""; + return unless -f "$path/_static/$filename"; + ln_sf($_, "$path/_static/$filename"); + }, + no_chdir => 1 + }, $target_dir); + + my $rtd_theme_version = get_installed_package_version("sphinx-rtd-theme-common"); + $rtd_theme_version =~ s/-[^-]+$//; # Remove the Debian version suffix + push @deps, "sphinx-rtd-theme-common (>= $rtd_theme_version)"; + } + return @deps; +} + +sub get_installed_package_version($) +{ + my ($package_name) = @_; + return `dpkg-query -W -f '\${Version}' $package_name 2>/dev/null`; +} + +sub list_built_using($) +{ + my ($path) = @_; + my @built_using; + my $sphinx_version = get_installed_package_version("sphinx-common"); + push @built_using, "sphinx (= $sphinx_version)"; + if (-d "$path/_static" and -f "$path/_static/alabaster.css") + { + my $alabaster_version = get_installed_package_version("python3-alabaster"); + if ($alabaster_version) + { + push @built_using, "alabaster (= $alabaster_version)"; + } + } + return @built_using; +} + +sub fix_sphinx_doc($$) +{ + my ($package, $path) = @_; + my $is_html = looks_like_sphinx_doc($path); + my $singlehtml_file = looks_like_sphinx_singlehtml_doc($path); + return 0 if not ($is_html or $singlehtml_file); + my @js = sanity_check($path, $singlehtml_file); + my @rtd_deps = process_rtd($path); + my @deps = fix_symlinks($path, @js); + my @built_using = list_built_using($path); + drop_cruft($path); + map { addsubstvar($package, "sphinxdoc:Depends", $_) } @deps; + map { addsubstvar($package, "sphinxdoc:Depends", $_) } @rtd_deps; + map { addsubstvar($package, "sphinxdoc:Built-Using", $_) } @built_using; + return 1; +} + +init(); + +load_packaged_js(); + +my @paths = @ARGV; +@paths = (undef) unless @paths; + +foreach my $path (@paths) +{ + my $done = 0; + my @matching_packages; + foreach my $package (@{$dh{DOPACKAGES}}) + { + my $pkgpath = tmpdir($package); + if (defined $path) + { + next if -l $path; + $pkgpath .= "/$path"; + next unless -d $pkgpath; + push @matching_packages, $package; + $done += fix_sphinx_doc($package, $pkgpath); + } + else + { + $pkgpath .= '/usr/share/doc/'; + next unless -d $pkgpath; + find({ + wanted => sub { + return unless -d; + return if -l; + return if excludefile($_); + $done += fix_sphinx_doc($package, $_); + }, + no_chdir => 1 + }, $pkgpath); + } + } + if ($done == 0) + { + if (defined $path) + { + if (!@matching_packages) + { + error("Path $path not found in any built package\n(searched in: @{$dh{DOPACKAGES}})"); + } + error("Sphinx documentation not found at $path\n(path found in packages: @matching_packages)"); + } + else + { + warning("Sphinx documentation not found"); + } + } +} + +=head1 SEE ALSO + +L, L. + +This program is meant to be used together with debhelper. + +=head1 AUTHOR + +Jakub Wilk + +=cut + +# vim:ts=4 sw=4 et diff --git a/debian/dh-sphinxdoc/empty.rst b/debian/dh-sphinxdoc/empty.rst new file mode 100644 index 0000000..e69de29 diff --git a/debian/dh-sphinxdoc/index b/debian/dh-sphinxdoc/index new file mode 100644 index 0000000..6217120 --- /dev/null +++ b/debian/dh-sphinxdoc/index @@ -0,0 +1,8 @@ +# [min-version] +1.0/doctools.js 5.2 +1.0/language_data.js 2.4.3-5~ +1.0/searchtools.js 7.2.2 +1.0/sidebar.js 5.0 +1.0/theme_extras.js 5.0 +1.0/css3-mediaqueries.js 1.3 +1.0/sphinx_highlight.js 7.2.2 diff --git a/debian/dh-sphinxdoc/install-js b/debian/dh-sphinxdoc/install-js new file mode 100755 index 0000000..cf4ceac --- /dev/null +++ b/debian/dh-sphinxdoc/install-js @@ -0,0 +1,22 @@ +#!/bin/sh + +set -e -u + +if [ $# -eq 0 ] +then + printf 'Usage: %s \n' "$0" >&2 + exit 1 +fi + +here="$(dirname "$0")" +rm -rf "$here/tmp/" +python3 ./sphinx/cmd/build.py -T -b html "$here" "$here/tmp" +cp -f "sphinx/themes/bizstyle/static/css3-mediaqueries.js" "$1" +cp -f "sphinx/themes/scrolls/static/theme_extras.js" "$1" +cp -f "$here/tmp/_static/doctools.js" "$1" +cp -f "$here/tmp/_static/language_data.js" "$1" +cp -f "$here/tmp/_static/sidebar.js" "$1" +cp -f "$here/tmp/_static/searchtools.js" "$1" +rm -rf "$here/tmp/" + +# vim:ts=4 sw=4 et diff --git a/debian/dh-sphinxdoc/sphinxdoc.pm b/debian/dh-sphinxdoc/sphinxdoc.pm new file mode 100644 index 0000000..3b777e3 --- /dev/null +++ b/debian/dh-sphinxdoc/sphinxdoc.pm @@ -0,0 +1,8 @@ +use warnings; +use strict; + +use Debian::Debhelper::Dh_Lib; + +insert_after('dh_installdocs', 'dh_sphinxdoc'); + +1; diff --git a/debian/gbp.conf b/debian/gbp.conf new file mode 100644 index 0000000..3879982 --- /dev/null +++ b/debian/gbp.conf @@ -0,0 +1,2 @@ +[DEFAULT] +debian-branch=debian/master diff --git a/debian/jstest/jstest.py b/debian/jstest/jstest.py new file mode 100644 index 0000000..42e7f36 --- /dev/null +++ b/debian/jstest/jstest.py @@ -0,0 +1,125 @@ +#!/usr/bin/python3 +# encoding=UTF-8 + +# Copyright © 2011 Jakub Wilk +# © 2013-2023 Dmitry Shachnev +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are +# met: +# +# * Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# +# * Redistributions in binary form must reproduce the above copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +import unittest + +from PyQt6.QtCore import QTimer, QUrl, QUrlQuery +from PyQt6.QtWidgets import QApplication +from PyQt6.QtWebEngineCore import QWebEnginePage +from PyQt6.QtWebEngineWidgets import QWebEngineView + +default_time_limit = 40_000 # msecs +timer_step = 1_000 # msecs + +# HTTP browser +# ============ + +class Page(QWebEnginePage): + def javaScriptConsoleMessage(self, level, message, lineNumber, sourceId): + print(f"[{level}] {sourceId}:{lineNumber}: {message}") + + +class View(QWebEngineView): + def __init__(self): + super().__init__() + self.result = None + self._page = Page(parent=self) + self._page.loadFinished.connect(self.onLoadFinished) + self.setPage(self._page) + self._timer = None + self._time_limit = default_time_limit + + def setResult(self, result): + self.result = result + + def onLoadFinished(self): + self._timer = QTimer(parent=self) + self._timer.timeout.connect(self.runJavaScript) + self._timer.start(timer_step) + + def runJavaScript(self): + if self._time_limit <= 0: + raise TimeoutError + script = """ + result = { + n_results: document.querySelector('#search-results > p').textContent.match(/found (\\d+) page/)[1], + n_links: document.querySelectorAll('#search-results a').length, + n_highlights: document.querySelectorAll('#search-results .highlighted').length, + }; + result + """ + self._page.runJavaScript(script, self.setResult) + self._time_limit -= timer_step + + def waitForResult(self): + app = QApplication.instance() + while self.result is None: + app.processEvents() + self._timer.stop() + + +# Actual tests +# ============ + +def test_html(result, options): + + class TestCase(unittest.TestCase): + + if options.n_results is not None: + def test_n_results(self): + n_results = int(result['n_results']) + self.assertEqual(n_results, options.n_results) + + if options.n_links is not None: + def test_n_links(self): + n_links = int(result['n_links']) + self.assertEqual(n_links, options.n_links) + + if options.n_highlights is not None: + def test_n_highlights(self): + n_highlights = int(result['n_highlights']) + self.assertEqual(n_highlights, options.n_highlights) + + TestCase.__name__ = 'TestCase(%r)' % options.search_term + + suite = unittest.TestLoader().loadTestsFromTestCase(TestCase) + return unittest.TextTestRunner(verbosity=2).run(suite) + +def test_directory(directory, options, time_limit=default_time_limit): + url = QUrl.fromLocalFile(f'{directory}/search.html') + query = QUrlQuery() + query.addQueryItem('q', options.search_term) + url.setQuery(query) + view = View() + view.load(url) + view.show() + view.waitForResult() + return test_html(view.result, options) + +# vim:ts=4 sw=4 et diff --git a/debian/jstest/run-tests b/debian/jstest/run-tests new file mode 100755 index 0000000..1285ccd --- /dev/null +++ b/debian/jstest/run-tests @@ -0,0 +1,40 @@ +#!/usr/bin/python3 + +import os +import sys + +import jstest + +from PyQt6.QtWidgets import QApplication + +class t1: + search_term = 'example' + n_results = 85 + n_links = 85 + n_highlights = 101 + +class t2: + search_term = 'examples' + n_results = 76 + n_links = 76 + n_highlights = 17 + +class t3: + search_term = 'graph' + n_results = 33 + n_links = 33 + n_highlights = 124 + +if __name__ == '__main__': + if not os.getenv('DISPLAY'): + raise RuntimeError('These tests require access to an X server') + app = QApplication(sys.argv) + [build_directory] = sys.argv[1:] + build_directory = os.path.abspath(build_directory) + n_failures = 0 + for testcase in t1, t2, t3: + failures = jstest.test_directory(build_directory, testcase).failures + n_failures += len(failures) + sys.exit(n_failures > 0) + +# vim:ts=4 sw=4 et diff --git a/debian/libjs-sphinxdoc.dirs b/debian/libjs-sphinxdoc.dirs new file mode 100644 index 0000000..60fd8e3 --- /dev/null +++ b/debian/libjs-sphinxdoc.dirs @@ -0,0 +1 @@ +/usr/share/javascript/sphinxdoc/1.0/ diff --git a/debian/libjs-sphinxdoc.install b/debian/libjs-sphinxdoc.install new file mode 100644 index 0000000..5eaa069 --- /dev/null +++ b/debian/libjs-sphinxdoc.install @@ -0,0 +1 @@ +debian/dh-sphinxdoc/index /usr/share/javascript/sphinxdoc/ diff --git a/debian/libjs-sphinxdoc.links b/debian/libjs-sphinxdoc.links new file mode 100644 index 0000000..bd6705b --- /dev/null +++ b/debian/libjs-sphinxdoc.links @@ -0,0 +1,2 @@ +/usr/share/javascript/jquery/jquery.js /usr/share/javascript/sphinxdoc/1.0/jquery.js +/usr/share/javascript/underscore/underscore.js /usr/share/javascript/sphinxdoc/1.0/underscore.js diff --git a/debian/patches/docutils_manpage_macros.diff b/debian/patches/docutils_manpage_macros.diff new file mode 100644 index 0000000..4bf22dc --- /dev/null +++ b/debian/patches/docutils_manpage_macros.diff @@ -0,0 +1,22 @@ +From: Dmitry Shachnev +Date: Thu, 3 Aug 2023 19:23:41 +0300 +Subject: Make test_build_manpage pass with docutils 0.19+dfsg-7 + +I backported the change from upstream 0.21 to our 0.19 and 0.20 packaging. +--- + tests/test_build_manpage.py | 2 +- + 1 file changed, 1 insertion(+), 1 deletion(-) + +diff --git a/tests/test_build_manpage.py b/tests/test_build_manpage.py +index e765644..2fc2014 100644 +--- a/tests/test_build_manpage.py ++++ b/tests/test_build_manpage.py +@@ -52,7 +52,7 @@ def test_captioned_code_block(app, status, warning): + app.builder.build_all() + content = (app.outdir / 'python.1').read_text(encoding='utf8') + +- if docutils.__version_info__[:2] < (0, 21): ++ if docutils.__version_info__[:2] < (0, 19): + expected = """\ + .sp + caption \\fItest\\fP rb diff --git a/debian/patches/intersphinx_local.diff b/debian/patches/intersphinx_local.diff new file mode 100644 index 0000000..1eff330 --- /dev/null +++ b/debian/patches/intersphinx_local.diff @@ -0,0 +1,51 @@ +From: Dmitry Shachnev +Date: Tue, 2 Jun 2020 12:22:52 +0300 +Subject: Use local intersphinx inventory + +To prevent Sphinx from downloading https://docs.python.org/3/objects.inv +during build. +--- + doc/conf.py | 5 ++--- + doc/tutorial/deploying.rst | 9 ++++++--- + 2 files changed, 8 insertions(+), 6 deletions(-) + +diff --git a/doc/conf.py b/doc/conf.py +index 416158f..a262354 100644 +--- a/doc/conf.py ++++ b/doc/conf.py +@@ -117,9 +117,8 @@ texinfo_documents = [ + ] + + intersphinx_mapping = { +- 'python': ('https://docs.python.org/3/', None), +- 'requests': ('https://requests.readthedocs.io/en/latest/', None), +- 'readthedocs': ('https://docs.readthedocs.io/en/stable', None), ++ 'python': ('/usr/share/doc/python3-doc/html', None), ++ 'requests': ('/usr/share/doc/python-requests-doc/html', None), + } + + # Sphinx document translation with sphinx gettext feature uses these settings: +diff --git a/doc/tutorial/deploying.rst b/doc/tutorial/deploying.rst +index e16abdf..1c4e3c6 100644 +--- a/doc/tutorial/deploying.rst ++++ b/doc/tutorial/deploying.rst +@@ -160,13 +160,16 @@ Read the Docs + ~~~~~~~~~~~~~ + + `Read the Docs`_ offers integration with both GitHub and GitLab. The quickest +-way of getting started is to follow :doc:`the RTD +-tutorial `, which is loosely based on this one. ++way of getting started is to follow `the RTD tutorial`_, which is loosely ++based on this one. + You can publish your sources on GitHub as explained :ref:`in the previous + section `, then skip directly to +-:ref:`readthedocs:tutorial/index:Sign up for Read the Docs`. ++`Sign up for Read the Docs`_. + If you choose GitLab instead, the process is similar. + ++.. _the RTD tutorial: https://docs.readthedocs.io/en/stable/tutorial/index.html ++.. _Sign up for Read the Docs: https://docs.readthedocs.io/en/stable/tutorial/index.html#sign-up-for-read-the-docs ++ + GitHub Pages + ~~~~~~~~~~~~ + diff --git a/debian/patches/move_sphinxcontrib_to_extras_require.diff b/debian/patches/move_sphinxcontrib_to_extras_require.diff new file mode 100644 index 0000000..9fa47ea --- /dev/null +++ b/debian/patches/move_sphinxcontrib_to_extras_require.diff @@ -0,0 +1,40 @@ +From: Dmitry Shachnev +Date: Fri, 7 Feb 2020 13:59:30 +0300 +Subject: Move sphinxcontrib modules to extras_require + +--- + pyproject.toml | 14 ++++++++------ + 1 file changed, 8 insertions(+), 6 deletions(-) + +diff --git a/pyproject.toml b/pyproject.toml +index 0a9bc9e..6383e31 100644 +--- a/pyproject.toml ++++ b/pyproject.toml +@@ -55,12 +55,6 @@ classifiers = [ + "Topic :: Utilities", + ] + dependencies = [ +- "sphinxcontrib-applehelp", +- "sphinxcontrib-devhelp", +- "sphinxcontrib-jsmath", +- "sphinxcontrib-htmlhelp>=2.0.0", +- "sphinxcontrib-serializinghtml>=1.1.9", +- "sphinxcontrib-qthelp", + "Jinja2>=3.0", + "Pygments>=2.14", + "docutils>=0.18.1,<0.21", +@@ -96,6 +90,14 @@ test = [ + "setuptools>=67.0", # for Cython compilation + "filelock", + ] ++sphinxcontrib = [ ++ "sphinxcontrib-applehelp", ++ "sphinxcontrib-devhelp", ++ "sphinxcontrib-jsmath", ++ "sphinxcontrib-htmlhelp>=2.0.0", ++ "sphinxcontrib-serializinghtml>=1.1.9", ++ "sphinxcontrib-qthelp", ++] + + [[project.authors]] + name = "Georg Brandl" diff --git a/debian/patches/no_external_css.diff b/debian/patches/no_external_css.diff new file mode 100644 index 0000000..697de83 --- /dev/null +++ b/debian/patches/no_external_css.diff @@ -0,0 +1,21 @@ +From: Chris Lamb +Date: Sat, 14 Apr 2018 10:10:45 +0100 +Subject: Don't use Google Fonts to avoid privacy breach. + +--- + sphinx/themes/pyramid/layout.html | 2 -- + 1 file changed, 2 deletions(-) + +diff --git a/sphinx/themes/pyramid/layout.html b/sphinx/themes/pyramid/layout.html +index ffa9313..19f351d 100644 +--- a/sphinx/themes/pyramid/layout.html ++++ b/sphinx/themes/pyramid/layout.html +@@ -1,8 +1,6 @@ + {%- extends "basic/layout.html" %} + + {%- block extrahead %} +- +- + diff --git a/debian/patches/python_3.11.7.diff b/debian/patches/python_3.11.7.diff new file mode 100644 index 0000000..02ed97f --- /dev/null +++ b/debian/patches/python_3.11.7.diff @@ -0,0 +1,77 @@ +From: Hugo van Kemenade +Date: Mon, 11 Dec 2023 12:01:55 +0200 +Subject: Fix autodoc tests for Python 3.11.7+ + +Origin: https://github.com/sphinx-doc/sphinx/pull/11793 +--- + tests/test_ext_autodoc_configs.py | 24 ++++++++++++++++++++---- + 1 file changed, 20 insertions(+), 4 deletions(-) + +diff --git a/tests/test_ext_autodoc_configs.py b/tests/test_ext_autodoc_configs.py +index 45bc729..2e8f40c 100644 +--- a/tests/test_ext_autodoc_configs.py ++++ b/tests/test_ext_autodoc_configs.py +@@ -1584,6 +1584,14 @@ def test_autodoc_typehints_format_fully_qualified_for_newtype_alias(app): + + @pytest.mark.sphinx('html', testroot='ext-autodoc') + def test_autodoc_default_options(app): ++ if ( ++ (3, 11, 7) <= sys.version_info < (3, 12) ++ or sys.version_info >= (3, 12, 1) ++ ): ++ list_of_weak_references = " list of weak references to the object" ++ else: ++ list_of_weak_references = " list of weak references to the object (if defined)" ++ + # no settings + actual = do_autodoc(app, 'class', 'target.enums.EnumCls') + assert ' .. py:attribute:: EnumCls.val1' not in actual +@@ -1627,7 +1635,7 @@ def test_autodoc_default_options(app): + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' in actual +- assert ' list of weak references to the object (if defined)' in actual ++ assert list_of_weak_references in actual + + # :exclude-members: None - has no effect. Unlike :members:, + # :special-members:, etc. where None == "include all", here None means +@@ -1651,13 +1659,21 @@ def test_autodoc_default_options(app): + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' in actual +- assert ' list of weak references to the object (if defined)' in actual ++ assert list_of_weak_references in actual + assert ' .. py:method:: CustomIter.snafucate()' in actual + assert ' Makes this snafucated.' in actual + + + @pytest.mark.sphinx('html', testroot='ext-autodoc') + def test_autodoc_default_options_with_values(app): ++ if ( ++ (3, 11, 7) <= sys.version_info < (3, 12) ++ or sys.version_info >= (3, 12, 1) ++ ): ++ list_of_weak_references = " list of weak references to the object" ++ else: ++ list_of_weak_references = " list of weak references to the object (if defined)" ++ + # with :members: + app.config.autodoc_default_options = {'members': 'val1,val2'} + actual = do_autodoc(app, 'class', 'target.enums.EnumCls') +@@ -1698,7 +1714,7 @@ def test_autodoc_default_options_with_values(app): + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' not in actual +- assert ' list of weak references to the object (if defined)' not in actual ++ assert list_of_weak_references not in actual + + # with :exclude-members: + app.config.autodoc_default_options = { +@@ -1722,6 +1738,6 @@ def test_autodoc_default_options_with_values(app): + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' not in actual +- assert ' list of weak references to the object (if defined)' not in actual ++ assert list_of_weak_references not in actual + assert ' .. py:method:: CustomIter.snafucate()' not in actual + assert ' Makes this snafucated.' not in actual diff --git a/debian/patches/remove_contrib_references.diff b/debian/patches/remove_contrib_references.diff new file mode 100644 index 0000000..8510649 --- /dev/null +++ b/debian/patches/remove_contrib_references.diff @@ -0,0 +1,79 @@ +From: Dmitry Shachnev +Date: Wed, 25 Dec 2019 23:18:56 +0300 +Subject: Remove references to sphinxcontrib modules + +They are not packaged yet, and when they are, we would want to avoid +dependency loops anyway. +--- + doc/usage/builders/index.rst | 24 ------------------------ + sphinx/application.py | 1 - + 2 files changed, 25 deletions(-) + +diff --git a/doc/usage/builders/index.rst b/doc/usage/builders/index.rst +index ce2c5dc..01172a7 100644 +--- a/doc/usage/builders/index.rst ++++ b/doc/usage/builders/index.rst +@@ -68,12 +68,6 @@ The builder's "name" must be given to the **-b** command-line option of + also generates HTML Help support files that allow the Microsoft HTML Help + Workshop to compile them into a CHM file. + +- .. autoattribute:: name +- +- .. autoattribute:: format +- +- .. autoattribute:: supported_image_types +- + .. module:: sphinxcontrib.qthelp + .. class:: QtHelpBuilder + +@@ -85,12 +79,6 @@ The builder's "name" must be given to the **-b** command-line option of + + Moved to sphinxcontrib.qthelp from sphinx.builders package. + +- .. autoattribute:: name +- +- .. autoattribute:: format +- +- .. autoattribute:: supported_image_types +- + .. _Qt help: https://doc.qt.io/qt-4.8/qthelp-framework.html + + .. module:: sphinxcontrib.applehelp +@@ -111,12 +99,6 @@ The builder's "name" must be given to the **-b** command-line option of + output will not be valid until :program:`hiutil` has been run on all of the + ``.lproj`` folders within the bundle. + +- .. autoattribute:: name +- +- .. autoattribute:: format +- +- .. autoattribute:: supported_image_types +- + .. versionadded:: 1.3 + + .. versionchanged:: 2.0 +@@ -130,12 +112,6 @@ The builder's "name" must be given to the **-b** command-line option of + also generates `GNOME Devhelp `__ + support file that allows the GNOME Devhelp reader to view them. + +- .. autoattribute:: name +- +- .. autoattribute:: format +- +- .. autoattribute:: supported_image_types +- + .. versionchanged:: 2.0 + + Moved to sphinxcontrib.devhelp from sphinx.builders package. +diff --git a/sphinx/application.py b/sphinx/application.py +index 73c157d..ebb47ca 100644 +--- a/sphinx/application.py ++++ b/sphinx/application.py +@@ -116,7 +116,6 @@ _first_party_themes = ( + 'alabaster', + ) + builtin_extensions += _first_party_themes +-builtin_extensions += _first_party_extensions + + ENV_PICKLE_FILENAME = 'environment.pickle' + diff --git a/debian/patches/series b/debian/patches/series new file mode 100644 index 0000000..fe0e669 --- /dev/null +++ b/debian/patches/series @@ -0,0 +1,11 @@ +skip_tests_network.diff +no_external_css.diff +remove_contrib_references.diff +skip_tests_jsmath.diff +use_packaged_mathjax.diff +skip_tests_serializinghtml.diff +move_sphinxcontrib_to_extras_require.diff +intersphinx_local.diff +support_old_search_indexes.diff +docutils_manpage_macros.diff +python_3.11.7.diff diff --git a/debian/patches/skip_tests_jsmath.diff b/debian/patches/skip_tests_jsmath.diff new file mode 100644 index 0000000..32647a4 --- /dev/null +++ b/debian/patches/skip_tests_jsmath.diff @@ -0,0 +1,36 @@ +From: Dmitry Shachnev +Date: Wed, 25 Dec 2019 23:37:50 +0300 +Subject: Skip tests that require sphinxcontrib.jsmath module + +--- + tests/test_build_html.py | 3 +++ + 1 file changed, 3 insertions(+) + +diff --git a/tests/test_build_html.py b/tests/test_build_html.py +index 07f101d..beef440 100644 +--- a/tests/test_build_html.py ++++ b/tests/test_build_html.py +@@ -1544,6 +1544,7 @@ def test_html_math_renderer_is_imgmath(app, status, warning): + assert app.builder.math_renderer_name == 'imgmath' + + ++@pytest.mark.skip('Requires sphinxcontrib.jsmath module') + @pytest.mark.sphinx('html', testroot='basic', + confoverrides={'extensions': ['sphinxcontrib.jsmath', + 'sphinx.ext.imgmath']}) +@@ -1564,6 +1565,7 @@ def test_html_math_renderer_is_duplicated2(app, status, warning): + assert app.builder.math_renderer_name == 'imgmath' # The another one is chosen + + ++@pytest.mark.skip('Requires sphinxcontrib.jsmath module') + @pytest.mark.sphinx('html', testroot='basic', + confoverrides={'extensions': ['sphinxcontrib.jsmath', + 'sphinx.ext.imgmath'], +@@ -1572,6 +1574,7 @@ def test_html_math_renderer_is_chosen(app, status, warning): + assert app.builder.math_renderer_name == 'imgmath' + + ++@pytest.mark.skip('Requires sphinxcontrib.jsmath module') + @pytest.mark.sphinx('html', testroot='basic', + confoverrides={'extensions': ['sphinxcontrib.jsmath', + 'sphinx.ext.mathjax'], diff --git a/debian/patches/skip_tests_network.diff b/debian/patches/skip_tests_network.diff new file mode 100644 index 0000000..60fe57c --- /dev/null +++ b/debian/patches/skip_tests_network.diff @@ -0,0 +1,21 @@ +From: Dmitry Shachnev +Date: Tue, 20 Dec 2016 16:37:32 +0300 +Subject: Skip tests that require network access + +Forwarded: not-needed +--- + tests/test_build_latex.py | 1 + + 1 file changed, 1 insertion(+) + +diff --git a/tests/test_build_latex.py b/tests/test_build_latex.py +index f6c3369..5996203 100644 +--- a/tests/test_build_latex.py ++++ b/tests/test_build_latex.py +@@ -1420,6 +1420,7 @@ def test_latex_raw_directive(app, status, warning): + assert 'LaTeX: abc def ghi' in result + + ++@pytest.mark.skip('Requires internet access') + @pytest.mark.sphinx('latex', testroot='images') + def test_latex_images(app, status, warning): + app.builder.build_all() diff --git a/debian/patches/skip_tests_serializinghtml.diff b/debian/patches/skip_tests_serializinghtml.diff new file mode 100644 index 0000000..b9401cc --- /dev/null +++ b/debian/patches/skip_tests_serializinghtml.diff @@ -0,0 +1,28 @@ +From: Dmitry Shachnev +Date: Thu, 6 Feb 2020 23:55:28 +0300 +Subject: Skip tests that require sphinxcontrib.serializinghtml module + +--- + tests/test_api_translator.py | 2 ++ + 1 file changed, 2 insertions(+) + +diff --git a/tests/test_api_translator.py b/tests/test_api_translator.py +index 2185fb8..66aa17f 100644 +--- a/tests/test_api_translator.py ++++ b/tests/test_api_translator.py +@@ -36,6 +36,7 @@ def test_singlehtml_set_translator_for_singlehtml(app, status, warning): + assert translator_class.__name__ == 'ConfSingleHTMLTranslator' + + ++@pytest.mark.skip('Requires sphinxcontrib.serializinghtml module') + @pytest.mark.sphinx('pickle', testroot='api-set-translator') + def test_pickle_set_translator_for_pickle(app, status, warning): + translator_class = app.builder.get_translator_class() +@@ -43,6 +44,7 @@ def test_pickle_set_translator_for_pickle(app, status, warning): + assert translator_class.__name__ == 'ConfPickleTranslator' + + ++@pytest.mark.skip('Requires sphinxcontrib.serializinghtml module') + @pytest.mark.sphinx('json', testroot='api-set-translator') + def test_json_set_translator_for_json(app, status, warning): + translator_class = app.builder.get_translator_class() diff --git a/debian/patches/support_old_search_indexes.diff b/debian/patches/support_old_search_indexes.diff new file mode 100644 index 0000000..450e5e8 --- /dev/null +++ b/debian/patches/support_old_search_indexes.diff @@ -0,0 +1,48 @@ +From: Dmitry Shachnev +Date: Sat, 11 Dec 2021 19:19:27 +0300 +Subject: Make searchtools.js support documentation built with old Sphinx + +Sphinx 4.3 has changed format of searchindex.js files, but in Debian +there are lots of packages built with older Sphinx, and we want to +keep them working for some time. + +Also support legacy custom search.html templates, which don't have +data-content_root attribute on the top-level element. + +Forwarded: not-needed +--- + sphinx/themes/basic/static/searchtools.js | 12 ++++++++---- + 1 file changed, 8 insertions(+), 4 deletions(-) + +diff --git a/sphinx/themes/basic/static/searchtools.js b/sphinx/themes/basic/static/searchtools.js +index 7918c3f..09d6458 100644 +--- a/sphinx/themes/basic/static/searchtools.js ++++ b/sphinx/themes/basic/static/searchtools.js +@@ -62,7 +62,8 @@ const _displayItem = (item, searchTerms, highlightTerms) => { + const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX; + const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX; + const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY; +- const contentRoot = document.documentElement.dataset.content_root; ++ const contentRoot = document.documentElement.dataset.content_root ++ ?? DOCUMENTATION_OPTIONS.URL_ROOT; + + const [docName, title, anchor, descr, score, _filename] = item; + +@@ -434,11 +435,14 @@ const Search = { + filenames[match[0]], + ]); + }; +- Object.keys(objects).forEach((prefix) => ++ Object.keys(objects).forEach((prefix) => { ++ if (!(objects[prefix] instanceof Array)) { ++ objects[prefix] = Object.entries(objects[prefix]).map(([name, match]) => [...match, name]); ++ } + objects[prefix].forEach((array) => + objectSearchCallback(prefix, array) +- ) +- ); ++ ); ++ }); + return results; + }, + diff --git a/debian/patches/use_packaged_mathjax.diff b/debian/patches/use_packaged_mathjax.diff new file mode 100644 index 0000000..28405ca --- /dev/null +++ b/debian/patches/use_packaged_mathjax.diff @@ -0,0 +1,20 @@ +From: Dmitry Shachnev +Date: Tue, 4 Feb 2020 00:12:18 +0300 +Subject: Use packaged MathJax (for our own documentation) + +--- + doc/conf.py | 1 + + 1 file changed, 1 insertion(+) + +diff --git a/doc/conf.py b/doc/conf.py +index d4915aa..416158f 100644 +--- a/doc/conf.py ++++ b/doc/conf.py +@@ -185,6 +185,7 @@ nitpick_ignore = { + ('std:confval', 'globaltoc_maxdepth'), + } + ++mathjax_path = 'file:///usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML' + + # -- Extension interface ------------------------------------------------------- + diff --git a/debian/python3-sphinx.install b/debian/python3-sphinx.install new file mode 100644 index 0000000..fbf38fe --- /dev/null +++ b/debian/python3-sphinx.install @@ -0,0 +1,2 @@ +/usr/bin +/usr/lib/python3.*/dist-packages/ diff --git a/debian/python3-sphinx.links b/debian/python3-sphinx.links new file mode 100644 index 0000000..13b1376 --- /dev/null +++ b/debian/python3-sphinx.links @@ -0,0 +1,4 @@ +usr/bin/sphinx-apidoc usr/share/sphinx/scripts/python3/sphinx-apidoc +usr/bin/sphinx-autogen usr/share/sphinx/scripts/python3/sphinx-autogen +usr/bin/sphinx-build usr/share/sphinx/scripts/python3/sphinx-build +usr/bin/sphinx-quickstart usr/share/sphinx/scripts/python3/sphinx-quickstart diff --git a/debian/python3-sphinx.preinst b/debian/python3-sphinx.preinst new file mode 100644 index 0000000..b4b7bd6 --- /dev/null +++ b/debian/python3-sphinx.preinst @@ -0,0 +1,13 @@ +#!/bin/sh + +set -e + +if [ "$1" = upgrade ] && dpkg --compare-versions "$2" lt 2.4.3-3~ +then + for exe in /usr/share/sphinx/scripts/python3/* + do + update-alternatives --remove ${exe##*/} $exe + done +fi + +#DEBHELPER# diff --git a/debian/python3-sphinx.pyremove b/debian/python3-sphinx.pyremove new file mode 100644 index 0000000..cf9e72b --- /dev/null +++ b/debian/python3-sphinx.pyremove @@ -0,0 +1 @@ +sphinx/locale/.tx/ diff --git a/debian/rules b/debian/rules new file mode 100755 index 0000000..0a40e5d --- /dev/null +++ b/debian/rules @@ -0,0 +1,82 @@ +#!/usr/bin/make -f +# -*- makefile -*- + +export NO_PKG_MANGLE=1 +export LC_ALL=C.UTF-8 +export PYTHONWARNINGS=d + +export PYBUILD_TEST_ARGS=--verbose --ignore tests/test_api_translator.py + +locales = $(notdir $(patsubst %/LC_MESSAGES,%,$(wildcard sphinx/locale/*/LC_MESSAGES))) + +debroot = debian/tmp/ +py3_libdir = /usr/lib/$(shell py3versions -d)/dist-packages +py3_builddir = $(shell pybuild --print build_dir --interpreter python3) +javascript_path = /usr/share/javascript/sphinxdoc/1.0/ + +%: + dh $@ --with python3 --buildsystem=pybuild + +override_dh_auto_build: + dh_auto_build +ifeq "$(filter nodoc,$(DEB_BUILD_OPTIONS))" "" + PYTHONPATH=$(py3_builddir) python3 ./sphinx/cmd/build.py -T doc build/html/ + find build/html/ -name '*.txt' -or -name '*.html' | xargs -L1 sed -i \ + 's!http://docutils.sourceforge.net/docs/!file:///usr/share/doc/docutils-doc/docs/!g' + PYTHONPATH=$(py3_builddir) python3 ./sphinx/cmd/build.py -T -b man doc build/man +endif + PYTHONPATH=$(py3_builddir) python3 ./utils/babel_runner.py compile + +override_dh_auto_install: + pybuild --install -p $(shell py3versions -vd) + # move static files outside dist-packages + sed -i -e "s!^package_dir = .*!package_dir = '/usr/share/sphinx'!" \ + $(debroot)$(py3_libdir)/sphinx/__init__.py + mkdir -p $(debroot)/usr/share/sphinx + cd $(debroot) && mv -t usr/share/sphinx/ \ + .$(py3_libdir)/sphinx/templates \ + .$(py3_libdir)/sphinx/texinputs \ + .$(py3_libdir)/sphinx/themes + mkdir -p $(debroot)/usr/share/sphinx/ext/autosummary/ + cd $(debroot) && mv -t usr/share/sphinx/ext/autosummary/ \ + .$(py3_libdir)/sphinx/ext/autosummary/templates + mkdir -p $(debroot)/usr/share/sphinx/search/ + cd $(debroot) && mv -t usr/share/sphinx/search/ \ + .$(py3_libdir)/sphinx/search/minified-js \ + .$(py3_libdir)/sphinx/search/non-minified-js + set -e -x; \ + cd $(debroot) && \ + for lang in $(locales); \ + do \ + install -m 644 -D $(CURDIR)/sphinx/locale/$$lang/LC_MESSAGES/sphinx.js \ + usr/share/sphinx/locale/$$lang/sphinx.js; \ + install -m 644 -D $(CURDIR)/sphinx/locale/$$lang/LC_MESSAGES/sphinx.mo \ + usr/share/locale/$$lang/LC_MESSAGES/sphinx.mo; \ + done + cd $(debroot)$(py3_libdir)/sphinx/locale && rm -rf sphinx.pot */ + # Move JavaScript code to libjs-sphinxdoc: + PYTHONPATH=$(py3_builddir) debian/dh-sphinxdoc/install-js debian/libjs-sphinxdoc$(javascript_path) + rm -f $(debroot)/usr/share/sphinx/themes/bizstyle/static/css3-mediaqueries_src.js + set -e; \ + for js in $$(find $(debroot)/usr/share/sphinx/themes/ -name '*.js' -a '!' -name 'websupport.js'); do \ + mv $$js debian/libjs-sphinxdoc/$(javascript_path); \ + ln -sf "$(javascript_path)/$${js##*/}" $$js; \ + done + +override_dh_installchangelogs: + dh_installchangelogs CHANGES + +override_dh_installdocs: + dh_installdocs +ifeq "$(filter nodoc,$(DEB_BUILD_OPTIONS))" "" + ./debian/dh-sphinxdoc/dh_sphinxdoc -p sphinx-doc /usr/share/doc/sphinx-doc/html/ +endif + +override_dh_installman: + cd debian/dh-sphinxdoc/ && pod2man -c Debhelper -r '' dh_sphinxdoc dh_sphinxdoc.1 +ifeq "$(filter nodoc,$(DEB_BUILD_OPTIONS))" "" + dh_installman +endif + +override_dh_compress: + dh_compress -X.py -X.rst -X.json -X.txt diff --git a/debian/source/format b/debian/source/format new file mode 100644 index 0000000..163aaf8 --- /dev/null +++ b/debian/source/format @@ -0,0 +1 @@ +3.0 (quilt) diff --git a/debian/source/lintian-overrides b/debian/source/lintian-overrides new file mode 100644 index 0000000..1293ae5 --- /dev/null +++ b/debian/source/lintian-overrides @@ -0,0 +1,8 @@ +# Generated from the .po files using ‘setup.py compile_catalog’ +sphinx source: source-is-missing [sphinx/locale/*/LC_MESSAGES/sphinx.js] + +# Non-minified version is available in css3-mediaqueries_src.js +sphinx source: source-is-missing [sphinx/themes/bizstyle/static/css3-mediaqueries.js] + +# Non-minified versions are available in sphinx/search/non-minified-js/* +sphinx source: source-is-missing [sphinx/search/minified-js/*] diff --git a/debian/source/options b/debian/source/options new file mode 100644 index 0000000..b5dbec1 --- /dev/null +++ b/debian/source/options @@ -0,0 +1,2 @@ +extend-diff-ignore = "^[^/]*[.]egg-info/" +extend-diff-ignore = "^sphinx/locale/[^/]+/LC_MESSAGES/" diff --git a/debian/sphinx-common.install b/debian/sphinx-common.install new file mode 100644 index 0000000..a52bbe6 --- /dev/null +++ b/debian/sphinx-common.install @@ -0,0 +1,9 @@ +/usr/share/locale/ +/usr/share/sphinx/ext/ +/usr/share/sphinx/locale/ +/usr/share/sphinx/search/ +/usr/share/sphinx/templates/ +/usr/share/sphinx/texinputs/ +/usr/share/sphinx/themes/ +debian/dh-sphinxdoc/dh_sphinxdoc /usr/bin/ +debian/dh-sphinxdoc/sphinxdoc.pm /usr/share/perl5/Debian/Debhelper/Sequence/ diff --git a/debian/sphinx-common.lintian-overrides b/debian/sphinx-common.lintian-overrides new file mode 100644 index 0000000..56becc8 --- /dev/null +++ b/debian/sphinx-common.lintian-overrides @@ -0,0 +1,3 @@ +# sphinx-common postinst must not be run if old version on python-sphinx is +# even unpacked. +sphinx-common: conflicts-with-version python-sphinx (<< 1.1) diff --git a/debian/sphinx-common.manpages b/debian/sphinx-common.manpages new file mode 100644 index 0000000..c0ddd4b --- /dev/null +++ b/debian/sphinx-common.manpages @@ -0,0 +1,5 @@ +build/man/sphinx-apidoc.1 +build/man/sphinx-autogen.1 +build/man/sphinx-build.1 +build/man/sphinx-quickstart.1 +debian/dh-sphinxdoc/dh_sphinxdoc.1 diff --git a/debian/sphinx-doc.doc-base b/debian/sphinx-doc.doc-base new file mode 100644 index 0000000..8af0b37 --- /dev/null +++ b/debian/sphinx-doc.doc-base @@ -0,0 +1,12 @@ +Document: sphinx-manual +Title: Sphinx documentation builder manual +Author: Georg Brandl +Abstract: Sphinx is a tool that translates a set of reStructuredText source + files into various output formats, automatically producing cross-references, + indices etc. It can also generate a LaTeX file that you can compile into a PDF + version of the documents. +Section: Text + +Format: HTML +Index: /usr/share/doc/sphinx-doc/html/index.html +Files: /usr/share/doc/sphinx-doc/html/* diff --git a/debian/sphinx-doc.docs b/debian/sphinx-doc.docs new file mode 100644 index 0000000..79c4f46 --- /dev/null +++ b/debian/sphinx-doc.docs @@ -0,0 +1,3 @@ +AUTHORS +README.rst +build/html diff --git a/debian/sphinx-doc.links b/debian/sphinx-doc.links new file mode 100644 index 0000000..afafcca --- /dev/null +++ b/debian/sphinx-doc.links @@ -0,0 +1,3 @@ +/usr/share/doc/sphinx-doc/html/ /usr/share/doc/python3-sphinx/html +/usr/share/doc/sphinx-doc/html/_sources/ /usr/share/doc/sphinx-doc/rst +/usr/share/doc/sphinx-doc/rst/ /usr/share/doc/python3-sphinx/rst diff --git a/debian/sphinx-doc.lintian-overrides b/debian/sphinx-doc.lintian-overrides new file mode 100644 index 0000000..ea525bc --- /dev/null +++ b/debian/sphinx-doc.lintian-overrides @@ -0,0 +1,4 @@ +# As per policy 6.6, dpkg cannot replace a directory (shipped in +# python-sphinx << 1.1) with a symlink to directory (shipped in +# sphinx-doc). +sphinx-doc: conflicts-with-version python-sphinx (<< 1.1) diff --git a/debian/tests/control b/debian/tests/control new file mode 100644 index 0000000..3e6c688 --- /dev/null +++ b/debian/tests/control @@ -0,0 +1,27 @@ +Tests: python3-sphinx +Depends: dvipng, + fonts-freefont-otf, + graphviz, + imagemagick-6.q16, + librsvg2-bin, + python3-all, + python3-filelock, + python3-html5lib, + python3-pytest, + python3-setuptools, + python3-sphinx, + python3-sphinxcontrib.websupport, + python3-sqlalchemy (>= 0.9), + python3-whoosh, + python3-xapian, + tex-gyre, + texinfo, + texlive-fonts-recommended, + texlive-latex-extra, + texlive-luatex, + texlive-xetex + +Tests: sphinx-doc +Depends: python3-pyqt6.qtwebengine, sphinx-doc, xauth, xvfb +Restrictions: allow-stderr +Architecture: amd64 i386 diff --git a/debian/tests/python3-sphinx b/debian/tests/python3-sphinx new file mode 100755 index 0000000..581df90 --- /dev/null +++ b/debian/tests/python3-sphinx @@ -0,0 +1,10 @@ +#!/bin/sh +set -e -u +cp -r tests "$AUTOPKGTEST_TMP/" +cd "$AUTOPKGTEST_TMP" +py3versions -s \ +| tr ' ' '\n' \ +| xargs -I {} env PYTHONWARNINGS=d PYTHONHASHSEED=random {} \ + -m pytest -vv 2>&1 + +# vim:ts=4 sw=4 et diff --git a/debian/tests/sphinx-doc b/debian/tests/sphinx-doc new file mode 100644 index 0000000..e86b74d --- /dev/null +++ b/debian/tests/sphinx-doc @@ -0,0 +1,18 @@ +#!/bin/sh +set -e -u + +cp -r debian/jstest "$AUTOPKGTEST_TMP/" +cd "$AUTOPKGTEST_TMP" +for format in rst html +do + [ "$(readlink -f /usr/share/doc/python3-sphinx/$format)" = "$(readlink -f /usr/share/doc/sphinx-doc/$format)" ] +done +run_js_tests='jstest/run-tests /usr/share/doc/sphinx-doc/html/' +if [ -n "${DISPLAY:-}" ] +then + $run_js_tests +else + xvfb-run -a $run_js_tests +fi + +# vim:ts=4 sw=4 et diff --git a/debian/upstream/metadata b/debian/upstream/metadata new file mode 100644 index 0000000..ded997a --- /dev/null +++ b/debian/upstream/metadata @@ -0,0 +1,5 @@ +Bug-Database: https://github.com/sphinx-doc/sphinx/issues +Bug-Submit: https://github.com/sphinx-doc/sphinx/issues/new +Documentation: https://www.sphinx-doc.org/en/master/ +Repository: https://github.com/sphinx-doc/sphinx.git +Repository-Browse: https://github.com/sphinx-doc/sphinx diff --git a/debian/watch b/debian/watch new file mode 100644 index 0000000..b9c0dfb --- /dev/null +++ b/debian/watch @@ -0,0 +1,2 @@ +version=4 +https://pypi.debian.net/Sphinx/[Ss]phinx-([\d.]+)\.tar\.gz -- cgit v1.2.3