gecko-dev/python/mozbuild
Gregory Szorc 67e6a15a08 Bug 1173633 - Print docstrings of mach command handlers in help output; r=ahal
`mach help <command>` currently only displays a brief description of the
command along with its arguments. Sometimes more detailed help text is
needed.

With this commit, the docstrings of mach command handlers will appear in
the output of `mach help <command>` if they are defined.

I've implemented basic docstrings for the three flavors of mach commands
(normal command, main subcommand, subcommand) to demonstate things work.

My hope is others will start to fill in docstrings once this feature
lands so the output for `mach help` can serve as a better learning guide
for new contributors.

--HG--
extra : commitid : Hx6ZkHDxbCK
extra : rebase_source : 01ced5a044442e370a45cd3fb245ac6283316925
extra : amend_source : fceb771e0e1ffa4e6f3f1b7c22eae6e25cf82034
2015-06-11 08:32:02 -07:00
..
dumbmake Bug 869613 - Make mach build some/deeper/path do dependencies for some and 2013-09-27 14:47:37 -04:00
mozbuild Bug 1173633 - Print docstrings of mach command handlers in help output; r=ahal 2015-06-11 08:32:02 -07:00
mozpack Bug 1168607 - Add a native Mercurial finder; r=glandium 2015-06-09 13:49:45 -07:00
setup.py Bug 780561 - Import new packager code. r=gps 2013-01-23 11:23:14 +01:00
TODO Bug 784841 - Part 2: Implement sandboxing for Python build files; r=ted,glandium 2013-01-15 22:21:21 -08:00