Gentoo Archives: gentoo-dev

From: Mike Frysinger <vapier@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] Re: Re: comprehensive eclass checking in repoman
Date: Fri, 25 May 2012 19:02:21
In Reply to: [gentoo-dev] Re: Re: comprehensive eclass checking in repoman by Steven J Long
On Friday 25 May 2012 14:38:34 Steven J Long wrote:
> > Steven J Long wrote: > >> You could maybe tighten the false-negative side by scanning all > >> functions defined in an eclass, and warning if they're undocumented. > > > > that happens now when you emerge eclass-manpages, but i suspect no one > > cares. if you run the script by hand on your eclass, it'll tell you the > > same thing. > > So, if eclass-manpages /is/ installed, then it gets used to check the > documentation by repoman?
no. while generating the manpages, the script will warn you bad comment blocks or unknown keywords. $ cd /usr/portage $ ./app-portage/eclass-manpages/files/ \ eclass/*.eclass ... alternatives.eclass: warning:41: alternatives.eclass: no @MAINTAINER found ... gnuconfig.eclass: error:103: eclass not documented yet (no @ECLASS found) ... leechcraft.eclass: warning:12: Unexpected tag in "funcvar" state: # @DESCRIPTION: ... -mike


File name MIME type
signature.asc application/pgp-signature