From: Christopher Lenz <cmlenz@gmail.com>
Date: Fri, 15 Jun 2007 18:27:38 +0000 (+0000)
Subject: Moved doc config into a subdirectory, and added a `--force` option to the `build_doc... 
X-Git-Tag: 1.0~513
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ce4e27cc7f8f4c1faee0749bc8da6c02f9519922;p=thirdparty%2Fbabel.git

Moved doc config into a subdirectory, and added a `--force` option to the `build_doc` command.
---

diff --git a/doc/docutils.conf b/doc/conf/docutils.ini
similarity index 100%
rename from doc/docutils.conf
rename to doc/conf/docutils.ini
diff --git a/doc/epydoc.conf b/doc/conf/epydoc.ini
similarity index 100%
rename from doc/epydoc.conf
rename to doc/conf/epydoc.ini
diff --git a/setup.py b/setup.py
index b27adc9f..8efd523f 100755
--- a/setup.py
+++ b/setup.py
@@ -26,12 +26,15 @@ import sys
 class build_doc(Command):
     description = 'Builds the documentation'
     user_options = [
+        ('force', None,
+         "force regeneration even if no reStructuredText files have changed"),
         ('without-apidocs', None,
          "whether to skip the generation of API documentaton"),
     ]
-    boolean_options = ['without-apidocs']
+    boolean_options = ['force', 'without-apidocs']
 
     def initialize_options(self):
+        self.force = False
         self.without_apidocs = False
 
     def finalize_options(self):
@@ -42,8 +45,8 @@ class build_doc(Command):
         from docutils.nodes import raw
         from docutils.parsers import rst
 
-        docutils_conf = os.path.join('doc', 'docutils.conf')
-        epydoc_conf = os.path.join('doc', 'epydoc.conf')
+        docutils_conf = os.path.join('doc', 'conf', 'docutils.ini')
+        epydoc_conf = os.path.join('doc', 'conf', 'epydoc.ini')
 
         try:
             from pygments import highlight
@@ -64,8 +67,8 @@ class build_doc(Command):
 
         for source in glob('doc/*.txt'):
             dest = os.path.splitext(source)[0] + '.html'
-            if not os.path.exists(dest) or \
-                   os.path.getmtime(dest) < os.path.getmtime(source):
+            if self.force or not os.path.exists(dest) or \
+                    os.path.getmtime(dest) < os.path.getmtime(source):
                 print 'building documentation file %s' % dest
                 publish_cmdline(writer_name='html',
                                 argv=['--config=%s' % docutils_conf, source,