From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 6BAAF138CBD for ; Thu, 12 Mar 2015 13:55:13 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 1CFA1E087E; Thu, 12 Mar 2015 13:55:12 +0000 (UTC) Received: from plane.gmane.org (plane.gmane.org [80.91.229.3]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 8F235E086A for ; Thu, 12 Mar 2015 13:55:11 +0000 (UTC) Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1YW3Zn-0008DU-Gv for gentoo-portage-dev@lists.gentoo.org; Thu, 12 Mar 2015 14:55:04 +0100 Received: from ip68-231-22-224.ph.ph.cox.net ([68.231.22.224]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 12 Mar 2015 14:55:03 +0100 Received: from 1i5t5.duncan by ip68-231-22-224.ph.ph.cox.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 12 Mar 2015 14:55:03 +0100 X-Injected-Via-Gmane: http://gmane.org/ To: gentoo-portage-dev@lists.gentoo.org From: Duncan <1i5t5.duncan@cox.net> Subject: [gentoo-portage-dev] Re: RFC: emerge manpage options categorization Date: Thu, 12 Mar 2015 13:52:56 +0000 (UTC) Message-ID: References: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-portage-dev@lists.gentoo.org Reply-to: gentoo-portage-dev@lists.gentoo.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: ip68-231-22-224.ph.ph.cox.net User-Agent: Pan/0.140 (Chocolate Salty Balls; GIT 10ca3f5) X-Archives-Salt: 392d7842-4a41-4e30-adb7-78948825af2e X-Archives-Hash: 0d1fd1f44b0dadf17ab4dead2a89d628 Kent Fredric posted on Thu, 12 Mar 2015 15:23:59 +1300 as excerpted: > On 12 March 2015 at 15:19, Duncan <1i5t5.duncan@cox.net> wrote: > >> Comments? > > > A less radical change would be some sort of tagging notation on each > feature to indicate their usage. > > That way, it doesn't impede the current audience who expects to be able > to browse the list alphabetically. > > ( I suggest this, because restructuring it radically will have potential > bikeshed drama of people not liking the new layout, so tag-style > metadata makes the levels visible without requiring a restructure ) Tags would be less radical, indeed, and an improvement from current, agreed. But as envisioned, the alphabetic order of all options (including those listed in the other sections, as I mentioned in the original proposal) would be maintained in the all options section, precisely because it remains useful to have an alphabetically ordered full-reference section. Tho as proposed, that all-options section may /optionally/ be moved into its own manpage, with an explicit note to that effect in the main manpage. Among other things that would avoid an already long manpage made longer by repeated option descriptions. But I don't feel strongly enough about such a split to make it a big deal if others don't like the idea, the the "optional" qualifier. IOW, people that didn't like the new layout could simply refer to the all- options section or separate manpage for the old alphabetically-ordered full reference layout, which should hopefully reduce resistance dramatically. =:^) -- Duncan - List replies preferred. No HTML msgs. "Every nonfree program has a lord, a master -- and if you use the program, he is your master." Richard Stallman