• Post Reply Bookmark Topic Watch Topic
  • New Topic

Obtaining Javadoc for the JSTL tag library, version 1.2

 
Mark E Hansen
Ranch Hand
Posts: 650
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
I'm getting started with JSTL, using version 1.2, and am trying to find Javadoc for the tags. I found the following for version 1.1: http://java.sun.com/products/jsp/jstl/1.1/docs/tlddocs/index.html, but nothing for version 1.2

I read that I can create the Javadoc using the tag library documentation utility, tlddoc. I downloaded version 1.3 of this utility and tried to run it against the jstl-1.2.jar, but it fails saying that there are two tag libraries with the same short name, and this is not yet supported.

Is the specification PDF really the only way to get the tag library usage information? Is a javadoc available for it? Javadoc is far easier for me when I just need a quick reference for the use of a particular tag.

Thanks,
 
Bear Bibeault
Author and ninkuma
Marshal
Posts: 65530
108
IntelliJ IDE Java jQuery Mac Mac OS X
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
The link's from the Sun/Oracle JSTL 1.2 pages still point to the 1.1 JavaDoc, so I imagine it's not available.

If you want to use tlddoc, you could try dissecting the jar file to excise the offending parts.
 
Mark E Hansen
Ranch Hand
Posts: 650
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Thanks, I did try taking apart the Jar, but didn't see any way to limit the doc generation to only those portions I was interested in.

I guess if there's no javadoc for 1.2, then either people don't use the javadoc, or the 1.1 version is good enough?

Thanks again,
 
Bear Bibeault
Author and ninkuma
Marshal
Posts: 65530
108
IntelliJ IDE Java jQuery Mac Mac OS X
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
I use either the 1.1 javadoc or refer to the spec when I need to.
 
Mark E Hansen
Ranch Hand
Posts: 650
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Bear Bibeault wrote:I use either the 1.1 javadoc or refer to the spec when I need to.

I must say, I find the lack of Javadoc quite disappointing. Oh well.
Thanks for the help.
 
Vijitha Kumara
Bartender
Posts: 3952
21
Chrome Fedora Hibernate
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Bear Bibeault wrote:The link's from the Sun/Oracle .........

Can we call it like that.. ?
 
Bear Bibeault
Author and ninkuma
Marshal
Posts: 65530
108
IntelliJ IDE Java jQuery Mac Mac OS X
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Vijitha Kumara wrote:
Bear Bibeault wrote:The link's from the Sun/Oracle .........

Can we call it like that.. ?

Judge for yourself.
 
Ulf Dittmer
Rancher
Posts: 42970
73
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Mark E Hansen wrote:I read that I can create the Javadoc using the tag library documentation utility, tlddoc. I downloaded version 1.3 of this utility and tried to run it against the jstl-1.2.jar, but it fails saying that there are two tag libraries with the same short name, and this is not yet supported.

You probably ran it against all 15 TLDs, but there is some duplication due to the presence of the obsolete 1.0-style TLDs. If you remove those it should work fine.

From the changelog it looks as if the differences to JSTL 1.1 are pretty minor, though.
 
Mark E Hansen
Ranch Hand
Posts: 650
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Thanks, Ulf. It's interesting that in looking at the various .tld files in the 1.2 release, they show the TLD version as 1.1.
Anyway, I guess I'll just use the 1.1 Javadoc for now.

Thanks again to all who helped.
 
  • Post Reply Bookmark Topic Watch Topic
  • New Topic
Boost this thread!