Re: [PATCH] docs: stop using asciidoc no-inline-literal

[Thomas Rast <trast@student.ethz.ch>]

Thomas Rast <trast@inf.ethz.ch> writes:

> -``Com M Itter'') and `<email>` is the person's email address
> -(``cm@example.com'').  `LT` and `GT` are the literal less-than (\x3c)
> -and greater-than (\x3e) symbols.  These are required to delimit
> +`Com M Itter`) and `<email>` is the person's email address
> +(`cm@example.com`).  `LT` and `GT` are the literal less-than (`\x3c`)
> +and greater-than (`\x3e`) symbols.  These are required to delimit
[...]
>
> On my box (asciidoc 8.4.5) the preimage renders as
>
>   `Com M Itter''
>
> in fixed-width font.

Note that ``foo'' is the correct way to have it render “foo” (with the
smart quotes).  So it's not even a formatting error on our end, just
massive quoting rules brain damage that ruins the use of quotes here.

(I had this in the original email, but then edited it out.  Sorry for
any undue confusion caused.)

> In the process of debugging this, I noticed that
> the quoting rules are hilariously screwy.  It seems that within a
> paragraph, saying
>
>   ``foo'' means `bar`
>    ^^^^^^^^^^^^^
>
> treats the underlined part as a `-quoted chunk of text, and renders it
> appropriately using a fixed-width font.  The trailing ` has no effect
> unless it is followed by another ` within the same paragraph.  But the `
> right at the start of the "quoted" text has no effect either!  Moreover,
> this behaviour is the same regardless of the 'asciidoc7compatible'
> setting.  I wonder if it has since been fixed, but the above might be a
> good idea anyway.  (The quoting around \xAB is just for good measure.)

-- 
Thomas Rast
trast@{inf,student}.ethz.ch