/*
 * $Id: How_to_Configure_and_Use.txt,v 1.5 2015/03/21 01:33:17 fyurisich Exp $
 */


English
--------------------------------------------------------------------------------

If OOHG package was installed in C:\OOHG, and MinGW is going to be used to
compile projects, there's no need to change the default configuration. Simply
add C:\OOHG to the system's PATH and use DOS commands "COMPILE prg_name" or
BUILDAPP prg_name" to build executable files. If you dont want to change
the PATH, use "C:\OOHG\COMPILE prg_name" or "C:\OOHG\BUILDAPP prg_name"
instead.

If you have more than one OOHG version installed in the same folder, yo must
specify which one has to be used. For that, use "COMPILE version prg_name" or
"BUILDAPP version prg_name". For more details execute this commans without
arguments or read their content.

If OOHG package was installed in another folder (e.g. D:\XYZ), you must set
the following environment variable, before using the compilation commands:

set HG_ROOT=D:\XYZ

By default OOHG package build with Harbour 3.0 uses the folder "LIB" to store
it's libraries. For OOHG package build with Harbour 3.2, "LIB\HB\WIN" is used.
To use a different folder (e.g. C:\OOHG\LIB\MYLIBS), set the following
environment variable, before using the compilation commands:

set LIB_GUI=LIB\MYLIBS

By default OOHG package uses a bundled version of Harbour to compile projects.
To use a different version of Harbour (e.g. installed in D:\MYHRB), set the
following environment variable, before using the compilation commands:

set HG_HRB=D:\MYHRB

If the new version stores it's libraries in a folder different than
"D:\MYHRB\LIB" (e.g. at D:\MYHRB\LIB\MYLIBS), set the following environment
variable, before using the compilation commands:

set LIB_HRB=D:\MYHRB\LIB\MYLIBS

If the new version stores it's binaries in a folder different than
"D:\MYHRB\BIN" (e.g. at D:\MYHRB\BIN\WIN\MINGW), set the following environment
variable, before using the compilation commands:

set BIN_HRB=D:\MYHRB\BIN\WIN\MINGW

By default OOHG package uses a bundled version of MinGW to compile projects.
To use a different version of MinGW (e.g. installed in D:\MYMINGW), set the
following environment variable, before using the compilation commands:

set HG_MINGW=D:\MYMINGW

To use Borland C++ 5.5 compiler instead of MinGW, edit C:\OOHG\COMPILE.BAT
and replace its content with:

   @echo off
   cls
   rem *** Set Paths ***
   if "%HG_ROOT%"=="" set HG_ROOT=c:\oohg
   rem *** Call Compiler Specific Batch File ***
   call %HG_ROOT%\compile_bcc.bat %1 %2 %3 %4 %5 %6 %7 %8 %9

If the compiler is not installed at C:\BORLAND\BCC55 (e.g. at D:\MYBCC),
set the following environment variable before using the compilation commands:

set HG_BCC=D:\MYBCC

To use Pelles C compiler instead of MinGW, edit C:\OOHG\COMPILE.BAT and
replace its content with:

   @echo off
   cls
   rem *** Set Paths ***
   if "%HG_ROOT%"=="" set HG_ROOT=c:\oohg
   rem *** Call Compiler Specific Batch File ***
   call %HG_ROOT%\compile_pc.bat %1 %2 %3 %4 %5 %6 %7 %8 %9

If the compiler is not installed at C:\PELLESC (e.g. at D:\PCC), set the
following environment variable before using the compilation commands:

set HG_PC=D:\PCC

To use Microsoft Visual Studio 9.0 compiler instead of MinGW, edit
C:\OOHG\COMPILE.BAT and replace its content with:

   @echo off
   cls
   rem *** Set Paths ***
   if "%HG_ROOT%"=="" set HG_ROOT=c:\oohg
   rem *** Call Compiler Specific Batch File ***
   call %HG_ROOT%\compile_vc.bat %1 %2 %3 %4 %5 %6 %7 %8 %9

If the compiler is not installed at
%PROGRAMFILES%\MICROSOFT VISUAL STUDIO 9.0\vc (e.g. at D:\VS9), set the
following environment variable before using the compilation commands:

set HG_VC=D:\VS9

To rebuild OOGH's libraries: switch to SOURCE folder and launch MAKELIB.BAT
(build is done using C compiler's tools) or BUILDLIB.BAT (build is done using
Harbour's HBMK2 tool).


Espaol
--------------------------------------------------------------------------------

Si el paquete OOHG se instala en C:\OOHG y MinGW va a ser utilizado para
compilar los proyectos, no hay necesidad de cambiar la configuracin por
defecto. Simplemente aada C:\OOHG al PATH del sistema y utilice los comandos
de DOS "COMPILE nombre_prg" o "BUILDAPP nombre_prg" para crear los archivos
ejecutables. Si no desea cambiar el PATH, utilice "C:\OOHG\COMPILE prg_name" o
"C:\OOHG\BUILDAPP prg_name" en su lugar.

Si tiene ms de una versin de OOHG instalada en la misma carpeta, deber
especificar cual desea usar. Para ello utilice "COMPILE versin nombre_prg" o
"BUILDAPP versin nombre_prg". Para ms detalles ejecute estos comandos sin
argumentos o lea su contenido.

Si el paquete OOHG se instal en otra carpeta (por ejemplo D:\XYZ), deber
setear la siguiente variable de ambiente, antes de usar los comandos de
compilacin:

set HG_ROOT=D:\XYZ

Por defecto, el paquete OOHG construido con Harbour 3.0 utiliza la carpeta
"LIB" para guardar sus libreras. Para el paquete OOHG construido con Harbour
3.2, se utiliza la carpeta "LIB\HB\WIN".
Para utilizar otra carpeta (por ej. C:\OOHG\LIB\MYLIBS), deber setear la
siguiente variable de ambiente, antes de usar los comandos de compilacin:

set LIB_GUI=LIB\MYLIBS

Por defecto el paquete OOHG utiliza la versin incluida de Harbour para
compilar los proyectos. Para utilizar una versin diferente (por ej. la
instalada en D:\MYHRB), deber setear la siguiente variable de ambiente,
antes de usar los comandos de compilacin:

set HG_HRB=D:\MYHRB

Si la nueva versin guarda sus libreras en una carpeta distinta a
"D:\MYHRB\LIB" (por ej. en D:\MYHRB\LIB\MYLIBS), deber setear la siguiente
variable de ambiente, antes de usar los comandos de compilacin:

set LIB_HRB=D:\MYHRB\LIB\MYLIBS

Si la nueva versin guarda sus binarios en una carpeta distinta a
"D:\MYHRB\BIN" (por ej. en D:\MYHRB\BIN\WIN\MINGW), deber setear la siguiente
variable de ambiente, antes de usar los comandos de compilacin:

set BIN_HRB=D:\MYHRB\BIN\WIN\MINGW

Por defecto, el paquete OOHG utiliza la versin incluida del compilador MinGW.
Para utilizar una versin diferente de MinGW (por ejemplo la instalada en
D:\MYMINGW), deber setear la siguiente variable de ambiente antes de usar los
comandos de compilacin:

set HG_MINGW=D:\MYMINGW



Para utilizar el compilador Borland C++ 5.5 en lugar de MinGW, edite
C:\OOHG\COMPILE.BAT y reemplace su contenido con:

   @echo off
   cls
   rem *** Set Paths ***
   if "%HG_ROOT%"=="" set HG_ROOT=c:\oohg
   rem *** Call Compiler Specific Batch File ***
   call %HG_ROOT%\compile_bcc.bat %1 %2 %3 %4 %5 %6 %7 %8 %9

Si el compilador no est instalado en C:\BORLAND\BCC55 (por ejemplo, est en
D:\MYBCC), deber setear la siguiente variable de ambiente antes de usar los
comandos de compilacin:

set HG_BCC=D:\MYBCC

Para utilizar el compilador Pelles C en lugar de MinGW, edite
C:\OOHG\COMPILE.BAT y reemplace su contenido con:

   @echo off
   cls
   rem *** Set Paths ***
   if "%HG_ROOT%"=="" set HG_ROOT=c:\oohg
   rem *** Call Compiler Specific Batch File ***
   call %HG_ROOT%\compile_pc.bat %1 %2 %3 %4 %5 %6 %7 %8 %9

Si el compilador no est instalado en C:\PELLESC (por ejemplo, est en D:\PCC),
deber setear la siguiente variable de ambiente antes de usar los comandos de
compilacin:

set HG_PC=D:\PCC

Para utilizar el compilador Microsoft Visual Studio 9.0 en lugar de MinGW,
edite C:\OOHG\COMPILE.BAT y reemplace su contenido con:

   @echo off
   cls
   rem *** Set Paths ***
   if "%HG_ROOT%"=="" set HG_ROOT=c:\oohg
   rem *** Call Compiler Specific Batch File ***
   call %HG_ROOT%\compile_vc.bat %1 %2 %3 %4 %5 %6 %7 %8 %9

Si el compilador no est instalado en
%PROGRAM FILES%\MICROSOFT VISUAL STUDIO 9.0\vc (por ejemplo, est en D:\VS9),
deber setear la siguiente variable de ambiente antes de usar los comandos de
compilacin:

set HG_VC=D:\VS9

Para reconstruir las libreras de OOHG: cambie a la carpeta SOURCE y ejecute
MAKELIB.BAT (la reconstruccin se realiza utilizando las herramientas del
compilador C) o BUILDLIB.BAT (la reconstruccin se realiza utilizando la
herramienta HBMK2 de Harbour).
