From owner-freebsd-stable@FreeBSD.ORG Thu Jun 7 02:53:44 2012 Return-Path: Delivered-To: freebsd-stable@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 944401065674 for ; Thu, 7 Jun 2012 02:53:44 +0000 (UTC) (envelope-from spork@bway.net) Received: from xena.bway.net (xena.bway.net [216.220.96.26]) by mx1.freebsd.org (Postfix) with ESMTP id 50D818FC08 for ; Thu, 7 Jun 2012 02:53:44 +0000 (UTC) Received: (qmail 17896 invoked by uid 0); 7 Jun 2012 02:47:01 -0000 Received: from smtp.bway.net (216.220.96.25) by xena.bway.net with ESMTPS (DHE-RSA-AES256-SHA encrypted); 7 Jun 2012 02:47:01 -0000 Received: (qmail 17887 invoked by uid 90); 7 Jun 2012 02:47:01 -0000 Received: from unknown (HELO ?10.3.2.41?) (spork@96.57.144.66) by smtp.bway.net with ESMTPA; 7 Jun 2012 02:47:01 -0000 References: <201206040224.q542OBqk085897@hugeraid.jetcafe.org> <20120604043233.GB32597@lonesome.com> <201206040841.q548fVHa091169@hugeraid.jetcafe.org> <201206041841.q54IfUow001060@hugeraid.jetcafe.org> <20120604191343.GF10783@isuckatdomains.isuckatdomains.net> <201206041932.q54JWONA001600@hugeraid.jetcafe.org> <4FCDA15C.2000700@digsys.bg> <201206061859.q56IxvLx045828@hugeraid.jetcafe.org> <4FCFC846.5050508@FreeBSD.org> <20120606212351.GB1387@glenbarber.us> <4FCFD05C.6040707@unsane.co.uk> In-Reply-To: Mime-Version: 1.0 (Apple Message framework v1084) Content-Type: text/plain; charset=us-ascii Message-Id: <470F2F8A-BB03-4561-B085-9E108613DEF2@bway.net> Content-Transfer-Encoding: quoted-printable From: Charles Sprickman Date: Wed, 6 Jun 2012 22:47:00 -0400 To: Warren Block X-Mailer: Apple Mail (2.1084) Cc: freebsd-stable@freebsd.org, Vincent Hoffman Subject: Re: Documenting 'make config' options X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 07 Jun 2012 02:53:44 -0000 On Jun 6, 2012, at 7:43 PM, Warren Block wrote: > On Wed, 6 Jun 2012, Vincent Hoffman wrote: >=20 >> On 06/06/2012 22:23, Glen Barber wrote: >>> On Wed, Jun 06, 2012 at 02:14:46PM -0700, Doug Barton wrote: >>>> On 06/06/2012 11:59, Dave Hayes wrote: >>>>> I'm describing more of a use case here, not attempting to specify = an >>>>> implementation. If a user invokes 'make', a window is presented to = them >>>>> with various options. It's probably very common that this is met = with an >>>>> initial reaction of "what the hell do these do?", even from the = most >>>>> seasoned of admins (presuming they are unfamiliar with the = software they >>>>> have been asked to install). I claim it would be an improvement to = have >>>>> that information at the fingertips of the make invoker. >>>> What manner of providing this information would meet your needs? >>>>=20 >>> IMHO, something informing what "THAT" is in devel/subversion option >>> MOD_DONTDOTHAT would be nice. :) >>>=20 >> Not something I had bothered looking up till now as I hadnt wanted to >> use it but the 2nd hit on google, >> = http://lists.freebsd.org/pipermail/freebsd-ports-bugs/2009-April/161673.ht= ml >> describes it quite well. >> I tend to go with, If i dont know what it is, and its not default, I >> probably dont need it. >> Unless it looks interesting, then I google it ;) >>=20 >> Maybe an (optional) new file with a longer descriptions of the make >> options so as not to crowd the make config dialog? >> I dont mind looking up compile time options for software I am = installing >> but I can see how having a precis available locally might be handy. >=20 > Here's an idea: if the description is too long to show in the very = limited space, cut it off, show a "...", and show the entire description = in a two- or three-line text box below the main one. The >< indicate a = highlight here: >=20 > ----------------------------------------------- > >[ ] GOOFY Build with support for the... < > [ ] EXAMPLES Install the examples >=20 > ----------------------------------------------- > < OK > >=20 > --------------------------------------------- > Build with support for the GOOFY framework > that provides concurrent whoopsies integrated > with a Perubython interpreter, and stuff. > ----------------------------------------------- >=20 > The description at the bottom is from whatever option is currently = highlighted, and changes as the user scrolls through the options. It = would be blank if the entire description could be displayed in the space = available above. >=20 > The advantage of this is that it would work with existing ports, and = give the ability to use longer descriptions. The disadvantage is that = dialog(1) would probably need modifications. If we're talking about changing dialog(1), let's make sure there's also = an "uncheck all"/"check all" option. I'm looking at you, ghostscript: wc -l /var/db/ports/ghostscript9/options 315 /var/db/ports/ghostscript9/options Charles > _______________________________________________ > freebsd-stable@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-stable > To unsubscribe, send any mail to = "freebsd-stable-unsubscribe@freebsd.org" -- Charles Sprickman NetEng/SysAdmin Bway.net - New York's Best Internet www.bway.net spork@bway.net - 212.655.9344