From uspoerlein@gmail.com  Thu Apr 16 17:32:44 2009
Return-Path: <uspoerlein@gmail.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 1BE53106564A;
	Thu, 16 Apr 2009 17:32:44 +0000 (UTC)
	(envelope-from uspoerlein@gmail.com)
Received: from acme.spoerlein.net (cl-43.dus-01.de.sixxs.net [IPv6:2a01:198:200:2a::2])
	by mx1.freebsd.org (Postfix) with ESMTP id 6DA4C8FC13;
	Thu, 16 Apr 2009 17:32:43 +0000 (UTC)
	(envelope-from uspoerlein@gmail.com)
Received: from roadrunner.spoerlein.net (e180152215.adsl.alicedsl.de [85.180.152.215])
	by acme.spoerlein.net (8.14.3/8.14.3) with ESMTP id n3GHWfJp098394
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
	Thu, 16 Apr 2009 19:32:42 +0200 (CEST)
	(envelope-from uspoerlein@gmail.com)
Received: from roadrunner.spoerlein.net (localhost [127.0.0.1])
	by roadrunner.spoerlein.net (8.14.3/8.14.3) with ESMTP id n3GHWYqi060541
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Thu, 16 Apr 2009 19:32:35 +0200 (CEST)
	(envelope-from uqs@roadrunner.spoerlein.net)
Received: (from uqs@localhost)
	by roadrunner.spoerlein.net (8.14.3/8.14.3/Submit) id n3GHWYOb060540;
	Thu, 16 Apr 2009 19:32:34 +0200 (CEST)
	(envelope-from uqs)
Message-Id: <200904161732.n3GHWYOb060540@roadrunner.spoerlein.net>
Date: Thu, 16 Apr 2009 19:32:34 +0200 (CEST)
From: Ulrich Spoerlein <uqs@spoerlein.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc: re@freebsd.org
Subject: [PATCH] man pages lying about HISTORY
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         133785
>Category:       docs
>Synopsis:       [PATCH] man pages lying about HISTORY
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    brueffer
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Apr 16 17:40:06 UTC 2009
>Closed-Date:    Thu Apr 23 19:32:08 CEST 2009
>Last-Modified:  Fri Nov 12 20:54:22 UTC 2010
>Originator:     Ulrich Spoerlein
>Release:        FreeBSD 7.2-PRERELEASE i386
>Organization:
>Environment:
>Description:
Simple "grep .Fx 8.0" over all manpages from RELENG_7 tree (before 7.2 branch)
turned up the following manpages, that lie about when features first appeared
in FreeBSD.

Either the documented feature is there, then it will appear in 7.2 before 8.0.
Or the documented feature is really only in 8.0, then it should not be
mentioned in 7.2.

I assume the first case, naturally. The patch should be committed to HEAD and then
MFC'ed to RELENG_7 and RELENG_7_2 or whatever they are called in SVN land.

@re: A one-liner like the following could/should be added to the TODO list when
branching for the next release to catch these trivial inconsistencies.

find /usr/src -type f -name \*.[0-9] | while read man; do
  egrep -Hn "^\.Fx 8.0" $man
done

Which can be followed by a 'vim -q' to fix them quickly.
>How-To-Repeat:
>Fix:

--- manpage-diff begins here ---
Index: sbin/savecore/savecore.8
===================================================================
RCS file: /tank/ncvs/src/sbin/savecore/savecore.8,v
retrieving revision 1.25.10.1
diff -u -p -r1.25.10.1 savecore.8
--- sbin/savecore/savecore.8	31 Mar 2008 22:03:54 -0000	1.25.10.1
+++ sbin/savecore/savecore.8	16 Apr 2009 17:23:30 -0000
@@ -154,6 +154,6 @@ utility appeared in
 .Bx 4.1 .
 .Pp
 Support for kernel textdumps appeared in
-.Fx 8.0 .
+.Fx 7.2 .
 .Sh BUGS
 The minfree code does not consider the effect of compression or sparse files.
Index: share/man/man4/man4.powerpc/bm.4
===================================================================
RCS file: /tank/ncvs/src/share/man/man4/man4.powerpc/bm.4,v
retrieving revision 1.1.2.1
diff -u -p -r1.1.2.1 bm.4
--- share/man/man4/man4.powerpc/bm.4	28 Aug 2008 17:06:24 -0000	1.1.2.1
+++ share/man/man4/man4.powerpc/bm.4	16 Apr 2009 17:23:30 -0000
@@ -76,7 +76,7 @@ Apple BMAC+ Onboard Ethernet
 The
 .Nm
 device driver appeared in
-.Fx 8.0 .
+.Fx 7.2 .
 .Sh AUTHORS
 .An -nosplit
 The
Index: share/man/man4/man4.i386/glxsb.4
===================================================================
RCS file: /tank/ncvs/src/share/man/man4/man4.i386/glxsb.4,v
retrieving revision 1.3.2.1
diff -u -p -r1.3.2.1 glxsb.4
--- share/man/man4/man4.i386/glxsb.4	20 Aug 2008 14:16:07 -0000	1.3.2.1
+++ share/man/man4/man4.i386/glxsb.4	16 Apr 2009 17:23:30 -0000
@@ -82,7 +82,7 @@ device driver first appeared in
 The
 .Nm
 device driver was imported into
-.Fx 8.0 .
+.Fx 7.2 .
 .Sh AUTHORS
 .An -nosplit
 The
Index: share/man/man4/cpuctl.4
===================================================================
RCS file: /tank/ncvs/src/share/man/man4/cpuctl.4,v
retrieving revision 1.5.2.1
diff -u -p -r1.5.2.1 cpuctl.4
--- share/man/man4/cpuctl.4	12 Jan 2009 15:48:22 -0000	1.5.2.1
+++ share/man/man4/cpuctl.4	16 Apr 2009 17:23:30 -0000
@@ -142,7 +142,7 @@ The firmware image address points outsid
 The
 .Nm
 driver first appeared in
-.Fx 8.0 .
+.Fx 7.2 .
 .Sh BUGS
 Yes, probably, report if any.
 .Sh AUTHORS
Index: share/man/man4/u3g.4
===================================================================
RCS file: /tank/ncvs/src/share/man/man4/u3g.4,v
retrieving revision 1.9.2.1
diff -u -p -r1.9.2.1 u3g.4
--- share/man/man4/u3g.4	22 Mar 2009 16:27:14 -0000	1.9.2.1
+++ share/man/man4/u3g.4	16 Apr 2009 17:23:30 -0000
@@ -109,7 +109,7 @@ and replug the device.
 The
 .Nm
 driver appeared in
-.Fx 8.0 ,
+.Fx 7.2 ,
 is based on the
 .Xr uark 4
 driver, and written by
Index: usr.sbin/setfib/setfib.1
===================================================================
RCS file: /tank/ncvs/src/usr.sbin/setfib/setfib.1,v
retrieving revision 1.2.2.1
diff -u -p -r1.2.2.1 setfib.1
--- usr.sbin/setfib/setfib.1	24 Jul 2008 01:13:22 -0000	1.2.2.1
+++ usr.sbin/setfib/setfib.1	16 Apr 2009 17:23:30 -0000
@@ -94,4 +94,4 @@ have an equivalent function.
 The
 .Nm
 utility appeared in
-.Fx 8.0 .
+.Fx 7.2 .
Index: usr.sbin/cpucontrol/cpucontrol.8
===================================================================
RCS file: /tank/ncvs/src/usr.sbin/cpucontrol/cpucontrol.8,v
retrieving revision 1.4.2.1
diff -u -p -r1.4.2.1 cpucontrol.8
--- usr.sbin/cpucontrol/cpucontrol.8	12 Jan 2009 15:48:22 -0000	1.4.2.1
+++ usr.sbin/cpucontrol/cpucontrol.8	16 Apr 2009 17:23:30 -0000
@@ -113,7 +113,7 @@ use the following command:
 The
 .Nm
 utility first appeared in
-.Fx 8.0 .
+.Fx 7.2 .
 .Sh BUGS
 Yes, probably, report if any.
 .Sh AUTHORS
Index: usr.sbin/crashinfo/crashinfo.8
===================================================================
RCS file: /tank/ncvs/src/usr.sbin/crashinfo/crashinfo.8,v
retrieving revision 1.1.2.1
diff -u -p -r1.1.2.1 crashinfo.8
--- usr.sbin/crashinfo/crashinfo.8	12 Sep 2008 21:30:54 -0000	1.1.2.1
+++ usr.sbin/crashinfo/crashinfo.8	16 Apr 2009 17:23:30 -0000
@@ -106,4 +106,4 @@ Specify an explicit kernel file.
 The
 .Nm
 utility appeared in
-.Fx 8.0 .
+.Fx 7.2 .
Index: lib/libc/string/memchr.3
===================================================================
RCS file: /tank/ncvs/src/lib/libc/string/memchr.3,v
retrieving revision 1.9.2.1
diff -u -p -r1.9.2.1 memchr.3
--- lib/libc/string/memchr.3	27 May 2008 20:01:04 -0000	1.9.2.1
+++ lib/libc/string/memchr.3	16 Apr 2009 17:23:30 -0000
@@ -99,6 +99,6 @@ The
 .Fn memrchr
 function first appeared in GNU libc 2.1.91, this implementation
 first appeared in
-.Fx 8.0 ,
+.Fx 7.2 ,
 coming from
 .Ox 4.3 .
Index: lib/libc/sys/setfib.2
===================================================================
RCS file: /tank/ncvs/src/lib/libc/sys/setfib.2,v
retrieving revision 1.2.2.2
diff -u -p -r1.2.2.2 setfib.2
--- lib/libc/sys/setfib.2	25 Jul 2008 01:11:07 -0000	1.2.2.2
+++ lib/libc/sys/setfib.2	16 Apr 2009 17:23:30 -0000
@@ -76,4 +76,4 @@ have been added to many other UNIX style
 The
 .Fn setfib
 function appeared in
-.Fx 8.0 .
+.Fx 7.2 .
--- manpage-diff ends here ---


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: brueffer 
State-Changed-When: Thu Apr 23 10:38:25 CEST 2009 
State-Changed-Why:  
Corrected in HEAD.  A little more research was necessary, since 
half of the functionality appeared prior to 7.2. 


Responsible-Changed-From-To: freebsd-doc->brueffer 
Responsible-Changed-By: brueffer 
Responsible-Changed-When: Thu Apr 23 10:38:25 CEST 2009 
Responsible-Changed-Why:  
MFC reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=133785 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/133785: commit references a PR
Date: Thu, 23 Apr 2009 08:38:50 +0000 (UTC)

 Author: brueffer
 Date: Thu Apr 23 08:37:56 2009
 New Revision: 191414
 URL: http://svn.freebsd.org/changeset/base/191414
 
 Log:
   Correct the information about when the respective functionality first
   appeared in FreeBSD.
   
   PR:		133785
   Submitted by:	Ulrich Spoerlein <uqs@spoerlein.net>
   MFC after:	3 days
 
 Modified:
   head/lib/libc/string/memchr.3
   head/lib/libc/sys/setfib.2
   head/sbin/savecore/savecore.8
   head/share/man/man4/cpuctl.4
   head/share/man/man4/man4.i386/glxsb.4
   head/share/man/man4/man4.powerpc/bm.4
   head/share/man/man4/u3g.4
   head/usr.sbin/cpucontrol/cpucontrol.8
   head/usr.sbin/crashinfo/crashinfo.8
   head/usr.sbin/setfib/setfib.1
 
 Modified: head/lib/libc/string/memchr.3
 ==============================================================================
 --- head/lib/libc/string/memchr.3	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/lib/libc/string/memchr.3	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -100,6 +100,6 @@ The
  .Fn memrchr
  function first appeared in GNU libc 2.1.91, this implementation
  first appeared in
 -.Fx 8.0 ,
 +.Fx 6.4 ,
  coming from
  .Ox 4.3 .
 
 Modified: head/lib/libc/sys/setfib.2
 ==============================================================================
 --- head/lib/libc/sys/setfib.2	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/lib/libc/sys/setfib.2	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -81,4 +81,4 @@ have been added to many other
  The
  .Fn setfib
  function appeared in
 -.Fx 8.0 .
 +.Fx 7.1 .
 
 Modified: head/sbin/savecore/savecore.8
 ==============================================================================
 --- head/sbin/savecore/savecore.8	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/sbin/savecore/savecore.8	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -154,6 +154,6 @@ utility appeared in
  .Bx 4.1 .
  .Pp
  Support for kernel textdumps appeared in
 -.Fx 8.0 .
 +.Fx 7.1 .
  .Sh BUGS
  The minfree code does not consider the effect of compression or sparse files.
 
 Modified: head/share/man/man4/cpuctl.4
 ==============================================================================
 --- head/share/man/man4/cpuctl.4	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/share/man/man4/cpuctl.4	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -142,7 +142,7 @@ The firmware image address points outsid
  The
  .Nm
  driver first appeared in
 -.Fx 8.0 .
 +.Fx 7.2 .
  .Sh BUGS
  Yes, probably, report if any.
  .Sh AUTHORS
 
 Modified: head/share/man/man4/man4.i386/glxsb.4
 ==============================================================================
 --- head/share/man/man4/man4.i386/glxsb.4	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/share/man/man4/man4.i386/glxsb.4	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -82,7 +82,7 @@ device driver first appeared in
  The
  .Nm
  device driver was imported into
 -.Fx 8.0 .
 +.Fx 7.1 .
  .Sh AUTHORS
  .An -nosplit
  The
 
 Modified: head/share/man/man4/man4.powerpc/bm.4
 ==============================================================================
 --- head/share/man/man4/man4.powerpc/bm.4	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/share/man/man4/man4.powerpc/bm.4	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -76,7 +76,7 @@ Apple BMAC+ Onboard Ethernet
  The
  .Nm
  device driver appeared in
 -.Fx 8.0 .
 +.Fx 7.1 .
  .Sh AUTHORS
  .An -nosplit
  The
 
 Modified: head/share/man/man4/u3g.4
 ==============================================================================
 --- head/share/man/man4/u3g.4	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/share/man/man4/u3g.4	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -109,7 +109,7 @@ and replug the device.
  The
  .Nm
  driver appeared in
 -.Fx 8.0 ,
 +.Fx 7.2 ,
  is based on the
  .Xr uark 4
  driver, and written by
 
 Modified: head/usr.sbin/cpucontrol/cpucontrol.8
 ==============================================================================
 --- head/usr.sbin/cpucontrol/cpucontrol.8	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/usr.sbin/cpucontrol/cpucontrol.8	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -113,7 +113,7 @@ use the following command:
  The
  .Nm
  utility first appeared in
 -.Fx 8.0 .
 +.Fx 7.2 .
  .Sh BUGS
  Yes, probably, report if any.
  .Sh AUTHORS
 
 Modified: head/usr.sbin/crashinfo/crashinfo.8
 ==============================================================================
 --- head/usr.sbin/crashinfo/crashinfo.8	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/usr.sbin/crashinfo/crashinfo.8	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -106,4 +106,4 @@ Specify an explicit kernel file.
  The
  .Nm
  utility appeared in
 -.Fx 8.0 .
 +.Fx 6.4 .
 
 Modified: head/usr.sbin/setfib/setfib.1
 ==============================================================================
 --- head/usr.sbin/setfib/setfib.1	Thu Apr 23 08:11:48 2009	(r191413)
 +++ head/usr.sbin/setfib/setfib.1	Thu Apr 23 08:37:56 2009	(r191414)
 @@ -94,4 +94,4 @@ have an equivalent function.
  The
  .Nm
  utility appeared in
 -.Fx 8.0 .
 +.Fx 7.1 .
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: brueffer 
State-Changed-When: Thu Apr 23 19:31:44 CEST 2009 
State-Changed-Why:  
MFCs done. Thanks! 

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