On Sunday 24 April 2011 21:30:33 Neil Bothwick wrote:
> On Sun, 24 Apr 2011 21:17:23 +0100, David W Noon wrote:
> > >Doing this today I've had a couple of packages that needed to be
> > >emerged with USE=-doc when they failed.
> > 
> > Those would be jinja and sphinx.  They are notorious for their circular
> > dependency, which requires USE='-doc' to bypass.
> 
> It's rarely desirable to enable doc globally. It is best to enable only
> for those packages where you need extended documentation.

@Alan Mackenzie:

What Neil is saying can be achieved by setting package specific USE flags in 
the file /etc/portage/package.use; e.g. use an entry like:

dev-python/jinja -doc i18n

to exclude USE flag "doc", but include "i18n".
-- 
Regards,
Mick