markt-asf commented on a change in pull request #138: Expanding SSI documentation (bug # 63184) URL: https://github.com/apache/tomcat/pull/138#discussion_r265734995
########## File path: webapps/docs/ssi-howto.xml ########## @@ -146,27 +146,53 @@ false.</li> <p>The directives are:</p> <ul> <li> -<strong>config</strong> - <code><!--#config timefmt="%B %Y" --></code> -Used to set the format of dates and other items processed by SSI +<strong>config</strong> - <code><!--#config errmsg="Error occured" sizefmt="abbrev" timefmt="%B %Y" --></code> +Used to set SSI error message, the format of dates and file sizes processed by SSI.<br/> +All are optional but at least one must be used. The available options are as follows: +<br/> +<strong>errmsg</strong> - error message used for SSI errors<br/> +<strong>sizefmt</strong> - format used for sizes in the <strong>fsize</strong> directive<br/> +<strong>timefmt</strong> - format used for timestamps in the <strong>flastmod</strong> directive<br/> </li> <li> -<strong>echo</strong> - <code><!--#echo var="VARIABLE_NAME" --></code> +<strong>echo</strong> - <code><!--#echo var="VARIABLE_NAME" encoding="entity" --></code> will be replaced by the value of the variable. +<br/> +The optional <strong>encoding</strong> parameter specifies the type of encoding to use. +Valid values are <strong>entity</strong> (default), <strong>url</strong> or <strong>none</strong>. +NOTE: Using an encoding other than <strong>entity</strong> can lead to security issues. </li> <li> -<strong>exec</strong> - Used to run commands on the host system. +<strong>exec</strong> - <code><!--#exec cmd="file-name" --></code> +Used to run commands on the host system. +</li> +<li> +<strong>exec</strong> - <code><!--#exec cgi="file-name" --></code> +This acts the same as the <strong>include</strong> directive, and doesn't actually execute any commands. +</li> +<li> +<strong>include</strong> - <code><!--#include file="file-name" --></code> +inserts the contents, this is interpreted relative to the current directory. </li> <li> <strong>include</strong> - <code><!--#include virtual="file-name" --></code> -inserts the contents +inserts the contents, this is interpreted relative to the document being served. </li> <li> <strong>flastmod</strong> - <code><!--#flastmod file="filename.shtml" --></code> -Returns the time that a file was lost modified. +Returns the time that a file was lost modified, this is interpreted relative to the current directory. +</li> Review comment: "last" not "lost" "relative to the current directory"? ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org With regards, Apache Git Services --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org
