[pkg-gnupg-maint] Bug#900247: gpg-check-pattern.1: Some formatting changes in the manual

[Bjarni Ingi Gislason]

Package: gpg-agent
Version: 2.2.5-1
Severity: minor
Tags: patch

Dear Maintainer,

   * What led up to the situation?

  Warning from "groff":

<gpg-check-pattern.1>:19 (macro BR): only 1 argument, but more are expected

Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z 

  [ "test-groff" is a developmental version of "groff" ]

###

  Summary of changes:

Use correct font for "options" (denotes variable text)

Split long lines (> 80) (and make only the first word bold)

Change a two-fonts macro to an one-font macro for a singular argument

###

  Details:

Test nr. 16:

Use the correct macro for the font change of one argument.
Split a punctuation mark from the only argument if one is there

19:.BR \-\-check

#####

Test nr. 42:

Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause.

gpg-check-pattern.1: line 12	length 90
.B gpg\-check\-pattern checks a passphrase given on stdin against a specified patternfile.

#####

  Patch:

--- gpg-check-pattern.1	2018-02-22 22:20:18.000000000 +0000
+++ gpg-check-pattern.1.new	2018-05-28 00:57:21.000000000 +0000
@@ -5,18 +5,19 @@ gpg-check-pattern \- Check a passphrase
 
 .SH SYNOPSIS
 .B gpg\-check\-pattern
-.RB [ options ]
+.RI [ options ]
 .I patternfile
 
 .SH DESCRIPTION
-.B gpg\-check\-pattern checks a passphrase given on stdin against a specified patternfile.
+.B gpg\-check\-pattern
+checks a passphrase given on stdin against a specified patternfile.
 
 .SH OPTIONS
 .TP
 .BR \-v ", " \-\-verbose
 Produce verbose output
 .TP
-.BR \-\-check
+.B \-\-check
 run only a syntax check on the patternfile
 .TP
 .BR \-0 ",  " \-\-null


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

Kernel: Linux 4.9.88-1-u1 (SMP w/2 CPU cores)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages gpg-agent depends on:
ii  gpgconf                   2.2.5-1
ii  libassuan0                2.5.1-2
ii  libc6                     2.27-3
ii  libgcrypt20               1.8.2-2
ii  libgpg-error0             1.31-1
ii  libnpth0                  1.5-3
ii  pinentry-gtk2 [pinentry]  1.1.0-1+b1

Versions of packages gpg-agent recommends:
ii  gnupg  2.2.5-1

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

-- no debconf information

-- 
Bjarni I. Gislason