Prev: [new port] usage of shar command
Next: apache22 imap "ssl_onceonlyinit" error following latest upgrades
From: Eric on 21 Jul 2010 05:17 >>> 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 21 Jul 2010 08:56 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 21 Jul 2010 09:31 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 21 Jul 2010 09:44 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 21 Jul 2010 09:45
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" |