Re: [PATCH v3 03/21] diff-parseopt: convert --dirstat and friends

[Andrei Rybak <rybak.a.v@gmail.com>]

On 2/16/19 12:36 PM, Nguyễn Thái Ngọc Duy wrote:
> Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
> Signed-off-by: Junio C Hamano <gitster@pobox.com>
> ---
>  Documentation/diff-options.txt |  7 ++++++
>  diff.c                         | 39 +++++++++++++++++++++++++---------
>  2 files changed, 36 insertions(+), 10 deletions(-)
> 
> diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt
> index 0711734b12..058d93ec4f 100644
> --- a/Documentation/diff-options.txt
> +++ b/Documentation/diff-options.txt
> @@ -148,6 +148,7 @@ These parameters can also be set individually with `--stat-width=<width>`,
>  	number of modified files, as well as number of added and deleted
>  	lines.
>  
> +-X<param1,param2,...>::
>  --dirstat[=<param1,param2,...>]::

<param1,param2,...> should probably marked as optional for -X

>  	Output the distribution of relative amount of changes for each
>  	sub-directory. The behavior of `--dirstat` can be customized by
> @@ -192,6 +193,12 @@ directories with less than 10% of the total amount of changed files,
>  and accumulating child directory counts in the parent directories:
>  `--dirstat=files,10,cumulative`.
>  
> +--cumulative::
> +	Synonym for --dirstat=cumulative
> +
> +--dirstat-by-file[=<param1,param2>...]::
> +	Synonym for --dirstat=files,param1,param2...
> +
>  --summary::
>  	Output a condensed summary of extended header information
>  	such as creations, renames and mode changes.