Bug#932957: #932957 Please migrate Release Notes to reStructuredText

[Richard Lewis <richard.lewis.debian@googlemail.com>]

Holger Wansing <hwansing@mailbox.org> writes:

> Richard Lewis <richard.lewis.debian@googlemail.com> wrote (Sun, 30 Jul 2023 11:10:10 +0100):
>> in [0] the '#' is meant to indicate 'run this as root', but the rst has
>> '.. code-block:: shell' so the commands are being formatted as a
>> comment.
>
> Yes, there are different methods for including quoted material, and they are
> somewhat tricky sometimes.
>
> I may lack detailed experience on this, so need more details:
> - What's the exact URL where you found this? (there was no such link as [0])
> - What makes you think, that the commands are formatted as comment?
>   Is it the font color or what?

sorry - it's the use of italic in eg '# apt-mark auto rsyslog'
https://people.debian.org/~holgerw/release-notes_sphinx/www.debian.org/releases/trixie/release-notes/issues.en.html#changes-to-system-logging


i found
https://stackoverflow.com/questions/16397794/how-to-show-terminal-shell-code-snippets-in-sphinx
which i think says that 'code-block:: console' might be better than
'code-block:: shell', but i may be misunderstanding that page