From owner-freebsd-ports@FreeBSD.ORG Tue Dec 6 14:13:22 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 6A01C16A41F; Tue, 6 Dec 2005 14:13:22 +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 39CE143D46; Tue, 6 Dec 2005 14:13:19 +0000 (GMT) (envelope-from Alexander@Leidinger.net) Received: from Andro-Beta.Leidinger.net (p54A5C921.dip.t-dialin.net [84.165.201.33]) (authenticated bits=0) by www.ebusiness-leidinger.de (8.13.1/8.13.1) with ESMTP id jB6DjUh5075509; Tue, 6 Dec 2005 14:45:31 +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 jB6EDDG7003825; Tue, 6 Dec 2005 15:13:13 +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; Tue, 06 Dec 2005 15:13:12 +0100 Message-ID: <20051206151312.jys77382ogw00gsg@netchild.homeip.net> X-Priority: 3 (Normal) Date: Tue, 06 Dec 2005 15:13:12 +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: multipart/mixed; boundary="=_43qrpac3pc4k" Content-Transfer-Encoding: 7bit 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: Tue, 06 Dec 2005 14:13:22 -0000 This message is in MIME format. --=_43qrpac3pc4k Content-Type: text/plain; charset=UTF-8; format="flowed" Content-Disposition: inline Content-Transfer-Encoding: 7bit Pav Lucistnik wrote: > 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. Attached is a revised version. Native english speakers (or people which know the english language better than me) are encouraged to highlight bugs... Note: I'm only interested in the content of this new part of the porters handbook. So if someone thinks he can come up with a better wording: feel free to share it with us. Bye, Alexander. -- http://www.Leidinger.net Alexander @ Leidinger.net: PGP ID = B0063FE7 http://www.FreeBSD.org netchild @ FreeBSD.org : PGP ID = 72077137 You have only to mumble a few words in church to get married and few words in your sleep to get divorced. --=_43qrpac3pc4k Content-Type: text/plain; charset=UTF-8; name="install-time-lplist" Content-Disposition: attachment; filename="install-time-lplist" Content-Transfer-Encoding: 7bit Dynamic vs. static plist ------------------------ Definition "static plist": a static plist is a plist which is available in the Ports Collection either as a pkg-plist file (with or without plist variables), or embedded into the Makefile of the port as PLIST_FILES/PLIST_DIRS variables. The contents may be auto-generated by a tool or a target in the Makefile *before* the inclusion into the Ports Collection by a committer. Definition "dynamic plist": a dynamic plist is a plist which is generated at the time the port is build/compiled based upon the files and directories which are installed and is not available in the Ports Collection before the source files of the port are downloaded and build or after a "make clean". Some maintainers prefer to use dynamic plists. While the use of them is not forbidden, maintainers should use dynamic plists wherever possible, as it enables users to grep(1) through available plists to discover, for example, which port installs a certain file. Exceptions are complex ports where the plist changes a lot based upon optional features of the port and getting the static plist right would result in a major headache, or ports which change the plist based upon the version of BUILD_DEPENDS used (e.g. ports which generate docs with Javadoc). Maintainers which prefer dynamic plists are encouraged to add a new target to their port which generates the plist. Some additional info for the commit log: ---snip--- Benefits of static plists: - Allows to search for files which are not installed. Affects users. - Allows to determine if a particular port contains what we want. Affects users. - Allows to check just with grep if two ports install conflicting files. Affects users (which debug a problem) and developers (which process a bug report). - Allows to check the plist for flaws/pitfalls with portlint. Affects developers. - Allows to answer some classes of support requests without the need to install the port. Affects "support frontliners". - Allows to notice files which are not build but should be build. Affects users (quality of the port/package) and developers (automatic bug notification by the ports build cluster). - Allows to have a look at the history of what a port installs. Affects users (which have a problem and need support with an old version of a port). Drawback of static plists: an dynamic plist is generated when the port is installed while a static plists needs to be transfered to the user. Counter argument to the drawback of static plists: while there are still some locations with limited connectivity where this may matter, the size of the rest of the ports tree combined with only transferring differences (if this results in smaller sizes) and compression (as done by cvsup and portsnap), the additional size of static plists is negligible. ---snip--- --=_43qrpac3pc4k--