]> Creatis software - clitk.git/blob - cmake/gengetopt/skels/header.cc
Adapt CMakeLists to include it from other projects
[clitk.git] / cmake / gengetopt / skels / header.cc
1 /*
2  * File automatically generated by
3  * gengen 1.4 by Lorenzo Bettini 
4  * http://www.gnu.org/software/gengen
5  */
6
7 #include "header.h"
8
9 void
10 header_gen_class::generate_header(ostream &stream, unsigned int indent)
11 {
12   string indent_str (indent, ' ');
13   indent = 0;
14
15   stream << "/** ";
16   stream << "@";
17   stream << "file ";
18   generate_string (header_file_name, stream, indent + indent_str.length ());
19   stream << ".";
20   generate_string (header_file_ext, stream, indent + indent_str.length ());
21   stream << "\n";
22   stream << indent_str;
23   stream << " *  ";
24   stream << "@";
25   stream << "brief The header file for the command line option parser";
26   stream << "\n";
27   stream << indent_str;
28   stream << " *  generated by GNU Gengetopt ";
29   generate_string (generator_version, stream, indent + indent_str.length ());
30   stream << "\n";
31   stream << indent_str;
32   stream << " *  http://www.gnu.org/software/gengetopt.";
33   stream << "\n";
34   stream << indent_str;
35   stream << " *  DO NOT modify this file, since it can be overwritten";
36   stream << "\n";
37   stream << indent_str;
38   stream << " *  ";
39   stream << "@";
40   stream << "author GNU Gengetopt by Lorenzo Bettini */";
41   stream << "\n";
42   stream << indent_str;
43   stream << "\n";
44   stream << indent_str;
45   stream << "#ifndef ";
46   generate_string (ifndefname, stream, indent + indent_str.length ());
47   stream << "_H";
48   stream << "\n";
49   stream << indent_str;
50   stream << "#define ";
51   generate_string (ifndefname, stream, indent + indent_str.length ());
52   stream << "_H";
53   stream << "\n";
54   stream << indent_str;
55   stream << "\n";
56   stream << indent_str;
57   stream << "/* If we use autoconf.  */";
58   stream << "\n";
59   stream << indent_str;
60   stream << "#ifdef HAVE_CONFIG_H";
61   stream << "\n";
62   stream << indent_str;
63   stream << "#include \"config.h\"";
64   stream << "\n";
65   stream << indent_str;
66   stream << "#endif";
67   stream << "\n";
68   stream << indent_str;
69   stream << "\n";
70   stream << indent_str;
71   stream << "#include <stdio.h> /* for FILE */";
72   stream << "\n";
73   stream << indent_str;
74   stream << "\n";
75   stream << indent_str;
76   stream << "#ifdef __cplusplus";
77   stream << "\n";
78   stream << indent_str;
79   stream << "extern \"C\" {";
80   stream << "\n";
81   stream << indent_str;
82   stream << "#endif /* __cplusplus */";
83   stream << "\n";
84   stream << indent_str;
85   stream << "\n";
86   stream << indent_str;
87   stream << "#ifndef ";
88   generate_string (package_var_name, stream, indent + indent_str.length ());
89   stream << "\n";
90   stream << indent_str;
91   stream << "/** ";
92   stream << "@";
93   stream << "brief the program name (used for printing errors) */";
94   stream << "\n";
95   stream << indent_str;
96   stream << "#define ";
97   generate_string (package_var_name, stream, indent + indent_str.length ());
98   stream << " ";
99   generate_string (package_var_val, stream, indent + indent_str.length ());
100   stream << "\n";
101   stream << indent_str;
102   stream << "#endif";
103   stream << "\n";
104   stream << indent_str;
105   stream << "\n";
106   stream << indent_str;
107   stream << "#ifndef ";
108   generate_string (package_var_name, stream, indent + indent_str.length ());
109   stream << "_NAME";
110   stream << "\n";
111   stream << indent_str;
112   stream << "/** ";
113   stream << "@";
114   stream << "brief the complete program name (used for help and version) */";
115   stream << "\n";
116   stream << indent_str;
117   if (( package_var_val != "PACKAGE" ))
118     {
119       stream << "#define ";
120       generate_string (package_var_name, stream, indent + indent_str.length ());
121       stream << "_NAME ";
122       generate_string (package_var_val, stream, indent + indent_str.length ());
123       stream << "\n";
124       stream << indent_str;
125     }
126   else
127     {
128       stream << "#ifdef PACKAGE_NAME";
129       stream << "\n";
130       stream << indent_str;
131       stream << "#define ";
132       generate_string (package_var_name, stream, indent + indent_str.length ());
133       stream << "_NAME PACKAGE_NAME";
134       stream << "\n";
135       stream << indent_str;
136       stream << "#else";
137       stream << "\n";
138       stream << indent_str;
139       stream << "#define ";
140       generate_string (package_var_name, stream, indent + indent_str.length ());
141       stream << "_NAME PACKAGE";
142       stream << "\n";
143       stream << indent_str;
144       stream << "#endif";
145       stream << "\n";
146       stream << indent_str;
147     }
148   stream << "#endif";
149   stream << "\n";
150   stream << indent_str;
151   stream << "\n";
152   stream << indent_str;
153   stream << "#ifndef ";
154   generate_string (version_var_name, stream, indent + indent_str.length ());
155   stream << "\n";
156   stream << indent_str;
157   stream << "/** ";
158   stream << "@";
159   stream << "brief the program version */";
160   stream << "\n";
161   stream << indent_str;
162   stream << "#define ";
163   generate_string (version_var_name, stream, indent + indent_str.length ());
164   stream << " ";
165   generate_string (version_var_val, stream, indent + indent_str.length ());
166   stream << "\n";
167   stream << indent_str;
168   stream << "#endif";
169   stream << "\n";
170   stream << indent_str;
171   if (enum_types.size () > 0)
172     generate_string (enum_types, stream, indent + indent_str.length ());
173   else
174     generate_enum_types (stream, indent + indent_str.length ());
175   stream << indent_str;
176   stream << "\n";
177   stream << indent_str;
178   stream << "/** ";
179   stream << "@";
180   stream << "brief Where the command line options are stored */";
181   stream << "\n";
182   stream << indent_str;
183   stream << "struct ";
184   generate_string (args_info, stream, indent + indent_str.length ());
185   stream << "\n";
186   stream << indent_str;
187   stream << "{";
188   stream << "\n";
189   stream << indent_str;
190   indent = 2;
191   stream << "  ";
192   if (option_arg.size () > 0)
193     generate_string (option_arg, stream, indent + indent_str.length ());
194   else
195     generate_option_arg (stream, indent + indent_str.length ());
196   indent = 0;
197   stream << "\n";
198   stream << indent_str;
199   indent = 2;
200   stream << "  ";
201   if (option_given.size () > 0)
202     generate_string (option_given, stream, indent + indent_str.length ());
203   else
204     generate_option_given (stream, indent + indent_str.length ());
205   indent = 0;
206   stream << "\n";
207   stream << indent_str;
208   indent = 2;
209   if (group_counters.size () > 0)
210     generate_string (group_counters, stream, indent + indent_str.length ());
211   else
212     generate_group_counters (stream, indent + indent_str.length ());
213   indent = 0;
214   stream << indent_str;
215   indent = 2;
216   if (mode_counters.size () > 0)
217     generate_string (mode_counters, stream, indent + indent_str.length ());
218   else
219     generate_mode_counters (stream, indent + indent_str.length ());
220   indent = 0;
221   stream << indent_str;
222   stream << "} ;";
223   stream << "\n";
224   stream << indent_str;
225   stream << "\n";
226   stream << indent_str;
227   stream << "/** ";
228   stream << "@";
229   stream << "brief The additional parameters to pass to parser functions */";
230   stream << "\n";
231   stream << indent_str;
232   stream << "struct ";
233   generate_string (parser_name, stream, indent + indent_str.length ());
234   stream << "_params";
235   stream << "\n";
236   stream << indent_str;
237   stream << "{";
238   stream << "\n";
239   stream << indent_str;
240   stream << "  int override; /**< ";
241   stream << "@";
242   stream << "brief whether to override possibly already present options (default 0) */";
243   stream << "\n";
244   stream << indent_str;
245   stream << "  int initialize; /**< ";
246   stream << "@";
247   stream << "brief whether to initialize the option structure ";
248   generate_string (args_info, stream, indent + indent_str.length ());
249   stream << " (default 1) */";
250   stream << "\n";
251   stream << indent_str;
252   stream << "  int check_required; /**< ";
253   stream << "@";
254   stream << "brief whether to check that all required options were provided (default 1) */";
255   stream << "\n";
256   stream << indent_str;
257   stream << "  int check_ambiguity; /**< ";
258   stream << "@";
259   stream << "brief whether to check for options already specified in the option structure ";
260   generate_string (args_info, stream, indent + indent_str.length ());
261   stream << " (default 0) */";
262   stream << "\n";
263   stream << indent_str;
264   stream << "  int print_errors; /**< ";
265   stream << "@";
266   stream << "brief whether getopt_long should print an error message for a bad option (default 1) */";
267   stream << "\n";
268   stream << indent_str;
269   stream << "} ;";
270   stream << "\n";
271   stream << indent_str;
272   stream << "\n";
273   stream << indent_str;
274   stream << "/** ";
275   stream << "@";
276   stream << "brief the purpose string of the program */";
277   stream << "\n";
278   stream << indent_str;
279   stream << "extern const char *";
280   generate_string (args_info, stream, indent + indent_str.length ());
281   stream << "_purpose;";
282   stream << "\n";
283   stream << indent_str;
284   stream << "/** ";
285   stream << "@";
286   stream << "brief the usage string of the program */";
287   stream << "\n";
288   stream << indent_str;
289   stream << "extern const char *";
290   generate_string (args_info, stream, indent + indent_str.length ());
291   stream << "_usage;";
292   stream << "\n";
293   stream << indent_str;
294   stream << "/** ";
295   stream << "@";
296   stream << "brief all the lines making the help output */";
297   stream << "\n";
298   stream << indent_str;
299   stream << "extern const char *";
300   generate_string (args_info, stream, indent + indent_str.length ());
301   stream << "_help[];";
302   stream << "\n";
303   stream << indent_str;
304   if (has_hidden)
305     {
306       stream << "/** ";
307       stream << "@";
308       stream << "brief all the lines making the full help output (including hidden options) */";
309       stream << "\n";
310       stream << indent_str;
311       stream << "extern const char *";
312       generate_string (args_info, stream, indent + indent_str.length ());
313       stream << "_full_help[];";
314       stream << "\n";
315       stream << indent_str;
316     }
317   if (has_details)
318     {
319       stream << "/** ";
320       stream << "@";
321       stream << "brief all the lines making the detailed help output (including hidden options and details) */";
322       stream << "\n";
323       stream << indent_str;
324       stream << "extern const char *";
325       generate_string (args_info, stream, indent + indent_str.length ());
326       stream << "_detailed_help[];";
327       stream << "\n";
328       stream << indent_str;
329     }
330   stream << "\n";
331   stream << indent_str;
332   stream << "/**";
333   stream << "\n";
334   stream << indent_str;
335   stream << " * The command line parser";
336   stream << "\n";
337   stream << indent_str;
338   stream << " * ";
339   stream << "@";
340   stream << "param argc the number of command line options";
341   stream << "\n";
342   stream << indent_str;
343   stream << " * ";
344   stream << "@";
345   stream << "param argv the command line options";
346   stream << "\n";
347   stream << indent_str;
348   stream << " * ";
349   stream << "@";
350   stream << "param args_info the structure where option information will be stored";
351   stream << "\n";
352   stream << indent_str;
353   stream << " * ";
354   stream << "@";
355   stream << "return 0 if everything went fine, NON 0 if an error took place";
356   stream << "\n";
357   stream << indent_str;
358   stream << " */";
359   stream << "\n";
360   stream << indent_str;
361   stream << "int ";
362   generate_string (parser_name, stream, indent + indent_str.length ());
363   stream << " (int argc, char **argv,";
364   stream << "\n";
365   stream << indent_str;
366   stream << "  struct ";
367   generate_string (args_info, stream, indent + indent_str.length ());
368   stream << " *args_info);";
369   stream << "\n";
370   stream << indent_str;
371   stream << "\n";
372   stream << indent_str;
373   stream << "/**";
374   stream << "\n";
375   stream << indent_str;
376   stream << " * The command line parser (version with additional parameters - deprecated)";
377   stream << "\n";
378   stream << indent_str;
379   stream << " * ";
380   stream << "@";
381   stream << "param argc the number of command line options";
382   stream << "\n";
383   stream << indent_str;
384   stream << " * ";
385   stream << "@";
386   stream << "param argv the command line options";
387   stream << "\n";
388   stream << indent_str;
389   stream << " * ";
390   stream << "@";
391   stream << "param args_info the structure where option information will be stored";
392   stream << "\n";
393   stream << indent_str;
394   stream << " * ";
395   stream << "@";
396   stream << "param override whether to override possibly already present options";
397   stream << "\n";
398   stream << indent_str;
399   stream << " * ";
400   stream << "@";
401   stream << "param initialize whether to initialize the option structure my_args_info";
402   stream << "\n";
403   stream << indent_str;
404   stream << " * ";
405   stream << "@";
406   stream << "param check_required whether to check that all required options were provided";
407   stream << "\n";
408   stream << indent_str;
409   stream << " * ";
410   stream << "@";
411   stream << "return 0 if everything went fine, NON 0 if an error took place";
412   stream << "\n";
413   stream << indent_str;
414   stream << " * ";
415   stream << "@";
416   stream << "deprecated use ";
417   generate_string (parser_name, stream, indent + indent_str.length ());
418   stream << "_ext() instead";
419   stream << "\n";
420   stream << indent_str;
421   stream << " */";
422   stream << "\n";
423   stream << indent_str;
424   stream << "int ";
425   generate_string (parser_name, stream, indent + indent_str.length ());
426   stream << "2 (int argc, char **argv,";
427   stream << "\n";
428   stream << indent_str;
429   stream << "  struct ";
430   generate_string (args_info, stream, indent + indent_str.length ());
431   stream << " *args_info,";
432   stream << "\n";
433   stream << indent_str;
434   stream << "  int override, int initialize, int check_required);";
435   stream << "\n";
436   stream << indent_str;
437   stream << "\n";
438   stream << indent_str;
439   stream << "/**";
440   stream << "\n";
441   stream << indent_str;
442   stream << " * The command line parser (version with additional parameters)";
443   stream << "\n";
444   stream << indent_str;
445   stream << " * ";
446   stream << "@";
447   stream << "param argc the number of command line options";
448   stream << "\n";
449   stream << indent_str;
450   stream << " * ";
451   stream << "@";
452   stream << "param argv the command line options";
453   stream << "\n";
454   stream << indent_str;
455   stream << " * ";
456   stream << "@";
457   stream << "param args_info the structure where option information will be stored";
458   stream << "\n";
459   stream << indent_str;
460   stream << " * ";
461   stream << "@";
462   stream << "param params additional parameters for the parser";
463   stream << "\n";
464   stream << indent_str;
465   stream << " * ";
466   stream << "@";
467   stream << "return 0 if everything went fine, NON 0 if an error took place";
468   stream << "\n";
469   stream << indent_str;
470   stream << " */";
471   stream << "\n";
472   stream << indent_str;
473   stream << "int ";
474   generate_string (parser_name, stream, indent + indent_str.length ());
475   stream << "_ext (int argc, char **argv,";
476   stream << "\n";
477   stream << indent_str;
478   stream << "  struct ";
479   generate_string (args_info, stream, indent + indent_str.length ());
480   stream << " *args_info,";
481   stream << "\n";
482   stream << indent_str;
483   stream << "  struct ";
484   generate_string (parser_name, stream, indent + indent_str.length ());
485   stream << "_params *params);";
486   stream << "\n";
487   stream << indent_str;
488   stream << "\n";
489   stream << indent_str;
490   stream << "/**";
491   stream << "\n";
492   stream << indent_str;
493   stream << " * Save the contents of the option struct into an already open FILE stream.";
494   stream << "\n";
495   stream << indent_str;
496   stream << " * ";
497   stream << "@";
498   stream << "param outfile the stream where to dump options";
499   stream << "\n";
500   stream << indent_str;
501   stream << " * ";
502   stream << "@";
503   stream << "param args_info the option struct to dump";
504   stream << "\n";
505   stream << indent_str;
506   stream << " * ";
507   stream << "@";
508   stream << "return 0 if everything went fine, NON 0 if an error took place";
509   stream << "\n";
510   stream << indent_str;
511   stream << " */";
512   stream << "\n";
513   stream << indent_str;
514   stream << "int ";
515   generate_string (parser_name, stream, indent + indent_str.length ());
516   stream << "_dump(FILE *outfile,";
517   stream << "\n";
518   stream << indent_str;
519   stream << "  struct ";
520   generate_string (args_info, stream, indent + indent_str.length ());
521   stream << " *args_info);";
522   stream << "\n";
523   stream << indent_str;
524   stream << "\n";
525   stream << indent_str;
526   stream << "/**";
527   stream << "\n";
528   stream << indent_str;
529   stream << " * Save the contents of the option struct into a (text) file.";
530   stream << "\n";
531   stream << indent_str;
532   stream << " * This file can be read by the config file parser (if generated by gengetopt)";
533   stream << "\n";
534   stream << indent_str;
535   stream << " * ";
536   stream << "@";
537   stream << "param filename the file where to save";
538   stream << "\n";
539   stream << indent_str;
540   stream << " * ";
541   stream << "@";
542   stream << "param args_info the option struct to save";
543   stream << "\n";
544   stream << indent_str;
545   stream << " * ";
546   stream << "@";
547   stream << "return 0 if everything went fine, NON 0 if an error took place";
548   stream << "\n";
549   stream << indent_str;
550   stream << " */";
551   stream << "\n";
552   stream << indent_str;
553   stream << "int ";
554   generate_string (parser_name, stream, indent + indent_str.length ());
555   stream << "_file_save(const char *filename,";
556   stream << "\n";
557   stream << indent_str;
558   stream << "  struct ";
559   generate_string (args_info, stream, indent + indent_str.length ());
560   stream << " *args_info);";
561   stream << "\n";
562   stream << indent_str;
563   stream << "\n";
564   stream << indent_str;
565   stream << "/**";
566   stream << "\n";
567   stream << indent_str;
568   stream << " * Print the help";
569   stream << "\n";
570   stream << indent_str;
571   stream << " */";
572   stream << "\n";
573   stream << indent_str;
574   stream << "void ";
575   generate_string (parser_name, stream, indent + indent_str.length ());
576   stream << "_print_help(void);";
577   stream << "\n";
578   stream << indent_str;
579   if (has_hidden)
580     {
581       stream << "/**";
582       stream << "\n";
583       stream << indent_str;
584       stream << " * Print the full help (including hidden options)";
585       stream << "\n";
586       stream << indent_str;
587       stream << " */";
588       stream << "\n";
589       stream << indent_str;
590       stream << "void ";
591       generate_string (parser_name, stream, indent + indent_str.length ());
592       stream << "_print_full_help(void);";
593       stream << "\n";
594       stream << indent_str;
595     }
596   if (has_details)
597     {
598       stream << "/**";
599       stream << "\n";
600       stream << indent_str;
601       stream << " * Print the detailed help (including hidden options and details)";
602       stream << "\n";
603       stream << indent_str;
604       stream << " */";
605       stream << "\n";
606       stream << indent_str;
607       stream << "void ";
608       generate_string (parser_name, stream, indent + indent_str.length ());
609       stream << "_print_detailed_help(void);";
610       stream << "\n";
611       stream << indent_str;
612     }
613   stream << "/**";
614   stream << "\n";
615   stream << indent_str;
616   stream << " * Print the version";
617   stream << "\n";
618   stream << indent_str;
619   stream << " */";
620   stream << "\n";
621   stream << indent_str;
622   stream << "void ";
623   generate_string (parser_name, stream, indent + indent_str.length ());
624   stream << "_print_version(void);";
625   stream << "\n";
626   stream << indent_str;
627   stream << "\n";
628   stream << indent_str;
629   stream << "/**";
630   stream << "\n";
631   stream << indent_str;
632   stream << " * Initializes all the fields a ";
633   generate_string (parser_name, stream, indent + indent_str.length ());
634   stream << "_params structure ";
635   stream << "\n";
636   stream << indent_str;
637   stream << " * to their default values";
638   stream << "\n";
639   stream << indent_str;
640   stream << " * ";
641   stream << "@";
642   stream << "param params the structure to initialize";
643   stream << "\n";
644   stream << indent_str;
645   stream << " */";
646   stream << "\n";
647   stream << indent_str;
648   stream << "void ";
649   generate_string (parser_name, stream, indent + indent_str.length ());
650   stream << "_params_init(struct ";
651   generate_string (parser_name, stream, indent + indent_str.length ());
652   stream << "_params *params);";
653   stream << "\n";
654   stream << indent_str;
655   stream << "\n";
656   stream << indent_str;
657   stream << "/**";
658   stream << "\n";
659   stream << indent_str;
660   stream << " * Allocates dynamically a ";
661   generate_string (parser_name, stream, indent + indent_str.length ());
662   stream << "_params structure and initializes";
663   stream << "\n";
664   stream << indent_str;
665   stream << " * all its fields to their default values";
666   stream << "\n";
667   stream << indent_str;
668   stream << " * ";
669   stream << "@";
670   stream << "return the created and initialized ";
671   generate_string (parser_name, stream, indent + indent_str.length ());
672   stream << "_params structure";
673   stream << "\n";
674   stream << indent_str;
675   stream << " */";
676   stream << "\n";
677   stream << indent_str;
678   stream << "struct ";
679   generate_string (parser_name, stream, indent + indent_str.length ());
680   stream << "_params *";
681   generate_string (parser_name, stream, indent + indent_str.length ());
682   stream << "_params_create(void);";
683   stream << "\n";
684   stream << indent_str;
685   stream << "\n";
686   stream << indent_str;
687   stream << "/**";
688   stream << "\n";
689   stream << indent_str;
690   stream << " * Initializes the passed ";
691   generate_string (args_info, stream, indent + indent_str.length ());
692   stream << " structure's fields";
693   stream << "\n";
694   stream << indent_str;
695   stream << " * (also set default values for options that have a default)";
696   stream << "\n";
697   stream << indent_str;
698   stream << " * ";
699   stream << "@";
700   stream << "param args_info the structure to initialize";
701   stream << "\n";
702   stream << indent_str;
703   stream << " */";
704   stream << "\n";
705   stream << indent_str;
706   stream << "void ";
707   generate_string (parser_name, stream, indent + indent_str.length ());
708   stream << "_init (struct ";
709   generate_string (args_info, stream, indent + indent_str.length ());
710   stream << " *args_info);";
711   stream << "\n";
712   stream << indent_str;
713   stream << "/**";
714   stream << "\n";
715   stream << indent_str;
716   stream << " * Deallocates the string fields of the ";
717   generate_string (args_info, stream, indent + indent_str.length ());
718   stream << " structure";
719   stream << "\n";
720   stream << indent_str;
721   stream << " * (but does not deallocate the structure itself)";
722   stream << "\n";
723   stream << indent_str;
724   stream << " * ";
725   stream << "@";
726   stream << "param args_info the structure to deallocate";
727   stream << "\n";
728   stream << indent_str;
729   stream << " */";
730   stream << "\n";
731   stream << indent_str;
732   stream << "void ";
733   generate_string (parser_name, stream, indent + indent_str.length ());
734   stream << "_free (struct ";
735   generate_string (args_info, stream, indent + indent_str.length ());
736   stream << " *args_info);";
737   stream << "\n";
738   stream << indent_str;
739   stream << "\n";
740   stream << indent_str;
741   if (generate_config_parser)
742     {
743       stream << "/**";
744       stream << "\n";
745       stream << indent_str;
746       stream << " * The config file parser (deprecated version)";
747       stream << "\n";
748       stream << indent_str;
749       stream << " * ";
750       stream << "@";
751       stream << "param filename the name of the config file";
752       stream << "\n";
753       stream << indent_str;
754       stream << " * ";
755       stream << "@";
756       stream << "param args_info the structure where option information will be stored";
757       stream << "\n";
758       stream << indent_str;
759       stream << " * ";
760       stream << "@";
761       stream << "param override whether to override possibly already present options";
762       stream << "\n";
763       stream << indent_str;
764       stream << " * ";
765       stream << "@";
766       stream << "param initialize whether to initialize the option structure my_args_info";
767       stream << "\n";
768       stream << indent_str;
769       stream << " * ";
770       stream << "@";
771       stream << "param check_required whether to check that all required options were provided";
772       stream << "\n";
773       stream << indent_str;
774       stream << " * ";
775       stream << "@";
776       stream << "return 0 if everything went fine, NON 0 if an error took place";
777       stream << "\n";
778       stream << indent_str;
779       stream << " * ";
780       stream << "@";
781       stream << "deprecated use ";
782       generate_string (parser_name, stream, indent + indent_str.length ());
783       stream << "_config_file() instead";
784       stream << "\n";
785       stream << indent_str;
786       stream << " */";
787       stream << "\n";
788       stream << indent_str;
789       stream << "int ";
790       generate_string (parser_name, stream, indent + indent_str.length ());
791       stream << "_configfile (const char *filename,";
792       stream << "\n";
793       stream << indent_str;
794       stream << "  struct ";
795       generate_string (args_info, stream, indent + indent_str.length ());
796       stream << " *args_info,";
797       stream << "\n";
798       stream << indent_str;
799       stream << "  int override, int initialize, int check_required);";
800       stream << "\n";
801       stream << indent_str;
802       stream << "\n";
803       stream << indent_str;
804       stream << "/**";
805       stream << "\n";
806       stream << indent_str;
807       stream << " * The config file parser";
808       stream << "\n";
809       stream << indent_str;
810       stream << " * ";
811       stream << "@";
812       stream << "param filename the name of the config file";
813       stream << "\n";
814       stream << indent_str;
815       stream << " * ";
816       stream << "@";
817       stream << "param args_info the structure where option information will be stored";
818       stream << "\n";
819       stream << indent_str;
820       stream << " * ";
821       stream << "@";
822       stream << "param params additional parameters for the parser";
823       stream << "\n";
824       stream << indent_str;
825       stream << " * ";
826       stream << "@";
827       stream << "return 0 if everything went fine, NON 0 if an error took place";
828       stream << "\n";
829       stream << indent_str;
830       stream << " */";
831       stream << "\n";
832       stream << indent_str;
833       stream << "int ";
834       generate_string (parser_name, stream, indent + indent_str.length ());
835       stream << "_config_file (const char *filename,";
836       stream << "\n";
837       stream << indent_str;
838       stream << "  struct ";
839       generate_string (args_info, stream, indent + indent_str.length ());
840       stream << " *args_info,";
841       stream << "\n";
842       stream << indent_str;
843       stream << "  struct ";
844       generate_string (parser_name, stream, indent + indent_str.length ());
845       stream << "_params *params);";
846       stream << "\n";
847       stream << indent_str;
848       stream << "\n";
849       stream << indent_str;
850     }
851   if (generate_string_parser)
852     {
853       stream << "/**";
854       stream << "\n";
855       stream << indent_str;
856       stream << " * The string parser (interprets the passed string as a command line)";
857       stream << "\n";
858       stream << indent_str;
859       stream << " * ";
860       stream << "@";
861       stream << "param cmdline the command line stirng";
862       stream << "\n";
863       stream << indent_str;
864       stream << " * ";
865       stream << "@";
866       stream << "param args_info the structure where option information will be stored";
867       stream << "\n";
868       stream << indent_str;
869       stream << " * ";
870       stream << "@";
871       stream << "param prog_name the name of the program that will be used to print";
872       stream << "\n";
873       stream << indent_str;
874       stream << " *   possible errors";
875       stream << "\n";
876       stream << indent_str;
877       stream << " * ";
878       stream << "@";
879       stream << "return 0 if everything went fine, NON 0 if an error took place";
880       stream << "\n";
881       stream << indent_str;
882       stream << " */";
883       stream << "\n";
884       stream << indent_str;
885       stream << "int ";
886       generate_string (parser_name, stream, indent + indent_str.length ());
887       stream << "_string (const char *cmdline, struct ";
888       generate_string (args_info, stream, indent + indent_str.length ());
889       stream << " *args_info,";
890       stream << "\n";
891       stream << indent_str;
892       stream << "  const char *prog_name);";
893       stream << "\n";
894       stream << indent_str;
895       stream << "/**";
896       stream << "\n";
897       stream << indent_str;
898       stream << " * The string parser (version with additional parameters - deprecated)";
899       stream << "\n";
900       stream << indent_str;
901       stream << " * ";
902       stream << "@";
903       stream << "param cmdline the command line stirng";
904       stream << "\n";
905       stream << indent_str;
906       stream << " * ";
907       stream << "@";
908       stream << "param args_info the structure where option information will be stored";
909       stream << "\n";
910       stream << indent_str;
911       stream << " * ";
912       stream << "@";
913       stream << "param prog_name the name of the program that will be used to print";
914       stream << "\n";
915       stream << indent_str;
916       stream << " *   possible errors";
917       stream << "\n";
918       stream << indent_str;
919       stream << " * ";
920       stream << "@";
921       stream << "param override whether to override possibly already present options";
922       stream << "\n";
923       stream << indent_str;
924       stream << " * ";
925       stream << "@";
926       stream << "param initialize whether to initialize the option structure my_args_info";
927       stream << "\n";
928       stream << indent_str;
929       stream << " * ";
930       stream << "@";
931       stream << "param check_required whether to check that all required options were provided";
932       stream << "\n";
933       stream << indent_str;
934       stream << " * ";
935       stream << "@";
936       stream << "return 0 if everything went fine, NON 0 if an error took place";
937       stream << "\n";
938       stream << indent_str;
939       stream << " * ";
940       stream << "@";
941       stream << "deprecated use ";
942       generate_string (parser_name, stream, indent + indent_str.length ());
943       stream << "_string_ext() instead";
944       stream << "\n";
945       stream << indent_str;
946       stream << " */";
947       stream << "\n";
948       stream << indent_str;
949       stream << "int ";
950       generate_string (parser_name, stream, indent + indent_str.length ());
951       stream << "_string2 (const char *cmdline, struct ";
952       generate_string (args_info, stream, indent + indent_str.length ());
953       stream << " *args_info,";
954       stream << "\n";
955       stream << indent_str;
956       stream << "  const char *prog_name,";
957       stream << "\n";
958       stream << indent_str;
959       stream << "  int override, int initialize, int check_required);";
960       stream << "\n";
961       stream << indent_str;
962       stream << "/**";
963       stream << "\n";
964       stream << indent_str;
965       stream << " * The string parser (version with additional parameters)";
966       stream << "\n";
967       stream << indent_str;
968       stream << " * ";
969       stream << "@";
970       stream << "param cmdline the command line stirng";
971       stream << "\n";
972       stream << indent_str;
973       stream << " * ";
974       stream << "@";
975       stream << "param args_info the structure where option information will be stored";
976       stream << "\n";
977       stream << indent_str;
978       stream << " * ";
979       stream << "@";
980       stream << "param prog_name the name of the program that will be used to print";
981       stream << "\n";
982       stream << indent_str;
983       stream << " *   possible errors";
984       stream << "\n";
985       stream << indent_str;
986       stream << " * ";
987       stream << "@";
988       stream << "param params additional parameters for the parser";
989       stream << "\n";
990       stream << indent_str;
991       stream << " * ";
992       stream << "@";
993       stream << "return 0 if everything went fine, NON 0 if an error took place";
994       stream << "\n";
995       stream << indent_str;
996       stream << " */";
997       stream << "\n";
998       stream << indent_str;
999       stream << "int ";
1000       generate_string (parser_name, stream, indent + indent_str.length ());
1001       stream << "_string_ext (const char *cmdline, struct ";
1002       generate_string (args_info, stream, indent + indent_str.length ());
1003       stream << " *args_info,";
1004       stream << "\n";
1005       stream << indent_str;
1006       stream << "  const char *prog_name,";
1007       stream << "\n";
1008       stream << indent_str;
1009       stream << "  struct ";
1010       generate_string (parser_name, stream, indent + indent_str.length ());
1011       stream << "_params *params);";
1012       stream << "\n";
1013       stream << indent_str;
1014       stream << "\n";
1015       stream << indent_str;
1016     }
1017   stream << "/**";
1018   stream << "\n";
1019   stream << indent_str;
1020   stream << " * Checks that all the required options were specified";
1021   stream << "\n";
1022   stream << indent_str;
1023   stream << " * ";
1024   stream << "@";
1025   stream << "param args_info the structure to check";
1026   stream << "\n";
1027   stream << indent_str;
1028   stream << " * ";
1029   stream << "@";
1030   stream << "param prog_name the name of the program that will be used to print";
1031   stream << "\n";
1032   stream << indent_str;
1033   stream << " *   possible errors";
1034   stream << "\n";
1035   stream << indent_str;
1036   stream << " * ";
1037   stream << "@";
1038   stream << "return";
1039   stream << "\n";
1040   stream << indent_str;
1041   stream << " */";
1042   stream << "\n";
1043   stream << indent_str;
1044   stream << "int ";
1045   generate_string (parser_name, stream, indent + indent_str.length ());
1046   stream << "_required (struct ";
1047   generate_string (args_info, stream, indent + indent_str.length ());
1048   stream << " *args_info,";
1049   stream << "\n";
1050   stream << indent_str;
1051   stream << "  const char *prog_name);";
1052   stream << "\n";
1053   stream << indent_str;
1054   stream << "\n";
1055   stream << indent_str;
1056   if (option_values_decl.size () > 0)
1057     generate_string (option_values_decl, stream, indent + indent_str.length ());
1058   else
1059     generate_option_values_decl (stream, indent + indent_str.length ());
1060   stream << indent_str;
1061   stream << "\n";
1062   stream << indent_str;
1063   stream << "#ifdef __cplusplus";
1064   stream << "\n";
1065   stream << indent_str;
1066   stream << "}";
1067   stream << "\n";
1068   stream << indent_str;
1069   stream << "#endif /* __cplusplus */";
1070   stream << "\n";
1071   stream << indent_str;
1072   stream << "#endif /* ";
1073   generate_string (ifndefname, stream, indent + indent_str.length ());
1074   stream << "_H */";
1075   stream << "\n";
1076   stream << indent_str;
1077 }