|
1 | 1 | {% extends "layout.html" %} |
2 | 2 | {% block head %} |
3 | 3 | <style> |
4 | | - .help-content { |
5 | | - font-family: Helvetica, Arial, sans-serif; |
6 | | - line-height: 140%; |
7 | | - font-size: 16px; |
8 | | - max-width: 50em; |
9 | | - } |
| 4 | + .help-content { |
| 5 | + font-family: Helvetica, Arial, sans-serif; |
| 6 | + line-height: 140%; |
| 7 | + font-size: 16px; |
| 8 | + max-width: 50em; |
| 9 | + } |
10 | 10 |
|
11 | | - .help-content code { |
12 | | - background: #eee; |
13 | | - border-radius: 5px; |
14 | | - padding: 2px; |
15 | | - } |
| 11 | + .help-content code { |
| 12 | + background: #eee; |
| 13 | + border-radius: 5px; |
| 14 | + padding: 2px; |
| 15 | + } |
16 | 16 | </style> |
17 | 17 | {% endblock %} |
18 | 18 |
|
19 | 19 | {% block content %} |
20 | 20 | <div class="help-content"> |
21 | 21 | <h3><b><code>@rust-timer</code> commands</b></h3> |
22 | 22 | <p><code>@rust-timer</code> supports several commands, the most common (and simple) being |
23 | | - <code>@rust-timer queue</code>. This command is usually invoked as <code>@bors try @rust-timer queue</code>, |
24 | | - which starts a bors "try" run (not a merge). <code>@rust-timer</code> will wait for the try run to finish, |
| 23 | + <code>@rust-timer queue</code>. This command is usually invoked as <code>@bors try @rust-timer |
| 24 | + queue</code>, |
| 25 | + which starts a bors "try" run (not a merge). <code>@rust-timer</code> will wait for the try run |
| 26 | + to finish, |
25 | 27 | and if it succeeds will then queue a perf run. |
26 | 28 | </p> |
27 | 29 | <p><code>@rust-timer queue</code> has a few extra options that can be useful:</p> |
28 | 30 | <ul> |
29 | | - <li><code>include=<INCLUDE></code> is a comma-separated list of benchmark prefixes. A benchmark is included in |
| 31 | + <li><code>include=<INCLUDE></code> is a comma-separated list of benchmark prefixes. A |
| 32 | + benchmark is included in |
30 | 33 | the run only if its name matches one of the given prefixes. |
31 | 34 | </li> |
32 | | - <li><code>exclude=<EXCLUDE></code> is a comma-separated list of benchmark prefixes, and the inverse of <code>include=</code>. |
33 | | - A benchmark is excluded from the run if its name matches one of the given prefixes.</li> |
| 35 | + <li><code>exclude=<EXCLUDE></code> is a comma-separated list of benchmark prefixes, and |
| 36 | + the inverse of <code>include=</code>. |
| 37 | + A benchmark is excluded from the run if its name matches one of the given prefixes. |
| 38 | + </li> |
34 | 39 | <li><code>runs=<RUNS></code> configures how many times the benchmark is run. <code><RUNS></code> |
35 | | - is an integer. All benchmarks run at least once by default, but some run more than one time. You can use |
36 | | - the <code>runs</code> option to override the default run count and make every benchmark run for |
| 40 | + is an integer. All benchmarks run at least once by default, but some run more than one time. |
| 41 | + You can use |
| 42 | + the <code>runs</code> option to override the default run count and make every benchmark run |
| 43 | + for |
37 | 44 | <code><RUNS></code> times. |
38 | 45 | </li> |
| 46 | + <li><code>backends=<BACKENDS></code> configures which codegen backends should be |
| 47 | + benchmarked. |
| 48 | + By default, only the LLVM backend is benchmarked. If you select a non-default codegen backend, |
| 49 | + rustc-perf will also gather data for this backend for the parent/baseline commit, so that we |
| 50 | + have something to compare to. |
| 51 | + </li> |
39 | 52 | </ul> |
40 | | - <p><code>@rust-timer build $commit</code> will queue a perf run for the given commit <code>$commit</code>. |
| 53 | + <p><code>@rust-timer build $commit</code> will queue a perf run for the given commit |
| 54 | + <code>$commit</code>. |
41 | 55 | It is usually invoked with the commit from a successful "try" run. (The |
42 | 56 | <code>queue</code> command can be seen as a shortcut that automatically selects the |
43 | 57 | "try" run's commit for the <code>build</code> command) |
44 | | - This command also supports the same <code>include</code>, <code>exclude</code>, and <code>runs</code> options |
45 | | - as <code>@rust-timer queue</code>. |
| 58 | + This command also supports the same options as <code>@rust-timer queue</code>. |
46 | 59 | </p> |
47 | 60 | </div> |
48 | 61 | {% endblock %} |
0 commit comments