]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
_PROGRESS.md: add the E unit, mention kibibyte
authorDaniel Stenberg <daniel@haxx.se>
Wed, 12 Nov 2025 22:15:37 +0000 (23:15 +0100)
committerDaniel Stenberg <daniel@haxx.se>
Wed, 12 Nov 2025 22:44:25 +0000 (23:44 +0100)
The suffixes used are not standard since we want them to be single
characters and the proper ones would be KiB, MiB etc.

Closes #19502

.github/scripts/pyspelling.words
docs/cmdline-opts/_PROGRESS.md

index 5dbce132271e8cf22ba95f42e8710830307671e7..76889a05bbe02dd73ed63e290b915a0b64ab906a 100644 (file)
@@ -244,6 +244,7 @@ et
 etag
 ETag
 ETags
+exa
 exe
 executables
 EXPN
@@ -417,6 +418,7 @@ kerberos
 Keychain
 keychain
 KiB
+kibibyte
 kickstart
 Kirei
 Knauf
@@ -491,6 +493,7 @@ Mavrogiannopoulos
 Mbed
 mbedTLS
 md
+mebibyte
 Meglio
 memdebug
 MesaLink
index 9ab1ce8c9bf70e87e8d222b1b1a9ed45c8367632..a506d041dca064d4a81fa42be24f0df86133382d 100644 (file)
@@ -4,9 +4,10 @@
 
 curl normally displays a progress meter during operations, indicating the
 amount of transferred data, transfer speeds and estimated time left, etc. The
-progress meter displays the transfer rate in bytes per second. The suffixes
-(`k` for kilo, `M` for mega, `G` for giga, `T` for tera, and `P` for peta) are
-1024 based. For example 1k is 1024 bytes. 1M is 1048576 bytes.
+progress meter displays the transfer rate in bytes per second. The used
+suffixes (`k` for kilo, `M` for mega, `G` for giga, `T` for tera, `P` for peta
+and `E` for exa) are 1024 based. For example 1k is 1024 bytes. 1M is 1048576
+bytes. Strictly speaking this makes the units kibibyte and mebibyte etc.
 
 curl displays this data to the terminal by default, so if you invoke curl to
 do an operation and it is about to write data to the terminal, it *disables*
@@ -14,8 +15,8 @@ the progress meter as otherwise it would mess up the output mixing progress
 meter and response data.
 
 If you want a progress meter for HTTP POST or PUT requests, you need to
-redirect the response output to a file, using shell redirect (\>), --output
-or similar.
+redirect the response output to a file, using shell redirect (\>), --output or
+similar.
 
 This does not apply to FTP upload as that operation does not spit out any
 response data to the terminal.