From: Pádraig Brady <P@draigBrady.com>
Date: Tue, 20 Jan 2026 18:58:40 +0000 (+0000)
Subject: doc: ls: document --block-size in the manual
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=af61d818f861fee3aa5cff1fe29110fecfdcbc44;p=thirdparty%2Fcoreutils.git

doc: ls: document --block-size in the manual

* doc/coreutils.texi (ls invocation): Document --block-size
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index cea9efb842..261cb69dfc 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -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,}