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