From c7123b315977c34bd530f1d18034f96e66ef57e3 Mon Sep 17 00:00:00 2001 From: Ed Page Date: Mon, 8 Aug 2022 08:53:42 -0500 Subject: [PATCH] docs(derive): Clarify what defaulted action/value_parser does Noticed this was missing when responding to #4041 --- src/_derive/mod.rs | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/src/_derive/mod.rs b/src/_derive/mod.rs index cf5dd0b3ae5..b209ff69467 100644 --- a/src/_derive/mod.rs +++ b/src/_derive/mod.rs @@ -186,11 +186,17 @@ //! - `value_parser [= ]`: [`Arg::value_parser`][crate::Arg::value_parser] //! - When not present: will auto-select an implementation based on the field type using //! [`value_parser!][crate::value_parser!] -//! - To register a custom type's [`ValueParser`][crate::builder::ValueParser], implement [`ValueParserFactory`][crate::builder::ValueParserFactory] +//! - When present but defaulted: opt-in to clap v4 semantics +//! - Env parsing is now dependent on inferred parser +//! - `PathBuf` will implicitly skip UTF-8 validation (before it required specifying +//! `try_from_os_str`) //! - When present, implies `#[clap(action)]` +//! - To register a custom type's [`ValueParser`][crate::builder::ValueParser], implement [`ValueParserFactory`][crate::builder::ValueParserFactory] //! - `action [= ]`: [`Arg::action`][crate::Arg::action] //! - When not present: will auto-select an action based on the field type +//! - When present but defaulted: opt-in to clap v4 semantics //! - When present, implies `#[clap(value_parser)]` +//! - `args_override_self` is forced on for single flags //! - `help = `: [`Arg::help`][crate::Arg::help] //! - When not present: [Doc comment summary](#doc-comments) //! - `long_help = `: [`Arg::long_help`][crate::Arg::long_help]