blob: c635c1633fee11bfdd32f9a6a7bf6456f31bb3a9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
<HTML>
<HEAD>
<!-- This HTML file has been created by texi2html 1.51
from gettext.texi on 19 April 2001 -->
<TITLE>GNU gettext utilities - Table of Contents</TITLE>
</HEAD>
<BODY>
<H1>GNU gettext tools, version 0.10.37</H1>
<H2>Native Language Support Library and Tools</H2>
<H2>Edition 0.10.37, 19 April 2001</H2>
<ADDRESS>Ulrich Drepper</ADDRESS>
<ADDRESS>Jim Meyering</ADDRESS>
<ADDRESS>Fran@,{c}ois Pinard</ADDRESS>
<P>
<P><HR><P>
<UL>
<LI><A NAME="TOC1" HREF="gettext_1.html#SEC1">1 Introduction</A>
<UL>
<LI><A NAME="TOC2" HREF="gettext_1.html#SEC2">1.1 The Purpose of GNU <CODE>gettext</CODE></A>
<LI><A NAME="TOC3" HREF="gettext_1.html#SEC3">1.2 I18n, L10n, and Such</A>
<LI><A NAME="TOC4" HREF="gettext_1.html#SEC4">1.3 Aspects in Native Language Support</A>
<LI><A NAME="TOC5" HREF="gettext_1.html#SEC5">1.4 Files Conveying Translations</A>
<LI><A NAME="TOC6" HREF="gettext_1.html#SEC6">1.5 Overview of GNU <CODE>gettext</CODE></A>
</UL>
<LI><A NAME="TOC7" HREF="gettext_2.html#SEC7">2 PO Files and PO Mode Basics</A>
<UL>
<LI><A NAME="TOC8" HREF="gettext_2.html#SEC8">2.1 Completing GNU <CODE>gettext</CODE> Installation</A>
<LI><A NAME="TOC9" HREF="gettext_2.html#SEC9">2.2 The Format of PO Files</A>
<LI><A NAME="TOC10" HREF="gettext_2.html#SEC10">2.3 Main PO mode Commands</A>
<LI><A NAME="TOC11" HREF="gettext_2.html#SEC11">2.4 Entry Positioning</A>
<LI><A NAME="TOC12" HREF="gettext_2.html#SEC12">2.5 Normalizing Strings in Entries</A>
</UL>
<LI><A NAME="TOC13" HREF="gettext_3.html#SEC13">3 Preparing Program Sources</A>
<UL>
<LI><A NAME="TOC14" HREF="gettext_3.html#SEC14">3.1 Triggering <CODE>gettext</CODE> Operations</A>
<LI><A NAME="TOC15" HREF="gettext_3.html#SEC15">3.2 How Marks Appear in Sources</A>
<LI><A NAME="TOC16" HREF="gettext_3.html#SEC16">3.3 Marking Translatable Strings</A>
<LI><A NAME="TOC17" HREF="gettext_3.html#SEC17">3.4 Special Comments preceding Keywords</A>
<LI><A NAME="TOC18" HREF="gettext_3.html#SEC18">3.5 Special Cases of Translatable Strings</A>
</UL>
<LI><A NAME="TOC19" HREF="gettext_4.html#SEC19">4 Making the PO Template File</A>
<UL>
<LI><A NAME="TOC20" HREF="gettext_4.html#SEC20">4.1 Invoking the <CODE>xgettext</CODE> Program</A>
</UL>
<LI><A NAME="TOC21" HREF="gettext_5.html#SEC21">5 Creating a New PO File</A>
<LI><A NAME="TOC22" HREF="gettext_6.html#SEC22">6 Updating Existing PO Files</A>
<UL>
<LI><A NAME="TOC23" HREF="gettext_6.html#SEC23">6.1 Invoking the <CODE>msgmerge</CODE> Program</A>
<LI><A NAME="TOC24" HREF="gettext_6.html#SEC24">6.2 Translated Entries</A>
<LI><A NAME="TOC25" HREF="gettext_6.html#SEC25">6.3 Fuzzy Entries</A>
<LI><A NAME="TOC26" HREF="gettext_6.html#SEC26">6.4 Untranslated Entries</A>
<LI><A NAME="TOC27" HREF="gettext_6.html#SEC27">6.5 Obsolete Entries</A>
<LI><A NAME="TOC28" HREF="gettext_6.html#SEC28">6.6 Modifying Translations</A>
<LI><A NAME="TOC29" HREF="gettext_6.html#SEC29">6.7 Modifying Comments</A>
<LI><A NAME="TOC30" HREF="gettext_6.html#SEC30">6.8 Details of Sub Edition</A>
<LI><A NAME="TOC31" HREF="gettext_6.html#SEC31">6.9 C Sources Context</A>
<LI><A NAME="TOC32" HREF="gettext_6.html#SEC32">6.10 Consulting Auxiliary PO Files</A>
<LI><A NAME="TOC33" HREF="gettext_6.html#SEC33">6.11 Using Translation Compendiums</A>
</UL>
<LI><A NAME="TOC34" HREF="gettext_7.html#SEC34">7 Producing Binary MO Files</A>
<UL>
<LI><A NAME="TOC35" HREF="gettext_7.html#SEC35">7.1 Invoking the <CODE>msgfmt</CODE> Program</A>
<LI><A NAME="TOC36" HREF="gettext_7.html#SEC36">7.2 The Format of GNU MO Files</A>
</UL>
<LI><A NAME="TOC37" HREF="gettext_8.html#SEC37">8 The User's View</A>
<UL>
<LI><A NAME="TOC38" HREF="gettext_8.html#SEC38">8.1 The Current <TT>`ABOUT-NLS'</TT> Matrix</A>
<LI><A NAME="TOC39" HREF="gettext_8.html#SEC39">8.2 Magic for Installers</A>
<LI><A NAME="TOC40" HREF="gettext_8.html#SEC40">8.3 Magic for End Users</A>
</UL>
<LI><A NAME="TOC41" HREF="gettext_9.html#SEC41">9 The Programmer's View</A>
<UL>
<LI><A NAME="TOC42" HREF="gettext_9.html#SEC42">9.1 About <CODE>catgets</CODE></A>
<UL>
<LI><A NAME="TOC43" HREF="gettext_9.html#SEC43">9.1.1 The Interface</A>
<LI><A NAME="TOC44" HREF="gettext_9.html#SEC44">9.1.2 Problems with the <CODE>catgets</CODE> Interface?!</A>
</UL>
<LI><A NAME="TOC45" HREF="gettext_9.html#SEC45">9.2 About <CODE>gettext</CODE></A>
<UL>
<LI><A NAME="TOC46" HREF="gettext_9.html#SEC46">9.2.1 The Interface</A>
<LI><A NAME="TOC47" HREF="gettext_9.html#SEC47">9.2.2 Solving Ambiguities</A>
<LI><A NAME="TOC48" HREF="gettext_9.html#SEC48">9.2.3 Locating Message Catalog Files</A>
<LI><A NAME="TOC49" HREF="gettext_9.html#SEC49">9.2.4 How to specify the output character set <CODE>gettext</CODE> uses</A>
<LI><A NAME="TOC50" HREF="gettext_9.html#SEC50">9.2.5 Additional functions for plural forms</A>
<LI><A NAME="TOC51" HREF="gettext_9.html#SEC51">9.2.6 How to use <CODE>gettext</CODE> in GUI programs</A>
<LI><A NAME="TOC52" HREF="gettext_9.html#SEC52">9.2.7 Optimization of the *gettext functions</A>
</UL>
<LI><A NAME="TOC53" HREF="gettext_9.html#SEC53">9.3 Comparing the Two Interfaces</A>
<LI><A NAME="TOC54" HREF="gettext_9.html#SEC54">9.4 Using libintl.a in own programs</A>
<LI><A NAME="TOC55" HREF="gettext_9.html#SEC55">9.5 Being a <CODE>gettext</CODE> grok</A>
<LI><A NAME="TOC56" HREF="gettext_9.html#SEC56">9.6 Temporary Notes for the Programmers Chapter</A>
<UL>
<LI><A NAME="TOC57" HREF="gettext_9.html#SEC57">9.6.1 Temporary - Two Possible Implementations</A>
<LI><A NAME="TOC58" HREF="gettext_9.html#SEC58">9.6.2 Temporary - About <CODE>catgets</CODE></A>
<LI><A NAME="TOC59" HREF="gettext_9.html#SEC59">9.6.3 Temporary - Why a single implementation</A>
<LI><A NAME="TOC60" HREF="gettext_9.html#SEC60">9.6.4 Temporary - Notes</A>
</UL>
</UL>
<LI><A NAME="TOC61" HREF="gettext_10.html#SEC61">10 The Translator's View</A>
<UL>
<LI><A NAME="TOC62" HREF="gettext_10.html#SEC62">10.1 Introduction 0</A>
<LI><A NAME="TOC63" HREF="gettext_10.html#SEC63">10.2 Introduction 1</A>
<LI><A NAME="TOC64" HREF="gettext_10.html#SEC64">10.3 Discussions</A>
<LI><A NAME="TOC65" HREF="gettext_10.html#SEC65">10.4 Organization</A>
<UL>
<LI><A NAME="TOC66" HREF="gettext_10.html#SEC66">10.4.1 Central Coordination</A>
<LI><A NAME="TOC67" HREF="gettext_10.html#SEC67">10.4.2 National Teams</A>
<UL>
<LI><A NAME="TOC68" HREF="gettext_10.html#SEC68">10.4.2.1 Sub-Cultures</A>
<LI><A NAME="TOC69" HREF="gettext_10.html#SEC69">10.4.2.2 Organizational Ideas</A>
</UL>
<LI><A NAME="TOC70" HREF="gettext_10.html#SEC70">10.4.3 Mailing Lists</A>
</UL>
<LI><A NAME="TOC71" HREF="gettext_10.html#SEC71">10.5 Information Flow</A>
</UL>
<LI><A NAME="TOC72" HREF="gettext_11.html#SEC72">11 The Maintainer's View</A>
<UL>
<LI><A NAME="TOC73" HREF="gettext_11.html#SEC73">11.1 Flat or Non-Flat Directory Structures</A>
<LI><A NAME="TOC74" HREF="gettext_11.html#SEC74">11.2 Prerequisite Works</A>
<LI><A NAME="TOC75" HREF="gettext_11.html#SEC75">11.3 Invoking the <CODE>gettextize</CODE> Program</A>
<LI><A NAME="TOC76" HREF="gettext_11.html#SEC76">11.4 Files You Must Create or Alter</A>
<UL>
<LI><A NAME="TOC77" HREF="gettext_11.html#SEC77">11.4.1 <TT>`POTFILES.in'</TT> in <TT>`po/'</TT></A>
<LI><A NAME="TOC78" HREF="gettext_11.html#SEC78">11.4.2 <TT>`configure.in'</TT> at top level</A>
<LI><A NAME="TOC79" HREF="gettext_11.html#SEC79">11.4.3 <TT>`config.guess'</TT>, <TT>`config.sub'</TT> at top level</A>
<LI><A NAME="TOC80" HREF="gettext_11.html#SEC80">11.4.4 <TT>`aclocal.m4'</TT> at top level</A>
<LI><A NAME="TOC81" HREF="gettext_11.html#SEC81">11.4.5 <TT>`acconfig.h'</TT> at top level</A>
<LI><A NAME="TOC82" HREF="gettext_11.html#SEC82">11.4.6 <TT>`Makefile.in'</TT> at top level</A>
<LI><A NAME="TOC83" HREF="gettext_11.html#SEC83">11.4.7 <TT>`Makefile.in'</TT> in <TT>`src/'</TT></A>
</UL>
</UL>
<LI><A NAME="TOC84" HREF="gettext_12.html#SEC84">12 Concluding Remarks</A>
<UL>
<LI><A NAME="TOC85" HREF="gettext_12.html#SEC85">12.1 History of GNU <CODE>gettext</CODE></A>
<LI><A NAME="TOC86" HREF="gettext_12.html#SEC86">12.2 Related Readings</A>
</UL>
<LI><A NAME="TOC87" HREF="gettext_13.html#SEC87">A Language Codes</A>
<LI><A NAME="TOC88" HREF="gettext_14.html#SEC88">B Country Codes</A>
</UL>
<P><HR><P>
This document was generated on 19 April 2001 using the
<A HREF="http://wwwcn.cern.ch/dci/texi2html/">texi2html</A>
translator version 1.51.</P>
</BODY>
</HTML>
|