From owner-cvs-src@FreeBSD.ORG Thu Feb 10 08:33:21 2005 Return-Path: Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 736F516A4CE; Thu, 10 Feb 2005 08:33:21 +0000 (GMT) Received: from tigra.ip.net.ua (tigra.ip.net.ua [82.193.96.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 963AC43D39; Thu, 10 Feb 2005 08:33:20 +0000 (GMT) (envelope-from ru@ip.net.ua) Received: from localhost (rocky.ip.net.ua [82.193.96.2]) by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id j1A8XJ7v002656; Thu, 10 Feb 2005 10:33:19 +0200 (EET) (envelope-from ru@ip.net.ua) Received: from tigra.ip.net.ua ([82.193.96.10]) by localhost (rocky.ipnet [82.193.96.2]) (amavisd-new, port 10024) with LMTP id 23622-16; Thu, 10 Feb 2005 10:33:18 +0200 (EET) Received: from heffalump.ip.net.ua (heffalump.ip.net.ua [82.193.96.213]) by tigra.ip.net.ua (8.12.11/8.12.11) with ESMTP id j1A8XIKX002652 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 10 Feb 2005 10:33:18 +0200 (EET) (envelope-from ru@ip.net.ua) Received: (from ru@localhost) by heffalump.ip.net.ua (8.13.1/8.13.1) id j1A8XJ5R050142; Thu, 10 Feb 2005 10:33:19 +0200 (EET) (envelope-from ru) Date: Thu, 10 Feb 2005 10:33:19 +0200 From: Ruslan Ermilov To: Bruce Evans Message-ID: <20050210083319.GB43466@ip.net.ua> References: <200502091807.j19I7HrO003008@repoman.freebsd.org> <20050209214537.GY18759@submonkey.net> <20050210142452.R28116@delplex.bde.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="PmA2V3Z32TCmWXqI" Content-Disposition: inline In-Reply-To: <20050210142452.R28116@delplex.bde.org> User-Agent: Mutt/1.5.6i X-Virus-Scanned: by amavisd-new at ip.net.ua cc: cvs-src@freebsd.org cc: Ceri Davies cc: src-committers@freebsd.org cc: cvs-all@freebsd.org Subject: Re: cvs commit: src/share/examples/ses/getencstat getencstat.0 src/share/examples/ses/sesd sesd.0 src/share/examples/ses/setencstat setencstat.0 src/share/examples/ses/setobjstat setobjstat.0 src/shar X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 10 Feb 2005 08:33:21 -0000 --PmA2V3Z32TCmWXqI Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Feb 10, 2005 at 03:02:49PM +1100, Bruce Evans wrote: > On Wed, 9 Feb 2005, Ceri Davies wrote: >=20 > > On Wed, Feb 09, 2005 at 06:07:17PM +0000, Ruslan Ermilov wrote: > > > ru 2005-02-09 18:07:17 UTC > > > > > > FreeBSD src repository > > > > > > Modified files: > > > ... > > > share/man/man9 VOP_ACLCHECK.9 acl.9 microtime.9 mutex.9 > > > style.9 tvtohz.9 vfs_unmountall.9 > ^^^^^^^ > > > Log: > > > Fixed the misplaced $FreeBSD$. > > > > style(9) doesn't say anything about this - could you add something > > please? >=20 It actually does. Manpages are similar to C header files in this respect, i.e., the following apply, among other: - after a copyright header, there's a blank line, and then $FreeBSD$; - $FreeBSD$ should exist only once, except in the style.9 manpage; - keep and do not edit foreign IDs. > style.9 says a lot about this for C programs, and used to say something > about this for man pages by example: $FreeBSD$ goes immediately after > the vendor id. >=20 Except it actually says to put $FreeBSD$ after a copyright block, and do not edit/move foreign IDs, so in case if the vendor ID was put before copyright block, I kept it there, and just placed $FreeBSD$ where it belongs according to style(9) and template manpages (/usr/share/examples/mdoc/). > However, the example doesn't obviously apply to man > pages because it is in a form suitable for C headers (a C comment), >=20 The C headers example in style(9) fits nicely with manpages. > though it was intended to be a self-referential example for the man > page itself. >=20 It's hard to guess, as manpages use different style of comments. > The vendor id in it had to be misplaced to not set a bad > example by moving the vendor id, >=20 You mean misplaced in the manpage's source? > and the $FreeBSD$ in it had to be > misplaced to not set a bad example by placing it elsewhere than after > the vendor id. >=20 You mean misplaced in the manpage's source? > Now there is another buggy example in the comment at the top of the > man page. The new bugs are not having the vendor id there, and > incompleteness -- the example can only be seen by reading the source > file. >=20 Well, the copyright is also not that of the vendor, either. ;) > style.9 is special since it has to give self-referential examples. It > needs at least 1 more $FreeBSD$ and 1 or 2 more vendor ids to obviously > cover man pages: > - a literal vendor id and $FreeBSD$ pair in the form of a man page comment >=20 I think this is not necessary. Manpage example can be viewed by viewing the style.9 source. This is pretty self-referential. ;) > - maybe another vendor id before the $FreeBSD$ in the comment at the top > of the man page. This is not quite right because style.9 isn't really > a man page and the vendor didn't put the id there. >=20 It should be as per style(9): %%% Index: style.9 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/src/share/man/man9/style.9,v retrieving revision 1.117 diff -u -p -r1.117 style.9 --- style.9 9 Feb 2005 18:07:17 -0000 1.117 +++ style.9 10 Feb 2005 08:30:19 -0000 @@ -23,9 +23,10 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" From: @(#)style 1.14 (Berkeley) 4/28/95 .\" $FreeBSD: src/share/man/man9/style.9,v 1.117 2005/02/09 18:07:17 ru Ex= p $ .\" -.Dd December 7, 2001 +.Dd February 10, 2005 .Dt STYLE 9 .Os .Sh NAME %%% Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --PmA2V3Z32TCmWXqI Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (FreeBSD) iD8DBQFCCxxPqRfpzJluFF4RAp6hAKCZnyEw0lAOVQfGrZt/aW8yamrdnACdExkS MNs/8AdHjz45osXYWUhNNp0= =54tZ -----END PGP SIGNATURE----- --PmA2V3Z32TCmWXqI--