#678689 unzip(1): Macros EX/EE defined too early in the manual

Package:
unzip
Source:
unzip
Description:
De-archiver for .zip files
Submitter:
Bjarni Ingi Gislason
Date:
2013-10-14 13:57:14 UTC
Severity:
minor
#678689#5
Date:
2012-06-23 18:55:50 UTC
From:
To:
  From "man ..." ("groff -ww ..."):

<groff: unzip.1>:992: warning: tab character in unquoted macro argument

  Wrong macros "EX/EE" used (in file "an-ext.tmac"), so no
intending is produced.

  Some cosmetic changes, spaces, escape before a option, small
space between dashes, full stop in abbreviations protected with
"\&", "--" between words changed to em-dash (\(em).

####

  General considerations

a) Manuals should usually only be left justified.  Use ".ad l"
as the first regular command.

b) Each sentence should begin on a new line.  The conventions
about the amount of space between sentences are different.  This
also makes a check on the number of space characters between
words easier.

c) Separate numbers from units with a (no-break) space.  A
no-break space can be code 0xA0, "\ " (\<space>), or "\~"
(groff).

d) Use macros "TS/TE" for tables with more than two columns.
Then use

'\" t

as the first line in the source to tell "man" to use the "tbl"
preprocessor.

e) Protect last period (full stop) in abbreviations and ellipsis
with "\&", if it is or might be (through new formatting of
source) at the end of line, if it is also not an end of
sentence.

f) Test the source with "man --warnings=w ... -l <source>" and
the environmental variable "MAN_KEEP_STDERR=y".  Check the
output on the display.

g) Test the source also with "groff -b -ww -mandoc ... > ..."
(default output is a "ps" file) and look at the output with an
appropriate program.

  See also web-article on www.kernel.org/doc/man-pages/

####

  Patch is in the attachment