Better documentation

docs/src/v2cli/compile.md

@@ -126,4 +126,4 @@ the set of unstable options is subject to change at any time.
 | `-Z min-crossrefs=<num>` | Equivalent to bibtex's `-min-crossrefs` flag. Default vaue: 2 |
 | `-Z paper-size=<spec>`   | Change the initial paper size. Default: `letter` |
 | `-Z shell-escape`        | Enable `\write18` (unless `--untrusted` has been specified) |
-| `-Z search-path=<path>`  | Also look in <path> for files, like TEXINPUTS. Can be specified multiple times |
+| `-Z search-path=<path>`  | Also look in <path> for files (unless `--untrusted` has been specified), like TEXINPUTS. Can be specified multiple times |

src/driver.rs

@@ -451,7 +451,8 @@ macro_rules! bridgestate_ioprovider_cascade {
                 bridgestate_ioprovider_try!(p, $($inner)+);
             }
 
-            // extra search paths
+            // Extra search paths. This has higher priority than bundles but lower than current
+            // working dir to support the use case of overriding broken bundles (see issue #816).
             for fsio in $self.extra_search_paths.iter_mut() {
                 bridgestate_ioprovider_try!(fsio, $($inner)+);
             }