manual: escape backslashes in "parsed-literal" blocks
commit353a06b425256cdab06be423863241cb5be1885e
authorLaszlo Ersek <lersek@redhat.com>
Tue, 8 Sep 2020 17:21:11 +0000 (8 19:21 +0200)
committerLaurent Vivier <laurent@vivier.eu>
Wed, 16 Sep 2020 08:52:34 +0000 (16 10:52 +0200)
treed9dea9b1e5548cb545d6d61abd8059d828002359
parentcf0560b9c16e0b0e37cc46c9cd5a57c4315b25db
manual: escape backslashes in "parsed-literal" blocks

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>
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Message-Id: <20200908172111.19072-1-lersek@redhat.com>
Signed-off-by: Laurent Vivier <laurent@vivier.eu>
docs/system/device-url-syntax.rst.inc
qemu-options.hx