On Mon, 16 Nov 2020 at 14:53, Thomas Huth <th...@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