-
Notifications
You must be signed in to change notification settings - Fork 1.6k
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
base: master
Are you sure you want to change the base?
Conversation
docs/user/manual.adoc
Outdated
args: string[]; | ||
/// The current working directory of the runnable. | ||
cwd: string; | ||
kind: 'check' | 'run' | 'testOne'; |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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.
9db9b53
to
6ab6084
Compare
args: string[]; | ||
/// The current working directory of the runnable. | ||
cwd: string; | ||
/// Used to decide what CodeLens to offer. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
/// 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}`. |
There was a problem hiding this comment.
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.
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.