xref: /ohac/ohacds-g11n

README.ohacds.g11n v1.0 04 Jul 2007

OPENHACLUSTER G11N WORKSPACE BUILDABLE SOURCE

Open High Availability Cluster Globalization buildable source.
Consists of messages as well as codes pertaining to localization. 


- The contents of the tarball ohacds-g11n-20070704.tar.bz2 includes:

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

                Translation messages for Open HA Cluster agent 
                components.

                Package buildable tree for above messages

        There are no translated man pages for agents.

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

                Language            Short_name    Encoding
                --------------------------------------------
                German              de          : 8859-1
                Spanish             es          : 8859-1
                French              fr          : 8859-1
                Japanese            ja          : eucJP
                Korean              ko          : ko_KR.euc
                Simplified Chinese  zh          : zh_CN.euc
                Traditional Chinese zh_CN       : zh_TW.euc

        * Some files are not full translation of corresponding
          source (English) files but translation of subset.
          The number of translated messages are different between
          languages.

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

        * /usr/ccs/bin/make
        * /usr/bin/msgfmt
        * /bin/pkgmk
        * /usr/perl5/bin/perl
        * 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 seven locales, German, Spanish, French, Japanese,
                Korean, Simplified Chinese and Traditional 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 ohacds-g11n-YYYYMMDD.tar.bz2 | tar xvf -
        (directory "ohacds-g11n" will be created)

- How to build entire source tree

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

          For example in ksh:

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

          Each directory need to have proper permission to build.

        * Go to <your_directory>/ohacds-g11n/trans and compile message 
          files and install them into $ROOT directory.

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

        * Go to <your_directory>/ohacds-g11n/pkg and compile message 
          files and install them into $PKGROOT directory.
  
                $ make -e install 2>&1 | tee pkg.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 convention and number of packages.
        * Each language packages have specific name as below.

                German pkg              : SUNWd*
                French pkg              : SUNWf*
                Spanish pkg             : SUNWe*
                Japanese pkg            : SUNWj*
                Korean pkg              : SUNWk*
                Simplified Chinese pkg  : SUNWc*
                Traditional Chinese pkg : SUNWh*

         * The number of packages are difference between languages.
           The number of packages for French, Japanese and Simplified Chinese
           are larger than German, Spanish, Korean and Traditional Chinese.

- 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 bug category. The category of
          Open HA Cluster bug is 'suncluster'.