==================================================================================================================
==================================================================================================================
REQUIREMENTS:
    1. Windows XP, Windows Vista or Windows 7
    2. Microsoft Windows SDK.
    3. make.js WSH script (available at http://sourceforge.net in project mzwshscripts)
    4. Microsoft Windows Driver Kit (crt library)
    5. see library dependencies in __REQUIRED_LIBS__.txt

    
    
==================================================================================================================
==================================================================================================================
CONFIGURATION:
1. Place make.js WSH script somewhere on the path
2. Do following customization of provided make.js file:
   * set PSDK_PATH to proper Windows SDK home directory. For example:
         var PSDK_PATH = "D:\\SDK\\Microsoft SDKs\\Windows\\v7.1";
   * set WDK_PATH to proper Windows Driver Kit home directory (IF INSTALLED). For example:
         var WDK_PATH = "D:\\SDK\\WinDDK\\7600.16385.1";
   * set DEVEL_LIBS_PATH to directory which contains our development libraries (headers and binaries). For example:
         var DEVEL_LIBS_PATH = "D:\\SDK\\devel_libs";
   * set DEVEL_LIBS_PATH_INSTALL_DIR to directory into which there will be copied development version (headers and
     binaries) of libraries that we build. It's good idea te set the variable to the DEVEL_LIBS_PATH directory.
     For example:
         var DEVEL_LIBS_PATH_INSTALL_DIR = DEVEL_LIBS_PATH;
   * set OUTPUT_DIR_BASE to directory which holds all builded output files (for the separation binaries and sources).
     For example:
         var OUTPUT_DIR_BASE = "D:\\compilation_output";
3. Make sure that *.js files are executed by %SystemRoot%\System32\cscript.exe by default:
   * open cmd console with admin privileges (runas /user:Administrator "cmd")
   * type in: assoc .js
     The result should be following output: .js=JSFile
     If not, type in: assoc .js=JSFile
   * type in: cscript /H:CScript
   * type in: ftype JSFile
     The result should be following output: JSFile=%SystemRoot%\System32\CScript.exe "%1" %*
     If not, type in: ftype JSFile=%SystemRoot%\System32\CScript.exe "%1" %*
   * type in: SET PATHEXT
     The result should be output containing extension .JS.
     If not press WindowsKey+Pause, switch to Advanced tab and click Environment Variables button. Environment
     Variables dialog box appears. Under section System Variables double-click PATHEXT item and add .JS extension
     after semicolon character. Press OK in all opened dialog boxes to apply changes.
   * Close console with admin privileges.
4. Try working of WSH scripts:
   * open cmd console
   * type in: make
     If file executes and display usage information then everything is OK.
     If file opens in text editor, then open windows explorer window and go to make.js location. Right click
     make.js and choose "Open With->Choose application..." menuitem. Open With dialog box appers. Click
     Browse button and go to C:\Windows\System32 directory. Select cscript.exe and press OK. In Open With dialog
     box make selected "Always use selected program for opening files of this type" checkbox. Press OK.
     again type in: make
     Now file should execute and display usage information.


     
==================================================================================================================
==================================================================================================================
COMPILATION:
   * type make for available compilation options and info about each of them
   * sample compilation command (it builds dll and static versions of library, each of debug and release kind
     and install it in the installation directory):
         make /debug /release /dll /static /install


    
==================================================================================================================
==================================================================================================================
TESTING LIBRARY:
   * make sure that all specified libraries are installed in DEVEL_LIBS_PATH:
        mzstd, mzstdwin32, mzstdmathext, mzstddatetime, mzstdshell, mzstdgraphics, mzstdgui, mzstdimaging, mzstdprint, mzstdxml, mzstdmemory, mzstddebug
   * make sure that resources package is installed in DEVEL_LIBS_PATH
   * open cmd console
   * go to directory with read/write access
   * type in: make /create app test
   * type in: cd test, to change directory to created application folder
   * type in: make /debug /dll
   * go to directory: OUTPUT_DIR_BASE\apps\test\debug\dll and run test.exe
