From ... Path: archiver1.google.com!newsfeed.google.com!newsfeed.stanford.edu!news.tele.dk!134.222.94.5!npeer.kpnqwest.net!nreader1.kpnqwest.net.POSTED!not-for-mail Newsgroups: comp.lang.lisp Subject: Re: So, where's the "Javadoc" for COMMON Lisp? References: <3B544F2D.2D2B5B99@rchland.vnet.ibm.com> <9j20j2$ifl$2@newsg1.svr.pol.co.uk> <3204451328338331@naggum.net> Mail-Copies-To: never From: Erik Naggum Message-ID: <3204466420985118@naggum.net> Organization: Naggum Software, Oslo, Norway Lines: 29 User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Wed, 18 Jul 2001 17:33:43 GMT X-Complaints-To: newsmaster@Norway.EU.net X-Trace: nreader1.kpnqwest.net 995477623 193.71.66.1 (Wed, 18 Jul 2001 19:33:43 MET DST) NNTP-Posting-Date: Wed, 18 Jul 2001 19:33:43 MET DST Xref: archiver1.google.com comp.lang.lisp:13317 * 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.