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.12, updated June 2011.

   Copyright (C) 1992-2011 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.12.

   AutoGen copyright (C) 1992-2011 Bruce Korb AutoOpts copyright (C)
1992-2011 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: 1456
autogen.info-2: 300911

Tag Table:
(Indirect)
Node: Top1456
Node: Introduction2893
Node: Generalities4417
Node: Example Usage7221
Node: csh/zsh caveat12468
Node: Testimonial13833
Node: Definitions File16044
Node: Identification17949
Node: Definitions19238
Node: def-list20425
Node: double-quote-string21314
Node: single-quote-string21792
Node: simple-string22527
Node: shell-generated23286
Node: scheme-generated23971
Node: here-string24368
Node: concat-string25982
Node: Index Assignments26966
Node: Dynamic Text28428
Node: Directives29603
Node: Predefines35224
Node: Comments36987
Node: Example37402
Node: Full Syntax38136
Node: Alternate Definition51589
Node: Template File53664
Node: pseudo macro55293
Node: naming values60996
Node: expression syntax62277
Node: apply code63519
Node: basic expression66065
Node: AutoGen Functions68356
Node: SCM ag-fprintf72926
Node: SCM ag-function?73707
Node: SCM base-name74085
Node: SCM chdir74465
Node: SCM count74934
Node: SCM def-file75417
Node: SCM def-file-line75787
Node: SCM dne76708
Node: SCM emit78049
Node: SCM emit-string-table78558
Node: SCM error79007
Node: SCM exist?79930
Node: SCM find-file80702
Node: SCM first-for?81245
Node: SCM for-by81724
Node: SCM for-from82158
Node: SCM for-index82597
Node: SCM for-sep83049
Node: SCM for-to83593
Node: SCM get84015
Node: SCM get-c-name84502
Node: SCM get-down-name85062
Node: SCM get-up-name85688
Node: SCM high-lim86304
Node: SCM last-for?87000
Node: SCM len87468
Node: SCM low-lim87982
Node: SCM make-header-guard88319
Node: SCM make-tmp-dir90079
Node: SCM match-value?90435
Node: SCM out-delete91335
Node: SCM out-depth91830
Node: SCM out-emit-suspended92179
Node: SCM out-line92596
Node: SCM out-move92971
Node: SCM out-name93454
Node: SCM out-pop93911
Node: SCM out-push-add94537
Node: SCM out-push-new94948
Node: SCM out-resume95566
Node: SCM out-suspend96056
Node: SCM out-switch96759
Node: SCM output-file-next-line97339
Node: SCM set-option98269
Node: SCM set-writable98681
Node: SCM stack99253
Node: SCM stack-join99641
Node: SCM string-table-add100173
Node: SCM suffix100960
Node: SCM tpl-file101279
Node: SCM tpl-file-line101772
Node: SCM tpl-file-next-line102762
Node: SCM autogen-version103350
Node: SCM c-file-line-fmt103719
Node: Common Functions104140
Node: SCM agpl109420
Node: SCM bsd109878
Node: SCM c-string110356
Node: SCM error-source-line111123
Node: SCM extract111657
Node: SCM format-arg-count115006
Node: SCM fprintf115915
Node: SCM gperf116465
Node: SCM gperf-code117195
Node: SCM gpl118386
Node: SCM hide-email118852
Node: SCM html-escape-encode119316
Node: SCM in?119817
Node: SCM join120255
Node: SCM kr-string120768
Node: SCM lgpl121336
Node: SCM license121860
Node: SCM license-description122408
Node: SCM license-full123162
Node: SCM license-info125346
Node: SCM license-name126303
Node: SCM make-gperf126664
Node: SCM makefile-script127660
Node: SCM max129949
Node: SCM min130262
Node: SCM prefix130566
Node: SCM printf131092
Node: SCM raw-shell-str131657
Node: SCM shell132408
Node: SCM shell-str132958
Node: SCM shellf135883
Node: SCM sprintf136331
Node: SCM string-capitalize136714
Node: SCM string-capitalize!137177
Node: SCM *=*137518
Node: SCM *==*138088
Node: SCM string-downcase138496
Node: SCM string-downcase!138908
Node: SCM *~139269
Node: SCM *~~139691
Node: SCM *=140073
Node: SCM *==140455
Node: SCM ==140867
Node: SCM ~141213
Node: SCM =141684
Node: SCM *~*142421
Node: SCM *~~*142834
Node: SCM ~~143230
Node: SCM ~*143596
Node: SCM ~~*144010
Node: SCM =*144403
Node: SCM ==*144791
Node: SCM string-substitute145176
Node: SCM string-table-add-ref145925
Node: SCM string-table-new146499
Node: SCM string-table-size149034
Node: SCM string->c-name!149457
Node: SCM string->camelcase149987
Node: SCM string-tr150482
Node: SCM string-tr!150960
Node: SCM string-upcase151619
Node: SCM string-upcase!152027
Node: SCM sub-shell-str152389
Node: SCM sum152841
Node: SCM time-string->number153175
Node: SCM version-compare153807
Node: native macros154750
Node: AGMacro syntax157649
Node: CASE159797
Node: COMMENT162517
Node: DEBUG163061
Node: DEFINE163927
Node: ELIF166161
Node: ELSE166637
Node: ENDDEF167010
Node: ENDFOR167275
Node: ENDIF167575
Node: ENDWHILE167853
Node: ESAC168147
Node: EXPR168429
Node: FOR168908
Node: IF171886
Node: INCLUDE172923
Node: INVOKE173571
Node: SELECT174571
Node: UNKNOWN175062
Node: WHILE175591
Node: output controls176332
Node: Augmenting AutoGen178340
Node: shell commands178890
Node: guile macros179713
Node: guile callouts180519
Node: AutoGen macros182717
Node: autogen Invocation183416
Node: autogen usage186361
Node: autogen base-name191269
Node: autogen core192383
Node: autogen define193067
Node: autogen definitions194323
Node: autogen equate195053
Node: autogen lib-template195484
Node: autogen load-functions195967
Node: autogen load-scheme196511
Node: autogen loop-limit197085
Node: autogen make-dep197572
Node: autogen no-fmemopen199757
Node: autogen override-tpl200706
Node: autogen select-suffix201229
Node: autogen shell201855
Node: autogen show-defs202538
Node: autogen skip-suffix203059
Node: autogen source-time203814
Node: autogen templ-dirs204357
Node: autogen timeout204936
Node: autogen trace205561
Node: autogen trace-out207600
Node: autogen undefine208210
Node: autogen used-defines208795
Node: autogen writable209666
Node: autogen option presets210124
Node: autogen exit status212252
Node: autogen Description212970
Node: autogen Examples213152
Node: Installation213325
Node: configuring213643
Node: AutoGen CGI216494
Node: signal names218921
Node: installing220144
Node: AutoOpts222928
Node: Features224691
Node: Licensing231849
Node: Caveats232974
Node: Quick Start235075
Node: Option Definitions239104
Node: program attributes241035
Node: usage attributes242726
Node: config attributes245424
Node: programming attributes247593
Node: presentation attributes251930
Node: library attributes255137
Node: lib and program256014
Node: lib called258430
Node: prog calls lib259717
Node: information attributes260595
Node: Generated main265034
Node: main guile266214
Node: main shell-process267121
Node: main shell-parser268485
Node: main main269131
Node: main include270005
Node: main invoke270809
Node: main for-each271452
Node: option attributes276911
Node: Required Attributes278298
Node: Common Attributes279998
Node: Immediate Action283473
Node: Option Conflict Attributes285790
Node: opt-attr settable286576
Node: opt-attr no-preset287167
Node: opt-attr equivalence287527
Node: opt-attr aliases289748
Node: opt-attr default option290410
Node: opt-attr documentation291219
Node: opt-attr translators292332
Node: Option Arguments292947
Node: arg-type string295078
Node: arg-type number295379
Node: arg-type boolean297286
Node: arg-type keyword297737
Node: arg-type set membership299346
Node: arg-type hierarchy300911
Node: arg-type file name301691
Node: arg-type time-duration302939
Node: arg-type time-date305003
Node: arg-keyword305787
Node: arg-optional306642
Node: arg-default307361
Node: Option Argument Handling307720
Node: Internationalizing Options311138
Node: documentation attributes313036
Node: automatic options318986
Node: standard options324215
Node: AutoOpts API328420
Node: Option Processing Data331320
Node: CLEAR_OPT334916
Node: COUNT_OPT335240
Node: DESC335645
Node: DISABLE_OPT_name336063
Node: ENABLED_OPT336620
Node: ERRSKIP_OPTERR337059
Node: ERRSTOP_OPTERR337390
Node: HAVE_OPT337844
Node: ISSEL_OPT338213
Node: ISUNUSED_OPT338521
Node: OPTION_CT338831
Node: OPT_ARG339187
Node: OPT_NO_XLAT_CFG_NAMES339740
Node: OPT_NO_XLAT_OPT_NAMES340277
Node: OPT_VALUE_name340758
Node: OPT_XLAT_CFG_NAMES341222
Node: OPT_XLAT_OPT_NAMES342088
Node: RESTART_OPT342793
Node: SET_OPT_name343262
Node: STACKCT_OPT344212
Node: STACKLST_OPT344994
Node: START_OPT345814
Node: STATE_OPT346070
Node: USAGE347019
Node: VALUE_OPT_name348485
Node: VERSION349139
Node: WHICH_IDX_name349723
Node: WHICH_OPT_name350281
Node: teOptIndex350849
Node: OPTIONS_STRUCT_VERSION351438
Node: libopts procedures352231
Node: libopts-ao_string_tokenize353800
Node: libopts-configFileLoad355822
Node: libopts-optionFileLoad357129
Node: libopts-optionFindNextValue358716
Node: libopts-optionFindValue359911
Node: libopts-optionFree360970
Node: libopts-optionGetValue361618
Node: libopts-optionLoadLine362693
Node: libopts-optionNextValue364086
Node: libopts-optionOnlyUsage365383
Node: libopts-optionProcess366067
Node: libopts-optionRestore367823
Node: libopts-optionSaveFile368714
Node: libopts-optionSaveState369960
Node: libopts-optionUnloadNested371174
Node: libopts-optionVersion371830
Node: libopts-pathfind372399
Node: libopts-strequate374102
Node: libopts-streqvcmp374717
Node: libopts-streqvmap375669
Node: libopts-strneqvcmp376777
Node: libopts-strtransform377829
Node: Multi-Threading378530
Node: option descriptor379526
Node: Using AutoOpts380177
Node: local use380787
Node: binary not installed382417
Node: binary pre-installed382921
Node: source pre-installed383550
Node: source not installed384612
Node: Presetting Options385737
Node: loading rcfile388000
Node: saving rcfile389706
Node: sample rcfile390215
Node: environrc391258
Node: config example393170
Node: Config File Format395035
Node: config name/string-value396081
Node: config integer-values398922
Node: config nested-values399426
Node: config directives399910
Node: config comments401722
Node: shell options402147
Node: binary-parser403970
Node: script-parser406404
Node: AutoInfo431229
Node: command-info432671
Node: library-info433714
Node: AutoMan pages434959
Node: man1435413
Node: man3436876
Node: getopt_long440098
Node: i18n442992
Node: Naming Conflicts444405
Node: All Attribute Names445793
Node: Option Define Names447964
Node: Add-Ons459407
Node: AutoFSM460398
Node: AutoXDR460821
Node: AutoEvents461652
Node: columns Invocation462908
Node: columns usage465291
Node: columns by-columns467908
Node: columns col-width468349
Node: columns columns468761
Node: columns ending469157
Node: columns fill469428
Node: columns first-indent470009
Node: columns format470813
Node: columns indent471196
Node: columns input471574
Node: columns line-separation471951
Node: columns separation472307
Node: columns sort472654
Node: columns spread473099
Node: columns tab-width473467
Node: columns width473783
Node: columns option presets474321
Node: columns exit status476447
Node: columns See Also476761
Node: getdefs Invocation476941
Node: getdefs usage480376
Node: getdefs agarg483684
Node: getdefs assign484168
Node: getdefs autogen484585
Node: getdefs base-name485184
Node: getdefs common-assign485797
Node: getdefs copy486250
Node: getdefs defs-to-get486662
Node: getdefs filelist487077
Node: getdefs first-index487536
Node: getdefs input487959
Node: getdefs linenum488681
Node: getdefs listattr489171
Node: getdefs ordering489998
Node: getdefs output490618
Node: getdefs srcfile491020
Node: getdefs subblock491502
Node: getdefs template492534
Node: getdefs option presets492819
Node: getdefs exit status494425
Node: getdefs See Also494739
Node: xml2ag Invocation494919
Node: xml2ag usage497225
Node: xml2ag base-name500818
Node: xml2ag core501070
Node: xml2ag define501754
Node: xml2ag definitions502103
Node: xml2ag equate502348
Node: xml2ag lib-template502599
Node: xml2ag load-functions502962
Node: xml2ag load-scheme503375
Node: xml2ag loop-limit503644
Node: xml2ag make-dep503897
Node: xml2ag no-fmemopen504255
Node: xml2ag output504517
Node: xml2ag override-tpl504880
Node: xml2ag select-suffix505147
Node: xml2ag shell505517
Node: xml2ag show-defs505767
Node: xml2ag skip-suffix506014
Node: xml2ag source-time506477
Node: xml2ag templ-dirs506741
Node: xml2ag timeout507107
Node: xml2ag trace507360
Node: xml2ag trace-out508003
Node: xml2ag undefine508252
Node: xml2ag used-defines508616
Node: xml2ag writable508873
Node: xml2ag exit status509133
Node: snprintfv509850
Node: Future512367
Node: Copying This Manual512706
Node: Concept Index535247
Node: Function Index555099

End Tag Table
