Subject: Re: So, where's the "Javadoc" for COMMON Lisp?
From: Erik Naggum <erik@naggum.net>
Date: Wed, 18 Jul 2001 17:33:43 GMT
Newsgroups: comp.lang.lisp
Message-ID: <3204466420985118@naggum.net>

* Kent M Pitman
> Admittedly, I was thinking of something that would only work 
> 99.9999999999% of the time, like 
>  (string-equal doc-string "http:/" :end1 (min (length doc-string) 6))

  There are a number of possible "schemes", or whatever they are called,
  besides "http", but the general syntax is still supposed to be preserved.
  It is almost like namestrings for pathnames, only far less intelligently
  done (regardless of what anyone might think of pathnames), due to the
  near-fatal case of standard-optionitis.

  I do _not_ propose that the URL should be (in) the documentation string.
  What I really wanted was a way to link the _real_ documentation to the
  symbol and documentation type through that function.  I think it would be
  ideal if that function launched the browser in a friendly way, and if it
  returned nil to the caller, that would not be a problem.

  Since documentation strings are routinely discarded by most CL systems,
  the best way to do this would be to use an interface that could take a
  package name, a symbol name, and the documentation type.  This would be a
  lot easier to implement on top of the generic function documentation than
  interfacing with magic values of the documentation string.

#:Erik
-- 
  There is nothing in this message that under normal circumstances should
  cause Barry Margolin to announce his moral superiority over others, but
  one never knows how he needs to behave to maintain his belief in it.