[med-svn] [mypy] 05/07: Provide the documentation in mypy-doc

[Ghislain Vaillant]

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

ghisvail-guest pushed a commit to branch master
in repository mypy.

commit 100f06aa191803d8eae5657f24191df6224746ea
Author: Ghislain Antony Vaillant <ghisvail at gmail.com>
Date:   Mon Nov 13 15:55:48 2017 +0000

    Provide the documentation in mypy-doc
---
 debian/control           | 22 +++++++++++++++++++++-
 debian/mypy-doc.doc-base |  9 +++++++++
 debian/mypy-doc.docs     |  1 +
 debian/rules             |  4 +++-
 4 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/debian/control b/debian/control
index e0c43ef..b2f410c 100644
--- a/debian/control
+++ b/debian/control
@@ -12,6 +12,8 @@ Build-Depends: debhelper (>= 10),
                python3-pytest,
                python3-pytest-cov,
                python3-setuptools,
+               python3-sphinx,
+               python3-sphinx-rtd-theme,
                python3-typed-ast (>= 1.1.0)
 Standards-Version: 4.1.1
 Vcs-Browser: https://anonscm.debian.org/cgit/debian-med/mypy.git
@@ -23,9 +25,27 @@ Package: mypy
 Architecture: all
 Depends: ${misc:Depends},
          ${python3:Depends}
-Description: Optional static typing for Python
+Suggests: mypy-doc
+Description: optional static typing for Python
  Add type annotations to your Python programs, and use mypy to type check them.
  Mypy is essentially a Python linter on steroids, and it can catch many
  programming errors by analyzing your program, without actually having to run
  it. Mypy has a powerful type system with features such as type inference,
  gradual typing, generics and union types.
+ .
+ This package provides the command-line interface.
+
+Package: mypy-doc
+Architecture: all
+Section: doc
+Depends: ${misc:Depends},
+         ${sphinxdoc:Depends}
+Built-Using: ${sphinxdoc:Built-Using}
+Description: documentation for mypy
+ Add type annotations to your Python programs, and use mypy to type check them.
+ Mypy is essentially a Python linter on steroids, and it can catch many
+ programming errors by analyzing your program, without actually having to run
+ it. Mypy has a powerful type system with features such as type inference,
+ gradual typing, generics and union types.
+ .
+ This package provides the documentation.
diff --git a/debian/mypy-doc.doc-base b/debian/mypy-doc.doc-base
new file mode 100644
index 0000000..b10eff0
--- /dev/null
+++ b/debian/mypy-doc.doc-base
@@ -0,0 +1,9 @@
+Document: mypy-doc
+Title: Mypy Documentation
+Author: Jukka Lehtosalo
+Abstract: This is the reference documentation for mypy.
+Section: Programming/Python
+
+Format: HTML
+Index: /usr/share/doc/mypy-doc/html/index.html
+Files: /usr/share/doc/mypy-doc/html/*.html
diff --git a/debian/mypy-doc.docs b/debian/mypy-doc.docs
new file mode 100644
index 0000000..a213c54
--- /dev/null
+++ b/debian/mypy-doc.docs
@@ -0,0 +1 @@
+docs/build/html
diff --git a/debian/rules b/debian/rules
index c8a9278..391f3b3 100755
--- a/debian/rules
+++ b/debian/rules
@@ -9,7 +9,7 @@ PPATH=$(CURDIR)
 PY3V=$(shell py3versions -dv)
 include /usr/share/dpkg/pkg-info.mk
 %:
-	dh $@ --with python3 --buildsystem=pybuild
+	dh $@ --with python3,sphinxdoc --buildsystem=pybuild
 
 override_dh_auto_build:
 	dh_auto_build
@@ -20,7 +20,9 @@ override_dh_auto_build:
 		   --no-discard-stderr --version-string="${DEB_VERSION_UPSTREAM}" \
 		   --name 'Generate draft stubs for Python modules.' > \
 		   debian/stubgen.1
+	PYTHONPATH=$(CURDIR) $(MAKE) -C docs html
 
 override_dh_auto_clean:
 	rm -f debian/*.1
 	dh_auto_clean
+	$(MAKE) -C docs clean

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-med/mypy.git