[Hwgui-developers] HwGUI tutorial

[Alexander S.K. <al...@be...>]

Hello,

  New utility, HwGUI tutorial has been added as hwgui/utils/tutorial. 
Two  bat files, for bcc55 and mingw are included. They create two exe's 
- hwgrun.exe and the tutorial - tutor.exe.

      It is interactive - because you can not only read the code and 
comments, but execute it. Moreover, you can edit the code and then 
execute it immedeately to see the results of your changes.
      The tutorial is very simple to navigate, it has minimum of tools. 
Just click on a tree node to see appropriate content is a text editor. 
If this is a code fragment, double clicking on this tree node or 
clicking on a button, which is in a right top corner of a window above 
the editor will execute this code.

      There is a configuration file, tutor.xml, which, possible, you 
will need to tune.
      It contains a tag with a path to HwGUI directory:

      <hwgui_dir path="..\.." />

      This path is needed for internal compiler to find the HwGUI 
include/ directory with header file hwgui.ch, if the path is wrong, you 
will get a message "compile error", when you will try to execute a code. 
By default it is set to "..\.." due to the default location of this 
program ( hwgui\utils\tutorial ). If you for some reason decide to 
change this location, you will need to change this path.
      Yet another tag, which you, probably, may want to change is:

      <tutorial file="tutor_eng.xml" />

      This is a name of a file with tutorial content. The default file 
above "tutor_eng.xml" is an English language version. If there is some 
other with a language of your choice, edit that tag.

   There is some content already, we need to add new code and comments 
to make it really full.

   For Harbour there is no need to have even the harbour.exe to compile 
and execute code, becouse Harbour have internal compiler library. As 
far, as I know, xHarbour hasn't, so I've added some code specially for 
xHarbour to compile code fragments with harbour.exe, to force it to work 
you need to set the <harbour_bin> tag in tutor.xml.

Regards, Alexander.