From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.help Subject: Re: Info viewer: Links to function documentations? Date: Wed, 25 Mar 2020 13:01:04 -0400 Message-ID: References: <86blokhh1u.fsf@duenenhof-wilhelm.de> <83sghwa2d9.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="42906"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) To: help-gnu-emacs@gnu.org Cancel-Lock: sha1:3YwSR9BWjCo7LKMxvjrD7JyloKA= Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Wed Mar 25 18:01:37 2020 Return-path: Envelope-to: geh-help-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 1jH9PM-000B4x-DK for geh-help-gnu-emacs@m.gmane-mx.org; Wed, 25 Mar 2020 18:01:36 +0100 Original-Received: from localhost ([::1]:39732 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jH9PL-0003Uh-Fi for geh-help-gnu-emacs@m.gmane-mx.org; Wed, 25 Mar 2020 13:01:35 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56686) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jH9P0-0003Tn-Ca for help-gnu-emacs@gnu.org; Wed, 25 Mar 2020 13:01:15 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jH9Oz-0005Ja-9t for help-gnu-emacs@gnu.org; Wed, 25 Mar 2020 13:01:14 -0400 Original-Received: from ciao.gmane.io ([159.69.161.202]:55222) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1jH9Oz-0005JO-3d for help-gnu-emacs@gnu.org; Wed, 25 Mar 2020 13:01:13 -0400 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1jH9Ow-000AZN-Q4 for help-gnu-emacs@gnu.org; Wed, 25 Mar 2020 18:01:10 +0100 X-Injected-Via-Gmane: http://gmane.org/ X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 159.69.161.202 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:122664 Archived-At: >> Info would indeed benefit from better use of hyperlinks (and images). >> This will require using a different format, tho, since the Info format >> is barely more than plain text. > > As for hyperlinks to Emacs documentation: if the intent is to link to > the doc strings, then this is just a question of someone coming up > with the code to do that. I was thinking more of the "redundant" hyperlinks you can see e.g. in Wikipedia, where lots of words are hyperlinked "just in case". Texinfo doesn't encourage this practice because it was designed for paper and (mostly) plain text, where references can be annoying in the text, unlike the relatively inconspicuous "blue with underline" used for web hyperlinks. And AFAIK the Info format also doesn't support such lightweight hyperlinks really (IIRC info-mode may try to make some links lighter weight by eliding some surrounding text (which plays the role of markup), but it's a bit brittle and negatively affects the paragraph filling of the surrounding text). Stefan