Repository: trafficserver Updated Branches: refs/heads/master d107b7cfb -> 5f738a28e
TS-2576: Update description of LogFormat in logs_xml.config.en.rst Signed-off-by: Yunkai Zhang <qiushu....@taobao.com> Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/5f738a28 Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/5f738a28 Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/5f738a28 Branch: refs/heads/master Commit: 5f738a28e1ca4cca93be3f4994632d24b6530abe Parents: d107b7c Author: Yunkai Zhang <qiushu....@taobao.com> Authored: Thu Feb 27 11:31:59 2014 +0800 Committer: Yunkai Zhang <qiushu....@taobao.com> Committed: Thu Feb 27 11:36:35 2014 +0800 ---------------------------------------------------------------------- doc/reference/configuration/logs_xml.config.en.rst | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/trafficserver/blob/5f738a28/doc/reference/configuration/logs_xml.config.en.rst ---------------------------------------------------------------------- diff --git a/doc/reference/configuration/logs_xml.config.en.rst b/doc/reference/configuration/logs_xml.config.en.rst index 43a030a..4599968 100644 --- a/doc/reference/configuration/logs_xml.config.en.rst +++ b/doc/reference/configuration/logs_xml.config.en.rst @@ -61,8 +61,16 @@ The following list shows ``LogFormat`` specifications. ``<Format = "valid_format_specification"/>`` Required A valid format specification is a printf-style string describing - each log entry when formatted for ASCII output. Use ``%<`` - ``field`` ``>`` as a placeholder for valid field names. For more + each log entry when formatted for ASCII output. + + The printf-style could accept Oct/Hex escape representation: + + - ``\abc`` is Oct escape sequence, a,b,c should be one of [0-9], and + (a*8^2 + b*8 + c) should be greater than 0 and less than 255. + - ``\xab`` is Hex escape sequence, a,b should be one of [0-9, a-f, A-F], + and (a*16 + b) should be greater than 0 and less than 255. + + Use ``%<`` ``field`` ``>`` as a placeholder for valid field names. For more information, refer to :ref:`custom-logging-fields`. The specified field can be one of the following types:
