[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH RESEND] manual: escape backslashes in "parsed-literal" blocks
From: |
Philippe Mathieu-Daudé |
Subject: |
Re: [PATCH RESEND] manual: escape backslashes in "parsed-literal" blocks |
Date: |
Tue, 8 Sep 2020 20:14:56 +0200 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.11.0 |
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>