From owner-freebsd-ports@FreeBSD.ORG Mon Jul 19 00:07:44 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 04A3A106567D for ; Mon, 19 Jul 2010 00:07:44 +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 932DB8FC08 for ; Mon, 19 Jul 2010 00:07:43 +0000 (UTC) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AsMVAE8zQ0zKRaxEPGdsb2JhbAAHky+MRAEBAQE1viiFJQSDfocZ X-IronPort-AV: E=Sophos;i="4.55,224,1278259200"; d="scan'208";a="13841107" Received: from unknown (HELO [10.0.10.3]) ([202.69.172.68]) by avmxsmtp2.comclark.com with ESMTP; 19 Jul 2010 08:07:42 +0800 Message-ID: <4C43974C.1090006@comclark.com> Date: Mon, 19 Jul 2010 08:07:40 +0800 From: Joe User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: freebsd-ports@freebsd.org References: <4C42CFDA.3040409@comclark.com> <4C42D292.208@infracaninophile.co.uk> <4C4388D2.30200@comclark.com> <20100718232645.GD93366@libertas.local.camdensoftware.com> In-Reply-To: <20100718232645.GD93366@libertas.local.camdensoftware.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit 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: Mon, 19 Jul 2010 00:07:44 -0000 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.