<?xml version="1.0" encoding="UTF-8"?>
<document>

  <properties>
    <author>Apache Tomcat Project</author>
    <title>Migration Guide - Tomcat 9.0.x</title>
  </properties>

<body>

<section name="Table of Contents">
<toc/>
</section>

<section name="General">

<p>Please read the general <a href="migration.html">Migration Guide page</a>
first, for common considerations that apply to migration or upgrade between
versions of Apache Tomcat<sup>&#174;</sup>.</p>

</section>

<section name="Migrating from 8.0.x or 8.5.x to 9.0.x">

  <p>This section lists all the known changes between 8.0.x / 8.5.x and 9.0.x
  which may cause backwards compatibility problems when upgrading. Some of
  these changes and new features are already present in Apache Tomcat 8.5.x.</p>

  <subsection name="Java 8 required">

    <p>Apache Tomcat 9.0.x requires Java 8 or later. Apache Tomcat 8.0.x and 8.5.x
    required Java 7.</p>

  </subsection>

  <subsection name="Specification APIs">

    <p>Apache Tomcat 9 supports the Java Servlet 4.0, JavaServer Pages 2.3,
    Java Unified Expression Language 3.0 and Java API for WebSocket 1.0
    <a href="https://cwiki.apache.org/confluence/display/TOMCAT/Specifications">specifications</a>.
    The changes between versions of specifications may be found in the
    <em>Changes</em> appendix in each of specification documents.
    </p>

  </subsection>
  
  <subsection name="Servlet 4.0 API">
  
    <p>In JSP pages that use wildcard import syntax the new classes added in
    Servlet API may conflict with ones in web applications.
    For example, if package <code>"a"</code> contains class
    <code>PushBuilder</code>, the following JSP page will cease to compile in
    Tomcat 9:</p>

    <source><![CDATA[<%@page import="a.*"%>
<% PushBuilder pushBuilder = new PushBuilder(); %>]]></source>

    <p>This happens because the implicit import of
    <code>javax.servlet.http.*</code> and the explicit import of
    <code>a.*</code> will provide conflicting definitions of class
    <code>PushBuilder</code> that was added in Servlet 4.0. The solution is to
    use the explicit import, <code>import="a.PushBuilder"</code>.</p>

  </subsection>

  <subsection name="JavaServer Pages 2.3">
  
    <p>This is unchanged from Tomcat 8.x.</p>

  </subsection>

  <subsection name="Expression Language 3.0">
  
    <p>This is unchanged from Tomcat 8.x.</p>

  </subsection>

  <subsection name="WebSocket 1.1">
  
    <p>This is unchanged from Tomcat 8.x.</p>

  </subsection>

  <subsection name="BIO connector removed">

    <p><em>The following change is present in 8.5.0 onwards.</em></p>

    <p>The Java blocking IO implementation (BIO) for both HTTP and AJP has been
    removed. Users are recommended to switch to the Java non-blocking IO
    implementation (NIO).</p>

  </subsection>

  <subsection name="HTTP connector changes">
    <p>
      HTTP reason phrases have been <a href="https://bz.apache.org/bugzilla/show_bug.cgi?id=60362#c60">removed</a>
      entirely. Some non-RFC-compliant clients are known to fail when the
      reason phrase is missing. Such failures are a problem with the client
      and not with Tomcat.
    </p>
  </subsection>

  <subsection name="Comet support removed">

    <p><em>The following change is present in 8.5.0 onwards.</em></p>

    <p>Comet support has been removed without a direct replacement. Applications
    using Comet are recommended to migrate to WebSockets.</p>

  </subsection>

  <subsection name="HTTP/2 support added">

    <p><em>The following feature is available since 8.5.0 onwards.</em></p>

    <p>HTTP/2 is supported for h2 (over TLS, negotiated via ALPN) and h2c (clear
    text, negotiated via HTTP/1.1 upgrade). HTTP/2 needs to be explicitly
    enabled for a connector. To enable it, insert
    <source><![CDATA[<UpgradeProtocol className="org.apache.coyote.http2.Http2Protocol" />]]></source>
    inside the connector for which you wish to enable HTTP/2. Note that to
    enable HTTP/2 for a secure NIO or NIO2 connector, those connectors must be
    using the OpenSSL engine for TLS.</p>

  </subsection>

  <subsection name="TLS virtual hosting and multiple certificate support added">

    <p><em>The following feature is available since 8.5.0 onwards.</em></p>

    <p>Tomcat 9 supports multiple TLS virtual hosts for a single connector with
    each virtual host able to support multiple certificates. Virtual host
    definitions are nested inside the Connector element with the default
    specified using the <strong>defaultSSLHostConfigName</strong> attribute on the
    Connector if more than one virtual host is specified. Certificate
    definitions are nested inside the virtual host.</p>
    
    <p>The following example shows how to use this to configure a single
    APR/native connector for multiple TLS virtual hosts with each host having
    both an RSA and EC certificate.
    
<source><![CDATA[
<Connector port="8443"
           protocol="org.apache.coyote.http11.Http11AprProtocol"
           maxThreads="150"
           SSLEnabled="true"
           defaultSSLHostConfigName="openoffice.apache.org" >
    <SSLHostConfig hostName="openoffice.apache.org" >
        <Certificate certificateKeyFile="conf/openoffice.apache.org-rsa-key.pem"
                     certificateFile="conf/openoffice.apache.org-rsa-cert.pem"
                     type="RSA" />
        <Certificate certificateKeyFile="conf/openoffice.apache.org-ec-key.pem"
                     certificateFile="conf/openoffice.apache.org-ec-cert.pem"
                     type="EC" />
    </SSLHostConfig>
    <SSLHostConfig hostName="www.openoffice.org" >
        <Certificate certificateKeyFile="conf/www.openoffice.org-rsa-key.pem"
                     certificateFile="conf/www.openoffice.org-rsa-cert.pem"
                     type="RSA" />
        <Certificate certificateKeyFile="conf/www.openoffice.org-ec-key.pem"
                     certificateFile="conf/www.openoffice.org-ec-cert.pem"
                     type="EC" />
    </SSLHostConfig>
</Connector>
]]></source></p>

  </subsection>

  <subsection name="Internal APIs">
  
    <p>Whilst the Tomcat 9 internal API is broadly compatible with Tomcat 8
    there have been many changes at the detail level and they are not binary
    compatible. Developers of custom components that interact with Tomcat&apos;s
    internals should review the JavaDoc for the relevant API.</p>

    <p>Of particular note are:</p>
    <ul>
      <li>Significant refactoring has taken place throughout the connectors to
          reduce duplicate code and to align behaviour across
          implementations. (<em>This change is present in 8.5.x.</em>)</li>
      <li>The deprecated <code>digest</code> attribute has been removed from the
          <code>Realm</code>. (<em>This change is present in 8.5.x.</em>)</li>
    </ul>

  </subsection>

  <subsection name="JSR-77 implementation removed">

    <p><em>The following change is present in 8.5.0 onwards.</em></p>

    <p>The JSR-77 implementation is incomplete and has been removed in 8.5.x and 9.0.x.
    Specifically, the following methods that exposed to JMX have been removed.
    </p>

    <ul>
      <li><code>StandardContext.getServlets()</code></li>
      <li><code>StandardContext.isStateManageable()</code></li>
      <li><code>StandardContext.getDeploymentDescriptor()</code></li>
      <li><code>StandardWrapper.isStateManageable()</code></li>
    </ul>
  </subsection>

  <subsection name="Clustering">

    <p><em>The following change is present in 8.5.0 onwards.</em></p>

    <p><code>MessageDispatch15Interceptor</code> had been used to add the Java 5
    features to MessageDispatchInterceptor.
    <code>MessageDispatch15Interceptor</code> has been removed in Tomcat 8.5.x and 9.0.x
    by merging the Java 5 features to <code>MessageDispatchInterceptor</code>.
    </p>

  </subsection>

  <subsection name="InstanceListener removed">

    <p><em>The following change is present in 8.5.0 onwards.</em></p>

    <p>The support of InstanceListener has been removed in 8.5.x and 9.0.x.
    Specifically, the following classes have been removed.
    </p>

    <ul>
      <li><code>org.apache.catalina.InstanceListener</code></li>
      <li><code>org.apache.catalina.InstanceEvent</code></li>
      <li><code>org.apache.catalina.util.InstanceSupport</code></li>
    </ul>
  </subsection>

  <subsection name="SessionManager">

    <p><em>The following change is present in 8.5.0 onwards.</em></p>

    <p>The following session manager attributes have been completely removed in
    8.5.x and 9.0.x.</p>

    <ul>
      <li><code>distributable</code></li>
      <li><code>maxInactiveInterval</code></li>
      <li><code>sessionIdLength</code></li>
    </ul>

    <p>The replacements are as follows:</p>
    <ul>
      <li>The <code>distributable</code> attribute has been deprecated in 8.0
          and specified value is ignored. This should be configured via the
          Context. The value is inherited based on the presence or absence of
          the <code>&lt;distributable /&gt;</code> element in
          <code>/WEB-INF/web.xml.</code></li>
      <li>The <code>maxInactiveInterval</code> attribute has been deprecated in
          8.0. If the value is specified, a warning log is issued. This should
          be configured via the Context. The value is inherited based on the
          value of the <code>&lt;session-timeout&gt;</code> element in
          <code>/WEB-INF/web.xml</code>.</li>
      <li>The <code>sessionIdLength</code> attribute of <code>Manager</code> has
          been replaced by <code>sessionIdLength</code> attribute of
          <code>SessionIdGenerator</code>.</li>
    </ul>
  </subsection>

  <subsection name="Cookies">
  
    <p>The default <code>CookieProcessor</code> is now the
    <code>Rfc6265CookieProcessor</code>. The <code>CookieProcessor</code> is
    configurable per <code>Context</code> and the
    <code>LegacyCookieProcessor</code> may be used to obtain the 8.0.x
    behaviour.</p>

  </subsection>

  <subsection name="Web applications">
  
    <p>The Manager and HostManager web applications are configured by default
       with a <code>RemoteAddrValve</code> that limits access to those
       applications to connections from localhost.</p>

  </subsection>

  <subsection name="Engine and Host configurations">

    <p>The behaviour for <code>startStopThreads</code> has changed when the
    effective value is 1. In this case, children will be started on the current
    thread rather than via an <code>ExecutorService</code> configured with a
    single thread.</p>

  </subsection>

  <subsection name="Context configurations">

    <p>The <code>clearReferencesStatic</code> attribute has been removed in
    8.5.x and 9.0.x.</p>

  </subsection>

  <subsection name="Logging">

    <p>By default the log files will be kept 90 days and then removed from the
    file system.</p>

  </subsection>

</section>

<section name="Upgrading 9.0.x">

  <p>When upgrading instances of Apache Tomcat from one version of Tomcat 9 to
  another, particularly when using separate locations for $CATALINA_HOME and
  $CATALINA_BASE, it is necessary to ensure that any changes in the
  configuration files such as new attributes and changes to defaults are applied
  as part of the upgrade. To assist with the identification of these changes,
  the form below may be used to view the differences between the configuration
  files in different versions of Tomcat 9.</p>

  <subsection name="Tomcat 9.0.x noteable changes">
    <p>The Tomcat developers aim for each patch release to be fully backwards
       compatible with the previous release.  Occasionally, it is necessary to
       break backwards compatibility in order to fix a bug. In most cases, these
       changes will go unnoticed. This section lists changes that are not fully
       backwards compatible and might cause breakage when upgrading.</p>
    <ul>
      <li>
        In 9.0.96, a change was made to the way pooled JSP tags were released,
        resulting in a binary incompatiblity between some JSP files compiled
        with earlier versions of Apache Tomcat 9. This incompatibility will be
        corrected in 9.0.97, so JSPs compiled <i>before</i> 9.0.96 should again
        run without recompilation in 9.0.97 and later.
      </li> 
      <li>
        In 9.0.74 onwards, the default value for the Connector attribute
        <code>maxParameterCount</code> has been reduced from 10,000 to 1,000.
      </li>
      <li><p>In 9.0.31 onwards, the default listen <strong>address</strong> of
        the AJP Connector was changed to the loopback address rather than all
        addresses.</p>
        <p>Reference:  <a href="tomcat-9.0-doc/config/ajp.html">AJP
        connector</a>.</p>
      </li>
      <li><p>In 9.0.31 onwards, the <strong>requiredSecret</strong> attribute
        of the AJP Connector was deprecated and replaced by the
        <strong>secret</strong> attribute.</p>
        <p>Reference:  <a href="tomcat-9.0-doc/config/ajp.html">AJP
        connector</a>.</p>
      </li>
      <li><p>In 9.0.31 onwards, the <strong>secretRequired</strong> attribute
        was added to the AJP Connector. If set to <code>true</code>, the
        default, the AJP Connector will not start unless a
        <strong>secret</strong> has been specified.</p>
        <p>Reference:  <a href="tomcat-9.0-doc/config/ajp.html">AJP
        connector</a>.</p>
      </li>
      <li><p>In 9.0.31 onwards, the
        <strong>allowedRequestAttributesPattern</strong> attribute was added to
        the AJP Connector. Requests with unrecognised attributes will now be
        blocked with a 403.</p>
        <p>Reference:  <a href="tomcat-9.0-doc/config/ajp.html">AJP
        connector</a>.</p>
      </li>
      <li><p>In 9.0.44 onwards, the semantics of the
        <code>HostConfig.check(String)</code> method have changed. Rather than
        marking the application as serviced before calling the method, the
        method will mark the application as serviced before checking
        resources and then un-mark the application as being serviced after the
        checks are complete. If the application is marked as serviced when the
        method is called, the method will be a NO-OP.</p>
      </li>
      <li><p>In 9.0.48 onwards, the NIO poller was simplified and the block
        poller and selector configuration has been removed. This will not
        cause a startup error if they are present in the configuration, but
        may produce a warning and will have no effect.</p>
      </li>
      <li><p>In 9.0.51 onwards, Tomcat no longer adds an "Expires" HTTP
        response header when adding "Cache-Control: private" due to a
        CONFIDENTIAL transport-guarantee. This will likely cause a change
        in caching behavior for applications that do not explicitly set
        their own headers but rely on Tomcat's previous behavior. If you
        wish to disable caching, you will need to configure it explicitly
        in your application. See <a href="https://bz.apache.org/bugzilla/show_bug.cgi?id=65513">BZ 65513</a>
        for more information.</p>
      </li>
      <li><p>In 9.0.53 onwards, as a result of the updated fork of Commons
        FileUpload now using <code>java.nio.file.Files</code>, applications
        using multi-part uploads need to ensure that the JVM is configured with
        sufficient direct memory to store all in progress multi-part
        uploads.</p>
      </li>
      <li><p>In 9.0.56 onwards, the system property
        <code>org.apache.juli.AsyncLoggerPollInterval</code> is no longer
        used.</p>
      </li>
      <li>
        In 9.0.109, a release packaging error caused some support classes
        for FileStore to be missing from the release. You should avoid 9.0.109
        if you use the FileStore session mechanism.
      </li>
      <li>
        In 9.0.114 onwards, the minimum Tomcat Native version is 1.3.4 for
        Tomcat Native 1.3.x and 2.0.12 for Tomcat Native 2.0.x.
      </li>
      <li>
        Tomcat 9.0.119 introduces a <b>breaking change</b> for users of the
        <code>EncryptInterceptor</code> in their clustering configuration.
        Migration from prior-to-Tomcat-9.0.119 to after-Tomcat-9.0.119
        will require that <i>all</i> cluster nodes are stopped and restarted
        to perform the migration. There is an additional, required, piece of
        data that is being introduced into the cluster data stream for
        <code>EncryptInterceptor</code> and nodes running any older versions
        will fail to send or receive cluster messages.
      </li>
    </ul>
  </subsection>

  <subsection name="Tomcat 9.0.x configuration file differences">

    <p>Select a configuration file, old version and new version from the boxes
    below and then click &quot;View differences&quot; to see the differences.
    The differences will be shown in a new tab/window.</p>

    <p><b>Note:</b> If there are no differences you will see an error page.</p>

    <form action="https://gitbox.apache.org/filediff"
          method="get"
          target="_blank">

    <input type="hidden" name="repo" value="tomcat.git"/>

    <p><label>Configuration file:
    <select name="file">
    <option value="conf" selected="selected">All configuration files</option>
    <option value="conf/catalina.policy">catalina.policy</option>
    <option value="conf/catalina.properties">catalina.properties</option>
    <option value="conf/context.xml">context.xml</option>
    <option value="conf/logging.properties">logging.properties</option>
    <option value="conf/server.xml">server.xml</option>
    <option value="conf/tomcat-users.xml">tomcat-users.xml</option>
    <option value="conf/web.xml">web.xml</option>
    </select></label>
    </p>
    <p><label>Old version:
    <select name="origin">
    <option value="9.0.0-M1">9.0.0-M1</option>
    <option value="9.0.0-M3">9.0.0-M3</option>
    <option value="9.0.0-M4">9.0.0-M4</option>
    <option value="9.0.0-M6">9.0.0-M6</option>
    <option value="9.0.0-M8">9.0.0-M8</option>
    <option value="9.0.0-M9">9.0.0-M9</option>
    <option value="9.0.0-M10">9.0.0-M10</option>
    <option value="9.0.0-M11">9.0.0-M11</option>
    <option value="9.0.0-M13">9.0.0-M13</option>
    <option value="9.0.0-M15">9.0.0-M15</option>
    <option value="9.0.0-M17">9.0.0-M17</option>
    <option value="9.0.0-M18">9.0.0-M18</option>
    <option value="9.0.0-M19">9.0.0-M19</option>
    <option value="9.0.0-M20">9.0.0-M20</option>
    <option value="9.0.0-M21">9.0.0-M21</option>
    <option value="9.0.0-M22">9.0.0-M22</option>
    <option value="9.0.0-M26">9.0.0-M26</option>
    <option value="9.0.1">9.0.1</option>
    <option value="9.0.2">9.0.2</option>
    <option value="9.0.4">9.0.4</option>
    <option value="9.0.5">9.0.5</option>
    <option value="9.0.6">9.0.6</option>
    <option value="9.0.7">9.0.7</option>
    <option value="9.0.8">9.0.8</option>
    <option value="9.0.10">9.0.10</option>
    <option value="9.0.11">9.0.11</option>
    <option value="9.0.12">9.0.12</option>
    <option value="9.0.13">9.0.13</option>
    <option value="9.0.14">9.0.14</option>
    <option value="9.0.16">9.0.16</option>
    <option value="9.0.17">9.0.17</option>
    <option value="9.0.19">9.0.19</option>
    <option value="9.0.20">9.0.20</option>
    <option value="9.0.21">9.0.21</option>
    <option value="9.0.22">9.0.22</option>
    <option value="9.0.24">9.0.24</option>
    <option value="9.0.26">9.0.26</option>
    <option value="9.0.27">9.0.27</option>
    <option value="9.0.28">9.0.28</option>
    <option value="9.0.30">9.0.30</option>
    <option value="9.0.31">9.0.31</option>
    <option value="9.0.33">9.0.33</option>
    <option value="9.0.34">9.0.34</option>
    <option value="9.0.35">9.0.35</option>
    <option value="9.0.36">9.0.36</option>
    <option value="9.0.37">9.0.37</option>
    <option value="9.0.38">9.0.38</option>
    <option value="9.0.39">9.0.39</option>
    <option value="9.0.40">9.0.40</option>
    <option value="9.0.41">9.0.41</option>
    <option value="9.0.43">9.0.43</option>
    <option value="9.0.44">9.0.44</option>
    <option value="9.0.45">9.0.45</option>
    <option value="9.0.46">9.0.46</option>
    <option value="9.0.48">9.0.48</option>
    <option value="9.0.50">9.0.50</option>
    <option value="9.0.52">9.0.52</option>
    <option value="9.0.53">9.0.53</option>
    <option value="9.0.54">9.0.54</option>
    <option value="9.0.55">9.0.55</option>
    <option value="9.0.56">9.0.56</option>
    <option value="9.0.58">9.0.58</option>
    <option value="9.0.59">9.0.59</option>
    <option value="9.0.60">9.0.60</option>
    <option value="9.0.62">9.0.62</option>
    <option value="9.0.63">9.0.63</option>
    <option value="9.0.64">9.0.64</option>
    <option value="9.0.65">9.0.65</option>
    <option value="9.0.67">9.0.67</option>
    <option value="9.0.68">9.0.68</option>
    <option value="9.0.69">9.0.69</option>
    <option value="9.0.70">9.0.70</option>
    <option value="9.0.71">9.0.71</option>
    <option value="9.0.72">9.0.72</option>
    <option value="9.0.73">9.0.73</option>
    <option value="9.0.74">9.0.74</option>
    <option value="9.0.75">9.0.75</option>
    <option value="9.0.76">9.0.76</option>
    <option value="9.0.78">9.0.78</option>
    <option value="9.0.79">9.0.79</option>
    <option value="9.0.80">9.0.80</option>
    <option value="9.0.81">9.0.81</option>
    <option value="9.0.82">9.0.82</option>
    <option value="9.0.83">9.0.83</option>
    <option value="9.0.84">9.0.84</option>
    <option value="9.0.85">9.0.85</option>
    <option value="9.0.86">9.0.86</option>
    <option value="9.0.87">9.0.87</option>
    <option value="9.0.88">9.0.88</option>
    <option value="9.0.89">9.0.89</option>
    <option value="9.0.90">9.0.90</option>
    <option value="9.0.91">9.0.91</option>
    <option value="9.0.93">9.0.93</option>
    <option value="9.0.94">9.0.94</option>
    <option value="9.0.95">9.0.95</option>
    <option value="9.0.96">9.0.96</option>
    <option value="9.0.97">9.0.97</option>
    <option value="9.0.98">9.0.98</option>
    <option value="9.0.99">9.0.99</option>
    <option value="9.0.100">9.0.100</option>
    <option value="9.0.102">9.0.102</option>
    <option value="9.0.104">9.0.104</option>
    <option value="9.0.105">9.0.105</option>
    <option value="9.0.106">9.0.106</option>
    <option value="9.0.107">9.0.107</option>
    <option value="9.0.108">9.0.108</option>
    <option value="9.0.109">9.0.109</option>
    <option value="9.0.110">9.0.110</option>
    <option value="9.0.111">9.0.111</option>
    <option value="9.0.112">9.0.112</option>
    <option value="9.0.113">9.0.113</option>
    <option value="9.0.115">9.0.115</option>
    <option value="9.0.116">9.0.116</option>
    <option value="9.0.117">9.0.117</option>
    <option value="9.0.118">9.0.118</option>
    <option value="9.0.119">9.0.119</option>
    <option value="9.0.120">9.0.120</option>
    <option value="9.0.121">9.0.121</option>
    <option value="9.0.122">9.0.122</option>
    <option value="9.0.123" selected="selected">9.0.123</option>
    </select>,</label> <label>new version:
    <select name="target">
    <option value="9.0.0-M1">9.0.0-M1</option>
    <option value="9.0.0-M3">9.0.0-M3</option>
    <option value="9.0.0-M4">9.0.0-M4</option>
    <option value="9.0.0-M6">9.0.0-M6</option>
    <option value="9.0.0-M8">9.0.0-M8</option>
    <option value="9.0.0-M9">9.0.0-M9</option>
    <option value="9.0.0-M10">9.0.0-M10</option>
    <option value="9.0.0-M11">9.0.0-M11</option>
    <option value="9.0.0-M13">9.0.0-M13</option>
    <option value="9.0.0-M15">9.0.0-M15</option>
    <option value="9.0.0-M17">9.0.0-M17</option>
    <option value="9.0.0-M18">9.0.0-M18</option>
    <option value="9.0.0-M19">9.0.0-M19</option>
    <option value="9.0.0-M20">9.0.0-M20</option>
    <option value="9.0.0-M21">9.0.0-M21</option>
    <option value="9.0.0-M22">9.0.0-M22</option>
    <option value="9.0.0-M26">9.0.0-M26</option>
    <option value="9.0.1">9.0.1</option>
    <option value="9.0.2">9.0.2</option>
    <option value="9.0.4">9.0.4</option>
    <option value="9.0.5">9.0.5</option>
    <option value="9.0.6">9.0.6</option>
    <option value="9.0.7">9.0.7</option>
    <option value="9.0.8">9.0.8</option>
    <option value="9.0.10">9.0.10</option>
    <option value="9.0.11">9.0.11</option>
    <option value="9.0.12">9.0.12</option>
    <option value="9.0.13">9.0.13</option>
    <option value="9.0.14">9.0.14</option>
    <option value="9.0.16">9.0.16</option>
    <option value="9.0.17">9.0.17</option>
    <option value="9.0.19">9.0.19</option>
    <option value="9.0.20">9.0.20</option>
    <option value="9.0.21">9.0.21</option>
    <option value="9.0.22">9.0.22</option>
    <option value="9.0.24">9.0.24</option>
    <option value="9.0.26">9.0.26</option>
    <option value="9.0.27">9.0.27</option>
    <option value="9.0.29">9.0.29</option>
    <option value="9.0.30">9.0.30</option>
    <option value="9.0.31">9.0.31</option>
    <option value="9.0.33">9.0.33</option>
    <option value="9.0.34">9.0.34</option>
    <option value="9.0.35">9.0.35</option>
    <option value="9.0.36">9.0.36</option>
    <option value="9.0.37">9.0.37</option>
    <option value="9.0.38">9.0.38</option>
    <option value="9.0.39">9.0.39</option>
    <option value="9.0.40">9.0.40</option>
    <option value="9.0.41">9.0.41</option>
    <option value="9.0.43">9.0.43</option>
    <option value="9.0.44">9.0.44</option>
    <option value="9.0.45">9.0.45</option>
    <option value="9.0.46">9.0.46</option>
    <option value="9.0.48">9.0.48</option>
    <option value="9.0.50">9.0.50</option>
    <option value="9.0.52">9.0.52</option>
    <option value="9.0.53">9.0.53</option>
    <option value="9.0.54">9.0.54</option>
    <option value="9.0.55">9.0.55</option>
    <option value="9.0.56">9.0.56</option>
    <option value="9.0.58">9.0.58</option>
    <option value="9.0.59">9.0.59</option>
    <option value="9.0.60">9.0.60</option>
    <option value="9.0.62">9.0.62</option>
    <option value="9.0.63">9.0.63</option>
    <option value="9.0.64">9.0.64</option>
    <option value="9.0.65">9.0.65</option>
    <option value="9.0.67">9.0.67</option>
    <option value="9.0.68">9.0.68</option>
    <option value="9.0.69">9.0.69</option>
    <option value="9.0.70">9.0.70</option>
    <option value="9.0.71">9.0.71</option>
    <option value="9.0.72">9.0.72</option>
    <option value="9.0.73">9.0.73</option>
    <option value="9.0.74">9.0.74</option>
    <option value="9.0.75">9.0.75</option>
    <option value="9.0.76">9.0.76</option>
    <option value="9.0.78">9.0.78</option>
    <option value="9.0.79">9.0.79</option>
    <option value="9.0.80">9.0.80</option>
    <option value="9.0.81">9.0.81</option>
    <option value="9.0.82">9.0.82</option>
    <option value="9.0.83">9.0.83</option>
    <option value="9.0.84">9.0.84</option>
    <option value="9.0.85">9.0.85</option>
    <option value="9.0.86">9.0.86</option>
    <option value="9.0.87">9.0.87</option>
    <option value="9.0.88">9.0.88</option>
    <option value="9.0.89">9.0.89</option>
    <option value="9.0.90">9.0.90</option>
    <option value="9.0.91">9.0.91</option>
    <option value="9.0.93">9.0.93</option>
    <option value="9.0.94">9.0.94</option>
    <option value="9.0.95">9.0.95</option>
    <option value="9.0.96">9.0.96</option>
    <option value="9.0.97">9.0.97</option>
    <option value="9.0.98">9.0.98</option>
    <option value="9.0.99">9.0.99</option>
    <option value="9.0.100">9.0.100</option>
    <option value="9.0.102">9.0.102</option>
    <option value="9.0.104">9.0.104</option>
    <option value="9.0.105">9.0.105</option>
    <option value="9.0.106">9.0.106</option>
    <option value="9.0.107">9.0.107</option>
    <option value="9.0.108">9.0.108</option>
    <option value="9.0.109">9.0.109</option>
    <option value="9.0.110">9.0.110</option>
    <option value="9.0.111">9.0.111</option>
    <option value="9.0.112">9.0.112</option>
    <option value="9.0.113">9.0.113</option>
    <option value="9.0.115">9.0.115</option>
    <option value="9.0.116">9.0.116</option>
    <option value="9.0.117">9.0.117</option>
    <option value="9.0.118">9.0.118</option>
    <option value="9.0.119">9.0.119</option>
    <option value="9.0.120">9.0.120</option>
    <option value="9.0.121">9.0.121</option>
    <option value="9.0.122">9.0.122</option>
    <option value="9.0.123">9.0.123</option>
    <option value="9.0.124" selected="selected">9.0.124</option>
    <option value="HEAD">trunk (unreleased)</option>
    </select></label>
    </p>

    <p>
    <button>View Differences</button>
    </p>
    </form>
    <p>You can also use a Git command similar to the following from within a
       working copy:</p>
    <source>git diff 9.0.0 9.0.12 -- conf/</source>
  </subsection>
  
</section>

</body>
</document>
