Installing HFL

Copying the HFL files

The first step is to copy the HFL files into the directory where you wish them to permanently reside. We will refer to this as the 'install directory'.
You may place your files wherever you wish.
For the purposes of the examples in this file, we will assume that the HFL files were copied into folder 'C:\Common\HFL'. So when reading the instructions, just substitute your actual location for 'C:\Common\HFL'.

Running the setup program

There are two ways that HFL can be installed.
- Install Option 1: You can add the install directory to your path.
- Install Option 2: You can copy the .bat files to another location, and add that directory to your path. This option would be used when you already have a main batch file directory, and do not wish to increase the size of you PATH environment variable.
To install HFL, it is necessary to execute the installation script in a command window that is in 'as Administrator' mode.
1. In Windows Explorer, open the subfolder 'setup' within the HFL folder, then right-click on the file 'setup.bat'.
2. Choose 'Run as administrator' from the right-click menu. This will launch the HFL installer program.
3. You will first be asked where to install the HFL batch files. For example:
  - --------------------------------------------
    HFL INSTALLER VER 1.0
    --------------------------------------------
    INSTALLING HFL INTO DIR |C:\Common\HFL|
    
    INSTALL HFL BATCH FILES IN |C:\Common\HFL| [y]?
  - If you respond with 'y', it will add the install directory to your path.
  - If you respond with 'n', you will be prompted for where to place the batch files that invoke the compiler. For example:
  - INSTALL HFL BATCH FILES IN |C:\Common\HFL| [y]? n
    ENTER BATCH FILE LOCATION
    ? C:\Shared\batch
4. You will then be asked if you wish to add the HFL path to the system 'PATH' environment variable:
  - ADD |C:\Common\HFL| TO PATH? [n] y
  - If you are installing using the second option, and that directory is already in you path, you may skip this step by answering 'n'.
  - If you answer 'y', the batch file location that you selected (either the install directory or the batch file directory) will be added to your path.
5. Finally, you will be asked to confirm that you wish to update your system. If you answer 'y' to this, the changes will be applied. If the first installation option was chosen, it will add the HFL install directory to your path. If the second option was chosen, it will copy the batch files to the directory that you named, and add that directory to your path if you requested it.
  - --------------------------------------------
    WILL INSTALL HFL BATCH FILES IN DIRECTORY
    |C:\Common\HFL|
    --------------------------------------------
    
    OK TO UPDATE SYSTEM (y/n) [n]? y
    
    INSTALL COMPLETE
    Press any key to continue . . .
6. Hit the 'Enter' key to close 'setup.bat'

Previous: HFL Language Differences Next: Compiling HFL Files

	Installing HFL
	Introduction Introduction Background Why A New Language? HFL Transformations HFL Formats HFL Language Differences Getting Started Install HFL Compiling HFL Files The HFL Preprocessor Parse mode Tutorial Index Of Commands Concepts Basic Concepts Cells Scopes Clip Pools Modal Scopes Pseudo-Variables Temporary Classes Advanced Concepts The Evaluator Aligning Content Scope-lists Scopes And Features HFL Scopes Defining Scopes Variables Cell Properties Flow Control And Functions Advanced Scopes Built-in Scopes Objects Code Generators Generating Javascript Code Built-in Functions Input/Output Functions String Functions Array Functions Hash Functions Filename Functions Object Functions Logging Functions Other HFL Functions Debugging The HFL Debugger Debugger Inspector Commands Cell Inspector Commands Other Inspector Commands FAQ Formats Using HFL Formats Creating HFL Formats The Goal of HFL Formats Minimizing Required Markup Format Organization

	Installing HFL Copying the HFL files The first step is to copy the HFL files into the directory where you wish them to permanently reside. We will refer to this as the 'install directory'. You may place your files wherever you wish. For the purposes of the examples in this file, we will assume that the HFL files were copied into folder 'C:\Common\HFL'. So when reading the instructions, just substitute your actual location for 'C:\Common\HFL'. Running the setup program There are two ways that HFL can be installed. Install Option 1: You can add the install directory to your path. Install Option 2: You can copy the .bat files to another location, and add that directory to your path. This option would be used when you already have a main batch file directory, and do not wish to increase the size of you PATH environment variable. To install HFL, it is necessary to execute the installation script in a command window that is in 'as Administrator' mode. In Windows Explorer, open the subfolder 'setup' within the HFL folder, then right-click on the file 'setup.bat'. Choose 'Run as administrator' from the right-click menu. This will launch the HFL installer program. You will first be asked where to install the HFL batch files. For example: -------------------------------------------- HFL INSTALLER VER 1.0 -------------------------------------------- INSTALLING HFL INTO DIR \|C:\Common\HFL\| INSTALL HFL BATCH FILES IN \|C:\Common\HFL\| [y]? If you respond with 'y', it will add the install directory to your path. If you respond with 'n', you will be prompted for where to place the batch files that invoke the compiler. For example: INSTALL HFL BATCH FILES IN \|C:\Common\HFL\| [y]? n ENTER BATCH FILE LOCATION ? C:\Shared\batch You will then be asked if you wish to add the HFL path to the system 'PATH' environment variable: ADD \|C:\Common\HFL\| TO PATH? [n] y If you are installing using the second option, and that directory is already in you path, you may skip this step by answering 'n'. If you answer 'y', the batch file location that you selected (either the install directory or the batch file directory) will be added to your path. Finally, you will be asked to confirm that you wish to update your system. If you answer 'y' to this, the changes will be applied. If the first installation option was chosen, it will add the HFL install directory to your path. If the second option was chosen, it will copy the batch files to the directory that you named, and add that directory to your path if you requested it. -------------------------------------------- WILL INSTALL HFL BATCH FILES IN DIRECTORY \|C:\Common\HFL\| -------------------------------------------- OK TO UPDATE SYSTEM (y/n) [n]? y INSTALL COMPLETE Press any key to continue . . . Hit the 'Enter' key to close 'setup.bat' Previous: HFL Language Differences Next: Compiling HFL Files