[TAP5-2288] Improve JavaDoc clarity for @Cached annotation.

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 5.4
• Component/s: tapestry-core
• Labels: documentation
• Assignee: Bob Harner
• Reporter: Michael Gentry
• Created: 18/Feb/14 19:58
• Updated: 22/Feb/14 19:09
• Resolved: 22/Feb/14 19:09

Description

The JavaDoc for the @Cached annotation:

https://github.com/apache/tapestry-5/blob/master/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Cached.java

Says:

"Indicates that a method should only be evaluated once and the result cached. All further calls to the method will return the cached result."

This implies the value is cached forever, but this link says per-request:

http://tapestry.apache.org/component-cheat-sheet.html

Please correct the JavaDoc or cheat sheet to specify the actual cached duration (forever, session, request, etc).

Thanks!