Uptools3---setting the environment settings

Each of the tools in the uptools3 distribution uses the library uplib. This library requires two environment settings which always have to be set:

UNIPEN_INCLUDE_PATH

Typically, a user working with UNIPEN files will have several directories in which his files are contained. Adding paths to these directories in the UNIPEN_INCLUDE_PATH environment variable will ensure, that uplib looks for files in these directories. For example, consider the following settings: 
     setenv UNIPEN_INCLUDE_PATH ". .INHERIT\
                                 ~/unipen/train_r01_v07/data\
                                 ~/unipen/train_r01_v07/include"

Two situations can occur in which uplib is searching for a file. The first is when a tool is started with a path to a UNIPEN file, say path1/file1.dat. The second is when in such a file a 

     .INCLUDE path2/file2.dat
statement is contained. For both situations, given the settings above, the following heuristic is used by uplib to search the file:
  1. try to open path/file.dat
  2. try to open ./path/file.dat
  3. try to open the file via the path-inheritance mechanism described below
  4. try to open ~/unipen/train_r01_v07/data/path/file.dat
  5. try to open ~/unipen/train_r01_v07/include/path/file.dat
  6. give an error message
The path-inheritance mechanism uses the path to the currently open file. For example, if a UNIPEN file dirpath/filename.dat is opened, the file dirpath/path/file.dat is tried.

UNIPEN_DEFINITION_FILE

Before any UNIPEN file is parsed, uplib requires a definition file (typically unipen.def). This file describes the data format of UNIPEN. By default, uplib tries to open the file in the current working directory. If no unipen.def can be found, the environment variable UNIPEN_DEFINITION_FILE is tried.
Back to the uptools3 homepage
Page last updated on Fri Mar 14 12:18:15 MET 1997
You are visitor

Generated by htmlize at Fri Nov 14 12:31:32 1997 Louis Vuurpijl