summaryrefslogtreecommitdiffstats
path: root/share
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2000-11-22 16:11:48 +0000
committerru <ru@FreeBSD.org>2000-11-22 16:11:48 +0000
commite75ab20d6b4eaec58e390123387f0d0ef2f9f360 (patch)
tree064a66603b9a3557325a005737c8a7027ea73713 /share
parentbdc5340b39fbc40a64feadf0d2fd65beca35a320 (diff)
downloadFreeBSD-src-e75ab20d6b4eaec58e390123387f0d0ef2f9f360.zip
FreeBSD-src-e75ab20d6b4eaec58e390123387f0d0ef2f9f360.tar.gz
mdoc(7) police: Er macro usage cleanup.
Diffstat (limited to 'share')
-rw-r--r--share/examples/mdoc/example.34
-rw-r--r--share/man/man4/intro.42
-rw-r--r--share/man/man4/ip6.42
-rw-r--r--share/man/man4/kld.42
-rw-r--r--share/man/man4/man4.i386/gsc.414
-rw-r--r--share/man/man4/man4.i386/mcd.42
-rw-r--r--share/man/man4/man4.i386/meteor.435
-rw-r--r--share/man/man4/mem.416
-rw-r--r--share/man/man4/pcvt.44
-rw-r--r--share/man/man4/route.46
-rw-r--r--share/man/man4/termios.44
-rw-r--r--share/man/man9/DEVICE_PROBE.95
-rw-r--r--share/man/man9/VFS_VGET.92
-rw-r--r--share/man/man9/VOP_LOOKUP.98
-rw-r--r--share/man/man9/VOP_PATHCONF.92
-rw-r--r--share/man/man9/bus_generic_read_ivar.92
-rw-r--r--share/man/man9/copy.98
-rw-r--r--share/man/man9/sleep.98
-rw-r--r--share/man/man9/suser.92
-rw-r--r--share/man/man9/taskqueue.92
20 files changed, 69 insertions, 61 deletions
diff --git a/share/examples/mdoc/example.3 b/share/examples/mdoc/example.3
index a2028a8..4ec3865 100644
--- a/share/examples/mdoc/example.3
+++ b/share/examples/mdoc/example.3
@@ -197,13 +197,13 @@ Protocol wrong type for socket.
Protocol not available.
.It Bq Er EPROTONOSUPPORT
Protocol not supported.
-.It Bq Er ESOCKNOTSUPORT
+.It Bq Er ESOCKTNOSUPPORT
Socket type not supported.
.It Bq Er EOPNOTSUPP
Operation not supported.
.It Bq Er EPFNOSUPPORT
Protocol family not supported.
-.It Bq Er EAFNNOSUPPORT
+.It Bq Er EAFNOSUPPORT
Address family not supported by protocol family.
.It Bq Er EADDRINUSE
Address already in use.
diff --git a/share/man/man4/intro.4 b/share/man/man4/intro.4
index 5a54534..1507119 100644
--- a/share/man/man4/intro.4
+++ b/share/man/man4/intro.4
@@ -86,7 +86,7 @@ devices, but cannot be accessed since the corresponding device node is
still missing. In the first case, any attempt to reference the device
through the device node will result in an error, returned by the upper
layers of the kernel, usually
-.Ql ENXIO .
+.Er ENXIO .
In the second case, the device node needs to be created before the
driver and its device will be usable.
.Pp
diff --git a/share/man/man4/ip6.4 b/share/man/man4/ip6.4
index db5b360..9605b7d 100644
--- a/share/man/man4/ip6.4
+++ b/share/man/man4/ip6.4
@@ -115,7 +115,7 @@ If -1 is specified, the kernel will use a default value.
If a value of 0 to 255 is specified, the packet will have the specified
value as hoplimit.
Other values are considered invalid, and
-.Dv EINVAL
+.Er EINVAL
will be returned.
For example:
.Bd -literal -offset indent
diff --git a/share/man/man4/kld.4 b/share/man/man4/kld.4
index 41c1ace..6a38cae 100644
--- a/share/man/man4/kld.4
+++ b/share/man/man4/kld.4
@@ -148,7 +148,7 @@ fails to execute the entry point.
.Pp
.Xr kldload 8
returns the cryptic message
-.Sq ENOEXEC Po Exec format error Pc
+.Sq Li "ENOEXEC (Exec format error)"
for any error encountered while loading a module.
.Pp
When system internal interfaces change, old modules often cannot
diff --git a/share/man/man4/man4.i386/gsc.4 b/share/man/man4/man4.i386/gsc.4
index ab453cd..d4a25c6 100644
--- a/share/man/man4/man4.i386/gsc.4
+++ b/share/man/man4/man4.i386/gsc.4
@@ -147,7 +147,8 @@ Set resolution value from selector switch.
The driver must be in an
open though untouched state otherwise the request will fail and
.Xr errno 2
-is set to EBUSY.
+is set to
+.Er EBUSY .
.It GSC_SWIDTH int
Set the
.Em width
@@ -213,12 +214,14 @@ Since the buffer
size limit is (currently) 0x3000 bytes the maximum number of lines
allowed will vary with the width of each line.
This upper limit is
-checked before it overwrites the current value and pases an ENOMEM in
-the
+checked before it overwrites the current value and pases an
+.Er ENOMEM
+in the
.Xr errno 2
variable.
However, since the bitmap width can change
-after a buffer length was selected a read request may fail with ENOMEM
+after a buffer length was selected a read request may fail with
+.Er ENOMEM
if the buffer length turns out too high.
It is generally wise to
choose long buffers rather than go save in order to obtain better
@@ -232,7 +235,8 @@ handy scanner is a human/computer interface timeout values are usually
higher than those of a flat scanner.
Default is 15 seconds.
After
-timeout is reached the read operation will fail with EBUSY.
+timeout is reached the read operation will fail with
+.Er EBUSY .
Note that
the timeout timer starts anew for each buffer to be read and thus does
not cause you to scan faster for longer images.
diff --git a/share/man/man4/man4.i386/mcd.4 b/share/man/man4/man4.i386/mcd.4
index fa848af..4c7bbc6 100644
--- a/share/man/man4/man4.i386/mcd.4
+++ b/share/man/man4/man4.i386/mcd.4
@@ -80,7 +80,7 @@ gets all of the table of contents
begins audio playing at location specified
.It CDIOCPLAYBLOCKS
fails with error
-.Dv EINVAL
+.Er EINVAL
.It CDIOCPLAYMSF
begins audio playing at location specified
.It CDIOCRESUME
diff --git a/share/man/man4/man4.i386/meteor.4 b/share/man/man4/man4.i386/meteor.4
index 7af8285..a17a23a 100644
--- a/share/man/man4/man4.i386/meteor.4
+++ b/share/man/man4/man4.i386/meteor.4
@@ -531,11 +531,11 @@ the existing buffer is used.
If METEORSETGEO fails the ioctl() will return a value of -1 and the
external variable errno will be set to:
.Pp
-.Bl -tag -width EINVAL
-.It Dv EINVAL
+.Bl -tag -width Er
+.It Bq Er EINVAL
invalid meteor_geomet structure pointer, rows, columns,
frames were invalid.
-.It Dv ENOMEM
+.It Bq Er ENOMEM
could not allocate the contiguous block.
.El
.in -0.5i
@@ -658,13 +658,13 @@ capture
If METEORCAPTUR fails the ioctl() will return a value of -1 and the
external variable errno will be set to:
.Pp
-.Bl -tag -width EINVAL
-.It Dv EINVAL
+.Bl -tag -width Er
+.It Bq Er EINVAL
invalid capture command value
-.It Dv ENXIO
+.It Bq Er ENXIO
there is not internal buffer to hold the frame.
this indicates the previous set geometry ioctl failed.
-.It Dv EIO
+.It Bq Er EIO
card is already capturing.
.El
.in -0.5i
@@ -707,13 +707,13 @@ is lower than lowat.
If METEORCAPFRM fails the ioctl() will return a value of -1 and the
external variable errno will be set to:
.Pp
-.Bl -tag -width EINVAL
-.It Dv EINVAL
+.Bl -tag -width Er
+.It Bq Er EINVAL
invalid meteor_geomet structure pointer or bad command.
-.It Dv ENXIO
+.It Bq Er ENXIO
there is not internal buffer to hold the frame.
this indicates the previous set geometry ioctl failed.
-.It Dv EIO
+.It Bq Er EIO
card is already capturing.
.El
.in -0.5i
@@ -727,9 +727,8 @@ gain control and effects the UV output amplitude.
If METEORSCHCV or METEORGCHCV fails the ioctl() will return a value
of -1 and the external variable errno will be set to:
.Pp
-.Bl -tag -width EINVAL
-.It Dv EINVAL
-EINVAL
+.Bl -tag -width Er
+.It Bq Er EINVAL
invalid unsigned char pointer.
.El
.in -0.5i
@@ -745,8 +744,8 @@ signed character has legal values are from +127 which represent
If METEORGHUE or METEORSHUE fails the ioctl() will return a value of
-1 and the external variable errno will be set to:
.Pp
-.Bl -tag -width EINVAL
-.It Dv EINVAL
+.Bl -tag -width Er
+.It Bq Er EINVAL
invalid signed char pointer.
.El
.in -0.5i
@@ -773,8 +772,8 @@ number of FIFO errors since device was opened.
.Pp
If METEORSCOUNT or METEORGCOUNT fails the ioctl() will return a value
of -1 and the external variable errno will be set to:
-.Bl -tag -width EINVAL
-.It Dv EINVAL
+.Bl -tag -width Er
+.It Bq Er EINVAL
invalid meteor_counts structure pointer.
.El
.in -0.5i
diff --git a/share/man/man4/mem.4 b/share/man/man4/mem.4
index be34199..064cc69 100644
--- a/share/man/man4/mem.4
+++ b/share/man/man4/mem.4
@@ -154,24 +154,24 @@ should be set to MEMRANGE_SET_UPDATE to update an existing
or establish a new range, or to MEMRANGE_SET_REMOVE to remove a range.
.Pp
.Sh RETURN VALUES
-.Bl -tag -width 10
-.It EOPNOTSUPP
+.Bl -tag -width Er
+.It Bq Er EOPNOTSUPP
Memory range operations are not supported on this architecture.
-.It ENXIO
+.It Bq Er ENXIO
No memory range descriptors are available (eg. firmware has not enabled
any).
-.It EINVAL
+.It Bq Er EINVAL
The memory range supplied as an argument is invalid or overlaps another
range in a fashion not supported by this architecture.
-.It EBUSY
+.It Bq Er EBUSY
An attempt to remove or update a range failed because the range is busy.
-.It ENOSPC
+.It Bq Er ENOSPC
An attempt to create a new range failed due to a shortage of hardware
resources (eg. descriptor slots).
-.It ENOENT
+.It Bq Er ENOENT
An attempt to remove a range failed because no range matches the descriptor
base/length supplued.
-.It EPERM
+.It Bq Er EPERM
An attempt to remove a range failed because the range is permanently
enabled.
.El
diff --git a/share/man/man4/pcvt.4 b/share/man/man4/pcvt.4
index ef4d4e7..faa966b 100644
--- a/share/man/man4/pcvt.4
+++ b/share/man/man4/pcvt.4
@@ -567,10 +567,10 @@ or a value of 132.
Note that setting the number of columns to 132 is only supported on
some VGA adaptors.
Any unsupported numbers cause the ioctl to fail with
-.Em errno
+.Va errno
.Pq see Xr intro 2
being set to
-.Em EINVAL .
+.Er EINVAL .
.Pp
.Em VGA color palette interface
.Pp
diff --git a/share/man/man4/route.4 b/share/man/man4/route.4
index 9135be2..5d5beec 100644
--- a/share/man/man4/route.4
+++ b/share/man/man4/route.4
@@ -141,14 +141,14 @@ by filling in the
.Ar rtm_errno
field.
The routing code returns
-.Dv EEXIST
+.Er EEXIST
if
requested to duplicate an existing entry,
-.Dv ESRCH
+.Er ESRCH
if
requested to delete a non-existent entry,
or
-.Dv ENOBUFS
+.Er ENOBUFS
if insufficient resources were available
to install a new route.
In the current implementation, all routing processes run locally,
diff --git a/share/man/man4/termios.4 b/share/man/man4/termios.4
index fb54436..2cf0c4b 100644
--- a/share/man/man4/termios.4
+++ b/share/man/man4/termios.4
@@ -174,7 +174,7 @@ process is orphaned, the
.Xr read 2
returns -1 with
.Va errno set to
-.Er Dv EIO
+.Er EIO
and no
signal is sent. The default action of the
.Dv SIGTTIN
@@ -205,7 +205,7 @@ the
.Xr write 2
returns -1 with
errno set to
-.Er Dv EIO
+.Er EIO
and no signal is sent.
.Pp
Certain calls that set terminal parameters are treated in the same
diff --git a/share/man/man9/DEVICE_PROBE.9 b/share/man/man9/DEVICE_PROBE.9
index f643d39..dfb982e 100644
--- a/share/man/man9/DEVICE_PROBE.9
+++ b/share/man/man9/DEVICE_PROBE.9
@@ -43,8 +43,9 @@
.Sh DESCRIPTION
.Pp
This device method should probe to see if the device is present.
-It should return 0 if the device exists, ENXIO if it cannot be
-found.
+It should return 0 if the device exists,
+.Er ENXIO
+if it cannot be found.
If some other error happens during the probe (such as a memory
allocation failure), an appropriate error code should be returned.
For
diff --git a/share/man/man9/VFS_VGET.9 b/share/man/man9/VFS_VGET.9
index 98767c9..12e5e3c 100644
--- a/share/man/man9/VFS_VGET.9
+++ b/share/man/man9/VFS_VGET.9
@@ -61,7 +61,7 @@ implement the
nfs call.
.Pp
If the filesystem does not support this call, then it should return
-.Dv EOPNOTSUPP .
+.Er EOPNOTSUPP .
.Sh SEE ALSO
.Xr VFS 9 ,
.Xr vnode 9
diff --git a/share/man/man9/VOP_LOOKUP.9 b/share/man/man9/VOP_LOOKUP.9
index b2f7b24..12d17e4 100644
--- a/share/man/man9/VOP_LOOKUP.9
+++ b/share/man/man9/VOP_LOOKUP.9
@@ -108,9 +108,9 @@ notfound:
.Bd -filled -offset indent
If creating or renaming and at end of pathname,
return
-.Dv EJUSTRETURN ,
+.Er EJUSTRETURN ,
leaving info on available slots else return
-.Dv ENOENT .
+.Er ENOENT .
.Ed
.Pp
found:
@@ -126,7 +126,7 @@ The directory,
.Fa dvp
should be locked on entry.
If an error (note: the return value
-.Dv EJUSTRETURN
+.Er EJUSTRETURN
is not considered an error)
is detected, it will be returned locked.
Otherwise, it will be unlocked unless both
@@ -153,7 +153,7 @@ or
the flag
.Dv ISLASTCN
is specified and the operation would succeed, the special return value
-.Dv EJUSTRETURN
+.Er EJUSTRETURN
is returned.
Otherwise, an appropriate error code is returned.
.Sh PSEUDOCODE
diff --git a/share/man/man9/VOP_PATHCONF.9 b/share/man/man9/VOP_PATHCONF.9
index cfb392d..bc4a8d4 100644
--- a/share/man/man9/VOP_PATHCONF.9
+++ b/share/man/man9/VOP_PATHCONF.9
@@ -79,7 +79,7 @@ If
is recognized,
.Fa *retval
is set to the specified value and zero is returned, otherwise
-.Dv EINVAL
+.Er EINVAL
is returned.
.Sh SEE ALSO
.Xr pathconf 2 ,
diff --git a/share/man/man9/bus_generic_read_ivar.9 b/share/man/man9/bus_generic_read_ivar.9
index a7fdec4..a4f8f8a 100644
--- a/share/man/man9/bus_generic_read_ivar.9
+++ b/share/man/man9/bus_generic_read_ivar.9
@@ -49,7 +49,7 @@ for busses
.Sh DESCRIPTION
.Pp
These functions simply return
-.Dv ENOENT .
+.Er ENOENT .
.Sh SEE ALSO
.Xr device 9 ,
.Xr driver 9
diff --git a/share/man/man9/copy.9 b/share/man/man9/copy.9
index a01d03c..c1513e2 100644
--- a/share/man/man9/copy.9
+++ b/share/man/man9/copy.9
@@ -116,7 +116,9 @@ NUL, is returned in
.Sh RETURN VALUES
The
.Nm
-functions return 0 on success or EFAULT if a bad address is encountered.
+functions return 0 on success or
+.Er EFAULT
+if a bad address is encountered.
In addition, the
.Fn copystr ,
and
@@ -124,7 +126,9 @@ and
.\" .Fn copyinstr ,
.\" and
.\" .Fn copyoutstr
-functions return ENAMETOOLONG if the string is longer than
+functions return
+.Er ENAMETOOLONG
+if the string is longer than
.Pa len
bytes.
.Sh SEE ALSO
diff --git a/share/man/man9/sleep.9 b/share/man/man9/sleep.9
index 770a070..c4519d8 100644
--- a/share/man/man9/sleep.9
+++ b/share/man/man9/sleep.9
@@ -100,16 +100,16 @@ includes the
.Dv PCATCH
flag, signals are checked before and after sleeping, else signals are
not checked. Returns 0 if awakened,
-.Dv EWOULDBLOCK
+.Er EWOULDBLOCK
if the timeout expires. If
.Dv PCATCH
is set and a signal needs to be delivered,
-.Dv ERESTART
+.Er ERESTART
is returned if the current system call should be restarted if
possible, and
-.Dv EINTR
+.Er EINTR
is returned if the system call should be interrupted by the signal
-.Pq return Dv EINTR .
+.Pq return Er EINTR .
.Pp
.Nm Msleep
is a variation on tsleep. The parameter
diff --git a/share/man/man9/suser.9 b/share/man/man9/suser.9
index 0677073..d8aed25 100644
--- a/share/man/man9/suser.9
+++ b/share/man/man9/suser.9
@@ -98,7 +98,7 @@ The
and
.Nm suser_xxx
functions return 0 if the user has superuser powers and
-.Dv EPERM
+.Er EPERM
otherwise.
This is the
.Em reverse logic
diff --git a/share/man/man9/taskqueue.9 b/share/man/man9/taskqueue.9
index a1ece9f..6356594 100644
--- a/share/man/man9/taskqueue.9
+++ b/share/man/man9/taskqueue.9
@@ -116,7 +116,7 @@ value or at the end of the list if no tasks have a lower priority.
Enqueueing a task does not perform any memory allocation which makes
it suitable for calling from an interrupt handler.
This function will return
-.Dv EPIPE
+.Er EPIPE
if the queue is being freed.
.Pp
To execute all the tasks on a queue,
OpenPOWER on IntegriCloud