• Brent Welch's Practical Programming in Tcl and Tk book is probably the best introductory reference. Be sure you get the latest edition.
• The Tcl Developer Xchange has a long list of web tutorials.
• The Tcl Developer Xchange also has the Tcl/Tk man pages on the web. This is a very handy bookmark to have around when you're programming.
  
  
• OTcl
  
  OTcl is used mainly by Mash and ns. It now has a home on SourceForge.
  
  
  • The OTcl Manual from the original release is still the best reference. You don't have to read the whole thing. Reading the OTcl Tutorial is good enough.
    
    
• TclCL
  
  TclCL is used mainly by Mash and ns. It now has a home on SourceForge.
  
  
  • We have started writing a brief TclCL tutorial. It is in the tutorials/tclcl directory. It isn't finished yet, but it should be helpful.
  • You can also read the Interface to the Interpreter chapter of the ns Manual, but this may be somewhat painful. When they say "OTcl Linkage", they really mean TclCL most of the time.
    
    
• C++
  
  You're kidding me. Doesn't everyone know C++?
  
  
  • The standard reference is Bjarne Stroustrup's The C++ Programming Language. You don't need the hardcover. The latest printing of the softcover is the same thing and it's cheaper.

Learning Mash

• Larry Rowe's The Mash Programming Environment talk is a good introduction to Mash programming.
• The FILES file in mash-1 has brief descriptions of most major directories.

Several tools are useful for debugging Open Mash applications:

• mash/smash - mash is a Tcl/Tk wish with the core mash libraries already loaded. smash is a tclsh with the mash libraries if you do not need a GUI interface. You can enter and debug scripts interactively using either of these tools. The import command can be used to lookup and load Tcl procedures and Otcl classes.
• MashInspector - this class provides a GUI interface for examining Otcl class definitions and instances. Just import the class into your mash shell and execute the command
  

  % new MashInspector

  to create an inspector. More information is available on the Mash Inspector documentation page.

A series of notes have been published that describe how to use and develop using Open Mash. The Notes Index page shows the currently available notes. These notes are often constructed from email messages and scribbles used to teach folks around Berkeley how to use the system. Skim these notes as they might include something useful when you are getting started. You should also skim/search through the on-line message archive available on the Mailing List webpage.

In addition, we are always looking for new notes to add to the collection.