Re: [PATCH v19 1/3] doc: git-format-patch: describe the option --always

From: Aleen 徐沛文 <pwxu@coremail.cn>
Date: Dec 10, 2021, 01:26 UTC
Message-ID: <7bd729fd.29.17da1f2df5d.Coremail.pwxu@coremail.cn>
In-Reply-To: <1ad4a3ee-af05-9bb2-67fe-566d5e4c39a8@gmail.com>

Show 21 quoted lines

> What about this wording below?
> 
> diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
> index be797d7a28..302659cfd5 100644
> --- a/Documentation/git-format-patch.txt
> +++ b/Documentation/git-format-patch.txt
> @@ -193,8 +193,8 @@ will want to ensure that threading is disabled for `git send-email`.
>   	ignored.
>   
>   --always::
> -	Include patches for commits that do not introduce any change,
> -	which are omitted by default.
> +	Always generate patches, even if there are empty-change commits.
> +	Default is to omit such commits.
>   
>   --cover-from-description=<mode>::
>   	Controls which parts of the cover letter will be automatically
> 
> 
> -- 
> An old man doll... just what I always wanted! - Clara

Dears Sanjaya,

    Thanks for your suggestion. I don't see the actual difference between
    the two sentences, and do you want to enhance the word "always"?
    If you do, how about just describing the option as "Always include patches..."?

Aleen