"Fossies" - the Fresh Open Source Software Archive

Member "apache-tomcat-8.5.58/webapps/ROOT/RELEASE-NOTES.txt" (10 Sep 2020, 7314 Bytes) of package /windows/www/apache-tomcat-8.5.58-windows-x64.zip:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 ================================================================================
    2   Licensed to the Apache Software Foundation (ASF) under one or more
    3   contributor license agreements.  See the NOTICE file distributed with
    4   this work for additional information regarding copyright ownership.
    5   The ASF licenses this file to You under the Apache License, Version 2.0
    6   (the "License"); you may not use this file except in compliance with
    7   the License.  You may obtain a copy of the License at
    8 
    9       http://www.apache.org/licenses/LICENSE-2.0
   10 
   11   Unless required by applicable law or agreed to in writing, software
   12   distributed under the License is distributed on an "AS IS" BASIS,
   13   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   14   See the License for the specific language governing permissions and
   15   limitations under the License.
   16 ================================================================================
   17 
   18 
   19                      Apache Tomcat Version 8.5.58
   20                             Release Notes
   21 
   22 
   23 =========
   24 CONTENTS:
   25 =========
   26 
   27 * Dependency Changes
   28 * API Stability
   29 * Bundled APIs
   30 * Web application reloading and static fields in shared libraries
   31 * Security manager URLs
   32 * Symlinking static resources
   33 * Viewing the Tomcat Change Log
   34 * Cryptographic software notice
   35 * When all else fails
   36 
   37 
   38 ===================
   39 Dependency Changes:
   40 ===================
   41 Tomcat 8.5 is designed to run on Java 7 and later.
   42 
   43 
   44 ==============
   45 API Stability:
   46 ==============
   47 
   48 The public interfaces for the following classes are fixed and will not be
   49 changed at all during the remaining lifetime of the 8.x series:
   50 - All classes in the javax namespace
   51 
   52 The public interfaces for the following classes may be added to in order to
   53 resolve bugs and/or add new features. No existing interface method will be
   54 removed or changed although it may be deprecated.
   55 - org.apache.catalina.* (excluding sub-packages)
   56 
   57 Note: As Tomcat 8 matures, the above list will be added to. The list is not
   58       considered complete at this time.
   59 
   60 Note: A large number of deprecated methods, fields and configuration options
   61       were removed in the transition from 8.0.x to 8.5.x. If any of those
   62       removals triggers significant problems for the user community that the
   63       deletion may be reverted in a later point release.
   64 
   65 The remaining classes are considered part of the Tomcat internals and may change
   66 without notice between point releases.
   67 
   68 
   69 =============
   70 Bundled APIs:
   71 =============
   72 A standard installation of Tomcat 8.5 makes all of the following APIs available
   73 for use by web applications (by placing them in "lib"):
   74 * annotations-api.jar (Annotations package)
   75 * catalina.jar (Tomcat Catalina implementation)
   76 * catalina-ant.jar (Tomcat Catalina Ant tasks)
   77 * catalina-ha.jar (High availability package)
   78 * catalina-storeconfig.jar (Generation of XML configuration from current state)
   79 * catalina-tribes.jar (Group communication)
   80 * ecj-4.6.3.jar (Eclipse JDT Java compiler)
   81 * el-api.jar (EL 3.0 API)
   82 * jasper.jar (Jasper 2 Compiler and Runtime)
   83 * jasper-el.jar (Jasper 2 EL implementation)
   84 * jsp-api.jar (JSP 2.3 API)
   85 * servlet-api.jar (Servlet 3.1 API)
   86 * tomcat-api.jar (Interfaces shared by Catalina and Jasper)
   87 * tomcat-coyote.jar (Tomcat connectors and utility classes)
   88 * tomcat-dbcp.jar (package renamed database connection pool based on Commons DBCP 2)
   89 * tomcat-jdbc.jar (Tomcat's database connection pooling solution)
   90 * tomcat-jni.jar (Interface to the native component of the APR/native connector)
   91 * tomcat-util.jar (Various utilities)
   92 * tomcat-websocket.jar (WebSocket 1.1 implementation)
   93 * websocket-api.jar (WebSocket 1.1 API)
   94 
   95 You can make additional APIs available to all of your web applications by
   96 putting unpacked classes into a "classes" directory (not created by default),
   97 or by placing them in JAR files in the "lib" directory.
   98 
   99 To override the XML parser implementation or interfaces, use the appropriate
  100 feature for your JVM. For Java <= 8 use the endorsed standards override
  101 feature. The default configuration defines JARs located in "endorsed" as endorsed.
  102 For Java 9+ use the upgradeable modules feature.
  103 
  104 
  105 ================================================================
  106 Web application reloading and static fields in shared libraries:
  107 ================================================================
  108 Some shared libraries (many are part of the JDK) keep references to objects
  109 instantiated by the web application. To avoid class loading related problems
  110 (ClassCastExceptions, messages indicating that the classloader
  111 is stopped, etc.), the shared libraries state should be reinitialized.
  112 
  113 Something which might help is to avoid putting classes which would be
  114 referenced by a shared static field in the web application classloader,
  115 and putting them in the shared classloader instead (JARs should be put in the
  116 "lib" folder, and classes should be put in the "classes" folder).
  117 
  118 
  119 ======================
  120 Security manager URLs:
  121 ======================
  122 In order to grant security permissions to JARs located inside the
  123 web application repository, use URLs of the following format
  124 in your policy file:
  125 
  126 file:${catalina.base}/webapps/examples/WEB-INF/lib/driver.jar
  127 
  128 
  129 ============================
  130 Symlinking static resources:
  131 ============================
  132 By default, Unix symlinks will not work when used in a web application to link
  133 resources located outside the web application root directory.
  134 
  135 This behavior is optional, and the "allowLinking" flag may be used to disable
  136 the check.
  137 
  138 
  139 ==============================
  140 Viewing the Tomcat Change Log:
  141 ==============================
  142 The full change log is available from https://tomcat.apache.org and is also
  143 included in the documentation web application.
  144 
  145 
  146 =============================
  147 Cryptographic software notice
  148 =============================
  149 This distribution includes cryptographic software.  The country in
  150 which you currently reside may have restrictions on the import,
  151 possession, use, and/or re-export to another country, of
  152 encryption software.  BEFORE using any encryption software, please
  153 check your country's laws, regulations and policies concerning the
  154 import, possession, or use, and re-export of encryption software, to
  155 see if this is permitted.  See <http://www.wassenaar.org/> for more
  156 information.
  157 
  158 The U.S. Government Department of Commerce, Bureau of Industry and
  159 Security (BIS), has classified this software as Export Commodity
  160 Control Number (ECCN) 5D002.C.1, which includes information security
  161 software using or performing cryptographic functions with asymmetric
  162 algorithms.  The form and manner of this Apache Software Foundation
  163 distribution makes it eligible for export under the License Exception
  164 ENC Technology Software Unrestricted (TSU) exception (see the BIS
  165 Export Administration Regulations, Section 740.13) for both object
  166 code and source code.
  167 
  168 The following provides more details on the included cryptographic
  169 software:
  170   - Tomcat includes code designed to work with JSSE
  171   - Tomcat includes code designed to work with OpenSSL
  172 
  173 
  174 ====================
  175 When all else fails:
  176 ====================
  177 See the FAQ
  178 https://tomcat.apache.org/faq/