ARCHIVE VIEWER LANGUAGE SUPPORT

Language support in Archive Viewer resides in two files:
  ARCV_xx.MSG  - User interface text    (compiled from ARCV_xx.MKM)
  ARCV_xx.HLP  - Help file              (compiled from ARCV_xx.IPF)
where 'xx' is the two-letter language code (see below).

By default, Archive Viewer automatically sets the language it uses by checking
the %LANG% environment variable for the current system language, and loading
the above files for that language if they exist.  (If files for that language
do not exist, the English files are used instead.)

You can force Archive Viewer to use a particular language by dragging a 
supported locale item from the Locale object under System Setup into the
Archive Viewer window.  Archive Viewer will then use that language in the
future.  (This is stored in the settings file ARCVIEW.INI, which resides in 
the same directory as OS2.INI, normally <bootdrive>\OS2.  You can revert to 
the automatic language selection behaviour by editing the file with REGEDIT2
or the equivalent, and deleting the key "Archive Viewer" -> "Locale".)


CONTENTS OF THIS PACKAGE

  EN/ARCV_EN.MKM    English-language source file for ARCV_EN.MSG
  EN/ARCV_EN.IPF    English-language source file for ARCV_EN.HLP
  OLD.ZIP           Contains out-of-date/incomplete translations for various
                    languages (from previous versions of Archive Viewer)
  NLV.TXT           This file

TRANSLATING ARCHIVE VIEWER

To translate the above files into your language, you need the English source
files ARCV_EN.MKM and ARCV_EN.IPF.  Rename them to ARCV_xx.MKM and ARCV_xx.IPF
respectively, where 'xx' is the two-letter abbreviation for your language.

The language abbreviation generally corresponds to the two-character ISO 
language codes used in OS/2 locale names, with the exception of those for
Simplified and Traditional Chinese (for which see the items marked '*' in the
list below).  Some of the more common language codes are:

  * CX       Chinese, Simplified (used in China - PRC)
  * TW       Chinese, Traditional (used in Taiwan and Hong Kong)
    NL       Dutch
    EN       English
    FR       French
    DE       German
    IT       Italian
    JA       Japanese
    KO       Korean
    PO       Portuguese
    RU       Russian
    ES       Spanish
    SV       Swedish

NOTE: The archive OLD.ZIP contains the translated files for a number of these
      languages that were used with older versions of the Archive Viewer.
      These files are out-of-date and/or incomplete with respect to the current
      version, but are useful as a starting point for translation.

Translate the files as needed into your language.  Both files use specific
structures, but this is the same for all languages, so you can generally focus
on simply translating the text itself.

ARCV_xx.MKM is an OS/2 message source file.  The syntax should be reasonably
self-explanatory; refer to the "Tools Reference" book included with the IBM
Developer's Toolkit for details.  

ARCV_xx.IPF is an IPF (IBM Information Presentation Facility (IPF) source
file.  This is a simple SGML-style markup language similar to HTML, albeit
with its own particular syntax rules.  Refer to the "IPF Programming Guide
and Reference" book included with the IBM Developer's Toolkit for details.  

Once you have translated the files, you can build them yourself if you have
the means to do so (see below); you are advised to do this if possible, in 
order to be able to verify that the translation works properly.

When finished, please send the translated files to the Archive Viewer developer
(via the email address listed at the end of this file).  Even if you have
built the compiled language files yourself, please send the translated source
files as well.


BUILDING THE LANGUAGE FILES

Building the files requires that you have the IBM Developer's Toolkit
installed (version 4.52 is recommended, although most versions should work).

ARCV_xx.MKM must be compiled using the IBM Make Message File Utility 
(MKMSGF.EXE).  The syntax (shown here for the English files) is:

   mkmsgf arcv_en.mkm arcv_en.msg

Additional parameters might be needed for compiling East Asian languages;
refer to the documentation for more information.


ARCV_xx.IPF must be compiled using the IBM IPF Compiler (IPFC.EXE).  The
syntax (shown here for English) is:

   ipfc arcv_en.ipf

Again, additional parameters might be needed for compiling East Asian 
languages; refer to the documentation for more information.


DEVELOPER CONTACT INFORMATION

Alex Taylor - alex (at) altsan (dot) org
http://www.altsan.org/