Re: [new port] usage of shar command

2010-07-18 Thread Johan van Selst
Joe wrote: > I can not figure out just what the author was trying to say with > "output of shar `find port_dir`" If your port files are stored in the subdirectory 'newport' then you may issue the command shar `find newport` > file.shar This creates the 'file.shar' file, which contains a s

Re: [new port] usage of shar command

2010-07-18 Thread Matthew Seaman
On 18/07/2010 10:56:42, Joe wrote: > After getting my port ready for submitting to the ports system, I read > the above section from the porters handbook and come to a show stopper. > > I can not figure out just what the author was trying to say with > "output of shar `find port_dir`" > > Can so

Re: [new port] usage of shar command

2010-07-18 Thread Anonymous
Johan van Selst writes: > Joe wrote: >> I can not figure out just what the author was trying to say with >> "output of shar `find port_dir`" > > If your port files are stored in the subdirectory 'newport' then > you may issue the command > shar `find newport` > file.shar Another way is to

Re: [new port] usage of shar command

2010-07-18 Thread Chip Camden
Quoth Anonymous on Sunday, 18 July 2010: > Johan van Selst writes: > > > Joe wrote: > >> I can not figure out just what the author was trying to say with > >> "output of shar `find port_dir`" > > > > If your port files are stored in the subdirectory 'newport' then > > you may issue the command >

Re: [new port] usage of shar command

2010-07-18 Thread Joe
Matthew Seaman wrote: On 18/07/2010 10:56:42, Joe wrote: After getting my port ready for submitting to the ports system, I read the above section from the porters handbook and come to a show stopper. I can not figure out just what the author was trying to say with "output of shar `find port_di

Re: [new port] usage of shar command

2010-07-18 Thread Chip Camden
Quoth Joe on Monday, 19 July 2010: > Matthew Seaman wrote: > >On 18/07/2010 10:56:42, Joe wrote: > > > >>After getting my port ready for submitting to the ports system, I read > >>the above section from the porters handbook and come to a show stopper. > >> > >>I can not figure out just what the aut

Re: [new port] usage of shar command

2010-07-18 Thread Joe
Chip Camden wrote: Quoth Joe on Monday, 19 July 2010: Matthew Seaman wrote: On 18/07/2010 10:56:42, Joe wrote: After getting my port ready for submitting to the ports system, I read the above section from the porters handbook and come to a show stopper. I can not figure out just what the aut

Re: [new port] usage of shar command

2010-07-18 Thread Doug Barton
On 07/18/10 02:56, Joe wrote: > I can not figure out just what the author was trying to say with > "output of shar `find port_dir`" I just committed what is hopefully an improvement to the documentation for that. It should hit the web site in a couple hours. FWIW, I saw your followup about mentio

Re: [new port] usage of shar command

2010-07-18 Thread Janne Snabb
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

Re: [new port] usage of shar command

2010-07-18 Thread Joe
Janne Snabb 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 wou

Re: [new port] usage of shar command

2010-07-18 Thread Doug Barton
On 07/18/10 19:47, Joe wrote: > There will always be first timers. We all started somewhere. :) Doug -- Improve the effectiveness of your Internet presence with a domain name makeover!http://SupersetSolutions.com/ Computers are useless. They can only give you answ

Re: [new port] usage of shar command

2010-07-19 Thread RW
On Sun, 18 Jul 2010 19:17:38 -0700 Doug Barton wrote: > In any case, thanks for expressing your confusion, it's actually > really helpful to get information from the perspective of a new user. I wonder how many new users have read the bugs section of the shar man page, and know how to check suc

Re: [new port] usage of shar command

2010-07-19 Thread Anonymous
RW writes: > On Sun, 18 Jul 2010 19:17:38 -0700 > Doug Barton wrote: >> In any case, thanks for expressing your confusion, it's actually >> really helpful to get information from the perspective of a new user. > > I wonder how many new users have read the bugs section of the shar man > page, and

Re: [new port] usage of shar command

2010-07-19 Thread RW
On Mon, 19 Jul 2010 18:07:14 +0400 Anonymous wrote: > RW writes: > > > On Sun, 18 Jul 2010 19:17:38 -0700 > > Doug Barton wrote: > >> In any case, thanks for expressing your confusion, it's actually > >> really helpful to get information from the perspective of a new > >> user. > > > > I wonde

Re: [new port] usage of shar command

2010-07-19 Thread Anonymous
RW writes: > I don't think that's right. When I used shar to submit an update to an > unmaintained port, I was asked to use diff for updates and shar for > new ports. I was referring more to [new port] PRs. Besides, diffs are natural to any VCS unlike shars. > Incidently shar(1) suggests run

Re: [new port] usage of shar command

2010-07-19 Thread Doug Barton
On Mon, 19 Jul 2010, RW wrote: Am I the only one that thinks it's odd that in 2010 we're still using executable scripts to distribute text files? How would you do it differently? Doug -- Improve the effectiveness of your Internet presence with a domain name makeover!htt

Re: [new port] usage of shar command

2010-07-19 Thread Anonymous
Doug Barton writes: > On Mon, 19 Jul 2010, RW wrote: > >> Am I the only one that thinks it's odd that in 2010 we're still using >> executable scripts to distribute text files? > > How would you do it differently? $ diff -upNr /nonexistent mynewport And if you have CVS checkout around $ cd

Re: [new port] usage of shar command

2010-07-20 Thread Peter Jeremy
On 2010-Jul-19 02:19:33 +, Janne Snabb 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 a

Re: [new port] usage of shar command

2010-07-20 Thread Doug Barton
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

Re: [new port] usage of shar command

2010-07-20 Thread 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 backtick

Re: [new port] usage of shar command

2010-07-21 Thread Eric
>>> 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 $(fi

Re: [new port] usage of shar command

2010-07-21 Thread Dominic Fandrey
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. >>> >>

Re: [new port] usage of shar command

2010-07-21 Thread Sean
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) a

Re: [new port] usage of shar command

2010-07-21 Thread Dominic Fandrey
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 co

Re: [new port] usage of shar command

2010-07-21 Thread Anonymous
Sean 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

Re: [new port] usage of shar command

2010-07-22 Thread Frank J. Laszlo
Joe wrote: 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 correct

Re: [new port] usage of shar command

2010-07-22 Thread Jerry
On Thu, 22 Jul 2010 08:00:47 -0400 Frank J. Laszlo articulated: > I'm not trying to attack the OP, but I wanted to voice my objection for > dumbing down the handbook to the point that a 3 year old could figure it > out. OK, so what age should we use for the cutoff limit? By the way, age is an

Re: [new port] usage of shar command

2010-07-22 Thread Janne Snabb
On Thu, 22 Jul 2010, Jerry wrote: Then again, perhaps we should just remove the handbook all together and let everyone figure it out for themselves. No dumbing down at all required. We certainly would not want to over do the 'friendly' concept. I suppose some of use, you obviously, knew it all w

Re: [new port] usage of shar command

2010-07-22 Thread Chip Camden
Quoth Janne Snabb on Thursday, 22 July 2010: > On Thu, 22 Jul 2010, Jerry wrote: > > >Then again, perhaps we should just remove the handbook all together and > >let everyone figure it out for themselves. No dumbing down at all > >required. We certainly would not want to over do the 'friendly' > >c

Re: [new port] usage of shar command

2010-07-22 Thread Doug Barton
We don't support flamewars on FreeBSD lists, so I'm going to ask everyone to simply stop posting on this thread. The OP had a good point in that the PH text was not as clear as it could be. I think I've made an improvement to it, and I'm sensitive to the argument that $() is not portable, so w

Re: [new port] usage of shar command

2010-07-22 Thread Johan van Selst
Anonymous wrote: > >> Am I the only one that thinks it's odd that in 2010 we're still using > >> executable scripts to distribute text files? > > How would you do it differently? > $ diff -upNr /nonexistent mynewport I quite like this solution. It's a simple command, very similar to what's used