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-System.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 ‘a.syntax-symbol’ CSS different from just
‘a’, I’m all ears!)

This is happening in ‘doc/build.scm’ as a post-processing step 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—e.g., anytime “service” appears, it’ll link to the ‘service’
procedure.

I’d like to extend it to include references to the Guile manual, so that
one could click on, say, ‘append’, but there might be too many false
positives at that point.  And then we would need DrRacket fanciness to
be able to determine what an identifier really refers to…

Feedback welcome!

Ludo’.

Reply via email to