RPCS3/llvm
1
0
Fork 0
mirror of https://github.com/RPCS3/llvm.git synced 2025-02-21 19:20:50 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

[docs] cleanup documentation on lit substitutions

Browse Source 
1. Added missing substitutions to the documentation in docs/TestingGuide.rst
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.

Patch by bd1976llvm

Differential Revision: https://reviews.llvm.org/D29281



git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@294586 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
David Bozier 2017-02-09 14:12:30 +00:00
parent 8a37b965ff
commit 56b920f6fe
2 changed files with 24 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
docs/CommandGuide/lit.rst
View File

@ -379,7 +379,7 @@ PRE-DEFINED SUBSTITUTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~
:program:`lit` provides various patterns that can be used with the RUN command. :program:`lit` provides various patterns that can be used with the RUN command.
These are defined in TestRunner.py. These are defined in TestRunner.py. The base set of substitutions are:
========== ============== ========== ==============
Macro Substitution Macro Substitution
@ -391,17 +391,13 @@ These are defined in TestRunner.py.
%t temporary file name unique to the test %t temporary file name unique to the test
%T temporary directory unique to the test %T temporary directory unique to the test
%% % %% %
%/s same as %s but replace all / with \\
%/S same as %S but replace all / with \\
%/p same as %p but replace all / with \\
%/t same as %t but replace all / with \\
%/T same as %T but replace all / with \\
========== ============== ========== ==============
Further substitution patterns might be defined by each test module. Other substitutions are provided that are variations on this base set and
See the modules :ref:`local-configuration-files`. further substitution patterns can be defined by each test module. See the
modules :ref:`local-configuration-files`.
More information on the testing infrastucture can be found in the More detailed information on substitutions can be found in the
:doc:`../TestingGuide`. :doc:`../TestingGuide`.
TEST RUN OUTPUT FORMAT TEST RUN OUTPUT FORMAT

19
docs/TestingGuide.rst
View File

@ -468,6 +468,25 @@ RUN lines:
Expands to the path separator, i.e. ``:`` (or ``;`` on Windows). Expands to the path separator, i.e. ``:`` (or ``;`` on Windows).
``%/s, %/S, %/t, %/T:``
Act like the corresponding substitution above but replace any ``\``
character with a ``/``. This is useful to normalize path separators.
Example: ``%s: C:\Desktop Files/foo_test.s.tmp``
Example: ``%/s: C:/Desktop Files/foo_test.s.tmp``
``%:s, %:S, %:t, %:T:``
Act like the corresponding substitution above but remove colons at
the beginning of Windows paths. This is useful to allow concatenation
of absolute paths on Windows to produce a legal path.
Example: ``%s: C:\Desktop Files\foo_test.s.tmp``
Example: ``%:s: C\Desktop Files\foo_test.s.tmp``
**LLVM-specific substitutions:** **LLVM-specific substitutions:**