From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#31405: 25.3; Python.el doesn't provide infos to info-lookup-symbol Date: Sat, 28 Aug 2021 13:05:52 +0300 Message-ID: <83a6l1opdr.fsf@gnu.org> References: <8736yz4jp9.fsf@k-7.ch> <87k0kqkayt.fsf@gnus.org> <871r6yd7c1.fsf@tcd.ie> <87o8a2hend.fsf@gnus.org> <87lf56vfd7.fsf@tcd.ie> <87k0k5evut.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25402"; mail-complaints-to="usenet@ciao.gmane.io" Cc: seb@k-7.ch, stefan@marxist.se, npostavs@gmail.com, contovob@tcd.ie, 31405@debbugs.gnu.org, larsi@gnus.org To: Augusto Stoffel Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Aug 28 12:07:09 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mJvEz-0006Rn-4j for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 28 Aug 2021 12:07:09 +0200 Original-Received: from localhost ([::1]:48614 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mJvEy-0004Gr-7G for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 28 Aug 2021 06:07:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49286) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mJvEs-0004Gf-Gx for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2021 06:07:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:41888) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mJvEs-000835-8o for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2021 06:07:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mJvEs-0001wE-0G for bug-gnu-emacs@gnu.org; Sat, 28 Aug 2021 06:07:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 28 Aug 2021 10:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31405 X-GNU-PR-Package: emacs Original-Received: via spool by 31405-submit@debbugs.gnu.org id=B31405.16301451787380 (code B ref 31405); Sat, 28 Aug 2021 10:07:01 +0000 Original-Received: (at 31405) by debbugs.gnu.org; 28 Aug 2021 10:06:18 +0000 Original-Received: from localhost ([127.0.0.1]:53434 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mJvE9-0001uy-Tb for submit@debbugs.gnu.org; Sat, 28 Aug 2021 06:06:18 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:32986) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mJvE7-0001uc-9Z for 31405@debbugs.gnu.org; Sat, 28 Aug 2021 06:06:16 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:59162) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mJvE1-0007Ec-18; Sat, 28 Aug 2021 06:06:09 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:3476 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mJvE0-0002Yh-KY; Sat, 28 Aug 2021 06:06:08 -0400 In-Reply-To: <87k0k5evut.fsf@gmail.com> (message from Augusto Stoffel on Sat, 28 Aug 2021 11:56:10 +0200) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:212866 Archived-At: > From: Augusto Stoffel > 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.