[Top][All Lists]

[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

-- PMM

reply via email to

[Prev in Thread] Current Thread [Next in Thread]