From mboxrd@z Thu Jan  1 00:00:00 1970
From: =?utf-8?Q?Ludovic_Court=C3=A8s?= <ludo@gnu.org>
Subject: Hyperlinks!
Date: Mon, 13 Apr 2020 12:58:42 +0200
Message-ID: <87eesrlkil.fsf@gnu.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane-mx.org@gnu.org>
Received: from eggs.gnu.org ([2001:470:142:3::10]:57830)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <ludo@gnu.org>) id 1jNwnc-0002ZU-O1
 for guix-devel@gnu.org; Mon, 13 Apr 2020 06:58:45 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e]:47280)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <ludo@gnu.org>)
 id 1jNwnc-00084y-L4
 for guix-devel@gnu.org; Mon, 13 Apr 2020 06:58:44 -0400
Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=57370 helo=ribbon)
 by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
 (Exim 4.82) (envelope-from <ludo@gnu.org>) id 1jNwnc-0003G8-8K
 for guix-devel@gnu.org; Mon, 13 Apr 2020 06:58:44 -0400
List-Id: "Development of GNU Guix and the GNU System distribution."
 <guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
 <mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/guix-devel>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
 <mailto:guix-devel-request@gnu.org?subject=subscribe>
Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane-mx.org@gnu.org
Sender: "Guix-devel"
 <guix-devel-bounces+gcggd-guix-devel=m.gmane-mx.org@gnu.org>
To: guix-devel@gnu.org

Hello Guix!

Scheme code snippets in the on-line manual now have hyperlinks for all
the symbols documented in the manual:

  https://guix.gnu.org/manual/devel/en/html_node/Using-the-Configuration-Sy=
stem.html
  https://guix.gnu.org/manual/devel/en/html_node/Defining-Packages.html

Hyperlinks are such an amazing invention!

(If anyone knows how to get =E2=80=98a.syntax-symbol=E2=80=99 CSS different=
 from just
=E2=80=98a=E2=80=99, I=E2=80=99m all ears!)

This is happening in =E2=80=98doc/build.scm=E2=80=99 as a post-processing s=
tep on the
makeinfo-generated HTML (along with the syntax-highlighting
post-processing step).  It works well but there can be false positives
because it matches on identifiers, without taking scope etc. into
account=E2=80=94e.g., anytime =E2=80=9Cservice=E2=80=9D appears, it=E2=80=
=99ll link to the =E2=80=98service=E2=80=99
procedure.

I=E2=80=99d like to extend it to include references to the Guile manual, so=
 that
one could click on, say, =E2=80=98append=E2=80=99, but there might be too m=
any false
positives at that point.  And then we would need DrRacket fanciness to
be able to determine what an identifier really refers to=E2=80=A6

Feedback welcome!

Ludo=E2=80=99.