From owner-freebsd-ports@FreeBSD.ORG Wed May 30 20:47:11 2012 Return-Path: Delivered-To: ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 3D63F1065670; Wed, 30 May 2012 20:47:11 +0000 (UTC) (envelope-from villa.alberto@gmail.com) Received: from mail-we0-f182.google.com (mail-we0-f182.google.com [74.125.82.182]) by mx1.freebsd.org (Postfix) with ESMTP id 9CECB8FC18; Wed, 30 May 2012 20:47:10 +0000 (UTC) Received: by werg1 with SMTP id g1so200951wer.13 for ; Wed, 30 May 2012 13:47:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type; bh=Zoc03vRvoZhZwzwCk9P6jSL1uaDQ7GoL5qnx9UMIr48=; b=snpo6gms0UR/46Hq1GLYK5+Lfn5LANLBDCB7u6pq7KxDja++ZyUwOPmtQm55PgvPp+ dMkdTjmmFEDwZAqdht0SmuZVLFlMTD4AxSRopSUfhQT1vqvJqey8hXZciQO9spRoR5dW FOPYnjlzT3Ri0zHxpkVv+XbIzykpwaikoKFd+/NGiA3tjxuPvovqFIbdYEitiKwtNxhi 0ATgJ/8a99rSDir0WkThxa5/cjyhl/WJK/nundSR7jukLVbAFE1MnkvZgkdtIiwpZOJO v6f8wUURrZ3ACMFVnkvP4Qet1ZlOR2gFMTjgOAWXrSxFb35qFnAj+S83qqKyoncWu6XE NxVA== Received: by 10.216.206.164 with SMTP id l36mr11431952weo.154.1338410824287; Wed, 30 May 2012 13:47:04 -0700 (PDT) MIME-Version: 1.0 Sender: villa.alberto@gmail.com Received: by 10.227.112.132 with HTTP; Wed, 30 May 2012 13:46:44 -0700 (PDT) In-Reply-To: <20120530063334.GD9952@ithaqua.etoilebsd.net> References: <20120530063334.GD9952@ithaqua.etoilebsd.net> From: Alberto Villa Date: Wed, 30 May 2012 22:46:44 +0200 X-Google-Sender-Auth: AvjzRdhmzBiVMRGwFaQwEc-6uZI Message-ID: To: Baptiste Daroussin Content-Type: text/plain; charset=ISO-8859-1 Cc: ports@freebsd.org Subject: Re: Options name, descriptions and consistency X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 30 May 2012 20:47:11 -0000 On Wed, May 30, 2012 at 8:33 AM, Baptiste Daroussin wrote: > On of the reasons of bsd.options.desc.mk is to be able to share common options > and descriptions, to have better consistency between ports and to have general > meaning descriptions that make more sense, has anyone can improve the > description of an option. While I really like what bsd.options.desc.mk is supposed to do, I would like to recommend to any committer/maintainer (and I will personally submit a patch for the soon-to-come documentation and for the file itself) to think before always relying on on default option descriptions. Sometimes just saying "Enable XXX support" doesn't mean anything to the user, and a more explanatory text would be far better, explaining maybe what feature one is about to enable instead of just what he is going to depend on. So, please, do not hesitate to redefine option descriptions for your ports if you feel you can add more information for the port specific case. -- Alberto Villa, FreeBSD committer http://people.FreeBSD.org/~avilla