Preface

Asian Application Developer's Guide provides application development information specific to the operation of the following three separate Sun® products, which are identified generically as Asian Solaris^TM software:

Korean Solaris software
Simplified Chinese Solaris software
Traditional Chinese Solaris software

This documentation complements Sun's standard Common Desktop Environment (CDE) and Solaris base-release product documentation. It includes information that advanced users and developers can use to access and control the Korean or Chinese language-related features of Asian Solaris software.

Who Should Use This Book

You should already be familiar (but need not be expert) with Solaris, the windowing environment you are using, and their documentation.

You should read this manual if:

You need specific instructions on how to set up Korean or Chinese Solaris language features for users.
You are a developer who has not used the Korean or Chinese Solaris operating environment before.
You are a developer who needs information on accessing and controlling the Korean- or Chinese-related features of Asian Solaris software.
You are an advanced user who wants to use or customize Korean- or Chinese-related features of Asian Solaris software.
You want information on a variety of Korean- or Chinese-related details internal to the operation of Asian Solaris software.

Before You Read This Book

Before you read this book, read Common Desktop Environment: Internationalization Programmer's Guide and Solaris Internationalization Guide for Developers for basic internationalization issues. You should also read an overview of your Asian Solaris product and last-minute changes not included in this document. The following documents contain this information:

The release overview for your Asian Solaris locale
Asian Solaris Release and Installation Notes (Intel Platform Edition)
Asian Solaris Release and Installation Notes (SPARC Platform Edition)
Solaris Advanced Installation Guide
Information Library for Solaris (Intel Platform Edition)
Information Library for Solaris (SPARC Platform Edition)

How This Book Is Organized

Each chapter of Asian Application Developer's Guide addresses a different aspect of development for a Korean or Chinese feature of Asian Solaris software. Some chapters give step by step instructions for using or customizing product features.

Chapter 1, System Environment describes the Asian Solaris locale environments.

Chapter 2, Language Environment and Character Codes describes the mechanisms for handling different character sets and multiple code sets.

Chapter 3, The Codeset Conversion Utility describes the iconv library, a conversion utility for character-based code.

Chapter 4, Asian Solaris Fonts describes the fonts and font sets that come with the software and shows basic ways to use them.

Chapter 5, X Input Method Architecture describes the X Window input method architecture.

Chapter 6, Display PostScript System (DPS) explains how to use DPS for Asian font displays in the Asian Solaris operating environment.

Appendix A, OpenWindows Information describes information unique to OpenWindows environment programming.

Appendix B, Backward Compatibility Information describes utilities useful for backward compatibility.

Related Books

The following books are related to the topic of this book and may contain useful information.

For information on how to use the window system and associated applications, see:

The user's guide for your Asian Solaris product
Solaris User's Guide

For information on Asian Solaris system administration, see the system administration guide for your Asian Solaris localization.

What Typographic Changes Mean

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions


Typeface or Symbol	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% You have mail.`
`AaBbCc123`	What you type, contrasted with on-screen computer output	`machine_name%` `su` `Password:`
`AaBbCc123`	Command-line placeholder: replace with a real name or value	To delete a file, type `rm` `filename`.
AaBbCc123	Book titles, new words or terms, or words to be emphasized	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts


Shell	Prompt
C shell prompt	`machine_name%`
C shell superuser prompt	`machine_name#`
Bourne shell and Korn shell prompt	`$`
Bourne shell and Korn shell superuser prompt	`#`