|
378 | 378 | % \item |--dry-run| Runs the \texttt{install} target but does not copy
|
379 | 379 | % any files: simply lists those that would be installed
|
380 | 380 | % \item |--email| Sets the email address for CTAN upload
|
381 |
| -% \item |--engine| (|-e|) Sets the engine to use for testing |
| 381 | +% \item |--engine| (|-e|) Sets the engine(s) to use for testing |
382 | 382 | % \item |--epoch| Sets the epoch for typesetting and testing
|
383 | 383 | % \item |--file| (|-F|) Takes the upload announcement from the given file
|
384 | 384 | % \item |--first| Name of the first test to run
|
|
456 | 456 | % \begin{buildcmd}{check \meta{name(s)}}
|
457 | 457 | % Checks only the test \texttt{\meta{name(s)}.lvt}.
|
458 | 458 | % All engines specified by \var{checkengines} are tested unless the command
|
459 |
| -% line option |--engine| (or |-e|) has been given to limit |
460 |
| -% testing to a single engine. Normally testing is preceded by unpacking |
| 459 | +% line option |--engine| (or |-e|) has been given a comma-separated list to |
| 460 | +% limit testing to selected |checkengines|. |
| 461 | +% Normally testing is preceded by unpacking |
461 | 462 | % source files and copying the result plus any additional support to the
|
462 | 463 | % test directory: this may be skipped using the |--rerun| (|-r|) option.
|
463 | 464 | % \end{buildcmd}
|
|
572 | 573 | % This command saves the output of the test to a |.tlg| file.
|
573 | 574 | % This file is then used in all subsequent checks against the \texttt{\meta{name}.lvt} test.
|
574 | 575 | %
|
575 |
| -% If the |--engine| (or |-e|) is specified (one of |pdftex|, |xetex|, or |luatex|), the saved output is stored in \texttt{\meta{name}.\meta{engine}.tlg}. This is necessary if running the test through a different engine produces a different output. |
576 |
| -% A normalization process is performed when checking to avoid common differences such as register allocation; full details are listed in Section~\vref{sec:norm}. |
| 576 | +% If the |--engine| (or |-e|) is specified (one or more comma-separated engines |
| 577 | +% in |checkengines|), the saved output is stored in |
| 578 | +% \texttt{\meta{name}.\meta{engine}.tlg} for non-standard engines. |
| 579 | +% This is necessary if running the test through a different engine produces |
| 580 | +% a different output. A normalization process is performed when checking to |
| 581 | +% avoid common differences such as register allocation; full details are listed |
| 582 | +% in Section~\vref{sec:norm}. |
577 | 583 | %
|
578 | 584 | % If the \var{recordstatus} variable is set \var{true}, additional information
|
579 | 585 | % will be added to the \texttt{.tlg} to record the \enquote{exit status} of the
|
|
745 | 751 | %
|
746 | 752 | % To allow selection of one or more configurations, and to allow saving of
|
747 | 753 | % |.tlg| files in non-standard configurations, the |--config| (|-c|) option may
|
748 |
| -% be used. This works in the same way as |--engine|: it takes a comma list of |
749 |
| -% configurations to apply, overriding \var{checkconfigs}. For example, in the |
750 |
| -% directory containing |config-TU.lua|, you can use |
| 754 | +% be used. This works in the same way as |--engine|: it takes a comma-separated |
| 755 | +% list of configurations to apply, overriding \var{checkconfigs}. For example, |
| 756 | +% in the directory containing |config-TU.lua|, you can use |
751 | 757 | % |l3build check -cconfig-TU <name(s)>| and |l3build save -cconfig-TU <name(s)>|
|
752 | 758 | % to check and save tests in |testfiles-TU| directory.
|
753 | 759 | %
|
|
0 commit comments