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

Bug#1095789: marked as done (locale.gen.5: Some remarks and a patch with editorial changes for this man page)

Your message dated Sat, 15 Feb 2025 10:35:46 +0000
with message-id <E1tjFWU-006BBF-OH@fasolo.debian.org>
and subject line Bug#1095789: fixed in glibc 2.40-7
has caused the Debian Bug report #1095789,
regarding locale.gen.5: Some remarks and a patch with 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.)


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

   * What led up to the situation?

     Checking for defects with a new version

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

  [Use "groff -e ' $' -e '\\~$' <file>" to find obvious 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:<stdin>:28: warning: trailing space in the line
troff:<stdin>:30: 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.12.12-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.89
ii  libc-bin               2.40-6
ii  libc-l10n              2.40-6

locales recommends no packages.

locales suggests no packages.

-- debconf information excluded

Input file is locale.gen.5

Output from "mandoc -T lint  locale.gen.5": (shortened list)

      2 whitespace at end of input line

-.-.

Output from "test-groff -mandoc -t -ww -z locale.gen.5": (shortened list)

      2 trailing space in the line

-.-.

Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".

Number of lines affected is

2

-.-.

FSF office address update.  See
https://lists.gnu.org/archive/html/bug-gnulib/2024-09/msg00004.html

16:.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

-.-.

Section headings (.SH and .SS) do not need quoting.

18:.SH "NAME"
20:.SH "DESCRIPTION"
38:.SH "SEE ALSO"
40:.SH "AUTHOR"

-.-.

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

troff:<stdin>:28: warning: trailing space in the line
troff:<stdin>:30: warning: trailing space in the line

--- locale.gen.5	2025-02-12 02:15:05.571480220 +0000
+++ locale.gen.5.new	2025-02-12 02:20:30.521788206 +0000
@@ -15,9 +15,9 @@
 .\" along with this program; if not, write to the Free Software Foundation,
 .\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 .TH locale.gen 5 "July 2005" "Debian GNU/Linux"
-.SH "NAME"
+.SH NAME
 locale.gen \- Configuration file for locale-gen
-.SH "DESCRIPTION"
+.SH DESCRIPTION
 The file \fI/etc/locale.gen\fP lists the locales that are to be generated
 by the \fBlocale-gen\fP command.
 
@@ -25,9 +25,9 @@ Each line is of the form:
 
 <locale> <charset>
 
-where <locale> is one of the locales given in 
+where <locale> is one of the locales given in
 .B /usr/share/i18n/locales
-and <charset> is one of the character sets listed in 
+and <charset> is one of the character sets listed in
 .B /usr/share/i18n/charmaps
 
 The
@@ -35,7 +35,7 @@ The
 command will generate all the locales, placing them in
 \fB/usr/lib/locale\fP.
 
-.SH "SEE ALSO"
+.SH SEE ALSO
 \fBlocale-gen\fP(8), \fBlocaledef\fP(1), \fBlocale\fP(1)
-.SH "AUTHOR"
+.SH AUTHOR
 Alastair McKinstry <mckinstry@computer.org>

  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

-.-

  Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.

  It should also check its input files for too long (> 80) lines.

  This is just a simple quality control measure.

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

  Common defects:

  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.
Line length should thus be reduced.

  The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.

  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 -d -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 from 'diff -d -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)

-.-

--- End Message ---
--- Begin Message --- 
Source: glibc
Source-Version: 2.40-7
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 1095789@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: Sat, 15 Feb 2025 11:20:09 +0100
Source: glibc
Architecture: source
Version: 2.40-7
Distribution: unstable
Urgency: medium
Maintainer: GNU Libc Maintainers <debian-glibc@lists.debian.org>
Changed-By: Aurelien Jarno <aurel32@debian.org>
Closes: 1094154 1095789
Changes:
 glibc (2.40-7) unstable; urgency=medium
 .
   [ Samuel Thibault ]
   * debian/libc0.3.symbols.hurd-*: Prepare removal of experimental
     exec_exec_file_name and file_exec_file_name.
   * debian/patches/hurd-i386/local-exec_filename.diff: Drop old experimental
     patch.
   * debian/patches/hurd-i386/git-mig-strncpy.diff: ensure destination string is
     null terminated.
 .
   [ Aurelien Jarno ]
   * debian/libc0.1.symbols.common: remove leftover from kfreebsd removal.
   * debhelper.in/locales.NEWS: remove asterisks list to make lintian happier.
   * debian/copyright: fix issues reported by lintian.
   * debian/tests/rebuild: rename into upstream-testsuite and only run the
     build-arch-post-check target instead of the full build.
   * debian/tests/control.in: update accordingly and drop fakeroot from the
     depends.
   * debian/rules.d/build.mk: display the failures again in the
     build-arch-post-check target, useful for debci which drop the middle of
     the autopkgtest log.
 .
   [ Frans Spiesschaert ]
   * Update Dutch debconf translation.  Closes: #1094154.
 .
   [ Bjarni Ingi Gislason ]
   * debian/local/manpages/locale.gen.5: editorial fixes.  Closes: #1095789.
Checksums-Sha1:
 0740ef5b8b2d7e682f313521e8f7999f5236274f 7540 glibc_2.40-7.dsc
 053f25d61f9600c5cbc81fb3a9163181c37e480e 458080 glibc_2.40-7.debian.tar.xz
 58648499c8948cb19ef13ab80b65fa9d6d36b531 10741 glibc_2.40-7_source.buildinfo
Checksums-Sha256:
 2d0784faa6df105ecfad72d02c3c29473aeb925736995562aea3f24346c44719 7540 glibc_2.40-7.dsc
 2ba19a5313db27f43d50c7af511049de4077c66bdb681e792237a77fbd49d4b0 458080 glibc_2.40-7.debian.tar.xz
 64dbaefe5e1a36e1cc572fff8f34454c374c05b42746a4b3d9d735de327f1abe 10741 glibc_2.40-7_source.buildinfo
Files:
 5467efc15316b6d9db30b2d74e5497cb 7540 libs required glibc_2.40-7.dsc
 cc9957b130feeefdce52232b3e073efa 458080 libs required glibc_2.40-7.debian.tar.xz
 c3db7ed4a7bace432f30f610962a1adc 10741 libs required glibc_2.40-7_source.buildinfo

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

iQIzBAEBCgAdFiEEUryGlb40+QrX1Ay4E4jA+JnoM2sFAmewa3oACgkQE4jA+Jno
M2u6Pg/7ByREoKq/1xa3cAoMaRL4aGFZtxCrcr4JIf1/Zolkt32g/Nj5ukbZBI8N
2ItzpS/trOVC+gSvRFArN8WOb/0c4rJYvi8ZnF8I8AgP1UJWHah+YL7TBk6rbaVc
0K+aLU+TQIB6vNkhZLgVQ+xrFgggP2bOPIsHlzZhYGsWW5nDDyDnVgBO62vLFPfI
gv3rGl19zipXyDmeiUNYuF7rITkcvisELJ4XRNwlMqFMfxUI5g/r+l8xOA8GnKEJ
pCtUbM2Zx+yekkLBeC+upwYmVop3AdOdimdSjl7sq5WCXLlRbWdppKaIHbWbqYcL
e3Ac2rr+gMxerZiPFpDIlDUEgPLAo4VAy8XFVHAS0tQYq0uZ8KDAKCvWdQI3cLaE
ET7TzA81HndVyk9zflJW1+QXaiFJq8c58TQ4G4/a3SWgGH0NgaFowawFjv0cdi9r
6GNqaaprPrqZ+mAfGi57lwgkCVdE/P2HErMO1C6bIa8azND09ajkd+K32cVEQroZ
oqkAKB8CDIkMYzol/zhuQar5Gu1jGkxs7I0Bv+HZ6kLBkuD0/00TiaQniRBA4lN1
WyhNALgFA2Cbii4Bw0ZIPjLaq3Ub7QiKu8YjiX1dPlSlyeM9HLv6V/HdkloD8cbz
QdVChNVmaI0pjkv+0O4eaYbi/N5RdVpfikdl/qwKvlCBGW9m8t8=
=0Hy8
-----END PGP SIGNATURE-----

Attachment: pgp2vBkZG0Goz.pgp
Description: PGP signature


--- End Message ---
Reply to: