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.

Sign up for GitHub

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

Jump to bottom

Document macro usage of arg groups #932

Closed
TedDriggs opened this issue Apr 12, 2017 · 1 comment
Closed

Document macro usage of arg groups #932

TedDriggs opened this issue Apr 12, 2017 · 1 comment
Labels
A-docs Area: documentation, including docs.rs, readme, examples, etc... C-enhancement Category: Raise on the bar on expectations E-medium Call for participation: Experience needed to fix: Medium / intermediate
Milestone
2.24.2

Comments

@TedDriggs
Copy link
Contributor

Rust Version

rustc 1.18.0-nightly (3b5754e5c 2017-04-10)

Affected Version of clap

2.23

Missing Documentation

The macro syntax for declaring applications doesn't make clear how to use arg groups. I attempted to follow the rules for args, such as using +required, but this failed saying an ident was expected. I've tried a variety of different formats without success, so this is a general documentation or example request rather than an ask for specific debugging help.
@kbknapp
Copy link
Member

kbknapp commented Apr 18, 2017

Good point! Thanks. This is because those shorthand tricks only work with args.

Although I guess there's really no reason why those couldn't be added for groups here.

@kbknapp kbknapp added C: arg groups A-docs Area: documentation, including docs.rs, readme, examples, etc... E-medium Call for participation: Experience needed to fix: Medium / intermediate C-enhancement Category: Raise on the bar on expectations labels Apr 18, 2017
@kbknapp kbknapp added this to the 2.24.2 milestone May 9, 2017
kbknapp added a commit that referenced this issue May 15, 2017
@kbknapp
docs(clap_app!): adds using the @group specifier to the macro docs
fe85fcb 
Closes #932
kbknapp added a commit that referenced this issue May 16, 2017
@kbknapp
docs(clap_app!): adds using the @group specifier to the macro docs
5e9855d 
Closes #932
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
A-docs Area: documentation, including docs.rs, readme, examples, etc... C-enhancement Category: Raise on the bar on expectations E-medium Call for participation: Experience needed to fix: Medium / intermediate
Projects
None yet
Milestone
2.24.2
Development

No branches or pull requests
2 participants
@TedDriggs @kbknapp