Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 81409

Summary: Java Docs 1.5 hardmasked ~amd64
Product: [OLD] Docs-developer Reporter: Steffen Jobbagy-Felso <meh6666>
Component: OtherAssignee: Java team <java>
Status: RESOLVED WONTFIX    
Severity: minor CC: davidgrant
Priority: High    
Version: unspecified   
Hardware: AMD64   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description Steffen Jobbagy-Felso 2005-02-09 13:53:00 UTC
I can't see any reason for masking a bunch of HTML files, even if the program they're documenting is hardmasked.. the docs aren't causing a problem, are they? ;)
So I think 1.5 docs should be unmasked and marked stable.

Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 Stefano Pacella (RETIRED) gentoo-dev 2005-02-09 15:54:45 UTC
it should be java team's work
Comment 2 Jan Brinkmann (RETIRED) gentoo-dev 2005-02-28 15:19:48 UTC
marking as WONTFIX to indicate that we're not going to unmask the docs without having the jdk1.5 unmasked. the problem is that users may get the impression that it's safe to use the jdk1.5 as the system vm and that would be bad at the moment.
Comment 3 Jan Brinkmann (RETIRED) gentoo-dev 2005-03-10 10:26:14 UTC
*** Bug 84766 has been marked as a duplicate of this bug. ***
Comment 4 David Grant 2005-03-10 10:50:54 UTC
Comment #2 implies that removing a hard-mask from the docs implies the removal of the hard mask from the sun-jdk? Doesn't make any sense. The mask will still be there. The biggest advantage of removing the hard mask from the docs is that as soon as a user adds sun-jdk-1.5* to /etc/portage/package.unmask and /etc/portage/package.keywords, he is ready to emerge it. Instead, users are forced to do another iteration when they find out that the docs are also masked.

Imagine you have an unstable package with 100 dependancies. You hard mask the unstable package. But do you hard mask all the dependancies just because the something which is masked depends on them? If you don't do that in this example, than don't do it in this case.

It also looks really bad. When I see java-docs hard masked, it makes me think that gentoo developers are on crack.
Comment 5 Jan Brinkmann (RETIRED) gentoo-dev 2005-03-10 11:08:19 UTC
well, there is no real need for offense. as i said before, it's obviously not an technical issue with the docs itself. the problem is that the jdk1.5 isn't ready for the normal use yet, if we unmask the docs for that package users may get the impression that it can't be to bad if they unmask the package itself. your example doesn't match the situation, sorry.
Comment 6 David Grant 2005-03-10 11:46:50 UTC
No offense, I was just kidding. Maybe I am the one on crack.

The question is, does gentoo have a policy of hard masking packages NOT based on the merits of that package or piece of software, but based on some other piece of software which depends on it.

I don't think anyone will notice that sun-jdk is unmasked like you say, and I even if they do notice I don't think they will draw any inferences from that about the stability or lack therof of sun-jdk.  They will only notice if it is masked. It will seem natural that the doc package is stable but the real package isn't. It makes perfect sense.
Comment 7 David Grant 2005-03-10 11:48:06 UTC
BTW, it's 2-1 now in favour of unmasking. The process should be democratic no?
Comment 8 David Grant 2005-03-10 11:48:57 UTC
A compromise: add a reason for why the docs are masked in the mask file so that users see the reason when they try to emerge it.