Author: markt Date: Mon Feb 18 10:13:25 2013 New Revision: 1447181 URL: http://svn.apache.org/r1447181 Log: Improve Javadoc. Clarify difference between spec minimum behaviour and what Tomcat does.
Modified: tomcat/tc7.0.x/trunk/ (props changed) tomcat/tc7.0.x/trunk/java/javax/servlet/http/Part.java Propchange: tomcat/tc7.0.x/trunk/ ------------------------------------------------------------------------------ Merged /tomcat/trunk:r1447178 Modified: tomcat/tc7.0.x/trunk/java/javax/servlet/http/Part.java URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/java/javax/servlet/http/Part.java?rev=1447181&r1=1447180&r2=1447181&view=diff ============================================================================== --- tomcat/tc7.0.x/trunk/java/javax/servlet/http/Part.java (original) +++ tomcat/tc7.0.x/trunk/java/javax/servlet/http/Part.java Mon Feb 18 10:13:25 2013 @@ -71,10 +71,14 @@ public interface Part { /** * Deletes the underlying storage for a part, including deleting any - * associated temporary disk file. Although this storage will be deleted - * automatically when the Part instance is garbage collected, this - * method can be used to ensure that this is done at an earlier time, thus - * preserving system resources. + * associated temporary disk file. Although the container will delete this + * storage automatically this method can be used to ensure that this is done + * at an earlier time, thus preserving system resources. + * <p> + * Containers are only required to delete the associated storage when the + * Part instance is garbage collected. Apache Tomcat will delete the + * associated storage when the associated request has finished processing. + * Behaviour of other containers may be different. */ public void delete() throws IOException; --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org