GNU logs - #75916, boring messages

Message sent to bug-coreutils@HIDDEN:

Subject: bug#75916: Making ls(1)'s --format clearer
Resent-From: Samuel Thibault <samuel.thibault@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-coreutils@HIDDEN
Resent-Date: Tue, 28 Jan 2025 20:02:01 +0000
Resent-Message-ID: <handler.75916.B.173809446724834 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 75916 <at> debbugs.gnu.org
Date: Tue, 28 Jan 2025 21:00:37 +0100
From: Samuel Thibault <samuel.thibault@HIDDEN>
Message-ID: <Z5k3ZR6vggR1l5Wm@begin>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="CAxbdmkJuCVjkpJt"
Content-Disposition: inline
Organization: I am not organized
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>


--CAxbdmkJuCVjkpJt
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Hello,

ls(1) says this about --format:

--format=WORD
       across  -x,  commas -m, horizontal -x, long -l, single-column -1,
       verbose -l, vertical -C

It was not clear at all for my students (and not for me either,
actually), that it's the words that should be used, and not the letters.

The attached patch makes this much more explicit:

--format=WORD where WORD can be
       across  (like  -x),  commas (like -m), horizontal (like -x), long
       (like -l), single-column (like -1), verbose (like  -l),  vertical
       (like -C)

Samuel

--CAxbdmkJuCVjkpJt
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename=patch

--- ./man/ls.1.original	2025-01-28 20:51:07.959926088 +0100
+++ ./man/ls.1	2025-01-28 20:58:01.681557095 +0100
@@ -59,9 +59,11 @@
 \fB\-\-file\-type\fR
 likewise, except do not append '*'
 .TP
-\fB\-\-format\fR=\fI\,WORD\/\fR
-across \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR,
-single\-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR
+\fB\-\-format\fR=\fI\,WORD\/\fR where WORD can be
+\fBacross\fR (like \fB\-x\fR), \fBcommas\fR (like \fB\-m\fR),
+\fBhorizontal\fR (like \fB\-x\fR), \fBlong\fR (like \fB\-l\fR),
+\fBsingle\-column\fR (like \fB\-1\fR), \fBverbose\fR (like \fB\-l\fR),
+\fBvertical\fR (like \fB\-C\fR)
 .TP
 \fB\-\-full\-time\fR
 like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR

--CAxbdmkJuCVjkpJt--

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Samuel Thibault <samuel.thibault@HIDDEN>
Subject: bug#75916: Acknowledgement (Making ls(1)'s --format clearer)
Message-ID: <handler.75916.B.173809446724834.ack <at> debbugs.gnu.org>
References: <Z5k3ZR6vggR1l5Wm@begin>
X-Gnu-PR-Message: ack 75916
X-Gnu-PR-Package: coreutils
Reply-To: 75916 <at> debbugs.gnu.org
Date: Tue, 28 Jan 2025 20:02:02 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-coreutils@HIDDEN

If you wish to submit further information on this problem, please
send it to 75916 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
75916: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D75916
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-coreutils@HIDDEN:

Subject: bug#75916: Making ls(1)'s --format clearer
Resent-From: =?UTF-8?Q?P=C3=A1draig?= Brady <P@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-coreutils@HIDDEN
Resent-Date: Tue, 28 Jan 2025 20:22:02 +0000
Resent-Message-ID: <handler.75916.B75916.173809566728506 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: Samuel Thibault <samuel.thibault@HIDDEN>, 75916 <at> debbugs.gnu.org
Message-ID: <15375f78-a8f3-498b-9439-34b202a43412@HIDDEN>
Date: Tue, 28 Jan 2025 20:20:54 +0000
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird Beta
References: <Z5k3ZR6vggR1l5Wm@begin>
Content-Language: en-US
From: =?UTF-8?Q?P=C3=A1draig?= Brady <P@HIDDEN>
In-Reply-To: <Z5k3ZR6vggR1l5Wm@begin>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

On 28/01/2025 20:00, Samuel Thibault wrote:
> Hello,
> 
> ls(1) says this about --format:
> 
> --format=WORD
>         across  -x,  commas -m, horizontal -x, long -l, single-column -1,
>         verbose -l, vertical -C
> 
> It was not clear at all for my students (and not for me either,
> actually), that it's the words that should be used, and not the letters.
> 
> The attached patch makes this much more explicit:
> 
> --format=WORD where WORD can be
>         across  (like  -x),  commas (like -m), horizontal (like -x), long
>         (like -l), single-column (like -1), verbose (like  -l),  vertical
>         (like -C)

Right. It might suffice just to add the parentheses,
and then the description would be of consistent form with:

   --sort=WORD          sort by WORD instead of name: none (-U), size  (-S),  time  (-t),
           version (-v), extension (-X), width


   --indicator-style=WORD
           append  indicator with style WORD to entry names: none (default),
           slash (-p), file-type (--file-type), classify (-F)

I'll adjust accordingly and push if you agree.

cheers,
Pádraig

Message sent to bug-coreutils@HIDDEN:

Subject: bug#75916: Making ls(1)'s --format clearer
Resent-From: Samuel Thibault <samuel.thibault@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-coreutils@HIDDEN
Resent-Date: Tue, 28 Jan 2025 20:26:01 +0000
Resent-Message-ID: <handler.75916.B75916.173809591029274 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: =?UTF-8?Q?P=C3=A1draig?= Brady <P@HIDDEN>
Cc: 75916 <at> debbugs.gnu.org
Date: Tue, 28 Jan 2025 21:24:57 +0100
From: Samuel Thibault <samuel.thibault@HIDDEN>
Message-ID: <Z5k9GQDemfqf-8ty@begin>
References: <Z5k3ZR6vggR1l5Wm@begin>
 <15375f78-a8f3-498b-9439-34b202a43412@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <15375f78-a8f3-498b-9439-34b202a43412@HIDDEN>
Organization: I am not organized
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

Pádraig Brady, le mar. 28 janv. 2025 20:20:54 +0000, a ecrit:
> On 28/01/2025 20:00, Samuel Thibault wrote:
> > ls(1) says this about --format:
> > 
> > --format=WORD
> >         across  -x,  commas -m, horizontal -x, long -l, single-column -1,
> >         verbose -l, vertical -C
> > 
> > It was not clear at all for my students (and not for me either,
> > actually), that it's the words that should be used, and not the letters.
> > 
> > The attached patch makes this much more explicit:
> > 
> > --format=WORD where WORD can be
> >         across  (like  -x),  commas (like -m), horizontal (like -x), long
> >         (like -l), single-column (like -1), verbose (like  -l),  vertical
> >         (like -C)
> 
> Right. It might suffice just to add the parentheses,
> and then the description would be of consistent form with:
> 
>   --sort=WORD          sort by WORD instead of name: none (-U), size  (-S),  time  (-t),
>           version (-v), extension (-X), width
> 
> 
>   --indicator-style=WORD
>           append  indicator with style WORD to entry names: none (default),
>           slash (-p), file-type (--file-type), classify (-F)
> 
> I'll adjust accordingly and push if you agree.

Sure, thanks!

Samuel

Message received at control <at> debbugs.gnu.org:

Received: (at control) by debbugs.gnu.org; 29 Jan 2025 11:40:34 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jan 29 06:40:34 2025
Received: from localhost ([127.0.0.1]:40148 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1td6Qs-0008S8-As
	for submit <at> debbugs.gnu.org; Wed, 29 Jan 2025 06:40:34 -0500
Received: from mail-wm1-x336.google.com ([2a00:1450:4864:20::336]:53454)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.84_2) (envelope-from <pixelbeat@HIDDEN>)
 id 1td6Qo-0008Rp-Re
 for control <at> debbugs.gnu.org; Wed, 29 Jan 2025 06:40:31 -0500
Received: by mail-wm1-x336.google.com with SMTP id
 5b1f17b1804b1-43624b2d453so74364685e9.2
 for <control <at> debbugs.gnu.org>; Wed, 29 Jan 2025 03:40:30 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=gmail.com; s=20230601; t=1738150824; x=1738755624; darn=debbugs.gnu.org;
 h=content-transfer-encoding:in-reply-to:content-language:references
 :to:from:subject:user-agent:mime-version:date:message-id:sender:from
 :to:cc:subject:date:message-id:reply-to;
 bh=YS4ZwQ/xPvfC8ukB9bg/AklAel4KZZixDIM8fLwtGwI=;
 b=OsY9biCbqz98QoDuBC9Ca0/LtUKF4I3SamAuTdf1OZs1l8Oa50z4wd6n9l3x35UzyL
 zr8ZosD8yQ4UvDi0CdfXgGEbjGpTEf7fiItZ9I3vKen1cU2IvECrwbspJWivVXzFtyfv
 QFzouIxXBpBIc5rGcJUKM093mFpnQKyeS2Tj2StBBXVV07OcPbY7AFQOJnB+2CTG31cN
 CBYr0bCWuW8yv2NAEnrm4vfbbntNEQifc+WjkOmMeNlOZ4JTZz8mBPu0XYTRyZnHkoAL
 GcBSdk9+O9ZDeBPc7/25bukgrxnulmeHnAWtPm/KmRwtBvFRYsBQnlCLXm50f/nayNuq
 jMAQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20230601; t=1738150824; x=1738755624;
 h=content-transfer-encoding:in-reply-to:content-language:references
 :to:from:subject:user-agent:mime-version:date:message-id:sender
 :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to;
 bh=YS4ZwQ/xPvfC8ukB9bg/AklAel4KZZixDIM8fLwtGwI=;
 b=xDmolxAlRjyJHJlCf+W/FfBfT0W8afpQgeDrTc15FcMjPVL7pHMoEgr2hHtq0na6Yp
 ET2I4iR93p9XiWbUVt4ce7pYfZsASB95CwuM2R5eWvgUcbXkLP0vM+ccRY7OLcB5Vbs6
 Q/zsRL9uBYG9F7AmZv14YOtcc6A3GElqLXXFgtTy/fgaFa2qXQNPhfo6/MgaUa4Qyyjj
 IRDTLcUFWonymhWqAvH+eIlVPKO8s88CHLB3+Lif+ynINsQ72SgDIa5z1rAnTB9PplhW
 uDVEMcl+hXHX9zDZEmXKH3345EKziEkG9SLUEhfRPIiMTjZBx3a8mA8uC50LRT4Zalg5
 RL1w==
X-Gm-Message-State: AOJu0YxhlSnzPXMAaeCWqmehP+gLDoBZj+wKcNq4sExSLIuSfqrIlgLb
 36hgdJfusxYyeAoS73FHSU4UPf9xttmK7lWtw2Ir3JxwKDK2tx+mqhCXnw==
X-Gm-Gg: ASbGncuSl3Khu5MjLq3ZQoebBgZwG6PioSNSNCb/GWvYOoXjqz+IwiioD6OYRuZE86K
 TpBaU4+/N84vqKTc5+r3PlxUSUbTXhQlJHD5ZtsgWlq4auZbJU5wlye20erdfrJoHFzfhqMLCFR
 6/AF/Bgkw74hgN3EmcYZJSBIBibUMygpT42oYYVa9EHs9dSaTkNSCMe1Baag/N0PdbA3z50xrbw
 QGCPNWPD7oPzoWXcqheM/vJusP/YWUmE8qSRSWPs5s6tmFS3ynFFOIoJM9OHvupGZrgl3D/3BPP
 qRY8RxdQxKUL2epujC1h+d3blPxdB53vYiH08P7Tsuw28ngJ1WqCum8Xm469YzSEZRG8MfM=
X-Google-Smtp-Source: AGHT+IHOmw5679iCgGjGIbq4eQTG7AQD4d2Zn0nfgPkUsyHHVD0xdtLrBwa+CGntrf78zPxCsWNAwA==
X-Received: by 2002:a05:600c:4fc1:b0:436:1ac2:1acf with SMTP id
 5b1f17b1804b1-438dc40d55emr22824805e9.20.1738150824202; 
 Wed, 29 Jan 2025 03:40:24 -0800 (PST)
Received: from [192.168.1.31]
 (86-44-211-146-dynamic.agg2.lod.rsl-rtd.eircom.net. [86.44.211.146])
 by smtp.googlemail.com with ESMTPSA id
 5b1f17b1804b1-438dcc50655sm19768065e9.33.2025.01.29.03.40.23
 for <control <at> debbugs.gnu.org>
 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);
 Wed, 29 Jan 2025 03:40:23 -0800 (PST)
Message-ID: <bf6a8e0e-3484-4af8-b831-2c3008ebd793@HIDDEN>
Date: Wed, 29 Jan 2025 11:40:22 +0000
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird Beta
Subject: Re: bug#75916: Making ls(1)'s --format clearer
From: =?UTF-8?Q?P=C3=A1draig_Brady?= <P@HIDDEN>
To: GNU bug tracker automated control server <control <at> debbugs.gnu.org>
References: <Z5k3ZR6vggR1l5Wm@begin>
 <15375f78-a8f3-498b-9439-34b202a43412@HIDDEN>
Content-Language: en-US
In-Reply-To: <15375f78-a8f3-498b-9439-34b202a43412@HIDDEN>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: control
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

close 75916
stop

Last modified: Wed, 29 Jan 2025 11:45:01 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.