Package: unzip
Version: 6.0-4
Severity: minor
Tags: patch

  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

-- System Information:
Debian Release: 6.0.5
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 
'stable')
Architecture: i386 (i586)

Kernel: Linux 2.6.32-45
Locale: LANG=is_IS, LC_CTYPE=is_IS (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash

Versions of packages unzip depends on:
ii  libbz2-1.0              1.0.5-6+squeeze1 high-quality block-sorting file co
ii  libc6                   2.11.3-3         Embedded GNU C Library: Shared lib

unzip recommends no packages.

Versions of packages unzip suggests:
pn  zip                           <none>     (no description available)

-- no debconf information

-- 
Bjarni I. Gislason

Attachment: unzip.1.diff.gz
Description: application/gunzip

Reply via email to