From owner-freebsd-ports@FreeBSD.ORG  Mon Aug  6 16:36:56 2012
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id DCD6D1065672
	for <freebsd-ports@freebsd.org>; Mon,  6 Aug 2012 16:36:56 +0000 (UTC)
	(envelope-from bryan@shatow.net)
Received: from secure.xzibition.com (secure.xzibition.com [173.160.118.92])
	by mx1.freebsd.org (Postfix) with ESMTP id 8567A8FC1A
	for <freebsd-ports@freebsd.org>; Mon,  6 Aug 2012 16:36:56 +0000 (UTC)
DomainKey-Signature: a=rsa-sha1; c=nofws; d=shatow.net; h=message-id
	:date:from:mime-version:to:cc:subject:references:in-reply-to
	:content-type:content-transfer-encoding; q=dns; s=sweb; b=ksiXdI
	w5xlnDiJdKyaHXtW/kpvu0tqylpl6kq32Jm/AepLasu0XMo0Oi8bBw1cgDmVCQ8N
	ecrYnpJTgitk5MoKzlPrd+2pRF8QG3MR9GBeYU8EOW6ufuB4Zj1koNEAyU8TcQW3
	32gZnFRnTJ/L2olSeNrWuXhNkB0vsd5IhiBiI=
DKIM-Signature: v=1; a=rsa-sha256; c=simple; d=shatow.net; h=message-id
	:date:from:mime-version:to:cc:subject:references:in-reply-to
	:content-type:content-transfer-encoding; s=sweb; bh=uOO0rZZrJsnK
	X9OuO4/wxYZt7qjek4rx6ud1PVMdyDk=; b=cT7KdI0i3Xls3AZ21kN0z1x7r8yw
	pJV2/nHd536QCRRy8UVuDKYXcMIzLSg2IX9jz1pxMPptoretMNSSZgBlcBc96NfZ
	spntP3kS0vY6UKvi+F87gDbTGEZT1phR5IWtB3oz4tMGOuI5dgnYB8s+ybKWLnH5
	i7w84Ap1d/varDc=
Received: (qmail 91679 invoked from network); 6 Aug 2012 11:36:54 -0500
Received: from unknown (HELO ?192.168.0.74?) (bryan@shatow.net@74.94.87.209)
	by sweb.xzibition.com with ESMTPA; 6 Aug 2012 11:36:54 -0500
Message-ID: <501FF2A4.1020107@shatow.net>
Date: Mon, 06 Aug 2012 11:36:52 -0500
From: Bryan Drewery <bryan@shatow.net>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
	rv:14.0) Gecko/20120713 Thunderbird/14.0
MIME-Version: 1.0
To: Jeremy Chadwick <jdc@koitsu.org>
References: <20120806160425.GA23270@icarus.home.lan>
In-Reply-To: <20120806160425.GA23270@icarus.home.lan>
X-Enigmail-Version: 1.4.3
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Cc: freebsd-ports@freebsd.org
Subject: Re: Questions about/issues with new OPTIONS framework
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 06 Aug 2012 16:36:57 -0000

On 8/6/2012 11:04 AM, Jeremy Chadwick wrote:
> 2. ports/KNOBS is very explicit in stating, and even visually
> demonstrating (using pipe symbols to delimit length maximums and so
> on), the following:
> 
> #  - Knob description must be 45 characters or less
> 
> Yet, a very good number of descriptions violate this (see the file for
> yourself).  I'm inclined to think the limit is to be extra friendly
> towards 80-column terminals, but I'm still not sure.  Is this
> 45-character-limit untrue, or are numerous descriptions blatantly too
> long?

The KNOBS file is deprecated. The new file is Mk/bsd.options.desc.mk,
which has similar length comments and restrictions.

The limit *does* matter as otherwise the description
a) Gets cut off
b) Wraps, causing display issues on 8.x and 7.x.

If you find descriptions that are cut off or wrapping, please do report
them.

Regards,
Bryan Drewery