[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH RESEND] manual: escape backslashes in "parsed-literal" blocks
From: |
Laszlo Ersek |
Subject: |
Re: [PATCH RESEND] manual: escape backslashes in "parsed-literal" blocks |
Date: |
Wed, 9 Sep 2020 13:09:25 +0200 |
On 09/08/20 20:14, Philippe Mathieu-Daudé wrote:
> On 9/8/20 7:21 PM, Laszlo Ersek wrote:
>> According to
>> <https://docutils.sourceforge.io/docs/ref/rst/directives.html#parsed-literal>,
>> "inline markup is recognized and there is no protection from parsing.
>> Backslash-escapes may be necessary to prevent unintended parsing".
>>
>> The qemu(1) manual page (formatted with Sphinx 2.2.2) has several overlong
>> lines on my system. A stand-alone backslash at EOL serves as line
>> continuation in a "parsed-literal" block. Therefore, escape the
>> backslashes that we want to appear as such in the formatted documentation.
>>
>> Cc: Peter Maydell <peter.maydell@linaro.org>
>> Signed-off-by: Laszlo Ersek <lersek@redhat.com>
>> ---
>>
>> Notes:
>> Resending with Peter's email address in the Cc: tag fixed. Sorry!
>>
>> docs/system/device-url-syntax.rst.inc | 8 +-
>> qemu-options.hx | 108 ++++++++++----------
>> 2 files changed, 58 insertions(+), 58 deletions(-)
>
> Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
>
Thanks for the quick check!
Laszlo