OSE - Release Notes

Graham Dumpleton
Dumpleton Software Consulting Pty Limited
PO BOX 3150
Parramatta, 2124
N.S.W, Australia
email: grahamd@nms.otc.com.au

Table of Contents

User Setup
OSE - Release NotesUser Setup

User Setup

1 Executable Search Path

The OSE build environment is a collection of tools, designed to improve the productivity of software developers. The core components of the build environment are the make environment and documentation extraction tools. To be able to run any of the tools, they must appear in your path. In a typical installation, OSE is installed under the root directory,

  /usr/local/ose
For example, OSE version 4.0 would be installed in the directory,

  /usr/local/ose/4.0
and as a result you should include the directory,

  /usr/local/ose/4.0/bin
in your path. If you are using a Bourne shell, to add the OSE bin directory to your path, you would include the following in your login file:

  PATH="/usr/local/ose/4.0/bin:$PATH"
export PATH
If you are using a C shell, you should use the following:

  set path = ( /usr/local/ose/4.0/bin $path )
The scripts in this directory are generic and will work for whatever host architecture you are actually on. Where binaries must be run by these scripts, you must indicate the host architecture you are using by setting the OSE_HOST environment variable. For example:

  OSE_HOST=SPARC_SUN4
export OSE_HOST
You should check with your OSE administrator as to what you should set this variable to at your own site. Alternatively, you can run the `ose-info' program from the OSE bin directory given above. This program will also give you an indication as to the C++ compilers for which OSE has been installed.

2 Manual Pages

To access the OSE manual pages, you need to list the manual page directory in your MANPATH environment variable. For OSE version 4.0, the name of the manual page directory would be:

  /usr/local/ose/4.0/man
Alternatively, you can run the `ose-man' program from the OSE bin directory.

3 Root Directory

If OSE is moved to a location other than where it was initially installed, you must define an environment variable giving the root directory of where all versions of OSE have been moved to. The name of the environment variable is OSE_ROOT. The value of the environment variable will be used in conjunction with the release name encoded into the programs, to locate any auxilliary files required. For example, if you were using OSE version 4.0, and it was moved to the directory:

  /pkg/ose/4.0
after originally being installed in some other location, you should set the OSE_ROOT environment variable to:

  /pkg/ose
The OSE_ROOT variable should not include the name of any specific version. If a version of OSE is moved, the last component of the pathname should still be `ose'.

You should check with the administrator for OSE at your site as to the precise location of OSE on your system, and whether it is necessary to set the OSE_ROOT environment variable.