Struts Javadoc Missing

[Charles Curley]

I have installed struts on FC5:

[root@charlesc ~]# pre struts
struts-manual-1.2.8-2jpp_9fc
struts11-manual-1.1-1jpp_7fc
struts-javadoc-1.2.8-2jpp_9fc
struts11-javadoc-1.1-1jpp_7fc
struts-1.2.8-2jpp_9fc
struts-webapps-tomcat5-1.2.8-2jpp_9fc

I restarted Tomcat to make sure it reloaded everything. However, when
I go to the struts docs
(http://charlesc.localdomain:8080/struts-documentation/), and click on
the javadoc link, I get a 404:

type Status report

message /struts-documentation/api/index.html

description The requested resource
(/struts-documentation/api/index.html) is not available.

The subdirectory api is not in
/usr/share/tomcat5/webapps/struts-documentation/.

Am I doing something wrong or have I hit a bug?

-- 

Charles Curley                  /"\    ASCII Ribbon Campaign
Looking for fine software       \ /    Respect for open standards
and/or writing?                  X     No HTML/RTF in email
http://www.charlescurley.com    / \    No M$ Word docs in email

Key fingerprint = CE5C 6645 A45A 64E4 94C0  809C FFF6 4C48 4ECD DFDB

[Anthony Green]

On Wed, 2006-11-08 at 20:20 -0700, Charles Curley wrote:
>  I restarted Tomcat to make sure it reloaded everything. However,
> when
>  I go to the struts docs
>  (http://charlesc.localdomain:8080/struts-documentation/), and click on
>  the javadoc link, I get a 404:
>  
>  type Status report
>  
>  message /struts-documentation/api/index.html
>  
>  description The requested resource
>  (/struts-documentation/api/index.html) is not available.
>  
>  The subdirectory api is not in
>  /usr/share/tomcat5/webapps/struts-documentation/.
>  
>  Am I doing something wrong or have I hit a bug? 
I don't have a FC5 machine handy to test this on but, for what it's
worth, this works perfectly on FC6.

AG

[Anthony Green]

On Thu, 2006-11-09 at 07:05 -0800, Anthony Green wrote:
>  I don't have a FC5 machine handy to test this on but, for what
> it's
>  worth, this works perfectly on FC6. 
Oops - I take this back.  I didn't read your note properly.  Yes, the
javadoc API link is busted.  This looks like a simple packaging bug.
I'll file a bug report.

AG

[Charles Curley]

On Thu, Nov 09, 2006 at 07:53:04AM -0800, Anthony Green wrote:
>  On Thu, 2006-11-09 at 07:05 -0800, Anthony Green wrote:
>  > I don't have a FC5 machine handy to test this on but, for what it's
>  > worth, this works perfectly on FC6.
>  
>  Oops - I take this back.  I didn't read your note properly.  Yes, the
>  javadoc API link is busted.  This looks like a simple packaging bug.
>  I'll file a bug report. 
Thank you. It is 214812, should anyone else wish to track it.

For what it's worth, I did eventually find the errant javadoc. It's in
/usr/share/javadoc/, along with a whole slew of other javadoc, the
existence of which I had not previously suspected.

Since it seems rather silly to have a bunch of javadoc inaccessible by
browser, I added the following to my http.conf for apache (right after
the similar stanza for /usr/share/doc/):


# Allow access to local system javadoc documentation
Alias /javadoc/ /usr/share/javadoc/
<Location /javadoc>
  order deny,allow
  deny from all
  allow from ....
  Options Indexes FollowSymLinks
</Location>

Perhaps someone would be kind enough to add something like that to the
standard Fedora Java packaging?

-- 

Charles Curley                  /"\    ASCII Ribbon Campaign
Looking for fine software       \ /    Respect for open standards
and/or writing?                  X     No HTML/RTF in email
http://www.charlescurley.com    / \    No M$ Word docs in email

Key fingerprint = CE5C 6645 A45A 64E4 94C0  809C FFF6 4C48 4ECD DFDB

[Andrew Haley]

Charles Curley writes:
>  On Thu, Nov 09, 2006 at 07:53:04AM -0800, Anthony Green wrote:
>  > On Thu, 2006-11-09 at 07:05 -0800, Anthony Green wrote:
>  > > I don't have a FC5 machine handy to test this on but, for what it's
>  > > worth, this works perfectly on FC6.
>  > 
>  > Oops - I take this back.  I didn't read your note properly.  Yes, the
>  > javadoc API link is busted.  This looks like a simple packaging bug.
>  > I'll file a bug report.
>  
>  Thank you. It is 214812, should anyone else wish to track it.
>  
>  For what it's worth, I did eventually find the errant javadoc. It's in
>  /usr/share/javadoc/, along with a whole slew of other javadoc, the
>  existence of which I had not previously suspected.
>  
>  Since it seems rather silly to have a bunch of javadoc inaccessible by
>  browser, 
It's not inaccessible by browser.

   firefox /usr/share/javadoc/struts-1.2.4/

works for me.

Andrew.