r199256 - Driver: clarify help string for "-###"
Tim Northover
tnorthover at apple.com
Tue Jan 14 12:49:19 PST 2014
Author: tnorthover
Date: Tue Jan 14 14:49:19 2014
New Revision: 199256
URL: http://llvm.org/viewvc/llvm-project?rev=199256&view=rev
Log:
Driver: clarify help string for "-###"
Someone recently wasted some time not realising that "-###" didn't
actually execute the commands it printed, and suggested a
documentation tweak.
Having made the same mistake myself on at least one occasion, I
sympathise. So here it is. Any kibitzing on an even better text
welcome.
Modified:
cfe/trunk/docs/tools/clang.pod
cfe/trunk/include/clang/Driver/Options.td
Modified: cfe/trunk/docs/tools/clang.pod
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/tools/clang.pod?rev=199256&r1=199255&r2=199256&view=diff
==============================================================================
--- cfe/trunk/docs/tools/clang.pod (original)
+++ cfe/trunk/docs/tools/clang.pod Tue Jan 14 14:49:19 2014
@@ -380,7 +380,7 @@ to the linker depending on the stage sel
=item B<-###>
-Print the commands to run for this compilation.
+Print (but do not run) the commands to run for this compilation.
=item B<--help>
Modified: cfe/trunk/include/clang/Driver/Options.td
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/include/clang/Driver/Options.td?rev=199256&r1=199255&r2=199256&view=diff
==============================================================================
--- cfe/trunk/include/clang/Driver/Options.td (original)
+++ cfe/trunk/include/clang/Driver/Options.td Tue Jan 14 14:49:19 2014
@@ -198,7 +198,7 @@ def ccc_ : Joined<["-"], "ccc-">, Group<
// Standard Options
def _HASH_HASH_HASH : Flag<["-"], "###">, Flags<[DriverOption, CoreOption]>,
- HelpText<"Print the commands to run for this compilation">;
+ HelpText<"Print (but do not run) the commands to run for this compilation">;
def _DASH_DASH : Option<["--"], "", KIND_REMAINING_ARGS>,
Flags<[DriverOption, CoreOption]>;
def A : JoinedOrSeparate<["-"], "A">, Flags<[RenderJoined]>;
More information about the cfe-commits
mailing list