Subject: Re: So, where's the "Javadoc" for COMMON Lisp?
From: Erik Naggum <erik@naggum.net>
Date: Fri, 20 Jul 2001 21:55:41 GMT
Newsgroups: comp.lang.lisp
Message-ID: <3204654939180446@naggum.net>

* Kent M Pitman <pitman@world.std.com>
> Doing it with a tuple mapping has the advantage, too, that you can make
> different documentation for the selfsame (i.e., eq) symbol based on which
> package it's exported from, since even though its actual implementation
> and function might not vary, its "intentional" use might in some cases.

  But how would you know which package that would be?  Packages being a
  reader concept, it is quite hard to figure out which package you mean
  after the fact, other than the symbol's home package.  So although I
  appreciate the idea, I am not sure how you think it could be implemented.
  I thought one would take the package from (symbol-package symbol) and
  the symbol name from (symbol-name symbol), since the generic function
  documentation does not receive the package separately from the symbol.

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