From owner-freebsd-ports@FreeBSD.ORG Thu May 30 16:49:05 2013 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 341C3625 for ; Thu, 30 May 2013 16:49:05 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-pb0-x22c.google.com (mail-pb0-x22c.google.com [IPv6:2607:f8b0:400e:c01::22c]) by mx1.freebsd.org (Postfix) with ESMTP id 0F7EB638 for ; Thu, 30 May 2013 16:49:05 +0000 (UTC) Received: by mail-pb0-f44.google.com with SMTP id wz12so686457pbc.3 for ; Thu, 30 May 2013 09:49:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :content-type; bh=t2QcvWua9QN5QZcD/HCYtB/8KwB4j0NCwZEDC7DbtKQ=; b=DTOT4x+Lpi4uCLCEblXNBg7UYwTmOTzpX1wTAUU8WvObzoP7JevgaqPcCBOjW2zjVC u8UQ30G5XwlhoaN3Oc5Z8rKa9BmGjrENVvlhaUBrH2AMPtQe64E0C1APrNsg+SGjH6jT JL02MV95JZdLa/CdyBiElSBnJAGEJcD9z99Y8= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :content-type:x-gm-message-state; bh=t2QcvWua9QN5QZcD/HCYtB/8KwB4j0NCwZEDC7DbtKQ=; b=dElW35p6NfmZ2+UNawyC6aADOz25ozx2KHtzlDRdPT+gxVuiS7yLR1J9kKaPpxlXcN zT6vG5iAVsB95HG4x0ZqWh6oELxDNWPJbPuoK+dhhUzdSEdeHGNPcuLotGCdUoTlyy+E sHftqCO+4IEtyfzx+33UhJjOhdz9lgYW27I6Kv+PDwAqgmnuf1j69dXkp8OxOT01O8qb DUFSLFV4CLiXyXMcWrsf065RkBTRC0BaXxcpIdRdBLisUI3wEuy+TunCZuXa1D8TQl25 Pt3bBXbDejC0Iidr9HRa3rXh4tiMe2fzlbz0mGkN0kpC2YbcQsBOyb7UlW2eukeu1Jrn lQWA== X-Received: by 10.68.213.231 with SMTP id nv7mr8995760pbc.70.1369932544813; Thu, 30 May 2013 09:49:04 -0700 (PDT) MIME-Version: 1.0 Received: by 10.70.91.139 with HTTP; Thu, 30 May 2013 09:48:34 -0700 (PDT) In-Reply-To: <20130530105753.722eec41@scorpio> References: <20130530132742.43455bba@bsd64.grem.de> <51A7413D.9010104@marino.st> <20130530150955.2916170a@bsd64.grem.de> <20130530105753.722eec41@scorpio> From: Eitan Adler Date: Thu, 30 May 2013 18:48:34 +0200 Message-ID: Subject: Re: shells/bash: Options slightly confusing To: freebsd-ports@freebsd.org Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQlxb8XAcze7mjteQ/plsAw9pJRnq/s3+wyixKeQzZoP+YTOwxnaQu7ga2TwPdl3cd1tgw01 X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 May 2013 16:49:05 -0000 On 30 May 2013 16:57, Jerry wrote: > I agree whole heartily. Unfortunately, all too many ports have > options that all cryptic in nature. There really needs to be better > documentation as to what the options actually do. Perhaps having an > additional file in each port named "OPTDESC", or whatever that would > list each available option for the port and exactly what it did would > prove useful. It certainly would not be a burden as over 90% of the > ports that have either none or just one or two options. Besides, if > some maintainer created a port with 40 or 50 configurable options, then > they certainly can take the time to fully document them. support for this file, called pkg-help, is on the way. -- Eitan Adler