Mercurial > pylearn
diff doc/scripts/docgen.py @ 1516:57feab73c783
Remove :api: role, do not generate epydoc by default
author | Pascal Lamblin <lamblinp@iro.umontreal.ca> |
---|---|
date | Mon, 05 Mar 2012 17:35:15 -0500 |
parents | 9472d234db2e |
children |
line wrap: on
line diff
--- a/doc/scripts/docgen.py Wed Feb 29 12:43:07 2012 -0500 +++ b/doc/scripts/docgen.py Mon Mar 05 17:35:15 2012 -0500 @@ -28,7 +28,9 @@ print ' --help: this help' sys.exit(0) - options['--all'] = not (bool(options['--epydoc']) ^ bool(options['--rst'])) + if not (options['--epydoc'] or options['--rst']): + # Default is now rst + options['--rst'] = True def mkdir(path): try: @@ -39,8 +41,6 @@ outdir = options['-o'] or (pylearn_root + '/html') mkdir(outdir) os.chdir(outdir) - mkdir("doc") - mkdir("api") # Make sure the appropriate 'theano' directory is in the PYTHONPATH pythonpath = os.environ.get('PYTHONPATH', '') @@ -48,6 +48,7 @@ os.environ['PYTHONPATH'] = pythonpath if options['--all'] or options['--epydoc']: + mkdir("api") from epydoc.cli import cli sys.path[0:0] = [pylearn_root] @@ -63,6 +64,7 @@ # TODO if options['--all'] or options['--rst']: + mkdir("doc") import sphinx sys.path[0:0] = [os.path.join(pylearn_root, 'doc')] sphinx.main(['', '-E', os.path.join(pylearn_root, 'doc'), '.'])