From owner-freebsd-ports@FreeBSD.ORG Sat Jun 9 18:20:39 2007 Return-Path: X-Original-To: freebsd-ports@freebsd.org Delivered-To: freebsd-ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 54FB716A421 for ; Sat, 9 Jun 2007 18:20:39 +0000 (UTC) (envelope-from mail@maxlor.com) Received: from popeye1.ggamaur.net (popeye1.ggamaur.net [213.160.40.50]) by mx1.freebsd.org (Postfix) with ESMTP id 03A5013C455 for ; Sat, 9 Jun 2007 18:20:38 +0000 (UTC) (envelope-from mail@maxlor.com) Received: from maxlor.mine.nu (c-82-192-240-247.customer.ggaweb.ch [82.192.240.247]) by popeye1.ggamaur.net (8.13.7/8.13.7/Submit) with ESMTP id l59IKYhV091024; Sat, 9 Jun 2007 20:20:36 +0200 (CEST) (envelope-from mail@maxlor.com) Received: from localhost (unknown [127.0.0.1]) by maxlor.mine.nu (Postfix) with ESMTP id D13D02E212; Sat, 9 Jun 2007 20:20:27 +0200 (CEST) X-Virus-Scanned: amavisd-new at atlantis.intranet Received: from maxlor.mine.nu ([127.0.0.1]) by localhost (atlantis.intranet [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 3X4fJJ6xczXU; Sat, 9 Jun 2007 20:20:27 +0200 (CEST) Received: from mini.intranet (mini.intranet [10.0.0.17]) by maxlor.mine.nu (Postfix) with ESMTP id 92C3D2E1E9; Sat, 9 Jun 2007 20:20:27 +0200 (CEST) From: Benjamin Lutz To: freebsd-ports@freebsd.org Date: Sat, 9 Jun 2007 20:20:21 +0200 User-Agent: KMail/1.9.5 References: <200706090936.51775.david@vizion2000.net> In-Reply-To: <200706090936.51775.david@vizion2000.net> X-Face: $Ov27?7*N,h60fIEfNJdb!m,@#4T/d; 1hw|W0zvsHM(a$Yn6BYQ0^SEEXvi8>D`|V*F"=?utf-8?q?=5F+=0A=09R2?=@Aq>+mNb4`,'[[%z9v0Fa~]AD1}xQO3|>b.z&}l#R-_(P`?@Mz"kS; XC>Eti,i3>%@=?utf-8?q?g=3F=0A=094f?=,\c7|Ghwb&ky$b2PJ^\0b83NkLsFKv|smL/cI4UD%Tu8alAD MIME-Version: 1.0 Content-Type: multipart/signed; boundary="nextPart2228787.9NCNXTk9N7"; protocol="application/pgp-signature"; micalg=pgp-sha1 Content-Transfer-Encoding: 7bit Message-Id: <200706092020.25742.mail@maxlor.com> X-Scanned-By: MIMEDefang 2.61 on 213.160.40.60 Cc: David Southwell Subject: Re: ./options-descr file suggestion for ports 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: Sat, 09 Jun 2007 18:20:39 -0000 --nextPart2228787.9NCNXTk9N7 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline On Saturday 09 June 2007 18:36, David Southwell wrote: > Hi > > Would it be possible , when a port has options, to ask porters if > they would consider the merits/demerits of adding: > > 1. An ./options-descr file in the port directory that describes the > options, their purpose and any notes about an option > > Reasons: > This would be extremely useful for anyone not familiar with the port > to help in the task of choosing which options to install. > > I realise that this would depend upon whether maintainers are willing > to add an additional task to the already heavy burden they undertake. > Maintainers who are willing to consider this idea but are reluctant > to prepare the notes themselves but do not have the time or are for > any reason reluctant to do so, could invite users to submit notes for > incorporating in ./options-descr. > > By way of example I am just installing www/ruby-gem-rails and had no > immediate idea whether or not to add fastcgi support without trying > to find out whether it is or is not needed when one has mod_ruby > installed and > LoadModule ruby_module libexec/apache/mod_ruby.so > in httpd.conf. A brief note in a ./options-descr could be very > helpful, especially for some ports where the options are sometimes > numerous and not always completely documented. > > A little bit of intial guidance about options would be most helpful > to a system administrator who is not necessarily familiar with the a > specific port. > > my two pennorth. > > david I think that's a great idea. I've been wondering about the meaning of=20 OPTIONS several times, and some canonical way to add a description=20 would be quite nice. But maybe instead of adding another file, this could be integrated into=20 the pkg-descr file, and the recorded package description after a port=20 is installed could contain only those options that were selected,=20 filtering out the description for the other options. Cheers Benjamin --nextPart2228787.9NCNXTk9N7 Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.7 (GNU/Linux) iD8DBQBGau9mzZEjpyKHuQwRAuBVAJwPMIWQIYyTJdUEunoUQlc8Gv8bbwCgk20Z AvN4K3/PKuwOjztExgLkw3A= =JLQq -----END PGP SIGNATURE----- --nextPart2228787.9NCNXTk9N7--