From owner-freebsd-ports@freebsd.org Sat Sep 17 08:50:40 2016 Return-Path: Delivered-To: freebsd-ports@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 1216ABDEE6A for ; Sat, 17 Sep 2016 08:50:40 +0000 (UTC) (envelope-from jmc-freebsd2@milibyte.co.uk) Received: from avasout08.plus.net (avasout08.plus.net [212.159.14.20]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (Client CN "Bizanga Labs SMTP Client Certificate", Issuer "Bizanga Labs CA" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 6B6919E1 for ; Sat, 17 Sep 2016 08:50:38 +0000 (UTC) (envelope-from jmc-freebsd2@milibyte.co.uk) Received: from curlew.milibyte.co.uk ([80.229.31.82]) by avasout08 with smtp id kYnR1t0031mJoLY01YnSvY; Sat, 17 Sep 2016 09:47:26 +0100 X-CM-Score: 0.00 X-CNFS-Analysis: v=2.2 cv=Y6S6iVWN c=1 sm=1 tr=0 a=cd0K7rcWwnZFf6xQxRobyA==:117 a=cd0K7rcWwnZFf6xQxRobyA==:17 a=kj9zAlcOel0A:10 a=GW1xBdLrtEIA:10 a=o5jpBRpSQihOQRg46woA:9 a=R0xic6zjUnxikngp:21 a=I15dLs9zNDkLtwCx:21 a=CjuIK1q_8ugA:10 Received: from curlew.lan ([192.168.1.13] helo=milibyte.co.uk) by curlew.milibyte.co.uk with esmtp (Exim 4.87) (envelope-from ) id 1blBHD-0000tJ-NZ for freebsd-ports@freebsd.org; Sat, 17 Sep 2016 09:47:25 +0100 From: Mike Clarke To: freebsd-ports@freebsd.org Date: Sat, 17 Sep 2016 09:47:10 +0100 Message-ID: <11003591.UQgRz8LoQ6@curlew.lan> User-Agent: KMail/4.14.10 (FreeBSD/10.3-RELEASE-p7; KDE/4.14.10; amd64; ; ) In-Reply-To: References: MIME-Version: 1.0 X-SA-Exim-Connect-IP: 192.168.1.13 X-SA-Exim-Mail-From: jmc-freebsd2@milibyte.co.uk X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on curlew.lan X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=ALL_TRUSTED,BAYES_00 autolearn=ham autolearn_force=no version=3.4.1 Subject: Re: Checking port option descriptions Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" X-SA-Exim-Version: 4.2 X-SA-Exim-Scanned: Yes (on curlew.milibyte.co.uk) X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 17 Sep 2016 08:50:40 -0000 On Friday 16 Sep 2016 20:09:06 Kevin Oberman wrote: > Even when the meaning is clear in global sense, what are the implications > for an application. E.g. "RTC=on: Add support for kernel real time clock" > in mplayer. I know exactly what the RTC is, but I have no idea why I might > or might not want it in mplayer. For cases where one line comments won't suffice how about providing the facility to include an extra text file in a port (perhaps "pkg-options") containing notes about why some particular options would be chosen? In its simplest form a user would be able to refer to the file before selecting an option, A further enhancement could be to modify the way that configure works so that the user can select an option and press "?" to see the section of text, if any, from pkg-options explaining that option. -- Mike Clarke