Subject: bug#59262: closed (Re: bug#59262: Dash instead of two hyphens in manual)

From: [email-masked] (GNU bug Tracking System)
Date: Tue, 15 Nov 2022 03:13:02 +0000

Your bug report

#59262: Dash instead of two hyphens in manual

which was filed against the coreutils package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
59262: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=59262
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#59262: Dash instead of two hyphens in manual
From: Paul Eggert <[email-masked]>
To: Antonio Diaz Diaz <[email-masked]>
Cc: [email-masked]
Date: Mon, 14 Nov 2022 19:11:58 -0800
List-Id: <debbugs-submit.debbugs.gnu.org>

Thanks for reporting that. Fixed by installing the attached. This should 
propagate to the web pages after the next release.

From b73888b12caa359c93d05aa7ff7c3a66a74b5f7b Mon Sep 17 00:00:00 2001
From: Paul Eggert <[email-masked]>
Date: Mon, 14 Nov 2022 19:00:06 -0800
Subject: [PATCH 1/2] build: update gnulib submodule to latest

---
 gnulib | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gnulib b/gnulib
index e441260ea..08ba9aaeb 160000
--- a/gnulib
+++ b/gnulib
@@ -1 +1 @@
-Subproject commit e441260eab816e9b6d202fe7ac288ec2a7b72f34
+Subproject commit 08ba9aaebff69a02cbb794c6213314fd09dd5ec5
-- 
2.38.1

From 2fce39eb3a720009edc0e85ddff5b879ac599e16 Mon Sep 17 00:00:00 2001
From: Paul Eggert <[email-masked]>
Date: Mon, 14 Nov 2022 19:08:19 -0800
Subject: [PATCH 2/2] doc: fix markup
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Problem reported by Antonio Diaz Diaz (bug#59262).
* doc/coreutils.texi: Use markup in menus to prevent
‘--’ from turning into an em dash, and to be more
consistent.
---
 doc/coreutils.texi | 56 +++++++++++++++++++++++-----------------------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index d82c86709..ebd096cda 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -379,9 +379,9 @@ Conditions
 
 @command{expr}: Evaluate expression
 
-* String expressions::           + : match substr index length
-* Numeric expressions::          + - * / %
-* Relations for expr::           | & < <= = == != >= >
+* String expressions::           @code{+ : match substr index length}
+* Numeric expressions::          @code{+ - * / %}
+* Relations for expr::           @code{| & < <= = == != >= >}
 * Examples of expr::             Examples of using @command{expr}
 
 Redirection
@@ -486,15 +486,15 @@ File permissions
 Date input formats
 
 * General date syntax::          Common rules
-* Calendar date items::          21 Jul 2020
-* Time of day items::            9:20pm
-* Time zone items::              UTC, -0700, +0900, @dots{}
-* Combined date and time of day items:: 2020-07-21T20:02:00,000000-0400
-* Day of week items::            Monday and others
-* Relative items in date strings:: next tuesday, 2 years ago
-* Pure numbers in date strings:: 20200721, 1440
-* Seconds since the Epoch::      @@1595289600
-* Specifying time zone rules::   TZ="America/New_York", TZ="UTC0"
+* Calendar date items::          @samp{14 Nov 2022}
+* Time of day items::            @samp{9:02pm}
+* Time zone items::              @samp{UTC}, @samp{-0700}, @samp{+0900}, @dots{}
+* Combined date and time of day items:: @samp{2022-11-14T21:02:42,000000-0500}
+* Day of week items::            @samp{Monday} and others
+* Relative items in date strings:: @samp{next tuesday, 2 years ago}
+* Pure numbers in date strings:: @samp{20221114}, @samp{2102}
+* Seconds since the Epoch::      @samp{@@1668477762}
+* Specifying time zone rules::   @samp{TZ="America/New_York"}, @samp{TZ="UTC0"}
 * Authors of parse_datetime::    Bellovin, Eggert, Salz, Berets, et al.
 
 Version sorting order
@@ -793,16 +793,16 @@ name.
 
 @menu
 * Exit status::                 Indicating program success or failure.
-* Backup options::              -b -S, in some programs.
-* Block size::                  BLOCK_SIZE and --block-size, in some programs.
+* Backup options::              @option{-b} @option{-S}, in some programs.
+* Block size::                  BLOCK_SIZE and @option{--block-size}, in some programs.
 * Floating point::              Floating point number representation.
-* Signal specifications::       Specifying signals using the --signal option.
+* Signal specifications::       Specifying signals using @option{--signal}.
 * Disambiguating names and IDs:: chgrp, chown, chroot, id: user and group syntax
-* Random sources::              --random-source, in some programs.
+* Random sources::              @option{--random-source}, in some programs.
 * Target directory::            Specifying a target directory, in some programs.
-* Trailing slashes::            --strip-trailing-slashes, in some programs.
-* Traversing symlinks::         -H, -L, or -P, in some programs.
-* Treating / specially::        --preserve-root and --no-preserve-root.
+* Trailing slashes::            @option{--strip-trailing-slashes}, in some programs.
+* Traversing symlinks::         @option{-H}, @option{-L}, or @option{-P}, in some programs.
+* Treating / specially::        @option{--preserve-root} and @option{--no-preserve-root}.
 * Special built-in utilities::  @command{break}, @command{:}, @dots{}
 * Standards conformance::       Conformance to the POSIX standard.
 * Multi-call invocation::       Multi-call program invocation.
@@ -13428,12 +13428,12 @@ Exit status:
 @end display
 
 @menu
-* File type tests::             -[bcdfhLpSt]
-* Access permission tests::     -[gkruwxOG]
-* File characteristic tests::   -e -s -nt -ot -ef
-* String tests::                -z -n = == !=
-* Numeric tests::               -eq -ne -lt -le -gt -ge
-* Connectives for test::        ! -a -o
+* File type tests::             @code{-[bcdfhLpSt]}
+* Access permission tests::     @code{-[gkruwxOG]}
+* File characteristic tests::   @code{-e -s -nt -ot -ef}
+* String tests::                @code{-z -n = == !=}
+* Numeric tests::               @code{-eq -ne -lt -le -gt -ge}
+* Connectives for test::        @code{! -a -o}
 @end menu

@@ -13801,9 +13801,9 @@ Exit status:
 @end display
 
 @menu
-* String expressions::          + : match substr index length
-* Numeric expressions::         + - * / %
-* Relations for expr::          | & < <= = == != >= >
+* String expressions::          @code{+ : match substr index length}
+* Numeric expressions::         @code{+ - * / %}
+* Relations for expr::          @code{| & < <= = == != >= >}
 * Examples of expr::            Examples.
 @end menu
 
-- 
2.38.1

Subject: Dash instead of two hyphens in manual
From: Antonio Diaz Diaz <[email-masked]>
To: [email-masked]
Cc: Antonio Diaz Diaz <[email-masked]>
Date: Mon, 14 Nov 2022 19:23:23 +0100
List-Id: <debbugs-submit.debbugs.gnu.org>

Hello.

I have found a minor bug in the manual.

In the entry descriptions of the menu at the bottom of 'Common options'[1] 
there are 6 long option names preceded by a dash instead of two hyphens 
('â@Sblock-size' instead of '--block-size', etc).

Maybe those option names should be inserted in an @option or @code command?

[1] http://www.gnu.org/software/coreutils/manual/html_node/Common-options.html

Thanks,
Antonio.