Date: Fri, 31 May 2013 09:11:22 +0200 From: Baptiste Daroussin <bapt@FreeBSD.org> To: Warren Block <wblock@wonkity.com> Cc: rum1cro@yandex.ru, freebsd-ports <freebsd-ports@freebsd.org> Subject: Re: shells/bash: Options slightly confusing Message-ID: <20130531071122.GJ19621@ithaqua.etoilebsd.net> In-Reply-To: <alpine.BSF.2.00.1305302304350.69685@wonkity.com> References: <20130530132742.43455bba@bsd64.grem.de> <51A7413D.9010104@marino.st> <20130530150955.2916170a@bsd64.grem.de> <20130530105753.722eec41@scorpio> <CAOjFWZ4ztQsB92%2B8xJ8FZwA_o=WWK-qPHcj4YME46vbVTGh9=A@mail.gmail.com> <alpine.BSF.2.00.1305302304350.69685@wonkity.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <jerry@seibercom.net> 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130531071122.GJ19621>