   -- [[http://www.gnu.org/software/emacs/tour/][Emacs]] for Surmulot --

Welcome to Surmulot !
This is version pre-12 (csound-x 2.19, muO 249)

[[info:surmulot:Top][Browse Surmulot documentation]] (using [[info:info:Top][Info]])


Expand the following items by pressing the TAB key on them (we are in [[info:org:Top][org-mode]]).
You can also [[elisp:(show-all)][show all]], [[elisp:(progn (org-overview) (org-content))][show inner headings]] or [[elisp:(org-overview)][hide all]].

* Demos 

** Csound compositions demos 

[[file:../csound/library/examples/Study%20for%20Computer%20(John%20Endicott).csd]["Study for computer" by John Endicott]]

[[file:../csound/library/CsoundRealtimeExamples/Convolution/pconvolve.csd][pconvolve opcode demo by Iain McCurdy]]

[[file:../csound/csd/mphrase%20example.csd::About][CSD composition with embedded MIDI]]

[[file:d:/devel/surmulot/csound/csd/microtonal%20guitar%20example.csd][CSD synthesizer with interactive composition]]

[[file:../csound/csd/envelope%20example.csd::About][CSD composition with graphical envelope editing]]

[[file:../csound/csd/wave%20example.csd::About][CSD composition with sound wave editing]]

[[file:../csound/csd/diagrams%20example.csd::About][CSD composition with orchestra diagrams]]

[[file:../csound/csd/OSC%20controls%20example.csd::About][CSD composition with OSC controls]]

[[info:csound-x:Csound%20Elisp][Csound Elisp example]]

[[file:../emacs/site-lisp/stef-elisp/csound-x/examples/Tobiah's%20orchestra.el][Csound Elisp more elaborate example]]


** Csound API & Clojure demo 

[[elisp:(progn (require 'csound-clj)(surmulot-start-clojure))][Start Clojure REPL]]

[[elisp:(progn (require 'csound-clj) (surmulot-slider-demo))][Slider demo]] ([[elisp:(find-file-other-frame "../clojure/SliderDemo.clj")][see Clojure code]])


* Documentation and settings 

Surmulot should work out of the box. 
Please get used to it before attempting to tweak its default settings...


** Csound-x documentation and settings 

[[info:csound-x:Top][Browse csound-x info pages]]

[[elisp:(customize-group 'spfa-paths)][Edit all paths]]

[[elisp:(csdoc-browse-html)][See Csound manual]]

[[elisp:(csound-z)][See Csound opcodes list]]


** MuO 

[[elisp:(squeak-eval "Morph fromLocalFileName: 'muo books\\DocBook entry points.morph'")][Browse MuO documentation]]

[[elisp:(squeak-eval "MuO ConfigurationManager openInWorld")][Configure MuO]]
... don't forget to save the image if you make any change.


** TiMidity++ configuration 

[[elisp:(find-file-other-frame (surmulot-timidity-cfg))][Edit configuration file]]

[[elisp:(browse-url-of-file (surmulot-timidity-man))][See Timidity man page (local)]]


** Keykit 

Keykit is an optional component of Surmulot.
[[http://www.zogotounga.net/GM/eGM0.html][GeoMaestro]] implemented in KeyKit has been superceded by [[http://www.zogotounga.net/comp/squeak/sqgeo.htm][muO]], implemented 
in Squeak.

For legal reasons, Keykit is not part of the Surmulot distribution.
If you wish to install it, please do as follows:
1) get key74d.exe (or a possibly newer version, untested) 
from [[http://nosuch.com/keykit/]]
2) run the installer, targetting directory surmulot/keykit 

[[elisp:(browse-url-of-file (surmulot-keykit-man))][See Keykit man page (local)]]


* Undocumented snippets 

(muo-get "'a,b,c' kmusic asBox")

(squeak-eval "EnvelopeEditor browseHierarchy")


* Advanced Emacs & Emacs Lisp

See right here...
... [[info:emacs:Top][The Emacs manual]]
... [[info:eintr:Top][Introdution to Programming in Emacs Lisp]]
... [[info:elisp:Top][The Emacs Lisp Reference Manual]]
... [[info:cl:Top][The CL extensions manual]]

See on-line...
... an [[http://www-d0.fnal.gov/d0unix/archive/emacs_ref.html][Emacs commands reference card]]
... a very nice [[http://steve-yegge.blogspot.com/2008/01/emergency-elisp.html][Emacs Lisp primer]]
... an [[http://xahlee.org/emacs/elisp.html][Emacs Lisp tutorial]]


* About Squeak and Smalltalk

... many [[http://stephane.ducasse.free.fr/FreeBooks.html][free books]]
