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

* Marcin Tustin
> Actually, how powerful is the document string feature? (I'll go read about
> it later)? Has anyone found the need to build something more like javadoc
> (or Doxygen)? (I do mean javadoc, not api documentation).

  In this day and age with "web browsers" used for everything, I think it
  would have been a better idea than my hyperspec.el thing (which others
  have also done) to keep URLs in the documentation strings of standard
  symbols and of symbols exported from implementation-specific packages.
  The generic function documentation does not necessarily need to return a
  constant URL, but could build it from on-site or off-site base URLs,
  possibly even build it from the symbol name and documentation type.  The
  Lisp system would interact with the browser with the established remote
  control features, at least available in Netscape under Unix and Linux.

#: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.