README.opensolaris.g11n v2.0, Jul 3, 2007

OPENSOLARIS.ORG NEVADA G11N WORKSPACE BUILD INSTRUCTIONS

This file contains the instructions for checking out and building the G11N

workspace for OpenSolaris, where to file bug or RFE (Request For Enhancement)

reports, and also how to contribute.

G11N Workspace Build Instructions

---------------------------------

1. Install a build machine with the latest version of Solaris Express from:

	http://www.sun.com/software/solaris/solaris-express/get.jsp

   Currently, the build machines must have Developer System Support or higher

   meta-cluster and all locales installed. It is recommended to have at least

   1GB of swap space or memory combined for a proper build.

   After the build machine installation, about 3.2GB of free disk space is

   needed to keep the downloaded tarballs and also to build.

2. Download an install image of Sun Studio 11 for OpenSolaris, SPARC or

   x86/x64 from:

	http://opensolaris.org/os/community/tools/sun_studio_tools/sun_studio_11_tools/

   This must be installed into /opt/SUNWspro/, i.e. your cc compiler should be

   available as /opt/SUNWspro/bin/cc.

3. Download the closed binary tarballs by following the link from the following

   web page:

	http://www.opensolaris.org/os/community/int_localization/sources/

   The binary tarballs contain binary objects that may not be on your current

   system but are needed by the workspace to build, and use the naming

   convention 'g11n-{closed,GPL}-bins-<DATE>.<PLATFORM>.tar.bz2'. Make sure

   you take the correct ones for your architecture, for instance, download

   'g11n-closed-bins-20061220.sparc.tar.bz2' and

   'g11n-GPL-bins-20061220.sparc.tar.bz2' if you are working on a SPARC-based

   system and 'g11n-closed-bins-20061220.i386.tar.bz2' and

   g11n-GPL-bins-20061220.i386.tar.bz2' if you are working on an x86/x64-based

   system. The tarballs are also organized by date, where the date is in

   the format of YYYYMMDD.

4. Unpack the binary tarballs at the root file system as root:

	$ su -

	# bzcat g11n-closed-bins-20061220.sparc.tar.bz2 | (cd / ; tar xvf -)

	# bzcat g11n-GPL-bins-20061220.sparc.tar.bz2 | (cd / ; tar xvf -)

5. Check out the latest source codes from live repository

    # cd /build

    # hg clone ssh://[email protected]/hg/nv-g11n/g11n

    More details about G11N live repository can be found from:

    http://www.opensolaris.org/os/project/nv-g11n/documents/repository/

6. Set an environment variable called 'SRC' to the full path of the g11n

   directory, i.e., if you extracted it into a /build directory then SRC

   should be /build/g11n. In ksh:

	# export SRC=/build/g11n

7. Add the necessary paths to your $PATH variable such as '/usr/ccs/bin' for

   make and '/opt/SUNWspro/bin' for compilers. These should be near

   the beginning so that they are the first to be picked up.

	# export PATH=/opt/SUNWspro/bin:/usr/ccs/bin:/usr/openwin/bin:/usr/bin

8. Run 'make all' to build the workspace in its entirety. This will compile

   and generate binary files and create an empty directory tree in

   $SRC/proto/$arch/fileroot where $arch is your machine's architecture,

   i.e., sparc or i386:

	# make all 2>&1 | tee make.log

   The '2>&1 | tee make.log' will write all output from the make into

   a file called make.log. This isn't strictly necessary but is useful for

   debugging purposes later.

9. Run 'make install' to populate this directory tree. This will copy all

   necessary files into $SRC/proto/$arch/fileroot in the locations that they

   would be installed on your system:

	# make install 2>&1 | tee install.log

10. Run 'make links' to set up the necessary permissions and symbolic links in

   the proto directory. This changes the permissions and owners of the files

   to what they would be on the installed system, and also creates all

   necessary symbolic links between files:

	# make links 2>&1 | tee links.log

11. To install the G11N files on your system, the workspace will create

   a set of binary tarballs in $SRC/dist/$arch which, if extracted from

   the root of your machine, will install all of the components to their

   correct locations. There are three options for this:

   - All components in one tarball. This will bundle everything into

     the one tarball, approx 62MB in size depending on the architecture.

     Build this by running 'make tarball'.

   - One tarball per locale. This creates a separate tarball for each locale,

     using the locale name as the tarball name, plus a common tarball for

     components that are common across all locales. Build this by running

     'make tarballs'.

   - One tarball for a specific locale. If you only want to install one locale,

     then you can run 'make <locale>' where <locale> is the name of the locale

     you want to create the tarball for, e.g., 'make de_DE' for German locales.

     If you just provide the "short" locale name without the codeset,

     the tarball will contain all of the codesets for that locale.

12. After installation

    Run tools/update_fonts_cache.sh to update fonts.cache-1 files

    possibly outdated by installing font files.

    (Otherwise desktop login may fail.)

    # $SRC/tools/update_fonts_cache.sh

    updating /usr/openwin/lib/X11/fonts/TrueType/ttmap/fonts.cache-1...

    updating /usr/openwin/lib/X11/fonts/TrueType/fonts.cache-1...

    updating /usr/openwin/lib/locale/ar/X11/fonts/TrueType/fonts.cache-1...

    updating /usr/openwin/lib/locale/ko.UTF-8/X11/fonts/TrueType/fonts.cache-1...

    updating /usr/openwin/lib/locale/en_US.UTF-8/X11/fonts/misc/fonts.cache-1...

    updating /usr/openwin/lib/locale/ko/X11/fonts/TrueType/fonts.cache-1...

    # 

Bug/RFE Reports

---------------

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

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

Available category values are library and utility and subcategory values are

l10n-common, l10n-asia, l10n-europe, l10n-japan, and l10n-message.

Alternatively you can also inform and discuss your issue or idea with

other community members at i18n-discuss at opensolaris.org mailing list and

other language mailing lists shown at the following:

	http://www.opensolaris.org/os/community/int_localization/discussions/

How to Contribute

-----------------

If you would like make contributions (source, idea, translation, and so on),

sending an email to i18n-discuss at opensolaris.org mailing list and

discuss about the contribution would be a good start.

You can also follow the Development Process at OpenSolaris.org shown at

the following:

	http://www.opensolaris.org/os/community/on/os_dev_process/

and start a project.

If bug or RFE that you're thinking about to contribute are not big enough for

a project and if you have code changes already more or less, you can also

simply file a bug or RFE report and send an email to request-sponsor at

opensolaris.org *and* i18n-discuss at opensolaris.org asking for a sponsor.

There are many emails that you can reference before you send out

a request from the following:

	http://www.opensolaris.org/jive/forum.jspa?forumID=27

Shortly after your email, there will be a sponsor contacting you and work

together with you to integrate your contributions into G11N or any other

consolidation/community's workspaces as needed.