From owner-freebsd-ports@freebsd.org Sat Sep 17 15:00:01 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 C25D9BDE150 for ; Sat, 17 Sep 2016 15:00:01 +0000 (UTC) (envelope-from scratch65535@att.net) Received: from mailman.ysv.freebsd.org (unknown [127.0.1.3]) by mx1.freebsd.org (Postfix) with ESMTP id A4EF5CE5 for ; Sat, 17 Sep 2016 15:00:01 +0000 (UTC) (envelope-from scratch65535@att.net) Received: by mailman.ysv.freebsd.org (Postfix) id A460ABDE14F; Sat, 17 Sep 2016 15:00:01 +0000 (UTC) Delivered-To: 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 A407DBDE14E for ; Sat, 17 Sep 2016 15:00:01 +0000 (UTC) (envelope-from scratch65535@att.net) Received: from nm21-vm3.access.bullet.mail.gq1.yahoo.com (nm21-vm3.access.bullet.mail.gq1.yahoo.com [216.39.63.79]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 7ACFDCE4 for ; Sat, 17 Sep 2016 15:00:01 +0000 (UTC) (envelope-from scratch65535@att.net) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=att.net; s=s1024; t=1474124272; bh=YVu+vYu6RG51zyymVQi4gUGISj+JGrxAN8Qnrgs/wKM=; h=From:To:Subject:Date:References:In-Reply-To:From:Subject; b=Vm/rugQPJt+JXnAHtn+7/4hvaQPaHMVJsjPgAGhBXtNmqGobCd7iACRssB6fRMN5Gt6VLBh/oSLYB6spvz6RFQotk/yABAT9R9s6Akir19MI0Tode5NKmQG3aH4VU0MyyD7GkVtgj4kTjin6XCM07s9DX7h42iYQdOYii4Lwn6k= Received: from [216.39.60.166] by nm21.access.bullet.mail.gq1.yahoo.com with NNFMP; 17 Sep 2016 14:57:52 -0000 Received: from [67.195.23.144] by tm2.access.bullet.mail.gq1.yahoo.com with NNFMP; 17 Sep 2016 14:57:52 -0000 Received: from [127.0.0.1] by smtp116.sbc.mail.gq1.yahoo.com with NNFMP; 17 Sep 2016 14:57:52 -0000 X-Yahoo-Newman-Id: 60500.83929.bm@smtp116.sbc.mail.gq1.yahoo.com X-Yahoo-Newman-Property: ymail-3 X-YMail-OSG: l7bMACAVM1m2GQisDQDaJpyktqCeK4kT6BGCuPuerlhX6LA DzXEf8K_FoXU364Jxcbzk3gKFkw.UcakZxoulLDHkDrzfRmsEsdkYHGwCfii 0b8RdsAte.u_jU6op1b6TilGsl65oMaMHzfeHdJvA8IXvazV8tGtrhJWS_rY 3TksWXEkGuo0T8D7IruodBuAWCCllfRy.sRT5r1crGCyR.KmCYyVxj0zabb5 F4DUBvz7RucWZKw_AopGxgONDWsjeMOZYIHbSncrfQP.uM6CFb.QbR2el474 7OfKUJMD_teJpDfYiH5RgyhU.NO_Q.Yp3n4YTsggICI_YeMwH4vM06FX_5Xb 0AcyJZ25QXUFPHotpdKafn7qGnncQ5g6TabfJKugBS5.E1NJ7t1uGvhszS9G XGVjdJX7WQL86B1VT4e8ZmaQ7RfXnKjUn_ehiQqIui6_O0ixtnJC3xkqTG7I tOs8aFXr76w66ZRtjTA9e1HkjDz0jKxf.A9hC60.CwAzhZyLCCseqiPuddhL 5C8lEHl_SZjWnQfp7yy0E6pSciJpJ0b1oIcS36ZG1.SOrY9yvlqr6He_v53V GqemmxVSv X-Yahoo-SMTP: pPvqnOaswBBbYZLVYFzvU7GaowLcbNioPp.aF8KvOjZk From: Margaret To: FreeBSD ports Subject: Re: Checking port option descriptions Date: Sat, 17 Sep 2016 10:58:40 -0400 Message-ID: <4bmqtblq0nl3qmcdomq1koa0n7ic3bqk71@4ax.com> References: <11003591.UQgRz8LoQ6@curlew.lan> In-Reply-To: <11003591.UQgRz8LoQ6@curlew.lan> X-Mailer: Forte Agent 4.2/32.1118 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit 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 15:00:01 -0000 [Default] On Sat, 17 Sep 2016 09:47:10 +0100, Mike Clarke wrote: >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. I like that idea! The nice thing about good, useful comments is that, like the software itself, they generally only have to be written from scratch ONCE. It shouldn't be too hard to agree a template for the file you propose.