diff options
author | Ingela Anderton Andin <ingela@erlang.org> | 2019-12-10 16:20:47 +0100 |
---|---|---|
committer | Ingela Anderton Andin <ingela@erlang.org> | 2019-12-10 16:20:47 +0100 |
commit | f10c161356f24983bfb95c9a778877535a954e33 (patch) | |
tree | 069427f68e447713d92d6a67339924e85366066d /lib/common_test | |
parent | 83a4ddadb8765884414c96521a7fbcfadfed9635 (diff) | |
parent | 1e01e9d9007ea37b7009a5b510f16fac6733f33d (diff) | |
download | erlang-f10c161356f24983bfb95c9a778877535a954e33.tar.gz |
Merge branch 'maint'
Diffstat (limited to 'lib/common_test')
-rw-r--r-- | lib/common_test/doc/src/cover_chapter.xml | 50 |
1 files changed, 36 insertions, 14 deletions
diff --git a/lib/common_test/doc/src/cover_chapter.xml b/lib/common_test/doc/src/cover_chapter.xml index 6c180c276c..e05943bb3b 100644 --- a/lib/common_test/doc/src/cover_chapter.xml +++ b/lib/common_test/doc/src/cover_chapter.xml @@ -125,8 +125,12 @@ <section> <title>The Cover Specification File</title> - <p>The following terms are allowed in a cover specification file:</p> + <section> + <title>General Config</title> + + <p>Here follows the general configuration terms that are allowed in a cover specification file:</p> + <pre> %% List of Nodes on which cover will be active during test. %% Nodes = [atom()] @@ -143,7 +147,7 @@ %% Cover analysis level. %% Level = details | overview {level, Level}. - + %% Directories to include in cover. %% Dirs = [string()] {incl_dirs, Dirs}. @@ -169,19 +173,37 @@ %% Mod = [atom()], modules to compile for accumulated analysis {cross,[{Tag,Mods}]}.</pre> - <p>The terms <c>incl_dirs_r</c> and <c>excl_dirs_r</c> tell <c>Common - Test</c> to search the specified directories recursively and include - or exclude any module found during the search. The terms - <c>incl_dirs</c> and <c>excl_dirs</c> result in a - non-recursive search for modules (that is, only modules found in - the specified directories are included or excluded).</p> - <note><p>Directories containing Erlang modules to be included in a code - coverage test must exist in the code server path. Otherwise, - the Cover tool fails to recompile the modules. It is not sufficient to - specify these directories in the cover specification file for - <c>Common Test</c>.</p></note> + <p>The terms <c>incl_dirs_r</c> and <c>excl_dirs_r</c> tell <c>Common + Test</c> to search the specified directories recursively and include + or exclude any module found during the search. The terms + <c>incl_dirs</c> and <c>excl_dirs</c> result in a + non-recursive search for modules (that is, only modules found in + the specified directories are included or excluded).</p> + <note><p>Directories containing Erlang modules to be included in a code + coverage test must exist in the code server path. Otherwise, + the Cover tool fails to recompile the modules. It is not sufficient to + specify these directories in the cover specification file for + <c>Common Test</c>.</p></note> + </section> + + <section> + <title>OTP application Config</title> + + <p>When using a cover specification in the testing of an OTP + application itself, there is a special incl_app directive that + includes the applications modules for the cover compilation.</p> + + <pre> +{incl_app, AppName, Cover:: overview | details}. +</pre> + + <note><p>If you desire to also use some other general cover configuration + together with this option you should insert the AppName in between + the option and its value creating a three tuple. + </p></note> + </section> </section> - + <section> <marker id="cross_cover"/> <title>Cross Cover Analysis</title> |