[Python-modules-commits] r30311 - in packages/configobj/trunk/debian (7 files)

[bdrung at users.alioth.debian.org]

    Date: Thursday, August 28, 2014 @ 16:25:59
  Author: bdrung
Revision: 30311

Move documentation into separate package and build Sphinx documentation.

Added:
  packages/configobj/trunk/debian/python-configobj-doc.doc-base
    (from rev 30310, packages/configobj/trunk/debian/python-configobj.doc-base.api)
  packages/configobj/trunk/debian/python-configobj-doc.docs
    (from rev 30310, packages/configobj/trunk/debian/python-configobj.docs)
Modified:
  packages/configobj/trunk/debian/control
  packages/configobj/trunk/debian/rules
Deleted:
  packages/configobj/trunk/debian/clean
  packages/configobj/trunk/debian/python-configobj.doc-base.api
  packages/configobj/trunk/debian/python-configobj.docs

Deleted: packages/configobj/trunk/debian/clean
===================================================================
--- packages/configobj/trunk/debian/clean	2014-08-28 14:25:34 UTC (rev 30310)
+++ packages/configobj/trunk/debian/clean	2014-08-28 16:25:59 UTC (rev 30311)
@@ -1,3 +0,0 @@
-*.egg-info/*
-*.pyc
-api/*

Modified: packages/configobj/trunk/debian/control
===================================================================
--- packages/configobj/trunk/debian/control	2014-08-28 14:25:34 UTC (rev 30310)
+++ packages/configobj/trunk/debian/control	2014-08-28 16:25:59 UTC (rev 30311)
@@ -12,10 +12,13 @@
  python-epydoc,
  python-pytest,
  python-setuptools,
+ python-six,
+ python-sphinx,
  python-unittest2,
  python3-all,
  python3-pytest,
- python3-setuptools
+ python3-setuptools,
+ python3-six
 Standards-Version: 3.9.5
 Homepage: http://www.voidspace.org.uk/python/configobj.html
 X-Python-Version: >= 2.6
@@ -27,6 +30,7 @@
 Package: python-configobj
 Architecture: all
 Depends: ${misc:Depends}, ${python:Depends}
+Suggests: python-configobj-doc
 Description: simple but powerful config file reader and writer for Python 2
  ConfigObj is a simple but powerful config file reader and writer: an
  ini file round tripper. Its main feature is that it is very easy to
@@ -48,9 +52,35 @@
  .
   This is the Python 2 version of the package.
 
+Package: python-configobj-doc
+Architecture: all
+Section: doc
+Depends: ${misc:Depends}, ${sphinxdoc:Depends}
+Description: simple but powerful config file reader and writer (documentation)
+ ConfigObj is a simple but powerful config file reader and writer: an
+ ini file round tripper. Its main feature is that it is very easy to
+ use, with a straightforward programmer's interface and a simple
+ syntax for config files. It has lots of other features, though:
+ .
+  * Nested sections (subsections), to any level
+  * List values
+  * Multiple line values
+  * String interpolation (substitution)
+  * Integrated with a powerful validation system
+    + including automatic type checking/conversion
+    + and allowing default values
+    + repeated sections
+  * All comments in the file are preserved
+  * The order of keys/sections is preserved
+  * Full Unicode support
+  * Powerful unrepr mode for storing/retrieving Python data-types
+ .
+ This package includes the documentation in HTML format.
+
 Package: python3-configobj
 Architecture: all
 Depends: ${misc:Depends}, ${python3:Depends}
+Suggests: python-configobj-doc
 Description: simple but powerful config file reader and writer for Python 3
  ConfigObj is a simple but powerful config file reader and writer: an
  ini file round tripper. Its main feature is that it is very easy to

Copied: packages/configobj/trunk/debian/python-configobj-doc.doc-base (from rev 30310, packages/configobj/trunk/debian/python-configobj.doc-base.api)
===================================================================
--- packages/configobj/trunk/debian/python-configobj-doc.doc-base	                        (rev 0)
+++ packages/configobj/trunk/debian/python-configobj-doc.doc-base	2014-08-28 16:25:59 UTC (rev 30311)
@@ -0,0 +1,12 @@
+Document: configobj
+Title: ConfigObj API Reference
+Author: Ken Pizzini
+Abstract: ConfigObj is a simple but powerful config file reader and
+ writer: an ini file round tripper. Its main feature is that it is
+ very easy to use, with a straightforward programmer's interface and a
+ simple syntax for config files.
+Section: Programming
+
+Format: HTML
+Index: /usr/share/doc/python-configobj-doc/html/index.html
+Files: /usr/share/doc/python-configobj-doc/html/*.html

Copied: packages/configobj/trunk/debian/python-configobj-doc.docs (from rev 30310, packages/configobj/trunk/debian/python-configobj.docs)
===================================================================
--- packages/configobj/trunk/debian/python-configobj-doc.docs	                        (rev 0)
+++ packages/configobj/trunk/debian/python-configobj-doc.docs	2014-08-28 16:25:59 UTC (rev 30311)
@@ -0,0 +1 @@
+docs/_build/html

Deleted: packages/configobj/trunk/debian/python-configobj.doc-base.api
===================================================================
--- packages/configobj/trunk/debian/python-configobj.doc-base.api	2014-08-28 14:25:34 UTC (rev 30310)
+++ packages/configobj/trunk/debian/python-configobj.doc-base.api	2014-08-28 16:25:59 UTC (rev 30311)
@@ -1,12 +0,0 @@
-Document: configobj-api
-Title: ConfigObj API Reference
-Author: Ken Pizzini
-Abstract: ConfigObj is a simple but powerful config file reader and
- writer: an ini file round tripper. Its main feature is that it is
- very easy to use, with a straightforward programmer's interface and a
- simple syntax for config files.
-Section: Programming
-
-Format: HTML
-Index: /usr/share/doc/python-configobj/api/index.html
-Files: /usr/share/doc/python-configobj/api/*.html

Deleted: packages/configobj/trunk/debian/python-configobj.docs
===================================================================
--- packages/configobj/trunk/debian/python-configobj.docs	2014-08-28 14:25:34 UTC (rev 30310)
+++ packages/configobj/trunk/debian/python-configobj.docs	2014-08-28 16:25:59 UTC (rev 30311)
@@ -1,2 +0,0 @@
-docs
-api

Modified: packages/configobj/trunk/debian/rules
===================================================================
--- packages/configobj/trunk/debian/rules	2014-08-28 14:25:34 UTC (rev 30310)
+++ packages/configobj/trunk/debian/rules	2014-08-28 16:25:59 UTC (rev 30311)
@@ -4,13 +4,15 @@
 export PYBUILD_NAME=configobj
 
 %:
-	dh $@ --with python2,python3 --buildsystem=pybuild
+	dh $@ --with python2,python3,sphinxdoc --buildsystem=pybuild
 
+override_dh_auto_clean:
+	dh_auto_clean
+	make -C docs clean
+
 override_dh_auto_build:
 	dh_auto_build
-	env PYTHONPATH=`pwd` epydoc --name ConfigObj \
-		--url http://www.voidspace.org.uk/python/configobj.html \
-		-o api configobj
+	make -C docs html
 
 override_dh_auto_test:
 	dh_auto_test -- --test-pytest --test-args "$(CURDIR)/tests"