Bug 956346 - Hibernate4 javadoc must be installed to versioned directory with unversioned symlink
Summary: Hibernate4 javadoc must be installed to versioned directory with unversioned ...
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: JBoss Enterprise Web Server 2
Classification: JBoss
Component: unspecified
Version: unspecified
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ER03
: 2.1.0
Assignee: Dave Stahl
QA Contact: Michal Haško
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-04-24 18:26 UTC by David Walluck
Modified: 2015-11-09 01:10 UTC (History)
9 users (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2014-08-08 08:07:06 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description David Walluck 2013-04-24 18:26:45 UTC
The current productization policy is to install aggregate javadocs into %{_javadocdir}/%{name}-%{namedversion}, where %{name} is usually the package name and %{namedversion} is the full productized version (usually this is NOT equal to the RPM %{version}). Then, an unversioned symlink to this directory is added. It's currently using an unversioned directory, which doesn't match other packages.

Also, the use of wildcards in the file list may exacerbate this problem. When you do something like 

%files
%_javadocdir/*

it is not immediately apparent what directories are going to be included, so spotting a bug in the files is more difficult.

Version-Release number of selected component: hibernate4-4.2.0-4.Final_redhat_1.ep6.el6.

Comment 1 Permaine Cheung 2013-04-24 18:31:56 UTC
The affected component is hibernate, but as we currently do not have a hibernate component, we've put it under unspecified for now, I have asked John to create that for us and will move this to the appropriate component when it is created.

Assigning to Dave.

Comment 4 Dave Stahl 2014-06-18 12:44:39 UTC
Fix in included in the hibernate upgrade.

Comment 6 Libor Fuka 2014-06-19 06:49:07 UTC
Checked in EWS 2.1.0-ER3 and its not correct i think.
We have these directory structure in hibernate-dist.zip:
hibernate-release-4.2.13.Final-redhat-1/documentation/javadocs/...

Comment 7 Dave Stahl 2014-06-23 19:22:51 UTC
(In reply to Libor Fuka from comment #6)
> Checked in EWS 2.1.0-ER3 and its not correct i think.
> We have these directory structure in hibernate-dist.zip:
> hibernate-release-4.2.13.Final-redhat-1/documentation/javadocs/...

I was under the impression that this bug was referring to the javadoc directory installed by the RPM rather than what is contained in the zip. 
ie. /usr/share/javadoc/hibernate4 -> hibernate-4.2.13.Final-redhat-1

Comment 8 David Walluck 2014-06-23 19:41:53 UTC
(In reply to Dave Stahl from comment #7)
> I was under the impression that this bug was referring to the javadoc
> directory installed by the RPM rather than what is contained in the zip. 
> ie. /usr/share/javadoc/hibernate4 -> hibernate-4.2.13.Final-redhat-1

Correct. This bug is RPM-only.

Comment 10 Michal Haško 2014-08-08 08:07:06 UTC
hibernate4-javadoc-eap6 subpackage is dropped in 2.1.0.

Comment 11 Misha H. Ali 2014-08-09 05:59:25 UTC
I'm assuming we don't want to document this in the Release Notes so I'm removing the flag.


Note You need to log in before you can comment on or make changes to this bug.