changeset 100:3eaa652b1216

Add `--without-apidocs` switch to `build_doc` command for quicker doc-edit/review cycles.
author cmlenz
date Wed, 13 Jun 2007 07:48:06 +0000
parents b6b5992daa6c
children d61861014473
files doc/formatting.txt setup.py
diffstat 2 files changed, 23 insertions(+), 18 deletions(-) [+]
line wrap: on
line diff
--- a/doc/formatting.txt
+++ b/doc/formatting.txt
@@ -14,10 +14,12 @@
 ===============
 
 When working with date and time information in Python, you commonly use the
-classes ``date``, ``datetime`` and/or ``time`` from the `datetime package`_.
+classes ``date``, ``datetime`` and/or ``time`` from the `datetime`_ package.
 Babel provides functions for locale-specific formatting of those objects in its
 ``dates`` module:
 
+.. _`datetime`: http://docs.python.org/lib/module-datetime.html
+
 .. code-block:: pycon
 
     >>> from datetime import date, datetime, time
@@ -51,8 +53,6 @@
     >>> format_date(d, format='full', locale='en')
     u'Sunday, April 1, 2007'
 
-.. _`datetime package`: http://docs.python.org/lib/module-datetime.html
-
 
 Pattern Syntax
 --------------
--- a/setup.py
+++ b/setup.py
@@ -25,10 +25,14 @@
 
 class build_doc(Command):
     description = 'Builds the documentation'
-    user_options = []
+    user_options = [
+        ('without-apidocs', None,
+         "whether to skip the generation of API documentaton"),
+    ]
+    boolean_options = ['without-apidocs']
 
     def initialize_options(self):
-        pass
+        self.without_apidocs = False
 
     def finalize_options(self):
         pass
@@ -67,20 +71,21 @@
                                 argv=['--config=%s' % docutils_conf, source,
                                       dest])
 
-        try:
-            from epydoc import cli
-            old_argv = sys.argv[1:]
-            sys.argv[1:] = [
-                '--config=%s' % epydoc_conf,
-                '--no-private', # epydoc bug, not read from config
-                '--simple-term',
-                '--verbose'
-            ]
-            cli.cli()
-            sys.argv[1:] = old_argv
+        if not self.without_apidocs:
+            try:
+                from epydoc import cli
+                old_argv = sys.argv[1:]
+                sys.argv[1:] = [
+                    '--config=%s' % epydoc_conf,
+                    '--no-private', # epydoc bug, not read from config
+                    '--simple-term',
+                    '--verbose'
+                ]
+                cli.cli()
+                sys.argv[1:] = old_argv
 
-        except ImportError:
-            print 'epydoc not installed, skipping API documentation.'
+            except ImportError:
+                print 'epydoc not installed, skipping API documentation.'
 
 
 class test_doc(Command):
Copyright (C) 2012-2017 Edgewall Software