Home | History | Annotate | Download | only in ohacds-g11n
      1 README.ohacds.g11n v1.0 04 Jul 2007
      2 
      3 OPENHACLUSTER G11N WORKSPACE BUILDABLE SOURCE
      4 
      5 Open High Availability Cluster Globalization buildable source.
      6 Consists of messages as well as codes pertaining to localization. 
      7 
      8 
      9 - The contents of the tarball ohacds-g11n-20070704.tar.bz2 includes:
     10 
     11         * Translations of Open HA Cluster agent message files.
     12           including:
     13 
     14                 Translation messages for Open HA Cluster agent 
     15                 components.
     16 
     17                 Package buildable tree for above messages
     18 
     19         There are no translated man pages for agents.
     20 
     21 - More notes on the files in tarball
     22         * Translation file format is .po.
     23         * Languages and encodings are as follows :
     24 
     25                 Language            Short_name    Encoding
     26                 --------------------------------------------
     27                 German              de          : 8859-1
     28                 Spanish             es          : 8859-1
     29                 French              fr          : 8859-1
     30                 Japanese            ja          : eucJP
     31                 Korean              ko          : ko_KR.euc
     32                 Simplified Chinese  zh          : zh_CN.euc
     33                 Traditional Chinese zh_CN       : zh_TW.euc
     34 
     35         * Some files are not full translation of corresponding
     36           source (English) files but translation of subset.
     37           The number of translated messages are different between
     38           languages.
     39 
     40 - You will need to have the following installed in order to build 
     41   the files on Solaris. To install all these tools and components
     42   please select 'Developer System Support' and corresponding seven
     43   language areas in Solaris installation.
     44 
     45         * /usr/ccs/bin/make
     46         * /usr/bin/msgfmt
     47         * /bin/pkgmk
     48         * /usr/perl5/bin/perl
     49         * OS locales
     50                 needed by msgfmt which needs to run in the locale
     51                 which given (code-converted) .po file is for.
     52                 (Essentially, only codeset is significant so it's
     53                 possible to generate .mo in different locale but
     54                 with same codeset.)
     55                
     56                 All seven locales, German, Spanish, French, Japanese,
     57                 Korean, Simplified Chinese and Traditional Chinese
     58                 are needed to succeed the build. When you added your
     59                 own language or locale cluster message, that locale
     60                 will be also needed on the system.
     61                 
     62         * iconv modules between each source encoding and target binary 
     63           encodings(e.g. UTF-8, GB18030, Big5...)
     64         * other misc tools like grep, sed, etc.
     65 
     66         This list can grow when more contents become available
     67         in the future.
     68 
     69         C/C++ compilers are not used.
     70 
     71 - How to extract the tarball
     72 
     73         $ cd <your_directory>
     74         $ bzcat ohacds-g11n-YYYYMMDD.tar.bz2 | tar xvf -
     75         (directory "ohacds-g11n" will be created)
     76 
     77 - How to build entire source tree
     78 
     79         * Set three environment variables called 'SRC', 'ROOT', 'PKGROOT'
     80           to  to the full path of the g11n directory, i.e., if you extracted 
     81           it into a /build directory then SRC should be /build/ohacds-g11n. 
     82           Compiled files will be located under $ROOT directory and
     83           build packages will be under $PKGROOT directory.
     84 
     85           For example in ksh:
     86 
     87                 $ export SRC=/build/ohacds-g11n
     88                 $ export ROOT=/proto
     89                 $ export PKGROOT=/pkg
     90 
     91           Each directory need to have proper permission to build.
     92 
     93         * Go to <your_directory>/ohacds-g11n/trans and compile message 
     94           files and install them into $ROOT directory.
     95 
     96                 $ make -e install 2>&1 | tee make.log
     97 
     98         * Go to <your_directory>/ohacds-g11n/pkg and compile message 
     99           files and install them into $PKGROOT directory.
    100   
    101                 $ make -e install 2>&1 | tee pkg.log
    102 
    103         The packages are built under $PKGROOT directory.
    104 
    105 - How to install built packages
    106 
    107         * Use pkgadd command with root or alternate user account to install
    108           packages on your system.
    109 
    110                 # pkgadd -d $PKGROOT <package names>
    111 
    112 - Package convention and number of packages.
    113         * Each language packages have specific name as below.
    114 
    115                 German pkg              : SUNWd*
    116                 French pkg              : SUNWf*
    117                 Spanish pkg             : SUNWe*
    118                 Japanese pkg            : SUNWj*
    119                 Korean pkg              : SUNWk*
    120                 Simplified Chinese pkg  : SUNWc*
    121                 Traditional Chinese pkg : SUNWh*
    122 
    123          * The number of packages are difference between languages.
    124            The number of packages for French, Japanese and Simplified Chinese
    125            are larger than German, Spanish, Korean and Traditional Chinese.
    126 
    127 - Bug/RFE subcategories 
    128 
    129         * To report a bug or an RFE, please use the following web interface:
    130 
    131                 https://www.opensolaris.org/bug/report.jspa
    132 
    133         * Translation bugs of Open HA Cluster are filed in 'l10n' subcategory
    134           in corresponding Open HA Cluster bug category. The category of
    135           Open HA Cluster bug is 'suncluster'.
    136 
    137