6502/llvm-6502
1
0
Fork 0
mirror of https://github.com/c64scene-ar/llvm-6502.git synced 2025-07-26 20:26:07 +00:00
Code Issues Projects Releases Wiki Activity

Fix FileCheck CHECK-LABEL documentation wording slightly; also mention that it allows error recovery.

Browse Source 
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@186628 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
Stephen Lin
2013-07-18 23:26:58 +00:00
parent 9d1359453f
commit d639206676
1 changed files with 10 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/CommandGuide/FileCheck.rst
View File

@@ -255,13 +255,13 @@ actual source of the problem.
In order to produce better error messages in these cases, the "``CHECK-LABEL:``" In order to produce better error messages in these cases, the "``CHECK-LABEL:``"
directive can be used. It is treated identically to a normal ``CHECK`` directive can be used. It is treated identically to a normal ``CHECK``
directive except that the FileCheck utility makes an additional assumption that directive except that FileCheck makes an additional assumption that a line
a line matched by the directive cannot also be matched by any other check matched by the directive cannot also be matched by any other check present in
present in ``match-filename``; this is intended to be used for lines containing ``match-filename``; this is intended to be used for lines containing labels or
labels or other unique identifiers. Conceptually, the presence of other unique identifiers. Conceptually, the presence of ``CHECK-LABEL`` divides
``CHECK-LABEL`` divides the input stream into separate blocks, each of which is the input stream into separate blocks, each of which is processed independently,
processed independently, preventing a ``CHECK:`` directive in one block preventing a ``CHECK:`` directive in one block matching a line in another block.
matching a line in another block. For example, For example,
.. code-block:: llvm .. code-block:: llvm
@@ -285,7 +285,9 @@ matching a line in another block. For example,
The use of ``CHECK-LABEL:`` directives in this case ensures that the three The use of ``CHECK-LABEL:`` directives in this case ensures that the three
``CHECK:`` directives only accept lines corresponding to the body of the ``CHECK:`` directives only accept lines corresponding to the body of the
``@C_ctor_base`` function, even if the patterns match lines found later in ``@C_ctor_base`` function, even if the patterns match lines found later in
the file. the file. Furthermore, if one of these three ``CHECK:`` directives fail,
FileCheck will recover by continuing to the next block, allowing multiple test
failures to be detected in a single invocation.
There is no requirement that ``CHECK-LABEL:`` directives contain strings that There is no requirement that ``CHECK-LABEL:`` directives contain strings that
correspond to actual syntactic labels in a source or output language: they must correspond to actual syntactic labels in a source or output language: they must