From 389648f690cc94ecc166c4985871b1c9bef706f6 Mon Sep 17 00:00:00 2001 From: Vedant Kumar Date: Thu, 2 Jun 2016 02:25:13 +0000 Subject: [PATCH] [docs] Minor formatting changes and typo fixes git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@271471 91177308-0d34-0410-b5e6-96231b3b80d8 --- docs/SourceBasedCodeCoverage.rst | 21 ++++++++++----------- 1 file 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: -- 2.40.0