[Reproducible-commits] [sphinx] 02/03: imported from sphinx_1.2.3+dfsg-1.debian.tar.xz
Holger Levsen
holger at moszumanska.debian.org
Mon Mar 23 12:53:44 UTC 2015
This is an automated email from the git hooks/post-receive script.
holger pushed a commit to branch pu/reproducible_builds
in repository sphinx.
commit 97f2e189d9057cafd46b7ff669f042f47e72350d
Author: Holger Levsen <holger at layer-acht.org>
Date: Mon Mar 23 13:50:38 2015 +0100
imported from sphinx_1.2.3+dfsg-1.debian.tar.xz
---
debian/changelog | 769 +++++++++++++++++++++++++++
debian/clean | 4 +
debian/compat | 1 +
debian/control | 121 +++++
debian/copyright | 254 +++++++++
debian/dh-sphinxdoc/conf.py | 2 +
debian/dh-sphinxdoc/dh_sphinxdoc | 390 ++++++++++++++
debian/dh-sphinxdoc/empty.rst | 0
debian/dh-sphinxdoc/index | 7 +
debian/dh-sphinxdoc/install-js | 21 +
debian/dh-sphinxdoc/sphinxdoc.pm | 8 +
debian/get-orig-source.sh | 27 +
debian/jstest/jstest.py | 146 +++++
debian/jstest/run-tests | 37 ++
debian/libjs-sphinxdoc.dirs | 1 +
debian/libjs-sphinxdoc.install | 1 +
debian/libjs-sphinxdoc.links | 2 +
debian/patches/disable_distribute_setup.diff | 15 +
debian/patches/fix_latex_hlines.diff | 32 ++
debian/patches/initialize_autodoc.diff | 33 ++
debian/patches/no_external_css.diff | 27 +
debian/patches/parallel_2to3.diff | 31 ++
debian/patches/python3_test_build_dir.diff | 30 ++
debian/patches/series | 6 +
debian/python-sphinx.docs | 2 +
debian/python-sphinx.install | 2 +
debian/python3-sphinx.install | 2 +
debian/rules | 160 ++++++
debian/source/format | 1 +
debian/source/include-binaries | 1 +
debian/source/lintian-overrides | 2 +
debian/source/options | 2 +
debian/sphinx-autogen.1 | 45 ++
debian/sphinx-common.install | 4 +
debian/sphinx-common.lintian-overrides | 3 +
debian/sphinx-common.manpages | 5 +
debian/sphinx-common.postinst.in | 29 +
debian/sphinx-common.prerm.in | 13 +
debian/sphinx-common.triggers | 1 +
debian/sphinx-doc.doc-base | 12 +
debian/sphinx-doc.docs | 3 +
debian/sphinx-doc.links | 5 +
debian/sphinx-doc.lintian-overrides | 4 +
debian/tests/control | 8 +
debian/tests/python-sphinx | 10 +
debian/tests/python3-sphinx | 11 +
debian/tests/sphinx-doc | 20 +
debian/upstream-signing-key.pgp | Bin 0 -> 2897 bytes
debian/watch | 3 +
49 files changed, 2313 insertions(+)
diff --git a/debian/changelog b/debian/changelog
new file mode 100644
index 0000000..4067e21
--- /dev/null
+++ b/debian/changelog
@@ -0,0 +1,769 @@
+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 <mitya57 at debian.org> 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 <mitya57 at debian.org> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <mitya57 at gmail.com> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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
+ <http://deb.li/H8ED> and <http://deb.li/3Rw0z>).
+
+ -- Jakub Wilk <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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<item> should now exclude a file if <item> 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 <jwilk at debian.org> 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 <jwilk at debian.org> Sun, 20 Nov 2011 15:56:50 +0100
+
+sphinx (1.0.8+dfsg-2) unstable; urgency=low
+
+ * Upload to unstable.
+
+ -- Jakub Wilk <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <jwilk at debian.org> 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 <python-modules-team at lists.alioth.debian.org> 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 <python-modules-team at lists.alioth.debian.org> 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 <python-modules-team at lists.alioth.debian.org> 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 <dottedmag at dottedmag.net> 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 <dottedmag at dottedmag.net> 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 <python-modules-team at lists.alioth.debian.org> 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 <dottedmag at dottedmag.net> 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 <python-modules-team at lists.alioth.debian.org> Thu, 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 <python-modules-team at lists.alioth.debian.org> 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 <python-modules-team at lists.alioth.debian.org> 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 <python-modules-team at lists.alioth.debian.org> 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 <python-modules-team at lists.alioth.debian.org> 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 <dottedmag at dottedmag.net> 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 <dottedmag at dottedmag.net> 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 <dottedmag at dottedmag.net> 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 <dottedmag at dottedmag.net> Mon, 23 Jun 2008 19:31:00 +0700
+
+sphinx (0.3-2) unstable; urgency=medium
+
+ * Added missing python-docutils dependency (Closes: #482916).
+
+ -- Mikhail Gusarov <dottedmag at dottedmag.net> 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 <dottedmag at dottedmag.net> 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 <dottedmag at dottedmag.net> 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 <dottedmag at dottedmag.net> Sun, 20 Apr 2008 23:01:50 +0200
diff --git a/debian/clean b/debian/clean
new file mode 100644
index 0000000..298df6d
--- /dev/null
+++ b/debian/clean
@@ -0,0 +1,4 @@
+debian/dh-sphinxdoc/*.1
+sphinx/pycode/*.pickle
+sphinx/themes/basic/static/jquery.js
+sphinx/themes/basic/static/underscore.js
diff --git a/debian/compat b/debian/compat
new file mode 100644
index 0000000..ec63514
--- /dev/null
+++ b/debian/compat
@@ -0,0 +1 @@
+9
diff --git a/debian/control b/debian/control
new file mode 100644
index 0000000..b080081
--- /dev/null
+++ b/debian/control
@@ -0,0 +1,121 @@
+Source: sphinx
+Section: python
+Priority: optional
+Maintainer: Debian Python Modules Team <python-modules-team at lists.alioth.debian.org>
+Uploaders: Dmitry Shachnev <mitya57 at debian.org>
+Homepage: http://sphinx-doc.org/
+Build-Depends: debhelper (>= 9)
+Build-Depends-Indep: dh-python,
+ python-all (>= 2.6.6-3~), python3-all (>= 3.1.2-7~),
+ python-setuptools (>= 0.6c5-1~), python3-setuptools,
+ python-docutils (>= 0.7), python3-docutils (>= 0.7),
+ python-pygments (>= 1.2), python3-pygments (>= 1.2),
+ python-jinja2 (>= 2.3), python3-jinja2 (>= 2.3),
+ python-sqlalchemy, python3-sqlalchemy,
+ python-whoosh, python3-whoosh,
+ python-xapian,
+ python-nose, python3-nose,
+ python-babel,
+ xvfb, xauth, libjs-jquery (>= 1.4), libjs-underscore,
+ python3-gi, gir1.2-webkit-3.0,
+ texlive-latex-recommended, texlive-latex-extra, texlive-fonts-recommended, texinfo,
+ perl
+X-Python-Version: >= 2.5
+X-Python3-Version: >= 3.1
+XS-Testsuite: autopkgtest
+Standards-Version: 3.9.5
+Vcs-Svn: svn://anonscm.debian.org/python-modules/packages/sphinx/trunk/
+Vcs-Browser: http://anonscm.debian.org/viewvc/python-modules/packages/sphinx/trunk/
+
+Package: python-sphinx
+Architecture: all
+Depends: ${misc:Depends}, ${python:Depends},
+ python-docutils (>= 0.7),
+ python-pygments (>= 1.2),
+ python-jinja2 (>= 2.3),
+ sphinx-common (= ${source:Version})
+Recommends: python-pil,
+ sphinx-doc
+Suggests:
+ libjs-mathjax, dvipng,
+ texlive-latex-recommended, texlive-latex-extra, texlive-fonts-recommended
+Breaks:
+ python-sphinxcontrib.issuetracker (<< 0.11-1),
+ python-sphinxcontrib.spelling (<< 2.1.1-1)
+Description: documentation generator for Python projects (implemented in Python 2)
+ 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.
+ .
+ This package includes Python 2 modules and command line utilities.
+
+Package: python3-sphinx
+Architecture: all
+Depends: ${misc:Depends}, ${python3:Depends},
+ python3-docutils (>= 0.7),
+ python3-pygments (>= 1.2),
+ python3-jinja2 (>= 2.3),
+ sphinx-common (= ${source:Version})
+Recommends: python3-pil
+Suggests:
+ libjs-mathjax, dvipng,
+ texlive-latex-recommended, texlive-latex-extra, texlive-fonts-recommended,
+ sphinx-doc
+Description: documentation generator for Python projects (implemented in Python 3)
+ 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.
+ .
+ This package includes Python 3 modules.
+
+Package: sphinx-common
+Architecture: all
+Depends: ${misc:Depends},
+ libjs-sphinxdoc (= ${source:Version})
+Recommends: python-sphinx | python3-sphinx
+Conflicts: python-sphinx (<< 1.1)
+Replaces: python-sphinx (<< 1.1)
+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
+Section: doc
+Architecture: all
+Conflicts: python-sphinx (<< 1.1)
+Replaces: python-sphinx (<< 1.1)
+Depends: docutils-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: web
+Architecture: all
+Depends: ${misc:Depends}, libjs-jquery (>= 1.4), libjs-underscore
+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..bda7d82
--- /dev/null
+++ b/debian/copyright
@@ -0,0 +1,254 @@
+This package was first debianized by Mikhail Gusarov <dottedmag at dottedmag.net>
+on Mon, 08 Apr 2008 01:52:52 +0600
+
+It was downloaded from http://sphinx.pocoo.org/
+
+Copyright Holders: Georg Brandl <georg at python.org>, Armin Ronacher
+<armin.ronacher at active-4.com>, Josip Dzolonga, Gerold Penz, Vivake Gupta
+<v at nano.com>
+
+License for Sphinx
+==================
+
+Copyright (c) 2007-2013 by the Sphinx team (see AUTHORS file).
+All rights reserved.
+
+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.
+
+Licenses for incorporated software
+==================================
+
+The pgen2 package, included in this distribution under the name
+sphinx.pycode.pgen2, is available in the Python 2.6 distribution under
+the PSF license agreement for Python:
+
+| Copyright © 2001-2008 Python Software Foundation; All Rights Reserved.
+|
+| PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
+| --------------------------------------------
+|
+| 1. This LICENSE AGREEMENT is between the Python Software Foundation
+| ("PSF"), and the Individual or Organization ("Licensee") accessing
+| and otherwise using Python 2.6 software in source or binary form
+| and its associated documentation.
+|
+| 2. Subject to the terms and conditions of this License Agreement, PSF
+| hereby grants Licensee a nonexclusive, royalty-free, world-wide
+| license to reproduce, analyze, test, perform and/or display
+| publicly, prepare derivative works, distribute, and otherwise use
+| Python 2.6 alone or in any derivative version, provided, however,
+| that PSF's License Agreement and PSF's notice of copyright, i.e.,
+| "Copyright © 2001-2008 Python Software Foundation; All Rights
+| Reserved" are retained in Python 2.6 alone or in any derivative
+| version prepared by Licensee.
+|
+| 3. In the event Licensee prepares a derivative work that is based on
+| or incorporates Python 2.6 or any part thereof, and wants to make
+| the derivative work available to others as provided herein, then
+| Licensee hereby agrees to include in any such work a brief summary
+| of the changes made to Python 2.6.
+|
+| 4. PSF is making Python 2.6 available to Licensee on an "AS IS" basis.
+| PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY
+| WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY
+| REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY
+| PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 2.6 WILL NOT INFRINGE
+| ANY THIRD PARTY RIGHTS.
+|
+| 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
+| 2.6 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS
+| AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON
+| 2.6, OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY
+| THEREOF.
+|
+| 6. This License Agreement will automatically terminate upon a material
+| breach of its terms and conditions.
+|
+| 7. Nothing in this License Agreement shall be deemed to create any
+| relationship of agency, partnership, or joint venture between PSF
+| and Licensee. This License Agreement does not grant permission to
+| use PSF trademarks or trade name in a trademark sense to endorse or
+| promote products or services of Licensee, or any third party.
+|
+| 8. By copying, installing or otherwise using Python 2.6, Licensee
+| agrees to be bound by the terms and conditions of this License
+| Agreement.
+
+The included smartypants module, included as sphinx.util.smartypants,
+is available under the following license:
+
+| SmartyPants license::
+|
+| Copyright (c) 2003 John Gruber
+| (http://daringfireball.net/)
+| All rights reserved.
+|
+| 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 "SmartyPants" 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 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.
+|
+|
+| smartypants.py license::
+|
+| smartypants.py is a derivative work of SmartyPants.
+|
+| 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.
+
+The ElementTree package, included in this distribution in
+test/etree13, is available under the following license:
+
+| The ElementTree toolkit is
+|
+| Copyright (c) 1999-2007 by Fredrik Lundh
+|
+| By obtaining, using, and/or copying this software and/or its
+| associated documentation, you agree that you have read, understood,
+| and will comply with the following terms and conditions:
+|
+| Permission to use, copy, modify, and distribute this software and its
+| associated documentation for any purpose and without fee is hereby
+| granted, provided that the above copyright notice appears in all
+| copies, and that both that copyright notice and this permission notice
+| appear in supporting documentation, and that the name of Secret Labs
+| AB or the author not be used in advertising or publicity pertaining to
+| distribution of the software without specific, written prior
+| permission.
+|
+| SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO
+| THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT- ABILITY
+| AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE
+| FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+| WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+| ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+| OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+AUTHORS file
+============
+
+Sphinx is written and maintained by Georg Brandl <georg at python.org>.
+
+Substantial parts of the templates were written by Armin Ronacher
+<armin.ronacher at active-4.com>.
+
+Other contributors, listed alphabetically, are:
+
+* Andi Albrecht -- agogo theme
+* Henrique Bastos -- SVG support for graphviz extension
+* Daniel Bültmann -- todo extension
+* Etienne Desautels -- apidoc module
+* Michael Droettboom -- inheritance_diagram extension
+* Charles Duffy -- original graphviz extension
+* Kevin Dunn -- MathJax extension
+* Josip Dzolonga -- coverage builder
+* Horst Gutmann -- internationalization support
+* Martin Hans -- autodoc improvements
+* Doug Hellmann -- graphviz improvements
+* Dave Kuhlman -- original LaTeX writer
+* Blaise Laflamme -- pyramid theme
+* Thomas Lamb -- linkcheck builder
+* Łukasz Langa -- partial support for autodoc
+* Robert Lehmann -- gettext builder (GSOC project)
+* Dan MacKinlay -- metadata fixes
+* Martin Mahner -- nature theme
+* Will Maier -- directory HTML builder
+* Jacob Mason -- websupport library (GSOC project)
+* Roland Meister -- epub builder
+* Ezio Melotti -- collapsible sidebar JavaScript
+* Daniel Neuhäuser -- JavaScript domain, Python 3 support (GSOC)
+* Christopher Perkins -- autosummary integration
+* Benjamin Peterson -- unittests
+* T. Powers -- HTML output improvements
+* Stefan Seefeld -- toctree improvements
+* Shibukawa Yoshiki -- pluggable search API and Japanese search
+* Antonio Valentino -- qthelp builder
+* Pauli Virtanen -- autodoc improvements, autosummary extension
+* Stefan van der Walt -- autosummary extension
+* Thomas Waldmann -- apidoc module fixes
+* John Waltman -- Texinfo builder
+* Barry Warsaw -- setup command improvements
+* Sebastian Wiesner -- image handling, distutils support
+* Joel Wurtz -- cellspanning support in LaTeX
+
+Many thanks for all contributions!
+
+There are also a few modules or functions incorporated from other
+authors and projects:
+
+* sphinx.util.jsdump uses the basestring encoding from simplejson,
+ written by Bob Ippolito, released under the MIT license
+* sphinx.util.stemmer was written by Vivake Gupta, placed in the
+ Public Domain
+* sphinx.apidoc is derived from the "sphinx-autopackage" script, which is:
+ Copyright 2008 Société des arts technologiques (SAT), http://www.sat.qc.ca/
diff --git a/debian/dh-sphinxdoc/conf.py b/debian/dh-sphinxdoc/conf.py
new file mode 100644
index 0000000..1025954
--- /dev/null
+++ b/debian/dh-sphinxdoc/conf.py
@@ -0,0 +1,2 @@
+master_doc = 'empty'
+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..966c63f
--- /dev/null
+++ b/debian/dh-sphinxdoc/dh_sphinxdoc
@@ -0,0 +1,390 @@
+#!/usr/bin/perl
+
+# Copyright © 2011 Jakub Wilk <jwilk at debian.org>
+# © 2014 Dmitry Shachnev <mitya57 at debian.org>
+#
+# 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<I<debhelper options>>] [B<-X>I<item>] [I<directory>...]
+
+=head1 DESCRIPTION
+
+B<dh_sphinxdoc> 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<searchindex.js> exist.
+
+=item *
+
+It replaces known F<*.js> files with symlinks to F</usr/share/javascript/sphinxdoc/>
+and generates B<${sphinxdoc:Depends}> substitution variable.
+
+=item *
+
+It removes the F<.doctrees> directory.
+
+=item *
+
+It removes the F<.buildinfo> file.
+
+=item *
+
+It removes the F<websupport.js> file.
+
+=back
+
+=head1 OPTIONS
+
+=over 4
+
+=item I<directory>
+
+By default, B<dh_sphinxdoc> 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.
+
+=item B<-X>I<item>, B<--exclude=>I<item>
+
+Exclude files that contain I<item> anywhere in their filename from
+being symlinked, removed or checked for existence.
+
+=back
+
+=head1 BUGS
+
+Symlinking translations.js and non-English searchtools.js is not supported.
+
+=cut
+
+use strict;
+use warnings;
+
+use Digest::MD5;
+use File::Find;
+use Debian::Debhelper::Dh_Lib;
+
+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 (<F>)
+ {
+ 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.]+/(\w+[.]js))$} or 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);
+}
+
+sub looks_like_sphinx_doc($)
+{
+ my ($path) = @_;
+ return 0 unless -f "$path/searchindex.js";
+ return 0 unless -f "$path/search.html";
+ return 1;
+}
+
+sub sanity_check($)
+{
+ local $/;
+ my ($path) = @_;
+ my $indexfn = "$path/searchindex.js";
+ open(F, '<', $indexfn) or error("cannot open $indexfn");
+ my $index = <F>;
+ close(F);
+ $index =~ m{^Search[.]setIndex[(].*?filenames:\["(.*?)"\].*[)]$} or error("$indexfn doesn't look like a Sphinx search index");
+ $index = $1;
+ my $searchfn = "$path/search.html";
+ open(F, '<', $searchfn) or error("cannot open $searchfn");
+ my $search = <F>;
+ close F;
+ $search =~ s/<!--.*?-->//g; # strip comments
+ my %js = ();
+ grep { s/[?#].*//; $js{$_} = 1 unless m/^[a-z][a-z0-9.+-]*:/i or excludefile("$path/$_"); } $search =~ m{<script type="text/javascript" src="([^"]++)"></script>}g;
+ my $loads_searchindex = $search =~ m/\QjQuery(function() { Search.loadIndex("searchindex.js"); });\E/;
+ my ($has_source) = $search =~ m{HAS_SOURCE:\s*(true|false)};
+ my ($url_root) = $search =~ m{URL_ROOT:\s*'([^']*)'};
+ (%js and $loads_searchindex and defined $has_source and defined $url_root) or error("$searchfn doesn't look like a Sphinx search page");
+ $has_source = $has_source eq 'true';
+ $url_root =~ m{^([a-z]+:/)?/} and error("URL_ROOT in $searchfn is not relative");
+ for my $js (keys(%js))
+ {
+ -f "$path/$js" or -l "$path/$js" or error("$path/$js is missing");
+ }
+ for my $page (split(/","/, $index))
+ {
+ -f "$path/$page.html"
+ or excludefile("$path/$page.html")
+ or error("$path/$page.html is missing");
+ -f "$path/_sources/$page.txt"
+ or excludefile("$path/_sources/$page.txt")
+ or error("$path/_sources/$page.txt is missing")
+ if $has_source;
+ }
+ if (opendir(D, "$path/_static/"))
+ {
+ grep {
+ $js{"_static/$_"} = 1
+ if /[.]js$/ and not excludefile("$path/_static/$_");
+ } readdir(D);
+ closedir(D);
+ }
+ return keys(%js);
+}
+
+sub unknown_javascript($)
+{
+ my ($js) = @_;
+ my $message = "unknown JavaScript code: $js";
+ $js =~ s{.*/}{};
+ my $basic = grep { $_ eq $js } qw(searchtools.js doctools.js jquery.js underscore.js);
+ my $cruft = grep { $_ eq $js } @cruft_js;
+ if ($basic)
+ {
+ error("error: $message");
+ }
+ elsif (not $cruft)
+ {
+ warning("ignoring $message");
+ }
+}
+
+sub ln_sf($$)
+{
+ my ($orig_target, $orig_source) = my ($target, $source) = @_;
+ $source =~ s{^debian/[^/]++/+}{} or die;
+ $target =~ s{^/++}{} or die;
+ my @source = split(m{/++}, $source);
+ my @target = split(m{/++}, $target);
+ @source > 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 fix_sphinx_doc($$)
+{
+ my ($package, $path) = @_;
+ return 0 if not looks_like_sphinx_doc($path);
+ my @js = sanity_check($path);
+ my @deps = fix_symlinks($path, @js);
+ drop_cruft($path);
+ map { addsubstvar($package, "sphinxdoc:Depends", $_) } @deps;
+ return 1;
+}
+
+init();
+
+load_packaged_js();
+
+my @paths = @ARGV;
+ at paths = (undef) unless @paths;
+
+foreach my $path (@paths)
+{
+ my $done = 0;
+ foreach my $package (@{$dh{DOPACKAGES}})
+ {
+ my $pkgpath = tmpdir($package);
+ if (defined $path)
+ {
+ next if -l $path;
+ $pkgpath .= "/$path";
+ $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)
+ {
+ error("Sphinx documentation not found at $path");
+ }
+ else
+ {
+ warning("Sphinx documentation not found");
+ }
+ }
+}
+
+=head1 SEE ALSO
+
+L<debhelper(7)>, L<dh(1)>.
+
+This program is meant to be used together with debhelper.
+
+=head1 AUTHOR
+
+Jakub Wilk <jwilk at debian.org>
+
+=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..76d2dd2
--- /dev/null
+++ b/debian/dh-sphinxdoc/index
@@ -0,0 +1,7 @@
+# <filename> [min-version]
+1.0/doctools.js
+1.0/jquery.js
+1.0/searchtools.js
+1.0/sidebar.js
+1.0/theme_extras.js
+1.0/underscore.js
diff --git a/debian/dh-sphinxdoc/install-js b/debian/dh-sphinxdoc/install-js
new file mode 100755
index 0000000..169386d
--- /dev/null
+++ b/debian/dh-sphinxdoc/install-js
@@ -0,0 +1,21 @@
+#!/bin/sh
+
+set -e -u
+
+if [ $# -eq 0 ]
+then
+ printf 'Usage: %s <target-directory>\n' "$0" >&2
+ exit 1
+fi
+
+here="$(dirname "$0")"
+rm -rf "$here/tmp/"
+./sphinx-build.py -b html "$here" "$here/tmp"
+find sphinx/themes/ -type f -name '*.js' ! -name websupport.js \
+| xargs -t -I '{}' cp -f '{}' "$1"
+( cd "$here/tmp/_static" && rm jquery.js underscore.js websupport.js )
+find "$here/tmp/_static/" -name '*.js' \
+| xargs -t -I '{}' cp -f '{}' "$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/get-orig-source.sh b/debian/get-orig-source.sh
new file mode 100644
index 0000000..c27d57d
--- /dev/null
+++ b/debian/get-orig-source.sh
@@ -0,0 +1,27 @@
+#!/bin/sh
+set -e
+export TAR_OPTIONS='--owner root --group root --mode a+rX'
+export GZIP_OPTIONS='-9n'
+pwd=$(pwd)
+dfsg_version="$1"
+if [ -z "$dfsg_version" ]
+then
+ printf 'Usage: %s <version>\n' "$0"
+ exit 1
+fi
+upstream_version="${dfsg_version%+dfsg*}"
+cd "$(dirname "$0")/../"
+tmpdir=$(mktemp -t -d get-orig-source.XXXXXX)
+uscan --noconf --force-download --rename --download-version="$upstream_version" --destdir="$tmpdir"
+cd "$tmpdir"
+tar -xzf sphinx_*.orig.tar.gz
+rm *.tar.gz
+# Remove JavaScript code without source:
+rm Sphinx-*/sphinx/themes/basic/static/jquery.js
+rm Sphinx-*/sphinx/themes/basic/static/underscore.js
+mv Sphinx-*/ "sphinx-${dfsg_version}.orig"
+tar -czf "$pwd/sphinx_${dfsg_version}.orig.tar.gz" sphinx-*.orig/
+cd ..
+rm -Rf "$tmpdir"
+
+# vim:ts=4 sw=4 et
diff --git a/debian/jstest/jstest.py b/debian/jstest/jstest.py
new file mode 100644
index 0000000..3e7a426
--- /dev/null
+++ b/debian/jstest/jstest.py
@@ -0,0 +1,146 @@
+#!/usr/bin/python3
+# encoding=UTF-8
+
+# Copyright © 2011 Jakub Wilk <jwilk at debian.org>
+# © 2013-2014 Dmitry Shachnev <mitya57 at debian.org>
+#
+# 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 urllib.parse
+import urllib.request
+import re
+import unittest
+
+from gi.repository import GLib, Gtk, WebKit
+
+default_time_limit = 10.0
+time_step = 0.1
+
+# HTTP browser
+# ============
+
+class Timeout(Exception):
+ pass
+
+class Browser(object):
+
+ def __init__(self, options):
+ settings = WebKit.WebSettings()
+ settings.set_property('enable-file-access-from-file-uris', True)
+ self._time_limit = 0
+ self._view = WebKit.WebView()
+ self._view.set_settings(settings)
+ self._result = None
+
+ def wget(self, url, time_limit=default_time_limit):
+ self._view.load_uri(url)
+ self._time_limit = time_limit
+ GLib.timeout_add(int(1000 * time_step), self._check)
+ Gtk.main()
+ if self._result is None:
+ raise Timeout
+ return self._result
+
+ def _extract_html(self):
+ # There is not obvious way to extract HTML from WebKit.
+ # We use a trick from <http://code.google.com/p/pywebkitgtk/wiki/HowDoI> instead.
+ self._view.execute_script('document.title = document.documentElement.innerHTML')
+ try:
+ return self._view.get_main_frame().get_title() or ''
+ finally:
+ self._view.execute_script('document.title = ""')
+
+ def _check(self):
+ contents = self._extract_html()
+ match = re_done.search(contents)
+ if match is not None:
+ self._result = contents
+ Gtk.main_quit()
+ return
+ self._time_limit -= time_step
+ if self._time_limit < 0:
+ self._result = None
+ Gtk.main_quit()
+ else:
+ GLib.timeout_add(int(1000 * time_step), self._check)
+
+
+# Actual tests
+# ============
+
+re_done = re.compile(r'Search finished, found ([0-9]+) page')
+re_link = re.compile(r'<a href="[^"]+?highlight=[^"?]+">')
+re_highlight = re.compile(r'<span class="highlighted">')
+
+def test_html(html, options):
+
+ class TestCase(unittest.TestCase):
+
+ if options.n_results is not None:
+ def test_n_results(self):
+ match = re_done.search(html)
+ self.assertFalse(match is None)
+ n_results = int(match.group(1))
+ self.assertEqual(n_results, options.n_results)
+
+ if options.n_links is not None:
+ def test_n_links(self):
+ matches = re_link.findall(html)
+ n_links = len(matches)
+ self.assertEqual(n_links, options.n_links)
+
+ if options.n_highlights is not None:
+ def test_n_highlights(self):
+ matches = re_highlight.findall(html)
+ n_highlights = len(matches)
+ 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 = urllib.parse.urljoin('file:', urllib.request.pathname2url(directory))
+ url = urllib.parse.urljoin(url, 'html/search.html?q=' + urllib.parse.quote_plus(options.search_term))
+ browser = Browser(options)
+ html = browser.wget(url, time_limit)
+ return test_html(html, options)
+
+def main():
+ import argparse
+ parser = argparse.ArgumentParser()
+ parser.add_argument('--time-limit', type=float, default=default_time_limit)
+ parser.add_argument('directory', metavar='DIRECTORY')
+ parser.add_argument('search_term', metavar='SEARCH-TERM')
+ parser.add_argument('--n-results', type=int)
+ parser.add_argument('--n-links', type=int)
+ parser.add_argument('--n-highlights', type=int)
+ options = parser.parse_args()
+ test_directory(options.directory, options=options, time_limit=options.time_limit)
+
+if __name__ == '__main__':
+ main()
+
+# vim:ts=4 sw=4 et
diff --git a/debian/jstest/run-tests b/debian/jstest/run-tests
new file mode 100755
index 0000000..cf248c6
--- /dev/null
+++ b/debian/jstest/run-tests
@@ -0,0 +1,37 @@
+#!/usr/bin/python3
+
+import os
+import sys
+
+import jstest
+
+class t1:
+ search_term = 'example'
+ n_results = 26
+ n_links = 26
+ n_highlights = 24
+
+class t2:
+ search_term = 'examples'
+ n_results = 26
+ n_links = 26
+ n_highlights = 7
+
+class t3:
+ search_term = 'graph'
+ n_results = 10
+ n_links = 10
+ n_highlights = 1
+
+if __name__ == '__main__':
+ if not os.getenv('DISPLAY'):
+ raise RuntimeError('These tests require access to an X server')
+ [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..173422a
--- /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/disable_distribute_setup.diff b/debian/patches/disable_distribute_setup.diff
new file mode 100644
index 0000000..82dd96d
--- /dev/null
+++ b/debian/patches/disable_distribute_setup.diff
@@ -0,0 +1,15 @@
+Description: disable use of distribute_setup, which bootstraps distribute installation
+Author: Jakub Wilk <jwilk at debian.org>
+Forwarded: not-needed
+Last-Update: 2013-10-05
+
+--- a/setup.py
++++ b/setup.py
+@@ -2,6 +2,7 @@
+ try:
+ from setuptools import setup, find_packages
+ except ImportError:
++ raise
+ import ez_setup
+ ez_setup.use_setuptools()
+ from setuptools import setup, find_packages
diff --git a/debian/patches/fix_latex_hlines.diff b/debian/patches/fix_latex_hlines.diff
new file mode 100644
index 0000000..bfd9b51
--- /dev/null
+++ b/debian/patches/fix_latex_hlines.diff
@@ -0,0 +1,32 @@
+Description: fix writing table hlines in latex writer
+Origin: upstream, https://bitbucket.org/birkenfeld/sphinx/commits/91597cc54b0b2e
+Bug-Debian: https://bugs.debian.org/732585
+Last-Update: 2014-03-01
+
+--- a/sphinx/writers/latex.py
++++ b/sphinx/writers/latex.py
+@@ -743,14 +743,14 @@
+ # Redirect head output until header is finished. see visit_tbody.
+ self.body = self.tableheaders
+ def depart_thead(self, node):
+- self.body.append('\\hline')
++ pass
+
+ def visit_tbody(self, node):
+ if not self.table.had_head:
+ self.visit_thead(node)
+ self.body = self.tablebody
+ def depart_tbody(self, node):
+- self.body.append('\\hline')
++ pass
+
+ def visit_row(self, node):
+ self.table.col = 0
+@@ -758,6 +758,7 @@
+ if self.previous_spanning_row == 1:
+ self.previous_spanning_row = 0
+ self.body.append('\\\\\n')
++ self.body.append('\\hline')
+ self.table.rowcount += 1
+
+ def visit_entry(self, node):
diff --git a/debian/patches/initialize_autodoc.diff b/debian/patches/initialize_autodoc.diff
new file mode 100644
index 0000000..edbba31
--- /dev/null
+++ b/debian/patches/initialize_autodoc.diff
@@ -0,0 +1,33 @@
+Description: make sphinx-autogen initialize the sphinx.ext.autodoc module
+Author: Jakub Wilk <jwilk at debian.org>
+Bug-Debian: http://bugs.debian.org/611078
+Bug: https://bitbucket.org/birkenfeld/sphinx/issue/618
+Forwarded: yes
+Last-Update: 2012-02-04
+
+--- a/sphinx/ext/autosummary/generate.py
++++ b/sphinx/ext/autosummary/generate.py
+@@ -27,6 +27,7 @@
+ from jinja2 import FileSystemLoader, TemplateNotFound
+ from jinja2.sandbox import SandboxedEnvironment
+
++from sphinx.ext import autodoc
+ from sphinx import package_dir
+ from sphinx.ext.autosummary import import_by_name, get_documenter
+ from sphinx.jinja2glue import BuiltinTemplateLoader
+@@ -65,6 +66,15 @@
+ if len(args) < 1:
+ p.error('no input files given')
+
++ class Sphinx(object):
++ def add_autodocumenter(self, cls):
++ autodoc.add_documenter(cls)
++ def add_event(self, name):
++ pass
++ def add_config_value(self, name, default, rebuild):
++ pass
++ autodoc.setup(Sphinx())
++
+ generate_autosummary_docs(args, options.output_dir,
+ "." + options.suffix,
+ template_dir=options.templates)
diff --git a/debian/patches/no_external_css.diff b/debian/patches/no_external_css.diff
new file mode 100644
index 0000000..8fc0d82
--- /dev/null
+++ b/debian/patches/no_external_css.diff
@@ -0,0 +1,27 @@
+Description: don't use CSS files hosted on external sites
+Author: Jakub Wilk <jwilk at debian.org>
+Forwarded: no
+Last-Update: 2013-04-08
+
+--- a/doc/_themes/sphinx13/layout.html
++++ b/doc/_themes/sphinx13/layout.html
+@@ -14,8 +14,6 @@
+ {% block sidebar2 %}{% endblock %}
+
+ {% block extrahead %}
+- <link href='http://fonts.googleapis.com/css?family=Open+Sans:300,400,700'
+- rel='stylesheet' type='text/css' />
+ {{ super() }}
+ {%- if not embedded %}
+ <style type="text/css">
+--- a/sphinx/themes/pyramid/layout.html
++++ b/sphinx/themes/pyramid/layout.html
+@@ -1,8 +1,6 @@
+ {%- extends "basic/layout.html" %}
+
+ {%- block extrahead %}
+-<link rel="stylesheet" href="http://fonts.googleapis.com/css?family=Neuton&subset=latin" type="text/css" media="screen" charset="utf-8" />
+-<link rel="stylesheet" href="http://fonts.googleapis.com/css?family=Nobile:regular,italic,bold,bolditalic&subset=latin" type="text/css" media="screen" charset="utf-8" />
+ <!--[if lte IE 6]>
+ <link rel="stylesheet" href="{{ pathto('_static/ie6.css', 1) }}" type="text/css" media="screen" charset="utf-8" />
+ <![endif]-->
diff --git a/debian/patches/parallel_2to3.diff b/debian/patches/parallel_2to3.diff
new file mode 100644
index 0000000..9799cbb
--- /dev/null
+++ b/debian/patches/parallel_2to3.diff
@@ -0,0 +1,31 @@
+Description: run 2to3 in parallel
+Author: Jakub Wilk <jwilk at debian.org>
+Forwarded: not-needed
+Last-Update: 2012-12-18
+
+--- a/setup.py
++++ b/setup.py
+@@ -158,6 +158,23 @@
+
+ cmdclass['compile_catalog'] = compile_catalog_plusjs
+
++if sys.version_info >= (3,):
++
++ num_processes = 1
++ for option in os.environ.get('DEB_BUILD_OPTIONS', '').split():
++ if option.startswith('parallel='):
++ num_processes = int(option.split('=', 1)[1])
++ if num_processes > 1:
++ import lib2to3.refactor
++ class RefactoringTool(lib2to3.refactor.MultiprocessRefactoringTool):
++ def refactor(self, items, write=False, doctests_only=False):
++ return lib2to3.refactor.MultiprocessRefactoringTool.refactor(
++ self, items,
++ write=write,
++ doctests_only=doctests_only,
++ num_processes=num_processes
++ )
++ lib2to3.refactor.RefactoringTool = RefactoringTool
+
+ setup(
+ name='Sphinx',
diff --git a/debian/patches/python3_test_build_dir.diff b/debian/patches/python3_test_build_dir.diff
new file mode 100644
index 0000000..a87c5e3
--- /dev/null
+++ b/debian/patches/python3_test_build_dir.diff
@@ -0,0 +1,30 @@
+Description: fix build directory for test runner
+ Hardcode Python 3 build directory in the test runner to the one that Debian
+ package uses.
+Author: Jakub Wilk <jwilk at debian.org>
+Forwarded: not-needed
+Last-Update: 2013-09-18
+
+--- a/tests/run.py
++++ b/tests/run.py
+@@ -21,17 +21,17 @@
+ # tox installs the sphinx package, no need for sys.path.insert
+ else:
+ newroot = path.join(testroot, path.pardir, 'build')
+- newroot = path.join(newroot, listdir(newroot)[0], 'tests')
++ newroot = path.join(newroot, 'py%d' % sys.version_info[0], 'tests')
+
+ shutil.rmtree(newroot, ignore_errors=True)
+
+ if sys.version_info >= (3, 0):
+- print('Copying and converting sources to build/lib/tests...')
++ print('Copying and converting sources to build/py3/tests...')
+ from distutils.util import copydir_run_2to3
+ copydir_run_2to3(testroot, newroot)
+ else:
+ # just copying test directory to parallel testing
+- print('Copying sources to build/lib/tests...')
++ print('Copying sources to build/py2/tests...')
+ shutil.copytree(testroot, newroot)
+
+ # always test the sphinx package from build/lib/
diff --git a/debian/patches/series b/debian/patches/series
new file mode 100644
index 0000000..5d9378c
--- /dev/null
+++ b/debian/patches/series
@@ -0,0 +1,6 @@
+disable_distribute_setup.diff
+initialize_autodoc.diff
+python3_test_build_dir.diff
+parallel_2to3.diff
+no_external_css.diff
+fix_latex_hlines.diff
diff --git a/debian/python-sphinx.docs b/debian/python-sphinx.docs
new file mode 100644
index 0000000..c19ffba
--- /dev/null
+++ b/debian/python-sphinx.docs
@@ -0,0 +1,2 @@
+README.rst
+AUTHORS
diff --git a/debian/python-sphinx.install b/debian/python-sphinx.install
new file mode 100644
index 0000000..e313a86
--- /dev/null
+++ b/debian/python-sphinx.install
@@ -0,0 +1,2 @@
+/usr/lib/python2.*/*-packages/
+/usr/share/sphinx/scripts/python2/
diff --git a/debian/python3-sphinx.install b/debian/python3-sphinx.install
new file mode 100644
index 0000000..1549065
--- /dev/null
+++ b/debian/python3-sphinx.install
@@ -0,0 +1,2 @@
+/usr/lib/python3/dist-packages/
+/usr/share/sphinx/scripts/python3/
diff --git a/debian/rules b/debian/rules
new file mode 100755
index 0000000..92dee0d
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,160 @@
+#!/usr/bin/make -f
+# -*- makefile -*-
+
+include /usr/share/python/python.mk
+
+export NO_PKG_MANGLE=1
+export PYTHONWARNINGS=d
+export PYTHONHASHSEED=random
+export http_proxy=http://127.0.0.1:9/
+
+here = $(dir $(firstword $(MAKEFILE_LIST)))/..
+debian_version = $(word 2,$(shell cd $(here) && dpkg-parsechangelog | grep ^Version:))
+upstream_dfsg_version = $(firstword $(subst -, ,$(debian_version)))
+upstream_version = $(subst ~,,$(firstword $(subst +, ,$(debian_version))))
+
+locales = $(notdir $(patsubst %/LC_MESSAGES,%,$(wildcard sphinx/locale/*/LC_MESSAGES)))
+scripts = $(basename $(wildcard sphinx-*.py))
+
+debroot = debian/tmp/
+site_packages = $(call py_libdir,$(shell pyversions -d))
+py3_site_packages = $(call py_libdir,$(shell py3versions -d))
+javascript_path = /usr/share/javascript/sphinxdoc/1.0/
+
+python_all = pyversions -r | tr ' ' '\n' | xargs -t -I {} env {}
+python3_all = py3versions -r | tr ' ' '\n' | xargs -t -I {} env {}
+
+.PHONY: clean
+clean:
+ dh_clean
+ find . -name '*.py[co]' -delete
+ rm -rf build
+ rm -f $(basename $(wildcard debian/*.in))
+ rm -f sphinx/pycode/Grammar*.pickle
+
+.PHONY: build build-arch build-indep
+build build-indep: build-stamp
+
+sphinx/themes/basic/static/%.js:
+ ln -sf /usr/share/javascript/$(*)/$(*).js $(@)
+
+build/javascript-stamp: $(addprefix sphinx/themes/basic/static/,jquery.js underscore.js)
+ echo $(^) | xargs -n1 | xargs -t -I {} [ -L {} ]
+ mkdir -p $(dir $@)
+ touch $(@)
+
+build-stamp: sphinx-build.py build/javascript-stamp
+ python ./sphinx-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'
+ rm -rf build/man
+ cp -rl build/html build/man
+ python ./sphinx-build.py -T -b man doc build/man
+ python setup.py build --build-lib build/py2/
+ python3 setup.py build --build-lib build/py3/
+ python setup.py compile_catalog
+ifeq "$(filter nocheck,$(DEB_BUILD_OPTIONS))" ""
+ # FIXME: https://bitbucket.org/birkenfeld/sphinx/issue/703
+ export LC_ALL=C.UTF-8 && \
+ $(python_all) tests/run.py --verbose --no-skip
+ export LC_ALL=C.UTF-8 && \
+ $(python3_all) tests/run.py --verbose
+ rm -rf build/py2/tests/ build/py3/tests/
+ xvfb-run -a ./debian/jstest/run-tests build/html/
+endif
+ # import sphinx.pycode to generate grammar pickle files
+ cd build/py2/ && python -c "import sphinx.pycode"
+ cd build/py3/ && python3 -c "import sphinx.pycode"
+ touch build-stamp
+
+.PHONY: binary binary-arch binary-indep
+binary binary-indep: build-stamp
+ dh_testroot
+ dh_installdirs
+ python setup.py \
+ build --build-lib build/py2/ \
+ install --no-compile --install-layout=deb --root $(debroot)
+ python3 setup.py \
+ build --build-lib build/py3/ \
+ install --no-compile --install-layout=deb --root $(debroot)
+ rm $(debroot)/usr/lib/python*/*-packages/Sphinx-*.egg-info/SOURCES.txt
+ # move static files outside {site,dist}-packages
+ sed -i -e "s!^package_dir = .*!package_dir = '/usr/share/sphinx'!" \
+ $(debroot)$(site_packages)/sphinx/__init__.py \
+ $(debroot)$(py3_site_packages)/sphinx/__init__.py
+ rm -rf $(debroot)/usr/share/sphinx/
+ mkdir -p $(debroot)/usr/share/sphinx/
+ cd $(debroot) && mv -t usr/share/sphinx/ \
+ .$(site_packages)/sphinx/texinputs \
+ .$(site_packages)/sphinx/themes
+ mkdir -p $(debroot)/usr/share/sphinx/pycode/
+ cd $(debroot) && mv -t usr/share/sphinx/pycode/ \
+ .$(site_packages)/sphinx/pycode/Grammar*
+ cd $(debroot) && mv -t usr/share/sphinx/pycode/ \
+ .$(py3_site_packages)/sphinx/pycode/Grammar*
+ mkdir -p $(debroot)/usr/share/sphinx/ext/autosummary/
+ cd $(debroot) && mv -t usr/share/sphinx/ext/autosummary/ \
+ .$(site_packages)/sphinx/ext/autosummary/templates
+ cd $(debroot)$(py3_site_packages)/sphinx/ && \
+ rm -rf texinputs/ themes/ ext/autosummary/templates/
+ set -e -x; \
+ cd $(debroot) && \
+ for lang in $(locales); \
+ do \
+ install -m 644 -D .$(site_packages)/sphinx/locale/$$lang/LC_MESSAGES/sphinx.js \
+ usr/share/sphinx/locale/$$lang/sphinx.js; \
+ install -m 644 -D .$(site_packages)/sphinx/locale/$$lang/LC_MESSAGES/sphinx.mo \
+ usr/share/locale/$$lang/LC_MESSAGES/sphinx.mo; \
+ done
+ cd $(debroot)$(site_packages)/sphinx/locale && rm -rf sphinx.pot */
+ cd $(debroot)$(py3_site_packages)/sphinx/locale && rm -rf sphinx.pot */
+ # install scripts not touched by easy install
+ set -e -x; \
+ for python in python2 python3; do \
+ dir=$(debroot)/usr/share/sphinx/scripts/$$python/; \
+ mkdir -p $$dir; \
+ for script in $(scripts); do \
+ sed -e "1 s,#!.*,#!/usr/bin/$${python%2}," $$script.py \
+ > $$dir/$$script; \
+ rm -f $(debroot)/usr/bin/$$script; \
+ done; \
+ chmod 755 $$dir/*; \
+ done
+ set -e -x; \
+ for maintscript in $(wildcard debian/sphinx-common.*.in); do \
+ sed -e 's/@SCRIPTS@/$(scripts)/' $$maintscript > $${maintscript%.in}; \
+ done
+ # Move JavaScript code to libjs-sphinxdoc:
+ debian/dh-sphinxdoc/install-js debian/libjs-sphinxdoc/$(javascript_path)/
+ 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
+ dh_install -p sphinx-common -X /scripts/
+ dh_install -N sphinx-common --fail-missing
+ dh_installchangelogs CHANGES
+ dh_installdocs
+ dh_lintian
+ ./debian/dh-sphinxdoc/dh_sphinxdoc -p sphinx-doc /usr/share/doc/sphinx-doc/html/
+ dh_installexamples
+ cd debian/dh-sphinxdoc/ && pod2man -c Debhelper -r '' dh_sphinxdoc dh_sphinxdoc.1
+ifneq ($(shell grep -h '^[.]TH' debian/*.1 | cut -d ' ' -f 6-7 | sort -u), "Sphinx $(upstream_version)")
+ $(warning W: version numbers in the manual pages are out of date)
+endif
+ dh_installman
+ dh_python2 -p python-sphinx
+ dh_python3 -p python3-sphinx --no-guessing-deps
+ dh_compress -X.py -X.rst -X.json -X.txt
+ dh_link
+ dh_fixperms
+ dh_installdeb
+ dh_gencontrol
+ dh_md5sums
+ dh_builddeb
+
+.PHONY: get-orig-source
+get-orig-source:
+ sh $(here)/debian/get-orig-source.sh $(upstream_dfsg_version)
+
+# vim:ts=4 sw=4 noet
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/include-binaries b/debian/source/include-binaries
new file mode 100644
index 0000000..95a390b
--- /dev/null
+++ b/debian/source/include-binaries
@@ -0,0 +1 @@
+debian/upstream-signing-key.pgp
diff --git a/debian/source/lintian-overrides b/debian/source/lintian-overrides
new file mode 100644
index 0000000..708ff48
--- /dev/null
+++ b/debian/source/lintian-overrides
@@ -0,0 +1,2 @@
+# Generated from the .po files using ‘setup.py compile_catalog’
+sphinx source: source-is-missing sphinx/locale/*/LC_MESSAGES/sphinx.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-autogen.1 b/debian/sphinx-autogen.1
new file mode 100644
index 0000000..6665be9
--- /dev/null
+++ b/debian/sphinx-autogen.1
@@ -0,0 +1,45 @@
+.TH sphinx\-autogen 1 "Sep 2014" "Sphinx 1.2.3" "User Commands"
+
+.SH NAME
+sphinx\-autogen \- generate reStructuredText using \fBautosummary\fR
+directives
+
+.SH SYNOPSIS
+.B sphinx\-autogen
+[\-o \fIoutput_dir\fR]
+[\-s \fIsuffix\fR]
+.BI sourcefile ...
+
+.SH OPTIONS
+.TP
+\fB\-o\fR, \fB--output-dir=\fIoutput_dir\fR,
+the directory the output files should be written to
+.TP
+\fB\-s\fR, \fB--suffix=\fIsuffix\fR
+the suffix of the written files (defaults to rst)
+.TP
+\fB\-t\fR, \fB--templates=\fIdirectory\fR
+custom template directory
+
+.SH DESCRIPTION
+.B sphinx\-autogen
+is a frontend to \fBsphinx.ext.autosummary.generate\fR.
+It generates the ReStructuredText files from the \fBautosummary\fR
+directives contained in the given input files.
+
+The format of the \fBautosummary\fR directive is documented in the
+\fBsphinx.ext.autosummary\fR Python module and can be read using
+
+.B pydoc
+.I sphinx.ext.autosummary
+
+.SH SEE ALSO
+\fBsphinx\-quickstart\fR(1),
+\fBsphinx\-build\fR(1)
+
+.mso www.tmac
+.URL "http://sphinx-doc.org/" "The Sphinx website"
+
+.SH AUTHOR
+This man page was written by Jan Dittberner <jan at dittberner.info> for
+the Debian project (but may be used by others).
diff --git a/debian/sphinx-common.install b/debian/sphinx-common.install
new file mode 100644
index 0000000..789be98
--- /dev/null
+++ b/debian/sphinx-common.install
@@ -0,0 +1,4 @@
+/usr/share/sphinx/
+/usr/share/locale/
+debian/dh-sphinxdoc/sphinxdoc.pm /usr/share/perl5/Debian/Debhelper/Sequence/
+debian/dh-sphinxdoc/dh_sphinxdoc /usr/bin/
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..98f97d9
--- /dev/null
+++ b/debian/sphinx-common.manpages
@@ -0,0 +1,5 @@
+build/man/sphinx-build.1
+build/man/sphinx-quickstart.1
+build/man/sphinx-apidoc.1
+debian/sphinx-autogen.1
+debian/dh-sphinxdoc/dh_sphinxdoc.1
diff --git a/debian/sphinx-common.postinst.in b/debian/sphinx-common.postinst.in
new file mode 100644
index 0000000..0dfe2e7
--- /dev/null
+++ b/debian/sphinx-common.postinst.in
@@ -0,0 +1,29 @@
+#!/bin/sh
+set -e
+
+directory=/usr/share/sphinx/scripts
+scripts='@SCRIPTS@'
+if [ "$1" = configure ] || [ "$1" = triggered ]
+then
+ if [ -d $directory/python2/ ]
+ then
+ for script in $scripts
+ do
+ ln -sf ../${directory#/usr/}/python2/$script /usr/bin/
+ done
+ elif [ -d $directory/python3/ ]
+ then
+ for script in $scripts
+ do
+ ln -sf ../${directory#/usr/}/python3/$script /usr/bin/
+ done
+ else
+ cd /usr/bin/
+ rm -f $scripts
+ cd /
+ fi
+fi
+unset directory
+unset scripts
+
+#DEBHELPER#
diff --git a/debian/sphinx-common.prerm.in b/debian/sphinx-common.prerm.in
new file mode 100644
index 0000000..5210bfa
--- /dev/null
+++ b/debian/sphinx-common.prerm.in
@@ -0,0 +1,13 @@
+#!/bin/sh
+set -e
+
+scripts='@SCRIPTS@'
+if [ "$1" = remove ] || [ "$1" = deconfigure ]
+then
+ cd /usr/bin/
+ rm -f $scripts
+ cd /
+fi
+unset scripts
+
+#DEBHELPER#
diff --git a/debian/sphinx-common.triggers b/debian/sphinx-common.triggers
new file mode 100644
index 0000000..6bb457e
--- /dev/null
+++ b/debian/sphinx-common.triggers
@@ -0,0 +1 @@
+interest /usr/share/sphinx/scripts
diff --git a/debian/sphinx-doc.doc-base b/debian/sphinx-doc.doc-base
new file mode 100644
index 0000000..c04a801
--- /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..9e0ca75
--- /dev/null
+++ b/debian/sphinx-doc.docs
@@ -0,0 +1,3 @@
+README.rst
+AUTHORS
+build/html
diff --git a/debian/sphinx-doc.links b/debian/sphinx-doc.links
new file mode 100644
index 0000000..6b1d912
--- /dev/null
+++ b/debian/sphinx-doc.links
@@ -0,0 +1,5 @@
+/usr/share/doc/sphinx-doc/html/_sources/ /usr/share/doc/sphinx-doc/rst
+/usr/share/doc/sphinx-doc/rst/ /usr/share/doc/python-sphinx/rst
+/usr/share/doc/sphinx-doc/html/ /usr/share/doc/python-sphinx/html
+/usr/share/doc/sphinx-doc/rst/ /usr/share/doc/python3-sphinx/rst
+/usr/share/doc/sphinx-doc/html/ /usr/share/doc/python3-sphinx/html
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..94c1dfc
--- /dev/null
+++ b/debian/tests/control
@@ -0,0 +1,8 @@
+Tests: python-sphinx
+Depends: python-sphinx, python-nose
+
+Tests: python3-sphinx
+Depends: python3-sphinx, python3-nose
+
+Tests: sphinx-doc
+Depends: sphinx-doc, python3-gi, gir1.2-webkit-3.0, xauth, xvfb
diff --git a/debian/tests/python-sphinx b/debian/tests/python-sphinx
new file mode 100755
index 0000000..76beaff
--- /dev/null
+++ b/debian/tests/python-sphinx
@@ -0,0 +1,10 @@
+#!/bin/sh
+set -e -u
+cp -r tests "$ADTTMP/"
+cd "$ADTTMP"
+pyversions -i \
+| tr ' ' '\n' \
+| xargs -I {} env PYTHONWARNINGS=d PYTHONHASHSEED=random {} \
+ /usr/bin/nosetests --verbose 2>&1
+
+# vim:ts=4 sw=4 et
diff --git a/debian/tests/python3-sphinx b/debian/tests/python3-sphinx
new file mode 100755
index 0000000..cedcfbf
--- /dev/null
+++ b/debian/tests/python3-sphinx
@@ -0,0 +1,11 @@
+#!/bin/sh
+set -e -u
+cp -r tests "$ADTTMP/"
+2to3-$(py3versions -vd) --no-diffs -w -n "$ADTTMP/tests/" 2>&1
+cd "$ADTTMP"
+py3versions -i \
+| tr ' ' '\n' \
+| xargs -I {} env PYTHONWARNINGS=d PYTHONHASHSEED=random {} \
+ /usr/bin/nosetests3 --verbose 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..d4ccc1a
--- /dev/null
+++ b/debian/tests/sphinx-doc
@@ -0,0 +1,20 @@
+#!/bin/sh
+set -e -u
+cp -r debian/jstest "$ADTTMP/"
+cd "$ADTTMP"
+for python in python python3
+do
+ for format in rst html
+ do
+ [ "$(readlink -f /usr/share/doc/$python-sphinx/$format)" = "$(readlink -f /usr/share/doc/sphinx-doc/$format)" ]
+ done
+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-signing-key.pgp b/debian/upstream-signing-key.pgp
new file mode 100644
index 0000000..7582209
Binary files /dev/null and b/debian/upstream-signing-key.pgp differ
diff --git a/debian/watch b/debian/watch
new file mode 100644
index 0000000..8179522
--- /dev/null
+++ b/debian/watch
@@ -0,0 +1,3 @@
+version=3
+opts=uversionmangle=s/b/~b/,dversionmangle=s/\+dfsg//,pgpsigurlmangle=s/$/.asc/ \
+https://pypi.python.org/packages/source/S/Sphinx/Sphinx-(.*)\.tar\.gz
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/sphinx.git
More information about the Reproducible-commits
mailing list