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

coral2: change rabbit docs to use -S flag #277

Conversation

jameshcorbett
Copy link
Member

Problem: flux-core PR github.com/flux-framework/flux-core/pull/6238 introduced the -S option as shorthand for --setattr, and users will most likely prefer using -S, but only --setattr is described in the documentation.

Change the documentation to list both options and make the examples use -S.

Problem: flux-core PR github.com/flux-framework/flux-core/pull/6238
introduced the `-S` option as shorthand for `--setattr`, and users
will most likely prefer using `-S`, but only `--setattr` is
described in the documentation.

Change the documentation to list both options and make the examples
use `-S`.
@jameshcorbett jameshcorbett requested a review from grondo September 3, 2024 21:27
Copy link
Contributor

@grondo grondo left a comment

Choose a reason for hiding this comment

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

LGTM!

It is a style choice, and I'm sure you're already aware, but since -S requires an argument, no space is necessary between -S and dw, so

$ flux alloc -N2 -Sdw="#DW jobdw type=xfs capacity=10GiB name=project1

will work too.

Just pointing that out in case it wasn't obvious :-)

@jameshcorbett
Copy link
Member Author

Yeah I was thinking users might find it easier to read maybe?

@grondo
Copy link
Contributor

grondo commented Sep 3, 2024

Yes, good point. I wasn't suggesting any changes, just making sure we didn't think a space between -S and its argument is necessary.

@jameshcorbett
Copy link
Member Author

Makes sense. Thanks for the review! Setting MWP.

@jameshcorbett jameshcorbett added the merge-when-passing mark PR for auto-merging by mergify.io bot label Sep 3, 2024
@mergify mergify bot merged commit bdf2600 into flux-framework:master Sep 3, 2024
7 checks passed
@jameshcorbett jameshcorbett deleted the rabbits-document-new-setattr-flag branch October 1, 2024 21:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
merge-when-passing mark PR for auto-merging by mergify.io bot
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants