From owner-freebsd-doc  Fri Apr 12  7:41:19 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65])
	by hub.freebsd.org (Postfix) with ESMTP
	id 0C6B537B416; Fri, 12 Apr 2002 07:41:06 -0700 (PDT)
Received: (from ru@localhost)
	by whale.sunbay.crimea.ua (8.11.6/8.11.2) id g3CEexG49203;
	Fri, 12 Apr 2002 17:40:59 +0300 (EEST)
	(envelope-from ru)
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>
References: <200204121323.g3CDNYO71020@freefall.freebsd.org>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="k1lZvvs/B4yU6o8G"
Content-Disposition: inline
In-Reply-To: <200204121323.g3CDNYO71020@freefall.freebsd.org>
User-Agent: Mutt/1.3.27i
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


--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