General Modularity Example Module Projects & Files Commands & Scripting
Windows Menus Charts Tables Buttons & tools
Trees and Taxa Characters & Models Documentation General Utilities
Commands Scripting Snapshots Macros Cloning windows
Also: User's guide to scripting language class MesquiteCommand interface Commandable
class CommandChecker class Snapshot class Puppeteer

Scripting

(updated August 2005)

A Mesquite script is a series of commands intended to command Commandable objects. A script can reside in a data file, in a macro, or be directly sent by the user to a module using the Send Script menu item in the Scripting submenu of the Window menu.

Scripts are executed with the aid of a Puppeteer object. For explanation and general syntax, see the user's guide to scripting. Some commands in the scripting language are universal and defined by the Puppeteer (see the Scripting Commands web page available from the Help menu while Mesquite is running). Most of the commands, however, are defined by modules and other commandable objects. The commands accepted by modules are listed in the web pages Mesquite composes for them, linked from the Scripting Commands web page.

To learn about scripting one of the best methods is to examine the scripts that Mesquite composes itself. It composes scripts on saving NEXUS files (see the Mesquite block in the NEXUS file), and in cloning windows. The script that would be used to clone a window can be seen by selecting Show Snapshot from the Scripting submenu of the Window menu.


© W. Maddison & D. Maddison 2005