From owner-freebsd-ports@FreeBSD.ORG Wed Jun 13 18:52:56 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 4B0B316A46B for ; Wed, 13 Jun 2007 18:52:56 +0000 (UTC) (envelope-from egypcio@gmail.com) Received: from nz-out-0506.google.com (nz-out-0506.google.com [64.233.162.235]) by mx1.freebsd.org (Postfix) with ESMTP id E375213C45B for ; Wed, 13 Jun 2007 18:52:55 +0000 (UTC) (envelope-from egypcio@gmail.com) Received: by nz-out-0506.google.com with SMTP id 14so267033nzn for ; Wed, 13 Jun 2007 11:52:55 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=dc3TVQfKQQmR5HDTaV+Jlp0Veg12SwRll60zc8y3ERbmQSarfSW2wropH5CZ7snZMqd1EcPQ/ieYrsw0r1XVahS4rFSSuYoP9zsFeWYDfnYa/thqAYhpeqcKDkd/BP2yxhq8G51M/VyAhwPnIrsNquHTaPHDomyCRqVIEVpxu3c= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=nxUhdRseDp2osz+1NFWNhkL7I8P9IAyKXrmyNNjJK1X852ABNZjnWihZDrPUVgtQY4/vMMujMkE81l6s3pYaZHWkt4RItrKCQ3Ma4uwBs+BTrilnYCwZtj6LGy4Uc9HVDKM8SretD3KtRUViEzfLe6o4J8I5220ULSIv0t/IT5A= Received: by 10.114.12.9 with SMTP id 9mr938832wal.1181759241795; Wed, 13 Jun 2007 11:27:21 -0700 (PDT) Received: by 10.115.14.3 with HTTP; Wed, 13 Jun 2007 11:27:21 -0700 (PDT) Message-ID: <8b5ad0e10706131127n446a384bw7c3c6e89de4ddf56@mail.gmail.com> Date: Wed, 13 Jun 2007 14:27:21 -0400 From: "=?ISO-8859-1?Q?Zavam,_Vin=EDcius?=" To: freebsd-ports@freebsd.org In-Reply-To: <200706092020.25742.mail@maxlor.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: quoted-printable Content-Disposition: inline References: <200706090936.51775.david@vizion2000.net> <200706092020.25742.mail@maxlor.com> 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: Wed, 13 Jun 2007 18:52:56 -0000 2007/6/9, Benjamin Lutz : > 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 > OPTIONS several times, and some canonical way to add a description > would be quite nice. > > But maybe instead of adding another file, this could be integrated into > the pkg-descr file, and the recorded package description after a port > is installed could contain only those options that were selected, > filtering out the description for the other options. > > Cheers > Benjamin seems nice for me. great post I just can hope this or something similar to happen --=20 Zavam, Vin=EDcius