From d03d703868ea404d084d5d8f9ffa7befcd1a7f3e Mon Sep 17 00:00:00 2001 From: claudex Date: Wed, 29 Jul 2026 20:54:59 +0200 Subject: [PATCH] Update docs/cmdline-opts/write-out.md Co-authored-by: Daniel Stenberg --- docs/cmdline-opts/write-out.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/cmdline-opts/write-out.md b/docs/cmdline-opts/write-out.md index 9df35658f8..6c82534739 100644 --- a/docs/cmdline-opts/write-out.md +++ b/docs/cmdline-opts/write-out.md @@ -57,12 +57,11 @@ when using this option to properly escape. If this option is used at the command prompt then the % cannot be escaped and unintended expansion is possible. -The option allow a filter to be added to the variables that express a size. -This allow to convert the size using the standard suffixes K, M, G... like -what's printed by default on the CLI. The filter allow maximum 4 digits plus -one suffix character. To use it, add the `:pretty` suffix to the variable. For -example, `--write-out '%{size_download:pretty}'`. This only works with variable -that output a size like parameter +To format numerical output for better human readability, append the `:pretty` +modifier to a numerical variable name (e.g., `--write-out '%{size_download:pretty}'`). +This modifier applies standard SI metric suffixes (K, M, G, etc.) and +constrains the output to a maximum width of 5 characters, including the +suffix. This works only with numerical variables. The variables available are: