Skip to content

Conversation

tacertain
Copy link

Clarify usage of default-members with root package in workspaces.

What does this PR try to resolve?

I found this section of the doc confusing. I have made clarifications that align with my understanding. If this understanding is incorrect, then presumably a different change would be in order.

How to test and review this PR?

Doc change only

Clarify usage of default-members with root package in workspaces.
@rustbot
Copy link
Collaborator

rustbot commented Sep 3, 2025

r? @ehuss

rustbot has assigned @ehuss.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

@rustbot rustbot added A-documenting-cargo-itself Area: Cargo's documentation S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. labels Sep 3, 2025
> you can only operate on it using `--package` and `--workspace` flags.
> Note: If `default-members` is specified and a [root package](#root-package) is present,
> you can only operate on the root package using `--package` and `--workspace` flags.
> There is no way to specify the root package explicitly in the `default-members` field.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually you can do that through default-members = ["."].

Maybe we should remove this instead?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-documenting-cargo-itself Area: Cargo's documentation S-waiting-on-review Status: Awaiting review from the assignee but also interested parties.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants