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: Steven J Long <slong@...>
Subject: Re: comprehensive eclass checking in repoman
Date: Thu, 24 May 2012 23:16:23 +0100
Mike Frysinger wrote:
> ..the proposal is to utilize the existing eclass documentation markers
> ..the metadata stays current, and we can scale better to all eclasses

> if people don't properly document their eclasses, repoman might throw
> false positives (warnings, not errors) about unused eclasses

> will miss throwing errors when functions are used but the respective
> eclasses aren't inherited.

> however, i think that's a good hammer to throw at eclass maintainers to
> keep their documentation up-to-date and accurate.
> any other opinions/feedback?

I think it's an excellent idea to give this kind of QA early, to avoid 
issues like recent eutils inheritance changes in the future; it's not a 
hammer so much as a helpful reminder, that improves things for everyone. 

You could maybe tighten the false-negative side by scanning all functions 
defined in an eclass, and warning if they're undocumented.

Steve.
-- 
#friendly-coders -- We're friendly, but we're not /that/ friendly ;-)




Replies:
Re: Re: comprehensive eclass checking in repoman
-- Mike Frysinger
References:
comprehensive eclass checking in repoman
-- Mike Frysinger
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: comprehensive eclass checking in repoman
Next by thread:
Re: Re: comprehensive eclass checking in repoman
Previous by date:
Re: Portage Git migration - Handling Pull Requests (Was: clean cut or git-cvsserver)
Next by date:
Re: Re: comprehensive eclass checking in repoman


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.