Author: hlship
Date: Wed Nov 2 15:20:43 2011
New Revision: 1196621
URL: http://svn.apache.org/viewvc?rev=1196621&view=rev
Log:
Fix some JavaDoc warnings, enable index splitting and link to source
Modified:
tapestry/tapestry5/branches/5.3/build.gradle
tapestry/tapestry5/branches/5.3/plastic/src/main/java/org/apache/tapestry5/internal/plastic/Lockable.java
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/StreamableResourceProcessing.java
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/security/ClientWhitelist.java
tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/InitializationPlan.java
tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/PeriodicExecutor.java
Modified: tapestry/tapestry5/branches/5.3/build.gradle
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/branches/5.3/build.gradle?rev=1196621&r1=1196620&r2=1196621&view=diff
==============================================================================
--- tapestry/tapestry5/branches/5.3/build.gradle (original)
+++ tapestry/tapestry5/branches/5.3/build.gradle Wed Nov 2 15:20:43 2011
@@ -203,6 +203,8 @@ task aggregateJavadoc(type: Javadoc, gro
destinationDir = javadocBuildDir.dir
configure(options) {
// overview = new File( projectDir, 'src/javadoc/package.html' )
+ splitIndex = true
+ linkSource = true
stylesheetFile = new File(projectDir, 'src/javadoc/stylesheet.css')
windowTitle = 'Tapestry API Documentation'
docTitle = "Tapestry JavaDoc ($project.version)"
@@ -211,7 +213,6 @@ task aggregateJavadoc(type: Javadoc, gro
links = ['http://download.oracle.com/javase/6/docs/api/',
'http://download.oracle.com/javaee/6/api/']
addStringOption "tagletpath", configurations.javadoc.asPath
addStringOption "taglet",
"org.apache.tapestry5.javadoc.TapestryDocTaglet"
-
exclude "org/apache/tapestry5/internal/plastic/asm/**"
}
Modified:
tapestry/tapestry5/branches/5.3/plastic/src/main/java/org/apache/tapestry5/internal/plastic/Lockable.java
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/branches/5.3/plastic/src/main/java/org/apache/tapestry5/internal/plastic/Lockable.java?rev=1196621&r1=1196620&r2=1196621&view=diff
==============================================================================
---
tapestry/tapestry5/branches/5.3/plastic/src/main/java/org/apache/tapestry5/internal/plastic/Lockable.java
(original)
+++
tapestry/tapestry5/branches/5.3/plastic/src/main/java/org/apache/tapestry5/internal/plastic/Lockable.java
Wed Nov 2 15:20:43 2011
@@ -26,7 +26,7 @@ public class Lockable
/**
* Checks to see if the object has been locked.
*
- * @throw IllegalStateException if {@link #lock()} has been invoked.
+ * @throws IllegalStateException if {@link #lock()} has been invoked.
*/
protected void check()
{
Modified:
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java?rev=1196621&r1=1196620&r2=1196621&view=diff
==============================================================================
---
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java
(original)
+++
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java
Wed Nov 2 15:20:43 2011
@@ -336,8 +336,7 @@ public class Tree
/**
* Returns the actual {@link TreeSelectionModel} in use for this Tree
component,
- * as per the {@link #selectionModel} parameter. This is often, but not
always, the same
- * as {@link #getDefaultTreeSelectionModel()}.
+ * as per the {@link #selectionModel} parameter.
*/
public TreeSelectionModel getSelectionModel()
{
Modified:
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/StreamableResourceProcessing.java
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/StreamableResourceProcessing.java?rev=1196621&r1=1196620&r2=1196621&view=diff
==============================================================================
---
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/StreamableResourceProcessing.java
(original)
+++
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/StreamableResourceProcessing.java
Wed Nov 2 15:20:43 2011
@@ -20,9 +20,9 @@ import org.apache.tapestry5.services.jav
/**
* Defines additional features desired when accessing the content of a {@link
Resource} as
* a {@link StreamableResource}.
- *
+ *
+ * @see StreamableResourceSource
* @since 5.3
- * @see StreamableResourceSource#getStreamableResource(Resource,
StreamableResourceProcessing)
*/
public enum StreamableResourceProcessing
{
@@ -42,7 +42,7 @@ public enum StreamableResourceProcessing
/**
* Turns off all caching and minification of the resource, which is
appropriate when the individual resource will be
* aggregated with other resources to form a virtual composite.
- *
+ *
* @see JavaScriptStack
*/
FOR_AGGREGATION
Modified:
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/security/ClientWhitelist.java
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/security/ClientWhitelist.java?rev=1196621&r1=1196620&r2=1196621&view=diff
==============================================================================
---
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/security/ClientWhitelist.java
(original)
+++
tapestry/tapestry5/branches/5.3/tapestry-core/src/main/java/org/apache/tapestry5/services/security/ClientWhitelist.java
Wed Nov 2 15:20:43 2011
@@ -29,7 +29,6 @@ public interface ClientWhitelist
/**
* Analyzes the current request, returning true if it is on the whitelist.
*
- * @return
*/
boolean isClientRequestOnWhitelist();
}
Modified:
tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/InitializationPlan.java
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/InitializationPlan.java?rev=1196621&r1=1196620&r2=1196621&view=diff
==============================================================================
---
tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/InitializationPlan.java
(original)
+++
tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/InitializationPlan.java
Wed Nov 2 15:20:43 2011
@@ -24,7 +24,6 @@ public interface InitializationPlan<T>
/**
* The description of the operation, used with the {@link
org.apache.tapestry5.ioc.OperationTracker}.
*
- * @return
*/
String getDescription();
Modified:
tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/PeriodicExecutor.java
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/PeriodicExecutor.java?rev=1196621&r1=1196620&r2=1196621&view=diff
==============================================================================
---
tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/PeriodicExecutor.java
(original)
+++
tapestry/tapestry5/branches/5.3/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/PeriodicExecutor.java
Wed Nov 2 15:20:43 2011
@@ -27,7 +27,7 @@ public interface PeriodicExecutor
* @param schedule defines when the job will next execute
* @param name a name used in debugging output related to the job
* @param job a Runnable object that represents the work to be done
- * @returns a PeriodicJob that can be used to query when the job executes,
or to cancel its execution
+ * @return a PeriodicJob that can be used to query when the job executes,
or to cancel its execution
*/
PeriodicJob addJob(Schedule schedule, String name, Runnable job);
}