[GitHub] [tomcat] markt-asf commented on a change in pull request #138: Expanding SSI documentation (bug # 63184)
markt-asf commented on a change in pull request #138: Expanding SSI documentation (bug # 63184) URL: https://github.com/apache/tomcat/pull/138#discussion_r265734162 ## File path: webapps/docs/ssi-howto.xml ## @@ -146,27 +146,53 @@ false. The directives are: -config - !--#config timefmt=%B %Y -- -Used to set the format of dates and other items processed by SSI +config - !--#config errmsg=Error occured sizefmt=abbrev timefmt=%B %Y -- +Used to set SSI error message, the format of dates and file sizes processed by SSI. +All are optional but at least one must be used. The available options are as follows: + +errmsg - error message used for SSI errors +sizefmt - format used for sizes in the fsize directive +timefmt - format used for timestamps in the flastmod directive -echo - !--#echo var=VARIABLE_NAME -- +echo - !--#echo var=VARIABLE_NAME encoding=entity -- will be replaced by the value of the variable. + +The optional encoding parameter specifies the type of encoding to use. +Valid values are entity (default), url or none. +NOTE: Using an encoding other than entity can lead to security issues. -exec - Used to run commands on the host system. +exec - !--#exec cmd=file-name -- +Used to run commands on the host system. + + +exec - !--#exec cgi=file-name -- +This acts the same as the include directive, and doesn't actually execute any commands. + + +include - !--#include file=file-name -- +inserts the contents, this is interpreted relative to the current directory. include - !--#include virtual=file-name -- -inserts the contents +inserts the contents, this is interpreted relative to the document being served. flastmod - !--#flastmod file=filename.shtml -- -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. + + +flastmod - !--#flastmod virtual=filename.shtml -- +Returns the time that a file was lost modified, this is interpreted relative to the document being served. Review comment: "last modified" not "lost modified" 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
[GitHub] [tomcat] markt-asf commented on a change in pull request #138: Expanding SSI documentation (bug # 63184)
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. The directives are: -config - !--#config timefmt=%B %Y -- -Used to set the format of dates and other items processed by SSI +config - !--#config errmsg=Error occured sizefmt=abbrev timefmt=%B %Y -- +Used to set SSI error message, the format of dates and file sizes processed by SSI. +All are optional but at least one must be used. The available options are as follows: + +errmsg - error message used for SSI errors +sizefmt - format used for sizes in the fsize directive +timefmt - format used for timestamps in the flastmod directive -echo - !--#echo var=VARIABLE_NAME -- +echo - !--#echo var=VARIABLE_NAME encoding=entity -- will be replaced by the value of the variable. + +The optional encoding parameter specifies the type of encoding to use. +Valid values are entity (default), url or none. +NOTE: Using an encoding other than entity can lead to security issues. -exec - Used to run commands on the host system. +exec - !--#exec cmd=file-name -- +Used to run commands on the host system. + + +exec - !--#exec cgi=file-name -- +This acts the same as the include directive, and doesn't actually execute any commands. + + +include - !--#include file=file-name -- +inserts the contents, this is interpreted relative to the current directory. include - !--#include virtual=file-name -- -inserts the contents +inserts the contents, this is interpreted relative to the document being served. flastmod - !--#flastmod file=filename.shtml -- -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. + 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
[GitHub] [tomcat] markt-asf commented on a change in pull request #138: Expanding SSI documentation (bug # 63184)
markt-asf commented on a change in pull request #138: Expanding SSI documentation (bug # 63184) URL: https://github.com/apache/tomcat/pull/138#discussion_r265735188 ## File path: webapps/docs/ssi-howto.xml ## @@ -146,27 +146,53 @@ false. The directives are: -config - !--#config timefmt=%B %Y -- -Used to set the format of dates and other items processed by SSI +config - !--#config errmsg=Error occured sizefmt=abbrev timefmt=%B %Y -- +Used to set SSI error message, the format of dates and file sizes processed by SSI. +All are optional but at least one must be used. The available options are as follows: + +errmsg - error message used for SSI errors +sizefmt - format used for sizes in the fsize directive +timefmt - format used for timestamps in the flastmod directive -echo - !--#echo var=VARIABLE_NAME -- +echo - !--#echo var=VARIABLE_NAME encoding=entity -- will be replaced by the value of the variable. + +The optional encoding parameter specifies the type of encoding to use. +Valid values are entity (default), url or none. +NOTE: Using an encoding other than entity can lead to security issues. -exec - Used to run commands on the host system. +exec - !--#exec cmd=file-name -- +Used to run commands on the host system. + + +exec - !--#exec cgi=file-name -- +This acts the same as the include directive, and doesn't actually execute any commands. + + +include - !--#include file=file-name -- +inserts the contents, this is interpreted relative to the current directory. include - !--#include virtual=file-name -- -inserts the contents +inserts the contents, this is interpreted relative to the document being served. flastmod - !--#flastmod file=filename.shtml -- -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. + + +flastmod - !--#flastmod virtual=filename.shtml -- +Returns the time that a file was lost modified, this is interpreted relative to the document being served. fsize - !--#fsize file=filename.shtml -- -Returns the size of a file. +Returns the size of a file, this is interpreted relative to the current directory. + Review comment: "relative to the current directory"? That looks like a copy/paste error. 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
[GitHub] [tomcat] markt-asf commented on a change in pull request #138: Expanding SSI documentation (bug # 63184)
markt-asf commented on a change in pull request #138: Expanding SSI documentation (bug # 63184) URL: https://github.com/apache/tomcat/pull/138#discussion_r265735282 ## File path: webapps/docs/ssi-howto.xml ## @@ -146,27 +146,53 @@ false. The directives are: -config - !--#config timefmt=%B %Y -- -Used to set the format of dates and other items processed by SSI +config - !--#config errmsg=Error occured sizefmt=abbrev timefmt=%B %Y -- +Used to set SSI error message, the format of dates and file sizes processed by SSI. +All are optional but at least one must be used. The available options are as follows: + +errmsg - error message used for SSI errors +sizefmt - format used for sizes in the fsize directive +timefmt - format used for timestamps in the flastmod directive -echo - !--#echo var=VARIABLE_NAME -- +echo - !--#echo var=VARIABLE_NAME encoding=entity -- will be replaced by the value of the variable. + +The optional encoding parameter specifies the type of encoding to use. +Valid values are entity (default), url or none. +NOTE: Using an encoding other than entity can lead to security issues. -exec - Used to run commands on the host system. +exec - !--#exec cmd=file-name -- +Used to run commands on the host system. + + +exec - !--#exec cgi=file-name -- +This acts the same as the include directive, and doesn't actually execute any commands. + + +include - !--#include file=file-name -- +inserts the contents, this is interpreted relative to the current directory. include - !--#include virtual=file-name -- -inserts the contents +inserts the contents, this is interpreted relative to the document being served. flastmod - !--#flastmod file=filename.shtml -- -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. + + +flastmod - !--#flastmod virtual=filename.shtml -- +Returns the time that a file was lost modified, this is interpreted relative to the document being served. fsize - !--#fsize file=filename.shtml -- -Returns the size of a file. +Returns the size of a file, this is interpreted relative to the current directory. + + +fsize - !--#fsize virtual=filename.shtml -- +Returns the size of a file, this is interpreted relative to the document being served. Review comment: "relative to the document"? 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