diff options
| author | Vedant Kumar <vsk@apple.com> | 2016-06-02 02:25:13 +0000 |
|---|---|---|
| committer | Vedant Kumar <vsk@apple.com> | 2016-06-02 02:25:13 +0000 |
| commit | 389648f690cc94ecc166c4985871b1c9bef706f6 (patch) | |
| tree | efea4c2e5ad0d66ee78a14b87c4ca637fd30c6e1 /docs | |
| parent | c055111ab20cb853f16c7b4abefdb0f2346547f5 (diff) | |
| download | clang-389648f690cc94ecc166c4985871b1c9bef706f6.tar.gz | |
[docs] Minor formatting changes and typo fixes
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@271471 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/SourceBasedCodeCoverage.rst | 21 |
1 files changed, 10 insertions, 11 deletions
diff --git a/docs/SourceBasedCodeCoverage.rst b/docs/SourceBasedCodeCoverage.rst index 027dd8bac5..5edbada18c 100644 --- a/docs/SourceBasedCodeCoverage.rst +++ b/docs/SourceBasedCodeCoverage.rst @@ -26,11 +26,11 @@ The code coverage workflow The code coverage workflow consists of three main steps: -1. Compiling with coverage enabled. +* Compiling with coverage enabled. -2. Running the instrumented program. +* Running the instrumented program. -3. Creating coverage reports. +* Creating coverage reports. The next few sections work through a complete, copy-'n-paste friendly example based on this program: @@ -52,7 +52,7 @@ based on this program: Compiling with coverage enabled =============================== -To compile code with coverage enabled pass ``-fprofile-instr-generate +To compile code with coverage, enabled pass ``-fprofile-instr-generate -fcoverage-mapping`` to the compiler: .. code-block:: console @@ -68,12 +68,11 @@ Running the instrumented program The next step is to run the instrumented program. When the program exits it will write a **raw profile** to the path specified by the ``LLVM_PROFILE_FILE`` -environment variable. If that variable does not exist the profile is written to -``default.profraw`` in the current directory of the program. - -If ``LLVM_PROFILE_FILE`` contains a path to a non-existent directory the -missing directory structure will be created. Additionally, the following -special **pattern strings** are replaced: +environment variable. If that variable does not exist, the profile is written +to ``default.profraw`` in the current directory of the program. If +``LLVM_PROFILE_FILE`` contains a path to a non-existent directory, the missing +directory structure will be created. Additionally, the following special +**pattern strings** are rewritten: * "%p" expands out to the process ID. @@ -87,7 +86,7 @@ special **pattern strings** are replaced: Creating coverage reports ========================= -Raw profiles have to be **indexed** before they can be used to generated +Raw profiles have to be **indexed** before they can be used to generate coverage reports. This is done using the "merge" tool in ``llvm-profdata``, so named because it can combine and index profiles at the same time: |