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

cmdline/docs: add a required 'multi' keyword for each option #9759

Closed
wants to merge 1 commit into from

Conversation

bagder
Copy link
Member

@bagder bagder commented Oct 18, 2022

The keyword specifies how option works when specified multiple times:

  • single: the last provided value replaces the earlier ones
  • append: it supports being provided multiple times
  • boolean: on/off values
  • mutex: flag-like option that disable anoter flag

The 'gen.pl' script then outputs the proper and unified language for each option's multi-use behavior in the generated man page.

The multi: header is requires in each .d file and will cause build error if missing or set to an unknown value.

The keyword specifies how option works when specified multiple times:

 - single: the last provided value replaces the earlier ones
 - append: it supports being provided multiple times
 - boolean: on/off values
 - mutex: flag-like option that disable anoter flag

The 'gen.pl' script then outputs the proper and unified language for
each option's multi-use behavior in the generated man page.

The multi: header is requires in each .d file and will cause build error
if missing or set to an unknown value.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

None yet

1 participant