Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 122265 - digikam need a -doc flag
Summary: digikam need a -doc flag
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Gentoo KDE team
URL:
Whiteboard:
Keywords:
: 130749 (view as bug list)
Depends on:
Blocks:
 
Reported: 2006-02-09 08:50 UTC by Daniel Kukula
Modified: 2006-05-29 18:08 UTC (History)
5 users (show)

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 Daniel Kukula 2006-02-09 08:50:05 UTC
kuku@kuku ~ $ ACCEPT_KEYWORDS="~x86" emerge -pvt digikam
These are the packages that I would merge, in reverse order:

Calculating dependencies ...done!
[ebuild  N    ] media-gfx/digikam-0.8.1  -arts -debug -xinerama 0 kB 

kuku@kuku ~ $ ls -alh /usr/portage/distfiles/digikam-*
-rw-rw-r--  1 root portage 3,7M sty 21 16:17 /usr/portage/distfiles/digikam-0.8.1.tar.bz2
-rw-rw-r--  1 root portage  42M lis 25 23:25 /usr/portage/distfiles/digikam-doc-0.8.0.tar.bz2


as you see the docs for digicam are over 42 MB and the sources itself are only 4MB so I think it should be possible to disable the downloading od the doc files
Comment 1 Carsten Lohrke (RETIRED) gentoo-dev 2006-02-15 07:43:53 UTC
The doc use flag is for developer documentation, user documentation does always get installed, unless you't have "nodocs" in FEATURES, which doesn't affect downloading, though.
Comment 2 Jakub Moc (RETIRED) gentoo-dev 2006-04-21 09:48:24 UTC
*** Bug 130749 has been marked as a duplicate of this bug. ***
Comment 3 Jakub Moc (RETIRED) gentoo-dev 2006-04-21 09:52:22 UTC
May I ask why are we forcing people on dialup etc. to download 40+ megs (10x more than the whole app) of stuff they don't want/need?
Comment 4 Carsten Lohrke (RETIRED) gentoo-dev 2006-04-21 10:07:12 UTC
See comment #1.
Comment 5 Dmitry Suzdalev 2006-04-21 10:29:40 UTC
So, should I open another bug with title:
"Please add "nouserdoc" USE flag to gentoo" or something like that? :)
I really-really don't want to download such a huge docs, and as it turned out, I'm not alone :).
What do you think?

And please sorry for dup.
Honestly, I did a search on 'digikam doc' - it gave me 6 bugs, excluding this for some reason.
Comment 6 Carsten Lohrke (RETIRED) gentoo-dev 2006-04-21 12:01:32 UTC
(In reply to comment #5)
> So, should I open another bug with title:
> "Please add "nouserdoc" USE flag to gentoo" or something like that? :)
> I really-really don't want to download such a huge docs, and as it turned out,
> I'm not alone :).
> What do you think?

no* use flags shouldn't even exist, personally I wouldn't object having a devdoc and a userdoc use flag, though. To request this, a discussion on the gentoo-dev list would probably be better suited, but iirc this happened once and was shot down, with the argument that there's the nodoc feature flag. And when you look e.g. at Gnome packages for example, not even the doc use flag is always respected. It's a matter of consistency and maintenance cost in the first place. Admitted, using Gentoo and being solely dependend on dialup sucks.
Comment 7 Dmitry Suzdalev 2006-04-21 13:00:21 UTC
Not that it sucks, but sometimes I just refuse to download huge apps that are  not-critical for me :). (and also deltup worked _quite_ well until it became totally broken)

In this case I _want_ digikam on my system :).
So what can I do? Let me see:
1. Somehow reach developers crowd (IRC, gentoo-dev@gentoo.org, forums)
2. File a wish/bug
Right?
What's the best/preferrable? Maybe some other way? :)

Thanks for your input!
With best wishes,
Dmitry.
Comment 8 Jakub Moc (RETIRED) gentoo-dev 2006-04-21 13:08:15 UTC
(In reply to comment #4)
> See comment #1.

Yeah, I did, but it doesn't make much sense:

<snip>
03 Dec 2005; Carsten Lohrke <carlo@gentoo.org> +digikam-0.7.4-r1.ebuild, +digikam-0.8.0-r1.ebuild:
install user docs always
</snip>

This change was made fairly recently - I didn't actually notice that anyone would request this; since then people are requesting the exact opposite. 0.7.4 still had USE=doc and noone complained:

http://sources.gentoo.org/viewcvs.py/gentoo-x86/media-gfx/digikam/digikam-0.7.4.ebuild?hideattic=0&rev=1.4&view=markup

Really, common sense >> policy or some vague use flag description. The docs tarball is bigger than kernel sources... uh.
Comment 9 Carsten Lohrke (RETIRED) gentoo-dev 2006-04-25 10:33:10 UTC
(In reply to comment #8)
> This change was made fairly recently

No, it was single wrong ebuild.

For everything else please refer to my previous comments or discuss it on gentoo-dev.
Comment 10 Dmitry Suzdalev 2006-04-25 12:29:53 UTC
Well, while waiting for this bug to become resolved I copied digikam's ebuild to my portage overlay and removed all the doc stuff out of it.
Kind of a solution to me :))).
Comment 11 Jakub Moc (RETIRED) gentoo-dev 2006-05-29 08:37:23 UTC
Eh, so.... 

http://tinyurl.com/pv8g6

Please, put the USE="doc" back to the ebuild, there's apparently no such policy similar to what you've stated in Comment #1... If you wish to discuss what's in use.desc, then revive that thread, meanwhile we could stop annoying people w/ this cruft.
Comment 12 Carsten Lohrke (RETIRED) gentoo-dev 2006-05-29 09:02:35 UTC
Sorry that I didn't take part in that "discussion", but it's meaningless with so  few voices and it also missed a few point (as e.g. there is no difference made between stuff installed vs. downloaded). I would of course follow a clear policy, if we had one (and I'd welcome that, as it is indeed handled very different between maintiners/teams), but for now I simply say no.
Comment 13 Jakub Moc (RETIRED) gentoo-dev 2006-05-29 09:48:56 UTC
Removing myself, useless downloads for t3h win.
Comment 14 Diego Elio Pettenò (RETIRED) gentoo-dev 2006-05-29 10:41:30 UTC
I think common sense should be relevant here, more than policies and documentation.

QA team seems to not have problems to a semi-abuse of doc useflag under the rule of "requires extra download/time".

An alternative would be to ask upstream to split the packages by language and use LINGUAS setting to decide which one download.

I'll try to get a hold of someone in digikam's team later on. Anyway if nobody in QA disagrees tomorrow I would add the doc useflag. Users are more important than policies.
Comment 15 Mark Loeser (RETIRED) gentoo-dev 2006-05-29 10:54:11 UTC
The doc USE flag should be used when downloading/installing the documentation requires extra dependencies, a lot of extra space, or takes awhile to install (imho).  That seems to be the guideline that people follow, so adding a doc USE flag here makes perfect sense to me.  If you can get upstream to make it a more sane download (split up the languages), then you can get rid of the flag, but until then, please add the flag.  

(Anyone else on qa, you are welcome to disagree with me an offer a better solution, but I don't see one :) )
Comment 16 Henrik Brix Andersen 2006-05-29 11:07:30 UTC
On a side note, this is how we (ab?)use the doc flag in dev-embedded/avr-libc :)
Comment 17 Carsten Lohrke (RETIRED) gentoo-dev 2006-05-29 11:11:50 UTC
(In reply to comment #14)
> I think common sense should be relevant here, more than policies and
> documentation.

My idea of common sense is it to treat all KDE packages by the same standard. If you changes this arbitrarily, you can take care for this stuff in future.
Comment 18 Diego Elio Pettenò (RETIRED) gentoo-dev 2006-05-29 11:29:27 UTC
I would treat all by the same standard if all the packages had 10MB of extra documentation every 1MB of source code, that would be about 60 MB for amaroK..

Not all packages are the same identical thing, so while using the same standard main features, you need to tweak them on a per package basis. In this case, this is overkill to download every time.
Comment 19 Diego Elio Pettenò (RETIRED) gentoo-dev 2006-05-29 18:08:06 UTC
The new setup is in place, I'll take care of digiKam from now on, if nobody else wants to. In any case I'll write a maintainer's guide so that if I'll ever go MIA you won't be in trouble.