From owner-freebsd-ports@FreeBSD.ORG Sun Jul 18 23:05:58 2010 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EC1E3106566C for ; Sun, 18 Jul 2010 23:05:58 +0000 (UTC) (envelope-from joeb_722@comclark.com) Received: from avmxsmtp3.comclark.com (avmxsmtp3.comclark.com [202.69.191.117]) by mx1.freebsd.org (Postfix) with ESMTP id 870808FC0C for ; Sun, 18 Jul 2010 23:05:58 +0000 (UTC) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AsQUAD4lQ0zKRaxEPGdsb2JhbAAHgxeEUpgJAQEBATWtWpAxgSmDCXMEg36HGQ X-IronPort-AV: E=Sophos;i="4.55,224,1278259200"; d="scan'208";a="13839310" Received: from unknown (HELO [10.0.10.3]) ([202.69.172.68]) by avmxsmtp2.comclark.com with ESMTP; 19 Jul 2010 07:05:56 +0800 Message-ID: <4C4388D2.30200@comclark.com> Date: Mon, 19 Jul 2010 07:05:54 +0800 From: Joe User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: Matthew Seaman References: <4C42CFDA.3040409@comclark.com> <4C42D292.208@infracaninophile.co.uk> In-Reply-To: <4C42D292.208@infracaninophile.co.uk> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-ports@freebsd.org Subject: Re: [new port] usage of shar command X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2010 23:05:59 -0000 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. Thank you Matthew for pointing this out. That was the problem I was having.