Deprecate useAcceptRanges

Author: markt-asf

conf/web.xml

@@ -84,6 +84,9 @@
   <!--                                                                      -->
   <!--   useAcceptRanges     Should the Accept-Ranges header be included    -->
   <!--                       in responses where appropriate? [true]         -->
+  <!--                       Deprecated. This option will be removed        -->
+  <!--                       without replacement in Tomcat 12 onwards where -->
+  <!--                       it will effectively be hard coded to true.     -->
   <!--                                                                      -->
   <!--  For directory listing customization. Checks localXsltFile, then     -->
   <!--  globalXsltFile, then defaults to original behavior.                 -->

java/org/apache/catalina/servlets/DefaultServlet.java

@@ -237,7 +237,11 @@ public class DefaultServlet extends HttpServlet {
 
     /**
      * Should the Accept-Ranges: bytes header be send with static resources?
+     *
+     * @deprecated This option will be removed without replacement in Tomcat 12 onwards where it will effectively be
+     *                 hard coded to {@code true}.
      */
+    @Deprecated
     protected boolean useAcceptRanges = true;
 
     /**

webapps/docs/changelog.xml

@@ -223,6 +223,11 @@
         only be processed for <code>GET</code> requests. Based on pull request
         <pr>790</pr> provided by Chenjp. (markt)
       </fix>
+      <fix>
+        Deprecate the <code>useAcceptRanges</code> initialisation parameter for
+        the default servlet. It will be removed in Tomcat 12 onwards where it
+        will effectively be hard coded to <code>true</code>. (markt)
+      </fix>
     </changelog>
   </subsection>
   <subsection name="Coyote">

webapps/docs/default-servlet.xml

@@ -194,6 +194,9 @@ Tomcat.</p>
   <property name="useAcceptRanges">
         If true, the Accept-Ranges header will be set when appropriate for the
         response. [true]
+        <br/>
+        Deprecated. This option will be removed without replacement in Tomcat
+        12 onwards where it will effectively be hard coded to <code>true</code>.
   </property>
   <property name="showServerInfo">
         Should server information be presented in the response sent to clients