<div dir="ltr">Thanks!</div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Feb 9, 2017 at 6:12 AM, David Bozier via llvm-commits <span dir="ltr"><<a href="mailto:llvm-commits@lists.llvm.org" target="_blank">llvm-commits@lists.llvm.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Author: davidb<br>
Date: Thu Feb 9 08:12:30 2017<br>
New Revision: 294586<br>
<br>
URL: <a href="http://llvm.org/viewvc/llvm-project?rev=294586&view=rev" rel="noreferrer" target="_blank">http://llvm.org/viewvc/llvm-<wbr>project?rev=294586&view=rev</a><br>
Log:<br>
[docs] cleanup documentation on lit substitutions<br>
<br>
1. Added missing substitutions to the documentation in docs/TestingGuide.rst<br>
2. Modified docs/CommandGuide/lit.rst to only document the "base" set of substitutions and to refer the reader to docs/TestingGuide.rst for more detailed info on substitutions.<br>
<br>
Patch by bd1976llvm<br>
<br>
Differential Revision: <a href="https://reviews.llvm.org/D29281" rel="noreferrer" target="_blank">https://reviews.llvm.org/<wbr>D29281</a><br>
<br>
<br>
Modified:<br>
llvm/trunk/docs/CommandGuide/<wbr>lit.rst<br>
llvm/trunk/docs/TestingGuide.<wbr>rst<br>
<br>
Modified: llvm/trunk/docs/CommandGuide/<wbr>lit.rst<br>
URL: <a href="http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CommandGuide/lit.rst?rev=294586&r1=294585&r2=294586&view=diff" rel="noreferrer" target="_blank">http://llvm.org/viewvc/llvm-<wbr>project/llvm/trunk/docs/<wbr>CommandGuide/lit.rst?rev=<wbr>294586&r1=294585&r2=294586&<wbr>view=diff</a><br>
==============================<wbr>==============================<wbr>==================<br>
--- llvm/trunk/docs/CommandGuide/<wbr>lit.rst (original)<br>
+++ llvm/trunk/docs/CommandGuide/<wbr>lit.rst Thu Feb 9 08:12:30 2017<br>
@@ -379,7 +379,7 @@ PRE-DEFINED SUBSTITUTIONS<br>
~~~~~~~~~~~~~~~~~~~~~~~~~~<br>
<br>
:program:`lit` provides various patterns that can be used with the RUN command.<br>
-These are defined in TestRunner.py.<br>
+These are defined in TestRunner.py. The base set of substitutions are:<br>
<br>
========== ==============<br>
Macro Substitution<br>
@@ -391,17 +391,13 @@ These are defined in TestRunner.py.<br>
%t temporary file name unique to the test<br>
%T temporary directory unique to the test<br>
%% %<br>
- %/s same as %s but replace all / with \\<br>
- %/S same as %S but replace all / with \\<br>
- %/p same as %p but replace all / with \\<br>
- %/t same as %t but replace all / with \\<br>
- %/T same as %T but replace all / with \\<br>
========== ==============<br>
<br>
-Further substitution patterns might be defined by each test module.<br>
-See the modules :ref:`local-configuration-<wbr>files`.<br>
+Other substitutions are provided that are variations on this base set and<br>
+further substitution patterns can be defined by each test module. See the<br>
+modules :ref:`local-configuration-<wbr>files`.<br>
<br>
-More information on the testing infrastucture can be found in the<br>
+More detailed information on substitutions can be found in the<br>
:doc:`../TestingGuide`.<br>
<br>
TEST RUN OUTPUT FORMAT<br>
<br>
Modified: llvm/trunk/docs/TestingGuide.<wbr>rst<br>
URL: <a href="http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/TestingGuide.rst?rev=294586&r1=294585&r2=294586&view=diff" rel="noreferrer" target="_blank">http://llvm.org/viewvc/llvm-<wbr>project/llvm/trunk/docs/<wbr>TestingGuide.rst?rev=294586&<wbr>r1=294585&r2=294586&view=diff</a><br>
==============================<wbr>==============================<wbr>==================<br>
--- llvm/trunk/docs/TestingGuide.<wbr>rst (original)<br>
+++ llvm/trunk/docs/TestingGuide.<wbr>rst Thu Feb 9 08:12:30 2017<br>
@@ -468,6 +468,25 @@ RUN lines:<br>
<br>
Expands to the path separator, i.e. ``:`` (or ``;`` on Windows).<br>
<br>
+``%/s, %/S, %/t, %/T:``<br>
+<br>
+ Act like the corresponding substitution above but replace any ``\``<br>
+ character with a ``/``. This is useful to normalize path separators.<br>
+<br>
+ Example: ``%s: C:\Desktop Files/foo_test.s.tmp``<br>
+<br>
+ Example: ``%/s: C:/Desktop Files/foo_test.s.tmp``<br>
+<br>
+``%:s, %:S, %:t, %:T:``<br>
+<br>
+ Act like the corresponding substitution above but remove colons at<br>
+ the beginning of Windows paths. This is useful to allow concatenation<br>
+ of absolute paths on Windows to produce a legal path.<br>
+<br>
+ Example: ``%s: C:\Desktop Files\foo_test.s.tmp``<br>
+<br>
+ Example: ``%:s: C\Desktop Files\foo_test.s.tmp``<br>
+<br>
<br>
**LLVM-specific substitutions:**<br>
<br>
<br>
<br>
______________________________<wbr>_________________<br>
llvm-commits mailing list<br>
<a href="mailto:llvm-commits@lists.llvm.org">llvm-commits@lists.llvm.org</a><br>
<a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-commits" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/<wbr>mailman/listinfo/llvm-commits</a><br>
</blockquote></div><br></div>