Date: Sat, 9 Jun 2012 18:54:42 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: Doug Barton <dougb@freebsd.org> Cc: Dave Hayes <dave@jetcafe.org>, FreeBSD ports list <freebsd-ports@freebsd.org> Subject: Re: Documenting 'make config' options Message-ID: <alpine.BSF.2.00.1206091850110.71605@wonkity.com> In-Reply-To: <4FD37B40.2030500@FreeBSD.org> References: <CAOgwaMvsv3e1TxDauV038Pp7LRiYeH7oAODE%2Bw-pxHt9oGrXMA@mail.gmail.com> <201206020012.q520CEcf057568@hugeraid.jetcafe.org> <20120602004230.GA14487@in-addr.com> <201206040224.q542OBqk085897@hugeraid.jetcafe.org> <20120604043233.GB32597@lonesome.com> <201206040841.q548fVHa091169@hugeraid.jetcafe.org> <CADLo83-9jE1zAtdXrA78=K5AE7yR4UsMh=efeC5L4kXijaDFaQ@mail.gmail.com> <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> <201206070527.q575R1sX052893@hugeraid.jetcafe.org> <4FD37B40.2030500@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, 9 Jun 2012, Doug Barton wrote: > On 06/06/2012 22:27, Dave Hayes wrote: >> Personally, a 'pkg-options-descr' text file would suit me just fine. > > For those on -ports, the context is, "How do we provide more information > about what the various options mean?" This idea seems reasonable to me, > what do others think? The user needs to know what the options mean when they appear, and having to go look them up in another file is just another hassle. Difficult to do in some situations, too. Better to show them when the user scrolls to that option. Here's what I suggested in -stable: http://lists.freebsd.org/pipermail/freebsd-stable/2012-June/068187.html No new files, only one copy of the descriptions so they don't get out of sync.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1206091850110.71605>