From 2a11b0a723012c67949cb953807638523be884b7 Mon Sep 17 00:00:00 2001 From: Jim Weirich Date: Fri, 16 Nov 2012 14:51:27 -0500 Subject: [PATCH 1/2] Document options for --trace and --backtrace. --- doc/command_line_usage.rdoc | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/doc/command_line_usage.rdoc b/doc/command_line_usage.rdoc index 5a1aa5cf1..7dfeb67fe 100644 --- a/doc/command_line_usage.rdoc +++ b/doc/command_line_usage.rdoc @@ -15,11 +15,13 @@ Options are: Used in combination with the -T and -D options, will force those options to show all the tasks, even the ones without comments. -[--backtrace _output_ (-n)] +[--backtrace{=_output_} (-n)] Enable a full backtrace (i.e. like --trace, but without the task - tracing details). The backtrace output will be directed to stderr - by default. If the options _output_ parameter is set to "stdout", - then the output will be directed to standard output. + tracing details). The _output_ parameter is optional, but if + specified it controls where the backtrace output is sent. If + _output_ is stdout, then backtrace output is directed to + stardard output. If _output_ is stderr, or if it is + messing, then the backtrace output is sent to standard error. [--classic-namespace (-n)] Import the Task, FileTask, and FileCreateTask into the top-level @@ -140,9 +142,13 @@ Options are: are defined using the "desc" command. If a pattern is given, then only tasks matching the pattern are displayed. -[--trace (-t)] +[--trace{=_output_} (-t)] Turn on invoke/execute tracing. Also enable full backtrace on - errors. + errors. The _output_ parameter is optional, but if specified it + controls where the trace output is sent. If _output_ is + stdout, then trace output is directed to stardard output. + If _output_ is stderr, or if it is messing, then trace + output is sent to standard error. [--verbose (-v)] Echo the Sys commands to standard output. From 3d8e3fa28e2e730244e79697bf4db8d353b8f227 Mon Sep 17 00:00:00 2001 From: Jim Weirich Date: Fri, 16 Nov 2012 14:56:04 -0500 Subject: [PATCH 2/2] Fix typo: messing => missing --- doc/command_line_usage.rdoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/command_line_usage.rdoc b/doc/command_line_usage.rdoc index 7dfeb67fe..277fd5ee3 100644 --- a/doc/command_line_usage.rdoc +++ b/doc/command_line_usage.rdoc @@ -21,7 +21,7 @@ Options are: specified it controls where the backtrace output is sent. If _output_ is stdout, then backtrace output is directed to stardard output. If _output_ is stderr, or if it is - messing, then the backtrace output is sent to standard error. + missing, then the backtrace output is sent to standard error. [--classic-namespace (-n)] Import the Task, FileTask, and FileCreateTask into the top-level @@ -147,7 +147,7 @@ Options are: errors. The _output_ parameter is optional, but if specified it controls where the trace output is sent. If _output_ is stdout, then trace output is directed to stardard output. - If _output_ is stderr, or if it is messing, then trace + If _output_ is stderr, or if it is missing, then trace output is sent to standard error. [--verbose (-v)]