Date: Wed, 9 May 2012 02:19:34 +0900 (JST) From: Nobuyuki Koganemaru <kogane@jp.freebsd.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/167713: gnroff mandoc style, usage mistake or typos. (man2) Message-ID: <20120508171934.D720028429@kcesx30.koganemaru.co.jp> Resent-Message-ID: <201205081730.q48HU78B033968@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 167713
>Category: docs
>Synopsis: gnroff mandoc style, usage mistake or typos. (man2)
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Tue May 08 17:30:07 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator: Nobuyuki Koganemaru
>Release: FreeBSD 10.0-CURRENT
>Organization:
KOGANEMARU Computer Engineering Service Corporation.
>Environment:
System: FreeBSD kcesx31.koganemaru.co.jp 8.2-RELEASE-p6 FreeBSD 8.2-RELEASE-p6 #0: Tue Apr 24 03:49:22 JST 2012 root@kcesx31.koganemaru.co.jp:/usr/obj/usr/src.82/sys/GENERIC i386
>Description:
man2
>How-To-Repeat:
none.
>Fix:
corrected files:
ffclock.2:
$FreeBSD: src/lib/libc/sys/ffclock.2,v 1.1 2011/11/21 01:26:10 lstewart Exp $
ktrace.2:
$FreeBSD: src/lib/libc/sys/ktrace.2,v 1.31 2012/03/29 16:02:40 joel Exp $
msgsnd.2:
$NetBSD: msgsnd.2,v 1.1 1995/10/16 23:49:24 jtc Exp $
$FreeBSD: src/lib/libc/sys/msgsnd.2,v 1.1 2009/07/13 12:53:43 trasz Exp $
pathconf.2:
$FreeBSD: src/lib/libc/sys/pathconf.2,v 1.27 2012/03/29 05:02:12 eadler Exp $
rtprio.2:
$FreeBSD: src/lib/libc/sys/rtprio.2,v 1.27 2011/12/27 10:34:00 delphij Exp $
setfib.2:
$FreeBSD: src/lib/libc/sys/setfib.2,v 1.9 2012/04/22 07:51:49 delphij Exp $
shm_open.2:
$FreeBSD: src/lib/libc/sys/shm_open.2,v 1.16 2012/03/25 12:13:24 joel Exp $
sigpause.2:
$FreeBSD: src/lib/libc/compat-43/sigpause.2,v 1.17 2010/05/24 11:14:40 uqs Exp $
sigqueue.2:
$FreeBSD: src/lib/libc/sys/sigqueue.2,v 1.9 2012/03/10 10:54:52 trasz Exp $
timer_create.2:
$FreeBSD: src/lib/libc/sys/timer_create.2,v 1.11 2011/10/26 14:26:10 pluknet Exp $
timer_delete.2:
$FreeBSD: src/lib/libc/sys/timer_delete.2,v 1.6 2007/06/18 01:50:03 davidxu Exp $
timer_settime.2:
$FreeBSD: src/lib/libc/sys/timer_settime.2,v 1.8 2007/06/18 01:50:03 davidxu Exp $
unlink.2:
$FreeBSD: src/lib/libc/sys/unlink.2,v 1.25 2010/04/25 13:55:52 jilles Exp $
patch files:
diff -u ffclock.2.orig ./ffclock.2
--- ffclock.2.orig 2012-05-09 02:03:28.000000000 +0900
+++ ./ffclock.2 2012-05-09 02:04:26.000000000 +0900
@@ -34,7 +34,7 @@
.Nm ffclock_getcounter ,
.Nm ffclock_getestimate ,
.Nm ffclock_setestimate
-.Nd Retrieve feed-forward counter, get and set feed-forward clock estimates.
+.Nd Retrieve feed-forward counter, get and set feed-forward clock estimates
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
@@ -59,7 +59,7 @@
.Em timestamp
is a cumulative value of the ticks of the timecounter, which can be converted
into seconds by using the feed-forward
-.Em clock estimates.
+.Em clock estimates .
.Pp
The
.Fn ffclock_getcounter
diff -u ktrace.2.orig ./ktrace.2
--- ktrace.2.orig 2012-05-09 02:04:54.000000000 +0900
+++ ./ktrace.2 2012-05-09 02:05:13.000000000 +0900
@@ -127,7 +127,7 @@
that the record was generated.
The
.Va ktr_tid
-field holds a threadid.
+field holds a thread id.
.Pp
The generic header is followed by
.Va ktr_len
diff -u msgsnd.2.orig ./msgsnd.2
--- msgsnd.2.orig 2012-05-09 02:07:52.000000000 +0900
+++ ./msgsnd.2 2012-05-09 02:08:43.000000000 +0900
@@ -139,7 +139,7 @@
The
.Fa msqid
argument
-is not a valid message queue identifier
+is not a valid message queue identifier.
.Pp
The message queue was removed while
.Fn msgsnd
diff -u pathconf.2.orig ./pathconf.2
--- pathconf.2.orig 2012-05-09 02:08:57.000000000 +0900
+++ ./pathconf.2 2012-05-09 02:09:27.000000000 +0900
@@ -165,7 +165,7 @@
specified file, otherwise 0.
.It Li _PC_MIN_HOLE_SIZE
If a file system supports the reporting of holes (see
-.Xr lseek 2 ,
+.Xr lseek 2 ) ,
.Fn pathconf
and
.Fn fpathconf
diff -u rtprio.2.orig ./rtprio.2
--- rtprio.2.orig 2012-05-09 02:09:39.000000000 +0900
+++ ./rtprio.2 2012-05-09 02:11:21.000000000 +0900
@@ -132,7 +132,8 @@
The priority specified by the
.Va prio
field ranges between 0 and
-.Dv RTP_PRIO_MAX (usually 31) .
+.Dv RTP_PRIO_MAX
+(usually 31).
0 is the highest possible priority.
.Pp
Realtime and idle priority is inherited through fork() and exec().
@@ -149,7 +150,7 @@
The
.Fn rtprio
system call
-will fail if
+will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
The specified
@@ -175,7 +176,7 @@
.Xr setpriority 2 ,
.Xr nice 3 ,
.Xr renice 8 ,
-.Xr p_cansee 9 .
+.Xr p_cansee 9
.Sh AUTHORS
.An -nosplit
The original author was
diff -u setfib.2.orig ./setfib.2
--- setfib.2.orig 2012-05-09 02:11:36.000000000 +0900
+++ ./setfib.2 2012-05-09 02:11:47.000000000 +0900
@@ -95,7 +95,8 @@
.Fx
extension however similar extensions
have been added to many other
-.Ux style kernels.
+.Ux
+style kernels.
.Sh HISTORY
The
.Fn setfib
diff -u shm_open.2.orig ./shm_open.2
--- shm_open.2.orig 2012-05-09 02:12:10.000000000 +0900
+++ ./shm_open.2 2012-05-09 02:12:22.000000000 +0900
@@ -88,7 +88,7 @@
then
.Fn shm_open
will fail with
-.Er EEXIST.
+.Er EEXIST .
.Pp
Newly created objects start off with a size of zero.
If an existing shared memory object is opened with
diff -u sigpause.2.orig ./sigpause.2
--- sigpause.2.orig 2012-05-09 02:12:33.000000000 +0900
+++ ./sigpause.2 2012-05-09 02:13:19.000000000 +0900
@@ -62,7 +62,7 @@
.Sy This interface is made obsolete by
.Xr sigsuspend 2
.Sy and
-.Xr sigaction 2
+.Xr sigaction 2 .
.Pp
The
.Fn sigset
@@ -172,7 +172,8 @@
if the signal had been blocked and the signal's previous disposition if
it had not been blocked.
Otherwise,
-.Dv SIG_ERR is returned and
+.Dv SIG_ERR
+is returned and
.Va errno
set to indicate the error.
.Pp
diff -u sigqueue.2.orig ./sigqueue.2
--- sigqueue.2.orig 2012-05-09 02:13:29.000000000 +0900
+++ ./sigqueue.2 2012-05-09 02:13:43.000000000 +0900
@@ -141,7 +141,7 @@
The
.Fn sigqueue
system call conforms to
-.St -p1003.1-2004
+.St -p1003.1-2004 .
.Sh HISTORY
Support for
.Tn POSIX
diff -u timer_create.2.orig ./timer_create.2
--- timer_create.2.orig 2012-05-09 02:13:58.000000000 +0900
+++ ./timer_create.2 2012-05-09 02:14:17.000000000 +0900
@@ -157,7 +157,7 @@
The
.Fn timer_create
system call conforms to
-.St -p1003.1-2004
+.St -p1003.1-2004 .
.Sh HISTORY
Support for
.Tn POSIX
diff -u timer_delete.2.orig ./timer_delete.2
--- timer_delete.2.orig 2012-05-09 02:14:25.000000000 +0900
+++ ./timer_delete.2 2012-05-09 02:14:40.000000000 +0900
@@ -72,7 +72,7 @@
The
.Fn timer_delete
system call conforms to
-.St -p1003.1-2004
+.St -p1003.1-2004 .
.Sh HISTORY
Support for
.Tn POSIX
diff -u timer_settime.2.orig ./timer_settime.2
--- timer_settime.2.orig 2012-05-09 02:14:51.000000000 +0900
+++ ./timer_settime.2 2012-05-09 02:15:01.000000000 +0900
@@ -257,7 +257,7 @@
and
.Fn timer_settime
system calls conform to
-.St -p1003.1-2004
+.St -p1003.1-2004 .
.Sh HISTORY
Support for
.Tn POSIX
diff -u unlink.2.orig ./unlink.2
--- unlink.2.orig 2012-05-09 02:15:13.000000000 +0900
+++ ./unlink.2 2012-05-09 02:15:22.000000000 +0900
@@ -157,7 +157,7 @@
.Fn unlink ,
the
.Fn unlinkat
-may fail if
+may fail if:
.Bl -tag -width Er
.It Bq Er EBADF
The
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20120508171934.D720028429>