Revert "style(completion): remove -d descriptions to save screen space"

This reverts commit 45b1157a2a7234fe865df1e8ff836f58ca6ff448.

1 files changed, 142 insertions, 142 deletions

diff --git a/completions/gt.fish b/completions/gt.fish
index e0a2917..c901488 100644
--- a/completions/gt.fish
+++ b/completions/gt.fish
@@ -27,360 +27,360 @@ end
 # ── Flags ────────────────────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_needs_top_level" \
-    -l log -r
+    -l log -r -d "Session log file (REPL mode)"
 
 # ── Top-level subcommands ────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_needs_top_level" \
-    -a version
+    -a version -d "Show version"
 
 # ── Expression prefixes ──────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "rpn"
+    -a "rpn" -d "RPN expression prefix"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "calc"
+    -a "calc" -d "Calculation prefix (alias)"
 
 # ── Arithmetic operators ─────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "+"
+    -a "+" -d "Addition"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "-"
+    -a "-" -d "Subtraction"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "*"
+    -a "*" -d "Multiplication"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "/"
+    -a "/" -d "Division"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "^"
+    -a "^" -d "Power"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "**"
+    -a "**" -d "Fast integer power"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "%"
+    -a "%" -d "Modulo"
 
 # ── Logarithmic operators ────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "lg"
+    -a "lg" -d "Log base 2"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "log"
+    -a "log" -d "Log base 10"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "ln"
+    -a "ln" -d "Natural log"
 
 # ── Comparison operators ─────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "gt"
+    -a "gt" -d "Greater than"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "lt"
+    -a "lt" -d "Less than"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "gte"
+    -a "gte" -d "Greater or equal"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "lte"
+    -a "lte" -d "Less or equal"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "eq"
+    -a "eq" -d "Equal"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "=="
+    -a "==" -d "Equal"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "neq"
+    -a "neq" -d "Not equal"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "!="
+    -a "!=" -d "Not equal"
 
 # ── Hyper (n-ary) operators ──────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[+]"
+    -a "[+]" -d "Hyper add (n-ary)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[-]"
+    -a "[-]" -d "Hyper subtract (n-ary)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[*]"
+    -a "[*]" -d "Hyper multiply (n-ary)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[/]"
+    -a "[/]" -d "Hyper divide (n-ary)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[^]"
+    -a "[^]" -d "Hyper power (n-ary)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[%]"
+    -a "[%]" -d "Hyper modulo (n-ary)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[lg]"
+    -a "[lg]" -d "Hyper log2 (n-ary)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[log]"
+    -a "[log]" -d "Hyper log10 (n-ary)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "[ln]"
+    -a "[ln]" -d "Hyper ln (n-ary)"
 
 # ── Stack operators ──────────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "dup"
+    -a "dup" -d "Duplicate top of stack"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "swap"
+    -a "swap" -d "Swap top two stack values"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "pop"
+    -a "pop" -d "Discard top of stack"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "d"
+    -a "d" -d "Delete top two stack values"
 
 # ── Assignment / conversion operators ────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a ":="
+    -a ":=" -d "Assign right-to-left"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "=:"
+    -a "=:" -d "Assign left-to-right"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "convert"
+    -a "convert" -d "Convert metric unit (with @unit)"
 
 # ── Command operators ────────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "show"
+    -a "show" -d "Show stack"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "showstack"
+    -a "showstack" -d "Show stack (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "print"
+    -a "print" -d "Show stack (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "vars"
+    -a "vars" -d "List variables"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "constants"
+    -a "constants" -d "List constants"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "clear"
+    -a "clear" -d "Clear all variables"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "clearconstants"
+    -a "clearconstants" -d "Reset constants to defaults"
 
 # ── Boolean literals ─────────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "true"
+    -a "true" -d "Boolean true (coerces to 1)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "false"
+    -a "false" -d "Boolean false (coerces to 0)"
 
 # ── Constants ────────────────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "pi"
+    -a "pi" -d "π (3.14159…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "e"
+    -a "e" -d "Euler's number (2.71828…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "euler"
+    -a "euler" -d "Euler's number (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "phi"
+    -a "phi" -d "Golden ratio (1.61803…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "sqrt2"
+    -a "sqrt2" -d "√2 (1.41421…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "sqrt3"
+    -a "sqrt3" -d "√3 (1.73205…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "sqrt5"
+    -a "sqrt5" -d "√5 (2.23606…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "ln2"
+    -a "ln2" -d "ln(2) (0.69314…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "log2"
+    -a "log2" -d "ln(2) (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "ln10"
+    -a "ln10" -d "ln(10) (2.30258…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "log10"
+    -a "log10" -d "ln(10) (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "log_e"
+    -a "log_e" -d "log₁₀(e) (0.43429…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "log_e10"
+    -a "log_e10" -d "log₁₀(e) (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "tau"
+    -a "tau" -d "τ = 2π (6.28318…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "inv_pi"
+    -a "inv_pi" -d "1/π (0.31830…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "inv_e"
+    -a "inv_e" -d "1/e (0.36787…)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "inf"
+    -a "inf" -d "Positive infinity"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "infinity"
+    -a "infinity" -d "Positive infinity (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "-inf"
+    -a "-inf" -d "Negative infinity"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "-infinity"
+    -a "-infinity" -d "Negative infinity (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "nan"
+    -a "nan" -d "NaN (Not a Number)"
 
 # ── Metric units ─────────────────────────────────────────────────────────────
 
 # DataRate (base: bps)
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "bps"
+    -a "bps" -d "Bits per second"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "Kbps"
+    -a "Kbps" -d "Kilobits per second"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "Mbps"
+    -a "Mbps" -d "Megabits per second"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "Gbps"
+    -a "Gbps" -d "Gigabits per second"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "Tbps"
+    -a "Tbps" -d "Terabits per second"
 
 # DataSize (base: bits)
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "bits"
+    -a "bits" -d "Bits"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "bytes"
+    -a "bytes" -d "Bytes"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "KB"
+    -a "KB" -d "Kilobyte (SI / IEC)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "MB"
+    -a "MB" -d "Megabyte (SI / IEC)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "GB"
+    -a "GB" -d "Gigabyte (SI / IEC)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "TB"
+    -a "TB" -d "Terabyte (SI / IEC)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "PB"
+    -a "PB" -d "Petabyte (SI / IEC)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "KiB"
+    -a "KiB" -d "Kibibyte (1024 bytes)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "MiB"
+    -a "MiB" -d "Mebibyte (1024 KiB)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "GiB"
+    -a "GiB" -d "Gibibyte (1024 MiB)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "TiB"
+    -a "TiB" -d "Tebibyte (1024 GiB)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "PiB"
+    -a "PiB" -d "Pebibyte (1024 TiB)"
 
 # Time (base: seconds)
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "ms"
+    -a "ms" -d "Milliseconds"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "s"
+    -a "s" -d "Seconds"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "sec"
+    -a "sec" -d "Seconds (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "secs"
+    -a "secs" -d "Seconds (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "min"
+    -a "min" -d "Minutes"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "hr"
+    -a "hr" -d "Hours"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "day"
+    -a "day" -d "Days"
 
 # Weight (base: kilograms)
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "mg"
+    -a "mg" -d "Milligrams"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "g"
+    -a "g" -d "Grams"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "kg"
+    -a "kg" -d "Kilograms"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "ton"
+    -a "ton" -d "Metric tons"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "lb"
+    -a "lb" -d "Pounds"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "oz"
+    -a "oz" -d "Ounces"
 
 # Speed (base: m/s)
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "mps"
+    -a "mps" -d "Meters per second"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "kmh"
+    -a "kmh" -d "Kilometers per hour"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "mph"
+    -a "mph" -d "Miles per hour"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "knots"
+    -a "knots" -d "Knots"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "knot"
+    -a "knot" -d "Knots (alias)"
 
 # Distance (base: meters)
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "m"
+    -a "m" -d "Meters"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "km"
+    -a "km" -d "Kilometers"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "mi"
+    -a "mi" -d "Miles"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "mile"
+    -a "mile" -d "Miles (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "miles"
+    -a "miles" -d "Miles (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "ft"
+    -a "ft" -d "Feet"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "foot"
+    -a "foot" -d "Feet (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "feet"
+    -a "feet" -d "Feet (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "in"
+    -a "in" -d "Inches"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "nm"
+    -a "nm" -d "Nautical miles"
 
 # DataRate aliases (bit/s notation)
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "bit/s"
+    -a "bit/s" -d "Bits per second (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "kbit/s"
+    -a "kbit/s" -d "Kilobits per second (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "mbit/s"
+    -a "mbit/s" -d "Megabits per second (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "gbit/s"
+    -a "gbit/s" -d "Gigabits per second (alias)"
 complete -c gt -n "__fish_gt_not_in_metric_or_custom" \
-    -a "tbit/s"
+    -a "tbit/s" -d "Terabits per second (alias)"
 
 # ── `metric` subcommand ──────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_seen_subcommand_from metric" \
-    -a "show"
+    -a "show" -d "Show metric info for top of stack"
 complete -c gt -n "__fish_seen_subcommand_from metric" \
-    -a "list"
+    -a "list" -d "List all metric categories"
 complete -c gt -n "__fish_seen_subcommand_from metric" \
-    -a "compatible"
+    -a "compatible" -d "Check metric compatibility (top 2 values)"
 complete -c gt -n "__fish_seen_subcommand_from metric" \
-    -a "decimal set"
+    -a "decimal set" -d "Switch to SI prefix mode (1000-based)"
 complete -c gt -n "__fish_seen_subcommand_from metric" \
-    -a "binary set"
+    -a "binary set" -d "Switch to IEC prefix mode (1024-based)"
 
 # metric <category> — list metrics in a category
 complete -c gt \
     -n "__fish_seen_subcommand_from metric; and not __fish_seen_subcommand_from show list compatible 'decimal set' 'binary set'" \
-    -a "DataRate"
+    -a "DataRate" -d "bps, Kbps, Mbps, Gbps, Tbps"
 complete -c gt \
     -n "__fish_seen_subcommand_from metric; and not __fish_seen_subcommand_from show list compatible 'decimal set' 'binary set'" \
-    -a "DataSize"
+    -a "DataSize" -d "bits, bytes, KB, MB, GB, …"
 complete -c gt \
     -n "__fish_seen_subcommand_from metric; and not __fish_seen_subcommand_from show list compatible 'decimal set' 'binary set'" \
-    -a "Distance"
+    -a "Distance" -d "m, km, mi, ft, in, nm"
 complete -c gt \
     -n "__fish_seen_subcommand_from metric; and not __fish_seen_subcommand_from show list compatible 'decimal set' 'binary set'" \
-    -a "Speed"
+    -a "Speed" -d "mps, kmh, mph, knots"
 complete -c gt \
     -n "__fish_seen_subcommand_from metric; and not __fish_seen_subcommand_from show list compatible 'decimal set' 'binary set'" \
-    -a "Time"
+    -a "Time" -d "ms, s, min, hr, day"
 complete -c gt \
     -n "__fish_seen_subcommand_from metric; and not __fish_seen_subcommand_from show list compatible 'decimal set' 'binary set'" \
-    -a "Universal"
+    -a "Universal" -d "Cool (unitless)"
 complete -c gt \
     -n "__fish_seen_subcommand_from metric; and not __fish_seen_subcommand_from show list compatible 'decimal set' 'binary set'" \
-    -a "Weight"
+    -a "Weight" -d "mg, g, kg, ton, lb, oz"
 
 # ── `custom` subcommand ──────────────────────────────────────────────────────
 
 complete -c gt -n "__fish_seen_subcommand_from custom" \
-    -a "show"
+    -a "show" -d "Show custom metric(s)"
 complete -c gt -n "__fish_seen_subcommand_from custom" \
-    -a "list"
+    -a "list" -d "List all custom metrics"
 complete -c gt -n "__fish_seen_subcommand_from custom" \
-    -a "define"
+    -a "define" -d "Define a new custom metric"
 complete -c gt -n "__fish_seen_subcommand_from custom" \
-    -a "undefine"
+    -a "undefine" -d "Remove a custom metric"
 
 # custom define <name> <factor> <category> — complete categories
 complete -c gt \
     -n "__fish_seen_subcommand_from define" \
-    -a "Custom"
+    -a "Custom" -d "Custom (user-defined)"
 complete -c gt \
     -n "__fish_seen_subcommand_from define" \
-    -a "DataRate"
+    -a "DataRate" -d "Data rate category"
 complete -c gt \
     -n "__fish_seen_subcommand_from define" \
-    -a "DataSize"
+    -a "DataSize" -d "Data size category"
 complete -c gt \
     -n "__fish_seen_subcommand_from define" \
-    -a "Distance"
+    -a "Distance" -d "Distance category"
 complete -c gt \
     -n "__fish_seen_subcommand_from define" \
-    -a "Speed"
+    -a "Speed" -d "Speed category"
 complete -c gt \
     -n "__fish_seen_subcommand_from define" \
-    -a "Time"
+    -a "Time" -d "Time category"
 complete -c gt \
     -n "__fish_seen_subcommand_from define" \
-    -a "Universal"
+    -a "Universal" -d "Universal (unitless)"
 complete -c gt \
     -n "__fish_seen_subcommand_from define" \
-    -a "Weight"
+    -a "Weight" -d "Weight category"