140 lines
7.6 KiB
Plaintext
140 lines
7.6 KiB
Plaintext
<!-- $XConsortium: preface.sgm /main/10 1996/08/25 15:12:06 rws $ -->
|
|
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
|
|
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
|
|
<!-- (c) Copyright 1995 International Business Machines Corp. -->
|
|
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
|
|
<!-- (c) Copyright 1995 Novell, Inc. -->
|
|
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
|
|
<!-- (c) Copyright 1995 Hitachi. -->
|
|
|
|
<preface id="IPG.Pref.div.1">
|
|
<title>Preface</title>
|
|
<para>The <emphasis>Common Desktop Environment: Internationalization Programmer's
|
|
Guide</emphasis> provides information for internationalizating the desktop,
|
|
enabling applications to support various languages and cultural conventions
|
|
in a consistent user interface.</para>
|
|
<para>Specifically, this guide:</para>
|
|
<itemizedlist remap="Bullet1"><listitem><para>Provides guidelines and hints
|
|
for developers on how to write applications for worldwide distribution.</para>
|
|
</listitem><listitem><para>Provides an overall view of internationalization
|
|
topics that span different layers within the desktop.</para>
|
|
</listitem><listitem><para>Provides pointers to reference and more detailed
|
|
documentation. In some cases, standard documentation is referenced.</para>
|
|
</listitem></itemizedlist>
|
|
<para>This guide is not intended to duplicate the existing reference or conceptual
|
|
documentation but rather to provide guidelines and conventions on specific
|
|
internationalization topics. This document focuses on internationalization
|
|
topics and not on any specific component or layer in an open software environment.
|
|
</para>
|
|
<sect1 id="IPG.Pref.div.2">
|
|
<title>Who Should Use This Book</title>
|
|
<para>This book provides various levels of information for the application
|
|
programmer and developer and related fields.</para>
|
|
</sect1>
|
|
<sect1 id="ipg.pref.div.3">
|
|
<title>How This Book Is Organized</title>
|
|
<para>Explanations of the contents of this book follow:</para>
|
|
<para><emphasis role="Lead-in">Chapter 1, “Introduction to Internationalization,”</emphasis> provides an overview of internationalization and localizing within
|
|
the desktop, including locales, fonts, drawing, inputting, interclient communication,
|
|
and extracting user visual text. Information on the significance of internationalization
|
|
standards is also provided.</para>
|
|
<para><emphasis role="Lead-in">Chapter 2, “Internationalization and
|
|
the Common Desktop Environment,”</emphasis> covers the set of topics
|
|
that developers commonly need to consider when internationalizing their applications,
|
|
including locale management, localized resources, font management, localized
|
|
text tasks, interclient communication for localized text, and internationalized
|
|
functions.</para>
|
|
<para><emphasis role="Lead-in">Chapter 3, “Internationalization and
|
|
Distributed Networks,”</emphasis> discusses topics related to handling
|
|
encoded characters in distributed networks. Basic principles and examples
|
|
for interclient interoperability are provided to guide developers in internationalized
|
|
distributed environments.</para>
|
|
<para><emphasis role="Lead-in">Chapter 4, “Xt, Xlib, and Motif Dependencies,”</emphasis> topics include internationalized applications, locale management,
|
|
localized text, international User Interface Language (UIL), and localized
|
|
applications.</para>
|
|
<para><emphasis role="Lead-in">Appendix A,“Message Guidelines,”</emphasis> is a set of guidelines for writing messages.</para>
|
|
</sect1>
|
|
<sect1 id="IPG.Pref.div.4">
|
|
<title>Related Publications</title>
|
|
<para>See the following documentation for additional information on topics
|
|
presented in this book:</para>
|
|
<itemizedlist remap="Bullet1"><listitem><para>ISO C: ISO/IEC 9899:1990, <emphasis>Programming Languages --- C</emphasis> (technically identical to ANS X3.159-1989,
|
|
Programming Language C).</para>
|
|
</listitem><listitem><para>ISO/IEC 9945-1: 1990, (IEEE Standard 1003.1) <emphasis>Information Technology - Portable Operating System Interface (POSIX) - Part
|
|
1: System Application Program Interface (API) [C Language</emphasis>].</para>
|
|
</listitem><listitem><para>ISO/IEC DIS 9945-2: 1992, (IEEE Standard 1003.2-Draft) <emphasis>Information Technology - Portable Operating System Interface (POSIX) - Part
|
|
2: Shell and Utilities</emphasis>.</para>
|
|
</listitem><listitem><para>Motif: <emphasis>Motif Programmer's
|
|
Reference</emphasis>, <emphasis>Revision 1.2</emphasis>, Open Software Foundation,
|
|
Prentice Hall, 1992, ISBN: 0-13-643115-1.</para>
|
|
</listitem><listitem><para>Scheifler, W. R., <emphasis>X Window System, The
|
|
Complete Reference to Xlib, Xprotocol, ICCCM, XLFD</emphasis> - X Version
|
|
11, Release 5, Digital Press, 1992, ISBN: 1-55558- 088-2.</para>
|
|
</listitem><listitem><para>X/Open: <emphasis>X/Open CAE Specification System
|
|
Interface Definition</emphasis>, Issue 4, X/Open Company Ltd., 1992, ISBN:
|
|
1-872630-46-4.</para>
|
|
</listitem><listitem><para>X/Open: <emphasis>X/Open CAE Specification Commands
|
|
and Utilities</emphasis>, Issue 4, X/Open Company Ltd., 1992, ISBN: 1-872630-48-0.
|
|
</para>
|
|
</listitem><listitem><para>X/Open: <emphasis>X/Open CAE Specification System
|
|
Interface and Headers</emphasis>, Issue 4, X/Open Company Ltd., 1992, ISBN:
|
|
1-872630-47-2.</para>
|
|
</listitem><listitem><para>X/Open: <emphasis>X/Open Internationalization Guide</emphasis>, X/Open Company Ltd., 1992, ISBN: 1-872630-20-0.</para>
|
|
</listitem><listitem><para>ISO/IEC 10646-1:1993 (E): <emphasis>Information
|
|
Technology - Universal Multi-Octet Coded Character Set (UCS). Part 1: Architecture
|
|
and Basic Multilingual Plane</emphasis>.</para>
|
|
</listitem></itemizedlist>
|
|
</sect1>
|
|
<sect1 id="IPG.Pref.div.5">
|
|
<title>What DocBook SGML Markup Means</title>
|
|
<para>This book is written in the Structured Generalized Markup Language (SGML)
|
|
using the DocBook Document Type Definition (DTD). The following table
|
|
describes the DocBook markup used for various semantic elements.
|
|
</para>
|
|
<table id="ipg.pref.tbl.1" frame="topbot">
|
|
<title id="ipg.pref.mkr.1">DocBook SGML Markup</title>
|
|
<tgroup cols="3" colsep="0" rowsep="0">
|
|
<colspec colname="1" colwidth="1.2 in">
|
|
<colspec colname="2" colwidth="1.89 in">
|
|
<colspec colname="3" colwidth="2.23 in">
|
|
<thead>
|
|
<row>
|
|
<entry><para><literal>Markup Appearance</literal></para></entry>
|
|
<entry><para><literal>Semantic Element(s)</literal></para></entry>
|
|
<entry><para><literal>Example</literal></para></entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry><para><command>AaBbCc123</command></para></entry>
|
|
<entry><para>The names of commands.</para></entry>
|
|
<entry><para>Use the <command>ls</command> to list files.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><literal>AaBbCc123</literal></para></entry>
|
|
<entry><para>The names of command options.</para></entry>
|
|
<entry><para>Use <command>ls</command><literal>−a</literal> to list all files.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><symbol role="Variable">AaBbCc123</symbol></para></entry>
|
|
<entry><para>Command-line placeholder: replace with a real name or value.</para></entry>
|
|
<entry><para>To delete a file, type <command>rm</command>
|
|
<symbol role="Variable">filename</symbol>.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><filename>AaBbCc123</filename></para></entry>
|
|
<entry><para>The names of files and directories.</para></entry>
|
|
<entry><para>Edit your <filename>.login</filename> file.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><emphasis>AaBbCc123</emphasis></para></entry>
|
|
<entry><para>Book titles, new words or terms, or words to be emphasized.</para></entry>
|
|
<entry><para>Read Chapter 6 in <emphasis>User's Guide</emphasis>. These are called <emphasis>class</emphasis> options. You <emphasis>must</emphasis> be root to do this.</para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
</sect1>
|
|
</preface>
|
|
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 04:19:51-->
|