From owner-freebsd-ports@FreeBSD.ORG Thu Jul 22 14:49:33 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 60D851065673 for ; Thu, 22 Jul 2010 14:49:33 +0000 (UTC) (envelope-from sterling@camdensoftware.com) Received: from wh2.interactivevillages.com (wh2.interactivevillages.com [75.125.250.34]) by mx1.freebsd.org (Postfix) with ESMTP id 252878FC1B for ; Thu, 22 Jul 2010 14:49:32 +0000 (UTC) Received: from 174-21-99-21.tukw.qwest.net ([174.21.99.21] helo=_HOSTNAME_) by wh2.interactivevillages.com with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.69) (envelope-from ) id 1Obwtr-00066I-5P for freebsd-ports@freebsd.org; Thu, 22 Jul 2010 07:37:28 -0700 Received: by _HOSTNAME_ (sSMTP sendmail emulation); Thu, 22 Jul 2010 07:49:27 -0700 Date: Thu, 22 Jul 2010 07:49:27 -0700 From: Chip Camden To: freebsd-ports@freebsd.org Message-ID: <20100722144927.GA75486@libertas.local.camdensoftware.com> Mail-Followup-To: freebsd-ports@freebsd.org References: <4C42CFDA.3040409@comclark.com> <4C42D292.208@infracaninophile.co.uk> <4C4388D2.30200@comclark.com> <20100720190602.GA32624@server.vk2pj.dyndns.org> <4C465E14.1060300@comclark.com> <20100722090152.222b8f77@scorpio> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="G4iJoqBmSsgzjUCe" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.4.2.3i Company: Camden Software Consulting URL: http://camdensoftware.com X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - wh2.interactivevillages.com X-AntiAbuse: Original Domain - freebsd.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - camdensoftware.com 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: Thu, 22 Jul 2010 14:49:33 -0000 --G4iJoqBmSsgzjUCe Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Quoth Janne Snabb on Thursday, 22 July 2010: > On Thu, 22 Jul 2010, Jerry wrote: >=20 > >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 when you > >started out. >=20 > >=20 > I think there should be also a comment in addition to the backticks > issue that one should press ENTER key after they have successfully > entered all the required characters. This way we can teach all the > UNIX basics in one single document "The Porters Handbook" and will > have a tremendous success attracting people to learn UNIX by > submitting broken ports and asking basic questions on this mailing > list. >=20 > >=20 > PS. Flame me if you like. >=20 There are places to teach basic shell scripting, but the Porter's Handbook is not one of them, IMHO. Perhaps a "(note the backticks)" is appropriate for a web-based document because of potential font mangling, but I'd stick with the version of the command that's most universally applicable rather than the most readable. --=20 Sterling (Chip) Camden | sterling@camdensoftware.com | 2048D/3A978E4F http://camdensoftware.com | http://chipstips.com | http://chipsquips= .com --G4iJoqBmSsgzjUCe Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.10 (FreeBSD) iQEcBAEBAgAGBQJMSFp3AAoJEIpckszW26+RhGwIAIW413N+M5kygLUiElkV760A lWoa43oCfhT0QjKCgZssQoIUnv85GBHPV6NTNmVKhpqhZfzRbtotp52en9Umvx8B XjHko5Ck/ZdJf7olbsgnhIz2Bj+AzfMQb4BUYj4dqJ+OxbnKePbxphLPCiqvrL0q 3OmsQxOUVJtoA/tIQ128AhMqU9dvkNw94FCQk+ezKELqlCHEOI9FbzuIHrgp0CVp WKwUvqCdFbrtE006bsrV2S6CZ0jtfrriI66DF4Kmr2yuvlQjxrq1oEn5nQUwu5Zi d2hRAP+/LhX0OObYGH8nw9R37pybloIezz3h9nEIXQ4jam94Z+2VmuV83+X4GCg= =wWMW -----END PGP SIGNATURE----- --G4iJoqBmSsgzjUCe--