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 .  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