xref: /ohac/ohacgeo-g11n

README.ohacgeo.g11n v1.0 03 Dec 2007

Open High Availability Cluster Geographic Edition (Open HA Cluster) 
G11N Workspace buildable source

The Open High Availability Cluster Geographic Edition Globalization buildable 
source, consists of messages as well as codes pertaining to localization. 


- The contents of the tarball ohacgeo-g11n-20071203.tar.bz2 includes:

        * Translations of Open HA Cluster GEO message files.
          including:

                Translation messages for Open HA Cluster GEO
                components.

                Package buildable tree for above messages

        There are no translated man pages and online help files. 

- More notes on the files in tarball
        * Translation file formats are .po, .properties.
        * Languages and encodings are as follows :

                Language            Short_name    Encoding
                --------------------------------------------
                Japanese            ja          : eucJP
                Korean              ko          : ko_KR.euc
                Simplified Chinese  zh          : zh_CN.euc

        * Some files are not full translation of corresponding
          source (English) files but translation of subset.

- You will need to have the following installed component in order
  to build the files on Solaris. To install all these tools and 
  components please select 'Developer System Support' and corresponding 
  three language areas in Solaris installation.

        * /usr/ccs/bin/make
        * /usr/bin/msgfmt
        * /usr/sbin/install
        * /bin/pkgmk
        * /usr/java/bin/native2ascii
        * OS locales
                needed by msgfmt which needs to run 
                in the locale which given (code-converted) .po file is for.
                (Essentially, only codeset is significant so it's
                possible to generate .mo in different locale but
                with same codeset.)
               
                All three locales, Japanese, Korean and Simplified 
                Chinese are needed to succeed the build. When you 
                added your own language or locale cluster message, 
                that locale will be also needed on the system.
                
        * iconv modules between each source encoding and target binary 
          encodings(e.g. UTF-8, GB18030, Big5...)
        * other misc tools like grep, sed, etc.

        This list can grow when more contents become available
        in the future.

        C/C++ compilers are not used.

- How to extract the tarball

        $ cd <your_directory>
        $ bzcat ohacgeo-g11n-YYYYMMDD.tar.bz2 | tar xvf -
        (directory "ohacgeo-g11n" will be created)

- How to build entire source tree

        * In the expanded directory 'ohacgeo-g11n', there is build script
          named as 'build_ohacgeo-g11n.sh'. You can use this script to 
          build sources and packages. 

          $ cd ohacgeo-g11n
          $ chmod 755 build_ohacgeo-g11n.sh
          $ ./build_ohacgeo-g11n.sh'

          Script makes directory of 'proto' for put compiled files 
          and 'packages' for built packages. Logs are gathered into
          'log' file.


        * If you would like to use make files directory for partial build
          etc., please follow the below instruction.

             Set three environment variables called 'SRC', 'ROOT', 'PKGROOT'
             to the full path of the g11n directory, i.e., if you extracted
             it into a /build directory then SRC should be /build/ohacgeo-g11n.
             Compiled files will be located under $ROOT directory and build 
             packages will be under $PKGROOT directory.

             For example in ksh:

                   $ export SRC=/build/ohacgeo-g11n
                   $ export ROOT=/proto
                   $ export PKGROOT=/pkg

             Each directory need to have proper permission to build.

           * Go to <your_directory>/ohacgeo-g11n/usr

                   $ make -e install 2>&1 | tee make.log

           The packages are built under $PKGROOT directory.

- How to install built packages

        * Use pkgadd command with root or alternate user account to install
          packages on your system.

                # pkgadd -d $PKGROOT <package names>

- Package names:
        * The following packages are created.

                Japanese pkg :
                   SUNWjscgctl SUNWjscgrepavsu SUNWjscgrepsrdfu
                   SUNWjscgreptcu SUNWjscgspm
                Korean pkg :
                   SUNWkscgctl SUNWkscgrepavsu SUNWkscgrepsrdfu
                   SUNWkscgreptcu SUNWkscgspm
                Simplified Chinese pkg :
                   SUNWcscgctl SUNWcscgrepavsu SUNWcscgrepsrdfu
                   SUNWcscgreptcu SUNWcscgspm

- Bug/RFE subcategories 

        * To report a bug or an RFE, please use the following web interface:

                https://www.opensolaris.org/bug/report.jspa

        * Translation bugs of Open HA Cluster are filed in 'l10n' subcategory
          in corresponding Open HA Cluster GEO bug category. The category of
          Open HA Cluster GEO bug is 'suncluster-geo'.