1 /* -*- buffer-read-only: t -*- vi: set ro:
3 * DO NOT EDIT THIS FILE (usage-txt.h)
5 * It has been AutoGen-ed Saturday May 5, 2007 at 12:02:33 PM PDT
6 * From the definitions usage-txt.def
7 * and the template file usage-txt.tpl
9 * This file handles all the bookkeeping required for tracking all the little
10 * tiny strings used by the AutoOpts library. There are 113
11 * of them. This is not versioned because it is entirely internal to the
12 * library and accessed by client code only in a very well-controlled way:
13 * they may substitute translated strings using a procedure that steps through
14 * all the string pointers.
16 * AutoOpts is free software; you can redistribute it and/or
17 * modify it under the terms of the GNU Lesser General Public
18 * License as published by the Free Software Foundation; either
19 * version 2.1 of the License, or (at your option) any later version.
21 * AutoOpts is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
24 * Lesser General Public License for more details.
26 * You should have received a copy of the GNU Lesser General Public
27 * License along with AutoOpts. If not, write to:
28 * The Free Software Foundation, Inc.,
29 * 51 Franklin Street, Fifth Floor
30 * Boston, MA 02110-1301, USA.
32 #ifndef AUTOOPTS_USAGE_TXT_H_GUARD
33 #define AUTOOPTS_USAGE_TXT_H_GUARD
36 #define cch_t char const
39 * One structure to hold all the pointers to all the stringlets.
43 char* utpz_GnuBoolArg;
45 char* utpz_GnuKeyLArg;
48 cch_t* apz_str[ 108 ];
52 * Declare the global structure with all the pointers to translated
53 * strings. This is then used by the usage generation procedure.
55 extern usage_text_t option_usage_text;
57 #if defined(AUTOOPTS_INTERNAL) /* DEFINE ALL THE STRINGS = = = = = */
59 * Provide a mapping from a short name to fields in this structure.
61 #define zAO_Bad (option_usage_text.apz_str[ 0])
62 #define zAO_Big (option_usage_text.apz_str[ 1])
63 #define zAO_Err (option_usage_text.apz_str[ 2])
64 #define zAO_Sml (option_usage_text.apz_str[ 3])
65 #define zAll (option_usage_text.apz_str[ 4])
66 #define zAlt (option_usage_text.apz_str[ 5])
67 #define zAmbigKey (option_usage_text.apz_str[ 6])
68 #define zAmbiguous (option_usage_text.apz_str[ 7])
69 #define zArgsMust (option_usage_text.apz_str[ 8])
70 #define zAtMost (option_usage_text.apz_str[ 9])
71 #define zAuto (option_usage_text.apz_str[ 10])
72 #define zBadPipe (option_usage_text.apz_str[ 11])
73 #define zBadVerArg (option_usage_text.apz_str[ 12])
74 #define zCantFmt (option_usage_text.apz_str[ 13])
75 #define zCantSave (option_usage_text.apz_str[ 14])
76 #define zDefaultOpt (option_usage_text.apz_str[ 15])
77 #define zDis (option_usage_text.apz_str[ 16])
78 #define zEnab (option_usage_text.apz_str[ 17])
79 #define zEquiv (option_usage_text.apz_str[ 18])
80 #define zErrOnly (option_usage_text.apz_str[ 19])
81 #define zExamineFmt (option_usage_text.apz_str[ 20])
82 #define zFiveSpaces (option_usage_text.apz_str[ 21])
83 #define zFlagOkay (option_usage_text.apz_str[ 22])
84 #define zFmtFmt (option_usage_text.apz_str[ 23])
85 #define zForkFail (option_usage_text.apz_str[ 24])
86 #define zFSErrOptLoad (option_usage_text.apz_str[ 25])
87 #define zFSErrReadFile (option_usage_text.apz_str[ 26])
88 #define zGenshell (option_usage_text.apz_str[ 27])
89 #define zGnuBoolArg (option_usage_text.utpz_GnuBoolArg)
90 #define zGnuBreak (option_usage_text.apz_str[ 28])
91 #define zGnuKeyArg (option_usage_text.utpz_GnuKeyArg)
92 #define zGnuKeyLArg (option_usage_text.utpz_GnuKeyLArg)
93 #define zGnuNestArg (option_usage_text.apz_str[ 29])
94 #define zGnuNumArg (option_usage_text.utpz_GnuNumArg)
95 #define zGnuOptArg (option_usage_text.apz_str[ 30])
96 #define zGnuOptFmt (option_usage_text.apz_str[ 31])
97 #define zGnuStrArg (option_usage_text.utpz_GnuStrArg)
98 #define zIllOptChr (option_usage_text.apz_str[ 32])
99 #define zIllOptStr (option_usage_text.apz_str[ 33])
100 #define zIllegal (option_usage_text.apz_str[ 34])
101 #define zInvalOptDesc (option_usage_text.apz_str[ 35])
102 #define zKeyWords (option_usage_text.apz_str[ 36])
103 #define zLoadCooked (option_usage_text.apz_str[ 37])
104 #define zLoadKeep (option_usage_text.apz_str[ 38])
105 #define zLoadType (option_usage_text.apz_str[ 39])
106 #define zLoadUncooked (option_usage_text.apz_str[ 40])
107 #define zLtypeInteger (option_usage_text.apz_str[ 41])
108 #define zLtypeNest (option_usage_text.apz_str[ 42])
109 #define zLtypeString (option_usage_text.apz_str[ 43])
110 #define zLtypeBool (option_usage_text.apz_str[ 44])
111 #define zLtypeKeyword (option_usage_text.apz_str[ 45])
112 #define zLtypeSetMembership (option_usage_text.apz_str[ 46])
113 #define zMembers (option_usage_text.apz_str[ 47])
114 #define zMisArg (option_usage_text.apz_str[ 48])
115 #define zMultiEquiv (option_usage_text.apz_str[ 49])
116 #define zMust (option_usage_text.apz_str[ 50])
117 #define zNeedOne (option_usage_text.apz_str[ 51])
118 #define zNoArg (option_usage_text.apz_str[ 52])
119 #define zNoArgs (option_usage_text.apz_str[ 53])
120 #define zNoCreat (option_usage_text.apz_str[ 54])
121 #define zNoFlags (option_usage_text.apz_str[ 55])
122 #define zNoKey (option_usage_text.apz_str[ 56])
123 #define zNoLim (option_usage_text.apz_str[ 57])
124 #define zNoPreset (option_usage_text.apz_str[ 58])
125 #define zNoRq_NoShrtTtl (option_usage_text.apz_str[ 59])
126 #define zNoRq_ShrtTtl (option_usage_text.apz_str[ 60])
127 #define zNoStat (option_usage_text.apz_str[ 61])
128 #define zNoState (option_usage_text.apz_str[ 62])
129 #define zNone (option_usage_text.apz_str[ 63])
130 #define zNotDef (option_usage_text.apz_str[ 64])
131 #define zNotEnough (option_usage_text.apz_str[ 65])
132 #define zNotFile (option_usage_text.apz_str[ 66])
133 #define zNotNumber (option_usage_text.apz_str[ 67])
134 #define zNrmOptFmt (option_usage_text.apz_str[ 68])
135 #define zNumberOpt (option_usage_text.apz_str[ 69])
136 #define zOneSpace (option_usage_text.apz_str[ 70])
137 #define zOnlyOne (option_usage_text.apz_str[ 71])
138 #define zOptsOnly (option_usage_text.apz_str[ 72])
139 #define zPathFmt (option_usage_text.apz_str[ 73])
140 #define zPlsSendBugs (option_usage_text.apz_str[ 74])
141 #define zPreset (option_usage_text.apz_str[ 75])
142 #define zPresetFile (option_usage_text.apz_str[ 76])
143 #define zPresetIntro (option_usage_text.apz_str[ 77])
144 #define zProg (option_usage_text.apz_str[ 78])
145 #define zProhib (option_usage_text.apz_str[ 79])
146 #define zReorder (option_usage_text.apz_str[ 80])
147 #define zReqFmt (option_usage_text.apz_str[ 81])
148 #define zReqOptFmt (option_usage_text.apz_str[ 82])
149 #define zReqThese (option_usage_text.apz_str[ 83])
150 #define zReq_NoShrtTtl (option_usage_text.apz_str[ 84])
151 #define zReq_ShrtTtl (option_usage_text.apz_str[ 85])
152 #define zSepChars (option_usage_text.apz_str[ 86])
153 #define zSetMembers (option_usage_text.apz_str[ 87])
154 #define zSetMemberSettings (option_usage_text.apz_str[ 88])
155 #define zShrtGnuOptFmt (option_usage_text.apz_str[ 89])
156 #define zSixSpaces (option_usage_text.apz_str[ 90])
157 #define zStdBoolArg (option_usage_text.apz_str[ 91])
158 #define zStdBreak (option_usage_text.apz_str[ 92])
159 #define zStdKeyArg (option_usage_text.apz_str[ 93])
160 #define zStdKeyLArg (option_usage_text.apz_str[ 94])
161 #define zStdNestArg (option_usage_text.apz_str[ 95])
162 #define zStdNoArg (option_usage_text.apz_str[ 96])
163 #define zStdNumArg (option_usage_text.apz_str[ 97])
164 #define zStdOptArg (option_usage_text.apz_str[ 98])
165 #define zStdReqArg (option_usage_text.apz_str[ 99])
166 #define zStdStrArg (option_usage_text.apz_str[100])
167 #define zTabHyp (option_usage_text.apz_str[101])
168 #define zTabHypAnd (option_usage_text.apz_str[102])
169 #define zTabout (option_usage_text.apz_str[103])
170 #define zThreeSpaces (option_usage_text.apz_str[104])
171 #define zTwoSpaces (option_usage_text.apz_str[105])
172 #define zUpTo (option_usage_text.apz_str[106])
173 #define zValidKeys (option_usage_text.apz_str[107])
176 * First, set up the strings. Some of these are writable. These are all in
177 * English. This gets compiled into libopts and is distributed here so that
178 * xgettext (or equivalents) can extract these strings for translation.
181 static char eng_zGnuBoolArg[] = "=T/F";
182 static char eng_zGnuKeyArg[] = "=KWd";
183 static char eng_zGnuKeyLArg[] = "=Mbr";
184 static char eng_zGnuNumArg[] = "=num";
185 static char eng_zGnuStrArg[] = "=str";
186 static char const usage_txt[3208] =
187 "AutoOpts function called without option descriptor\n\0"
188 "\tThis exceeds the compiled library version: \0"
189 "Automated Options Processing Error!\n"
190 "\t%s called AutoOpts function with structure version %d:%d:%d.\n\0"
191 "\tThis is less than the minimum library version: \0"
193 "\t\t\t\t- an alternate for %s\n\0"
194 "%s error: the keyword `%s' is ambiguous for %s\n\0"
196 "%s: Command line arguments required\n\0"
197 "%d %s%s options allowed\n\0"
198 "version and help options:\0"
199 "Error %d (%s) from the pipe(2) syscall\n\0"
200 "ERROR: version option argument '%c' invalid. Use:\n"
201 "\t'v' - version only\n"
202 "\t'c' - version and copyright\n"
203 "\t'n' - version and copyright notice\n\0"
204 "ERROR: %s option conflicts with the %s option\n\0"
205 "%s(optionSaveState): error: cannot allocate %d bytes\n\0"
206 "\t\t\t\t- default option for unnamed options\n\0"
207 "\t\t\t\t- disabled as --%s\n\0"
208 "\t\t\t\t- enabled by default\n\0"
211 " - examining environment variables named %s_*\n\0"
213 "Options are specified by doubled hyphens and their name\n"
214 "or by a single hyphen and the flag character.\n\0"
216 "fs error %d (%s) on fork - cannot obtain %s usage\n\0"
217 "File error %d (%s) opening %s for loading options\n\0"
218 "fs error %d (%s) reading file %s\n\0"
220 "= = = = = = = =\n\n"
221 "This incarnation of genshell will produce\n"
222 "a shell script to parse the options for %s:\n\n\0"
228 "%s: illegal option -- %c\n\0"
229 "%s: %s option -- %s\n\0"
231 "AutoOpts ERROR: invalid option descriptor for %s\n\0"
243 "\t\t\t\t- is a set membership option\n\0"
244 "%s: option `%s' requires an argument\n\0"
245 "Equivalenced option '%s' was equivalenced to both\n"
247 "\t\t\t\t- must appear between %d and %d times\n\0"
248 "ERROR: The %s option is required\n\0"
249 "%s: option `%s' cannot have an argument\n\0"
250 "%s: Command line arguments not allowed\n\0"
251 "error %d (%s) creating %s\n\0"
252 "Options are specified by single or double hyphens and their name.\n\0"
253 "%s error: `%s' does not match any %s keywords\n\0"
254 "\t\t\t\t- may appear multiple times\n\0"
255 "\t\t\t\t- may not be preset\n\0"
256 " Arg Option-Name Description\n\0"
257 " Flg Arg Option-Name Description\n\0"
258 "error %d (%s) stat-ing %s\n\0"
259 "%s(optionRestore): error: no saved option state\n\0"
261 "'%s' not defined\n\0"
262 "ERROR: The %s option must appear %d times\n\0"
263 "error: cannot load options from non-regular file %s\n\0"
264 "%s error: `%s' is not a recognizable number\n\0"
266 "The '-#<number>' option may omit the hash char\n\0"
268 "one %s%s option allowed\n\0"
269 "All arguments are named options.\n\0"
270 " - reading file %s\0"
272 "please send bug reports to: %s\n\0"
273 "\t\t\t\t- may NOT appear - preset only\n\0"
274 "# preset/initialization file\n"
277 "The following option preset mechanisms are supported:\n\0"
279 "prohibits these options:\n\0"
280 "Operands and options may be intermixed. They will be reordered.\n\0"
281 "ERROR: %s option requires the %s option\n\0"
283 "requires these options:\n\0"
284 " Arg Option-Name Req? Description\n\0"
285 " Flg Arg Option-Name Req? Description\n\0"
288 "or you may use a numeric representation. Preceding these with a '!' will\n"
289 "clear the bits, specifying 'none' will clear all bits, and 'all' will set them\n"
290 "all. Multiple entries may be passed as an option argument list.\n\0"
310 "\t\t\t\t- may appear up to %d times\n\0"
311 "The valid \"%s\" option keywords are:\n\0";
315 * Now, define (and initialize) the structure that contains
316 * the pointers to all these strings.
317 * Aren't you glad you don't maintain this by hand?
319 usage_text_t option_usage_text = {
321 eng_zGnuBoolArg, eng_zGnuKeyArg, eng_zGnuKeyLArg, eng_zGnuNumArg,
324 usage_txt + 0, usage_txt + 52, usage_txt + 98, usage_txt + 197,
325 usage_txt + 247, usage_txt + 251, usage_txt + 278, usage_txt + 327,
326 usage_txt + 337, usage_txt + 374, usage_txt + 399, usage_txt + 425,
327 usage_txt + 465, usage_txt + 602, usage_txt + 650, usage_txt + 704,
328 usage_txt + 746, usage_txt + 770, usage_txt + 796, usage_txt + 809,
329 usage_txt + 823, usage_txt + 870, usage_txt + 876, usage_txt + 979,
330 usage_txt + 991, usage_txt +1042, usage_txt +1093, usage_txt +1127,
331 usage_txt +1233, usage_txt +1239, usage_txt +1245, usage_txt +1252,
332 usage_txt +1263, usage_txt +1289, usage_txt +1310, usage_txt +1318,
333 usage_txt +1369, usage_txt +1376, usage_txt +1383, usage_txt +1388,
334 usage_txt +1394, usage_txt +1403, usage_txt +1411, usage_txt +1418,
335 usage_txt +1425, usage_txt +1430, usage_txt +1438, usage_txt +1442,
336 usage_txt +1476, usage_txt +1514, usage_txt +1579, usage_txt +1622,
337 usage_txt +1657, usage_txt +1698, usage_txt +1738, usage_txt +1765,
338 usage_txt +1832, usage_txt +1880, usage_txt +1913, usage_txt +1938,
339 usage_txt +1973, usage_txt +2011, usage_txt +2038, usage_txt +2087,
340 usage_txt +2092, usage_txt +2110, usage_txt +2154, usage_txt +2208,
341 usage_txt +2254, usage_txt +2262, usage_txt +2310, usage_txt +2312,
342 usage_txt +2337, usage_txt +2371, usage_txt +2390, usage_txt +2424,
343 usage_txt +2460, usage_txt +2498, usage_txt +2554, usage_txt +2562,
344 usage_txt +2588, usage_txt +2654, usage_txt +2696, usage_txt +2710,
345 usage_txt +2735, usage_txt +2775, usage_txt +2818, usage_txt +2822,
346 usage_txt +2831, usage_txt +3050, usage_txt +3053, usage_txt +3060,
347 usage_txt +3064, usage_txt +3072, usage_txt +3076, usage_txt +3080,
348 usage_txt +3084, usage_txt +3088, usage_txt +3092, usage_txt +3096,
349 usage_txt +3100, usage_txt +3104, usage_txt +3111, usage_txt +3123,
350 usage_txt +3131, usage_txt +3135, usage_txt +3138, usage_txt +3171
354 #endif /* DO_TRANSLATIONS */
355 #endif /* AUTOOPTS_USAGE_TXT_H_GUARD */