docs/133785: [PATCH] man pages lying about HISTORY
Ulrich Spoerlein
uqs at spoerlein.net
Thu Apr 16 17:40:08 UTC 2009
>Number: 133785
>Category: docs
>Synopsis: [PATCH] man pages lying about HISTORY
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Thu Apr 16 17:40:06 UTC 2009
>Closed-Date:
>Last-Modified:
>Originator: Ulrich Spörlein
>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:
>Unformatted:
More information about the freebsd-doc
mailing list