kinman 2002/12/03 17:41:19
Modified: jasper2/src/share/org/apache/jasper/compiler/tagplugin
TagPlugin.java TagPluginContext.java
Log:
- Some doc editing
Revision Changes Path
1.3 +11 -7
jakarta-tomcat-jasper/jasper2/src/share/org/apache/jasper/compiler/tagplugin/TagPlugin.java
Index: TagPlugin.java
===================================================================
RCS file:
/home/cvs/jakarta-tomcat-jasper/jasper2/src/share/org/apache/jasper/compiler/tagplugin/TagPlugin.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- TagPlugin.java 4 Dec 2002 00:48:43 -0000 1.2
+++ TagPlugin.java 4 Dec 2002 01:41:19 -0000 1.3
@@ -63,15 +63,19 @@
/**
* This interface is to be implemented by the plugin author, to supply
- * an alternate implementation of the tag handlers. Used to specify
- * the Java codes that need to be generated when a tag is referenced.
+ * an alternate implementation of the tag handlers. It can be used to
+ * specify the Java codes to be generated when a tag is referenced.
+ *
+ * An implementation of this interface must be registered in a file
+ * named "tagPlugins.xml" under WEB-INF.
*/
public interface TagPlugin {
/**
- * Invoked to generate codes a custom tag.
+ * Generate codes for a custom tag.
+ * @param ctxt a TagPluginContext for accessing Jasper functions
*/
- void doTag(TagPluginContext c);
+ void doTag(TagPluginContext ctxt);
}
1.3 +9 -9
jakarta-tomcat-jasper/jasper2/src/share/org/apache/jasper/compiler/tagplugin/TagPluginContext.java
Index: TagPluginContext.java
===================================================================
RCS file:
/home/cvs/jakarta-tomcat-jasper/jasper2/src/share/org/apache/jasper/compiler/tagplugin/TagPluginContext.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- TagPluginContext.java 4 Dec 2002 00:48:43 -0000 1.2
+++ TagPluginContext.java 4 Dec 2002 01:41:19 -0000 1.3
@@ -64,9 +64,9 @@
import org.apache.jasper.compiler.ServletWriter;
/**
- * This interface allows the plugin author to query about the properties
- * of the current tag, and to use Jasper resources to generate more
- * efficient implementation for the tag handler under some conditions.
+ * This interface allows the plugin author to make inqueries about the
+ * properties of the current tag, and to use Jasper resources to generate
+ * direct Java codes in place of tag handler invokations.
*/
public interface TagPluginContext {
@@ -104,10 +104,10 @@
void generateBody();
/**
- * Abandon optimization for this tag handler, and instruct the
+ * Abandon optimization for this tag handler, and instruct
* Jaser to generate the tag handler calls, as usual.
- * Should be invoked if errors are detected, or that the tag body is
- * too compilicated for optimization.
+ * Should be invoked if errors are detected, or when the tag body
+ * is judged to be too compilicated for optimization.
*/
void dontUseTagPlugin();
}
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
