From owner-freebsd-ports@FreeBSD.ORG Thu May 30 14:57:57 2013 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 7C24EBB8 for ; Thu, 30 May 2013 14:57:57 +0000 (UTC) (envelope-from jerry@seibercom.net) Received: from mail-yh0-x231.google.com (mail-yh0-x231.google.com [IPv6:2607:f8b0:4002:c01::231]) by mx1.freebsd.org (Postfix) with ESMTP id 34A6DA72 for ; Thu, 30 May 2013 14:57:56 +0000 (UTC) Received: by mail-yh0-f49.google.com with SMTP id i57so79399yha.8 for ; Thu, 30 May 2013 07:57:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=seibercom.net; s=google; h=date:from:to:subject:message-id:in-reply-to:references:reply-to :organization:x-mailer:face:mime-version:content-type :content-transfer-encoding; bh=SDFcjMlG7HsqaJBE8nthOqWw14WoGTY45+DHx5wcFjE=; b=IRVoAM719/Q2i4GAE0sO6qt6BrNW8YivxreQ5QrKHlDFteLAta2SrQvLFWZdbx0pUK 9N8apo6kkXI8ED1WauVPKGwOQ3NwAJ0GL6y+53NkU5mPhSjlZqUTlDLlglyhdakdZ9xi g9sfMOPG2Quq6Y3axdbs+Stgrb6okCVjuiKDI= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=date:from:to:subject:message-id:in-reply-to:references:reply-to :organization:x-mailer:face:mime-version:content-type :content-transfer-encoding:x-gm-message-state; bh=SDFcjMlG7HsqaJBE8nthOqWw14WoGTY45+DHx5wcFjE=; b=FbK/hGdncfumFMzl6Y4m63Lh7tNahdVbPdxGVt+19VvKZhXemzFzosOzLUqjF9N8mb fXSol0cXfQuKHqTQQuMUZWtmVeJmwiHDqvo2cATV28Q8cmWq9AQo+ebrEIib1uReQT+/ 32NYupVv4uKd3NhIPJy+Im0Nj8ncmBoxwX/tQcmaxRFMMzD9dVhgjjbwK13JSsXuErEw IwtOnLXjW+CEU2TabHwr1tWeEnQpaAml3EzwKfNRwFAnSMTBxW/YPdHpA9TFEkmCaYrg KlEQLMnLRTNwpFeYbqvGDLFPACUSRMKl1tpvY3oy2YEEWKr4j1q8hpVPBvIhLIl3o1bZ uIxw== X-Received: by 10.236.2.10 with SMTP id 10mr3810811yhe.146.1369925876615; Thu, 30 May 2013 07:57:56 -0700 (PDT) Received: from scorpio.seibercom.net (cpe-076-182-104-150.nc.res.rr.com. [76.182.104.150]) by mx.google.com with ESMTPSA id f30sm52359652yhi.21.2013.05.30.07.57.55 for (version=TLSv1.2 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 30 May 2013 07:57:55 -0700 (PDT) Received: from scorpio (localhost [127.0.0.1]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: jerry@seibercom.net) by scorpio.seibercom.net (Postfix) with ESMTPSA id 3bLsNK6C33z2CG5q for ; Thu, 30 May 2013 10:57:53 -0400 (EDT) Date: Thu, 30 May 2013 10:57:53 -0400 From: Jerry To: freebsd-ports@freebsd.org Subject: Re: shells/bash: Options slightly confusing Message-ID: <20130530105753.722eec41@scorpio> In-Reply-To: <20130530150955.2916170a@bsd64.grem.de> References: <20130530132742.43455bba@bsd64.grem.de> <51A7413D.9010104@marino.st> <20130530150955.2916170a@bsd64.grem.de> Organization: seibercom.net X-Mailer: Claws Mail 3.9.1 (GTK+ 2.24.18; amd64-portbld-freebsd8.3) Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAHlBMVEUAAABYRlwJCw4FAgAIBwKprDkBAQFQLR0BAgCir7VRttp8AAACAUlEQVQ4jZWUTYvbMBCGTVl8V2hX6Gg5G5FbWQdBj0lEfE7BhN4cyzi5Wt1E5L70roWy6N92xok/skkP+5IYrMcz78xIduDWpNM3vFzuA/jX5EY1AI6KHFwW/CzFuQAwqUBbV12p+CzIh6Awq7sg33pn5D64SQXAexffeuQlA/L35RrkaB551OjGfP/cAO8mCNaDcgvfky5ijoD0pAXlCQCnljiAjsJD9Ax05Ko5sZxbnLQcmM+dZg5IjREfZrWIHK0JuwU68pAGwHvfRxBundRzTxxz3r9dNUikPsEihjz2Dc4kjp1hKsJGuot4EDxaxzMoC7XqhxhOSfZrTS6gSX1JVdjp+o1PvWfekXgw3WL0g70nDEwA0H0HQsEZc8sTmFMTkWUfYWC/vdR1zQy3xLQgLwzu90QnlnFLjeiGWBjwhb4Sa42IqOg2qqS4O1/zhKokFUb1Q8Rj4Eb69WVflXEehJ35DgChVTE5n50eaGyMLOfH8AOodoSM4PVYAQgQdBulOa+knklYks3vAuQ+uX492lTl+A+e8qBV2AKoXalVKFfyuUp0pUp1ARaUHh82lv9MN+Ig7CZtgE6FNYvjlywT2VP2dMgOG46gTIWcqdfvuwyXNz0oMJNd/N5lh1YNiJt19ADTUo3VuFSNeQwVqRSrGjSCp53fk2g+Mvfk/gfoPxHeUS8MH9vRAAAAAElFTkSuQmCC Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Gm-Message-State: ALoCoQlxkYK5M+mvbA1XKGu57iK24luV2k965f7ghVgTOECoEIiYdjKgW1hnH0d+FVwYhPFf4tUd X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: freebsd-ports@freebsd.org List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 May 2013 14:57:57 -0000 On Thu, 30 May 2013 15:09:55 +0200 Michael Gmelin articulated: > On Thu, 30 May 2013 14:08:29 +0200 > John Marino wrote: > > > On 5/30/2013 13:27, Michael Gmelin wrote: > > > I assume there are better ways to make this clear. It might even > > > make sense to have a basic distinction on the ports system level - > > > options that provide additional features vs. options that > > > change the (default) behavior of the port. > > > > Isn't this implicit in the option default selection? In other > > words, the fact that it's pre-selected indicates the default > > behavior of the port, right? > > > > Even in the case of a dialog showing where it didn't before isn't a > > logical reason to think pre-selected options are changes in default > > behavior, at least not to me. > > > > There's been some debate over the bash port earlier this year, plus it > has been converted to OptionsNg recently (AFAIK it had no options > dialog before), therefore my pessimism. > > But regardless of default options and updating - if I installed bash > for the first time and seen an option labeled as "Use directory name > alone to cd into it" I would assume that bash will behave like this > after installation without further configuration - in contrast to > adding the ability to do that ("Support feature"). > > Maybe it's just me though :) I agree whole heartily. Unfortunately, all too many ports have options that all cryptic in nature. There really needs to be better documentation as to what the options actually do. Perhaps having an additional file in each port named "OPTDESC", or whatever that would list each available option for the port and exactly what it did would prove useful. It certainly would not be a burden as over 90% of the ports that have either none or just one or two options. Besides, if some maintainer created a port with 40 or 50 configurable options, then they certainly can take the time to fully document them. Just my 2¢. -- Jerry ♔ Disclaimer: off-list followups get on-list replies or get ignored. Please do not ignore the Reply-To header. __________________________________________________________________ Mollison's Bureaucracy Hypothesis: If an idea can survive a bureaucratic review and be implemented it wasn't worth doing.