common-lisp-hyperspec-root should be file:///usr/share/doc/hyperspec/ instead

Bug #1909409 reported by u922796
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
hyperspec (Ubuntu)
New
Undecided
Unassigned

Bug Description

The current startup file contains: (setq common-lisp-hyperspec-root "/usr/share/doc/hyperspec/").

It should be changed to (setq common-lisp-hyperspec-root "file:///usr/share/doc/hyperspec/").

Reasons:

* When the Emacs default browser is Eww (setq browse-url-browser-function 'eww-browse-url), having common-lisp-hyperspec-root set to "/usr/share/doc/hyperspec/" breaks things. Eww will be looking for http:///usr/share/doc/hyperspec/... The error message will be: "open-network-stream: /80 Name or service not known".

Although the current value works for web browsers such as Firefox, it may break for other browsers such as Eww. Firefox automatically converts paths like /usr/share/doc/hyperspec/... into file:///usr/share/doc/hyperspec/... Eww does not do this conversion.

* The documentation for the variable explicitly mentions how the variable should be for a local copy of the HyperSpec. I quote:

    The root of the Common Lisp HyperSpec URL.
    If you copy the HyperSpec to your local system, set this variable to something like "file://usr/local/doc/HyperSpec/".

How to fix the problem:

Replace (setq common-lisp-hyperspec-root "/usr/share/doc/hyperspec/") with (setq common-lisp-hyperspec-root "file:///usr/share/doc/hyperspec/") on lines 7 and 11 of the start up file.

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.