Skip to content

bootstrap: x doc --open ferrocene/doc no longer opens a dozen web pages#1883

Draft
jyn514 wants to merge 3 commits intomainfrom
jyn/doc-open
Draft

bootstrap: x doc --open ferrocene/doc no longer opens a dozen web pages#1883
jyn514 wants to merge 3 commits intomainfrom
jyn/doc-open

Conversation

@jyn514
Copy link
Contributor

@jyn514 jyn514 commented Oct 28, 2025

draft until i upstream the first two commits

… flag

The original motivation for adding this `path.starts_with` check was to
allow things like `--skip=src/etc`. But it affects quite a lot more
things than just `--skip`; bootstrap is really not designed for the case
when multiple Steps match the same filter. For example, `x test src`
does ... something! Not sure what, but something!

Change `starts_with` to only affect `--skip`, not anything else.

The original motivation for this was to make it so that `x doc src/doc
--open` doesn't open a dozen different books, but I expect it to fix
various other steps in bootstrap as well.
In general, the rationale for `--open` is to only open HTML files if
they were "explicitly" invoked from the CLI (e.g. `x doc --open
library/core`). The existing logic did not do that. Instead it opened
the docs unconditionally when a subset of the crates was requested. This
is unfortunate for other Steps in bootstrap, which may wish to `ensure()`
the standard library docs without opening them.

Change `Std` to check if it was explicitly invoked, rather than assuming
it's the case.
…ages

The previous commits in this chain make it so that the pages no longer
open. This commit just opens the main index page, now that it's no
longer being implicitly opened.
@jyn514
Copy link
Contributor Author

jyn514 commented Oct 28, 2025

@jyn514 jyn514 added the blocked waiting on another change label Nov 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

blocked waiting on another change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant