From: Jelmer Vernooij <jelmer@samba.org>
Date: Sat, 11 Dec 2010 00:05:13 +0000 (+0100)
Subject: talloc: Add ability to generate Python docs using pydoctor.
X-Git-Url: http://git.samba.org/?p=metze%2Fsamba%2Fwip.git;a=commitdiff_plain;h=68d97f8b492d1d075ed77a4bab7f178d10570106

talloc: Add ability to generate Python docs using pydoctor.
---

diff --git a/lib/talloc/Makefile b/lib/talloc/Makefile
index 5b8220c6cb7f..95564ebc6de5 100644
--- 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 49eac6e6e6dd..b4cb84bbd8a0 100644
--- 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)