Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 353705 - app-portage/eix-0.22.7: About USE=doc, suggestions
Summary: app-portage/eix-0.22.7: About USE=doc, suggestions
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: High enhancement
Assignee: Martin Väth
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-02-04 17:48 UTC by Jeremy Olexa (darkside) (RETIRED)
Modified: 2011-03-12 04:45 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jeremy Olexa (darkside) (RETIRED) archtester gentoo-dev Security 2011-02-04 17:48:17 UTC
Martin,

I'd like to suggest the following:

a) Install html files in $docdir/html so that the docompress line can be dropped.
b) Include prebuilt html files in the release archive so USE=doc can be dropped. I don't see the point to having an extra dep for [only] 2 files.

Thanks.
Comment 1 Martin Väth 2011-02-04 23:53:05 UTC
(In reply to comment #0)
> a) Install html files in $docdir/html so that the docompress line can be
> dropped.

This is not a question of eix but of the ebuild:
Just keep the ./configure option
  --htmldir="${EPREFIX}/usr/share/doc/${PF}/html"
(as in older eix ebuilds) and remove the src_install function.
The disadvantage is that it appears a bit strange to have a subdirectory
for only 2 files.
(In the svn trunk, I treat eix-xml.xsd now as doc and not as html -
not sure whether it will stay this way.)

Another possibility might be to install everything in $docdir and compress
the html: The few developers who need the files can uncompress them before
reading them (see below)...

> b) Include prebuilt html files in the release archive so USE=doc can be
> dropped. I don't see the point to having an extra dep for [only] 2 files.

I modified the build system in the svn trunk such that they are shipped,
and I removed --with-rst

However, instead I added --with-extra-doc:

It appears a bit strange to install a lot documentation on everybody's
system (among them about 30k uncompressed(!) html) which is actually only
of interest for the very few people developing applications based on eix.
So I suggest to keep IUSE=doc but to change
  $(use_with doc rst)
into
  $(use_with_doc extra-doc)
Of course, the DEPEND on dev-utils/docutils can vanish in any case for the
new tarballs.
Comment 2 Jeremy Olexa (darkside) (RETIRED) archtester gentoo-dev Security 2011-03-12 04:45:02 UTC
0.22.8 committed.