Bug 155402 – dev-lisp/clisp: support for disabling the online documentation

• Product: Gentoo Linux
• Status: RESOLVED FIXED

[Description nefercheprure 2006-11-16 11:43:22 UTC]

The ebuild shall be made customizable as to the use of the external documentation. This should be as easy as replacing:

sed -i 's,http://www.lisp.org/HyperSpec/,http://www.lispworks.com/reference/HyperSpec/,g' config.lisp

line with something more to the likeness (XXXX represents a suitable use flag):

if use XXXX ; then
  sed -i 's,http://www.lisp.org/HyperSpec/,http://www.lispworks.com/reference/HyperSpec/,g' config.lisp
else
  sed -i 's,"http://www.lisp.org/HyperSpec/",nil,' config.lisp
fi

Alternatively, the fact, that the HyperSpec is installed locally could be taken advantage of too. I do not have a ready made solution, that is both robust and does not introduce a dependency (which is not advisable for the sake of those not willing to install the HyperSpec locally).

Moreover, the URL now used, while still functional, reports a "301 Moved Permanently" status. The new URL shall be:
http://www.lispworks.com/documentation/HyperSpec/

The file impnotes.html is installed locally. It would be nice, if the config.lisp would be notified of the fact, as described in  http://clisp.cons.org/impnotes.html#describe (under the subheading Function CUSTOM:IMPNOTES-ROOT.)


This bug could be construed an enhancement request. Even though it can, it is not marked so, because of the annoyance its absence causes.

[Comment 1 Marijn Schouten (RETIRED) 2008-05-15 22:02:30 UTC]

fixed, though we should consider using the configure option to set the hyperspec url.

[Comment 2 Marijn Schouten (RETIRED) 2009-07-29 11:03:47 UTC]

Actually that is what we do now, so this can be closed.