]> granicus.if.org Git - clang/commitdiff
[docs] Coverage: Document the profile merge pool specifier
authorVedant Kumar <vsk@apple.com>
Tue, 14 Jun 2016 00:42:12 +0000 (00:42 +0000)
committerVedant Kumar <vsk@apple.com>
Tue, 14 Jun 2016 00:42:12 +0000 (00:42 +0000)
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@272604 91177308-0d34-0410-b5e6-96231b3b80d8

docs/SourceBasedCodeCoverage.rst

index ff43c931ea2fb338835e03cefab21087342e8978..95b2eb692bad7e2f3f039f3a2ab5ff7aac008d38 100644 (file)
@@ -78,6 +78,14 @@ directory structure will be created.  Additionally, the following special
 
 * "%h" expands out to the hostname of the machine running the program.
 
+* "%Nm" expands out to the instrumented binary's signature. When this pattern
+  is specified, the runtime creates a pool of N raw profiles which are used for
+  on-line profile merging. The runtime takes care of selecting a raw profile
+  from the pool, locking it, and updating it before the program exits.  If N is
+  not specified (i.e the pattern is "%m"), it's assumed that ``N = 1``. N must
+  be between 1 and 9. The merge pool specifier can only occur once per filename
+  pattern.
+
 .. code-block:: console
 
     # Step 2: Run the program.