Repository: eza-community/eza (language: rust)

Issue:
bug: Undocumented options
- The version of eza being used (`eza --version`)

v0.14.0 [+git]

- The command-line arguments you are using

`-?`

- Your operating system and hardware platform

Linux Mint 21.2

---

The following options are not documented in the man file:

`-?`, `--help`
`-v`, `--version`

The following options are not documented in either the man file or the `--help` output:

`-A`, `--almost-all`
`-X`, `--dereference`



Discussion / hints:
> -?

We do want to phase this one out before v1.0, and replace it with -h. The others should definitely be documented thou

Fix patch:
diff --git a/completions/bash/eza b/completions/bash/eza
index df739d480..5da803d20 100644
--- a/completions/bash/eza
+++ b/completions/bash/eza
@@ -4,7 +4,7 @@ _eza() {
     prev=${COMP_WORDS[COMP_CWORD-1]}
 
     case "$prev" in
-        -'?'|--help|-v|--version)
+        --help|-v|--version)
             return
             ;;
 
diff --git a/completions/nush/eza.nu b/completions/nush/eza.nu
index 5094f8cea..67bf42c7b 100644
--- a/completions/nush/eza.nu
+++ b/completions/nush/eza.nu
@@ -1,6 +1,6 @@
 export extern "eza" [
     --version(-v)              # Show version of eza
-    --help(-?)                 # Show list of command-line options
+    --help                     # Show list of command-line options
     --oneline(-1)              # Display one entry per line
     --long(-l)                 # Display extended file metadata as a table
     --grid(-G)                 # Display entries in a grid
diff --git a/completions/zsh/_eza b/completions/zsh/_eza
index 63982e118..577a84ebf 100644
--- a/completions/zsh/_eza
+++ b/completions/zsh/_eza
@@ -11,7 +11,7 @@ __eza() {
     # `-S` for delimiting options with `--` like in `eza -- -a`.
     _arguments -s -S \
         "(- *)"{-v,--version}"[Show version of eza]" \
-        "(- *)"{-'\?',--help}"[Show list of command-line options]" \
+        "(- *)"{--help}"[Show list of command-line options]" \
         {-1,--oneline}"[Display one entry per line]" \
         {-l,--long}"[Display extended file metadata as a table]" \
         {-G,--grid}"[Display entries as a grid]" \
diff --git a/man/eza.1.md b/man/eza.1.md
index a72aaa291..2e45b06c5 100644
--- a/man/eza.1.md
+++ b/man/eza.1.md
@@ -38,6 +38,16 @@ EXAMPLES
 : Displays a tree of files, three levels deep, as well as each file’s metadata.
 
 
+META OPTIONS
+===============
+
+`--help`
+: Show list of command-line options.
+
+`-v`, `--version`
+: Show version of eza.
+
+
 DISPLAY OPTIONS
 ===============
 
@@ -59,6 +69,9 @@ DISPLAY OPTIONS
 `-T`, `--tree`
 : Recurse into directories as a tree.
 
+`-X`, `--dereference`
+: Dereference symbolic links when displaying information.
+
 `-x`, `--across`
 : Sort the grid across, rather than downwards.
 
@@ -98,6 +111,9 @@ FILTERING AND SORTING OPTIONS
 : Show hidden and “dot” files.
 Use this twice to also show the ‘`.`’ and ‘`..`’ directories.
 
+`-A`, `--almost-all`
+: Equivalent to --all; included for compatibility with `ls -A`.
+
 `-d`, `--list-dirs`
 : List directories as regular files, rather than recursing and listing their contents.
 
diff --git a/src/options/help.rs b/src/options/help.rs
index 6d0043cc1..16b174ea9 100644
--- a/src/options/help.rs
+++ b/src/options/help.rs
@@ -8,7 +8,7 @@ static USAGE_PART1: &str = "Usage:
   eza [options] [files...]
 
 META OPTIONS
-  -?, --help         show list of command-line options
+  --help             show list of command-line options
   -v, --version      show version of eza
 
 DISPLAY OPTIONS
@@ -18,6 +18,7 @@ DISPLAY OPTIONS
   -x, --across       sort the grid across, rather than downwards
   -R, --recurse      recurse into directories
   -T, --tree         recurse into directories as a tree
+  -X, --dereference  dereference symbolic links when displaying information
   -F, --classify     display type indicator by file names
   --colo[u]r=WHEN    when to use terminal colours (always, auto, never)
   --colo[u]r-scale   highlight levels of file sizes distinctly
@@ -27,8 +28,10 @@ DISPLAY OPTIONS
   --hyperlink        display entries as hyperlinks
   -w, --width COLS   set screen width in columns
 
+
 FILTERING AND SORTING OPTIONS
   -a, --all                  show hidden and 'dot' files. Use this twice to also show the '.' and '..' directories
+  -A, --almost-all           equivalent to --all; included for compatibility with `ls -A`
   -d, --list-dirs            list directories as files; don't list their contents
   -L, --level DEPTH          limit the depth of recursion
   -r, --reverse              reverse the sort order


Test patch: