File tree Expand file tree Collapse file tree 1 file changed +4
-3
lines changed Expand file tree Collapse file tree 1 file changed +4
-3
lines changed Original file line number Diff line number Diff line change @@ -151,7 +151,7 @@ Here are some details that are relevant to this test suite specifically:
151
151
* While you can use both ` //@ compile-flags ` and ` //@ doc-flags ` to pass flags to ` rustdoc ` ,
152
152
prefer to user the latter to show intent. The former is meant for ` rustc ` .
153
153
* Add ` //@ build-aux-docs ` to the test file that has auxiliary crates to not only compile the
154
- auxiliaries with ` rustc ` but to also document them with ` rustdoc `
154
+ auxiliaries with ` rustc ` but to also document them with ` rustdoc ` .
155
155
156
156
## Caveats
157
157
@@ -161,8 +161,9 @@ It's not unusual that the *shape* of the generated HTML document tree changes fr
161
161
This includes for example renamings of CSS classes.
162
162
163
163
Whenever that happens, * positive* checks will either continue to match the intended element /
164
- attribute / text if their XPath expression is general / loose enough and thus test the correct thing
165
- or they won't in which case they would fail forcing the author of the change tolook at them.
164
+ attribute / text (if their XPath expression is general / loose enough) and
165
+ thus continue to test the correct thing or they won't in which case they would fail thereby
166
+ forcing the author of the change to look at them.
166
167
167
168
Compare that to * negative* checks (e.g., ` //@ !has PATH XPATH PATTERN ` ) which won't fail if their
168
169
XPath expression "no longer" matches. The author who changed "the shape" thus won't get notified and
You can’t perform that action at this time.
0 commit comments