From: Eric on
>>> 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.

I'd second making it clearer, certainly: shar `find port_dir` threw me when
I first started writing ports and was looking to submit my work. I think
part of the issue was just I'd never used the shell archive command before
so I had no idea quite what 'shar' actually was. Perhaps adding a one liner
to explain what is actually going to happen and why your doing it might be
useful?

Personally I think the second suggestion of "shar $(find port_dir)" is the
better one, it's far less likely to get mangled by font display and I expect
it's easier for people to located $() on their keyboards than ` (backtick)

Regards

Eric


_______________________________________________
freebsd-ports(a)freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"

From: Dominic Fandrey on
On 21/07/2010 04:40, Joe wrote:
> 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)"

This one doesn't work in (t)csh, the backticks do.

> both address the problem nicely.
>
> By all means go and make the correction.

Object!


Regards

--
A: Because it fouls the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: Top-posting.
Q: What is the most annoying thing on usenet and in e-mail?
_______________________________________________
freebsd-ports(a)freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"

From: Sean on

On 21/07/2010, at 10:56 PM, Dominic Fandrey wrote:

> On 21/07/2010 04:40, Joe wrote:
>> 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)"
>
> This one doesn't work in (t)csh, the backticks do.
>
>> both address the problem nicely.
>>
>> By all means go and make the correction.
>
> Object!
>


find port_dir -print0 | xargs -0 -x shar

Though it doesn't help when you've got too many files. Then you're probably better off with the tar command to generate shar files.

>
> Regards
>
> --
> A: Because it fouls the order in which people normally read text.
> Q: Why is top-posting such a bad thing?
> A: Top-posting.
> Q: What is the most annoying thing on usenet and in e-mail?
> _______________________________________________
> freebsd-ports(a)freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-ports
> To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"

_______________________________________________
freebsd-ports(a)freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"

From: Dominic Fandrey on
On 21/07/2010 15:31, Sean wrote:
>
> On 21/07/2010, at 10:56 PM, Dominic Fandrey wrote:
>
>> On 21/07/2010 04:40, Joe wrote:
>>> 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)"
>>
>> This one doesn't work in (t)csh, the backticks do.
>>
>>> both address the problem nicely.
>>>
>>> By all means go and make the correction.
>>
>> Object!
>>
>
>
> find port_dir -print0 | xargs -0 -x shar
>
> Though it doesn't help when you've got too many files. Then you're probably better off with the tar command to generate shar files.

I know how to use shar. :) But I think the Handbook should have
examples that work in the default shell.

Regards

--
A: Because it fouls the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: Top-posting.
Q: What is the most annoying thing on usenet and in e-mail?
_______________________________________________
freebsd-ports(a)freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"

From: Anonymous on
Sean <sean(a)gothic.net.au> writes:

>>> 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)"
>>
>> This one doesn't work in (t)csh, the backticks do.
>>
>>> both address the problem nicely.
>>>
>>> By all means go and make the correction.
>>
>> Object!
>>
>
> find port_dir -print0 | xargs -0 -x shar
>
> Though it doesn't help when you've got too many files. Then you're probably better off with the tar command to generate shar files.

BTW, do we still have *supported* release where tar(1) can't create shar archives?
_______________________________________________
freebsd-ports(a)freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscribe(a)freebsd.org"