annotate intl/gmo.h @ 875:c4240e36806f trunk

[svn] - remove default rules override as it's no longer used here
author nenolod
date Fri, 24 Mar 2006 13:31:38 -0800
parents cb178e5ad177
children f12d7e208b43
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
1 /* Description of GNU message catalog format: general file layout.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
2 Copyright (C) 1995, 1997, 2000-2002 Free Software Foundation, Inc.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
3
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
4 This program is free software; you can redistribute it and/or modify it
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
5 under the terms of the GNU Library General Public License as published
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
6 by the Free Software Foundation; either version 2, or (at your option)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
7 any later version.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
8
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
12 Library General Public License for more details.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
13
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
14 You should have received a copy of the GNU Library General Public
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
15 License along with this program; if not, write to the Free Software
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
16 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
17 USA. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
18
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
19 #ifndef _GETTEXT_H
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
20 #define _GETTEXT_H 1
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
21
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
22 #include <limits.h>
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
23
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
24 /* @@ end of prolog @@ */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
25
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
26 /* The magic number of the GNU message catalog format. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
27 #define _MAGIC 0x950412de
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
28 #define _MAGIC_SWAPPED 0xde120495
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
29
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
30 /* Revision number of the currently used .mo (binary) file format. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
31 #define MO_REVISION_NUMBER 0
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
32
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
33 /* The following contortions are an attempt to use the C preprocessor
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
34 to determine an unsigned integral type that is 32 bits wide. An
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
35 alternative approach is to use autoconf's AC_CHECK_SIZEOF macro, but
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
36 as of version autoconf-2.13, the AC_CHECK_SIZEOF macro doesn't work
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
37 when cross-compiling. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
38
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
39 #if __STDC__
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
40 # define UINT_MAX_32_BITS 4294967295U
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
41 #else
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
42 # define UINT_MAX_32_BITS 0xFFFFFFFF
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
43 #endif
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
44
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
45 /* If UINT_MAX isn't defined, assume it's a 32-bit type.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
46 This should be valid for all systems GNU cares about because
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
47 that doesn't include 16-bit systems, and only modern systems
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
48 (that certainly have <limits.h>) have 64+-bit integral types. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
49
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
50 #ifndef UINT_MAX
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
51 # define UINT_MAX UINT_MAX_32_BITS
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
52 #endif
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
53
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
54 #if UINT_MAX == UINT_MAX_32_BITS
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
55 typedef unsigned nls_uint32;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
56 #else
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
57 # if USHRT_MAX == UINT_MAX_32_BITS
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
58 typedef unsigned short nls_uint32;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
59 # else
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
60 # if ULONG_MAX == UINT_MAX_32_BITS
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
61 typedef unsigned long nls_uint32;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
62 # else
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
63 /* The following line is intended to throw an error. Using #error is
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
64 not portable enough. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
65 "Cannot determine unsigned 32-bit data type."
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
66 # endif
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
67 # endif
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
68 #endif
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
69
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
70
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
71 /* Header for binary .mo file format. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
72 struct mo_file_header
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
73 {
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
74 /* The magic number. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
75 nls_uint32 magic;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
76 /* The revision number of the file format. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
77 nls_uint32 revision;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
78
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
79 /* The following are only used in .mo files with major revision 0. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
80
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
81 /* The number of strings pairs. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
82 nls_uint32 nstrings;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
83 /* Offset of table with start offsets of original strings. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
84 nls_uint32 orig_tab_offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
85 /* Offset of table with start offsets of translated strings. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
86 nls_uint32 trans_tab_offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
87 /* Size of hash table. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
88 nls_uint32 hash_tab_size;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
89 /* Offset of first hash table entry. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
90 nls_uint32 hash_tab_offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
91
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
92 /* The following are only used in .mo files with minor revision >= 1. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
93
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
94 /* The number of system dependent segments. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
95 nls_uint32 n_sysdep_segments;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
96 /* Offset of table describing system dependent segments. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
97 nls_uint32 sysdep_segments_offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
98 /* The number of system dependent strings pairs. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
99 nls_uint32 n_sysdep_strings;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
100 /* Offset of table with start offsets of original sysdep strings. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
101 nls_uint32 orig_sysdep_tab_offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
102 /* Offset of table with start offsets of translated sysdep strings. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
103 nls_uint32 trans_sysdep_tab_offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
104 };
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
105
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
106 /* Descriptor for static string contained in the binary .mo file. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
107 struct string_desc
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
108 {
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
109 /* Length of addressed string, not including the trailing NUL. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
110 nls_uint32 length;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
111 /* Offset of string in file. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
112 nls_uint32 offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
113 };
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
114
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
115 /* The following are only used in .mo files with minor revision >= 1. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
116
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
117 /* Descriptor for system dependent string segment. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
118 struct sysdep_segment
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
119 {
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
120 /* Length of addressed string, including the trailing NUL. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
121 nls_uint32 length;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
122 /* Offset of string in file. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
123 nls_uint32 offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
124 };
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
125
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
126 /* Descriptor for system dependent string. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
127 struct sysdep_string
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
128 {
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
129 /* Offset of static string segments in file. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
130 nls_uint32 offset;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
131 /* Alternating sequence of static and system dependent segments.
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
132 The last segment is a static segment, including the trailing NUL. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
133 struct segment_pair
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
134 {
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
135 /* Size of static segment. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
136 nls_uint32 segsize;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
137 /* Reference to system dependent string segment, or ~0 at the end. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
138 nls_uint32 sysdepref;
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
139 } segments[1];
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
140 };
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
141
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
142 /* Marker for the end of the segments[] array. This has the value 0xFFFFFFFF,
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
143 regardless whether 'int' is 16 bit, 32 bit, or 64 bit. */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
144 #define SEGMENTS_END ((nls_uint32) ~0)
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
145
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
146 /* @@ begin of epilog @@ */
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
147
cb178e5ad177 [svn] Import audacious source.
nenolod
parents:
diff changeset
148 #endif /* gettext.h */