summaryrefslogtreecommitdiff
path: root/doc/autogen.info
blob: de39afb6a627c5628e967c1bfb02702d9c480975 (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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
This is autogen.info, produced by makeinfo version 4.13 from
/old-home/bkorb/ag/ag/doc//agdoc.texi.

This manual is for GNU AutoGen version 5.16, updated August 2012.

   Copyright (C) 1992-2012 by Bruce Korb.

     Permission is granted to copy, distribute and/or modify this
     document under the terms of the GNU Free Documentation License,
     Version 1.2 or any later version published by the Free Software
     Foundation; with no Invariant Sections, no Front-Cover Texts, and
     no Back-Cover Texts.

INFO-DIR-SECTION GNU programming tools
START-INFO-DIR-ENTRY
* AutoGen: (autogen).         The Automated Program Generator
END-INFO-DIR-ENTRY

   This file documents GNU AutoGen Version 5.16.

   AutoGen copyright (C) 1992-2012 Bruce Korb AutoOpts copyright (C)
1992-2012 Bruce Korb snprintfv copyright (C) 1999-2000 Gary V. Vaughan

   AutoGen is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.

   AutoGen is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

   You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.


Indirect:
autogen.info-1: 1458
autogen.info-2: 300856

Tag Table:
(Indirect)
Node: Top1458
Node: Introduction2897
Node: Generalities4567
Node: Example Usage7371
Node: csh/zsh caveat12618
Node: Testimonial13983
Node: Definitions File16194
Node: Identification18099
Node: Definitions19388
Node: def-list21111
Node: double-quote-string22000
Node: single-quote-string22868
Node: simple-string23603
Node: shell-generated24362
Node: scheme-generated25047
Node: here-string25444
Node: concat-string27206
Node: Index Assignments28190
Node: Dynamic Text29652
Node: Directives30827
Node: Predefines36448
Node: Comments38211
Node: Example38626
Node: Full Syntax39360
Node: Alternate Definition52813
Node: Template File54888
Node: pseudo macro56517
Node: naming values62220
Node: expression syntax63501
Node: apply code64743
Node: basic expression67289
Node: AutoGen Functions69580
Node: SCM ag-fprintf74073
Node: SCM ag-function?74854
Node: SCM base-name75232
Node: SCM chdir75612
Node: SCM count76081
Node: SCM def-file76564
Node: SCM def-file-line76934
Node: SCM dne77855
Node: SCM emit79196
Node: SCM emit-string-table79705
Node: SCM error80154
Node: SCM exist?81077
Node: SCM find-file81849
Node: SCM first-for?82392
Node: SCM for-by82876
Node: SCM for-from83310
Node: SCM for-index83749
Node: SCM for-sep84204
Node: SCM for-to84748
Node: SCM get85170
Node: SCM get-c-name85657
Node: SCM get-down-name86217
Node: SCM get-up-name86843
Node: SCM high-lim87459
Node: SCM last-for?88155
Node: SCM len88623
Node: SCM low-lim89137
Node: SCM make-header-guard89474
Node: SCM make-tmp-dir91234
Node: SCM match-value?91590
Node: SCM out-delete92490
Node: SCM out-depth92985
Node: SCM out-emit-suspended93334
Node: SCM out-line93751
Node: SCM out-move94126
Node: SCM out-name94609
Node: SCM out-pop95066
Node: SCM out-push-add95692
Node: SCM out-push-new96103
Node: SCM out-resume96721
Node: SCM out-suspend97211
Node: SCM out-switch97914
Node: SCM output-file-next-line98494
Node: SCM set-option99424
Node: SCM set-writable99836
Node: SCM stack100408
Node: SCM stack-join100796
Node: SCM suffix101318
Node: SCM tpl-file101631
Node: SCM tpl-file-line102124
Node: SCM tpl-file-next-line103114
Node: SCM autogen-version103702
Node: SCM c-file-line-fmt104073
Node: Common Functions104494
Node: SCM agpl109846
Node: SCM bsd110304
Node: SCM c-string110782
Node: SCM error-source-line111549
Node: SCM extract112083
Node: SCM format-arg-count115432
Node: SCM fprintf116341
Node: SCM gperf116891
Node: SCM gperf-code117621
Node: SCM gpl118812
Node: SCM hide-email119278
Node: SCM html-escape-encode119742
Node: SCM in?120243
Node: SCM join120681
Node: SCM kr-string121194
Node: SCM lgpl121762
Node: SCM license122286
Node: SCM license-description122834
Node: SCM license-full123588
Node: SCM license-info125772
Node: SCM license-name126729
Node: SCM make-gperf127090
Node: SCM makefile-script128086
Node: SCM max130865
Node: SCM min131178
Node: SCM prefix131482
Node: SCM printf132008
Node: SCM raw-shell-str132573
Node: SCM shell133324
Node: SCM shell-str134339
Node: SCM shellf137264
Node: SCM sprintf137712
Node: SCM string-capitalize138095
Node: SCM string-capitalize!138558
Node: SCM *=*138899
Node: SCM *==*139469
Node: SCM string-downcase139877
Node: SCM string-downcase!140289
Node: SCM *~140650
Node: SCM *~~141072
Node: SCM *=141454
Node: SCM *==141836
Node: SCM ==142248
Node: SCM ~142594
Node: SCM =143065
Node: SCM *~*143847
Node: SCM *~~*144260
Node: SCM ~~144656
Node: SCM ~*145022
Node: SCM ~~*145436
Node: SCM =*145829
Node: SCM ==*146217
Node: SCM string-substitute146602
Node: SCM string-table-add147366
Node: SCM string-table-add-ref148173
Node: SCM string-table-new148746
Node: SCM string-table-size151462
Node: SCM string->c-name!151885
Node: SCM string->camelcase152415
Node: SCM string-tr152910
Node: SCM string-tr!153388
Node: SCM string-upcase154047
Node: SCM string-upcase!154455
Node: SCM sub-shell-str154817
Node: SCM sum155269
Node: SCM time-string->number155603
Node: SCM version-compare156235
Node: native macros157178
Node: AGMacro syntax160265
Node: BREAK162414
Node: CASE162769
Node: COMMENT165480
Node: CONTINUE166027
Node: DEBUG166287
Node: DEFINE167154
Node: ELIF169388
Node: ELSE169864
Node: ENDDEF170237
Node: ENDFOR170504
Node: ENDIF170806
Node: ENDWHILE171084
Node: ESAC171378
Node: EXPR171660
Node: FOR172139
Node: IF175117
Node: INCLUDE176154
Node: INVOKE176802
Node: RETURN177802
Node: SELECT178341
Node: UNKNOWN178832
Node: WHILE179361
Node: output controls180102
Node: Augmenting AutoGen182110
Node: shell commands182660
Node: guile macros183483
Node: guile callouts184289
Node: AutoGen macros186487
Node: autogen Invocation187186
Node: autogen usage189075
Node: autogen input-select194482
Ref: autogen templ-dirs194791
Ref: autogen override-tpl195282
Ref: autogen lib-template195710
Ref: autogen definitions196092
Ref: autogen load-scheme196746
Ref: autogen load-functions197233
Ref: autogen shell197651
Ref: autogen no-fmemopen198267
Ref: autogen equate199059
Node: autogen out-handling199377
Ref: autogen base-name199659
Ref: autogen source-time200688
Ref: autogen writable201087
Node: autogen debug-tpl201230
Ref: autogen loop-limit201624
Ref: autogen timeout202025
Ref: autogen trace202555
Ref: autogen trace-out204532
Ref: autogen show-defs205060
Ref: autogen used-defines205453
Ref: autogen core206181
Node: autogen processing206702
Ref: autogen skip-suffix207090
Ref: autogen select-suffix207757
Ref: autogen define208278
Ref: autogen undefine209601
Node: autogen dep-track210053
Ref: autogen make-dep210320
Node: autogen config213631
Node: autogen exit status216700
Node: autogen Examples217870
Node: Installation218593
Node: configuring218911
Node: AutoGen CGI221762
Node: signal names224189
Node: installing225412
Node: AutoOpts228196
Node: Features229959
Node: Licensing237573
Node: Caveats238698
Node: Quick Start240799
Node: Option Definitions245705
Node: program attributes247636
Node: usage attributes249537
Node: config attributes253271
Node: programming attributes256616
Node: presentation attributes261484
Node: library attributes264809
Node: lib and program265686
Node: lib called268102
Node: prog calls lib269389
Node: information attributes270267
Node: Generated main274919
Node: main guile276099
Node: main shell-process277006
Node: main shell-parser278370
Node: main main279016
Node: main include279890
Node: main invoke280694
Node: main for-each281337
Node: option attributes286796
Node: Required Attributes288183
Node: Common Attributes289992
Node: Immediate Action293915
Node: Option Conflict Attributes296232
Node: opt-attr settable297018
Node: opt-attr no-preset297609
Node: opt-attr equivalence297969
Node: opt-attr aliases300190
Node: opt-attr default option300856
Node: opt-attr documentation301663
Node: opt-attr translators303192
Node: Option Arguments303807
Node: arg-type string305938
Node: arg-type number306239
Node: arg-type boolean308146
Node: arg-type keyword308597
Node: arg-type set membership310553
Node: arg-type hierarchy312118
Node: arg-type file name312898
Node: arg-type time-duration314146
Node: arg-type time-date316101
Node: arg-keyword316885
Node: arg-optional317740
Node: arg-default318459
Node: Option Argument Handling318818
Node: Internationalizing Options323017
Node: documentation attributes324969
Node: automatic options330919
Node: standard options336479
Node: AutoOpts API340700
Node: Option Processing Data343600
Node: CLEAR_OPT347196
Node: COUNT_OPT347520
Node: DESC347925
Node: DISABLE_OPT_name348343
Node: ENABLED_OPT348900
Node: ERRSKIP_OPTERR349339
Node: ERRSTOP_OPTERR349670
Node: HAVE_OPT350124
Node: ISSEL_OPT350493
Node: ISUNUSED_OPT350801
Node: OPTION_CT351111
Node: OPT_ARG351467
Node: OPT_NO_XLAT_CFG_NAMES352020
Node: OPT_NO_XLAT_OPT_NAMES352557
Node: OPT_VALUE_name353038
Node: OPT_XLAT_CFG_NAMES353502
Node: OPT_XLAT_OPT_NAMES354424
Node: RESTART_OPT355186
Node: SET_OPT_name355655
Node: STACKCT_OPT356605
Node: STACKLST_OPT357387
Node: START_OPT358207
Node: STATE_OPT358463
Node: USAGE359412
Node: VALUE_OPT_name360878
Node: VERSION361532
Node: WHICH_IDX_name362116
Node: WHICH_OPT_name362674
Node: teOptIndex363242
Node: OPTIONS_STRUCT_VERSION363831
Node: libopts procedures364624
Node: libopts-ao_string_tokenize366193
Node: libopts-configFileLoad368215
Node: libopts-optionFileLoad369563
Node: libopts-optionFindNextValue371150
Node: libopts-optionFindValue372345
Node: libopts-optionFree373404
Node: libopts-optionGetValue374052
Node: libopts-optionLoadLine375312
Node: libopts-optionNextValue376758
Node: libopts-optionOnlyUsage378055
Node: libopts-optionProcess378739
Node: libopts-optionRestore380495
Node: libopts-optionSaveFile381386
Node: libopts-optionSaveState382632
Node: libopts-optionUnloadNested383846
Node: libopts-optionVersion384502
Node: libopts-pathfind385071
Node: libopts-strequate386774
Node: libopts-streqvcmp387389
Node: libopts-streqvmap388341
Node: libopts-strneqvcmp389449
Node: libopts-strtransform390501
Node: Multi-Threading391202
Node: option descriptor392198
Node: Using AutoOpts392849
Node: local use393459
Node: binary not installed395089
Node: binary pre-installed395593
Node: source pre-installed396222
Node: source not installed397284
Node: Presetting Options398409
Node: loading rcfile400672
Node: saving rcfile402378
Node: sample rcfile402887
Node: environrc411815
Node: config example413727
Node: Config File Format415592
Node: config name/string-value416638
Node: config integer-values419479
Node: config nested-values419983
Node: config directives420467
Node: config comments422279
Node: shell options422704
Node: binary-parser424527
Node: script-parser426961
Node: AutoInfo452010
Node: command-info453452
Node: library-info454495
Node: AutoMan pages455740
Node: man1456194
Node: man3457657
Node: getopt_long460879
Node: getopt limitations461789
Node: getopt building463413
Node: i18n466054
Node: Naming Conflicts467616
Node: All Attribute Names469004
Node: Option Define Names471175
Node: Add-Ons483121
Node: AutoFSM484137
Node: AutoXDR484560
Node: AutoEvents485391
Node: columns Invocation486647
Node: columns usage488430
Node: columns dimensions491808
Ref: columns width492052
Ref: columns columns492502
Ref: columns col-width492819
Ref: columns tab-width493132
Node: columns treatment493326
Ref: columns spread493565
Ref: columns fill493931
Ref: columns indent494393
Ref: columns first-indent494696
Ref: columns format495412
Ref: columns separation495720
Ref: columns line-separation495977
Ref: columns ending496224
Node: columns ordering496388
Ref: columns by-columns496637
Ref: columns sort496944
Node: columns input-text497280
Ref: columns input497533
Node: columns config497780
Node: columns exit status500525
Node: columns See Also501109
Node: getdefs Invocation501384
Node: getdefs usage504258
Node: getdefs def-selection508240
Ref: getdefs defs-to-get508536
Ref: getdefs subblock508862
Ref: getdefs listattr509807
Node: getdefs enumerating510508
Ref: getdefs ordering510768
Ref: getdefs first-index511319
Node: getdefs doc-insert511620
Ref: getdefs filelist511867
Ref: getdefs assign512239
Ref: getdefs common-assign512589
Ref: getdefs copy512935
Ref: getdefs srcfile513260
Ref: getdefs linenum513665
Node: getdefs input-files514051
Ref: getdefs input514306
Node: getdefs doc-output514913
Ref: getdefs output515161
Ref: getdefs autogen515477
Ref: getdefs template516002
Ref: getdefs agarg516187
Ref: getdefs base-name516600
Node: getdefs config517082
Node: getdefs exit status519309
Node: getdefs See Also519893
Node: xml2ag Invocation520168
Node: xml2ag usage522046
Node: xml2ag the-xml2ag-option526250
Ref: xml2ag output526532
Node: xml2ag autogen-options526765
Ref: xml2ag templ-dirs527246
Ref: xml2ag override-tpl527524
Ref: xml2ag lib-template527704
Ref: xml2ag definitions527966
Ref: xml2ag load-scheme528140
Ref: xml2ag load-functions528322
Ref: xml2ag shell528609
Ref: xml2ag no-fmemopen528795
Ref: xml2ag equate528906
Ref: xml2ag base-name529091
Ref: xml2ag source-time529261
Ref: xml2ag writable529381
Ref: xml2ag loop-limit529508
Ref: xml2ag timeout529675
Ref: xml2ag trace529836
Ref: xml2ag trace-out530417
Ref: xml2ag show-defs530584
Ref: xml2ag used-defines530706
Ref: xml2ag core530823
Ref: xml2ag skip-suffix531395
Ref: xml2ag select-suffix531770
Ref: xml2ag define532035
Ref: xml2ag undefine532307
Ref: xml2ag make-dep532583
Node: xml2ag exit status532813
Node: snprintfv533747
Node: Future536264
Node: Copying This Manual536603
Node: Concept Index559144
Node: Function Index580933

End Tag Table