From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 5E5D21396D0 for ; Wed, 6 Sep 2017 18:39:37 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 653ACE0DA7; Wed, 6 Sep 2017 18:39:31 +0000 (UTC) Received: from avasout08.plus.net (avasout08.plus.net [212.159.14.20]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id F30E2E0D82 for ; Wed, 6 Sep 2017 18:39:30 +0000 (UTC) Received: from mailserver ([209.93.137.200]) by avasout08 with smtp id 6JfU1w0024Kc8E901JfVnQ; Wed, 06 Sep 2017 19:39:29 +0100 X-CM-Score: 0.00 X-CNFS-Analysis: v=2.2 cv=EJl26xRC c=1 sm=1 tr=0 a=g14KNUlykCmuQU4Ld1dqZg==:117 a=g14KNUlykCmuQU4Ld1dqZg==:17 a=IkcTkHD0fZMA:10 a=x7bEGLp0ZPQA:10 a=YbTMELGUhT8A:10 a=7mOBRU54AAAA:8 a=D8LHKImjSAp-r3bC-t0A:9 a=QEXdDO2ut3YA:10 a=wa9RWnbW_A1YIeRBVszw:22 Subject: Re: [gentoo-dev] [PATCH] eutils.eclass: Document optfeature suggests packages not installed To: gentoo-dev@lists.gentoo.org References: <20170903155608.22737-1-aklhfex@gmail.com> From: Chris Mayo Message-ID: Date: Wed, 6 Sep 2017 19:39:28 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.3.0 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Language: en-GB Content-Transfer-Encoding: 7bit X-Archives-Salt: 2ce22241-2a22-4749-a107-cdfe2a08e006 X-Archives-Hash: 50c449635393f6154b3ff8b25e5cef66 On 03/09/17 22:22, Michael Orlitzky wrote: > On 09/03/2017 11:56 AM, Chris Mayo wrote: >> # >> # The following snippet would suggest app-misc/foo for optional foo support, >> # app-misc/bar or app-misc/baz[bar] for optional bar support >> > > Would the @EXAMPLE tag[0] make sense here? > > > [0] https://devmanual.gentoo.org/eclass-writing/index.html > I believe @EXAMPLE is only for the first documentation block introducing the eclass. At least where it is used for functions the text doesn't show up in the man page. e.g. prefix.eclass hprefixify() and prefixify_ro() https://devmanual.gentoo.org/eclass-reference/prefix.eclass/index.html https://gitweb.gentoo.org/repo/gentoo.git/tree/eclass/prefix.eclass?id=61b861acd7b49083dab687e133f30f3331cb7480