build: align help options

While it's aesthetically nice to start the help message in a new line
looking at the code, the first \n screws the output leaving them not
aligned.

Tools/ardupilotwaf/ardupilotwaf.py

@@ -394,18 +394,16 @@ def options(opt):
     g.add_option('--program-group',
         action='append',
         default=[],
-        help='''
+        help='''Select all programs that go in <PROGRAM_GROUP>/ for the build.
-Select all programs that go in <PROGRAM_GROUP>/ for the build. Example: `waf
+Example: `waf --program-group examples` builds all examples. The
---program-group examples` builds all examples. The special group "all" selects
+special group "all" selects all programs.
-all programs.
 ''')
 
     g.add_option('--upload',
         action='store_true',
-        help='''
+        help='''Upload applicable targets to a connected device. Not all
-Upload applicable targets to a connected device. Not all platforms may support
+platforms may support this. Example: `waf copter --upload` means "build
-this. Example: `waf copter --upload` means "build arducopter and upload it to
+arducopter and upload it to my board".
-my board".
 ''')
 
     g = opt.ap_groups['check']
@@ -418,12 +416,12 @@ my board".
 
     g.add_option('--clean-all-sigs',
         action='store_true',
-        help='''
+        help='''Clean signatures for all tasks. By default, tasks that scan for
-Clean signatures for all tasks. By default, tasks that scan for implicit
+implicit dependencies (like the compilation tasks) keep the dependency
-dependencies (like the compilation tasks) keep the dependency information
+information across clean commands, so that that information is changed
-across clean commands, so that that information is changed only when really
+only when really necessary. Also, some tasks that don't really produce
-necessary. Also, some tasks that don't really produce files persist their
+files persist their signature. This option avoids that behavior when
-signature. This option avoids that behavior when cleaning the build.
+cleaning the build.
 ''')
 
 def build(bld):

Tools/ardupilotwaf/build_summary.py

@@ -209,9 +209,8 @@ def options(opt):
 
     g.add_option('--summary-all',
         action='store_true',
-        help='''
+        help='''Print build summary for all targets. By default, only
-Print build summary for all targets. By default, only information about the
+information about the first %d targets will be printed.
-first %d targets will be printed.
 ''' % MAX_TARGETS)
 
 def configure(cfg):

wscript

@@ -68,18 +68,17 @@ def options(opt):
         dest='autoconfig',
         action='store_false',
         default=True,
-        help='''
+        help='''Disable autoconfiguration feature. By default, the build system
-Disable autoconfiguration feature. By default, the build system triggers a
+triggers a reconfiguration whenever it thinks it's necessary - this
-reconfiguration whenever it thinks it's necessary - this option disables that.
+option disables that.
 ''')
 
     g.add_option('--no-submodule-update',
         dest='submodule_update',
         action='store_false',
         default=True,
-        help='''
+        help='''Don't update git submodules. Useful for building with
-Don't update git submodules. Useful for building with submodules at specific
+submodules at specific revisions.
-revisions.
 ''')
 
     g.add_option('--disable-header-checks', action='store_true',
@@ -96,9 +95,8 @@ revisions.
         dest='rsync_dest',
         action='store',
         default='',
-        help='''
+        help='''Destination for the rsync Waf command. It can be passed during
-Destination for the rsync Waf command. It can be passed during configuration in
+configuration in order to save typing.
-order to save typing.
 ''')
 
     g.add_option('--enable-benchmarks',