From owner-freebsd-doc@FreeBSD.ORG Tue May 8 17:30:08 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 5455B106566B for ; Tue, 8 May 2012 17:30:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1C1DC8FC0C for ; Tue, 8 May 2012 17:30:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q48HU7hL033969 for ; Tue, 8 May 2012 17:30:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q48HU78B033968; Tue, 8 May 2012 17:30:07 GMT (envelope-from gnats) Resent-Date: Tue, 8 May 2012 17:30:07 GMT Resent-Message-Id: <201205081730.q48HU78B033968@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, kogane@jp.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5D91A1065672 for ; Tue, 8 May 2012 17:21:07 +0000 (UTC) (envelope-from n-kogane@syd.odn.ne.jp) Received: from cmta102.odn.ne.jp (mta102.odn.ne.jp [143.90.14.138]) by mx1.freebsd.org (Postfix) with ESMTP id D31508FC16 for ; Tue, 8 May 2012 17:21:06 +0000 (UTC) Received: from vmta102.odn.ne.jp by cmta102.odn.ne.jp with ESMTP id <20120508172105531.EFAE.16604.cmta102.odn.ne.jp@mta102.odn.ne.jp> for ; Wed, 9 May 2012 02:21:05 +0900 Received: from emta102.odn.ne.jp by vmta102.odn.ne.jp with ESMTP id <20120508172105486.HNUP.22564.vmta102.odn.ne.jp@mta102.odn.ne.jp> for ; Wed, 9 May 2012 02:21:05 +0900 Received: from kcesx30.koganemaru.co.jp ([218.218.68.33] [218.218.68.33]) by emta102.odn.ne.jp with ESMTP id <20120508172105290.BVTM.6396.emta102.odn.ne.jp@mta102.odn.ne.jp> for ; Wed, 9 May 2012 02:21:05 +0900 Received: by kcesx30.koganemaru.co.jp (Postfix, from userid 100) id D720028429; Wed, 9 May 2012 02:19:34 +0900 (JST) Message-Id: <20120508171934.D720028429@kcesx30.koganemaru.co.jp> Date: Wed, 9 May 2012 02:19:34 +0900 (JST) From: Nobuyuki Koganemaru To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/167713: gnroff mandoc style, usage mistake or typos. (man2) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: kogane@jp.freebsd.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 08 May 2012 17:30:08 -0000 >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: