Zsh Mailing List Archive
Messages sorted by:
Reverse Date,
Date,
Thread,
Author
[PATCH] docs: clarify zformat -F ternary behaviour
- X-seq: zsh-workers 54579
- From: dana <dana@xxxxxxx>
- To: zsh-workers@xxxxxxx
- Subject: [PATCH] docs: clarify zformat -F ternary behaviour
- Date: Mon, 18 May 2026 04:04:11 -0500
- Archived-at: <https://zsh.org/workers/54579>
- Feedback-id: i9be146f9:Fastmail
- List-id: <zsh-workers.zsh.org>
> With -F instead of -f, ternary expressions choose between the ‘true’
> or ‘false’ text on the basis of whether the format specifier is
> present and non-empty. A test number indicates a minimum width for the
> value given in the format specifier. Negative numbers reverse this, so
> the test is for whether the value exceeds a maximum width.
that's just not true. maybe this is better
dana
diff --git a/Doc/Zsh/mod_zutil.yo b/Doc/Zsh/mod_zutil.yo
index c33e3c721..a36104167 100644
--- a/Doc/Zsh/mod_zutil.yo
+++ b/Doc/Zsh/mod_zutil.yo
@@ -207,9 +207,11 @@ expression.
With tt(-F) instead of tt(-f), ternary expressions choose between the
`true' or `false' text on the basis of whether the format specifier is
-present and non-empty. A test number indicates a minimum width for the
-value given in the format specifier. Negative numbers reverse this,
-so the test is for whether the value exceeds a maximum width.
+present and non-empty. If a test number is provided, it tests the width
+of the value given in the format specifier DASH()- with a positive
+number the condition is true when the width is em(greater than) that
+number, and with a negative number the condition is true when the width
+is em(less than or equal to) the absolute value of that number.
The form, using the tt(-a) option, can be used for aligning
strings. Here, the var(spec)s are of the form
Messages sorted by:
Reverse Date,
Date,
Thread,
Author