From owner-freebsd-doc@FreeBSD.ORG Thu Apr 16 17:40:07 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 69DDC1065670 for ; Thu, 16 Apr 2009 17:40:07 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 402AD8FC24 for ; Thu, 16 Apr 2009 17:40:07 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n3GHe7uf054025 for ; Thu, 16 Apr 2009 17:40:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n3GHe7Y8054024; Thu, 16 Apr 2009 17:40:07 GMT (envelope-from gnats) Resent-Date: Thu, 16 Apr 2009 17:40:07 GMT Resent-Message-Id: <200904161740.n3GHe7Y8054024@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Ulrich Spoerlein 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 X-Mailman-Approved-At: Thu, 16 Apr 2009 21:20:39 +0000 Cc: re@FreeBSD.org Subject: docs/133785: [PATCH] man pages lying about HISTORY X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Apr 2009 17:40:08 -0000 >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: