Building and adding docs to the package.

New package python-kitchen-doc.
This commit is contained in:
Sergio Durigan Junior 2016-07-09 23:47:56 -04:00
parent eda70b07a1
commit 6e60eb1363
5 changed files with 53 additions and 1 deletions

21
debian/control vendored
View file

@ -15,7 +15,7 @@ Build-Depends:
python-sphinx,
python-coverage,
python3-coverage,
locales-all,
locales-all
Standards-Version: 3.9.8
X-Python-Version: >= 2.6
X-Python3-Version: >= 3.4
@ -26,6 +26,7 @@ Vcs-Browser: https://anonscm.debian.org/cgit/python-modules/packages/kitchen.git
Package: python-kitchen
Architecture: all
Depends: ${misc:Depends}, ${python:Depends}
Suggests: python-kitchen-doc
Description: Python library of containers, text and i18n helpers (Python 2)
The kitchen Python package aims at gathering in one place all the snippets of
code that the author originally carried around from project to project to ease
@ -42,6 +43,7 @@ Description: Python library of containers, text and i18n helpers (Python 2)
Package: python3-kitchen
Architecture: all
Depends: ${misc:Depends}, ${python3:Depends}
Suggests: python-kitchen-doc
Description: Python library of containers, text and i18n helpers (Python 3)
The kitchen Python package aims at gathering in one place all the snippets of
code that the author originally carried around from project to project to ease
@ -54,3 +56,20 @@ Description: Python library of containers, text and i18n helpers (Python 3)
* Tools to help deal with PEP386 version format
.
This package installs the library for Python 3.
Package: python-kitchen-doc
Architecture: all
Section: doc
Depends: ${sphinxdoc:Depends}, ${misc:Depends}
Description: Python library of containers, text and i18n helpers (common documentation)
The kitchen Python package aims at gathering in one place all the snippets of
code that the author originally carried around from project to project to ease
the development.
.
A non-exhaustive list of the features provided by kitchen:
* helpers for text and specifically unicode handling i18n support
* a dictionary that treats unicode and str strings as different values
* An helper function to change any non-list value into a single-element list
* Tools to help deal with PEP386 version format
.
This is the common documentation package.

21
debian/python-kitchen-doc.doc-base vendored Normal file
View file

@ -0,0 +1,21 @@
Document: kitchen
Title: Debian kitchen Manual
Author: Toshio Kuratomi
Abstract: This is the manual for kitchen.
kitchen is a Python plugin that aims at gathering in one place all
the snippets of code that the author originally carried around from
project to project to ease the development.
.
A non-exhaustive list of the features provided by kitchen:
* helpers for text and specifically unicode handling i18n support
* a dictionary that treats unicode and str strings as different values
* An helper function to change any non-list value into a single-element list
* Tools to help deal with PEP386 version format
Section: Programming/Python
Format: HTML
Index: /usr/share/doc/python-kitchen-doc/html/index.html
Files:
/usr/share/doc/python-kitchen-doc/html/*.html
/usr/share/doc/python-kitchen-doc/html/_sources/*
/usr/share/doc/python-kitchen-doc/html/_static/*

2
debian/python-kitchen-doc.docs vendored Normal file
View file

@ -0,0 +1,2 @@
kitchen2/docs/_build/html/
NEWS.rst

1
debian/python-kitchen-doc.manpages vendored Normal file
View file

@ -0,0 +1 @@
kitchen2/docs/_build/man/kitchen.1

9
debian/rules vendored
View file

@ -9,3 +9,12 @@ export LANGUAGE =
%:
dh $@ --with python2,python3,sphinxdoc --buildsystem=pybuild
override_dh_auto_build:
dh_auto_build
# Docs from kitchen2 and kitchen3 are basically the same, so we just
# use the ones from kitchen2.
PYTHONPATH=$(CURDIR)/kitchen2/ http_proxy='127.0.0.1:9' \
sphinx-build -N -bhtml kitchen2/docs/ kitchen2/docs/_build/html
PYTHONPATH=$(CURDIR)/kitchen2/ http_proxy='127.0.0.1:9' \
sphinx-build -N -bman kitchen2/docs/ kitchen2/docs/_build/man