What's the difference and which to use? #[clap(... x #[arg(...

[alanwilter]

Both seem to work. clap site examples uses #[arg(... yet I see a lot #[clap(... elsewhere.

[epage]

#[clap()] is what was exclusively used in clap v3. In clap v4, we introduced more specific attributes which has allowed things like #[group] and #[command] attributes existing at the top-level and it better relates the attributes to the builder API to help people connect the two together. #[clap] attributes are deprecated and will be removed in clap v5. We don't proactively show deprecation messages due to feedback from users who don't want to see them until they are ready to process them, so we put them behind cargo check -F clap/deprecated.

[alanwilter]

Thank you very much for that!

[Ominous-Olive]

I simply want to add that I also found this very confusing. I just spent a fair bit of time trying to make sense of the additional attributes since the fact that #[clap(..)] is "deprecated" doesn't seem to be mentioned in the derive reference, the derive tutorial or the faq.

Of course, I may have simply missed something very obvious. So this is just my two cents as someone who is slightly frustrated that they had to dig around in the discussions to find information on this.

Regardless, thank you for the amazing work on this crate.

[pronebird]

This has been a source of so much frustration since half of examples on the internet use #[clap] and it just works. I think it would have been better to force developers to migrate instead of making this a "surprise" in clap v5.