Ignore:
Timestamp:
2020-03-10T12:09:23+13:00 (4 years ago)
Author:
davidb
Message:

Comment-based changes resulting from: (i) merging in differences from the latest tomcat (v8.5.51), and (ii) better labelling so the places that GSDL changes from the default tomcat file are marked more clearly

File:
1 edited

Legend:

Unmodified
Added
Removed

  • main/trunk/greenstone3/resources/tomcat/web8.xml.svn

    r32696 r34002  
    1616  limitations under the License.
    1717-->
     18<!-- GSDL Notes
     19  To turn a new default 'tomcatN.x.yy/conf/web.xml' into a webN.xml.svn
     20
     21  Uncomment the CGI servlet element, and updated so (init) params:
     22    'debug' is 0,
     23    'passShellEnvironment' is 0
     24    'executable' is @perlpath@perl
     25
     26  Then uncomment the corresponding servlet-mapping element for CGI
     27-->
     28 
     29
    1830<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    1931  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    … …  
    4860  <!--   fileEncoding        Encoding to be used to read static resources   -->
    4961  <!--                       [platform default]                             -->
     62  <!--                                                                      -->
     63  <!--   useBomIfPresent     If a static file contains a byte order mark    -->
     64  <!--                       (BOM), should this be used to determine the    -->
     65  <!--                       file encoding in preference to fileEncoding.   -->
     66  <!--                       [true]                                         -->
    5067  <!--                                                                      -->
    5168  <!--   input               Input buffer size (in bytes) when reading      -->
    … …  
    100117  <!--                       response sent to clients when directory        -->
    101118  <!--                       listings is enabled? [true]                    -->
     119  <!--                                                                      -->
     120  <!--   allowPartialPut     Should the server treat an HTTP PUT request    -->
     121  <!--                       with a Range header as a partial PUT? Note     -->
     122  <!--                       that RFC 7233 clarified that Range headers are -->
     123  <!--                       only valid for GET requests. [true]            -->
    102124
    103125    <servlet>
    … …  
    336358  <!--                        Recommended value: WEB-INF/cgi                -->
    337359  <!--                                                                      -->
     360  <!--  cmdLineArgumentsDecoded                                             -->
     361  <!--                        Only used when enableCmdLineArguments is      -->
     362  <!--                        true. The pattern that individual decoded     -->
     363  <!--                        command line arguments must match else the    -->
     364  <!--                        request will be rejected. This is to          -->
     365  <!--                        work-around various issues when Java passes   -->
     366  <!--                        the arguments to the OS. See the CGI How-To   -->
     367  <!--                        for more details. The default varies by       -->
     368  <!--                        platform.                                     -->
     369  <!--                        Windows: [[a-zA-Z0-9\Q-_.\\/:\E]+]            -->
     370  <!--                        Others:  [.*]                                 -->
     371  <!--                        Note that internally the CGI Servlet treats   -->
     372  <!--                        [.*] as a special case to improve performance -->
     373  <!--                                                                      -->
     374  <!--   cmdLineArgumentsEncoded                                            -->
     375  <!--                        Only used when enableCmdLineArguments is      -->
     376  <!--                        true. The pattern that individual encoded     -->
     377  <!--                        command line arguments must match else the    -->
     378  <!--                        request will be rejected. The default matches -->
     379  <!--                        the allowed values defined by RFC3875.        -->
     380  <!--                        [[a-zA-Z0-9\Q%;/?:@&,$-_.!~*'()\E]+]          -->
     381  <!--                                                                      -->
    338382  <!--   enableCmdLineArguments                                             -->
    339383  <!--                        Are command line parameters generated from    -->
    340384  <!--                        the query string as per section 4.4 of 3875   -->
    341   <!--                        RFC? [true]                                   -->
     385  <!--                        RFC? [false]                                  -->
    342386  <!--                                                                      -->
    343387  <!--   executable           Name of the executable used to run the        -->
    … …  
    374418
    375419
    376   <!-- Greenstone makes use of CGI through some Perl scripts -->
     420    <!-- GSDL: Greenstone makes use of CGI through some Perl scripts, so we need this element in-play  --> 
    377421    <servlet>
    378422        <servlet-name>cgi</servlet-name>
    … …  
    382426          <param-value>WEB-INF/cgi</param-value>
    383427        </init-param>
     428
    384429        <init-param>
    385430          <param-name>debug</param-name>
    386431          <param-value>0</param-value>
    387432        </init-param>
    388 
    389     <init-param>
    390       <param-name>passShellEnvironment</param-name>
    391       <param-value>true</param-value>
    392     </init-param>
    393     <init-param>
    394       <param-name>executable</param-name>
    395       <param-value>@perlpath@perl</param-value>
    396     </init-param>
    397 
     433        <init-param>
     434          <param-name>passShellEnvironment</param-name>
     435          <param-value>true</param-value>
     436        </init-param>
     437        <init-param>
     438          <param-name>executable</param-name>
     439          <param-value>@perlpath@perl</param-value>
     440        </init-param>
     441   
    398442        <load-on-startup>5</load-on-startup>
    399443    </servlet>
    … …  
    432476    <!-- The mapping for the CGI Gateway servlet -->
    433477
    434 
     478    <!-- GSDL: Greenstone makes use of CGI through some Perl scripts, so we need this element in-play  -->
    435479    <servlet-mapping>
    436480        <servlet-name>cgi</servlet-name>
Note: See TracChangeset for help on using the changeset viewer.