On Mon, Dec 12, 2016 at 9:44 PM, Mike Gilbert <flop...@gentoo.org> wrote: > On Mon, Dec 12, 2016 at 7:34 PM, Mike Pagano <mpag...@gentoo.org> wrote: >> According to PMS, @USAGE is required for functions. >> This patch only touches comments and no code has been modified. > > PMS says nothing on the topic of eclass documentation syntax. > > Any requirements are imposed by the eclass-manpages awk script.
Maybe you were referring to the devmanual (not PMS)? https://devmanual.gentoo.org/eclass-writing/index.html Personally, I don't think it makes sense to add an empty @USAGE entry for functions that take no arguments.
