diff options
| author | Boris Kolpackov <boris@codesynthesis.com> | 2016-11-03 17:54:02 +0200 |
|---|---|---|
| committer | Boris Kolpackov <boris@codesynthesis.com> | 2016-11-04 09:26:37 +0200 |
| commit | 554475390b6d2912614778fe50788a09f99ac6a4 (patch) | |
| tree | 2cc756aa363f0697291b4cbf8e7a9365bf65629b /doc/testscript.cli | |
| parent | 7ebe4aa8d07e8845f1669e2d43fbe6071d3ee463 (diff) | |
Implement testscript inclusion support
Diffstat (limited to 'doc/testscript.cli')
| -rw-r--r-- | doc/testscript.cli | 18 |
1 files changed, 11 insertions, 7 deletions
diff --git a/doc/testscript.cli b/doc/testscript.cli index d055b58..913bd18 100644 --- a/doc/testscript.cli +++ b/doc/testscript.cli @@ -728,7 +728,7 @@ test: *((variable-line|test-line) ';') test-line (':' <text>)? -include: 'include' '--once'? <path>+ +include: '.include'(' '+'--once')*(' '+<path>)* description: +(':' <text>) @@ -801,8 +801,10 @@ interleaving with scopes and tests, it can be used anywhere in the scope body. It can also contain several parts of a scope, for example, setup and test lines. -The \c{--once} option signals that files that have already been included -in this scope should not be included again. +The \c{--once} option signals that files that have already been included in +this scope should not be included again. The implementation is not required to +handle links when determining if two paths are to the same file. Relative +paths are assumed to be relative to the including testscript. Note that \c{include} is a directive, not a command. It is performed during parsing before any command is executed or testscript variable assigned. You @@ -1089,11 +1091,13 @@ If an id is not specified then it is automatically derived from the test or test group location. If the test or test group is contained directly in the top-level testscript file, then just its start line number is used as an id. Otherwise, if the test or test group reside in an included file, then the -start line number is prefixed with that file name (without the extension) in -the form \c{<file>-<line>}. The start line for a block (either test or group) -is the line containing opening curly brace (\c{{}) and for a simple test \- -the test line itself. +start line number (inside the included file) is prefixed with the line number +of the \c{.include} directive followed by the included file name (without the +extension) in the form \c{<line>-<file>-}. This process is repeated +recursively for nested inclusion. +The start line for a block (either test or group) is the line containing +opening brace (\c{{}) and for a simple test \- the test line itself. \h#grammar-directives|Directives| |