Using MySQLTutor
-------------

The main menu in MySQLTutor can be found by clicking the "Files" button.
From there youll see the choices "About", "Help", "Lesson Selection", 
and "Quit".  Select one of these depending on what you want to do.

About:
  Tells you a bit about MySQLTutor, the author, and the contributors.

Help:
  What you are reading now.

Lesson Selection:
  As of now you must select the first lesson through this menu.  Any 
subsequent lessons can be selected using the "Previous Lesson" and 
"Next Lesson" buttons.

Quit:
  Quit MySQLTutor



The next two buttons are "Previous Lesson" and "Next Lesson".

Previous Lesson:
  Moves back to the previous lesson unless, of course, you are on 
Lesson 1, then it does nothing.

Next Lesson:
  Jumps to the next lesson in the lessons list.  A message will tell you if
you try to use it and you are on the last lesson in the list.  See below for
information about creating and installing new lessons.


The last button is "Run Example"

Run Example:
  This will run the example code in the middle window and put the results in
the bottom window.  There can only be one query at a time uncommented 
(comments are made with the # charactar).  There will often be multiple 
examples so if you feel you don't understand after the first one, you can 
comment or delete it and uncomment another one.  The example window 
is an input field meaning you can change things around and experiment all 
you  want.  All error messages are also written to the bottom window.  
Feel free to experiment and learn.  That's what its there for!



Installing New Lessons
---------------

  To install new lessons simply put the *.les and *.exp files in 
MySQLTutor's "/lesson" directory and add the lesson to the bottom of the 
list in the file named "lessons" in the MySQLTutor "/lesson" directory.  
It is not necessary to restart MySQLTutor, but you must reload the lesson
by choosing "Files", "Lesson Selection".  Now all entries will be loaded.



Creating Lessons
------------

  To create lessons for MySQLTutor you just need two text files in the 
following format.  The first file, named *.les will contain the lesson on 
the subject matter.  This can be put in any means you feel to get the point
across briefly.  The second file, named *.exp, will contain the example 
code for the lesson.  Please comment out all but one query as you can not 
pass two at a time using the MySQL C API.  If you feel your lesson is 
worthy, email it to sbarron@n-link.com and I will put it on the 
MySQLTutor home page for all to download.  To be informed when new 
lessons are posted send mail to me (sbarron@n-link.com) with the subject 
"MySQLTutor Lesson notification" or something similar to that.
