diff --git a/CHANGES b/CHANGES index 67c8155b4..5f5ab76d9 100644 --- a/CHANGES +++ b/CHANGES @@ -1,6 +1,9 @@ Release 1.2 (in development) ============================ +* sphinx-build now supports the standard :option:`--help` and + :option:`--version` options. + * #869: sphinx-build now has the option :option:`-T` for printing the full traceback after an unhandled exception. diff --git a/sphinx/cmdline.py b/sphinx/cmdline.py index 9b8d8ae2e..026bcd45c 100644 --- a/sphinx/cmdline.py +++ b/sphinx/cmdline.py @@ -60,6 +60,8 @@ new and changed files -W -- turn warnings into errors -P -- run Pdb on exception -T -- show full traceback on exception + --help -- show this help and exit + --version -- show version information and exit Modi: * without -a and without filenames, write new and changed files. * with -a, write all files. @@ -72,8 +74,15 @@ def main(argv): nocolor() try: - opts, args = getopt.getopt(argv[1:], 'ab:t:d:c:CD:A:ng:NEqQWw:PT') + opts, args = getopt.getopt(argv[1:], 'ab:t:d:c:CD:A:ng:NEqQWw:PTh', + ['help', 'version']) allopts = set(opt[0] for opt in opts) + if '-h' in allopts or '--help' in allopts: + usage(argv) + return 0 + if '--version' in allopts: + print 'Sphinx (sphinx-build) %s' % __version__ + return 0 srcdir = confdir = abspath(args[0]) if not path.isdir(srcdir): print >>sys.stderr, 'Error: Cannot find source directory `%s\'.' % (