@@ -133,29 +133,34 @@ There are several use-cases for try builds:
133
133
Again, a working compiler build is needed for this, which can be produced by
134
134
the [ dist-x86_64-linux] CI job.
135
135
- Run a specific CI job (e.g. Windows tests) on a PR, to quickly test if it
136
- passes the test suite executed by that job. You can select which CI jobs will
137
- be executed in the try build by adding lines containing `try-job:
138
- <job patter >` to the PR description. All such specified jobs will be executed
139
- in the try build once the ` @bors try ` command is used on the PR. If no try
140
- jobs are specified in this way, the jobs defined in the ` try ` section of
141
- [ ` jobs.yml ` ] will be executed by default. Each pattern can either be an exact
142
- name of a job or a glob pattern that matches multiple jobs, for example
143
- ` *msvc* ` or ` *-alt ` . You can start at most 20 jobs in a single try build.
136
+ passes the test suite executed by that job.
137
+
138
+ You can select which CI jobs will
139
+ be executed in the try build by adding lines containing `try-job:
140
+ <job pattern >` to the PR description. All such specified jobs will be executed
141
+ in the try build once the ` @bors try ` command is used on the PR. If no try
142
+ jobs are specified in this way, the jobs defined in the ` try ` section of
143
+ [ ` jobs.yml ` ] will be executed by default.
144
+
145
+ Each pattern can either be an exact name of a job or a glob pattern that matches multiple jobs,
146
+ for example ` *msvc* ` or ` *-alt ` . You can start at most 20 jobs in a single try build. When using
147
+ glob patterns, you might want to wrap them in backticks (`` ` `` ) to avoid GitHub rendering
148
+ the pattern as Markdown.
144
149
145
150
> ** Using ` try-job ` PR description directives**
146
151
>
147
152
> 1 . Identify which set of try-jobs you would like to exercise. You can
148
153
> find the name of the CI jobs in [ ` jobs.yml ` ] .
149
154
>
150
- > 2 . Amend PR description to include (usually at the end of the PR description)
151
- > e.g.
155
+ > 2 . Amend PR description to include a set of patterns (usually at the end
156
+ > of the PR description), for example:
152
157
>
153
158
> ``` text
154
159
> This PR fixes #123456.
155
160
>
156
161
> try-job: x86_64-msvc
157
162
> try-job: test-various
158
- > try-job: *-alt
163
+ > try-job: ` *-alt`
159
164
> ```
160
165
>
161
166
> Each `try-job` pattern must be on its own line.
0 commit comments