[new port] usage of shar command

[Joe]

Doug Barton wrote:
> On Wed, 21 Jul 2010, Peter Jeremy wrote:
> 
>> 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.
> 
> That's a fair point. Do you think that the text as it currently exists 
> is sufficiently clear, or do you think that it still needs the 
> modification you're suggesting? I'm happy to make the change (or someone 
> else can if they so desire) if that's what people thing is the right way 
> to go.
> 
> 
> Doug
> 
The text as its currently exists is a long way from being clear to a 
first timer. And I am talking about the new change that just went in.

"shar `find port_dir` (note the backticks)",

or

"shar $(find port_dir)"

both address the problem nicely.

By all means go and make the correction.