bug#31405: 25.3; Python.el doesn't provide infos to info-lookup-symbol

[Eli Zaretskii <eliz@gnu.org>]

> From: Augusto Stoffel <arstoffel@gmail.com>
> Date: Sat, 28 Aug 2021 11:56:10 +0200
> Cc: contovob@tcd.ie, larsi@gnus.org, stefan@marxist.se, npostavs@gmail.com,
>  seb@k-7.ch
> 
> FWIW, the Info version of the Python manual doesn't look very good.  The
> (only) reason being that Info doesn't let you write a plain hyperlink in
> the middle of a sentence; rather it assumes that all hyperlinks are part
> of the phrase “See [link target].”.
> 
> Since the Python manual wasn't written specifically for Texinfo, it has
> lots of hyperlinks, and so will say things like "this function takes a
> see string. as argument and return a see boolean."

That's because they use tools that mainly target HTML docs, and don't
much care about the other output formats.  These inline references
look badly in print.  GCC is migrating to the same tools, and its
manuals will have the same problems (because people who drive this
migration don't seem to care too much about Info, either).

> I brought this up in [1], but unfortunately the Texinfo people seem to
> like this limitation a lot.

The way to overcome this difficulty is to use Texinfo macros, so that
these inline references look in HTML as HTML users expect, but at the
same time don't uglify Info or PS/PDF output.  I believe this was
mentioned on the Texinfo list more than once.