[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1088003: marked as done (update-locale.8: Some remarks and editorial changes for this man page)

Your message dated Fri, 03 Jan 2025 11:21:55 +0000
with message-id <E1tTfkZ-003D19-OB@fasolo.debian.org>
and subject line Bug#1088003: fixed in glibc 2.40-5
has caused the Debian Bug report #1088003,
regarding update-locale.8: Some remarks and editorial changes for this man page
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
1088003: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1088003
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: locales
Version: 2.40-3
Severity: minor
Tags: patch

   * What led up to the situation?

     Checking for defects with

test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -ww -b -z < "man page"

  [Use "groff -e ' $' <file>" to find trailing spaces.]

  ["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).

  [The fate of "test-nroff" was decided in groff bug #55941.]

   * What was the outcome of this action?

troff: backtrace: file '<stdin>':7
troff:<stdin>:7: warning: trailing space in the line

   * What outcome did you expect instead?

     No output (no warnings).

-.-

  General remarks and further material, if a diff-file exist, are in the
attachments.


-- System Information:
Debian Release: trixie/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 6.11.7-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages locales depends on:
ii  debconf [debconf-2.0]  1.5.87
ii  libc-bin               2.40-3
ii  libc-l10n              2.40-3

locales recommends no packages.

locales suggests no packages.

-- debconf information excluded

Input file is update-locale.8

  Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)

[gn]roff -mandoc -t -ww -b -z -K utf8  <man page>

  The same goes for man pages that are used as an input.

  For a style guide use

  mandoc -T lint

-.-

  So any 'generator' should check its products with the above mentioned
'groff', 'mandoc',  and additionally with 'nroff ...'.

  This is just a simple quality control measure.

  The 'generator' may have to be corrected to get a better man page,
the source file may, and any additional file may.

  Common defects:

  Input text line longer than 80 bytes.

  Not removing trailing spaces (in in- and output).
  The reason for these trailing spaces should be found and eliminated.

  Not beginning each input sentence on a new line.
Lines should thus be shorter.

  See man-pages(7), item 'semantic newline'.

-.-

The difference between the formatted output of the original and patched file
can be seen with:

  nroff -mandoc <file1> > <out1>
  nroff -mandoc <file2> > <out2>
  diff -u <out1> <out2>

and for groff, using

"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - "

instead of 'nroff -mandoc'

  Add the option '-t', if the file contains a table.

  Read the output of 'diff -u' with 'less -R' or similar.

-.-.

  If 'man' (man-db) is used to check the manual for warnings,
the following must be set:

  The option "-warnings=w"

  The environmental variable:

export MAN_KEEP_STDERR=yes (or any non-empty value)

  or

  (produce only warnings):

export MANROFFOPT="-ww -b -z"

export MAN_KEEP_STDERR=yes (or any non-empty value)


-.-.

Output from "mandoc -T lint  update-locale.8 ": (shortened list)

      5 skipping paragraph macro
      7 whitespace at end of input line

-.-.

Output from "test-groff -mandoc -t -ww -b -z update-locale.8 ": (shortened list)

      1 trailing space in the line

-.-.

Output from "mandoc -T lint  update-locale.8 ":

mandoc: update-locale.8:3:2: WARNING: skipping paragraph macro: PP after SH
mandoc: update-locale.8:3:4: STYLE: whitespace at end of input line
mandoc: update-locale.8:6:2: WARNING: skipping paragraph macro: PP after SH
mandoc: update-locale.8:6:4: STYLE: whitespace at end of input line
mandoc: update-locale.8:7:14: STYLE: whitespace at end of input line
mandoc: update-locale.8:12:2: WARNING: skipping paragraph macro: PP after SH
mandoc: update-locale.8:12:4: STYLE: whitespace at end of input line
mandoc: update-locale.8:41:4: STYLE: whitespace at end of input line
mandoc: update-locale.8:45:2: WARNING: skipping paragraph macro: PP after SH
mandoc: update-locale.8:45:4: STYLE: whitespace at end of input line
mandoc: update-locale.8:48:2: WARNING: skipping paragraph macro: PP after SH
mandoc: update-locale.8:48:4: STYLE: whitespace at end of input line
-.-.

-.-.

Remove space characters at the end of lines.

Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".

3:.LP 
6:.LP 
7:update-locale 
12:.LP 
41:.TP 
45:.LP 
48:.LP 

-.-.

Two or more space charaters between printable characters

28:Define file containing locale variables.  (Default:

-.-.

Output from "test-groff  -mandoc -t -K utf8 -rF0 -rHY=0 -ww -b -z ":

troff: backtrace: file '<stdin>':7
troff:<stdin>:7: warning: trailing space in the line


--- update-locale.8	2024-11-21 18:45:18.015767786 +0000
+++ update-locale.8.new	2024-11-21 18:56:09.338676475 +0000
@@ -1,15 +1,15 @@
 .TH UPDATE-LOCALE 8 "April 2006" "Debian GNU/Linux"
 .SH "NAME"
-.LP 
+.
 update-locale \- Modify global locale settings
 .SH "SYNTAX"
-.LP 
-update-locale 
+.
+update-locale
 .RI [ OPTIONS ]
 [\fIvar\fP=\fIlocale\fP | \fIvar\fP]
 [...]
 .SH "DESCRIPTION"
-.LP 
+.
 This program can be called by maintainer scripts when Debian packages are
 installed or removed, it updates the \fI/etc/locale.conf\fP file to
 reflect changes in system configuration related to global locale settings.
@@ -25,7 +25,8 @@ Display an help message and exit.
 Variables which are not set on command-line are cleared out.
 .TP
 .BI \-\-locale\-file " FILE"
-Define file containing locale variables.  (Default:
+Define file containing locale variables.
+(Default:
 .IR /etc/locale.conf )
 .TP
 .B \-\-no\-checks
@@ -38,12 +39,12 @@ The command
 .ft R
 sets \fBLANG\fP to \fBen_CA.UTF-8\fP and removes definitions for \fBLANGUAGE\fP.
 .SH "FILES"
-.TP 
+.TP
 .I /etc/locale.conf
 File where global locale settings are stored.
 .SH "AUTHOR"
-.LP 
+.
 Denis Barbier <barbier@linuxfr.org>
 .SH "SEE ALSO"
-.LP 
+.
 \fBlocale\-gen\fP(8), \fBlocale\fP(1)

--- End Message ---
--- Begin Message --- 
Source: glibc
Source-Version: 2.40-5
Done: Aurelien Jarno <aurel32@debian.org>

We believe that the bug you reported is fixed in the latest version of
glibc, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 1088003@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Aurelien Jarno <aurel32@debian.org> (supplier of updated glibc package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Format: 1.8
Date: Fri, 03 Jan 2025 11:56:38 +0100
Source: glibc
Architecture: source
Version: 2.40-5
Distribution: unstable
Urgency: medium
Maintainer: GNU Libc Maintainers <debian-glibc@lists.debian.org>
Changed-By: Aurelien Jarno <aurel32@debian.org>
Closes: 1087670 1088003 1088166 1088964 1091473 1091705
Changes:
 glibc (2.40-5) unstable; urgency=medium
 .
   [ Samuel Thibault ]
   * debian/patches/hurd-i386/git-MAP_NORESERVE.diff: Add MAP_NORESERVE flag.
   * debian/patches/hurd-i386/git-signal-reply-port.diff: Fix hurd build
     against gcc 14.
 .
   [ Bjarni Ingi Gislason ]
   * debian/local/manpages/update-locale.8: fix issues reported by troff.
     Closes: #1088003.
 .
   [ Aurelien Jarno ]
   * debian/patches/any/git-iconv-do-not-report-*.patch: backport iconv return
     code with transliteration fix from upstream.  Closes: #1087670.
   * debian/debhelper.in/locales.templates: add a note to clarify that the C,
     C.UTF-8 and POSIX locales do not need to be generated.  Closes: #1091473.
   * debian/patches/git-updates.diff: update from upstream stable branch.
   * patches/any/git-posix-fix-system-when-a-child-cannot-be-created-BZ-3.patch:
     backport patch from upstream to fix return value of system() when a child
     process cannot be created.  Closes: #1088964.
   * debian/rules.d/debhelper.mk: explicitly pass the library path to
     dh_shlibdeps for multilib packages, to fix a FTBFS with rebootstrap which
     does not install the g++-XX-multilib build-dependency.  Closes: #1088166.
 .
   [ Carles Pina i Estany ]
   * Update Catalan debconf translation.  Closes: #1091705.
Checksums-Sha1:
 2e59a6bd088306fda97a4dc2430fe4e36517b54f 7550 glibc_2.40-5.dsc
 fe2c602b78f0bb88f3fd05f5f9ec061264491c5f 453708 glibc_2.40-5.debian.tar.xz
 fc175cddd87ff54ff439dff23e2e195facfd590a 11182 glibc_2.40-5_source.buildinfo
Checksums-Sha256:
 721e79c087b0b907e7e098a6b84d654891012a7aa2b7626bf73d2485d6976f49 7550 glibc_2.40-5.dsc
 05aa4df25ff502a1d8ab4902f800805daa3b86c986627b0fd6d44b5409878862 453708 glibc_2.40-5.debian.tar.xz
 fc54149d984c8c9461b80e7c112f8d6a8881c443a5350b3f395996a26e1eeb6b 11182 glibc_2.40-5_source.buildinfo
Files:
 fa5650ca4562760ee82bce10cd105510 7550 libs required glibc_2.40-5.dsc
 cc64bb13bfa93c6cbcd640a12408ada5 453708 libs required glibc_2.40-5.debian.tar.xz
 a4cb2f0d9e5c6aadcadd20ac69f2e08e 11182 libs required glibc_2.40-5_source.buildinfo

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEEUryGlb40+QrX1Ay4E4jA+JnoM2sFAmd3wtcACgkQE4jA+Jno
M2ur7w/9Fsk8q/hSNIHtl+x7tCxDhvBHaQE6iupbFsu/Uq21o3j/CCqduGD/lANF
ZuAwpa24Lfy14Xv4NykLR6BH/yBFqPfb6yHffV2YnfY9YxYzoXPOWWK+/GNGiRWu
H/QQ8uPGVed0xfdA5BEsDT/LDyfWzLj7hCq5S7qTZAfAZITtA0DMBO517xBaMqWW
HKV3GKy5wQ/Amowpt4K/tMKSUvH8COuVd70B4HlEAzTkh847UijP9IzhyeRZ4KHI
wJRUMpEt3VlNtrsWgbW+qlQpphxSNLi2XXht8lLlpVd7cB56sJ39dWP1+zAJCHwc
Pf6/pdJqTYSwUSqnJKrT6fcoEr/v1H2p0nqFsRzD7XZYksRVX52qyaU8VG3Lqt6e
e6HHY2DpiNjfOoJMiGZlcKqU8xKm0Matt8G+LQw8wIYMHBkiCG3cTqghN2AKFzE1
Puq4JMLJzkHKzMn5A3wFabkbH0y1G0zqu2NmycDBExLl0hS1gftv51Jei5FggmYI
KczHQQfNrOU5AP6DdClPx6b3XhvKxBJhh7wojL/29xXw7Cd+P4F8OI5siT/p47QV
vEoTisX38TRqPtSNUB77OBb1QmBzBH/Ovo8ym/JZEA81IhxeQBUAGciJhwTohRz4
4x+pIoUYMGYA9VZ0m/HCtNHgIkr5S0cQw26tIpnkvfqzoZg/Mok=
=AQ0b
-----END PGP SIGNATURE-----

Attachment: pgpmie4Ozm3L5.pgp
Description: PGP signature


--- End Message ---
Reply to: