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 <chris.spike(a)arcor.de&gt; [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 <chris.spike(a)arcor.de&gt; [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 <chris.spike(a)arcor.de&gt; [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