From owner-freebsd-ports@FreeBSD.ORG Mon Aug 16 22:36:29 2010 Return-Path: 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 CB33010656A7 for ; Mon, 16 Aug 2010 22:36:29 +0000 (UTC) (envelope-from swell.k@gmail.com) Received: from mail-vw0-f54.google.com (mail-vw0-f54.google.com [209.85.212.54]) by mx1.freebsd.org (Postfix) with ESMTP id 7DBBC8FC18 for ; Mon, 16 Aug 2010 22:36:29 +0000 (UTC) Received: by vws7 with SMTP id 7so4701589vws.13 for ; Mon, 16 Aug 2010 15:36:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:subject:date :message-id:user-agent:mime-version:content-type; bh=aRv+iU9/X7RNUuNn9mWa7mAcKebbmk8FisPpoV4KVlQ=; b=B1/FFESKY0HPk0lNm+pJM/0zWiTVaX7pCqO+u20H4wD4Ya7OqwmgXxakWLUYRQUkH3 n0PfRoAdiL11qBdiAv+Rxq5qqHPXs30Q8SvreMjVMrEbvMqf5TQO/3beK3/NKvV8wPUk qpfxBeipoCAaikW7SIAXUnt1tD6Ip5vhH1O58= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:subject:date:message-id:user-agent:mime-version :content-type; b=NQA7YGwBisSXG+0z7KmQYGIQdgLwZWuf1kB47MrEycEpTdrHAGTaiaZLX4MJOtICvE 7W5K23EtX5rJDf+88rI7YtWYz9+Qhym775wKWEF+EnTIeEV5P+icTE7AOfVddmEoWYLP We8ZdbiVNAUR+6E4MmoMrKU6qHdxlFrCzfe3c= Received: by 10.220.168.213 with SMTP id v21mr3521267vcy.274.1281998188634; Mon, 16 Aug 2010 15:36:28 -0700 (PDT) Received: from localhost ([80.62.217.18]) by mx.google.com with ESMTPS id q12sm1978959vcf.11.2010.08.16.15.36.26 (version=SSLv3 cipher=RC4-MD5); Mon, 16 Aug 2010 15:36:28 -0700 (PDT) From: Anonymous To: freebsd-ports@FreeBSD.org Date: Tue, 17 Aug 2010 02:31:27 +0400 Message-ID: <86bp92i400.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: Subject: [portmaster] navigation in the man page 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: Mon, 16 Aug 2010 22:36:29 -0000 Am I the only one who finds it hard to navigate in portmaster(8)? - options are neither sorted alphabetically nor grouped in blocks[1] - too little space between an option and its description - inconsistent in using terms (flags vs. options) - being too verbose about port-related terms[2] - SYNOPSYS makes a spaghetti with one-letter options, long options and comments[3] - DESCRIPTION is too verbose, it should go either to EXAMPLES or to a specific option description[4] in OPTIONS - `-i' option is misleading, portmaster is already quite interactive On the side, I still can't find how to shut up portmaster from asking me about +IGNOREME ports. [1] look at how grouping is done in grep(1) from textproc/gnugrep [2] Like the one below [-R] -r name/glob of port directory in /var/db/pkg Why not use `origin' or `pkg-name' term from pkg_info(1)? WTF is `port directory in /var/db/pkg' ? Only *package* directories lie there. [3] Smth like `portmaster [options] [args...]' is probably enough. There is already EXAMPLES section, no need to duplicate it. [4] I for one read DESCRIPTION only once, when first run the tool and never again. Most of the time I'm more concerned how certain option changes behavior and not interested in general prose.