add documentation and examples showing how to override the short and long option names together

1 files changed, 24 insertions, 1 deletions

diff --git a/README.md b/README.md
index 3526872..a9555b9 100644
--- a/README.md
+++ b/README.md
@@ -125,7 +125,7 @@ Workers: [1 99]
 var args struct {
 	Input    string   `arg:"positional"`
 	Output   []string `arg:"positional"`
-	Verbose  bool     `arg:"-v" help:"verbosity level"`
+	Verbose  bool     `arg:"-v,--verbose" help:"verbosity level"`
 	Dataset  string   `help:"dataset to use"`
 	Optimize int      `arg:"-O" help:"optimization level"`
 }
@@ -240,6 +240,29 @@ $ ./example --version
 someprogram 4.3.0
 ```
 
+### Overriding option names
+
+```go
+var args struct {
+	Short         string  `arg:"-s"`
+	Long          string  `arg:"--custom-long-option"`
+	ShortAndLong  string  `arg:"-x,--my-option"`
+}
+arg.MustParse(&args)
+```
+
+```shell
+$ ./example --help
+Usage: [--short SHORT] [--custom-long-option CUSTOM-LONG-OPTION] [--my-option MY-OPTION]
+
+Options:
+  --short SHORT, -s SHORT
+  --custom-long-option CUSTOM-LONG-OPTION
+  --my-option MY-OPTION, -x MY-OPTION
+  --help, -h             display this help and exit
+```
+
+
 ### Embedded structs
 
 The fields of embedded structs are treated just like regular fields: