[pkg-gnupg-maint] Bug#987647: gpg-agent(1) man page word-wrapping issue

[Vincent Lefevre]

Package: gpg-agent
Version: 2.2.27-2
Severity: minor

The gpg-agent(1) man page has a word-wrapping issue: in the FILES
section, from the "gpg-agent.conf" text up to, but not including,
the last paragraph ("Note that on larger installations..."), the
text is not formatted correctly, at least with a 80-column
terminal or narrower.

Here's what I obtain with a 68-column terminal (I've reduced it
to 68 for the purpose of the bug report):

       gpg-agent.conf
                This  is  the  standard configuration file read by
              gpg-agent on
                startup.  It may contain any  valid  long  option;
              the leading
                two  dashes  may not be entered and the option may
              not be abbreviated.
                This file is also read after a SIGHUP however only
              a few
                options  will  actually  have an effect.  This de‐
              fault name may be
                changed on the command line  (see:  [option  --op‐
              tions]).
                You should backup this file.

I suppose that the cause is the two spaces at the beginning of
each line in the troff file (this doesn't occur before):

.B  gpg-agent.conf
  This is the standard configuration file read by \fBgpg-agent\fR on
  startup.  It may contain any valid long option; the leading
  two dashes may not be entered and the option may not be abbreviated.
  This file is also read after a \fBSIGHUP\fR however only a few
  options will actually have an effect.  This default name may be
  changed on the command line (see: [option --options]).
  You should backup this file.

And concerning the "Before entering a key into this file..." paragraph,
it remains formatted as in the troff file, without word-wraps for this
narrow terminal. For this issue, I don't have an idea of the cause
(perhaps some style that has not been reset?).

-- System Information:
Debian Release: 11.0
  APT prefers unstable-debug
  APT policy: (500, 'unstable-debug'), (500, 'testing-security'), (500, 'stable-updates'), (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 5.10.0-6-amd64 (SMP w/8 CPU threads)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=POSIX, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages gpg-agent depends on:
ii  gpgconf                     2.2.27-2
ii  init-system-helpers         1.60
ii  libassuan0                  2.5.4-1
ii  libc6                       2.31-11
ii  libgcrypt20                 1.8.7-3
ii  libgpg-error0               1.38-2
ii  libnpth0                    1.6-3
ii  pinentry-curses [pinentry]  1.1.0-4
ii  pinentry-gtk2 [pinentry]    1.1.0-4

Versions of packages gpg-agent recommends:
ii  gnupg  2.2.27-2

Versions of packages gpg-agent suggests:
ii  dbus-user-session  1.12.20-2
ii  libpam-systemd     247.3-5
pn  pinentry-gnome3    <none>
pn  scdaemon           <none>

-- no debconf information

-- 
Vincent Lefèvre <vincent at vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / AriC project (LIP, ENS-Lyon)