From owner-freebsd-ports@FreeBSD.ORG Mon Dec 5 10:29:25 2005 Return-Path: X-Original-To: ports@FreeBSD.org Delivered-To: freebsd-ports@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BC98416A41F; Mon, 5 Dec 2005 10:29:25 +0000 (GMT) (envelope-from Alexander@Leidinger.net) Received: from www.ebusiness-leidinger.de (jojo.ms-net.de [84.16.236.246]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0BEDA43D6B; Mon, 5 Dec 2005 10:29:23 +0000 (GMT) (envelope-from Alexander@Leidinger.net) Received: from Andro-Beta.Leidinger.net (p54A5D103.dip.t-dialin.net [84.165.209.3]) (authenticated bits=0) by www.ebusiness-leidinger.de (8.13.1/8.13.1) with ESMTP id jB5A1nVu064382; Mon, 5 Dec 2005 11:01:50 +0100 (CET) (envelope-from Alexander@Leidinger.net) Received: from localhost (localhost [127.0.0.1]) by Andro-Beta.Leidinger.net (8.13.3/8.13.3) with ESMTP id jB5ATIge097721; Mon, 5 Dec 2005 11:29:18 +0100 (CET) (envelope-from Alexander@Leidinger.net) Received: from pslux.cec.eu.int (pslux.cec.eu.int [158.169.9.14]) by webmail.leidinger.net (Horde MIME library) with HTTP; Mon, 05 Dec 2005 11:29:18 +0100 Message-ID: <20051205112918.4x1fceccg0k8wssk@netchild.homeip.net> X-Priority: 3 (Normal) Date: Mon, 05 Dec 2005 11:29:18 +0100 From: Alexander Leidinger To: pav@FreeBSD.org References: <20051204151945.29aae42d@Magellan.Leidinger.net> <4393913E.3020902@FreeBSD.org> <20051205094053.50p5wfogg8g4404o@netchild.homeip.net> <1133775145.59675.15.camel@pav.hide.vol.cz> In-Reply-To: <1133775145.59675.15.camel@pav.hide.vol.cz> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format="flowed" Content-Disposition: inline Content-Transfer-Encoding: quoted-printable User-Agent: Internet Messaging Program (IMP) H3 (4.0.3) / FreeBSD-4.11 X-Virus-Scanned: by amavisd-new Cc: ports@FreeBSD.org, Adam Weinberger Subject: Re: Proposal for an additional (sub)section in the porters handbook 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, 05 Dec 2005 10:29:25 -0000 Pav Lucistnik wrote: > Alexander Leidinger p=C3=ADse v po 05. 12. 2005 v 09:40 +0100: >> Adam Weinberger wrote: >> > Alexander Leidinger wrote: > >> >> Some maintainers prefer to use install-time plists. While the use of >> >> them is not forbitten, maintainers have to use commit-time plists >> >> wherever possible. >> > >> > See, as soon as you use "have to", you've negated any purpose of your >> > addition past political rhetoric. The entire thing could be shortened >> >> Ah! Pav, did you referenced to this as being "political" as well? I thou= ght >> you talked about the "benefits"-list. Ok, I will change this. > > Possibly. > > I have an experience that every extra sentence equals to a percentage of > readers not reading the text at all. Thus, I prefer to keep the texts in > Porter's Handbook down to the minimum, while saying everything > important. > > Think law book. You don't justify the rules in the law book. You just > say this will be done, this can be done, this is prohibited. Uhm... now I don't know where to go. If we talk about a law book I prefer t= o talk with "must" and "must not" instead of "should" and "should not". My main motivation to not use "should" is the way a "should" is handled in RFC's. It's a "you do *not* have to care about this", but the intend of thi= s additional section is "you *have* to care about this". >> > down to, "Please use static plists when possible, as it enables users >> > to grep(1) through available plists to discover, for example, which >> > port installs a certain file." > > Yes, this would be enough. > > I really think you should keep using "static" and "dynamic" in the > "ambiguous" way, and perhaps define them in the text with a sentence or > two each, to clear any confusion. With your new terms, you're risking a > confusion of all the longtimers. Ok, sounds fine to me. Bye, Alexander. -- http://www.Leidinger.net Alexander @ Leidinger.net: PGP ID =3D B0063FE7 http://www.FreeBSD.org netchild @ FreeBSD.org : PGP ID =3D 72077137 ISO applications: =09A solution in search of a problem!