From: Chip Camden on
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 author was trying to say with
> >>"output of shar `find port_dir`"
> >>
> >>Can someone explain how the shar command is intended to be used to
> >>create the file that gets send with the [new port] pr?
> >
> >Suppose you have called your new port "splat", and you have therefore a
> >directory ~/splat containing the port Makefile, distinfo, pkg-descr,
> >etc. Then what you need to do is run exactly this:
> >
> > % cd ~
> > % shar `find splat` > splat.shar
> >
> >Note the special `backticks` -- they're important.
> >
> >What this does is --
> >
> > * Runs the command: find splat
> > This will print out a list of all the file and directory names
> > under the directory splat.
> > * Takes that list and turns it into part of the command line for
> > shar.
> > * Runs shar over all the files and directories found by find.
> >
> >Now, just attach that splat.shar file to the PR (send-pr -a splat.shar)
> >as the final step in submitting your new port.
> >
> > Cheers,
> >
> > Matthew
>
> 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.
>
The handbook shows backticks, at least in my browser:

http://www.freebsd.org/doc/en/books/porters-handbook/porting-submitting.html
>

--
Sterling (Chip) Camden | sterling(a)camdensoftware.com | 2048D/3A978E4F
http://camdensoftware.com | http://chipstips.com | http://chipsquips..com
From: Joe on
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 author was trying to say with
>>>> "output of shar `find port_dir`"
>>>>
>>>> Can someone explain how the shar command is intended to be used to
>>>> create the file that gets send with the [new port] pr?
>>> Suppose you have called your new port "splat", and you have therefore a
>>> directory ~/splat containing the port Makefile, distinfo, pkg-descr,
>>> etc. Then what you need to do is run exactly this:
>>>
>>> % cd ~
>>> % shar `find splat` > splat.shar
>>>
>>> Note the special `backticks` -- they're important.
>>>
>>> What this does is --
>>>
>>> * Runs the command: find splat
>>> This will print out a list of all the file and directory names
>>> under the directory splat.
>>> * Takes that list and turns it into part of the command line for
>>> shar.
>>> * Runs shar over all the files and directories found by find.
>>>
>>> Now, just attach that splat.shar file to the PR (send-pr -a splat.shar)
>>> as the final step in submitting your new port.
>>>
>>> Cheers,
>>>
>>> Matthew
>> 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.
>>
> The handbook shows backticks, at least in my browser:
>
> http://www.freebsd.org/doc/en/books/porters-handbook/porting-submitting.html
>
And like I said, stating that in words calls it to the attention of the
reader.
_______________________________________________
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: Doug Barton on
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 mentioning the backticks explicitly.
Hopefully the text as modified will be clear enough without going to
that extreme.

In any case, thanks for expressing your confusion, it's actually really
helpful to get information from the perspective of a new user.


Regards,

Doug

--

Improve the effectiveness of your Internet presence with
a domain name makeover! http://SupersetSolutions.com/

Computers are useless. They can only give you answers.
-- Pablo Picasso

_______________________________________________
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: Janne Snabb on
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.

--
Janne Snabb / EPIPE Communications
snabb(a)epipe.com - http://epipe.com/
_______________________________________________
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: Joe on
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 would be familiar
> with the elementary basics of shell syntax.
>
> --
> Janne Snabb / EPIPE Communications
> snabb(a)epipe.com - http://epipe.com/
> _______________________________________________
> 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"
>
>
Well your assumption is wrong. There will always be first timers.
_______________________________________________
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"