home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / bsd_srcs / usr.bin / lisp / lispnews / text0292.txt < prev    next >
Encoding:
Text File  |  1985-11-10  |  2.3 KB  |  45 lines
  1. Sorry to report that there really is no official documentation for the
  2. several Franz lisplib modules which implement a measure of compatibility
  3. with Zetalisp, the dialect running on MIT Lisp Machines (and, more or
  4. less, on Symbolics and LMI machines).  The Franz source code was adapted
  5. from the MIT Lisp machine code several years ago; there is still
  6. approximate compatibility, although new features and certain semantic
  7. subtleties have diverged.  Driven partially by natural evolution and
  8. partially by the standardization efforts of Common Lisp, Lisp Machine
  9. compatibility is something of a moving target.
  10.  
  11. But do not despair; there are two standardly available sources for
  12. documentation.  Reading them will give a very usable idea about the
  13. packages.  Unfortunately, a few unimplemented features and semantic
  14. differences will have to be discovered by experimentation or examination
  15. of the source code.  (What do you want for free? :-)
  16.  
  17. (1) If you have available a MIT Lisp Machine Manual, the sections on
  18. defstruct, flavors, format, hash, and loop output are still reasonable
  19. approximations of documentation for the Franz versions.  Incidentally,
  20. the `Blue' MIT Lisp Machine Manual circa 1981 corresponds most closely
  21. with the Franz inplementation, although a few more recent features have
  22. been retrofitted.  If available, Symbolics documentation is probably
  23. only very slightly less good -- the older, the better.
  24.  
  25. (2) For defstruct, hash, and format the Guy Steele <Common Lisp: The
  26. Language>, published by Digital Press (a branch of DEC), is usefully
  27. close to the existing Franz code.  Again, experimentation and
  28. examination of the source code will resolve the details.  Unfortunately,
  29. Flavors and the loop macro are not (yet) part of the Common Lisp
  30. specification, and may well be very different when they are.
  31.  
  32. Unofficially, there is another even better hope.  The MIT Athena project
  33. will be `releasing' these packages into their standard Franz system this
  34. in another month or two.  They are commencing a quick effort to edit
  35. Lisp Machine documentation into proper format for inclusion as
  36. appendixes in the Franz manual.  If at all possible, I will attempt to
  37. get the results publically distributed.  (Translation:  My assistance is
  38. essential to this documentation, so I am in position to insist they be
  39. `reasonable' about it...)  But no promises just yet.
  40.  
  41. Steve Haflich
  42. MIT
  43.  
  44.  
  45.