Package: pciutils
Version: 1:3.1.7-6
Severity: minor
Tags: patch
From "man ..." ("groff -ww ..."):
<groff: setpci.8>:2: warning: macro `IX' not defined
<groff: setpci.8>:151: warning: escape character ignored before `I'
Ellipsis at end of line protected with "\&".
The macro "IX" is not part of the man(doc)-macros.
####
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 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.
####
Patch:
--- setpci.8 2012-05-25 21:07:04.000000000 +0000
+++ setpci.8.new 2012-05-25 22:07:36.000000000 +0000
@@ -1,5 +1,5 @@
.TH setpci 8 "31 January 2010" "pciutils-3.1.7" "The PCI Utilities"
-.IX setpci
+.\".IX setpci
.SH NAME
setpci \- configure PCI devices
.SH SYNOPSIS
@@ -115,7 +115,7 @@
.PP
There are two kinds of operations: reads and writes. To read a register, just
specify
its name. Writes have the form
-.IR name = value , value ...
+.IR name = value , value ...\&
where each
.I value
is either a hexadecimal number or an expression of type
@@ -148,7 +148,7 @@
Each of the previous formats can be followed by \fB+offset\fP to add an offset
(a hex number) to the address. This feature can be useful for addressing of
registers
living within a capability, or to modify parts of standard registers.
-\IP \(bu
+.IP \(bu
Finally, you should append a width specifier \fB.B\fP, \fB.W\fP, or \fB.L\fP
to choose
how many bytes (1, 2, or 4) should be transferred. The width can be omitted if
you are
accessing a named register whose width is well known.
-- 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 pciutils depends on:
ii libc6 2.11.3-3 Embedded GNU C Library: Shared lib
ii libpci3 1:3.1.7-6 Linux PCI Utilities (shared librar
pciutils recommends no packages.
Versions of packages pciutils suggests:
ii bzip2 1.0.5-6+squeeze1 high-quality block-sorting file co
ii lynx 2.8.8dev.5-1 Text-mode WWW Browser (transitiona
ii wget 1.12-2.1 retrieves files from the web
-- no debconf information
--
Bjarni I. Gislason
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
