On 01/05/2026 16:42, Vineet Padole wrote:
The existing description of numeric modes is dense and combines multiple concepts in a single paragraph.This change restructures the section to separate digit roles and improves readability. It also adds a concise mapping of octal values to permission bits for quick reference. No functional changes.
Thanks for the patch, However I don't think it's an improvement, as it makes it unclear if the "special mode bits" relate to a class of user. Also it drops how "other" users relate to groups. Also it mixes ls mode representation which could be confusing. We do have more detailed info on Numeric modes though in the full manual online. I think it would be good to link to that from the man page. With the attached, "numeric mode" in the man page now links to: https://www.gnu.org/software/coreutils/manual/html_node/Numeric-Modes.html On systems that don't support links, we degrade gracefully to what was displayed before. cheers, Padraig
From a40fc887b763cab032e6bb4ecd7b48aad0205406 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?P=C3=A1draig=20Brady?= <[email protected]> Date: Fri, 1 May 2026 18:48:39 +0100 Subject: [PATCH] doc: reference detailed "numeric mode" info from chmod.1 Note were links are not supported (like on Solaris or FreeBSD), the text still displays normally. * man/chmod.x: Link from "numeric mode" in chmod man page, to more detailed online info. --- man/chmod.x | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/man/chmod.x b/man/chmod.x index 39749f0bf..1faf4a5bd 100644 --- a/man/chmod.x +++ b/man/chmod.x @@ -49,7 +49,10 @@ users who are members of the file's group (\fBg\fP), and the permissions granted to users that are in neither of the two preceding categories (\fBo\fP). .PP -A numeric mode is from one to four octal digits (0\-7), derived by +.ds cU https://www.gnu.org/software/coreutils/manual/html_node/ +.as cU Numeric-Modes.html +A \X'tty: link \*(cU'\fBnumeric mode\fP\X'tty: link' +is from one to four octal digits (0\-7), derived by adding up the bits with values 4, 2, and 1. Omitted digits are assumed to be leading zeros. The first digit selects the set user ID (4) and set group ID (2) and -- 2.54.0
