@@ -133,29 +133,37 @@ 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 up to 10 lines containing `try-job:
138
- <name of job >` 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.
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.
142
149
143
150
> ** Using ` try-job ` PR description directives**
144
151
>
145
- > 1 . Identify which set of try-jobs (max 10) you would like to exercise. You can
152
+ > 1 . Identify which set of try-jobs you would like to exercise. You can
146
153
> find the name of the CI jobs in [ ` jobs.yml ` ] .
147
154
>
148
- > 2 . Amend PR description to include (usually at the end of the PR description)
149
- > e.g.
155
+ > 2 . Amend PR description to include a set of patterns (usually at the end
156
+ > of the PR description), for example:
150
157
>
151
158
> ``` text
152
159
> This PR fixes #123456.
153
160
>
154
161
> try-job: x86_64-msvc
155
162
> try-job: test-various
163
+ > try-job: `*-alt`
156
164
> ```
157
165
>
158
- > Each `try-job` directive must be on its own line.
166
+ > Each `try-job` pattern must be on its own line.
159
167
>
160
168
> 3. Run the prescribed try jobs with `@bors try`. As aforementioned, this
161
169
> requires the user to either (1) have `try` permissions or (2) be delegated
0 commit comments