1                Short description of the source files
2                =====================================
3
4The msg* and xgettext programs.
5
6Bottom-up structure:
7
8str-list.h
9str-list.c
10                A list-of-immutable-strings type.
11
12dir-list.h
13dir-list.c
14                Management of the list of directories where PO files are
15                searched.
16
17file-list.h
18file-list.c
19                Reading a file list from a file. Used by those programs which
20                accept multiple file arguments and have a --files-from option.
21
22lang-table.h
23lang-table.c
24                Language names according to ISO 639.
25
26pos.h
27                Source file positions.
28
29message.h
30message.c
31                The message type, with many utility routines.
32                A list-of-messages type.
33                A list-of-lists-of-messages type.
34
35msgl-ascii.h
36msgl-ascii.c
37                Message list test for ASCII character set.
38
39po-error.h
40po-error.c
41po-xerror.h
42po-xerror.c
43                Error handling during writing and reading of PO files.
44
45+-------------- Writing PO files
46| write-catalog.h
47| write-catalog.c
48|               Output of a list-of-messages.
49| write-po.h
50| write-po.c
51|               Output of a list-of-messages to a PO file.
52| write-properties.h
53| write-properties.c
54|               Output of a list-of-messages to a Java .properties file.
55| write-stringtable.h
56| write-stringtable.c
57|               Output of a list-of-messages to a NeXTstep/GNUstep .strings
58|               file.
59+-------------- Writing PO files
60
61+-------------- Reading PO files
62| open-catalog.h
63| open-catalog.c
64|               Opening PO files for reading.
65|
66| po-charset.h
67| po-charset.c
68|               Charset handling while reading PO files.
69|
70| po-lex.h
71| po-lex.c
72|               Lexical analysis of PO files.
73|
74| read-catalog-abstract.h
75| po-gram.h
76| po-gram-gen.y
77| read-po.h
78| read-po.c
79| read-properties.h
80| read-properties.c
81| read-stringtable.h
82| read-stringtable.c
83| read-catalog-abstract.c
84|               Parsing of PO files and Java .properties and NeXTstep/GNUstep
85|              .strings files.
86|         read-catalog-abstract.h
87|                       General parser structure.
88|         po-gram.h
89|         po-gram-gen.y
90|                       Parsing of PO files, based on po-lex.{h,c}.
91|         read-po.h
92|         read-po.c
93|                       Parsing of PO files.
94|         read-properties.h
95|         read-properties.c
96|                       Parsing of Java .properties files.
97|         read-stringtable.h
98|         read-stringtable.c
99|                       Parsing of NeXTstep/GNUstep .strings files.
100|         read-catalog-abstract.c
101|                       Top-level parser functions and callbacks.
102|
103| read-catalog.h
104| read-catalog.c
105|               Reading of a PO file, returning a list-of-messages.
106|
107+-------------- Reading PO files
108
109msgl-iconv.h
110msgl-iconv.c
111                Convert a list-of-messages to another character encoding.
112
113msgl-cat.h
114msgl-cat.c
115                Concatenate message lists from several files, with handling
116                of duplicate msgids.
117
118msgcmp.c        Main source for the 'msgcmp' program.
119
120+-------------- The 'msgmerge' program
121| msgl-equal.h
122| msgl-equal.c
123|               Comparing two lists-of-messages.
124| plural-count.h
125| plural-count.c
126|               Extracting the plural count of a header of a lists-of-messages.
127| msgmerge.c
128|               Main source for the 'msgmerge' program.
129|
130+-------------- The 'msgmerge' program
131
132msgcomm.c       Main source for the 'msgcomm' program.
133msgattrib.c     Main source for the 'msgattrib' program.
134msgcat.c        Main source for the 'msgcat' program.
135msgconv.c       Main source for the 'msgconv' program.
136msguniq.c       Main source for the 'msguniq' program.
137
138msgl-charset.h
139msgl-charset.c
140                Compare the encoding of a list-of-messages with the locale
141                encoding.
142
143msgexec.c       Main source for the 'msgexec' program.
144msgfilter.c     Main source for the 'msgfilter' program.
145msggrep.c       Main source for the 'msggrep' program.
146
147+-------------- The 'msgen' program
148| msgl-english.h
149| msgl-english.c
150|               English message initialization.
151| msgen.c
152|               Main source for the 'msgen' program.
153|
154+-------------- The 'msgen' program
155
156po-time.h
157po-time.c
158                Create time stamps for use in PO/POT files.
159
160plural-table.h
161plural-table.c
162                Table of plural form formulas.
163
164+-------------- The 'msginit' program
165| hostname.c
166|               The 'hostname' program.
167| user-email.sh.in
168|               Determine the user's email address.
169| urlget.c
170|               The 'urlget' program.
171| project-id
172|               Determine the package's name.
173| msginit.c
174|               Main source for the 'msginit' program.
175|
176+-------------- The 'msginit' program
177
178+-------------- The 'msgunfmt' program
179| msgunfmt.h
180|               Declarations.
181| read-mo.h
182| read-mo.c
183|               Reading GNU .mo files.
184| read-java.h
185| read-java.c
186|               Reading Java ResourceBundle files.
187| read-csharp.h
188| read-csharp.c
189| msgunfmt.cs
190|               Reading C# satellite assemblies.
191| read-resources.h
192| read-resources.c
193| msgunfmt.cs
194|               Reading C# .resources files.
195| read-tcl.h
196| read-tcl.c
197| msgunfmt.tcl
198|               Reading Tcl .msg files.
199| msgunfmt.c
200|               Main source for the 'msgunfmt' program.
201|
202+-------------- The 'msgunfmt' program
203
204format.h        Declarations of the language dependent format string handlers.
205format-invalid.h  Declarations of some error messages for invalid strings.
206format-c.c             Format string handling for C.
207format-sh.c            Format string handling for Shell.
208format-python.c        Format string handling for Python.
209format-lisp.c          Format string handling for Common Lisp.
210format-elisp.c         Format string handling for Emacs Lisp.
211format-librep.c        Format string handling for librep.
212format-scheme.c        Format string handling for Scheme.
213format-java.c          Format string handling for Java.
214format-csharp.c        Format string handling for C#.
215format-awk.c           Format string handling for awk.
216format-pascal.c        Format string handling for Object Pascal.
217format-ycp.c           Format string handling for YCP.
218format-tcl.c           Format string handling for Tcl.
219format-perl.c          Format string handling for Perl.
220format-perl-brace.c    Format string handling for Perl, braced syntax.
221format-php.c           Format string handling for PHP.
222format-gcc-internal.c  Format string handling GCC internal.
223format-qt.c            Format string handling for Qt.
224format-boost.c         Format string handling for Boost.
225format.c        Table of the language dependent format string handlers.
226
227plural-exp.c
228                Parsing plural expressions.
229plural-eval.h
230plural-eval.c
231                Evaluating plural expressions.
232msgl-check.h
233msgl-check.c
234                Checking of messages.
235
236+-------------- The 'msgfmt' program
237| msgfmt.h
238|               Declarations.
239| write-mo.h
240| write-mo.c
241|               Generating GNU .mo files.
242| write-java.h
243| write-java.c
244|               Generating Java ResourceBundle files.
245| write-csharp.h
246| write-csharp.c
247|               Generating C# satellite assemblies.
248| write-resources.h
249| write-resources.c
250| msgfmt.cs
251|               Generating C# .resources files.
252| write-tcl.h
253| write-tcl.c
254|               Generating Tcl .msg files.
255| write-qt.h
256| write-qt.c
257|               Generating Qt .qm files.
258| msgfmt.c
259|               Main source for the 'msgfmt' program.
260|
261+-------------- The 'msgfmt' program
262
263+-------------- The 'xgettext' program
264| xgettext.h
265|               Declarations used by the backends.
266| x-c.h
267| x-c.c
268|               String extractor for C.
269| x-po.h
270| x-properties.h
271| x-stringtable.h
272| x-po.c
273|               String extractor from PO files and Java .properties and
274|               NeXTstep/GNUstep .strings files.
275| x-sh.h
276| x-sh.c
277|               String extractor for Shell.
278| x-python.h
279| x-python.c
280|               String extractor for Python.
281| x-lisp.h
282| x-lisp.c
283|               String extractor for Common Lisp.
284| x-elisp.h
285| x-elisp.c
286|               String extractor for Emacs Lisp.
287| x-librep.h
288| x-librep.c
289|               String extractor for librep.
290| x-scheme.h
291| x-scheme.c
292|               String extractor for Scheme.
293| x-smalltalk.h
294| x-smalltalk.c
295|               String extractor for Smalltalk.
296| x-java.h
297| x-java.c
298|               String extractor for Java.
299| x-csharp.h
300| x-csharp.c
301|               String extractor for C#.
302| x-awk.h
303| x-awk.c
304|               String extractor for awk.
305| x-ycp.h
306| x-ycp.c
307|               String extractor for YCP.
308| x-tcl.h
309| x-tcl.c
310|               String extractor for Tcl.
311| x-perl.h
312| x-perl.c
313|               String extractor for Perl.
314| x-php.h
315| x-php.c
316|               String extractor for PHP.
317| x-rst.h
318| x-rst.c
319|               String extractor from .rst files, for Object Pascal.
320| x-glade.h
321| x-glade.c
322|               String extractor from .glade files, GNOME GUI descriptions.
323| xgettext.c
324|               Main source for the 'xgettext' program.
325|
326+-------------- The 'xgettext' program
327