Dear Maintainer,

following the correction of a bug in the german manual pages to
adduser and deluser
(https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=685529), the german
translation team noted that the formatting of the four manual pages is
not in accordance with the guidelines man-pages(7).

Together with this bugreport, four groff files with correct formatting
of options, arguments, files-names etc. are passed to your team.

To make it easier to find out what has been changed, You will find as
well commented diff-files. The changes are summarized below.

To illustrate the results, the manual pages emerging from the source
code files are attached as well as pdf files.

In principle, I am ready to continue this piece of work by making the
subsequent changes in the related german po file.

Best regards
Markus Hiereth
---------------------------------------------------------------------

1. Information related to all manual page files

1.a) Changes

First line in groff source code that tells emacs that this is a groff
source file has been erased
(.\" Hey, Emacs!  This is an -*- nroff -*- source file.)

The input for the title macro .TH did not conform with man-pages(7)
which asks for " .TH title section date source manual".
Input was changed.

In the input for the title macro .TH a variable VERSION appears.
Maybe there is a script that replaces this by the actual value.
In the files sent, the version number 3.116 appears


1.b) For your interest

In groff source file, now all phrases begin in a new line according
to man-pages(7).

Consider usage of the macros .SY, .OP and .YS in section "Synopsis"
as presented in groff_man(7)

Check whether it is necessary to use the groff code for the character
minus (dash preceeded by a backslash, i.e. \-) within options that
consist of more than one word:
  \-\-remove\-home   versus   \-\-remove-home

There is no Section "Copyright" listed in man-pages(7)
Consider putting these information only as comment in the groff source file



2. Information related to adduser manual page
see attached adduser_3.8, adduser.8_c.diff

2.a) Changes

As suggested in bug report #846242, short options according
to output of --help have been added

"GIDS" has been replaced by "GIDs" as this is the plural of GID


2.b) for your interest

Consider using either "gecos" or "GECOS" troughout the document.



3. Information related to the deluser manual page
see attached deluser_3.8, deluser.8c.diff

3.a) Changes

Short options introduced according to bug report #846242

The notation for backup file names in the section "Options"
(with slashes and $-sign was strange and/or wrong and
differed from the one used in section "Description" and in
deluser.conf(5). Therefore, notation was unified.

The obligatory argument to the option --backup-to was missing and has
been introduced in the text. In section "Description" it was stated
that, by default, the backup file will appear in the current directory,
which is in contradiction to "/" in the explanation of option
--backup-to.


3.b) For your interest

Slight changes in the explanation of the options --remove-home and
--remove-all-files

Formatting with sequences \fI...\fR inside a .BR macro has been done
as three font styles are needed sometimes

The option --force does not appear the section "Options". Consider to
introduce it in the list of options.

Has 'perl modules' in section "Return values" to be replaced with
'perl' according to a changelog entry for Version 3.116?


4. Information related to adduser.conf manual page
see attached adduser.conf_3.5, adduser.conf.5_c.diff

I see no reason for square brackets to appear in the path of home
directories in case GROUPHOMES = true. They have been erased.


5. Information related to deluser.conf manual page
see attached deluser.conf_3.5, deluser.conf.5_c.diff

Explanation to NAME_REGEX has been made shorter and more simple


Best regards
Markus Hiereth

---------------------------------------------------------------------------

Hello,

Bug #874560 in adduser reported by you has been fixed in the
Git repository and is awaiting an upload. You can see the commit
message below and you can check the diff of the fix at:

https://salsa.debian.org/debian/adduser/-/commit/3cd1fccab8830a81c1afae2e46527cdd07546b1e
------------------------------------------------------------------------
Formatting changes to manual pages.

Thanks: Markus Hiereth
Closes: #874560
------------------------------------------------------------------------

(this message was generated automatically)
-- 
Greetings

https://bugs.debian.org/874560

We believe that the bug you reported is fixed in the latest version of
adduser, 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 874560@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Marc Haber <mh+debian-packages@zugschlus.de> (supplier of updated adduser 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)
Format: 1.8
Date: Wed, 13 Jul 2022 20:30:00 +0200
Source: adduser
Architecture: source
Version: 3.122
Distribution: unstable
Urgency: low
Maintainer: Debian Adduser Developers <adduser@packages.debian.org>
Changed-By: Marc Haber <mh+debian-packages@zugschlus.de>
Closes: 202943 239825 398793 432562 520037 521883 588872 643559 664869 675804 679746 685532 701110 723572 774046 849265 874560 891748 896916 908997 920739 923059 925511 926262 969217 977678 979385 983405 992163 1001863 1006897 1006941 1006975 1007785 1008081 1008091 1014395 1014448
Changes:
 adduser (3.122) unstable; urgency=low
 .
   [ Marc Haber ]
   * improve package description.
   * Standards-Version: 4.6.1 (no changes necessary)
   * clean out EXTRA_GROUPS to only contain users.
     Thanks to Daniel Keast. (Closes: #849265)
   * add SECURITY section to manual pages.
   * add test for backups of home directory.
   * improve and update lintian overrides.
   * Formatting changes to manual pages.
     Thanks to Markus Hiereth. (Closes: #874560)
   * fix some typos in manual pages.
   * set VERBOSE and DEBUG envvars in deluser as well. (Closes: #1006897)
   * add documentation about adduser being a policy layer. (Closes: #1007785)
   * try to clarify system account terminology (policy vs system).
     (Closes: #1006975)
   * Document that only adduser --system is idempotent. (Closes: #723572)
   * error out for two-argument addgroup.
     Thanks to Mike Dornberger. (Closes: #664869)
   * make --add_extra_groups into --add-extra-groups. (Closes: #1014395)
   * --force-badname is now --allow-badname. (Closes: #1014448)
   * update turkish debconf translation.
     Thanks to Atila KOÇ. (Closes: #908997)
   * Update Russian debconf translation.
     Thanks to Lev Lamberov. (Closes: #920739)
   * Update Danish debconf translation (Closes: #923059)
   * Update Italian debconf translation.
     Thanks to Luca Monducci. (Closes: #969217)
   * Update German man page translation.
     Thanks to Helge Kreutzmann. (Closes: #977678)
   * Update European Portuguese translation of man page.
     Thanks to Américo Monteiro. (Closes: #925511)
   * disable translated manpages, none left for the time being.
   * deprecate planned directory service support.
   * Add docs about adduser.local being the place to interact with DS,
   * Some improvements to autopkgtests.
 .
   [ Matt Barry ]
   * System account home dir defaults to /nonexistent. (Closes: #679746)
   * do not accept all-numeric user names. (Closes: #891748)
   * prompts need y/n/empty(default).
   * Implement SYS_DIR_MODE. (Closes: #1008081, #202943, #398793)
   * Implement SYS_NAME_REGEX. (Closes: #521883, #432562)
   * Deprecate SETGID_HOME.
     Add NEWS/TODO items. (Closes: #643559, #979385, #1008091, #643559)
   * Fix ignored files for --remove-all-files.
     (Closes: #1001863, #588872, #926262, #992163)
   * Redefines the default NO_DEL_PATHS to avoid unnecessary
     scanning.
   * Change deluser_files test to use gzip.
   * Fix deletion of sockets/pipes. (Closes: #685532)
   * Simplify checkname sub.  (Closes: #1006941)
   * Adds support for lock files. (Closes: #983405)
   * Username validity testing framework.
   * Add --allow-all-names to bypass --force-badname.
     (Closes: #520037, #774046)
   * use warnf instead of printf in some places. (Closes: #675804)
   * Support tar --auto-compress for backups. (Closes: #896916)
   * Many improvements to autopkgtests. (Closes: 239825)
 .
   [ Jason Franklin ]
   * Allow for cloned-UID users in group member lists.
     Thanks to Daniel Heimann. (Closes: #701110)
Checksums-Sha1:
 5cbcec9f80e5c73198307edb7040c5c12bb35d3f 1683 adduser_3.122.dsc
 ccf7c4e3efec29257e3b484bb53c2a55d69e0455 230224 adduser_3.122.tar.xz
 27c0ec7f2d7048ddfd7f89dc33012bef7a8e5866 5697 adduser_3.122_source.buildinfo
Checksums-Sha256:
 584ed616d8ac705daffc96564ef45fb34f2eb9663f7348013adea0e4539a869c 1683 adduser_3.122.dsc
 5f093054c0f0c90c313d704f7af6d338f334df793942fafd43e5a8e6c63236c4 230224 adduser_3.122.tar.xz
 7f92d3de2b5ea8da31088424a2043831dedc8aab8f60158e37455cb3a350d63e 5697 adduser_3.122_source.buildinfo
Files:
 0c7d4c5bcd648b829bcaa58101fecbb7 1683 admin important adduser_3.122.dsc
 1da1b75966877f902c4b6d0d5f105609 230224 admin important adduser_3.122.tar.xz
 ab9602ba5d83a6de88ab29bb2e76d961 5697 admin important adduser_3.122_source.buildinfo
-----BEGIN PGP SIGNATURE-----

iQIzBAEBCAAdFiEE6QL5UJ/L0pcuNEbjj3cgEwEyBEIFAmLPEWMACgkQj3cgEwEy
BELCfhAAujNsWZNpvvi2vpDICGMPprz7MooXq5B4fe6fR6nR5Pizh+0E9Skh7NVl
Z5qJvIzcNcva+/TYkml0wO77H1fPefQ+sgxCHmtUTBwK9LZPdh0b6MrWK7hWnhk0
QI/mRMKoNUrMSpVz6suvetUrHvVymWBv/hsQHTt5uSOAB/Wqwbfdt0VFYgQ2i+Yd
Vtr1+U4yjPZ+j9kAFg7HYnVc2Jh8J07ipRrSRnC07AB3wvwcunUiv2fOzJi4S51S
9n/LllsXNS4629siVKDspKOtaak3dpXRPLHFgB+hPlZRhdCCKWoto9TrY1e3XY8N
zZRSYVULaH9OkuIFx6yoUuChhDmteyZ+C0TJlv+qaigf34/qaqF15pu4ee5ZlmuT
SYHI2vcYQ0yXJ92U2U56hYvlzFZufyopWUQkALKwGEzq13LMlMtTJhKypl2PnwzF
jL/n0r0P92kSUd0BAFuzsdp3PPkQoTG9hSTf5BQAXN9JR1dYkIjc95si8KKZ+FD+
Gda+o46EUo3tLgAYGxStxoPsgNb8n2mePrFB5cXERL84uimeVNMg4Hnmt8+cqnYw
jbdDxODIBNsgoCYEqqTe2NOyBQv5gPb0PXYekiHNFRH70sTJDPIjQkrnrYQX73xZ
W5ap2XFEMpqGrFa8VyUwRl15/MAg5Ds0bRi7GzlGPKIKKK8PFFI=
=6vgg
-----END PGP SIGNATURE-----