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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Thomas Rast <trast@xxxxxxxxxxx> writes:

> -``Com M Itter'') and `<email>` is the person's email address
> -(``cm@xxxxxxxxxxx'').  `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@xxxxxxxxxxx`).  `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
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]