This is autogen.info, produced by makeinfo version 4.12 from autogen.texi. This manual is for GNU AutoGen version 5.10, updated November 2009. Copyright (C) 1992-2009 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.10. AutoGen copyright (C) 1992-2009 Bruce Korb AutoOpts copyright (C) 1992-2009 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 .  Indirect: autogen.info-1: 1435 autogen.info-2: 297582  Tag Table: (Indirect) Node: Top1435 Node: Introduction2876 Node: Generalities4400 Node: Example Usage7204 Node: csh/zsh caveat12451 Node: Testimonial13816 Node: Definitions File16027 Node: Identification17932 Node: Definitions19221 Node: def-list20408 Node: double-quote-string21297 Node: single-quote-string21775 Node: shell-generated22510 Node: simple-string23195 Node: scheme-generated23954 Node: here-string24351 Node: concat-string25965 Node: Index Assignments26949 Node: Dynamic Text28411 Node: Directives29586 Node: Predefines35208 Node: Comments36971 Node: Example37386 Node: Full Syntax38120 Node: Alternate Definition51573 Node: Template File53648 Node: pseudo macro55277 Node: naming values61031 Node: expression syntax62312 Node: apply code63554 Node: basic expression66100 Node: AutoGen Functions68391 Node: SCM ag-function?72342 Node: SCM base-name72697 Node: SCM chdir73077 Node: SCM count73546 Node: SCM def-file74029 Node: SCM def-file-line74399 Node: SCM dne75320 Node: SCM error76659 Node: SCM exist?77566 Node: SCM find-file78336 Node: SCM first-for?78879 Node: SCM for-by79358 Node: SCM for-from79792 Node: SCM for-index80231 Node: SCM for-sep80683 Node: SCM for-to81227 Node: SCM get81649 Node: SCM get-c-name82136 Node: SCM get-down-name82696 Node: SCM get-up-name83322 Node: SCM high-lim83938 Node: SCM last-for?84634 Node: SCM len85102 Node: SCM low-lim85616 Node: SCM make-header-guard85953 Node: SCM match-value?87713 Node: SCM out-delete88618 Node: SCM out-depth89113 Node: SCM out-emit-suspended89462 Node: SCM out-line89881 Node: SCM out-move90256 Node: SCM out-name90739 Node: SCM out-pop91196 Node: SCM out-push-add91822 Node: SCM out-push-new92233 Node: SCM out-resume92851 Node: SCM out-suspend93343 Node: SCM out-switch94046 Node: SCM set-option94615 Node: SCM set-writable95016 Node: SCM stack95588 Node: SCM suffix95972 Node: SCM tpl-file96280 Node: SCM tpl-file-line96773 Node: SCM autogen-version97655 Node: SCM c-file-line-fmt98019 Node: Common Functions98440 Node: SCM ag-fprintf103591 Node: SCM agpl104363 Node: SCM bsd104924 Node: SCM c-string105518 Node: SCM emit106272 Node: SCM emit-string-table106645 Node: SCM error-source-line107103 Node: SCM extract107646 Node: SCM format-arg-count110995 Node: SCM fprintf111904 Node: SCM gperf112456 Node: SCM gperf-code113188 Node: SCM gpl114381 Node: SCM hide-email114926 Node: SCM html-escape-encode115390 Node: SCM in?115891 Node: SCM join116329 Node: SCM kr-string116842 Node: SCM lgpl117410 Node: SCM license118053 Node: SCM make-gperf118818 Node: SCM makefile-script119809 Node: SCM max122098 Node: SCM min122411 Node: SCM prefix122715 Node: SCM printf123241 Node: SCM raw-shell-str123806 Node: SCM shell124557 Node: SCM shell-str125107 Node: SCM shellf128030 Node: SCM sprintf128478 Node: SCM string-capitalize128861 Node: SCM string-capitalize!129324 Node: SCM *=*129665 Node: SCM *==*130235 Node: SCM string-downcase130643 Node: SCM string-downcase!131055 Node: SCM *~131416 Node: SCM *~~131838 Node: SCM *=132220 Node: SCM *==132602 Node: SCM ==133014 Node: SCM ~133360 Node: SCM =133831 Node: SCM *~*134568 Node: SCM *~~*134981 Node: SCM ~~135377 Node: SCM ~*135743 Node: SCM ~~*136157 Node: SCM =*136550 Node: SCM ==*136938 Node: SCM string-substitute137323 Node: SCM string-table-add138068 Node: SCM string-table-add-ref138875 Node: SCM string-table-new139448 Node: SCM string-table-size141983 Node: SCM string->c-name!142406 Node: SCM string-tr142928 Node: SCM string-tr!143404 Node: SCM string-upcase144063 Node: SCM string-upcase!144471 Node: SCM sub-shell-str144833 Node: SCM sum145285 Node: SCM time-string->number145619 Node: SCM version-compare146251 Node: native macros147194 Node: AGMacro syntax150093 Node: CASE152241 Node: COMMENT154961 Node: DEBUG155505 Node: DEFINE156371 Node: ELIF158605 Node: ELSE159081 Node: ENDDEF159454 Node: ENDFOR159719 Node: ENDIF160019 Node: ENDWHILE160297 Node: ESAC160591 Node: EXPR160873 Node: FOR161352 Node: IF164330 Node: INCLUDE165367 Node: INVOKE166015 Node: SELECT167015 Node: UNKNOWN167506 Node: WHILE168035 Node: output controls168776 Node: Augmenting AutoGen170784 Node: shell commands171334 Node: guile macros172157 Node: guile callouts172963 Node: AutoGen macros175161 Node: autogen Invocation175860 Node: autogen usage178379 Node: autogen templ-dirs183377 Node: autogen override-tpl183954 Node: autogen lib-template184475 Node: autogen base-name184958 Node: autogen definitions186074 Node: autogen load-scheme186804 Node: autogen load-functions187378 Node: autogen skip-suffix188644 Node: autogen select-suffix189305 Node: autogen source-time189935 Node: autogen no-fmemopen190478 Node: autogen equate191227 Node: autogen writable191660 Node: autogen loop-limit192087 Node: autogen timeout192577 Node: autogen trace193206 Node: autogen trace-out195246 Node: autogen show-defs195822 Node: autogen used-defines196351 Node: autogen define197222 Node: autogen undefine198485 Node: Installation199065 Node: configuring199383 Node: AutoGen CGI202234 Node: signal names204661 Node: installing205884 Node: AutoOpts208668 Node: Features210376 Node: Licensing217177 Node: Caveats218302 Node: Quick Start219074 Node: Option Definitions223029 Node: program attributes224960 Node: library attributes233392 Node: lib and program234269 Node: lib called236685 Node: prog calls lib237972 Node: Generated main238850 Node: main guile240030 Node: main shell-process240937 Node: main shell-parser242301 Node: main main242947 Node: main include243821 Node: main invoke244625 Node: main for-each245268 Node: information attributes250213 Node: option attributes254658 Node: Required Attributes256045 Node: Common Attributes257745 Node: opt-attr settable261220 Node: opt-attr no-preset261811 Node: opt-attr equivalence262171 Node: opt-attr aliases264392 Node: opt-attr default option265054 Node: opt-attr documentation265863 Node: opt-attr translators266974 Node: Immediate Action267587 Node: Option Conflict Attributes269906 Node: Option Arguments270694 Node: arg-keyword272774 Node: arg-optional273622 Node: arg-default274339 Node: arg-type string274696 Node: arg-type number274997 Node: arg-type boolean276904 Node: arg-type keyword277355 Node: arg-type set membership278964 Node: arg-type hierarchy280529 Node: arg-type file name281309 Node: arg-type time282550 Node: Option Argument Handling284591 Node: Internationalizing Options288009 Node: documentation attributes289907 Node: automatic options292269 Node: standard options297582 Node: AutoOpts API301710 Node: Option Processing Data304610 Node: CLEAR_OPT308209 Node: COUNT_OPT308533 Node: DESC308938 Node: DISABLE_OPT_name309356 Node: ENABLED_OPT309913 Node: ERRSKIP_OPTERR310352 Node: ERRSTOP_OPTERR310683 Node: HAVE_OPT311137 Node: ISSEL_OPT311506 Node: ISUNUSED_OPT311814 Node: OPTION_CT312124 Node: OPT_ARG312480 Node: OPT_NO_XLAT_CFG_NAMES313033 Node: OPT_NO_XLAT_OPT_NAMES313570 Node: OPT_VALUE_name314051 Node: OPT_XLAT_CFG_NAMES314515 Node: OPT_XLAT_OPT_NAMES315381 Node: RESTART_OPT316086 Node: SET_OPT_name316555 Node: STACKCT_OPT317505 Node: STACKLST_OPT318287 Node: START_OPT319107 Node: STATE_OPT319363 Node: USAGE320312 Node: VALUE_OPT_name321779 Node: VERSION322433 Node: WHICH_IDX_name323017 Node: WHICH_OPT_name323575 Node: teOptIndex324143 Node: OPTIONS_STRUCT_VERSION324732 Node: libopts procedures325525 Node: libopts-ao_string_tokenize327094 Node: libopts-configFileLoad329116 Node: libopts-optionFileLoad330423 Node: libopts-optionFindNextValue332010 Node: libopts-optionFindValue333205 Node: libopts-optionFree334264 Node: libopts-optionGetValue334912 Node: libopts-optionLoadLine335987 Node: libopts-optionNextValue337380 Node: libopts-optionOnlyUsage338677 Node: libopts-optionProcess339361 Node: libopts-optionRestore341117 Node: libopts-optionSaveFile342008 Node: libopts-optionSaveState343256 Node: libopts-optionUnloadNested344470 Node: libopts-optionVersion345126 Node: libopts-pathfind345695 Node: libopts-strequate347398 Node: libopts-streqvcmp348013 Node: libopts-streqvmap348965 Node: libopts-strneqvcmp350075 Node: libopts-strtransform351127 Node: Multi-Threading351828 Node: option descriptor352824 Node: Using AutoOpts353475 Node: local use354085 Node: binary not installed355715 Node: binary pre-installed356219 Node: source pre-installed356848 Node: source not installed357910 Node: Presetting Options359035 Node: loading rcfile361308 Node: saving rcfile363014 Node: sample rcfile363523 Node: environrc371855 Node: config example373744 Node: Config File Format375539 Node: config name/string-value376583 Node: config integer-values378802 Node: config nested-values379306 Node: config sections379788 Node: config comments381166 Node: shell options381589 Node: binary-parser383412 Node: script-parser385766 Node: AutoInfo411343 Node: command-info412695 Node: library-info413731 Node: AutoMan pages414976 Node: man1415430 Node: man3416888 Node: getopt_long420110 Node: i18n423004 Node: Naming Conflicts424417 Node: Option Define Names425805 Node: Add-Ons435752 Node: AutoFSM436743 Node: AutoXDR437166 Node: AutoEvents437997 Node: columns Invocation439253 Node: columns usage441474 Node: columns width444535 Node: columns columns445040 Node: columns col-width445434 Node: columns spread445846 Node: columns fill446212 Node: columns indent446754 Node: columns first-indent447132 Node: columns tab-width447632 Node: columns sort447946 Node: columns format448391 Node: columns separation448776 Node: columns line-separation449123 Node: columns by-columns449479 Node: columns input449922 Node: getdefs Invocation450299 Node: getdefs usage453752 Node: getdefs defs-to-get457788 Node: getdefs ordering458203 Node: getdefs first-index458821 Node: getdefs input459242 Node: getdefs subblock459962 Node: getdefs listattr460992 Node: getdefs filelist461817 Node: getdefs assign462276 Node: getdefs common-assign462693 Node: getdefs copy463148 Node: getdefs srcfile463562 Node: getdefs linenum464044 Node: getdefs output464534 Node: getdefs autogen464936 Node: getdefs template465537 Node: getdefs agarg465791 Node: getdefs base-name466277 Node: xml2ag Invocation466892 Node: xml2ag usage469828 Node: xml2ag output473038 Node: xml2ag templ-dirs473399 Node: xml2ag override-tpl473763 Node: xml2ag lib-template474028 Node: xml2ag base-name474391 Node: xml2ag definitions474645 Node: xml2ag load-scheme474890 Node: xml2ag load-functions475159 Node: xml2ag skip-suffix475572 Node: xml2ag select-suffix475943 Node: xml2ag source-time476317 Node: xml2ag no-fmemopen476581 Node: xml2ag equate476981 Node: xml2ag writable477234 Node: xml2ag loop-limit477467 Node: xml2ag timeout477723 Node: xml2ag trace477980 Node: xml2ag trace-out478624 Node: xml2ag show-defs478872 Node: xml2ag used-defines479127 Node: xml2ag define479384 Node: xml2ag undefine479740 Node: snprintfv480100 Node: Future482617 Node: Copying This Manual482956 Node: Concept Index505487 Node: Function Index524470  End Tag Table