From 090b964baa2e63135c1d0912889ee16e04665a98 Mon Sep 17 00:00:00 2001
From: Kevin Cui <bh@bugs.cc>
Date: Thu, 11 Jul 2024 11:04:51 +0800
Subject: [PATCH 1/3] docs(flag): add `UseShortOptionHandling` description

Close: #1942

Signed-off-by: Kevin Cui <bh@bugs.cc>
---
 docs/v2/examples/flags.md | 4 ++++
 docs/v3/examples/flags.md | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/docs/v2/examples/flags.md b/docs/v2/examples/flags.md
index eb87e6c6d4..0ef4c86ef4 100644
--- a/docs/v2/examples/flags.md
+++ b/docs/v2/examples/flags.md
@@ -104,6 +104,8 @@ See full list of flags at https://pkg.go.dev/github.com/urfave/cli/v2
 
 For bool flags you can specify the flag multiple times to get a count(e.g -v -v -v or -vvv)
 
+> If you want to support the `-vvv` flag, you need to set `App.UseShortOptionHandling`.
+
 <!-- {
   "args": ["&#45;&#45;foo", "&#45;&#45;foo"],
   "output": "count 2"
@@ -123,10 +125,12 @@ func main() {
 	var count int
 
 	app := &cli.App{
+		UseShortOptionHandling: true,
 		Flags: []cli.Flag{
 			&cli.BoolFlag{
 				Name:        "foo",
 				Usage:       "foo greeting",
+				Aliases:     []string{"f"},
 				Count: &count,
 			},
 		},
diff --git a/docs/v3/examples/flags.md b/docs/v3/examples/flags.md
index 1344c55182..6bf846463e 100644
--- a/docs/v3/examples/flags.md
+++ b/docs/v3/examples/flags.md
@@ -106,6 +106,8 @@ See full list of flags at https://pkg.go.dev/github.com/urfave/cli/v3
 
 For bool flags you can specify the flag multiple times to get a count(e.g -v -v -v or -vvv)
 
+> If you want to support the `-vvv` flag, you need to set `Command.UseShortOptionHandling`.
+
 <!-- {
   "args": ["&#45;&#45;foo", "&#45;&#45;foo"],
   "output": "count 2"
@@ -126,10 +128,12 @@ func main() {
 	var count int
 
 	cmd := &cli.Command{
+		UseShortOptionHandling: true,
 		Flags: []cli.Flag{
 			&cli.BoolFlag{
 				Name:        "foo",
 				Usage:       "foo greeting",
+				Aliases:     []string{"f"},
 				Config: cli.BoolConfig{
 					Count: &count,
 				},

From 0be947b90e240e597d52e74e604fa0bbca67f693 Mon Sep 17 00:00:00 2001
From: Kevin Cui <github@bugs.cc>
Date: Tue, 16 Jul 2024 18:03:27 +0800
Subject: [PATCH 2/3] Update flags.md

Co-authored-by: Anatoli Babenia <anatoli@rainforce.org>
---
 docs/v3/examples/flags.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/v3/examples/flags.md b/docs/v3/examples/flags.md
index 6bf846463e..04d1aefb44 100644
--- a/docs/v3/examples/flags.md
+++ b/docs/v3/examples/flags.md
@@ -109,8 +109,8 @@ For bool flags you can specify the flag multiple times to get a count(e.g -v -v
 > If you want to support the `-vvv` flag, you need to set `Command.UseShortOptionHandling`.
 
 <!-- {
-  "args": ["&#45;&#45;foo", "&#45;&#45;foo"],
-  "output": "count 2"
+  "args": ["&#45;&#45;foo", "&#45;&#45;foo", "&#45;fff"],
+  "output": "count 5"
 } -->
 ```go
 package main

From 3bc73ed60bdb19a7692052db58e1ddbf9aaaf61a Mon Sep 17 00:00:00 2001
From: Kevin Cui <github@bugs.cc>
Date: Tue, 16 Jul 2024 18:03:43 +0800
Subject: [PATCH 3/3] Update flags.md

Co-authored-by: Anatoli Babenia <anatoli@rainforce.org>
---
 docs/v2/examples/flags.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/v2/examples/flags.md b/docs/v2/examples/flags.md
index 0ef4c86ef4..2f16c4c3e8 100644
--- a/docs/v2/examples/flags.md
+++ b/docs/v2/examples/flags.md
@@ -107,8 +107,8 @@ For bool flags you can specify the flag multiple times to get a count(e.g -v -v
 > If you want to support the `-vvv` flag, you need to set `App.UseShortOptionHandling`.
 
 <!-- {
-  "args": ["&#45;&#45;foo", "&#45;&#45;foo"],
-  "output": "count 2"
+  "args": ["&#45;&#45;foo", "&#45;&#45;foo", "&#45;fff",  "&#45;f"],
+  "output": "count 6"  
 } -->
 ```go
 package main