Skip to content

rustdoc: Replace unstable flag --doctest-compilation-args with a simpler one: --doctest-build-arg #139863

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

fmease
Copy link
Member

@fmease fmease commented Apr 15, 2025

Tracking issue: #134172.
Context: #137096 (comment)

Yeets the ad hoc shell-like lexer for 'nested' program arguments.
No FCP necessary since the flag is unstable.

I've chosen to replace compilation with build because it's shorter (you now need to pass it multiple times in order to pass many arguments to the doctest compiler, so it matters a bit) and since I prefer it esthetically.

Issue: Even though we don't process the argument passed to --doctest-build-arg, we end up passing it via an argument file (rustc @argfile) which delimits arguments by line break (LF or CRLF, via) meaning ultimately the arguments still get split which is unfortunate. Still, I think this change is an improvement over the status quo.

I'll update the tracking issue if/once this PR merges. I'll also add the (CR)LF issue to 'unresolved question'.

r? GuillaumeGomez
r? notriddle

@rustbot rustbot added A-run-make Area: port run-make Makefiles to rmake.rs S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-compiler Relevant to the compiler team, which will review and decide on the PR/issue. T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue. labels Apr 15, 2025
@rustbot
Copy link
Collaborator

rustbot commented Apr 15, 2025

This PR modifies run-make tests.

cc @jieyouxu

@fmease fmease changed the title Replace unstable flag --doctest-compilation-args with a simpler one: --doctest-build-arg rustdoc: Replace unstable flag --doctest-compilation-args with a simpler one: --doctest-build-arg Apr 15, 2025
@fmease fmease force-pushed the simp-doctest-build-arg-passing branch from 82f5c3e to aa1c113 Compare April 15, 2025 12:24
@rust-log-analyzer

This comment has been minimized.

@GuillaumeGomez
Copy link
Member

That resolve the argument parsing, which I strongly approve!

…est-build-arg`

More notably, the value of the new flag does *not* get lexed shell-like and ad hoc.
@fmease fmease force-pushed the simp-doctest-build-arg-passing branch from aa1c113 to 307a67a Compare April 15, 2025 13:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-run-make Area: port run-make Makefiles to rmake.rs S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-compiler Relevant to the compiler team, which will review and decide on the PR/issue. T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants