[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH for-5.2] docs: Get rid of the weird _005f links in the man pa
From: |
Peter Maydell |
Subject: |
Re: [PATCH for-5.2] docs: Get rid of the weird _005f links in the man page |
Date: |
Mon, 16 Nov 2020 15:32:12 +0000 |
On Mon, 16 Nov 2020 at 14:53, Thomas Huth <thuth@redhat.com> wrote:
>
> The man page does not contain all the chapters from the System Emulation
> Users Guide, so some of the links that we've put into the qemu options
> descriptions can not be resolved and thus the link names are used in the
> man pages instead. These link names currently contain weird "_005f" letters
> in the middle and just do not make any sense for the users. To avoid this
> situation, replace the link names with more descriptive, natural text.
The "_005f" is a legacy from the automatic conversion from Texinfo.
In Texinfo, link names could not contain underscores and so for
instance the link to the GDB usage was "gdb_usage". The conversion
to rST seems to have taken a broad view of what might be a
punctuation character that needed escaping, and so converted the '_'
into a hex-representation (ASCII 0x5f being '_'), giving
"gdb_005fusage".
thanks
-- PMM