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: docs/133785: [PATCH] man pages lying about HISTORY Message-ID: <200904161732.n3GHWYOb060540@roadrunner.spoerlein.net> Resent-Message-ID: <200904161740.n3GHe7Y8054024@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200904161732.n3GHWYOb060540>