Skip to content
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

manual: Document all rust-project.json fields #18878

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

Conversation

Wilfred
Copy link
Contributor

@Wilfred Wilfred commented Jan 8, 2025

Ensure that all the fields that rust-analyzer understands are in the manual, they all have doc comments, and they use consistent punctuation (; rather than mixing , and ;).

Whilst we're here, fix the sysroot_src example and add 2024 as a legal value for Rust edition.

@rustbot rustbot added the S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. label Jan 8, 2025
args: string[];
/// The current working directory of the runnable.
cwd: string;
kind: 'check' | 'run' | 'testOne';
Copy link
Member

Choose a reason for hiding this comment

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

Let's give kind a comment too.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think testOne is the only value that's used when you have a rust-project.json, so I've documented that and removed the other mentions.

Ensure that all the fields that rust-analyzer understands are in the
manual, they all have doc comments, and they use consistent
punctuation (`;` rather than mixing `,` and `;`).

Whilst we're here, fix the `sysroot_src` example and add 2024 as a
legal value for Rust edition.
@Wilfred Wilfred force-pushed the document_build_info branch from 9db9b53 to 6ab6084 Compare January 9, 2025 23:52
args: string[];
/// The current working directory of the runnable.
cwd: string;
/// Used to decide what CodeLens to offer.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
/// Used to decide what CodeLens to offer.
/// Used to decide what code lens to offer.

/// 'testOne': This runnable will be used when the user clicks the 'Run Test'
/// CodeLens above a test.
///
/// The args can contain two template strings: `{label}` and `{test_id}`.
Copy link
Member

Choose a reason for hiding this comment

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

This seems copy-pasted from above, by mistake.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
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.

3 participants