From 31174134e282d3a056a01128040ba079ddb2200e Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Tue, 12 Nov 2024 08:01:27 +0300
Subject: [PATCH 1/5] Fix links to examples

---
 README.md | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 481e8b9..4c11d4d 100644
--- a/README.md
+++ b/README.md
@@ -23,12 +23,19 @@ And you can use your favorite flag or cli library!
 
 ## Supported flags and cli libraries:
 
- - [x] [flag](https://golang.org/pkg/flag/) - [example](https://github.com/octago/sflags/blob/master/examples/flag/main.go)
- - [x] [spf13/pflag](https://github.com/spf13/pflag) - [example](https://github.com/octago/sflags/blob/master/examples/pflag/main.go)
- - [x] [spf13/cobra](https://github.com/spf13/cobra) - [example](https://github.com/octago/sflags/blob/master/examples/cobra/main.go)
- - [ ] [spf13/viper](https://github.com/spf13/viper)
- - [x] [urfave/cli](https://github.com/urfave/cli) [example](https://github.com/octago/sflags/blob/master/examples/urfave_cli/main.go)
- - [x] [kingpin](https://github.com/alecthomas/kingpin) [example](https://github.com/octago/sflags/blob/master/examples/kingpin/main.go)
+ - [x] [flag] - [example](./examples/flag/main.go)
+ - [x] [spf13/pflag] - [example](./examples/pflag/main.go)
+ - [x] [spf13/cobra] - [example](.examples/cobra/main.go)
+ - [ ] [spf13/viper]
+ - [x] [urfave/cli] - [example](./urfave_cli/main.go)
+ - [x] [kingpin] - [example](./examples/kingpin/main.go)
+
+[flag]: https://golang.org/pkg/flag/
+[spf13/pflag]: https://github.com/spf13/pflag
+[spf13/cobra]: https://github.com/spf13/cobra
+[spf13/viper]: https://github.com/spf13/viper
+[urfave/cli]: https://github.com/urfave/cli
+[kingpin]: https://github.com/alecthomas/kingpin
 
 ## Features:
 

From cb64d005ee3f975e781a09d58514c87f33f8a837 Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Tue, 12 Nov 2024 08:17:35 +0300
Subject: [PATCH 2/5] Reformat as a table

---
 README.md | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 4c11d4d..d8996b3 100644
--- a/README.md
+++ b/README.md
@@ -23,12 +23,14 @@ And you can use your favorite flag or cli library!
 
 ## Supported flags and cli libraries:
 
- - [x] [flag] - [example](./examples/flag/main.go)
- - [x] [spf13/pflag] - [example](./examples/pflag/main.go)
- - [x] [spf13/cobra] - [example](.examples/cobra/main.go)
- - [ ] [spf13/viper]
- - [x] [urfave/cli] - [example](./urfave_cli/main.go)
- - [x] [kingpin] - [example](./examples/kingpin/main.go)
+|     |     |
+| --- | --- |
+| <ul><li>[x] [flag]</li><ul> | [example](./examples/flag/main.go) |
+| <ul><li>[x] [spf13/pflag]</li></ul> | [example](./examples/pflag/main.go) |
+| <ul><li>[x] [spf13/cobra]</li></ul> | [example](./examples/cobra/main.go) |
+| <ul><li>[ ] [spf13/viper]</li><ul> |   |
+| <ul><li>[x] [urfave/cli]</li></ul> | [example](./example/urfave_cli/main.go) |
+| <ul><li>[x] [kingpin]</li></ul> | [example](./examples/kingpin/main.go) |
 
 [flag]: https://golang.org/pkg/flag/
 [spf13/pflag]: https://github.com/spf13/pflag

From 1094572d3e5d7dcfe60734eb0467278e2e4c3b38 Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Tue, 12 Nov 2024 08:44:11 +0300
Subject: [PATCH 3/5] Merge features and libs tables into one

---
 README.md | 45 ++++++++++++++++++---------------------------
 1 file changed, 18 insertions(+), 27 deletions(-)

diff --git a/README.md b/README.md
index d8996b3..49f39c0 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Flags based on structures. [![GoDoc](https://godoc.org/github.com/octago/sflags?status.svg)](http://godoc.org/github.com/octago/sflags) [![Build Status](https://travis-ci.org/octago/sflags.svg?branch=master)](https://travis-ci.org/octago/sflags)  [![codecov](https://codecov.io/gh/octago/sflags/branch/master/graph/badge.svg)](https://codecov.io/gh/octago/sflags)  [![Go Report Card](https://goreportcard.com/badge/github.com/octago/sflags)](https://goreportcard.com/report/github.com/octago/sflags)
+# Flags based on structures [![GoDoc](https://godoc.org/github.com/octago/sflags?status.svg)](http://godoc.org/github.com/octago/sflags) [![Build Status](https://travis-ci.org/octago/sflags.svg?branch=master)](https://travis-ci.org/octago/sflags)  [![codecov](https://codecov.io/gh/octago/sflags/branch/master/graph/badge.svg)](https://codecov.io/gh/octago/sflags)  [![Go Report Card](https://goreportcard.com/badge/github.com/octago/sflags)](https://goreportcard.com/report/github.com/octago/sflags)
 
 The sflags package uses structs, reflection and struct field tags
 to allow you specify command line options. It supports [different types](#supported-types-in-structures) and [features](#features).
@@ -21,16 +21,21 @@ type Config struct {
 
 And you can use your favorite flag or cli library!
 
-## Supported flags and cli libraries:
+## Supported libraries and features:
+
+|     |     | Hidden | Deprecated | Short | Env |
+| --- | --- | ------ | ---------- |------ | --- |
+| <ul><li>[x] [flag]</li><ul> | [example](./examples/flag/main.go) | `-` | `-` | `-` | `-` |
+| <ul><li>[x] [spf13/pflag]</li></ul> | [example](./examples/pflag/main.go) | [x] | [x] | [x] | `-` |
+| <ul><li>[x] [spf13/cobra]</li></ul> | [example](./examples/cobra/main.go) | [x] | [x] | [x] | `-` |
+| <ul><li>[ ] [spf13/viper]</li><ul> |   | [ ] | [ ] | [ ] | [ ] |
+| <ul><li>[x] [urfave/cli]</li></ul> | [example](./example/urfave_cli/main.go) | [x] | `-` | [x] | [x] |
+| <ul><li>[x] [kingpin]</li></ul> | [example](./examples/kingpin/main.go) | [x] | [ ] | [x] | [x] |
+
+- [x] - feature is supported and implemented
+
+`-` - feature can't be implemented for this cli library
 
-|     |     |
-| --- | --- |
-| <ul><li>[x] [flag]</li><ul> | [example](./examples/flag/main.go) |
-| <ul><li>[x] [spf13/pflag]</li></ul> | [example](./examples/pflag/main.go) |
-| <ul><li>[x] [spf13/cobra]</li></ul> | [example](./examples/cobra/main.go) |
-| <ul><li>[ ] [spf13/viper]</li><ul> |   |
-| <ul><li>[x] [urfave/cli]</li></ul> | [example](./example/urfave_cli/main.go) |
-| <ul><li>[x] [kingpin]</li></ul> | [example](./examples/kingpin/main.go) |
 
 [flag]: https://golang.org/pkg/flag/
 [spf13/pflag]: https://github.com/spf13/pflag
@@ -83,22 +88,10 @@ And you can use your favorite flag or cli library!
  - [ ] url list
  - [ ] units (bytes 1kb = 1024b, speed, etc)
 
-## Supported features matrix:
+## Example:
 
-| Name | Hidden | Deprecated | Short | Env |
-| --- | --- | --- | --- | --- |
-| flag | - | - | - | - |
-| pflag | [x] | [x] | [x] | - |
-| kingpin | [x] | [ ] | [x] | [x] |
-| urfave | [x] | - | [x] | [x] |
-| cobra | [x] | [x] | [x] | - |
-| viper | [ ] | [ ] | [ ] | [ ] |
-
-  \[x] - feature is supported and implemented
-  
-  `-` - feature can't be implemented for this cli library
-
-Simple example for flag library:
+The code below shows how to use `sflags` with the [flag] library. Examples for other
+flag libraries are available from [./examples](./examples) dir.
 
 ```golang
 package main
@@ -154,8 +147,6 @@ Usage of _obj/exe/main:
 exit status 2
 ```
 
-Look at the other [examples](https://github.com/octago/sflags/blob/master/examples) for different flag libraries.
-
 ## Options for flag tag
 
 The flag default key string is the struct field name but can be specified in the struct field's tag value.

From 4d9b4d673e64c7090c6095cbfe1eaf23a161b7ff Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Tue, 12 Nov 2024 09:09:40 +0300
Subject: [PATCH 4/5] Format checkboxes

---
 README.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 49f39c0..ac91eba 100644
--- a/README.md
+++ b/README.md
@@ -26,11 +26,11 @@ And you can use your favorite flag or cli library!
 |     |     | Hidden | Deprecated | Short | Env |
 | --- | --- | ------ | ---------- |------ | --- |
 | <ul><li>[x] [flag]</li><ul> | [example](./examples/flag/main.go) | `-` | `-` | `-` | `-` |
-| <ul><li>[x] [spf13/pflag]</li></ul> | [example](./examples/pflag/main.go) | [x] | [x] | [x] | `-` |
-| <ul><li>[x] [spf13/cobra]</li></ul> | [example](./examples/cobra/main.go) | [x] | [x] | [x] | `-` |
-| <ul><li>[ ] [spf13/viper]</li><ul> |   | [ ] | [ ] | [ ] | [ ] |
-| <ul><li>[x] [urfave/cli]</li></ul> | [example](./example/urfave_cli/main.go) | [x] | `-` | [x] | [x] |
-| <ul><li>[x] [kingpin]</li></ul> | [example](./examples/kingpin/main.go) | [x] | [ ] | [x] | [x] |
+| <ul><li>[x] [spf13/pflag]</li></ul> | [example](./examples/pflag/main.go) | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> | `-` |
+| <ul><li>[x] [spf13/cobra]</li></ul> | [example](./examples/cobra/main.go) | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> | `-` |
+| <ul><li>[ ] [spf13/viper]</li><ul> |   | <ul><li>[ ] </li></ul> | <ul><li>[ ] </li></ul> | <ul><li>[ ] </li></ul> | <ul><li>[ ] </li></ul> |
+| <ul><li>[x] [urfave/cli]</li></ul> | [example](./example/urfave_cli/main.go) | <ul><li>[x] </li></ul> | `-` | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> |
+| <ul><li>[x] [kingpin]</li></ul> | [example](./examples/kingpin/main.go) | <ul><li>[x] </li></ul> | <ul><li>[ ] </li></ul> | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> |
 
 - [x] - feature is supported and implemented
 

From ae1911c6fbc32a633d2594f203b93228983ae1b9 Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Tue, 12 Nov 2024 09:11:15 +0300
Subject: [PATCH 5/5] Sort libraries in table

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ac91eba..b280ccb 100644
--- a/README.md
+++ b/README.md
@@ -26,11 +26,11 @@ And you can use your favorite flag or cli library!
 |     |     | Hidden | Deprecated | Short | Env |
 | --- | --- | ------ | ---------- |------ | --- |
 | <ul><li>[x] [flag]</li><ul> | [example](./examples/flag/main.go) | `-` | `-` | `-` | `-` |
+| <ul><li>[x] [kingpin]</li></ul> | [example](./examples/kingpin/main.go) | <ul><li>[x] </li></ul> | <ul><li>[ ] </li></ul> | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> |
 | <ul><li>[x] [spf13/pflag]</li></ul> | [example](./examples/pflag/main.go) | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> | `-` |
 | <ul><li>[x] [spf13/cobra]</li></ul> | [example](./examples/cobra/main.go) | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> | `-` |
 | <ul><li>[ ] [spf13/viper]</li><ul> |   | <ul><li>[ ] </li></ul> | <ul><li>[ ] </li></ul> | <ul><li>[ ] </li></ul> | <ul><li>[ ] </li></ul> |
 | <ul><li>[x] [urfave/cli]</li></ul> | [example](./example/urfave_cli/main.go) | <ul><li>[x] </li></ul> | `-` | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> |
-| <ul><li>[x] [kingpin]</li></ul> | [example](./examples/kingpin/main.go) | <ul><li>[x] </li></ul> | <ul><li>[ ] </li></ul> | <ul><li>[x] </li></ul> | <ul><li>[x] </li></ul> |
 
 - [x] - feature is supported and implemented