home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
i18nv102.zip
/
SAMPLE
/
INSTALL
/
READ.ME
< prev
Wrap
Text File
|
1995-08-28
|
11KB
|
247 lines
===============================================================================
Internationalization (I18N) For OS/2 March 31, 1995
===============================================================================
Copyright IBM Corporation -- 1993, 1995
DISCLAIMER: This I18N package has been made available solely to gauge OS/2
developer interest in the industry standard XPG4 internationalization
programming model. This does not mean that IBM will introduce a product based
on the contents of this package. This package is not a full implementation of
the X/Open XPG4 specification and does not make any claims of XPG4 branding.
It implements only the portions of the XPG4 specification which deal with
internationalization.
X/Open is a trademark of the X/Open Company Limited.
===============================================================================
/************************/
/*** Contents ***/
/************************/
1. Overview
2. Installation prerequisites
3. Optional parameters
4. Files in this directory
5. How to run the sample program
6. How to compile the sample program
1. Overview
============
This sample program demonstrates how to package and install the I18N files
required for the runtime environment and how to configure the CONFIG.SYS
information.
This program's high level functions include:
A. Determine if this version of the I18N package should be installed:
1) Install if the I18N runtime routines are not accessible on the
system.
2) Install if the diskette I18N runtime routines are the same or
more current than the system I18N runtime routines.
B. Determine the drive on which to install the I18N package. If the I18N
package is already installed, the default drive will be the drive on
which it is already installed. The program calling this install program
can specify a parameter to set the default drive. The user can select
any of the available drives on which to install this package.
C. Create all of the required I18N directories if they do not already
exist.
D. Install the I18N runtime code (setloc.dll) from the PKZIP2 diskette
file.
E. Install the I18N locale files (*.dll) from the PKZIP2 diskette file(s).
F. Determine whether CONFIG.SYS should be updated with the necessary
I18N information. If yes, allow the user to select the desired LANG
value to be used, create a backup of the CONFIG.SYS file, and add the
I18N values for LANG (using user's selection), LIBPATH, LOCPATH, and
NLSPATH (using installation path information).
This program uses a Presentation Manager environment to control the installation
of the I18N runtime environment. PM windows are presented to allow the user to:
A. Select the drive on which to install the I18N files.
B. See progress data as to which file is currently being installed.
C. Select whether CONFIG.SYS should be updated with I18N values.
D. Select the LANG variable value to be set in the CONFIG.SYS file.
E. Be notified of error conditions and take actions to those situations.
2. Installation prerequisites
==============================
This program assumes that PKUNZIP2 is available and that the installation is
occurring from one or two diskettes, which contain these files:
#1 INSTALL.EXE This program resides on the 1st diskette.
#1 I18NDLL.ZIP Contains the SETLOC.DLL file packaged using PKZIP2:
PKZIP2 -P I18NDLL.ZIP c:\i18n\dll\setloc.dll
#1 I18NLOC1.ZIP Contains all or a some of the I18N locale files packaged
using PKZIP2 (whatever will fit on the 1st diskette):
PKZIP2 -P I18NLOC1.ZIP c:\i18n\locale\*.dll
#2 I18NLOC2.ZIP Contains the rest of the I18N locale files which would not
fit on the 1st diskette in the I18NLOC1.ZIP file:
PKZIP2 -P I18NLOC2.ZIP c:\i18n\locale\*.dll
This program can be customized to install from whatever set of diskette files
your application has defined. There are several #DEFINE statements in the
INSTALL.C source which should be reviewed and modified as needed:
A. Do not add or remove any of the #DEFINE statements without modifying
the associated C statements referencing those values.
B. INSTALL_ZIP_NUM defines the number of PKZIP2 files which exist on
the diskette which contain the I18N files. This is used to determine
how many of the INSTALL_ZIPn values will be used. For example, to
define that there are three diskette files to be used:
#define INSTALL_ZIP_NUM 3
C. INSTALL_ZIPn defines the name of the "nth" diskette file.
INSTALL_ZIP1 must define the name of the diskette file containing the
I18N runtime code (setloc.dll). This name must contain the letters
"DLL". For example:
#define INSTALL_ZIP1 "\\I18NDLL.ZIP"
INSTALL_ZIP2 must define the name of the diskette file containing all
or the 1st part of the I18N locale files (*.dll). This name must
contain the letters "LOC". For example:
#define INSTALL_ZIP2 "\\I18NLOC1.ZIP"
INSTALL_ZIP3 and INSTALL_ZIP4 may be used to define the name of the
diskette file containing the rest of the I18N locale files (*.dll).
This name must contain the letters "LOC". For example:
#define INSTALL_ZIP3 "\\I18NLOC2.ZIP"
#define INSTALL_ZIP4 ""
D. Recompile INSTALL.C to incorporate your changes into your version of
the INSTALL.EXE program.
3. Optional parameters
=======================
This install program can be invoked directly from your application's install
program. When this is done, parameters are available to allow you to customize
the execution of this install program to fit into your install process.
When the program is invoked without any parameters, the following default values
are used:
1st parm: C (Default drive C:)
2nd parm: none (Do not force to a specific drive)
3rd parm: If LANG value is currently set, use its value as default.
Otherwise, use "enus437".
4th parm: Y (Show PM user interface)
5th parm: Y (Ask user if install drive is OK)
6th parm: A (Ask user if to update CONFIG.SYS)
The following optional parameters can be specified. The values are order
dependent. If you do not want to specify a specific value, use a
non-alphabetic character in that position (like a period ".").
1st parm: The default drive letter on which to install the I18N package if
the I18N runtime routines are not already accessible. This must
be an alphabetic letter, C-Z. If "A", "B" or non-alphabetic,
will use the default value.
2nd parm: The default drive letter on which to force the installation of
the I18N package, regardless of whether the package is already
installed. This could be used if you are installing the package
on a server drive and already have package installed on a local
drive. This must be an alphabetic letter, C-Z. If "A", "B" or
non-alphabetic, will use the default value specified by the
1st parameter.
3rd parm: The default LANG variable value to use when updating CONFIG.SYS.
The first letter must be alphabetic, else the default value
will be used.
4th parm: Whether the PM user interface is to be shown during processing.
If "N", do not show any PM windows, except if error conditions
are encountered.
If not "N", the normal PM interface is shown.
5th parm: Whether to ask the user to select the drive on which to install
the I18N package.
If "N", do not ask the user. Use the default value defined by
the 1st and 2nd parameters.
If "U", ask the user only when the I18N package has never
been installed before. If the I18N package exists, do not
ask the user.
If not "N" or "U", the user will be shown a PM window and
asked to select a drive.
6th parm: Whether to update the CONFIG.SYS file with I18N information
(LANG, PATH, LOCPATH, NLSPATH).
If "A", ask the user whether to update CONFIG.SYS.
If "Y", update CONFIG.SYS with I18N information.
If not "A" or "Y", CONFIG.SYS will not be updated.
4. Files in this directory
===========================
File Purpose
------------------------------------------------------------------------------
install.c Source code for the install sample program.
install.h Include file for the program.
install.rc Resource file for the program.
install.dlg Dialog definitions for all panels used by the program.
install.def Definition file needed for compiling the program.
install.mak Make file used to compile the sample.
install.exe Compiled version of the install sample.
build.cmd A command file which will compile and link the sample program.
read.me This file.
5. How to run the sample program
=================================
The following steps show how the program can be run.
1) Copy the install.exe program from this directory to a diskette.
copy install.exe a:
2) Use PKZIP2 to create a ZIP file containing the I18N runtime files.
PKZIP2 -P I18NDLL.ZIP c:\i18n\dll\setloc.dll
3) Copy the zipped I18N runtime file to a diskette.
copy I18NDLL.ZIP a:
4) Use PKZIP2 to create a ZIP file containing the I18N locale files.
PKZIP2 -P I18NLOC1.ZIP c:\i18n\locale\*.dll
5) Copy the zipped I18N locale file to a diskette.
copy I18NLOC1.ZIP a:
6) Execute the install.exe program from the diskette.
a:install
6. How to compile the sample program
=====================================
NOTE: The sample program is already compiled for you. If you want to see the
behavior of the program, you can just run it. The following instructions
are needed only if you want to modify the program and recompile it.
To compile the sample application:
1) Make sure that the CSET/2 compiler and OS/2 toolkit are installed
correctly on your system.
2) cd to the directory which contains the info source files.
3) Type "build" at the command prompt.