home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / music / cmn.README < prev    next >
Encoding:
Text File  |  1993-04-03  |  6.9 KB  |  241 lines
  1.     C O M M O N    M U S I C    N O T A T I O N
  2.  
  3. This directory contains the cmn source and documentation.  cmn is
  4. built on Common Lisp, CLOS (pcl), PostScript, and the Adobe Sonata
  5. font.  In this version, I've put everything in the cmn package.
  6. Please send bug reports and suggestions to bil@ccrma.stanford.edu.
  7. You can substitute the Petrucci-Medium font for the Sonata font,
  8. but it is not as good a font.
  9.  
  10. There's a mailing list for CMN news: cmdist@ccrma.stanford.edu.
  11. To get your address added to or removed from this list, send
  12. the request to cmdist-request@ccrma.stanford.edu.  (Common Music
  13. and CLM use this same mailing list).
  14.  
  15.  
  16.  
  17. This software is available to anyone who is interested, free gratis
  18. for nothing, without warranties of any kind.
  19.  
  20.  
  21. Documentation is in cmn.wn (or cmn.rtfd).
  22.  
  23.  
  24. The examples are:
  25.  
  26.   carl.cmn     from "Archibald Douglas" by Karl Loewe
  27.   franz.cmn    from a piano trio by Schubert
  28.   fred.cmn     from a piano concerto by Chopin
  29.   fux.cmn      part of a paper on automatic counterpoint
  30.   gus.cmn      opening of last mvt of Mahler's 3rd
  31.   henry.cmn    opening of "Thoreau" mvt of Ives' "Concord Sonata"
  32.   joh.cmn      from Brahms' "A German Requiem"
  33.   mir.cmn      from "Mir ist so wunderbar" in Beethoven's "Fidelio"
  34.   moz.cmn      opening of a piano sonata by Mozart
  35.   cmn-ex.lisp  some cmn code to do various useful things
  36.   cmnt.lisp    the examples in cmn.wn
  37.   duke.cmn     Archduke Trio excerpt
  38.  
  39.   wedge.lisp   code to make wedged beams like Bartok used for the bouncing ball rhythm
  40.   pedal.lisp   code to display all three piano pedals 
  41.   accent.lisp  various 20th century articulation marks
  42.   percussion.lisp random symbols said to be useful in percussion scores
  43.  
  44.  
  45.  
  46. The following describes how to get cmn going on:
  47.   
  48.   A NeXT with Allegro CL 3.1.20 and PCL, or Allegro CL 4.1
  49.   An SGI Indigo with Allegro CL 4.1
  50.   A NeXT with KCL (version 615 or later) and PCL (March 92 or later)
  51.   A Mac II (system 7) with MCL 2.0
  52.  
  53.   or any computer with Common Lisp.
  54.  
  55.  
  56.  
  57. -------------------------
  58. In Franz Allegro CL, in a shell or terminal, type
  59.  
  60.   NeXT:
  61.          cc nxtcmn.c -c -O
  62.   Indigo:
  63.          cc nxtcmn.c -c -G 0
  64.  
  65. and (if necessary) fix the pathname pointing to this .o file in
  66. cmn0.lisp -- it's at the start of the file in the line 
  67.  
  68.  (load (merge-pathnames "nxtcmn.o" excl::*source-pathname*) ...)
  69.  
  70.  
  71. pcl and cmn assume you're running a case-insensitive lisp (I use
  72. case-insensitive-upper in ACL).  Except in ACL 4.1, if loop has 
  73. not been compiled,
  74.   
  75.   :cl loop
  76.  
  77.  
  78. If not in ACL 4.1,get CLOS going, (CLOS is available free at
  79. the anonymous ftp site parcftp.xerox.com as /pub/pcl/tarfile-rev-4b or
  80. something like that -- at ccrma-ftp, pub/pcl.tar.Z is the same file).
  81. To get PCL compiled:
  82.  
  83.   :cl defsys.lisp
  84.   (pcl::compile-pcl)
  85.  
  86. Thereafter, you load it with:
  87.  
  88.   :ld defsys
  89.   (pcl::load-pcl)
  90.  
  91. Once CLOS or PCL is loaded,
  92.  
  93.   (pushnew :Petrucci-Medium *features*)
  94.    or
  95.   (pushnew :Sonata *features*)
  96.  
  97. and if you're running NeXT 3.0,
  98.  
  99.   (pushnew :Next-3.0 *features*)
  100.  
  101. then,
  102.  
  103. if you're running ACL 4.1, (load "nxtcmn.o")
  104.  
  105. and
  106.  
  107.   :cl cmn0
  108.   :cl cmn1
  109.   :cl cmn2
  110.   :cl cmn3
  111.   :cl cmn4
  112.   :pa cmn
  113.  
  114. It takes a long time (ca 30 minutes) to compile, load, and run cmn the
  115. first time, but after that it seems to be ok.  The files buildcmn and
  116. build.lisp do all this for you and save the resultant lisp image.
  117.  
  118. If not in ACL 4.1, you need pcl from May-90 or later -- the "Victoria
  119. Day" version does not work, but the "May Day" version does (cmn
  120. expects defgeneric to be more than just a documentation no-op).
  121.  
  122.  
  123. There is a rudimentary previewer/editor in nps.lisp,cmned.lisp and
  124. nps.c.  To try it out, cc nps.c -c and load nps into cmn.  This is
  125. only for good sports.  I stopped work on this mouse-driven editor
  126. because the connection from lisp to the Display Postscript system on
  127. the Next was too primitive.  I'm staring at various versions of X
  128. windows and CLX currently, and may take that route.
  129.  
  130. If you have ACL that worked on NeXT 2.1, and want it to run on NeXT 3.0,
  131. see the file ACL3.1-on-NeXT3.0.
  132.  
  133.  
  134.  
  135. -------------------------
  136. In akcl (available free at sonata.cc.purdue.edu as
  137. pub/next/2.0-release/binary/AKCL-1-586.bin.tar.Z, or at
  138. rascal.ics.utexas.edu (128.83.138.20) as: pub/NeXT-akcl-1-605.tar.Z,
  139. pub/kcl.tar.Z, and pub/akcl-1-605.tar.Z):
  140.  
  141. First get the latest pcl (the one mentioned above -- earlier versions
  142. don't compile), and in defsys.lisp (in the pcl directory) change the
  143. file extensions in the table *pathname-extensions* (I change the KCL
  144. line to "lisp" and "o").  You also need the loop facility -- it's
  145. included in the cmn release just in case you don't have it.  Also,
  146. you have to increase kcl's process size: before making kcl, change
  147. BIG_HEAP_SIZE in kcl/akcl/h/NeXT.h to #x2000000, then run add-defs
  148. and so on).
  149.  
  150. Fire up kcl in the pcl directory, and:
  151.  
  152.   (compile-file "defsys.lisp")
  153.   (load "defsys.o")
  154.   (pcl::compile-pcl)
  155.  
  156. Now exit kcl, change to the cmn directory, restart kcl, and:
  157.  
  158.   (system:allocate 'SYMBOL 400)
  159.   (system:allocate 'CONS 4000)
  160.  
  161.   (compile-file "loop.lisp")
  162.   (load "loop.o")
  163.  
  164.   (load "<pcl-directory>/defsys.o")
  165.   (pcl::load-pcl)
  166.  
  167.   (setf pcl::*defmethod-times* '(compile load eval))
  168.   (setf pcl::*defclass-times* '(compile load eval))
  169.   (setf pcl::*defgeneric-times* '(compile load eval))
  170.  
  171. then, 
  172.  
  173.   (pushnew :Petrucci-Medium *features*)
  174.    or
  175.   (pushnew :Sonata *features*)
  176.  
  177. and,
  178.  
  179.   (compile-file "cmn0.lisp")
  180.   (compile-file "cmn1.lisp")
  181.   (compile-file "cmn2.lisp")
  182.   (compile-file "cmn3.lisp")
  183.   (compile-file "cmn4.lisp")
  184.  
  185. Now exit and restart Kcl, and:
  186.  
  187.   (system:allocate-contiguous-pages 1000)
  188.   (load "loop.o")
  189.   (load "<pcl-directory>/defsys.o")
  190.   (pcl::load-pcl)
  191.  
  192.   (load "cmn0.o")
  193.   (load "cmn1.o")
  194.   (load "cmn2.o")
  195.   (load "cmn3.o")
  196.   (load "cmn4.o")
  197.  
  198.   (in-package "CMN")
  199.  
  200. and you're ready to go.  You can save this image with the kcl function
  201. save.
  202.  
  203. This process takes a VERY long time (i.e. measured in hours).
  204.  
  205. I've noticed that the kcl version of cmn makes odd line/page break
  206. decisions -- I don't know why.
  207.  
  208.  
  209. On a NeXT 3.0 system, you have to make the following
  210. changes to the 615 kcl version:
  211.  
  212. In akcl/c/NeXTunixsave.c, the declaration:
  213.  
  214.   extern struct section *getsectbyname(char *, char *);
  215.  
  216. causes a fatal compiler error.  The new declaration
  217. (in /NextDeveloper/Headers/bsd/lib.h) is:
  218.  
  219.   extern const struct section *getsectbyname(
  220.      const char *segname, 
  221.      const char *sectname);
  222.  
  223.  
  224. Also, the library /usr/lib/libg.a is not included in the 3.0 release,
  225. so remove the -lg switch from the LIBS statement in akcl/h/NeXT.defs.
  226. (Do this before running add-defs and making kcl).
  227.  
  228.  
  229.  
  230.  
  231. ------------------------- 
  232. In MCL on a Mac II, fix the pathname in mac-cmn.lisp to point to the
  233. directory that has the cmn sources, then load mac-cmn.  This process
  234. takes about a half hour.
  235.  
  236. In system 6.<something>, simple calls on the cmn function work fine
  237. (turning out Postscript code, of course), but larger examples (like
  238. moz.cmn) apparently run out of memory causing Lisp to die.  I'm told
  239. that gnu's ghostscript runs on the Mac.
  240.  
  241.