From owner-freebsd-ports@FreeBSD.ORG Fri May 31 07:11:26 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 D111DD18 for ; Fri, 31 May 2013 07:11:26 +0000 (UTC) (envelope-from baptiste.daroussin@gmail.com) Received: from mail-wg0-x22b.google.com (mail-wg0-x22b.google.com [IPv6:2a00:1450:400c:c00::22b]) by mx1.freebsd.org (Postfix) with ESMTP id 65D4C960 for ; Fri, 31 May 2013 07:11:26 +0000 (UTC) Received: by mail-wg0-f43.google.com with SMTP id x12so932626wgg.22 for ; Fri, 31 May 2013 00:11:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:date:from:to:cc:subject:message-id:references:mime-version :content-type:content-disposition:in-reply-to:user-agent; bh=GaluVwDYZKygWcKMP6qhn9JkbEe37NlfdvQwSQIKbvc=; b=P7nfIW6saX1ioO2HekZTQm4fPpky/+EJ2epmbkg9+ln6qCzM9cTOESqKFFiL8WJeHc qvTQrgG/twrOb3QxGc4R6m3Yf9he1E2K6yC0X6aVjfc9Im7j88HxIxpBab5+V+Un9lcv TUFaVzD5Uk5slv5ddNXv21jg+jj5iqYQObTwcp5Rtx99T3kB3QMbjJsphIclOCRUXBfe N/sKcYK7GQTpT86MBCfooWP1P4ppaBdTwkks2Eywbtp9vIiZmVslXg0hjSKDdhVi89lS +xhkXRQp9gdBHmHxduo1VgdI2XbB8xfJxK+o/Qxq1TS8241bIPK58/vnN1S4m+767CHR zRNg== X-Received: by 10.180.105.161 with SMTP id gn1mr2020265wib.5.1369984285578; Fri, 31 May 2013 00:11:25 -0700 (PDT) Received: from ithaqua.etoilebsd.net (ithaqua.etoilebsd.net. [37.59.37.188]) by mx.google.com with ESMTPSA id d10sm1909000wik.0.2013.05.31.00.11.23 for (version=TLSv1 cipher=RC4-SHA bits=128/128); Fri, 31 May 2013 00:11:24 -0700 (PDT) Sender: Baptiste Daroussin Date: Fri, 31 May 2013 09:11:22 +0200 From: Baptiste Daroussin To: Warren Block Subject: Re: shells/bash: Options slightly confusing Message-ID: <20130531071122.GJ19621@ithaqua.etoilebsd.net> References: <20130530132742.43455bba@bsd64.grem.de> <51A7413D.9010104@marino.st> <20130530150955.2916170a@bsd64.grem.de> <20130530105753.722eec41@scorpio> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="va4/JQ6j8/8uipEp" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Cc: rum1cro@yandex.ru, freebsd-ports X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 31 May 2013 07:11:26 -0000 --va4/JQ6j8/8uipEp Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, May 30, 2013 at 11:12:44PM -0600, Warren Block wrote: > On Thu, 30 May 2013, Freddie Cash wrote: >=20 > > On Thu, May 30, 2013 at 7:57 AM, Jerry wrote: > > > >> 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. > >> > >> Isn't long options description support enabled in the ports tree now? = Or > > was that only available via Warren Block's dialogwrapper? Or maybe via > > dialog4ports? > > > > I remember reading something about this a few months back, where the bo= ttom > > of the screen would show long descriptions of what the option would do,= or > > a separate help screen would be available. Or maybe that was just a > > proof-of-concept? >=20 > dialogwrapper did it. Still does, except the new dialog4ports supplants= =20 > dialogwrapper. >=20 > Unfortunately, dialog4ports does not show long option descriptions. I=20 > consider long options descriptions that are shown by default to be very= =20 > important. I think dialog4ports has a way to show a help file on user=20 > request, but to me, that is a solution to a different problem. We do want long description on dialog4ports and this is on the TODO. I added Ilya the main dialog4port in CC. regards, Bapt --va4/JQ6j8/8uipEp Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (FreeBSD) iEYEARECAAYFAlGoTRoACgkQ8kTtMUmk6EwZ8ACeOng1HFzgdu910YlcOAKV/bjB uP0AoIvrPAEgl9EVSPToPrV4n4R9itoU =S04/ -----END PGP SIGNATURE----- --va4/JQ6j8/8uipEp--