--- sphinx-0.5.1.orig/debian/manpages +++ sphinx-0.5.1/debian/manpages @@ -0,0 +1,2 @@ +debian/sphinx-build.1 +debian/sphinx-quickstart.1 --- sphinx-0.5.1.orig/debian/sphinx-quickstart.1 +++ sphinx-0.5.1/debian/sphinx-quickstart.1 @@ -0,0 +1,23 @@ +.TH sphinx-quickstart 1 "Apr 2008" "Sphinx 0.1.61950" "User Commands" +.SH NAME +sphinx-quickstart \- Sphinx documentation template generator +.SH SYNOPSIS +.B sphinx-quickstart +.SH DESCRIPTION +sphinx-quickstart is the interactive tool which asks some questions about your +Python project and then generates template documentation directory and sample +Makefile to be used with \fBsphinx-build(1)\fR. +.SH "SEE ALSO" +.BR sphinx-build(1) +.br +The full documentation for +.B Sphinx +is installed to +.B /usr/share/doc/python-sphinx +. +.SH AUTHOR +Georg Brandl , Armin Ronacher et +al. +.PP +This manual page was written by Mikhail Gusarov for +the Debian project (but may be used by others). --- sphinx-0.5.1.orig/debian/sphinx-build.1 +++ sphinx-0.5.1/debian/sphinx-build.1 @@ -0,0 +1,79 @@ +.TH sphinx-build 1 "Apr 2008" "Sphinx 0.1.61950" "User Commands" +.SH NAME +sphinx-build \- Sphinx documentation generator tool +.SH SYNOPSIS +.B sphinx-build +[\fIoptions\fR] <\fIsourcedir\fR> <\fIoutdir\fR> [\fIfilenames\fR...] +.SH DESCRIPTION +sphinx-build generates documentation from the files in and places it +to the . + +sphinx-build looks for /conf.py for the configuration settings. +.B sphinx-quickstart(1) +may be used to generate template files, including conf.py. + +sphinx-build can create documentation in different formats. Format is selected +by specifying builder in command line and defaults to HTML. Builders can +also perform other tasks related to the documentation processing. + +List of available builders: +.TP +\fBhtml\fR +HTML files generation. This is default builder. +.TP +\fBweb\fR +Generating files for sphinx-web (currently undergo the full rewrite, and not working). +.TP +\fBhtmlhelp\fR +Generates files for CHM generation. +.TP +\fBlatex\fR +Generates LaTeX version of documentation. This builder uses PAPER environment variable (e.g. PAPER=a4 or PAPER=letter) if available. +.TP +\fBchanges\fR +Shows changed/added/deprecated items since last documentation generation. +.TP +\fBlinkcheck\fR +Checks the integrity of all external links in documentation +.SH OPTIONS +.TP +\fB-b\fR +Builder to use; defaults to html. See the full list of builders above. +.TP +\fB\fR +Force to generate documentation for the file +.TP +\fB-a\fR +Generate all files; without this option only documentation for new and changed files is generated +.TP +\fB-E\fR +Ignore cached files, forces to re-read all files from disk. +.TP +\fB-d\fR +Path to cached environment; defaults to /.doctrees +.TP +\fB-D\fR = +Overrides setting from /conf.py +.TP +\fB-N\fR +Do not do colored output +.TP +\fB-q\fR +Quiet operation, just prints warnings and errors on stderr +.TP +\fB-P\fR +Run Pdb on exception +.SH "SEE ALSO" +.BR sphinx-quickstart(1) +.br +The full documentation for +.B Sphinx +is installed to +.B /usr/share/doc/python-sphinx +. +.SH AUTHOR +Georg Brandl , Armin Ronacher et +al. +.PP +This manual page was written by Mikhail Gusarov , for +the Debian project (but may be used by others). --- sphinx-0.5.1.orig/debian/copyright +++ sphinx-0.5.1/debian/copyright @@ -0,0 +1,75 @@ +This package was first debianized by Mikhail Gusarov +on Mon, 08 Apr 2008 01:52:52 +0600 + +It was downloaded from http://sphinx.pocoo.org/ + +Copyright Holders: Georg Brandl , Armin Ronacher +, Josip Dzolonga, Gerold Penz, Vivake Gupta + + +License: + +Copyright (c) 2007-2008 by the respective authors (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. + + * The names of the contributors may not 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. + +AUTHORS file: + +The doctools are written and maintained by Georg Brandl . +Substantial parts of the templates and the web application were written by +Armin Ronacher . + +Other contributors are noted in the :copyright: fields within the docstrings +of the respective files. + +Many thanks for all contributions! + +Copyright strings: + +spinx/search.py, +sphinx/web/{feed.py,antispam.py,userdb.py,wsgiutil.py,markup.py,} + +:copyright: 2007-2008 by Armin Ronacher. + +sphinx/ext/coverage.py + +:copyright: 2007 by Josip Dzolonga, Georg Brandl. + +sphinx/web/mail.py + +:copyright: 2004-2007 by Gerold Penz. + +sphinx/util/stemmer.py + +:copyright: 2001 by Vivake Gupta + +All the other files: + +:copyright: 2007-2008 by Georg Brandl --- sphinx-0.5.1.orig/debian/compat +++ sphinx-0.5.1/debian/compat @@ -0,0 +1 @@ +7 --- sphinx-0.5.1.orig/debian/watch +++ sphinx-0.5.1/debian/watch @@ -0,0 +1,2 @@ +version=3 +http://pypi.python.org/packages/source/S/Sphinx/Sphinx-(.*)\.tar\.gz --- sphinx-0.5.1.orig/debian/changelog +++ sphinx-0.5.1/debian/changelog @@ -0,0 +1,109 @@ +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 --- sphinx-0.5.1.orig/debian/rules +++ sphinx-0.5.1/debian/rules @@ -0,0 +1,62 @@ +#!/usr/bin/make -f +# -*- makefile -*- + +include /usr/share/quilt/quilt.make + +PACKAGE_NAME=python-sphinx + +build: build-stamp + +build-stamp: + dh_testdir + + mkdir -p _build/html + python sphinx-build.py doc _build/html + touch build-stamp + +clean: clean-patched unpatch + dh_testdir + dh_testroot + find . -name '*.py[co]' -delete + rm -rf _build build + dh_clean + +clean-patched: patch + dh_testdir + python setup.py clean + +install: build patch + dh_testdir + dh_testroot + dh_installdirs + + python setup.py install --no-compile --root $(CURDIR)/debian/$(PACKAGE_NAME) + # install scripts not touched by easy install + install -m 755 $(CURDIR)/sphinx-build.py $(CURDIR)/debian/$(PACKAGE_NAME)/usr/bin/sphinx-build + install -m 755 $(CURDIR)/sphinx-quickstart.py $(CURDIR)/debian/$(PACKAGE_NAME)/usr/bin/sphinx-quickstart + +binary-indep: build install + dh_testdir + dh_testroot + dh_installchangelogs CHANGES + dh_installdocs + rm -rf $(CURDIR)/debian/$(PACKAGE_NAME)/usr/share/doc/python-sphinx/html/.doctrees + dh_installexamples + dh_installman + dh_pycentral + dh_compress -X.py -X.js -X.rst -X.json -X.doctree -X.txt + ln -sf /usr/share/javascript/jquery/jquery.js \ + $(CURDIR)/debian/$(PACKAGE_NAME)/usr/share/doc/python-sphinx/html/_static/jquery.js + ln -sf /usr/share/javascript/jquery/jquery.js \ + $(CURDIR)/debian/$(PACKAGE_NAME)/usr/share/pyshared/sphinx/static/jquery.js + dh_link + dh_fixperms + dh_installdeb + dh_gencontrol + dh_md5sums + dh_builddeb + +binary-arch: build install + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install --- sphinx-0.5.1.orig/debian/docs +++ sphinx-0.5.1/debian/docs @@ -0,0 +1,4 @@ +README +TODO +doc +_build/html --- sphinx-0.5.1.orig/debian/README.source +++ sphinx-0.5.1/debian/README.source @@ -0,0 +1,9 @@ +This package is using dpatch patch system. + +To patch the source: + * debian/rules patch +To add a new patch: + * put it under debian/patches + * add it to debian/patches/00list + +See /usr/share/doc/dpatch/README.source.gz for more information. --- sphinx-0.5.1.orig/debian/control +++ sphinx-0.5.1/debian/control @@ -0,0 +1,31 @@ +Source: sphinx +Section: python +Priority: optional +Maintainer: Mikhail Gusarov +Uploaders: Debian Python Modules Team +Homepage: http://sphinx.pocoo.org/ +Build-Depends: debhelper (>= 7), python-all-dev (>= 2.3.5-11), python-setuptools (>= 0.6c5), quilt (>= 0.40) +Build-Depends-Indep: python-central (>= 0.5.6), python-docutils, python-pygments (>= 0.8), python-jinja (>= 1.1) +Standards-Version: 3.8.0 +XS-Python-Version: >=2.4 +Vcs-Svn: svn://svn.debian.org/python-modules/packages/sphinx/trunk/ +Vcs-Browser: http://svn.debian.org/viewsvn/python-modules/packages/sphinx/trunk/ + +Package: python-sphinx +Architecture: all +Depends: ${python:Depends}, python-docutils, python-pygments (>= 0.8), python-jinja (>= 1.1), libjs-jquery +Recommends: python (>= 2.6) | python-simplejson, python-imaging +Suggests: jsmath +XB-Python-Version: ${python:Versions} +Description: tool for producing documentation 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 doctrings from Python modules. --- sphinx-0.5.1.orig/debian/patches/series +++ sphinx-0.5.1/debian/patches/series @@ -0,0 +1 @@ +disable_ez_setup.patch --- sphinx-0.5.1.orig/debian/patches/disable_ez_setup.patch +++ sphinx-0.5.1/debian/patches/disable_ez_setup.patch @@ -0,0 +1,15 @@ +all dependencies should be are already installed (see Build-Depends*), +ignore ez_setup's attempt to download different version of setuptools +Index: sphinx-0.5.1/setup.py +=================================================================== +--- sphinx-0.5.1.orig/setup.py ++++ sphinx-0.5.1/setup.py +@@ -1,6 +1,6 @@ + # -*- coding: utf-8 -*- +-import ez_setup +-ez_setup.use_setuptools() ++#import ez_setup ++#ez_setup.use_setuptools() + + import os + import sys