[keras] 03/07: Add a documentation package.

[Stephen Sinclair]

This is an automated email from the git hooks/post-receive script.

sinclairs-guest pushed a commit to branch master
in repository keras.

commit 460b9e5a6a0848bc968ce706822199053dd9e424
Author: Stephen Sinclair <radarsat1 at gmail.com>
Date:   Tue Nov 7 11:45:40 2017 -0300

    Add a documentation package.
---
 debian/control | 28 ++++++++++++++++++++++++++++
 debian/rules   | 23 ++++++++++++++++++++---
 2 files changed, 48 insertions(+), 3 deletions(-)

diff --git a/debian/control b/debian/control
index 25c7292..49603ff 100644
--- a/debian/control
+++ b/debian/control
@@ -19,6 +19,7 @@ Build-Depends:
  python3-pandas,
  python3-pil,
  markdown,
+ mkdocs,
  links
 Standards-Version: 4.1.1
 Homepage: http://keras.io/
@@ -49,3 +50,30 @@ Description: deep learning framework running on Theano or TensorFlow
  compiler) by default, which makes it possible to accelerate the computations
  by using (GP)GPU devices. Alternatively, Keras could run on Google's
  TensorFlow (not yet available in Debian, but coming up).
+
+Package: keras-doc
+Architecture: all
+Section: doc
+Depends:
+ ${misc:Depends}
+Suggests:
+ python3-keras
+Description: CPU/GPU math expression compiler for Python (docs)
+ Keras is a Python library for machine learning based on deep (multi-
+ layered) artificial neural networks (DNN), which follows a minimalistic
+ and modular design with a focus on fast experimentation.
+ .
+ Features of DNNs like neural layers, cost functions, optimizers,
+ initialization schemes, activation functions and regularization schemes
+ are available in Keras a standalone modules which can be plugged together
+ as wanted to create sequence models or more complex architectures.
+ Keras supports convolutions neural networks (CNN, used for image
+ recognition resp. classification) and recurrent neural networks (RNN,
+ suitable for sequence analysis like in natural language processing).
+ .
+ It runs as an abstraction layer on the top of Theano (math expression
+ compiler) by default, which makes it possible to accelerate the computations
+ by using (GP)GPU devices. Alternatively, Keras could run on Google's
+ TensorFlow (not yet available in Debian, but coming up).
+ .
+ This package contains the documentation for Keras.
diff --git a/debian/rules b/debian/rules
index fa23886..2c5de83 100755
--- a/debian/rules
+++ b/debian/rules
@@ -3,7 +3,12 @@
 #export DEB_BUILD_OPTIONS=nocheck
 export PYBUILD_NAME=keras
 
-export THEANO_FLAGS=base_compiledir='.pybuild'
+export KERAS_BACKEND=theano
+export THEANO_FLAGS=base_compiledir='.pybuild',device=cpu
+export PYTHONDONTWRITEBYTECODE=1
+
+export LC_ALL=C.UTF-8
+export LANG=C.UTF-8
 
 # require tensorflow but not SKIPPED
 TESTSTOIGNORE=\
@@ -29,6 +34,18 @@ IGNORETESTS=$(TESTSTOIGNORE:%=--ignore=%)
 %:
 	dh $@ --with python3 --buildsystem=pybuild
 
+override_dh_auto_build-indep:
+	dh_auto_build
+# In the PyPI distribution the file CONTRIBUTING.md is missing, which
+# causes an error during doc build, so make it an empty file.
+ifeq ($(filter nodoc,$(DEB_BUILD_PROFILES)),)
+	cd docs && sh -c "env PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=.. python3 autogen.py && mkdocs build --site-dir=html"
+# Despite PYTHONDONTWRITEBYTECODE, a __pycache__ is nonetheless generated by mkdocs!
+	find . -type d -name __pycache__ | xargs rm -rfv
+# Distributed docs should not contain any programs
+	rm -fv docs/html/*.py
+endif
+
 override_dh_auto_test:
 # Run tests using Theano backend and CPU device.
 # Not every test is expected to pass, so we run a subset here:
@@ -36,8 +53,8 @@ override_dh_auto_test:
 
 override_dh_installdocs:
 	markdown README.md > .pybuild/README.html
-	LC_LANG=C.UTF-8 links -dump .pybuild/README.html > .pybuild/README
-	dh_installdocs .pybuild/README
+	links -dump .pybuild/README.html > .pybuild/README
+	dh_installdocs -A .pybuild/README
 
 override_dh_compress:
 	dh_compress -X.py

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/keras.git