Date: Fri, 12 Apr 2002 17:40:59 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Philippe Charnier <charnier@FreeBSD.org> Cc: doc@FreeBSD.org Subject: Re: cvs commit: src/usr.bin/make job.c main.c make.1 Message-ID: <20020412144059.GA47739@sunbay.com> In-Reply-To: <200204121323.g3CDNYO71020@freefall.freebsd.org> References: <200204121323.g3CDNYO71020@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--k1lZvvs/B4yU6o8G Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Apr 12, 2002 at 06:23:34AM -0700, Philippe Charnier wrote: > charnier 2002/04/12 06:23:34 PDT >=20 > Modified files: > usr.bin/make job.c main.c make.1=20 > Log: [...] > =20 > Use .Pa and .Ar. Uppercase (first letter) programname after dot. > =20 > Revision Changes Path [...] > 1.49 +18 -14 src/usr.bin/make/make.1 >=20 Uppercasing program name is bogus, please don't do that. Program names should appear exactly as typed. An alternate approach is to use this idiom: The =2ENm program For make(1) that would be: =2ESh NAME =2ENm make =2E.. =2ESh DESCRIPTION The =2ENm program is designed to simplify ... Also, the below change is incorrect: : .It Fl f Ar makefile : -Specify a makefile to read instead of the default : +Specify a : +.Ar makefile : +to read instead of the default : .Ql Pa makefile : and : .Ql Pa Makefile . For example, the reader might want what does "make -f foo" means. This now gives him: -f foo Specify a "foo" to read instead of the default "makefile" and "Makefile". IOW, we are talking about "a makefile" here, not "the makefile". In this context this would be right: : .It Fl f Ar makefile : Specify that the : .Ar makefile : file should be read instead of the default : .Ql Pa makefile : and : .Ql Pa Makefile . Cheers, --=20 Ruslan Ermilov Sysadmin and DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --k1lZvvs/B4yU6o8G Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iD8DBQE8tvH7Ukv4P6juNwoRAk6HAKCL1Wkvo+QYvrCDGXx7oBgQTyUoSQCgiO9n 8pKXviInzlNgbBFt05IJ1Yw= =TYZK -----END PGP SIGNATURE----- --k1lZvvs/B4yU6o8G-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020412144059.GA47739>