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

From: Thomas Rast <trast@student.ethz.ch>
Date: Apr 26, 2012, 09:50 UTC
Message-ID: <87sjfqn7og.fsf@thomas.inf.ethz.ch>
In-Reply-To: <87d36uomlq.fsf@thomas.inf.ethz.ch>

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

Show 6 quoted lines

> -``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

[...]

Show 6 quoted lines

>
> 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.)

Show 14 quoted lines

> 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