Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-dev
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-dev@g.o
From: Mike Frysinger <vapier@g.o>
Subject: Re: Re: Re: comprehensive eclass checking in repoman
Date: Fri, 25 May 2012 15:02:57 -0400
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 \
	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
Attachment:
signature.asc (This is a digitally signed message part.)
References:
comprehensive eclass checking in repoman
-- Mike Frysinger
Re: Re: comprehensive eclass checking in repoman
-- Mike Frysinger
Re: Re: comprehensive eclass checking in repoman
-- Steven J Long
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: Re: comprehensive eclass checking in repoman
Next by thread:
Re: comprehensive eclass checking in repoman
Previous by date:
Re: Re: comprehensive eclass checking in repoman
Next by date:
new qa warning: append-flags will complain about preprocessor flags


Updated Jun 29, 2012

Summary: Archive of the gentoo-dev mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.