From n-kogane@syd.odn.ne.jp  Tue Dec 28 15:07:53 2004
Return-Path: <n-kogane@syd.odn.ne.jp>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9F64916A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 28 Dec 2004 15:07:53 +0000 (GMT)
Received: from t-mta2.odn.ne.jp (mfep2.odn.ne.jp [143.90.131.180])
	by mx1.FreeBSD.org (Postfix) with ESMTP id F3EC043D41
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 28 Dec 2004 15:07:52 +0000 (GMT)
	(envelope-from n-kogane@syd.odn.ne.jp)
Received: from kces6.koganemaru.co.jp ([210.252.255.207])
          by t-mta2.odn.ne.jp with ESMTP
          id <20041228150752084.KYLY.2654.t-mta2.odn.ne.jp@mta2.odn.ne.jp>
          for <FreeBSD-gnats-submit@freebsd.org>;
          Wed, 29 Dec 2004 00:07:52 +0900
Received: by kces6.koganemaru.co.jp (Postfix, from userid 100)
	id 216D510272; Wed, 29 Dec 2004 00:12:19 +0000 (GMT)
Message-Id: <20041229001219.216D510272@kces6.koganemaru.co.jp>
Date: Wed, 29 Dec 2004 00:12:19 +0000 (GMT)
From: n-kogane@syd.odn.ne.jp
Reply-To: n-kogane@syd.odn.ne.jp
To: FreeBSD-gnats-submit@freebsd.org
Subject: typos in man3 manual pages, curs_termcap.3, inet6_option_space.3, ipx.3, libalias.3, libdisk.3, libstand.3, logging.3, login_cap.3.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         75574
>Category:       docs
>Synopsis:       typos in man3 manual pages, curs_termcap.3, inet6_option_space.3, ipx.3, libalias.3, libdisk.3, libstand.3, logging.3, login_cap.3.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 28 15:10:13 GMT 2004
>Closed-Date:    Tue Feb 08 19:46:33 GMT 2005
>Last-Modified:  Tue Feb 08 19:46:33 GMT 2005
>Originator:     Nobuyuki Koganemaru
>Release:        FreeBSD 4.11-RC1 i386
>Organization:
KOGANEMARU Computer Engineering Service Corporation.
>Environment:
FreeBSD kcesx3.koganemaru.co.jp 4.10-RELEASE FreeBSD 4.10-RELEASE #0: Tue May 25 22:47:12 GMT 2004     root@perseus.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386


>Description:
	I found some typos in curs_termcap.3, inet6_option_space.3, ipx.3,
	libalias.3, libdisk.3, libstand.3, logging.3, login_cap.3.
>How-To-Repeat:
	Do "man 3 xxxxx".
>Fix:
 
diff -u curs_termcap.3.orig ./curs_termcap.3
--- curs_termcap.3.orig	Sat Dec 18 00:08:08 2004
+++ ./curs_termcap.3	Tue Dec 28 04:36:36 2004
@@ -106,7 +106,7 @@
 are marked TO BE WITHDRAWN and may be removed in future versions.
 
 Neither the XSI Curses standard nor the SVr4 man pages documented the return
-values of \fBtgetent\fR correctly, though all three were in fact returned ever
+values of \fBtgetent\fR correctly, though all there were in fact returned ever
 since SVr1.
 .SH SEE ALSO
 \fBcurses\fR(3X), \fBterminfo\fR(\*n), \fBputc\fR(3S).
diff -u inet6_option_space.3.orig ./inet6_option_space.3
--- inet6_option_space.3.orig	Sat Dec 18 00:08:11 2004
+++ ./inet6_option_space.3	Tue Dec 28 23:52:42 2004
@@ -361,7 +361,7 @@
 .Fa *tptrp
 must be set to
 .Dv NULL .
-.Pa
+.Pp
 This function starts searching for an option of the specified type
 beginning after the value of
 .Fa *tptrp .
diff -u ipx.3.orig ./ipx.3
--- ipx.3.orig	Sat Dec 18 00:08:16 2004
+++ ./ipx.3	Tue Dec 28 23:54:42 2004
@@ -91,7 +91,7 @@
 quantity to be zero extended in the high-network-order bytes.
 Next, the field is inspected for hyphens, in which case
 the field is assumed to be a number in decimal notation
-with hyphens separating the millenia.
+with hyphens separating the millennia.
 Next, the field is assumed to be a number:
 It is interpreted
 as hexadecimal if there is a leading
diff -u libalias.3.orig ./libalias.3
--- libalias.3.orig	Sat Dec 18 00:08:10 2004
+++ ./libalias.3	Tue Dec 28 23:56:31 2004
@@ -342,7 +342,7 @@
 .Fa buffer ,
 and
 .Fa maxpacketsize
-indicates the maximum packet size permissible should the packet length be
+indicates the maximum packet size permissibility should the packet length be
 changed.
 IP encoding protocols place address and port information in the encapsulated
 data stream which has to be modified and can account for changes in packet
diff -u libdisk.3.orig ./libdisk.3
--- libdisk.3.orig	Sat Dec 18 00:08:15 2004
+++ ./libdisk.3	Tue Dec 28 23:59:33 2004
@@ -173,7 +173,7 @@
 .Ql whole, unknown, fat, freebsd, extended, part, unused .
 .Pp
 These are the valid
-.Ql flag
+.Ql flags
 values for a
 .Ql struct chunk .
 .Bl -tag -offset indent -width CHUNK_BSD_COMPATXX
@@ -297,9 +297,9 @@
 up to next track according to the BIOS geometry.
 .Pp
 .Fn Prev_Track_Aligned
-checks if
+rounds
 .Ql offset
-is aligned on a track according to the BIOS geometry.
+up to previous track according to the BIOS geometry.
 .Pp
 .Fn Create_Chunk_DWIM
 creates a partition inside the given parent of the given size, and
diff -u libstand.3.orig ./libstand.3
--- libstand.3.orig	Sat Dec 18 00:08:17 2004
+++ ./libstand.3	Wed Dec 29 00:03:20 2004
@@ -550,6 +550,7 @@
 .Ft int
 .Fn devclose "struct open_file *of"
 .Xc
+.Pp
 Close the device allocated for
 .Fa of .
 The device driver itself will already have been called for the close; this call
diff -u logging.3.orig ./logging.3
--- logging.3.orig	Sat Dec 18 00:08:16 2004
+++ ./logging.3	Wed Dec 29 00:10:29 2004
@@ -737,7 +737,7 @@
 and 
 .Dq Fa level .
 The
-.Dq Fa facility .
+.Dq Fa facility
 can be any valid
 .Xr syslog 3
 facility; see the appropriate system header file or manpage for more 
@@ -883,7 +883,7 @@
 .Dv NULL
 or 
 .Fa category
-is invalid, as under failure condition a) for
+is invalid, as under failure condition for
 .Fn log_add_channel ,
 above, including the setting of
 .Va errno ;
diff -u login_cap.3.orig ./login_cap.3
--- login_cap.3.orig	Sat Dec 18 00:08:09 2004
+++ ./login_cap.3	Wed Dec 29 00:12:37 2004
@@ -321,7 +321,7 @@
 .Fn login_getstyle .
 .It Fn login_getpath
 This function returns a list of directories separated by colons
-.Ql &: .
+.Ql \&: .
 Capability tags for which this function is called consist of a list of
 directories separated by spaces.
 .It Fn login_getcaptime
@@ -400,7 +400,7 @@
 default to "passwd" as the authorisation list.
 .It
 If 'style' is not NULL or empty, look for it in the list of authorisation
-methods found from the pprevious step.
+methods found from the previous step.
 If 'style' is NULL or an empty string, then default to "passwd"
 authorisation.
 .It
>Release-Note:
>Audit-Trail:

From: Tom Rhodes <trhodes@FreeBSD.org>
To: n-kogane@syd.odn.ne.jp
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/75574: typos in man3 manual pages, curs_termcap.3,
 inet6_option_space.3, ipx.3, libalias.3, libdisk.3, libstand.3,	logging.3,
 login_cap.3.
Date: Tue, 28 Dec 2004 21:08:35 -0500

 On Wed, 29 Dec 2004 00:12:19 +0000 (GMT)
 n-kogane@syd.odn.ne.jp wrote:
 
 >  
 > diff -u curs_termcap.3.orig ./curs_termcap.3
 > --- curs_termcap.3.orig	Sat Dec 18 00:08:08 2004
 > +++ ./curs_termcap.3	Tue Dec 28 04:36:36 2004
 > @@ -106,7 +106,7 @@
 >  are marked TO BE WITHDRAWN and may be removed in future versions.
 >  
 >  Neither the XSI Curses standard nor the SVr4 man pages documented the return
 > -values of \fBtgetent\fR correctly, though all three were in fact returned ever
 > +values of \fBtgetent\fR correctly, though all there were in fact returned ever
 >  since SVr1.
 >  .SH SEE ALSO
 >  \fBcurses\fR(3X), \fBterminfo\fR(\*n), \fBputc\fR(3S).
 
 This is contributed software, which we normally don't modify.
 Is there a way you could have this modification done by the
 vendor?
 
 
 > diff -u inet6_option_space.3.orig ./inet6_option_space.3
 > --- inet6_option_space.3.orig	Sat Dec 18 00:08:11 2004
 > +++ ./inet6_option_space.3	Tue Dec 28 23:52:42 2004
 > @@ -361,7 +361,7 @@
 >  .Fa *tptrp
 >  must be set to
 >  .Dv NULL .
 > -.Pa
 > +.Pp
 >  This function starts searching for an option of the specified type
 >  beginning after the value of
 >  .Fa *tptrp .
 > diff -u ipx.3.orig ./ipx.3
 > --- ipx.3.orig	Sat Dec 18 00:08:16 2004
 > +++ ./ipx.3	Tue Dec 28 23:54:42 2004
 > @@ -91,7 +91,7 @@
 >  quantity to be zero extended in the high-network-order bytes.
 >  Next, the field is inspected for hyphens, in which case
 >  the field is assumed to be a number in decimal notation
 > -with hyphens separating the millenia.
 > +with hyphens separating the millennia.
 >  Next, the field is assumed to be a number:
 >  It is interpreted
 >  as hexadecimal if there is a leading
 > diff -u libalias.3.orig ./libalias.3
 > --- libalias.3.orig	Sat Dec 18 00:08:10 2004
 > +++ ./libalias.3	Tue Dec 28 23:56:31 2004
 > @@ -342,7 +342,7 @@
 >  .Fa buffer ,
 >  and
 >  .Fa maxpacketsize
 > -indicates the maximum packet size permissible should the packet length be
 > +indicates the maximum packet size permissibility should the packet length be
 
 I'm not sure changing one adjective for another adjective which makes
 the sentence sound odd is a good idea.
 
 [SNIP]
 
 The rest looks good to me.
 
 -- 
 Tom Rhodes
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Wed Dec 29 03:04:24 GMT 2004 
State-Changed-Why:  
Modified version of submitted patch committed; awaiting MFC. 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Wed Dec 29 03:04:24 GMT 2004 
Responsible-Changed-Why:  
Over to me for the MFC. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=75574 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Tue Feb 8 19:46:08 GMT 2005 
State-Changed-Why:  
Patched up CURRENT and RELENG_5 already, thanks for 
the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=75574 
>Unformatted:
