Bug 266590

Summary:	dev-java/tomcat-servlet-api-6.0.18 doesn't come with a doc USE flag like dev-java/tomcat-servlet-api-5.5.27
Product:	Gentoo Linux	Reporter:	Mohamed Hazem <cviruss>
Component:	[OLD] Java	Assignee:	Java team <java>
Status:	RESOLVED WONTFIX
Severity:	minor	CC:	cviruss
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---
Bug Depends on:
Bug Blocks:	322979

Description Mohamed Hazem 2009-04-17 22:37:57 UTC

dev-java/tomcat-servlet-api-6.0.18 doesn't come with a doc USE flag like dev-java/tomcat-servlet-api-5.5.27

tomcat-servlet-api-5.5.27 installs the API docs for servlet 2.4 and jsp 2.0 inside /usr/share/doc/tomcat-servlet-api-5.5.27/

dev-java/tomcat-servlet-api-6.0.18 should have a doc USE flag to install the servlet 2.5 and jsp 2.1 docs inside /usr/share/doc as well
http://java.sun.com/products/jsp/2.1/docs/jsp-2_1-pfd2/index.html
http://java.sun.com/products/servlet/2.5/docs/servlet-2_5-mr2/index.html

I'm not sure whether this is a minor bug or an enhancement so I filed it as a minor bug anyways.

Reproducible: Always

Steps to Reproduce:
1.emerge =dev-java/tomcat-servlet-api-6.0.18
API docs for servlet 2.5 and jsp 2.1 are not available due to the lack of doc USE flag for the package


Expected Results:  
1- emerge =dev-java/tomcat-servlet-api-6.0.18 with doc USE flag
2- cd tomcat-servlet-api-6.0.18/ and the API docs shall be there

Comment 1 Mohamed Hazem 2009-04-17 22:39:04 UTC

> Expected Results:  
> 1- emerge =dev-java/tomcat-servlet-api-6.0.18 with doc USE flag
> 2- cd tomcat-servlet-api-6.0.18/ and the API docs shall be there


correction: cd /usr/share/doc/tomcat-servlet-api-6.0.18/ and the API docs shall be there

Comment 2 William L. Thomson Jr. 2011-03-07 22:12:32 UTC

Not sure why it wasn't added to versions beyond 5.5.x. But 6.0.x and 7.0.x versions do not have a doc use flag either. I will see about adding support for such time permitting.

Comment 3 William L. Thomson Jr. 2015-08-25 14:30:59 UTC

This has been addressed in 7 and 8, but not 6.

Comment 4 James Le Cuirot gentoo-dev

2015-08-25 23:16:41 UTC

6 doesn't include the Ant tasks for building the javadocs and refers to you an online copy instead. It's not worth our time trying to do it manually, especially when this isn't an issue for 7 or 8. Closing.