****************
GIDE 1.0 build 2
****************


----------------
Introduction
----------------
The GIde program has been gatherd up to allow a faster development of an automated CMN-to-Guido converting 
algorithm written for a music education project I'm currently working on. Thus my personal use of the program 
is very simple: I write the basic score using the integrated CMN Score Editor then, pressing [F2], I tell 
GIde 1to generate a version of the Guido code for the score. The[F4] key sends the code to the built-in 
Guido Parser(0.61 version) for syntax checking. If there are errors they are displayed in the error list. 
The list can be clicked to quickly position the editor at the wrong line and character. I then press [F5] to 
load the code in the NoteViewer and display the resulting score.
Of course the code editor can be used as a completely independent tool or to refine the output of the 
CMN score. Only be aware that by pressing [F2] again the code will be regenerated and all manual changes 
lost (apart for a set of options such as Title, Composer stave distances and some bells and whistles 
which are saved to the project file). 
The CMN score along with the Guido code and other settings can be saved to a project file (.gip). 
ALternatively the CMN score and/or the Guido code can be exported separately.

---------------------
The CMN Score Editor
---------------------
The score engine is in a mid-stage of development. Anyway it will only have the features strictly 
related with the main project goals. Particularly, there is no support for tuplets and chords (and never 
there will be). The use of the score toolbar is rather straightforward. Clicking the score with the right 
mouse button will popup a menu with a set of functions for bars, staves, voices, time and key signatures. 
The "Staff settings" dialog allows changing of clef, staff range and instrument name. Every staff (can be 
added or inserted at your convenience) can handle up to 4 voices identified by colors (change using 
Options->Project options). Beaming and stemming are automatic. Text and/or lyrics can be inserted by 
shift-clicking an event or a bar. The string will be positioned respectively at the bottom or at the 
top of the staff. By pressing [F2], the whole score will be converted to Guido. Alternatively, a single 
bar, or inside it a single voice, can be placed in the editor at the current cursor position (Guido->Insert 
Guido code for...).

---------------------
The Guido code editor
---------------------
Not very much to say. Its a full-featured syntax editor (now using code of the SynEdit project), 
including Auto-Completion [Ctrl + Space]. The code can also be copied and exported as .html. I have no 
time to embellish the program with the usual menus and icons but all common keystrokes work. You can also 
put marks for the Guido \staff and \bar tags to quickly see your way clear inside the code 
(Guido->Add Bookmark for...).
The supported set of Guido tags can be easily updated (Guido->Edit Guido Tags...)
Selecting a tag in the Editor and pressing [F1] will show a help window with the available infos about 
the tag itself. GIde scans the html file searching for a bookmark matching the text string selected in the 
editor. Furthermore it fills the clickable list at the left side of the help window with all the available 
file bookmarks. The direct consequence is that the help file (GuidoHelp.htm) can be easily customized by 
the user (of course with an html editor) simply by adding or editing the various topics and by defining 
bookmarks for the new ones. 

A.F. 22.21 25/11/03