From: Pádraig Brady <P@draigBrady.com>
Date: Wed, 3 Jun 2026 17:06:11 +0000 (+0100)
Subject: doc: NEWS: describe the stat file name quoting changes
X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=HEAD;p=thirdparty%2Fcoreutils.git

doc: NEWS: describe the stat file name quoting changes

Note also a previous discussion on stat quoting at:
https://bugs.gnu.org/23422

* NEWS: Describe the changes in behavior.
---

diff --git a/NEWS b/NEWS
index 4dad878b03..40822ceccc 100644
--- a/NEWS
+++ b/NEWS
@@ -36,6 +36,12 @@ GNU coreutils NEWS                                    -*- outline -*-
   'ls' -w,--width no longer includes '\n' in the width of a line.
   I.e., the width or $COLUMNS is interpreted to be an _inclusive_ maximum.
 
+  'stat' now uses shell quoting when required, to more robustly escape
+  file names.  Previously it only quoted file names with the %N format.
+  The default quoting honors the QUOTING_STYLE env variable (like %N).
+  Also %Qn is a newly supported format combination to quote file names,
+  leaving the existing %n format for when quoting is not desired.
+
 ** Improvements
 
   'sort' will now better use available memory and parallel operation