man pages: sort flags, and keep them that way

Command flags (OPTIONS) in man pages have to date been in
haphazard order. Sometimes that order is sensible, e.g.,
most-important options first, but more often they're
just in arbitrary places. This makes life hard for users.

Here, I update the man-page-check Makefile script so it
checks and enforces alphabetical order in OPTIONS sections.
Then -- the hard part -- update all existing man pages to
conform to this requirement.

Signed-off-by: Ed Santiago <santiago@redhat.com>

1 files changed, 8 insertions, 8 deletions

diff --git a/docs/source/markdown/podman-secret-ls.1.md b/docs/source/markdown/podman-secret-ls.1.md
index f33ccf41b..3b8535b5d 100644
--- a/docs/source/markdown/podman-secret-ls.1.md
+++ b/docs/source/markdown/podman-secret-ls.1.md
@@ -12,14 +12,6 @@ Lists all the secrets that exist. The output can be formatted to a Go template u
 
 ## OPTIONS
 
-#### **--format**=*format*
-
-Format secret output using Go template.
-
-#### **--noheading**
-
-Omit the table headings from the listing of secrets.	.
-
 #### **--filter**, **-f**=*filter=value*
 
 Filter output based on conditions given.
@@ -32,6 +24,14 @@ Valid filters are listed below:
 | name       | [Name] Secret name (accepts regex)                                |
 | id         | [ID] Full or partial secret ID                                    |
 
+#### **--format**=*format*
+
+Format secret output using Go template.
+
+#### **--noheading**
+
+Omit the table headings from the listing of secrets.	.
+
 ## EXAMPLES
 
 ```