[new port] usage of shar command

[Peter Jeremy]

On 2010-Jul-19 02:19:33 +0000, Janne Snabb <snabb at 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 
>> 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.

-- 
Peter Jeremy
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 196 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/freebsd-ports/attachments/20100720/1b29fad8/attachment.pgp