Debian Bug report logs - #846242
Short options are not documented in man pages

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Ralf Treinen <treinen@irif.fr>

To: submit@bugs.debian.org

Subject: adduser: manpage should document short options

Date: Tue, 29 Nov 2016 15:29:58 +0100

Package: adduser
Version: 3.115
User: treinen@debian.org
Usertags: colis-shparser

Hi,

looking at the source code of adduser reveals that it also accepts some
short options. Please include these in the manpage along with the 
equivalent long options. I noticed these since short options are in
fact used in maintainer scripts, but not document in the adduser manpage.
AFAICS, the short options are:

-q for --quiet
-h for --help
-v for --verbose

-Ralf.
-- 
Ralf Treinen
Institut de Recherche en Informatique Fondamentale
Équipe Preuves, Programmes et Systèmes
Université Paris Diderot, Paris, France.
http://www.irif.fr/~treinen/

Message #12 received at 846242@bugs.debian.org (full text, mbox, reply):

From: Markus Hiereth <post@hiereth.de>

To: Ralf Treinen <treinen@irif.fr>, 846242@bugs.debian.org

Subject: Re: adduser: manpage should document short options

Date: Sun, 3 Sep 2017 15:22:55 +0200

Bonjour Ralf, dear maintainer,

Ralf Treinen schrieb am 29. November 2016 um 15:29

> Package: adduser
> Version: 3.115
> User: treinen@debian.org
> Usertags: colis-shparser
> 
> looking at the source code of adduser reveals that it also accepts some
> short options. Please include these in the manpage along with the 
> equivalent long options. I noticed these since short options are in
> fact used in maintainer scripts, but not document in the adduser manpage.
> AFAICS, the short options are:
> 
> -q for --quiet
> -h for --help
> -v for --verbose

the German translation group noted that text of manual pages
adduser(8) and deluser(8) was not formatted in accordance with
man_pages(7). Mainly arguments printed in capitals instead of italics.

Editing these files gave an opportunity to introduce short
options. According to the output of --help,

  adduser -c file user

should as well work like

  adduser --conf file user

Salut / Best regards
Markus Hiereth

Message #21 received at 846242-close@bugs.debian.org (full text, mbox, reply):

From: Debian FTP Masters <ftpmaster@ftp-master.debian.org>

To: 846242-close@bugs.debian.org

Subject: Bug#846242: fixed in adduser 3.119

Date: Sat, 05 Mar 2022 21:33:52 +0000

Source: adduser
Source-Version: 3.119
Done: Marc Haber <mh+debian-packages@zugschlus.de>

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 846242@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)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Format: 1.8
Date: Thu, 03 Mar 2022 11:36:10 +0100
Source: adduser
Binary: adduser
Architecture: source all
Version: 3.119
Distribution: unstable
Urgency: medium
Maintainer: Debian Adduser Developers <adduser@packages.debian.org>
Changed-By: Marc Haber <mh+debian-packages@zugschlus.de>
Description:
 adduser    - add and remove users and groups
Closes: 473379 503153 558260 559423 573155 630750 846242 974658 1004710
Changes:
 adduser (3.119) unstable; urgency=medium
 .
   [ Jason Franklin ]
   * Remove a spurious warning that a group is empty. (Closes: #473379)
   * Edit the "--gid" and "--ingroup" man page text. (Closes: #503153)
   * Prefer "usermod" when adding a user to a group. (Closes: #558260)
   * Make "delgroup --system" succeed with a nonexistent group.
     (Closes: #559423)
   * Fix an invalid command in the "adduser -h" output (Closes: #573155)
   * Document currently supported short options. (Closes: #846242)
   * Strip trailing dots from man page descriptions. (Closes: #974658)
   * Pass "-r" to "useradd" when creating a system user. (Closes: #1004710)
   * Run "wrap-and-sort"
   * Make the "deluser" script executable in working tree.
   * Remove editor-specific directives.
   * Remove the "COMMON OPTIONS" man page sections.
   * Edit "general options" in each usage message.
 .
   [ Marc Haber ]
   * Fix NAME_REGEX the intended way.
     Thanks to Georgios M. Zarkadas, Daniel Convissor, Henry Lin,
     Laurent Martelli (Closes: 630750)
   * add basic salsa-ci
   * convert ca.po, nb.po, pl.po to utf-8
   * Bump debhelper from old 9 to 13
   * Rules-Requires-Root: binary-targets
   * give pot file headers proper copyright
   * DEP-5 debian/copyright
   * Standards-Version: 4.6.0 (no changes necessary)
   * override update-debian-copyright for files in debian/po.
 .
   [ Debian Janitor ]
   * Trim trailing whitespace.
   * Fix day-of-week for changelog entries: 3.63, 3.13.
   * Wrap long lines in changelog entries: 3.107, 2.10.
   * Fix misspelling of "Close" => "Closes".
 .
   [ Ondřej Nový ]
   * debian/changelog: Remove trailing whitespaces
Checksums-Sha1:
 d6ae0d1126bf0cc0a545bf18aeafe93cd922a69b 1677 adduser_3.119.dsc
 0e0a7915686be52b89737ba1293db36a0625e5cd 214340 adduser_3.119.tar.xz
 21d12273958e0e7279931032dd9e5668f4c2744b 232388 adduser_3.119_all.deb
 916e0bf91600a17371eed178a75f3ba2a148b9b4 6051 adduser_3.119_amd64.buildinfo
Checksums-Sha256:
 39ede3eac15923f92f6dce252c1ee925a4ac66abebe23cfaf36bff8ae57fb2ee 1677 adduser_3.119.dsc
 c7065a030b58895c2927e110a83247b9707914b3d44791889d8199ec8ebc0ae0 214340 adduser_3.119.tar.xz
 10e64cbd67c3da94bf09d0edebe0c2076994503e163fc9bf348eb4cf0b8b167e 232388 adduser_3.119_all.deb
 c6825604f71c480505c11275e3fc6521a867ab2b0bc6639bae36e267b535ced5 6051 adduser_3.119_amd64.buildinfo
Files:
 ebc51d219ebd835d11b8143f4ee490cd 1677 admin important adduser_3.119.dsc
 a84350e3c4660defb47805be3e467fab 214340 admin important adduser_3.119.tar.xz
 bd352895a7403080a5866a0e90069cf6 232388 admin important adduser_3.119_all.deb
 fa64f0dea90bcd19c29c8eaefe34edfd 6051 admin important adduser_3.119_amd64.buildinfo

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

iQIzBAEBCAAdFiEE6QL5UJ/L0pcuNEbjj3cgEwEyBEIFAmIj0owACgkQj3cgEwEy
BEKzQRAAgRvyoCuU4V6nlkBO8cfX+TcSOe7oYipMeqoRpcMLqWlfub8/DavBexgJ
rYO6buRXMHsV//oiRpC/5D5WHkLx7CB3uSfLSrpsIa47igXRSkmkY/VFqC1Ucnnt
3xc1qRTzgVruijyJoxonyANV6VqXaJqjCKpJOfIGj2IgFdamUZSjG1pjDvyo2gjl
8EOgns1AqQZEmUCiAq1okac2wIbaqBlxit5JpO6C3DTUdP6qnSMvhar8mHwvU4T8
jIzKNDijSbzJE8zQwj0mOLgffQF88ZhLlQU1T6Qpc2t1UUWOTbXc//u0EopgPxr9
KtfBiNf2g5A0flDPCCXA7t/146GWmIi89ivEUe7mmXYSjgmg8RdVvMO+vIIlpxoq
aNSJvC5NgLmoEd7+Q2vHuoaQGZktz2t5LnSOrwmjwH/UfPqEqaefHtyBfYNuJTrM
Q/USm+NpADeRY2LWmx4KuR8qwpufRMRHWFWWprjJZDpFN54NMSzlxuuQ8LyzfYNo
eV/DzrOKmEoIIQwKEpe0QFT2V7yu+pjmnCcx5aeY18s/xTWGX88+NW2y/o5qFYKR
j59/Q9NdLLsSQrXsGpVRUJ38NiMPSN0+yAceuQK+W+in2B/WkC9/lPzmChK6OGcq
bQDBiKsdiV6oRTh7WLiLM7HZ8htXN/JyePvaFu8tRTlptBMxqG4=
=UFgz
-----END PGP SIGNATURE-----

Send a report that this bug log contains spam.