From 89a66474b6c1e5843c3dbc96bde52e5a7076c6cc Mon Sep 17 00:00:00 2001
From: Clement Courbet <courbet@google.com>
Date: Thu, 6 Feb 2020 12:08:02 +0100
Subject: [PATCH] [llvm-exegesis] Document `repetition-mode`.

Reviewers: gchatelet

Subscribers: tschuett, mstojanovic, llvm-commits

Tags: #llvm

Differential Revision: https://reviews.llvm.org/D74114
---
 llvm/docs/CommandGuide/llvm-exegesis.rst | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/llvm/docs/CommandGuide/llvm-exegesis.rst b/llvm/docs/CommandGuide/llvm-exegesis.rst
index 81e92e7736d6..0a5b0990d2ee 100644
--- a/llvm/docs/CommandGuide/llvm-exegesis.rst
+++ b/llvm/docs/CommandGuide/llvm-exegesis.rst
@@ -184,10 +184,10 @@ OPTIONS
  a comma-separated list. See example 1 for details.
  Either `opcode-index`, `opcode-name` or `snippets-file` must be set.
 
- .. option:: -snippets-file=<filename>
+.. option:: -snippets-file=<filename>
 
-  Specify the custom code snippet to measure. See example 2 for details.
-  Either `opcode-index`, `opcode-name` or `snippets-file` must be set.
+ Specify the custom code snippet to measure. See example 2 for details.
+ Either `opcode-index`, `opcode-name` or `snippets-file` must be set.
 
 .. option:: -mode=[latency|uops|inverse_throughput|analysis]
 
@@ -195,6 +195,15 @@ OPTIONS
  to specify at least one of the `-analysis-clusters-output-file=` and
  `-analysis-inconsistencies-output-file=`.
 
+.. option:: -repetition-mode=[duplicate|loop]
+
+ Specify the repetition mode. `duplicate` will create a large, straight line
+ basic block with `num-repetitions` copies of the snippet. `loop` will wrap
+ the snippet in a loop which will be run `num-repetitions` times. The `loop`
+ mode tends to better hide the effects of the CPU frontend on architectures
+ that cache decoded instructions, but consumes a register for counting
+ iterations.
+
 .. option:: -num-repetitions=<Number of repetitions>
 
  Specify the number of repetitions of the asm snippet.