List Archive: gentoo-dev
Note: Due to technical difficulties, the Archives are currently not up to date.
provides an alternative service for most mailing lists.c.f. bug 424647
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-to-manpage.sh \
warning:41: alternatives.eclass: no @MAINTAINER found
error:103: eclass not documented yet (no @ECLASS found)
warning:12: Unexpected tag in "funcvar" state: # @DESCRIPTION:
signature.asc (This is a digitally signed message part.)