&Ben.Boeckel; &Ben.Boeckel.mail; 2009-08-03 &sigmodr; Basics Starting &sigmodr; Since &sigmodr; is the official editor for &sigmod; files, it is the default application for opening &sigmod; files with if installed. Precedence with other applications can be changed using the File Associations settings (found in System Settings). By default, &sigmodr; can be started in any of the following ways: Opening a &sigmod; file Choosing &sigmodr; from the menus From a launcher (i.e., KRunner or Katapault) User interface This section describes the user interface of &sigmodr; and how to open and edit the data structures within &sigmodr;. The Main Window When &sigmodr; is started, the main window is displayed: &sigmodr; main window &sigmodr; main window The main window works best when tall and narrow since the tree and the editing widgets are both oriented this way. The window consists of the &sigmod; tree and the editor panel. The &sigmod; Tree The &sigmod; tree is a tree structure with all of the data elements represented within it. It is on the left of the main window. It has descriptions as the main part of the tree items. If an item is surrounded by ‘«’ and ‘»’, it means that the data used to describe the item is not set. On the right side, there are three icons. The first icon is shown if the item can be edited, the second icon is shown if the item can be deleted, and finally the third icon is shown if an item can be added to it (as a child). Here is a screenshot of the tree with a few &sigmod;s open and some items expanded: &sigmod; tree image &sigmod; tree with a few open &sigmod;s The Editor Panel The editing panel is where the widgets used to edit a data structure are shown. The Apply button will save the information to the &sigmod; in memory. In order to save the &sigmod; to disk, use the Save or Save As... entries in the File menu. The Discard button will undo changes since the last Apply. The Validate button will check the data structure (and all children) for errors and warnings. See the validation page for more information. Here is an example of a data structure being edited: Editor panel image Editor panel editing a data structure For more specific information on each data structure's editing, please see the appropriate chapter.