]> git.ipfire.org Git - thirdparty/coreutils.git/commitdiff
doc: ls: document --block-size in the manual
authorPádraig Brady <P@draigBrady.com>
Tue, 20 Jan 2026 18:58:40 +0000 (18:58 +0000)
committerPádraig Brady <P@draigBrady.com>
Wed, 21 Jan 2026 13:51:58 +0000 (13:51 +0000)
* doc/coreutils.texi (ls invocation): Document --block-size

doc/coreutils.texi

index cea9efb842e5c3b766a41fd85fd65f3dacf26b8d..261cb69dfc8b2ab5b2d8e518d3903c45dbdcc182 100644 (file)
@@ -7731,6 +7731,12 @@ Inhibit display of group information in long format.
 (This is the default in some non-GNU versions of @command{ls}, so we
 provide this option for compatibility.)
 
+@optItem{ls,--block-size,=@var{size}}
+@cindex file sizes
+With @option{-l}, scale sizes by @var{size} before printing them
+(@pxref{Block size}).  For example,
+@option{--block-size=G} prints sizes in units of 1,073,741,824 bytes.
+
 @optHumanReadable{ls}
 
 @optItem{ls,-i,}