Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 26 Mar 2008 10:18:29 -0400
From:      Wesley Shields <wxs@FreeBSD.org>
To:        Pav Lucistnik <pav@FreeBSD.org>
Cc:        ports@FreeBSD.org, Andrew Reilly <andrew-freebsd@areilly.bpc-users.org>, Jeremy Chadwick <koitsu@FreeBSD.org>
Subject:   Re: There is no way to know what port options mean (in general)
Message-ID:  <20080326141829.GE23226@atarininja.org>
In-Reply-To: <20080326141048.M53995@FreeBSD.org>
References:  <20080326053328.GA29448@duncan.reilly.home> <20080326093858.GA78756@eos.sc1.parodius.com> <20080326133611.GD23226@atarininja.org> <20080326141048.M53995@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Mar 26, 2008 at 03:11:39PM +0100, Pav Lucistnik wrote:
> On Wed, 26 Mar 2008 09:36:11 -0400, Wesley Shields wrote
> 
> > While, it has to go somewhere and as a maintainer I have no problem
> > printing out a description of each option inside a custom target.
> > What's important is that there be some consistency in what that 
> > target is called.  Even better would be to provide a framework to 
> > ease the work maintainers have to do.  I envision the following:
> > 
> > - For each available option have a variable called DESC_$FOO which 
> > is a 	string which describes that option in detail. - Whatever that 
> > target is called should be in bsd.ports.mk and output 	the contents 
> > of DESC_$FOO.
> 
> I think best it would be to extend the OPTIONS syntax from five to six fields,
> adding a long description field. Two issues
> 
> 1) what about backward compatibility with existing ports

The idea would be to call "make describeconfig" (or whatever it ends up
being) which would output the information.  If the port does not have a
DESC_$FOO it will emit a string indicating that this option is not
documented and to contact the maintainer to address that.

> 2) is dialog(1) able to display such a text field?

I was not thinking of displaying these in dialog at all, but rather
similar to how "showconfig" works right now.  I see no point in using
dialog(1) for this as it's not really an interactive process at all,
just purely informational.

Sounds to me like you are thinking of including the description in the
dialog.  This sounds like a good idea to me and is something I can look
into doing instead of my proposal.

-- WXS



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20080326141829.GE23226>