DOC/MINOR: reformat configuration.txt's "quoting and escaping" table

The table in section 2.2 ("Quoting and escaping") was formated in a way
which is not recognized by haproxy-dconv, breaking it, and cutting off
the entire section.
This commit fix that by formatting the table in way which allows the
converter to produce the correct HTML.

Fixes cbonte/haproxy-dconv#35
This commit is contained in:
Marcos de Oliveira 2023-03-17 11:03:13 -03:00 committed by Willy Tarreau
parent 2c5b9ded9b
commit 3b7a351a97

View File

@ -586,19 +586,28 @@ As a result, here is the matrix indicating how special characters can be
entered in different contexts (unprintable characters are replaced with their entered in different contexts (unprintable characters are replaced with their
name within angle brackets). Note that some characters that may only be name within angle brackets). Note that some characters that may only be
represented escaped have no possible representation inside single quotes, represented escaped have no possible representation inside single quotes,
hence the '-' there: hence its absence there:
Character | Unquoted | Weakly quoted | Strongly quoted Character | Unquoted | Weakly quoted | Strongly quoted
-----------+---------------+-----------------------------+----------------- -----------+---------------+-----------------------------+-----------------
<TAB> | \<TAB>, \x09 | "<TAB>", "\<TAB>", "\x09" | '<TAB>' <TAB> | \<TAB>, \x09 | "<TAB>", "\<TAB>", "\x09" | '<TAB>'
<LF> | \n, \x0a | "\n", "\x0a" | - -----------+---------------+-----------------------------+-----------------
<CR> | \r, \x0d | "\r", "\x0d" | - <LF> | \n, \x0a | "\n", "\x0a" |
-----------+---------------+-----------------------------+-----------------
<CR> | \r, \x0d | "\r", "\x0d" |
-----------+---------------+-----------------------------+-----------------
<SPC> | \<SPC>, \x20 | "<SPC>", "\<SPC>", "\x20" | '<SPC>' <SPC> | \<SPC>, \x20 | "<SPC>", "\<SPC>", "\x20" | '<SPC>'
-----------+---------------+-----------------------------+-----------------
" | \", \x22 | "\"", "\x22" | '"' " | \", \x22 | "\"", "\x22" | '"'
-----------+---------------+-----------------------------+-----------------
# | \#, \x23 | "#", "\#", "\x23" | '#' # | \#, \x23 | "#", "\#", "\x23" | '#'
-----------+---------------+-----------------------------+-----------------
$ | $, \$, \x24 | "\$", "\x24" | '$' $ | $, \$, \x24 | "\$", "\x24" | '$'
' | \', \x27 | "'", "\'", "\x27" | - -----------+---------------+-----------------------------+-----------------
' | \', \x27 | "'", "\'", "\x27" |
-----------+---------------+-----------------------------+-----------------
\ | \\, \x5c | "\\", "\x5c" | '\' \ | \\, \x5c | "\\", "\x5c" | '\'
-----------+---------------+-----------------------------+-----------------
Example: Example:
# those are all strictly equivalent: # those are all strictly equivalent: