You are viewing a plain text version of this content. The canonical link for it is here.
Posted to servletapi-dev@jakarta.apache.org by ed...@locus.apache.org on 2000/10/14 00:34:49 UTC
cvs commit: jakarta-servletapi/src/share/javax/servlet/jsp JspFactory.java JspPage.java JspWriter.java PageContext.java
eduardop 00/10/13 15:34:47
Modified: src/share/javax/servlet/jsp Tag: SERVLET_23_JSP_12
JspFactory.java JspPage.java JspWriter.java
PageContext.java
Log:
Applied formating/editing changes to javadoc.
Revision Changes Path
No revision
No revision
1.1.1.1.4.2 +4 -4 jakarta-servletapi/src/share/javax/servlet/jsp/JspFactory.java
Index: JspFactory.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/JspFactory.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- JspFactory.java 2000/08/24 21:05:23 1.1.1.1.4.1
+++ JspFactory.java 2000/10/13 22:34:45 1.1.1.1.4.2
@@ -113,7 +113,7 @@
*
* <p>
* This method is typically called early in the processing of the
- * _jspService() mehtod of a JSP implementation class in order to
+ * _jspService() method of a JSP implementation class in order to
* obtain a PageContext object for the request being processed.
* </p>
* <p>
@@ -151,9 +151,9 @@
/**
* <p>
- * called to release a previously allocated PageContext object. results
- * in PageContext.release() being invoked. This method should be invoked
- * prior to returning from the _jspService() method of a JSP implementation
+ * called to release a previously allocated PageContext object.
+ * Results in PageContext.release() being invoked.
+ * This method should be invoked prior to returning from the _jspService() method of a JSP implementation
* class.
* </p>
*
1.1.1.1.4.2 +3 -3 jakarta-servletapi/src/share/javax/servlet/jsp/JspPage.java
Index: JspPage.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/JspPage.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- JspPage.java 2000/08/24 21:05:23 1.1.1.1.4.1
+++ JspPage.java 2000/10/13 22:34:45 1.1.1.1.4.2
@@ -77,7 +77,7 @@
* corresponding Servlet-based method invocations.
* <p>
* The jspInit() and jspDestroy() methods can be defined by a JSP
- * author, but the _jspService() method is defined authomatically
+ * author, but the _jspService() method is defined automatically
* by the JSP processor based on the contents of the JSP page.
*
* <p><B>_jspService()</B>
@@ -113,7 +113,7 @@
* A JSP page can override this method by including a definition for it
* in a declaration element.
*
- * A JSP page should redefine the init() method from Servlet
+ * A JSP page should redefine the init() method from Servlet.
*/
public void jspInit();
@@ -124,7 +124,7 @@
* A JSP page can override this method by including a definition for it
* in a declaration element.
*
- * A JSP page should redefine the destroy() method from Servlet
+ * A JSP page should redefine the destroy() method from Servlet.
*/
public void jspDestroy();
1.1.1.1.4.2 +9 -9 jakarta-servletapi/src/share/javax/servlet/jsp/JspWriter.java
Index: JspWriter.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/JspWriter.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- JspWriter.java 2000/08/24 21:05:23 1.1.1.1.4.1
+++ JspWriter.java 2000/10/13 22:34:45 1.1.1.1.4.2
@@ -71,11 +71,11 @@
* <p>
* The initial JspWriter object is associated with the PrintWriter object
* of the ServletResponse in a way that depends on whether the page is or
- * not buffered. If the page is not buffered, output written to this
+ * is not buffered. If the page is not buffered, output written to this
* JspWriter object will be written through to the PrintWriter directly,
* which will be created if necessary by invoking the getWriter() method
* on the response object. But if the page is buffered, the PrintWriter
- * object will not be created until when the buffer is flushed, and
+ * object will not be created until the buffer is flushed and
* operations like setContentType() are legal. Since this flexibility
* simplifies programming substantially, buffering is the default for JSP
* pages.
@@ -98,20 +98,20 @@
* may want to set autoFlush to false, with a typical case being that
* where the client is an application itself. On the other hand, JSP
* pages that send data that is meaningful even when partially
- * constructed may want to set autoFlush to true; a case may be when the
+ * constructed may want to set autoFlush to true; such as when the
* data is sent for immediate display through a browser. Each application
* will need to consider their specific needs.
* <p>
- * An alternative considered was to make the buffer size unbounded, but
- * this has the disadvantage that runaway computations may consume an
+ * An alternative considered was to make the buffer size unbounded; but,
+ * this had the disadvantage that runaway computations would consume an
* unbounded amount of resources.
* <p>
* The "out" implicit variable of a JSP implementation class is of this type.
* If the page directive selects autoflush="true" then all the I/O operations
- * on this class shall automatically fluch the contents of the buffer if an
+ * on this class shall automatically flush the contents of the buffer if an
* overflow condition would result if the current operation were performed
* without a flush. If autoflush="false" then all the I/O operations on this
- * class shall throw an IOException if performing the current opertion would
+ * class shall throw an IOException if performing the current operation would
* result in a buffer overflow condition.
*
* @see java.io.Writer
@@ -385,7 +385,7 @@
/**
* Clears the current contents of the buffer. Unlike clear(), this
- * mehtod will not throw an IOException if the buffer has already been
+ * method will not throw an IOException if the buffer has already been
* flushed. It merely clears the current content of the buffer and
* returns.
*
@@ -419,7 +419,7 @@
* as the code generated by the JSP container will automatically
* include a call to close().
* <p>
- * Closing a previously-closed stream, unlike flush(),, has no effect.
+ * Closing a previously-closed stream, unlike flush(), has no effect.
*
* @exception IOException If an I/O error occurs
*/
1.1.1.1.4.2 +22 -21 jakarta-servletapi/src/share/javax/servlet/jsp/PageContext.java
Index: PageContext.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/PageContext.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- PageContext.java 2000/08/24 21:05:24 1.1.1.1.4.1
+++ PageContext.java 2000/10/13 22:34:45 1.1.1.1.4.2
@@ -90,7 +90,7 @@
* <p>
* The PageContext provides a number of facilities to the page/component author and
* page implementor, including:
- * <td>
+ * <ul>
* <li>a single API to manage the various scoped namespaces
* <li>a number of convenience API's to access various public objects
* <li>a mechanism to obtain the JspWriter for output
@@ -98,7 +98,7 @@
* <li>a mechanism to expose page directive attributes to the scripting environment
* <li>mechanisms to forward or include the current request to other active components in the application
* <li>a mechanism to handle errorpage exception processing
- * </td>
+ * </ul>
*
* <p><B>Methods Intended for Container Generated Code</B>
* <p>Some methods are intended to be used by the code generated by the
@@ -112,7 +112,8 @@
*
* <p><B>Methods Intended for JSP authors</B>
* <p>
- * Some methods provide <B>uniform access</B> to the diverse scopes objects.
+ * Some methods provide <B>uniform access</B> to the diverse objects
+ * representing scopes.
* The implementation must use the underlying Servlet machinery
* corresponding to that scope, so information can be passed back and
* forth between Servlets and JSP pages. The methods are:
@@ -138,7 +139,7 @@
abstract public class PageContext {
/**
- * page scope: (this is the default) the named reference remains available
+ * Page scope: (this is the default) the named reference remains available
* in this PageContext until the return from the current Servlet.service()
* invocation.
*/
@@ -146,14 +147,14 @@
public static final int PAGE_SCOPE = 1;
/**
- * request scope: the named reference remains available from the ServletRequest
- * associated with the Servlet that until the current request is completed.
+ * Request scope: the named reference remains available from the ServletRequest
+ * associated with the Servlet until the current request is completed.
*/
public static final int REQUEST_SCOPE = 2;
/**
- * session scope (only valid if this page participates in a session):
+ * Session scope (only valid if this page participates in a session):
* the named reference remains available from the HttpSession (if any)
* associated with the Servlet until the HttpSession is invalidated.
*/
@@ -161,70 +162,70 @@
public static final int SESSION_SCOPE = 3;
/**
- * application scope: named reference remains available in the
+ * Application scope: named reference remains available in the
* ServletContext until it is reclaimed.
*/
public static final int APPLICATION_SCOPE = 4;
/**
- * name used to store the Servlet in this PageContext's nametables
+ * Name used to store the Servlet in this PageContext's nametables.
*/
public static final String PAGE = "javax.servlet.jsp.jspPage";
/**
- * name used to store this PageContext in it's own name tables
+ * Name used to store this PageContext in it's own name table.
*/
public static final String PAGECONTEXT = "javax.servlet.jsp.jspPageContext";
/**
- * name used to store ServletRequest in PageContext name table
+ * Name used to store ServletRequest in PageContext name table.
*/
public static final String REQUEST = "javax.servlet.jsp.jspRequest";
/**
- * name used to store ServletResponse in PageContext name table
+ * Name used to store ServletResponse in PageContext name table.
*/
public static final String RESPONSE = "javax.servlet.jsp.jspResponse";
/**
- * name used to store ServletConfig in PageContext name table
+ * Name used to store ServletConfig in PageContext name table.
*/
public static final String CONFIG = "javax.servlet.jsp.jspConfig";
/**
- * name used to store HttpSession in PageContext name table
+ * Name used to store HttpSession in PageContext name table.
*/
public static final String SESSION = "javax.servlet.jsp.jspSession";
/**
- * name used to store current JspWriter in PageContext name table
+ * Name used to store current JspWriter in PageContext name table.
*/
public static final String OUT = "javax.servlet.jsp.jspOut";
/**
- * name used to store ServletContext in PageContext name table
+ * Name used to store ServletContext in PageContext name table.
*/
public static final String APPLICATION = "javax.servlet.jsp.jspApplication";
/**
- * name used to store uncaught exception in ServletRequest attribute list and PageContext name table
+ * Name used to store uncaught exception in ServletRequest attribute list and PageContext name table.
*/
public static final String EXCEPTION = "javax.servlet.jsp.jspException";
/**
* <p>
- * The initialize emthod is called to initialize an uninitialized PageContext
+ * The initialize method is called to initialize an uninitialized PageContext
* so that it may be used by a JSP Implementation class to service an
- * incoming request and response wihtin it's _jspService() method.
+ * incoming request and response within it's _jspService() method.
*
* <p>
* This method is typically called from JspFactory.getPageContext() in
@@ -235,7 +236,7 @@
* the "out" name in page scope with this newly created object.
*
* <p>
- * This method should not be used by page or tag libray authors.
+ * This method should not be used by page or tag library authors.
*
* @param servlet The Servlet that is associated with this PageContext
* @param request The currently pending request for this Servlet
@@ -262,7 +263,7 @@
* Subclasses shall envelope this method.
*
* <p>
- * This method should not be used by page or tag libray authors.
+ * This method should not be used by page or tag library authors.
*
*/