talloc: Add ability to generate Python docs using pydoctor.

diff --git a/lib/talloc/Makefile b/lib/talloc/Makefile
index 5b8220c6cb7fc476f57dc9dfb8eac50417343a94..95564ebc6de566b7829e6f2e6a257aacd4ebf0b1 100644 (file)
--- a/lib/talloc/Makefile
+++ b/lib/talloc/Makefile
@@ -56,6 +56,9 @@ etags:
 ctags:
        $(WAF) ctags
 
+pydoctor:
+       $(WAF) pydoctor
+
 bin/%:: FORCE
        $(WAF) --targets=`basename $@`
 FORCE:

diff --git a/lib/talloc/wscript b/lib/talloc/wscript
index 49eac6e6e6dd8c08b804c07f7dffe4383b9597ca..b4cb84bbd8a000edf94f5a9c38cfa8f6ac2bcd27 100644 (file)
--- a/lib/talloc/wscript
+++ b/lib/talloc/wscript
@@ -141,3 +141,10 @@ def reconfigure(ctx):
     '''reconfigure if config scripts have changed'''
     import samba_utils
     samba_utils.reconfigure(ctx)
+
+
+def pydoctor(ctx):
+    '''build python apidocs'''
+    cmd='PYTHONPATH=bin/python pydoctor --project-name=talloc --project-url=http://talloc.samba.org/ --make-html --docformat=restructuredtext --introspect-c-modules --add-module bin/python/talloc.*'
+    print("Running: %s" % cmd)
+    os.system(cmd)