From owner-freebsd-ports@FreeBSD.ORG  Tue Jul 20 19:06:21 2010
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 25FDA106566B
	for <freebsd-ports@freebsd.org>; Tue, 20 Jul 2010 19:06:21 +0000 (UTC)
	(envelope-from peterjeremy@acm.org)
Received: from mail13.syd.optusnet.com.au (mail13.syd.optusnet.com.au
	[211.29.132.194])
	by mx1.freebsd.org (Postfix) with ESMTP id A98F48FC1F
	for <freebsd-ports@freebsd.org>; Tue, 20 Jul 2010 19:06:20 +0000 (UTC)
Received: from server.vk2pj.dyndns.org
	(c211-30-160-13.belrs4.nsw.optusnet.com.au [211.30.160.13])
	by mail13.syd.optusnet.com.au (8.13.1/8.13.1) with ESMTP id
	o6KJ63ix006150
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Wed, 21 Jul 2010 05:06:05 +1000
X-Bogosity: Ham, spamicity=0.000000
Received: from server.vk2pj.dyndns.org (localhost.vk2pj.dyndns.org [127.0.0.1])
	by server.vk2pj.dyndns.org (8.14.4/8.14.4) with ESMTP id o6KJ63rL032803;
	Wed, 21 Jul 2010 05:06:03 +1000 (EST)
	(envelope-from peter@server.vk2pj.dyndns.org)
Received: (from peter@localhost)
	by server.vk2pj.dyndns.org (8.14.4/8.14.4/Submit) id o6KJ62vP032802;
	Wed, 21 Jul 2010 05:06:02 +1000 (EST) (envelope-from peter)
Date: Wed, 21 Jul 2010 05:06:02 +1000
From: Peter Jeremy <peterjeremy@acm.org>
To: Janne Snabb <snabb@epipe.com>
Message-ID: <20100720190602.GA32624@server.vk2pj.dyndns.org>
References: <4C42CFDA.3040409@comclark.com>
	<4C42D292.208@infracaninophile.co.uk> <4C4388D2.30200@comclark.com>
	<alpine.BSF.2.00.1007190216290.9805@tiktik.epipe.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="J2SCkAp4GZ/dPZZf"
Content-Disposition: inline
In-Reply-To: <alpine.BSF.2.00.1007190216290.9805@tiktik.epipe.com>
X-PGP-Key: http://members.optusnet.com.au/peterjeremy/pubkey.asc
User-Agent: Mutt/1.5.20 (2009-06-14)
Cc: Joe <joeb_722@comclark.com>, freebsd-ports@freebsd.org
Subject: Re: [new port] usage of shar command
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 20 Jul 2010 19:06:21 -0000


--J2SCkAp4GZ/dPZZf
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On 2010-Jul-19 02:19:33 +0000, Janne Snabb <snabb@epipe.com> wrote:
>On Mon, 19 Jul 2010, Joe wrote:
>
>> This needs to be in the handbook. How is anybody going to know that the
>> `find port_dir` is suppose to be enclosed by [`backticks`]. I has to be =
said=20
>> in words not just a printed example.
>
>I would have assumed that anyone who submits a port would be familiar
>with the elementary basics of shell syntax.

The major problems with backticks is that they tend to be inconspicuous
(and easily confused with bits of dust or fly-droppings) and are often
difficult to distinguish from quotes.

Rather than write "`find port_dir` (note the backticks)", IMO, it is
far easier to write $(find port_dir) - which is syntactically the
same but visually more obvious.

--=20
Peter Jeremy

--J2SCkAp4GZ/dPZZf
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.15 (FreeBSD)

iEYEARECAAYFAkxF85oACgkQ/opHv/APuIc6zACdHk8CZppm3k18+wKLHfr8OcSB
CaAAnirMa56MUjEWzNElzQg+YIxWZwBO
=2Khw
-----END PGP SIGNATURE-----

--J2SCkAp4GZ/dPZZf--