mirror of
https://github.com/clap-rs/clap
synced 2024-12-15 15:22:30 +00:00
13 lines
961 B
Markdown
13 lines
961 B
Markdown
# How to Contribute
|
|
|
|
See the [clap-wide CONTRIBUTING.md](../CONTRIBUTING.md). This will contain `clap_derive` specific notes.
|
|
|
|
## Derive Gotchas
|
|
|
|
- Always prefix generated variables with `__clap_` to minimize clashes with the user's variables, see [#2934](https://github.com/clap-rs/clap/issues/2934).
|
|
- Prefer the path `clap` over `::clap` to allow users to re-export clap, see [#2258](https://github.com/clap-rs/clap/pull/2258).
|
|
- Prefer substituting variable names to avoid problems with `macro_rules`, see [#2823](https://github.com/clap-rs/clap/pull/2823).
|
|
- Prefer `::std::result::Result` and `::std::option::Option`, see [#3092](https://github.com/clap-rs/clap/pull/3092).
|
|
- Put whitespace between `#quoted #variables`.
|
|
- New "magic" attributes must be documented in the [derive reference](../src/_derive.rs)
|
|
- If there is no related builder method, a `#![doc(alias = "")]` should also be added, see [#4984](https://github.com/clap-rs/clap/pull/4984)
|