home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a010 / 1.ddi / NATION.DOC < prev    next >
Encoding:
Text File  |  1993-03-04  |  10.0 KB  |  227 lines
  1. ===========================================================================
  2.    CA-Clipper 5.2 International - Release Notes
  3.  
  4.    Copyright (c) 1993, Computer Associates International, Inc.
  5.    All rights reserved.
  6.  
  7.    This file contains important information to all European customers
  8.    needing national language support for their applications.
  9.  
  10.  
  11. ==========================================================================
  12. 1. Introduction
  13.  
  14.    The international release of CA-Clipper 5.2 provides runtime
  15.    national language support, allowing users to develop applications
  16.    for the European market.  Linking in the appropriate drivers will
  17.    provide you with language translations of runtime messages and
  18.    country-specific database collation sequences.
  19.  
  20.  
  21. ==========================================================================
  22. 2. Translated Message Support
  23.  
  24.    The international release of CA-Clipper 5.2 lets you change
  25.    the default messages that appear in the product, to different
  26.    languages.
  27.  
  28.    The messages affected by this are:
  29.      Days of the Week    - day names used by the CDOW() function.
  30.      Months of the Year  - month names used by CMONTH() function.
  31.      Command Messages    - LABEL FORM SAMPLES message.
  32.                            REPORT FORM titles.
  33.                            GET System scoreboard messages.
  34.      Runtime Errors      - Many runtime errors are translated
  35.                            (This support is not provided with all drivers)
  36.  
  37.    A file MSG*.OBJ for each country (listed below) provides this
  38.    support.
  39.  
  40.  
  41. ==========================================================================
  42. 3. Collation Sequences
  43.  
  44.    The collation sequence affects the order of your indexes, sort
  45.    operations, array sorting and string comparisons.  It also includes
  46.    the functions UPPER(), LOWER(), ISUPPER(), ISLOWER(), ISALPHA() and
  47.    PICTURE clause routines. The == (Exactly equal--binary) operator is
  48.    not affected by this.
  49.  
  50.    The default collation sequence for CA-Clipper is ASCII order.
  51.    National language collations drivers reorder this sequence to
  52.    include each country's accented characters in the correct place
  53.    within the alphabet.
  54.  
  55.    An example, is the letter ç-CHR(135).  With the default ASCII
  56.    collation sequence, if this occurred in an index, it would appear
  57.    between the letters å-CHR(134) and ê-CHR(136).  If you link in
  58.    the French MDX collation driver and rebuild the index, the ç-CHR(153)
  59.    will now appear between the letters c-CHR(67) and d-CHR(68).
  60.    Therefore, the compare operation described below can give
  61.    different results, depending on which driver is linked.
  62.  
  63.       ? "ç" > "d"     // Returns .T. with ASCII collation sequence
  64.       ? "ç" > "d"     // Returns .F. with French MDX collation sequence
  65.  
  66.    Note: Changing the collation sequence in an application with
  67.          existing indexes will cause index corruption. You should
  68.          rebuild all indexes before the application is used.
  69.  
  70.    ---------------------------------------------------------------------
  71.    3.1  Replaceable Database Drivers
  72.  
  73.    CA-Clipper 5.2 supports Replaceable Database Drivers (RDDs). Within
  74.    each country, the different database products can provide a different
  75.    collation sequence.  We, therefore, supply different nation language
  76.    drivers for each of the RDDs.
  77.  
  78.    The following information outlines the specifics of collation support
  79.    for these drivers.
  80.  
  81.    ---------------------------------------------------------------------
  82.    3.1.1  DBFNTX (Clipper) collation sequence support
  83.  
  84.    These DBFNTX language support drivers replace those provided with the
  85.    European Nation Module Suite available for previous versions of
  86.    CA-Clipper.
  87.  
  88.    ---------------------------------------------------------------------
  89.    3.1.2  DBFMDX (dBase IV) collation sequence support
  90.  
  91.    The DBFMDX National language drivers allow your applications to
  92.    correctly update dBase IV database and associated MDX files.  Each
  93.    country-specific version of dBase IV is contains its own unique
  94.    collation sequence.  If you do not use the correct driver,
  95.    index corruption will occur.
  96.  
  97.    ---------------------------------------------------------------------
  98.    3.1.3  DBFCDX (FoxPro 2) collation sequence support
  99.  
  100.    European versions of FoxPro 2 use the ASCII collation sequence.
  101.  
  102.    You can link the national language message drivers, if you wish to
  103.    provide messages in your application.  This will not affect the
  104.    collation sequence of the DBFCDX RDD.
  105.  
  106.    Note: Please inform your local Computer Associates office if a
  107.          non-ASCII collation sequence is required for compatibility
  108.          with the FoxPro 2 in your country.
  109.  
  110.    ---------------------------------------------------------------------
  111.    3.1.4  DBPX (Parodox 3.5) collation sequence support
  112.  
  113.    CURRENTLY, NO NATIONAL LANGUAGE SUPPORT IS AVAILABLE FOR THIS RDD.
  114.  
  115.    You can link the national language message drivers, if you wish to
  116.    provide messages in your application.  This will not affect the
  117.    collation sequence of the DBPX RDD.
  118.  
  119.    ---------------------------------------------------------------------
  120.    3.2  Multiple RDD support
  121.  
  122.    You can only link one national language driver into a CA-Clipper
  123.    5.2 application at any time.  It is not possible to provide the two
  124.    different indexing orders simultaneously for users who require
  125.    both DBFNTX and DBFMDX Replaceable Database Drivers in a single
  126.    application.  You should, therefore, select the language driver
  127.    for the RDD index with which you wish to remain compatible.
  128.    You should rebuild all the indexes for the non-compatible RDD
  129.    system.
  130.  
  131. ==========================================================================
  132. 4. What countries are supported?
  133.  
  134.    The following table outlines which countries we currently support.
  135.    ┌────────────┬──────────┬──────────┬────────┬────────────────────┐
  136.    │ Country    │ Messages │ DBFNTX   │ DBFMDX │ Notes              │
  137.    ╞════════════╪══════════╪══════════╪════════╪════════════════════╡
  138.    │ British    │          │          │ MDXUK  │ NTX is ASCII order │
  139.    │ Danish     │ MSGDAN   │ NTXDAN   │        │                    │
  140.    │ Dutch      │ MSGDUT   │ NTXDUT   │ MDXDUT │                    │
  141.    │ Finnish    │ MSGFIN   │ NTXFIN   │        │                    │
  142.    │ French     │ MSGFRE   │ NTXFRE   │ MDXFRE │                    │
  143.    │ German     │ MSGGER   │ NTXGER   │ MDXGER │                    │
  144.    │ Greek      │ MSGGR437 │ NTXGR437 │        │ For Code Page 437  │
  145.    │            │ MSGGR851 │ NTXGR851 │        │ For Code Page 851  │
  146.    │ Icelandic  │ MSGIC850 │ NTXIC850 │        │ For Code Page 850  │
  147.    │            │ MSGIC861 │ NTXIC861 │        │ For Code Page 861  │
  148.    │ Italian    │ MSGITA   │ NTXITA   │ MDXITA │                    │
  149.    │ Norwegian  │ MSGNOR   │ NTXNOR   │        │                    │
  150.    │ Portuguese │ MSGPOR   │          │        │                    │
  151.    │ Spanish    │ MSGSPA   │ NTXSPA   │ MDXSPA │                    │
  152.    │ Swedish    │ MSGSWE   │ NTXSWE   │ MDXSWE │                    │
  153.    └────────────┴──────────┴──────────┴────────┴────────────────────┘
  154.  
  155.    If support for your country is not provided, please contact your
  156.    local Computer Associates office.
  157.  
  158.    To install the appropriate drivers for your country run NATION.BAT,
  159.    found in the \CLIPPER5\OBJ directory and follow the on-screen
  160.    instructions.  This will copy your country's message driver to
  161.    MSG.OBJ, the DBFNTX collation driver to NTXSORT.OBJ and the DBFMDX
  162.    collation driver to MDXSORT.OBJ.
  163.  
  164. ==========================================================================
  165. 5. Linking the national language drivers.
  166.  
  167.    The following documentation uses the file naming convention 
  168.    described above and assumes your have run NATION.BAT.
  169.  
  170.    Before you link in your language driver, ensure that you have set
  171.    the environment variable, OBJ, to the \CLIPPER5\OBJ directory.
  172.    For example, include "SET OBJ=C:\CLIPPER5\OBJ" in your AUTOEXEC.BAT.
  173.  
  174.    To create a Clipper .EXE that provides support for your country,
  175.    you must link in the Message Driver and the Collation Driver
  176.    (for the RDD you wish to use). The syntax for this is:
  177.  
  178.      RTLINK FI <Objs> [, <MessageDriver>] [, <CollationDriver>]
  179.  
  180.    where  <Objs>            is the list of .OBJ files for your application
  181.           <MessageDriver>   is the country messages driver
  182.           <CollationDriver> is the country RDD driver
  183.  
  184.    For example, to build an application with both messages and
  185.    DBFMDX collation support use,
  186.  
  187.      RTLINK FI <objs>, MSG, MDXSORT
  188.  
  189.    Both the Message and the Collation drivers are optional.  An
  190.    application could provide translated messages with the standard ASCII
  191.    collation driver. e.g.
  192.  
  193.      RTLINK FI <objs>, MSG
  194.  
  195.    By using the //INFO command line switch with your application, you
  196.    can determine what National Language Drivers have been linked into
  197.    your application. For example,
  198.  
  199.      C:\> MYAPP //INFO
  200.  
  201.    when linked with no language drivers, will display the following
  202.    message before your application starts.
  203.  
  204.  
  205.      Clipper (R) 5.2 Intl. Rev. 1.96 BRITISH - ASCII Collation
  206.                                      └──┬──┘   └─┬─┘
  207.                                         │        │
  208.                      National Message ──┘        └── National Collation
  209.                      Driver Linked                   Driver Linked
  210.  
  211.  
  212.    This message will change depending on what has been linked into your
  213.    application. For the collation driver, the RDD and country will be
  214.    displayed. For example if you have installed the French nation
  215.    drivers and linked in MSG.OBJ and MDXSORT.OBJ, the application would
  216.    display:
  217.  
  218.      Clipper (R) 5.2 Intl. Rev. 1.96 FRENCH - FRENCH DBFMDX Collation
  219.  
  220.  
  221.    ---------------------------------------------------------------------
  222.    If you require any further technical assistance, or encounter any
  223.    problems please contact your local Computer Associates office.
  224.  
  225.                               *  *  *
  226. 
  227.