apache-commons and javadoc symlinks

[Chris Spike]

Hi,

While most of the java libraries copy their javadocs to
{_javadocdir}/%{name}-%{version} and provide a symlink
{_javadocdir}/%{name}, some simply copy the files to
{_javadocdir}/%{name} (like commons-compress or commons-math).
As long as there is an unversioned dir, I actually don't see any
problems (or necessity for the versioned symlink), but I'm curious: Is
there any recommendation on this?

Regards, Chris

[Andrew Overholt]

Hi,

* Chris Spike  [2010-07-08 06:43]:
> While most of the java libraries copy their javadocs to
> {_javadocdir}/%{name}-%{version} and provide a symlink
> {_javadocdir}/%{name}, some simply copy the files to
> {_javadocdir}/%{name} (like commons-compress or commons-math).
> As long as there is an unversioned dir, I actually don't see any
> problems (or necessity for the versioned symlink), but I'm curious: Is
> there any recommendation on this?

There's probably something here:

https://fedoraproject.org/wiki/Packaging/Java

Andrew

[Chris Spike]

On 07/08/2010 04:59 PM, Andrew Overholt wrote:
> Hi,
> Chris Spike  [2010-07-08 06:43]:
> > While most of the java libraries copy their javadocs to
> > {_javadocdir}/%{name}-%{version} and provide a symlink
> > {_javadocdir}/%{name}, some simply copy the files to
> > {_javadocdir}/%{name} (like commons-compress or commons-math).
> > As long as there is an unversioned dir, I actually don't see any
> > problems (or necessity for the versioned symlink), but I'm curious: Is
> > there any recommendation on this?
>
> There's probably something here:
>
> https://fedoraproject.org/wiki/Packaging/Java

Unfortunately not. Neither on Packaging:Java nor on the draft update[1]

Regards, Chris

[1] https://fedoraproject.org/wiki/User:Abo/JavaPackagingDraftUpdate

[Alexander Boström]

sön 2010-07-11 klockan 11:13 +0200 skrev Chris Spike:
> On 07/08/2010 04:59 PM, Andrew Overholt wrote:
> > Hi,
> > Chris Spike  [2010-07-08 06:43]:
> > > As long as there is an unversioned dir, I actually don't see any
> > > problems (or necessity for the versioned symlink), but I'm curious: Is
> > > there any recommendation on this?
> > https://fedoraproject.org/wiki/Packaging/Java
>
> Unfortunately not. Neither on Packaging:Java nor on the draft update[1]
> [1] https://fedoraproject.org/wiki/User:Abo/JavaPackagingDraftUpdate

Yeah, the current guidelines do not say anything clear about it, but the
samples say %{name}. In the draft it says both ways are allowed, but
that doesn't really help much. The samples still say %{name}.

I don't have any strong opinion. %{name} is simpler, but
%{name}-%{version} in analogous with /usr/share/doc.

/Alexander