From af61d818f861fee3aa5cff1fe29110fecfdcbc44 Mon Sep 17 00:00:00 2001
From: =?utf8?q?P=C3=A1draig=20Brady?= <P@draigBrady.com>
Date: Tue, 20 Jan 2026 18:58:40 +0000
Subject: [PATCH] doc: ls: document --block-size in the manual

* doc/coreutils.texi (ls invocation): Document --block-size
---
 doc/coreutils.texi | 6 ++++++
 1 file changed, 6 insertions(+)

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,}
-- 
2.47.3