Bug 133785

Summary: [PATCH] man pages lying about HISTORY
Product: Documentation Reporter: Ulrich Spoerlein <uqs>
Component: Books & ArticlesAssignee: Christian Brueffer <brueffer>
Status: Closed FIXED    
Severity: Affects Only Me CC: re
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
manpage-diff none

Description Ulrich Spoerlein 2009-04-16 18:40:06 UTC
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.
Comment 1 Christian Brueffer freebsd_committer freebsd_triage 2009-04-23 09:38:25 UTC
State Changed
From-To: open->patched

Corrected in HEAD.  A little more research was necessary, since 
half of the functionality appeared prior to 7.2. 


Comment 2 Christian Brueffer freebsd_committer freebsd_triage 2009-04-23 09:38:25 UTC
Responsible Changed
From-To: freebsd-doc->brueffer

MFC reminder.
Comment 3 dfilter service freebsd_committer freebsd_triage 2009-04-23 09:38:50 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"
Comment 4 Christian Brueffer freebsd_committer freebsd_triage 2009-04-23 18:31:44 UTC
State Changed
From-To: patched->closed

MFCs done. Thanks!