--- /srv/reproducible-results/rbuild-debian/r-b-build.smVoB9oq/b1/automake1.11_1.11.6-6_i386.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.smVoB9oq/b2/automake1.11_1.11.6-6_i386.changes ├── Files │ @@ -1,2 +1,2 @@ │ │ - ca6f8bcaf636e689f54f12f85e990651 535284 devel optional automake1.11_1.11.6-6_all.deb │ + e9cc57560dedbc94838cfc9fbb7cdaa0 535324 devel optional automake1.11_1.11.6-6_all.deb ├── automake1.11_1.11.6-6_all.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2021-01-04 18:54:23.000000 debian-binary │ │ --rw-r--r-- 0 0 0 4476 2021-01-04 18:54:23.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 530616 2021-01-04 18:54:23.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 4472 2021-01-04 18:54:23.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 530660 2021-01-04 18:54:23.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -1,12 +1,12 @@ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/bin/ │ │ │ │ -rwxr-xr-x 0 root (0) root (0) 31694 2021-01-04 18:54:23.000000 ./usr/bin/aclocal-1.11 │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 260056 2021-01-04 18:54:23.000000 ./usr/bin/automake-1.11 │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 260054 2021-01-04 18:54:23.000000 ./usr/bin/automake-1.11 │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/aclocal/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/aclocal-1.11/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1662 2021-01-04 18:54:23.000000 ./usr/share/aclocal-1.11/amversion.m4 │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2036 2021-01-04 18:54:23.000000 ./usr/share/aclocal-1.11/ar-lib.m4 │ │ │ │ -rw-r--r-- 0 root (0) root (0) 799 2021-01-04 18:54:23.000000 ./usr/share/aclocal-1.11/as.m4 │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2455 2021-01-04 18:54:23.000000 ./usr/share/aclocal-1.11/auxdir.m4 │ │ │ │ @@ -136,17 +136,17 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 457 2021-01-04 18:54:23.000000 ./usr/share/doc/automake1.11/README.Debian │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3434 2021-01-04 18:54:23.000000 ./usr/share/doc/automake1.11/changelog.Debian.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 25770 2012-07-09 16:09:42.000000 ./usr/share/doc/automake1.11/changelog.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3028 2021-01-04 18:54:23.000000 ./usr/share/doc/automake1.11/copyright │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/doc-base/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 644 2021-01-04 18:54:23.000000 ./usr/share/doc-base/automake-1.11 │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/info/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 88713 2021-01-04 18:54:23.000000 ./usr/share/info/automake-1.11.info-1.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 82742 2021-01-04 18:54:23.000000 ./usr/share/info/automake-1.11.info-2.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 3049 2021-01-04 18:54:23.000000 ./usr/share/info/automake-1.11.info.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 88715 2021-01-04 18:54:23.000000 ./usr/share/info/automake-1.11.info-1.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 82745 2021-01-04 18:54:23.000000 ./usr/share/info/automake-1.11.info-2.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 3053 2021-01-04 18:54:23.000000 ./usr/share/info/automake-1.11.info.gz │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/lintian/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/lintian/overrides/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 65 2021-01-04 18:54:23.000000 ./usr/share/lintian/overrides/automake1.11 │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/man/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-01-04 18:54:23.000000 ./usr/share/man/man1/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1210 2021-01-04 18:54:23.000000 ./usr/share/man/man1/aclocal-1.11.1.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1648 2021-01-04 18:54:23.000000 ./usr/share/man/man1/automake-1.11.1.gz │ │ │ ├── ./usr/bin/automake-1.11 │ │ │ │ @@ -37,15 +37,15 @@ │ │ │ │ # Override SHELL. This is required on DJGPP so that system() uses │ │ │ │ # bash, not COMMAND.COM which doesn't quote arguments properly. │ │ │ │ # Other systems aren't expected to use $SHELL when Automake │ │ │ │ # runs, but it should be safe to drop the `if DJGPP' guard if │ │ │ │ # it turns up other systems need the same thing. After all, │ │ │ │ # if SHELL is used, ./configure's SHELL is always better than │ │ │ │ # the user's SHELL (which may be something like tcsh). │ │ │ │ - $ENV{'SHELL'} = '/bin/bash' if exists $ENV{'DJDIR'}; │ │ │ │ + $ENV{'SHELL'} = '/bin/sh' if exists $ENV{'DJDIR'}; │ │ │ │ } │ │ │ │ │ │ │ │ use Automake::Struct; │ │ │ │ struct (# Short name of the language (c, f77...). │ │ │ │ 'name' => "\$", │ │ │ │ # Nice name of the language (C, Fortran 77...). │ │ │ │ 'Name' => "\$", │ │ │ ├── ./usr/share/info/automake-1.11.info-1.gz │ │ │ │ ├── automake-1.11.info-1 │ │ │ │ │ @@ -2,18777 +2,18777 @@ │ │ │ │ │ 00000010: 2d31 2e31 312e 696e 666f 2c20 7072 6f64 -1.11.info, prod │ │ │ │ │ 00000020: 7563 6564 2062 7920 6d61 6b65 696e 666f uced by makeinfo │ │ │ │ │ 00000030: 2076 6572 7369 6f6e 2036 2e37 2066 726f version 6.7 fro │ │ │ │ │ 00000040: 6d0a 6175 746f 6d61 6b65 2e74 6578 692e m.automake.texi. │ │ │ │ │ 00000050: 0a0a 5468 6973 206d 616e 7561 6c20 6973 ..This manual is │ │ │ │ │ 00000060: 2066 6f72 2047 4e55 2041 7574 6f6d 616b for GNU Automak │ │ │ │ │ 00000070: 6520 2876 6572 7369 6f6e 2031 2e31 312e e (version 1.11. │ │ │ │ │ -00000080: 362c 2031 3420 4a61 6e75 6172 7920 3230 6, 14 January 20 │ │ │ │ │ -00000090: 3234 292c 2061 0a70 726f 6772 616d 2074 24), a.program t │ │ │ │ │ -000000a0: 6861 7420 6372 6561 7465 7320 474e 5520 hat creates GNU │ │ │ │ │ -000000b0: 7374 616e 6461 7264 732d 636f 6d70 6c69 standards-compli │ │ │ │ │ -000000c0: 616e 7420 4d61 6b65 6669 6c65 7320 6672 ant Makefiles fr │ │ │ │ │ -000000d0: 6f6d 2074 656d 706c 6174 650a 6669 6c65 om template.file │ │ │ │ │ -000000e0: 732e 0a0a 2020 2043 6f70 7972 6967 6874 s... Copyright │ │ │ │ │ -000000f0: 2028 4329 2031 3939 352c 2031 3939 362c (C) 1995, 1996, │ │ │ │ │ -00000100: 2031 3939 372c 2031 3939 382c 2031 3939 1997, 1998, 199 │ │ │ │ │ -00000110: 392c 2032 3030 302c 2032 3030 312c 2032 9, 2000, 2001, 2 │ │ │ │ │ -00000120: 3030 322c 2032 3030 332c 0a32 3030 342c 002, 2003,.2004, │ │ │ │ │ -00000130: 2032 3030 352c 2032 3030 362c 2032 3030 2005, 2006, 200 │ │ │ │ │ -00000140: 372c 2032 3030 382c 2032 3030 392c 2032 7, 2008, 2009, 2 │ │ │ │ │ -00000150: 3031 302c 2032 3031 312c 2032 3031 3220 010, 2011, 2012 │ │ │ │ │ -00000160: 4672 6565 2053 6f66 7477 6172 650a 466f Free Software.Fo │ │ │ │ │ -00000170: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ -00000180: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ -00000190: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ -000001a0: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ -000001b0: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ -000001c0: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ -000001d0: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ -000001e0: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ -000001f0: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ -00000200: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ -00000210: 696f 6e20 312e 3320 6f72 2061 6e79 206c ion 1.3 or any l │ │ │ │ │ -00000220: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ -00000230: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ -00000240: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ -00000250: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ -00000260: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ -00000270: 6563 7469 6f6e 732c 2077 6974 6820 6e6f ections, with no │ │ │ │ │ -00000280: 2046 726f 6e74 2d43 6f76 6572 2074 6578 Front-Cover tex │ │ │ │ │ -00000290: 7473 2c0a 2020 2020 2061 6e64 2077 6974 ts,. and wit │ │ │ │ │ -000002a0: 6820 6e6f 2042 6163 6b2d 436f 7665 7220 h no Back-Cover │ │ │ │ │ -000002b0: 5465 7874 732e 2020 4120 636f 7079 206f Texts. A copy o │ │ │ │ │ -000002c0: 6620 7468 6520 6c69 6365 6e73 6520 6973 f the license is │ │ │ │ │ -000002d0: 2069 6e63 6c75 6465 6420 696e 0a20 2020 included in. │ │ │ │ │ -000002e0: 2020 7468 6520 7365 6374 696f 6e20 656e the section en │ │ │ │ │ -000002f0: 7469 746c 6564 2022 474e 5520 4672 6565 titled "GNU Free │ │ │ │ │ -00000300: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00000310: 6963 656e 7365 2e22 0a0a 494e 464f 2d44 icense."..INFO-D │ │ │ │ │ -00000320: 4952 2d53 4543 5449 4f4e 2053 6f66 7477 IR-SECTION Softw │ │ │ │ │ -00000330: 6172 6520 6465 7665 6c6f 706d 656e 740a are development. │ │ │ │ │ -00000340: 5354 4152 542d 494e 464f 2d44 4952 2d45 START-INFO-DIR-E │ │ │ │ │ -00000350: 4e54 5259 0a2a 2041 7574 6f6d 616b 653a NTRY.* Automake: │ │ │ │ │ -00000360: 2028 6175 746f 6d61 6b65 2d31 2e31 3129 (automake-1.11) │ │ │ │ │ -00000370: 2e20 2020 2020 2020 2020 4d61 6b69 6e67 . Making │ │ │ │ │ -00000380: 2047 4e55 2073 7461 6e64 6172 6473 2d63 GNU standards-c │ │ │ │ │ -00000390: 6f6d 706c 6961 6e74 204d 616b 6566 696c ompliant Makefil │ │ │ │ │ -000003a0: 6573 2e0a 454e 442d 494e 464f 2d44 4952 es..END-INFO-DIR │ │ │ │ │ -000003b0: 2d45 4e54 5259 0a0a 494e 464f 2d44 4952 -ENTRY..INFO-DIR │ │ │ │ │ -000003c0: 2d53 4543 5449 4f4e 2049 6e64 6976 6964 -SECTION Individ │ │ │ │ │ -000003d0: 7561 6c20 7574 696c 6974 6965 730a 5354 ual utilities.ST │ │ │ │ │ -000003e0: 4152 542d 494e 464f 2d44 4952 2d45 4e54 ART-INFO-DIR-ENT │ │ │ │ │ -000003f0: 5259 0a2a 2061 636c 6f63 616c 2d69 6e76 RY.* aclocal-inv │ │ │ │ │ -00000400: 6f63 6174 696f 6e3a 2028 6175 746f 6d61 ocation: (automa │ │ │ │ │ -00000410: 6b65 2d31 2e31 3129 6163 6c6f 6361 6c20 ke-1.11)aclocal │ │ │ │ │ -00000420: 496e 766f 6361 7469 6f6e 2e20 2047 656e Invocation. Gen │ │ │ │ │ -00000430: 6572 6174 696e 6720 6163 6c6f 6361 6c2e erating aclocal. │ │ │ │ │ -00000440: 6d34 2e0a 2a20 6175 746f 6d61 6b65 2d69 m4..* automake-i │ │ │ │ │ -00000450: 6e76 6f63 6174 696f 6e3a 2028 6175 746f nvocation: (auto │ │ │ │ │ -00000460: 6d61 6b65 2d31 2e31 3129 6175 746f 6d61 make-1.11)automa │ │ │ │ │ -00000470: 6b65 2049 6e76 6f63 6174 696f 6e2e 2047 ke Invocation. G │ │ │ │ │ -00000480: 656e 6572 6174 696e 6720 4d61 6b65 6669 enerating Makefi │ │ │ │ │ -00000490: 6c65 2e69 6e2e 0a45 4e44 2d49 4e46 4f2d le.in..END-INFO- │ │ │ │ │ -000004a0: 4449 522d 454e 5452 590a 0a1f 0a46 696c DIR-ENTRY....Fil │ │ │ │ │ -000004b0: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -000004c0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 546f .info, Node: To │ │ │ │ │ -000004d0: 702c 2020 4e65 7874 3a20 496e 7472 6f64 p, Next: Introd │ │ │ │ │ -000004e0: 7563 7469 6f6e 2c20 2055 703a 2028 6469 uction, Up: (di │ │ │ │ │ -000004f0: 7229 0a0a 474e 5520 4175 746f 6d61 6b65 r)..GNU Automake │ │ │ │ │ -00000500: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 .************..T │ │ │ │ │ -00000510: 6869 7320 6d61 6e75 616c 2069 7320 666f his manual is fo │ │ │ │ │ -00000520: 7220 474e 5520 4175 746f 6d61 6b65 2028 r GNU Automake ( │ │ │ │ │ -00000530: 7665 7273 696f 6e20 312e 3131 2e36 2c20 version 1.11.6, │ │ │ │ │ -00000540: 3134 204a 616e 7561 7279 2032 3032 3429 14 January 2024) │ │ │ │ │ -00000550: 2c20 610a 7072 6f67 7261 6d20 7468 6174 , a.program that │ │ │ │ │ -00000560: 2063 7265 6174 6573 2047 4e55 2073 7461 creates GNU sta │ │ │ │ │ -00000570: 6e64 6172 6473 2d63 6f6d 706c 6961 6e74 ndards-compliant │ │ │ │ │ -00000580: 204d 616b 6566 696c 6573 2066 726f 6d20 Makefiles from │ │ │ │ │ -00000590: 7465 6d70 6c61 7465 0a66 696c 6573 2e0a template.files.. │ │ │ │ │ -000005a0: 0a20 2020 436f 7079 7269 6768 7420 2843 . Copyright (C │ │ │ │ │ -000005b0: 2920 3139 3935 2c20 3139 3936 2c20 3139 ) 1995, 1996, 19 │ │ │ │ │ -000005c0: 3937 2c20 3139 3938 2c20 3139 3939 2c20 97, 1998, 1999, │ │ │ │ │ -000005d0: 3230 3030 2c20 3230 3031 2c20 3230 3032 2000, 2001, 2002 │ │ │ │ │ -000005e0: 2c20 3230 3033 2c0a 3230 3034 2c20 3230 , 2003,.2004, 20 │ │ │ │ │ -000005f0: 3035 2c20 3230 3036 2c20 3230 3037 2c20 05, 2006, 2007, │ │ │ │ │ -00000600: 3230 3038 2c20 3230 3039 2c20 3230 3130 2008, 2009, 2010 │ │ │ │ │ -00000610: 2c20 3230 3131 2c20 3230 3132 2046 7265 , 2011, 2012 Fre │ │ │ │ │ -00000620: 6520 536f 6674 7761 7265 0a46 6f75 6e64 e Software.Found │ │ │ │ │ -00000630: 6174 696f 6e2c 2049 6e63 2e0a 0a20 2020 ation, Inc... │ │ │ │ │ -00000640: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ │ -00000650: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ │ -00000660: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ │ -00000670: 6f72 206d 6f64 6966 7920 7468 6973 0a20 or modify this. │ │ │ │ │ -00000680: 2020 2020 646f 6375 6d65 6e74 2075 6e64 document und │ │ │ │ │ -00000690: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ -000006a0: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ │ -000006b0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ -000006c0: 7365 2c0a 2020 2020 2056 6572 7369 6f6e se,. Version │ │ │ │ │ -000006d0: 2031 2e33 206f 7220 616e 7920 6c61 7465 1.3 or any late │ │ │ │ │ -000006e0: 7220 7665 7273 696f 6e20 7075 626c 6973 r version publis │ │ │ │ │ -000006f0: 6865 6420 6279 2074 6865 2046 7265 6520 hed by the Free │ │ │ │ │ -00000700: 536f 6674 7761 7265 0a20 2020 2020 466f Software. Fo │ │ │ │ │ -00000710: 756e 6461 7469 6f6e 3b20 7769 7468 206e undation; with n │ │ │ │ │ -00000720: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ │ -00000730: 696f 6e73 2c20 7769 7468 206e 6f20 4672 ions, with no Fr │ │ │ │ │ -00000740: 6f6e 742d 436f 7665 7220 7465 7874 732c ont-Cover texts, │ │ │ │ │ -00000750: 0a20 2020 2020 616e 6420 7769 7468 206e . and with n │ │ │ │ │ -00000760: 6f20 4261 636b 2d43 6f76 6572 2054 6578 o Back-Cover Tex │ │ │ │ │ -00000770: 7473 2e20 2041 2063 6f70 7920 6f66 2074 ts. A copy of t │ │ │ │ │ -00000780: 6865 206c 6963 656e 7365 2069 7320 696e he license is in │ │ │ │ │ -00000790: 636c 7564 6564 2069 6e0a 2020 2020 2074 cluded in. t │ │ │ │ │ -000007a0: 6865 2073 6563 7469 6f6e 2065 6e74 6974 he section entit │ │ │ │ │ -000007b0: 6c65 6420 2247 4e55 2046 7265 6520 446f led "GNU Free Do │ │ │ │ │ -000007c0: 6375 6d65 6e74 6174 696f 6e20 4c69 6365 cumentation Lice │ │ │ │ │ -000007d0: 6e73 652e 220a 0a2a 204d 656e 753a 0a0a nse."..* Menu:.. │ │ │ │ │ -000007e0: 2a20 496e 7472 6f64 7563 7469 6f6e 3a3a * Introduction:: │ │ │ │ │ -000007f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000800: 4175 746f 6d61 6b65 2773 2070 7572 706f Automake's purpo │ │ │ │ │ -00000810: 7365 0a2a 2041 7574 6f74 6f6f 6c73 2049 se.* Autotools I │ │ │ │ │ -00000820: 6e74 726f 6475 6374 696f 6e3a 3a20 2020 ntroduction:: │ │ │ │ │ -00000830: 2020 2041 6e20 496e 7472 6f64 7563 7469 An Introducti │ │ │ │ │ -00000840: 6f6e 2074 6f20 7468 6520 4175 746f 746f on to the Autoto │ │ │ │ │ -00000850: 6f6c 730a 2a20 4765 6e65 7261 6c69 7469 ols.* Generaliti │ │ │ │ │ -00000860: 6573 3a3a 2020 2020 2020 2020 2020 2020 es:: │ │ │ │ │ -00000870: 2020 2020 4765 6e65 7261 6c20 6964 6561 General idea │ │ │ │ │ -00000880: 730a 2a20 4578 616d 706c 6573 3a3a 2020 s.* Examples:: │ │ │ │ │ +00000080: 362c 2031 3620 4665 6272 7561 7279 2032 6, 16 February 2 │ │ │ │ │ +00000090: 3032 3529 2c20 610a 7072 6f67 7261 6d20 025), a.program │ │ │ │ │ +000000a0: 7468 6174 2063 7265 6174 6573 2047 4e55 that creates GNU │ │ │ │ │ +000000b0: 2073 7461 6e64 6172 6473 2d63 6f6d 706c standards-compl │ │ │ │ │ +000000c0: 6961 6e74 204d 616b 6566 696c 6573 2066 iant Makefiles f │ │ │ │ │ +000000d0: 726f 6d20 7465 6d70 6c61 7465 0a66 696c rom template.fil │ │ │ │ │ +000000e0: 6573 2e0a 0a20 2020 436f 7079 7269 6768 es... Copyrigh │ │ │ │ │ +000000f0: 7420 2843 2920 3139 3935 2c20 3139 3936 t (C) 1995, 1996 │ │ │ │ │ +00000100: 2c20 3139 3937 2c20 3139 3938 2c20 3139 , 1997, 1998, 19 │ │ │ │ │ +00000110: 3939 2c20 3230 3030 2c20 3230 3031 2c20 99, 2000, 2001, │ │ │ │ │ +00000120: 3230 3032 2c20 3230 3033 2c0a 3230 3034 2002, 2003,.2004 │ │ │ │ │ +00000130: 2c20 3230 3035 2c20 3230 3036 2c20 3230 , 2005, 2006, 20 │ │ │ │ │ +00000140: 3037 2c20 3230 3038 2c20 3230 3039 2c20 07, 2008, 2009, │ │ │ │ │ +00000150: 3230 3130 2c20 3230 3131 2c20 3230 3132 2010, 2011, 2012 │ │ │ │ │ +00000160: 2046 7265 6520 536f 6674 7761 7265 0a46 Free Software.F │ │ │ │ │ +00000170: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ +00000180: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ +00000190: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ +000001a0: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ +000001b0: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ +000001c0: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ +000001d0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ +000001e0: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ +000001f0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ +00000200: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ +00000210: 7369 6f6e 2031 2e33 206f 7220 616e 7920 sion 1.3 or any │ │ │ │ │ +00000220: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ +00000230: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ +00000240: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ +00000250: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ +00000260: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ +00000270: 5365 6374 696f 6e73 2c20 7769 7468 206e Sections, with n │ │ │ │ │ +00000280: 6f20 4672 6f6e 742d 436f 7665 7220 7465 o Front-Cover te │ │ │ │ │ +00000290: 7874 732c 0a20 2020 2020 616e 6420 7769 xts,. and wi │ │ │ │ │ +000002a0: 7468 206e 6f20 4261 636b 2d43 6f76 6572 th no Back-Cover │ │ │ │ │ +000002b0: 2054 6578 7473 2e20 2041 2063 6f70 7920 Texts. A copy │ │ │ │ │ +000002c0: 6f66 2074 6865 206c 6963 656e 7365 2069 of the license i │ │ │ │ │ +000002d0: 7320 696e 636c 7564 6564 2069 6e0a 2020 s included in. │ │ │ │ │ +000002e0: 2020 2074 6865 2073 6563 7469 6f6e 2065 the section e │ │ │ │ │ +000002f0: 6e74 6974 6c65 6420 2247 4e55 2046 7265 ntitled "GNU Fre │ │ │ │ │ +00000300: 6520 446f 6375 6d65 6e74 6174 696f 6e20 e Documentation │ │ │ │ │ +00000310: 4c69 6365 6e73 652e 220a 0a49 4e46 4f2d License."..INFO- │ │ │ │ │ +00000320: 4449 522d 5345 4354 494f 4e20 536f 6674 DIR-SECTION Soft │ │ │ │ │ +00000330: 7761 7265 2064 6576 656c 6f70 6d65 6e74 ware development │ │ │ │ │ +00000340: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000350: 454e 5452 590a 2a20 4175 746f 6d61 6b65 ENTRY.* Automake │ │ │ │ │ +00000360: 3a20 2861 7574 6f6d 616b 652d 312e 3131 : (automake-1.11 │ │ │ │ │ +00000370: 292e 2020 2020 2020 2020 204d 616b 696e ). Makin │ │ │ │ │ +00000380: 6720 474e 5520 7374 616e 6461 7264 732d g GNU standards- │ │ │ │ │ +00000390: 636f 6d70 6c69 616e 7420 4d61 6b65 6669 compliant Makefi │ │ │ │ │ +000003a0: 6c65 732e 0a45 4e44 2d49 4e46 4f2d 4449 les..END-INFO-DI │ │ │ │ │ +000003b0: 522d 454e 5452 590a 0a49 4e46 4f2d 4449 R-ENTRY..INFO-DI │ │ │ │ │ +000003c0: 522d 5345 4354 494f 4e20 496e 6469 7669 R-SECTION Indivi │ │ │ │ │ +000003d0: 6475 616c 2075 7469 6c69 7469 6573 0a53 dual utilities.S │ │ │ │ │ +000003e0: 5441 5254 2d49 4e46 4f2d 4449 522d 454e TART-INFO-DIR-EN │ │ │ │ │ +000003f0: 5452 590a 2a20 6163 6c6f 6361 6c2d 696e TRY.* aclocal-in │ │ │ │ │ +00000400: 766f 6361 7469 6f6e 3a20 2861 7574 6f6d vocation: (autom │ │ │ │ │ +00000410: 616b 652d 312e 3131 2961 636c 6f63 616c ake-1.11)aclocal │ │ │ │ │ +00000420: 2049 6e76 6f63 6174 696f 6e2e 2020 4765 Invocation. Ge │ │ │ │ │ +00000430: 6e65 7261 7469 6e67 2061 636c 6f63 616c nerating aclocal │ │ │ │ │ +00000440: 2e6d 342e 0a2a 2061 7574 6f6d 616b 652d .m4..* automake- │ │ │ │ │ +00000450: 696e 766f 6361 7469 6f6e 3a20 2861 7574 invocation: (aut │ │ │ │ │ +00000460: 6f6d 616b 652d 312e 3131 2961 7574 6f6d omake-1.11)autom │ │ │ │ │ +00000470: 616b 6520 496e 766f 6361 7469 6f6e 2e20 ake Invocation. │ │ │ │ │ +00000480: 4765 6e65 7261 7469 6e67 204d 616b 6566 Generating Makef │ │ │ │ │ +00000490: 696c 652e 696e 2e0a 454e 442d 494e 464f ile.in..END-INFO │ │ │ │ │ +000004a0: 2d44 4952 2d45 4e54 5259 0a0a 1f0a 4669 -DIR-ENTRY....Fi │ │ │ │ │ +000004b0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +000004c0: 312e 696e 666f 2c20 204e 6f64 653a 2054 1.info, Node: T │ │ │ │ │ +000004d0: 6f70 2c20 204e 6578 743a 2049 6e74 726f op, Next: Intro │ │ │ │ │ +000004e0: 6475 6374 696f 6e2c 2020 5570 3a20 2864 duction, Up: (d │ │ │ │ │ +000004f0: 6972 290a 0a47 4e55 2041 7574 6f6d 616b ir)..GNU Automak │ │ │ │ │ +00000500: 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a e.************.. │ │ │ │ │ +00000510: 5468 6973 206d 616e 7561 6c20 6973 2066 This manual is f │ │ │ │ │ +00000520: 6f72 2047 4e55 2041 7574 6f6d 616b 6520 or GNU Automake │ │ │ │ │ +00000530: 2876 6572 7369 6f6e 2031 2e31 312e 362c (version 1.11.6, │ │ │ │ │ +00000540: 2031 3620 4665 6272 7561 7279 2032 3032 16 February 202 │ │ │ │ │ +00000550: 3529 2c20 610a 7072 6f67 7261 6d20 7468 5), a.program th │ │ │ │ │ +00000560: 6174 2063 7265 6174 6573 2047 4e55 2073 at creates GNU s │ │ │ │ │ +00000570: 7461 6e64 6172 6473 2d63 6f6d 706c 6961 tandards-complia │ │ │ │ │ +00000580: 6e74 204d 616b 6566 696c 6573 2066 726f nt Makefiles fro │ │ │ │ │ +00000590: 6d20 7465 6d70 6c61 7465 0a66 696c 6573 m template.files │ │ │ │ │ +000005a0: 2e0a 0a20 2020 436f 7079 7269 6768 7420 ... Copyright │ │ │ │ │ +000005b0: 2843 2920 3139 3935 2c20 3139 3936 2c20 (C) 1995, 1996, │ │ │ │ │ +000005c0: 3139 3937 2c20 3139 3938 2c20 3139 3939 1997, 1998, 1999 │ │ │ │ │ +000005d0: 2c20 3230 3030 2c20 3230 3031 2c20 3230 , 2000, 2001, 20 │ │ │ │ │ +000005e0: 3032 2c20 3230 3033 2c0a 3230 3034 2c20 02, 2003,.2004, │ │ │ │ │ +000005f0: 3230 3035 2c20 3230 3036 2c20 3230 3037 2005, 2006, 2007 │ │ │ │ │ +00000600: 2c20 3230 3038 2c20 3230 3039 2c20 3230 , 2008, 2009, 20 │ │ │ │ │ +00000610: 3130 2c20 3230 3131 2c20 3230 3132 2046 10, 2011, 2012 F │ │ │ │ │ +00000620: 7265 6520 536f 6674 7761 7265 0a46 6f75 ree Software.Fou │ │ │ │ │ +00000630: 6e64 6174 696f 6e2c 2049 6e63 2e0a 0a20 ndation, Inc... │ │ │ │ │ +00000640: 2020 2020 5065 726d 6973 7369 6f6e 2069 Permission i │ │ │ │ │ +00000650: 7320 6772 616e 7465 6420 746f 2063 6f70 s granted to cop │ │ │ │ │ +00000660: 792c 2064 6973 7472 6962 7574 6520 616e y, distribute an │ │ │ │ │ +00000670: 642f 6f72 206d 6f64 6966 7920 7468 6973 d/or modify this │ │ │ │ │ +00000680: 0a20 2020 2020 646f 6375 6d65 6e74 2075 . document u │ │ │ │ │ +00000690: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ +000006a0: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ +000006b0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +000006c0: 656e 7365 2c0a 2020 2020 2056 6572 7369 ense,. Versi │ │ │ │ │ +000006d0: 6f6e 2031 2e33 206f 7220 616e 7920 6c61 on 1.3 or any la │ │ │ │ │ +000006e0: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ +000006f0: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ +00000700: 6520 536f 6674 7761 7265 0a20 2020 2020 e Software. │ │ │ │ │ +00000710: 466f 756e 6461 7469 6f6e 3b20 7769 7468 Foundation; with │ │ │ │ │ +00000720: 206e 6f20 496e 7661 7269 616e 7420 5365 no Invariant Se │ │ │ │ │ +00000730: 6374 696f 6e73 2c20 7769 7468 206e 6f20 ctions, with no │ │ │ │ │ +00000740: 4672 6f6e 742d 436f 7665 7220 7465 7874 Front-Cover text │ │ │ │ │ +00000750: 732c 0a20 2020 2020 616e 6420 7769 7468 s,. and with │ │ │ │ │ +00000760: 206e 6f20 4261 636b 2d43 6f76 6572 2054 no Back-Cover T │ │ │ │ │ +00000770: 6578 7473 2e20 2041 2063 6f70 7920 6f66 exts. A copy of │ │ │ │ │ +00000780: 2074 6865 206c 6963 656e 7365 2069 7320 the license is │ │ │ │ │ +00000790: 696e 636c 7564 6564 2069 6e0a 2020 2020 included in. │ │ │ │ │ +000007a0: 2074 6865 2073 6563 7469 6f6e 2065 6e74 the section ent │ │ │ │ │ +000007b0: 6974 6c65 6420 2247 4e55 2046 7265 6520 itled "GNU Free │ │ │ │ │ +000007c0: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ +000007d0: 6365 6e73 652e 220a 0a2a 204d 656e 753a cense."..* Menu: │ │ │ │ │ +000007e0: 0a0a 2a20 496e 7472 6f64 7563 7469 6f6e ..* Introduction │ │ │ │ │ +000007f0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00000800: 2020 4175 746f 6d61 6b65 2773 2070 7572 Automake's pur │ │ │ │ │ +00000810: 706f 7365 0a2a 2041 7574 6f74 6f6f 6c73 pose.* Autotools │ │ │ │ │ +00000820: 2049 6e74 726f 6475 6374 696f 6e3a 3a20 Introduction:: │ │ │ │ │ +00000830: 2020 2020 2041 6e20 496e 7472 6f64 7563 An Introduc │ │ │ │ │ +00000840: 7469 6f6e 2074 6f20 7468 6520 4175 746f tion to the Auto │ │ │ │ │ +00000850: 746f 6f6c 730a 2a20 4765 6e65 7261 6c69 tools.* Generali │ │ │ │ │ +00000860: 7469 6573 3a3a 2020 2020 2020 2020 2020 ties:: │ │ │ │ │ +00000870: 2020 2020 2020 4765 6e65 7261 6c20 6964 General id │ │ │ │ │ +00000880: 6561 730a 2a20 4578 616d 706c 6573 3a3a eas.* Examples:: │ │ │ │ │ 00000890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000008a0: 2020 536f 6d65 2065 7861 6d70 6c65 2070 Some example p │ │ │ │ │ -000008b0: 6163 6b61 6765 730a 2a20 6175 746f 6d61 ackages.* automa │ │ │ │ │ -000008c0: 6b65 2049 6e76 6f63 6174 696f 6e3a 3a20 ke Invocation:: │ │ │ │ │ -000008d0: 2020 2020 2020 2020 4372 6561 7469 6e67 Creating │ │ │ │ │ -000008e0: 2061 204d 616b 6566 696c 652e 696e 0a2a a Makefile.in.* │ │ │ │ │ -000008f0: 2063 6f6e 6669 6775 7265 3a3a 2020 2020 configure:: │ │ │ │ │ -00000900: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -00000910: 6361 6e6e 696e 6720 636f 6e66 6967 7572 canning configur │ │ │ │ │ -00000920: 652e 6163 2c20 7573 696e 6720 6163 6c6f e.ac, using aclo │ │ │ │ │ -00000930: 6361 6c0a 2a20 4469 7265 6374 6f72 6965 cal.* Directorie │ │ │ │ │ -00000940: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ -00000950: 2020 2020 4465 636c 6172 696e 6720 7375 Declaring su │ │ │ │ │ -00000960: 6264 6972 6563 746f 7269 6573 0a2a 2050 bdirectories.* P │ │ │ │ │ -00000970: 726f 6772 616d 733a 3a20 2020 2020 2020 rograms:: │ │ │ │ │ -00000980: 2020 2020 2020 2020 2020 2020 2042 7569 Bui │ │ │ │ │ -00000990: 6c64 696e 6720 7072 6f67 7261 6d73 2061 lding programs a │ │ │ │ │ -000009a0: 6e64 206c 6962 7261 7269 6573 0a2a 204f nd libraries.* O │ │ │ │ │ -000009b0: 7468 6572 204f 626a 6563 7473 3a3a 2020 ther Objects:: │ │ │ │ │ -000009c0: 2020 2020 2020 2020 2020 2020 204f 7468 Oth │ │ │ │ │ -000009d0: 6572 2064 6572 6976 6564 206f 626a 6563 er derived objec │ │ │ │ │ -000009e0: 7473 0a2a 204f 7468 6572 2047 4e55 2054 ts.* Other GNU T │ │ │ │ │ -000009f0: 6f6f 6c73 3a3a 2020 2020 2020 2020 2020 ools:: │ │ │ │ │ -00000a00: 2020 204f 7468 6572 2047 4e55 2054 6f6f Other GNU Too │ │ │ │ │ -00000a10: 6c73 0a2a 2044 6f63 756d 656e 7461 7469 ls.* Documentati │ │ │ │ │ -00000a20: 6f6e 3a3a 2020 2020 2020 2020 2020 2020 on:: │ │ │ │ │ -00000a30: 2020 2042 7569 6c64 696e 6720 646f 6375 Building docu │ │ │ │ │ -00000a40: 6d65 6e74 6174 696f 6e0a 2a20 496e 7374 mentation.* Inst │ │ │ │ │ -00000a50: 616c 6c3a 3a20 2020 2020 2020 2020 2020 all:: │ │ │ │ │ -00000a60: 2020 2020 2020 2020 2020 5768 6174 2067 What g │ │ │ │ │ -00000a70: 6574 7320 696e 7374 616c 6c65 640a 2a20 ets installed.* │ │ │ │ │ -00000a80: 436c 6561 6e3a 3a20 2020 2020 2020 2020 Clean:: │ │ │ │ │ -00000a90: 2020 2020 2020 2020 2020 2020 2020 5768 Wh │ │ │ │ │ -00000aa0: 6174 2067 6574 7320 636c 6561 6e65 640a at gets cleaned. │ │ │ │ │ -00000ab0: 2a20 4469 7374 3a3a 2020 2020 2020 2020 * Dist:: │ │ │ │ │ +000008a0: 2020 2020 536f 6d65 2065 7861 6d70 6c65 Some example │ │ │ │ │ +000008b0: 2070 6163 6b61 6765 730a 2a20 6175 746f packages.* auto │ │ │ │ │ +000008c0: 6d61 6b65 2049 6e76 6f63 6174 696f 6e3a make Invocation: │ │ │ │ │ +000008d0: 3a20 2020 2020 2020 2020 4372 6561 7469 : Creati │ │ │ │ │ +000008e0: 6e67 2061 204d 616b 6566 696c 652e 696e ng a Makefile.in │ │ │ │ │ +000008f0: 0a2a 2063 6f6e 6669 6775 7265 3a3a 2020 .* configure:: │ │ │ │ │ +00000900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000910: 2053 6361 6e6e 696e 6720 636f 6e66 6967 Scanning config │ │ │ │ │ +00000920: 7572 652e 6163 2c20 7573 696e 6720 6163 ure.ac, using ac │ │ │ │ │ +00000930: 6c6f 6361 6c0a 2a20 4469 7265 6374 6f72 local.* Director │ │ │ │ │ +00000940: 6965 733a 3a20 2020 2020 2020 2020 2020 ies:: │ │ │ │ │ +00000950: 2020 2020 2020 4465 636c 6172 696e 6720 Declaring │ │ │ │ │ +00000960: 7375 6264 6972 6563 746f 7269 6573 0a2a subdirectories.* │ │ │ │ │ +00000970: 2050 726f 6772 616d 733a 3a20 2020 2020 Programs:: │ │ │ │ │ +00000980: 2020 2020 2020 2020 2020 2020 2020 2042 B │ │ │ │ │ +00000990: 7569 6c64 696e 6720 7072 6f67 7261 6d73 uilding programs │ │ │ │ │ +000009a0: 2061 6e64 206c 6962 7261 7269 6573 0a2a and libraries.* │ │ │ │ │ +000009b0: 204f 7468 6572 204f 626a 6563 7473 3a3a Other Objects:: │ │ │ │ │ +000009c0: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +000009d0: 7468 6572 2064 6572 6976 6564 206f 626a ther derived obj │ │ │ │ │ +000009e0: 6563 7473 0a2a 204f 7468 6572 2047 4e55 ects.* Other GNU │ │ │ │ │ +000009f0: 2054 6f6f 6c73 3a3a 2020 2020 2020 2020 Tools:: │ │ │ │ │ +00000a00: 2020 2020 204f 7468 6572 2047 4e55 2054 Other GNU T │ │ │ │ │ +00000a10: 6f6f 6c73 0a2a 2044 6f63 756d 656e 7461 ools.* Documenta │ │ │ │ │ +00000a20: 7469 6f6e 3a3a 2020 2020 2020 2020 2020 tion:: │ │ │ │ │ +00000a30: 2020 2020 2042 7569 6c64 696e 6720 646f Building do │ │ │ │ │ +00000a40: 6375 6d65 6e74 6174 696f 6e0a 2a20 496e cumentation.* In │ │ │ │ │ +00000a50: 7374 616c 6c3a 3a20 2020 2020 2020 2020 stall:: │ │ │ │ │ +00000a60: 2020 2020 2020 2020 2020 2020 5768 6174 What │ │ │ │ │ +00000a70: 2067 6574 7320 696e 7374 616c 6c65 640a gets installed. │ │ │ │ │ +00000a80: 2a20 436c 6561 6e3a 3a20 2020 2020 2020 * Clean:: │ │ │ │ │ +00000a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000aa0: 5768 6174 2067 6574 7320 636c 6561 6e65 What gets cleane │ │ │ │ │ +00000ab0: 640a 2a20 4469 7374 3a3a 2020 2020 2020 d.* Dist:: │ │ │ │ │ 00000ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ad0: 5768 6174 2067 6f65 7320 696e 2061 2064 What goes in a d │ │ │ │ │ -00000ae0: 6973 7472 6962 7574 696f 6e0a 2a20 5465 istribution.* Te │ │ │ │ │ -00000af0: 7374 733a 3a20 2020 2020 2020 2020 2020 sts:: │ │ │ │ │ -00000b00: 2020 2020 2020 2020 2020 2020 5375 7070 Supp │ │ │ │ │ -00000b10: 6f72 7420 666f 7220 7465 7374 2073 7569 ort for test sui │ │ │ │ │ -00000b20: 7465 730a 2a20 5265 6275 696c 6469 6e67 tes.* Rebuilding │ │ │ │ │ -00000b30: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00000b40: 2020 2020 4175 746f 6d61 7469 6320 7265 Automatic re │ │ │ │ │ -00000b50: 6275 696c 6469 6e67 206f 6620 4d61 6b65 building of Make │ │ │ │ │ -00000b60: 6669 6c65 0a2a 204f 7074 696f 6e73 3a3a file.* Options:: │ │ │ │ │ -00000b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000b80: 2020 2020 2043 6861 6e67 696e 6720 4175 Changing Au │ │ │ │ │ -00000b90: 746f 6d61 6b65 2773 2062 6568 6176 696f tomake's behavio │ │ │ │ │ -00000ba0: 720a 2a20 4d69 7363 656c 6c61 6e65 6f75 r.* Miscellaneou │ │ │ │ │ -00000bb0: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ -00000bc0: 2020 4d69 7363 656c 6c61 6e65 6f75 7320 Miscellaneous │ │ │ │ │ -00000bd0: 7275 6c65 730a 2a20 496e 636c 7564 653a rules.* Include: │ │ │ │ │ -00000be0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00000bf0: 2020 2020 2020 496e 636c 7564 696e 6720 Including │ │ │ │ │ -00000c00: 6578 7472 6120 6669 6c65 7320 696e 2061 extra files in a │ │ │ │ │ -00000c10: 6e20 4175 746f 6d61 6b65 2074 656d 706c n Automake templ │ │ │ │ │ -00000c20: 6174 650a 2a20 436f 6e64 6974 696f 6e61 ate.* Conditiona │ │ │ │ │ -00000c30: 6c73 3a3a 2020 2020 2020 2020 2020 2020 ls:: │ │ │ │ │ -00000c40: 2020 2020 436f 6e64 6974 696f 6e61 6c73 Conditionals │ │ │ │ │ -00000c50: 0a2a 2053 696c 656e 6369 6e67 204d 616b .* Silencing Mak │ │ │ │ │ -00000c60: 653a 3a20 2020 2020 2020 2020 2020 2020 e:: │ │ │ │ │ -00000c70: 204f 6274 6169 6e20 6c65 7373 2076 6572 Obtain less ver │ │ │ │ │ -00000c80: 626f 7365 206f 7574 7075 7420 6672 6f6d bose output from │ │ │ │ │ -00000c90: 2027 6d61 6b65 270a 2a20 476e 6974 733a 'make'.* Gnits: │ │ │ │ │ -00000ca0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00000cb0: 2020 2020 2020 2020 5468 6520 6566 6665 The effe │ │ │ │ │ -00000cc0: 6374 206f 6620 272d 2d67 6e75 2720 616e ct of '--gnu' an │ │ │ │ │ -00000cd0: 6420 272d 2d67 6e69 7473 270a 2a20 4379 d '--gnits'.* Cy │ │ │ │ │ -00000ce0: 676e 7573 3a3a 2020 2020 2020 2020 2020 gnus:: │ │ │ │ │ -00000cf0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ -00000d00: 6566 6665 6374 206f 6620 272d 2d63 7967 effect of '--cyg │ │ │ │ │ -00000d10: 6e75 7327 2028 6465 7072 6563 6174 6564 nus' (deprecated │ │ │ │ │ -00000d20: 2c20 736f 6f6e 2074 6f20 6265 2072 656d , soon to be rem │ │ │ │ │ -00000d30: 6f76 6564 290a 2a20 4e6f 7420 456e 6f75 oved).* Not Enou │ │ │ │ │ -00000d40: 6768 3a3a 2020 2020 2020 2020 2020 2020 gh:: │ │ │ │ │ -00000d50: 2020 2020 2020 5768 656e 2041 7574 6f6d When Autom │ │ │ │ │ -00000d60: 616b 6520 6973 206e 6f74 2045 6e6f 7567 ake is not Enoug │ │ │ │ │ -00000d70: 680a 2a20 4469 7374 7269 6275 7469 6e67 h.* Distributing │ │ │ │ │ -00000d80: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00000d90: 2020 4469 7374 7269 6275 7469 6e67 2074 Distributing t │ │ │ │ │ -00000da0: 6865 204d 616b 6566 696c 652e 696e 0a2a he Makefile.in.* │ │ │ │ │ -00000db0: 2041 5049 2056 6572 7369 6f6e 696e 673a API Versioning: │ │ │ │ │ -00000dc0: 3a20 2020 2020 2020 2020 2020 2020 2041 : A │ │ │ │ │ -00000dd0: 626f 7574 2063 6f6d 7061 7469 6269 6c69 bout compatibili │ │ │ │ │ -00000de0: 7479 2062 6574 7765 656e 2041 7574 6f6d ty between Autom │ │ │ │ │ -00000df0: 616b 6520 7665 7273 696f 6e73 0a2a 2055 ake versions.* U │ │ │ │ │ -00000e00: 7067 7261 6469 6e67 3a3a 2020 2020 2020 pgrading:: │ │ │ │ │ -00000e10: 2020 2020 2020 2020 2020 2020 2055 7067 Upg │ │ │ │ │ -00000e20: 7261 6469 6e67 2074 6f20 6120 4e65 7765 rading to a Newe │ │ │ │ │ -00000e30: 7220 4175 746f 6d61 6b65 2056 6572 7369 r Automake Versi │ │ │ │ │ -00000e40: 6f6e 0a2a 2046 4151 3a3a 2020 2020 2020 on.* FAQ:: │ │ │ │ │ +00000ad0: 2020 5768 6174 2067 6f65 7320 696e 2061 What goes in a │ │ │ │ │ +00000ae0: 2064 6973 7472 6962 7574 696f 6e0a 2a20 distribution.* │ │ │ │ │ +00000af0: 5465 7374 733a 3a20 2020 2020 2020 2020 Tests:: │ │ │ │ │ +00000b00: 2020 2020 2020 2020 2020 2020 2020 5375 Su │ │ │ │ │ +00000b10: 7070 6f72 7420 666f 7220 7465 7374 2073 pport for test s │ │ │ │ │ +00000b20: 7569 7465 730a 2a20 5265 6275 696c 6469 uites.* Rebuildi │ │ │ │ │ +00000b30: 6e67 3a3a 2020 2020 2020 2020 2020 2020 ng:: │ │ │ │ │ +00000b40: 2020 2020 2020 4175 746f 6d61 7469 6320 Automatic │ │ │ │ │ +00000b50: 7265 6275 696c 6469 6e67 206f 6620 4d61 rebuilding of Ma │ │ │ │ │ +00000b60: 6b65 6669 6c65 0a2a 204f 7074 696f 6e73 kefile.* Options │ │ │ │ │ +00000b70: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00000b80: 2020 2020 2020 2043 6861 6e67 696e 6720 Changing │ │ │ │ │ +00000b90: 4175 746f 6d61 6b65 2773 2062 6568 6176 Automake's behav │ │ │ │ │ +00000ba0: 696f 720a 2a20 4d69 7363 656c 6c61 6e65 ior.* Miscellane │ │ │ │ │ +00000bb0: 6f75 733a 3a20 2020 2020 2020 2020 2020 ous:: │ │ │ │ │ +00000bc0: 2020 2020 4d69 7363 656c 6c61 6e65 6f75 Miscellaneou │ │ │ │ │ +00000bd0: 7320 7275 6c65 730a 2a20 496e 636c 7564 s rules.* Includ │ │ │ │ │ +00000be0: 653a 3a20 2020 2020 2020 2020 2020 2020 e:: │ │ │ │ │ +00000bf0: 2020 2020 2020 2020 496e 636c 7564 696e Includin │ │ │ │ │ +00000c00: 6720 6578 7472 6120 6669 6c65 7320 696e g extra files in │ │ │ │ │ +00000c10: 2061 6e20 4175 746f 6d61 6b65 2074 656d an Automake tem │ │ │ │ │ +00000c20: 706c 6174 650a 2a20 436f 6e64 6974 696f plate.* Conditio │ │ │ │ │ +00000c30: 6e61 6c73 3a3a 2020 2020 2020 2020 2020 nals:: │ │ │ │ │ +00000c40: 2020 2020 2020 436f 6e64 6974 696f 6e61 Conditiona │ │ │ │ │ +00000c50: 6c73 0a2a 2053 696c 656e 6369 6e67 204d ls.* Silencing M │ │ │ │ │ +00000c60: 616b 653a 3a20 2020 2020 2020 2020 2020 ake:: │ │ │ │ │ +00000c70: 2020 204f 6274 6169 6e20 6c65 7373 2076 Obtain less v │ │ │ │ │ +00000c80: 6572 626f 7365 206f 7574 7075 7420 6672 erbose output fr │ │ │ │ │ +00000c90: 6f6d 2027 6d61 6b65 270a 2a20 476e 6974 om 'make'.* Gnit │ │ │ │ │ +00000ca0: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ +00000cb0: 2020 2020 2020 2020 2020 5468 6520 6566 The ef │ │ │ │ │ +00000cc0: 6665 6374 206f 6620 272d 2d67 6e75 2720 fect of '--gnu' │ │ │ │ │ +00000cd0: 616e 6420 272d 2d67 6e69 7473 270a 2a20 and '--gnits'.* │ │ │ │ │ +00000ce0: 4379 676e 7573 3a3a 2020 2020 2020 2020 Cygnus:: │ │ │ │ │ +00000cf0: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ +00000d00: 6520 6566 6665 6374 206f 6620 272d 2d63 e effect of '--c │ │ │ │ │ +00000d10: 7967 6e75 7327 2028 6465 7072 6563 6174 ygnus' (deprecat │ │ │ │ │ +00000d20: 6564 2c20 736f 6f6e 2074 6f20 6265 2072 ed, soon to be r │ │ │ │ │ +00000d30: 656d 6f76 6564 290a 2a20 4e6f 7420 456e emoved).* Not En │ │ │ │ │ +00000d40: 6f75 6768 3a3a 2020 2020 2020 2020 2020 ough:: │ │ │ │ │ +00000d50: 2020 2020 2020 2020 5768 656e 2041 7574 When Aut │ │ │ │ │ +00000d60: 6f6d 616b 6520 6973 206e 6f74 2045 6e6f omake is not Eno │ │ │ │ │ +00000d70: 7567 680a 2a20 4469 7374 7269 6275 7469 ugh.* Distributi │ │ │ │ │ +00000d80: 6e67 3a3a 2020 2020 2020 2020 2020 2020 ng:: │ │ │ │ │ +00000d90: 2020 2020 4469 7374 7269 6275 7469 6e67 Distributing │ │ │ │ │ +00000da0: 2074 6865 204d 616b 6566 696c 652e 696e the Makefile.in │ │ │ │ │ +00000db0: 0a2a 2041 5049 2056 6572 7369 6f6e 696e .* API Versionin │ │ │ │ │ +00000dc0: 673a 3a20 2020 2020 2020 2020 2020 2020 g:: │ │ │ │ │ +00000dd0: 2041 626f 7574 2063 6f6d 7061 7469 6269 About compatibi │ │ │ │ │ +00000de0: 6c69 7479 2062 6574 7765 656e 2041 7574 lity between Aut │ │ │ │ │ +00000df0: 6f6d 616b 6520 7665 7273 696f 6e73 0a2a omake versions.* │ │ │ │ │ +00000e00: 2055 7067 7261 6469 6e67 3a3a 2020 2020 Upgrading:: │ │ │ │ │ +00000e10: 2020 2020 2020 2020 2020 2020 2020 2055 U │ │ │ │ │ +00000e20: 7067 7261 6469 6e67 2074 6f20 6120 4e65 pgrading to a Ne │ │ │ │ │ +00000e30: 7765 7220 4175 746f 6d61 6b65 2056 6572 wer Automake Ver │ │ │ │ │ +00000e40: 7369 6f6e 0a2a 2046 4151 3a3a 2020 2020 sion.* FAQ:: │ │ │ │ │ 00000e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000e60: 2020 2046 7265 7175 656e 746c 7920 4173 Frequently As │ │ │ │ │ -00000e70: 6b65 6420 5175 6573 7469 6f6e 730a 2a20 ked Questions.* │ │ │ │ │ -00000e80: 4869 7374 6f72 793a 3a20 2020 2020 2020 History:: │ │ │ │ │ -00000e90: 2020 2020 2020 2020 2020 2020 2020 4e6f No │ │ │ │ │ -00000ea0: 7465 7320 6162 6f75 7420 7468 6520 6869 tes about the hi │ │ │ │ │ -00000eb0: 7374 6f72 7920 6f66 2041 7574 6f6d 616b story of Automak │ │ │ │ │ -00000ec0: 650a 2a20 436f 7079 696e 6720 5468 6973 e.* Copying This │ │ │ │ │ -00000ed0: 204d 616e 7561 6c3a 3a20 2020 2020 2020 Manual:: │ │ │ │ │ -00000ee0: 2020 486f 7720 746f 206d 616b 6520 636f How to make co │ │ │ │ │ -00000ef0: 7069 6573 206f 6620 7468 6973 206d 616e pies of this man │ │ │ │ │ -00000f00: 7561 6c0a 2a20 496e 6469 6365 733a 3a20 ual.* Indices:: │ │ │ │ │ -00000f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000f20: 2020 2020 496e 6469 6365 7320 6f66 2076 Indices of v │ │ │ │ │ -00000f30: 6172 6961 626c 6573 2c20 6d61 6372 6f73 ariables, macros │ │ │ │ │ -00000f40: 2c20 616e 6420 636f 6e63 6570 7473 0a0a , and concepts.. │ │ │ │ │ -00000f50: 202d 2d20 5468 6520 4465 7461 696c 6564 -- The Detailed │ │ │ │ │ -00000f60: 204e 6f64 6520 4c69 7374 696e 6720 2d2d Node Listing -- │ │ │ │ │ -00000f70: 0a0a 416e 2049 6e74 726f 6475 6374 696f ..An Introductio │ │ │ │ │ -00000f80: 6e20 746f 2074 6865 2041 7574 6f74 6f6f n to the Autotoo │ │ │ │ │ -00000f90: 6c73 0a0a 2a20 474e 5520 4275 696c 6420 ls..* GNU Build │ │ │ │ │ -00000fa0: 5379 7374 656d 3a3a 2020 2020 2020 2020 System:: │ │ │ │ │ -00000fb0: 2020 2020 496e 7472 6f64 7563 696e 6720 Introducing │ │ │ │ │ -00000fc0: 7468 6520 474e 5520 4275 696c 6420 5379 the GNU Build Sy │ │ │ │ │ -00000fd0: 7374 656d 0a2a 2055 7365 2043 6173 6573 stem.* Use Cases │ │ │ │ │ -00000fe0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00000ff0: 2020 2020 2055 7365 2043 6173 6573 2066 Use Cases f │ │ │ │ │ -00001000: 6f72 2074 6865 2047 4e55 2042 7569 6c64 or the GNU Build │ │ │ │ │ -00001010: 2053 7973 7465 6d0a 2a20 5768 7920 4175 System.* Why Au │ │ │ │ │ -00001020: 746f 746f 6f6c 733a 3a20 2020 2020 2020 totools:: │ │ │ │ │ -00001030: 2020 2020 2020 2020 486f 7720 4175 746f How Auto │ │ │ │ │ -00001040: 746f 6f6c 7320 4865 6c70 0a2a 2048 656c tools Help.* Hel │ │ │ │ │ -00001050: 6c6f 2057 6f72 6c64 3a3a 2020 2020 2020 lo World:: │ │ │ │ │ -00001060: 2020 2020 2020 2020 2020 2041 2053 6d61 A Sma │ │ │ │ │ -00001070: 6c6c 2048 656c 6c6f 2057 6f72 6c64 2050 ll Hello World P │ │ │ │ │ -00001080: 6163 6b61 6765 0a0a 5573 6520 4361 7365 ackage..Use Case │ │ │ │ │ -00001090: 7320 666f 7220 7468 6520 474e 5520 4275 s for the GNU Bu │ │ │ │ │ -000010a0: 696c 6420 5379 7374 656d 0a0a 2a20 4261 ild System..* Ba │ │ │ │ │ -000010b0: 7369 6320 496e 7374 616c 6c61 7469 6f6e sic Installation │ │ │ │ │ -000010c0: 3a3a 2020 2020 2020 2020 2020 436f 6d6d :: Comm │ │ │ │ │ -000010d0: 6f6e 2069 6e73 7461 6c6c 6174 696f 6e20 on installation │ │ │ │ │ -000010e0: 7072 6f63 6564 7572 650a 2a20 5374 616e procedure.* Stan │ │ │ │ │ -000010f0: 6461 7264 2054 6172 6765 7473 3a3a 2020 dard Targets:: │ │ │ │ │ -00001100: 2020 2020 2020 2020 2020 4120 6c69 7374 A list │ │ │ │ │ -00001110: 206f 6620 7374 616e 6461 7264 204d 616b of standard Mak │ │ │ │ │ -00001120: 6566 696c 6520 7461 7267 6574 730a 2a20 efile targets.* │ │ │ │ │ -00001130: 5374 616e 6461 7264 2044 6972 6563 746f Standard Directo │ │ │ │ │ -00001140: 7279 2056 6172 6961 626c 6573 3a3a 2020 ry Variables:: │ │ │ │ │ -00001150: 4120 6c69 7374 206f 6620 7374 616e 6461 A list of standa │ │ │ │ │ -00001160: 7264 2064 6972 6563 746f 7279 2076 6172 rd directory var │ │ │ │ │ -00001170: 6961 626c 6573 0a2a 2053 7461 6e64 6172 iables.* Standar │ │ │ │ │ -00001180: 6420 436f 6e66 6967 7572 6174 696f 6e20 d Configuration │ │ │ │ │ -00001190: 5661 7269 6162 6c65 733a 3a20 2055 7369 Variables:: Usi │ │ │ │ │ -000011a0: 6e67 2063 6f6e 6669 6775 7261 7469 6f6e ng configuration │ │ │ │ │ -000011b0: 2076 6172 6961 626c 6573 0a2a 2063 6f6e variables.* con │ │ │ │ │ -000011c0: 6669 672e 7369 7465 3a3a 2020 2020 2020 fig.site:: │ │ │ │ │ -000011d0: 2020 2020 2020 2020 2020 2055 7369 6e67 Using │ │ │ │ │ -000011e0: 2061 2063 6f6e 6669 672e 7369 7465 2066 a config.site f │ │ │ │ │ -000011f0: 696c 650a 2a20 5650 4154 4820 4275 696c ile.* VPATH Buil │ │ │ │ │ -00001200: 6473 3a3a 2020 2020 2020 2020 2020 2020 ds:: │ │ │ │ │ -00001210: 2020 2020 5061 7261 6c6c 656c 2062 7569 Parallel bui │ │ │ │ │ -00001220: 6c64 2074 7265 6573 0a2a 2054 776f 2d50 ld trees.* Two-P │ │ │ │ │ -00001230: 6172 7420 496e 7374 616c 6c3a 3a20 2020 art Install:: │ │ │ │ │ -00001240: 2020 2020 2020 2020 2049 6e73 7461 6c6c Install │ │ │ │ │ -00001250: 696e 6720 6461 7461 2061 6e64 2070 726f ing data and pro │ │ │ │ │ -00001260: 6772 616d 7320 7365 7061 7261 7465 6c79 grams separately │ │ │ │ │ -00001270: 0a2a 2043 726f 7373 2d43 6f6d 7069 6c61 .* Cross-Compila │ │ │ │ │ -00001280: 7469 6f6e 3a3a 2020 2020 2020 2020 2020 tion:: │ │ │ │ │ -00001290: 2042 7569 6c64 696e 6720 666f 7220 6f74 Building for ot │ │ │ │ │ -000012a0: 6865 7220 6172 6368 6974 6563 7475 7265 her architecture │ │ │ │ │ -000012b0: 730a 2a20 5265 6e61 6d69 6e67 3a3a 2020 s.* Renaming:: │ │ │ │ │ +00000e60: 2020 2020 2046 7265 7175 656e 746c 7920 Frequently │ │ │ │ │ +00000e70: 4173 6b65 6420 5175 6573 7469 6f6e 730a Asked Questions. │ │ │ │ │ +00000e80: 2a20 4869 7374 6f72 793a 3a20 2020 2020 * History:: │ │ │ │ │ +00000e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000ea0: 4e6f 7465 7320 6162 6f75 7420 7468 6520 Notes about the │ │ │ │ │ +00000eb0: 6869 7374 6f72 7920 6f66 2041 7574 6f6d history of Autom │ │ │ │ │ +00000ec0: 616b 650a 2a20 436f 7079 696e 6720 5468 ake.* Copying Th │ │ │ │ │ +00000ed0: 6973 204d 616e 7561 6c3a 3a20 2020 2020 is Manual:: │ │ │ │ │ +00000ee0: 2020 2020 486f 7720 746f 206d 616b 6520 How to make │ │ │ │ │ +00000ef0: 636f 7069 6573 206f 6620 7468 6973 206d copies of this m │ │ │ │ │ +00000f00: 616e 7561 6c0a 2a20 496e 6469 6365 733a anual.* Indices: │ │ │ │ │ +00000f10: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000f20: 2020 2020 2020 496e 6469 6365 7320 6f66 Indices of │ │ │ │ │ +00000f30: 2076 6172 6961 626c 6573 2c20 6d61 6372 variables, macr │ │ │ │ │ +00000f40: 6f73 2c20 616e 6420 636f 6e63 6570 7473 os, and concepts │ │ │ │ │ +00000f50: 0a0a 202d 2d20 5468 6520 4465 7461 696c .. -- The Detail │ │ │ │ │ +00000f60: 6564 204e 6f64 6520 4c69 7374 696e 6720 ed Node Listing │ │ │ │ │ +00000f70: 2d2d 0a0a 416e 2049 6e74 726f 6475 6374 --..An Introduct │ │ │ │ │ +00000f80: 696f 6e20 746f 2074 6865 2041 7574 6f74 ion to the Autot │ │ │ │ │ +00000f90: 6f6f 6c73 0a0a 2a20 474e 5520 4275 696c ools..* GNU Buil │ │ │ │ │ +00000fa0: 6420 5379 7374 656d 3a3a 2020 2020 2020 d System:: │ │ │ │ │ +00000fb0: 2020 2020 2020 496e 7472 6f64 7563 696e Introducin │ │ │ │ │ +00000fc0: 6720 7468 6520 474e 5520 4275 696c 6420 g the GNU Build │ │ │ │ │ +00000fd0: 5379 7374 656d 0a2a 2055 7365 2043 6173 System.* Use Cas │ │ │ │ │ +00000fe0: 6573 3a3a 2020 2020 2020 2020 2020 2020 es:: │ │ │ │ │ +00000ff0: 2020 2020 2020 2055 7365 2043 6173 6573 Use Cases │ │ │ │ │ +00001000: 2066 6f72 2074 6865 2047 4e55 2042 7569 for the GNU Bui │ │ │ │ │ +00001010: 6c64 2053 7973 7465 6d0a 2a20 5768 7920 ld System.* Why │ │ │ │ │ +00001020: 4175 746f 746f 6f6c 733a 3a20 2020 2020 Autotools:: │ │ │ │ │ +00001030: 2020 2020 2020 2020 2020 486f 7720 4175 How Au │ │ │ │ │ +00001040: 746f 746f 6f6c 7320 4865 6c70 0a2a 2048 totools Help.* H │ │ │ │ │ +00001050: 656c 6c6f 2057 6f72 6c64 3a3a 2020 2020 ello World:: │ │ │ │ │ +00001060: 2020 2020 2020 2020 2020 2020 2041 2053 A S │ │ │ │ │ +00001070: 6d61 6c6c 2048 656c 6c6f 2057 6f72 6c64 mall Hello World │ │ │ │ │ +00001080: 2050 6163 6b61 6765 0a0a 5573 6520 4361 Package..Use Ca │ │ │ │ │ +00001090: 7365 7320 666f 7220 7468 6520 474e 5520 ses for the GNU │ │ │ │ │ +000010a0: 4275 696c 6420 5379 7374 656d 0a0a 2a20 Build System..* │ │ │ │ │ +000010b0: 4261 7369 6320 496e 7374 616c 6c61 7469 Basic Installati │ │ │ │ │ +000010c0: 6f6e 3a3a 2020 2020 2020 2020 2020 436f on:: Co │ │ │ │ │ +000010d0: 6d6d 6f6e 2069 6e73 7461 6c6c 6174 696f mmon installatio │ │ │ │ │ +000010e0: 6e20 7072 6f63 6564 7572 650a 2a20 5374 n procedure.* St │ │ │ │ │ +000010f0: 616e 6461 7264 2054 6172 6765 7473 3a3a andard Targets:: │ │ │ │ │ +00001100: 2020 2020 2020 2020 2020 2020 4120 6c69 A li │ │ │ │ │ +00001110: 7374 206f 6620 7374 616e 6461 7264 204d st of standard M │ │ │ │ │ +00001120: 616b 6566 696c 6520 7461 7267 6574 730a akefile targets. │ │ │ │ │ +00001130: 2a20 5374 616e 6461 7264 2044 6972 6563 * Standard Direc │ │ │ │ │ +00001140: 746f 7279 2056 6172 6961 626c 6573 3a3a tory Variables:: │ │ │ │ │ +00001150: 2020 4120 6c69 7374 206f 6620 7374 616e A list of stan │ │ │ │ │ +00001160: 6461 7264 2064 6972 6563 746f 7279 2076 dard directory v │ │ │ │ │ +00001170: 6172 6961 626c 6573 0a2a 2053 7461 6e64 ariables.* Stand │ │ │ │ │ +00001180: 6172 6420 436f 6e66 6967 7572 6174 696f ard Configuratio │ │ │ │ │ +00001190: 6e20 5661 7269 6162 6c65 733a 3a20 2055 n Variables:: U │ │ │ │ │ +000011a0: 7369 6e67 2063 6f6e 6669 6775 7261 7469 sing configurati │ │ │ │ │ +000011b0: 6f6e 2076 6172 6961 626c 6573 0a2a 2063 on variables.* c │ │ │ │ │ +000011c0: 6f6e 6669 672e 7369 7465 3a3a 2020 2020 onfig.site:: │ │ │ │ │ +000011d0: 2020 2020 2020 2020 2020 2020 2055 7369 Usi │ │ │ │ │ +000011e0: 6e67 2061 2063 6f6e 6669 672e 7369 7465 ng a config.site │ │ │ │ │ +000011f0: 2066 696c 650a 2a20 5650 4154 4820 4275 file.* VPATH Bu │ │ │ │ │ +00001200: 696c 6473 3a3a 2020 2020 2020 2020 2020 ilds:: │ │ │ │ │ +00001210: 2020 2020 2020 5061 7261 6c6c 656c 2062 Parallel b │ │ │ │ │ +00001220: 7569 6c64 2074 7265 6573 0a2a 2054 776f uild trees.* Two │ │ │ │ │ +00001230: 2d50 6172 7420 496e 7374 616c 6c3a 3a20 -Part Install:: │ │ │ │ │ +00001240: 2020 2020 2020 2020 2020 2049 6e73 7461 Insta │ │ │ │ │ +00001250: 6c6c 696e 6720 6461 7461 2061 6e64 2070 lling data and p │ │ │ │ │ +00001260: 726f 6772 616d 7320 7365 7061 7261 7465 rograms separate │ │ │ │ │ +00001270: 6c79 0a2a 2043 726f 7373 2d43 6f6d 7069 ly.* Cross-Compi │ │ │ │ │ +00001280: 6c61 7469 6f6e 3a3a 2020 2020 2020 2020 lation:: │ │ │ │ │ +00001290: 2020 2042 7569 6c64 696e 6720 666f 7220 Building for │ │ │ │ │ +000012a0: 6f74 6865 7220 6172 6368 6974 6563 7475 other architectu │ │ │ │ │ +000012b0: 7265 730a 2a20 5265 6e61 6d69 6e67 3a3a res.* Renaming:: │ │ │ │ │ 000012c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000012d0: 2020 5265 6e61 6d69 6e67 2070 726f 6772 Renaming progr │ │ │ │ │ -000012e0: 616d 7320 6174 2069 6e73 7461 6c6c 2074 ams at install t │ │ │ │ │ -000012f0: 696d 650a 2a20 4445 5354 4449 523a 3a20 ime.* DESTDIR:: │ │ │ │ │ -00001300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001310: 2020 2020 4275 696c 6469 6e67 2062 696e Building bin │ │ │ │ │ -00001320: 6172 7920 7061 636b 6167 6573 2077 6974 ary packages wit │ │ │ │ │ -00001330: 6820 4445 5354 4449 520a 2a20 5072 6570 h DESTDIR.* Prep │ │ │ │ │ -00001340: 6172 696e 6720 4469 7374 7269 6275 7469 aring Distributi │ │ │ │ │ -00001350: 6f6e 733a 3a20 2020 2020 526f 6c6c 696e ons:: Rollin │ │ │ │ │ -00001360: 6720 6f75 7420 7461 7262 616c 6c73 0a2a g out tarballs.* │ │ │ │ │ -00001370: 2044 6570 656e 6465 6e63 7920 5472 6163 Dependency Trac │ │ │ │ │ -00001380: 6b69 6e67 3a3a 2020 2020 2020 2020 2041 king:: A │ │ │ │ │ -00001390: 7574 6f6d 6174 6963 2064 6570 656e 6465 utomatic depende │ │ │ │ │ -000013a0: 6e63 7920 7472 6163 6b69 6e67 0a2a 204e ncy tracking.* N │ │ │ │ │ -000013b0: 6573 7465 6420 5061 636b 6167 6573 3a3a ested Packages:: │ │ │ │ │ -000013c0: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -000013d0: 2047 4e55 2042 7569 6c64 2053 7973 7465 GNU Build Syste │ │ │ │ │ -000013e0: 6d73 2063 616e 2062 6520 6e65 7374 6564 ms can be nested │ │ │ │ │ -000013f0: 0a0a 4120 536d 616c 6c20 4865 6c6c 6f20 ..A Small Hello │ │ │ │ │ -00001400: 576f 726c 640a 0a2a 2043 7265 6174 696e World..* Creatin │ │ │ │ │ -00001410: 6720 616d 6865 6c6c 6f3a 3a20 2020 2020 g amhello:: │ │ │ │ │ -00001420: 2020 2020 2020 2043 7265 6174 6520 2761 Create 'a │ │ │ │ │ -00001430: 6d68 656c 6c6f 2d31 2e30 2e74 6172 2e67 mhello-1.0.tar.g │ │ │ │ │ -00001440: 7a27 2066 726f 6d20 7363 7261 7463 680a z' from scratch. │ │ │ │ │ -00001450: 2a20 616d 6865 6c6c 6f27 7320 636f 6e66 * amhello's conf │ │ │ │ │ -00001460: 6967 7572 652e 6163 2053 6574 7570 2045 igure.ac Setup E │ │ │ │ │ -00001470: 7870 6c61 696e 6564 3a3a 0a2a 2061 6d68 xplained::.* amh │ │ │ │ │ -00001480: 656c 6c6f 2773 204d 616b 6566 696c 652e ello's Makefile. │ │ │ │ │ -00001490: 616d 2053 6574 7570 2045 7870 6c61 696e am Setup Explain │ │ │ │ │ -000014a0: 6564 3a3a 0a0a 4765 6e65 7261 6c20 6964 ed::..General id │ │ │ │ │ -000014b0: 6561 730a 0a2a 2047 656e 6572 616c 204f eas..* General O │ │ │ │ │ -000014c0: 7065 7261 7469 6f6e 3a3a 2020 2020 2020 peration:: │ │ │ │ │ -000014d0: 2020 2020 2047 656e 6572 616c 206f 7065 General ope │ │ │ │ │ -000014e0: 7261 7469 6f6e 206f 6620 4175 746f 6d61 ration of Automa │ │ │ │ │ -000014f0: 6b65 0a2a 2053 7472 6963 746e 6573 733a ke.* Strictness: │ │ │ │ │ -00001500: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00001510: 2020 2053 7461 6e64 6172 6473 2063 6f6e Standards con │ │ │ │ │ -00001520: 666f 726d 616e 6365 2063 6865 636b 696e formance checkin │ │ │ │ │ -00001530: 670a 2a20 556e 6966 6f72 6d3a 3a20 2020 g.* Uniform:: │ │ │ │ │ +000012d0: 2020 2020 5265 6e61 6d69 6e67 2070 726f Renaming pro │ │ │ │ │ +000012e0: 6772 616d 7320 6174 2069 6e73 7461 6c6c grams at install │ │ │ │ │ +000012f0: 2074 696d 650a 2a20 4445 5354 4449 523a time.* DESTDIR: │ │ │ │ │ +00001300: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001310: 2020 2020 2020 4275 696c 6469 6e67 2062 Building b │ │ │ │ │ +00001320: 696e 6172 7920 7061 636b 6167 6573 2077 inary packages w │ │ │ │ │ +00001330: 6974 6820 4445 5354 4449 520a 2a20 5072 ith DESTDIR.* Pr │ │ │ │ │ +00001340: 6570 6172 696e 6720 4469 7374 7269 6275 eparing Distribu │ │ │ │ │ +00001350: 7469 6f6e 733a 3a20 2020 2020 526f 6c6c tions:: Roll │ │ │ │ │ +00001360: 696e 6720 6f75 7420 7461 7262 616c 6c73 ing out tarballs │ │ │ │ │ +00001370: 0a2a 2044 6570 656e 6465 6e63 7920 5472 .* Dependency Tr │ │ │ │ │ +00001380: 6163 6b69 6e67 3a3a 2020 2020 2020 2020 acking:: │ │ │ │ │ +00001390: 2041 7574 6f6d 6174 6963 2064 6570 656e Automatic depen │ │ │ │ │ +000013a0: 6465 6e63 7920 7472 6163 6b69 6e67 0a2a dency tracking.* │ │ │ │ │ +000013b0: 204e 6573 7465 6420 5061 636b 6167 6573 Nested Packages │ │ │ │ │ +000013c0: 3a3a 2020 2020 2020 2020 2020 2020 2054 :: T │ │ │ │ │ +000013d0: 6865 2047 4e55 2042 7569 6c64 2053 7973 he GNU Build Sys │ │ │ │ │ +000013e0: 7465 6d73 2063 616e 2062 6520 6e65 7374 tems can be nest │ │ │ │ │ +000013f0: 6564 0a0a 4120 536d 616c 6c20 4865 6c6c ed..A Small Hell │ │ │ │ │ +00001400: 6f20 576f 726c 640a 0a2a 2043 7265 6174 o World..* Creat │ │ │ │ │ +00001410: 696e 6720 616d 6865 6c6c 6f3a 3a20 2020 ing amhello:: │ │ │ │ │ +00001420: 2020 2020 2020 2020 2043 7265 6174 6520 Create │ │ │ │ │ +00001430: 2761 6d68 656c 6c6f 2d31 2e30 2e74 6172 'amhello-1.0.tar │ │ │ │ │ +00001440: 2e67 7a27 2066 726f 6d20 7363 7261 7463 .gz' from scratc │ │ │ │ │ +00001450: 680a 2a20 616d 6865 6c6c 6f27 7320 636f h.* amhello's co │ │ │ │ │ +00001460: 6e66 6967 7572 652e 6163 2053 6574 7570 nfigure.ac Setup │ │ │ │ │ +00001470: 2045 7870 6c61 696e 6564 3a3a 0a2a 2061 Explained::.* a │ │ │ │ │ +00001480: 6d68 656c 6c6f 2773 204d 616b 6566 696c mhello's Makefil │ │ │ │ │ +00001490: 652e 616d 2053 6574 7570 2045 7870 6c61 e.am Setup Expla │ │ │ │ │ +000014a0: 696e 6564 3a3a 0a0a 4765 6e65 7261 6c20 ined::..General │ │ │ │ │ +000014b0: 6964 6561 730a 0a2a 2047 656e 6572 616c ideas..* General │ │ │ │ │ +000014c0: 204f 7065 7261 7469 6f6e 3a3a 2020 2020 Operation:: │ │ │ │ │ +000014d0: 2020 2020 2020 2047 656e 6572 616c 206f General o │ │ │ │ │ +000014e0: 7065 7261 7469 6f6e 206f 6620 4175 746f peration of Auto │ │ │ │ │ +000014f0: 6d61 6b65 0a2a 2053 7472 6963 746e 6573 make.* Strictnes │ │ │ │ │ +00001500: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ +00001510: 2020 2020 2053 7461 6e64 6172 6473 2063 Standards c │ │ │ │ │ +00001520: 6f6e 666f 726d 616e 6365 2063 6865 636b onformance check │ │ │ │ │ +00001530: 696e 670a 2a20 556e 6966 6f72 6d3a 3a20 ing.* Uniform:: │ │ │ │ │ 00001540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001550: 2020 5468 6520 556e 6966 6f72 6d20 4e61 The Uniform Na │ │ │ │ │ -00001560: 6d69 6e67 2053 6368 656d 650a 2a20 4c65 ming Scheme.* Le │ │ │ │ │ -00001570: 6e67 7468 204c 696d 6974 6174 696f 6e73 ngth Limitations │ │ │ │ │ -00001580: 3a3a 2020 2020 2020 2020 2020 5374 6179 :: Stay │ │ │ │ │ -00001590: 696e 6720 6265 6c6f 7720 7468 6520 636f ing below the co │ │ │ │ │ -000015a0: 6d6d 616e 6420 6c69 6e65 206c 656e 6774 mmand line lengt │ │ │ │ │ -000015b0: 6820 6c69 6d69 740a 2a20 4361 6e6f 6e69 h limit.* Canoni │ │ │ │ │ -000015c0: 6361 6c69 7a61 7469 6f6e 3a3a 2020 2020 calization:: │ │ │ │ │ -000015d0: 2020 2020 2020 2020 486f 7720 6465 7269 How deri │ │ │ │ │ -000015e0: 7665 6420 7661 7269 6162 6c65 7320 6172 ved variables ar │ │ │ │ │ -000015f0: 6520 6e61 6d65 640a 2a20 5573 6572 2056 e named.* User V │ │ │ │ │ -00001600: 6172 6961 626c 6573 3a3a 2020 2020 2020 ariables:: │ │ │ │ │ -00001610: 2020 2020 2020 2020 5661 7269 6162 6c65 Variable │ │ │ │ │ -00001620: 7320 7265 7365 7276 6564 2066 6f72 2074 s reserved for t │ │ │ │ │ -00001630: 6865 2075 7365 720a 2a20 4175 7869 6c69 he user.* Auxili │ │ │ │ │ -00001640: 6172 7920 5072 6f67 7261 6d73 3a3a 2020 ary Programs:: │ │ │ │ │ -00001650: 2020 2020 2020 2020 5072 6f67 7261 6d73 Programs │ │ │ │ │ -00001660: 2061 7574 6f6d 616b 6520 6d69 6768 7420 automake might │ │ │ │ │ -00001670: 7265 7175 6972 650a 0a53 6f6d 6520 6578 require..Some ex │ │ │ │ │ -00001680: 616d 706c 6520 7061 636b 6167 6573 0a0a ample packages.. │ │ │ │ │ -00001690: 2a20 436f 6d70 6c65 7465 3a3a 2020 2020 * Complete:: │ │ │ │ │ +00001550: 2020 2020 5468 6520 556e 6966 6f72 6d20 The Uniform │ │ │ │ │ +00001560: 4e61 6d69 6e67 2053 6368 656d 650a 2a20 Naming Scheme.* │ │ │ │ │ +00001570: 4c65 6e67 7468 204c 696d 6974 6174 696f Length Limitatio │ │ │ │ │ +00001580: 6e73 3a3a 2020 2020 2020 2020 2020 5374 ns:: St │ │ │ │ │ +00001590: 6179 696e 6720 6265 6c6f 7720 7468 6520 aying below the │ │ │ │ │ +000015a0: 636f 6d6d 616e 6420 6c69 6e65 206c 656e command line len │ │ │ │ │ +000015b0: 6774 6820 6c69 6d69 740a 2a20 4361 6e6f gth limit.* Cano │ │ │ │ │ +000015c0: 6e69 6361 6c69 7a61 7469 6f6e 3a3a 2020 nicalization:: │ │ │ │ │ +000015d0: 2020 2020 2020 2020 2020 486f 7720 6465 How de │ │ │ │ │ +000015e0: 7269 7665 6420 7661 7269 6162 6c65 7320 rived variables │ │ │ │ │ +000015f0: 6172 6520 6e61 6d65 640a 2a20 5573 6572 are named.* User │ │ │ │ │ +00001600: 2056 6172 6961 626c 6573 3a3a 2020 2020 Variables:: │ │ │ │ │ +00001610: 2020 2020 2020 2020 2020 5661 7269 6162 Variab │ │ │ │ │ +00001620: 6c65 7320 7265 7365 7276 6564 2066 6f72 les reserved for │ │ │ │ │ +00001630: 2074 6865 2075 7365 720a 2a20 4175 7869 the user.* Auxi │ │ │ │ │ +00001640: 6c69 6172 7920 5072 6f67 7261 6d73 3a3a liary Programs:: │ │ │ │ │ +00001650: 2020 2020 2020 2020 2020 5072 6f67 7261 Progra │ │ │ │ │ +00001660: 6d73 2061 7574 6f6d 616b 6520 6d69 6768 ms automake migh │ │ │ │ │ +00001670: 7420 7265 7175 6972 650a 0a53 6f6d 6520 t require..Some │ │ │ │ │ +00001680: 6578 616d 706c 6520 7061 636b 6167 6573 example packages │ │ │ │ │ +00001690: 0a0a 2a20 436f 6d70 6c65 7465 3a3a 2020 ..* Complete:: │ │ │ │ │ 000016a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000016b0: 4120 7369 6d70 6c65 2065 7861 6d70 6c65 A simple example │ │ │ │ │ -000016c0: 2c20 7374 6172 7420 746f 2066 696e 6973 , start to finis │ │ │ │ │ -000016d0: 680a 2a20 7472 7565 3a3a 2020 2020 2020 h.* true:: │ │ │ │ │ +000016b0: 2020 4120 7369 6d70 6c65 2065 7861 6d70 A simple examp │ │ │ │ │ +000016c0: 6c65 2c20 7374 6172 7420 746f 2066 696e le, start to fin │ │ │ │ │ +000016d0: 6973 680a 2a20 7472 7565 3a3a 2020 2020 ish.* true:: │ │ │ │ │ 000016e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000016f0: 2020 4275 696c 6469 6e67 2074 7275 6520 Building true │ │ │ │ │ -00001700: 616e 6420 6661 6c73 650a 0a53 6361 6e6e and false..Scann │ │ │ │ │ -00001710: 696e 6720 2763 6f6e 6669 6775 7265 2e61 ing 'configure.a │ │ │ │ │ -00001720: 6327 2c20 7573 696e 6720 2761 636c 6f63 c', using 'acloc │ │ │ │ │ -00001730: 616c 270a 0a2a 2052 6571 7569 7265 6d65 al'..* Requireme │ │ │ │ │ -00001740: 6e74 733a 3a20 2020 2020 2020 2020 2020 nts:: │ │ │ │ │ -00001750: 2020 2020 2043 6f6e 6669 6775 7261 7469 Configurati │ │ │ │ │ -00001760: 6f6e 2072 6571 7569 7265 6d65 6e74 730a on requirements. │ │ │ │ │ -00001770: 2a20 4f70 7469 6f6e 616c 3a3a 2020 2020 * Optional:: │ │ │ │ │ +000016f0: 2020 2020 4275 696c 6469 6e67 2074 7275 Building tru │ │ │ │ │ +00001700: 6520 616e 6420 6661 6c73 650a 0a53 6361 e and false..Sca │ │ │ │ │ +00001710: 6e6e 696e 6720 2763 6f6e 6669 6775 7265 nning 'configure │ │ │ │ │ +00001720: 2e61 6327 2c20 7573 696e 6720 2761 636c .ac', using 'acl │ │ │ │ │ +00001730: 6f63 616c 270a 0a2a 2052 6571 7569 7265 ocal'..* Require │ │ │ │ │ +00001740: 6d65 6e74 733a 3a20 2020 2020 2020 2020 ments:: │ │ │ │ │ +00001750: 2020 2020 2020 2043 6f6e 6669 6775 7261 Configura │ │ │ │ │ +00001760: 7469 6f6e 2072 6571 7569 7265 6d65 6e74 tion requirement │ │ │ │ │ +00001770: 730a 2a20 4f70 7469 6f6e 616c 3a3a 2020 s.* Optional:: │ │ │ │ │ 00001780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001790: 4f74 6865 7220 7468 696e 6773 2041 7574 Other things Aut │ │ │ │ │ -000017a0: 6f6d 616b 6520 7265 636f 676e 697a 6573 omake recognizes │ │ │ │ │ -000017b0: 0a2a 2061 636c 6f63 616c 2049 6e76 6f63 .* aclocal Invoc │ │ │ │ │ -000017c0: 6174 696f 6e3a 3a20 2020 2020 2020 2020 ation:: │ │ │ │ │ -000017d0: 2041 7574 6f2d 6765 6e65 7261 7469 6e67 Auto-generating │ │ │ │ │ -000017e0: 2061 636c 6f63 616c 2e6d 340a 2a20 4d61 aclocal.m4.* Ma │ │ │ │ │ -000017f0: 6372 6f73 3a3a 2020 2020 2020 2020 2020 cros:: │ │ │ │ │ -00001800: 2020 2020 2020 2020 2020 2020 4175 746f Auto │ │ │ │ │ -00001810: 636f 6e66 206d 6163 726f 7320 7375 7070 conf macros supp │ │ │ │ │ -00001820: 6c69 6564 2077 6974 6820 4175 746f 6d61 lied with Automa │ │ │ │ │ -00001830: 6b65 0a0a 4175 746f 2d67 656e 6572 6174 ke..Auto-generat │ │ │ │ │ -00001840: 696e 6720 6163 6c6f 6361 6c2e 6d34 0a0a ing aclocal.m4.. │ │ │ │ │ -00001850: 2a20 6163 6c6f 6361 6c20 4f70 7469 6f6e * aclocal Option │ │ │ │ │ -00001860: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ -00001870: 4f70 7469 6f6e 7320 7375 7070 6f72 7465 Options supporte │ │ │ │ │ -00001880: 6420 6279 2061 636c 6f63 616c 0a2a 204d d by aclocal.* M │ │ │ │ │ -00001890: 6163 726f 2053 6561 7263 6820 5061 7468 acro Search Path │ │ │ │ │ -000018a0: 3a3a 2020 2020 2020 2020 2020 2048 6f77 :: How │ │ │ │ │ -000018b0: 2061 636c 6f63 616c 2066 696e 6473 202e aclocal finds . │ │ │ │ │ -000018c0: 6d34 2066 696c 6573 0a2a 2045 7874 656e m4 files.* Exten │ │ │ │ │ -000018d0: 6469 6e67 2061 636c 6f63 616c 3a3a 2020 ding aclocal:: │ │ │ │ │ -000018e0: 2020 2020 2020 2020 2057 7269 7469 6e67 Writing │ │ │ │ │ -000018f0: 2079 6f75 7220 6f77 6e20 6163 6c6f 6361 your own acloca │ │ │ │ │ -00001900: 6c20 6d61 6372 6f73 0a2a 204c 6f63 616c l macros.* Local │ │ │ │ │ -00001910: 204d 6163 726f 733a 3a20 2020 2020 2020 Macros:: │ │ │ │ │ -00001920: 2020 2020 2020 2020 204f 7267 616e 697a Organiz │ │ │ │ │ -00001930: 696e 6720 6c6f 6361 6c20 6d61 6372 6f73 ing local macros │ │ │ │ │ -00001940: 0a2a 2053 6572 6961 6c73 3a3a 2020 2020 .* Serials:: │ │ │ │ │ +00001790: 2020 4f74 6865 7220 7468 696e 6773 2041 Other things A │ │ │ │ │ +000017a0: 7574 6f6d 616b 6520 7265 636f 676e 697a utomake recogniz │ │ │ │ │ +000017b0: 6573 0a2a 2061 636c 6f63 616c 2049 6e76 es.* aclocal Inv │ │ │ │ │ +000017c0: 6f63 6174 696f 6e3a 3a20 2020 2020 2020 ocation:: │ │ │ │ │ +000017d0: 2020 2041 7574 6f2d 6765 6e65 7261 7469 Auto-generati │ │ │ │ │ +000017e0: 6e67 2061 636c 6f63 616c 2e6d 340a 2a20 ng aclocal.m4.* │ │ │ │ │ +000017f0: 4d61 6372 6f73 3a3a 2020 2020 2020 2020 Macros:: │ │ │ │ │ +00001800: 2020 2020 2020 2020 2020 2020 2020 4175 Au │ │ │ │ │ +00001810: 746f 636f 6e66 206d 6163 726f 7320 7375 toconf macros su │ │ │ │ │ +00001820: 7070 6c69 6564 2077 6974 6820 4175 746f pplied with Auto │ │ │ │ │ +00001830: 6d61 6b65 0a0a 4175 746f 2d67 656e 6572 make..Auto-gener │ │ │ │ │ +00001840: 6174 696e 6720 6163 6c6f 6361 6c2e 6d34 ating aclocal.m4 │ │ │ │ │ +00001850: 0a0a 2a20 6163 6c6f 6361 6c20 4f70 7469 ..* aclocal Opti │ │ │ │ │ +00001860: 6f6e 733a 3a20 2020 2020 2020 2020 2020 ons:: │ │ │ │ │ +00001870: 2020 4f70 7469 6f6e 7320 7375 7070 6f72 Options suppor │ │ │ │ │ +00001880: 7465 6420 6279 2061 636c 6f63 616c 0a2a ted by aclocal.* │ │ │ │ │ +00001890: 204d 6163 726f 2053 6561 7263 6820 5061 Macro Search Pa │ │ │ │ │ +000018a0: 7468 3a3a 2020 2020 2020 2020 2020 2048 th:: H │ │ │ │ │ +000018b0: 6f77 2061 636c 6f63 616c 2066 696e 6473 ow aclocal finds │ │ │ │ │ +000018c0: 202e 6d34 2066 696c 6573 0a2a 2045 7874 .m4 files.* Ext │ │ │ │ │ +000018d0: 656e 6469 6e67 2061 636c 6f63 616c 3a3a ending aclocal:: │ │ │ │ │ +000018e0: 2020 2020 2020 2020 2020 2057 7269 7469 Writi │ │ │ │ │ +000018f0: 6e67 2079 6f75 7220 6f77 6e20 6163 6c6f ng your own aclo │ │ │ │ │ +00001900: 6361 6c20 6d61 6372 6f73 0a2a 204c 6f63 cal macros.* Loc │ │ │ │ │ +00001910: 616c 204d 6163 726f 733a 3a20 2020 2020 al Macros:: │ │ │ │ │ +00001920: 2020 2020 2020 2020 2020 204f 7267 616e Organ │ │ │ │ │ +00001930: 697a 696e 6720 6c6f 6361 6c20 6d61 6372 izing local macr │ │ │ │ │ +00001940: 6f73 0a2a 2053 6572 6961 6c73 3a3a 2020 os.* Serials:: │ │ │ │ │ 00001950: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001960: 2053 6572 6961 6c20 6c69 6e65 7320 696e Serial lines in │ │ │ │ │ -00001970: 2041 7574 6f63 6f6e 6620 6d61 6372 6f73 Autoconf macros │ │ │ │ │ -00001980: 0a2a 2046 7574 7572 6520 6f66 2061 636c .* Future of acl │ │ │ │ │ -00001990: 6f63 616c 3a3a 2020 2020 2020 2020 2020 ocal:: │ │ │ │ │ -000019a0: 2061 636c 6f63 616c 2773 2073 6368 6564 aclocal's sched │ │ │ │ │ -000019b0: 756c 6564 2064 6561 7468 0a0a 4175 746f uled death..Auto │ │ │ │ │ -000019c0: 636f 6e66 206d 6163 726f 7320 7375 7070 conf macros supp │ │ │ │ │ -000019d0: 6c69 6564 2077 6974 6820 4175 746f 6d61 lied with Automa │ │ │ │ │ -000019e0: 6b65 0a0a 2a20 5075 626c 6963 204d 6163 ke..* Public Mac │ │ │ │ │ -000019f0: 726f 733a 3a20 2020 2020 2020 2020 2020 ros:: │ │ │ │ │ -00001a00: 2020 2020 4d61 6372 6f73 2074 6861 7420 Macros that │ │ │ │ │ -00001a10: 796f 7520 6361 6e20 7573 652e 0a2a 204f you can use..* O │ │ │ │ │ -00001a20: 6273 6f6c 6574 6520 4d61 6372 6f73 3a3a bsolete Macros:: │ │ │ │ │ -00001a30: 2020 2020 2020 2020 2020 2020 204d 6163 Mac │ │ │ │ │ -00001a40: 726f 7320 7468 6174 2079 6f75 2073 686f ros that you sho │ │ │ │ │ -00001a50: 756c 6420 7374 6f70 2075 7369 6e67 2e0a uld stop using.. │ │ │ │ │ -00001a60: 2a20 5072 6976 6174 6520 4d61 6372 6f73 * Private Macros │ │ │ │ │ -00001a70: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00001a80: 4d61 6372 6f73 2074 6861 7420 796f 7520 Macros that you │ │ │ │ │ -00001a90: 7368 6f75 6c64 206e 6f74 2075 7365 2e0a should not use.. │ │ │ │ │ -00001aa0: 0a44 6972 6563 746f 7269 6573 0a0a 2a20 .Directories..* │ │ │ │ │ -00001ab0: 5375 6264 6972 6563 746f 7269 6573 3a3a Subdirectories:: │ │ │ │ │ -00001ac0: 2020 2020 2020 2020 2020 2020 2020 4275 Bu │ │ │ │ │ -00001ad0: 696c 6469 6e67 2073 7562 6469 7265 6374 ilding subdirect │ │ │ │ │ -00001ae0: 6f72 6965 7320 7265 6375 7273 6976 656c ories recursivel │ │ │ │ │ -00001af0: 790a 2a20 436f 6e64 6974 696f 6e61 6c20 y.* Conditional │ │ │ │ │ -00001b00: 5375 6264 6972 6563 746f 7269 6573 3a3a Subdirectories:: │ │ │ │ │ -00001b10: 2020 436f 6e64 6974 696f 6e61 6c6c 7920 Conditionally │ │ │ │ │ -00001b20: 6e6f 7420 6275 696c 6469 6e67 2064 6972 not building dir │ │ │ │ │ -00001b30: 6563 746f 7269 6573 0a2a 2041 6c74 6572 ectories.* Alter │ │ │ │ │ -00001b40: 6e61 7469 7665 3a3a 2020 2020 2020 2020 native:: │ │ │ │ │ -00001b50: 2020 2020 2020 2020 2053 7562 6469 7265 Subdire │ │ │ │ │ -00001b60: 6374 6f72 6965 7320 7769 7468 6f75 7420 ctories without │ │ │ │ │ -00001b70: 7265 6375 7273 696f 6e0a 2a20 5375 6270 recursion.* Subp │ │ │ │ │ -00001b80: 6163 6b61 6765 733a 3a20 2020 2020 2020 ackages:: │ │ │ │ │ -00001b90: 2020 2020 2020 2020 2020 4e65 7374 696e Nestin │ │ │ │ │ -00001ba0: 6720 7061 636b 6167 6573 0a0a 436f 6e64 g packages..Cond │ │ │ │ │ -00001bb0: 6974 696f 6e61 6c20 5375 6264 6972 6563 itional Subdirec │ │ │ │ │ -00001bc0: 746f 7269 6573 0a0a 2a20 5355 4244 4952 tories..* SUBDIR │ │ │ │ │ -00001bd0: 5320 7673 2044 4953 545f 5355 4244 4952 S vs DIST_SUBDIR │ │ │ │ │ -00001be0: 533a 3a20 2020 2020 5477 6f20 7365 7473 S:: Two sets │ │ │ │ │ -00001bf0: 206f 6620 6469 7265 6374 6f72 6965 730a of directories. │ │ │ │ │ -00001c00: 2a20 5375 6264 6972 6563 746f 7269 6573 * Subdirectories │ │ │ │ │ -00001c10: 2077 6974 6820 414d 5f43 4f4e 4449 5449 with AM_CONDITI │ │ │ │ │ -00001c20: 4f4e 414c 3a3a 2020 5370 6563 6966 7969 ONAL:: Specifyi │ │ │ │ │ -00001c30: 6e67 2063 6f6e 6469 7469 6f6e 616c 2073 ng conditional s │ │ │ │ │ -00001c40: 7562 6469 7265 6374 6f72 6965 730a 2a20 ubdirectories.* │ │ │ │ │ -00001c50: 5375 6264 6972 6563 746f 7269 6573 2077 Subdirectories w │ │ │ │ │ -00001c60: 6974 6820 4143 5f53 5542 5354 3a3a 2020 ith AC_SUBST:: │ │ │ │ │ -00001c70: 416e 6f74 6865 7220 7761 7920 666f 7220 Another way for │ │ │ │ │ -00001c80: 636f 6e64 6974 696f 6e61 6c20 7265 6375 conditional recu │ │ │ │ │ -00001c90: 7273 696f 6e0a 2a20 556e 636f 6e66 6967 rsion.* Unconfig │ │ │ │ │ -00001ca0: 7572 6564 2053 7562 6469 7265 6374 6f72 ured Subdirector │ │ │ │ │ -00001cb0: 6965 733a 3a20 204e 6f74 2065 7665 6e20 ies:: Not even │ │ │ │ │ -00001cc0: 6372 6561 7469 6e67 2061 2027 4d61 6b65 creating a 'Make │ │ │ │ │ -00001cd0: 6669 6c65 270a 0a42 7569 6c64 696e 6720 file'..Building │ │ │ │ │ -00001ce0: 5072 6f67 7261 6d73 2061 6e64 204c 6962 Programs and Lib │ │ │ │ │ -00001cf0: 7261 7269 6573 0a0a 2a20 4120 5072 6f67 raries..* A Prog │ │ │ │ │ -00001d00: 7261 6d3a 3a20 2020 2020 2020 2020 2020 ram:: │ │ │ │ │ -00001d10: 2020 2020 2020 2020 4275 696c 6469 6e67 Building │ │ │ │ │ -00001d20: 2061 2070 726f 6772 616d 0a2a 2041 204c a program.* A L │ │ │ │ │ -00001d30: 6962 7261 7279 3a3a 2020 2020 2020 2020 ibrary:: │ │ │ │ │ -00001d40: 2020 2020 2020 2020 2020 2042 7569 6c64 Build │ │ │ │ │ -00001d50: 696e 6720 6120 6c69 6272 6172 790a 2a20 ing a library.* │ │ │ │ │ -00001d60: 4120 5368 6172 6564 204c 6962 7261 7279 A Shared Library │ │ │ │ │ -00001d70: 3a3a 2020 2020 2020 2020 2020 2020 4275 :: Bu │ │ │ │ │ -00001d80: 696c 6469 6e67 2061 204c 6962 746f 6f6c ilding a Libtool │ │ │ │ │ -00001d90: 206c 6962 7261 7279 0a2a 2050 726f 6772 library.* Progr │ │ │ │ │ -00001da0: 616d 2061 6e64 204c 6962 7261 7279 2056 am and Library V │ │ │ │ │ -00001db0: 6172 6961 626c 6573 3a3a 2020 5661 7269 ariables:: Vari │ │ │ │ │ -00001dc0: 6162 6c65 7320 636f 6e74 726f 6c6c 696e ables controllin │ │ │ │ │ -00001dd0: 6720 7072 6f67 7261 6d20 616e 640a 2020 g program and. │ │ │ │ │ +00001960: 2020 2053 6572 6961 6c20 6c69 6e65 7320 Serial lines │ │ │ │ │ +00001970: 696e 2041 7574 6f63 6f6e 6620 6d61 6372 in Autoconf macr │ │ │ │ │ +00001980: 6f73 0a2a 2046 7574 7572 6520 6f66 2061 os.* Future of a │ │ │ │ │ +00001990: 636c 6f63 616c 3a3a 2020 2020 2020 2020 clocal:: │ │ │ │ │ +000019a0: 2020 2061 636c 6f63 616c 2773 2073 6368 aclocal's sch │ │ │ │ │ +000019b0: 6564 756c 6564 2064 6561 7468 0a0a 4175 eduled death..Au │ │ │ │ │ +000019c0: 746f 636f 6e66 206d 6163 726f 7320 7375 toconf macros su │ │ │ │ │ +000019d0: 7070 6c69 6564 2077 6974 6820 4175 746f pplied with Auto │ │ │ │ │ +000019e0: 6d61 6b65 0a0a 2a20 5075 626c 6963 204d make..* Public M │ │ │ │ │ +000019f0: 6163 726f 733a 3a20 2020 2020 2020 2020 acros:: │ │ │ │ │ +00001a00: 2020 2020 2020 4d61 6372 6f73 2074 6861 Macros tha │ │ │ │ │ +00001a10: 7420 796f 7520 6361 6e20 7573 652e 0a2a t you can use..* │ │ │ │ │ +00001a20: 204f 6273 6f6c 6574 6520 4d61 6372 6f73 Obsolete Macros │ │ │ │ │ +00001a30: 3a3a 2020 2020 2020 2020 2020 2020 204d :: M │ │ │ │ │ +00001a40: 6163 726f 7320 7468 6174 2079 6f75 2073 acros that you s │ │ │ │ │ +00001a50: 686f 756c 6420 7374 6f70 2075 7369 6e67 hould stop using │ │ │ │ │ +00001a60: 2e0a 2a20 5072 6976 6174 6520 4d61 6372 ..* Private Macr │ │ │ │ │ +00001a70: 6f73 3a3a 2020 2020 2020 2020 2020 2020 os:: │ │ │ │ │ +00001a80: 2020 4d61 6372 6f73 2074 6861 7420 796f Macros that yo │ │ │ │ │ +00001a90: 7520 7368 6f75 6c64 206e 6f74 2075 7365 u should not use │ │ │ │ │ +00001aa0: 2e0a 0a44 6972 6563 746f 7269 6573 0a0a ...Directories.. │ │ │ │ │ +00001ab0: 2a20 5375 6264 6972 6563 746f 7269 6573 * Subdirectories │ │ │ │ │ +00001ac0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00001ad0: 4275 696c 6469 6e67 2073 7562 6469 7265 Building subdire │ │ │ │ │ +00001ae0: 6374 6f72 6965 7320 7265 6375 7273 6976 ctories recursiv │ │ │ │ │ +00001af0: 656c 790a 2a20 436f 6e64 6974 696f 6e61 ely.* Conditiona │ │ │ │ │ +00001b00: 6c20 5375 6264 6972 6563 746f 7269 6573 l Subdirectories │ │ │ │ │ +00001b10: 3a3a 2020 436f 6e64 6974 696f 6e61 6c6c :: Conditionall │ │ │ │ │ +00001b20: 7920 6e6f 7420 6275 696c 6469 6e67 2064 y not building d │ │ │ │ │ +00001b30: 6972 6563 746f 7269 6573 0a2a 2041 6c74 irectories.* Alt │ │ │ │ │ +00001b40: 6572 6e61 7469 7665 3a3a 2020 2020 2020 ernative:: │ │ │ │ │ +00001b50: 2020 2020 2020 2020 2020 2053 7562 6469 Subdi │ │ │ │ │ +00001b60: 7265 6374 6f72 6965 7320 7769 7468 6f75 rectories withou │ │ │ │ │ +00001b70: 7420 7265 6375 7273 696f 6e0a 2a20 5375 t recursion.* Su │ │ │ │ │ +00001b80: 6270 6163 6b61 6765 733a 3a20 2020 2020 bpackages:: │ │ │ │ │ +00001b90: 2020 2020 2020 2020 2020 2020 4e65 7374 Nest │ │ │ │ │ +00001ba0: 696e 6720 7061 636b 6167 6573 0a0a 436f ing packages..Co │ │ │ │ │ +00001bb0: 6e64 6974 696f 6e61 6c20 5375 6264 6972 nditional Subdir │ │ │ │ │ +00001bc0: 6563 746f 7269 6573 0a0a 2a20 5355 4244 ectories..* SUBD │ │ │ │ │ +00001bd0: 4952 5320 7673 2044 4953 545f 5355 4244 IRS vs DIST_SUBD │ │ │ │ │ +00001be0: 4952 533a 3a20 2020 2020 5477 6f20 7365 IRS:: Two se │ │ │ │ │ +00001bf0: 7473 206f 6620 6469 7265 6374 6f72 6965 ts of directorie │ │ │ │ │ +00001c00: 730a 2a20 5375 6264 6972 6563 746f 7269 s.* Subdirectori │ │ │ │ │ +00001c10: 6573 2077 6974 6820 414d 5f43 4f4e 4449 es with AM_CONDI │ │ │ │ │ +00001c20: 5449 4f4e 414c 3a3a 2020 5370 6563 6966 TIONAL:: Specif │ │ │ │ │ +00001c30: 7969 6e67 2063 6f6e 6469 7469 6f6e 616c ying conditional │ │ │ │ │ +00001c40: 2073 7562 6469 7265 6374 6f72 6965 730a subdirectories. │ │ │ │ │ +00001c50: 2a20 5375 6264 6972 6563 746f 7269 6573 * Subdirectories │ │ │ │ │ +00001c60: 2077 6974 6820 4143 5f53 5542 5354 3a3a with AC_SUBST:: │ │ │ │ │ +00001c70: 2020 416e 6f74 6865 7220 7761 7920 666f Another way fo │ │ │ │ │ +00001c80: 7220 636f 6e64 6974 696f 6e61 6c20 7265 r conditional re │ │ │ │ │ +00001c90: 6375 7273 696f 6e0a 2a20 556e 636f 6e66 cursion.* Unconf │ │ │ │ │ +00001ca0: 6967 7572 6564 2053 7562 6469 7265 6374 igured Subdirect │ │ │ │ │ +00001cb0: 6f72 6965 733a 3a20 204e 6f74 2065 7665 ories:: Not eve │ │ │ │ │ +00001cc0: 6e20 6372 6561 7469 6e67 2061 2027 4d61 n creating a 'Ma │ │ │ │ │ +00001cd0: 6b65 6669 6c65 270a 0a42 7569 6c64 696e kefile'..Buildin │ │ │ │ │ +00001ce0: 6720 5072 6f67 7261 6d73 2061 6e64 204c g Programs and L │ │ │ │ │ +00001cf0: 6962 7261 7269 6573 0a0a 2a20 4120 5072 ibraries..* A Pr │ │ │ │ │ +00001d00: 6f67 7261 6d3a 3a20 2020 2020 2020 2020 ogram:: │ │ │ │ │ +00001d10: 2020 2020 2020 2020 2020 4275 696c 6469 Buildi │ │ │ │ │ +00001d20: 6e67 2061 2070 726f 6772 616d 0a2a 2041 ng a program.* A │ │ │ │ │ +00001d30: 204c 6962 7261 7279 3a3a 2020 2020 2020 Library:: │ │ │ │ │ +00001d40: 2020 2020 2020 2020 2020 2020 2042 7569 Bui │ │ │ │ │ +00001d50: 6c64 696e 6720 6120 6c69 6272 6172 790a lding a library. │ │ │ │ │ +00001d60: 2a20 4120 5368 6172 6564 204c 6962 7261 * A Shared Libra │ │ │ │ │ +00001d70: 7279 3a3a 2020 2020 2020 2020 2020 2020 ry:: │ │ │ │ │ +00001d80: 4275 696c 6469 6e67 2061 204c 6962 746f Building a Libto │ │ │ │ │ +00001d90: 6f6c 206c 6962 7261 7279 0a2a 2050 726f ol library.* Pro │ │ │ │ │ +00001da0: 6772 616d 2061 6e64 204c 6962 7261 7279 gram and Library │ │ │ │ │ +00001db0: 2056 6172 6961 626c 6573 3a3a 2020 5661 Variables:: Va │ │ │ │ │ +00001dc0: 7269 6162 6c65 7320 636f 6e74 726f 6c6c riables controll │ │ │ │ │ +00001dd0: 696e 6720 7072 6f67 7261 6d20 616e 640a ing program and. │ │ │ │ │ 00001de0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001df0: 2020 2020 2020 2020 2020 2020 2020 6c69 li │ │ │ │ │ -00001e00: 6272 6172 7920 6275 696c 6473 0a2a 2044 brary builds.* D │ │ │ │ │ -00001e10: 6566 6175 6c74 205f 534f 5552 4345 533a efault _SOURCES: │ │ │ │ │ -00001e20: 3a20 2020 2020 2020 2020 2020 2044 6566 : Def │ │ │ │ │ -00001e30: 6175 6c74 2073 6f75 7263 6520 6669 6c65 ault source file │ │ │ │ │ -00001e40: 730a 2a20 4c49 424f 424a 533a 3a20 2020 s.* LIBOBJS:: │ │ │ │ │ +00001df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001e00: 6c69 6272 6172 7920 6275 696c 6473 0a2a library builds.* │ │ │ │ │ +00001e10: 2044 6566 6175 6c74 205f 534f 5552 4345 Default _SOURCE │ │ │ │ │ +00001e20: 533a 3a20 2020 2020 2020 2020 2020 2044 S:: D │ │ │ │ │ +00001e30: 6566 6175 6c74 2073 6f75 7263 6520 6669 efault source fi │ │ │ │ │ +00001e40: 6c65 730a 2a20 4c49 424f 424a 533a 3a20 les.* LIBOBJS:: │ │ │ │ │ 00001e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001e60: 2020 5370 6563 6961 6c20 6861 6e64 6c69 Special handli │ │ │ │ │ -00001e70: 6e67 2066 6f72 204c 4942 4f42 4a53 2061 ng for LIBOBJS a │ │ │ │ │ -00001e80: 6e64 2041 4c4c 4f43 410a 2a20 5072 6f67 nd ALLOCA.* Prog │ │ │ │ │ -00001e90: 7261 6d20 5661 7269 6162 6c65 733a 3a20 ram Variables:: │ │ │ │ │ -00001ea0: 2020 2020 2020 2020 2020 5661 7269 6162 Variab │ │ │ │ │ -00001eb0: 6c65 7320 7573 6564 2077 6865 6e20 6275 les used when bu │ │ │ │ │ -00001ec0: 696c 6469 6e67 2061 2070 726f 6772 616d ilding a program │ │ │ │ │ -00001ed0: 0a2a 2059 6163 6320 616e 6420 4c65 783a .* Yacc and Lex: │ │ │ │ │ -00001ee0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00001ef0: 2059 6163 6320 616e 6420 4c65 7820 7375 Yacc and Lex su │ │ │ │ │ -00001f00: 7070 6f72 740a 2a20 432b 2b20 5375 7070 pport.* C++ Supp │ │ │ │ │ -00001f10: 6f72 743a 3a20 2020 2020 2020 2020 2020 ort:: │ │ │ │ │ -00001f20: 2020 2020 2020 436f 6d70 696c 696e 6720 Compiling │ │ │ │ │ -00001f30: 432b 2b20 736f 7572 6365 730a 2a20 4f62 C++ sources.* Ob │ │ │ │ │ -00001f40: 6a65 6374 6976 6520 4320 5375 7070 6f72 jective C Suppor │ │ │ │ │ -00001f50: 743a 3a20 2020 2020 2020 2020 436f 6d70 t:: Comp │ │ │ │ │ -00001f60: 696c 696e 6720 4f62 6a65 6374 6976 6520 iling Objective │ │ │ │ │ -00001f70: 4320 736f 7572 6365 730a 2a20 556e 6966 C sources.* Unif │ │ │ │ │ -00001f80: 6965 6420 5061 7261 6c6c 656c 2043 2053 ied Parallel C S │ │ │ │ │ -00001f90: 7570 706f 7274 3a3a 2020 436f 6d70 696c upport:: Compil │ │ │ │ │ -00001fa0: 696e 6720 556e 6966 6965 6420 5061 7261 ing Unified Para │ │ │ │ │ -00001fb0: 6c6c 656c 2043 2073 6f75 7263 6573 0a2a llel C sources.* │ │ │ │ │ -00001fc0: 2041 7373 656d 626c 7920 5375 7070 6f72 Assembly Suppor │ │ │ │ │ -00001fd0: 743a 3a20 2020 2020 2020 2020 2020 2043 t:: C │ │ │ │ │ -00001fe0: 6f6d 7069 6c69 6e67 2061 7373 656d 626c ompiling assembl │ │ │ │ │ -00001ff0: 7920 736f 7572 6365 730a 2a20 466f 7274 y sources.* Fort │ │ │ │ │ -00002000: 7261 6e20 3737 2053 7570 706f 7274 3a3a ran 77 Support:: │ │ │ │ │ -00002010: 2020 2020 2020 2020 2020 436f 6d70 696c Compil │ │ │ │ │ -00002020: 696e 6720 466f 7274 7261 6e20 3737 2073 ing Fortran 77 s │ │ │ │ │ -00002030: 6f75 7263 6573 0a2a 2046 6f72 7472 616e ources.* Fortran │ │ │ │ │ -00002040: 2039 7820 5375 7070 6f72 743a 3a20 2020 9x Support:: │ │ │ │ │ -00002050: 2020 2020 2020 2043 6f6d 7069 6c69 6e67 Compiling │ │ │ │ │ -00002060: 2046 6f72 7472 616e 2039 7820 736f 7572 Fortran 9x sour │ │ │ │ │ -00002070: 6365 730a 2a20 4a61 7661 2053 7570 706f ces.* Java Suppo │ │ │ │ │ -00002080: 7274 2077 6974 6820 6763 6a3a 3a20 2020 rt with gcj:: │ │ │ │ │ -00002090: 2020 2020 436f 6d70 696c 696e 6720 4a61 Compiling Ja │ │ │ │ │ -000020a0: 7661 2073 6f75 7263 6573 2075 7369 6e67 va sources using │ │ │ │ │ -000020b0: 2067 636a 0a2a 2056 616c 6120 5375 7070 gcj.* Vala Supp │ │ │ │ │ -000020c0: 6f72 743a 3a20 2020 2020 2020 2020 2020 ort:: │ │ │ │ │ -000020d0: 2020 2020 2043 6f6d 7069 6c69 6e67 2056 Compiling V │ │ │ │ │ -000020e0: 616c 6120 736f 7572 6365 730a 2a20 5375 ala sources.* Su │ │ │ │ │ -000020f0: 7070 6f72 7420 666f 7220 4f74 6865 7220 pport for Other │ │ │ │ │ -00002100: 4c61 6e67 7561 6765 733a 3a20 2043 6f6d Languages:: Com │ │ │ │ │ -00002110: 7069 6c69 6e67 206f 7468 6572 206c 616e piling other lan │ │ │ │ │ -00002120: 6775 6167 6573 0a2a 2041 4e53 493a 3a20 guages.* ANSI:: │ │ │ │ │ -00002130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002140: 2020 2020 2020 2041 7574 6f6d 6174 6963 Automatic │ │ │ │ │ -00002150: 2064 652d 414e 5349 2d66 6963 6174 696f de-ANSI-ficatio │ │ │ │ │ -00002160: 6e20 2864 6570 7265 6361 7465 642c 2073 n (deprecated, s │ │ │ │ │ -00002170: 6f6f 6e20 746f 2062 6520 7265 6d6f 7665 oon to be remove │ │ │ │ │ -00002180: 6429 0a2a 2044 6570 656e 6465 6e63 6965 d).* Dependencie │ │ │ │ │ -00002190: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ -000021a0: 2020 2041 7574 6f6d 6174 6963 2064 6570 Automatic dep │ │ │ │ │ -000021b0: 656e 6465 6e63 7920 7472 6163 6b69 6e67 endency tracking │ │ │ │ │ -000021c0: 0a2a 2045 5845 4558 543a 3a20 2020 2020 .* EXEEXT:: │ │ │ │ │ +00001e60: 2020 2020 5370 6563 6961 6c20 6861 6e64 Special hand │ │ │ │ │ +00001e70: 6c69 6e67 2066 6f72 204c 4942 4f42 4a53 ling for LIBOBJS │ │ │ │ │ +00001e80: 2061 6e64 2041 4c4c 4f43 410a 2a20 5072 and ALLOCA.* Pr │ │ │ │ │ +00001e90: 6f67 7261 6d20 5661 7269 6162 6c65 733a ogram Variables: │ │ │ │ │ +00001ea0: 3a20 2020 2020 2020 2020 2020 5661 7269 : Vari │ │ │ │ │ +00001eb0: 6162 6c65 7320 7573 6564 2077 6865 6e20 ables used when │ │ │ │ │ +00001ec0: 6275 696c 6469 6e67 2061 2070 726f 6772 building a progr │ │ │ │ │ +00001ed0: 616d 0a2a 2059 6163 6320 616e 6420 4c65 am.* Yacc and Le │ │ │ │ │ +00001ee0: 783a 3a20 2020 2020 2020 2020 2020 2020 x:: │ │ │ │ │ +00001ef0: 2020 2059 6163 6320 616e 6420 4c65 7820 Yacc and Lex │ │ │ │ │ +00001f00: 7375 7070 6f72 740a 2a20 432b 2b20 5375 support.* C++ Su │ │ │ │ │ +00001f10: 7070 6f72 743a 3a20 2020 2020 2020 2020 pport:: │ │ │ │ │ +00001f20: 2020 2020 2020 2020 436f 6d70 696c 696e Compilin │ │ │ │ │ +00001f30: 6720 432b 2b20 736f 7572 6365 730a 2a20 g C++ sources.* │ │ │ │ │ +00001f40: 4f62 6a65 6374 6976 6520 4320 5375 7070 Objective C Supp │ │ │ │ │ +00001f50: 6f72 743a 3a20 2020 2020 2020 2020 436f ort:: Co │ │ │ │ │ +00001f60: 6d70 696c 696e 6720 4f62 6a65 6374 6976 mpiling Objectiv │ │ │ │ │ +00001f70: 6520 4320 736f 7572 6365 730a 2a20 556e e C sources.* Un │ │ │ │ │ +00001f80: 6966 6965 6420 5061 7261 6c6c 656c 2043 ified Parallel C │ │ │ │ │ +00001f90: 2053 7570 706f 7274 3a3a 2020 436f 6d70 Support:: Comp │ │ │ │ │ +00001fa0: 696c 696e 6720 556e 6966 6965 6420 5061 iling Unified Pa │ │ │ │ │ +00001fb0: 7261 6c6c 656c 2043 2073 6f75 7263 6573 rallel C sources │ │ │ │ │ +00001fc0: 0a2a 2041 7373 656d 626c 7920 5375 7070 .* Assembly Supp │ │ │ │ │ +00001fd0: 6f72 743a 3a20 2020 2020 2020 2020 2020 ort:: │ │ │ │ │ +00001fe0: 2043 6f6d 7069 6c69 6e67 2061 7373 656d Compiling assem │ │ │ │ │ +00001ff0: 626c 7920 736f 7572 6365 730a 2a20 466f bly sources.* Fo │ │ │ │ │ +00002000: 7274 7261 6e20 3737 2053 7570 706f 7274 rtran 77 Support │ │ │ │ │ +00002010: 3a3a 2020 2020 2020 2020 2020 436f 6d70 :: Comp │ │ │ │ │ +00002020: 696c 696e 6720 466f 7274 7261 6e20 3737 iling Fortran 77 │ │ │ │ │ +00002030: 2073 6f75 7263 6573 0a2a 2046 6f72 7472 sources.* Fortr │ │ │ │ │ +00002040: 616e 2039 7820 5375 7070 6f72 743a 3a20 an 9x Support:: │ │ │ │ │ +00002050: 2020 2020 2020 2020 2043 6f6d 7069 6c69 Compili │ │ │ │ │ +00002060: 6e67 2046 6f72 7472 616e 2039 7820 736f ng Fortran 9x so │ │ │ │ │ +00002070: 7572 6365 730a 2a20 4a61 7661 2053 7570 urces.* Java Sup │ │ │ │ │ +00002080: 706f 7274 2077 6974 6820 6763 6a3a 3a20 port with gcj:: │ │ │ │ │ +00002090: 2020 2020 2020 436f 6d70 696c 696e 6720 Compiling │ │ │ │ │ +000020a0: 4a61 7661 2073 6f75 7263 6573 2075 7369 Java sources usi │ │ │ │ │ +000020b0: 6e67 2067 636a 0a2a 2056 616c 6120 5375 ng gcj.* Vala Su │ │ │ │ │ +000020c0: 7070 6f72 743a 3a20 2020 2020 2020 2020 pport:: │ │ │ │ │ +000020d0: 2020 2020 2020 2043 6f6d 7069 6c69 6e67 Compiling │ │ │ │ │ +000020e0: 2056 616c 6120 736f 7572 6365 730a 2a20 Vala sources.* │ │ │ │ │ +000020f0: 5375 7070 6f72 7420 666f 7220 4f74 6865 Support for Othe │ │ │ │ │ +00002100: 7220 4c61 6e67 7561 6765 733a 3a20 2043 r Languages:: C │ │ │ │ │ +00002110: 6f6d 7069 6c69 6e67 206f 7468 6572 206c ompiling other l │ │ │ │ │ +00002120: 616e 6775 6167 6573 0a2a 2041 4e53 493a anguages.* ANSI: │ │ │ │ │ +00002130: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00002140: 2020 2020 2020 2020 2041 7574 6f6d 6174 Automat │ │ │ │ │ +00002150: 6963 2064 652d 414e 5349 2d66 6963 6174 ic de-ANSI-ficat │ │ │ │ │ +00002160: 696f 6e20 2864 6570 7265 6361 7465 642c ion (deprecated, │ │ │ │ │ +00002170: 2073 6f6f 6e20 746f 2062 6520 7265 6d6f soon to be remo │ │ │ │ │ +00002180: 7665 6429 0a2a 2044 6570 656e 6465 6e63 ved).* Dependenc │ │ │ │ │ +00002190: 6965 733a 3a20 2020 2020 2020 2020 2020 ies:: │ │ │ │ │ +000021a0: 2020 2020 2041 7574 6f6d 6174 6963 2064 Automatic d │ │ │ │ │ +000021b0: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ +000021c0: 6e67 0a2a 2045 5845 4558 543a 3a20 2020 ng.* EXEEXT:: │ │ │ │ │ 000021d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000021e0: 2053 7570 706f 7274 2066 6f72 2065 7865 Support for exe │ │ │ │ │ -000021f0: 6375 7461 626c 6520 6578 7465 6e73 696f cutable extensio │ │ │ │ │ -00002200: 6e73 0a0a 4275 696c 6469 6e67 2061 2070 ns..Building a p │ │ │ │ │ -00002210: 726f 6772 616d 0a0a 2a20 5072 6f67 7261 rogram..* Progra │ │ │ │ │ -00002220: 6d20 536f 7572 6365 733a 3a20 2020 2020 m Sources:: │ │ │ │ │ -00002230: 2020 2020 2020 2020 4465 6669 6e69 6e67 Defining │ │ │ │ │ -00002240: 2070 726f 6772 616d 2073 6f75 7263 6573 program sources │ │ │ │ │ -00002250: 0a2a 204c 696e 6b69 6e67 3a3a 2020 2020 .* Linking:: │ │ │ │ │ +000021e0: 2020 2053 7570 706f 7274 2066 6f72 2065 Support for e │ │ │ │ │ +000021f0: 7865 6375 7461 626c 6520 6578 7465 6e73 xecutable extens │ │ │ │ │ +00002200: 696f 6e73 0a0a 4275 696c 6469 6e67 2061 ions..Building a │ │ │ │ │ +00002210: 2070 726f 6772 616d 0a0a 2a20 5072 6f67 program..* Prog │ │ │ │ │ +00002220: 7261 6d20 536f 7572 6365 733a 3a20 2020 ram Sources:: │ │ │ │ │ +00002230: 2020 2020 2020 2020 2020 4465 6669 6e69 Defini │ │ │ │ │ +00002240: 6e67 2070 726f 6772 616d 2073 6f75 7263 ng program sourc │ │ │ │ │ +00002250: 6573 0a2a 204c 696e 6b69 6e67 3a3a 2020 es.* Linking:: │ │ │ │ │ 00002260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002270: 204c 696e 6b69 6e67 2077 6974 6820 6c69 Linking with li │ │ │ │ │ -00002280: 6272 6172 6965 7320 6f72 2065 7874 7261 braries or extra │ │ │ │ │ -00002290: 206f 626a 6563 7473 0a2a 2043 6f6e 6469 objects.* Condi │ │ │ │ │ -000022a0: 7469 6f6e 616c 2053 6f75 7263 6573 3a3a tional Sources:: │ │ │ │ │ -000022b0: 2020 2020 2020 2020 2048 616e 646c 696e Handlin │ │ │ │ │ -000022c0: 6720 636f 6e64 6974 696f 6e61 6c20 736f g conditional so │ │ │ │ │ -000022d0: 7572 6365 730a 2a20 436f 6e64 6974 696f urces.* Conditio │ │ │ │ │ -000022e0: 6e61 6c20 5072 6f67 7261 6d73 3a3a 2020 nal Programs:: │ │ │ │ │ -000022f0: 2020 2020 2020 4275 696c 6469 6e67 2061 Building a │ │ │ │ │ -00002300: 2070 726f 6772 616d 2063 6f6e 6469 7469 program conditi │ │ │ │ │ -00002310: 6f6e 616c 6c79 0a0a 4275 696c 6469 6e67 onally..Building │ │ │ │ │ -00002320: 2061 2053 6861 7265 6420 4c69 6272 6172 a Shared Librar │ │ │ │ │ -00002330: 790a 0a2a 204c 6962 746f 6f6c 2043 6f6e y..* Libtool Con │ │ │ │ │ -00002340: 6365 7074 3a3a 2020 2020 2020 2020 2020 cept:: │ │ │ │ │ -00002350: 2020 2049 6e74 726f 6475 6369 6e67 204c Introducing L │ │ │ │ │ -00002360: 6962 746f 6f6c 0a2a 204c 6962 746f 6f6c ibtool.* Libtool │ │ │ │ │ -00002370: 204c 6962 7261 7269 6573 3a3a 2020 2020 Libraries:: │ │ │ │ │ -00002380: 2020 2020 2020 2044 6563 6c61 7269 6e67 Declaring │ │ │ │ │ -00002390: 204c 6962 746f 6f6c 204c 6962 7261 7269 Libtool Librari │ │ │ │ │ -000023a0: 6573 0a2a 2043 6f6e 6469 7469 6f6e 616c es.* Conditional │ │ │ │ │ -000023b0: 204c 6962 746f 6f6c 204c 6962 7261 7269 Libtool Librari │ │ │ │ │ -000023c0: 6573 3a3a 2020 4275 696c 6469 6e67 204c es:: Building L │ │ │ │ │ -000023d0: 6962 746f 6f6c 204c 6962 7261 7269 6573 ibtool Libraries │ │ │ │ │ -000023e0: 2043 6f6e 6469 7469 6f6e 616c 6c79 0a2a Conditionally.* │ │ │ │ │ -000023f0: 2043 6f6e 6469 7469 6f6e 616c 204c 6962 Conditional Lib │ │ │ │ │ -00002400: 746f 6f6c 2053 6f75 7263 6573 3a3a 2020 tool Sources:: │ │ │ │ │ -00002410: 4368 6f6f 7369 6e67 204c 6962 7261 7279 Choosing Library │ │ │ │ │ -00002420: 2053 6f75 7263 6573 2043 6f6e 6469 7469 Sources Conditi │ │ │ │ │ -00002430: 6f6e 616c 6c79 0a2a 204c 6962 746f 6f6c onally.* Libtool │ │ │ │ │ -00002440: 2043 6f6e 7665 6e69 656e 6365 204c 6962 Convenience Lib │ │ │ │ │ -00002450: 7261 7269 6573 3a3a 2020 4275 696c 6469 raries:: Buildi │ │ │ │ │ -00002460: 6e67 2043 6f6e 7665 6e69 656e 6365 204c ng Convenience L │ │ │ │ │ -00002470: 6962 746f 6f6c 204c 6962 7261 7269 6573 ibtool Libraries │ │ │ │ │ -00002480: 0a2a 204c 6962 746f 6f6c 204d 6f64 756c .* Libtool Modul │ │ │ │ │ -00002490: 6573 3a3a 2020 2020 2020 2020 2020 2020 es:: │ │ │ │ │ -000024a0: 2042 7569 6c64 696e 6720 4c69 6274 6f6f Building Libtoo │ │ │ │ │ -000024b0: 6c20 4d6f 6475 6c65 730a 2a20 4c69 6274 l Modules.* Libt │ │ │ │ │ -000024c0: 6f6f 6c20 466c 6167 733a 3a20 2020 2020 ool Flags:: │ │ │ │ │ -000024d0: 2020 2020 2020 2020 2020 5573 696e 6720 Using │ │ │ │ │ -000024e0: 5f4c 4942 4144 442c 205f 4c44 464c 4147 _LIBADD, _LDFLAG │ │ │ │ │ -000024f0: 532c 2061 6e64 205f 4c49 4254 4f4f 4c46 S, and _LIBTOOLF │ │ │ │ │ -00002500: 4c41 4753 0a2a 204c 544c 4942 4f42 4a53 LAGS.* LTLIBOBJS │ │ │ │ │ -00002510: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00002520: 2020 2020 2055 7369 6e67 2024 284c 544c Using $(LTL │ │ │ │ │ -00002530: 4942 4f42 4a53 2920 616e 6420 2428 4c54 IBOBJS) and $(LT │ │ │ │ │ -00002540: 414c 4c4f 4341 290a 2a20 4c69 6274 6f6f ALLOCA).* Libtoo │ │ │ │ │ -00002550: 6c20 4973 7375 6573 3a3a 2020 2020 2020 l Issues:: │ │ │ │ │ -00002560: 2020 2020 2020 2020 436f 6d6d 6f6e 2049 Common I │ │ │ │ │ -00002570: 7373 7565 7320 5265 6c61 7465 6420 746f ssues Related to │ │ │ │ │ -00002580: 204c 6962 746f 6f6c 2773 2055 7365 0a0a Libtool's Use.. │ │ │ │ │ -00002590: 436f 6d6d 6f6e 2049 7373 7565 7320 5265 Common Issues Re │ │ │ │ │ -000025a0: 6c61 7465 6420 746f 204c 6962 746f 6f6c lated to Libtool │ │ │ │ │ -000025b0: 2773 2055 7365 0a0a 2a20 4572 726f 7220 's Use..* Error │ │ │ │ │ -000025c0: 7265 7175 6972 6564 2066 696c 6520 6c74 required file lt │ │ │ │ │ -000025d0: 6d61 696e 2e73 6820 6e6f 7420 666f 756e main.sh not foun │ │ │ │ │ -000025e0: 643a 3a20 2054 6865 206e 6565 6420 746f d:: The need to │ │ │ │ │ -000025f0: 2072 756e 206c 6962 746f 6f6c 697a 650a run libtoolize. │ │ │ │ │ -00002600: 2a20 4f62 6a65 6374 7320 6372 6561 7465 * Objects create │ │ │ │ │ -00002610: 6420 626f 7468 2077 6974 6820 6c69 6274 d both with libt │ │ │ │ │ -00002620: 6f6f 6c20 616e 6420 7769 7468 6f75 743a ool and without: │ │ │ │ │ -00002630: 3a20 2041 766f 6964 2061 2073 7065 6369 : Avoid a speci │ │ │ │ │ -00002640: 6669 6320 6275 696c 6420 7261 6365 0a0a fic build race.. │ │ │ │ │ -00002650: 466f 7274 7261 6e20 3737 2053 7570 706f Fortran 77 Suppo │ │ │ │ │ -00002660: 7274 0a0a 2a20 5072 6570 726f 6365 7373 rt..* Preprocess │ │ │ │ │ -00002670: 696e 6720 466f 7274 7261 6e20 3737 3a3a ing Fortran 77:: │ │ │ │ │ -00002680: 2020 2020 5072 6570 726f 6365 7373 696e Preprocessin │ │ │ │ │ -00002690: 6720 466f 7274 7261 6e20 3737 2073 6f75 g Fortran 77 sou │ │ │ │ │ -000026a0: 7263 6573 0a2a 2043 6f6d 7069 6c69 6e67 rces.* Compiling │ │ │ │ │ -000026b0: 2046 6f72 7472 616e 2037 3720 4669 6c65 Fortran 77 File │ │ │ │ │ -000026c0: 733a 3a20 2043 6f6d 7069 6c69 6e67 2046 s:: Compiling F │ │ │ │ │ -000026d0: 6f72 7472 616e 2037 3720 736f 7572 6365 ortran 77 source │ │ │ │ │ -000026e0: 730a 2a20 4d69 7869 6e67 2046 6f72 7472 s.* Mixing Fortr │ │ │ │ │ -000026f0: 616e 2037 3720 5769 7468 2043 2061 6e64 an 77 With C and │ │ │ │ │ -00002700: 2043 2b2b 3a3a 2020 4d69 7869 6e67 2046 C++:: Mixing F │ │ │ │ │ -00002710: 6f72 7472 616e 2037 3720 5769 7468 2043 ortran 77 With C │ │ │ │ │ -00002720: 2061 6e64 2043 2b2b 0a0a 4d69 7869 6e67 and C++..Mixing │ │ │ │ │ -00002730: 2046 6f72 7472 616e 2037 3720 5769 7468 Fortran 77 With │ │ │ │ │ -00002740: 2043 2061 6e64 2043 2b2b 0a0a 2a20 486f C and C++..* Ho │ │ │ │ │ -00002750: 7720 7468 6520 4c69 6e6b 6572 2069 7320 w the Linker is │ │ │ │ │ -00002760: 4368 6f73 656e 3a3a 2020 2020 4175 746f Chosen:: Auto │ │ │ │ │ -00002770: 6d61 7469 6320 6c69 6e6b 6572 2073 656c matic linker sel │ │ │ │ │ -00002780: 6563 7469 6f6e 0a0a 466f 7274 7261 6e20 ection..Fortran │ │ │ │ │ -00002790: 3978 2053 7570 706f 7274 0a0a 2a20 436f 9x Support..* Co │ │ │ │ │ -000027a0: 6d70 696c 696e 6720 466f 7274 7261 6e20 mpiling Fortran │ │ │ │ │ -000027b0: 3978 2046 696c 6573 3a3a 2020 436f 6d70 9x Files:: Comp │ │ │ │ │ -000027c0: 696c 696e 6720 466f 7274 7261 6e20 3978 iling Fortran 9x │ │ │ │ │ -000027d0: 2073 6f75 7263 6573 0a0a 4f74 6865 7220 sources..Other │ │ │ │ │ -000027e0: 4465 7269 7665 6420 4f62 6a65 6374 730a Derived Objects. │ │ │ │ │ -000027f0: 0a2a 2053 6372 6970 7473 3a3a 2020 2020 .* Scripts:: │ │ │ │ │ +00002270: 2020 204c 696e 6b69 6e67 2077 6974 6820 Linking with │ │ │ │ │ +00002280: 6c69 6272 6172 6965 7320 6f72 2065 7874 libraries or ext │ │ │ │ │ +00002290: 7261 206f 626a 6563 7473 0a2a 2043 6f6e ra objects.* Con │ │ │ │ │ +000022a0: 6469 7469 6f6e 616c 2053 6f75 7263 6573 ditional Sources │ │ │ │ │ +000022b0: 3a3a 2020 2020 2020 2020 2048 616e 646c :: Handl │ │ │ │ │ +000022c0: 696e 6720 636f 6e64 6974 696f 6e61 6c20 ing conditional │ │ │ │ │ +000022d0: 736f 7572 6365 730a 2a20 436f 6e64 6974 sources.* Condit │ │ │ │ │ +000022e0: 696f 6e61 6c20 5072 6f67 7261 6d73 3a3a ional Programs:: │ │ │ │ │ +000022f0: 2020 2020 2020 2020 4275 696c 6469 6e67 Building │ │ │ │ │ +00002300: 2061 2070 726f 6772 616d 2063 6f6e 6469 a program condi │ │ │ │ │ +00002310: 7469 6f6e 616c 6c79 0a0a 4275 696c 6469 tionally..Buildi │ │ │ │ │ +00002320: 6e67 2061 2053 6861 7265 6420 4c69 6272 ng a Shared Libr │ │ │ │ │ +00002330: 6172 790a 0a2a 204c 6962 746f 6f6c 2043 ary..* Libtool C │ │ │ │ │ +00002340: 6f6e 6365 7074 3a3a 2020 2020 2020 2020 oncept:: │ │ │ │ │ +00002350: 2020 2020 2049 6e74 726f 6475 6369 6e67 Introducing │ │ │ │ │ +00002360: 204c 6962 746f 6f6c 0a2a 204c 6962 746f Libtool.* Libto │ │ │ │ │ +00002370: 6f6c 204c 6962 7261 7269 6573 3a3a 2020 ol Libraries:: │ │ │ │ │ +00002380: 2020 2020 2020 2020 2044 6563 6c61 7269 Declari │ │ │ │ │ +00002390: 6e67 204c 6962 746f 6f6c 204c 6962 7261 ng Libtool Libra │ │ │ │ │ +000023a0: 7269 6573 0a2a 2043 6f6e 6469 7469 6f6e ries.* Condition │ │ │ │ │ +000023b0: 616c 204c 6962 746f 6f6c 204c 6962 7261 al Libtool Libra │ │ │ │ │ +000023c0: 7269 6573 3a3a 2020 4275 696c 6469 6e67 ries:: Building │ │ │ │ │ +000023d0: 204c 6962 746f 6f6c 204c 6962 7261 7269 Libtool Librari │ │ │ │ │ +000023e0: 6573 2043 6f6e 6469 7469 6f6e 616c 6c79 es Conditionally │ │ │ │ │ +000023f0: 0a2a 2043 6f6e 6469 7469 6f6e 616c 204c .* Conditional L │ │ │ │ │ +00002400: 6962 746f 6f6c 2053 6f75 7263 6573 3a3a ibtool Sources:: │ │ │ │ │ +00002410: 2020 4368 6f6f 7369 6e67 204c 6962 7261 Choosing Libra │ │ │ │ │ +00002420: 7279 2053 6f75 7263 6573 2043 6f6e 6469 ry Sources Condi │ │ │ │ │ +00002430: 7469 6f6e 616c 6c79 0a2a 204c 6962 746f tionally.* Libto │ │ │ │ │ +00002440: 6f6c 2043 6f6e 7665 6e69 656e 6365 204c ol Convenience L │ │ │ │ │ +00002450: 6962 7261 7269 6573 3a3a 2020 4275 696c ibraries:: Buil │ │ │ │ │ +00002460: 6469 6e67 2043 6f6e 7665 6e69 656e 6365 ding Convenience │ │ │ │ │ +00002470: 204c 6962 746f 6f6c 204c 6962 7261 7269 Libtool Librari │ │ │ │ │ +00002480: 6573 0a2a 204c 6962 746f 6f6c 204d 6f64 es.* Libtool Mod │ │ │ │ │ +00002490: 756c 6573 3a3a 2020 2020 2020 2020 2020 ules:: │ │ │ │ │ +000024a0: 2020 2042 7569 6c64 696e 6720 4c69 6274 Building Libt │ │ │ │ │ +000024b0: 6f6f 6c20 4d6f 6475 6c65 730a 2a20 4c69 ool Modules.* Li │ │ │ │ │ +000024c0: 6274 6f6f 6c20 466c 6167 733a 3a20 2020 btool Flags:: │ │ │ │ │ +000024d0: 2020 2020 2020 2020 2020 2020 5573 696e Usin │ │ │ │ │ +000024e0: 6720 5f4c 4942 4144 442c 205f 4c44 464c g _LIBADD, _LDFL │ │ │ │ │ +000024f0: 4147 532c 2061 6e64 205f 4c49 4254 4f4f AGS, and _LIBTOO │ │ │ │ │ +00002500: 4c46 4c41 4753 0a2a 204c 544c 4942 4f42 LFLAGS.* LTLIBOB │ │ │ │ │ +00002510: 4a53 3a3a 2020 2020 2020 2020 2020 2020 JS:: │ │ │ │ │ +00002520: 2020 2020 2020 2055 7369 6e67 2024 284c Using $(L │ │ │ │ │ +00002530: 544c 4942 4f42 4a53 2920 616e 6420 2428 TLIBOBJS) and $( │ │ │ │ │ +00002540: 4c54 414c 4c4f 4341 290a 2a20 4c69 6274 LTALLOCA).* Libt │ │ │ │ │ +00002550: 6f6f 6c20 4973 7375 6573 3a3a 2020 2020 ool Issues:: │ │ │ │ │ +00002560: 2020 2020 2020 2020 2020 436f 6d6d 6f6e Common │ │ │ │ │ +00002570: 2049 7373 7565 7320 5265 6c61 7465 6420 Issues Related │ │ │ │ │ +00002580: 746f 204c 6962 746f 6f6c 2773 2055 7365 to Libtool's Use │ │ │ │ │ +00002590: 0a0a 436f 6d6d 6f6e 2049 7373 7565 7320 ..Common Issues │ │ │ │ │ +000025a0: 5265 6c61 7465 6420 746f 204c 6962 746f Related to Libto │ │ │ │ │ +000025b0: 6f6c 2773 2055 7365 0a0a 2a20 4572 726f ol's Use..* Erro │ │ │ │ │ +000025c0: 7220 7265 7175 6972 6564 2066 696c 6520 r required file │ │ │ │ │ +000025d0: 6c74 6d61 696e 2e73 6820 6e6f 7420 666f ltmain.sh not fo │ │ │ │ │ +000025e0: 756e 643a 3a20 2054 6865 206e 6565 6420 und:: The need │ │ │ │ │ +000025f0: 746f 2072 756e 206c 6962 746f 6f6c 697a to run libtooliz │ │ │ │ │ +00002600: 650a 2a20 4f62 6a65 6374 7320 6372 6561 e.* Objects crea │ │ │ │ │ +00002610: 7465 6420 626f 7468 2077 6974 6820 6c69 ted both with li │ │ │ │ │ +00002620: 6274 6f6f 6c20 616e 6420 7769 7468 6f75 btool and withou │ │ │ │ │ +00002630: 743a 3a20 2041 766f 6964 2061 2073 7065 t:: Avoid a spe │ │ │ │ │ +00002640: 6369 6669 6320 6275 696c 6420 7261 6365 cific build race │ │ │ │ │ +00002650: 0a0a 466f 7274 7261 6e20 3737 2053 7570 ..Fortran 77 Sup │ │ │ │ │ +00002660: 706f 7274 0a0a 2a20 5072 6570 726f 6365 port..* Preproce │ │ │ │ │ +00002670: 7373 696e 6720 466f 7274 7261 6e20 3737 ssing Fortran 77 │ │ │ │ │ +00002680: 3a3a 2020 2020 5072 6570 726f 6365 7373 :: Preprocess │ │ │ │ │ +00002690: 696e 6720 466f 7274 7261 6e20 3737 2073 ing Fortran 77 s │ │ │ │ │ +000026a0: 6f75 7263 6573 0a2a 2043 6f6d 7069 6c69 ources.* Compili │ │ │ │ │ +000026b0: 6e67 2046 6f72 7472 616e 2037 3720 4669 ng Fortran 77 Fi │ │ │ │ │ +000026c0: 6c65 733a 3a20 2043 6f6d 7069 6c69 6e67 les:: Compiling │ │ │ │ │ +000026d0: 2046 6f72 7472 616e 2037 3720 736f 7572 Fortran 77 sour │ │ │ │ │ +000026e0: 6365 730a 2a20 4d69 7869 6e67 2046 6f72 ces.* Mixing For │ │ │ │ │ +000026f0: 7472 616e 2037 3720 5769 7468 2043 2061 tran 77 With C a │ │ │ │ │ +00002700: 6e64 2043 2b2b 3a3a 2020 4d69 7869 6e67 nd C++:: Mixing │ │ │ │ │ +00002710: 2046 6f72 7472 616e 2037 3720 5769 7468 Fortran 77 With │ │ │ │ │ +00002720: 2043 2061 6e64 2043 2b2b 0a0a 4d69 7869 C and C++..Mixi │ │ │ │ │ +00002730: 6e67 2046 6f72 7472 616e 2037 3720 5769 ng Fortran 77 Wi │ │ │ │ │ +00002740: 7468 2043 2061 6e64 2043 2b2b 0a0a 2a20 th C and C++..* │ │ │ │ │ +00002750: 486f 7720 7468 6520 4c69 6e6b 6572 2069 How the Linker i │ │ │ │ │ +00002760: 7320 4368 6f73 656e 3a3a 2020 2020 4175 s Chosen:: Au │ │ │ │ │ +00002770: 746f 6d61 7469 6320 6c69 6e6b 6572 2073 tomatic linker s │ │ │ │ │ +00002780: 656c 6563 7469 6f6e 0a0a 466f 7274 7261 election..Fortra │ │ │ │ │ +00002790: 6e20 3978 2053 7570 706f 7274 0a0a 2a20 n 9x Support..* │ │ │ │ │ +000027a0: 436f 6d70 696c 696e 6720 466f 7274 7261 Compiling Fortra │ │ │ │ │ +000027b0: 6e20 3978 2046 696c 6573 3a3a 2020 436f n 9x Files:: Co │ │ │ │ │ +000027c0: 6d70 696c 696e 6720 466f 7274 7261 6e20 mpiling Fortran │ │ │ │ │ +000027d0: 3978 2073 6f75 7263 6573 0a0a 4f74 6865 9x sources..Othe │ │ │ │ │ +000027e0: 7220 4465 7269 7665 6420 4f62 6a65 6374 r Derived Object │ │ │ │ │ +000027f0: 730a 0a2a 2053 6372 6970 7473 3a3a 2020 s..* Scripts:: │ │ │ │ │ 00002800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002810: 2045 7865 6375 7461 626c 6520 7363 7269 Executable scri │ │ │ │ │ -00002820: 7074 730a 2a20 4865 6164 6572 733a 3a20 pts.* Headers:: │ │ │ │ │ -00002830: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002840: 2020 2020 4865 6164 6572 2066 696c 6573 Header files │ │ │ │ │ -00002850: 0a2a 2044 6174 613a 3a20 2020 2020 2020 .* Data:: │ │ │ │ │ +00002810: 2020 2045 7865 6375 7461 626c 6520 7363 Executable sc │ │ │ │ │ +00002820: 7269 7074 730a 2a20 4865 6164 6572 733a ripts.* Headers: │ │ │ │ │ +00002830: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00002840: 2020 2020 2020 4865 6164 6572 2066 696c Header fil │ │ │ │ │ +00002850: 6573 0a2a 2044 6174 613a 3a20 2020 2020 es.* Data:: │ │ │ │ │ 00002860: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002870: 2041 7263 6869 7465 6374 7572 652d 696e Architecture-in │ │ │ │ │ -00002880: 6465 7065 6e64 656e 7420 6461 7461 2066 dependent data f │ │ │ │ │ -00002890: 696c 6573 0a2a 2053 6f75 7263 6573 3a3a iles.* Sources:: │ │ │ │ │ -000028a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000028b0: 2020 2020 2044 6572 6976 6564 2073 6f75 Derived sou │ │ │ │ │ -000028c0: 7263 6573 0a0a 4275 696c 7420 536f 7572 rces..Built Sour │ │ │ │ │ -000028d0: 6365 730a 0a2a 2042 7569 6c74 2053 6f75 ces..* Built Sou │ │ │ │ │ -000028e0: 7263 6573 2045 7861 6d70 6c65 3a3a 2020 rces Example:: │ │ │ │ │ -000028f0: 2020 2020 2053 6576 6572 616c 2077 6179 Several way │ │ │ │ │ -00002900: 7320 746f 2068 616e 646c 6520 6275 696c s to handle buil │ │ │ │ │ -00002910: 7420 736f 7572 6365 732e 0a0a 4f74 6865 t sources...Othe │ │ │ │ │ -00002920: 7220 474e 5520 546f 6f6c 730a 0a2a 2045 r GNU Tools..* E │ │ │ │ │ -00002930: 6d61 6373 204c 6973 703a 3a20 2020 2020 macs Lisp:: │ │ │ │ │ -00002940: 2020 2020 2020 2020 2020 2020 2045 6d61 Ema │ │ │ │ │ -00002950: 6373 204c 6973 700a 2a20 6765 7474 6578 cs Lisp.* gettex │ │ │ │ │ -00002960: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -00002970: 2020 2020 2020 2020 4765 7474 6578 740a Gettext. │ │ │ │ │ -00002980: 2a20 4c69 6274 6f6f 6c3a 3a20 2020 2020 * Libtool:: │ │ │ │ │ +00002870: 2020 2041 7263 6869 7465 6374 7572 652d Architecture- │ │ │ │ │ +00002880: 696e 6465 7065 6e64 656e 7420 6461 7461 independent data │ │ │ │ │ +00002890: 2066 696c 6573 0a2a 2053 6f75 7263 6573 files.* Sources │ │ │ │ │ +000028a0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000028b0: 2020 2020 2020 2044 6572 6976 6564 2073 Derived s │ │ │ │ │ +000028c0: 6f75 7263 6573 0a0a 4275 696c 7420 536f ources..Built So │ │ │ │ │ +000028d0: 7572 6365 730a 0a2a 2042 7569 6c74 2053 urces..* Built S │ │ │ │ │ +000028e0: 6f75 7263 6573 2045 7861 6d70 6c65 3a3a ources Example:: │ │ │ │ │ +000028f0: 2020 2020 2020 2053 6576 6572 616c 2077 Several w │ │ │ │ │ +00002900: 6179 7320 746f 2068 616e 646c 6520 6275 ays to handle bu │ │ │ │ │ +00002910: 696c 7420 736f 7572 6365 732e 0a0a 4f74 ilt sources...Ot │ │ │ │ │ +00002920: 6865 7220 474e 5520 546f 6f6c 730a 0a2a her GNU Tools..* │ │ │ │ │ +00002930: 2045 6d61 6373 204c 6973 703a 3a20 2020 Emacs Lisp:: │ │ │ │ │ +00002940: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +00002950: 6d61 6373 204c 6973 700a 2a20 6765 7474 macs Lisp.* gett │ │ │ │ │ +00002960: 6578 743a 3a20 2020 2020 2020 2020 2020 ext:: │ │ │ │ │ +00002970: 2020 2020 2020 2020 2020 4765 7474 6578 Gettex │ │ │ │ │ +00002980: 740a 2a20 4c69 6274 6f6f 6c3a 3a20 2020 t.* Libtool:: │ │ │ │ │ 00002990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000029a0: 4c69 6274 6f6f 6c0a 2a20 4a61 7661 3a3a Libtool.* Java:: │ │ │ │ │ -000029b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000029c0: 2020 2020 2020 2020 4a61 7661 2062 7974 Java byt │ │ │ │ │ -000029d0: 6563 6f64 6520 636f 6d70 696c 6174 696f ecode compilatio │ │ │ │ │ -000029e0: 6e20 2864 6570 7265 6361 7465 6429 0a2a n (deprecated).* │ │ │ │ │ -000029f0: 2050 7974 686f 6e3a 3a20 2020 2020 2020 Python:: │ │ │ │ │ -00002a00: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -00002a10: 7974 686f 6e0a 0a42 7569 6c64 696e 6720 ython..Building │ │ │ │ │ -00002a20: 646f 6375 6d65 6e74 6174 696f 6e0a 0a2a documentation..* │ │ │ │ │ -00002a30: 2054 6578 696e 666f 3a3a 2020 2020 2020 Texinfo:: │ │ │ │ │ -00002a40: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -00002a50: 6578 696e 666f 0a2a 204d 616e 2050 6167 exinfo.* Man Pag │ │ │ │ │ -00002a60: 6573 3a3a 2020 2020 2020 2020 2020 2020 es:: │ │ │ │ │ -00002a70: 2020 2020 2020 204d 616e 2070 6167 6573 Man pages │ │ │ │ │ -00002a80: 0a0a 5768 6174 2047 6574 7320 496e 7374 ..What Gets Inst │ │ │ │ │ -00002a90: 616c 6c65 640a 0a2a 2042 6173 6963 7320 alled..* Basics │ │ │ │ │ -00002aa0: 6f66 2049 6e73 7461 6c6c 6174 696f 6e3a of Installation: │ │ │ │ │ -00002ab0: 3a20 2020 2020 2057 6861 7420 6765 7473 : What gets │ │ │ │ │ -00002ac0: 2069 6e73 7461 6c6c 6564 2077 6865 7265 installed where │ │ │ │ │ -00002ad0: 0a2a 2054 6865 2054 776f 2050 6172 7473 .* The Two Parts │ │ │ │ │ -00002ae0: 206f 6620 496e 7374 616c 6c3a 3a20 2020 of Install:: │ │ │ │ │ -00002af0: 2049 6e73 7461 6c6c 696e 6720 6461 7461 Installing data │ │ │ │ │ -00002b00: 2061 6e64 2070 726f 6772 616d 7320 7365 and programs se │ │ │ │ │ -00002b10: 7061 7261 7465 6c79 0a2a 2045 7874 656e parately.* Exten │ │ │ │ │ -00002b20: 6469 6e67 2049 6e73 7461 6c6c 6174 696f ding Installatio │ │ │ │ │ -00002b30: 6e3a 3a20 2020 2020 2041 6464 696e 6720 n:: Adding │ │ │ │ │ -00002b40: 796f 7572 206f 776e 2072 756c 6573 2066 your own rules f │ │ │ │ │ -00002b50: 6f72 2069 6e73 7461 6c6c 6174 696f 6e0a or installation. │ │ │ │ │ -00002b60: 2a20 5374 6167 6564 2049 6e73 7461 6c6c * Staged Install │ │ │ │ │ -00002b70: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ -00002b80: 496e 7374 616c 6c61 7469 6f6e 2069 6e20 Installation in │ │ │ │ │ -00002b90: 6120 7465 6d70 6f72 6172 7920 6c6f 6361 a temporary loca │ │ │ │ │ -00002ba0: 7469 6f6e 0a2a 2049 6e73 7461 6c6c 2052 tion.* Install R │ │ │ │ │ -00002bb0: 756c 6573 2066 6f72 2074 6865 2055 7365 ules for the Use │ │ │ │ │ -00002bc0: 723a 3a20 2055 7365 6675 6c20 6164 6469 r:: Useful addi │ │ │ │ │ -00002bd0: 7469 6f6e 616c 2072 756c 6573 0a0a 5768 tional rules..Wh │ │ │ │ │ -00002be0: 6174 2047 6f65 7320 696e 2061 2044 6973 at Goes in a Dis │ │ │ │ │ -00002bf0: 7472 6962 7574 696f 6e0a 0a2a 2042 6173 tribution..* Bas │ │ │ │ │ -00002c00: 6963 7320 6f66 2044 6973 7472 6962 7574 ics of Distribut │ │ │ │ │ -00002c10: 696f 6e3a 3a20 2020 2020 2046 696c 6573 ion:: Files │ │ │ │ │ -00002c20: 2064 6973 7472 6962 7574 6564 2062 7920 distributed by │ │ │ │ │ -00002c30: 6465 6661 756c 740a 2a20 4669 6e65 2d67 default.* Fine-g │ │ │ │ │ -00002c40: 7261 696e 6564 2044 6973 7472 6962 7574 rained Distribut │ │ │ │ │ -00002c50: 696f 6e20 436f 6e74 726f 6c3a 3a20 2027 ion Control:: ' │ │ │ │ │ -00002c60: 6469 7374 5f27 2061 6e64 2027 6e6f 6469 dist_' and 'nodi │ │ │ │ │ -00002c70: 7374 5f27 2070 7265 6669 7865 730a 2a20 st_' prefixes.* │ │ │ │ │ -00002c80: 5468 6520 6469 7374 2048 6f6f 6b3a 3a20 The dist Hook:: │ │ │ │ │ -00002c90: 2020 2020 2020 2020 2020 2020 2020 4120 A │ │ │ │ │ -00002ca0: 7461 7267 6574 2066 6f72 206c 6173 742d target for last- │ │ │ │ │ -00002cb0: 6d69 6e75 7465 2064 6973 7472 6962 7574 minute distribut │ │ │ │ │ -00002cc0: 696f 6e20 6368 616e 6765 730a 2a20 4368 ion changes.* Ch │ │ │ │ │ -00002cd0: 6563 6b69 6e67 2074 6865 2044 6973 7472 ecking the Distr │ │ │ │ │ -00002ce0: 6962 7574 696f 6e3a 3a20 2020 276d 616b ibution:: 'mak │ │ │ │ │ -00002cf0: 6520 6469 7374 6368 6563 6b27 2065 7870 e distcheck' exp │ │ │ │ │ -00002d00: 6c61 696e 6564 0a2a 2054 6865 2054 7970 lained.* The Typ │ │ │ │ │ -00002d10: 6573 206f 6620 4469 7374 7269 6275 7469 es of Distributi │ │ │ │ │ -00002d20: 6f6e 733a 3a20 2041 2076 6172 6965 7479 ons:: A variety │ │ │ │ │ -00002d30: 206f 6620 666f 726d 6174 7320 616e 6420 of formats and │ │ │ │ │ -00002d40: 636f 6d70 7265 7373 696f 6e20 6d65 7468 compression meth │ │ │ │ │ -00002d50: 6f64 730a 0a53 7570 706f 7274 2066 6f72 ods..Support for │ │ │ │ │ -00002d60: 2074 6573 7420 7375 6974 6573 0a0a 2a20 test suites..* │ │ │ │ │ -00002d70: 5369 6d70 6c65 2054 6573 7473 3a3a 2020 Simple Tests:: │ │ │ │ │ -00002d80: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ │ -00002d90: 7374 696e 6720 7072 6f67 7261 6d73 2061 sting programs a │ │ │ │ │ -00002da0: 6e64 2073 6372 6970 7473 2069 6e20 2754 nd scripts in 'T │ │ │ │ │ -00002db0: 4553 5453 270a 2a20 5369 6d70 6c65 2054 ESTS'.* Simple T │ │ │ │ │ -00002dc0: 6573 7473 2075 7369 6e67 2070 6172 616c ests using paral │ │ │ │ │ -00002dd0: 6c65 6c2d 7465 7374 733a 3a20 204d 6f72 lel-tests:: Mor │ │ │ │ │ -00002de0: 6520 706f 7765 7266 756c 2074 6573 7420 e powerful test │ │ │ │ │ -00002df0: 6472 6976 6572 0a2a 2044 656a 6147 6e75 driver.* DejaGnu │ │ │ │ │ -00002e00: 2054 6573 7473 3a3a 2020 2020 2020 2020 Tests:: │ │ │ │ │ -00002e10: 2020 2020 2020 2049 6e74 6572 6661 6369 Interfaci │ │ │ │ │ -00002e20: 6e67 2077 6974 6820 7468 6520 6578 7465 ng with the exte │ │ │ │ │ -00002e30: 726e 616c 2074 6573 7469 6e67 2066 7261 rnal testing fra │ │ │ │ │ -00002e40: 6d65 776f 726b 0a2a 2049 6e73 7461 6c6c mework.* Install │ │ │ │ │ -00002e50: 2054 6573 7473 3a3a 2020 2020 2020 2020 Tests:: │ │ │ │ │ -00002e60: 2020 2020 2020 2052 756e 6e69 6e67 2074 Running t │ │ │ │ │ -00002e70: 6573 7473 206f 6e20 696e 7374 616c 6c65 ests on installe │ │ │ │ │ -00002e80: 6420 7061 636b 6167 6573 0a0a 4d69 7363 d packages..Misc │ │ │ │ │ -00002e90: 656c 6c61 6e65 6f75 7320 5275 6c65 730a ellaneous Rules. │ │ │ │ │ -00002ea0: 0a2a 2054 6167 733a 3a20 2020 2020 2020 .* Tags:: │ │ │ │ │ +000029a0: 2020 4c69 6274 6f6f 6c0a 2a20 4a61 7661 Libtool.* Java │ │ │ │ │ +000029b0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000029c0: 2020 2020 2020 2020 2020 4a61 7661 2062 Java b │ │ │ │ │ +000029d0: 7974 6563 6f64 6520 636f 6d70 696c 6174 ytecode compilat │ │ │ │ │ +000029e0: 696f 6e20 2864 6570 7265 6361 7465 6429 ion (deprecated) │ │ │ │ │ +000029f0: 0a2a 2050 7974 686f 6e3a 3a20 2020 2020 .* Python:: │ │ │ │ │ +00002a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00002a10: 2050 7974 686f 6e0a 0a42 7569 6c64 696e Python..Buildin │ │ │ │ │ +00002a20: 6720 646f 6375 6d65 6e74 6174 696f 6e0a g documentation. │ │ │ │ │ +00002a30: 0a2a 2054 6578 696e 666f 3a3a 2020 2020 .* Texinfo:: │ │ │ │ │ +00002a40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00002a50: 2054 6578 696e 666f 0a2a 204d 616e 2050 Texinfo.* Man P │ │ │ │ │ +00002a60: 6167 6573 3a3a 2020 2020 2020 2020 2020 ages:: │ │ │ │ │ +00002a70: 2020 2020 2020 2020 204d 616e 2070 6167 Man pag │ │ │ │ │ +00002a80: 6573 0a0a 5768 6174 2047 6574 7320 496e es..What Gets In │ │ │ │ │ +00002a90: 7374 616c 6c65 640a 0a2a 2042 6173 6963 stalled..* Basic │ │ │ │ │ +00002aa0: 7320 6f66 2049 6e73 7461 6c6c 6174 696f s of Installatio │ │ │ │ │ +00002ab0: 6e3a 3a20 2020 2020 2057 6861 7420 6765 n:: What ge │ │ │ │ │ +00002ac0: 7473 2069 6e73 7461 6c6c 6564 2077 6865 ts installed whe │ │ │ │ │ +00002ad0: 7265 0a2a 2054 6865 2054 776f 2050 6172 re.* The Two Par │ │ │ │ │ +00002ae0: 7473 206f 6620 496e 7374 616c 6c3a 3a20 ts of Install:: │ │ │ │ │ +00002af0: 2020 2049 6e73 7461 6c6c 696e 6720 6461 Installing da │ │ │ │ │ +00002b00: 7461 2061 6e64 2070 726f 6772 616d 7320 ta and programs │ │ │ │ │ +00002b10: 7365 7061 7261 7465 6c79 0a2a 2045 7874 separately.* Ext │ │ │ │ │ +00002b20: 656e 6469 6e67 2049 6e73 7461 6c6c 6174 ending Installat │ │ │ │ │ +00002b30: 696f 6e3a 3a20 2020 2020 2041 6464 696e ion:: Addin │ │ │ │ │ +00002b40: 6720 796f 7572 206f 776e 2072 756c 6573 g your own rules │ │ │ │ │ +00002b50: 2066 6f72 2069 6e73 7461 6c6c 6174 696f for installatio │ │ │ │ │ +00002b60: 6e0a 2a20 5374 6167 6564 2049 6e73 7461 n.* Staged Insta │ │ │ │ │ +00002b70: 6c6c 733a 3a20 2020 2020 2020 2020 2020 lls:: │ │ │ │ │ +00002b80: 2020 496e 7374 616c 6c61 7469 6f6e 2069 Installation i │ │ │ │ │ +00002b90: 6e20 6120 7465 6d70 6f72 6172 7920 6c6f n a temporary lo │ │ │ │ │ +00002ba0: 6361 7469 6f6e 0a2a 2049 6e73 7461 6c6c cation.* Install │ │ │ │ │ +00002bb0: 2052 756c 6573 2066 6f72 2074 6865 2055 Rules for the U │ │ │ │ │ +00002bc0: 7365 723a 3a20 2055 7365 6675 6c20 6164 ser:: Useful ad │ │ │ │ │ +00002bd0: 6469 7469 6f6e 616c 2072 756c 6573 0a0a ditional rules.. │ │ │ │ │ +00002be0: 5768 6174 2047 6f65 7320 696e 2061 2044 What Goes in a D │ │ │ │ │ +00002bf0: 6973 7472 6962 7574 696f 6e0a 0a2a 2042 istribution..* B │ │ │ │ │ +00002c00: 6173 6963 7320 6f66 2044 6973 7472 6962 asics of Distrib │ │ │ │ │ +00002c10: 7574 696f 6e3a 3a20 2020 2020 2046 696c ution:: Fil │ │ │ │ │ +00002c20: 6573 2064 6973 7472 6962 7574 6564 2062 es distributed b │ │ │ │ │ +00002c30: 7920 6465 6661 756c 740a 2a20 4669 6e65 y default.* Fine │ │ │ │ │ +00002c40: 2d67 7261 696e 6564 2044 6973 7472 6962 -grained Distrib │ │ │ │ │ +00002c50: 7574 696f 6e20 436f 6e74 726f 6c3a 3a20 ution Control:: │ │ │ │ │ +00002c60: 2027 6469 7374 5f27 2061 6e64 2027 6e6f 'dist_' and 'no │ │ │ │ │ +00002c70: 6469 7374 5f27 2070 7265 6669 7865 730a dist_' prefixes. │ │ │ │ │ +00002c80: 2a20 5468 6520 6469 7374 2048 6f6f 6b3a * The dist Hook: │ │ │ │ │ +00002c90: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00002ca0: 4120 7461 7267 6574 2066 6f72 206c 6173 A target for las │ │ │ │ │ +00002cb0: 742d 6d69 6e75 7465 2064 6973 7472 6962 t-minute distrib │ │ │ │ │ +00002cc0: 7574 696f 6e20 6368 616e 6765 730a 2a20 ution changes.* │ │ │ │ │ +00002cd0: 4368 6563 6b69 6e67 2074 6865 2044 6973 Checking the Dis │ │ │ │ │ +00002ce0: 7472 6962 7574 696f 6e3a 3a20 2020 276d tribution:: 'm │ │ │ │ │ +00002cf0: 616b 6520 6469 7374 6368 6563 6b27 2065 ake distcheck' e │ │ │ │ │ +00002d00: 7870 6c61 696e 6564 0a2a 2054 6865 2054 xplained.* The T │ │ │ │ │ +00002d10: 7970 6573 206f 6620 4469 7374 7269 6275 ypes of Distribu │ │ │ │ │ +00002d20: 7469 6f6e 733a 3a20 2041 2076 6172 6965 tions:: A varie │ │ │ │ │ +00002d30: 7479 206f 6620 666f 726d 6174 7320 616e ty of formats an │ │ │ │ │ +00002d40: 6420 636f 6d70 7265 7373 696f 6e20 6d65 d compression me │ │ │ │ │ +00002d50: 7468 6f64 730a 0a53 7570 706f 7274 2066 thods..Support f │ │ │ │ │ +00002d60: 6f72 2074 6573 7420 7375 6974 6573 0a0a or test suites.. │ │ │ │ │ +00002d70: 2a20 5369 6d70 6c65 2054 6573 7473 3a3a * Simple Tests:: │ │ │ │ │ +00002d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00002d90: 4c69 7374 696e 6720 7072 6f67 7261 6d73 Listing programs │ │ │ │ │ +00002da0: 2061 6e64 2073 6372 6970 7473 2069 6e20 and scripts in │ │ │ │ │ +00002db0: 2754 4553 5453 270a 2a20 5369 6d70 6c65 'TESTS'.* Simple │ │ │ │ │ +00002dc0: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ +00002dd0: 616c 6c65 6c2d 7465 7374 733a 3a20 204d allel-tests:: M │ │ │ │ │ +00002de0: 6f72 6520 706f 7765 7266 756c 2074 6573 ore powerful tes │ │ │ │ │ +00002df0: 7420 6472 6976 6572 0a2a 2044 656a 6147 t driver.* DejaG │ │ │ │ │ +00002e00: 6e75 2054 6573 7473 3a3a 2020 2020 2020 nu Tests:: │ │ │ │ │ +00002e10: 2020 2020 2020 2020 2049 6e74 6572 6661 Interfa │ │ │ │ │ +00002e20: 6369 6e67 2077 6974 6820 7468 6520 6578 cing with the ex │ │ │ │ │ +00002e30: 7465 726e 616c 2074 6573 7469 6e67 2066 ternal testing f │ │ │ │ │ +00002e40: 7261 6d65 776f 726b 0a2a 2049 6e73 7461 ramework.* Insta │ │ │ │ │ +00002e50: 6c6c 2054 6573 7473 3a3a 2020 2020 2020 ll Tests:: │ │ │ │ │ +00002e60: 2020 2020 2020 2020 2052 756e 6e69 6e67 Running │ │ │ │ │ +00002e70: 2074 6573 7473 206f 6e20 696e 7374 616c tests on instal │ │ │ │ │ +00002e80: 6c65 6420 7061 636b 6167 6573 0a0a 4d69 led packages..Mi │ │ │ │ │ +00002e90: 7363 656c 6c61 6e65 6f75 7320 5275 6c65 scellaneous Rule │ │ │ │ │ +00002ea0: 730a 0a2a 2054 6167 733a 3a20 2020 2020 s..* Tags:: │ │ │ │ │ 00002eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002ec0: 2049 6e74 6572 6661 6369 6e67 2074 6f20 Interfacing to │ │ │ │ │ -00002ed0: 6574 6167 7320 616e 6420 6d6b 6964 0a2a etags and mkid.* │ │ │ │ │ -00002ee0: 2053 7566 6669 7865 733a 3a20 2020 2020 Suffixes:: │ │ │ │ │ -00002ef0: 2020 2020 2020 2020 2020 2020 2020 2048 H │ │ │ │ │ -00002f00: 616e 646c 696e 6720 6e65 7720 6669 6c65 andling new file │ │ │ │ │ -00002f10: 2065 7874 656e 7369 6f6e 730a 2a20 4d75 extensions.* Mu │ │ │ │ │ -00002f20: 6c74 696c 6962 733a 3a20 2020 2020 2020 ltilibs:: │ │ │ │ │ -00002f30: 2020 2020 2020 2020 2020 2020 5375 7070 Supp │ │ │ │ │ -00002f40: 6f72 7420 666f 7220 6d75 6c74 696c 6962 ort for multilib │ │ │ │ │ -00002f50: 7320 2864 6570 7265 6361 7465 642c 2073 s (deprecated, s │ │ │ │ │ -00002f60: 6f6f 6e20 746f 2062 6520 7265 6d6f 7665 oon to be remove │ │ │ │ │ -00002f70: 6429 2e0a 0a43 6f6e 6469 7469 6f6e 616c d)...Conditional │ │ │ │ │ -00002f80: 730a 0a2a 2055 7361 6765 206f 6620 436f s..* Usage of Co │ │ │ │ │ -00002f90: 6e64 6974 696f 6e61 6c73 3a3a 2020 2020 nditionals:: │ │ │ │ │ -00002fa0: 2020 2044 6563 6c61 7269 6e67 2063 6f6e Declaring con │ │ │ │ │ -00002fb0: 6469 7469 6f6e 616c 2063 6f6e 7465 6e74 ditional content │ │ │ │ │ -00002fc0: 0a2a 204c 696d 6974 7320 6f66 2043 6f6e .* Limits of Con │ │ │ │ │ -00002fd0: 6469 7469 6f6e 616c 733a 3a20 2020 2020 ditionals:: │ │ │ │ │ -00002fe0: 2045 6e63 6c6f 7369 6e67 2063 6f6d 706c Enclosing compl │ │ │ │ │ -00002ff0: 6574 6520 7374 6174 656d 656e 7473 0a0a ete statements.. │ │ │ │ │ -00003000: 5369 6c65 6e63 696e 6720 4d61 6b65 0a0a Silencing Make.. │ │ │ │ │ -00003010: 2a20 4d61 6b65 2076 6572 626f 7369 7479 * Make verbosity │ │ │ │ │ -00003020: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00003030: 204d 616b 6520 6973 2076 6572 626f 7365 Make is verbose │ │ │ │ │ -00003040: 2062 7920 6465 6661 756c 740a 2a20 5472 by default.* Tr │ │ │ │ │ -00003050: 6963 6b73 2046 6f72 2053 696c 656e 6369 icks For Silenci │ │ │ │ │ -00003060: 6e67 204d 616b 653a 3a20 2020 2053 7461 ng Make:: Sta │ │ │ │ │ -00003070: 6e64 6172 6420 616e 6420 6765 6e65 7269 ndard and generi │ │ │ │ │ -00003080: 6320 7761 7973 2074 6f20 7369 6c65 6e63 c ways to silenc │ │ │ │ │ -00003090: 6520 6d61 6b65 0a2a 2041 7574 6f6d 616b e make.* Automak │ │ │ │ │ -000030a0: 6520 7369 6c65 6e74 2d72 756c 6573 204f e silent-rules O │ │ │ │ │ -000030b0: 7074 696f 6e3a 3a20 486f 7720 4175 746f ption:: How Auto │ │ │ │ │ -000030c0: 6d61 6b65 2063 616e 2068 656c 7020 696e make can help in │ │ │ │ │ -000030d0: 2073 696c 656e 6369 6e67 206d 616b 650a silencing make. │ │ │ │ │ -000030e0: 0a57 6865 6e20 4175 746f 6d61 6b65 2049 .When Automake I │ │ │ │ │ -000030f0: 736e 2774 2045 6e6f 7567 680a 0a2a 2045 sn't Enough..* E │ │ │ │ │ -00003100: 7874 656e 6469 6e67 3a3a 2020 2020 2020 xtending:: │ │ │ │ │ -00003110: 2020 2020 2020 2020 2020 2020 2041 6464 Add │ │ │ │ │ -00003120: 696e 6720 6e65 7720 7275 6c65 7320 6f72 ing new rules or │ │ │ │ │ -00003130: 206f 7665 7272 6964 696e 6720 6578 6973 overriding exis │ │ │ │ │ -00003140: 7469 6e67 206f 6e65 732e 0a2a 2054 6869 ting ones..* Thi │ │ │ │ │ -00003150: 7264 2d50 6172 7479 204d 616b 6566 696c rd-Party Makefil │ │ │ │ │ -00003160: 6573 3a3a 2020 2020 2020 2049 6e74 6567 es:: Integ │ │ │ │ │ -00003170: 7261 7469 6e67 204e 6f6e 2d41 7574 6f6d rating Non-Autom │ │ │ │ │ -00003180: 616b 6520 274d 616b 6566 696c 6527 732e ake 'Makefile's. │ │ │ │ │ -00003190: 0a0a 4672 6571 7565 6e74 6c79 2041 736b ..Frequently Ask │ │ │ │ │ -000031a0: 6564 2051 7565 7374 696f 6e73 2061 626f ed Questions abo │ │ │ │ │ -000031b0: 7574 2041 7574 6f6d 616b 650a 0a2a 2043 ut Automake..* C │ │ │ │ │ -000031c0: 5653 3a3a 2020 2020 2020 2020 2020 2020 VS:: │ │ │ │ │ -000031d0: 2020 2020 2020 2020 2020 2020 2043 5653 CVS │ │ │ │ │ -000031e0: 2061 6e64 2067 656e 6572 6174 6564 2066 and generated f │ │ │ │ │ -000031f0: 696c 6573 0a2a 206d 6169 6e74 6169 6e65 iles.* maintaine │ │ │ │ │ -00003200: 722d 6d6f 6465 3a3a 2020 2020 2020 2020 r-mode:: │ │ │ │ │ -00003210: 2020 2020 206d 6973 7369 6e67 2061 6e64 missing and │ │ │ │ │ -00003220: 2041 4d5f 4d41 494e 5441 494e 4552 5f4d AM_MAINTAINER_M │ │ │ │ │ -00003230: 4f44 450a 2a20 5769 6c64 6361 7264 733a ODE.* Wildcards: │ │ │ │ │ -00003240: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00003250: 2020 2020 5768 7920 646f 6573 6e27 7420 Why doesn't │ │ │ │ │ -00003260: 4175 746f 6d61 6b65 2073 7570 706f 7274 Automake support │ │ │ │ │ -00003270: 2077 696c 6463 6172 6473 3f0a 2a20 4c69 wildcards?.* Li │ │ │ │ │ -00003280: 6d69 7461 7469 6f6e 7320 6f6e 2046 696c mitations on Fil │ │ │ │ │ -00003290: 6520 4e61 6d65 733a 3a20 2020 4c69 6d69 e Names:: Limi │ │ │ │ │ -000032a0: 7461 7469 6f6e 7320 6f6e 2073 6f75 7263 tations on sourc │ │ │ │ │ -000032b0: 6520 616e 6420 696e 7374 616c 6c65 6420 e and installed │ │ │ │ │ -000032c0: 6669 6c65 206e 616d 6573 0a2a 2064 6973 file names.* dis │ │ │ │ │ -000032d0: 7463 6c65 616e 6368 6563 6b3a 3a20 2020 tcleancheck:: │ │ │ │ │ -000032e0: 2020 2020 2020 2020 2020 2046 696c 6573 Files │ │ │ │ │ -000032f0: 206c 6566 7420 696e 2062 7569 6c64 2064 left in build d │ │ │ │ │ -00003300: 6972 6563 746f 7279 2061 6674 6572 2064 irectory after d │ │ │ │ │ -00003310: 6973 7463 6c65 616e 0a2a 2046 6c61 6720 istclean.* Flag │ │ │ │ │ -00003320: 5661 7269 6162 6c65 7320 4f72 6465 7269 Variables Orderi │ │ │ │ │ -00003330: 6e67 3a3a 2020 2020 2043 464c 4147 5320 ng:: CFLAGS │ │ │ │ │ -00003340: 7673 2e20 414d 5f43 464c 4147 5320 7673 vs. AM_CFLAGS vs │ │ │ │ │ -00003350: 2e20 6d75 6d62 6c65 5f43 464c 4147 530a . mumble_CFLAGS. │ │ │ │ │ -00003360: 2a20 5265 6e61 6d65 6420 4f62 6a65 6374 * Renamed Object │ │ │ │ │ -00003370: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ -00003380: 5768 7920 6172 6520 6f62 6a65 6374 2066 Why are object f │ │ │ │ │ -00003390: 696c 6573 2073 6f6d 6574 696d 6573 2072 iles sometimes r │ │ │ │ │ -000033a0: 656e 616d 6564 3f0a 2a20 5065 722d 4f62 enamed?.* Per-Ob │ │ │ │ │ -000033b0: 6a65 6374 2046 6c61 6773 3a3a 2020 2020 ject Flags:: │ │ │ │ │ -000033c0: 2020 2020 2020 2020 486f 7720 746f 2073 How to s │ │ │ │ │ -000033d0: 696d 756c 6174 6520 7065 722d 6f62 6a65 imulate per-obje │ │ │ │ │ -000033e0: 6374 2066 6c61 6773 3f0a 2a20 4d75 6c74 ct flags?.* Mult │ │ │ │ │ -000033f0: 6970 6c65 204f 7574 7075 7473 3a3a 2020 iple Outputs:: │ │ │ │ │ -00003400: 2020 2020 2020 2020 2020 5772 6974 696e Writin │ │ │ │ │ -00003410: 6720 7275 6c65 7320 666f 7220 746f 6f6c g rules for tool │ │ │ │ │ -00003420: 7320 7769 7468 206d 616e 7920 6f75 7470 s with many outp │ │ │ │ │ -00003430: 7574 2066 696c 6573 0a2a 2048 6172 642d ut files.* Hard- │ │ │ │ │ -00003440: 436f 6465 6420 496e 7374 616c 6c20 5061 Coded Install Pa │ │ │ │ │ -00003450: 7468 733a 3a20 2020 2049 6e73 7461 6c6c ths:: Install │ │ │ │ │ -00003460: 696e 6720 746f 2068 6172 642d 636f 6465 ing to hard-code │ │ │ │ │ -00003470: 6420 6c6f 6361 7469 6f6e 730a 2a20 4465 d locations.* De │ │ │ │ │ -00003480: 6275 6767 696e 6720 4d61 6b65 2052 756c bugging Make Rul │ │ │ │ │ -00003490: 6573 3a3a 2020 2020 2020 2020 5374 7261 es:: Stra │ │ │ │ │ -000034a0: 7465 6769 6573 2077 6865 6e20 7468 696e tegies when thin │ │ │ │ │ -000034b0: 6773 2064 6f6e 2774 2077 6f72 6b20 6173 gs don't work as │ │ │ │ │ -000034c0: 2065 7870 6563 7465 640a 2a20 5265 706f expected.* Repo │ │ │ │ │ -000034d0: 7274 696e 6720 4275 6773 3a3a 2020 2020 rting Bugs:: │ │ │ │ │ -000034e0: 2020 2020 2020 2020 2020 4665 6564 6261 Feedba │ │ │ │ │ -000034f0: 636b 206f 6e20 6275 6773 2061 6e64 2066 ck on bugs and f │ │ │ │ │ -00003500: 6561 7475 7265 2072 6571 7565 7374 730a eature requests. │ │ │ │ │ -00003510: 0a48 6973 746f 7279 206f 6620 4175 746f .History of Auto │ │ │ │ │ -00003520: 6d61 6b65 0a0a 2a20 5469 6d65 6c69 6e65 make..* Timeline │ │ │ │ │ -00003530: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00003540: 2020 2020 2020 5468 6520 4175 746f 6d61 The Automa │ │ │ │ │ -00003550: 6b65 2073 746f 7279 2e0a 2a20 4465 7065 ke story..* Depe │ │ │ │ │ -00003560: 6e64 656e 6379 2054 7261 636b 696e 6720 ndency Tracking │ │ │ │ │ -00003570: 4576 6f6c 7574 696f 6e3a 3a20 2045 766f Evolution:: Evo │ │ │ │ │ -00003580: 6c75 7469 6f6e 206f 6620 4175 746f 6d61 lution of Automa │ │ │ │ │ -00003590: 7469 6320 4465 7065 6e64 656e 6379 2054 tic Dependency T │ │ │ │ │ -000035a0: 7261 636b 696e 670a 2a20 5265 6c65 6173 racking.* Releas │ │ │ │ │ -000035b0: 6573 3a3a 2020 2020 2020 2020 2020 2020 es:: │ │ │ │ │ -000035c0: 2020 2020 2020 2020 5374 6174 6973 7469 Statisti │ │ │ │ │ -000035d0: 6373 2061 626f 7574 2041 7574 6f6d 616b cs about Automak │ │ │ │ │ -000035e0: 6520 5265 6c65 6173 6573 0a0a 4465 7065 e Releases..Depe │ │ │ │ │ -000035f0: 6e64 656e 6379 2054 7261 636b 696e 6720 ndency Tracking │ │ │ │ │ -00003600: 696e 2041 7574 6f6d 616b 650a 0a2a 2046 in Automake..* F │ │ │ │ │ -00003610: 6972 7374 2054 616b 6520 6f6e 2044 6570 irst Take on Dep │ │ │ │ │ -00003620: 656e 6465 6e63 6965 733a 3a20 2050 7265 endencies:: Pre │ │ │ │ │ -00003630: 636f 6d70 7574 6564 2064 6570 656e 6465 computed depende │ │ │ │ │ -00003640: 6e63 7920 7472 6163 6b69 6e67 0a2a 2044 ncy tracking.* D │ │ │ │ │ -00003650: 6570 656e 6465 6e63 6965 7320 4173 2053 ependencies As S │ │ │ │ │ -00003660: 6964 6520 4566 6665 6374 733a 3a20 2055 ide Effects:: U │ │ │ │ │ -00003670: 7064 6174 6520 6174 2064 6576 656c 6f70 pdate at develop │ │ │ │ │ -00003680: 6572 2063 6f6d 7069 6c65 2074 696d 650a er compile time. │ │ │ │ │ -00003690: 2a20 4465 7065 6e64 656e 6369 6573 2066 * Dependencies f │ │ │ │ │ -000036a0: 6f72 2074 6865 2055 7365 723a 3a20 2020 or the User:: │ │ │ │ │ -000036b0: 5570 6461 7465 2061 7420 7573 6572 2063 Update at user c │ │ │ │ │ -000036c0: 6f6d 7069 6c65 2074 696d 650a 2a20 5465 ompile time.* Te │ │ │ │ │ -000036d0: 6368 6e69 7175 6573 2066 6f72 2044 6570 chniques for Dep │ │ │ │ │ -000036e0: 656e 6465 6e63 6965 733a 3a20 2041 6c74 endencies:: Alt │ │ │ │ │ -000036f0: 6572 6e61 7469 7665 2061 7070 726f 6163 ernative approac │ │ │ │ │ -00003700: 6865 730a 2a20 5265 636f 6d6d 656e 6461 hes.* Recommenda │ │ │ │ │ -00003710: 7469 6f6e 7320 666f 7220 546f 6f6c 2057 tions for Tool W │ │ │ │ │ -00003720: 7269 7465 7273 3a3a 2020 5768 6174 2074 riters:: What t │ │ │ │ │ -00003730: 6f6f 6c20 7772 6974 6572 7320 6361 6e20 ool writers can │ │ │ │ │ -00003740: 646f 2074 6f20 6865 6c70 0a2a 2046 7574 do to help.* Fut │ │ │ │ │ -00003750: 7572 6520 4469 7265 6374 696f 6e73 2066 ure Directions f │ │ │ │ │ -00003760: 6f72 2044 6570 656e 6465 6e63 6965 733a or Dependencies: │ │ │ │ │ -00003770: 3a20 204c 616e 6775 6167 6573 2041 7574 : Languages Aut │ │ │ │ │ -00003780: 6f6d 616b 6520 646f 6573 206e 6f74 206b omake does not k │ │ │ │ │ -00003790: 6e6f 770a 0a43 6f70 7969 6e67 2054 6869 now..Copying Thi │ │ │ │ │ -000037a0: 7320 4d61 6e75 616c 0a0a 2a20 474e 5520 s Manual..* GNU │ │ │ │ │ -000037b0: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ -000037c0: 6f6e 204c 6963 656e 7365 3a3a 2020 4c69 on License:: Li │ │ │ │ │ -000037d0: 6365 6e73 6520 666f 7220 636f 7079 696e cense for copyin │ │ │ │ │ -000037e0: 6720 7468 6973 206d 616e 7561 6c0a 0a49 g this manual..I │ │ │ │ │ -000037f0: 6e64 6963 6573 0a0a 2a20 4d61 6372 6f20 ndices..* Macro │ │ │ │ │ -00003800: 496e 6465 783a 3a20 2020 2020 2020 2020 Index:: │ │ │ │ │ -00003810: 2020 2020 2020 2020 496e 6465 7820 6f66 Index of │ │ │ │ │ -00003820: 2041 7574 6f63 6f6e 6620 6d61 6372 6f73 Autoconf macros │ │ │ │ │ -00003830: 0a2a 2056 6172 6961 626c 6520 496e 6465 .* Variable Inde │ │ │ │ │ -00003840: 783a 3a20 2020 2020 2020 2020 2020 2020 x:: │ │ │ │ │ -00003850: 2049 6e64 6578 206f 6620 4d61 6b65 6669 Index of Makefi │ │ │ │ │ -00003860: 6c65 2076 6172 6961 626c 6573 0a2a 2047 le variables.* G │ │ │ │ │ -00003870: 656e 6572 616c 2049 6e64 6578 3a3a 2020 eneral Index:: │ │ │ │ │ -00003880: 2020 2020 2020 2020 2020 2020 2047 656e Gen │ │ │ │ │ -00003890: 6572 616c 2069 6e64 6578 0a0a 0a1f 0a46 eral index.....F │ │ │ │ │ -000038a0: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -000038b0: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -000038c0: 496e 7472 6f64 7563 7469 6f6e 2c20 204e Introduction, N │ │ │ │ │ -000038d0: 6578 743a 2041 7574 6f74 6f6f 6c73 2049 ext: Autotools I │ │ │ │ │ -000038e0: 6e74 726f 6475 6374 696f 6e2c 2020 5072 ntroduction, Pr │ │ │ │ │ -000038f0: 6576 3a20 546f 702c 2020 5570 3a20 546f ev: Top, Up: To │ │ │ │ │ -00003900: 700a 0a31 2049 6e74 726f 6475 6374 696f p..1 Introductio │ │ │ │ │ -00003910: 6e0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a n.************** │ │ │ │ │ -00003920: 0a0a 4175 746f 6d61 6b65 2069 7320 6120 ..Automake is a │ │ │ │ │ -00003930: 746f 6f6c 2066 6f72 2061 7574 6f6d 6174 tool for automat │ │ │ │ │ -00003940: 6963 616c 6c79 2067 656e 6572 6174 696e ically generatin │ │ │ │ │ -00003950: 6720 274d 616b 6566 696c 652e 696e 2773 g 'Makefile.in's │ │ │ │ │ -00003960: 2066 726f 6d0a 6669 6c65 7320 6361 6c6c from.files call │ │ │ │ │ -00003970: 6564 2027 4d61 6b65 6669 6c65 2e61 6d27 ed 'Makefile.am' │ │ │ │ │ -00003980: 2e20 2045 6163 6820 274d 616b 6566 696c . Each 'Makefil │ │ │ │ │ -00003990: 652e 616d 2720 6973 2062 6173 6963 616c e.am' is basical │ │ │ │ │ -000039a0: 6c79 2061 2073 6572 6965 7320 6f66 0a27 ly a series of.' │ │ │ │ │ -000039b0: 6d61 6b65 2720 7661 7269 6162 6c65 2064 make' variable d │ │ │ │ │ -000039c0: 6566 696e 6974 696f 6e73 2831 292c 2077 efinitions(1), w │ │ │ │ │ -000039d0: 6974 6820 7275 6c65 7320 6265 696e 6720 ith rules being │ │ │ │ │ -000039e0: 7468 726f 776e 2069 6e20 6f63 6361 7369 thrown in occasi │ │ │ │ │ -000039f0: 6f6e 616c 6c79 2e0a 5468 6520 6765 6e65 onally..The gene │ │ │ │ │ -00003a00: 7261 7465 6420 274d 616b 6566 696c 652e rated 'Makefile. │ │ │ │ │ -00003a10: 696e 2773 2061 7265 2063 6f6d 706c 6961 in's are complia │ │ │ │ │ -00003a20: 6e74 2077 6974 6820 7468 6520 474e 5520 nt with the GNU │ │ │ │ │ -00003a30: 4d61 6b65 6669 6c65 0a73 7461 6e64 6172 Makefile.standar │ │ │ │ │ -00003a40: 6473 2e0a 0a20 2020 5468 6520 474e 5520 ds... The GNU │ │ │ │ │ -00003a50: 4d61 6b65 6669 6c65 2053 7461 6e64 6172 Makefile Standar │ │ │ │ │ -00003a60: 6473 2044 6f63 756d 656e 7420 282a 6e6f ds Document (*no │ │ │ │ │ -00003a70: 7465 2028 7374 616e 6461 7264 7329 4d61 te (standards)Ma │ │ │ │ │ -00003a80: 6b65 6669 6c65 0a43 6f6e 7665 6e74 696f kefile.Conventio │ │ │ │ │ -00003a90: 6e73 3a3a 2920 6973 206c 6f6e 672c 2063 ns::) is long, c │ │ │ │ │ -00003aa0: 6f6d 706c 6963 6174 6564 2c20 616e 6420 omplicated, and │ │ │ │ │ -00003ab0: 7375 626a 6563 7420 746f 2063 6861 6e67 subject to chang │ │ │ │ │ -00003ac0: 652e 2020 5468 6520 676f 616c 206f 660a e. The goal of. │ │ │ │ │ -00003ad0: 4175 746f 6d61 6b65 2069 7320 746f 2072 Automake is to r │ │ │ │ │ -00003ae0: 656d 6f76 6520 7468 6520 6275 7264 656e emove the burden │ │ │ │ │ -00003af0: 206f 6620 4d61 6b65 6669 6c65 206d 6169 of Makefile mai │ │ │ │ │ -00003b00: 6e74 656e 616e 6365 2066 726f 6d20 7468 ntenance from th │ │ │ │ │ -00003b10: 6520 6261 636b 0a6f 6620 7468 6520 696e e back.of the in │ │ │ │ │ -00003b20: 6469 7669 6475 616c 2047 4e55 206d 6169 dividual GNU mai │ │ │ │ │ -00003b30: 6e74 6169 6e65 7220 2861 6e64 2070 7574 ntainer (and put │ │ │ │ │ -00003b40: 2069 7420 6f6e 2074 6865 2062 6163 6b20 it on the back │ │ │ │ │ -00003b50: 6f66 2074 6865 2041 7574 6f6d 616b 650a of the Automake. │ │ │ │ │ -00003b60: 6d61 696e 7461 696e 6572 7329 2e0a 0a20 maintainers)... │ │ │ │ │ -00003b70: 2020 5468 6520 7479 7069 6361 6c20 4175 The typical Au │ │ │ │ │ -00003b80: 746f 6d61 6b65 2069 6e70 7574 2066 696c tomake input fil │ │ │ │ │ -00003b90: 6520 6973 2073 696d 706c 7920 6120 7365 e is simply a se │ │ │ │ │ -00003ba0: 7269 6573 206f 6620 7661 7269 6162 6c65 ries of variable │ │ │ │ │ -00003bb0: 0a64 6566 696e 6974 696f 6e73 2e20 2045 .definitions. E │ │ │ │ │ -00003bc0: 6163 6820 7375 6368 2066 696c 6520 6973 ach such file is │ │ │ │ │ -00003bd0: 2070 726f 6365 7373 6564 2074 6f20 6372 processed to cr │ │ │ │ │ -00003be0: 6561 7465 2061 2027 4d61 6b65 6669 6c65 eate a 'Makefile │ │ │ │ │ -00003bf0: 2e69 6e27 2e0a 5468 6572 6520 7368 6f75 .in'..There shou │ │ │ │ │ -00003c00: 6c64 2067 656e 6572 616c 6c79 2062 6520 ld generally be │ │ │ │ │ -00003c10: 6f6e 6520 274d 616b 6566 696c 652e 616d one 'Makefile.am │ │ │ │ │ -00003c20: 2720 7065 7220 6469 7265 6374 6f72 7920 ' per directory │ │ │ │ │ -00003c30: 6f66 2061 2070 726f 6a65 6374 2e0a 0a20 of a project... │ │ │ │ │ -00003c40: 2020 4175 746f 6d61 6b65 2064 6f65 7320 Automake does │ │ │ │ │ -00003c50: 636f 6e73 7472 6169 6e20 6120 7072 6f6a constrain a proj │ │ │ │ │ -00003c60: 6563 7420 696e 2063 6572 7461 696e 2077 ect in certain w │ │ │ │ │ -00003c70: 6179 733b 2066 6f72 2069 6e73 7461 6e63 ays; for instanc │ │ │ │ │ -00003c80: 652c 2069 740a 6173 7375 6d65 7320 7468 e, it.assumes th │ │ │ │ │ -00003c90: 6174 2074 6865 2070 726f 6a65 6374 2075 at the project u │ │ │ │ │ -00003ca0: 7365 7320 4175 746f 636f 6e66 2028 2a6e ses Autoconf (*n │ │ │ │ │ -00003cb0: 6f74 6520 496e 7472 6f64 7563 7469 6f6e ote Introduction │ │ │ │ │ -00003cc0: 3a0a 2861 7574 6f63 6f6e 6629 546f 702e :.(autoconf)Top. │ │ │ │ │ -00003cd0: 292c 2061 6e64 2065 6e66 6f72 6365 7320 ), and enforces │ │ │ │ │ -00003ce0: 6365 7274 6169 6e20 7265 7374 7269 6374 certain restrict │ │ │ │ │ -00003cf0: 696f 6e73 206f 6e20 7468 6520 2763 6f6e ions on the 'con │ │ │ │ │ -00003d00: 6669 6775 7265 2e61 6327 0a63 6f6e 7465 figure.ac'.conte │ │ │ │ │ -00003d10: 6e74 7328 3229 2e0a 0a20 2020 4175 746f nts(2)... Auto │ │ │ │ │ -00003d20: 6d61 6b65 2072 6571 7569 7265 7320 2770 make requires 'p │ │ │ │ │ -00003d30: 6572 6c27 2069 6e20 6f72 6465 7220 746f erl' in order to │ │ │ │ │ -00003d40: 2067 656e 6572 6174 6520 7468 6520 274d generate the 'M │ │ │ │ │ -00003d50: 616b 6566 696c 652e 696e 2773 2e0a 486f akefile.in's..Ho │ │ │ │ │ -00003d60: 7765 7665 722c 2074 6865 2064 6973 7472 wever, the distr │ │ │ │ │ -00003d70: 6962 7574 696f 6e73 2063 7265 6174 6564 ibutions created │ │ │ │ │ -00003d80: 2062 7920 4175 746f 6d61 6b65 2061 7265 by Automake are │ │ │ │ │ -00003d90: 2066 756c 6c79 2047 4e55 0a73 7461 6e64 fully GNU.stand │ │ │ │ │ -00003da0: 6172 6473 2d63 6f6d 706c 6961 6e74 2c20 ards-compliant, │ │ │ │ │ -00003db0: 616e 6420 646f 206e 6f74 2072 6571 7569 and do not requi │ │ │ │ │ -00003dc0: 7265 2027 7065 726c 2720 696e 206f 7264 re 'perl' in ord │ │ │ │ │ -00003dd0: 6572 2074 6f20 6265 2062 7569 6c74 2e0a er to be built.. │ │ │ │ │ -00003de0: 0a20 2020 466f 7220 6d6f 7265 2069 6e66 . For more inf │ │ │ │ │ -00003df0: 6f72 6d61 7469 6f6e 206f 6e20 6275 6720 ormation on bug │ │ │ │ │ -00003e00: 7265 706f 7274 732c 202a 4e6f 7465 2052 reports, *Note R │ │ │ │ │ -00003e10: 6570 6f72 7469 6e67 2042 7567 733a 3a2e eporting Bugs::. │ │ │ │ │ -00003e20: 0a0a 2020 202d 2d2d 2d2d 2d2d 2d2d 2d20 .. ---------- │ │ │ │ │ -00003e30: 466f 6f74 6e6f 7465 7320 2d2d 2d2d 2d2d Footnotes ------ │ │ │ │ │ -00003e40: 2d2d 2d2d 0a0a 2020 2028 3129 2054 6865 ----.. (1) The │ │ │ │ │ -00003e50: 7365 2076 6172 6961 626c 6573 2061 7265 se variables are │ │ │ │ │ -00003e60: 2061 6c73 6f20 6361 6c6c 6564 2022 6d61 also called "ma │ │ │ │ │ -00003e70: 6b65 206d 6163 726f 7322 2069 6e20 4d61 ke macros" in Ma │ │ │ │ │ -00003e80: 6b65 0a74 6572 6d69 6e6f 6c6f 6779 2c20 ke.terminology, │ │ │ │ │ -00003e90: 686f 7765 7665 7220 696e 2074 6869 7320 however in this │ │ │ │ │ -00003ea0: 6d61 6e75 616c 2077 6520 7265 7365 7276 manual we reserv │ │ │ │ │ -00003eb0: 6520 7468 6520 7465 726d 2022 6d61 6372 e the term "macr │ │ │ │ │ -00003ec0: 6f22 2066 6f72 0a41 7574 6f63 6f6e 6627 o" for.Autoconf' │ │ │ │ │ -00003ed0: 7320 6d61 6372 6f73 2e0a 0a20 2020 2832 s macros... (2 │ │ │ │ │ -00003ee0: 2920 4f6c 6465 7220 4175 746f 636f 6e66 ) Older Autoconf │ │ │ │ │ -00003ef0: 2076 6572 7369 6f6e 7320 7573 6564 2027 versions used ' │ │ │ │ │ -00003f00: 636f 6e66 6967 7572 652e 696e 272e 2020 configure.in'. │ │ │ │ │ -00003f10: 4175 746f 636f 6e66 2032 2e35 3020 616e Autoconf 2.50 an │ │ │ │ │ -00003f20: 640a 6772 6561 7465 7220 7072 6f6d 6f74 d.greater promot │ │ │ │ │ -00003f30: 6573 2027 636f 6e66 6967 7572 652e 6163 es 'configure.ac │ │ │ │ │ -00003f40: 2720 6f76 6572 2027 636f 6e66 6967 7572 ' over 'configur │ │ │ │ │ -00003f50: 652e 696e 272e 2020 5468 6520 7265 7374 e.in'. The rest │ │ │ │ │ -00003f60: 206f 6620 7468 6973 0a64 6f63 756d 656e of this.documen │ │ │ │ │ -00003f70: 7461 7469 6f6e 2077 696c 6c20 7265 6665 tation will refe │ │ │ │ │ -00003f80: 7220 746f 2027 636f 6e66 6967 7572 652e r to 'configure. │ │ │ │ │ -00003f90: 6163 272c 2062 7574 2041 7574 6f6d 616b ac', but Automak │ │ │ │ │ -00003fa0: 6520 616c 736f 2073 7570 706f 7274 730a e also supports. │ │ │ │ │ -00003fb0: 2763 6f6e 6669 6775 7265 2e69 6e27 2066 'configure.in' f │ │ │ │ │ -00003fc0: 6f72 2062 6163 6b77 6172 6420 636f 6d70 or backward comp │ │ │ │ │ -00003fd0: 6174 6962 696c 6974 792e 0a0a 1f0a 4669 atibility.....Fi │ │ │ │ │ -00003fe0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ -00003ff0: 312e 696e 666f 2c20 204e 6f64 653a 2041 1.info, Node: A │ │ │ │ │ -00004000: 7574 6f74 6f6f 6c73 2049 6e74 726f 6475 utotools Introdu │ │ │ │ │ -00004010: 6374 696f 6e2c 2020 4e65 7874 3a20 4765 ction, Next: Ge │ │ │ │ │ -00004020: 6e65 7261 6c69 7469 6573 2c20 2050 7265 neralities, Pre │ │ │ │ │ -00004030: 763a 2049 6e74 726f 6475 6374 696f 6e2c v: Introduction, │ │ │ │ │ -00004040: 2020 5570 3a20 546f 700a 0a32 2041 6e20 Up: Top..2 An │ │ │ │ │ -00004050: 496e 7472 6f64 7563 7469 6f6e 2074 6f20 Introduction to │ │ │ │ │ -00004060: 7468 6520 4175 746f 746f 6f6c 730a 2a2a the Autotools.** │ │ │ │ │ +00002ec0: 2020 2049 6e74 6572 6661 6369 6e67 2074 Interfacing t │ │ │ │ │ +00002ed0: 6f20 6574 6167 7320 616e 6420 6d6b 6964 o etags and mkid │ │ │ │ │ +00002ee0: 0a2a 2053 7566 6669 7865 733a 3a20 2020 .* Suffixes:: │ │ │ │ │ +00002ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00002f00: 2048 616e 646c 696e 6720 6e65 7720 6669 Handling new fi │ │ │ │ │ +00002f10: 6c65 2065 7874 656e 7369 6f6e 730a 2a20 le extensions.* │ │ │ │ │ +00002f20: 4d75 6c74 696c 6962 733a 3a20 2020 2020 Multilibs:: │ │ │ │ │ +00002f30: 2020 2020 2020 2020 2020 2020 2020 5375 Su │ │ │ │ │ +00002f40: 7070 6f72 7420 666f 7220 6d75 6c74 696c pport for multil │ │ │ │ │ +00002f50: 6962 7320 2864 6570 7265 6361 7465 642c ibs (deprecated, │ │ │ │ │ +00002f60: 2073 6f6f 6e20 746f 2062 6520 7265 6d6f soon to be remo │ │ │ │ │ +00002f70: 7665 6429 2e0a 0a43 6f6e 6469 7469 6f6e ved)...Condition │ │ │ │ │ +00002f80: 616c 730a 0a2a 2055 7361 6765 206f 6620 als..* Usage of │ │ │ │ │ +00002f90: 436f 6e64 6974 696f 6e61 6c73 3a3a 2020 Conditionals:: │ │ │ │ │ +00002fa0: 2020 2020 2044 6563 6c61 7269 6e67 2063 Declaring c │ │ │ │ │ +00002fb0: 6f6e 6469 7469 6f6e 616c 2063 6f6e 7465 onditional conte │ │ │ │ │ +00002fc0: 6e74 0a2a 204c 696d 6974 7320 6f66 2043 nt.* Limits of C │ │ │ │ │ +00002fd0: 6f6e 6469 7469 6f6e 616c 733a 3a20 2020 onditionals:: │ │ │ │ │ +00002fe0: 2020 2045 6e63 6c6f 7369 6e67 2063 6f6d Enclosing com │ │ │ │ │ +00002ff0: 706c 6574 6520 7374 6174 656d 656e 7473 plete statements │ │ │ │ │ +00003000: 0a0a 5369 6c65 6e63 696e 6720 4d61 6b65 ..Silencing Make │ │ │ │ │ +00003010: 0a0a 2a20 4d61 6b65 2076 6572 626f 7369 ..* Make verbosi │ │ │ │ │ +00003020: 7479 3a3a 2020 2020 2020 2020 2020 2020 ty:: │ │ │ │ │ +00003030: 2020 204d 616b 6520 6973 2076 6572 626f Make is verbo │ │ │ │ │ +00003040: 7365 2062 7920 6465 6661 756c 740a 2a20 se by default.* │ │ │ │ │ +00003050: 5472 6963 6b73 2046 6f72 2053 696c 656e Tricks For Silen │ │ │ │ │ +00003060: 6369 6e67 204d 616b 653a 3a20 2020 2053 cing Make:: S │ │ │ │ │ +00003070: 7461 6e64 6172 6420 616e 6420 6765 6e65 tandard and gene │ │ │ │ │ +00003080: 7269 6320 7761 7973 2074 6f20 7369 6c65 ric ways to sile │ │ │ │ │ +00003090: 6e63 6520 6d61 6b65 0a2a 2041 7574 6f6d nce make.* Autom │ │ │ │ │ +000030a0: 616b 6520 7369 6c65 6e74 2d72 756c 6573 ake silent-rules │ │ │ │ │ +000030b0: 204f 7074 696f 6e3a 3a20 486f 7720 4175 Option:: How Au │ │ │ │ │ +000030c0: 746f 6d61 6b65 2063 616e 2068 656c 7020 tomake can help │ │ │ │ │ +000030d0: 696e 2073 696c 656e 6369 6e67 206d 616b in silencing mak │ │ │ │ │ +000030e0: 650a 0a57 6865 6e20 4175 746f 6d61 6b65 e..When Automake │ │ │ │ │ +000030f0: 2049 736e 2774 2045 6e6f 7567 680a 0a2a Isn't Enough..* │ │ │ │ │ +00003100: 2045 7874 656e 6469 6e67 3a3a 2020 2020 Extending:: │ │ │ │ │ +00003110: 2020 2020 2020 2020 2020 2020 2020 2041 A │ │ │ │ │ +00003120: 6464 696e 6720 6e65 7720 7275 6c65 7320 dding new rules │ │ │ │ │ +00003130: 6f72 206f 7665 7272 6964 696e 6720 6578 or overriding ex │ │ │ │ │ +00003140: 6973 7469 6e67 206f 6e65 732e 0a2a 2054 isting ones..* T │ │ │ │ │ +00003150: 6869 7264 2d50 6172 7479 204d 616b 6566 hird-Party Makef │ │ │ │ │ +00003160: 696c 6573 3a3a 2020 2020 2020 2049 6e74 iles:: Int │ │ │ │ │ +00003170: 6567 7261 7469 6e67 204e 6f6e 2d41 7574 egrating Non-Aut │ │ │ │ │ +00003180: 6f6d 616b 6520 274d 616b 6566 696c 6527 omake 'Makefile' │ │ │ │ │ +00003190: 732e 0a0a 4672 6571 7565 6e74 6c79 2041 s...Frequently A │ │ │ │ │ +000031a0: 736b 6564 2051 7565 7374 696f 6e73 2061 sked Questions a │ │ │ │ │ +000031b0: 626f 7574 2041 7574 6f6d 616b 650a 0a2a bout Automake..* │ │ │ │ │ +000031c0: 2043 5653 3a3a 2020 2020 2020 2020 2020 CVS:: │ │ │ │ │ +000031d0: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ +000031e0: 5653 2061 6e64 2067 656e 6572 6174 6564 VS and generated │ │ │ │ │ +000031f0: 2066 696c 6573 0a2a 206d 6169 6e74 6169 files.* maintai │ │ │ │ │ +00003200: 6e65 722d 6d6f 6465 3a3a 2020 2020 2020 ner-mode:: │ │ │ │ │ +00003210: 2020 2020 2020 206d 6973 7369 6e67 2061 missing a │ │ │ │ │ +00003220: 6e64 2041 4d5f 4d41 494e 5441 494e 4552 nd AM_MAINTAINER │ │ │ │ │ +00003230: 5f4d 4f44 450a 2a20 5769 6c64 6361 7264 _MODE.* Wildcard │ │ │ │ │ +00003240: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ +00003250: 2020 2020 2020 5768 7920 646f 6573 6e27 Why doesn' │ │ │ │ │ +00003260: 7420 4175 746f 6d61 6b65 2073 7570 706f t Automake suppo │ │ │ │ │ +00003270: 7274 2077 696c 6463 6172 6473 3f0a 2a20 rt wildcards?.* │ │ │ │ │ +00003280: 4c69 6d69 7461 7469 6f6e 7320 6f6e 2046 Limitations on F │ │ │ │ │ +00003290: 696c 6520 4e61 6d65 733a 3a20 2020 4c69 ile Names:: Li │ │ │ │ │ +000032a0: 6d69 7461 7469 6f6e 7320 6f6e 2073 6f75 mitations on sou │ │ │ │ │ +000032b0: 7263 6520 616e 6420 696e 7374 616c 6c65 rce and installe │ │ │ │ │ +000032c0: 6420 6669 6c65 206e 616d 6573 0a2a 2064 d file names.* d │ │ │ │ │ +000032d0: 6973 7463 6c65 616e 6368 6563 6b3a 3a20 istcleancheck:: │ │ │ │ │ +000032e0: 2020 2020 2020 2020 2020 2020 2046 696c Fil │ │ │ │ │ +000032f0: 6573 206c 6566 7420 696e 2062 7569 6c64 es left in build │ │ │ │ │ +00003300: 2064 6972 6563 746f 7279 2061 6674 6572 directory after │ │ │ │ │ +00003310: 2064 6973 7463 6c65 616e 0a2a 2046 6c61 distclean.* Fla │ │ │ │ │ +00003320: 6720 5661 7269 6162 6c65 7320 4f72 6465 g Variables Orde │ │ │ │ │ +00003330: 7269 6e67 3a3a 2020 2020 2043 464c 4147 ring:: CFLAG │ │ │ │ │ +00003340: 5320 7673 2e20 414d 5f43 464c 4147 5320 S vs. AM_CFLAGS │ │ │ │ │ +00003350: 7673 2e20 6d75 6d62 6c65 5f43 464c 4147 vs. mumble_CFLAG │ │ │ │ │ +00003360: 530a 2a20 5265 6e61 6d65 6420 4f62 6a65 S.* Renamed Obje │ │ │ │ │ +00003370: 6374 733a 3a20 2020 2020 2020 2020 2020 cts:: │ │ │ │ │ +00003380: 2020 5768 7920 6172 6520 6f62 6a65 6374 Why are object │ │ │ │ │ +00003390: 2066 696c 6573 2073 6f6d 6574 696d 6573 files sometimes │ │ │ │ │ +000033a0: 2072 656e 616d 6564 3f0a 2a20 5065 722d renamed?.* Per- │ │ │ │ │ +000033b0: 4f62 6a65 6374 2046 6c61 6773 3a3a 2020 Object Flags:: │ │ │ │ │ +000033c0: 2020 2020 2020 2020 2020 486f 7720 746f How to │ │ │ │ │ +000033d0: 2073 696d 756c 6174 6520 7065 722d 6f62 simulate per-ob │ │ │ │ │ +000033e0: 6a65 6374 2066 6c61 6773 3f0a 2a20 4d75 ject flags?.* Mu │ │ │ │ │ +000033f0: 6c74 6970 6c65 204f 7574 7075 7473 3a3a ltiple Outputs:: │ │ │ │ │ +00003400: 2020 2020 2020 2020 2020 2020 5772 6974 Writ │ │ │ │ │ +00003410: 696e 6720 7275 6c65 7320 666f 7220 746f ing rules for to │ │ │ │ │ +00003420: 6f6c 7320 7769 7468 206d 616e 7920 6f75 ols with many ou │ │ │ │ │ +00003430: 7470 7574 2066 696c 6573 0a2a 2048 6172 tput files.* Har │ │ │ │ │ +00003440: 642d 436f 6465 6420 496e 7374 616c 6c20 d-Coded Install │ │ │ │ │ +00003450: 5061 7468 733a 3a20 2020 2049 6e73 7461 Paths:: Insta │ │ │ │ │ +00003460: 6c6c 696e 6720 746f 2068 6172 642d 636f lling to hard-co │ │ │ │ │ +00003470: 6465 6420 6c6f 6361 7469 6f6e 730a 2a20 ded locations.* │ │ │ │ │ +00003480: 4465 6275 6767 696e 6720 4d61 6b65 2052 Debugging Make R │ │ │ │ │ +00003490: 756c 6573 3a3a 2020 2020 2020 2020 5374 ules:: St │ │ │ │ │ +000034a0: 7261 7465 6769 6573 2077 6865 6e20 7468 rategies when th │ │ │ │ │ +000034b0: 696e 6773 2064 6f6e 2774 2077 6f72 6b20 ings don't work │ │ │ │ │ +000034c0: 6173 2065 7870 6563 7465 640a 2a20 5265 as expected.* Re │ │ │ │ │ +000034d0: 706f 7274 696e 6720 4275 6773 3a3a 2020 porting Bugs:: │ │ │ │ │ +000034e0: 2020 2020 2020 2020 2020 2020 4665 6564 Feed │ │ │ │ │ +000034f0: 6261 636b 206f 6e20 6275 6773 2061 6e64 back on bugs and │ │ │ │ │ +00003500: 2066 6561 7475 7265 2072 6571 7565 7374 feature request │ │ │ │ │ +00003510: 730a 0a48 6973 746f 7279 206f 6620 4175 s..History of Au │ │ │ │ │ +00003520: 746f 6d61 6b65 0a0a 2a20 5469 6d65 6c69 tomake..* Timeli │ │ │ │ │ +00003530: 6e65 3a3a 2020 2020 2020 2020 2020 2020 ne:: │ │ │ │ │ +00003540: 2020 2020 2020 2020 5468 6520 4175 746f The Auto │ │ │ │ │ +00003550: 6d61 6b65 2073 746f 7279 2e0a 2a20 4465 make story..* De │ │ │ │ │ +00003560: 7065 6e64 656e 6379 2054 7261 636b 696e pendency Trackin │ │ │ │ │ +00003570: 6720 4576 6f6c 7574 696f 6e3a 3a20 2045 g Evolution:: E │ │ │ │ │ +00003580: 766f 6c75 7469 6f6e 206f 6620 4175 746f volution of Auto │ │ │ │ │ +00003590: 6d61 7469 6320 4465 7065 6e64 656e 6379 matic Dependency │ │ │ │ │ +000035a0: 2054 7261 636b 696e 670a 2a20 5265 6c65 Tracking.* Rele │ │ │ │ │ +000035b0: 6173 6573 3a3a 2020 2020 2020 2020 2020 ases:: │ │ │ │ │ +000035c0: 2020 2020 2020 2020 2020 5374 6174 6973 Statis │ │ │ │ │ +000035d0: 7469 6373 2061 626f 7574 2041 7574 6f6d tics about Autom │ │ │ │ │ +000035e0: 616b 6520 5265 6c65 6173 6573 0a0a 4465 ake Releases..De │ │ │ │ │ +000035f0: 7065 6e64 656e 6379 2054 7261 636b 696e pendency Trackin │ │ │ │ │ +00003600: 6720 696e 2041 7574 6f6d 616b 650a 0a2a g in Automake..* │ │ │ │ │ +00003610: 2046 6972 7374 2054 616b 6520 6f6e 2044 First Take on D │ │ │ │ │ +00003620: 6570 656e 6465 6e63 6965 733a 3a20 2050 ependencies:: P │ │ │ │ │ +00003630: 7265 636f 6d70 7574 6564 2064 6570 656e recomputed depen │ │ │ │ │ +00003640: 6465 6e63 7920 7472 6163 6b69 6e67 0a2a dency tracking.* │ │ │ │ │ +00003650: 2044 6570 656e 6465 6e63 6965 7320 4173 Dependencies As │ │ │ │ │ +00003660: 2053 6964 6520 4566 6665 6374 733a 3a20 Side Effects:: │ │ │ │ │ +00003670: 2055 7064 6174 6520 6174 2064 6576 656c Update at devel │ │ │ │ │ +00003680: 6f70 6572 2063 6f6d 7069 6c65 2074 696d oper compile tim │ │ │ │ │ +00003690: 650a 2a20 4465 7065 6e64 656e 6369 6573 e.* Dependencies │ │ │ │ │ +000036a0: 2066 6f72 2074 6865 2055 7365 723a 3a20 for the User:: │ │ │ │ │ +000036b0: 2020 5570 6461 7465 2061 7420 7573 6572 Update at user │ │ │ │ │ +000036c0: 2063 6f6d 7069 6c65 2074 696d 650a 2a20 compile time.* │ │ │ │ │ +000036d0: 5465 6368 6e69 7175 6573 2066 6f72 2044 Techniques for D │ │ │ │ │ +000036e0: 6570 656e 6465 6e63 6965 733a 3a20 2041 ependencies:: A │ │ │ │ │ +000036f0: 6c74 6572 6e61 7469 7665 2061 7070 726f lternative appro │ │ │ │ │ +00003700: 6163 6865 730a 2a20 5265 636f 6d6d 656e aches.* Recommen │ │ │ │ │ +00003710: 6461 7469 6f6e 7320 666f 7220 546f 6f6c dations for Tool │ │ │ │ │ +00003720: 2057 7269 7465 7273 3a3a 2020 5768 6174 Writers:: What │ │ │ │ │ +00003730: 2074 6f6f 6c20 7772 6974 6572 7320 6361 tool writers ca │ │ │ │ │ +00003740: 6e20 646f 2074 6f20 6865 6c70 0a2a 2046 n do to help.* F │ │ │ │ │ +00003750: 7574 7572 6520 4469 7265 6374 696f 6e73 uture Directions │ │ │ │ │ +00003760: 2066 6f72 2044 6570 656e 6465 6e63 6965 for Dependencie │ │ │ │ │ +00003770: 733a 3a20 204c 616e 6775 6167 6573 2041 s:: Languages A │ │ │ │ │ +00003780: 7574 6f6d 616b 6520 646f 6573 206e 6f74 utomake does not │ │ │ │ │ +00003790: 206b 6e6f 770a 0a43 6f70 7969 6e67 2054 know..Copying T │ │ │ │ │ +000037a0: 6869 7320 4d61 6e75 616c 0a0a 2a20 474e his Manual..* GN │ │ │ │ │ +000037b0: 5520 4672 6565 2044 6f63 756d 656e 7461 U Free Documenta │ │ │ │ │ +000037c0: 7469 6f6e 204c 6963 656e 7365 3a3a 2020 tion License:: │ │ │ │ │ +000037d0: 4c69 6365 6e73 6520 666f 7220 636f 7079 License for copy │ │ │ │ │ +000037e0: 696e 6720 7468 6973 206d 616e 7561 6c0a ing this manual. │ │ │ │ │ +000037f0: 0a49 6e64 6963 6573 0a0a 2a20 4d61 6372 .Indices..* Macr │ │ │ │ │ +00003800: 6f20 496e 6465 783a 3a20 2020 2020 2020 o Index:: │ │ │ │ │ +00003810: 2020 2020 2020 2020 2020 496e 6465 7820 Index │ │ │ │ │ +00003820: 6f66 2041 7574 6f63 6f6e 6620 6d61 6372 of Autoconf macr │ │ │ │ │ +00003830: 6f73 0a2a 2056 6172 6961 626c 6520 496e os.* Variable In │ │ │ │ │ +00003840: 6465 783a 3a20 2020 2020 2020 2020 2020 dex:: │ │ │ │ │ +00003850: 2020 2049 6e64 6578 206f 6620 4d61 6b65 Index of Make │ │ │ │ │ +00003860: 6669 6c65 2076 6172 6961 626c 6573 0a2a file variables.* │ │ │ │ │ +00003870: 2047 656e 6572 616c 2049 6e64 6578 3a3a General Index:: │ │ │ │ │ +00003880: 2020 2020 2020 2020 2020 2020 2020 2047 G │ │ │ │ │ +00003890: 656e 6572 616c 2069 6e64 6578 0a0a 0a1f eneral index.... │ │ │ │ │ +000038a0: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +000038b0: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +000038c0: 3a20 496e 7472 6f64 7563 7469 6f6e 2c20 : Introduction, │ │ │ │ │ +000038d0: 204e 6578 743a 2041 7574 6f74 6f6f 6c73 Next: Autotools │ │ │ │ │ +000038e0: 2049 6e74 726f 6475 6374 696f 6e2c 2020 Introduction, │ │ │ │ │ +000038f0: 5072 6576 3a20 546f 702c 2020 5570 3a20 Prev: Top, Up: │ │ │ │ │ +00003900: 546f 700a 0a31 2049 6e74 726f 6475 6374 Top..1 Introduct │ │ │ │ │ +00003910: 696f 6e0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ion.************ │ │ │ │ │ +00003920: 2a2a 0a0a 4175 746f 6d61 6b65 2069 7320 **..Automake is │ │ │ │ │ +00003930: 6120 746f 6f6c 2066 6f72 2061 7574 6f6d a tool for autom │ │ │ │ │ +00003940: 6174 6963 616c 6c79 2067 656e 6572 6174 atically generat │ │ │ │ │ +00003950: 696e 6720 274d 616b 6566 696c 652e 696e ing 'Makefile.in │ │ │ │ │ +00003960: 2773 2066 726f 6d0a 6669 6c65 7320 6361 's from.files ca │ │ │ │ │ +00003970: 6c6c 6564 2027 4d61 6b65 6669 6c65 2e61 lled 'Makefile.a │ │ │ │ │ +00003980: 6d27 2e20 2045 6163 6820 274d 616b 6566 m'. Each 'Makef │ │ │ │ │ +00003990: 696c 652e 616d 2720 6973 2062 6173 6963 ile.am' is basic │ │ │ │ │ +000039a0: 616c 6c79 2061 2073 6572 6965 7320 6f66 ally a series of │ │ │ │ │ +000039b0: 0a27 6d61 6b65 2720 7661 7269 6162 6c65 .'make' variable │ │ │ │ │ +000039c0: 2064 6566 696e 6974 696f 6e73 2831 292c definitions(1), │ │ │ │ │ +000039d0: 2077 6974 6820 7275 6c65 7320 6265 696e with rules bein │ │ │ │ │ +000039e0: 6720 7468 726f 776e 2069 6e20 6f63 6361 g thrown in occa │ │ │ │ │ +000039f0: 7369 6f6e 616c 6c79 2e0a 5468 6520 6765 sionally..The ge │ │ │ │ │ +00003a00: 6e65 7261 7465 6420 274d 616b 6566 696c nerated 'Makefil │ │ │ │ │ +00003a10: 652e 696e 2773 2061 7265 2063 6f6d 706c e.in's are compl │ │ │ │ │ +00003a20: 6961 6e74 2077 6974 6820 7468 6520 474e iant with the GN │ │ │ │ │ +00003a30: 5520 4d61 6b65 6669 6c65 0a73 7461 6e64 U Makefile.stand │ │ │ │ │ +00003a40: 6172 6473 2e0a 0a20 2020 5468 6520 474e ards... The GN │ │ │ │ │ +00003a50: 5520 4d61 6b65 6669 6c65 2053 7461 6e64 U Makefile Stand │ │ │ │ │ +00003a60: 6172 6473 2044 6f63 756d 656e 7420 282a ards Document (* │ │ │ │ │ +00003a70: 6e6f 7465 2028 7374 616e 6461 7264 7329 note (standards) │ │ │ │ │ +00003a80: 4d61 6b65 6669 6c65 0a43 6f6e 7665 6e74 Makefile.Convent │ │ │ │ │ +00003a90: 696f 6e73 3a3a 2920 6973 206c 6f6e 672c ions::) is long, │ │ │ │ │ +00003aa0: 2063 6f6d 706c 6963 6174 6564 2c20 616e complicated, an │ │ │ │ │ +00003ab0: 6420 7375 626a 6563 7420 746f 2063 6861 d subject to cha │ │ │ │ │ +00003ac0: 6e67 652e 2020 5468 6520 676f 616c 206f nge. The goal o │ │ │ │ │ +00003ad0: 660a 4175 746f 6d61 6b65 2069 7320 746f f.Automake is to │ │ │ │ │ +00003ae0: 2072 656d 6f76 6520 7468 6520 6275 7264 remove the burd │ │ │ │ │ +00003af0: 656e 206f 6620 4d61 6b65 6669 6c65 206d en of Makefile m │ │ │ │ │ +00003b00: 6169 6e74 656e 616e 6365 2066 726f 6d20 aintenance from │ │ │ │ │ +00003b10: 7468 6520 6261 636b 0a6f 6620 7468 6520 the back.of the │ │ │ │ │ +00003b20: 696e 6469 7669 6475 616c 2047 4e55 206d individual GNU m │ │ │ │ │ +00003b30: 6169 6e74 6169 6e65 7220 2861 6e64 2070 aintainer (and p │ │ │ │ │ +00003b40: 7574 2069 7420 6f6e 2074 6865 2062 6163 ut it on the bac │ │ │ │ │ +00003b50: 6b20 6f66 2074 6865 2041 7574 6f6d 616b k of the Automak │ │ │ │ │ +00003b60: 650a 6d61 696e 7461 696e 6572 7329 2e0a e.maintainers).. │ │ │ │ │ +00003b70: 0a20 2020 5468 6520 7479 7069 6361 6c20 . The typical │ │ │ │ │ +00003b80: 4175 746f 6d61 6b65 2069 6e70 7574 2066 Automake input f │ │ │ │ │ +00003b90: 696c 6520 6973 2073 696d 706c 7920 6120 ile is simply a │ │ │ │ │ +00003ba0: 7365 7269 6573 206f 6620 7661 7269 6162 series of variab │ │ │ │ │ +00003bb0: 6c65 0a64 6566 696e 6974 696f 6e73 2e20 le.definitions. │ │ │ │ │ +00003bc0: 2045 6163 6820 7375 6368 2066 696c 6520 Each such file │ │ │ │ │ +00003bd0: 6973 2070 726f 6365 7373 6564 2074 6f20 is processed to │ │ │ │ │ +00003be0: 6372 6561 7465 2061 2027 4d61 6b65 6669 create a 'Makefi │ │ │ │ │ +00003bf0: 6c65 2e69 6e27 2e0a 5468 6572 6520 7368 le.in'..There sh │ │ │ │ │ +00003c00: 6f75 6c64 2067 656e 6572 616c 6c79 2062 ould generally b │ │ │ │ │ +00003c10: 6520 6f6e 6520 274d 616b 6566 696c 652e e one 'Makefile. │ │ │ │ │ +00003c20: 616d 2720 7065 7220 6469 7265 6374 6f72 am' per director │ │ │ │ │ +00003c30: 7920 6f66 2061 2070 726f 6a65 6374 2e0a y of a project.. │ │ │ │ │ +00003c40: 0a20 2020 4175 746f 6d61 6b65 2064 6f65 . Automake doe │ │ │ │ │ +00003c50: 7320 636f 6e73 7472 6169 6e20 6120 7072 s constrain a pr │ │ │ │ │ +00003c60: 6f6a 6563 7420 696e 2063 6572 7461 696e oject in certain │ │ │ │ │ +00003c70: 2077 6179 733b 2066 6f72 2069 6e73 7461 ways; for insta │ │ │ │ │ +00003c80: 6e63 652c 2069 740a 6173 7375 6d65 7320 nce, it.assumes │ │ │ │ │ +00003c90: 7468 6174 2074 6865 2070 726f 6a65 6374 that the project │ │ │ │ │ +00003ca0: 2075 7365 7320 4175 746f 636f 6e66 2028 uses Autoconf ( │ │ │ │ │ +00003cb0: 2a6e 6f74 6520 496e 7472 6f64 7563 7469 *note Introducti │ │ │ │ │ +00003cc0: 6f6e 3a0a 2861 7574 6f63 6f6e 6629 546f on:.(autoconf)To │ │ │ │ │ +00003cd0: 702e 292c 2061 6e64 2065 6e66 6f72 6365 p.), and enforce │ │ │ │ │ +00003ce0: 7320 6365 7274 6169 6e20 7265 7374 7269 s certain restri │ │ │ │ │ +00003cf0: 6374 696f 6e73 206f 6e20 7468 6520 2763 ctions on the 'c │ │ │ │ │ +00003d00: 6f6e 6669 6775 7265 2e61 6327 0a63 6f6e onfigure.ac'.con │ │ │ │ │ +00003d10: 7465 6e74 7328 3229 2e0a 0a20 2020 4175 tents(2)... Au │ │ │ │ │ +00003d20: 746f 6d61 6b65 2072 6571 7569 7265 7320 tomake requires │ │ │ │ │ +00003d30: 2770 6572 6c27 2069 6e20 6f72 6465 7220 'perl' in order │ │ │ │ │ +00003d40: 746f 2067 656e 6572 6174 6520 7468 6520 to generate the │ │ │ │ │ +00003d50: 274d 616b 6566 696c 652e 696e 2773 2e0a 'Makefile.in's.. │ │ │ │ │ +00003d60: 486f 7765 7665 722c 2074 6865 2064 6973 However, the dis │ │ │ │ │ +00003d70: 7472 6962 7574 696f 6e73 2063 7265 6174 tributions creat │ │ │ │ │ +00003d80: 6564 2062 7920 4175 746f 6d61 6b65 2061 ed by Automake a │ │ │ │ │ +00003d90: 7265 2066 756c 6c79 2047 4e55 0a73 7461 re fully GNU.sta │ │ │ │ │ +00003da0: 6e64 6172 6473 2d63 6f6d 706c 6961 6e74 ndards-compliant │ │ │ │ │ +00003db0: 2c20 616e 6420 646f 206e 6f74 2072 6571 , and do not req │ │ │ │ │ +00003dc0: 7569 7265 2027 7065 726c 2720 696e 206f uire 'perl' in o │ │ │ │ │ +00003dd0: 7264 6572 2074 6f20 6265 2062 7569 6c74 rder to be built │ │ │ │ │ +00003de0: 2e0a 0a20 2020 466f 7220 6d6f 7265 2069 ... For more i │ │ │ │ │ +00003df0: 6e66 6f72 6d61 7469 6f6e 206f 6e20 6275 nformation on bu │ │ │ │ │ +00003e00: 6720 7265 706f 7274 732c 202a 4e6f 7465 g reports, *Note │ │ │ │ │ +00003e10: 2052 6570 6f72 7469 6e67 2042 7567 733a Reporting Bugs: │ │ │ │ │ +00003e20: 3a2e 0a0a 2020 202d 2d2d 2d2d 2d2d 2d2d :... --------- │ │ │ │ │ +00003e30: 2d20 466f 6f74 6e6f 7465 7320 2d2d 2d2d - Footnotes ---- │ │ │ │ │ +00003e40: 2d2d 2d2d 2d2d 0a0a 2020 2028 3129 2054 ------.. (1) T │ │ │ │ │ +00003e50: 6865 7365 2076 6172 6961 626c 6573 2061 hese variables a │ │ │ │ │ +00003e60: 7265 2061 6c73 6f20 6361 6c6c 6564 2022 re also called " │ │ │ │ │ +00003e70: 6d61 6b65 206d 6163 726f 7322 2069 6e20 make macros" in │ │ │ │ │ +00003e80: 4d61 6b65 0a74 6572 6d69 6e6f 6c6f 6779 Make.terminology │ │ │ │ │ +00003e90: 2c20 686f 7765 7665 7220 696e 2074 6869 , however in thi │ │ │ │ │ +00003ea0: 7320 6d61 6e75 616c 2077 6520 7265 7365 s manual we rese │ │ │ │ │ +00003eb0: 7276 6520 7468 6520 7465 726d 2022 6d61 rve the term "ma │ │ │ │ │ +00003ec0: 6372 6f22 2066 6f72 0a41 7574 6f63 6f6e cro" for.Autocon │ │ │ │ │ +00003ed0: 6627 7320 6d61 6372 6f73 2e0a 0a20 2020 f's macros... │ │ │ │ │ +00003ee0: 2832 2920 4f6c 6465 7220 4175 746f 636f (2) Older Autoco │ │ │ │ │ +00003ef0: 6e66 2076 6572 7369 6f6e 7320 7573 6564 nf versions used │ │ │ │ │ +00003f00: 2027 636f 6e66 6967 7572 652e 696e 272e 'configure.in'. │ │ │ │ │ +00003f10: 2020 4175 746f 636f 6e66 2032 2e35 3020 Autoconf 2.50 │ │ │ │ │ +00003f20: 616e 640a 6772 6561 7465 7220 7072 6f6d and.greater prom │ │ │ │ │ +00003f30: 6f74 6573 2027 636f 6e66 6967 7572 652e otes 'configure. │ │ │ │ │ +00003f40: 6163 2720 6f76 6572 2027 636f 6e66 6967 ac' over 'config │ │ │ │ │ +00003f50: 7572 652e 696e 272e 2020 5468 6520 7265 ure.in'. The re │ │ │ │ │ +00003f60: 7374 206f 6620 7468 6973 0a64 6f63 756d st of this.docum │ │ │ │ │ +00003f70: 656e 7461 7469 6f6e 2077 696c 6c20 7265 entation will re │ │ │ │ │ +00003f80: 6665 7220 746f 2027 636f 6e66 6967 7572 fer to 'configur │ │ │ │ │ +00003f90: 652e 6163 272c 2062 7574 2041 7574 6f6d e.ac', but Autom │ │ │ │ │ +00003fa0: 616b 6520 616c 736f 2073 7570 706f 7274 ake also support │ │ │ │ │ +00003fb0: 730a 2763 6f6e 6669 6775 7265 2e69 6e27 s.'configure.in' │ │ │ │ │ +00003fc0: 2066 6f72 2062 6163 6b77 6172 6420 636f for backward co │ │ │ │ │ +00003fd0: 6d70 6174 6962 696c 6974 792e 0a0a 1f0a mpatibility..... │ │ │ │ │ +00003fe0: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +00003ff0: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +00004000: 2041 7574 6f74 6f6f 6c73 2049 6e74 726f Autotools Intro │ │ │ │ │ +00004010: 6475 6374 696f 6e2c 2020 4e65 7874 3a20 duction, Next: │ │ │ │ │ +00004020: 4765 6e65 7261 6c69 7469 6573 2c20 2050 Generalities, P │ │ │ │ │ +00004030: 7265 763a 2049 6e74 726f 6475 6374 696f rev: Introductio │ │ │ │ │ +00004040: 6e2c 2020 5570 3a20 546f 700a 0a32 2041 n, Up: Top..2 A │ │ │ │ │ +00004050: 6e20 496e 7472 6f64 7563 7469 6f6e 2074 n Introduction t │ │ │ │ │ +00004060: 6f20 7468 6520 4175 746f 746f 6f6c 730a o the Autotools. │ │ │ │ │ 00004070: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 00004080: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00004090: 0a0a 4966 2079 6f75 2061 7265 206e 6577 ..If you are new │ │ │ │ │ -000040a0: 2074 6f20 4175 746f 6d61 6b65 2c20 6d61 to Automake, ma │ │ │ │ │ -000040b0: 7962 6520 796f 7520 6b6e 6f77 2074 6861 ybe you know tha │ │ │ │ │ -000040c0: 7420 6974 2069 7320 7061 7274 206f 6620 t it is part of │ │ │ │ │ -000040d0: 6120 7365 7420 6f66 0a74 6f6f 6c73 2063 a set of.tools c │ │ │ │ │ -000040e0: 616c 6c65 6420 5f54 6865 2041 7574 6f74 alled _The Autot │ │ │ │ │ -000040f0: 6f6f 6c73 5f2e 2020 4d61 7962 6520 796f ools_. Maybe yo │ │ │ │ │ -00004100: 7527 7665 2061 6c72 6561 6479 2064 656c u've already del │ │ │ │ │ -00004110: 7665 6420 696e 746f 2061 0a70 6163 6b61 ved into a.packa │ │ │ │ │ -00004120: 6765 2066 756c 6c20 6f66 2066 696c 6573 ge full of files │ │ │ │ │ -00004130: 206e 616d 6564 2027 636f 6e66 6967 7572 named 'configur │ │ │ │ │ -00004140: 6527 2c20 2763 6f6e 6669 6775 7265 2e61 e', 'configure.a │ │ │ │ │ -00004150: 6327 2c20 274d 616b 6566 696c 652e 696e c', 'Makefile.in │ │ │ │ │ -00004160: 272c 0a27 4d61 6b65 6669 6c65 2e61 6d27 ',.'Makefile.am' │ │ │ │ │ -00004170: 2c20 2761 636c 6f63 616c 2e6d 3427 2c20 , 'aclocal.m4', │ │ │ │ │ -00004180: 2e2e 2e2c 2073 6f6d 6520 6f66 2074 6865 ..., some of the │ │ │ │ │ -00004190: 6d20 636c 6169 6d69 6e67 2074 6f20 6265 m claiming to be │ │ │ │ │ -000041a0: 205f 6765 6e65 7261 7465 640a 6279 5f20 _generated.by_ │ │ │ │ │ -000041b0: 4175 746f 636f 6e66 206f 7220 4175 746f Autoconf or Auto │ │ │ │ │ -000041c0: 6d61 6b65 2e20 2042 7574 2074 6865 2065 make. But the e │ │ │ │ │ -000041d0: 7861 6374 2070 7572 706f 7365 206f 6620 xact purpose of │ │ │ │ │ -000041e0: 7468 6573 6520 6669 6c65 7320 616e 640a these files and. │ │ │ │ │ -000041f0: 7468 6569 7220 7265 6c61 7469 6f6e 7320 their relations │ │ │ │ │ -00004200: 6973 2070 726f 6261 626c 7920 6675 7a7a is probably fuzz │ │ │ │ │ -00004210: 792e 2020 5468 6520 676f 616c 206f 6620 y. The goal of │ │ │ │ │ -00004220: 7468 6973 2063 6861 7074 6572 2069 7320 this chapter is │ │ │ │ │ -00004230: 746f 0a69 6e74 726f 6475 6365 2079 6f75 to.introduce you │ │ │ │ │ -00004240: 2074 6f20 7468 6973 206d 6163 6869 6e65 to this machine │ │ │ │ │ -00004250: 7279 2c20 746f 2073 686f 7720 796f 7520 ry, to show you │ │ │ │ │ -00004260: 686f 7720 6974 2077 6f72 6b73 2061 6e64 how it works and │ │ │ │ │ -00004270: 2068 6f77 0a70 6f77 6572 6675 6c20 6974 how.powerful it │ │ │ │ │ -00004280: 2069 732e 2020 4966 2079 6f75 2776 6520 is. If you've │ │ │ │ │ -00004290: 6e65 7665 7220 696e 7374 616c 6c65 6420 never installed │ │ │ │ │ -000042a0: 6f72 2073 6565 6e20 7375 6368 2061 2070 or seen such a p │ │ │ │ │ -000042b0: 6163 6b61 6765 2c20 646f 0a6e 6f74 2077 ackage, do.not w │ │ │ │ │ -000042c0: 6f72 7279 3a20 7468 6973 2063 6861 7074 orry: this chapt │ │ │ │ │ -000042d0: 6572 2077 696c 6c20 7761 6c6b 2079 6f75 er will walk you │ │ │ │ │ -000042e0: 2074 6872 6f75 6768 2069 742e 0a0a 2020 through it... │ │ │ │ │ -000042f0: 2049 6620 796f 7520 6e65 6564 2073 6f6d If you need som │ │ │ │ │ -00004300: 6520 7465 6163 6869 6e67 206d 6174 6572 e teaching mater │ │ │ │ │ -00004310: 6961 6c2c 206d 6f72 6520 696c 6c75 7374 ial, more illust │ │ │ │ │ -00004320: 7261 7469 6f6e 732c 206f 7220 6120 6c65 rations, or a le │ │ │ │ │ -00004330: 7373 0a27 6175 746f 6d61 6b65 272d 6365 ss.'automake'-ce │ │ │ │ │ -00004340: 6e74 6572 6564 2063 6f6e 7469 6e75 6174 ntered continuat │ │ │ │ │ -00004350: 696f 6e2c 2073 6f6d 6520 736c 6964 6573 ion, some slides │ │ │ │ │ -00004360: 2066 6f72 2074 6869 7320 696e 7472 6f64 for this introd │ │ │ │ │ -00004370: 7563 7469 6f6e 2061 7265 0a61 7661 696c uction are.avail │ │ │ │ │ -00004380: 6162 6c65 2069 6e20 416c 6578 616e 6472 able in Alexandr │ │ │ │ │ -00004390: 6520 4475 7265 742d 4c75 747a 2773 2041 e Duret-Lutz's A │ │ │ │ │ -000043a0: 7574 6f74 6f6f 6c73 2054 7574 6f72 6961 utotools Tutoria │ │ │ │ │ -000043b0: 6c0a 2868 7474 703a 2f2f 7777 772e 6c72 l.(http://www.lr │ │ │ │ │ -000043c0: 6465 2e65 7069 7461 2e66 722f 7e61 646c de.epita.fr/~adl │ │ │ │ │ -000043d0: 2f61 7574 6f74 6f6f 6c73 2e68 746d 6c29 /autotools.html) │ │ │ │ │ -000043e0: 2e20 2054 6869 7320 6368 6170 7465 7220 . This chapter │ │ │ │ │ -000043f0: 6973 2074 6865 0a77 7269 7474 656e 2076 is the.written v │ │ │ │ │ -00004400: 6572 7369 6f6e 206f 6620 7468 6520 6669 ersion of the fi │ │ │ │ │ -00004410: 7273 7420 7061 7274 206f 6620 6869 7320 rst part of his │ │ │ │ │ -00004420: 7475 746f 7269 616c 2e0a 0a2a 204d 656e tutorial...* Men │ │ │ │ │ -00004430: 753a 0a0a 2a20 474e 5520 4275 696c 6420 u:..* GNU Build │ │ │ │ │ -00004440: 5379 7374 656d 3a3a 2020 2020 2020 2020 System:: │ │ │ │ │ -00004450: 2020 2020 496e 7472 6f64 7563 696e 6720 Introducing │ │ │ │ │ -00004460: 7468 6520 474e 5520 4275 696c 6420 5379 the GNU Build Sy │ │ │ │ │ -00004470: 7374 656d 0a2a 2055 7365 2043 6173 6573 stem.* Use Cases │ │ │ │ │ -00004480: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00004490: 2020 2020 2055 7365 2043 6173 6573 2066 Use Cases f │ │ │ │ │ -000044a0: 6f72 2074 6865 2047 4e55 2042 7569 6c64 or the GNU Build │ │ │ │ │ -000044b0: 2053 7973 7465 6d0a 2a20 5768 7920 4175 System.* Why Au │ │ │ │ │ -000044c0: 746f 746f 6f6c 733a 3a20 2020 2020 2020 totools:: │ │ │ │ │ -000044d0: 2020 2020 2020 2020 486f 7720 4175 746f How Auto │ │ │ │ │ -000044e0: 746f 6f6c 7320 4865 6c70 0a2a 2048 656c tools Help.* Hel │ │ │ │ │ -000044f0: 6c6f 2057 6f72 6c64 3a3a 2020 2020 2020 lo World:: │ │ │ │ │ -00004500: 2020 2020 2020 2020 2020 2041 2053 6d61 A Sma │ │ │ │ │ -00004510: 6c6c 2048 656c 6c6f 2057 6f72 6c64 2050 ll Hello World P │ │ │ │ │ -00004520: 6163 6b61 6765 0a0a 1f0a 4669 6c65 3a20 ackage....File: │ │ │ │ │ -00004530: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -00004540: 666f 2c20 204e 6f64 653a 2047 4e55 2042 fo, Node: GNU B │ │ │ │ │ -00004550: 7569 6c64 2053 7973 7465 6d2c 2020 4e65 uild System, Ne │ │ │ │ │ -00004560: 7874 3a20 5573 6520 4361 7365 732c 2020 xt: Use Cases, │ │ │ │ │ -00004570: 5570 3a20 4175 746f 746f 6f6c 7320 496e Up: Autotools In │ │ │ │ │ -00004580: 7472 6f64 7563 7469 6f6e 0a0a 322e 3120 troduction..2.1 │ │ │ │ │ -00004590: 496e 7472 6f64 7563 696e 6720 7468 6520 Introducing the │ │ │ │ │ -000045a0: 474e 5520 4275 696c 6420 5379 7374 656d GNU Build System │ │ │ │ │ -000045b0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +00004090: 2a2a 0a0a 4966 2079 6f75 2061 7265 206e **..If you are n │ │ │ │ │ +000040a0: 6577 2074 6f20 4175 746f 6d61 6b65 2c20 ew to Automake, │ │ │ │ │ +000040b0: 6d61 7962 6520 796f 7520 6b6e 6f77 2074 maybe you know t │ │ │ │ │ +000040c0: 6861 7420 6974 2069 7320 7061 7274 206f hat it is part o │ │ │ │ │ +000040d0: 6620 6120 7365 7420 6f66 0a74 6f6f 6c73 f a set of.tools │ │ │ │ │ +000040e0: 2063 616c 6c65 6420 5f54 6865 2041 7574 called _The Aut │ │ │ │ │ +000040f0: 6f74 6f6f 6c73 5f2e 2020 4d61 7962 6520 otools_. Maybe │ │ │ │ │ +00004100: 796f 7527 7665 2061 6c72 6561 6479 2064 you've already d │ │ │ │ │ +00004110: 656c 7665 6420 696e 746f 2061 0a70 6163 elved into a.pac │ │ │ │ │ +00004120: 6b61 6765 2066 756c 6c20 6f66 2066 696c kage full of fil │ │ │ │ │ +00004130: 6573 206e 616d 6564 2027 636f 6e66 6967 es named 'config │ │ │ │ │ +00004140: 7572 6527 2c20 2763 6f6e 6669 6775 7265 ure', 'configure │ │ │ │ │ +00004150: 2e61 6327 2c20 274d 616b 6566 696c 652e .ac', 'Makefile. │ │ │ │ │ +00004160: 696e 272c 0a27 4d61 6b65 6669 6c65 2e61 in',.'Makefile.a │ │ │ │ │ +00004170: 6d27 2c20 2761 636c 6f63 616c 2e6d 3427 m', 'aclocal.m4' │ │ │ │ │ +00004180: 2c20 2e2e 2e2c 2073 6f6d 6520 6f66 2074 , ..., some of t │ │ │ │ │ +00004190: 6865 6d20 636c 6169 6d69 6e67 2074 6f20 hem claiming to │ │ │ │ │ +000041a0: 6265 205f 6765 6e65 7261 7465 640a 6279 be _generated.by │ │ │ │ │ +000041b0: 5f20 4175 746f 636f 6e66 206f 7220 4175 _ Autoconf or Au │ │ │ │ │ +000041c0: 746f 6d61 6b65 2e20 2042 7574 2074 6865 tomake. But the │ │ │ │ │ +000041d0: 2065 7861 6374 2070 7572 706f 7365 206f exact purpose o │ │ │ │ │ +000041e0: 6620 7468 6573 6520 6669 6c65 7320 616e f these files an │ │ │ │ │ +000041f0: 640a 7468 6569 7220 7265 6c61 7469 6f6e d.their relation │ │ │ │ │ +00004200: 7320 6973 2070 726f 6261 626c 7920 6675 s is probably fu │ │ │ │ │ +00004210: 7a7a 792e 2020 5468 6520 676f 616c 206f zzy. The goal o │ │ │ │ │ +00004220: 6620 7468 6973 2063 6861 7074 6572 2069 f this chapter i │ │ │ │ │ +00004230: 7320 746f 0a69 6e74 726f 6475 6365 2079 s to.introduce y │ │ │ │ │ +00004240: 6f75 2074 6f20 7468 6973 206d 6163 6869 ou to this machi │ │ │ │ │ +00004250: 6e65 7279 2c20 746f 2073 686f 7720 796f nery, to show yo │ │ │ │ │ +00004260: 7520 686f 7720 6974 2077 6f72 6b73 2061 u how it works a │ │ │ │ │ +00004270: 6e64 2068 6f77 0a70 6f77 6572 6675 6c20 nd how.powerful │ │ │ │ │ +00004280: 6974 2069 732e 2020 4966 2079 6f75 2776 it is. If you'v │ │ │ │ │ +00004290: 6520 6e65 7665 7220 696e 7374 616c 6c65 e never installe │ │ │ │ │ +000042a0: 6420 6f72 2073 6565 6e20 7375 6368 2061 d or seen such a │ │ │ │ │ +000042b0: 2070 6163 6b61 6765 2c20 646f 0a6e 6f74 package, do.not │ │ │ │ │ +000042c0: 2077 6f72 7279 3a20 7468 6973 2063 6861 worry: this cha │ │ │ │ │ +000042d0: 7074 6572 2077 696c 6c20 7761 6c6b 2079 pter will walk y │ │ │ │ │ +000042e0: 6f75 2074 6872 6f75 6768 2069 742e 0a0a ou through it... │ │ │ │ │ +000042f0: 2020 2049 6620 796f 7520 6e65 6564 2073 If you need s │ │ │ │ │ +00004300: 6f6d 6520 7465 6163 6869 6e67 206d 6174 ome teaching mat │ │ │ │ │ +00004310: 6572 6961 6c2c 206d 6f72 6520 696c 6c75 erial, more illu │ │ │ │ │ +00004320: 7374 7261 7469 6f6e 732c 206f 7220 6120 strations, or a │ │ │ │ │ +00004330: 6c65 7373 0a27 6175 746f 6d61 6b65 272d less.'automake'- │ │ │ │ │ +00004340: 6365 6e74 6572 6564 2063 6f6e 7469 6e75 centered continu │ │ │ │ │ +00004350: 6174 696f 6e2c 2073 6f6d 6520 736c 6964 ation, some slid │ │ │ │ │ +00004360: 6573 2066 6f72 2074 6869 7320 696e 7472 es for this intr │ │ │ │ │ +00004370: 6f64 7563 7469 6f6e 2061 7265 0a61 7661 oduction are.ava │ │ │ │ │ +00004380: 696c 6162 6c65 2069 6e20 416c 6578 616e ilable in Alexan │ │ │ │ │ +00004390: 6472 6520 4475 7265 742d 4c75 747a 2773 dre Duret-Lutz's │ │ │ │ │ +000043a0: 2041 7574 6f74 6f6f 6c73 2054 7574 6f72 Autotools Tutor │ │ │ │ │ +000043b0: 6961 6c0a 2868 7474 703a 2f2f 7777 772e ial.(http://www. │ │ │ │ │ +000043c0: 6c72 6465 2e65 7069 7461 2e66 722f 7e61 lrde.epita.fr/~a │ │ │ │ │ +000043d0: 646c 2f61 7574 6f74 6f6f 6c73 2e68 746d dl/autotools.htm │ │ │ │ │ +000043e0: 6c29 2e20 2054 6869 7320 6368 6170 7465 l). This chapte │ │ │ │ │ +000043f0: 7220 6973 2074 6865 0a77 7269 7474 656e r is the.written │ │ │ │ │ +00004400: 2076 6572 7369 6f6e 206f 6620 7468 6520 version of the │ │ │ │ │ +00004410: 6669 7273 7420 7061 7274 206f 6620 6869 first part of hi │ │ │ │ │ +00004420: 7320 7475 746f 7269 616c 2e0a 0a2a 204d s tutorial...* M │ │ │ │ │ +00004430: 656e 753a 0a0a 2a20 474e 5520 4275 696c enu:..* GNU Buil │ │ │ │ │ +00004440: 6420 5379 7374 656d 3a3a 2020 2020 2020 d System:: │ │ │ │ │ +00004450: 2020 2020 2020 496e 7472 6f64 7563 696e Introducin │ │ │ │ │ +00004460: 6720 7468 6520 474e 5520 4275 696c 6420 g the GNU Build │ │ │ │ │ +00004470: 5379 7374 656d 0a2a 2055 7365 2043 6173 System.* Use Cas │ │ │ │ │ +00004480: 6573 3a3a 2020 2020 2020 2020 2020 2020 es:: │ │ │ │ │ +00004490: 2020 2020 2020 2055 7365 2043 6173 6573 Use Cases │ │ │ │ │ +000044a0: 2066 6f72 2074 6865 2047 4e55 2042 7569 for the GNU Bui │ │ │ │ │ +000044b0: 6c64 2053 7973 7465 6d0a 2a20 5768 7920 ld System.* Why │ │ │ │ │ +000044c0: 4175 746f 746f 6f6c 733a 3a20 2020 2020 Autotools:: │ │ │ │ │ +000044d0: 2020 2020 2020 2020 2020 486f 7720 4175 How Au │ │ │ │ │ +000044e0: 746f 746f 6f6c 7320 4865 6c70 0a2a 2048 totools Help.* H │ │ │ │ │ +000044f0: 656c 6c6f 2057 6f72 6c64 3a3a 2020 2020 ello World:: │ │ │ │ │ +00004500: 2020 2020 2020 2020 2020 2020 2041 2053 A S │ │ │ │ │ +00004510: 6d61 6c6c 2048 656c 6c6f 2057 6f72 6c64 mall Hello World │ │ │ │ │ +00004520: 2050 6163 6b61 6765 0a0a 1f0a 4669 6c65 Package....File │ │ │ │ │ +00004530: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +00004540: 696e 666f 2c20 204e 6f64 653a 2047 4e55 info, Node: GNU │ │ │ │ │ +00004550: 2042 7569 6c64 2053 7973 7465 6d2c 2020 Build System, │ │ │ │ │ +00004560: 4e65 7874 3a20 5573 6520 4361 7365 732c Next: Use Cases, │ │ │ │ │ +00004570: 2020 5570 3a20 4175 746f 746f 6f6c 7320 Up: Autotools │ │ │ │ │ +00004580: 496e 7472 6f64 7563 7469 6f6e 0a0a 322e Introduction..2. │ │ │ │ │ +00004590: 3120 496e 7472 6f64 7563 696e 6720 7468 1 Introducing th │ │ │ │ │ +000045a0: 6520 474e 5520 4275 696c 6420 5379 7374 e GNU Build Syst │ │ │ │ │ +000045b0: 656d 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d em.============= │ │ │ │ │ 000045c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000045d0: 3d3d 3d3d 3d0a 0a49 7420 6973 2061 2074 =====..It is a t │ │ │ │ │ -000045e0: 7275 7468 2075 6e69 7665 7273 616c 6c79 ruth universally │ │ │ │ │ -000045f0: 2061 636b 6e6f 776c 6564 6765 642c 2074 acknowledged, t │ │ │ │ │ -00004600: 6861 7420 6173 2061 2064 6576 656c 6f70 hat as a develop │ │ │ │ │ -00004610: 6572 2069 6e0a 706f 7373 6573 7369 6f6e er in.possession │ │ │ │ │ -00004620: 206f 6620 6120 6e65 7720 7061 636b 6167 of a new packag │ │ │ │ │ -00004630: 652c 2079 6f75 206d 7573 7420 6265 2069 e, you must be i │ │ │ │ │ -00004640: 6e20 7761 6e74 206f 6620 6120 6275 696c n want of a buil │ │ │ │ │ -00004650: 6420 7379 7374 656d 2e0a 0a20 2020 496e d system... In │ │ │ │ │ -00004660: 2074 6865 2055 6e69 7820 776f 726c 642c the Unix world, │ │ │ │ │ -00004670: 2073 7563 6820 6120 6275 696c 6420 7379 such a build sy │ │ │ │ │ -00004680: 7374 656d 2069 7320 7472 6164 6974 696f stem is traditio │ │ │ │ │ -00004690: 6e61 6c6c 7920 6163 6869 6576 6564 0a75 nally achieved.u │ │ │ │ │ -000046a0: 7369 6e67 2074 6865 2063 6f6d 6d61 6e64 sing the command │ │ │ │ │ -000046b0: 2027 6d61 6b65 2720 282a 6e6f 7465 204f 'make' (*note O │ │ │ │ │ -000046c0: 7665 7276 6965 773a 2028 6d61 6b65 2954 verview: (make)T │ │ │ │ │ -000046d0: 6f70 2e29 2e20 2059 6f75 2065 7870 7265 op.). You expre │ │ │ │ │ -000046e0: 7373 2074 6865 0a72 6563 6970 6520 746f ss the.recipe to │ │ │ │ │ -000046f0: 2062 7569 6c64 2079 6f75 7220 7061 636b build your pack │ │ │ │ │ -00004700: 6167 6520 696e 2061 2027 4d61 6b65 6669 age in a 'Makefi │ │ │ │ │ -00004710: 6c65 272e 2020 5468 6973 2066 696c 6520 le'. This file │ │ │ │ │ -00004720: 6973 2061 2073 6574 206f 660a 7275 6c65 is a set of.rule │ │ │ │ │ -00004730: 7320 746f 2062 7569 6c64 2074 6865 2066 s to build the f │ │ │ │ │ -00004740: 696c 6573 2069 6e20 7468 6520 7061 636b iles in the pack │ │ │ │ │ -00004750: 6167 652e 2020 466f 7220 696e 7374 616e age. For instan │ │ │ │ │ -00004760: 6365 2074 6865 2070 726f 6772 616d 0a27 ce the program.' │ │ │ │ │ -00004770: 7072 6f67 2720 6d61 7920 6265 2062 7569 prog' may be bui │ │ │ │ │ -00004780: 6c74 2062 7920 7275 6e6e 696e 6720 7468 lt by running th │ │ │ │ │ -00004790: 6520 6c69 6e6b 6572 206f 6e20 7468 6520 e linker on the │ │ │ │ │ -000047a0: 6669 6c65 7320 276d 6169 6e2e 6f27 2c0a files 'main.o',. │ │ │ │ │ -000047b0: 2766 6f6f 2e6f 272c 2061 6e64 2027 6261 'foo.o', and 'ba │ │ │ │ │ -000047c0: 722e 6f27 3b20 7468 6520 6669 6c65 2027 r.o'; the file ' │ │ │ │ │ -000047d0: 6d61 696e 2e6f 2720 6d61 7920 6265 2062 main.o' may be b │ │ │ │ │ -000047e0: 7569 6c74 2062 7920 7275 6e6e 696e 6720 uilt by running │ │ │ │ │ -000047f0: 7468 650a 636f 6d70 696c 6572 206f 6e20 the.compiler on │ │ │ │ │ -00004800: 276d 6169 6e2e 6327 3b20 6574 632e 2020 'main.c'; etc. │ │ │ │ │ -00004810: 4561 6368 2074 696d 6520 276d 616b 6527 Each time 'make' │ │ │ │ │ -00004820: 2069 7320 7275 6e2c 2069 7420 7265 6164 is run, it read │ │ │ │ │ -00004830: 730a 274d 616b 6566 696c 6527 2c20 6368 s.'Makefile', ch │ │ │ │ │ -00004840: 6563 6b73 2074 6865 2065 7869 7374 656e ecks the existen │ │ │ │ │ -00004850: 6365 2061 6e64 206d 6f64 6966 6963 6174 ce and modificat │ │ │ │ │ -00004860: 696f 6e20 7469 6d65 206f 6620 7468 6520 ion time of the │ │ │ │ │ -00004870: 6669 6c65 730a 6d65 6e74 696f 6e65 642c files.mentioned, │ │ │ │ │ -00004880: 2064 6563 6964 6573 2077 6861 7420 6669 decides what fi │ │ │ │ │ -00004890: 6c65 7320 6e65 6564 2074 6f20 6265 2062 les need to be b │ │ │ │ │ -000048a0: 7569 6c74 2028 6f72 2072 6562 7569 6c74 uilt (or rebuilt │ │ │ │ │ -000048b0: 292c 2061 6e64 2072 756e 730a 7468 6520 ), and runs.the │ │ │ │ │ -000048c0: 6173 736f 6369 6174 6564 2063 6f6d 6d61 associated comma │ │ │ │ │ -000048d0: 6e64 732e 0a0a 2020 2057 6865 6e20 6120 nds... When a │ │ │ │ │ -000048e0: 7061 636b 6167 6520 6e65 6564 7320 746f package needs to │ │ │ │ │ -000048f0: 2062 6520 6275 696c 7420 6f6e 2061 2064 be built on a d │ │ │ │ │ -00004900: 6966 6665 7265 6e74 2070 6c61 7466 6f72 ifferent platfor │ │ │ │ │ -00004910: 6d20 7468 616e 2074 6865 206f 6e65 0a69 m than the one.i │ │ │ │ │ -00004920: 7420 7761 7320 6465 7665 6c6f 7065 6420 t was developed │ │ │ │ │ -00004930: 6f6e 2c20 6974 7320 274d 616b 6566 696c on, its 'Makefil │ │ │ │ │ -00004940: 6527 2075 7375 616c 6c79 206e 6565 6473 e' usually needs │ │ │ │ │ -00004950: 2074 6f20 6265 2061 646a 7573 7465 642e to be adjusted. │ │ │ │ │ -00004960: 2020 466f 720a 696e 7374 616e 6365 2074 For.instance t │ │ │ │ │ -00004970: 6865 2063 6f6d 7069 6c65 7220 6d61 7920 he compiler may │ │ │ │ │ -00004980: 6861 7665 2061 6e6f 7468 6572 206e 616d have another nam │ │ │ │ │ -00004990: 6520 6f72 2072 6571 7569 7265 206d 6f72 e or require mor │ │ │ │ │ -000049a0: 6520 6f70 7469 6f6e 732e 2020 496e 0a31 e options. In.1 │ │ │ │ │ -000049b0: 3939 312c 2044 6176 6964 204a 2e20 4d61 991, David J. Ma │ │ │ │ │ -000049c0: 634b 656e 7a69 6520 676f 7420 7469 7265 cKenzie got tire │ │ │ │ │ -000049d0: 6420 6f66 2063 7573 746f 6d69 7a69 6e67 d of customizing │ │ │ │ │ -000049e0: 2027 4d61 6b65 6669 6c65 2720 666f 7220 'Makefile' for │ │ │ │ │ -000049f0: 7468 6520 3230 0a70 6c61 7466 6f72 6d73 the 20.platforms │ │ │ │ │ -00004a00: 2068 6520 6861 6420 746f 2064 6561 6c20 he had to deal │ │ │ │ │ -00004a10: 7769 7468 2e20 2049 6e73 7465 6164 2c20 with. Instead, │ │ │ │ │ -00004a20: 6865 2068 616e 6463 7261 6674 6564 2061 he handcrafted a │ │ │ │ │ -00004a30: 206c 6974 746c 6520 7368 656c 6c0a 7363 little shell.sc │ │ │ │ │ -00004a40: 7269 7074 2063 616c 6c65 6420 2763 6f6e ript called 'con │ │ │ │ │ -00004a50: 6669 6775 7265 2720 746f 2061 7574 6f6d figure' to autom │ │ │ │ │ -00004a60: 6174 6963 616c 6c79 2061 646a 7573 7420 atically adjust │ │ │ │ │ -00004a70: 7468 6520 274d 616b 6566 696c 6527 2028 the 'Makefile' ( │ │ │ │ │ -00004a80: 2a6e 6f74 650a 4765 6e65 7369 733a 2028 *note.Genesis: ( │ │ │ │ │ -00004a90: 6175 746f 636f 6e66 2947 656e 6573 6973 autoconf)Genesis │ │ │ │ │ -00004aa0: 2e29 2e20 2043 6f6d 7069 6c69 6e67 2068 .). Compiling h │ │ │ │ │ -00004ab0: 6973 2070 6163 6b61 6765 2077 6173 206e is package was n │ │ │ │ │ -00004ac0: 6f77 2061 7320 7369 6d70 6c65 0a61 7320 ow as simple.as │ │ │ │ │ -00004ad0: 7275 6e6e 696e 6720 272e 2f63 6f6e 6669 running './confi │ │ │ │ │ -00004ae0: 6775 7265 2026 2620 6d61 6b65 272e 0a0a gure && make'... │ │ │ │ │ -00004af0: 2020 2054 6f64 6179 2074 6869 7320 7072 Today this pr │ │ │ │ │ -00004b00: 6f63 6573 7320 6861 7320 6265 656e 2073 ocess has been s │ │ │ │ │ -00004b10: 7461 6e64 6172 6469 7a65 6420 696e 2074 tandardized in t │ │ │ │ │ -00004b20: 6865 2047 4e55 2070 726f 6a65 6374 2e20 he GNU project. │ │ │ │ │ -00004b30: 2054 6865 2047 4e55 0a43 6f64 696e 6720 The GNU.Coding │ │ │ │ │ -00004b40: 5374 616e 6461 7264 7320 282a 6e6f 7465 Standards (*note │ │ │ │ │ -00004b50: 2054 6865 2052 656c 6561 7365 2050 726f The Release Pro │ │ │ │ │ -00004b60: 6365 7373 3a20 2873 7461 6e64 6172 6473 cess: (standards │ │ │ │ │ -00004b70: 294d 616e 6167 696e 670a 5265 6c65 6173 )Managing.Releas │ │ │ │ │ -00004b80: 6573 2e29 2065 7870 6c61 696e 7320 686f es.) explains ho │ │ │ │ │ -00004b90: 7720 6561 6368 2070 6163 6b61 6765 206f w each package o │ │ │ │ │ -00004ba0: 6620 7468 6520 474e 5520 7072 6f6a 6563 f the GNU projec │ │ │ │ │ -00004bb0: 7420 7368 6f75 6c64 2068 6176 6520 610a t should have a. │ │ │ │ │ -00004bc0: 2763 6f6e 6669 6775 7265 2720 7363 7269 'configure' scri │ │ │ │ │ -00004bd0: 7074 2c20 616e 6420 7468 6520 6d69 6e69 pt, and the mini │ │ │ │ │ -00004be0: 6d61 6c20 696e 7465 7266 6163 6520 6974 mal interface it │ │ │ │ │ -00004bf0: 2073 686f 756c 6420 6861 7665 2e20 2054 should have. T │ │ │ │ │ -00004c00: 6865 0a27 4d61 6b65 6669 6c65 2720 746f he.'Makefile' to │ │ │ │ │ -00004c10: 6f20 7368 6f75 6c64 2066 6f6c 6c6f 7720 o should follow │ │ │ │ │ -00004c20: 736f 6d65 2065 7374 6162 6c69 7368 6564 some established │ │ │ │ │ -00004c30: 2063 6f6e 7665 6e74 696f 6e73 2e20 2054 conventions. T │ │ │ │ │ -00004c40: 6865 2072 6573 756c 743f 0a41 2075 6e69 he result?.A uni │ │ │ │ │ -00004c50: 6669 6564 2062 7569 6c64 2073 7973 7465 fied build syste │ │ │ │ │ -00004c60: 6d20 7468 6174 206d 616b 6573 2061 6c6c m that makes all │ │ │ │ │ -00004c70: 2070 6163 6b61 6765 7320 616c 6d6f 7374 packages almost │ │ │ │ │ -00004c80: 2069 6e64 6973 7469 6e67 7569 7368 6162 indistinguishab │ │ │ │ │ -00004c90: 6c65 0a62 7920 7468 6520 696e 7374 616c le.by the instal │ │ │ │ │ -00004ca0: 6c65 722e 2020 496e 2069 7473 2073 696d ler. In its sim │ │ │ │ │ -00004cb0: 706c 6573 7420 7363 656e 6172 696f 2c20 plest scenario, │ │ │ │ │ -00004cc0: 616c 6c20 7468 6520 696e 7374 616c 6c65 all the installe │ │ │ │ │ -00004cd0: 7220 6861 7320 746f 2064 6f0a 6973 2074 r has to do.is t │ │ │ │ │ -00004ce0: 6f20 756e 7061 636b 2074 6865 2070 6163 o unpack the pac │ │ │ │ │ -00004cf0: 6b61 6765 2c20 7275 6e20 272e 2f63 6f6e kage, run './con │ │ │ │ │ -00004d00: 6669 6775 7265 2026 2620 6d61 6b65 2026 figure && make & │ │ │ │ │ -00004d10: 2620 6d61 6b65 2069 6e73 7461 6c6c 272c & make install', │ │ │ │ │ -00004d20: 2061 6e64 0a72 6570 6561 7420 7769 7468 and.repeat with │ │ │ │ │ -00004d30: 2074 6865 206e 6578 7420 7061 636b 6167 the next packag │ │ │ │ │ -00004d40: 6520 746f 2069 6e73 7461 6c6c 2e0a 0a20 e to install... │ │ │ │ │ -00004d50: 2020 5765 2063 616c 6c20 7468 6973 2062 We call this b │ │ │ │ │ -00004d60: 7569 6c64 2073 7973 7465 6d20 7468 6520 uild system the │ │ │ │ │ -00004d70: 2247 4e55 2042 7569 6c64 2053 7973 7465 "GNU Build Syste │ │ │ │ │ -00004d80: 6d22 2c20 7369 6e63 6520 6974 2077 6173 m", since it was │ │ │ │ │ -00004d90: 2067 726f 776e 0a6f 7574 206f 6620 7468 grown.out of th │ │ │ │ │ -00004da0: 6520 474e 5520 7072 6f6a 6563 742e 2020 e GNU project. │ │ │ │ │ -00004db0: 486f 7765 7665 7220 6974 2069 7320 7573 However it is us │ │ │ │ │ -00004dc0: 6564 2062 7920 6120 7661 7374 206e 756d ed by a vast num │ │ │ │ │ -00004dd0: 6265 7220 6f66 206f 7468 6572 0a70 6163 ber of other.pac │ │ │ │ │ -00004de0: 6b61 6765 733a 2066 6f6c 6c6f 7769 6e67 kages: following │ │ │ │ │ -00004df0: 2061 6e79 2065 7869 7374 696e 6720 636f any existing co │ │ │ │ │ -00004e00: 6e76 656e 7469 6f6e 2068 6173 2069 7473 nvention has its │ │ │ │ │ -00004e10: 2061 6476 616e 7461 6765 732e 0a0a 2020 advantages... │ │ │ │ │ -00004e20: 2054 6865 2041 7574 6f74 6f6f 6c73 2061 The Autotools a │ │ │ │ │ -00004e30: 7265 2074 6f6f 6c73 2074 6861 7420 7769 re tools that wi │ │ │ │ │ -00004e40: 6c6c 2063 7265 6174 6520 6120 474e 5520 ll create a GNU │ │ │ │ │ -00004e50: 4275 696c 6420 5379 7374 656d 2066 6f72 Build System for │ │ │ │ │ -00004e60: 2079 6f75 720a 7061 636b 6167 652e 2020 your.package. │ │ │ │ │ -00004e70: 4175 746f 636f 6e66 206d 6f73 746c 7920 Autoconf mostly │ │ │ │ │ -00004e80: 666f 6375 7365 7320 6f6e 2027 636f 6e66 focuses on 'conf │ │ │ │ │ -00004e90: 6967 7572 6527 2061 6e64 2041 7574 6f6d igure' and Autom │ │ │ │ │ -00004ea0: 616b 6520 6f6e 0a27 4d61 6b65 6669 6c65 ake on.'Makefile │ │ │ │ │ -00004eb0: 2773 2e20 2049 7420 6973 2065 6e74 6972 's. It is entir │ │ │ │ │ -00004ec0: 656c 7920 706f 7373 6962 6c65 2074 6f20 ely possible to │ │ │ │ │ -00004ed0: 6372 6561 7465 2061 2047 4e55 2042 7569 create a GNU Bui │ │ │ │ │ -00004ee0: 6c64 2053 7973 7465 6d0a 7769 7468 6f75 ld System.withou │ │ │ │ │ -00004ef0: 7420 7468 6520 6865 6c70 206f 6620 7468 t the help of th │ │ │ │ │ -00004f00: 6573 6520 746f 6f6c 732e 2020 486f 7765 ese tools. Howe │ │ │ │ │ -00004f10: 7665 7220 6974 2069 7320 7261 7468 6572 ver it is rather │ │ │ │ │ -00004f20: 2062 7572 6465 6e73 6f6d 6520 616e 640a burdensome and. │ │ │ │ │ -00004f30: 6572 726f 722d 7072 6f6e 652e 2020 5765 error-prone. We │ │ │ │ │ -00004f40: 2077 696c 6c20 6469 7363 7573 7320 7468 will discuss th │ │ │ │ │ -00004f50: 6973 2061 6761 696e 2061 6674 6572 2073 is again after s │ │ │ │ │ -00004f60: 6f6d 6520 696c 6c75 7374 7261 7469 6f6e ome illustration │ │ │ │ │ -00004f70: 206f 6620 7468 650a 474e 5520 4275 696c of the.GNU Buil │ │ │ │ │ -00004f80: 6420 5379 7374 656d 2069 6e20 6163 7469 d System in acti │ │ │ │ │ -00004f90: 6f6e 2e0a 0a1f 0a46 696c 653a 2061 7574 on.....File: aut │ │ │ │ │ -00004fa0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -00004fb0: 2020 4e6f 6465 3a20 5573 6520 4361 7365 Node: Use Case │ │ │ │ │ -00004fc0: 732c 2020 4e65 7874 3a20 5768 7920 4175 s, Next: Why Au │ │ │ │ │ -00004fd0: 746f 746f 6f6c 732c 2020 5072 6576 3a20 totools, Prev: │ │ │ │ │ -00004fe0: 474e 5520 4275 696c 6420 5379 7374 656d GNU Build System │ │ │ │ │ -00004ff0: 2c20 2055 703a 2041 7574 6f74 6f6f 6c73 , Up: Autotools │ │ │ │ │ -00005000: 2049 6e74 726f 6475 6374 696f 6e0a 0a32 Introduction..2 │ │ │ │ │ -00005010: 2e32 2055 7365 2043 6173 6573 2066 6f72 .2 Use Cases for │ │ │ │ │ -00005020: 2074 6865 2047 4e55 2042 7569 6c64 2053 the GNU Build S │ │ │ │ │ -00005030: 7973 7465 6d0a 3d3d 3d3d 3d3d 3d3d 3d3d ystem.========== │ │ │ │ │ +000045d0: 3d3d 3d3d 3d3d 3d0a 0a49 7420 6973 2061 =======..It is a │ │ │ │ │ +000045e0: 2074 7275 7468 2075 6e69 7665 7273 616c truth universal │ │ │ │ │ +000045f0: 6c79 2061 636b 6e6f 776c 6564 6765 642c ly acknowledged, │ │ │ │ │ +00004600: 2074 6861 7420 6173 2061 2064 6576 656c that as a devel │ │ │ │ │ +00004610: 6f70 6572 2069 6e0a 706f 7373 6573 7369 oper in.possessi │ │ │ │ │ +00004620: 6f6e 206f 6620 6120 6e65 7720 7061 636b on of a new pack │ │ │ │ │ +00004630: 6167 652c 2079 6f75 206d 7573 7420 6265 age, you must be │ │ │ │ │ +00004640: 2069 6e20 7761 6e74 206f 6620 6120 6275 in want of a bu │ │ │ │ │ +00004650: 696c 6420 7379 7374 656d 2e0a 0a20 2020 ild system... │ │ │ │ │ +00004660: 496e 2074 6865 2055 6e69 7820 776f 726c In the Unix worl │ │ │ │ │ +00004670: 642c 2073 7563 6820 6120 6275 696c 6420 d, such a build │ │ │ │ │ +00004680: 7379 7374 656d 2069 7320 7472 6164 6974 system is tradit │ │ │ │ │ +00004690: 696f 6e61 6c6c 7920 6163 6869 6576 6564 ionally achieved │ │ │ │ │ +000046a0: 0a75 7369 6e67 2074 6865 2063 6f6d 6d61 .using the comma │ │ │ │ │ +000046b0: 6e64 2027 6d61 6b65 2720 282a 6e6f 7465 nd 'make' (*note │ │ │ │ │ +000046c0: 204f 7665 7276 6965 773a 2028 6d61 6b65 Overview: (make │ │ │ │ │ +000046d0: 2954 6f70 2e29 2e20 2059 6f75 2065 7870 )Top.). You exp │ │ │ │ │ +000046e0: 7265 7373 2074 6865 0a72 6563 6970 6520 ress the.recipe │ │ │ │ │ +000046f0: 746f 2062 7569 6c64 2079 6f75 7220 7061 to build your pa │ │ │ │ │ +00004700: 636b 6167 6520 696e 2061 2027 4d61 6b65 ckage in a 'Make │ │ │ │ │ +00004710: 6669 6c65 272e 2020 5468 6973 2066 696c file'. This fil │ │ │ │ │ +00004720: 6520 6973 2061 2073 6574 206f 660a 7275 e is a set of.ru │ │ │ │ │ +00004730: 6c65 7320 746f 2062 7569 6c64 2074 6865 les to build the │ │ │ │ │ +00004740: 2066 696c 6573 2069 6e20 7468 6520 7061 files in the pa │ │ │ │ │ +00004750: 636b 6167 652e 2020 466f 7220 696e 7374 ckage. For inst │ │ │ │ │ +00004760: 616e 6365 2074 6865 2070 726f 6772 616d ance the program │ │ │ │ │ +00004770: 0a27 7072 6f67 2720 6d61 7920 6265 2062 .'prog' may be b │ │ │ │ │ +00004780: 7569 6c74 2062 7920 7275 6e6e 696e 6720 uilt by running │ │ │ │ │ +00004790: 7468 6520 6c69 6e6b 6572 206f 6e20 7468 the linker on th │ │ │ │ │ +000047a0: 6520 6669 6c65 7320 276d 6169 6e2e 6f27 e files 'main.o' │ │ │ │ │ +000047b0: 2c0a 2766 6f6f 2e6f 272c 2061 6e64 2027 ,.'foo.o', and ' │ │ │ │ │ +000047c0: 6261 722e 6f27 3b20 7468 6520 6669 6c65 bar.o'; the file │ │ │ │ │ +000047d0: 2027 6d61 696e 2e6f 2720 6d61 7920 6265 'main.o' may be │ │ │ │ │ +000047e0: 2062 7569 6c74 2062 7920 7275 6e6e 696e built by runnin │ │ │ │ │ +000047f0: 6720 7468 650a 636f 6d70 696c 6572 206f g the.compiler o │ │ │ │ │ +00004800: 6e20 276d 6169 6e2e 6327 3b20 6574 632e n 'main.c'; etc. │ │ │ │ │ +00004810: 2020 4561 6368 2074 696d 6520 276d 616b Each time 'mak │ │ │ │ │ +00004820: 6527 2069 7320 7275 6e2c 2069 7420 7265 e' is run, it re │ │ │ │ │ +00004830: 6164 730a 274d 616b 6566 696c 6527 2c20 ads.'Makefile', │ │ │ │ │ +00004840: 6368 6563 6b73 2074 6865 2065 7869 7374 checks the exist │ │ │ │ │ +00004850: 656e 6365 2061 6e64 206d 6f64 6966 6963 ence and modific │ │ │ │ │ +00004860: 6174 696f 6e20 7469 6d65 206f 6620 7468 ation time of th │ │ │ │ │ +00004870: 6520 6669 6c65 730a 6d65 6e74 696f 6e65 e files.mentione │ │ │ │ │ +00004880: 642c 2064 6563 6964 6573 2077 6861 7420 d, decides what │ │ │ │ │ +00004890: 6669 6c65 7320 6e65 6564 2074 6f20 6265 files need to be │ │ │ │ │ +000048a0: 2062 7569 6c74 2028 6f72 2072 6562 7569 built (or rebui │ │ │ │ │ +000048b0: 6c74 292c 2061 6e64 2072 756e 730a 7468 lt), and runs.th │ │ │ │ │ +000048c0: 6520 6173 736f 6369 6174 6564 2063 6f6d e associated com │ │ │ │ │ +000048d0: 6d61 6e64 732e 0a0a 2020 2057 6865 6e20 mands... When │ │ │ │ │ +000048e0: 6120 7061 636b 6167 6520 6e65 6564 7320 a package needs │ │ │ │ │ +000048f0: 746f 2062 6520 6275 696c 7420 6f6e 2061 to be built on a │ │ │ │ │ +00004900: 2064 6966 6665 7265 6e74 2070 6c61 7466 different platf │ │ │ │ │ +00004910: 6f72 6d20 7468 616e 2074 6865 206f 6e65 orm than the one │ │ │ │ │ +00004920: 0a69 7420 7761 7320 6465 7665 6c6f 7065 .it was develope │ │ │ │ │ +00004930: 6420 6f6e 2c20 6974 7320 274d 616b 6566 d on, its 'Makef │ │ │ │ │ +00004940: 696c 6527 2075 7375 616c 6c79 206e 6565 ile' usually nee │ │ │ │ │ +00004950: 6473 2074 6f20 6265 2061 646a 7573 7465 ds to be adjuste │ │ │ │ │ +00004960: 642e 2020 466f 720a 696e 7374 616e 6365 d. For.instance │ │ │ │ │ +00004970: 2074 6865 2063 6f6d 7069 6c65 7220 6d61 the compiler ma │ │ │ │ │ +00004980: 7920 6861 7665 2061 6e6f 7468 6572 206e y have another n │ │ │ │ │ +00004990: 616d 6520 6f72 2072 6571 7569 7265 206d ame or require m │ │ │ │ │ +000049a0: 6f72 6520 6f70 7469 6f6e 732e 2020 496e ore options. In │ │ │ │ │ +000049b0: 0a31 3939 312c 2044 6176 6964 204a 2e20 .1991, David J. │ │ │ │ │ +000049c0: 4d61 634b 656e 7a69 6520 676f 7420 7469 MacKenzie got ti │ │ │ │ │ +000049d0: 7265 6420 6f66 2063 7573 746f 6d69 7a69 red of customizi │ │ │ │ │ +000049e0: 6e67 2027 4d61 6b65 6669 6c65 2720 666f ng 'Makefile' fo │ │ │ │ │ +000049f0: 7220 7468 6520 3230 0a70 6c61 7466 6f72 r the 20.platfor │ │ │ │ │ +00004a00: 6d73 2068 6520 6861 6420 746f 2064 6561 ms he had to dea │ │ │ │ │ +00004a10: 6c20 7769 7468 2e20 2049 6e73 7465 6164 l with. Instead │ │ │ │ │ +00004a20: 2c20 6865 2068 616e 6463 7261 6674 6564 , he handcrafted │ │ │ │ │ +00004a30: 2061 206c 6974 746c 6520 7368 656c 6c0a a little shell. │ │ │ │ │ +00004a40: 7363 7269 7074 2063 616c 6c65 6420 2763 script called 'c │ │ │ │ │ +00004a50: 6f6e 6669 6775 7265 2720 746f 2061 7574 onfigure' to aut │ │ │ │ │ +00004a60: 6f6d 6174 6963 616c 6c79 2061 646a 7573 omatically adjus │ │ │ │ │ +00004a70: 7420 7468 6520 274d 616b 6566 696c 6527 t the 'Makefile' │ │ │ │ │ +00004a80: 2028 2a6e 6f74 650a 4765 6e65 7369 733a (*note.Genesis: │ │ │ │ │ +00004a90: 2028 6175 746f 636f 6e66 2947 656e 6573 (autoconf)Genes │ │ │ │ │ +00004aa0: 6973 2e29 2e20 2043 6f6d 7069 6c69 6e67 is.). Compiling │ │ │ │ │ +00004ab0: 2068 6973 2070 6163 6b61 6765 2077 6173 his package was │ │ │ │ │ +00004ac0: 206e 6f77 2061 7320 7369 6d70 6c65 0a61 now as simple.a │ │ │ │ │ +00004ad0: 7320 7275 6e6e 696e 6720 272e 2f63 6f6e s running './con │ │ │ │ │ +00004ae0: 6669 6775 7265 2026 2620 6d61 6b65 272e figure && make'. │ │ │ │ │ +00004af0: 0a0a 2020 2054 6f64 6179 2074 6869 7320 .. Today this │ │ │ │ │ +00004b00: 7072 6f63 6573 7320 6861 7320 6265 656e process has been │ │ │ │ │ +00004b10: 2073 7461 6e64 6172 6469 7a65 6420 696e standardized in │ │ │ │ │ +00004b20: 2074 6865 2047 4e55 2070 726f 6a65 6374 the GNU project │ │ │ │ │ +00004b30: 2e20 2054 6865 2047 4e55 0a43 6f64 696e . The GNU.Codin │ │ │ │ │ +00004b40: 6720 5374 616e 6461 7264 7320 282a 6e6f g Standards (*no │ │ │ │ │ +00004b50: 7465 2054 6865 2052 656c 6561 7365 2050 te The Release P │ │ │ │ │ +00004b60: 726f 6365 7373 3a20 2873 7461 6e64 6172 rocess: (standar │ │ │ │ │ +00004b70: 6473 294d 616e 6167 696e 670a 5265 6c65 ds)Managing.Rele │ │ │ │ │ +00004b80: 6173 6573 2e29 2065 7870 6c61 696e 7320 ases.) explains │ │ │ │ │ +00004b90: 686f 7720 6561 6368 2070 6163 6b61 6765 how each package │ │ │ │ │ +00004ba0: 206f 6620 7468 6520 474e 5520 7072 6f6a of the GNU proj │ │ │ │ │ +00004bb0: 6563 7420 7368 6f75 6c64 2068 6176 6520 ect should have │ │ │ │ │ +00004bc0: 610a 2763 6f6e 6669 6775 7265 2720 7363 a.'configure' sc │ │ │ │ │ +00004bd0: 7269 7074 2c20 616e 6420 7468 6520 6d69 ript, and the mi │ │ │ │ │ +00004be0: 6e69 6d61 6c20 696e 7465 7266 6163 6520 nimal interface │ │ │ │ │ +00004bf0: 6974 2073 686f 756c 6420 6861 7665 2e20 it should have. │ │ │ │ │ +00004c00: 2054 6865 0a27 4d61 6b65 6669 6c65 2720 The.'Makefile' │ │ │ │ │ +00004c10: 746f 6f20 7368 6f75 6c64 2066 6f6c 6c6f too should follo │ │ │ │ │ +00004c20: 7720 736f 6d65 2065 7374 6162 6c69 7368 w some establish │ │ │ │ │ +00004c30: 6564 2063 6f6e 7665 6e74 696f 6e73 2e20 ed conventions. │ │ │ │ │ +00004c40: 2054 6865 2072 6573 756c 743f 0a41 2075 The result?.A u │ │ │ │ │ +00004c50: 6e69 6669 6564 2062 7569 6c64 2073 7973 nified build sys │ │ │ │ │ +00004c60: 7465 6d20 7468 6174 206d 616b 6573 2061 tem that makes a │ │ │ │ │ +00004c70: 6c6c 2070 6163 6b61 6765 7320 616c 6d6f ll packages almo │ │ │ │ │ +00004c80: 7374 2069 6e64 6973 7469 6e67 7569 7368 st indistinguish │ │ │ │ │ +00004c90: 6162 6c65 0a62 7920 7468 6520 696e 7374 able.by the inst │ │ │ │ │ +00004ca0: 616c 6c65 722e 2020 496e 2069 7473 2073 aller. In its s │ │ │ │ │ +00004cb0: 696d 706c 6573 7420 7363 656e 6172 696f implest scenario │ │ │ │ │ +00004cc0: 2c20 616c 6c20 7468 6520 696e 7374 616c , all the instal │ │ │ │ │ +00004cd0: 6c65 7220 6861 7320 746f 2064 6f0a 6973 ler has to do.is │ │ │ │ │ +00004ce0: 2074 6f20 756e 7061 636b 2074 6865 2070 to unpack the p │ │ │ │ │ +00004cf0: 6163 6b61 6765 2c20 7275 6e20 272e 2f63 ackage, run './c │ │ │ │ │ +00004d00: 6f6e 6669 6775 7265 2026 2620 6d61 6b65 onfigure && make │ │ │ │ │ +00004d10: 2026 2620 6d61 6b65 2069 6e73 7461 6c6c && make install │ │ │ │ │ +00004d20: 272c 2061 6e64 0a72 6570 6561 7420 7769 ', and.repeat wi │ │ │ │ │ +00004d30: 7468 2074 6865 206e 6578 7420 7061 636b th the next pack │ │ │ │ │ +00004d40: 6167 6520 746f 2069 6e73 7461 6c6c 2e0a age to install.. │ │ │ │ │ +00004d50: 0a20 2020 5765 2063 616c 6c20 7468 6973 . We call this │ │ │ │ │ +00004d60: 2062 7569 6c64 2073 7973 7465 6d20 7468 build system th │ │ │ │ │ +00004d70: 6520 2247 4e55 2042 7569 6c64 2053 7973 e "GNU Build Sys │ │ │ │ │ +00004d80: 7465 6d22 2c20 7369 6e63 6520 6974 2077 tem", since it w │ │ │ │ │ +00004d90: 6173 2067 726f 776e 0a6f 7574 206f 6620 as grown.out of │ │ │ │ │ +00004da0: 7468 6520 474e 5520 7072 6f6a 6563 742e the GNU project. │ │ │ │ │ +00004db0: 2020 486f 7765 7665 7220 6974 2069 7320 However it is │ │ │ │ │ +00004dc0: 7573 6564 2062 7920 6120 7661 7374 206e used by a vast n │ │ │ │ │ +00004dd0: 756d 6265 7220 6f66 206f 7468 6572 0a70 umber of other.p │ │ │ │ │ +00004de0: 6163 6b61 6765 733a 2066 6f6c 6c6f 7769 ackages: followi │ │ │ │ │ +00004df0: 6e67 2061 6e79 2065 7869 7374 696e 6720 ng any existing │ │ │ │ │ +00004e00: 636f 6e76 656e 7469 6f6e 2068 6173 2069 convention has i │ │ │ │ │ +00004e10: 7473 2061 6476 616e 7461 6765 732e 0a0a ts advantages... │ │ │ │ │ +00004e20: 2020 2054 6865 2041 7574 6f74 6f6f 6c73 The Autotools │ │ │ │ │ +00004e30: 2061 7265 2074 6f6f 6c73 2074 6861 7420 are tools that │ │ │ │ │ +00004e40: 7769 6c6c 2063 7265 6174 6520 6120 474e will create a GN │ │ │ │ │ +00004e50: 5520 4275 696c 6420 5379 7374 656d 2066 U Build System f │ │ │ │ │ +00004e60: 6f72 2079 6f75 720a 7061 636b 6167 652e or your.package. │ │ │ │ │ +00004e70: 2020 4175 746f 636f 6e66 206d 6f73 746c Autoconf mostl │ │ │ │ │ +00004e80: 7920 666f 6375 7365 7320 6f6e 2027 636f y focuses on 'co │ │ │ │ │ +00004e90: 6e66 6967 7572 6527 2061 6e64 2041 7574 nfigure' and Aut │ │ │ │ │ +00004ea0: 6f6d 616b 6520 6f6e 0a27 4d61 6b65 6669 omake on.'Makefi │ │ │ │ │ +00004eb0: 6c65 2773 2e20 2049 7420 6973 2065 6e74 le's. It is ent │ │ │ │ │ +00004ec0: 6972 656c 7920 706f 7373 6962 6c65 2074 irely possible t │ │ │ │ │ +00004ed0: 6f20 6372 6561 7465 2061 2047 4e55 2042 o create a GNU B │ │ │ │ │ +00004ee0: 7569 6c64 2053 7973 7465 6d0a 7769 7468 uild System.with │ │ │ │ │ +00004ef0: 6f75 7420 7468 6520 6865 6c70 206f 6620 out the help of │ │ │ │ │ +00004f00: 7468 6573 6520 746f 6f6c 732e 2020 486f these tools. Ho │ │ │ │ │ +00004f10: 7765 7665 7220 6974 2069 7320 7261 7468 wever it is rath │ │ │ │ │ +00004f20: 6572 2062 7572 6465 6e73 6f6d 6520 616e er burdensome an │ │ │ │ │ +00004f30: 640a 6572 726f 722d 7072 6f6e 652e 2020 d.error-prone. │ │ │ │ │ +00004f40: 5765 2077 696c 6c20 6469 7363 7573 7320 We will discuss │ │ │ │ │ +00004f50: 7468 6973 2061 6761 696e 2061 6674 6572 this again after │ │ │ │ │ +00004f60: 2073 6f6d 6520 696c 6c75 7374 7261 7469 some illustrati │ │ │ │ │ +00004f70: 6f6e 206f 6620 7468 650a 474e 5520 4275 on of the.GNU Bu │ │ │ │ │ +00004f80: 696c 6420 5379 7374 656d 2069 6e20 6163 ild System in ac │ │ │ │ │ +00004f90: 7469 6f6e 2e0a 0a1f 0a46 696c 653a 2061 tion.....File: a │ │ │ │ │ +00004fa0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +00004fb0: 6f2c 2020 4e6f 6465 3a20 5573 6520 4361 o, Node: Use Ca │ │ │ │ │ +00004fc0: 7365 732c 2020 4e65 7874 3a20 5768 7920 ses, Next: Why │ │ │ │ │ +00004fd0: 4175 746f 746f 6f6c 732c 2020 5072 6576 Autotools, Prev │ │ │ │ │ +00004fe0: 3a20 474e 5520 4275 696c 6420 5379 7374 : GNU Build Syst │ │ │ │ │ +00004ff0: 656d 2c20 2055 703a 2041 7574 6f74 6f6f em, Up: Autotoo │ │ │ │ │ +00005000: 6c73 2049 6e74 726f 6475 6374 696f 6e0a ls Introduction. │ │ │ │ │ +00005010: 0a32 2e32 2055 7365 2043 6173 6573 2066 .2.2 Use Cases f │ │ │ │ │ +00005020: 6f72 2074 6865 2047 4e55 2042 7569 6c64 or the GNU Build │ │ │ │ │ +00005030: 2053 7973 7465 6d0a 3d3d 3d3d 3d3d 3d3d System.======== │ │ │ │ │ 00005040: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00005050: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 496e ============..In │ │ │ │ │ -00005060: 2074 6869 7320 7365 6374 696f 6e20 7765 this section we │ │ │ │ │ -00005070: 2065 7870 6c6f 7265 2073 6576 6572 616c explore several │ │ │ │ │ -00005080: 2075 7365 2063 6173 6573 2066 6f72 2074 use cases for t │ │ │ │ │ -00005090: 6865 2047 4e55 2042 7569 6c64 2053 7973 he GNU Build Sys │ │ │ │ │ -000050a0: 7465 6d2e 0a59 6f75 2063 616e 2072 6570 tem..You can rep │ │ │ │ │ -000050b0: 6c61 7920 616c 6c20 7468 6573 6520 6578 lay all these ex │ │ │ │ │ -000050c0: 616d 706c 6573 206f 6e20 7468 6520 2761 amples on the 'a │ │ │ │ │ -000050d0: 6d68 656c 6c6f 2d31 2e30 2e74 6172 2e67 mhello-1.0.tar.g │ │ │ │ │ -000050e0: 7a27 2070 6163 6b61 6765 0a64 6973 7472 z' package.distr │ │ │ │ │ -000050f0: 6962 7574 6564 2077 6974 6820 4175 746f ibuted with Auto │ │ │ │ │ -00005100: 6d61 6b65 2e20 2049 6620 4175 746f 6d61 make. If Automa │ │ │ │ │ -00005110: 6b65 2069 7320 696e 7374 616c 6c65 6420 ke is installed │ │ │ │ │ -00005120: 6f6e 2079 6f75 7220 7379 7374 656d 2c20 on your system, │ │ │ │ │ -00005130: 796f 750a 7368 6f75 6c64 2066 696e 6420 you.should find │ │ │ │ │ -00005140: 6120 636f 7079 206f 6620 7468 6973 2066 a copy of this f │ │ │ │ │ -00005150: 696c 6520 696e 0a27 5052 4546 4958 2f73 ile in.'PREFIX/s │ │ │ │ │ -00005160: 6861 7265 2f64 6f63 2f61 7574 6f6d 616b hare/doc/automak │ │ │ │ │ -00005170: 652f 616d 6865 6c6c 6f2d 312e 302e 7461 e/amhello-1.0.ta │ │ │ │ │ -00005180: 722e 677a 272c 2077 6865 7265 2050 5245 r.gz', where PRE │ │ │ │ │ -00005190: 4649 5820 6973 2074 6865 0a69 6e73 7461 FIX is the.insta │ │ │ │ │ -000051a0: 6c6c 6174 696f 6e20 7072 6566 6978 2073 llation prefix s │ │ │ │ │ -000051b0: 7065 6369 6669 6564 2064 7572 696e 6720 pecified during │ │ │ │ │ -000051c0: 636f 6e66 6967 7572 6174 696f 6e20 2850 configuration (P │ │ │ │ │ -000051d0: 5245 4649 5820 6465 6661 756c 7473 2074 REFIX defaults t │ │ │ │ │ -000051e0: 6f0a 272f 7573 722f 6c6f 6361 6c27 2c20 o.'/usr/local', │ │ │ │ │ -000051f0: 686f 7765 7665 7220 6966 2041 7574 6f6d however if Autom │ │ │ │ │ -00005200: 616b 6520 7761 7320 696e 7374 616c 6c65 ake was installe │ │ │ │ │ -00005210: 6420 6279 2073 6f6d 6520 474e 552f 4c69 d by some GNU/Li │ │ │ │ │ -00005220: 6e75 780a 6469 7374 7269 6275 7469 6f6e nux.distribution │ │ │ │ │ -00005230: 2069 7420 6d6f 7374 206c 696b 656c 7920 it most likely │ │ │ │ │ -00005240: 6861 7320 6265 656e 2073 6574 2074 6f20 has been set to │ │ │ │ │ -00005250: 272f 7573 7227 292e 2020 4966 2079 6f75 '/usr'). If you │ │ │ │ │ -00005260: 2064 6f20 6e6f 7420 6861 7665 0a61 2063 do not have.a c │ │ │ │ │ -00005270: 6f70 7920 6f66 2041 7574 6f6d 616b 6520 opy of Automake │ │ │ │ │ -00005280: 696e 7374 616c 6c65 642c 2079 6f75 2063 installed, you c │ │ │ │ │ -00005290: 616e 2066 696e 6420 6120 636f 7079 206f an find a copy o │ │ │ │ │ -000052a0: 6620 7468 6973 2066 696c 6520 696e 7369 f this file insi │ │ │ │ │ -000052b0: 6465 0a74 6865 2027 646f 632f 2720 6469 de.the 'doc/' di │ │ │ │ │ -000052c0: 7265 6374 6f72 7920 6f66 2074 6865 2041 rectory of the A │ │ │ │ │ -000052d0: 7574 6f6d 616b 6520 7061 636b 6167 652e utomake package. │ │ │ │ │ -000052e0: 0a0a 2020 2053 6f6d 6520 6f66 2074 6865 .. Some of the │ │ │ │ │ -000052f0: 2066 6f6c 6c6f 7769 6e67 2075 7365 2063 following use c │ │ │ │ │ -00005300: 6173 6573 2070 7265 7365 6e74 2066 6561 ases present fea │ │ │ │ │ -00005310: 7475 7265 7320 7468 6174 2061 7265 2069 tures that are i │ │ │ │ │ -00005320: 6e20 6661 6374 0a65 7874 656e 7369 6f6e n fact.extension │ │ │ │ │ -00005330: 7320 746f 2074 6865 2047 4e55 2042 7569 s to the GNU Bui │ │ │ │ │ -00005340: 6c64 2053 7973 7465 6d2e 2020 5265 6164 ld System. Read │ │ │ │ │ -00005350: 3a20 7468 6579 2061 7265 206e 6f74 2073 : they are not s │ │ │ │ │ -00005360: 7065 6369 6669 6564 2062 7920 7468 650a pecified by the. │ │ │ │ │ -00005370: 474e 5520 436f 6469 6e67 2053 7461 6e64 GNU Coding Stand │ │ │ │ │ -00005380: 6172 6473 2c20 6275 7420 7468 6579 2061 ards, but they a │ │ │ │ │ -00005390: 7265 206e 6f6e 6574 6865 6c65 7373 2070 re nonetheless p │ │ │ │ │ -000053a0: 6172 7420 6f66 2074 6865 2062 7569 6c64 art of the build │ │ │ │ │ -000053b0: 2073 7973 7465 6d0a 6372 6561 7465 6420 system.created │ │ │ │ │ -000053c0: 6279 2074 6865 2041 7574 6f74 6f6f 6c73 by the Autotools │ │ │ │ │ -000053d0: 2e20 2054 6f20 6b65 6570 2074 6869 6e67 . To keep thing │ │ │ │ │ -000053e0: 7320 7369 6d70 6c65 2c20 7765 2064 6f20 s simple, we do │ │ │ │ │ -000053f0: 6e6f 7420 706f 696e 7420 6f75 740a 7468 not point out.th │ │ │ │ │ -00005400: 6520 6469 6666 6572 656e 6365 2e20 204f e difference. O │ │ │ │ │ -00005410: 7572 206f 626a 6563 7469 7665 2069 7320 ur objective is │ │ │ │ │ -00005420: 746f 2073 686f 7720 796f 7520 6d61 6e79 to show you many │ │ │ │ │ -00005430: 206f 6620 7468 6520 6665 6174 7572 6573 of the features │ │ │ │ │ -00005440: 2074 6861 740a 7468 6520 6275 696c 6420 that.the build │ │ │ │ │ -00005450: 7379 7374 656d 2063 7265 6174 6564 2062 system created b │ │ │ │ │ -00005460: 7920 7468 6520 4175 746f 746f 6f6c 7320 y the Autotools │ │ │ │ │ -00005470: 7769 6c6c 206f 6666 6572 2074 6f20 796f will offer to yo │ │ │ │ │ -00005480: 752e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2042 u...* Menu:..* B │ │ │ │ │ -00005490: 6173 6963 2049 6e73 7461 6c6c 6174 696f asic Installatio │ │ │ │ │ -000054a0: 6e3a 3a20 2020 2020 2020 2020 2043 6f6d n:: Com │ │ │ │ │ -000054b0: 6d6f 6e20 696e 7374 616c 6c61 7469 6f6e mon installation │ │ │ │ │ -000054c0: 2070 726f 6365 6475 7265 0a2a 2053 7461 procedure.* Sta │ │ │ │ │ -000054d0: 6e64 6172 6420 5461 7267 6574 733a 3a20 ndard Targets:: │ │ │ │ │ -000054e0: 2020 2020 2020 2020 2020 2041 206c 6973 A lis │ │ │ │ │ -000054f0: 7420 6f66 2073 7461 6e64 6172 6420 4d61 t of standard Ma │ │ │ │ │ -00005500: 6b65 6669 6c65 2074 6172 6765 7473 0a2a kefile targets.* │ │ │ │ │ -00005510: 2053 7461 6e64 6172 6420 4469 7265 6374 Standard Direct │ │ │ │ │ -00005520: 6f72 7920 5661 7269 6162 6c65 733a 3a20 ory Variables:: │ │ │ │ │ -00005530: 2041 206c 6973 7420 6f66 2073 7461 6e64 A list of stand │ │ │ │ │ -00005540: 6172 6420 6469 7265 6374 6f72 7920 7661 ard directory va │ │ │ │ │ -00005550: 7269 6162 6c65 730a 2a20 5374 616e 6461 riables.* Standa │ │ │ │ │ -00005560: 7264 2043 6f6e 6669 6775 7261 7469 6f6e rd Configuration │ │ │ │ │ -00005570: 2056 6172 6961 626c 6573 3a3a 2020 5573 Variables:: Us │ │ │ │ │ -00005580: 696e 6720 636f 6e66 6967 7572 6174 696f ing configuratio │ │ │ │ │ -00005590: 6e20 7661 7269 6162 6c65 730a 2a20 636f n variables.* co │ │ │ │ │ -000055a0: 6e66 6967 2e73 6974 653a 3a20 2020 2020 nfig.site:: │ │ │ │ │ -000055b0: 2020 2020 2020 2020 2020 2020 5573 696e Usin │ │ │ │ │ -000055c0: 6720 6120 636f 6e66 6967 2e73 6974 6520 g a config.site │ │ │ │ │ -000055d0: 6669 6c65 0a2a 2056 5041 5448 2042 7569 file.* VPATH Bui │ │ │ │ │ -000055e0: 6c64 733a 3a20 2020 2020 2020 2020 2020 lds:: │ │ │ │ │ -000055f0: 2020 2020 2050 6172 616c 6c65 6c20 6275 Parallel bu │ │ │ │ │ -00005600: 696c 6420 7472 6565 730a 2a20 5477 6f2d ild trees.* Two- │ │ │ │ │ -00005610: 5061 7274 2049 6e73 7461 6c6c 3a3a 2020 Part Install:: │ │ │ │ │ -00005620: 2020 2020 2020 2020 2020 496e 7374 616c Instal │ │ │ │ │ -00005630: 6c69 6e67 2064 6174 6120 616e 6420 7072 ling data and pr │ │ │ │ │ -00005640: 6f67 7261 6d73 2073 6570 6172 6174 656c ograms separatel │ │ │ │ │ -00005650: 790a 2a20 4372 6f73 732d 436f 6d70 696c y.* Cross-Compil │ │ │ │ │ -00005660: 6174 696f 6e3a 3a20 2020 2020 2020 2020 ation:: │ │ │ │ │ -00005670: 2020 4275 696c 6469 6e67 2066 6f72 206f Building for o │ │ │ │ │ -00005680: 7468 6572 2061 7263 6869 7465 6374 7572 ther architectur │ │ │ │ │ -00005690: 6573 0a2a 2052 656e 616d 696e 673a 3a20 es.* Renaming:: │ │ │ │ │ -000056a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000056b0: 2020 2052 656e 616d 696e 6720 7072 6f67 Renaming prog │ │ │ │ │ -000056c0: 7261 6d73 2061 7420 696e 7374 616c 6c20 rams at install │ │ │ │ │ -000056d0: 7469 6d65 0a2a 2044 4553 5444 4952 3a3a time.* DESTDIR:: │ │ │ │ │ -000056e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000056f0: 2020 2020 2042 7569 6c64 696e 6720 6269 Building bi │ │ │ │ │ -00005700: 6e61 7279 2070 6163 6b61 6765 7320 7769 nary packages wi │ │ │ │ │ -00005710: 7468 2044 4553 5444 4952 0a2a 2050 7265 th DESTDIR.* Pre │ │ │ │ │ -00005720: 7061 7269 6e67 2044 6973 7472 6962 7574 paring Distribut │ │ │ │ │ -00005730: 696f 6e73 3a3a 2020 2020 2052 6f6c 6c69 ions:: Rolli │ │ │ │ │ -00005740: 6e67 206f 7574 2074 6172 6261 6c6c 730a ng out tarballs. │ │ │ │ │ -00005750: 2a20 4465 7065 6e64 656e 6379 2054 7261 * Dependency Tra │ │ │ │ │ -00005760: 636b 696e 673a 3a20 2020 2020 2020 2020 cking:: │ │ │ │ │ -00005770: 4175 746f 6d61 7469 6320 6465 7065 6e64 Automatic depend │ │ │ │ │ -00005780: 656e 6379 2074 7261 636b 696e 670a 2a20 ency tracking.* │ │ │ │ │ -00005790: 4e65 7374 6564 2050 6163 6b61 6765 733a Nested Packages: │ │ │ │ │ -000057a0: 3a20 2020 2020 2020 2020 2020 2020 5468 : Th │ │ │ │ │ -000057b0: 6520 474e 5520 4275 696c 6420 5379 7374 e GNU Build Syst │ │ │ │ │ -000057c0: 656d 7320 6361 6e20 6265 206e 6573 7465 ems can be neste │ │ │ │ │ -000057d0: 640a 0a1f 0a46 696c 653a 2061 7574 6f6d d....File: autom │ │ │ │ │ -000057e0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -000057f0: 4e6f 6465 3a20 4261 7369 6320 496e 7374 Node: Basic Inst │ │ │ │ │ -00005800: 616c 6c61 7469 6f6e 2c20 204e 6578 743a allation, Next: │ │ │ │ │ -00005810: 2053 7461 6e64 6172 6420 5461 7267 6574 Standard Target │ │ │ │ │ -00005820: 732c 2020 5570 3a20 5573 6520 4361 7365 s, Up: Use Case │ │ │ │ │ -00005830: 730a 0a32 2e32 2e31 2042 6173 6963 2049 s..2.2.1 Basic I │ │ │ │ │ -00005840: 6e73 7461 6c6c 6174 696f 6e0a 2d2d 2d2d nstallation.---- │ │ │ │ │ +00005050: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +00005060: 496e 2074 6869 7320 7365 6374 696f 6e20 In this section │ │ │ │ │ +00005070: 7765 2065 7870 6c6f 7265 2073 6576 6572 we explore sever │ │ │ │ │ +00005080: 616c 2075 7365 2063 6173 6573 2066 6f72 al use cases for │ │ │ │ │ +00005090: 2074 6865 2047 4e55 2042 7569 6c64 2053 the GNU Build S │ │ │ │ │ +000050a0: 7973 7465 6d2e 0a59 6f75 2063 616e 2072 ystem..You can r │ │ │ │ │ +000050b0: 6570 6c61 7920 616c 6c20 7468 6573 6520 eplay all these │ │ │ │ │ +000050c0: 6578 616d 706c 6573 206f 6e20 7468 6520 examples on the │ │ │ │ │ +000050d0: 2761 6d68 656c 6c6f 2d31 2e30 2e74 6172 'amhello-1.0.tar │ │ │ │ │ +000050e0: 2e67 7a27 2070 6163 6b61 6765 0a64 6973 .gz' package.dis │ │ │ │ │ +000050f0: 7472 6962 7574 6564 2077 6974 6820 4175 tributed with Au │ │ │ │ │ +00005100: 746f 6d61 6b65 2e20 2049 6620 4175 746f tomake. If Auto │ │ │ │ │ +00005110: 6d61 6b65 2069 7320 696e 7374 616c 6c65 make is installe │ │ │ │ │ +00005120: 6420 6f6e 2079 6f75 7220 7379 7374 656d d on your system │ │ │ │ │ +00005130: 2c20 796f 750a 7368 6f75 6c64 2066 696e , you.should fin │ │ │ │ │ +00005140: 6420 6120 636f 7079 206f 6620 7468 6973 d a copy of this │ │ │ │ │ +00005150: 2066 696c 6520 696e 0a27 5052 4546 4958 file in.'PREFIX │ │ │ │ │ +00005160: 2f73 6861 7265 2f64 6f63 2f61 7574 6f6d /share/doc/autom │ │ │ │ │ +00005170: 616b 652f 616d 6865 6c6c 6f2d 312e 302e ake/amhello-1.0. │ │ │ │ │ +00005180: 7461 722e 677a 272c 2077 6865 7265 2050 tar.gz', where P │ │ │ │ │ +00005190: 5245 4649 5820 6973 2074 6865 0a69 6e73 REFIX is the.ins │ │ │ │ │ +000051a0: 7461 6c6c 6174 696f 6e20 7072 6566 6978 tallation prefix │ │ │ │ │ +000051b0: 2073 7065 6369 6669 6564 2064 7572 696e specified durin │ │ │ │ │ +000051c0: 6720 636f 6e66 6967 7572 6174 696f 6e20 g configuration │ │ │ │ │ +000051d0: 2850 5245 4649 5820 6465 6661 756c 7473 (PREFIX defaults │ │ │ │ │ +000051e0: 2074 6f0a 272f 7573 722f 6c6f 6361 6c27 to.'/usr/local' │ │ │ │ │ +000051f0: 2c20 686f 7765 7665 7220 6966 2041 7574 , however if Aut │ │ │ │ │ +00005200: 6f6d 616b 6520 7761 7320 696e 7374 616c omake was instal │ │ │ │ │ +00005210: 6c65 6420 6279 2073 6f6d 6520 474e 552f led by some GNU/ │ │ │ │ │ +00005220: 4c69 6e75 780a 6469 7374 7269 6275 7469 Linux.distributi │ │ │ │ │ +00005230: 6f6e 2069 7420 6d6f 7374 206c 696b 656c on it most likel │ │ │ │ │ +00005240: 7920 6861 7320 6265 656e 2073 6574 2074 y has been set t │ │ │ │ │ +00005250: 6f20 272f 7573 7227 292e 2020 4966 2079 o '/usr'). If y │ │ │ │ │ +00005260: 6f75 2064 6f20 6e6f 7420 6861 7665 0a61 ou do not have.a │ │ │ │ │ +00005270: 2063 6f70 7920 6f66 2041 7574 6f6d 616b copy of Automak │ │ │ │ │ +00005280: 6520 696e 7374 616c 6c65 642c 2079 6f75 e installed, you │ │ │ │ │ +00005290: 2063 616e 2066 696e 6420 6120 636f 7079 can find a copy │ │ │ │ │ +000052a0: 206f 6620 7468 6973 2066 696c 6520 696e of this file in │ │ │ │ │ +000052b0: 7369 6465 0a74 6865 2027 646f 632f 2720 side.the 'doc/' │ │ │ │ │ +000052c0: 6469 7265 6374 6f72 7920 6f66 2074 6865 directory of the │ │ │ │ │ +000052d0: 2041 7574 6f6d 616b 6520 7061 636b 6167 Automake packag │ │ │ │ │ +000052e0: 652e 0a0a 2020 2053 6f6d 6520 6f66 2074 e... Some of t │ │ │ │ │ +000052f0: 6865 2066 6f6c 6c6f 7769 6e67 2075 7365 he following use │ │ │ │ │ +00005300: 2063 6173 6573 2070 7265 7365 6e74 2066 cases present f │ │ │ │ │ +00005310: 6561 7475 7265 7320 7468 6174 2061 7265 eatures that are │ │ │ │ │ +00005320: 2069 6e20 6661 6374 0a65 7874 656e 7369 in fact.extensi │ │ │ │ │ +00005330: 6f6e 7320 746f 2074 6865 2047 4e55 2042 ons to the GNU B │ │ │ │ │ +00005340: 7569 6c64 2053 7973 7465 6d2e 2020 5265 uild System. Re │ │ │ │ │ +00005350: 6164 3a20 7468 6579 2061 7265 206e 6f74 ad: they are not │ │ │ │ │ +00005360: 2073 7065 6369 6669 6564 2062 7920 7468 specified by th │ │ │ │ │ +00005370: 650a 474e 5520 436f 6469 6e67 2053 7461 e.GNU Coding Sta │ │ │ │ │ +00005380: 6e64 6172 6473 2c20 6275 7420 7468 6579 ndards, but they │ │ │ │ │ +00005390: 2061 7265 206e 6f6e 6574 6865 6c65 7373 are nonetheless │ │ │ │ │ +000053a0: 2070 6172 7420 6f66 2074 6865 2062 7569 part of the bui │ │ │ │ │ +000053b0: 6c64 2073 7973 7465 6d0a 6372 6561 7465 ld system.create │ │ │ │ │ +000053c0: 6420 6279 2074 6865 2041 7574 6f74 6f6f d by the Autotoo │ │ │ │ │ +000053d0: 6c73 2e20 2054 6f20 6b65 6570 2074 6869 ls. To keep thi │ │ │ │ │ +000053e0: 6e67 7320 7369 6d70 6c65 2c20 7765 2064 ngs simple, we d │ │ │ │ │ +000053f0: 6f20 6e6f 7420 706f 696e 7420 6f75 740a o not point out. │ │ │ │ │ +00005400: 7468 6520 6469 6666 6572 656e 6365 2e20 the difference. │ │ │ │ │ +00005410: 204f 7572 206f 626a 6563 7469 7665 2069 Our objective i │ │ │ │ │ +00005420: 7320 746f 2073 686f 7720 796f 7520 6d61 s to show you ma │ │ │ │ │ +00005430: 6e79 206f 6620 7468 6520 6665 6174 7572 ny of the featur │ │ │ │ │ +00005440: 6573 2074 6861 740a 7468 6520 6275 696c es that.the buil │ │ │ │ │ +00005450: 6420 7379 7374 656d 2063 7265 6174 6564 d system created │ │ │ │ │ +00005460: 2062 7920 7468 6520 4175 746f 746f 6f6c by the Autotool │ │ │ │ │ +00005470: 7320 7769 6c6c 206f 6666 6572 2074 6f20 s will offer to │ │ │ │ │ +00005480: 796f 752e 0a0a 2a20 4d65 6e75 3a0a 0a2a you...* Menu:..* │ │ │ │ │ +00005490: 2042 6173 6963 2049 6e73 7461 6c6c 6174 Basic Installat │ │ │ │ │ +000054a0: 696f 6e3a 3a20 2020 2020 2020 2020 2043 ion:: C │ │ │ │ │ +000054b0: 6f6d 6d6f 6e20 696e 7374 616c 6c61 7469 ommon installati │ │ │ │ │ +000054c0: 6f6e 2070 726f 6365 6475 7265 0a2a 2053 on procedure.* S │ │ │ │ │ +000054d0: 7461 6e64 6172 6420 5461 7267 6574 733a tandard Targets: │ │ │ │ │ +000054e0: 3a20 2020 2020 2020 2020 2020 2041 206c : A l │ │ │ │ │ +000054f0: 6973 7420 6f66 2073 7461 6e64 6172 6420 ist of standard │ │ │ │ │ +00005500: 4d61 6b65 6669 6c65 2074 6172 6765 7473 Makefile targets │ │ │ │ │ +00005510: 0a2a 2053 7461 6e64 6172 6420 4469 7265 .* Standard Dire │ │ │ │ │ +00005520: 6374 6f72 7920 5661 7269 6162 6c65 733a ctory Variables: │ │ │ │ │ +00005530: 3a20 2041 206c 6973 7420 6f66 2073 7461 : A list of sta │ │ │ │ │ +00005540: 6e64 6172 6420 6469 7265 6374 6f72 7920 ndard directory │ │ │ │ │ +00005550: 7661 7269 6162 6c65 730a 2a20 5374 616e variables.* Stan │ │ │ │ │ +00005560: 6461 7264 2043 6f6e 6669 6775 7261 7469 dard Configurati │ │ │ │ │ +00005570: 6f6e 2056 6172 6961 626c 6573 3a3a 2020 on Variables:: │ │ │ │ │ +00005580: 5573 696e 6720 636f 6e66 6967 7572 6174 Using configurat │ │ │ │ │ +00005590: 696f 6e20 7661 7269 6162 6c65 730a 2a20 ion variables.* │ │ │ │ │ +000055a0: 636f 6e66 6967 2e73 6974 653a 3a20 2020 config.site:: │ │ │ │ │ +000055b0: 2020 2020 2020 2020 2020 2020 2020 5573 Us │ │ │ │ │ +000055c0: 696e 6720 6120 636f 6e66 6967 2e73 6974 ing a config.sit │ │ │ │ │ +000055d0: 6520 6669 6c65 0a2a 2056 5041 5448 2042 e file.* VPATH B │ │ │ │ │ +000055e0: 7569 6c64 733a 3a20 2020 2020 2020 2020 uilds:: │ │ │ │ │ +000055f0: 2020 2020 2020 2050 6172 616c 6c65 6c20 Parallel │ │ │ │ │ +00005600: 6275 696c 6420 7472 6565 730a 2a20 5477 build trees.* Tw │ │ │ │ │ +00005610: 6f2d 5061 7274 2049 6e73 7461 6c6c 3a3a o-Part Install:: │ │ │ │ │ +00005620: 2020 2020 2020 2020 2020 2020 496e 7374 Inst │ │ │ │ │ +00005630: 616c 6c69 6e67 2064 6174 6120 616e 6420 alling data and │ │ │ │ │ +00005640: 7072 6f67 7261 6d73 2073 6570 6172 6174 programs separat │ │ │ │ │ +00005650: 656c 790a 2a20 4372 6f73 732d 436f 6d70 ely.* Cross-Comp │ │ │ │ │ +00005660: 696c 6174 696f 6e3a 3a20 2020 2020 2020 ilation:: │ │ │ │ │ +00005670: 2020 2020 4275 696c 6469 6e67 2066 6f72 Building for │ │ │ │ │ +00005680: 206f 7468 6572 2061 7263 6869 7465 6374 other architect │ │ │ │ │ +00005690: 7572 6573 0a2a 2052 656e 616d 696e 673a ures.* Renaming: │ │ │ │ │ +000056a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000056b0: 2020 2020 2052 656e 616d 696e 6720 7072 Renaming pr │ │ │ │ │ +000056c0: 6f67 7261 6d73 2061 7420 696e 7374 616c ograms at instal │ │ │ │ │ +000056d0: 6c20 7469 6d65 0a2a 2044 4553 5444 4952 l time.* DESTDIR │ │ │ │ │ +000056e0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000056f0: 2020 2020 2020 2042 7569 6c64 696e 6720 Building │ │ │ │ │ +00005700: 6269 6e61 7279 2070 6163 6b61 6765 7320 binary packages │ │ │ │ │ +00005710: 7769 7468 2044 4553 5444 4952 0a2a 2050 with DESTDIR.* P │ │ │ │ │ +00005720: 7265 7061 7269 6e67 2044 6973 7472 6962 reparing Distrib │ │ │ │ │ +00005730: 7574 696f 6e73 3a3a 2020 2020 2052 6f6c utions:: Rol │ │ │ │ │ +00005740: 6c69 6e67 206f 7574 2074 6172 6261 6c6c ling out tarball │ │ │ │ │ +00005750: 730a 2a20 4465 7065 6e64 656e 6379 2054 s.* Dependency T │ │ │ │ │ +00005760: 7261 636b 696e 673a 3a20 2020 2020 2020 racking:: │ │ │ │ │ +00005770: 2020 4175 746f 6d61 7469 6320 6465 7065 Automatic depe │ │ │ │ │ +00005780: 6e64 656e 6379 2074 7261 636b 696e 670a ndency tracking. │ │ │ │ │ +00005790: 2a20 4e65 7374 6564 2050 6163 6b61 6765 * Nested Package │ │ │ │ │ +000057a0: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ +000057b0: 5468 6520 474e 5520 4275 696c 6420 5379 The GNU Build Sy │ │ │ │ │ +000057c0: 7374 656d 7320 6361 6e20 6265 206e 6573 stems can be nes │ │ │ │ │ +000057d0: 7465 640a 0a1f 0a46 696c 653a 2061 7574 ted....File: aut │ │ │ │ │ +000057e0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +000057f0: 2020 4e6f 6465 3a20 4261 7369 6320 496e Node: Basic In │ │ │ │ │ +00005800: 7374 616c 6c61 7469 6f6e 2c20 204e 6578 stallation, Nex │ │ │ │ │ +00005810: 743a 2053 7461 6e64 6172 6420 5461 7267 t: Standard Targ │ │ │ │ │ +00005820: 6574 732c 2020 5570 3a20 5573 6520 4361 ets, Up: Use Ca │ │ │ │ │ +00005830: 7365 730a 0a32 2e32 2e31 2042 6173 6963 ses..2.2.1 Basic │ │ │ │ │ +00005840: 2049 6e73 7461 6c6c 6174 696f 6e0a 2d2d Installation.-- │ │ │ │ │ 00005850: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00005860: 2d2d 2d2d 0a0a 5468 6520 6d6f 7374 2063 ----..The most c │ │ │ │ │ -00005870: 6f6d 6d6f 6e20 696e 7374 616c 6c61 7469 ommon installati │ │ │ │ │ -00005880: 6f6e 2070 726f 6365 6475 7265 206c 6f6f on procedure loo │ │ │ │ │ -00005890: 6b73 2061 7320 666f 6c6c 6f77 732e 0a0a ks as follows... │ │ │ │ │ -000058a0: 2020 2020 207e 2025 2074 6172 207a 7866 ~ % tar zxf │ │ │ │ │ -000058b0: 2061 6d68 656c 6c6f 2d31 2e30 2e74 6172 amhello-1.0.tar │ │ │ │ │ -000058c0: 2e67 7a0a 2020 2020 207e 2025 2063 6420 .gz. ~ % cd │ │ │ │ │ -000058d0: 616d 6865 6c6c 6f2d 312e 300a 2020 2020 amhello-1.0. │ │ │ │ │ -000058e0: 207e 2f61 6d68 656c 6c6f 2d31 2e30 2025 ~/amhello-1.0 % │ │ │ │ │ -000058f0: 202e 2f63 6f6e 6669 6775 7265 0a20 2020 ./configure. │ │ │ │ │ -00005900: 2020 2e2e 2e0a 2020 2020 2063 6f6e 6669 .... confi │ │ │ │ │ -00005910: 672e 7374 6174 7573 3a20 6372 6561 7469 g.status: creati │ │ │ │ │ -00005920: 6e67 204d 616b 6566 696c 650a 2020 2020 ng Makefile. │ │ │ │ │ -00005930: 2063 6f6e 6669 672e 7374 6174 7573 3a20 config.status: │ │ │ │ │ -00005940: 6372 6561 7469 6e67 2073 7263 2f4d 616b creating src/Mak │ │ │ │ │ -00005950: 6566 696c 650a 2020 2020 202e 2e2e 0a20 efile. .... │ │ │ │ │ -00005960: 2020 2020 7e2f 616d 6865 6c6c 6f2d 312e ~/amhello-1. │ │ │ │ │ -00005970: 3020 2520 6d61 6b65 0a20 2020 2020 2e2e 0 % make. .. │ │ │ │ │ -00005980: 2e0a 2020 2020 207e 2f61 6d68 656c 6c6f .. ~/amhello │ │ │ │ │ -00005990: 2d31 2e30 2025 206d 616b 6520 6368 6563 -1.0 % make chec │ │ │ │ │ -000059a0: 6b0a 2020 2020 202e 2e2e 0a20 2020 2020 k. .... │ │ │ │ │ -000059b0: 7e2f 616d 6865 6c6c 6f2d 312e 3020 2520 ~/amhello-1.0 % │ │ │ │ │ -000059c0: 7375 0a20 2020 2020 5061 7373 776f 7264 su. Password │ │ │ │ │ -000059d0: 3a0a 2020 2020 202f 686f 6d65 2f61 646c :. /home/adl │ │ │ │ │ -000059e0: 2f61 6d68 656c 6c6f 2d31 2e30 2023 206d /amhello-1.0 # m │ │ │ │ │ -000059f0: 616b 6520 696e 7374 616c 6c0a 2020 2020 ake install. │ │ │ │ │ -00005a00: 202e 2e2e 0a20 2020 2020 2f68 6f6d 652f .... /home/ │ │ │ │ │ -00005a10: 6164 6c2f 616d 6865 6c6c 6f2d 312e 3020 adl/amhello-1.0 │ │ │ │ │ -00005a20: 2320 6578 6974 0a20 2020 2020 7e2f 616d # exit. ~/am │ │ │ │ │ -00005a30: 6865 6c6c 6f2d 312e 3020 2520 6d61 6b65 hello-1.0 % make │ │ │ │ │ -00005a40: 2069 6e73 7461 6c6c 6368 6563 6b0a 2020 installcheck. │ │ │ │ │ -00005a50: 2020 202e 2e2e 0a0a 2020 2054 6865 2075 ..... The u │ │ │ │ │ -00005a60: 7365 7220 6669 7273 7420 756e 7061 636b ser first unpack │ │ │ │ │ -00005a70: 7320 7468 6520 7061 636b 6167 652e 2020 s the package. │ │ │ │ │ -00005a80: 4865 7265 2c20 616e 6420 696e 2074 6865 Here, and in the │ │ │ │ │ -00005a90: 2066 6f6c 6c6f 7769 6e67 0a65 7861 6d70 following.examp │ │ │ │ │ -00005aa0: 6c65 732c 2077 6520 7769 6c6c 2075 7365 les, we will use │ │ │ │ │ -00005ab0: 2074 6865 206e 6f6e 2d70 6f72 7461 626c the non-portabl │ │ │ │ │ -00005ac0: 6520 2774 6172 207a 7866 2720 636f 6d6d e 'tar zxf' comm │ │ │ │ │ -00005ad0: 616e 6420 666f 7220 7369 6d70 6c69 6369 and for simplici │ │ │ │ │ -00005ae0: 7479 2e0a 4f6e 2061 2073 7973 7465 6d20 ty..On a system │ │ │ │ │ -00005af0: 7769 7468 6f75 7420 474e 5520 2774 6172 without GNU 'tar │ │ │ │ │ -00005b00: 2720 696e 7374 616c 6c65 642c 2074 6869 ' installed, thi │ │ │ │ │ -00005b10: 7320 636f 6d6d 616e 6420 7368 6f75 6c64 s command should │ │ │ │ │ -00005b20: 2072 6561 640a 2767 756e 7a69 7020 2d63 read.'gunzip -c │ │ │ │ │ -00005b30: 2061 6d68 656c 6c6f 2d31 2e30 2e74 6172 amhello-1.0.tar │ │ │ │ │ -00005b40: 2e67 7a20 7c20 7461 7220 7866 202d 272e .gz | tar xf -'. │ │ │ │ │ -00005b50: 0a0a 2020 2054 6865 2075 7365 7220 7468 .. The user th │ │ │ │ │ -00005b60: 656e 2065 6e74 6572 7320 7468 6520 6e65 en enters the ne │ │ │ │ │ -00005b70: 776c 7920 6372 6561 7465 6420 6469 7265 wly created dire │ │ │ │ │ -00005b80: 6374 6f72 7920 746f 2072 756e 2074 6865 ctory to run the │ │ │ │ │ -00005b90: 0a27 636f 6e66 6967 7572 6527 2073 6372 .'configure' scr │ │ │ │ │ -00005ba0: 6970 742e 2020 5468 6973 2073 6372 6970 ipt. This scrip │ │ │ │ │ -00005bb0: 7420 7072 6f62 6573 2074 6865 2073 7973 t probes the sys │ │ │ │ │ -00005bc0: 7465 6d20 666f 7220 7661 7269 6f75 7320 tem for various │ │ │ │ │ -00005bd0: 6665 6174 7572 6573 2c0a 616e 6420 6669 features,.and fi │ │ │ │ │ -00005be0: 6e61 6c6c 7920 6372 6561 7465 7320 7468 nally creates th │ │ │ │ │ -00005bf0: 6520 274d 616b 6566 696c 6527 732e 2020 e 'Makefile's. │ │ │ │ │ -00005c00: 496e 2074 6869 7320 746f 7920 6578 616d In this toy exam │ │ │ │ │ -00005c10: 706c 6520 7468 6572 6520 6172 6520 6f6e ple there are on │ │ │ │ │ -00005c20: 6c79 0a74 776f 2027 4d61 6b65 6669 6c65 ly.two 'Makefile │ │ │ │ │ -00005c30: 2773 2c20 6275 7420 696e 2072 6561 6c2d 's, but in real- │ │ │ │ │ -00005c40: 776f 726c 6420 7072 6f6a 6563 7473 2c20 world projects, │ │ │ │ │ -00005c50: 7468 6572 6520 6d61 7920 6265 206d 616e there may be man │ │ │ │ │ -00005c60: 7920 6d6f 7265 2c0a 7573 7561 6c6c 7920 y more,.usually │ │ │ │ │ -00005c70: 6f6e 6520 274d 616b 6566 696c 6527 2070 one 'Makefile' p │ │ │ │ │ -00005c80: 6572 2064 6972 6563 746f 7279 2e0a 0a20 er directory... │ │ │ │ │ -00005c90: 2020 4974 2069 7320 6e6f 7720 706f 7373 It is now poss │ │ │ │ │ -00005ca0: 6962 6c65 2074 6f20 7275 6e20 276d 616b ible to run 'mak │ │ │ │ │ -00005cb0: 6527 2e20 2054 6869 7320 7769 6c6c 2063 e'. This will c │ │ │ │ │ -00005cc0: 6f6e 7374 7275 6374 2061 6c6c 2074 6865 onstruct all the │ │ │ │ │ -00005cd0: 0a70 726f 6772 616d 732c 206c 6962 7261 .programs, libra │ │ │ │ │ -00005ce0: 7269 6573 2c20 616e 6420 7363 7269 7074 ries, and script │ │ │ │ │ -00005cf0: 7320 7468 6174 206e 6565 6420 746f 2062 s that need to b │ │ │ │ │ -00005d00: 6520 636f 6e73 7472 7563 7465 6420 666f e constructed fo │ │ │ │ │ -00005d10: 7220 7468 650a 7061 636b 6167 652e 2020 r the.package. │ │ │ │ │ -00005d20: 496e 206f 7572 2065 7861 6d70 6c65 2c20 In our example, │ │ │ │ │ -00005d30: 7468 6973 2063 6f6d 7069 6c65 7320 7468 this compiles th │ │ │ │ │ -00005d40: 6520 2768 656c 6c6f 2720 7072 6f67 7261 e 'hello' progra │ │ │ │ │ -00005d50: 6d2e 2020 416c 6c20 6669 6c65 730a 6172 m. All files.ar │ │ │ │ │ -00005d60: 6520 636f 6e73 7472 7563 7465 6420 696e e constructed in │ │ │ │ │ -00005d70: 2070 6c61 6365 2c20 696e 2074 6865 2073 place, in the s │ │ │ │ │ -00005d80: 6f75 7263 6520 7472 6565 3b20 7765 2077 ource tree; we w │ │ │ │ │ -00005d90: 696c 6c20 7365 6520 6c61 7465 7220 686f ill see later ho │ │ │ │ │ -00005da0: 7720 7468 6973 0a63 616e 2062 6520 6368 w this.can be ch │ │ │ │ │ -00005db0: 616e 6765 642e 0a0a 2020 2027 6d61 6b65 anged... 'make │ │ │ │ │ -00005dc0: 2063 6865 636b 2720 6361 7573 6573 2074 check' causes t │ │ │ │ │ -00005dd0: 6865 2070 6163 6b61 6765 2773 2074 6573 he package's tes │ │ │ │ │ -00005de0: 7473 2074 6f20 6265 2072 756e 2e20 2054 ts to be run. T │ │ │ │ │ -00005df0: 6869 7320 7374 6570 2069 7320 6e6f 740a his step is not. │ │ │ │ │ -00005e00: 6d61 6e64 6174 6f72 792c 2062 7574 2069 mandatory, but i │ │ │ │ │ -00005e10: 7420 6973 206f 6674 656e 2067 6f6f 6420 t is often good │ │ │ │ │ -00005e20: 746f 206d 616b 6520 7375 7265 2074 6865 to make sure the │ │ │ │ │ -00005e30: 2070 726f 6772 616d 7320 7468 6174 2068 programs that h │ │ │ │ │ -00005e40: 6176 6520 6265 656e 0a62 7569 6c74 2062 ave been.built b │ │ │ │ │ -00005e50: 6568 6176 6520 6173 2074 6865 7920 7368 ehave as they sh │ │ │ │ │ -00005e60: 6f75 6c64 2c20 6265 666f 7265 2079 6f75 ould, before you │ │ │ │ │ -00005e70: 2064 6563 6964 6520 746f 2069 6e73 7461 decide to insta │ │ │ │ │ -00005e80: 6c6c 2074 6865 6d2e 2020 4f75 720a 6578 ll them. Our.ex │ │ │ │ │ -00005e90: 616d 706c 6520 646f 6573 206e 6f74 2063 ample does not c │ │ │ │ │ -00005ea0: 6f6e 7461 696e 2061 6e79 2074 6573 7473 ontain any tests │ │ │ │ │ -00005eb0: 2c20 736f 2072 756e 6e69 6e67 2027 6d61 , so running 'ma │ │ │ │ │ -00005ec0: 6b65 2063 6865 636b 2720 6973 2061 206e ke check' is a n │ │ │ │ │ -00005ed0: 6f2d 6f70 2e0a 0a20 2020 4166 7465 7220 o-op... After │ │ │ │ │ -00005ee0: 6576 6572 7974 6869 6e67 2068 6173 2062 everything has b │ │ │ │ │ -00005ef0: 6565 6e20 6275 696c 742c 2061 6e64 206d een built, and m │ │ │ │ │ -00005f00: 6179 6265 2074 6573 7465 642c 2069 7420 aybe tested, it │ │ │ │ │ -00005f10: 6973 2074 696d 6520 746f 0a69 6e73 7461 is time to.insta │ │ │ │ │ -00005f20: 6c6c 2069 7420 6f6e 2074 6865 2073 7973 ll it on the sys │ │ │ │ │ -00005f30: 7465 6d2e 2020 5468 6174 206d 6561 6e73 tem. That means │ │ │ │ │ -00005f40: 2063 6f70 7969 6e67 2074 6865 2070 726f copying the pro │ │ │ │ │ -00005f50: 6772 616d 732c 206c 6962 7261 7269 6573 grams, libraries │ │ │ │ │ -00005f60: 2c0a 6865 6164 6572 2066 696c 6573 2c20 ,.header files, │ │ │ │ │ -00005f70: 7363 7269 7074 732c 2061 6e64 206f 7468 scripts, and oth │ │ │ │ │ -00005f80: 6572 2064 6174 6120 6669 6c65 7320 6672 er data files fr │ │ │ │ │ -00005f90: 6f6d 2074 6865 2073 6f75 7263 6520 6469 om the source di │ │ │ │ │ -00005fa0: 7265 6374 6f72 7920 746f 0a74 6865 6972 rectory to.their │ │ │ │ │ -00005fb0: 2066 696e 616c 2064 6573 7469 6e61 7469 final destinati │ │ │ │ │ -00005fc0: 6f6e 206f 6e20 7468 6520 7379 7374 656d on on the system │ │ │ │ │ -00005fd0: 2e20 2054 6865 2063 6f6d 6d61 6e64 2027 . The command ' │ │ │ │ │ -00005fe0: 6d61 6b65 2069 6e73 7461 6c6c 2720 7769 make install' wi │ │ │ │ │ -00005ff0: 6c6c 0a64 6f20 7468 6174 2e20 2048 6f77 ll.do that. How │ │ │ │ │ -00006000: 6576 6572 2c20 6279 2064 6566 6175 6c74 ever, by default │ │ │ │ │ -00006010: 2065 7665 7279 7468 696e 6720 7769 6c6c everything will │ │ │ │ │ -00006020: 2062 6520 696e 7374 616c 6c65 6420 696e be installed in │ │ │ │ │ -00006030: 0a73 7562 6469 7265 6374 6f72 6965 7320 .subdirectories │ │ │ │ │ -00006040: 6f66 2027 2f75 7372 2f6c 6f63 616c 273a of '/usr/local': │ │ │ │ │ -00006050: 2062 696e 6172 6965 7320 7769 6c6c 2067 binaries will g │ │ │ │ │ -00006060: 6f20 696e 746f 2027 2f75 7372 2f6c 6f63 o into '/usr/loc │ │ │ │ │ -00006070: 616c 2f62 696e 272c 0a6c 6962 7261 7269 al/bin',.librari │ │ │ │ │ -00006080: 6573 2077 696c 6c20 656e 6420 7570 2069 es will end up i │ │ │ │ │ -00006090: 6e20 272f 7573 722f 6c6f 6361 6c2f 6c69 n '/usr/local/li │ │ │ │ │ -000060a0: 6227 2c20 6574 632e 2020 5468 6973 2064 b', etc. This d │ │ │ │ │ -000060b0: 6573 7469 6e61 7469 6f6e 2069 730a 7573 estination is.us │ │ │ │ │ -000060c0: 7561 6c6c 7920 6e6f 7420 7772 6974 6162 ually not writab │ │ │ │ │ -000060d0: 6c65 2062 7920 616e 7920 7573 6572 2c20 le by any user, │ │ │ │ │ -000060e0: 736f 2077 6520 6173 7375 6d65 2074 6861 so we assume tha │ │ │ │ │ -000060f0: 7420 7765 2068 6176 6520 746f 2062 6563 t we have to bec │ │ │ │ │ -00006100: 6f6d 650a 726f 6f74 2062 6566 6f72 6520 ome.root before │ │ │ │ │ -00006110: 7765 2063 616e 2072 756e 2027 6d61 6b65 we can run 'make │ │ │ │ │ -00006120: 2069 6e73 7461 6c6c 272e 2020 496e 206f install'. In o │ │ │ │ │ -00006130: 7572 2065 7861 6d70 6c65 2c20 7275 6e6e ur example, runn │ │ │ │ │ -00006140: 696e 6720 276d 616b 650a 696e 7374 616c ing 'make.instal │ │ │ │ │ -00006150: 6c27 2077 696c 6c20 636f 7079 2074 6865 l' will copy the │ │ │ │ │ -00006160: 2070 726f 6772 616d 2027 6865 6c6c 6f27 program 'hello' │ │ │ │ │ -00006170: 2069 6e74 6f20 272f 7573 722f 6c6f 6361 into '/usr/loca │ │ │ │ │ -00006180: 6c2f 6269 6e27 2061 6e64 0a27 5245 4144 l/bin' and.'READ │ │ │ │ │ -00006190: 4d45 2720 696e 746f 2027 2f75 7372 2f6c ME' into '/usr/l │ │ │ │ │ -000061a0: 6f63 616c 2f73 6861 7265 2f64 6f63 2f61 ocal/share/doc/a │ │ │ │ │ -000061b0: 6d68 656c 6c6f 272e 0a0a 2020 2041 206c mhello'... A l │ │ │ │ │ -000061c0: 6173 7420 616e 6420 6f70 7469 6f6e 616c ast and optional │ │ │ │ │ -000061d0: 2073 7465 7020 6973 2074 6f20 7275 6e20 step is to run │ │ │ │ │ -000061e0: 276d 616b 6520 696e 7374 616c 6c63 6865 'make installche │ │ │ │ │ -000061f0: 636b 272e 2020 5468 6973 2063 6f6d 6d61 ck'. This comma │ │ │ │ │ -00006200: 6e64 0a6d 6179 2072 756e 2074 6573 7473 nd.may run tests │ │ │ │ │ -00006210: 206f 6e20 7468 6520 696e 7374 616c 6c65 on the installe │ │ │ │ │ -00006220: 6420 6669 6c65 732e 2020 276d 616b 6520 d files. 'make │ │ │ │ │ -00006230: 6368 6563 6b27 2074 6573 7473 2074 6865 check' tests the │ │ │ │ │ -00006240: 2066 696c 6573 2069 6e0a 7468 6520 736f files in.the so │ │ │ │ │ -00006250: 7572 6365 2074 7265 652c 2077 6869 6c65 urce tree, while │ │ │ │ │ -00006260: 2027 6d61 6b65 2069 6e73 7461 6c6c 6368 'make installch │ │ │ │ │ -00006270: 6563 6b27 2074 6573 7473 2074 6865 6972 eck' tests their │ │ │ │ │ -00006280: 2069 6e73 7461 6c6c 6564 2063 6f70 6965 installed copie │ │ │ │ │ -00006290: 732e 0a54 6865 2074 6573 7473 2072 756e s..The tests run │ │ │ │ │ -000062a0: 2062 7920 7468 6520 6c61 7474 6572 2063 by the latter c │ │ │ │ │ -000062b0: 616e 2062 6520 6469 6666 6572 656e 7420 an be different │ │ │ │ │ -000062c0: 6672 6f6d 2074 686f 7365 2072 756e 2062 from those run b │ │ │ │ │ -000062d0: 7920 7468 650a 666f 726d 6572 2e20 2046 y the.former. F │ │ │ │ │ -000062e0: 6f72 2069 6e73 7461 6e63 652c 2074 6865 or instance, the │ │ │ │ │ -000062f0: 7265 2061 7265 2074 6573 7473 2074 6861 re are tests tha │ │ │ │ │ -00006300: 7420 6361 6e6e 6f74 2062 6520 7275 6e20 t cannot be run │ │ │ │ │ -00006310: 696e 2074 6865 2073 6f75 7263 650a 7472 in the source.tr │ │ │ │ │ -00006320: 6565 2e20 2043 6f6e 7665 7273 656c 792c ee. Conversely, │ │ │ │ │ -00006330: 2073 6f6d 6520 7061 636b 6167 6573 2061 some packages a │ │ │ │ │ -00006340: 7265 2073 6574 2075 7020 736f 2074 6861 re set up so tha │ │ │ │ │ -00006350: 7420 276d 616b 6520 696e 7374 616c 6c63 t 'make installc │ │ │ │ │ -00006360: 6865 636b 270a 7769 6c6c 2072 756e 2074 heck'.will run t │ │ │ │ │ -00006370: 6865 2076 6572 7920 7361 6d65 2074 6573 he very same tes │ │ │ │ │ -00006380: 7473 2061 7320 276d 616b 6520 6368 6563 ts as 'make chec │ │ │ │ │ -00006390: 6b27 2c20 6f6e 6c79 206f 6e20 6469 6666 k', only on diff │ │ │ │ │ -000063a0: 6572 656e 7420 6669 6c65 730a 286e 6f6e erent files.(non │ │ │ │ │ -000063b0: 2d69 6e73 7461 6c6c 6564 2076 732e 2069 -installed vs. i │ │ │ │ │ -000063c0: 6e73 7461 6c6c 6564 292e 2020 4974 2063 nstalled). It c │ │ │ │ │ -000063d0: 616e 206d 616b 6520 6120 6469 6666 6572 an make a differ │ │ │ │ │ -000063e0: 656e 6365 2c20 666f 7220 696e 7374 616e ence, for instan │ │ │ │ │ -000063f0: 6365 0a77 6865 6e20 7468 6520 736f 7572 ce.when the sour │ │ │ │ │ -00006400: 6365 2074 7265 6527 7320 6c61 796f 7574 ce tree's layout │ │ │ │ │ -00006410: 2069 7320 6469 6666 6572 656e 7420 6672 is different fr │ │ │ │ │ -00006420: 6f6d 2074 6861 7420 6f66 2074 6865 0a69 om that of the.i │ │ │ │ │ -00006430: 6e73 7461 6c6c 6174 696f 6e2e 2020 4675 nstallation. Fu │ │ │ │ │ -00006440: 7274 6865 726d 6f72 6520 6974 206d 6179 rthermore it may │ │ │ │ │ -00006450: 2068 656c 7020 746f 2064 6961 676e 6f73 help to diagnos │ │ │ │ │ -00006460: 6520 616e 2069 6e63 6f6d 706c 6574 650a e an incomplete. │ │ │ │ │ -00006470: 696e 7374 616c 6c61 7469 6f6e 2e0a 0a20 installation... │ │ │ │ │ -00006480: 2020 5072 6573 656e 746c 7920 6d6f 7374 Presently most │ │ │ │ │ -00006490: 2070 6163 6b61 6765 7320 646f 206e 6f74 packages do not │ │ │ │ │ -000064a0: 2068 6176 6520 616e 7920 2769 6e73 7461 have any 'insta │ │ │ │ │ -000064b0: 6c6c 6368 6563 6b27 2074 6573 7473 2062 llcheck' tests b │ │ │ │ │ -000064c0: 6563 6175 7365 0a74 6865 2065 7869 7374 ecause.the exist │ │ │ │ │ -000064d0: 656e 6365 206f 6620 2769 6e73 7461 6c6c ence of 'install │ │ │ │ │ -000064e0: 6368 6563 6b27 2069 7320 6c69 7474 6c65 check' is little │ │ │ │ │ -000064f0: 206b 6e6f 776e 2c20 616e 6420 6974 7320 known, and its │ │ │ │ │ -00006500: 7573 6566 756c 6e65 7373 2069 730a 6e65 usefulness is.ne │ │ │ │ │ -00006510: 676c 6563 7465 642e 2020 4f75 7220 6c69 glected. Our li │ │ │ │ │ -00006520: 7474 6c65 2074 6f79 2070 6163 6b61 6765 ttle toy package │ │ │ │ │ -00006530: 2069 7320 6e6f 2062 6574 7465 723a 2027 is no better: ' │ │ │ │ │ -00006540: 6d61 6b65 2069 6e73 7461 6c6c 6368 6563 make installchec │ │ │ │ │ -00006550: 6b27 0a64 6f65 7320 6e6f 7468 696e 672e k'.does nothing. │ │ │ │ │ -00006560: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00006570: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00006580: 6f64 653a 2053 7461 6e64 6172 6420 5461 ode: Standard Ta │ │ │ │ │ -00006590: 7267 6574 732c 2020 4e65 7874 3a20 5374 rgets, Next: St │ │ │ │ │ -000065a0: 616e 6461 7264 2044 6972 6563 746f 7279 andard Directory │ │ │ │ │ -000065b0: 2056 6172 6961 626c 6573 2c20 2050 7265 Variables, Pre │ │ │ │ │ -000065c0: 763a 2042 6173 6963 2049 6e73 7461 6c6c v: Basic Install │ │ │ │ │ -000065d0: 6174 696f 6e2c 2020 5570 3a20 5573 6520 ation, Up: Use │ │ │ │ │ -000065e0: 4361 7365 730a 0a32 2e32 2e32 2053 7461 Cases..2.2.2 Sta │ │ │ │ │ -000065f0: 6e64 6172 6420 274d 616b 6566 696c 6527 ndard 'Makefile' │ │ │ │ │ -00006600: 2054 6172 6765 7473 0a2d 2d2d 2d2d 2d2d Targets.------- │ │ │ │ │ +00005860: 2d2d 2d2d 2d2d 0a0a 5468 6520 6d6f 7374 ------..The most │ │ │ │ │ +00005870: 2063 6f6d 6d6f 6e20 696e 7374 616c 6c61 common installa │ │ │ │ │ +00005880: 7469 6f6e 2070 726f 6365 6475 7265 206c tion procedure l │ │ │ │ │ +00005890: 6f6f 6b73 2061 7320 666f 6c6c 6f77 732e ooks as follows. │ │ │ │ │ +000058a0: 0a0a 2020 2020 207e 2025 2074 6172 207a .. ~ % tar z │ │ │ │ │ +000058b0: 7866 2061 6d68 656c 6c6f 2d31 2e30 2e74 xf amhello-1.0.t │ │ │ │ │ +000058c0: 6172 2e67 7a0a 2020 2020 207e 2025 2063 ar.gz. ~ % c │ │ │ │ │ +000058d0: 6420 616d 6865 6c6c 6f2d 312e 300a 2020 d amhello-1.0. │ │ │ │ │ +000058e0: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ +000058f0: 2025 202e 2f63 6f6e 6669 6775 7265 0a20 % ./configure. │ │ │ │ │ +00005900: 2020 2020 2e2e 2e0a 2020 2020 2063 6f6e .... con │ │ │ │ │ +00005910: 6669 672e 7374 6174 7573 3a20 6372 6561 fig.status: crea │ │ │ │ │ +00005920: 7469 6e67 204d 616b 6566 696c 650a 2020 ting Makefile. │ │ │ │ │ +00005930: 2020 2063 6f6e 6669 672e 7374 6174 7573 config.status │ │ │ │ │ +00005940: 3a20 6372 6561 7469 6e67 2073 7263 2f4d : creating src/M │ │ │ │ │ +00005950: 616b 6566 696c 650a 2020 2020 202e 2e2e akefile. ... │ │ │ │ │ +00005960: 0a20 2020 2020 7e2f 616d 6865 6c6c 6f2d . ~/amhello- │ │ │ │ │ +00005970: 312e 3020 2520 6d61 6b65 0a20 2020 2020 1.0 % make. │ │ │ │ │ +00005980: 2e2e 2e0a 2020 2020 207e 2f61 6d68 656c .... ~/amhel │ │ │ │ │ +00005990: 6c6f 2d31 2e30 2025 206d 616b 6520 6368 lo-1.0 % make ch │ │ │ │ │ +000059a0: 6563 6b0a 2020 2020 202e 2e2e 0a20 2020 eck. .... │ │ │ │ │ +000059b0: 2020 7e2f 616d 6865 6c6c 6f2d 312e 3020 ~/amhello-1.0 │ │ │ │ │ +000059c0: 2520 7375 0a20 2020 2020 5061 7373 776f % su. Passwo │ │ │ │ │ +000059d0: 7264 3a0a 2020 2020 202f 686f 6d65 2f61 rd:. /home/a │ │ │ │ │ +000059e0: 646c 2f61 6d68 656c 6c6f 2d31 2e30 2023 dl/amhello-1.0 # │ │ │ │ │ +000059f0: 206d 616b 6520 696e 7374 616c 6c0a 2020 make install. │ │ │ │ │ +00005a00: 2020 202e 2e2e 0a20 2020 2020 2f68 6f6d .... /hom │ │ │ │ │ +00005a10: 652f 6164 6c2f 616d 6865 6c6c 6f2d 312e e/adl/amhello-1. │ │ │ │ │ +00005a20: 3020 2320 6578 6974 0a20 2020 2020 7e2f 0 # exit. ~/ │ │ │ │ │ +00005a30: 616d 6865 6c6c 6f2d 312e 3020 2520 6d61 amhello-1.0 % ma │ │ │ │ │ +00005a40: 6b65 2069 6e73 7461 6c6c 6368 6563 6b0a ke installcheck. │ │ │ │ │ +00005a50: 2020 2020 202e 2e2e 0a0a 2020 2054 6865 ..... The │ │ │ │ │ +00005a60: 2075 7365 7220 6669 7273 7420 756e 7061 user first unpa │ │ │ │ │ +00005a70: 636b 7320 7468 6520 7061 636b 6167 652e cks the package. │ │ │ │ │ +00005a80: 2020 4865 7265 2c20 616e 6420 696e 2074 Here, and in t │ │ │ │ │ +00005a90: 6865 2066 6f6c 6c6f 7769 6e67 0a65 7861 he following.exa │ │ │ │ │ +00005aa0: 6d70 6c65 732c 2077 6520 7769 6c6c 2075 mples, we will u │ │ │ │ │ +00005ab0: 7365 2074 6865 206e 6f6e 2d70 6f72 7461 se the non-porta │ │ │ │ │ +00005ac0: 626c 6520 2774 6172 207a 7866 2720 636f ble 'tar zxf' co │ │ │ │ │ +00005ad0: 6d6d 616e 6420 666f 7220 7369 6d70 6c69 mmand for simpli │ │ │ │ │ +00005ae0: 6369 7479 2e0a 4f6e 2061 2073 7973 7465 city..On a syste │ │ │ │ │ +00005af0: 6d20 7769 7468 6f75 7420 474e 5520 2774 m without GNU 't │ │ │ │ │ +00005b00: 6172 2720 696e 7374 616c 6c65 642c 2074 ar' installed, t │ │ │ │ │ +00005b10: 6869 7320 636f 6d6d 616e 6420 7368 6f75 his command shou │ │ │ │ │ +00005b20: 6c64 2072 6561 640a 2767 756e 7a69 7020 ld read.'gunzip │ │ │ │ │ +00005b30: 2d63 2061 6d68 656c 6c6f 2d31 2e30 2e74 -c amhello-1.0.t │ │ │ │ │ +00005b40: 6172 2e67 7a20 7c20 7461 7220 7866 202d ar.gz | tar xf - │ │ │ │ │ +00005b50: 272e 0a0a 2020 2054 6865 2075 7365 7220 '... The user │ │ │ │ │ +00005b60: 7468 656e 2065 6e74 6572 7320 7468 6520 then enters the │ │ │ │ │ +00005b70: 6e65 776c 7920 6372 6561 7465 6420 6469 newly created di │ │ │ │ │ +00005b80: 7265 6374 6f72 7920 746f 2072 756e 2074 rectory to run t │ │ │ │ │ +00005b90: 6865 0a27 636f 6e66 6967 7572 6527 2073 he.'configure' s │ │ │ │ │ +00005ba0: 6372 6970 742e 2020 5468 6973 2073 6372 cript. This scr │ │ │ │ │ +00005bb0: 6970 7420 7072 6f62 6573 2074 6865 2073 ipt probes the s │ │ │ │ │ +00005bc0: 7973 7465 6d20 666f 7220 7661 7269 6f75 ystem for variou │ │ │ │ │ +00005bd0: 7320 6665 6174 7572 6573 2c0a 616e 6420 s features,.and │ │ │ │ │ +00005be0: 6669 6e61 6c6c 7920 6372 6561 7465 7320 finally creates │ │ │ │ │ +00005bf0: 7468 6520 274d 616b 6566 696c 6527 732e the 'Makefile's. │ │ │ │ │ +00005c00: 2020 496e 2074 6869 7320 746f 7920 6578 In this toy ex │ │ │ │ │ +00005c10: 616d 706c 6520 7468 6572 6520 6172 6520 ample there are │ │ │ │ │ +00005c20: 6f6e 6c79 0a74 776f 2027 4d61 6b65 6669 only.two 'Makefi │ │ │ │ │ +00005c30: 6c65 2773 2c20 6275 7420 696e 2072 6561 le's, but in rea │ │ │ │ │ +00005c40: 6c2d 776f 726c 6420 7072 6f6a 6563 7473 l-world projects │ │ │ │ │ +00005c50: 2c20 7468 6572 6520 6d61 7920 6265 206d , there may be m │ │ │ │ │ +00005c60: 616e 7920 6d6f 7265 2c0a 7573 7561 6c6c any more,.usuall │ │ │ │ │ +00005c70: 7920 6f6e 6520 274d 616b 6566 696c 6527 y one 'Makefile' │ │ │ │ │ +00005c80: 2070 6572 2064 6972 6563 746f 7279 2e0a per directory.. │ │ │ │ │ +00005c90: 0a20 2020 4974 2069 7320 6e6f 7720 706f . It is now po │ │ │ │ │ +00005ca0: 7373 6962 6c65 2074 6f20 7275 6e20 276d ssible to run 'm │ │ │ │ │ +00005cb0: 616b 6527 2e20 2054 6869 7320 7769 6c6c ake'. This will │ │ │ │ │ +00005cc0: 2063 6f6e 7374 7275 6374 2061 6c6c 2074 construct all t │ │ │ │ │ +00005cd0: 6865 0a70 726f 6772 616d 732c 206c 6962 he.programs, lib │ │ │ │ │ +00005ce0: 7261 7269 6573 2c20 616e 6420 7363 7269 raries, and scri │ │ │ │ │ +00005cf0: 7074 7320 7468 6174 206e 6565 6420 746f pts that need to │ │ │ │ │ +00005d00: 2062 6520 636f 6e73 7472 7563 7465 6420 be constructed │ │ │ │ │ +00005d10: 666f 7220 7468 650a 7061 636b 6167 652e for the.package. │ │ │ │ │ +00005d20: 2020 496e 206f 7572 2065 7861 6d70 6c65 In our example │ │ │ │ │ +00005d30: 2c20 7468 6973 2063 6f6d 7069 6c65 7320 , this compiles │ │ │ │ │ +00005d40: 7468 6520 2768 656c 6c6f 2720 7072 6f67 the 'hello' prog │ │ │ │ │ +00005d50: 7261 6d2e 2020 416c 6c20 6669 6c65 730a ram. All files. │ │ │ │ │ +00005d60: 6172 6520 636f 6e73 7472 7563 7465 6420 are constructed │ │ │ │ │ +00005d70: 696e 2070 6c61 6365 2c20 696e 2074 6865 in place, in the │ │ │ │ │ +00005d80: 2073 6f75 7263 6520 7472 6565 3b20 7765 source tree; we │ │ │ │ │ +00005d90: 2077 696c 6c20 7365 6520 6c61 7465 7220 will see later │ │ │ │ │ +00005da0: 686f 7720 7468 6973 0a63 616e 2062 6520 how this.can be │ │ │ │ │ +00005db0: 6368 616e 6765 642e 0a0a 2020 2027 6d61 changed... 'ma │ │ │ │ │ +00005dc0: 6b65 2063 6865 636b 2720 6361 7573 6573 ke check' causes │ │ │ │ │ +00005dd0: 2074 6865 2070 6163 6b61 6765 2773 2074 the package's t │ │ │ │ │ +00005de0: 6573 7473 2074 6f20 6265 2072 756e 2e20 ests to be run. │ │ │ │ │ +00005df0: 2054 6869 7320 7374 6570 2069 7320 6e6f This step is no │ │ │ │ │ +00005e00: 740a 6d61 6e64 6174 6f72 792c 2062 7574 t.mandatory, but │ │ │ │ │ +00005e10: 2069 7420 6973 206f 6674 656e 2067 6f6f it is often goo │ │ │ │ │ +00005e20: 6420 746f 206d 616b 6520 7375 7265 2074 d to make sure t │ │ │ │ │ +00005e30: 6865 2070 726f 6772 616d 7320 7468 6174 he programs that │ │ │ │ │ +00005e40: 2068 6176 6520 6265 656e 0a62 7569 6c74 have been.built │ │ │ │ │ +00005e50: 2062 6568 6176 6520 6173 2074 6865 7920 behave as they │ │ │ │ │ +00005e60: 7368 6f75 6c64 2c20 6265 666f 7265 2079 should, before y │ │ │ │ │ +00005e70: 6f75 2064 6563 6964 6520 746f 2069 6e73 ou decide to ins │ │ │ │ │ +00005e80: 7461 6c6c 2074 6865 6d2e 2020 4f75 720a tall them. Our. │ │ │ │ │ +00005e90: 6578 616d 706c 6520 646f 6573 206e 6f74 example does not │ │ │ │ │ +00005ea0: 2063 6f6e 7461 696e 2061 6e79 2074 6573 contain any tes │ │ │ │ │ +00005eb0: 7473 2c20 736f 2072 756e 6e69 6e67 2027 ts, so running ' │ │ │ │ │ +00005ec0: 6d61 6b65 2063 6865 636b 2720 6973 2061 make check' is a │ │ │ │ │ +00005ed0: 206e 6f2d 6f70 2e0a 0a20 2020 4166 7465 no-op... Afte │ │ │ │ │ +00005ee0: 7220 6576 6572 7974 6869 6e67 2068 6173 r everything has │ │ │ │ │ +00005ef0: 2062 6565 6e20 6275 696c 742c 2061 6e64 been built, and │ │ │ │ │ +00005f00: 206d 6179 6265 2074 6573 7465 642c 2069 maybe tested, i │ │ │ │ │ +00005f10: 7420 6973 2074 696d 6520 746f 0a69 6e73 t is time to.ins │ │ │ │ │ +00005f20: 7461 6c6c 2069 7420 6f6e 2074 6865 2073 tall it on the s │ │ │ │ │ +00005f30: 7973 7465 6d2e 2020 5468 6174 206d 6561 ystem. That mea │ │ │ │ │ +00005f40: 6e73 2063 6f70 7969 6e67 2074 6865 2070 ns copying the p │ │ │ │ │ +00005f50: 726f 6772 616d 732c 206c 6962 7261 7269 rograms, librari │ │ │ │ │ +00005f60: 6573 2c0a 6865 6164 6572 2066 696c 6573 es,.header files │ │ │ │ │ +00005f70: 2c20 7363 7269 7074 732c 2061 6e64 206f , scripts, and o │ │ │ │ │ +00005f80: 7468 6572 2064 6174 6120 6669 6c65 7320 ther data files │ │ │ │ │ +00005f90: 6672 6f6d 2074 6865 2073 6f75 7263 6520 from the source │ │ │ │ │ +00005fa0: 6469 7265 6374 6f72 7920 746f 0a74 6865 directory to.the │ │ │ │ │ +00005fb0: 6972 2066 696e 616c 2064 6573 7469 6e61 ir final destina │ │ │ │ │ +00005fc0: 7469 6f6e 206f 6e20 7468 6520 7379 7374 tion on the syst │ │ │ │ │ +00005fd0: 656d 2e20 2054 6865 2063 6f6d 6d61 6e64 em. The command │ │ │ │ │ +00005fe0: 2027 6d61 6b65 2069 6e73 7461 6c6c 2720 'make install' │ │ │ │ │ +00005ff0: 7769 6c6c 0a64 6f20 7468 6174 2e20 2048 will.do that. H │ │ │ │ │ +00006000: 6f77 6576 6572 2c20 6279 2064 6566 6175 owever, by defau │ │ │ │ │ +00006010: 6c74 2065 7665 7279 7468 696e 6720 7769 lt everything wi │ │ │ │ │ +00006020: 6c6c 2062 6520 696e 7374 616c 6c65 6420 ll be installed │ │ │ │ │ +00006030: 696e 0a73 7562 6469 7265 6374 6f72 6965 in.subdirectorie │ │ │ │ │ +00006040: 7320 6f66 2027 2f75 7372 2f6c 6f63 616c s of '/usr/local │ │ │ │ │ +00006050: 273a 2062 696e 6172 6965 7320 7769 6c6c ': binaries will │ │ │ │ │ +00006060: 2067 6f20 696e 746f 2027 2f75 7372 2f6c go into '/usr/l │ │ │ │ │ +00006070: 6f63 616c 2f62 696e 272c 0a6c 6962 7261 ocal/bin',.libra │ │ │ │ │ +00006080: 7269 6573 2077 696c 6c20 656e 6420 7570 ries will end up │ │ │ │ │ +00006090: 2069 6e20 272f 7573 722f 6c6f 6361 6c2f in '/usr/local/ │ │ │ │ │ +000060a0: 6c69 6227 2c20 6574 632e 2020 5468 6973 lib', etc. This │ │ │ │ │ +000060b0: 2064 6573 7469 6e61 7469 6f6e 2069 730a destination is. │ │ │ │ │ +000060c0: 7573 7561 6c6c 7920 6e6f 7420 7772 6974 usually not writ │ │ │ │ │ +000060d0: 6162 6c65 2062 7920 616e 7920 7573 6572 able by any user │ │ │ │ │ +000060e0: 2c20 736f 2077 6520 6173 7375 6d65 2074 , so we assume t │ │ │ │ │ +000060f0: 6861 7420 7765 2068 6176 6520 746f 2062 hat we have to b │ │ │ │ │ +00006100: 6563 6f6d 650a 726f 6f74 2062 6566 6f72 ecome.root befor │ │ │ │ │ +00006110: 6520 7765 2063 616e 2072 756e 2027 6d61 e we can run 'ma │ │ │ │ │ +00006120: 6b65 2069 6e73 7461 6c6c 272e 2020 496e ke install'. In │ │ │ │ │ +00006130: 206f 7572 2065 7861 6d70 6c65 2c20 7275 our example, ru │ │ │ │ │ +00006140: 6e6e 696e 6720 276d 616b 650a 696e 7374 nning 'make.inst │ │ │ │ │ +00006150: 616c 6c27 2077 696c 6c20 636f 7079 2074 all' will copy t │ │ │ │ │ +00006160: 6865 2070 726f 6772 616d 2027 6865 6c6c he program 'hell │ │ │ │ │ +00006170: 6f27 2069 6e74 6f20 272f 7573 722f 6c6f o' into '/usr/lo │ │ │ │ │ +00006180: 6361 6c2f 6269 6e27 2061 6e64 0a27 5245 cal/bin' and.'RE │ │ │ │ │ +00006190: 4144 4d45 2720 696e 746f 2027 2f75 7372 ADME' into '/usr │ │ │ │ │ +000061a0: 2f6c 6f63 616c 2f73 6861 7265 2f64 6f63 /local/share/doc │ │ │ │ │ +000061b0: 2f61 6d68 656c 6c6f 272e 0a0a 2020 2041 /amhello'... A │ │ │ │ │ +000061c0: 206c 6173 7420 616e 6420 6f70 7469 6f6e last and option │ │ │ │ │ +000061d0: 616c 2073 7465 7020 6973 2074 6f20 7275 al step is to ru │ │ │ │ │ +000061e0: 6e20 276d 616b 6520 696e 7374 616c 6c63 n 'make installc │ │ │ │ │ +000061f0: 6865 636b 272e 2020 5468 6973 2063 6f6d heck'. This com │ │ │ │ │ +00006200: 6d61 6e64 0a6d 6179 2072 756e 2074 6573 mand.may run tes │ │ │ │ │ +00006210: 7473 206f 6e20 7468 6520 696e 7374 616c ts on the instal │ │ │ │ │ +00006220: 6c65 6420 6669 6c65 732e 2020 276d 616b led files. 'mak │ │ │ │ │ +00006230: 6520 6368 6563 6b27 2074 6573 7473 2074 e check' tests t │ │ │ │ │ +00006240: 6865 2066 696c 6573 2069 6e0a 7468 6520 he files in.the │ │ │ │ │ +00006250: 736f 7572 6365 2074 7265 652c 2077 6869 source tree, whi │ │ │ │ │ +00006260: 6c65 2027 6d61 6b65 2069 6e73 7461 6c6c le 'make install │ │ │ │ │ +00006270: 6368 6563 6b27 2074 6573 7473 2074 6865 check' tests the │ │ │ │ │ +00006280: 6972 2069 6e73 7461 6c6c 6564 2063 6f70 ir installed cop │ │ │ │ │ +00006290: 6965 732e 0a54 6865 2074 6573 7473 2072 ies..The tests r │ │ │ │ │ +000062a0: 756e 2062 7920 7468 6520 6c61 7474 6572 un by the latter │ │ │ │ │ +000062b0: 2063 616e 2062 6520 6469 6666 6572 656e can be differen │ │ │ │ │ +000062c0: 7420 6672 6f6d 2074 686f 7365 2072 756e t from those run │ │ │ │ │ +000062d0: 2062 7920 7468 650a 666f 726d 6572 2e20 by the.former. │ │ │ │ │ +000062e0: 2046 6f72 2069 6e73 7461 6e63 652c 2074 For instance, t │ │ │ │ │ +000062f0: 6865 7265 2061 7265 2074 6573 7473 2074 here are tests t │ │ │ │ │ +00006300: 6861 7420 6361 6e6e 6f74 2062 6520 7275 hat cannot be ru │ │ │ │ │ +00006310: 6e20 696e 2074 6865 2073 6f75 7263 650a n in the source. │ │ │ │ │ +00006320: 7472 6565 2e20 2043 6f6e 7665 7273 656c tree. Conversel │ │ │ │ │ +00006330: 792c 2073 6f6d 6520 7061 636b 6167 6573 y, some packages │ │ │ │ │ +00006340: 2061 7265 2073 6574 2075 7020 736f 2074 are set up so t │ │ │ │ │ +00006350: 6861 7420 276d 616b 6520 696e 7374 616c hat 'make instal │ │ │ │ │ +00006360: 6c63 6865 636b 270a 7769 6c6c 2072 756e lcheck'.will run │ │ │ │ │ +00006370: 2074 6865 2076 6572 7920 7361 6d65 2074 the very same t │ │ │ │ │ +00006380: 6573 7473 2061 7320 276d 616b 6520 6368 ests as 'make ch │ │ │ │ │ +00006390: 6563 6b27 2c20 6f6e 6c79 206f 6e20 6469 eck', only on di │ │ │ │ │ +000063a0: 6666 6572 656e 7420 6669 6c65 730a 286e fferent files.(n │ │ │ │ │ +000063b0: 6f6e 2d69 6e73 7461 6c6c 6564 2076 732e on-installed vs. │ │ │ │ │ +000063c0: 2069 6e73 7461 6c6c 6564 292e 2020 4974 installed). It │ │ │ │ │ +000063d0: 2063 616e 206d 616b 6520 6120 6469 6666 can make a diff │ │ │ │ │ +000063e0: 6572 656e 6365 2c20 666f 7220 696e 7374 erence, for inst │ │ │ │ │ +000063f0: 616e 6365 0a77 6865 6e20 7468 6520 736f ance.when the so │ │ │ │ │ +00006400: 7572 6365 2074 7265 6527 7320 6c61 796f urce tree's layo │ │ │ │ │ +00006410: 7574 2069 7320 6469 6666 6572 656e 7420 ut is different │ │ │ │ │ +00006420: 6672 6f6d 2074 6861 7420 6f66 2074 6865 from that of the │ │ │ │ │ +00006430: 0a69 6e73 7461 6c6c 6174 696f 6e2e 2020 .installation. │ │ │ │ │ +00006440: 4675 7274 6865 726d 6f72 6520 6974 206d Furthermore it m │ │ │ │ │ +00006450: 6179 2068 656c 7020 746f 2064 6961 676e ay help to diagn │ │ │ │ │ +00006460: 6f73 6520 616e 2069 6e63 6f6d 706c 6574 ose an incomplet │ │ │ │ │ +00006470: 650a 696e 7374 616c 6c61 7469 6f6e 2e0a e.installation.. │ │ │ │ │ +00006480: 0a20 2020 5072 6573 656e 746c 7920 6d6f . Presently mo │ │ │ │ │ +00006490: 7374 2070 6163 6b61 6765 7320 646f 206e st packages do n │ │ │ │ │ +000064a0: 6f74 2068 6176 6520 616e 7920 2769 6e73 ot have any 'ins │ │ │ │ │ +000064b0: 7461 6c6c 6368 6563 6b27 2074 6573 7473 tallcheck' tests │ │ │ │ │ +000064c0: 2062 6563 6175 7365 0a74 6865 2065 7869 because.the exi │ │ │ │ │ +000064d0: 7374 656e 6365 206f 6620 2769 6e73 7461 stence of 'insta │ │ │ │ │ +000064e0: 6c6c 6368 6563 6b27 2069 7320 6c69 7474 llcheck' is litt │ │ │ │ │ +000064f0: 6c65 206b 6e6f 776e 2c20 616e 6420 6974 le known, and it │ │ │ │ │ +00006500: 7320 7573 6566 756c 6e65 7373 2069 730a s usefulness is. │ │ │ │ │ +00006510: 6e65 676c 6563 7465 642e 2020 4f75 7220 neglected. Our │ │ │ │ │ +00006520: 6c69 7474 6c65 2074 6f79 2070 6163 6b61 little toy packa │ │ │ │ │ +00006530: 6765 2069 7320 6e6f 2062 6574 7465 723a ge is no better: │ │ │ │ │ +00006540: 2027 6d61 6b65 2069 6e73 7461 6c6c 6368 'make installch │ │ │ │ │ +00006550: 6563 6b27 0a64 6f65 7320 6e6f 7468 696e eck'.does nothin │ │ │ │ │ +00006560: 672e 0a0a 1f0a 4669 6c65 3a20 6175 746f g.....File: auto │ │ │ │ │ +00006570: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +00006580: 204e 6f64 653a 2053 7461 6e64 6172 6420 Node: Standard │ │ │ │ │ +00006590: 5461 7267 6574 732c 2020 4e65 7874 3a20 Targets, Next: │ │ │ │ │ +000065a0: 5374 616e 6461 7264 2044 6972 6563 746f Standard Directo │ │ │ │ │ +000065b0: 7279 2056 6172 6961 626c 6573 2c20 2050 ry Variables, P │ │ │ │ │ +000065c0: 7265 763a 2042 6173 6963 2049 6e73 7461 rev: Basic Insta │ │ │ │ │ +000065d0: 6c6c 6174 696f 6e2c 2020 5570 3a20 5573 llation, Up: Us │ │ │ │ │ +000065e0: 6520 4361 7365 730a 0a32 2e32 2e32 2053 e Cases..2.2.2 S │ │ │ │ │ +000065f0: 7461 6e64 6172 6420 274d 616b 6566 696c tandard 'Makefil │ │ │ │ │ +00006600: 6527 2054 6172 6765 7473 0a2d 2d2d 2d2d e' Targets.----- │ │ │ │ │ 00006610: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00006620: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 536f 2066 ----------..So f │ │ │ │ │ -00006630: 6172 2077 6520 6861 7665 2063 6f6d 6520 ar we have come │ │ │ │ │ -00006640: 6163 726f 7373 2066 6f75 7220 7761 7973 across four ways │ │ │ │ │ -00006650: 2074 6f20 7275 6e20 276d 616b 6527 2069 to run 'make' i │ │ │ │ │ -00006660: 6e20 7468 6520 474e 5520 4275 696c 640a n the GNU Build. │ │ │ │ │ -00006670: 5379 7374 656d 3a20 276d 616b 6527 2c20 System: 'make', │ │ │ │ │ -00006680: 276d 616b 6520 6368 6563 6b27 2c20 276d 'make check', 'm │ │ │ │ │ -00006690: 616b 6520 696e 7374 616c 6c27 2c20 616e ake install', an │ │ │ │ │ -000066a0: 6420 276d 616b 6520 696e 7374 616c 6c63 d 'make installc │ │ │ │ │ -000066b0: 6865 636b 272e 0a54 6865 2077 6f72 6473 heck'..The words │ │ │ │ │ -000066c0: 2027 6368 6563 6b27 2c20 2769 6e73 7461 'check', 'insta │ │ │ │ │ -000066d0: 6c6c 272c 2061 6e64 2027 696e 7374 616c ll', and 'instal │ │ │ │ │ -000066e0: 6c63 6865 636b 272c 2070 6173 7365 6420 lcheck', passed │ │ │ │ │ -000066f0: 6173 2061 7267 756d 656e 7473 2074 6f0a as arguments to. │ │ │ │ │ -00006700: 276d 616b 6527 2c20 6172 6520 6361 6c6c 'make', are call │ │ │ │ │ -00006710: 6564 2022 7461 7267 6574 7322 2e20 2027 ed "targets". ' │ │ │ │ │ -00006720: 6d61 6b65 2720 6973 2061 2073 686f 7274 make' is a short │ │ │ │ │ -00006730: 6861 6e64 2066 6f72 2027 6d61 6b65 2061 hand for 'make a │ │ │ │ │ -00006740: 6c6c 272c 0a27 616c 6c27 2062 6569 6e67 ll',.'all' being │ │ │ │ │ -00006750: 2074 6865 2064 6566 6175 6c74 2074 6172 the default tar │ │ │ │ │ -00006760: 6765 7420 696e 2074 6865 2047 4e55 2042 get in the GNU B │ │ │ │ │ -00006770: 7569 6c64 2053 7973 7465 6d2e 0a0a 2020 uild System... │ │ │ │ │ -00006780: 2048 6572 6520 6973 2061 206c 6973 7420 Here is a list │ │ │ │ │ -00006790: 6f66 2074 6865 206d 6f73 7420 7573 6566 of the most usef │ │ │ │ │ -000067a0: 756c 2074 6172 6765 7473 2074 6861 7420 ul targets that │ │ │ │ │ -000067b0: 7468 6520 474e 5520 436f 6469 6e67 0a53 the GNU Coding.S │ │ │ │ │ -000067c0: 7461 6e64 6172 6473 2073 7065 6369 6679 tandards specify │ │ │ │ │ -000067d0: 2e0a 0a27 6d61 6b65 2061 6c6c 270a 2020 ...'make all'. │ │ │ │ │ -000067e0: 2020 2042 7569 6c64 2070 726f 6772 616d Build program │ │ │ │ │ -000067f0: 732c 206c 6962 7261 7269 6573 2c20 646f s, libraries, do │ │ │ │ │ -00006800: 6375 6d65 6e74 6174 696f 6e2c 2065 7463 cumentation, etc │ │ │ │ │ -00006810: 2e20 2873 616d 6520 6173 2027 6d61 6b65 . (same as 'make │ │ │ │ │ -00006820: 2729 2e0a 276d 616b 6520 696e 7374 616c ')..'make instal │ │ │ │ │ -00006830: 6c27 0a20 2020 2020 496e 7374 616c 6c20 l'. Install │ │ │ │ │ -00006840: 7768 6174 206e 6565 6473 2074 6f20 6265 what needs to be │ │ │ │ │ -00006850: 2069 6e73 7461 6c6c 6564 2c20 636f 7079 installed, copy │ │ │ │ │ -00006860: 696e 6720 7468 6520 6669 6c65 7320 6672 ing the files fr │ │ │ │ │ -00006870: 6f6d 2074 6865 0a20 2020 2020 7061 636b om the. pack │ │ │ │ │ -00006880: 6167 6527 7320 7472 6565 2074 6f20 7379 age's tree to sy │ │ │ │ │ -00006890: 7374 656d 2d77 6964 6520 6469 7265 6374 stem-wide direct │ │ │ │ │ -000068a0: 6f72 6965 732e 0a27 6d61 6b65 2069 6e73 ories..'make ins │ │ │ │ │ -000068b0: 7461 6c6c 2d73 7472 6970 270a 2020 2020 tall-strip'. │ │ │ │ │ -000068c0: 2053 616d 6520 6173 2027 6d61 6b65 2069 Same as 'make i │ │ │ │ │ -000068d0: 6e73 7461 6c6c 272c 2074 6865 6e20 7374 nstall', then st │ │ │ │ │ -000068e0: 7269 7020 6465 6275 6767 696e 6720 7379 rip debugging sy │ │ │ │ │ -000068f0: 6d62 6f6c 732e 2020 536f 6d65 2075 7365 mbols. Some use │ │ │ │ │ -00006900: 7273 0a20 2020 2020 6c69 6b65 2074 6f20 rs. like to │ │ │ │ │ -00006910: 7472 6164 6520 7370 6163 6520 666f 7220 trade space for │ │ │ │ │ -00006920: 7573 6566 756c 2062 7567 2072 6570 6f72 useful bug repor │ │ │ │ │ -00006930: 7473 2e2e 2e0a 276d 616b 6520 756e 696e ts....'make unin │ │ │ │ │ -00006940: 7374 616c 6c27 0a20 2020 2020 5468 6520 stall'. The │ │ │ │ │ -00006950: 6f70 706f 7369 7465 206f 6620 276d 616b opposite of 'mak │ │ │ │ │ -00006960: 6520 696e 7374 616c 6c27 3a20 6572 6173 e install': eras │ │ │ │ │ -00006970: 6520 7468 6520 696e 7374 616c 6c65 6420 e the installed │ │ │ │ │ -00006980: 6669 6c65 732e 2020 2854 6869 730a 2020 files. (This. │ │ │ │ │ -00006990: 2020 206e 6565 6473 2074 6f20 6265 2072 needs to be r │ │ │ │ │ -000069a0: 756e 2066 726f 6d20 7468 6520 7361 6d65 un from the same │ │ │ │ │ -000069b0: 2062 7569 6c64 2074 7265 6520 7468 6174 build tree that │ │ │ │ │ -000069c0: 2077 6173 2069 6e73 7461 6c6c 6564 2e29 was installed.) │ │ │ │ │ -000069d0: 0a27 6d61 6b65 2063 6c65 616e 270a 2020 .'make clean'. │ │ │ │ │ -000069e0: 2020 2045 7261 7365 2066 726f 6d20 7468 Erase from th │ │ │ │ │ -000069f0: 6520 6275 696c 6420 7472 6565 2074 6865 e build tree the │ │ │ │ │ -00006a00: 2066 696c 6573 2062 7569 6c74 2062 7920 files built by │ │ │ │ │ -00006a10: 276d 616b 6520 616c 6c27 2e0a 276d 616b 'make all'..'mak │ │ │ │ │ -00006a20: 6520 6469 7374 636c 6561 6e27 0a20 2020 e distclean'. │ │ │ │ │ -00006a30: 2020 4164 6469 7469 6f6e 616c 6c79 2065 Additionally e │ │ │ │ │ -00006a40: 7261 7365 2061 6e79 7468 696e 6720 272e rase anything '. │ │ │ │ │ -00006a50: 2f63 6f6e 6669 6775 7265 2720 6372 6561 /configure' crea │ │ │ │ │ -00006a60: 7465 642e 0a27 6d61 6b65 2063 6865 636b ted..'make check │ │ │ │ │ -00006a70: 270a 2020 2020 2052 756e 2074 6865 2074 '. Run the t │ │ │ │ │ -00006a80: 6573 7420 7375 6974 652c 2069 6620 616e est suite, if an │ │ │ │ │ -00006a90: 792e 0a27 6d61 6b65 2069 6e73 7461 6c6c y..'make install │ │ │ │ │ -00006aa0: 6368 6563 6b27 0a20 2020 2020 4368 6563 check'. Chec │ │ │ │ │ -00006ab0: 6b20 7468 6520 696e 7374 616c 6c65 6420 k the installed │ │ │ │ │ -00006ac0: 7072 6f67 7261 6d73 206f 7220 6c69 6272 programs or libr │ │ │ │ │ -00006ad0: 6172 6965 732c 2069 6620 7375 7070 6f72 aries, if suppor │ │ │ │ │ -00006ae0: 7465 642e 0a27 6d61 6b65 2064 6973 7427 ted..'make dist' │ │ │ │ │ -00006af0: 0a20 2020 2020 5265 6372 6561 7465 2027 . Recreate ' │ │ │ │ │ -00006b00: 5041 434b 4147 452d 5645 5253 494f 4e2e PACKAGE-VERSION. │ │ │ │ │ -00006b10: 7461 722e 677a 2720 6672 6f6d 2061 6c6c tar.gz' from all │ │ │ │ │ -00006b20: 2074 6865 2073 6f75 7263 6520 6669 6c65 the source file │ │ │ │ │ -00006b30: 732e 0a0a 1f0a 4669 6c65 3a20 6175 746f s.....File: auto │ │ │ │ │ -00006b40: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00006b50: 204e 6f64 653a 2053 7461 6e64 6172 6420 Node: Standard │ │ │ │ │ -00006b60: 4469 7265 6374 6f72 7920 5661 7269 6162 Directory Variab │ │ │ │ │ -00006b70: 6c65 732c 2020 4e65 7874 3a20 5374 616e les, Next: Stan │ │ │ │ │ -00006b80: 6461 7264 2043 6f6e 6669 6775 7261 7469 dard Configurati │ │ │ │ │ -00006b90: 6f6e 2056 6172 6961 626c 6573 2c20 2050 on Variables, P │ │ │ │ │ -00006ba0: 7265 763a 2053 7461 6e64 6172 6420 5461 rev: Standard Ta │ │ │ │ │ -00006bb0: 7267 6574 732c 2020 5570 3a20 5573 6520 rgets, Up: Use │ │ │ │ │ -00006bc0: 4361 7365 730a 0a32 2e32 2e33 2053 7461 Cases..2.2.3 Sta │ │ │ │ │ -00006bd0: 6e64 6172 6420 4469 7265 6374 6f72 7920 ndard Directory │ │ │ │ │ -00006be0: 5661 7269 6162 6c65 730a 2d2d 2d2d 2d2d Variables.------ │ │ │ │ │ +00006620: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 536f ------------..So │ │ │ │ │ +00006630: 2066 6172 2077 6520 6861 7665 2063 6f6d far we have com │ │ │ │ │ +00006640: 6520 6163 726f 7373 2066 6f75 7220 7761 e across four wa │ │ │ │ │ +00006650: 7973 2074 6f20 7275 6e20 276d 616b 6527 ys to run 'make' │ │ │ │ │ +00006660: 2069 6e20 7468 6520 474e 5520 4275 696c in the GNU Buil │ │ │ │ │ +00006670: 640a 5379 7374 656d 3a20 276d 616b 6527 d.System: 'make' │ │ │ │ │ +00006680: 2c20 276d 616b 6520 6368 6563 6b27 2c20 , 'make check', │ │ │ │ │ +00006690: 276d 616b 6520 696e 7374 616c 6c27 2c20 'make install', │ │ │ │ │ +000066a0: 616e 6420 276d 616b 6520 696e 7374 616c and 'make instal │ │ │ │ │ +000066b0: 6c63 6865 636b 272e 0a54 6865 2077 6f72 lcheck'..The wor │ │ │ │ │ +000066c0: 6473 2027 6368 6563 6b27 2c20 2769 6e73 ds 'check', 'ins │ │ │ │ │ +000066d0: 7461 6c6c 272c 2061 6e64 2027 696e 7374 tall', and 'inst │ │ │ │ │ +000066e0: 616c 6c63 6865 636b 272c 2070 6173 7365 allcheck', passe │ │ │ │ │ +000066f0: 6420 6173 2061 7267 756d 656e 7473 2074 d as arguments t │ │ │ │ │ +00006700: 6f0a 276d 616b 6527 2c20 6172 6520 6361 o.'make', are ca │ │ │ │ │ +00006710: 6c6c 6564 2022 7461 7267 6574 7322 2e20 lled "targets". │ │ │ │ │ +00006720: 2027 6d61 6b65 2720 6973 2061 2073 686f 'make' is a sho │ │ │ │ │ +00006730: 7274 6861 6e64 2066 6f72 2027 6d61 6b65 rthand for 'make │ │ │ │ │ +00006740: 2061 6c6c 272c 0a27 616c 6c27 2062 6569 all',.'all' bei │ │ │ │ │ +00006750: 6e67 2074 6865 2064 6566 6175 6c74 2074 ng the default t │ │ │ │ │ +00006760: 6172 6765 7420 696e 2074 6865 2047 4e55 arget in the GNU │ │ │ │ │ +00006770: 2042 7569 6c64 2053 7973 7465 6d2e 0a0a Build System... │ │ │ │ │ +00006780: 2020 2048 6572 6520 6973 2061 206c 6973 Here is a lis │ │ │ │ │ +00006790: 7420 6f66 2074 6865 206d 6f73 7420 7573 t of the most us │ │ │ │ │ +000067a0: 6566 756c 2074 6172 6765 7473 2074 6861 eful targets tha │ │ │ │ │ +000067b0: 7420 7468 6520 474e 5520 436f 6469 6e67 t the GNU Coding │ │ │ │ │ +000067c0: 0a53 7461 6e64 6172 6473 2073 7065 6369 .Standards speci │ │ │ │ │ +000067d0: 6679 2e0a 0a27 6d61 6b65 2061 6c6c 270a fy...'make all'. │ │ │ │ │ +000067e0: 2020 2020 2042 7569 6c64 2070 726f 6772 Build progr │ │ │ │ │ +000067f0: 616d 732c 206c 6962 7261 7269 6573 2c20 ams, libraries, │ │ │ │ │ +00006800: 646f 6375 6d65 6e74 6174 696f 6e2c 2065 documentation, e │ │ │ │ │ +00006810: 7463 2e20 2873 616d 6520 6173 2027 6d61 tc. (same as 'ma │ │ │ │ │ +00006820: 6b65 2729 2e0a 276d 616b 6520 696e 7374 ke')..'make inst │ │ │ │ │ +00006830: 616c 6c27 0a20 2020 2020 496e 7374 616c all'. Instal │ │ │ │ │ +00006840: 6c20 7768 6174 206e 6565 6473 2074 6f20 l what needs to │ │ │ │ │ +00006850: 6265 2069 6e73 7461 6c6c 6564 2c20 636f be installed, co │ │ │ │ │ +00006860: 7079 696e 6720 7468 6520 6669 6c65 7320 pying the files │ │ │ │ │ +00006870: 6672 6f6d 2074 6865 0a20 2020 2020 7061 from the. pa │ │ │ │ │ +00006880: 636b 6167 6527 7320 7472 6565 2074 6f20 ckage's tree to │ │ │ │ │ +00006890: 7379 7374 656d 2d77 6964 6520 6469 7265 system-wide dire │ │ │ │ │ +000068a0: 6374 6f72 6965 732e 0a27 6d61 6b65 2069 ctories..'make i │ │ │ │ │ +000068b0: 6e73 7461 6c6c 2d73 7472 6970 270a 2020 nstall-strip'. │ │ │ │ │ +000068c0: 2020 2053 616d 6520 6173 2027 6d61 6b65 Same as 'make │ │ │ │ │ +000068d0: 2069 6e73 7461 6c6c 272c 2074 6865 6e20 install', then │ │ │ │ │ +000068e0: 7374 7269 7020 6465 6275 6767 696e 6720 strip debugging │ │ │ │ │ +000068f0: 7379 6d62 6f6c 732e 2020 536f 6d65 2075 symbols. Some u │ │ │ │ │ +00006900: 7365 7273 0a20 2020 2020 6c69 6b65 2074 sers. like t │ │ │ │ │ +00006910: 6f20 7472 6164 6520 7370 6163 6520 666f o trade space fo │ │ │ │ │ +00006920: 7220 7573 6566 756c 2062 7567 2072 6570 r useful bug rep │ │ │ │ │ +00006930: 6f72 7473 2e2e 2e0a 276d 616b 6520 756e orts....'make un │ │ │ │ │ +00006940: 696e 7374 616c 6c27 0a20 2020 2020 5468 install'. Th │ │ │ │ │ +00006950: 6520 6f70 706f 7369 7465 206f 6620 276d e opposite of 'm │ │ │ │ │ +00006960: 616b 6520 696e 7374 616c 6c27 3a20 6572 ake install': er │ │ │ │ │ +00006970: 6173 6520 7468 6520 696e 7374 616c 6c65 ase the installe │ │ │ │ │ +00006980: 6420 6669 6c65 732e 2020 2854 6869 730a d files. (This. │ │ │ │ │ +00006990: 2020 2020 206e 6565 6473 2074 6f20 6265 needs to be │ │ │ │ │ +000069a0: 2072 756e 2066 726f 6d20 7468 6520 7361 run from the sa │ │ │ │ │ +000069b0: 6d65 2062 7569 6c64 2074 7265 6520 7468 me build tree th │ │ │ │ │ +000069c0: 6174 2077 6173 2069 6e73 7461 6c6c 6564 at was installed │ │ │ │ │ +000069d0: 2e29 0a27 6d61 6b65 2063 6c65 616e 270a .).'make clean'. │ │ │ │ │ +000069e0: 2020 2020 2045 7261 7365 2066 726f 6d20 Erase from │ │ │ │ │ +000069f0: 7468 6520 6275 696c 6420 7472 6565 2074 the build tree t │ │ │ │ │ +00006a00: 6865 2066 696c 6573 2062 7569 6c74 2062 he files built b │ │ │ │ │ +00006a10: 7920 276d 616b 6520 616c 6c27 2e0a 276d y 'make all'..'m │ │ │ │ │ +00006a20: 616b 6520 6469 7374 636c 6561 6e27 0a20 ake distclean'. │ │ │ │ │ +00006a30: 2020 2020 4164 6469 7469 6f6e 616c 6c79 Additionally │ │ │ │ │ +00006a40: 2065 7261 7365 2061 6e79 7468 696e 6720 erase anything │ │ │ │ │ +00006a50: 272e 2f63 6f6e 6669 6775 7265 2720 6372 './configure' cr │ │ │ │ │ +00006a60: 6561 7465 642e 0a27 6d61 6b65 2063 6865 eated..'make che │ │ │ │ │ +00006a70: 636b 270a 2020 2020 2052 756e 2074 6865 ck'. Run the │ │ │ │ │ +00006a80: 2074 6573 7420 7375 6974 652c 2069 6620 test suite, if │ │ │ │ │ +00006a90: 616e 792e 0a27 6d61 6b65 2069 6e73 7461 any..'make insta │ │ │ │ │ +00006aa0: 6c6c 6368 6563 6b27 0a20 2020 2020 4368 llcheck'. Ch │ │ │ │ │ +00006ab0: 6563 6b20 7468 6520 696e 7374 616c 6c65 eck the installe │ │ │ │ │ +00006ac0: 6420 7072 6f67 7261 6d73 206f 7220 6c69 d programs or li │ │ │ │ │ +00006ad0: 6272 6172 6965 732c 2069 6620 7375 7070 braries, if supp │ │ │ │ │ +00006ae0: 6f72 7465 642e 0a27 6d61 6b65 2064 6973 orted..'make dis │ │ │ │ │ +00006af0: 7427 0a20 2020 2020 5265 6372 6561 7465 t'. Recreate │ │ │ │ │ +00006b00: 2027 5041 434b 4147 452d 5645 5253 494f 'PACKAGE-VERSIO │ │ │ │ │ +00006b10: 4e2e 7461 722e 677a 2720 6672 6f6d 2061 N.tar.gz' from a │ │ │ │ │ +00006b20: 6c6c 2074 6865 2073 6f75 7263 6520 6669 ll the source fi │ │ │ │ │ +00006b30: 6c65 732e 0a0a 1f0a 4669 6c65 3a20 6175 les.....File: au │ │ │ │ │ +00006b40: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00006b50: 2c20 204e 6f64 653a 2053 7461 6e64 6172 , Node: Standar │ │ │ │ │ +00006b60: 6420 4469 7265 6374 6f72 7920 5661 7269 d Directory Vari │ │ │ │ │ +00006b70: 6162 6c65 732c 2020 4e65 7874 3a20 5374 ables, Next: St │ │ │ │ │ +00006b80: 616e 6461 7264 2043 6f6e 6669 6775 7261 andard Configura │ │ │ │ │ +00006b90: 7469 6f6e 2056 6172 6961 626c 6573 2c20 tion Variables, │ │ │ │ │ +00006ba0: 2050 7265 763a 2053 7461 6e64 6172 6420 Prev: Standard │ │ │ │ │ +00006bb0: 5461 7267 6574 732c 2020 5570 3a20 5573 Targets, Up: Us │ │ │ │ │ +00006bc0: 6520 4361 7365 730a 0a32 2e32 2e33 2053 e Cases..2.2.3 S │ │ │ │ │ +00006bd0: 7461 6e64 6172 6420 4469 7265 6374 6f72 tandard Director │ │ │ │ │ +00006be0: 7920 5661 7269 6162 6c65 730a 2d2d 2d2d y Variables.---- │ │ │ │ │ 00006bf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00006c00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ │ -00006c10: 6520 474e 5520 436f 6469 6e67 2053 7461 e GNU Coding Sta │ │ │ │ │ -00006c20: 6e64 6172 6473 2061 6c73 6f20 7370 6563 ndards also spec │ │ │ │ │ -00006c30: 6966 7920 6120 6869 6572 6172 6368 7920 ify a hierarchy │ │ │ │ │ -00006c40: 6f66 2076 6172 6961 626c 6573 2074 6f20 of variables to │ │ │ │ │ -00006c50: 6465 6e6f 7465 0a69 6e73 7461 6c6c 6174 denote.installat │ │ │ │ │ -00006c60: 696f 6e20 6469 7265 6374 6f72 6965 732e ion directories. │ │ │ │ │ -00006c70: 2020 536f 6d65 206f 6620 7468 6573 6520 Some of these │ │ │ │ │ -00006c80: 6172 653a 0a0a 4469 7265 6374 6f72 7920 are:..Directory │ │ │ │ │ -00006c90: 7661 7269 6162 6c65 2020 2044 6566 6175 variable Defau │ │ │ │ │ -00006ca0: 6c74 2076 616c 7565 0a2d 2d2d 2d2d 2d2d lt value.------- │ │ │ │ │ +00006c00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00006c10: 5468 6520 474e 5520 436f 6469 6e67 2053 The GNU Coding S │ │ │ │ │ +00006c20: 7461 6e64 6172 6473 2061 6c73 6f20 7370 tandards also sp │ │ │ │ │ +00006c30: 6563 6966 7920 6120 6869 6572 6172 6368 ecify a hierarch │ │ │ │ │ +00006c40: 7920 6f66 2076 6172 6961 626c 6573 2074 y of variables t │ │ │ │ │ +00006c50: 6f20 6465 6e6f 7465 0a69 6e73 7461 6c6c o denote.install │ │ │ │ │ +00006c60: 6174 696f 6e20 6469 7265 6374 6f72 6965 ation directorie │ │ │ │ │ +00006c70: 732e 2020 536f 6d65 206f 6620 7468 6573 s. Some of thes │ │ │ │ │ +00006c80: 6520 6172 653a 0a0a 4469 7265 6374 6f72 e are:..Director │ │ │ │ │ +00006c90: 7920 7661 7269 6162 6c65 2020 2044 6566 y variable Def │ │ │ │ │ +00006ca0: 6175 6c74 2076 616c 7565 0a2d 2d2d 2d2d ault value.----- │ │ │ │ │ 00006cb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00006cc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00006cd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00006ce0: 0a27 7072 6566 6978 2720 2020 2020 2020 .'prefix' │ │ │ │ │ -00006cf0: 2020 2020 2020 272f 7573 722f 6c6f 6361 '/usr/loca │ │ │ │ │ -00006d00: 6c27 0a20 2027 6578 6563 5f70 7265 6669 l'. 'exec_prefi │ │ │ │ │ -00006d10: 7827 2020 2020 2020 2724 7b70 7265 6669 x' '${prefi │ │ │ │ │ -00006d20: 787d 270a 2020 2020 2762 696e 6469 7227 x}'. 'bindir' │ │ │ │ │ -00006d30: 2020 2020 2020 2020 2027 247b 6578 6563 '${exec │ │ │ │ │ -00006d40: 5f70 7265 6669 787d 2f62 696e 270a 2020 _prefix}/bin'. │ │ │ │ │ -00006d50: 2020 276c 6962 6469 7227 2020 2020 2020 'libdir' │ │ │ │ │ -00006d60: 2020 2027 247b 6578 6563 5f70 7265 6669 '${exec_prefi │ │ │ │ │ -00006d70: 787d 2f6c 6962 270a 2020 2020 2e2e 2e0a x}/lib'. .... │ │ │ │ │ -00006d80: 2020 2769 6e63 6c75 6465 6469 7227 2020 'includedir' │ │ │ │ │ -00006d90: 2020 2020 2027 247b 7072 6566 6978 7d2f '${prefix}/ │ │ │ │ │ -00006da0: 696e 636c 7564 6527 0a20 2027 6461 7461 include'. 'data │ │ │ │ │ -00006db0: 726f 6f74 6469 7227 2020 2020 2020 2724 rootdir' '$ │ │ │ │ │ -00006dc0: 7b70 7265 6669 787d 2f73 6861 7265 270a {prefix}/share'. │ │ │ │ │ -00006dd0: 2020 2020 2764 6174 6164 6972 2720 2020 'datadir' │ │ │ │ │ -00006de0: 2020 2020 2027 247b 6461 7461 726f 6f74 '${dataroot │ │ │ │ │ -00006df0: 6469 727d 270a 2020 2020 276d 616e 6469 dir}'. 'mandi │ │ │ │ │ -00006e00: 7227 2020 2020 2020 2020 2027 247b 6461 r' '${da │ │ │ │ │ -00006e10: 7461 726f 6f74 6469 727d 2f6d 616e 270a tarootdir}/man'. │ │ │ │ │ -00006e20: 2020 2020 2769 6e66 6f64 6972 2720 2020 'infodir' │ │ │ │ │ -00006e30: 2020 2020 2027 247b 6461 7461 726f 6f74 '${dataroot │ │ │ │ │ -00006e40: 6469 727d 2f69 6e66 6f27 0a20 2020 2027 dir}/info'. ' │ │ │ │ │ -00006e50: 646f 6364 6972 2720 2020 2020 2020 2020 docdir' │ │ │ │ │ -00006e60: 2724 7b64 6174 6172 6f6f 7464 6972 7d2f '${datarootdir}/ │ │ │ │ │ -00006e70: 646f 632f 247b 5041 434b 4147 457d 270a doc/${PACKAGE}'. │ │ │ │ │ -00006e80: 2020 2e2e 2e0a 0a20 2020 4561 6368 206f ..... Each o │ │ │ │ │ -00006e90: 6620 7468 6573 6520 6469 7265 6374 6f72 f these director │ │ │ │ │ -00006ea0: 6965 7320 6861 7320 6120 726f 6c65 2077 ies has a role w │ │ │ │ │ -00006eb0: 6869 6368 2069 7320 6f66 7465 6e20 6f62 hich is often ob │ │ │ │ │ -00006ec0: 7669 6f75 7320 6672 6f6d 2069 7473 0a6e vious from its.n │ │ │ │ │ -00006ed0: 616d 652e 2020 496e 2061 2070 6163 6b61 ame. In a packa │ │ │ │ │ -00006ee0: 6765 2c20 616e 7920 696e 7374 616c 6c61 ge, any installa │ │ │ │ │ -00006ef0: 626c 6520 6669 6c65 2077 696c 6c20 6265 ble file will be │ │ │ │ │ -00006f00: 2069 6e73 7461 6c6c 6564 2069 6e20 6f6e installed in on │ │ │ │ │ -00006f10: 6520 6f66 0a74 6865 7365 2064 6972 6563 e of.these direc │ │ │ │ │ -00006f20: 746f 7269 6573 2e20 2046 6f72 2069 6e73 tories. For ins │ │ │ │ │ -00006f30: 7461 6e63 6520 696e 2027 616d 6865 6c6c tance in 'amhell │ │ │ │ │ -00006f40: 6f2d 312e 3027 2c20 7468 6520 7072 6f67 o-1.0', the prog │ │ │ │ │ -00006f50: 7261 6d20 2768 656c 6c6f 270a 6973 2074 ram 'hello'.is t │ │ │ │ │ -00006f60: 6f20 6265 2069 6e73 7461 6c6c 6564 2069 o be installed i │ │ │ │ │ -00006f70: 6e20 4249 4e44 4952 2c20 7468 6520 6469 n BINDIR, the di │ │ │ │ │ -00006f80: 7265 6374 6f72 7920 666f 7220 6269 6e61 rectory for bina │ │ │ │ │ -00006f90: 7269 6573 2e20 2054 6865 2064 6566 6175 ries. The defau │ │ │ │ │ -00006fa0: 6c74 0a76 616c 7565 2066 6f72 2074 6869 lt.value for thi │ │ │ │ │ -00006fb0: 7320 6469 7265 6374 6f72 7920 6973 2027 s directory is ' │ │ │ │ │ -00006fc0: 2f75 7372 2f6c 6f63 616c 2f62 696e 272c /usr/local/bin', │ │ │ │ │ -00006fd0: 2062 7574 2074 6865 2075 7365 7220 6361 but the user ca │ │ │ │ │ -00006fe0: 6e20 7375 7070 6c79 2061 0a64 6966 6665 n supply a.diffe │ │ │ │ │ -00006ff0: 7265 6e74 2076 616c 7565 2077 6865 6e20 rent value when │ │ │ │ │ -00007000: 6361 6c6c 696e 6720 2763 6f6e 6669 6775 calling 'configu │ │ │ │ │ -00007010: 7265 272e 2020 416c 736f 2074 6865 2066 re'. Also the f │ │ │ │ │ -00007020: 696c 6520 2752 4541 444d 4527 2077 696c ile 'README' wil │ │ │ │ │ -00007030: 6c0a 6265 2069 6e73 7461 6c6c 6564 2069 l.be installed i │ │ │ │ │ -00007040: 6e74 6f20 444f 4344 4952 2c20 7768 6963 nto DOCDIR, whic │ │ │ │ │ -00007050: 6820 6465 6661 756c 7473 2074 6f0a 272f h defaults to.'/ │ │ │ │ │ -00007060: 7573 722f 6c6f 6361 6c2f 7368 6172 652f usr/local/share/ │ │ │ │ │ -00007070: 646f 632f 616d 6865 6c6c 6f27 2e0a 0a20 doc/amhello'... │ │ │ │ │ -00007080: 2020 4173 2061 2075 7365 722c 2069 6620 As a user, if │ │ │ │ │ -00007090: 796f 7520 7769 7368 2074 6f20 696e 7374 you wish to inst │ │ │ │ │ -000070a0: 616c 6c20 6120 7061 636b 6167 6520 6f6e all a package on │ │ │ │ │ -000070b0: 2079 6f75 7220 6f77 6e20 6163 636f 756e your own accoun │ │ │ │ │ -000070c0: 742c 2079 6f75 0a63 6f75 6c64 2070 726f t, you.could pro │ │ │ │ │ -000070d0: 6365 6564 2061 7320 666f 6c6c 6f77 733a ceed as follows: │ │ │ │ │ -000070e0: 0a0a 2020 2020 207e 2f61 6d68 656c 6c6f .. ~/amhello │ │ │ │ │ -000070f0: 2d31 2e30 2025 202e 2f63 6f6e 6669 6775 -1.0 % ./configu │ │ │ │ │ -00007100: 7265 202d 2d70 7265 6669 7820 7e2f 7573 re --prefix ~/us │ │ │ │ │ -00007110: 720a 2020 2020 202e 2e2e 0a20 2020 2020 r. .... │ │ │ │ │ -00007120: 7e2f 616d 6865 6c6c 6f2d 312e 3020 2520 ~/amhello-1.0 % │ │ │ │ │ -00007130: 6d61 6b65 0a20 2020 2020 2e2e 2e0a 2020 make. .... │ │ │ │ │ -00007140: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ -00007150: 2025 206d 616b 6520 696e 7374 616c 6c0a % make install. │ │ │ │ │ -00007160: 2020 2020 202e 2e2e 0a0a 2020 2054 6869 ..... Thi │ │ │ │ │ -00007170: 7320 776f 756c 6420 696e 7374 616c 6c20 s would install │ │ │ │ │ -00007180: 277e 2f75 7372 2f62 696e 2f68 656c 6c6f '~/usr/bin/hello │ │ │ │ │ -00007190: 2720 616e 640a 277e 2f75 7372 2f73 6861 ' and.'~/usr/sha │ │ │ │ │ -000071a0: 7265 2f64 6f63 2f61 6d68 656c 6c6f 2f52 re/doc/amhello/R │ │ │ │ │ -000071b0: 4541 444d 4527 2e0a 0a20 2020 5468 6520 EADME'... The │ │ │ │ │ -000071c0: 6c69 7374 206f 6620 616c 6c20 7375 6368 list of all such │ │ │ │ │ -000071d0: 2064 6972 6563 746f 7279 206f 7074 696f directory optio │ │ │ │ │ -000071e0: 6e73 2069 7320 7368 6f77 6e20 6279 2027 ns is shown by ' │ │ │ │ │ -000071f0: 2e2f 636f 6e66 6967 7572 650a 2d2d 6865 ./configure.--he │ │ │ │ │ -00007200: 6c70 272e 0a0a 1f0a 4669 6c65 3a20 6175 lp'.....File: au │ │ │ │ │ -00007210: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -00007220: 2c20 204e 6f64 653a 2053 7461 6e64 6172 , Node: Standar │ │ │ │ │ -00007230: 6420 436f 6e66 6967 7572 6174 696f 6e20 d Configuration │ │ │ │ │ -00007240: 5661 7269 6162 6c65 732c 2020 4e65 7874 Variables, Next │ │ │ │ │ -00007250: 3a20 636f 6e66 6967 2e73 6974 652c 2020 : config.site, │ │ │ │ │ -00007260: 5072 6576 3a20 5374 616e 6461 7264 2044 Prev: Standard D │ │ │ │ │ -00007270: 6972 6563 746f 7279 2056 6172 6961 626c irectory Variabl │ │ │ │ │ -00007280: 6573 2c20 2055 703a 2055 7365 2043 6173 es, Up: Use Cas │ │ │ │ │ -00007290: 6573 0a0a 322e 322e 3420 5374 616e 6461 es..2.2.4 Standa │ │ │ │ │ -000072a0: 7264 2043 6f6e 6669 6775 7261 7469 6f6e rd Configuration │ │ │ │ │ -000072b0: 2056 6172 6961 626c 6573 0a2d 2d2d 2d2d Variables.----- │ │ │ │ │ +00006ce0: 2d2d 0a27 7072 6566 6978 2720 2020 2020 --.'prefix' │ │ │ │ │ +00006cf0: 2020 2020 2020 2020 272f 7573 722f 6c6f '/usr/lo │ │ │ │ │ +00006d00: 6361 6c27 0a20 2027 6578 6563 5f70 7265 cal'. 'exec_pre │ │ │ │ │ +00006d10: 6669 7827 2020 2020 2020 2724 7b70 7265 fix' '${pre │ │ │ │ │ +00006d20: 6669 787d 270a 2020 2020 2762 696e 6469 fix}'. 'bindi │ │ │ │ │ +00006d30: 7227 2020 2020 2020 2020 2027 247b 6578 r' '${ex │ │ │ │ │ +00006d40: 6563 5f70 7265 6669 787d 2f62 696e 270a ec_prefix}/bin'. │ │ │ │ │ +00006d50: 2020 2020 276c 6962 6469 7227 2020 2020 'libdir' │ │ │ │ │ +00006d60: 2020 2020 2027 247b 6578 6563 5f70 7265 '${exec_pre │ │ │ │ │ +00006d70: 6669 787d 2f6c 6962 270a 2020 2020 2e2e fix}/lib'. .. │ │ │ │ │ +00006d80: 2e0a 2020 2769 6e63 6c75 6465 6469 7227 .. 'includedir' │ │ │ │ │ +00006d90: 2020 2020 2020 2027 247b 7072 6566 6978 '${prefix │ │ │ │ │ +00006da0: 7d2f 696e 636c 7564 6527 0a20 2027 6461 }/include'. 'da │ │ │ │ │ +00006db0: 7461 726f 6f74 6469 7227 2020 2020 2020 tarootdir' │ │ │ │ │ +00006dc0: 2724 7b70 7265 6669 787d 2f73 6861 7265 '${prefix}/share │ │ │ │ │ +00006dd0: 270a 2020 2020 2764 6174 6164 6972 2720 '. 'datadir' │ │ │ │ │ +00006de0: 2020 2020 2020 2027 247b 6461 7461 726f '${dataro │ │ │ │ │ +00006df0: 6f74 6469 727d 270a 2020 2020 276d 616e otdir}'. 'man │ │ │ │ │ +00006e00: 6469 7227 2020 2020 2020 2020 2027 247b dir' '${ │ │ │ │ │ +00006e10: 6461 7461 726f 6f74 6469 727d 2f6d 616e datarootdir}/man │ │ │ │ │ +00006e20: 270a 2020 2020 2769 6e66 6f64 6972 2720 '. 'infodir' │ │ │ │ │ +00006e30: 2020 2020 2020 2027 247b 6461 7461 726f '${dataro │ │ │ │ │ +00006e40: 6f74 6469 727d 2f69 6e66 6f27 0a20 2020 otdir}/info'. │ │ │ │ │ +00006e50: 2027 646f 6364 6972 2720 2020 2020 2020 'docdir' │ │ │ │ │ +00006e60: 2020 2724 7b64 6174 6172 6f6f 7464 6972 '${datarootdir │ │ │ │ │ +00006e70: 7d2f 646f 632f 247b 5041 434b 4147 457d }/doc/${PACKAGE} │ │ │ │ │ +00006e80: 270a 2020 2e2e 2e0a 0a20 2020 4561 6368 '. ..... Each │ │ │ │ │ +00006e90: 206f 6620 7468 6573 6520 6469 7265 6374 of these direct │ │ │ │ │ +00006ea0: 6f72 6965 7320 6861 7320 6120 726f 6c65 ories has a role │ │ │ │ │ +00006eb0: 2077 6869 6368 2069 7320 6f66 7465 6e20 which is often │ │ │ │ │ +00006ec0: 6f62 7669 6f75 7320 6672 6f6d 2069 7473 obvious from its │ │ │ │ │ +00006ed0: 0a6e 616d 652e 2020 496e 2061 2070 6163 .name. In a pac │ │ │ │ │ +00006ee0: 6b61 6765 2c20 616e 7920 696e 7374 616c kage, any instal │ │ │ │ │ +00006ef0: 6c61 626c 6520 6669 6c65 2077 696c 6c20 lable file will │ │ │ │ │ +00006f00: 6265 2069 6e73 7461 6c6c 6564 2069 6e20 be installed in │ │ │ │ │ +00006f10: 6f6e 6520 6f66 0a74 6865 7365 2064 6972 one of.these dir │ │ │ │ │ +00006f20: 6563 746f 7269 6573 2e20 2046 6f72 2069 ectories. For i │ │ │ │ │ +00006f30: 6e73 7461 6e63 6520 696e 2027 616d 6865 nstance in 'amhe │ │ │ │ │ +00006f40: 6c6c 6f2d 312e 3027 2c20 7468 6520 7072 llo-1.0', the pr │ │ │ │ │ +00006f50: 6f67 7261 6d20 2768 656c 6c6f 270a 6973 ogram 'hello'.is │ │ │ │ │ +00006f60: 2074 6f20 6265 2069 6e73 7461 6c6c 6564 to be installed │ │ │ │ │ +00006f70: 2069 6e20 4249 4e44 4952 2c20 7468 6520 in BINDIR, the │ │ │ │ │ +00006f80: 6469 7265 6374 6f72 7920 666f 7220 6269 directory for bi │ │ │ │ │ +00006f90: 6e61 7269 6573 2e20 2054 6865 2064 6566 naries. The def │ │ │ │ │ +00006fa0: 6175 6c74 0a76 616c 7565 2066 6f72 2074 ault.value for t │ │ │ │ │ +00006fb0: 6869 7320 6469 7265 6374 6f72 7920 6973 his directory is │ │ │ │ │ +00006fc0: 2027 2f75 7372 2f6c 6f63 616c 2f62 696e '/usr/local/bin │ │ │ │ │ +00006fd0: 272c 2062 7574 2074 6865 2075 7365 7220 ', but the user │ │ │ │ │ +00006fe0: 6361 6e20 7375 7070 6c79 2061 0a64 6966 can supply a.dif │ │ │ │ │ +00006ff0: 6665 7265 6e74 2076 616c 7565 2077 6865 ferent value whe │ │ │ │ │ +00007000: 6e20 6361 6c6c 696e 6720 2763 6f6e 6669 n calling 'confi │ │ │ │ │ +00007010: 6775 7265 272e 2020 416c 736f 2074 6865 gure'. Also the │ │ │ │ │ +00007020: 2066 696c 6520 2752 4541 444d 4527 2077 file 'README' w │ │ │ │ │ +00007030: 696c 6c0a 6265 2069 6e73 7461 6c6c 6564 ill.be installed │ │ │ │ │ +00007040: 2069 6e74 6f20 444f 4344 4952 2c20 7768 into DOCDIR, wh │ │ │ │ │ +00007050: 6963 6820 6465 6661 756c 7473 2074 6f0a ich defaults to. │ │ │ │ │ +00007060: 272f 7573 722f 6c6f 6361 6c2f 7368 6172 '/usr/local/shar │ │ │ │ │ +00007070: 652f 646f 632f 616d 6865 6c6c 6f27 2e0a e/doc/amhello'.. │ │ │ │ │ +00007080: 0a20 2020 4173 2061 2075 7365 722c 2069 . As a user, i │ │ │ │ │ +00007090: 6620 796f 7520 7769 7368 2074 6f20 696e f you wish to in │ │ │ │ │ +000070a0: 7374 616c 6c20 6120 7061 636b 6167 6520 stall a package │ │ │ │ │ +000070b0: 6f6e 2079 6f75 7220 6f77 6e20 6163 636f on your own acco │ │ │ │ │ +000070c0: 756e 742c 2079 6f75 0a63 6f75 6c64 2070 unt, you.could p │ │ │ │ │ +000070d0: 726f 6365 6564 2061 7320 666f 6c6c 6f77 roceed as follow │ │ │ │ │ +000070e0: 733a 0a0a 2020 2020 207e 2f61 6d68 656c s:.. ~/amhel │ │ │ │ │ +000070f0: 6c6f 2d31 2e30 2025 202e 2f63 6f6e 6669 lo-1.0 % ./confi │ │ │ │ │ +00007100: 6775 7265 202d 2d70 7265 6669 7820 7e2f gure --prefix ~/ │ │ │ │ │ +00007110: 7573 720a 2020 2020 202e 2e2e 0a20 2020 usr. .... │ │ │ │ │ +00007120: 2020 7e2f 616d 6865 6c6c 6f2d 312e 3020 ~/amhello-1.0 │ │ │ │ │ +00007130: 2520 6d61 6b65 0a20 2020 2020 2e2e 2e0a % make. .... │ │ │ │ │ +00007140: 2020 2020 207e 2f61 6d68 656c 6c6f 2d31 ~/amhello-1 │ │ │ │ │ +00007150: 2e30 2025 206d 616b 6520 696e 7374 616c .0 % make instal │ │ │ │ │ +00007160: 6c0a 2020 2020 202e 2e2e 0a0a 2020 2054 l. ..... T │ │ │ │ │ +00007170: 6869 7320 776f 756c 6420 696e 7374 616c his would instal │ │ │ │ │ +00007180: 6c20 277e 2f75 7372 2f62 696e 2f68 656c l '~/usr/bin/hel │ │ │ │ │ +00007190: 6c6f 2720 616e 640a 277e 2f75 7372 2f73 lo' and.'~/usr/s │ │ │ │ │ +000071a0: 6861 7265 2f64 6f63 2f61 6d68 656c 6c6f hare/doc/amhello │ │ │ │ │ +000071b0: 2f52 4541 444d 4527 2e0a 0a20 2020 5468 /README'... Th │ │ │ │ │ +000071c0: 6520 6c69 7374 206f 6620 616c 6c20 7375 e list of all su │ │ │ │ │ +000071d0: 6368 2064 6972 6563 746f 7279 206f 7074 ch directory opt │ │ │ │ │ +000071e0: 696f 6e73 2069 7320 7368 6f77 6e20 6279 ions is shown by │ │ │ │ │ +000071f0: 2027 2e2f 636f 6e66 6967 7572 650a 2d2d './configure.-- │ │ │ │ │ +00007200: 6865 6c70 272e 0a0a 1f0a 4669 6c65 3a20 help'.....File: │ │ │ │ │ +00007210: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +00007220: 666f 2c20 204e 6f64 653a 2053 7461 6e64 fo, Node: Stand │ │ │ │ │ +00007230: 6172 6420 436f 6e66 6967 7572 6174 696f ard Configuratio │ │ │ │ │ +00007240: 6e20 5661 7269 6162 6c65 732c 2020 4e65 n Variables, Ne │ │ │ │ │ +00007250: 7874 3a20 636f 6e66 6967 2e73 6974 652c xt: config.site, │ │ │ │ │ +00007260: 2020 5072 6576 3a20 5374 616e 6461 7264 Prev: Standard │ │ │ │ │ +00007270: 2044 6972 6563 746f 7279 2056 6172 6961 Directory Varia │ │ │ │ │ +00007280: 626c 6573 2c20 2055 703a 2055 7365 2043 bles, Up: Use C │ │ │ │ │ +00007290: 6173 6573 0a0a 322e 322e 3420 5374 616e ases..2.2.4 Stan │ │ │ │ │ +000072a0: 6461 7264 2043 6f6e 6669 6775 7261 7469 dard Configurati │ │ │ │ │ +000072b0: 6f6e 2056 6172 6961 626c 6573 0a2d 2d2d on Variables.--- │ │ │ │ │ 000072c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 000072d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000072e0: 2d0a 0a54 6865 2047 4e55 2043 6f64 696e -..The GNU Codin │ │ │ │ │ -000072f0: 6720 5374 616e 6461 7264 7320 616c 736f g Standards also │ │ │ │ │ -00007300: 2064 6566 696e 6520 6120 7365 7420 6f66 define a set of │ │ │ │ │ -00007310: 2073 7461 6e64 6172 6420 636f 6e66 6967 standard config │ │ │ │ │ -00007320: 7572 6174 696f 6e0a 7661 7269 6162 6c65 uration.variable │ │ │ │ │ -00007330: 7320 7573 6564 2064 7572 696e 6720 7468 s used during th │ │ │ │ │ -00007340: 6520 6275 696c 642e 2020 4865 7265 2061 e build. Here a │ │ │ │ │ -00007350: 7265 2073 6f6d 653a 0a0a 2743 4327 0a20 re some:..'CC'. │ │ │ │ │ -00007360: 2020 2020 4320 636f 6d70 696c 6572 2063 C compiler c │ │ │ │ │ -00007370: 6f6d 6d61 6e64 0a27 4346 4c41 4753 270a ommand.'CFLAGS'. │ │ │ │ │ -00007380: 2020 2020 2043 2063 6f6d 7069 6c65 7220 C compiler │ │ │ │ │ -00007390: 666c 6167 730a 2743 5858 270a 2020 2020 flags.'CXX'. │ │ │ │ │ -000073a0: 2043 2b2b 2063 6f6d 7069 6c65 7220 636f C++ compiler co │ │ │ │ │ -000073b0: 6d6d 616e 640a 2743 5858 464c 4147 5327 mmand.'CXXFLAGS' │ │ │ │ │ -000073c0: 0a20 2020 2020 432b 2b20 636f 6d70 696c . C++ compil │ │ │ │ │ -000073d0: 6572 2066 6c61 6773 0a27 4c44 464c 4147 er flags.'LDFLAG │ │ │ │ │ -000073e0: 5327 0a20 2020 2020 6c69 6e6b 6572 2066 S'. linker f │ │ │ │ │ -000073f0: 6c61 6773 0a27 4350 5046 4c41 4753 270a lags.'CPPFLAGS'. │ │ │ │ │ -00007400: 2020 2020 2043 2f43 2b2b 2070 7265 7072 C/C++ prepr │ │ │ │ │ -00007410: 6f63 6573 736f 7220 666c 6167 730a 2e2e ocessor flags... │ │ │ │ │ -00007420: 2e0a 0a20 2020 2763 6f6e 6669 6775 7265 ... 'configure │ │ │ │ │ -00007430: 2720 7573 7561 6c6c 7920 646f 6573 2061 ' usually does a │ │ │ │ │ -00007440: 2067 6f6f 6420 6a6f 6220 6174 2073 6574 good job at set │ │ │ │ │ -00007450: 7469 6e67 2061 7070 726f 7072 6961 7465 ting appropriate │ │ │ │ │ -00007460: 2076 616c 7565 7320 666f 720a 7468 6573 values for.thes │ │ │ │ │ -00007470: 6520 7661 7269 6162 6c65 732c 2062 7574 e variables, but │ │ │ │ │ -00007480: 2074 6865 7265 2061 7265 2063 6173 6573 there are cases │ │ │ │ │ -00007490: 2077 6865 7265 2079 6f75 206d 6179 2077 where you may w │ │ │ │ │ -000074a0: 616e 7420 746f 206f 7665 7272 6964 650a ant to override. │ │ │ │ │ -000074b0: 7468 656d 2e20 2046 6f72 2069 6e73 7461 them. For insta │ │ │ │ │ -000074c0: 6e63 6520 796f 7520 6d61 7920 6861 7665 nce you may have │ │ │ │ │ -000074d0: 2073 6576 6572 616c 2076 6572 7369 6f6e several version │ │ │ │ │ -000074e0: 7320 6f66 2061 2063 6f6d 7069 6c65 720a s of a compiler. │ │ │ │ │ -000074f0: 696e 7374 616c 6c65 6420 616e 6420 776f installed and wo │ │ │ │ │ -00007500: 756c 6420 6c69 6b65 2074 6f20 7573 6520 uld like to use │ │ │ │ │ -00007510: 616e 6f74 6865 7220 6f6e 652c 2079 6f75 another one, you │ │ │ │ │ -00007520: 206d 6179 2068 6176 6520 6865 6164 6572 may have header │ │ │ │ │ -00007530: 2066 696c 6573 0a69 6e73 7461 6c6c 6564 files.installed │ │ │ │ │ -00007540: 206f 7574 7369 6465 2074 6865 2064 6566 outside the def │ │ │ │ │ -00007550: 6175 6c74 2073 6561 7263 6820 7061 7468 ault search path │ │ │ │ │ -00007560: 206f 6620 7468 6520 636f 6d70 696c 6572 of the compiler │ │ │ │ │ -00007570: 2c20 6f72 2065 7665 6e0a 6c69 6272 6172 , or even.librar │ │ │ │ │ -00007580: 6965 7320 6f75 7420 6f66 2074 6865 2077 ies out of the w │ │ │ │ │ -00007590: 6179 206f 6620 7468 6520 6c69 6e6b 6572 ay of the linker │ │ │ │ │ -000075a0: 2e0a 0a20 2020 4865 7265 2069 7320 686f ... Here is ho │ │ │ │ │ -000075b0: 7720 6f6e 6520 776f 756c 6420 6361 6c6c w one would call │ │ │ │ │ -000075c0: 2027 636f 6e66 6967 7572 6527 2074 6f20 'configure' to │ │ │ │ │ -000075d0: 666f 7263 6520 6974 2074 6f20 7573 6520 force it to use │ │ │ │ │ -000075e0: 2767 6363 2d33 2720 6173 0a43 2063 6f6d 'gcc-3' as.C com │ │ │ │ │ -000075f0: 7069 6c65 722c 2075 7365 2068 6561 6465 piler, use heade │ │ │ │ │ -00007600: 7220 6669 6c65 7320 6672 6f6d 2027 7e2f r files from '~/ │ │ │ │ │ -00007610: 7573 722f 696e 636c 7564 6527 2077 6865 usr/include' whe │ │ │ │ │ -00007620: 6e20 636f 6d70 696c 696e 672c 2061 6e64 n compiling, and │ │ │ │ │ -00007630: 0a6c 6962 7261 7269 6573 2066 726f 6d20 .libraries from │ │ │ │ │ -00007640: 277e 2f75 7372 2f6c 6962 2720 7768 656e '~/usr/lib' when │ │ │ │ │ -00007650: 206c 696e 6b69 6e67 2e0a 0a20 2020 2020 linking... │ │ │ │ │ -00007660: 7e2f 616d 6865 6c6c 6f2d 312e 3020 2520 ~/amhello-1.0 % │ │ │ │ │ -00007670: 2e2f 636f 6e66 6967 7572 6520 2d2d 7072 ./configure --pr │ │ │ │ │ -00007680: 6566 6978 207e 2f75 7372 2043 433d 6763 efix ~/usr CC=gc │ │ │ │ │ -00007690: 632d 3320 5c0a 2020 2020 2043 5050 464c c-3 \. CPPFL │ │ │ │ │ -000076a0: 4147 533d 2d49 2448 4f4d 452f 7573 722f AGS=-I$HOME/usr/ │ │ │ │ │ -000076b0: 696e 636c 7564 6520 4c44 464c 4147 533d include LDFLAGS= │ │ │ │ │ -000076c0: 2d4c 2448 4f4d 452f 7573 722f 6c69 620a -L$HOME/usr/lib. │ │ │ │ │ -000076d0: 0a20 2020 4167 6169 6e2c 2061 2066 756c . Again, a ful │ │ │ │ │ -000076e0: 6c20 6c69 7374 206f 6620 7468 6573 6520 l list of these │ │ │ │ │ -000076f0: 7661 7269 6162 6c65 7320 6170 7065 6172 variables appear │ │ │ │ │ -00007700: 7320 696e 2074 6865 206f 7574 7075 7420 s in the output │ │ │ │ │ -00007710: 6f66 0a27 2e2f 636f 6e66 6967 7572 6520 of.'./configure │ │ │ │ │ -00007720: 2d2d 6865 6c70 272e 0a0a 1f0a 4669 6c65 --help'.....File │ │ │ │ │ -00007730: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -00007740: 696e 666f 2c20 204e 6f64 653a 2063 6f6e info, Node: con │ │ │ │ │ -00007750: 6669 672e 7369 7465 2c20 204e 6578 743a fig.site, Next: │ │ │ │ │ -00007760: 2056 5041 5448 2042 7569 6c64 732c 2020 VPATH Builds, │ │ │ │ │ -00007770: 5072 6576 3a20 5374 616e 6461 7264 2043 Prev: Standard C │ │ │ │ │ -00007780: 6f6e 6669 6775 7261 7469 6f6e 2056 6172 onfiguration Var │ │ │ │ │ -00007790: 6961 626c 6573 2c20 2055 703a 2055 7365 iables, Up: Use │ │ │ │ │ -000077a0: 2043 6173 6573 0a0a 322e 322e 3520 4f76 Cases..2.2.5 Ov │ │ │ │ │ -000077b0: 6572 7269 6469 6e67 2044 6566 6175 6c74 erriding Default │ │ │ │ │ -000077c0: 2043 6f6e 6669 6775 7261 7469 6f6e 2053 Configuration S │ │ │ │ │ -000077d0: 6574 7469 6e67 2077 6974 6820 2763 6f6e etting with 'con │ │ │ │ │ -000077e0: 6669 672e 7369 7465 270a 2d2d 2d2d 2d2d fig.site'.------ │ │ │ │ │ +000072e0: 2d2d 2d0a 0a54 6865 2047 4e55 2043 6f64 ---..The GNU Cod │ │ │ │ │ +000072f0: 696e 6720 5374 616e 6461 7264 7320 616c ing Standards al │ │ │ │ │ +00007300: 736f 2064 6566 696e 6520 6120 7365 7420 so define a set │ │ │ │ │ +00007310: 6f66 2073 7461 6e64 6172 6420 636f 6e66 of standard conf │ │ │ │ │ +00007320: 6967 7572 6174 696f 6e0a 7661 7269 6162 iguration.variab │ │ │ │ │ +00007330: 6c65 7320 7573 6564 2064 7572 696e 6720 les used during │ │ │ │ │ +00007340: 7468 6520 6275 696c 642e 2020 4865 7265 the build. Here │ │ │ │ │ +00007350: 2061 7265 2073 6f6d 653a 0a0a 2743 4327 are some:..'CC' │ │ │ │ │ +00007360: 0a20 2020 2020 4320 636f 6d70 696c 6572 . C compiler │ │ │ │ │ +00007370: 2063 6f6d 6d61 6e64 0a27 4346 4c41 4753 command.'CFLAGS │ │ │ │ │ +00007380: 270a 2020 2020 2043 2063 6f6d 7069 6c65 '. C compile │ │ │ │ │ +00007390: 7220 666c 6167 730a 2743 5858 270a 2020 r flags.'CXX'. │ │ │ │ │ +000073a0: 2020 2043 2b2b 2063 6f6d 7069 6c65 7220 C++ compiler │ │ │ │ │ +000073b0: 636f 6d6d 616e 640a 2743 5858 464c 4147 command.'CXXFLAG │ │ │ │ │ +000073c0: 5327 0a20 2020 2020 432b 2b20 636f 6d70 S'. C++ comp │ │ │ │ │ +000073d0: 696c 6572 2066 6c61 6773 0a27 4c44 464c iler flags.'LDFL │ │ │ │ │ +000073e0: 4147 5327 0a20 2020 2020 6c69 6e6b 6572 AGS'. linker │ │ │ │ │ +000073f0: 2066 6c61 6773 0a27 4350 5046 4c41 4753 flags.'CPPFLAGS │ │ │ │ │ +00007400: 270a 2020 2020 2043 2f43 2b2b 2070 7265 '. C/C++ pre │ │ │ │ │ +00007410: 7072 6f63 6573 736f 7220 666c 6167 730a processor flags. │ │ │ │ │ +00007420: 2e2e 2e0a 0a20 2020 2763 6f6e 6669 6775 ..... 'configu │ │ │ │ │ +00007430: 7265 2720 7573 7561 6c6c 7920 646f 6573 re' usually does │ │ │ │ │ +00007440: 2061 2067 6f6f 6420 6a6f 6220 6174 2073 a good job at s │ │ │ │ │ +00007450: 6574 7469 6e67 2061 7070 726f 7072 6961 etting appropria │ │ │ │ │ +00007460: 7465 2076 616c 7565 7320 666f 720a 7468 te values for.th │ │ │ │ │ +00007470: 6573 6520 7661 7269 6162 6c65 732c 2062 ese variables, b │ │ │ │ │ +00007480: 7574 2074 6865 7265 2061 7265 2063 6173 ut there are cas │ │ │ │ │ +00007490: 6573 2077 6865 7265 2079 6f75 206d 6179 es where you may │ │ │ │ │ +000074a0: 2077 616e 7420 746f 206f 7665 7272 6964 want to overrid │ │ │ │ │ +000074b0: 650a 7468 656d 2e20 2046 6f72 2069 6e73 e.them. For ins │ │ │ │ │ +000074c0: 7461 6e63 6520 796f 7520 6d61 7920 6861 tance you may ha │ │ │ │ │ +000074d0: 7665 2073 6576 6572 616c 2076 6572 7369 ve several versi │ │ │ │ │ +000074e0: 6f6e 7320 6f66 2061 2063 6f6d 7069 6c65 ons of a compile │ │ │ │ │ +000074f0: 720a 696e 7374 616c 6c65 6420 616e 6420 r.installed and │ │ │ │ │ +00007500: 776f 756c 6420 6c69 6b65 2074 6f20 7573 would like to us │ │ │ │ │ +00007510: 6520 616e 6f74 6865 7220 6f6e 652c 2079 e another one, y │ │ │ │ │ +00007520: 6f75 206d 6179 2068 6176 6520 6865 6164 ou may have head │ │ │ │ │ +00007530: 6572 2066 696c 6573 0a69 6e73 7461 6c6c er files.install │ │ │ │ │ +00007540: 6564 206f 7574 7369 6465 2074 6865 2064 ed outside the d │ │ │ │ │ +00007550: 6566 6175 6c74 2073 6561 7263 6820 7061 efault search pa │ │ │ │ │ +00007560: 7468 206f 6620 7468 6520 636f 6d70 696c th of the compil │ │ │ │ │ +00007570: 6572 2c20 6f72 2065 7665 6e0a 6c69 6272 er, or even.libr │ │ │ │ │ +00007580: 6172 6965 7320 6f75 7420 6f66 2074 6865 aries out of the │ │ │ │ │ +00007590: 2077 6179 206f 6620 7468 6520 6c69 6e6b way of the link │ │ │ │ │ +000075a0: 6572 2e0a 0a20 2020 4865 7265 2069 7320 er... Here is │ │ │ │ │ +000075b0: 686f 7720 6f6e 6520 776f 756c 6420 6361 how one would ca │ │ │ │ │ +000075c0: 6c6c 2027 636f 6e66 6967 7572 6527 2074 ll 'configure' t │ │ │ │ │ +000075d0: 6f20 666f 7263 6520 6974 2074 6f20 7573 o force it to us │ │ │ │ │ +000075e0: 6520 2767 6363 2d33 2720 6173 0a43 2063 e 'gcc-3' as.C c │ │ │ │ │ +000075f0: 6f6d 7069 6c65 722c 2075 7365 2068 6561 ompiler, use hea │ │ │ │ │ +00007600: 6465 7220 6669 6c65 7320 6672 6f6d 2027 der files from ' │ │ │ │ │ +00007610: 7e2f 7573 722f 696e 636c 7564 6527 2077 ~/usr/include' w │ │ │ │ │ +00007620: 6865 6e20 636f 6d70 696c 696e 672c 2061 hen compiling, a │ │ │ │ │ +00007630: 6e64 0a6c 6962 7261 7269 6573 2066 726f nd.libraries fro │ │ │ │ │ +00007640: 6d20 277e 2f75 7372 2f6c 6962 2720 7768 m '~/usr/lib' wh │ │ │ │ │ +00007650: 656e 206c 696e 6b69 6e67 2e0a 0a20 2020 en linking... │ │ │ │ │ +00007660: 2020 7e2f 616d 6865 6c6c 6f2d 312e 3020 ~/amhello-1.0 │ │ │ │ │ +00007670: 2520 2e2f 636f 6e66 6967 7572 6520 2d2d % ./configure -- │ │ │ │ │ +00007680: 7072 6566 6978 207e 2f75 7372 2043 433d prefix ~/usr CC= │ │ │ │ │ +00007690: 6763 632d 3320 5c0a 2020 2020 2043 5050 gcc-3 \. CPP │ │ │ │ │ +000076a0: 464c 4147 533d 2d49 2448 4f4d 452f 7573 FLAGS=-I$HOME/us │ │ │ │ │ +000076b0: 722f 696e 636c 7564 6520 4c44 464c 4147 r/include LDFLAG │ │ │ │ │ +000076c0: 533d 2d4c 2448 4f4d 452f 7573 722f 6c69 S=-L$HOME/usr/li │ │ │ │ │ +000076d0: 620a 0a20 2020 4167 6169 6e2c 2061 2066 b.. Again, a f │ │ │ │ │ +000076e0: 756c 6c20 6c69 7374 206f 6620 7468 6573 ull list of thes │ │ │ │ │ +000076f0: 6520 7661 7269 6162 6c65 7320 6170 7065 e variables appe │ │ │ │ │ +00007700: 6172 7320 696e 2074 6865 206f 7574 7075 ars in the outpu │ │ │ │ │ +00007710: 7420 6f66 0a27 2e2f 636f 6e66 6967 7572 t of.'./configur │ │ │ │ │ +00007720: 6520 2d2d 6865 6c70 272e 0a0a 1f0a 4669 e --help'.....Fi │ │ │ │ │ +00007730: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +00007740: 312e 696e 666f 2c20 204e 6f64 653a 2063 1.info, Node: c │ │ │ │ │ +00007750: 6f6e 6669 672e 7369 7465 2c20 204e 6578 onfig.site, Nex │ │ │ │ │ +00007760: 743a 2056 5041 5448 2042 7569 6c64 732c t: VPATH Builds, │ │ │ │ │ +00007770: 2020 5072 6576 3a20 5374 616e 6461 7264 Prev: Standard │ │ │ │ │ +00007780: 2043 6f6e 6669 6775 7261 7469 6f6e 2056 Configuration V │ │ │ │ │ +00007790: 6172 6961 626c 6573 2c20 2055 703a 2055 ariables, Up: U │ │ │ │ │ +000077a0: 7365 2043 6173 6573 0a0a 322e 322e 3520 se Cases..2.2.5 │ │ │ │ │ +000077b0: 4f76 6572 7269 6469 6e67 2044 6566 6175 Overriding Defau │ │ │ │ │ +000077c0: 6c74 2043 6f6e 6669 6775 7261 7469 6f6e lt Configuration │ │ │ │ │ +000077d0: 2053 6574 7469 6e67 2077 6974 6820 2763 Setting with 'c │ │ │ │ │ +000077e0: 6f6e 6669 672e 7369 7465 270a 2d2d 2d2d onfig.site'.---- │ │ │ │ │ 000077f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00007800: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00007810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00007820: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a57 6865 -----------..Whe │ │ │ │ │ -00007830: 6e20 696e 7374 616c 6c69 6e67 2073 6576 n installing sev │ │ │ │ │ -00007840: 6572 616c 2070 6163 6b61 6765 7320 7573 eral packages us │ │ │ │ │ -00007850: 696e 6720 7468 6520 7361 6d65 2073 6574 ing the same set │ │ │ │ │ -00007860: 7570 2c20 6974 2063 616e 2062 650a 636f up, it can be.co │ │ │ │ │ -00007870: 6e76 656e 6965 6e74 2074 6f20 6372 6561 nvenient to crea │ │ │ │ │ -00007880: 7465 2061 2066 696c 6520 746f 2063 6170 te a file to cap │ │ │ │ │ -00007890: 7475 7265 2063 6f6d 6d6f 6e20 7365 7474 ture common sett │ │ │ │ │ -000078a0: 696e 6773 2e20 2049 6620 6120 6669 6c65 ings. If a file │ │ │ │ │ -000078b0: 206e 616d 6564 0a27 5052 4546 4958 2f73 named.'PREFIX/s │ │ │ │ │ -000078c0: 6861 7265 2f63 6f6e 6669 672e 7369 7465 hare/config.site │ │ │ │ │ -000078d0: 2720 6578 6973 7473 2c20 2763 6f6e 6669 ' exists, 'confi │ │ │ │ │ -000078e0: 6775 7265 2720 7769 6c6c 2073 6f75 7263 gure' will sourc │ │ │ │ │ -000078f0: 6520 6974 2061 7420 7468 650a 6265 6769 e it at the.begi │ │ │ │ │ -00007900: 6e6e 696e 6720 6f66 2069 7473 2065 7865 nning of its exe │ │ │ │ │ -00007910: 6375 7469 6f6e 2e0a 0a20 2020 5265 6361 cution... Reca │ │ │ │ │ -00007920: 6c6c 2074 6865 2063 6f6d 6d61 6e64 2066 ll the command f │ │ │ │ │ -00007930: 726f 6d20 7468 6520 7072 6576 696f 7573 rom the previous │ │ │ │ │ -00007940: 2073 6563 7469 6f6e 3a0a 0a20 2020 2020 section:.. │ │ │ │ │ -00007950: 7e2f 616d 6865 6c6c 6f2d 312e 3020 2520 ~/amhello-1.0 % │ │ │ │ │ -00007960: 2e2f 636f 6e66 6967 7572 6520 2d2d 7072 ./configure --pr │ │ │ │ │ -00007970: 6566 6978 207e 2f75 7372 2043 433d 6763 efix ~/usr CC=gc │ │ │ │ │ -00007980: 632d 3320 5c0a 2020 2020 2043 5050 464c c-3 \. CPPFL │ │ │ │ │ -00007990: 4147 533d 2d49 2448 4f4d 452f 7573 722f AGS=-I$HOME/usr/ │ │ │ │ │ -000079a0: 696e 636c 7564 6520 4c44 464c 4147 533d include LDFLAGS= │ │ │ │ │ -000079b0: 2d4c 2448 4f4d 452f 7573 722f 6c69 620a -L$HOME/usr/lib. │ │ │ │ │ -000079c0: 0a20 2020 4173 7375 6d69 6e67 2077 6520 . Assuming we │ │ │ │ │ -000079d0: 6172 6520 696e 7374 616c 6c69 6e67 206d are installing m │ │ │ │ │ -000079e0: 616e 7920 7061 636b 6167 6520 696e 2027 any package in ' │ │ │ │ │ -000079f0: 7e2f 7573 7227 2c20 616e 6420 7769 6c6c ~/usr', and will │ │ │ │ │ -00007a00: 2061 6c77 6179 730a 7761 6e74 2074 6f20 always.want to │ │ │ │ │ -00007a10: 7573 6520 7468 6573 6520 6465 6669 6e69 use these defini │ │ │ │ │ -00007a20: 7469 6f6e 7320 6f66 2027 4343 272c 2027 tions of 'CC', ' │ │ │ │ │ -00007a30: 4350 5046 4c41 4753 272c 2061 6e64 2027 CPPFLAGS', and ' │ │ │ │ │ -00007a40: 4c44 464c 4147 5327 2c20 7765 2063 616e LDFLAGS', we can │ │ │ │ │ -00007a50: 0a61 7574 6f6d 6174 6520 7468 6973 2062 .automate this b │ │ │ │ │ -00007a60: 7920 6372 6561 7469 6e67 2074 6865 2066 y creating the f │ │ │ │ │ -00007a70: 6f6c 6c6f 7769 6e67 2027 7e2f 7573 722f ollowing '~/usr/ │ │ │ │ │ -00007a80: 7368 6172 652f 636f 6e66 6967 2e73 6974 share/config.sit │ │ │ │ │ -00007a90: 6527 2066 696c 653a 0a0a 2020 2020 2074 e' file:.. t │ │ │ │ │ -00007aa0: 6573 7420 2d7a 2022 2443 4322 2026 2620 est -z "$CC" && │ │ │ │ │ -00007ab0: 4343 3d67 6363 2d33 0a20 2020 2020 7465 CC=gcc-3. te │ │ │ │ │ -00007ac0: 7374 202d 7a20 2224 4350 5046 4c41 4753 st -z "$CPPFLAGS │ │ │ │ │ -00007ad0: 2220 2626 2043 5050 464c 4147 533d 2d49 " && CPPFLAGS=-I │ │ │ │ │ -00007ae0: 2448 4f4d 452f 7573 722f 696e 636c 7564 $HOME/usr/includ │ │ │ │ │ -00007af0: 650a 2020 2020 2074 6573 7420 2d7a 2022 e. test -z " │ │ │ │ │ -00007b00: 244c 4446 4c41 4753 2220 2626 204c 4446 $LDFLAGS" && LDF │ │ │ │ │ -00007b10: 4c41 4753 3d2d 4c24 484f 4d45 2f75 7372 LAGS=-L$HOME/usr │ │ │ │ │ -00007b20: 2f6c 6962 0a0a 2020 204e 6f77 2c20 616e /lib.. Now, an │ │ │ │ │ -00007b30: 7920 7469 6d65 2061 2027 636f 6e66 6967 y time a 'config │ │ │ │ │ -00007b40: 7572 6527 2073 6372 6970 7420 6973 2075 ure' script is u │ │ │ │ │ -00007b50: 7369 6e67 2074 6865 2027 7e2f 7573 7227 sing the '~/usr' │ │ │ │ │ -00007b60: 2070 7265 6669 782c 2069 740a 7769 6c6c prefix, it.will │ │ │ │ │ -00007b70: 2065 7865 6375 7465 2074 6865 2061 626f execute the abo │ │ │ │ │ -00007b80: 7665 2027 636f 6e66 6967 2e73 6974 6527 ve 'config.site' │ │ │ │ │ -00007b90: 2061 6e64 2064 6566 696e 6520 7468 6573 and define thes │ │ │ │ │ -00007ba0: 6520 7468 7265 6520 7661 7269 6162 6c65 e three variable │ │ │ │ │ -00007bb0: 732e 0a0a 2020 2020 207e 2f61 6d68 656c s... ~/amhel │ │ │ │ │ -00007bc0: 6c6f 2d31 2e30 2025 202e 2f63 6f6e 6669 lo-1.0 % ./confi │ │ │ │ │ -00007bd0: 6775 7265 202d 2d70 7265 6669 7820 7e2f gure --prefix ~/ │ │ │ │ │ -00007be0: 7573 720a 2020 2020 2063 6f6e 6669 6775 usr. configu │ │ │ │ │ -00007bf0: 7265 3a20 6c6f 6164 696e 6720 7369 7465 re: loading site │ │ │ │ │ -00007c00: 2073 6372 6970 7420 2f68 6f6d 652f 6164 script /home/ad │ │ │ │ │ -00007c10: 6c2f 7573 722f 7368 6172 652f 636f 6e66 l/usr/share/conf │ │ │ │ │ -00007c20: 6967 2e73 6974 650a 2020 2020 202e 2e2e ig.site. ... │ │ │ │ │ -00007c30: 0a0a 2020 202a 4e6f 7465 2053 6574 7469 .. *Note Setti │ │ │ │ │ -00007c40: 6e67 2053 6974 6520 4465 6661 756c 7473 ng Site Defaults │ │ │ │ │ -00007c50: 3a20 2861 7574 6f63 6f6e 6629 5369 7465 : (autoconf)Site │ │ │ │ │ -00007c60: 2044 6566 6175 6c74 732c 2066 6f72 206d Defaults, for m │ │ │ │ │ -00007c70: 6f72 650a 696e 666f 726d 6174 696f 6e20 ore.information │ │ │ │ │ -00007c80: 6162 6f75 7420 7468 6973 2066 6561 7475 about this featu │ │ │ │ │ -00007c90: 7265 2e0a 0a1f 0a46 696c 653a 2061 7574 re.....File: aut │ │ │ │ │ -00007ca0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -00007cb0: 2020 4e6f 6465 3a20 5650 4154 4820 4275 Node: VPATH Bu │ │ │ │ │ -00007cc0: 696c 6473 2c20 204e 6578 743a 2054 776f ilds, Next: Two │ │ │ │ │ -00007cd0: 2d50 6172 7420 496e 7374 616c 6c2c 2020 -Part Install, │ │ │ │ │ -00007ce0: 5072 6576 3a20 636f 6e66 6967 2e73 6974 Prev: config.sit │ │ │ │ │ -00007cf0: 652c 2020 5570 3a20 5573 6520 4361 7365 e, Up: Use Case │ │ │ │ │ -00007d00: 730a 0a32 2e32 2e36 2050 6172 616c 6c65 s..2.2.6 Paralle │ │ │ │ │ -00007d10: 6c20 4275 696c 6420 5472 6565 7320 2861 l Build Trees (a │ │ │ │ │ -00007d20: 2e6b 2e61 2e20 5650 4154 4820 4275 696c .k.a. VPATH Buil │ │ │ │ │ -00007d30: 6473 290a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ds).------------ │ │ │ │ │ +00007820: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a57 -------------..W │ │ │ │ │ +00007830: 6865 6e20 696e 7374 616c 6c69 6e67 2073 hen installing s │ │ │ │ │ +00007840: 6576 6572 616c 2070 6163 6b61 6765 7320 everal packages │ │ │ │ │ +00007850: 7573 696e 6720 7468 6520 7361 6d65 2073 using the same s │ │ │ │ │ +00007860: 6574 7570 2c20 6974 2063 616e 2062 650a etup, it can be. │ │ │ │ │ +00007870: 636f 6e76 656e 6965 6e74 2074 6f20 6372 convenient to cr │ │ │ │ │ +00007880: 6561 7465 2061 2066 696c 6520 746f 2063 eate a file to c │ │ │ │ │ +00007890: 6170 7475 7265 2063 6f6d 6d6f 6e20 7365 apture common se │ │ │ │ │ +000078a0: 7474 696e 6773 2e20 2049 6620 6120 6669 ttings. If a fi │ │ │ │ │ +000078b0: 6c65 206e 616d 6564 0a27 5052 4546 4958 le named.'PREFIX │ │ │ │ │ +000078c0: 2f73 6861 7265 2f63 6f6e 6669 672e 7369 /share/config.si │ │ │ │ │ +000078d0: 7465 2720 6578 6973 7473 2c20 2763 6f6e te' exists, 'con │ │ │ │ │ +000078e0: 6669 6775 7265 2720 7769 6c6c 2073 6f75 figure' will sou │ │ │ │ │ +000078f0: 7263 6520 6974 2061 7420 7468 650a 6265 rce it at the.be │ │ │ │ │ +00007900: 6769 6e6e 696e 6720 6f66 2069 7473 2065 ginning of its e │ │ │ │ │ +00007910: 7865 6375 7469 6f6e 2e0a 0a20 2020 5265 xecution... Re │ │ │ │ │ +00007920: 6361 6c6c 2074 6865 2063 6f6d 6d61 6e64 call the command │ │ │ │ │ +00007930: 2066 726f 6d20 7468 6520 7072 6576 696f from the previo │ │ │ │ │ +00007940: 7573 2073 6563 7469 6f6e 3a0a 0a20 2020 us section:.. │ │ │ │ │ +00007950: 2020 7e2f 616d 6865 6c6c 6f2d 312e 3020 ~/amhello-1.0 │ │ │ │ │ +00007960: 2520 2e2f 636f 6e66 6967 7572 6520 2d2d % ./configure -- │ │ │ │ │ +00007970: 7072 6566 6978 207e 2f75 7372 2043 433d prefix ~/usr CC= │ │ │ │ │ +00007980: 6763 632d 3320 5c0a 2020 2020 2043 5050 gcc-3 \. CPP │ │ │ │ │ +00007990: 464c 4147 533d 2d49 2448 4f4d 452f 7573 FLAGS=-I$HOME/us │ │ │ │ │ +000079a0: 722f 696e 636c 7564 6520 4c44 464c 4147 r/include LDFLAG │ │ │ │ │ +000079b0: 533d 2d4c 2448 4f4d 452f 7573 722f 6c69 S=-L$HOME/usr/li │ │ │ │ │ +000079c0: 620a 0a20 2020 4173 7375 6d69 6e67 2077 b.. Assuming w │ │ │ │ │ +000079d0: 6520 6172 6520 696e 7374 616c 6c69 6e67 e are installing │ │ │ │ │ +000079e0: 206d 616e 7920 7061 636b 6167 6520 696e many package in │ │ │ │ │ +000079f0: 2027 7e2f 7573 7227 2c20 616e 6420 7769 '~/usr', and wi │ │ │ │ │ +00007a00: 6c6c 2061 6c77 6179 730a 7761 6e74 2074 ll always.want t │ │ │ │ │ +00007a10: 6f20 7573 6520 7468 6573 6520 6465 6669 o use these defi │ │ │ │ │ +00007a20: 6e69 7469 6f6e 7320 6f66 2027 4343 272c nitions of 'CC', │ │ │ │ │ +00007a30: 2027 4350 5046 4c41 4753 272c 2061 6e64 'CPPFLAGS', and │ │ │ │ │ +00007a40: 2027 4c44 464c 4147 5327 2c20 7765 2063 'LDFLAGS', we c │ │ │ │ │ +00007a50: 616e 0a61 7574 6f6d 6174 6520 7468 6973 an.automate this │ │ │ │ │ +00007a60: 2062 7920 6372 6561 7469 6e67 2074 6865 by creating the │ │ │ │ │ +00007a70: 2066 6f6c 6c6f 7769 6e67 2027 7e2f 7573 following '~/us │ │ │ │ │ +00007a80: 722f 7368 6172 652f 636f 6e66 6967 2e73 r/share/config.s │ │ │ │ │ +00007a90: 6974 6527 2066 696c 653a 0a0a 2020 2020 ite' file:.. │ │ │ │ │ +00007aa0: 2074 6573 7420 2d7a 2022 2443 4322 2026 test -z "$CC" & │ │ │ │ │ +00007ab0: 2620 4343 3d67 6363 2d33 0a20 2020 2020 & CC=gcc-3. │ │ │ │ │ +00007ac0: 7465 7374 202d 7a20 2224 4350 5046 4c41 test -z "$CPPFLA │ │ │ │ │ +00007ad0: 4753 2220 2626 2043 5050 464c 4147 533d GS" && CPPFLAGS= │ │ │ │ │ +00007ae0: 2d49 2448 4f4d 452f 7573 722f 696e 636c -I$HOME/usr/incl │ │ │ │ │ +00007af0: 7564 650a 2020 2020 2074 6573 7420 2d7a ude. test -z │ │ │ │ │ +00007b00: 2022 244c 4446 4c41 4753 2220 2626 204c "$LDFLAGS" && L │ │ │ │ │ +00007b10: 4446 4c41 4753 3d2d 4c24 484f 4d45 2f75 DFLAGS=-L$HOME/u │ │ │ │ │ +00007b20: 7372 2f6c 6962 0a0a 2020 204e 6f77 2c20 sr/lib.. Now, │ │ │ │ │ +00007b30: 616e 7920 7469 6d65 2061 2027 636f 6e66 any time a 'conf │ │ │ │ │ +00007b40: 6967 7572 6527 2073 6372 6970 7420 6973 igure' script is │ │ │ │ │ +00007b50: 2075 7369 6e67 2074 6865 2027 7e2f 7573 using the '~/us │ │ │ │ │ +00007b60: 7227 2070 7265 6669 782c 2069 740a 7769 r' prefix, it.wi │ │ │ │ │ +00007b70: 6c6c 2065 7865 6375 7465 2074 6865 2061 ll execute the a │ │ │ │ │ +00007b80: 626f 7665 2027 636f 6e66 6967 2e73 6974 bove 'config.sit │ │ │ │ │ +00007b90: 6527 2061 6e64 2064 6566 696e 6520 7468 e' and define th │ │ │ │ │ +00007ba0: 6573 6520 7468 7265 6520 7661 7269 6162 ese three variab │ │ │ │ │ +00007bb0: 6c65 732e 0a0a 2020 2020 207e 2f61 6d68 les... ~/amh │ │ │ │ │ +00007bc0: 656c 6c6f 2d31 2e30 2025 202e 2f63 6f6e ello-1.0 % ./con │ │ │ │ │ +00007bd0: 6669 6775 7265 202d 2d70 7265 6669 7820 figure --prefix │ │ │ │ │ +00007be0: 7e2f 7573 720a 2020 2020 2063 6f6e 6669 ~/usr. confi │ │ │ │ │ +00007bf0: 6775 7265 3a20 6c6f 6164 696e 6720 7369 gure: loading si │ │ │ │ │ +00007c00: 7465 2073 6372 6970 7420 2f68 6f6d 652f te script /home/ │ │ │ │ │ +00007c10: 6164 6c2f 7573 722f 7368 6172 652f 636f adl/usr/share/co │ │ │ │ │ +00007c20: 6e66 6967 2e73 6974 650a 2020 2020 202e nfig.site. . │ │ │ │ │ +00007c30: 2e2e 0a0a 2020 202a 4e6f 7465 2053 6574 .... *Note Set │ │ │ │ │ +00007c40: 7469 6e67 2053 6974 6520 4465 6661 756c ting Site Defaul │ │ │ │ │ +00007c50: 7473 3a20 2861 7574 6f63 6f6e 6629 5369 ts: (autoconf)Si │ │ │ │ │ +00007c60: 7465 2044 6566 6175 6c74 732c 2066 6f72 te Defaults, for │ │ │ │ │ +00007c70: 206d 6f72 650a 696e 666f 726d 6174 696f more.informatio │ │ │ │ │ +00007c80: 6e20 6162 6f75 7420 7468 6973 2066 6561 n about this fea │ │ │ │ │ +00007c90: 7475 7265 2e0a 0a1f 0a46 696c 653a 2061 ture.....File: a │ │ │ │ │ +00007ca0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +00007cb0: 6f2c 2020 4e6f 6465 3a20 5650 4154 4820 o, Node: VPATH │ │ │ │ │ +00007cc0: 4275 696c 6473 2c20 204e 6578 743a 2054 Builds, Next: T │ │ │ │ │ +00007cd0: 776f 2d50 6172 7420 496e 7374 616c 6c2c wo-Part Install, │ │ │ │ │ +00007ce0: 2020 5072 6576 3a20 636f 6e66 6967 2e73 Prev: config.s │ │ │ │ │ +00007cf0: 6974 652c 2020 5570 3a20 5573 6520 4361 ite, Up: Use Ca │ │ │ │ │ +00007d00: 7365 730a 0a32 2e32 2e36 2050 6172 616c ses..2.2.6 Paral │ │ │ │ │ +00007d10: 6c65 6c20 4275 696c 6420 5472 6565 7320 lel Build Trees │ │ │ │ │ +00007d20: 2861 2e6b 2e61 2e20 5650 4154 4820 4275 (a.k.a. VPATH Bu │ │ │ │ │ +00007d30: 696c 6473 290a 2d2d 2d2d 2d2d 2d2d 2d2d ilds).---------- │ │ │ │ │ 00007d40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00007d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00007d60: 2d2d 2d2d 0a0a 5468 6520 474e 5520 4275 ----..The GNU Bu │ │ │ │ │ -00007d70: 696c 6420 5379 7374 656d 2064 6973 7469 ild System disti │ │ │ │ │ -00007d80: 6e67 7569 7368 6573 2074 776f 2074 7265 nguishes two tre │ │ │ │ │ -00007d90: 6573 3a20 7468 6520 736f 7572 6365 2074 es: the source t │ │ │ │ │ -00007da0: 7265 652c 2061 6e64 2074 6865 0a62 7569 ree, and the.bui │ │ │ │ │ -00007db0: 6c64 2074 7265 652e 0a0a 2020 2054 6865 ld tree... The │ │ │ │ │ -00007dc0: 2073 6f75 7263 6520 7472 6565 2069 7320 source tree is │ │ │ │ │ -00007dd0: 726f 6f74 6564 2069 6e20 7468 6520 6469 rooted in the di │ │ │ │ │ -00007de0: 7265 6374 6f72 7920 636f 6e74 6169 6e69 rectory containi │ │ │ │ │ -00007df0: 6e67 2027 636f 6e66 6967 7572 6527 2e0a ng 'configure'.. │ │ │ │ │ -00007e00: 4974 2063 6f6e 7461 696e 7320 616c 6c20 It contains all │ │ │ │ │ -00007e10: 7468 6520 736f 7572 6365 7320 6669 6c65 the sources file │ │ │ │ │ -00007e20: 7320 2874 686f 7365 2074 6861 7420 6172 s (those that ar │ │ │ │ │ -00007e30: 6520 6469 7374 7269 6275 7465 6429 2c20 e distributed), │ │ │ │ │ -00007e40: 616e 6420 6d61 790a 6265 2061 7272 616e and may.be arran │ │ │ │ │ -00007e50: 6765 6420 7573 696e 6720 7365 7665 7261 ged using severa │ │ │ │ │ -00007e60: 6c20 7375 6264 6972 6563 746f 7269 6573 l subdirectories │ │ │ │ │ -00007e70: 2e0a 0a20 2020 5468 6520 6275 696c 6420 ... The build │ │ │ │ │ -00007e80: 7472 6565 2069 7320 726f 6f74 6564 2069 tree is rooted i │ │ │ │ │ -00007e90: 6e20 7468 6520 6469 7265 6374 6f72 7920 n the directory │ │ │ │ │ -00007ea0: 696e 2077 6869 6368 2027 636f 6e66 6967 in which 'config │ │ │ │ │ -00007eb0: 7572 6527 2077 6173 0a72 756e 2c20 616e ure' was.run, an │ │ │ │ │ -00007ec0: 6420 6973 2070 6f70 756c 6174 6564 2077 d is populated w │ │ │ │ │ -00007ed0: 6974 6820 616c 6c20 6f62 6a65 6374 2066 ith all object f │ │ │ │ │ -00007ee0: 696c 6573 2c20 7072 6f67 7261 6d73 2c20 iles, programs, │ │ │ │ │ -00007ef0: 6c69 6272 6172 6965 732c 2061 6e64 0a6f libraries, and.o │ │ │ │ │ -00007f00: 7468 6572 2064 6572 6976 6564 2066 696c ther derived fil │ │ │ │ │ -00007f10: 6573 2062 7569 6c74 2066 726f 6d20 7468 es built from th │ │ │ │ │ -00007f20: 6520 736f 7572 6365 7320 2861 6e64 2068 e sources (and h │ │ │ │ │ -00007f30: 656e 6365 206e 6f74 2064 6973 7472 6962 ence not distrib │ │ │ │ │ -00007f40: 7574 6564 292e 0a54 6865 2062 7569 6c64 uted)..The build │ │ │ │ │ -00007f50: 2074 7265 6520 7573 7561 6c6c 7920 6861 tree usually ha │ │ │ │ │ -00007f60: 7320 7468 6520 7361 6d65 2073 7562 6469 s the same subdi │ │ │ │ │ -00007f70: 7265 6374 6f72 7920 6c61 796f 7574 2061 rectory layout a │ │ │ │ │ -00007f80: 7320 7468 6520 736f 7572 6365 0a74 7265 s the source.tre │ │ │ │ │ -00007f90: 653b 2069 7473 2073 7562 6469 7265 6374 e; its subdirect │ │ │ │ │ -00007fa0: 6f72 6965 7320 6172 6520 6372 6561 7465 ories are create │ │ │ │ │ -00007fb0: 6420 6175 746f 6d61 7469 6361 6c6c 7920 d automatically │ │ │ │ │ -00007fc0: 6279 2074 6865 2062 7569 6c64 2073 7973 by the build sys │ │ │ │ │ -00007fd0: 7465 6d2e 0a0a 2020 2049 6620 2763 6f6e tem... If 'con │ │ │ │ │ -00007fe0: 6669 6775 7265 2720 6973 2065 7865 6375 figure' is execu │ │ │ │ │ -00007ff0: 7465 6420 696e 2069 7473 206f 776e 2064 ted in its own d │ │ │ │ │ -00008000: 6972 6563 746f 7279 2c20 7468 6520 736f irectory, the so │ │ │ │ │ -00008010: 7572 6365 2061 6e64 2062 7569 6c64 0a74 urce and build.t │ │ │ │ │ -00008020: 7265 6573 2061 7265 2063 6f6d 6269 6e65 rees are combine │ │ │ │ │ -00008030: 643a 2064 6572 6976 6564 2066 696c 6573 d: derived files │ │ │ │ │ -00008040: 2061 7265 2063 6f6e 7374 7275 6374 6564 are constructed │ │ │ │ │ -00008050: 2069 6e20 7468 6520 7361 6d65 0a64 6972 in the same.dir │ │ │ │ │ -00008060: 6563 746f 7269 6573 2061 7320 7468 6569 ectories as thei │ │ │ │ │ -00008070: 7220 736f 7572 6365 732e 2020 5468 6973 r sources. This │ │ │ │ │ -00008080: 2077 6173 2074 6865 2063 6173 6520 696e was the case in │ │ │ │ │ -00008090: 206f 7572 2066 6972 7374 0a69 6e73 7461 our first.insta │ │ │ │ │ -000080a0: 6c6c 6174 696f 6e20 6578 616d 706c 6520 llation example │ │ │ │ │ -000080b0: 282a 6e6f 7465 2042 6173 6963 2049 6e73 (*note Basic Ins │ │ │ │ │ -000080c0: 7461 6c6c 6174 696f 6e3a 3a29 2e0a 0a20 tallation::)... │ │ │ │ │ -000080d0: 2020 4120 636f 6d6d 6f6e 2072 6571 7565 A common reque │ │ │ │ │ -000080e0: 7374 2066 726f 6d20 7573 6572 7320 6973 st from users is │ │ │ │ │ -000080f0: 2074 6861 7420 7468 6579 2077 616e 7420 that they want │ │ │ │ │ -00008100: 746f 2063 6f6e 6669 6e65 2061 6c6c 2064 to confine all d │ │ │ │ │ -00008110: 6572 6976 6564 0a66 696c 6573 2074 6f20 erived.files to │ │ │ │ │ -00008120: 6120 7369 6e67 6c65 2064 6972 6563 746f a single directo │ │ │ │ │ -00008130: 7279 2c20 746f 206b 6565 7020 7468 6569 ry, to keep thei │ │ │ │ │ -00008140: 7220 736f 7572 6365 2064 6972 6563 746f r source directo │ │ │ │ │ -00008150: 7269 6573 0a75 6e63 6c75 7474 6572 6564 ries.uncluttered │ │ │ │ │ -00008160: 2e20 2048 6572 6520 6973 2068 6f77 2077 . Here is how w │ │ │ │ │ -00008170: 6520 636f 756c 6420 7275 6e20 2763 6f6e e could run 'con │ │ │ │ │ -00008180: 6669 6775 7265 2720 746f 2062 7569 6c64 figure' to build │ │ │ │ │ -00008190: 2065 7665 7279 7468 696e 670a 696e 2061 everything.in a │ │ │ │ │ -000081a0: 2073 7562 6469 7265 6374 6f72 7920 6361 subdirectory ca │ │ │ │ │ -000081b0: 6c6c 6564 2027 6275 696c 642f 272e 0a0a lled 'build/'... │ │ │ │ │ -000081c0: 2020 2020 207e 2025 2074 6172 207a 7866 ~ % tar zxf │ │ │ │ │ -000081d0: 207e 2f61 6d68 656c 6c6f 2d31 2e30 2e74 ~/amhello-1.0.t │ │ │ │ │ -000081e0: 6172 2e67 7a0a 2020 2020 207e 2025 2063 ar.gz. ~ % c │ │ │ │ │ -000081f0: 6420 616d 6865 6c6c 6f2d 312e 300a 2020 d amhello-1.0. │ │ │ │ │ -00008200: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ -00008210: 2025 206d 6b64 6972 2062 7569 6c64 2026 % mkdir build & │ │ │ │ │ -00008220: 2620 6364 2062 7569 6c64 0a20 2020 2020 & cd build. │ │ │ │ │ -00008230: 7e2f 616d 6865 6c6c 6f2d 312e 302f 6275 ~/amhello-1.0/bu │ │ │ │ │ -00008240: 696c 6420 2520 2e2e 2f63 6f6e 6669 6775 ild % ../configu │ │ │ │ │ -00008250: 7265 0a20 2020 2020 2e2e 2e0a 2020 2020 re. .... │ │ │ │ │ -00008260: 207e 2f61 6d68 656c 6c6f 2d31 2e30 2f62 ~/amhello-1.0/b │ │ │ │ │ -00008270: 7569 6c64 2025 206d 616b 650a 2020 2020 uild % make. │ │ │ │ │ -00008280: 202e 2e2e 0a0a 2020 2054 6865 7365 2073 ..... These s │ │ │ │ │ -00008290: 6574 7570 732c 2077 6865 7265 2073 6f75 etups, where sou │ │ │ │ │ -000082a0: 7263 6520 616e 6420 6275 696c 6420 7472 rce and build tr │ │ │ │ │ -000082b0: 6565 7320 6172 6520 6469 6666 6572 656e ees are differen │ │ │ │ │ -000082c0: 742c 2061 7265 206f 6674 656e 0a63 616c t, are often.cal │ │ │ │ │ -000082d0: 6c65 6420 2270 6172 616c 6c65 6c20 6275 led "parallel bu │ │ │ │ │ -000082e0: 696c 6473 2220 6f72 2022 5650 4154 4820 ilds" or "VPATH │ │ │ │ │ -000082f0: 6275 696c 6473 222e 2020 5468 6520 6578 builds". The ex │ │ │ │ │ -00008300: 7072 6573 7369 6f6e 205f 7061 7261 6c6c pression _parall │ │ │ │ │ -00008310: 656c 0a62 7569 6c64 5f20 6973 206d 6973 el.build_ is mis │ │ │ │ │ -00008320: 6c65 6164 696e 673a 2074 6865 2077 6f72 leading: the wor │ │ │ │ │ -00008330: 6420 5f70 6172 616c 6c65 6c5f 2069 7320 d _parallel_ is │ │ │ │ │ -00008340: 6120 7265 6665 7265 6e63 6520 746f 2074 a reference to t │ │ │ │ │ -00008350: 6865 2077 6179 2074 6865 0a62 7569 6c64 he way the.build │ │ │ │ │ -00008360: 2074 7265 6520 7368 6164 6f77 7320 7468 tree shadows th │ │ │ │ │ -00008370: 6520 736f 7572 6365 2074 7265 652c 2069 e source tree, i │ │ │ │ │ -00008380: 7420 6973 206e 6f74 2061 626f 7574 2073 t is not about s │ │ │ │ │ -00008390: 6f6d 6520 636f 6e63 7572 7265 6e63 7920 ome concurrency │ │ │ │ │ -000083a0: 696e 0a74 6865 2077 6179 2062 7569 6c64 in.the way build │ │ │ │ │ -000083b0: 2063 6f6d 6d61 6e64 7320 6172 6520 7275 commands are ru │ │ │ │ │ -000083c0: 6e2e 2020 466f 7220 7468 6973 2072 6561 n. For this rea │ │ │ │ │ -000083d0: 736f 6e20 7765 2072 6566 6572 2074 6f20 son we refer to │ │ │ │ │ -000083e0: 7375 6368 2073 6574 7570 730a 7573 696e such setups.usin │ │ │ │ │ -000083f0: 6720 7468 6520 6e61 6d65 205f 5650 4154 g the name _VPAT │ │ │ │ │ -00008400: 4820 6275 696c 6473 5f20 696e 2074 6865 H builds_ in the │ │ │ │ │ -00008410: 2066 6f6c 6c6f 7769 6e67 2e20 205f 5650 following. _VP │ │ │ │ │ -00008420: 4154 485f 2069 7320 7468 6520 6e61 6d65 ATH_ is the name │ │ │ │ │ -00008430: 206f 660a 7468 6520 276d 616b 6527 2066 of.the 'make' f │ │ │ │ │ -00008440: 6561 7475 7265 2075 7365 6420 6279 2074 eature used by t │ │ │ │ │ -00008450: 6865 2027 4d61 6b65 6669 6c65 2773 2074 he 'Makefile's t │ │ │ │ │ -00008460: 6f20 616c 6c6f 7720 7468 6573 6520 6275 o allow these bu │ │ │ │ │ -00008470: 696c 6473 2028 2a6e 6f74 650a 2756 5041 ilds (*note.'VPA │ │ │ │ │ -00008480: 5448 2720 5365 6172 6368 2050 6174 6820 TH' Search Path │ │ │ │ │ -00008490: 666f 7220 416c 6c20 5072 6572 6571 7569 for All Prerequi │ │ │ │ │ -000084a0: 7369 7465 733a 2028 6d61 6b65 2947 656e sites: (make)Gen │ │ │ │ │ -000084b0: 6572 616c 2053 6561 7263 682e 292e 0a0a eral Search.)... │ │ │ │ │ -000084c0: 2020 2056 5041 5448 2062 7569 6c64 7320 VPATH builds │ │ │ │ │ -000084d0: 6861 7665 206f 7468 6572 2069 6e74 6572 have other inter │ │ │ │ │ -000084e0: 6573 7469 6e67 2075 7365 732e 2020 4f6e esting uses. On │ │ │ │ │ -000084f0: 6520 6973 2074 6f20 6275 696c 6420 7468 e is to build th │ │ │ │ │ -00008500: 6520 7361 6d65 0a73 6f75 7263 6573 2077 e same.sources w │ │ │ │ │ -00008510: 6974 6820 6d75 6c74 6970 6c65 2063 6f6e ith multiple con │ │ │ │ │ -00008520: 6669 6775 7261 7469 6f6e 732e 2020 466f figurations. Fo │ │ │ │ │ -00008530: 7220 696e 7374 616e 6365 3a0a 0a20 2020 r instance:.. │ │ │ │ │ -00008540: 2020 7e20 2520 7461 7220 7a78 6620 7e2f ~ % tar zxf ~/ │ │ │ │ │ -00008550: 616d 6865 6c6c 6f2d 312e 302e 7461 722e amhello-1.0.tar. │ │ │ │ │ -00008560: 677a 0a20 2020 2020 7e20 2520 6364 2061 gz. ~ % cd a │ │ │ │ │ -00008570: 6d68 656c 6c6f 2d31 2e30 0a20 2020 2020 mhello-1.0. │ │ │ │ │ -00008580: 7e2f 616d 6865 6c6c 6f2d 312e 3020 2520 ~/amhello-1.0 % │ │ │ │ │ -00008590: 6d6b 6469 7220 6465 6275 6720 6f70 7469 mkdir debug opti │ │ │ │ │ -000085a0: 6d20 2626 2063 6420 6465 6275 670a 2020 m && cd debug. │ │ │ │ │ -000085b0: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ -000085c0: 2f64 6562 7567 2025 202e 2e2f 636f 6e66 /debug % ../conf │ │ │ │ │ -000085d0: 6967 7572 6520 4346 4c41 4753 3d27 2d67 igure CFLAGS='-g │ │ │ │ │ -000085e0: 202d 4f30 270a 2020 2020 202e 2e2e 0a20 -O0'. .... │ │ │ │ │ -000085f0: 2020 2020 7e2f 616d 6865 6c6c 6f2d 312e ~/amhello-1. │ │ │ │ │ -00008600: 302f 6465 6275 6720 2520 6d61 6b65 0a20 0/debug % make. │ │ │ │ │ -00008610: 2020 2020 2e2e 2e0a 2020 2020 207e 2f61 .... ~/a │ │ │ │ │ -00008620: 6d68 656c 6c6f 2d31 2e30 2f64 6562 7567 mhello-1.0/debug │ │ │ │ │ -00008630: 2025 2063 6420 2e2e 2f6f 7074 696d 0a20 % cd ../optim. │ │ │ │ │ -00008640: 2020 2020 7e2f 616d 6865 6c6c 6f2d 312e ~/amhello-1. │ │ │ │ │ -00008650: 302f 6f70 7469 6d20 2520 2e2e 2f63 6f6e 0/optim % ../con │ │ │ │ │ -00008660: 6669 6775 7265 2043 464c 4147 533d 272d figure CFLAGS='- │ │ │ │ │ -00008670: 4f33 202d 666f 6d69 742d 6672 616d 652d O3 -fomit-frame- │ │ │ │ │ -00008680: 706f 696e 7465 7227 0a20 2020 2020 2e2e pointer'. .. │ │ │ │ │ -00008690: 2e0a 2020 2020 207e 2f61 6d68 656c 6c6f .. ~/amhello │ │ │ │ │ -000086a0: 2d31 2e30 2f6f 7074 696d 2025 206d 616b -1.0/optim % mak │ │ │ │ │ -000086b0: 650a 2020 2020 202e 2e2e 0a0a 2020 2057 e. ..... W │ │ │ │ │ -000086c0: 6974 6820 6e65 7477 6f72 6b20 6669 6c65 ith network file │ │ │ │ │ -000086d0: 2073 7973 7465 6d73 2c20 6120 7369 6d69 systems, a simi │ │ │ │ │ -000086e0: 6c61 7220 6170 7072 6f61 6368 2063 616e lar approach can │ │ │ │ │ -000086f0: 2062 6520 7573 6564 2074 6f20 6275 696c be used to buil │ │ │ │ │ -00008700: 640a 7468 6520 7361 6d65 2073 6f75 7263 d.the same sourc │ │ │ │ │ -00008710: 6573 206f 6e20 6469 6666 6572 656e 7420 es on different │ │ │ │ │ -00008720: 6d61 6368 696e 6573 2e20 2046 6f72 2069 machines. For i │ │ │ │ │ -00008730: 6e73 7461 6e63 652c 2073 7570 706f 7365 nstance, suppose │ │ │ │ │ -00008740: 2074 6861 7420 7468 650a 736f 7572 6365 that the.source │ │ │ │ │ -00008750: 7320 6172 6520 696e 7374 616c 6c65 6420 s are installed │ │ │ │ │ -00008760: 6f6e 2061 2064 6972 6563 746f 7279 2073 on a directory s │ │ │ │ │ -00008770: 6861 7265 6420 6279 2074 776f 2068 6f73 hared by two hos │ │ │ │ │ -00008780: 7473 3a20 2748 4f53 5431 2720 616e 640a ts: 'HOST1' and. │ │ │ │ │ -00008790: 2748 4f53 5432 272c 2077 6869 6368 206d 'HOST2', which m │ │ │ │ │ -000087a0: 6179 2062 6520 6469 6666 6572 656e 7420 ay be different │ │ │ │ │ -000087b0: 706c 6174 666f 726d 732e 0a0a 2020 2020 platforms... │ │ │ │ │ -000087c0: 207e 2025 2063 6420 2f6e 6673 2f73 7263 ~ % cd /nfs/src │ │ │ │ │ -000087d0: 0a20 2020 2020 2f6e 6673 2f73 7263 2025 . /nfs/src % │ │ │ │ │ -000087e0: 2074 6172 207a 7866 207e 2f61 6d68 656c tar zxf ~/amhel │ │ │ │ │ -000087f0: 6c6f 2d31 2e30 2e74 6172 2e67 7a0a 0a20 lo-1.0.tar.gz.. │ │ │ │ │ -00008800: 2020 4f6e 2074 6865 2066 6972 7374 2068 On the first h │ │ │ │ │ -00008810: 6f73 742c 2079 6f75 2063 6f75 6c64 2063 ost, you could c │ │ │ │ │ -00008820: 7265 6174 6520 6120 6c6f 6361 6c20 6275 reate a local bu │ │ │ │ │ -00008830: 696c 6420 6469 7265 6374 6f72 793a 0a20 ild directory:. │ │ │ │ │ -00008840: 2020 2020 5b48 4f53 5431 5d20 7e20 2520 [HOST1] ~ % │ │ │ │ │ -00008850: 6d6b 6469 7220 2f74 6d70 2f61 6d68 2026 mkdir /tmp/amh & │ │ │ │ │ -00008860: 2620 6364 202f 746d 702f 616d 680a 2020 & cd /tmp/amh. │ │ │ │ │ -00008870: 2020 205b 484f 5354 315d 202f 746d 702f [HOST1] /tmp/ │ │ │ │ │ -00008880: 616d 6820 2520 2f6e 6673 2f73 7263 2f61 amh % /nfs/src/a │ │ │ │ │ -00008890: 6d68 656c 6c6f 2d31 2e30 2f63 6f6e 6669 mhello-1.0/confi │ │ │ │ │ -000088a0: 6775 7265 0a20 2020 2020 2e2e 2e0a 2020 gure. .... │ │ │ │ │ -000088b0: 2020 205b 484f 5354 315d 202f 746d 702f [HOST1] /tmp/ │ │ │ │ │ -000088c0: 616d 6820 2520 6d61 6b65 2026 2620 7375 amh % make && su │ │ │ │ │ -000088d0: 646f 206d 616b 6520 696e 7374 616c 6c0a do make install. │ │ │ │ │ -000088e0: 2020 2020 202e 2e2e 0a0a 2848 6572 6520 .....(Here │ │ │ │ │ -000088f0: 7765 2061 7373 756d 6520 7468 6174 2074 we assume that t │ │ │ │ │ -00008900: 6865 2069 6e73 7461 6c6c 6572 2068 6173 he installer has │ │ │ │ │ -00008910: 2063 6f6e 6669 6775 7265 6420 2773 7564 configured 'sud │ │ │ │ │ -00008920: 6f27 2073 6f20 6974 2063 616e 0a65 7865 o' so it can.exe │ │ │ │ │ -00008930: 6375 7465 2027 6d61 6b65 2069 6e73 7461 cute 'make insta │ │ │ │ │ -00008940: 6c6c 2720 7769 7468 2072 6f6f 7420 7072 ll' with root pr │ │ │ │ │ -00008950: 6976 696c 6567 6573 3b20 6974 2069 7320 ivileges; it is │ │ │ │ │ -00008960: 6d6f 7265 2063 6f6e 7665 6e69 656e 7420 more convenient │ │ │ │ │ -00008970: 7468 616e 0a75 7369 6e67 2027 7375 2720 than.using 'su' │ │ │ │ │ -00008980: 6c69 6b65 2069 6e20 2a6e 6f74 6520 4261 like in *note Ba │ │ │ │ │ -00008990: 7369 6320 496e 7374 616c 6c61 7469 6f6e sic Installation │ │ │ │ │ -000089a0: 3a3a 292e 0a0a 2020 204f 6e20 7468 6520 ::)... On the │ │ │ │ │ -000089b0: 7365 636f 6e64 2068 6f73 742c 2079 6f75 second host, you │ │ │ │ │ -000089c0: 2077 6f75 6c64 2064 6f20 6578 6163 746c would do exactl │ │ │ │ │ -000089d0: 7920 7468 6520 7361 6d65 2c20 706f 7373 y the same, poss │ │ │ │ │ -000089e0: 6962 6c79 2061 7420 7468 650a 7361 6d65 ibly at the.same │ │ │ │ │ -000089f0: 2074 696d 653a 0a20 2020 2020 5b48 4f53 time:. [HOS │ │ │ │ │ -00008a00: 5432 5d20 7e20 2520 6d6b 6469 7220 2f74 T2] ~ % mkdir /t │ │ │ │ │ -00008a10: 6d70 2f61 6d68 2026 2620 6364 202f 746d mp/amh && cd /tm │ │ │ │ │ -00008a20: 702f 616d 680a 2020 2020 205b 484f 5354 p/amh. [HOST │ │ │ │ │ -00008a30: 325d 202f 746d 702f 616d 6820 2520 2f6e 2] /tmp/amh % /n │ │ │ │ │ -00008a40: 6673 2f73 7263 2f61 6d68 656c 6c6f 2d31 fs/src/amhello-1 │ │ │ │ │ -00008a50: 2e30 2f63 6f6e 6669 6775 7265 0a20 2020 .0/configure. │ │ │ │ │ -00008a60: 2020 2e2e 2e0a 2020 2020 205b 484f 5354 .... [HOST │ │ │ │ │ -00008a70: 325d 202f 746d 702f 616d 6820 2520 6d61 2] /tmp/amh % ma │ │ │ │ │ -00008a80: 6b65 2026 2620 7375 646f 206d 616b 6520 ke && sudo make │ │ │ │ │ -00008a90: 696e 7374 616c 6c0a 2020 2020 202e 2e2e install. ... │ │ │ │ │ -00008aa0: 0a0a 2020 2049 6e20 7468 6973 2073 6365 .. In this sce │ │ │ │ │ -00008ab0: 6e61 7269 6f2c 206e 6f74 6869 6e67 2066 nario, nothing f │ │ │ │ │ -00008ac0: 6f72 6269 6473 2074 6865 2027 2f6e 6673 orbids the '/nfs │ │ │ │ │ -00008ad0: 2f73 7263 2f61 6d68 656c 6c6f 2d31 2e30 /src/amhello-1.0 │ │ │ │ │ -00008ae0: 270a 6469 7265 6374 6f72 7920 6672 6f6d '.directory from │ │ │ │ │ -00008af0: 2062 6569 6e67 2072 6561 642d 6f6e 6c79 being read-only │ │ │ │ │ -00008b00: 2e20 2049 6e20 6661 6374 2056 5041 5448 . In fact VPATH │ │ │ │ │ -00008b10: 2062 7569 6c64 7320 6172 6520 616c 736f builds are also │ │ │ │ │ -00008b20: 2061 206d 6561 6e73 0a6f 6620 6275 696c a means.of buil │ │ │ │ │ -00008b30: 6469 6e67 2070 6163 6b61 6765 7320 6672 ding packages fr │ │ │ │ │ -00008b40: 6f6d 2061 2072 6561 642d 6f6e 6c79 206d om a read-only m │ │ │ │ │ -00008b50: 6564 6975 6d20 7375 6368 2061 7320 6120 edium such as a │ │ │ │ │ -00008b60: 4344 2d52 4f4d 2e20 2854 6865 2046 5346 CD-ROM. (The FSF │ │ │ │ │ -00008b70: 0a75 7365 6420 746f 2073 656c 6c20 4344 .used to sell CD │ │ │ │ │ -00008b80: 2d52 4f4d 2077 6974 6820 756e 7061 636b -ROM with unpack │ │ │ │ │ -00008b90: 6564 2073 6f75 7263 6520 636f 6465 2c20 ed source code, │ │ │ │ │ -00008ba0: 6265 666f 7265 2074 6865 2047 4e55 2070 before the GNU p │ │ │ │ │ -00008bb0: 726f 6a65 6374 0a67 7265 7720 736f 2062 roject.grew so b │ │ │ │ │ -00008bc0: 6967 2e29 0a0a 1f0a 4669 6c65 3a20 6175 ig.)....File: au │ │ │ │ │ -00008bd0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -00008be0: 2c20 204e 6f64 653a 2054 776f 2d50 6172 , Node: Two-Par │ │ │ │ │ -00008bf0: 7420 496e 7374 616c 6c2c 2020 4e65 7874 t Install, Next │ │ │ │ │ -00008c00: 3a20 4372 6f73 732d 436f 6d70 696c 6174 : Cross-Compilat │ │ │ │ │ -00008c10: 696f 6e2c 2020 5072 6576 3a20 5650 4154 ion, Prev: VPAT │ │ │ │ │ -00008c20: 4820 4275 696c 6473 2c20 2055 703a 2055 H Builds, Up: U │ │ │ │ │ -00008c30: 7365 2043 6173 6573 0a0a 322e 322e 3720 se Cases..2.2.7 │ │ │ │ │ -00008c40: 5477 6f2d 5061 7274 2049 6e73 7461 6c6c Two-Part Install │ │ │ │ │ -00008c50: 6174 696f 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d ation.---------- │ │ │ │ │ +00007d60: 2d2d 2d2d 2d2d 0a0a 5468 6520 474e 5520 ------..The GNU │ │ │ │ │ +00007d70: 4275 696c 6420 5379 7374 656d 2064 6973 Build System dis │ │ │ │ │ +00007d80: 7469 6e67 7569 7368 6573 2074 776f 2074 tinguishes two t │ │ │ │ │ +00007d90: 7265 6573 3a20 7468 6520 736f 7572 6365 rees: the source │ │ │ │ │ +00007da0: 2074 7265 652c 2061 6e64 2074 6865 0a62 tree, and the.b │ │ │ │ │ +00007db0: 7569 6c64 2074 7265 652e 0a0a 2020 2054 uild tree... T │ │ │ │ │ +00007dc0: 6865 2073 6f75 7263 6520 7472 6565 2069 he source tree i │ │ │ │ │ +00007dd0: 7320 726f 6f74 6564 2069 6e20 7468 6520 s rooted in the │ │ │ │ │ +00007de0: 6469 7265 6374 6f72 7920 636f 6e74 6169 directory contai │ │ │ │ │ +00007df0: 6e69 6e67 2027 636f 6e66 6967 7572 6527 ning 'configure' │ │ │ │ │ +00007e00: 2e0a 4974 2063 6f6e 7461 696e 7320 616c ..It contains al │ │ │ │ │ +00007e10: 6c20 7468 6520 736f 7572 6365 7320 6669 l the sources fi │ │ │ │ │ +00007e20: 6c65 7320 2874 686f 7365 2074 6861 7420 les (those that │ │ │ │ │ +00007e30: 6172 6520 6469 7374 7269 6275 7465 6429 are distributed) │ │ │ │ │ +00007e40: 2c20 616e 6420 6d61 790a 6265 2061 7272 , and may.be arr │ │ │ │ │ +00007e50: 616e 6765 6420 7573 696e 6720 7365 7665 anged using seve │ │ │ │ │ +00007e60: 7261 6c20 7375 6264 6972 6563 746f 7269 ral subdirectori │ │ │ │ │ +00007e70: 6573 2e0a 0a20 2020 5468 6520 6275 696c es... The buil │ │ │ │ │ +00007e80: 6420 7472 6565 2069 7320 726f 6f74 6564 d tree is rooted │ │ │ │ │ +00007e90: 2069 6e20 7468 6520 6469 7265 6374 6f72 in the director │ │ │ │ │ +00007ea0: 7920 696e 2077 6869 6368 2027 636f 6e66 y in which 'conf │ │ │ │ │ +00007eb0: 6967 7572 6527 2077 6173 0a72 756e 2c20 igure' was.run, │ │ │ │ │ +00007ec0: 616e 6420 6973 2070 6f70 756c 6174 6564 and is populated │ │ │ │ │ +00007ed0: 2077 6974 6820 616c 6c20 6f62 6a65 6374 with all object │ │ │ │ │ +00007ee0: 2066 696c 6573 2c20 7072 6f67 7261 6d73 files, programs │ │ │ │ │ +00007ef0: 2c20 6c69 6272 6172 6965 732c 2061 6e64 , libraries, and │ │ │ │ │ +00007f00: 0a6f 7468 6572 2064 6572 6976 6564 2066 .other derived f │ │ │ │ │ +00007f10: 696c 6573 2062 7569 6c74 2066 726f 6d20 iles built from │ │ │ │ │ +00007f20: 7468 6520 736f 7572 6365 7320 2861 6e64 the sources (and │ │ │ │ │ +00007f30: 2068 656e 6365 206e 6f74 2064 6973 7472 hence not distr │ │ │ │ │ +00007f40: 6962 7574 6564 292e 0a54 6865 2062 7569 ibuted)..The bui │ │ │ │ │ +00007f50: 6c64 2074 7265 6520 7573 7561 6c6c 7920 ld tree usually │ │ │ │ │ +00007f60: 6861 7320 7468 6520 7361 6d65 2073 7562 has the same sub │ │ │ │ │ +00007f70: 6469 7265 6374 6f72 7920 6c61 796f 7574 directory layout │ │ │ │ │ +00007f80: 2061 7320 7468 6520 736f 7572 6365 0a74 as the source.t │ │ │ │ │ +00007f90: 7265 653b 2069 7473 2073 7562 6469 7265 ree; its subdire │ │ │ │ │ +00007fa0: 6374 6f72 6965 7320 6172 6520 6372 6561 ctories are crea │ │ │ │ │ +00007fb0: 7465 6420 6175 746f 6d61 7469 6361 6c6c ted automaticall │ │ │ │ │ +00007fc0: 7920 6279 2074 6865 2062 7569 6c64 2073 y by the build s │ │ │ │ │ +00007fd0: 7973 7465 6d2e 0a0a 2020 2049 6620 2763 ystem... If 'c │ │ │ │ │ +00007fe0: 6f6e 6669 6775 7265 2720 6973 2065 7865 onfigure' is exe │ │ │ │ │ +00007ff0: 6375 7465 6420 696e 2069 7473 206f 776e cuted in its own │ │ │ │ │ +00008000: 2064 6972 6563 746f 7279 2c20 7468 6520 directory, the │ │ │ │ │ +00008010: 736f 7572 6365 2061 6e64 2062 7569 6c64 source and build │ │ │ │ │ +00008020: 0a74 7265 6573 2061 7265 2063 6f6d 6269 .trees are combi │ │ │ │ │ +00008030: 6e65 643a 2064 6572 6976 6564 2066 696c ned: derived fil │ │ │ │ │ +00008040: 6573 2061 7265 2063 6f6e 7374 7275 6374 es are construct │ │ │ │ │ +00008050: 6564 2069 6e20 7468 6520 7361 6d65 0a64 ed in the same.d │ │ │ │ │ +00008060: 6972 6563 746f 7269 6573 2061 7320 7468 irectories as th │ │ │ │ │ +00008070: 6569 7220 736f 7572 6365 732e 2020 5468 eir sources. Th │ │ │ │ │ +00008080: 6973 2077 6173 2074 6865 2063 6173 6520 is was the case │ │ │ │ │ +00008090: 696e 206f 7572 2066 6972 7374 0a69 6e73 in our first.ins │ │ │ │ │ +000080a0: 7461 6c6c 6174 696f 6e20 6578 616d 706c tallation exampl │ │ │ │ │ +000080b0: 6520 282a 6e6f 7465 2042 6173 6963 2049 e (*note Basic I │ │ │ │ │ +000080c0: 6e73 7461 6c6c 6174 696f 6e3a 3a29 2e0a nstallation::).. │ │ │ │ │ +000080d0: 0a20 2020 4120 636f 6d6d 6f6e 2072 6571 . A common req │ │ │ │ │ +000080e0: 7565 7374 2066 726f 6d20 7573 6572 7320 uest from users │ │ │ │ │ +000080f0: 6973 2074 6861 7420 7468 6579 2077 616e is that they wan │ │ │ │ │ +00008100: 7420 746f 2063 6f6e 6669 6e65 2061 6c6c t to confine all │ │ │ │ │ +00008110: 2064 6572 6976 6564 0a66 696c 6573 2074 derived.files t │ │ │ │ │ +00008120: 6f20 6120 7369 6e67 6c65 2064 6972 6563 o a single direc │ │ │ │ │ +00008130: 746f 7279 2c20 746f 206b 6565 7020 7468 tory, to keep th │ │ │ │ │ +00008140: 6569 7220 736f 7572 6365 2064 6972 6563 eir source direc │ │ │ │ │ +00008150: 746f 7269 6573 0a75 6e63 6c75 7474 6572 tories.unclutter │ │ │ │ │ +00008160: 6564 2e20 2048 6572 6520 6973 2068 6f77 ed. Here is how │ │ │ │ │ +00008170: 2077 6520 636f 756c 6420 7275 6e20 2763 we could run 'c │ │ │ │ │ +00008180: 6f6e 6669 6775 7265 2720 746f 2062 7569 onfigure' to bui │ │ │ │ │ +00008190: 6c64 2065 7665 7279 7468 696e 670a 696e ld everything.in │ │ │ │ │ +000081a0: 2061 2073 7562 6469 7265 6374 6f72 7920 a subdirectory │ │ │ │ │ +000081b0: 6361 6c6c 6564 2027 6275 696c 642f 272e called 'build/'. │ │ │ │ │ +000081c0: 0a0a 2020 2020 207e 2025 2074 6172 207a .. ~ % tar z │ │ │ │ │ +000081d0: 7866 207e 2f61 6d68 656c 6c6f 2d31 2e30 xf ~/amhello-1.0 │ │ │ │ │ +000081e0: 2e74 6172 2e67 7a0a 2020 2020 207e 2025 .tar.gz. ~ % │ │ │ │ │ +000081f0: 2063 6420 616d 6865 6c6c 6f2d 312e 300a cd amhello-1.0. │ │ │ │ │ +00008200: 2020 2020 207e 2f61 6d68 656c 6c6f 2d31 ~/amhello-1 │ │ │ │ │ +00008210: 2e30 2025 206d 6b64 6972 2062 7569 6c64 .0 % mkdir build │ │ │ │ │ +00008220: 2026 2620 6364 2062 7569 6c64 0a20 2020 && cd build. │ │ │ │ │ +00008230: 2020 7e2f 616d 6865 6c6c 6f2d 312e 302f ~/amhello-1.0/ │ │ │ │ │ +00008240: 6275 696c 6420 2520 2e2e 2f63 6f6e 6669 build % ../confi │ │ │ │ │ +00008250: 6775 7265 0a20 2020 2020 2e2e 2e0a 2020 gure. .... │ │ │ │ │ +00008260: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ +00008270: 2f62 7569 6c64 2025 206d 616b 650a 2020 /build % make. │ │ │ │ │ +00008280: 2020 202e 2e2e 0a0a 2020 2054 6865 7365 ..... These │ │ │ │ │ +00008290: 2073 6574 7570 732c 2077 6865 7265 2073 setups, where s │ │ │ │ │ +000082a0: 6f75 7263 6520 616e 6420 6275 696c 6420 ource and build │ │ │ │ │ +000082b0: 7472 6565 7320 6172 6520 6469 6666 6572 trees are differ │ │ │ │ │ +000082c0: 656e 742c 2061 7265 206f 6674 656e 0a63 ent, are often.c │ │ │ │ │ +000082d0: 616c 6c65 6420 2270 6172 616c 6c65 6c20 alled "parallel │ │ │ │ │ +000082e0: 6275 696c 6473 2220 6f72 2022 5650 4154 builds" or "VPAT │ │ │ │ │ +000082f0: 4820 6275 696c 6473 222e 2020 5468 6520 H builds". The │ │ │ │ │ +00008300: 6578 7072 6573 7369 6f6e 205f 7061 7261 expression _para │ │ │ │ │ +00008310: 6c6c 656c 0a62 7569 6c64 5f20 6973 206d llel.build_ is m │ │ │ │ │ +00008320: 6973 6c65 6164 696e 673a 2074 6865 2077 isleading: the w │ │ │ │ │ +00008330: 6f72 6420 5f70 6172 616c 6c65 6c5f 2069 ord _parallel_ i │ │ │ │ │ +00008340: 7320 6120 7265 6665 7265 6e63 6520 746f s a reference to │ │ │ │ │ +00008350: 2074 6865 2077 6179 2074 6865 0a62 7569 the way the.bui │ │ │ │ │ +00008360: 6c64 2074 7265 6520 7368 6164 6f77 7320 ld tree shadows │ │ │ │ │ +00008370: 7468 6520 736f 7572 6365 2074 7265 652c the source tree, │ │ │ │ │ +00008380: 2069 7420 6973 206e 6f74 2061 626f 7574 it is not about │ │ │ │ │ +00008390: 2073 6f6d 6520 636f 6e63 7572 7265 6e63 some concurrenc │ │ │ │ │ +000083a0: 7920 696e 0a74 6865 2077 6179 2062 7569 y in.the way bui │ │ │ │ │ +000083b0: 6c64 2063 6f6d 6d61 6e64 7320 6172 6520 ld commands are │ │ │ │ │ +000083c0: 7275 6e2e 2020 466f 7220 7468 6973 2072 run. For this r │ │ │ │ │ +000083d0: 6561 736f 6e20 7765 2072 6566 6572 2074 eason we refer t │ │ │ │ │ +000083e0: 6f20 7375 6368 2073 6574 7570 730a 7573 o such setups.us │ │ │ │ │ +000083f0: 696e 6720 7468 6520 6e61 6d65 205f 5650 ing the name _VP │ │ │ │ │ +00008400: 4154 4820 6275 696c 6473 5f20 696e 2074 ATH builds_ in t │ │ │ │ │ +00008410: 6865 2066 6f6c 6c6f 7769 6e67 2e20 205f he following. _ │ │ │ │ │ +00008420: 5650 4154 485f 2069 7320 7468 6520 6e61 VPATH_ is the na │ │ │ │ │ +00008430: 6d65 206f 660a 7468 6520 276d 616b 6527 me of.the 'make' │ │ │ │ │ +00008440: 2066 6561 7475 7265 2075 7365 6420 6279 feature used by │ │ │ │ │ +00008450: 2074 6865 2027 4d61 6b65 6669 6c65 2773 the 'Makefile's │ │ │ │ │ +00008460: 2074 6f20 616c 6c6f 7720 7468 6573 6520 to allow these │ │ │ │ │ +00008470: 6275 696c 6473 2028 2a6e 6f74 650a 2756 builds (*note.'V │ │ │ │ │ +00008480: 5041 5448 2720 5365 6172 6368 2050 6174 PATH' Search Pat │ │ │ │ │ +00008490: 6820 666f 7220 416c 6c20 5072 6572 6571 h for All Prereq │ │ │ │ │ +000084a0: 7569 7369 7465 733a 2028 6d61 6b65 2947 uisites: (make)G │ │ │ │ │ +000084b0: 656e 6572 616c 2053 6561 7263 682e 292e eneral Search.). │ │ │ │ │ +000084c0: 0a0a 2020 2056 5041 5448 2062 7569 6c64 .. VPATH build │ │ │ │ │ +000084d0: 7320 6861 7665 206f 7468 6572 2069 6e74 s have other int │ │ │ │ │ +000084e0: 6572 6573 7469 6e67 2075 7365 732e 2020 eresting uses. │ │ │ │ │ +000084f0: 4f6e 6520 6973 2074 6f20 6275 696c 6420 One is to build │ │ │ │ │ +00008500: 7468 6520 7361 6d65 0a73 6f75 7263 6573 the same.sources │ │ │ │ │ +00008510: 2077 6974 6820 6d75 6c74 6970 6c65 2063 with multiple c │ │ │ │ │ +00008520: 6f6e 6669 6775 7261 7469 6f6e 732e 2020 onfigurations. │ │ │ │ │ +00008530: 466f 7220 696e 7374 616e 6365 3a0a 0a20 For instance:.. │ │ │ │ │ +00008540: 2020 2020 7e20 2520 7461 7220 7a78 6620 ~ % tar zxf │ │ │ │ │ +00008550: 7e2f 616d 6865 6c6c 6f2d 312e 302e 7461 ~/amhello-1.0.ta │ │ │ │ │ +00008560: 722e 677a 0a20 2020 2020 7e20 2520 6364 r.gz. ~ % cd │ │ │ │ │ +00008570: 2061 6d68 656c 6c6f 2d31 2e30 0a20 2020 amhello-1.0. │ │ │ │ │ +00008580: 2020 7e2f 616d 6865 6c6c 6f2d 312e 3020 ~/amhello-1.0 │ │ │ │ │ +00008590: 2520 6d6b 6469 7220 6465 6275 6720 6f70 % mkdir debug op │ │ │ │ │ +000085a0: 7469 6d20 2626 2063 6420 6465 6275 670a tim && cd debug. │ │ │ │ │ +000085b0: 2020 2020 207e 2f61 6d68 656c 6c6f 2d31 ~/amhello-1 │ │ │ │ │ +000085c0: 2e30 2f64 6562 7567 2025 202e 2e2f 636f .0/debug % ../co │ │ │ │ │ +000085d0: 6e66 6967 7572 6520 4346 4c41 4753 3d27 nfigure CFLAGS=' │ │ │ │ │ +000085e0: 2d67 202d 4f30 270a 2020 2020 202e 2e2e -g -O0'. ... │ │ │ │ │ +000085f0: 0a20 2020 2020 7e2f 616d 6865 6c6c 6f2d . ~/amhello- │ │ │ │ │ +00008600: 312e 302f 6465 6275 6720 2520 6d61 6b65 1.0/debug % make │ │ │ │ │ +00008610: 0a20 2020 2020 2e2e 2e0a 2020 2020 207e . .... ~ │ │ │ │ │ +00008620: 2f61 6d68 656c 6c6f 2d31 2e30 2f64 6562 /amhello-1.0/deb │ │ │ │ │ +00008630: 7567 2025 2063 6420 2e2e 2f6f 7074 696d ug % cd ../optim │ │ │ │ │ +00008640: 0a20 2020 2020 7e2f 616d 6865 6c6c 6f2d . ~/amhello- │ │ │ │ │ +00008650: 312e 302f 6f70 7469 6d20 2520 2e2e 2f63 1.0/optim % ../c │ │ │ │ │ +00008660: 6f6e 6669 6775 7265 2043 464c 4147 533d onfigure CFLAGS= │ │ │ │ │ +00008670: 272d 4f33 202d 666f 6d69 742d 6672 616d '-O3 -fomit-fram │ │ │ │ │ +00008680: 652d 706f 696e 7465 7227 0a20 2020 2020 e-pointer'. │ │ │ │ │ +00008690: 2e2e 2e0a 2020 2020 207e 2f61 6d68 656c .... ~/amhel │ │ │ │ │ +000086a0: 6c6f 2d31 2e30 2f6f 7074 696d 2025 206d lo-1.0/optim % m │ │ │ │ │ +000086b0: 616b 650a 2020 2020 202e 2e2e 0a0a 2020 ake. ..... │ │ │ │ │ +000086c0: 2057 6974 6820 6e65 7477 6f72 6b20 6669 With network fi │ │ │ │ │ +000086d0: 6c65 2073 7973 7465 6d73 2c20 6120 7369 le systems, a si │ │ │ │ │ +000086e0: 6d69 6c61 7220 6170 7072 6f61 6368 2063 milar approach c │ │ │ │ │ +000086f0: 616e 2062 6520 7573 6564 2074 6f20 6275 an be used to bu │ │ │ │ │ +00008700: 696c 640a 7468 6520 7361 6d65 2073 6f75 ild.the same sou │ │ │ │ │ +00008710: 7263 6573 206f 6e20 6469 6666 6572 656e rces on differen │ │ │ │ │ +00008720: 7420 6d61 6368 696e 6573 2e20 2046 6f72 t machines. For │ │ │ │ │ +00008730: 2069 6e73 7461 6e63 652c 2073 7570 706f instance, suppo │ │ │ │ │ +00008740: 7365 2074 6861 7420 7468 650a 736f 7572 se that the.sour │ │ │ │ │ +00008750: 6365 7320 6172 6520 696e 7374 616c 6c65 ces are installe │ │ │ │ │ +00008760: 6420 6f6e 2061 2064 6972 6563 746f 7279 d on a directory │ │ │ │ │ +00008770: 2073 6861 7265 6420 6279 2074 776f 2068 shared by two h │ │ │ │ │ +00008780: 6f73 7473 3a20 2748 4f53 5431 2720 616e osts: 'HOST1' an │ │ │ │ │ +00008790: 640a 2748 4f53 5432 272c 2077 6869 6368 d.'HOST2', which │ │ │ │ │ +000087a0: 206d 6179 2062 6520 6469 6666 6572 656e may be differen │ │ │ │ │ +000087b0: 7420 706c 6174 666f 726d 732e 0a0a 2020 t platforms... │ │ │ │ │ +000087c0: 2020 207e 2025 2063 6420 2f6e 6673 2f73 ~ % cd /nfs/s │ │ │ │ │ +000087d0: 7263 0a20 2020 2020 2f6e 6673 2f73 7263 rc. /nfs/src │ │ │ │ │ +000087e0: 2025 2074 6172 207a 7866 207e 2f61 6d68 % tar zxf ~/amh │ │ │ │ │ +000087f0: 656c 6c6f 2d31 2e30 2e74 6172 2e67 7a0a ello-1.0.tar.gz. │ │ │ │ │ +00008800: 0a20 2020 4f6e 2074 6865 2066 6972 7374 . On the first │ │ │ │ │ +00008810: 2068 6f73 742c 2079 6f75 2063 6f75 6c64 host, you could │ │ │ │ │ +00008820: 2063 7265 6174 6520 6120 6c6f 6361 6c20 create a local │ │ │ │ │ +00008830: 6275 696c 6420 6469 7265 6374 6f72 793a build directory: │ │ │ │ │ +00008840: 0a20 2020 2020 5b48 4f53 5431 5d20 7e20 . [HOST1] ~ │ │ │ │ │ +00008850: 2520 6d6b 6469 7220 2f74 6d70 2f61 6d68 % mkdir /tmp/amh │ │ │ │ │ +00008860: 2026 2620 6364 202f 746d 702f 616d 680a && cd /tmp/amh. │ │ │ │ │ +00008870: 2020 2020 205b 484f 5354 315d 202f 746d [HOST1] /tm │ │ │ │ │ +00008880: 702f 616d 6820 2520 2f6e 6673 2f73 7263 p/amh % /nfs/src │ │ │ │ │ +00008890: 2f61 6d68 656c 6c6f 2d31 2e30 2f63 6f6e /amhello-1.0/con │ │ │ │ │ +000088a0: 6669 6775 7265 0a20 2020 2020 2e2e 2e0a figure. .... │ │ │ │ │ +000088b0: 2020 2020 205b 484f 5354 315d 202f 746d [HOST1] /tm │ │ │ │ │ +000088c0: 702f 616d 6820 2520 6d61 6b65 2026 2620 p/amh % make && │ │ │ │ │ +000088d0: 7375 646f 206d 616b 6520 696e 7374 616c sudo make instal │ │ │ │ │ +000088e0: 6c0a 2020 2020 202e 2e2e 0a0a 2848 6572 l. .....(Her │ │ │ │ │ +000088f0: 6520 7765 2061 7373 756d 6520 7468 6174 e we assume that │ │ │ │ │ +00008900: 2074 6865 2069 6e73 7461 6c6c 6572 2068 the installer h │ │ │ │ │ +00008910: 6173 2063 6f6e 6669 6775 7265 6420 2773 as configured 's │ │ │ │ │ +00008920: 7564 6f27 2073 6f20 6974 2063 616e 0a65 udo' so it can.e │ │ │ │ │ +00008930: 7865 6375 7465 2027 6d61 6b65 2069 6e73 xecute 'make ins │ │ │ │ │ +00008940: 7461 6c6c 2720 7769 7468 2072 6f6f 7420 tall' with root │ │ │ │ │ +00008950: 7072 6976 696c 6567 6573 3b20 6974 2069 privileges; it i │ │ │ │ │ +00008960: 7320 6d6f 7265 2063 6f6e 7665 6e69 656e s more convenien │ │ │ │ │ +00008970: 7420 7468 616e 0a75 7369 6e67 2027 7375 t than.using 'su │ │ │ │ │ +00008980: 2720 6c69 6b65 2069 6e20 2a6e 6f74 6520 ' like in *note │ │ │ │ │ +00008990: 4261 7369 6320 496e 7374 616c 6c61 7469 Basic Installati │ │ │ │ │ +000089a0: 6f6e 3a3a 292e 0a0a 2020 204f 6e20 7468 on::)... On th │ │ │ │ │ +000089b0: 6520 7365 636f 6e64 2068 6f73 742c 2079 e second host, y │ │ │ │ │ +000089c0: 6f75 2077 6f75 6c64 2064 6f20 6578 6163 ou would do exac │ │ │ │ │ +000089d0: 746c 7920 7468 6520 7361 6d65 2c20 706f tly the same, po │ │ │ │ │ +000089e0: 7373 6962 6c79 2061 7420 7468 650a 7361 ssibly at the.sa │ │ │ │ │ +000089f0: 6d65 2074 696d 653a 0a20 2020 2020 5b48 me time:. [H │ │ │ │ │ +00008a00: 4f53 5432 5d20 7e20 2520 6d6b 6469 7220 OST2] ~ % mkdir │ │ │ │ │ +00008a10: 2f74 6d70 2f61 6d68 2026 2620 6364 202f /tmp/amh && cd / │ │ │ │ │ +00008a20: 746d 702f 616d 680a 2020 2020 205b 484f tmp/amh. [HO │ │ │ │ │ +00008a30: 5354 325d 202f 746d 702f 616d 6820 2520 ST2] /tmp/amh % │ │ │ │ │ +00008a40: 2f6e 6673 2f73 7263 2f61 6d68 656c 6c6f /nfs/src/amhello │ │ │ │ │ +00008a50: 2d31 2e30 2f63 6f6e 6669 6775 7265 0a20 -1.0/configure. │ │ │ │ │ +00008a60: 2020 2020 2e2e 2e0a 2020 2020 205b 484f .... [HO │ │ │ │ │ +00008a70: 5354 325d 202f 746d 702f 616d 6820 2520 ST2] /tmp/amh % │ │ │ │ │ +00008a80: 6d61 6b65 2026 2620 7375 646f 206d 616b make && sudo mak │ │ │ │ │ +00008a90: 6520 696e 7374 616c 6c0a 2020 2020 202e e install. . │ │ │ │ │ +00008aa0: 2e2e 0a0a 2020 2049 6e20 7468 6973 2073 .... In this s │ │ │ │ │ +00008ab0: 6365 6e61 7269 6f2c 206e 6f74 6869 6e67 cenario, nothing │ │ │ │ │ +00008ac0: 2066 6f72 6269 6473 2074 6865 2027 2f6e forbids the '/n │ │ │ │ │ +00008ad0: 6673 2f73 7263 2f61 6d68 656c 6c6f 2d31 fs/src/amhello-1 │ │ │ │ │ +00008ae0: 2e30 270a 6469 7265 6374 6f72 7920 6672 .0'.directory fr │ │ │ │ │ +00008af0: 6f6d 2062 6569 6e67 2072 6561 642d 6f6e om being read-on │ │ │ │ │ +00008b00: 6c79 2e20 2049 6e20 6661 6374 2056 5041 ly. In fact VPA │ │ │ │ │ +00008b10: 5448 2062 7569 6c64 7320 6172 6520 616c TH builds are al │ │ │ │ │ +00008b20: 736f 2061 206d 6561 6e73 0a6f 6620 6275 so a means.of bu │ │ │ │ │ +00008b30: 696c 6469 6e67 2070 6163 6b61 6765 7320 ilding packages │ │ │ │ │ +00008b40: 6672 6f6d 2061 2072 6561 642d 6f6e 6c79 from a read-only │ │ │ │ │ +00008b50: 206d 6564 6975 6d20 7375 6368 2061 7320 medium such as │ │ │ │ │ +00008b60: 6120 4344 2d52 4f4d 2e20 2854 6865 2046 a CD-ROM. (The F │ │ │ │ │ +00008b70: 5346 0a75 7365 6420 746f 2073 656c 6c20 SF.used to sell │ │ │ │ │ +00008b80: 4344 2d52 4f4d 2077 6974 6820 756e 7061 CD-ROM with unpa │ │ │ │ │ +00008b90: 636b 6564 2073 6f75 7263 6520 636f 6465 cked source code │ │ │ │ │ +00008ba0: 2c20 6265 666f 7265 2074 6865 2047 4e55 , before the GNU │ │ │ │ │ +00008bb0: 2070 726f 6a65 6374 0a67 7265 7720 736f project.grew so │ │ │ │ │ +00008bc0: 2062 6967 2e29 0a0a 1f0a 4669 6c65 3a20 big.)....File: │ │ │ │ │ +00008bd0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +00008be0: 666f 2c20 204e 6f64 653a 2054 776f 2d50 fo, Node: Two-P │ │ │ │ │ +00008bf0: 6172 7420 496e 7374 616c 6c2c 2020 4e65 art Install, Ne │ │ │ │ │ +00008c00: 7874 3a20 4372 6f73 732d 436f 6d70 696c xt: Cross-Compil │ │ │ │ │ +00008c10: 6174 696f 6e2c 2020 5072 6576 3a20 5650 ation, Prev: VP │ │ │ │ │ +00008c20: 4154 4820 4275 696c 6473 2c20 2055 703a ATH Builds, Up: │ │ │ │ │ +00008c30: 2055 7365 2043 6173 6573 0a0a 322e 322e Use Cases..2.2. │ │ │ │ │ +00008c40: 3720 5477 6f2d 5061 7274 2049 6e73 7461 7 Two-Part Insta │ │ │ │ │ +00008c50: 6c6c 6174 696f 6e0a 2d2d 2d2d 2d2d 2d2d llation.-------- │ │ │ │ │ 00008c60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00008c70: 2d0a 0a49 6e20 6f75 7220 6c61 7374 2065 -..In our last e │ │ │ │ │ -00008c80: 7861 6d70 6c65 2028 2a6e 6f74 6520 5650 xample (*note VP │ │ │ │ │ -00008c90: 4154 4820 4275 696c 6473 3a3a 292c 2061 ATH Builds::), a │ │ │ │ │ -00008ca0: 2073 6f75 7263 6520 7472 6565 2077 6173 source tree was │ │ │ │ │ -00008cb0: 2073 6861 7265 6420 6279 0a74 776f 2068 shared by.two h │ │ │ │ │ -00008cc0: 6f73 7473 2c20 6275 7420 636f 6d70 696c osts, but compil │ │ │ │ │ -00008cd0: 6174 696f 6e20 616e 6420 696e 7374 616c ation and instal │ │ │ │ │ -00008ce0: 6c61 7469 6f6e 2077 6572 6520 646f 6e65 lation were done │ │ │ │ │ -00008cf0: 2073 6570 6172 6174 656c 7920 6f6e 2065 separately on e │ │ │ │ │ -00008d00: 6163 680a 686f 7374 2e0a 0a20 2020 5468 ach.host... Th │ │ │ │ │ -00008d10: 6520 474e 5520 4275 696c 6420 5379 7374 e GNU Build Syst │ │ │ │ │ -00008d20: 656d 2061 6c73 6f20 7375 7070 6f72 7473 em also supports │ │ │ │ │ -00008d30: 206e 6574 776f 726b 6564 2073 6574 7570 networked setup │ │ │ │ │ -00008d40: 7320 7768 6572 6520 7061 7274 206f 6620 s where part of │ │ │ │ │ -00008d50: 7468 650a 696e 7374 616c 6c65 6420 6669 the.installed fi │ │ │ │ │ -00008d60: 6c65 7320 7368 6f75 6c64 2062 6520 7368 les should be sh │ │ │ │ │ -00008d70: 6172 6564 2061 6d6f 6e67 7374 206d 756c ared amongst mul │ │ │ │ │ -00008d80: 7469 706c 6520 686f 7374 732e 2020 4974 tiple hosts. It │ │ │ │ │ -00008d90: 2064 6f65 7320 736f 2062 790a 6469 7374 does so by.dist │ │ │ │ │ -00008da0: 696e 6775 6973 6869 6e67 2061 7263 6869 inguishing archi │ │ │ │ │ -00008db0: 7465 6374 7572 652d 6465 7065 6e64 656e tecture-dependen │ │ │ │ │ -00008dc0: 7420 6669 6c65 7320 6672 6f6d 0a61 7263 t files from.arc │ │ │ │ │ -00008dd0: 6869 7465 6374 7572 652d 696e 6465 7065 hitecture-indepe │ │ │ │ │ -00008de0: 6e64 656e 7420 6669 6c65 732c 2061 6e64 ndent files, and │ │ │ │ │ -00008df0: 2070 726f 7669 6469 6e67 2074 776f 2027 providing two ' │ │ │ │ │ -00008e00: 4d61 6b65 6669 6c65 2720 7461 7267 6574 Makefile' target │ │ │ │ │ -00008e10: 7320 746f 0a69 6e73 7461 6c6c 2065 6163 s to.install eac │ │ │ │ │ -00008e20: 6820 6f66 2074 6865 7365 2063 6c61 7373 h of these class │ │ │ │ │ -00008e30: 6573 206f 6620 6669 6c65 732e 0a0a 2020 es of files... │ │ │ │ │ -00008e40: 2054 6865 7365 2074 6172 6765 7473 2061 These targets a │ │ │ │ │ -00008e50: 7265 2027 696e 7374 616c 6c2d 6578 6563 re 'install-exec │ │ │ │ │ -00008e60: 2720 666f 7220 6172 6368 6974 6563 7475 ' for architectu │ │ │ │ │ -00008e70: 7265 2d64 6570 656e 6465 6e74 2066 696c re-dependent fil │ │ │ │ │ -00008e80: 6573 2061 6e64 0a27 696e 7374 616c 6c2d es and.'install- │ │ │ │ │ -00008e90: 6461 7461 2720 666f 7220 6172 6368 6974 data' for archit │ │ │ │ │ -00008ea0: 6563 7475 7265 2d69 6e64 6570 656e 6465 ecture-independe │ │ │ │ │ -00008eb0: 6e74 2066 696c 6573 2e20 2054 6865 2063 nt files. The c │ │ │ │ │ -00008ec0: 6f6d 6d61 6e64 2077 6520 7573 6564 0a75 ommand we used.u │ │ │ │ │ -00008ed0: 7020 746f 206e 6f77 2c20 276d 616b 6520 p to now, 'make │ │ │ │ │ -00008ee0: 696e 7374 616c 6c27 2c20 6361 6e20 6265 install', can be │ │ │ │ │ -00008ef0: 2074 686f 7567 6874 206f 6620 6173 2061 thought of as a │ │ │ │ │ -00008f00: 2073 686f 7274 6861 6e64 2066 6f72 2027 shorthand for ' │ │ │ │ │ -00008f10: 6d61 6b65 0a69 6e73 7461 6c6c 2d65 7865 make.install-exe │ │ │ │ │ -00008f20: 6320 696e 7374 616c 6c2d 6461 7461 272e c install-data'. │ │ │ │ │ -00008f30: 0a0a 2020 2046 726f 6d20 7468 6520 474e .. From the GN │ │ │ │ │ -00008f40: 5520 4275 696c 6420 5379 7374 656d 2070 U Build System p │ │ │ │ │ -00008f50: 6f69 6e74 206f 6620 7669 6577 2c20 7468 oint of view, th │ │ │ │ │ -00008f60: 6520 6469 7374 696e 6374 696f 6e20 6265 e distinction be │ │ │ │ │ -00008f70: 7477 6565 6e0a 6172 6368 6974 6563 7475 tween.architectu │ │ │ │ │ -00008f80: 7265 2d64 6570 656e 6465 6e74 2066 696c re-dependent fil │ │ │ │ │ -00008f90: 6573 2061 6e64 2061 7263 6869 7465 6374 es and architect │ │ │ │ │ -00008fa0: 7572 652d 696e 6465 7065 6e64 656e 7420 ure-independent │ │ │ │ │ -00008fb0: 6669 6c65 7320 6973 2062 6173 6564 0a65 files is based.e │ │ │ │ │ -00008fc0: 7863 6c75 7369 7665 6c79 206f 6e20 7468 xclusively on th │ │ │ │ │ -00008fd0: 6520 6469 7265 6374 6f72 7920 7661 7269 e directory vari │ │ │ │ │ -00008fe0: 6162 6c65 2075 7365 6420 746f 2073 7065 able used to spe │ │ │ │ │ -00008ff0: 6369 6679 2074 6865 6972 2069 6e73 7461 cify their insta │ │ │ │ │ -00009000: 6c6c 6174 696f 6e0a 6465 7374 696e 6174 llation.destinat │ │ │ │ │ -00009010: 696f 6e2e 2020 496e 2074 6865 206c 6973 ion. In the lis │ │ │ │ │ -00009020: 7420 6f66 2064 6972 6563 746f 7279 2076 t of directory v │ │ │ │ │ -00009030: 6172 6961 626c 6573 2077 6520 7072 6f76 ariables we prov │ │ │ │ │ -00009040: 6964 6564 2065 6172 6c69 6572 0a28 2a6e ided earlier.(*n │ │ │ │ │ -00009050: 6f74 6520 5374 616e 6461 7264 2044 6972 ote Standard Dir │ │ │ │ │ -00009060: 6563 746f 7279 2056 6172 6961 626c 6573 ectory Variables │ │ │ │ │ -00009070: 3a3a 292c 2061 6c6c 2074 6865 2076 6172 ::), all the var │ │ │ │ │ -00009080: 6961 626c 6573 2062 6173 6564 206f 6e0a iables based on. │ │ │ │ │ -00009090: 4558 4543 2d50 5245 4649 5820 6465 7369 EXEC-PREFIX desi │ │ │ │ │ -000090a0: 676e 6174 6520 6172 6368 6974 6563 7475 gnate architectu │ │ │ │ │ -000090b0: 7265 2d64 6570 656e 6465 6e74 2064 6972 re-dependent dir │ │ │ │ │ -000090c0: 6563 746f 7269 6573 2077 686f 7365 2066 ectories whose f │ │ │ │ │ -000090d0: 696c 6573 0a77 696c 6c20 6265 2069 6e73 iles.will be ins │ │ │ │ │ -000090e0: 7461 6c6c 6564 2062 7920 276d 616b 6520 talled by 'make │ │ │ │ │ -000090f0: 696e 7374 616c 6c2d 6578 6563 272e 2020 install-exec'. │ │ │ │ │ -00009100: 5468 6520 6f74 6865 7273 2064 6573 6967 The others desig │ │ │ │ │ -00009110: 6e61 7465 0a61 7263 6869 7465 6374 7572 nate.architectur │ │ │ │ │ -00009120: 652d 696e 6465 7065 6e64 656e 7420 6469 e-independent di │ │ │ │ │ -00009130: 7265 6374 6f72 6965 7320 616e 6420 7769 rectories and wi │ │ │ │ │ -00009140: 6c6c 2073 6572 7665 2066 696c 6573 2069 ll serve files i │ │ │ │ │ -00009150: 6e73 7461 6c6c 6564 2062 790a 276d 616b nstalled by.'mak │ │ │ │ │ -00009160: 6520 696e 7374 616c 6c2d 6461 7461 272e e install-data'. │ │ │ │ │ -00009170: 2020 2a4e 6f74 6520 5468 6520 5477 6f20 *Note The Two │ │ │ │ │ -00009180: 5061 7274 7320 6f66 2049 6e73 7461 6c6c Parts of Install │ │ │ │ │ -00009190: 3a3a 2c20 666f 7220 6d6f 7265 0a64 6574 ::, for more.det │ │ │ │ │ -000091a0: 6169 6c73 2e0a 0a20 2020 4865 7265 2069 ails... Here i │ │ │ │ │ -000091b0: 7320 686f 7720 7765 2063 6f75 6c64 2072 s how we could r │ │ │ │ │ -000091c0: 6576 6973 6974 206f 7572 2074 776f 2d68 evisit our two-h │ │ │ │ │ -000091d0: 6f73 7420 696e 7374 616c 6c61 7469 6f6e ost installation │ │ │ │ │ -000091e0: 2065 7861 6d70 6c65 2c0a 6173 7375 6d69 example,.assumi │ │ │ │ │ -000091f0: 6e67 2074 6861 7420 2831 2920 7765 2077 ng that (1) we w │ │ │ │ │ -00009200: 616e 7420 746f 2069 6e73 7461 6c6c 2074 ant to install t │ │ │ │ │ -00009210: 6865 2070 6163 6b61 6765 2064 6972 6563 he package direc │ │ │ │ │ -00009220: 746c 7920 696e 2027 2f75 7372 272c 2061 tly in '/usr', a │ │ │ │ │ -00009230: 6e64 0a28 3229 2074 6865 2064 6972 6563 nd.(2) the direc │ │ │ │ │ -00009240: 746f 7279 2027 2f75 7372 2f73 6861 7265 tory '/usr/share │ │ │ │ │ -00009250: 2720 6973 2073 6861 7265 6420 6279 2074 ' is shared by t │ │ │ │ │ -00009260: 6865 2074 776f 2068 6f73 7473 2e0a 0a20 he two hosts... │ │ │ │ │ -00009270: 2020 4f6e 2074 6865 2066 6972 7374 2068 On the first h │ │ │ │ │ -00009280: 6f73 7420 7765 2077 6f75 6c64 2072 756e ost we would run │ │ │ │ │ -00009290: 0a20 2020 2020 5b48 4f53 5431 5d20 7e20 . [HOST1] ~ │ │ │ │ │ -000092a0: 2520 6d6b 6469 7220 2f74 6d70 2f61 6d68 % mkdir /tmp/amh │ │ │ │ │ -000092b0: 2026 2620 6364 202f 746d 702f 616d 680a && cd /tmp/amh. │ │ │ │ │ -000092c0: 2020 2020 205b 484f 5354 315d 202f 746d [HOST1] /tm │ │ │ │ │ -000092d0: 702f 616d 6820 2520 2f6e 6673 2f73 7263 p/amh % /nfs/src │ │ │ │ │ -000092e0: 2f61 6d68 656c 6c6f 2d31 2e30 2f63 6f6e /amhello-1.0/con │ │ │ │ │ -000092f0: 6669 6775 7265 202d 2d70 7265 6669 7820 figure --prefix │ │ │ │ │ -00009300: 2f75 7372 0a20 2020 2020 2e2e 2e0a 2020 /usr. .... │ │ │ │ │ -00009310: 2020 205b 484f 5354 315d 202f 746d 702f [HOST1] /tmp/ │ │ │ │ │ -00009320: 616d 6820 2520 6d61 6b65 2026 2620 7375 amh % make && su │ │ │ │ │ -00009330: 646f 206d 616b 6520 696e 7374 616c 6c0a do make install. │ │ │ │ │ -00009340: 2020 2020 202e 2e2e 0a0a 2020 204f 6e20 ..... On │ │ │ │ │ -00009350: 7468 6520 7365 636f 6e64 2068 6f73 742c the second host, │ │ │ │ │ -00009360: 2068 6f77 6576 6572 2c20 7765 206e 6565 however, we nee │ │ │ │ │ -00009370: 6420 6f6e 6c79 2069 6e73 7461 6c6c 2074 d only install t │ │ │ │ │ -00009380: 6865 0a61 7263 6869 7465 6374 7572 652d he.architecture- │ │ │ │ │ -00009390: 7370 6563 6966 6963 2066 696c 6573 2e0a specific files.. │ │ │ │ │ -000093a0: 2020 2020 205b 484f 5354 325d 207e 2025 [HOST2] ~ % │ │ │ │ │ -000093b0: 206d 6b64 6972 202f 746d 702f 616d 6820 mkdir /tmp/amh │ │ │ │ │ -000093c0: 2626 2063 6420 2f74 6d70 2f61 6d68 0a20 && cd /tmp/amh. │ │ │ │ │ -000093d0: 2020 2020 5b48 4f53 5432 5d20 2f74 6d70 [HOST2] /tmp │ │ │ │ │ -000093e0: 2f61 6d68 2025 202f 6e66 732f 7372 632f /amh % /nfs/src/ │ │ │ │ │ -000093f0: 616d 6865 6c6c 6f2d 312e 302f 636f 6e66 amhello-1.0/conf │ │ │ │ │ -00009400: 6967 7572 6520 2d2d 7072 6566 6978 202f igure --prefix / │ │ │ │ │ -00009410: 7573 720a 2020 2020 202e 2e2e 0a20 2020 usr. .... │ │ │ │ │ -00009420: 2020 5b48 4f53 5432 5d20 2f74 6d70 2f61 [HOST2] /tmp/a │ │ │ │ │ -00009430: 6d68 2025 206d 616b 6520 2626 2073 7564 mh % make && sud │ │ │ │ │ -00009440: 6f20 6d61 6b65 2069 6e73 7461 6c6c 2d65 o make install-e │ │ │ │ │ -00009450: 7865 630a 2020 2020 202e 2e2e 0a0a 2020 xec. ..... │ │ │ │ │ -00009460: 2049 6e20 7061 636b 6167 6573 2074 6861 In packages tha │ │ │ │ │ -00009470: 7420 6861 7665 2069 6e73 7461 6c6c 6174 t have installat │ │ │ │ │ -00009480: 696f 6e20 6368 6563 6b73 2c20 6974 2077 ion checks, it w │ │ │ │ │ -00009490: 6f75 6c64 206d 616b 6520 7365 6e73 6520 ould make sense │ │ │ │ │ -000094a0: 746f 2072 756e 0a27 6d61 6b65 2069 6e73 to run.'make ins │ │ │ │ │ -000094b0: 7461 6c6c 6368 6563 6b27 2028 2a6e 6f74 tallcheck' (*not │ │ │ │ │ -000094c0: 6520 4261 7369 6320 496e 7374 616c 6c61 e Basic Installa │ │ │ │ │ -000094d0: 7469 6f6e 3a3a 2920 746f 2076 6572 6966 tion::) to verif │ │ │ │ │ -000094e0: 7920 7468 6174 2074 6865 0a70 6163 6b61 y that the.packa │ │ │ │ │ -000094f0: 6765 2077 6f72 6b73 2063 6f72 7265 6374 ge works correct │ │ │ │ │ -00009500: 6c79 2064 6573 7069 7465 2074 6865 2061 ly despite the a │ │ │ │ │ -00009510: 7070 6172 656e 7420 7061 7274 6961 6c20 pparent partial │ │ │ │ │ -00009520: 696e 7374 616c 6c61 7469 6f6e 2e0a 0a1f installation.... │ │ │ │ │ -00009530: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -00009540: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -00009550: 3a20 4372 6f73 732d 436f 6d70 696c 6174 : Cross-Compilat │ │ │ │ │ -00009560: 696f 6e2c 2020 4e65 7874 3a20 5265 6e61 ion, Next: Rena │ │ │ │ │ -00009570: 6d69 6e67 2c20 2050 7265 763a 2054 776f ming, Prev: Two │ │ │ │ │ -00009580: 2d50 6172 7420 496e 7374 616c 6c2c 2020 -Part Install, │ │ │ │ │ -00009590: 5570 3a20 5573 6520 4361 7365 730a 0a32 Up: Use Cases..2 │ │ │ │ │ -000095a0: 2e32 2e38 2043 726f 7373 2d43 6f6d 7069 .2.8 Cross-Compi │ │ │ │ │ -000095b0: 6c61 7469 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d lation.--------- │ │ │ │ │ -000095c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -000095d0: 546f 2022 6372 6f73 732d 636f 6d70 696c To "cross-compil │ │ │ │ │ -000095e0: 6522 2069 7320 746f 2062 7569 6c64 206f e" is to build o │ │ │ │ │ -000095f0: 6e20 6f6e 6520 706c 6174 666f 726d 2061 n one platform a │ │ │ │ │ -00009600: 2062 696e 6172 7920 7468 6174 2077 696c binary that wil │ │ │ │ │ -00009610: 6c20 7275 6e20 6f6e 0a61 6e6f 7468 6572 l run on.another │ │ │ │ │ -00009620: 2070 6c61 7466 6f72 6d2e 2020 5768 656e platform. When │ │ │ │ │ -00009630: 2073 7065 616b 696e 6720 6f66 2063 726f speaking of cro │ │ │ │ │ -00009640: 7373 2d63 6f6d 7069 6c61 7469 6f6e 2c20 ss-compilation, │ │ │ │ │ -00009650: 6974 2069 7320 696d 706f 7274 616e 740a it is important. │ │ │ │ │ -00009660: 746f 2064 6973 7469 6e67 7569 7368 2062 to distinguish b │ │ │ │ │ -00009670: 6574 7765 656e 2074 6865 2022 6275 696c etween the "buil │ │ │ │ │ -00009680: 6420 706c 6174 666f 726d 2220 6f6e 2077 d platform" on w │ │ │ │ │ -00009690: 6869 6368 2074 6865 2063 6f6d 7069 6c61 hich the compila │ │ │ │ │ -000096a0: 7469 6f6e 2069 730a 7065 7266 6f72 6d65 tion is.performe │ │ │ │ │ -000096b0: 642c 2061 6e64 2074 6865 2022 686f 7374 d, and the "host │ │ │ │ │ -000096c0: 2070 6c61 7466 6f72 6d22 206f 6e20 7768 platform" on wh │ │ │ │ │ -000096d0: 6963 6820 7468 6520 7265 7375 6c74 696e ich the resultin │ │ │ │ │ -000096e0: 6720 6578 6563 7574 6162 6c65 2069 730a g executable is. │ │ │ │ │ -000096f0: 6578 7065 6374 6564 2074 6f20 7275 6e2e expected to run. │ │ │ │ │ -00009700: 2020 5468 6520 666f 6c6c 6f77 696e 6720 The following │ │ │ │ │ -00009710: 2763 6f6e 6669 6775 7265 2720 6f70 7469 'configure' opti │ │ │ │ │ -00009720: 6f6e 7320 6172 6520 7573 6564 2074 6f20 ons are used to │ │ │ │ │ -00009730: 7370 6563 6966 790a 6561 6368 206f 6620 specify.each of │ │ │ │ │ -00009740: 7468 656d 3a0a 0a27 2d2d 6275 696c 643d them:..'--build= │ │ │ │ │ -00009750: 4255 494c 4427 0a20 2020 2020 5468 6520 BUILD'. The │ │ │ │ │ -00009760: 7379 7374 656d 206f 6e20 7768 6963 6820 system on which │ │ │ │ │ -00009770: 7468 6520 7061 636b 6167 6520 6973 2062 the package is b │ │ │ │ │ -00009780: 7569 6c74 2e0a 272d 2d68 6f73 743d 484f uilt..'--host=HO │ │ │ │ │ -00009790: 5354 270a 2020 2020 2054 6865 2073 7973 ST'. The sys │ │ │ │ │ -000097a0: 7465 6d20 7768 6572 6520 6275 696c 7420 tem where built │ │ │ │ │ -000097b0: 7072 6f67 7261 6d73 2061 6e64 206c 6962 programs and lib │ │ │ │ │ -000097c0: 7261 7269 6573 2077 696c 6c20 7275 6e2e raries will run. │ │ │ │ │ -000097d0: 0a0a 2020 2057 6865 6e20 7468 6520 272d .. When the '- │ │ │ │ │ -000097e0: 2d68 6f73 7427 2069 7320 7573 6564 2c20 -host' is used, │ │ │ │ │ -000097f0: 2763 6f6e 6669 6775 7265 2720 7769 6c6c 'configure' will │ │ │ │ │ -00009800: 2073 6561 7263 6820 666f 7220 7468 650a search for the. │ │ │ │ │ -00009810: 6372 6f73 732d 636f 6d70 696c 696e 6720 cross-compiling │ │ │ │ │ -00009820: 7375 6974 6520 666f 7220 7468 6973 2070 suite for this p │ │ │ │ │ -00009830: 6c61 7466 6f72 6d2e 2020 4372 6f73 732d latform. Cross- │ │ │ │ │ -00009840: 636f 6d70 696c 6174 696f 6e20 746f 6f6c compilation tool │ │ │ │ │ -00009850: 730a 636f 6d6d 6f6e 6c79 2068 6176 6520 s.commonly have │ │ │ │ │ -00009860: 7468 6569 7220 7461 7267 6574 2061 7263 their target arc │ │ │ │ │ -00009870: 6869 7465 6374 7572 6520 6173 2070 7265 hitecture as pre │ │ │ │ │ -00009880: 6669 7820 6f66 2074 6865 6972 206e 616d fix of their nam │ │ │ │ │ -00009890: 652e 2020 466f 720a 696e 7374 616e 6365 e. For.instance │ │ │ │ │ -000098a0: 206d 7920 6372 6f73 732d 636f 6d70 696c my cross-compil │ │ │ │ │ -000098b0: 6572 2066 6f72 204d 696e 4757 3332 2068 er for MinGW32 h │ │ │ │ │ -000098c0: 6173 2069 7473 2062 696e 6172 6965 7320 as its binaries │ │ │ │ │ -000098d0: 6361 6c6c 6564 0a27 6935 3836 2d6d 696e called.'i586-min │ │ │ │ │ -000098e0: 6777 3332 6d73 7663 2d67 6363 272c 2027 gw32msvc-gcc', ' │ │ │ │ │ -000098f0: 6935 3836 2d6d 696e 6777 3332 6d73 7663 i586-mingw32msvc │ │ │ │ │ -00009900: 2d6c 6427 2c20 2769 3538 362d 6d69 6e67 -ld', 'i586-ming │ │ │ │ │ -00009910: 7733 326d 7376 632d 6173 272c 0a65 7463 w32msvc-as',.etc │ │ │ │ │ -00009920: 2e0a 0a20 2020 4865 7265 2069 7320 686f ... Here is ho │ │ │ │ │ -00009930: 7720 7765 2063 6f75 6c64 2062 7569 6c64 w we could build │ │ │ │ │ -00009940: 2027 616d 6865 6c6c 6f2d 312e 3027 2066 'amhello-1.0' f │ │ │ │ │ -00009950: 6f72 2027 6935 3836 2d6d 696e 6777 3332 or 'i586-mingw32 │ │ │ │ │ -00009960: 6d73 7663 2720 6f6e 2061 0a47 4e55 2f4c msvc' on a.GNU/L │ │ │ │ │ -00009970: 696e 7578 2050 432e 0a0a 2020 2020 207e inux PC... ~ │ │ │ │ │ -00009980: 2f61 6d68 656c 6c6f 2d31 2e30 2025 202e /amhello-1.0 % . │ │ │ │ │ -00009990: 2f63 6f6e 6669 6775 7265 202d 2d62 7569 /configure --bui │ │ │ │ │ -000099a0: 6c64 2069 3638 362d 7063 2d6c 696e 7578 ld i686-pc-linux │ │ │ │ │ -000099b0: 2d67 6e75 202d 2d68 6f73 7420 6935 3836 -gnu --host i586 │ │ │ │ │ -000099c0: 2d6d 696e 6777 3332 6d73 7663 0a20 2020 -mingw32msvc. │ │ │ │ │ -000099d0: 2020 6368 6563 6b69 6e67 2066 6f72 2061 checking for a │ │ │ │ │ -000099e0: 2042 5344 2d63 6f6d 7061 7469 626c 6520 BSD-compatible │ │ │ │ │ -000099f0: 696e 7374 616c 6c2e 2e2e 202f 7573 722f install... /usr/ │ │ │ │ │ -00009a00: 6269 6e2f 696e 7374 616c 6c20 2d63 0a20 bin/install -c. │ │ │ │ │ -00009a10: 2020 2020 6368 6563 6b69 6e67 2077 6865 checking whe │ │ │ │ │ -00009a20: 7468 6572 2062 7569 6c64 2065 6e76 6972 ther build envir │ │ │ │ │ -00009a30: 6f6e 6d65 6e74 2069 7320 7361 6e65 2e2e onment is sane.. │ │ │ │ │ -00009a40: 2e20 7965 730a 2020 2020 2063 6865 636b . yes. check │ │ │ │ │ -00009a50: 696e 6720 666f 7220 6761 776b 2e2e 2e20 ing for gawk... │ │ │ │ │ -00009a60: 6761 776b 0a20 2020 2020 6368 6563 6b69 gawk. checki │ │ │ │ │ -00009a70: 6e67 2077 6865 7468 6572 206d 616b 6520 ng whether make │ │ │ │ │ -00009a80: 7365 7473 2024 284d 414b 4529 2e2e 2e20 sets $(MAKE)... │ │ │ │ │ -00009a90: 7965 730a 2020 2020 2063 6865 636b 696e yes. checkin │ │ │ │ │ -00009aa0: 6720 666f 7220 6935 3836 2d6d 696e 6777 g for i586-mingw │ │ │ │ │ -00009ab0: 3332 6d73 7663 2d73 7472 6970 2e2e 2e20 32msvc-strip... │ │ │ │ │ -00009ac0: 6935 3836 2d6d 696e 6777 3332 6d73 7663 i586-mingw32msvc │ │ │ │ │ -00009ad0: 2d73 7472 6970 0a20 2020 2020 6368 6563 -strip. chec │ │ │ │ │ -00009ae0: 6b69 6e67 2066 6f72 2069 3538 362d 6d69 king for i586-mi │ │ │ │ │ -00009af0: 6e67 7733 326d 7376 632d 6763 632e 2e2e ngw32msvc-gcc... │ │ │ │ │ -00009b00: 2069 3538 362d 6d69 6e67 7733 326d 7376 i586-mingw32msv │ │ │ │ │ -00009b10: 632d 6763 630a 2020 2020 2063 6865 636b c-gcc. check │ │ │ │ │ -00009b20: 696e 6720 666f 7220 4320 636f 6d70 696c ing for C compil │ │ │ │ │ -00009b30: 6572 2064 6566 6175 6c74 206f 7574 7075 er default outpu │ │ │ │ │ -00009b40: 7420 6669 6c65 206e 616d 652e 2e2e 2061 t file name... a │ │ │ │ │ -00009b50: 2e65 7865 0a20 2020 2020 6368 6563 6b69 .exe. checki │ │ │ │ │ -00009b60: 6e67 2077 6865 7468 6572 2074 6865 2043 ng whether the C │ │ │ │ │ -00009b70: 2063 6f6d 7069 6c65 7220 776f 726b 732e compiler works. │ │ │ │ │ -00009b80: 2e2e 2079 6573 0a20 2020 2020 6368 6563 .. yes. chec │ │ │ │ │ -00009b90: 6b69 6e67 2077 6865 7468 6572 2077 6520 king whether we │ │ │ │ │ -00009ba0: 6172 6520 6372 6f73 7320 636f 6d70 696c are cross compil │ │ │ │ │ -00009bb0: 696e 672e 2e2e 2079 6573 0a20 2020 2020 ing... yes. │ │ │ │ │ -00009bc0: 6368 6563 6b69 6e67 2066 6f72 2073 7566 checking for suf │ │ │ │ │ -00009bd0: 6669 7820 6f66 2065 7865 6375 7461 626c fix of executabl │ │ │ │ │ -00009be0: 6573 2e2e 2e20 2e65 7865 0a20 2020 2020 es... .exe. │ │ │ │ │ -00009bf0: 6368 6563 6b69 6e67 2066 6f72 2073 7566 checking for suf │ │ │ │ │ -00009c00: 6669 7820 6f66 206f 626a 6563 7420 6669 fix of object fi │ │ │ │ │ -00009c10: 6c65 732e 2e2e 206f 0a20 2020 2020 6368 les... o. ch │ │ │ │ │ -00009c20: 6563 6b69 6e67 2077 6865 7468 6572 2077 ecking whether w │ │ │ │ │ -00009c30: 6520 6172 6520 7573 696e 6720 7468 6520 e are using the │ │ │ │ │ -00009c40: 474e 5520 4320 636f 6d70 696c 6572 2e2e GNU C compiler.. │ │ │ │ │ -00009c50: 2e20 7965 730a 2020 2020 2063 6865 636b . yes. check │ │ │ │ │ -00009c60: 696e 6720 7768 6574 6865 7220 6935 3836 ing whether i586 │ │ │ │ │ -00009c70: 2d6d 696e 6777 3332 6d73 7663 2d67 6363 -mingw32msvc-gcc │ │ │ │ │ -00009c80: 2061 6363 6570 7473 202d 672e 2e2e 2079 accepts -g... y │ │ │ │ │ -00009c90: 6573 0a20 2020 2020 6368 6563 6b69 6e67 es. checking │ │ │ │ │ -00009ca0: 2066 6f72 2069 3538 362d 6d69 6e67 7733 for i586-mingw3 │ │ │ │ │ -00009cb0: 326d 7376 632d 6763 6320 6f70 7469 6f6e 2msvc-gcc option │ │ │ │ │ -00009cc0: 2074 6f20 6163 6365 7074 2041 4e53 4920 to accept ANSI │ │ │ │ │ -00009cd0: 432e 2e2e 0a20 2020 2020 2e2e 2e0a 2020 C.... .... │ │ │ │ │ -00009ce0: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ -00009cf0: 2025 206d 616b 650a 2020 2020 202e 2e2e % make. ... │ │ │ │ │ -00009d00: 0a20 2020 2020 7e2f 616d 6865 6c6c 6f2d . ~/amhello- │ │ │ │ │ -00009d10: 312e 3020 2520 6364 2073 7263 3b20 6669 1.0 % cd src; fi │ │ │ │ │ -00009d20: 6c65 2068 656c 6c6f 2e65 7865 0a20 2020 le hello.exe. │ │ │ │ │ -00009d30: 2020 6865 6c6c 6f2e 6578 653a 204d 5320 hello.exe: MS │ │ │ │ │ -00009d40: 5769 6e64 6f77 7320 5045 2033 322d 6269 Windows PE 32-bi │ │ │ │ │ -00009d50: 7420 496e 7465 6c20 3830 3338 3620 636f t Intel 80386 co │ │ │ │ │ -00009d60: 6e73 6f6c 6520 6578 6563 7574 6162 6c65 nsole executable │ │ │ │ │ -00009d70: 206e 6f74 2072 656c 6f63 6174 6162 6c65 not relocatable │ │ │ │ │ -00009d80: 0a0a 2020 2054 6865 2027 2d2d 686f 7374 .. The '--host │ │ │ │ │ -00009d90: 2720 616e 6420 272d 2d62 7569 6c64 2720 ' and '--build' │ │ │ │ │ -00009da0: 6f70 7469 6f6e 7320 6172 6520 7573 7561 options are usua │ │ │ │ │ -00009db0: 6c6c 7920 616c 6c20 7765 206e 6565 6420 lly all we need │ │ │ │ │ -00009dc0: 666f 720a 6372 6f73 732d 636f 6d70 696c for.cross-compil │ │ │ │ │ -00009dd0: 696e 672e 2020 5468 6520 6f6e 6c79 2065 ing. The only e │ │ │ │ │ -00009de0: 7863 6570 7469 6f6e 2069 7320 6966 2074 xception is if t │ │ │ │ │ -00009df0: 6865 2070 6163 6b61 6765 2062 6569 6e67 he package being │ │ │ │ │ -00009e00: 2062 7569 6c74 2069 730a 6974 7365 6c66 built is.itself │ │ │ │ │ -00009e10: 2061 2063 726f 7373 2d63 6f6d 7069 6c65 a cross-compile │ │ │ │ │ -00009e20: 723a 2077 6520 6e65 6564 2061 2074 6869 r: we need a thi │ │ │ │ │ -00009e30: 7264 206f 7074 696f 6e20 746f 2073 7065 rd option to spe │ │ │ │ │ -00009e40: 6369 6679 2069 7473 2074 6172 6765 740a cify its target. │ │ │ │ │ -00009e50: 6172 6368 6974 6563 7475 7265 2e0a 0a27 architecture...' │ │ │ │ │ -00009e60: 2d2d 7461 7267 6574 3d54 4152 4745 5427 --target=TARGET' │ │ │ │ │ -00009e70: 0a20 2020 2020 5768 656e 2062 7569 6c64 . When build │ │ │ │ │ -00009e80: 696e 6720 636f 6d70 696c 6572 2074 6f6f ing compiler too │ │ │ │ │ -00009e90: 6c73 3a20 7468 6520 7379 7374 656d 2066 ls: the system f │ │ │ │ │ -00009ea0: 6f72 2077 6869 6368 2074 6865 2074 6f6f or which the too │ │ │ │ │ -00009eb0: 6c73 2077 696c 6c0a 2020 2020 2063 7265 ls will. cre │ │ │ │ │ -00009ec0: 6174 6520 6f75 7470 7574 2e0a 0a20 2020 ate output... │ │ │ │ │ -00009ed0: 466f 7220 696e 7374 616e 6365 2077 6865 For instance whe │ │ │ │ │ -00009ee0: 6e20 696e 7374 616c 6c69 6e67 2047 4343 n installing GCC │ │ │ │ │ -00009ef0: 2c20 7468 6520 474e 5520 436f 6d70 696c , the GNU Compil │ │ │ │ │ -00009f00: 6572 2043 6f6c 6c65 6374 696f 6e2c 2077 er Collection, w │ │ │ │ │ -00009f10: 6520 6361 6e0a 7573 6520 272d 2d74 6172 e can.use '--tar │ │ │ │ │ -00009f20: 6765 743d 5441 5247 4554 2720 746f 2073 get=TARGET' to s │ │ │ │ │ -00009f30: 7065 6369 6679 2074 6861 7420 7765 2077 pecify that we w │ │ │ │ │ -00009f40: 616e 7420 746f 2062 7569 6c64 2047 4343 ant to build GCC │ │ │ │ │ -00009f50: 2061 7320 610a 6372 6f73 732d 636f 6d70 as a.cross-comp │ │ │ │ │ -00009f60: 696c 6572 2066 6f72 2054 4152 4745 542e iler for TARGET. │ │ │ │ │ -00009f70: 2020 4d69 7869 6e67 2027 2d2d 6275 696c Mixing '--buil │ │ │ │ │ -00009f80: 6427 2061 6e64 2027 2d2d 7461 7267 6574 d' and '--target │ │ │ │ │ -00009f90: 272c 2077 6520 6361 6e0a 6163 7475 616c ', we can.actual │ │ │ │ │ -00009fa0: 6c79 2063 726f 7373 2d63 6f6d 7069 6c65 ly cross-compile │ │ │ │ │ -00009fb0: 2061 2063 726f 7373 2d63 6f6d 7069 6c65 a cross-compile │ │ │ │ │ -00009fc0: 723b 2073 7563 6820 6120 7468 7265 652d r; such a three- │ │ │ │ │ -00009fd0: 7761 790a 6372 6f73 732d 636f 6d70 696c way.cross-compil │ │ │ │ │ -00009fe0: 6174 696f 6e20 6973 206b 6e6f 776e 2061 ation is known a │ │ │ │ │ -00009ff0: 7320 6120 2243 616e 6164 6961 6e20 6372 s a "Canadian cr │ │ │ │ │ -0000a000: 6f73 7322 2e0a 0a20 2020 2a4e 6f74 6520 oss"... *Note │ │ │ │ │ -0000a010: 5370 6563 6966 7969 6e67 2074 6865 2053 Specifying the S │ │ │ │ │ -0000a020: 7973 7465 6d20 5479 7065 3a20 2861 7574 ystem Type: (aut │ │ │ │ │ -0000a030: 6f63 6f6e 6629 5370 6563 6966 7969 6e67 oconf)Specifying │ │ │ │ │ -0000a040: 204e 616d 6573 2c20 666f 720a 6d6f 7265 Names, for.more │ │ │ │ │ -0000a050: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f information abo │ │ │ │ │ -0000a060: 7574 2074 6865 7365 2027 636f 6e66 6967 ut these 'config │ │ │ │ │ -0000a070: 7572 6527 206f 7074 696f 6e73 2e0a 0a1f ure' options.... │ │ │ │ │ -0000a080: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -0000a090: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -0000a0a0: 3a20 5265 6e61 6d69 6e67 2c20 204e 6578 : Renaming, Nex │ │ │ │ │ -0000a0b0: 743a 2044 4553 5444 4952 2c20 2050 7265 t: DESTDIR, Pre │ │ │ │ │ -0000a0c0: 763a 2043 726f 7373 2d43 6f6d 7069 6c61 v: Cross-Compila │ │ │ │ │ -0000a0d0: 7469 6f6e 2c20 2055 703a 2055 7365 2043 tion, Up: Use C │ │ │ │ │ -0000a0e0: 6173 6573 0a0a 322e 322e 3920 5265 6e61 ases..2.2.9 Rena │ │ │ │ │ -0000a0f0: 6d69 6e67 2050 726f 6772 616d 7320 6174 ming Programs at │ │ │ │ │ -0000a100: 2049 6e73 7461 6c6c 2054 696d 650a 2d2d Install Time.-- │ │ │ │ │ +00008c70: 2d2d 2d0a 0a49 6e20 6f75 7220 6c61 7374 ---..In our last │ │ │ │ │ +00008c80: 2065 7861 6d70 6c65 2028 2a6e 6f74 6520 example (*note │ │ │ │ │ +00008c90: 5650 4154 4820 4275 696c 6473 3a3a 292c VPATH Builds::), │ │ │ │ │ +00008ca0: 2061 2073 6f75 7263 6520 7472 6565 2077 a source tree w │ │ │ │ │ +00008cb0: 6173 2073 6861 7265 6420 6279 0a74 776f as shared by.two │ │ │ │ │ +00008cc0: 2068 6f73 7473 2c20 6275 7420 636f 6d70 hosts, but comp │ │ │ │ │ +00008cd0: 696c 6174 696f 6e20 616e 6420 696e 7374 ilation and inst │ │ │ │ │ +00008ce0: 616c 6c61 7469 6f6e 2077 6572 6520 646f allation were do │ │ │ │ │ +00008cf0: 6e65 2073 6570 6172 6174 656c 7920 6f6e ne separately on │ │ │ │ │ +00008d00: 2065 6163 680a 686f 7374 2e0a 0a20 2020 each.host... │ │ │ │ │ +00008d10: 5468 6520 474e 5520 4275 696c 6420 5379 The GNU Build Sy │ │ │ │ │ +00008d20: 7374 656d 2061 6c73 6f20 7375 7070 6f72 stem also suppor │ │ │ │ │ +00008d30: 7473 206e 6574 776f 726b 6564 2073 6574 ts networked set │ │ │ │ │ +00008d40: 7570 7320 7768 6572 6520 7061 7274 206f ups where part o │ │ │ │ │ +00008d50: 6620 7468 650a 696e 7374 616c 6c65 6420 f the.installed │ │ │ │ │ +00008d60: 6669 6c65 7320 7368 6f75 6c64 2062 6520 files should be │ │ │ │ │ +00008d70: 7368 6172 6564 2061 6d6f 6e67 7374 206d shared amongst m │ │ │ │ │ +00008d80: 756c 7469 706c 6520 686f 7374 732e 2020 ultiple hosts. │ │ │ │ │ +00008d90: 4974 2064 6f65 7320 736f 2062 790a 6469 It does so by.di │ │ │ │ │ +00008da0: 7374 696e 6775 6973 6869 6e67 2061 7263 stinguishing arc │ │ │ │ │ +00008db0: 6869 7465 6374 7572 652d 6465 7065 6e64 hitecture-depend │ │ │ │ │ +00008dc0: 656e 7420 6669 6c65 7320 6672 6f6d 0a61 ent files from.a │ │ │ │ │ +00008dd0: 7263 6869 7465 6374 7572 652d 696e 6465 rchitecture-inde │ │ │ │ │ +00008de0: 7065 6e64 656e 7420 6669 6c65 732c 2061 pendent files, a │ │ │ │ │ +00008df0: 6e64 2070 726f 7669 6469 6e67 2074 776f nd providing two │ │ │ │ │ +00008e00: 2027 4d61 6b65 6669 6c65 2720 7461 7267 'Makefile' targ │ │ │ │ │ +00008e10: 6574 7320 746f 0a69 6e73 7461 6c6c 2065 ets to.install e │ │ │ │ │ +00008e20: 6163 6820 6f66 2074 6865 7365 2063 6c61 ach of these cla │ │ │ │ │ +00008e30: 7373 6573 206f 6620 6669 6c65 732e 0a0a sses of files... │ │ │ │ │ +00008e40: 2020 2054 6865 7365 2074 6172 6765 7473 These targets │ │ │ │ │ +00008e50: 2061 7265 2027 696e 7374 616c 6c2d 6578 are 'install-ex │ │ │ │ │ +00008e60: 6563 2720 666f 7220 6172 6368 6974 6563 ec' for architec │ │ │ │ │ +00008e70: 7475 7265 2d64 6570 656e 6465 6e74 2066 ture-dependent f │ │ │ │ │ +00008e80: 696c 6573 2061 6e64 0a27 696e 7374 616c iles and.'instal │ │ │ │ │ +00008e90: 6c2d 6461 7461 2720 666f 7220 6172 6368 l-data' for arch │ │ │ │ │ +00008ea0: 6974 6563 7475 7265 2d69 6e64 6570 656e itecture-indepen │ │ │ │ │ +00008eb0: 6465 6e74 2066 696c 6573 2e20 2054 6865 dent files. The │ │ │ │ │ +00008ec0: 2063 6f6d 6d61 6e64 2077 6520 7573 6564 command we used │ │ │ │ │ +00008ed0: 0a75 7020 746f 206e 6f77 2c20 276d 616b .up to now, 'mak │ │ │ │ │ +00008ee0: 6520 696e 7374 616c 6c27 2c20 6361 6e20 e install', can │ │ │ │ │ +00008ef0: 6265 2074 686f 7567 6874 206f 6620 6173 be thought of as │ │ │ │ │ +00008f00: 2061 2073 686f 7274 6861 6e64 2066 6f72 a shorthand for │ │ │ │ │ +00008f10: 2027 6d61 6b65 0a69 6e73 7461 6c6c 2d65 'make.install-e │ │ │ │ │ +00008f20: 7865 6320 696e 7374 616c 6c2d 6461 7461 xec install-data │ │ │ │ │ +00008f30: 272e 0a0a 2020 2046 726f 6d20 7468 6520 '... From the │ │ │ │ │ +00008f40: 474e 5520 4275 696c 6420 5379 7374 656d GNU Build System │ │ │ │ │ +00008f50: 2070 6f69 6e74 206f 6620 7669 6577 2c20 point of view, │ │ │ │ │ +00008f60: 7468 6520 6469 7374 696e 6374 696f 6e20 the distinction │ │ │ │ │ +00008f70: 6265 7477 6565 6e0a 6172 6368 6974 6563 between.architec │ │ │ │ │ +00008f80: 7475 7265 2d64 6570 656e 6465 6e74 2066 ture-dependent f │ │ │ │ │ +00008f90: 696c 6573 2061 6e64 2061 7263 6869 7465 iles and archite │ │ │ │ │ +00008fa0: 6374 7572 652d 696e 6465 7065 6e64 656e cture-independen │ │ │ │ │ +00008fb0: 7420 6669 6c65 7320 6973 2062 6173 6564 t files is based │ │ │ │ │ +00008fc0: 0a65 7863 6c75 7369 7665 6c79 206f 6e20 .exclusively on │ │ │ │ │ +00008fd0: 7468 6520 6469 7265 6374 6f72 7920 7661 the directory va │ │ │ │ │ +00008fe0: 7269 6162 6c65 2075 7365 6420 746f 2073 riable used to s │ │ │ │ │ +00008ff0: 7065 6369 6679 2074 6865 6972 2069 6e73 pecify their ins │ │ │ │ │ +00009000: 7461 6c6c 6174 696f 6e0a 6465 7374 696e tallation.destin │ │ │ │ │ +00009010: 6174 696f 6e2e 2020 496e 2074 6865 206c ation. In the l │ │ │ │ │ +00009020: 6973 7420 6f66 2064 6972 6563 746f 7279 ist of directory │ │ │ │ │ +00009030: 2076 6172 6961 626c 6573 2077 6520 7072 variables we pr │ │ │ │ │ +00009040: 6f76 6964 6564 2065 6172 6c69 6572 0a28 ovided earlier.( │ │ │ │ │ +00009050: 2a6e 6f74 6520 5374 616e 6461 7264 2044 *note Standard D │ │ │ │ │ +00009060: 6972 6563 746f 7279 2056 6172 6961 626c irectory Variabl │ │ │ │ │ +00009070: 6573 3a3a 292c 2061 6c6c 2074 6865 2076 es::), all the v │ │ │ │ │ +00009080: 6172 6961 626c 6573 2062 6173 6564 206f ariables based o │ │ │ │ │ +00009090: 6e0a 4558 4543 2d50 5245 4649 5820 6465 n.EXEC-PREFIX de │ │ │ │ │ +000090a0: 7369 676e 6174 6520 6172 6368 6974 6563 signate architec │ │ │ │ │ +000090b0: 7475 7265 2d64 6570 656e 6465 6e74 2064 ture-dependent d │ │ │ │ │ +000090c0: 6972 6563 746f 7269 6573 2077 686f 7365 irectories whose │ │ │ │ │ +000090d0: 2066 696c 6573 0a77 696c 6c20 6265 2069 files.will be i │ │ │ │ │ +000090e0: 6e73 7461 6c6c 6564 2062 7920 276d 616b nstalled by 'mak │ │ │ │ │ +000090f0: 6520 696e 7374 616c 6c2d 6578 6563 272e e install-exec'. │ │ │ │ │ +00009100: 2020 5468 6520 6f74 6865 7273 2064 6573 The others des │ │ │ │ │ +00009110: 6967 6e61 7465 0a61 7263 6869 7465 6374 ignate.architect │ │ │ │ │ +00009120: 7572 652d 696e 6465 7065 6e64 656e 7420 ure-independent │ │ │ │ │ +00009130: 6469 7265 6374 6f72 6965 7320 616e 6420 directories and │ │ │ │ │ +00009140: 7769 6c6c 2073 6572 7665 2066 696c 6573 will serve files │ │ │ │ │ +00009150: 2069 6e73 7461 6c6c 6564 2062 790a 276d installed by.'m │ │ │ │ │ +00009160: 616b 6520 696e 7374 616c 6c2d 6461 7461 ake install-data │ │ │ │ │ +00009170: 272e 2020 2a4e 6f74 6520 5468 6520 5477 '. *Note The Tw │ │ │ │ │ +00009180: 6f20 5061 7274 7320 6f66 2049 6e73 7461 o Parts of Insta │ │ │ │ │ +00009190: 6c6c 3a3a 2c20 666f 7220 6d6f 7265 0a64 ll::, for more.d │ │ │ │ │ +000091a0: 6574 6169 6c73 2e0a 0a20 2020 4865 7265 etails... Here │ │ │ │ │ +000091b0: 2069 7320 686f 7720 7765 2063 6f75 6c64 is how we could │ │ │ │ │ +000091c0: 2072 6576 6973 6974 206f 7572 2074 776f revisit our two │ │ │ │ │ +000091d0: 2d68 6f73 7420 696e 7374 616c 6c61 7469 -host installati │ │ │ │ │ +000091e0: 6f6e 2065 7861 6d70 6c65 2c0a 6173 7375 on example,.assu │ │ │ │ │ +000091f0: 6d69 6e67 2074 6861 7420 2831 2920 7765 ming that (1) we │ │ │ │ │ +00009200: 2077 616e 7420 746f 2069 6e73 7461 6c6c want to install │ │ │ │ │ +00009210: 2074 6865 2070 6163 6b61 6765 2064 6972 the package dir │ │ │ │ │ +00009220: 6563 746c 7920 696e 2027 2f75 7372 272c ectly in '/usr', │ │ │ │ │ +00009230: 2061 6e64 0a28 3229 2074 6865 2064 6972 and.(2) the dir │ │ │ │ │ +00009240: 6563 746f 7279 2027 2f75 7372 2f73 6861 ectory '/usr/sha │ │ │ │ │ +00009250: 7265 2720 6973 2073 6861 7265 6420 6279 re' is shared by │ │ │ │ │ +00009260: 2074 6865 2074 776f 2068 6f73 7473 2e0a the two hosts.. │ │ │ │ │ +00009270: 0a20 2020 4f6e 2074 6865 2066 6972 7374 . On the first │ │ │ │ │ +00009280: 2068 6f73 7420 7765 2077 6f75 6c64 2072 host we would r │ │ │ │ │ +00009290: 756e 0a20 2020 2020 5b48 4f53 5431 5d20 un. [HOST1] │ │ │ │ │ +000092a0: 7e20 2520 6d6b 6469 7220 2f74 6d70 2f61 ~ % mkdir /tmp/a │ │ │ │ │ +000092b0: 6d68 2026 2620 6364 202f 746d 702f 616d mh && cd /tmp/am │ │ │ │ │ +000092c0: 680a 2020 2020 205b 484f 5354 315d 202f h. [HOST1] / │ │ │ │ │ +000092d0: 746d 702f 616d 6820 2520 2f6e 6673 2f73 tmp/amh % /nfs/s │ │ │ │ │ +000092e0: 7263 2f61 6d68 656c 6c6f 2d31 2e30 2f63 rc/amhello-1.0/c │ │ │ │ │ +000092f0: 6f6e 6669 6775 7265 202d 2d70 7265 6669 onfigure --prefi │ │ │ │ │ +00009300: 7820 2f75 7372 0a20 2020 2020 2e2e 2e0a x /usr. .... │ │ │ │ │ +00009310: 2020 2020 205b 484f 5354 315d 202f 746d [HOST1] /tm │ │ │ │ │ +00009320: 702f 616d 6820 2520 6d61 6b65 2026 2620 p/amh % make && │ │ │ │ │ +00009330: 7375 646f 206d 616b 6520 696e 7374 616c sudo make instal │ │ │ │ │ +00009340: 6c0a 2020 2020 202e 2e2e 0a0a 2020 204f l. ..... O │ │ │ │ │ +00009350: 6e20 7468 6520 7365 636f 6e64 2068 6f73 n the second hos │ │ │ │ │ +00009360: 742c 2068 6f77 6576 6572 2c20 7765 206e t, however, we n │ │ │ │ │ +00009370: 6565 6420 6f6e 6c79 2069 6e73 7461 6c6c eed only install │ │ │ │ │ +00009380: 2074 6865 0a61 7263 6869 7465 6374 7572 the.architectur │ │ │ │ │ +00009390: 652d 7370 6563 6966 6963 2066 696c 6573 e-specific files │ │ │ │ │ +000093a0: 2e0a 2020 2020 205b 484f 5354 325d 207e .. [HOST2] ~ │ │ │ │ │ +000093b0: 2025 206d 6b64 6972 202f 746d 702f 616d % mkdir /tmp/am │ │ │ │ │ +000093c0: 6820 2626 2063 6420 2f74 6d70 2f61 6d68 h && cd /tmp/amh │ │ │ │ │ +000093d0: 0a20 2020 2020 5b48 4f53 5432 5d20 2f74 . [HOST2] /t │ │ │ │ │ +000093e0: 6d70 2f61 6d68 2025 202f 6e66 732f 7372 mp/amh % /nfs/sr │ │ │ │ │ +000093f0: 632f 616d 6865 6c6c 6f2d 312e 302f 636f c/amhello-1.0/co │ │ │ │ │ +00009400: 6e66 6967 7572 6520 2d2d 7072 6566 6978 nfigure --prefix │ │ │ │ │ +00009410: 202f 7573 720a 2020 2020 202e 2e2e 0a20 /usr. .... │ │ │ │ │ +00009420: 2020 2020 5b48 4f53 5432 5d20 2f74 6d70 [HOST2] /tmp │ │ │ │ │ +00009430: 2f61 6d68 2025 206d 616b 6520 2626 2073 /amh % make && s │ │ │ │ │ +00009440: 7564 6f20 6d61 6b65 2069 6e73 7461 6c6c udo make install │ │ │ │ │ +00009450: 2d65 7865 630a 2020 2020 202e 2e2e 0a0a -exec. ..... │ │ │ │ │ +00009460: 2020 2049 6e20 7061 636b 6167 6573 2074 In packages t │ │ │ │ │ +00009470: 6861 7420 6861 7665 2069 6e73 7461 6c6c hat have install │ │ │ │ │ +00009480: 6174 696f 6e20 6368 6563 6b73 2c20 6974 ation checks, it │ │ │ │ │ +00009490: 2077 6f75 6c64 206d 616b 6520 7365 6e73 would make sens │ │ │ │ │ +000094a0: 6520 746f 2072 756e 0a27 6d61 6b65 2069 e to run.'make i │ │ │ │ │ +000094b0: 6e73 7461 6c6c 6368 6563 6b27 2028 2a6e nstallcheck' (*n │ │ │ │ │ +000094c0: 6f74 6520 4261 7369 6320 496e 7374 616c ote Basic Instal │ │ │ │ │ +000094d0: 6c61 7469 6f6e 3a3a 2920 746f 2076 6572 lation::) to ver │ │ │ │ │ +000094e0: 6966 7920 7468 6174 2074 6865 0a70 6163 ify that the.pac │ │ │ │ │ +000094f0: 6b61 6765 2077 6f72 6b73 2063 6f72 7265 kage works corre │ │ │ │ │ +00009500: 6374 6c79 2064 6573 7069 7465 2074 6865 ctly despite the │ │ │ │ │ +00009510: 2061 7070 6172 656e 7420 7061 7274 6961 apparent partia │ │ │ │ │ +00009520: 6c20 696e 7374 616c 6c61 7469 6f6e 2e0a l installation.. │ │ │ │ │ +00009530: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +00009540: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +00009550: 6465 3a20 4372 6f73 732d 436f 6d70 696c de: Cross-Compil │ │ │ │ │ +00009560: 6174 696f 6e2c 2020 4e65 7874 3a20 5265 ation, Next: Re │ │ │ │ │ +00009570: 6e61 6d69 6e67 2c20 2050 7265 763a 2054 naming, Prev: T │ │ │ │ │ +00009580: 776f 2d50 6172 7420 496e 7374 616c 6c2c wo-Part Install, │ │ │ │ │ +00009590: 2020 5570 3a20 5573 6520 4361 7365 730a Up: Use Cases. │ │ │ │ │ +000095a0: 0a32 2e32 2e38 2043 726f 7373 2d43 6f6d .2.2.8 Cross-Com │ │ │ │ │ +000095b0: 7069 6c61 7469 6f6e 0a2d 2d2d 2d2d 2d2d pilation.------- │ │ │ │ │ +000095c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +000095d0: 0a0a 546f 2022 6372 6f73 732d 636f 6d70 ..To "cross-comp │ │ │ │ │ +000095e0: 696c 6522 2069 7320 746f 2062 7569 6c64 ile" is to build │ │ │ │ │ +000095f0: 206f 6e20 6f6e 6520 706c 6174 666f 726d on one platform │ │ │ │ │ +00009600: 2061 2062 696e 6172 7920 7468 6174 2077 a binary that w │ │ │ │ │ +00009610: 696c 6c20 7275 6e20 6f6e 0a61 6e6f 7468 ill run on.anoth │ │ │ │ │ +00009620: 6572 2070 6c61 7466 6f72 6d2e 2020 5768 er platform. Wh │ │ │ │ │ +00009630: 656e 2073 7065 616b 696e 6720 6f66 2063 en speaking of c │ │ │ │ │ +00009640: 726f 7373 2d63 6f6d 7069 6c61 7469 6f6e ross-compilation │ │ │ │ │ +00009650: 2c20 6974 2069 7320 696d 706f 7274 616e , it is importan │ │ │ │ │ +00009660: 740a 746f 2064 6973 7469 6e67 7569 7368 t.to distinguish │ │ │ │ │ +00009670: 2062 6574 7765 656e 2074 6865 2022 6275 between the "bu │ │ │ │ │ +00009680: 696c 6420 706c 6174 666f 726d 2220 6f6e ild platform" on │ │ │ │ │ +00009690: 2077 6869 6368 2074 6865 2063 6f6d 7069 which the compi │ │ │ │ │ +000096a0: 6c61 7469 6f6e 2069 730a 7065 7266 6f72 lation is.perfor │ │ │ │ │ +000096b0: 6d65 642c 2061 6e64 2074 6865 2022 686f med, and the "ho │ │ │ │ │ +000096c0: 7374 2070 6c61 7466 6f72 6d22 206f 6e20 st platform" on │ │ │ │ │ +000096d0: 7768 6963 6820 7468 6520 7265 7375 6c74 which the result │ │ │ │ │ +000096e0: 696e 6720 6578 6563 7574 6162 6c65 2069 ing executable i │ │ │ │ │ +000096f0: 730a 6578 7065 6374 6564 2074 6f20 7275 s.expected to ru │ │ │ │ │ +00009700: 6e2e 2020 5468 6520 666f 6c6c 6f77 696e n. The followin │ │ │ │ │ +00009710: 6720 2763 6f6e 6669 6775 7265 2720 6f70 g 'configure' op │ │ │ │ │ +00009720: 7469 6f6e 7320 6172 6520 7573 6564 2074 tions are used t │ │ │ │ │ +00009730: 6f20 7370 6563 6966 790a 6561 6368 206f o specify.each o │ │ │ │ │ +00009740: 6620 7468 656d 3a0a 0a27 2d2d 6275 696c f them:..'--buil │ │ │ │ │ +00009750: 643d 4255 494c 4427 0a20 2020 2020 5468 d=BUILD'. Th │ │ │ │ │ +00009760: 6520 7379 7374 656d 206f 6e20 7768 6963 e system on whic │ │ │ │ │ +00009770: 6820 7468 6520 7061 636b 6167 6520 6973 h the package is │ │ │ │ │ +00009780: 2062 7569 6c74 2e0a 272d 2d68 6f73 743d built..'--host= │ │ │ │ │ +00009790: 484f 5354 270a 2020 2020 2054 6865 2073 HOST'. The s │ │ │ │ │ +000097a0: 7973 7465 6d20 7768 6572 6520 6275 696c ystem where buil │ │ │ │ │ +000097b0: 7420 7072 6f67 7261 6d73 2061 6e64 206c t programs and l │ │ │ │ │ +000097c0: 6962 7261 7269 6573 2077 696c 6c20 7275 ibraries will ru │ │ │ │ │ +000097d0: 6e2e 0a0a 2020 2057 6865 6e20 7468 6520 n... When the │ │ │ │ │ +000097e0: 272d 2d68 6f73 7427 2069 7320 7573 6564 '--host' is used │ │ │ │ │ +000097f0: 2c20 2763 6f6e 6669 6775 7265 2720 7769 , 'configure' wi │ │ │ │ │ +00009800: 6c6c 2073 6561 7263 6820 666f 7220 7468 ll search for th │ │ │ │ │ +00009810: 650a 6372 6f73 732d 636f 6d70 696c 696e e.cross-compilin │ │ │ │ │ +00009820: 6720 7375 6974 6520 666f 7220 7468 6973 g suite for this │ │ │ │ │ +00009830: 2070 6c61 7466 6f72 6d2e 2020 4372 6f73 platform. Cros │ │ │ │ │ +00009840: 732d 636f 6d70 696c 6174 696f 6e20 746f s-compilation to │ │ │ │ │ +00009850: 6f6c 730a 636f 6d6d 6f6e 6c79 2068 6176 ols.commonly hav │ │ │ │ │ +00009860: 6520 7468 6569 7220 7461 7267 6574 2061 e their target a │ │ │ │ │ +00009870: 7263 6869 7465 6374 7572 6520 6173 2070 rchitecture as p │ │ │ │ │ +00009880: 7265 6669 7820 6f66 2074 6865 6972 206e refix of their n │ │ │ │ │ +00009890: 616d 652e 2020 466f 720a 696e 7374 616e ame. For.instan │ │ │ │ │ +000098a0: 6365 206d 7920 6372 6f73 732d 636f 6d70 ce my cross-comp │ │ │ │ │ +000098b0: 696c 6572 2066 6f72 204d 696e 4757 3332 iler for MinGW32 │ │ │ │ │ +000098c0: 2068 6173 2069 7473 2062 696e 6172 6965 has its binarie │ │ │ │ │ +000098d0: 7320 6361 6c6c 6564 0a27 6935 3836 2d6d s called.'i586-m │ │ │ │ │ +000098e0: 696e 6777 3332 6d73 7663 2d67 6363 272c ingw32msvc-gcc', │ │ │ │ │ +000098f0: 2027 6935 3836 2d6d 696e 6777 3332 6d73 'i586-mingw32ms │ │ │ │ │ +00009900: 7663 2d6c 6427 2c20 2769 3538 362d 6d69 vc-ld', 'i586-mi │ │ │ │ │ +00009910: 6e67 7733 326d 7376 632d 6173 272c 0a65 ngw32msvc-as',.e │ │ │ │ │ +00009920: 7463 2e0a 0a20 2020 4865 7265 2069 7320 tc... Here is │ │ │ │ │ +00009930: 686f 7720 7765 2063 6f75 6c64 2062 7569 how we could bui │ │ │ │ │ +00009940: 6c64 2027 616d 6865 6c6c 6f2d 312e 3027 ld 'amhello-1.0' │ │ │ │ │ +00009950: 2066 6f72 2027 6935 3836 2d6d 696e 6777 for 'i586-mingw │ │ │ │ │ +00009960: 3332 6d73 7663 2720 6f6e 2061 0a47 4e55 32msvc' on a.GNU │ │ │ │ │ +00009970: 2f4c 696e 7578 2050 432e 0a0a 2020 2020 /Linux PC... │ │ │ │ │ +00009980: 207e 2f61 6d68 656c 6c6f 2d31 2e30 2025 ~/amhello-1.0 % │ │ │ │ │ +00009990: 202e 2f63 6f6e 6669 6775 7265 202d 2d62 ./configure --b │ │ │ │ │ +000099a0: 7569 6c64 2069 3638 362d 7063 2d6c 696e uild i686-pc-lin │ │ │ │ │ +000099b0: 7578 2d67 6e75 202d 2d68 6f73 7420 6935 ux-gnu --host i5 │ │ │ │ │ +000099c0: 3836 2d6d 696e 6777 3332 6d73 7663 0a20 86-mingw32msvc. │ │ │ │ │ +000099d0: 2020 2020 6368 6563 6b69 6e67 2066 6f72 checking for │ │ │ │ │ +000099e0: 2061 2042 5344 2d63 6f6d 7061 7469 626c a BSD-compatibl │ │ │ │ │ +000099f0: 6520 696e 7374 616c 6c2e 2e2e 202f 7573 e install... /us │ │ │ │ │ +00009a00: 722f 6269 6e2f 696e 7374 616c 6c20 2d63 r/bin/install -c │ │ │ │ │ +00009a10: 0a20 2020 2020 6368 6563 6b69 6e67 2077 . checking w │ │ │ │ │ +00009a20: 6865 7468 6572 2062 7569 6c64 2065 6e76 hether build env │ │ │ │ │ +00009a30: 6972 6f6e 6d65 6e74 2069 7320 7361 6e65 ironment is sane │ │ │ │ │ +00009a40: 2e2e 2e20 7965 730a 2020 2020 2063 6865 ... yes. che │ │ │ │ │ +00009a50: 636b 696e 6720 666f 7220 6761 776b 2e2e cking for gawk.. │ │ │ │ │ +00009a60: 2e20 6761 776b 0a20 2020 2020 6368 6563 . gawk. chec │ │ │ │ │ +00009a70: 6b69 6e67 2077 6865 7468 6572 206d 616b king whether mak │ │ │ │ │ +00009a80: 6520 7365 7473 2024 284d 414b 4529 2e2e e sets $(MAKE).. │ │ │ │ │ +00009a90: 2e20 7965 730a 2020 2020 2063 6865 636b . yes. check │ │ │ │ │ +00009aa0: 696e 6720 666f 7220 6935 3836 2d6d 696e ing for i586-min │ │ │ │ │ +00009ab0: 6777 3332 6d73 7663 2d73 7472 6970 2e2e gw32msvc-strip.. │ │ │ │ │ +00009ac0: 2e20 6935 3836 2d6d 696e 6777 3332 6d73 . i586-mingw32ms │ │ │ │ │ +00009ad0: 7663 2d73 7472 6970 0a20 2020 2020 6368 vc-strip. ch │ │ │ │ │ +00009ae0: 6563 6b69 6e67 2066 6f72 2069 3538 362d ecking for i586- │ │ │ │ │ +00009af0: 6d69 6e67 7733 326d 7376 632d 6763 632e mingw32msvc-gcc. │ │ │ │ │ +00009b00: 2e2e 2069 3538 362d 6d69 6e67 7733 326d .. i586-mingw32m │ │ │ │ │ +00009b10: 7376 632d 6763 630a 2020 2020 2063 6865 svc-gcc. che │ │ │ │ │ +00009b20: 636b 696e 6720 666f 7220 4320 636f 6d70 cking for C comp │ │ │ │ │ +00009b30: 696c 6572 2064 6566 6175 6c74 206f 7574 iler default out │ │ │ │ │ +00009b40: 7075 7420 6669 6c65 206e 616d 652e 2e2e put file name... │ │ │ │ │ +00009b50: 2061 2e65 7865 0a20 2020 2020 6368 6563 a.exe. chec │ │ │ │ │ +00009b60: 6b69 6e67 2077 6865 7468 6572 2074 6865 king whether the │ │ │ │ │ +00009b70: 2043 2063 6f6d 7069 6c65 7220 776f 726b C compiler work │ │ │ │ │ +00009b80: 732e 2e2e 2079 6573 0a20 2020 2020 6368 s... yes. ch │ │ │ │ │ +00009b90: 6563 6b69 6e67 2077 6865 7468 6572 2077 ecking whether w │ │ │ │ │ +00009ba0: 6520 6172 6520 6372 6f73 7320 636f 6d70 e are cross comp │ │ │ │ │ +00009bb0: 696c 696e 672e 2e2e 2079 6573 0a20 2020 iling... yes. │ │ │ │ │ +00009bc0: 2020 6368 6563 6b69 6e67 2066 6f72 2073 checking for s │ │ │ │ │ +00009bd0: 7566 6669 7820 6f66 2065 7865 6375 7461 uffix of executa │ │ │ │ │ +00009be0: 626c 6573 2e2e 2e20 2e65 7865 0a20 2020 bles... .exe. │ │ │ │ │ +00009bf0: 2020 6368 6563 6b69 6e67 2066 6f72 2073 checking for s │ │ │ │ │ +00009c00: 7566 6669 7820 6f66 206f 626a 6563 7420 uffix of object │ │ │ │ │ +00009c10: 6669 6c65 732e 2e2e 206f 0a20 2020 2020 files... o. │ │ │ │ │ +00009c20: 6368 6563 6b69 6e67 2077 6865 7468 6572 checking whether │ │ │ │ │ +00009c30: 2077 6520 6172 6520 7573 696e 6720 7468 we are using th │ │ │ │ │ +00009c40: 6520 474e 5520 4320 636f 6d70 696c 6572 e GNU C compiler │ │ │ │ │ +00009c50: 2e2e 2e20 7965 730a 2020 2020 2063 6865 ... yes. che │ │ │ │ │ +00009c60: 636b 696e 6720 7768 6574 6865 7220 6935 cking whether i5 │ │ │ │ │ +00009c70: 3836 2d6d 696e 6777 3332 6d73 7663 2d67 86-mingw32msvc-g │ │ │ │ │ +00009c80: 6363 2061 6363 6570 7473 202d 672e 2e2e cc accepts -g... │ │ │ │ │ +00009c90: 2079 6573 0a20 2020 2020 6368 6563 6b69 yes. checki │ │ │ │ │ +00009ca0: 6e67 2066 6f72 2069 3538 362d 6d69 6e67 ng for i586-ming │ │ │ │ │ +00009cb0: 7733 326d 7376 632d 6763 6320 6f70 7469 w32msvc-gcc opti │ │ │ │ │ +00009cc0: 6f6e 2074 6f20 6163 6365 7074 2041 4e53 on to accept ANS │ │ │ │ │ +00009cd0: 4920 432e 2e2e 0a20 2020 2020 2e2e 2e0a I C.... .... │ │ │ │ │ +00009ce0: 2020 2020 207e 2f61 6d68 656c 6c6f 2d31 ~/amhello-1 │ │ │ │ │ +00009cf0: 2e30 2025 206d 616b 650a 2020 2020 202e .0 % make. . │ │ │ │ │ +00009d00: 2e2e 0a20 2020 2020 7e2f 616d 6865 6c6c ... ~/amhell │ │ │ │ │ +00009d10: 6f2d 312e 3020 2520 6364 2073 7263 3b20 o-1.0 % cd src; │ │ │ │ │ +00009d20: 6669 6c65 2068 656c 6c6f 2e65 7865 0a20 file hello.exe. │ │ │ │ │ +00009d30: 2020 2020 6865 6c6c 6f2e 6578 653a 204d hello.exe: M │ │ │ │ │ +00009d40: 5320 5769 6e64 6f77 7320 5045 2033 322d S Windows PE 32- │ │ │ │ │ +00009d50: 6269 7420 496e 7465 6c20 3830 3338 3620 bit Intel 80386 │ │ │ │ │ +00009d60: 636f 6e73 6f6c 6520 6578 6563 7574 6162 console executab │ │ │ │ │ +00009d70: 6c65 206e 6f74 2072 656c 6f63 6174 6162 le not relocatab │ │ │ │ │ +00009d80: 6c65 0a0a 2020 2054 6865 2027 2d2d 686f le.. The '--ho │ │ │ │ │ +00009d90: 7374 2720 616e 6420 272d 2d62 7569 6c64 st' and '--build │ │ │ │ │ +00009da0: 2720 6f70 7469 6f6e 7320 6172 6520 7573 ' options are us │ │ │ │ │ +00009db0: 7561 6c6c 7920 616c 6c20 7765 206e 6565 ually all we nee │ │ │ │ │ +00009dc0: 6420 666f 720a 6372 6f73 732d 636f 6d70 d for.cross-comp │ │ │ │ │ +00009dd0: 696c 696e 672e 2020 5468 6520 6f6e 6c79 iling. The only │ │ │ │ │ +00009de0: 2065 7863 6570 7469 6f6e 2069 7320 6966 exception is if │ │ │ │ │ +00009df0: 2074 6865 2070 6163 6b61 6765 2062 6569 the package bei │ │ │ │ │ +00009e00: 6e67 2062 7569 6c74 2069 730a 6974 7365 ng built is.itse │ │ │ │ │ +00009e10: 6c66 2061 2063 726f 7373 2d63 6f6d 7069 lf a cross-compi │ │ │ │ │ +00009e20: 6c65 723a 2077 6520 6e65 6564 2061 2074 ler: we need a t │ │ │ │ │ +00009e30: 6869 7264 206f 7074 696f 6e20 746f 2073 hird option to s │ │ │ │ │ +00009e40: 7065 6369 6679 2069 7473 2074 6172 6765 pecify its targe │ │ │ │ │ +00009e50: 740a 6172 6368 6974 6563 7475 7265 2e0a t.architecture.. │ │ │ │ │ +00009e60: 0a27 2d2d 7461 7267 6574 3d54 4152 4745 .'--target=TARGE │ │ │ │ │ +00009e70: 5427 0a20 2020 2020 5768 656e 2062 7569 T'. When bui │ │ │ │ │ +00009e80: 6c64 696e 6720 636f 6d70 696c 6572 2074 lding compiler t │ │ │ │ │ +00009e90: 6f6f 6c73 3a20 7468 6520 7379 7374 656d ools: the system │ │ │ │ │ +00009ea0: 2066 6f72 2077 6869 6368 2074 6865 2074 for which the t │ │ │ │ │ +00009eb0: 6f6f 6c73 2077 696c 6c0a 2020 2020 2063 ools will. c │ │ │ │ │ +00009ec0: 7265 6174 6520 6f75 7470 7574 2e0a 0a20 reate output... │ │ │ │ │ +00009ed0: 2020 466f 7220 696e 7374 616e 6365 2077 For instance w │ │ │ │ │ +00009ee0: 6865 6e20 696e 7374 616c 6c69 6e67 2047 hen installing G │ │ │ │ │ +00009ef0: 4343 2c20 7468 6520 474e 5520 436f 6d70 CC, the GNU Comp │ │ │ │ │ +00009f00: 696c 6572 2043 6f6c 6c65 6374 696f 6e2c iler Collection, │ │ │ │ │ +00009f10: 2077 6520 6361 6e0a 7573 6520 272d 2d74 we can.use '--t │ │ │ │ │ +00009f20: 6172 6765 743d 5441 5247 4554 2720 746f arget=TARGET' to │ │ │ │ │ +00009f30: 2073 7065 6369 6679 2074 6861 7420 7765 specify that we │ │ │ │ │ +00009f40: 2077 616e 7420 746f 2062 7569 6c64 2047 want to build G │ │ │ │ │ +00009f50: 4343 2061 7320 610a 6372 6f73 732d 636f CC as a.cross-co │ │ │ │ │ +00009f60: 6d70 696c 6572 2066 6f72 2054 4152 4745 mpiler for TARGE │ │ │ │ │ +00009f70: 542e 2020 4d69 7869 6e67 2027 2d2d 6275 T. Mixing '--bu │ │ │ │ │ +00009f80: 696c 6427 2061 6e64 2027 2d2d 7461 7267 ild' and '--targ │ │ │ │ │ +00009f90: 6574 272c 2077 6520 6361 6e0a 6163 7475 et', we can.actu │ │ │ │ │ +00009fa0: 616c 6c79 2063 726f 7373 2d63 6f6d 7069 ally cross-compi │ │ │ │ │ +00009fb0: 6c65 2061 2063 726f 7373 2d63 6f6d 7069 le a cross-compi │ │ │ │ │ +00009fc0: 6c65 723b 2073 7563 6820 6120 7468 7265 ler; such a thre │ │ │ │ │ +00009fd0: 652d 7761 790a 6372 6f73 732d 636f 6d70 e-way.cross-comp │ │ │ │ │ +00009fe0: 696c 6174 696f 6e20 6973 206b 6e6f 776e ilation is known │ │ │ │ │ +00009ff0: 2061 7320 6120 2243 616e 6164 6961 6e20 as a "Canadian │ │ │ │ │ +0000a000: 6372 6f73 7322 2e0a 0a20 2020 2a4e 6f74 cross"... *Not │ │ │ │ │ +0000a010: 6520 5370 6563 6966 7969 6e67 2074 6865 e Specifying the │ │ │ │ │ +0000a020: 2053 7973 7465 6d20 5479 7065 3a20 2861 System Type: (a │ │ │ │ │ +0000a030: 7574 6f63 6f6e 6629 5370 6563 6966 7969 utoconf)Specifyi │ │ │ │ │ +0000a040: 6e67 204e 616d 6573 2c20 666f 720a 6d6f ng Names, for.mo │ │ │ │ │ +0000a050: 7265 2069 6e66 6f72 6d61 7469 6f6e 2061 re information a │ │ │ │ │ +0000a060: 626f 7574 2074 6865 7365 2027 636f 6e66 bout these 'conf │ │ │ │ │ +0000a070: 6967 7572 6527 206f 7074 696f 6e73 2e0a igure' options.. │ │ │ │ │ +0000a080: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +0000a090: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +0000a0a0: 6465 3a20 5265 6e61 6d69 6e67 2c20 204e de: Renaming, N │ │ │ │ │ +0000a0b0: 6578 743a 2044 4553 5444 4952 2c20 2050 ext: DESTDIR, P │ │ │ │ │ +0000a0c0: 7265 763a 2043 726f 7373 2d43 6f6d 7069 rev: Cross-Compi │ │ │ │ │ +0000a0d0: 6c61 7469 6f6e 2c20 2055 703a 2055 7365 lation, Up: Use │ │ │ │ │ +0000a0e0: 2043 6173 6573 0a0a 322e 322e 3920 5265 Cases..2.2.9 Re │ │ │ │ │ +0000a0f0: 6e61 6d69 6e67 2050 726f 6772 616d 7320 naming Programs │ │ │ │ │ +0000a100: 6174 2049 6e73 7461 6c6c 2054 696d 650a at Install Time. │ │ │ │ │ 0000a110: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a120: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000a130: 2d2d 2d2d 2d0a 0a54 6865 2047 4e55 2042 -----..The GNU B │ │ │ │ │ -0000a140: 7569 6c64 2053 7973 7465 6d20 7072 6f76 uild System prov │ │ │ │ │ -0000a150: 6964 6573 206d 6561 6e73 2074 6f20 6175 ides means to au │ │ │ │ │ -0000a160: 746f 6d61 7469 6361 6c6c 7920 7265 6e61 tomatically rena │ │ │ │ │ -0000a170: 6d65 2065 7865 6375 7461 626c 6573 0a61 me executables.a │ │ │ │ │ -0000a180: 6e64 206d 616e 7061 6765 7320 6265 666f nd manpages befo │ │ │ │ │ -0000a190: 7265 2074 6865 7920 6172 6520 696e 7374 re they are inst │ │ │ │ │ -0000a1a0: 616c 6c65 6420 282a 6e6f 7465 204d 616e alled (*note Man │ │ │ │ │ -0000a1b0: 2050 6167 6573 3a3a 292e 2020 5468 6973 Pages::). This │ │ │ │ │ -0000a1c0: 2069 730a 6573 7065 6369 616c 6c79 2063 is.especially c │ │ │ │ │ -0000a1d0: 6f6e 7665 6e69 656e 7420 7768 656e 2069 onvenient when i │ │ │ │ │ -0000a1e0: 6e73 7461 6c6c 696e 6720 6120 474e 5520 nstalling a GNU │ │ │ │ │ -0000a1f0: 7061 636b 6167 6520 6f6e 2061 2073 7973 package on a sys │ │ │ │ │ -0000a200: 7465 6d20 7468 6174 0a61 6c72 6561 6479 tem that.already │ │ │ │ │ -0000a210: 2068 6173 2061 2070 726f 7072 6965 7461 has a proprieta │ │ │ │ │ -0000a220: 7279 2069 6d70 6c65 6d65 6e74 6174 696f ry implementatio │ │ │ │ │ -0000a230: 6e20 796f 7520 646f 206e 6f74 2077 616e n you do not wan │ │ │ │ │ -0000a240: 7420 746f 206f 7665 7277 7269 7465 2e0a t to overwrite.. │ │ │ │ │ -0000a250: 466f 7220 696e 7374 616e 6365 2c20 796f For instance, yo │ │ │ │ │ -0000a260: 7520 6d61 7920 7761 6e74 2074 6f20 696e u may want to in │ │ │ │ │ -0000a270: 7374 616c 6c20 474e 5520 2774 6172 2720 stall GNU 'tar' │ │ │ │ │ -0000a280: 6173 2027 6774 6172 2720 736f 2079 6f75 as 'gtar' so you │ │ │ │ │ -0000a290: 2063 616e 0a64 6973 7469 6e67 7569 7368 can.distinguish │ │ │ │ │ -0000a2a0: 2069 7420 6672 6f6d 2079 6f75 7220 7665 it from your ve │ │ │ │ │ -0000a2b0: 6e64 6f72 2773 2027 7461 7227 2e0a 0a20 ndor's 'tar'... │ │ │ │ │ -0000a2c0: 2020 5468 6973 2063 616e 2062 6520 646f This can be do │ │ │ │ │ -0000a2d0: 6e65 2075 7369 6e67 206f 6e65 206f 6620 ne using one of │ │ │ │ │ -0000a2e0: 7468 6573 6520 7468 7265 6520 2763 6f6e these three 'con │ │ │ │ │ -0000a2f0: 6669 6775 7265 2720 6f70 7469 6f6e 732e figure' options. │ │ │ │ │ -0000a300: 0a0a 272d 2d70 726f 6772 616d 2d70 7265 ..'--program-pre │ │ │ │ │ -0000a310: 6669 783d 5052 4546 4958 270a 2020 2020 fix=PREFIX'. │ │ │ │ │ -0000a320: 2050 7265 7065 6e64 2050 5245 4649 5820 Prepend PREFIX │ │ │ │ │ -0000a330: 746f 2069 6e73 7461 6c6c 6564 2070 726f to installed pro │ │ │ │ │ -0000a340: 6772 616d 206e 616d 6573 2e0a 272d 2d70 gram names..'--p │ │ │ │ │ -0000a350: 726f 6772 616d 2d73 7566 6669 783d 5355 rogram-suffix=SU │ │ │ │ │ -0000a360: 4646 4958 270a 2020 2020 2041 7070 656e FFIX'. Appen │ │ │ │ │ -0000a370: 6420 5355 4646 4958 2074 6f20 696e 7374 d SUFFIX to inst │ │ │ │ │ -0000a380: 616c 6c65 6420 7072 6f67 7261 6d20 6e61 alled program na │ │ │ │ │ -0000a390: 6d65 732e 0a27 2d2d 7072 6f67 7261 6d2d mes..'--program- │ │ │ │ │ -0000a3a0: 7472 616e 7366 6f72 6d2d 6e61 6d65 3d50 transform-name=P │ │ │ │ │ -0000a3b0: 524f 4752 414d 270a 2020 2020 2052 756e ROGRAM'. Run │ │ │ │ │ -0000a3c0: 2027 7365 6420 5052 4f47 5241 4d27 206f 'sed PROGRAM' o │ │ │ │ │ -0000a3d0: 6e20 696e 7374 616c 6c65 6420 7072 6f67 n installed prog │ │ │ │ │ -0000a3e0: 7261 6d20 6e61 6d65 732e 0a0a 2020 2054 ram names... T │ │ │ │ │ -0000a3f0: 6865 2066 6f6c 6c6f 7769 6e67 2063 6f6d he following com │ │ │ │ │ -0000a400: 6d61 6e64 7320 776f 756c 6420 696e 7374 mands would inst │ │ │ │ │ -0000a410: 616c 6c20 2768 656c 6c6f 2720 6173 0a27 all 'hello' as.' │ │ │ │ │ -0000a420: 2f75 7372 2f6c 6f63 616c 2f62 696e 2f74 /usr/local/bin/t │ │ │ │ │ -0000a430: 6573 742d 6865 6c6c 6f27 2c20 666f 7220 est-hello', for │ │ │ │ │ -0000a440: 696e 7374 616e 6365 2e0a 0a20 2020 2020 instance... │ │ │ │ │ -0000a450: 7e2f 616d 6865 6c6c 6f2d 312e 3020 2520 ~/amhello-1.0 % │ │ │ │ │ -0000a460: 2e2f 636f 6e66 6967 7572 6520 2d2d 7072 ./configure --pr │ │ │ │ │ -0000a470: 6f67 7261 6d2d 7072 6566 6978 2074 6573 ogram-prefix tes │ │ │ │ │ -0000a480: 742d 0a20 2020 2020 2e2e 2e0a 2020 2020 t-. .... │ │ │ │ │ -0000a490: 207e 2f61 6d68 656c 6c6f 2d31 2e30 2025 ~/amhello-1.0 % │ │ │ │ │ -0000a4a0: 206d 616b 650a 2020 2020 202e 2e2e 0a20 make. .... │ │ │ │ │ -0000a4b0: 2020 2020 7e2f 616d 6865 6c6c 6f2d 312e ~/amhello-1. │ │ │ │ │ -0000a4c0: 3020 2520 7375 646f 206d 616b 6520 696e 0 % sudo make in │ │ │ │ │ -0000a4d0: 7374 616c 6c0a 2020 2020 202e 2e2e 0a0a stall. ..... │ │ │ │ │ -0000a4e0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -0000a4f0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -0000a500: 653a 2044 4553 5444 4952 2c20 204e 6578 e: DESTDIR, Nex │ │ │ │ │ -0000a510: 743a 2050 7265 7061 7269 6e67 2044 6973 t: Preparing Dis │ │ │ │ │ -0000a520: 7472 6962 7574 696f 6e73 2c20 2050 7265 tributions, Pre │ │ │ │ │ -0000a530: 763a 2052 656e 616d 696e 672c 2020 5570 v: Renaming, Up │ │ │ │ │ -0000a540: 3a20 5573 6520 4361 7365 730a 0a32 2e32 : Use Cases..2.2 │ │ │ │ │ -0000a550: 2e31 3020 4275 696c 6469 6e67 2042 696e .10 Building Bin │ │ │ │ │ -0000a560: 6172 7920 5061 636b 6167 6573 2055 7369 ary Packages Usi │ │ │ │ │ -0000a570: 6e67 2044 4553 5444 4952 0a2d 2d2d 2d2d ng DESTDIR.----- │ │ │ │ │ +0000a130: 2d2d 2d2d 2d2d 2d0a 0a54 6865 2047 4e55 -------..The GNU │ │ │ │ │ +0000a140: 2042 7569 6c64 2053 7973 7465 6d20 7072 Build System pr │ │ │ │ │ +0000a150: 6f76 6964 6573 206d 6561 6e73 2074 6f20 ovides means to │ │ │ │ │ +0000a160: 6175 746f 6d61 7469 6361 6c6c 7920 7265 automatically re │ │ │ │ │ +0000a170: 6e61 6d65 2065 7865 6375 7461 626c 6573 name executables │ │ │ │ │ +0000a180: 0a61 6e64 206d 616e 7061 6765 7320 6265 .and manpages be │ │ │ │ │ +0000a190: 666f 7265 2074 6865 7920 6172 6520 696e fore they are in │ │ │ │ │ +0000a1a0: 7374 616c 6c65 6420 282a 6e6f 7465 204d stalled (*note M │ │ │ │ │ +0000a1b0: 616e 2050 6167 6573 3a3a 292e 2020 5468 an Pages::). Th │ │ │ │ │ +0000a1c0: 6973 2069 730a 6573 7065 6369 616c 6c79 is is.especially │ │ │ │ │ +0000a1d0: 2063 6f6e 7665 6e69 656e 7420 7768 656e convenient when │ │ │ │ │ +0000a1e0: 2069 6e73 7461 6c6c 696e 6720 6120 474e installing a GN │ │ │ │ │ +0000a1f0: 5520 7061 636b 6167 6520 6f6e 2061 2073 U package on a s │ │ │ │ │ +0000a200: 7973 7465 6d20 7468 6174 0a61 6c72 6561 ystem that.alrea │ │ │ │ │ +0000a210: 6479 2068 6173 2061 2070 726f 7072 6965 dy has a proprie │ │ │ │ │ +0000a220: 7461 7279 2069 6d70 6c65 6d65 6e74 6174 tary implementat │ │ │ │ │ +0000a230: 696f 6e20 796f 7520 646f 206e 6f74 2077 ion you do not w │ │ │ │ │ +0000a240: 616e 7420 746f 206f 7665 7277 7269 7465 ant to overwrite │ │ │ │ │ +0000a250: 2e0a 466f 7220 696e 7374 616e 6365 2c20 ..For instance, │ │ │ │ │ +0000a260: 796f 7520 6d61 7920 7761 6e74 2074 6f20 you may want to │ │ │ │ │ +0000a270: 696e 7374 616c 6c20 474e 5520 2774 6172 install GNU 'tar │ │ │ │ │ +0000a280: 2720 6173 2027 6774 6172 2720 736f 2079 ' as 'gtar' so y │ │ │ │ │ +0000a290: 6f75 2063 616e 0a64 6973 7469 6e67 7569 ou can.distingui │ │ │ │ │ +0000a2a0: 7368 2069 7420 6672 6f6d 2079 6f75 7220 sh it from your │ │ │ │ │ +0000a2b0: 7665 6e64 6f72 2773 2027 7461 7227 2e0a vendor's 'tar'.. │ │ │ │ │ +0000a2c0: 0a20 2020 5468 6973 2063 616e 2062 6520 . This can be │ │ │ │ │ +0000a2d0: 646f 6e65 2075 7369 6e67 206f 6e65 206f done using one o │ │ │ │ │ +0000a2e0: 6620 7468 6573 6520 7468 7265 6520 2763 f these three 'c │ │ │ │ │ +0000a2f0: 6f6e 6669 6775 7265 2720 6f70 7469 6f6e onfigure' option │ │ │ │ │ +0000a300: 732e 0a0a 272d 2d70 726f 6772 616d 2d70 s...'--program-p │ │ │ │ │ +0000a310: 7265 6669 783d 5052 4546 4958 270a 2020 refix=PREFIX'. │ │ │ │ │ +0000a320: 2020 2050 7265 7065 6e64 2050 5245 4649 Prepend PREFI │ │ │ │ │ +0000a330: 5820 746f 2069 6e73 7461 6c6c 6564 2070 X to installed p │ │ │ │ │ +0000a340: 726f 6772 616d 206e 616d 6573 2e0a 272d rogram names..'- │ │ │ │ │ +0000a350: 2d70 726f 6772 616d 2d73 7566 6669 783d -program-suffix= │ │ │ │ │ +0000a360: 5355 4646 4958 270a 2020 2020 2041 7070 SUFFIX'. App │ │ │ │ │ +0000a370: 656e 6420 5355 4646 4958 2074 6f20 696e end SUFFIX to in │ │ │ │ │ +0000a380: 7374 616c 6c65 6420 7072 6f67 7261 6d20 stalled program │ │ │ │ │ +0000a390: 6e61 6d65 732e 0a27 2d2d 7072 6f67 7261 names..'--progra │ │ │ │ │ +0000a3a0: 6d2d 7472 616e 7366 6f72 6d2d 6e61 6d65 m-transform-name │ │ │ │ │ +0000a3b0: 3d50 524f 4752 414d 270a 2020 2020 2052 =PROGRAM'. R │ │ │ │ │ +0000a3c0: 756e 2027 7365 6420 5052 4f47 5241 4d27 un 'sed PROGRAM' │ │ │ │ │ +0000a3d0: 206f 6e20 696e 7374 616c 6c65 6420 7072 on installed pr │ │ │ │ │ +0000a3e0: 6f67 7261 6d20 6e61 6d65 732e 0a0a 2020 ogram names... │ │ │ │ │ +0000a3f0: 2054 6865 2066 6f6c 6c6f 7769 6e67 2063 The following c │ │ │ │ │ +0000a400: 6f6d 6d61 6e64 7320 776f 756c 6420 696e ommands would in │ │ │ │ │ +0000a410: 7374 616c 6c20 2768 656c 6c6f 2720 6173 stall 'hello' as │ │ │ │ │ +0000a420: 0a27 2f75 7372 2f6c 6f63 616c 2f62 696e .'/usr/local/bin │ │ │ │ │ +0000a430: 2f74 6573 742d 6865 6c6c 6f27 2c20 666f /test-hello', fo │ │ │ │ │ +0000a440: 7220 696e 7374 616e 6365 2e0a 0a20 2020 r instance... │ │ │ │ │ +0000a450: 2020 7e2f 616d 6865 6c6c 6f2d 312e 3020 ~/amhello-1.0 │ │ │ │ │ +0000a460: 2520 2e2f 636f 6e66 6967 7572 6520 2d2d % ./configure -- │ │ │ │ │ +0000a470: 7072 6f67 7261 6d2d 7072 6566 6978 2074 program-prefix t │ │ │ │ │ +0000a480: 6573 742d 0a20 2020 2020 2e2e 2e0a 2020 est-. .... │ │ │ │ │ +0000a490: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ +0000a4a0: 2025 206d 616b 650a 2020 2020 202e 2e2e % make. ... │ │ │ │ │ +0000a4b0: 0a20 2020 2020 7e2f 616d 6865 6c6c 6f2d . ~/amhello- │ │ │ │ │ +0000a4c0: 312e 3020 2520 7375 646f 206d 616b 6520 1.0 % sudo make │ │ │ │ │ +0000a4d0: 696e 7374 616c 6c0a 2020 2020 202e 2e2e install. ... │ │ │ │ │ +0000a4e0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +0000a4f0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +0000a500: 6f64 653a 2044 4553 5444 4952 2c20 204e ode: DESTDIR, N │ │ │ │ │ +0000a510: 6578 743a 2050 7265 7061 7269 6e67 2044 ext: Preparing D │ │ │ │ │ +0000a520: 6973 7472 6962 7574 696f 6e73 2c20 2050 istributions, P │ │ │ │ │ +0000a530: 7265 763a 2052 656e 616d 696e 672c 2020 rev: Renaming, │ │ │ │ │ +0000a540: 5570 3a20 5573 6520 4361 7365 730a 0a32 Up: Use Cases..2 │ │ │ │ │ +0000a550: 2e32 2e31 3020 4275 696c 6469 6e67 2042 .2.10 Building B │ │ │ │ │ +0000a560: 696e 6172 7920 5061 636b 6167 6573 2055 inary Packages U │ │ │ │ │ +0000a570: 7369 6e67 2044 4553 5444 4952 0a2d 2d2d sing DESTDIR.--- │ │ │ │ │ 0000a580: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a590: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000a5a0: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 474e --------..The GN │ │ │ │ │ -0000a5b0: 5520 4275 696c 6420 5379 7374 656d 2773 U Build System's │ │ │ │ │ -0000a5c0: 2027 6d61 6b65 2069 6e73 7461 6c6c 2720 'make install' │ │ │ │ │ -0000a5d0: 616e 6420 276d 616b 6520 756e 696e 7374 and 'make uninst │ │ │ │ │ -0000a5e0: 616c 6c27 2069 6e74 6572 6661 6365 0a64 all' interface.d │ │ │ │ │ -0000a5f0: 6f65 7320 6e6f 7420 6578 6163 746c 7920 oes not exactly │ │ │ │ │ -0000a600: 6669 7420 7468 6520 6e65 6564 7320 6f66 fit the needs of │ │ │ │ │ -0000a610: 2061 2073 7973 7465 6d20 6164 6d69 6e69 a system admini │ │ │ │ │ -0000a620: 7374 7261 746f 7220 7768 6f20 6861 7320 strator who has │ │ │ │ │ -0000a630: 746f 0a64 6570 6c6f 7920 616e 6420 7570 to.deploy and up │ │ │ │ │ -0000a640: 6772 6164 6520 7061 636b 6167 6573 206f grade packages o │ │ │ │ │ -0000a650: 6e20 6c6f 7473 206f 6620 686f 7374 732e n lots of hosts. │ │ │ │ │ -0000a660: 2020 496e 206f 7468 6572 2077 6f72 6473 In other words │ │ │ │ │ -0000a670: 2c20 7468 6520 474e 550a 4275 696c 6420 , the GNU.Build │ │ │ │ │ -0000a680: 5379 7374 656d 2064 6f65 7320 6e6f 7420 System does not │ │ │ │ │ -0000a690: 7265 706c 6163 6520 6120 7061 636b 6167 replace a packag │ │ │ │ │ -0000a6a0: 6520 6d61 6e61 6765 722e 0a0a 2020 2053 e manager... S │ │ │ │ │ -0000a6b0: 7563 6820 7061 636b 6167 6520 6d61 6e61 uch package mana │ │ │ │ │ -0000a6c0: 6765 7273 2075 7375 616c 6c79 206e 6565 gers usually nee │ │ │ │ │ -0000a6d0: 6420 746f 206b 6e6f 7720 7768 6963 6820 d to know which │ │ │ │ │ -0000a6e0: 6669 6c65 7320 6861 7665 2062 6565 6e0a files have been. │ │ │ │ │ -0000a6f0: 696e 7374 616c 6c65 6420 6279 2061 2070 installed by a p │ │ │ │ │ -0000a700: 6163 6b61 6765 2c20 736f 2061 206d 6572 ackage, so a mer │ │ │ │ │ -0000a710: 6520 276d 616b 6520 696e 7374 616c 6c27 e 'make install' │ │ │ │ │ -0000a720: 2069 7320 696e 6170 7072 6f70 7269 6174 is inappropriat │ │ │ │ │ -0000a730: 652e 0a0a 2020 2054 6865 2027 4445 5354 e... The 'DEST │ │ │ │ │ -0000a740: 4449 5227 2076 6172 6961 626c 6520 6361 DIR' variable ca │ │ │ │ │ -0000a750: 6e20 6265 2075 7365 6420 746f 2070 6572 n be used to per │ │ │ │ │ -0000a760: 666f 726d 2061 2073 7461 6765 6420 696e form a staged in │ │ │ │ │ -0000a770: 7374 616c 6c61 7469 6f6e 2e0a 5468 6520 stallation..The │ │ │ │ │ -0000a780: 7061 636b 6167 6520 7368 6f75 6c64 2062 package should b │ │ │ │ │ -0000a790: 6520 636f 6e66 6967 7572 6564 2061 7320 e configured as │ │ │ │ │ -0000a7a0: 6966 2069 7420 7761 7320 676f 696e 6720 if it was going │ │ │ │ │ -0000a7b0: 746f 2062 6520 696e 7374 616c 6c65 6420 to be installed │ │ │ │ │ -0000a7c0: 696e 0a69 7473 2066 696e 616c 206c 6f63 in.its final loc │ │ │ │ │ -0000a7d0: 6174 696f 6e20 2865 2e67 2e2c 2027 2d2d ation (e.g., '-- │ │ │ │ │ -0000a7e0: 7072 6566 6978 202f 7573 7227 292c 2062 prefix /usr'), b │ │ │ │ │ -0000a7f0: 7574 2077 6865 6e20 7275 6e6e 696e 6720 ut when running │ │ │ │ │ -0000a800: 276d 616b 650a 696e 7374 616c 6c27 2c20 'make.install', │ │ │ │ │ -0000a810: 7468 6520 2744 4553 5444 4952 2720 7368 the 'DESTDIR' sh │ │ │ │ │ -0000a820: 6f75 6c64 2062 6520 7365 7420 746f 2074 ould be set to t │ │ │ │ │ -0000a830: 6865 2061 6273 6f6c 7574 6520 6e61 6d65 he absolute name │ │ │ │ │ -0000a840: 206f 6620 610a 6469 7265 6374 6f72 7920 of a.directory │ │ │ │ │ -0000a850: 696e 746f 2077 6869 6368 2074 6865 2069 into which the i │ │ │ │ │ -0000a860: 6e73 7461 6c6c 6174 696f 6e20 7769 6c6c nstallation will │ │ │ │ │ -0000a870: 2062 6520 6469 7665 7274 6564 2e20 2046 be diverted. F │ │ │ │ │ -0000a880: 726f 6d20 7468 6973 0a64 6972 6563 746f rom this.directo │ │ │ │ │ -0000a890: 7279 2069 7420 6973 2065 6173 7920 746f ry it is easy to │ │ │ │ │ -0000a8a0: 2072 6576 6965 7720 7768 6963 6820 6669 review which fi │ │ │ │ │ -0000a8b0: 6c65 7320 6172 6520 6265 696e 6720 696e les are being in │ │ │ │ │ -0000a8c0: 7374 616c 6c65 6420 7768 6572 652c 0a61 stalled where,.a │ │ │ │ │ -0000a8d0: 6e64 2066 696e 616c 6c79 2063 6f70 7920 nd finally copy │ │ │ │ │ -0000a8e0: 7468 656d 2074 6f20 7468 6569 7220 6669 them to their fi │ │ │ │ │ -0000a8f0: 6e61 6c20 6c6f 6361 7469 6f6e 2062 7920 nal location by │ │ │ │ │ -0000a900: 736f 6d65 206d 6561 6e73 2e0a 0a20 2020 some means... │ │ │ │ │ -0000a910: 466f 7220 696e 7374 616e 6365 2068 6572 For instance her │ │ │ │ │ -0000a920: 6520 6973 2068 6f77 2077 6520 636f 756c e is how we coul │ │ │ │ │ -0000a930: 6420 6372 6561 7465 2061 2062 696e 6172 d create a binar │ │ │ │ │ -0000a940: 7920 7061 636b 6167 6520 636f 6e74 6169 y package contai │ │ │ │ │ -0000a950: 6e69 6e67 0a61 2073 6e61 7073 686f 7420 ning.a snapshot │ │ │ │ │ -0000a960: 6f66 2061 6c6c 2074 6865 2066 696c 6573 of all the files │ │ │ │ │ -0000a970: 2074 6f20 6265 2069 6e73 7461 6c6c 6564 to be installed │ │ │ │ │ -0000a980: 2e0a 0a20 2020 2020 7e2f 616d 6865 6c6c ... ~/amhell │ │ │ │ │ -0000a990: 6f2d 312e 3020 2520 2e2f 636f 6e66 6967 o-1.0 % ./config │ │ │ │ │ -0000a9a0: 7572 6520 2d2d 7072 6566 6978 202f 7573 ure --prefix /us │ │ │ │ │ -0000a9b0: 720a 2020 2020 202e 2e2e 0a20 2020 2020 r. .... │ │ │ │ │ -0000a9c0: 7e2f 616d 6865 6c6c 6f2d 312e 3020 2520 ~/amhello-1.0 % │ │ │ │ │ -0000a9d0: 6d61 6b65 0a20 2020 2020 2e2e 2e0a 2020 make. .... │ │ │ │ │ -0000a9e0: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ -0000a9f0: 2025 206d 616b 6520 4445 5354 4449 523d % make DESTDIR= │ │ │ │ │ -0000aa00: 2448 4f4d 452f 696e 7374 2069 6e73 7461 $HOME/inst insta │ │ │ │ │ -0000aa10: 6c6c 0a20 2020 2020 2e2e 2e0a 2020 2020 ll. .... │ │ │ │ │ -0000aa20: 207e 2f61 6d68 656c 6c6f 2d31 2e30 2025 ~/amhello-1.0 % │ │ │ │ │ -0000aa30: 2063 6420 7e2f 696e 7374 0a20 2020 2020 cd ~/inst. │ │ │ │ │ -0000aa40: 7e2f 696e 7374 2025 2066 696e 6420 2e20 ~/inst % find . │ │ │ │ │ -0000aa50: 2d74 7970 6520 6620 2d70 7269 6e74 203e -type f -print > │ │ │ │ │ -0000aa60: 202e 2e2f 6669 6c65 732e 6c73 740a 2020 ../files.lst. │ │ │ │ │ -0000aa70: 2020 207e 2f69 6e73 7420 2520 7461 7220 ~/inst % tar │ │ │ │ │ -0000aa80: 7a63 7666 207e 2f61 6d68 656c 6c6f 2d31 zcvf ~/amhello-1 │ │ │ │ │ -0000aa90: 2e30 2d69 3638 362e 7461 722e 677a 2060 .0-i686.tar.gz ` │ │ │ │ │ -0000aaa0: 6361 7420 2e2e 2f66 696c 6573 2e6c 7374 cat ../files.lst │ │ │ │ │ -0000aab0: 600a 2020 2020 202e 2f75 7372 2f62 696e `. ./usr/bin │ │ │ │ │ -0000aac0: 2f68 656c 6c6f 0a20 2020 2020 2e2f 7573 /hello. ./us │ │ │ │ │ -0000aad0: 722f 7368 6172 652f 646f 632f 616d 6865 r/share/doc/amhe │ │ │ │ │ -0000aae0: 6c6c 6f2f 5245 4144 4d45 0a0a 2020 2041 llo/README.. A │ │ │ │ │ -0000aaf0: 6674 6572 2074 6869 7320 6578 616d 706c fter this exampl │ │ │ │ │ -0000ab00: 652c 2027 616d 6865 6c6c 6f2d 312e 302d e, 'amhello-1.0- │ │ │ │ │ -0000ab10: 6936 3836 2e74 6172 2e67 7a27 2069 7320 i686.tar.gz' is │ │ │ │ │ -0000ab20: 7265 6164 7920 746f 2062 650a 756e 636f ready to be.unco │ │ │ │ │ -0000ab30: 6d70 7265 7373 6564 2069 6e20 272f 2720 mpressed in '/' │ │ │ │ │ -0000ab40: 6f6e 206d 616e 7920 686f 7374 732e 2020 on many hosts. │ │ │ │ │ -0000ab50: 2855 7369 6e67 2027 6063 6174 202e 2e2f (Using '`cat ../ │ │ │ │ │ -0000ab60: 6669 6c65 732e 6c73 7460 2720 696e 7374 files.lst`' inst │ │ │ │ │ -0000ab70: 6561 640a 6f66 2027 2e27 2061 7320 6172 ead.of '.' as ar │ │ │ │ │ -0000ab80: 6775 6d65 6e74 2066 6f72 2027 7461 7227 gument for 'tar' │ │ │ │ │ -0000ab90: 2061 766f 6964 7320 656e 7472 6965 7320 avoids entries │ │ │ │ │ -0000aba0: 666f 7220 6561 6368 2073 7562 6469 7265 for each subdire │ │ │ │ │ -0000abb0: 6374 6f72 7920 696e 2074 6865 0a61 7263 ctory in the.arc │ │ │ │ │ -0000abc0: 6869 7665 3a20 7765 2077 6f75 6c64 206e hive: we would n │ │ │ │ │ -0000abd0: 6f74 206c 696b 6520 2774 6172 2720 746f ot like 'tar' to │ │ │ │ │ -0000abe0: 2072 6573 746f 7265 2074 6865 206d 6f64 restore the mod │ │ │ │ │ -0000abf0: 6966 6963 6174 696f 6e20 7469 6d65 206f ification time o │ │ │ │ │ -0000ac00: 660a 272f 272c 2027 2f75 7372 2f27 2c20 f.'/', '/usr/', │ │ │ │ │ -0000ac10: 6574 632e 290a 0a20 2020 4e6f 7465 2074 etc.).. Note t │ │ │ │ │ -0000ac20: 6861 7420 7768 656e 2062 7569 6c64 696e hat when buildin │ │ │ │ │ -0000ac30: 6720 7061 636b 6167 6573 2066 6f72 2073 g packages for s │ │ │ │ │ -0000ac40: 6576 6572 616c 2061 7263 6869 7465 6374 everal architect │ │ │ │ │ -0000ac50: 7572 6573 2c20 6974 206d 6967 6874 0a62 ures, it might.b │ │ │ │ │ -0000ac60: 6520 636f 6e76 656e 6965 6e74 2074 6f20 e convenient to │ │ │ │ │ -0000ac70: 7573 6520 276d 616b 6520 696e 7374 616c use 'make instal │ │ │ │ │ -0000ac80: 6c2d 6461 7461 2720 616e 6420 276d 616b l-data' and 'mak │ │ │ │ │ -0000ac90: 6520 696e 7374 616c 6c2d 6578 6563 2720 e install-exec' │ │ │ │ │ -0000aca0: 282a 6e6f 7465 0a54 776f 2d50 6172 7420 (*note.Two-Part │ │ │ │ │ -0000acb0: 496e 7374 616c 6c3a 3a29 2074 6f20 6761 Install::) to ga │ │ │ │ │ -0000acc0: 7468 6572 2061 7263 6869 7465 6374 7572 ther architectur │ │ │ │ │ -0000acd0: 652d 696e 6465 7065 6e64 656e 7420 6669 e-independent fi │ │ │ │ │ -0000ace0: 6c65 7320 696e 2061 2073 696e 676c 650a les in a single. │ │ │ │ │ -0000acf0: 7061 636b 6167 652e 0a0a 2020 202a 4e6f package... *No │ │ │ │ │ -0000ad00: 7465 2049 6e73 7461 6c6c 3a3a 2c20 666f te Install::, fo │ │ │ │ │ -0000ad10: 7220 6d6f 7265 2069 6e66 6f72 6d61 7469 r more informati │ │ │ │ │ -0000ad20: 6f6e 2e0a 0a1f 0a46 696c 653a 2061 7574 on.....File: aut │ │ │ │ │ -0000ad30: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -0000ad40: 2020 4e6f 6465 3a20 5072 6570 6172 696e Node: Preparin │ │ │ │ │ -0000ad50: 6720 4469 7374 7269 6275 7469 6f6e 732c g Distributions, │ │ │ │ │ -0000ad60: 2020 4e65 7874 3a20 4465 7065 6e64 656e Next: Dependen │ │ │ │ │ -0000ad70: 6379 2054 7261 636b 696e 672c 2020 5072 cy Tracking, Pr │ │ │ │ │ -0000ad80: 6576 3a20 4445 5354 4449 522c 2020 5570 ev: DESTDIR, Up │ │ │ │ │ -0000ad90: 3a20 5573 6520 4361 7365 730a 0a32 2e32 : Use Cases..2.2 │ │ │ │ │ -0000ada0: 2e31 3120 5072 6570 6172 696e 6720 4469 .11 Preparing Di │ │ │ │ │ -0000adb0: 7374 7269 6275 7469 6f6e 730a 2d2d 2d2d stributions.---- │ │ │ │ │ +0000a5a0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 ----------..The │ │ │ │ │ +0000a5b0: 474e 5520 4275 696c 6420 5379 7374 656d GNU Build System │ │ │ │ │ +0000a5c0: 2773 2027 6d61 6b65 2069 6e73 7461 6c6c 's 'make install │ │ │ │ │ +0000a5d0: 2720 616e 6420 276d 616b 6520 756e 696e ' and 'make unin │ │ │ │ │ +0000a5e0: 7374 616c 6c27 2069 6e74 6572 6661 6365 stall' interface │ │ │ │ │ +0000a5f0: 0a64 6f65 7320 6e6f 7420 6578 6163 746c .does not exactl │ │ │ │ │ +0000a600: 7920 6669 7420 7468 6520 6e65 6564 7320 y fit the needs │ │ │ │ │ +0000a610: 6f66 2061 2073 7973 7465 6d20 6164 6d69 of a system admi │ │ │ │ │ +0000a620: 6e69 7374 7261 746f 7220 7768 6f20 6861 nistrator who ha │ │ │ │ │ +0000a630: 7320 746f 0a64 6570 6c6f 7920 616e 6420 s to.deploy and │ │ │ │ │ +0000a640: 7570 6772 6164 6520 7061 636b 6167 6573 upgrade packages │ │ │ │ │ +0000a650: 206f 6e20 6c6f 7473 206f 6620 686f 7374 on lots of host │ │ │ │ │ +0000a660: 732e 2020 496e 206f 7468 6572 2077 6f72 s. In other wor │ │ │ │ │ +0000a670: 6473 2c20 7468 6520 474e 550a 4275 696c ds, the GNU.Buil │ │ │ │ │ +0000a680: 6420 5379 7374 656d 2064 6f65 7320 6e6f d System does no │ │ │ │ │ +0000a690: 7420 7265 706c 6163 6520 6120 7061 636b t replace a pack │ │ │ │ │ +0000a6a0: 6167 6520 6d61 6e61 6765 722e 0a0a 2020 age manager... │ │ │ │ │ +0000a6b0: 2053 7563 6820 7061 636b 6167 6520 6d61 Such package ma │ │ │ │ │ +0000a6c0: 6e61 6765 7273 2075 7375 616c 6c79 206e nagers usually n │ │ │ │ │ +0000a6d0: 6565 6420 746f 206b 6e6f 7720 7768 6963 eed to know whic │ │ │ │ │ +0000a6e0: 6820 6669 6c65 7320 6861 7665 2062 6565 h files have bee │ │ │ │ │ +0000a6f0: 6e0a 696e 7374 616c 6c65 6420 6279 2061 n.installed by a │ │ │ │ │ +0000a700: 2070 6163 6b61 6765 2c20 736f 2061 206d package, so a m │ │ │ │ │ +0000a710: 6572 6520 276d 616b 6520 696e 7374 616c ere 'make instal │ │ │ │ │ +0000a720: 6c27 2069 7320 696e 6170 7072 6f70 7269 l' is inappropri │ │ │ │ │ +0000a730: 6174 652e 0a0a 2020 2054 6865 2027 4445 ate... The 'DE │ │ │ │ │ +0000a740: 5354 4449 5227 2076 6172 6961 626c 6520 STDIR' variable │ │ │ │ │ +0000a750: 6361 6e20 6265 2075 7365 6420 746f 2070 can be used to p │ │ │ │ │ +0000a760: 6572 666f 726d 2061 2073 7461 6765 6420 erform a staged │ │ │ │ │ +0000a770: 696e 7374 616c 6c61 7469 6f6e 2e0a 5468 installation..Th │ │ │ │ │ +0000a780: 6520 7061 636b 6167 6520 7368 6f75 6c64 e package should │ │ │ │ │ +0000a790: 2062 6520 636f 6e66 6967 7572 6564 2061 be configured a │ │ │ │ │ +0000a7a0: 7320 6966 2069 7420 7761 7320 676f 696e s if it was goin │ │ │ │ │ +0000a7b0: 6720 746f 2062 6520 696e 7374 616c 6c65 g to be installe │ │ │ │ │ +0000a7c0: 6420 696e 0a69 7473 2066 696e 616c 206c d in.its final l │ │ │ │ │ +0000a7d0: 6f63 6174 696f 6e20 2865 2e67 2e2c 2027 ocation (e.g., ' │ │ │ │ │ +0000a7e0: 2d2d 7072 6566 6978 202f 7573 7227 292c --prefix /usr'), │ │ │ │ │ +0000a7f0: 2062 7574 2077 6865 6e20 7275 6e6e 696e but when runnin │ │ │ │ │ +0000a800: 6720 276d 616b 650a 696e 7374 616c 6c27 g 'make.install' │ │ │ │ │ +0000a810: 2c20 7468 6520 2744 4553 5444 4952 2720 , the 'DESTDIR' │ │ │ │ │ +0000a820: 7368 6f75 6c64 2062 6520 7365 7420 746f should be set to │ │ │ │ │ +0000a830: 2074 6865 2061 6273 6f6c 7574 6520 6e61 the absolute na │ │ │ │ │ +0000a840: 6d65 206f 6620 610a 6469 7265 6374 6f72 me of a.director │ │ │ │ │ +0000a850: 7920 696e 746f 2077 6869 6368 2074 6865 y into which the │ │ │ │ │ +0000a860: 2069 6e73 7461 6c6c 6174 696f 6e20 7769 installation wi │ │ │ │ │ +0000a870: 6c6c 2062 6520 6469 7665 7274 6564 2e20 ll be diverted. │ │ │ │ │ +0000a880: 2046 726f 6d20 7468 6973 0a64 6972 6563 From this.direc │ │ │ │ │ +0000a890: 746f 7279 2069 7420 6973 2065 6173 7920 tory it is easy │ │ │ │ │ +0000a8a0: 746f 2072 6576 6965 7720 7768 6963 6820 to review which │ │ │ │ │ +0000a8b0: 6669 6c65 7320 6172 6520 6265 696e 6720 files are being │ │ │ │ │ +0000a8c0: 696e 7374 616c 6c65 6420 7768 6572 652c installed where, │ │ │ │ │ +0000a8d0: 0a61 6e64 2066 696e 616c 6c79 2063 6f70 .and finally cop │ │ │ │ │ +0000a8e0: 7920 7468 656d 2074 6f20 7468 6569 7220 y them to their │ │ │ │ │ +0000a8f0: 6669 6e61 6c20 6c6f 6361 7469 6f6e 2062 final location b │ │ │ │ │ +0000a900: 7920 736f 6d65 206d 6561 6e73 2e0a 0a20 y some means... │ │ │ │ │ +0000a910: 2020 466f 7220 696e 7374 616e 6365 2068 For instance h │ │ │ │ │ +0000a920: 6572 6520 6973 2068 6f77 2077 6520 636f ere is how we co │ │ │ │ │ +0000a930: 756c 6420 6372 6561 7465 2061 2062 696e uld create a bin │ │ │ │ │ +0000a940: 6172 7920 7061 636b 6167 6520 636f 6e74 ary package cont │ │ │ │ │ +0000a950: 6169 6e69 6e67 0a61 2073 6e61 7073 686f aining.a snapsho │ │ │ │ │ +0000a960: 7420 6f66 2061 6c6c 2074 6865 2066 696c t of all the fil │ │ │ │ │ +0000a970: 6573 2074 6f20 6265 2069 6e73 7461 6c6c es to be install │ │ │ │ │ +0000a980: 6564 2e0a 0a20 2020 2020 7e2f 616d 6865 ed... ~/amhe │ │ │ │ │ +0000a990: 6c6c 6f2d 312e 3020 2520 2e2f 636f 6e66 llo-1.0 % ./conf │ │ │ │ │ +0000a9a0: 6967 7572 6520 2d2d 7072 6566 6978 202f igure --prefix / │ │ │ │ │ +0000a9b0: 7573 720a 2020 2020 202e 2e2e 0a20 2020 usr. .... │ │ │ │ │ +0000a9c0: 2020 7e2f 616d 6865 6c6c 6f2d 312e 3020 ~/amhello-1.0 │ │ │ │ │ +0000a9d0: 2520 6d61 6b65 0a20 2020 2020 2e2e 2e0a % make. .... │ │ │ │ │ +0000a9e0: 2020 2020 207e 2f61 6d68 656c 6c6f 2d31 ~/amhello-1 │ │ │ │ │ +0000a9f0: 2e30 2025 206d 616b 6520 4445 5354 4449 .0 % make DESTDI │ │ │ │ │ +0000aa00: 523d 2448 4f4d 452f 696e 7374 2069 6e73 R=$HOME/inst ins │ │ │ │ │ +0000aa10: 7461 6c6c 0a20 2020 2020 2e2e 2e0a 2020 tall. .... │ │ │ │ │ +0000aa20: 2020 207e 2f61 6d68 656c 6c6f 2d31 2e30 ~/amhello-1.0 │ │ │ │ │ +0000aa30: 2025 2063 6420 7e2f 696e 7374 0a20 2020 % cd ~/inst. │ │ │ │ │ +0000aa40: 2020 7e2f 696e 7374 2025 2066 696e 6420 ~/inst % find │ │ │ │ │ +0000aa50: 2e20 2d74 7970 6520 6620 2d70 7269 6e74 . -type f -print │ │ │ │ │ +0000aa60: 203e 202e 2e2f 6669 6c65 732e 6c73 740a > ../files.lst. │ │ │ │ │ +0000aa70: 2020 2020 207e 2f69 6e73 7420 2520 7461 ~/inst % ta │ │ │ │ │ +0000aa80: 7220 7a63 7666 207e 2f61 6d68 656c 6c6f r zcvf ~/amhello │ │ │ │ │ +0000aa90: 2d31 2e30 2d69 3638 362e 7461 722e 677a -1.0-i686.tar.gz │ │ │ │ │ +0000aaa0: 2060 6361 7420 2e2e 2f66 696c 6573 2e6c `cat ../files.l │ │ │ │ │ +0000aab0: 7374 600a 2020 2020 202e 2f75 7372 2f62 st`. ./usr/b │ │ │ │ │ +0000aac0: 696e 2f68 656c 6c6f 0a20 2020 2020 2e2f in/hello. ./ │ │ │ │ │ +0000aad0: 7573 722f 7368 6172 652f 646f 632f 616d usr/share/doc/am │ │ │ │ │ +0000aae0: 6865 6c6c 6f2f 5245 4144 4d45 0a0a 2020 hello/README.. │ │ │ │ │ +0000aaf0: 2041 6674 6572 2074 6869 7320 6578 616d After this exam │ │ │ │ │ +0000ab00: 706c 652c 2027 616d 6865 6c6c 6f2d 312e ple, 'amhello-1. │ │ │ │ │ +0000ab10: 302d 6936 3836 2e74 6172 2e67 7a27 2069 0-i686.tar.gz' i │ │ │ │ │ +0000ab20: 7320 7265 6164 7920 746f 2062 650a 756e s ready to be.un │ │ │ │ │ +0000ab30: 636f 6d70 7265 7373 6564 2069 6e20 272f compressed in '/ │ │ │ │ │ +0000ab40: 2720 6f6e 206d 616e 7920 686f 7374 732e ' on many hosts. │ │ │ │ │ +0000ab50: 2020 2855 7369 6e67 2027 6063 6174 202e (Using '`cat . │ │ │ │ │ +0000ab60: 2e2f 6669 6c65 732e 6c73 7460 2720 696e ./files.lst`' in │ │ │ │ │ +0000ab70: 7374 6561 640a 6f66 2027 2e27 2061 7320 stead.of '.' as │ │ │ │ │ +0000ab80: 6172 6775 6d65 6e74 2066 6f72 2027 7461 argument for 'ta │ │ │ │ │ +0000ab90: 7227 2061 766f 6964 7320 656e 7472 6965 r' avoids entrie │ │ │ │ │ +0000aba0: 7320 666f 7220 6561 6368 2073 7562 6469 s for each subdi │ │ │ │ │ +0000abb0: 7265 6374 6f72 7920 696e 2074 6865 0a61 rectory in the.a │ │ │ │ │ +0000abc0: 7263 6869 7665 3a20 7765 2077 6f75 6c64 rchive: we would │ │ │ │ │ +0000abd0: 206e 6f74 206c 696b 6520 2774 6172 2720 not like 'tar' │ │ │ │ │ +0000abe0: 746f 2072 6573 746f 7265 2074 6865 206d to restore the m │ │ │ │ │ +0000abf0: 6f64 6966 6963 6174 696f 6e20 7469 6d65 odification time │ │ │ │ │ +0000ac00: 206f 660a 272f 272c 2027 2f75 7372 2f27 of.'/', '/usr/' │ │ │ │ │ +0000ac10: 2c20 6574 632e 290a 0a20 2020 4e6f 7465 , etc.).. Note │ │ │ │ │ +0000ac20: 2074 6861 7420 7768 656e 2062 7569 6c64 that when build │ │ │ │ │ +0000ac30: 696e 6720 7061 636b 6167 6573 2066 6f72 ing packages for │ │ │ │ │ +0000ac40: 2073 6576 6572 616c 2061 7263 6869 7465 several archite │ │ │ │ │ +0000ac50: 6374 7572 6573 2c20 6974 206d 6967 6874 ctures, it might │ │ │ │ │ +0000ac60: 0a62 6520 636f 6e76 656e 6965 6e74 2074 .be convenient t │ │ │ │ │ +0000ac70: 6f20 7573 6520 276d 616b 6520 696e 7374 o use 'make inst │ │ │ │ │ +0000ac80: 616c 6c2d 6461 7461 2720 616e 6420 276d all-data' and 'm │ │ │ │ │ +0000ac90: 616b 6520 696e 7374 616c 6c2d 6578 6563 ake install-exec │ │ │ │ │ +0000aca0: 2720 282a 6e6f 7465 0a54 776f 2d50 6172 ' (*note.Two-Par │ │ │ │ │ +0000acb0: 7420 496e 7374 616c 6c3a 3a29 2074 6f20 t Install::) to │ │ │ │ │ +0000acc0: 6761 7468 6572 2061 7263 6869 7465 6374 gather architect │ │ │ │ │ +0000acd0: 7572 652d 696e 6465 7065 6e64 656e 7420 ure-independent │ │ │ │ │ +0000ace0: 6669 6c65 7320 696e 2061 2073 696e 676c files in a singl │ │ │ │ │ +0000acf0: 650a 7061 636b 6167 652e 0a0a 2020 202a e.package... * │ │ │ │ │ +0000ad00: 4e6f 7465 2049 6e73 7461 6c6c 3a3a 2c20 Note Install::, │ │ │ │ │ +0000ad10: 666f 7220 6d6f 7265 2069 6e66 6f72 6d61 for more informa │ │ │ │ │ +0000ad20: 7469 6f6e 2e0a 0a1f 0a46 696c 653a 2061 tion.....File: a │ │ │ │ │ +0000ad30: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +0000ad40: 6f2c 2020 4e6f 6465 3a20 5072 6570 6172 o, Node: Prepar │ │ │ │ │ +0000ad50: 696e 6720 4469 7374 7269 6275 7469 6f6e ing Distribution │ │ │ │ │ +0000ad60: 732c 2020 4e65 7874 3a20 4465 7065 6e64 s, Next: Depend │ │ │ │ │ +0000ad70: 656e 6379 2054 7261 636b 696e 672c 2020 ency Tracking, │ │ │ │ │ +0000ad80: 5072 6576 3a20 4445 5354 4449 522c 2020 Prev: DESTDIR, │ │ │ │ │ +0000ad90: 5570 3a20 5573 6520 4361 7365 730a 0a32 Up: Use Cases..2 │ │ │ │ │ +0000ada0: 2e32 2e31 3120 5072 6570 6172 696e 6720 .2.11 Preparing │ │ │ │ │ +0000adb0: 4469 7374 7269 6275 7469 6f6e 730a 2d2d Distributions.-- │ │ │ │ │ 0000adc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000add0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5765 2068 ----------..We h │ │ │ │ │ -0000ade0: 6176 6520 616c 7265 6164 7920 6d65 6e74 ave already ment │ │ │ │ │ -0000adf0: 696f 6e65 6420 276d 616b 6520 6469 7374 ioned 'make dist │ │ │ │ │ -0000ae00: 272e 2020 5468 6973 2074 6172 6765 7420 '. This target │ │ │ │ │ -0000ae10: 636f 6c6c 6563 7473 2061 6c6c 2079 6f75 collects all you │ │ │ │ │ -0000ae20: 720a 736f 7572 6365 2066 696c 6573 2061 r.source files a │ │ │ │ │ -0000ae30: 6e64 2074 6865 206e 6563 6573 7361 7279 nd the necessary │ │ │ │ │ -0000ae40: 2070 6172 7473 206f 6620 7468 6520 6275 parts of the bu │ │ │ │ │ -0000ae50: 696c 6420 7379 7374 656d 2074 6f20 6372 ild system to cr │ │ │ │ │ -0000ae60: 6561 7465 2061 0a74 6172 6261 6c6c 206e eate a.tarball n │ │ │ │ │ -0000ae70: 616d 6564 2027 5041 434b 4147 452d 5645 amed 'PACKAGE-VE │ │ │ │ │ -0000ae80: 5253 494f 4e2e 7461 722e 677a 272e 0a0a RSION.tar.gz'... │ │ │ │ │ -0000ae90: 2020 2041 6e6f 7468 6572 2c20 6d6f 7265 Another, more │ │ │ │ │ -0000aea0: 2075 7365 6675 6c20 636f 6d6d 616e 6420 useful command │ │ │ │ │ -0000aeb0: 6973 2027 6d61 6b65 2064 6973 7463 6865 is 'make distche │ │ │ │ │ -0000aec0: 636b 272e 2020 5468 6520 2764 6973 7463 ck'. The 'distc │ │ │ │ │ -0000aed0: 6865 636b 270a 7461 7267 6574 2063 6f6e heck'.target con │ │ │ │ │ -0000aee0: 7374 7275 6374 7320 2750 4143 4b41 4745 structs 'PACKAGE │ │ │ │ │ -0000aef0: 2d56 4552 5349 4f4e 2e74 6172 2e67 7a27 -VERSION.tar.gz' │ │ │ │ │ -0000af00: 206a 7573 7420 6173 2077 656c 6c20 6173 just as well as │ │ │ │ │ -0000af10: 2027 6469 7374 272c 2062 7574 0a69 7420 'dist', but.it │ │ │ │ │ -0000af20: 6164 6469 7469 6f6e 616c 6c79 2065 6e73 additionally ens │ │ │ │ │ -0000af30: 7572 6573 206d 6f73 7420 6f66 2074 6865 ures most of the │ │ │ │ │ -0000af40: 2075 7365 2063 6173 6573 2070 7265 7365 use cases prese │ │ │ │ │ -0000af50: 6e74 6564 2073 6f20 6661 7220 776f 726b nted so far work │ │ │ │ │ -0000af60: 3a0a 0a20 2020 2a20 4974 2061 7474 656d :.. * It attem │ │ │ │ │ -0000af70: 7074 7320 6120 6675 6c6c 2063 6f6d 7069 pts a full compi │ │ │ │ │ -0000af80: 6c61 7469 6f6e 206f 6620 7468 6520 7061 lation of the pa │ │ │ │ │ -0000af90: 636b 6167 6520 282a 6e6f 7465 2042 6173 ckage (*note Bas │ │ │ │ │ -0000afa0: 6963 0a20 2020 2020 496e 7374 616c 6c61 ic. Installa │ │ │ │ │ -0000afb0: 7469 6f6e 3a3a 292c 2075 6e70 6163 6b69 tion::), unpacki │ │ │ │ │ -0000afc0: 6e67 2074 6865 206e 6577 6c79 2063 6f6e ng the newly con │ │ │ │ │ -0000afd0: 7374 7275 6374 6564 2074 6172 6261 6c6c structed tarball │ │ │ │ │ -0000afe0: 2c20 7275 6e6e 696e 670a 2020 2020 2027 , running. ' │ │ │ │ │ -0000aff0: 6d61 6b65 272c 2027 6d61 6b65 2063 6865 make', 'make che │ │ │ │ │ -0000b000: 636b 272c 2027 6d61 6b65 2069 6e73 7461 ck', 'make insta │ │ │ │ │ -0000b010: 6c6c 272c 2061 7320 7765 6c6c 2061 7320 ll', as well as │ │ │ │ │ -0000b020: 276d 616b 650a 2020 2020 2069 6e73 7461 'make. insta │ │ │ │ │ -0000b030: 6c6c 6368 6563 6b27 2c20 616e 6420 6576 llcheck', and ev │ │ │ │ │ -0000b040: 656e 2027 6d61 6b65 2064 6973 7427 2c0a en 'make dist',. │ │ │ │ │ -0000b050: 2020 202a 2069 7420 7465 7374 7320 5650 * it tests VP │ │ │ │ │ -0000b060: 4154 4820 6275 696c 6473 2077 6974 6820 ATH builds with │ │ │ │ │ -0000b070: 7265 6164 2d6f 6e6c 7920 736f 7572 6365 read-only source │ │ │ │ │ -0000b080: 2074 7265 6520 282a 6e6f 7465 2056 5041 tree (*note VPA │ │ │ │ │ -0000b090: 5448 0a20 2020 2020 4275 696c 6473 3a3a TH. Builds:: │ │ │ │ │ -0000b0a0: 292c 0a20 2020 2a20 6974 206d 616b 6573 ),. * it makes │ │ │ │ │ -0000b0b0: 2073 7572 6520 276d 616b 6520 636c 6561 sure 'make clea │ │ │ │ │ -0000b0c0: 6e27 2c20 276d 616b 6520 6469 7374 636c n', 'make distcl │ │ │ │ │ -0000b0d0: 6561 6e27 2c20 616e 6420 276d 616b 6520 ean', and 'make │ │ │ │ │ -0000b0e0: 756e 696e 7374 616c 6c27 0a20 2020 2020 uninstall'. │ │ │ │ │ -0000b0f0: 646f 206e 6f74 206f 6d69 7420 616e 7920 do not omit any │ │ │ │ │ -0000b100: 6669 6c65 2028 2a6e 6f74 6520 5374 616e file (*note Stan │ │ │ │ │ -0000b110: 6461 7264 2054 6172 6765 7473 3a3a 292c dard Targets::), │ │ │ │ │ -0000b120: 0a20 2020 2a20 616e 6420 6974 2063 6865 . * and it che │ │ │ │ │ -0000b130: 636b 7320 7468 6174 2027 4445 5354 4449 cks that 'DESTDI │ │ │ │ │ -0000b140: 5227 2069 6e73 7461 6c6c 6174 696f 6e73 R' installations │ │ │ │ │ -0000b150: 2077 6f72 6b20 282a 6e6f 7465 2044 4553 work (*note DES │ │ │ │ │ -0000b160: 5444 4952 3a3a 292e 0a0a 2020 2041 6c6c TDIR::)... All │ │ │ │ │ -0000b170: 206f 6620 7468 6573 6520 6163 7469 6f6e of these action │ │ │ │ │ -0000b180: 7320 6172 6520 7065 7266 6f72 6d65 6420 s are performed │ │ │ │ │ -0000b190: 696e 2061 2074 656d 706f 7261 7279 2073 in a temporary s │ │ │ │ │ -0000b1a0: 7562 6469 7265 6374 6f72 792c 2073 6f0a ubdirectory, so. │ │ │ │ │ -0000b1b0: 7468 6174 206e 6f20 726f 6f74 2070 7269 that no root pri │ │ │ │ │ -0000b1c0: 7669 6c65 6765 7320 6172 6520 7265 7175 vileges are requ │ │ │ │ │ -0000b1d0: 6972 6564 2e0a 0a20 2020 5265 6c65 6173 ired... Releas │ │ │ │ │ -0000b1e0: 696e 6720 6120 7061 636b 6167 6520 7468 ing a package th │ │ │ │ │ -0000b1f0: 6174 2066 6169 6c73 2027 6d61 6b65 2064 at fails 'make d │ │ │ │ │ -0000b200: 6973 7463 6865 636b 2720 6d65 616e 7320 istcheck' means │ │ │ │ │ -0000b210: 7468 6174 206f 6e65 206f 6620 7468 650a that one of the. │ │ │ │ │ -0000b220: 7363 656e 6172 696f 7320 7765 2070 7265 scenarios we pre │ │ │ │ │ -0000b230: 7365 6e74 6564 2077 696c 6c20 6e6f 7420 sented will not │ │ │ │ │ -0000b240: 776f 726b 2061 6e64 2073 6f6d 6520 7573 work and some us │ │ │ │ │ -0000b250: 6572 7320 7769 6c6c 2062 650a 6469 7361 ers will be.disa │ │ │ │ │ -0000b260: 7070 6f69 6e74 6564 2e20 2054 6865 7265 ppointed. There │ │ │ │ │ -0000b270: 666f 7265 2069 7420 6973 2061 2067 6f6f fore it is a goo │ │ │ │ │ -0000b280: 6420 7072 6163 7469 6365 2074 6f20 7265 d practice to re │ │ │ │ │ -0000b290: 6c65 6173 6520 6120 7061 636b 6167 6520 lease a package │ │ │ │ │ -0000b2a0: 6f6e 6c79 0a61 6674 6572 2061 2073 7563 only.after a suc │ │ │ │ │ -0000b2b0: 6365 7373 6675 6c20 276d 616b 6520 6469 cessful 'make di │ │ │ │ │ -0000b2c0: 7374 6368 6563 6b27 2e20 2054 6869 7320 stcheck'. This │ │ │ │ │ -0000b2d0: 6f66 2063 6f75 7273 6520 646f 6573 206e of course does n │ │ │ │ │ -0000b2e0: 6f74 2069 6d70 6c79 2074 6861 740a 7468 ot imply that.th │ │ │ │ │ -0000b2f0: 6520 7061 636b 6167 6520 7769 6c6c 2062 e package will b │ │ │ │ │ -0000b300: 6520 666c 6177 6c65 7373 2c20 6275 7420 e flawless, but │ │ │ │ │ -0000b310: 6174 206c 6561 7374 2069 7420 7769 6c6c at least it will │ │ │ │ │ -0000b320: 2070 7265 7665 6e74 2073 6f6d 6520 6f66 prevent some of │ │ │ │ │ -0000b330: 2074 6865 0a65 6d62 6172 7261 7373 696e the.embarrassin │ │ │ │ │ -0000b340: 6720 6572 726f 7273 2079 6f75 206d 6179 g errors you may │ │ │ │ │ -0000b350: 2066 696e 6420 696e 2070 6163 6b61 6765 find in package │ │ │ │ │ -0000b360: 7320 7265 6c65 6173 6564 2062 7920 7065 s released by pe │ │ │ │ │ -0000b370: 6f70 6c65 2077 686f 2068 6176 650a 6e65 ople who have.ne │ │ │ │ │ -0000b380: 7665 7220 6865 6172 6420 6162 6f75 7420 ver heard about │ │ │ │ │ -0000b390: 2764 6973 7463 6865 636b 2720 286c 696b 'distcheck' (lik │ │ │ │ │ -0000b3a0: 6520 2744 4553 5444 4952 2720 6e6f 7420 e 'DESTDIR' not │ │ │ │ │ -0000b3b0: 776f 726b 696e 6720 6265 6361 7573 6520 working because │ │ │ │ │ -0000b3c0: 6f66 2061 0a74 7970 6f2c 206f 7220 6120 of a.typo, or a │ │ │ │ │ -0000b3d0: 6469 7374 7269 6275 7465 6420 6669 6c65 distributed file │ │ │ │ │ -0000b3e0: 2062 6569 6e67 2065 7261 7365 6420 6279 being erased by │ │ │ │ │ -0000b3f0: 2027 6d61 6b65 2063 6c65 616e 272c 206f 'make clean', o │ │ │ │ │ -0000b400: 7220 6576 656e 0a27 5650 4154 4827 2062 r even.'VPATH' b │ │ │ │ │ -0000b410: 7569 6c64 7320 6e6f 7420 776f 726b 696e uilds not workin │ │ │ │ │ -0000b420: 6729 2e0a 0a20 2020 2a4e 6f74 6520 4372 g)... *Note Cr │ │ │ │ │ -0000b430: 6561 7469 6e67 2061 6d68 656c 6c6f 3a3a eating amhello:: │ │ │ │ │ -0000b440: 2c20 746f 2072 6563 7265 6174 6520 2761 , to recreate 'a │ │ │ │ │ -0000b450: 6d68 656c 6c6f 2d31 2e30 2e74 6172 2e67 mhello-1.0.tar.g │ │ │ │ │ -0000b460: 7a27 2075 7369 6e67 0a27 6d61 6b65 2064 z' using.'make d │ │ │ │ │ -0000b470: 6973 7463 6865 636b 272e 2020 2a4e 6f74 istcheck'. *Not │ │ │ │ │ -0000b480: 6520 4368 6563 6b69 6e67 2074 6865 2044 e Checking the D │ │ │ │ │ -0000b490: 6973 7472 6962 7574 696f 6e3a 3a2c 2066 istribution::, f │ │ │ │ │ -0000b4a0: 6f72 206d 6f72 650a 696e 666f 726d 6174 or more.informat │ │ │ │ │ -0000b4b0: 696f 6e20 6162 6f75 7420 2764 6973 7463 ion about 'distc │ │ │ │ │ -0000b4c0: 6865 636b 272e 0a0a 1f0a 4669 6c65 3a20 heck'.....File: │ │ │ │ │ -0000b4d0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -0000b4e0: 666f 2c20 204e 6f64 653a 2044 6570 656e fo, Node: Depen │ │ │ │ │ -0000b4f0: 6465 6e63 7920 5472 6163 6b69 6e67 2c20 dency Tracking, │ │ │ │ │ -0000b500: 204e 6578 743a 204e 6573 7465 6420 5061 Next: Nested Pa │ │ │ │ │ -0000b510: 636b 6167 6573 2c20 2050 7265 763a 2050 ckages, Prev: P │ │ │ │ │ -0000b520: 7265 7061 7269 6e67 2044 6973 7472 6962 reparing Distrib │ │ │ │ │ -0000b530: 7574 696f 6e73 2c20 2055 703a 2055 7365 utions, Up: Use │ │ │ │ │ -0000b540: 2043 6173 6573 0a0a 322e 322e 3132 2041 Cases..2.2.12 A │ │ │ │ │ -0000b550: 7574 6f6d 6174 6963 2044 6570 656e 6465 utomatic Depende │ │ │ │ │ -0000b560: 6e63 7920 5472 6163 6b69 6e67 0a2d 2d2d ncy Tracking.--- │ │ │ │ │ +0000add0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5765 ------------..We │ │ │ │ │ +0000ade0: 2068 6176 6520 616c 7265 6164 7920 6d65 have already me │ │ │ │ │ +0000adf0: 6e74 696f 6e65 6420 276d 616b 6520 6469 ntioned 'make di │ │ │ │ │ +0000ae00: 7374 272e 2020 5468 6973 2074 6172 6765 st'. This targe │ │ │ │ │ +0000ae10: 7420 636f 6c6c 6563 7473 2061 6c6c 2079 t collects all y │ │ │ │ │ +0000ae20: 6f75 720a 736f 7572 6365 2066 696c 6573 our.source files │ │ │ │ │ +0000ae30: 2061 6e64 2074 6865 206e 6563 6573 7361 and the necessa │ │ │ │ │ +0000ae40: 7279 2070 6172 7473 206f 6620 7468 6520 ry parts of the │ │ │ │ │ +0000ae50: 6275 696c 6420 7379 7374 656d 2074 6f20 build system to │ │ │ │ │ +0000ae60: 6372 6561 7465 2061 0a74 6172 6261 6c6c create a.tarball │ │ │ │ │ +0000ae70: 206e 616d 6564 2027 5041 434b 4147 452d named 'PACKAGE- │ │ │ │ │ +0000ae80: 5645 5253 494f 4e2e 7461 722e 677a 272e VERSION.tar.gz'. │ │ │ │ │ +0000ae90: 0a0a 2020 2041 6e6f 7468 6572 2c20 6d6f .. Another, mo │ │ │ │ │ +0000aea0: 7265 2075 7365 6675 6c20 636f 6d6d 616e re useful comman │ │ │ │ │ +0000aeb0: 6420 6973 2027 6d61 6b65 2064 6973 7463 d is 'make distc │ │ │ │ │ +0000aec0: 6865 636b 272e 2020 5468 6520 2764 6973 heck'. The 'dis │ │ │ │ │ +0000aed0: 7463 6865 636b 270a 7461 7267 6574 2063 tcheck'.target c │ │ │ │ │ +0000aee0: 6f6e 7374 7275 6374 7320 2750 4143 4b41 onstructs 'PACKA │ │ │ │ │ +0000aef0: 4745 2d56 4552 5349 4f4e 2e74 6172 2e67 GE-VERSION.tar.g │ │ │ │ │ +0000af00: 7a27 206a 7573 7420 6173 2077 656c 6c20 z' just as well │ │ │ │ │ +0000af10: 6173 2027 6469 7374 272c 2062 7574 0a69 as 'dist', but.i │ │ │ │ │ +0000af20: 7420 6164 6469 7469 6f6e 616c 6c79 2065 t additionally e │ │ │ │ │ +0000af30: 6e73 7572 6573 206d 6f73 7420 6f66 2074 nsures most of t │ │ │ │ │ +0000af40: 6865 2075 7365 2063 6173 6573 2070 7265 he use cases pre │ │ │ │ │ +0000af50: 7365 6e74 6564 2073 6f20 6661 7220 776f sented so far wo │ │ │ │ │ +0000af60: 726b 3a0a 0a20 2020 2a20 4974 2061 7474 rk:.. * It att │ │ │ │ │ +0000af70: 656d 7074 7320 6120 6675 6c6c 2063 6f6d empts a full com │ │ │ │ │ +0000af80: 7069 6c61 7469 6f6e 206f 6620 7468 6520 pilation of the │ │ │ │ │ +0000af90: 7061 636b 6167 6520 282a 6e6f 7465 2042 package (*note B │ │ │ │ │ +0000afa0: 6173 6963 0a20 2020 2020 496e 7374 616c asic. Instal │ │ │ │ │ +0000afb0: 6c61 7469 6f6e 3a3a 292c 2075 6e70 6163 lation::), unpac │ │ │ │ │ +0000afc0: 6b69 6e67 2074 6865 206e 6577 6c79 2063 king the newly c │ │ │ │ │ +0000afd0: 6f6e 7374 7275 6374 6564 2074 6172 6261 onstructed tarba │ │ │ │ │ +0000afe0: 6c6c 2c20 7275 6e6e 696e 670a 2020 2020 ll, running. │ │ │ │ │ +0000aff0: 2027 6d61 6b65 272c 2027 6d61 6b65 2063 'make', 'make c │ │ │ │ │ +0000b000: 6865 636b 272c 2027 6d61 6b65 2069 6e73 heck', 'make ins │ │ │ │ │ +0000b010: 7461 6c6c 272c 2061 7320 7765 6c6c 2061 tall', as well a │ │ │ │ │ +0000b020: 7320 276d 616b 650a 2020 2020 2069 6e73 s 'make. ins │ │ │ │ │ +0000b030: 7461 6c6c 6368 6563 6b27 2c20 616e 6420 tallcheck', and │ │ │ │ │ +0000b040: 6576 656e 2027 6d61 6b65 2064 6973 7427 even 'make dist' │ │ │ │ │ +0000b050: 2c0a 2020 202a 2069 7420 7465 7374 7320 ,. * it tests │ │ │ │ │ +0000b060: 5650 4154 4820 6275 696c 6473 2077 6974 VPATH builds wit │ │ │ │ │ +0000b070: 6820 7265 6164 2d6f 6e6c 7920 736f 7572 h read-only sour │ │ │ │ │ +0000b080: 6365 2074 7265 6520 282a 6e6f 7465 2056 ce tree (*note V │ │ │ │ │ +0000b090: 5041 5448 0a20 2020 2020 4275 696c 6473 PATH. Builds │ │ │ │ │ +0000b0a0: 3a3a 292c 0a20 2020 2a20 6974 206d 616b ::),. * it mak │ │ │ │ │ +0000b0b0: 6573 2073 7572 6520 276d 616b 6520 636c es sure 'make cl │ │ │ │ │ +0000b0c0: 6561 6e27 2c20 276d 616b 6520 6469 7374 ean', 'make dist │ │ │ │ │ +0000b0d0: 636c 6561 6e27 2c20 616e 6420 276d 616b clean', and 'mak │ │ │ │ │ +0000b0e0: 6520 756e 696e 7374 616c 6c27 0a20 2020 e uninstall'. │ │ │ │ │ +0000b0f0: 2020 646f 206e 6f74 206f 6d69 7420 616e do not omit an │ │ │ │ │ +0000b100: 7920 6669 6c65 2028 2a6e 6f74 6520 5374 y file (*note St │ │ │ │ │ +0000b110: 616e 6461 7264 2054 6172 6765 7473 3a3a andard Targets:: │ │ │ │ │ +0000b120: 292c 0a20 2020 2a20 616e 6420 6974 2063 ),. * and it c │ │ │ │ │ +0000b130: 6865 636b 7320 7468 6174 2027 4445 5354 hecks that 'DEST │ │ │ │ │ +0000b140: 4449 5227 2069 6e73 7461 6c6c 6174 696f DIR' installatio │ │ │ │ │ +0000b150: 6e73 2077 6f72 6b20 282a 6e6f 7465 2044 ns work (*note D │ │ │ │ │ +0000b160: 4553 5444 4952 3a3a 292e 0a0a 2020 2041 ESTDIR::)... A │ │ │ │ │ +0000b170: 6c6c 206f 6620 7468 6573 6520 6163 7469 ll of these acti │ │ │ │ │ +0000b180: 6f6e 7320 6172 6520 7065 7266 6f72 6d65 ons are performe │ │ │ │ │ +0000b190: 6420 696e 2061 2074 656d 706f 7261 7279 d in a temporary │ │ │ │ │ +0000b1a0: 2073 7562 6469 7265 6374 6f72 792c 2073 subdirectory, s │ │ │ │ │ +0000b1b0: 6f0a 7468 6174 206e 6f20 726f 6f74 2070 o.that no root p │ │ │ │ │ +0000b1c0: 7269 7669 6c65 6765 7320 6172 6520 7265 rivileges are re │ │ │ │ │ +0000b1d0: 7175 6972 6564 2e0a 0a20 2020 5265 6c65 quired... Rele │ │ │ │ │ +0000b1e0: 6173 696e 6720 6120 7061 636b 6167 6520 asing a package │ │ │ │ │ +0000b1f0: 7468 6174 2066 6169 6c73 2027 6d61 6b65 that fails 'make │ │ │ │ │ +0000b200: 2064 6973 7463 6865 636b 2720 6d65 616e distcheck' mean │ │ │ │ │ +0000b210: 7320 7468 6174 206f 6e65 206f 6620 7468 s that one of th │ │ │ │ │ +0000b220: 650a 7363 656e 6172 696f 7320 7765 2070 e.scenarios we p │ │ │ │ │ +0000b230: 7265 7365 6e74 6564 2077 696c 6c20 6e6f resented will no │ │ │ │ │ +0000b240: 7420 776f 726b 2061 6e64 2073 6f6d 6520 t work and some │ │ │ │ │ +0000b250: 7573 6572 7320 7769 6c6c 2062 650a 6469 users will be.di │ │ │ │ │ +0000b260: 7361 7070 6f69 6e74 6564 2e20 2054 6865 sappointed. The │ │ │ │ │ +0000b270: 7265 666f 7265 2069 7420 6973 2061 2067 refore it is a g │ │ │ │ │ +0000b280: 6f6f 6420 7072 6163 7469 6365 2074 6f20 ood practice to │ │ │ │ │ +0000b290: 7265 6c65 6173 6520 6120 7061 636b 6167 release a packag │ │ │ │ │ +0000b2a0: 6520 6f6e 6c79 0a61 6674 6572 2061 2073 e only.after a s │ │ │ │ │ +0000b2b0: 7563 6365 7373 6675 6c20 276d 616b 6520 uccessful 'make │ │ │ │ │ +0000b2c0: 6469 7374 6368 6563 6b27 2e20 2054 6869 distcheck'. Thi │ │ │ │ │ +0000b2d0: 7320 6f66 2063 6f75 7273 6520 646f 6573 s of course does │ │ │ │ │ +0000b2e0: 206e 6f74 2069 6d70 6c79 2074 6861 740a not imply that. │ │ │ │ │ +0000b2f0: 7468 6520 7061 636b 6167 6520 7769 6c6c the package will │ │ │ │ │ +0000b300: 2062 6520 666c 6177 6c65 7373 2c20 6275 be flawless, bu │ │ │ │ │ +0000b310: 7420 6174 206c 6561 7374 2069 7420 7769 t at least it wi │ │ │ │ │ +0000b320: 6c6c 2070 7265 7665 6e74 2073 6f6d 6520 ll prevent some │ │ │ │ │ +0000b330: 6f66 2074 6865 0a65 6d62 6172 7261 7373 of the.embarrass │ │ │ │ │ +0000b340: 696e 6720 6572 726f 7273 2079 6f75 206d ing errors you m │ │ │ │ │ +0000b350: 6179 2066 696e 6420 696e 2070 6163 6b61 ay find in packa │ │ │ │ │ +0000b360: 6765 7320 7265 6c65 6173 6564 2062 7920 ges released by │ │ │ │ │ +0000b370: 7065 6f70 6c65 2077 686f 2068 6176 650a people who have. │ │ │ │ │ +0000b380: 6e65 7665 7220 6865 6172 6420 6162 6f75 never heard abou │ │ │ │ │ +0000b390: 7420 2764 6973 7463 6865 636b 2720 286c t 'distcheck' (l │ │ │ │ │ +0000b3a0: 696b 6520 2744 4553 5444 4952 2720 6e6f ike 'DESTDIR' no │ │ │ │ │ +0000b3b0: 7420 776f 726b 696e 6720 6265 6361 7573 t working becaus │ │ │ │ │ +0000b3c0: 6520 6f66 2061 0a74 7970 6f2c 206f 7220 e of a.typo, or │ │ │ │ │ +0000b3d0: 6120 6469 7374 7269 6275 7465 6420 6669 a distributed fi │ │ │ │ │ +0000b3e0: 6c65 2062 6569 6e67 2065 7261 7365 6420 le being erased │ │ │ │ │ +0000b3f0: 6279 2027 6d61 6b65 2063 6c65 616e 272c by 'make clean', │ │ │ │ │ +0000b400: 206f 7220 6576 656e 0a27 5650 4154 4827 or even.'VPATH' │ │ │ │ │ +0000b410: 2062 7569 6c64 7320 6e6f 7420 776f 726b builds not work │ │ │ │ │ +0000b420: 696e 6729 2e0a 0a20 2020 2a4e 6f74 6520 ing)... *Note │ │ │ │ │ +0000b430: 4372 6561 7469 6e67 2061 6d68 656c 6c6f Creating amhello │ │ │ │ │ +0000b440: 3a3a 2c20 746f 2072 6563 7265 6174 6520 ::, to recreate │ │ │ │ │ +0000b450: 2761 6d68 656c 6c6f 2d31 2e30 2e74 6172 'amhello-1.0.tar │ │ │ │ │ +0000b460: 2e67 7a27 2075 7369 6e67 0a27 6d61 6b65 .gz' using.'make │ │ │ │ │ +0000b470: 2064 6973 7463 6865 636b 272e 2020 2a4e distcheck'. *N │ │ │ │ │ +0000b480: 6f74 6520 4368 6563 6b69 6e67 2074 6865 ote Checking the │ │ │ │ │ +0000b490: 2044 6973 7472 6962 7574 696f 6e3a 3a2c Distribution::, │ │ │ │ │ +0000b4a0: 2066 6f72 206d 6f72 650a 696e 666f 726d for more.inform │ │ │ │ │ +0000b4b0: 6174 696f 6e20 6162 6f75 7420 2764 6973 ation about 'dis │ │ │ │ │ +0000b4c0: 7463 6865 636b 272e 0a0a 1f0a 4669 6c65 tcheck'.....File │ │ │ │ │ +0000b4d0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +0000b4e0: 696e 666f 2c20 204e 6f64 653a 2044 6570 info, Node: Dep │ │ │ │ │ +0000b4f0: 656e 6465 6e63 7920 5472 6163 6b69 6e67 endency Tracking │ │ │ │ │ +0000b500: 2c20 204e 6578 743a 204e 6573 7465 6420 , Next: Nested │ │ │ │ │ +0000b510: 5061 636b 6167 6573 2c20 2050 7265 763a Packages, Prev: │ │ │ │ │ +0000b520: 2050 7265 7061 7269 6e67 2044 6973 7472 Preparing Distr │ │ │ │ │ +0000b530: 6962 7574 696f 6e73 2c20 2055 703a 2055 ibutions, Up: U │ │ │ │ │ +0000b540: 7365 2043 6173 6573 0a0a 322e 322e 3132 se Cases..2.2.12 │ │ │ │ │ +0000b550: 2041 7574 6f6d 6174 6963 2044 6570 656e Automatic Depen │ │ │ │ │ +0000b560: 6465 6e63 7920 5472 6163 6b69 6e67 0a2d dency Tracking.- │ │ │ │ │ 0000b570: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000b580: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000b590: 2d0a 0a44 6570 656e 6465 6e63 7920 7472 -..Dependency tr │ │ │ │ │ -0000b5a0: 6163 6b69 6e67 2069 7320 7065 7266 6f72 acking is perfor │ │ │ │ │ -0000b5b0: 6d65 6420 6173 2061 2073 6964 652d 6566 med as a side-ef │ │ │ │ │ -0000b5c0: 6665 6374 206f 6620 636f 6d70 696c 6174 fect of compilat │ │ │ │ │ -0000b5d0: 696f 6e2e 2020 4561 6368 0a74 696d 6520 ion. Each.time │ │ │ │ │ -0000b5e0: 7468 6520 6275 696c 6420 7379 7374 656d the build system │ │ │ │ │ -0000b5f0: 2063 6f6d 7069 6c65 7320 6120 736f 7572 compiles a sour │ │ │ │ │ -0000b600: 6365 2066 696c 652c 2069 7420 636f 6d70 ce file, it comp │ │ │ │ │ -0000b610: 7574 6573 2069 7473 206c 6973 7420 6f66 utes its list of │ │ │ │ │ -0000b620: 0a64 6570 656e 6465 6e63 6965 7320 2869 .dependencies (i │ │ │ │ │ -0000b630: 6e20 4320 7468 6573 6520 6172 6520 7468 n C these are th │ │ │ │ │ -0000b640: 6520 6865 6164 6572 2066 696c 6573 2069 e header files i │ │ │ │ │ -0000b650: 6e63 6c75 6465 6420 6279 2074 6865 2073 ncluded by the s │ │ │ │ │ -0000b660: 6f75 7263 650a 6265 696e 6720 636f 6d70 ource.being comp │ │ │ │ │ -0000b670: 696c 6564 292e 2020 4c61 7465 722c 2061 iled). Later, a │ │ │ │ │ -0000b680: 6e79 2074 696d 6520 276d 616b 6527 2069 ny time 'make' i │ │ │ │ │ -0000b690: 7320 7275 6e20 616e 6420 6120 6465 7065 s run and a depe │ │ │ │ │ -0000b6a0: 6e64 656e 6379 2061 7070 6561 7273 0a74 ndency appears.t │ │ │ │ │ -0000b6b0: 6f20 6861 7665 2063 6861 6e67 6564 2c20 o have changed, │ │ │ │ │ -0000b6c0: 7468 6520 6465 7065 6e64 656e 7420 6669 the dependent fi │ │ │ │ │ -0000b6d0: 6c65 7320 7769 6c6c 2062 6520 7265 6275 les will be rebu │ │ │ │ │ -0000b6e0: 696c 742e 0a0a 2020 2041 7574 6f6d 616b ilt... Automak │ │ │ │ │ -0000b6f0: 6520 6765 6e65 7261 7465 7320 636f 6465 e generates code │ │ │ │ │ -0000b700: 2066 6f72 2061 7574 6f6d 6174 6963 2064 for automatic d │ │ │ │ │ -0000b710: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ -0000b720: 6e67 2062 7920 6465 6661 756c 742c 0a75 ng by default,.u │ │ │ │ │ -0000b730: 6e6c 6573 7320 7468 6520 6465 7665 6c6f nless the develo │ │ │ │ │ -0000b740: 7065 7220 6368 6f6f 7365 7320 746f 206f per chooses to o │ │ │ │ │ -0000b750: 7665 7272 6964 6520 6974 3b20 666f 7220 verride it; for │ │ │ │ │ -0000b760: 6d6f 7265 2069 6e66 6f72 6d61 7469 6f6e more information │ │ │ │ │ -0000b770: 2c20 2a6e 6f74 650a 4465 7065 6e64 656e , *note.Dependen │ │ │ │ │ -0000b780: 6369 6573 3a3a 2e0a 0a20 2020 5768 656e cies::... When │ │ │ │ │ -0000b790: 2027 636f 6e66 6967 7572 6527 2069 7320 'configure' is │ │ │ │ │ -0000b7a0: 6578 6563 7574 6564 2c20 796f 7520 6361 executed, you ca │ │ │ │ │ -0000b7b0: 6e20 7365 6520 6974 2070 726f 6269 6e67 n see it probing │ │ │ │ │ -0000b7c0: 2065 6163 6820 636f 6d70 696c 6572 0a66 each compiler.f │ │ │ │ │ -0000b7d0: 6f72 2074 6865 2064 6570 656e 6465 6e63 or the dependenc │ │ │ │ │ -0000b7e0: 7920 6d65 6368 616e 6973 6d20 6974 2073 y mechanism it s │ │ │ │ │ -0000b7f0: 7570 706f 7274 7320 2873 6576 6572 616c upports (several │ │ │ │ │ -0000b800: 206d 6563 6861 6e69 736d 7320 6361 6e20 mechanisms can │ │ │ │ │ -0000b810: 6265 0a75 7365 6429 3a0a 0a20 2020 2020 be.used):.. │ │ │ │ │ -0000b820: 7e2f 616d 6865 6c6c 6f2d 312e 3020 2520 ~/amhello-1.0 % │ │ │ │ │ -0000b830: 2e2f 636f 6e66 6967 7572 6520 2d2d 7072 ./configure --pr │ │ │ │ │ -0000b840: 6566 6978 202f 7573 720a 2020 2020 202e efix /usr. . │ │ │ │ │ -0000b850: 2e2e 0a20 2020 2020 6368 6563 6b69 6e67 ... checking │ │ │ │ │ -0000b860: 2064 6570 656e 6465 6e63 7920 7374 796c dependency styl │ │ │ │ │ -0000b870: 6520 6f66 2067 6363 2e2e 2e20 6763 6333 e of gcc... gcc3 │ │ │ │ │ -0000b880: 0a20 2020 2020 2e2e 2e0a 0a20 2020 4265 . ..... Be │ │ │ │ │ -0000b890: 6361 7573 6520 6465 7065 6e64 656e 6369 cause dependenci │ │ │ │ │ -0000b8a0: 6573 2061 7265 206f 6e6c 7920 636f 6d70 es are only comp │ │ │ │ │ -0000b8b0: 7574 6564 2061 7320 6120 7369 6465 2d65 uted as a side-e │ │ │ │ │ -0000b8c0: 6666 6563 7420 6f66 2074 6865 0a63 6f6d ffect of the.com │ │ │ │ │ -0000b8d0: 7069 6c61 7469 6f6e 2c20 6e6f 2064 6570 pilation, no dep │ │ │ │ │ -0000b8e0: 656e 6465 6e63 7920 696e 666f 726d 6174 endency informat │ │ │ │ │ -0000b8f0: 696f 6e20 6578 6973 7473 2074 6865 2066 ion exists the f │ │ │ │ │ -0000b900: 6972 7374 2074 696d 6520 6120 7061 636b irst time a pack │ │ │ │ │ -0000b910: 6167 650a 6973 2062 7569 6c74 2e20 2054 age.is built. T │ │ │ │ │ -0000b920: 6869 7320 6973 204f 4b20 6265 6361 7573 his is OK becaus │ │ │ │ │ -0000b930: 6520 616c 6c20 7468 6520 6669 6c65 7320 e all the files │ │ │ │ │ -0000b940: 6e65 6564 2074 6f20 6265 2062 7569 6c74 need to be built │ │ │ │ │ -0000b950: 2061 6e79 7761 793a 0a27 6d61 6b65 2720 anyway:.'make' │ │ │ │ │ -0000b960: 646f 6573 206e 6f74 2068 6176 6520 746f does not have to │ │ │ │ │ -0000b970: 2064 6563 6964 6520 7768 6963 6820 6669 decide which fi │ │ │ │ │ -0000b980: 6c65 7320 6e65 6564 2074 6f20 6265 2072 les need to be r │ │ │ │ │ -0000b990: 6562 7569 6c74 2e20 2049 6e20 6661 6374 ebuilt. In fact │ │ │ │ │ -0000b9a0: 2c0a 6465 7065 6e64 656e 6379 2074 7261 ,.dependency tra │ │ │ │ │ -0000b9b0: 636b 696e 6720 6973 2063 6f6d 706c 6574 cking is complet │ │ │ │ │ -0000b9c0: 656c 7920 7573 656c 6573 7320 666f 7220 ely useless for │ │ │ │ │ -0000b9d0: 6f6e 652d 7469 6d65 2062 7569 6c64 7320 one-time builds │ │ │ │ │ -0000b9e0: 616e 6420 7468 6572 650a 6973 2061 2027 and there.is a ' │ │ │ │ │ -0000b9f0: 636f 6e66 6967 7572 6527 206f 7074 696f configure' optio │ │ │ │ │ -0000ba00: 6e20 746f 2064 6973 6162 6c65 2074 6869 n to disable thi │ │ │ │ │ -0000ba10: 733a 0a0a 272d 2d64 6973 6162 6c65 2d64 s:..'--disable-d │ │ │ │ │ -0000ba20: 6570 656e 6465 6e63 792d 7472 6163 6b69 ependency-tracki │ │ │ │ │ -0000ba30: 6e67 270a 2020 2020 2053 7065 6564 2075 ng'. Speed u │ │ │ │ │ -0000ba40: 7020 6f6e 652d 7469 6d65 2062 7569 6c64 p one-time build │ │ │ │ │ -0000ba50: 732e 0a0a 2020 2053 6f6d 6520 636f 6d70 s... Some comp │ │ │ │ │ -0000ba60: 696c 6572 7320 646f 206e 6f74 206f 6666 ilers do not off │ │ │ │ │ -0000ba70: 6572 2061 6e79 2070 7261 6374 6963 616c er any practical │ │ │ │ │ -0000ba80: 2077 6179 2074 6f20 6465 7269 7665 2074 way to derive t │ │ │ │ │ -0000ba90: 6865 206c 6973 7420 6f66 0a64 6570 656e he list of.depen │ │ │ │ │ -0000baa0: 6465 6e63 6965 7320 6173 2061 2073 6964 dencies as a sid │ │ │ │ │ -0000bab0: 652d 6566 6665 6374 206f 6620 7468 6520 e-effect of the │ │ │ │ │ -0000bac0: 636f 6d70 696c 6174 696f 6e2c 2072 6571 compilation, req │ │ │ │ │ -0000bad0: 7569 7269 6e67 2061 2073 6570 6172 6174 uiring a separat │ │ │ │ │ -0000bae0: 650a 7275 6e20 286d 6179 6265 206f 6620 e.run (maybe of │ │ │ │ │ -0000baf0: 616e 6f74 6865 7220 746f 6f6c 2920 746f another tool) to │ │ │ │ │ -0000bb00: 2063 6f6d 7075 7465 2074 6865 7365 2064 compute these d │ │ │ │ │ -0000bb10: 6570 656e 6465 6e63 6965 732e 2020 5468 ependencies. Th │ │ │ │ │ -0000bb20: 650a 7065 7266 6f72 6d61 6e63 6520 7065 e.performance pe │ │ │ │ │ -0000bb30: 6e61 6c74 7920 696d 706c 6965 6420 6279 nalty implied by │ │ │ │ │ -0000bb40: 2074 6865 7365 206d 6574 686f 6473 2069 these methods i │ │ │ │ │ -0000bb50: 7320 696d 706f 7274 616e 7420 656e 6f75 s important enou │ │ │ │ │ -0000bb60: 6768 2074 6f0a 6469 7361 626c 6520 7468 gh to.disable th │ │ │ │ │ -0000bb70: 656d 2062 7920 6465 6661 756c 742e 2020 em by default. │ │ │ │ │ -0000bb80: 5468 6520 6f70 7469 6f6e 2027 2d2d 656e The option '--en │ │ │ │ │ -0000bb90: 6162 6c65 2d64 6570 656e 6465 6e63 792d able-dependency- │ │ │ │ │ -0000bba0: 7472 6163 6b69 6e67 2720 6d75 7374 0a62 tracking' must.b │ │ │ │ │ -0000bbb0: 6520 7061 7373 6564 2074 6f20 2763 6f6e e passed to 'con │ │ │ │ │ -0000bbc0: 6669 6775 7265 2720 746f 2061 6374 6976 figure' to activ │ │ │ │ │ -0000bbd0: 6174 6520 7468 656d 2e0a 0a27 2d2d 656e ate them...'--en │ │ │ │ │ -0000bbe0: 6162 6c65 2d64 6570 656e 6465 6e63 792d able-dependency- │ │ │ │ │ -0000bbf0: 7472 6163 6b69 6e67 270a 2020 2020 2044 tracking'. D │ │ │ │ │ -0000bc00: 6f20 6e6f 7420 7265 6a65 6374 2073 6c6f o not reject slo │ │ │ │ │ -0000bc10: 7720 6465 7065 6e64 656e 6379 2065 7874 w dependency ext │ │ │ │ │ -0000bc20: 7261 6374 6f72 732e 0a0a 2020 202a 4e6f ractors... *No │ │ │ │ │ -0000bc30: 7465 2044 6570 656e 6465 6e63 7920 5472 te Dependency Tr │ │ │ │ │ -0000bc40: 6163 6b69 6e67 2045 766f 6c75 7469 6f6e acking Evolution │ │ │ │ │ -0000bc50: 3a3a 2c20 666f 7220 736f 6d65 2064 6973 ::, for some dis │ │ │ │ │ -0000bc60: 6375 7373 696f 6e20 6162 6f75 7420 7468 cussion about th │ │ │ │ │ -0000bc70: 650a 6469 6666 6572 656e 7420 6465 7065 e.different depe │ │ │ │ │ -0000bc80: 6e64 656e 6379 2074 7261 636b 696e 6720 ndency tracking │ │ │ │ │ -0000bc90: 7363 6865 6d65 7320 7573 6564 2062 7920 schemes used by │ │ │ │ │ -0000bca0: 4175 746f 6d61 6b65 206f 7665 7220 7468 Automake over th │ │ │ │ │ -0000bcb0: 6520 7965 6172 732e 0a0a 1f0a 4669 6c65 e years.....File │ │ │ │ │ -0000bcc0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -0000bcd0: 696e 666f 2c20 204e 6f64 653a 204e 6573 info, Node: Nes │ │ │ │ │ -0000bce0: 7465 6420 5061 636b 6167 6573 2c20 2050 ted Packages, P │ │ │ │ │ -0000bcf0: 7265 763a 2044 6570 656e 6465 6e63 7920 rev: Dependency │ │ │ │ │ -0000bd00: 5472 6163 6b69 6e67 2c20 2055 703a 2055 Tracking, Up: U │ │ │ │ │ -0000bd10: 7365 2043 6173 6573 0a0a 322e 322e 3133 se Cases..2.2.13 │ │ │ │ │ -0000bd20: 204e 6573 7465 6420 5061 636b 6167 6573 Nested Packages │ │ │ │ │ -0000bd30: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -0000bd40: 2d2d 2d2d 2d2d 2d0a 0a41 6c74 686f 7567 -------..Althoug │ │ │ │ │ -0000bd50: 6820 6e65 7374 696e 6720 7061 636b 6167 h nesting packag │ │ │ │ │ -0000bd60: 6573 2069 736e 2774 2073 6f6d 6574 6869 es isn't somethi │ │ │ │ │ -0000bd70: 6e67 2077 6520 776f 756c 6420 7265 636f ng we would reco │ │ │ │ │ -0000bd80: 6d6d 656e 6420 746f 2073 6f6d 656f 6e65 mmend to someone │ │ │ │ │ -0000bd90: 0a77 686f 2069 7320 6469 7363 6f76 6572 .who is discover │ │ │ │ │ -0000bda0: 696e 6720 7468 6520 4175 746f 746f 6f6c ing the Autotool │ │ │ │ │ -0000bdb0: 732c 2069 7420 6973 2061 206e 6963 6520 s, it is a nice │ │ │ │ │ -0000bdc0: 6665 6174 7572 6520 776f 7274 6879 206f feature worthy o │ │ │ │ │ -0000bdd0: 6620 6d65 6e74 696f 6e0a 696e 2074 6869 f mention.in thi │ │ │ │ │ -0000bde0: 7320 736d 616c 6c20 6164 7665 7274 6973 s small advertis │ │ │ │ │ -0000bdf0: 696e 6720 746f 7572 2e0a 0a20 2020 4175 ing tour... Au │ │ │ │ │ -0000be00: 746f 636f 6e66 6973 6361 7465 6420 7061 toconfiscated pa │ │ │ │ │ -0000be10: 636b 6167 6573 2028 7468 6174 206d 6561 ckages (that mea │ │ │ │ │ -0000be20: 6e73 2070 6163 6b61 6765 7320 7768 6f73 ns packages whos │ │ │ │ │ -0000be30: 6520 6275 696c 6420 7379 7374 656d 2068 e build system h │ │ │ │ │ -0000be40: 6176 650a 6265 656e 2063 7265 6174 6564 ave.been created │ │ │ │ │ -0000be50: 2062 7920 4175 746f 636f 6e66 2061 6e64 by Autoconf and │ │ │ │ │ -0000be60: 2066 7269 656e 6473 2920 6361 6e20 6265 friends) can be │ │ │ │ │ -0000be70: 206e 6573 7465 6420 746f 2061 7262 6974 nested to arbit │ │ │ │ │ -0000be80: 7261 7279 2064 6570 7468 2e0a 0a20 2020 rary depth... │ │ │ │ │ -0000be90: 4120 7479 7069 6361 6c20 7365 7475 7020 A typical setup │ │ │ │ │ -0000bea0: 6973 2074 6861 7420 7061 636b 6167 6520 is that package │ │ │ │ │ -0000beb0: 4120 7769 6c6c 2064 6973 7472 6962 7574 A will distribut │ │ │ │ │ -0000bec0: 6520 6f6e 6520 6f66 2074 6865 0a6c 6962 e one of the.lib │ │ │ │ │ -0000bed0: 7261 7269 6573 2069 7420 6e65 6564 7320 raries it needs │ │ │ │ │ -0000bee0: 696e 2061 2073 7562 6469 7265 6374 6f72 in a subdirector │ │ │ │ │ -0000bef0: 792e 2020 5468 6973 206c 6962 7261 7279 y. This library │ │ │ │ │ -0000bf00: 2042 2069 7320 6120 636f 6d70 6c65 7465 B is a complete │ │ │ │ │ -0000bf10: 0a70 6163 6b61 6765 2077 6974 6820 6974 .package with it │ │ │ │ │ -0000bf20: 7320 6f77 6e20 474e 5520 4275 696c 6420 s own GNU Build │ │ │ │ │ -0000bf30: 5379 7374 656d 2e20 2054 6865 2027 636f System. The 'co │ │ │ │ │ -0000bf40: 6e66 6967 7572 6527 2073 6372 6970 7420 nfigure' script │ │ │ │ │ -0000bf50: 6f66 2041 2077 696c 6c0a 7275 6e20 7468 of A will.run th │ │ │ │ │ -0000bf60: 6520 2763 6f6e 6669 6775 7265 2720 7363 e 'configure' sc │ │ │ │ │ -0000bf70: 7269 7074 206f 6620 4220 6173 2070 6172 ript of B as par │ │ │ │ │ -0000bf80: 7420 6f66 2069 7473 2065 7865 6375 7469 t of its executi │ │ │ │ │ -0000bf90: 6f6e 2c20 6275 696c 6469 6e67 2061 6e64 on, building and │ │ │ │ │ -0000bfa0: 0a69 6e73 7461 6c6c 696e 6720 4120 7769 .installing A wi │ │ │ │ │ -0000bfb0: 6c6c 2061 6c73 6f20 6275 696c 6420 616e ll also build an │ │ │ │ │ -0000bfc0: 6420 696e 7374 616c 6c20 422e 2047 656e d install B. Gen │ │ │ │ │ -0000bfd0: 6572 6174 696e 6720 6120 6469 7374 7269 erating a distri │ │ │ │ │ -0000bfe0: 6275 7469 6f6e 0a66 6f72 2041 2077 696c bution.for A wil │ │ │ │ │ -0000bff0: 6c20 616c 736f 2069 6e63 6c75 6465 2042 l also include B │ │ │ │ │ -0000c000: 2e0a 0a20 2020 4974 2069 7320 706f 7373 ... It is poss │ │ │ │ │ -0000c010: 6962 6c65 2074 6f20 6761 7468 6572 2073 ible to gather s │ │ │ │ │ -0000c020: 6576 6572 616c 2070 6163 6b61 6765 7320 everal packages │ │ │ │ │ -0000c030: 6c69 6b65 2074 6869 732e 2020 4743 4320 like this. GCC │ │ │ │ │ -0000c040: 6973 2061 2068 6561 7679 0a75 7365 7220 is a heavy.user │ │ │ │ │ -0000c050: 6f66 2074 6869 7320 6665 6174 7572 652e of this feature. │ │ │ │ │ -0000c060: 2020 5468 6973 2067 6976 6573 2069 6e73 This gives ins │ │ │ │ │ -0000c070: 7461 6c6c 6572 7320 6120 7369 6e67 6c65 tallers a single │ │ │ │ │ -0000c080: 2070 6163 6b61 6765 2074 6f0a 636f 6e66 package to.conf │ │ │ │ │ -0000c090: 6967 7572 652c 2062 7569 6c64 2061 6e64 igure, build and │ │ │ │ │ -0000c0a0: 2069 6e73 7461 6c6c 2c20 7768 696c 6520 install, while │ │ │ │ │ -0000c0b0: 6974 2061 6c6c 6f77 7320 6465 7665 6c6f it allows develo │ │ │ │ │ -0000c0c0: 7065 7273 2074 6f20 776f 726b 206f 6e0a pers to work on. │ │ │ │ │ -0000c0d0: 7375 6270 6163 6b61 6765 7320 696e 6465 subpackages inde │ │ │ │ │ -0000c0e0: 7065 6e64 656e 746c 792e 0a0a 2020 2057 pendently... W │ │ │ │ │ -0000c0f0: 6865 6e20 636f 6e66 6967 7572 696e 6720 hen configuring │ │ │ │ │ -0000c100: 6e65 7374 6564 2070 6163 6b61 6765 732c nested packages, │ │ │ │ │ -0000c110: 2074 6865 2027 636f 6e66 6967 7572 6527 the 'configure' │ │ │ │ │ -0000c120: 206f 7074 696f 6e73 2067 6976 656e 2074 options given t │ │ │ │ │ -0000c130: 6f0a 7468 6520 746f 702d 6c65 7665 6c20 o.the top-level │ │ │ │ │ -0000c140: 2763 6f6e 6669 6775 7265 2720 6172 6520 'configure' are │ │ │ │ │ -0000c150: 7061 7373 6564 2072 6563 7572 7369 7665 passed recursive │ │ │ │ │ -0000c160: 6c79 2074 6f20 6e65 7374 6564 2027 636f ly to nested 'co │ │ │ │ │ -0000c170: 6e66 6967 7572 6527 732e 0a41 2070 6163 nfigure's..A pac │ │ │ │ │ -0000c180: 6b61 6765 2074 6861 7420 646f 6573 206e kage that does n │ │ │ │ │ -0000c190: 6f74 2075 6e64 6572 7374 616e 6420 616e ot understand an │ │ │ │ │ -0000c1a0: 206f 7074 696f 6e20 7769 6c6c 2069 676e option will ign │ │ │ │ │ -0000c1b0: 6f72 6520 6974 2c20 6173 7375 6d69 6e67 ore it, assuming │ │ │ │ │ -0000c1c0: 2069 740a 6973 206d 6561 6e69 6e67 6675 it.is meaningfu │ │ │ │ │ -0000c1d0: 6c20 746f 2073 6f6d 6520 6f74 6865 7220 l to some other │ │ │ │ │ -0000c1e0: 7061 636b 6167 652e 0a0a 2020 2054 6865 package... The │ │ │ │ │ -0000c1f0: 2063 6f6d 6d61 6e64 2027 636f 6e66 6967 command 'config │ │ │ │ │ -0000c200: 7572 6520 2d2d 6865 6c70 3d72 6563 7572 ure --help=recur │ │ │ │ │ -0000c210: 7369 7665 2720 6361 6e20 6265 2075 7365 sive' can be use │ │ │ │ │ -0000c220: 6420 746f 2064 6973 706c 6179 2074 6865 d to display the │ │ │ │ │ -0000c230: 0a6f 7074 696f 6e73 2073 7570 706f 7274 .options support │ │ │ │ │ -0000c240: 6564 2062 7920 616c 6c20 7468 6520 696e ed by all the in │ │ │ │ │ -0000c250: 636c 7564 6564 2070 6163 6b61 6765 732e cluded packages. │ │ │ │ │ -0000c260: 0a0a 2020 202a 4e6f 7465 2053 7562 7061 .. *Note Subpa │ │ │ │ │ -0000c270: 636b 6167 6573 3a3a 2c20 666f 7220 616e ckages::, for an │ │ │ │ │ -0000c280: 2065 7861 6d70 6c65 2073 6574 7570 2e0a example setup.. │ │ │ │ │ -0000c290: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -0000c2a0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -0000c2b0: 6465 3a20 5768 7920 4175 746f 746f 6f6c de: Why Autotool │ │ │ │ │ -0000c2c0: 732c 2020 4e65 7874 3a20 4865 6c6c 6f20 s, Next: Hello │ │ │ │ │ -0000c2d0: 576f 726c 642c 2020 5072 6576 3a20 5573 World, Prev: Us │ │ │ │ │ -0000c2e0: 6520 4361 7365 732c 2020 5570 3a20 4175 e Cases, Up: Au │ │ │ │ │ -0000c2f0: 746f 746f 6f6c 7320 496e 7472 6f64 7563 totools Introduc │ │ │ │ │ -0000c300: 7469 6f6e 0a0a 322e 3320 486f 7720 4175 tion..2.3 How Au │ │ │ │ │ -0000c310: 746f 746f 6f6c 7320 4865 6c70 0a3d 3d3d totools Help.=== │ │ │ │ │ +0000b590: 2d2d 2d0a 0a44 6570 656e 6465 6e63 7920 ---..Dependency │ │ │ │ │ +0000b5a0: 7472 6163 6b69 6e67 2069 7320 7065 7266 tracking is perf │ │ │ │ │ +0000b5b0: 6f72 6d65 6420 6173 2061 2073 6964 652d ormed as a side- │ │ │ │ │ +0000b5c0: 6566 6665 6374 206f 6620 636f 6d70 696c effect of compil │ │ │ │ │ +0000b5d0: 6174 696f 6e2e 2020 4561 6368 0a74 696d ation. Each.tim │ │ │ │ │ +0000b5e0: 6520 7468 6520 6275 696c 6420 7379 7374 e the build syst │ │ │ │ │ +0000b5f0: 656d 2063 6f6d 7069 6c65 7320 6120 736f em compiles a so │ │ │ │ │ +0000b600: 7572 6365 2066 696c 652c 2069 7420 636f urce file, it co │ │ │ │ │ +0000b610: 6d70 7574 6573 2069 7473 206c 6973 7420 mputes its list │ │ │ │ │ +0000b620: 6f66 0a64 6570 656e 6465 6e63 6965 7320 of.dependencies │ │ │ │ │ +0000b630: 2869 6e20 4320 7468 6573 6520 6172 6520 (in C these are │ │ │ │ │ +0000b640: 7468 6520 6865 6164 6572 2066 696c 6573 the header files │ │ │ │ │ +0000b650: 2069 6e63 6c75 6465 6420 6279 2074 6865 included by the │ │ │ │ │ +0000b660: 2073 6f75 7263 650a 6265 696e 6720 636f source.being co │ │ │ │ │ +0000b670: 6d70 696c 6564 292e 2020 4c61 7465 722c mpiled). Later, │ │ │ │ │ +0000b680: 2061 6e79 2074 696d 6520 276d 616b 6527 any time 'make' │ │ │ │ │ +0000b690: 2069 7320 7275 6e20 616e 6420 6120 6465 is run and a de │ │ │ │ │ +0000b6a0: 7065 6e64 656e 6379 2061 7070 6561 7273 pendency appears │ │ │ │ │ +0000b6b0: 0a74 6f20 6861 7665 2063 6861 6e67 6564 .to have changed │ │ │ │ │ +0000b6c0: 2c20 7468 6520 6465 7065 6e64 656e 7420 , the dependent │ │ │ │ │ +0000b6d0: 6669 6c65 7320 7769 6c6c 2062 6520 7265 files will be re │ │ │ │ │ +0000b6e0: 6275 696c 742e 0a0a 2020 2041 7574 6f6d built... Autom │ │ │ │ │ +0000b6f0: 616b 6520 6765 6e65 7261 7465 7320 636f ake generates co │ │ │ │ │ +0000b700: 6465 2066 6f72 2061 7574 6f6d 6174 6963 de for automatic │ │ │ │ │ +0000b710: 2064 6570 656e 6465 6e63 7920 7472 6163 dependency trac │ │ │ │ │ +0000b720: 6b69 6e67 2062 7920 6465 6661 756c 742c king by default, │ │ │ │ │ +0000b730: 0a75 6e6c 6573 7320 7468 6520 6465 7665 .unless the deve │ │ │ │ │ +0000b740: 6c6f 7065 7220 6368 6f6f 7365 7320 746f loper chooses to │ │ │ │ │ +0000b750: 206f 7665 7272 6964 6520 6974 3b20 666f override it; fo │ │ │ │ │ +0000b760: 7220 6d6f 7265 2069 6e66 6f72 6d61 7469 r more informati │ │ │ │ │ +0000b770: 6f6e 2c20 2a6e 6f74 650a 4465 7065 6e64 on, *note.Depend │ │ │ │ │ +0000b780: 656e 6369 6573 3a3a 2e0a 0a20 2020 5768 encies::... Wh │ │ │ │ │ +0000b790: 656e 2027 636f 6e66 6967 7572 6527 2069 en 'configure' i │ │ │ │ │ +0000b7a0: 7320 6578 6563 7574 6564 2c20 796f 7520 s executed, you │ │ │ │ │ +0000b7b0: 6361 6e20 7365 6520 6974 2070 726f 6269 can see it probi │ │ │ │ │ +0000b7c0: 6e67 2065 6163 6820 636f 6d70 696c 6572 ng each compiler │ │ │ │ │ +0000b7d0: 0a66 6f72 2074 6865 2064 6570 656e 6465 .for the depende │ │ │ │ │ +0000b7e0: 6e63 7920 6d65 6368 616e 6973 6d20 6974 ncy mechanism it │ │ │ │ │ +0000b7f0: 2073 7570 706f 7274 7320 2873 6576 6572 supports (sever │ │ │ │ │ +0000b800: 616c 206d 6563 6861 6e69 736d 7320 6361 al mechanisms ca │ │ │ │ │ +0000b810: 6e20 6265 0a75 7365 6429 3a0a 0a20 2020 n be.used):.. │ │ │ │ │ +0000b820: 2020 7e2f 616d 6865 6c6c 6f2d 312e 3020 ~/amhello-1.0 │ │ │ │ │ +0000b830: 2520 2e2f 636f 6e66 6967 7572 6520 2d2d % ./configure -- │ │ │ │ │ +0000b840: 7072 6566 6978 202f 7573 720a 2020 2020 prefix /usr. │ │ │ │ │ +0000b850: 202e 2e2e 0a20 2020 2020 6368 6563 6b69 .... checki │ │ │ │ │ +0000b860: 6e67 2064 6570 656e 6465 6e63 7920 7374 ng dependency st │ │ │ │ │ +0000b870: 796c 6520 6f66 2067 6363 2e2e 2e20 6763 yle of gcc... gc │ │ │ │ │ +0000b880: 6333 0a20 2020 2020 2e2e 2e0a 0a20 2020 c3. ..... │ │ │ │ │ +0000b890: 4265 6361 7573 6520 6465 7065 6e64 656e Because dependen │ │ │ │ │ +0000b8a0: 6369 6573 2061 7265 206f 6e6c 7920 636f cies are only co │ │ │ │ │ +0000b8b0: 6d70 7574 6564 2061 7320 6120 7369 6465 mputed as a side │ │ │ │ │ +0000b8c0: 2d65 6666 6563 7420 6f66 2074 6865 0a63 -effect of the.c │ │ │ │ │ +0000b8d0: 6f6d 7069 6c61 7469 6f6e 2c20 6e6f 2064 ompilation, no d │ │ │ │ │ +0000b8e0: 6570 656e 6465 6e63 7920 696e 666f 726d ependency inform │ │ │ │ │ +0000b8f0: 6174 696f 6e20 6578 6973 7473 2074 6865 ation exists the │ │ │ │ │ +0000b900: 2066 6972 7374 2074 696d 6520 6120 7061 first time a pa │ │ │ │ │ +0000b910: 636b 6167 650a 6973 2062 7569 6c74 2e20 ckage.is built. │ │ │ │ │ +0000b920: 2054 6869 7320 6973 204f 4b20 6265 6361 This is OK beca │ │ │ │ │ +0000b930: 7573 6520 616c 6c20 7468 6520 6669 6c65 use all the file │ │ │ │ │ +0000b940: 7320 6e65 6564 2074 6f20 6265 2062 7569 s need to be bui │ │ │ │ │ +0000b950: 6c74 2061 6e79 7761 793a 0a27 6d61 6b65 lt anyway:.'make │ │ │ │ │ +0000b960: 2720 646f 6573 206e 6f74 2068 6176 6520 ' does not have │ │ │ │ │ +0000b970: 746f 2064 6563 6964 6520 7768 6963 6820 to decide which │ │ │ │ │ +0000b980: 6669 6c65 7320 6e65 6564 2074 6f20 6265 files need to be │ │ │ │ │ +0000b990: 2072 6562 7569 6c74 2e20 2049 6e20 6661 rebuilt. In fa │ │ │ │ │ +0000b9a0: 6374 2c0a 6465 7065 6e64 656e 6379 2074 ct,.dependency t │ │ │ │ │ +0000b9b0: 7261 636b 696e 6720 6973 2063 6f6d 706c racking is compl │ │ │ │ │ +0000b9c0: 6574 656c 7920 7573 656c 6573 7320 666f etely useless fo │ │ │ │ │ +0000b9d0: 7220 6f6e 652d 7469 6d65 2062 7569 6c64 r one-time build │ │ │ │ │ +0000b9e0: 7320 616e 6420 7468 6572 650a 6973 2061 s and there.is a │ │ │ │ │ +0000b9f0: 2027 636f 6e66 6967 7572 6527 206f 7074 'configure' opt │ │ │ │ │ +0000ba00: 696f 6e20 746f 2064 6973 6162 6c65 2074 ion to disable t │ │ │ │ │ +0000ba10: 6869 733a 0a0a 272d 2d64 6973 6162 6c65 his:..'--disable │ │ │ │ │ +0000ba20: 2d64 6570 656e 6465 6e63 792d 7472 6163 -dependency-trac │ │ │ │ │ +0000ba30: 6b69 6e67 270a 2020 2020 2053 7065 6564 king'. Speed │ │ │ │ │ +0000ba40: 2075 7020 6f6e 652d 7469 6d65 2062 7569 up one-time bui │ │ │ │ │ +0000ba50: 6c64 732e 0a0a 2020 2053 6f6d 6520 636f lds... Some co │ │ │ │ │ +0000ba60: 6d70 696c 6572 7320 646f 206e 6f74 206f mpilers do not o │ │ │ │ │ +0000ba70: 6666 6572 2061 6e79 2070 7261 6374 6963 ffer any practic │ │ │ │ │ +0000ba80: 616c 2077 6179 2074 6f20 6465 7269 7665 al way to derive │ │ │ │ │ +0000ba90: 2074 6865 206c 6973 7420 6f66 0a64 6570 the list of.dep │ │ │ │ │ +0000baa0: 656e 6465 6e63 6965 7320 6173 2061 2073 endencies as a s │ │ │ │ │ +0000bab0: 6964 652d 6566 6665 6374 206f 6620 7468 ide-effect of th │ │ │ │ │ +0000bac0: 6520 636f 6d70 696c 6174 696f 6e2c 2072 e compilation, r │ │ │ │ │ +0000bad0: 6571 7569 7269 6e67 2061 2073 6570 6172 equiring a separ │ │ │ │ │ +0000bae0: 6174 650a 7275 6e20 286d 6179 6265 206f ate.run (maybe o │ │ │ │ │ +0000baf0: 6620 616e 6f74 6865 7220 746f 6f6c 2920 f another tool) │ │ │ │ │ +0000bb00: 746f 2063 6f6d 7075 7465 2074 6865 7365 to compute these │ │ │ │ │ +0000bb10: 2064 6570 656e 6465 6e63 6965 732e 2020 dependencies. │ │ │ │ │ +0000bb20: 5468 650a 7065 7266 6f72 6d61 6e63 6520 The.performance │ │ │ │ │ +0000bb30: 7065 6e61 6c74 7920 696d 706c 6965 6420 penalty implied │ │ │ │ │ +0000bb40: 6279 2074 6865 7365 206d 6574 686f 6473 by these methods │ │ │ │ │ +0000bb50: 2069 7320 696d 706f 7274 616e 7420 656e is important en │ │ │ │ │ +0000bb60: 6f75 6768 2074 6f0a 6469 7361 626c 6520 ough to.disable │ │ │ │ │ +0000bb70: 7468 656d 2062 7920 6465 6661 756c 742e them by default. │ │ │ │ │ +0000bb80: 2020 5468 6520 6f70 7469 6f6e 2027 2d2d The option '-- │ │ │ │ │ +0000bb90: 656e 6162 6c65 2d64 6570 656e 6465 6e63 enable-dependenc │ │ │ │ │ +0000bba0: 792d 7472 6163 6b69 6e67 2720 6d75 7374 y-tracking' must │ │ │ │ │ +0000bbb0: 0a62 6520 7061 7373 6564 2074 6f20 2763 .be passed to 'c │ │ │ │ │ +0000bbc0: 6f6e 6669 6775 7265 2720 746f 2061 6374 onfigure' to act │ │ │ │ │ +0000bbd0: 6976 6174 6520 7468 656d 2e0a 0a27 2d2d ivate them...'-- │ │ │ │ │ +0000bbe0: 656e 6162 6c65 2d64 6570 656e 6465 6e63 enable-dependenc │ │ │ │ │ +0000bbf0: 792d 7472 6163 6b69 6e67 270a 2020 2020 y-tracking'. │ │ │ │ │ +0000bc00: 2044 6f20 6e6f 7420 7265 6a65 6374 2073 Do not reject s │ │ │ │ │ +0000bc10: 6c6f 7720 6465 7065 6e64 656e 6379 2065 low dependency e │ │ │ │ │ +0000bc20: 7874 7261 6374 6f72 732e 0a0a 2020 202a xtractors... * │ │ │ │ │ +0000bc30: 4e6f 7465 2044 6570 656e 6465 6e63 7920 Note Dependency │ │ │ │ │ +0000bc40: 5472 6163 6b69 6e67 2045 766f 6c75 7469 Tracking Evoluti │ │ │ │ │ +0000bc50: 6f6e 3a3a 2c20 666f 7220 736f 6d65 2064 on::, for some d │ │ │ │ │ +0000bc60: 6973 6375 7373 696f 6e20 6162 6f75 7420 iscussion about │ │ │ │ │ +0000bc70: 7468 650a 6469 6666 6572 656e 7420 6465 the.different de │ │ │ │ │ +0000bc80: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ +0000bc90: 6720 7363 6865 6d65 7320 7573 6564 2062 g schemes used b │ │ │ │ │ +0000bca0: 7920 4175 746f 6d61 6b65 206f 7665 7220 y Automake over │ │ │ │ │ +0000bcb0: 7468 6520 7965 6172 732e 0a0a 1f0a 4669 the years.....Fi │ │ │ │ │ +0000bcc0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +0000bcd0: 312e 696e 666f 2c20 204e 6f64 653a 204e 1.info, Node: N │ │ │ │ │ +0000bce0: 6573 7465 6420 5061 636b 6167 6573 2c20 ested Packages, │ │ │ │ │ +0000bcf0: 2050 7265 763a 2044 6570 656e 6465 6e63 Prev: Dependenc │ │ │ │ │ +0000bd00: 7920 5472 6163 6b69 6e67 2c20 2055 703a y Tracking, Up: │ │ │ │ │ +0000bd10: 2055 7365 2043 6173 6573 0a0a 322e 322e Use Cases..2.2. │ │ │ │ │ +0000bd20: 3133 204e 6573 7465 6420 5061 636b 6167 13 Nested Packag │ │ │ │ │ +0000bd30: 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d es.------------- │ │ │ │ │ +0000bd40: 2d2d 2d2d 2d2d 2d2d 2d0a 0a41 6c74 686f ---------..Altho │ │ │ │ │ +0000bd50: 7567 6820 6e65 7374 696e 6720 7061 636b ugh nesting pack │ │ │ │ │ +0000bd60: 6167 6573 2069 736e 2774 2073 6f6d 6574 ages isn't somet │ │ │ │ │ +0000bd70: 6869 6e67 2077 6520 776f 756c 6420 7265 hing we would re │ │ │ │ │ +0000bd80: 636f 6d6d 656e 6420 746f 2073 6f6d 656f commend to someo │ │ │ │ │ +0000bd90: 6e65 0a77 686f 2069 7320 6469 7363 6f76 ne.who is discov │ │ │ │ │ +0000bda0: 6572 696e 6720 7468 6520 4175 746f 746f ering the Autoto │ │ │ │ │ +0000bdb0: 6f6c 732c 2069 7420 6973 2061 206e 6963 ols, it is a nic │ │ │ │ │ +0000bdc0: 6520 6665 6174 7572 6520 776f 7274 6879 e feature worthy │ │ │ │ │ +0000bdd0: 206f 6620 6d65 6e74 696f 6e0a 696e 2074 of mention.in t │ │ │ │ │ +0000bde0: 6869 7320 736d 616c 6c20 6164 7665 7274 his small advert │ │ │ │ │ +0000bdf0: 6973 696e 6720 746f 7572 2e0a 0a20 2020 ising tour... │ │ │ │ │ +0000be00: 4175 746f 636f 6e66 6973 6361 7465 6420 Autoconfiscated │ │ │ │ │ +0000be10: 7061 636b 6167 6573 2028 7468 6174 206d packages (that m │ │ │ │ │ +0000be20: 6561 6e73 2070 6163 6b61 6765 7320 7768 eans packages wh │ │ │ │ │ +0000be30: 6f73 6520 6275 696c 6420 7379 7374 656d ose build system │ │ │ │ │ +0000be40: 2068 6176 650a 6265 656e 2063 7265 6174 have.been creat │ │ │ │ │ +0000be50: 6564 2062 7920 4175 746f 636f 6e66 2061 ed by Autoconf a │ │ │ │ │ +0000be60: 6e64 2066 7269 656e 6473 2920 6361 6e20 nd friends) can │ │ │ │ │ +0000be70: 6265 206e 6573 7465 6420 746f 2061 7262 be nested to arb │ │ │ │ │ +0000be80: 6974 7261 7279 2064 6570 7468 2e0a 0a20 itrary depth... │ │ │ │ │ +0000be90: 2020 4120 7479 7069 6361 6c20 7365 7475 A typical setu │ │ │ │ │ +0000bea0: 7020 6973 2074 6861 7420 7061 636b 6167 p is that packag │ │ │ │ │ +0000beb0: 6520 4120 7769 6c6c 2064 6973 7472 6962 e A will distrib │ │ │ │ │ +0000bec0: 7574 6520 6f6e 6520 6f66 2074 6865 0a6c ute one of the.l │ │ │ │ │ +0000bed0: 6962 7261 7269 6573 2069 7420 6e65 6564 ibraries it need │ │ │ │ │ +0000bee0: 7320 696e 2061 2073 7562 6469 7265 6374 s in a subdirect │ │ │ │ │ +0000bef0: 6f72 792e 2020 5468 6973 206c 6962 7261 ory. This libra │ │ │ │ │ +0000bf00: 7279 2042 2069 7320 6120 636f 6d70 6c65 ry B is a comple │ │ │ │ │ +0000bf10: 7465 0a70 6163 6b61 6765 2077 6974 6820 te.package with │ │ │ │ │ +0000bf20: 6974 7320 6f77 6e20 474e 5520 4275 696c its own GNU Buil │ │ │ │ │ +0000bf30: 6420 5379 7374 656d 2e20 2054 6865 2027 d System. The ' │ │ │ │ │ +0000bf40: 636f 6e66 6967 7572 6527 2073 6372 6970 configure' scrip │ │ │ │ │ +0000bf50: 7420 6f66 2041 2077 696c 6c0a 7275 6e20 t of A will.run │ │ │ │ │ +0000bf60: 7468 6520 2763 6f6e 6669 6775 7265 2720 the 'configure' │ │ │ │ │ +0000bf70: 7363 7269 7074 206f 6620 4220 6173 2070 script of B as p │ │ │ │ │ +0000bf80: 6172 7420 6f66 2069 7473 2065 7865 6375 art of its execu │ │ │ │ │ +0000bf90: 7469 6f6e 2c20 6275 696c 6469 6e67 2061 tion, building a │ │ │ │ │ +0000bfa0: 6e64 0a69 6e73 7461 6c6c 696e 6720 4120 nd.installing A │ │ │ │ │ +0000bfb0: 7769 6c6c 2061 6c73 6f20 6275 696c 6420 will also build │ │ │ │ │ +0000bfc0: 616e 6420 696e 7374 616c 6c20 422e 2047 and install B. G │ │ │ │ │ +0000bfd0: 656e 6572 6174 696e 6720 6120 6469 7374 enerating a dist │ │ │ │ │ +0000bfe0: 7269 6275 7469 6f6e 0a66 6f72 2041 2077 ribution.for A w │ │ │ │ │ +0000bff0: 696c 6c20 616c 736f 2069 6e63 6c75 6465 ill also include │ │ │ │ │ +0000c000: 2042 2e0a 0a20 2020 4974 2069 7320 706f B... It is po │ │ │ │ │ +0000c010: 7373 6962 6c65 2074 6f20 6761 7468 6572 ssible to gather │ │ │ │ │ +0000c020: 2073 6576 6572 616c 2070 6163 6b61 6765 several package │ │ │ │ │ +0000c030: 7320 6c69 6b65 2074 6869 732e 2020 4743 s like this. GC │ │ │ │ │ +0000c040: 4320 6973 2061 2068 6561 7679 0a75 7365 C is a heavy.use │ │ │ │ │ +0000c050: 7220 6f66 2074 6869 7320 6665 6174 7572 r of this featur │ │ │ │ │ +0000c060: 652e 2020 5468 6973 2067 6976 6573 2069 e. This gives i │ │ │ │ │ +0000c070: 6e73 7461 6c6c 6572 7320 6120 7369 6e67 nstallers a sing │ │ │ │ │ +0000c080: 6c65 2070 6163 6b61 6765 2074 6f0a 636f le package to.co │ │ │ │ │ +0000c090: 6e66 6967 7572 652c 2062 7569 6c64 2061 nfigure, build a │ │ │ │ │ +0000c0a0: 6e64 2069 6e73 7461 6c6c 2c20 7768 696c nd install, whil │ │ │ │ │ +0000c0b0: 6520 6974 2061 6c6c 6f77 7320 6465 7665 e it allows deve │ │ │ │ │ +0000c0c0: 6c6f 7065 7273 2074 6f20 776f 726b 206f lopers to work o │ │ │ │ │ +0000c0d0: 6e0a 7375 6270 6163 6b61 6765 7320 696e n.subpackages in │ │ │ │ │ +0000c0e0: 6465 7065 6e64 656e 746c 792e 0a0a 2020 dependently... │ │ │ │ │ +0000c0f0: 2057 6865 6e20 636f 6e66 6967 7572 696e When configurin │ │ │ │ │ +0000c100: 6720 6e65 7374 6564 2070 6163 6b61 6765 g nested package │ │ │ │ │ +0000c110: 732c 2074 6865 2027 636f 6e66 6967 7572 s, the 'configur │ │ │ │ │ +0000c120: 6527 206f 7074 696f 6e73 2067 6976 656e e' options given │ │ │ │ │ +0000c130: 2074 6f0a 7468 6520 746f 702d 6c65 7665 to.the top-leve │ │ │ │ │ +0000c140: 6c20 2763 6f6e 6669 6775 7265 2720 6172 l 'configure' ar │ │ │ │ │ +0000c150: 6520 7061 7373 6564 2072 6563 7572 7369 e passed recursi │ │ │ │ │ +0000c160: 7665 6c79 2074 6f20 6e65 7374 6564 2027 vely to nested ' │ │ │ │ │ +0000c170: 636f 6e66 6967 7572 6527 732e 0a41 2070 configure's..A p │ │ │ │ │ +0000c180: 6163 6b61 6765 2074 6861 7420 646f 6573 ackage that does │ │ │ │ │ +0000c190: 206e 6f74 2075 6e64 6572 7374 616e 6420 not understand │ │ │ │ │ +0000c1a0: 616e 206f 7074 696f 6e20 7769 6c6c 2069 an option will i │ │ │ │ │ +0000c1b0: 676e 6f72 6520 6974 2c20 6173 7375 6d69 gnore it, assumi │ │ │ │ │ +0000c1c0: 6e67 2069 740a 6973 206d 6561 6e69 6e67 ng it.is meaning │ │ │ │ │ +0000c1d0: 6675 6c20 746f 2073 6f6d 6520 6f74 6865 ful to some othe │ │ │ │ │ +0000c1e0: 7220 7061 636b 6167 652e 0a0a 2020 2054 r package... T │ │ │ │ │ +0000c1f0: 6865 2063 6f6d 6d61 6e64 2027 636f 6e66 he command 'conf │ │ │ │ │ +0000c200: 6967 7572 6520 2d2d 6865 6c70 3d72 6563 igure --help=rec │ │ │ │ │ +0000c210: 7572 7369 7665 2720 6361 6e20 6265 2075 ursive' can be u │ │ │ │ │ +0000c220: 7365 6420 746f 2064 6973 706c 6179 2074 sed to display t │ │ │ │ │ +0000c230: 6865 0a6f 7074 696f 6e73 2073 7570 706f he.options suppo │ │ │ │ │ +0000c240: 7274 6564 2062 7920 616c 6c20 7468 6520 rted by all the │ │ │ │ │ +0000c250: 696e 636c 7564 6564 2070 6163 6b61 6765 included package │ │ │ │ │ +0000c260: 732e 0a0a 2020 202a 4e6f 7465 2053 7562 s... *Note Sub │ │ │ │ │ +0000c270: 7061 636b 6167 6573 3a3a 2c20 666f 7220 packages::, for │ │ │ │ │ +0000c280: 616e 2065 7861 6d70 6c65 2073 6574 7570 an example setup │ │ │ │ │ +0000c290: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +0000c2a0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +0000c2b0: 4e6f 6465 3a20 5768 7920 4175 746f 746f Node: Why Autoto │ │ │ │ │ +0000c2c0: 6f6c 732c 2020 4e65 7874 3a20 4865 6c6c ols, Next: Hell │ │ │ │ │ +0000c2d0: 6f20 576f 726c 642c 2020 5072 6576 3a20 o World, Prev: │ │ │ │ │ +0000c2e0: 5573 6520 4361 7365 732c 2020 5570 3a20 Use Cases, Up: │ │ │ │ │ +0000c2f0: 4175 746f 746f 6f6c 7320 496e 7472 6f64 Autotools Introd │ │ │ │ │ +0000c300: 7563 7469 6f6e 0a0a 322e 3320 486f 7720 uction..2.3 How │ │ │ │ │ +0000c310: 4175 746f 746f 6f6c 7320 4865 6c70 0a3d Autotools Help.= │ │ │ │ │ 0000c320: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000c330: 3d3d 3d0a 0a54 6865 7265 2061 7265 2073 ===..There are s │ │ │ │ │ -0000c340: 6576 6572 616c 2072 6561 736f 6e73 2077 everal reasons w │ │ │ │ │ -0000c350: 6879 2079 6f75 206d 6179 206e 6f74 2077 hy you may not w │ │ │ │ │ -0000c360: 616e 7420 746f 2069 6d70 6c65 6d65 6e74 ant to implement │ │ │ │ │ -0000c370: 2074 6865 2047 4e55 0a42 7569 6c64 2053 the GNU.Build S │ │ │ │ │ -0000c380: 7973 7465 6d20 796f 7572 7365 6c66 2028 ystem yourself ( │ │ │ │ │ -0000c390: 7265 6164 3a20 7772 6974 6520 6120 2763 read: write a 'c │ │ │ │ │ -0000c3a0: 6f6e 6669 6775 7265 2720 7363 7269 7074 onfigure' script │ │ │ │ │ -0000c3b0: 2061 6e64 2027 4d61 6b65 6669 6c65 2773 and 'Makefile's │ │ │ │ │ -0000c3c0: 0a79 6f75 7273 656c 6629 2e0a 0a20 2020 .yourself)... │ │ │ │ │ -0000c3d0: 2a20 4173 2077 6520 6861 7665 2073 6565 * As we have see │ │ │ │ │ -0000c3e0: 6e2c 2074 6865 2047 4e55 2042 7569 6c64 n, the GNU Build │ │ │ │ │ -0000c3f0: 2053 7973 7465 6d20 6861 7320 6120 6c6f System has a lo │ │ │ │ │ -0000c400: 7420 6f66 2066 6561 7475 7265 7320 282a t of features (* │ │ │ │ │ -0000c410: 6e6f 7465 0a20 2020 2020 5573 6520 4361 note. Use Ca │ │ │ │ │ -0000c420: 7365 733a 3a29 2e20 2053 6f6d 6520 7573 ses::). Some us │ │ │ │ │ -0000c430: 6572 7320 6d61 7920 6578 7065 6374 2066 ers may expect f │ │ │ │ │ -0000c440: 6561 7475 7265 7320 796f 7520 6861 7665 eatures you have │ │ │ │ │ -0000c450: 206e 6f74 0a20 2020 2020 696d 706c 656d not. implem │ │ │ │ │ -0000c460: 656e 7465 6420 6265 6361 7573 6520 796f ented because yo │ │ │ │ │ -0000c470: 7520 6469 6420 6e6f 7420 6e65 6564 2074 u did not need t │ │ │ │ │ -0000c480: 6865 6d2e 0a20 2020 2a20 496d 706c 656d hem.. * Implem │ │ │ │ │ -0000c490: 656e 7469 6e67 2074 6865 7365 2066 6561 enting these fea │ │ │ │ │ -0000c4a0: 7475 7265 7320 706f 7274 6162 6c79 2069 tures portably i │ │ │ │ │ -0000c4b0: 7320 6469 6666 6963 756c 7420 616e 6420 s difficult and │ │ │ │ │ -0000c4c0: 6578 6861 7573 7469 6e67 2e0a 2020 2020 exhausting.. │ │ │ │ │ -0000c4d0: 2054 6869 6e6b 206f 6620 7772 6974 696e Think of writin │ │ │ │ │ -0000c4e0: 6720 706f 7274 6162 6c65 2073 6865 6c6c g portable shell │ │ │ │ │ -0000c4f0: 2073 6372 6970 7473 2c20 616e 6420 706f scripts, and po │ │ │ │ │ -0000c500: 7274 6162 6c65 2027 4d61 6b65 6669 6c65 rtable 'Makefile │ │ │ │ │ -0000c510: 2773 2c0a 2020 2020 2066 6f72 2073 7973 's,. for sys │ │ │ │ │ -0000c520: 7465 6d73 2079 6f75 206d 6179 206e 6f74 tems you may not │ │ │ │ │ -0000c530: 2068 6176 6520 6861 6e64 792e 2020 2a4e have handy. *N │ │ │ │ │ -0000c540: 6f74 6520 506f 7274 6162 6c65 2053 6865 ote Portable She │ │ │ │ │ -0000c550: 6c6c 0a20 2020 2020 5072 6f67 7261 6d6d ll. Programm │ │ │ │ │ -0000c560: 696e 673a 2028 6175 746f 636f 6e66 2950 ing: (autoconf)P │ │ │ │ │ -0000c570: 6f72 7461 626c 6520 5368 656c 6c2c 2074 ortable Shell, t │ │ │ │ │ -0000c580: 6f20 636f 6e76 696e 6365 2079 6f75 7273 o convince yours │ │ │ │ │ -0000c590: 656c 662e 0a20 2020 2a20 596f 7520 7769 elf.. * You wi │ │ │ │ │ -0000c5a0: 6c6c 2068 6176 6520 746f 2075 7067 7261 ll have to upgra │ │ │ │ │ -0000c5b0: 6465 2079 6f75 7220 7365 7475 7020 746f de your setup to │ │ │ │ │ -0000c5c0: 2066 6f6c 6c6f 7720 6368 616e 6765 7320 follow changes │ │ │ │ │ -0000c5d0: 746f 2074 6865 2047 4e55 0a20 2020 2020 to the GNU. │ │ │ │ │ -0000c5e0: 436f 6469 6e67 2053 7461 6e64 6172 6473 Coding Standards │ │ │ │ │ -0000c5f0: 2e0a 0a20 2020 5468 6520 474e 5520 4175 ... The GNU Au │ │ │ │ │ -0000c600: 746f 746f 6f6c 7320 7461 6b65 2061 6c6c totools take all │ │ │ │ │ -0000c610: 2074 6869 7320 6275 7264 656e 206f 6666 this burden off │ │ │ │ │ -0000c620: 2079 6f75 7220 6261 636b 2061 6e64 2070 your back and p │ │ │ │ │ -0000c630: 726f 7669 6465 3a0a 0a20 2020 2a20 546f rovide:.. * To │ │ │ │ │ -0000c640: 6f6c 7320 746f 2063 7265 6174 6520 6120 ols to create a │ │ │ │ │ -0000c650: 706f 7274 6162 6c65 2c20 636f 6d70 6c65 portable, comple │ │ │ │ │ -0000c660: 7465 2c20 616e 6420 7365 6c66 2d63 6f6e te, and self-con │ │ │ │ │ -0000c670: 7461 696e 6564 2047 4e55 2042 7569 6c64 tained GNU Build │ │ │ │ │ -0000c680: 0a20 2020 2020 5379 7374 656d 2c20 6672 . System, fr │ │ │ │ │ -0000c690: 6f6d 2073 696d 706c 6520 696e 7374 7275 om simple instru │ │ │ │ │ -0000c6a0: 6374 696f 6e73 2e20 205f 5365 6c66 2d63 ctions. _Self-c │ │ │ │ │ -0000c6b0: 6f6e 7461 696e 6564 5f20 6d65 616e 696e ontained_ meanin │ │ │ │ │ -0000c6c0: 6720 7468 650a 2020 2020 2072 6573 756c g the. resul │ │ │ │ │ -0000c6d0: 7469 6e67 2062 7569 6c64 2073 7973 7465 ting build syste │ │ │ │ │ -0000c6e0: 6d20 646f 6573 206e 6f74 2072 6571 7569 m does not requi │ │ │ │ │ -0000c6f0: 7265 2074 6865 2047 4e55 2041 7574 6f74 re the GNU Autot │ │ │ │ │ -0000c700: 6f6f 6c73 2e0a 2020 202a 2041 2063 656e ools.. * A cen │ │ │ │ │ -0000c710: 7472 616c 2070 6c61 6365 2077 6865 7265 tral place where │ │ │ │ │ -0000c720: 2066 6978 6573 2061 6e64 2069 6d70 726f fixes and impro │ │ │ │ │ -0000c730: 7665 6d65 6e74 7320 6172 6520 6d61 6465 vements are made │ │ │ │ │ -0000c740: 3a20 6120 6275 672d 6669 780a 2020 2020 : a bug-fix. │ │ │ │ │ -0000c750: 2066 6f72 2061 2070 6f72 7461 6269 6c69 for a portabili │ │ │ │ │ -0000c760: 7479 2069 7373 7565 2077 696c 6c20 6265 ty issue will be │ │ │ │ │ -0000c770: 6e65 6669 7420 6576 6572 7920 7061 636b nefit every pack │ │ │ │ │ -0000c780: 6167 652e 0a0a 2020 2059 6574 2074 6865 age... Yet the │ │ │ │ │ -0000c790: 7265 2061 6c73 6f20 6578 6973 7420 7265 re also exist re │ │ │ │ │ -0000c7a0: 6173 6f6e 7320 7768 7920 796f 7520 6d61 asons why you ma │ │ │ │ │ -0000c7b0: 7920 7761 6e74 204e 4f54 2074 6f20 7573 y want NOT to us │ │ │ │ │ -0000c7c0: 6520 7468 650a 4175 746f 746f 6f6c 732e e the.Autotools. │ │ │ │ │ -0000c7d0: 2e2e 2020 466f 7220 696e 7374 616e 6365 .. For instance │ │ │ │ │ -0000c7e0: 2079 6f75 206d 6179 2062 6520 616c 7265 you may be alre │ │ │ │ │ -0000c7f0: 6164 7920 7573 696e 6720 286f 7220 7573 ady using (or us │ │ │ │ │ -0000c800: 6564 2074 6f29 2061 6e6f 7468 6572 0a69 ed to) another.i │ │ │ │ │ -0000c810: 6e63 6f6d 7061 7469 626c 6520 6275 696c ncompatible buil │ │ │ │ │ -0000c820: 6420 7379 7374 656d 2e20 2041 7574 6f74 d system. Autot │ │ │ │ │ -0000c830: 6f6f 6c73 2077 696c 6c20 6f6e 6c79 2062 ools will only b │ │ │ │ │ -0000c840: 6520 7573 6566 756c 2069 6620 796f 7520 e useful if you │ │ │ │ │ -0000c850: 646f 0a61 6363 6570 7420 7468 6520 636f do.accept the co │ │ │ │ │ -0000c860: 6e63 6570 7473 206f 6620 7468 6520 474e ncepts of the GN │ │ │ │ │ -0000c870: 5520 4275 696c 6420 5379 7374 656d 2e20 U Build System. │ │ │ │ │ -0000c880: 2050 656f 706c 6520 7768 6f20 6861 7665 People who have │ │ │ │ │ -0000c890: 2074 6865 6972 206f 776e 0a69 6465 6120 their own.idea │ │ │ │ │ -0000c8a0: 6f66 2068 6f77 2061 2062 7569 6c64 2073 of how a build s │ │ │ │ │ -0000c8b0: 7973 7465 6d20 7368 6f75 6c64 2077 6f72 ystem should wor │ │ │ │ │ -0000c8c0: 6b20 7769 6c6c 2066 6565 6c20 6672 7573 k will feel frus │ │ │ │ │ -0000c8d0: 7472 6174 6564 2062 7920 7468 650a 4175 trated by the.Au │ │ │ │ │ -0000c8e0: 746f 746f 6f6c 732e 0a0a 1f0a 4669 6c65 totools.....File │ │ │ │ │ -0000c8f0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -0000c900: 696e 666f 2c20 204e 6f64 653a 2048 656c info, Node: Hel │ │ │ │ │ -0000c910: 6c6f 2057 6f72 6c64 2c20 2050 7265 763a lo World, Prev: │ │ │ │ │ -0000c920: 2057 6879 2041 7574 6f74 6f6f 6c73 2c20 Why Autotools, │ │ │ │ │ -0000c930: 2055 703a 2041 7574 6f74 6f6f 6c73 2049 Up: Autotools I │ │ │ │ │ -0000c940: 6e74 726f 6475 6374 696f 6e0a 0a32 2e34 ntroduction..2.4 │ │ │ │ │ -0000c950: 2041 2053 6d61 6c6c 2048 656c 6c6f 2057 A Small Hello W │ │ │ │ │ -0000c960: 6f72 6c64 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d orld.=========== │ │ │ │ │ -0000c970: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 496e ============..In │ │ │ │ │ -0000c980: 2074 6869 7320 7365 6374 696f 6e20 7765 this section we │ │ │ │ │ -0000c990: 2072 6563 7265 6174 6520 7468 6520 2761 recreate the 'a │ │ │ │ │ -0000c9a0: 6d68 656c 6c6f 2d31 2e30 2720 7061 636b mhello-1.0' pack │ │ │ │ │ -0000c9b0: 6167 6520 6672 6f6d 2073 6372 6174 6368 age from scratch │ │ │ │ │ -0000c9c0: 2e20 2054 6865 0a66 6972 7374 2073 7562 . The.first sub │ │ │ │ │ -0000c9d0: 7365 6374 696f 6e20 7368 6f77 7320 686f section shows ho │ │ │ │ │ -0000c9e0: 7720 746f 2063 616c 6c20 7468 6520 4175 w to call the Au │ │ │ │ │ -0000c9f0: 746f 746f 6f6c 7320 746f 2069 6e73 7461 totools to insta │ │ │ │ │ -0000ca00: 6e74 6961 7465 2074 6865 2047 4e55 0a42 ntiate the GNU.B │ │ │ │ │ -0000ca10: 7569 6c64 2053 7973 7465 6d2c 2077 6869 uild System, whi │ │ │ │ │ -0000ca20: 6c65 2074 6865 2073 6563 6f6e 6420 6578 le the second ex │ │ │ │ │ -0000ca30: 706c 6169 6e73 2074 6865 206d 6561 6e69 plains the meani │ │ │ │ │ -0000ca40: 6e67 206f 6620 7468 650a 2763 6f6e 6669 ng of the.'confi │ │ │ │ │ -0000ca50: 6775 7265 2e61 6327 2061 6e64 2027 4d61 gure.ac' and 'Ma │ │ │ │ │ -0000ca60: 6b65 6669 6c65 2e61 6d27 2066 696c 6573 kefile.am' files │ │ │ │ │ -0000ca70: 2072 6561 6420 6279 2074 6865 2041 7574 read by the Aut │ │ │ │ │ -0000ca80: 6f74 6f6f 6c73 2e0a 0a2a 204d 656e 753a otools...* Menu: │ │ │ │ │ -0000ca90: 0a0a 2a20 4372 6561 7469 6e67 2061 6d68 ..* Creating amh │ │ │ │ │ -0000caa0: 656c 6c6f 3a3a 2020 2020 2020 2020 2020 ello:: │ │ │ │ │ -0000cab0: 2020 4372 6561 7465 2027 616d 6865 6c6c Create 'amhell │ │ │ │ │ -0000cac0: 6f2d 312e 302e 7461 722e 677a 2720 6672 o-1.0.tar.gz' fr │ │ │ │ │ -0000cad0: 6f6d 2073 6372 6174 6368 0a2a 2061 6d68 om scratch.* amh │ │ │ │ │ -0000cae0: 656c 6c6f 2773 2063 6f6e 6669 6775 7265 ello's configure │ │ │ │ │ -0000caf0: 2e61 6320 5365 7475 7020 4578 706c 6169 .ac Setup Explai │ │ │ │ │ -0000cb00: 6e65 643a 3a0a 2a20 616d 6865 6c6c 6f27 ned::.* amhello' │ │ │ │ │ -0000cb10: 7320 4d61 6b65 6669 6c65 2e61 6d20 5365 s Makefile.am Se │ │ │ │ │ -0000cb20: 7475 7020 4578 706c 6169 6e65 643a 3a0a tup Explained::. │ │ │ │ │ -0000cb30: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -0000cb40: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -0000cb50: 6465 3a20 4372 6561 7469 6e67 2061 6d68 de: Creating amh │ │ │ │ │ -0000cb60: 656c 6c6f 2c20 204e 6578 743a 2061 6d68 ello, Next: amh │ │ │ │ │ -0000cb70: 656c 6c6f 2773 2063 6f6e 6669 6775 7265 ello's configure │ │ │ │ │ -0000cb80: 2e61 6320 5365 7475 7020 4578 706c 6169 .ac Setup Explai │ │ │ │ │ -0000cb90: 6e65 642c 2020 5570 3a20 4865 6c6c 6f20 ned, Up: Hello │ │ │ │ │ -0000cba0: 576f 726c 640a 0a32 2e34 2e31 2043 7265 World..2.4.1 Cre │ │ │ │ │ -0000cbb0: 6174 696e 6720 2761 6d68 656c 6c6f 2d31 ating 'amhello-1 │ │ │ │ │ -0000cbc0: 2e30 2e74 6172 2e67 7a27 0a2d 2d2d 2d2d .0.tar.gz'.----- │ │ │ │ │ +0000c330: 3d3d 3d3d 3d0a 0a54 6865 7265 2061 7265 =====..There are │ │ │ │ │ +0000c340: 2073 6576 6572 616c 2072 6561 736f 6e73 several reasons │ │ │ │ │ +0000c350: 2077 6879 2079 6f75 206d 6179 206e 6f74 why you may not │ │ │ │ │ +0000c360: 2077 616e 7420 746f 2069 6d70 6c65 6d65 want to impleme │ │ │ │ │ +0000c370: 6e74 2074 6865 2047 4e55 0a42 7569 6c64 nt the GNU.Build │ │ │ │ │ +0000c380: 2053 7973 7465 6d20 796f 7572 7365 6c66 System yourself │ │ │ │ │ +0000c390: 2028 7265 6164 3a20 7772 6974 6520 6120 (read: write a │ │ │ │ │ +0000c3a0: 2763 6f6e 6669 6775 7265 2720 7363 7269 'configure' scri │ │ │ │ │ +0000c3b0: 7074 2061 6e64 2027 4d61 6b65 6669 6c65 pt and 'Makefile │ │ │ │ │ +0000c3c0: 2773 0a79 6f75 7273 656c 6629 2e0a 0a20 's.yourself)... │ │ │ │ │ +0000c3d0: 2020 2a20 4173 2077 6520 6861 7665 2073 * As we have s │ │ │ │ │ +0000c3e0: 6565 6e2c 2074 6865 2047 4e55 2042 7569 een, the GNU Bui │ │ │ │ │ +0000c3f0: 6c64 2053 7973 7465 6d20 6861 7320 6120 ld System has a │ │ │ │ │ +0000c400: 6c6f 7420 6f66 2066 6561 7475 7265 7320 lot of features │ │ │ │ │ +0000c410: 282a 6e6f 7465 0a20 2020 2020 5573 6520 (*note. Use │ │ │ │ │ +0000c420: 4361 7365 733a 3a29 2e20 2053 6f6d 6520 Cases::). Some │ │ │ │ │ +0000c430: 7573 6572 7320 6d61 7920 6578 7065 6374 users may expect │ │ │ │ │ +0000c440: 2066 6561 7475 7265 7320 796f 7520 6861 features you ha │ │ │ │ │ +0000c450: 7665 206e 6f74 0a20 2020 2020 696d 706c ve not. impl │ │ │ │ │ +0000c460: 656d 656e 7465 6420 6265 6361 7573 6520 emented because │ │ │ │ │ +0000c470: 796f 7520 6469 6420 6e6f 7420 6e65 6564 you did not need │ │ │ │ │ +0000c480: 2074 6865 6d2e 0a20 2020 2a20 496d 706c them.. * Impl │ │ │ │ │ +0000c490: 656d 656e 7469 6e67 2074 6865 7365 2066 ementing these f │ │ │ │ │ +0000c4a0: 6561 7475 7265 7320 706f 7274 6162 6c79 eatures portably │ │ │ │ │ +0000c4b0: 2069 7320 6469 6666 6963 756c 7420 616e is difficult an │ │ │ │ │ +0000c4c0: 6420 6578 6861 7573 7469 6e67 2e0a 2020 d exhausting.. │ │ │ │ │ +0000c4d0: 2020 2054 6869 6e6b 206f 6620 7772 6974 Think of writ │ │ │ │ │ +0000c4e0: 696e 6720 706f 7274 6162 6c65 2073 6865 ing portable she │ │ │ │ │ +0000c4f0: 6c6c 2073 6372 6970 7473 2c20 616e 6420 ll scripts, and │ │ │ │ │ +0000c500: 706f 7274 6162 6c65 2027 4d61 6b65 6669 portable 'Makefi │ │ │ │ │ +0000c510: 6c65 2773 2c0a 2020 2020 2066 6f72 2073 le's,. for s │ │ │ │ │ +0000c520: 7973 7465 6d73 2079 6f75 206d 6179 206e ystems you may n │ │ │ │ │ +0000c530: 6f74 2068 6176 6520 6861 6e64 792e 2020 ot have handy. │ │ │ │ │ +0000c540: 2a4e 6f74 6520 506f 7274 6162 6c65 2053 *Note Portable S │ │ │ │ │ +0000c550: 6865 6c6c 0a20 2020 2020 5072 6f67 7261 hell. Progra │ │ │ │ │ +0000c560: 6d6d 696e 673a 2028 6175 746f 636f 6e66 mming: (autoconf │ │ │ │ │ +0000c570: 2950 6f72 7461 626c 6520 5368 656c 6c2c )Portable Shell, │ │ │ │ │ +0000c580: 2074 6f20 636f 6e76 696e 6365 2079 6f75 to convince you │ │ │ │ │ +0000c590: 7273 656c 662e 0a20 2020 2a20 596f 7520 rself.. * You │ │ │ │ │ +0000c5a0: 7769 6c6c 2068 6176 6520 746f 2075 7067 will have to upg │ │ │ │ │ +0000c5b0: 7261 6465 2079 6f75 7220 7365 7475 7020 rade your setup │ │ │ │ │ +0000c5c0: 746f 2066 6f6c 6c6f 7720 6368 616e 6765 to follow change │ │ │ │ │ +0000c5d0: 7320 746f 2074 6865 2047 4e55 0a20 2020 s to the GNU. │ │ │ │ │ +0000c5e0: 2020 436f 6469 6e67 2053 7461 6e64 6172 Coding Standar │ │ │ │ │ +0000c5f0: 6473 2e0a 0a20 2020 5468 6520 474e 5520 ds... The GNU │ │ │ │ │ +0000c600: 4175 746f 746f 6f6c 7320 7461 6b65 2061 Autotools take a │ │ │ │ │ +0000c610: 6c6c 2074 6869 7320 6275 7264 656e 206f ll this burden o │ │ │ │ │ +0000c620: 6666 2079 6f75 7220 6261 636b 2061 6e64 ff your back and │ │ │ │ │ +0000c630: 2070 726f 7669 6465 3a0a 0a20 2020 2a20 provide:.. * │ │ │ │ │ +0000c640: 546f 6f6c 7320 746f 2063 7265 6174 6520 Tools to create │ │ │ │ │ +0000c650: 6120 706f 7274 6162 6c65 2c20 636f 6d70 a portable, comp │ │ │ │ │ +0000c660: 6c65 7465 2c20 616e 6420 7365 6c66 2d63 lete, and self-c │ │ │ │ │ +0000c670: 6f6e 7461 696e 6564 2047 4e55 2042 7569 ontained GNU Bui │ │ │ │ │ +0000c680: 6c64 0a20 2020 2020 5379 7374 656d 2c20 ld. System, │ │ │ │ │ +0000c690: 6672 6f6d 2073 696d 706c 6520 696e 7374 from simple inst │ │ │ │ │ +0000c6a0: 7275 6374 696f 6e73 2e20 205f 5365 6c66 ructions. _Self │ │ │ │ │ +0000c6b0: 2d63 6f6e 7461 696e 6564 5f20 6d65 616e -contained_ mean │ │ │ │ │ +0000c6c0: 696e 6720 7468 650a 2020 2020 2072 6573 ing the. res │ │ │ │ │ +0000c6d0: 756c 7469 6e67 2062 7569 6c64 2073 7973 ulting build sys │ │ │ │ │ +0000c6e0: 7465 6d20 646f 6573 206e 6f74 2072 6571 tem does not req │ │ │ │ │ +0000c6f0: 7569 7265 2074 6865 2047 4e55 2041 7574 uire the GNU Aut │ │ │ │ │ +0000c700: 6f74 6f6f 6c73 2e0a 2020 202a 2041 2063 otools.. * A c │ │ │ │ │ +0000c710: 656e 7472 616c 2070 6c61 6365 2077 6865 entral place whe │ │ │ │ │ +0000c720: 7265 2066 6978 6573 2061 6e64 2069 6d70 re fixes and imp │ │ │ │ │ +0000c730: 726f 7665 6d65 6e74 7320 6172 6520 6d61 rovements are ma │ │ │ │ │ +0000c740: 6465 3a20 6120 6275 672d 6669 780a 2020 de: a bug-fix. │ │ │ │ │ +0000c750: 2020 2066 6f72 2061 2070 6f72 7461 6269 for a portabi │ │ │ │ │ +0000c760: 6c69 7479 2069 7373 7565 2077 696c 6c20 lity issue will │ │ │ │ │ +0000c770: 6265 6e65 6669 7420 6576 6572 7920 7061 benefit every pa │ │ │ │ │ +0000c780: 636b 6167 652e 0a0a 2020 2059 6574 2074 ckage... Yet t │ │ │ │ │ +0000c790: 6865 7265 2061 6c73 6f20 6578 6973 7420 here also exist │ │ │ │ │ +0000c7a0: 7265 6173 6f6e 7320 7768 7920 796f 7520 reasons why you │ │ │ │ │ +0000c7b0: 6d61 7920 7761 6e74 204e 4f54 2074 6f20 may want NOT to │ │ │ │ │ +0000c7c0: 7573 6520 7468 650a 4175 746f 746f 6f6c use the.Autotool │ │ │ │ │ +0000c7d0: 732e 2e2e 2020 466f 7220 696e 7374 616e s... For instan │ │ │ │ │ +0000c7e0: 6365 2079 6f75 206d 6179 2062 6520 616c ce you may be al │ │ │ │ │ +0000c7f0: 7265 6164 7920 7573 696e 6720 286f 7220 ready using (or │ │ │ │ │ +0000c800: 7573 6564 2074 6f29 2061 6e6f 7468 6572 used to) another │ │ │ │ │ +0000c810: 0a69 6e63 6f6d 7061 7469 626c 6520 6275 .incompatible bu │ │ │ │ │ +0000c820: 696c 6420 7379 7374 656d 2e20 2041 7574 ild system. Aut │ │ │ │ │ +0000c830: 6f74 6f6f 6c73 2077 696c 6c20 6f6e 6c79 otools will only │ │ │ │ │ +0000c840: 2062 6520 7573 6566 756c 2069 6620 796f be useful if yo │ │ │ │ │ +0000c850: 7520 646f 0a61 6363 6570 7420 7468 6520 u do.accept the │ │ │ │ │ +0000c860: 636f 6e63 6570 7473 206f 6620 7468 6520 concepts of the │ │ │ │ │ +0000c870: 474e 5520 4275 696c 6420 5379 7374 656d GNU Build System │ │ │ │ │ +0000c880: 2e20 2050 656f 706c 6520 7768 6f20 6861 . People who ha │ │ │ │ │ +0000c890: 7665 2074 6865 6972 206f 776e 0a69 6465 ve their own.ide │ │ │ │ │ +0000c8a0: 6120 6f66 2068 6f77 2061 2062 7569 6c64 a of how a build │ │ │ │ │ +0000c8b0: 2073 7973 7465 6d20 7368 6f75 6c64 2077 system should w │ │ │ │ │ +0000c8c0: 6f72 6b20 7769 6c6c 2066 6565 6c20 6672 ork will feel fr │ │ │ │ │ +0000c8d0: 7573 7472 6174 6564 2062 7920 7468 650a ustrated by the. │ │ │ │ │ +0000c8e0: 4175 746f 746f 6f6c 732e 0a0a 1f0a 4669 Autotools.....Fi │ │ │ │ │ +0000c8f0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +0000c900: 312e 696e 666f 2c20 204e 6f64 653a 2048 1.info, Node: H │ │ │ │ │ +0000c910: 656c 6c6f 2057 6f72 6c64 2c20 2050 7265 ello World, Pre │ │ │ │ │ +0000c920: 763a 2057 6879 2041 7574 6f74 6f6f 6c73 v: Why Autotools │ │ │ │ │ +0000c930: 2c20 2055 703a 2041 7574 6f74 6f6f 6c73 , Up: Autotools │ │ │ │ │ +0000c940: 2049 6e74 726f 6475 6374 696f 6e0a 0a32 Introduction..2 │ │ │ │ │ +0000c950: 2e34 2041 2053 6d61 6c6c 2048 656c 6c6f .4 A Small Hello │ │ │ │ │ +0000c960: 2057 6f72 6c64 0a3d 3d3d 3d3d 3d3d 3d3d World.========= │ │ │ │ │ +0000c970: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +0000c980: 496e 2074 6869 7320 7365 6374 696f 6e20 In this section │ │ │ │ │ +0000c990: 7765 2072 6563 7265 6174 6520 7468 6520 we recreate the │ │ │ │ │ +0000c9a0: 2761 6d68 656c 6c6f 2d31 2e30 2720 7061 'amhello-1.0' pa │ │ │ │ │ +0000c9b0: 636b 6167 6520 6672 6f6d 2073 6372 6174 ckage from scrat │ │ │ │ │ +0000c9c0: 6368 2e20 2054 6865 0a66 6972 7374 2073 ch. The.first s │ │ │ │ │ +0000c9d0: 7562 7365 6374 696f 6e20 7368 6f77 7320 ubsection shows │ │ │ │ │ +0000c9e0: 686f 7720 746f 2063 616c 6c20 7468 6520 how to call the │ │ │ │ │ +0000c9f0: 4175 746f 746f 6f6c 7320 746f 2069 6e73 Autotools to ins │ │ │ │ │ +0000ca00: 7461 6e74 6961 7465 2074 6865 2047 4e55 tantiate the GNU │ │ │ │ │ +0000ca10: 0a42 7569 6c64 2053 7973 7465 6d2c 2077 .Build System, w │ │ │ │ │ +0000ca20: 6869 6c65 2074 6865 2073 6563 6f6e 6420 hile the second │ │ │ │ │ +0000ca30: 6578 706c 6169 6e73 2074 6865 206d 6561 explains the mea │ │ │ │ │ +0000ca40: 6e69 6e67 206f 6620 7468 650a 2763 6f6e ning of the.'con │ │ │ │ │ +0000ca50: 6669 6775 7265 2e61 6327 2061 6e64 2027 figure.ac' and ' │ │ │ │ │ +0000ca60: 4d61 6b65 6669 6c65 2e61 6d27 2066 696c Makefile.am' fil │ │ │ │ │ +0000ca70: 6573 2072 6561 6420 6279 2074 6865 2041 es read by the A │ │ │ │ │ +0000ca80: 7574 6f74 6f6f 6c73 2e0a 0a2a 204d 656e utotools...* Men │ │ │ │ │ +0000ca90: 753a 0a0a 2a20 4372 6561 7469 6e67 2061 u:..* Creating a │ │ │ │ │ +0000caa0: 6d68 656c 6c6f 3a3a 2020 2020 2020 2020 mhello:: │ │ │ │ │ +0000cab0: 2020 2020 4372 6561 7465 2027 616d 6865 Create 'amhe │ │ │ │ │ +0000cac0: 6c6c 6f2d 312e 302e 7461 722e 677a 2720 llo-1.0.tar.gz' │ │ │ │ │ +0000cad0: 6672 6f6d 2073 6372 6174 6368 0a2a 2061 from scratch.* a │ │ │ │ │ +0000cae0: 6d68 656c 6c6f 2773 2063 6f6e 6669 6775 mhello's configu │ │ │ │ │ +0000caf0: 7265 2e61 6320 5365 7475 7020 4578 706c re.ac Setup Expl │ │ │ │ │ +0000cb00: 6169 6e65 643a 3a0a 2a20 616d 6865 6c6c ained::.* amhell │ │ │ │ │ +0000cb10: 6f27 7320 4d61 6b65 6669 6c65 2e61 6d20 o's Makefile.am │ │ │ │ │ +0000cb20: 5365 7475 7020 4578 706c 6169 6e65 643a Setup Explained: │ │ │ │ │ +0000cb30: 3a0a 0a1f 0a46 696c 653a 2061 7574 6f6d :....File: autom │ │ │ │ │ +0000cb40: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +0000cb50: 4e6f 6465 3a20 4372 6561 7469 6e67 2061 Node: Creating a │ │ │ │ │ +0000cb60: 6d68 656c 6c6f 2c20 204e 6578 743a 2061 mhello, Next: a │ │ │ │ │ +0000cb70: 6d68 656c 6c6f 2773 2063 6f6e 6669 6775 mhello's configu │ │ │ │ │ +0000cb80: 7265 2e61 6320 5365 7475 7020 4578 706c re.ac Setup Expl │ │ │ │ │ +0000cb90: 6169 6e65 642c 2020 5570 3a20 4865 6c6c ained, Up: Hell │ │ │ │ │ +0000cba0: 6f20 576f 726c 640a 0a32 2e34 2e31 2043 o World..2.4.1 C │ │ │ │ │ +0000cbb0: 7265 6174 696e 6720 2761 6d68 656c 6c6f reating 'amhello │ │ │ │ │ +0000cbc0: 2d31 2e30 2e74 6172 2e67 7a27 0a2d 2d2d -1.0.tar.gz'.--- │ │ │ │ │ 0000cbd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000cbe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0000cbf0: 4865 7265 2069 7320 686f 7720 7765 2063 Here is how we c │ │ │ │ │ -0000cc00: 616e 2072 6563 7265 6174 6520 2761 6d68 an recreate 'amh │ │ │ │ │ -0000cc10: 656c 6c6f 2d31 2e30 2e74 6172 2e67 7a27 ello-1.0.tar.gz' │ │ │ │ │ -0000cc20: 2066 726f 6d20 7363 7261 7463 682e 2020 from scratch. │ │ │ │ │ -0000cc30: 5468 650a 7061 636b 6167 6520 6973 2073 The.package is s │ │ │ │ │ -0000cc40: 696d 706c 6520 656e 6f75 6768 2073 6f20 imple enough so │ │ │ │ │ -0000cc50: 7468 6174 2077 6520 7769 6c6c 206f 6e6c that we will onl │ │ │ │ │ -0000cc60: 7920 6e65 6564 2074 6f20 7772 6974 6520 y need to write │ │ │ │ │ -0000cc70: 3520 6669 6c65 732e 0a28 596f 7520 6d61 5 files..(You ma │ │ │ │ │ -0000cc80: 7920 636f 7079 2074 6865 6d20 6672 6f6d y copy them from │ │ │ │ │ -0000cc90: 2074 6865 2066 696e 616c 2027 616d 6865 the final 'amhe │ │ │ │ │ -0000cca0: 6c6c 6f2d 312e 302e 7461 722e 677a 2720 llo-1.0.tar.gz' │ │ │ │ │ -0000ccb0: 7468 6174 2069 730a 6469 7374 7269 6275 that is.distribu │ │ │ │ │ -0000ccc0: 7465 6420 7769 7468 2041 7574 6f6d 616b ted with Automak │ │ │ │ │ -0000ccd0: 6520 6966 2079 6f75 2064 6f20 6e6f 7420 e if you do not │ │ │ │ │ -0000cce0: 7761 6e74 2074 6f20 7772 6974 6520 7468 want to write th │ │ │ │ │ -0000ccf0: 656d 2e29 0a0a 2020 2043 7265 6174 6520 em.).. Create │ │ │ │ │ -0000cd00: 7468 6520 666f 6c6c 6f77 696e 6720 6669 the following fi │ │ │ │ │ -0000cd10: 6c65 7320 696e 2061 6e20 656d 7074 7920 les in an empty │ │ │ │ │ -0000cd20: 6469 7265 6374 6f72 792e 0a0a 2020 202a directory... * │ │ │ │ │ -0000cd30: 2027 7372 632f 6d61 696e 2e63 2720 6973 'src/main.c' is │ │ │ │ │ -0000cd40: 2074 6865 2073 6f75 7263 6520 6669 6c65 the source file │ │ │ │ │ -0000cd50: 2066 6f72 2074 6865 2027 6865 6c6c 6f27 for the 'hello' │ │ │ │ │ -0000cd60: 2070 726f 6772 616d 2e20 2057 6520 7374 program. We st │ │ │ │ │ -0000cd70: 6f72 650a 2020 2020 2069 7420 696e 2074 ore. it in t │ │ │ │ │ -0000cd80: 6865 2027 7372 632f 2720 7375 6264 6972 he 'src/' subdir │ │ │ │ │ -0000cd90: 6563 746f 7279 2c20 6265 6361 7573 6520 ectory, because │ │ │ │ │ -0000cda0: 6c61 7465 722c 2077 6865 6e20 7468 6520 later, when the │ │ │ │ │ -0000cdb0: 7061 636b 6167 650a 2020 2020 2065 766f package. evo │ │ │ │ │ -0000cdc0: 6c76 6573 2c20 6974 2077 696c 6c20 6561 lves, it will ea │ │ │ │ │ -0000cdd0: 7365 2074 6865 2061 6464 6974 696f 6e20 se the addition │ │ │ │ │ -0000cde0: 6f66 2061 2027 6d61 6e2f 2720 6469 7265 of a 'man/' dire │ │ │ │ │ -0000cdf0: 6374 6f72 7920 666f 7220 6d61 6e0a 2020 ctory for man. │ │ │ │ │ -0000ce00: 2020 2070 6167 6573 2c20 6120 2764 6174 pages, a 'dat │ │ │ │ │ -0000ce10: 612f 2720 6469 7265 6374 6f72 7920 666f a/' directory fo │ │ │ │ │ -0000ce20: 7220 6461 7461 2066 696c 6573 2c20 6574 r data files, et │ │ │ │ │ -0000ce30: 632e 0a20 2020 2020 2020 2020 207e 2f61 c.. ~/a │ │ │ │ │ -0000ce40: 6d68 656c 6c6f 2025 2063 6174 2073 7263 mhello % cat src │ │ │ │ │ -0000ce50: 2f6d 6169 6e2e 630a 2020 2020 2020 2020 /main.c. │ │ │ │ │ -0000ce60: 2020 2369 6e63 6c75 6465 203c 636f 6e66 #include . │ │ │ │ │ -0000ce80: 2369 6e63 6c75 6465 203c 7374 6469 6f2e #include .. in │ │ │ │ │ -0000cea0: 740a 2020 2020 2020 2020 2020 6d61 696e t. main │ │ │ │ │ -0000ceb0: 2028 766f 6964 290a 2020 2020 2020 2020 (void). │ │ │ │ │ -0000cec0: 2020 7b0a 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ -0000ced0: 7075 7473 2028 2248 656c 6c6f 2057 6f72 puts ("Hello Wor │ │ │ │ │ -0000cee0: 6c64 2122 293b 0a20 2020 2020 2020 2020 ld!");. │ │ │ │ │ -0000cef0: 2020 2070 7574 7320 2822 5468 6973 2069 puts ("This i │ │ │ │ │ -0000cf00: 7320 2220 5041 434b 4147 455f 5354 5249 s " PACKAGE_STRI │ │ │ │ │ -0000cf10: 4e47 2022 2e22 293b 0a20 2020 2020 2020 NG ".");. │ │ │ │ │ -0000cf20: 2020 2020 2072 6574 7572 6e20 303b 0a20 return 0;. │ │ │ │ │ -0000cf30: 2020 2020 2020 2020 207d 0a0a 2020 202a }.. * │ │ │ │ │ -0000cf40: 2027 5245 4144 4d45 2720 636f 6e74 6169 'README' contai │ │ │ │ │ -0000cf50: 6e73 2073 6f6d 6520 7665 7279 206c 696d ns some very lim │ │ │ │ │ -0000cf60: 6974 6564 2064 6f63 756d 656e 7461 7469 ited documentati │ │ │ │ │ -0000cf70: 6f6e 2066 6f72 206f 7572 206c 6974 746c on for our littl │ │ │ │ │ -0000cf80: 650a 2020 2020 2070 6163 6b61 6765 2e0a e. package.. │ │ │ │ │ -0000cf90: 2020 2020 2020 2020 2020 7e2f 616d 6865 ~/amhe │ │ │ │ │ -0000cfa0: 6c6c 6f20 2520 6361 7420 5245 4144 4d45 llo % cat README │ │ │ │ │ -0000cfb0: 0a20 2020 2020 2020 2020 2054 6869 7320 . This │ │ │ │ │ -0000cfc0: 6973 2061 2064 656d 6f6e 7374 7261 7469 is a demonstrati │ │ │ │ │ -0000cfd0: 6f6e 2070 6163 6b61 6765 2066 6f72 2047 on package for G │ │ │ │ │ -0000cfe0: 4e55 2041 7574 6f6d 616b 652e 0a20 2020 NU Automake.. │ │ │ │ │ -0000cff0: 2020 2020 2020 2054 7970 6520 6069 6e66 Type `inf │ │ │ │ │ -0000d000: 6f20 4175 746f 6d61 6b65 2720 746f 2072 o Automake' to r │ │ │ │ │ -0000d010: 6561 6420 7468 6520 4175 746f 6d61 6b65 ead the Automake │ │ │ │ │ -0000d020: 206d 616e 7561 6c2e 0a0a 2020 202a 2027 manual... * ' │ │ │ │ │ -0000d030: 4d61 6b65 6669 6c65 2e61 6d27 2061 6e64 Makefile.am' and │ │ │ │ │ -0000d040: 2027 7372 632f 4d61 6b65 6669 6c65 2e61 'src/Makefile.a │ │ │ │ │ -0000d050: 6d27 2063 6f6e 7461 696e 2041 7574 6f6d m' contain Autom │ │ │ │ │ -0000d060: 616b 6520 696e 7374 7275 6374 696f 6e73 ake instructions │ │ │ │ │ -0000d070: 0a20 2020 2020 666f 7220 7468 6573 6520 . for these │ │ │ │ │ -0000d080: 7477 6f20 6469 7265 6374 6f72 6965 732e two directories. │ │ │ │ │ -0000d090: 0a0a 2020 2020 2020 2020 2020 7e2f 616d .. ~/am │ │ │ │ │ -0000d0a0: 6865 6c6c 6f20 2520 6361 7420 7372 632f hello % cat src/ │ │ │ │ │ -0000d0b0: 4d61 6b65 6669 6c65 2e61 6d0a 2020 2020 Makefile.am. │ │ │ │ │ -0000d0c0: 2020 2020 2020 6269 6e5f 5052 4f47 5241 bin_PROGRA │ │ │ │ │ -0000d0d0: 4d53 203d 2068 656c 6c6f 0a20 2020 2020 MS = hello. │ │ │ │ │ -0000d0e0: 2020 2020 2068 656c 6c6f 5f53 4f55 5243 hello_SOURC │ │ │ │ │ -0000d0f0: 4553 203d 206d 6169 6e2e 630a 2020 2020 ES = main.c. │ │ │ │ │ -0000d100: 2020 2020 2020 7e2f 616d 6865 6c6c 6f20 ~/amhello │ │ │ │ │ -0000d110: 2520 6361 7420 4d61 6b65 6669 6c65 2e61 % cat Makefile.a │ │ │ │ │ -0000d120: 6d0a 2020 2020 2020 2020 2020 5355 4244 m. SUBD │ │ │ │ │ -0000d130: 4952 5320 3d20 7372 630a 2020 2020 2020 IRS = src. │ │ │ │ │ -0000d140: 2020 2020 6469 7374 5f64 6f63 5f44 4154 dist_doc_DAT │ │ │ │ │ -0000d150: 4120 3d20 5245 4144 4d45 0a0a 2020 202a A = README.. * │ │ │ │ │ -0000d160: 2046 696e 616c 6c79 2c20 2763 6f6e 6669 Finally, 'confi │ │ │ │ │ -0000d170: 6775 7265 2e61 6327 2063 6f6e 7461 696e gure.ac' contain │ │ │ │ │ -0000d180: 7320 4175 746f 636f 6e66 2069 6e73 7472 s Autoconf instr │ │ │ │ │ -0000d190: 7563 7469 6f6e 7320 746f 2063 7265 6174 uctions to creat │ │ │ │ │ -0000d1a0: 650a 2020 2020 2074 6865 2027 636f 6e66 e. the 'conf │ │ │ │ │ -0000d1b0: 6967 7572 6527 2073 6372 6970 742e 0a0a igure' script... │ │ │ │ │ -0000d1c0: 2020 2020 2020 2020 2020 7e2f 616d 6865 ~/amhe │ │ │ │ │ -0000d1d0: 6c6c 6f20 2520 6361 7420 636f 6e66 6967 llo % cat config │ │ │ │ │ -0000d1e0: 7572 652e 6163 0a20 2020 2020 2020 2020 ure.ac. │ │ │ │ │ -0000d1f0: 2041 435f 494e 4954 285b 616d 6865 6c6c AC_INIT([amhell │ │ │ │ │ -0000d200: 6f5d 2c20 5b31 2e30 5d2c 205b 6275 672d o], [1.0], [bug- │ │ │ │ │ -0000d210: 6175 746f 6d61 6b65 4067 6e75 2e6f 7267 automake@gnu.org │ │ │ │ │ -0000d220: 5d29 0a20 2020 2020 2020 2020 2041 4d5f ]). AM_ │ │ │ │ │ -0000d230: 494e 4954 5f41 5554 4f4d 414b 4528 5b2d INIT_AUTOMAKE([- │ │ │ │ │ -0000d240: 5761 6c6c 202d 5765 7272 6f72 2066 6f72 Wall -Werror for │ │ │ │ │ -0000d250: 6569 676e 5d29 0a20 2020 2020 2020 2020 eign]). │ │ │ │ │ -0000d260: 2041 435f 5052 4f47 5f43 430a 2020 2020 AC_PROG_CC. │ │ │ │ │ -0000d270: 2020 2020 2020 4143 5f43 4f4e 4649 475f AC_CONFIG_ │ │ │ │ │ -0000d280: 4845 4144 4552 5328 5b63 6f6e 6669 672e HEADERS([config. │ │ │ │ │ -0000d290: 685d 290a 2020 2020 2020 2020 2020 4143 h]). AC │ │ │ │ │ -0000d2a0: 5f43 4f4e 4649 475f 4649 4c45 5328 5b0a _CONFIG_FILES([. │ │ │ │ │ -0000d2b0: 2020 2020 2020 2020 2020 204d 616b 6566 Makef │ │ │ │ │ -0000d2c0: 696c 650a 2020 2020 2020 2020 2020 2073 ile. s │ │ │ │ │ -0000d2d0: 7263 2f4d 616b 6566 696c 650a 2020 2020 rc/Makefile. │ │ │ │ │ -0000d2e0: 2020 2020 2020 5d29 0a20 2020 2020 2020 ]). │ │ │ │ │ -0000d2f0: 2020 2041 435f 4f55 5450 5554 0a0a 2020 AC_OUTPUT.. │ │ │ │ │ -0000d300: 204f 6e63 6520 796f 7520 6861 7665 2074 Once you have t │ │ │ │ │ -0000d310: 6865 7365 2066 6976 6520 6669 6c65 732c hese five files, │ │ │ │ │ -0000d320: 2069 7420 6973 2074 696d 6520 746f 2072 it is time to r │ │ │ │ │ -0000d330: 756e 2074 6865 2041 7574 6f74 6f6f 6c73 un the Autotools │ │ │ │ │ -0000d340: 2074 6f0a 696e 7374 616e 7469 6174 6520 to.instantiate │ │ │ │ │ -0000d350: 7468 6520 6275 696c 6420 7379 7374 656d the build system │ │ │ │ │ -0000d360: 2e20 2044 6f20 7468 6973 2075 7369 6e67 . Do this using │ │ │ │ │ -0000d370: 2074 6865 2027 6175 746f 7265 636f 6e66 the 'autoreconf │ │ │ │ │ -0000d380: 2720 636f 6d6d 616e 6420 6173 0a66 6f6c ' command as.fol │ │ │ │ │ -0000d390: 6c6f 7773 3a0a 0a20 2020 2020 7e2f 616d lows:.. ~/am │ │ │ │ │ -0000d3a0: 6865 6c6c 6f20 2520 6175 746f 7265 636f hello % autoreco │ │ │ │ │ -0000d3b0: 6e66 202d 2d69 6e73 7461 6c6c 0a20 2020 nf --install. │ │ │ │ │ -0000d3c0: 2020 636f 6e66 6967 7572 652e 6163 3a20 configure.ac: │ │ │ │ │ -0000d3d0: 696e 7374 616c 6c69 6e67 2060 2e2f 696e installing `./in │ │ │ │ │ -0000d3e0: 7374 616c 6c2d 7368 270a 2020 2020 2063 stall-sh'. c │ │ │ │ │ -0000d3f0: 6f6e 6669 6775 7265 2e61 633a 2069 6e73 onfigure.ac: ins │ │ │ │ │ -0000d400: 7461 6c6c 696e 6720 602e 2f6d 6973 7369 talling `./missi │ │ │ │ │ -0000d410: 6e67 270a 2020 2020 2073 7263 2f4d 616b ng'. src/Mak │ │ │ │ │ -0000d420: 6566 696c 652e 616d 3a20 696e 7374 616c efile.am: instal │ │ │ │ │ -0000d430: 6c69 6e67 2060 2e2f 6465 7063 6f6d 7027 ling `./depcomp' │ │ │ │ │ -0000d440: 0a0a 2020 2041 7420 7468 6973 2070 6f69 .. At this poi │ │ │ │ │ -0000d450: 6e74 2074 6865 2062 7569 6c64 2073 7973 nt the build sys │ │ │ │ │ -0000d460: 7465 6d20 6973 2063 6f6d 706c 6574 652e tem is complete. │ │ │ │ │ -0000d470: 0a0a 2020 2049 6e20 6164 6469 7469 6f6e .. In addition │ │ │ │ │ -0000d480: 2074 6f20 7468 6520 7468 7265 6520 7363 to the three sc │ │ │ │ │ -0000d490: 7269 7074 7320 6d65 6e74 696f 6e65 6420 ripts mentioned │ │ │ │ │ -0000d4a0: 696e 2069 7473 206f 7574 7075 742c 2079 in its output, y │ │ │ │ │ -0000d4b0: 6f75 2063 616e 2073 6565 0a74 6861 7420 ou can see.that │ │ │ │ │ -0000d4c0: 2761 7574 6f72 6563 6f6e 6627 2063 7265 'autoreconf' cre │ │ │ │ │ -0000d4d0: 6174 6564 2066 6f75 7220 6f74 6865 7220 ated four other │ │ │ │ │ -0000d4e0: 6669 6c65 733a 2027 636f 6e66 6967 7572 files: 'configur │ │ │ │ │ -0000d4f0: 6527 2c20 2763 6f6e 6669 672e 682e 696e e', 'config.h.in │ │ │ │ │ -0000d500: 272c 0a27 4d61 6b65 6669 6c65 2e69 6e27 ',.'Makefile.in' │ │ │ │ │ -0000d510: 2c20 616e 6420 2773 7263 2f4d 616b 6566 , and 'src/Makef │ │ │ │ │ -0000d520: 696c 652e 696e 272e 2020 5468 6520 6c61 ile.in'. The la │ │ │ │ │ -0000d530: 7474 6572 2074 6872 6565 2066 696c 6573 tter three files │ │ │ │ │ -0000d540: 2061 7265 0a74 656d 706c 6174 6573 2074 are.templates t │ │ │ │ │ -0000d550: 6861 7420 7769 6c6c 2062 6520 6164 6170 hat will be adap │ │ │ │ │ -0000d560: 7465 6420 746f 2074 6865 2073 7973 7465 ted to the syste │ │ │ │ │ -0000d570: 6d20 6279 2027 636f 6e66 6967 7572 6527 m by 'configure' │ │ │ │ │ -0000d580: 2075 6e64 6572 2074 6865 0a6e 616d 6573 under the.names │ │ │ │ │ -0000d590: 2027 636f 6e66 6967 2e68 272c 2027 4d61 'config.h', 'Ma │ │ │ │ │ -0000d5a0: 6b65 6669 6c65 272c 2061 6e64 2027 7372 kefile', and 'sr │ │ │ │ │ -0000d5b0: 632f 4d61 6b65 6669 6c65 272e 2020 4c65 c/Makefile'. Le │ │ │ │ │ -0000d5c0: 7427 7320 646f 2074 6869 733a 0a0a 2020 t's do this:.. │ │ │ │ │ -0000d5d0: 2020 207e 2f61 6d68 656c 6c6f 2025 202e ~/amhello % . │ │ │ │ │ -0000d5e0: 2f63 6f6e 6669 6775 7265 0a20 2020 2020 /configure. │ │ │ │ │ -0000d5f0: 6368 6563 6b69 6e67 2066 6f72 2061 2042 checking for a B │ │ │ │ │ -0000d600: 5344 2d63 6f6d 7061 7469 626c 6520 696e SD-compatible in │ │ │ │ │ -0000d610: 7374 616c 6c2e 2e2e 202f 7573 722f 6269 stall... /usr/bi │ │ │ │ │ -0000d620: 6e2f 696e 7374 616c 6c20 2d63 0a20 2020 n/install -c. │ │ │ │ │ -0000d630: 2020 6368 6563 6b69 6e67 2077 6865 7468 checking wheth │ │ │ │ │ -0000d640: 6572 2062 7569 6c64 2065 6e76 6972 6f6e er build environ │ │ │ │ │ -0000d650: 6d65 6e74 2069 7320 7361 6e65 2e2e 2e20 ment is sane... │ │ │ │ │ -0000d660: 7965 730a 2020 2020 2063 6865 636b 696e yes. checkin │ │ │ │ │ -0000d670: 6720 666f 7220 6761 776b 2e2e 2e20 6e6f g for gawk... no │ │ │ │ │ -0000d680: 0a20 2020 2020 6368 6563 6b69 6e67 2066 . checking f │ │ │ │ │ -0000d690: 6f72 206d 6177 6b2e 2e2e 206d 6177 6b0a or mawk... mawk. │ │ │ │ │ -0000d6a0: 2020 2020 2063 6865 636b 696e 6720 7768 checking wh │ │ │ │ │ -0000d6b0: 6574 6865 7220 6d61 6b65 2073 6574 7320 ether make sets │ │ │ │ │ -0000d6c0: 2428 4d41 4b45 292e 2e2e 2079 6573 0a20 $(MAKE)... yes. │ │ │ │ │ -0000d6d0: 2020 2020 6368 6563 6b69 6e67 2066 6f72 checking for │ │ │ │ │ -0000d6e0: 2067 6363 2e2e 2e20 6763 630a 2020 2020 gcc... gcc. │ │ │ │ │ -0000d6f0: 2063 6865 636b 696e 6720 666f 7220 4320 checking for C │ │ │ │ │ -0000d700: 636f 6d70 696c 6572 2064 6566 6175 6c74 compiler default │ │ │ │ │ -0000d710: 206f 7574 7075 7420 6669 6c65 206e 616d output file nam │ │ │ │ │ -0000d720: 652e 2e2e 2061 2e6f 7574 0a20 2020 2020 e... a.out. │ │ │ │ │ -0000d730: 6368 6563 6b69 6e67 2077 6865 7468 6572 checking whether │ │ │ │ │ -0000d740: 2074 6865 2043 2063 6f6d 7069 6c65 7220 the C compiler │ │ │ │ │ -0000d750: 776f 726b 732e 2e2e 2079 6573 0a20 2020 works... yes. │ │ │ │ │ -0000d760: 2020 6368 6563 6b69 6e67 2077 6865 7468 checking wheth │ │ │ │ │ -0000d770: 6572 2077 6520 6172 6520 6372 6f73 7320 er we are cross │ │ │ │ │ -0000d780: 636f 6d70 696c 696e 672e 2e2e 206e 6f0a compiling... no. │ │ │ │ │ -0000d790: 2020 2020 2063 6865 636b 696e 6720 666f checking fo │ │ │ │ │ -0000d7a0: 7220 7375 6666 6978 206f 6620 6578 6563 r suffix of exec │ │ │ │ │ -0000d7b0: 7574 6162 6c65 732e 2e2e 0a20 2020 2020 utables.... │ │ │ │ │ -0000d7c0: 6368 6563 6b69 6e67 2066 6f72 2073 7566 checking for suf │ │ │ │ │ -0000d7d0: 6669 7820 6f66 206f 626a 6563 7420 6669 fix of object fi │ │ │ │ │ -0000d7e0: 6c65 732e 2e2e 206f 0a20 2020 2020 6368 les... o. ch │ │ │ │ │ -0000d7f0: 6563 6b69 6e67 2077 6865 7468 6572 2077 ecking whether w │ │ │ │ │ -0000d800: 6520 6172 6520 7573 696e 6720 7468 6520 e are using the │ │ │ │ │ -0000d810: 474e 5520 4320 636f 6d70 696c 6572 2e2e GNU C compiler.. │ │ │ │ │ -0000d820: 2e20 7965 730a 2020 2020 2063 6865 636b . yes. check │ │ │ │ │ -0000d830: 696e 6720 7768 6574 6865 7220 6763 6320 ing whether gcc │ │ │ │ │ -0000d840: 6163 6365 7074 7320 2d67 2e2e 2e20 7965 accepts -g... ye │ │ │ │ │ -0000d850: 730a 2020 2020 2063 6865 636b 696e 6720 s. checking │ │ │ │ │ -0000d860: 666f 7220 6763 6320 6f70 7469 6f6e 2074 for gcc option t │ │ │ │ │ -0000d870: 6f20 6163 6365 7074 2049 534f 2043 3839 o accept ISO C89 │ │ │ │ │ -0000d880: 2e2e 2e20 6e6f 6e65 206e 6565 6465 640a ... none needed. │ │ │ │ │ -0000d890: 2020 2020 2063 6865 636b 696e 6720 666f checking fo │ │ │ │ │ -0000d8a0: 7220 7374 796c 6520 6f66 2069 6e63 6c75 r style of inclu │ │ │ │ │ -0000d8b0: 6465 2075 7365 6420 6279 206d 616b 652e de used by make. │ │ │ │ │ -0000d8c0: 2e2e 2047 4e55 0a20 2020 2020 6368 6563 .. GNU. chec │ │ │ │ │ -0000d8d0: 6b69 6e67 2064 6570 656e 6465 6e63 7920 king dependency │ │ │ │ │ -0000d8e0: 7374 796c 6520 6f66 2067 6363 2e2e 2e20 style of gcc... │ │ │ │ │ -0000d8f0: 6763 6333 0a20 2020 2020 636f 6e66 6967 gcc3. config │ │ │ │ │ -0000d900: 7572 653a 2063 7265 6174 696e 6720 2e2f ure: creating ./ │ │ │ │ │ -0000d910: 636f 6e66 6967 2e73 7461 7475 730a 2020 config.status. │ │ │ │ │ -0000d920: 2020 2063 6f6e 6669 672e 7374 6174 7573 config.status │ │ │ │ │ -0000d930: 3a20 6372 6561 7469 6e67 204d 616b 6566 : creating Makef │ │ │ │ │ -0000d940: 696c 650a 2020 2020 2063 6f6e 6669 672e ile. config. │ │ │ │ │ -0000d950: 7374 6174 7573 3a20 6372 6561 7469 6e67 status: creating │ │ │ │ │ -0000d960: 2073 7263 2f4d 616b 6566 696c 650a 2020 src/Makefile. │ │ │ │ │ -0000d970: 2020 2063 6f6e 6669 672e 7374 6174 7573 config.status │ │ │ │ │ -0000d980: 3a20 6372 6561 7469 6e67 2063 6f6e 6669 : creating confi │ │ │ │ │ -0000d990: 672e 680a 2020 2020 2063 6f6e 6669 672e g.h. config. │ │ │ │ │ -0000d9a0: 7374 6174 7573 3a20 6578 6563 7574 696e status: executin │ │ │ │ │ -0000d9b0: 6720 6465 7066 696c 6573 2063 6f6d 6d61 g depfiles comma │ │ │ │ │ -0000d9c0: 6e64 730a 0a20 2020 596f 7520 6361 6e20 nds.. You can │ │ │ │ │ -0000d9d0: 7365 6520 274d 616b 6566 696c 6527 2c20 see 'Makefile', │ │ │ │ │ -0000d9e0: 2773 7263 2f4d 616b 6566 696c 6527 2c20 'src/Makefile', │ │ │ │ │ -0000d9f0: 616e 6420 2763 6f6e 6669 672e 6827 2062 and 'config.h' b │ │ │ │ │ -0000da00: 6569 6e67 2063 7265 6174 6564 0a61 7420 eing created.at │ │ │ │ │ -0000da10: 7468 6520 656e 6420 6166 7465 7220 2763 the end after 'c │ │ │ │ │ -0000da20: 6f6e 6669 6775 7265 2720 6861 7320 7072 onfigure' has pr │ │ │ │ │ -0000da30: 6f62 6564 2074 6865 2073 7973 7465 6d2e obed the system. │ │ │ │ │ -0000da40: 2020 4974 2069 7320 6e6f 7720 706f 7373 It is now poss │ │ │ │ │ -0000da50: 6962 6c65 0a74 6f20 7275 6e20 616c 6c20 ible.to run all │ │ │ │ │ -0000da60: 7468 6520 7461 7267 6574 7320 7765 2077 the targets we w │ │ │ │ │ -0000da70: 6973 6820 282a 6e6f 7465 2053 7461 6e64 ish (*note Stand │ │ │ │ │ -0000da80: 6172 6420 5461 7267 6574 733a 3a29 2e20 ard Targets::). │ │ │ │ │ -0000da90: 2046 6f72 0a69 6e73 7461 6e63 653a 0a0a For.instance:.. │ │ │ │ │ -0000daa0: 2020 2020 207e 2f61 6d68 656c 6c6f 2025 ~/amhello % │ │ │ │ │ -0000dab0: 206d 616b 650a 2020 2020 202e 2e2e 0a20 make. .... │ │ │ │ │ -0000dac0: 2020 2020 7e2f 616d 6865 6c6c 6f20 2520 ~/amhello % │ │ │ │ │ -0000dad0: 7372 632f 6865 6c6c 6f0a 2020 2020 2048 src/hello. H │ │ │ │ │ -0000dae0: 656c 6c6f 2057 6f72 6c64 210a 2020 2020 ello World!. │ │ │ │ │ -0000daf0: 2054 6869 7320 6973 2061 6d68 656c 6c6f This is amhello │ │ │ │ │ -0000db00: 2031 2e30 2e0a 2020 2020 207e 2f61 6d68 1.0.. ~/amh │ │ │ │ │ -0000db10: 656c 6c6f 2025 206d 616b 6520 6469 7374 ello % make dist │ │ │ │ │ -0000db20: 6368 6563 6b0a 2020 2020 202e 2e2e 0a20 check. .... │ │ │ │ │ -0000db30: 2020 2020 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ============ │ │ │ │ │ +0000cbe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0000cbf0: 0a0a 4865 7265 2069 7320 686f 7720 7765 ..Here is how we │ │ │ │ │ +0000cc00: 2063 616e 2072 6563 7265 6174 6520 2761 can recreate 'a │ │ │ │ │ +0000cc10: 6d68 656c 6c6f 2d31 2e30 2e74 6172 2e67 mhello-1.0.tar.g │ │ │ │ │ +0000cc20: 7a27 2066 726f 6d20 7363 7261 7463 682e z' from scratch. │ │ │ │ │ +0000cc30: 2020 5468 650a 7061 636b 6167 6520 6973 The.package is │ │ │ │ │ +0000cc40: 2073 696d 706c 6520 656e 6f75 6768 2073 simple enough s │ │ │ │ │ +0000cc50: 6f20 7468 6174 2077 6520 7769 6c6c 206f o that we will o │ │ │ │ │ +0000cc60: 6e6c 7920 6e65 6564 2074 6f20 7772 6974 nly need to writ │ │ │ │ │ +0000cc70: 6520 3520 6669 6c65 732e 0a28 596f 7520 e 5 files..(You │ │ │ │ │ +0000cc80: 6d61 7920 636f 7079 2074 6865 6d20 6672 may copy them fr │ │ │ │ │ +0000cc90: 6f6d 2074 6865 2066 696e 616c 2027 616d om the final 'am │ │ │ │ │ +0000cca0: 6865 6c6c 6f2d 312e 302e 7461 722e 677a hello-1.0.tar.gz │ │ │ │ │ +0000ccb0: 2720 7468 6174 2069 730a 6469 7374 7269 ' that is.distri │ │ │ │ │ +0000ccc0: 6275 7465 6420 7769 7468 2041 7574 6f6d buted with Autom │ │ │ │ │ +0000ccd0: 616b 6520 6966 2079 6f75 2064 6f20 6e6f ake if you do no │ │ │ │ │ +0000cce0: 7420 7761 6e74 2074 6f20 7772 6974 6520 t want to write │ │ │ │ │ +0000ccf0: 7468 656d 2e29 0a0a 2020 2043 7265 6174 them.).. Creat │ │ │ │ │ +0000cd00: 6520 7468 6520 666f 6c6c 6f77 696e 6720 e the following │ │ │ │ │ +0000cd10: 6669 6c65 7320 696e 2061 6e20 656d 7074 files in an empt │ │ │ │ │ +0000cd20: 7920 6469 7265 6374 6f72 792e 0a0a 2020 y directory... │ │ │ │ │ +0000cd30: 202a 2027 7372 632f 6d61 696e 2e63 2720 * 'src/main.c' │ │ │ │ │ +0000cd40: 6973 2074 6865 2073 6f75 7263 6520 6669 is the source fi │ │ │ │ │ +0000cd50: 6c65 2066 6f72 2074 6865 2027 6865 6c6c le for the 'hell │ │ │ │ │ +0000cd60: 6f27 2070 726f 6772 616d 2e20 2057 6520 o' program. We │ │ │ │ │ +0000cd70: 7374 6f72 650a 2020 2020 2069 7420 696e store. it in │ │ │ │ │ +0000cd80: 2074 6865 2027 7372 632f 2720 7375 6264 the 'src/' subd │ │ │ │ │ +0000cd90: 6972 6563 746f 7279 2c20 6265 6361 7573 irectory, becaus │ │ │ │ │ +0000cda0: 6520 6c61 7465 722c 2077 6865 6e20 7468 e later, when th │ │ │ │ │ +0000cdb0: 6520 7061 636b 6167 650a 2020 2020 2065 e package. e │ │ │ │ │ +0000cdc0: 766f 6c76 6573 2c20 6974 2077 696c 6c20 volves, it will │ │ │ │ │ +0000cdd0: 6561 7365 2074 6865 2061 6464 6974 696f ease the additio │ │ │ │ │ +0000cde0: 6e20 6f66 2061 2027 6d61 6e2f 2720 6469 n of a 'man/' di │ │ │ │ │ +0000cdf0: 7265 6374 6f72 7920 666f 7220 6d61 6e0a rectory for man. │ │ │ │ │ +0000ce00: 2020 2020 2070 6167 6573 2c20 6120 2764 pages, a 'd │ │ │ │ │ +0000ce10: 6174 612f 2720 6469 7265 6374 6f72 7920 ata/' directory │ │ │ │ │ +0000ce20: 666f 7220 6461 7461 2066 696c 6573 2c20 for data files, │ │ │ │ │ +0000ce30: 6574 632e 0a20 2020 2020 2020 2020 207e etc.. ~ │ │ │ │ │ +0000ce40: 2f61 6d68 656c 6c6f 2025 2063 6174 2073 /amhello % cat s │ │ │ │ │ +0000ce50: 7263 2f6d 6169 6e2e 630a 2020 2020 2020 rc/main.c. │ │ │ │ │ +0000ce60: 2020 2020 2369 6e63 6c75 6465 203c 636f #include . │ │ │ │ │ +0000ce80: 2020 2369 6e63 6c75 6465 203c 7374 6469 #include .. │ │ │ │ │ +0000cea0: 696e 740a 2020 2020 2020 2020 2020 6d61 int. ma │ │ │ │ │ +0000ceb0: 696e 2028 766f 6964 290a 2020 2020 2020 in (void). │ │ │ │ │ +0000cec0: 2020 2020 7b0a 2020 2020 2020 2020 2020 {. │ │ │ │ │ +0000ced0: 2020 7075 7473 2028 2248 656c 6c6f 2057 puts ("Hello W │ │ │ │ │ +0000cee0: 6f72 6c64 2122 293b 0a20 2020 2020 2020 orld!");. │ │ │ │ │ +0000cef0: 2020 2020 2070 7574 7320 2822 5468 6973 puts ("This │ │ │ │ │ +0000cf00: 2069 7320 2220 5041 434b 4147 455f 5354 is " PACKAGE_ST │ │ │ │ │ +0000cf10: 5249 4e47 2022 2e22 293b 0a20 2020 2020 RING ".");. │ │ │ │ │ +0000cf20: 2020 2020 2020 2072 6574 7572 6e20 303b return 0; │ │ │ │ │ +0000cf30: 0a20 2020 2020 2020 2020 207d 0a0a 2020 . }.. │ │ │ │ │ +0000cf40: 202a 2027 5245 4144 4d45 2720 636f 6e74 * 'README' cont │ │ │ │ │ +0000cf50: 6169 6e73 2073 6f6d 6520 7665 7279 206c ains some very l │ │ │ │ │ +0000cf60: 696d 6974 6564 2064 6f63 756d 656e 7461 imited documenta │ │ │ │ │ +0000cf70: 7469 6f6e 2066 6f72 206f 7572 206c 6974 tion for our lit │ │ │ │ │ +0000cf80: 746c 650a 2020 2020 2070 6163 6b61 6765 tle. package │ │ │ │ │ +0000cf90: 2e0a 2020 2020 2020 2020 2020 7e2f 616d .. ~/am │ │ │ │ │ +0000cfa0: 6865 6c6c 6f20 2520 6361 7420 5245 4144 hello % cat READ │ │ │ │ │ +0000cfb0: 4d45 0a20 2020 2020 2020 2020 2054 6869 ME. Thi │ │ │ │ │ +0000cfc0: 7320 6973 2061 2064 656d 6f6e 7374 7261 s is a demonstra │ │ │ │ │ +0000cfd0: 7469 6f6e 2070 6163 6b61 6765 2066 6f72 tion package for │ │ │ │ │ +0000cfe0: 2047 4e55 2041 7574 6f6d 616b 652e 0a20 GNU Automake.. │ │ │ │ │ +0000cff0: 2020 2020 2020 2020 2054 7970 6520 6069 Type `i │ │ │ │ │ +0000d000: 6e66 6f20 4175 746f 6d61 6b65 2720 746f nfo Automake' to │ │ │ │ │ +0000d010: 2072 6561 6420 7468 6520 4175 746f 6d61 read the Automa │ │ │ │ │ +0000d020: 6b65 206d 616e 7561 6c2e 0a0a 2020 202a ke manual... * │ │ │ │ │ +0000d030: 2027 4d61 6b65 6669 6c65 2e61 6d27 2061 'Makefile.am' a │ │ │ │ │ +0000d040: 6e64 2027 7372 632f 4d61 6b65 6669 6c65 nd 'src/Makefile │ │ │ │ │ +0000d050: 2e61 6d27 2063 6f6e 7461 696e 2041 7574 .am' contain Aut │ │ │ │ │ +0000d060: 6f6d 616b 6520 696e 7374 7275 6374 696f omake instructio │ │ │ │ │ +0000d070: 6e73 0a20 2020 2020 666f 7220 7468 6573 ns. for thes │ │ │ │ │ +0000d080: 6520 7477 6f20 6469 7265 6374 6f72 6965 e two directorie │ │ │ │ │ +0000d090: 732e 0a0a 2020 2020 2020 2020 2020 7e2f s... ~/ │ │ │ │ │ +0000d0a0: 616d 6865 6c6c 6f20 2520 6361 7420 7372 amhello % cat sr │ │ │ │ │ +0000d0b0: 632f 4d61 6b65 6669 6c65 2e61 6d0a 2020 c/Makefile.am. │ │ │ │ │ +0000d0c0: 2020 2020 2020 2020 6269 6e5f 5052 4f47 bin_PROG │ │ │ │ │ +0000d0d0: 5241 4d53 203d 2068 656c 6c6f 0a20 2020 RAMS = hello. │ │ │ │ │ +0000d0e0: 2020 2020 2020 2068 656c 6c6f 5f53 4f55 hello_SOU │ │ │ │ │ +0000d0f0: 5243 4553 203d 206d 6169 6e2e 630a 2020 RCES = main.c. │ │ │ │ │ +0000d100: 2020 2020 2020 2020 7e2f 616d 6865 6c6c ~/amhell │ │ │ │ │ +0000d110: 6f20 2520 6361 7420 4d61 6b65 6669 6c65 o % cat Makefile │ │ │ │ │ +0000d120: 2e61 6d0a 2020 2020 2020 2020 2020 5355 .am. SU │ │ │ │ │ +0000d130: 4244 4952 5320 3d20 7372 630a 2020 2020 BDIRS = src. │ │ │ │ │ +0000d140: 2020 2020 2020 6469 7374 5f64 6f63 5f44 dist_doc_D │ │ │ │ │ +0000d150: 4154 4120 3d20 5245 4144 4d45 0a0a 2020 ATA = README.. │ │ │ │ │ +0000d160: 202a 2046 696e 616c 6c79 2c20 2763 6f6e * Finally, 'con │ │ │ │ │ +0000d170: 6669 6775 7265 2e61 6327 2063 6f6e 7461 figure.ac' conta │ │ │ │ │ +0000d180: 696e 7320 4175 746f 636f 6e66 2069 6e73 ins Autoconf ins │ │ │ │ │ +0000d190: 7472 7563 7469 6f6e 7320 746f 2063 7265 tructions to cre │ │ │ │ │ +0000d1a0: 6174 650a 2020 2020 2074 6865 2027 636f ate. the 'co │ │ │ │ │ +0000d1b0: 6e66 6967 7572 6527 2073 6372 6970 742e nfigure' script. │ │ │ │ │ +0000d1c0: 0a0a 2020 2020 2020 2020 2020 7e2f 616d .. ~/am │ │ │ │ │ +0000d1d0: 6865 6c6c 6f20 2520 6361 7420 636f 6e66 hello % cat conf │ │ │ │ │ +0000d1e0: 6967 7572 652e 6163 0a20 2020 2020 2020 igure.ac. │ │ │ │ │ +0000d1f0: 2020 2041 435f 494e 4954 285b 616d 6865 AC_INIT([amhe │ │ │ │ │ +0000d200: 6c6c 6f5d 2c20 5b31 2e30 5d2c 205b 6275 llo], [1.0], [bu │ │ │ │ │ +0000d210: 672d 6175 746f 6d61 6b65 4067 6e75 2e6f g-automake@gnu.o │ │ │ │ │ +0000d220: 7267 5d29 0a20 2020 2020 2020 2020 2041 rg]). A │ │ │ │ │ +0000d230: 4d5f 494e 4954 5f41 5554 4f4d 414b 4528 M_INIT_AUTOMAKE( │ │ │ │ │ +0000d240: 5b2d 5761 6c6c 202d 5765 7272 6f72 2066 [-Wall -Werror f │ │ │ │ │ +0000d250: 6f72 6569 676e 5d29 0a20 2020 2020 2020 oreign]). │ │ │ │ │ +0000d260: 2020 2041 435f 5052 4f47 5f43 430a 2020 AC_PROG_CC. │ │ │ │ │ +0000d270: 2020 2020 2020 2020 4143 5f43 4f4e 4649 AC_CONFI │ │ │ │ │ +0000d280: 475f 4845 4144 4552 5328 5b63 6f6e 6669 G_HEADERS([confi │ │ │ │ │ +0000d290: 672e 685d 290a 2020 2020 2020 2020 2020 g.h]). │ │ │ │ │ +0000d2a0: 4143 5f43 4f4e 4649 475f 4649 4c45 5328 AC_CONFIG_FILES( │ │ │ │ │ +0000d2b0: 5b0a 2020 2020 2020 2020 2020 204d 616b [. Mak │ │ │ │ │ +0000d2c0: 6566 696c 650a 2020 2020 2020 2020 2020 efile. │ │ │ │ │ +0000d2d0: 2073 7263 2f4d 616b 6566 696c 650a 2020 src/Makefile. │ │ │ │ │ +0000d2e0: 2020 2020 2020 2020 5d29 0a20 2020 2020 ]). │ │ │ │ │ +0000d2f0: 2020 2020 2041 435f 4f55 5450 5554 0a0a AC_OUTPUT.. │ │ │ │ │ +0000d300: 2020 204f 6e63 6520 796f 7520 6861 7665 Once you have │ │ │ │ │ +0000d310: 2074 6865 7365 2066 6976 6520 6669 6c65 these five file │ │ │ │ │ +0000d320: 732c 2069 7420 6973 2074 696d 6520 746f s, it is time to │ │ │ │ │ +0000d330: 2072 756e 2074 6865 2041 7574 6f74 6f6f run the Autotoo │ │ │ │ │ +0000d340: 6c73 2074 6f0a 696e 7374 616e 7469 6174 ls to.instantiat │ │ │ │ │ +0000d350: 6520 7468 6520 6275 696c 6420 7379 7374 e the build syst │ │ │ │ │ +0000d360: 656d 2e20 2044 6f20 7468 6973 2075 7369 em. Do this usi │ │ │ │ │ +0000d370: 6e67 2074 6865 2027 6175 746f 7265 636f ng the 'autoreco │ │ │ │ │ +0000d380: 6e66 2720 636f 6d6d 616e 6420 6173 0a66 nf' command as.f │ │ │ │ │ +0000d390: 6f6c 6c6f 7773 3a0a 0a20 2020 2020 7e2f ollows:.. ~/ │ │ │ │ │ +0000d3a0: 616d 6865 6c6c 6f20 2520 6175 746f 7265 amhello % autore │ │ │ │ │ +0000d3b0: 636f 6e66 202d 2d69 6e73 7461 6c6c 0a20 conf --install. │ │ │ │ │ +0000d3c0: 2020 2020 636f 6e66 6967 7572 652e 6163 configure.ac │ │ │ │ │ +0000d3d0: 3a20 696e 7374 616c 6c69 6e67 2060 2e2f : installing `./ │ │ │ │ │ +0000d3e0: 696e 7374 616c 6c2d 7368 270a 2020 2020 install-sh'. │ │ │ │ │ +0000d3f0: 2063 6f6e 6669 6775 7265 2e61 633a 2069 configure.ac: i │ │ │ │ │ +0000d400: 6e73 7461 6c6c 696e 6720 602e 2f6d 6973 nstalling `./mis │ │ │ │ │ +0000d410: 7369 6e67 270a 2020 2020 2073 7263 2f4d sing'. src/M │ │ │ │ │ +0000d420: 616b 6566 696c 652e 616d 3a20 696e 7374 akefile.am: inst │ │ │ │ │ +0000d430: 616c 6c69 6e67 2060 2e2f 6465 7063 6f6d alling `./depcom │ │ │ │ │ +0000d440: 7027 0a0a 2020 2041 7420 7468 6973 2070 p'.. At this p │ │ │ │ │ +0000d450: 6f69 6e74 2074 6865 2062 7569 6c64 2073 oint the build s │ │ │ │ │ +0000d460: 7973 7465 6d20 6973 2063 6f6d 706c 6574 ystem is complet │ │ │ │ │ +0000d470: 652e 0a0a 2020 2049 6e20 6164 6469 7469 e... In additi │ │ │ │ │ +0000d480: 6f6e 2074 6f20 7468 6520 7468 7265 6520 on to the three │ │ │ │ │ +0000d490: 7363 7269 7074 7320 6d65 6e74 696f 6e65 scripts mentione │ │ │ │ │ +0000d4a0: 6420 696e 2069 7473 206f 7574 7075 742c d in its output, │ │ │ │ │ +0000d4b0: 2079 6f75 2063 616e 2073 6565 0a74 6861 you can see.tha │ │ │ │ │ +0000d4c0: 7420 2761 7574 6f72 6563 6f6e 6627 2063 t 'autoreconf' c │ │ │ │ │ +0000d4d0: 7265 6174 6564 2066 6f75 7220 6f74 6865 reated four othe │ │ │ │ │ +0000d4e0: 7220 6669 6c65 733a 2027 636f 6e66 6967 r files: 'config │ │ │ │ │ +0000d4f0: 7572 6527 2c20 2763 6f6e 6669 672e 682e ure', 'config.h. │ │ │ │ │ +0000d500: 696e 272c 0a27 4d61 6b65 6669 6c65 2e69 in',.'Makefile.i │ │ │ │ │ +0000d510: 6e27 2c20 616e 6420 2773 7263 2f4d 616b n', and 'src/Mak │ │ │ │ │ +0000d520: 6566 696c 652e 696e 272e 2020 5468 6520 efile.in'. The │ │ │ │ │ +0000d530: 6c61 7474 6572 2074 6872 6565 2066 696c latter three fil │ │ │ │ │ +0000d540: 6573 2061 7265 0a74 656d 706c 6174 6573 es are.templates │ │ │ │ │ +0000d550: 2074 6861 7420 7769 6c6c 2062 6520 6164 that will be ad │ │ │ │ │ +0000d560: 6170 7465 6420 746f 2074 6865 2073 7973 apted to the sys │ │ │ │ │ +0000d570: 7465 6d20 6279 2027 636f 6e66 6967 7572 tem by 'configur │ │ │ │ │ +0000d580: 6527 2075 6e64 6572 2074 6865 0a6e 616d e' under the.nam │ │ │ │ │ +0000d590: 6573 2027 636f 6e66 6967 2e68 272c 2027 es 'config.h', ' │ │ │ │ │ +0000d5a0: 4d61 6b65 6669 6c65 272c 2061 6e64 2027 Makefile', and ' │ │ │ │ │ +0000d5b0: 7372 632f 4d61 6b65 6669 6c65 272e 2020 src/Makefile'. │ │ │ │ │ +0000d5c0: 4c65 7427 7320 646f 2074 6869 733a 0a0a Let's do this:.. │ │ │ │ │ +0000d5d0: 2020 2020 207e 2f61 6d68 656c 6c6f 2025 ~/amhello % │ │ │ │ │ +0000d5e0: 202e 2f63 6f6e 6669 6775 7265 0a20 2020 ./configure. │ │ │ │ │ +0000d5f0: 2020 6368 6563 6b69 6e67 2066 6f72 2061 checking for a │ │ │ │ │ +0000d600: 2042 5344 2d63 6f6d 7061 7469 626c 6520 BSD-compatible │ │ │ │ │ +0000d610: 696e 7374 616c 6c2e 2e2e 202f 7573 722f install... /usr/ │ │ │ │ │ +0000d620: 6269 6e2f 696e 7374 616c 6c20 2d63 0a20 bin/install -c. │ │ │ │ │ +0000d630: 2020 2020 6368 6563 6b69 6e67 2077 6865 checking whe │ │ │ │ │ +0000d640: 7468 6572 2062 7569 6c64 2065 6e76 6972 ther build envir │ │ │ │ │ +0000d650: 6f6e 6d65 6e74 2069 7320 7361 6e65 2e2e onment is sane.. │ │ │ │ │ +0000d660: 2e20 7965 730a 2020 2020 2063 6865 636b . yes. check │ │ │ │ │ +0000d670: 696e 6720 666f 7220 6761 776b 2e2e 2e20 ing for gawk... │ │ │ │ │ +0000d680: 6e6f 0a20 2020 2020 6368 6563 6b69 6e67 no. checking │ │ │ │ │ +0000d690: 2066 6f72 206d 6177 6b2e 2e2e 206d 6177 for mawk... maw │ │ │ │ │ +0000d6a0: 6b0a 2020 2020 2063 6865 636b 696e 6720 k. checking │ │ │ │ │ +0000d6b0: 7768 6574 6865 7220 6d61 6b65 2073 6574 whether make set │ │ │ │ │ +0000d6c0: 7320 2428 4d41 4b45 292e 2e2e 2079 6573 s $(MAKE)... yes │ │ │ │ │ +0000d6d0: 0a20 2020 2020 6368 6563 6b69 6e67 2066 . checking f │ │ │ │ │ +0000d6e0: 6f72 2067 6363 2e2e 2e20 6763 630a 2020 or gcc... gcc. │ │ │ │ │ +0000d6f0: 2020 2063 6865 636b 696e 6720 666f 7220 checking for │ │ │ │ │ +0000d700: 4320 636f 6d70 696c 6572 2064 6566 6175 C compiler defau │ │ │ │ │ +0000d710: 6c74 206f 7574 7075 7420 6669 6c65 206e lt output file n │ │ │ │ │ +0000d720: 616d 652e 2e2e 2061 2e6f 7574 0a20 2020 ame... a.out. │ │ │ │ │ +0000d730: 2020 6368 6563 6b69 6e67 2077 6865 7468 checking wheth │ │ │ │ │ +0000d740: 6572 2074 6865 2043 2063 6f6d 7069 6c65 er the C compile │ │ │ │ │ +0000d750: 7220 776f 726b 732e 2e2e 2079 6573 0a20 r works... yes. │ │ │ │ │ +0000d760: 2020 2020 6368 6563 6b69 6e67 2077 6865 checking whe │ │ │ │ │ +0000d770: 7468 6572 2077 6520 6172 6520 6372 6f73 ther we are cros │ │ │ │ │ +0000d780: 7320 636f 6d70 696c 696e 672e 2e2e 206e s compiling... n │ │ │ │ │ +0000d790: 6f0a 2020 2020 2063 6865 636b 696e 6720 o. checking │ │ │ │ │ +0000d7a0: 666f 7220 7375 6666 6978 206f 6620 6578 for suffix of ex │ │ │ │ │ +0000d7b0: 6563 7574 6162 6c65 732e 2e2e 0a20 2020 ecutables.... │ │ │ │ │ +0000d7c0: 2020 6368 6563 6b69 6e67 2066 6f72 2073 checking for s │ │ │ │ │ +0000d7d0: 7566 6669 7820 6f66 206f 626a 6563 7420 uffix of object │ │ │ │ │ +0000d7e0: 6669 6c65 732e 2e2e 206f 0a20 2020 2020 files... o. │ │ │ │ │ +0000d7f0: 6368 6563 6b69 6e67 2077 6865 7468 6572 checking whether │ │ │ │ │ +0000d800: 2077 6520 6172 6520 7573 696e 6720 7468 we are using th │ │ │ │ │ +0000d810: 6520 474e 5520 4320 636f 6d70 696c 6572 e GNU C compiler │ │ │ │ │ +0000d820: 2e2e 2e20 7965 730a 2020 2020 2063 6865 ... yes. che │ │ │ │ │ +0000d830: 636b 696e 6720 7768 6574 6865 7220 6763 cking whether gc │ │ │ │ │ +0000d840: 6320 6163 6365 7074 7320 2d67 2e2e 2e20 c accepts -g... │ │ │ │ │ +0000d850: 7965 730a 2020 2020 2063 6865 636b 696e yes. checkin │ │ │ │ │ +0000d860: 6720 666f 7220 6763 6320 6f70 7469 6f6e g for gcc option │ │ │ │ │ +0000d870: 2074 6f20 6163 6365 7074 2049 534f 2043 to accept ISO C │ │ │ │ │ +0000d880: 3839 2e2e 2e20 6e6f 6e65 206e 6565 6465 89... none neede │ │ │ │ │ +0000d890: 640a 2020 2020 2063 6865 636b 696e 6720 d. checking │ │ │ │ │ +0000d8a0: 666f 7220 7374 796c 6520 6f66 2069 6e63 for style of inc │ │ │ │ │ +0000d8b0: 6c75 6465 2075 7365 6420 6279 206d 616b lude used by mak │ │ │ │ │ +0000d8c0: 652e 2e2e 2047 4e55 0a20 2020 2020 6368 e... GNU. ch │ │ │ │ │ +0000d8d0: 6563 6b69 6e67 2064 6570 656e 6465 6e63 ecking dependenc │ │ │ │ │ +0000d8e0: 7920 7374 796c 6520 6f66 2067 6363 2e2e y style of gcc.. │ │ │ │ │ +0000d8f0: 2e20 6763 6333 0a20 2020 2020 636f 6e66 . gcc3. conf │ │ │ │ │ +0000d900: 6967 7572 653a 2063 7265 6174 696e 6720 igure: creating │ │ │ │ │ +0000d910: 2e2f 636f 6e66 6967 2e73 7461 7475 730a ./config.status. │ │ │ │ │ +0000d920: 2020 2020 2063 6f6e 6669 672e 7374 6174 config.stat │ │ │ │ │ +0000d930: 7573 3a20 6372 6561 7469 6e67 204d 616b us: creating Mak │ │ │ │ │ +0000d940: 6566 696c 650a 2020 2020 2063 6f6e 6669 efile. confi │ │ │ │ │ +0000d950: 672e 7374 6174 7573 3a20 6372 6561 7469 g.status: creati │ │ │ │ │ +0000d960: 6e67 2073 7263 2f4d 616b 6566 696c 650a ng src/Makefile. │ │ │ │ │ +0000d970: 2020 2020 2063 6f6e 6669 672e 7374 6174 config.stat │ │ │ │ │ +0000d980: 7573 3a20 6372 6561 7469 6e67 2063 6f6e us: creating con │ │ │ │ │ +0000d990: 6669 672e 680a 2020 2020 2063 6f6e 6669 fig.h. confi │ │ │ │ │ +0000d9a0: 672e 7374 6174 7573 3a20 6578 6563 7574 g.status: execut │ │ │ │ │ +0000d9b0: 696e 6720 6465 7066 696c 6573 2063 6f6d ing depfiles com │ │ │ │ │ +0000d9c0: 6d61 6e64 730a 0a20 2020 596f 7520 6361 mands.. You ca │ │ │ │ │ +0000d9d0: 6e20 7365 6520 274d 616b 6566 696c 6527 n see 'Makefile' │ │ │ │ │ +0000d9e0: 2c20 2773 7263 2f4d 616b 6566 696c 6527 , 'src/Makefile' │ │ │ │ │ +0000d9f0: 2c20 616e 6420 2763 6f6e 6669 672e 6827 , and 'config.h' │ │ │ │ │ +0000da00: 2062 6569 6e67 2063 7265 6174 6564 0a61 being created.a │ │ │ │ │ +0000da10: 7420 7468 6520 656e 6420 6166 7465 7220 t the end after │ │ │ │ │ +0000da20: 2763 6f6e 6669 6775 7265 2720 6861 7320 'configure' has │ │ │ │ │ +0000da30: 7072 6f62 6564 2074 6865 2073 7973 7465 probed the syste │ │ │ │ │ +0000da40: 6d2e 2020 4974 2069 7320 6e6f 7720 706f m. It is now po │ │ │ │ │ +0000da50: 7373 6962 6c65 0a74 6f20 7275 6e20 616c ssible.to run al │ │ │ │ │ +0000da60: 6c20 7468 6520 7461 7267 6574 7320 7765 l the targets we │ │ │ │ │ +0000da70: 2077 6973 6820 282a 6e6f 7465 2053 7461 wish (*note Sta │ │ │ │ │ +0000da80: 6e64 6172 6420 5461 7267 6574 733a 3a29 ndard Targets::) │ │ │ │ │ +0000da90: 2e20 2046 6f72 0a69 6e73 7461 6e63 653a . For.instance: │ │ │ │ │ +0000daa0: 0a0a 2020 2020 207e 2f61 6d68 656c 6c6f .. ~/amhello │ │ │ │ │ +0000dab0: 2025 206d 616b 650a 2020 2020 202e 2e2e % make. ... │ │ │ │ │ +0000dac0: 0a20 2020 2020 7e2f 616d 6865 6c6c 6f20 . ~/amhello │ │ │ │ │ +0000dad0: 2520 7372 632f 6865 6c6c 6f0a 2020 2020 % src/hello. │ │ │ │ │ +0000dae0: 2048 656c 6c6f 2057 6f72 6c64 210a 2020 Hello World!. │ │ │ │ │ +0000daf0: 2020 2054 6869 7320 6973 2061 6d68 656c This is amhel │ │ │ │ │ +0000db00: 6c6f 2031 2e30 2e0a 2020 2020 207e 2f61 lo 1.0.. ~/a │ │ │ │ │ +0000db10: 6d68 656c 6c6f 2025 206d 616b 6520 6469 mhello % make di │ │ │ │ │ +0000db20: 7374 6368 6563 6b0a 2020 2020 202e 2e2e stcheck. ... │ │ │ │ │ +0000db30: 0a20 2020 2020 3d3d 3d3d 3d3d 3d3d 3d3d . ========== │ │ │ │ │ 0000db40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0000db50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000db60: 3d0a 2020 2020 2061 6d68 656c 6c6f 2d31 =. amhello-1 │ │ │ │ │ -0000db70: 2e30 2061 7263 6869 7665 7320 7265 6164 .0 archives read │ │ │ │ │ -0000db80: 7920 666f 7220 6469 7374 7269 6275 7469 y for distributi │ │ │ │ │ -0000db90: 6f6e 3a0a 2020 2020 2061 6d68 656c 6c6f on:. amhello │ │ │ │ │ -0000dba0: 2d31 2e30 2e74 6172 2e67 7a0a 2020 2020 -1.0.tar.gz. │ │ │ │ │ -0000dbb0: 203d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d =============== │ │ │ │ │ +0000db60: 3d3d 3d0a 2020 2020 2061 6d68 656c 6c6f ===. amhello │ │ │ │ │ +0000db70: 2d31 2e30 2061 7263 6869 7665 7320 7265 -1.0 archives re │ │ │ │ │ +0000db80: 6164 7920 666f 7220 6469 7374 7269 6275 ady for distribu │ │ │ │ │ +0000db90: 7469 6f6e 3a0a 2020 2020 2061 6d68 656c tion:. amhel │ │ │ │ │ +0000dba0: 6c6f 2d31 2e30 2e74 6172 2e67 7a0a 2020 lo-1.0.tar.gz. │ │ │ │ │ +0000dbb0: 2020 203d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ============= │ │ │ │ │ 0000dbc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000dbd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -0000dbe0: 2020 204e 6f74 6520 7468 6174 2072 756e Note that run │ │ │ │ │ -0000dbf0: 6e69 6e67 2027 6175 746f 7265 636f 6e66 ning 'autoreconf │ │ │ │ │ -0000dc00: 2720 6973 206f 6e6c 7920 6e65 6564 6564 ' is only needed │ │ │ │ │ -0000dc10: 2069 6e69 7469 616c 6c79 2077 6865 6e20 initially when │ │ │ │ │ -0000dc20: 7468 6520 474e 550a 4275 696c 6420 5379 the GNU.Build Sy │ │ │ │ │ -0000dc30: 7374 656d 2064 6f65 7320 6e6f 7420 6578 stem does not ex │ │ │ │ │ -0000dc40: 6973 742e 2020 5768 656e 2079 6f75 206c ist. When you l │ │ │ │ │ -0000dc50: 6174 6572 2063 6861 6e67 6520 736f 6d65 ater change some │ │ │ │ │ -0000dc60: 2069 6e73 7472 7563 7469 6f6e 7320 696e instructions in │ │ │ │ │ -0000dc70: 0a61 2027 4d61 6b65 6669 6c65 2e61 6d27 .a 'Makefile.am' │ │ │ │ │ -0000dc80: 206f 7220 2763 6f6e 6669 6775 7265 2e61 or 'configure.a │ │ │ │ │ -0000dc90: 6327 2c20 7468 6520 7265 6c65 7661 6e74 c', the relevant │ │ │ │ │ -0000dca0: 2070 6172 7420 6f66 2074 6865 2062 7569 part of the bui │ │ │ │ │ -0000dcb0: 6c64 2073 7973 7465 6d0a 7769 6c6c 2062 ld system.will b │ │ │ │ │ -0000dcc0: 6520 7265 6765 6e65 7261 7465 6420 6175 e regenerated au │ │ │ │ │ -0000dcd0: 746f 6d61 7469 6361 6c6c 7920 7768 656e tomatically when │ │ │ │ │ -0000dce0: 2079 6f75 2065 7865 6375 7465 2027 6d61 you execute 'ma │ │ │ │ │ -0000dcf0: 6b65 272e 0a0a 2020 2027 6175 746f 7265 ke'... 'autore │ │ │ │ │ -0000dd00: 636f 6e66 2720 6973 2061 2073 6372 6970 conf' is a scrip │ │ │ │ │ -0000dd10: 7420 7468 6174 2063 616c 6c73 2027 6175 t that calls 'au │ │ │ │ │ -0000dd20: 746f 636f 6e66 272c 2027 6175 746f 6d61 toconf', 'automa │ │ │ │ │ -0000dd30: 6b65 272c 2061 6e64 2061 0a62 756e 6368 ke', and a.bunch │ │ │ │ │ -0000dd40: 206f 6620 6f74 6865 7220 636f 6d6d 616e of other comman │ │ │ │ │ -0000dd50: 6473 2069 6e20 7468 6520 7269 6768 7420 ds in the right │ │ │ │ │ -0000dd60: 6f72 6465 722e 2020 4966 2079 6f75 2061 order. If you a │ │ │ │ │ -0000dd70: 7265 2062 6567 696e 6e69 6e67 2077 6974 re beginning wit │ │ │ │ │ -0000dd80: 680a 7468 6573 6520 746f 6f6c 732c 2069 h.these tools, i │ │ │ │ │ -0000dd90: 7420 6973 206e 6f74 2069 6d70 6f72 7461 t is not importa │ │ │ │ │ -0000dda0: 6e74 2074 6f20 6669 6775 7265 206f 7574 nt to figure out │ │ │ │ │ -0000ddb0: 2069 6e20 7768 6963 6820 6f72 6465 7220 in which order │ │ │ │ │ -0000ddc0: 616c 6c20 7468 6573 650a 746f 6f6c 7320 all these.tools │ │ │ │ │ -0000ddd0: 7368 6f75 6c64 2062 6520 696e 766f 6b65 should be invoke │ │ │ │ │ -0000dde0: 6420 616e 6420 7768 792e 2020 486f 7765 d and why. Howe │ │ │ │ │ -0000ddf0: 7665 722c 2062 6563 6175 7365 2041 7574 ver, because Aut │ │ │ │ │ -0000de00: 6f63 6f6e 6620 616e 6420 4175 746f 6d61 oconf and Automa │ │ │ │ │ -0000de10: 6b65 0a68 6176 6520 7365 7061 7261 7465 ke.have separate │ │ │ │ │ -0000de20: 206d 616e 7561 6c73 2c20 7468 6520 696d manuals, the im │ │ │ │ │ -0000de30: 706f 7274 616e 7420 706f 696e 7420 746f portant point to │ │ │ │ │ -0000de40: 2075 6e64 6572 7374 616e 6420 6973 2074 understand is t │ │ │ │ │ -0000de50: 6861 740a 2761 7574 6f63 6f6e 6627 2069 hat.'autoconf' i │ │ │ │ │ -0000de60: 7320 696e 2063 6861 7267 6520 6f66 2063 s in charge of c │ │ │ │ │ -0000de70: 7265 6174 696e 6720 2763 6f6e 6669 6775 reating 'configu │ │ │ │ │ -0000de80: 7265 2720 6672 6f6d 2027 636f 6e66 6967 re' from 'config │ │ │ │ │ -0000de90: 7572 652e 6163 272c 0a77 6869 6c65 2027 ure.ac',.while ' │ │ │ │ │ -0000dea0: 6175 746f 6d61 6b65 2720 6973 2069 6e20 automake' is in │ │ │ │ │ -0000deb0: 6368 6172 6765 206f 6620 6372 6561 7469 charge of creati │ │ │ │ │ -0000dec0: 6e67 2027 4d61 6b65 6669 6c65 2e69 6e27 ng 'Makefile.in' │ │ │ │ │ -0000ded0: 7320 6672 6f6d 0a27 4d61 6b65 6669 6c65 s from.'Makefile │ │ │ │ │ -0000dee0: 2e61 6d27 7320 616e 6420 2763 6f6e 6669 .am's and 'confi │ │ │ │ │ -0000def0: 6775 7265 2e61 6327 2e20 2054 6869 7320 gure.ac'. This │ │ │ │ │ -0000df00: 7368 6f75 6c64 2061 7420 6c65 6173 7420 should at least │ │ │ │ │ -0000df10: 6469 7265 6374 2079 6f75 2074 6f0a 7468 direct you to.th │ │ │ │ │ -0000df20: 6520 7269 6768 7420 6d61 6e75 616c 2077 e right manual w │ │ │ │ │ -0000df30: 6865 6e20 7365 656b 696e 6720 616e 7377 hen seeking answ │ │ │ │ │ -0000df40: 6572 732e 0a0a 1f0a 4669 6c65 3a20 6175 ers.....File: au │ │ │ │ │ -0000df50: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -0000df60: 2c20 204e 6f64 653a 2061 6d68 656c 6c6f , Node: amhello │ │ │ │ │ -0000df70: 2773 2063 6f6e 6669 6775 7265 2e61 6320 's configure.ac │ │ │ │ │ -0000df80: 5365 7475 7020 4578 706c 6169 6e65 642c Setup Explained, │ │ │ │ │ -0000df90: 2020 4e65 7874 3a20 616d 6865 6c6c 6f27 Next: amhello' │ │ │ │ │ -0000dfa0: 7320 4d61 6b65 6669 6c65 2e61 6d20 5365 s Makefile.am Se │ │ │ │ │ -0000dfb0: 7475 7020 4578 706c 6169 6e65 642c 2020 tup Explained, │ │ │ │ │ -0000dfc0: 5072 6576 3a20 4372 6561 7469 6e67 2061 Prev: Creating a │ │ │ │ │ -0000dfd0: 6d68 656c 6c6f 2c20 2055 703a 2048 656c mhello, Up: Hel │ │ │ │ │ -0000dfe0: 6c6f 2057 6f72 6c64 0a0a 322e 342e 3220 lo World..2.4.2 │ │ │ │ │ -0000dff0: 2761 6d68 656c 6c6f 2727 7320 2763 6f6e 'amhello''s 'con │ │ │ │ │ -0000e000: 6669 6775 7265 2e61 6327 2053 6574 7570 figure.ac' Setup │ │ │ │ │ -0000e010: 2045 7870 6c61 696e 6564 0a2d 2d2d 2d2d Explained.----- │ │ │ │ │ +0000dbd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0000dbe0: 0a0a 2020 204e 6f74 6520 7468 6174 2072 .. Note that r │ │ │ │ │ +0000dbf0: 756e 6e69 6e67 2027 6175 746f 7265 636f unning 'autoreco │ │ │ │ │ +0000dc00: 6e66 2720 6973 206f 6e6c 7920 6e65 6564 nf' is only need │ │ │ │ │ +0000dc10: 6564 2069 6e69 7469 616c 6c79 2077 6865 ed initially whe │ │ │ │ │ +0000dc20: 6e20 7468 6520 474e 550a 4275 696c 6420 n the GNU.Build │ │ │ │ │ +0000dc30: 5379 7374 656d 2064 6f65 7320 6e6f 7420 System does not │ │ │ │ │ +0000dc40: 6578 6973 742e 2020 5768 656e 2079 6f75 exist. When you │ │ │ │ │ +0000dc50: 206c 6174 6572 2063 6861 6e67 6520 736f later change so │ │ │ │ │ +0000dc60: 6d65 2069 6e73 7472 7563 7469 6f6e 7320 me instructions │ │ │ │ │ +0000dc70: 696e 0a61 2027 4d61 6b65 6669 6c65 2e61 in.a 'Makefile.a │ │ │ │ │ +0000dc80: 6d27 206f 7220 2763 6f6e 6669 6775 7265 m' or 'configure │ │ │ │ │ +0000dc90: 2e61 6327 2c20 7468 6520 7265 6c65 7661 .ac', the releva │ │ │ │ │ +0000dca0: 6e74 2070 6172 7420 6f66 2074 6865 2062 nt part of the b │ │ │ │ │ +0000dcb0: 7569 6c64 2073 7973 7465 6d0a 7769 6c6c uild system.will │ │ │ │ │ +0000dcc0: 2062 6520 7265 6765 6e65 7261 7465 6420 be regenerated │ │ │ │ │ +0000dcd0: 6175 746f 6d61 7469 6361 6c6c 7920 7768 automatically wh │ │ │ │ │ +0000dce0: 656e 2079 6f75 2065 7865 6375 7465 2027 en you execute ' │ │ │ │ │ +0000dcf0: 6d61 6b65 272e 0a0a 2020 2027 6175 746f make'... 'auto │ │ │ │ │ +0000dd00: 7265 636f 6e66 2720 6973 2061 2073 6372 reconf' is a scr │ │ │ │ │ +0000dd10: 6970 7420 7468 6174 2063 616c 6c73 2027 ipt that calls ' │ │ │ │ │ +0000dd20: 6175 746f 636f 6e66 272c 2027 6175 746f autoconf', 'auto │ │ │ │ │ +0000dd30: 6d61 6b65 272c 2061 6e64 2061 0a62 756e make', and a.bun │ │ │ │ │ +0000dd40: 6368 206f 6620 6f74 6865 7220 636f 6d6d ch of other comm │ │ │ │ │ +0000dd50: 616e 6473 2069 6e20 7468 6520 7269 6768 ands in the righ │ │ │ │ │ +0000dd60: 7420 6f72 6465 722e 2020 4966 2079 6f75 t order. If you │ │ │ │ │ +0000dd70: 2061 7265 2062 6567 696e 6e69 6e67 2077 are beginning w │ │ │ │ │ +0000dd80: 6974 680a 7468 6573 6520 746f 6f6c 732c ith.these tools, │ │ │ │ │ +0000dd90: 2069 7420 6973 206e 6f74 2069 6d70 6f72 it is not impor │ │ │ │ │ +0000dda0: 7461 6e74 2074 6f20 6669 6775 7265 206f tant to figure o │ │ │ │ │ +0000ddb0: 7574 2069 6e20 7768 6963 6820 6f72 6465 ut in which orde │ │ │ │ │ +0000ddc0: 7220 616c 6c20 7468 6573 650a 746f 6f6c r all these.tool │ │ │ │ │ +0000ddd0: 7320 7368 6f75 6c64 2062 6520 696e 766f s should be invo │ │ │ │ │ +0000dde0: 6b65 6420 616e 6420 7768 792e 2020 486f ked and why. Ho │ │ │ │ │ +0000ddf0: 7765 7665 722c 2062 6563 6175 7365 2041 wever, because A │ │ │ │ │ +0000de00: 7574 6f63 6f6e 6620 616e 6420 4175 746f utoconf and Auto │ │ │ │ │ +0000de10: 6d61 6b65 0a68 6176 6520 7365 7061 7261 make.have separa │ │ │ │ │ +0000de20: 7465 206d 616e 7561 6c73 2c20 7468 6520 te manuals, the │ │ │ │ │ +0000de30: 696d 706f 7274 616e 7420 706f 696e 7420 important point │ │ │ │ │ +0000de40: 746f 2075 6e64 6572 7374 616e 6420 6973 to understand is │ │ │ │ │ +0000de50: 2074 6861 740a 2761 7574 6f63 6f6e 6627 that.'autoconf' │ │ │ │ │ +0000de60: 2069 7320 696e 2063 6861 7267 6520 6f66 is in charge of │ │ │ │ │ +0000de70: 2063 7265 6174 696e 6720 2763 6f6e 6669 creating 'confi │ │ │ │ │ +0000de80: 6775 7265 2720 6672 6f6d 2027 636f 6e66 gure' from 'conf │ │ │ │ │ +0000de90: 6967 7572 652e 6163 272c 0a77 6869 6c65 igure.ac',.while │ │ │ │ │ +0000dea0: 2027 6175 746f 6d61 6b65 2720 6973 2069 'automake' is i │ │ │ │ │ +0000deb0: 6e20 6368 6172 6765 206f 6620 6372 6561 n charge of crea │ │ │ │ │ +0000dec0: 7469 6e67 2027 4d61 6b65 6669 6c65 2e69 ting 'Makefile.i │ │ │ │ │ +0000ded0: 6e27 7320 6672 6f6d 0a27 4d61 6b65 6669 n's from.'Makefi │ │ │ │ │ +0000dee0: 6c65 2e61 6d27 7320 616e 6420 2763 6f6e le.am's and 'con │ │ │ │ │ +0000def0: 6669 6775 7265 2e61 6327 2e20 2054 6869 figure.ac'. Thi │ │ │ │ │ +0000df00: 7320 7368 6f75 6c64 2061 7420 6c65 6173 s should at leas │ │ │ │ │ +0000df10: 7420 6469 7265 6374 2079 6f75 2074 6f0a t direct you to. │ │ │ │ │ +0000df20: 7468 6520 7269 6768 7420 6d61 6e75 616c the right manual │ │ │ │ │ +0000df30: 2077 6865 6e20 7365 656b 696e 6720 616e when seeking an │ │ │ │ │ +0000df40: 7377 6572 732e 0a0a 1f0a 4669 6c65 3a20 swers.....File: │ │ │ │ │ +0000df50: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +0000df60: 666f 2c20 204e 6f64 653a 2061 6d68 656c fo, Node: amhel │ │ │ │ │ +0000df70: 6c6f 2773 2063 6f6e 6669 6775 7265 2e61 lo's configure.a │ │ │ │ │ +0000df80: 6320 5365 7475 7020 4578 706c 6169 6e65 c Setup Explaine │ │ │ │ │ +0000df90: 642c 2020 4e65 7874 3a20 616d 6865 6c6c d, Next: amhell │ │ │ │ │ +0000dfa0: 6f27 7320 4d61 6b65 6669 6c65 2e61 6d20 o's Makefile.am │ │ │ │ │ +0000dfb0: 5365 7475 7020 4578 706c 6169 6e65 642c Setup Explained, │ │ │ │ │ +0000dfc0: 2020 5072 6576 3a20 4372 6561 7469 6e67 Prev: Creating │ │ │ │ │ +0000dfd0: 2061 6d68 656c 6c6f 2c20 2055 703a 2048 amhello, Up: H │ │ │ │ │ +0000dfe0: 656c 6c6f 2057 6f72 6c64 0a0a 322e 342e ello World..2.4. │ │ │ │ │ +0000dff0: 3220 2761 6d68 656c 6c6f 2727 7320 2763 2 'amhello''s 'c │ │ │ │ │ +0000e000: 6f6e 6669 6775 7265 2e61 6327 2053 6574 onfigure.ac' Set │ │ │ │ │ +0000e010: 7570 2045 7870 6c61 696e 6564 0a2d 2d2d up Explained.--- │ │ │ │ │ 0000e020: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000e030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000e040: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a4c 6574 -----------..Let │ │ │ │ │ -0000e050: 2075 7320 6265 6769 6e20 7769 7468 2074 us begin with t │ │ │ │ │ -0000e060: 6865 2063 6f6e 7465 6e74 7320 6f66 2027 he contents of ' │ │ │ │ │ -0000e070: 636f 6e66 6967 7572 652e 6163 272e 0a0a configure.ac'... │ │ │ │ │ -0000e080: 2020 2020 2041 435f 494e 4954 285b 616d AC_INIT([am │ │ │ │ │ -0000e090: 6865 6c6c 6f5d 2c20 5b31 2e30 5d2c 205b hello], [1.0], [ │ │ │ │ │ -0000e0a0: 6275 672d 6175 746f 6d61 6b65 4067 6e75 bug-automake@gnu │ │ │ │ │ -0000e0b0: 2e6f 7267 5d29 0a20 2020 2020 414d 5f49 .org]). AM_I │ │ │ │ │ -0000e0c0: 4e49 545f 4155 544f 4d41 4b45 285b 2d57 NIT_AUTOMAKE([-W │ │ │ │ │ -0000e0d0: 616c 6c20 2d57 6572 726f 7220 666f 7265 all -Werror fore │ │ │ │ │ -0000e0e0: 6967 6e5d 290a 2020 2020 2041 435f 5052 ign]). AC_PR │ │ │ │ │ -0000e0f0: 4f47 5f43 430a 2020 2020 2041 435f 434f OG_CC. AC_CO │ │ │ │ │ -0000e100: 4e46 4947 5f48 4541 4445 5253 285b 636f NFIG_HEADERS([co │ │ │ │ │ -0000e110: 6e66 6967 2e68 5d29 0a20 2020 2020 4143 nfig.h]). AC │ │ │ │ │ -0000e120: 5f43 4f4e 4649 475f 4649 4c45 5328 5b0a _CONFIG_FILES([. │ │ │ │ │ -0000e130: 2020 2020 2020 4d61 6b65 6669 6c65 0a20 Makefile. │ │ │ │ │ -0000e140: 2020 2020 2073 7263 2f4d 616b 6566 696c src/Makefil │ │ │ │ │ -0000e150: 650a 2020 2020 205d 290a 2020 2020 2041 e. ]). A │ │ │ │ │ -0000e160: 435f 4f55 5450 5554 0a0a 2020 2054 6869 C_OUTPUT.. Thi │ │ │ │ │ -0000e170: 7320 6669 6c65 2069 7320 7265 6164 2062 s file is read b │ │ │ │ │ -0000e180: 7920 626f 7468 2027 6175 746f 636f 6e66 y both 'autoconf │ │ │ │ │ -0000e190: 2720 2874 6f20 6372 6561 7465 2027 636f ' (to create 'co │ │ │ │ │ -0000e1a0: 6e66 6967 7572 6527 2920 616e 640a 2761 nfigure') and.'a │ │ │ │ │ -0000e1b0: 7574 6f6d 616b 6527 2028 746f 2063 7265 utomake' (to cre │ │ │ │ │ -0000e1c0: 6174 6520 7468 6520 7661 7269 6f75 7320 ate the various │ │ │ │ │ -0000e1d0: 274d 616b 6566 696c 652e 696e 2773 292e 'Makefile.in's). │ │ │ │ │ -0000e1e0: 2020 4974 2063 6f6e 7461 696e 7320 6120 It contains a │ │ │ │ │ -0000e1f0: 7365 7269 6573 0a6f 6620 4d34 206d 6163 series.of M4 mac │ │ │ │ │ -0000e200: 726f 7320 7468 6174 2077 696c 6c20 6265 ros that will be │ │ │ │ │ -0000e210: 2065 7870 616e 6465 6420 6173 2073 6865 expanded as she │ │ │ │ │ -0000e220: 6c6c 2063 6f64 6520 746f 2066 696e 616c ll code to final │ │ │ │ │ -0000e230: 6c79 2066 6f72 6d20 7468 650a 2763 6f6e ly form the.'con │ │ │ │ │ -0000e240: 6669 6775 7265 2720 7363 7269 7074 2e20 figure' script. │ │ │ │ │ -0000e250: 2057 6520 7769 6c6c 206e 6f74 2065 6c61 We will not ela │ │ │ │ │ -0000e260: 626f 7261 7465 206f 6e20 7468 6520 7379 borate on the sy │ │ │ │ │ -0000e270: 6e74 6178 206f 6620 7468 6973 2066 696c ntax of this fil │ │ │ │ │ -0000e280: 652c 0a62 6563 6175 7365 2074 6865 2041 e,.because the A │ │ │ │ │ -0000e290: 7574 6f63 6f6e 6620 6d61 6e75 616c 2068 utoconf manual h │ │ │ │ │ -0000e2a0: 6173 2061 2077 686f 6c65 2073 6563 7469 as a whole secti │ │ │ │ │ -0000e2b0: 6f6e 2061 626f 7574 2069 7420 282a 6e6f on about it (*no │ │ │ │ │ -0000e2c0: 7465 2057 7269 7469 6e67 0a27 636f 6e66 te Writing.'conf │ │ │ │ │ -0000e2d0: 6967 7572 652e 6163 273a 2028 6175 746f igure.ac': (auto │ │ │ │ │ -0000e2e0: 636f 6e66 2957 7269 7469 6e67 2041 7574 conf)Writing Aut │ │ │ │ │ -0000e2f0: 6f63 6f6e 6620 496e 7075 742e 292e 0a0a oconf Input.)... │ │ │ │ │ -0000e300: 2020 2054 6865 206d 6163 726f 7320 7072 The macros pr │ │ │ │ │ -0000e310: 6566 6978 6564 2077 6974 6820 2741 435f efixed with 'AC_ │ │ │ │ │ -0000e320: 2720 6172 6520 4175 746f 636f 6e66 206d ' are Autoconf m │ │ │ │ │ -0000e330: 6163 726f 732c 2064 6f63 756d 656e 7465 acros, documente │ │ │ │ │ -0000e340: 6420 696e 2074 6865 0a41 7574 6f63 6f6e d in the.Autocon │ │ │ │ │ -0000e350: 6620 6d61 6e75 616c 2028 2a6e 6f74 6520 f manual (*note │ │ │ │ │ -0000e360: 4175 746f 636f 6e66 204d 6163 726f 2049 Autoconf Macro I │ │ │ │ │ -0000e370: 6e64 6578 3a20 2861 7574 6f63 6f6e 6629 ndex: (autoconf) │ │ │ │ │ -0000e380: 4175 746f 636f 6e66 204d 6163 726f 0a49 Autoconf Macro.I │ │ │ │ │ -0000e390: 6e64 6578 2e29 2e20 2054 6865 206d 6163 ndex.). The mac │ │ │ │ │ -0000e3a0: 726f 7320 7468 6174 2073 7461 7274 2077 ros that start w │ │ │ │ │ -0000e3b0: 6974 6820 2741 4d5f 2720 6172 6520 4175 ith 'AM_' are Au │ │ │ │ │ -0000e3c0: 746f 6d61 6b65 206d 6163 726f 732c 0a64 tomake macros,.d │ │ │ │ │ -0000e3d0: 6f63 756d 656e 7465 6420 6c61 7465 7220 ocumented later │ │ │ │ │ -0000e3e0: 696e 2074 6869 7320 6d61 6e75 616c 2028 in this manual ( │ │ │ │ │ -0000e3f0: 2a6e 6f74 6520 4d61 6372 6f20 496e 6465 *note Macro Inde │ │ │ │ │ -0000e400: 783a 3a29 2e0a 0a20 2020 5468 6520 6669 x::)... The fi │ │ │ │ │ -0000e410: 7273 7420 7477 6f20 6c69 6e65 7320 6f66 rst two lines of │ │ │ │ │ -0000e420: 2027 636f 6e66 6967 7572 652e 6163 2720 'configure.ac' │ │ │ │ │ -0000e430: 696e 6974 6961 6c69 7a65 2041 7574 6f63 initialize Autoc │ │ │ │ │ -0000e440: 6f6e 6620 616e 640a 4175 746f 6d61 6b65 onf and.Automake │ │ │ │ │ -0000e450: 2e20 2027 4143 5f49 4e49 5427 2074 616b . 'AC_INIT' tak │ │ │ │ │ -0000e460: 6573 2069 6e20 6173 2070 6172 616d 6574 es in as paramet │ │ │ │ │ -0000e470: 6572 7320 7468 6520 6e61 6d65 206f 6620 ers the name of │ │ │ │ │ -0000e480: 7468 6520 7061 636b 6167 652c 2069 7473 the package, its │ │ │ │ │ -0000e490: 0a76 6572 7369 6f6e 206e 756d 6265 722c .version number, │ │ │ │ │ -0000e4a0: 2061 6e64 2061 2063 6f6e 7461 6374 2061 and a contact a │ │ │ │ │ -0000e4b0: 6464 7265 7373 2066 6f72 2062 7567 2d72 ddress for bug-r │ │ │ │ │ -0000e4c0: 6570 6f72 7473 2061 626f 7574 2074 6865 eports about the │ │ │ │ │ -0000e4d0: 2070 6163 6b61 6765 0a28 7468 6973 2061 package.(this a │ │ │ │ │ -0000e4e0: 6464 7265 7373 2069 7320 6f75 7470 7574 ddress is output │ │ │ │ │ -0000e4f0: 2061 7420 7468 6520 656e 6420 6f66 2027 at the end of ' │ │ │ │ │ -0000e500: 2e2f 636f 6e66 6967 7572 6520 2d2d 6865 ./configure --he │ │ │ │ │ -0000e510: 6c70 272c 2066 6f72 0a69 6e73 7461 6e63 lp', for.instanc │ │ │ │ │ -0000e520: 6529 2e20 2057 6865 6e20 6164 6170 7469 e). When adapti │ │ │ │ │ -0000e530: 6e67 2074 6869 7320 7365 7475 7020 746f ng this setup to │ │ │ │ │ -0000e540: 2079 6f75 7220 6f77 6e20 7061 636b 6167 your own packag │ │ │ │ │ -0000e550: 652c 2062 7920 616c 6c20 6d65 616e 730a e, by all means. │ │ │ │ │ -0000e560: 706c 6561 7365 2064 6f20 6e6f 7420 626c please do not bl │ │ │ │ │ -0000e570: 696e 646c 7920 636f 7079 2041 7574 6f6d indly copy Autom │ │ │ │ │ -0000e580: 616b 6527 7320 6164 6472 6573 733a 2075 ake's address: u │ │ │ │ │ -0000e590: 7365 2074 6865 206d 6169 6c69 6e67 206c se the mailing l │ │ │ │ │ -0000e5a0: 6973 7420 6f66 0a79 6f75 7220 7061 636b ist of.your pack │ │ │ │ │ -0000e5b0: 6167 652c 206f 7220 796f 7572 206f 776e age, or your own │ │ │ │ │ -0000e5c0: 206d 6169 6c20 6164 6472 6573 732e 0a0a mail address... │ │ │ │ │ -0000e5d0: 2020 2054 6865 2061 7267 756d 656e 7420 The argument │ │ │ │ │ -0000e5e0: 746f 2027 414d 5f49 4e49 545f 4155 544f to 'AM_INIT_AUTO │ │ │ │ │ -0000e5f0: 4d41 4b45 2720 6973 2061 206c 6973 7420 MAKE' is a list │ │ │ │ │ -0000e600: 6f66 206f 7074 696f 6e73 2066 6f72 0a27 of options for.' │ │ │ │ │ -0000e610: 6175 746f 6d61 6b65 2720 282a 6e6f 7465 automake' (*note │ │ │ │ │ -0000e620: 204f 7074 696f 6e73 3a3a 292e 2020 272d Options::). '- │ │ │ │ │ -0000e630: 5761 6c6c 2720 616e 6420 272d 5765 7272 Wall' and '-Werr │ │ │ │ │ -0000e640: 6f72 2720 6173 6b20 2761 7574 6f6d 616b or' ask 'automak │ │ │ │ │ -0000e650: 6527 2074 6f0a 7475 726e 206f 6e20 616c e' to.turn on al │ │ │ │ │ -0000e660: 6c20 7761 726e 696e 6773 2061 6e64 2072 l warnings and r │ │ │ │ │ -0000e670: 6570 6f72 7420 7468 656d 2061 7320 6572 eport them as er │ │ │ │ │ -0000e680: 726f 7273 2e20 2057 6520 6172 6520 7370 rors. We are sp │ │ │ │ │ -0000e690: 6561 6b69 6e67 206f 660a 2a41 7574 6f6d eaking of.*Autom │ │ │ │ │ -0000e6a0: 616b 652a 2077 6172 6e69 6e67 7320 6865 ake* warnings he │ │ │ │ │ -0000e6b0: 7265 2c20 7375 6368 2061 7320 6475 6269 re, such as dubi │ │ │ │ │ -0000e6c0: 6f75 7320 696e 7374 7275 6374 696f 6e73 ous instructions │ │ │ │ │ -0000e6d0: 2069 6e20 274d 616b 6566 696c 652e 616d in 'Makefile.am │ │ │ │ │ -0000e6e0: 272e 0a54 6869 7320 6861 7320 6162 736f '..This has abso │ │ │ │ │ -0000e6f0: 6c75 7465 6c79 206e 6f74 6869 6e67 2074 lutely nothing t │ │ │ │ │ -0000e700: 6f20 646f 2077 6974 6820 686f 7720 7468 o do with how th │ │ │ │ │ -0000e710: 6520 636f 6d70 696c 6572 2077 696c 6c20 e compiler will │ │ │ │ │ -0000e720: 6265 2063 616c 6c65 642c 0a65 7665 6e20 be called,.even │ │ │ │ │ -0000e730: 7468 6f75 6768 2069 7420 6d61 7920 7375 though it may su │ │ │ │ │ -0000e740: 7070 6f72 7420 6f70 7469 6f6e 7320 7769 pport options wi │ │ │ │ │ -0000e750: 7468 2073 696d 696c 6172 206e 616d 6573 th similar names │ │ │ │ │ -0000e760: 2e20 2055 7369 6e67 2027 2d57 616c 6c0a . Using '-Wall. │ │ │ │ │ -0000e770: 2d57 6572 726f 7227 2069 7320 6120 7361 -Werror' is a sa │ │ │ │ │ -0000e780: 6665 2073 6574 7469 6e67 2077 6865 6e20 fe setting when │ │ │ │ │ -0000e790: 7374 6172 7469 6e67 2074 6f20 776f 726b starting to work │ │ │ │ │ -0000e7a0: 206f 6e20 6120 7061 636b 6167 653a 2079 on a package: y │ │ │ │ │ -0000e7b0: 6f75 2064 6f0a 6e6f 7420 7761 6e74 2074 ou do.not want t │ │ │ │ │ -0000e7c0: 6f20 6d69 7373 2061 6e79 2069 7373 7565 o miss any issue │ │ │ │ │ -0000e7d0: 732e 2020 4c61 7465 7220 796f 7520 6d61 s. Later you ma │ │ │ │ │ -0000e7e0: 7920 6465 6369 6465 2074 6f20 7265 6c61 y decide to rela │ │ │ │ │ -0000e7f0: 7820 7468 696e 6773 2061 0a62 6974 2e20 x things a.bit. │ │ │ │ │ -0000e800: 2054 6865 2027 666f 7265 6967 6e27 206f The 'foreign' o │ │ │ │ │ -0000e810: 7074 696f 6e20 7465 6c6c 7320 4175 746f ption tells Auto │ │ │ │ │ -0000e820: 6d61 6b65 2074 6861 7420 7468 6973 2070 make that this p │ │ │ │ │ -0000e830: 6163 6b61 6765 2077 696c 6c20 6e6f 740a ackage will not. │ │ │ │ │ -0000e840: 666f 6c6c 6f77 2074 6865 2047 4e55 2053 follow the GNU S │ │ │ │ │ -0000e850: 7461 6e64 6172 6473 2e20 2047 4e55 2070 tandards. GNU p │ │ │ │ │ -0000e860: 6163 6b61 6765 7320 7368 6f75 6c64 2061 ackages should a │ │ │ │ │ -0000e870: 6c77 6179 7320 6469 7374 7269 6275 7465 lways distribute │ │ │ │ │ -0000e880: 0a61 6464 6974 696f 6e61 6c20 6669 6c65 .additional file │ │ │ │ │ -0000e890: 7320 7375 6368 2061 7320 2743 6861 6e67 s such as 'Chang │ │ │ │ │ -0000e8a0: 654c 6f67 272c 2027 4155 5448 4f52 5327 eLog', 'AUTHORS' │ │ │ │ │ -0000e8b0: 2c20 6574 632e 2020 5765 2064 6f20 6e6f , etc. We do no │ │ │ │ │ -0000e8c0: 7420 7761 6e74 0a27 6175 746f 6d61 6b65 t want.'automake │ │ │ │ │ -0000e8d0: 2720 746f 2063 6f6d 706c 6169 6e20 6162 ' to complain ab │ │ │ │ │ -0000e8e0: 6f75 7420 7468 6573 6520 6d69 7373 696e out these missin │ │ │ │ │ -0000e8f0: 6720 6669 6c65 7320 696e 206f 7572 2073 g files in our s │ │ │ │ │ -0000e900: 6d61 6c6c 2065 7861 6d70 6c65 2e0a 0a20 mall example... │ │ │ │ │ -0000e910: 2020 5468 6520 2741 435f 5052 4f47 5f43 The 'AC_PROG_C │ │ │ │ │ -0000e920: 4327 206c 696e 6520 6361 7573 6573 2074 C' line causes t │ │ │ │ │ -0000e930: 6865 2027 636f 6e66 6967 7572 6527 2073 he 'configure' s │ │ │ │ │ -0000e940: 6372 6970 7420 746f 2073 6561 7263 6820 cript to search │ │ │ │ │ -0000e950: 666f 7220 6120 430a 636f 6d70 696c 6572 for a C.compiler │ │ │ │ │ -0000e960: 2061 6e64 2064 6566 696e 6520 7468 6520 and define the │ │ │ │ │ -0000e970: 7661 7269 6162 6c65 2027 4343 2720 7769 variable 'CC' wi │ │ │ │ │ -0000e980: 7468 2069 7473 206e 616d 652e 2020 5468 th its name. Th │ │ │ │ │ -0000e990: 650a 2773 7263 2f4d 616b 6566 696c 652e e.'src/Makefile. │ │ │ │ │ -0000e9a0: 696e 2720 6669 6c65 2067 656e 6572 6174 in' file generat │ │ │ │ │ -0000e9b0: 6564 2062 7920 4175 746f 6d61 6b65 2075 ed by Automake u │ │ │ │ │ -0000e9c0: 7365 7320 7468 6520 7661 7269 6162 6c65 ses the variable │ │ │ │ │ -0000e9d0: 2027 4343 2720 746f 0a62 7569 6c64 2027 'CC' to.build ' │ │ │ │ │ -0000e9e0: 6865 6c6c 6f27 2c20 736f 2077 6865 6e20 hello', so when │ │ │ │ │ -0000e9f0: 2763 6f6e 6669 6775 7265 2720 6372 6561 'configure' crea │ │ │ │ │ -0000ea00: 7465 7320 2773 7263 2f4d 616b 6566 696c tes 'src/Makefil │ │ │ │ │ -0000ea10: 6527 2066 726f 6d0a 2773 7263 2f4d 616b e' from.'src/Mak │ │ │ │ │ -0000ea20: 6566 696c 652e 696e 272c 2069 7420 7769 efile.in', it wi │ │ │ │ │ -0000ea30: 6c6c 2064 6566 696e 6520 2743 4327 2077 ll define 'CC' w │ │ │ │ │ -0000ea40: 6974 6820 7468 6520 7661 6c75 6520 6974 ith the value it │ │ │ │ │ -0000ea50: 2068 6173 2066 6f75 6e64 2e20 2049 660a has found. If. │ │ │ │ │ -0000ea60: 4175 746f 6d61 6b65 2069 7320 6173 6b65 Automake is aske │ │ │ │ │ -0000ea70: 6420 746f 2063 7265 6174 6520 6120 274d d to create a 'M │ │ │ │ │ -0000ea80: 616b 6566 696c 652e 696e 2720 7468 6174 akefile.in' that │ │ │ │ │ -0000ea90: 2075 7365 7320 2743 4327 2062 7574 0a27 uses 'CC' but.' │ │ │ │ │ -0000eaa0: 636f 6e66 6967 7572 652e 6163 2720 646f configure.ac' do │ │ │ │ │ -0000eab0: 6573 206e 6f74 2064 6566 696e 6520 6974 es not define it │ │ │ │ │ -0000eac0: 2c20 6974 2077 696c 6c20 7375 6767 6573 , it will sugges │ │ │ │ │ -0000ead0: 7420 796f 7520 6164 6420 6120 6361 6c6c t you add a call │ │ │ │ │ -0000eae0: 2074 6f0a 2741 435f 5052 4f47 5f43 4327 to.'AC_PROG_CC' │ │ │ │ │ -0000eaf0: 2e0a 0a20 2020 5468 6520 2741 435f 434f ... The 'AC_CO │ │ │ │ │ -0000eb00: 4e46 4947 5f48 4541 4445 5253 285b 636f NFIG_HEADERS([co │ │ │ │ │ -0000eb10: 6e66 6967 2e68 5d29 2720 696e 766f 6361 nfig.h])' invoca │ │ │ │ │ -0000eb20: 7469 6f6e 2063 6175 7365 7320 7468 6520 tion causes the │ │ │ │ │ -0000eb30: 2763 6f6e 6669 6775 7265 270a 7363 7269 'configure'.scri │ │ │ │ │ -0000eb40: 7074 2074 6f20 6372 6561 7465 2061 2027 pt to create a ' │ │ │ │ │ -0000eb50: 636f 6e66 6967 2e68 2720 6669 6c65 2067 config.h' file g │ │ │ │ │ -0000eb60: 6174 6865 7269 6e67 2027 2364 6566 696e athering '#defin │ │ │ │ │ -0000eb70: 6527 7320 6465 6669 6e65 6420 6279 206f e's defined by o │ │ │ │ │ -0000eb80: 7468 6572 0a6d 6163 726f 7320 696e 2027 ther.macros in ' │ │ │ │ │ -0000eb90: 636f 6e66 6967 7572 652e 6163 272e 2020 configure.ac'. │ │ │ │ │ -0000eba0: 496e 206f 7572 2063 6173 652c 2074 6865 In our case, the │ │ │ │ │ -0000ebb0: 2027 4143 5f49 4e49 5427 206d 6163 726f 'AC_INIT' macro │ │ │ │ │ -0000ebc0: 2061 6c72 6561 6479 0a64 6566 696e 6564 already.defined │ │ │ │ │ -0000ebd0: 2061 2066 6577 206f 6620 7468 656d 2e20 a few of them. │ │ │ │ │ -0000ebe0: 2048 6572 6520 6973 2061 6e20 6578 6365 Here is an exce │ │ │ │ │ -0000ebf0: 7270 7420 6f66 2027 636f 6e66 6967 2e68 rpt of 'config.h │ │ │ │ │ -0000ec00: 2720 6166 7465 720a 2763 6f6e 6669 6775 ' after.'configu │ │ │ │ │ -0000ec10: 7265 2720 6861 7320 7275 6e3a 0a0a 2020 re' has run:.. │ │ │ │ │ -0000ec20: 2020 202e 2e2e 0a20 2020 2020 2f2a 2044 .... /* D │ │ │ │ │ -0000ec30: 6566 696e 6520 746f 2074 6865 2061 6464 efine to the add │ │ │ │ │ -0000ec40: 7265 7373 2077 6865 7265 2062 7567 2072 ress where bug r │ │ │ │ │ -0000ec50: 6570 6f72 7473 2066 6f72 2074 6869 7320 eports for this │ │ │ │ │ -0000ec60: 7061 636b 6167 6520 7368 6f75 6c64 2062 package should b │ │ │ │ │ -0000ec70: 6520 7365 6e74 2e20 2a2f 0a20 2020 2020 e sent. */. │ │ │ │ │ -0000ec80: 2364 6566 696e 6520 5041 434b 4147 455f #define PACKAGE_ │ │ │ │ │ -0000ec90: 4255 4752 4550 4f52 5420 2262 7567 2d61 BUGREPORT "bug-a │ │ │ │ │ -0000eca0: 7574 6f6d 616b 6540 676e 752e 6f72 6722 utomake@gnu.org" │ │ │ │ │ -0000ecb0: 0a0a 2020 2020 202f 2a20 4465 6669 6e65 .. /* Define │ │ │ │ │ -0000ecc0: 2074 6f20 7468 6520 6675 6c6c 206e 616d to the full nam │ │ │ │ │ -0000ecd0: 6520 616e 6420 7665 7273 696f 6e20 6f66 e and version of │ │ │ │ │ -0000ece0: 2074 6869 7320 7061 636b 6167 652e 202a this package. * │ │ │ │ │ -0000ecf0: 2f0a 2020 2020 2023 6465 6669 6e65 2050 /. #define P │ │ │ │ │ -0000ed00: 4143 4b41 4745 5f53 5452 494e 4720 2261 ACKAGE_STRING "a │ │ │ │ │ -0000ed10: 6d68 656c 6c6f 2031 2e30 220a 2020 2020 mhello 1.0". │ │ │ │ │ -0000ed20: 202e 2e2e 0a0a 2020 2041 7320 796f 7520 ..... As you │ │ │ │ │ -0000ed30: 7072 6f62 6162 6c79 206e 6f74 6963 6564 probably noticed │ │ │ │ │ -0000ed40: 2c20 2773 7263 2f6d 6169 6e2e 6327 2069 , 'src/main.c' i │ │ │ │ │ -0000ed50: 6e63 6c75 6465 7320 2763 6f6e 6669 672e ncludes 'config. │ │ │ │ │ -0000ed60: 6827 2073 6f20 6974 2063 616e 0a75 7365 h' so it can.use │ │ │ │ │ -0000ed70: 2027 5041 434b 4147 455f 5354 5249 4e47 'PACKAGE_STRING │ │ │ │ │ -0000ed80: 272e 2020 496e 2061 2072 6561 6c2d 776f '. In a real-wo │ │ │ │ │ -0000ed90: 726c 6420 7072 6f6a 6563 742c 2027 636f rld project, 'co │ │ │ │ │ -0000eda0: 6e66 6967 2e68 2720 6361 6e20 6772 6f77 nfig.h' can grow │ │ │ │ │ -0000edb0: 0a72 6561 6c6c 7920 6269 672c 2077 6974 .really big, wit │ │ │ │ │ -0000edc0: 6820 6f6e 6520 2723 6465 6669 6e65 2720 h one '#define' │ │ │ │ │ -0000edd0: 7065 7220 6665 6174 7572 6520 7072 6f62 per feature prob │ │ │ │ │ -0000ede0: 6564 206f 6e20 7468 6520 7379 7374 656d ed on the system │ │ │ │ │ -0000edf0: 2e0a 0a20 2020 5468 6520 2741 435f 434f ... The 'AC_CO │ │ │ │ │ -0000ee00: 4e46 4947 5f46 494c 4553 2720 6d61 6372 NFIG_FILES' macr │ │ │ │ │ -0000ee10: 6f20 6465 636c 6172 6573 2074 6865 206c o declares the l │ │ │ │ │ -0000ee20: 6973 7420 6f66 2066 696c 6573 2074 6861 ist of files tha │ │ │ │ │ -0000ee30: 740a 2763 6f6e 6669 6775 7265 2720 7368 t.'configure' sh │ │ │ │ │ -0000ee40: 6f75 6c64 2063 7265 6174 6520 6672 6f6d ould create from │ │ │ │ │ -0000ee50: 2074 6865 6972 2027 2a2e 696e 2720 7465 their '*.in' te │ │ │ │ │ -0000ee60: 6d70 6c61 7465 732e 2020 4175 746f 6d61 mplates. Automa │ │ │ │ │ -0000ee70: 6b65 2061 6c73 6f0a 7363 616e 7320 7468 ke also.scans th │ │ │ │ │ -0000ee80: 6973 206c 6973 7420 746f 2066 696e 6420 is list to find │ │ │ │ │ -0000ee90: 7468 6520 274d 616b 6566 696c 652e 616d the 'Makefile.am │ │ │ │ │ -0000eea0: 2720 6669 6c65 7320 6974 206d 7573 7420 ' files it must │ │ │ │ │ -0000eeb0: 7072 6f63 6573 732e 2020 2854 6869 730a process. (This. │ │ │ │ │ -0000eec0: 6973 2069 6d70 6f72 7461 6e74 2074 6f20 is important to │ │ │ │ │ -0000eed0: 7265 6d65 6d62 6572 3a20 7768 656e 2061 remember: when a │ │ │ │ │ -0000eee0: 6464 696e 6720 6120 6e65 7720 6469 7265 dding a new dire │ │ │ │ │ -0000eef0: 6374 6f72 7920 746f 2079 6f75 7220 7072 ctory to your pr │ │ │ │ │ -0000ef00: 6f6a 6563 742c 0a79 6f75 2073 686f 756c oject,.you shoul │ │ │ │ │ -0000ef10: 6420 6164 6420 6974 7320 274d 616b 6566 d add its 'Makef │ │ │ │ │ -0000ef20: 696c 6527 2074 6f20 7468 6973 206c 6973 ile' to this lis │ │ │ │ │ -0000ef30: 742c 206f 7468 6572 7769 7365 2041 7574 t, otherwise Aut │ │ │ │ │ -0000ef40: 6f6d 616b 6520 7769 6c6c 0a6e 6576 6572 omake will.never │ │ │ │ │ -0000ef50: 2070 726f 6365 7373 2074 6865 206e 6577 process the new │ │ │ │ │ -0000ef60: 2027 4d61 6b65 6669 6c65 2e61 6d27 2079 'Makefile.am' y │ │ │ │ │ -0000ef70: 6f75 2077 726f 7465 2069 6e20 7468 6174 ou wrote in that │ │ │ │ │ -0000ef80: 2064 6972 6563 746f 7279 2e29 0a0a 2020 directory.).. │ │ │ │ │ -0000ef90: 2046 696e 616c 6c79 2c20 7468 6520 2741 Finally, the 'A │ │ │ │ │ -0000efa0: 435f 4f55 5450 5554 2720 6c69 6e65 2069 C_OUTPUT' line i │ │ │ │ │ -0000efb0: 7320 6120 636c 6f73 696e 6720 636f 6d6d s a closing comm │ │ │ │ │ -0000efc0: 616e 6420 7468 6174 2061 6374 7561 6c6c and that actuall │ │ │ │ │ -0000efd0: 790a 7072 6f64 7563 6573 2074 6865 2070 y.produces the p │ │ │ │ │ -0000efe0: 6172 7420 6f66 2074 6865 2073 6372 6970 art of the scrip │ │ │ │ │ -0000eff0: 7420 696e 2063 6861 7267 6520 6f66 2063 t in charge of c │ │ │ │ │ -0000f000: 7265 6174 696e 6720 7468 6520 6669 6c65 reating the file │ │ │ │ │ -0000f010: 730a 7265 6769 7374 6572 6564 2077 6974 s.registered wit │ │ │ │ │ -0000f020: 6820 2741 435f 434f 4e46 4947 5f48 4541 h 'AC_CONFIG_HEA │ │ │ │ │ -0000f030: 4445 5253 2720 616e 6420 2741 435f 434f DERS' and 'AC_CO │ │ │ │ │ -0000f040: 4e46 4947 5f46 494c 4553 272e 0a0a 2020 NFIG_FILES'... │ │ │ │ │ -0000f050: 2057 6865 6e20 7374 6172 7469 6e67 2061 When starting a │ │ │ │ │ -0000f060: 206e 6577 2070 726f 6a65 6374 2c20 7765 new project, we │ │ │ │ │ -0000f070: 2073 7567 6765 7374 2079 6f75 2073 7461 suggest you sta │ │ │ │ │ -0000f080: 7274 2077 6974 6820 7375 6368 2061 2073 rt with such a s │ │ │ │ │ -0000f090: 696d 706c 650a 2763 6f6e 6669 6775 7265 imple.'configure │ │ │ │ │ -0000f0a0: 2e61 6327 2c20 616e 6420 6772 6164 7561 .ac', and gradua │ │ │ │ │ -0000f0b0: 6c6c 7920 6164 6420 7468 6520 6f74 6865 lly add the othe │ │ │ │ │ -0000f0c0: 7220 7465 7374 7320 6974 2072 6571 7569 r tests it requi │ │ │ │ │ -0000f0d0: 7265 732e 2020 5468 650a 636f 6d6d 616e res. The.comman │ │ │ │ │ -0000f0e0: 6420 2761 7574 6f73 6361 6e27 2063 616e d 'autoscan' can │ │ │ │ │ -0000f0f0: 2061 6c73 6f20 7375 6767 6573 7420 6120 also suggest a │ │ │ │ │ -0000f100: 6665 7720 6f66 2074 6865 2074 6573 7473 few of the tests │ │ │ │ │ -0000f110: 2079 6f75 7220 7061 636b 6167 6520 6d61 your package ma │ │ │ │ │ -0000f120: 790a 6e65 6564 2028 2a6e 6f74 6520 5573 y.need (*note Us │ │ │ │ │ -0000f130: 696e 6720 2761 7574 6f73 6361 6e27 2074 ing 'autoscan' t │ │ │ │ │ -0000f140: 6f20 4372 6561 7465 2027 636f 6e66 6967 o Create 'config │ │ │ │ │ -0000f150: 7572 652e 6163 273a 0a28 6175 746f 636f ure.ac':.(autoco │ │ │ │ │ -0000f160: 6e66 2961 7574 6f73 6361 6e20 496e 766f nf)autoscan Invo │ │ │ │ │ -0000f170: 6361 7469 6f6e 2e29 2e0a 0a1f 0a46 696c cation.).....Fil │ │ │ │ │ -0000f180: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -0000f190: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 616d .info, Node: am │ │ │ │ │ -0000f1a0: 6865 6c6c 6f27 7320 4d61 6b65 6669 6c65 hello's Makefile │ │ │ │ │ -0000f1b0: 2e61 6d20 5365 7475 7020 4578 706c 6169 .am Setup Explai │ │ │ │ │ -0000f1c0: 6e65 642c 2020 5072 6576 3a20 616d 6865 ned, Prev: amhe │ │ │ │ │ -0000f1d0: 6c6c 6f27 7320 636f 6e66 6967 7572 652e llo's configure. │ │ │ │ │ -0000f1e0: 6163 2053 6574 7570 2045 7870 6c61 696e ac Setup Explain │ │ │ │ │ -0000f1f0: 6564 2c20 2055 703a 2048 656c 6c6f 2057 ed, Up: Hello W │ │ │ │ │ -0000f200: 6f72 6c64 0a0a 322e 342e 3320 2761 6d68 orld..2.4.3 'amh │ │ │ │ │ -0000f210: 656c 6c6f 2727 7320 274d 616b 6566 696c ello''s 'Makefil │ │ │ │ │ -0000f220: 652e 616d 2720 5365 7475 7020 4578 706c e.am' Setup Expl │ │ │ │ │ -0000f230: 6169 6e65 640a 2d2d 2d2d 2d2d 2d2d 2d2d ained.---------- │ │ │ │ │ +0000e040: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a4c -------------..L │ │ │ │ │ +0000e050: 6574 2075 7320 6265 6769 6e20 7769 7468 et us begin with │ │ │ │ │ +0000e060: 2074 6865 2063 6f6e 7465 6e74 7320 6f66 the contents of │ │ │ │ │ +0000e070: 2027 636f 6e66 6967 7572 652e 6163 272e 'configure.ac'. │ │ │ │ │ +0000e080: 0a0a 2020 2020 2041 435f 494e 4954 285b .. AC_INIT([ │ │ │ │ │ +0000e090: 616d 6865 6c6c 6f5d 2c20 5b31 2e30 5d2c amhello], [1.0], │ │ │ │ │ +0000e0a0: 205b 6275 672d 6175 746f 6d61 6b65 4067 [bug-automake@g │ │ │ │ │ +0000e0b0: 6e75 2e6f 7267 5d29 0a20 2020 2020 414d nu.org]). AM │ │ │ │ │ +0000e0c0: 5f49 4e49 545f 4155 544f 4d41 4b45 285b _INIT_AUTOMAKE([ │ │ │ │ │ +0000e0d0: 2d57 616c 6c20 2d57 6572 726f 7220 666f -Wall -Werror fo │ │ │ │ │ +0000e0e0: 7265 6967 6e5d 290a 2020 2020 2041 435f reign]). AC_ │ │ │ │ │ +0000e0f0: 5052 4f47 5f43 430a 2020 2020 2041 435f PROG_CC. AC_ │ │ │ │ │ +0000e100: 434f 4e46 4947 5f48 4541 4445 5253 285b CONFIG_HEADERS([ │ │ │ │ │ +0000e110: 636f 6e66 6967 2e68 5d29 0a20 2020 2020 config.h]). │ │ │ │ │ +0000e120: 4143 5f43 4f4e 4649 475f 4649 4c45 5328 AC_CONFIG_FILES( │ │ │ │ │ +0000e130: 5b0a 2020 2020 2020 4d61 6b65 6669 6c65 [. Makefile │ │ │ │ │ +0000e140: 0a20 2020 2020 2073 7263 2f4d 616b 6566 . src/Makef │ │ │ │ │ +0000e150: 696c 650a 2020 2020 205d 290a 2020 2020 ile. ]). │ │ │ │ │ +0000e160: 2041 435f 4f55 5450 5554 0a0a 2020 2054 AC_OUTPUT.. T │ │ │ │ │ +0000e170: 6869 7320 6669 6c65 2069 7320 7265 6164 his file is read │ │ │ │ │ +0000e180: 2062 7920 626f 7468 2027 6175 746f 636f by both 'autoco │ │ │ │ │ +0000e190: 6e66 2720 2874 6f20 6372 6561 7465 2027 nf' (to create ' │ │ │ │ │ +0000e1a0: 636f 6e66 6967 7572 6527 2920 616e 640a configure') and. │ │ │ │ │ +0000e1b0: 2761 7574 6f6d 616b 6527 2028 746f 2063 'automake' (to c │ │ │ │ │ +0000e1c0: 7265 6174 6520 7468 6520 7661 7269 6f75 reate the variou │ │ │ │ │ +0000e1d0: 7320 274d 616b 6566 696c 652e 696e 2773 s 'Makefile.in's │ │ │ │ │ +0000e1e0: 292e 2020 4974 2063 6f6e 7461 696e 7320 ). It contains │ │ │ │ │ +0000e1f0: 6120 7365 7269 6573 0a6f 6620 4d34 206d a series.of M4 m │ │ │ │ │ +0000e200: 6163 726f 7320 7468 6174 2077 696c 6c20 acros that will │ │ │ │ │ +0000e210: 6265 2065 7870 616e 6465 6420 6173 2073 be expanded as s │ │ │ │ │ +0000e220: 6865 6c6c 2063 6f64 6520 746f 2066 696e hell code to fin │ │ │ │ │ +0000e230: 616c 6c79 2066 6f72 6d20 7468 650a 2763 ally form the.'c │ │ │ │ │ +0000e240: 6f6e 6669 6775 7265 2720 7363 7269 7074 onfigure' script │ │ │ │ │ +0000e250: 2e20 2057 6520 7769 6c6c 206e 6f74 2065 . We will not e │ │ │ │ │ +0000e260: 6c61 626f 7261 7465 206f 6e20 7468 6520 laborate on the │ │ │ │ │ +0000e270: 7379 6e74 6178 206f 6620 7468 6973 2066 syntax of this f │ │ │ │ │ +0000e280: 696c 652c 0a62 6563 6175 7365 2074 6865 ile,.because the │ │ │ │ │ +0000e290: 2041 7574 6f63 6f6e 6620 6d61 6e75 616c Autoconf manual │ │ │ │ │ +0000e2a0: 2068 6173 2061 2077 686f 6c65 2073 6563 has a whole sec │ │ │ │ │ +0000e2b0: 7469 6f6e 2061 626f 7574 2069 7420 282a tion about it (* │ │ │ │ │ +0000e2c0: 6e6f 7465 2057 7269 7469 6e67 0a27 636f note Writing.'co │ │ │ │ │ +0000e2d0: 6e66 6967 7572 652e 6163 273a 2028 6175 nfigure.ac': (au │ │ │ │ │ +0000e2e0: 746f 636f 6e66 2957 7269 7469 6e67 2041 toconf)Writing A │ │ │ │ │ +0000e2f0: 7574 6f63 6f6e 6620 496e 7075 742e 292e utoconf Input.). │ │ │ │ │ +0000e300: 0a0a 2020 2054 6865 206d 6163 726f 7320 .. The macros │ │ │ │ │ +0000e310: 7072 6566 6978 6564 2077 6974 6820 2741 prefixed with 'A │ │ │ │ │ +0000e320: 435f 2720 6172 6520 4175 746f 636f 6e66 C_' are Autoconf │ │ │ │ │ +0000e330: 206d 6163 726f 732c 2064 6f63 756d 656e macros, documen │ │ │ │ │ +0000e340: 7465 6420 696e 2074 6865 0a41 7574 6f63 ted in the.Autoc │ │ │ │ │ +0000e350: 6f6e 6620 6d61 6e75 616c 2028 2a6e 6f74 onf manual (*not │ │ │ │ │ +0000e360: 6520 4175 746f 636f 6e66 204d 6163 726f e Autoconf Macro │ │ │ │ │ +0000e370: 2049 6e64 6578 3a20 2861 7574 6f63 6f6e Index: (autocon │ │ │ │ │ +0000e380: 6629 4175 746f 636f 6e66 204d 6163 726f f)Autoconf Macro │ │ │ │ │ +0000e390: 0a49 6e64 6578 2e29 2e20 2054 6865 206d .Index.). The m │ │ │ │ │ +0000e3a0: 6163 726f 7320 7468 6174 2073 7461 7274 acros that start │ │ │ │ │ +0000e3b0: 2077 6974 6820 2741 4d5f 2720 6172 6520 with 'AM_' are │ │ │ │ │ +0000e3c0: 4175 746f 6d61 6b65 206d 6163 726f 732c Automake macros, │ │ │ │ │ +0000e3d0: 0a64 6f63 756d 656e 7465 6420 6c61 7465 .documented late │ │ │ │ │ +0000e3e0: 7220 696e 2074 6869 7320 6d61 6e75 616c r in this manual │ │ │ │ │ +0000e3f0: 2028 2a6e 6f74 6520 4d61 6372 6f20 496e (*note Macro In │ │ │ │ │ +0000e400: 6465 783a 3a29 2e0a 0a20 2020 5468 6520 dex::)... The │ │ │ │ │ +0000e410: 6669 7273 7420 7477 6f20 6c69 6e65 7320 first two lines │ │ │ │ │ +0000e420: 6f66 2027 636f 6e66 6967 7572 652e 6163 of 'configure.ac │ │ │ │ │ +0000e430: 2720 696e 6974 6961 6c69 7a65 2041 7574 ' initialize Aut │ │ │ │ │ +0000e440: 6f63 6f6e 6620 616e 640a 4175 746f 6d61 oconf and.Automa │ │ │ │ │ +0000e450: 6b65 2e20 2027 4143 5f49 4e49 5427 2074 ke. 'AC_INIT' t │ │ │ │ │ +0000e460: 616b 6573 2069 6e20 6173 2070 6172 616d akes in as param │ │ │ │ │ +0000e470: 6574 6572 7320 7468 6520 6e61 6d65 206f eters the name o │ │ │ │ │ +0000e480: 6620 7468 6520 7061 636b 6167 652c 2069 f the package, i │ │ │ │ │ +0000e490: 7473 0a76 6572 7369 6f6e 206e 756d 6265 ts.version numbe │ │ │ │ │ +0000e4a0: 722c 2061 6e64 2061 2063 6f6e 7461 6374 r, and a contact │ │ │ │ │ +0000e4b0: 2061 6464 7265 7373 2066 6f72 2062 7567 address for bug │ │ │ │ │ +0000e4c0: 2d72 6570 6f72 7473 2061 626f 7574 2074 -reports about t │ │ │ │ │ +0000e4d0: 6865 2070 6163 6b61 6765 0a28 7468 6973 he package.(this │ │ │ │ │ +0000e4e0: 2061 6464 7265 7373 2069 7320 6f75 7470 address is outp │ │ │ │ │ +0000e4f0: 7574 2061 7420 7468 6520 656e 6420 6f66 ut at the end of │ │ │ │ │ +0000e500: 2027 2e2f 636f 6e66 6967 7572 6520 2d2d './configure -- │ │ │ │ │ +0000e510: 6865 6c70 272c 2066 6f72 0a69 6e73 7461 help', for.insta │ │ │ │ │ +0000e520: 6e63 6529 2e20 2057 6865 6e20 6164 6170 nce). When adap │ │ │ │ │ +0000e530: 7469 6e67 2074 6869 7320 7365 7475 7020 ting this setup │ │ │ │ │ +0000e540: 746f 2079 6f75 7220 6f77 6e20 7061 636b to your own pack │ │ │ │ │ +0000e550: 6167 652c 2062 7920 616c 6c20 6d65 616e age, by all mean │ │ │ │ │ +0000e560: 730a 706c 6561 7365 2064 6f20 6e6f 7420 s.please do not │ │ │ │ │ +0000e570: 626c 696e 646c 7920 636f 7079 2041 7574 blindly copy Aut │ │ │ │ │ +0000e580: 6f6d 616b 6527 7320 6164 6472 6573 733a omake's address: │ │ │ │ │ +0000e590: 2075 7365 2074 6865 206d 6169 6c69 6e67 use the mailing │ │ │ │ │ +0000e5a0: 206c 6973 7420 6f66 0a79 6f75 7220 7061 list of.your pa │ │ │ │ │ +0000e5b0: 636b 6167 652c 206f 7220 796f 7572 206f ckage, or your o │ │ │ │ │ +0000e5c0: 776e 206d 6169 6c20 6164 6472 6573 732e wn mail address. │ │ │ │ │ +0000e5d0: 0a0a 2020 2054 6865 2061 7267 756d 656e .. The argumen │ │ │ │ │ +0000e5e0: 7420 746f 2027 414d 5f49 4e49 545f 4155 t to 'AM_INIT_AU │ │ │ │ │ +0000e5f0: 544f 4d41 4b45 2720 6973 2061 206c 6973 TOMAKE' is a lis │ │ │ │ │ +0000e600: 7420 6f66 206f 7074 696f 6e73 2066 6f72 t of options for │ │ │ │ │ +0000e610: 0a27 6175 746f 6d61 6b65 2720 282a 6e6f .'automake' (*no │ │ │ │ │ +0000e620: 7465 204f 7074 696f 6e73 3a3a 292e 2020 te Options::). │ │ │ │ │ +0000e630: 272d 5761 6c6c 2720 616e 6420 272d 5765 '-Wall' and '-We │ │ │ │ │ +0000e640: 7272 6f72 2720 6173 6b20 2761 7574 6f6d rror' ask 'autom │ │ │ │ │ +0000e650: 616b 6527 2074 6f0a 7475 726e 206f 6e20 ake' to.turn on │ │ │ │ │ +0000e660: 616c 6c20 7761 726e 696e 6773 2061 6e64 all warnings and │ │ │ │ │ +0000e670: 2072 6570 6f72 7420 7468 656d 2061 7320 report them as │ │ │ │ │ +0000e680: 6572 726f 7273 2e20 2057 6520 6172 6520 errors. We are │ │ │ │ │ +0000e690: 7370 6561 6b69 6e67 206f 660a 2a41 7574 speaking of.*Aut │ │ │ │ │ +0000e6a0: 6f6d 616b 652a 2077 6172 6e69 6e67 7320 omake* warnings │ │ │ │ │ +0000e6b0: 6865 7265 2c20 7375 6368 2061 7320 6475 here, such as du │ │ │ │ │ +0000e6c0: 6269 6f75 7320 696e 7374 7275 6374 696f bious instructio │ │ │ │ │ +0000e6d0: 6e73 2069 6e20 274d 616b 6566 696c 652e ns in 'Makefile. │ │ │ │ │ +0000e6e0: 616d 272e 0a54 6869 7320 6861 7320 6162 am'..This has ab │ │ │ │ │ +0000e6f0: 736f 6c75 7465 6c79 206e 6f74 6869 6e67 solutely nothing │ │ │ │ │ +0000e700: 2074 6f20 646f 2077 6974 6820 686f 7720 to do with how │ │ │ │ │ +0000e710: 7468 6520 636f 6d70 696c 6572 2077 696c the compiler wil │ │ │ │ │ +0000e720: 6c20 6265 2063 616c 6c65 642c 0a65 7665 l be called,.eve │ │ │ │ │ +0000e730: 6e20 7468 6f75 6768 2069 7420 6d61 7920 n though it may │ │ │ │ │ +0000e740: 7375 7070 6f72 7420 6f70 7469 6f6e 7320 support options │ │ │ │ │ +0000e750: 7769 7468 2073 696d 696c 6172 206e 616d with similar nam │ │ │ │ │ +0000e760: 6573 2e20 2055 7369 6e67 2027 2d57 616c es. Using '-Wal │ │ │ │ │ +0000e770: 6c0a 2d57 6572 726f 7227 2069 7320 6120 l.-Werror' is a │ │ │ │ │ +0000e780: 7361 6665 2073 6574 7469 6e67 2077 6865 safe setting whe │ │ │ │ │ +0000e790: 6e20 7374 6172 7469 6e67 2074 6f20 776f n starting to wo │ │ │ │ │ +0000e7a0: 726b 206f 6e20 6120 7061 636b 6167 653a rk on a package: │ │ │ │ │ +0000e7b0: 2079 6f75 2064 6f0a 6e6f 7420 7761 6e74 you do.not want │ │ │ │ │ +0000e7c0: 2074 6f20 6d69 7373 2061 6e79 2069 7373 to miss any iss │ │ │ │ │ +0000e7d0: 7565 732e 2020 4c61 7465 7220 796f 7520 ues. Later you │ │ │ │ │ +0000e7e0: 6d61 7920 6465 6369 6465 2074 6f20 7265 may decide to re │ │ │ │ │ +0000e7f0: 6c61 7820 7468 696e 6773 2061 0a62 6974 lax things a.bit │ │ │ │ │ +0000e800: 2e20 2054 6865 2027 666f 7265 6967 6e27 . The 'foreign' │ │ │ │ │ +0000e810: 206f 7074 696f 6e20 7465 6c6c 7320 4175 option tells Au │ │ │ │ │ +0000e820: 746f 6d61 6b65 2074 6861 7420 7468 6973 tomake that this │ │ │ │ │ +0000e830: 2070 6163 6b61 6765 2077 696c 6c20 6e6f package will no │ │ │ │ │ +0000e840: 740a 666f 6c6c 6f77 2074 6865 2047 4e55 t.follow the GNU │ │ │ │ │ +0000e850: 2053 7461 6e64 6172 6473 2e20 2047 4e55 Standards. GNU │ │ │ │ │ +0000e860: 2070 6163 6b61 6765 7320 7368 6f75 6c64 packages should │ │ │ │ │ +0000e870: 2061 6c77 6179 7320 6469 7374 7269 6275 always distribu │ │ │ │ │ +0000e880: 7465 0a61 6464 6974 696f 6e61 6c20 6669 te.additional fi │ │ │ │ │ +0000e890: 6c65 7320 7375 6368 2061 7320 2743 6861 les such as 'Cha │ │ │ │ │ +0000e8a0: 6e67 654c 6f67 272c 2027 4155 5448 4f52 ngeLog', 'AUTHOR │ │ │ │ │ +0000e8b0: 5327 2c20 6574 632e 2020 5765 2064 6f20 S', etc. We do │ │ │ │ │ +0000e8c0: 6e6f 7420 7761 6e74 0a27 6175 746f 6d61 not want.'automa │ │ │ │ │ +0000e8d0: 6b65 2720 746f 2063 6f6d 706c 6169 6e20 ke' to complain │ │ │ │ │ +0000e8e0: 6162 6f75 7420 7468 6573 6520 6d69 7373 about these miss │ │ │ │ │ +0000e8f0: 696e 6720 6669 6c65 7320 696e 206f 7572 ing files in our │ │ │ │ │ +0000e900: 2073 6d61 6c6c 2065 7861 6d70 6c65 2e0a small example.. │ │ │ │ │ +0000e910: 0a20 2020 5468 6520 2741 435f 5052 4f47 . The 'AC_PROG │ │ │ │ │ +0000e920: 5f43 4327 206c 696e 6520 6361 7573 6573 _CC' line causes │ │ │ │ │ +0000e930: 2074 6865 2027 636f 6e66 6967 7572 6527 the 'configure' │ │ │ │ │ +0000e940: 2073 6372 6970 7420 746f 2073 6561 7263 script to searc │ │ │ │ │ +0000e950: 6820 666f 7220 6120 430a 636f 6d70 696c h for a C.compil │ │ │ │ │ +0000e960: 6572 2061 6e64 2064 6566 696e 6520 7468 er and define th │ │ │ │ │ +0000e970: 6520 7661 7269 6162 6c65 2027 4343 2720 e variable 'CC' │ │ │ │ │ +0000e980: 7769 7468 2069 7473 206e 616d 652e 2020 with its name. │ │ │ │ │ +0000e990: 5468 650a 2773 7263 2f4d 616b 6566 696c The.'src/Makefil │ │ │ │ │ +0000e9a0: 652e 696e 2720 6669 6c65 2067 656e 6572 e.in' file gener │ │ │ │ │ +0000e9b0: 6174 6564 2062 7920 4175 746f 6d61 6b65 ated by Automake │ │ │ │ │ +0000e9c0: 2075 7365 7320 7468 6520 7661 7269 6162 uses the variab │ │ │ │ │ +0000e9d0: 6c65 2027 4343 2720 746f 0a62 7569 6c64 le 'CC' to.build │ │ │ │ │ +0000e9e0: 2027 6865 6c6c 6f27 2c20 736f 2077 6865 'hello', so whe │ │ │ │ │ +0000e9f0: 6e20 2763 6f6e 6669 6775 7265 2720 6372 n 'configure' cr │ │ │ │ │ +0000ea00: 6561 7465 7320 2773 7263 2f4d 616b 6566 eates 'src/Makef │ │ │ │ │ +0000ea10: 696c 6527 2066 726f 6d0a 2773 7263 2f4d ile' from.'src/M │ │ │ │ │ +0000ea20: 616b 6566 696c 652e 696e 272c 2069 7420 akefile.in', it │ │ │ │ │ +0000ea30: 7769 6c6c 2064 6566 696e 6520 2743 4327 will define 'CC' │ │ │ │ │ +0000ea40: 2077 6974 6820 7468 6520 7661 6c75 6520 with the value │ │ │ │ │ +0000ea50: 6974 2068 6173 2066 6f75 6e64 2e20 2049 it has found. I │ │ │ │ │ +0000ea60: 660a 4175 746f 6d61 6b65 2069 7320 6173 f.Automake is as │ │ │ │ │ +0000ea70: 6b65 6420 746f 2063 7265 6174 6520 6120 ked to create a │ │ │ │ │ +0000ea80: 274d 616b 6566 696c 652e 696e 2720 7468 'Makefile.in' th │ │ │ │ │ +0000ea90: 6174 2075 7365 7320 2743 4327 2062 7574 at uses 'CC' but │ │ │ │ │ +0000eaa0: 0a27 636f 6e66 6967 7572 652e 6163 2720 .'configure.ac' │ │ │ │ │ +0000eab0: 646f 6573 206e 6f74 2064 6566 696e 6520 does not define │ │ │ │ │ +0000eac0: 6974 2c20 6974 2077 696c 6c20 7375 6767 it, it will sugg │ │ │ │ │ +0000ead0: 6573 7420 796f 7520 6164 6420 6120 6361 est you add a ca │ │ │ │ │ +0000eae0: 6c6c 2074 6f0a 2741 435f 5052 4f47 5f43 ll to.'AC_PROG_C │ │ │ │ │ +0000eaf0: 4327 2e0a 0a20 2020 5468 6520 2741 435f C'... The 'AC_ │ │ │ │ │ +0000eb00: 434f 4e46 4947 5f48 4541 4445 5253 285b CONFIG_HEADERS([ │ │ │ │ │ +0000eb10: 636f 6e66 6967 2e68 5d29 2720 696e 766f config.h])' invo │ │ │ │ │ +0000eb20: 6361 7469 6f6e 2063 6175 7365 7320 7468 cation causes th │ │ │ │ │ +0000eb30: 6520 2763 6f6e 6669 6775 7265 270a 7363 e 'configure'.sc │ │ │ │ │ +0000eb40: 7269 7074 2074 6f20 6372 6561 7465 2061 ript to create a │ │ │ │ │ +0000eb50: 2027 636f 6e66 6967 2e68 2720 6669 6c65 'config.h' file │ │ │ │ │ +0000eb60: 2067 6174 6865 7269 6e67 2027 2364 6566 gathering '#def │ │ │ │ │ +0000eb70: 696e 6527 7320 6465 6669 6e65 6420 6279 ine's defined by │ │ │ │ │ +0000eb80: 206f 7468 6572 0a6d 6163 726f 7320 696e other.macros in │ │ │ │ │ +0000eb90: 2027 636f 6e66 6967 7572 652e 6163 272e 'configure.ac'. │ │ │ │ │ +0000eba0: 2020 496e 206f 7572 2063 6173 652c 2074 In our case, t │ │ │ │ │ +0000ebb0: 6865 2027 4143 5f49 4e49 5427 206d 6163 he 'AC_INIT' mac │ │ │ │ │ +0000ebc0: 726f 2061 6c72 6561 6479 0a64 6566 696e ro already.defin │ │ │ │ │ +0000ebd0: 6564 2061 2066 6577 206f 6620 7468 656d ed a few of them │ │ │ │ │ +0000ebe0: 2e20 2048 6572 6520 6973 2061 6e20 6578 . Here is an ex │ │ │ │ │ +0000ebf0: 6365 7270 7420 6f66 2027 636f 6e66 6967 cerpt of 'config │ │ │ │ │ +0000ec00: 2e68 2720 6166 7465 720a 2763 6f6e 6669 .h' after.'confi │ │ │ │ │ +0000ec10: 6775 7265 2720 6861 7320 7275 6e3a 0a0a gure' has run:.. │ │ │ │ │ +0000ec20: 2020 2020 202e 2e2e 0a20 2020 2020 2f2a .... /* │ │ │ │ │ +0000ec30: 2044 6566 696e 6520 746f 2074 6865 2061 Define to the a │ │ │ │ │ +0000ec40: 6464 7265 7373 2077 6865 7265 2062 7567 ddress where bug │ │ │ │ │ +0000ec50: 2072 6570 6f72 7473 2066 6f72 2074 6869 reports for thi │ │ │ │ │ +0000ec60: 7320 7061 636b 6167 6520 7368 6f75 6c64 s package should │ │ │ │ │ +0000ec70: 2062 6520 7365 6e74 2e20 2a2f 0a20 2020 be sent. */. │ │ │ │ │ +0000ec80: 2020 2364 6566 696e 6520 5041 434b 4147 #define PACKAG │ │ │ │ │ +0000ec90: 455f 4255 4752 4550 4f52 5420 2262 7567 E_BUGREPORT "bug │ │ │ │ │ +0000eca0: 2d61 7574 6f6d 616b 6540 676e 752e 6f72 -automake@gnu.or │ │ │ │ │ +0000ecb0: 6722 0a0a 2020 2020 202f 2a20 4465 6669 g".. /* Defi │ │ │ │ │ +0000ecc0: 6e65 2074 6f20 7468 6520 6675 6c6c 206e ne to the full n │ │ │ │ │ +0000ecd0: 616d 6520 616e 6420 7665 7273 696f 6e20 ame and version │ │ │ │ │ +0000ece0: 6f66 2074 6869 7320 7061 636b 6167 652e of this package. │ │ │ │ │ +0000ecf0: 202a 2f0a 2020 2020 2023 6465 6669 6e65 */. #define │ │ │ │ │ +0000ed00: 2050 4143 4b41 4745 5f53 5452 494e 4720 PACKAGE_STRING │ │ │ │ │ +0000ed10: 2261 6d68 656c 6c6f 2031 2e30 220a 2020 "amhello 1.0". │ │ │ │ │ +0000ed20: 2020 202e 2e2e 0a0a 2020 2041 7320 796f ..... As yo │ │ │ │ │ +0000ed30: 7520 7072 6f62 6162 6c79 206e 6f74 6963 u probably notic │ │ │ │ │ +0000ed40: 6564 2c20 2773 7263 2f6d 6169 6e2e 6327 ed, 'src/main.c' │ │ │ │ │ +0000ed50: 2069 6e63 6c75 6465 7320 2763 6f6e 6669 includes 'confi │ │ │ │ │ +0000ed60: 672e 6827 2073 6f20 6974 2063 616e 0a75 g.h' so it can.u │ │ │ │ │ +0000ed70: 7365 2027 5041 434b 4147 455f 5354 5249 se 'PACKAGE_STRI │ │ │ │ │ +0000ed80: 4e47 272e 2020 496e 2061 2072 6561 6c2d NG'. In a real- │ │ │ │ │ +0000ed90: 776f 726c 6420 7072 6f6a 6563 742c 2027 world project, ' │ │ │ │ │ +0000eda0: 636f 6e66 6967 2e68 2720 6361 6e20 6772 config.h' can gr │ │ │ │ │ +0000edb0: 6f77 0a72 6561 6c6c 7920 6269 672c 2077 ow.really big, w │ │ │ │ │ +0000edc0: 6974 6820 6f6e 6520 2723 6465 6669 6e65 ith one '#define │ │ │ │ │ +0000edd0: 2720 7065 7220 6665 6174 7572 6520 7072 ' per feature pr │ │ │ │ │ +0000ede0: 6f62 6564 206f 6e20 7468 6520 7379 7374 obed on the syst │ │ │ │ │ +0000edf0: 656d 2e0a 0a20 2020 5468 6520 2741 435f em... The 'AC_ │ │ │ │ │ +0000ee00: 434f 4e46 4947 5f46 494c 4553 2720 6d61 CONFIG_FILES' ma │ │ │ │ │ +0000ee10: 6372 6f20 6465 636c 6172 6573 2074 6865 cro declares the │ │ │ │ │ +0000ee20: 206c 6973 7420 6f66 2066 696c 6573 2074 list of files t │ │ │ │ │ +0000ee30: 6861 740a 2763 6f6e 6669 6775 7265 2720 hat.'configure' │ │ │ │ │ +0000ee40: 7368 6f75 6c64 2063 7265 6174 6520 6672 should create fr │ │ │ │ │ +0000ee50: 6f6d 2074 6865 6972 2027 2a2e 696e 2720 om their '*.in' │ │ │ │ │ +0000ee60: 7465 6d70 6c61 7465 732e 2020 4175 746f templates. Auto │ │ │ │ │ +0000ee70: 6d61 6b65 2061 6c73 6f0a 7363 616e 7320 make also.scans │ │ │ │ │ +0000ee80: 7468 6973 206c 6973 7420 746f 2066 696e this list to fin │ │ │ │ │ +0000ee90: 6420 7468 6520 274d 616b 6566 696c 652e d the 'Makefile. │ │ │ │ │ +0000eea0: 616d 2720 6669 6c65 7320 6974 206d 7573 am' files it mus │ │ │ │ │ +0000eeb0: 7420 7072 6f63 6573 732e 2020 2854 6869 t process. (Thi │ │ │ │ │ +0000eec0: 730a 6973 2069 6d70 6f72 7461 6e74 2074 s.is important t │ │ │ │ │ +0000eed0: 6f20 7265 6d65 6d62 6572 3a20 7768 656e o remember: when │ │ │ │ │ +0000eee0: 2061 6464 696e 6720 6120 6e65 7720 6469 adding a new di │ │ │ │ │ +0000eef0: 7265 6374 6f72 7920 746f 2079 6f75 7220 rectory to your │ │ │ │ │ +0000ef00: 7072 6f6a 6563 742c 0a79 6f75 2073 686f project,.you sho │ │ │ │ │ +0000ef10: 756c 6420 6164 6420 6974 7320 274d 616b uld add its 'Mak │ │ │ │ │ +0000ef20: 6566 696c 6527 2074 6f20 7468 6973 206c efile' to this l │ │ │ │ │ +0000ef30: 6973 742c 206f 7468 6572 7769 7365 2041 ist, otherwise A │ │ │ │ │ +0000ef40: 7574 6f6d 616b 6520 7769 6c6c 0a6e 6576 utomake will.nev │ │ │ │ │ +0000ef50: 6572 2070 726f 6365 7373 2074 6865 206e er process the n │ │ │ │ │ +0000ef60: 6577 2027 4d61 6b65 6669 6c65 2e61 6d27 ew 'Makefile.am' │ │ │ │ │ +0000ef70: 2079 6f75 2077 726f 7465 2069 6e20 7468 you wrote in th │ │ │ │ │ +0000ef80: 6174 2064 6972 6563 746f 7279 2e29 0a0a at directory.).. │ │ │ │ │ +0000ef90: 2020 2046 696e 616c 6c79 2c20 7468 6520 Finally, the │ │ │ │ │ +0000efa0: 2741 435f 4f55 5450 5554 2720 6c69 6e65 'AC_OUTPUT' line │ │ │ │ │ +0000efb0: 2069 7320 6120 636c 6f73 696e 6720 636f is a closing co │ │ │ │ │ +0000efc0: 6d6d 616e 6420 7468 6174 2061 6374 7561 mmand that actua │ │ │ │ │ +0000efd0: 6c6c 790a 7072 6f64 7563 6573 2074 6865 lly.produces the │ │ │ │ │ +0000efe0: 2070 6172 7420 6f66 2074 6865 2073 6372 part of the scr │ │ │ │ │ +0000eff0: 6970 7420 696e 2063 6861 7267 6520 6f66 ipt in charge of │ │ │ │ │ +0000f000: 2063 7265 6174 696e 6720 7468 6520 6669 creating the fi │ │ │ │ │ +0000f010: 6c65 730a 7265 6769 7374 6572 6564 2077 les.registered w │ │ │ │ │ +0000f020: 6974 6820 2741 435f 434f 4e46 4947 5f48 ith 'AC_CONFIG_H │ │ │ │ │ +0000f030: 4541 4445 5253 2720 616e 6420 2741 435f EADERS' and 'AC_ │ │ │ │ │ +0000f040: 434f 4e46 4947 5f46 494c 4553 272e 0a0a CONFIG_FILES'... │ │ │ │ │ +0000f050: 2020 2057 6865 6e20 7374 6172 7469 6e67 When starting │ │ │ │ │ +0000f060: 2061 206e 6577 2070 726f 6a65 6374 2c20 a new project, │ │ │ │ │ +0000f070: 7765 2073 7567 6765 7374 2079 6f75 2073 we suggest you s │ │ │ │ │ +0000f080: 7461 7274 2077 6974 6820 7375 6368 2061 tart with such a │ │ │ │ │ +0000f090: 2073 696d 706c 650a 2763 6f6e 6669 6775 simple.'configu │ │ │ │ │ +0000f0a0: 7265 2e61 6327 2c20 616e 6420 6772 6164 re.ac', and grad │ │ │ │ │ +0000f0b0: 7561 6c6c 7920 6164 6420 7468 6520 6f74 ually add the ot │ │ │ │ │ +0000f0c0: 6865 7220 7465 7374 7320 6974 2072 6571 her tests it req │ │ │ │ │ +0000f0d0: 7569 7265 732e 2020 5468 650a 636f 6d6d uires. The.comm │ │ │ │ │ +0000f0e0: 616e 6420 2761 7574 6f73 6361 6e27 2063 and 'autoscan' c │ │ │ │ │ +0000f0f0: 616e 2061 6c73 6f20 7375 6767 6573 7420 an also suggest │ │ │ │ │ +0000f100: 6120 6665 7720 6f66 2074 6865 2074 6573 a few of the tes │ │ │ │ │ +0000f110: 7473 2079 6f75 7220 7061 636b 6167 6520 ts your package │ │ │ │ │ +0000f120: 6d61 790a 6e65 6564 2028 2a6e 6f74 6520 may.need (*note │ │ │ │ │ +0000f130: 5573 696e 6720 2761 7574 6f73 6361 6e27 Using 'autoscan' │ │ │ │ │ +0000f140: 2074 6f20 4372 6561 7465 2027 636f 6e66 to Create 'conf │ │ │ │ │ +0000f150: 6967 7572 652e 6163 273a 0a28 6175 746f igure.ac':.(auto │ │ │ │ │ +0000f160: 636f 6e66 2961 7574 6f73 6361 6e20 496e conf)autoscan In │ │ │ │ │ +0000f170: 766f 6361 7469 6f6e 2e29 2e0a 0a1f 0a46 vocation.).....F │ │ │ │ │ +0000f180: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +0000f190: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +0000f1a0: 616d 6865 6c6c 6f27 7320 4d61 6b65 6669 amhello's Makefi │ │ │ │ │ +0000f1b0: 6c65 2e61 6d20 5365 7475 7020 4578 706c le.am Setup Expl │ │ │ │ │ +0000f1c0: 6169 6e65 642c 2020 5072 6576 3a20 616d ained, Prev: am │ │ │ │ │ +0000f1d0: 6865 6c6c 6f27 7320 636f 6e66 6967 7572 hello's configur │ │ │ │ │ +0000f1e0: 652e 6163 2053 6574 7570 2045 7870 6c61 e.ac Setup Expla │ │ │ │ │ +0000f1f0: 696e 6564 2c20 2055 703a 2048 656c 6c6f ined, Up: Hello │ │ │ │ │ +0000f200: 2057 6f72 6c64 0a0a 322e 342e 3320 2761 World..2.4.3 'a │ │ │ │ │ +0000f210: 6d68 656c 6c6f 2727 7320 274d 616b 6566 mhello''s 'Makef │ │ │ │ │ +0000f220: 696c 652e 616d 2720 5365 7475 7020 4578 ile.am' Setup Ex │ │ │ │ │ +0000f230: 706c 6169 6e65 640a 2d2d 2d2d 2d2d 2d2d plained.-------- │ │ │ │ │ 0000f240: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000f250: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f260: 2d2d 2d2d 2d0a 0a57 6520 6e6f 7720 7475 -----..We now tu │ │ │ │ │ -0000f270: 726e 2074 6f20 2773 7263 2f4d 616b 6566 rn to 'src/Makef │ │ │ │ │ -0000f280: 696c 652e 616d 272e 2020 5468 6973 2066 ile.am'. This f │ │ │ │ │ -0000f290: 696c 6520 636f 6e74 6169 6e73 2041 7574 ile contains Aut │ │ │ │ │ -0000f2a0: 6f6d 616b 650a 696e 7374 7275 6374 696f omake.instructio │ │ │ │ │ -0000f2b0: 6e73 2074 6f20 6275 696c 6420 616e 6420 ns to build and │ │ │ │ │ -0000f2c0: 696e 7374 616c 6c20 2768 656c 6c6f 272e install 'hello'. │ │ │ │ │ -0000f2d0: 0a0a 2020 2020 2062 696e 5f50 524f 4752 .. bin_PROGR │ │ │ │ │ -0000f2e0: 414d 5320 3d20 6865 6c6c 6f0a 2020 2020 AMS = hello. │ │ │ │ │ -0000f2f0: 2068 656c 6c6f 5f53 4f55 5243 4553 203d hello_SOURCES = │ │ │ │ │ -0000f300: 206d 6169 6e2e 630a 0a20 2020 4120 274d main.c.. A 'M │ │ │ │ │ -0000f310: 616b 6566 696c 652e 616d 2720 6861 7320 akefile.am' has │ │ │ │ │ -0000f320: 7468 6520 7361 6d65 2073 796e 7461 7820 the same syntax │ │ │ │ │ -0000f330: 6173 2061 6e20 6f72 6469 6e61 7279 2027 as an ordinary ' │ │ │ │ │ -0000f340: 4d61 6b65 6669 6c65 272e 2020 5768 656e Makefile'. When │ │ │ │ │ -0000f350: 0a27 6175 746f 6d61 6b65 2720 7072 6f63 .'automake' proc │ │ │ │ │ -0000f360: 6573 7365 7320 6120 274d 616b 6566 696c esses a 'Makefil │ │ │ │ │ -0000f370: 652e 616d 2720 6974 2063 6f70 6965 7320 e.am' it copies │ │ │ │ │ -0000f380: 7468 6520 656e 7469 7265 2066 696c 6520 the entire file │ │ │ │ │ -0000f390: 696e 746f 2074 6865 0a6f 7574 7075 7420 into the.output │ │ │ │ │ -0000f3a0: 274d 616b 6566 696c 652e 696e 2720 2874 'Makefile.in' (t │ │ │ │ │ -0000f3b0: 6861 7420 7769 6c6c 2062 6520 6c61 7465 hat will be late │ │ │ │ │ -0000f3c0: 7220 7475 726e 6564 2069 6e74 6f20 274d r turned into 'M │ │ │ │ │ -0000f3d0: 616b 6566 696c 6527 2062 790a 2763 6f6e akefile' by.'con │ │ │ │ │ -0000f3e0: 6669 6775 7265 2729 2062 7574 2077 696c figure') but wil │ │ │ │ │ -0000f3f0: 6c20 7265 6163 7420 746f 2063 6572 7461 l react to certa │ │ │ │ │ -0000f400: 696e 2076 6172 6961 626c 6520 6465 6669 in variable defi │ │ │ │ │ -0000f410: 6e69 7469 6f6e 7320 6279 0a67 656e 6572 nitions by.gener │ │ │ │ │ -0000f420: 6174 696e 6720 736f 6d65 2062 7569 6c64 ating some build │ │ │ │ │ -0000f430: 2072 756c 6573 2061 6e64 206f 7468 6572 rules and other │ │ │ │ │ -0000f440: 2076 6172 6961 626c 6573 2e20 204f 6674 variables. Oft │ │ │ │ │ -0000f450: 656e 2027 4d61 6b65 6669 6c65 2e61 6d27 en 'Makefile.am' │ │ │ │ │ -0000f460: 730a 636f 6e74 6169 6e20 6f6e 6c79 2061 s.contain only a │ │ │ │ │ -0000f470: 206c 6973 7420 6f66 2076 6172 6961 626c list of variabl │ │ │ │ │ -0000f480: 6520 6465 6669 6e69 7469 6f6e 7320 6173 e definitions as │ │ │ │ │ -0000f490: 2061 626f 7665 2c20 6275 7420 7468 6579 above, but they │ │ │ │ │ -0000f4a0: 2063 616e 2061 6c73 6f0a 636f 6e74 6169 can also.contai │ │ │ │ │ -0000f4b0: 6e20 6f74 6865 7220 7661 7269 6162 6c65 n other variable │ │ │ │ │ -0000f4c0: 2061 6e64 2072 756c 6520 6465 6669 6e69 and rule defini │ │ │ │ │ -0000f4d0: 7469 6f6e 7320 7468 6174 2027 6175 746f tions that 'auto │ │ │ │ │ -0000f4e0: 6d61 6b65 2720 7769 6c6c 2070 6173 730a make' will pass. │ │ │ │ │ -0000f4f0: 616c 6f6e 6720 7769 7468 6f75 7420 696e along without in │ │ │ │ │ -0000f500: 7465 7270 7265 7461 7469 6f6e 2e0a 0a20 terpretation... │ │ │ │ │ -0000f510: 2020 5661 7269 6162 6c65 7320 7468 6174 Variables that │ │ │ │ │ -0000f520: 2065 6e64 2077 6974 6820 275f 5052 4f47 end with '_PROG │ │ │ │ │ -0000f530: 5241 4d53 2720 6172 6520 7370 6563 6961 RAMS' are specia │ │ │ │ │ -0000f540: 6c20 7661 7269 6162 6c65 7320 7468 6174 l variables that │ │ │ │ │ -0000f550: 206c 6973 740a 7072 6f67 7261 6d73 2074 list.programs t │ │ │ │ │ -0000f560: 6861 7420 7468 6520 7265 7375 6c74 696e hat the resultin │ │ │ │ │ -0000f570: 6720 274d 616b 6566 696c 6527 2073 686f g 'Makefile' sho │ │ │ │ │ -0000f580: 756c 6420 6275 696c 642e 2020 496e 2041 uld build. In A │ │ │ │ │ -0000f590: 7574 6f6d 616b 6520 7370 6561 6b2c 0a74 utomake speak,.t │ │ │ │ │ -0000f5a0: 6869 7320 275f 5052 4f47 5241 4d53 2720 his '_PROGRAMS' │ │ │ │ │ -0000f5b0: 7375 6666 6978 2069 7320 6361 6c6c 6564 suffix is called │ │ │ │ │ -0000f5c0: 2061 2022 7072 696d 6172 7922 3b20 4175 a "primary"; Au │ │ │ │ │ -0000f5d0: 746f 6d61 6b65 2072 6563 6f67 6e69 7a65 tomake recognize │ │ │ │ │ -0000f5e0: 7320 6f74 6865 720a 7072 696d 6172 6965 s other.primarie │ │ │ │ │ -0000f5f0: 7320 7375 6368 2061 7320 275f 5343 5249 s such as '_SCRI │ │ │ │ │ -0000f600: 5054 5327 2c20 275f 4441 5441 272c 2027 PTS', '_DATA', ' │ │ │ │ │ -0000f610: 5f4c 4942 5241 5249 4553 272c 2065 7463 _LIBRARIES', etc │ │ │ │ │ -0000f620: 2e20 636f 7272 6573 706f 6e64 696e 670a . corresponding. │ │ │ │ │ -0000f630: 746f 2064 6966 6665 7265 6e74 2074 7970 to different typ │ │ │ │ │ -0000f640: 6573 206f 6620 6669 6c65 732e 0a0a 2020 es of files... │ │ │ │ │ -0000f650: 2054 6865 2027 6269 6e27 2070 6172 7420 The 'bin' part │ │ │ │ │ -0000f660: 6f66 2074 6865 2027 6269 6e5f 5052 4f47 of the 'bin_PROG │ │ │ │ │ -0000f670: 5241 4d53 2720 7465 6c6c 7320 2761 7574 RAMS' tells 'aut │ │ │ │ │ -0000f680: 6f6d 616b 6527 2074 6861 7420 7468 650a omake' that the. │ │ │ │ │ -0000f690: 7265 7375 6c74 696e 6720 7072 6f67 7261 resulting progra │ │ │ │ │ -0000f6a0: 6d73 2073 686f 756c 6420 6265 2069 6e73 ms should be ins │ │ │ │ │ -0000f6b0: 7461 6c6c 6564 2069 6e20 4249 4e44 4952 talled in BINDIR │ │ │ │ │ -0000f6c0: 2e20 2052 6563 616c 6c20 7468 6174 2074 . Recall that t │ │ │ │ │ -0000f6d0: 6865 2047 4e55 0a42 7569 6c64 2053 7973 he GNU.Build Sys │ │ │ │ │ -0000f6e0: 7465 6d20 7573 6573 2061 2073 6574 206f tem uses a set o │ │ │ │ │ -0000f6f0: 6620 7661 7269 6162 6c65 7320 746f 2064 f variables to d │ │ │ │ │ -0000f700: 656e 6f74 6520 6465 7374 696e 6174 696f enote destinatio │ │ │ │ │ -0000f710: 6e20 6469 7265 6374 6f72 6965 730a 616e n directories.an │ │ │ │ │ -0000f720: 6420 616c 6c6f 7720 7573 6572 7320 746f d allow users to │ │ │ │ │ -0000f730: 2063 7573 746f 6d69 7a65 2074 6865 7365 customize these │ │ │ │ │ -0000f740: 206c 6f63 6174 696f 6e73 2028 2a6e 6f74 locations (*not │ │ │ │ │ -0000f750: 6520 5374 616e 6461 7264 2044 6972 6563 e Standard Direc │ │ │ │ │ -0000f760: 746f 7279 0a56 6172 6961 626c 6573 3a3a tory.Variables:: │ │ │ │ │ -0000f770: 292e 2020 416e 7920 7375 6368 2064 6972 ). Any such dir │ │ │ │ │ -0000f780: 6563 746f 7279 2076 6172 6961 626c 6520 ectory variable │ │ │ │ │ -0000f790: 6361 6e20 6265 2070 7574 2069 6e20 6672 can be put in fr │ │ │ │ │ -0000f7a0: 6f6e 7420 6f66 2061 0a70 7269 6d61 7279 ont of a.primary │ │ │ │ │ -0000f7b0: 2028 6f6d 6974 7469 6e67 2074 6865 2027 (omitting the ' │ │ │ │ │ -0000f7c0: 6469 7227 2073 7566 6669 7829 2074 6f20 dir' suffix) to │ │ │ │ │ -0000f7d0: 7465 6c6c 2027 6175 746f 6d61 6b65 2720 tell 'automake' │ │ │ │ │ -0000f7e0: 7768 6572 6520 746f 2069 6e73 7461 6c6c where to install │ │ │ │ │ -0000f7f0: 0a74 6865 206c 6973 7465 6420 6669 6c65 .the listed file │ │ │ │ │ -0000f800: 732e 0a0a 2020 2050 726f 6772 616d 7320 s... Programs │ │ │ │ │ -0000f810: 6e65 6564 2074 6f20 6265 2062 7569 6c74 need to be built │ │ │ │ │ -0000f820: 2066 726f 6d20 736f 7572 6365 2066 696c from source fil │ │ │ │ │ -0000f830: 6573 2c20 736f 2066 6f72 2065 6163 6820 es, so for each │ │ │ │ │ -0000f840: 7072 6f67 7261 6d0a 2750 524f 4727 206c program.'PROG' l │ │ │ │ │ -0000f850: 6973 7465 6420 696e 2061 2027 5f50 524f isted in a '_PRO │ │ │ │ │ -0000f860: 4752 414d 5327 2076 6172 6961 626c 652c GRAMS' variable, │ │ │ │ │ -0000f870: 2027 6175 746f 6d61 6b65 2720 7769 6c6c 'automake' will │ │ │ │ │ -0000f880: 206c 6f6f 6b20 666f 720a 616e 6f74 6865 look for.anothe │ │ │ │ │ -0000f890: 7220 7661 7269 6162 6c65 206e 616d 6564 r variable named │ │ │ │ │ -0000f8a0: 2027 5052 4f47 5f53 4f55 5243 4553 2720 'PROG_SOURCES' │ │ │ │ │ -0000f8b0: 6c69 7374 696e 6720 6974 7320 736f 7572 listing its sour │ │ │ │ │ -0000f8c0: 6365 2066 696c 6573 2e20 2054 6865 7265 ce files. There │ │ │ │ │ -0000f8d0: 0a6d 6179 2062 6520 6d6f 7265 2074 6861 .may be more tha │ │ │ │ │ -0000f8e0: 6e20 6f6e 6520 736f 7572 6365 2066 696c n one source fil │ │ │ │ │ -0000f8f0: 653a 2074 6865 7920 7769 6c6c 2061 6c6c e: they will all │ │ │ │ │ -0000f900: 2062 6520 636f 6d70 696c 6564 2061 6e64 be compiled and │ │ │ │ │ -0000f910: 206c 696e 6b65 640a 746f 6765 7468 6572 linked.together │ │ │ │ │ -0000f920: 2e0a 0a20 2020 4175 746f 6d61 6b65 2061 ... Automake a │ │ │ │ │ -0000f930: 6c73 6f20 6b6e 6f77 7320 7468 6174 2073 lso knows that s │ │ │ │ │ -0000f940: 6f75 7263 6520 6669 6c65 7320 6e65 6564 ource files need │ │ │ │ │ -0000f950: 2074 6f20 6265 2064 6973 7472 6962 7574 to be distribut │ │ │ │ │ -0000f960: 6564 2077 6865 6e0a 6372 6561 7469 6e67 ed when.creating │ │ │ │ │ -0000f970: 2061 2074 6172 6261 6c6c 2028 756e 6c69 a tarball (unli │ │ │ │ │ -0000f980: 6b65 2062 7569 6c74 2070 726f 6772 616d ke built program │ │ │ │ │ -0000f990: 7329 2e20 2053 6f20 6120 7369 6465 2d65 s). So a side-e │ │ │ │ │ -0000f9a0: 6666 6563 7420 6f66 2074 6869 730a 2768 ffect of this.'h │ │ │ │ │ -0000f9b0: 656c 6c6f 5f53 4f55 5243 4553 2720 6465 ello_SOURCES' de │ │ │ │ │ -0000f9c0: 636c 6172 6174 696f 6e20 6973 2074 6861 claration is tha │ │ │ │ │ -0000f9d0: 7420 276d 6169 6e2e 6327 2077 696c 6c20 t 'main.c' will │ │ │ │ │ -0000f9e0: 6265 2070 6172 7420 6f66 2074 6865 2074 be part of the t │ │ │ │ │ -0000f9f0: 6172 6261 6c6c 0a63 7265 6174 6564 2062 arball.created b │ │ │ │ │ -0000fa00: 7920 276d 616b 6520 6469 7374 272e 0a0a y 'make dist'... │ │ │ │ │ -0000fa10: 2020 2046 696e 616c 6c79 2068 6572 6520 Finally here │ │ │ │ │ -0000fa20: 6172 6520 736f 6d65 2065 7870 6c61 6e61 are some explana │ │ │ │ │ -0000fa30: 7469 6f6e 7320 7265 6761 7264 696e 6720 tions regarding │ │ │ │ │ -0000fa40: 7468 6520 746f 702d 6c65 7665 6c0a 274d the top-level.'M │ │ │ │ │ -0000fa50: 616b 6566 696c 652e 616d 272e 0a0a 2020 akefile.am'... │ │ │ │ │ -0000fa60: 2020 2053 5542 4449 5253 203d 2073 7263 SUBDIRS = src │ │ │ │ │ -0000fa70: 0a20 2020 2020 6469 7374 5f64 6f63 5f44 . dist_doc_D │ │ │ │ │ -0000fa80: 4154 4120 3d20 5245 4144 4d45 0a0a 2020 ATA = README.. │ │ │ │ │ -0000fa90: 2027 5355 4244 4952 5327 2069 7320 6120 'SUBDIRS' is a │ │ │ │ │ -0000faa0: 7370 6563 6961 6c20 7661 7269 6162 6c65 special variable │ │ │ │ │ -0000fab0: 206c 6973 7469 6e67 2061 6c6c 2064 6972 listing all dir │ │ │ │ │ -0000fac0: 6563 746f 7269 6573 2074 6861 7420 276d ectories that 'm │ │ │ │ │ -0000fad0: 616b 6527 0a73 686f 756c 6420 7265 6375 ake'.should recu │ │ │ │ │ -0000fae0: 7273 6520 696e 746f 2062 6566 6f72 6520 rse into before │ │ │ │ │ -0000faf0: 7072 6f63 6573 7369 6e67 2074 6865 2063 processing the c │ │ │ │ │ -0000fb00: 7572 7265 6e74 2064 6972 6563 746f 7279 urrent directory │ │ │ │ │ -0000fb10: 2e20 2053 6f20 7468 6973 0a6c 696e 6520 . So this.line │ │ │ │ │ -0000fb20: 6973 2072 6573 706f 6e73 6962 6c65 2066 is responsible f │ │ │ │ │ -0000fb30: 6f72 2027 6d61 6b65 2720 6275 696c 6469 or 'make' buildi │ │ │ │ │ -0000fb40: 6e67 2027 7372 632f 6865 6c6c 6f27 2065 ng 'src/hello' e │ │ │ │ │ -0000fb50: 7665 6e20 7468 6f75 6768 2077 6520 7275 ven though we ru │ │ │ │ │ -0000fb60: 6e0a 6974 2066 726f 6d20 7468 6520 746f n.it from the to │ │ │ │ │ -0000fb70: 702d 6c65 7665 6c2e 2020 5468 6973 206c p-level. This l │ │ │ │ │ -0000fb80: 696e 6520 616c 736f 2063 6175 7365 7320 ine also causes │ │ │ │ │ -0000fb90: 276d 616b 6520 696e 7374 616c 6c27 2074 'make install' t │ │ │ │ │ -0000fba0: 6f20 696e 7374 616c 6c0a 2773 7263 2f68 o install.'src/h │ │ │ │ │ -0000fbb0: 656c 6c6f 2720 6265 666f 7265 2069 6e73 ello' before ins │ │ │ │ │ -0000fbc0: 7461 6c6c 696e 6720 2752 4541 444d 4527 talling 'README' │ │ │ │ │ -0000fbd0: 2028 6e6f 7420 7468 6174 2074 6869 7320 (not that this │ │ │ │ │ -0000fbe0: 6f72 6465 7220 6d61 7474 6572 7329 2e0a order matters).. │ │ │ │ │ -0000fbf0: 0a20 2020 5468 6520 6c69 6e65 2027 6469 . The line 'di │ │ │ │ │ -0000fc00: 7374 5f64 6f63 5f44 4154 4120 3d20 5245 st_doc_DATA = RE │ │ │ │ │ -0000fc10: 4144 4d45 2720 6361 7573 6573 2027 5245 ADME' causes 'RE │ │ │ │ │ -0000fc20: 4144 4d45 2720 746f 2062 6520 6469 7374 ADME' to be dist │ │ │ │ │ -0000fc30: 7269 6275 7465 640a 616e 6420 696e 7374 ributed.and inst │ │ │ │ │ -0000fc40: 616c 6c65 6420 696e 2044 4f43 4449 522e alled in DOCDIR. │ │ │ │ │ -0000fc50: 2020 4669 6c65 7320 6c69 7374 6564 2077 Files listed w │ │ │ │ │ -0000fc60: 6974 6820 7468 6520 275f 4441 5441 2720 ith the '_DATA' │ │ │ │ │ -0000fc70: 7072 696d 6172 7920 6172 6520 6e6f 740a primary are not. │ │ │ │ │ -0000fc80: 6175 746f 6d61 7469 6361 6c6c 7920 7061 automatically pa │ │ │ │ │ -0000fc90: 7274 206f 6620 7468 6520 7461 7262 616c rt of the tarbal │ │ │ │ │ -0000fca0: 6c20 6275 696c 7420 7769 7468 2027 6d61 l built with 'ma │ │ │ │ │ -0000fcb0: 6b65 2064 6973 7427 2c20 736f 2077 6520 ke dist', so we │ │ │ │ │ -0000fcc0: 6164 6420 7468 650a 2764 6973 745f 2720 add the.'dist_' │ │ │ │ │ -0000fcd0: 7072 6566 6978 2073 6f20 7468 6579 2067 prefix so they g │ │ │ │ │ -0000fce0: 6574 2064 6973 7472 6962 7574 6564 2e20 et distributed. │ │ │ │ │ -0000fcf0: 2048 6f77 6576 6572 2c20 666f 7220 2752 However, for 'R │ │ │ │ │ -0000fd00: 4541 444d 4527 2069 7420 776f 756c 640a EADME' it would. │ │ │ │ │ -0000fd10: 6e6f 7420 6861 7665 2062 6565 6e20 6e65 not have been ne │ │ │ │ │ -0000fd20: 6365 7373 6172 793a 2027 6175 746f 6d61 cessary: 'automa │ │ │ │ │ -0000fd30: 6b65 2720 6175 746f 6d61 7469 6361 6c6c ke' automaticall │ │ │ │ │ -0000fd40: 7920 6469 7374 7269 6275 7465 7320 616e y distributes an │ │ │ │ │ -0000fd50: 790a 2752 4541 444d 4527 2066 696c 6520 y.'README' file │ │ │ │ │ -0000fd60: 6974 2065 6e63 6f75 6e74 6572 7320 2874 it encounters (t │ │ │ │ │ -0000fd70: 6865 206c 6973 7420 6f66 206f 7468 6572 he list of other │ │ │ │ │ -0000fd80: 2066 696c 6573 2061 7574 6f6d 6174 6963 files automatic │ │ │ │ │ -0000fd90: 616c 6c79 0a64 6973 7472 6962 7574 6564 ally.distributed │ │ │ │ │ -0000fda0: 2069 7320 7072 6573 656e 7465 6420 6279 is presented by │ │ │ │ │ -0000fdb0: 2027 6175 746f 6d61 6b65 202d 2d68 656c 'automake --hel │ │ │ │ │ -0000fdc0: 7027 292e 2020 5468 6520 6f6e 6c79 2069 p'). The only i │ │ │ │ │ -0000fdd0: 6d70 6f72 7461 6e74 0a65 6666 6563 7420 mportant.effect │ │ │ │ │ -0000fde0: 6f66 2074 6869 7320 7365 636f 6e64 206c of this second l │ │ │ │ │ -0000fdf0: 696e 6520 6973 2074 6865 7265 666f 7265 ine is therefore │ │ │ │ │ -0000fe00: 2074 6f20 696e 7374 616c 6c20 2752 4541 to install 'REA │ │ │ │ │ -0000fe10: 444d 4527 2064 7572 696e 6720 276d 616b DME' during 'mak │ │ │ │ │ -0000fe20: 650a 696e 7374 616c 6c27 2e0a 0a20 2020 e.install'... │ │ │ │ │ -0000fe30: 4f6e 6520 7468 696e 6720 6e6f 7420 636f One thing not co │ │ │ │ │ -0000fe40: 7665 7265 6420 696e 2074 6869 7320 6578 vered in this ex │ │ │ │ │ -0000fe50: 616d 706c 6520 6973 2061 6363 6573 7369 ample is accessi │ │ │ │ │ -0000fe60: 6e67 2074 6865 2069 6e73 7461 6c6c 6174 ng the installat │ │ │ │ │ -0000fe70: 696f 6e0a 6469 7265 6374 6f72 7920 7661 ion.directory va │ │ │ │ │ -0000fe80: 6c75 6573 2028 2a6e 6f74 6520 5374 616e lues (*note Stan │ │ │ │ │ -0000fe90: 6461 7264 2044 6972 6563 746f 7279 2056 dard Directory V │ │ │ │ │ -0000fea0: 6172 6961 626c 6573 3a3a 2920 6672 6f6d ariables::) from │ │ │ │ │ -0000feb0: 2079 6f75 720a 7072 6f67 7261 6d20 636f your.program co │ │ │ │ │ -0000fec0: 6465 2c20 7468 6174 2069 732c 2063 6f6e de, that is, con │ │ │ │ │ -0000fed0: 7665 7274 696e 6720 7468 656d 2069 6e74 verting them int │ │ │ │ │ -0000fee0: 6f20 6465 6669 6e65 6420 6d61 6372 6f73 o defined macros │ │ │ │ │ -0000fef0: 2e20 2046 6f72 2074 6869 732c 0a2a 6e6f . For this,.*no │ │ │ │ │ -0000ff00: 7465 2028 6175 746f 636f 6e66 2944 6566 te (autoconf)Def │ │ │ │ │ -0000ff10: 696e 696e 6720 4469 7265 6374 6f72 6965 ining Directorie │ │ │ │ │ -0000ff20: 733a 3a2e 0a0a 1f0a 4669 6c65 3a20 6175 s::.....File: au │ │ │ │ │ -0000ff30: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -0000ff40: 2c20 204e 6f64 653a 2047 656e 6572 616c , Node: General │ │ │ │ │ -0000ff50: 6974 6965 732c 2020 4e65 7874 3a20 4578 ities, Next: Ex │ │ │ │ │ -0000ff60: 616d 706c 6573 2c20 2050 7265 763a 2041 amples, Prev: A │ │ │ │ │ -0000ff70: 7574 6f74 6f6f 6c73 2049 6e74 726f 6475 utotools Introdu │ │ │ │ │ -0000ff80: 6374 696f 6e2c 2020 5570 3a20 546f 700a ction, Up: Top. │ │ │ │ │ -0000ff90: 0a33 2047 656e 6572 616c 2069 6465 6173 .3 General ideas │ │ │ │ │ -0000ffa0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -0000ffb0: 0a0a 5468 6520 666f 6c6c 6f77 696e 6720 ..The following │ │ │ │ │ -0000ffc0: 7365 6374 696f 6e73 2063 6f76 6572 2061 sections cover a │ │ │ │ │ -0000ffd0: 2066 6577 2062 6173 6963 2069 6465 6173 few basic ideas │ │ │ │ │ -0000ffe0: 2074 6861 7420 7769 6c6c 2068 656c 7020 that will help │ │ │ │ │ -0000fff0: 796f 750a 756e 6465 7273 7461 6e64 2068 you.understand h │ │ │ │ │ -00010000: 6f77 2041 7574 6f6d 616b 6520 776f 726b ow Automake work │ │ │ │ │ -00010010: 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047 s...* Menu:..* G │ │ │ │ │ -00010020: 656e 6572 616c 204f 7065 7261 7469 6f6e eneral Operation │ │ │ │ │ -00010030: 3a3a 2020 2020 2020 2020 2020 2047 656e :: Gen │ │ │ │ │ -00010040: 6572 616c 206f 7065 7261 7469 6f6e 206f eral operation o │ │ │ │ │ -00010050: 6620 4175 746f 6d61 6b65 0a2a 2053 7472 f Automake.* Str │ │ │ │ │ -00010060: 6963 746e 6573 733a 3a20 2020 2020 2020 ictness:: │ │ │ │ │ -00010070: 2020 2020 2020 2020 2020 2053 7461 6e64 Stand │ │ │ │ │ -00010080: 6172 6473 2063 6f6e 666f 726d 616e 6365 ards conformance │ │ │ │ │ -00010090: 2063 6865 636b 696e 670a 2a20 556e 6966 checking.* Unif │ │ │ │ │ -000100a0: 6f72 6d3a 3a20 2020 2020 2020 2020 2020 orm:: │ │ │ │ │ -000100b0: 2020 2020 2020 2020 2020 5468 6520 556e The Un │ │ │ │ │ -000100c0: 6966 6f72 6d20 4e61 6d69 6e67 2053 6368 iform Naming Sch │ │ │ │ │ -000100d0: 656d 650a 2a20 4c65 6e67 7468 204c 696d eme.* Length Lim │ │ │ │ │ -000100e0: 6974 6174 696f 6e73 3a3a 2020 2020 2020 itations:: │ │ │ │ │ -000100f0: 2020 2020 5374 6179 696e 6720 6265 6c6f Staying belo │ │ │ │ │ -00010100: 7720 7468 6520 636f 6d6d 616e 6420 6c69 w the command li │ │ │ │ │ -00010110: 6e65 206c 656e 6774 6820 6c69 6d69 740a ne length limit. │ │ │ │ │ -00010120: 2a20 4361 6e6f 6e69 6361 6c69 7a61 7469 * Canonicalizati │ │ │ │ │ -00010130: 6f6e 3a3a 2020 2020 2020 2020 2020 2020 on:: │ │ │ │ │ -00010140: 486f 7720 6465 7269 7665 6420 7661 7269 How derived vari │ │ │ │ │ -00010150: 6162 6c65 7320 6172 6520 6e61 6d65 640a ables are named. │ │ │ │ │ -00010160: 2a20 5573 6572 2056 6172 6961 626c 6573 * User Variables │ │ │ │ │ -00010170: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00010180: 5661 7269 6162 6c65 7320 7265 7365 7276 Variables reserv │ │ │ │ │ -00010190: 6564 2066 6f72 2074 6865 2075 7365 720a ed for the user. │ │ │ │ │ -000101a0: 2a20 4175 7869 6c69 6172 7920 5072 6f67 * Auxiliary Prog │ │ │ │ │ -000101b0: 7261 6d73 3a3a 2020 2020 2020 2020 2020 rams:: │ │ │ │ │ -000101c0: 5072 6f67 7261 6d73 2061 7574 6f6d 616b Programs automak │ │ │ │ │ -000101d0: 6520 6d69 6768 7420 7265 7175 6972 650a e might require. │ │ │ │ │ -000101e0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -000101f0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -00010200: 6465 3a20 4765 6e65 7261 6c20 4f70 6572 de: General Oper │ │ │ │ │ -00010210: 6174 696f 6e2c 2020 4e65 7874 3a20 5374 ation, Next: St │ │ │ │ │ -00010220: 7269 6374 6e65 7373 2c20 2055 703a 2047 rictness, Up: G │ │ │ │ │ -00010230: 656e 6572 616c 6974 6965 730a 0a33 2e31 eneralities..3.1 │ │ │ │ │ -00010240: 2047 656e 6572 616c 204f 7065 7261 7469 General Operati │ │ │ │ │ -00010250: 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d on.============= │ │ │ │ │ -00010260: 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 ========..Automa │ │ │ │ │ -00010270: 6b65 2077 6f72 6b73 2062 7920 7265 6164 ke works by read │ │ │ │ │ -00010280: 696e 6720 6120 274d 616b 6566 696c 652e ing a 'Makefile. │ │ │ │ │ -00010290: 616d 2720 616e 6420 6765 6e65 7261 7469 am' and generati │ │ │ │ │ -000102a0: 6e67 2061 0a27 4d61 6b65 6669 6c65 2e69 ng a.'Makefile.i │ │ │ │ │ -000102b0: 6e27 2e20 2043 6572 7461 696e 2076 6172 n'. Certain var │ │ │ │ │ -000102c0: 6961 626c 6573 2061 6e64 2072 756c 6573 iables and rules │ │ │ │ │ -000102d0: 2064 6566 696e 6564 2069 6e20 7468 6520 defined in the │ │ │ │ │ -000102e0: 274d 616b 6566 696c 652e 616d 270a 696e 'Makefile.am'.in │ │ │ │ │ -000102f0: 7374 7275 6374 2041 7574 6f6d 616b 6520 struct Automake │ │ │ │ │ -00010300: 746f 2067 656e 6572 6174 6520 6d6f 7265 to generate more │ │ │ │ │ -00010310: 2073 7065 6369 616c 697a 6564 2063 6f64 specialized cod │ │ │ │ │ -00010320: 653b 2066 6f72 2069 6e73 7461 6e63 652c e; for instance, │ │ │ │ │ -00010330: 2061 0a27 6269 6e5f 5052 4f47 5241 4d53 a.'bin_PROGRAMS │ │ │ │ │ -00010340: 2720 7661 7269 6162 6c65 2064 6566 696e ' variable defin │ │ │ │ │ -00010350: 6974 696f 6e20 7769 6c6c 2063 6175 7365 ition will cause │ │ │ │ │ -00010360: 2072 756c 6573 2066 6f72 2063 6f6d 7069 rules for compi │ │ │ │ │ -00010370: 6c69 6e67 2061 6e64 0a6c 696e 6b69 6e67 ling and.linking │ │ │ │ │ -00010380: 2070 726f 6772 616d 7320 746f 2062 6520 programs to be │ │ │ │ │ -00010390: 6765 6e65 7261 7465 642e 0a0a 2020 2054 generated... T │ │ │ │ │ -000103a0: 6865 2076 6172 6961 626c 6520 6465 6669 he variable defi │ │ │ │ │ -000103b0: 6e69 7469 6f6e 7320 616e 6420 7275 6c65 nitions and rule │ │ │ │ │ -000103c0: 7320 696e 2074 6865 2027 4d61 6b65 6669 s in the 'Makefi │ │ │ │ │ -000103d0: 6c65 2e61 6d27 2061 7265 2063 6f70 6965 le.am' are copie │ │ │ │ │ -000103e0: 640a 6d6f 7374 6c79 2076 6572 6261 7469 d.mostly verbati │ │ │ │ │ -000103f0: 6d20 696e 746f 2074 6865 2067 656e 6572 m into the gener │ │ │ │ │ -00010400: 6174 6564 2066 696c 652c 2077 6974 6820 ated file, with │ │ │ │ │ -00010410: 616c 6c20 7661 7269 6162 6c65 2064 6566 all variable def │ │ │ │ │ -00010420: 696e 6974 696f 6e73 0a70 7265 6365 6469 initions.precedi │ │ │ │ │ -00010430: 6e67 2061 6c6c 2072 756c 6573 2e20 2054 ng all rules. T │ │ │ │ │ -00010440: 6869 7320 616c 6c6f 7773 2079 6f75 2074 his allows you t │ │ │ │ │ -00010450: 6f20 6164 6420 616c 6d6f 7374 2061 7262 o add almost arb │ │ │ │ │ -00010460: 6974 7261 7279 2063 6f64 6520 696e 746f itrary code into │ │ │ │ │ -00010470: 0a74 6865 2067 656e 6572 6174 6564 2027 .the generated ' │ │ │ │ │ -00010480: 4d61 6b65 6669 6c65 2e69 6e27 2e20 2046 Makefile.in'. F │ │ │ │ │ -00010490: 6f72 2069 6e73 7461 6e63 652c 2074 6865 or instance, the │ │ │ │ │ -000104a0: 2041 7574 6f6d 616b 6520 6469 7374 7269 Automake distri │ │ │ │ │ -000104b0: 6275 7469 6f6e 0a69 6e63 6c75 6465 7320 bution.includes │ │ │ │ │ -000104c0: 6120 6e6f 6e2d 7374 616e 6461 7264 2072 a non-standard r │ │ │ │ │ -000104d0: 756c 6520 666f 7220 7468 6520 2767 6974 ule for the 'git │ │ │ │ │ -000104e0: 2d64 6973 7427 2074 6172 6765 742c 2077 -dist' target, w │ │ │ │ │ -000104f0: 6869 6368 2074 6865 0a41 7574 6f6d 616b hich the.Automak │ │ │ │ │ -00010500: 6520 6d61 696e 7461 696e 6572 2075 7365 e maintainer use │ │ │ │ │ -00010510: 7320 746f 206d 616b 6520 6469 7374 7269 s to make distri │ │ │ │ │ -00010520: 6275 7469 6f6e 7320 6672 6f6d 2074 6865 butions from the │ │ │ │ │ -00010530: 2073 6f75 7263 6520 636f 6e74 726f 6c0a source control. │ │ │ │ │ -00010540: 7379 7374 656d 2e0a 0a20 2020 4e6f 7465 system... Note │ │ │ │ │ -00010550: 2074 6861 7420 6d6f 7374 2047 4e55 206d that most GNU m │ │ │ │ │ -00010560: 616b 6520 6578 7465 6e73 696f 6e73 2061 ake extensions a │ │ │ │ │ -00010570: 7265 206e 6f74 2072 6563 6f67 6e69 7a65 re not recognize │ │ │ │ │ -00010580: 6420 6279 2041 7574 6f6d 616b 652e 0a55 d by Automake..U │ │ │ │ │ -00010590: 7369 6e67 2073 7563 6820 6578 7465 6e73 sing such extens │ │ │ │ │ -000105a0: 696f 6e73 2069 6e20 6120 274d 616b 6566 ions in a 'Makef │ │ │ │ │ -000105b0: 696c 652e 616d 2720 7769 6c6c 206c 6561 ile.am' will lea │ │ │ │ │ -000105c0: 6420 746f 2065 7272 6f72 7320 6f72 0a63 d to errors or.c │ │ │ │ │ -000105d0: 6f6e 6675 7369 6e67 2062 6568 6176 696f onfusing behavio │ │ │ │ │ -000105e0: 722e 0a0a 2020 2041 2073 7065 6369 616c r... A special │ │ │ │ │ -000105f0: 2065 7863 6570 7469 6f6e 2069 7320 7468 exception is th │ │ │ │ │ -00010600: 6174 2074 6865 2047 4e55 206d 616b 6520 at the GNU make │ │ │ │ │ -00010610: 6170 7065 6e64 206f 7065 7261 746f 722c append operator, │ │ │ │ │ -00010620: 2027 2b3d 272c 2069 730a 7375 7070 6f72 '+=', is.suppor │ │ │ │ │ -00010630: 7465 642e 2020 5468 6973 206f 7065 7261 ted. This opera │ │ │ │ │ -00010640: 746f 7220 6170 7065 6e64 7320 6974 7320 tor appends its │ │ │ │ │ -00010650: 7269 6768 7420 6861 6e64 2061 7267 756d right hand argum │ │ │ │ │ -00010660: 656e 7420 746f 2074 6865 0a76 6172 6961 ent to the.varia │ │ │ │ │ -00010670: 626c 6520 7370 6563 6966 6965 6420 6f6e ble specified on │ │ │ │ │ -00010680: 2074 6865 206c 6566 742e 2020 4175 746f the left. Auto │ │ │ │ │ -00010690: 6d61 6b65 2077 696c 6c20 7472 616e 736c make will transl │ │ │ │ │ -000106a0: 6174 6520 7468 6520 6f70 6572 6174 6f72 ate the operator │ │ │ │ │ -000106b0: 0a69 6e74 6f20 616e 206f 7264 696e 6172 .into an ordinar │ │ │ │ │ -000106c0: 7920 273d 2720 6f70 6572 6174 6f72 3b20 y '=' operator; │ │ │ │ │ -000106d0: 272b 3d27 2077 696c 6c20 7468 7573 2077 '+=' will thus w │ │ │ │ │ -000106e0: 6f72 6b20 7769 7468 2061 6e79 206d 616b ork with any mak │ │ │ │ │ -000106f0: 650a 7072 6f67 7261 6d2e 0a0a 2020 2041 e.program... A │ │ │ │ │ -00010700: 7574 6f6d 616b 6520 7472 6965 7320 746f utomake tries to │ │ │ │ │ -00010710: 206b 6565 7020 636f 6d6d 656e 7473 2067 keep comments g │ │ │ │ │ -00010720: 726f 7570 6564 2077 6974 6820 616e 7920 rouped with any │ │ │ │ │ -00010730: 6164 6a6f 696e 696e 6720 7275 6c65 7320 adjoining rules │ │ │ │ │ -00010740: 6f72 0a76 6172 6961 626c 6520 6465 6669 or.variable defi │ │ │ │ │ -00010750: 6e69 7469 6f6e 732e 0a0a 2020 2047 656e nitions... Gen │ │ │ │ │ -00010760: 6572 616c 6c79 2c20 4175 746f 6d61 6b65 erally, Automake │ │ │ │ │ -00010770: 2069 7320 6e6f 7420 7061 7274 6963 756c is not particul │ │ │ │ │ -00010780: 6172 6c79 2073 6d61 7274 2069 6e20 7468 arly smart in th │ │ │ │ │ -00010790: 6520 7061 7273 696e 6720 6f66 0a75 6e75 e parsing of.unu │ │ │ │ │ -000107a0: 7375 616c 204d 616b 6566 696c 6520 636f sual Makefile co │ │ │ │ │ -000107b0: 6e73 7472 7563 7473 2c20 736f 2079 6f75 nstructs, so you │ │ │ │ │ -000107c0: 2772 6520 6164 7669 7365 6420 746f 2061 're advised to a │ │ │ │ │ -000107d0: 766f 6964 2066 616e 6379 2063 6f6e 7374 void fancy const │ │ │ │ │ -000107e0: 7275 6374 730a 6f72 2022 6372 6561 7469 ructs.or "creati │ │ │ │ │ -000107f0: 7665 2220 7573 6520 6f66 2077 6869 7465 ve" use of white │ │ │ │ │ -00010800: 7370 6163 6573 2e20 2046 6f72 2065 7861 spaces. For exa │ │ │ │ │ -00010810: 6d70 6c65 2c20 3c54 4142 3e20 6368 6172 mple, char │ │ │ │ │ -00010820: 6163 7465 7273 2063 616e 6e6f 740a 6265 acters cannot.be │ │ │ │ │ -00010830: 2075 7365 6420 6265 7477 6565 6e20 6120 used between a │ │ │ │ │ -00010840: 7461 7267 6574 206e 616d 6520 616e 6420 target name and │ │ │ │ │ -00010850: 7468 6520 666f 6c6c 6f77 696e 6720 2227 the following "' │ │ │ │ │ -00010860: 3a27 2220 6368 6172 6163 7465 722c 2061 :'" character, a │ │ │ │ │ -00010870: 6e64 0a76 6172 6961 626c 6520 6173 7369 nd.variable assi │ │ │ │ │ -00010880: 676e 6d65 6e74 7320 7368 6f75 6c64 6e27 gnments shouldn' │ │ │ │ │ -00010890: 7420 6265 2069 6e64 656e 7465 6420 7769 t be indented wi │ │ │ │ │ -000108a0: 7468 203c 5441 423e 2063 6861 7261 6374 th charact │ │ │ │ │ -000108b0: 6572 732e 2020 416c 736f 2c0a 7573 696e ers. Also,.usin │ │ │ │ │ -000108c0: 6720 6d6f 7265 2063 6f6d 706c 6578 206d g more complex m │ │ │ │ │ -000108d0: 6163 726f 2069 6e20 7461 7267 6574 206e acro in target n │ │ │ │ │ -000108e0: 616d 6573 2063 616e 2063 6175 7365 2074 ames can cause t │ │ │ │ │ -000108f0: 726f 7562 6c65 3a0a 0a20 2020 2020 2520 rouble:.. % │ │ │ │ │ -00010900: 6361 7420 4d61 6b65 6669 6c65 2e61 6d0a cat Makefile.am. │ │ │ │ │ -00010910: 2020 2020 2024 2846 4f4f 3a3d 7829 3a20 $(FOO:=x): │ │ │ │ │ -00010920: 6261 720a 2020 2020 2025 2061 7574 6f6d bar. % autom │ │ │ │ │ -00010930: 616b 650a 2020 2020 204d 616b 6566 696c ake. Makefil │ │ │ │ │ -00010940: 652e 616d 3a31 3a20 6261 6420 6368 6172 e.am:1: bad char │ │ │ │ │ -00010950: 6163 7465 7273 2069 6e20 7661 7269 6162 acters in variab │ │ │ │ │ -00010960: 6c65 206e 616d 6520 6024 2846 4f4f 270a le name `$(FOO'. │ │ │ │ │ -00010970: 2020 2020 204d 616b 6566 696c 652e 616d Makefile.am │ │ │ │ │ -00010980: 3a31 3a20 603a 3d27 2d73 7479 6c65 2061 :1: `:='-style a │ │ │ │ │ -00010990: 7373 6967 6e6d 656e 7473 2061 7265 206e ssignments are n │ │ │ │ │ -000109a0: 6f74 2070 6f72 7461 626c 650a 0a20 2020 ot portable.. │ │ │ │ │ -000109b0: 4120 7275 6c65 2064 6566 696e 6564 2069 A rule defined i │ │ │ │ │ -000109c0: 6e20 274d 616b 6566 696c 652e 616d 2720 n 'Makefile.am' │ │ │ │ │ -000109d0: 6765 6e65 7261 6c6c 7920 6f76 6572 7269 generally overri │ │ │ │ │ -000109e0: 6465 7320 616e 7920 7375 6368 2072 756c des any such rul │ │ │ │ │ -000109f0: 6520 6f66 0a61 2073 696d 696c 6172 206e e of.a similar n │ │ │ │ │ -00010a00: 616d 6520 7468 6174 2077 6f75 6c64 2062 ame that would b │ │ │ │ │ -00010a10: 6520 6175 746f 6d61 7469 6361 6c6c 7920 e automatically │ │ │ │ │ -00010a20: 6765 6e65 7261 7465 6420 6279 2027 6175 generated by 'au │ │ │ │ │ -00010a30: 746f 6d61 6b65 272e 0a41 6c74 686f 7567 tomake'..Althoug │ │ │ │ │ -00010a40: 6820 7468 6973 2069 7320 6120 7375 7070 h this is a supp │ │ │ │ │ -00010a50: 6f72 7465 6420 6665 6174 7572 652c 2069 orted feature, i │ │ │ │ │ -00010a60: 7420 6973 2067 656e 6572 616c 6c79 2062 t is generally b │ │ │ │ │ -00010a70: 6573 7420 746f 2061 766f 6964 0a6d 616b est to avoid.mak │ │ │ │ │ -00010a80: 696e 6720 7573 6520 6f66 2069 742c 2061 ing use of it, a │ │ │ │ │ -00010a90: 7320 736f 6d65 7469 6d65 7320 7468 6520 s sometimes the │ │ │ │ │ -00010aa0: 6765 6e65 7261 7465 6420 7275 6c65 7320 generated rules │ │ │ │ │ -00010ab0: 6172 6520 7665 7279 2070 6172 7469 6375 are very particu │ │ │ │ │ -00010ac0: 6c61 722e 0a0a 2020 2053 696d 696c 6172 lar... Similar │ │ │ │ │ -00010ad0: 6c79 2c20 6120 7661 7269 6162 6c65 2064 ly, a variable d │ │ │ │ │ -00010ae0: 6566 696e 6564 2069 6e20 274d 616b 6566 efined in 'Makef │ │ │ │ │ -00010af0: 696c 652e 616d 2720 6f72 2027 4143 5f53 ile.am' or 'AC_S │ │ │ │ │ -00010b00: 5542 5354 2765 6420 6672 6f6d 0a27 636f UBST'ed from.'co │ │ │ │ │ -00010b10: 6e66 6967 7572 652e 6163 2720 7769 6c6c nfigure.ac' will │ │ │ │ │ -00010b20: 206f 7665 7272 6964 6520 616e 7920 6465 override any de │ │ │ │ │ -00010b30: 6669 6e69 7469 6f6e 206f 6620 7468 6520 finition of the │ │ │ │ │ -00010b40: 7661 7269 6162 6c65 2074 6861 740a 2761 variable that.'a │ │ │ │ │ -00010b50: 7574 6f6d 616b 6527 2077 6f75 6c64 206f utomake' would o │ │ │ │ │ -00010b60: 7264 696e 6172 696c 7920 6372 6561 7465 rdinarily create │ │ │ │ │ -00010b70: 2e20 2054 6869 7320 6665 6174 7572 6520 . This feature │ │ │ │ │ -00010b80: 6973 206d 6f72 6520 6f66 7465 6e20 7573 is more often us │ │ │ │ │ -00010b90: 6566 756c 0a74 6861 6e20 7468 6520 6162 eful.than the ab │ │ │ │ │ -00010ba0: 696c 6974 7920 746f 206f 7665 7272 6964 ility to overrid │ │ │ │ │ -00010bb0: 6520 6120 7275 6c65 2e20 2042 6520 7761 e a rule. Be wa │ │ │ │ │ -00010bc0: 726e 6564 2074 6861 7420 6d61 6e79 206f rned that many o │ │ │ │ │ -00010bd0: 6620 7468 650a 7661 7269 6162 6c65 7320 f the.variables │ │ │ │ │ -00010be0: 6765 6e65 7261 7465 6420 6279 2027 6175 generated by 'au │ │ │ │ │ -00010bf0: 746f 6d61 6b65 2720 6172 6520 636f 6e73 tomake' are cons │ │ │ │ │ -00010c00: 6964 6572 6564 2074 6f20 6265 2066 6f72 idered to be for │ │ │ │ │ -00010c10: 2069 6e74 6572 6e61 6c20 7573 650a 6f6e internal use.on │ │ │ │ │ -00010c20: 6c79 2c20 616e 6420 7468 6569 7220 6e61 ly, and their na │ │ │ │ │ -00010c30: 6d65 7320 6d69 6768 7420 6368 616e 6765 mes might change │ │ │ │ │ -00010c40: 2069 6e20 6675 7475 7265 2072 656c 6561 in future relea │ │ │ │ │ -00010c50: 7365 732e 0a0a 2020 2057 6865 6e20 6578 ses... When ex │ │ │ │ │ -00010c60: 616d 696e 696e 6720 6120 7661 7269 6162 amining a variab │ │ │ │ │ -00010c70: 6c65 2064 6566 696e 6974 696f 6e2c 2041 le definition, A │ │ │ │ │ -00010c80: 7574 6f6d 616b 6520 7769 6c6c 2072 6563 utomake will rec │ │ │ │ │ -00010c90: 7572 7369 7665 6c79 0a65 7861 6d69 6e65 ursively.examine │ │ │ │ │ -00010ca0: 2076 6172 6961 626c 6573 2072 6566 6572 variables refer │ │ │ │ │ -00010cb0: 656e 6365 6420 696e 2074 6865 2064 6566 enced in the def │ │ │ │ │ -00010cc0: 696e 6974 696f 6e2e 2020 466f 7220 6578 inition. For ex │ │ │ │ │ -00010cd0: 616d 706c 652c 2069 660a 4175 746f 6d61 ample, if.Automa │ │ │ │ │ -00010ce0: 6b65 2069 7320 6c6f 6f6b 696e 6720 6174 ke is looking at │ │ │ │ │ -00010cf0: 2074 6865 2063 6f6e 7465 6e74 206f 6620 the content of │ │ │ │ │ -00010d00: 2766 6f6f 5f53 4f55 5243 4553 2720 696e 'foo_SOURCES' in │ │ │ │ │ -00010d10: 2074 6869 7320 736e 6970 7065 740a 0a20 this snippet.. │ │ │ │ │ -00010d20: 2020 2020 7873 203d 2061 2e63 2062 2e63 xs = a.c b.c │ │ │ │ │ -00010d30: 0a20 2020 2020 666f 6f5f 534f 5552 4345 . foo_SOURCE │ │ │ │ │ -00010d40: 5320 3d20 632e 6320 2428 7873 290a 0a20 S = c.c $(xs).. │ │ │ │ │ -00010d50: 2020 6974 2077 6f75 6c64 2075 7365 2074 it would use t │ │ │ │ │ -00010d60: 6865 2066 696c 6573 2027 612e 6327 2c20 he files 'a.c', │ │ │ │ │ -00010d70: 2762 2e63 272c 2061 6e64 2027 632e 6327 'b.c', and 'c.c' │ │ │ │ │ -00010d80: 2061 7320 7468 6520 636f 6e74 656e 7473 as the contents │ │ │ │ │ -00010d90: 206f 660a 2766 6f6f 5f53 4f55 5243 4553 of.'foo_SOURCES │ │ │ │ │ -00010da0: 272e 0a0a 2020 2041 7574 6f6d 616b 6520 '... Automake │ │ │ │ │ -00010db0: 616c 736f 2061 6c6c 6f77 7320 6120 666f also allows a fo │ │ │ │ │ -00010dc0: 726d 206f 6620 636f 6d6d 656e 7420 7468 rm of comment th │ │ │ │ │ -00010dd0: 6174 2069 7320 5f6e 6f74 5f20 636f 7069 at is _not_ copi │ │ │ │ │ -00010de0: 6564 2069 6e74 6f20 7468 650a 6f75 7470 ed into the.outp │ │ │ │ │ -00010df0: 7574 3b20 616c 6c20 6c69 6e65 7320 6265 ut; all lines be │ │ │ │ │ -00010e00: 6769 6e6e 696e 6720 7769 7468 2027 2323 ginning with '## │ │ │ │ │ -00010e10: 2720 286c 6561 6469 6e67 2073 7061 6365 ' (leading space │ │ │ │ │ -00010e20: 7320 616c 6c6f 7765 6429 2061 7265 0a63 s allowed) are.c │ │ │ │ │ -00010e30: 6f6d 706c 6574 656c 7920 6967 6e6f 7265 ompletely ignore │ │ │ │ │ -00010e40: 6420 6279 2041 7574 6f6d 616b 652e 0a0a d by Automake... │ │ │ │ │ -00010e50: 2020 2049 7420 6973 2063 7573 746f 6d61 It is customa │ │ │ │ │ -00010e60: 7279 2074 6f20 6d61 6b65 2074 6865 2066 ry to make the f │ │ │ │ │ -00010e70: 6972 7374 206c 696e 6520 6f66 2027 4d61 irst line of 'Ma │ │ │ │ │ -00010e80: 6b65 6669 6c65 2e61 6d27 2072 6561 643a kefile.am' read: │ │ │ │ │ -00010e90: 0a0a 2020 2020 2023 2320 5072 6f63 6573 .. ## Proces │ │ │ │ │ -00010ea0: 7320 7468 6973 2066 696c 6520 7769 7468 s this file with │ │ │ │ │ -00010eb0: 2061 7574 6f6d 616b 6520 746f 2070 726f automake to pro │ │ │ │ │ -00010ec0: 6475 6365 204d 616b 6566 696c 652e 696e duce Makefile.in │ │ │ │ │ -00010ed0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00010ee0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00010ef0: 6f64 653a 2053 7472 6963 746e 6573 732c ode: Strictness, │ │ │ │ │ -00010f00: 2020 4e65 7874 3a20 556e 6966 6f72 6d2c Next: Uniform, │ │ │ │ │ -00010f10: 2020 5072 6576 3a20 4765 6e65 7261 6c20 Prev: General │ │ │ │ │ -00010f20: 4f70 6572 6174 696f 6e2c 2020 5570 3a20 Operation, Up: │ │ │ │ │ -00010f30: 4765 6e65 7261 6c69 7469 6573 0a0a 332e Generalities..3. │ │ │ │ │ -00010f40: 3220 5374 7269 6374 6e65 7373 0a3d 3d3d 2 Strictness.=== │ │ │ │ │ -00010f50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a57 6869 ===========..Whi │ │ │ │ │ -00010f60: 6c65 2041 7574 6f6d 616b 6520 6973 2069 le Automake is i │ │ │ │ │ -00010f70: 6e74 656e 6465 6420 746f 2062 6520 7573 ntended to be us │ │ │ │ │ -00010f80: 6564 2062 7920 6d61 696e 7461 696e 6572 ed by maintainer │ │ │ │ │ -00010f90: 7320 6f66 2047 4e55 2070 6163 6b61 6765 s of GNU package │ │ │ │ │ -00010fa0: 732c 2069 740a 646f 6573 206d 616b 6520 s, it.does make │ │ │ │ │ -00010fb0: 736f 6d65 2065 6666 6f72 7420 746f 2061 some effort to a │ │ │ │ │ -00010fc0: 6363 6f6d 6d6f 6461 7465 2074 686f 7365 ccommodate those │ │ │ │ │ -00010fd0: 2077 686f 2077 6973 6820 746f 2075 7365 who wish to use │ │ │ │ │ -00010fe0: 2069 742c 2062 7574 2064 6f0a 6e6f 7420 it, but do.not │ │ │ │ │ -00010ff0: 7761 6e74 2074 6f20 7573 6520 616c 6c20 want to use all │ │ │ │ │ -00011000: 7468 6520 474e 5520 636f 6e76 656e 7469 the GNU conventi │ │ │ │ │ -00011010: 6f6e 732e 0a0a 2020 2054 6f20 7468 6973 ons... To this │ │ │ │ │ -00011020: 2065 6e64 2c20 4175 746f 6d61 6b65 2073 end, Automake s │ │ │ │ │ -00011030: 7570 706f 7274 7320 7468 7265 6520 6c65 upports three le │ │ │ │ │ -00011040: 7665 6c73 206f 6620 2273 7472 6963 746e vels of "strictn │ │ │ │ │ -00011050: 6573 7322 2d2d 7468 650a 7374 7269 6374 ess"--the.strict │ │ │ │ │ -00011060: 6e65 7373 2069 6e64 6963 6174 696e 6720 ness indicating │ │ │ │ │ -00011070: 686f 7720 7374 7269 6e67 656e 746c 7920 how stringently │ │ │ │ │ -00011080: 4175 746f 6d61 6b65 2073 686f 756c 6420 Automake should │ │ │ │ │ -00011090: 6368 6563 6b20 7374 616e 6461 7264 730a check standards. │ │ │ │ │ -000110a0: 636f 6e66 6f72 6d61 6e63 652e 0a0a 2020 conformance... │ │ │ │ │ -000110b0: 2054 6865 2076 616c 6964 2073 7472 6963 The valid stric │ │ │ │ │ -000110c0: 746e 6573 7320 6c65 7665 6c73 2061 7265 tness levels are │ │ │ │ │ -000110d0: 3a0a 0a27 666f 7265 6967 6e27 0a20 2020 :..'foreign'. │ │ │ │ │ -000110e0: 2020 4175 746f 6d61 6b65 2077 696c 6c20 Automake will │ │ │ │ │ -000110f0: 6368 6563 6b20 666f 7220 6f6e 6c79 2074 check for only t │ │ │ │ │ -00011100: 686f 7365 2074 6869 6e67 7320 7468 6174 hose things that │ │ │ │ │ -00011110: 2061 7265 2061 6273 6f6c 7574 656c 790a are absolutely. │ │ │ │ │ -00011120: 2020 2020 2072 6571 7569 7265 6420 666f required fo │ │ │ │ │ -00011130: 7220 7072 6f70 6572 206f 7065 7261 7469 r proper operati │ │ │ │ │ -00011140: 6f6e 732e 2020 466f 7220 696e 7374 616e ons. For instan │ │ │ │ │ -00011150: 6365 2c20 7768 6572 6561 7320 474e 550a ce, whereas GNU. │ │ │ │ │ -00011160: 2020 2020 2073 7461 6e64 6172 6473 2064 standards d │ │ │ │ │ -00011170: 6963 7461 7465 2074 6865 2065 7869 7374 ictate the exist │ │ │ │ │ -00011180: 656e 6365 206f 6620 6120 274e 4557 5327 ence of a 'NEWS' │ │ │ │ │ -00011190: 2066 696c 652c 2069 7420 7769 6c6c 206e file, it will n │ │ │ │ │ -000111a0: 6f74 2062 650a 2020 2020 2072 6571 7569 ot be. requi │ │ │ │ │ -000111b0: 7265 6420 696e 2074 6869 7320 6d6f 6465 red in this mode │ │ │ │ │ -000111c0: 2e20 2054 6865 206e 616d 6520 636f 6d65 . The name come │ │ │ │ │ -000111d0: 7320 6672 6f6d 2074 6865 2066 6163 7420 s from the fact │ │ │ │ │ -000111e0: 7468 6174 2041 7574 6f6d 616b 650a 2020 that Automake. │ │ │ │ │ -000111f0: 2020 2069 7320 696e 7465 6e64 6564 2074 is intended t │ │ │ │ │ -00011200: 6f20 6265 2075 7365 6420 666f 7220 474e o be used for GN │ │ │ │ │ -00011210: 5520 7072 6f67 7261 6d73 3b20 7468 6573 U programs; thes │ │ │ │ │ -00011220: 6520 7265 6c61 7865 6420 7275 6c65 7320 e relaxed rules │ │ │ │ │ -00011230: 6172 650a 2020 2020 206e 6f74 2074 6865 are. not the │ │ │ │ │ -00011240: 2073 7461 6e64 6172 6420 6d6f 6465 206f standard mode o │ │ │ │ │ -00011250: 6620 6f70 6572 6174 696f 6e2e 0a0a 2767 f operation...'g │ │ │ │ │ -00011260: 6e75 270a 2020 2020 2041 7574 6f6d 616b nu'. Automak │ │ │ │ │ -00011270: 6520 7769 6c6c 2063 6865 636b 2d2d 6173 e will check--as │ │ │ │ │ -00011280: 206d 7563 6820 6173 2070 6f73 7369 626c much as possibl │ │ │ │ │ -00011290: 652d 2d66 6f72 2063 6f6d 706c 6961 6e63 e--for complianc │ │ │ │ │ -000112a0: 6520 746f 2074 6865 2047 4e55 0a20 2020 e to the GNU. │ │ │ │ │ -000112b0: 2020 7374 616e 6461 7264 7320 666f 7220 standards for │ │ │ │ │ -000112c0: 7061 636b 6167 6573 2e20 2054 6869 7320 packages. This │ │ │ │ │ -000112d0: 6973 2074 6865 2064 6566 6175 6c74 2e0a is the default.. │ │ │ │ │ -000112e0: 0a27 676e 6974 7327 0a20 2020 2020 4175 .'gnits'. Au │ │ │ │ │ -000112f0: 746f 6d61 6b65 2077 696c 6c20 6368 6563 tomake will chec │ │ │ │ │ -00011300: 6b20 666f 7220 636f 6d70 6c69 616e 6365 k for compliance │ │ │ │ │ -00011310: 2074 6f20 7468 6520 6173 2d79 6574 2d75 to the as-yet-u │ │ │ │ │ -00011320: 6e77 7269 7474 656e 2022 476e 6974 730a nwritten "Gnits. │ │ │ │ │ -00011330: 2020 2020 2073 7461 6e64 6172 6473 222e standards". │ │ │ │ │ -00011340: 2020 5468 6573 6520 6172 6520 6261 7365 These are base │ │ │ │ │ -00011350: 6420 6f6e 2074 6865 2047 4e55 2073 7461 d on the GNU sta │ │ │ │ │ -00011360: 6e64 6172 6473 2c20 6275 7420 6172 6520 ndards, but are │ │ │ │ │ -00011370: 6576 656e 0a20 2020 2020 6d6f 7265 2064 even. more d │ │ │ │ │ -00011380: 6574 6169 6c65 642e 2020 556e 6c65 7373 etailed. Unless │ │ │ │ │ -00011390: 2079 6f75 2061 7265 2061 2047 6e69 7473 you are a Gnits │ │ │ │ │ -000113a0: 2073 7461 6e64 6172 6473 2063 6f6e 7472 standards contr │ │ │ │ │ -000113b0: 6962 7574 6f72 2c20 6974 2069 730a 2020 ibutor, it is. │ │ │ │ │ -000113c0: 2020 2072 6563 6f6d 6d65 6e64 6564 2074 recommended t │ │ │ │ │ -000113d0: 6861 7420 796f 7520 6176 6f69 6420 7468 hat you avoid th │ │ │ │ │ -000113e0: 6973 206f 7074 696f 6e20 756e 7469 6c20 is option until │ │ │ │ │ -000113f0: 7375 6368 2074 696d 6520 6173 2074 6865 such time as the │ │ │ │ │ -00011400: 2047 6e69 7473 0a20 2020 2020 7374 616e Gnits. stan │ │ │ │ │ -00011410: 6461 7264 2069 7320 6163 7475 616c 6c79 dard is actually │ │ │ │ │ -00011420: 2070 7562 6c69 7368 6564 2028 7768 6963 published (whic │ │ │ │ │ -00011430: 6820 6d61 7920 6e65 7665 7220 6861 7070 h may never happ │ │ │ │ │ -00011440: 656e 292e 0a0a 2020 202a 4e6f 7465 2047 en)... *Note G │ │ │ │ │ -00011450: 6e69 7473 3a3a 2c20 666f 7220 6d6f 7265 nits::, for more │ │ │ │ │ -00011460: 2069 6e66 6f72 6d61 7469 6f6e 206f 6e20 information on │ │ │ │ │ -00011470: 7468 6520 7072 6563 6973 6520 696d 706c the precise impl │ │ │ │ │ -00011480: 6963 6174 696f 6e73 206f 660a 7468 6520 ications of.the │ │ │ │ │ -00011490: 7374 7269 6374 6e65 7373 206c 6576 656c strictness level │ │ │ │ │ -000114a0: 2e0a 0a20 2020 4175 746f 6d61 6b65 2061 ... Automake a │ │ │ │ │ -000114b0: 6c73 6f20 6861 7320 6120 7370 6563 6961 lso has a specia │ │ │ │ │ -000114c0: 6c20 2861 6e64 205f 746f 6461 7920 6465 l (and _today de │ │ │ │ │ -000114d0: 7072 6563 6174 6564 5f29 2022 6379 676e precated_) "cygn │ │ │ │ │ -000114e0: 7573 2220 6d6f 6465 0a74 6861 7420 6973 us" mode.that is │ │ │ │ │ -000114f0: 2073 696d 696c 6172 2074 6f20 7374 7269 similar to stri │ │ │ │ │ -00011500: 6374 6e65 7373 2062 7574 2068 616e 646c ctness but handl │ │ │ │ │ -00011510: 6564 2064 6966 6665 7265 6e74 6c79 2e20 ed differently. │ │ │ │ │ -00011520: 2054 6869 7320 6d6f 6465 2069 730a 7573 This mode is.us │ │ │ │ │ -00011530: 6566 756c 2066 6f72 2070 6163 6b61 6765 eful for package │ │ │ │ │ -00011540: 7320 7468 6174 2061 7265 2070 7574 2069 s that are put i │ │ │ │ │ -00011550: 6e74 6f20 6120 2243 7967 6e75 7322 2073 nto a "Cygnus" s │ │ │ │ │ -00011560: 7479 6c65 2074 7265 6520 2865 2e67 2e2c tyle tree (e.g., │ │ │ │ │ -00011570: 206f 6c64 6572 0a76 6572 7369 6f6e 7320 older.versions │ │ │ │ │ -00011580: 6f66 2074 6865 2047 4343 2061 6e64 2067 of the GCC and g │ │ │ │ │ -00011590: 6462 2074 7265 6573 292e 2020 2a4e 6f74 db trees). *Not │ │ │ │ │ -000115a0: 6520 4379 676e 7573 3a3a 2c20 666f 7220 e Cygnus::, for │ │ │ │ │ -000115b0: 6d6f 7265 0a69 6e66 6f72 6d61 7469 6f6e more.information │ │ │ │ │ -000115c0: 206f 6e20 7468 6973 206d 6f64 652e 2020 on this mode. │ │ │ │ │ -000115d0: 506c 6561 7365 206e 6f74 6520 7468 6174 Please note that │ │ │ │ │ -000115e0: 2074 6869 7320 6d6f 6465 2069 7320 6465 this mode is de │ │ │ │ │ -000115f0: 7072 6563 6174 6564 2061 6e64 0a5f 7769 precated and._wi │ │ │ │ │ -00011600: 6c6c 2062 6520 7265 6d6f 7665 6420 696e ll be removed in │ │ │ │ │ -00011610: 2074 6865 2066 7574 7572 6520 6175 746f the future auto │ │ │ │ │ -00011620: 6d61 6b65 2076 6572 7369 6f6e 735f 3b20 make versions_; │ │ │ │ │ -00011630: 796f 7520 6d75 7374 2061 766f 6964 2069 you must avoid i │ │ │ │ │ -00011640: 7473 0a75 7365 2069 6e20 6e65 7720 7061 ts.use in new pa │ │ │ │ │ -00011650: 636b 6167 6573 2c20 616e 6420 7368 6f75 ckages, and shou │ │ │ │ │ -00011660: 6c64 2073 746f 7020 7573 696e 6720 6974 ld stop using it │ │ │ │ │ -00011670: 2069 6e20 6578 6973 7469 6e67 2070 6163 in existing pac │ │ │ │ │ -00011680: 6b61 6765 7320 6173 0a77 656c 6c2e 0a0a kages as.well... │ │ │ │ │ -00011690: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -000116a0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -000116b0: 653a 2055 6e69 666f 726d 2c20 204e 6578 e: Uniform, Nex │ │ │ │ │ -000116c0: 743a 204c 656e 6774 6820 4c69 6d69 7461 t: Length Limita │ │ │ │ │ -000116d0: 7469 6f6e 732c 2020 5072 6576 3a20 5374 tions, Prev: St │ │ │ │ │ -000116e0: 7269 6374 6e65 7373 2c20 2055 703a 2047 rictness, Up: G │ │ │ │ │ -000116f0: 656e 6572 616c 6974 6965 730a 0a33 2e33 eneralities..3.3 │ │ │ │ │ -00011700: 2054 6865 2055 6e69 666f 726d 204e 616d The Uniform Nam │ │ │ │ │ -00011710: 696e 6720 5363 6865 6d65 0a3d 3d3d 3d3d ing Scheme.===== │ │ │ │ │ +0000f260: 2d2d 2d2d 2d2d 2d0a 0a57 6520 6e6f 7720 -------..We now │ │ │ │ │ +0000f270: 7475 726e 2074 6f20 2773 7263 2f4d 616b turn to 'src/Mak │ │ │ │ │ +0000f280: 6566 696c 652e 616d 272e 2020 5468 6973 efile.am'. This │ │ │ │ │ +0000f290: 2066 696c 6520 636f 6e74 6169 6e73 2041 file contains A │ │ │ │ │ +0000f2a0: 7574 6f6d 616b 650a 696e 7374 7275 6374 utomake.instruct │ │ │ │ │ +0000f2b0: 696f 6e73 2074 6f20 6275 696c 6420 616e ions to build an │ │ │ │ │ +0000f2c0: 6420 696e 7374 616c 6c20 2768 656c 6c6f d install 'hello │ │ │ │ │ +0000f2d0: 272e 0a0a 2020 2020 2062 696e 5f50 524f '... bin_PRO │ │ │ │ │ +0000f2e0: 4752 414d 5320 3d20 6865 6c6c 6f0a 2020 GRAMS = hello. │ │ │ │ │ +0000f2f0: 2020 2068 656c 6c6f 5f53 4f55 5243 4553 hello_SOURCES │ │ │ │ │ +0000f300: 203d 206d 6169 6e2e 630a 0a20 2020 4120 = main.c.. A │ │ │ │ │ +0000f310: 274d 616b 6566 696c 652e 616d 2720 6861 'Makefile.am' ha │ │ │ │ │ +0000f320: 7320 7468 6520 7361 6d65 2073 796e 7461 s the same synta │ │ │ │ │ +0000f330: 7820 6173 2061 6e20 6f72 6469 6e61 7279 x as an ordinary │ │ │ │ │ +0000f340: 2027 4d61 6b65 6669 6c65 272e 2020 5768 'Makefile'. Wh │ │ │ │ │ +0000f350: 656e 0a27 6175 746f 6d61 6b65 2720 7072 en.'automake' pr │ │ │ │ │ +0000f360: 6f63 6573 7365 7320 6120 274d 616b 6566 ocesses a 'Makef │ │ │ │ │ +0000f370: 696c 652e 616d 2720 6974 2063 6f70 6965 ile.am' it copie │ │ │ │ │ +0000f380: 7320 7468 6520 656e 7469 7265 2066 696c s the entire fil │ │ │ │ │ +0000f390: 6520 696e 746f 2074 6865 0a6f 7574 7075 e into the.outpu │ │ │ │ │ +0000f3a0: 7420 274d 616b 6566 696c 652e 696e 2720 t 'Makefile.in' │ │ │ │ │ +0000f3b0: 2874 6861 7420 7769 6c6c 2062 6520 6c61 (that will be la │ │ │ │ │ +0000f3c0: 7465 7220 7475 726e 6564 2069 6e74 6f20 ter turned into │ │ │ │ │ +0000f3d0: 274d 616b 6566 696c 6527 2062 790a 2763 'Makefile' by.'c │ │ │ │ │ +0000f3e0: 6f6e 6669 6775 7265 2729 2062 7574 2077 onfigure') but w │ │ │ │ │ +0000f3f0: 696c 6c20 7265 6163 7420 746f 2063 6572 ill react to cer │ │ │ │ │ +0000f400: 7461 696e 2076 6172 6961 626c 6520 6465 tain variable de │ │ │ │ │ +0000f410: 6669 6e69 7469 6f6e 7320 6279 0a67 656e finitions by.gen │ │ │ │ │ +0000f420: 6572 6174 696e 6720 736f 6d65 2062 7569 erating some bui │ │ │ │ │ +0000f430: 6c64 2072 756c 6573 2061 6e64 206f 7468 ld rules and oth │ │ │ │ │ +0000f440: 6572 2076 6172 6961 626c 6573 2e20 204f er variables. O │ │ │ │ │ +0000f450: 6674 656e 2027 4d61 6b65 6669 6c65 2e61 ften 'Makefile.a │ │ │ │ │ +0000f460: 6d27 730a 636f 6e74 6169 6e20 6f6e 6c79 m's.contain only │ │ │ │ │ +0000f470: 2061 206c 6973 7420 6f66 2076 6172 6961 a list of varia │ │ │ │ │ +0000f480: 626c 6520 6465 6669 6e69 7469 6f6e 7320 ble definitions │ │ │ │ │ +0000f490: 6173 2061 626f 7665 2c20 6275 7420 7468 as above, but th │ │ │ │ │ +0000f4a0: 6579 2063 616e 2061 6c73 6f0a 636f 6e74 ey can also.cont │ │ │ │ │ +0000f4b0: 6169 6e20 6f74 6865 7220 7661 7269 6162 ain other variab │ │ │ │ │ +0000f4c0: 6c65 2061 6e64 2072 756c 6520 6465 6669 le and rule defi │ │ │ │ │ +0000f4d0: 6e69 7469 6f6e 7320 7468 6174 2027 6175 nitions that 'au │ │ │ │ │ +0000f4e0: 746f 6d61 6b65 2720 7769 6c6c 2070 6173 tomake' will pas │ │ │ │ │ +0000f4f0: 730a 616c 6f6e 6720 7769 7468 6f75 7420 s.along without │ │ │ │ │ +0000f500: 696e 7465 7270 7265 7461 7469 6f6e 2e0a interpretation.. │ │ │ │ │ +0000f510: 0a20 2020 5661 7269 6162 6c65 7320 7468 . Variables th │ │ │ │ │ +0000f520: 6174 2065 6e64 2077 6974 6820 275f 5052 at end with '_PR │ │ │ │ │ +0000f530: 4f47 5241 4d53 2720 6172 6520 7370 6563 OGRAMS' are spec │ │ │ │ │ +0000f540: 6961 6c20 7661 7269 6162 6c65 7320 7468 ial variables th │ │ │ │ │ +0000f550: 6174 206c 6973 740a 7072 6f67 7261 6d73 at list.programs │ │ │ │ │ +0000f560: 2074 6861 7420 7468 6520 7265 7375 6c74 that the result │ │ │ │ │ +0000f570: 696e 6720 274d 616b 6566 696c 6527 2073 ing 'Makefile' s │ │ │ │ │ +0000f580: 686f 756c 6420 6275 696c 642e 2020 496e hould build. In │ │ │ │ │ +0000f590: 2041 7574 6f6d 616b 6520 7370 6561 6b2c Automake speak, │ │ │ │ │ +0000f5a0: 0a74 6869 7320 275f 5052 4f47 5241 4d53 .this '_PROGRAMS │ │ │ │ │ +0000f5b0: 2720 7375 6666 6978 2069 7320 6361 6c6c ' suffix is call │ │ │ │ │ +0000f5c0: 6564 2061 2022 7072 696d 6172 7922 3b20 ed a "primary"; │ │ │ │ │ +0000f5d0: 4175 746f 6d61 6b65 2072 6563 6f67 6e69 Automake recogni │ │ │ │ │ +0000f5e0: 7a65 7320 6f74 6865 720a 7072 696d 6172 zes other.primar │ │ │ │ │ +0000f5f0: 6965 7320 7375 6368 2061 7320 275f 5343 ies such as '_SC │ │ │ │ │ +0000f600: 5249 5054 5327 2c20 275f 4441 5441 272c RIPTS', '_DATA', │ │ │ │ │ +0000f610: 2027 5f4c 4942 5241 5249 4553 272c 2065 '_LIBRARIES', e │ │ │ │ │ +0000f620: 7463 2e20 636f 7272 6573 706f 6e64 696e tc. correspondin │ │ │ │ │ +0000f630: 670a 746f 2064 6966 6665 7265 6e74 2074 g.to different t │ │ │ │ │ +0000f640: 7970 6573 206f 6620 6669 6c65 732e 0a0a ypes of files... │ │ │ │ │ +0000f650: 2020 2054 6865 2027 6269 6e27 2070 6172 The 'bin' par │ │ │ │ │ +0000f660: 7420 6f66 2074 6865 2027 6269 6e5f 5052 t of the 'bin_PR │ │ │ │ │ +0000f670: 4f47 5241 4d53 2720 7465 6c6c 7320 2761 OGRAMS' tells 'a │ │ │ │ │ +0000f680: 7574 6f6d 616b 6527 2074 6861 7420 7468 utomake' that th │ │ │ │ │ +0000f690: 650a 7265 7375 6c74 696e 6720 7072 6f67 e.resulting prog │ │ │ │ │ +0000f6a0: 7261 6d73 2073 686f 756c 6420 6265 2069 rams should be i │ │ │ │ │ +0000f6b0: 6e73 7461 6c6c 6564 2069 6e20 4249 4e44 nstalled in BIND │ │ │ │ │ +0000f6c0: 4952 2e20 2052 6563 616c 6c20 7468 6174 IR. Recall that │ │ │ │ │ +0000f6d0: 2074 6865 2047 4e55 0a42 7569 6c64 2053 the GNU.Build S │ │ │ │ │ +0000f6e0: 7973 7465 6d20 7573 6573 2061 2073 6574 ystem uses a set │ │ │ │ │ +0000f6f0: 206f 6620 7661 7269 6162 6c65 7320 746f of variables to │ │ │ │ │ +0000f700: 2064 656e 6f74 6520 6465 7374 696e 6174 denote destinat │ │ │ │ │ +0000f710: 696f 6e20 6469 7265 6374 6f72 6965 730a ion directories. │ │ │ │ │ +0000f720: 616e 6420 616c 6c6f 7720 7573 6572 7320 and allow users │ │ │ │ │ +0000f730: 746f 2063 7573 746f 6d69 7a65 2074 6865 to customize the │ │ │ │ │ +0000f740: 7365 206c 6f63 6174 696f 6e73 2028 2a6e se locations (*n │ │ │ │ │ +0000f750: 6f74 6520 5374 616e 6461 7264 2044 6972 ote Standard Dir │ │ │ │ │ +0000f760: 6563 746f 7279 0a56 6172 6961 626c 6573 ectory.Variables │ │ │ │ │ +0000f770: 3a3a 292e 2020 416e 7920 7375 6368 2064 ::). Any such d │ │ │ │ │ +0000f780: 6972 6563 746f 7279 2076 6172 6961 626c irectory variabl │ │ │ │ │ +0000f790: 6520 6361 6e20 6265 2070 7574 2069 6e20 e can be put in │ │ │ │ │ +0000f7a0: 6672 6f6e 7420 6f66 2061 0a70 7269 6d61 front of a.prima │ │ │ │ │ +0000f7b0: 7279 2028 6f6d 6974 7469 6e67 2074 6865 ry (omitting the │ │ │ │ │ +0000f7c0: 2027 6469 7227 2073 7566 6669 7829 2074 'dir' suffix) t │ │ │ │ │ +0000f7d0: 6f20 7465 6c6c 2027 6175 746f 6d61 6b65 o tell 'automake │ │ │ │ │ +0000f7e0: 2720 7768 6572 6520 746f 2069 6e73 7461 ' where to insta │ │ │ │ │ +0000f7f0: 6c6c 0a74 6865 206c 6973 7465 6420 6669 ll.the listed fi │ │ │ │ │ +0000f800: 6c65 732e 0a0a 2020 2050 726f 6772 616d les... Program │ │ │ │ │ +0000f810: 7320 6e65 6564 2074 6f20 6265 2062 7569 s need to be bui │ │ │ │ │ +0000f820: 6c74 2066 726f 6d20 736f 7572 6365 2066 lt from source f │ │ │ │ │ +0000f830: 696c 6573 2c20 736f 2066 6f72 2065 6163 iles, so for eac │ │ │ │ │ +0000f840: 6820 7072 6f67 7261 6d0a 2750 524f 4727 h program.'PROG' │ │ │ │ │ +0000f850: 206c 6973 7465 6420 696e 2061 2027 5f50 listed in a '_P │ │ │ │ │ +0000f860: 524f 4752 414d 5327 2076 6172 6961 626c ROGRAMS' variabl │ │ │ │ │ +0000f870: 652c 2027 6175 746f 6d61 6b65 2720 7769 e, 'automake' wi │ │ │ │ │ +0000f880: 6c6c 206c 6f6f 6b20 666f 720a 616e 6f74 ll look for.anot │ │ │ │ │ +0000f890: 6865 7220 7661 7269 6162 6c65 206e 616d her variable nam │ │ │ │ │ +0000f8a0: 6564 2027 5052 4f47 5f53 4f55 5243 4553 ed 'PROG_SOURCES │ │ │ │ │ +0000f8b0: 2720 6c69 7374 696e 6720 6974 7320 736f ' listing its so │ │ │ │ │ +0000f8c0: 7572 6365 2066 696c 6573 2e20 2054 6865 urce files. The │ │ │ │ │ +0000f8d0: 7265 0a6d 6179 2062 6520 6d6f 7265 2074 re.may be more t │ │ │ │ │ +0000f8e0: 6861 6e20 6f6e 6520 736f 7572 6365 2066 han one source f │ │ │ │ │ +0000f8f0: 696c 653a 2074 6865 7920 7769 6c6c 2061 ile: they will a │ │ │ │ │ +0000f900: 6c6c 2062 6520 636f 6d70 696c 6564 2061 ll be compiled a │ │ │ │ │ +0000f910: 6e64 206c 696e 6b65 640a 746f 6765 7468 nd linked.togeth │ │ │ │ │ +0000f920: 6572 2e0a 0a20 2020 4175 746f 6d61 6b65 er... Automake │ │ │ │ │ +0000f930: 2061 6c73 6f20 6b6e 6f77 7320 7468 6174 also knows that │ │ │ │ │ +0000f940: 2073 6f75 7263 6520 6669 6c65 7320 6e65 source files ne │ │ │ │ │ +0000f950: 6564 2074 6f20 6265 2064 6973 7472 6962 ed to be distrib │ │ │ │ │ +0000f960: 7574 6564 2077 6865 6e0a 6372 6561 7469 uted when.creati │ │ │ │ │ +0000f970: 6e67 2061 2074 6172 6261 6c6c 2028 756e ng a tarball (un │ │ │ │ │ +0000f980: 6c69 6b65 2062 7569 6c74 2070 726f 6772 like built progr │ │ │ │ │ +0000f990: 616d 7329 2e20 2053 6f20 6120 7369 6465 ams). So a side │ │ │ │ │ +0000f9a0: 2d65 6666 6563 7420 6f66 2074 6869 730a -effect of this. │ │ │ │ │ +0000f9b0: 2768 656c 6c6f 5f53 4f55 5243 4553 2720 'hello_SOURCES' │ │ │ │ │ +0000f9c0: 6465 636c 6172 6174 696f 6e20 6973 2074 declaration is t │ │ │ │ │ +0000f9d0: 6861 7420 276d 6169 6e2e 6327 2077 696c hat 'main.c' wil │ │ │ │ │ +0000f9e0: 6c20 6265 2070 6172 7420 6f66 2074 6865 l be part of the │ │ │ │ │ +0000f9f0: 2074 6172 6261 6c6c 0a63 7265 6174 6564 tarball.created │ │ │ │ │ +0000fa00: 2062 7920 276d 616b 6520 6469 7374 272e by 'make dist'. │ │ │ │ │ +0000fa10: 0a0a 2020 2046 696e 616c 6c79 2068 6572 .. Finally her │ │ │ │ │ +0000fa20: 6520 6172 6520 736f 6d65 2065 7870 6c61 e are some expla │ │ │ │ │ +0000fa30: 6e61 7469 6f6e 7320 7265 6761 7264 696e nations regardin │ │ │ │ │ +0000fa40: 6720 7468 6520 746f 702d 6c65 7665 6c0a g the top-level. │ │ │ │ │ +0000fa50: 274d 616b 6566 696c 652e 616d 272e 0a0a 'Makefile.am'... │ │ │ │ │ +0000fa60: 2020 2020 2053 5542 4449 5253 203d 2073 SUBDIRS = s │ │ │ │ │ +0000fa70: 7263 0a20 2020 2020 6469 7374 5f64 6f63 rc. dist_doc │ │ │ │ │ +0000fa80: 5f44 4154 4120 3d20 5245 4144 4d45 0a0a _DATA = README.. │ │ │ │ │ +0000fa90: 2020 2027 5355 4244 4952 5327 2069 7320 'SUBDIRS' is │ │ │ │ │ +0000faa0: 6120 7370 6563 6961 6c20 7661 7269 6162 a special variab │ │ │ │ │ +0000fab0: 6c65 206c 6973 7469 6e67 2061 6c6c 2064 le listing all d │ │ │ │ │ +0000fac0: 6972 6563 746f 7269 6573 2074 6861 7420 irectories that │ │ │ │ │ +0000fad0: 276d 616b 6527 0a73 686f 756c 6420 7265 'make'.should re │ │ │ │ │ +0000fae0: 6375 7273 6520 696e 746f 2062 6566 6f72 curse into befor │ │ │ │ │ +0000faf0: 6520 7072 6f63 6573 7369 6e67 2074 6865 e processing the │ │ │ │ │ +0000fb00: 2063 7572 7265 6e74 2064 6972 6563 746f current directo │ │ │ │ │ +0000fb10: 7279 2e20 2053 6f20 7468 6973 0a6c 696e ry. So this.lin │ │ │ │ │ +0000fb20: 6520 6973 2072 6573 706f 6e73 6962 6c65 e is responsible │ │ │ │ │ +0000fb30: 2066 6f72 2027 6d61 6b65 2720 6275 696c for 'make' buil │ │ │ │ │ +0000fb40: 6469 6e67 2027 7372 632f 6865 6c6c 6f27 ding 'src/hello' │ │ │ │ │ +0000fb50: 2065 7665 6e20 7468 6f75 6768 2077 6520 even though we │ │ │ │ │ +0000fb60: 7275 6e0a 6974 2066 726f 6d20 7468 6520 run.it from the │ │ │ │ │ +0000fb70: 746f 702d 6c65 7665 6c2e 2020 5468 6973 top-level. This │ │ │ │ │ +0000fb80: 206c 696e 6520 616c 736f 2063 6175 7365 line also cause │ │ │ │ │ +0000fb90: 7320 276d 616b 6520 696e 7374 616c 6c27 s 'make install' │ │ │ │ │ +0000fba0: 2074 6f20 696e 7374 616c 6c0a 2773 7263 to install.'src │ │ │ │ │ +0000fbb0: 2f68 656c 6c6f 2720 6265 666f 7265 2069 /hello' before i │ │ │ │ │ +0000fbc0: 6e73 7461 6c6c 696e 6720 2752 4541 444d nstalling 'READM │ │ │ │ │ +0000fbd0: 4527 2028 6e6f 7420 7468 6174 2074 6869 E' (not that thi │ │ │ │ │ +0000fbe0: 7320 6f72 6465 7220 6d61 7474 6572 7329 s order matters) │ │ │ │ │ +0000fbf0: 2e0a 0a20 2020 5468 6520 6c69 6e65 2027 ... The line ' │ │ │ │ │ +0000fc00: 6469 7374 5f64 6f63 5f44 4154 4120 3d20 dist_doc_DATA = │ │ │ │ │ +0000fc10: 5245 4144 4d45 2720 6361 7573 6573 2027 README' causes ' │ │ │ │ │ +0000fc20: 5245 4144 4d45 2720 746f 2062 6520 6469 README' to be di │ │ │ │ │ +0000fc30: 7374 7269 6275 7465 640a 616e 6420 696e stributed.and in │ │ │ │ │ +0000fc40: 7374 616c 6c65 6420 696e 2044 4f43 4449 stalled in DOCDI │ │ │ │ │ +0000fc50: 522e 2020 4669 6c65 7320 6c69 7374 6564 R. Files listed │ │ │ │ │ +0000fc60: 2077 6974 6820 7468 6520 275f 4441 5441 with the '_DATA │ │ │ │ │ +0000fc70: 2720 7072 696d 6172 7920 6172 6520 6e6f ' primary are no │ │ │ │ │ +0000fc80: 740a 6175 746f 6d61 7469 6361 6c6c 7920 t.automatically │ │ │ │ │ +0000fc90: 7061 7274 206f 6620 7468 6520 7461 7262 part of the tarb │ │ │ │ │ +0000fca0: 616c 6c20 6275 696c 7420 7769 7468 2027 all built with ' │ │ │ │ │ +0000fcb0: 6d61 6b65 2064 6973 7427 2c20 736f 2077 make dist', so w │ │ │ │ │ +0000fcc0: 6520 6164 6420 7468 650a 2764 6973 745f e add the.'dist_ │ │ │ │ │ +0000fcd0: 2720 7072 6566 6978 2073 6f20 7468 6579 ' prefix so they │ │ │ │ │ +0000fce0: 2067 6574 2064 6973 7472 6962 7574 6564 get distributed │ │ │ │ │ +0000fcf0: 2e20 2048 6f77 6576 6572 2c20 666f 7220 . However, for │ │ │ │ │ +0000fd00: 2752 4541 444d 4527 2069 7420 776f 756c 'README' it woul │ │ │ │ │ +0000fd10: 640a 6e6f 7420 6861 7665 2062 6565 6e20 d.not have been │ │ │ │ │ +0000fd20: 6e65 6365 7373 6172 793a 2027 6175 746f necessary: 'auto │ │ │ │ │ +0000fd30: 6d61 6b65 2720 6175 746f 6d61 7469 6361 make' automatica │ │ │ │ │ +0000fd40: 6c6c 7920 6469 7374 7269 6275 7465 7320 lly distributes │ │ │ │ │ +0000fd50: 616e 790a 2752 4541 444d 4527 2066 696c any.'README' fil │ │ │ │ │ +0000fd60: 6520 6974 2065 6e63 6f75 6e74 6572 7320 e it encounters │ │ │ │ │ +0000fd70: 2874 6865 206c 6973 7420 6f66 206f 7468 (the list of oth │ │ │ │ │ +0000fd80: 6572 2066 696c 6573 2061 7574 6f6d 6174 er files automat │ │ │ │ │ +0000fd90: 6963 616c 6c79 0a64 6973 7472 6962 7574 ically.distribut │ │ │ │ │ +0000fda0: 6564 2069 7320 7072 6573 656e 7465 6420 ed is presented │ │ │ │ │ +0000fdb0: 6279 2027 6175 746f 6d61 6b65 202d 2d68 by 'automake --h │ │ │ │ │ +0000fdc0: 656c 7027 292e 2020 5468 6520 6f6e 6c79 elp'). The only │ │ │ │ │ +0000fdd0: 2069 6d70 6f72 7461 6e74 0a65 6666 6563 important.effec │ │ │ │ │ +0000fde0: 7420 6f66 2074 6869 7320 7365 636f 6e64 t of this second │ │ │ │ │ +0000fdf0: 206c 696e 6520 6973 2074 6865 7265 666f line is therefo │ │ │ │ │ +0000fe00: 7265 2074 6f20 696e 7374 616c 6c20 2752 re to install 'R │ │ │ │ │ +0000fe10: 4541 444d 4527 2064 7572 696e 6720 276d EADME' during 'm │ │ │ │ │ +0000fe20: 616b 650a 696e 7374 616c 6c27 2e0a 0a20 ake.install'... │ │ │ │ │ +0000fe30: 2020 4f6e 6520 7468 696e 6720 6e6f 7420 One thing not │ │ │ │ │ +0000fe40: 636f 7665 7265 6420 696e 2074 6869 7320 covered in this │ │ │ │ │ +0000fe50: 6578 616d 706c 6520 6973 2061 6363 6573 example is acces │ │ │ │ │ +0000fe60: 7369 6e67 2074 6865 2069 6e73 7461 6c6c sing the install │ │ │ │ │ +0000fe70: 6174 696f 6e0a 6469 7265 6374 6f72 7920 ation.directory │ │ │ │ │ +0000fe80: 7661 6c75 6573 2028 2a6e 6f74 6520 5374 values (*note St │ │ │ │ │ +0000fe90: 616e 6461 7264 2044 6972 6563 746f 7279 andard Directory │ │ │ │ │ +0000fea0: 2056 6172 6961 626c 6573 3a3a 2920 6672 Variables::) fr │ │ │ │ │ +0000feb0: 6f6d 2079 6f75 720a 7072 6f67 7261 6d20 om your.program │ │ │ │ │ +0000fec0: 636f 6465 2c20 7468 6174 2069 732c 2063 code, that is, c │ │ │ │ │ +0000fed0: 6f6e 7665 7274 696e 6720 7468 656d 2069 onverting them i │ │ │ │ │ +0000fee0: 6e74 6f20 6465 6669 6e65 6420 6d61 6372 nto defined macr │ │ │ │ │ +0000fef0: 6f73 2e20 2046 6f72 2074 6869 732c 0a2a os. For this,.* │ │ │ │ │ +0000ff00: 6e6f 7465 2028 6175 746f 636f 6e66 2944 note (autoconf)D │ │ │ │ │ +0000ff10: 6566 696e 696e 6720 4469 7265 6374 6f72 efining Director │ │ │ │ │ +0000ff20: 6965 733a 3a2e 0a0a 1f0a 4669 6c65 3a20 ies::.....File: │ │ │ │ │ +0000ff30: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +0000ff40: 666f 2c20 204e 6f64 653a 2047 656e 6572 fo, Node: Gener │ │ │ │ │ +0000ff50: 616c 6974 6965 732c 2020 4e65 7874 3a20 alities, Next: │ │ │ │ │ +0000ff60: 4578 616d 706c 6573 2c20 2050 7265 763a Examples, Prev: │ │ │ │ │ +0000ff70: 2041 7574 6f74 6f6f 6c73 2049 6e74 726f Autotools Intro │ │ │ │ │ +0000ff80: 6475 6374 696f 6e2c 2020 5570 3a20 546f duction, Up: To │ │ │ │ │ +0000ff90: 700a 0a33 2047 656e 6572 616c 2069 6465 p..3 General ide │ │ │ │ │ +0000ffa0: 6173 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a as.************* │ │ │ │ │ +0000ffb0: 2a2a 0a0a 5468 6520 666f 6c6c 6f77 696e **..The followin │ │ │ │ │ +0000ffc0: 6720 7365 6374 696f 6e73 2063 6f76 6572 g sections cover │ │ │ │ │ +0000ffd0: 2061 2066 6577 2062 6173 6963 2069 6465 a few basic ide │ │ │ │ │ +0000ffe0: 6173 2074 6861 7420 7769 6c6c 2068 656c as that will hel │ │ │ │ │ +0000fff0: 7020 796f 750a 756e 6465 7273 7461 6e64 p you.understand │ │ │ │ │ +00010000: 2068 6f77 2041 7574 6f6d 616b 6520 776f how Automake wo │ │ │ │ │ +00010010: 726b 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a rks...* Menu:..* │ │ │ │ │ +00010020: 2047 656e 6572 616c 204f 7065 7261 7469 General Operati │ │ │ │ │ +00010030: 6f6e 3a3a 2020 2020 2020 2020 2020 2047 on:: G │ │ │ │ │ +00010040: 656e 6572 616c 206f 7065 7261 7469 6f6e eneral operation │ │ │ │ │ +00010050: 206f 6620 4175 746f 6d61 6b65 0a2a 2053 of Automake.* S │ │ │ │ │ +00010060: 7472 6963 746e 6573 733a 3a20 2020 2020 trictness:: │ │ │ │ │ +00010070: 2020 2020 2020 2020 2020 2020 2053 7461 Sta │ │ │ │ │ +00010080: 6e64 6172 6473 2063 6f6e 666f 726d 616e ndards conforman │ │ │ │ │ +00010090: 6365 2063 6865 636b 696e 670a 2a20 556e ce checking.* Un │ │ │ │ │ +000100a0: 6966 6f72 6d3a 3a20 2020 2020 2020 2020 iform:: │ │ │ │ │ +000100b0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ +000100c0: 556e 6966 6f72 6d20 4e61 6d69 6e67 2053 Uniform Naming S │ │ │ │ │ +000100d0: 6368 656d 650a 2a20 4c65 6e67 7468 204c cheme.* Length L │ │ │ │ │ +000100e0: 696d 6974 6174 696f 6e73 3a3a 2020 2020 imitations:: │ │ │ │ │ +000100f0: 2020 2020 2020 5374 6179 696e 6720 6265 Staying be │ │ │ │ │ +00010100: 6c6f 7720 7468 6520 636f 6d6d 616e 6420 low the command │ │ │ │ │ +00010110: 6c69 6e65 206c 656e 6774 6820 6c69 6d69 line length limi │ │ │ │ │ +00010120: 740a 2a20 4361 6e6f 6e69 6361 6c69 7a61 t.* Canonicaliza │ │ │ │ │ +00010130: 7469 6f6e 3a3a 2020 2020 2020 2020 2020 tion:: │ │ │ │ │ +00010140: 2020 486f 7720 6465 7269 7665 6420 7661 How derived va │ │ │ │ │ +00010150: 7269 6162 6c65 7320 6172 6520 6e61 6d65 riables are name │ │ │ │ │ +00010160: 640a 2a20 5573 6572 2056 6172 6961 626c d.* User Variabl │ │ │ │ │ +00010170: 6573 3a3a 2020 2020 2020 2020 2020 2020 es:: │ │ │ │ │ +00010180: 2020 5661 7269 6162 6c65 7320 7265 7365 Variables rese │ │ │ │ │ +00010190: 7276 6564 2066 6f72 2074 6865 2075 7365 rved for the use │ │ │ │ │ +000101a0: 720a 2a20 4175 7869 6c69 6172 7920 5072 r.* Auxiliary Pr │ │ │ │ │ +000101b0: 6f67 7261 6d73 3a3a 2020 2020 2020 2020 ograms:: │ │ │ │ │ +000101c0: 2020 5072 6f67 7261 6d73 2061 7574 6f6d Programs autom │ │ │ │ │ +000101d0: 616b 6520 6d69 6768 7420 7265 7175 6972 ake might requir │ │ │ │ │ +000101e0: 650a 0a1f 0a46 696c 653a 2061 7574 6f6d e....File: autom │ │ │ │ │ +000101f0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +00010200: 4e6f 6465 3a20 4765 6e65 7261 6c20 4f70 Node: General Op │ │ │ │ │ +00010210: 6572 6174 696f 6e2c 2020 4e65 7874 3a20 eration, Next: │ │ │ │ │ +00010220: 5374 7269 6374 6e65 7373 2c20 2055 703a Strictness, Up: │ │ │ │ │ +00010230: 2047 656e 6572 616c 6974 6965 730a 0a33 Generalities..3 │ │ │ │ │ +00010240: 2e31 2047 656e 6572 616c 204f 7065 7261 .1 General Opera │ │ │ │ │ +00010250: 7469 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d tion.=========== │ │ │ │ │ +00010260: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f ==========..Auto │ │ │ │ │ +00010270: 6d61 6b65 2077 6f72 6b73 2062 7920 7265 make works by re │ │ │ │ │ +00010280: 6164 696e 6720 6120 274d 616b 6566 696c ading a 'Makefil │ │ │ │ │ +00010290: 652e 616d 2720 616e 6420 6765 6e65 7261 e.am' and genera │ │ │ │ │ +000102a0: 7469 6e67 2061 0a27 4d61 6b65 6669 6c65 ting a.'Makefile │ │ │ │ │ +000102b0: 2e69 6e27 2e20 2043 6572 7461 696e 2076 .in'. Certain v │ │ │ │ │ +000102c0: 6172 6961 626c 6573 2061 6e64 2072 756c ariables and rul │ │ │ │ │ +000102d0: 6573 2064 6566 696e 6564 2069 6e20 7468 es defined in th │ │ │ │ │ +000102e0: 6520 274d 616b 6566 696c 652e 616d 270a e 'Makefile.am'. │ │ │ │ │ +000102f0: 696e 7374 7275 6374 2041 7574 6f6d 616b instruct Automak │ │ │ │ │ +00010300: 6520 746f 2067 656e 6572 6174 6520 6d6f e to generate mo │ │ │ │ │ +00010310: 7265 2073 7065 6369 616c 697a 6564 2063 re specialized c │ │ │ │ │ +00010320: 6f64 653b 2066 6f72 2069 6e73 7461 6e63 ode; for instanc │ │ │ │ │ +00010330: 652c 2061 0a27 6269 6e5f 5052 4f47 5241 e, a.'bin_PROGRA │ │ │ │ │ +00010340: 4d53 2720 7661 7269 6162 6c65 2064 6566 MS' variable def │ │ │ │ │ +00010350: 696e 6974 696f 6e20 7769 6c6c 2063 6175 inition will cau │ │ │ │ │ +00010360: 7365 2072 756c 6573 2066 6f72 2063 6f6d se rules for com │ │ │ │ │ +00010370: 7069 6c69 6e67 2061 6e64 0a6c 696e 6b69 piling and.linki │ │ │ │ │ +00010380: 6e67 2070 726f 6772 616d 7320 746f 2062 ng programs to b │ │ │ │ │ +00010390: 6520 6765 6e65 7261 7465 642e 0a0a 2020 e generated... │ │ │ │ │ +000103a0: 2054 6865 2076 6172 6961 626c 6520 6465 The variable de │ │ │ │ │ +000103b0: 6669 6e69 7469 6f6e 7320 616e 6420 7275 finitions and ru │ │ │ │ │ +000103c0: 6c65 7320 696e 2074 6865 2027 4d61 6b65 les in the 'Make │ │ │ │ │ +000103d0: 6669 6c65 2e61 6d27 2061 7265 2063 6f70 file.am' are cop │ │ │ │ │ +000103e0: 6965 640a 6d6f 7374 6c79 2076 6572 6261 ied.mostly verba │ │ │ │ │ +000103f0: 7469 6d20 696e 746f 2074 6865 2067 656e tim into the gen │ │ │ │ │ +00010400: 6572 6174 6564 2066 696c 652c 2077 6974 erated file, wit │ │ │ │ │ +00010410: 6820 616c 6c20 7661 7269 6162 6c65 2064 h all variable d │ │ │ │ │ +00010420: 6566 696e 6974 696f 6e73 0a70 7265 6365 efinitions.prece │ │ │ │ │ +00010430: 6469 6e67 2061 6c6c 2072 756c 6573 2e20 ding all rules. │ │ │ │ │ +00010440: 2054 6869 7320 616c 6c6f 7773 2079 6f75 This allows you │ │ │ │ │ +00010450: 2074 6f20 6164 6420 616c 6d6f 7374 2061 to add almost a │ │ │ │ │ +00010460: 7262 6974 7261 7279 2063 6f64 6520 696e rbitrary code in │ │ │ │ │ +00010470: 746f 0a74 6865 2067 656e 6572 6174 6564 to.the generated │ │ │ │ │ +00010480: 2027 4d61 6b65 6669 6c65 2e69 6e27 2e20 'Makefile.in'. │ │ │ │ │ +00010490: 2046 6f72 2069 6e73 7461 6e63 652c 2074 For instance, t │ │ │ │ │ +000104a0: 6865 2041 7574 6f6d 616b 6520 6469 7374 he Automake dist │ │ │ │ │ +000104b0: 7269 6275 7469 6f6e 0a69 6e63 6c75 6465 ribution.include │ │ │ │ │ +000104c0: 7320 6120 6e6f 6e2d 7374 616e 6461 7264 s a non-standard │ │ │ │ │ +000104d0: 2072 756c 6520 666f 7220 7468 6520 2767 rule for the 'g │ │ │ │ │ +000104e0: 6974 2d64 6973 7427 2074 6172 6765 742c it-dist' target, │ │ │ │ │ +000104f0: 2077 6869 6368 2074 6865 0a41 7574 6f6d which the.Autom │ │ │ │ │ +00010500: 616b 6520 6d61 696e 7461 696e 6572 2075 ake maintainer u │ │ │ │ │ +00010510: 7365 7320 746f 206d 616b 6520 6469 7374 ses to make dist │ │ │ │ │ +00010520: 7269 6275 7469 6f6e 7320 6672 6f6d 2074 ributions from t │ │ │ │ │ +00010530: 6865 2073 6f75 7263 6520 636f 6e74 726f he source contro │ │ │ │ │ +00010540: 6c0a 7379 7374 656d 2e0a 0a20 2020 4e6f l.system... No │ │ │ │ │ +00010550: 7465 2074 6861 7420 6d6f 7374 2047 4e55 te that most GNU │ │ │ │ │ +00010560: 206d 616b 6520 6578 7465 6e73 696f 6e73 make extensions │ │ │ │ │ +00010570: 2061 7265 206e 6f74 2072 6563 6f67 6e69 are not recogni │ │ │ │ │ +00010580: 7a65 6420 6279 2041 7574 6f6d 616b 652e zed by Automake. │ │ │ │ │ +00010590: 0a55 7369 6e67 2073 7563 6820 6578 7465 .Using such exte │ │ │ │ │ +000105a0: 6e73 696f 6e73 2069 6e20 6120 274d 616b nsions in a 'Mak │ │ │ │ │ +000105b0: 6566 696c 652e 616d 2720 7769 6c6c 206c efile.am' will l │ │ │ │ │ +000105c0: 6561 6420 746f 2065 7272 6f72 7320 6f72 ead to errors or │ │ │ │ │ +000105d0: 0a63 6f6e 6675 7369 6e67 2062 6568 6176 .confusing behav │ │ │ │ │ +000105e0: 696f 722e 0a0a 2020 2041 2073 7065 6369 ior... A speci │ │ │ │ │ +000105f0: 616c 2065 7863 6570 7469 6f6e 2069 7320 al exception is │ │ │ │ │ +00010600: 7468 6174 2074 6865 2047 4e55 206d 616b that the GNU mak │ │ │ │ │ +00010610: 6520 6170 7065 6e64 206f 7065 7261 746f e append operato │ │ │ │ │ +00010620: 722c 2027 2b3d 272c 2069 730a 7375 7070 r, '+=', is.supp │ │ │ │ │ +00010630: 6f72 7465 642e 2020 5468 6973 206f 7065 orted. This ope │ │ │ │ │ +00010640: 7261 746f 7220 6170 7065 6e64 7320 6974 rator appends it │ │ │ │ │ +00010650: 7320 7269 6768 7420 6861 6e64 2061 7267 s right hand arg │ │ │ │ │ +00010660: 756d 656e 7420 746f 2074 6865 0a76 6172 ument to the.var │ │ │ │ │ +00010670: 6961 626c 6520 7370 6563 6966 6965 6420 iable specified │ │ │ │ │ +00010680: 6f6e 2074 6865 206c 6566 742e 2020 4175 on the left. Au │ │ │ │ │ +00010690: 746f 6d61 6b65 2077 696c 6c20 7472 616e tomake will tran │ │ │ │ │ +000106a0: 736c 6174 6520 7468 6520 6f70 6572 6174 slate the operat │ │ │ │ │ +000106b0: 6f72 0a69 6e74 6f20 616e 206f 7264 696e or.into an ordin │ │ │ │ │ +000106c0: 6172 7920 273d 2720 6f70 6572 6174 6f72 ary '=' operator │ │ │ │ │ +000106d0: 3b20 272b 3d27 2077 696c 6c20 7468 7573 ; '+=' will thus │ │ │ │ │ +000106e0: 2077 6f72 6b20 7769 7468 2061 6e79 206d work with any m │ │ │ │ │ +000106f0: 616b 650a 7072 6f67 7261 6d2e 0a0a 2020 ake.program... │ │ │ │ │ +00010700: 2041 7574 6f6d 616b 6520 7472 6965 7320 Automake tries │ │ │ │ │ +00010710: 746f 206b 6565 7020 636f 6d6d 656e 7473 to keep comments │ │ │ │ │ +00010720: 2067 726f 7570 6564 2077 6974 6820 616e grouped with an │ │ │ │ │ +00010730: 7920 6164 6a6f 696e 696e 6720 7275 6c65 y adjoining rule │ │ │ │ │ +00010740: 7320 6f72 0a76 6172 6961 626c 6520 6465 s or.variable de │ │ │ │ │ +00010750: 6669 6e69 7469 6f6e 732e 0a0a 2020 2047 finitions... G │ │ │ │ │ +00010760: 656e 6572 616c 6c79 2c20 4175 746f 6d61 enerally, Automa │ │ │ │ │ +00010770: 6b65 2069 7320 6e6f 7420 7061 7274 6963 ke is not partic │ │ │ │ │ +00010780: 756c 6172 6c79 2073 6d61 7274 2069 6e20 ularly smart in │ │ │ │ │ +00010790: 7468 6520 7061 7273 696e 6720 6f66 0a75 the parsing of.u │ │ │ │ │ +000107a0: 6e75 7375 616c 204d 616b 6566 696c 6520 nusual Makefile │ │ │ │ │ +000107b0: 636f 6e73 7472 7563 7473 2c20 736f 2079 constructs, so y │ │ │ │ │ +000107c0: 6f75 2772 6520 6164 7669 7365 6420 746f ou're advised to │ │ │ │ │ +000107d0: 2061 766f 6964 2066 616e 6379 2063 6f6e avoid fancy con │ │ │ │ │ +000107e0: 7374 7275 6374 730a 6f72 2022 6372 6561 structs.or "crea │ │ │ │ │ +000107f0: 7469 7665 2220 7573 6520 6f66 2077 6869 tive" use of whi │ │ │ │ │ +00010800: 7465 7370 6163 6573 2e20 2046 6f72 2065 tespaces. For e │ │ │ │ │ +00010810: 7861 6d70 6c65 2c20 3c54 4142 3e20 6368 xample, ch │ │ │ │ │ +00010820: 6172 6163 7465 7273 2063 616e 6e6f 740a aracters cannot. │ │ │ │ │ +00010830: 6265 2075 7365 6420 6265 7477 6565 6e20 be used between │ │ │ │ │ +00010840: 6120 7461 7267 6574 206e 616d 6520 616e a target name an │ │ │ │ │ +00010850: 6420 7468 6520 666f 6c6c 6f77 696e 6720 d the following │ │ │ │ │ +00010860: 2227 3a27 2220 6368 6172 6163 7465 722c "':'" character, │ │ │ │ │ +00010870: 2061 6e64 0a76 6172 6961 626c 6520 6173 and.variable as │ │ │ │ │ +00010880: 7369 676e 6d65 6e74 7320 7368 6f75 6c64 signments should │ │ │ │ │ +00010890: 6e27 7420 6265 2069 6e64 656e 7465 6420 n't be indented │ │ │ │ │ +000108a0: 7769 7468 203c 5441 423e 2063 6861 7261 with chara │ │ │ │ │ +000108b0: 6374 6572 732e 2020 416c 736f 2c0a 7573 cters. Also,.us │ │ │ │ │ +000108c0: 696e 6720 6d6f 7265 2063 6f6d 706c 6578 ing more complex │ │ │ │ │ +000108d0: 206d 6163 726f 2069 6e20 7461 7267 6574 macro in target │ │ │ │ │ +000108e0: 206e 616d 6573 2063 616e 2063 6175 7365 names can cause │ │ │ │ │ +000108f0: 2074 726f 7562 6c65 3a0a 0a20 2020 2020 trouble:.. │ │ │ │ │ +00010900: 2520 6361 7420 4d61 6b65 6669 6c65 2e61 % cat Makefile.a │ │ │ │ │ +00010910: 6d0a 2020 2020 2024 2846 4f4f 3a3d 7829 m. $(FOO:=x) │ │ │ │ │ +00010920: 3a20 6261 720a 2020 2020 2025 2061 7574 : bar. % aut │ │ │ │ │ +00010930: 6f6d 616b 650a 2020 2020 204d 616b 6566 omake. Makef │ │ │ │ │ +00010940: 696c 652e 616d 3a31 3a20 6261 6420 6368 ile.am:1: bad ch │ │ │ │ │ +00010950: 6172 6163 7465 7273 2069 6e20 7661 7269 aracters in vari │ │ │ │ │ +00010960: 6162 6c65 206e 616d 6520 6024 2846 4f4f able name `$(FOO │ │ │ │ │ +00010970: 270a 2020 2020 204d 616b 6566 696c 652e '. Makefile. │ │ │ │ │ +00010980: 616d 3a31 3a20 603a 3d27 2d73 7479 6c65 am:1: `:='-style │ │ │ │ │ +00010990: 2061 7373 6967 6e6d 656e 7473 2061 7265 assignments are │ │ │ │ │ +000109a0: 206e 6f74 2070 6f72 7461 626c 650a 0a20 not portable.. │ │ │ │ │ +000109b0: 2020 4120 7275 6c65 2064 6566 696e 6564 A rule defined │ │ │ │ │ +000109c0: 2069 6e20 274d 616b 6566 696c 652e 616d in 'Makefile.am │ │ │ │ │ +000109d0: 2720 6765 6e65 7261 6c6c 7920 6f76 6572 ' generally over │ │ │ │ │ +000109e0: 7269 6465 7320 616e 7920 7375 6368 2072 rides any such r │ │ │ │ │ +000109f0: 756c 6520 6f66 0a61 2073 696d 696c 6172 ule of.a similar │ │ │ │ │ +00010a00: 206e 616d 6520 7468 6174 2077 6f75 6c64 name that would │ │ │ │ │ +00010a10: 2062 6520 6175 746f 6d61 7469 6361 6c6c be automaticall │ │ │ │ │ +00010a20: 7920 6765 6e65 7261 7465 6420 6279 2027 y generated by ' │ │ │ │ │ +00010a30: 6175 746f 6d61 6b65 272e 0a41 6c74 686f automake'..Altho │ │ │ │ │ +00010a40: 7567 6820 7468 6973 2069 7320 6120 7375 ugh this is a su │ │ │ │ │ +00010a50: 7070 6f72 7465 6420 6665 6174 7572 652c pported feature, │ │ │ │ │ +00010a60: 2069 7420 6973 2067 656e 6572 616c 6c79 it is generally │ │ │ │ │ +00010a70: 2062 6573 7420 746f 2061 766f 6964 0a6d best to avoid.m │ │ │ │ │ +00010a80: 616b 696e 6720 7573 6520 6f66 2069 742c aking use of it, │ │ │ │ │ +00010a90: 2061 7320 736f 6d65 7469 6d65 7320 7468 as sometimes th │ │ │ │ │ +00010aa0: 6520 6765 6e65 7261 7465 6420 7275 6c65 e generated rule │ │ │ │ │ +00010ab0: 7320 6172 6520 7665 7279 2070 6172 7469 s are very parti │ │ │ │ │ +00010ac0: 6375 6c61 722e 0a0a 2020 2053 696d 696c cular... Simil │ │ │ │ │ +00010ad0: 6172 6c79 2c20 6120 7661 7269 6162 6c65 arly, a variable │ │ │ │ │ +00010ae0: 2064 6566 696e 6564 2069 6e20 274d 616b defined in 'Mak │ │ │ │ │ +00010af0: 6566 696c 652e 616d 2720 6f72 2027 4143 efile.am' or 'AC │ │ │ │ │ +00010b00: 5f53 5542 5354 2765 6420 6672 6f6d 0a27 _SUBST'ed from.' │ │ │ │ │ +00010b10: 636f 6e66 6967 7572 652e 6163 2720 7769 configure.ac' wi │ │ │ │ │ +00010b20: 6c6c 206f 7665 7272 6964 6520 616e 7920 ll override any │ │ │ │ │ +00010b30: 6465 6669 6e69 7469 6f6e 206f 6620 7468 definition of th │ │ │ │ │ +00010b40: 6520 7661 7269 6162 6c65 2074 6861 740a e variable that. │ │ │ │ │ +00010b50: 2761 7574 6f6d 616b 6527 2077 6f75 6c64 'automake' would │ │ │ │ │ +00010b60: 206f 7264 696e 6172 696c 7920 6372 6561 ordinarily crea │ │ │ │ │ +00010b70: 7465 2e20 2054 6869 7320 6665 6174 7572 te. This featur │ │ │ │ │ +00010b80: 6520 6973 206d 6f72 6520 6f66 7465 6e20 e is more often │ │ │ │ │ +00010b90: 7573 6566 756c 0a74 6861 6e20 7468 6520 useful.than the │ │ │ │ │ +00010ba0: 6162 696c 6974 7920 746f 206f 7665 7272 ability to overr │ │ │ │ │ +00010bb0: 6964 6520 6120 7275 6c65 2e20 2042 6520 ide a rule. Be │ │ │ │ │ +00010bc0: 7761 726e 6564 2074 6861 7420 6d61 6e79 warned that many │ │ │ │ │ +00010bd0: 206f 6620 7468 650a 7661 7269 6162 6c65 of the.variable │ │ │ │ │ +00010be0: 7320 6765 6e65 7261 7465 6420 6279 2027 s generated by ' │ │ │ │ │ +00010bf0: 6175 746f 6d61 6b65 2720 6172 6520 636f automake' are co │ │ │ │ │ +00010c00: 6e73 6964 6572 6564 2074 6f20 6265 2066 nsidered to be f │ │ │ │ │ +00010c10: 6f72 2069 6e74 6572 6e61 6c20 7573 650a or internal use. │ │ │ │ │ +00010c20: 6f6e 6c79 2c20 616e 6420 7468 6569 7220 only, and their │ │ │ │ │ +00010c30: 6e61 6d65 7320 6d69 6768 7420 6368 616e names might chan │ │ │ │ │ +00010c40: 6765 2069 6e20 6675 7475 7265 2072 656c ge in future rel │ │ │ │ │ +00010c50: 6561 7365 732e 0a0a 2020 2057 6865 6e20 eases... When │ │ │ │ │ +00010c60: 6578 616d 696e 696e 6720 6120 7661 7269 examining a vari │ │ │ │ │ +00010c70: 6162 6c65 2064 6566 696e 6974 696f 6e2c able definition, │ │ │ │ │ +00010c80: 2041 7574 6f6d 616b 6520 7769 6c6c 2072 Automake will r │ │ │ │ │ +00010c90: 6563 7572 7369 7665 6c79 0a65 7861 6d69 ecursively.exami │ │ │ │ │ +00010ca0: 6e65 2076 6172 6961 626c 6573 2072 6566 ne variables ref │ │ │ │ │ +00010cb0: 6572 656e 6365 6420 696e 2074 6865 2064 erenced in the d │ │ │ │ │ +00010cc0: 6566 696e 6974 696f 6e2e 2020 466f 7220 efinition. For │ │ │ │ │ +00010cd0: 6578 616d 706c 652c 2069 660a 4175 746f example, if.Auto │ │ │ │ │ +00010ce0: 6d61 6b65 2069 7320 6c6f 6f6b 696e 6720 make is looking │ │ │ │ │ +00010cf0: 6174 2074 6865 2063 6f6e 7465 6e74 206f at the content o │ │ │ │ │ +00010d00: 6620 2766 6f6f 5f53 4f55 5243 4553 2720 f 'foo_SOURCES' │ │ │ │ │ +00010d10: 696e 2074 6869 7320 736e 6970 7065 740a in this snippet. │ │ │ │ │ +00010d20: 0a20 2020 2020 7873 203d 2061 2e63 2062 . xs = a.c b │ │ │ │ │ +00010d30: 2e63 0a20 2020 2020 666f 6f5f 534f 5552 .c. foo_SOUR │ │ │ │ │ +00010d40: 4345 5320 3d20 632e 6320 2428 7873 290a CES = c.c $(xs). │ │ │ │ │ +00010d50: 0a20 2020 6974 2077 6f75 6c64 2075 7365 . it would use │ │ │ │ │ +00010d60: 2074 6865 2066 696c 6573 2027 612e 6327 the files 'a.c' │ │ │ │ │ +00010d70: 2c20 2762 2e63 272c 2061 6e64 2027 632e , 'b.c', and 'c. │ │ │ │ │ +00010d80: 6327 2061 7320 7468 6520 636f 6e74 656e c' as the conten │ │ │ │ │ +00010d90: 7473 206f 660a 2766 6f6f 5f53 4f55 5243 ts of.'foo_SOURC │ │ │ │ │ +00010da0: 4553 272e 0a0a 2020 2041 7574 6f6d 616b ES'... Automak │ │ │ │ │ +00010db0: 6520 616c 736f 2061 6c6c 6f77 7320 6120 e also allows a │ │ │ │ │ +00010dc0: 666f 726d 206f 6620 636f 6d6d 656e 7420 form of comment │ │ │ │ │ +00010dd0: 7468 6174 2069 7320 5f6e 6f74 5f20 636f that is _not_ co │ │ │ │ │ +00010de0: 7069 6564 2069 6e74 6f20 7468 650a 6f75 pied into the.ou │ │ │ │ │ +00010df0: 7470 7574 3b20 616c 6c20 6c69 6e65 7320 tput; all lines │ │ │ │ │ +00010e00: 6265 6769 6e6e 696e 6720 7769 7468 2027 beginning with ' │ │ │ │ │ +00010e10: 2323 2720 286c 6561 6469 6e67 2073 7061 ##' (leading spa │ │ │ │ │ +00010e20: 6365 7320 616c 6c6f 7765 6429 2061 7265 ces allowed) are │ │ │ │ │ +00010e30: 0a63 6f6d 706c 6574 656c 7920 6967 6e6f .completely igno │ │ │ │ │ +00010e40: 7265 6420 6279 2041 7574 6f6d 616b 652e red by Automake. │ │ │ │ │ +00010e50: 0a0a 2020 2049 7420 6973 2063 7573 746f .. It is custo │ │ │ │ │ +00010e60: 6d61 7279 2074 6f20 6d61 6b65 2074 6865 mary to make the │ │ │ │ │ +00010e70: 2066 6972 7374 206c 696e 6520 6f66 2027 first line of ' │ │ │ │ │ +00010e80: 4d61 6b65 6669 6c65 2e61 6d27 2072 6561 Makefile.am' rea │ │ │ │ │ +00010e90: 643a 0a0a 2020 2020 2023 2320 5072 6f63 d:.. ## Proc │ │ │ │ │ +00010ea0: 6573 7320 7468 6973 2066 696c 6520 7769 ess this file wi │ │ │ │ │ +00010eb0: 7468 2061 7574 6f6d 616b 6520 746f 2070 th automake to p │ │ │ │ │ +00010ec0: 726f 6475 6365 204d 616b 6566 696c 652e roduce Makefile. │ │ │ │ │ +00010ed0: 696e 0a0a 1f0a 4669 6c65 3a20 6175 746f in....File: auto │ │ │ │ │ +00010ee0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +00010ef0: 204e 6f64 653a 2053 7472 6963 746e 6573 Node: Strictnes │ │ │ │ │ +00010f00: 732c 2020 4e65 7874 3a20 556e 6966 6f72 s, Next: Unifor │ │ │ │ │ +00010f10: 6d2c 2020 5072 6576 3a20 4765 6e65 7261 m, Prev: Genera │ │ │ │ │ +00010f20: 6c20 4f70 6572 6174 696f 6e2c 2020 5570 l Operation, Up │ │ │ │ │ +00010f30: 3a20 4765 6e65 7261 6c69 7469 6573 0a0a : Generalities.. │ │ │ │ │ +00010f40: 332e 3220 5374 7269 6374 6e65 7373 0a3d 3.2 Strictness.= │ │ │ │ │ +00010f50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a57 =============..W │ │ │ │ │ +00010f60: 6869 6c65 2041 7574 6f6d 616b 6520 6973 hile Automake is │ │ │ │ │ +00010f70: 2069 6e74 656e 6465 6420 746f 2062 6520 intended to be │ │ │ │ │ +00010f80: 7573 6564 2062 7920 6d61 696e 7461 696e used by maintain │ │ │ │ │ +00010f90: 6572 7320 6f66 2047 4e55 2070 6163 6b61 ers of GNU packa │ │ │ │ │ +00010fa0: 6765 732c 2069 740a 646f 6573 206d 616b ges, it.does mak │ │ │ │ │ +00010fb0: 6520 736f 6d65 2065 6666 6f72 7420 746f e some effort to │ │ │ │ │ +00010fc0: 2061 6363 6f6d 6d6f 6461 7465 2074 686f accommodate tho │ │ │ │ │ +00010fd0: 7365 2077 686f 2077 6973 6820 746f 2075 se who wish to u │ │ │ │ │ +00010fe0: 7365 2069 742c 2062 7574 2064 6f0a 6e6f se it, but do.no │ │ │ │ │ +00010ff0: 7420 7761 6e74 2074 6f20 7573 6520 616c t want to use al │ │ │ │ │ +00011000: 6c20 7468 6520 474e 5520 636f 6e76 656e l the GNU conven │ │ │ │ │ +00011010: 7469 6f6e 732e 0a0a 2020 2054 6f20 7468 tions... To th │ │ │ │ │ +00011020: 6973 2065 6e64 2c20 4175 746f 6d61 6b65 is end, Automake │ │ │ │ │ +00011030: 2073 7570 706f 7274 7320 7468 7265 6520 supports three │ │ │ │ │ +00011040: 6c65 7665 6c73 206f 6620 2273 7472 6963 levels of "stric │ │ │ │ │ +00011050: 746e 6573 7322 2d2d 7468 650a 7374 7269 tness"--the.stri │ │ │ │ │ +00011060: 6374 6e65 7373 2069 6e64 6963 6174 696e ctness indicatin │ │ │ │ │ +00011070: 6720 686f 7720 7374 7269 6e67 656e 746c g how stringentl │ │ │ │ │ +00011080: 7920 4175 746f 6d61 6b65 2073 686f 756c y Automake shoul │ │ │ │ │ +00011090: 6420 6368 6563 6b20 7374 616e 6461 7264 d check standard │ │ │ │ │ +000110a0: 730a 636f 6e66 6f72 6d61 6e63 652e 0a0a s.conformance... │ │ │ │ │ +000110b0: 2020 2054 6865 2076 616c 6964 2073 7472 The valid str │ │ │ │ │ +000110c0: 6963 746e 6573 7320 6c65 7665 6c73 2061 ictness levels a │ │ │ │ │ +000110d0: 7265 3a0a 0a27 666f 7265 6967 6e27 0a20 re:..'foreign'. │ │ │ │ │ +000110e0: 2020 2020 4175 746f 6d61 6b65 2077 696c Automake wil │ │ │ │ │ +000110f0: 6c20 6368 6563 6b20 666f 7220 6f6e 6c79 l check for only │ │ │ │ │ +00011100: 2074 686f 7365 2074 6869 6e67 7320 7468 those things th │ │ │ │ │ +00011110: 6174 2061 7265 2061 6273 6f6c 7574 656c at are absolutel │ │ │ │ │ +00011120: 790a 2020 2020 2072 6571 7569 7265 6420 y. required │ │ │ │ │ +00011130: 666f 7220 7072 6f70 6572 206f 7065 7261 for proper opera │ │ │ │ │ +00011140: 7469 6f6e 732e 2020 466f 7220 696e 7374 tions. For inst │ │ │ │ │ +00011150: 616e 6365 2c20 7768 6572 6561 7320 474e ance, whereas GN │ │ │ │ │ +00011160: 550a 2020 2020 2073 7461 6e64 6172 6473 U. standards │ │ │ │ │ +00011170: 2064 6963 7461 7465 2074 6865 2065 7869 dictate the exi │ │ │ │ │ +00011180: 7374 656e 6365 206f 6620 6120 274e 4557 stence of a 'NEW │ │ │ │ │ +00011190: 5327 2066 696c 652c 2069 7420 7769 6c6c S' file, it will │ │ │ │ │ +000111a0: 206e 6f74 2062 650a 2020 2020 2072 6571 not be. req │ │ │ │ │ +000111b0: 7569 7265 6420 696e 2074 6869 7320 6d6f uired in this mo │ │ │ │ │ +000111c0: 6465 2e20 2054 6865 206e 616d 6520 636f de. The name co │ │ │ │ │ +000111d0: 6d65 7320 6672 6f6d 2074 6865 2066 6163 mes from the fac │ │ │ │ │ +000111e0: 7420 7468 6174 2041 7574 6f6d 616b 650a t that Automake. │ │ │ │ │ +000111f0: 2020 2020 2069 7320 696e 7465 6e64 6564 is intended │ │ │ │ │ +00011200: 2074 6f20 6265 2075 7365 6420 666f 7220 to be used for │ │ │ │ │ +00011210: 474e 5520 7072 6f67 7261 6d73 3b20 7468 GNU programs; th │ │ │ │ │ +00011220: 6573 6520 7265 6c61 7865 6420 7275 6c65 ese relaxed rule │ │ │ │ │ +00011230: 7320 6172 650a 2020 2020 206e 6f74 2074 s are. not t │ │ │ │ │ +00011240: 6865 2073 7461 6e64 6172 6420 6d6f 6465 he standard mode │ │ │ │ │ +00011250: 206f 6620 6f70 6572 6174 696f 6e2e 0a0a of operation... │ │ │ │ │ +00011260: 2767 6e75 270a 2020 2020 2041 7574 6f6d 'gnu'. Autom │ │ │ │ │ +00011270: 616b 6520 7769 6c6c 2063 6865 636b 2d2d ake will check-- │ │ │ │ │ +00011280: 6173 206d 7563 6820 6173 2070 6f73 7369 as much as possi │ │ │ │ │ +00011290: 626c 652d 2d66 6f72 2063 6f6d 706c 6961 ble--for complia │ │ │ │ │ +000112a0: 6e63 6520 746f 2074 6865 2047 4e55 0a20 nce to the GNU. │ │ │ │ │ +000112b0: 2020 2020 7374 616e 6461 7264 7320 666f standards fo │ │ │ │ │ +000112c0: 7220 7061 636b 6167 6573 2e20 2054 6869 r packages. Thi │ │ │ │ │ +000112d0: 7320 6973 2074 6865 2064 6566 6175 6c74 s is the default │ │ │ │ │ +000112e0: 2e0a 0a27 676e 6974 7327 0a20 2020 2020 ...'gnits'. │ │ │ │ │ +000112f0: 4175 746f 6d61 6b65 2077 696c 6c20 6368 Automake will ch │ │ │ │ │ +00011300: 6563 6b20 666f 7220 636f 6d70 6c69 616e eck for complian │ │ │ │ │ +00011310: 6365 2074 6f20 7468 6520 6173 2d79 6574 ce to the as-yet │ │ │ │ │ +00011320: 2d75 6e77 7269 7474 656e 2022 476e 6974 -unwritten "Gnit │ │ │ │ │ +00011330: 730a 2020 2020 2073 7461 6e64 6172 6473 s. standards │ │ │ │ │ +00011340: 222e 2020 5468 6573 6520 6172 6520 6261 ". These are ba │ │ │ │ │ +00011350: 7365 6420 6f6e 2074 6865 2047 4e55 2073 sed on the GNU s │ │ │ │ │ +00011360: 7461 6e64 6172 6473 2c20 6275 7420 6172 tandards, but ar │ │ │ │ │ +00011370: 6520 6576 656e 0a20 2020 2020 6d6f 7265 e even. more │ │ │ │ │ +00011380: 2064 6574 6169 6c65 642e 2020 556e 6c65 detailed. Unle │ │ │ │ │ +00011390: 7373 2079 6f75 2061 7265 2061 2047 6e69 ss you are a Gni │ │ │ │ │ +000113a0: 7473 2073 7461 6e64 6172 6473 2063 6f6e ts standards con │ │ │ │ │ +000113b0: 7472 6962 7574 6f72 2c20 6974 2069 730a tributor, it is. │ │ │ │ │ +000113c0: 2020 2020 2072 6563 6f6d 6d65 6e64 6564 recommended │ │ │ │ │ +000113d0: 2074 6861 7420 796f 7520 6176 6f69 6420 that you avoid │ │ │ │ │ +000113e0: 7468 6973 206f 7074 696f 6e20 756e 7469 this option unti │ │ │ │ │ +000113f0: 6c20 7375 6368 2074 696d 6520 6173 2074 l such time as t │ │ │ │ │ +00011400: 6865 2047 6e69 7473 0a20 2020 2020 7374 he Gnits. st │ │ │ │ │ +00011410: 616e 6461 7264 2069 7320 6163 7475 616c andard is actual │ │ │ │ │ +00011420: 6c79 2070 7562 6c69 7368 6564 2028 7768 ly published (wh │ │ │ │ │ +00011430: 6963 6820 6d61 7920 6e65 7665 7220 6861 ich may never ha │ │ │ │ │ +00011440: 7070 656e 292e 0a0a 2020 202a 4e6f 7465 ppen)... *Note │ │ │ │ │ +00011450: 2047 6e69 7473 3a3a 2c20 666f 7220 6d6f Gnits::, for mo │ │ │ │ │ +00011460: 7265 2069 6e66 6f72 6d61 7469 6f6e 206f re information o │ │ │ │ │ +00011470: 6e20 7468 6520 7072 6563 6973 6520 696d n the precise im │ │ │ │ │ +00011480: 706c 6963 6174 696f 6e73 206f 660a 7468 plications of.th │ │ │ │ │ +00011490: 6520 7374 7269 6374 6e65 7373 206c 6576 e strictness lev │ │ │ │ │ +000114a0: 656c 2e0a 0a20 2020 4175 746f 6d61 6b65 el... Automake │ │ │ │ │ +000114b0: 2061 6c73 6f20 6861 7320 6120 7370 6563 also has a spec │ │ │ │ │ +000114c0: 6961 6c20 2861 6e64 205f 746f 6461 7920 ial (and _today │ │ │ │ │ +000114d0: 6465 7072 6563 6174 6564 5f29 2022 6379 deprecated_) "cy │ │ │ │ │ +000114e0: 676e 7573 2220 6d6f 6465 0a74 6861 7420 gnus" mode.that │ │ │ │ │ +000114f0: 6973 2073 696d 696c 6172 2074 6f20 7374 is similar to st │ │ │ │ │ +00011500: 7269 6374 6e65 7373 2062 7574 2068 616e rictness but han │ │ │ │ │ +00011510: 646c 6564 2064 6966 6665 7265 6e74 6c79 dled differently │ │ │ │ │ +00011520: 2e20 2054 6869 7320 6d6f 6465 2069 730a . This mode is. │ │ │ │ │ +00011530: 7573 6566 756c 2066 6f72 2070 6163 6b61 useful for packa │ │ │ │ │ +00011540: 6765 7320 7468 6174 2061 7265 2070 7574 ges that are put │ │ │ │ │ +00011550: 2069 6e74 6f20 6120 2243 7967 6e75 7322 into a "Cygnus" │ │ │ │ │ +00011560: 2073 7479 6c65 2074 7265 6520 2865 2e67 style tree (e.g │ │ │ │ │ +00011570: 2e2c 206f 6c64 6572 0a76 6572 7369 6f6e ., older.version │ │ │ │ │ +00011580: 7320 6f66 2074 6865 2047 4343 2061 6e64 s of the GCC and │ │ │ │ │ +00011590: 2067 6462 2074 7265 6573 292e 2020 2a4e gdb trees). *N │ │ │ │ │ +000115a0: 6f74 6520 4379 676e 7573 3a3a 2c20 666f ote Cygnus::, fo │ │ │ │ │ +000115b0: 7220 6d6f 7265 0a69 6e66 6f72 6d61 7469 r more.informati │ │ │ │ │ +000115c0: 6f6e 206f 6e20 7468 6973 206d 6f64 652e on on this mode. │ │ │ │ │ +000115d0: 2020 506c 6561 7365 206e 6f74 6520 7468 Please note th │ │ │ │ │ +000115e0: 6174 2074 6869 7320 6d6f 6465 2069 7320 at this mode is │ │ │ │ │ +000115f0: 6465 7072 6563 6174 6564 2061 6e64 0a5f deprecated and._ │ │ │ │ │ +00011600: 7769 6c6c 2062 6520 7265 6d6f 7665 6420 will be removed │ │ │ │ │ +00011610: 696e 2074 6865 2066 7574 7572 6520 6175 in the future au │ │ │ │ │ +00011620: 746f 6d61 6b65 2076 6572 7369 6f6e 735f tomake versions_ │ │ │ │ │ +00011630: 3b20 796f 7520 6d75 7374 2061 766f 6964 ; you must avoid │ │ │ │ │ +00011640: 2069 7473 0a75 7365 2069 6e20 6e65 7720 its.use in new │ │ │ │ │ +00011650: 7061 636b 6167 6573 2c20 616e 6420 7368 packages, and sh │ │ │ │ │ +00011660: 6f75 6c64 2073 746f 7020 7573 696e 6720 ould stop using │ │ │ │ │ +00011670: 6974 2069 6e20 6578 6973 7469 6e67 2070 it in existing p │ │ │ │ │ +00011680: 6163 6b61 6765 7320 6173 0a77 656c 6c2e ackages as.well. │ │ │ │ │ +00011690: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +000116a0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +000116b0: 6f64 653a 2055 6e69 666f 726d 2c20 204e ode: Uniform, N │ │ │ │ │ +000116c0: 6578 743a 204c 656e 6774 6820 4c69 6d69 ext: Length Limi │ │ │ │ │ +000116d0: 7461 7469 6f6e 732c 2020 5072 6576 3a20 tations, Prev: │ │ │ │ │ +000116e0: 5374 7269 6374 6e65 7373 2c20 2055 703a Strictness, Up: │ │ │ │ │ +000116f0: 2047 656e 6572 616c 6974 6965 730a 0a33 Generalities..3 │ │ │ │ │ +00011700: 2e33 2054 6865 2055 6e69 666f 726d 204e .3 The Uniform N │ │ │ │ │ +00011710: 616d 696e 6720 5363 6865 6d65 0a3d 3d3d aming Scheme.=== │ │ │ │ │ 00011720: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00011730: 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 ========..Automa │ │ │ │ │ -00011740: 6b65 2076 6172 6961 626c 6573 2067 656e ke variables gen │ │ │ │ │ -00011750: 6572 616c 6c79 2066 6f6c 6c6f 7720 6120 erally follow a │ │ │ │ │ -00011760: 2275 6e69 666f 726d 206e 616d 696e 6720 "uniform naming │ │ │ │ │ -00011770: 7363 6865 6d65 2220 7468 6174 206d 616b scheme" that mak │ │ │ │ │ -00011780: 6573 0a69 7420 6561 7379 2074 6f20 6465 es.it easy to de │ │ │ │ │ -00011790: 6369 6465 2068 6f77 2070 726f 6772 616d cide how program │ │ │ │ │ -000117a0: 7320 2861 6e64 206f 7468 6572 2064 6572 s (and other der │ │ │ │ │ -000117b0: 6976 6564 206f 626a 6563 7473 2920 6172 ived objects) ar │ │ │ │ │ -000117c0: 6520 6275 696c 742c 0a61 6e64 2068 6f77 e built,.and how │ │ │ │ │ -000117d0: 2074 6865 7920 6172 6520 696e 7374 616c they are instal │ │ │ │ │ -000117e0: 6c65 642e 2020 5468 6973 2073 6368 656d led. This schem │ │ │ │ │ -000117f0: 6520 616c 736f 2073 7570 706f 7274 7320 e also supports │ │ │ │ │ -00011800: 2763 6f6e 6669 6775 7265 2720 7469 6d65 'configure' time │ │ │ │ │ -00011810: 0a64 6574 6572 6d69 6e61 7469 6f6e 206f .determination o │ │ │ │ │ -00011820: 6620 7768 6174 2073 686f 756c 6420 6265 f what should be │ │ │ │ │ -00011830: 2062 7569 6c74 2e0a 0a20 2020 4174 2027 built... At ' │ │ │ │ │ -00011840: 6d61 6b65 2720 7469 6d65 2c20 6365 7274 make' time, cert │ │ │ │ │ -00011850: 6169 6e20 7661 7269 6162 6c65 7320 6172 ain variables ar │ │ │ │ │ -00011860: 6520 7573 6564 2074 6f20 6465 7465 726d e used to determ │ │ │ │ │ -00011870: 696e 6520 7768 6963 6820 6f62 6a65 6374 ine which object │ │ │ │ │ -00011880: 730a 6172 6520 746f 2062 6520 6275 696c s.are to be buil │ │ │ │ │ -00011890: 742e 2020 5468 6520 7661 7269 6162 6c65 t. The variable │ │ │ │ │ -000118a0: 206e 616d 6573 2061 7265 206d 6164 6520 names are made │ │ │ │ │ -000118b0: 6f66 2073 6576 6572 616c 2070 6965 6365 of several piece │ │ │ │ │ -000118c0: 7320 7468 6174 2061 7265 0a63 6f6e 6361 s that are.conca │ │ │ │ │ -000118d0: 7465 6e61 7465 6420 746f 6765 7468 6572 tenated together │ │ │ │ │ -000118e0: 2e0a 0a20 2020 5468 6520 7069 6563 6520 ... The piece │ │ │ │ │ -000118f0: 7468 6174 2074 656c 6c73 2027 6175 746f that tells 'auto │ │ │ │ │ -00011900: 6d61 6b65 2720 7768 6174 2069 7320 6265 make' what is be │ │ │ │ │ -00011910: 696e 6720 6275 696c 7420 6973 2063 6f6d ing built is com │ │ │ │ │ -00011920: 6d6f 6e6c 790a 6361 6c6c 6564 2074 6865 monly.called the │ │ │ │ │ -00011930: 2022 7072 696d 6172 7922 2e20 2046 6f72 "primary". For │ │ │ │ │ -00011940: 2069 6e73 7461 6e63 652c 2074 6865 2070 instance, the p │ │ │ │ │ -00011950: 7269 6d61 7279 2027 5052 4f47 5241 4d53 rimary 'PROGRAMS │ │ │ │ │ -00011960: 2720 686f 6c64 7320 6120 6c69 7374 0a6f ' holds a list.o │ │ │ │ │ -00011970: 6620 7072 6f67 7261 6d73 2074 6861 7420 f programs that │ │ │ │ │ -00011980: 6172 6520 746f 2062 6520 636f 6d70 696c are to be compil │ │ │ │ │ -00011990: 6564 2061 6e64 206c 696e 6b65 642e 0a0a ed and linked... │ │ │ │ │ -000119a0: 2020 2041 2064 6966 6665 7265 6e74 2073 A different s │ │ │ │ │ -000119b0: 6574 206f 6620 6e61 6d65 7320 6973 2075 et of names is u │ │ │ │ │ -000119c0: 7365 6420 746f 2064 6563 6964 6520 7768 sed to decide wh │ │ │ │ │ -000119d0: 6572 6520 7468 6520 6275 696c 7420 6f62 ere the built ob │ │ │ │ │ -000119e0: 6a65 6374 730a 7368 6f75 6c64 2062 6520 jects.should be │ │ │ │ │ -000119f0: 696e 7374 616c 6c65 642e 2020 5468 6573 installed. Thes │ │ │ │ │ -00011a00: 6520 6e61 6d65 7320 6172 6520 7072 6566 e names are pref │ │ │ │ │ -00011a10: 6978 6573 2074 6f20 7468 6520 7072 696d ixes to the prim │ │ │ │ │ -00011a20: 6172 792c 2061 6e64 2074 6865 790a 696e ary, and they.in │ │ │ │ │ -00011a30: 6469 6361 7465 2077 6869 6368 2073 7461 dicate which sta │ │ │ │ │ -00011a40: 6e64 6172 6420 6469 7265 6374 6f72 7920 ndard directory │ │ │ │ │ -00011a50: 7368 6f75 6c64 2062 6520 7573 6564 2061 should be used a │ │ │ │ │ -00011a60: 7320 7468 6520 696e 7374 616c 6c61 7469 s the installati │ │ │ │ │ -00011a70: 6f6e 0a64 6972 6563 746f 7279 2e20 2054 on.directory. T │ │ │ │ │ -00011a80: 6865 2073 7461 6e64 6172 6420 6469 7265 he standard dire │ │ │ │ │ -00011a90: 6374 6f72 7920 6e61 6d65 7320 6172 6520 ctory names are │ │ │ │ │ -00011aa0: 6769 7665 6e20 696e 2074 6865 2047 4e55 given in the GNU │ │ │ │ │ -00011ab0: 2073 7461 6e64 6172 6473 0a28 2a6e 6f74 standards.(*not │ │ │ │ │ -00011ac0: 6520 2873 7461 6e64 6172 6473 2944 6972 e (standards)Dir │ │ │ │ │ -00011ad0: 6563 746f 7279 2056 6172 6961 626c 6573 ectory Variables │ │ │ │ │ -00011ae0: 3a3a 292e 2020 4175 746f 6d61 6b65 2065 ::). Automake e │ │ │ │ │ -00011af0: 7874 656e 6473 2074 6869 7320 6c69 7374 xtends this list │ │ │ │ │ -00011b00: 0a77 6974 6820 2770 6b67 6461 7461 6469 .with 'pkgdatadi │ │ │ │ │ -00011b10: 7227 2c20 2770 6b67 696e 636c 7564 6564 r', 'pkgincluded │ │ │ │ │ -00011b20: 6972 272c 2027 706b 676c 6962 6469 7227 ir', 'pkglibdir' │ │ │ │ │ -00011b30: 2c20 616e 6420 2770 6b67 6c69 6265 7865 , and 'pkglibexe │ │ │ │ │ -00011b40: 6364 6972 273b 0a74 6865 7365 2061 7265 cdir';.these are │ │ │ │ │ -00011b50: 2074 6865 2073 616d 6520 6173 2074 6865 the same as the │ │ │ │ │ -00011b60: 206e 6f6e 2d27 706b 6727 2076 6572 7369 non-'pkg' versi │ │ │ │ │ -00011b70: 6f6e 732c 2062 7574 2077 6974 6820 2724 ons, but with '$ │ │ │ │ │ -00011b80: 2850 4143 4b41 4745 2927 0a61 7070 656e (PACKAGE)'.appen │ │ │ │ │ -00011b90: 6465 642e 2020 466f 7220 696e 7374 616e ded. For instan │ │ │ │ │ -00011ba0: 6365 2c20 2770 6b67 6c69 6264 6972 2720 ce, 'pkglibdir' │ │ │ │ │ -00011bb0: 6973 2064 6566 696e 6564 2061 730a 2724 is defined as.'$ │ │ │ │ │ -00011bc0: 286c 6962 6469 7229 2f24 2850 4143 4b41 (libdir)/$(PACKA │ │ │ │ │ -00011bd0: 4745 2927 2e0a 0a20 2020 466f 7220 6561 GE)'... For ea │ │ │ │ │ -00011be0: 6368 2070 7269 6d61 7279 2c20 7468 6572 ch primary, ther │ │ │ │ │ -00011bf0: 6520 6973 206f 6e65 2061 6464 6974 696f e is one additio │ │ │ │ │ -00011c00: 6e61 6c20 7661 7269 6162 6c65 206e 616d nal variable nam │ │ │ │ │ -00011c10: 6564 2062 790a 7072 6570 656e 6469 6e67 ed by.prepending │ │ │ │ │ -00011c20: 2027 4558 5452 415f 2720 746f 2074 6865 'EXTRA_' to the │ │ │ │ │ -00011c30: 2070 7269 6d61 7279 206e 616d 652e 2020 primary name. │ │ │ │ │ -00011c40: 5468 6973 2076 6172 6961 626c 6520 6973 This variable is │ │ │ │ │ -00011c50: 2075 7365 6420 746f 206c 6973 740a 6f62 used to list.ob │ │ │ │ │ -00011c60: 6a65 6374 7320 7468 6174 206d 6179 206f jects that may o │ │ │ │ │ -00011c70: 7220 6d61 7920 6e6f 7420 6265 2062 7569 r may not be bui │ │ │ │ │ -00011c80: 6c74 2c20 6465 7065 6e64 696e 6720 6f6e lt, depending on │ │ │ │ │ -00011c90: 2077 6861 7420 2763 6f6e 6669 6775 7265 what 'configure │ │ │ │ │ -00011ca0: 270a 6465 6369 6465 732e 2020 5468 6973 '.decides. This │ │ │ │ │ -00011cb0: 2076 6172 6961 626c 6520 6973 2072 6571 variable is req │ │ │ │ │ -00011cc0: 7569 7265 6420 6265 6361 7573 6520 4175 uired because Au │ │ │ │ │ -00011cd0: 746f 6d61 6b65 206d 7573 7420 7374 6174 tomake must stat │ │ │ │ │ -00011ce0: 6963 616c 6c79 0a6b 6e6f 7720 7468 6520 ically.know the │ │ │ │ │ -00011cf0: 656e 7469 7265 206c 6973 7420 6f66 206f entire list of o │ │ │ │ │ -00011d00: 626a 6563 7473 2074 6861 7420 6d61 7920 bjects that may │ │ │ │ │ -00011d10: 6265 2062 7569 6c74 2069 6e20 6f72 6465 be built in orde │ │ │ │ │ -00011d20: 7220 746f 2067 656e 6572 6174 6520 610a r to generate a. │ │ │ │ │ -00011d30: 274d 616b 6566 696c 652e 696e 2720 7468 'Makefile.in' th │ │ │ │ │ -00011d40: 6174 2077 696c 6c20 776f 726b 2069 6e20 at will work in │ │ │ │ │ -00011d50: 616c 6c20 6361 7365 732e 0a0a 2020 2046 all cases... F │ │ │ │ │ -00011d60: 6f72 2069 6e73 7461 6e63 652c 2027 6370 or instance, 'cp │ │ │ │ │ -00011d70: 696f 2720 6465 6369 6465 7320 6174 2063 io' decides at c │ │ │ │ │ -00011d80: 6f6e 6669 6775 7265 2074 696d 6520 7768 onfigure time wh │ │ │ │ │ -00011d90: 6963 6820 7072 6f67 7261 6d73 2073 686f ich programs sho │ │ │ │ │ -00011da0: 756c 640a 6265 2062 7569 6c74 2e20 2053 uld.be built. S │ │ │ │ │ -00011db0: 6f6d 6520 6f66 2074 6865 2070 726f 6772 ome of the progr │ │ │ │ │ -00011dc0: 616d 7320 6172 6520 696e 7374 616c 6c65 ams are installe │ │ │ │ │ -00011dd0: 6420 696e 2027 6269 6e64 6972 272c 2061 d in 'bindir', a │ │ │ │ │ -00011de0: 6e64 2073 6f6d 6520 6172 650a 696e 7374 nd some are.inst │ │ │ │ │ -00011df0: 616c 6c65 6420 696e 2027 7362 696e 6469 alled in 'sbindi │ │ │ │ │ -00011e00: 7227 3a0a 0a20 2020 2020 4558 5452 415f r':.. EXTRA_ │ │ │ │ │ -00011e10: 5052 4f47 5241 4d53 203d 206d 7420 726d PROGRAMS = mt rm │ │ │ │ │ -00011e20: 740a 2020 2020 2062 696e 5f50 524f 4752 t. bin_PROGR │ │ │ │ │ -00011e30: 414d 5320 3d20 6370 696f 2070 6178 0a20 AMS = cpio pax. │ │ │ │ │ -00011e40: 2020 2020 7362 696e 5f50 524f 4752 414d sbin_PROGRAM │ │ │ │ │ -00011e50: 5320 3d20 2428 4d4f 5245 5f50 524f 4752 S = $(MORE_PROGR │ │ │ │ │ -00011e60: 414d 5329 0a0a 2020 2044 6566 696e 696e AMS).. Definin │ │ │ │ │ -00011e70: 6720 6120 7072 696d 6172 7920 7769 7468 g a primary with │ │ │ │ │ -00011e80: 6f75 7420 6120 7072 6566 6978 2061 7320 out a prefix as │ │ │ │ │ -00011e90: 6120 7661 7269 6162 6c65 2c20 652e 672e a variable, e.g. │ │ │ │ │ -00011ea0: 2c20 2750 524f 4752 414d 5327 2c0a 6973 , 'PROGRAMS',.is │ │ │ │ │ -00011eb0: 2061 6e20 6572 726f 722e 0a0a 2020 204e an error... N │ │ │ │ │ -00011ec0: 6f74 6520 7468 6174 2074 6865 2063 6f6d ote that the com │ │ │ │ │ -00011ed0: 6d6f 6e20 2764 6972 2720 7375 6666 6978 mon 'dir' suffix │ │ │ │ │ -00011ee0: 2069 7320 6c65 6674 206f 6666 2077 6865 is left off whe │ │ │ │ │ -00011ef0: 6e20 636f 6e73 7472 7563 7469 6e67 2074 n constructing t │ │ │ │ │ -00011f00: 6865 0a76 6172 6961 626c 6520 6e61 6d65 he.variable name │ │ │ │ │ -00011f10: 733b 2074 6875 7320 6f6e 6520 7772 6974 s; thus one writ │ │ │ │ │ -00011f20: 6573 2027 6269 6e5f 5052 4f47 5241 4d53 es 'bin_PROGRAMS │ │ │ │ │ -00011f30: 2720 616e 6420 6e6f 740a 2762 696e 6469 ' and not.'bindi │ │ │ │ │ -00011f40: 725f 5052 4f47 5241 4d53 272e 0a0a 2020 r_PROGRAMS'... │ │ │ │ │ -00011f50: 204e 6f74 2065 7665 7279 2073 6f72 7420 Not every sort │ │ │ │ │ -00011f60: 6f66 206f 626a 6563 7420 6361 6e20 6265 of object can be │ │ │ │ │ -00011f70: 2069 6e73 7461 6c6c 6564 2069 6e20 6576 installed in ev │ │ │ │ │ -00011f80: 6572 7920 6469 7265 6374 6f72 792e 0a41 ery directory..A │ │ │ │ │ -00011f90: 7574 6f6d 616b 6520 7769 6c6c 2066 6c61 utomake will fla │ │ │ │ │ -00011fa0: 6720 7468 6f73 6520 6174 7465 6d70 7473 g those attempts │ │ │ │ │ -00011fb0: 2069 7420 6669 6e64 7320 696e 2065 7272 it finds in err │ │ │ │ │ -00011fc0: 6f72 2028 6275 7420 7365 6520 6265 6c6f or (but see belo │ │ │ │ │ -00011fd0: 7720 686f 770a 746f 206f 7665 7272 6964 w how.to overrid │ │ │ │ │ -00011fe0: 6520 7468 6520 6368 6563 6b20 6966 2079 e the check if y │ │ │ │ │ -00011ff0: 6f75 2072 6561 6c6c 7920 6e65 6564 2074 ou really need t │ │ │ │ │ -00012000: 6f29 2e20 2041 7574 6f6d 616b 6520 7769 o). Automake wi │ │ │ │ │ -00012010: 6c6c 2061 6c73 6f0a 6469 6167 6e6f 7365 ll also.diagnose │ │ │ │ │ -00012020: 206f 6276 696f 7573 206d 6973 7370 656c obvious misspel │ │ │ │ │ -00012030: 6c69 6e67 7320 696e 2064 6972 6563 746f lings in directo │ │ │ │ │ -00012040: 7279 206e 616d 6573 2e0a 0a20 2020 536f ry names... So │ │ │ │ │ -00012050: 6d65 7469 6d65 7320 7468 6520 7374 616e metimes the stan │ │ │ │ │ -00012060: 6461 7264 2064 6972 6563 746f 7269 6573 dard directories │ │ │ │ │ -00012070: 2d2d 6576 656e 2061 7320 6175 676d 656e --even as augmen │ │ │ │ │ -00012080: 7465 6420 6279 0a41 7574 6f6d 616b 652d ted by.Automake- │ │ │ │ │ -00012090: 2d61 7265 206e 6f74 2065 6e6f 7567 682e -are not enough. │ │ │ │ │ -000120a0: 2020 496e 2070 6172 7469 6375 6c61 7220 In particular │ │ │ │ │ -000120b0: 6974 2069 7320 736f 6d65 7469 6d65 7320 it is sometimes │ │ │ │ │ -000120c0: 7573 6566 756c 2c20 666f 720a 636c 6172 useful, for.clar │ │ │ │ │ -000120d0: 6974 792c 2074 6f20 696e 7374 616c 6c20 ity, to install │ │ │ │ │ -000120e0: 6f62 6a65 6374 7320 696e 2061 2073 7562 objects in a sub │ │ │ │ │ -000120f0: 6469 7265 6374 6f72 7920 6f66 2073 6f6d directory of som │ │ │ │ │ -00012100: 6520 7072 6564 6566 696e 6564 0a64 6972 e predefined.dir │ │ │ │ │ -00012110: 6563 746f 7279 2e20 2054 6f20 7468 6973 ectory. To this │ │ │ │ │ -00012120: 2065 6e64 2c20 4175 746f 6d61 6b65 2061 end, Automake a │ │ │ │ │ -00012130: 6c6c 6f77 7320 796f 7520 746f 2065 7874 llows you to ext │ │ │ │ │ -00012140: 656e 6420 7468 6520 6c69 7374 206f 660a end the list of. │ │ │ │ │ -00012150: 706f 7373 6962 6c65 2069 6e73 7461 6c6c possible install │ │ │ │ │ -00012160: 6174 696f 6e20 6469 7265 6374 6f72 6965 ation directorie │ │ │ │ │ -00012170: 732e 2020 4120 6769 7665 6e20 7072 6566 s. A given pref │ │ │ │ │ -00012180: 6978 2028 652e 672e 2c20 277a 6172 2729 ix (e.g., 'zar') │ │ │ │ │ -00012190: 2069 730a 7661 6c69 6420 6966 2061 2076 is.valid if a v │ │ │ │ │ -000121a0: 6172 6961 626c 6520 6f66 2074 6865 2073 ariable of the s │ │ │ │ │ -000121b0: 616d 6520 6e61 6d65 2077 6974 6820 2764 ame name with 'd │ │ │ │ │ -000121c0: 6972 2720 6170 7065 6e64 6564 2069 7320 ir' appended is │ │ │ │ │ -000121d0: 6465 6669 6e65 640a 2865 2e67 2e2c 2027 defined.(e.g., ' │ │ │ │ │ -000121e0: 7a61 7264 6972 2729 2e0a 0a20 2020 466f zardir')... Fo │ │ │ │ │ -000121f0: 7220 696e 7374 616e 6365 2c20 7468 6520 r instance, the │ │ │ │ │ -00012200: 666f 6c6c 6f77 696e 6720 736e 6970 7065 following snippe │ │ │ │ │ -00012210: 7420 7769 6c6c 2069 6e73 7461 6c6c 2027 t will install ' │ │ │ │ │ -00012220: 6669 6c65 2e78 6d6c 2720 696e 746f 0a27 file.xml' into.' │ │ │ │ │ -00012230: 2428 6461 7461 6469 7229 2f78 6d6c 272e $(datadir)/xml'. │ │ │ │ │ -00012240: 0a0a 2020 2020 2078 6d6c 6469 7220 3d20 .. xmldir = │ │ │ │ │ -00012250: 2428 6461 7461 6469 7229 2f78 6d6c 0a20 $(datadir)/xml. │ │ │ │ │ -00012260: 2020 2020 786d 6c5f 4441 5441 203d 2066 xml_DATA = f │ │ │ │ │ -00012270: 696c 652e 786d 6c0a 0a20 2020 5468 6973 ile.xml.. This │ │ │ │ │ -00012280: 2066 6561 7475 7265 2063 616e 2061 6c73 feature can als │ │ │ │ │ -00012290: 6f20 6265 2075 7365 6420 746f 206f 7665 o be used to ove │ │ │ │ │ -000122a0: 7272 6964 6520 7468 6520 7361 6e69 7479 rride the sanity │ │ │ │ │ -000122b0: 2063 6865 636b 7320 4175 746f 6d61 6b65 checks Automake │ │ │ │ │ -000122c0: 0a70 6572 666f 726d 7320 746f 2064 6961 .performs to dia │ │ │ │ │ -000122d0: 676e 6f73 6520 7375 7370 6963 696f 7573 gnose suspicious │ │ │ │ │ -000122e0: 2064 6972 6563 746f 7279 2f70 7269 6d61 directory/prima │ │ │ │ │ -000122f0: 7279 2063 6f75 706c 6573 2028 696e 2074 ry couples (in t │ │ │ │ │ -00012300: 6865 0a75 6e6c 696b 656c 7920 6361 7365 he.unlikely case │ │ │ │ │ -00012310: 2074 6865 7365 2063 6865 636b 7320 6172 these checks ar │ │ │ │ │ -00012320: 6520 756e 6465 7369 7261 626c 652c 2061 e undesirable, a │ │ │ │ │ -00012330: 6e64 2079 6f75 2072 6561 6c6c 7920 6b6e nd you really kn │ │ │ │ │ -00012340: 6f77 2077 6861 740a 796f 7527 7265 2064 ow what.you're d │ │ │ │ │ -00012350: 6f69 6e67 292e 2020 466f 7220 6578 616d oing). For exam │ │ │ │ │ -00012360: 706c 652c 2041 7574 6f6d 616b 6520 776f ple, Automake wo │ │ │ │ │ -00012370: 756c 6420 6572 726f 7220 6f75 7420 6f6e uld error out on │ │ │ │ │ -00012380: 2074 6869 7320 696e 7075 743a 0a0a 2020 this input:.. │ │ │ │ │ -00012390: 2020 2023 2046 6f72 6269 6464 656e 2064 # Forbidden d │ │ │ │ │ -000123a0: 6972 6563 746f 7279 2063 6f6d 6269 6e61 irectory combina │ │ │ │ │ -000123b0: 7469 6f6e 732c 2061 7574 6f6d 616b 6520 tions, automake │ │ │ │ │ -000123c0: 7769 6c6c 2065 7272 6f72 206f 7574 206f will error out o │ │ │ │ │ -000123d0: 6e20 7468 6973 2e0a 2020 2020 2070 6b67 n this.. pkg │ │ │ │ │ -000123e0: 6c69 625f 5052 4f47 5241 4d53 203d 2066 lib_PROGRAMS = f │ │ │ │ │ -000123f0: 6f6f 0a20 2020 2020 646f 635f 4c49 4252 oo. doc_LIBR │ │ │ │ │ -00012400: 4152 4945 5320 3d20 6c69 6271 7575 782e ARIES = libquux. │ │ │ │ │ -00012410: 610a 0a62 7574 2069 7420 7769 6c6c 2073 a..but it will s │ │ │ │ │ -00012420: 7563 6365 6564 2077 6974 6820 7468 6973 ucceed with this │ │ │ │ │ -00012430: 3a0a 0a20 2020 2020 2320 576f 726b 2061 :.. # Work a │ │ │ │ │ -00012440: 726f 756e 6420 666f 7262 6964 6465 6e20 round forbidden │ │ │ │ │ -00012450: 6469 7265 6374 6f72 7920 636f 6d62 696e directory combin │ │ │ │ │ -00012460: 6174 696f 6e73 2e20 2044 6f20 6e6f 7420 ations. Do not │ │ │ │ │ -00012470: 7573 6520 7468 6973 0a20 2020 2020 2320 use this. # │ │ │ │ │ -00012480: 7769 7468 6f75 7420 6120 7665 7279 2067 without a very g │ │ │ │ │ -00012490: 6f6f 6420 7265 6173 6f6e 210a 2020 2020 ood reason!. │ │ │ │ │ -000124a0: 206d 795f 6578 6563 6269 6e64 6972 203d my_execbindir = │ │ │ │ │ -000124b0: 2024 2870 6b67 6c69 6264 6972 290a 2020 $(pkglibdir). │ │ │ │ │ -000124c0: 2020 206d 795f 646f 636c 6962 6469 7220 my_doclibdir │ │ │ │ │ -000124d0: 3d20 2428 646f 6364 6972 290a 2020 2020 = $(docdir). │ │ │ │ │ -000124e0: 206d 795f 6578 6563 6269 6e5f 5052 4f47 my_execbin_PROG │ │ │ │ │ -000124f0: 5241 4d53 203d 2066 6f6f 0a20 2020 2020 RAMS = foo. │ │ │ │ │ -00012500: 6d79 5f64 6f63 6c69 625f 4c49 4252 4152 my_doclib_LIBRAR │ │ │ │ │ -00012510: 4945 5320 3d20 6c69 6271 7575 782e 610a IES = libquux.a. │ │ │ │ │ -00012520: 0a20 2020 5468 6520 2765 7865 6327 2073 . The 'exec' s │ │ │ │ │ -00012530: 7562 7374 7269 6e67 206f 6620 7468 6520 ubstring of the │ │ │ │ │ -00012540: 276d 795f 6578 6563 6269 6e64 6972 2720 'my_execbindir' │ │ │ │ │ -00012550: 7661 7269 6162 6c65 206c 6574 7320 7468 variable lets th │ │ │ │ │ -00012560: 6520 6669 6c65 730a 6265 2069 6e73 7461 e files.be insta │ │ │ │ │ -00012570: 6c6c 6564 2061 7420 7468 6520 7269 6768 lled at the righ │ │ │ │ │ -00012580: 7420 7469 6d65 2028 2a6e 6f74 6520 5468 t time (*note Th │ │ │ │ │ -00012590: 6520 5477 6f20 5061 7274 7320 6f66 2049 e Two Parts of I │ │ │ │ │ -000125a0: 6e73 7461 6c6c 3a3a 292e 0a0a 2020 2054 nstall::)... T │ │ │ │ │ -000125b0: 6865 2073 7065 6369 616c 2070 7265 6669 he special prefi │ │ │ │ │ -000125c0: 7820 276e 6f69 6e73 745f 2720 696e 6469 x 'noinst_' indi │ │ │ │ │ -000125d0: 6361 7465 7320 7468 6174 2074 6865 206f cates that the o │ │ │ │ │ -000125e0: 626a 6563 7473 2069 6e20 7175 6573 7469 bjects in questi │ │ │ │ │ -000125f0: 6f6e 0a73 686f 756c 6420 6265 2062 7569 on.should be bui │ │ │ │ │ -00012600: 6c74 2062 7574 206e 6f74 2069 6e73 7461 lt but not insta │ │ │ │ │ -00012610: 6c6c 6564 2061 7420 616c 6c2e 2020 5468 lled at all. Th │ │ │ │ │ -00012620: 6973 2069 7320 7573 7561 6c6c 7920 7573 is is usually us │ │ │ │ │ -00012630: 6564 2066 6f72 0a6f 626a 6563 7473 2072 ed for.objects r │ │ │ │ │ -00012640: 6571 7569 7265 6420 746f 2062 7569 6c64 equired to build │ │ │ │ │ -00012650: 2074 6865 2072 6573 7420 6f66 2079 6f75 the rest of you │ │ │ │ │ -00012660: 7220 7061 636b 6167 652c 2066 6f72 2069 r package, for i │ │ │ │ │ -00012670: 6e73 7461 6e63 6520 7374 6174 6963 0a6c nstance static.l │ │ │ │ │ -00012680: 6962 7261 7269 6573 2028 2a6e 6f74 6520 ibraries (*note │ │ │ │ │ -00012690: 4120 4c69 6272 6172 793a 3a29 2c20 6f72 A Library::), or │ │ │ │ │ -000126a0: 2068 656c 7065 7220 7363 7269 7074 732e helper scripts. │ │ │ │ │ -000126b0: 0a0a 2020 2054 6865 2073 7065 6369 616c .. The special │ │ │ │ │ -000126c0: 2070 7265 6669 7820 2763 6865 636b 5f27 prefix 'check_' │ │ │ │ │ -000126d0: 2069 6e64 6963 6174 6573 2074 6861 7420 indicates that │ │ │ │ │ -000126e0: 7468 6520 6f62 6a65 6374 7320 696e 2071 the objects in q │ │ │ │ │ -000126f0: 7565 7374 696f 6e0a 7368 6f75 6c64 206e uestion.should n │ │ │ │ │ -00012700: 6f74 2062 6520 6275 696c 7420 756e 7469 ot be built unti │ │ │ │ │ -00012710: 6c20 7468 6520 276d 616b 6520 6368 6563 l the 'make chec │ │ │ │ │ -00012720: 6b27 2063 6f6d 6d61 6e64 2069 7320 7275 k' command is ru │ │ │ │ │ -00012730: 6e2e 2020 5468 6f73 650a 6f62 6a65 6374 n. Those.object │ │ │ │ │ -00012740: 7320 6172 6520 6e6f 7420 696e 7374 616c s are not instal │ │ │ │ │ -00012750: 6c65 6420 6569 7468 6572 2e0a 0a20 2020 led either... │ │ │ │ │ -00012760: 5468 6520 6375 7272 656e 7420 7072 696d The current prim │ │ │ │ │ -00012770: 6172 7920 6e61 6d65 7320 6172 6520 2750 ary names are 'P │ │ │ │ │ -00012780: 524f 4752 414d 5327 2c20 274c 4942 5241 ROGRAMS', 'LIBRA │ │ │ │ │ -00012790: 5249 4553 272c 2027 4c54 4c49 4252 4152 RIES', 'LTLIBRAR │ │ │ │ │ -000127a0: 4945 5327 2c0a 274c 4953 5027 2c20 2750 IES',.'LISP', 'P │ │ │ │ │ -000127b0: 5954 484f 4e27 2c20 274a 4156 4127 2c20 YTHON', 'JAVA', │ │ │ │ │ -000127c0: 2753 4352 4950 5453 272c 2027 4441 5441 'SCRIPTS', 'DATA │ │ │ │ │ -000127d0: 272c 2027 4845 4144 4552 5327 2c20 274d ', 'HEADERS', 'M │ │ │ │ │ -000127e0: 414e 5327 2c20 616e 640a 2754 4558 494e ANS', and.'TEXIN │ │ │ │ │ -000127f0: 464f 5327 2e0a 0a20 2020 536f 6d65 2070 FOS'... Some p │ │ │ │ │ -00012800: 7269 6d61 7269 6573 2061 6c73 6f20 616c rimaries also al │ │ │ │ │ -00012810: 6c6f 7720 6164 6469 7469 6f6e 616c 2070 low additional p │ │ │ │ │ -00012820: 7265 6669 7865 7320 7468 6174 2063 6f6e refixes that con │ │ │ │ │ -00012830: 7472 6f6c 206f 7468 6572 0a61 7370 6563 trol other.aspec │ │ │ │ │ -00012840: 7473 206f 6620 2761 7574 6f6d 616b 6527 ts of 'automake' │ │ │ │ │ -00012850: 2773 2062 6568 6176 696f 722e 2020 5468 's behavior. Th │ │ │ │ │ -00012860: 6520 6375 7272 656e 746c 7920 6465 6669 e currently defi │ │ │ │ │ -00012870: 6e65 6420 7072 6566 6978 6573 2061 7265 ned prefixes are │ │ │ │ │ -00012880: 0a27 6469 7374 5f27 2c20 276e 6f64 6973 .'dist_', 'nodis │ │ │ │ │ -00012890: 745f 272c 2027 6e6f 6261 7365 5f27 2c20 t_', 'nobase_', │ │ │ │ │ -000128a0: 616e 6420 276e 6f74 7261 6e73 5f27 2e20 and 'notrans_'. │ │ │ │ │ -000128b0: 2054 6865 7365 2070 7265 6669 7865 7320 These prefixes │ │ │ │ │ -000128c0: 6172 650a 6578 706c 6169 6e65 6420 6c61 are.explained la │ │ │ │ │ -000128d0: 7465 7220 282a 6e6f 7465 2050 726f 6772 ter (*note Progr │ │ │ │ │ -000128e0: 616d 2061 6e64 204c 6962 7261 7279 2056 am and Library V │ │ │ │ │ -000128f0: 6172 6961 626c 6573 3a3a 2920 282a 6e6f ariables::) (*no │ │ │ │ │ -00012900: 7465 204d 616e 0a50 6167 6573 3a3a 292e te Man.Pages::). │ │ │ │ │ -00012910: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00012920: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00012930: 6f64 653a 204c 656e 6774 6820 4c69 6d69 ode: Length Limi │ │ │ │ │ -00012940: 7461 7469 6f6e 732c 2020 4e65 7874 3a20 tations, Next: │ │ │ │ │ -00012950: 4361 6e6f 6e69 6361 6c69 7a61 7469 6f6e Canonicalization │ │ │ │ │ -00012960: 2c20 2050 7265 763a 2055 6e69 666f 726d , Prev: Uniform │ │ │ │ │ -00012970: 2c20 2055 703a 2047 656e 6572 616c 6974 , Up: Generalit │ │ │ │ │ -00012980: 6965 730a 0a33 2e34 2053 7461 7969 6e67 ies..3.4 Staying │ │ │ │ │ -00012990: 2062 656c 6f77 2074 6865 2063 6f6d 6d61 below the comma │ │ │ │ │ -000129a0: 6e64 206c 696e 6520 6c65 6e67 7468 206c nd line length l │ │ │ │ │ -000129b0: 696d 6974 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d imit.=========== │ │ │ │ │ +00011730: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f ==========..Auto │ │ │ │ │ +00011740: 6d61 6b65 2076 6172 6961 626c 6573 2067 make variables g │ │ │ │ │ +00011750: 656e 6572 616c 6c79 2066 6f6c 6c6f 7720 enerally follow │ │ │ │ │ +00011760: 6120 2275 6e69 666f 726d 206e 616d 696e a "uniform namin │ │ │ │ │ +00011770: 6720 7363 6865 6d65 2220 7468 6174 206d g scheme" that m │ │ │ │ │ +00011780: 616b 6573 0a69 7420 6561 7379 2074 6f20 akes.it easy to │ │ │ │ │ +00011790: 6465 6369 6465 2068 6f77 2070 726f 6772 decide how progr │ │ │ │ │ +000117a0: 616d 7320 2861 6e64 206f 7468 6572 2064 ams (and other d │ │ │ │ │ +000117b0: 6572 6976 6564 206f 626a 6563 7473 2920 erived objects) │ │ │ │ │ +000117c0: 6172 6520 6275 696c 742c 0a61 6e64 2068 are built,.and h │ │ │ │ │ +000117d0: 6f77 2074 6865 7920 6172 6520 696e 7374 ow they are inst │ │ │ │ │ +000117e0: 616c 6c65 642e 2020 5468 6973 2073 6368 alled. This sch │ │ │ │ │ +000117f0: 656d 6520 616c 736f 2073 7570 706f 7274 eme also support │ │ │ │ │ +00011800: 7320 2763 6f6e 6669 6775 7265 2720 7469 s 'configure' ti │ │ │ │ │ +00011810: 6d65 0a64 6574 6572 6d69 6e61 7469 6f6e me.determination │ │ │ │ │ +00011820: 206f 6620 7768 6174 2073 686f 756c 6420 of what should │ │ │ │ │ +00011830: 6265 2062 7569 6c74 2e0a 0a20 2020 4174 be built... At │ │ │ │ │ +00011840: 2027 6d61 6b65 2720 7469 6d65 2c20 6365 'make' time, ce │ │ │ │ │ +00011850: 7274 6169 6e20 7661 7269 6162 6c65 7320 rtain variables │ │ │ │ │ +00011860: 6172 6520 7573 6564 2074 6f20 6465 7465 are used to dete │ │ │ │ │ +00011870: 726d 696e 6520 7768 6963 6820 6f62 6a65 rmine which obje │ │ │ │ │ +00011880: 6374 730a 6172 6520 746f 2062 6520 6275 cts.are to be bu │ │ │ │ │ +00011890: 696c 742e 2020 5468 6520 7661 7269 6162 ilt. The variab │ │ │ │ │ +000118a0: 6c65 206e 616d 6573 2061 7265 206d 6164 le names are mad │ │ │ │ │ +000118b0: 6520 6f66 2073 6576 6572 616c 2070 6965 e of several pie │ │ │ │ │ +000118c0: 6365 7320 7468 6174 2061 7265 0a63 6f6e ces that are.con │ │ │ │ │ +000118d0: 6361 7465 6e61 7465 6420 746f 6765 7468 catenated togeth │ │ │ │ │ +000118e0: 6572 2e0a 0a20 2020 5468 6520 7069 6563 er... The piec │ │ │ │ │ +000118f0: 6520 7468 6174 2074 656c 6c73 2027 6175 e that tells 'au │ │ │ │ │ +00011900: 746f 6d61 6b65 2720 7768 6174 2069 7320 tomake' what is │ │ │ │ │ +00011910: 6265 696e 6720 6275 696c 7420 6973 2063 being built is c │ │ │ │ │ +00011920: 6f6d 6d6f 6e6c 790a 6361 6c6c 6564 2074 ommonly.called t │ │ │ │ │ +00011930: 6865 2022 7072 696d 6172 7922 2e20 2046 he "primary". F │ │ │ │ │ +00011940: 6f72 2069 6e73 7461 6e63 652c 2074 6865 or instance, the │ │ │ │ │ +00011950: 2070 7269 6d61 7279 2027 5052 4f47 5241 primary 'PROGRA │ │ │ │ │ +00011960: 4d53 2720 686f 6c64 7320 6120 6c69 7374 MS' holds a list │ │ │ │ │ +00011970: 0a6f 6620 7072 6f67 7261 6d73 2074 6861 .of programs tha │ │ │ │ │ +00011980: 7420 6172 6520 746f 2062 6520 636f 6d70 t are to be comp │ │ │ │ │ +00011990: 696c 6564 2061 6e64 206c 696e 6b65 642e iled and linked. │ │ │ │ │ +000119a0: 0a0a 2020 2041 2064 6966 6665 7265 6e74 .. A different │ │ │ │ │ +000119b0: 2073 6574 206f 6620 6e61 6d65 7320 6973 set of names is │ │ │ │ │ +000119c0: 2075 7365 6420 746f 2064 6563 6964 6520 used to decide │ │ │ │ │ +000119d0: 7768 6572 6520 7468 6520 6275 696c 7420 where the built │ │ │ │ │ +000119e0: 6f62 6a65 6374 730a 7368 6f75 6c64 2062 objects.should b │ │ │ │ │ +000119f0: 6520 696e 7374 616c 6c65 642e 2020 5468 e installed. Th │ │ │ │ │ +00011a00: 6573 6520 6e61 6d65 7320 6172 6520 7072 ese names are pr │ │ │ │ │ +00011a10: 6566 6978 6573 2074 6f20 7468 6520 7072 efixes to the pr │ │ │ │ │ +00011a20: 696d 6172 792c 2061 6e64 2074 6865 790a imary, and they. │ │ │ │ │ +00011a30: 696e 6469 6361 7465 2077 6869 6368 2073 indicate which s │ │ │ │ │ +00011a40: 7461 6e64 6172 6420 6469 7265 6374 6f72 tandard director │ │ │ │ │ +00011a50: 7920 7368 6f75 6c64 2062 6520 7573 6564 y should be used │ │ │ │ │ +00011a60: 2061 7320 7468 6520 696e 7374 616c 6c61 as the installa │ │ │ │ │ +00011a70: 7469 6f6e 0a64 6972 6563 746f 7279 2e20 tion.directory. │ │ │ │ │ +00011a80: 2054 6865 2073 7461 6e64 6172 6420 6469 The standard di │ │ │ │ │ +00011a90: 7265 6374 6f72 7920 6e61 6d65 7320 6172 rectory names ar │ │ │ │ │ +00011aa0: 6520 6769 7665 6e20 696e 2074 6865 2047 e given in the G │ │ │ │ │ +00011ab0: 4e55 2073 7461 6e64 6172 6473 0a28 2a6e NU standards.(*n │ │ │ │ │ +00011ac0: 6f74 6520 2873 7461 6e64 6172 6473 2944 ote (standards)D │ │ │ │ │ +00011ad0: 6972 6563 746f 7279 2056 6172 6961 626c irectory Variabl │ │ │ │ │ +00011ae0: 6573 3a3a 292e 2020 4175 746f 6d61 6b65 es::). Automake │ │ │ │ │ +00011af0: 2065 7874 656e 6473 2074 6869 7320 6c69 extends this li │ │ │ │ │ +00011b00: 7374 0a77 6974 6820 2770 6b67 6461 7461 st.with 'pkgdata │ │ │ │ │ +00011b10: 6469 7227 2c20 2770 6b67 696e 636c 7564 dir', 'pkginclud │ │ │ │ │ +00011b20: 6564 6972 272c 2027 706b 676c 6962 6469 edir', 'pkglibdi │ │ │ │ │ +00011b30: 7227 2c20 616e 6420 2770 6b67 6c69 6265 r', and 'pkglibe │ │ │ │ │ +00011b40: 7865 6364 6972 273b 0a74 6865 7365 2061 xecdir';.these a │ │ │ │ │ +00011b50: 7265 2074 6865 2073 616d 6520 6173 2074 re the same as t │ │ │ │ │ +00011b60: 6865 206e 6f6e 2d27 706b 6727 2076 6572 he non-'pkg' ver │ │ │ │ │ +00011b70: 7369 6f6e 732c 2062 7574 2077 6974 6820 sions, but with │ │ │ │ │ +00011b80: 2724 2850 4143 4b41 4745 2927 0a61 7070 '$(PACKAGE)'.app │ │ │ │ │ +00011b90: 656e 6465 642e 2020 466f 7220 696e 7374 ended. For inst │ │ │ │ │ +00011ba0: 616e 6365 2c20 2770 6b67 6c69 6264 6972 ance, 'pkglibdir │ │ │ │ │ +00011bb0: 2720 6973 2064 6566 696e 6564 2061 730a ' is defined as. │ │ │ │ │ +00011bc0: 2724 286c 6962 6469 7229 2f24 2850 4143 '$(libdir)/$(PAC │ │ │ │ │ +00011bd0: 4b41 4745 2927 2e0a 0a20 2020 466f 7220 KAGE)'... For │ │ │ │ │ +00011be0: 6561 6368 2070 7269 6d61 7279 2c20 7468 each primary, th │ │ │ │ │ +00011bf0: 6572 6520 6973 206f 6e65 2061 6464 6974 ere is one addit │ │ │ │ │ +00011c00: 696f 6e61 6c20 7661 7269 6162 6c65 206e ional variable n │ │ │ │ │ +00011c10: 616d 6564 2062 790a 7072 6570 656e 6469 amed by.prependi │ │ │ │ │ +00011c20: 6e67 2027 4558 5452 415f 2720 746f 2074 ng 'EXTRA_' to t │ │ │ │ │ +00011c30: 6865 2070 7269 6d61 7279 206e 616d 652e he primary name. │ │ │ │ │ +00011c40: 2020 5468 6973 2076 6172 6961 626c 6520 This variable │ │ │ │ │ +00011c50: 6973 2075 7365 6420 746f 206c 6973 740a is used to list. │ │ │ │ │ +00011c60: 6f62 6a65 6374 7320 7468 6174 206d 6179 objects that may │ │ │ │ │ +00011c70: 206f 7220 6d61 7920 6e6f 7420 6265 2062 or may not be b │ │ │ │ │ +00011c80: 7569 6c74 2c20 6465 7065 6e64 696e 6720 uilt, depending │ │ │ │ │ +00011c90: 6f6e 2077 6861 7420 2763 6f6e 6669 6775 on what 'configu │ │ │ │ │ +00011ca0: 7265 270a 6465 6369 6465 732e 2020 5468 re'.decides. Th │ │ │ │ │ +00011cb0: 6973 2076 6172 6961 626c 6520 6973 2072 is variable is r │ │ │ │ │ +00011cc0: 6571 7569 7265 6420 6265 6361 7573 6520 equired because │ │ │ │ │ +00011cd0: 4175 746f 6d61 6b65 206d 7573 7420 7374 Automake must st │ │ │ │ │ +00011ce0: 6174 6963 616c 6c79 0a6b 6e6f 7720 7468 atically.know th │ │ │ │ │ +00011cf0: 6520 656e 7469 7265 206c 6973 7420 6f66 e entire list of │ │ │ │ │ +00011d00: 206f 626a 6563 7473 2074 6861 7420 6d61 objects that ma │ │ │ │ │ +00011d10: 7920 6265 2062 7569 6c74 2069 6e20 6f72 y be built in or │ │ │ │ │ +00011d20: 6465 7220 746f 2067 656e 6572 6174 6520 der to generate │ │ │ │ │ +00011d30: 610a 274d 616b 6566 696c 652e 696e 2720 a.'Makefile.in' │ │ │ │ │ +00011d40: 7468 6174 2077 696c 6c20 776f 726b 2069 that will work i │ │ │ │ │ +00011d50: 6e20 616c 6c20 6361 7365 732e 0a0a 2020 n all cases... │ │ │ │ │ +00011d60: 2046 6f72 2069 6e73 7461 6e63 652c 2027 For instance, ' │ │ │ │ │ +00011d70: 6370 696f 2720 6465 6369 6465 7320 6174 cpio' decides at │ │ │ │ │ +00011d80: 2063 6f6e 6669 6775 7265 2074 696d 6520 configure time │ │ │ │ │ +00011d90: 7768 6963 6820 7072 6f67 7261 6d73 2073 which programs s │ │ │ │ │ +00011da0: 686f 756c 640a 6265 2062 7569 6c74 2e20 hould.be built. │ │ │ │ │ +00011db0: 2053 6f6d 6520 6f66 2074 6865 2070 726f Some of the pro │ │ │ │ │ +00011dc0: 6772 616d 7320 6172 6520 696e 7374 616c grams are instal │ │ │ │ │ +00011dd0: 6c65 6420 696e 2027 6269 6e64 6972 272c led in 'bindir', │ │ │ │ │ +00011de0: 2061 6e64 2073 6f6d 6520 6172 650a 696e and some are.in │ │ │ │ │ +00011df0: 7374 616c 6c65 6420 696e 2027 7362 696e stalled in 'sbin │ │ │ │ │ +00011e00: 6469 7227 3a0a 0a20 2020 2020 4558 5452 dir':.. EXTR │ │ │ │ │ +00011e10: 415f 5052 4f47 5241 4d53 203d 206d 7420 A_PROGRAMS = mt │ │ │ │ │ +00011e20: 726d 740a 2020 2020 2062 696e 5f50 524f rmt. bin_PRO │ │ │ │ │ +00011e30: 4752 414d 5320 3d20 6370 696f 2070 6178 GRAMS = cpio pax │ │ │ │ │ +00011e40: 0a20 2020 2020 7362 696e 5f50 524f 4752 . sbin_PROGR │ │ │ │ │ +00011e50: 414d 5320 3d20 2428 4d4f 5245 5f50 524f AMS = $(MORE_PRO │ │ │ │ │ +00011e60: 4752 414d 5329 0a0a 2020 2044 6566 696e GRAMS).. Defin │ │ │ │ │ +00011e70: 696e 6720 6120 7072 696d 6172 7920 7769 ing a primary wi │ │ │ │ │ +00011e80: 7468 6f75 7420 6120 7072 6566 6978 2061 thout a prefix a │ │ │ │ │ +00011e90: 7320 6120 7661 7269 6162 6c65 2c20 652e s a variable, e. │ │ │ │ │ +00011ea0: 672e 2c20 2750 524f 4752 414d 5327 2c0a g., 'PROGRAMS',. │ │ │ │ │ +00011eb0: 6973 2061 6e20 6572 726f 722e 0a0a 2020 is an error... │ │ │ │ │ +00011ec0: 204e 6f74 6520 7468 6174 2074 6865 2063 Note that the c │ │ │ │ │ +00011ed0: 6f6d 6d6f 6e20 2764 6972 2720 7375 6666 ommon 'dir' suff │ │ │ │ │ +00011ee0: 6978 2069 7320 6c65 6674 206f 6666 2077 ix is left off w │ │ │ │ │ +00011ef0: 6865 6e20 636f 6e73 7472 7563 7469 6e67 hen constructing │ │ │ │ │ +00011f00: 2074 6865 0a76 6172 6961 626c 6520 6e61 the.variable na │ │ │ │ │ +00011f10: 6d65 733b 2074 6875 7320 6f6e 6520 7772 mes; thus one wr │ │ │ │ │ +00011f20: 6974 6573 2027 6269 6e5f 5052 4f47 5241 ites 'bin_PROGRA │ │ │ │ │ +00011f30: 4d53 2720 616e 6420 6e6f 740a 2762 696e MS' and not.'bin │ │ │ │ │ +00011f40: 6469 725f 5052 4f47 5241 4d53 272e 0a0a dir_PROGRAMS'... │ │ │ │ │ +00011f50: 2020 204e 6f74 2065 7665 7279 2073 6f72 Not every sor │ │ │ │ │ +00011f60: 7420 6f66 206f 626a 6563 7420 6361 6e20 t of object can │ │ │ │ │ +00011f70: 6265 2069 6e73 7461 6c6c 6564 2069 6e20 be installed in │ │ │ │ │ +00011f80: 6576 6572 7920 6469 7265 6374 6f72 792e every directory. │ │ │ │ │ +00011f90: 0a41 7574 6f6d 616b 6520 7769 6c6c 2066 .Automake will f │ │ │ │ │ +00011fa0: 6c61 6720 7468 6f73 6520 6174 7465 6d70 lag those attemp │ │ │ │ │ +00011fb0: 7473 2069 7420 6669 6e64 7320 696e 2065 ts it finds in e │ │ │ │ │ +00011fc0: 7272 6f72 2028 6275 7420 7365 6520 6265 rror (but see be │ │ │ │ │ +00011fd0: 6c6f 7720 686f 770a 746f 206f 7665 7272 low how.to overr │ │ │ │ │ +00011fe0: 6964 6520 7468 6520 6368 6563 6b20 6966 ide the check if │ │ │ │ │ +00011ff0: 2079 6f75 2072 6561 6c6c 7920 6e65 6564 you really need │ │ │ │ │ +00012000: 2074 6f29 2e20 2041 7574 6f6d 616b 6520 to). Automake │ │ │ │ │ +00012010: 7769 6c6c 2061 6c73 6f0a 6469 6167 6e6f will also.diagno │ │ │ │ │ +00012020: 7365 206f 6276 696f 7573 206d 6973 7370 se obvious missp │ │ │ │ │ +00012030: 656c 6c69 6e67 7320 696e 2064 6972 6563 ellings in direc │ │ │ │ │ +00012040: 746f 7279 206e 616d 6573 2e0a 0a20 2020 tory names... │ │ │ │ │ +00012050: 536f 6d65 7469 6d65 7320 7468 6520 7374 Sometimes the st │ │ │ │ │ +00012060: 616e 6461 7264 2064 6972 6563 746f 7269 andard directori │ │ │ │ │ +00012070: 6573 2d2d 6576 656e 2061 7320 6175 676d es--even as augm │ │ │ │ │ +00012080: 656e 7465 6420 6279 0a41 7574 6f6d 616b ented by.Automak │ │ │ │ │ +00012090: 652d 2d61 7265 206e 6f74 2065 6e6f 7567 e--are not enoug │ │ │ │ │ +000120a0: 682e 2020 496e 2070 6172 7469 6375 6c61 h. In particula │ │ │ │ │ +000120b0: 7220 6974 2069 7320 736f 6d65 7469 6d65 r it is sometime │ │ │ │ │ +000120c0: 7320 7573 6566 756c 2c20 666f 720a 636c s useful, for.cl │ │ │ │ │ +000120d0: 6172 6974 792c 2074 6f20 696e 7374 616c arity, to instal │ │ │ │ │ +000120e0: 6c20 6f62 6a65 6374 7320 696e 2061 2073 l objects in a s │ │ │ │ │ +000120f0: 7562 6469 7265 6374 6f72 7920 6f66 2073 ubdirectory of s │ │ │ │ │ +00012100: 6f6d 6520 7072 6564 6566 696e 6564 0a64 ome predefined.d │ │ │ │ │ +00012110: 6972 6563 746f 7279 2e20 2054 6f20 7468 irectory. To th │ │ │ │ │ +00012120: 6973 2065 6e64 2c20 4175 746f 6d61 6b65 is end, Automake │ │ │ │ │ +00012130: 2061 6c6c 6f77 7320 796f 7520 746f 2065 allows you to e │ │ │ │ │ +00012140: 7874 656e 6420 7468 6520 6c69 7374 206f xtend the list o │ │ │ │ │ +00012150: 660a 706f 7373 6962 6c65 2069 6e73 7461 f.possible insta │ │ │ │ │ +00012160: 6c6c 6174 696f 6e20 6469 7265 6374 6f72 llation director │ │ │ │ │ +00012170: 6965 732e 2020 4120 6769 7665 6e20 7072 ies. A given pr │ │ │ │ │ +00012180: 6566 6978 2028 652e 672e 2c20 277a 6172 efix (e.g., 'zar │ │ │ │ │ +00012190: 2729 2069 730a 7661 6c69 6420 6966 2061 ') is.valid if a │ │ │ │ │ +000121a0: 2076 6172 6961 626c 6520 6f66 2074 6865 variable of the │ │ │ │ │ +000121b0: 2073 616d 6520 6e61 6d65 2077 6974 6820 same name with │ │ │ │ │ +000121c0: 2764 6972 2720 6170 7065 6e64 6564 2069 'dir' appended i │ │ │ │ │ +000121d0: 7320 6465 6669 6e65 640a 2865 2e67 2e2c s defined.(e.g., │ │ │ │ │ +000121e0: 2027 7a61 7264 6972 2729 2e0a 0a20 2020 'zardir')... │ │ │ │ │ +000121f0: 466f 7220 696e 7374 616e 6365 2c20 7468 For instance, th │ │ │ │ │ +00012200: 6520 666f 6c6c 6f77 696e 6720 736e 6970 e following snip │ │ │ │ │ +00012210: 7065 7420 7769 6c6c 2069 6e73 7461 6c6c pet will install │ │ │ │ │ +00012220: 2027 6669 6c65 2e78 6d6c 2720 696e 746f 'file.xml' into │ │ │ │ │ +00012230: 0a27 2428 6461 7461 6469 7229 2f78 6d6c .'$(datadir)/xml │ │ │ │ │ +00012240: 272e 0a0a 2020 2020 2078 6d6c 6469 7220 '... xmldir │ │ │ │ │ +00012250: 3d20 2428 6461 7461 6469 7229 2f78 6d6c = $(datadir)/xml │ │ │ │ │ +00012260: 0a20 2020 2020 786d 6c5f 4441 5441 203d . xml_DATA = │ │ │ │ │ +00012270: 2066 696c 652e 786d 6c0a 0a20 2020 5468 file.xml.. Th │ │ │ │ │ +00012280: 6973 2066 6561 7475 7265 2063 616e 2061 is feature can a │ │ │ │ │ +00012290: 6c73 6f20 6265 2075 7365 6420 746f 206f lso be used to o │ │ │ │ │ +000122a0: 7665 7272 6964 6520 7468 6520 7361 6e69 verride the sani │ │ │ │ │ +000122b0: 7479 2063 6865 636b 7320 4175 746f 6d61 ty checks Automa │ │ │ │ │ +000122c0: 6b65 0a70 6572 666f 726d 7320 746f 2064 ke.performs to d │ │ │ │ │ +000122d0: 6961 676e 6f73 6520 7375 7370 6963 696f iagnose suspicio │ │ │ │ │ +000122e0: 7573 2064 6972 6563 746f 7279 2f70 7269 us directory/pri │ │ │ │ │ +000122f0: 6d61 7279 2063 6f75 706c 6573 2028 696e mary couples (in │ │ │ │ │ +00012300: 2074 6865 0a75 6e6c 696b 656c 7920 6361 the.unlikely ca │ │ │ │ │ +00012310: 7365 2074 6865 7365 2063 6865 636b 7320 se these checks │ │ │ │ │ +00012320: 6172 6520 756e 6465 7369 7261 626c 652c are undesirable, │ │ │ │ │ +00012330: 2061 6e64 2079 6f75 2072 6561 6c6c 7920 and you really │ │ │ │ │ +00012340: 6b6e 6f77 2077 6861 740a 796f 7527 7265 know what.you're │ │ │ │ │ +00012350: 2064 6f69 6e67 292e 2020 466f 7220 6578 doing). For ex │ │ │ │ │ +00012360: 616d 706c 652c 2041 7574 6f6d 616b 6520 ample, Automake │ │ │ │ │ +00012370: 776f 756c 6420 6572 726f 7220 6f75 7420 would error out │ │ │ │ │ +00012380: 6f6e 2074 6869 7320 696e 7075 743a 0a0a on this input:.. │ │ │ │ │ +00012390: 2020 2020 2023 2046 6f72 6269 6464 656e # Forbidden │ │ │ │ │ +000123a0: 2064 6972 6563 746f 7279 2063 6f6d 6269 directory combi │ │ │ │ │ +000123b0: 6e61 7469 6f6e 732c 2061 7574 6f6d 616b nations, automak │ │ │ │ │ +000123c0: 6520 7769 6c6c 2065 7272 6f72 206f 7574 e will error out │ │ │ │ │ +000123d0: 206f 6e20 7468 6973 2e0a 2020 2020 2070 on this.. p │ │ │ │ │ +000123e0: 6b67 6c69 625f 5052 4f47 5241 4d53 203d kglib_PROGRAMS = │ │ │ │ │ +000123f0: 2066 6f6f 0a20 2020 2020 646f 635f 4c49 foo. doc_LI │ │ │ │ │ +00012400: 4252 4152 4945 5320 3d20 6c69 6271 7575 BRARIES = libquu │ │ │ │ │ +00012410: 782e 610a 0a62 7574 2069 7420 7769 6c6c x.a..but it will │ │ │ │ │ +00012420: 2073 7563 6365 6564 2077 6974 6820 7468 succeed with th │ │ │ │ │ +00012430: 6973 3a0a 0a20 2020 2020 2320 576f 726b is:.. # Work │ │ │ │ │ +00012440: 2061 726f 756e 6420 666f 7262 6964 6465 around forbidde │ │ │ │ │ +00012450: 6e20 6469 7265 6374 6f72 7920 636f 6d62 n directory comb │ │ │ │ │ +00012460: 696e 6174 696f 6e73 2e20 2044 6f20 6e6f inations. Do no │ │ │ │ │ +00012470: 7420 7573 6520 7468 6973 0a20 2020 2020 t use this. │ │ │ │ │ +00012480: 2320 7769 7468 6f75 7420 6120 7665 7279 # without a very │ │ │ │ │ +00012490: 2067 6f6f 6420 7265 6173 6f6e 210a 2020 good reason!. │ │ │ │ │ +000124a0: 2020 206d 795f 6578 6563 6269 6e64 6972 my_execbindir │ │ │ │ │ +000124b0: 203d 2024 2870 6b67 6c69 6264 6972 290a = $(pkglibdir). │ │ │ │ │ +000124c0: 2020 2020 206d 795f 646f 636c 6962 6469 my_doclibdi │ │ │ │ │ +000124d0: 7220 3d20 2428 646f 6364 6972 290a 2020 r = $(docdir). │ │ │ │ │ +000124e0: 2020 206d 795f 6578 6563 6269 6e5f 5052 my_execbin_PR │ │ │ │ │ +000124f0: 4f47 5241 4d53 203d 2066 6f6f 0a20 2020 OGRAMS = foo. │ │ │ │ │ +00012500: 2020 6d79 5f64 6f63 6c69 625f 4c49 4252 my_doclib_LIBR │ │ │ │ │ +00012510: 4152 4945 5320 3d20 6c69 6271 7575 782e ARIES = libquux. │ │ │ │ │ +00012520: 610a 0a20 2020 5468 6520 2765 7865 6327 a.. The 'exec' │ │ │ │ │ +00012530: 2073 7562 7374 7269 6e67 206f 6620 7468 substring of th │ │ │ │ │ +00012540: 6520 276d 795f 6578 6563 6269 6e64 6972 e 'my_execbindir │ │ │ │ │ +00012550: 2720 7661 7269 6162 6c65 206c 6574 7320 ' variable lets │ │ │ │ │ +00012560: 7468 6520 6669 6c65 730a 6265 2069 6e73 the files.be ins │ │ │ │ │ +00012570: 7461 6c6c 6564 2061 7420 7468 6520 7269 talled at the ri │ │ │ │ │ +00012580: 6768 7420 7469 6d65 2028 2a6e 6f74 6520 ght time (*note │ │ │ │ │ +00012590: 5468 6520 5477 6f20 5061 7274 7320 6f66 The Two Parts of │ │ │ │ │ +000125a0: 2049 6e73 7461 6c6c 3a3a 292e 0a0a 2020 Install::)... │ │ │ │ │ +000125b0: 2054 6865 2073 7065 6369 616c 2070 7265 The special pre │ │ │ │ │ +000125c0: 6669 7820 276e 6f69 6e73 745f 2720 696e fix 'noinst_' in │ │ │ │ │ +000125d0: 6469 6361 7465 7320 7468 6174 2074 6865 dicates that the │ │ │ │ │ +000125e0: 206f 626a 6563 7473 2069 6e20 7175 6573 objects in ques │ │ │ │ │ +000125f0: 7469 6f6e 0a73 686f 756c 6420 6265 2062 tion.should be b │ │ │ │ │ +00012600: 7569 6c74 2062 7574 206e 6f74 2069 6e73 uilt but not ins │ │ │ │ │ +00012610: 7461 6c6c 6564 2061 7420 616c 6c2e 2020 talled at all. │ │ │ │ │ +00012620: 5468 6973 2069 7320 7573 7561 6c6c 7920 This is usually │ │ │ │ │ +00012630: 7573 6564 2066 6f72 0a6f 626a 6563 7473 used for.objects │ │ │ │ │ +00012640: 2072 6571 7569 7265 6420 746f 2062 7569 required to bui │ │ │ │ │ +00012650: 6c64 2074 6865 2072 6573 7420 6f66 2079 ld the rest of y │ │ │ │ │ +00012660: 6f75 7220 7061 636b 6167 652c 2066 6f72 our package, for │ │ │ │ │ +00012670: 2069 6e73 7461 6e63 6520 7374 6174 6963 instance static │ │ │ │ │ +00012680: 0a6c 6962 7261 7269 6573 2028 2a6e 6f74 .libraries (*not │ │ │ │ │ +00012690: 6520 4120 4c69 6272 6172 793a 3a29 2c20 e A Library::), │ │ │ │ │ +000126a0: 6f72 2068 656c 7065 7220 7363 7269 7074 or helper script │ │ │ │ │ +000126b0: 732e 0a0a 2020 2054 6865 2073 7065 6369 s... The speci │ │ │ │ │ +000126c0: 616c 2070 7265 6669 7820 2763 6865 636b al prefix 'check │ │ │ │ │ +000126d0: 5f27 2069 6e64 6963 6174 6573 2074 6861 _' indicates tha │ │ │ │ │ +000126e0: 7420 7468 6520 6f62 6a65 6374 7320 696e t the objects in │ │ │ │ │ +000126f0: 2071 7565 7374 696f 6e0a 7368 6f75 6c64 question.should │ │ │ │ │ +00012700: 206e 6f74 2062 6520 6275 696c 7420 756e not be built un │ │ │ │ │ +00012710: 7469 6c20 7468 6520 276d 616b 6520 6368 til the 'make ch │ │ │ │ │ +00012720: 6563 6b27 2063 6f6d 6d61 6e64 2069 7320 eck' command is │ │ │ │ │ +00012730: 7275 6e2e 2020 5468 6f73 650a 6f62 6a65 run. Those.obje │ │ │ │ │ +00012740: 6374 7320 6172 6520 6e6f 7420 696e 7374 cts are not inst │ │ │ │ │ +00012750: 616c 6c65 6420 6569 7468 6572 2e0a 0a20 alled either... │ │ │ │ │ +00012760: 2020 5468 6520 6375 7272 656e 7420 7072 The current pr │ │ │ │ │ +00012770: 696d 6172 7920 6e61 6d65 7320 6172 6520 imary names are │ │ │ │ │ +00012780: 2750 524f 4752 414d 5327 2c20 274c 4942 'PROGRAMS', 'LIB │ │ │ │ │ +00012790: 5241 5249 4553 272c 2027 4c54 4c49 4252 RARIES', 'LTLIBR │ │ │ │ │ +000127a0: 4152 4945 5327 2c0a 274c 4953 5027 2c20 ARIES',.'LISP', │ │ │ │ │ +000127b0: 2750 5954 484f 4e27 2c20 274a 4156 4127 'PYTHON', 'JAVA' │ │ │ │ │ +000127c0: 2c20 2753 4352 4950 5453 272c 2027 4441 , 'SCRIPTS', 'DA │ │ │ │ │ +000127d0: 5441 272c 2027 4845 4144 4552 5327 2c20 TA', 'HEADERS', │ │ │ │ │ +000127e0: 274d 414e 5327 2c20 616e 640a 2754 4558 'MANS', and.'TEX │ │ │ │ │ +000127f0: 494e 464f 5327 2e0a 0a20 2020 536f 6d65 INFOS'... Some │ │ │ │ │ +00012800: 2070 7269 6d61 7269 6573 2061 6c73 6f20 primaries also │ │ │ │ │ +00012810: 616c 6c6f 7720 6164 6469 7469 6f6e 616c allow additional │ │ │ │ │ +00012820: 2070 7265 6669 7865 7320 7468 6174 2063 prefixes that c │ │ │ │ │ +00012830: 6f6e 7472 6f6c 206f 7468 6572 0a61 7370 ontrol other.asp │ │ │ │ │ +00012840: 6563 7473 206f 6620 2761 7574 6f6d 616b ects of 'automak │ │ │ │ │ +00012850: 6527 2773 2062 6568 6176 696f 722e 2020 e''s behavior. │ │ │ │ │ +00012860: 5468 6520 6375 7272 656e 746c 7920 6465 The currently de │ │ │ │ │ +00012870: 6669 6e65 6420 7072 6566 6978 6573 2061 fined prefixes a │ │ │ │ │ +00012880: 7265 0a27 6469 7374 5f27 2c20 276e 6f64 re.'dist_', 'nod │ │ │ │ │ +00012890: 6973 745f 272c 2027 6e6f 6261 7365 5f27 ist_', 'nobase_' │ │ │ │ │ +000128a0: 2c20 616e 6420 276e 6f74 7261 6e73 5f27 , and 'notrans_' │ │ │ │ │ +000128b0: 2e20 2054 6865 7365 2070 7265 6669 7865 . These prefixe │ │ │ │ │ +000128c0: 7320 6172 650a 6578 706c 6169 6e65 6420 s are.explained │ │ │ │ │ +000128d0: 6c61 7465 7220 282a 6e6f 7465 2050 726f later (*note Pro │ │ │ │ │ +000128e0: 6772 616d 2061 6e64 204c 6962 7261 7279 gram and Library │ │ │ │ │ +000128f0: 2056 6172 6961 626c 6573 3a3a 2920 282a Variables::) (* │ │ │ │ │ +00012900: 6e6f 7465 204d 616e 0a50 6167 6573 3a3a note Man.Pages:: │ │ │ │ │ +00012910: 292e 0a0a 1f0a 4669 6c65 3a20 6175 746f ).....File: auto │ │ │ │ │ +00012920: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +00012930: 204e 6f64 653a 204c 656e 6774 6820 4c69 Node: Length Li │ │ │ │ │ +00012940: 6d69 7461 7469 6f6e 732c 2020 4e65 7874 mitations, Next │ │ │ │ │ +00012950: 3a20 4361 6e6f 6e69 6361 6c69 7a61 7469 : Canonicalizati │ │ │ │ │ +00012960: 6f6e 2c20 2050 7265 763a 2055 6e69 666f on, Prev: Unifo │ │ │ │ │ +00012970: 726d 2c20 2055 703a 2047 656e 6572 616c rm, Up: General │ │ │ │ │ +00012980: 6974 6965 730a 0a33 2e34 2053 7461 7969 ities..3.4 Stayi │ │ │ │ │ +00012990: 6e67 2062 656c 6f77 2074 6865 2063 6f6d ng below the com │ │ │ │ │ +000129a0: 6d61 6e64 206c 696e 6520 6c65 6e67 7468 mand line length │ │ │ │ │ +000129b0: 206c 696d 6974 0a3d 3d3d 3d3d 3d3d 3d3d limit.========= │ │ │ │ │ 000129c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000129d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000129e0: 3d3d 3d3d 0a0a 5472 6164 6974 696f 6e61 ====..Traditiona │ │ │ │ │ -000129f0: 6c6c 792c 206d 6f73 7420 756e 6978 2d6c lly, most unix-l │ │ │ │ │ -00012a00: 696b 6520 7379 7374 656d 7320 6861 7665 ike systems have │ │ │ │ │ -00012a10: 2061 206c 656e 6774 6820 6c69 6d69 7461 a length limita │ │ │ │ │ -00012a20: 7469 6f6e 2066 6f72 2074 6865 0a63 6f6d tion for the.com │ │ │ │ │ -00012a30: 6d61 6e64 206c 696e 6520 6172 6775 6d65 mand line argume │ │ │ │ │ -00012a40: 6e74 7320 616e 6420 656e 7669 726f 6e6d nts and environm │ │ │ │ │ -00012a50: 656e 7420 636f 6e74 656e 7473 2077 6865 ent contents whe │ │ │ │ │ -00012a60: 6e20 6372 6561 7469 6e67 206e 6577 0a70 n creating new.p │ │ │ │ │ -00012a70: 726f 6365 7373 6573 2028 7365 6520 666f rocesses (see fo │ │ │ │ │ -00012a80: 7220 6578 616d 706c 650a 3c68 7474 703a r example. for a │ │ │ │ │ -00012ac0: 6e20 6f76 6572 7669 6577 206f 6e20 7468 n overview on th │ │ │ │ │ -00012ad0: 6973 0a69 7373 7565 292c 2077 6869 6368 is.issue), which │ │ │ │ │ -00012ae0: 206f 6620 636f 7572 7365 2061 6c73 6f20 of course also │ │ │ │ │ -00012af0: 6170 706c 6965 7320 746f 2063 6f6d 6d61 applies to comma │ │ │ │ │ -00012b00: 6e64 7320 7370 6177 6e65 6420 6279 2027 nds spawned by ' │ │ │ │ │ -00012b10: 6d61 6b65 272e 0a50 4f53 4958 2072 6571 make'..POSIX req │ │ │ │ │ -00012b20: 7569 7265 7320 7468 6973 206c 696d 6974 uires this limit │ │ │ │ │ -00012b30: 2074 6f20 6265 2061 7420 6c65 6173 7420 to be at least │ │ │ │ │ -00012b40: 3430 3936 2062 7974 6573 2c20 616e 6420 4096 bytes, and │ │ │ │ │ -00012b50: 6d6f 7374 206d 6f64 6572 6e0a 7379 7374 most modern.syst │ │ │ │ │ -00012b60: 656d 7320 6861 7665 2071 7569 7465 2068 ems have quite h │ │ │ │ │ -00012b70: 6967 6820 6c69 6d69 7473 2028 6f72 2061 igh limits (or a │ │ │ │ │ -00012b80: 7265 2075 6e6c 696d 6974 6564 292e 0a0a re unlimited)... │ │ │ │ │ -00012b90: 2020 2049 6e20 6f72 6465 7220 746f 2063 In order to c │ │ │ │ │ -00012ba0: 7265 6174 6520 706f 7274 6162 6c65 204d reate portable M │ │ │ │ │ -00012bb0: 616b 6566 696c 6573 2074 6861 7420 646f akefiles that do │ │ │ │ │ -00012bc0: 206e 6f74 2074 7269 7020 6f76 6572 2074 not trip over t │ │ │ │ │ -00012bd0: 6865 7365 0a6c 696d 6974 732c 2069 7420 hese.limits, it │ │ │ │ │ -00012be0: 6973 206e 6563 6573 7361 7279 2074 6f20 is necessary to │ │ │ │ │ -00012bf0: 6b65 6570 2074 6865 206c 656e 6774 6820 keep the length │ │ │ │ │ -00012c00: 6f66 2066 696c 6520 6c69 7374 7320 626f of file lists bo │ │ │ │ │ -00012c10: 756e 6465 642e 0a55 6e66 6f72 7475 6e61 unded..Unfortuna │ │ │ │ │ -00012c20: 7465 6c79 2c20 6974 2069 7320 6e6f 7420 tely, it is not │ │ │ │ │ -00012c30: 706f 7373 6962 6c65 2074 6f20 646f 2073 possible to do s │ │ │ │ │ -00012c40: 6f20 6675 6c6c 7920 7472 616e 7370 6172 o fully transpar │ │ │ │ │ -00012c50: 656e 746c 7920 7769 7468 696e 0a41 7574 ently within.Aut │ │ │ │ │ -00012c60: 6f6d 616b 652c 2073 6f20 796f 7572 2068 omake, so your h │ │ │ │ │ -00012c70: 656c 7020 6d61 7920 6265 206e 6565 6465 elp may be neede │ │ │ │ │ -00012c80: 642e 2020 5479 7069 6361 6c6c 792c 2079 d. Typically, y │ │ │ │ │ -00012c90: 6f75 2063 616e 2073 706c 6974 206c 6f6e ou can split lon │ │ │ │ │ -00012ca0: 670a 6669 6c65 206c 6973 7473 206d 616e g.file lists man │ │ │ │ │ -00012cb0: 7561 6c6c 7920 616e 6420 7573 6520 6469 ually and use di │ │ │ │ │ -00012cc0: 6666 6572 656e 7420 696e 7374 616c 6c61 fferent installa │ │ │ │ │ -00012cd0: 7469 6f6e 2064 6972 6563 746f 7279 206e tion directory n │ │ │ │ │ -00012ce0: 616d 6573 2066 6f72 0a65 6163 6820 6c69 ames for.each li │ │ │ │ │ -00012cf0: 7374 2e20 2046 6f72 2065 7861 6d70 6c65 st. For example │ │ │ │ │ -00012d00: 2c0a 0a20 2020 2020 6461 7461 5f44 4154 ,.. data_DAT │ │ │ │ │ -00012d10: 4120 3d20 6669 6c65 3120 2e2e 2e20 6669 A = file1 ... fi │ │ │ │ │ -00012d20: 6c65 4e20 6669 6c65 4e2b 3120 2e2e 2e20 leN fileN+1 ... │ │ │ │ │ -00012d30: 6669 6c65 324e 0a0a 6d61 7920 616c 736f file2N..may also │ │ │ │ │ -00012d40: 2062 6520 7772 6974 7465 6e20 6173 0a0a be written as.. │ │ │ │ │ -00012d50: 2020 2020 2064 6174 615f 4441 5441 203d data_DATA = │ │ │ │ │ -00012d60: 2066 696c 6531 202e 2e2e 2066 696c 654e file1 ... fileN │ │ │ │ │ -00012d70: 0a20 2020 2020 6461 7461 3264 6972 203d . data2dir = │ │ │ │ │ -00012d80: 2024 2864 6174 6164 6972 290a 2020 2020 $(datadir). │ │ │ │ │ -00012d90: 2064 6174 6132 5f44 4154 4120 3d20 6669 data2_DATA = fi │ │ │ │ │ -00012da0: 6c65 4e2b 3120 2e2e 2e20 6669 6c65 324e leN+1 ... file2N │ │ │ │ │ -00012db0: 0a0a 616e 6420 7769 6c6c 2063 6175 7365 ..and will cause │ │ │ │ │ -00012dc0: 2041 7574 6f6d 616b 6520 746f 2074 7265 Automake to tre │ │ │ │ │ -00012dd0: 6174 2074 6865 2074 776f 206c 6973 7473 at the two lists │ │ │ │ │ -00012de0: 2073 6570 6172 6174 656c 7920 6475 7269 separately duri │ │ │ │ │ -00012df0: 6e67 2027 6d61 6b65 0a69 6e73 7461 6c6c ng 'make.install │ │ │ │ │ -00012e00: 272e 2020 5365 6520 2a6e 6f74 6520 5468 '. See *note Th │ │ │ │ │ -00012e10: 6520 5477 6f20 5061 7274 7320 6f66 2049 e Two Parts of I │ │ │ │ │ -00012e20: 6e73 7461 6c6c 3a3a 2066 6f72 2063 686f nstall:: for cho │ │ │ │ │ -00012e30: 6f73 696e 6720 6469 7265 6374 6f72 790a osing directory. │ │ │ │ │ -00012e40: 6e61 6d65 7320 7468 6174 2077 696c 6c20 names that will │ │ │ │ │ -00012e50: 6b65 6570 2074 6865 206f 7264 6572 696e keep the orderin │ │ │ │ │ -00012e60: 6720 6f66 2074 6865 2074 776f 2070 6172 g of the two par │ │ │ │ │ -00012e70: 7473 206f 6620 696e 7374 616c 6c61 7469 ts of installati │ │ │ │ │ -00012e80: 6f6e 204e 6f74 650a 7468 6174 2027 6d61 on Note.that 'ma │ │ │ │ │ -00012e90: 6b65 2064 6973 7427 206d 6179 2073 7469 ke dist' may sti │ │ │ │ │ -00012ea0: 6c6c 206f 6e6c 7920 776f 726b 206f 6e20 ll only work on │ │ │ │ │ -00012eb0: 6120 686f 7374 2077 6974 6820 6120 6869 a host with a hi │ │ │ │ │ -00012ec0: 6768 6572 206c 656e 6774 680a 6c69 6d69 gher length.limi │ │ │ │ │ -00012ed0: 7420 696e 2074 6869 7320 6578 616d 706c t in this exampl │ │ │ │ │ -00012ee0: 652e 0a0a 2020 2041 7574 6f6d 616b 6520 e... Automake │ │ │ │ │ -00012ef0: 6974 7365 6c66 2065 6d70 6c6f 7973 2061 itself employs a │ │ │ │ │ -00012f00: 2063 6f75 706c 6520 6f66 2073 7472 6174 couple of strat │ │ │ │ │ -00012f10: 6567 6965 7320 746f 2061 766f 6964 206c egies to avoid l │ │ │ │ │ -00012f20: 6f6e 6720 636f 6d6d 616e 640a 6c69 6e65 ong command.line │ │ │ │ │ -00012f30: 732e 2020 466f 7220 6578 616d 706c 652c s. For example, │ │ │ │ │ -00012f40: 2077 6865 6e20 2724 7b73 7263 6469 727d when '${srcdir} │ │ │ │ │ -00012f50: 2f27 2069 7320 7072 6570 656e 6465 6420 /' is prepended │ │ │ │ │ -00012f60: 746f 2066 696c 6520 6e61 6d65 732c 2061 to file names, a │ │ │ │ │ -00012f70: 730a 6361 6e20 6861 7070 656e 2077 6974 s.can happen wit │ │ │ │ │ -00012f80: 6820 6162 6f76 6520 2724 2864 6174 615f h above '$(data_ │ │ │ │ │ -00012f90: 4441 5441 2927 206c 6973 7473 2c20 6974 DATA)' lists, it │ │ │ │ │ -00012fa0: 206c 696d 6974 7320 7468 6520 616d 6f75 limits the amou │ │ │ │ │ -00012fb0: 6e74 206f 660a 6172 6775 6d65 6e74 7320 nt of.arguments │ │ │ │ │ -00012fc0: 7061 7373 6564 2074 6f20 6578 7465 726e passed to extern │ │ │ │ │ -00012fd0: 616c 2063 6f6d 6d61 6e64 732e 0a0a 2020 al commands... │ │ │ │ │ -00012fe0: 2055 6e66 6f72 7475 6e61 7465 6c79 2c20 Unfortunately, │ │ │ │ │ -00012ff0: 736f 6d65 2073 7973 7465 6d27 7320 276d some system's 'm │ │ │ │ │ -00013000: 616b 6527 2063 6f6d 6d61 6e64 7320 6d61 ake' commands ma │ │ │ │ │ -00013010: 7920 7072 6570 656e 6420 2756 5041 5448 y prepend 'VPATH │ │ │ │ │ -00013020: 270a 7072 6566 6978 6573 206c 696b 6520 '.prefixes like │ │ │ │ │ -00013030: 2724 7b73 7263 6469 727d 2f27 2074 6f20 '${srcdir}/' to │ │ │ │ │ -00013040: 6669 6c65 206e 616d 6573 2066 726f 6d20 file names from │ │ │ │ │ -00013050: 7468 6520 736f 7572 6365 2074 7265 650a the source tree. │ │ │ │ │ -00013060: 6175 746f 6d61 7469 6361 6c6c 7920 282a automatically (* │ │ │ │ │ -00013070: 6e6f 7465 2041 7574 6f6d 6174 6963 2052 note Automatic R │ │ │ │ │ -00013080: 756c 6520 5265 7772 6974 696e 673a 2028 ule Rewriting: ( │ │ │ │ │ -00013090: 6175 746f 636f 6e66 2941 7574 6f6d 6174 autoconf)Automat │ │ │ │ │ -000130a0: 6963 2052 756c 650a 5265 7772 6974 696e ic Rule.Rewritin │ │ │ │ │ -000130b0: 672e 292e 2020 496e 2074 6869 7320 6361 g.). In this ca │ │ │ │ │ -000130c0: 7365 2c20 7468 6520 7573 6572 206d 6179 se, the user may │ │ │ │ │ -000130d0: 2068 6176 6520 746f 2073 7769 7463 6820 have to switch │ │ │ │ │ -000130e0: 746f 2075 7365 2047 4e55 204d 616b 652c to use GNU Make, │ │ │ │ │ -000130f0: 0a6f 7220 7265 6672 6169 6e20 6672 6f6d .or refrain from │ │ │ │ │ -00013100: 2075 7369 6e67 2056 5041 5448 2062 7569 using VPATH bui │ │ │ │ │ -00013110: 6c64 732c 2069 6e20 6f72 6465 7220 746f lds, in order to │ │ │ │ │ -00013120: 2073 7461 7920 6265 6c6f 7720 7468 6520 stay below the │ │ │ │ │ -00013130: 6c65 6e67 7468 0a6c 696d 6974 2e0a 0a20 length.limit... │ │ │ │ │ -00013140: 2020 466f 7220 6c69 6272 6172 6965 7320 For libraries │ │ │ │ │ -00013150: 616e 6420 7072 6f67 7261 6d73 2062 7569 and programs bui │ │ │ │ │ -00013160: 6c74 2066 726f 6d20 6d61 6e79 2073 6f75 lt from many sou │ │ │ │ │ -00013170: 7263 6573 2c20 636f 6e76 656e 6965 6e63 rces, convenienc │ │ │ │ │ -00013180: 650a 6172 6368 6976 6573 206d 6179 2062 e.archives may b │ │ │ │ │ -00013190: 6520 7573 6564 2061 7320 696e 7465 726d e used as interm │ │ │ │ │ -000131a0: 6564 6961 7465 7320 696e 206f 7264 6572 ediates in order │ │ │ │ │ -000131b0: 2074 6f20 6c69 6d69 7420 7468 6520 6f62 to limit the ob │ │ │ │ │ -000131c0: 6a65 6374 206c 6973 740a 6c65 6e67 7468 ject list.length │ │ │ │ │ -000131d0: 2028 2a6e 6f74 6520 4c69 6274 6f6f 6c20 (*note Libtool │ │ │ │ │ -000131e0: 436f 6e76 656e 6965 6e63 6520 4c69 6272 Convenience Libr │ │ │ │ │ -000131f0: 6172 6965 733a 3a29 2e0a 0a1f 0a46 696c aries::).....Fil │ │ │ │ │ -00013200: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -00013210: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4361 .info, Node: Ca │ │ │ │ │ -00013220: 6e6f 6e69 6361 6c69 7a61 7469 6f6e 2c20 nonicalization, │ │ │ │ │ -00013230: 204e 6578 743a 2055 7365 7220 5661 7269 Next: User Vari │ │ │ │ │ -00013240: 6162 6c65 732c 2020 5072 6576 3a20 4c65 ables, Prev: Le │ │ │ │ │ -00013250: 6e67 7468 204c 696d 6974 6174 696f 6e73 ngth Limitations │ │ │ │ │ -00013260: 2c20 2055 703a 2047 656e 6572 616c 6974 , Up: Generalit │ │ │ │ │ -00013270: 6965 730a 0a33 2e35 2048 6f77 2064 6572 ies..3.5 How der │ │ │ │ │ -00013280: 6976 6564 2076 6172 6961 626c 6573 2061 ived variables a │ │ │ │ │ -00013290: 7265 206e 616d 6564 0a3d 3d3d 3d3d 3d3d re named.======= │ │ │ │ │ +000129e0: 3d3d 3d3d 3d3d 0a0a 5472 6164 6974 696f ======..Traditio │ │ │ │ │ +000129f0: 6e61 6c6c 792c 206d 6f73 7420 756e 6978 nally, most unix │ │ │ │ │ +00012a00: 2d6c 696b 6520 7379 7374 656d 7320 6861 -like systems ha │ │ │ │ │ +00012a10: 7665 2061 206c 656e 6774 6820 6c69 6d69 ve a length limi │ │ │ │ │ +00012a20: 7461 7469 6f6e 2066 6f72 2074 6865 0a63 tation for the.c │ │ │ │ │ +00012a30: 6f6d 6d61 6e64 206c 696e 6520 6172 6775 ommand line argu │ │ │ │ │ +00012a40: 6d65 6e74 7320 616e 6420 656e 7669 726f ments and enviro │ │ │ │ │ +00012a50: 6e6d 656e 7420 636f 6e74 656e 7473 2077 nment contents w │ │ │ │ │ +00012a60: 6865 6e20 6372 6561 7469 6e67 206e 6577 hen creating new │ │ │ │ │ +00012a70: 0a70 726f 6365 7373 6573 2028 7365 6520 .processes (see │ │ │ │ │ +00012a80: 666f 7220 6578 616d 706c 650a 3c68 7474 for example. for │ │ │ │ │ +00012ac0: 2061 6e20 6f76 6572 7669 6577 206f 6e20 an overview on │ │ │ │ │ +00012ad0: 7468 6973 0a69 7373 7565 292c 2077 6869 this.issue), whi │ │ │ │ │ +00012ae0: 6368 206f 6620 636f 7572 7365 2061 6c73 ch of course als │ │ │ │ │ +00012af0: 6f20 6170 706c 6965 7320 746f 2063 6f6d o applies to com │ │ │ │ │ +00012b00: 6d61 6e64 7320 7370 6177 6e65 6420 6279 mands spawned by │ │ │ │ │ +00012b10: 2027 6d61 6b65 272e 0a50 4f53 4958 2072 'make'..POSIX r │ │ │ │ │ +00012b20: 6571 7569 7265 7320 7468 6973 206c 696d equires this lim │ │ │ │ │ +00012b30: 6974 2074 6f20 6265 2061 7420 6c65 6173 it to be at leas │ │ │ │ │ +00012b40: 7420 3430 3936 2062 7974 6573 2c20 616e t 4096 bytes, an │ │ │ │ │ +00012b50: 6420 6d6f 7374 206d 6f64 6572 6e0a 7379 d most modern.sy │ │ │ │ │ +00012b60: 7374 656d 7320 6861 7665 2071 7569 7465 stems have quite │ │ │ │ │ +00012b70: 2068 6967 6820 6c69 6d69 7473 2028 6f72 high limits (or │ │ │ │ │ +00012b80: 2061 7265 2075 6e6c 696d 6974 6564 292e are unlimited). │ │ │ │ │ +00012b90: 0a0a 2020 2049 6e20 6f72 6465 7220 746f .. In order to │ │ │ │ │ +00012ba0: 2063 7265 6174 6520 706f 7274 6162 6c65 create portable │ │ │ │ │ +00012bb0: 204d 616b 6566 696c 6573 2074 6861 7420 Makefiles that │ │ │ │ │ +00012bc0: 646f 206e 6f74 2074 7269 7020 6f76 6572 do not trip over │ │ │ │ │ +00012bd0: 2074 6865 7365 0a6c 696d 6974 732c 2069 these.limits, i │ │ │ │ │ +00012be0: 7420 6973 206e 6563 6573 7361 7279 2074 t is necessary t │ │ │ │ │ +00012bf0: 6f20 6b65 6570 2074 6865 206c 656e 6774 o keep the lengt │ │ │ │ │ +00012c00: 6820 6f66 2066 696c 6520 6c69 7374 7320 h of file lists │ │ │ │ │ +00012c10: 626f 756e 6465 642e 0a55 6e66 6f72 7475 bounded..Unfortu │ │ │ │ │ +00012c20: 6e61 7465 6c79 2c20 6974 2069 7320 6e6f nately, it is no │ │ │ │ │ +00012c30: 7420 706f 7373 6962 6c65 2074 6f20 646f t possible to do │ │ │ │ │ +00012c40: 2073 6f20 6675 6c6c 7920 7472 616e 7370 so fully transp │ │ │ │ │ +00012c50: 6172 656e 746c 7920 7769 7468 696e 0a41 arently within.A │ │ │ │ │ +00012c60: 7574 6f6d 616b 652c 2073 6f20 796f 7572 utomake, so your │ │ │ │ │ +00012c70: 2068 656c 7020 6d61 7920 6265 206e 6565 help may be nee │ │ │ │ │ +00012c80: 6465 642e 2020 5479 7069 6361 6c6c 792c ded. Typically, │ │ │ │ │ +00012c90: 2079 6f75 2063 616e 2073 706c 6974 206c you can split l │ │ │ │ │ +00012ca0: 6f6e 670a 6669 6c65 206c 6973 7473 206d ong.file lists m │ │ │ │ │ +00012cb0: 616e 7561 6c6c 7920 616e 6420 7573 6520 anually and use │ │ │ │ │ +00012cc0: 6469 6666 6572 656e 7420 696e 7374 616c different instal │ │ │ │ │ +00012cd0: 6c61 7469 6f6e 2064 6972 6563 746f 7279 lation directory │ │ │ │ │ +00012ce0: 206e 616d 6573 2066 6f72 0a65 6163 6820 names for.each │ │ │ │ │ +00012cf0: 6c69 7374 2e20 2046 6f72 2065 7861 6d70 list. For examp │ │ │ │ │ +00012d00: 6c65 2c0a 0a20 2020 2020 6461 7461 5f44 le,.. data_D │ │ │ │ │ +00012d10: 4154 4120 3d20 6669 6c65 3120 2e2e 2e20 ATA = file1 ... │ │ │ │ │ +00012d20: 6669 6c65 4e20 6669 6c65 4e2b 3120 2e2e fileN fileN+1 .. │ │ │ │ │ +00012d30: 2e20 6669 6c65 324e 0a0a 6d61 7920 616c . file2N..may al │ │ │ │ │ +00012d40: 736f 2062 6520 7772 6974 7465 6e20 6173 so be written as │ │ │ │ │ +00012d50: 0a0a 2020 2020 2064 6174 615f 4441 5441 .. data_DATA │ │ │ │ │ +00012d60: 203d 2066 696c 6531 202e 2e2e 2066 696c = file1 ... fil │ │ │ │ │ +00012d70: 654e 0a20 2020 2020 6461 7461 3264 6972 eN. data2dir │ │ │ │ │ +00012d80: 203d 2024 2864 6174 6164 6972 290a 2020 = $(datadir). │ │ │ │ │ +00012d90: 2020 2064 6174 6132 5f44 4154 4120 3d20 data2_DATA = │ │ │ │ │ +00012da0: 6669 6c65 4e2b 3120 2e2e 2e20 6669 6c65 fileN+1 ... file │ │ │ │ │ +00012db0: 324e 0a0a 616e 6420 7769 6c6c 2063 6175 2N..and will cau │ │ │ │ │ +00012dc0: 7365 2041 7574 6f6d 616b 6520 746f 2074 se Automake to t │ │ │ │ │ +00012dd0: 7265 6174 2074 6865 2074 776f 206c 6973 reat the two lis │ │ │ │ │ +00012de0: 7473 2073 6570 6172 6174 656c 7920 6475 ts separately du │ │ │ │ │ +00012df0: 7269 6e67 2027 6d61 6b65 0a69 6e73 7461 ring 'make.insta │ │ │ │ │ +00012e00: 6c6c 272e 2020 5365 6520 2a6e 6f74 6520 ll'. See *note │ │ │ │ │ +00012e10: 5468 6520 5477 6f20 5061 7274 7320 6f66 The Two Parts of │ │ │ │ │ +00012e20: 2049 6e73 7461 6c6c 3a3a 2066 6f72 2063 Install:: for c │ │ │ │ │ +00012e30: 686f 6f73 696e 6720 6469 7265 6374 6f72 hoosing director │ │ │ │ │ +00012e40: 790a 6e61 6d65 7320 7468 6174 2077 696c y.names that wil │ │ │ │ │ +00012e50: 6c20 6b65 6570 2074 6865 206f 7264 6572 l keep the order │ │ │ │ │ +00012e60: 696e 6720 6f66 2074 6865 2074 776f 2070 ing of the two p │ │ │ │ │ +00012e70: 6172 7473 206f 6620 696e 7374 616c 6c61 arts of installa │ │ │ │ │ +00012e80: 7469 6f6e 204e 6f74 650a 7468 6174 2027 tion Note.that ' │ │ │ │ │ +00012e90: 6d61 6b65 2064 6973 7427 206d 6179 2073 make dist' may s │ │ │ │ │ +00012ea0: 7469 6c6c 206f 6e6c 7920 776f 726b 206f till only work o │ │ │ │ │ +00012eb0: 6e20 6120 686f 7374 2077 6974 6820 6120 n a host with a │ │ │ │ │ +00012ec0: 6869 6768 6572 206c 656e 6774 680a 6c69 higher length.li │ │ │ │ │ +00012ed0: 6d69 7420 696e 2074 6869 7320 6578 616d mit in this exam │ │ │ │ │ +00012ee0: 706c 652e 0a0a 2020 2041 7574 6f6d 616b ple... Automak │ │ │ │ │ +00012ef0: 6520 6974 7365 6c66 2065 6d70 6c6f 7973 e itself employs │ │ │ │ │ +00012f00: 2061 2063 6f75 706c 6520 6f66 2073 7472 a couple of str │ │ │ │ │ +00012f10: 6174 6567 6965 7320 746f 2061 766f 6964 ategies to avoid │ │ │ │ │ +00012f20: 206c 6f6e 6720 636f 6d6d 616e 640a 6c69 long command.li │ │ │ │ │ +00012f30: 6e65 732e 2020 466f 7220 6578 616d 706c nes. For exampl │ │ │ │ │ +00012f40: 652c 2077 6865 6e20 2724 7b73 7263 6469 e, when '${srcdi │ │ │ │ │ +00012f50: 727d 2f27 2069 7320 7072 6570 656e 6465 r}/' is prepende │ │ │ │ │ +00012f60: 6420 746f 2066 696c 6520 6e61 6d65 732c d to file names, │ │ │ │ │ +00012f70: 2061 730a 6361 6e20 6861 7070 656e 2077 as.can happen w │ │ │ │ │ +00012f80: 6974 6820 6162 6f76 6520 2724 2864 6174 ith above '$(dat │ │ │ │ │ +00012f90: 615f 4441 5441 2927 206c 6973 7473 2c20 a_DATA)' lists, │ │ │ │ │ +00012fa0: 6974 206c 696d 6974 7320 7468 6520 616d it limits the am │ │ │ │ │ +00012fb0: 6f75 6e74 206f 660a 6172 6775 6d65 6e74 ount of.argument │ │ │ │ │ +00012fc0: 7320 7061 7373 6564 2074 6f20 6578 7465 s passed to exte │ │ │ │ │ +00012fd0: 726e 616c 2063 6f6d 6d61 6e64 732e 0a0a rnal commands... │ │ │ │ │ +00012fe0: 2020 2055 6e66 6f72 7475 6e61 7465 6c79 Unfortunately │ │ │ │ │ +00012ff0: 2c20 736f 6d65 2073 7973 7465 6d27 7320 , some system's │ │ │ │ │ +00013000: 276d 616b 6527 2063 6f6d 6d61 6e64 7320 'make' commands │ │ │ │ │ +00013010: 6d61 7920 7072 6570 656e 6420 2756 5041 may prepend 'VPA │ │ │ │ │ +00013020: 5448 270a 7072 6566 6978 6573 206c 696b TH'.prefixes lik │ │ │ │ │ +00013030: 6520 2724 7b73 7263 6469 727d 2f27 2074 e '${srcdir}/' t │ │ │ │ │ +00013040: 6f20 6669 6c65 206e 616d 6573 2066 726f o file names fro │ │ │ │ │ +00013050: 6d20 7468 6520 736f 7572 6365 2074 7265 m the source tre │ │ │ │ │ +00013060: 650a 6175 746f 6d61 7469 6361 6c6c 7920 e.automatically │ │ │ │ │ +00013070: 282a 6e6f 7465 2041 7574 6f6d 6174 6963 (*note Automatic │ │ │ │ │ +00013080: 2052 756c 6520 5265 7772 6974 696e 673a Rule Rewriting: │ │ │ │ │ +00013090: 2028 6175 746f 636f 6e66 2941 7574 6f6d (autoconf)Autom │ │ │ │ │ +000130a0: 6174 6963 2052 756c 650a 5265 7772 6974 atic Rule.Rewrit │ │ │ │ │ +000130b0: 696e 672e 292e 2020 496e 2074 6869 7320 ing.). In this │ │ │ │ │ +000130c0: 6361 7365 2c20 7468 6520 7573 6572 206d case, the user m │ │ │ │ │ +000130d0: 6179 2068 6176 6520 746f 2073 7769 7463 ay have to switc │ │ │ │ │ +000130e0: 6820 746f 2075 7365 2047 4e55 204d 616b h to use GNU Mak │ │ │ │ │ +000130f0: 652c 0a6f 7220 7265 6672 6169 6e20 6672 e,.or refrain fr │ │ │ │ │ +00013100: 6f6d 2075 7369 6e67 2056 5041 5448 2062 om using VPATH b │ │ │ │ │ +00013110: 7569 6c64 732c 2069 6e20 6f72 6465 7220 uilds, in order │ │ │ │ │ +00013120: 746f 2073 7461 7920 6265 6c6f 7720 7468 to stay below th │ │ │ │ │ +00013130: 6520 6c65 6e67 7468 0a6c 696d 6974 2e0a e length.limit.. │ │ │ │ │ +00013140: 0a20 2020 466f 7220 6c69 6272 6172 6965 . For librarie │ │ │ │ │ +00013150: 7320 616e 6420 7072 6f67 7261 6d73 2062 s and programs b │ │ │ │ │ +00013160: 7569 6c74 2066 726f 6d20 6d61 6e79 2073 uilt from many s │ │ │ │ │ +00013170: 6f75 7263 6573 2c20 636f 6e76 656e 6965 ources, convenie │ │ │ │ │ +00013180: 6e63 650a 6172 6368 6976 6573 206d 6179 nce.archives may │ │ │ │ │ +00013190: 2062 6520 7573 6564 2061 7320 696e 7465 be used as inte │ │ │ │ │ +000131a0: 726d 6564 6961 7465 7320 696e 206f 7264 rmediates in ord │ │ │ │ │ +000131b0: 6572 2074 6f20 6c69 6d69 7420 7468 6520 er to limit the │ │ │ │ │ +000131c0: 6f62 6a65 6374 206c 6973 740a 6c65 6e67 object list.leng │ │ │ │ │ +000131d0: 7468 2028 2a6e 6f74 6520 4c69 6274 6f6f th (*note Libtoo │ │ │ │ │ +000131e0: 6c20 436f 6e76 656e 6965 6e63 6520 4c69 l Convenience Li │ │ │ │ │ +000131f0: 6272 6172 6965 733a 3a29 2e0a 0a1f 0a46 braries::).....F │ │ │ │ │ +00013200: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +00013210: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +00013220: 4361 6e6f 6e69 6361 6c69 7a61 7469 6f6e Canonicalization │ │ │ │ │ +00013230: 2c20 204e 6578 743a 2055 7365 7220 5661 , Next: User Va │ │ │ │ │ +00013240: 7269 6162 6c65 732c 2020 5072 6576 3a20 riables, Prev: │ │ │ │ │ +00013250: 4c65 6e67 7468 204c 696d 6974 6174 696f Length Limitatio │ │ │ │ │ +00013260: 6e73 2c20 2055 703a 2047 656e 6572 616c ns, Up: General │ │ │ │ │ +00013270: 6974 6965 730a 0a33 2e35 2048 6f77 2064 ities..3.5 How d │ │ │ │ │ +00013280: 6572 6976 6564 2076 6172 6961 626c 6573 erived variables │ │ │ │ │ +00013290: 2061 7265 206e 616d 6564 0a3d 3d3d 3d3d are named.===== │ │ │ │ │ 000132a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000132b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 536f ============..So │ │ │ │ │ -000132c0: 6d65 7469 6d65 7320 6120 4d61 6b65 6669 metimes a Makefi │ │ │ │ │ -000132d0: 6c65 2076 6172 6961 626c 6520 6e61 6d65 le variable name │ │ │ │ │ -000132e0: 2069 7320 6465 7269 7665 6420 6672 6f6d is derived from │ │ │ │ │ -000132f0: 2073 6f6d 6520 7465 7874 2074 6865 0a6d some text the.m │ │ │ │ │ -00013300: 6169 6e74 6169 6e65 7220 7375 7070 6c69 aintainer suppli │ │ │ │ │ -00013310: 6573 2e20 2046 6f72 2069 6e73 7461 6e63 es. For instanc │ │ │ │ │ -00013320: 652c 2061 2070 726f 6772 616d 206e 616d e, a program nam │ │ │ │ │ -00013330: 6520 6c69 7374 6564 2069 6e20 275f 5052 e listed in '_PR │ │ │ │ │ -00013340: 4f47 5241 4d53 270a 6973 2072 6577 7269 OGRAMS'.is rewri │ │ │ │ │ -00013350: 7474 656e 2069 6e74 6f20 7468 6520 6e61 tten into the na │ │ │ │ │ -00013360: 6d65 206f 6620 6120 275f 534f 5552 4345 me of a '_SOURCE │ │ │ │ │ -00013370: 5327 2076 6172 6961 626c 652e 2020 496e S' variable. In │ │ │ │ │ -00013380: 2063 6173 6573 206c 696b 650a 7468 6973 cases like.this │ │ │ │ │ -00013390: 2c20 4175 746f 6d61 6b65 2063 616e 6f6e , Automake canon │ │ │ │ │ -000133a0: 6963 616c 697a 6573 2074 6865 2074 6578 icalizes the tex │ │ │ │ │ -000133b0: 742c 2073 6f20 7468 6174 2070 726f 6772 t, so that progr │ │ │ │ │ -000133c0: 616d 206e 616d 6573 2061 6e64 2074 6865 am names and the │ │ │ │ │ -000133d0: 0a6c 696b 6520 646f 206e 6f74 2068 6176 .like do not hav │ │ │ │ │ -000133e0: 6520 746f 2066 6f6c 6c6f 7720 4d61 6b65 e to follow Make │ │ │ │ │ -000133f0: 6669 6c65 2076 6172 6961 626c 6520 6e61 file variable na │ │ │ │ │ -00013400: 6d69 6e67 2072 756c 6573 2e20 2041 6c6c ming rules. All │ │ │ │ │ -00013410: 0a63 6861 7261 6374 6572 7320 696e 2074 .characters in t │ │ │ │ │ -00013420: 6865 206e 616d 6520 6578 6365 7074 2066 he name except f │ │ │ │ │ -00013430: 6f72 206c 6574 7465 7273 2c20 6e75 6d62 or letters, numb │ │ │ │ │ -00013440: 6572 732c 2074 6865 2073 7472 7564 656c ers, the strudel │ │ │ │ │ -00013450: 2028 4029 2c20 616e 640a 7468 6520 756e (@), and.the un │ │ │ │ │ -00013460: 6465 7273 636f 7265 2061 7265 2074 7572 derscore are tur │ │ │ │ │ -00013470: 6e65 6420 696e 746f 2075 6e64 6572 7363 ned into undersc │ │ │ │ │ -00013480: 6f72 6573 2077 6865 6e20 6d61 6b69 6e67 ores when making │ │ │ │ │ -00013490: 2076 6172 6961 626c 650a 7265 6665 7265 variable.refere │ │ │ │ │ -000134a0: 6e63 6573 2e0a 0a20 2020 466f 7220 6578 nces... For ex │ │ │ │ │ -000134b0: 616d 706c 652c 2069 6620 796f 7572 2070 ample, if your p │ │ │ │ │ -000134c0: 726f 6772 616d 2069 7320 6e61 6d65 6420 rogram is named │ │ │ │ │ -000134d0: 2773 6e69 6666 2d67 6c75 6527 2c20 7468 'sniff-glue', th │ │ │ │ │ -000134e0: 6520 6465 7269 7665 640a 7661 7269 6162 e derived.variab │ │ │ │ │ -000134f0: 6c65 206e 616d 6520 776f 756c 6420 6265 le name would be │ │ │ │ │ -00013500: 2027 736e 6966 665f 676c 7565 5f53 4f55 'sniff_glue_SOU │ │ │ │ │ -00013510: 5243 4553 272c 206e 6f74 2027 736e 6966 RCES', not 'snif │ │ │ │ │ -00013520: 662d 676c 7565 5f53 4f55 5243 4553 272e f-glue_SOURCES'. │ │ │ │ │ -00013530: 0a53 696d 696c 6172 6c79 2074 6865 2073 .Similarly the s │ │ │ │ │ -00013540: 6f75 7263 6573 2066 6f72 2061 206c 6962 ources for a lib │ │ │ │ │ -00013550: 7261 7279 206e 616d 6564 2027 6c69 626d rary named 'libm │ │ │ │ │ -00013560: 756d 626c 652b 2b2e 6127 2073 686f 756c umble++.a' shoul │ │ │ │ │ -00013570: 6420 6265 0a6c 6973 7465 6420 696e 2074 d be.listed in t │ │ │ │ │ -00013580: 6865 2027 6c69 626d 756d 626c 655f 5f5f he 'libmumble___ │ │ │ │ │ -00013590: 615f 534f 5552 4345 5327 2076 6172 6961 a_SOURCES' varia │ │ │ │ │ -000135a0: 626c 652e 0a0a 2020 2054 6865 2073 7472 ble... The str │ │ │ │ │ -000135b0: 7564 656c 2069 7320 616e 2061 6464 6974 udel is an addit │ │ │ │ │ -000135c0: 696f 6e2c 2074 6f20 6d61 6b65 2074 6865 ion, to make the │ │ │ │ │ -000135d0: 2075 7365 206f 6620 4175 746f 636f 6e66 use of Autoconf │ │ │ │ │ -000135e0: 2073 7562 7374 6974 7574 696f 6e73 0a69 substitutions.i │ │ │ │ │ -000135f0: 6e20 7661 7269 6162 6c65 206e 616d 6573 n variable names │ │ │ │ │ -00013600: 206c 6573 7320 6f62 6675 7363 6174 696e less obfuscatin │ │ │ │ │ -00013610: 672e 0a0a 1f0a 4669 6c65 3a20 6175 746f g.....File: auto │ │ │ │ │ -00013620: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00013630: 204e 6f64 653a 2055 7365 7220 5661 7269 Node: User Vari │ │ │ │ │ -00013640: 6162 6c65 732c 2020 4e65 7874 3a20 4175 ables, Next: Au │ │ │ │ │ -00013650: 7869 6c69 6172 7920 5072 6f67 7261 6d73 xiliary Programs │ │ │ │ │ -00013660: 2c20 2050 7265 763a 2043 616e 6f6e 6963 , Prev: Canonic │ │ │ │ │ -00013670: 616c 697a 6174 696f 6e2c 2020 5570 3a20 alization, Up: │ │ │ │ │ -00013680: 4765 6e65 7261 6c69 7469 6573 0a0a 332e Generalities..3. │ │ │ │ │ -00013690: 3620 5661 7269 6162 6c65 7320 7265 7365 6 Variables rese │ │ │ │ │ -000136a0: 7276 6564 2066 6f72 2074 6865 2075 7365 rved for the use │ │ │ │ │ -000136b0: 720a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d r.============== │ │ │ │ │ +000132b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +000132c0: 536f 6d65 7469 6d65 7320 6120 4d61 6b65 Sometimes a Make │ │ │ │ │ +000132d0: 6669 6c65 2076 6172 6961 626c 6520 6e61 file variable na │ │ │ │ │ +000132e0: 6d65 2069 7320 6465 7269 7665 6420 6672 me is derived fr │ │ │ │ │ +000132f0: 6f6d 2073 6f6d 6520 7465 7874 2074 6865 om some text the │ │ │ │ │ +00013300: 0a6d 6169 6e74 6169 6e65 7220 7375 7070 .maintainer supp │ │ │ │ │ +00013310: 6c69 6573 2e20 2046 6f72 2069 6e73 7461 lies. For insta │ │ │ │ │ +00013320: 6e63 652c 2061 2070 726f 6772 616d 206e nce, a program n │ │ │ │ │ +00013330: 616d 6520 6c69 7374 6564 2069 6e20 275f ame listed in '_ │ │ │ │ │ +00013340: 5052 4f47 5241 4d53 270a 6973 2072 6577 PROGRAMS'.is rew │ │ │ │ │ +00013350: 7269 7474 656e 2069 6e74 6f20 7468 6520 ritten into the │ │ │ │ │ +00013360: 6e61 6d65 206f 6620 6120 275f 534f 5552 name of a '_SOUR │ │ │ │ │ +00013370: 4345 5327 2076 6172 6961 626c 652e 2020 CES' variable. │ │ │ │ │ +00013380: 496e 2063 6173 6573 206c 696b 650a 7468 In cases like.th │ │ │ │ │ +00013390: 6973 2c20 4175 746f 6d61 6b65 2063 616e is, Automake can │ │ │ │ │ +000133a0: 6f6e 6963 616c 697a 6573 2074 6865 2074 onicalizes the t │ │ │ │ │ +000133b0: 6578 742c 2073 6f20 7468 6174 2070 726f ext, so that pro │ │ │ │ │ +000133c0: 6772 616d 206e 616d 6573 2061 6e64 2074 gram names and t │ │ │ │ │ +000133d0: 6865 0a6c 696b 6520 646f 206e 6f74 2068 he.like do not h │ │ │ │ │ +000133e0: 6176 6520 746f 2066 6f6c 6c6f 7720 4d61 ave to follow Ma │ │ │ │ │ +000133f0: 6b65 6669 6c65 2076 6172 6961 626c 6520 kefile variable │ │ │ │ │ +00013400: 6e61 6d69 6e67 2072 756c 6573 2e20 2041 naming rules. A │ │ │ │ │ +00013410: 6c6c 0a63 6861 7261 6374 6572 7320 696e ll.characters in │ │ │ │ │ +00013420: 2074 6865 206e 616d 6520 6578 6365 7074 the name except │ │ │ │ │ +00013430: 2066 6f72 206c 6574 7465 7273 2c20 6e75 for letters, nu │ │ │ │ │ +00013440: 6d62 6572 732c 2074 6865 2073 7472 7564 mbers, the strud │ │ │ │ │ +00013450: 656c 2028 4029 2c20 616e 640a 7468 6520 el (@), and.the │ │ │ │ │ +00013460: 756e 6465 7273 636f 7265 2061 7265 2074 underscore are t │ │ │ │ │ +00013470: 7572 6e65 6420 696e 746f 2075 6e64 6572 urned into under │ │ │ │ │ +00013480: 7363 6f72 6573 2077 6865 6e20 6d61 6b69 scores when maki │ │ │ │ │ +00013490: 6e67 2076 6172 6961 626c 650a 7265 6665 ng variable.refe │ │ │ │ │ +000134a0: 7265 6e63 6573 2e0a 0a20 2020 466f 7220 rences... For │ │ │ │ │ +000134b0: 6578 616d 706c 652c 2069 6620 796f 7572 example, if your │ │ │ │ │ +000134c0: 2070 726f 6772 616d 2069 7320 6e61 6d65 program is name │ │ │ │ │ +000134d0: 6420 2773 6e69 6666 2d67 6c75 6527 2c20 d 'sniff-glue', │ │ │ │ │ +000134e0: 7468 6520 6465 7269 7665 640a 7661 7269 the derived.vari │ │ │ │ │ +000134f0: 6162 6c65 206e 616d 6520 776f 756c 6420 able name would │ │ │ │ │ +00013500: 6265 2027 736e 6966 665f 676c 7565 5f53 be 'sniff_glue_S │ │ │ │ │ +00013510: 4f55 5243 4553 272c 206e 6f74 2027 736e OURCES', not 'sn │ │ │ │ │ +00013520: 6966 662d 676c 7565 5f53 4f55 5243 4553 iff-glue_SOURCES │ │ │ │ │ +00013530: 272e 0a53 696d 696c 6172 6c79 2074 6865 '..Similarly the │ │ │ │ │ +00013540: 2073 6f75 7263 6573 2066 6f72 2061 206c sources for a l │ │ │ │ │ +00013550: 6962 7261 7279 206e 616d 6564 2027 6c69 ibrary named 'li │ │ │ │ │ +00013560: 626d 756d 626c 652b 2b2e 6127 2073 686f bmumble++.a' sho │ │ │ │ │ +00013570: 756c 6420 6265 0a6c 6973 7465 6420 696e uld be.listed in │ │ │ │ │ +00013580: 2074 6865 2027 6c69 626d 756d 626c 655f the 'libmumble_ │ │ │ │ │ +00013590: 5f5f 615f 534f 5552 4345 5327 2076 6172 __a_SOURCES' var │ │ │ │ │ +000135a0: 6961 626c 652e 0a0a 2020 2054 6865 2073 iable... The s │ │ │ │ │ +000135b0: 7472 7564 656c 2069 7320 616e 2061 6464 trudel is an add │ │ │ │ │ +000135c0: 6974 696f 6e2c 2074 6f20 6d61 6b65 2074 ition, to make t │ │ │ │ │ +000135d0: 6865 2075 7365 206f 6620 4175 746f 636f he use of Autoco │ │ │ │ │ +000135e0: 6e66 2073 7562 7374 6974 7574 696f 6e73 nf substitutions │ │ │ │ │ +000135f0: 0a69 6e20 7661 7269 6162 6c65 206e 616d .in variable nam │ │ │ │ │ +00013600: 6573 206c 6573 7320 6f62 6675 7363 6174 es less obfuscat │ │ │ │ │ +00013610: 696e 672e 0a0a 1f0a 4669 6c65 3a20 6175 ing.....File: au │ │ │ │ │ +00013620: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00013630: 2c20 204e 6f64 653a 2055 7365 7220 5661 , Node: User Va │ │ │ │ │ +00013640: 7269 6162 6c65 732c 2020 4e65 7874 3a20 riables, Next: │ │ │ │ │ +00013650: 4175 7869 6c69 6172 7920 5072 6f67 7261 Auxiliary Progra │ │ │ │ │ +00013660: 6d73 2c20 2050 7265 763a 2043 616e 6f6e ms, Prev: Canon │ │ │ │ │ +00013670: 6963 616c 697a 6174 696f 6e2c 2020 5570 icalization, Up │ │ │ │ │ +00013680: 3a20 4765 6e65 7261 6c69 7469 6573 0a0a : Generalities.. │ │ │ │ │ +00013690: 332e 3620 5661 7269 6162 6c65 7320 7265 3.6 Variables re │ │ │ │ │ +000136a0: 7365 7276 6564 2066 6f72 2074 6865 2075 served for the u │ │ │ │ │ +000136b0: 7365 720a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ser.============ │ │ │ │ │ 000136c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000136d0: 3d3d 3d3d 3d0a 0a53 6f6d 6520 274d 616b =====..Some 'Mak │ │ │ │ │ -000136e0: 6566 696c 6527 2076 6172 6961 626c 6573 efile' variables │ │ │ │ │ -000136f0: 2061 7265 2072 6573 6572 7665 6420 6279 are reserved by │ │ │ │ │ -00013700: 2074 6865 2047 4e55 2043 6f64 696e 6720 the GNU Coding │ │ │ │ │ -00013710: 5374 616e 6461 7264 7320 666f 720a 7468 Standards for.th │ │ │ │ │ -00013720: 6520 7573 6520 6f66 2074 6865 2022 7573 e use of the "us │ │ │ │ │ -00013730: 6572 222d 2d74 6865 2070 6572 736f 6e20 er"--the person │ │ │ │ │ -00013740: 6275 696c 6469 6e67 2074 6865 2070 6163 building the pac │ │ │ │ │ -00013750: 6b61 6765 2e20 2046 6f72 2069 6e73 7461 kage. For insta │ │ │ │ │ -00013760: 6e63 652c 0a27 4346 4c41 4753 2720 6973 nce,.'CFLAGS' is │ │ │ │ │ -00013770: 206f 6e65 2073 7563 6820 7661 7269 6162 one such variab │ │ │ │ │ -00013780: 6c65 2e0a 0a20 2020 536f 6d65 7469 6d65 le... Sometime │ │ │ │ │ -00013790: 7320 7061 636b 6167 6520 6465 7665 6c6f s package develo │ │ │ │ │ -000137a0: 7065 7273 2061 7265 2074 656d 7074 6564 pers are tempted │ │ │ │ │ -000137b0: 2074 6f20 7365 7420 7573 6572 2076 6172 to set user var │ │ │ │ │ -000137c0: 6961 626c 6573 2073 7563 680a 6173 2027 iables such.as ' │ │ │ │ │ -000137d0: 4346 4c41 4753 2720 6265 6361 7573 6520 CFLAGS' because │ │ │ │ │ -000137e0: 6974 2061 7070 6561 7273 2074 6f20 6d61 it appears to ma │ │ │ │ │ -000137f0: 6b65 2074 6865 6972 206a 6f62 2065 6173 ke their job eas │ │ │ │ │ -00013800: 6965 722e 2020 486f 7765 7665 722c 2074 ier. However, t │ │ │ │ │ -00013810: 6865 0a70 6163 6b61 6765 2069 7473 656c he.package itsel │ │ │ │ │ -00013820: 6620 7368 6f75 6c64 206e 6576 6572 2073 f should never s │ │ │ │ │ -00013830: 6574 2061 2075 7365 7220 7661 7269 6162 et a user variab │ │ │ │ │ -00013840: 6c65 2c20 7061 7274 6963 756c 6172 6c79 le, particularly │ │ │ │ │ -00013850: 206e 6f74 2074 6f0a 696e 636c 7564 6520 not to.include │ │ │ │ │ -00013860: 7377 6974 6368 6573 2074 6861 7420 6172 switches that ar │ │ │ │ │ -00013870: 6520 7265 7175 6972 6564 2066 6f72 2070 e required for p │ │ │ │ │ -00013880: 726f 7065 7220 636f 6d70 696c 6174 696f roper compilatio │ │ │ │ │ -00013890: 6e20 6f66 2074 6865 0a70 6163 6b61 6765 n of the.package │ │ │ │ │ -000138a0: 2e20 2053 696e 6365 2074 6865 7365 2076 . Since these v │ │ │ │ │ -000138b0: 6172 6961 626c 6573 2061 7265 2064 6f63 ariables are doc │ │ │ │ │ -000138c0: 756d 656e 7465 6420 6173 2062 6569 6e67 umented as being │ │ │ │ │ -000138d0: 2066 6f72 2074 6865 2070 6163 6b61 6765 for the package │ │ │ │ │ -000138e0: 0a62 7569 6c64 6572 2c20 7468 6174 2070 .builder, that p │ │ │ │ │ -000138f0: 6572 736f 6e20 7269 6768 7466 756c 6c79 erson rightfully │ │ │ │ │ -00013900: 2065 7870 6563 7473 2074 6f20 6265 2061 expects to be a │ │ │ │ │ -00013910: 626c 6520 746f 206f 7665 7272 6964 6520 ble to override │ │ │ │ │ -00013920: 616e 7920 6f66 0a74 6865 7365 2076 6172 any of.these var │ │ │ │ │ -00013930: 6961 626c 6573 2061 7420 6275 696c 6420 iables at build │ │ │ │ │ -00013940: 7469 6d65 2e0a 0a20 2020 546f 2067 6574 time... To get │ │ │ │ │ -00013950: 2061 726f 756e 6420 7468 6973 2070 726f around this pro │ │ │ │ │ -00013960: 626c 656d 2c20 4175 746f 6d61 6b65 2069 blem, Automake i │ │ │ │ │ -00013970: 6e74 726f 6475 6365 7320 616e 2061 7574 ntroduces an aut │ │ │ │ │ -00013980: 6f6d 616b 652d 7370 6563 6966 6963 0a73 omake-specific.s │ │ │ │ │ -00013990: 6861 646f 7720 7661 7269 6162 6c65 2066 hadow variable f │ │ │ │ │ -000139a0: 6f72 2065 6163 6820 7573 6572 2066 6c61 or each user fla │ │ │ │ │ -000139b0: 6720 7661 7269 6162 6c65 2e20 2028 5368 g variable. (Sh │ │ │ │ │ -000139c0: 6164 6f77 2076 6172 6961 626c 6573 2061 adow variables a │ │ │ │ │ -000139d0: 7265 206e 6f74 0a69 6e74 726f 6475 6365 re not.introduce │ │ │ │ │ -000139e0: 6420 666f 7220 7661 7269 6162 6c65 7320 d for variables │ │ │ │ │ -000139f0: 6c69 6b65 2027 4343 272c 2077 6865 7265 like 'CC', where │ │ │ │ │ -00013a00: 2074 6865 7920 776f 756c 6420 6d61 6b65 they would make │ │ │ │ │ -00013a10: 206e 6f20 7365 6e73 652e 290a 5468 6520 no sense.).The │ │ │ │ │ -00013a20: 7368 6164 6f77 2076 6172 6961 626c 6520 shadow variable │ │ │ │ │ -00013a30: 6973 206e 616d 6564 2062 7920 7072 6570 is named by prep │ │ │ │ │ -00013a40: 656e 6469 6e67 2027 414d 5f27 2074 6f20 ending 'AM_' to │ │ │ │ │ -00013a50: 7468 6520 7573 6572 2076 6172 6961 626c the user variabl │ │ │ │ │ -00013a60: 6527 730a 6e61 6d65 2e20 2046 6f72 2069 e's.name. For i │ │ │ │ │ -00013a70: 6e73 7461 6e63 652c 2074 6865 2073 6861 nstance, the sha │ │ │ │ │ -00013a80: 646f 7720 7661 7269 6162 6c65 2066 6f72 dow variable for │ │ │ │ │ -00013a90: 2027 5946 4c41 4753 2720 6973 2027 414d 'YFLAGS' is 'AM │ │ │ │ │ -00013aa0: 5f59 464c 4147 5327 2e0a 5468 6520 7061 _YFLAGS'..The pa │ │ │ │ │ -00013ab0: 636b 6167 6520 6d61 696e 7461 696e 6572 ckage maintainer │ │ │ │ │ -00013ac0: 2d2d 7468 6174 2069 732c 2074 6865 2061 --that is, the a │ │ │ │ │ -00013ad0: 7574 686f 7228 7329 206f 6620 7468 6520 uthor(s) of the │ │ │ │ │ -00013ae0: 274d 616b 6566 696c 652e 616d 2720 616e 'Makefile.am' an │ │ │ │ │ -00013af0: 640a 2763 6f6e 6669 6775 7265 2e61 6327 d.'configure.ac' │ │ │ │ │ -00013b00: 2066 696c 6573 2d2d 6d61 7920 6164 6a75 files--may adju │ │ │ │ │ -00013b10: 7374 2074 6865 7365 2073 6861 646f 7720 st these shadow │ │ │ │ │ -00013b20: 7661 7269 6162 6c65 7320 686f 7765 7665 variables howeve │ │ │ │ │ -00013b30: 720a 6e65 6365 7373 6172 792e 0a0a 2020 r.necessary... │ │ │ │ │ -00013b40: 202a 4e6f 7465 2046 6c61 6720 5661 7269 *Note Flag Vari │ │ │ │ │ -00013b50: 6162 6c65 7320 4f72 6465 7269 6e67 3a3a ables Ordering:: │ │ │ │ │ -00013b60: 2c20 666f 7220 6d6f 7265 2064 6973 6375 , for more discu │ │ │ │ │ -00013b70: 7373 696f 6e20 6162 6f75 7420 7468 6573 ssion about thes │ │ │ │ │ -00013b80: 650a 7661 7269 6162 6c65 7320 616e 6420 e.variables and │ │ │ │ │ -00013b90: 686f 7720 7468 6579 2069 6e74 6572 6163 how they interac │ │ │ │ │ -00013ba0: 7420 7769 7468 2070 6572 2d74 6172 6765 t with per-targe │ │ │ │ │ -00013bb0: 7420 7661 7269 6162 6c65 732e 0a0a 1f0a t variables..... │ │ │ │ │ -00013bc0: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ -00013bd0: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ -00013be0: 2041 7578 696c 6961 7279 2050 726f 6772 Auxiliary Progr │ │ │ │ │ -00013bf0: 616d 732c 2020 5072 6576 3a20 5573 6572 ams, Prev: User │ │ │ │ │ -00013c00: 2056 6172 6961 626c 6573 2c20 2055 703a Variables, Up: │ │ │ │ │ -00013c10: 2047 656e 6572 616c 6974 6965 730a 0a33 Generalities..3 │ │ │ │ │ -00013c20: 2e37 2050 726f 6772 616d 7320 6175 746f .7 Programs auto │ │ │ │ │ -00013c30: 6d61 6b65 206d 6967 6874 2072 6571 7569 make might requi │ │ │ │ │ -00013c40: 7265 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d re.============= │ │ │ │ │ +000136d0: 3d3d 3d3d 3d3d 3d0a 0a53 6f6d 6520 274d =======..Some 'M │ │ │ │ │ +000136e0: 616b 6566 696c 6527 2076 6172 6961 626c akefile' variabl │ │ │ │ │ +000136f0: 6573 2061 7265 2072 6573 6572 7665 6420 es are reserved │ │ │ │ │ +00013700: 6279 2074 6865 2047 4e55 2043 6f64 696e by the GNU Codin │ │ │ │ │ +00013710: 6720 5374 616e 6461 7264 7320 666f 720a g Standards for. │ │ │ │ │ +00013720: 7468 6520 7573 6520 6f66 2074 6865 2022 the use of the " │ │ │ │ │ +00013730: 7573 6572 222d 2d74 6865 2070 6572 736f user"--the perso │ │ │ │ │ +00013740: 6e20 6275 696c 6469 6e67 2074 6865 2070 n building the p │ │ │ │ │ +00013750: 6163 6b61 6765 2e20 2046 6f72 2069 6e73 ackage. For ins │ │ │ │ │ +00013760: 7461 6e63 652c 0a27 4346 4c41 4753 2720 tance,.'CFLAGS' │ │ │ │ │ +00013770: 6973 206f 6e65 2073 7563 6820 7661 7269 is one such vari │ │ │ │ │ +00013780: 6162 6c65 2e0a 0a20 2020 536f 6d65 7469 able... Someti │ │ │ │ │ +00013790: 6d65 7320 7061 636b 6167 6520 6465 7665 mes package deve │ │ │ │ │ +000137a0: 6c6f 7065 7273 2061 7265 2074 656d 7074 lopers are tempt │ │ │ │ │ +000137b0: 6564 2074 6f20 7365 7420 7573 6572 2076 ed to set user v │ │ │ │ │ +000137c0: 6172 6961 626c 6573 2073 7563 680a 6173 ariables such.as │ │ │ │ │ +000137d0: 2027 4346 4c41 4753 2720 6265 6361 7573 'CFLAGS' becaus │ │ │ │ │ +000137e0: 6520 6974 2061 7070 6561 7273 2074 6f20 e it appears to │ │ │ │ │ +000137f0: 6d61 6b65 2074 6865 6972 206a 6f62 2065 make their job e │ │ │ │ │ +00013800: 6173 6965 722e 2020 486f 7765 7665 722c asier. However, │ │ │ │ │ +00013810: 2074 6865 0a70 6163 6b61 6765 2069 7473 the.package its │ │ │ │ │ +00013820: 656c 6620 7368 6f75 6c64 206e 6576 6572 elf should never │ │ │ │ │ +00013830: 2073 6574 2061 2075 7365 7220 7661 7269 set a user vari │ │ │ │ │ +00013840: 6162 6c65 2c20 7061 7274 6963 756c 6172 able, particular │ │ │ │ │ +00013850: 6c79 206e 6f74 2074 6f0a 696e 636c 7564 ly not to.includ │ │ │ │ │ +00013860: 6520 7377 6974 6368 6573 2074 6861 7420 e switches that │ │ │ │ │ +00013870: 6172 6520 7265 7175 6972 6564 2066 6f72 are required for │ │ │ │ │ +00013880: 2070 726f 7065 7220 636f 6d70 696c 6174 proper compilat │ │ │ │ │ +00013890: 696f 6e20 6f66 2074 6865 0a70 6163 6b61 ion of the.packa │ │ │ │ │ +000138a0: 6765 2e20 2053 696e 6365 2074 6865 7365 ge. Since these │ │ │ │ │ +000138b0: 2076 6172 6961 626c 6573 2061 7265 2064 variables are d │ │ │ │ │ +000138c0: 6f63 756d 656e 7465 6420 6173 2062 6569 ocumented as bei │ │ │ │ │ +000138d0: 6e67 2066 6f72 2074 6865 2070 6163 6b61 ng for the packa │ │ │ │ │ +000138e0: 6765 0a62 7569 6c64 6572 2c20 7468 6174 ge.builder, that │ │ │ │ │ +000138f0: 2070 6572 736f 6e20 7269 6768 7466 756c person rightful │ │ │ │ │ +00013900: 6c79 2065 7870 6563 7473 2074 6f20 6265 ly expects to be │ │ │ │ │ +00013910: 2061 626c 6520 746f 206f 7665 7272 6964 able to overrid │ │ │ │ │ +00013920: 6520 616e 7920 6f66 0a74 6865 7365 2076 e any of.these v │ │ │ │ │ +00013930: 6172 6961 626c 6573 2061 7420 6275 696c ariables at buil │ │ │ │ │ +00013940: 6420 7469 6d65 2e0a 0a20 2020 546f 2067 d time... To g │ │ │ │ │ +00013950: 6574 2061 726f 756e 6420 7468 6973 2070 et around this p │ │ │ │ │ +00013960: 726f 626c 656d 2c20 4175 746f 6d61 6b65 roblem, Automake │ │ │ │ │ +00013970: 2069 6e74 726f 6475 6365 7320 616e 2061 introduces an a │ │ │ │ │ +00013980: 7574 6f6d 616b 652d 7370 6563 6966 6963 utomake-specific │ │ │ │ │ +00013990: 0a73 6861 646f 7720 7661 7269 6162 6c65 .shadow variable │ │ │ │ │ +000139a0: 2066 6f72 2065 6163 6820 7573 6572 2066 for each user f │ │ │ │ │ +000139b0: 6c61 6720 7661 7269 6162 6c65 2e20 2028 lag variable. ( │ │ │ │ │ +000139c0: 5368 6164 6f77 2076 6172 6961 626c 6573 Shadow variables │ │ │ │ │ +000139d0: 2061 7265 206e 6f74 0a69 6e74 726f 6475 are not.introdu │ │ │ │ │ +000139e0: 6365 6420 666f 7220 7661 7269 6162 6c65 ced for variable │ │ │ │ │ +000139f0: 7320 6c69 6b65 2027 4343 272c 2077 6865 s like 'CC', whe │ │ │ │ │ +00013a00: 7265 2074 6865 7920 776f 756c 6420 6d61 re they would ma │ │ │ │ │ +00013a10: 6b65 206e 6f20 7365 6e73 652e 290a 5468 ke no sense.).Th │ │ │ │ │ +00013a20: 6520 7368 6164 6f77 2076 6172 6961 626c e shadow variabl │ │ │ │ │ +00013a30: 6520 6973 206e 616d 6564 2062 7920 7072 e is named by pr │ │ │ │ │ +00013a40: 6570 656e 6469 6e67 2027 414d 5f27 2074 epending 'AM_' t │ │ │ │ │ +00013a50: 6f20 7468 6520 7573 6572 2076 6172 6961 o the user varia │ │ │ │ │ +00013a60: 626c 6527 730a 6e61 6d65 2e20 2046 6f72 ble's.name. For │ │ │ │ │ +00013a70: 2069 6e73 7461 6e63 652c 2074 6865 2073 instance, the s │ │ │ │ │ +00013a80: 6861 646f 7720 7661 7269 6162 6c65 2066 hadow variable f │ │ │ │ │ +00013a90: 6f72 2027 5946 4c41 4753 2720 6973 2027 or 'YFLAGS' is ' │ │ │ │ │ +00013aa0: 414d 5f59 464c 4147 5327 2e0a 5468 6520 AM_YFLAGS'..The │ │ │ │ │ +00013ab0: 7061 636b 6167 6520 6d61 696e 7461 696e package maintain │ │ │ │ │ +00013ac0: 6572 2d2d 7468 6174 2069 732c 2074 6865 er--that is, the │ │ │ │ │ +00013ad0: 2061 7574 686f 7228 7329 206f 6620 7468 author(s) of th │ │ │ │ │ +00013ae0: 6520 274d 616b 6566 696c 652e 616d 2720 e 'Makefile.am' │ │ │ │ │ +00013af0: 616e 640a 2763 6f6e 6669 6775 7265 2e61 and.'configure.a │ │ │ │ │ +00013b00: 6327 2066 696c 6573 2d2d 6d61 7920 6164 c' files--may ad │ │ │ │ │ +00013b10: 6a75 7374 2074 6865 7365 2073 6861 646f just these shado │ │ │ │ │ +00013b20: 7720 7661 7269 6162 6c65 7320 686f 7765 w variables howe │ │ │ │ │ +00013b30: 7665 720a 6e65 6365 7373 6172 792e 0a0a ver.necessary... │ │ │ │ │ +00013b40: 2020 202a 4e6f 7465 2046 6c61 6720 5661 *Note Flag Va │ │ │ │ │ +00013b50: 7269 6162 6c65 7320 4f72 6465 7269 6e67 riables Ordering │ │ │ │ │ +00013b60: 3a3a 2c20 666f 7220 6d6f 7265 2064 6973 ::, for more dis │ │ │ │ │ +00013b70: 6375 7373 696f 6e20 6162 6f75 7420 7468 cussion about th │ │ │ │ │ +00013b80: 6573 650a 7661 7269 6162 6c65 7320 616e ese.variables an │ │ │ │ │ +00013b90: 6420 686f 7720 7468 6579 2069 6e74 6572 d how they inter │ │ │ │ │ +00013ba0: 6163 7420 7769 7468 2070 6572 2d74 6172 act with per-tar │ │ │ │ │ +00013bb0: 6765 7420 7661 7269 6162 6c65 732e 0a0a get variables... │ │ │ │ │ +00013bc0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +00013bd0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +00013be0: 653a 2041 7578 696c 6961 7279 2050 726f e: Auxiliary Pro │ │ │ │ │ +00013bf0: 6772 616d 732c 2020 5072 6576 3a20 5573 grams, Prev: Us │ │ │ │ │ +00013c00: 6572 2056 6172 6961 626c 6573 2c20 2055 er Variables, U │ │ │ │ │ +00013c10: 703a 2047 656e 6572 616c 6974 6965 730a p: Generalities. │ │ │ │ │ +00013c20: 0a33 2e37 2050 726f 6772 616d 7320 6175 .3.7 Programs au │ │ │ │ │ +00013c30: 746f 6d61 6b65 206d 6967 6874 2072 6571 tomake might req │ │ │ │ │ +00013c40: 7569 7265 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d uire.=========== │ │ │ │ │ 00013c50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00013c60: 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 ======..Automake │ │ │ │ │ -00013c70: 2073 6f6d 6574 696d 6573 2072 6571 7569 sometimes requi │ │ │ │ │ -00013c80: 7265 7320 6865 6c70 6572 2070 726f 6772 res helper progr │ │ │ │ │ -00013c90: 616d 7320 736f 2074 6861 7420 7468 6520 ams so that the │ │ │ │ │ -00013ca0: 6765 6e65 7261 7465 640a 274d 616b 6566 generated.'Makef │ │ │ │ │ -00013cb0: 696c 6527 2063 616e 2064 6f20 6974 7320 ile' can do its │ │ │ │ │ -00013cc0: 776f 726b 2070 726f 7065 726c 792e 2020 work properly. │ │ │ │ │ -00013cd0: 5468 6572 6520 6172 6520 6120 6661 6972 There are a fair │ │ │ │ │ -00013ce0: 6c79 206c 6172 6765 206e 756d 6265 7220 ly large number │ │ │ │ │ -00013cf0: 6f66 0a74 6865 6d2c 2061 6e64 2077 6520 of.them, and we │ │ │ │ │ -00013d00: 6c69 7374 2074 6865 6d20 6865 7265 2e0a list them here.. │ │ │ │ │ -00013d10: 0a20 2020 416c 7468 6f75 6768 2061 6c6c . Although all │ │ │ │ │ -00013d20: 206f 6620 7468 6573 6520 6669 6c65 7320 of these files │ │ │ │ │ -00013d30: 6172 6520 6469 7374 7269 6275 7465 6420 are distributed │ │ │ │ │ -00013d40: 616e 6420 696e 7374 616c 6c65 6420 7769 and installed wi │ │ │ │ │ -00013d50: 7468 0a41 7574 6f6d 616b 652c 2061 2063 th.Automake, a c │ │ │ │ │ -00013d60: 6f75 706c 6520 6f66 2074 6865 6d20 6172 ouple of them ar │ │ │ │ │ -00013d70: 6520 6d61 696e 7461 696e 6564 2073 6570 e maintained sep │ │ │ │ │ -00013d80: 6172 6174 656c 792e 2020 5468 6520 4175 arately. The Au │ │ │ │ │ -00013d90: 746f 6d61 6b65 0a63 6f70 6965 7320 6172 tomake.copies ar │ │ │ │ │ -00013da0: 6520 7570 6461 7465 6420 6265 666f 7265 e updated before │ │ │ │ │ -00013db0: 2065 6163 6820 7265 6c65 6173 652c 2062 each release, b │ │ │ │ │ -00013dc0: 7574 2077 6520 6d65 6e74 696f 6e20 7468 ut we mention th │ │ │ │ │ -00013dd0: 6520 6f72 6967 696e 616c 0a73 6f75 7263 e original.sourc │ │ │ │ │ -00013de0: 6520 696e 2063 6173 6520 796f 7520 6e65 e in case you ne │ │ │ │ │ -00013df0: 6564 206d 6f72 6520 7265 6365 6e74 2076 ed more recent v │ │ │ │ │ -00013e00: 6572 7369 6f6e 732e 0a0a 2761 722d 6c69 ersions...'ar-li │ │ │ │ │ -00013e10: 6227 0a20 2020 2020 5468 6973 2069 7320 b'. This is │ │ │ │ │ -00013e20: 6120 7772 6170 7065 7220 7072 696d 6172 a wrapper primar │ │ │ │ │ -00013e30: 696c 7920 666f 7220 7468 6520 4d69 6372 ily for the Micr │ │ │ │ │ -00013e40: 6f73 6f66 7420 6c69 6220 6172 6368 6976 osoft lib archiv │ │ │ │ │ -00013e50: 6572 2c20 746f 206d 616b 650a 2020 2020 er, to make. │ │ │ │ │ -00013e60: 2069 7420 6d6f 7265 2050 4f53 4958 2d6c it more POSIX-l │ │ │ │ │ -00013e70: 696b 652e 0a0a 2761 6e73 6932 6b6e 722e ike...'ansi2knr. │ │ │ │ │ -00013e80: 6327 0a27 616e 7369 326b 6e72 2e31 270a c'.'ansi2knr.1'. │ │ │ │ │ -00013e90: 2020 2020 2054 6865 7365 2074 776f 2066 These two f │ │ │ │ │ -00013ea0: 696c 6573 2061 7265 2075 7365 6420 666f iles are used fo │ │ │ │ │ -00013eb0: 7220 6465 2d41 4e53 492d 6669 6361 7469 r de-ANSI-ficati │ │ │ │ │ -00013ec0: 6f6e 2073 7570 706f 7274 2028 7468 6579 on support (they │ │ │ │ │ -00013ed0: 2061 7265 0a20 2020 2020 6465 7072 6563 are. deprec │ │ │ │ │ -00013ee0: 6174 6564 206e 6f77 2c20 616e 6420 5f77 ated now, and _w │ │ │ │ │ -00013ef0: 696c 6c20 6265 2072 656d 6f76 6564 5f20 ill be removed_ │ │ │ │ │ -00013f00: 696e 2074 6865 206e 6578 7420 6d61 6a6f in the next majo │ │ │ │ │ -00013f10: 7220 4175 746f 6d61 6b65 0a20 2020 2020 r Automake. │ │ │ │ │ -00013f20: 7265 6c65 6173 653b 202a 6e6f 7465 2041 release; *note A │ │ │ │ │ -00013f30: 4e53 493a 3a29 2e0a 0a27 636f 6d70 696c NSI::)...'compil │ │ │ │ │ -00013f40: 6527 0a20 2020 2020 5468 6973 2069 7320 e'. This is │ │ │ │ │ -00013f50: 6120 7772 6170 7065 7220 666f 7220 636f a wrapper for co │ │ │ │ │ -00013f60: 6d70 696c 6572 7320 7468 6174 2064 6f20 mpilers that do │ │ │ │ │ -00013f70: 6e6f 7420 6163 6365 7074 206f 7074 696f not accept optio │ │ │ │ │ -00013f80: 6e73 2027 2d63 2720 616e 640a 2020 2020 ns '-c' and. │ │ │ │ │ -00013f90: 2027 2d6f 2720 6174 2074 6865 2073 616d '-o' at the sam │ │ │ │ │ -00013fa0: 6520 7469 6d65 2e20 2049 7420 6973 206f e time. It is o │ │ │ │ │ -00013fb0: 6e6c 7920 7573 6564 2077 6865 6e20 6162 nly used when ab │ │ │ │ │ -00013fc0: 736f 6c75 7465 6c79 2072 6571 7569 7265 solutely require │ │ │ │ │ -00013fd0: 642e 0a20 2020 2020 5375 6368 2063 6f6d d.. Such com │ │ │ │ │ -00013fe0: 7069 6c65 7273 2061 7265 2072 6172 652c pilers are rare, │ │ │ │ │ -00013ff0: 2077 6974 6820 7468 6520 4d69 6372 6f73 with the Micros │ │ │ │ │ -00014000: 6f66 7420 432f 432b 2b20 436f 6d70 696c oft C/C++ Compil │ │ │ │ │ -00014010: 6572 2061 7320 7468 650a 2020 2020 206d er as the. m │ │ │ │ │ -00014020: 6f73 7420 6e6f 7461 626c 6520 6578 6365 ost notable exce │ │ │ │ │ -00014030: 7074 696f 6e2e 2020 5468 6973 2077 7261 ption. This wra │ │ │ │ │ -00014040: 7070 6572 2061 6c73 6f20 6d61 6b65 7320 pper also makes │ │ │ │ │ -00014050: 7468 6520 666f 6c6c 6f77 696e 670a 2020 the following. │ │ │ │ │ -00014060: 2020 2063 6f6d 6d6f 6e20 6f70 7469 6f6e common option │ │ │ │ │ -00014070: 7320 6176 6169 6c61 626c 6520 666f 7220 s available for │ │ │ │ │ -00014080: 7468 6174 2063 6f6d 7069 6c65 722c 2077 that compiler, w │ │ │ │ │ -00014090: 6869 6c65 2070 6572 666f 726d 696e 6720 hile performing │ │ │ │ │ -000140a0: 6669 6c65 0a20 2020 2020 6e61 6d65 2074 file. name t │ │ │ │ │ -000140b0: 7261 6e73 6c61 7469 6f6e 2077 6865 7265 ranslation where │ │ │ │ │ -000140c0: 206e 6565 6465 643a 2027 2d49 272c 2027 needed: '-I', ' │ │ │ │ │ -000140d0: 2d4c 272c 2027 2d6c 272c 2027 2d57 6c2c -L', '-l', '-Wl, │ │ │ │ │ -000140e0: 2720 616e 640a 2020 2020 2027 2d58 6c69 ' and. '-Xli │ │ │ │ │ -000140f0: 6e6b 6572 272e 0a0a 2763 6f6e 6669 672e nker'...'config. │ │ │ │ │ -00014100: 6775 6573 7327 0a27 636f 6e66 6967 2e73 guess'.'config.s │ │ │ │ │ -00014110: 7562 270a 2020 2020 2054 6865 7365 2074 ub'. These t │ │ │ │ │ -00014120: 776f 2070 726f 6772 616d 7320 636f 6d70 wo programs comp │ │ │ │ │ -00014130: 7574 6520 7468 6520 6361 6e6f 6e69 6361 ute the canonica │ │ │ │ │ -00014140: 6c20 7472 6970 6c65 7473 2066 6f72 2074 l triplets for t │ │ │ │ │ -00014150: 6865 2067 6976 656e 0a20 2020 2020 6275 he given. bu │ │ │ │ │ -00014160: 696c 642c 2068 6f73 742c 206f 7220 7461 ild, host, or ta │ │ │ │ │ -00014170: 7267 6574 2061 7263 6869 7465 6374 7572 rget architectur │ │ │ │ │ -00014180: 652e 2020 5468 6573 6520 7072 6f67 7261 e. These progra │ │ │ │ │ -00014190: 6d73 2061 7265 2075 7064 6174 6564 0a20 ms are updated. │ │ │ │ │ -000141a0: 2020 2020 7265 6775 6c61 726c 7920 746f regularly to │ │ │ │ │ -000141b0: 2073 7570 706f 7274 206e 6577 2061 7263 support new arc │ │ │ │ │ -000141c0: 6869 7465 6374 7572 6573 2061 6e64 2066 hitectures and f │ │ │ │ │ -000141d0: 6978 2070 726f 6265 7320 6272 6f6b 656e ix probes broken │ │ │ │ │ -000141e0: 2062 790a 2020 2020 2063 6861 6e67 6573 by. changes │ │ │ │ │ -000141f0: 2069 6e20 6e65 7720 6b65 726e 656c 2076 in new kernel v │ │ │ │ │ -00014200: 6572 7369 6f6e 732e 2020 4561 6368 206e ersions. Each n │ │ │ │ │ -00014210: 6577 2072 656c 6561 7365 206f 6620 4175 ew release of Au │ │ │ │ │ -00014220: 746f 6d61 6b65 2063 6f6d 6573 0a20 2020 tomake comes. │ │ │ │ │ -00014230: 2020 7769 7468 2075 702d 746f 2d64 6174 with up-to-dat │ │ │ │ │ -00014240: 6520 636f 7069 6573 206f 6620 7468 6573 e copies of thes │ │ │ │ │ -00014250: 6520 7072 6f67 7261 6d73 2e20 2049 6620 e programs. If │ │ │ │ │ -00014260: 796f 7572 2063 6f70 7920 6f66 2041 7574 your copy of Aut │ │ │ │ │ -00014270: 6f6d 616b 650a 2020 2020 2069 7320 6765 omake. is ge │ │ │ │ │ -00014280: 7474 696e 6720 6f6c 642c 2079 6f75 2061 tting old, you a │ │ │ │ │ -00014290: 7265 2065 6e63 6f75 7261 6765 6420 746f re encouraged to │ │ │ │ │ -000142a0: 2066 6574 6368 2074 6865 206c 6174 6573 fetch the lates │ │ │ │ │ -000142b0: 7420 7665 7273 696f 6e73 206f 660a 2020 t versions of. │ │ │ │ │ -000142c0: 2020 2074 6865 7365 2066 696c 6573 2066 these files f │ │ │ │ │ -000142d0: 726f 6d20 3c68 7474 703a 2f2f 7361 7661 rom │ │ │ │ │ -00014300: 6265 666f 7265 0a20 2020 2020 6d61 6b69 before. maki │ │ │ │ │ -00014310: 6e67 2061 2072 656c 6561 7365 2e0a 0a27 ng a release...' │ │ │ │ │ -00014320: 636f 6e66 6967 2d6d 6c2e 696e 270a 2020 config-ml.in'. │ │ │ │ │ -00014330: 2020 2054 6869 7320 6669 6c65 2069 7320 This file is │ │ │ │ │ -00014340: 6e6f 7420 6120 7072 6f67 7261 6d2c 2069 not a program, i │ │ │ │ │ -00014350: 7420 6973 2061 2027 636f 6e66 6967 7572 t is a 'configur │ │ │ │ │ -00014360: 6527 2066 7261 676d 656e 7420 7573 6564 e' fragment used │ │ │ │ │ -00014370: 2066 6f72 0a20 2020 2020 6d75 6c74 696c for. multil │ │ │ │ │ -00014380: 6962 2073 7570 706f 7274 2028 2a6e 6f74 ib support (*not │ │ │ │ │ -00014390: 6520 4d75 6c74 696c 6962 733a 3a29 2e20 e Multilibs::). │ │ │ │ │ -000143a0: 2053 696e 6365 2074 6865 2041 7574 6f6d Since the Autom │ │ │ │ │ -000143b0: 616b 6520 6d75 6c74 696c 6962 0a20 2020 ake multilib. │ │ │ │ │ -000143c0: 2020 7375 7070 6f72 7420 6861 7320 6265 support has be │ │ │ │ │ -000143d0: 656e 205f 6465 7072 6563 6174 6564 5f20 en _deprecated_ │ │ │ │ │ -000143e0: 616e 6420 7461 7267 6574 6564 2066 6f72 and targeted for │ │ │ │ │ -000143f0: 2072 656d 6f76 616c 2c20 7468 6973 2066 removal, this f │ │ │ │ │ -00014400: 696c 650a 2020 2020 2069 7320 676f 696e ile. is goin │ │ │ │ │ -00014410: 6720 746f 2062 6520 5f72 656d 6f76 6564 g to be _removed │ │ │ │ │ -00014420: 2066 726f 6d20 7468 6520 4175 746f 6d61 from the Automa │ │ │ │ │ -00014430: 6b65 2063 6f72 655f 2069 6e20 7468 6520 ke core_ in the │ │ │ │ │ -00014440: 6e65 7874 206d 616a 6f72 0a20 2020 2020 next major. │ │ │ │ │ -00014450: 7265 6c65 6173 652e 2020 5468 6520 6d61 release. The ma │ │ │ │ │ -00014460: 7374 6572 2063 6f70 7920 6f66 2074 6869 ster copy of thi │ │ │ │ │ -00014470: 7320 6669 6c65 2069 7320 6d61 696e 7461 s file is mainta │ │ │ │ │ -00014480: 696e 6564 2069 6e20 7468 6520 4743 430a ined in the GCC. │ │ │ │ │ -00014490: 2020 2020 2074 7265 6520 6174 203c 6874 tree at ...'de │ │ │ │ │ -000144c0: 7063 6f6d 7027 0a20 2020 2020 5468 6973 pcomp'. This │ │ │ │ │ -000144d0: 2070 726f 6772 616d 2075 6e64 6572 7374 program underst │ │ │ │ │ -000144e0: 616e 6473 2068 6f77 2074 6f20 7275 6e20 ands how to run │ │ │ │ │ -000144f0: 6120 636f 6d70 696c 6572 2073 6f20 7468 a compiler so th │ │ │ │ │ -00014500: 6174 2069 7420 7769 6c6c 0a20 2020 2020 at it will. │ │ │ │ │ -00014510: 6765 6e65 7261 7465 206e 6f74 206f 6e6c generate not onl │ │ │ │ │ -00014520: 7920 7468 6520 6465 7369 7265 6420 6f75 y the desired ou │ │ │ │ │ -00014530: 7470 7574 2062 7574 2061 6c73 6f20 6465 tput but also de │ │ │ │ │ -00014540: 7065 6e64 656e 6379 0a20 2020 2020 696e pendency. in │ │ │ │ │ -00014550: 666f 726d 6174 696f 6e20 7468 6174 2069 formation that i │ │ │ │ │ -00014560: 7320 7468 656e 2075 7365 6420 6279 2074 s then used by t │ │ │ │ │ -00014570: 6865 2061 7574 6f6d 6174 6963 2064 6570 he automatic dep │ │ │ │ │ -00014580: 656e 6465 6e63 7920 7472 6163 6b69 6e67 endency tracking │ │ │ │ │ -00014590: 0a20 2020 2020 6665 6174 7572 6520 282a . feature (* │ │ │ │ │ -000145a0: 6e6f 7465 2044 6570 656e 6465 6e63 6965 note Dependencie │ │ │ │ │ -000145b0: 733a 3a29 2e0a 0a27 656c 6973 702d 636f s::)...'elisp-co │ │ │ │ │ -000145c0: 6d70 270a 2020 2020 2054 6869 7320 7072 mp'. This pr │ │ │ │ │ -000145d0: 6f67 7261 6d20 6973 2075 7365 6420 746f ogram is used to │ │ │ │ │ -000145e0: 2062 7974 652d 636f 6d70 696c 6520 456d byte-compile Em │ │ │ │ │ -000145f0: 6163 7320 4c69 7370 2063 6f64 652e 0a0a acs Lisp code... │ │ │ │ │ -00014600: 2769 6e73 7461 6c6c 2d73 6827 0a20 2020 'install-sh'. │ │ │ │ │ -00014610: 2020 5468 6973 2069 7320 6120 7265 706c This is a repl │ │ │ │ │ -00014620: 6163 656d 656e 7420 666f 7220 7468 6520 acement for the │ │ │ │ │ -00014630: 2769 6e73 7461 6c6c 2720 7072 6f67 7261 'install' progra │ │ │ │ │ -00014640: 6d20 7468 6174 2077 6f72 6b73 206f 6e0a m that works on. │ │ │ │ │ -00014650: 2020 2020 2070 6c61 7466 6f72 6d73 2077 platforms w │ │ │ │ │ -00014660: 6865 7265 2027 696e 7374 616c 6c27 2069 here 'install' i │ │ │ │ │ -00014670: 7320 756e 6176 6169 6c61 626c 6520 6f72 s unavailable or │ │ │ │ │ -00014680: 2075 6e75 7361 626c 652e 0a0a 276d 6461 unusable...'mda │ │ │ │ │ -00014690: 7465 2d73 6827 0a20 2020 2020 5468 6973 te-sh'. This │ │ │ │ │ -000146a0: 2073 6372 6970 7420 6973 2075 7365 6420 script is used │ │ │ │ │ -000146b0: 746f 2067 656e 6572 6174 6520 6120 2776 to generate a 'v │ │ │ │ │ -000146c0: 6572 7369 6f6e 2e74 6578 6927 2066 696c ersion.texi' fil │ │ │ │ │ -000146d0: 652e 2020 4974 2065 7861 6d69 6e65 730a e. It examines. │ │ │ │ │ -000146e0: 2020 2020 2061 2066 696c 6520 616e 6420 a file and │ │ │ │ │ -000146f0: 7072 696e 7473 2073 6f6d 6520 6461 7465 prints some date │ │ │ │ │ -00014700: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f information abo │ │ │ │ │ -00014710: 7574 2069 742e 0a0a 276d 6973 7369 6e67 ut it...'missing │ │ │ │ │ -00014720: 270a 2020 2020 2054 6869 7320 7772 6170 '. This wrap │ │ │ │ │ -00014730: 7320 6120 6e75 6d62 6572 206f 6620 7072 s a number of pr │ │ │ │ │ -00014740: 6f67 7261 6d73 2074 6861 7420 6172 6520 ograms that are │ │ │ │ │ -00014750: 7479 7069 6361 6c6c 7920 6f6e 6c79 2072 typically only r │ │ │ │ │ -00014760: 6571 7569 7265 6420 6279 0a20 2020 2020 equired by. │ │ │ │ │ -00014770: 6d61 696e 7461 696e 6572 732e 2020 4966 maintainers. If │ │ │ │ │ -00014780: 2074 6865 2070 726f 6772 616d 2069 6e20 the program in │ │ │ │ │ -00014790: 7175 6573 7469 6f6e 2064 6f65 736e 2774 question doesn't │ │ │ │ │ -000147a0: 2065 7869 7374 2c20 276d 6973 7369 6e67 exist, 'missing │ │ │ │ │ -000147b0: 270a 2020 2020 2070 7269 6e74 7320 616e '. prints an │ │ │ │ │ -000147c0: 2069 6e66 6f72 6d61 7469 7665 2077 6172 informative war │ │ │ │ │ -000147d0: 6e69 6e67 2061 6e64 2061 7474 656d 7074 ning and attempt │ │ │ │ │ -000147e0: 7320 746f 2066 6978 2074 6869 6e67 7320 s to fix things │ │ │ │ │ -000147f0: 736f 2074 6861 740a 2020 2020 2074 6865 so that. the │ │ │ │ │ -00014800: 2062 7569 6c64 2063 616e 2063 6f6e 7469 build can conti │ │ │ │ │ -00014810: 6e75 652e 0a0a 276d 6b69 6e73 7461 6c6c nue...'mkinstall │ │ │ │ │ -00014820: 6469 7273 270a 2020 2020 2054 6869 7320 dirs'. This │ │ │ │ │ -00014830: 7363 7269 7074 2075 7365 6420 746f 2062 script used to b │ │ │ │ │ -00014840: 6520 6120 7772 6170 7065 7220 6172 6f75 e a wrapper arou │ │ │ │ │ -00014850: 6e64 2027 6d6b 6469 7220 2d70 272c 2077 nd 'mkdir -p', w │ │ │ │ │ -00014860: 6869 6368 2069 7320 6e6f 740a 2020 2020 hich is not. │ │ │ │ │ -00014870: 2070 6f72 7461 626c 652e 2020 4e6f 7720 portable. Now │ │ │ │ │ -00014880: 7765 2070 7265 6665 7220 746f 2075 7365 we prefer to use │ │ │ │ │ -00014890: 2027 696e 7374 616c 6c2d 7368 202d 6427 'install-sh -d' │ │ │ │ │ -000148a0: 2077 6865 6e20 2763 6f6e 6669 6775 7265 when 'configure │ │ │ │ │ -000148b0: 270a 2020 2020 2066 696e 6473 2074 6861 '. finds tha │ │ │ │ │ -000148c0: 7420 276d 6b64 6972 202d 7027 2064 6f65 t 'mkdir -p' doe │ │ │ │ │ -000148d0: 7320 6e6f 7420 776f 726b 2c20 7468 6973 s not work, this │ │ │ │ │ -000148e0: 206d 616b 6573 206f 6e65 206c 6573 7320 makes one less │ │ │ │ │ -000148f0: 7363 7269 7074 2074 6f0a 2020 2020 2064 script to. d │ │ │ │ │ -00014900: 6973 7472 6962 7574 652e 0a0a 2020 2020 istribute... │ │ │ │ │ -00014910: 2046 6f72 2062 6163 6b77 6172 6420 636f For backward co │ │ │ │ │ -00014920: 6d70 6174 6962 696c 6974 7920 276d 6b69 mpatibility 'mki │ │ │ │ │ -00014930: 6e73 7461 6c6c 6469 7273 2720 6973 2073 nstalldirs' is s │ │ │ │ │ -00014940: 7469 6c6c 2075 7365 6420 616e 640a 2020 till used and. │ │ │ │ │ -00014950: 2020 2064 6973 7472 6962 7574 6564 2077 distributed w │ │ │ │ │ -00014960: 6865 6e20 2761 7574 6f6d 616b 6527 2066 hen 'automake' f │ │ │ │ │ -00014970: 696e 6473 2069 7420 696e 2061 2070 6163 inds it in a pac │ │ │ │ │ -00014980: 6b61 6765 2e20 2042 7574 2069 7420 6973 kage. But it is │ │ │ │ │ -00014990: 206e 6f0a 2020 2020 206c 6f6e 6765 7220 no. longer │ │ │ │ │ -000149a0: 696e 7374 616c 6c65 6420 6175 746f 6d61 installed automa │ │ │ │ │ -000149b0: 7469 6361 6c6c 792c 2061 6e64 2069 7420 tically, and it │ │ │ │ │ -000149c0: 7368 6f75 6c64 2062 6520 7361 6665 2074 should be safe t │ │ │ │ │ -000149d0: 6f20 7265 6d6f 7665 2069 742e 0a0a 2770 o remove it...'p │ │ │ │ │ -000149e0: 792d 636f 6d70 696c 6527 0a20 2020 2020 y-compile'. │ │ │ │ │ -000149f0: 5468 6973 2069 7320 7573 6564 2074 6f20 This is used to │ │ │ │ │ -00014a00: 6279 7465 2d63 6f6d 7069 6c65 2050 7974 byte-compile Pyt │ │ │ │ │ -00014a10: 686f 6e20 7363 7269 7074 732e 0a0a 2773 hon scripts...'s │ │ │ │ │ -00014a20: 796d 6c69 6e6b 2d74 7265 6527 0a20 2020 ymlink-tree'. │ │ │ │ │ -00014a30: 2020 5468 6973 2070 726f 6772 616d 2064 This program d │ │ │ │ │ -00014a40: 7570 6c69 6361 7465 7320 6120 7472 6565 uplicates a tree │ │ │ │ │ -00014a50: 206f 6620 6469 7265 6374 6f72 6965 732c of directories, │ │ │ │ │ -00014a60: 2075 7369 6e67 2073 796d 626f 6c69 6320 using symbolic │ │ │ │ │ -00014a70: 6c69 6e6b 730a 2020 2020 2069 6e73 7465 links. inste │ │ │ │ │ -00014a80: 6164 206f 6620 636f 7079 696e 6720 6669 ad of copying fi │ │ │ │ │ -00014a90: 6c65 732e 2020 5375 6368 2061 6e20 6f70 les. Such an op │ │ │ │ │ -00014aa0: 6572 6174 696f 6e20 6973 2070 6572 666f eration is perfo │ │ │ │ │ -00014ab0: 726d 6564 2077 6865 6e0a 2020 2020 2062 rmed when. b │ │ │ │ │ -00014ac0: 7569 6c64 696e 6720 6d75 6c74 696c 6962 uilding multilib │ │ │ │ │ -00014ad0: 7320 282a 6e6f 7465 204d 756c 7469 6c69 s (*note Multili │ │ │ │ │ -00014ae0: 6273 3a3a 292e 2020 5369 6e63 6520 7468 bs::). Since th │ │ │ │ │ -00014af0: 6520 4175 746f 6d61 6b65 0a20 2020 2020 e Automake. │ │ │ │ │ -00014b00: 6d75 6c74 696c 6962 2073 7570 706f 7274 multilib support │ │ │ │ │ -00014b10: 2068 6173 2062 6565 6e20 5f64 6570 7265 has been _depre │ │ │ │ │ -00014b20: 6361 7465 645f 2061 6e64 2074 6172 6765 cated_ and targe │ │ │ │ │ -00014b30: 7465 6420 666f 7220 7265 6d6f 7661 6c2c ted for removal, │ │ │ │ │ -00014b40: 0a20 2020 2020 7468 6973 2066 696c 6520 . this file │ │ │ │ │ -00014b50: 6973 2067 6f69 6e67 2074 6f20 6265 205f is going to be _ │ │ │ │ │ -00014b60: 7265 6d6f 7665 6420 6672 6f6d 2074 6865 removed from the │ │ │ │ │ -00014b70: 2041 7574 6f6d 616b 6520 636f 7265 5f20 Automake core_ │ │ │ │ │ -00014b80: 696e 2074 6865 0a20 2020 2020 6e65 7874 in the. next │ │ │ │ │ -00014b90: 206d 616a 6f72 2072 656c 6561 7365 2e20 major release. │ │ │ │ │ -00014ba0: 2054 6865 206d 6173 7465 7220 636f 7079 The master copy │ │ │ │ │ -00014bb0: 206f 6620 7468 6973 2066 696c 6520 6973 of this file is │ │ │ │ │ -00014bc0: 206d 6169 6e74 6169 6e65 6420 696e 0a20 maintained in. │ │ │ │ │ -00014bd0: 2020 2020 7468 6520 4743 4320 7472 6565 the GCC tree │ │ │ │ │ -00014be0: 2061 7420 3c68 7474 703a 2f2f 6763 632e at ...'texinfo.tex │ │ │ │ │ -00014c10: 270a 2020 2020 204e 6f74 2061 2070 726f '. Not a pro │ │ │ │ │ -00014c20: 6772 616d 2c20 7468 6973 2066 696c 6520 gram, this file │ │ │ │ │ -00014c30: 6973 2072 6571 7569 7265 6420 666f 7220 is required for │ │ │ │ │ -00014c40: 276d 616b 6520 6476 6927 2c20 276d 616b 'make dvi', 'mak │ │ │ │ │ -00014c50: 6520 7073 2720 616e 640a 2020 2020 2027 e ps' and. ' │ │ │ │ │ -00014c60: 6d61 6b65 2070 6466 2720 746f 2077 6f72 make pdf' to wor │ │ │ │ │ -00014c70: 6b20 7768 656e 2054 6578 696e 666f 2073 k when Texinfo s │ │ │ │ │ -00014c80: 6f75 7263 6573 2061 7265 2069 6e20 7468 ources are in th │ │ │ │ │ -00014c90: 6520 7061 636b 6167 652e 2020 5468 650a e package. The. │ │ │ │ │ -00014ca0: 2020 2020 206c 6174 6573 7420 7665 7273 latest vers │ │ │ │ │ -00014cb0: 696f 6e20 6361 6e20 6265 2064 6f77 6e6c ion can be downl │ │ │ │ │ -00014cc0: 6f61 6465 6420 6672 6f6d 0a20 2020 2020 oaded from. │ │ │ │ │ -00014cd0: 3c68 7474 703a 2f2f 7777 772e 676e 752e ...'ylwrap │ │ │ │ │ -00014d00: 270a 2020 2020 2054 6869 7320 7072 6f67 '. This prog │ │ │ │ │ -00014d10: 7261 6d20 7772 6170 7320 276c 6578 2720 ram wraps 'lex' │ │ │ │ │ -00014d20: 616e 6420 2779 6163 6327 2074 6f20 7265 and 'yacc' to re │ │ │ │ │ -00014d30: 6e61 6d65 2074 6865 6972 206f 7574 7075 name their outpu │ │ │ │ │ -00014d40: 7420 6669 6c65 732e 0a20 2020 2020 4974 t files.. It │ │ │ │ │ -00014d50: 2061 6c73 6f20 656e 7375 7265 7320 7468 also ensures th │ │ │ │ │ -00014d60: 6174 2c20 666f 7220 696e 7374 616e 6365 at, for instance │ │ │ │ │ -00014d70: 2c20 6d75 6c74 6970 6c65 2027 7961 6363 , multiple 'yacc │ │ │ │ │ -00014d80: 2720 696e 7374 616e 6365 7320 6361 6e0a ' instances can. │ │ │ │ │ -00014d90: 2020 2020 2062 6520 696e 766f 6b65 6420 be invoked │ │ │ │ │ -00014da0: 696e 2061 2073 696e 676c 6520 6469 7265 in a single dire │ │ │ │ │ -00014db0: 6374 6f72 7920 696e 2070 6172 616c 6c65 ctory in paralle │ │ │ │ │ -00014dc0: 6c2e 0a0a 1f0a 4669 6c65 3a20 6175 746f l.....File: auto │ │ │ │ │ -00014dd0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00014de0: 204e 6f64 653a 2045 7861 6d70 6c65 732c Node: Examples, │ │ │ │ │ -00014df0: 2020 4e65 7874 3a20 6175 746f 6d61 6b65 Next: automake │ │ │ │ │ -00014e00: 2049 6e76 6f63 6174 696f 6e2c 2020 5072 Invocation, Pr │ │ │ │ │ -00014e10: 6576 3a20 4765 6e65 7261 6c69 7469 6573 ev: Generalities │ │ │ │ │ -00014e20: 2c20 2055 703a 2054 6f70 0a0a 3420 536f , Up: Top..4 So │ │ │ │ │ -00014e30: 6d65 2065 7861 6d70 6c65 2070 6163 6b61 me example packa │ │ │ │ │ -00014e40: 6765 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ges.************ │ │ │ │ │ -00014e50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6869 ***********..Thi │ │ │ │ │ -00014e60: 7320 7365 6374 696f 6e20 636f 6e74 6169 s section contai │ │ │ │ │ -00014e70: 6e73 2074 776f 2073 6d61 6c6c 2065 7861 ns two small exa │ │ │ │ │ -00014e80: 6d70 6c65 732e 0a0a 2020 2054 6865 2066 mples... The f │ │ │ │ │ -00014e90: 6972 7374 2065 7861 6d70 6c65 2028 2a6e irst example (*n │ │ │ │ │ -00014ea0: 6f74 6520 436f 6d70 6c65 7465 3a3a 2920 ote Complete::) │ │ │ │ │ -00014eb0: 6173 7375 6d65 7320 796f 7520 6861 7665 assumes you have │ │ │ │ │ -00014ec0: 2061 6e20 6578 6973 7469 6e67 0a70 726f an existing.pro │ │ │ │ │ -00014ed0: 6a65 6374 2061 6c72 6561 6479 2075 7369 ject already usi │ │ │ │ │ -00014ee0: 6e67 2041 7574 6f63 6f6e 662c 2077 6974 ng Autoconf, wit │ │ │ │ │ -00014ef0: 6820 6861 6e64 6372 6166 7465 6420 274d h handcrafted 'M │ │ │ │ │ -00014f00: 616b 6566 696c 6527 732c 2061 6e64 2074 akefile's, and t │ │ │ │ │ -00014f10: 6861 740a 796f 7520 7761 6e74 2074 6f20 hat.you want to │ │ │ │ │ -00014f20: 636f 6e76 6572 7420 6974 2074 6f20 7573 convert it to us │ │ │ │ │ -00014f30: 696e 6720 4175 746f 6d61 6b65 2e20 2049 ing Automake. I │ │ │ │ │ -00014f40: 6620 796f 7520 6172 6520 6469 7363 6f76 f you are discov │ │ │ │ │ -00014f50: 6572 696e 6720 626f 7468 0a74 6f6f 6c73 ering both.tools │ │ │ │ │ -00014f60: 2c20 6974 2069 7320 7072 6f62 6162 6c79 , it is probably │ │ │ │ │ -00014f70: 2062 6574 7465 7220 7468 6174 2079 6f75 better that you │ │ │ │ │ -00014f80: 206c 6f6f 6b20 6174 2074 6865 2048 656c look at the Hel │ │ │ │ │ -00014f90: 6c6f 2057 6f72 6c64 2065 7861 6d70 6c65 lo World example │ │ │ │ │ -00014fa0: 0a70 7265 7365 6e74 6564 2065 6172 6c69 .presented earli │ │ │ │ │ -00014fb0: 6572 2028 2a6e 6f74 6520 4865 6c6c 6f20 er (*note Hello │ │ │ │ │ -00014fc0: 576f 726c 643a 3a29 2e0a 0a20 2020 5468 World::)... Th │ │ │ │ │ -00014fd0: 6520 7365 636f 6e64 2065 7861 6d70 6c65 e second example │ │ │ │ │ -00014fe0: 2028 2a6e 6f74 6520 7472 7565 3a3a 2920 (*note true::) │ │ │ │ │ -00014ff0: 7368 6f77 7320 686f 7720 7477 6f20 7072 shows how two pr │ │ │ │ │ -00015000: 6f67 7261 6d73 2063 616e 2062 6520 6275 ograms can be bu │ │ │ │ │ -00015010: 696c 740a 6672 6f6d 2074 6865 2073 616d ilt.from the sam │ │ │ │ │ -00015020: 6520 6669 6c65 2c20 7573 696e 6720 6469 e file, using di │ │ │ │ │ -00015030: 6666 6572 656e 7420 636f 6d70 696c 6174 fferent compilat │ │ │ │ │ -00015040: 696f 6e20 7061 7261 6d65 7465 7273 2e20 ion parameters. │ │ │ │ │ -00015050: 2049 7420 636f 6e74 6169 6e73 0a73 6f6d It contains.som │ │ │ │ │ -00015060: 6520 7465 6368 6e69 6361 6c20 6469 6772 e technical digr │ │ │ │ │ -00015070: 6573 7369 6f6e 7320 7468 6174 2061 7265 essions that are │ │ │ │ │ -00015080: 2070 726f 6261 626c 7920 6265 7374 2073 probably best s │ │ │ │ │ -00015090: 6b69 7070 6564 206f 6e20 6669 7273 7420 kipped on first │ │ │ │ │ -000150a0: 7265 6164 2e0a 0a2a 204d 656e 753a 0a0a read...* Menu:.. │ │ │ │ │ -000150b0: 2a20 436f 6d70 6c65 7465 3a3a 2020 2020 * Complete:: │ │ │ │ │ +00013c60: 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 ========..Automa │ │ │ │ │ +00013c70: 6b65 2073 6f6d 6574 696d 6573 2072 6571 ke sometimes req │ │ │ │ │ +00013c80: 7569 7265 7320 6865 6c70 6572 2070 726f uires helper pro │ │ │ │ │ +00013c90: 6772 616d 7320 736f 2074 6861 7420 7468 grams so that th │ │ │ │ │ +00013ca0: 6520 6765 6e65 7261 7465 640a 274d 616b e generated.'Mak │ │ │ │ │ +00013cb0: 6566 696c 6527 2063 616e 2064 6f20 6974 efile' can do it │ │ │ │ │ +00013cc0: 7320 776f 726b 2070 726f 7065 726c 792e s work properly. │ │ │ │ │ +00013cd0: 2020 5468 6572 6520 6172 6520 6120 6661 There are a fa │ │ │ │ │ +00013ce0: 6972 6c79 206c 6172 6765 206e 756d 6265 irly large numbe │ │ │ │ │ +00013cf0: 7220 6f66 0a74 6865 6d2c 2061 6e64 2077 r of.them, and w │ │ │ │ │ +00013d00: 6520 6c69 7374 2074 6865 6d20 6865 7265 e list them here │ │ │ │ │ +00013d10: 2e0a 0a20 2020 416c 7468 6f75 6768 2061 ... Although a │ │ │ │ │ +00013d20: 6c6c 206f 6620 7468 6573 6520 6669 6c65 ll of these file │ │ │ │ │ +00013d30: 7320 6172 6520 6469 7374 7269 6275 7465 s are distribute │ │ │ │ │ +00013d40: 6420 616e 6420 696e 7374 616c 6c65 6420 d and installed │ │ │ │ │ +00013d50: 7769 7468 0a41 7574 6f6d 616b 652c 2061 with.Automake, a │ │ │ │ │ +00013d60: 2063 6f75 706c 6520 6f66 2074 6865 6d20 couple of them │ │ │ │ │ +00013d70: 6172 6520 6d61 696e 7461 696e 6564 2073 are maintained s │ │ │ │ │ +00013d80: 6570 6172 6174 656c 792e 2020 5468 6520 eparately. The │ │ │ │ │ +00013d90: 4175 746f 6d61 6b65 0a63 6f70 6965 7320 Automake.copies │ │ │ │ │ +00013da0: 6172 6520 7570 6461 7465 6420 6265 666f are updated befo │ │ │ │ │ +00013db0: 7265 2065 6163 6820 7265 6c65 6173 652c re each release, │ │ │ │ │ +00013dc0: 2062 7574 2077 6520 6d65 6e74 696f 6e20 but we mention │ │ │ │ │ +00013dd0: 7468 6520 6f72 6967 696e 616c 0a73 6f75 the original.sou │ │ │ │ │ +00013de0: 7263 6520 696e 2063 6173 6520 796f 7520 rce in case you │ │ │ │ │ +00013df0: 6e65 6564 206d 6f72 6520 7265 6365 6e74 need more recent │ │ │ │ │ +00013e00: 2076 6572 7369 6f6e 732e 0a0a 2761 722d versions...'ar- │ │ │ │ │ +00013e10: 6c69 6227 0a20 2020 2020 5468 6973 2069 lib'. This i │ │ │ │ │ +00013e20: 7320 6120 7772 6170 7065 7220 7072 696d s a wrapper prim │ │ │ │ │ +00013e30: 6172 696c 7920 666f 7220 7468 6520 4d69 arily for the Mi │ │ │ │ │ +00013e40: 6372 6f73 6f66 7420 6c69 6220 6172 6368 crosoft lib arch │ │ │ │ │ +00013e50: 6976 6572 2c20 746f 206d 616b 650a 2020 iver, to make. │ │ │ │ │ +00013e60: 2020 2069 7420 6d6f 7265 2050 4f53 4958 it more POSIX │ │ │ │ │ +00013e70: 2d6c 696b 652e 0a0a 2761 6e73 6932 6b6e -like...'ansi2kn │ │ │ │ │ +00013e80: 722e 6327 0a27 616e 7369 326b 6e72 2e31 r.c'.'ansi2knr.1 │ │ │ │ │ +00013e90: 270a 2020 2020 2054 6865 7365 2074 776f '. These two │ │ │ │ │ +00013ea0: 2066 696c 6573 2061 7265 2075 7365 6420 files are used │ │ │ │ │ +00013eb0: 666f 7220 6465 2d41 4e53 492d 6669 6361 for de-ANSI-fica │ │ │ │ │ +00013ec0: 7469 6f6e 2073 7570 706f 7274 2028 7468 tion support (th │ │ │ │ │ +00013ed0: 6579 2061 7265 0a20 2020 2020 6465 7072 ey are. depr │ │ │ │ │ +00013ee0: 6563 6174 6564 206e 6f77 2c20 616e 6420 ecated now, and │ │ │ │ │ +00013ef0: 5f77 696c 6c20 6265 2072 656d 6f76 6564 _will be removed │ │ │ │ │ +00013f00: 5f20 696e 2074 6865 206e 6578 7420 6d61 _ in the next ma │ │ │ │ │ +00013f10: 6a6f 7220 4175 746f 6d61 6b65 0a20 2020 jor Automake. │ │ │ │ │ +00013f20: 2020 7265 6c65 6173 653b 202a 6e6f 7465 release; *note │ │ │ │ │ +00013f30: 2041 4e53 493a 3a29 2e0a 0a27 636f 6d70 ANSI::)...'comp │ │ │ │ │ +00013f40: 696c 6527 0a20 2020 2020 5468 6973 2069 ile'. This i │ │ │ │ │ +00013f50: 7320 6120 7772 6170 7065 7220 666f 7220 s a wrapper for │ │ │ │ │ +00013f60: 636f 6d70 696c 6572 7320 7468 6174 2064 compilers that d │ │ │ │ │ +00013f70: 6f20 6e6f 7420 6163 6365 7074 206f 7074 o not accept opt │ │ │ │ │ +00013f80: 696f 6e73 2027 2d63 2720 616e 640a 2020 ions '-c' and. │ │ │ │ │ +00013f90: 2020 2027 2d6f 2720 6174 2074 6865 2073 '-o' at the s │ │ │ │ │ +00013fa0: 616d 6520 7469 6d65 2e20 2049 7420 6973 ame time. It is │ │ │ │ │ +00013fb0: 206f 6e6c 7920 7573 6564 2077 6865 6e20 only used when │ │ │ │ │ +00013fc0: 6162 736f 6c75 7465 6c79 2072 6571 7569 absolutely requi │ │ │ │ │ +00013fd0: 7265 642e 0a20 2020 2020 5375 6368 2063 red.. Such c │ │ │ │ │ +00013fe0: 6f6d 7069 6c65 7273 2061 7265 2072 6172 ompilers are rar │ │ │ │ │ +00013ff0: 652c 2077 6974 6820 7468 6520 4d69 6372 e, with the Micr │ │ │ │ │ +00014000: 6f73 6f66 7420 432f 432b 2b20 436f 6d70 osoft C/C++ Comp │ │ │ │ │ +00014010: 696c 6572 2061 7320 7468 650a 2020 2020 iler as the. │ │ │ │ │ +00014020: 206d 6f73 7420 6e6f 7461 626c 6520 6578 most notable ex │ │ │ │ │ +00014030: 6365 7074 696f 6e2e 2020 5468 6973 2077 ception. This w │ │ │ │ │ +00014040: 7261 7070 6572 2061 6c73 6f20 6d61 6b65 rapper also make │ │ │ │ │ +00014050: 7320 7468 6520 666f 6c6c 6f77 696e 670a s the following. │ │ │ │ │ +00014060: 2020 2020 2063 6f6d 6d6f 6e20 6f70 7469 common opti │ │ │ │ │ +00014070: 6f6e 7320 6176 6169 6c61 626c 6520 666f ons available fo │ │ │ │ │ +00014080: 7220 7468 6174 2063 6f6d 7069 6c65 722c r that compiler, │ │ │ │ │ +00014090: 2077 6869 6c65 2070 6572 666f 726d 696e while performin │ │ │ │ │ +000140a0: 6720 6669 6c65 0a20 2020 2020 6e61 6d65 g file. name │ │ │ │ │ +000140b0: 2074 7261 6e73 6c61 7469 6f6e 2077 6865 translation whe │ │ │ │ │ +000140c0: 7265 206e 6565 6465 643a 2027 2d49 272c re needed: '-I', │ │ │ │ │ +000140d0: 2027 2d4c 272c 2027 2d6c 272c 2027 2d57 '-L', '-l', '-W │ │ │ │ │ +000140e0: 6c2c 2720 616e 640a 2020 2020 2027 2d58 l,' and. '-X │ │ │ │ │ +000140f0: 6c69 6e6b 6572 272e 0a0a 2763 6f6e 6669 linker'...'confi │ │ │ │ │ +00014100: 672e 6775 6573 7327 0a27 636f 6e66 6967 g.guess'.'config │ │ │ │ │ +00014110: 2e73 7562 270a 2020 2020 2054 6865 7365 .sub'. These │ │ │ │ │ +00014120: 2074 776f 2070 726f 6772 616d 7320 636f two programs co │ │ │ │ │ +00014130: 6d70 7574 6520 7468 6520 6361 6e6f 6e69 mpute the canoni │ │ │ │ │ +00014140: 6361 6c20 7472 6970 6c65 7473 2066 6f72 cal triplets for │ │ │ │ │ +00014150: 2074 6865 2067 6976 656e 0a20 2020 2020 the given. │ │ │ │ │ +00014160: 6275 696c 642c 2068 6f73 742c 206f 7220 build, host, or │ │ │ │ │ +00014170: 7461 7267 6574 2061 7263 6869 7465 6374 target architect │ │ │ │ │ +00014180: 7572 652e 2020 5468 6573 6520 7072 6f67 ure. These prog │ │ │ │ │ +00014190: 7261 6d73 2061 7265 2075 7064 6174 6564 rams are updated │ │ │ │ │ +000141a0: 0a20 2020 2020 7265 6775 6c61 726c 7920 . regularly │ │ │ │ │ +000141b0: 746f 2073 7570 706f 7274 206e 6577 2061 to support new a │ │ │ │ │ +000141c0: 7263 6869 7465 6374 7572 6573 2061 6e64 rchitectures and │ │ │ │ │ +000141d0: 2066 6978 2070 726f 6265 7320 6272 6f6b fix probes brok │ │ │ │ │ +000141e0: 656e 2062 790a 2020 2020 2063 6861 6e67 en by. chang │ │ │ │ │ +000141f0: 6573 2069 6e20 6e65 7720 6b65 726e 656c es in new kernel │ │ │ │ │ +00014200: 2076 6572 7369 6f6e 732e 2020 4561 6368 versions. Each │ │ │ │ │ +00014210: 206e 6577 2072 656c 6561 7365 206f 6620 new release of │ │ │ │ │ +00014220: 4175 746f 6d61 6b65 2063 6f6d 6573 0a20 Automake comes. │ │ │ │ │ +00014230: 2020 2020 7769 7468 2075 702d 746f 2d64 with up-to-d │ │ │ │ │ +00014240: 6174 6520 636f 7069 6573 206f 6620 7468 ate copies of th │ │ │ │ │ +00014250: 6573 6520 7072 6f67 7261 6d73 2e20 2049 ese programs. I │ │ │ │ │ +00014260: 6620 796f 7572 2063 6f70 7920 6f66 2041 f your copy of A │ │ │ │ │ +00014270: 7574 6f6d 616b 650a 2020 2020 2069 7320 utomake. is │ │ │ │ │ +00014280: 6765 7474 696e 6720 6f6c 642c 2079 6f75 getting old, you │ │ │ │ │ +00014290: 2061 7265 2065 6e63 6f75 7261 6765 6420 are encouraged │ │ │ │ │ +000142a0: 746f 2066 6574 6368 2074 6865 206c 6174 to fetch the lat │ │ │ │ │ +000142b0: 6573 7420 7665 7273 696f 6e73 206f 660a est versions of. │ │ │ │ │ +000142c0: 2020 2020 2074 6865 7365 2066 696c 6573 these files │ │ │ │ │ +000142d0: 2066 726f 6d20 3c68 7474 703a 2f2f 7361 from before. ma │ │ │ │ │ +00014310: 6b69 6e67 2061 2072 656c 6561 7365 2e0a king a release.. │ │ │ │ │ +00014320: 0a27 636f 6e66 6967 2d6d 6c2e 696e 270a .'config-ml.in'. │ │ │ │ │ +00014330: 2020 2020 2054 6869 7320 6669 6c65 2069 This file i │ │ │ │ │ +00014340: 7320 6e6f 7420 6120 7072 6f67 7261 6d2c s not a program, │ │ │ │ │ +00014350: 2069 7420 6973 2061 2027 636f 6e66 6967 it is a 'config │ │ │ │ │ +00014360: 7572 6527 2066 7261 676d 656e 7420 7573 ure' fragment us │ │ │ │ │ +00014370: 6564 2066 6f72 0a20 2020 2020 6d75 6c74 ed for. mult │ │ │ │ │ +00014380: 696c 6962 2073 7570 706f 7274 2028 2a6e ilib support (*n │ │ │ │ │ +00014390: 6f74 6520 4d75 6c74 696c 6962 733a 3a29 ote Multilibs::) │ │ │ │ │ +000143a0: 2e20 2053 696e 6365 2074 6865 2041 7574 . Since the Aut │ │ │ │ │ +000143b0: 6f6d 616b 6520 6d75 6c74 696c 6962 0a20 omake multilib. │ │ │ │ │ +000143c0: 2020 2020 7375 7070 6f72 7420 6861 7320 support has │ │ │ │ │ +000143d0: 6265 656e 205f 6465 7072 6563 6174 6564 been _deprecated │ │ │ │ │ +000143e0: 5f20 616e 6420 7461 7267 6574 6564 2066 _ and targeted f │ │ │ │ │ +000143f0: 6f72 2072 656d 6f76 616c 2c20 7468 6973 or removal, this │ │ │ │ │ +00014400: 2066 696c 650a 2020 2020 2069 7320 676f file. is go │ │ │ │ │ +00014410: 696e 6720 746f 2062 6520 5f72 656d 6f76 ing to be _remov │ │ │ │ │ +00014420: 6564 2066 726f 6d20 7468 6520 4175 746f ed from the Auto │ │ │ │ │ +00014430: 6d61 6b65 2063 6f72 655f 2069 6e20 7468 make core_ in th │ │ │ │ │ +00014440: 6520 6e65 7874 206d 616a 6f72 0a20 2020 e next major. │ │ │ │ │ +00014450: 2020 7265 6c65 6173 652e 2020 5468 6520 release. The │ │ │ │ │ +00014460: 6d61 7374 6572 2063 6f70 7920 6f66 2074 master copy of t │ │ │ │ │ +00014470: 6869 7320 6669 6c65 2069 7320 6d61 696e his file is main │ │ │ │ │ +00014480: 7461 696e 6564 2069 6e20 7468 6520 4743 tained in the GC │ │ │ │ │ +00014490: 430a 2020 2020 2074 7265 6520 6174 203c C. tree at < │ │ │ │ │ +000144a0: 6874 7470 3a2f 2f67 6363 2e67 6e75 2e6f http://gcc.gnu.o │ │ │ │ │ +000144b0: 7267 2f73 766e 2e68 746d 6c3e 2e0a 0a27 rg/svn.html>...' │ │ │ │ │ +000144c0: 6465 7063 6f6d 7027 0a20 2020 2020 5468 depcomp'. Th │ │ │ │ │ +000144d0: 6973 2070 726f 6772 616d 2075 6e64 6572 is program under │ │ │ │ │ +000144e0: 7374 616e 6473 2068 6f77 2074 6f20 7275 stands how to ru │ │ │ │ │ +000144f0: 6e20 6120 636f 6d70 696c 6572 2073 6f20 n a compiler so │ │ │ │ │ +00014500: 7468 6174 2069 7420 7769 6c6c 0a20 2020 that it will. │ │ │ │ │ +00014510: 2020 6765 6e65 7261 7465 206e 6f74 206f generate not o │ │ │ │ │ +00014520: 6e6c 7920 7468 6520 6465 7369 7265 6420 nly the desired │ │ │ │ │ +00014530: 6f75 7470 7574 2062 7574 2061 6c73 6f20 output but also │ │ │ │ │ +00014540: 6465 7065 6e64 656e 6379 0a20 2020 2020 dependency. │ │ │ │ │ +00014550: 696e 666f 726d 6174 696f 6e20 7468 6174 information that │ │ │ │ │ +00014560: 2069 7320 7468 656e 2075 7365 6420 6279 is then used by │ │ │ │ │ +00014570: 2074 6865 2061 7574 6f6d 6174 6963 2064 the automatic d │ │ │ │ │ +00014580: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ +00014590: 6e67 0a20 2020 2020 6665 6174 7572 6520 ng. feature │ │ │ │ │ +000145a0: 282a 6e6f 7465 2044 6570 656e 6465 6e63 (*note Dependenc │ │ │ │ │ +000145b0: 6965 733a 3a29 2e0a 0a27 656c 6973 702d ies::)...'elisp- │ │ │ │ │ +000145c0: 636f 6d70 270a 2020 2020 2054 6869 7320 comp'. This │ │ │ │ │ +000145d0: 7072 6f67 7261 6d20 6973 2075 7365 6420 program is used │ │ │ │ │ +000145e0: 746f 2062 7974 652d 636f 6d70 696c 6520 to byte-compile │ │ │ │ │ +000145f0: 456d 6163 7320 4c69 7370 2063 6f64 652e Emacs Lisp code. │ │ │ │ │ +00014600: 0a0a 2769 6e73 7461 6c6c 2d73 6827 0a20 ..'install-sh'. │ │ │ │ │ +00014610: 2020 2020 5468 6973 2069 7320 6120 7265 This is a re │ │ │ │ │ +00014620: 706c 6163 656d 656e 7420 666f 7220 7468 placement for th │ │ │ │ │ +00014630: 6520 2769 6e73 7461 6c6c 2720 7072 6f67 e 'install' prog │ │ │ │ │ +00014640: 7261 6d20 7468 6174 2077 6f72 6b73 206f ram that works o │ │ │ │ │ +00014650: 6e0a 2020 2020 2070 6c61 7466 6f72 6d73 n. platforms │ │ │ │ │ +00014660: 2077 6865 7265 2027 696e 7374 616c 6c27 where 'install' │ │ │ │ │ +00014670: 2069 7320 756e 6176 6169 6c61 626c 6520 is unavailable │ │ │ │ │ +00014680: 6f72 2075 6e75 7361 626c 652e 0a0a 276d or unusable...'m │ │ │ │ │ +00014690: 6461 7465 2d73 6827 0a20 2020 2020 5468 date-sh'. Th │ │ │ │ │ +000146a0: 6973 2073 6372 6970 7420 6973 2075 7365 is script is use │ │ │ │ │ +000146b0: 6420 746f 2067 656e 6572 6174 6520 6120 d to generate a │ │ │ │ │ +000146c0: 2776 6572 7369 6f6e 2e74 6578 6927 2066 'version.texi' f │ │ │ │ │ +000146d0: 696c 652e 2020 4974 2065 7861 6d69 6e65 ile. It examine │ │ │ │ │ +000146e0: 730a 2020 2020 2061 2066 696c 6520 616e s. a file an │ │ │ │ │ +000146f0: 6420 7072 696e 7473 2073 6f6d 6520 6461 d prints some da │ │ │ │ │ +00014700: 7465 2069 6e66 6f72 6d61 7469 6f6e 2061 te information a │ │ │ │ │ +00014710: 626f 7574 2069 742e 0a0a 276d 6973 7369 bout it...'missi │ │ │ │ │ +00014720: 6e67 270a 2020 2020 2054 6869 7320 7772 ng'. This wr │ │ │ │ │ +00014730: 6170 7320 6120 6e75 6d62 6572 206f 6620 aps a number of │ │ │ │ │ +00014740: 7072 6f67 7261 6d73 2074 6861 7420 6172 programs that ar │ │ │ │ │ +00014750: 6520 7479 7069 6361 6c6c 7920 6f6e 6c79 e typically only │ │ │ │ │ +00014760: 2072 6571 7569 7265 6420 6279 0a20 2020 required by. │ │ │ │ │ +00014770: 2020 6d61 696e 7461 696e 6572 732e 2020 maintainers. │ │ │ │ │ +00014780: 4966 2074 6865 2070 726f 6772 616d 2069 If the program i │ │ │ │ │ +00014790: 6e20 7175 6573 7469 6f6e 2064 6f65 736e n question doesn │ │ │ │ │ +000147a0: 2774 2065 7869 7374 2c20 276d 6973 7369 't exist, 'missi │ │ │ │ │ +000147b0: 6e67 270a 2020 2020 2070 7269 6e74 7320 ng'. prints │ │ │ │ │ +000147c0: 616e 2069 6e66 6f72 6d61 7469 7665 2077 an informative w │ │ │ │ │ +000147d0: 6172 6e69 6e67 2061 6e64 2061 7474 656d arning and attem │ │ │ │ │ +000147e0: 7074 7320 746f 2066 6978 2074 6869 6e67 pts to fix thing │ │ │ │ │ +000147f0: 7320 736f 2074 6861 740a 2020 2020 2074 s so that. t │ │ │ │ │ +00014800: 6865 2062 7569 6c64 2063 616e 2063 6f6e he build can con │ │ │ │ │ +00014810: 7469 6e75 652e 0a0a 276d 6b69 6e73 7461 tinue...'mkinsta │ │ │ │ │ +00014820: 6c6c 6469 7273 270a 2020 2020 2054 6869 lldirs'. Thi │ │ │ │ │ +00014830: 7320 7363 7269 7074 2075 7365 6420 746f s script used to │ │ │ │ │ +00014840: 2062 6520 6120 7772 6170 7065 7220 6172 be a wrapper ar │ │ │ │ │ +00014850: 6f75 6e64 2027 6d6b 6469 7220 2d70 272c ound 'mkdir -p', │ │ │ │ │ +00014860: 2077 6869 6368 2069 7320 6e6f 740a 2020 which is not. │ │ │ │ │ +00014870: 2020 2070 6f72 7461 626c 652e 2020 4e6f portable. No │ │ │ │ │ +00014880: 7720 7765 2070 7265 6665 7220 746f 2075 w we prefer to u │ │ │ │ │ +00014890: 7365 2027 696e 7374 616c 6c2d 7368 202d se 'install-sh - │ │ │ │ │ +000148a0: 6427 2077 6865 6e20 2763 6f6e 6669 6775 d' when 'configu │ │ │ │ │ +000148b0: 7265 270a 2020 2020 2066 696e 6473 2074 re'. finds t │ │ │ │ │ +000148c0: 6861 7420 276d 6b64 6972 202d 7027 2064 hat 'mkdir -p' d │ │ │ │ │ +000148d0: 6f65 7320 6e6f 7420 776f 726b 2c20 7468 oes not work, th │ │ │ │ │ +000148e0: 6973 206d 616b 6573 206f 6e65 206c 6573 is makes one les │ │ │ │ │ +000148f0: 7320 7363 7269 7074 2074 6f0a 2020 2020 s script to. │ │ │ │ │ +00014900: 2064 6973 7472 6962 7574 652e 0a0a 2020 distribute... │ │ │ │ │ +00014910: 2020 2046 6f72 2062 6163 6b77 6172 6420 For backward │ │ │ │ │ +00014920: 636f 6d70 6174 6962 696c 6974 7920 276d compatibility 'm │ │ │ │ │ +00014930: 6b69 6e73 7461 6c6c 6469 7273 2720 6973 kinstalldirs' is │ │ │ │ │ +00014940: 2073 7469 6c6c 2075 7365 6420 616e 640a still used and. │ │ │ │ │ +00014950: 2020 2020 2064 6973 7472 6962 7574 6564 distributed │ │ │ │ │ +00014960: 2077 6865 6e20 2761 7574 6f6d 616b 6527 when 'automake' │ │ │ │ │ +00014970: 2066 696e 6473 2069 7420 696e 2061 2070 finds it in a p │ │ │ │ │ +00014980: 6163 6b61 6765 2e20 2042 7574 2069 7420 ackage. But it │ │ │ │ │ +00014990: 6973 206e 6f0a 2020 2020 206c 6f6e 6765 is no. longe │ │ │ │ │ +000149a0: 7220 696e 7374 616c 6c65 6420 6175 746f r installed auto │ │ │ │ │ +000149b0: 6d61 7469 6361 6c6c 792c 2061 6e64 2069 matically, and i │ │ │ │ │ +000149c0: 7420 7368 6f75 6c64 2062 6520 7361 6665 t should be safe │ │ │ │ │ +000149d0: 2074 6f20 7265 6d6f 7665 2069 742e 0a0a to remove it... │ │ │ │ │ +000149e0: 2770 792d 636f 6d70 696c 6527 0a20 2020 'py-compile'. │ │ │ │ │ +000149f0: 2020 5468 6973 2069 7320 7573 6564 2074 This is used t │ │ │ │ │ +00014a00: 6f20 6279 7465 2d63 6f6d 7069 6c65 2050 o byte-compile P │ │ │ │ │ +00014a10: 7974 686f 6e20 7363 7269 7074 732e 0a0a ython scripts... │ │ │ │ │ +00014a20: 2773 796d 6c69 6e6b 2d74 7265 6527 0a20 'symlink-tree'. │ │ │ │ │ +00014a30: 2020 2020 5468 6973 2070 726f 6772 616d This program │ │ │ │ │ +00014a40: 2064 7570 6c69 6361 7465 7320 6120 7472 duplicates a tr │ │ │ │ │ +00014a50: 6565 206f 6620 6469 7265 6374 6f72 6965 ee of directorie │ │ │ │ │ +00014a60: 732c 2075 7369 6e67 2073 796d 626f 6c69 s, using symboli │ │ │ │ │ +00014a70: 6320 6c69 6e6b 730a 2020 2020 2069 6e73 c links. ins │ │ │ │ │ +00014a80: 7465 6164 206f 6620 636f 7079 696e 6720 tead of copying │ │ │ │ │ +00014a90: 6669 6c65 732e 2020 5375 6368 2061 6e20 files. Such an │ │ │ │ │ +00014aa0: 6f70 6572 6174 696f 6e20 6973 2070 6572 operation is per │ │ │ │ │ +00014ab0: 666f 726d 6564 2077 6865 6e0a 2020 2020 formed when. │ │ │ │ │ +00014ac0: 2062 7569 6c64 696e 6720 6d75 6c74 696c building multil │ │ │ │ │ +00014ad0: 6962 7320 282a 6e6f 7465 204d 756c 7469 ibs (*note Multi │ │ │ │ │ +00014ae0: 6c69 6273 3a3a 292e 2020 5369 6e63 6520 libs::). Since │ │ │ │ │ +00014af0: 7468 6520 4175 746f 6d61 6b65 0a20 2020 the Automake. │ │ │ │ │ +00014b00: 2020 6d75 6c74 696c 6962 2073 7570 706f multilib suppo │ │ │ │ │ +00014b10: 7274 2068 6173 2062 6565 6e20 5f64 6570 rt has been _dep │ │ │ │ │ +00014b20: 7265 6361 7465 645f 2061 6e64 2074 6172 recated_ and tar │ │ │ │ │ +00014b30: 6765 7465 6420 666f 7220 7265 6d6f 7661 geted for remova │ │ │ │ │ +00014b40: 6c2c 0a20 2020 2020 7468 6973 2066 696c l,. this fil │ │ │ │ │ +00014b50: 6520 6973 2067 6f69 6e67 2074 6f20 6265 e is going to be │ │ │ │ │ +00014b60: 205f 7265 6d6f 7665 6420 6672 6f6d 2074 _removed from t │ │ │ │ │ +00014b70: 6865 2041 7574 6f6d 616b 6520 636f 7265 he Automake core │ │ │ │ │ +00014b80: 5f20 696e 2074 6865 0a20 2020 2020 6e65 _ in the. ne │ │ │ │ │ +00014b90: 7874 206d 616a 6f72 2072 656c 6561 7365 xt major release │ │ │ │ │ +00014ba0: 2e20 2054 6865 206d 6173 7465 7220 636f . The master co │ │ │ │ │ +00014bb0: 7079 206f 6620 7468 6973 2066 696c 6520 py of this file │ │ │ │ │ +00014bc0: 6973 206d 6169 6e74 6169 6e65 6420 696e is maintained in │ │ │ │ │ +00014bd0: 0a20 2020 2020 7468 6520 4743 4320 7472 . the GCC tr │ │ │ │ │ +00014be0: 6565 2061 7420 3c68 7474 703a 2f2f 6763 ee at ...'texinfo.t │ │ │ │ │ +00014c10: 6578 270a 2020 2020 204e 6f74 2061 2070 ex'. Not a p │ │ │ │ │ +00014c20: 726f 6772 616d 2c20 7468 6973 2066 696c rogram, this fil │ │ │ │ │ +00014c30: 6520 6973 2072 6571 7569 7265 6420 666f e is required fo │ │ │ │ │ +00014c40: 7220 276d 616b 6520 6476 6927 2c20 276d r 'make dvi', 'm │ │ │ │ │ +00014c50: 616b 6520 7073 2720 616e 640a 2020 2020 ake ps' and. │ │ │ │ │ +00014c60: 2027 6d61 6b65 2070 6466 2720 746f 2077 'make pdf' to w │ │ │ │ │ +00014c70: 6f72 6b20 7768 656e 2054 6578 696e 666f ork when Texinfo │ │ │ │ │ +00014c80: 2073 6f75 7263 6573 2061 7265 2069 6e20 sources are in │ │ │ │ │ +00014c90: 7468 6520 7061 636b 6167 652e 2020 5468 the package. Th │ │ │ │ │ +00014ca0: 650a 2020 2020 206c 6174 6573 7420 7665 e. latest ve │ │ │ │ │ +00014cb0: 7273 696f 6e20 6361 6e20 6265 2064 6f77 rsion can be dow │ │ │ │ │ +00014cc0: 6e6c 6f61 6465 6420 6672 6f6d 0a20 2020 nloaded from. │ │ │ │ │ +00014cd0: 2020 3c68 7474 703a 2f2f 7777 772e 676e ...'ylwr │ │ │ │ │ +00014d00: 6170 270a 2020 2020 2054 6869 7320 7072 ap'. This pr │ │ │ │ │ +00014d10: 6f67 7261 6d20 7772 6170 7320 276c 6578 ogram wraps 'lex │ │ │ │ │ +00014d20: 2720 616e 6420 2779 6163 6327 2074 6f20 ' and 'yacc' to │ │ │ │ │ +00014d30: 7265 6e61 6d65 2074 6865 6972 206f 7574 rename their out │ │ │ │ │ +00014d40: 7075 7420 6669 6c65 732e 0a20 2020 2020 put files.. │ │ │ │ │ +00014d50: 4974 2061 6c73 6f20 656e 7375 7265 7320 It also ensures │ │ │ │ │ +00014d60: 7468 6174 2c20 666f 7220 696e 7374 616e that, for instan │ │ │ │ │ +00014d70: 6365 2c20 6d75 6c74 6970 6c65 2027 7961 ce, multiple 'ya │ │ │ │ │ +00014d80: 6363 2720 696e 7374 616e 6365 7320 6361 cc' instances ca │ │ │ │ │ +00014d90: 6e0a 2020 2020 2062 6520 696e 766f 6b65 n. be invoke │ │ │ │ │ +00014da0: 6420 696e 2061 2073 696e 676c 6520 6469 d in a single di │ │ │ │ │ +00014db0: 7265 6374 6f72 7920 696e 2070 6172 616c rectory in paral │ │ │ │ │ +00014dc0: 6c65 6c2e 0a0a 1f0a 4669 6c65 3a20 6175 lel.....File: au │ │ │ │ │ +00014dd0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00014de0: 2c20 204e 6f64 653a 2045 7861 6d70 6c65 , Node: Example │ │ │ │ │ +00014df0: 732c 2020 4e65 7874 3a20 6175 746f 6d61 s, Next: automa │ │ │ │ │ +00014e00: 6b65 2049 6e76 6f63 6174 696f 6e2c 2020 ke Invocation, │ │ │ │ │ +00014e10: 5072 6576 3a20 4765 6e65 7261 6c69 7469 Prev: Generaliti │ │ │ │ │ +00014e20: 6573 2c20 2055 703a 2054 6f70 0a0a 3420 es, Up: Top..4 │ │ │ │ │ +00014e30: 536f 6d65 2065 7861 6d70 6c65 2070 6163 Some example pac │ │ │ │ │ +00014e40: 6b61 6765 730a 2a2a 2a2a 2a2a 2a2a 2a2a kages.********** │ │ │ │ │ +00014e50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 *************..T │ │ │ │ │ +00014e60: 6869 7320 7365 6374 696f 6e20 636f 6e74 his section cont │ │ │ │ │ +00014e70: 6169 6e73 2074 776f 2073 6d61 6c6c 2065 ains two small e │ │ │ │ │ +00014e80: 7861 6d70 6c65 732e 0a0a 2020 2054 6865 xamples... The │ │ │ │ │ +00014e90: 2066 6972 7374 2065 7861 6d70 6c65 2028 first example ( │ │ │ │ │ +00014ea0: 2a6e 6f74 6520 436f 6d70 6c65 7465 3a3a *note Complete:: │ │ │ │ │ +00014eb0: 2920 6173 7375 6d65 7320 796f 7520 6861 ) assumes you ha │ │ │ │ │ +00014ec0: 7665 2061 6e20 6578 6973 7469 6e67 0a70 ve an existing.p │ │ │ │ │ +00014ed0: 726f 6a65 6374 2061 6c72 6561 6479 2075 roject already u │ │ │ │ │ +00014ee0: 7369 6e67 2041 7574 6f63 6f6e 662c 2077 sing Autoconf, w │ │ │ │ │ +00014ef0: 6974 6820 6861 6e64 6372 6166 7465 6420 ith handcrafted │ │ │ │ │ +00014f00: 274d 616b 6566 696c 6527 732c 2061 6e64 'Makefile's, and │ │ │ │ │ +00014f10: 2074 6861 740a 796f 7520 7761 6e74 2074 that.you want t │ │ │ │ │ +00014f20: 6f20 636f 6e76 6572 7420 6974 2074 6f20 o convert it to │ │ │ │ │ +00014f30: 7573 696e 6720 4175 746f 6d61 6b65 2e20 using Automake. │ │ │ │ │ +00014f40: 2049 6620 796f 7520 6172 6520 6469 7363 If you are disc │ │ │ │ │ +00014f50: 6f76 6572 696e 6720 626f 7468 0a74 6f6f overing both.too │ │ │ │ │ +00014f60: 6c73 2c20 6974 2069 7320 7072 6f62 6162 ls, it is probab │ │ │ │ │ +00014f70: 6c79 2062 6574 7465 7220 7468 6174 2079 ly better that y │ │ │ │ │ +00014f80: 6f75 206c 6f6f 6b20 6174 2074 6865 2048 ou look at the H │ │ │ │ │ +00014f90: 656c 6c6f 2057 6f72 6c64 2065 7861 6d70 ello World examp │ │ │ │ │ +00014fa0: 6c65 0a70 7265 7365 6e74 6564 2065 6172 le.presented ear │ │ │ │ │ +00014fb0: 6c69 6572 2028 2a6e 6f74 6520 4865 6c6c lier (*note Hell │ │ │ │ │ +00014fc0: 6f20 576f 726c 643a 3a29 2e0a 0a20 2020 o World::)... │ │ │ │ │ +00014fd0: 5468 6520 7365 636f 6e64 2065 7861 6d70 The second examp │ │ │ │ │ +00014fe0: 6c65 2028 2a6e 6f74 6520 7472 7565 3a3a le (*note true:: │ │ │ │ │ +00014ff0: 2920 7368 6f77 7320 686f 7720 7477 6f20 ) shows how two │ │ │ │ │ +00015000: 7072 6f67 7261 6d73 2063 616e 2062 6520 programs can be │ │ │ │ │ +00015010: 6275 696c 740a 6672 6f6d 2074 6865 2073 built.from the s │ │ │ │ │ +00015020: 616d 6520 6669 6c65 2c20 7573 696e 6720 ame file, using │ │ │ │ │ +00015030: 6469 6666 6572 656e 7420 636f 6d70 696c different compil │ │ │ │ │ +00015040: 6174 696f 6e20 7061 7261 6d65 7465 7273 ation parameters │ │ │ │ │ +00015050: 2e20 2049 7420 636f 6e74 6169 6e73 0a73 . It contains.s │ │ │ │ │ +00015060: 6f6d 6520 7465 6368 6e69 6361 6c20 6469 ome technical di │ │ │ │ │ +00015070: 6772 6573 7369 6f6e 7320 7468 6174 2061 gressions that a │ │ │ │ │ +00015080: 7265 2070 726f 6261 626c 7920 6265 7374 re probably best │ │ │ │ │ +00015090: 2073 6b69 7070 6564 206f 6e20 6669 7273 skipped on firs │ │ │ │ │ +000150a0: 7420 7265 6164 2e0a 0a2a 204d 656e 753a t read...* Menu: │ │ │ │ │ +000150b0: 0a0a 2a20 436f 6d70 6c65 7465 3a3a 2020 ..* Complete:: │ │ │ │ │ 000150c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000150d0: 4120 7369 6d70 6c65 2065 7861 6d70 6c65 A simple example │ │ │ │ │ -000150e0: 2c20 7374 6172 7420 746f 2066 696e 6973 , start to finis │ │ │ │ │ -000150f0: 680a 2a20 7472 7565 3a3a 2020 2020 2020 h.* true:: │ │ │ │ │ +000150d0: 2020 4120 7369 6d70 6c65 2065 7861 6d70 A simple examp │ │ │ │ │ +000150e0: 6c65 2c20 7374 6172 7420 746f 2066 696e le, start to fin │ │ │ │ │ +000150f0: 6973 680a 2a20 7472 7565 3a3a 2020 2020 ish.* true:: │ │ │ │ │ 00015100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00015110: 2020 4275 696c 6469 6e67 2074 7275 6520 Building true │ │ │ │ │ -00015120: 616e 6420 6661 6c73 650a 0a1f 0a46 696c and false....Fil │ │ │ │ │ -00015130: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -00015140: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 436f .info, Node: Co │ │ │ │ │ -00015150: 6d70 6c65 7465 2c20 204e 6578 743a 2074 mplete, Next: t │ │ │ │ │ -00015160: 7275 652c 2020 5570 3a20 4578 616d 706c rue, Up: Exampl │ │ │ │ │ -00015170: 6573 0a0a 342e 3120 4120 7369 6d70 6c65 es..4.1 A simple │ │ │ │ │ -00015180: 2065 7861 6d70 6c65 2c20 7374 6172 7420 example, start │ │ │ │ │ -00015190: 746f 2066 696e 6973 680a 3d3d 3d3d 3d3d to finish.====== │ │ │ │ │ +00015110: 2020 2020 4275 696c 6469 6e67 2074 7275 Building tru │ │ │ │ │ +00015120: 6520 616e 6420 6661 6c73 650a 0a1f 0a46 e and false....F │ │ │ │ │ +00015130: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +00015140: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +00015150: 436f 6d70 6c65 7465 2c20 204e 6578 743a Complete, Next: │ │ │ │ │ +00015160: 2074 7275 652c 2020 5570 3a20 4578 616d true, Up: Exam │ │ │ │ │ +00015170: 706c 6573 0a0a 342e 3120 4120 7369 6d70 ples..4.1 A simp │ │ │ │ │ +00015180: 6c65 2065 7861 6d70 6c65 2c20 7374 6172 le example, star │ │ │ │ │ +00015190: 7420 746f 2066 696e 6973 680a 3d3d 3d3d t to finish.==== │ │ │ │ │ 000151a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000151b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -000151c0: 0a4c 6574 2773 2073 7570 706f 7365 2079 .Let's suppose y │ │ │ │ │ -000151d0: 6f75 206a 7573 7420 6669 6e69 7368 6564 ou just finished │ │ │ │ │ -000151e0: 2077 7269 7469 6e67 2027 7a61 7264 6f7a writing 'zardoz │ │ │ │ │ -000151f0: 272c 2061 2070 726f 6772 616d 2074 6f20 ', a program to │ │ │ │ │ -00015200: 6d61 6b65 2079 6f75 720a 6865 6164 2066 make your.head f │ │ │ │ │ -00015210: 6c6f 6174 2066 726f 6d20 766f 7274 6578 loat from vortex │ │ │ │ │ -00015220: 2074 6f20 766f 7274 6578 2e20 2059 6f75 to vortex. You │ │ │ │ │ -00015230: 2776 6520 6265 656e 2075 7369 6e67 2041 've been using A │ │ │ │ │ -00015240: 7574 6f63 6f6e 6620 746f 2070 726f 7669 utoconf to provi │ │ │ │ │ -00015250: 6465 0a61 2070 6f72 7461 6269 6c69 7479 de.a portability │ │ │ │ │ -00015260: 2066 7261 6d65 776f 726b 2c20 6275 7420 framework, but │ │ │ │ │ -00015270: 796f 7572 2027 4d61 6b65 6669 6c65 2e69 your 'Makefile.i │ │ │ │ │ -00015280: 6e27 7320 6861 7665 2062 6565 6e20 6164 n's have been ad │ │ │ │ │ -00015290: 2d68 6f63 2e20 2059 6f75 0a77 616e 7420 -hoc. You.want │ │ │ │ │ -000152a0: 746f 206d 616b 6520 7468 656d 2062 756c to make them bul │ │ │ │ │ -000152b0: 6c65 7470 726f 6f66 2c20 736f 2079 6f75 letproof, so you │ │ │ │ │ -000152c0: 2074 7572 6e20 746f 2041 7574 6f6d 616b turn to Automak │ │ │ │ │ -000152d0: 652e 0a0a 2020 2054 6865 2066 6972 7374 e... The first │ │ │ │ │ -000152e0: 2073 7465 7020 6973 2074 6f20 7570 6461 step is to upda │ │ │ │ │ -000152f0: 7465 2079 6f75 7220 2763 6f6e 6669 6775 te your 'configu │ │ │ │ │ -00015300: 7265 2e61 6327 2074 6f20 696e 636c 7564 re.ac' to includ │ │ │ │ │ -00015310: 6520 7468 650a 636f 6d6d 616e 6473 2074 e the.commands t │ │ │ │ │ -00015320: 6861 7420 2761 7574 6f6d 616b 6527 206e hat 'automake' n │ │ │ │ │ -00015330: 6565 6473 2e20 2054 6865 2077 6179 2074 eeds. The way t │ │ │ │ │ -00015340: 6f20 646f 2074 6869 7320 6973 2074 6f20 o do this is to │ │ │ │ │ -00015350: 6164 6420 616e 0a27 414d 5f49 4e49 545f add an.'AM_INIT_ │ │ │ │ │ -00015360: 4155 544f 4d41 4b45 2720 6361 6c6c 206a AUTOMAKE' call j │ │ │ │ │ -00015370: 7573 7420 6166 7465 7220 2741 435f 494e ust after 'AC_IN │ │ │ │ │ -00015380: 4954 273a 0a0a 2020 2020 2041 435f 494e IT':.. AC_IN │ │ │ │ │ -00015390: 4954 285b 7a61 7264 6f7a 5d2c 205b 312e IT([zardoz], [1. │ │ │ │ │ -000153a0: 305d 290a 2020 2020 2041 4d5f 494e 4954 0]). AM_INIT │ │ │ │ │ -000153b0: 5f41 5554 4f4d 414b 450a 2020 2020 202e _AUTOMAKE. . │ │ │ │ │ -000153c0: 2e2e 0a0a 2020 2053 696e 6365 2079 6f75 .... Since you │ │ │ │ │ -000153d0: 7220 7072 6f67 7261 6d20 646f 6573 6e27 r program doesn' │ │ │ │ │ -000153e0: 7420 6861 7665 2061 6e79 2063 6f6d 706c t have any compl │ │ │ │ │ -000153f0: 6963 6174 696e 6720 6661 6374 6f72 7320 icating factors │ │ │ │ │ -00015400: 2865 2e67 2e2c 2069 740a 646f 6573 6e27 (e.g., it.doesn' │ │ │ │ │ -00015410: 7420 7573 6520 2767 6574 7465 7874 272c t use 'gettext', │ │ │ │ │ -00015420: 2069 7420 646f 6573 6e27 7420 7761 6e74 it doesn't want │ │ │ │ │ -00015430: 2074 6f20 6275 696c 6420 6120 7368 6172 to build a shar │ │ │ │ │ -00015440: 6564 206c 6962 7261 7279 292c 0a79 6f75 ed library),.you │ │ │ │ │ -00015450: 2772 6520 646f 6e65 2077 6974 6820 7468 're done with th │ │ │ │ │ -00015460: 6973 2070 6172 742e 2020 5468 6174 2077 is part. That w │ │ │ │ │ -00015470: 6173 2065 6173 7921 0a0a 2020 204e 6f77 as easy!.. Now │ │ │ │ │ -00015480: 2079 6f75 206d 7573 7420 7265 6765 6e65 you must regene │ │ │ │ │ -00015490: 7261 7465 2027 636f 6e66 6967 7572 6527 rate 'configure' │ │ │ │ │ -000154a0: 2e20 2042 7574 2074 6f20 646f 2074 6861 . But to do tha │ │ │ │ │ -000154b0: 742c 2079 6f75 276c 6c20 6e65 6564 2074 t, you'll need t │ │ │ │ │ -000154c0: 6f0a 7465 6c6c 2027 6175 746f 636f 6e66 o.tell 'autoconf │ │ │ │ │ -000154d0: 2720 686f 7720 746f 2066 696e 6420 7468 ' how to find th │ │ │ │ │ -000154e0: 6520 6e65 7720 6d61 6372 6f20 796f 7527 e new macro you' │ │ │ │ │ -000154f0: 7665 2075 7365 642e 2020 5468 6520 6561 ve used. The ea │ │ │ │ │ -00015500: 7369 6573 7420 7761 790a 746f 2064 6f20 siest way.to do │ │ │ │ │ -00015510: 7468 6973 2069 7320 746f 2075 7365 2074 this is to use t │ │ │ │ │ -00015520: 6865 2027 6163 6c6f 6361 6c27 2070 726f he 'aclocal' pro │ │ │ │ │ -00015530: 6772 616d 2074 6f20 6765 6e65 7261 7465 gram to generate │ │ │ │ │ -00015540: 2079 6f75 7220 2761 636c 6f63 616c 2e6d your 'aclocal.m │ │ │ │ │ -00015550: 3427 0a66 6f72 2079 6f75 2e20 2042 7574 4'.for you. But │ │ │ │ │ -00015560: 2077 6169 742e 2e2e 206d 6179 6265 2079 wait... maybe y │ │ │ │ │ -00015570: 6f75 2061 6c72 6561 6479 2068 6176 6520 ou already have │ │ │ │ │ -00015580: 616e 2027 6163 6c6f 6361 6c2e 6d34 272c an 'aclocal.m4', │ │ │ │ │ -00015590: 2062 6563 6175 7365 0a79 6f75 2068 6164 because.you had │ │ │ │ │ -000155a0: 2074 6f20 7772 6974 6520 736f 6d65 2068 to write some h │ │ │ │ │ -000155b0: 6169 7279 206d 6163 726f 7320 666f 7220 airy macros for │ │ │ │ │ -000155c0: 796f 7572 2070 726f 6772 616d 2e20 2054 your program. T │ │ │ │ │ -000155d0: 6865 2027 6163 6c6f 6361 6c27 0a70 726f he 'aclocal'.pro │ │ │ │ │ -000155e0: 6772 616d 206c 6574 7320 796f 7520 7075 gram lets you pu │ │ │ │ │ -000155f0: 7420 796f 7572 206f 776e 206d 6163 726f t your own macro │ │ │ │ │ -00015600: 7320 696e 746f 2027 6163 696e 636c 7564 s into 'acinclud │ │ │ │ │ -00015610: 652e 6d34 272c 2073 6f20 7369 6d70 6c79 e.m4', so simply │ │ │ │ │ -00015620: 0a72 656e 616d 6520 616e 6420 7468 656e .rename and then │ │ │ │ │ -00015630: 2072 756e 3a0a 0a20 2020 2020 6d76 2061 run:.. mv a │ │ │ │ │ -00015640: 636c 6f63 616c 2e6d 3420 6163 696e 636c clocal.m4 acincl │ │ │ │ │ -00015650: 7564 652e 6d34 0a20 2020 2020 6163 6c6f ude.m4. aclo │ │ │ │ │ -00015660: 6361 6c0a 2020 2020 2061 7574 6f63 6f6e cal. autocon │ │ │ │ │ -00015670: 660a 0a20 2020 4e6f 7720 6974 2069 7320 f.. Now it is │ │ │ │ │ -00015680: 7469 6d65 2074 6f20 7772 6974 6520 796f time to write yo │ │ │ │ │ -00015690: 7572 2027 4d61 6b65 6669 6c65 2e61 6d27 ur 'Makefile.am' │ │ │ │ │ -000156a0: 2066 6f72 2027 7a61 7264 6f7a 272e 2020 for 'zardoz'. │ │ │ │ │ -000156b0: 5369 6e63 650a 277a 6172 646f 7a27 2069 Since.'zardoz' i │ │ │ │ │ -000156c0: 7320 6120 7573 6572 2070 726f 6772 616d s a user program │ │ │ │ │ -000156d0: 2c20 796f 7520 7761 6e74 2074 6f20 696e , you want to in │ │ │ │ │ -000156e0: 7374 616c 6c20 6974 2077 6865 7265 2074 stall it where t │ │ │ │ │ -000156f0: 6865 2072 6573 7420 6f66 2074 6865 0a75 he rest of the.u │ │ │ │ │ -00015700: 7365 7220 7072 6f67 7261 6d73 2067 6f3a ser programs go: │ │ │ │ │ -00015710: 2027 6269 6e64 6972 272e 2020 4164 6469 'bindir'. Addi │ │ │ │ │ -00015720: 7469 6f6e 616c 6c79 2c20 277a 6172 646f tionally, 'zardo │ │ │ │ │ -00015730: 7a27 2068 6173 2073 6f6d 6520 5465 7869 z' has some Texi │ │ │ │ │ -00015740: 6e66 6f0a 646f 6375 6d65 6e74 6174 696f nfo.documentatio │ │ │ │ │ -00015750: 6e2e 2020 596f 7572 2027 636f 6e66 6967 n. Your 'config │ │ │ │ │ -00015760: 7572 652e 6163 2720 7363 7269 7074 2075 ure.ac' script u │ │ │ │ │ -00015770: 7365 7320 2741 435f 5245 504c 4143 455f ses 'AC_REPLACE_ │ │ │ │ │ -00015780: 4655 4e43 5327 2c20 736f 0a79 6f75 206e FUNCS', so.you n │ │ │ │ │ -00015790: 6565 6420 746f 206c 696e 6b20 6167 6169 eed to link agai │ │ │ │ │ -000157a0: 6e73 7420 2724 284c 4942 4f42 4a53 2927 nst '$(LIBOBJS)' │ │ │ │ │ -000157b0: 2e20 2053 6f20 6865 7265 2773 2077 6861 . So here's wha │ │ │ │ │ -000157c0: 7420 796f 7527 6420 7772 6974 653a 0a0a t you'd write:.. │ │ │ │ │ -000157d0: 2020 2020 2062 696e 5f50 524f 4752 414d bin_PROGRAM │ │ │ │ │ -000157e0: 5320 3d20 7a61 7264 6f7a 0a20 2020 2020 S = zardoz. │ │ │ │ │ -000157f0: 7a61 7264 6f7a 5f53 4f55 5243 4553 203d zardoz_SOURCES = │ │ │ │ │ -00015800: 206d 6169 6e2e 6320 6865 6164 2e63 2066 main.c head.c f │ │ │ │ │ -00015810: 6c6f 6174 2e63 2076 6f72 7465 7839 2e63 loat.c vortex9.c │ │ │ │ │ -00015820: 2067 756e 2e63 0a20 2020 2020 7a61 7264 gun.c. zard │ │ │ │ │ -00015830: 6f7a 5f4c 4441 4444 203d 2024 284c 4942 oz_LDADD = $(LIB │ │ │ │ │ -00015840: 4f42 4a53 290a 0a20 2020 2020 696e 666f OBJS).. info │ │ │ │ │ -00015850: 5f54 4558 494e 464f 5320 3d20 7a61 7264 _TEXINFOS = zard │ │ │ │ │ -00015860: 6f7a 2e74 6578 690a 0a20 2020 4e6f 7720 oz.texi.. Now │ │ │ │ │ -00015870: 796f 7520 6361 6e20 7275 6e20 2761 7574 you can run 'aut │ │ │ │ │ -00015880: 6f6d 616b 6520 2d2d 6164 642d 6d69 7373 omake --add-miss │ │ │ │ │ -00015890: 696e 6727 2074 6f20 6765 6e65 7261 7465 ing' to generate │ │ │ │ │ -000158a0: 2079 6f75 720a 274d 616b 6566 696c 652e your.'Makefile. │ │ │ │ │ -000158b0: 696e 2720 616e 6420 6772 6162 2061 6e79 in' and grab any │ │ │ │ │ -000158c0: 2061 7578 696c 6961 7279 2066 696c 6573 auxiliary files │ │ │ │ │ -000158d0: 2079 6f75 206d 6967 6874 206e 6565 642c you might need, │ │ │ │ │ -000158e0: 2061 6e64 2079 6f75 2772 650a 646f 6e65 and you're.done │ │ │ │ │ -000158f0: 210a 0a1f 0a46 696c 653a 2061 7574 6f6d !....File: autom │ │ │ │ │ -00015900: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -00015910: 4e6f 6465 3a20 7472 7565 2c20 2050 7265 Node: true, Pre │ │ │ │ │ -00015920: 763a 2043 6f6d 706c 6574 652c 2020 5570 v: Complete, Up │ │ │ │ │ -00015930: 3a20 4578 616d 706c 6573 0a0a 342e 3220 : Examples..4.2 │ │ │ │ │ -00015940: 4275 696c 6469 6e67 2074 7275 6520 616e Building true an │ │ │ │ │ -00015950: 6420 6661 6c73 650a 3d3d 3d3d 3d3d 3d3d d false.======== │ │ │ │ │ +000151b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000151c0: 3d0a 0a4c 6574 2773 2073 7570 706f 7365 =..Let's suppose │ │ │ │ │ +000151d0: 2079 6f75 206a 7573 7420 6669 6e69 7368 you just finish │ │ │ │ │ +000151e0: 6564 2077 7269 7469 6e67 2027 7a61 7264 ed writing 'zard │ │ │ │ │ +000151f0: 6f7a 272c 2061 2070 726f 6772 616d 2074 oz', a program t │ │ │ │ │ +00015200: 6f20 6d61 6b65 2079 6f75 720a 6865 6164 o make your.head │ │ │ │ │ +00015210: 2066 6c6f 6174 2066 726f 6d20 766f 7274 float from vort │ │ │ │ │ +00015220: 6578 2074 6f20 766f 7274 6578 2e20 2059 ex to vortex. Y │ │ │ │ │ +00015230: 6f75 2776 6520 6265 656e 2075 7369 6e67 ou've been using │ │ │ │ │ +00015240: 2041 7574 6f63 6f6e 6620 746f 2070 726f Autoconf to pro │ │ │ │ │ +00015250: 7669 6465 0a61 2070 6f72 7461 6269 6c69 vide.a portabili │ │ │ │ │ +00015260: 7479 2066 7261 6d65 776f 726b 2c20 6275 ty framework, bu │ │ │ │ │ +00015270: 7420 796f 7572 2027 4d61 6b65 6669 6c65 t your 'Makefile │ │ │ │ │ +00015280: 2e69 6e27 7320 6861 7665 2062 6565 6e20 .in's have been │ │ │ │ │ +00015290: 6164 2d68 6f63 2e20 2059 6f75 0a77 616e ad-hoc. You.wan │ │ │ │ │ +000152a0: 7420 746f 206d 616b 6520 7468 656d 2062 t to make them b │ │ │ │ │ +000152b0: 756c 6c65 7470 726f 6f66 2c20 736f 2079 ulletproof, so y │ │ │ │ │ +000152c0: 6f75 2074 7572 6e20 746f 2041 7574 6f6d ou turn to Autom │ │ │ │ │ +000152d0: 616b 652e 0a0a 2020 2054 6865 2066 6972 ake... The fir │ │ │ │ │ +000152e0: 7374 2073 7465 7020 6973 2074 6f20 7570 st step is to up │ │ │ │ │ +000152f0: 6461 7465 2079 6f75 7220 2763 6f6e 6669 date your 'confi │ │ │ │ │ +00015300: 6775 7265 2e61 6327 2074 6f20 696e 636c gure.ac' to incl │ │ │ │ │ +00015310: 7564 6520 7468 650a 636f 6d6d 616e 6473 ude the.commands │ │ │ │ │ +00015320: 2074 6861 7420 2761 7574 6f6d 616b 6527 that 'automake' │ │ │ │ │ +00015330: 206e 6565 6473 2e20 2054 6865 2077 6179 needs. The way │ │ │ │ │ +00015340: 2074 6f20 646f 2074 6869 7320 6973 2074 to do this is t │ │ │ │ │ +00015350: 6f20 6164 6420 616e 0a27 414d 5f49 4e49 o add an.'AM_INI │ │ │ │ │ +00015360: 545f 4155 544f 4d41 4b45 2720 6361 6c6c T_AUTOMAKE' call │ │ │ │ │ +00015370: 206a 7573 7420 6166 7465 7220 2741 435f just after 'AC_ │ │ │ │ │ +00015380: 494e 4954 273a 0a0a 2020 2020 2041 435f INIT':.. AC_ │ │ │ │ │ +00015390: 494e 4954 285b 7a61 7264 6f7a 5d2c 205b INIT([zardoz], [ │ │ │ │ │ +000153a0: 312e 305d 290a 2020 2020 2041 4d5f 494e 1.0]). AM_IN │ │ │ │ │ +000153b0: 4954 5f41 5554 4f4d 414b 450a 2020 2020 IT_AUTOMAKE. │ │ │ │ │ +000153c0: 202e 2e2e 0a0a 2020 2053 696e 6365 2079 ..... Since y │ │ │ │ │ +000153d0: 6f75 7220 7072 6f67 7261 6d20 646f 6573 our program does │ │ │ │ │ +000153e0: 6e27 7420 6861 7665 2061 6e79 2063 6f6d n't have any com │ │ │ │ │ +000153f0: 706c 6963 6174 696e 6720 6661 6374 6f72 plicating factor │ │ │ │ │ +00015400: 7320 2865 2e67 2e2c 2069 740a 646f 6573 s (e.g., it.does │ │ │ │ │ +00015410: 6e27 7420 7573 6520 2767 6574 7465 7874 n't use 'gettext │ │ │ │ │ +00015420: 272c 2069 7420 646f 6573 6e27 7420 7761 ', it doesn't wa │ │ │ │ │ +00015430: 6e74 2074 6f20 6275 696c 6420 6120 7368 nt to build a sh │ │ │ │ │ +00015440: 6172 6564 206c 6962 7261 7279 292c 0a79 ared library),.y │ │ │ │ │ +00015450: 6f75 2772 6520 646f 6e65 2077 6974 6820 ou're done with │ │ │ │ │ +00015460: 7468 6973 2070 6172 742e 2020 5468 6174 this part. That │ │ │ │ │ +00015470: 2077 6173 2065 6173 7921 0a0a 2020 204e was easy!.. N │ │ │ │ │ +00015480: 6f77 2079 6f75 206d 7573 7420 7265 6765 ow you must rege │ │ │ │ │ +00015490: 6e65 7261 7465 2027 636f 6e66 6967 7572 nerate 'configur │ │ │ │ │ +000154a0: 6527 2e20 2042 7574 2074 6f20 646f 2074 e'. But to do t │ │ │ │ │ +000154b0: 6861 742c 2079 6f75 276c 6c20 6e65 6564 hat, you'll need │ │ │ │ │ +000154c0: 2074 6f0a 7465 6c6c 2027 6175 746f 636f to.tell 'autoco │ │ │ │ │ +000154d0: 6e66 2720 686f 7720 746f 2066 696e 6420 nf' how to find │ │ │ │ │ +000154e0: 7468 6520 6e65 7720 6d61 6372 6f20 796f the new macro yo │ │ │ │ │ +000154f0: 7527 7665 2075 7365 642e 2020 5468 6520 u've used. The │ │ │ │ │ +00015500: 6561 7369 6573 7420 7761 790a 746f 2064 easiest way.to d │ │ │ │ │ +00015510: 6f20 7468 6973 2069 7320 746f 2075 7365 o this is to use │ │ │ │ │ +00015520: 2074 6865 2027 6163 6c6f 6361 6c27 2070 the 'aclocal' p │ │ │ │ │ +00015530: 726f 6772 616d 2074 6f20 6765 6e65 7261 rogram to genera │ │ │ │ │ +00015540: 7465 2079 6f75 7220 2761 636c 6f63 616c te your 'aclocal │ │ │ │ │ +00015550: 2e6d 3427 0a66 6f72 2079 6f75 2e20 2042 .m4'.for you. B │ │ │ │ │ +00015560: 7574 2077 6169 742e 2e2e 206d 6179 6265 ut wait... maybe │ │ │ │ │ +00015570: 2079 6f75 2061 6c72 6561 6479 2068 6176 you already hav │ │ │ │ │ +00015580: 6520 616e 2027 6163 6c6f 6361 6c2e 6d34 e an 'aclocal.m4 │ │ │ │ │ +00015590: 272c 2062 6563 6175 7365 0a79 6f75 2068 ', because.you h │ │ │ │ │ +000155a0: 6164 2074 6f20 7772 6974 6520 736f 6d65 ad to write some │ │ │ │ │ +000155b0: 2068 6169 7279 206d 6163 726f 7320 666f hairy macros fo │ │ │ │ │ +000155c0: 7220 796f 7572 2070 726f 6772 616d 2e20 r your program. │ │ │ │ │ +000155d0: 2054 6865 2027 6163 6c6f 6361 6c27 0a70 The 'aclocal'.p │ │ │ │ │ +000155e0: 726f 6772 616d 206c 6574 7320 796f 7520 rogram lets you │ │ │ │ │ +000155f0: 7075 7420 796f 7572 206f 776e 206d 6163 put your own mac │ │ │ │ │ +00015600: 726f 7320 696e 746f 2027 6163 696e 636c ros into 'acincl │ │ │ │ │ +00015610: 7564 652e 6d34 272c 2073 6f20 7369 6d70 ude.m4', so simp │ │ │ │ │ +00015620: 6c79 0a72 656e 616d 6520 616e 6420 7468 ly.rename and th │ │ │ │ │ +00015630: 656e 2072 756e 3a0a 0a20 2020 2020 6d76 en run:.. mv │ │ │ │ │ +00015640: 2061 636c 6f63 616c 2e6d 3420 6163 696e aclocal.m4 acin │ │ │ │ │ +00015650: 636c 7564 652e 6d34 0a20 2020 2020 6163 clude.m4. ac │ │ │ │ │ +00015660: 6c6f 6361 6c0a 2020 2020 2061 7574 6f63 local. autoc │ │ │ │ │ +00015670: 6f6e 660a 0a20 2020 4e6f 7720 6974 2069 onf.. Now it i │ │ │ │ │ +00015680: 7320 7469 6d65 2074 6f20 7772 6974 6520 s time to write │ │ │ │ │ +00015690: 796f 7572 2027 4d61 6b65 6669 6c65 2e61 your 'Makefile.a │ │ │ │ │ +000156a0: 6d27 2066 6f72 2027 7a61 7264 6f7a 272e m' for 'zardoz'. │ │ │ │ │ +000156b0: 2020 5369 6e63 650a 277a 6172 646f 7a27 Since.'zardoz' │ │ │ │ │ +000156c0: 2069 7320 6120 7573 6572 2070 726f 6772 is a user progr │ │ │ │ │ +000156d0: 616d 2c20 796f 7520 7761 6e74 2074 6f20 am, you want to │ │ │ │ │ +000156e0: 696e 7374 616c 6c20 6974 2077 6865 7265 install it where │ │ │ │ │ +000156f0: 2074 6865 2072 6573 7420 6f66 2074 6865 the rest of the │ │ │ │ │ +00015700: 0a75 7365 7220 7072 6f67 7261 6d73 2067 .user programs g │ │ │ │ │ +00015710: 6f3a 2027 6269 6e64 6972 272e 2020 4164 o: 'bindir'. Ad │ │ │ │ │ +00015720: 6469 7469 6f6e 616c 6c79 2c20 277a 6172 ditionally, 'zar │ │ │ │ │ +00015730: 646f 7a27 2068 6173 2073 6f6d 6520 5465 doz' has some Te │ │ │ │ │ +00015740: 7869 6e66 6f0a 646f 6375 6d65 6e74 6174 xinfo.documentat │ │ │ │ │ +00015750: 696f 6e2e 2020 596f 7572 2027 636f 6e66 ion. Your 'conf │ │ │ │ │ +00015760: 6967 7572 652e 6163 2720 7363 7269 7074 igure.ac' script │ │ │ │ │ +00015770: 2075 7365 7320 2741 435f 5245 504c 4143 uses 'AC_REPLAC │ │ │ │ │ +00015780: 455f 4655 4e43 5327 2c20 736f 0a79 6f75 E_FUNCS', so.you │ │ │ │ │ +00015790: 206e 6565 6420 746f 206c 696e 6b20 6167 need to link ag │ │ │ │ │ +000157a0: 6169 6e73 7420 2724 284c 4942 4f42 4a53 ainst '$(LIBOBJS │ │ │ │ │ +000157b0: 2927 2e20 2053 6f20 6865 7265 2773 2077 )'. So here's w │ │ │ │ │ +000157c0: 6861 7420 796f 7527 6420 7772 6974 653a hat you'd write: │ │ │ │ │ +000157d0: 0a0a 2020 2020 2062 696e 5f50 524f 4752 .. bin_PROGR │ │ │ │ │ +000157e0: 414d 5320 3d20 7a61 7264 6f7a 0a20 2020 AMS = zardoz. │ │ │ │ │ +000157f0: 2020 7a61 7264 6f7a 5f53 4f55 5243 4553 zardoz_SOURCES │ │ │ │ │ +00015800: 203d 206d 6169 6e2e 6320 6865 6164 2e63 = main.c head.c │ │ │ │ │ +00015810: 2066 6c6f 6174 2e63 2076 6f72 7465 7839 float.c vortex9 │ │ │ │ │ +00015820: 2e63 2067 756e 2e63 0a20 2020 2020 7a61 .c gun.c. za │ │ │ │ │ +00015830: 7264 6f7a 5f4c 4441 4444 203d 2024 284c rdoz_LDADD = $(L │ │ │ │ │ +00015840: 4942 4f42 4a53 290a 0a20 2020 2020 696e IBOBJS).. in │ │ │ │ │ +00015850: 666f 5f54 4558 494e 464f 5320 3d20 7a61 fo_TEXINFOS = za │ │ │ │ │ +00015860: 7264 6f7a 2e74 6578 690a 0a20 2020 4e6f rdoz.texi.. No │ │ │ │ │ +00015870: 7720 796f 7520 6361 6e20 7275 6e20 2761 w you can run 'a │ │ │ │ │ +00015880: 7574 6f6d 616b 6520 2d2d 6164 642d 6d69 utomake --add-mi │ │ │ │ │ +00015890: 7373 696e 6727 2074 6f20 6765 6e65 7261 ssing' to genera │ │ │ │ │ +000158a0: 7465 2079 6f75 720a 274d 616b 6566 696c te your.'Makefil │ │ │ │ │ +000158b0: 652e 696e 2720 616e 6420 6772 6162 2061 e.in' and grab a │ │ │ │ │ +000158c0: 6e79 2061 7578 696c 6961 7279 2066 696c ny auxiliary fil │ │ │ │ │ +000158d0: 6573 2079 6f75 206d 6967 6874 206e 6565 es you might nee │ │ │ │ │ +000158e0: 642c 2061 6e64 2079 6f75 2772 650a 646f d, and you're.do │ │ │ │ │ +000158f0: 6e65 210a 0a1f 0a46 696c 653a 2061 7574 ne!....File: aut │ │ │ │ │ +00015900: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +00015910: 2020 4e6f 6465 3a20 7472 7565 2c20 2050 Node: true, P │ │ │ │ │ +00015920: 7265 763a 2043 6f6d 706c 6574 652c 2020 rev: Complete, │ │ │ │ │ +00015930: 5570 3a20 4578 616d 706c 6573 0a0a 342e Up: Examples..4. │ │ │ │ │ +00015940: 3220 4275 696c 6469 6e67 2074 7275 6520 2 Building true │ │ │ │ │ +00015950: 616e 6420 6661 6c73 650a 3d3d 3d3d 3d3d and false.====== │ │ │ │ │ 00015960: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00015970: 3d3d 3d0a 0a48 6572 6520 6973 2061 6e6f ===..Here is ano │ │ │ │ │ -00015980: 7468 6572 2c20 7472 6963 6b69 6572 2065 ther, trickier e │ │ │ │ │ -00015990: 7861 6d70 6c65 2e20 2049 7420 7368 6f77 xample. It show │ │ │ │ │ -000159a0: 7320 686f 7720 746f 2067 656e 6572 6174 s how to generat │ │ │ │ │ -000159b0: 6520 7477 6f0a 7072 6f67 7261 6d73 2028 e two.programs ( │ │ │ │ │ -000159c0: 2774 7275 6527 2061 6e64 2027 6661 6c73 'true' and 'fals │ │ │ │ │ -000159d0: 6527 2920 6672 6f6d 2074 6865 2073 616d e') from the sam │ │ │ │ │ -000159e0: 6520 736f 7572 6365 2066 696c 6520 2827 e source file (' │ │ │ │ │ -000159f0: 7472 7565 2e63 2729 2e20 2054 6865 0a64 true.c'). The.d │ │ │ │ │ -00015a00: 6966 6669 6375 6c74 2070 6172 7420 6973 ifficult part is │ │ │ │ │ -00015a10: 2074 6861 7420 6561 6368 2063 6f6d 7069 that each compi │ │ │ │ │ -00015a20: 6c61 7469 6f6e 206f 6620 2774 7275 652e lation of 'true. │ │ │ │ │ -00015a30: 6327 2072 6571 7569 7265 7320 6469 6666 c' requires diff │ │ │ │ │ -00015a40: 6572 656e 740a 2763 7070 2720 666c 6167 erent.'cpp' flag │ │ │ │ │ -00015a50: 732e 0a0a 2020 2020 2062 696e 5f50 524f s... bin_PRO │ │ │ │ │ -00015a60: 4752 414d 5320 3d20 7472 7565 2066 616c GRAMS = true fal │ │ │ │ │ -00015a70: 7365 0a20 2020 2020 6661 6c73 655f 534f se. false_SO │ │ │ │ │ -00015a80: 5552 4345 5320 3d0a 2020 2020 2066 616c URCES =. fal │ │ │ │ │ -00015a90: 7365 5f4c 4441 4444 203d 2066 616c 7365 se_LDADD = false │ │ │ │ │ -00015aa0: 2e6f 0a0a 2020 2020 2074 7275 652e 6f3a .o.. true.o: │ │ │ │ │ -00015ab0: 2074 7275 652e 630a 2020 2020 2020 2020 true.c. │ │ │ │ │ -00015ac0: 2020 2020 2024 2843 4f4d 5049 4c45 2920 $(COMPILE) │ │ │ │ │ -00015ad0: 2d44 4558 4954 5f43 4f44 453d 3020 2d63 -DEXIT_CODE=0 -c │ │ │ │ │ -00015ae0: 2074 7275 652e 630a 0a20 2020 2020 6661 true.c.. fa │ │ │ │ │ -00015af0: 6c73 652e 6f3a 2074 7275 652e 630a 2020 lse.o: true.c. │ │ │ │ │ -00015b00: 2020 2020 2020 2020 2020 2024 2843 4f4d $(COM │ │ │ │ │ -00015b10: 5049 4c45 2920 2d44 4558 4954 5f43 4f44 PILE) -DEXIT_COD │ │ │ │ │ -00015b20: 453d 3120 2d6f 2066 616c 7365 2e6f 202d E=1 -o false.o - │ │ │ │ │ -00015b30: 6320 7472 7565 2e63 0a0a 2020 204e 6f74 c true.c.. Not │ │ │ │ │ -00015b40: 6520 7468 6174 2074 6865 7265 2069 7320 e that there is │ │ │ │ │ -00015b50: 6e6f 2027 7472 7565 5f53 4f55 5243 4553 no 'true_SOURCES │ │ │ │ │ -00015b60: 2720 6465 6669 6e69 7469 6f6e 2e20 2041 ' definition. A │ │ │ │ │ -00015b70: 7574 6f6d 616b 6520 7769 6c6c 0a69 6d70 utomake will.imp │ │ │ │ │ -00015b80: 6c69 6369 746c 7920 6173 7375 6d65 2074 licitly assume t │ │ │ │ │ -00015b90: 6861 7420 7468 6572 6520 6973 2061 2073 hat there is a s │ │ │ │ │ -00015ba0: 6f75 7263 6520 6669 6c65 206e 616d 6564 ource file named │ │ │ │ │ -00015bb0: 2027 7472 7565 2e63 2720 282a 6e6f 7465 'true.c' (*note │ │ │ │ │ -00015bc0: 0a44 6566 6175 6c74 205f 534f 5552 4345 .Default _SOURCE │ │ │ │ │ -00015bd0: 533a 3a29 2c20 616e 6420 6465 6669 6e65 S::), and define │ │ │ │ │ -00015be0: 2072 756c 6573 2074 6f20 636f 6d70 696c rules to compil │ │ │ │ │ -00015bf0: 6520 2774 7275 652e 6f27 2061 6e64 206c e 'true.o' and l │ │ │ │ │ -00015c00: 696e 6b0a 2774 7275 6527 2e20 2054 6865 ink.'true'. The │ │ │ │ │ -00015c10: 2027 7472 7565 2e6f 3a20 7472 7565 2e63 'true.o: true.c │ │ │ │ │ -00015c20: 2720 7275 6c65 2073 7570 706c 6965 6420 ' rule supplied │ │ │ │ │ -00015c30: 6279 2074 6865 2061 626f 7665 2027 4d61 by the above 'Ma │ │ │ │ │ -00015c40: 6b65 6669 6c65 2e61 6d27 2c0a 7769 6c6c kefile.am',.will │ │ │ │ │ -00015c50: 206f 7665 7272 6964 6520 7468 6520 4175 override the Au │ │ │ │ │ -00015c60: 746f 6d61 6b65 2067 656e 6572 6174 6564 tomake generated │ │ │ │ │ -00015c70: 2072 756c 6520 746f 2062 7569 6c64 2027 rule to build ' │ │ │ │ │ -00015c80: 7472 7565 2e6f 272e 0a0a 2020 2027 6661 true.o'... 'fa │ │ │ │ │ -00015c90: 6c73 655f 534f 5552 4345 5327 2069 7320 lse_SOURCES' is │ │ │ │ │ -00015ca0: 6465 6669 6e65 6420 746f 2062 6520 656d defined to be em │ │ │ │ │ -00015cb0: 7074 792d 2d74 6861 7420 7761 7920 6e6f pty--that way no │ │ │ │ │ -00015cc0: 2069 6d70 6c69 6369 7420 7661 6c75 6520 implicit value │ │ │ │ │ -00015cd0: 6973 0a73 7562 7374 6974 7574 6564 2e20 is.substituted. │ │ │ │ │ -00015ce0: 2042 6563 6175 7365 2077 6520 6861 7665 Because we have │ │ │ │ │ -00015cf0: 206e 6f74 206c 6973 7465 6420 7468 6520 not listed the │ │ │ │ │ -00015d00: 736f 7572 6365 206f 6620 2766 616c 7365 source of 'false │ │ │ │ │ -00015d10: 272c 2077 6520 6861 7665 0a74 6f20 7465 ', we have.to te │ │ │ │ │ -00015d20: 6c6c 2041 7574 6f6d 616b 6520 686f 7720 ll Automake how │ │ │ │ │ -00015d30: 746f 206c 696e 6b20 7468 6520 7072 6f67 to link the prog │ │ │ │ │ -00015d40: 7261 6d2e 2020 5468 6973 2069 7320 7468 ram. This is th │ │ │ │ │ -00015d50: 6520 7075 7270 6f73 6520 6f66 2074 6865 e purpose of the │ │ │ │ │ -00015d60: 0a27 6661 6c73 655f 4c44 4144 4427 206c .'false_LDADD' l │ │ │ │ │ -00015d70: 696e 652e 2020 4120 2766 616c 7365 5f44 ine. A 'false_D │ │ │ │ │ -00015d80: 4550 454e 4445 4e43 4945 5327 2076 6172 EPENDENCIES' var │ │ │ │ │ -00015d90: 6961 626c 652c 2068 6f6c 6469 6e67 2074 iable, holding t │ │ │ │ │ -00015da0: 6865 0a64 6570 656e 6465 6e63 6965 7320 he.dependencies │ │ │ │ │ -00015db0: 6f66 2074 6865 2027 6661 6c73 6527 2074 of the 'false' t │ │ │ │ │ -00015dc0: 6172 6765 7420 7769 6c6c 2062 6520 6175 arget will be au │ │ │ │ │ -00015dd0: 746f 6d61 7469 6361 6c6c 7920 6765 6e65 tomatically gene │ │ │ │ │ -00015de0: 7261 7465 6420 6279 0a41 7574 6f6d 616b rated by.Automak │ │ │ │ │ -00015df0: 6520 6672 6f6d 2074 6865 2063 6f6e 7465 e from the conte │ │ │ │ │ -00015e00: 6e74 206f 6620 2766 616c 7365 5f4c 4441 nt of 'false_LDA │ │ │ │ │ -00015e10: 4444 272e 0a0a 2020 2054 6865 2061 626f DD'... The abo │ │ │ │ │ -00015e20: 7665 2072 756c 6573 2077 6f6e 2774 2077 ve rules won't w │ │ │ │ │ -00015e30: 6f72 6b20 6966 2079 6f75 7220 636f 6d70 ork if your comp │ │ │ │ │ -00015e40: 696c 6572 2064 6f65 736e 2774 2061 6363 iler doesn't acc │ │ │ │ │ -00015e50: 6570 7420 626f 7468 2027 2d63 270a 616e ept both '-c'.an │ │ │ │ │ -00015e60: 6420 272d 6f27 2e20 2054 6865 2073 696d d '-o'. The sim │ │ │ │ │ -00015e70: 706c 6573 7420 6669 7820 666f 7220 7468 plest fix for th │ │ │ │ │ -00015e80: 6973 2069 7320 746f 2069 6e74 726f 6475 is is to introdu │ │ │ │ │ -00015e90: 6365 2061 2062 6f67 7573 2064 6570 656e ce a bogus depen │ │ │ │ │ -00015ea0: 6465 6e63 790a 2874 6f20 6176 6f69 6420 dency.(to avoid │ │ │ │ │ -00015eb0: 7072 6f62 6c65 6d73 2077 6974 6820 6120 problems with a │ │ │ │ │ -00015ec0: 7061 7261 6c6c 656c 2027 6d61 6b65 2729 parallel 'make') │ │ │ │ │ -00015ed0: 3a0a 0a20 2020 2020 7472 7565 2e6f 3a20 :.. true.o: │ │ │ │ │ -00015ee0: 7472 7565 2e63 2066 616c 7365 2e6f 0a20 true.c false.o. │ │ │ │ │ -00015ef0: 2020 2020 2020 2020 2020 2020 2428 434f $(CO │ │ │ │ │ -00015f00: 4d50 494c 4529 202d 4445 5849 545f 434f MPILE) -DEXIT_CO │ │ │ │ │ -00015f10: 4445 3d30 202d 6320 7472 7565 2e63 0a0a DE=0 -c true.c.. │ │ │ │ │ -00015f20: 2020 2020 2066 616c 7365 2e6f 3a20 7472 false.o: tr │ │ │ │ │ -00015f30: 7565 2e63 0a20 2020 2020 2020 2020 2020 ue.c. │ │ │ │ │ -00015f40: 2020 2428 434f 4d50 494c 4529 202d 4445 $(COMPILE) -DE │ │ │ │ │ -00015f50: 5849 545f 434f 4445 3d31 202d 6320 7472 XIT_CODE=1 -c tr │ │ │ │ │ -00015f60: 7565 2e63 2026 2620 6d76 2074 7275 652e ue.c && mv true. │ │ │ │ │ -00015f70: 6f20 6661 6c73 652e 6f0a 0a20 2020 4173 o false.o.. As │ │ │ │ │ -00015f80: 2069 7420 7475 726e 7320 6f75 742c 2074 it turns out, t │ │ │ │ │ -00015f90: 6865 7265 2069 7320 616c 736f 2061 206d here is also a m │ │ │ │ │ -00015fa0: 7563 6820 6561 7369 6572 2077 6179 2074 uch easier way t │ │ │ │ │ -00015fb0: 6f20 646f 2074 6869 7320 7361 6d65 0a74 o do this same.t │ │ │ │ │ -00015fc0: 6173 6b2e 2020 536f 6d65 206f 6620 7468 ask. Some of th │ │ │ │ │ -00015fd0: 6520 6162 6f76 6520 7465 6368 6e69 7175 e above techniqu │ │ │ │ │ -00015fe0: 6520 6973 2075 7365 6675 6c20 656e 6f75 e is useful enou │ │ │ │ │ -00015ff0: 6768 2074 6861 7420 7765 2776 6520 6b65 gh that we've ke │ │ │ │ │ -00016000: 7074 2074 6865 0a65 7861 6d70 6c65 2069 pt the.example i │ │ │ │ │ -00016010: 6e20 7468 6520 6d61 6e75 616c 2e20 2048 n the manual. H │ │ │ │ │ -00016020: 6f77 6576 6572 2069 6620 796f 7520 7765 owever if you we │ │ │ │ │ -00016030: 7265 2074 6f20 6275 696c 6420 2774 7275 re to build 'tru │ │ │ │ │ -00016040: 6527 2061 6e64 2027 6661 6c73 6527 0a69 e' and 'false'.i │ │ │ │ │ -00016050: 6e20 7265 616c 206c 6966 652c 2079 6f75 n real life, you │ │ │ │ │ -00016060: 2077 6f75 6c64 2070 726f 6261 626c 7920 would probably │ │ │ │ │ -00016070: 7573 6520 7065 722d 7072 6f67 7261 6d20 use per-program │ │ │ │ │ -00016080: 636f 6d70 696c 6174 696f 6e20 666c 6167 compilation flag │ │ │ │ │ -00016090: 732c 206c 696b 650a 736f 3a0a 0a20 2020 s, like.so:.. │ │ │ │ │ -000160a0: 2020 6269 6e5f 5052 4f47 5241 4d53 203d bin_PROGRAMS = │ │ │ │ │ -000160b0: 2066 616c 7365 2074 7275 650a 0a20 2020 false true.. │ │ │ │ │ -000160c0: 2020 6661 6c73 655f 534f 5552 4345 5320 false_SOURCES │ │ │ │ │ -000160d0: 3d20 7472 7565 2e63 0a20 2020 2020 6661 = true.c. fa │ │ │ │ │ -000160e0: 6c73 655f 4350 5046 4c41 4753 203d 202d lse_CPPFLAGS = - │ │ │ │ │ -000160f0: 4445 5849 545f 434f 4445 3d31 0a0a 2020 DEXIT_CODE=1.. │ │ │ │ │ -00016100: 2020 2074 7275 655f 534f 5552 4345 5320 true_SOURCES │ │ │ │ │ -00016110: 3d20 7472 7565 2e63 0a20 2020 2020 7472 = true.c. tr │ │ │ │ │ -00016120: 7565 5f43 5050 464c 4147 5320 3d20 2d44 ue_CPPFLAGS = -D │ │ │ │ │ -00016130: 4558 4954 5f43 4f44 453d 300a 0a20 2020 EXIT_CODE=0.. │ │ │ │ │ -00016140: 496e 2074 6869 7320 6361 7365 2041 7574 In this case Aut │ │ │ │ │ -00016150: 6f6d 616b 6520 7769 6c6c 2063 6175 7365 omake will cause │ │ │ │ │ -00016160: 2027 7472 7565 2e63 2720 746f 2062 6520 'true.c' to be │ │ │ │ │ -00016170: 636f 6d70 696c 6564 2074 7769 6365 2c20 compiled twice, │ │ │ │ │ -00016180: 7769 7468 0a64 6966 6665 7265 6e74 2066 with.different f │ │ │ │ │ -00016190: 6c61 6773 2e20 2049 6e20 7468 6973 2069 lags. In this i │ │ │ │ │ -000161a0: 6e73 7461 6e63 652c 2074 6865 206e 616d nstance, the nam │ │ │ │ │ -000161b0: 6573 206f 6620 7468 6520 6f62 6a65 6374 es of the object │ │ │ │ │ -000161c0: 2066 696c 6573 2077 6f75 6c64 0a62 6520 files would.be │ │ │ │ │ -000161d0: 6368 6f73 656e 2062 7920 6175 746f 6d61 chosen by automa │ │ │ │ │ -000161e0: 6b65 3b20 7468 6579 2077 6f75 6c64 2062 ke; they would b │ │ │ │ │ -000161f0: 6520 2766 616c 7365 2d74 7275 652e 6f27 e 'false-true.o' │ │ │ │ │ -00016200: 2061 6e64 2027 7472 7565 2d74 7275 652e and 'true-true. │ │ │ │ │ -00016210: 6f27 2e0a 2854 6865 206e 616d 6520 6f66 o'..(The name of │ │ │ │ │ -00016220: 2074 6865 206f 626a 6563 7420 6669 6c65 the object file │ │ │ │ │ -00016230: 7320 7261 7265 6c79 206d 6174 7465 7273 s rarely matters │ │ │ │ │ -00016240: 2e29 0a0a 1f0a 4669 6c65 3a20 6175 746f .)....File: auto │ │ │ │ │ -00016250: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00016260: 204e 6f64 653a 2061 7574 6f6d 616b 6520 Node: automake │ │ │ │ │ -00016270: 496e 766f 6361 7469 6f6e 2c20 204e 6578 Invocation, Nex │ │ │ │ │ -00016280: 743a 2063 6f6e 6669 6775 7265 2c20 2050 t: configure, P │ │ │ │ │ -00016290: 7265 763a 2045 7861 6d70 6c65 732c 2020 rev: Examples, │ │ │ │ │ -000162a0: 5570 3a20 546f 700a 0a35 2043 7265 6174 Up: Top..5 Creat │ │ │ │ │ -000162b0: 696e 6720 6120 274d 616b 6566 696c 652e ing a 'Makefile. │ │ │ │ │ -000162c0: 696e 270a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a in'.************ │ │ │ │ │ -000162d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ -000162e0: 546f 2063 7265 6174 6520 616c 6c20 7468 To create all th │ │ │ │ │ -000162f0: 6520 274d 616b 6566 696c 652e 696e 2773 e 'Makefile.in's │ │ │ │ │ -00016300: 2066 6f72 2061 2070 6163 6b61 6765 2c20 for a package, │ │ │ │ │ -00016310: 7275 6e20 7468 6520 2761 7574 6f6d 616b run the 'automak │ │ │ │ │ -00016320: 6527 0a70 726f 6772 616d 2069 6e20 7468 e'.program in th │ │ │ │ │ -00016330: 6520 746f 7020 6c65 7665 6c20 6469 7265 e top level dire │ │ │ │ │ -00016340: 6374 6f72 792c 2077 6974 6820 6e6f 2061 ctory, with no a │ │ │ │ │ -00016350: 7267 756d 656e 7473 2e20 2027 6175 746f rguments. 'auto │ │ │ │ │ -00016360: 6d61 6b65 2720 7769 6c6c 0a61 7574 6f6d make' will.autom │ │ │ │ │ -00016370: 6174 6963 616c 6c79 2066 696e 6420 6561 atically find ea │ │ │ │ │ -00016380: 6368 2061 7070 726f 7072 6961 7465 2027 ch appropriate ' │ │ │ │ │ -00016390: 4d61 6b65 6669 6c65 2e61 6d27 2028 6279 Makefile.am' (by │ │ │ │ │ -000163a0: 2073 6361 6e6e 696e 670a 2763 6f6e 6669 scanning.'confi │ │ │ │ │ -000163b0: 6775 7265 2e61 6327 3b20 2a6e 6f74 6520 gure.ac'; *note │ │ │ │ │ -000163c0: 636f 6e66 6967 7572 653a 3a29 2061 6e64 configure::) and │ │ │ │ │ -000163d0: 2067 656e 6572 6174 6520 7468 6520 636f generate the co │ │ │ │ │ -000163e0: 7272 6573 706f 6e64 696e 670a 274d 616b rresponding.'Mak │ │ │ │ │ -000163f0: 6566 696c 652e 696e 272e 2020 4e6f 7465 efile.in'. Note │ │ │ │ │ -00016400: 2074 6861 7420 2761 7574 6f6d 616b 6527 that 'automake' │ │ │ │ │ -00016410: 2068 6173 2061 2072 6174 6865 7220 7369 has a rather si │ │ │ │ │ -00016420: 6d70 6c69 7374 6963 2076 6965 7720 6f66 mplistic view of │ │ │ │ │ -00016430: 0a77 6861 7420 636f 6e73 7469 7475 7465 .what constitute │ │ │ │ │ -00016440: 7320 6120 7061 636b 6167 653b 2069 7420 s a package; it │ │ │ │ │ -00016450: 6173 7375 6d65 7320 7468 6174 2061 2070 assumes that a p │ │ │ │ │ -00016460: 6163 6b61 6765 2068 6173 206f 6e6c 7920 ackage has only │ │ │ │ │ -00016470: 6f6e 650a 2763 6f6e 6669 6775 7265 2e61 one.'configure.a │ │ │ │ │ -00016480: 6327 2c20 6174 2074 6865 2074 6f70 2e20 c', at the top. │ │ │ │ │ -00016490: 2049 6620 796f 7572 2070 6163 6b61 6765 If your package │ │ │ │ │ -000164a0: 2068 6173 206d 756c 7469 706c 650a 2763 has multiple.'c │ │ │ │ │ -000164b0: 6f6e 6669 6775 7265 2e61 6327 732c 2074 onfigure.ac's, t │ │ │ │ │ -000164c0: 6865 6e20 796f 7520 6d75 7374 2072 756e hen you must run │ │ │ │ │ -000164d0: 2027 6175 746f 6d61 6b65 2720 696e 2065 'automake' in e │ │ │ │ │ -000164e0: 6163 6820 6469 7265 6374 6f72 7920 686f ach directory ho │ │ │ │ │ -000164f0: 6c64 696e 670a 6120 2763 6f6e 6669 6775 lding.a 'configu │ │ │ │ │ -00016500: 7265 2e61 6327 2e20 2028 416c 7465 726e re.ac'. (Altern │ │ │ │ │ -00016510: 6174 6976 656c 792c 2079 6f75 206d 6179 atively, you may │ │ │ │ │ -00016520: 2072 656c 7920 6f6e 2041 7574 6f63 6f6e rely on Autocon │ │ │ │ │ -00016530: 6627 730a 2761 7574 6f72 6563 6f6e 6627 f's.'autoreconf' │ │ │ │ │ -00016540: 2c20 7768 6963 6820 6973 2061 626c 6520 , which is able │ │ │ │ │ -00016550: 746f 2072 6563 7572 7365 2079 6f75 7220 to recurse your │ │ │ │ │ -00016560: 7061 636b 6167 6520 7472 6565 2061 6e64 package tree and │ │ │ │ │ -00016570: 2072 756e 0a27 6175 746f 6d61 6b65 2720 run.'automake' │ │ │ │ │ -00016580: 7768 6572 6520 6170 7072 6f70 7269 6174 where appropriat │ │ │ │ │ -00016590: 652e 290a 0a20 2020 596f 7520 6361 6e20 e.).. You can │ │ │ │ │ -000165a0: 6f70 7469 6f6e 616c 6c79 2067 6976 6520 optionally give │ │ │ │ │ -000165b0: 2761 7574 6f6d 616b 6527 2061 6e20 6172 'automake' an ar │ │ │ │ │ -000165c0: 6775 6d65 6e74 3b20 272e 616d 2720 6973 gument; '.am' is │ │ │ │ │ -000165d0: 2061 7070 656e 6465 6420 746f 0a74 6865 appended to.the │ │ │ │ │ -000165e0: 2061 7267 756d 656e 7420 616e 6420 7468 argument and th │ │ │ │ │ -000165f0: 6520 7265 7375 6c74 2069 7320 7573 6564 e result is used │ │ │ │ │ -00016600: 2061 7320 7468 6520 6e61 6d65 206f 6620 as the name of │ │ │ │ │ -00016610: 7468 6520 696e 7075 7420 6669 6c65 2e20 the input file. │ │ │ │ │ -00016620: 2054 6869 730a 6665 6174 7572 6520 6973 This.feature is │ │ │ │ │ -00016630: 2067 656e 6572 616c 6c79 206f 6e6c 7920 generally only │ │ │ │ │ -00016640: 7573 6564 2074 6f20 6175 746f 6d61 7469 used to automati │ │ │ │ │ -00016650: 6361 6c6c 7920 7265 6275 696c 6420 616e cally rebuild an │ │ │ │ │ -00016660: 206f 7574 2d6f 662d 6461 7465 0a27 4d61 out-of-date.'Ma │ │ │ │ │ -00016670: 6b65 6669 6c65 2e69 6e27 2e20 204e 6f74 kefile.in'. Not │ │ │ │ │ -00016680: 6520 7468 6174 2027 6175 746f 6d61 6b65 e that 'automake │ │ │ │ │ -00016690: 2720 6d75 7374 2061 6c77 6179 7320 6265 ' must always be │ │ │ │ │ -000166a0: 2072 756e 2066 726f 6d20 7468 6520 746f run from the to │ │ │ │ │ -000166b0: 706d 6f73 740a 6469 7265 6374 6f72 7920 pmost.directory │ │ │ │ │ -000166c0: 6f66 2061 2070 726f 6a65 6374 2c20 6576 of a project, ev │ │ │ │ │ -000166d0: 656e 2069 6620 6265 696e 6720 7573 6564 en if being used │ │ │ │ │ -000166e0: 2074 6f20 7265 6765 6e65 7261 7465 2074 to regenerate t │ │ │ │ │ -000166f0: 6865 0a27 4d61 6b65 6669 6c65 2e69 6e27 he.'Makefile.in' │ │ │ │ │ -00016700: 2069 6e20 736f 6d65 2073 7562 6469 7265 in some subdire │ │ │ │ │ -00016710: 6374 6f72 792e 2020 5468 6973 2069 7320 ctory. This is │ │ │ │ │ -00016720: 6e65 6365 7373 6172 7920 6265 6361 7573 necessary becaus │ │ │ │ │ -00016730: 650a 2761 7574 6f6d 616b 6527 206d 7573 e.'automake' mus │ │ │ │ │ -00016740: 7420 7363 616e 2027 636f 6e66 6967 7572 t scan 'configur │ │ │ │ │ -00016750: 652e 6163 272c 2061 6e64 2062 6563 6175 e.ac', and becau │ │ │ │ │ -00016760: 7365 2027 6175 746f 6d61 6b65 2720 7573 se 'automake' us │ │ │ │ │ -00016770: 6573 2074 6865 0a6b 6e6f 776c 6564 6765 es the.knowledge │ │ │ │ │ -00016780: 2074 6861 7420 6120 274d 616b 6566 696c that a 'Makefil │ │ │ │ │ -00016790: 652e 696e 2720 6973 2069 6e20 6120 7375 e.in' is in a su │ │ │ │ │ -000167a0: 6264 6972 6563 746f 7279 2074 6f20 6368 bdirectory to ch │ │ │ │ │ -000167b0: 616e 6765 2069 7473 0a62 6568 6176 696f ange its.behavio │ │ │ │ │ -000167c0: 7220 696e 2073 6f6d 6520 6361 7365 732e r in some cases. │ │ │ │ │ -000167d0: 0a0a 2020 2041 7574 6f6d 616b 6520 7769 .. Automake wi │ │ │ │ │ -000167e0: 6c6c 2072 756e 2027 6175 746f 636f 6e66 ll run 'autoconf │ │ │ │ │ -000167f0: 2720 746f 2073 6361 6e20 2763 6f6e 6669 ' to scan 'confi │ │ │ │ │ -00016800: 6775 7265 2e61 6327 2061 6e64 2069 7473 gure.ac' and its │ │ │ │ │ -00016810: 0a64 6570 656e 6465 6e63 6965 7320 2869 .dependencies (i │ │ │ │ │ -00016820: 2e65 2e2c 2027 6163 6c6f 6361 6c2e 6d34 .e., 'aclocal.m4 │ │ │ │ │ -00016830: 2720 616e 6420 616e 7920 696e 636c 7564 ' and any includ │ │ │ │ │ -00016840: 6564 2066 696c 6529 2c20 7468 6572 6566 ed file), theref │ │ │ │ │ -00016850: 6f72 650a 2761 7574 6f63 6f6e 6627 206d ore.'autoconf' m │ │ │ │ │ -00016860: 7573 7420 6265 2069 6e20 796f 7572 2027 ust be in your ' │ │ │ │ │ -00016870: 5041 5448 272e 2020 4966 2074 6865 7265 PATH'. If there │ │ │ │ │ -00016880: 2069 7320 616e 2027 4155 544f 434f 4e46 is an 'AUTOCONF │ │ │ │ │ -00016890: 2720 7661 7269 6162 6c65 0a69 6e20 796f ' variable.in yo │ │ │ │ │ -000168a0: 7572 2065 6e76 6972 6f6e 6d65 6e74 2069 ur environment i │ │ │ │ │ -000168b0: 7420 7769 6c6c 2062 6520 7573 6564 2069 t will be used i │ │ │ │ │ -000168c0: 6e73 7465 6164 206f 6620 2761 7574 6f63 nstead of 'autoc │ │ │ │ │ -000168d0: 6f6e 6627 2c20 7468 6973 2061 6c6c 6f77 onf', this allow │ │ │ │ │ -000168e0: 730a 796f 7520 746f 2073 656c 6563 7420 s.you to select │ │ │ │ │ -000168f0: 6120 7061 7274 6963 756c 6172 2076 6572 a particular ver │ │ │ │ │ -00016900: 7369 6f6e 206f 6620 4175 746f 636f 6e66 sion of Autoconf │ │ │ │ │ -00016910: 2e20 2042 7920 7468 6520 7761 792c 2064 . By the way, d │ │ │ │ │ -00016920: 6f6e 2774 0a6d 6973 756e 6465 7273 7461 on't.misundersta │ │ │ │ │ -00016930: 6e64 2074 6869 7320 7061 7261 6772 6170 nd this paragrap │ │ │ │ │ -00016940: 683a 2027 6175 746f 6d61 6b65 2720 7275 h: 'automake' ru │ │ │ │ │ -00016950: 6e73 2027 6175 746f 636f 6e66 2720 746f ns 'autoconf' to │ │ │ │ │ -00016960: 202a 7363 616e 2a20 796f 7572 0a27 636f *scan* your.'co │ │ │ │ │ -00016970: 6e66 6967 7572 652e 6163 272c 2074 6869 nfigure.ac', thi │ │ │ │ │ -00016980: 7320 776f 6e27 7420 6275 696c 6420 2763 s won't build 'c │ │ │ │ │ -00016990: 6f6e 6669 6775 7265 2720 616e 6420 796f onfigure' and yo │ │ │ │ │ -000169a0: 7520 7374 696c 6c20 6861 7665 2074 6f20 u still have to │ │ │ │ │ -000169b0: 7275 6e0a 2761 7574 6f63 6f6e 6627 2079 run.'autoconf' y │ │ │ │ │ -000169c0: 6f75 7273 656c 6620 666f 7220 7468 6973 ourself for this │ │ │ │ │ -000169d0: 2070 7572 706f 7365 2e0a 0a20 2020 2761 purpose... 'a │ │ │ │ │ -000169e0: 7574 6f6d 616b 6527 2061 6363 6570 7473 utomake' accepts │ │ │ │ │ -000169f0: 2074 6865 2066 6f6c 6c6f 7769 6e67 206f the following o │ │ │ │ │ -00016a00: 7074 696f 6e73 3a0a 0a27 2d61 270a 272d ptions:..'-a'.'- │ │ │ │ │ -00016a10: 2d61 6464 2d6d 6973 7369 6e67 270a 2020 -add-missing'. │ │ │ │ │ -00016a20: 2020 2041 7574 6f6d 616b 6520 7265 7175 Automake requ │ │ │ │ │ -00016a30: 6972 6573 2063 6572 7461 696e 2063 6f6d ires certain com │ │ │ │ │ -00016a40: 6d6f 6e20 6669 6c65 7320 746f 2065 7869 mon files to exi │ │ │ │ │ -00016a50: 7374 2069 6e20 6365 7274 6169 6e0a 2020 st in certain. │ │ │ │ │ -00016a60: 2020 2073 6974 7561 7469 6f6e 733b 2066 situations; f │ │ │ │ │ -00016a70: 6f72 2069 6e73 7461 6e63 652c 2027 636f or instance, 'co │ │ │ │ │ -00016a80: 6e66 6967 2e67 7565 7373 2720 6973 2072 nfig.guess' is r │ │ │ │ │ -00016a90: 6571 7569 7265 6420 6966 0a20 2020 2020 equired if. │ │ │ │ │ -00016aa0: 2763 6f6e 6669 6775 7265 2e61 6327 2069 'configure.ac' i │ │ │ │ │ -00016ab0: 6e76 6f6b 6573 2027 4143 5f43 414e 4f4e nvokes 'AC_CANON │ │ │ │ │ -00016ac0: 4943 414c 5f48 4f53 5427 2e20 2041 7574 ICAL_HOST'. Aut │ │ │ │ │ -00016ad0: 6f6d 616b 6520 6973 0a20 2020 2020 6469 omake is. di │ │ │ │ │ -00016ae0: 7374 7269 6275 7465 6420 7769 7468 2073 stributed with s │ │ │ │ │ -00016af0: 6576 6572 616c 206f 6620 7468 6573 6520 everal of these │ │ │ │ │ -00016b00: 6669 6c65 7320 282a 6e6f 7465 2041 7578 files (*note Aux │ │ │ │ │ -00016b10: 696c 6961 7279 0a20 2020 2020 5072 6f67 iliary. Prog │ │ │ │ │ -00016b20: 7261 6d73 3a3a 293b 2074 6869 7320 6f70 rams::); this op │ │ │ │ │ -00016b30: 7469 6f6e 2077 696c 6c20 6361 7573 6520 tion will cause │ │ │ │ │ -00016b40: 7468 6520 6d69 7373 696e 6720 6f6e 6573 the missing ones │ │ │ │ │ -00016b50: 2074 6f20 6265 0a20 2020 2020 6175 746f to be. auto │ │ │ │ │ -00016b60: 6d61 7469 6361 6c6c 7920 6164 6465 6420 matically added │ │ │ │ │ -00016b70: 746f 2074 6865 2070 6163 6b61 6765 2c20 to the package, │ │ │ │ │ -00016b80: 7768 656e 6576 6572 2070 6f73 7369 626c whenever possibl │ │ │ │ │ -00016b90: 652e 2020 496e 2067 656e 6572 616c 0a20 e. In general. │ │ │ │ │ -00016ba0: 2020 2020 6966 2041 7574 6f6d 616b 6520 if Automake │ │ │ │ │ -00016bb0: 7465 6c6c 7320 796f 7520 6120 6669 6c65 tells you a file │ │ │ │ │ -00016bc0: 2069 7320 6d69 7373 696e 672c 2074 7279 is missing, try │ │ │ │ │ -00016bd0: 2075 7369 6e67 2074 6869 7320 6f70 7469 using this opti │ │ │ │ │ -00016be0: 6f6e 2e20 2042 790a 2020 2020 2064 6566 on. By. def │ │ │ │ │ -00016bf0: 6175 6c74 2041 7574 6f6d 616b 6520 7472 ault Automake tr │ │ │ │ │ -00016c00: 6965 7320 746f 206d 616b 6520 6120 7379 ies to make a sy │ │ │ │ │ -00016c10: 6d62 6f6c 6963 206c 696e 6b20 706f 696e mbolic link poin │ │ │ │ │ -00016c20: 7469 6e67 2074 6f20 6974 7320 6f77 6e0a ting to its own. │ │ │ │ │ -00016c30: 2020 2020 2063 6f70 7920 6f66 2074 6865 copy of the │ │ │ │ │ -00016c40: 206d 6973 7369 6e67 2066 696c 653b 2074 missing file; t │ │ │ │ │ -00016c50: 6869 7320 6361 6e20 6265 2063 6861 6e67 his can be chang │ │ │ │ │ -00016c60: 6564 2077 6974 6820 272d 2d63 6f70 7927 ed with '--copy' │ │ │ │ │ -00016c70: 2e0a 0a20 2020 2020 4d61 6e79 206f 6620 ... Many of │ │ │ │ │ -00016c80: 7468 6520 706f 7465 6e74 6961 6c6c 792d the potentially- │ │ │ │ │ -00016c90: 6d69 7373 696e 6720 6669 6c65 7320 6172 missing files ar │ │ │ │ │ -00016ca0: 6520 636f 6d6d 6f6e 2073 6372 6970 7473 e common scripts │ │ │ │ │ -00016cb0: 2077 686f 7365 0a20 2020 2020 6c6f 6361 whose. loca │ │ │ │ │ -00016cc0: 7469 6f6e 206d 6179 2062 6520 7370 6563 tion may be spec │ │ │ │ │ -00016cd0: 6966 6965 6420 7669 6120 7468 6520 2741 ified via the 'A │ │ │ │ │ -00016ce0: 435f 434f 4e46 4947 5f41 5558 5f44 4952 C_CONFIG_AUX_DIR │ │ │ │ │ -00016cf0: 2720 6d61 6372 6f2e 0a20 2020 2020 5468 ' macro.. Th │ │ │ │ │ -00016d00: 6572 6566 6f72 652c 2027 4143 5f43 4f4e erefore, 'AC_CON │ │ │ │ │ -00016d10: 4649 475f 4155 585f 4449 5227 2773 2073 FIG_AUX_DIR''s s │ │ │ │ │ -00016d20: 6574 7469 6e67 2061 6666 6563 7473 2077 etting affects w │ │ │ │ │ -00016d30: 6865 7468 6572 2061 2066 696c 6520 6973 hether a file is │ │ │ │ │ -00016d40: 0a20 2020 2020 636f 6e73 6964 6572 6564 . considered │ │ │ │ │ -00016d50: 206d 6973 7369 6e67 2c20 616e 6420 7768 missing, and wh │ │ │ │ │ -00016d60: 6572 6520 7468 6520 6d69 7373 696e 6720 ere the missing │ │ │ │ │ -00016d70: 6669 6c65 2069 7320 6164 6465 6420 282a file is added (* │ │ │ │ │ -00016d80: 6e6f 7465 0a20 2020 2020 4f70 7469 6f6e note. Option │ │ │ │ │ -00016d90: 616c 3a3a 292e 0a0a 2020 2020 2049 6e20 al::)... In │ │ │ │ │ -00016da0: 736f 6d65 2073 7472 6963 746e 6573 7320 some strictness │ │ │ │ │ -00016db0: 6d6f 6465 732c 2061 6464 6974 696f 6e61 modes, additiona │ │ │ │ │ -00016dc0: 6c20 6669 6c65 7320 6172 6520 696e 7374 l files are inst │ │ │ │ │ -00016dd0: 616c 6c65 642c 2073 6565 202a 6e6f 7465 alled, see *note │ │ │ │ │ -00016de0: 0a20 2020 2020 476e 6974 733a 3a20 666f . Gnits:: fo │ │ │ │ │ -00016df0: 7220 6d6f 7265 2069 6e66 6f72 6d61 7469 r more informati │ │ │ │ │ -00016e00: 6f6e 2e0a 0a27 2d2d 6c69 6264 6972 3d44 on...'--libdir=D │ │ │ │ │ -00016e10: 4952 270a 2020 2020 204c 6f6f 6b20 666f IR'. Look fo │ │ │ │ │ -00016e20: 7220 4175 746f 6d61 6b65 2064 6174 6120 r Automake data │ │ │ │ │ -00016e30: 6669 6c65 7320 696e 2064 6972 6563 746f files in directo │ │ │ │ │ -00016e40: 7279 2044 4952 2069 6e73 7465 6164 206f ry DIR instead o │ │ │ │ │ -00016e50: 6620 696e 2074 6865 0a20 2020 2020 696e f in the. in │ │ │ │ │ -00016e60: 7374 616c 6c61 7469 6f6e 2064 6972 6563 stallation direc │ │ │ │ │ -00016e70: 746f 7279 2e20 2054 6869 7320 6973 2074 tory. This is t │ │ │ │ │ -00016e80: 7970 6963 616c 6c79 2075 7365 6420 666f ypically used fo │ │ │ │ │ -00016e90: 7220 6465 6275 6767 696e 672e 0a0a 272d r debugging...'- │ │ │ │ │ -00016ea0: 6327 0a27 2d2d 636f 7079 270a 2020 2020 c'.'--copy'. │ │ │ │ │ -00016eb0: 2057 6865 6e20 7573 6564 2077 6974 6820 When used with │ │ │ │ │ -00016ec0: 272d 2d61 6464 2d6d 6973 7369 6e67 272c '--add-missing', │ │ │ │ │ -00016ed0: 2063 6175 7365 7320 696e 7374 616c 6c65 causes installe │ │ │ │ │ -00016ee0: 6420 6669 6c65 7320 746f 2062 650a 2020 d files to be. │ │ │ │ │ -00016ef0: 2020 2063 6f70 6965 642e 2020 5468 6520 copied. The │ │ │ │ │ -00016f00: 6465 6661 756c 7420 6973 2074 6f20 6d61 default is to ma │ │ │ │ │ -00016f10: 6b65 2061 2073 796d 626f 6c69 6320 6c69 ke a symbolic li │ │ │ │ │ -00016f20: 6e6b 2e0a 0a27 2d2d 6379 676e 7573 270a nk...'--cygnus'. │ │ │ │ │ -00016f30: 2020 2020 2043 6175 7365 7320 7468 6520 Causes the │ │ │ │ │ -00016f40: 6765 6e65 7261 7465 6420 274d 616b 6566 generated 'Makef │ │ │ │ │ -00016f50: 696c 652e 696e 2773 2074 6f20 666f 6c6c ile.in's to foll │ │ │ │ │ -00016f60: 6f77 2043 7967 6e75 7320 7275 6c65 732c ow Cygnus rules, │ │ │ │ │ -00016f70: 2069 6e73 7465 6164 0a20 2020 2020 6f66 instead. of │ │ │ │ │ -00016f80: 2047 4e55 206f 7220 476e 6974 7320 7275 GNU or Gnits ru │ │ │ │ │ -00016f90: 6c65 732e 2020 466f 7220 6d6f 7265 2069 les. For more i │ │ │ │ │ -00016fa0: 6e66 6f72 6d61 7469 6f6e 2c20 7365 6520 nformation, see │ │ │ │ │ -00016fb0: 2a6e 6f74 6520 4379 676e 7573 3a3a 2e0a *note Cygnus::.. │ │ │ │ │ -00016fc0: 2020 2020 204e 6f74 6520 7468 6174 205f Note that _ │ │ │ │ │ -00016fd0: 7468 6973 206d 6f64 6520 6f66 206f 7065 this mode of ope │ │ │ │ │ -00016fe0: 7261 7469 6f6e 2069 7320 6465 7072 6563 ration is deprec │ │ │ │ │ -00016ff0: 6174 6564 2c20 616e 6420 7769 6c6c 2062 ated, and will b │ │ │ │ │ -00017000: 650a 2020 2020 2072 656d 6f76 6564 5f20 e. removed_ │ │ │ │ │ -00017010: 696e 2061 2066 7574 7572 6520 4175 746f in a future Auto │ │ │ │ │ -00017020: 6d61 6b65 2072 656c 6561 7365 2e0a 0a27 make release...' │ │ │ │ │ -00017030: 2d66 270a 272d 2d66 6f72 6365 2d6d 6973 -f'.'--force-mis │ │ │ │ │ -00017040: 7369 6e67 270a 2020 2020 2057 6865 6e20 sing'. When │ │ │ │ │ -00017050: 7573 6564 2077 6974 6820 272d 2d61 6464 used with '--add │ │ │ │ │ -00017060: 2d6d 6973 7369 6e67 272c 2063 6175 7365 -missing', cause │ │ │ │ │ -00017070: 7320 7374 616e 6461 7264 2066 696c 6573 s standard files │ │ │ │ │ -00017080: 2074 6f20 6265 0a20 2020 2020 7265 696e to be. rein │ │ │ │ │ -00017090: 7374 616c 6c65 6420 6576 656e 2069 6620 stalled even if │ │ │ │ │ -000170a0: 7468 6579 2061 6c72 6561 6479 2065 7869 they already exi │ │ │ │ │ -000170b0: 7374 2069 6e20 7468 6520 736f 7572 6365 st in the source │ │ │ │ │ -000170c0: 2074 7265 652e 2020 5468 6973 0a20 2020 tree. This. │ │ │ │ │ -000170d0: 2020 696e 766f 6c76 6573 2072 656d 6f76 involves remov │ │ │ │ │ -000170e0: 696e 6720 7468 6520 6669 6c65 2066 726f ing the file fro │ │ │ │ │ -000170f0: 6d20 7468 6520 736f 7572 6365 2074 7265 m the source tre │ │ │ │ │ -00017100: 6520 6265 666f 7265 2063 7265 6174 696e e before creatin │ │ │ │ │ -00017110: 6720 7468 650a 2020 2020 206e 6577 2073 g the. new s │ │ │ │ │ -00017120: 796d 6c69 6e6b 2028 6f72 2c20 7769 7468 ymlink (or, with │ │ │ │ │ -00017130: 2027 2d2d 636f 7079 272c 2063 6f70 7969 '--copy', copyi │ │ │ │ │ -00017140: 6e67 2074 6865 206e 6577 2066 696c 6529 ng the new file) │ │ │ │ │ -00017150: 2e0a 0a27 2d2d 666f 7265 6967 6e27 0a20 ...'--foreign'. │ │ │ │ │ -00017160: 2020 2020 5365 7420 7468 6520 676c 6f62 Set the glob │ │ │ │ │ -00017170: 616c 2073 7472 6963 746e 6573 7320 746f al strictness to │ │ │ │ │ -00017180: 2027 666f 7265 6967 6e27 2e20 2046 6f72 'foreign'. For │ │ │ │ │ -00017190: 206d 6f72 6520 696e 666f 726d 6174 696f more informatio │ │ │ │ │ -000171a0: 6e2c 2073 6565 0a20 2020 2020 2a6e 6f74 n, see. *not │ │ │ │ │ -000171b0: 6520 5374 7269 6374 6e65 7373 3a3a 2e0a e Strictness::.. │ │ │ │ │ -000171c0: 0a27 2d2d 676e 6974 7327 0a20 2020 2020 .'--gnits'. │ │ │ │ │ -000171d0: 5365 7420 7468 6520 676c 6f62 616c 2073 Set the global s │ │ │ │ │ -000171e0: 7472 6963 746e 6573 7320 746f 2027 676e trictness to 'gn │ │ │ │ │ -000171f0: 6974 7327 2e20 2046 6f72 206d 6f72 6520 its'. For more │ │ │ │ │ -00017200: 696e 666f 726d 6174 696f 6e2c 2073 6565 information, see │ │ │ │ │ -00017210: 0a20 2020 2020 2a6e 6f74 6520 476e 6974 . *note Gnit │ │ │ │ │ -00017220: 733a 3a2e 0a0a 272d 2d67 6e75 270a 2020 s::...'--gnu'. │ │ │ │ │ -00017230: 2020 2053 6574 2074 6865 2067 6c6f 6261 Set the globa │ │ │ │ │ -00017240: 6c20 7374 7269 6374 6e65 7373 2074 6f20 l strictness to │ │ │ │ │ -00017250: 2767 6e75 272e 2020 466f 7220 6d6f 7265 'gnu'. For more │ │ │ │ │ -00017260: 2069 6e66 6f72 6d61 7469 6f6e 2c20 7365 information, se │ │ │ │ │ -00017270: 650a 2020 2020 202a 6e6f 7465 2047 6e69 e. *note Gni │ │ │ │ │ -00017280: 7473 3a3a 2e20 2054 6869 7320 6973 2074 ts::. This is t │ │ │ │ │ -00017290: 6865 2064 6566 6175 6c74 2073 7472 6963 he default stric │ │ │ │ │ -000172a0: 746e 6573 732e 0a0a 272d 2d68 656c 7027 tness...'--help' │ │ │ │ │ -000172b0: 0a20 2020 2020 5072 696e 7420 6120 7375 . Print a su │ │ │ │ │ -000172c0: 6d6d 6172 7920 6f66 2074 6865 2063 6f6d mmary of the com │ │ │ │ │ -000172d0: 6d61 6e64 206c 696e 6520 6f70 7469 6f6e mand line option │ │ │ │ │ -000172e0: 7320 616e 6420 6578 6974 2e0a 0a27 2d69 s and exit...'-i │ │ │ │ │ -000172f0: 270a 272d 2d69 676e 6f72 652d 6465 7073 '.'--ignore-deps │ │ │ │ │ -00017300: 270a 2020 2020 2054 6869 7320 6469 7361 '. This disa │ │ │ │ │ -00017310: 626c 6573 2074 6865 2064 6570 656e 6465 bles the depende │ │ │ │ │ -00017320: 6e63 7920 7472 6163 6b69 6e67 2066 6561 ncy tracking fea │ │ │ │ │ -00017330: 7475 7265 2069 6e20 6765 6e65 7261 7465 ture in generate │ │ │ │ │ -00017340: 640a 2020 2020 2027 4d61 6b65 6669 6c65 d. 'Makefile │ │ │ │ │ -00017350: 2773 3b20 7365 6520 2a6e 6f74 6520 4465 's; see *note De │ │ │ │ │ -00017360: 7065 6e64 656e 6369 6573 3a3a 2e0a 0a27 pendencies::...' │ │ │ │ │ -00017370: 2d2d 696e 636c 7564 652d 6465 7073 270a --include-deps'. │ │ │ │ │ -00017380: 2020 2020 2054 6869 7320 656e 6162 6c65 This enable │ │ │ │ │ -00017390: 7320 7468 6520 6465 7065 6e64 656e 6379 s the dependency │ │ │ │ │ -000173a0: 2074 7261 636b 696e 6720 6665 6174 7572 tracking featur │ │ │ │ │ -000173b0: 652e 2020 5468 6973 2066 6561 7475 7265 e. This feature │ │ │ │ │ -000173c0: 2069 730a 2020 2020 2065 6e61 626c 6564 is. enabled │ │ │ │ │ -000173d0: 2062 7920 6465 6661 756c 742e 2020 5468 by default. Th │ │ │ │ │ -000173e0: 6973 206f 7074 696f 6e20 6973 2070 726f is option is pro │ │ │ │ │ -000173f0: 7669 6465 6420 666f 7220 6869 7374 6f72 vided for histor │ │ │ │ │ -00017400: 6963 616c 2072 6561 736f 6e73 0a20 2020 ical reasons. │ │ │ │ │ -00017410: 2020 6f6e 6c79 2061 6e64 2070 726f 6261 only and proba │ │ │ │ │ -00017420: 626c 7920 7368 6f75 6c64 206e 6f74 2062 bly should not b │ │ │ │ │ -00017430: 6520 7573 6564 2e0a 0a27 2d2d 6e6f 2d66 e used...'--no-f │ │ │ │ │ -00017440: 6f72 6365 270a 2020 2020 204f 7264 696e orce'. Ordin │ │ │ │ │ -00017450: 6172 696c 7920 2761 7574 6f6d 616b 6527 arily 'automake' │ │ │ │ │ -00017460: 2063 7265 6174 6573 2061 6c6c 2027 4d61 creates all 'Ma │ │ │ │ │ -00017470: 6b65 6669 6c65 2e69 6e27 7320 6d65 6e74 kefile.in's ment │ │ │ │ │ -00017480: 696f 6e65 6420 696e 0a20 2020 2020 2763 ioned in. 'c │ │ │ │ │ -00017490: 6f6e 6669 6775 7265 2e61 6327 2e20 2054 onfigure.ac'. T │ │ │ │ │ -000174a0: 6869 7320 6f70 7469 6f6e 2063 6175 7365 his option cause │ │ │ │ │ -000174b0: 7320 6974 2074 6f20 6f6e 6c79 2075 7064 s it to only upd │ │ │ │ │ -000174c0: 6174 6520 7468 6f73 650a 2020 2020 2027 ate those. ' │ │ │ │ │ -000174d0: 4d61 6b65 6669 6c65 2e69 6e27 7320 7468 Makefile.in's th │ │ │ │ │ -000174e0: 6174 2061 7265 206f 7574 206f 6620 6461 at are out of da │ │ │ │ │ -000174f0: 7465 2077 6974 6820 7265 7370 6563 7420 te with respect │ │ │ │ │ -00017500: 746f 206f 6e65 206f 6620 7468 6569 720a to one of their. │ │ │ │ │ -00017510: 2020 2020 2064 6570 656e 6465 6e74 732e dependents. │ │ │ │ │ -00017520: 0a0a 272d 6f20 4449 5227 0a27 2d2d 6f75 ..'-o DIR'.'--ou │ │ │ │ │ -00017530: 7470 7574 2d64 6972 3d44 4952 270a 2020 tput-dir=DIR'. │ │ │ │ │ -00017540: 2020 2050 7574 2074 6865 2067 656e 6572 Put the gener │ │ │ │ │ -00017550: 6174 6564 2027 4d61 6b65 6669 6c65 2e69 ated 'Makefile.i │ │ │ │ │ -00017560: 6e27 2069 6e20 7468 6520 6469 7265 6374 n' in the direct │ │ │ │ │ -00017570: 6f72 7920 4449 522e 2020 4f72 6469 6e61 ory DIR. Ordina │ │ │ │ │ -00017580: 7269 6c79 0a20 2020 2020 6561 6368 2027 rily. each ' │ │ │ │ │ -00017590: 4d61 6b65 6669 6c65 2e69 6e27 2069 7320 Makefile.in' is │ │ │ │ │ -000175a0: 6372 6561 7465 6420 696e 2074 6865 2064 created in the d │ │ │ │ │ -000175b0: 6972 6563 746f 7279 206f 6620 7468 6520 irectory of the │ │ │ │ │ -000175c0: 636f 7272 6573 706f 6e64 696e 670a 2020 corresponding. │ │ │ │ │ -000175d0: 2020 2027 4d61 6b65 6669 6c65 2e61 6d27 'Makefile.am' │ │ │ │ │ -000175e0: 2e20 2054 6869 7320 6f70 7469 6f6e 2069 . This option i │ │ │ │ │ -000175f0: 7320 6465 7072 6563 6174 6564 2061 6e64 s deprecated and │ │ │ │ │ -00017600: 2077 696c 6c20 6265 2072 656d 6f76 6564 will be removed │ │ │ │ │ -00017610: 2069 6e20 610a 2020 2020 2066 7574 7572 in a. futur │ │ │ │ │ -00017620: 6520 7265 6c65 6173 652e 0a0a 272d 7627 e release...'-v' │ │ │ │ │ -00017630: 0a27 2d2d 7665 7262 6f73 6527 0a20 2020 .'--verbose'. │ │ │ │ │ -00017640: 2020 4361 7573 6520 4175 746f 6d61 6b65 Cause Automake │ │ │ │ │ -00017650: 2074 6f20 7072 696e 7420 696e 666f 726d to print inform │ │ │ │ │ -00017660: 6174 696f 6e20 6162 6f75 7420 7768 6963 ation about whic │ │ │ │ │ -00017670: 6820 6669 6c65 7320 6172 6520 6265 696e h files are bein │ │ │ │ │ -00017680: 670a 2020 2020 2072 6561 6420 6f72 2063 g. read or c │ │ │ │ │ -00017690: 7265 6174 6564 2e0a 0a27 2d2d 7665 7273 reated...'--vers │ │ │ │ │ -000176a0: 696f 6e27 0a20 2020 2020 5072 696e 7420 ion'. Print │ │ │ │ │ -000176b0: 7468 6520 7665 7273 696f 6e20 6e75 6d62 the version numb │ │ │ │ │ -000176c0: 6572 206f 6620 4175 746f 6d61 6b65 2061 er of Automake a │ │ │ │ │ -000176d0: 6e64 2065 7869 742e 0a0a 272d 5720 4341 nd exit...'-W CA │ │ │ │ │ -000176e0: 5445 474f 5259 270a 272d 2d77 6172 6e69 TEGORY'.'--warni │ │ │ │ │ -000176f0: 6e67 733d 4341 5445 474f 5259 270a 2020 ngs=CATEGORY'. │ │ │ │ │ -00017700: 2020 204f 7574 7075 7420 7761 726e 696e Output warnin │ │ │ │ │ -00017710: 6773 2066 616c 6c69 6e67 2069 6e20 4341 gs falling in CA │ │ │ │ │ -00017720: 5445 474f 5259 2e20 2043 4154 4547 4f52 TEGORY. CATEGOR │ │ │ │ │ -00017730: 5920 6361 6e20 6265 206f 6e65 206f 663a Y can be one of: │ │ │ │ │ -00017740: 0a20 2020 2020 2767 6e75 270a 2020 2020 . 'gnu'. │ │ │ │ │ -00017750: 2020 2020 2020 7761 726e 696e 6773 2072 warnings r │ │ │ │ │ -00017760: 656c 6174 6564 2074 6f20 7468 6520 474e elated to the GN │ │ │ │ │ -00017770: 5520 436f 6469 6e67 2053 7461 6e64 6172 U Coding Standar │ │ │ │ │ -00017780: 6473 2028 2a6e 6f74 650a 2020 2020 2020 ds (*note. │ │ │ │ │ -00017790: 2020 2020 2873 7461 6e64 6172 6473 2954 (standards)T │ │ │ │ │ -000177a0: 6f70 3a3a 292e 0a20 2020 2020 276f 6273 op::).. 'obs │ │ │ │ │ -000177b0: 6f6c 6574 6527 0a20 2020 2020 2020 2020 olete'. │ │ │ │ │ -000177c0: 206f 6273 6f6c 6574 6520 6665 6174 7572 obsolete featur │ │ │ │ │ -000177d0: 6573 206f 7220 636f 6e73 7472 7563 7469 es or constructi │ │ │ │ │ -000177e0: 6f6e 730a 2020 2020 2027 6f76 6572 7269 ons. 'overri │ │ │ │ │ -000177f0: 6465 270a 2020 2020 2020 2020 2020 7573 de'. us │ │ │ │ │ -00017800: 6572 2072 6564 6566 696e 6974 696f 6e73 er redefinitions │ │ │ │ │ -00017810: 206f 6620 4175 746f 6d61 6b65 2072 756c of Automake rul │ │ │ │ │ -00017820: 6573 206f 7220 7661 7269 6162 6c65 730a es or variables. │ │ │ │ │ -00017830: 2020 2020 2027 706f 7274 6162 696c 6974 'portabilit │ │ │ │ │ -00017840: 7927 0a20 2020 2020 2020 2020 2070 6f72 y'. por │ │ │ │ │ -00017850: 7461 6269 6c69 7479 2069 7373 7565 7320 tability issues │ │ │ │ │ -00017860: 2865 2e67 2e2c 2075 7365 206f 6620 276d (e.g., use of 'm │ │ │ │ │ -00017870: 616b 6527 2066 6561 7475 7265 7320 7468 ake' features th │ │ │ │ │ -00017880: 6174 2061 7265 0a20 2020 2020 2020 2020 at are. │ │ │ │ │ -00017890: 206b 6e6f 776e 2074 6f20 6265 206e 6f74 known to be not │ │ │ │ │ -000178a0: 2070 6f72 7461 626c 6529 0a20 2020 2020 portable). │ │ │ │ │ -000178b0: 2765 7874 7261 2d70 6f72 7461 6269 6c69 'extra-portabili │ │ │ │ │ -000178c0: 7479 270a 2020 2020 2020 2020 2020 6578 ty'. ex │ │ │ │ │ -000178d0: 7472 6120 706f 7274 6162 696c 6974 7920 tra portability │ │ │ │ │ -000178e0: 6973 7375 6573 2072 656c 6174 6564 2074 issues related t │ │ │ │ │ -000178f0: 6f20 6f62 7363 7572 6520 746f 6f6c 732e o obscure tools. │ │ │ │ │ -00017900: 2020 4f6e 650a 2020 2020 2020 2020 2020 One. │ │ │ │ │ -00017910: 6578 616d 706c 6520 6f66 2073 7563 6820 example of such │ │ │ │ │ -00017920: 6120 746f 6f6c 2069 7320 7468 6520 4d69 a tool is the Mi │ │ │ │ │ -00017930: 6372 6f73 6f66 7420 276c 6962 2720 6172 crosoft 'lib' ar │ │ │ │ │ -00017940: 6368 6976 6572 2e0a 2020 2020 2027 7379 chiver.. 'sy │ │ │ │ │ -00017950: 6e74 6178 270a 2020 2020 2020 2020 2020 ntax'. │ │ │ │ │ -00017960: 7765 6972 6420 7379 6e74 6178 2c20 756e weird syntax, un │ │ │ │ │ -00017970: 7573 6564 2076 6172 6961 626c 6573 2c20 used variables, │ │ │ │ │ -00017980: 7479 706f 730a 2020 2020 2027 756e 7375 typos. 'unsu │ │ │ │ │ -00017990: 7070 6f72 7465 6427 0a20 2020 2020 2020 pported'. │ │ │ │ │ -000179a0: 2020 2075 6e73 7570 706f 7274 6564 206f unsupported o │ │ │ │ │ -000179b0: 7220 696e 636f 6d70 6c65 7465 2066 6561 r incomplete fea │ │ │ │ │ -000179c0: 7475 7265 730a 2020 2020 2027 616c 6c27 tures. 'all' │ │ │ │ │ -000179d0: 0a20 2020 2020 2020 2020 2061 6c6c 2074 . all t │ │ │ │ │ -000179e0: 6865 2077 6172 6e69 6e67 730a 2020 2020 he warnings. │ │ │ │ │ -000179f0: 2027 6e6f 6e65 270a 2020 2020 2020 2020 'none'. │ │ │ │ │ -00017a00: 2020 7475 726e 206f 6666 2061 6c6c 2074 turn off all t │ │ │ │ │ -00017a10: 6865 2077 6172 6e69 6e67 730a 2020 2020 he warnings. │ │ │ │ │ -00017a20: 2027 6572 726f 7227 0a20 2020 2020 2020 'error'. │ │ │ │ │ -00017a30: 2020 2074 7265 6174 2077 6172 6e69 6e67 treat warning │ │ │ │ │ -00017a40: 7320 6173 2065 7272 6f72 730a 0a20 2020 s as errors.. │ │ │ │ │ -00017a50: 2020 4120 6361 7465 676f 7279 2063 616e A category can │ │ │ │ │ -00017a60: 2062 6520 7475 726e 6564 206f 6666 2062 be turned off b │ │ │ │ │ -00017a70: 7920 7072 6566 6978 696e 6720 6974 7320 y prefixing its │ │ │ │ │ -00017a80: 6e61 6d65 2077 6974 6820 276e 6f2d 272e name with 'no-'. │ │ │ │ │ -00017a90: 2020 466f 720a 2020 2020 2069 6e73 7461 For. insta │ │ │ │ │ -00017aa0: 6e63 652c 2027 2d57 6e6f 2d73 796e 7461 nce, '-Wno-synta │ │ │ │ │ -00017ab0: 7827 2077 696c 6c20 6869 6465 2074 6865 x' will hide the │ │ │ │ │ -00017ac0: 2077 6172 6e69 6e67 7320 6162 6f75 7420 warnings about │ │ │ │ │ -00017ad0: 756e 7573 6564 0a20 2020 2020 7661 7269 unused. vari │ │ │ │ │ -00017ae0: 6162 6c65 732e 0a0a 2020 2020 2054 6865 ables... The │ │ │ │ │ -00017af0: 2063 6174 6567 6f72 6965 7320 6f75 7470 categories outp │ │ │ │ │ -00017b00: 7574 2062 7920 6465 6661 756c 7420 6172 ut by default ar │ │ │ │ │ -00017b10: 6520 2773 796e 7461 7827 2061 6e64 2027 e 'syntax' and ' │ │ │ │ │ -00017b20: 756e 7375 7070 6f72 7465 6427 2e0a 2020 unsupported'.. │ │ │ │ │ -00017b30: 2020 2041 6464 6974 696f 6e61 6c6c 792c Additionally, │ │ │ │ │ -00017b40: 2027 676e 7527 2061 6e64 2027 706f 7274 'gnu' and 'port │ │ │ │ │ -00017b50: 6162 696c 6974 7927 2061 7265 2065 6e61 ability' are ena │ │ │ │ │ -00017b60: 626c 6564 2069 6e20 272d 2d67 6e75 2720 bled in '--gnu' │ │ │ │ │ -00017b70: 616e 640a 2020 2020 2027 2d2d 676e 6974 and. '--gnit │ │ │ │ │ -00017b80: 7327 2073 7472 6963 746e 6573 732e 2020 s' strictness. │ │ │ │ │ -00017b90: 4f6e 2074 6865 206f 7468 6572 2068 616e On the other han │ │ │ │ │ -00017ba0: 642c 2074 6865 2027 7369 6c65 6e74 2d72 d, the 'silent-r │ │ │ │ │ -00017bb0: 756c 6573 270a 2020 2020 206f 7074 696f ules'. optio │ │ │ │ │ -00017bc0: 6e73 2028 2a6e 6f74 6520 4f70 7469 6f6e ns (*note Option │ │ │ │ │ -00017bd0: 733a 3a29 2074 7572 6e73 206f 6666 2070 s::) turns off p │ │ │ │ │ -00017be0: 6f72 7461 6269 6c69 7479 2077 6172 6e69 ortability warni │ │ │ │ │ -00017bf0: 6e67 7320 6162 6f75 740a 2020 2020 2072 ngs about. r │ │ │ │ │ -00017c00: 6563 7572 7369 7665 2076 6172 6961 626c ecursive variabl │ │ │ │ │ -00017c10: 6520 6578 7061 6e73 696f 6e73 2e0a 0a20 e expansions... │ │ │ │ │ -00017c20: 2020 2020 5475 726e 696e 6720 6f66 6620 Turning off │ │ │ │ │ -00017c30: 2770 6f72 7461 6269 6c69 7479 2720 7769 'portability' wi │ │ │ │ │ -00017c40: 6c6c 2061 6c73 6f20 7475 726e 206f 6666 ll also turn off │ │ │ │ │ -00017c50: 2027 6578 7472 612d 706f 7274 6162 696c 'extra-portabil │ │ │ │ │ -00017c60: 6974 7927 2c0a 2020 2020 2061 6e64 2073 ity',. and s │ │ │ │ │ -00017c70: 696d 696c 6172 6c79 2074 7572 6e69 6e67 imilarly turning │ │ │ │ │ -00017c80: 206f 6e20 2765 7874 7261 2d70 6f72 7461 on 'extra-porta │ │ │ │ │ -00017c90: 6269 6c69 7479 2720 7769 6c6c 2061 6c73 bility' will als │ │ │ │ │ -00017ca0: 6f20 7475 726e 206f 6e0a 2020 2020 2027 o turn on. ' │ │ │ │ │ -00017cb0: 706f 7274 6162 696c 6974 7927 2e20 2048 portability'. H │ │ │ │ │ -00017cc0: 6f77 6576 6572 2c20 7475 726e 696e 6720 owever, turning │ │ │ │ │ -00017cd0: 6f6e 2027 706f 7274 6162 696c 6974 7927 on 'portability' │ │ │ │ │ -00017ce0: 206f 7220 7475 726e 696e 6720 6f66 660a or turning off. │ │ │ │ │ -00017cf0: 2020 2020 2027 6578 7472 612d 706f 7274 'extra-port │ │ │ │ │ -00017d00: 6162 696c 6974 7927 2077 696c 6c20 6e6f ability' will no │ │ │ │ │ -00017d10: 7420 6166 6665 6374 2074 6865 206f 7468 t affect the oth │ │ │ │ │ -00017d20: 6572 2063 6174 6567 6f72 792e 0a0a 2020 er category... │ │ │ │ │ -00017d30: 2020 2054 6865 2065 6e76 6972 6f6e 6d65 The environme │ │ │ │ │ -00017d40: 6e74 2076 6172 6961 626c 6520 2757 4152 nt variable 'WAR │ │ │ │ │ -00017d50: 4e49 4e47 5327 2063 616e 2063 6f6e 7461 NINGS' can conta │ │ │ │ │ -00017d60: 696e 2061 2063 6f6d 6d61 2073 6570 6172 in a comma separ │ │ │ │ │ -00017d70: 6174 6564 0a20 2020 2020 6c69 7374 206f ated. list o │ │ │ │ │ -00017d80: 6620 6361 7465 676f 7269 6573 2074 6f20 f categories to │ │ │ │ │ -00017d90: 656e 6162 6c65 2e20 2049 7420 7769 6c6c enable. It will │ │ │ │ │ -00017da0: 2062 6520 7461 6b65 6e20 696e 746f 2061 be taken into a │ │ │ │ │ -00017db0: 6363 6f75 6e74 2062 6566 6f72 650a 2020 ccount before. │ │ │ │ │ -00017dc0: 2020 2074 6865 2063 6f6d 6d61 6e64 2d6c the command-l │ │ │ │ │ -00017dd0: 696e 6520 7377 6974 6368 6573 2c20 7468 ine switches, th │ │ │ │ │ -00017de0: 6973 2077 6179 2027 2d57 6e6f 6e65 2720 is way '-Wnone' │ │ │ │ │ -00017df0: 7769 6c6c 2061 6c73 6f20 6967 6e6f 7265 will also ignore │ │ │ │ │ -00017e00: 2061 6e79 0a20 2020 2020 7761 726e 696e any. warnin │ │ │ │ │ -00017e10: 6720 6361 7465 676f 7279 2065 6e61 626c g category enabl │ │ │ │ │ -00017e20: 6564 2062 7920 2757 4152 4e49 4e47 5327 ed by 'WARNINGS' │ │ │ │ │ -00017e30: 2e20 2054 6869 7320 7661 7269 6162 6c65 . This variable │ │ │ │ │ -00017e40: 2069 7320 616c 736f 2075 7365 640a 2020 is also used. │ │ │ │ │ -00017e50: 2020 2062 7920 6f74 6865 7220 746f 6f6c by other tool │ │ │ │ │ -00017e60: 7320 6c69 6b65 2027 6175 746f 636f 6e66 s like 'autoconf │ │ │ │ │ -00017e70: 273b 2075 6e6b 6e6f 776e 2063 6174 6567 '; unknown categ │ │ │ │ │ -00017e80: 6f72 6965 7320 6172 6520 6967 6e6f 7265 ories are ignore │ │ │ │ │ -00017e90: 6420 666f 720a 2020 2020 2074 6869 7320 d for. this │ │ │ │ │ -00017ea0: 7265 6173 6f6e 2e0a 0a20 2020 4966 2074 reason... If t │ │ │ │ │ -00017eb0: 6865 2065 6e76 6972 6f6e 6d65 6e74 2076 he environment v │ │ │ │ │ -00017ec0: 6172 6961 626c 6520 2741 5554 4f4d 414b ariable 'AUTOMAK │ │ │ │ │ -00017ed0: 455f 4a4f 4253 2720 636f 6e74 6169 6e73 E_JOBS' contains │ │ │ │ │ -00017ee0: 2061 2070 6f73 6974 6976 650a 6e75 6d62 a positive.numb │ │ │ │ │ -00017ef0: 6572 2c20 6974 2069 7320 7461 6b65 6e20 er, it is taken │ │ │ │ │ -00017f00: 6173 2074 6865 206d 6178 696d 756d 206e as the maximum n │ │ │ │ │ -00017f10: 756d 6265 7220 6f66 2050 6572 6c20 7468 umber of Perl th │ │ │ │ │ -00017f20: 7265 6164 7320 746f 2075 7365 2069 6e0a reads to use in. │ │ │ │ │ -00017f30: 2761 7574 6f6d 616b 6527 2066 6f72 2067 'automake' for g │ │ │ │ │ -00017f40: 656e 6572 6174 696e 6720 6d75 6c74 6970 enerating multip │ │ │ │ │ -00017f50: 6c65 2027 4d61 6b65 6669 6c65 2e69 6e27 le 'Makefile.in' │ │ │ │ │ -00017f60: 2066 696c 6573 2063 6f6e 6375 7272 656e files concurren │ │ │ │ │ -00017f70: 746c 792e 0a54 6869 7320 6973 2061 6e20 tly..This is an │ │ │ │ │ -00017f80: 6578 7065 7269 6d65 6e74 616c 2066 6561 experimental fea │ │ │ │ │ -00017f90: 7475 7265 2e0a 0a1f 0a46 696c 653a 2061 ture.....File: a │ │ │ │ │ -00017fa0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -00017fb0: 6f2c 2020 4e6f 6465 3a20 636f 6e66 6967 o, Node: config │ │ │ │ │ -00017fc0: 7572 652c 2020 4e65 7874 3a20 4469 7265 ure, Next: Dire │ │ │ │ │ -00017fd0: 6374 6f72 6965 732c 2020 5072 6576 3a20 ctories, Prev: │ │ │ │ │ -00017fe0: 6175 746f 6d61 6b65 2049 6e76 6f63 6174 automake Invocat │ │ │ │ │ -00017ff0: 696f 6e2c 2020 5570 3a20 546f 700a 0a36 ion, Up: Top..6 │ │ │ │ │ -00018000: 2053 6361 6e6e 696e 6720 2763 6f6e 6669 Scanning 'confi │ │ │ │ │ -00018010: 6775 7265 2e61 6327 2c20 7573 696e 6720 gure.ac', using │ │ │ │ │ -00018020: 2761 636c 6f63 616c 270a 2a2a 2a2a 2a2a 'aclocal'.****** │ │ │ │ │ +00015970: 3d3d 3d3d 3d0a 0a48 6572 6520 6973 2061 =====..Here is a │ │ │ │ │ +00015980: 6e6f 7468 6572 2c20 7472 6963 6b69 6572 nother, trickier │ │ │ │ │ +00015990: 2065 7861 6d70 6c65 2e20 2049 7420 7368 example. It sh │ │ │ │ │ +000159a0: 6f77 7320 686f 7720 746f 2067 656e 6572 ows how to gener │ │ │ │ │ +000159b0: 6174 6520 7477 6f0a 7072 6f67 7261 6d73 ate two.programs │ │ │ │ │ +000159c0: 2028 2774 7275 6527 2061 6e64 2027 6661 ('true' and 'fa │ │ │ │ │ +000159d0: 6c73 6527 2920 6672 6f6d 2074 6865 2073 lse') from the s │ │ │ │ │ +000159e0: 616d 6520 736f 7572 6365 2066 696c 6520 ame source file │ │ │ │ │ +000159f0: 2827 7472 7565 2e63 2729 2e20 2054 6865 ('true.c'). The │ │ │ │ │ +00015a00: 0a64 6966 6669 6375 6c74 2070 6172 7420 .difficult part │ │ │ │ │ +00015a10: 6973 2074 6861 7420 6561 6368 2063 6f6d is that each com │ │ │ │ │ +00015a20: 7069 6c61 7469 6f6e 206f 6620 2774 7275 pilation of 'tru │ │ │ │ │ +00015a30: 652e 6327 2072 6571 7569 7265 7320 6469 e.c' requires di │ │ │ │ │ +00015a40: 6666 6572 656e 740a 2763 7070 2720 666c fferent.'cpp' fl │ │ │ │ │ +00015a50: 6167 732e 0a0a 2020 2020 2062 696e 5f50 ags... bin_P │ │ │ │ │ +00015a60: 524f 4752 414d 5320 3d20 7472 7565 2066 ROGRAMS = true f │ │ │ │ │ +00015a70: 616c 7365 0a20 2020 2020 6661 6c73 655f alse. false_ │ │ │ │ │ +00015a80: 534f 5552 4345 5320 3d0a 2020 2020 2066 SOURCES =. f │ │ │ │ │ +00015a90: 616c 7365 5f4c 4441 4444 203d 2066 616c alse_LDADD = fal │ │ │ │ │ +00015aa0: 7365 2e6f 0a0a 2020 2020 2074 7275 652e se.o.. true. │ │ │ │ │ +00015ab0: 6f3a 2074 7275 652e 630a 2020 2020 2020 o: true.c. │ │ │ │ │ +00015ac0: 2020 2020 2020 2024 2843 4f4d 5049 4c45 $(COMPILE │ │ │ │ │ +00015ad0: 2920 2d44 4558 4954 5f43 4f44 453d 3020 ) -DEXIT_CODE=0 │ │ │ │ │ +00015ae0: 2d63 2074 7275 652e 630a 0a20 2020 2020 -c true.c.. │ │ │ │ │ +00015af0: 6661 6c73 652e 6f3a 2074 7275 652e 630a false.o: true.c. │ │ │ │ │ +00015b00: 2020 2020 2020 2020 2020 2020 2024 2843 $(C │ │ │ │ │ +00015b10: 4f4d 5049 4c45 2920 2d44 4558 4954 5f43 OMPILE) -DEXIT_C │ │ │ │ │ +00015b20: 4f44 453d 3120 2d6f 2066 616c 7365 2e6f ODE=1 -o false.o │ │ │ │ │ +00015b30: 202d 6320 7472 7565 2e63 0a0a 2020 204e -c true.c.. N │ │ │ │ │ +00015b40: 6f74 6520 7468 6174 2074 6865 7265 2069 ote that there i │ │ │ │ │ +00015b50: 7320 6e6f 2027 7472 7565 5f53 4f55 5243 s no 'true_SOURC │ │ │ │ │ +00015b60: 4553 2720 6465 6669 6e69 7469 6f6e 2e20 ES' definition. │ │ │ │ │ +00015b70: 2041 7574 6f6d 616b 6520 7769 6c6c 0a69 Automake will.i │ │ │ │ │ +00015b80: 6d70 6c69 6369 746c 7920 6173 7375 6d65 mplicitly assume │ │ │ │ │ +00015b90: 2074 6861 7420 7468 6572 6520 6973 2061 that there is a │ │ │ │ │ +00015ba0: 2073 6f75 7263 6520 6669 6c65 206e 616d source file nam │ │ │ │ │ +00015bb0: 6564 2027 7472 7565 2e63 2720 282a 6e6f ed 'true.c' (*no │ │ │ │ │ +00015bc0: 7465 0a44 6566 6175 6c74 205f 534f 5552 te.Default _SOUR │ │ │ │ │ +00015bd0: 4345 533a 3a29 2c20 616e 6420 6465 6669 CES::), and defi │ │ │ │ │ +00015be0: 6e65 2072 756c 6573 2074 6f20 636f 6d70 ne rules to comp │ │ │ │ │ +00015bf0: 696c 6520 2774 7275 652e 6f27 2061 6e64 ile 'true.o' and │ │ │ │ │ +00015c00: 206c 696e 6b0a 2774 7275 6527 2e20 2054 link.'true'. T │ │ │ │ │ +00015c10: 6865 2027 7472 7565 2e6f 3a20 7472 7565 he 'true.o: true │ │ │ │ │ +00015c20: 2e63 2720 7275 6c65 2073 7570 706c 6965 .c' rule supplie │ │ │ │ │ +00015c30: 6420 6279 2074 6865 2061 626f 7665 2027 d by the above ' │ │ │ │ │ +00015c40: 4d61 6b65 6669 6c65 2e61 6d27 2c0a 7769 Makefile.am',.wi │ │ │ │ │ +00015c50: 6c6c 206f 7665 7272 6964 6520 7468 6520 ll override the │ │ │ │ │ +00015c60: 4175 746f 6d61 6b65 2067 656e 6572 6174 Automake generat │ │ │ │ │ +00015c70: 6564 2072 756c 6520 746f 2062 7569 6c64 ed rule to build │ │ │ │ │ +00015c80: 2027 7472 7565 2e6f 272e 0a0a 2020 2027 'true.o'... ' │ │ │ │ │ +00015c90: 6661 6c73 655f 534f 5552 4345 5327 2069 false_SOURCES' i │ │ │ │ │ +00015ca0: 7320 6465 6669 6e65 6420 746f 2062 6520 s defined to be │ │ │ │ │ +00015cb0: 656d 7074 792d 2d74 6861 7420 7761 7920 empty--that way │ │ │ │ │ +00015cc0: 6e6f 2069 6d70 6c69 6369 7420 7661 6c75 no implicit valu │ │ │ │ │ +00015cd0: 6520 6973 0a73 7562 7374 6974 7574 6564 e is.substituted │ │ │ │ │ +00015ce0: 2e20 2042 6563 6175 7365 2077 6520 6861 . Because we ha │ │ │ │ │ +00015cf0: 7665 206e 6f74 206c 6973 7465 6420 7468 ve not listed th │ │ │ │ │ +00015d00: 6520 736f 7572 6365 206f 6620 2766 616c e source of 'fal │ │ │ │ │ +00015d10: 7365 272c 2077 6520 6861 7665 0a74 6f20 se', we have.to │ │ │ │ │ +00015d20: 7465 6c6c 2041 7574 6f6d 616b 6520 686f tell Automake ho │ │ │ │ │ +00015d30: 7720 746f 206c 696e 6b20 7468 6520 7072 w to link the pr │ │ │ │ │ +00015d40: 6f67 7261 6d2e 2020 5468 6973 2069 7320 ogram. This is │ │ │ │ │ +00015d50: 7468 6520 7075 7270 6f73 6520 6f66 2074 the purpose of t │ │ │ │ │ +00015d60: 6865 0a27 6661 6c73 655f 4c44 4144 4427 he.'false_LDADD' │ │ │ │ │ +00015d70: 206c 696e 652e 2020 4120 2766 616c 7365 line. A 'false │ │ │ │ │ +00015d80: 5f44 4550 454e 4445 4e43 4945 5327 2076 _DEPENDENCIES' v │ │ │ │ │ +00015d90: 6172 6961 626c 652c 2068 6f6c 6469 6e67 ariable, holding │ │ │ │ │ +00015da0: 2074 6865 0a64 6570 656e 6465 6e63 6965 the.dependencie │ │ │ │ │ +00015db0: 7320 6f66 2074 6865 2027 6661 6c73 6527 s of the 'false' │ │ │ │ │ +00015dc0: 2074 6172 6765 7420 7769 6c6c 2062 6520 target will be │ │ │ │ │ +00015dd0: 6175 746f 6d61 7469 6361 6c6c 7920 6765 automatically ge │ │ │ │ │ +00015de0: 6e65 7261 7465 6420 6279 0a41 7574 6f6d nerated by.Autom │ │ │ │ │ +00015df0: 616b 6520 6672 6f6d 2074 6865 2063 6f6e ake from the con │ │ │ │ │ +00015e00: 7465 6e74 206f 6620 2766 616c 7365 5f4c tent of 'false_L │ │ │ │ │ +00015e10: 4441 4444 272e 0a0a 2020 2054 6865 2061 DADD'... The a │ │ │ │ │ +00015e20: 626f 7665 2072 756c 6573 2077 6f6e 2774 bove rules won't │ │ │ │ │ +00015e30: 2077 6f72 6b20 6966 2079 6f75 7220 636f work if your co │ │ │ │ │ +00015e40: 6d70 696c 6572 2064 6f65 736e 2774 2061 mpiler doesn't a │ │ │ │ │ +00015e50: 6363 6570 7420 626f 7468 2027 2d63 270a ccept both '-c'. │ │ │ │ │ +00015e60: 616e 6420 272d 6f27 2e20 2054 6865 2073 and '-o'. The s │ │ │ │ │ +00015e70: 696d 706c 6573 7420 6669 7820 666f 7220 implest fix for │ │ │ │ │ +00015e80: 7468 6973 2069 7320 746f 2069 6e74 726f this is to intro │ │ │ │ │ +00015e90: 6475 6365 2061 2062 6f67 7573 2064 6570 duce a bogus dep │ │ │ │ │ +00015ea0: 656e 6465 6e63 790a 2874 6f20 6176 6f69 endency.(to avoi │ │ │ │ │ +00015eb0: 6420 7072 6f62 6c65 6d73 2077 6974 6820 d problems with │ │ │ │ │ +00015ec0: 6120 7061 7261 6c6c 656c 2027 6d61 6b65 a parallel 'make │ │ │ │ │ +00015ed0: 2729 3a0a 0a20 2020 2020 7472 7565 2e6f '):.. true.o │ │ │ │ │ +00015ee0: 3a20 7472 7565 2e63 2066 616c 7365 2e6f : true.c false.o │ │ │ │ │ +00015ef0: 0a20 2020 2020 2020 2020 2020 2020 2428 . $( │ │ │ │ │ +00015f00: 434f 4d50 494c 4529 202d 4445 5849 545f COMPILE) -DEXIT_ │ │ │ │ │ +00015f10: 434f 4445 3d30 202d 6320 7472 7565 2e63 CODE=0 -c true.c │ │ │ │ │ +00015f20: 0a0a 2020 2020 2066 616c 7365 2e6f 3a20 .. false.o: │ │ │ │ │ +00015f30: 7472 7565 2e63 0a20 2020 2020 2020 2020 true.c. │ │ │ │ │ +00015f40: 2020 2020 2428 434f 4d50 494c 4529 202d $(COMPILE) - │ │ │ │ │ +00015f50: 4445 5849 545f 434f 4445 3d31 202d 6320 DEXIT_CODE=1 -c │ │ │ │ │ +00015f60: 7472 7565 2e63 2026 2620 6d76 2074 7275 true.c && mv tru │ │ │ │ │ +00015f70: 652e 6f20 6661 6c73 652e 6f0a 0a20 2020 e.o false.o.. │ │ │ │ │ +00015f80: 4173 2069 7420 7475 726e 7320 6f75 742c As it turns out, │ │ │ │ │ +00015f90: 2074 6865 7265 2069 7320 616c 736f 2061 there is also a │ │ │ │ │ +00015fa0: 206d 7563 6820 6561 7369 6572 2077 6179 much easier way │ │ │ │ │ +00015fb0: 2074 6f20 646f 2074 6869 7320 7361 6d65 to do this same │ │ │ │ │ +00015fc0: 0a74 6173 6b2e 2020 536f 6d65 206f 6620 .task. Some of │ │ │ │ │ +00015fd0: 7468 6520 6162 6f76 6520 7465 6368 6e69 the above techni │ │ │ │ │ +00015fe0: 7175 6520 6973 2075 7365 6675 6c20 656e que is useful en │ │ │ │ │ +00015ff0: 6f75 6768 2074 6861 7420 7765 2776 6520 ough that we've │ │ │ │ │ +00016000: 6b65 7074 2074 6865 0a65 7861 6d70 6c65 kept the.example │ │ │ │ │ +00016010: 2069 6e20 7468 6520 6d61 6e75 616c 2e20 in the manual. │ │ │ │ │ +00016020: 2048 6f77 6576 6572 2069 6620 796f 7520 However if you │ │ │ │ │ +00016030: 7765 7265 2074 6f20 6275 696c 6420 2774 were to build 't │ │ │ │ │ +00016040: 7275 6527 2061 6e64 2027 6661 6c73 6527 rue' and 'false' │ │ │ │ │ +00016050: 0a69 6e20 7265 616c 206c 6966 652c 2079 .in real life, y │ │ │ │ │ +00016060: 6f75 2077 6f75 6c64 2070 726f 6261 626c ou would probabl │ │ │ │ │ +00016070: 7920 7573 6520 7065 722d 7072 6f67 7261 y use per-progra │ │ │ │ │ +00016080: 6d20 636f 6d70 696c 6174 696f 6e20 666c m compilation fl │ │ │ │ │ +00016090: 6167 732c 206c 696b 650a 736f 3a0a 0a20 ags, like.so:.. │ │ │ │ │ +000160a0: 2020 2020 6269 6e5f 5052 4f47 5241 4d53 bin_PROGRAMS │ │ │ │ │ +000160b0: 203d 2066 616c 7365 2074 7275 650a 0a20 = false true.. │ │ │ │ │ +000160c0: 2020 2020 6661 6c73 655f 534f 5552 4345 false_SOURCE │ │ │ │ │ +000160d0: 5320 3d20 7472 7565 2e63 0a20 2020 2020 S = true.c. │ │ │ │ │ +000160e0: 6661 6c73 655f 4350 5046 4c41 4753 203d false_CPPFLAGS = │ │ │ │ │ +000160f0: 202d 4445 5849 545f 434f 4445 3d31 0a0a -DEXIT_CODE=1.. │ │ │ │ │ +00016100: 2020 2020 2074 7275 655f 534f 5552 4345 true_SOURCE │ │ │ │ │ +00016110: 5320 3d20 7472 7565 2e63 0a20 2020 2020 S = true.c. │ │ │ │ │ +00016120: 7472 7565 5f43 5050 464c 4147 5320 3d20 true_CPPFLAGS = │ │ │ │ │ +00016130: 2d44 4558 4954 5f43 4f44 453d 300a 0a20 -DEXIT_CODE=0.. │ │ │ │ │ +00016140: 2020 496e 2074 6869 7320 6361 7365 2041 In this case A │ │ │ │ │ +00016150: 7574 6f6d 616b 6520 7769 6c6c 2063 6175 utomake will cau │ │ │ │ │ +00016160: 7365 2027 7472 7565 2e63 2720 746f 2062 se 'true.c' to b │ │ │ │ │ +00016170: 6520 636f 6d70 696c 6564 2074 7769 6365 e compiled twice │ │ │ │ │ +00016180: 2c20 7769 7468 0a64 6966 6665 7265 6e74 , with.different │ │ │ │ │ +00016190: 2066 6c61 6773 2e20 2049 6e20 7468 6973 flags. In this │ │ │ │ │ +000161a0: 2069 6e73 7461 6e63 652c 2074 6865 206e instance, the n │ │ │ │ │ +000161b0: 616d 6573 206f 6620 7468 6520 6f62 6a65 ames of the obje │ │ │ │ │ +000161c0: 6374 2066 696c 6573 2077 6f75 6c64 0a62 ct files would.b │ │ │ │ │ +000161d0: 6520 6368 6f73 656e 2062 7920 6175 746f e chosen by auto │ │ │ │ │ +000161e0: 6d61 6b65 3b20 7468 6579 2077 6f75 6c64 make; they would │ │ │ │ │ +000161f0: 2062 6520 2766 616c 7365 2d74 7275 652e be 'false-true. │ │ │ │ │ +00016200: 6f27 2061 6e64 2027 7472 7565 2d74 7275 o' and 'true-tru │ │ │ │ │ +00016210: 652e 6f27 2e0a 2854 6865 206e 616d 6520 e.o'..(The name │ │ │ │ │ +00016220: 6f66 2074 6865 206f 626a 6563 7420 6669 of the object fi │ │ │ │ │ +00016230: 6c65 7320 7261 7265 6c79 206d 6174 7465 les rarely matte │ │ │ │ │ +00016240: 7273 2e29 0a0a 1f0a 4669 6c65 3a20 6175 rs.)....File: au │ │ │ │ │ +00016250: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00016260: 2c20 204e 6f64 653a 2061 7574 6f6d 616b , Node: automak │ │ │ │ │ +00016270: 6520 496e 766f 6361 7469 6f6e 2c20 204e e Invocation, N │ │ │ │ │ +00016280: 6578 743a 2063 6f6e 6669 6775 7265 2c20 ext: configure, │ │ │ │ │ +00016290: 2050 7265 763a 2045 7861 6d70 6c65 732c Prev: Examples, │ │ │ │ │ +000162a0: 2020 5570 3a20 546f 700a 0a35 2043 7265 Up: Top..5 Cre │ │ │ │ │ +000162b0: 6174 696e 6720 6120 274d 616b 6566 696c ating a 'Makefil │ │ │ │ │ +000162c0: 652e 696e 270a 2a2a 2a2a 2a2a 2a2a 2a2a e.in'.********** │ │ │ │ │ +000162d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +000162e0: 0a0a 546f 2063 7265 6174 6520 616c 6c20 ..To create all │ │ │ │ │ +000162f0: 7468 6520 274d 616b 6566 696c 652e 696e the 'Makefile.in │ │ │ │ │ +00016300: 2773 2066 6f72 2061 2070 6163 6b61 6765 's for a package │ │ │ │ │ +00016310: 2c20 7275 6e20 7468 6520 2761 7574 6f6d , run the 'autom │ │ │ │ │ +00016320: 616b 6527 0a70 726f 6772 616d 2069 6e20 ake'.program in │ │ │ │ │ +00016330: 7468 6520 746f 7020 6c65 7665 6c20 6469 the top level di │ │ │ │ │ +00016340: 7265 6374 6f72 792c 2077 6974 6820 6e6f rectory, with no │ │ │ │ │ +00016350: 2061 7267 756d 656e 7473 2e20 2027 6175 arguments. 'au │ │ │ │ │ +00016360: 746f 6d61 6b65 2720 7769 6c6c 0a61 7574 tomake' will.aut │ │ │ │ │ +00016370: 6f6d 6174 6963 616c 6c79 2066 696e 6420 omatically find │ │ │ │ │ +00016380: 6561 6368 2061 7070 726f 7072 6961 7465 each appropriate │ │ │ │ │ +00016390: 2027 4d61 6b65 6669 6c65 2e61 6d27 2028 'Makefile.am' ( │ │ │ │ │ +000163a0: 6279 2073 6361 6e6e 696e 670a 2763 6f6e by scanning.'con │ │ │ │ │ +000163b0: 6669 6775 7265 2e61 6327 3b20 2a6e 6f74 figure.ac'; *not │ │ │ │ │ +000163c0: 6520 636f 6e66 6967 7572 653a 3a29 2061 e configure::) a │ │ │ │ │ +000163d0: 6e64 2067 656e 6572 6174 6520 7468 6520 nd generate the │ │ │ │ │ +000163e0: 636f 7272 6573 706f 6e64 696e 670a 274d corresponding.'M │ │ │ │ │ +000163f0: 616b 6566 696c 652e 696e 272e 2020 4e6f akefile.in'. No │ │ │ │ │ +00016400: 7465 2074 6861 7420 2761 7574 6f6d 616b te that 'automak │ │ │ │ │ +00016410: 6527 2068 6173 2061 2072 6174 6865 7220 e' has a rather │ │ │ │ │ +00016420: 7369 6d70 6c69 7374 6963 2076 6965 7720 simplistic view │ │ │ │ │ +00016430: 6f66 0a77 6861 7420 636f 6e73 7469 7475 of.what constitu │ │ │ │ │ +00016440: 7465 7320 6120 7061 636b 6167 653b 2069 tes a package; i │ │ │ │ │ +00016450: 7420 6173 7375 6d65 7320 7468 6174 2061 t assumes that a │ │ │ │ │ +00016460: 2070 6163 6b61 6765 2068 6173 206f 6e6c package has onl │ │ │ │ │ +00016470: 7920 6f6e 650a 2763 6f6e 6669 6775 7265 y one.'configure │ │ │ │ │ +00016480: 2e61 6327 2c20 6174 2074 6865 2074 6f70 .ac', at the top │ │ │ │ │ +00016490: 2e20 2049 6620 796f 7572 2070 6163 6b61 . If your packa │ │ │ │ │ +000164a0: 6765 2068 6173 206d 756c 7469 706c 650a ge has multiple. │ │ │ │ │ +000164b0: 2763 6f6e 6669 6775 7265 2e61 6327 732c 'configure.ac's, │ │ │ │ │ +000164c0: 2074 6865 6e20 796f 7520 6d75 7374 2072 then you must r │ │ │ │ │ +000164d0: 756e 2027 6175 746f 6d61 6b65 2720 696e un 'automake' in │ │ │ │ │ +000164e0: 2065 6163 6820 6469 7265 6374 6f72 7920 each directory │ │ │ │ │ +000164f0: 686f 6c64 696e 670a 6120 2763 6f6e 6669 holding.a 'confi │ │ │ │ │ +00016500: 6775 7265 2e61 6327 2e20 2028 416c 7465 gure.ac'. (Alte │ │ │ │ │ +00016510: 726e 6174 6976 656c 792c 2079 6f75 206d rnatively, you m │ │ │ │ │ +00016520: 6179 2072 656c 7920 6f6e 2041 7574 6f63 ay rely on Autoc │ │ │ │ │ +00016530: 6f6e 6627 730a 2761 7574 6f72 6563 6f6e onf's.'autorecon │ │ │ │ │ +00016540: 6627 2c20 7768 6963 6820 6973 2061 626c f', which is abl │ │ │ │ │ +00016550: 6520 746f 2072 6563 7572 7365 2079 6f75 e to recurse you │ │ │ │ │ +00016560: 7220 7061 636b 6167 6520 7472 6565 2061 r package tree a │ │ │ │ │ +00016570: 6e64 2072 756e 0a27 6175 746f 6d61 6b65 nd run.'automake │ │ │ │ │ +00016580: 2720 7768 6572 6520 6170 7072 6f70 7269 ' where appropri │ │ │ │ │ +00016590: 6174 652e 290a 0a20 2020 596f 7520 6361 ate.).. You ca │ │ │ │ │ +000165a0: 6e20 6f70 7469 6f6e 616c 6c79 2067 6976 n optionally giv │ │ │ │ │ +000165b0: 6520 2761 7574 6f6d 616b 6527 2061 6e20 e 'automake' an │ │ │ │ │ +000165c0: 6172 6775 6d65 6e74 3b20 272e 616d 2720 argument; '.am' │ │ │ │ │ +000165d0: 6973 2061 7070 656e 6465 6420 746f 0a74 is appended to.t │ │ │ │ │ +000165e0: 6865 2061 7267 756d 656e 7420 616e 6420 he argument and │ │ │ │ │ +000165f0: 7468 6520 7265 7375 6c74 2069 7320 7573 the result is us │ │ │ │ │ +00016600: 6564 2061 7320 7468 6520 6e61 6d65 206f ed as the name o │ │ │ │ │ +00016610: 6620 7468 6520 696e 7075 7420 6669 6c65 f the input file │ │ │ │ │ +00016620: 2e20 2054 6869 730a 6665 6174 7572 6520 . This.feature │ │ │ │ │ +00016630: 6973 2067 656e 6572 616c 6c79 206f 6e6c is generally onl │ │ │ │ │ +00016640: 7920 7573 6564 2074 6f20 6175 746f 6d61 y used to automa │ │ │ │ │ +00016650: 7469 6361 6c6c 7920 7265 6275 696c 6420 tically rebuild │ │ │ │ │ +00016660: 616e 206f 7574 2d6f 662d 6461 7465 0a27 an out-of-date.' │ │ │ │ │ +00016670: 4d61 6b65 6669 6c65 2e69 6e27 2e20 204e Makefile.in'. N │ │ │ │ │ +00016680: 6f74 6520 7468 6174 2027 6175 746f 6d61 ote that 'automa │ │ │ │ │ +00016690: 6b65 2720 6d75 7374 2061 6c77 6179 7320 ke' must always │ │ │ │ │ +000166a0: 6265 2072 756e 2066 726f 6d20 7468 6520 be run from the │ │ │ │ │ +000166b0: 746f 706d 6f73 740a 6469 7265 6374 6f72 topmost.director │ │ │ │ │ +000166c0: 7920 6f66 2061 2070 726f 6a65 6374 2c20 y of a project, │ │ │ │ │ +000166d0: 6576 656e 2069 6620 6265 696e 6720 7573 even if being us │ │ │ │ │ +000166e0: 6564 2074 6f20 7265 6765 6e65 7261 7465 ed to regenerate │ │ │ │ │ +000166f0: 2074 6865 0a27 4d61 6b65 6669 6c65 2e69 the.'Makefile.i │ │ │ │ │ +00016700: 6e27 2069 6e20 736f 6d65 2073 7562 6469 n' in some subdi │ │ │ │ │ +00016710: 7265 6374 6f72 792e 2020 5468 6973 2069 rectory. This i │ │ │ │ │ +00016720: 7320 6e65 6365 7373 6172 7920 6265 6361 s necessary beca │ │ │ │ │ +00016730: 7573 650a 2761 7574 6f6d 616b 6527 206d use.'automake' m │ │ │ │ │ +00016740: 7573 7420 7363 616e 2027 636f 6e66 6967 ust scan 'config │ │ │ │ │ +00016750: 7572 652e 6163 272c 2061 6e64 2062 6563 ure.ac', and bec │ │ │ │ │ +00016760: 6175 7365 2027 6175 746f 6d61 6b65 2720 ause 'automake' │ │ │ │ │ +00016770: 7573 6573 2074 6865 0a6b 6e6f 776c 6564 uses the.knowled │ │ │ │ │ +00016780: 6765 2074 6861 7420 6120 274d 616b 6566 ge that a 'Makef │ │ │ │ │ +00016790: 696c 652e 696e 2720 6973 2069 6e20 6120 ile.in' is in a │ │ │ │ │ +000167a0: 7375 6264 6972 6563 746f 7279 2074 6f20 subdirectory to │ │ │ │ │ +000167b0: 6368 616e 6765 2069 7473 0a62 6568 6176 change its.behav │ │ │ │ │ +000167c0: 696f 7220 696e 2073 6f6d 6520 6361 7365 ior in some case │ │ │ │ │ +000167d0: 732e 0a0a 2020 2041 7574 6f6d 616b 6520 s... Automake │ │ │ │ │ +000167e0: 7769 6c6c 2072 756e 2027 6175 746f 636f will run 'autoco │ │ │ │ │ +000167f0: 6e66 2720 746f 2073 6361 6e20 2763 6f6e nf' to scan 'con │ │ │ │ │ +00016800: 6669 6775 7265 2e61 6327 2061 6e64 2069 figure.ac' and i │ │ │ │ │ +00016810: 7473 0a64 6570 656e 6465 6e63 6965 7320 ts.dependencies │ │ │ │ │ +00016820: 2869 2e65 2e2c 2027 6163 6c6f 6361 6c2e (i.e., 'aclocal. │ │ │ │ │ +00016830: 6d34 2720 616e 6420 616e 7920 696e 636c m4' and any incl │ │ │ │ │ +00016840: 7564 6564 2066 696c 6529 2c20 7468 6572 uded file), ther │ │ │ │ │ +00016850: 6566 6f72 650a 2761 7574 6f63 6f6e 6627 efore.'autoconf' │ │ │ │ │ +00016860: 206d 7573 7420 6265 2069 6e20 796f 7572 must be in your │ │ │ │ │ +00016870: 2027 5041 5448 272e 2020 4966 2074 6865 'PATH'. If the │ │ │ │ │ +00016880: 7265 2069 7320 616e 2027 4155 544f 434f re is an 'AUTOCO │ │ │ │ │ +00016890: 4e46 2720 7661 7269 6162 6c65 0a69 6e20 NF' variable.in │ │ │ │ │ +000168a0: 796f 7572 2065 6e76 6972 6f6e 6d65 6e74 your environment │ │ │ │ │ +000168b0: 2069 7420 7769 6c6c 2062 6520 7573 6564 it will be used │ │ │ │ │ +000168c0: 2069 6e73 7465 6164 206f 6620 2761 7574 instead of 'aut │ │ │ │ │ +000168d0: 6f63 6f6e 6627 2c20 7468 6973 2061 6c6c oconf', this all │ │ │ │ │ +000168e0: 6f77 730a 796f 7520 746f 2073 656c 6563 ows.you to selec │ │ │ │ │ +000168f0: 7420 6120 7061 7274 6963 756c 6172 2076 t a particular v │ │ │ │ │ +00016900: 6572 7369 6f6e 206f 6620 4175 746f 636f ersion of Autoco │ │ │ │ │ +00016910: 6e66 2e20 2042 7920 7468 6520 7761 792c nf. By the way, │ │ │ │ │ +00016920: 2064 6f6e 2774 0a6d 6973 756e 6465 7273 don't.misunders │ │ │ │ │ +00016930: 7461 6e64 2074 6869 7320 7061 7261 6772 tand this paragr │ │ │ │ │ +00016940: 6170 683a 2027 6175 746f 6d61 6b65 2720 aph: 'automake' │ │ │ │ │ +00016950: 7275 6e73 2027 6175 746f 636f 6e66 2720 runs 'autoconf' │ │ │ │ │ +00016960: 746f 202a 7363 616e 2a20 796f 7572 0a27 to *scan* your.' │ │ │ │ │ +00016970: 636f 6e66 6967 7572 652e 6163 272c 2074 configure.ac', t │ │ │ │ │ +00016980: 6869 7320 776f 6e27 7420 6275 696c 6420 his won't build │ │ │ │ │ +00016990: 2763 6f6e 6669 6775 7265 2720 616e 6420 'configure' and │ │ │ │ │ +000169a0: 796f 7520 7374 696c 6c20 6861 7665 2074 you still have t │ │ │ │ │ +000169b0: 6f20 7275 6e0a 2761 7574 6f63 6f6e 6627 o run.'autoconf' │ │ │ │ │ +000169c0: 2079 6f75 7273 656c 6620 666f 7220 7468 yourself for th │ │ │ │ │ +000169d0: 6973 2070 7572 706f 7365 2e0a 0a20 2020 is purpose... │ │ │ │ │ +000169e0: 2761 7574 6f6d 616b 6527 2061 6363 6570 'automake' accep │ │ │ │ │ +000169f0: 7473 2074 6865 2066 6f6c 6c6f 7769 6e67 ts the following │ │ │ │ │ +00016a00: 206f 7074 696f 6e73 3a0a 0a27 2d61 270a options:..'-a'. │ │ │ │ │ +00016a10: 272d 2d61 6464 2d6d 6973 7369 6e67 270a '--add-missing'. │ │ │ │ │ +00016a20: 2020 2020 2041 7574 6f6d 616b 6520 7265 Automake re │ │ │ │ │ +00016a30: 7175 6972 6573 2063 6572 7461 696e 2063 quires certain c │ │ │ │ │ +00016a40: 6f6d 6d6f 6e20 6669 6c65 7320 746f 2065 ommon files to e │ │ │ │ │ +00016a50: 7869 7374 2069 6e20 6365 7274 6169 6e0a xist in certain. │ │ │ │ │ +00016a60: 2020 2020 2073 6974 7561 7469 6f6e 733b situations; │ │ │ │ │ +00016a70: 2066 6f72 2069 6e73 7461 6e63 652c 2027 for instance, ' │ │ │ │ │ +00016a80: 636f 6e66 6967 2e67 7565 7373 2720 6973 config.guess' is │ │ │ │ │ +00016a90: 2072 6571 7569 7265 6420 6966 0a20 2020 required if. │ │ │ │ │ +00016aa0: 2020 2763 6f6e 6669 6775 7265 2e61 6327 'configure.ac' │ │ │ │ │ +00016ab0: 2069 6e76 6f6b 6573 2027 4143 5f43 414e invokes 'AC_CAN │ │ │ │ │ +00016ac0: 4f4e 4943 414c 5f48 4f53 5427 2e20 2041 ONICAL_HOST'. A │ │ │ │ │ +00016ad0: 7574 6f6d 616b 6520 6973 0a20 2020 2020 utomake is. │ │ │ │ │ +00016ae0: 6469 7374 7269 6275 7465 6420 7769 7468 distributed with │ │ │ │ │ +00016af0: 2073 6576 6572 616c 206f 6620 7468 6573 several of thes │ │ │ │ │ +00016b00: 6520 6669 6c65 7320 282a 6e6f 7465 2041 e files (*note A │ │ │ │ │ +00016b10: 7578 696c 6961 7279 0a20 2020 2020 5072 uxiliary. Pr │ │ │ │ │ +00016b20: 6f67 7261 6d73 3a3a 293b 2074 6869 7320 ograms::); this │ │ │ │ │ +00016b30: 6f70 7469 6f6e 2077 696c 6c20 6361 7573 option will caus │ │ │ │ │ +00016b40: 6520 7468 6520 6d69 7373 696e 6720 6f6e e the missing on │ │ │ │ │ +00016b50: 6573 2074 6f20 6265 0a20 2020 2020 6175 es to be. au │ │ │ │ │ +00016b60: 746f 6d61 7469 6361 6c6c 7920 6164 6465 tomatically adde │ │ │ │ │ +00016b70: 6420 746f 2074 6865 2070 6163 6b61 6765 d to the package │ │ │ │ │ +00016b80: 2c20 7768 656e 6576 6572 2070 6f73 7369 , whenever possi │ │ │ │ │ +00016b90: 626c 652e 2020 496e 2067 656e 6572 616c ble. In general │ │ │ │ │ +00016ba0: 0a20 2020 2020 6966 2041 7574 6f6d 616b . if Automak │ │ │ │ │ +00016bb0: 6520 7465 6c6c 7320 796f 7520 6120 6669 e tells you a fi │ │ │ │ │ +00016bc0: 6c65 2069 7320 6d69 7373 696e 672c 2074 le is missing, t │ │ │ │ │ +00016bd0: 7279 2075 7369 6e67 2074 6869 7320 6f70 ry using this op │ │ │ │ │ +00016be0: 7469 6f6e 2e20 2042 790a 2020 2020 2064 tion. By. d │ │ │ │ │ +00016bf0: 6566 6175 6c74 2041 7574 6f6d 616b 6520 efault Automake │ │ │ │ │ +00016c00: 7472 6965 7320 746f 206d 616b 6520 6120 tries to make a │ │ │ │ │ +00016c10: 7379 6d62 6f6c 6963 206c 696e 6b20 706f symbolic link po │ │ │ │ │ +00016c20: 696e 7469 6e67 2074 6f20 6974 7320 6f77 inting to its ow │ │ │ │ │ +00016c30: 6e0a 2020 2020 2063 6f70 7920 6f66 2074 n. copy of t │ │ │ │ │ +00016c40: 6865 206d 6973 7369 6e67 2066 696c 653b he missing file; │ │ │ │ │ +00016c50: 2074 6869 7320 6361 6e20 6265 2063 6861 this can be cha │ │ │ │ │ +00016c60: 6e67 6564 2077 6974 6820 272d 2d63 6f70 nged with '--cop │ │ │ │ │ +00016c70: 7927 2e0a 0a20 2020 2020 4d61 6e79 206f y'... Many o │ │ │ │ │ +00016c80: 6620 7468 6520 706f 7465 6e74 6961 6c6c f the potentiall │ │ │ │ │ +00016c90: 792d 6d69 7373 696e 6720 6669 6c65 7320 y-missing files │ │ │ │ │ +00016ca0: 6172 6520 636f 6d6d 6f6e 2073 6372 6970 are common scrip │ │ │ │ │ +00016cb0: 7473 2077 686f 7365 0a20 2020 2020 6c6f ts whose. lo │ │ │ │ │ +00016cc0: 6361 7469 6f6e 206d 6179 2062 6520 7370 cation may be sp │ │ │ │ │ +00016cd0: 6563 6966 6965 6420 7669 6120 7468 6520 ecified via the │ │ │ │ │ +00016ce0: 2741 435f 434f 4e46 4947 5f41 5558 5f44 'AC_CONFIG_AUX_D │ │ │ │ │ +00016cf0: 4952 2720 6d61 6372 6f2e 0a20 2020 2020 IR' macro.. │ │ │ │ │ +00016d00: 5468 6572 6566 6f72 652c 2027 4143 5f43 Therefore, 'AC_C │ │ │ │ │ +00016d10: 4f4e 4649 475f 4155 585f 4449 5227 2773 ONFIG_AUX_DIR''s │ │ │ │ │ +00016d20: 2073 6574 7469 6e67 2061 6666 6563 7473 setting affects │ │ │ │ │ +00016d30: 2077 6865 7468 6572 2061 2066 696c 6520 whether a file │ │ │ │ │ +00016d40: 6973 0a20 2020 2020 636f 6e73 6964 6572 is. consider │ │ │ │ │ +00016d50: 6564 206d 6973 7369 6e67 2c20 616e 6420 ed missing, and │ │ │ │ │ +00016d60: 7768 6572 6520 7468 6520 6d69 7373 696e where the missin │ │ │ │ │ +00016d70: 6720 6669 6c65 2069 7320 6164 6465 6420 g file is added │ │ │ │ │ +00016d80: 282a 6e6f 7465 0a20 2020 2020 4f70 7469 (*note. Opti │ │ │ │ │ +00016d90: 6f6e 616c 3a3a 292e 0a0a 2020 2020 2049 onal::)... I │ │ │ │ │ +00016da0: 6e20 736f 6d65 2073 7472 6963 746e 6573 n some strictnes │ │ │ │ │ +00016db0: 7320 6d6f 6465 732c 2061 6464 6974 696f s modes, additio │ │ │ │ │ +00016dc0: 6e61 6c20 6669 6c65 7320 6172 6520 696e nal files are in │ │ │ │ │ +00016dd0: 7374 616c 6c65 642c 2073 6565 202a 6e6f stalled, see *no │ │ │ │ │ +00016de0: 7465 0a20 2020 2020 476e 6974 733a 3a20 te. Gnits:: │ │ │ │ │ +00016df0: 666f 7220 6d6f 7265 2069 6e66 6f72 6d61 for more informa │ │ │ │ │ +00016e00: 7469 6f6e 2e0a 0a27 2d2d 6c69 6264 6972 tion...'--libdir │ │ │ │ │ +00016e10: 3d44 4952 270a 2020 2020 204c 6f6f 6b20 =DIR'. Look │ │ │ │ │ +00016e20: 666f 7220 4175 746f 6d61 6b65 2064 6174 for Automake dat │ │ │ │ │ +00016e30: 6120 6669 6c65 7320 696e 2064 6972 6563 a files in direc │ │ │ │ │ +00016e40: 746f 7279 2044 4952 2069 6e73 7465 6164 tory DIR instead │ │ │ │ │ +00016e50: 206f 6620 696e 2074 6865 0a20 2020 2020 of in the. │ │ │ │ │ +00016e60: 696e 7374 616c 6c61 7469 6f6e 2064 6972 installation dir │ │ │ │ │ +00016e70: 6563 746f 7279 2e20 2054 6869 7320 6973 ectory. This is │ │ │ │ │ +00016e80: 2074 7970 6963 616c 6c79 2075 7365 6420 typically used │ │ │ │ │ +00016e90: 666f 7220 6465 6275 6767 696e 672e 0a0a for debugging... │ │ │ │ │ +00016ea0: 272d 6327 0a27 2d2d 636f 7079 270a 2020 '-c'.'--copy'. │ │ │ │ │ +00016eb0: 2020 2057 6865 6e20 7573 6564 2077 6974 When used wit │ │ │ │ │ +00016ec0: 6820 272d 2d61 6464 2d6d 6973 7369 6e67 h '--add-missing │ │ │ │ │ +00016ed0: 272c 2063 6175 7365 7320 696e 7374 616c ', causes instal │ │ │ │ │ +00016ee0: 6c65 6420 6669 6c65 7320 746f 2062 650a led files to be. │ │ │ │ │ +00016ef0: 2020 2020 2063 6f70 6965 642e 2020 5468 copied. Th │ │ │ │ │ +00016f00: 6520 6465 6661 756c 7420 6973 2074 6f20 e default is to │ │ │ │ │ +00016f10: 6d61 6b65 2061 2073 796d 626f 6c69 6320 make a symbolic │ │ │ │ │ +00016f20: 6c69 6e6b 2e0a 0a27 2d2d 6379 676e 7573 link...'--cygnus │ │ │ │ │ +00016f30: 270a 2020 2020 2043 6175 7365 7320 7468 '. Causes th │ │ │ │ │ +00016f40: 6520 6765 6e65 7261 7465 6420 274d 616b e generated 'Mak │ │ │ │ │ +00016f50: 6566 696c 652e 696e 2773 2074 6f20 666f efile.in's to fo │ │ │ │ │ +00016f60: 6c6c 6f77 2043 7967 6e75 7320 7275 6c65 llow Cygnus rule │ │ │ │ │ +00016f70: 732c 2069 6e73 7465 6164 0a20 2020 2020 s, instead. │ │ │ │ │ +00016f80: 6f66 2047 4e55 206f 7220 476e 6974 7320 of GNU or Gnits │ │ │ │ │ +00016f90: 7275 6c65 732e 2020 466f 7220 6d6f 7265 rules. For more │ │ │ │ │ +00016fa0: 2069 6e66 6f72 6d61 7469 6f6e 2c20 7365 information, se │ │ │ │ │ +00016fb0: 6520 2a6e 6f74 6520 4379 676e 7573 3a3a e *note Cygnus:: │ │ │ │ │ +00016fc0: 2e0a 2020 2020 204e 6f74 6520 7468 6174 .. Note that │ │ │ │ │ +00016fd0: 205f 7468 6973 206d 6f64 6520 6f66 206f _this mode of o │ │ │ │ │ +00016fe0: 7065 7261 7469 6f6e 2069 7320 6465 7072 peration is depr │ │ │ │ │ +00016ff0: 6563 6174 6564 2c20 616e 6420 7769 6c6c ecated, and will │ │ │ │ │ +00017000: 2062 650a 2020 2020 2072 656d 6f76 6564 be. removed │ │ │ │ │ +00017010: 5f20 696e 2061 2066 7574 7572 6520 4175 _ in a future Au │ │ │ │ │ +00017020: 746f 6d61 6b65 2072 656c 6561 7365 2e0a tomake release.. │ │ │ │ │ +00017030: 0a27 2d66 270a 272d 2d66 6f72 6365 2d6d .'-f'.'--force-m │ │ │ │ │ +00017040: 6973 7369 6e67 270a 2020 2020 2057 6865 issing'. Whe │ │ │ │ │ +00017050: 6e20 7573 6564 2077 6974 6820 272d 2d61 n used with '--a │ │ │ │ │ +00017060: 6464 2d6d 6973 7369 6e67 272c 2063 6175 dd-missing', cau │ │ │ │ │ +00017070: 7365 7320 7374 616e 6461 7264 2066 696c ses standard fil │ │ │ │ │ +00017080: 6573 2074 6f20 6265 0a20 2020 2020 7265 es to be. re │ │ │ │ │ +00017090: 696e 7374 616c 6c65 6420 6576 656e 2069 installed even i │ │ │ │ │ +000170a0: 6620 7468 6579 2061 6c72 6561 6479 2065 f they already e │ │ │ │ │ +000170b0: 7869 7374 2069 6e20 7468 6520 736f 7572 xist in the sour │ │ │ │ │ +000170c0: 6365 2074 7265 652e 2020 5468 6973 0a20 ce tree. This. │ │ │ │ │ +000170d0: 2020 2020 696e 766f 6c76 6573 2072 656d involves rem │ │ │ │ │ +000170e0: 6f76 696e 6720 7468 6520 6669 6c65 2066 oving the file f │ │ │ │ │ +000170f0: 726f 6d20 7468 6520 736f 7572 6365 2074 rom the source t │ │ │ │ │ +00017100: 7265 6520 6265 666f 7265 2063 7265 6174 ree before creat │ │ │ │ │ +00017110: 696e 6720 7468 650a 2020 2020 206e 6577 ing the. new │ │ │ │ │ +00017120: 2073 796d 6c69 6e6b 2028 6f72 2c20 7769 symlink (or, wi │ │ │ │ │ +00017130: 7468 2027 2d2d 636f 7079 272c 2063 6f70 th '--copy', cop │ │ │ │ │ +00017140: 7969 6e67 2074 6865 206e 6577 2066 696c ying the new fil │ │ │ │ │ +00017150: 6529 2e0a 0a27 2d2d 666f 7265 6967 6e27 e)...'--foreign' │ │ │ │ │ +00017160: 0a20 2020 2020 5365 7420 7468 6520 676c . Set the gl │ │ │ │ │ +00017170: 6f62 616c 2073 7472 6963 746e 6573 7320 obal strictness │ │ │ │ │ +00017180: 746f 2027 666f 7265 6967 6e27 2e20 2046 to 'foreign'. F │ │ │ │ │ +00017190: 6f72 206d 6f72 6520 696e 666f 726d 6174 or more informat │ │ │ │ │ +000171a0: 696f 6e2c 2073 6565 0a20 2020 2020 2a6e ion, see. *n │ │ │ │ │ +000171b0: 6f74 6520 5374 7269 6374 6e65 7373 3a3a ote Strictness:: │ │ │ │ │ +000171c0: 2e0a 0a27 2d2d 676e 6974 7327 0a20 2020 ...'--gnits'. │ │ │ │ │ +000171d0: 2020 5365 7420 7468 6520 676c 6f62 616c Set the global │ │ │ │ │ +000171e0: 2073 7472 6963 746e 6573 7320 746f 2027 strictness to ' │ │ │ │ │ +000171f0: 676e 6974 7327 2e20 2046 6f72 206d 6f72 gnits'. For mor │ │ │ │ │ +00017200: 6520 696e 666f 726d 6174 696f 6e2c 2073 e information, s │ │ │ │ │ +00017210: 6565 0a20 2020 2020 2a6e 6f74 6520 476e ee. *note Gn │ │ │ │ │ +00017220: 6974 733a 3a2e 0a0a 272d 2d67 6e75 270a its::...'--gnu'. │ │ │ │ │ +00017230: 2020 2020 2053 6574 2074 6865 2067 6c6f Set the glo │ │ │ │ │ +00017240: 6261 6c20 7374 7269 6374 6e65 7373 2074 bal strictness t │ │ │ │ │ +00017250: 6f20 2767 6e75 272e 2020 466f 7220 6d6f o 'gnu'. For mo │ │ │ │ │ +00017260: 7265 2069 6e66 6f72 6d61 7469 6f6e 2c20 re information, │ │ │ │ │ +00017270: 7365 650a 2020 2020 202a 6e6f 7465 2047 see. *note G │ │ │ │ │ +00017280: 6e69 7473 3a3a 2e20 2054 6869 7320 6973 nits::. This is │ │ │ │ │ +00017290: 2074 6865 2064 6566 6175 6c74 2073 7472 the default str │ │ │ │ │ +000172a0: 6963 746e 6573 732e 0a0a 272d 2d68 656c ictness...'--hel │ │ │ │ │ +000172b0: 7027 0a20 2020 2020 5072 696e 7420 6120 p'. Print a │ │ │ │ │ +000172c0: 7375 6d6d 6172 7920 6f66 2074 6865 2063 summary of the c │ │ │ │ │ +000172d0: 6f6d 6d61 6e64 206c 696e 6520 6f70 7469 ommand line opti │ │ │ │ │ +000172e0: 6f6e 7320 616e 6420 6578 6974 2e0a 0a27 ons and exit...' │ │ │ │ │ +000172f0: 2d69 270a 272d 2d69 676e 6f72 652d 6465 -i'.'--ignore-de │ │ │ │ │ +00017300: 7073 270a 2020 2020 2054 6869 7320 6469 ps'. This di │ │ │ │ │ +00017310: 7361 626c 6573 2074 6865 2064 6570 656e sables the depen │ │ │ │ │ +00017320: 6465 6e63 7920 7472 6163 6b69 6e67 2066 dency tracking f │ │ │ │ │ +00017330: 6561 7475 7265 2069 6e20 6765 6e65 7261 eature in genera │ │ │ │ │ +00017340: 7465 640a 2020 2020 2027 4d61 6b65 6669 ted. 'Makefi │ │ │ │ │ +00017350: 6c65 2773 3b20 7365 6520 2a6e 6f74 6520 le's; see *note │ │ │ │ │ +00017360: 4465 7065 6e64 656e 6369 6573 3a3a 2e0a Dependencies::.. │ │ │ │ │ +00017370: 0a27 2d2d 696e 636c 7564 652d 6465 7073 .'--include-deps │ │ │ │ │ +00017380: 270a 2020 2020 2054 6869 7320 656e 6162 '. This enab │ │ │ │ │ +00017390: 6c65 7320 7468 6520 6465 7065 6e64 656e les the dependen │ │ │ │ │ +000173a0: 6379 2074 7261 636b 696e 6720 6665 6174 cy tracking feat │ │ │ │ │ +000173b0: 7572 652e 2020 5468 6973 2066 6561 7475 ure. This featu │ │ │ │ │ +000173c0: 7265 2069 730a 2020 2020 2065 6e61 626c re is. enabl │ │ │ │ │ +000173d0: 6564 2062 7920 6465 6661 756c 742e 2020 ed by default. │ │ │ │ │ +000173e0: 5468 6973 206f 7074 696f 6e20 6973 2070 This option is p │ │ │ │ │ +000173f0: 726f 7669 6465 6420 666f 7220 6869 7374 rovided for hist │ │ │ │ │ +00017400: 6f72 6963 616c 2072 6561 736f 6e73 0a20 orical reasons. │ │ │ │ │ +00017410: 2020 2020 6f6e 6c79 2061 6e64 2070 726f only and pro │ │ │ │ │ +00017420: 6261 626c 7920 7368 6f75 6c64 206e 6f74 bably should not │ │ │ │ │ +00017430: 2062 6520 7573 6564 2e0a 0a27 2d2d 6e6f be used...'--no │ │ │ │ │ +00017440: 2d66 6f72 6365 270a 2020 2020 204f 7264 -force'. Ord │ │ │ │ │ +00017450: 696e 6172 696c 7920 2761 7574 6f6d 616b inarily 'automak │ │ │ │ │ +00017460: 6527 2063 7265 6174 6573 2061 6c6c 2027 e' creates all ' │ │ │ │ │ +00017470: 4d61 6b65 6669 6c65 2e69 6e27 7320 6d65 Makefile.in's me │ │ │ │ │ +00017480: 6e74 696f 6e65 6420 696e 0a20 2020 2020 ntioned in. │ │ │ │ │ +00017490: 2763 6f6e 6669 6775 7265 2e61 6327 2e20 'configure.ac'. │ │ │ │ │ +000174a0: 2054 6869 7320 6f70 7469 6f6e 2063 6175 This option cau │ │ │ │ │ +000174b0: 7365 7320 6974 2074 6f20 6f6e 6c79 2075 ses it to only u │ │ │ │ │ +000174c0: 7064 6174 6520 7468 6f73 650a 2020 2020 pdate those. │ │ │ │ │ +000174d0: 2027 4d61 6b65 6669 6c65 2e69 6e27 7320 'Makefile.in's │ │ │ │ │ +000174e0: 7468 6174 2061 7265 206f 7574 206f 6620 that are out of │ │ │ │ │ +000174f0: 6461 7465 2077 6974 6820 7265 7370 6563 date with respec │ │ │ │ │ +00017500: 7420 746f 206f 6e65 206f 6620 7468 6569 t to one of thei │ │ │ │ │ +00017510: 720a 2020 2020 2064 6570 656e 6465 6e74 r. dependent │ │ │ │ │ +00017520: 732e 0a0a 272d 6f20 4449 5227 0a27 2d2d s...'-o DIR'.'-- │ │ │ │ │ +00017530: 6f75 7470 7574 2d64 6972 3d44 4952 270a output-dir=DIR'. │ │ │ │ │ +00017540: 2020 2020 2050 7574 2074 6865 2067 656e Put the gen │ │ │ │ │ +00017550: 6572 6174 6564 2027 4d61 6b65 6669 6c65 erated 'Makefile │ │ │ │ │ +00017560: 2e69 6e27 2069 6e20 7468 6520 6469 7265 .in' in the dire │ │ │ │ │ +00017570: 6374 6f72 7920 4449 522e 2020 4f72 6469 ctory DIR. Ordi │ │ │ │ │ +00017580: 6e61 7269 6c79 0a20 2020 2020 6561 6368 narily. each │ │ │ │ │ +00017590: 2027 4d61 6b65 6669 6c65 2e69 6e27 2069 'Makefile.in' i │ │ │ │ │ +000175a0: 7320 6372 6561 7465 6420 696e 2074 6865 s created in the │ │ │ │ │ +000175b0: 2064 6972 6563 746f 7279 206f 6620 7468 directory of th │ │ │ │ │ +000175c0: 6520 636f 7272 6573 706f 6e64 696e 670a e corresponding. │ │ │ │ │ +000175d0: 2020 2020 2027 4d61 6b65 6669 6c65 2e61 'Makefile.a │ │ │ │ │ +000175e0: 6d27 2e20 2054 6869 7320 6f70 7469 6f6e m'. This option │ │ │ │ │ +000175f0: 2069 7320 6465 7072 6563 6174 6564 2061 is deprecated a │ │ │ │ │ +00017600: 6e64 2077 696c 6c20 6265 2072 656d 6f76 nd will be remov │ │ │ │ │ +00017610: 6564 2069 6e20 610a 2020 2020 2066 7574 ed in a. fut │ │ │ │ │ +00017620: 7572 6520 7265 6c65 6173 652e 0a0a 272d ure release...'- │ │ │ │ │ +00017630: 7627 0a27 2d2d 7665 7262 6f73 6527 0a20 v'.'--verbose'. │ │ │ │ │ +00017640: 2020 2020 4361 7573 6520 4175 746f 6d61 Cause Automa │ │ │ │ │ +00017650: 6b65 2074 6f20 7072 696e 7420 696e 666f ke to print info │ │ │ │ │ +00017660: 726d 6174 696f 6e20 6162 6f75 7420 7768 rmation about wh │ │ │ │ │ +00017670: 6963 6820 6669 6c65 7320 6172 6520 6265 ich files are be │ │ │ │ │ +00017680: 696e 670a 2020 2020 2072 6561 6420 6f72 ing. read or │ │ │ │ │ +00017690: 2063 7265 6174 6564 2e0a 0a27 2d2d 7665 created...'--ve │ │ │ │ │ +000176a0: 7273 696f 6e27 0a20 2020 2020 5072 696e rsion'. Prin │ │ │ │ │ +000176b0: 7420 7468 6520 7665 7273 696f 6e20 6e75 t the version nu │ │ │ │ │ +000176c0: 6d62 6572 206f 6620 4175 746f 6d61 6b65 mber of Automake │ │ │ │ │ +000176d0: 2061 6e64 2065 7869 742e 0a0a 272d 5720 and exit...'-W │ │ │ │ │ +000176e0: 4341 5445 474f 5259 270a 272d 2d77 6172 CATEGORY'.'--war │ │ │ │ │ +000176f0: 6e69 6e67 733d 4341 5445 474f 5259 270a nings=CATEGORY'. │ │ │ │ │ +00017700: 2020 2020 204f 7574 7075 7420 7761 726e Output warn │ │ │ │ │ +00017710: 696e 6773 2066 616c 6c69 6e67 2069 6e20 ings falling in │ │ │ │ │ +00017720: 4341 5445 474f 5259 2e20 2043 4154 4547 CATEGORY. CATEG │ │ │ │ │ +00017730: 4f52 5920 6361 6e20 6265 206f 6e65 206f ORY can be one o │ │ │ │ │ +00017740: 663a 0a20 2020 2020 2767 6e75 270a 2020 f:. 'gnu'. │ │ │ │ │ +00017750: 2020 2020 2020 2020 7761 726e 696e 6773 warnings │ │ │ │ │ +00017760: 2072 656c 6174 6564 2074 6f20 7468 6520 related to the │ │ │ │ │ +00017770: 474e 5520 436f 6469 6e67 2053 7461 6e64 GNU Coding Stand │ │ │ │ │ +00017780: 6172 6473 2028 2a6e 6f74 650a 2020 2020 ards (*note. │ │ │ │ │ +00017790: 2020 2020 2020 2873 7461 6e64 6172 6473 (standards │ │ │ │ │ +000177a0: 2954 6f70 3a3a 292e 0a20 2020 2020 276f )Top::).. 'o │ │ │ │ │ +000177b0: 6273 6f6c 6574 6527 0a20 2020 2020 2020 bsolete'. │ │ │ │ │ +000177c0: 2020 206f 6273 6f6c 6574 6520 6665 6174 obsolete feat │ │ │ │ │ +000177d0: 7572 6573 206f 7220 636f 6e73 7472 7563 ures or construc │ │ │ │ │ +000177e0: 7469 6f6e 730a 2020 2020 2027 6f76 6572 tions. 'over │ │ │ │ │ +000177f0: 7269 6465 270a 2020 2020 2020 2020 2020 ride'. │ │ │ │ │ +00017800: 7573 6572 2072 6564 6566 696e 6974 696f user redefinitio │ │ │ │ │ +00017810: 6e73 206f 6620 4175 746f 6d61 6b65 2072 ns of Automake r │ │ │ │ │ +00017820: 756c 6573 206f 7220 7661 7269 6162 6c65 ules or variable │ │ │ │ │ +00017830: 730a 2020 2020 2027 706f 7274 6162 696c s. 'portabil │ │ │ │ │ +00017840: 6974 7927 0a20 2020 2020 2020 2020 2070 ity'. p │ │ │ │ │ +00017850: 6f72 7461 6269 6c69 7479 2069 7373 7565 ortability issue │ │ │ │ │ +00017860: 7320 2865 2e67 2e2c 2075 7365 206f 6620 s (e.g., use of │ │ │ │ │ +00017870: 276d 616b 6527 2066 6561 7475 7265 7320 'make' features │ │ │ │ │ +00017880: 7468 6174 2061 7265 0a20 2020 2020 2020 that are. │ │ │ │ │ +00017890: 2020 206b 6e6f 776e 2074 6f20 6265 206e known to be n │ │ │ │ │ +000178a0: 6f74 2070 6f72 7461 626c 6529 0a20 2020 ot portable). │ │ │ │ │ +000178b0: 2020 2765 7874 7261 2d70 6f72 7461 6269 'extra-portabi │ │ │ │ │ +000178c0: 6c69 7479 270a 2020 2020 2020 2020 2020 lity'. │ │ │ │ │ +000178d0: 6578 7472 6120 706f 7274 6162 696c 6974 extra portabilit │ │ │ │ │ +000178e0: 7920 6973 7375 6573 2072 656c 6174 6564 y issues related │ │ │ │ │ +000178f0: 2074 6f20 6f62 7363 7572 6520 746f 6f6c to obscure tool │ │ │ │ │ +00017900: 732e 2020 4f6e 650a 2020 2020 2020 2020 s. One. │ │ │ │ │ +00017910: 2020 6578 616d 706c 6520 6f66 2073 7563 example of suc │ │ │ │ │ +00017920: 6820 6120 746f 6f6c 2069 7320 7468 6520 h a tool is the │ │ │ │ │ +00017930: 4d69 6372 6f73 6f66 7420 276c 6962 2720 Microsoft 'lib' │ │ │ │ │ +00017940: 6172 6368 6976 6572 2e0a 2020 2020 2027 archiver.. ' │ │ │ │ │ +00017950: 7379 6e74 6178 270a 2020 2020 2020 2020 syntax'. │ │ │ │ │ +00017960: 2020 7765 6972 6420 7379 6e74 6178 2c20 weird syntax, │ │ │ │ │ +00017970: 756e 7573 6564 2076 6172 6961 626c 6573 unused variables │ │ │ │ │ +00017980: 2c20 7479 706f 730a 2020 2020 2027 756e , typos. 'un │ │ │ │ │ +00017990: 7375 7070 6f72 7465 6427 0a20 2020 2020 supported'. │ │ │ │ │ +000179a0: 2020 2020 2075 6e73 7570 706f 7274 6564 unsupported │ │ │ │ │ +000179b0: 206f 7220 696e 636f 6d70 6c65 7465 2066 or incomplete f │ │ │ │ │ +000179c0: 6561 7475 7265 730a 2020 2020 2027 616c eatures. 'al │ │ │ │ │ +000179d0: 6c27 0a20 2020 2020 2020 2020 2061 6c6c l'. all │ │ │ │ │ +000179e0: 2074 6865 2077 6172 6e69 6e67 730a 2020 the warnings. │ │ │ │ │ +000179f0: 2020 2027 6e6f 6e65 270a 2020 2020 2020 'none'. │ │ │ │ │ +00017a00: 2020 2020 7475 726e 206f 6666 2061 6c6c turn off all │ │ │ │ │ +00017a10: 2074 6865 2077 6172 6e69 6e67 730a 2020 the warnings. │ │ │ │ │ +00017a20: 2020 2027 6572 726f 7227 0a20 2020 2020 'error'. │ │ │ │ │ +00017a30: 2020 2020 2074 7265 6174 2077 6172 6e69 treat warni │ │ │ │ │ +00017a40: 6e67 7320 6173 2065 7272 6f72 730a 0a20 ngs as errors.. │ │ │ │ │ +00017a50: 2020 2020 4120 6361 7465 676f 7279 2063 A category c │ │ │ │ │ +00017a60: 616e 2062 6520 7475 726e 6564 206f 6666 an be turned off │ │ │ │ │ +00017a70: 2062 7920 7072 6566 6978 696e 6720 6974 by prefixing it │ │ │ │ │ +00017a80: 7320 6e61 6d65 2077 6974 6820 276e 6f2d s name with 'no- │ │ │ │ │ +00017a90: 272e 2020 466f 720a 2020 2020 2069 6e73 '. For. ins │ │ │ │ │ +00017aa0: 7461 6e63 652c 2027 2d57 6e6f 2d73 796e tance, '-Wno-syn │ │ │ │ │ +00017ab0: 7461 7827 2077 696c 6c20 6869 6465 2074 tax' will hide t │ │ │ │ │ +00017ac0: 6865 2077 6172 6e69 6e67 7320 6162 6f75 he warnings abou │ │ │ │ │ +00017ad0: 7420 756e 7573 6564 0a20 2020 2020 7661 t unused. va │ │ │ │ │ +00017ae0: 7269 6162 6c65 732e 0a0a 2020 2020 2054 riables... T │ │ │ │ │ +00017af0: 6865 2063 6174 6567 6f72 6965 7320 6f75 he categories ou │ │ │ │ │ +00017b00: 7470 7574 2062 7920 6465 6661 756c 7420 tput by default │ │ │ │ │ +00017b10: 6172 6520 2773 796e 7461 7827 2061 6e64 are 'syntax' and │ │ │ │ │ +00017b20: 2027 756e 7375 7070 6f72 7465 6427 2e0a 'unsupported'.. │ │ │ │ │ +00017b30: 2020 2020 2041 6464 6974 696f 6e61 6c6c Additionall │ │ │ │ │ +00017b40: 792c 2027 676e 7527 2061 6e64 2027 706f y, 'gnu' and 'po │ │ │ │ │ +00017b50: 7274 6162 696c 6974 7927 2061 7265 2065 rtability' are e │ │ │ │ │ +00017b60: 6e61 626c 6564 2069 6e20 272d 2d67 6e75 nabled in '--gnu │ │ │ │ │ +00017b70: 2720 616e 640a 2020 2020 2027 2d2d 676e ' and. '--gn │ │ │ │ │ +00017b80: 6974 7327 2073 7472 6963 746e 6573 732e its' strictness. │ │ │ │ │ +00017b90: 2020 4f6e 2074 6865 206f 7468 6572 2068 On the other h │ │ │ │ │ +00017ba0: 616e 642c 2074 6865 2027 7369 6c65 6e74 and, the 'silent │ │ │ │ │ +00017bb0: 2d72 756c 6573 270a 2020 2020 206f 7074 -rules'. opt │ │ │ │ │ +00017bc0: 696f 6e73 2028 2a6e 6f74 6520 4f70 7469 ions (*note Opti │ │ │ │ │ +00017bd0: 6f6e 733a 3a29 2074 7572 6e73 206f 6666 ons::) turns off │ │ │ │ │ +00017be0: 2070 6f72 7461 6269 6c69 7479 2077 6172 portability war │ │ │ │ │ +00017bf0: 6e69 6e67 7320 6162 6f75 740a 2020 2020 nings about. │ │ │ │ │ +00017c00: 2072 6563 7572 7369 7665 2076 6172 6961 recursive varia │ │ │ │ │ +00017c10: 626c 6520 6578 7061 6e73 696f 6e73 2e0a ble expansions.. │ │ │ │ │ +00017c20: 0a20 2020 2020 5475 726e 696e 6720 6f66 . Turning of │ │ │ │ │ +00017c30: 6620 2770 6f72 7461 6269 6c69 7479 2720 f 'portability' │ │ │ │ │ +00017c40: 7769 6c6c 2061 6c73 6f20 7475 726e 206f will also turn o │ │ │ │ │ +00017c50: 6666 2027 6578 7472 612d 706f 7274 6162 ff 'extra-portab │ │ │ │ │ +00017c60: 696c 6974 7927 2c0a 2020 2020 2061 6e64 ility',. and │ │ │ │ │ +00017c70: 2073 696d 696c 6172 6c79 2074 7572 6e69 similarly turni │ │ │ │ │ +00017c80: 6e67 206f 6e20 2765 7874 7261 2d70 6f72 ng on 'extra-por │ │ │ │ │ +00017c90: 7461 6269 6c69 7479 2720 7769 6c6c 2061 tability' will a │ │ │ │ │ +00017ca0: 6c73 6f20 7475 726e 206f 6e0a 2020 2020 lso turn on. │ │ │ │ │ +00017cb0: 2027 706f 7274 6162 696c 6974 7927 2e20 'portability'. │ │ │ │ │ +00017cc0: 2048 6f77 6576 6572 2c20 7475 726e 696e However, turnin │ │ │ │ │ +00017cd0: 6720 6f6e 2027 706f 7274 6162 696c 6974 g on 'portabilit │ │ │ │ │ +00017ce0: 7927 206f 7220 7475 726e 696e 6720 6f66 y' or turning of │ │ │ │ │ +00017cf0: 660a 2020 2020 2027 6578 7472 612d 706f f. 'extra-po │ │ │ │ │ +00017d00: 7274 6162 696c 6974 7927 2077 696c 6c20 rtability' will │ │ │ │ │ +00017d10: 6e6f 7420 6166 6665 6374 2074 6865 206f not affect the o │ │ │ │ │ +00017d20: 7468 6572 2063 6174 6567 6f72 792e 0a0a ther category... │ │ │ │ │ +00017d30: 2020 2020 2054 6865 2065 6e76 6972 6f6e The environ │ │ │ │ │ +00017d40: 6d65 6e74 2076 6172 6961 626c 6520 2757 ment variable 'W │ │ │ │ │ +00017d50: 4152 4e49 4e47 5327 2063 616e 2063 6f6e ARNINGS' can con │ │ │ │ │ +00017d60: 7461 696e 2061 2063 6f6d 6d61 2073 6570 tain a comma sep │ │ │ │ │ +00017d70: 6172 6174 6564 0a20 2020 2020 6c69 7374 arated. list │ │ │ │ │ +00017d80: 206f 6620 6361 7465 676f 7269 6573 2074 of categories t │ │ │ │ │ +00017d90: 6f20 656e 6162 6c65 2e20 2049 7420 7769 o enable. It wi │ │ │ │ │ +00017da0: 6c6c 2062 6520 7461 6b65 6e20 696e 746f ll be taken into │ │ │ │ │ +00017db0: 2061 6363 6f75 6e74 2062 6566 6f72 650a account before. │ │ │ │ │ +00017dc0: 2020 2020 2074 6865 2063 6f6d 6d61 6e64 the command │ │ │ │ │ +00017dd0: 2d6c 696e 6520 7377 6974 6368 6573 2c20 -line switches, │ │ │ │ │ +00017de0: 7468 6973 2077 6179 2027 2d57 6e6f 6e65 this way '-Wnone │ │ │ │ │ +00017df0: 2720 7769 6c6c 2061 6c73 6f20 6967 6e6f ' will also igno │ │ │ │ │ +00017e00: 7265 2061 6e79 0a20 2020 2020 7761 726e re any. warn │ │ │ │ │ +00017e10: 696e 6720 6361 7465 676f 7279 2065 6e61 ing category ena │ │ │ │ │ +00017e20: 626c 6564 2062 7920 2757 4152 4e49 4e47 bled by 'WARNING │ │ │ │ │ +00017e30: 5327 2e20 2054 6869 7320 7661 7269 6162 S'. This variab │ │ │ │ │ +00017e40: 6c65 2069 7320 616c 736f 2075 7365 640a le is also used. │ │ │ │ │ +00017e50: 2020 2020 2062 7920 6f74 6865 7220 746f by other to │ │ │ │ │ +00017e60: 6f6c 7320 6c69 6b65 2027 6175 746f 636f ols like 'autoco │ │ │ │ │ +00017e70: 6e66 273b 2075 6e6b 6e6f 776e 2063 6174 nf'; unknown cat │ │ │ │ │ +00017e80: 6567 6f72 6965 7320 6172 6520 6967 6e6f egories are igno │ │ │ │ │ +00017e90: 7265 6420 666f 720a 2020 2020 2074 6869 red for. thi │ │ │ │ │ +00017ea0: 7320 7265 6173 6f6e 2e0a 0a20 2020 4966 s reason... If │ │ │ │ │ +00017eb0: 2074 6865 2065 6e76 6972 6f6e 6d65 6e74 the environment │ │ │ │ │ +00017ec0: 2076 6172 6961 626c 6520 2741 5554 4f4d variable 'AUTOM │ │ │ │ │ +00017ed0: 414b 455f 4a4f 4253 2720 636f 6e74 6169 AKE_JOBS' contai │ │ │ │ │ +00017ee0: 6e73 2061 2070 6f73 6974 6976 650a 6e75 ns a positive.nu │ │ │ │ │ +00017ef0: 6d62 6572 2c20 6974 2069 7320 7461 6b65 mber, it is take │ │ │ │ │ +00017f00: 6e20 6173 2074 6865 206d 6178 696d 756d n as the maximum │ │ │ │ │ +00017f10: 206e 756d 6265 7220 6f66 2050 6572 6c20 number of Perl │ │ │ │ │ +00017f20: 7468 7265 6164 7320 746f 2075 7365 2069 threads to use i │ │ │ │ │ +00017f30: 6e0a 2761 7574 6f6d 616b 6527 2066 6f72 n.'automake' for │ │ │ │ │ +00017f40: 2067 656e 6572 6174 696e 6720 6d75 6c74 generating mult │ │ │ │ │ +00017f50: 6970 6c65 2027 4d61 6b65 6669 6c65 2e69 iple 'Makefile.i │ │ │ │ │ +00017f60: 6e27 2066 696c 6573 2063 6f6e 6375 7272 n' files concurr │ │ │ │ │ +00017f70: 656e 746c 792e 0a54 6869 7320 6973 2061 ently..This is a │ │ │ │ │ +00017f80: 6e20 6578 7065 7269 6d65 6e74 616c 2066 n experimental f │ │ │ │ │ +00017f90: 6561 7475 7265 2e0a 0a1f 0a46 696c 653a eature.....File: │ │ │ │ │ +00017fa0: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +00017fb0: 6e66 6f2c 2020 4e6f 6465 3a20 636f 6e66 nfo, Node: conf │ │ │ │ │ +00017fc0: 6967 7572 652c 2020 4e65 7874 3a20 4469 igure, Next: Di │ │ │ │ │ +00017fd0: 7265 6374 6f72 6965 732c 2020 5072 6576 rectories, Prev │ │ │ │ │ +00017fe0: 3a20 6175 746f 6d61 6b65 2049 6e76 6f63 : automake Invoc │ │ │ │ │ +00017ff0: 6174 696f 6e2c 2020 5570 3a20 546f 700a ation, Up: Top. │ │ │ │ │ +00018000: 0a36 2053 6361 6e6e 696e 6720 2763 6f6e .6 Scanning 'con │ │ │ │ │ +00018010: 6669 6775 7265 2e61 6327 2c20 7573 696e figure.ac', usin │ │ │ │ │ +00018020: 6720 2761 636c 6f63 616c 270a 2a2a 2a2a g 'aclocal'.**** │ │ │ │ │ 00018030: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 00018040: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00018050: 2a2a 2a2a 0a0a 4175 746f 6d61 6b65 2073 ****..Automake s │ │ │ │ │ -00018060: 6361 6e73 2074 6865 2070 6163 6b61 6765 cans the package │ │ │ │ │ -00018070: 2773 2027 636f 6e66 6967 7572 652e 6163 's 'configure.ac │ │ │ │ │ -00018080: 2720 746f 2064 6574 6572 6d69 6e65 2063 ' to determine c │ │ │ │ │ -00018090: 6572 7461 696e 0a69 6e66 6f72 6d61 7469 ertain.informati │ │ │ │ │ -000180a0: 6f6e 2061 626f 7574 2074 6865 2070 6163 on about the pac │ │ │ │ │ -000180b0: 6b61 6765 2e20 2053 6f6d 6520 2761 7574 kage. Some 'aut │ │ │ │ │ -000180c0: 6f63 6f6e 6627 206d 6163 726f 7320 6172 oconf' macros ar │ │ │ │ │ -000180d0: 6520 7265 7175 6972 6564 2061 6e64 0a73 e required and.s │ │ │ │ │ -000180e0: 6f6d 6520 7661 7269 6162 6c65 7320 6d75 ome variables mu │ │ │ │ │ -000180f0: 7374 2062 6520 6465 6669 6e65 6420 696e st be defined in │ │ │ │ │ -00018100: 2027 636f 6e66 6967 7572 652e 6163 272e 'configure.ac'. │ │ │ │ │ -00018110: 2020 4175 746f 6d61 6b65 2077 696c 6c20 Automake will │ │ │ │ │ -00018120: 616c 736f 0a75 7365 2069 6e66 6f72 6d61 also.use informa │ │ │ │ │ -00018130: 7469 6f6e 2066 726f 6d20 2763 6f6e 6669 tion from 'confi │ │ │ │ │ -00018140: 6775 7265 2e61 6327 2074 6f20 6675 7274 gure.ac' to furt │ │ │ │ │ -00018150: 6865 7220 7461 696c 6f72 2069 7473 206f her tailor its o │ │ │ │ │ -00018160: 7574 7075 742e 0a0a 2020 2041 7574 6f6d utput... Autom │ │ │ │ │ -00018170: 616b 6520 616c 736f 2073 7570 706c 6965 ake also supplie │ │ │ │ │ -00018180: 7320 736f 6d65 2041 7574 6f63 6f6e 6620 s some Autoconf │ │ │ │ │ -00018190: 6d61 6372 6f73 2074 6f20 6d61 6b65 2074 macros to make t │ │ │ │ │ -000181a0: 6865 206d 6169 6e74 656e 616e 6365 0a65 he maintenance.e │ │ │ │ │ -000181b0: 6173 6965 722e 2020 5468 6573 6520 6d61 asier. These ma │ │ │ │ │ -000181c0: 6372 6f73 2063 616e 2061 7574 6f6d 6174 cros can automat │ │ │ │ │ -000181d0: 6963 616c 6c79 2062 6520 7075 7420 696e ically be put in │ │ │ │ │ -000181e0: 746f 2079 6f75 7220 2761 636c 6f63 616c to your 'aclocal │ │ │ │ │ -000181f0: 2e6d 3427 0a75 7369 6e67 2074 6865 2027 .m4'.using the ' │ │ │ │ │ -00018200: 6163 6c6f 6361 6c27 2070 726f 6772 616d aclocal' program │ │ │ │ │ -00018210: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 5265 ...* Menu:..* Re │ │ │ │ │ -00018220: 7175 6972 656d 656e 7473 3a3a 2020 2020 quirements:: │ │ │ │ │ -00018230: 2020 2020 2020 2020 2020 2020 436f 6e66 Conf │ │ │ │ │ -00018240: 6967 7572 6174 696f 6e20 7265 7175 6972 iguration requir │ │ │ │ │ -00018250: 656d 656e 7473 0a2a 204f 7074 696f 6e61 ements.* Optiona │ │ │ │ │ -00018260: 6c3a 3a20 2020 2020 2020 2020 2020 2020 l:: │ │ │ │ │ -00018270: 2020 2020 2020 204f 7468 6572 2074 6869 Other thi │ │ │ │ │ -00018280: 6e67 7320 4175 746f 6d61 6b65 2072 6563 ngs Automake rec │ │ │ │ │ -00018290: 6f67 6e69 7a65 730a 2a20 6163 6c6f 6361 ognizes.* acloca │ │ │ │ │ -000182a0: 6c20 496e 766f 6361 7469 6f6e 3a3a 2020 l Invocation:: │ │ │ │ │ -000182b0: 2020 2020 2020 2020 4175 746f 2d67 656e Auto-gen │ │ │ │ │ -000182c0: 6572 6174 696e 6720 6163 6c6f 6361 6c2e erating aclocal. │ │ │ │ │ -000182d0: 6d34 0a2a 204d 6163 726f 733a 3a20 2020 m4.* Macros:: │ │ │ │ │ +00018050: 2a2a 2a2a 2a2a 0a0a 4175 746f 6d61 6b65 ******..Automake │ │ │ │ │ +00018060: 2073 6361 6e73 2074 6865 2070 6163 6b61 scans the packa │ │ │ │ │ +00018070: 6765 2773 2027 636f 6e66 6967 7572 652e ge's 'configure. │ │ │ │ │ +00018080: 6163 2720 746f 2064 6574 6572 6d69 6e65 ac' to determine │ │ │ │ │ +00018090: 2063 6572 7461 696e 0a69 6e66 6f72 6d61 certain.informa │ │ │ │ │ +000180a0: 7469 6f6e 2061 626f 7574 2074 6865 2070 tion about the p │ │ │ │ │ +000180b0: 6163 6b61 6765 2e20 2053 6f6d 6520 2761 ackage. Some 'a │ │ │ │ │ +000180c0: 7574 6f63 6f6e 6627 206d 6163 726f 7320 utoconf' macros │ │ │ │ │ +000180d0: 6172 6520 7265 7175 6972 6564 2061 6e64 are required and │ │ │ │ │ +000180e0: 0a73 6f6d 6520 7661 7269 6162 6c65 7320 .some variables │ │ │ │ │ +000180f0: 6d75 7374 2062 6520 6465 6669 6e65 6420 must be defined │ │ │ │ │ +00018100: 696e 2027 636f 6e66 6967 7572 652e 6163 in 'configure.ac │ │ │ │ │ +00018110: 272e 2020 4175 746f 6d61 6b65 2077 696c '. Automake wil │ │ │ │ │ +00018120: 6c20 616c 736f 0a75 7365 2069 6e66 6f72 l also.use infor │ │ │ │ │ +00018130: 6d61 7469 6f6e 2066 726f 6d20 2763 6f6e mation from 'con │ │ │ │ │ +00018140: 6669 6775 7265 2e61 6327 2074 6f20 6675 figure.ac' to fu │ │ │ │ │ +00018150: 7274 6865 7220 7461 696c 6f72 2069 7473 rther tailor its │ │ │ │ │ +00018160: 206f 7574 7075 742e 0a0a 2020 2041 7574 output... Aut │ │ │ │ │ +00018170: 6f6d 616b 6520 616c 736f 2073 7570 706c omake also suppl │ │ │ │ │ +00018180: 6965 7320 736f 6d65 2041 7574 6f63 6f6e ies some Autocon │ │ │ │ │ +00018190: 6620 6d61 6372 6f73 2074 6f20 6d61 6b65 f macros to make │ │ │ │ │ +000181a0: 2074 6865 206d 6169 6e74 656e 616e 6365 the maintenance │ │ │ │ │ +000181b0: 0a65 6173 6965 722e 2020 5468 6573 6520 .easier. These │ │ │ │ │ +000181c0: 6d61 6372 6f73 2063 616e 2061 7574 6f6d macros can autom │ │ │ │ │ +000181d0: 6174 6963 616c 6c79 2062 6520 7075 7420 atically be put │ │ │ │ │ +000181e0: 696e 746f 2079 6f75 7220 2761 636c 6f63 into your 'acloc │ │ │ │ │ +000181f0: 616c 2e6d 3427 0a75 7369 6e67 2074 6865 al.m4'.using the │ │ │ │ │ +00018200: 2027 6163 6c6f 6361 6c27 2070 726f 6772 'aclocal' progr │ │ │ │ │ +00018210: 616d 2e0a 0a2a 204d 656e 753a 0a0a 2a20 am...* Menu:..* │ │ │ │ │ +00018220: 5265 7175 6972 656d 656e 7473 3a3a 2020 Requirements:: │ │ │ │ │ +00018230: 2020 2020 2020 2020 2020 2020 2020 436f Co │ │ │ │ │ +00018240: 6e66 6967 7572 6174 696f 6e20 7265 7175 nfiguration requ │ │ │ │ │ +00018250: 6972 656d 656e 7473 0a2a 204f 7074 696f irements.* Optio │ │ │ │ │ +00018260: 6e61 6c3a 3a20 2020 2020 2020 2020 2020 nal:: │ │ │ │ │ +00018270: 2020 2020 2020 2020 204f 7468 6572 2074 Other t │ │ │ │ │ +00018280: 6869 6e67 7320 4175 746f 6d61 6b65 2072 hings Automake r │ │ │ │ │ +00018290: 6563 6f67 6e69 7a65 730a 2a20 6163 6c6f ecognizes.* aclo │ │ │ │ │ +000182a0: 6361 6c20 496e 766f 6361 7469 6f6e 3a3a cal Invocation:: │ │ │ │ │ +000182b0: 2020 2020 2020 2020 2020 4175 746f 2d67 Auto-g │ │ │ │ │ +000182c0: 656e 6572 6174 696e 6720 6163 6c6f 6361 enerating acloca │ │ │ │ │ +000182d0: 6c2e 6d34 0a2a 204d 6163 726f 733a 3a20 l.m4.* Macros:: │ │ │ │ │ 000182e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000182f0: 2020 2041 7574 6f63 6f6e 6620 6d61 6372 Autoconf macr │ │ │ │ │ -00018300: 6f73 2073 7570 706c 6965 6420 7769 7468 os supplied with │ │ │ │ │ -00018310: 2041 7574 6f6d 616b 650a 0a1f 0a46 696c Automake....Fil │ │ │ │ │ -00018320: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -00018330: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5265 .info, Node: Re │ │ │ │ │ -00018340: 7175 6972 656d 656e 7473 2c20 204e 6578 quirements, Nex │ │ │ │ │ -00018350: 743a 204f 7074 696f 6e61 6c2c 2020 5570 t: Optional, Up │ │ │ │ │ -00018360: 3a20 636f 6e66 6967 7572 650a 0a36 2e31 : configure..6.1 │ │ │ │ │ -00018370: 2043 6f6e 6669 6775 7261 7469 6f6e 2072 Configuration r │ │ │ │ │ -00018380: 6571 7569 7265 6d65 6e74 730a 3d3d 3d3d equirements.==== │ │ │ │ │ +000182f0: 2020 2020 2041 7574 6f63 6f6e 6620 6d61 Autoconf ma │ │ │ │ │ +00018300: 6372 6f73 2073 7570 706c 6965 6420 7769 cros supplied wi │ │ │ │ │ +00018310: 7468 2041 7574 6f6d 616b 650a 0a1f 0a46 th Automake....F │ │ │ │ │ +00018320: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +00018330: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +00018340: 5265 7175 6972 656d 656e 7473 2c20 204e Requirements, N │ │ │ │ │ +00018350: 6578 743a 204f 7074 696f 6e61 6c2c 2020 ext: Optional, │ │ │ │ │ +00018360: 5570 3a20 636f 6e66 6967 7572 650a 0a36 Up: configure..6 │ │ │ │ │ +00018370: 2e31 2043 6f6e 6669 6775 7261 7469 6f6e .1 Configuration │ │ │ │ │ +00018380: 2072 6571 7569 7265 6d65 6e74 730a 3d3d requirements.== │ │ │ │ │ 00018390: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000183a0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ -000183b0: 6f6e 6520 7265 616c 2072 6571 7569 7265 one real require │ │ │ │ │ -000183c0: 6d65 6e74 206f 6620 4175 746f 6d61 6b65 ment of Automake │ │ │ │ │ -000183d0: 2069 7320 7468 6174 2079 6f75 7220 2763 is that your 'c │ │ │ │ │ -000183e0: 6f6e 6669 6775 7265 2e61 6327 2063 616c onfigure.ac' cal │ │ │ │ │ -000183f0: 6c0a 2741 4d5f 494e 4954 5f41 5554 4f4d l.'AM_INIT_AUTOM │ │ │ │ │ -00018400: 414b 4527 2e20 2054 6869 7320 6d61 6372 AKE'. This macr │ │ │ │ │ -00018410: 6f20 646f 6573 2073 6576 6572 616c 2074 o does several t │ │ │ │ │ -00018420: 6869 6e67 7320 7468 6174 2061 7265 2072 hings that are r │ │ │ │ │ -00018430: 6571 7569 7265 640a 666f 7220 7072 6f70 equired.for prop │ │ │ │ │ -00018440: 6572 2041 7574 6f6d 616b 6520 6f70 6572 er Automake oper │ │ │ │ │ -00018450: 6174 696f 6e20 282a 6e6f 7465 204d 6163 ation (*note Mac │ │ │ │ │ -00018460: 726f 733a 3a29 2e0a 0a20 2020 4865 7265 ros::)... Here │ │ │ │ │ -00018470: 2061 7265 2074 6865 206f 7468 6572 206d are the other m │ │ │ │ │ -00018480: 6163 726f 7320 7468 6174 2041 7574 6f6d acros that Autom │ │ │ │ │ -00018490: 616b 6520 7265 7175 6972 6573 2062 7574 ake requires but │ │ │ │ │ -000184a0: 2077 6869 6368 2061 7265 206e 6f74 0a72 which are not.r │ │ │ │ │ -000184b0: 756e 2062 7920 2741 4d5f 494e 4954 5f41 un by 'AM_INIT_A │ │ │ │ │ -000184c0: 5554 4f4d 414b 4527 3a0a 0a27 4143 5f43 UTOMAKE':..'AC_C │ │ │ │ │ -000184d0: 4f4e 4649 475f 4649 4c45 5327 0a27 4143 ONFIG_FILES'.'AC │ │ │ │ │ -000184e0: 5f4f 5554 5055 5427 0a20 2020 2020 5468 _OUTPUT'. Th │ │ │ │ │ -000184f0: 6573 6520 7477 6f20 6d61 6372 6f73 2061 ese two macros a │ │ │ │ │ -00018500: 7265 2075 7375 616c 6c79 2069 6e76 6f6b re usually invok │ │ │ │ │ -00018510: 6564 2061 7320 666f 6c6c 6f77 7320 6e65 ed as follows ne │ │ │ │ │ -00018520: 6172 2074 6865 2065 6e64 206f 660a 2020 ar the end of. │ │ │ │ │ -00018530: 2020 2027 636f 6e66 6967 7572 652e 6163 'configure.ac │ │ │ │ │ -00018540: 272e 0a0a 2020 2020 2020 2020 2020 2e2e '... .. │ │ │ │ │ -00018550: 2e0a 2020 2020 2020 2020 2020 4143 5f43 .. AC_C │ │ │ │ │ -00018560: 4f4e 4649 475f 4649 4c45 5328 5b0a 2020 ONFIG_FILES([. │ │ │ │ │ -00018570: 2020 2020 2020 2020 2020 4d61 6b65 6669 Makefi │ │ │ │ │ -00018580: 6c65 0a20 2020 2020 2020 2020 2020 2064 le. d │ │ │ │ │ -00018590: 6f63 2f4d 616b 6566 696c 650a 2020 2020 oc/Makefile. │ │ │ │ │ -000185a0: 2020 2020 2020 2020 7372 632f 4d61 6b65 src/Make │ │ │ │ │ -000185b0: 6669 6c65 0a20 2020 2020 2020 2020 2020 file. │ │ │ │ │ -000185c0: 2073 7263 2f6c 6962 2f4d 616b 6566 696c src/lib/Makefil │ │ │ │ │ -000185d0: 650a 2020 2020 2020 2020 2020 2020 2e2e e. .. │ │ │ │ │ -000185e0: 2e0a 2020 2020 2020 2020 2020 5d29 0a20 .. ]). │ │ │ │ │ -000185f0: 2020 2020 2020 2020 2041 435f 4f55 5450 AC_OUTP │ │ │ │ │ -00018600: 5554 0a0a 2020 2020 2041 7574 6f6d 616b UT.. Automak │ │ │ │ │ -00018610: 6520 7573 6573 2074 6865 7365 2074 6f20 e uses these to │ │ │ │ │ -00018620: 6465 7465 726d 696e 6520 7768 6963 6820 determine which │ │ │ │ │ -00018630: 6669 6c65 7320 746f 2063 7265 6174 6520 files to create │ │ │ │ │ -00018640: 282a 6e6f 7465 0a20 2020 2020 4372 6561 (*note. Crea │ │ │ │ │ -00018650: 7469 6e67 204f 7574 7075 7420 4669 6c65 ting Output File │ │ │ │ │ -00018660: 733a 2028 6175 746f 636f 6e66 294f 7574 s: (autoconf)Out │ │ │ │ │ -00018670: 7075 742e 292e 2020 4120 6c69 7374 6564 put.). A listed │ │ │ │ │ -00018680: 2066 696c 6520 6973 0a20 2020 2020 636f file is. co │ │ │ │ │ -00018690: 6e73 6964 6572 6564 2074 6f20 6265 2061 nsidered to be a │ │ │ │ │ -000186a0: 6e20 4175 746f 6d61 6b65 2067 656e 6572 n Automake gener │ │ │ │ │ -000186b0: 6174 6564 2027 4d61 6b65 6669 6c65 2720 ated 'Makefile' │ │ │ │ │ -000186c0: 6966 2074 6865 7265 2065 7869 7374 7320 if there exists │ │ │ │ │ -000186d0: 610a 2020 2020 2066 696c 6520 7769 7468 a. file with │ │ │ │ │ -000186e0: 2074 6865 2073 616d 6520 6e61 6d65 2061 the same name a │ │ │ │ │ -000186f0: 6e64 2074 6865 2027 2e61 6d27 2065 7874 nd the '.am' ext │ │ │ │ │ -00018700: 656e 7369 6f6e 2061 7070 656e 6465 642e ension appended. │ │ │ │ │ -00018710: 0a20 2020 2020 5479 7069 6361 6c6c 792c . Typically, │ │ │ │ │ -00018720: 2027 4143 5f43 4f4e 4649 475f 4649 4c45 'AC_CONFIG_FILE │ │ │ │ │ -00018730: 5328 5b66 6f6f 2f4d 616b 6566 696c 655d S([foo/Makefile] │ │ │ │ │ -00018740: 2927 2077 696c 6c20 6361 7573 6520 4175 )' will cause Au │ │ │ │ │ -00018750: 746f 6d61 6b65 2074 6f0a 2020 2020 2067 tomake to. g │ │ │ │ │ -00018760: 656e 6572 6174 6520 2766 6f6f 2f4d 616b enerate 'foo/Mak │ │ │ │ │ -00018770: 6566 696c 652e 696e 2720 6966 2027 666f efile.in' if 'fo │ │ │ │ │ -00018780: 6f2f 4d61 6b65 6669 6c65 2e61 6d27 2065 o/Makefile.am' e │ │ │ │ │ -00018790: 7869 7374 732e 0a0a 2020 2020 2057 6865 xists... Whe │ │ │ │ │ -000187a0: 6e20 7573 696e 6720 2741 435f 434f 4e46 n using 'AC_CONF │ │ │ │ │ -000187b0: 4947 5f46 494c 4553 2720 7769 7468 206d IG_FILES' with m │ │ │ │ │ -000187c0: 756c 7469 706c 6520 696e 7075 7420 6669 ultiple input fi │ │ │ │ │ -000187d0: 6c65 732c 2061 7320 696e 0a0a 2020 2020 les, as in.. │ │ │ │ │ -000187e0: 2020 2020 2020 4143 5f43 4f4e 4649 475f AC_CONFIG_ │ │ │ │ │ -000187f0: 4649 4c45 5328 5b4d 616b 6566 696c 653a FILES([Makefile: │ │ │ │ │ -00018800: 746f 702e 696e 3a4d 616b 6566 696c 652e top.in:Makefile. │ │ │ │ │ -00018810: 696e 3a62 6f74 2e69 6e5d 290a 0a20 2020 in:bot.in]).. │ │ │ │ │ -00018820: 2020 2761 7574 6f6d 616b 6527 2077 696c 'automake' wil │ │ │ │ │ -00018830: 6c20 6765 6e65 7261 7465 2074 6865 2066 l generate the f │ │ │ │ │ -00018840: 6972 7374 2027 2e69 6e27 2069 6e70 7574 irst '.in' input │ │ │ │ │ -00018850: 2066 696c 6520 666f 7220 7768 6963 6820 file for which │ │ │ │ │ -00018860: 610a 2020 2020 2027 2e61 6d27 2066 696c a. '.am' fil │ │ │ │ │ -00018870: 6520 6578 6973 7473 2e20 2049 6620 6e6f e exists. If no │ │ │ │ │ -00018880: 2073 7563 6820 6669 6c65 2065 7869 7374 such file exist │ │ │ │ │ -00018890: 7320 7468 6520 6f75 7470 7574 2066 696c s the output fil │ │ │ │ │ -000188a0: 6520 6973 206e 6f74 0a20 2020 2020 636f e is not. co │ │ │ │ │ -000188b0: 6e73 6964 6572 6564 2074 6f20 6265 2067 nsidered to be g │ │ │ │ │ -000188c0: 656e 6572 6174 6564 2062 7920 4175 746f enerated by Auto │ │ │ │ │ -000188d0: 6d61 6b65 2e0a 0a20 2020 2020 4669 6c65 make... File │ │ │ │ │ -000188e0: 7320 6372 6561 7465 6420 6279 2027 4143 s created by 'AC │ │ │ │ │ -000188f0: 5f43 4f4e 4649 475f 4649 4c45 5327 2c20 _CONFIG_FILES', │ │ │ │ │ -00018900: 6265 2074 6865 7920 4175 746f 6d61 6b65 be they Automake │ │ │ │ │ -00018910: 2027 4d61 6b65 6669 6c65 2773 206f 720a 'Makefile's or. │ │ │ │ │ -00018920: 2020 2020 206e 6f74 2c20 6172 6520 616c not, are al │ │ │ │ │ -00018930: 6c20 7265 6d6f 7665 6420 6279 2027 6d61 l removed by 'ma │ │ │ │ │ -00018940: 6b65 2064 6973 7463 6c65 616e 272e 2020 ke distclean'. │ │ │ │ │ -00018950: 5468 6569 7220 696e 7075 7473 2061 7265 Their inputs are │ │ │ │ │ -00018960: 0a20 2020 2020 6175 746f 6d61 7469 6361 . automatica │ │ │ │ │ -00018970: 6c6c 7920 6469 7374 7269 6275 7465 642c lly distributed, │ │ │ │ │ -00018980: 2075 6e6c 6573 7320 7468 6579 2061 7265 unless they are │ │ │ │ │ -00018990: 2074 6865 206f 7574 7075 7420 6f66 2070 the output of p │ │ │ │ │ -000189a0: 7269 6f72 0a20 2020 2020 2741 435f 434f rior. 'AC_CO │ │ │ │ │ -000189b0: 4e46 4947 5f46 494c 4553 2720 636f 6d6d NFIG_FILES' comm │ │ │ │ │ -000189c0: 616e 6473 2e20 2046 696e 616c 6c79 2c20 ands. Finally, │ │ │ │ │ -000189d0: 7265 6275 696c 6420 7275 6c65 7320 6172 rebuild rules ar │ │ │ │ │ -000189e0: 6520 6765 6e65 7261 7465 640a 2020 2020 e generated. │ │ │ │ │ -000189f0: 2069 6e20 7468 6520 4175 746f 6d61 6b65 in the Automake │ │ │ │ │ -00018a00: 2027 4d61 6b65 6669 6c65 2720 6578 6973 'Makefile' exis │ │ │ │ │ -00018a10: 7469 6e67 2069 6e20 7468 6520 7375 6264 ting in the subd │ │ │ │ │ -00018a20: 6972 6563 746f 7279 206f 6620 7468 650a irectory of the. │ │ │ │ │ -00018a30: 2020 2020 206f 7574 7075 7420 6669 6c65 output file │ │ │ │ │ -00018a40: 2c20 6966 2074 6865 7265 2069 7320 6f6e , if there is on │ │ │ │ │ -00018a50: 652c 206f 7220 696e 2074 6865 2074 6f70 e, or in the top │ │ │ │ │ -00018a60: 2d6c 6576 656c 2027 4d61 6b65 6669 6c65 -level 'Makefile │ │ │ │ │ -00018a70: 270a 2020 2020 206f 7468 6572 7769 7365 '. otherwise │ │ │ │ │ -00018a80: 2e0a 0a20 2020 2020 5468 6520 6162 6f76 ... The abov │ │ │ │ │ -00018a90: 6520 6d61 6368 696e 6572 7920 2863 6c65 e machinery (cle │ │ │ │ │ -00018aa0: 616e 696e 672c 2064 6973 7472 6962 7574 aning, distribut │ │ │ │ │ -00018ab0: 696e 672c 2061 6e64 2072 6562 7569 6c64 ing, and rebuild │ │ │ │ │ -00018ac0: 696e 6729 2077 6f72 6b73 0a20 2020 2020 ing) works. │ │ │ │ │ -00018ad0: 6669 6e65 2069 6620 7468 6520 2741 435f fine if the 'AC_ │ │ │ │ │ -00018ae0: 434f 4e46 4947 5f46 494c 4553 2720 7370 CONFIG_FILES' sp │ │ │ │ │ -00018af0: 6563 6966 6963 6174 696f 6e73 2063 6f6e ecifications con │ │ │ │ │ -00018b00: 7461 696e 206f 6e6c 7920 6c69 7465 7261 tain only litera │ │ │ │ │ -00018b10: 6c73 2e0a 2020 2020 2049 6620 7061 7274 ls.. If part │ │ │ │ │ -00018b20: 206f 6620 7468 6520 7370 6563 6966 6963 of the specific │ │ │ │ │ -00018b30: 6174 696f 6e20 7573 6573 2073 6865 6c6c ation uses shell │ │ │ │ │ -00018b40: 2076 6172 6961 626c 6573 2c20 2761 7574 variables, 'aut │ │ │ │ │ -00018b50: 6f6d 616b 6527 2077 696c 6c0a 2020 2020 omake' will. │ │ │ │ │ -00018b60: 206e 6f74 2062 6520 6162 6c65 2074 6f20 not be able to │ │ │ │ │ -00018b70: 6675 6c66 696c 6c20 7468 6973 2073 6574 fulfill this set │ │ │ │ │ -00018b80: 7570 2c20 616e 6420 796f 7520 7769 6c6c up, and you will │ │ │ │ │ -00018b90: 2068 6176 6520 746f 2063 6f6d 706c 6574 have to complet │ │ │ │ │ -00018ba0: 650a 2020 2020 2074 6865 206d 6973 7369 e. the missi │ │ │ │ │ -00018bb0: 6e67 2062 6974 7320 6279 2068 616e 642e ng bits by hand. │ │ │ │ │ -00018bc0: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ -00018bd0: 6f6e 0a0a 2020 2020 2020 2020 2020 6669 on.. fi │ │ │ │ │ -00018be0: 6c65 3d69 6e70 7574 0a20 2020 2020 2020 le=input. │ │ │ │ │ -00018bf0: 2020 202e 2e2e 0a20 2020 2020 2020 2020 .... │ │ │ │ │ -00018c00: 2041 435f 434f 4e46 4947 5f46 494c 4553 AC_CONFIG_FILES │ │ │ │ │ -00018c10: 285b 6f75 7470 7574 3a24 6669 6c65 5d2c ([output:$file], │ │ │ │ │ -00018c20: 2c20 5b66 696c 653d 2466 696c 655d 290a , [file=$file]). │ │ │ │ │ -00018c30: 0a20 2020 2020 2761 7574 6f6d 616b 6527 . 'automake' │ │ │ │ │ -00018c40: 2077 696c 6c20 6f75 7470 7574 2072 756c will output rul │ │ │ │ │ -00018c50: 6573 2074 6f20 636c 6561 6e20 276f 7574 es to clean 'out │ │ │ │ │ -00018c60: 7075 7427 2c20 616e 6420 7265 6275 696c put', and rebuil │ │ │ │ │ -00018c70: 6420 6974 2e0a 2020 2020 2048 6f77 6576 d it.. Howev │ │ │ │ │ -00018c80: 6572 2074 6865 2072 6562 7569 6c64 2072 er the rebuild r │ │ │ │ │ -00018c90: 756c 6520 7769 6c6c 206e 6f74 2064 6570 ule will not dep │ │ │ │ │ -00018ca0: 656e 6420 6f6e 2027 696e 7075 7427 2c20 end on 'input', │ │ │ │ │ -00018cb0: 616e 6420 7468 6973 2066 696c 650a 2020 and this file. │ │ │ │ │ -00018cc0: 2020 2077 696c 6c20 6e6f 7420 6265 2064 will not be d │ │ │ │ │ -00018cd0: 6973 7472 6962 7574 6564 2065 6974 6865 istributed eithe │ │ │ │ │ -00018ce0: 722e 2020 2859 6f75 206d 7573 7420 6164 r. (You must ad │ │ │ │ │ -00018cf0: 6420 2745 5854 5241 5f44 4953 5420 3d20 d 'EXTRA_DIST = │ │ │ │ │ -00018d00: 696e 7075 7427 0a20 2020 2020 746f 2079 input'. to y │ │ │ │ │ -00018d10: 6f75 7220 274d 616b 6566 696c 652e 616d our 'Makefile.am │ │ │ │ │ -00018d20: 2720 6966 2027 696e 7075 7427 2069 7320 ' if 'input' is │ │ │ │ │ -00018d30: 6120 736f 7572 6365 2066 696c 652e 290a a source file.). │ │ │ │ │ -00018d40: 0a20 2020 2020 5369 6d69 6c61 726c 790a . Similarly. │ │ │ │ │ -00018d50: 0a20 2020 2020 2020 2020 2066 696c 653d . file= │ │ │ │ │ -00018d60: 6f75 7470 7574 0a20 2020 2020 2020 2020 output. │ │ │ │ │ -00018d70: 2066 696c 6532 3d6f 7574 3a69 6e0a 2020 file2=out:in. │ │ │ │ │ -00018d80: 2020 2020 2020 2020 2e2e 2e0a 2020 2020 .... │ │ │ │ │ -00018d90: 2020 2020 2020 4143 5f43 4f4e 4649 475f AC_CONFIG_ │ │ │ │ │ -00018da0: 4649 4c45 5328 5b24 6669 6c65 3a69 6e70 FILES([$file:inp │ │ │ │ │ -00018db0: 7574 5d2c 2c20 5b66 696c 653d 2466 696c ut],, [file=$fil │ │ │ │ │ -00018dc0: 655d 290a 2020 2020 2020 2020 2020 4143 e]). AC │ │ │ │ │ -00018dd0: 5f43 4f4e 4649 475f 4649 4c45 5328 5b24 _CONFIG_FILES([$ │ │ │ │ │ -00018de0: 6669 6c65 325d 2c2c 205b 6669 6c65 323d file2],, [file2= │ │ │ │ │ -00018df0: 2466 696c 6532 5d29 0a0a 2020 2020 2077 $file2]).. w │ │ │ │ │ -00018e00: 696c 6c20 6f6e 6c79 2063 6175 7365 2027 ill only cause ' │ │ │ │ │ -00018e10: 696e 7075 7427 2074 6f20 6265 2064 6973 input' to be dis │ │ │ │ │ -00018e20: 7472 6962 7574 6564 2e20 204e 6f20 6669 tributed. No fi │ │ │ │ │ -00018e30: 6c65 2077 696c 6c20 6265 2063 6c65 616e le will be clean │ │ │ │ │ -00018e40: 6564 0a20 2020 2020 6175 746f 6d61 7469 ed. automati │ │ │ │ │ -00018e50: 6361 6c6c 7920 2861 6464 2027 4449 5354 cally (add 'DIST │ │ │ │ │ -00018e60: 434c 4541 4e46 494c 4553 203d 206f 7574 CLEANFILES = out │ │ │ │ │ -00018e70: 7075 7420 6f75 7427 2079 6f75 7273 656c put out' yoursel │ │ │ │ │ -00018e80: 6629 2c20 616e 6420 6e6f 0a20 2020 2020 f), and no. │ │ │ │ │ -00018e90: 7265 6275 696c 6420 7275 6c65 2077 696c rebuild rule wil │ │ │ │ │ -00018ea0: 6c20 6265 206f 7574 7075 742e 0a0a 2020 l be output... │ │ │ │ │ -00018eb0: 2020 204f 6276 696f 7573 6c79 2027 6175 Obviously 'au │ │ │ │ │ -00018ec0: 746f 6d61 6b65 2720 6361 6e6e 6f74 2067 tomake' cannot g │ │ │ │ │ -00018ed0: 7565 7373 2077 6861 7420 7661 6c75 6520 uess what value │ │ │ │ │ -00018ee0: 2724 6669 6c65 2720 6973 2067 6f69 6e67 '$file' is going │ │ │ │ │ -00018ef0: 2074 6f0a 2020 2020 2068 6f6c 6420 6c61 to. hold la │ │ │ │ │ -00018f00: 7465 7220 7768 656e 2027 636f 6e66 6967 ter when 'config │ │ │ │ │ -00018f10: 7572 6527 2069 7320 7275 6e2c 2061 6e64 ure' is run, and │ │ │ │ │ -00018f20: 2069 7420 6361 6e6e 6f74 2075 7365 2074 it cannot use t │ │ │ │ │ -00018f30: 6865 2073 6865 6c6c 0a20 2020 2020 7661 he shell. va │ │ │ │ │ -00018f40: 7269 6162 6c65 2027 2466 696c 6527 2069 riable '$file' i │ │ │ │ │ -00018f50: 6e20 6120 274d 616b 6566 696c 6527 2e20 n a 'Makefile'. │ │ │ │ │ -00018f60: 2048 6f77 6576 6572 2c20 6966 2079 6f75 However, if you │ │ │ │ │ -00018f70: 206d 616b 6520 7265 6665 7265 6e63 650a make reference. │ │ │ │ │ -00018f80: 2020 2020 2074 6f20 2724 6669 6c65 2720 to '$file' │ │ │ │ │ -00018f90: 6173 2027 247b 6669 6c65 7d27 2028 692e as '${file}' (i. │ │ │ │ │ -00018fa0: 652e 2c20 696e 2061 2077 6179 2074 6861 e., in a way tha │ │ │ │ │ -00018fb0: 7420 6973 2063 6f6d 7061 7469 626c 6520 t is compatible │ │ │ │ │ -00018fc0: 7769 7468 0a20 2020 2020 276d 616b 6527 with. 'make' │ │ │ │ │ -00018fd0: 2773 2073 796e 7461 7829 2061 6e64 2066 's syntax) and f │ │ │ │ │ -00018fe0: 7572 7468 6572 6d6f 7265 2075 7365 2027 urthermore use ' │ │ │ │ │ -00018ff0: 4143 5f53 5542 5354 2720 746f 2065 6e73 AC_SUBST' to ens │ │ │ │ │ -00019000: 7572 6520 7468 6174 0a20 2020 2020 2724 ure that. '$ │ │ │ │ │ -00019010: 7b66 696c 657d 2720 6973 206d 6561 6e69 {file}' is meani │ │ │ │ │ -00019020: 6e67 6675 6c20 696e 2061 2027 4d61 6b65 ngful in a 'Make │ │ │ │ │ -00019030: 6669 6c65 272c 2074 6865 6e20 2761 7574 file', then 'aut │ │ │ │ │ -00019040: 6f6d 616b 6527 2077 696c 6c20 6265 0a20 omake' will be. │ │ │ │ │ -00019050: 2020 2020 6162 6c65 2074 6f20 7573 6520 able to use │ │ │ │ │ -00019060: 2724 7b66 696c 657d 2720 746f 2067 656e '${file}' to gen │ │ │ │ │ -00019070: 6572 6174 6520 616c 6c20 7468 6573 6520 erate all these │ │ │ │ │ -00019080: 7275 6c65 732e 2020 466f 7220 696e 7374 rules. For inst │ │ │ │ │ -00019090: 616e 6365 2c0a 2020 2020 2068 6572 6520 ance,. here │ │ │ │ │ -000190a0: 6973 2068 6f77 2074 6865 2041 7574 6f6d is how the Autom │ │ │ │ │ -000190b0: 616b 6520 7061 636b 6167 6520 6974 7365 ake package itse │ │ │ │ │ -000190c0: 6c66 2067 656e 6572 6174 6573 2076 6572 lf generates ver │ │ │ │ │ -000190d0: 7369 6f6e 6564 2073 6372 6970 7473 0a20 sioned scripts. │ │ │ │ │ -000190e0: 2020 2020 666f 7220 6974 7320 7465 7374 for its test │ │ │ │ │ -000190f0: 2073 7569 7465 3a0a 0a20 2020 2020 2020 suite:.. │ │ │ │ │ -00019100: 2020 2041 435f 5355 4253 5428 5b41 5049 AC_SUBST([API │ │ │ │ │ -00019110: 5645 5253 494f 4e5d 2c20 2e2e 2e29 0a20 VERSION], ...). │ │ │ │ │ -00019120: 2020 2020 2020 2020 202e 2e2e 0a20 2020 .... │ │ │ │ │ -00019130: 2020 2020 2020 2041 435f 434f 4e46 4947 AC_CONFIG │ │ │ │ │ -00019140: 5f46 494c 4553 280a 2020 2020 2020 2020 _FILES(. │ │ │ │ │ -00019150: 2020 2020 5b74 6573 7473 2f61 636c 6f63 [tests/acloc │ │ │ │ │ -00019160: 616c 2d24 7b41 5049 5645 5253 494f 4e7d al-${APIVERSION} │ │ │ │ │ -00019170: 3a74 6573 7473 2f61 636c 6f63 616c 2e69 :tests/aclocal.i │ │ │ │ │ -00019180: 6e5d 2c0a 2020 2020 2020 2020 2020 2020 n],. │ │ │ │ │ -00019190: 5b63 686d 6f64 202b 7820 7465 7374 732f [chmod +x tests/ │ │ │ │ │ -000191a0: 6163 6c6f 6361 6c2d 247b 4150 4956 4552 aclocal-${APIVER │ │ │ │ │ -000191b0: 5349 4f4e 7d5d 2c0a 2020 2020 2020 2020 SION}],. │ │ │ │ │ -000191c0: 2020 2020 5b41 5049 5645 5253 494f 4e3d [APIVERSION= │ │ │ │ │ -000191d0: 2441 5049 5645 5253 494f 4e5d 290a 2020 $APIVERSION]). │ │ │ │ │ -000191e0: 2020 2020 2020 2020 4143 5f43 4f4e 4649 AC_CONFI │ │ │ │ │ -000191f0: 475f 4649 4c45 5328 0a20 2020 2020 2020 G_FILES(. │ │ │ │ │ -00019200: 2020 2020 205b 7465 7374 732f 6175 746f [tests/auto │ │ │ │ │ -00019210: 6d61 6b65 2d24 7b41 5049 5645 5253 494f make-${APIVERSIO │ │ │ │ │ -00019220: 4e7d 3a74 6573 7473 2f61 7574 6f6d 616b N}:tests/automak │ │ │ │ │ -00019230: 652e 696e 5d2c 0a20 2020 2020 2020 2020 e.in],. │ │ │ │ │ -00019240: 2020 205b 6368 6d6f 6420 2b78 2074 6573 [chmod +x tes │ │ │ │ │ -00019250: 7473 2f61 7574 6f6d 616b 652d 247b 4150 ts/automake-${AP │ │ │ │ │ -00019260: 4956 4552 5349 4f4e 7d5d 290a 0a20 2020 IVERSION}]).. │ │ │ │ │ -00019270: 2020 4865 7265 2063 6c65 616e 696e 672c Here cleaning, │ │ │ │ │ -00019280: 2064 6973 7472 6962 7574 696e 672c 2061 distributing, a │ │ │ │ │ -00019290: 6e64 2072 6562 7569 6c64 696e 6720 6172 nd rebuilding ar │ │ │ │ │ -000192a0: 6520 646f 6e65 2061 7574 6f6d 6174 6963 e done automatic │ │ │ │ │ -000192b0: 616c 6c79 2c0a 2020 2020 2062 6563 6175 ally,. becau │ │ │ │ │ -000192c0: 7365 2027 247b 4150 4956 4552 5349 4f4e se '${APIVERSION │ │ │ │ │ -000192d0: 7d27 2069 7320 6b6e 6f77 6e20 6174 2027 }' is known at ' │ │ │ │ │ -000192e0: 6d61 6b65 272d 7469 6d65 2e0a 0a20 2020 make'-time... │ │ │ │ │ -000192f0: 2020 4e6f 7465 2074 6861 7420 796f 7520 Note that you │ │ │ │ │ -00019300: 7368 6f75 6c64 206e 6f74 2075 7365 2073 should not use s │ │ │ │ │ -00019310: 6865 6c6c 2076 6172 6961 626c 6573 2074 hell variables t │ │ │ │ │ -00019320: 6f20 6465 636c 6172 6520 274d 616b 6566 o declare 'Makef │ │ │ │ │ -00019330: 696c 6527 0a20 2020 2020 6669 6c65 7320 ile'. files │ │ │ │ │ -00019340: 666f 7220 7768 6963 6820 2761 7574 6f6d for which 'autom │ │ │ │ │ -00019350: 616b 6527 206d 7573 7420 6372 6561 7465 ake' must create │ │ │ │ │ -00019360: 2027 4d61 6b65 6669 6c65 2e69 6e27 2e20 'Makefile.in'. │ │ │ │ │ -00019370: 2045 7665 6e0a 2020 2020 2027 4143 5f53 Even. 'AC_S │ │ │ │ │ -00019380: 5542 5354 2720 646f 6573 206e 6f74 2068 UBST' does not h │ │ │ │ │ -00019390: 656c 7020 6865 7265 2c20 6265 6361 7573 elp here, becaus │ │ │ │ │ -000193a0: 6520 2761 7574 6f6d 616b 6527 206e 6565 e 'automake' nee │ │ │ │ │ -000193b0: 6473 2074 6f20 6b6e 6f77 2074 6865 0a20 ds to know the. │ │ │ │ │ -000193c0: 2020 2020 6669 6c65 206e 616d 6520 7768 file name wh │ │ │ │ │ -000193d0: 656e 2069 7420 7275 6e73 2069 6e20 6f72 en it runs in or │ │ │ │ │ -000193e0: 6465 7220 746f 2063 6865 636b 2077 6865 der to check whe │ │ │ │ │ -000193f0: 7468 6572 2027 4d61 6b65 6669 6c65 2e61 ther 'Makefile.a │ │ │ │ │ -00019400: 6d27 0a20 2020 2020 6578 6973 7473 2e20 m'. exists. │ │ │ │ │ -00019410: 2028 496e 2074 6865 2076 6572 7920 6861 (In the very ha │ │ │ │ │ -00019420: 6972 7920 6361 7365 2074 6861 7420 796f iry case that yo │ │ │ │ │ -00019430: 7572 2073 6574 7570 2072 6571 7569 7265 ur setup require │ │ │ │ │ -00019440: 7320 7375 6368 2075 7365 0a20 2020 2020 s such use. │ │ │ │ │ -00019450: 6f66 2076 6172 6961 626c 6573 2c20 796f of variables, yo │ │ │ │ │ -00019460: 7520 7769 6c6c 2068 6176 6520 746f 2074 u will have to t │ │ │ │ │ -00019470: 656c 6c20 4175 746f 6d61 6b65 2077 6869 ell Automake whi │ │ │ │ │ -00019480: 6368 2027 4d61 6b65 6669 6c65 2e69 6e27 ch 'Makefile.in' │ │ │ │ │ -00019490: 730a 2020 2020 2074 6f20 6765 6e65 7261 s. to genera │ │ │ │ │ -000194a0: 7465 206f 6e20 7468 6520 636f 6d6d 616e te on the comman │ │ │ │ │ -000194b0: 642d 6c69 6e65 2e29 0a0a 2020 2020 2049 d-line.).. I │ │ │ │ │ -000194c0: 7420 6973 2070 6f73 7369 626c 6520 746f t is possible to │ │ │ │ │ -000194d0: 206c 6574 2027 6175 746f 6d61 6b65 2720 let 'automake' │ │ │ │ │ -000194e0: 656d 6974 2063 6f6e 6469 7469 6f6e 616c emit conditional │ │ │ │ │ -000194f0: 2072 756c 6573 2066 6f72 0a20 2020 2020 rules for. │ │ │ │ │ -00019500: 2741 435f 434f 4e46 4947 5f46 494c 4553 'AC_CONFIG_FILES │ │ │ │ │ -00019510: 2720 7769 7468 2074 6865 2068 656c 7020 ' with the help │ │ │ │ │ -00019520: 6f66 2027 414d 5f43 4f4e 445f 4946 2720 of 'AM_COND_IF' │ │ │ │ │ -00019530: 282a 6e6f 7465 204f 7074 696f 6e61 6c3a (*note Optional: │ │ │ │ │ -00019540: 3a29 2e0a 0a20 2020 2020 546f 2073 756d :)... To sum │ │ │ │ │ -00019550: 6d61 7269 7a65 3a0a 2020 2020 2020 2020 marize:. │ │ │ │ │ -00019560: 2a20 5573 6520 6c69 7465 7261 6c73 2066 * Use literals f │ │ │ │ │ -00019570: 6f72 2027 4d61 6b65 6669 6c65 2773 2c20 or 'Makefile's, │ │ │ │ │ -00019580: 616e 6420 666f 7220 6f74 6865 7220 6669 and for other fi │ │ │ │ │ -00019590: 6c65 7320 7768 656e 6576 6572 0a20 2020 les whenever. │ │ │ │ │ -000195a0: 2020 2020 2020 2070 6f73 7369 626c 652e possible. │ │ │ │ │ -000195b0: 0a20 2020 2020 2020 202a 2055 7365 2027 . * Use ' │ │ │ │ │ -000195c0: 2466 696c 6527 2028 6f72 2027 247b 6669 $file' (or '${fi │ │ │ │ │ -000195d0: 6c65 7d27 2077 6974 686f 7574 2027 4143 le}' without 'AC │ │ │ │ │ -000195e0: 5f53 5542 5354 285b 6669 6c65 5d29 2729 _SUBST([file])') │ │ │ │ │ -000195f0: 2066 6f72 0a20 2020 2020 2020 2020 2066 for. f │ │ │ │ │ -00019600: 696c 6573 2074 6861 7420 2761 7574 6f6d iles that 'autom │ │ │ │ │ -00019610: 616b 6527 2073 686f 756c 6420 6967 6e6f ake' should igno │ │ │ │ │ -00019620: 7265 2e0a 2020 2020 2020 2020 2a20 5573 re.. * Us │ │ │ │ │ -00019630: 6520 2724 7b66 696c 657d 2720 616e 6420 e '${file}' and │ │ │ │ │ -00019640: 2741 435f 5355 4253 5428 5b66 696c 655d 'AC_SUBST([file] │ │ │ │ │ -00019650: 2927 2066 6f72 2066 696c 6573 2074 6861 )' for files tha │ │ │ │ │ -00019660: 7420 2761 7574 6f6d 616b 6527 0a20 2020 t 'automake'. │ │ │ │ │ -00019670: 2020 2020 2020 2073 686f 756c 6420 6e6f should no │ │ │ │ │ -00019680: 7420 6967 6e6f 7265 2e0a 0a1f 0a46 696c t ignore.....Fil │ │ │ │ │ -00019690: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -000196a0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4f70 .info, Node: Op │ │ │ │ │ -000196b0: 7469 6f6e 616c 2c20 204e 6578 743a 2061 tional, Next: a │ │ │ │ │ -000196c0: 636c 6f63 616c 2049 6e76 6f63 6174 696f clocal Invocatio │ │ │ │ │ -000196d0: 6e2c 2020 5072 6576 3a20 5265 7175 6972 n, Prev: Requir │ │ │ │ │ -000196e0: 656d 656e 7473 2c20 2055 703a 2063 6f6e ements, Up: con │ │ │ │ │ -000196f0: 6669 6775 7265 0a0a 362e 3220 4f74 6865 figure..6.2 Othe │ │ │ │ │ -00019700: 7220 7468 696e 6773 2041 7574 6f6d 616b r things Automak │ │ │ │ │ -00019710: 6520 7265 636f 676e 697a 6573 0a3d 3d3d e recognizes.=== │ │ │ │ │ +000183a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ +000183b0: 6520 6f6e 6520 7265 616c 2072 6571 7569 e one real requi │ │ │ │ │ +000183c0: 7265 6d65 6e74 206f 6620 4175 746f 6d61 rement of Automa │ │ │ │ │ +000183d0: 6b65 2069 7320 7468 6174 2079 6f75 7220 ke is that your │ │ │ │ │ +000183e0: 2763 6f6e 6669 6775 7265 2e61 6327 2063 'configure.ac' c │ │ │ │ │ +000183f0: 616c 6c0a 2741 4d5f 494e 4954 5f41 5554 all.'AM_INIT_AUT │ │ │ │ │ +00018400: 4f4d 414b 4527 2e20 2054 6869 7320 6d61 OMAKE'. This ma │ │ │ │ │ +00018410: 6372 6f20 646f 6573 2073 6576 6572 616c cro does several │ │ │ │ │ +00018420: 2074 6869 6e67 7320 7468 6174 2061 7265 things that are │ │ │ │ │ +00018430: 2072 6571 7569 7265 640a 666f 7220 7072 required.for pr │ │ │ │ │ +00018440: 6f70 6572 2041 7574 6f6d 616b 6520 6f70 oper Automake op │ │ │ │ │ +00018450: 6572 6174 696f 6e20 282a 6e6f 7465 204d eration (*note M │ │ │ │ │ +00018460: 6163 726f 733a 3a29 2e0a 0a20 2020 4865 acros::)... He │ │ │ │ │ +00018470: 7265 2061 7265 2074 6865 206f 7468 6572 re are the other │ │ │ │ │ +00018480: 206d 6163 726f 7320 7468 6174 2041 7574 macros that Aut │ │ │ │ │ +00018490: 6f6d 616b 6520 7265 7175 6972 6573 2062 omake requires b │ │ │ │ │ +000184a0: 7574 2077 6869 6368 2061 7265 206e 6f74 ut which are not │ │ │ │ │ +000184b0: 0a72 756e 2062 7920 2741 4d5f 494e 4954 .run by 'AM_INIT │ │ │ │ │ +000184c0: 5f41 5554 4f4d 414b 4527 3a0a 0a27 4143 _AUTOMAKE':..'AC │ │ │ │ │ +000184d0: 5f43 4f4e 4649 475f 4649 4c45 5327 0a27 _CONFIG_FILES'.' │ │ │ │ │ +000184e0: 4143 5f4f 5554 5055 5427 0a20 2020 2020 AC_OUTPUT'. │ │ │ │ │ +000184f0: 5468 6573 6520 7477 6f20 6d61 6372 6f73 These two macros │ │ │ │ │ +00018500: 2061 7265 2075 7375 616c 6c79 2069 6e76 are usually inv │ │ │ │ │ +00018510: 6f6b 6564 2061 7320 666f 6c6c 6f77 7320 oked as follows │ │ │ │ │ +00018520: 6e65 6172 2074 6865 2065 6e64 206f 660a near the end of. │ │ │ │ │ +00018530: 2020 2020 2027 636f 6e66 6967 7572 652e 'configure. │ │ │ │ │ +00018540: 6163 272e 0a0a 2020 2020 2020 2020 2020 ac'... │ │ │ │ │ +00018550: 2e2e 2e0a 2020 2020 2020 2020 2020 4143 .... AC │ │ │ │ │ +00018560: 5f43 4f4e 4649 475f 4649 4c45 5328 5b0a _CONFIG_FILES([. │ │ │ │ │ +00018570: 2020 2020 2020 2020 2020 2020 4d61 6b65 Make │ │ │ │ │ +00018580: 6669 6c65 0a20 2020 2020 2020 2020 2020 file. │ │ │ │ │ +00018590: 2064 6f63 2f4d 616b 6566 696c 650a 2020 doc/Makefile. │ │ │ │ │ +000185a0: 2020 2020 2020 2020 2020 7372 632f 4d61 src/Ma │ │ │ │ │ +000185b0: 6b65 6669 6c65 0a20 2020 2020 2020 2020 kefile. │ │ │ │ │ +000185c0: 2020 2073 7263 2f6c 6962 2f4d 616b 6566 src/lib/Makef │ │ │ │ │ +000185d0: 696c 650a 2020 2020 2020 2020 2020 2020 ile. │ │ │ │ │ +000185e0: 2e2e 2e0a 2020 2020 2020 2020 2020 5d29 .... ]) │ │ │ │ │ +000185f0: 0a20 2020 2020 2020 2020 2041 435f 4f55 . AC_OU │ │ │ │ │ +00018600: 5450 5554 0a0a 2020 2020 2041 7574 6f6d TPUT.. Autom │ │ │ │ │ +00018610: 616b 6520 7573 6573 2074 6865 7365 2074 ake uses these t │ │ │ │ │ +00018620: 6f20 6465 7465 726d 696e 6520 7768 6963 o determine whic │ │ │ │ │ +00018630: 6820 6669 6c65 7320 746f 2063 7265 6174 h files to creat │ │ │ │ │ +00018640: 6520 282a 6e6f 7465 0a20 2020 2020 4372 e (*note. Cr │ │ │ │ │ +00018650: 6561 7469 6e67 204f 7574 7075 7420 4669 eating Output Fi │ │ │ │ │ +00018660: 6c65 733a 2028 6175 746f 636f 6e66 294f les: (autoconf)O │ │ │ │ │ +00018670: 7574 7075 742e 292e 2020 4120 6c69 7374 utput.). A list │ │ │ │ │ +00018680: 6564 2066 696c 6520 6973 0a20 2020 2020 ed file is. │ │ │ │ │ +00018690: 636f 6e73 6964 6572 6564 2074 6f20 6265 considered to be │ │ │ │ │ +000186a0: 2061 6e20 4175 746f 6d61 6b65 2067 656e an Automake gen │ │ │ │ │ +000186b0: 6572 6174 6564 2027 4d61 6b65 6669 6c65 erated 'Makefile │ │ │ │ │ +000186c0: 2720 6966 2074 6865 7265 2065 7869 7374 ' if there exist │ │ │ │ │ +000186d0: 7320 610a 2020 2020 2066 696c 6520 7769 s a. file wi │ │ │ │ │ +000186e0: 7468 2074 6865 2073 616d 6520 6e61 6d65 th the same name │ │ │ │ │ +000186f0: 2061 6e64 2074 6865 2027 2e61 6d27 2065 and the '.am' e │ │ │ │ │ +00018700: 7874 656e 7369 6f6e 2061 7070 656e 6465 xtension appende │ │ │ │ │ +00018710: 642e 0a20 2020 2020 5479 7069 6361 6c6c d.. Typicall │ │ │ │ │ +00018720: 792c 2027 4143 5f43 4f4e 4649 475f 4649 y, 'AC_CONFIG_FI │ │ │ │ │ +00018730: 4c45 5328 5b66 6f6f 2f4d 616b 6566 696c LES([foo/Makefil │ │ │ │ │ +00018740: 655d 2927 2077 696c 6c20 6361 7573 6520 e])' will cause │ │ │ │ │ +00018750: 4175 746f 6d61 6b65 2074 6f0a 2020 2020 Automake to. │ │ │ │ │ +00018760: 2067 656e 6572 6174 6520 2766 6f6f 2f4d generate 'foo/M │ │ │ │ │ +00018770: 616b 6566 696c 652e 696e 2720 6966 2027 akefile.in' if ' │ │ │ │ │ +00018780: 666f 6f2f 4d61 6b65 6669 6c65 2e61 6d27 foo/Makefile.am' │ │ │ │ │ +00018790: 2065 7869 7374 732e 0a0a 2020 2020 2057 exists... W │ │ │ │ │ +000187a0: 6865 6e20 7573 696e 6720 2741 435f 434f hen using 'AC_CO │ │ │ │ │ +000187b0: 4e46 4947 5f46 494c 4553 2720 7769 7468 NFIG_FILES' with │ │ │ │ │ +000187c0: 206d 756c 7469 706c 6520 696e 7075 7420 multiple input │ │ │ │ │ +000187d0: 6669 6c65 732c 2061 7320 696e 0a0a 2020 files, as in.. │ │ │ │ │ +000187e0: 2020 2020 2020 2020 4143 5f43 4f4e 4649 AC_CONFI │ │ │ │ │ +000187f0: 475f 4649 4c45 5328 5b4d 616b 6566 696c G_FILES([Makefil │ │ │ │ │ +00018800: 653a 746f 702e 696e 3a4d 616b 6566 696c e:top.in:Makefil │ │ │ │ │ +00018810: 652e 696e 3a62 6f74 2e69 6e5d 290a 0a20 e.in:bot.in]).. │ │ │ │ │ +00018820: 2020 2020 2761 7574 6f6d 616b 6527 2077 'automake' w │ │ │ │ │ +00018830: 696c 6c20 6765 6e65 7261 7465 2074 6865 ill generate the │ │ │ │ │ +00018840: 2066 6972 7374 2027 2e69 6e27 2069 6e70 first '.in' inp │ │ │ │ │ +00018850: 7574 2066 696c 6520 666f 7220 7768 6963 ut file for whic │ │ │ │ │ +00018860: 6820 610a 2020 2020 2027 2e61 6d27 2066 h a. '.am' f │ │ │ │ │ +00018870: 696c 6520 6578 6973 7473 2e20 2049 6620 ile exists. If │ │ │ │ │ +00018880: 6e6f 2073 7563 6820 6669 6c65 2065 7869 no such file exi │ │ │ │ │ +00018890: 7374 7320 7468 6520 6f75 7470 7574 2066 sts the output f │ │ │ │ │ +000188a0: 696c 6520 6973 206e 6f74 0a20 2020 2020 ile is not. │ │ │ │ │ +000188b0: 636f 6e73 6964 6572 6564 2074 6f20 6265 considered to be │ │ │ │ │ +000188c0: 2067 656e 6572 6174 6564 2062 7920 4175 generated by Au │ │ │ │ │ +000188d0: 746f 6d61 6b65 2e0a 0a20 2020 2020 4669 tomake... Fi │ │ │ │ │ +000188e0: 6c65 7320 6372 6561 7465 6420 6279 2027 les created by ' │ │ │ │ │ +000188f0: 4143 5f43 4f4e 4649 475f 4649 4c45 5327 AC_CONFIG_FILES' │ │ │ │ │ +00018900: 2c20 6265 2074 6865 7920 4175 746f 6d61 , be they Automa │ │ │ │ │ +00018910: 6b65 2027 4d61 6b65 6669 6c65 2773 206f ke 'Makefile's o │ │ │ │ │ +00018920: 720a 2020 2020 206e 6f74 2c20 6172 6520 r. not, are │ │ │ │ │ +00018930: 616c 6c20 7265 6d6f 7665 6420 6279 2027 all removed by ' │ │ │ │ │ +00018940: 6d61 6b65 2064 6973 7463 6c65 616e 272e make distclean'. │ │ │ │ │ +00018950: 2020 5468 6569 7220 696e 7075 7473 2061 Their inputs a │ │ │ │ │ +00018960: 7265 0a20 2020 2020 6175 746f 6d61 7469 re. automati │ │ │ │ │ +00018970: 6361 6c6c 7920 6469 7374 7269 6275 7465 cally distribute │ │ │ │ │ +00018980: 642c 2075 6e6c 6573 7320 7468 6579 2061 d, unless they a │ │ │ │ │ +00018990: 7265 2074 6865 206f 7574 7075 7420 6f66 re the output of │ │ │ │ │ +000189a0: 2070 7269 6f72 0a20 2020 2020 2741 435f prior. 'AC_ │ │ │ │ │ +000189b0: 434f 4e46 4947 5f46 494c 4553 2720 636f CONFIG_FILES' co │ │ │ │ │ +000189c0: 6d6d 616e 6473 2e20 2046 696e 616c 6c79 mmands. Finally │ │ │ │ │ +000189d0: 2c20 7265 6275 696c 6420 7275 6c65 7320 , rebuild rules │ │ │ │ │ +000189e0: 6172 6520 6765 6e65 7261 7465 640a 2020 are generated. │ │ │ │ │ +000189f0: 2020 2069 6e20 7468 6520 4175 746f 6d61 in the Automa │ │ │ │ │ +00018a00: 6b65 2027 4d61 6b65 6669 6c65 2720 6578 ke 'Makefile' ex │ │ │ │ │ +00018a10: 6973 7469 6e67 2069 6e20 7468 6520 7375 isting in the su │ │ │ │ │ +00018a20: 6264 6972 6563 746f 7279 206f 6620 7468 bdirectory of th │ │ │ │ │ +00018a30: 650a 2020 2020 206f 7574 7075 7420 6669 e. output fi │ │ │ │ │ +00018a40: 6c65 2c20 6966 2074 6865 7265 2069 7320 le, if there is │ │ │ │ │ +00018a50: 6f6e 652c 206f 7220 696e 2074 6865 2074 one, or in the t │ │ │ │ │ +00018a60: 6f70 2d6c 6576 656c 2027 4d61 6b65 6669 op-level 'Makefi │ │ │ │ │ +00018a70: 6c65 270a 2020 2020 206f 7468 6572 7769 le'. otherwi │ │ │ │ │ +00018a80: 7365 2e0a 0a20 2020 2020 5468 6520 6162 se... The ab │ │ │ │ │ +00018a90: 6f76 6520 6d61 6368 696e 6572 7920 2863 ove machinery (c │ │ │ │ │ +00018aa0: 6c65 616e 696e 672c 2064 6973 7472 6962 leaning, distrib │ │ │ │ │ +00018ab0: 7574 696e 672c 2061 6e64 2072 6562 7569 uting, and rebui │ │ │ │ │ +00018ac0: 6c64 696e 6729 2077 6f72 6b73 0a20 2020 lding) works. │ │ │ │ │ +00018ad0: 2020 6669 6e65 2069 6620 7468 6520 2741 fine if the 'A │ │ │ │ │ +00018ae0: 435f 434f 4e46 4947 5f46 494c 4553 2720 C_CONFIG_FILES' │ │ │ │ │ +00018af0: 7370 6563 6966 6963 6174 696f 6e73 2063 specifications c │ │ │ │ │ +00018b00: 6f6e 7461 696e 206f 6e6c 7920 6c69 7465 ontain only lite │ │ │ │ │ +00018b10: 7261 6c73 2e0a 2020 2020 2049 6620 7061 rals.. If pa │ │ │ │ │ +00018b20: 7274 206f 6620 7468 6520 7370 6563 6966 rt of the specif │ │ │ │ │ +00018b30: 6963 6174 696f 6e20 7573 6573 2073 6865 ication uses she │ │ │ │ │ +00018b40: 6c6c 2076 6172 6961 626c 6573 2c20 2761 ll variables, 'a │ │ │ │ │ +00018b50: 7574 6f6d 616b 6527 2077 696c 6c0a 2020 utomake' will. │ │ │ │ │ +00018b60: 2020 206e 6f74 2062 6520 6162 6c65 2074 not be able t │ │ │ │ │ +00018b70: 6f20 6675 6c66 696c 6c20 7468 6973 2073 o fulfill this s │ │ │ │ │ +00018b80: 6574 7570 2c20 616e 6420 796f 7520 7769 etup, and you wi │ │ │ │ │ +00018b90: 6c6c 2068 6176 6520 746f 2063 6f6d 706c ll have to compl │ │ │ │ │ +00018ba0: 6574 650a 2020 2020 2074 6865 206d 6973 ete. the mis │ │ │ │ │ +00018bb0: 7369 6e67 2062 6974 7320 6279 2068 616e sing bits by han │ │ │ │ │ +00018bc0: 642e 2020 466f 7220 696e 7374 616e 6365 d. For instance │ │ │ │ │ +00018bd0: 2c20 6f6e 0a0a 2020 2020 2020 2020 2020 , on.. │ │ │ │ │ +00018be0: 6669 6c65 3d69 6e70 7574 0a20 2020 2020 file=input. │ │ │ │ │ +00018bf0: 2020 2020 202e 2e2e 0a20 2020 2020 2020 .... │ │ │ │ │ +00018c00: 2020 2041 435f 434f 4e46 4947 5f46 494c AC_CONFIG_FIL │ │ │ │ │ +00018c10: 4553 285b 6f75 7470 7574 3a24 6669 6c65 ES([output:$file │ │ │ │ │ +00018c20: 5d2c 2c20 5b66 696c 653d 2466 696c 655d ],, [file=$file] │ │ │ │ │ +00018c30: 290a 0a20 2020 2020 2761 7574 6f6d 616b ).. 'automak │ │ │ │ │ +00018c40: 6527 2077 696c 6c20 6f75 7470 7574 2072 e' will output r │ │ │ │ │ +00018c50: 756c 6573 2074 6f20 636c 6561 6e20 276f ules to clean 'o │ │ │ │ │ +00018c60: 7574 7075 7427 2c20 616e 6420 7265 6275 utput', and rebu │ │ │ │ │ +00018c70: 696c 6420 6974 2e0a 2020 2020 2048 6f77 ild it.. How │ │ │ │ │ +00018c80: 6576 6572 2074 6865 2072 6562 7569 6c64 ever the rebuild │ │ │ │ │ +00018c90: 2072 756c 6520 7769 6c6c 206e 6f74 2064 rule will not d │ │ │ │ │ +00018ca0: 6570 656e 6420 6f6e 2027 696e 7075 7427 epend on 'input' │ │ │ │ │ +00018cb0: 2c20 616e 6420 7468 6973 2066 696c 650a , and this file. │ │ │ │ │ +00018cc0: 2020 2020 2077 696c 6c20 6e6f 7420 6265 will not be │ │ │ │ │ +00018cd0: 2064 6973 7472 6962 7574 6564 2065 6974 distributed eit │ │ │ │ │ +00018ce0: 6865 722e 2020 2859 6f75 206d 7573 7420 her. (You must │ │ │ │ │ +00018cf0: 6164 6420 2745 5854 5241 5f44 4953 5420 add 'EXTRA_DIST │ │ │ │ │ +00018d00: 3d20 696e 7075 7427 0a20 2020 2020 746f = input'. to │ │ │ │ │ +00018d10: 2079 6f75 7220 274d 616b 6566 696c 652e your 'Makefile. │ │ │ │ │ +00018d20: 616d 2720 6966 2027 696e 7075 7427 2069 am' if 'input' i │ │ │ │ │ +00018d30: 7320 6120 736f 7572 6365 2066 696c 652e s a source file. │ │ │ │ │ +00018d40: 290a 0a20 2020 2020 5369 6d69 6c61 726c ).. Similarl │ │ │ │ │ +00018d50: 790a 0a20 2020 2020 2020 2020 2066 696c y.. fil │ │ │ │ │ +00018d60: 653d 6f75 7470 7574 0a20 2020 2020 2020 e=output. │ │ │ │ │ +00018d70: 2020 2066 696c 6532 3d6f 7574 3a69 6e0a file2=out:in. │ │ │ │ │ +00018d80: 2020 2020 2020 2020 2020 2e2e 2e0a 2020 .... │ │ │ │ │ +00018d90: 2020 2020 2020 2020 4143 5f43 4f4e 4649 AC_CONFI │ │ │ │ │ +00018da0: 475f 4649 4c45 5328 5b24 6669 6c65 3a69 G_FILES([$file:i │ │ │ │ │ +00018db0: 6e70 7574 5d2c 2c20 5b66 696c 653d 2466 nput],, [file=$f │ │ │ │ │ +00018dc0: 696c 655d 290a 2020 2020 2020 2020 2020 ile]). │ │ │ │ │ +00018dd0: 4143 5f43 4f4e 4649 475f 4649 4c45 5328 AC_CONFIG_FILES( │ │ │ │ │ +00018de0: 5b24 6669 6c65 325d 2c2c 205b 6669 6c65 [$file2],, [file │ │ │ │ │ +00018df0: 323d 2466 696c 6532 5d29 0a0a 2020 2020 2=$file2]).. │ │ │ │ │ +00018e00: 2077 696c 6c20 6f6e 6c79 2063 6175 7365 will only cause │ │ │ │ │ +00018e10: 2027 696e 7075 7427 2074 6f20 6265 2064 'input' to be d │ │ │ │ │ +00018e20: 6973 7472 6962 7574 6564 2e20 204e 6f20 istributed. No │ │ │ │ │ +00018e30: 6669 6c65 2077 696c 6c20 6265 2063 6c65 file will be cle │ │ │ │ │ +00018e40: 616e 6564 0a20 2020 2020 6175 746f 6d61 aned. automa │ │ │ │ │ +00018e50: 7469 6361 6c6c 7920 2861 6464 2027 4449 tically (add 'DI │ │ │ │ │ +00018e60: 5354 434c 4541 4e46 494c 4553 203d 206f STCLEANFILES = o │ │ │ │ │ +00018e70: 7574 7075 7420 6f75 7427 2079 6f75 7273 utput out' yours │ │ │ │ │ +00018e80: 656c 6629 2c20 616e 6420 6e6f 0a20 2020 elf), and no. │ │ │ │ │ +00018e90: 2020 7265 6275 696c 6420 7275 6c65 2077 rebuild rule w │ │ │ │ │ +00018ea0: 696c 6c20 6265 206f 7574 7075 742e 0a0a ill be output... │ │ │ │ │ +00018eb0: 2020 2020 204f 6276 696f 7573 6c79 2027 Obviously ' │ │ │ │ │ +00018ec0: 6175 746f 6d61 6b65 2720 6361 6e6e 6f74 automake' cannot │ │ │ │ │ +00018ed0: 2067 7565 7373 2077 6861 7420 7661 6c75 guess what valu │ │ │ │ │ +00018ee0: 6520 2724 6669 6c65 2720 6973 2067 6f69 e '$file' is goi │ │ │ │ │ +00018ef0: 6e67 2074 6f0a 2020 2020 2068 6f6c 6420 ng to. hold │ │ │ │ │ +00018f00: 6c61 7465 7220 7768 656e 2027 636f 6e66 later when 'conf │ │ │ │ │ +00018f10: 6967 7572 6527 2069 7320 7275 6e2c 2061 igure' is run, a │ │ │ │ │ +00018f20: 6e64 2069 7420 6361 6e6e 6f74 2075 7365 nd it cannot use │ │ │ │ │ +00018f30: 2074 6865 2073 6865 6c6c 0a20 2020 2020 the shell. │ │ │ │ │ +00018f40: 7661 7269 6162 6c65 2027 2466 696c 6527 variable '$file' │ │ │ │ │ +00018f50: 2069 6e20 6120 274d 616b 6566 696c 6527 in a 'Makefile' │ │ │ │ │ +00018f60: 2e20 2048 6f77 6576 6572 2c20 6966 2079 . However, if y │ │ │ │ │ +00018f70: 6f75 206d 616b 6520 7265 6665 7265 6e63 ou make referenc │ │ │ │ │ +00018f80: 650a 2020 2020 2074 6f20 2724 6669 6c65 e. to '$file │ │ │ │ │ +00018f90: 2720 6173 2027 247b 6669 6c65 7d27 2028 ' as '${file}' ( │ │ │ │ │ +00018fa0: 692e 652e 2c20 696e 2061 2077 6179 2074 i.e., in a way t │ │ │ │ │ +00018fb0: 6861 7420 6973 2063 6f6d 7061 7469 626c hat is compatibl │ │ │ │ │ +00018fc0: 6520 7769 7468 0a20 2020 2020 276d 616b e with. 'mak │ │ │ │ │ +00018fd0: 6527 2773 2073 796e 7461 7829 2061 6e64 e''s syntax) and │ │ │ │ │ +00018fe0: 2066 7572 7468 6572 6d6f 7265 2075 7365 furthermore use │ │ │ │ │ +00018ff0: 2027 4143 5f53 5542 5354 2720 746f 2065 'AC_SUBST' to e │ │ │ │ │ +00019000: 6e73 7572 6520 7468 6174 0a20 2020 2020 nsure that. │ │ │ │ │ +00019010: 2724 7b66 696c 657d 2720 6973 206d 6561 '${file}' is mea │ │ │ │ │ +00019020: 6e69 6e67 6675 6c20 696e 2061 2027 4d61 ningful in a 'Ma │ │ │ │ │ +00019030: 6b65 6669 6c65 272c 2074 6865 6e20 2761 kefile', then 'a │ │ │ │ │ +00019040: 7574 6f6d 616b 6527 2077 696c 6c20 6265 utomake' will be │ │ │ │ │ +00019050: 0a20 2020 2020 6162 6c65 2074 6f20 7573 . able to us │ │ │ │ │ +00019060: 6520 2724 7b66 696c 657d 2720 746f 2067 e '${file}' to g │ │ │ │ │ +00019070: 656e 6572 6174 6520 616c 6c20 7468 6573 enerate all thes │ │ │ │ │ +00019080: 6520 7275 6c65 732e 2020 466f 7220 696e e rules. For in │ │ │ │ │ +00019090: 7374 616e 6365 2c0a 2020 2020 2068 6572 stance,. her │ │ │ │ │ +000190a0: 6520 6973 2068 6f77 2074 6865 2041 7574 e is how the Aut │ │ │ │ │ +000190b0: 6f6d 616b 6520 7061 636b 6167 6520 6974 omake package it │ │ │ │ │ +000190c0: 7365 6c66 2067 656e 6572 6174 6573 2076 self generates v │ │ │ │ │ +000190d0: 6572 7369 6f6e 6564 2073 6372 6970 7473 ersioned scripts │ │ │ │ │ +000190e0: 0a20 2020 2020 666f 7220 6974 7320 7465 . for its te │ │ │ │ │ +000190f0: 7374 2073 7569 7465 3a0a 0a20 2020 2020 st suite:.. │ │ │ │ │ +00019100: 2020 2020 2041 435f 5355 4253 5428 5b41 AC_SUBST([A │ │ │ │ │ +00019110: 5049 5645 5253 494f 4e5d 2c20 2e2e 2e29 PIVERSION], ...) │ │ │ │ │ +00019120: 0a20 2020 2020 2020 2020 202e 2e2e 0a20 . .... │ │ │ │ │ +00019130: 2020 2020 2020 2020 2041 435f 434f 4e46 AC_CONF │ │ │ │ │ +00019140: 4947 5f46 494c 4553 280a 2020 2020 2020 IG_FILES(. │ │ │ │ │ +00019150: 2020 2020 2020 5b74 6573 7473 2f61 636c [tests/acl │ │ │ │ │ +00019160: 6f63 616c 2d24 7b41 5049 5645 5253 494f ocal-${APIVERSIO │ │ │ │ │ +00019170: 4e7d 3a74 6573 7473 2f61 636c 6f63 616c N}:tests/aclocal │ │ │ │ │ +00019180: 2e69 6e5d 2c0a 2020 2020 2020 2020 2020 .in],. │ │ │ │ │ +00019190: 2020 5b63 686d 6f64 202b 7820 7465 7374 [chmod +x test │ │ │ │ │ +000191a0: 732f 6163 6c6f 6361 6c2d 247b 4150 4956 s/aclocal-${APIV │ │ │ │ │ +000191b0: 4552 5349 4f4e 7d5d 2c0a 2020 2020 2020 ERSION}],. │ │ │ │ │ +000191c0: 2020 2020 2020 5b41 5049 5645 5253 494f [APIVERSIO │ │ │ │ │ +000191d0: 4e3d 2441 5049 5645 5253 494f 4e5d 290a N=$APIVERSION]). │ │ │ │ │ +000191e0: 2020 2020 2020 2020 2020 4143 5f43 4f4e AC_CON │ │ │ │ │ +000191f0: 4649 475f 4649 4c45 5328 0a20 2020 2020 FIG_FILES(. │ │ │ │ │ +00019200: 2020 2020 2020 205b 7465 7374 732f 6175 [tests/au │ │ │ │ │ +00019210: 746f 6d61 6b65 2d24 7b41 5049 5645 5253 tomake-${APIVERS │ │ │ │ │ +00019220: 494f 4e7d 3a74 6573 7473 2f61 7574 6f6d ION}:tests/autom │ │ │ │ │ +00019230: 616b 652e 696e 5d2c 0a20 2020 2020 2020 ake.in],. │ │ │ │ │ +00019240: 2020 2020 205b 6368 6d6f 6420 2b78 2074 [chmod +x t │ │ │ │ │ +00019250: 6573 7473 2f61 7574 6f6d 616b 652d 247b ests/automake-${ │ │ │ │ │ +00019260: 4150 4956 4552 5349 4f4e 7d5d 290a 0a20 APIVERSION}]).. │ │ │ │ │ +00019270: 2020 2020 4865 7265 2063 6c65 616e 696e Here cleanin │ │ │ │ │ +00019280: 672c 2064 6973 7472 6962 7574 696e 672c g, distributing, │ │ │ │ │ +00019290: 2061 6e64 2072 6562 7569 6c64 696e 6720 and rebuilding │ │ │ │ │ +000192a0: 6172 6520 646f 6e65 2061 7574 6f6d 6174 are done automat │ │ │ │ │ +000192b0: 6963 616c 6c79 2c0a 2020 2020 2062 6563 ically,. bec │ │ │ │ │ +000192c0: 6175 7365 2027 247b 4150 4956 4552 5349 ause '${APIVERSI │ │ │ │ │ +000192d0: 4f4e 7d27 2069 7320 6b6e 6f77 6e20 6174 ON}' is known at │ │ │ │ │ +000192e0: 2027 6d61 6b65 272d 7469 6d65 2e0a 0a20 'make'-time... │ │ │ │ │ +000192f0: 2020 2020 4e6f 7465 2074 6861 7420 796f Note that yo │ │ │ │ │ +00019300: 7520 7368 6f75 6c64 206e 6f74 2075 7365 u should not use │ │ │ │ │ +00019310: 2073 6865 6c6c 2076 6172 6961 626c 6573 shell variables │ │ │ │ │ +00019320: 2074 6f20 6465 636c 6172 6520 274d 616b to declare 'Mak │ │ │ │ │ +00019330: 6566 696c 6527 0a20 2020 2020 6669 6c65 efile'. file │ │ │ │ │ +00019340: 7320 666f 7220 7768 6963 6820 2761 7574 s for which 'aut │ │ │ │ │ +00019350: 6f6d 616b 6527 206d 7573 7420 6372 6561 omake' must crea │ │ │ │ │ +00019360: 7465 2027 4d61 6b65 6669 6c65 2e69 6e27 te 'Makefile.in' │ │ │ │ │ +00019370: 2e20 2045 7665 6e0a 2020 2020 2027 4143 . Even. 'AC │ │ │ │ │ +00019380: 5f53 5542 5354 2720 646f 6573 206e 6f74 _SUBST' does not │ │ │ │ │ +00019390: 2068 656c 7020 6865 7265 2c20 6265 6361 help here, beca │ │ │ │ │ +000193a0: 7573 6520 2761 7574 6f6d 616b 6527 206e use 'automake' n │ │ │ │ │ +000193b0: 6565 6473 2074 6f20 6b6e 6f77 2074 6865 eeds to know the │ │ │ │ │ +000193c0: 0a20 2020 2020 6669 6c65 206e 616d 6520 . file name │ │ │ │ │ +000193d0: 7768 656e 2069 7420 7275 6e73 2069 6e20 when it runs in │ │ │ │ │ +000193e0: 6f72 6465 7220 746f 2063 6865 636b 2077 order to check w │ │ │ │ │ +000193f0: 6865 7468 6572 2027 4d61 6b65 6669 6c65 hether 'Makefile │ │ │ │ │ +00019400: 2e61 6d27 0a20 2020 2020 6578 6973 7473 .am'. exists │ │ │ │ │ +00019410: 2e20 2028 496e 2074 6865 2076 6572 7920 . (In the very │ │ │ │ │ +00019420: 6861 6972 7920 6361 7365 2074 6861 7420 hairy case that │ │ │ │ │ +00019430: 796f 7572 2073 6574 7570 2072 6571 7569 your setup requi │ │ │ │ │ +00019440: 7265 7320 7375 6368 2075 7365 0a20 2020 res such use. │ │ │ │ │ +00019450: 2020 6f66 2076 6172 6961 626c 6573 2c20 of variables, │ │ │ │ │ +00019460: 796f 7520 7769 6c6c 2068 6176 6520 746f you will have to │ │ │ │ │ +00019470: 2074 656c 6c20 4175 746f 6d61 6b65 2077 tell Automake w │ │ │ │ │ +00019480: 6869 6368 2027 4d61 6b65 6669 6c65 2e69 hich 'Makefile.i │ │ │ │ │ +00019490: 6e27 730a 2020 2020 2074 6f20 6765 6e65 n's. to gene │ │ │ │ │ +000194a0: 7261 7465 206f 6e20 7468 6520 636f 6d6d rate on the comm │ │ │ │ │ +000194b0: 616e 642d 6c69 6e65 2e29 0a0a 2020 2020 and-line.).. │ │ │ │ │ +000194c0: 2049 7420 6973 2070 6f73 7369 626c 6520 It is possible │ │ │ │ │ +000194d0: 746f 206c 6574 2027 6175 746f 6d61 6b65 to let 'automake │ │ │ │ │ +000194e0: 2720 656d 6974 2063 6f6e 6469 7469 6f6e ' emit condition │ │ │ │ │ +000194f0: 616c 2072 756c 6573 2066 6f72 0a20 2020 al rules for. │ │ │ │ │ +00019500: 2020 2741 435f 434f 4e46 4947 5f46 494c 'AC_CONFIG_FIL │ │ │ │ │ +00019510: 4553 2720 7769 7468 2074 6865 2068 656c ES' with the hel │ │ │ │ │ +00019520: 7020 6f66 2027 414d 5f43 4f4e 445f 4946 p of 'AM_COND_IF │ │ │ │ │ +00019530: 2720 282a 6e6f 7465 204f 7074 696f 6e61 ' (*note Optiona │ │ │ │ │ +00019540: 6c3a 3a29 2e0a 0a20 2020 2020 546f 2073 l::)... To s │ │ │ │ │ +00019550: 756d 6d61 7269 7a65 3a0a 2020 2020 2020 ummarize:. │ │ │ │ │ +00019560: 2020 2a20 5573 6520 6c69 7465 7261 6c73 * Use literals │ │ │ │ │ +00019570: 2066 6f72 2027 4d61 6b65 6669 6c65 2773 for 'Makefile's │ │ │ │ │ +00019580: 2c20 616e 6420 666f 7220 6f74 6865 7220 , and for other │ │ │ │ │ +00019590: 6669 6c65 7320 7768 656e 6576 6572 0a20 files whenever. │ │ │ │ │ +000195a0: 2020 2020 2020 2020 2070 6f73 7369 626c possibl │ │ │ │ │ +000195b0: 652e 0a20 2020 2020 2020 202a 2055 7365 e.. * Use │ │ │ │ │ +000195c0: 2027 2466 696c 6527 2028 6f72 2027 247b '$file' (or '${ │ │ │ │ │ +000195d0: 6669 6c65 7d27 2077 6974 686f 7574 2027 file}' without ' │ │ │ │ │ +000195e0: 4143 5f53 5542 5354 285b 6669 6c65 5d29 AC_SUBST([file]) │ │ │ │ │ +000195f0: 2729 2066 6f72 0a20 2020 2020 2020 2020 ') for. │ │ │ │ │ +00019600: 2066 696c 6573 2074 6861 7420 2761 7574 files that 'aut │ │ │ │ │ +00019610: 6f6d 616b 6527 2073 686f 756c 6420 6967 omake' should ig │ │ │ │ │ +00019620: 6e6f 7265 2e0a 2020 2020 2020 2020 2a20 nore.. * │ │ │ │ │ +00019630: 5573 6520 2724 7b66 696c 657d 2720 616e Use '${file}' an │ │ │ │ │ +00019640: 6420 2741 435f 5355 4253 5428 5b66 696c d 'AC_SUBST([fil │ │ │ │ │ +00019650: 655d 2927 2066 6f72 2066 696c 6573 2074 e])' for files t │ │ │ │ │ +00019660: 6861 7420 2761 7574 6f6d 616b 6527 0a20 hat 'automake'. │ │ │ │ │ +00019670: 2020 2020 2020 2020 2073 686f 756c 6420 should │ │ │ │ │ +00019680: 6e6f 7420 6967 6e6f 7265 2e0a 0a1f 0a46 not ignore.....F │ │ │ │ │ +00019690: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +000196a0: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +000196b0: 4f70 7469 6f6e 616c 2c20 204e 6578 743a Optional, Next: │ │ │ │ │ +000196c0: 2061 636c 6f63 616c 2049 6e76 6f63 6174 aclocal Invocat │ │ │ │ │ +000196d0: 696f 6e2c 2020 5072 6576 3a20 5265 7175 ion, Prev: Requ │ │ │ │ │ +000196e0: 6972 656d 656e 7473 2c20 2055 703a 2063 irements, Up: c │ │ │ │ │ +000196f0: 6f6e 6669 6775 7265 0a0a 362e 3220 4f74 onfigure..6.2 Ot │ │ │ │ │ +00019700: 6865 7220 7468 696e 6773 2041 7574 6f6d her things Autom │ │ │ │ │ +00019710: 616b 6520 7265 636f 676e 697a 6573 0a3d ake recognizes.= │ │ │ │ │ 00019720: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00019730: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00019740: 3d0a 0a45 7665 7279 2074 696d 6520 4175 =..Every time Au │ │ │ │ │ -00019750: 746f 6d61 6b65 2069 7320 7275 6e20 6974 tomake is run it │ │ │ │ │ -00019760: 2063 616c 6c73 2041 7574 6f63 6f6e 6620 calls Autoconf │ │ │ │ │ -00019770: 746f 2074 7261 6365 2027 636f 6e66 6967 to trace 'config │ │ │ │ │ -00019780: 7572 652e 6163 272e 0a54 6869 7320 7761 ure.ac'..This wa │ │ │ │ │ -00019790: 7920 6974 2063 616e 2072 6563 6f67 6e69 y it can recogni │ │ │ │ │ -000197a0: 7a65 2074 6865 2075 7365 206f 6620 6365 ze the use of ce │ │ │ │ │ -000197b0: 7274 6169 6e20 6d61 6372 6f73 2061 6e64 rtain macros and │ │ │ │ │ -000197c0: 2074 6169 6c6f 7220 7468 650a 6765 6e65 tailor the.gene │ │ │ │ │ -000197d0: 7261 7465 6420 274d 616b 6566 696c 652e rated 'Makefile. │ │ │ │ │ -000197e0: 696e 2720 6170 7072 6f70 7269 6174 656c in' appropriatel │ │ │ │ │ -000197f0: 792e 2020 4375 7272 656e 746c 7920 7265 y. Currently re │ │ │ │ │ -00019800: 636f 676e 697a 6564 206d 6163 726f 7320 cognized macros │ │ │ │ │ -00019810: 616e 640a 7468 6569 7220 6566 6665 6374 and.their effect │ │ │ │ │ -00019820: 7320 6172 653a 0a0a 2741 435f 4341 4e4f s are:..'AC_CANO │ │ │ │ │ -00019830: 4e49 4341 4c5f 4255 494c 4427 0a27 4143 NICAL_BUILD'.'AC │ │ │ │ │ -00019840: 5f43 414e 4f4e 4943 414c 5f48 4f53 5427 _CANONICAL_HOST' │ │ │ │ │ -00019850: 0a27 4143 5f43 414e 4f4e 4943 414c 5f54 .'AC_CANONICAL_T │ │ │ │ │ -00019860: 4152 4745 5427 0a20 2020 2020 4175 746f ARGET'. Auto │ │ │ │ │ -00019870: 6d61 6b65 2077 696c 6c20 656e 7375 7265 make will ensure │ │ │ │ │ -00019880: 2074 6861 7420 2763 6f6e 6669 672e 6775 that 'config.gu │ │ │ │ │ -00019890: 6573 7327 2061 6e64 2027 636f 6e66 6967 ess' and 'config │ │ │ │ │ -000198a0: 2e73 7562 2720 6578 6973 742e 0a20 2020 .sub' exist.. │ │ │ │ │ -000198b0: 2020 416c 736f 2c20 7468 6520 274d 616b Also, the 'Mak │ │ │ │ │ -000198c0: 6566 696c 6527 2076 6172 6961 626c 6573 efile' variables │ │ │ │ │ -000198d0: 2027 6275 696c 645f 7472 6970 6c65 7427 'build_triplet' │ │ │ │ │ -000198e0: 2c20 2768 6f73 745f 7472 6970 6c65 7427 , 'host_triplet' │ │ │ │ │ -000198f0: 2061 6e64 0a20 2020 2020 2774 6172 6765 and. 'targe │ │ │ │ │ -00019900: 745f 7472 6970 6c65 7427 2061 7265 2069 t_triplet' are i │ │ │ │ │ -00019910: 6e74 726f 6475 6365 642e 2020 5365 6520 ntroduced. See │ │ │ │ │ -00019920: 2a6e 6f74 6520 4765 7474 696e 6720 7468 *note Getting th │ │ │ │ │ -00019930: 6520 4361 6e6f 6e69 6361 6c0a 2020 2020 e Canonical. │ │ │ │ │ -00019940: 2053 7973 7465 6d20 5479 7065 3a20 2861 System Type: (a │ │ │ │ │ -00019950: 7574 6f63 6f6e 6629 4361 6e6f 6e69 6361 utoconf)Canonica │ │ │ │ │ -00019960: 6c69 7a69 6e67 2e0a 0a27 4143 5f43 4f4e lizing...'AC_CON │ │ │ │ │ -00019970: 4649 475f 4155 585f 4449 5227 0a20 2020 FIG_AUX_DIR'. │ │ │ │ │ -00019980: 2020 4175 746f 6d61 6b65 2077 696c 6c20 Automake will │ │ │ │ │ -00019990: 6c6f 6f6b 2066 6f72 2076 6172 696f 7573 look for various │ │ │ │ │ -000199a0: 2068 656c 7065 7220 7363 7269 7074 732c helper scripts, │ │ │ │ │ -000199b0: 2073 7563 6820 6173 0a20 2020 2020 2769 such as. 'i │ │ │ │ │ -000199c0: 6e73 7461 6c6c 2d73 6827 2c20 696e 2074 nstall-sh', in t │ │ │ │ │ -000199d0: 6865 2064 6972 6563 746f 7279 206e 616d he directory nam │ │ │ │ │ -000199e0: 6564 2069 6e20 7468 6973 206d 6163 726f ed in this macro │ │ │ │ │ -000199f0: 2069 6e76 6f63 6174 696f 6e2e 0a20 2020 invocation.. │ │ │ │ │ -00019a00: 2020 2854 6865 2066 756c 6c20 6c69 7374 (The full list │ │ │ │ │ -00019a10: 206f 6620 7363 7269 7074 7320 6973 3a20 of scripts is: │ │ │ │ │ -00019a20: 2761 722d 6c69 6227 2c20 2763 6f6e 6669 'ar-lib', 'confi │ │ │ │ │ -00019a30: 672e 6775 6573 7327 2c0a 2020 2020 2027 g.guess',. ' │ │ │ │ │ -00019a40: 636f 6e66 6967 2e73 7562 272c 2027 6465 config.sub', 'de │ │ │ │ │ -00019a50: 7063 6f6d 7027 2c20 2765 6c69 7370 2d63 pcomp', 'elisp-c │ │ │ │ │ -00019a60: 6f6d 7027 2c20 2763 6f6d 7069 6c65 272c omp', 'compile', │ │ │ │ │ -00019a70: 2027 696e 7374 616c 6c2d 7368 272c 0a20 'install-sh',. │ │ │ │ │ -00019a80: 2020 2020 276c 746d 6169 6e2e 7368 272c 'ltmain.sh', │ │ │ │ │ -00019a90: 2027 6d64 6174 652d 7368 272c 2027 6d69 'mdate-sh', 'mi │ │ │ │ │ -00019aa0: 7373 696e 6727 2c20 276d 6b69 6e73 7461 ssing', 'mkinsta │ │ │ │ │ -00019ab0: 6c6c 6469 7273 272c 2027 7079 2d63 6f6d lldirs', 'py-com │ │ │ │ │ -00019ac0: 7069 6c65 272c 0a20 2020 2020 2774 6578 pile',. 'tex │ │ │ │ │ -00019ad0: 696e 666f 2e74 6578 272c 2061 6e64 2027 info.tex', and ' │ │ │ │ │ -00019ae0: 796c 7772 6170 272e 2920 204e 6f74 2061 ylwrap'.) Not a │ │ │ │ │ -00019af0: 6c6c 2073 6372 6970 7473 2061 7265 2061 ll scripts are a │ │ │ │ │ -00019b00: 6c77 6179 7320 7365 6172 6368 6564 0a20 lways searched. │ │ │ │ │ -00019b10: 2020 2020 666f 723b 2073 6f6d 6520 7363 for; some sc │ │ │ │ │ -00019b20: 7269 7074 7320 7769 6c6c 206f 6e6c 7920 ripts will only │ │ │ │ │ -00019b30: 6265 2073 6f75 6768 7420 6966 2074 6865 be sought if the │ │ │ │ │ -00019b40: 2067 656e 6572 6174 6564 0a20 2020 2020 generated. │ │ │ │ │ -00019b50: 274d 616b 6566 696c 652e 696e 2720 7265 'Makefile.in' re │ │ │ │ │ -00019b60: 7175 6972 6573 2074 6865 6d2e 0a0a 2020 quires them... │ │ │ │ │ -00019b70: 2020 2049 6620 2741 435f 434f 4e46 4947 If 'AC_CONFIG │ │ │ │ │ -00019b80: 5f41 5558 5f44 4952 2720 6973 206e 6f74 _AUX_DIR' is not │ │ │ │ │ -00019b90: 2067 6976 656e 2c20 7468 6520 7363 7269 given, the scri │ │ │ │ │ -00019ba0: 7074 7320 6172 6520 6c6f 6f6b 6564 2066 pts are looked f │ │ │ │ │ -00019bb0: 6f72 2069 6e0a 2020 2020 2074 6865 6972 or in. their │ │ │ │ │ -00019bc0: 2073 7461 6e64 6172 6420 6c6f 6361 7469 standard locati │ │ │ │ │ -00019bd0: 6f6e 732e 2020 466f 7220 276d 6461 7465 ons. For 'mdate │ │ │ │ │ -00019be0: 2d73 6827 2c20 2774 6578 696e 666f 2e74 -sh', 'texinfo.t │ │ │ │ │ -00019bf0: 6578 272c 2061 6e64 0a20 2020 2020 2779 ex', and. 'y │ │ │ │ │ -00019c00: 6c77 7261 7027 2c20 7468 6520 7374 616e lwrap', the stan │ │ │ │ │ -00019c10: 6461 7264 206c 6f63 6174 696f 6e20 6973 dard location is │ │ │ │ │ -00019c20: 2074 6865 2073 6f75 7263 6520 6469 7265 the source dire │ │ │ │ │ -00019c30: 6374 6f72 790a 2020 2020 2063 6f72 7265 ctory. corre │ │ │ │ │ -00019c40: 7370 6f6e 6469 6e67 2074 6f20 7468 6520 sponding to the │ │ │ │ │ -00019c50: 6375 7272 656e 7420 274d 616b 6566 696c current 'Makefil │ │ │ │ │ -00019c60: 652e 616d 272e 2020 466f 7220 7468 6520 e.am'. For the │ │ │ │ │ -00019c70: 7265 7374 2c20 7468 650a 2020 2020 2073 rest, the. s │ │ │ │ │ -00019c80: 7461 6e64 6172 6420 6c6f 6361 7469 6f6e tandard location │ │ │ │ │ -00019c90: 2069 7320 7468 6520 6669 7273 7420 6f6e is the first on │ │ │ │ │ -00019ca0: 6520 6f66 2027 2e27 2c20 272e 2e27 2c20 e of '.', '..', │ │ │ │ │ -00019cb0: 6f72 2027 2e2e 2f2e 2e27 0a20 2020 2020 or '../..'. │ │ │ │ │ -00019cc0: 2872 656c 6174 6976 6520 746f 2074 6865 (relative to the │ │ │ │ │ -00019cd0: 2074 6f70 2073 6f75 7263 6520 6469 7265 top source dire │ │ │ │ │ -00019ce0: 6374 6f72 7929 2074 6861 7420 7072 6f76 ctory) that prov │ │ │ │ │ -00019cf0: 6964 6573 2061 6e79 206f 6e65 206f 6620 ides any one of │ │ │ │ │ -00019d00: 7468 650a 2020 2020 2068 656c 7065 7220 the. helper │ │ │ │ │ -00019d10: 7363 7269 7074 732e 2020 2a4e 6f74 6520 scripts. *Note │ │ │ │ │ -00019d20: 4669 6e64 696e 6720 2763 6f6e 6669 6775 Finding 'configu │ │ │ │ │ -00019d30: 7265 2720 496e 7075 743a 2028 6175 746f re' Input: (auto │ │ │ │ │ -00019d40: 636f 6e66 2949 6e70 7574 2e0a 0a20 2020 conf)Input... │ │ │ │ │ -00019d50: 2020 5265 7175 6972 6564 2066 696c 6573 Required files │ │ │ │ │ -00019d60: 2066 726f 6d20 2741 435f 434f 4e46 4947 from 'AC_CONFIG │ │ │ │ │ -00019d70: 5f41 5558 5f44 4952 2720 6172 6520 6175 _AUX_DIR' are au │ │ │ │ │ -00019d80: 746f 6d61 7469 6361 6c6c 790a 2020 2020 tomatically. │ │ │ │ │ -00019d90: 2064 6973 7472 6962 7574 6564 2c20 6576 distributed, ev │ │ │ │ │ -00019da0: 656e 2069 6620 7468 6572 6520 6973 206e en if there is n │ │ │ │ │ -00019db0: 6f20 274d 616b 6566 696c 652e 616d 2720 o 'Makefile.am' │ │ │ │ │ -00019dc0: 696e 2074 6869 7320 6469 7265 6374 6f72 in this director │ │ │ │ │ -00019dd0: 792e 0a0a 2741 435f 434f 4e46 4947 5f4c y...'AC_CONFIG_L │ │ │ │ │ -00019de0: 4942 4f42 4a5f 4449 5227 0a20 2020 2020 IBOBJ_DIR'. │ │ │ │ │ -00019df0: 4175 746f 6d61 6b65 2077 696c 6c20 7265 Automake will re │ │ │ │ │ -00019e00: 7175 6972 6520 7468 6520 736f 7572 6365 quire the source │ │ │ │ │ -00019e10: 7320 6669 6c65 2064 6563 6c61 7265 6420 s file declared │ │ │ │ │ -00019e20: 7769 7468 2027 4143 5f4c 4942 534f 5552 with 'AC_LIBSOUR │ │ │ │ │ -00019e30: 4345 270a 2020 2020 2028 7365 6520 6265 CE'. (see be │ │ │ │ │ -00019e40: 6c6f 7729 2069 6e20 7468 6520 6469 7265 low) in the dire │ │ │ │ │ -00019e50: 6374 6f72 7920 7370 6563 6966 6965 6420 ctory specified │ │ │ │ │ -00019e60: 6279 2074 6869 7320 6d61 6372 6f2e 0a0a by this macro... │ │ │ │ │ -00019e70: 2741 435f 434f 4e46 4947 5f48 4541 4445 'AC_CONFIG_HEADE │ │ │ │ │ -00019e80: 5253 270a 2020 2020 2041 7574 6f6d 616b RS'. Automak │ │ │ │ │ -00019e90: 6520 7769 6c6c 2067 656e 6572 6174 6520 e will generate │ │ │ │ │ -00019ea0: 7275 6c65 7320 746f 2072 6562 7569 6c64 rules to rebuild │ │ │ │ │ -00019eb0: 2074 6865 7365 2068 6561 6465 7273 2e20 these headers. │ │ │ │ │ -00019ec0: 204f 6c64 6572 0a20 2020 2020 7665 7273 Older. vers │ │ │ │ │ -00019ed0: 696f 6e73 206f 6620 4175 746f 6d61 6b65 ions of Automake │ │ │ │ │ -00019ee0: 2072 6571 7569 7265 6420 7468 6520 7573 required the us │ │ │ │ │ -00019ef0: 6520 6f66 2027 414d 5f43 4f4e 4649 475f e of 'AM_CONFIG_ │ │ │ │ │ -00019f00: 4845 4144 4552 2720 282a 6e6f 7465 0a20 HEADER' (*note. │ │ │ │ │ -00019f10: 2020 2020 4d61 6372 6f73 3a3a 293b 2074 Macros::); t │ │ │ │ │ -00019f20: 6869 7320 6973 206e 6f20 6c6f 6e67 6572 his is no longer │ │ │ │ │ -00019f30: 2074 6865 2063 6173 652e 0a0a 2020 2020 the case... │ │ │ │ │ -00019f40: 2041 7320 7769 7468 2027 4143 5f43 4f4e As with 'AC_CON │ │ │ │ │ -00019f50: 4649 475f 4649 4c45 5327 2028 2a6e 6f74 FIG_FILES' (*not │ │ │ │ │ -00019f60: 6520 5265 7175 6972 656d 656e 7473 3a3a e Requirements:: │ │ │ │ │ -00019f70: 292c 2070 6172 7473 206f 6620 7468 650a ), parts of the. │ │ │ │ │ -00019f80: 2020 2020 2073 7065 6369 6669 6361 7469 specificati │ │ │ │ │ -00019f90: 6f6e 2075 7369 6e67 2073 6865 6c6c 2076 on using shell v │ │ │ │ │ -00019fa0: 6172 6961 626c 6573 2077 696c 6c20 6265 ariables will be │ │ │ │ │ -00019fb0: 2069 676e 6f72 6564 2061 7320 6661 7220 ignored as far │ │ │ │ │ -00019fc0: 6173 0a20 2020 2020 636c 6561 6e69 6e67 as. cleaning │ │ │ │ │ -00019fd0: 2c20 6469 7374 7269 6275 7469 6e67 2c20 , distributing, │ │ │ │ │ -00019fe0: 616e 6420 7265 6275 696c 6469 6e67 2069 and rebuilding i │ │ │ │ │ -00019ff0: 7320 636f 6e63 6572 6e65 642e 0a0a 2741 s concerned...'A │ │ │ │ │ -0001a000: 435f 434f 4e46 4947 5f4c 494e 4b53 270a C_CONFIG_LINKS'. │ │ │ │ │ -0001a010: 2020 2020 2041 7574 6f6d 616b 6520 7769 Automake wi │ │ │ │ │ -0001a020: 6c6c 2067 656e 6572 6174 6520 7275 6c65 ll generate rule │ │ │ │ │ -0001a030: 7320 746f 2072 656d 6f76 6520 2763 6f6e s to remove 'con │ │ │ │ │ -0001a040: 6669 6775 7265 2720 6765 6e65 7261 7465 figure' generate │ │ │ │ │ -0001a050: 6420 6c69 6e6b 730a 2020 2020 206f 6e20 d links. on │ │ │ │ │ -0001a060: 276d 616b 6520 6469 7374 636c 6561 6e27 'make distclean' │ │ │ │ │ -0001a070: 2061 6e64 2074 6f20 6469 7374 7269 6275 and to distribu │ │ │ │ │ -0001a080: 7465 206e 616d 6564 2073 6f75 7263 6520 te named source │ │ │ │ │ -0001a090: 6669 6c65 7320 6173 2070 6172 7420 6f66 files as part of │ │ │ │ │ -0001a0a0: 0a20 2020 2020 276d 616b 6520 6469 7374 . 'make dist │ │ │ │ │ -0001a0b0: 272e 0a0a 2020 2020 2041 7320 666f 7220 '... As for │ │ │ │ │ -0001a0c0: 2741 435f 434f 4e46 4947 5f46 494c 4553 'AC_CONFIG_FILES │ │ │ │ │ -0001a0d0: 2720 282a 6e6f 7465 2052 6571 7569 7265 ' (*note Require │ │ │ │ │ -0001a0e0: 6d65 6e74 733a 3a29 2c20 7061 7274 7320 ments::), parts │ │ │ │ │ -0001a0f0: 6f66 2074 6865 0a20 2020 2020 7370 6563 of the. spec │ │ │ │ │ -0001a100: 6966 6963 6174 696f 6e20 7573 696e 6720 ification using │ │ │ │ │ -0001a110: 7368 656c 6c20 7661 7269 6162 6c65 7320 shell variables │ │ │ │ │ -0001a120: 7769 6c6c 2062 6520 6967 6e6f 7265 6420 will be ignored │ │ │ │ │ -0001a130: 6173 2066 6172 2061 730a 2020 2020 2063 as far as. c │ │ │ │ │ -0001a140: 6c65 616e 696e 6720 616e 6420 6469 7374 leaning and dist │ │ │ │ │ -0001a150: 7269 6275 7469 6e67 2069 7320 636f 6e63 ributing is conc │ │ │ │ │ -0001a160: 6572 6e65 642e 2020 2854 6865 7265 2061 erned. (There a │ │ │ │ │ -0001a170: 7265 206e 6f20 7265 6275 696c 640a 2020 re no rebuild. │ │ │ │ │ -0001a180: 2020 2072 756c 6573 2066 6f72 206c 696e rules for lin │ │ │ │ │ -0001a190: 6b73 2e29 0a0a 2741 435f 4c49 424f 424a ks.)..'AC_LIBOBJ │ │ │ │ │ -0001a1a0: 270a 2741 435f 4c49 4253 4f55 5243 4527 '.'AC_LIBSOURCE' │ │ │ │ │ -0001a1b0: 0a27 4143 5f4c 4942 534f 5552 4345 5327 .'AC_LIBSOURCES' │ │ │ │ │ -0001a1c0: 0a20 2020 2020 4175 746f 6d61 6b65 2077 . Automake w │ │ │ │ │ -0001a1d0: 696c 6c20 6175 746f 6d61 7469 6361 6c6c ill automaticall │ │ │ │ │ -0001a1e0: 7920 6469 7374 7269 6275 7465 2061 6e79 y distribute any │ │ │ │ │ -0001a1f0: 2066 696c 6520 6c69 7374 6564 2069 6e0a file listed in. │ │ │ │ │ -0001a200: 2020 2020 2027 4143 5f4c 4942 534f 5552 'AC_LIBSOUR │ │ │ │ │ -0001a210: 4345 2720 6f72 2027 4143 5f4c 4942 534f CE' or 'AC_LIBSO │ │ │ │ │ -0001a220: 5552 4345 5327 2e0a 0a20 2020 2020 4e6f URCES'... No │ │ │ │ │ -0001a230: 7465 2074 6861 7420 7468 6520 2741 435f te that the 'AC_ │ │ │ │ │ -0001a240: 4c49 424f 424a 2720 6d61 6372 6f20 6361 LIBOBJ' macro ca │ │ │ │ │ -0001a250: 6c6c 7320 2741 435f 4c49 4253 4f55 5243 lls 'AC_LIBSOURC │ │ │ │ │ -0001a260: 4527 2e20 2053 6f20 6966 2061 6e0a 2020 E'. So if an. │ │ │ │ │ -0001a270: 2020 2041 7574 6f63 6f6e 6620 6d61 6372 Autoconf macr │ │ │ │ │ -0001a280: 6f20 6973 2064 6f63 756d 656e 7465 6420 o is documented │ │ │ │ │ -0001a290: 746f 2063 616c 6c20 2741 435f 4c49 424f to call 'AC_LIBO │ │ │ │ │ -0001a2a0: 424a 285b 6669 6c65 5d29 272c 2074 6865 BJ([file])', the │ │ │ │ │ -0001a2b0: 6e0a 2020 2020 2027 6669 6c65 2e63 2720 n. 'file.c' │ │ │ │ │ -0001a2c0: 7769 6c6c 2062 6520 6469 7374 7269 6275 will be distribu │ │ │ │ │ -0001a2d0: 7465 6420 6175 746f 6d61 7469 6361 6c6c ted automaticall │ │ │ │ │ -0001a2e0: 7920 6279 2041 7574 6f6d 616b 652e 2020 y by Automake. │ │ │ │ │ -0001a2f0: 5468 6973 0a20 2020 2020 656e 636f 6d70 This. encomp │ │ │ │ │ -0001a300: 6173 7365 7320 6d61 6e79 206d 6163 726f asses many macro │ │ │ │ │ -0001a310: 7320 6c69 6b65 2027 4143 5f46 554e 435f s like 'AC_FUNC_ │ │ │ │ │ -0001a320: 414c 4c4f 4341 272c 2027 4143 5f46 554e ALLOCA', 'AC_FUN │ │ │ │ │ -0001a330: 435f 4d45 4d43 4d50 272c 0a20 2020 2020 C_MEMCMP',. │ │ │ │ │ -0001a340: 2741 435f 5245 504c 4143 455f 4655 4e43 'AC_REPLACE_FUNC │ │ │ │ │ -0001a350: 5327 2c20 616e 6420 6f74 6865 7273 2e0a S', and others.. │ │ │ │ │ -0001a360: 0a20 2020 2020 4279 2074 6865 2077 6179 . By the way │ │ │ │ │ -0001a370: 2c20 6469 7265 6374 2061 7373 6967 6e6d , direct assignm │ │ │ │ │ -0001a380: 656e 7473 2074 6f20 274c 4942 4f42 4a53 ents to 'LIBOBJS │ │ │ │ │ -0001a390: 2720 6172 6520 6e6f 206c 6f6e 6765 720a ' are no longer. │ │ │ │ │ -0001a3a0: 2020 2020 2073 7570 706f 7274 6564 2e20 supported. │ │ │ │ │ -0001a3b0: 2059 6f75 2073 686f 756c 6420 616c 7761 You should alwa │ │ │ │ │ -0001a3c0: 7973 2075 7365 2027 4143 5f4c 4942 4f42 ys use 'AC_LIBOB │ │ │ │ │ -0001a3d0: 4a27 2066 6f72 2074 6869 7320 7075 7270 J' for this purp │ │ │ │ │ -0001a3e0: 6f73 652e 0a20 2020 2020 2a4e 6f74 6520 ose.. *Note │ │ │ │ │ -0001a3f0: 2741 435f 4c49 424f 424a 2720 7673 2e20 'AC_LIBOBJ' vs. │ │ │ │ │ -0001a400: 274c 4942 4f42 4a53 273a 2028 6175 746f 'LIBOBJS': (auto │ │ │ │ │ -0001a410: 636f 6e66 2941 435f 4c49 424f 424a 2076 conf)AC_LIBOBJ v │ │ │ │ │ -0001a420: 7320 4c49 424f 424a 532e 0a0a 2741 435f s LIBOBJS...'AC_ │ │ │ │ │ -0001a430: 5052 4f47 5f52 414e 4c49 4227 0a20 2020 PROG_RANLIB'. │ │ │ │ │ -0001a440: 2020 5468 6973 2069 7320 7265 7175 6972 This is requir │ │ │ │ │ -0001a450: 6564 2069 6620 616e 7920 6c69 6272 6172 ed if any librar │ │ │ │ │ -0001a460: 6965 7320 6172 6520 6275 696c 7420 696e ies are built in │ │ │ │ │ -0001a470: 2074 6865 2070 6163 6b61 6765 2e20 202a the package. * │ │ │ │ │ -0001a480: 4e6f 7465 0a20 2020 2020 5061 7274 6963 Note. Partic │ │ │ │ │ -0001a490: 756c 6172 2050 726f 6772 616d 2043 6865 ular Program Che │ │ │ │ │ -0001a4a0: 636b 733a 2028 6175 746f 636f 6e66 2950 cks: (autoconf)P │ │ │ │ │ -0001a4b0: 6172 7469 6375 6c61 7220 5072 6f67 7261 articular Progra │ │ │ │ │ -0001a4c0: 6d73 2e0a 0a27 4143 5f50 524f 475f 4358 ms...'AC_PROG_CX │ │ │ │ │ -0001a4d0: 5827 0a20 2020 2020 5468 6973 2069 7320 X'. This is │ │ │ │ │ -0001a4e0: 7265 7175 6972 6564 2069 6620 616e 7920 required if any │ │ │ │ │ -0001a4f0: 432b 2b20 736f 7572 6365 2069 7320 696e C++ source is in │ │ │ │ │ -0001a500: 636c 7564 6564 2e20 202a 4e6f 7465 2050 cluded. *Note P │ │ │ │ │ -0001a510: 6172 7469 6375 6c61 720a 2020 2020 2050 articular. P │ │ │ │ │ -0001a520: 726f 6772 616d 2043 6865 636b 733a 2028 rogram Checks: ( │ │ │ │ │ -0001a530: 6175 746f 636f 6e66 2950 6172 7469 6375 autoconf)Particu │ │ │ │ │ -0001a540: 6c61 7220 5072 6f67 7261 6d73 2e0a 0a27 lar Programs...' │ │ │ │ │ -0001a550: 4143 5f50 524f 475f 4f42 4a43 270a 2020 AC_PROG_OBJC'. │ │ │ │ │ -0001a560: 2020 2054 6869 7320 6973 2072 6571 7569 This is requi │ │ │ │ │ -0001a570: 7265 6420 6966 2061 6e79 204f 626a 6563 red if any Objec │ │ │ │ │ -0001a580: 7469 7665 2043 2073 6f75 7263 6520 6973 tive C source is │ │ │ │ │ -0001a590: 2069 6e63 6c75 6465 642e 2020 2a4e 6f74 included. *Not │ │ │ │ │ -0001a5a0: 650a 2020 2020 2050 6172 7469 6375 6c61 e. Particula │ │ │ │ │ -0001a5b0: 7220 5072 6f67 7261 6d20 4368 6563 6b73 r Program Checks │ │ │ │ │ -0001a5c0: 3a20 2861 7574 6f63 6f6e 6629 5061 7274 : (autoconf)Part │ │ │ │ │ -0001a5d0: 6963 756c 6172 2050 726f 6772 616d 732e icular Programs. │ │ │ │ │ -0001a5e0: 0a0a 2741 435f 5052 4f47 5f46 3737 270a ..'AC_PROG_F77'. │ │ │ │ │ -0001a5f0: 2020 2020 2054 6869 7320 6973 2072 6571 This is req │ │ │ │ │ -0001a600: 7569 7265 6420 6966 2061 6e79 2046 6f72 uired if any For │ │ │ │ │ -0001a610: 7472 616e 2037 3720 736f 7572 6365 2069 tran 77 source i │ │ │ │ │ -0001a620: 7320 696e 636c 7564 6564 2e20 2054 6869 s included. Thi │ │ │ │ │ -0001a630: 7320 6d61 6372 6f0a 2020 2020 2069 7320 s macro. is │ │ │ │ │ -0001a640: 6469 7374 7269 6275 7465 6420 7769 7468 distributed with │ │ │ │ │ -0001a650: 2041 7574 6f63 6f6e 6620 7665 7273 696f Autoconf versio │ │ │ │ │ -0001a660: 6e20 322e 3133 2061 6e64 206c 6174 6572 n 2.13 and later │ │ │ │ │ -0001a670: 2e20 202a 4e6f 7465 0a20 2020 2020 5061 . *Note. Pa │ │ │ │ │ -0001a680: 7274 6963 756c 6172 2050 726f 6772 616d rticular Program │ │ │ │ │ -0001a690: 2043 6865 636b 733a 2028 6175 746f 636f Checks: (autoco │ │ │ │ │ -0001a6a0: 6e66 2950 6172 7469 6375 6c61 7220 5072 nf)Particular Pr │ │ │ │ │ -0001a6b0: 6f67 7261 6d73 2e0a 0a27 4143 5f46 3737 ograms...'AC_F77 │ │ │ │ │ -0001a6c0: 5f4c 4942 5241 5259 5f4c 4446 4c41 4753 _LIBRARY_LDFLAGS │ │ │ │ │ -0001a6d0: 270a 2020 2020 2054 6869 7320 6973 2072 '. This is r │ │ │ │ │ -0001a6e0: 6571 7569 7265 6420 666f 7220 7072 6f67 equired for prog │ │ │ │ │ -0001a6f0: 7261 6d73 2061 6e64 2073 6861 7265 6420 rams and shared │ │ │ │ │ -0001a700: 6c69 6272 6172 6965 7320 7468 6174 2061 libraries that a │ │ │ │ │ -0001a710: 7265 2061 0a20 2020 2020 6d69 7874 7572 re a. mixtur │ │ │ │ │ -0001a720: 6520 6f66 206c 616e 6775 6167 6573 2074 e of languages t │ │ │ │ │ -0001a730: 6861 7420 696e 636c 7564 6520 466f 7274 hat include Fort │ │ │ │ │ -0001a740: 7261 6e20 3737 2028 2a6e 6f74 6520 4d69 ran 77 (*note Mi │ │ │ │ │ -0001a750: 7869 6e67 2046 6f72 7472 616e 0a20 2020 xing Fortran. │ │ │ │ │ -0001a760: 2020 3737 2057 6974 6820 4320 616e 6420 77 With C and │ │ │ │ │ -0001a770: 432b 2b3a 3a29 2e20 202a 4e6f 7465 2041 C++::). *Note A │ │ │ │ │ -0001a780: 7574 6f63 6f6e 6620 6d61 6372 6f73 2073 utoconf macros s │ │ │ │ │ -0001a790: 7570 706c 6965 6420 7769 7468 0a20 2020 upplied with. │ │ │ │ │ -0001a7a0: 2020 4175 746f 6d61 6b65 3a20 4d61 6372 Automake: Macr │ │ │ │ │ -0001a7b0: 6f73 2e0a 0a27 4143 5f46 435f 5352 4345 os...'AC_FC_SRCE │ │ │ │ │ -0001a7c0: 5854 270a 2020 2020 2041 7574 6f6d 616b XT'. Automak │ │ │ │ │ -0001a7d0: 6520 7769 6c6c 2061 6464 2074 6865 2066 e will add the f │ │ │ │ │ -0001a7e0: 6c61 6773 2063 6f6d 7075 7465 6420 6279 lags computed by │ │ │ │ │ -0001a7f0: 2027 4143 5f46 435f 5352 4345 5854 2720 'AC_FC_SRCEXT' │ │ │ │ │ -0001a800: 746f 0a20 2020 2020 636f 6d70 696c 6174 to. compilat │ │ │ │ │ -0001a810: 696f 6e20 6f66 2066 696c 6573 2077 6974 ion of files wit │ │ │ │ │ -0001a820: 6820 7468 6520 7265 7370 6563 7469 7665 h the respective │ │ │ │ │ -0001a830: 2073 6f75 7263 6520 6578 7465 6e73 696f source extensio │ │ │ │ │ -0001a840: 6e20 282a 6e6f 7465 0a20 2020 2020 466f n (*note. Fo │ │ │ │ │ -0001a850: 7274 7261 6e20 436f 6d70 696c 6572 2043 rtran Compiler C │ │ │ │ │ -0001a860: 6861 7261 6374 6572 6973 7469 6373 3a20 haracteristics: │ │ │ │ │ -0001a870: 2861 7574 6f63 6f6e 6629 466f 7274 7261 (autoconf)Fortra │ │ │ │ │ -0001a880: 6e20 436f 6d70 696c 6572 2e29 2e0a 0a27 n Compiler.)...' │ │ │ │ │ -0001a890: 4143 5f50 524f 475f 4643 270a 2020 2020 AC_PROG_FC'. │ │ │ │ │ -0001a8a0: 2054 6869 7320 6973 2072 6571 7569 7265 This is require │ │ │ │ │ -0001a8b0: 6420 6966 2061 6e79 2046 6f72 7472 616e d if any Fortran │ │ │ │ │ -0001a8c0: 2039 302f 3935 2073 6f75 7263 6520 6973 90/95 source is │ │ │ │ │ -0001a8d0: 2069 6e63 6c75 6465 642e 2020 5468 6973 included. This │ │ │ │ │ -0001a8e0: 0a20 2020 2020 6d61 6372 6f20 6973 2064 . macro is d │ │ │ │ │ -0001a8f0: 6973 7472 6962 7574 6564 2077 6974 6820 istributed with │ │ │ │ │ -0001a900: 4175 746f 636f 6e66 2076 6572 7369 6f6e Autoconf version │ │ │ │ │ -0001a910: 2032 2e35 3820 616e 6420 6c61 7465 722e 2.58 and later. │ │ │ │ │ -0001a920: 2020 2a4e 6f74 650a 2020 2020 2050 6172 *Note. Par │ │ │ │ │ -0001a930: 7469 6375 6c61 7220 5072 6f67 7261 6d20 ticular Program │ │ │ │ │ -0001a940: 4368 6563 6b73 3a20 2861 7574 6f63 6f6e Checks: (autocon │ │ │ │ │ -0001a950: 6629 5061 7274 6963 756c 6172 2050 726f f)Particular Pro │ │ │ │ │ -0001a960: 6772 616d 732e 0a0a 2741 435f 5052 4f47 grams...'AC_PROG │ │ │ │ │ -0001a970: 5f4c 4942 544f 4f4c 270a 2020 2020 2041 _LIBTOOL'. A │ │ │ │ │ -0001a980: 7574 6f6d 616b 6520 7769 6c6c 2074 7572 utomake will tur │ │ │ │ │ -0001a990: 6e20 6f6e 2070 726f 6365 7373 696e 6720 n on processing │ │ │ │ │ -0001a9a0: 666f 7220 276c 6962 746f 6f6c 2720 282a for 'libtool' (* │ │ │ │ │ -0001a9b0: 6e6f 7465 2049 6e74 726f 6475 6374 696f note Introductio │ │ │ │ │ -0001a9c0: 6e3a 0a20 2020 2020 286c 6962 746f 6f6c n:. (libtool │ │ │ │ │ -0001a9d0: 2954 6f70 2e29 2e0a 0a27 4143 5f50 524f )Top.)...'AC_PRO │ │ │ │ │ -0001a9e0: 475f 5941 4343 270a 2020 2020 2049 6620 G_YACC'. If │ │ │ │ │ -0001a9f0: 6120 5961 6363 2073 6f75 7263 6520 6669 a Yacc source fi │ │ │ │ │ -0001aa00: 6c65 2069 7320 7365 656e 2c20 7468 656e le is seen, then │ │ │ │ │ -0001aa10: 2079 6f75 206d 7573 7420 6569 7468 6572 you must either │ │ │ │ │ -0001aa20: 2075 7365 2074 6869 7320 6d61 6372 6f0a use this macro. │ │ │ │ │ -0001aa30: 2020 2020 206f 7220 6465 6669 6e65 2074 or define t │ │ │ │ │ -0001aa40: 6865 2076 6172 6961 626c 6520 2759 4143 he variable 'YAC │ │ │ │ │ -0001aa50: 4327 2069 6e20 2763 6f6e 6669 6775 7265 C' in 'configure │ │ │ │ │ -0001aa60: 2e61 6327 2e20 2054 6865 2066 6f72 6d65 .ac'. The forme │ │ │ │ │ -0001aa70: 7220 6973 0a20 2020 2020 7072 6566 6572 r is. prefer │ │ │ │ │ -0001aa80: 7265 6420 282a 6e6f 7465 2050 6172 7469 red (*note Parti │ │ │ │ │ -0001aa90: 6375 6c61 7220 5072 6f67 7261 6d20 4368 cular Program Ch │ │ │ │ │ -0001aaa0: 6563 6b73 3a20 2861 7574 6f63 6f6e 6629 ecks: (autoconf) │ │ │ │ │ -0001aab0: 5061 7274 6963 756c 6172 0a20 2020 2020 Particular. │ │ │ │ │ -0001aac0: 5072 6f67 7261 6d73 2e29 2e0a 0a27 4143 Programs.)...'AC │ │ │ │ │ -0001aad0: 5f50 524f 475f 4c45 5827 0a20 2020 2020 _PROG_LEX'. │ │ │ │ │ -0001aae0: 4966 2061 204c 6578 2073 6f75 7263 6520 If a Lex source │ │ │ │ │ -0001aaf0: 6669 6c65 2069 7320 7365 656e 2c20 7468 file is seen, th │ │ │ │ │ -0001ab00: 656e 2074 6869 7320 6d61 6372 6f20 6d75 en this macro mu │ │ │ │ │ -0001ab10: 7374 2062 6520 7573 6564 2e20 202a 4e6f st be used. *No │ │ │ │ │ -0001ab20: 7465 0a20 2020 2020 5061 7274 6963 756c te. Particul │ │ │ │ │ -0001ab30: 6172 2050 726f 6772 616d 2043 6865 636b ar Program Check │ │ │ │ │ -0001ab40: 733a 2028 6175 746f 636f 6e66 2950 6172 s: (autoconf)Par │ │ │ │ │ -0001ab50: 7469 6375 6c61 7220 5072 6f67 7261 6d73 ticular Programs │ │ │ │ │ -0001ab60: 2e0a 0a27 4143 5f52 4551 5549 5245 5f41 ...'AC_REQUIRE_A │ │ │ │ │ -0001ab70: 5558 5f46 494c 4527 0a20 2020 2020 466f UX_FILE'. Fo │ │ │ │ │ -0001ab80: 7220 6561 6368 2027 4143 5f52 4551 5549 r each 'AC_REQUI │ │ │ │ │ -0001ab90: 5245 5f41 5558 5f46 494c 4528 5b46 494c RE_AUX_FILE([FIL │ │ │ │ │ -0001aba0: 455d 2927 2c20 2761 7574 6f6d 616b 6527 E])', 'automake' │ │ │ │ │ -0001abb0: 2077 696c 6c20 656e 7375 7265 2074 6861 will ensure tha │ │ │ │ │ -0001abc0: 740a 2020 2020 2027 4649 4c45 2720 6578 t. 'FILE' ex │ │ │ │ │ -0001abd0: 6973 7473 2069 6e20 7468 6520 6175 7820 ists in the aux │ │ │ │ │ -0001abe0: 6469 7265 6374 6f72 792c 2061 6e64 2077 directory, and w │ │ │ │ │ -0001abf0: 696c 6c20 636f 6d70 6c61 696e 206f 7468 ill complain oth │ │ │ │ │ -0001ac00: 6572 7769 7365 2e0a 2020 2020 2049 7420 erwise.. It │ │ │ │ │ -0001ac10: 7769 6c6c 2061 6c73 6f20 6175 746f 6d61 will also automa │ │ │ │ │ -0001ac20: 7469 6361 6c6c 7920 6469 7374 7269 6275 tically distribu │ │ │ │ │ -0001ac30: 7465 2074 6865 2066 696c 652e 2020 5468 te the file. Th │ │ │ │ │ -0001ac40: 6973 206d 6163 726f 2073 686f 756c 640a is macro should. │ │ │ │ │ -0001ac50: 2020 2020 2062 6520 7573 6564 2062 7920 be used by │ │ │ │ │ -0001ac60: 7468 6972 642d 7061 7274 7920 4175 746f third-party Auto │ │ │ │ │ -0001ac70: 636f 6e66 206d 6163 726f 7320 7468 6174 conf macros that │ │ │ │ │ -0001ac80: 2072 6571 7569 7265 2073 6f6d 6520 7375 require some su │ │ │ │ │ -0001ac90: 7070 6f72 7469 6e67 0a20 2020 2020 6669 pporting. fi │ │ │ │ │ -0001aca0: 6c65 7320 696e 2074 6865 2061 7578 2064 les in the aux d │ │ │ │ │ -0001acb0: 6972 6563 746f 7279 2073 7065 6369 6669 irectory specifi │ │ │ │ │ -0001acc0: 6564 2077 6974 6820 2741 435f 434f 4e46 ed with 'AC_CONF │ │ │ │ │ -0001acd0: 4947 5f41 5558 5f44 4952 270a 2020 2020 IG_AUX_DIR'. │ │ │ │ │ -0001ace0: 2061 626f 7665 2e20 202a 4e6f 7465 2046 above. *Note F │ │ │ │ │ -0001acf0: 696e 6469 6e67 2027 636f 6e66 6967 7572 inding 'configur │ │ │ │ │ -0001ad00: 6527 2049 6e70 7574 3a20 2861 7574 6f63 e' Input: (autoc │ │ │ │ │ -0001ad10: 6f6e 6629 496e 7075 742e 0a0a 2741 435f onf)Input...'AC_ │ │ │ │ │ -0001ad20: 5355 4253 5427 0a20 2020 2020 5468 6520 SUBST'. The │ │ │ │ │ -0001ad30: 6669 7273 7420 6172 6775 6d65 6e74 2069 first argument i │ │ │ │ │ -0001ad40: 7320 6175 746f 6d61 7469 6361 6c6c 7920 s automatically │ │ │ │ │ -0001ad50: 6465 6669 6e65 6420 6173 2061 2076 6172 defined as a var │ │ │ │ │ -0001ad60: 6961 626c 6520 696e 2065 6163 680a 2020 iable in each. │ │ │ │ │ -0001ad70: 2020 2067 656e 6572 6174 6564 2027 4d61 generated 'Ma │ │ │ │ │ -0001ad80: 6b65 6669 6c65 2e69 6e27 2c20 756e 6c65 kefile.in', unle │ │ │ │ │ -0001ad90: 7373 2027 414d 5f53 5542 5354 5f4e 4f54 ss 'AM_SUBST_NOT │ │ │ │ │ -0001ada0: 4d41 4b45 2720 6973 2061 6c73 6f20 7573 MAKE' is also us │ │ │ │ │ -0001adb0: 6564 2066 6f72 0a20 2020 2020 7468 6973 ed for. this │ │ │ │ │ -0001adc0: 2076 6172 6961 626c 652e 2020 2a4e 6f74 variable. *Not │ │ │ │ │ -0001add0: 6520 5365 7474 696e 6720 4f75 7470 7574 e Setting Output │ │ │ │ │ -0001ade0: 2056 6172 6961 626c 6573 3a20 2861 7574 Variables: (aut │ │ │ │ │ -0001adf0: 6f63 6f6e 6629 5365 7474 696e 670a 2020 oconf)Setting. │ │ │ │ │ -0001ae00: 2020 204f 7574 7075 7420 5661 7269 6162 Output Variab │ │ │ │ │ -0001ae10: 6c65 732e 0a0a 2020 2020 2046 6f72 2065 les... For e │ │ │ │ │ -0001ae20: 7665 7279 2073 7562 7374 6974 7574 6564 very substituted │ │ │ │ │ -0001ae30: 2076 6172 6961 626c 6520 5641 522c 2027 variable VAR, ' │ │ │ │ │ -0001ae40: 6175 746f 6d61 6b65 2720 7769 6c6c 2061 automake' will a │ │ │ │ │ -0001ae50: 6464 2061 206c 696e 6520 2756 4152 0a20 dd a line 'VAR. │ │ │ │ │ -0001ae60: 2020 2020 3d20 5641 4c55 4527 2074 6f20 = VALUE' to │ │ │ │ │ -0001ae70: 6561 6368 2027 4d61 6b65 6669 6c65 2e69 each 'Makefile.i │ │ │ │ │ -0001ae80: 6e27 2066 696c 652e 2020 4d61 6e79 2041 n' file. Many A │ │ │ │ │ -0001ae90: 7574 6f63 6f6e 6620 6d61 6372 6f73 2069 utoconf macros i │ │ │ │ │ -0001aea0: 6e76 6f6b 650a 2020 2020 2027 4143 5f53 nvoke. 'AC_S │ │ │ │ │ -0001aeb0: 5542 5354 2720 746f 2073 6574 206f 7574 UBST' to set out │ │ │ │ │ -0001aec0: 7075 7420 7661 7269 6162 6c65 7320 7468 put variables th │ │ │ │ │ -0001aed0: 6973 2077 6179 2c20 652e 672e 2c20 2741 is way, e.g., 'A │ │ │ │ │ -0001aee0: 435f 5041 5448 5f58 5452 4127 0a20 2020 C_PATH_XTRA'. │ │ │ │ │ -0001aef0: 2020 6465 6669 6e65 7320 2758 5f43 464c defines 'X_CFL │ │ │ │ │ -0001af00: 4147 5327 2061 6e64 2027 585f 4c49 4253 AGS' and 'X_LIBS │ │ │ │ │ -0001af10: 272e 2020 5468 7573 2c20 796f 7520 6361 '. Thus, you ca │ │ │ │ │ -0001af20: 6e20 6163 6365 7373 2074 6865 7365 0a20 n access these. │ │ │ │ │ -0001af30: 2020 2020 7661 7269 6162 6c65 7320 6173 variables as │ │ │ │ │ -0001af40: 2027 2428 585f 4346 4c41 4753 2927 2061 '$(X_CFLAGS)' a │ │ │ │ │ -0001af50: 6e64 2027 2428 585f 4c49 4253 2927 2069 nd '$(X_LIBS)' i │ │ │ │ │ -0001af60: 6e20 616e 7920 274d 616b 6566 696c 652e n any 'Makefile. │ │ │ │ │ -0001af70: 616d 2720 6966 0a20 2020 2020 2741 435f am' if. 'AC_ │ │ │ │ │ -0001af80: 5041 5448 5f58 5452 4127 2069 7320 6361 PATH_XTRA' is ca │ │ │ │ │ -0001af90: 6c6c 6564 2e0a 0a27 414d 5f43 5f50 524f lled...'AM_C_PRO │ │ │ │ │ -0001afa0: 544f 5459 5045 5327 0a20 2020 2020 5468 TOTYPES'. Th │ │ │ │ │ -0001afb0: 6973 2069 7320 7265 7175 6972 6564 2077 is is required w │ │ │ │ │ -0001afc0: 6865 6e20 7573 696e 6720 7468 6520 6465 hen using the de │ │ │ │ │ -0001afd0: 7072 6563 6174 6564 2064 652d 414e 5349 precated de-ANSI │ │ │ │ │ -0001afe0: 2d66 6963 6174 696f 6e0a 2020 2020 2066 -fication. f │ │ │ │ │ -0001aff0: 6561 7475 7265 3b20 2a6e 6f74 6520 414e eature; *note AN │ │ │ │ │ -0001b000: 5349 3a3a 2e20 205f 4974 2077 696c 6c20 SI::. _It will │ │ │ │ │ -0001b010: 6265 2072 656d 6f76 6564 5f20 696e 2074 be removed_ in t │ │ │ │ │ -0001b020: 6865 206e 6578 7420 6d61 6a6f 720a 2020 he next major. │ │ │ │ │ -0001b030: 2020 2041 7574 6f6d 616b 6520 7265 6c65 Automake rele │ │ │ │ │ -0001b040: 6173 652e 0a0a 2741 4d5f 434f 4e44 4954 ase...'AM_CONDIT │ │ │ │ │ -0001b050: 494f 4e41 4c27 0a20 2020 2020 5468 6973 IONAL'. This │ │ │ │ │ -0001b060: 2069 6e74 726f 6475 6365 7320 616e 2041 introduces an A │ │ │ │ │ -0001b070: 7574 6f6d 616b 6520 636f 6e64 6974 696f utomake conditio │ │ │ │ │ -0001b080: 6e61 6c20 282a 6e6f 7465 2043 6f6e 6469 nal (*note Condi │ │ │ │ │ -0001b090: 7469 6f6e 616c 733a 3a29 2e0a 0a27 414d tionals::)...'AM │ │ │ │ │ -0001b0a0: 5f43 4f4e 445f 4946 270a 2020 2020 2054 _COND_IF'. T │ │ │ │ │ -0001b0b0: 6869 7320 6d61 6372 6f20 616c 6c6f 7773 his macro allows │ │ │ │ │ -0001b0c0: 2027 6175 746f 6d61 6b65 2720 746f 2064 'automake' to d │ │ │ │ │ -0001b0d0: 6574 6563 7420 7375 6273 6571 7565 6e74 etect subsequent │ │ │ │ │ -0001b0e0: 2061 6363 6573 7320 7769 7468 696e 0a20 access within. │ │ │ │ │ -0001b0f0: 2020 2020 2763 6f6e 6669 6775 7265 2e61 'configure.a │ │ │ │ │ -0001b100: 6327 2074 6f20 6120 636f 6e64 6974 696f c' to a conditio │ │ │ │ │ -0001b110: 6e61 6c20 7072 6576 696f 7573 6c79 2069 nal previously i │ │ │ │ │ -0001b120: 6e74 726f 6475 6365 6420 7769 7468 0a20 ntroduced with. │ │ │ │ │ -0001b130: 2020 2020 2741 4d5f 434f 4e44 4954 494f 'AM_CONDITIO │ │ │ │ │ -0001b140: 4e41 4c27 2c20 7468 7573 2065 6e61 626c NAL', thus enabl │ │ │ │ │ -0001b150: 696e 6720 636f 6e64 6974 696f 6e61 6c20 ing conditional │ │ │ │ │ -0001b160: 2741 435f 434f 4e46 4947 5f46 494c 4553 'AC_CONFIG_FILES │ │ │ │ │ -0001b170: 270a 2020 2020 2028 2a6e 6f74 6520 5573 '. (*note Us │ │ │ │ │ -0001b180: 6167 6520 6f66 2043 6f6e 6469 7469 6f6e age of Condition │ │ │ │ │ -0001b190: 616c 733a 3a29 2e0a 0a27 414d 5f47 4e55 als::)...'AM_GNU │ │ │ │ │ -0001b1a0: 5f47 4554 5445 5854 270a 2020 2020 2054 _GETTEXT'. T │ │ │ │ │ -0001b1b0: 6869 7320 6d61 6372 6f20 6973 2072 6571 his macro is req │ │ │ │ │ -0001b1c0: 7569 7265 6420 666f 7220 7061 636b 6167 uired for packag │ │ │ │ │ -0001b1d0: 6573 2074 6861 7420 7573 6520 474e 5520 es that use GNU │ │ │ │ │ -0001b1e0: 6765 7474 6578 7420 282a 6e6f 7465 0a20 gettext (*note. │ │ │ │ │ -0001b1f0: 2020 2020 6765 7474 6578 743a 3a29 2e20 gettext::). │ │ │ │ │ -0001b200: 2049 7420 6973 2064 6973 7472 6962 7574 It is distribut │ │ │ │ │ -0001b210: 6564 2077 6974 6820 6765 7474 6578 742e ed with gettext. │ │ │ │ │ -0001b220: 2020 4966 2041 7574 6f6d 616b 6520 7365 If Automake se │ │ │ │ │ -0001b230: 6573 2074 6869 730a 2020 2020 206d 6163 es this. mac │ │ │ │ │ -0001b240: 726f 2069 7420 656e 7375 7265 7320 7468 ro it ensures th │ │ │ │ │ -0001b250: 6174 2074 6865 2070 6163 6b61 6765 206d at the package m │ │ │ │ │ -0001b260: 6565 7473 2073 6f6d 6520 6f66 2067 6574 eets some of get │ │ │ │ │ -0001b270: 7465 7874 2773 0a20 2020 2020 7265 7175 text's. requ │ │ │ │ │ -0001b280: 6972 656d 656e 7473 2e0a 0a27 414d 5f47 irements...'AM_G │ │ │ │ │ -0001b290: 4e55 5f47 4554 5445 5854 5f49 4e54 4c5f NU_GETTEXT_INTL_ │ │ │ │ │ -0001b2a0: 5355 4244 4952 270a 2020 2020 2054 6869 SUBDIR'. Thi │ │ │ │ │ -0001b2b0: 7320 6d61 6372 6f20 7370 6563 6966 6965 s macro specifie │ │ │ │ │ -0001b2c0: 7320 7468 6174 2074 6865 2027 696e 746c s that the 'intl │ │ │ │ │ -0001b2d0: 2f27 2073 7562 6469 7265 6374 6f72 7920 /' subdirectory │ │ │ │ │ -0001b2e0: 6973 2074 6f20 6265 2062 7569 6c74 2c0a is to be built,. │ │ │ │ │ -0001b2f0: 2020 2020 2065 7665 6e20 6966 2074 6865 even if the │ │ │ │ │ -0001b300: 2027 414d 5f47 4e55 5f47 4554 5445 5854 'AM_GNU_GETTEXT │ │ │ │ │ -0001b310: 2720 6d61 6372 6f20 7761 7320 696e 766f ' macro was invo │ │ │ │ │ -0001b320: 6b65 6420 7769 7468 2061 2066 6972 7374 ked with a first │ │ │ │ │ -0001b330: 0a20 2020 2020 6172 6775 6d65 6e74 206f . argument o │ │ │ │ │ -0001b340: 6620 2765 7874 6572 6e61 6c27 2e0a 0a27 f 'external'...' │ │ │ │ │ -0001b350: 414d 5f4d 4149 4e54 4149 4e45 525f 4d4f AM_MAINTAINER_MO │ │ │ │ │ -0001b360: 4445 285b 4445 4641 554c 542d 4d4f 4445 DE([DEFAULT-MODE │ │ │ │ │ -0001b370: 5d29 270a 2020 2020 2054 6869 7320 6d61 ])'. This ma │ │ │ │ │ -0001b380: 6372 6f20 6164 6473 2061 6e20 272d 2d65 cro adds an '--e │ │ │ │ │ -0001b390: 6e61 626c 652d 6d61 696e 7461 696e 6572 nable-maintainer │ │ │ │ │ -0001b3a0: 2d6d 6f64 6527 206f 7074 696f 6e20 746f -mode' option to │ │ │ │ │ -0001b3b0: 0a20 2020 2020 2763 6f6e 6669 6775 7265 . 'configure │ │ │ │ │ -0001b3c0: 272e 2020 4966 2074 6869 7320 6973 2075 '. If this is u │ │ │ │ │ -0001b3d0: 7365 642c 2027 6175 746f 6d61 6b65 2720 sed, 'automake' │ │ │ │ │ -0001b3e0: 7769 6c6c 2063 6175 7365 0a20 2020 2020 will cause. │ │ │ │ │ -0001b3f0: 226d 6169 6e74 6169 6e65 722d 6f6e 6c79 "maintainer-only │ │ │ │ │ -0001b400: 2220 7275 6c65 7320 746f 2062 6520 7475 " rules to be tu │ │ │ │ │ -0001b410: 726e 6564 206f 6666 2062 7920 6465 6661 rned off by defa │ │ │ │ │ -0001b420: 756c 7420 696e 2074 6865 0a20 2020 2020 ult in the. │ │ │ │ │ -0001b430: 6765 6e65 7261 7465 6420 274d 616b 6566 generated 'Makef │ │ │ │ │ -0001b440: 696c 652e 696e 2773 2c20 756e 6c65 7373 ile.in's, unless │ │ │ │ │ -0001b450: 2044 4546 4155 4c54 2d4d 4f44 4520 6973 DEFAULT-MODE is │ │ │ │ │ -0001b460: 2027 656e 6162 6c65 272e 2020 5468 6973 'enable'. This │ │ │ │ │ -0001b470: 0a20 2020 2020 6d61 6372 6f20 6465 6669 . macro defi │ │ │ │ │ -0001b480: 6e65 7320 7468 6520 274d 4149 4e54 4149 nes the 'MAINTAI │ │ │ │ │ -0001b490: 4e45 525f 4d4f 4445 2720 636f 6e64 6974 NER_MODE' condit │ │ │ │ │ -0001b4a0: 696f 6e61 6c2c 2077 6869 6368 2079 6f75 ional, which you │ │ │ │ │ -0001b4b0: 2063 616e 2075 7365 0a20 2020 2020 696e can use. in │ │ │ │ │ -0001b4c0: 2079 6f75 7220 6f77 6e20 274d 616b 6566 your own 'Makef │ │ │ │ │ -0001b4d0: 696c 652e 616d 272e 2020 2a4e 6f74 6520 ile.am'. *Note │ │ │ │ │ -0001b4e0: 6d61 696e 7461 696e 6572 2d6d 6f64 653a maintainer-mode: │ │ │ │ │ -0001b4f0: 3a2e 0a0a 2741 4d5f 5355 4253 545f 4e4f :...'AM_SUBST_NO │ │ │ │ │ -0001b500: 544d 414b 4528 5641 5229 270a 2020 2020 TMAKE(VAR)'. │ │ │ │ │ -0001b510: 2050 7265 7665 6e74 2041 7574 6f6d 616b Prevent Automak │ │ │ │ │ -0001b520: 6520 6672 6f6d 2064 6566 696e 696e 6720 e from defining │ │ │ │ │ -0001b530: 6120 7661 7269 6162 6c65 2056 4152 2c20 a variable VAR, │ │ │ │ │ -0001b540: 6576 656e 2069 6620 6974 2069 730a 2020 even if it is. │ │ │ │ │ -0001b550: 2020 2073 7562 7374 6974 7574 6564 2062 substituted b │ │ │ │ │ -0001b560: 7920 2763 6f6e 6669 672e 7374 6174 7573 y 'config.status │ │ │ │ │ -0001b570: 272e 2020 4e6f 726d 616c 6c79 2c20 4175 '. Normally, Au │ │ │ │ │ -0001b580: 746f 6d61 6b65 2064 6566 696e 6573 2061 tomake defines a │ │ │ │ │ -0001b590: 0a20 2020 2020 276d 616b 6527 2076 6172 . 'make' var │ │ │ │ │ -0001b5a0: 6961 626c 6520 666f 7220 6561 6368 2027 iable for each ' │ │ │ │ │ -0001b5b0: 636f 6e66 6967 7572 6527 2073 7562 7374 configure' subst │ │ │ │ │ -0001b5c0: 6974 7574 696f 6e2c 2069 2e65 2e2c 2066 itution, i.e., f │ │ │ │ │ -0001b5d0: 6f72 2065 6163 680a 2020 2020 2027 4143 or each. 'AC │ │ │ │ │ -0001b5e0: 5f53 5542 5354 285b 5641 525d 2927 2e20 _SUBST([VAR])'. │ │ │ │ │ -0001b5f0: 2054 6869 7320 6d61 6372 6f20 7072 6576 This macro prev │ │ │ │ │ -0001b600: 656e 7473 2074 6861 7420 6465 6669 6e69 ents that defini │ │ │ │ │ -0001b610: 7469 6f6e 2066 726f 6d0a 2020 2020 2041 tion from. A │ │ │ │ │ -0001b620: 7574 6f6d 616b 652e 2020 4966 2027 4143 utomake. If 'AC │ │ │ │ │ -0001b630: 5f53 5542 5354 2720 6861 7320 6e6f 7420 _SUBST' has not │ │ │ │ │ -0001b640: 6265 656e 2063 616c 6c65 6420 666f 7220 been called for │ │ │ │ │ -0001b650: 7468 6973 2076 6172 6961 626c 652c 0a20 this variable,. │ │ │ │ │ -0001b660: 2020 2020 7468 656e 2027 414d 5f53 5542 then 'AM_SUB │ │ │ │ │ -0001b670: 5354 5f4e 4f54 4d41 4b45 2720 6861 7320 ST_NOTMAKE' has │ │ │ │ │ -0001b680: 6e6f 2065 6666 6563 7473 2e20 2050 7265 no effects. Pre │ │ │ │ │ -0001b690: 7665 6e74 696e 6720 7661 7269 6162 6c65 venting variable │ │ │ │ │ -0001b6a0: 0a20 2020 2020 6465 6669 6e69 7469 6f6e . definition │ │ │ │ │ -0001b6b0: 7320 6d61 7920 6265 2075 7365 6675 6c20 s may be useful │ │ │ │ │ -0001b6c0: 666f 7220 7375 6273 7469 7475 7469 6f6e for substitution │ │ │ │ │ -0001b6d0: 206f 6620 6d75 6c74 692d 6c69 6e65 2076 of multi-line v │ │ │ │ │ -0001b6e0: 616c 7565 732c 0a20 2020 2020 7768 6572 alues,. wher │ │ │ │ │ -0001b6f0: 6520 2756 4152 203d 2040 5641 4c55 4540 e 'VAR = @VALUE@ │ │ │ │ │ -0001b700: 2720 6d69 6768 7420 7969 656c 6420 756e ' might yield un │ │ │ │ │ -0001b710: 696e 7465 6e64 6564 2072 6573 756c 7473 intended results │ │ │ │ │ -0001b720: 2e0a 0a27 6d34 5f69 6e63 6c75 6465 270a ...'m4_include'. │ │ │ │ │ -0001b730: 2020 2020 2046 696c 6573 2069 6e63 6c75 Files inclu │ │ │ │ │ -0001b740: 6465 6420 6279 2027 636f 6e66 6967 7572 ded by 'configur │ │ │ │ │ -0001b750: 652e 6163 2720 7573 696e 6720 7468 6973 e.ac' using this │ │ │ │ │ -0001b760: 206d 6163 726f 2077 696c 6c20 6265 2064 macro will be d │ │ │ │ │ -0001b770: 6574 6563 7465 640a 2020 2020 2062 7920 etected. by │ │ │ │ │ -0001b780: 4175 746f 6d61 6b65 2061 6e64 2061 7574 Automake and aut │ │ │ │ │ -0001b790: 6f6d 6174 6963 616c 6c79 2064 6973 7472 omatically distr │ │ │ │ │ -0001b7a0: 6962 7574 6564 2e20 2054 6865 7920 7769 ibuted. They wi │ │ │ │ │ -0001b7b0: 6c6c 2061 6c73 6f20 6170 7065 6172 0a20 ll also appear. │ │ │ │ │ -0001b7c0: 2020 2020 6173 2064 6570 656e 6465 6e63 as dependenc │ │ │ │ │ -0001b7d0: 6965 7320 696e 2027 4d61 6b65 6669 6c65 ies in 'Makefile │ │ │ │ │ -0001b7e0: 2720 7275 6c65 732e 0a0a 2020 2020 2027 ' rules... ' │ │ │ │ │ -0001b7f0: 6d34 5f69 6e63 6c75 6465 2720 6973 2073 m4_include' is s │ │ │ │ │ -0001b800: 656c 646f 6d20 7573 6564 2062 7920 2763 eldom used by 'c │ │ │ │ │ -0001b810: 6f6e 6669 6775 7265 2e61 6327 2061 7574 onfigure.ac' aut │ │ │ │ │ -0001b820: 686f 7273 2c20 6275 7420 6361 6e0a 2020 hors, but can. │ │ │ │ │ -0001b830: 2020 2061 7070 6561 7220 696e 2027 6163 appear in 'ac │ │ │ │ │ -0001b840: 6c6f 6361 6c2e 6d34 2720 7768 656e 2027 local.m4' when ' │ │ │ │ │ -0001b850: 6163 6c6f 6361 6c27 2064 6574 6563 7473 aclocal' detects │ │ │ │ │ -0001b860: 2074 6861 7420 736f 6d65 2072 6571 7569 that some requi │ │ │ │ │ -0001b870: 7265 640a 2020 2020 206d 6163 726f 7320 red. macros │ │ │ │ │ -0001b880: 636f 6d65 2066 726f 6d20 6669 6c65 7320 come from files │ │ │ │ │ -0001b890: 6c6f 6361 6c20 746f 2079 6f75 7220 7061 local to your pa │ │ │ │ │ -0001b8a0: 636b 6167 6520 2861 7320 6f70 706f 7365 ckage (as oppose │ │ │ │ │ -0001b8b0: 6420 746f 206d 6163 726f 730a 2020 2020 d to macros. │ │ │ │ │ -0001b8c0: 2069 6e73 7461 6c6c 6564 2069 6e20 6120 installed in a │ │ │ │ │ -0001b8d0: 7379 7374 656d 2d77 6964 6520 6469 7265 system-wide dire │ │ │ │ │ -0001b8e0: 6374 6f72 792c 202a 6e6f 7465 2061 636c ctory, *note acl │ │ │ │ │ -0001b8f0: 6f63 616c 2049 6e76 6f63 6174 696f 6e3a ocal Invocation: │ │ │ │ │ -0001b900: 3a29 2e0a 0a1f 0a46 696c 653a 2061 7574 :).....File: aut │ │ │ │ │ -0001b910: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -0001b920: 2020 4e6f 6465 3a20 6163 6c6f 6361 6c20 Node: aclocal │ │ │ │ │ -0001b930: 496e 766f 6361 7469 6f6e 2c20 204e 6578 Invocation, Nex │ │ │ │ │ -0001b940: 743a 204d 6163 726f 732c 2020 5072 6576 t: Macros, Prev │ │ │ │ │ -0001b950: 3a20 4f70 7469 6f6e 616c 2c20 2055 703a : Optional, Up: │ │ │ │ │ -0001b960: 2063 6f6e 6669 6775 7265 0a0a 362e 3320 configure..6.3 │ │ │ │ │ -0001b970: 4175 746f 2d67 656e 6572 6174 696e 6720 Auto-generating │ │ │ │ │ -0001b980: 6163 6c6f 6361 6c2e 6d34 0a3d 3d3d 3d3d aclocal.m4.===== │ │ │ │ │ +00019740: 3d3d 3d0a 0a45 7665 7279 2074 696d 6520 ===..Every time │ │ │ │ │ +00019750: 4175 746f 6d61 6b65 2069 7320 7275 6e20 Automake is run │ │ │ │ │ +00019760: 6974 2063 616c 6c73 2041 7574 6f63 6f6e it calls Autocon │ │ │ │ │ +00019770: 6620 746f 2074 7261 6365 2027 636f 6e66 f to trace 'conf │ │ │ │ │ +00019780: 6967 7572 652e 6163 272e 0a54 6869 7320 igure.ac'..This │ │ │ │ │ +00019790: 7761 7920 6974 2063 616e 2072 6563 6f67 way it can recog │ │ │ │ │ +000197a0: 6e69 7a65 2074 6865 2075 7365 206f 6620 nize the use of │ │ │ │ │ +000197b0: 6365 7274 6169 6e20 6d61 6372 6f73 2061 certain macros a │ │ │ │ │ +000197c0: 6e64 2074 6169 6c6f 7220 7468 650a 6765 nd tailor the.ge │ │ │ │ │ +000197d0: 6e65 7261 7465 6420 274d 616b 6566 696c nerated 'Makefil │ │ │ │ │ +000197e0: 652e 696e 2720 6170 7072 6f70 7269 6174 e.in' appropriat │ │ │ │ │ +000197f0: 656c 792e 2020 4375 7272 656e 746c 7920 ely. Currently │ │ │ │ │ +00019800: 7265 636f 676e 697a 6564 206d 6163 726f recognized macro │ │ │ │ │ +00019810: 7320 616e 640a 7468 6569 7220 6566 6665 s and.their effe │ │ │ │ │ +00019820: 6374 7320 6172 653a 0a0a 2741 435f 4341 cts are:..'AC_CA │ │ │ │ │ +00019830: 4e4f 4e49 4341 4c5f 4255 494c 4427 0a27 NONICAL_BUILD'.' │ │ │ │ │ +00019840: 4143 5f43 414e 4f4e 4943 414c 5f48 4f53 AC_CANONICAL_HOS │ │ │ │ │ +00019850: 5427 0a27 4143 5f43 414e 4f4e 4943 414c T'.'AC_CANONICAL │ │ │ │ │ +00019860: 5f54 4152 4745 5427 0a20 2020 2020 4175 _TARGET'. Au │ │ │ │ │ +00019870: 746f 6d61 6b65 2077 696c 6c20 656e 7375 tomake will ensu │ │ │ │ │ +00019880: 7265 2074 6861 7420 2763 6f6e 6669 672e re that 'config. │ │ │ │ │ +00019890: 6775 6573 7327 2061 6e64 2027 636f 6e66 guess' and 'conf │ │ │ │ │ +000198a0: 6967 2e73 7562 2720 6578 6973 742e 0a20 ig.sub' exist.. │ │ │ │ │ +000198b0: 2020 2020 416c 736f 2c20 7468 6520 274d Also, the 'M │ │ │ │ │ +000198c0: 616b 6566 696c 6527 2076 6172 6961 626c akefile' variabl │ │ │ │ │ +000198d0: 6573 2027 6275 696c 645f 7472 6970 6c65 es 'build_triple │ │ │ │ │ +000198e0: 7427 2c20 2768 6f73 745f 7472 6970 6c65 t', 'host_triple │ │ │ │ │ +000198f0: 7427 2061 6e64 0a20 2020 2020 2774 6172 t' and. 'tar │ │ │ │ │ +00019900: 6765 745f 7472 6970 6c65 7427 2061 7265 get_triplet' are │ │ │ │ │ +00019910: 2069 6e74 726f 6475 6365 642e 2020 5365 introduced. Se │ │ │ │ │ +00019920: 6520 2a6e 6f74 6520 4765 7474 696e 6720 e *note Getting │ │ │ │ │ +00019930: 7468 6520 4361 6e6f 6e69 6361 6c0a 2020 the Canonical. │ │ │ │ │ +00019940: 2020 2053 7973 7465 6d20 5479 7065 3a20 System Type: │ │ │ │ │ +00019950: 2861 7574 6f63 6f6e 6629 4361 6e6f 6e69 (autoconf)Canoni │ │ │ │ │ +00019960: 6361 6c69 7a69 6e67 2e0a 0a27 4143 5f43 calizing...'AC_C │ │ │ │ │ +00019970: 4f4e 4649 475f 4155 585f 4449 5227 0a20 ONFIG_AUX_DIR'. │ │ │ │ │ +00019980: 2020 2020 4175 746f 6d61 6b65 2077 696c Automake wil │ │ │ │ │ +00019990: 6c20 6c6f 6f6b 2066 6f72 2076 6172 696f l look for vario │ │ │ │ │ +000199a0: 7573 2068 656c 7065 7220 7363 7269 7074 us helper script │ │ │ │ │ +000199b0: 732c 2073 7563 6820 6173 0a20 2020 2020 s, such as. │ │ │ │ │ +000199c0: 2769 6e73 7461 6c6c 2d73 6827 2c20 696e 'install-sh', in │ │ │ │ │ +000199d0: 2074 6865 2064 6972 6563 746f 7279 206e the directory n │ │ │ │ │ +000199e0: 616d 6564 2069 6e20 7468 6973 206d 6163 amed in this mac │ │ │ │ │ +000199f0: 726f 2069 6e76 6f63 6174 696f 6e2e 0a20 ro invocation.. │ │ │ │ │ +00019a00: 2020 2020 2854 6865 2066 756c 6c20 6c69 (The full li │ │ │ │ │ +00019a10: 7374 206f 6620 7363 7269 7074 7320 6973 st of scripts is │ │ │ │ │ +00019a20: 3a20 2761 722d 6c69 6227 2c20 2763 6f6e : 'ar-lib', 'con │ │ │ │ │ +00019a30: 6669 672e 6775 6573 7327 2c0a 2020 2020 fig.guess',. │ │ │ │ │ +00019a40: 2027 636f 6e66 6967 2e73 7562 272c 2027 'config.sub', ' │ │ │ │ │ +00019a50: 6465 7063 6f6d 7027 2c20 2765 6c69 7370 depcomp', 'elisp │ │ │ │ │ +00019a60: 2d63 6f6d 7027 2c20 2763 6f6d 7069 6c65 -comp', 'compile │ │ │ │ │ +00019a70: 272c 2027 696e 7374 616c 6c2d 7368 272c ', 'install-sh', │ │ │ │ │ +00019a80: 0a20 2020 2020 276c 746d 6169 6e2e 7368 . 'ltmain.sh │ │ │ │ │ +00019a90: 272c 2027 6d64 6174 652d 7368 272c 2027 ', 'mdate-sh', ' │ │ │ │ │ +00019aa0: 6d69 7373 696e 6727 2c20 276d 6b69 6e73 missing', 'mkins │ │ │ │ │ +00019ab0: 7461 6c6c 6469 7273 272c 2027 7079 2d63 talldirs', 'py-c │ │ │ │ │ +00019ac0: 6f6d 7069 6c65 272c 0a20 2020 2020 2774 ompile',. 't │ │ │ │ │ +00019ad0: 6578 696e 666f 2e74 6578 272c 2061 6e64 exinfo.tex', and │ │ │ │ │ +00019ae0: 2027 796c 7772 6170 272e 2920 204e 6f74 'ylwrap'.) Not │ │ │ │ │ +00019af0: 2061 6c6c 2073 6372 6970 7473 2061 7265 all scripts are │ │ │ │ │ +00019b00: 2061 6c77 6179 7320 7365 6172 6368 6564 always searched │ │ │ │ │ +00019b10: 0a20 2020 2020 666f 723b 2073 6f6d 6520 . for; some │ │ │ │ │ +00019b20: 7363 7269 7074 7320 7769 6c6c 206f 6e6c scripts will onl │ │ │ │ │ +00019b30: 7920 6265 2073 6f75 6768 7420 6966 2074 y be sought if t │ │ │ │ │ +00019b40: 6865 2067 656e 6572 6174 6564 0a20 2020 he generated. │ │ │ │ │ +00019b50: 2020 274d 616b 6566 696c 652e 696e 2720 'Makefile.in' │ │ │ │ │ +00019b60: 7265 7175 6972 6573 2074 6865 6d2e 0a0a requires them... │ │ │ │ │ +00019b70: 2020 2020 2049 6620 2741 435f 434f 4e46 If 'AC_CONF │ │ │ │ │ +00019b80: 4947 5f41 5558 5f44 4952 2720 6973 206e IG_AUX_DIR' is n │ │ │ │ │ +00019b90: 6f74 2067 6976 656e 2c20 7468 6520 7363 ot given, the sc │ │ │ │ │ +00019ba0: 7269 7074 7320 6172 6520 6c6f 6f6b 6564 ripts are looked │ │ │ │ │ +00019bb0: 2066 6f72 2069 6e0a 2020 2020 2074 6865 for in. the │ │ │ │ │ +00019bc0: 6972 2073 7461 6e64 6172 6420 6c6f 6361 ir standard loca │ │ │ │ │ +00019bd0: 7469 6f6e 732e 2020 466f 7220 276d 6461 tions. For 'mda │ │ │ │ │ +00019be0: 7465 2d73 6827 2c20 2774 6578 696e 666f te-sh', 'texinfo │ │ │ │ │ +00019bf0: 2e74 6578 272c 2061 6e64 0a20 2020 2020 .tex', and. │ │ │ │ │ +00019c00: 2779 6c77 7261 7027 2c20 7468 6520 7374 'ylwrap', the st │ │ │ │ │ +00019c10: 616e 6461 7264 206c 6f63 6174 696f 6e20 andard location │ │ │ │ │ +00019c20: 6973 2074 6865 2073 6f75 7263 6520 6469 is the source di │ │ │ │ │ +00019c30: 7265 6374 6f72 790a 2020 2020 2063 6f72 rectory. cor │ │ │ │ │ +00019c40: 7265 7370 6f6e 6469 6e67 2074 6f20 7468 responding to th │ │ │ │ │ +00019c50: 6520 6375 7272 656e 7420 274d 616b 6566 e current 'Makef │ │ │ │ │ +00019c60: 696c 652e 616d 272e 2020 466f 7220 7468 ile.am'. For th │ │ │ │ │ +00019c70: 6520 7265 7374 2c20 7468 650a 2020 2020 e rest, the. │ │ │ │ │ +00019c80: 2073 7461 6e64 6172 6420 6c6f 6361 7469 standard locati │ │ │ │ │ +00019c90: 6f6e 2069 7320 7468 6520 6669 7273 7420 on is the first │ │ │ │ │ +00019ca0: 6f6e 6520 6f66 2027 2e27 2c20 272e 2e27 one of '.', '..' │ │ │ │ │ +00019cb0: 2c20 6f72 2027 2e2e 2f2e 2e27 0a20 2020 , or '../..'. │ │ │ │ │ +00019cc0: 2020 2872 656c 6174 6976 6520 746f 2074 (relative to t │ │ │ │ │ +00019cd0: 6865 2074 6f70 2073 6f75 7263 6520 6469 he top source di │ │ │ │ │ +00019ce0: 7265 6374 6f72 7929 2074 6861 7420 7072 rectory) that pr │ │ │ │ │ +00019cf0: 6f76 6964 6573 2061 6e79 206f 6e65 206f ovides any one o │ │ │ │ │ +00019d00: 6620 7468 650a 2020 2020 2068 656c 7065 f the. helpe │ │ │ │ │ +00019d10: 7220 7363 7269 7074 732e 2020 2a4e 6f74 r scripts. *Not │ │ │ │ │ +00019d20: 6520 4669 6e64 696e 6720 2763 6f6e 6669 e Finding 'confi │ │ │ │ │ +00019d30: 6775 7265 2720 496e 7075 743a 2028 6175 gure' Input: (au │ │ │ │ │ +00019d40: 746f 636f 6e66 2949 6e70 7574 2e0a 0a20 toconf)Input... │ │ │ │ │ +00019d50: 2020 2020 5265 7175 6972 6564 2066 696c Required fil │ │ │ │ │ +00019d60: 6573 2066 726f 6d20 2741 435f 434f 4e46 es from 'AC_CONF │ │ │ │ │ +00019d70: 4947 5f41 5558 5f44 4952 2720 6172 6520 IG_AUX_DIR' are │ │ │ │ │ +00019d80: 6175 746f 6d61 7469 6361 6c6c 790a 2020 automatically. │ │ │ │ │ +00019d90: 2020 2064 6973 7472 6962 7574 6564 2c20 distributed, │ │ │ │ │ +00019da0: 6576 656e 2069 6620 7468 6572 6520 6973 even if there is │ │ │ │ │ +00019db0: 206e 6f20 274d 616b 6566 696c 652e 616d no 'Makefile.am │ │ │ │ │ +00019dc0: 2720 696e 2074 6869 7320 6469 7265 6374 ' in this direct │ │ │ │ │ +00019dd0: 6f72 792e 0a0a 2741 435f 434f 4e46 4947 ory...'AC_CONFIG │ │ │ │ │ +00019de0: 5f4c 4942 4f42 4a5f 4449 5227 0a20 2020 _LIBOBJ_DIR'. │ │ │ │ │ +00019df0: 2020 4175 746f 6d61 6b65 2077 696c 6c20 Automake will │ │ │ │ │ +00019e00: 7265 7175 6972 6520 7468 6520 736f 7572 require the sour │ │ │ │ │ +00019e10: 6365 7320 6669 6c65 2064 6563 6c61 7265 ces file declare │ │ │ │ │ +00019e20: 6420 7769 7468 2027 4143 5f4c 4942 534f d with 'AC_LIBSO │ │ │ │ │ +00019e30: 5552 4345 270a 2020 2020 2028 7365 6520 URCE'. (see │ │ │ │ │ +00019e40: 6265 6c6f 7729 2069 6e20 7468 6520 6469 below) in the di │ │ │ │ │ +00019e50: 7265 6374 6f72 7920 7370 6563 6966 6965 rectory specifie │ │ │ │ │ +00019e60: 6420 6279 2074 6869 7320 6d61 6372 6f2e d by this macro. │ │ │ │ │ +00019e70: 0a0a 2741 435f 434f 4e46 4947 5f48 4541 ..'AC_CONFIG_HEA │ │ │ │ │ +00019e80: 4445 5253 270a 2020 2020 2041 7574 6f6d DERS'. Autom │ │ │ │ │ +00019e90: 616b 6520 7769 6c6c 2067 656e 6572 6174 ake will generat │ │ │ │ │ +00019ea0: 6520 7275 6c65 7320 746f 2072 6562 7569 e rules to rebui │ │ │ │ │ +00019eb0: 6c64 2074 6865 7365 2068 6561 6465 7273 ld these headers │ │ │ │ │ +00019ec0: 2e20 204f 6c64 6572 0a20 2020 2020 7665 . Older. ve │ │ │ │ │ +00019ed0: 7273 696f 6e73 206f 6620 4175 746f 6d61 rsions of Automa │ │ │ │ │ +00019ee0: 6b65 2072 6571 7569 7265 6420 7468 6520 ke required the │ │ │ │ │ +00019ef0: 7573 6520 6f66 2027 414d 5f43 4f4e 4649 use of 'AM_CONFI │ │ │ │ │ +00019f00: 475f 4845 4144 4552 2720 282a 6e6f 7465 G_HEADER' (*note │ │ │ │ │ +00019f10: 0a20 2020 2020 4d61 6372 6f73 3a3a 293b . Macros::); │ │ │ │ │ +00019f20: 2074 6869 7320 6973 206e 6f20 6c6f 6e67 this is no long │ │ │ │ │ +00019f30: 6572 2074 6865 2063 6173 652e 0a0a 2020 er the case... │ │ │ │ │ +00019f40: 2020 2041 7320 7769 7468 2027 4143 5f43 As with 'AC_C │ │ │ │ │ +00019f50: 4f4e 4649 475f 4649 4c45 5327 2028 2a6e ONFIG_FILES' (*n │ │ │ │ │ +00019f60: 6f74 6520 5265 7175 6972 656d 656e 7473 ote Requirements │ │ │ │ │ +00019f70: 3a3a 292c 2070 6172 7473 206f 6620 7468 ::), parts of th │ │ │ │ │ +00019f80: 650a 2020 2020 2073 7065 6369 6669 6361 e. specifica │ │ │ │ │ +00019f90: 7469 6f6e 2075 7369 6e67 2073 6865 6c6c tion using shell │ │ │ │ │ +00019fa0: 2076 6172 6961 626c 6573 2077 696c 6c20 variables will │ │ │ │ │ +00019fb0: 6265 2069 676e 6f72 6564 2061 7320 6661 be ignored as fa │ │ │ │ │ +00019fc0: 7220 6173 0a20 2020 2020 636c 6561 6e69 r as. cleani │ │ │ │ │ +00019fd0: 6e67 2c20 6469 7374 7269 6275 7469 6e67 ng, distributing │ │ │ │ │ +00019fe0: 2c20 616e 6420 7265 6275 696c 6469 6e67 , and rebuilding │ │ │ │ │ +00019ff0: 2069 7320 636f 6e63 6572 6e65 642e 0a0a is concerned... │ │ │ │ │ +0001a000: 2741 435f 434f 4e46 4947 5f4c 494e 4b53 'AC_CONFIG_LINKS │ │ │ │ │ +0001a010: 270a 2020 2020 2041 7574 6f6d 616b 6520 '. Automake │ │ │ │ │ +0001a020: 7769 6c6c 2067 656e 6572 6174 6520 7275 will generate ru │ │ │ │ │ +0001a030: 6c65 7320 746f 2072 656d 6f76 6520 2763 les to remove 'c │ │ │ │ │ +0001a040: 6f6e 6669 6775 7265 2720 6765 6e65 7261 onfigure' genera │ │ │ │ │ +0001a050: 7465 6420 6c69 6e6b 730a 2020 2020 206f ted links. o │ │ │ │ │ +0001a060: 6e20 276d 616b 6520 6469 7374 636c 6561 n 'make distclea │ │ │ │ │ +0001a070: 6e27 2061 6e64 2074 6f20 6469 7374 7269 n' and to distri │ │ │ │ │ +0001a080: 6275 7465 206e 616d 6564 2073 6f75 7263 bute named sourc │ │ │ │ │ +0001a090: 6520 6669 6c65 7320 6173 2070 6172 7420 e files as part │ │ │ │ │ +0001a0a0: 6f66 0a20 2020 2020 276d 616b 6520 6469 of. 'make di │ │ │ │ │ +0001a0b0: 7374 272e 0a0a 2020 2020 2041 7320 666f st'... As fo │ │ │ │ │ +0001a0c0: 7220 2741 435f 434f 4e46 4947 5f46 494c r 'AC_CONFIG_FIL │ │ │ │ │ +0001a0d0: 4553 2720 282a 6e6f 7465 2052 6571 7569 ES' (*note Requi │ │ │ │ │ +0001a0e0: 7265 6d65 6e74 733a 3a29 2c20 7061 7274 rements::), part │ │ │ │ │ +0001a0f0: 7320 6f66 2074 6865 0a20 2020 2020 7370 s of the. sp │ │ │ │ │ +0001a100: 6563 6966 6963 6174 696f 6e20 7573 696e ecification usin │ │ │ │ │ +0001a110: 6720 7368 656c 6c20 7661 7269 6162 6c65 g shell variable │ │ │ │ │ +0001a120: 7320 7769 6c6c 2062 6520 6967 6e6f 7265 s will be ignore │ │ │ │ │ +0001a130: 6420 6173 2066 6172 2061 730a 2020 2020 d as far as. │ │ │ │ │ +0001a140: 2063 6c65 616e 696e 6720 616e 6420 6469 cleaning and di │ │ │ │ │ +0001a150: 7374 7269 6275 7469 6e67 2069 7320 636f stributing is co │ │ │ │ │ +0001a160: 6e63 6572 6e65 642e 2020 2854 6865 7265 ncerned. (There │ │ │ │ │ +0001a170: 2061 7265 206e 6f20 7265 6275 696c 640a are no rebuild. │ │ │ │ │ +0001a180: 2020 2020 2072 756c 6573 2066 6f72 206c rules for l │ │ │ │ │ +0001a190: 696e 6b73 2e29 0a0a 2741 435f 4c49 424f inks.)..'AC_LIBO │ │ │ │ │ +0001a1a0: 424a 270a 2741 435f 4c49 4253 4f55 5243 BJ'.'AC_LIBSOURC │ │ │ │ │ +0001a1b0: 4527 0a27 4143 5f4c 4942 534f 5552 4345 E'.'AC_LIBSOURCE │ │ │ │ │ +0001a1c0: 5327 0a20 2020 2020 4175 746f 6d61 6b65 S'. Automake │ │ │ │ │ +0001a1d0: 2077 696c 6c20 6175 746f 6d61 7469 6361 will automatica │ │ │ │ │ +0001a1e0: 6c6c 7920 6469 7374 7269 6275 7465 2061 lly distribute a │ │ │ │ │ +0001a1f0: 6e79 2066 696c 6520 6c69 7374 6564 2069 ny file listed i │ │ │ │ │ +0001a200: 6e0a 2020 2020 2027 4143 5f4c 4942 534f n. 'AC_LIBSO │ │ │ │ │ +0001a210: 5552 4345 2720 6f72 2027 4143 5f4c 4942 URCE' or 'AC_LIB │ │ │ │ │ +0001a220: 534f 5552 4345 5327 2e0a 0a20 2020 2020 SOURCES'... │ │ │ │ │ +0001a230: 4e6f 7465 2074 6861 7420 7468 6520 2741 Note that the 'A │ │ │ │ │ +0001a240: 435f 4c49 424f 424a 2720 6d61 6372 6f20 C_LIBOBJ' macro │ │ │ │ │ +0001a250: 6361 6c6c 7320 2741 435f 4c49 4253 4f55 calls 'AC_LIBSOU │ │ │ │ │ +0001a260: 5243 4527 2e20 2053 6f20 6966 2061 6e0a RCE'. So if an. │ │ │ │ │ +0001a270: 2020 2020 2041 7574 6f63 6f6e 6620 6d61 Autoconf ma │ │ │ │ │ +0001a280: 6372 6f20 6973 2064 6f63 756d 656e 7465 cro is documente │ │ │ │ │ +0001a290: 6420 746f 2063 616c 6c20 2741 435f 4c49 d to call 'AC_LI │ │ │ │ │ +0001a2a0: 424f 424a 285b 6669 6c65 5d29 272c 2074 BOBJ([file])', t │ │ │ │ │ +0001a2b0: 6865 6e0a 2020 2020 2027 6669 6c65 2e63 hen. 'file.c │ │ │ │ │ +0001a2c0: 2720 7769 6c6c 2062 6520 6469 7374 7269 ' will be distri │ │ │ │ │ +0001a2d0: 6275 7465 6420 6175 746f 6d61 7469 6361 buted automatica │ │ │ │ │ +0001a2e0: 6c6c 7920 6279 2041 7574 6f6d 616b 652e lly by Automake. │ │ │ │ │ +0001a2f0: 2020 5468 6973 0a20 2020 2020 656e 636f This. enco │ │ │ │ │ +0001a300: 6d70 6173 7365 7320 6d61 6e79 206d 6163 mpasses many mac │ │ │ │ │ +0001a310: 726f 7320 6c69 6b65 2027 4143 5f46 554e ros like 'AC_FUN │ │ │ │ │ +0001a320: 435f 414c 4c4f 4341 272c 2027 4143 5f46 C_ALLOCA', 'AC_F │ │ │ │ │ +0001a330: 554e 435f 4d45 4d43 4d50 272c 0a20 2020 UNC_MEMCMP',. │ │ │ │ │ +0001a340: 2020 2741 435f 5245 504c 4143 455f 4655 'AC_REPLACE_FU │ │ │ │ │ +0001a350: 4e43 5327 2c20 616e 6420 6f74 6865 7273 NCS', and others │ │ │ │ │ +0001a360: 2e0a 0a20 2020 2020 4279 2074 6865 2077 ... By the w │ │ │ │ │ +0001a370: 6179 2c20 6469 7265 6374 2061 7373 6967 ay, direct assig │ │ │ │ │ +0001a380: 6e6d 656e 7473 2074 6f20 274c 4942 4f42 nments to 'LIBOB │ │ │ │ │ +0001a390: 4a53 2720 6172 6520 6e6f 206c 6f6e 6765 JS' are no longe │ │ │ │ │ +0001a3a0: 720a 2020 2020 2073 7570 706f 7274 6564 r. supported │ │ │ │ │ +0001a3b0: 2e20 2059 6f75 2073 686f 756c 6420 616c . You should al │ │ │ │ │ +0001a3c0: 7761 7973 2075 7365 2027 4143 5f4c 4942 ways use 'AC_LIB │ │ │ │ │ +0001a3d0: 4f42 4a27 2066 6f72 2074 6869 7320 7075 OBJ' for this pu │ │ │ │ │ +0001a3e0: 7270 6f73 652e 0a20 2020 2020 2a4e 6f74 rpose.. *Not │ │ │ │ │ +0001a3f0: 6520 2741 435f 4c49 424f 424a 2720 7673 e 'AC_LIBOBJ' vs │ │ │ │ │ +0001a400: 2e20 274c 4942 4f42 4a53 273a 2028 6175 . 'LIBOBJS': (au │ │ │ │ │ +0001a410: 746f 636f 6e66 2941 435f 4c49 424f 424a toconf)AC_LIBOBJ │ │ │ │ │ +0001a420: 2076 7320 4c49 424f 424a 532e 0a0a 2741 vs LIBOBJS...'A │ │ │ │ │ +0001a430: 435f 5052 4f47 5f52 414e 4c49 4227 0a20 C_PROG_RANLIB'. │ │ │ │ │ +0001a440: 2020 2020 5468 6973 2069 7320 7265 7175 This is requ │ │ │ │ │ +0001a450: 6972 6564 2069 6620 616e 7920 6c69 6272 ired if any libr │ │ │ │ │ +0001a460: 6172 6965 7320 6172 6520 6275 696c 7420 aries are built │ │ │ │ │ +0001a470: 696e 2074 6865 2070 6163 6b61 6765 2e20 in the package. │ │ │ │ │ +0001a480: 202a 4e6f 7465 0a20 2020 2020 5061 7274 *Note. Part │ │ │ │ │ +0001a490: 6963 756c 6172 2050 726f 6772 616d 2043 icular Program C │ │ │ │ │ +0001a4a0: 6865 636b 733a 2028 6175 746f 636f 6e66 hecks: (autoconf │ │ │ │ │ +0001a4b0: 2950 6172 7469 6375 6c61 7220 5072 6f67 )Particular Prog │ │ │ │ │ +0001a4c0: 7261 6d73 2e0a 0a27 4143 5f50 524f 475f rams...'AC_PROG_ │ │ │ │ │ +0001a4d0: 4358 5827 0a20 2020 2020 5468 6973 2069 CXX'. This i │ │ │ │ │ +0001a4e0: 7320 7265 7175 6972 6564 2069 6620 616e s required if an │ │ │ │ │ +0001a4f0: 7920 432b 2b20 736f 7572 6365 2069 7320 y C++ source is │ │ │ │ │ +0001a500: 696e 636c 7564 6564 2e20 202a 4e6f 7465 included. *Note │ │ │ │ │ +0001a510: 2050 6172 7469 6375 6c61 720a 2020 2020 Particular. │ │ │ │ │ +0001a520: 2050 726f 6772 616d 2043 6865 636b 733a Program Checks: │ │ │ │ │ +0001a530: 2028 6175 746f 636f 6e66 2950 6172 7469 (autoconf)Parti │ │ │ │ │ +0001a540: 6375 6c61 7220 5072 6f67 7261 6d73 2e0a cular Programs.. │ │ │ │ │ +0001a550: 0a27 4143 5f50 524f 475f 4f42 4a43 270a .'AC_PROG_OBJC'. │ │ │ │ │ +0001a560: 2020 2020 2054 6869 7320 6973 2072 6571 This is req │ │ │ │ │ +0001a570: 7569 7265 6420 6966 2061 6e79 204f 626a uired if any Obj │ │ │ │ │ +0001a580: 6563 7469 7665 2043 2073 6f75 7263 6520 ective C source │ │ │ │ │ +0001a590: 6973 2069 6e63 6c75 6465 642e 2020 2a4e is included. *N │ │ │ │ │ +0001a5a0: 6f74 650a 2020 2020 2050 6172 7469 6375 ote. Particu │ │ │ │ │ +0001a5b0: 6c61 7220 5072 6f67 7261 6d20 4368 6563 lar Program Chec │ │ │ │ │ +0001a5c0: 6b73 3a20 2861 7574 6f63 6f6e 6629 5061 ks: (autoconf)Pa │ │ │ │ │ +0001a5d0: 7274 6963 756c 6172 2050 726f 6772 616d rticular Program │ │ │ │ │ +0001a5e0: 732e 0a0a 2741 435f 5052 4f47 5f46 3737 s...'AC_PROG_F77 │ │ │ │ │ +0001a5f0: 270a 2020 2020 2054 6869 7320 6973 2072 '. This is r │ │ │ │ │ +0001a600: 6571 7569 7265 6420 6966 2061 6e79 2046 equired if any F │ │ │ │ │ +0001a610: 6f72 7472 616e 2037 3720 736f 7572 6365 ortran 77 source │ │ │ │ │ +0001a620: 2069 7320 696e 636c 7564 6564 2e20 2054 is included. T │ │ │ │ │ +0001a630: 6869 7320 6d61 6372 6f0a 2020 2020 2069 his macro. i │ │ │ │ │ +0001a640: 7320 6469 7374 7269 6275 7465 6420 7769 s distributed wi │ │ │ │ │ +0001a650: 7468 2041 7574 6f63 6f6e 6620 7665 7273 th Autoconf vers │ │ │ │ │ +0001a660: 696f 6e20 322e 3133 2061 6e64 206c 6174 ion 2.13 and lat │ │ │ │ │ +0001a670: 6572 2e20 202a 4e6f 7465 0a20 2020 2020 er. *Note. │ │ │ │ │ +0001a680: 5061 7274 6963 756c 6172 2050 726f 6772 Particular Progr │ │ │ │ │ +0001a690: 616d 2043 6865 636b 733a 2028 6175 746f am Checks: (auto │ │ │ │ │ +0001a6a0: 636f 6e66 2950 6172 7469 6375 6c61 7220 conf)Particular │ │ │ │ │ +0001a6b0: 5072 6f67 7261 6d73 2e0a 0a27 4143 5f46 Programs...'AC_F │ │ │ │ │ +0001a6c0: 3737 5f4c 4942 5241 5259 5f4c 4446 4c41 77_LIBRARY_LDFLA │ │ │ │ │ +0001a6d0: 4753 270a 2020 2020 2054 6869 7320 6973 GS'. This is │ │ │ │ │ +0001a6e0: 2072 6571 7569 7265 6420 666f 7220 7072 required for pr │ │ │ │ │ +0001a6f0: 6f67 7261 6d73 2061 6e64 2073 6861 7265 ograms and share │ │ │ │ │ +0001a700: 6420 6c69 6272 6172 6965 7320 7468 6174 d libraries that │ │ │ │ │ +0001a710: 2061 7265 2061 0a20 2020 2020 6d69 7874 are a. mixt │ │ │ │ │ +0001a720: 7572 6520 6f66 206c 616e 6775 6167 6573 ure of languages │ │ │ │ │ +0001a730: 2074 6861 7420 696e 636c 7564 6520 466f that include Fo │ │ │ │ │ +0001a740: 7274 7261 6e20 3737 2028 2a6e 6f74 6520 rtran 77 (*note │ │ │ │ │ +0001a750: 4d69 7869 6e67 2046 6f72 7472 616e 0a20 Mixing Fortran. │ │ │ │ │ +0001a760: 2020 2020 3737 2057 6974 6820 4320 616e 77 With C an │ │ │ │ │ +0001a770: 6420 432b 2b3a 3a29 2e20 202a 4e6f 7465 d C++::). *Note │ │ │ │ │ +0001a780: 2041 7574 6f63 6f6e 6620 6d61 6372 6f73 Autoconf macros │ │ │ │ │ +0001a790: 2073 7570 706c 6965 6420 7769 7468 0a20 supplied with. │ │ │ │ │ +0001a7a0: 2020 2020 4175 746f 6d61 6b65 3a20 4d61 Automake: Ma │ │ │ │ │ +0001a7b0: 6372 6f73 2e0a 0a27 4143 5f46 435f 5352 cros...'AC_FC_SR │ │ │ │ │ +0001a7c0: 4345 5854 270a 2020 2020 2041 7574 6f6d CEXT'. Autom │ │ │ │ │ +0001a7d0: 616b 6520 7769 6c6c 2061 6464 2074 6865 ake will add the │ │ │ │ │ +0001a7e0: 2066 6c61 6773 2063 6f6d 7075 7465 6420 flags computed │ │ │ │ │ +0001a7f0: 6279 2027 4143 5f46 435f 5352 4345 5854 by 'AC_FC_SRCEXT │ │ │ │ │ +0001a800: 2720 746f 0a20 2020 2020 636f 6d70 696c ' to. compil │ │ │ │ │ +0001a810: 6174 696f 6e20 6f66 2066 696c 6573 2077 ation of files w │ │ │ │ │ +0001a820: 6974 6820 7468 6520 7265 7370 6563 7469 ith the respecti │ │ │ │ │ +0001a830: 7665 2073 6f75 7263 6520 6578 7465 6e73 ve source extens │ │ │ │ │ +0001a840: 696f 6e20 282a 6e6f 7465 0a20 2020 2020 ion (*note. │ │ │ │ │ +0001a850: 466f 7274 7261 6e20 436f 6d70 696c 6572 Fortran Compiler │ │ │ │ │ +0001a860: 2043 6861 7261 6374 6572 6973 7469 6373 Characteristics │ │ │ │ │ +0001a870: 3a20 2861 7574 6f63 6f6e 6629 466f 7274 : (autoconf)Fort │ │ │ │ │ +0001a880: 7261 6e20 436f 6d70 696c 6572 2e29 2e0a ran Compiler.).. │ │ │ │ │ +0001a890: 0a27 4143 5f50 524f 475f 4643 270a 2020 .'AC_PROG_FC'. │ │ │ │ │ +0001a8a0: 2020 2054 6869 7320 6973 2072 6571 7569 This is requi │ │ │ │ │ +0001a8b0: 7265 6420 6966 2061 6e79 2046 6f72 7472 red if any Fortr │ │ │ │ │ +0001a8c0: 616e 2039 302f 3935 2073 6f75 7263 6520 an 90/95 source │ │ │ │ │ +0001a8d0: 6973 2069 6e63 6c75 6465 642e 2020 5468 is included. Th │ │ │ │ │ +0001a8e0: 6973 0a20 2020 2020 6d61 6372 6f20 6973 is. macro is │ │ │ │ │ +0001a8f0: 2064 6973 7472 6962 7574 6564 2077 6974 distributed wit │ │ │ │ │ +0001a900: 6820 4175 746f 636f 6e66 2076 6572 7369 h Autoconf versi │ │ │ │ │ +0001a910: 6f6e 2032 2e35 3820 616e 6420 6c61 7465 on 2.58 and late │ │ │ │ │ +0001a920: 722e 2020 2a4e 6f74 650a 2020 2020 2050 r. *Note. P │ │ │ │ │ +0001a930: 6172 7469 6375 6c61 7220 5072 6f67 7261 articular Progra │ │ │ │ │ +0001a940: 6d20 4368 6563 6b73 3a20 2861 7574 6f63 m Checks: (autoc │ │ │ │ │ +0001a950: 6f6e 6629 5061 7274 6963 756c 6172 2050 onf)Particular P │ │ │ │ │ +0001a960: 726f 6772 616d 732e 0a0a 2741 435f 5052 rograms...'AC_PR │ │ │ │ │ +0001a970: 4f47 5f4c 4942 544f 4f4c 270a 2020 2020 OG_LIBTOOL'. │ │ │ │ │ +0001a980: 2041 7574 6f6d 616b 6520 7769 6c6c 2074 Automake will t │ │ │ │ │ +0001a990: 7572 6e20 6f6e 2070 726f 6365 7373 696e urn on processin │ │ │ │ │ +0001a9a0: 6720 666f 7220 276c 6962 746f 6f6c 2720 g for 'libtool' │ │ │ │ │ +0001a9b0: 282a 6e6f 7465 2049 6e74 726f 6475 6374 (*note Introduct │ │ │ │ │ +0001a9c0: 696f 6e3a 0a20 2020 2020 286c 6962 746f ion:. (libto │ │ │ │ │ +0001a9d0: 6f6c 2954 6f70 2e29 2e0a 0a27 4143 5f50 ol)Top.)...'AC_P │ │ │ │ │ +0001a9e0: 524f 475f 5941 4343 270a 2020 2020 2049 ROG_YACC'. I │ │ │ │ │ +0001a9f0: 6620 6120 5961 6363 2073 6f75 7263 6520 f a Yacc source │ │ │ │ │ +0001aa00: 6669 6c65 2069 7320 7365 656e 2c20 7468 file is seen, th │ │ │ │ │ +0001aa10: 656e 2079 6f75 206d 7573 7420 6569 7468 en you must eith │ │ │ │ │ +0001aa20: 6572 2075 7365 2074 6869 7320 6d61 6372 er use this macr │ │ │ │ │ +0001aa30: 6f0a 2020 2020 206f 7220 6465 6669 6e65 o. or define │ │ │ │ │ +0001aa40: 2074 6865 2076 6172 6961 626c 6520 2759 the variable 'Y │ │ │ │ │ +0001aa50: 4143 4327 2069 6e20 2763 6f6e 6669 6775 ACC' in 'configu │ │ │ │ │ +0001aa60: 7265 2e61 6327 2e20 2054 6865 2066 6f72 re.ac'. The for │ │ │ │ │ +0001aa70: 6d65 7220 6973 0a20 2020 2020 7072 6566 mer is. pref │ │ │ │ │ +0001aa80: 6572 7265 6420 282a 6e6f 7465 2050 6172 erred (*note Par │ │ │ │ │ +0001aa90: 7469 6375 6c61 7220 5072 6f67 7261 6d20 ticular Program │ │ │ │ │ +0001aaa0: 4368 6563 6b73 3a20 2861 7574 6f63 6f6e Checks: (autocon │ │ │ │ │ +0001aab0: 6629 5061 7274 6963 756c 6172 0a20 2020 f)Particular. │ │ │ │ │ +0001aac0: 2020 5072 6f67 7261 6d73 2e29 2e0a 0a27 Programs.)...' │ │ │ │ │ +0001aad0: 4143 5f50 524f 475f 4c45 5827 0a20 2020 AC_PROG_LEX'. │ │ │ │ │ +0001aae0: 2020 4966 2061 204c 6578 2073 6f75 7263 If a Lex sourc │ │ │ │ │ +0001aaf0: 6520 6669 6c65 2069 7320 7365 656e 2c20 e file is seen, │ │ │ │ │ +0001ab00: 7468 656e 2074 6869 7320 6d61 6372 6f20 then this macro │ │ │ │ │ +0001ab10: 6d75 7374 2062 6520 7573 6564 2e20 202a must be used. * │ │ │ │ │ +0001ab20: 4e6f 7465 0a20 2020 2020 5061 7274 6963 Note. Partic │ │ │ │ │ +0001ab30: 756c 6172 2050 726f 6772 616d 2043 6865 ular Program Che │ │ │ │ │ +0001ab40: 636b 733a 2028 6175 746f 636f 6e66 2950 cks: (autoconf)P │ │ │ │ │ +0001ab50: 6172 7469 6375 6c61 7220 5072 6f67 7261 articular Progra │ │ │ │ │ +0001ab60: 6d73 2e0a 0a27 4143 5f52 4551 5549 5245 ms...'AC_REQUIRE │ │ │ │ │ +0001ab70: 5f41 5558 5f46 494c 4527 0a20 2020 2020 _AUX_FILE'. │ │ │ │ │ +0001ab80: 466f 7220 6561 6368 2027 4143 5f52 4551 For each 'AC_REQ │ │ │ │ │ +0001ab90: 5549 5245 5f41 5558 5f46 494c 4528 5b46 UIRE_AUX_FILE([F │ │ │ │ │ +0001aba0: 494c 455d 2927 2c20 2761 7574 6f6d 616b ILE])', 'automak │ │ │ │ │ +0001abb0: 6527 2077 696c 6c20 656e 7375 7265 2074 e' will ensure t │ │ │ │ │ +0001abc0: 6861 740a 2020 2020 2027 4649 4c45 2720 hat. 'FILE' │ │ │ │ │ +0001abd0: 6578 6973 7473 2069 6e20 7468 6520 6175 exists in the au │ │ │ │ │ +0001abe0: 7820 6469 7265 6374 6f72 792c 2061 6e64 x directory, and │ │ │ │ │ +0001abf0: 2077 696c 6c20 636f 6d70 6c61 696e 206f will complain o │ │ │ │ │ +0001ac00: 7468 6572 7769 7365 2e0a 2020 2020 2049 therwise.. I │ │ │ │ │ +0001ac10: 7420 7769 6c6c 2061 6c73 6f20 6175 746f t will also auto │ │ │ │ │ +0001ac20: 6d61 7469 6361 6c6c 7920 6469 7374 7269 matically distri │ │ │ │ │ +0001ac30: 6275 7465 2074 6865 2066 696c 652e 2020 bute the file. │ │ │ │ │ +0001ac40: 5468 6973 206d 6163 726f 2073 686f 756c This macro shoul │ │ │ │ │ +0001ac50: 640a 2020 2020 2062 6520 7573 6564 2062 d. be used b │ │ │ │ │ +0001ac60: 7920 7468 6972 642d 7061 7274 7920 4175 y third-party Au │ │ │ │ │ +0001ac70: 746f 636f 6e66 206d 6163 726f 7320 7468 toconf macros th │ │ │ │ │ +0001ac80: 6174 2072 6571 7569 7265 2073 6f6d 6520 at require some │ │ │ │ │ +0001ac90: 7375 7070 6f72 7469 6e67 0a20 2020 2020 supporting. │ │ │ │ │ +0001aca0: 6669 6c65 7320 696e 2074 6865 2061 7578 files in the aux │ │ │ │ │ +0001acb0: 2064 6972 6563 746f 7279 2073 7065 6369 directory speci │ │ │ │ │ +0001acc0: 6669 6564 2077 6974 6820 2741 435f 434f fied with 'AC_CO │ │ │ │ │ +0001acd0: 4e46 4947 5f41 5558 5f44 4952 270a 2020 NFIG_AUX_DIR'. │ │ │ │ │ +0001ace0: 2020 2061 626f 7665 2e20 202a 4e6f 7465 above. *Note │ │ │ │ │ +0001acf0: 2046 696e 6469 6e67 2027 636f 6e66 6967 Finding 'config │ │ │ │ │ +0001ad00: 7572 6527 2049 6e70 7574 3a20 2861 7574 ure' Input: (aut │ │ │ │ │ +0001ad10: 6f63 6f6e 6629 496e 7075 742e 0a0a 2741 oconf)Input...'A │ │ │ │ │ +0001ad20: 435f 5355 4253 5427 0a20 2020 2020 5468 C_SUBST'. Th │ │ │ │ │ +0001ad30: 6520 6669 7273 7420 6172 6775 6d65 6e74 e first argument │ │ │ │ │ +0001ad40: 2069 7320 6175 746f 6d61 7469 6361 6c6c is automaticall │ │ │ │ │ +0001ad50: 7920 6465 6669 6e65 6420 6173 2061 2076 y defined as a v │ │ │ │ │ +0001ad60: 6172 6961 626c 6520 696e 2065 6163 680a ariable in each. │ │ │ │ │ +0001ad70: 2020 2020 2067 656e 6572 6174 6564 2027 generated ' │ │ │ │ │ +0001ad80: 4d61 6b65 6669 6c65 2e69 6e27 2c20 756e Makefile.in', un │ │ │ │ │ +0001ad90: 6c65 7373 2027 414d 5f53 5542 5354 5f4e less 'AM_SUBST_N │ │ │ │ │ +0001ada0: 4f54 4d41 4b45 2720 6973 2061 6c73 6f20 OTMAKE' is also │ │ │ │ │ +0001adb0: 7573 6564 2066 6f72 0a20 2020 2020 7468 used for. th │ │ │ │ │ +0001adc0: 6973 2076 6172 6961 626c 652e 2020 2a4e is variable. *N │ │ │ │ │ +0001add0: 6f74 6520 5365 7474 696e 6720 4f75 7470 ote Setting Outp │ │ │ │ │ +0001ade0: 7574 2056 6172 6961 626c 6573 3a20 2861 ut Variables: (a │ │ │ │ │ +0001adf0: 7574 6f63 6f6e 6629 5365 7474 696e 670a utoconf)Setting. │ │ │ │ │ +0001ae00: 2020 2020 204f 7574 7075 7420 5661 7269 Output Vari │ │ │ │ │ +0001ae10: 6162 6c65 732e 0a0a 2020 2020 2046 6f72 ables... For │ │ │ │ │ +0001ae20: 2065 7665 7279 2073 7562 7374 6974 7574 every substitut │ │ │ │ │ +0001ae30: 6564 2076 6172 6961 626c 6520 5641 522c ed variable VAR, │ │ │ │ │ +0001ae40: 2027 6175 746f 6d61 6b65 2720 7769 6c6c 'automake' will │ │ │ │ │ +0001ae50: 2061 6464 2061 206c 696e 6520 2756 4152 add a line 'VAR │ │ │ │ │ +0001ae60: 0a20 2020 2020 3d20 5641 4c55 4527 2074 . = VALUE' t │ │ │ │ │ +0001ae70: 6f20 6561 6368 2027 4d61 6b65 6669 6c65 o each 'Makefile │ │ │ │ │ +0001ae80: 2e69 6e27 2066 696c 652e 2020 4d61 6e79 .in' file. Many │ │ │ │ │ +0001ae90: 2041 7574 6f63 6f6e 6620 6d61 6372 6f73 Autoconf macros │ │ │ │ │ +0001aea0: 2069 6e76 6f6b 650a 2020 2020 2027 4143 invoke. 'AC │ │ │ │ │ +0001aeb0: 5f53 5542 5354 2720 746f 2073 6574 206f _SUBST' to set o │ │ │ │ │ +0001aec0: 7574 7075 7420 7661 7269 6162 6c65 7320 utput variables │ │ │ │ │ +0001aed0: 7468 6973 2077 6179 2c20 652e 672e 2c20 this way, e.g., │ │ │ │ │ +0001aee0: 2741 435f 5041 5448 5f58 5452 4127 0a20 'AC_PATH_XTRA'. │ │ │ │ │ +0001aef0: 2020 2020 6465 6669 6e65 7320 2758 5f43 defines 'X_C │ │ │ │ │ +0001af00: 464c 4147 5327 2061 6e64 2027 585f 4c49 FLAGS' and 'X_LI │ │ │ │ │ +0001af10: 4253 272e 2020 5468 7573 2c20 796f 7520 BS'. Thus, you │ │ │ │ │ +0001af20: 6361 6e20 6163 6365 7373 2074 6865 7365 can access these │ │ │ │ │ +0001af30: 0a20 2020 2020 7661 7269 6162 6c65 7320 . variables │ │ │ │ │ +0001af40: 6173 2027 2428 585f 4346 4c41 4753 2927 as '$(X_CFLAGS)' │ │ │ │ │ +0001af50: 2061 6e64 2027 2428 585f 4c49 4253 2927 and '$(X_LIBS)' │ │ │ │ │ +0001af60: 2069 6e20 616e 7920 274d 616b 6566 696c in any 'Makefil │ │ │ │ │ +0001af70: 652e 616d 2720 6966 0a20 2020 2020 2741 e.am' if. 'A │ │ │ │ │ +0001af80: 435f 5041 5448 5f58 5452 4127 2069 7320 C_PATH_XTRA' is │ │ │ │ │ +0001af90: 6361 6c6c 6564 2e0a 0a27 414d 5f43 5f50 called...'AM_C_P │ │ │ │ │ +0001afa0: 524f 544f 5459 5045 5327 0a20 2020 2020 ROTOTYPES'. │ │ │ │ │ +0001afb0: 5468 6973 2069 7320 7265 7175 6972 6564 This is required │ │ │ │ │ +0001afc0: 2077 6865 6e20 7573 696e 6720 7468 6520 when using the │ │ │ │ │ +0001afd0: 6465 7072 6563 6174 6564 2064 652d 414e deprecated de-AN │ │ │ │ │ +0001afe0: 5349 2d66 6963 6174 696f 6e0a 2020 2020 SI-fication. │ │ │ │ │ +0001aff0: 2066 6561 7475 7265 3b20 2a6e 6f74 6520 feature; *note │ │ │ │ │ +0001b000: 414e 5349 3a3a 2e20 205f 4974 2077 696c ANSI::. _It wil │ │ │ │ │ +0001b010: 6c20 6265 2072 656d 6f76 6564 5f20 696e l be removed_ in │ │ │ │ │ +0001b020: 2074 6865 206e 6578 7420 6d61 6a6f 720a the next major. │ │ │ │ │ +0001b030: 2020 2020 2041 7574 6f6d 616b 6520 7265 Automake re │ │ │ │ │ +0001b040: 6c65 6173 652e 0a0a 2741 4d5f 434f 4e44 lease...'AM_COND │ │ │ │ │ +0001b050: 4954 494f 4e41 4c27 0a20 2020 2020 5468 ITIONAL'. Th │ │ │ │ │ +0001b060: 6973 2069 6e74 726f 6475 6365 7320 616e is introduces an │ │ │ │ │ +0001b070: 2041 7574 6f6d 616b 6520 636f 6e64 6974 Automake condit │ │ │ │ │ +0001b080: 696f 6e61 6c20 282a 6e6f 7465 2043 6f6e ional (*note Con │ │ │ │ │ +0001b090: 6469 7469 6f6e 616c 733a 3a29 2e0a 0a27 ditionals::)...' │ │ │ │ │ +0001b0a0: 414d 5f43 4f4e 445f 4946 270a 2020 2020 AM_COND_IF'. │ │ │ │ │ +0001b0b0: 2054 6869 7320 6d61 6372 6f20 616c 6c6f This macro allo │ │ │ │ │ +0001b0c0: 7773 2027 6175 746f 6d61 6b65 2720 746f ws 'automake' to │ │ │ │ │ +0001b0d0: 2064 6574 6563 7420 7375 6273 6571 7565 detect subseque │ │ │ │ │ +0001b0e0: 6e74 2061 6363 6573 7320 7769 7468 696e nt access within │ │ │ │ │ +0001b0f0: 0a20 2020 2020 2763 6f6e 6669 6775 7265 . 'configure │ │ │ │ │ +0001b100: 2e61 6327 2074 6f20 6120 636f 6e64 6974 .ac' to a condit │ │ │ │ │ +0001b110: 696f 6e61 6c20 7072 6576 696f 7573 6c79 ional previously │ │ │ │ │ +0001b120: 2069 6e74 726f 6475 6365 6420 7769 7468 introduced with │ │ │ │ │ +0001b130: 0a20 2020 2020 2741 4d5f 434f 4e44 4954 . 'AM_CONDIT │ │ │ │ │ +0001b140: 494f 4e41 4c27 2c20 7468 7573 2065 6e61 IONAL', thus ena │ │ │ │ │ +0001b150: 626c 696e 6720 636f 6e64 6974 696f 6e61 bling conditiona │ │ │ │ │ +0001b160: 6c20 2741 435f 434f 4e46 4947 5f46 494c l 'AC_CONFIG_FIL │ │ │ │ │ +0001b170: 4553 270a 2020 2020 2028 2a6e 6f74 6520 ES'. (*note │ │ │ │ │ +0001b180: 5573 6167 6520 6f66 2043 6f6e 6469 7469 Usage of Conditi │ │ │ │ │ +0001b190: 6f6e 616c 733a 3a29 2e0a 0a27 414d 5f47 onals::)...'AM_G │ │ │ │ │ +0001b1a0: 4e55 5f47 4554 5445 5854 270a 2020 2020 NU_GETTEXT'. │ │ │ │ │ +0001b1b0: 2054 6869 7320 6d61 6372 6f20 6973 2072 This macro is r │ │ │ │ │ +0001b1c0: 6571 7569 7265 6420 666f 7220 7061 636b equired for pack │ │ │ │ │ +0001b1d0: 6167 6573 2074 6861 7420 7573 6520 474e ages that use GN │ │ │ │ │ +0001b1e0: 5520 6765 7474 6578 7420 282a 6e6f 7465 U gettext (*note │ │ │ │ │ +0001b1f0: 0a20 2020 2020 6765 7474 6578 743a 3a29 . gettext::) │ │ │ │ │ +0001b200: 2e20 2049 7420 6973 2064 6973 7472 6962 . It is distrib │ │ │ │ │ +0001b210: 7574 6564 2077 6974 6820 6765 7474 6578 uted with gettex │ │ │ │ │ +0001b220: 742e 2020 4966 2041 7574 6f6d 616b 6520 t. If Automake │ │ │ │ │ +0001b230: 7365 6573 2074 6869 730a 2020 2020 206d sees this. m │ │ │ │ │ +0001b240: 6163 726f 2069 7420 656e 7375 7265 7320 acro it ensures │ │ │ │ │ +0001b250: 7468 6174 2074 6865 2070 6163 6b61 6765 that the package │ │ │ │ │ +0001b260: 206d 6565 7473 2073 6f6d 6520 6f66 2067 meets some of g │ │ │ │ │ +0001b270: 6574 7465 7874 2773 0a20 2020 2020 7265 ettext's. re │ │ │ │ │ +0001b280: 7175 6972 656d 656e 7473 2e0a 0a27 414d quirements...'AM │ │ │ │ │ +0001b290: 5f47 4e55 5f47 4554 5445 5854 5f49 4e54 _GNU_GETTEXT_INT │ │ │ │ │ +0001b2a0: 4c5f 5355 4244 4952 270a 2020 2020 2054 L_SUBDIR'. T │ │ │ │ │ +0001b2b0: 6869 7320 6d61 6372 6f20 7370 6563 6966 his macro specif │ │ │ │ │ +0001b2c0: 6965 7320 7468 6174 2074 6865 2027 696e ies that the 'in │ │ │ │ │ +0001b2d0: 746c 2f27 2073 7562 6469 7265 6374 6f72 tl/' subdirector │ │ │ │ │ +0001b2e0: 7920 6973 2074 6f20 6265 2062 7569 6c74 y is to be built │ │ │ │ │ +0001b2f0: 2c0a 2020 2020 2065 7665 6e20 6966 2074 ,. even if t │ │ │ │ │ +0001b300: 6865 2027 414d 5f47 4e55 5f47 4554 5445 he 'AM_GNU_GETTE │ │ │ │ │ +0001b310: 5854 2720 6d61 6372 6f20 7761 7320 696e XT' macro was in │ │ │ │ │ +0001b320: 766f 6b65 6420 7769 7468 2061 2066 6972 voked with a fir │ │ │ │ │ +0001b330: 7374 0a20 2020 2020 6172 6775 6d65 6e74 st. argument │ │ │ │ │ +0001b340: 206f 6620 2765 7874 6572 6e61 6c27 2e0a of 'external'.. │ │ │ │ │ +0001b350: 0a27 414d 5f4d 4149 4e54 4149 4e45 525f .'AM_MAINTAINER_ │ │ │ │ │ +0001b360: 4d4f 4445 285b 4445 4641 554c 542d 4d4f MODE([DEFAULT-MO │ │ │ │ │ +0001b370: 4445 5d29 270a 2020 2020 2054 6869 7320 DE])'. This │ │ │ │ │ +0001b380: 6d61 6372 6f20 6164 6473 2061 6e20 272d macro adds an '- │ │ │ │ │ +0001b390: 2d65 6e61 626c 652d 6d61 696e 7461 696e -enable-maintain │ │ │ │ │ +0001b3a0: 6572 2d6d 6f64 6527 206f 7074 696f 6e20 er-mode' option │ │ │ │ │ +0001b3b0: 746f 0a20 2020 2020 2763 6f6e 6669 6775 to. 'configu │ │ │ │ │ +0001b3c0: 7265 272e 2020 4966 2074 6869 7320 6973 re'. If this is │ │ │ │ │ +0001b3d0: 2075 7365 642c 2027 6175 746f 6d61 6b65 used, 'automake │ │ │ │ │ +0001b3e0: 2720 7769 6c6c 2063 6175 7365 0a20 2020 ' will cause. │ │ │ │ │ +0001b3f0: 2020 226d 6169 6e74 6169 6e65 722d 6f6e "maintainer-on │ │ │ │ │ +0001b400: 6c79 2220 7275 6c65 7320 746f 2062 6520 ly" rules to be │ │ │ │ │ +0001b410: 7475 726e 6564 206f 6666 2062 7920 6465 turned off by de │ │ │ │ │ +0001b420: 6661 756c 7420 696e 2074 6865 0a20 2020 fault in the. │ │ │ │ │ +0001b430: 2020 6765 6e65 7261 7465 6420 274d 616b generated 'Mak │ │ │ │ │ +0001b440: 6566 696c 652e 696e 2773 2c20 756e 6c65 efile.in's, unle │ │ │ │ │ +0001b450: 7373 2044 4546 4155 4c54 2d4d 4f44 4520 ss DEFAULT-MODE │ │ │ │ │ +0001b460: 6973 2027 656e 6162 6c65 272e 2020 5468 is 'enable'. Th │ │ │ │ │ +0001b470: 6973 0a20 2020 2020 6d61 6372 6f20 6465 is. macro de │ │ │ │ │ +0001b480: 6669 6e65 7320 7468 6520 274d 4149 4e54 fines the 'MAINT │ │ │ │ │ +0001b490: 4149 4e45 525f 4d4f 4445 2720 636f 6e64 AINER_MODE' cond │ │ │ │ │ +0001b4a0: 6974 696f 6e61 6c2c 2077 6869 6368 2079 itional, which y │ │ │ │ │ +0001b4b0: 6f75 2063 616e 2075 7365 0a20 2020 2020 ou can use. │ │ │ │ │ +0001b4c0: 696e 2079 6f75 7220 6f77 6e20 274d 616b in your own 'Mak │ │ │ │ │ +0001b4d0: 6566 696c 652e 616d 272e 2020 2a4e 6f74 efile.am'. *Not │ │ │ │ │ +0001b4e0: 6520 6d61 696e 7461 696e 6572 2d6d 6f64 e maintainer-mod │ │ │ │ │ +0001b4f0: 653a 3a2e 0a0a 2741 4d5f 5355 4253 545f e::...'AM_SUBST_ │ │ │ │ │ +0001b500: 4e4f 544d 414b 4528 5641 5229 270a 2020 NOTMAKE(VAR)'. │ │ │ │ │ +0001b510: 2020 2050 7265 7665 6e74 2041 7574 6f6d Prevent Autom │ │ │ │ │ +0001b520: 616b 6520 6672 6f6d 2064 6566 696e 696e ake from definin │ │ │ │ │ +0001b530: 6720 6120 7661 7269 6162 6c65 2056 4152 g a variable VAR │ │ │ │ │ +0001b540: 2c20 6576 656e 2069 6620 6974 2069 730a , even if it is. │ │ │ │ │ +0001b550: 2020 2020 2073 7562 7374 6974 7574 6564 substituted │ │ │ │ │ +0001b560: 2062 7920 2763 6f6e 6669 672e 7374 6174 by 'config.stat │ │ │ │ │ +0001b570: 7573 272e 2020 4e6f 726d 616c 6c79 2c20 us'. Normally, │ │ │ │ │ +0001b580: 4175 746f 6d61 6b65 2064 6566 696e 6573 Automake defines │ │ │ │ │ +0001b590: 2061 0a20 2020 2020 276d 616b 6527 2076 a. 'make' v │ │ │ │ │ +0001b5a0: 6172 6961 626c 6520 666f 7220 6561 6368 ariable for each │ │ │ │ │ +0001b5b0: 2027 636f 6e66 6967 7572 6527 2073 7562 'configure' sub │ │ │ │ │ +0001b5c0: 7374 6974 7574 696f 6e2c 2069 2e65 2e2c stitution, i.e., │ │ │ │ │ +0001b5d0: 2066 6f72 2065 6163 680a 2020 2020 2027 for each. ' │ │ │ │ │ +0001b5e0: 4143 5f53 5542 5354 285b 5641 525d 2927 AC_SUBST([VAR])' │ │ │ │ │ +0001b5f0: 2e20 2054 6869 7320 6d61 6372 6f20 7072 . This macro pr │ │ │ │ │ +0001b600: 6576 656e 7473 2074 6861 7420 6465 6669 events that defi │ │ │ │ │ +0001b610: 6e69 7469 6f6e 2066 726f 6d0a 2020 2020 nition from. │ │ │ │ │ +0001b620: 2041 7574 6f6d 616b 652e 2020 4966 2027 Automake. If ' │ │ │ │ │ +0001b630: 4143 5f53 5542 5354 2720 6861 7320 6e6f AC_SUBST' has no │ │ │ │ │ +0001b640: 7420 6265 656e 2063 616c 6c65 6420 666f t been called fo │ │ │ │ │ +0001b650: 7220 7468 6973 2076 6172 6961 626c 652c r this variable, │ │ │ │ │ +0001b660: 0a20 2020 2020 7468 656e 2027 414d 5f53 . then 'AM_S │ │ │ │ │ +0001b670: 5542 5354 5f4e 4f54 4d41 4b45 2720 6861 UBST_NOTMAKE' ha │ │ │ │ │ +0001b680: 7320 6e6f 2065 6666 6563 7473 2e20 2050 s no effects. P │ │ │ │ │ +0001b690: 7265 7665 6e74 696e 6720 7661 7269 6162 reventing variab │ │ │ │ │ +0001b6a0: 6c65 0a20 2020 2020 6465 6669 6e69 7469 le. definiti │ │ │ │ │ +0001b6b0: 6f6e 7320 6d61 7920 6265 2075 7365 6675 ons may be usefu │ │ │ │ │ +0001b6c0: 6c20 666f 7220 7375 6273 7469 7475 7469 l for substituti │ │ │ │ │ +0001b6d0: 6f6e 206f 6620 6d75 6c74 692d 6c69 6e65 on of multi-line │ │ │ │ │ +0001b6e0: 2076 616c 7565 732c 0a20 2020 2020 7768 values,. wh │ │ │ │ │ +0001b6f0: 6572 6520 2756 4152 203d 2040 5641 4c55 ere 'VAR = @VALU │ │ │ │ │ +0001b700: 4540 2720 6d69 6768 7420 7969 656c 6420 E@' might yield │ │ │ │ │ +0001b710: 756e 696e 7465 6e64 6564 2072 6573 756c unintended resul │ │ │ │ │ +0001b720: 7473 2e0a 0a27 6d34 5f69 6e63 6c75 6465 ts...'m4_include │ │ │ │ │ +0001b730: 270a 2020 2020 2046 696c 6573 2069 6e63 '. Files inc │ │ │ │ │ +0001b740: 6c75 6465 6420 6279 2027 636f 6e66 6967 luded by 'config │ │ │ │ │ +0001b750: 7572 652e 6163 2720 7573 696e 6720 7468 ure.ac' using th │ │ │ │ │ +0001b760: 6973 206d 6163 726f 2077 696c 6c20 6265 is macro will be │ │ │ │ │ +0001b770: 2064 6574 6563 7465 640a 2020 2020 2062 detected. b │ │ │ │ │ +0001b780: 7920 4175 746f 6d61 6b65 2061 6e64 2061 y Automake and a │ │ │ │ │ +0001b790: 7574 6f6d 6174 6963 616c 6c79 2064 6973 utomatically dis │ │ │ │ │ +0001b7a0: 7472 6962 7574 6564 2e20 2054 6865 7920 tributed. They │ │ │ │ │ +0001b7b0: 7769 6c6c 2061 6c73 6f20 6170 7065 6172 will also appear │ │ │ │ │ +0001b7c0: 0a20 2020 2020 6173 2064 6570 656e 6465 . as depende │ │ │ │ │ +0001b7d0: 6e63 6965 7320 696e 2027 4d61 6b65 6669 ncies in 'Makefi │ │ │ │ │ +0001b7e0: 6c65 2720 7275 6c65 732e 0a0a 2020 2020 le' rules... │ │ │ │ │ +0001b7f0: 2027 6d34 5f69 6e63 6c75 6465 2720 6973 'm4_include' is │ │ │ │ │ +0001b800: 2073 656c 646f 6d20 7573 6564 2062 7920 seldom used by │ │ │ │ │ +0001b810: 2763 6f6e 6669 6775 7265 2e61 6327 2061 'configure.ac' a │ │ │ │ │ +0001b820: 7574 686f 7273 2c20 6275 7420 6361 6e0a uthors, but can. │ │ │ │ │ +0001b830: 2020 2020 2061 7070 6561 7220 696e 2027 appear in ' │ │ │ │ │ +0001b840: 6163 6c6f 6361 6c2e 6d34 2720 7768 656e aclocal.m4' when │ │ │ │ │ +0001b850: 2027 6163 6c6f 6361 6c27 2064 6574 6563 'aclocal' detec │ │ │ │ │ +0001b860: 7473 2074 6861 7420 736f 6d65 2072 6571 ts that some req │ │ │ │ │ +0001b870: 7569 7265 640a 2020 2020 206d 6163 726f uired. macro │ │ │ │ │ +0001b880: 7320 636f 6d65 2066 726f 6d20 6669 6c65 s come from file │ │ │ │ │ +0001b890: 7320 6c6f 6361 6c20 746f 2079 6f75 7220 s local to your │ │ │ │ │ +0001b8a0: 7061 636b 6167 6520 2861 7320 6f70 706f package (as oppo │ │ │ │ │ +0001b8b0: 7365 6420 746f 206d 6163 726f 730a 2020 sed to macros. │ │ │ │ │ +0001b8c0: 2020 2069 6e73 7461 6c6c 6564 2069 6e20 installed in │ │ │ │ │ +0001b8d0: 6120 7379 7374 656d 2d77 6964 6520 6469 a system-wide di │ │ │ │ │ +0001b8e0: 7265 6374 6f72 792c 202a 6e6f 7465 2061 rectory, *note a │ │ │ │ │ +0001b8f0: 636c 6f63 616c 2049 6e76 6f63 6174 696f clocal Invocatio │ │ │ │ │ +0001b900: 6e3a 3a29 2e0a 0a1f 0a46 696c 653a 2061 n::).....File: a │ │ │ │ │ +0001b910: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +0001b920: 6f2c 2020 4e6f 6465 3a20 6163 6c6f 6361 o, Node: acloca │ │ │ │ │ +0001b930: 6c20 496e 766f 6361 7469 6f6e 2c20 204e l Invocation, N │ │ │ │ │ +0001b940: 6578 743a 204d 6163 726f 732c 2020 5072 ext: Macros, Pr │ │ │ │ │ +0001b950: 6576 3a20 4f70 7469 6f6e 616c 2c20 2055 ev: Optional, U │ │ │ │ │ +0001b960: 703a 2063 6f6e 6669 6775 7265 0a0a 362e p: configure..6. │ │ │ │ │ +0001b970: 3320 4175 746f 2d67 656e 6572 6174 696e 3 Auto-generatin │ │ │ │ │ +0001b980: 6720 6163 6c6f 6361 6c2e 6d34 0a3d 3d3d g aclocal.m4.=== │ │ │ │ │ 0001b990: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001b9a0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 6f6d =========..Autom │ │ │ │ │ -0001b9b0: 616b 6520 696e 636c 7564 6573 2061 206e ake includes a n │ │ │ │ │ -0001b9c0: 756d 6265 7220 6f66 2041 7574 6f63 6f6e umber of Autocon │ │ │ │ │ -0001b9d0: 6620 6d61 6372 6f73 2074 6861 7420 6361 f macros that ca │ │ │ │ │ -0001b9e0: 6e20 6265 2075 7365 6420 696e 2079 6f75 n be used in you │ │ │ │ │ -0001b9f0: 720a 7061 636b 6167 6520 282a 6e6f 7465 r.package (*note │ │ │ │ │ -0001ba00: 204d 6163 726f 733a 3a29 3b20 736f 6d65 Macros::); some │ │ │ │ │ -0001ba10: 206f 6620 7468 656d 2061 7265 2061 6374 of them are act │ │ │ │ │ -0001ba20: 7561 6c6c 7920 7265 7175 6972 6564 2062 ually required b │ │ │ │ │ -0001ba30: 7920 4175 746f 6d61 6b65 0a69 6e20 6365 y Automake.in ce │ │ │ │ │ -0001ba40: 7274 6169 6e20 7369 7475 6174 696f 6e73 rtain situations │ │ │ │ │ -0001ba50: 2e20 2054 6865 7365 206d 6163 726f 7320 . These macros │ │ │ │ │ -0001ba60: 6d75 7374 2062 6520 6465 6669 6e65 6420 must be defined │ │ │ │ │ -0001ba70: 696e 2079 6f75 720a 2761 636c 6f63 616c in your.'aclocal │ │ │ │ │ -0001ba80: 2e6d 3427 3b20 6f74 6865 7277 6973 6520 .m4'; otherwise │ │ │ │ │ -0001ba90: 7468 6579 2077 696c 6c20 6e6f 7420 6265 they will not be │ │ │ │ │ -0001baa0: 2073 6565 6e20 6279 2027 6175 746f 636f seen by 'autoco │ │ │ │ │ -0001bab0: 6e66 272e 0a0a 2020 2054 6865 2027 6163 nf'... The 'ac │ │ │ │ │ -0001bac0: 6c6f 6361 6c27 2070 726f 6772 616d 2077 local' program w │ │ │ │ │ -0001bad0: 696c 6c20 6175 746f 6d61 7469 6361 6c6c ill automaticall │ │ │ │ │ -0001bae0: 7920 6765 6e65 7261 7465 2027 6163 6c6f y generate 'aclo │ │ │ │ │ -0001baf0: 6361 6c2e 6d34 2720 6669 6c65 730a 6261 cal.m4' files.ba │ │ │ │ │ -0001bb00: 7365 6420 6f6e 2074 6865 2063 6f6e 7465 sed on the conte │ │ │ │ │ -0001bb10: 6e74 7320 6f66 2027 636f 6e66 6967 7572 nts of 'configur │ │ │ │ │ -0001bb20: 652e 6163 272e 2020 5468 6973 2070 726f e.ac'. This pro │ │ │ │ │ -0001bb30: 7669 6465 7320 6120 636f 6e76 656e 6965 vides a convenie │ │ │ │ │ -0001bb40: 6e74 2077 6179 0a74 6f20 6765 7420 4175 nt way.to get Au │ │ │ │ │ -0001bb50: 746f 6d61 6b65 2d70 726f 7669 6465 6420 tomake-provided │ │ │ │ │ -0001bb60: 6d61 6372 6f73 2c20 7769 7468 6f75 7420 macros, without │ │ │ │ │ -0001bb70: 6861 7669 6e67 2074 6f20 7365 6172 6368 having to search │ │ │ │ │ -0001bb80: 2061 726f 756e 642e 2020 5468 650a 2761 around. The.'a │ │ │ │ │ -0001bb90: 636c 6f63 616c 2720 6d65 6368 616e 6973 clocal' mechanis │ │ │ │ │ -0001bba0: 6d20 616c 6c6f 7773 206f 7468 6572 2070 m allows other p │ │ │ │ │ -0001bbb0: 6163 6b61 6765 7320 746f 2073 7570 706c ackages to suppl │ │ │ │ │ -0001bbc0: 7920 7468 6569 7220 6f77 6e20 6d61 6372 y their own macr │ │ │ │ │ -0001bbd0: 6f73 0a28 2a6e 6f74 6520 4578 7465 6e64 os.(*note Extend │ │ │ │ │ -0001bbe0: 696e 6720 6163 6c6f 6361 6c3a 3a29 2e20 ing aclocal::). │ │ │ │ │ -0001bbf0: 2059 6f75 2063 616e 2061 6c73 6f20 7573 You can also us │ │ │ │ │ -0001bc00: 6520 6974 2074 6f20 6d61 696e 7461 696e e it to maintain │ │ │ │ │ -0001bc10: 2079 6f75 7220 6f77 6e0a 7365 7420 6f66 your own.set of │ │ │ │ │ -0001bc20: 2063 7573 746f 6d20 6d61 6372 6f73 2028 custom macros ( │ │ │ │ │ -0001bc30: 2a6e 6f74 6520 4c6f 6361 6c20 4d61 6372 *note Local Macr │ │ │ │ │ -0001bc40: 6f73 3a3a 292e 0a0a 2020 2041 7420 7374 os::)... At st │ │ │ │ │ -0001bc50: 6172 7475 702c 2027 6163 6c6f 6361 6c27 artup, 'aclocal' │ │ │ │ │ -0001bc60: 2073 6361 6e73 2061 6c6c 2074 6865 2027 scans all the ' │ │ │ │ │ -0001bc70: 2e6d 3427 2066 696c 6573 2069 7420 6361 .m4' files it ca │ │ │ │ │ -0001bc80: 6e20 6669 6e64 2c20 6c6f 6f6b 696e 670a n find, looking. │ │ │ │ │ -0001bc90: 666f 7220 6d61 6372 6f20 6465 6669 6e69 for macro defini │ │ │ │ │ -0001bca0: 7469 6f6e 7320 282a 6e6f 7465 204d 6163 tions (*note Mac │ │ │ │ │ -0001bcb0: 726f 2053 6561 7263 6820 5061 7468 3a3a ro Search Path:: │ │ │ │ │ -0001bcc0: 292e 2020 5468 656e 2069 7420 7363 616e ). Then it scan │ │ │ │ │ -0001bcd0: 730a 2763 6f6e 6669 6775 7265 2e61 6327 s.'configure.ac' │ │ │ │ │ -0001bce0: 2e20 2041 6e79 206d 656e 7469 6f6e 206f . Any mention o │ │ │ │ │ -0001bcf0: 6620 6f6e 6520 6f66 2074 6865 206d 6163 f one of the mac │ │ │ │ │ -0001bd00: 726f 7320 666f 756e 6420 696e 2074 6865 ros found in the │ │ │ │ │ -0001bd10: 2066 6972 7374 0a73 7465 7020 6361 7573 first.step caus │ │ │ │ │ -0001bd20: 6573 2074 6861 7420 6d61 6372 6f2c 2061 es that macro, a │ │ │ │ │ -0001bd30: 6e64 2061 6e79 206d 6163 726f 7320 6974 nd any macros it │ │ │ │ │ -0001bd40: 2069 6e20 7475 726e 2072 6571 7569 7265 in turn require │ │ │ │ │ -0001bd50: 732c 2074 6f20 6265 2070 7574 0a69 6e74 s, to be put.int │ │ │ │ │ -0001bd60: 6f20 2761 636c 6f63 616c 2e6d 3427 2e0a o 'aclocal.m4'.. │ │ │ │ │ -0001bd70: 0a20 2020 5f50 7574 7469 6e67 5f20 7468 . _Putting_ th │ │ │ │ │ -0001bd80: 6520 6669 6c65 2074 6861 7420 636f 6e74 e file that cont │ │ │ │ │ -0001bd90: 6169 6e73 2074 6865 206d 6163 726f 2064 ains the macro d │ │ │ │ │ -0001bda0: 6566 696e 6974 696f 6e20 696e 746f 0a27 efinition into.' │ │ │ │ │ -0001bdb0: 6163 6c6f 6361 6c2e 6d34 2720 6973 2075 aclocal.m4' is u │ │ │ │ │ -0001bdc0: 7375 616c 6c79 2064 6f6e 6520 6279 2063 sually done by c │ │ │ │ │ -0001bdd0: 6f70 7969 6e67 2074 6865 2065 6e74 6972 opying the entir │ │ │ │ │ -0001bde0: 6520 7465 7874 206f 6620 7468 6973 2066 e text of this f │ │ │ │ │ -0001bdf0: 696c 652c 0a69 6e63 6c75 6469 6e67 2075 ile,.including u │ │ │ │ │ -0001be00: 6e75 7365 6420 6d61 6372 6f20 6465 6669 nused macro defi │ │ │ │ │ -0001be10: 6e69 7469 6f6e 7320 6173 2077 656c 6c20 nitions as well │ │ │ │ │ -0001be20: 6173 2062 6f74 6820 2723 2720 616e 6420 as both '#' and │ │ │ │ │ -0001be30: 2764 6e6c 270a 636f 6d6d 656e 7473 2e20 'dnl'.comments. │ │ │ │ │ -0001be40: 2049 6620 796f 7520 7761 6e74 2074 6f20 If you want to │ │ │ │ │ -0001be50: 6d61 6b65 2061 2063 6f6d 6d65 6e74 2074 make a comment t │ │ │ │ │ -0001be60: 6861 7420 7769 6c6c 2062 6520 636f 6d70 hat will be comp │ │ │ │ │ -0001be70: 6c65 7465 6c79 2069 676e 6f72 6564 0a62 letely ignored.b │ │ │ │ │ -0001be80: 7920 2761 636c 6f63 616c 272c 2075 7365 y 'aclocal', use │ │ │ │ │ -0001be90: 2027 2323 2720 6173 2074 6865 2063 6f6d '##' as the com │ │ │ │ │ -0001bea0: 6d65 6e74 206c 6561 6465 722e 0a0a 2020 ment leader... │ │ │ │ │ -0001beb0: 2057 6865 6e20 6120 6669 6c65 2073 656c When a file sel │ │ │ │ │ -0001bec0: 6563 7465 6420 6279 2027 6163 6c6f 6361 ected by 'acloca │ │ │ │ │ -0001bed0: 6c27 2069 7320 6c6f 6361 7465 6420 696e l' is located in │ │ │ │ │ -0001bee0: 2061 2073 7562 6469 7265 6374 6f72 790a a subdirectory. │ │ │ │ │ -0001bef0: 7370 6563 6966 6965 6420 6173 2061 2072 specified as a r │ │ │ │ │ -0001bf00: 656c 6174 6976 6520 7365 6172 6368 2070 elative search p │ │ │ │ │ -0001bf10: 6174 6820 7769 7468 2027 6163 6c6f 6361 ath with 'acloca │ │ │ │ │ -0001bf20: 6c27 2773 2027 2d49 2720 6172 6775 6d65 l''s '-I' argume │ │ │ │ │ -0001bf30: 6e74 2c0a 2761 636c 6f63 616c 2720 6173 nt,.'aclocal' as │ │ │ │ │ -0001bf40: 7375 6d65 7320 7468 6520 6669 6c65 2062 sumes the file b │ │ │ │ │ -0001bf50: 656c 6f6e 6773 2074 6f20 7468 6520 7061 elongs to the pa │ │ │ │ │ -0001bf60: 636b 6167 6520 616e 6420 7573 6573 2027 ckage and uses ' │ │ │ │ │ -0001bf70: 6d34 5f69 6e63 6c75 6465 270a 696e 7374 m4_include'.inst │ │ │ │ │ -0001bf80: 6561 6420 6f66 2063 6f70 7969 6e67 2069 ead of copying i │ │ │ │ │ -0001bf90: 7420 696e 746f 2027 6163 6c6f 6361 6c2e t into 'aclocal. │ │ │ │ │ -0001bfa0: 6d34 272e 2020 5468 6973 206d 616b 6573 m4'. This makes │ │ │ │ │ -0001bfb0: 2074 6865 2070 6163 6b61 6765 0a73 6d61 the package.sma │ │ │ │ │ -0001bfc0: 6c6c 6572 2c20 6561 7365 7320 6465 7065 ller, eases depe │ │ │ │ │ -0001bfd0: 6e64 656e 6379 2074 7261 636b 696e 672c ndency tracking, │ │ │ │ │ -0001bfe0: 2061 6e64 2063 6175 7365 2074 6865 2066 and cause the f │ │ │ │ │ -0001bff0: 696c 6520 746f 2062 6520 6469 7374 7269 ile to be distri │ │ │ │ │ -0001c000: 6275 7465 640a 6175 746f 6d61 7469 6361 buted.automatica │ │ │ │ │ -0001c010: 6c6c 792e 2020 282a 4e6f 7465 204c 6f63 lly. (*Note Loc │ │ │ │ │ -0001c020: 616c 204d 6163 726f 733a 3a2c 2066 6f72 al Macros::, for │ │ │ │ │ -0001c030: 2061 6e20 6578 616d 706c 652e 2920 2041 an example.) A │ │ │ │ │ -0001c040: 6e79 206d 6163 726f 2074 6861 740a 6973 ny macro that.is │ │ │ │ │ -0001c050: 2066 6f75 6e64 2069 6e20 6120 7379 7374 found in a syst │ │ │ │ │ -0001c060: 656d 2d77 6964 6520 6469 7265 6374 6f72 em-wide director │ │ │ │ │ -0001c070: 792c 206f 7220 7669 6120 616e 2061 6273 y, or via an abs │ │ │ │ │ -0001c080: 6f6c 7574 6520 7365 6172 6368 2070 6174 olute search pat │ │ │ │ │ -0001c090: 6820 7769 6c6c 0a62 6520 636f 7069 6564 h will.be copied │ │ │ │ │ -0001c0a0: 2e20 2053 6f20 7573 6520 272d 4920 6070 . So use '-I `p │ │ │ │ │ -0001c0b0: 7764 602f 7265 6c64 6972 2720 696e 7374 wd`/reldir' inst │ │ │ │ │ -0001c0c0: 6561 6420 6f66 2027 2d49 2072 656c 6469 ead of '-I reldi │ │ │ │ │ -0001c0d0: 7227 2077 6865 6e65 7665 720a 736f 6d65 r' whenever.some │ │ │ │ │ -0001c0e0: 2072 656c 6174 6976 6520 6469 7265 6374 relative direct │ │ │ │ │ -0001c0f0: 6f72 7920 7368 6f75 6c64 2062 6520 636f ory should be co │ │ │ │ │ -0001c100: 6e73 6964 6572 6564 206f 7574 7369 6465 nsidered outside │ │ │ │ │ -0001c110: 2074 6865 2070 6163 6b61 6765 2e0a 0a20 the package... │ │ │ │ │ -0001c120: 2020 5468 6520 636f 6e74 656e 7473 206f The contents o │ │ │ │ │ -0001c130: 6620 2761 6369 6e63 6c75 6465 2e6d 3427 f 'acinclude.m4' │ │ │ │ │ -0001c140: 2c20 6966 2074 6869 7320 6669 6c65 2065 , if this file e │ │ │ │ │ -0001c150: 7869 7374 732c 2061 7265 2061 6c73 6f0a xists, are also. │ │ │ │ │ -0001c160: 6175 746f 6d61 7469 6361 6c6c 7920 696e automatically in │ │ │ │ │ -0001c170: 636c 7564 6564 2069 6e20 2761 636c 6f63 cluded in 'acloc │ │ │ │ │ -0001c180: 616c 2e6d 3427 2e20 2057 6520 7265 636f al.m4'. We reco │ │ │ │ │ -0001c190: 6d6d 656e 6420 6167 6169 6e73 7420 7573 mmend against us │ │ │ │ │ -0001c1a0: 696e 670a 2761 6369 6e63 6c75 6465 2e6d ing.'acinclude.m │ │ │ │ │ -0001c1b0: 3427 2069 6e20 6e65 7720 7061 636b 6167 4' in new packag │ │ │ │ │ -0001c1c0: 6573 2028 2a6e 6f74 6520 4c6f 6361 6c20 es (*note Local │ │ │ │ │ -0001c1d0: 4d61 6372 6f73 3a3a 292e 0a0a 2020 2057 Macros::)... W │ │ │ │ │ -0001c1e0: 6869 6c65 2063 6f6d 7075 7469 6e67 2027 hile computing ' │ │ │ │ │ -0001c1f0: 6163 6c6f 6361 6c2e 6d34 272c 2027 6163 aclocal.m4', 'ac │ │ │ │ │ -0001c200: 6c6f 6361 6c27 2072 756e 7320 2761 7574 local' runs 'aut │ │ │ │ │ -0001c210: 6f6d 3474 6527 2028 2a6e 6f74 6520 5573 om4te' (*note Us │ │ │ │ │ -0001c220: 696e 670a 2741 7574 6f6d 3474 6527 3a20 ing.'Autom4te': │ │ │ │ │ -0001c230: 2861 7574 6f63 6f6e 6629 5573 696e 6720 (autoconf)Using │ │ │ │ │ -0001c240: 6175 746f 6d34 7465 2e29 2069 6e20 6f72 autom4te.) in or │ │ │ │ │ -0001c250: 6465 7220 746f 2074 7261 6365 2074 6865 der to trace the │ │ │ │ │ -0001c260: 206d 6163 726f 7320 7468 6174 0a61 7265 macros that.are │ │ │ │ │ -0001c270: 2072 6561 6c6c 7920 7573 6564 2c20 616e really used, an │ │ │ │ │ -0001c280: 6420 6f6d 6974 2066 726f 6d20 2761 636c d omit from 'acl │ │ │ │ │ -0001c290: 6f63 616c 2e6d 3427 2061 6c6c 206d 6163 ocal.m4' all mac │ │ │ │ │ -0001c2a0: 726f 7320 7468 6174 2061 7265 0a6d 656e ros that are.men │ │ │ │ │ -0001c2b0: 7469 6f6e 6564 2062 7574 206f 7468 6572 tioned but other │ │ │ │ │ -0001c2c0: 7769 7365 2075 6e65 7870 616e 6465 6420 wise unexpanded │ │ │ │ │ -0001c2d0: 2874 6869 7320 6361 6e20 6861 7070 656e (this can happen │ │ │ │ │ -0001c2e0: 2077 6865 6e20 6120 6d61 6372 6f20 6973 when a macro is │ │ │ │ │ -0001c2f0: 0a63 616c 6c65 6420 636f 6e64 6974 696f .called conditio │ │ │ │ │ -0001c300: 6e61 6c6c 7929 2e20 2027 6175 746f 6d34 nally). 'autom4 │ │ │ │ │ -0001c310: 7465 2720 6973 2065 7870 6563 7465 6420 te' is expected │ │ │ │ │ -0001c320: 746f 2062 6520 696e 2074 6865 2027 5041 to be in the 'PA │ │ │ │ │ -0001c330: 5448 272c 206a 7573 740a 6173 2027 6175 TH', just.as 'au │ │ │ │ │ -0001c340: 746f 636f 6e66 272e 2020 4974 7320 6c6f toconf'. Its lo │ │ │ │ │ -0001c350: 6361 7469 6f6e 2063 616e 2062 6520 6f76 cation can be ov │ │ │ │ │ -0001c360: 6572 7269 6464 656e 2075 7369 6e67 2074 erridden using t │ │ │ │ │ -0001c370: 6865 2027 4155 544f 4d34 5445 270a 656e he 'AUTOM4TE'.en │ │ │ │ │ -0001c380: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -0001c390: 6c65 2e0a 0a2a 204d 656e 753a 0a0a 2a20 le...* Menu:..* │ │ │ │ │ -0001c3a0: 6163 6c6f 6361 6c20 4f70 7469 6f6e 733a aclocal Options: │ │ │ │ │ -0001c3b0: 3a20 2020 2020 2020 2020 2020 2020 4f70 : Op │ │ │ │ │ -0001c3c0: 7469 6f6e 7320 7375 7070 6f72 7465 6420 tions supported │ │ │ │ │ -0001c3d0: 6279 2061 636c 6f63 616c 0a2a 204d 6163 by aclocal.* Mac │ │ │ │ │ -0001c3e0: 726f 2053 6561 7263 6820 5061 7468 3a3a ro Search Path:: │ │ │ │ │ -0001c3f0: 2020 2020 2020 2020 2020 2048 6f77 2061 How a │ │ │ │ │ -0001c400: 636c 6f63 616c 2066 696e 6473 202e 6d34 clocal finds .m4 │ │ │ │ │ -0001c410: 2066 696c 6573 0a2a 2045 7874 656e 6469 files.* Extendi │ │ │ │ │ -0001c420: 6e67 2061 636c 6f63 616c 3a3a 2020 2020 ng aclocal:: │ │ │ │ │ -0001c430: 2020 2020 2020 2057 7269 7469 6e67 2079 Writing y │ │ │ │ │ -0001c440: 6f75 7220 6f77 6e20 6163 6c6f 6361 6c20 our own aclocal │ │ │ │ │ -0001c450: 6d61 6372 6f73 0a2a 204c 6f63 616c 204d macros.* Local M │ │ │ │ │ -0001c460: 6163 726f 733a 3a20 2020 2020 2020 2020 acros:: │ │ │ │ │ -0001c470: 2020 2020 2020 204f 7267 616e 697a 696e Organizin │ │ │ │ │ -0001c480: 6720 6c6f 6361 6c20 6d61 6372 6f73 0a2a g local macros.* │ │ │ │ │ -0001c490: 2053 6572 6961 6c73 3a3a 2020 2020 2020 Serials:: │ │ │ │ │ -0001c4a0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -0001c4b0: 6572 6961 6c20 6c69 6e65 7320 696e 2041 erial lines in A │ │ │ │ │ -0001c4c0: 7574 6f63 6f6e 6620 6d61 6372 6f73 0a2a utoconf macros.* │ │ │ │ │ -0001c4d0: 2046 7574 7572 6520 6f66 2061 636c 6f63 Future of acloc │ │ │ │ │ -0001c4e0: 616c 3a3a 2020 2020 2020 2020 2020 2061 al:: a │ │ │ │ │ -0001c4f0: 636c 6f63 616c 2773 2073 6368 6564 756c clocal's schedul │ │ │ │ │ -0001c500: 6564 2064 6561 7468 0a0a 1f0a 4669 6c65 ed death....File │ │ │ │ │ -0001c510: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -0001c520: 696e 666f 2c20 204e 6f64 653a 2061 636c info, Node: acl │ │ │ │ │ -0001c530: 6f63 616c 204f 7074 696f 6e73 2c20 204e ocal Options, N │ │ │ │ │ -0001c540: 6578 743a 204d 6163 726f 2053 6561 7263 ext: Macro Searc │ │ │ │ │ -0001c550: 6820 5061 7468 2c20 2055 703a 2061 636c h Path, Up: acl │ │ │ │ │ -0001c560: 6f63 616c 2049 6e76 6f63 6174 696f 6e0a ocal Invocation. │ │ │ │ │ -0001c570: 0a36 2e33 2e31 2061 636c 6f63 616c 204f .6.3.1 aclocal O │ │ │ │ │ -0001c580: 7074 696f 6e73 0a2d 2d2d 2d2d 2d2d 2d2d ptions.--------- │ │ │ │ │ -0001c590: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2761 ------------..'a │ │ │ │ │ -0001c5a0: 636c 6f63 616c 2720 6163 6365 7074 7320 clocal' accepts │ │ │ │ │ -0001c5b0: 7468 6520 666f 6c6c 6f77 696e 6720 6f70 the following op │ │ │ │ │ -0001c5c0: 7469 6f6e 733a 0a0a 272d 2d61 7574 6f6d tions:..'--autom │ │ │ │ │ -0001c5d0: 616b 652d 6163 6469 723d 4449 5227 0a20 ake-acdir=DIR'. │ │ │ │ │ -0001c5e0: 2020 2020 4c6f 6f6b 2066 6f72 2074 6865 Look for the │ │ │ │ │ -0001c5f0: 2061 7574 6f6d 616b 652d 7072 6f76 6964 automake-provid │ │ │ │ │ -0001c600: 6564 206d 6163 726f 2066 696c 6573 2069 ed macro files i │ │ │ │ │ -0001c610: 6e20 4449 5220 696e 7374 6561 6420 6f66 n DIR instead of │ │ │ │ │ -0001c620: 2069 6e20 7468 650a 2020 2020 2069 6e73 in the. ins │ │ │ │ │ -0001c630: 7461 6c6c 6174 696f 6e20 6469 7265 6374 tallation direct │ │ │ │ │ -0001c640: 6f72 792e 2020 5468 6973 2069 7320 7479 ory. This is ty │ │ │ │ │ -0001c650: 7069 6361 6c6c 7920 7573 6564 2066 6f72 pically used for │ │ │ │ │ -0001c660: 2064 6562 7567 6769 6e67 2e0a 0a27 2d2d debugging...'-- │ │ │ │ │ -0001c670: 7379 7374 656d 2d61 6364 6972 3d44 4952 system-acdir=DIR │ │ │ │ │ -0001c680: 270a 2020 2020 204c 6f6f 6b20 666f 7220 '. Look for │ │ │ │ │ -0001c690: 7468 6520 7379 7374 656d 2d77 6964 6520 the system-wide │ │ │ │ │ -0001c6a0: 7468 6972 642d 7061 7274 7920 6d61 6372 third-party macr │ │ │ │ │ -0001c6b0: 6f20 6669 6c65 7320 2861 6e64 2074 6865 o files (and the │ │ │ │ │ -0001c6c0: 2073 7065 6369 616c 0a20 2020 2020 2764 special. 'd │ │ │ │ │ -0001c6d0: 6972 6c69 7374 2720 6669 6c65 2920 696e irlist' file) in │ │ │ │ │ -0001c6e0: 2044 4952 2069 6e73 7465 6164 206f 6620 DIR instead of │ │ │ │ │ -0001c6f0: 696e 2074 6865 2069 6e73 7461 6c6c 6174 in the installat │ │ │ │ │ -0001c700: 696f 6e20 6469 7265 6374 6f72 792e 0a20 ion directory.. │ │ │ │ │ -0001c710: 2020 2020 5468 6973 2069 7320 7479 7069 This is typi │ │ │ │ │ -0001c720: 6361 6c6c 7920 7573 6564 2066 6f72 2064 cally used for d │ │ │ │ │ -0001c730: 6562 7567 6769 6e67 2e0a 0a27 2d2d 6163 ebugging...'--ac │ │ │ │ │ -0001c740: 6469 723d 4449 5227 0a20 2020 2020 5f44 dir=DIR'. _D │ │ │ │ │ -0001c750: 6570 7265 6361 7465 645f 2073 686f 7274 eprecated_ short │ │ │ │ │ -0001c760: 6861 6e64 2066 6f72 2022 272d 2d61 7574 hand for "'--aut │ │ │ │ │ -0001c770: 6f6d 616b 652d 6163 6469 723d 4449 520a omake-acdir=DIR. │ │ │ │ │ -0001c780: 2020 2020 202d 2d73 7973 7465 6d2d 6163 --system-ac │ │ │ │ │ -0001c790: 6469 723d 4449 5227 222e 2020 5769 6c6c dir=DIR'". Will │ │ │ │ │ -0001c7a0: 2062 6520 7265 6d6f 7665 6420 696e 2066 be removed in f │ │ │ │ │ -0001c7b0: 7574 7572 6520 6163 6c6f 6361 6c20 7665 uture aclocal ve │ │ │ │ │ -0001c7c0: 7273 696f 6e73 2e0a 0a27 2d2d 6469 6666 rsions...'--diff │ │ │ │ │ -0001c7d0: 5b3d 434f 4d4d 414e 445d 270a 2020 2020 [=COMMAND]'. │ │ │ │ │ -0001c7e0: 2052 756e 2043 4f4d 4d41 4e44 206f 6e20 Run COMMAND on │ │ │ │ │ -0001c7f0: 4d34 2066 696c 6520 7468 6174 2077 6f75 M4 file that wou │ │ │ │ │ -0001c800: 6c64 2062 6520 696e 7374 616c 6c65 6420 ld be installed │ │ │ │ │ -0001c810: 6f72 206f 7665 7277 7269 7474 656e 2062 or overwritten b │ │ │ │ │ -0001c820: 790a 2020 2020 2027 2d2d 696e 7374 616c y. '--instal │ │ │ │ │ -0001c830: 6c27 2e20 2054 6865 2064 6566 6175 6c74 l'. The default │ │ │ │ │ -0001c840: 2043 4f4d 4d41 4e44 2069 7320 2764 6966 COMMAND is 'dif │ │ │ │ │ -0001c850: 6620 2d75 272e 2020 5468 6973 206f 7074 f -u'. This opt │ │ │ │ │ -0001c860: 696f 6e0a 2020 2020 2069 6d70 6c69 6573 ion. implies │ │ │ │ │ -0001c870: 2027 2d2d 696e 7374 616c 6c27 2061 6e64 '--install' and │ │ │ │ │ -0001c880: 2027 2d2d 6472 792d 7275 6e27 2e0a 0a27 '--dry-run'...' │ │ │ │ │ -0001c890: 2d2d 6472 792d 7275 6e27 0a20 2020 2020 --dry-run'. │ │ │ │ │ -0001c8a0: 446f 206e 6f74 2061 6374 7561 6c6c 7920 Do not actually │ │ │ │ │ -0001c8b0: 6f76 6572 7772 6974 6520 286f 7220 6372 overwrite (or cr │ │ │ │ │ -0001c8c0: 6561 7465 2920 2761 636c 6f63 616c 2e6d eate) 'aclocal.m │ │ │ │ │ -0001c8d0: 3427 2061 6e64 204d 3420 6669 6c65 730a 4' and M4 files. │ │ │ │ │ -0001c8e0: 2020 2020 2069 6e73 7461 6c6c 6564 2062 installed b │ │ │ │ │ -0001c8f0: 7920 272d 2d69 6e73 7461 6c6c 272e 0a0a y '--install'... │ │ │ │ │ -0001c900: 272d 2d68 656c 7027 0a20 2020 2020 5072 '--help'. Pr │ │ │ │ │ -0001c910: 696e 7420 6120 7375 6d6d 6172 7920 6f66 int a summary of │ │ │ │ │ -0001c920: 2074 6865 2063 6f6d 6d61 6e64 206c 696e the command lin │ │ │ │ │ -0001c930: 6520 6f70 7469 6f6e 7320 616e 6420 6578 e options and ex │ │ │ │ │ -0001c940: 6974 2e0a 0a27 2d49 2044 4952 270a 2020 it...'-I DIR'. │ │ │ │ │ -0001c950: 2020 2041 6464 2074 6865 2064 6972 6563 Add the direc │ │ │ │ │ -0001c960: 746f 7279 2044 4952 2074 6f20 7468 6520 tory DIR to the │ │ │ │ │ -0001c970: 6c69 7374 206f 6620 6469 7265 6374 6f72 list of director │ │ │ │ │ -0001c980: 6965 7320 7365 6172 6368 6564 2066 6f72 ies searched for │ │ │ │ │ -0001c990: 2027 2e6d 3427 0a20 2020 2020 6669 6c65 '.m4'. file │ │ │ │ │ -0001c9a0: 732e 0a0a 272d 2d69 6e73 7461 6c6c 270a s...'--install'. │ │ │ │ │ -0001c9b0: 2020 2020 2049 6e73 7461 6c6c 2073 7973 Install sys │ │ │ │ │ -0001c9c0: 7465 6d2d 7769 6465 2074 6869 7264 2d70 tem-wide third-p │ │ │ │ │ -0001c9d0: 6172 7479 206d 6163 726f 7320 696e 746f arty macros into │ │ │ │ │ -0001c9e0: 2074 6865 2066 6972 7374 2064 6972 6563 the first direc │ │ │ │ │ -0001c9f0: 746f 7279 0a20 2020 2020 7370 6563 6966 tory. specif │ │ │ │ │ -0001ca00: 6965 6420 7769 7468 2027 2d49 2044 4952 ied with '-I DIR │ │ │ │ │ -0001ca10: 2720 696e 7374 6561 6420 6f66 2063 6f70 ' instead of cop │ │ │ │ │ -0001ca20: 7969 6e67 2074 6865 6d20 696e 2074 6865 ying them in the │ │ │ │ │ -0001ca30: 206f 7574 7075 7420 6669 6c65 2e0a 2020 output file.. │ │ │ │ │ -0001ca40: 2020 204e 6f74 6520 7468 6174 2074 6869 Note that thi │ │ │ │ │ -0001ca50: 7320 7769 6c6c 2068 6170 7065 6e20 616c s will happen al │ │ │ │ │ -0001ca60: 736f 2069 6620 4449 5220 6973 2061 6e20 so if DIR is an │ │ │ │ │ -0001ca70: 6162 736f 6c75 7465 2070 6174 682e 0a0a absolute path... │ │ │ │ │ -0001ca80: 2020 2020 2057 6865 6e20 7468 6973 206f When this o │ │ │ │ │ -0001ca90: 7074 696f 6e20 6973 2075 7365 642c 2061 ption is used, a │ │ │ │ │ -0001caa0: 6e64 206f 6e6c 7920 7768 656e 2074 6869 nd only when thi │ │ │ │ │ -0001cab0: 7320 6f70 7469 6f6e 2069 7320 7573 6564 s option is used │ │ │ │ │ -0001cac0: 2c0a 2020 2020 2027 6163 6c6f 6361 6c27 ,. 'aclocal' │ │ │ │ │ -0001cad0: 2077 696c 6c20 616c 736f 2068 6f6e 6f72 will also honor │ │ │ │ │ -0001cae0: 2027 2373 6572 6961 6c20 4e55 4d42 4552 '#serial NUMBER │ │ │ │ │ -0001caf0: 2720 6c69 6e65 7320 7468 6174 2061 7070 ' lines that app │ │ │ │ │ -0001cb00: 6561 7220 696e 0a20 2020 2020 6d61 6372 ear in. macr │ │ │ │ │ -0001cb10: 6f73 3a20 616e 204d 3420 6669 6c65 2069 os: an M4 file i │ │ │ │ │ -0001cb20: 7320 6967 6e6f 7265 6420 6966 2074 6865 s ignored if the │ │ │ │ │ -0001cb30: 7265 2065 7869 7374 7320 616e 6f74 6865 re exists anothe │ │ │ │ │ -0001cb40: 7220 4d34 2066 696c 6520 7769 7468 0a20 r M4 file with. │ │ │ │ │ -0001cb50: 2020 2020 7468 6520 7361 6d65 2062 6173 the same bas │ │ │ │ │ -0001cb60: 656e 616d 6520 616e 6420 6120 6772 6561 ename and a grea │ │ │ │ │ -0001cb70: 7465 7220 7365 7269 616c 206e 756d 6265 ter serial numbe │ │ │ │ │ -0001cb80: 7220 696e 2074 6865 2073 6561 7263 6820 r in the search │ │ │ │ │ -0001cb90: 7061 7468 0a20 2020 2020 282a 6e6f 7465 path. (*note │ │ │ │ │ -0001cba0: 2053 6572 6961 6c73 3a3a 292e 0a0a 272d Serials::)...'- │ │ │ │ │ -0001cbb0: 2d66 6f72 6365 270a 2020 2020 2041 6c77 -force'. Alw │ │ │ │ │ -0001cbc0: 6179 7320 6f76 6572 7772 6974 6520 7468 ays overwrite th │ │ │ │ │ -0001cbd0: 6520 6f75 7470 7574 2066 696c 652e 2020 e output file. │ │ │ │ │ -0001cbe0: 5468 6520 6465 6661 756c 7420 6973 2074 The default is t │ │ │ │ │ -0001cbf0: 6f20 6f76 6572 7772 6974 6520 7468 650a o overwrite the. │ │ │ │ │ -0001cc00: 2020 2020 206f 7574 7075 7420 6669 6c65 output file │ │ │ │ │ -0001cc10: 206f 6e6c 7920 7768 656e 2072 6561 6c6c only when reall │ │ │ │ │ -0001cc20: 7920 6e65 6564 6564 2c20 692e 652e 2c20 y needed, i.e., │ │ │ │ │ -0001cc30: 7768 656e 2069 7473 2063 6f6e 7465 6e74 when its content │ │ │ │ │ -0001cc40: 730a 2020 2020 2063 6861 6e67 6573 206f s. changes o │ │ │ │ │ -0001cc50: 7220 6966 206f 6e65 206f 6620 6974 7320 r if one of its │ │ │ │ │ -0001cc60: 6465 7065 6e64 656e 6369 6573 2069 7320 dependencies is │ │ │ │ │ -0001cc70: 796f 756e 6765 722e 0a0a 2020 2020 2054 younger... T │ │ │ │ │ -0001cc80: 6869 7320 6f70 7469 6f6e 2066 6f72 6365 his option force │ │ │ │ │ -0001cc90: 7320 7468 6520 7570 6461 7465 206f 6620 s the update of │ │ │ │ │ -0001cca0: 2761 636c 6f63 616c 2e6d 3427 2028 6f72 'aclocal.m4' (or │ │ │ │ │ -0001ccb0: 2074 6865 2066 696c 650a 2020 2020 2073 the file. s │ │ │ │ │ -0001ccc0: 7065 6369 6669 6564 2077 6974 6820 272d pecified with '- │ │ │ │ │ -0001ccd0: 2d6f 7574 7075 7427 2062 656c 6f77 2920 -output' below) │ │ │ │ │ -0001cce0: 616e 6420 6f6e 6c79 2074 6869 7320 6669 and only this fi │ │ │ │ │ -0001ccf0: 6c65 2c20 6974 2068 6173 0a20 2020 2020 le, it has. │ │ │ │ │ -0001cd00: 6162 736f 6c75 7465 6c79 206e 6f20 696e absolutely no in │ │ │ │ │ -0001cd10: 666c 7565 6e63 6520 6f6e 2066 696c 6573 fluence on files │ │ │ │ │ -0001cd20: 2074 6861 7420 6d61 7920 6e65 6564 2074 that may need t │ │ │ │ │ -0001cd30: 6f20 6265 2069 6e73 7461 6c6c 6564 2062 o be installed b │ │ │ │ │ -0001cd40: 790a 2020 2020 2027 2d2d 696e 7374 616c y. '--instal │ │ │ │ │ -0001cd50: 6c27 2e0a 0a27 2d2d 6f75 7470 7574 3d46 l'...'--output=F │ │ │ │ │ -0001cd60: 494c 4527 0a20 2020 2020 4361 7573 6520 ILE'. Cause │ │ │ │ │ -0001cd70: 7468 6520 6f75 7470 7574 2074 6f20 6265 the output to be │ │ │ │ │ -0001cd80: 2070 7574 2069 6e74 6f20 4649 4c45 2069 put into FILE i │ │ │ │ │ -0001cd90: 6e73 7465 6164 206f 6620 2761 636c 6f63 nstead of 'acloc │ │ │ │ │ -0001cda0: 616c 2e6d 3427 2e0a 0a27 2d2d 7072 696e al.m4'...'--prin │ │ │ │ │ -0001cdb0: 742d 6163 2d64 6972 270a 2020 2020 2050 t-ac-dir'. P │ │ │ │ │ -0001cdc0: 7269 6e74 7320 7468 6520 6e61 6d65 206f rints the name o │ │ │ │ │ -0001cdd0: 6620 7468 6520 6469 7265 6374 6f72 7920 f the directory │ │ │ │ │ -0001cde0: 7468 6174 2027 6163 6c6f 6361 6c27 2077 that 'aclocal' w │ │ │ │ │ -0001cdf0: 696c 6c20 7365 6172 6368 2074 6f20 6669 ill search to fi │ │ │ │ │ -0001ce00: 6e64 0a20 2020 2020 7468 6972 642d 7061 nd. third-pa │ │ │ │ │ -0001ce10: 7274 7920 272e 6d34 2720 6669 6c65 732e rty '.m4' files. │ │ │ │ │ -0001ce20: 2020 5768 656e 2074 6869 7320 6f70 7469 When this opti │ │ │ │ │ -0001ce30: 6f6e 2069 7320 6769 7665 6e2c 206e 6f72 on is given, nor │ │ │ │ │ -0001ce40: 6d61 6c0a 2020 2020 2070 726f 6365 7373 mal. process │ │ │ │ │ -0001ce50: 696e 6720 6973 2073 7570 7072 6573 7365 ing is suppresse │ │ │ │ │ -0001ce60: 642e 2020 5468 6973 206f 7074 696f 6e20 d. This option │ │ │ │ │ -0001ce70: 7761 7320 7573 6564 205f 696e 2074 6865 was used _in the │ │ │ │ │ -0001ce80: 2070 6173 745f 2062 790a 2020 2020 2074 past_ by. t │ │ │ │ │ -0001ce90: 6869 7264 2d70 6172 7479 2070 6163 6b61 hird-party packa │ │ │ │ │ -0001cea0: 6765 7320 746f 2064 6574 6572 6d69 6e65 ges to determine │ │ │ │ │ -0001ceb0: 2077 6865 7265 2074 6f20 696e 7374 616c where to instal │ │ │ │ │ -0001cec0: 6c20 272e 6d34 2720 6d61 6372 6f0a 2020 l '.m4' macro. │ │ │ │ │ -0001ced0: 2020 2066 696c 6573 2c20 6275 7420 5f74 files, but _t │ │ │ │ │ -0001cee0: 6869 7320 7573 6167 6520 6973 2074 6f64 his usage is tod │ │ │ │ │ -0001cef0: 6179 2064 6973 636f 7572 6167 6564 5f2c ay discouraged_, │ │ │ │ │ -0001cf00: 2073 696e 6365 2069 7420 6361 7573 6573 since it causes │ │ │ │ │ -0001cf10: 0a20 2020 2020 2724 2870 7265 6669 7829 . '$(prefix) │ │ │ │ │ -0001cf20: 2720 6e6f 7420 746f 2062 6520 7468 6f72 ' not to be thor │ │ │ │ │ -0001cf30: 6f75 6768 6c79 2068 6f6e 6f75 7265 6420 oughly honoured │ │ │ │ │ -0001cf40: 2877 6869 6368 2076 696f 6c61 7465 7320 (which violates │ │ │ │ │ -0001cf50: 7468 6520 474e 550a 2020 2020 2043 6f64 the GNU. Cod │ │ │ │ │ -0001cf60: 696e 6720 5374 616e 6461 7264 7329 2c20 ing Standards), │ │ │ │ │ -0001cf70: 616e 6420 6120 7369 6d69 6c61 7220 7365 and a similar se │ │ │ │ │ -0001cf80: 6d61 6e74 6963 7320 6361 6e20 6265 2062 mantics can be b │ │ │ │ │ -0001cf90: 6574 7465 7220 6f62 7461 696e 6564 0a20 etter obtained. │ │ │ │ │ -0001cfa0: 2020 2020 7769 7468 2074 6865 2027 4143 with the 'AC │ │ │ │ │ -0001cfb0: 4c4f 4341 4c5f 5041 5448 2720 656e 7669 LOCAL_PATH' envi │ │ │ │ │ -0001cfc0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -0001cfd0: 3b20 2a6e 6f74 6520 4578 7465 6e64 696e ; *note Extendin │ │ │ │ │ -0001cfe0: 670a 2020 2020 2061 636c 6f63 616c 3a3a g. aclocal:: │ │ │ │ │ -0001cff0: 2e0a 0a27 2d2d 7665 7262 6f73 6527 0a20 ...'--verbose'. │ │ │ │ │ -0001d000: 2020 2020 5072 696e 7420 7468 6520 6e61 Print the na │ │ │ │ │ -0001d010: 6d65 7320 6f66 2074 6865 2066 696c 6573 mes of the files │ │ │ │ │ -0001d020: 2069 7420 6578 616d 696e 6573 2e0a 0a27 it examines...' │ │ │ │ │ -0001d030: 2d2d 7665 7273 696f 6e27 0a20 2020 2020 --version'. │ │ │ │ │ -0001d040: 5072 696e 7420 7468 6520 7665 7273 696f Print the versio │ │ │ │ │ -0001d050: 6e20 6e75 6d62 6572 206f 6620 4175 746f n number of Auto │ │ │ │ │ -0001d060: 6d61 6b65 2061 6e64 2065 7869 742e 0a0a make and exit... │ │ │ │ │ -0001d070: 272d 5720 4341 5445 474f 5259 270a 272d '-W CATEGORY'.'- │ │ │ │ │ -0001d080: 2d77 6172 6e69 6e67 733d 4341 5445 474f -warnings=CATEGO │ │ │ │ │ -0001d090: 5259 270a 2020 2020 204f 7574 7075 7420 RY'. Output │ │ │ │ │ -0001d0a0: 7761 726e 696e 6773 2066 616c 6c69 6e67 warnings falling │ │ │ │ │ -0001d0b0: 2069 6e20 4341 5445 474f 5259 2e20 2043 in CATEGORY. C │ │ │ │ │ -0001d0c0: 4154 4547 4f52 5920 6361 6e20 6265 206f ATEGORY can be o │ │ │ │ │ -0001d0d0: 6e65 206f 663a 0a20 2020 2020 2773 796e ne of:. 'syn │ │ │ │ │ -0001d0e0: 7461 7827 0a20 2020 2020 2020 2020 2064 tax'. d │ │ │ │ │ -0001d0f0: 7562 696f 7573 2073 796e 7461 6374 6963 ubious syntactic │ │ │ │ │ -0001d100: 2063 6f6e 7374 7275 6374 732c 2075 6e64 constructs, und │ │ │ │ │ -0001d110: 6572 7175 6f74 6564 206d 6163 726f 732c erquoted macros, │ │ │ │ │ -0001d120: 2075 6e75 7365 640a 2020 2020 2020 2020 unused. │ │ │ │ │ -0001d130: 2020 6d61 6372 6f73 2c20 6574 632e 0a20 macros, etc.. │ │ │ │ │ -0001d140: 2020 2020 2775 6e73 7570 706f 7274 6564 'unsupported │ │ │ │ │ -0001d150: 270a 2020 2020 2020 2020 2020 756e 6b6e '. unkn │ │ │ │ │ -0001d160: 6f77 6e20 6d61 6372 6f73 0a20 2020 2020 own macros. │ │ │ │ │ -0001d170: 2761 6c6c 270a 2020 2020 2020 2020 2020 'all'. │ │ │ │ │ -0001d180: 616c 6c20 7468 6520 7761 726e 696e 6773 all the warnings │ │ │ │ │ -0001d190: 2c20 7468 6973 2069 7320 7468 6520 6465 , this is the de │ │ │ │ │ -0001d1a0: 6661 756c 740a 2020 2020 2027 6e6f 6e65 fault. 'none │ │ │ │ │ -0001d1b0: 270a 2020 2020 2020 2020 2020 7475 726e '. turn │ │ │ │ │ -0001d1c0: 206f 6666 2061 6c6c 2074 6865 2077 6172 off all the war │ │ │ │ │ -0001d1d0: 6e69 6e67 730a 2020 2020 2027 6572 726f nings. 'erro │ │ │ │ │ -0001d1e0: 7227 0a20 2020 2020 2020 2020 2074 7265 r'. tre │ │ │ │ │ -0001d1f0: 6174 2077 6172 6e69 6e67 7320 6173 2065 at warnings as e │ │ │ │ │ -0001d200: 7272 6f72 730a 0a20 2020 2020 416c 6c20 rrors.. All │ │ │ │ │ -0001d210: 7761 726e 696e 6773 2061 7265 206f 7574 warnings are out │ │ │ │ │ -0001d220: 7075 7420 6279 2064 6566 6175 6c74 2e0a put by default.. │ │ │ │ │ -0001d230: 0a20 2020 2020 5468 6520 656e 7669 726f . The enviro │ │ │ │ │ -0001d240: 6e6d 656e 7420 7661 7269 6162 6c65 2027 nment variable ' │ │ │ │ │ -0001d250: 5741 524e 494e 4753 2720 6973 2068 6f6e WARNINGS' is hon │ │ │ │ │ -0001d260: 6f72 6564 2069 6e20 7468 6520 7361 6d65 ored in the same │ │ │ │ │ -0001d270: 2077 6179 2061 730a 2020 2020 2069 7420 way as. it │ │ │ │ │ -0001d280: 6973 2066 6f72 2027 6175 746f 6d61 6b65 is for 'automake │ │ │ │ │ -0001d290: 2720 282a 6e6f 7465 2061 7574 6f6d 616b ' (*note automak │ │ │ │ │ -0001d2a0: 6520 496e 766f 6361 7469 6f6e 3a3a 292e e Invocation::). │ │ │ │ │ -0001d2b0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -0001d2c0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -0001d2d0: 6f64 653a 204d 6163 726f 2053 6561 7263 ode: Macro Searc │ │ │ │ │ -0001d2e0: 6820 5061 7468 2c20 204e 6578 743a 2045 h Path, Next: E │ │ │ │ │ -0001d2f0: 7874 656e 6469 6e67 2061 636c 6f63 616c xtending aclocal │ │ │ │ │ -0001d300: 2c20 2050 7265 763a 2061 636c 6f63 616c , Prev: aclocal │ │ │ │ │ -0001d310: 204f 7074 696f 6e73 2c20 2055 703a 2061 Options, Up: a │ │ │ │ │ -0001d320: 636c 6f63 616c 2049 6e76 6f63 6174 696f clocal Invocatio │ │ │ │ │ -0001d330: 6e0a 0a36 2e33 2e32 204d 6163 726f 2053 n..6.3.2 Macro S │ │ │ │ │ -0001d340: 6561 7263 6820 5061 7468 0a2d 2d2d 2d2d earch Path.----- │ │ │ │ │ +0001b9a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 ===========..Aut │ │ │ │ │ +0001b9b0: 6f6d 616b 6520 696e 636c 7564 6573 2061 omake includes a │ │ │ │ │ +0001b9c0: 206e 756d 6265 7220 6f66 2041 7574 6f63 number of Autoc │ │ │ │ │ +0001b9d0: 6f6e 6620 6d61 6372 6f73 2074 6861 7420 onf macros that │ │ │ │ │ +0001b9e0: 6361 6e20 6265 2075 7365 6420 696e 2079 can be used in y │ │ │ │ │ +0001b9f0: 6f75 720a 7061 636b 6167 6520 282a 6e6f our.package (*no │ │ │ │ │ +0001ba00: 7465 204d 6163 726f 733a 3a29 3b20 736f te Macros::); so │ │ │ │ │ +0001ba10: 6d65 206f 6620 7468 656d 2061 7265 2061 me of them are a │ │ │ │ │ +0001ba20: 6374 7561 6c6c 7920 7265 7175 6972 6564 ctually required │ │ │ │ │ +0001ba30: 2062 7920 4175 746f 6d61 6b65 0a69 6e20 by Automake.in │ │ │ │ │ +0001ba40: 6365 7274 6169 6e20 7369 7475 6174 696f certain situatio │ │ │ │ │ +0001ba50: 6e73 2e20 2054 6865 7365 206d 6163 726f ns. These macro │ │ │ │ │ +0001ba60: 7320 6d75 7374 2062 6520 6465 6669 6e65 s must be define │ │ │ │ │ +0001ba70: 6420 696e 2079 6f75 720a 2761 636c 6f63 d in your.'acloc │ │ │ │ │ +0001ba80: 616c 2e6d 3427 3b20 6f74 6865 7277 6973 al.m4'; otherwis │ │ │ │ │ +0001ba90: 6520 7468 6579 2077 696c 6c20 6e6f 7420 e they will not │ │ │ │ │ +0001baa0: 6265 2073 6565 6e20 6279 2027 6175 746f be seen by 'auto │ │ │ │ │ +0001bab0: 636f 6e66 272e 0a0a 2020 2054 6865 2027 conf'... The ' │ │ │ │ │ +0001bac0: 6163 6c6f 6361 6c27 2070 726f 6772 616d aclocal' program │ │ │ │ │ +0001bad0: 2077 696c 6c20 6175 746f 6d61 7469 6361 will automatica │ │ │ │ │ +0001bae0: 6c6c 7920 6765 6e65 7261 7465 2027 6163 lly generate 'ac │ │ │ │ │ +0001baf0: 6c6f 6361 6c2e 6d34 2720 6669 6c65 730a local.m4' files. │ │ │ │ │ +0001bb00: 6261 7365 6420 6f6e 2074 6865 2063 6f6e based on the con │ │ │ │ │ +0001bb10: 7465 6e74 7320 6f66 2027 636f 6e66 6967 tents of 'config │ │ │ │ │ +0001bb20: 7572 652e 6163 272e 2020 5468 6973 2070 ure.ac'. This p │ │ │ │ │ +0001bb30: 726f 7669 6465 7320 6120 636f 6e76 656e rovides a conven │ │ │ │ │ +0001bb40: 6965 6e74 2077 6179 0a74 6f20 6765 7420 ient way.to get │ │ │ │ │ +0001bb50: 4175 746f 6d61 6b65 2d70 726f 7669 6465 Automake-provide │ │ │ │ │ +0001bb60: 6420 6d61 6372 6f73 2c20 7769 7468 6f75 d macros, withou │ │ │ │ │ +0001bb70: 7420 6861 7669 6e67 2074 6f20 7365 6172 t having to sear │ │ │ │ │ +0001bb80: 6368 2061 726f 756e 642e 2020 5468 650a ch around. The. │ │ │ │ │ +0001bb90: 2761 636c 6f63 616c 2720 6d65 6368 616e 'aclocal' mechan │ │ │ │ │ +0001bba0: 6973 6d20 616c 6c6f 7773 206f 7468 6572 ism allows other │ │ │ │ │ +0001bbb0: 2070 6163 6b61 6765 7320 746f 2073 7570 packages to sup │ │ │ │ │ +0001bbc0: 706c 7920 7468 6569 7220 6f77 6e20 6d61 ply their own ma │ │ │ │ │ +0001bbd0: 6372 6f73 0a28 2a6e 6f74 6520 4578 7465 cros.(*note Exte │ │ │ │ │ +0001bbe0: 6e64 696e 6720 6163 6c6f 6361 6c3a 3a29 nding aclocal::) │ │ │ │ │ +0001bbf0: 2e20 2059 6f75 2063 616e 2061 6c73 6f20 . You can also │ │ │ │ │ +0001bc00: 7573 6520 6974 2074 6f20 6d61 696e 7461 use it to mainta │ │ │ │ │ +0001bc10: 696e 2079 6f75 7220 6f77 6e0a 7365 7420 in your own.set │ │ │ │ │ +0001bc20: 6f66 2063 7573 746f 6d20 6d61 6372 6f73 of custom macros │ │ │ │ │ +0001bc30: 2028 2a6e 6f74 6520 4c6f 6361 6c20 4d61 (*note Local Ma │ │ │ │ │ +0001bc40: 6372 6f73 3a3a 292e 0a0a 2020 2041 7420 cros::)... At │ │ │ │ │ +0001bc50: 7374 6172 7475 702c 2027 6163 6c6f 6361 startup, 'acloca │ │ │ │ │ +0001bc60: 6c27 2073 6361 6e73 2061 6c6c 2074 6865 l' scans all the │ │ │ │ │ +0001bc70: 2027 2e6d 3427 2066 696c 6573 2069 7420 '.m4' files it │ │ │ │ │ +0001bc80: 6361 6e20 6669 6e64 2c20 6c6f 6f6b 696e can find, lookin │ │ │ │ │ +0001bc90: 670a 666f 7220 6d61 6372 6f20 6465 6669 g.for macro defi │ │ │ │ │ +0001bca0: 6e69 7469 6f6e 7320 282a 6e6f 7465 204d nitions (*note M │ │ │ │ │ +0001bcb0: 6163 726f 2053 6561 7263 6820 5061 7468 acro Search Path │ │ │ │ │ +0001bcc0: 3a3a 292e 2020 5468 656e 2069 7420 7363 ::). Then it sc │ │ │ │ │ +0001bcd0: 616e 730a 2763 6f6e 6669 6775 7265 2e61 ans.'configure.a │ │ │ │ │ +0001bce0: 6327 2e20 2041 6e79 206d 656e 7469 6f6e c'. Any mention │ │ │ │ │ +0001bcf0: 206f 6620 6f6e 6520 6f66 2074 6865 206d of one of the m │ │ │ │ │ +0001bd00: 6163 726f 7320 666f 756e 6420 696e 2074 acros found in t │ │ │ │ │ +0001bd10: 6865 2066 6972 7374 0a73 7465 7020 6361 he first.step ca │ │ │ │ │ +0001bd20: 7573 6573 2074 6861 7420 6d61 6372 6f2c uses that macro, │ │ │ │ │ +0001bd30: 2061 6e64 2061 6e79 206d 6163 726f 7320 and any macros │ │ │ │ │ +0001bd40: 6974 2069 6e20 7475 726e 2072 6571 7569 it in turn requi │ │ │ │ │ +0001bd50: 7265 732c 2074 6f20 6265 2070 7574 0a69 res, to be put.i │ │ │ │ │ +0001bd60: 6e74 6f20 2761 636c 6f63 616c 2e6d 3427 nto 'aclocal.m4' │ │ │ │ │ +0001bd70: 2e0a 0a20 2020 5f50 7574 7469 6e67 5f20 ... _Putting_ │ │ │ │ │ +0001bd80: 7468 6520 6669 6c65 2074 6861 7420 636f the file that co │ │ │ │ │ +0001bd90: 6e74 6169 6e73 2074 6865 206d 6163 726f ntains the macro │ │ │ │ │ +0001bda0: 2064 6566 696e 6974 696f 6e20 696e 746f definition into │ │ │ │ │ +0001bdb0: 0a27 6163 6c6f 6361 6c2e 6d34 2720 6973 .'aclocal.m4' is │ │ │ │ │ +0001bdc0: 2075 7375 616c 6c79 2064 6f6e 6520 6279 usually done by │ │ │ │ │ +0001bdd0: 2063 6f70 7969 6e67 2074 6865 2065 6e74 copying the ent │ │ │ │ │ +0001bde0: 6972 6520 7465 7874 206f 6620 7468 6973 ire text of this │ │ │ │ │ +0001bdf0: 2066 696c 652c 0a69 6e63 6c75 6469 6e67 file,.including │ │ │ │ │ +0001be00: 2075 6e75 7365 6420 6d61 6372 6f20 6465 unused macro de │ │ │ │ │ +0001be10: 6669 6e69 7469 6f6e 7320 6173 2077 656c finitions as wel │ │ │ │ │ +0001be20: 6c20 6173 2062 6f74 6820 2723 2720 616e l as both '#' an │ │ │ │ │ +0001be30: 6420 2764 6e6c 270a 636f 6d6d 656e 7473 d 'dnl'.comments │ │ │ │ │ +0001be40: 2e20 2049 6620 796f 7520 7761 6e74 2074 . If you want t │ │ │ │ │ +0001be50: 6f20 6d61 6b65 2061 2063 6f6d 6d65 6e74 o make a comment │ │ │ │ │ +0001be60: 2074 6861 7420 7769 6c6c 2062 6520 636f that will be co │ │ │ │ │ +0001be70: 6d70 6c65 7465 6c79 2069 676e 6f72 6564 mpletely ignored │ │ │ │ │ +0001be80: 0a62 7920 2761 636c 6f63 616c 272c 2075 .by 'aclocal', u │ │ │ │ │ +0001be90: 7365 2027 2323 2720 6173 2074 6865 2063 se '##' as the c │ │ │ │ │ +0001bea0: 6f6d 6d65 6e74 206c 6561 6465 722e 0a0a omment leader... │ │ │ │ │ +0001beb0: 2020 2057 6865 6e20 6120 6669 6c65 2073 When a file s │ │ │ │ │ +0001bec0: 656c 6563 7465 6420 6279 2027 6163 6c6f elected by 'aclo │ │ │ │ │ +0001bed0: 6361 6c27 2069 7320 6c6f 6361 7465 6420 cal' is located │ │ │ │ │ +0001bee0: 696e 2061 2073 7562 6469 7265 6374 6f72 in a subdirector │ │ │ │ │ +0001bef0: 790a 7370 6563 6966 6965 6420 6173 2061 y.specified as a │ │ │ │ │ +0001bf00: 2072 656c 6174 6976 6520 7365 6172 6368 relative search │ │ │ │ │ +0001bf10: 2070 6174 6820 7769 7468 2027 6163 6c6f path with 'aclo │ │ │ │ │ +0001bf20: 6361 6c27 2773 2027 2d49 2720 6172 6775 cal''s '-I' argu │ │ │ │ │ +0001bf30: 6d65 6e74 2c0a 2761 636c 6f63 616c 2720 ment,.'aclocal' │ │ │ │ │ +0001bf40: 6173 7375 6d65 7320 7468 6520 6669 6c65 assumes the file │ │ │ │ │ +0001bf50: 2062 656c 6f6e 6773 2074 6f20 7468 6520 belongs to the │ │ │ │ │ +0001bf60: 7061 636b 6167 6520 616e 6420 7573 6573 package and uses │ │ │ │ │ +0001bf70: 2027 6d34 5f69 6e63 6c75 6465 270a 696e 'm4_include'.in │ │ │ │ │ +0001bf80: 7374 6561 6420 6f66 2063 6f70 7969 6e67 stead of copying │ │ │ │ │ +0001bf90: 2069 7420 696e 746f 2027 6163 6c6f 6361 it into 'acloca │ │ │ │ │ +0001bfa0: 6c2e 6d34 272e 2020 5468 6973 206d 616b l.m4'. This mak │ │ │ │ │ +0001bfb0: 6573 2074 6865 2070 6163 6b61 6765 0a73 es the package.s │ │ │ │ │ +0001bfc0: 6d61 6c6c 6572 2c20 6561 7365 7320 6465 maller, eases de │ │ │ │ │ +0001bfd0: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ +0001bfe0: 672c 2061 6e64 2063 6175 7365 2074 6865 g, and cause the │ │ │ │ │ +0001bff0: 2066 696c 6520 746f 2062 6520 6469 7374 file to be dist │ │ │ │ │ +0001c000: 7269 6275 7465 640a 6175 746f 6d61 7469 ributed.automati │ │ │ │ │ +0001c010: 6361 6c6c 792e 2020 282a 4e6f 7465 204c cally. (*Note L │ │ │ │ │ +0001c020: 6f63 616c 204d 6163 726f 733a 3a2c 2066 ocal Macros::, f │ │ │ │ │ +0001c030: 6f72 2061 6e20 6578 616d 706c 652e 2920 or an example.) │ │ │ │ │ +0001c040: 2041 6e79 206d 6163 726f 2074 6861 740a Any macro that. │ │ │ │ │ +0001c050: 6973 2066 6f75 6e64 2069 6e20 6120 7379 is found in a sy │ │ │ │ │ +0001c060: 7374 656d 2d77 6964 6520 6469 7265 6374 stem-wide direct │ │ │ │ │ +0001c070: 6f72 792c 206f 7220 7669 6120 616e 2061 ory, or via an a │ │ │ │ │ +0001c080: 6273 6f6c 7574 6520 7365 6172 6368 2070 bsolute search p │ │ │ │ │ +0001c090: 6174 6820 7769 6c6c 0a62 6520 636f 7069 ath will.be copi │ │ │ │ │ +0001c0a0: 6564 2e20 2053 6f20 7573 6520 272d 4920 ed. So use '-I │ │ │ │ │ +0001c0b0: 6070 7764 602f 7265 6c64 6972 2720 696e `pwd`/reldir' in │ │ │ │ │ +0001c0c0: 7374 6561 6420 6f66 2027 2d49 2072 656c stead of '-I rel │ │ │ │ │ +0001c0d0: 6469 7227 2077 6865 6e65 7665 720a 736f dir' whenever.so │ │ │ │ │ +0001c0e0: 6d65 2072 656c 6174 6976 6520 6469 7265 me relative dire │ │ │ │ │ +0001c0f0: 6374 6f72 7920 7368 6f75 6c64 2062 6520 ctory should be │ │ │ │ │ +0001c100: 636f 6e73 6964 6572 6564 206f 7574 7369 considered outsi │ │ │ │ │ +0001c110: 6465 2074 6865 2070 6163 6b61 6765 2e0a de the package.. │ │ │ │ │ +0001c120: 0a20 2020 5468 6520 636f 6e74 656e 7473 . The contents │ │ │ │ │ +0001c130: 206f 6620 2761 6369 6e63 6c75 6465 2e6d of 'acinclude.m │ │ │ │ │ +0001c140: 3427 2c20 6966 2074 6869 7320 6669 6c65 4', if this file │ │ │ │ │ +0001c150: 2065 7869 7374 732c 2061 7265 2061 6c73 exists, are als │ │ │ │ │ +0001c160: 6f0a 6175 746f 6d61 7469 6361 6c6c 7920 o.automatically │ │ │ │ │ +0001c170: 696e 636c 7564 6564 2069 6e20 2761 636c included in 'acl │ │ │ │ │ +0001c180: 6f63 616c 2e6d 3427 2e20 2057 6520 7265 ocal.m4'. We re │ │ │ │ │ +0001c190: 636f 6d6d 656e 6420 6167 6169 6e73 7420 commend against │ │ │ │ │ +0001c1a0: 7573 696e 670a 2761 6369 6e63 6c75 6465 using.'acinclude │ │ │ │ │ +0001c1b0: 2e6d 3427 2069 6e20 6e65 7720 7061 636b .m4' in new pack │ │ │ │ │ +0001c1c0: 6167 6573 2028 2a6e 6f74 6520 4c6f 6361 ages (*note Loca │ │ │ │ │ +0001c1d0: 6c20 4d61 6372 6f73 3a3a 292e 0a0a 2020 l Macros::)... │ │ │ │ │ +0001c1e0: 2057 6869 6c65 2063 6f6d 7075 7469 6e67 While computing │ │ │ │ │ +0001c1f0: 2027 6163 6c6f 6361 6c2e 6d34 272c 2027 'aclocal.m4', ' │ │ │ │ │ +0001c200: 6163 6c6f 6361 6c27 2072 756e 7320 2761 aclocal' runs 'a │ │ │ │ │ +0001c210: 7574 6f6d 3474 6527 2028 2a6e 6f74 6520 utom4te' (*note │ │ │ │ │ +0001c220: 5573 696e 670a 2741 7574 6f6d 3474 6527 Using.'Autom4te' │ │ │ │ │ +0001c230: 3a20 2861 7574 6f63 6f6e 6629 5573 696e : (autoconf)Usin │ │ │ │ │ +0001c240: 6720 6175 746f 6d34 7465 2e29 2069 6e20 g autom4te.) in │ │ │ │ │ +0001c250: 6f72 6465 7220 746f 2074 7261 6365 2074 order to trace t │ │ │ │ │ +0001c260: 6865 206d 6163 726f 7320 7468 6174 0a61 he macros that.a │ │ │ │ │ +0001c270: 7265 2072 6561 6c6c 7920 7573 6564 2c20 re really used, │ │ │ │ │ +0001c280: 616e 6420 6f6d 6974 2066 726f 6d20 2761 and omit from 'a │ │ │ │ │ +0001c290: 636c 6f63 616c 2e6d 3427 2061 6c6c 206d clocal.m4' all m │ │ │ │ │ +0001c2a0: 6163 726f 7320 7468 6174 2061 7265 0a6d acros that are.m │ │ │ │ │ +0001c2b0: 656e 7469 6f6e 6564 2062 7574 206f 7468 entioned but oth │ │ │ │ │ +0001c2c0: 6572 7769 7365 2075 6e65 7870 616e 6465 erwise unexpande │ │ │ │ │ +0001c2d0: 6420 2874 6869 7320 6361 6e20 6861 7070 d (this can happ │ │ │ │ │ +0001c2e0: 656e 2077 6865 6e20 6120 6d61 6372 6f20 en when a macro │ │ │ │ │ +0001c2f0: 6973 0a63 616c 6c65 6420 636f 6e64 6974 is.called condit │ │ │ │ │ +0001c300: 696f 6e61 6c6c 7929 2e20 2027 6175 746f ionally). 'auto │ │ │ │ │ +0001c310: 6d34 7465 2720 6973 2065 7870 6563 7465 m4te' is expecte │ │ │ │ │ +0001c320: 6420 746f 2062 6520 696e 2074 6865 2027 d to be in the ' │ │ │ │ │ +0001c330: 5041 5448 272c 206a 7573 740a 6173 2027 PATH', just.as ' │ │ │ │ │ +0001c340: 6175 746f 636f 6e66 272e 2020 4974 7320 autoconf'. Its │ │ │ │ │ +0001c350: 6c6f 6361 7469 6f6e 2063 616e 2062 6520 location can be │ │ │ │ │ +0001c360: 6f76 6572 7269 6464 656e 2075 7369 6e67 overridden using │ │ │ │ │ +0001c370: 2074 6865 2027 4155 544f 4d34 5445 270a the 'AUTOM4TE'. │ │ │ │ │ +0001c380: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +0001c390: 6162 6c65 2e0a 0a2a 204d 656e 753a 0a0a able...* Menu:.. │ │ │ │ │ +0001c3a0: 2a20 6163 6c6f 6361 6c20 4f70 7469 6f6e * aclocal Option │ │ │ │ │ +0001c3b0: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ +0001c3c0: 4f70 7469 6f6e 7320 7375 7070 6f72 7465 Options supporte │ │ │ │ │ +0001c3d0: 6420 6279 2061 636c 6f63 616c 0a2a 204d d by aclocal.* M │ │ │ │ │ +0001c3e0: 6163 726f 2053 6561 7263 6820 5061 7468 acro Search Path │ │ │ │ │ +0001c3f0: 3a3a 2020 2020 2020 2020 2020 2048 6f77 :: How │ │ │ │ │ +0001c400: 2061 636c 6f63 616c 2066 696e 6473 202e aclocal finds . │ │ │ │ │ +0001c410: 6d34 2066 696c 6573 0a2a 2045 7874 656e m4 files.* Exten │ │ │ │ │ +0001c420: 6469 6e67 2061 636c 6f63 616c 3a3a 2020 ding aclocal:: │ │ │ │ │ +0001c430: 2020 2020 2020 2020 2057 7269 7469 6e67 Writing │ │ │ │ │ +0001c440: 2079 6f75 7220 6f77 6e20 6163 6c6f 6361 your own acloca │ │ │ │ │ +0001c450: 6c20 6d61 6372 6f73 0a2a 204c 6f63 616c l macros.* Local │ │ │ │ │ +0001c460: 204d 6163 726f 733a 3a20 2020 2020 2020 Macros:: │ │ │ │ │ +0001c470: 2020 2020 2020 2020 204f 7267 616e 697a Organiz │ │ │ │ │ +0001c480: 696e 6720 6c6f 6361 6c20 6d61 6372 6f73 ing local macros │ │ │ │ │ +0001c490: 0a2a 2053 6572 6961 6c73 3a3a 2020 2020 .* Serials:: │ │ │ │ │ +0001c4a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0001c4b0: 2053 6572 6961 6c20 6c69 6e65 7320 696e Serial lines in │ │ │ │ │ +0001c4c0: 2041 7574 6f63 6f6e 6620 6d61 6372 6f73 Autoconf macros │ │ │ │ │ +0001c4d0: 0a2a 2046 7574 7572 6520 6f66 2061 636c .* Future of acl │ │ │ │ │ +0001c4e0: 6f63 616c 3a3a 2020 2020 2020 2020 2020 ocal:: │ │ │ │ │ +0001c4f0: 2061 636c 6f63 616c 2773 2073 6368 6564 aclocal's sched │ │ │ │ │ +0001c500: 756c 6564 2064 6561 7468 0a0a 1f0a 4669 uled death....Fi │ │ │ │ │ +0001c510: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +0001c520: 312e 696e 666f 2c20 204e 6f64 653a 2061 1.info, Node: a │ │ │ │ │ +0001c530: 636c 6f63 616c 204f 7074 696f 6e73 2c20 clocal Options, │ │ │ │ │ +0001c540: 204e 6578 743a 204d 6163 726f 2053 6561 Next: Macro Sea │ │ │ │ │ +0001c550: 7263 6820 5061 7468 2c20 2055 703a 2061 rch Path, Up: a │ │ │ │ │ +0001c560: 636c 6f63 616c 2049 6e76 6f63 6174 696f clocal Invocatio │ │ │ │ │ +0001c570: 6e0a 0a36 2e33 2e31 2061 636c 6f63 616c n..6.3.1 aclocal │ │ │ │ │ +0001c580: 204f 7074 696f 6e73 0a2d 2d2d 2d2d 2d2d Options.------- │ │ │ │ │ +0001c590: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0001c5a0: 2761 636c 6f63 616c 2720 6163 6365 7074 'aclocal' accept │ │ │ │ │ +0001c5b0: 7320 7468 6520 666f 6c6c 6f77 696e 6720 s the following │ │ │ │ │ +0001c5c0: 6f70 7469 6f6e 733a 0a0a 272d 2d61 7574 options:..'--aut │ │ │ │ │ +0001c5d0: 6f6d 616b 652d 6163 6469 723d 4449 5227 omake-acdir=DIR' │ │ │ │ │ +0001c5e0: 0a20 2020 2020 4c6f 6f6b 2066 6f72 2074 . Look for t │ │ │ │ │ +0001c5f0: 6865 2061 7574 6f6d 616b 652d 7072 6f76 he automake-prov │ │ │ │ │ +0001c600: 6964 6564 206d 6163 726f 2066 696c 6573 ided macro files │ │ │ │ │ +0001c610: 2069 6e20 4449 5220 696e 7374 6561 6420 in DIR instead │ │ │ │ │ +0001c620: 6f66 2069 6e20 7468 650a 2020 2020 2069 of in the. i │ │ │ │ │ +0001c630: 6e73 7461 6c6c 6174 696f 6e20 6469 7265 nstallation dire │ │ │ │ │ +0001c640: 6374 6f72 792e 2020 5468 6973 2069 7320 ctory. This is │ │ │ │ │ +0001c650: 7479 7069 6361 6c6c 7920 7573 6564 2066 typically used f │ │ │ │ │ +0001c660: 6f72 2064 6562 7567 6769 6e67 2e0a 0a27 or debugging...' │ │ │ │ │ +0001c670: 2d2d 7379 7374 656d 2d61 6364 6972 3d44 --system-acdir=D │ │ │ │ │ +0001c680: 4952 270a 2020 2020 204c 6f6f 6b20 666f IR'. Look fo │ │ │ │ │ +0001c690: 7220 7468 6520 7379 7374 656d 2d77 6964 r the system-wid │ │ │ │ │ +0001c6a0: 6520 7468 6972 642d 7061 7274 7920 6d61 e third-party ma │ │ │ │ │ +0001c6b0: 6372 6f20 6669 6c65 7320 2861 6e64 2074 cro files (and t │ │ │ │ │ +0001c6c0: 6865 2073 7065 6369 616c 0a20 2020 2020 he special. │ │ │ │ │ +0001c6d0: 2764 6972 6c69 7374 2720 6669 6c65 2920 'dirlist' file) │ │ │ │ │ +0001c6e0: 696e 2044 4952 2069 6e73 7465 6164 206f in DIR instead o │ │ │ │ │ +0001c6f0: 6620 696e 2074 6865 2069 6e73 7461 6c6c f in the install │ │ │ │ │ +0001c700: 6174 696f 6e20 6469 7265 6374 6f72 792e ation directory. │ │ │ │ │ +0001c710: 0a20 2020 2020 5468 6973 2069 7320 7479 . This is ty │ │ │ │ │ +0001c720: 7069 6361 6c6c 7920 7573 6564 2066 6f72 pically used for │ │ │ │ │ +0001c730: 2064 6562 7567 6769 6e67 2e0a 0a27 2d2d debugging...'-- │ │ │ │ │ +0001c740: 6163 6469 723d 4449 5227 0a20 2020 2020 acdir=DIR'. │ │ │ │ │ +0001c750: 5f44 6570 7265 6361 7465 645f 2073 686f _Deprecated_ sho │ │ │ │ │ +0001c760: 7274 6861 6e64 2066 6f72 2022 272d 2d61 rthand for "'--a │ │ │ │ │ +0001c770: 7574 6f6d 616b 652d 6163 6469 723d 4449 utomake-acdir=DI │ │ │ │ │ +0001c780: 520a 2020 2020 202d 2d73 7973 7465 6d2d R. --system- │ │ │ │ │ +0001c790: 6163 6469 723d 4449 5227 222e 2020 5769 acdir=DIR'". Wi │ │ │ │ │ +0001c7a0: 6c6c 2062 6520 7265 6d6f 7665 6420 696e ll be removed in │ │ │ │ │ +0001c7b0: 2066 7574 7572 6520 6163 6c6f 6361 6c20 future aclocal │ │ │ │ │ +0001c7c0: 7665 7273 696f 6e73 2e0a 0a27 2d2d 6469 versions...'--di │ │ │ │ │ +0001c7d0: 6666 5b3d 434f 4d4d 414e 445d 270a 2020 ff[=COMMAND]'. │ │ │ │ │ +0001c7e0: 2020 2052 756e 2043 4f4d 4d41 4e44 206f Run COMMAND o │ │ │ │ │ +0001c7f0: 6e20 4d34 2066 696c 6520 7468 6174 2077 n M4 file that w │ │ │ │ │ +0001c800: 6f75 6c64 2062 6520 696e 7374 616c 6c65 ould be installe │ │ │ │ │ +0001c810: 6420 6f72 206f 7665 7277 7269 7474 656e d or overwritten │ │ │ │ │ +0001c820: 2062 790a 2020 2020 2027 2d2d 696e 7374 by. '--inst │ │ │ │ │ +0001c830: 616c 6c27 2e20 2054 6865 2064 6566 6175 all'. The defau │ │ │ │ │ +0001c840: 6c74 2043 4f4d 4d41 4e44 2069 7320 2764 lt COMMAND is 'd │ │ │ │ │ +0001c850: 6966 6620 2d75 272e 2020 5468 6973 206f iff -u'. This o │ │ │ │ │ +0001c860: 7074 696f 6e0a 2020 2020 2069 6d70 6c69 ption. impli │ │ │ │ │ +0001c870: 6573 2027 2d2d 696e 7374 616c 6c27 2061 es '--install' a │ │ │ │ │ +0001c880: 6e64 2027 2d2d 6472 792d 7275 6e27 2e0a nd '--dry-run'.. │ │ │ │ │ +0001c890: 0a27 2d2d 6472 792d 7275 6e27 0a20 2020 .'--dry-run'. │ │ │ │ │ +0001c8a0: 2020 446f 206e 6f74 2061 6374 7561 6c6c Do not actuall │ │ │ │ │ +0001c8b0: 7920 6f76 6572 7772 6974 6520 286f 7220 y overwrite (or │ │ │ │ │ +0001c8c0: 6372 6561 7465 2920 2761 636c 6f63 616c create) 'aclocal │ │ │ │ │ +0001c8d0: 2e6d 3427 2061 6e64 204d 3420 6669 6c65 .m4' and M4 file │ │ │ │ │ +0001c8e0: 730a 2020 2020 2069 6e73 7461 6c6c 6564 s. installed │ │ │ │ │ +0001c8f0: 2062 7920 272d 2d69 6e73 7461 6c6c 272e by '--install'. │ │ │ │ │ +0001c900: 0a0a 272d 2d68 656c 7027 0a20 2020 2020 ..'--help'. │ │ │ │ │ +0001c910: 5072 696e 7420 6120 7375 6d6d 6172 7920 Print a summary │ │ │ │ │ +0001c920: 6f66 2074 6865 2063 6f6d 6d61 6e64 206c of the command l │ │ │ │ │ +0001c930: 696e 6520 6f70 7469 6f6e 7320 616e 6420 ine options and │ │ │ │ │ +0001c940: 6578 6974 2e0a 0a27 2d49 2044 4952 270a exit...'-I DIR'. │ │ │ │ │ +0001c950: 2020 2020 2041 6464 2074 6865 2064 6972 Add the dir │ │ │ │ │ +0001c960: 6563 746f 7279 2044 4952 2074 6f20 7468 ectory DIR to th │ │ │ │ │ +0001c970: 6520 6c69 7374 206f 6620 6469 7265 6374 e list of direct │ │ │ │ │ +0001c980: 6f72 6965 7320 7365 6172 6368 6564 2066 ories searched f │ │ │ │ │ +0001c990: 6f72 2027 2e6d 3427 0a20 2020 2020 6669 or '.m4'. fi │ │ │ │ │ +0001c9a0: 6c65 732e 0a0a 272d 2d69 6e73 7461 6c6c les...'--install │ │ │ │ │ +0001c9b0: 270a 2020 2020 2049 6e73 7461 6c6c 2073 '. Install s │ │ │ │ │ +0001c9c0: 7973 7465 6d2d 7769 6465 2074 6869 7264 ystem-wide third │ │ │ │ │ +0001c9d0: 2d70 6172 7479 206d 6163 726f 7320 696e -party macros in │ │ │ │ │ +0001c9e0: 746f 2074 6865 2066 6972 7374 2064 6972 to the first dir │ │ │ │ │ +0001c9f0: 6563 746f 7279 0a20 2020 2020 7370 6563 ectory. spec │ │ │ │ │ +0001ca00: 6966 6965 6420 7769 7468 2027 2d49 2044 ified with '-I D │ │ │ │ │ +0001ca10: 4952 2720 696e 7374 6561 6420 6f66 2063 IR' instead of c │ │ │ │ │ +0001ca20: 6f70 7969 6e67 2074 6865 6d20 696e 2074 opying them in t │ │ │ │ │ +0001ca30: 6865 206f 7574 7075 7420 6669 6c65 2e0a he output file.. │ │ │ │ │ +0001ca40: 2020 2020 204e 6f74 6520 7468 6174 2074 Note that t │ │ │ │ │ +0001ca50: 6869 7320 7769 6c6c 2068 6170 7065 6e20 his will happen │ │ │ │ │ +0001ca60: 616c 736f 2069 6620 4449 5220 6973 2061 also if DIR is a │ │ │ │ │ +0001ca70: 6e20 6162 736f 6c75 7465 2070 6174 682e n absolute path. │ │ │ │ │ +0001ca80: 0a0a 2020 2020 2057 6865 6e20 7468 6973 .. When this │ │ │ │ │ +0001ca90: 206f 7074 696f 6e20 6973 2075 7365 642c option is used, │ │ │ │ │ +0001caa0: 2061 6e64 206f 6e6c 7920 7768 656e 2074 and only when t │ │ │ │ │ +0001cab0: 6869 7320 6f70 7469 6f6e 2069 7320 7573 his option is us │ │ │ │ │ +0001cac0: 6564 2c0a 2020 2020 2027 6163 6c6f 6361 ed,. 'acloca │ │ │ │ │ +0001cad0: 6c27 2077 696c 6c20 616c 736f 2068 6f6e l' will also hon │ │ │ │ │ +0001cae0: 6f72 2027 2373 6572 6961 6c20 4e55 4d42 or '#serial NUMB │ │ │ │ │ +0001caf0: 4552 2720 6c69 6e65 7320 7468 6174 2061 ER' lines that a │ │ │ │ │ +0001cb00: 7070 6561 7220 696e 0a20 2020 2020 6d61 ppear in. ma │ │ │ │ │ +0001cb10: 6372 6f73 3a20 616e 204d 3420 6669 6c65 cros: an M4 file │ │ │ │ │ +0001cb20: 2069 7320 6967 6e6f 7265 6420 6966 2074 is ignored if t │ │ │ │ │ +0001cb30: 6865 7265 2065 7869 7374 7320 616e 6f74 here exists anot │ │ │ │ │ +0001cb40: 6865 7220 4d34 2066 696c 6520 7769 7468 her M4 file with │ │ │ │ │ +0001cb50: 0a20 2020 2020 7468 6520 7361 6d65 2062 . the same b │ │ │ │ │ +0001cb60: 6173 656e 616d 6520 616e 6420 6120 6772 asename and a gr │ │ │ │ │ +0001cb70: 6561 7465 7220 7365 7269 616c 206e 756d eater serial num │ │ │ │ │ +0001cb80: 6265 7220 696e 2074 6865 2073 6561 7263 ber in the searc │ │ │ │ │ +0001cb90: 6820 7061 7468 0a20 2020 2020 282a 6e6f h path. (*no │ │ │ │ │ +0001cba0: 7465 2053 6572 6961 6c73 3a3a 292e 0a0a te Serials::)... │ │ │ │ │ +0001cbb0: 272d 2d66 6f72 6365 270a 2020 2020 2041 '--force'. A │ │ │ │ │ +0001cbc0: 6c77 6179 7320 6f76 6572 7772 6974 6520 lways overwrite │ │ │ │ │ +0001cbd0: 7468 6520 6f75 7470 7574 2066 696c 652e the output file. │ │ │ │ │ +0001cbe0: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ │ +0001cbf0: 2074 6f20 6f76 6572 7772 6974 6520 7468 to overwrite th │ │ │ │ │ +0001cc00: 650a 2020 2020 206f 7574 7075 7420 6669 e. output fi │ │ │ │ │ +0001cc10: 6c65 206f 6e6c 7920 7768 656e 2072 6561 le only when rea │ │ │ │ │ +0001cc20: 6c6c 7920 6e65 6564 6564 2c20 692e 652e lly needed, i.e. │ │ │ │ │ +0001cc30: 2c20 7768 656e 2069 7473 2063 6f6e 7465 , when its conte │ │ │ │ │ +0001cc40: 6e74 730a 2020 2020 2063 6861 6e67 6573 nts. changes │ │ │ │ │ +0001cc50: 206f 7220 6966 206f 6e65 206f 6620 6974 or if one of it │ │ │ │ │ +0001cc60: 7320 6465 7065 6e64 656e 6369 6573 2069 s dependencies i │ │ │ │ │ +0001cc70: 7320 796f 756e 6765 722e 0a0a 2020 2020 s younger... │ │ │ │ │ +0001cc80: 2054 6869 7320 6f70 7469 6f6e 2066 6f72 This option for │ │ │ │ │ +0001cc90: 6365 7320 7468 6520 7570 6461 7465 206f ces the update o │ │ │ │ │ +0001cca0: 6620 2761 636c 6f63 616c 2e6d 3427 2028 f 'aclocal.m4' ( │ │ │ │ │ +0001ccb0: 6f72 2074 6865 2066 696c 650a 2020 2020 or the file. │ │ │ │ │ +0001ccc0: 2073 7065 6369 6669 6564 2077 6974 6820 specified with │ │ │ │ │ +0001ccd0: 272d 2d6f 7574 7075 7427 2062 656c 6f77 '--output' below │ │ │ │ │ +0001cce0: 2920 616e 6420 6f6e 6c79 2074 6869 7320 ) and only this │ │ │ │ │ +0001ccf0: 6669 6c65 2c20 6974 2068 6173 0a20 2020 file, it has. │ │ │ │ │ +0001cd00: 2020 6162 736f 6c75 7465 6c79 206e 6f20 absolutely no │ │ │ │ │ +0001cd10: 696e 666c 7565 6e63 6520 6f6e 2066 696c influence on fil │ │ │ │ │ +0001cd20: 6573 2074 6861 7420 6d61 7920 6e65 6564 es that may need │ │ │ │ │ +0001cd30: 2074 6f20 6265 2069 6e73 7461 6c6c 6564 to be installed │ │ │ │ │ +0001cd40: 2062 790a 2020 2020 2027 2d2d 696e 7374 by. '--inst │ │ │ │ │ +0001cd50: 616c 6c27 2e0a 0a27 2d2d 6f75 7470 7574 all'...'--output │ │ │ │ │ +0001cd60: 3d46 494c 4527 0a20 2020 2020 4361 7573 =FILE'. Caus │ │ │ │ │ +0001cd70: 6520 7468 6520 6f75 7470 7574 2074 6f20 e the output to │ │ │ │ │ +0001cd80: 6265 2070 7574 2069 6e74 6f20 4649 4c45 be put into FILE │ │ │ │ │ +0001cd90: 2069 6e73 7465 6164 206f 6620 2761 636c instead of 'acl │ │ │ │ │ +0001cda0: 6f63 616c 2e6d 3427 2e0a 0a27 2d2d 7072 ocal.m4'...'--pr │ │ │ │ │ +0001cdb0: 696e 742d 6163 2d64 6972 270a 2020 2020 int-ac-dir'. │ │ │ │ │ +0001cdc0: 2050 7269 6e74 7320 7468 6520 6e61 6d65 Prints the name │ │ │ │ │ +0001cdd0: 206f 6620 7468 6520 6469 7265 6374 6f72 of the director │ │ │ │ │ +0001cde0: 7920 7468 6174 2027 6163 6c6f 6361 6c27 y that 'aclocal' │ │ │ │ │ +0001cdf0: 2077 696c 6c20 7365 6172 6368 2074 6f20 will search to │ │ │ │ │ +0001ce00: 6669 6e64 0a20 2020 2020 7468 6972 642d find. third- │ │ │ │ │ +0001ce10: 7061 7274 7920 272e 6d34 2720 6669 6c65 party '.m4' file │ │ │ │ │ +0001ce20: 732e 2020 5768 656e 2074 6869 7320 6f70 s. When this op │ │ │ │ │ +0001ce30: 7469 6f6e 2069 7320 6769 7665 6e2c 206e tion is given, n │ │ │ │ │ +0001ce40: 6f72 6d61 6c0a 2020 2020 2070 726f 6365 ormal. proce │ │ │ │ │ +0001ce50: 7373 696e 6720 6973 2073 7570 7072 6573 ssing is suppres │ │ │ │ │ +0001ce60: 7365 642e 2020 5468 6973 206f 7074 696f sed. This optio │ │ │ │ │ +0001ce70: 6e20 7761 7320 7573 6564 205f 696e 2074 n was used _in t │ │ │ │ │ +0001ce80: 6865 2070 6173 745f 2062 790a 2020 2020 he past_ by. │ │ │ │ │ +0001ce90: 2074 6869 7264 2d70 6172 7479 2070 6163 third-party pac │ │ │ │ │ +0001cea0: 6b61 6765 7320 746f 2064 6574 6572 6d69 kages to determi │ │ │ │ │ +0001ceb0: 6e65 2077 6865 7265 2074 6f20 696e 7374 ne where to inst │ │ │ │ │ +0001cec0: 616c 6c20 272e 6d34 2720 6d61 6372 6f0a all '.m4' macro. │ │ │ │ │ +0001ced0: 2020 2020 2066 696c 6573 2c20 6275 7420 files, but │ │ │ │ │ +0001cee0: 5f74 6869 7320 7573 6167 6520 6973 2074 _this usage is t │ │ │ │ │ +0001cef0: 6f64 6179 2064 6973 636f 7572 6167 6564 oday discouraged │ │ │ │ │ +0001cf00: 5f2c 2073 696e 6365 2069 7420 6361 7573 _, since it caus │ │ │ │ │ +0001cf10: 6573 0a20 2020 2020 2724 2870 7265 6669 es. '$(prefi │ │ │ │ │ +0001cf20: 7829 2720 6e6f 7420 746f 2062 6520 7468 x)' not to be th │ │ │ │ │ +0001cf30: 6f72 6f75 6768 6c79 2068 6f6e 6f75 7265 oroughly honoure │ │ │ │ │ +0001cf40: 6420 2877 6869 6368 2076 696f 6c61 7465 d (which violate │ │ │ │ │ +0001cf50: 7320 7468 6520 474e 550a 2020 2020 2043 s the GNU. C │ │ │ │ │ +0001cf60: 6f64 696e 6720 5374 616e 6461 7264 7329 oding Standards) │ │ │ │ │ +0001cf70: 2c20 616e 6420 6120 7369 6d69 6c61 7220 , and a similar │ │ │ │ │ +0001cf80: 7365 6d61 6e74 6963 7320 6361 6e20 6265 semantics can be │ │ │ │ │ +0001cf90: 2062 6574 7465 7220 6f62 7461 696e 6564 better obtained │ │ │ │ │ +0001cfa0: 0a20 2020 2020 7769 7468 2074 6865 2027 . with the ' │ │ │ │ │ +0001cfb0: 4143 4c4f 4341 4c5f 5041 5448 2720 656e ACLOCAL_PATH' en │ │ │ │ │ +0001cfc0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +0001cfd0: 6c65 3b20 2a6e 6f74 6520 4578 7465 6e64 le; *note Extend │ │ │ │ │ +0001cfe0: 696e 670a 2020 2020 2061 636c 6f63 616c ing. aclocal │ │ │ │ │ +0001cff0: 3a3a 2e0a 0a27 2d2d 7665 7262 6f73 6527 ::...'--verbose' │ │ │ │ │ +0001d000: 0a20 2020 2020 5072 696e 7420 7468 6520 . Print the │ │ │ │ │ +0001d010: 6e61 6d65 7320 6f66 2074 6865 2066 696c names of the fil │ │ │ │ │ +0001d020: 6573 2069 7420 6578 616d 696e 6573 2e0a es it examines.. │ │ │ │ │ +0001d030: 0a27 2d2d 7665 7273 696f 6e27 0a20 2020 .'--version'. │ │ │ │ │ +0001d040: 2020 5072 696e 7420 7468 6520 7665 7273 Print the vers │ │ │ │ │ +0001d050: 696f 6e20 6e75 6d62 6572 206f 6620 4175 ion number of Au │ │ │ │ │ +0001d060: 746f 6d61 6b65 2061 6e64 2065 7869 742e tomake and exit. │ │ │ │ │ +0001d070: 0a0a 272d 5720 4341 5445 474f 5259 270a ..'-W CATEGORY'. │ │ │ │ │ +0001d080: 272d 2d77 6172 6e69 6e67 733d 4341 5445 '--warnings=CATE │ │ │ │ │ +0001d090: 474f 5259 270a 2020 2020 204f 7574 7075 GORY'. Outpu │ │ │ │ │ +0001d0a0: 7420 7761 726e 696e 6773 2066 616c 6c69 t warnings falli │ │ │ │ │ +0001d0b0: 6e67 2069 6e20 4341 5445 474f 5259 2e20 ng in CATEGORY. │ │ │ │ │ +0001d0c0: 2043 4154 4547 4f52 5920 6361 6e20 6265 CATEGORY can be │ │ │ │ │ +0001d0d0: 206f 6e65 206f 663a 0a20 2020 2020 2773 one of:. 's │ │ │ │ │ +0001d0e0: 796e 7461 7827 0a20 2020 2020 2020 2020 yntax'. │ │ │ │ │ +0001d0f0: 2064 7562 696f 7573 2073 796e 7461 6374 dubious syntact │ │ │ │ │ +0001d100: 6963 2063 6f6e 7374 7275 6374 732c 2075 ic constructs, u │ │ │ │ │ +0001d110: 6e64 6572 7175 6f74 6564 206d 6163 726f nderquoted macro │ │ │ │ │ +0001d120: 732c 2075 6e75 7365 640a 2020 2020 2020 s, unused. │ │ │ │ │ +0001d130: 2020 2020 6d61 6372 6f73 2c20 6574 632e macros, etc. │ │ │ │ │ +0001d140: 0a20 2020 2020 2775 6e73 7570 706f 7274 . 'unsupport │ │ │ │ │ +0001d150: 6564 270a 2020 2020 2020 2020 2020 756e ed'. un │ │ │ │ │ +0001d160: 6b6e 6f77 6e20 6d61 6372 6f73 0a20 2020 known macros. │ │ │ │ │ +0001d170: 2020 2761 6c6c 270a 2020 2020 2020 2020 'all'. │ │ │ │ │ +0001d180: 2020 616c 6c20 7468 6520 7761 726e 696e all the warnin │ │ │ │ │ +0001d190: 6773 2c20 7468 6973 2069 7320 7468 6520 gs, this is the │ │ │ │ │ +0001d1a0: 6465 6661 756c 740a 2020 2020 2027 6e6f default. 'no │ │ │ │ │ +0001d1b0: 6e65 270a 2020 2020 2020 2020 2020 7475 ne'. tu │ │ │ │ │ +0001d1c0: 726e 206f 6666 2061 6c6c 2074 6865 2077 rn off all the w │ │ │ │ │ +0001d1d0: 6172 6e69 6e67 730a 2020 2020 2027 6572 arnings. 'er │ │ │ │ │ +0001d1e0: 726f 7227 0a20 2020 2020 2020 2020 2074 ror'. t │ │ │ │ │ +0001d1f0: 7265 6174 2077 6172 6e69 6e67 7320 6173 reat warnings as │ │ │ │ │ +0001d200: 2065 7272 6f72 730a 0a20 2020 2020 416c errors.. Al │ │ │ │ │ +0001d210: 6c20 7761 726e 696e 6773 2061 7265 206f l warnings are o │ │ │ │ │ +0001d220: 7574 7075 7420 6279 2064 6566 6175 6c74 utput by default │ │ │ │ │ +0001d230: 2e0a 0a20 2020 2020 5468 6520 656e 7669 ... The envi │ │ │ │ │ +0001d240: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +0001d250: 2027 5741 524e 494e 4753 2720 6973 2068 'WARNINGS' is h │ │ │ │ │ +0001d260: 6f6e 6f72 6564 2069 6e20 7468 6520 7361 onored in the sa │ │ │ │ │ +0001d270: 6d65 2077 6179 2061 730a 2020 2020 2069 me way as. i │ │ │ │ │ +0001d280: 7420 6973 2066 6f72 2027 6175 746f 6d61 t is for 'automa │ │ │ │ │ +0001d290: 6b65 2720 282a 6e6f 7465 2061 7574 6f6d ke' (*note autom │ │ │ │ │ +0001d2a0: 616b 6520 496e 766f 6361 7469 6f6e 3a3a ake Invocation:: │ │ │ │ │ +0001d2b0: 292e 0a0a 1f0a 4669 6c65 3a20 6175 746f ).....File: auto │ │ │ │ │ +0001d2c0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +0001d2d0: 204e 6f64 653a 204d 6163 726f 2053 6561 Node: Macro Sea │ │ │ │ │ +0001d2e0: 7263 6820 5061 7468 2c20 204e 6578 743a rch Path, Next: │ │ │ │ │ +0001d2f0: 2045 7874 656e 6469 6e67 2061 636c 6f63 Extending acloc │ │ │ │ │ +0001d300: 616c 2c20 2050 7265 763a 2061 636c 6f63 al, Prev: acloc │ │ │ │ │ +0001d310: 616c 204f 7074 696f 6e73 2c20 2055 703a al Options, Up: │ │ │ │ │ +0001d320: 2061 636c 6f63 616c 2049 6e76 6f63 6174 aclocal Invocat │ │ │ │ │ +0001d330: 696f 6e0a 0a36 2e33 2e32 204d 6163 726f ion..6.3.2 Macro │ │ │ │ │ +0001d340: 2053 6561 7263 6820 5061 7468 0a2d 2d2d Search Path.--- │ │ │ │ │ 0001d350: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0001d360: 2d2d 0a0a 4279 2064 6566 6175 6c74 2c20 --..By default, │ │ │ │ │ -0001d370: 2761 636c 6f63 616c 2720 7365 6172 6368 'aclocal' search │ │ │ │ │ -0001d380: 6573 2066 6f72 2027 2e6d 3427 2066 696c es for '.m4' fil │ │ │ │ │ -0001d390: 6573 2069 6e20 7468 6520 666f 6c6c 6f77 es in the follow │ │ │ │ │ -0001d3a0: 696e 670a 6469 7265 6374 6f72 6965 732c ing.directories, │ │ │ │ │ -0001d3b0: 2069 6e20 7468 6973 206f 7264 6572 3a0a in this order:. │ │ │ │ │ -0001d3c0: 0a27 4143 4449 522d 4150 4956 4552 5349 .'ACDIR-APIVERSI │ │ │ │ │ -0001d3d0: 4f4e 270a 2020 2020 2054 6869 7320 6973 ON'. This is │ │ │ │ │ -0001d3e0: 2077 6865 7265 2074 6865 2027 2e6d 3427 where the '.m4' │ │ │ │ │ -0001d3f0: 206d 6163 726f 7320 6469 7374 7269 6275 macros distribu │ │ │ │ │ -0001d400: 7465 6420 7769 7468 2041 7574 6f6d 616b ted with Automak │ │ │ │ │ -0001d410: 6520 6974 7365 6c66 2061 7265 0a20 2020 e itself are. │ │ │ │ │ -0001d420: 2020 7374 6f72 6564 2e20 2041 5049 5645 stored. APIVE │ │ │ │ │ -0001d430: 5253 494f 4e20 6465 7065 6e64 7320 6f6e RSION depends on │ │ │ │ │ -0001d440: 2074 6865 2041 7574 6f6d 616b 6520 7265 the Automake re │ │ │ │ │ -0001d450: 6c65 6173 6520 7573 6564 3b20 666f 720a lease used; for. │ │ │ │ │ -0001d460: 2020 2020 2065 7861 6d70 6c65 2c20 666f example, fo │ │ │ │ │ -0001d470: 7220 4175 746f 6d61 6b65 2031 2e31 312e r Automake 1.11. │ │ │ │ │ -0001d480: 782c 2041 5049 5645 5253 494f 4e20 3d20 x, APIVERSION = │ │ │ │ │ -0001d490: 2731 2e31 3127 2e0a 0a27 4143 4449 5227 '1.11'...'ACDIR' │ │ │ │ │ -0001d4a0: 0a20 2020 2020 5468 6973 2064 6972 6563 . This direc │ │ │ │ │ -0001d4b0: 746f 7279 2069 7320 696e 7465 6e64 6564 tory is intended │ │ │ │ │ -0001d4c0: 2066 6f72 2074 6869 7264 2070 6172 7479 for third party │ │ │ │ │ -0001d4d0: 2027 2e6d 3427 2066 696c 6573 2c20 616e '.m4' files, an │ │ │ │ │ -0001d4e0: 6420 6973 0a20 2020 2020 636f 6e66 6967 d is. config │ │ │ │ │ -0001d4f0: 7572 6564 2077 6865 6e20 2761 7574 6f6d ured when 'autom │ │ │ │ │ -0001d500: 616b 6527 2069 7473 656c 6620 6973 2062 ake' itself is b │ │ │ │ │ -0001d510: 7569 6c74 2e20 2054 6869 7320 6973 0a20 uilt. This is. │ │ │ │ │ -0001d520: 2020 2020 2740 6461 7461 6469 7240 2f61 '@datadir@/a │ │ │ │ │ -0001d530: 636c 6f63 616c 2f27 2c20 7768 6963 6820 clocal/', which │ │ │ │ │ -0001d540: 7479 7069 6361 6c6c 7920 6578 7061 6e64 typically expand │ │ │ │ │ -0001d550: 7320 746f 0a20 2020 2020 2724 7b70 7265 s to. '${pre │ │ │ │ │ -0001d560: 6669 787d 2f73 6861 7265 2f61 636c 6f63 fix}/share/acloc │ │ │ │ │ -0001d570: 616c 2f27 2e20 2054 6f20 6669 6e64 2074 al/'. To find t │ │ │ │ │ -0001d580: 6865 2063 6f6d 7069 6c65 642d 696e 2076 he compiled-in v │ │ │ │ │ -0001d590: 616c 7565 206f 660a 2020 2020 2041 4344 alue of. ACD │ │ │ │ │ -0001d5a0: 4952 2c20 7573 6520 7468 6520 272d 2d70 IR, use the '--p │ │ │ │ │ -0001d5b0: 7269 6e74 2d61 632d 6469 7227 206f 7074 rint-ac-dir' opt │ │ │ │ │ -0001d5c0: 696f 6e20 282a 6e6f 7465 2061 636c 6f63 ion (*note acloc │ │ │ │ │ -0001d5d0: 616c 204f 7074 696f 6e73 3a3a 292e 0a0a al Options::)... │ │ │ │ │ -0001d5e0: 2020 2041 7320 616e 2065 7861 6d70 6c65 As an example │ │ │ │ │ -0001d5f0: 2c20 7375 7070 6f73 6520 7468 6174 2027 , suppose that ' │ │ │ │ │ -0001d600: 6175 746f 6d61 6b65 2d31 2e31 312e 3227 automake-1.11.2' │ │ │ │ │ -0001d610: 2077 6173 2063 6f6e 6669 6775 7265 6420 was configured │ │ │ │ │ -0001d620: 7769 7468 0a27 2d2d 7072 6566 6978 3d2f with.'--prefix=/ │ │ │ │ │ -0001d630: 7573 722f 6c6f 6361 6c27 2e20 2054 6865 usr/local'. The │ │ │ │ │ -0001d640: 6e2c 2074 6865 2073 6561 7263 6820 7061 n, the search pa │ │ │ │ │ -0001d650: 7468 2077 6f75 6c64 2062 653a 0a0a 2020 th would be:.. │ │ │ │ │ -0001d660: 312e 2027 2f75 7372 2f6c 6f63 616c 2f73 1. '/usr/local/s │ │ │ │ │ -0001d670: 6861 7265 2f61 636c 6f63 616c 2d31 2e31 hare/aclocal-1.1 │ │ │ │ │ -0001d680: 312e 322f 270a 2020 322e 2027 2f75 7372 1.2/'. 2. '/usr │ │ │ │ │ -0001d690: 2f6c 6f63 616c 2f73 6861 7265 2f61 636c /local/share/acl │ │ │ │ │ -0001d6a0: 6f63 616c 2f27 0a0a 2020 2054 6865 2070 ocal/'.. The p │ │ │ │ │ -0001d6b0: 6174 6873 2066 6f72 2074 6865 2041 4344 aths for the ACD │ │ │ │ │ -0001d6c0: 4952 2061 6e64 2041 4344 4952 2d41 5049 IR and ACDIR-API │ │ │ │ │ -0001d6d0: 5645 5253 494f 4e20 6469 7265 6374 6f72 VERSION director │ │ │ │ │ -0001d6e0: 6965 7320 6361 6e20 6265 0a63 6861 6e67 ies can be.chang │ │ │ │ │ -0001d6f0: 6564 2072 6573 7065 6374 6976 656c 7920 ed respectively │ │ │ │ │ -0001d700: 7468 726f 7567 6820 6163 6c6f 6361 6c20 through aclocal │ │ │ │ │ -0001d710: 6f70 7469 6f6e 7320 272d 2d73 7973 7465 options '--syste │ │ │ │ │ -0001d720: 6d2d 6163 6469 7227 2061 6e64 0a27 2d2d m-acdir' and.'-- │ │ │ │ │ -0001d730: 6175 746f 6d61 6b65 2d61 6364 6972 2720 automake-acdir' │ │ │ │ │ -0001d740: 282a 6e6f 7465 2061 636c 6f63 616c 204f (*note aclocal O │ │ │ │ │ -0001d750: 7074 696f 6e73 3a3a 292e 2020 4e6f 7465 ptions::). Note │ │ │ │ │ -0001d760: 2068 6f77 6576 6572 2074 6861 7420 7468 however that th │ │ │ │ │ -0001d770: 6573 650a 6f70 7469 6f6e 7320 6172 6520 ese.options are │ │ │ │ │ -0001d780: 6f6e 6c79 2069 6e74 656e 6465 6420 666f only intended fo │ │ │ │ │ -0001d790: 7220 7573 6520 6279 2074 6865 2069 6e74 r use by the int │ │ │ │ │ -0001d7a0: 6572 6e61 6c20 4175 746f 6d61 6b65 2074 ernal Automake t │ │ │ │ │ -0001d7b0: 6573 7420 7375 6974 652c 0a6f 7220 666f est suite,.or fo │ │ │ │ │ -0001d7c0: 7220 6465 6275 6767 696e 6720 756e 6465 r debugging unde │ │ │ │ │ -0001d7d0: 7220 6869 6768 6c79 2075 6e75 7375 616c r highly unusual │ │ │ │ │ -0001d7e0: 2073 6974 7561 7469 6f6e 733b 2074 6865 situations; the │ │ │ │ │ -0001d7f0: 7920 6172 6520 6e6f 740a 6f72 6469 6e61 y are not.ordina │ │ │ │ │ -0001d800: 7269 6c79 206e 6565 6465 6420 6279 2065 rily needed by e │ │ │ │ │ -0001d810: 6e64 2d75 7365 7273 2e0a 0a20 2020 4173 nd-users... As │ │ │ │ │ -0001d820: 2065 7870 6c61 696e 6564 2069 6e20 282a explained in (* │ │ │ │ │ -0001d830: 6e6f 7465 2061 636c 6f63 616c 204f 7074 note aclocal Opt │ │ │ │ │ -0001d840: 696f 6e73 3a3a 292c 2074 6865 7265 2061 ions::), there a │ │ │ │ │ -0001d850: 7265 2073 6576 6572 616c 206f 7074 696f re several optio │ │ │ │ │ -0001d860: 6e73 0a74 6861 7420 6361 6e20 6265 2075 ns.that can be u │ │ │ │ │ -0001d870: 7365 6420 746f 2063 6861 6e67 6520 6f72 sed to change or │ │ │ │ │ -0001d880: 2065 7874 656e 6420 7468 6973 2073 6561 extend this sea │ │ │ │ │ -0001d890: 7263 6820 7061 7468 2e0a 0a4d 6f64 6966 rch path...Modif │ │ │ │ │ -0001d8a0: 7969 6e67 2074 6865 204d 6163 726f 2053 ying the Macro S │ │ │ │ │ -0001d8b0: 6561 7263 6820 5061 7468 3a20 272d 4920 earch Path: '-I │ │ │ │ │ -0001d8c0: 4449 5227 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e DIR'............ │ │ │ │ │ +0001d360: 2d2d 2d2d 0a0a 4279 2064 6566 6175 6c74 ----..By default │ │ │ │ │ +0001d370: 2c20 2761 636c 6f63 616c 2720 7365 6172 , 'aclocal' sear │ │ │ │ │ +0001d380: 6368 6573 2066 6f72 2027 2e6d 3427 2066 ches for '.m4' f │ │ │ │ │ +0001d390: 696c 6573 2069 6e20 7468 6520 666f 6c6c iles in the foll │ │ │ │ │ +0001d3a0: 6f77 696e 670a 6469 7265 6374 6f72 6965 owing.directorie │ │ │ │ │ +0001d3b0: 732c 2069 6e20 7468 6973 206f 7264 6572 s, in this order │ │ │ │ │ +0001d3c0: 3a0a 0a27 4143 4449 522d 4150 4956 4552 :..'ACDIR-APIVER │ │ │ │ │ +0001d3d0: 5349 4f4e 270a 2020 2020 2054 6869 7320 SION'. This │ │ │ │ │ +0001d3e0: 6973 2077 6865 7265 2074 6865 2027 2e6d is where the '.m │ │ │ │ │ +0001d3f0: 3427 206d 6163 726f 7320 6469 7374 7269 4' macros distri │ │ │ │ │ +0001d400: 6275 7465 6420 7769 7468 2041 7574 6f6d buted with Autom │ │ │ │ │ +0001d410: 616b 6520 6974 7365 6c66 2061 7265 0a20 ake itself are. │ │ │ │ │ +0001d420: 2020 2020 7374 6f72 6564 2e20 2041 5049 stored. API │ │ │ │ │ +0001d430: 5645 5253 494f 4e20 6465 7065 6e64 7320 VERSION depends │ │ │ │ │ +0001d440: 6f6e 2074 6865 2041 7574 6f6d 616b 6520 on the Automake │ │ │ │ │ +0001d450: 7265 6c65 6173 6520 7573 6564 3b20 666f release used; fo │ │ │ │ │ +0001d460: 720a 2020 2020 2065 7861 6d70 6c65 2c20 r. example, │ │ │ │ │ +0001d470: 666f 7220 4175 746f 6d61 6b65 2031 2e31 for Automake 1.1 │ │ │ │ │ +0001d480: 312e 782c 2041 5049 5645 5253 494f 4e20 1.x, APIVERSION │ │ │ │ │ +0001d490: 3d20 2731 2e31 3127 2e0a 0a27 4143 4449 = '1.11'...'ACDI │ │ │ │ │ +0001d4a0: 5227 0a20 2020 2020 5468 6973 2064 6972 R'. This dir │ │ │ │ │ +0001d4b0: 6563 746f 7279 2069 7320 696e 7465 6e64 ectory is intend │ │ │ │ │ +0001d4c0: 6564 2066 6f72 2074 6869 7264 2070 6172 ed for third par │ │ │ │ │ +0001d4d0: 7479 2027 2e6d 3427 2066 696c 6573 2c20 ty '.m4' files, │ │ │ │ │ +0001d4e0: 616e 6420 6973 0a20 2020 2020 636f 6e66 and is. conf │ │ │ │ │ +0001d4f0: 6967 7572 6564 2077 6865 6e20 2761 7574 igured when 'aut │ │ │ │ │ +0001d500: 6f6d 616b 6527 2069 7473 656c 6620 6973 omake' itself is │ │ │ │ │ +0001d510: 2062 7569 6c74 2e20 2054 6869 7320 6973 built. This is │ │ │ │ │ +0001d520: 0a20 2020 2020 2740 6461 7461 6469 7240 . '@datadir@ │ │ │ │ │ +0001d530: 2f61 636c 6f63 616c 2f27 2c20 7768 6963 /aclocal/', whic │ │ │ │ │ +0001d540: 6820 7479 7069 6361 6c6c 7920 6578 7061 h typically expa │ │ │ │ │ +0001d550: 6e64 7320 746f 0a20 2020 2020 2724 7b70 nds to. '${p │ │ │ │ │ +0001d560: 7265 6669 787d 2f73 6861 7265 2f61 636c refix}/share/acl │ │ │ │ │ +0001d570: 6f63 616c 2f27 2e20 2054 6f20 6669 6e64 ocal/'. To find │ │ │ │ │ +0001d580: 2074 6865 2063 6f6d 7069 6c65 642d 696e the compiled-in │ │ │ │ │ +0001d590: 2076 616c 7565 206f 660a 2020 2020 2041 value of. A │ │ │ │ │ +0001d5a0: 4344 4952 2c20 7573 6520 7468 6520 272d CDIR, use the '- │ │ │ │ │ +0001d5b0: 2d70 7269 6e74 2d61 632d 6469 7227 206f -print-ac-dir' o │ │ │ │ │ +0001d5c0: 7074 696f 6e20 282a 6e6f 7465 2061 636c ption (*note acl │ │ │ │ │ +0001d5d0: 6f63 616c 204f 7074 696f 6e73 3a3a 292e ocal Options::). │ │ │ │ │ +0001d5e0: 0a0a 2020 2041 7320 616e 2065 7861 6d70 .. As an examp │ │ │ │ │ +0001d5f0: 6c65 2c20 7375 7070 6f73 6520 7468 6174 le, suppose that │ │ │ │ │ +0001d600: 2027 6175 746f 6d61 6b65 2d31 2e31 312e 'automake-1.11. │ │ │ │ │ +0001d610: 3227 2077 6173 2063 6f6e 6669 6775 7265 2' was configure │ │ │ │ │ +0001d620: 6420 7769 7468 0a27 2d2d 7072 6566 6978 d with.'--prefix │ │ │ │ │ +0001d630: 3d2f 7573 722f 6c6f 6361 6c27 2e20 2054 =/usr/local'. T │ │ │ │ │ +0001d640: 6865 6e2c 2074 6865 2073 6561 7263 6820 hen, the search │ │ │ │ │ +0001d650: 7061 7468 2077 6f75 6c64 2062 653a 0a0a path would be:.. │ │ │ │ │ +0001d660: 2020 312e 2027 2f75 7372 2f6c 6f63 616c 1. '/usr/local │ │ │ │ │ +0001d670: 2f73 6861 7265 2f61 636c 6f63 616c 2d31 /share/aclocal-1 │ │ │ │ │ +0001d680: 2e31 312e 322f 270a 2020 322e 2027 2f75 .11.2/'. 2. '/u │ │ │ │ │ +0001d690: 7372 2f6c 6f63 616c 2f73 6861 7265 2f61 sr/local/share/a │ │ │ │ │ +0001d6a0: 636c 6f63 616c 2f27 0a0a 2020 2054 6865 clocal/'.. The │ │ │ │ │ +0001d6b0: 2070 6174 6873 2066 6f72 2074 6865 2041 paths for the A │ │ │ │ │ +0001d6c0: 4344 4952 2061 6e64 2041 4344 4952 2d41 CDIR and ACDIR-A │ │ │ │ │ +0001d6d0: 5049 5645 5253 494f 4e20 6469 7265 6374 PIVERSION direct │ │ │ │ │ +0001d6e0: 6f72 6965 7320 6361 6e20 6265 0a63 6861 ories can be.cha │ │ │ │ │ +0001d6f0: 6e67 6564 2072 6573 7065 6374 6976 656c nged respectivel │ │ │ │ │ +0001d700: 7920 7468 726f 7567 6820 6163 6c6f 6361 y through acloca │ │ │ │ │ +0001d710: 6c20 6f70 7469 6f6e 7320 272d 2d73 7973 l options '--sys │ │ │ │ │ +0001d720: 7465 6d2d 6163 6469 7227 2061 6e64 0a27 tem-acdir' and.' │ │ │ │ │ +0001d730: 2d2d 6175 746f 6d61 6b65 2d61 6364 6972 --automake-acdir │ │ │ │ │ +0001d740: 2720 282a 6e6f 7465 2061 636c 6f63 616c ' (*note aclocal │ │ │ │ │ +0001d750: 204f 7074 696f 6e73 3a3a 292e 2020 4e6f Options::). No │ │ │ │ │ +0001d760: 7465 2068 6f77 6576 6572 2074 6861 7420 te however that │ │ │ │ │ +0001d770: 7468 6573 650a 6f70 7469 6f6e 7320 6172 these.options ar │ │ │ │ │ +0001d780: 6520 6f6e 6c79 2069 6e74 656e 6465 6420 e only intended │ │ │ │ │ +0001d790: 666f 7220 7573 6520 6279 2074 6865 2069 for use by the i │ │ │ │ │ +0001d7a0: 6e74 6572 6e61 6c20 4175 746f 6d61 6b65 nternal Automake │ │ │ │ │ +0001d7b0: 2074 6573 7420 7375 6974 652c 0a6f 7220 test suite,.or │ │ │ │ │ +0001d7c0: 666f 7220 6465 6275 6767 696e 6720 756e for debugging un │ │ │ │ │ +0001d7d0: 6465 7220 6869 6768 6c79 2075 6e75 7375 der highly unusu │ │ │ │ │ +0001d7e0: 616c 2073 6974 7561 7469 6f6e 733b 2074 al situations; t │ │ │ │ │ +0001d7f0: 6865 7920 6172 6520 6e6f 740a 6f72 6469 hey are not.ordi │ │ │ │ │ +0001d800: 6e61 7269 6c79 206e 6565 6465 6420 6279 narily needed by │ │ │ │ │ +0001d810: 2065 6e64 2d75 7365 7273 2e0a 0a20 2020 end-users... │ │ │ │ │ +0001d820: 4173 2065 7870 6c61 696e 6564 2069 6e20 As explained in │ │ │ │ │ +0001d830: 282a 6e6f 7465 2061 636c 6f63 616c 204f (*note aclocal O │ │ │ │ │ +0001d840: 7074 696f 6e73 3a3a 292c 2074 6865 7265 ptions::), there │ │ │ │ │ +0001d850: 2061 7265 2073 6576 6572 616c 206f 7074 are several opt │ │ │ │ │ +0001d860: 696f 6e73 0a74 6861 7420 6361 6e20 6265 ions.that can be │ │ │ │ │ +0001d870: 2075 7365 6420 746f 2063 6861 6e67 6520 used to change │ │ │ │ │ +0001d880: 6f72 2065 7874 656e 6420 7468 6973 2073 or extend this s │ │ │ │ │ +0001d890: 6561 7263 6820 7061 7468 2e0a 0a4d 6f64 earch path...Mod │ │ │ │ │ +0001d8a0: 6966 7969 6e67 2074 6865 204d 6163 726f ifying the Macro │ │ │ │ │ +0001d8b0: 2053 6561 7263 6820 5061 7468 3a20 272d Search Path: '- │ │ │ │ │ +0001d8c0: 4920 4449 5227 0a2e 2e2e 2e2e 2e2e 2e2e I DIR'.......... │ │ │ │ │ 0001d8d0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0001d8e0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 0a0a ................ │ │ │ │ │ -0001d8f0: 416e 7920 6578 7472 6120 6469 7265 6374 Any extra direct │ │ │ │ │ -0001d900: 6f72 6965 7320 7370 6563 6966 6965 6420 ories specified │ │ │ │ │ -0001d910: 7573 696e 6720 272d 4927 206f 7074 696f using '-I' optio │ │ │ │ │ -0001d920: 6e73 2028 2a6e 6f74 6520 6163 6c6f 6361 ns (*note acloca │ │ │ │ │ -0001d930: 6c0a 4f70 7469 6f6e 733a 3a29 2061 7265 l.Options::) are │ │ │ │ │ -0001d940: 205f 7072 6570 656e 6465 645f 2074 6f20 _prepended_ to │ │ │ │ │ -0001d950: 7468 6973 2073 6561 7263 6820 6c69 7374 this search list │ │ │ │ │ -0001d960: 2e20 2054 6875 732c 2027 6163 6c6f 6361 . Thus, 'acloca │ │ │ │ │ -0001d970: 6c20 2d49 202f 666f 6f0a 2d49 202f 6261 l -I /foo.-I /ba │ │ │ │ │ -0001d980: 7227 2072 6573 756c 7473 2069 6e20 7468 r' results in th │ │ │ │ │ -0001d990: 6520 666f 6c6c 6f77 696e 6720 7365 6172 e following sear │ │ │ │ │ -0001d9a0: 6368 2070 6174 683a 0a0a 2020 312e 2027 ch path:.. 1. ' │ │ │ │ │ -0001d9b0: 2f66 6f6f 270a 2020 322e 2027 2f62 6172 /foo'. 2. '/bar │ │ │ │ │ -0001d9c0: 270a 2020 332e 2041 4344 4952 2d41 5049 '. 3. ACDIR-API │ │ │ │ │ -0001d9d0: 5645 5253 494f 4e0a 2020 342e 2041 4344 VERSION. 4. ACD │ │ │ │ │ -0001d9e0: 4952 0a0a 4d6f 6469 6679 696e 6720 7468 IR..Modifying th │ │ │ │ │ -0001d9f0: 6520 4d61 6372 6f20 5365 6172 6368 2050 e Macro Search P │ │ │ │ │ -0001da00: 6174 683a 2027 6469 726c 6973 7427 0a2e ath: 'dirlist'.. │ │ │ │ │ -0001da10: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ +0001d8e0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ +0001d8f0: 0a0a 416e 7920 6578 7472 6120 6469 7265 ..Any extra dire │ │ │ │ │ +0001d900: 6374 6f72 6965 7320 7370 6563 6966 6965 ctories specifie │ │ │ │ │ +0001d910: 6420 7573 696e 6720 272d 4927 206f 7074 d using '-I' opt │ │ │ │ │ +0001d920: 696f 6e73 2028 2a6e 6f74 6520 6163 6c6f ions (*note aclo │ │ │ │ │ +0001d930: 6361 6c0a 4f70 7469 6f6e 733a 3a29 2061 cal.Options::) a │ │ │ │ │ +0001d940: 7265 205f 7072 6570 656e 6465 645f 2074 re _prepended_ t │ │ │ │ │ +0001d950: 6f20 7468 6973 2073 6561 7263 6820 6c69 o this search li │ │ │ │ │ +0001d960: 7374 2e20 2054 6875 732c 2027 6163 6c6f st. Thus, 'aclo │ │ │ │ │ +0001d970: 6361 6c20 2d49 202f 666f 6f0a 2d49 202f cal -I /foo.-I / │ │ │ │ │ +0001d980: 6261 7227 2072 6573 756c 7473 2069 6e20 bar' results in │ │ │ │ │ +0001d990: 7468 6520 666f 6c6c 6f77 696e 6720 7365 the following se │ │ │ │ │ +0001d9a0: 6172 6368 2070 6174 683a 0a0a 2020 312e arch path:.. 1. │ │ │ │ │ +0001d9b0: 2027 2f66 6f6f 270a 2020 322e 2027 2f62 '/foo'. 2. '/b │ │ │ │ │ +0001d9c0: 6172 270a 2020 332e 2041 4344 4952 2d41 ar'. 3. ACDIR-A │ │ │ │ │ +0001d9d0: 5049 5645 5253 494f 4e0a 2020 342e 2041 PIVERSION. 4. A │ │ │ │ │ +0001d9e0: 4344 4952 0a0a 4d6f 6469 6679 696e 6720 CDIR..Modifying │ │ │ │ │ +0001d9f0: 7468 6520 4d61 6372 6f20 5365 6172 6368 the Macro Search │ │ │ │ │ +0001da00: 2050 6174 683a 2027 6469 726c 6973 7427 Path: 'dirlist' │ │ │ │ │ +0001da10: 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 0001da20: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0001da30: 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 6865 7265 ...........There │ │ │ │ │ -0001da40: 2069 7320 6120 7468 6972 6420 6d65 6368 is a third mech │ │ │ │ │ -0001da50: 616e 6973 6d20 666f 7220 6375 7374 6f6d anism for custom │ │ │ │ │ -0001da60: 697a 696e 6720 7468 6520 7365 6172 6368 izing the search │ │ │ │ │ -0001da70: 2070 6174 682e 2020 4966 2061 0a27 6469 path. If a.'di │ │ │ │ │ -0001da80: 726c 6973 7427 2066 696c 6520 6578 6973 rlist' file exis │ │ │ │ │ -0001da90: 7473 2069 6e20 4143 4449 522c 2074 6865 ts in ACDIR, the │ │ │ │ │ -0001daa0: 6e20 7468 6174 2066 696c 6520 6973 2061 n that file is a │ │ │ │ │ -0001dab0: 7373 756d 6564 2074 6f20 636f 6e74 6169 ssumed to contai │ │ │ │ │ -0001dac0: 6e20 610a 6c69 7374 206f 6620 6469 7265 n a.list of dire │ │ │ │ │ -0001dad0: 6374 6f72 7920 7061 7474 6572 6e73 2c20 ctory patterns, │ │ │ │ │ -0001dae0: 6f6e 6520 7065 7220 6c69 6e65 2e20 2027 one per line. ' │ │ │ │ │ -0001daf0: 6163 6c6f 6361 6c27 2065 7870 616e 6473 aclocal' expands │ │ │ │ │ -0001db00: 2074 6865 7365 0a70 6174 7465 726e 7320 these.patterns │ │ │ │ │ -0001db10: 746f 2064 6972 6563 746f 7279 206e 616d to directory nam │ │ │ │ │ -0001db20: 6573 2c20 616e 6420 6164 6473 2074 6865 es, and adds the │ │ │ │ │ -0001db30: 6d20 746f 2074 6865 2073 6561 7263 6820 m to the search │ │ │ │ │ -0001db40: 6c69 7374 205f 6166 7465 725f 0a61 6c6c list _after_.all │ │ │ │ │ -0001db50: 206f 7468 6572 2064 6972 6563 746f 7269 other directori │ │ │ │ │ -0001db60: 6573 2e20 2027 6469 726c 6973 7427 2065 es. 'dirlist' e │ │ │ │ │ -0001db70: 6e74 7269 6573 206d 6179 2075 7365 2073 ntries may use s │ │ │ │ │ -0001db80: 6865 6c6c 2077 696c 6463 6172 6473 2073 hell wildcards s │ │ │ │ │ -0001db90: 7563 680a 6173 2027 2a27 2c20 273f 272c uch.as '*', '?', │ │ │ │ │ -0001dba0: 206f 7220 275b 2e2e 2e5d 272e 0a0a 2020 or '[...]'... │ │ │ │ │ -0001dbb0: 2046 6f72 2065 7861 6d70 6c65 2c20 7375 For example, su │ │ │ │ │ -0001dbc0: 7070 6f73 6520 2741 4344 4952 2f64 6972 ppose 'ACDIR/dir │ │ │ │ │ -0001dbd0: 6c69 7374 2720 636f 6e74 6169 6e73 2074 list' contains t │ │ │ │ │ -0001dbe0: 6865 2066 6f6c 6c6f 7769 6e67 3a0a 0a20 he following:.. │ │ │ │ │ -0001dbf0: 2020 2020 2f74 6573 7431 0a20 2020 2020 /test1. │ │ │ │ │ -0001dc00: 2f74 6573 7432 0a20 2020 2020 2f74 6573 /test2. /tes │ │ │ │ │ -0001dc10: 7433 2a0a 0a61 6e64 2074 6861 7420 2761 t3*..and that 'a │ │ │ │ │ -0001dc20: 636c 6f63 616c 2720 7761 7320 6361 6c6c clocal' was call │ │ │ │ │ -0001dc30: 6564 2077 6974 6820 7468 6520 272d 4920 ed with the '-I │ │ │ │ │ -0001dc40: 2f66 6f6f 202d 4920 2f62 6172 2720 6f70 /foo -I /bar' op │ │ │ │ │ -0001dc50: 7469 6f6e 732e 2020 5468 656e 2c0a 7468 tions. Then,.th │ │ │ │ │ -0001dc60: 6520 7365 6172 6368 2070 6174 6820 776f e search path wo │ │ │ │ │ -0001dc70: 756c 6420 6265 0a0a 2020 312e 2027 2f66 uld be.. 1. '/f │ │ │ │ │ -0001dc80: 6f6f 270a 2020 322e 2027 2f62 6172 270a oo'. 2. '/bar'. │ │ │ │ │ -0001dc90: 2020 332e 2041 4344 4952 2d41 5049 5645 3. ACDIR-APIVE │ │ │ │ │ -0001dca0: 5253 494f 4e0a 2020 342e 2041 4344 4952 RSION. 4. ACDIR │ │ │ │ │ -0001dcb0: 0a20 2035 2e20 272f 7465 7374 3127 0a20 . 5. '/test1'. │ │ │ │ │ -0001dcc0: 2036 2e20 272f 7465 7374 3227 0a0a 616e 6. '/test2'..an │ │ │ │ │ -0001dcd0: 6420 616c 6c20 6469 7265 6374 6f72 6965 d all directorie │ │ │ │ │ -0001dce0: 7320 7769 7468 2070 6174 6820 6e61 6d65 s with path name │ │ │ │ │ -0001dcf0: 7320 7374 6172 7469 6e67 2077 6974 6820 s starting with │ │ │ │ │ -0001dd00: 272f 7465 7374 3327 2e0a 0a20 2020 4966 '/test3'... If │ │ │ │ │ -0001dd10: 2074 6865 2027 2d2d 7379 7374 656d 2d61 the '--system-a │ │ │ │ │ -0001dd20: 6364 6972 3d44 4952 2720 6f70 7469 6f6e cdir=DIR' option │ │ │ │ │ -0001dd30: 2069 7320 7573 6564 2c20 7468 656e 2027 is used, then ' │ │ │ │ │ -0001dd40: 6163 6c6f 6361 6c27 2077 696c 6c0a 7365 aclocal' will.se │ │ │ │ │ -0001dd50: 6172 6368 2066 6f72 2074 6865 2027 6469 arch for the 'di │ │ │ │ │ -0001dd60: 726c 6973 7427 2066 696c 6520 696e 2044 rlist' file in D │ │ │ │ │ -0001dd70: 4952 3b20 6275 7420 7265 6d65 6d62 6572 IR; but remember │ │ │ │ │ -0001dd80: 2074 6865 2077 6172 6e69 6e67 7320 6162 the warnings ab │ │ │ │ │ -0001dd90: 6f76 650a 6167 6169 6e73 7420 7468 6520 ove.against the │ │ │ │ │ -0001dda0: 7573 6520 6f66 2027 2d2d 7379 7374 656d use of '--system │ │ │ │ │ -0001ddb0: 2d61 6364 6972 272e 0a0a 2020 2027 6469 -acdir'... 'di │ │ │ │ │ -0001ddc0: 726c 6973 7427 2069 7320 7573 6566 756c rlist' is useful │ │ │ │ │ -0001ddd0: 2069 6e20 7468 6520 666f 6c6c 6f77 696e in the followin │ │ │ │ │ -0001dde0: 6720 7369 7475 6174 696f 6e3a 2073 7570 g situation: sup │ │ │ │ │ -0001ddf0: 706f 7365 2074 6861 740a 2761 7574 6f6d pose that.'autom │ │ │ │ │ -0001de00: 616b 6527 2076 6572 7369 6f6e 2027 312e ake' version '1. │ │ │ │ │ -0001de10: 3131 2e32 2720 6973 2069 6e73 7461 6c6c 11.2' is install │ │ │ │ │ -0001de20: 6564 2077 6974 6820 272d 2d70 7265 6669 ed with '--prefi │ │ │ │ │ -0001de30: 783d 2f75 7372 2720 6279 2074 6865 0a73 x=/usr' by the.s │ │ │ │ │ -0001de40: 7973 7465 6d20 7665 6e64 6f72 2e20 2054 ystem vendor. T │ │ │ │ │ -0001de50: 6875 732c 2074 6865 2064 6566 6175 6c74 hus, the default │ │ │ │ │ -0001de60: 2073 6561 7263 6820 6469 7265 6374 6f72 search director │ │ │ │ │ -0001de70: 6965 7320 6172 650a 0a20 2031 2e20 272f ies are.. 1. '/ │ │ │ │ │ -0001de80: 7573 722f 7368 6172 652f 6163 6c6f 6361 usr/share/acloca │ │ │ │ │ -0001de90: 6c2d 312e 3131 2f27 0a20 2032 2e20 272f l-1.11/'. 2. '/ │ │ │ │ │ -0001dea0: 7573 722f 7368 6172 652f 6163 6c6f 6361 usr/share/acloca │ │ │ │ │ -0001deb0: 6c2f 270a 0a20 2020 486f 7765 7665 722c l/'.. However, │ │ │ │ │ -0001dec0: 2073 7570 706f 7365 2066 7572 7468 6572 suppose further │ │ │ │ │ -0001ded0: 2074 6861 7420 6d61 6e79 2070 6163 6b61 that many packa │ │ │ │ │ -0001dee0: 6765 7320 6861 7665 2062 6565 6e20 6d61 ges have been ma │ │ │ │ │ -0001def0: 6e75 616c 6c79 0a69 6e73 7461 6c6c 6564 nually.installed │ │ │ │ │ -0001df00: 206f 6e20 7468 6520 7379 7374 656d 2c20 on the system, │ │ │ │ │ -0001df10: 7769 7468 2024 7072 6566 6978 3d2f 7573 with $prefix=/us │ │ │ │ │ -0001df20: 722f 6c6f 6361 6c2c 2061 7320 6973 2074 r/local, as is t │ │ │ │ │ -0001df30: 7970 6963 616c 2e20 2049 6e0a 7468 6174 ypical. In.that │ │ │ │ │ -0001df40: 2063 6173 652c 206d 616e 7920 6f66 2074 case, many of t │ │ │ │ │ -0001df50: 6865 7365 2022 6578 7472 6122 2027 2e6d hese "extra" '.m │ │ │ │ │ -0001df60: 3427 2066 696c 6573 2061 7265 2069 6e0a 4' files are in. │ │ │ │ │ -0001df70: 272f 7573 722f 6c6f 6361 6c2f 7368 6172 '/usr/local/shar │ │ │ │ │ -0001df80: 652f 6163 6c6f 6361 6c27 2e20 2054 6865 e/aclocal'. The │ │ │ │ │ -0001df90: 206f 6e6c 7920 7761 7920 746f 2066 6f72 only way to for │ │ │ │ │ -0001dfa0: 6365 2027 2f75 7372 2f62 696e 2f61 636c ce '/usr/bin/acl │ │ │ │ │ -0001dfb0: 6f63 616c 2720 746f 0a66 696e 6420 7468 ocal' to.find th │ │ │ │ │ -0001dfc0: 6573 6520 2265 7874 7261 2220 272e 6d34 ese "extra" '.m4 │ │ │ │ │ -0001dfd0: 2720 6669 6c65 7320 6973 2074 6f20 616c ' files is to al │ │ │ │ │ -0001dfe0: 7761 7973 2063 616c 6c20 2761 636c 6f63 ways call 'acloc │ │ │ │ │ -0001dff0: 616c 202d 490a 2f75 7372 2f6c 6f63 616c al -I./usr/local │ │ │ │ │ -0001e000: 2f73 6861 7265 2f61 636c 6f63 616c 272e /share/aclocal'. │ │ │ │ │ -0001e010: 2020 5468 6973 2069 7320 696e 636f 6e76 This is inconv │ │ │ │ │ -0001e020: 656e 6965 6e74 2e20 2057 6974 6820 2764 enient. With 'd │ │ │ │ │ -0001e030: 6972 6c69 7374 272c 206f 6e65 0a6d 6179 irlist', one.may │ │ │ │ │ -0001e040: 2063 7265 6174 6520 6120 6669 6c65 2027 create a file ' │ │ │ │ │ -0001e050: 2f75 7372 2f73 6861 7265 2f61 636c 6f63 /usr/share/acloc │ │ │ │ │ -0001e060: 616c 2f64 6972 6c69 7374 2720 636f 6e74 al/dirlist' cont │ │ │ │ │ -0001e070: 6169 6e69 6e67 206f 6e6c 7920 7468 650a aining only the. │ │ │ │ │ -0001e080: 7369 6e67 6c65 206c 696e 650a 0a20 2020 single line.. │ │ │ │ │ -0001e090: 2020 2f75 7372 2f6c 6f63 616c 2f73 6861 /usr/local/sha │ │ │ │ │ -0001e0a0: 7265 2f61 636c 6f63 616c 0a0a 2020 204e re/aclocal.. N │ │ │ │ │ -0001e0b0: 6f77 2c20 7468 6520 2264 6566 6175 6c74 ow, the "default │ │ │ │ │ -0001e0c0: 2220 7365 6172 6368 2070 6174 6820 6f6e " search path on │ │ │ │ │ -0001e0d0: 2074 6865 2061 6666 6563 7465 6420 7379 the affected sy │ │ │ │ │ -0001e0e0: 7374 656d 2069 730a 0a20 2031 2e20 272f stem is.. 1. '/ │ │ │ │ │ -0001e0f0: 7573 722f 7368 6172 652f 6163 6c6f 6361 usr/share/acloca │ │ │ │ │ -0001e100: 6c2d 312e 3131 2f27 0a20 2032 2e20 272f l-1.11/'. 2. '/ │ │ │ │ │ -0001e110: 7573 722f 7368 6172 652f 6163 6c6f 6361 usr/share/acloca │ │ │ │ │ -0001e120: 6c2f 270a 2020 332e 2027 2f75 7372 2f6c l/'. 3. '/usr/l │ │ │ │ │ -0001e130: 6f63 616c 2f73 6861 7265 2f61 636c 6f63 ocal/share/acloc │ │ │ │ │ -0001e140: 616c 2f27 0a0a 2020 2077 6974 686f 7574 al/'.. without │ │ │ │ │ -0001e150: 2074 6865 206e 6565 6420 666f 7220 272d the need for '- │ │ │ │ │ -0001e160: 4927 206f 7074 696f 6e73 3b20 272d 4927 I' options; '-I' │ │ │ │ │ -0001e170: 206f 7074 696f 6e73 2063 616e 2062 6520 options can be │ │ │ │ │ -0001e180: 7265 7365 7276 6564 2066 6f72 0a70 726f reserved for.pro │ │ │ │ │ -0001e190: 6a65 6374 2d73 7065 6369 6669 6320 6e65 ject-specific ne │ │ │ │ │ -0001e1a0: 6564 7320 2827 6d79 2d73 6f75 7263 652d eds ('my-source- │ │ │ │ │ -0001e1b0: 6469 722f 6d34 2f27 292c 2072 6174 6865 dir/m4/'), rathe │ │ │ │ │ -0001e1c0: 7220 7468 616e 2075 7369 6e67 2069 7420 r than using it │ │ │ │ │ -0001e1d0: 746f 0a77 6f72 6b20 6172 6f75 6e64 206c to.work around l │ │ │ │ │ -0001e1e0: 6f63 616c 2073 7973 7465 6d2d 6465 7065 ocal system-depe │ │ │ │ │ -0001e1f0: 6e64 656e 7420 746f 6f6c 2069 6e73 7461 ndent tool insta │ │ │ │ │ -0001e200: 6c6c 6174 696f 6e20 6469 7265 6374 6f72 llation director │ │ │ │ │ -0001e210: 6965 732e 0a0a 2020 2053 696d 696c 6172 ies... Similar │ │ │ │ │ -0001e220: 6c79 2c20 2764 6972 6c69 7374 2720 6361 ly, 'dirlist' ca │ │ │ │ │ -0001e230: 6e20 6265 2068 616e 6479 2069 6620 796f n be handy if yo │ │ │ │ │ -0001e240: 7520 6861 7665 2069 6e73 7461 6c6c 6564 u have installed │ │ │ │ │ -0001e250: 2061 206c 6f63 616c 2063 6f70 790a 6f66 a local copy.of │ │ │ │ │ -0001e260: 2041 7574 6f6d 616b 6520 696e 2079 6f75 Automake in you │ │ │ │ │ -0001e270: 7220 6163 636f 756e 7420 616e 6420 7761 r account and wa │ │ │ │ │ -0001e280: 6e74 2027 6163 6c6f 6361 6c27 2074 6f20 nt 'aclocal' to │ │ │ │ │ -0001e290: 6c6f 6f6b 2066 6f72 206d 6163 726f 730a look for macros. │ │ │ │ │ -0001e2a0: 696e 7374 616c 6c65 6420 6174 206f 7468 installed at oth │ │ │ │ │ -0001e2b0: 6572 2070 6c61 6365 7320 6f6e 2074 6865 er places on the │ │ │ │ │ -0001e2c0: 2073 7973 7465 6d2e 0a0a 4d6f 6469 6679 system...Modify │ │ │ │ │ -0001e2d0: 696e 6720 7468 6520 4d61 6372 6f20 5365 ing the Macro Se │ │ │ │ │ -0001e2e0: 6172 6368 2050 6174 683a 2027 4143 4c4f arch Path: 'ACLO │ │ │ │ │ -0001e2f0: 4341 4c5f 5041 5448 270a 2e2e 2e2e 2e2e CAL_PATH'....... │ │ │ │ │ +0001da30: 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 6865 .............The │ │ │ │ │ +0001da40: 7265 2069 7320 6120 7468 6972 6420 6d65 re is a third me │ │ │ │ │ +0001da50: 6368 616e 6973 6d20 666f 7220 6375 7374 chanism for cust │ │ │ │ │ +0001da60: 6f6d 697a 696e 6720 7468 6520 7365 6172 omizing the sear │ │ │ │ │ +0001da70: 6368 2070 6174 682e 2020 4966 2061 0a27 ch path. If a.' │ │ │ │ │ +0001da80: 6469 726c 6973 7427 2066 696c 6520 6578 dirlist' file ex │ │ │ │ │ +0001da90: 6973 7473 2069 6e20 4143 4449 522c 2074 ists in ACDIR, t │ │ │ │ │ +0001daa0: 6865 6e20 7468 6174 2066 696c 6520 6973 hen that file is │ │ │ │ │ +0001dab0: 2061 7373 756d 6564 2074 6f20 636f 6e74 assumed to cont │ │ │ │ │ +0001dac0: 6169 6e20 610a 6c69 7374 206f 6620 6469 ain a.list of di │ │ │ │ │ +0001dad0: 7265 6374 6f72 7920 7061 7474 6572 6e73 rectory patterns │ │ │ │ │ +0001dae0: 2c20 6f6e 6520 7065 7220 6c69 6e65 2e20 , one per line. │ │ │ │ │ +0001daf0: 2027 6163 6c6f 6361 6c27 2065 7870 616e 'aclocal' expan │ │ │ │ │ +0001db00: 6473 2074 6865 7365 0a70 6174 7465 726e ds these.pattern │ │ │ │ │ +0001db10: 7320 746f 2064 6972 6563 746f 7279 206e s to directory n │ │ │ │ │ +0001db20: 616d 6573 2c20 616e 6420 6164 6473 2074 ames, and adds t │ │ │ │ │ +0001db30: 6865 6d20 746f 2074 6865 2073 6561 7263 hem to the searc │ │ │ │ │ +0001db40: 6820 6c69 7374 205f 6166 7465 725f 0a61 h list _after_.a │ │ │ │ │ +0001db50: 6c6c 206f 7468 6572 2064 6972 6563 746f ll other directo │ │ │ │ │ +0001db60: 7269 6573 2e20 2027 6469 726c 6973 7427 ries. 'dirlist' │ │ │ │ │ +0001db70: 2065 6e74 7269 6573 206d 6179 2075 7365 entries may use │ │ │ │ │ +0001db80: 2073 6865 6c6c 2077 696c 6463 6172 6473 shell wildcards │ │ │ │ │ +0001db90: 2073 7563 680a 6173 2027 2a27 2c20 273f such.as '*', '? │ │ │ │ │ +0001dba0: 272c 206f 7220 275b 2e2e 2e5d 272e 0a0a ', or '[...]'... │ │ │ │ │ +0001dbb0: 2020 2046 6f72 2065 7861 6d70 6c65 2c20 For example, │ │ │ │ │ +0001dbc0: 7375 7070 6f73 6520 2741 4344 4952 2f64 suppose 'ACDIR/d │ │ │ │ │ +0001dbd0: 6972 6c69 7374 2720 636f 6e74 6169 6e73 irlist' contains │ │ │ │ │ +0001dbe0: 2074 6865 2066 6f6c 6c6f 7769 6e67 3a0a the following:. │ │ │ │ │ +0001dbf0: 0a20 2020 2020 2f74 6573 7431 0a20 2020 . /test1. │ │ │ │ │ +0001dc00: 2020 2f74 6573 7432 0a20 2020 2020 2f74 /test2. /t │ │ │ │ │ +0001dc10: 6573 7433 2a0a 0a61 6e64 2074 6861 7420 est3*..and that │ │ │ │ │ +0001dc20: 2761 636c 6f63 616c 2720 7761 7320 6361 'aclocal' was ca │ │ │ │ │ +0001dc30: 6c6c 6564 2077 6974 6820 7468 6520 272d lled with the '- │ │ │ │ │ +0001dc40: 4920 2f66 6f6f 202d 4920 2f62 6172 2720 I /foo -I /bar' │ │ │ │ │ +0001dc50: 6f70 7469 6f6e 732e 2020 5468 656e 2c0a options. Then,. │ │ │ │ │ +0001dc60: 7468 6520 7365 6172 6368 2070 6174 6820 the search path │ │ │ │ │ +0001dc70: 776f 756c 6420 6265 0a0a 2020 312e 2027 would be.. 1. ' │ │ │ │ │ +0001dc80: 2f66 6f6f 270a 2020 322e 2027 2f62 6172 /foo'. 2. '/bar │ │ │ │ │ +0001dc90: 270a 2020 332e 2041 4344 4952 2d41 5049 '. 3. ACDIR-API │ │ │ │ │ +0001dca0: 5645 5253 494f 4e0a 2020 342e 2041 4344 VERSION. 4. ACD │ │ │ │ │ +0001dcb0: 4952 0a20 2035 2e20 272f 7465 7374 3127 IR. 5. '/test1' │ │ │ │ │ +0001dcc0: 0a20 2036 2e20 272f 7465 7374 3227 0a0a . 6. '/test2'.. │ │ │ │ │ +0001dcd0: 616e 6420 616c 6c20 6469 7265 6374 6f72 and all director │ │ │ │ │ +0001dce0: 6965 7320 7769 7468 2070 6174 6820 6e61 ies with path na │ │ │ │ │ +0001dcf0: 6d65 7320 7374 6172 7469 6e67 2077 6974 mes starting wit │ │ │ │ │ +0001dd00: 6820 272f 7465 7374 3327 2e0a 0a20 2020 h '/test3'... │ │ │ │ │ +0001dd10: 4966 2074 6865 2027 2d2d 7379 7374 656d If the '--system │ │ │ │ │ +0001dd20: 2d61 6364 6972 3d44 4952 2720 6f70 7469 -acdir=DIR' opti │ │ │ │ │ +0001dd30: 6f6e 2069 7320 7573 6564 2c20 7468 656e on is used, then │ │ │ │ │ +0001dd40: 2027 6163 6c6f 6361 6c27 2077 696c 6c0a 'aclocal' will. │ │ │ │ │ +0001dd50: 7365 6172 6368 2066 6f72 2074 6865 2027 search for the ' │ │ │ │ │ +0001dd60: 6469 726c 6973 7427 2066 696c 6520 696e dirlist' file in │ │ │ │ │ +0001dd70: 2044 4952 3b20 6275 7420 7265 6d65 6d62 DIR; but rememb │ │ │ │ │ +0001dd80: 6572 2074 6865 2077 6172 6e69 6e67 7320 er the warnings │ │ │ │ │ +0001dd90: 6162 6f76 650a 6167 6169 6e73 7420 7468 above.against th │ │ │ │ │ +0001dda0: 6520 7573 6520 6f66 2027 2d2d 7379 7374 e use of '--syst │ │ │ │ │ +0001ddb0: 656d 2d61 6364 6972 272e 0a0a 2020 2027 em-acdir'... ' │ │ │ │ │ +0001ddc0: 6469 726c 6973 7427 2069 7320 7573 6566 dirlist' is usef │ │ │ │ │ +0001ddd0: 756c 2069 6e20 7468 6520 666f 6c6c 6f77 ul in the follow │ │ │ │ │ +0001dde0: 696e 6720 7369 7475 6174 696f 6e3a 2073 ing situation: s │ │ │ │ │ +0001ddf0: 7570 706f 7365 2074 6861 740a 2761 7574 uppose that.'aut │ │ │ │ │ +0001de00: 6f6d 616b 6527 2076 6572 7369 6f6e 2027 omake' version ' │ │ │ │ │ +0001de10: 312e 3131 2e32 2720 6973 2069 6e73 7461 1.11.2' is insta │ │ │ │ │ +0001de20: 6c6c 6564 2077 6974 6820 272d 2d70 7265 lled with '--pre │ │ │ │ │ +0001de30: 6669 783d 2f75 7372 2720 6279 2074 6865 fix=/usr' by the │ │ │ │ │ +0001de40: 0a73 7973 7465 6d20 7665 6e64 6f72 2e20 .system vendor. │ │ │ │ │ +0001de50: 2054 6875 732c 2074 6865 2064 6566 6175 Thus, the defau │ │ │ │ │ +0001de60: 6c74 2073 6561 7263 6820 6469 7265 6374 lt search direct │ │ │ │ │ +0001de70: 6f72 6965 7320 6172 650a 0a20 2031 2e20 ories are.. 1. │ │ │ │ │ +0001de80: 272f 7573 722f 7368 6172 652f 6163 6c6f '/usr/share/aclo │ │ │ │ │ +0001de90: 6361 6c2d 312e 3131 2f27 0a20 2032 2e20 cal-1.11/'. 2. │ │ │ │ │ +0001dea0: 272f 7573 722f 7368 6172 652f 6163 6c6f '/usr/share/aclo │ │ │ │ │ +0001deb0: 6361 6c2f 270a 0a20 2020 486f 7765 7665 cal/'.. Howeve │ │ │ │ │ +0001dec0: 722c 2073 7570 706f 7365 2066 7572 7468 r, suppose furth │ │ │ │ │ +0001ded0: 6572 2074 6861 7420 6d61 6e79 2070 6163 er that many pac │ │ │ │ │ +0001dee0: 6b61 6765 7320 6861 7665 2062 6565 6e20 kages have been │ │ │ │ │ +0001def0: 6d61 6e75 616c 6c79 0a69 6e73 7461 6c6c manually.install │ │ │ │ │ +0001df00: 6564 206f 6e20 7468 6520 7379 7374 656d ed on the system │ │ │ │ │ +0001df10: 2c20 7769 7468 2024 7072 6566 6978 3d2f , with $prefix=/ │ │ │ │ │ +0001df20: 7573 722f 6c6f 6361 6c2c 2061 7320 6973 usr/local, as is │ │ │ │ │ +0001df30: 2074 7970 6963 616c 2e20 2049 6e0a 7468 typical. In.th │ │ │ │ │ +0001df40: 6174 2063 6173 652c 206d 616e 7920 6f66 at case, many of │ │ │ │ │ +0001df50: 2074 6865 7365 2022 6578 7472 6122 2027 these "extra" ' │ │ │ │ │ +0001df60: 2e6d 3427 2066 696c 6573 2061 7265 2069 .m4' files are i │ │ │ │ │ +0001df70: 6e0a 272f 7573 722f 6c6f 6361 6c2f 7368 n.'/usr/local/sh │ │ │ │ │ +0001df80: 6172 652f 6163 6c6f 6361 6c27 2e20 2054 are/aclocal'. T │ │ │ │ │ +0001df90: 6865 206f 6e6c 7920 7761 7920 746f 2066 he only way to f │ │ │ │ │ +0001dfa0: 6f72 6365 2027 2f75 7372 2f62 696e 2f61 orce '/usr/bin/a │ │ │ │ │ +0001dfb0: 636c 6f63 616c 2720 746f 0a66 696e 6420 clocal' to.find │ │ │ │ │ +0001dfc0: 7468 6573 6520 2265 7874 7261 2220 272e these "extra" '. │ │ │ │ │ +0001dfd0: 6d34 2720 6669 6c65 7320 6973 2074 6f20 m4' files is to │ │ │ │ │ +0001dfe0: 616c 7761 7973 2063 616c 6c20 2761 636c always call 'acl │ │ │ │ │ +0001dff0: 6f63 616c 202d 490a 2f75 7372 2f6c 6f63 ocal -I./usr/loc │ │ │ │ │ +0001e000: 616c 2f73 6861 7265 2f61 636c 6f63 616c al/share/aclocal │ │ │ │ │ +0001e010: 272e 2020 5468 6973 2069 7320 696e 636f '. This is inco │ │ │ │ │ +0001e020: 6e76 656e 6965 6e74 2e20 2057 6974 6820 nvenient. With │ │ │ │ │ +0001e030: 2764 6972 6c69 7374 272c 206f 6e65 0a6d 'dirlist', one.m │ │ │ │ │ +0001e040: 6179 2063 7265 6174 6520 6120 6669 6c65 ay create a file │ │ │ │ │ +0001e050: 2027 2f75 7372 2f73 6861 7265 2f61 636c '/usr/share/acl │ │ │ │ │ +0001e060: 6f63 616c 2f64 6972 6c69 7374 2720 636f ocal/dirlist' co │ │ │ │ │ +0001e070: 6e74 6169 6e69 6e67 206f 6e6c 7920 7468 ntaining only th │ │ │ │ │ +0001e080: 650a 7369 6e67 6c65 206c 696e 650a 0a20 e.single line.. │ │ │ │ │ +0001e090: 2020 2020 2f75 7372 2f6c 6f63 616c 2f73 /usr/local/s │ │ │ │ │ +0001e0a0: 6861 7265 2f61 636c 6f63 616c 0a0a 2020 hare/aclocal.. │ │ │ │ │ +0001e0b0: 204e 6f77 2c20 7468 6520 2264 6566 6175 Now, the "defau │ │ │ │ │ +0001e0c0: 6c74 2220 7365 6172 6368 2070 6174 6820 lt" search path │ │ │ │ │ +0001e0d0: 6f6e 2074 6865 2061 6666 6563 7465 6420 on the affected │ │ │ │ │ +0001e0e0: 7379 7374 656d 2069 730a 0a20 2031 2e20 system is.. 1. │ │ │ │ │ +0001e0f0: 272f 7573 722f 7368 6172 652f 6163 6c6f '/usr/share/aclo │ │ │ │ │ +0001e100: 6361 6c2d 312e 3131 2f27 0a20 2032 2e20 cal-1.11/'. 2. │ │ │ │ │ +0001e110: 272f 7573 722f 7368 6172 652f 6163 6c6f '/usr/share/aclo │ │ │ │ │ +0001e120: 6361 6c2f 270a 2020 332e 2027 2f75 7372 cal/'. 3. '/usr │ │ │ │ │ +0001e130: 2f6c 6f63 616c 2f73 6861 7265 2f61 636c /local/share/acl │ │ │ │ │ +0001e140: 6f63 616c 2f27 0a0a 2020 2077 6974 686f ocal/'.. witho │ │ │ │ │ +0001e150: 7574 2074 6865 206e 6565 6420 666f 7220 ut the need for │ │ │ │ │ +0001e160: 272d 4927 206f 7074 696f 6e73 3b20 272d '-I' options; '- │ │ │ │ │ +0001e170: 4927 206f 7074 696f 6e73 2063 616e 2062 I' options can b │ │ │ │ │ +0001e180: 6520 7265 7365 7276 6564 2066 6f72 0a70 e reserved for.p │ │ │ │ │ +0001e190: 726f 6a65 6374 2d73 7065 6369 6669 6320 roject-specific │ │ │ │ │ +0001e1a0: 6e65 6564 7320 2827 6d79 2d73 6f75 7263 needs ('my-sourc │ │ │ │ │ +0001e1b0: 652d 6469 722f 6d34 2f27 292c 2072 6174 e-dir/m4/'), rat │ │ │ │ │ +0001e1c0: 6865 7220 7468 616e 2075 7369 6e67 2069 her than using i │ │ │ │ │ +0001e1d0: 7420 746f 0a77 6f72 6b20 6172 6f75 6e64 t to.work around │ │ │ │ │ +0001e1e0: 206c 6f63 616c 2073 7973 7465 6d2d 6465 local system-de │ │ │ │ │ +0001e1f0: 7065 6e64 656e 7420 746f 6f6c 2069 6e73 pendent tool ins │ │ │ │ │ +0001e200: 7461 6c6c 6174 696f 6e20 6469 7265 6374 tallation direct │ │ │ │ │ +0001e210: 6f72 6965 732e 0a0a 2020 2053 696d 696c ories... Simil │ │ │ │ │ +0001e220: 6172 6c79 2c20 2764 6972 6c69 7374 2720 arly, 'dirlist' │ │ │ │ │ +0001e230: 6361 6e20 6265 2068 616e 6479 2069 6620 can be handy if │ │ │ │ │ +0001e240: 796f 7520 6861 7665 2069 6e73 7461 6c6c you have install │ │ │ │ │ +0001e250: 6564 2061 206c 6f63 616c 2063 6f70 790a ed a local copy. │ │ │ │ │ +0001e260: 6f66 2041 7574 6f6d 616b 6520 696e 2079 of Automake in y │ │ │ │ │ +0001e270: 6f75 7220 6163 636f 756e 7420 616e 6420 our account and │ │ │ │ │ +0001e280: 7761 6e74 2027 6163 6c6f 6361 6c27 2074 want 'aclocal' t │ │ │ │ │ +0001e290: 6f20 6c6f 6f6b 2066 6f72 206d 6163 726f o look for macro │ │ │ │ │ +0001e2a0: 730a 696e 7374 616c 6c65 6420 6174 206f s.installed at o │ │ │ │ │ +0001e2b0: 7468 6572 2070 6c61 6365 7320 6f6e 2074 ther places on t │ │ │ │ │ +0001e2c0: 6865 2073 7973 7465 6d2e 0a0a 4d6f 6469 he system...Modi │ │ │ │ │ +0001e2d0: 6679 696e 6720 7468 6520 4d61 6372 6f20 fying the Macro │ │ │ │ │ +0001e2e0: 5365 6172 6368 2050 6174 683a 2027 4143 Search Path: 'AC │ │ │ │ │ +0001e2f0: 4c4f 4341 4c5f 5041 5448 270a 2e2e 2e2e LOCAL_PATH'..... │ │ │ │ │ 0001e300: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 0001e310: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0001e320: 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 6865 2066 ...........The f │ │ │ │ │ -0001e330: 6f75 7274 6820 616e 6420 6c61 7374 206d ourth and last m │ │ │ │ │ -0001e340: 6563 6861 6e69 736d 2074 6f20 6375 7374 echanism to cust │ │ │ │ │ -0001e350: 6f6d 697a 6520 7468 6520 6d61 6372 6f20 omize the macro │ │ │ │ │ -0001e360: 7365 6172 6368 2070 6174 6820 6973 2061 search path is a │ │ │ │ │ -0001e370: 6c73 6f0a 7468 6520 7369 6d70 6c65 7374 lso.the simplest │ │ │ │ │ -0001e380: 2e20 2041 6e79 2064 6972 6563 746f 7279 . Any directory │ │ │ │ │ -0001e390: 2069 6e63 6c75 6465 6420 696e 2074 6865 included in the │ │ │ │ │ -0001e3a0: 2063 6f6c 6f6e 2d73 6570 6172 6174 6564 colon-separated │ │ │ │ │ -0001e3b0: 2065 6e76 6972 6f6e 6d65 6e74 0a76 6172 environment.var │ │ │ │ │ -0001e3c0: 6961 626c 6520 2741 434c 4f43 414c 5f50 iable 'ACLOCAL_P │ │ │ │ │ -0001e3d0: 4154 4827 2069 7320 6164 6465 6420 746f ATH' is added to │ │ │ │ │ -0001e3e0: 2074 6865 2073 6561 7263 6820 7061 7468 the search path │ │ │ │ │ -0001e3f0: 2061 6e64 2074 616b 6573 2070 7265 6365 and takes prece │ │ │ │ │ -0001e400: 6465 6e63 650a 6f76 6572 2073 7973 7465 dence.over syste │ │ │ │ │ -0001e410: 6d20 6469 7265 6374 6f72 6965 7320 2869 m directories (i │ │ │ │ │ -0001e420: 6e63 6c75 6469 6e67 2074 686f 7365 2066 ncluding those f │ │ │ │ │ -0001e430: 6f75 6e64 2076 6961 2027 6469 726c 6973 ound via 'dirlis │ │ │ │ │ -0001e440: 7427 292c 2077 6974 6820 7468 650a 6578 t'), with the.ex │ │ │ │ │ -0001e450: 6365 7074 696f 6e20 6f66 2074 6865 2076 ception of the v │ │ │ │ │ -0001e460: 6572 7369 6f6e 6564 2064 6972 6563 746f ersioned directo │ │ │ │ │ -0001e470: 7279 2041 4344 4952 2d41 5049 5645 5253 ry ACDIR-APIVERS │ │ │ │ │ -0001e480: 494f 4e20 282a 6e6f 7465 204d 6163 726f ION (*note Macro │ │ │ │ │ -0001e490: 0a53 6561 7263 6820 5061 7468 3a3a 292e .Search Path::). │ │ │ │ │ -0001e4a0: 2020 486f 7765 7665 722c 2064 6972 6563 However, direc │ │ │ │ │ -0001e4b0: 746f 7269 6573 2070 6173 7365 6420 7669 tories passed vi │ │ │ │ │ -0001e4c0: 6120 272d 4927 2077 696c 6c20 7461 6b65 a '-I' will take │ │ │ │ │ -0001e4d0: 0a70 7265 6365 6465 6e63 6520 6f76 6572 .precedence over │ │ │ │ │ -0001e4e0: 2064 6972 6563 746f 7269 6573 2069 6e20 directories in │ │ │ │ │ -0001e4f0: 2741 434c 4f43 414c 5f50 4154 4827 2e0a 'ACLOCAL_PATH'.. │ │ │ │ │ -0001e500: 0a20 2020 416c 736f 206e 6f74 6520 7468 . Also note th │ │ │ │ │ -0001e510: 6174 2c20 6966 2074 6865 2027 2d2d 696e at, if the '--in │ │ │ │ │ -0001e520: 7374 616c 6c27 206f 7074 696f 6e20 6973 stall' option is │ │ │ │ │ -0001e530: 2075 7365 642c 2061 6e79 2027 2e6d 3427 used, any '.m4' │ │ │ │ │ -0001e540: 2066 696c 650a 636f 6e74 6169 6e69 6e67 file.containing │ │ │ │ │ -0001e550: 2061 2072 6571 7569 7265 6420 6d61 6372 a required macr │ │ │ │ │ -0001e560: 6f20 7468 6174 2069 7320 666f 756e 6420 o that is found │ │ │ │ │ -0001e570: 696e 2061 2064 6972 6563 746f 7279 206c in a directory l │ │ │ │ │ -0001e580: 6973 7465 6420 696e 0a27 4143 4c4f 4341 isted in.'ACLOCA │ │ │ │ │ -0001e590: 4c5f 5041 5448 2720 7769 6c6c 2062 6520 L_PATH' will be │ │ │ │ │ -0001e5a0: 696e 7374 616c 6c65 6420 6c6f 6361 6c6c installed locall │ │ │ │ │ -0001e5b0: 792e 2020 496e 2074 6869 7320 6361 7365 y. In this case │ │ │ │ │ -0001e5c0: 2c20 7365 7269 616c 206e 756d 6265 7273 , serial numbers │ │ │ │ │ -0001e5d0: 0a69 6e20 272e 6d34 2720 6172 6520 686f .in '.m4' are ho │ │ │ │ │ -0001e5e0: 6e6f 7572 6564 2074 6f6f 2c20 2a6e 6f74 noured too, *not │ │ │ │ │ -0001e5f0: 6520 5365 7269 616c 733a 3a2e 0a0a 2020 e Serials::... │ │ │ │ │ -0001e600: 2043 6f6e 7665 7273 656c 7920 746f 2027 Conversely to ' │ │ │ │ │ -0001e610: 6469 726c 6973 7427 2c20 2741 434c 4f43 dirlist', 'ACLOC │ │ │ │ │ -0001e620: 414c 5f50 4154 4827 2069 7320 7573 6566 AL_PATH' is usef │ │ │ │ │ -0001e630: 756c 2069 6620 796f 7520 6172 6520 7573 ul if you are us │ │ │ │ │ -0001e640: 696e 6720 610a 676c 6f62 616c 2063 6f70 ing a.global cop │ │ │ │ │ -0001e650: 7920 6f66 2041 7574 6f6d 616b 6520 616e y of Automake an │ │ │ │ │ -0001e660: 6420 7761 6e74 2027 6163 6c6f 6361 6c27 d want 'aclocal' │ │ │ │ │ -0001e670: 2074 6f20 6c6f 6f6b 2066 6f72 206d 6163 to look for mac │ │ │ │ │ -0001e680: 726f 7320 736f 6d65 7768 6572 650a 756e ros somewhere.un │ │ │ │ │ -0001e690: 6465 7220 796f 7572 2068 6f6d 6520 6469 der your home di │ │ │ │ │ -0001e6a0: 7265 6374 6f72 792e 0a0a 506c 616e 6e65 rectory...Planne │ │ │ │ │ -0001e6b0: 6420 6675 7475 7265 2069 6e63 6f6d 7061 d future incompa │ │ │ │ │ -0001e6c0: 7469 6269 6c69 7469 6573 0a2e 2e2e 2e2e tibilities...... │ │ │ │ │ +0001e320: 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 6865 .............The │ │ │ │ │ +0001e330: 2066 6f75 7274 6820 616e 6420 6c61 7374 fourth and last │ │ │ │ │ +0001e340: 206d 6563 6861 6e69 736d 2074 6f20 6375 mechanism to cu │ │ │ │ │ +0001e350: 7374 6f6d 697a 6520 7468 6520 6d61 6372 stomize the macr │ │ │ │ │ +0001e360: 6f20 7365 6172 6368 2070 6174 6820 6973 o search path is │ │ │ │ │ +0001e370: 2061 6c73 6f0a 7468 6520 7369 6d70 6c65 also.the simple │ │ │ │ │ +0001e380: 7374 2e20 2041 6e79 2064 6972 6563 746f st. Any directo │ │ │ │ │ +0001e390: 7279 2069 6e63 6c75 6465 6420 696e 2074 ry included in t │ │ │ │ │ +0001e3a0: 6865 2063 6f6c 6f6e 2d73 6570 6172 6174 he colon-separat │ │ │ │ │ +0001e3b0: 6564 2065 6e76 6972 6f6e 6d65 6e74 0a76 ed environment.v │ │ │ │ │ +0001e3c0: 6172 6961 626c 6520 2741 434c 4f43 414c ariable 'ACLOCAL │ │ │ │ │ +0001e3d0: 5f50 4154 4827 2069 7320 6164 6465 6420 _PATH' is added │ │ │ │ │ +0001e3e0: 746f 2074 6865 2073 6561 7263 6820 7061 to the search pa │ │ │ │ │ +0001e3f0: 7468 2061 6e64 2074 616b 6573 2070 7265 th and takes pre │ │ │ │ │ +0001e400: 6365 6465 6e63 650a 6f76 6572 2073 7973 cedence.over sys │ │ │ │ │ +0001e410: 7465 6d20 6469 7265 6374 6f72 6965 7320 tem directories │ │ │ │ │ +0001e420: 2869 6e63 6c75 6469 6e67 2074 686f 7365 (including those │ │ │ │ │ +0001e430: 2066 6f75 6e64 2076 6961 2027 6469 726c found via 'dirl │ │ │ │ │ +0001e440: 6973 7427 292c 2077 6974 6820 7468 650a ist'), with the. │ │ │ │ │ +0001e450: 6578 6365 7074 696f 6e20 6f66 2074 6865 exception of the │ │ │ │ │ +0001e460: 2076 6572 7369 6f6e 6564 2064 6972 6563 versioned direc │ │ │ │ │ +0001e470: 746f 7279 2041 4344 4952 2d41 5049 5645 tory ACDIR-APIVE │ │ │ │ │ +0001e480: 5253 494f 4e20 282a 6e6f 7465 204d 6163 RSION (*note Mac │ │ │ │ │ +0001e490: 726f 0a53 6561 7263 6820 5061 7468 3a3a ro.Search Path:: │ │ │ │ │ +0001e4a0: 292e 2020 486f 7765 7665 722c 2064 6972 ). However, dir │ │ │ │ │ +0001e4b0: 6563 746f 7269 6573 2070 6173 7365 6420 ectories passed │ │ │ │ │ +0001e4c0: 7669 6120 272d 4927 2077 696c 6c20 7461 via '-I' will ta │ │ │ │ │ +0001e4d0: 6b65 0a70 7265 6365 6465 6e63 6520 6f76 ke.precedence ov │ │ │ │ │ +0001e4e0: 6572 2064 6972 6563 746f 7269 6573 2069 er directories i │ │ │ │ │ +0001e4f0: 6e20 2741 434c 4f43 414c 5f50 4154 4827 n 'ACLOCAL_PATH' │ │ │ │ │ +0001e500: 2e0a 0a20 2020 416c 736f 206e 6f74 6520 ... Also note │ │ │ │ │ +0001e510: 7468 6174 2c20 6966 2074 6865 2027 2d2d that, if the '-- │ │ │ │ │ +0001e520: 696e 7374 616c 6c27 206f 7074 696f 6e20 install' option │ │ │ │ │ +0001e530: 6973 2075 7365 642c 2061 6e79 2027 2e6d is used, any '.m │ │ │ │ │ +0001e540: 3427 2066 696c 650a 636f 6e74 6169 6e69 4' file.containi │ │ │ │ │ +0001e550: 6e67 2061 2072 6571 7569 7265 6420 6d61 ng a required ma │ │ │ │ │ +0001e560: 6372 6f20 7468 6174 2069 7320 666f 756e cro that is foun │ │ │ │ │ +0001e570: 6420 696e 2061 2064 6972 6563 746f 7279 d in a directory │ │ │ │ │ +0001e580: 206c 6973 7465 6420 696e 0a27 4143 4c4f listed in.'ACLO │ │ │ │ │ +0001e590: 4341 4c5f 5041 5448 2720 7769 6c6c 2062 CAL_PATH' will b │ │ │ │ │ +0001e5a0: 6520 696e 7374 616c 6c65 6420 6c6f 6361 e installed loca │ │ │ │ │ +0001e5b0: 6c6c 792e 2020 496e 2074 6869 7320 6361 lly. In this ca │ │ │ │ │ +0001e5c0: 7365 2c20 7365 7269 616c 206e 756d 6265 se, serial numbe │ │ │ │ │ +0001e5d0: 7273 0a69 6e20 272e 6d34 2720 6172 6520 rs.in '.m4' are │ │ │ │ │ +0001e5e0: 686f 6e6f 7572 6564 2074 6f6f 2c20 2a6e honoured too, *n │ │ │ │ │ +0001e5f0: 6f74 6520 5365 7269 616c 733a 3a2e 0a0a ote Serials::... │ │ │ │ │ +0001e600: 2020 2043 6f6e 7665 7273 656c 7920 746f Conversely to │ │ │ │ │ +0001e610: 2027 6469 726c 6973 7427 2c20 2741 434c 'dirlist', 'ACL │ │ │ │ │ +0001e620: 4f43 414c 5f50 4154 4827 2069 7320 7573 OCAL_PATH' is us │ │ │ │ │ +0001e630: 6566 756c 2069 6620 796f 7520 6172 6520 eful if you are │ │ │ │ │ +0001e640: 7573 696e 6720 610a 676c 6f62 616c 2063 using a.global c │ │ │ │ │ +0001e650: 6f70 7920 6f66 2041 7574 6f6d 616b 6520 opy of Automake │ │ │ │ │ +0001e660: 616e 6420 7761 6e74 2027 6163 6c6f 6361 and want 'acloca │ │ │ │ │ +0001e670: 6c27 2074 6f20 6c6f 6f6b 2066 6f72 206d l' to look for m │ │ │ │ │ +0001e680: 6163 726f 7320 736f 6d65 7768 6572 650a acros somewhere. │ │ │ │ │ +0001e690: 756e 6465 7220 796f 7572 2068 6f6d 6520 under your home │ │ │ │ │ +0001e6a0: 6469 7265 6374 6f72 792e 0a0a 506c 616e directory...Plan │ │ │ │ │ +0001e6b0: 6e65 6420 6675 7475 7265 2069 6e63 6f6d ned future incom │ │ │ │ │ +0001e6c0: 7061 7469 6269 6c69 7469 6573 0a2e 2e2e patibilities.... │ │ │ │ │ 0001e6d0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0001e6e0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 6865 .............The │ │ │ │ │ -0001e6f0: 206f 7264 6572 2069 6e20 7768 6963 6820 order in which │ │ │ │ │ -0001e700: 7468 6520 6469 7265 6374 6f72 6965 7320 the directories │ │ │ │ │ -0001e710: 696e 2074 6865 206d 6163 726f 2073 6561 in the macro sea │ │ │ │ │ -0001e720: 7263 6820 7061 7468 2061 7265 0a63 7572 rch path are.cur │ │ │ │ │ -0001e730: 7265 6e74 6c79 206c 6f6f 6b65 6420 7570 rently looked up │ │ │ │ │ -0001e740: 2069 7320 636f 6e66 7573 696e 6720 616e is confusing an │ │ │ │ │ -0001e750: 642f 6f72 2073 7562 6f70 7469 6d61 6c20 d/or suboptimal │ │ │ │ │ -0001e760: 696e 2076 6172 696f 7573 2061 7370 6563 in various aspec │ │ │ │ │ -0001e770: 7473 2c0a 616e 6420 6973 2070 726f 6261 ts,.and is proba │ │ │ │ │ -0001e780: 626c 7920 676f 696e 6720 746f 2062 6520 bly going to be │ │ │ │ │ -0001e790: 6368 616e 6765 6420 696e 2074 6865 2066 changed in the f │ │ │ │ │ -0001e7a0: 7574 7572 6520 4175 746f 6d61 6b65 2072 uture Automake r │ │ │ │ │ -0001e7b0: 656c 6561 7365 2e20 2049 6e0a 7061 7274 elease. In.part │ │ │ │ │ -0001e7c0: 6963 756c 6172 2c20 6469 7265 6374 6f72 icular, director │ │ │ │ │ -0001e7d0: 6965 7320 696e 2027 4143 4c4f 4341 4c5f ies in 'ACLOCAL_ │ │ │ │ │ -0001e7e0: 5041 5448 2720 616e 6420 2741 4344 4952 PATH' and 'ACDIR │ │ │ │ │ -0001e7f0: 2720 6d69 6768 7420 656e 6420 7570 0a74 ' might end up.t │ │ │ │ │ -0001e800: 616b 696e 6720 7072 6563 6564 656e 6365 aking precedence │ │ │ │ │ -0001e810: 206f 7665 7220 2741 4344 4952 2d41 5049 over 'ACDIR-API │ │ │ │ │ -0001e820: 5645 5253 494f 4e27 2c20 616e 6420 6469 VERSION', and di │ │ │ │ │ -0001e830: 7265 6374 6f72 6965 7320 696e 0a27 4143 rectories in.'AC │ │ │ │ │ -0001e840: 4449 522f 6469 726c 6973 7427 206d 6967 DIR/dirlist' mig │ │ │ │ │ -0001e850: 6874 2065 6e64 2075 7020 7461 6b69 6e67 ht end up taking │ │ │ │ │ -0001e860: 2070 7265 6365 6465 6e63 6520 6f76 6572 precedence over │ │ │ │ │ -0001e870: 2027 4143 4449 5227 2e20 205f 5468 6973 'ACDIR'. _This │ │ │ │ │ -0001e880: 2069 7320 610a 706f 7373 6962 6c65 2066 is a.possible f │ │ │ │ │ -0001e890: 7574 7572 6520 696e 636f 6d70 6174 6962 uture incompatib │ │ │ │ │ -0001e8a0: 696c 6974 7921 5f0a 0a1f 0a46 696c 653a ility!_....File: │ │ │ │ │ -0001e8b0: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ -0001e8c0: 6e66 6f2c 2020 4e6f 6465 3a20 4578 7465 nfo, Node: Exte │ │ │ │ │ -0001e8d0: 6e64 696e 6720 6163 6c6f 6361 6c2c 2020 nding aclocal, │ │ │ │ │ -0001e8e0: 4e65 7874 3a20 4c6f 6361 6c20 4d61 6372 Next: Local Macr │ │ │ │ │ -0001e8f0: 6f73 2c20 2050 7265 763a 204d 6163 726f os, Prev: Macro │ │ │ │ │ -0001e900: 2053 6561 7263 6820 5061 7468 2c20 2055 Search Path, U │ │ │ │ │ -0001e910: 703a 2061 636c 6f63 616c 2049 6e76 6f63 p: aclocal Invoc │ │ │ │ │ -0001e920: 6174 696f 6e0a 0a36 2e33 2e33 2057 7269 ation..6.3.3 Wri │ │ │ │ │ -0001e930: 7469 6e67 2079 6f75 7220 6f77 6e20 6163 ting your own ac │ │ │ │ │ -0001e940: 6c6f 6361 6c20 6d61 6372 6f73 0a2d 2d2d local macros.--- │ │ │ │ │ +0001e6e0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 ...............T │ │ │ │ │ +0001e6f0: 6865 206f 7264 6572 2069 6e20 7768 6963 he order in whic │ │ │ │ │ +0001e700: 6820 7468 6520 6469 7265 6374 6f72 6965 h the directorie │ │ │ │ │ +0001e710: 7320 696e 2074 6865 206d 6163 726f 2073 s in the macro s │ │ │ │ │ +0001e720: 6561 7263 6820 7061 7468 2061 7265 0a63 earch path are.c │ │ │ │ │ +0001e730: 7572 7265 6e74 6c79 206c 6f6f 6b65 6420 urrently looked │ │ │ │ │ +0001e740: 7570 2069 7320 636f 6e66 7573 696e 6720 up is confusing │ │ │ │ │ +0001e750: 616e 642f 6f72 2073 7562 6f70 7469 6d61 and/or suboptima │ │ │ │ │ +0001e760: 6c20 696e 2076 6172 696f 7573 2061 7370 l in various asp │ │ │ │ │ +0001e770: 6563 7473 2c0a 616e 6420 6973 2070 726f ects,.and is pro │ │ │ │ │ +0001e780: 6261 626c 7920 676f 696e 6720 746f 2062 bably going to b │ │ │ │ │ +0001e790: 6520 6368 616e 6765 6420 696e 2074 6865 e changed in the │ │ │ │ │ +0001e7a0: 2066 7574 7572 6520 4175 746f 6d61 6b65 future Automake │ │ │ │ │ +0001e7b0: 2072 656c 6561 7365 2e20 2049 6e0a 7061 release. In.pa │ │ │ │ │ +0001e7c0: 7274 6963 756c 6172 2c20 6469 7265 6374 rticular, direct │ │ │ │ │ +0001e7d0: 6f72 6965 7320 696e 2027 4143 4c4f 4341 ories in 'ACLOCA │ │ │ │ │ +0001e7e0: 4c5f 5041 5448 2720 616e 6420 2741 4344 L_PATH' and 'ACD │ │ │ │ │ +0001e7f0: 4952 2720 6d69 6768 7420 656e 6420 7570 IR' might end up │ │ │ │ │ +0001e800: 0a74 616b 696e 6720 7072 6563 6564 656e .taking preceden │ │ │ │ │ +0001e810: 6365 206f 7665 7220 2741 4344 4952 2d41 ce over 'ACDIR-A │ │ │ │ │ +0001e820: 5049 5645 5253 494f 4e27 2c20 616e 6420 PIVERSION', and │ │ │ │ │ +0001e830: 6469 7265 6374 6f72 6965 7320 696e 0a27 directories in.' │ │ │ │ │ +0001e840: 4143 4449 522f 6469 726c 6973 7427 206d ACDIR/dirlist' m │ │ │ │ │ +0001e850: 6967 6874 2065 6e64 2075 7020 7461 6b69 ight end up taki │ │ │ │ │ +0001e860: 6e67 2070 7265 6365 6465 6e63 6520 6f76 ng precedence ov │ │ │ │ │ +0001e870: 6572 2027 4143 4449 5227 2e20 205f 5468 er 'ACDIR'. _Th │ │ │ │ │ +0001e880: 6973 2069 7320 610a 706f 7373 6962 6c65 is is a.possible │ │ │ │ │ +0001e890: 2066 7574 7572 6520 696e 636f 6d70 6174 future incompat │ │ │ │ │ +0001e8a0: 6962 696c 6974 7921 5f0a 0a1f 0a46 696c ibility!_....Fil │ │ │ │ │ +0001e8b0: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ +0001e8c0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4578 .info, Node: Ex │ │ │ │ │ +0001e8d0: 7465 6e64 696e 6720 6163 6c6f 6361 6c2c tending aclocal, │ │ │ │ │ +0001e8e0: 2020 4e65 7874 3a20 4c6f 6361 6c20 4d61 Next: Local Ma │ │ │ │ │ +0001e8f0: 6372 6f73 2c20 2050 7265 763a 204d 6163 cros, Prev: Mac │ │ │ │ │ +0001e900: 726f 2053 6561 7263 6820 5061 7468 2c20 ro Search Path, │ │ │ │ │ +0001e910: 2055 703a 2061 636c 6f63 616c 2049 6e76 Up: aclocal Inv │ │ │ │ │ +0001e920: 6f63 6174 696f 6e0a 0a36 2e33 2e33 2057 ocation..6.3.3 W │ │ │ │ │ +0001e930: 7269 7469 6e67 2079 6f75 7220 6f77 6e20 riting your own │ │ │ │ │ +0001e940: 6163 6c6f 6361 6c20 6d61 6372 6f73 0a2d aclocal macros.- │ │ │ │ │ 0001e950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0001e960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0001e970: 2d2d 0a0a 5468 6520 2761 636c 6f63 616c --..The 'aclocal │ │ │ │ │ -0001e980: 2720 7072 6f67 7261 6d20 646f 6573 6e27 ' program doesn' │ │ │ │ │ -0001e990: 7420 6861 7665 2061 6e79 2062 7569 6c74 t have any built │ │ │ │ │ -0001e9a0: 2d69 6e20 6b6e 6f77 6c65 6467 6520 6f66 -in knowledge of │ │ │ │ │ -0001e9b0: 2061 6e79 206d 6163 726f 732c 0a73 6f20 any macros,.so │ │ │ │ │ -0001e9c0: 6974 2069 7320 6561 7379 2074 6f20 6578 it is easy to ex │ │ │ │ │ -0001e9d0: 7465 6e64 2069 7420 7769 7468 2079 6f75 tend it with you │ │ │ │ │ -0001e9e0: 7220 6f77 6e20 6d61 6372 6f73 2e0a 0a20 r own macros... │ │ │ │ │ -0001e9f0: 2020 5468 6973 2063 616e 2062 6520 7573 This can be us │ │ │ │ │ -0001ea00: 6564 2062 7920 6c69 6272 6172 6965 7320 ed by libraries │ │ │ │ │ -0001ea10: 7468 6174 2077 616e 7420 746f 2073 7570 that want to sup │ │ │ │ │ -0001ea20: 706c 7920 7468 6569 7220 6f77 6e20 4175 ply their own Au │ │ │ │ │ -0001ea30: 746f 636f 6e66 0a6d 6163 726f 7320 666f toconf.macros fo │ │ │ │ │ -0001ea40: 7220 7573 6520 6279 206f 7468 6572 2070 r use by other p │ │ │ │ │ -0001ea50: 726f 6772 616d 732e 2020 466f 7220 696e rograms. For in │ │ │ │ │ -0001ea60: 7374 616e 6365 2c20 7468 6520 2767 6574 stance, the 'get │ │ │ │ │ -0001ea70: 7465 7874 2720 6c69 6272 6172 790a 7375 text' library.su │ │ │ │ │ -0001ea80: 7070 6c69 6573 2061 206d 6163 726f 2027 pplies a macro ' │ │ │ │ │ -0001ea90: 414d 5f47 4e55 5f47 4554 5445 5854 2720 AM_GNU_GETTEXT' │ │ │ │ │ -0001eaa0: 7468 6174 2073 686f 756c 6420 6265 2075 that should be u │ │ │ │ │ -0001eab0: 7365 6420 6279 2061 6e79 2070 6163 6b61 sed by any packa │ │ │ │ │ -0001eac0: 6765 0a75 7369 6e67 2027 6765 7474 6578 ge.using 'gettex │ │ │ │ │ -0001ead0: 7427 2e20 2057 6865 6e20 7468 6520 6c69 t'. When the li │ │ │ │ │ -0001eae0: 6272 6172 7920 6973 2069 6e73 7461 6c6c brary is install │ │ │ │ │ -0001eaf0: 6564 2c20 6974 2069 6e73 7461 6c6c 7320 ed, it installs │ │ │ │ │ -0001eb00: 7468 6973 206d 6163 726f 0a73 6f20 7468 this macro.so th │ │ │ │ │ -0001eb10: 6174 2027 6163 6c6f 6361 6c27 2077 696c at 'aclocal' wil │ │ │ │ │ -0001eb20: 6c20 6669 6e64 2069 742e 0a0a 2020 2041 l find it... A │ │ │ │ │ -0001eb30: 206d 6163 726f 2066 696c 6527 7320 6e61 macro file's na │ │ │ │ │ -0001eb40: 6d65 2073 686f 756c 6420 656e 6420 696e me should end in │ │ │ │ │ -0001eb50: 2027 2e6d 3427 2e20 2053 7563 6820 6669 '.m4'. Such fi │ │ │ │ │ -0001eb60: 6c65 7320 7368 6f75 6c64 2062 650a 696e les should be.in │ │ │ │ │ -0001eb70: 7374 616c 6c65 6420 696e 2027 2428 6461 stalled in '$(da │ │ │ │ │ -0001eb80: 7461 6469 7229 2f61 636c 6f63 616c 272e tadir)/aclocal'. │ │ │ │ │ -0001eb90: 2020 5468 6973 2069 7320 6173 2073 696d This is as sim │ │ │ │ │ -0001eba0: 706c 6520 6173 2077 7269 7469 6e67 3a0a ple as writing:. │ │ │ │ │ -0001ebb0: 0a20 2020 2020 6163 6c6f 6361 6c64 6972 . aclocaldir │ │ │ │ │ -0001ebc0: 203d 2024 2864 6174 6164 6972 292f 6163 = $(datadir)/ac │ │ │ │ │ -0001ebd0: 6c6f 6361 6c0a 2020 2020 2061 636c 6f63 local. acloc │ │ │ │ │ -0001ebe0: 616c 5f44 4154 4120 3d20 6d79 6d61 6372 al_DATA = mymacr │ │ │ │ │ -0001ebf0: 6f2e 6d34 206d 796f 7468 6572 6d61 6372 o.m4 myothermacr │ │ │ │ │ -0001ec00: 6f2e 6d34 0a0a 506c 6561 7365 2064 6f20 o.m4..Please do │ │ │ │ │ -0001ec10: 7573 6520 2724 2864 6174 6164 6972 292f use '$(datadir)/ │ │ │ │ │ -0001ec20: 6163 6c6f 6361 6c27 2c20 616e 6420 6e6f aclocal', and no │ │ │ │ │ -0001ec30: 7420 736f 6d65 7468 696e 6720 6261 7365 t something base │ │ │ │ │ -0001ec40: 6420 6f6e 2074 6865 0a72 6573 756c 7420 d on the.result │ │ │ │ │ -0001ec50: 6f66 2027 6163 6c6f 6361 6c20 2d2d 7072 of 'aclocal --pr │ │ │ │ │ -0001ec60: 696e 742d 6163 2d64 6972 2720 282a 6e6f int-ac-dir' (*no │ │ │ │ │ -0001ec70: 7465 2048 6172 642d 436f 6465 6420 496e te Hard-Coded In │ │ │ │ │ -0001ec80: 7374 616c 6c20 5061 7468 733a 3a2c 0a66 stall Paths::,.f │ │ │ │ │ -0001ec90: 6f72 2061 7267 756d 656e 7473 292e 2020 or arguments). │ │ │ │ │ -0001eca0: 4974 206d 6967 6874 2061 6c73 6f20 6265 It might also be │ │ │ │ │ -0001ecb0: 2068 656c 7066 756c 2074 6f20 7375 6767 helpful to sugg │ │ │ │ │ -0001ecc0: 6573 7420 746f 2074 6865 2075 7365 7220 est to the user │ │ │ │ │ -0001ecd0: 746f 2061 6464 0a74 6865 2027 2428 6461 to add.the '$(da │ │ │ │ │ -0001ece0: 7461 6469 7229 2f61 636c 6f63 616c 2720 tadir)/aclocal' │ │ │ │ │ -0001ecf0: 6469 7265 6374 6f72 7920 746f 2068 6973 directory to his │ │ │ │ │ -0001ed00: 2027 4143 4c4f 4341 4c5f 5041 5448 2720 'ACLOCAL_PATH' │ │ │ │ │ -0001ed10: 7661 7269 6162 6c65 2028 2a6e 6f74 650a variable (*note. │ │ │ │ │ -0001ed20: 4143 4c4f 4341 4c5f 5041 5448 3a3a 2920 ACLOCAL_PATH::) │ │ │ │ │ -0001ed30: 736f 2074 6861 7420 2761 636c 6f63 616c so that 'aclocal │ │ │ │ │ -0001ed40: 2720 7769 6c6c 2066 696e 6420 7468 6520 ' will find the │ │ │ │ │ -0001ed50: 272e 6d34 2720 6669 6c65 7320 696e 7374 '.m4' files inst │ │ │ │ │ -0001ed60: 616c 6c65 6420 6279 0a79 6f75 7220 7061 alled by.your pa │ │ │ │ │ -0001ed70: 636b 6167 6520 6175 746f 6d61 7469 6361 ckage automatica │ │ │ │ │ -0001ed80: 6c6c 792e 0a0a 2020 2041 2066 696c 6520 lly... A file │ │ │ │ │ -0001ed90: 6f66 206d 6163 726f 7320 7368 6f75 6c64 of macros should │ │ │ │ │ -0001eda0: 2062 6520 6120 7365 7269 6573 206f 6620 be a series of │ │ │ │ │ -0001edb0: 7072 6f70 6572 6c79 2071 756f 7465 6420 properly quoted │ │ │ │ │ -0001edc0: 2741 435f 4445 4655 4e27 2773 0a28 2a6e 'AC_DEFUN''s.(*n │ │ │ │ │ -0001edd0: 6f74 6520 2861 7574 6f63 6f6e 6629 4d61 ote (autoconf)Ma │ │ │ │ │ -0001ede0: 6372 6f20 4465 6669 6e69 7469 6f6e 733a cro Definitions: │ │ │ │ │ -0001edf0: 3a29 2e20 2054 6865 2027 6163 6c6f 6361 :). The 'acloca │ │ │ │ │ -0001ee00: 6c27 2070 726f 6772 616d 7320 616c 736f l' programs also │ │ │ │ │ -0001ee10: 0a75 6e64 6572 7374 616e 6473 2027 4143 .understands 'AC │ │ │ │ │ -0001ee20: 5f52 4551 5549 5245 2720 282a 6e6f 7465 _REQUIRE' (*note │ │ │ │ │ -0001ee30: 2028 6175 746f 636f 6e66 2950 7265 7265 (autoconf)Prere │ │ │ │ │ -0001ee40: 7175 6973 6974 6520 4d61 6372 6f73 3a3a quisite Macros:: │ │ │ │ │ -0001ee50: 292c 2073 6f20 6974 0a69 7320 7361 6665 ), so it.is safe │ │ │ │ │ -0001ee60: 2074 6f20 7075 7420 6561 6368 206d 6163 to put each mac │ │ │ │ │ -0001ee70: 726f 2069 6e20 6120 7365 7061 7261 7465 ro in a separate │ │ │ │ │ -0001ee80: 2066 696c 652e 2020 4561 6368 2066 696c file. Each fil │ │ │ │ │ -0001ee90: 6520 7368 6f75 6c64 2068 6176 6520 6e6f e should have no │ │ │ │ │ -0001eea0: 0a73 6964 6520 6566 6665 6374 7320 6275 .side effects bu │ │ │ │ │ -0001eeb0: 7420 6d61 6372 6f20 6465 6669 6e69 7469 t macro definiti │ │ │ │ │ -0001eec0: 6f6e 732e 2020 4573 7065 6369 616c 6c79 ons. Especially │ │ │ │ │ -0001eed0: 2c20 616e 7920 6361 6c6c 2074 6f20 2741 , any call to 'A │ │ │ │ │ -0001eee0: 435f 5052 4552 4551 270a 7368 6f75 6c64 C_PREREQ'.should │ │ │ │ │ -0001eef0: 2062 6520 646f 6e65 2069 6e73 6964 6520 be done inside │ │ │ │ │ -0001ef00: 7468 6520 6465 6669 6e65 6420 6d61 6372 the defined macr │ │ │ │ │ -0001ef10: 6f2c 206e 6f74 2061 7420 7468 6520 6265 o, not at the be │ │ │ │ │ -0001ef20: 6769 6e6e 696e 6720 6f66 2074 6865 0a66 ginning of the.f │ │ │ │ │ -0001ef30: 696c 652e 0a0a 2020 2053 7461 7274 696e ile... Startin │ │ │ │ │ -0001ef40: 6720 7769 7468 2041 7574 6f6d 616b 6520 g with Automake │ │ │ │ │ -0001ef50: 312e 382c 2027 6163 6c6f 6361 6c27 2077 1.8, 'aclocal' w │ │ │ │ │ -0001ef60: 696c 6c20 7761 726e 2061 626f 7574 2061 ill warn about a │ │ │ │ │ -0001ef70: 6c6c 2075 6e64 6572 7175 6f74 6564 0a63 ll underquoted.c │ │ │ │ │ -0001ef80: 616c 6c73 2074 6f20 2741 435f 4445 4655 alls to 'AC_DEFU │ │ │ │ │ -0001ef90: 4e27 2e20 2057 6520 7265 616c 697a 6520 N'. We realize │ │ │ │ │ -0001efa0: 7468 6973 2077 696c 6c20 616e 6e6f 7920 this will annoy │ │ │ │ │ -0001efb0: 6120 6c6f 7420 6f66 2070 656f 706c 652c a lot of people, │ │ │ │ │ -0001efc0: 0a62 6563 6175 7365 2027 6163 6c6f 6361 .because 'acloca │ │ │ │ │ -0001efd0: 6c27 2077 6173 206e 6f74 2073 6f20 7374 l' was not so st │ │ │ │ │ -0001efe0: 7269 6374 2069 6e20 7468 6520 7061 7374 rict in the past │ │ │ │ │ -0001eff0: 2061 6e64 206d 616e 7920 7468 6972 6420 and many third │ │ │ │ │ -0001f000: 7061 7274 790a 6d61 6372 6f73 2061 7265 party.macros are │ │ │ │ │ -0001f010: 2075 6e64 6572 7175 6f74 6564 3b20 616e underquoted; an │ │ │ │ │ -0001f020: 6420 7765 2068 6176 6520 746f 2061 706f d we have to apo │ │ │ │ │ -0001f030: 6c6f 6769 7a65 2066 6f72 2074 6869 7320 logize for this │ │ │ │ │ -0001f040: 7465 6d70 6f72 6172 790a 696e 636f 6e76 temporary.inconv │ │ │ │ │ -0001f050: 656e 6965 6e63 652e 2020 5468 6520 7265 enience. The re │ │ │ │ │ -0001f060: 6173 6f6e 2077 6520 6861 7665 2074 6f20 ason we have to │ │ │ │ │ -0001f070: 6265 2073 7472 6963 7465 7220 6973 2074 be stricter is t │ │ │ │ │ -0001f080: 6861 7420 6120 6675 7475 7265 0a69 6d70 hat a future.imp │ │ │ │ │ -0001f090: 6c65 6d65 6e74 6174 696f 6e20 6f66 2027 lementation of ' │ │ │ │ │ -0001f0a0: 6163 6c6f 6361 6c27 2028 2a6e 6f74 6520 aclocal' (*note │ │ │ │ │ -0001f0b0: 4675 7475 7265 206f 6620 6163 6c6f 6361 Future of acloca │ │ │ │ │ -0001f0c0: 6c3a 3a29 2077 696c 6c20 6861 7665 2074 l::) will have t │ │ │ │ │ -0001f0d0: 6f0a 7465 6d70 6f72 6172 696c 7920 696e o.temporarily in │ │ │ │ │ -0001f0e0: 636c 7564 6520 616c 6c20 7468 6573 6520 clude all these │ │ │ │ │ -0001f0f0: 7468 6972 6420 7061 7274 7920 272e 6d34 third party '.m4 │ │ │ │ │ -0001f100: 2720 6669 6c65 732c 206d 6179 6265 2073 ' files, maybe s │ │ │ │ │ -0001f110: 6576 6572 616c 0a74 696d 6573 2c20 696e everal.times, in │ │ │ │ │ -0001f120: 636c 7564 696e 6720 6576 656e 2066 696c cluding even fil │ │ │ │ │ -0001f130: 6573 2074 6861 7420 6172 6520 6e6f 7420 es that are not │ │ │ │ │ -0001f140: 6163 7475 616c 6c79 206e 6565 6465 642e actually needed. │ │ │ │ │ -0001f150: 2020 446f 696e 6720 736f 0a73 686f 756c Doing so.shoul │ │ │ │ │ -0001f160: 6420 616c 6c65 7669 6174 6520 6d61 6e79 d alleviate many │ │ │ │ │ -0001f170: 2070 726f 626c 656d 7320 6f66 2074 6865 problems of the │ │ │ │ │ -0001f180: 2063 7572 7265 6e74 2069 6d70 6c65 6d65 current impleme │ │ │ │ │ -0001f190: 6e74 6174 696f 6e2c 2068 6f77 6576 6572 ntation, however │ │ │ │ │ -0001f1a0: 2069 740a 7265 7175 6972 6573 2061 2073 it.requires a s │ │ │ │ │ -0001f1b0: 7472 6963 7465 7220 7374 796c 6520 6672 tricter style fr │ │ │ │ │ -0001f1c0: 6f6d 2074 6865 206d 6163 726f 2061 7574 om the macro aut │ │ │ │ │ -0001f1d0: 686f 7273 2e20 2048 6f70 6566 756c 6c79 hors. Hopefully │ │ │ │ │ -0001f1e0: 2069 7420 6973 2065 6173 790a 746f 2072 it is easy.to r │ │ │ │ │ -0001f1f0: 6576 6973 6520 7468 6520 6578 6973 7469 evise the existi │ │ │ │ │ -0001f200: 6e67 206d 6163 726f 732e 2020 466f 7220 ng macros. For │ │ │ │ │ -0001f210: 696e 7374 616e 6365 2c0a 0a20 2020 2020 instance,.. │ │ │ │ │ -0001f220: 2320 6261 6420 7374 796c 650a 2020 2020 # bad style. │ │ │ │ │ -0001f230: 2041 435f 5052 4552 4551 2832 2e35 3729 AC_PREREQ(2.57) │ │ │ │ │ -0001f240: 0a20 2020 2020 4143 5f44 4546 554e 2841 . AC_DEFUN(A │ │ │ │ │ -0001f250: 585f 464f 4f42 4152 2c0a 2020 2020 205b X_FOOBAR,. [ │ │ │ │ │ -0001f260: 4143 5f52 4551 5549 5245 285b 4158 5f53 AC_REQUIRE([AX_S │ │ │ │ │ -0001f270: 4f4d 4554 4849 4e47 5d29 646e 6c0a 2020 OMETHING])dnl. │ │ │ │ │ -0001f280: 2020 2041 585f 464f 4f0a 2020 2020 2041 AX_FOO. A │ │ │ │ │ -0001f290: 585f 4241 520a 2020 2020 205d 290a 0a73 X_BAR. ])..s │ │ │ │ │ -0001f2a0: 686f 756c 6420 6265 2072 6577 7269 7474 hould be rewritt │ │ │ │ │ -0001f2b0: 656e 2061 730a 0a20 2020 2020 4143 5f44 en as.. AC_D │ │ │ │ │ -0001f2c0: 4546 554e 285b 4158 5f46 4f4f 4241 525d EFUN([AX_FOOBAR] │ │ │ │ │ -0001f2d0: 2c0a 2020 2020 205b 4143 5f50 5245 5245 ,. [AC_PRERE │ │ │ │ │ -0001f2e0: 5128 5b32 2e35 375d 2964 6e6c 0a20 2020 Q([2.57])dnl. │ │ │ │ │ -0001f2f0: 2020 4143 5f52 4551 5549 5245 285b 4158 AC_REQUIRE([AX │ │ │ │ │ -0001f300: 5f53 4f4d 4554 4849 4e47 5d29 646e 6c0a _SOMETHING])dnl. │ │ │ │ │ -0001f310: 2020 2020 2041 585f 464f 4f0a 2020 2020 AX_FOO. │ │ │ │ │ -0001f320: 2041 585f 4241 520a 2020 2020 205d 290a AX_BAR. ]). │ │ │ │ │ -0001f330: 0a20 2020 5772 6170 7069 6e67 2074 6865 . Wrapping the │ │ │ │ │ -0001f340: 2027 4143 5f50 5245 5245 5127 2063 616c 'AC_PREREQ' cal │ │ │ │ │ -0001f350: 6c20 696e 7369 6465 2074 6865 206d 6163 l inside the mac │ │ │ │ │ -0001f360: 726f 2065 6e73 7572 6573 2074 6861 7420 ro ensures that │ │ │ │ │ -0001f370: 4175 746f 636f 6e66 0a32 2e35 3720 7769 Autoconf.2.57 wi │ │ │ │ │ -0001f380: 6c6c 206e 6f74 2062 6520 7265 7175 6972 ll not be requir │ │ │ │ │ -0001f390: 6564 2069 6620 2741 585f 464f 4f42 4152 ed if 'AX_FOOBAR │ │ │ │ │ -0001f3a0: 2720 6973 206e 6f74 2061 6374 7561 6c6c ' is not actuall │ │ │ │ │ -0001f3b0: 7920 7573 6564 2e20 204d 6f73 740a 696d y used. Most.im │ │ │ │ │ -0001f3c0: 706f 7274 616e 746c 792c 2071 756f 7469 portantly, quoti │ │ │ │ │ -0001f3d0: 6e67 2074 6865 2066 6972 7374 2061 7267 ng the first arg │ │ │ │ │ -0001f3e0: 756d 656e 7420 6f66 2027 4143 5f44 4546 ument of 'AC_DEF │ │ │ │ │ -0001f3f0: 554e 2720 616c 6c6f 7773 2074 6865 206d UN' allows the m │ │ │ │ │ -0001f400: 6163 726f 0a74 6f20 6265 2072 6564 6566 acro.to be redef │ │ │ │ │ -0001f410: 696e 6564 206f 7220 696e 636c 7564 6564 ined or included │ │ │ │ │ -0001f420: 2074 7769 6365 2028 6f74 6865 7277 6973 twice (otherwis │ │ │ │ │ -0001f430: 6520 7468 6973 2066 6972 7374 2061 7267 e this first arg │ │ │ │ │ -0001f440: 756d 656e 7420 776f 756c 640a 6265 2065 ument would.be e │ │ │ │ │ -0001f450: 7870 616e 6465 6420 6475 7269 6e67 2074 xpanded during t │ │ │ │ │ -0001f460: 6865 2073 6563 6f6e 6420 6465 6669 6e69 he second defini │ │ │ │ │ -0001f470: 7469 6f6e 292e 2020 466f 7220 636f 6e73 tion). For cons │ │ │ │ │ -0001f480: 6973 7465 6e63 7920 7765 206c 696b 6520 istency we like │ │ │ │ │ -0001f490: 746f 0a71 756f 7465 2065 7665 6e20 6172 to.quote even ar │ │ │ │ │ -0001f4a0: 6775 6d65 6e74 7320 7375 6368 2061 7320 guments such as │ │ │ │ │ -0001f4b0: 2732 2e35 3727 2074 6861 7420 646f 206e '2.57' that do n │ │ │ │ │ -0001f4c0: 6f74 2072 6571 7569 7265 2069 742e 0a0a ot require it... │ │ │ │ │ -0001f4d0: 2020 2049 6620 796f 7520 6861 7665 2062 If you have b │ │ │ │ │ -0001f4e0: 6565 6e20 6469 7265 6374 6564 2068 6572 een directed her │ │ │ │ │ -0001f4f0: 6520 6279 2074 6865 2027 6163 6c6f 6361 e by the 'acloca │ │ │ │ │ -0001f500: 6c27 2064 6961 676e 6f73 7469 6320 6275 l' diagnostic bu │ │ │ │ │ -0001f510: 7420 6172 650a 6e6f 7420 7468 6520 6d61 t are.not the ma │ │ │ │ │ -0001f520: 696e 7461 696e 6572 206f 6620 7468 6520 intainer of the │ │ │ │ │ -0001f530: 696d 706c 6963 6174 6564 206d 6163 726f implicated macro │ │ │ │ │ -0001f540: 2c20 796f 7520 7769 6c6c 2077 616e 7420 , you will want │ │ │ │ │ -0001f550: 746f 2063 6f6e 7461 6374 2074 6865 0a6d to contact the.m │ │ │ │ │ -0001f560: 6169 6e74 6169 6e65 7220 6f66 2074 6861 aintainer of tha │ │ │ │ │ -0001f570: 7420 6d61 6372 6f2e 2020 506c 6561 7365 t macro. Please │ │ │ │ │ -0001f580: 206d 616b 6520 7375 7265 2079 6f75 2068 make sure you h │ │ │ │ │ -0001f590: 6176 6520 7468 6520 6c61 7465 7374 2076 ave the latest v │ │ │ │ │ -0001f5a0: 6572 7369 6f6e 0a6f 6620 7468 6520 6d61 ersion.of the ma │ │ │ │ │ -0001f5b0: 6372 6f20 616e 6420 7468 6174 2074 6865 cro and that the │ │ │ │ │ -0001f5c0: 2070 726f 626c 656d 2068 6173 6e27 7420 problem hasn't │ │ │ │ │ -0001f5d0: 616c 7265 6164 7920 6265 656e 2072 6570 already been rep │ │ │ │ │ -0001f5e0: 6f72 7465 6420 6265 666f 7265 0a64 6f69 orted before.doi │ │ │ │ │ -0001f5f0: 6e67 2073 6f3a 2070 656f 706c 6520 7465 ng so: people te │ │ │ │ │ -0001f600: 6e64 2074 6f20 776f 726b 2066 6173 7465 nd to work faste │ │ │ │ │ -0001f610: 7220 7768 656e 2074 6865 7920 6172 656e r when they aren │ │ │ │ │ -0001f620: 2774 2066 6c6f 6f64 6564 2062 7920 6d61 't flooded by ma │ │ │ │ │ -0001f630: 696c 732e 0a0a 2020 2041 6e6f 7468 6572 ils... Another │ │ │ │ │ -0001f640: 2073 6974 7561 7469 6f6e 2077 6865 7265 situation where │ │ │ │ │ -0001f650: 2027 6163 6c6f 6361 6c27 2069 7320 636f 'aclocal' is co │ │ │ │ │ -0001f660: 6d6d 6f6e 6c79 2075 7365 6420 6973 2074 mmonly used is t │ │ │ │ │ -0001f670: 6f20 6d61 6e61 6765 0a6d 6163 726f 7320 o manage.macros │ │ │ │ │ -0001f680: 7468 6174 2061 7265 2075 7365 6420 6c6f that are used lo │ │ │ │ │ -0001f690: 6361 6c6c 7920 6279 2074 6865 2070 6163 cally by the pac │ │ │ │ │ -0001f6a0: 6b61 6765 2c20 2a6e 6f74 6520 4c6f 6361 kage, *note Loca │ │ │ │ │ -0001f6b0: 6c20 4d61 6372 6f73 3a3a 2e0a 0a1f 0a46 l Macros::.....F │ │ │ │ │ -0001f6c0: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -0001f6d0: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -0001f6e0: 4c6f 6361 6c20 4d61 6372 6f73 2c20 204e Local Macros, N │ │ │ │ │ -0001f6f0: 6578 743a 2053 6572 6961 6c73 2c20 2050 ext: Serials, P │ │ │ │ │ -0001f700: 7265 763a 2045 7874 656e 6469 6e67 2061 rev: Extending a │ │ │ │ │ -0001f710: 636c 6f63 616c 2c20 2055 703a 2061 636c clocal, Up: acl │ │ │ │ │ -0001f720: 6f63 616c 2049 6e76 6f63 6174 696f 6e0a ocal Invocation. │ │ │ │ │ -0001f730: 0a36 2e33 2e34 2048 616e 646c 696e 6720 .6.3.4 Handling │ │ │ │ │ -0001f740: 4c6f 6361 6c20 4d61 6372 6f73 0a2d 2d2d Local Macros.--- │ │ │ │ │ +0001e970: 2d2d 2d2d 0a0a 5468 6520 2761 636c 6f63 ----..The 'acloc │ │ │ │ │ +0001e980: 616c 2720 7072 6f67 7261 6d20 646f 6573 al' program does │ │ │ │ │ +0001e990: 6e27 7420 6861 7665 2061 6e79 2062 7569 n't have any bui │ │ │ │ │ +0001e9a0: 6c74 2d69 6e20 6b6e 6f77 6c65 6467 6520 lt-in knowledge │ │ │ │ │ +0001e9b0: 6f66 2061 6e79 206d 6163 726f 732c 0a73 of any macros,.s │ │ │ │ │ +0001e9c0: 6f20 6974 2069 7320 6561 7379 2074 6f20 o it is easy to │ │ │ │ │ +0001e9d0: 6578 7465 6e64 2069 7420 7769 7468 2079 extend it with y │ │ │ │ │ +0001e9e0: 6f75 7220 6f77 6e20 6d61 6372 6f73 2e0a our own macros.. │ │ │ │ │ +0001e9f0: 0a20 2020 5468 6973 2063 616e 2062 6520 . This can be │ │ │ │ │ +0001ea00: 7573 6564 2062 7920 6c69 6272 6172 6965 used by librarie │ │ │ │ │ +0001ea10: 7320 7468 6174 2077 616e 7420 746f 2073 s that want to s │ │ │ │ │ +0001ea20: 7570 706c 7920 7468 6569 7220 6f77 6e20 upply their own │ │ │ │ │ +0001ea30: 4175 746f 636f 6e66 0a6d 6163 726f 7320 Autoconf.macros │ │ │ │ │ +0001ea40: 666f 7220 7573 6520 6279 206f 7468 6572 for use by other │ │ │ │ │ +0001ea50: 2070 726f 6772 616d 732e 2020 466f 7220 programs. For │ │ │ │ │ +0001ea60: 696e 7374 616e 6365 2c20 7468 6520 2767 instance, the 'g │ │ │ │ │ +0001ea70: 6574 7465 7874 2720 6c69 6272 6172 790a ettext' library. │ │ │ │ │ +0001ea80: 7375 7070 6c69 6573 2061 206d 6163 726f supplies a macro │ │ │ │ │ +0001ea90: 2027 414d 5f47 4e55 5f47 4554 5445 5854 'AM_GNU_GETTEXT │ │ │ │ │ +0001eaa0: 2720 7468 6174 2073 686f 756c 6420 6265 ' that should be │ │ │ │ │ +0001eab0: 2075 7365 6420 6279 2061 6e79 2070 6163 used by any pac │ │ │ │ │ +0001eac0: 6b61 6765 0a75 7369 6e67 2027 6765 7474 kage.using 'gett │ │ │ │ │ +0001ead0: 6578 7427 2e20 2057 6865 6e20 7468 6520 ext'. When the │ │ │ │ │ +0001eae0: 6c69 6272 6172 7920 6973 2069 6e73 7461 library is insta │ │ │ │ │ +0001eaf0: 6c6c 6564 2c20 6974 2069 6e73 7461 6c6c lled, it install │ │ │ │ │ +0001eb00: 7320 7468 6973 206d 6163 726f 0a73 6f20 s this macro.so │ │ │ │ │ +0001eb10: 7468 6174 2027 6163 6c6f 6361 6c27 2077 that 'aclocal' w │ │ │ │ │ +0001eb20: 696c 6c20 6669 6e64 2069 742e 0a0a 2020 ill find it... │ │ │ │ │ +0001eb30: 2041 206d 6163 726f 2066 696c 6527 7320 A macro file's │ │ │ │ │ +0001eb40: 6e61 6d65 2073 686f 756c 6420 656e 6420 name should end │ │ │ │ │ +0001eb50: 696e 2027 2e6d 3427 2e20 2053 7563 6820 in '.m4'. Such │ │ │ │ │ +0001eb60: 6669 6c65 7320 7368 6f75 6c64 2062 650a files should be. │ │ │ │ │ +0001eb70: 696e 7374 616c 6c65 6420 696e 2027 2428 installed in '$( │ │ │ │ │ +0001eb80: 6461 7461 6469 7229 2f61 636c 6f63 616c datadir)/aclocal │ │ │ │ │ +0001eb90: 272e 2020 5468 6973 2069 7320 6173 2073 '. This is as s │ │ │ │ │ +0001eba0: 696d 706c 6520 6173 2077 7269 7469 6e67 imple as writing │ │ │ │ │ +0001ebb0: 3a0a 0a20 2020 2020 6163 6c6f 6361 6c64 :.. aclocald │ │ │ │ │ +0001ebc0: 6972 203d 2024 2864 6174 6164 6972 292f ir = $(datadir)/ │ │ │ │ │ +0001ebd0: 6163 6c6f 6361 6c0a 2020 2020 2061 636c aclocal. acl │ │ │ │ │ +0001ebe0: 6f63 616c 5f44 4154 4120 3d20 6d79 6d61 ocal_DATA = myma │ │ │ │ │ +0001ebf0: 6372 6f2e 6d34 206d 796f 7468 6572 6d61 cro.m4 myotherma │ │ │ │ │ +0001ec00: 6372 6f2e 6d34 0a0a 506c 6561 7365 2064 cro.m4..Please d │ │ │ │ │ +0001ec10: 6f20 7573 6520 2724 2864 6174 6164 6972 o use '$(datadir │ │ │ │ │ +0001ec20: 292f 6163 6c6f 6361 6c27 2c20 616e 6420 )/aclocal', and │ │ │ │ │ +0001ec30: 6e6f 7420 736f 6d65 7468 696e 6720 6261 not something ba │ │ │ │ │ +0001ec40: 7365 6420 6f6e 2074 6865 0a72 6573 756c sed on the.resul │ │ │ │ │ +0001ec50: 7420 6f66 2027 6163 6c6f 6361 6c20 2d2d t of 'aclocal -- │ │ │ │ │ +0001ec60: 7072 696e 742d 6163 2d64 6972 2720 282a print-ac-dir' (* │ │ │ │ │ +0001ec70: 6e6f 7465 2048 6172 642d 436f 6465 6420 note Hard-Coded │ │ │ │ │ +0001ec80: 496e 7374 616c 6c20 5061 7468 733a 3a2c Install Paths::, │ │ │ │ │ +0001ec90: 0a66 6f72 2061 7267 756d 656e 7473 292e .for arguments). │ │ │ │ │ +0001eca0: 2020 4974 206d 6967 6874 2061 6c73 6f20 It might also │ │ │ │ │ +0001ecb0: 6265 2068 656c 7066 756c 2074 6f20 7375 be helpful to su │ │ │ │ │ +0001ecc0: 6767 6573 7420 746f 2074 6865 2075 7365 ggest to the use │ │ │ │ │ +0001ecd0: 7220 746f 2061 6464 0a74 6865 2027 2428 r to add.the '$( │ │ │ │ │ +0001ece0: 6461 7461 6469 7229 2f61 636c 6f63 616c datadir)/aclocal │ │ │ │ │ +0001ecf0: 2720 6469 7265 6374 6f72 7920 746f 2068 ' directory to h │ │ │ │ │ +0001ed00: 6973 2027 4143 4c4f 4341 4c5f 5041 5448 is 'ACLOCAL_PATH │ │ │ │ │ +0001ed10: 2720 7661 7269 6162 6c65 2028 2a6e 6f74 ' variable (*not │ │ │ │ │ +0001ed20: 650a 4143 4c4f 4341 4c5f 5041 5448 3a3a e.ACLOCAL_PATH:: │ │ │ │ │ +0001ed30: 2920 736f 2074 6861 7420 2761 636c 6f63 ) so that 'acloc │ │ │ │ │ +0001ed40: 616c 2720 7769 6c6c 2066 696e 6420 7468 al' will find th │ │ │ │ │ +0001ed50: 6520 272e 6d34 2720 6669 6c65 7320 696e e '.m4' files in │ │ │ │ │ +0001ed60: 7374 616c 6c65 6420 6279 0a79 6f75 7220 stalled by.your │ │ │ │ │ +0001ed70: 7061 636b 6167 6520 6175 746f 6d61 7469 package automati │ │ │ │ │ +0001ed80: 6361 6c6c 792e 0a0a 2020 2041 2066 696c cally... A fil │ │ │ │ │ +0001ed90: 6520 6f66 206d 6163 726f 7320 7368 6f75 e of macros shou │ │ │ │ │ +0001eda0: 6c64 2062 6520 6120 7365 7269 6573 206f ld be a series o │ │ │ │ │ +0001edb0: 6620 7072 6f70 6572 6c79 2071 756f 7465 f properly quote │ │ │ │ │ +0001edc0: 6420 2741 435f 4445 4655 4e27 2773 0a28 d 'AC_DEFUN''s.( │ │ │ │ │ +0001edd0: 2a6e 6f74 6520 2861 7574 6f63 6f6e 6629 *note (autoconf) │ │ │ │ │ +0001ede0: 4d61 6372 6f20 4465 6669 6e69 7469 6f6e Macro Definition │ │ │ │ │ +0001edf0: 733a 3a29 2e20 2054 6865 2027 6163 6c6f s::). The 'aclo │ │ │ │ │ +0001ee00: 6361 6c27 2070 726f 6772 616d 7320 616c cal' programs al │ │ │ │ │ +0001ee10: 736f 0a75 6e64 6572 7374 616e 6473 2027 so.understands ' │ │ │ │ │ +0001ee20: 4143 5f52 4551 5549 5245 2720 282a 6e6f AC_REQUIRE' (*no │ │ │ │ │ +0001ee30: 7465 2028 6175 746f 636f 6e66 2950 7265 te (autoconf)Pre │ │ │ │ │ +0001ee40: 7265 7175 6973 6974 6520 4d61 6372 6f73 requisite Macros │ │ │ │ │ +0001ee50: 3a3a 292c 2073 6f20 6974 0a69 7320 7361 ::), so it.is sa │ │ │ │ │ +0001ee60: 6665 2074 6f20 7075 7420 6561 6368 206d fe to put each m │ │ │ │ │ +0001ee70: 6163 726f 2069 6e20 6120 7365 7061 7261 acro in a separa │ │ │ │ │ +0001ee80: 7465 2066 696c 652e 2020 4561 6368 2066 te file. Each f │ │ │ │ │ +0001ee90: 696c 6520 7368 6f75 6c64 2068 6176 6520 ile should have │ │ │ │ │ +0001eea0: 6e6f 0a73 6964 6520 6566 6665 6374 7320 no.side effects │ │ │ │ │ +0001eeb0: 6275 7420 6d61 6372 6f20 6465 6669 6e69 but macro defini │ │ │ │ │ +0001eec0: 7469 6f6e 732e 2020 4573 7065 6369 616c tions. Especial │ │ │ │ │ +0001eed0: 6c79 2c20 616e 7920 6361 6c6c 2074 6f20 ly, any call to │ │ │ │ │ +0001eee0: 2741 435f 5052 4552 4551 270a 7368 6f75 'AC_PREREQ'.shou │ │ │ │ │ +0001eef0: 6c64 2062 6520 646f 6e65 2069 6e73 6964 ld be done insid │ │ │ │ │ +0001ef00: 6520 7468 6520 6465 6669 6e65 6420 6d61 e the defined ma │ │ │ │ │ +0001ef10: 6372 6f2c 206e 6f74 2061 7420 7468 6520 cro, not at the │ │ │ │ │ +0001ef20: 6265 6769 6e6e 696e 6720 6f66 2074 6865 beginning of the │ │ │ │ │ +0001ef30: 0a66 696c 652e 0a0a 2020 2053 7461 7274 .file... Start │ │ │ │ │ +0001ef40: 696e 6720 7769 7468 2041 7574 6f6d 616b ing with Automak │ │ │ │ │ +0001ef50: 6520 312e 382c 2027 6163 6c6f 6361 6c27 e 1.8, 'aclocal' │ │ │ │ │ +0001ef60: 2077 696c 6c20 7761 726e 2061 626f 7574 will warn about │ │ │ │ │ +0001ef70: 2061 6c6c 2075 6e64 6572 7175 6f74 6564 all underquoted │ │ │ │ │ +0001ef80: 0a63 616c 6c73 2074 6f20 2741 435f 4445 .calls to 'AC_DE │ │ │ │ │ +0001ef90: 4655 4e27 2e20 2057 6520 7265 616c 697a FUN'. We realiz │ │ │ │ │ +0001efa0: 6520 7468 6973 2077 696c 6c20 616e 6e6f e this will anno │ │ │ │ │ +0001efb0: 7920 6120 6c6f 7420 6f66 2070 656f 706c y a lot of peopl │ │ │ │ │ +0001efc0: 652c 0a62 6563 6175 7365 2027 6163 6c6f e,.because 'aclo │ │ │ │ │ +0001efd0: 6361 6c27 2077 6173 206e 6f74 2073 6f20 cal' was not so │ │ │ │ │ +0001efe0: 7374 7269 6374 2069 6e20 7468 6520 7061 strict in the pa │ │ │ │ │ +0001eff0: 7374 2061 6e64 206d 616e 7920 7468 6972 st and many thir │ │ │ │ │ +0001f000: 6420 7061 7274 790a 6d61 6372 6f73 2061 d party.macros a │ │ │ │ │ +0001f010: 7265 2075 6e64 6572 7175 6f74 6564 3b20 re underquoted; │ │ │ │ │ +0001f020: 616e 6420 7765 2068 6176 6520 746f 2061 and we have to a │ │ │ │ │ +0001f030: 706f 6c6f 6769 7a65 2066 6f72 2074 6869 pologize for thi │ │ │ │ │ +0001f040: 7320 7465 6d70 6f72 6172 790a 696e 636f s temporary.inco │ │ │ │ │ +0001f050: 6e76 656e 6965 6e63 652e 2020 5468 6520 nvenience. The │ │ │ │ │ +0001f060: 7265 6173 6f6e 2077 6520 6861 7665 2074 reason we have t │ │ │ │ │ +0001f070: 6f20 6265 2073 7472 6963 7465 7220 6973 o be stricter is │ │ │ │ │ +0001f080: 2074 6861 7420 6120 6675 7475 7265 0a69 that a future.i │ │ │ │ │ +0001f090: 6d70 6c65 6d65 6e74 6174 696f 6e20 6f66 mplementation of │ │ │ │ │ +0001f0a0: 2027 6163 6c6f 6361 6c27 2028 2a6e 6f74 'aclocal' (*not │ │ │ │ │ +0001f0b0: 6520 4675 7475 7265 206f 6620 6163 6c6f e Future of aclo │ │ │ │ │ +0001f0c0: 6361 6c3a 3a29 2077 696c 6c20 6861 7665 cal::) will have │ │ │ │ │ +0001f0d0: 2074 6f0a 7465 6d70 6f72 6172 696c 7920 to.temporarily │ │ │ │ │ +0001f0e0: 696e 636c 7564 6520 616c 6c20 7468 6573 include all thes │ │ │ │ │ +0001f0f0: 6520 7468 6972 6420 7061 7274 7920 272e e third party '. │ │ │ │ │ +0001f100: 6d34 2720 6669 6c65 732c 206d 6179 6265 m4' files, maybe │ │ │ │ │ +0001f110: 2073 6576 6572 616c 0a74 696d 6573 2c20 several.times, │ │ │ │ │ +0001f120: 696e 636c 7564 696e 6720 6576 656e 2066 including even f │ │ │ │ │ +0001f130: 696c 6573 2074 6861 7420 6172 6520 6e6f iles that are no │ │ │ │ │ +0001f140: 7420 6163 7475 616c 6c79 206e 6565 6465 t actually neede │ │ │ │ │ +0001f150: 642e 2020 446f 696e 6720 736f 0a73 686f d. Doing so.sho │ │ │ │ │ +0001f160: 756c 6420 616c 6c65 7669 6174 6520 6d61 uld alleviate ma │ │ │ │ │ +0001f170: 6e79 2070 726f 626c 656d 7320 6f66 2074 ny problems of t │ │ │ │ │ +0001f180: 6865 2063 7572 7265 6e74 2069 6d70 6c65 he current imple │ │ │ │ │ +0001f190: 6d65 6e74 6174 696f 6e2c 2068 6f77 6576 mentation, howev │ │ │ │ │ +0001f1a0: 6572 2069 740a 7265 7175 6972 6573 2061 er it.requires a │ │ │ │ │ +0001f1b0: 2073 7472 6963 7465 7220 7374 796c 6520 stricter style │ │ │ │ │ +0001f1c0: 6672 6f6d 2074 6865 206d 6163 726f 2061 from the macro a │ │ │ │ │ +0001f1d0: 7574 686f 7273 2e20 2048 6f70 6566 756c uthors. Hopeful │ │ │ │ │ +0001f1e0: 6c79 2069 7420 6973 2065 6173 790a 746f ly it is easy.to │ │ │ │ │ +0001f1f0: 2072 6576 6973 6520 7468 6520 6578 6973 revise the exis │ │ │ │ │ +0001f200: 7469 6e67 206d 6163 726f 732e 2020 466f ting macros. Fo │ │ │ │ │ +0001f210: 7220 696e 7374 616e 6365 2c0a 0a20 2020 r instance,.. │ │ │ │ │ +0001f220: 2020 2320 6261 6420 7374 796c 650a 2020 # bad style. │ │ │ │ │ +0001f230: 2020 2041 435f 5052 4552 4551 2832 2e35 AC_PREREQ(2.5 │ │ │ │ │ +0001f240: 3729 0a20 2020 2020 4143 5f44 4546 554e 7). AC_DEFUN │ │ │ │ │ +0001f250: 2841 585f 464f 4f42 4152 2c0a 2020 2020 (AX_FOOBAR,. │ │ │ │ │ +0001f260: 205b 4143 5f52 4551 5549 5245 285b 4158 [AC_REQUIRE([AX │ │ │ │ │ +0001f270: 5f53 4f4d 4554 4849 4e47 5d29 646e 6c0a _SOMETHING])dnl. │ │ │ │ │ +0001f280: 2020 2020 2041 585f 464f 4f0a 2020 2020 AX_FOO. │ │ │ │ │ +0001f290: 2041 585f 4241 520a 2020 2020 205d 290a AX_BAR. ]). │ │ │ │ │ +0001f2a0: 0a73 686f 756c 6420 6265 2072 6577 7269 .should be rewri │ │ │ │ │ +0001f2b0: 7474 656e 2061 730a 0a20 2020 2020 4143 tten as.. AC │ │ │ │ │ +0001f2c0: 5f44 4546 554e 285b 4158 5f46 4f4f 4241 _DEFUN([AX_FOOBA │ │ │ │ │ +0001f2d0: 525d 2c0a 2020 2020 205b 4143 5f50 5245 R],. [AC_PRE │ │ │ │ │ +0001f2e0: 5245 5128 5b32 2e35 375d 2964 6e6c 0a20 REQ([2.57])dnl. │ │ │ │ │ +0001f2f0: 2020 2020 4143 5f52 4551 5549 5245 285b AC_REQUIRE([ │ │ │ │ │ +0001f300: 4158 5f53 4f4d 4554 4849 4e47 5d29 646e AX_SOMETHING])dn │ │ │ │ │ +0001f310: 6c0a 2020 2020 2041 585f 464f 4f0a 2020 l. AX_FOO. │ │ │ │ │ +0001f320: 2020 2041 585f 4241 520a 2020 2020 205d AX_BAR. ] │ │ │ │ │ +0001f330: 290a 0a20 2020 5772 6170 7069 6e67 2074 ).. Wrapping t │ │ │ │ │ +0001f340: 6865 2027 4143 5f50 5245 5245 5127 2063 he 'AC_PREREQ' c │ │ │ │ │ +0001f350: 616c 6c20 696e 7369 6465 2074 6865 206d all inside the m │ │ │ │ │ +0001f360: 6163 726f 2065 6e73 7572 6573 2074 6861 acro ensures tha │ │ │ │ │ +0001f370: 7420 4175 746f 636f 6e66 0a32 2e35 3720 t Autoconf.2.57 │ │ │ │ │ +0001f380: 7769 6c6c 206e 6f74 2062 6520 7265 7175 will not be requ │ │ │ │ │ +0001f390: 6972 6564 2069 6620 2741 585f 464f 4f42 ired if 'AX_FOOB │ │ │ │ │ +0001f3a0: 4152 2720 6973 206e 6f74 2061 6374 7561 AR' is not actua │ │ │ │ │ +0001f3b0: 6c6c 7920 7573 6564 2e20 204d 6f73 740a lly used. Most. │ │ │ │ │ +0001f3c0: 696d 706f 7274 616e 746c 792c 2071 756f importantly, quo │ │ │ │ │ +0001f3d0: 7469 6e67 2074 6865 2066 6972 7374 2061 ting the first a │ │ │ │ │ +0001f3e0: 7267 756d 656e 7420 6f66 2027 4143 5f44 rgument of 'AC_D │ │ │ │ │ +0001f3f0: 4546 554e 2720 616c 6c6f 7773 2074 6865 EFUN' allows the │ │ │ │ │ +0001f400: 206d 6163 726f 0a74 6f20 6265 2072 6564 macro.to be red │ │ │ │ │ +0001f410: 6566 696e 6564 206f 7220 696e 636c 7564 efined or includ │ │ │ │ │ +0001f420: 6564 2074 7769 6365 2028 6f74 6865 7277 ed twice (otherw │ │ │ │ │ +0001f430: 6973 6520 7468 6973 2066 6972 7374 2061 ise this first a │ │ │ │ │ +0001f440: 7267 756d 656e 7420 776f 756c 640a 6265 rgument would.be │ │ │ │ │ +0001f450: 2065 7870 616e 6465 6420 6475 7269 6e67 expanded during │ │ │ │ │ +0001f460: 2074 6865 2073 6563 6f6e 6420 6465 6669 the second defi │ │ │ │ │ +0001f470: 6e69 7469 6f6e 292e 2020 466f 7220 636f nition). For co │ │ │ │ │ +0001f480: 6e73 6973 7465 6e63 7920 7765 206c 696b nsistency we lik │ │ │ │ │ +0001f490: 6520 746f 0a71 756f 7465 2065 7665 6e20 e to.quote even │ │ │ │ │ +0001f4a0: 6172 6775 6d65 6e74 7320 7375 6368 2061 arguments such a │ │ │ │ │ +0001f4b0: 7320 2732 2e35 3727 2074 6861 7420 646f s '2.57' that do │ │ │ │ │ +0001f4c0: 206e 6f74 2072 6571 7569 7265 2069 742e not require it. │ │ │ │ │ +0001f4d0: 0a0a 2020 2049 6620 796f 7520 6861 7665 .. If you have │ │ │ │ │ +0001f4e0: 2062 6565 6e20 6469 7265 6374 6564 2068 been directed h │ │ │ │ │ +0001f4f0: 6572 6520 6279 2074 6865 2027 6163 6c6f ere by the 'aclo │ │ │ │ │ +0001f500: 6361 6c27 2064 6961 676e 6f73 7469 6320 cal' diagnostic │ │ │ │ │ +0001f510: 6275 7420 6172 650a 6e6f 7420 7468 6520 but are.not the │ │ │ │ │ +0001f520: 6d61 696e 7461 696e 6572 206f 6620 7468 maintainer of th │ │ │ │ │ +0001f530: 6520 696d 706c 6963 6174 6564 206d 6163 e implicated mac │ │ │ │ │ +0001f540: 726f 2c20 796f 7520 7769 6c6c 2077 616e ro, you will wan │ │ │ │ │ +0001f550: 7420 746f 2063 6f6e 7461 6374 2074 6865 t to contact the │ │ │ │ │ +0001f560: 0a6d 6169 6e74 6169 6e65 7220 6f66 2074 .maintainer of t │ │ │ │ │ +0001f570: 6861 7420 6d61 6372 6f2e 2020 506c 6561 hat macro. Plea │ │ │ │ │ +0001f580: 7365 206d 616b 6520 7375 7265 2079 6f75 se make sure you │ │ │ │ │ +0001f590: 2068 6176 6520 7468 6520 6c61 7465 7374 have the latest │ │ │ │ │ +0001f5a0: 2076 6572 7369 6f6e 0a6f 6620 7468 6520 version.of the │ │ │ │ │ +0001f5b0: 6d61 6372 6f20 616e 6420 7468 6174 2074 macro and that t │ │ │ │ │ +0001f5c0: 6865 2070 726f 626c 656d 2068 6173 6e27 he problem hasn' │ │ │ │ │ +0001f5d0: 7420 616c 7265 6164 7920 6265 656e 2072 t already been r │ │ │ │ │ +0001f5e0: 6570 6f72 7465 6420 6265 666f 7265 0a64 eported before.d │ │ │ │ │ +0001f5f0: 6f69 6e67 2073 6f3a 2070 656f 706c 6520 oing so: people │ │ │ │ │ +0001f600: 7465 6e64 2074 6f20 776f 726b 2066 6173 tend to work fas │ │ │ │ │ +0001f610: 7465 7220 7768 656e 2074 6865 7920 6172 ter when they ar │ │ │ │ │ +0001f620: 656e 2774 2066 6c6f 6f64 6564 2062 7920 en't flooded by │ │ │ │ │ +0001f630: 6d61 696c 732e 0a0a 2020 2041 6e6f 7468 mails... Anoth │ │ │ │ │ +0001f640: 6572 2073 6974 7561 7469 6f6e 2077 6865 er situation whe │ │ │ │ │ +0001f650: 7265 2027 6163 6c6f 6361 6c27 2069 7320 re 'aclocal' is │ │ │ │ │ +0001f660: 636f 6d6d 6f6e 6c79 2075 7365 6420 6973 commonly used is │ │ │ │ │ +0001f670: 2074 6f20 6d61 6e61 6765 0a6d 6163 726f to manage.macro │ │ │ │ │ +0001f680: 7320 7468 6174 2061 7265 2075 7365 6420 s that are used │ │ │ │ │ +0001f690: 6c6f 6361 6c6c 7920 6279 2074 6865 2070 locally by the p │ │ │ │ │ +0001f6a0: 6163 6b61 6765 2c20 2a6e 6f74 6520 4c6f ackage, *note Lo │ │ │ │ │ +0001f6b0: 6361 6c20 4d61 6372 6f73 3a3a 2e0a 0a1f cal Macros::.... │ │ │ │ │ +0001f6c0: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +0001f6d0: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +0001f6e0: 3a20 4c6f 6361 6c20 4d61 6372 6f73 2c20 : Local Macros, │ │ │ │ │ +0001f6f0: 204e 6578 743a 2053 6572 6961 6c73 2c20 Next: Serials, │ │ │ │ │ +0001f700: 2050 7265 763a 2045 7874 656e 6469 6e67 Prev: Extending │ │ │ │ │ +0001f710: 2061 636c 6f63 616c 2c20 2055 703a 2061 aclocal, Up: a │ │ │ │ │ +0001f720: 636c 6f63 616c 2049 6e76 6f63 6174 696f clocal Invocatio │ │ │ │ │ +0001f730: 6e0a 0a36 2e33 2e34 2048 616e 646c 696e n..6.3.4 Handlin │ │ │ │ │ +0001f740: 6720 4c6f 6361 6c20 4d61 6372 6f73 0a2d g Local Macros.- │ │ │ │ │ 0001f750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0001f760: 2d2d 2d2d 2d2d 2d2d 0a0a 4665 6174 7572 --------..Featur │ │ │ │ │ -0001f770: 6520 7465 7374 7320 6f66 6665 7265 6420 e tests offered │ │ │ │ │ -0001f780: 6279 2041 7574 6f63 6f6e 6620 646f 206e by Autoconf do n │ │ │ │ │ -0001f790: 6f74 2063 6f76 6572 2061 6c6c 206e 6565 ot cover all nee │ │ │ │ │ -0001f7a0: 6473 2e20 2050 656f 706c 6520 6f66 7465 ds. People ofte │ │ │ │ │ -0001f7b0: 6e0a 6861 7665 2074 6f20 7375 7070 6c65 n.have to supple │ │ │ │ │ -0001f7c0: 6d65 6e74 2065 7869 7374 696e 6720 7465 ment existing te │ │ │ │ │ -0001f7d0: 7374 7320 7769 7468 2074 6865 6972 206f sts with their o │ │ │ │ │ -0001f7e0: 776e 206d 6163 726f 732c 206f 7220 7769 wn macros, or wi │ │ │ │ │ -0001f7f0: 7468 0a74 6869 7264 2d70 6172 7479 206d th.third-party m │ │ │ │ │ -0001f800: 6163 726f 732e 0a0a 2020 2054 6865 7265 acros... There │ │ │ │ │ -0001f810: 2061 7265 2074 776f 2077 6179 7320 746f are two ways to │ │ │ │ │ -0001f820: 206f 7267 616e 697a 6520 6375 7374 6f6d organize custom │ │ │ │ │ -0001f830: 206d 6163 726f 7320 696e 2061 2070 6163 macros in a pac │ │ │ │ │ -0001f840: 6b61 6765 2e0a 0a20 2020 5468 6520 6669 kage... The fi │ │ │ │ │ -0001f850: 7273 7420 706f 7373 6962 696c 6974 7920 rst possibility │ │ │ │ │ -0001f860: 2874 6865 2068 6973 746f 7269 6361 6c20 (the historical │ │ │ │ │ -0001f870: 7072 6163 7469 6365 2920 6973 2074 6f20 practice) is to │ │ │ │ │ -0001f880: 6c69 7374 2061 6c6c 2079 6f75 720a 6d61 list all your.ma │ │ │ │ │ -0001f890: 6372 6f73 2069 6e20 2761 6369 6e63 6c75 cros in 'acinclu │ │ │ │ │ -0001f8a0: 6465 2e6d 3427 2e20 2054 6869 7320 6669 de.m4'. This fi │ │ │ │ │ -0001f8b0: 6c65 2077 696c 6c20 6265 2069 6e63 6c75 le will be inclu │ │ │ │ │ -0001f8c0: 6465 6420 696e 2027 6163 6c6f 6361 6c2e ded in 'aclocal. │ │ │ │ │ -0001f8d0: 6d34 270a 7768 656e 2079 6f75 2072 756e m4'.when you run │ │ │ │ │ -0001f8e0: 2027 6163 6c6f 6361 6c27 2c20 616e 6420 'aclocal', and │ │ │ │ │ -0001f8f0: 6974 7320 6d61 6372 6f28 7329 2077 696c its macro(s) wil │ │ │ │ │ -0001f900: 6c20 6865 6e63 6566 6f72 7468 2062 6520 l henceforth be │ │ │ │ │ -0001f910: 7669 7369 626c 6520 746f 0a27 6175 746f visible to.'auto │ │ │ │ │ -0001f920: 636f 6e66 272e 2020 486f 7765 7665 7220 conf'. However │ │ │ │ │ -0001f930: 6966 2069 7420 636f 6e74 6169 6e73 206e if it contains n │ │ │ │ │ -0001f940: 756d 6572 6f75 7320 6d61 6372 6f73 2c20 umerous macros, │ │ │ │ │ -0001f950: 6974 2077 696c 6c20 7261 7069 646c 790a it will rapidly. │ │ │ │ │ -0001f960: 6265 636f 6d65 2064 6966 6669 6375 6c74 become difficult │ │ │ │ │ -0001f970: 2074 6f20 6d61 696e 7461 696e 2c20 616e to maintain, an │ │ │ │ │ -0001f980: 6420 6974 2077 696c 6c20 6265 2061 6c6d d it will be alm │ │ │ │ │ -0001f990: 6f73 7420 696d 706f 7373 6962 6c65 2074 ost impossible t │ │ │ │ │ -0001f9a0: 6f20 7368 6172 650a 6d61 6372 6f73 2062 o share.macros b │ │ │ │ │ -0001f9b0: 6574 7765 656e 2070 6163 6b61 6765 732e etween packages. │ │ │ │ │ -0001f9c0: 0a0a 2020 2054 6865 2073 6563 6f6e 6420 .. The second │ │ │ │ │ -0001f9d0: 706f 7373 6962 696c 6974 792c 2077 6869 possibility, whi │ │ │ │ │ -0001f9e0: 6368 2077 6520 646f 2072 6563 6f6d 6d65 ch we do recomme │ │ │ │ │ -0001f9f0: 6e64 2c20 6973 2074 6f20 7772 6974 6520 nd, is to write │ │ │ │ │ -0001fa00: 6561 6368 206d 6163 726f 0a69 6e20 6974 each macro.in it │ │ │ │ │ -0001fa10: 7320 6f77 6e20 6669 6c65 2061 6e64 2067 s own file and g │ │ │ │ │ -0001fa20: 6174 6865 7220 616c 6c20 7468 6573 6520 ather all these │ │ │ │ │ -0001fa30: 6669 6c65 7320 696e 2061 2064 6972 6563 files in a direc │ │ │ │ │ -0001fa40: 746f 7279 2e20 2054 6869 730a 6469 7265 tory. This.dire │ │ │ │ │ -0001fa50: 6374 6f72 7920 6973 2075 7375 616c 6c79 ctory is usually │ │ │ │ │ -0001fa60: 2063 616c 6c65 6420 276d 342f 272e 2020 called 'm4/'. │ │ │ │ │ -0001fa70: 546f 2062 7569 6c64 2027 6163 6c6f 6361 To build 'acloca │ │ │ │ │ -0001fa80: 6c2e 6d34 272c 206f 6e65 2073 686f 756c l.m4', one shoul │ │ │ │ │ -0001fa90: 640a 7468 6572 6566 6f72 6520 696e 7374 d.therefore inst │ │ │ │ │ -0001faa0: 7275 6374 2027 6163 6c6f 6361 6c27 2074 ruct 'aclocal' t │ │ │ │ │ -0001fab0: 6f20 7363 616e 2027 6d34 2f27 2e20 2046 o scan 'm4/'. F │ │ │ │ │ -0001fac0: 726f 6d20 7468 6520 636f 6d6d 616e 6420 rom the command │ │ │ │ │ -0001fad0: 6c69 6e65 2c20 7468 6973 0a69 7320 646f line, this.is do │ │ │ │ │ -0001fae0: 6e65 2077 6974 6820 2761 636c 6f63 616c ne with 'aclocal │ │ │ │ │ -0001faf0: 202d 4920 6d34 272e 2020 5468 6520 746f -I m4'. The to │ │ │ │ │ -0001fb00: 702d 6c65 7665 6c20 274d 616b 6566 696c p-level 'Makefil │ │ │ │ │ -0001fb10: 652e 616d 2720 7368 6f75 6c64 2061 6c73 e.am' should als │ │ │ │ │ -0001fb20: 6f0a 6265 2075 7064 6174 6564 2074 6f20 o.be updated to │ │ │ │ │ -0001fb30: 6465 6669 6e65 0a0a 2020 2020 2041 434c define.. ACL │ │ │ │ │ -0001fb40: 4f43 414c 5f41 4d46 4c41 4753 203d 202d OCAL_AMFLAGS = - │ │ │ │ │ -0001fb50: 4920 6d34 0a0a 2020 2027 4143 4c4f 4341 I m4.. 'ACLOCA │ │ │ │ │ -0001fb60: 4c5f 414d 464c 4147 5327 2063 6f6e 7461 L_AMFLAGS' conta │ │ │ │ │ -0001fb70: 696e 7320 6f70 7469 6f6e 7320 746f 2070 ins options to p │ │ │ │ │ -0001fb80: 6173 7320 746f 2027 6163 6c6f 6361 6c27 ass to 'aclocal' │ │ │ │ │ -0001fb90: 2077 6865 6e0a 2761 636c 6f63 616c 2e6d when.'aclocal.m │ │ │ │ │ -0001fba0: 3427 2069 7320 746f 2062 6520 7265 6275 4' is to be rebu │ │ │ │ │ -0001fbb0: 696c 7420 6279 2027 6d61 6b65 272e 2020 ilt by 'make'. │ │ │ │ │ -0001fbc0: 5468 6973 206c 696e 6520 6973 2061 6c73 This line is als │ │ │ │ │ -0001fbd0: 6f20 7573 6564 2062 790a 2761 7574 6f72 o used by.'autor │ │ │ │ │ -0001fbe0: 6563 6f6e 6627 2028 2a6e 6f74 6520 5573 econf' (*note Us │ │ │ │ │ -0001fbf0: 696e 6720 2761 7574 6f72 6563 6f6e 6627 ing 'autoreconf' │ │ │ │ │ -0001fc00: 2074 6f20 5570 6461 7465 2027 636f 6e66 to Update 'conf │ │ │ │ │ -0001fc10: 6967 7572 6527 2053 6372 6970 7473 3a0a igure' Scripts:. │ │ │ │ │ -0001fc20: 2861 7574 6f63 6f6e 6629 6175 746f 7265 (autoconf)autore │ │ │ │ │ -0001fc30: 636f 6e66 2049 6e76 6f63 6174 696f 6e2e conf Invocation. │ │ │ │ │ -0001fc40: 2920 746f 2072 756e 2027 6163 6c6f 6361 ) to run 'acloca │ │ │ │ │ -0001fc50: 6c27 2077 6974 6820 7375 6974 6162 6c65 l' with suitable │ │ │ │ │ -0001fc60: 0a6f 7074 696f 6e73 2c20 6f72 2062 7920 .options, or by │ │ │ │ │ -0001fc70: 2761 7574 6f70 6f69 6e74 2720 282a 6e6f 'autopoint' (*no │ │ │ │ │ -0001fc80: 7465 2049 6e76 6f6b 696e 6720 7468 6520 te Invoking the │ │ │ │ │ -0001fc90: 2761 7574 6f70 6f69 6e74 2720 5072 6f67 'autopoint' Prog │ │ │ │ │ -0001fca0: 7261 6d3a 0a28 6765 7474 6578 7429 6175 ram:.(gettext)au │ │ │ │ │ -0001fcb0: 746f 706f 696e 7420 496e 766f 6361 7469 topoint Invocati │ │ │ │ │ -0001fcc0: 6f6e 2e29 2061 6e64 2027 6765 7474 6578 on.) and 'gettex │ │ │ │ │ -0001fcd0: 7469 7a65 2720 282a 6e6f 7465 2049 6e76 tize' (*note Inv │ │ │ │ │ -0001fce0: 6f6b 696e 6720 7468 650a 2767 6574 7465 oking the.'gette │ │ │ │ │ -0001fcf0: 7874 697a 6527 2050 726f 6772 616d 3a20 xtize' Program: │ │ │ │ │ -0001fd00: 2867 6574 7465 7874 2967 6574 7465 7874 (gettext)gettext │ │ │ │ │ -0001fd10: 697a 6520 496e 766f 6361 7469 6f6e 2e29 ize Invocation.) │ │ │ │ │ -0001fd20: 2074 6f20 6c6f 6361 7465 2074 6865 0a70 to locate the.p │ │ │ │ │ -0001fd30: 6c61 6365 2077 6865 7265 2047 6574 7465 lace where Gette │ │ │ │ │ -0001fd40: 7874 2773 206d 6163 726f 7320 7368 6f75 xt's macros shou │ │ │ │ │ -0001fd50: 6c64 2062 6520 696e 7374 616c 6c65 642e ld be installed. │ │ │ │ │ -0001fd60: 2020 536f 2065 7665 6e20 6966 2079 6f75 So even if you │ │ │ │ │ -0001fd70: 2064 6f20 6e6f 740a 7265 616c 6c79 2063 do not.really c │ │ │ │ │ -0001fd80: 6172 6520 6162 6f75 7420 7468 6520 7265 are about the re │ │ │ │ │ -0001fd90: 6275 696c 6420 7275 6c65 732c 2079 6f75 build rules, you │ │ │ │ │ -0001fda0: 2073 686f 756c 6420 6465 6669 6e65 0a27 should define.' │ │ │ │ │ -0001fdb0: 4143 4c4f 4341 4c5f 414d 464c 4147 5327 ACLOCAL_AMFLAGS' │ │ │ │ │ -0001fdc0: 2e0a 0a20 2020 5768 656e 2027 6163 6c6f ... When 'aclo │ │ │ │ │ -0001fdd0: 6361 6c20 2d49 206d 3427 2069 7320 7275 cal -I m4' is ru │ │ │ │ │ -0001fde0: 6e2c 2069 7420 7769 6c6c 2062 7569 6c64 n, it will build │ │ │ │ │ -0001fdf0: 2061 6e20 2761 636c 6f63 616c 2e6d 3427 an 'aclocal.m4' │ │ │ │ │ -0001fe00: 2074 6861 740a 276d 345f 696e 636c 7564 that.'m4_includ │ │ │ │ │ -0001fe10: 6527 7320 616e 7920 6669 6c65 2066 726f e's any file fro │ │ │ │ │ -0001fe20: 6d20 276d 342f 2720 7468 6174 2064 6566 m 'm4/' that def │ │ │ │ │ -0001fe30: 696e 6573 2061 2072 6571 7569 7265 6420 ines a required │ │ │ │ │ -0001fe40: 6d61 6372 6f2e 2020 4d61 6372 6f73 0a6e macro. Macros.n │ │ │ │ │ -0001fe50: 6f74 2066 6f75 6e64 206c 6f63 616c 6c79 ot found locally │ │ │ │ │ -0001fe60: 2077 696c 6c20 7374 696c 6c20 6265 2073 will still be s │ │ │ │ │ -0001fe70: 6561 7263 6865 6420 696e 2073 7973 7465 earched in syste │ │ │ │ │ -0001fe80: 6d2d 7769 6465 2064 6972 6563 746f 7269 m-wide directori │ │ │ │ │ -0001fe90: 6573 2c20 6173 0a65 7870 6c61 696e 6564 es, as.explained │ │ │ │ │ -0001fea0: 2069 6e20 2a6e 6f74 6520 4d61 6372 6f20 in *note Macro │ │ │ │ │ -0001feb0: 5365 6172 6368 2050 6174 683a 3a2e 0a0a Search Path::... │ │ │ │ │ -0001fec0: 2020 2043 7573 746f 6d20 6d61 6372 6f73 Custom macros │ │ │ │ │ -0001fed0: 2073 686f 756c 6420 6265 2064 6973 7472 should be distr │ │ │ │ │ -0001fee0: 6962 7574 6564 2066 6f72 2074 6865 2073 ibuted for the s │ │ │ │ │ -0001fef0: 616d 6520 7265 6173 6f6e 2074 6861 740a ame reason that. │ │ │ │ │ -0001ff00: 2763 6f6e 6669 6775 7265 2e61 6327 2069 'configure.ac' i │ │ │ │ │ -0001ff10: 733a 2073 6f20 7468 6174 206f 7468 6572 s: so that other │ │ │ │ │ -0001ff20: 2070 656f 706c 6520 6861 7665 2061 6c6c people have all │ │ │ │ │ -0001ff30: 2074 6865 2073 6f75 7263 6573 206f 6620 the sources of │ │ │ │ │ -0001ff40: 796f 7572 0a70 6163 6b61 6765 2069 6620 your.package if │ │ │ │ │ -0001ff50: 7468 6579 2077 616e 7420 746f 2077 6f72 they want to wor │ │ │ │ │ -0001ff60: 6b20 6f6e 2069 742e 2020 4163 7475 616c k on it. Actual │ │ │ │ │ -0001ff70: 6c79 2c20 7468 6973 2064 6973 7472 6962 ly, this distrib │ │ │ │ │ -0001ff80: 7574 696f 6e20 6861 7070 656e 730a 6175 ution happens.au │ │ │ │ │ -0001ff90: 746f 6d61 7469 6361 6c6c 7920 6265 6361 tomatically beca │ │ │ │ │ -0001ffa0: 7573 6520 616c 6c20 276d 345f 696e 636c use all 'm4_incl │ │ │ │ │ -0001ffb0: 7564 6527 6420 6669 6c65 7320 6172 6520 ude'd files are │ │ │ │ │ -0001ffc0: 6469 7374 7269 6275 7465 642e 0a0a 2020 distributed... │ │ │ │ │ -0001ffd0: 2048 6f77 6576 6572 2074 6865 7265 2069 However there i │ │ │ │ │ -0001ffe0: 7320 6e6f 2063 6f6e 7365 6e73 7573 206f s no consensus o │ │ │ │ │ -0001fff0: 6e20 7468 6520 6469 7374 7269 6275 7469 n the distributi │ │ │ │ │ -00020000: 6f6e 206f 6620 7468 6972 642d 7061 7274 on of third-part │ │ │ │ │ -00020010: 790a 6d61 6372 6f73 2074 6861 7420 796f y.macros that yo │ │ │ │ │ -00020020: 7572 2070 6163 6b61 6765 206d 6179 2075 ur package may u │ │ │ │ │ -00020030: 7365 2e20 204d 616e 7920 6c69 6272 6172 se. Many librar │ │ │ │ │ -00020040: 6965 7320 696e 7374 616c 6c20 7468 6569 ies install thei │ │ │ │ │ -00020050: 7220 6f77 6e0a 6d61 6372 6f20 696e 2074 r own.macro in t │ │ │ │ │ -00020060: 6865 2073 7973 7465 6d2d 7769 6465 2027 he system-wide ' │ │ │ │ │ -00020070: 6163 6c6f 6361 6c27 2064 6972 6563 746f aclocal' directo │ │ │ │ │ -00020080: 7279 2028 2a6e 6f74 6520 4578 7465 6e64 ry (*note Extend │ │ │ │ │ -00020090: 696e 670a 6163 6c6f 6361 6c3a 3a29 2e20 ing.aclocal::). │ │ │ │ │ -000200a0: 2046 6f72 2069 6e73 7461 6e63 652c 2047 For instance, G │ │ │ │ │ -000200b0: 7569 6c65 2073 6869 7073 2077 6974 6820 uile ships with │ │ │ │ │ -000200c0: 6120 6669 6c65 2063 616c 6c65 6420 2767 a file called 'g │ │ │ │ │ -000200d0: 7569 6c65 2e6d 3427 0a74 6861 7420 636f uile.m4'.that co │ │ │ │ │ -000200e0: 6e74 6169 6e73 2074 6865 206d 6163 726f ntains the macro │ │ │ │ │ -000200f0: 2027 4755 494c 455f 464c 4147 5327 2074 'GUILE_FLAGS' t │ │ │ │ │ -00020100: 6861 7420 6361 6e20 6265 2075 7365 6420 hat can be used │ │ │ │ │ -00020110: 746f 2064 6566 696e 6520 7365 7475 700a to define setup. │ │ │ │ │ -00020120: 636f 6d70 696c 6572 2061 6e64 206c 696e compiler and lin │ │ │ │ │ -00020130: 6b65 7220 666c 6167 7320 6170 7072 6f70 ker flags approp │ │ │ │ │ -00020140: 7269 6174 6520 666f 7220 7573 696e 6720 riate for using │ │ │ │ │ -00020150: 4775 696c 652e 2020 5573 696e 670a 2747 Guile. Using.'G │ │ │ │ │ -00020160: 5549 4c45 5f46 4c41 4753 2720 696e 2027 UILE_FLAGS' in ' │ │ │ │ │ -00020170: 636f 6e66 6967 7572 652e 6163 2720 7769 configure.ac' wi │ │ │ │ │ -00020180: 6c6c 2063 6175 7365 2027 6163 6c6f 6361 ll cause 'acloca │ │ │ │ │ -00020190: 6c27 2074 6f20 636f 7079 2027 6775 696c l' to copy 'guil │ │ │ │ │ -000201a0: 652e 6d34 270a 696e 746f 2027 6163 6c6f e.m4'.into 'aclo │ │ │ │ │ -000201b0: 6361 6c2e 6d34 272c 2062 7574 2061 7320 cal.m4', but as │ │ │ │ │ -000201c0: 2767 7569 6c65 2e6d 3427 2069 7320 6e6f 'guile.m4' is no │ │ │ │ │ -000201d0: 7420 7061 7274 206f 6620 7468 6520 7072 t part of the pr │ │ │ │ │ -000201e0: 6f6a 6563 742c 2069 7420 7769 6c6c 0a6e oject, it will.n │ │ │ │ │ -000201f0: 6f74 2062 6520 6469 7374 7269 6275 7465 ot be distribute │ │ │ │ │ -00020200: 642e 2020 5465 6368 6e69 6361 6c6c 792c d. Technically, │ │ │ │ │ -00020210: 2074 6861 7420 6d65 616e 7320 6120 7573 that means a us │ │ │ │ │ -00020220: 6572 2077 686f 206e 6565 6473 2074 6f20 er who needs to │ │ │ │ │ -00020230: 7265 6275 696c 640a 2761 636c 6f63 616c rebuild.'aclocal │ │ │ │ │ -00020240: 2e6d 3427 2077 696c 6c20 6861 7665 2074 .m4' will have t │ │ │ │ │ -00020250: 6f20 696e 7374 616c 6c20 4775 696c 6520 o install Guile │ │ │ │ │ -00020260: 6669 7273 742e 2020 5468 6973 2069 7320 first. This is │ │ │ │ │ -00020270: 7072 6f62 6162 6c79 204f 4b2c 2069 660a probably OK, if. │ │ │ │ │ -00020280: 4775 696c 6520 616c 7265 6164 7920 6973 Guile already is │ │ │ │ │ -00020290: 2061 2072 6571 7569 7265 6d65 6e74 2074 a requirement t │ │ │ │ │ -000202a0: 6f20 6275 696c 6420 7468 6520 7061 636b o build the pack │ │ │ │ │ -000202b0: 6167 652e 2020 486f 7765 7665 722c 2069 age. However, i │ │ │ │ │ -000202c0: 6620 4775 696c 650a 6973 206f 6e6c 7920 f Guile.is only │ │ │ │ │ -000202d0: 616e 206f 7074 696f 6e61 6c20 6665 6174 an optional feat │ │ │ │ │ -000202e0: 7572 652c 206f 7220 6966 2079 6f75 7220 ure, or if your │ │ │ │ │ -000202f0: 7061 636b 6167 6520 6d69 6768 7420 7275 package might ru │ │ │ │ │ -00020300: 6e20 6f6e 0a61 7263 6869 7465 6374 7572 n on.architectur │ │ │ │ │ -00020310: 6573 2077 6865 7265 2047 7569 6c65 2063 es where Guile c │ │ │ │ │ -00020320: 616e 6e6f 7420 6265 2069 6e73 7461 6c6c annot be install │ │ │ │ │ -00020330: 6564 2c20 7468 6973 2072 6571 7569 7265 ed, this require │ │ │ │ │ -00020340: 6d65 6e74 2077 696c 6c0a 6869 6e64 6572 ment will.hinder │ │ │ │ │ -00020350: 2064 6576 656c 6f70 6d65 6e74 2e20 2041 development. A │ │ │ │ │ -00020360: 6e20 6561 7379 2073 6f6c 7574 696f 6e20 n easy solution │ │ │ │ │ -00020370: 6973 2074 6f20 636f 7079 2073 7563 6820 is to copy such │ │ │ │ │ -00020380: 7468 6972 642d 7061 7274 7920 6d61 6372 third-party macr │ │ │ │ │ -00020390: 6f73 0a69 6e20 796f 7572 206c 6f63 616c os.in your local │ │ │ │ │ -000203a0: 2027 6d34 2f27 2064 6972 6563 746f 7279 'm4/' directory │ │ │ │ │ -000203b0: 2073 6f20 7468 6579 2067 6574 2064 6973 so they get dis │ │ │ │ │ -000203c0: 7472 6962 7574 6564 2e0a 0a20 2020 5369 tributed... Si │ │ │ │ │ -000203d0: 6e63 6520 4175 746f 6d61 6b65 2031 2e31 nce Automake 1.1 │ │ │ │ │ -000203e0: 302c 2027 6163 6c6f 6361 6c27 206f 6666 0, 'aclocal' off │ │ │ │ │ -000203f0: 6572 7320 616e 206f 7074 696f 6e20 746f ers an option to │ │ │ │ │ -00020400: 2063 6f70 7920 7468 6573 650a 7379 7374 copy these.syst │ │ │ │ │ -00020410: 656d 2d77 6964 6520 7468 6972 642d 7061 em-wide third-pa │ │ │ │ │ -00020420: 7274 7920 6d61 6372 6f73 2069 6e20 796f rty macros in yo │ │ │ │ │ -00020430: 7572 206c 6f63 616c 206d 6163 726f 2064 ur local macro d │ │ │ │ │ -00020440: 6972 6563 746f 7279 2c20 736f 6c76 696e irectory, solvin │ │ │ │ │ -00020450: 670a 7468 6520 6162 6f76 6520 7072 6f62 g.the above prob │ │ │ │ │ -00020460: 6c65 6d2e 2020 5369 6d70 6c79 2075 7365 lem. Simply use │ │ │ │ │ -00020470: 3a0a 0a20 2020 2020 4143 4c4f 4341 4c5f :.. ACLOCAL_ │ │ │ │ │ -00020480: 414d 464c 4147 5320 3d20 2d49 206d 3420 AMFLAGS = -I m4 │ │ │ │ │ -00020490: 2d2d 696e 7374 616c 6c0a 0a57 6974 6820 --install..With │ │ │ │ │ -000204a0: 7468 6973 2073 6574 7570 2c20 7379 7374 this setup, syst │ │ │ │ │ -000204b0: 656d 2d77 6964 6520 6d61 6372 6f73 2077 em-wide macros w │ │ │ │ │ -000204c0: 696c 6c20 6265 2063 6f70 6965 6420 746f ill be copied to │ │ │ │ │ -000204d0: 2027 6d34 2f27 2074 6865 2066 6972 7374 'm4/' the first │ │ │ │ │ -000204e0: 0a74 696d 6520 796f 7520 7275 6e20 2761 .time you run 'a │ │ │ │ │ -000204f0: 7574 6f72 6563 6f6e 6627 2e20 2054 6865 utoreconf'. The │ │ │ │ │ -00020500: 6e20 7468 6520 6c6f 6361 6c6c 7920 696e n the locally in │ │ │ │ │ -00020510: 7374 616c 6c65 6420 6d61 6372 6f73 2077 stalled macros w │ │ │ │ │ -00020520: 696c 6c20 6861 7665 0a70 7265 6365 6465 ill have.precede │ │ │ │ │ -00020530: 6e63 6520 6f76 6572 2074 6865 2073 7973 nce over the sys │ │ │ │ │ -00020540: 7465 6d2d 7769 6465 2069 6e73 7461 6c6c tem-wide install │ │ │ │ │ -00020550: 6564 206d 6163 726f 7320 6561 6368 2074 ed macros each t │ │ │ │ │ -00020560: 696d 6520 2761 636c 6f63 616c 2720 6973 ime 'aclocal' is │ │ │ │ │ -00020570: 0a72 756e 2061 6761 696e 2e0a 0a20 2020 .run again... │ │ │ │ │ -00020580: 4f6e 6520 7265 6173 6f6e 2077 6879 2079 One reason why y │ │ │ │ │ -00020590: 6f75 2073 686f 756c 6420 6b65 6570 2027 ou should keep ' │ │ │ │ │ -000205a0: 2d2d 696e 7374 616c 6c27 2069 6e20 7468 --install' in th │ │ │ │ │ -000205b0: 6520 666c 6167 7320 6576 656e 2061 6674 e flags even aft │ │ │ │ │ -000205c0: 6572 0a74 6865 2066 6972 7374 2072 756e er.the first run │ │ │ │ │ -000205d0: 2069 7320 7468 6174 2077 6865 6e20 796f is that when yo │ │ │ │ │ -000205e0: 7520 6c61 7465 7220 6564 6974 2027 636f u later edit 'co │ │ │ │ │ -000205f0: 6e66 6967 7572 652e 6163 2720 616e 6420 nfigure.ac' and │ │ │ │ │ -00020600: 6465 7065 6e64 206f 6e20 610a 6e65 7720 depend on a.new │ │ │ │ │ -00020610: 6d61 6372 6f2c 2074 6869 7320 6d61 6372 macro, this macr │ │ │ │ │ -00020620: 6f20 7769 6c6c 2062 6520 696e 7374 616c o will be instal │ │ │ │ │ -00020630: 6c65 6420 696e 2079 6f75 7220 276d 342f led in your 'm4/ │ │ │ │ │ -00020640: 2720 6175 746f 6d61 7469 6361 6c6c 792e ' automatically. │ │ │ │ │ -00020650: 0a41 6e6f 7468 6572 206f 6e65 2069 7320 .Another one is │ │ │ │ │ -00020660: 7468 6174 2073 6572 6961 6c20 6e75 6d62 that serial numb │ │ │ │ │ -00020670: 6572 7320 282a 6e6f 7465 2053 6572 6961 ers (*note Seria │ │ │ │ │ -00020680: 6c73 3a3a 2920 6361 6e20 6265 2075 7365 ls::) can be use │ │ │ │ │ -00020690: 6420 746f 0a75 7064 6174 6520 7468 6520 d to.update the │ │ │ │ │ -000206a0: 6d61 6372 6f73 2069 6e20 796f 7572 2073 macros in your s │ │ │ │ │ -000206b0: 6f75 7263 6520 7472 6565 2061 7574 6f6d ource tree autom │ │ │ │ │ -000206c0: 6174 6963 616c 6c79 2077 6865 6e20 6e65 atically when ne │ │ │ │ │ -000206d0: 7720 7379 7374 656d 2d77 6964 650a 7665 w system-wide.ve │ │ │ │ │ -000206e0: 7273 696f 6e73 2061 7265 2069 6e73 7461 rsions are insta │ │ │ │ │ -000206f0: 6c6c 6564 2e20 2041 2073 6572 6961 6c20 lled. A serial │ │ │ │ │ -00020700: 6e75 6d62 6572 2073 686f 756c 6420 6265 number should be │ │ │ │ │ -00020710: 2061 2073 696e 676c 6520 6c69 6e65 206f a single line o │ │ │ │ │ -00020720: 6620 7468 650a 666f 726d 0a0a 2020 2020 f the.form.. │ │ │ │ │ -00020730: 2023 7365 7269 616c 204e 4e4e 0a0a 7768 #serial NNN..wh │ │ │ │ │ -00020740: 6572 6520 4e4e 4e20 636f 6e74 6169 6e73 ere NNN contains │ │ │ │ │ -00020750: 206f 6e6c 7920 6469 6769 7473 2061 6e64 only digits and │ │ │ │ │ -00020760: 2064 6f74 732e 2020 4974 2073 686f 756c dots. It shoul │ │ │ │ │ -00020770: 6420 6170 7065 6172 2069 6e20 7468 6520 d appear in the │ │ │ │ │ -00020780: 4d34 0a66 696c 6520 6265 666f 7265 2061 M4.file before a │ │ │ │ │ -00020790: 6e79 206d 6163 726f 2064 6566 696e 6974 ny macro definit │ │ │ │ │ -000207a0: 696f 6e2e 2020 4974 2069 7320 6120 676f ion. It is a go │ │ │ │ │ -000207b0: 6f64 2070 7261 6374 6963 6520 746f 206d od practice to m │ │ │ │ │ -000207c0: 6169 6e74 6169 6e20 610a 7365 7269 616c aintain a.serial │ │ │ │ │ -000207d0: 206e 756d 6265 7220 666f 7220 6561 6368 number for each │ │ │ │ │ -000207e0: 206d 6163 726f 2079 6f75 2064 6973 7472 macro you distr │ │ │ │ │ -000207f0: 6962 7574 652c 2065 7665 6e20 6966 2079 ibute, even if y │ │ │ │ │ -00020800: 6f75 2064 6f20 6e6f 7420 7573 6520 7468 ou do not use th │ │ │ │ │ -00020810: 650a 272d 2d69 6e73 7461 6c6c 2720 6f70 e.'--install' op │ │ │ │ │ -00020820: 7469 6f6e 206f 6620 2761 636c 6f63 616c tion of 'aclocal │ │ │ │ │ -00020830: 273a 2074 6869 7320 616c 6c6f 7773 206f ': this allows o │ │ │ │ │ -00020840: 7468 6572 2070 656f 706c 6520 746f 2075 ther people to u │ │ │ │ │ -00020850: 7365 2069 742e 0a0a 1f0a 4669 6c65 3a20 se it.....File: │ │ │ │ │ -00020860: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -00020870: 666f 2c20 204e 6f64 653a 2053 6572 6961 fo, Node: Seria │ │ │ │ │ -00020880: 6c73 2c20 204e 6578 743a 2046 7574 7572 ls, Next: Futur │ │ │ │ │ -00020890: 6520 6f66 2061 636c 6f63 616c 2c20 2050 e of aclocal, P │ │ │ │ │ -000208a0: 7265 763a 204c 6f63 616c 204d 6163 726f rev: Local Macro │ │ │ │ │ -000208b0: 732c 2020 5570 3a20 6163 6c6f 6361 6c20 s, Up: aclocal │ │ │ │ │ -000208c0: 496e 766f 6361 7469 6f6e 0a0a 362e 332e Invocation..6.3. │ │ │ │ │ -000208d0: 3520 5365 7269 616c 204e 756d 6265 7273 5 Serial Numbers │ │ │ │ │ -000208e0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -000208f0: 2d2d 2d2d 2d0a 0a42 6563 6175 7365 2074 -----..Because t │ │ │ │ │ -00020900: 6869 7264 2d70 6172 7479 206d 6163 726f hird-party macro │ │ │ │ │ -00020910: 7320 6465 6669 6e65 6420 696e 2027 2a2e s defined in '*. │ │ │ │ │ -00020920: 6d34 2720 6669 6c65 7320 6172 6520 6e61 m4' files are na │ │ │ │ │ -00020930: 7475 7261 6c6c 7920 7368 6172 6564 0a62 turally shared.b │ │ │ │ │ -00020940: 6574 7765 656e 206d 756c 7469 706c 6520 etween multiple │ │ │ │ │ -00020950: 7072 6f6a 6563 7473 2c20 736f 6d65 2070 projects, some p │ │ │ │ │ -00020960: 656f 706c 6520 6c69 6b65 2074 6f20 7665 eople like to ve │ │ │ │ │ -00020970: 7273 696f 6e20 7468 656d 2e20 2054 6869 rsion them. Thi │ │ │ │ │ -00020980: 7320 6d61 6b65 730a 6974 2065 6173 6965 s makes.it easie │ │ │ │ │ -00020990: 7220 746f 2074 656c 6c20 7768 6963 6820 r to tell which │ │ │ │ │ -000209a0: 6f66 2074 776f 204d 3420 6669 6c65 7320 of two M4 files │ │ │ │ │ -000209b0: 6973 206e 6577 6572 2e20 2053 696e 6365 is newer. Since │ │ │ │ │ -000209c0: 2061 7420 6c65 6173 7420 3139 3936 2c0a at least 1996,. │ │ │ │ │ -000209d0: 7468 6520 7472 6164 6974 696f 6e20 6973 the tradition is │ │ │ │ │ -000209e0: 2074 6f20 7573 6520 6120 2723 7365 7269 to use a '#seri │ │ │ │ │ -000209f0: 616c 2720 6c69 6e65 2066 6f72 2074 6869 al' line for thi │ │ │ │ │ -00020a00: 732e 0a0a 2020 2041 2073 6572 6961 6c20 s... A serial │ │ │ │ │ -00020a10: 6e75 6d62 6572 2073 686f 756c 6420 6265 number should be │ │ │ │ │ -00020a20: 2061 2073 696e 676c 6520 6c69 6e65 206f a single line o │ │ │ │ │ -00020a30: 6620 7468 6520 666f 726d 0a0a 2020 2020 f the form.. │ │ │ │ │ -00020a40: 2023 2073 6572 6961 6c20 5645 5253 494f # serial VERSIO │ │ │ │ │ -00020a50: 4e0a 0a77 6865 7265 2056 4552 5349 4f4e N..where VERSION │ │ │ │ │ -00020a60: 2069 7320 6120 7665 7273 696f 6e20 6e75 is a version nu │ │ │ │ │ -00020a70: 6d62 6572 2063 6f6e 7461 696e 696e 6720 mber containing │ │ │ │ │ -00020a80: 6f6e 6c79 2064 6967 6974 7320 616e 6420 only digits and │ │ │ │ │ -00020a90: 646f 7473 2e0a 5573 7561 6c6c 7920 7065 dots..Usually pe │ │ │ │ │ -00020aa0: 6f70 6c65 2075 7365 2061 2073 696e 676c ople use a singl │ │ │ │ │ -00020ab0: 6520 696e 7465 6765 722c 2061 6e64 2074 e integer, and t │ │ │ │ │ -00020ac0: 6865 7920 696e 6372 656d 656e 7420 6974 hey increment it │ │ │ │ │ -00020ad0: 2065 6163 6820 7469 6d65 0a74 6865 7920 each time.they │ │ │ │ │ -00020ae0: 6368 616e 6765 2074 6865 206d 6163 726f change the macro │ │ │ │ │ -00020af0: 2028 6865 6e63 6520 7468 6520 6e61 6d65 (hence the name │ │ │ │ │ -00020b00: 206f 6620 2273 6572 6961 6c22 292e 2020 of "serial"). │ │ │ │ │ -00020b10: 5375 6368 2061 206c 696e 6520 7368 6f75 Such a line shou │ │ │ │ │ -00020b20: 6c64 0a61 7070 6561 7220 696e 2074 6865 ld.appear in the │ │ │ │ │ -00020b30: 204d 3420 6669 6c65 2062 6566 6f72 6520 M4 file before │ │ │ │ │ -00020b40: 616e 7920 6d61 6372 6f20 6465 6669 6e69 any macro defini │ │ │ │ │ -00020b50: 7469 6f6e 2e0a 0a20 2020 5468 6520 2723 tion... The '# │ │ │ │ │ -00020b60: 2720 6d75 7374 2062 6520 7468 6520 6669 ' must be the fi │ │ │ │ │ -00020b70: 7273 7420 6368 6172 6163 7465 7220 6f6e rst character on │ │ │ │ │ -00020b80: 2074 6865 206c 696e 652c 2061 6e64 2069 the line, and i │ │ │ │ │ -00020b90: 7420 6973 204f 4b20 746f 2068 6176 650a t is OK to have. │ │ │ │ │ -00020ba0: 6578 7472 6120 776f 7264 7320 6166 7465 extra words afte │ │ │ │ │ -00020bb0: 7220 7468 6520 7665 7273 696f 6e2c 2061 r the version, a │ │ │ │ │ -00020bc0: 7320 696e 0a0a 2020 2020 2023 7365 7269 s in.. #seri │ │ │ │ │ -00020bd0: 616c 2056 4552 5349 4f4e 2047 4152 4241 al VERSION GARBA │ │ │ │ │ -00020be0: 4745 0a0a 2020 204e 6f72 6d61 6c6c 7920 GE.. Normally │ │ │ │ │ -00020bf0: 7468 6573 6520 7365 7269 616c 206e 756d these serial num │ │ │ │ │ -00020c00: 6265 7273 2061 7265 2063 6f6d 706c 6574 bers are complet │ │ │ │ │ -00020c10: 656c 7920 6967 6e6f 7265 6420 6279 2027 ely ignored by ' │ │ │ │ │ -00020c20: 6163 6c6f 6361 6c27 2061 6e64 0a27 6175 aclocal' and.'au │ │ │ │ │ -00020c30: 746f 636f 6e66 272c 206c 696b 6520 616e toconf', like an │ │ │ │ │ -00020c40: 7920 6765 6e75 696e 6520 636f 6d6d 656e y genuine commen │ │ │ │ │ -00020c50: 742e 2020 486f 7765 7665 7220 7768 656e t. However when │ │ │ │ │ -00020c60: 2075 7369 6e67 2027 6163 6c6f 6361 6c27 using 'aclocal' │ │ │ │ │ -00020c70: 2773 0a27 2d2d 696e 7374 616c 6c27 2066 's.'--install' f │ │ │ │ │ -00020c80: 6561 7475 7265 2c20 7468 6573 6520 7365 eature, these se │ │ │ │ │ -00020c90: 7269 616c 206e 756d 6265 7273 2077 696c rial numbers wil │ │ │ │ │ -00020ca0: 6c20 6d6f 6469 6679 2074 6865 2077 6179 l modify the way │ │ │ │ │ -00020cb0: 2027 6163 6c6f 6361 6c27 0a73 656c 6563 'aclocal'.selec │ │ │ │ │ -00020cc0: 7473 2074 6865 206d 6163 726f 7320 746f ts the macros to │ │ │ │ │ -00020cd0: 2069 6e73 7461 6c6c 2069 6e20 7468 6520 install in the │ │ │ │ │ -00020ce0: 7061 636b 6167 653a 2069 6620 7477 6f20 package: if two │ │ │ │ │ -00020cf0: 6669 6c65 7320 7769 7468 2074 6865 2073 files with the s │ │ │ │ │ -00020d00: 616d 650a 6261 7365 6e61 6d65 2065 7869 ame.basename exi │ │ │ │ │ -00020d10: 7374 2069 6e20 796f 7572 2073 6561 7263 st in your searc │ │ │ │ │ -00020d20: 6820 7061 7468 2c20 616e 6420 6966 2061 h path, and if a │ │ │ │ │ -00020d30: 7420 6c65 6173 7420 6f6e 6520 6f66 2074 t least one of t │ │ │ │ │ -00020d40: 6865 6d20 7573 6573 2061 0a27 2373 6572 hem uses a.'#ser │ │ │ │ │ -00020d50: 6961 6c27 206c 696e 652c 2027 6163 6c6f ial' line, 'aclo │ │ │ │ │ -00020d60: 6361 6c27 2077 696c 6c20 6967 6e6f 7265 cal' will ignore │ │ │ │ │ -00020d70: 2074 6865 2066 696c 6520 7468 6174 2068 the file that h │ │ │ │ │ -00020d80: 6173 2074 6865 206f 6c64 6572 0a27 2373 as the older.'#s │ │ │ │ │ -00020d90: 6572 6961 6c27 206c 696e 6520 286f 7220 erial' line (or │ │ │ │ │ -00020da0: 7468 6520 6669 6c65 2074 6861 7420 6861 the file that ha │ │ │ │ │ -00020db0: 7320 6e6f 6e65 292e 0a0a 2020 204e 6f74 s none)... Not │ │ │ │ │ -00020dc0: 6520 7468 6174 2061 2073 6572 6961 6c20 e that a serial │ │ │ │ │ -00020dd0: 6e75 6d62 6572 2061 7070 6c69 6573 2074 number applies t │ │ │ │ │ -00020de0: 6f20 6120 7768 6f6c 6520 4d34 2066 696c o a whole M4 fil │ │ │ │ │ -00020df0: 652c 206e 6f74 2074 6f20 616e 790a 6d61 e, not to any.ma │ │ │ │ │ -00020e00: 6372 6f20 6974 2063 6f6e 7461 696e 732e cro it contains. │ │ │ │ │ -00020e10: 2020 4120 6669 6c65 2063 616e 2063 6f6e A file can con │ │ │ │ │ -00020e20: 7461 696e 7320 6d75 6c74 6970 6c65 206d tains multiple m │ │ │ │ │ -00020e30: 6163 726f 732c 2062 7574 206f 6e6c 7920 acros, but only │ │ │ │ │ -00020e40: 6f6e 650a 7365 7269 616c 2e0a 0a20 2020 one.serial... │ │ │ │ │ -00020e50: 4865 7265 2069 7320 6120 7573 6520 6361 Here is a use ca │ │ │ │ │ -00020e60: 7365 2074 6861 7420 696c 6c75 7374 7261 se that illustra │ │ │ │ │ -00020e70: 7465 7320 7468 6520 7573 6520 6f66 2027 tes the use of ' │ │ │ │ │ -00020e80: 2d2d 696e 7374 616c 6c27 2061 6e64 2069 --install' and i │ │ │ │ │ -00020e90: 7473 0a69 6e74 6572 6163 7469 6f6e 2077 ts.interaction w │ │ │ │ │ -00020ea0: 6974 6820 7365 7269 616c 206e 756d 6265 ith serial numbe │ │ │ │ │ -00020eb0: 7273 2e20 204c 6574 2773 2061 7373 756d rs. Let's assum │ │ │ │ │ -00020ec0: 6520 7765 206d 6169 6e74 6169 6e20 6120 e we maintain a │ │ │ │ │ -00020ed0: 7061 636b 6167 650a 6361 6c6c 6564 204d package.called M │ │ │ │ │ -00020ee0: 7950 6163 6b61 6765 2c20 7468 6520 2763 yPackage, the 'c │ │ │ │ │ -00020ef0: 6f6e 6669 6775 7265 2e61 6327 206f 6620 onfigure.ac' of │ │ │ │ │ -00020f00: 7768 6963 6820 7265 7175 6972 6573 2061 which requires a │ │ │ │ │ -00020f10: 2074 6869 7264 2d70 6172 7479 0a6d 6163 third-party.mac │ │ │ │ │ -00020f20: 726f 2027 4158 5f54 4849 5244 5f50 4152 ro 'AX_THIRD_PAR │ │ │ │ │ -00020f30: 5459 2720 6465 6669 6e65 6420 696e 2027 TY' defined in ' │ │ │ │ │ -00020f40: 2f75 7372 2f73 6861 7265 2f61 636c 6f63 /usr/share/acloc │ │ │ │ │ -00020f50: 616c 2f74 6869 7264 7061 7274 792e 6d34 al/thirdparty.m4 │ │ │ │ │ -00020f60: 2720 6173 0a66 6f6c 6c6f 7773 3a0a 0a20 ' as.follows:.. │ │ │ │ │ -00020f70: 2020 2020 2320 7365 7269 616c 2031 0a20 # serial 1. │ │ │ │ │ -00020f80: 2020 2020 4143 5f44 4546 554e 285b 4158 AC_DEFUN([AX │ │ │ │ │ -00020f90: 5f54 4849 5244 5f50 4152 5459 5d2c 205b _THIRD_PARTY], [ │ │ │ │ │ -00020fa0: 2e2e 2e5d 290a 0a20 2020 4d79 5061 636b ...]).. MyPack │ │ │ │ │ -00020fb0: 6167 6520 7573 6573 2061 6e20 276d 342f age uses an 'm4/ │ │ │ │ │ -00020fc0: 2720 6469 7265 6374 6f72 7920 746f 2073 ' directory to s │ │ │ │ │ -00020fd0: 746f 7265 206c 6f63 616c 206d 6163 726f tore local macro │ │ │ │ │ -00020fe0: 7320 6173 2065 7870 6c61 696e 6564 0a69 s as explained.i │ │ │ │ │ -00020ff0: 6e20 2a6e 6f74 6520 4c6f 6361 6c20 4d61 n *note Local Ma │ │ │ │ │ -00021000: 6372 6f73 3a3a 2c20 616e 6420 6861 730a cros::, and has. │ │ │ │ │ -00021010: 0a20 2020 2020 4143 4c4f 4341 4c5f 414d . ACLOCAL_AM │ │ │ │ │ -00021020: 464c 4147 5320 3d20 2d49 206d 3420 2d2d FLAGS = -I m4 -- │ │ │ │ │ -00021030: 696e 7374 616c 6c0a 0a69 6e20 6974 7320 install..in its │ │ │ │ │ -00021040: 746f 702d 6c65 7665 6c20 274d 616b 6566 top-level 'Makef │ │ │ │ │ -00021050: 696c 652e 616d 272e 0a0a 2020 2049 6e69 ile.am'... Ini │ │ │ │ │ -00021060: 7469 616c 6c79 2074 6865 2027 6d34 2f27 tially the 'm4/' │ │ │ │ │ -00021070: 2064 6972 6563 746f 7279 2069 7320 656d directory is em │ │ │ │ │ -00021080: 7074 792e 2020 5468 6520 6669 7273 7420 pty. The first │ │ │ │ │ -00021090: 7469 6d65 2077 6520 7275 6e0a 2761 7574 time we run.'aut │ │ │ │ │ -000210a0: 6f72 6563 6f6e 6627 2c20 6974 2077 696c oreconf', it wil │ │ │ │ │ -000210b0: 6c20 6665 7463 6820 7468 6520 6f70 7469 l fetch the opti │ │ │ │ │ -000210c0: 6f6e 7320 746f 2070 6173 7320 746f 2027 ons to pass to ' │ │ │ │ │ -000210d0: 6163 6c6f 6361 6c27 2069 6e0a 274d 616b aclocal' in.'Mak │ │ │ │ │ -000210e0: 6566 696c 652e 616d 272c 2061 6e64 2072 efile.am', and r │ │ │ │ │ -000210f0: 756e 2027 6163 6c6f 6361 6c20 2d49 206d un 'aclocal -I m │ │ │ │ │ -00021100: 3420 2d2d 696e 7374 616c 6c27 2e20 2027 4 --install'. ' │ │ │ │ │ -00021110: 6163 6c6f 6361 6c27 2077 696c 6c20 6e6f aclocal' will no │ │ │ │ │ -00021120: 7469 6365 0a74 6861 740a 0a20 2020 2a20 tice.that.. * │ │ │ │ │ -00021130: 2763 6f6e 6669 6775 7265 2e61 6327 2075 'configure.ac' u │ │ │ │ │ -00021140: 7365 7320 2741 585f 5448 4952 445f 5041 ses 'AX_THIRD_PA │ │ │ │ │ -00021150: 5254 5927 0a20 2020 2a20 4e6f 206c 6f63 RTY'. * No loc │ │ │ │ │ -00021160: 616c 206d 6163 726f 7320 6465 6669 6e65 al macros define │ │ │ │ │ -00021170: 2027 4158 5f54 4849 5244 5f50 4152 5459 'AX_THIRD_PARTY │ │ │ │ │ -00021180: 270a 2020 202a 2027 2f75 7372 2f73 6861 '. * '/usr/sha │ │ │ │ │ -00021190: 7265 2f61 636c 6f63 616c 2f74 6869 7264 re/aclocal/third │ │ │ │ │ -000211a0: 7061 7274 792e 6d34 2720 6465 6669 6e65 party.m4' define │ │ │ │ │ -000211b0: 7320 2741 585f 5448 4952 445f 5041 5254 s 'AX_THIRD_PART │ │ │ │ │ -000211c0: 5927 2077 6974 680a 2020 2020 2073 6572 Y' with. ser │ │ │ │ │ -000211d0: 6961 6c20 312e 0a0a 4265 6361 7573 6520 ial 1...Because │ │ │ │ │ -000211e0: 272f 7573 722f 7368 6172 652f 6163 6c6f '/usr/share/aclo │ │ │ │ │ -000211f0: 6361 6c2f 7468 6972 6470 6172 7479 2e6d cal/thirdparty.m │ │ │ │ │ -00021200: 3427 2069 7320 6120 7379 7374 656d 2d77 4' is a system-w │ │ │ │ │ -00021210: 6964 6520 6d61 6372 6f20 616e 640a 2761 ide macro and.'a │ │ │ │ │ -00021220: 636c 6f63 616c 2720 7761 7320 6769 7665 clocal' was give │ │ │ │ │ -00021230: 6e20 7468 6520 272d 2d69 6e73 7461 6c6c n the '--install │ │ │ │ │ -00021240: 2720 6f70 7469 6f6e 2c20 6974 2077 696c ' option, it wil │ │ │ │ │ -00021250: 6c20 636f 7079 2074 6869 7320 6669 6c65 l copy this file │ │ │ │ │ -00021260: 2069 6e0a 276d 342f 7468 6972 6470 6172 in.'m4/thirdpar │ │ │ │ │ -00021270: 7479 2e6d 3427 2c20 616e 6420 6f75 7470 ty.m4', and outp │ │ │ │ │ -00021280: 7574 2061 6e20 2761 636c 6f63 616c 2e6d ut an 'aclocal.m │ │ │ │ │ -00021290: 3427 2074 6861 7420 636f 6e74 6169 6e73 4' that contains │ │ │ │ │ -000212a0: 0a27 6d34 5f69 6e63 6c75 6465 285b 6d34 .'m4_include([m4 │ │ │ │ │ -000212b0: 2f74 6869 7264 7061 7274 792e 6d34 5d29 /thirdparty.m4]) │ │ │ │ │ -000212c0: 272e 0a0a 2020 2054 6865 206e 6578 7420 '... The next │ │ │ │ │ -000212d0: 7469 6d65 2027 6163 6c6f 6361 6c20 2d49 time 'aclocal -I │ │ │ │ │ -000212e0: 206d 3420 2d2d 696e 7374 616c 6c27 2069 m4 --install' i │ │ │ │ │ -000212f0: 7320 7275 6e20 2865 6974 6865 7220 7669 s run (either vi │ │ │ │ │ -00021300: 610a 2761 7574 6f72 6563 6f6e 6627 2c20 a.'autoreconf', │ │ │ │ │ -00021310: 6279 2068 616e 642c 206f 7220 6672 6f6d by hand, or from │ │ │ │ │ -00021320: 2074 6865 2027 4d61 6b65 6669 6c65 2720 the 'Makefile' │ │ │ │ │ -00021330: 7265 6275 696c 6420 7275 6c65 7329 2073 rebuild rules) s │ │ │ │ │ -00021340: 6f6d 6574 6869 6e67 0a64 6966 6665 7265 omething.differe │ │ │ │ │ -00021350: 6e74 2068 6170 7065 6e73 2e20 2027 6163 nt happens. 'ac │ │ │ │ │ -00021360: 6c6f 6361 6c27 206e 6f74 6963 6573 2074 local' notices t │ │ │ │ │ -00021370: 6861 740a 0a20 2020 2a20 2763 6f6e 6669 hat.. * 'confi │ │ │ │ │ -00021380: 6775 7265 2e61 6327 2075 7365 7320 2741 gure.ac' uses 'A │ │ │ │ │ -00021390: 585f 5448 4952 445f 5041 5254 5927 0a20 X_THIRD_PARTY'. │ │ │ │ │ -000213a0: 2020 2a20 276d 342f 7468 6972 6470 6172 * 'm4/thirdpar │ │ │ │ │ -000213b0: 7479 2e6d 3427 2064 6566 696e 6573 2027 ty.m4' defines ' │ │ │ │ │ -000213c0: 4158 5f54 4849 5244 5f50 4152 5459 2720 AX_THIRD_PARTY' │ │ │ │ │ -000213d0: 7769 7468 2073 6572 6961 6c20 312e 0a20 with serial 1.. │ │ │ │ │ -000213e0: 2020 2a20 272f 7573 722f 7368 6172 652f * '/usr/share/ │ │ │ │ │ -000213f0: 6163 6c6f 6361 6c2f 7468 6972 6470 6172 aclocal/thirdpar │ │ │ │ │ -00021400: 7479 2e6d 3427 2064 6566 696e 6573 2027 ty.m4' defines ' │ │ │ │ │ -00021410: 4158 5f54 4849 5244 5f50 4152 5459 2720 AX_THIRD_PARTY' │ │ │ │ │ -00021420: 7769 7468 0a20 2020 2020 7365 7269 616c with. serial │ │ │ │ │ -00021430: 2031 2e0a 0a42 6563 6175 7365 2062 6f74 1...Because bot │ │ │ │ │ -00021440: 6820 6669 6c65 7320 6861 7665 2074 6865 h files have the │ │ │ │ │ -00021450: 2073 616d 6520 7365 7269 616c 206e 756d same serial num │ │ │ │ │ -00021460: 6265 722c 2027 6163 6c6f 6361 6c27 2075 ber, 'aclocal' u │ │ │ │ │ -00021470: 7365 7320 7468 6520 6669 7273 740a 6974 ses the first.it │ │ │ │ │ -00021480: 2066 6f75 6e64 2069 6e20 6974 7320 7365 found in its se │ │ │ │ │ -00021490: 6172 6368 2070 6174 6820 6f72 6465 7220 arch path order │ │ │ │ │ -000214a0: 282a 6e6f 7465 204d 6163 726f 2053 6561 (*note Macro Sea │ │ │ │ │ -000214b0: 7263 6820 5061 7468 3a3a 292e 0a27 6163 rch Path::)..'ac │ │ │ │ │ -000214c0: 6c6f 6361 6c27 2074 6865 7265 666f 7265 local' therefore │ │ │ │ │ -000214d0: 2069 676e 6f72 6573 2027 2f75 7372 2f73 ignores '/usr/s │ │ │ │ │ -000214e0: 6861 7265 2f61 636c 6f63 616c 2f74 6869 hare/aclocal/thi │ │ │ │ │ -000214f0: 7264 7061 7274 792e 6d34 2720 616e 640a rdparty.m4' and. │ │ │ │ │ -00021500: 6f75 7470 7574 7320 616e 2027 6163 6c6f outputs an 'aclo │ │ │ │ │ -00021510: 6361 6c2e 6d34 2720 7468 6174 2063 6f6e cal.m4' that con │ │ │ │ │ -00021520: 7461 696e 7320 276d 345f 696e 636c 7564 tains 'm4_includ │ │ │ │ │ -00021530: 6528 5b6d 342f 7468 6972 6470 6172 7479 e([m4/thirdparty │ │ │ │ │ -00021540: 2e6d 345d 2927 2e0a 0a20 2020 4c6f 6361 .m4])'... Loca │ │ │ │ │ -00021550: 6c20 6469 7265 6374 6f72 6965 7320 7370 l directories sp │ │ │ │ │ -00021560: 6563 6966 6965 6420 7769 7468 2027 2d49 ecified with '-I │ │ │ │ │ -00021570: 2720 6172 6520 616c 7761 7973 2073 6561 ' are always sea │ │ │ │ │ -00021580: 7263 6865 6420 6265 666f 7265 0a73 7973 rched before.sys │ │ │ │ │ -00021590: 7465 6d2d 7769 6465 2064 6972 6563 746f tem-wide directo │ │ │ │ │ -000215a0: 7269 6573 2c20 736f 2061 206c 6f63 616c ries, so a local │ │ │ │ │ -000215b0: 2066 696c 6520 7769 6c6c 2061 6c77 6179 file will alway │ │ │ │ │ -000215c0: 7320 6265 2070 7265 6665 7272 6564 2074 s be preferred t │ │ │ │ │ -000215d0: 6f20 7468 650a 7379 7374 656d 2d77 6964 o the.system-wid │ │ │ │ │ -000215e0: 6520 6669 6c65 2069 6e20 6361 7365 206f e file in case o │ │ │ │ │ -000215f0: 6620 6571 7561 6c20 7365 7269 616c 206e f equal serial n │ │ │ │ │ -00021600: 756d 6265 7273 2e0a 0a20 2020 4e6f 7720 umbers... Now │ │ │ │ │ -00021610: 7375 7070 6f73 6520 7468 6520 7379 7374 suppose the syst │ │ │ │ │ -00021620: 656d 2d77 6964 6520 7468 6972 642d 7061 em-wide third-pa │ │ │ │ │ -00021630: 7274 7920 6d61 6372 6f20 6973 2063 6861 rty macro is cha │ │ │ │ │ -00021640: 6e67 6564 2e20 2054 6869 7320 6361 6e0a nged. This can. │ │ │ │ │ -00021650: 6861 7070 656e 2069 6620 7468 6520 7061 happen if the pa │ │ │ │ │ -00021660: 636b 6167 6520 696e 7374 616c 6c69 6e67 ckage installing │ │ │ │ │ -00021670: 2074 6869 7320 6d61 6372 6f20 6973 2075 this macro is u │ │ │ │ │ -00021680: 7064 6174 6564 2e20 204c 6574 2773 2073 pdated. Let's s │ │ │ │ │ -00021690: 7570 706f 7365 0a74 6865 206e 6577 206d uppose.the new m │ │ │ │ │ -000216a0: 6163 726f 2068 6173 2073 6572 6961 6c20 acro has serial │ │ │ │ │ -000216b0: 6e75 6d62 6572 2032 2e20 2054 6865 206e number 2. The n │ │ │ │ │ -000216c0: 6578 7420 7469 6d65 2027 6163 6c6f 6361 ext time 'acloca │ │ │ │ │ -000216d0: 6c20 2d49 206d 340a 2d2d 696e 7374 616c l -I m4.--instal │ │ │ │ │ -000216e0: 6c27 2069 7320 7275 6e20 7468 6520 7369 l' is run the si │ │ │ │ │ -000216f0: 7475 6174 696f 6e20 6973 2074 6865 2066 tuation is the f │ │ │ │ │ -00021700: 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 2a20 ollowing:.. * │ │ │ │ │ -00021710: 2763 6f6e 6669 6775 7265 2e61 6327 2075 'configure.ac' u │ │ │ │ │ -00021720: 7365 7320 2741 585f 5448 4952 445f 5041 ses 'AX_THIRD_PA │ │ │ │ │ -00021730: 5254 5927 0a20 2020 2a20 276d 342f 7468 RTY'. * 'm4/th │ │ │ │ │ -00021740: 6972 6470 6172 7479 2e6d 3427 2064 6566 irdparty.m4' def │ │ │ │ │ -00021750: 696e 6573 2027 4158 5f54 4849 5244 5f50 ines 'AX_THIRD_P │ │ │ │ │ -00021760: 4152 5459 2720 7769 7468 2073 6572 6961 ARTY' with seria │ │ │ │ │ -00021770: 6c20 312e 0a20 2020 2a20 272f 7573 722f l 1.. * '/usr/ │ │ │ │ │ -00021780: 7368 6172 652f 6163 6c6f 6361 6c2f 7468 share/aclocal/th │ │ │ │ │ -00021790: 6972 6470 6172 7479 2e6d 3427 2064 6566 irdparty.m4' def │ │ │ │ │ -000217a0: 696e 6573 2027 4158 5f54 4849 5244 5f50 ines 'AX_THIRD_P │ │ │ │ │ -000217b0: 4152 5459 2720 7769 7468 0a20 2020 2020 ARTY' with. │ │ │ │ │ -000217c0: 7365 7269 616c 2032 2e0a 0a57 6865 6e20 serial 2...When │ │ │ │ │ -000217d0: 2761 636c 6f63 616c 2720 7365 6573 2061 'aclocal' sees a │ │ │ │ │ -000217e0: 2067 7265 6174 6572 2073 6572 6961 6c20 greater serial │ │ │ │ │ -000217f0: 6e75 6d62 6572 2c20 6974 2069 6d6d 6564 number, it immed │ │ │ │ │ -00021800: 6961 7465 6c79 2066 6f72 6765 7473 0a61 iately forgets.a │ │ │ │ │ -00021810: 6e79 7468 696e 6720 6974 206b 6e6f 7773 nything it knows │ │ │ │ │ -00021820: 2066 726f 6d20 6669 6c65 7320 7468 6174 from files that │ │ │ │ │ -00021830: 2068 6176 6520 7468 6520 7361 6d65 2062 have the same b │ │ │ │ │ -00021840: 6173 656e 616d 6520 616e 6420 6120 736d asename and a sm │ │ │ │ │ -00021850: 616c 6c65 720a 7365 7269 616c 206e 756d aller.serial num │ │ │ │ │ -00021860: 6265 722e 2020 536f 2061 6674 6572 2069 ber. So after i │ │ │ │ │ -00021870: 7420 6861 7320 666f 756e 6420 272f 7573 t has found '/us │ │ │ │ │ -00021880: 722f 7368 6172 652f 6163 6c6f 6361 6c2f r/share/aclocal/ │ │ │ │ │ -00021890: 7468 6972 6470 6172 7479 2e6d 3427 0a77 thirdparty.m4'.w │ │ │ │ │ -000218a0: 6974 6820 7365 7269 616c 2032 2c20 2761 ith serial 2, 'a │ │ │ │ │ -000218b0: 636c 6f63 616c 2720 7769 6c6c 2070 726f clocal' will pro │ │ │ │ │ -000218c0: 6365 6564 2061 7320 6966 2069 7420 6861 ceed as if it ha │ │ │ │ │ -000218d0: 6420 6e65 7665 7220 7365 656e 0a27 6d34 d never seen.'m4 │ │ │ │ │ -000218e0: 2f74 6869 7264 7061 7274 792e 6d34 272e /thirdparty.m4'. │ │ │ │ │ -000218f0: 2020 5468 6973 2062 7269 6e67 7320 7573 This brings us │ │ │ │ │ -00021900: 2062 6163 6b20 746f 2061 2073 6974 7561 back to a situa │ │ │ │ │ -00021910: 7469 6f6e 2073 696d 696c 6172 2074 6f20 tion similar to │ │ │ │ │ -00021920: 7468 6174 0a61 7420 7468 6520 6265 6769 that.at the begi │ │ │ │ │ -00021930: 6e6e 696e 6720 6f66 206f 7572 2065 7861 nning of our exa │ │ │ │ │ -00021940: 6d70 6c65 2c20 7768 6572 6520 6e6f 206c mple, where no l │ │ │ │ │ -00021950: 6f63 616c 2066 696c 6520 6465 6669 6e65 ocal file define │ │ │ │ │ -00021960: 6420 7468 6520 6d61 6372 6f2e 0a27 6163 d the macro..'ac │ │ │ │ │ -00021970: 6c6f 6361 6c27 2077 696c 6c20 696e 7374 local' will inst │ │ │ │ │ -00021980: 616c 6c20 7468 6520 6e65 7720 7665 7273 all the new vers │ │ │ │ │ -00021990: 696f 6e20 6f66 2074 6865 206d 6163 726f ion of the macro │ │ │ │ │ -000219a0: 2069 6e0a 276d 342f 7468 6972 6470 6172 in.'m4/thirdpar │ │ │ │ │ -000219b0: 7479 2e6d 3427 2c20 696e 2074 6869 7320 ty.m4', in this │ │ │ │ │ -000219c0: 6361 7365 206f 7665 7272 6964 696e 6720 case overriding │ │ │ │ │ -000219d0: 7468 6520 6f6c 6420 7665 7273 696f 6e2e the old version. │ │ │ │ │ -000219e0: 2020 4d79 5061 636b 6167 650a 6a75 7374 MyPackage.just │ │ │ │ │ -000219f0: 2068 6164 2069 7473 206d 6163 726f 2075 had its macro u │ │ │ │ │ -00021a00: 7064 6174 6564 2061 7320 6120 7369 6465 pdated as a side │ │ │ │ │ -00021a10: 2065 6666 6563 7420 6f66 2072 756e 6e69 effect of runni │ │ │ │ │ -00021a20: 6e67 2027 6163 6c6f 6361 6c27 2e0a 0a20 ng 'aclocal'... │ │ │ │ │ -00021a30: 2020 4966 2079 6f75 2061 7265 206c 6565 If you are lee │ │ │ │ │ -00021a40: 7279 206f 6620 6c65 7474 696e 6720 2761 ry of letting 'a │ │ │ │ │ -00021a50: 636c 6f63 616c 2720 7570 6461 7465 2079 clocal' update y │ │ │ │ │ -00021a60: 6f75 7220 6c6f 6361 6c20 6d61 6372 6f2c our local macro, │ │ │ │ │ -00021a70: 2079 6f75 0a63 616e 2072 756e 2027 6163 you.can run 'ac │ │ │ │ │ -00021a80: 6c6f 6361 6c20 2d49 206d 3420 2d2d 6469 local -I m4 --di │ │ │ │ │ -00021a90: 6666 2720 746f 2072 6576 6965 7720 7468 ff' to review th │ │ │ │ │ -00021aa0: 6520 6368 616e 6765 7320 2761 636c 6f63 e changes 'acloc │ │ │ │ │ -00021ab0: 616c 202d 4920 6d34 0a2d 2d69 6e73 7461 al -I m4.--insta │ │ │ │ │ -00021ac0: 6c6c 2720 776f 756c 6420 7065 7266 6f72 ll' would perfor │ │ │ │ │ -00021ad0: 6d20 6f6e 2074 6865 7365 206d 6163 726f m on these macro │ │ │ │ │ -00021ae0: 732e 0a0a 2020 2046 696e 616c 6c79 2c20 s... Finally, │ │ │ │ │ -00021af0: 6e6f 7465 2074 6861 7420 7468 6520 272d note that the '- │ │ │ │ │ -00021b00: 2d66 6f72 6365 2720 6f70 7469 6f6e 206f -force' option o │ │ │ │ │ -00021b10: 6620 2761 636c 6f63 616c 2720 6861 7320 f 'aclocal' has │ │ │ │ │ -00021b20: 6162 736f 6c75 7465 6c79 0a6e 6f20 6566 absolutely.no ef │ │ │ │ │ -00021b30: 6665 6374 206f 6e20 7468 6520 6669 6c65 fect on the file │ │ │ │ │ -00021b40: 7320 696e 7374 616c 6c65 6420 6279 2027 s installed by ' │ │ │ │ │ -00021b50: 2d2d 696e 7374 616c 6c27 2e20 2046 6f72 --install'. For │ │ │ │ │ -00021b60: 2069 6e73 7461 6e63 652c 2069 6620 796f instance, if yo │ │ │ │ │ -00021b70: 750a 6861 7665 206d 6f64 6966 6965 6420 u.have modified │ │ │ │ │ -00021b80: 796f 7572 206c 6f63 616c 206d 6163 726f your local macro │ │ │ │ │ -00021b90: 732c 2064 6f20 6e6f 7420 6578 7065 6374 s, do not expect │ │ │ │ │ -00021ba0: 2027 2d2d 696e 7374 616c 6c20 2d2d 666f '--install --fo │ │ │ │ │ -00021bb0: 7263 6527 2074 6f0a 7265 706c 6163 6520 rce' to.replace │ │ │ │ │ -00021bc0: 7468 6520 6c6f 6361 6c20 6d61 6372 6f73 the local macros │ │ │ │ │ -00021bd0: 2062 7920 7468 6569 7220 7379 7374 656d by their system │ │ │ │ │ -00021be0: 2d77 6964 6520 7665 7273 696f 6e73 2e20 -wide versions. │ │ │ │ │ -00021bf0: 2049 6620 796f 7520 7761 6e74 2074 6f0a If you want to. │ │ │ │ │ -00021c00: 646f 2073 6f2c 2073 696d 706c 7920 6572 do so, simply er │ │ │ │ │ -00021c10: 6173 6520 7468 6520 6c6f 6361 6c20 6d61 ase the local ma │ │ │ │ │ -00021c20: 6372 6f73 2079 6f75 2077 616e 7420 746f cros you want to │ │ │ │ │ -00021c30: 2072 6576 6572 742c 2061 6e64 2072 756e revert, and run │ │ │ │ │ -00021c40: 0a27 6163 6c6f 6361 6c20 2d49 206d 3420 .'aclocal -I m4 │ │ │ │ │ -00021c50: 2d2d 696e 7374 616c 6c27 2e0a 0a1f 0a46 --install'.....F │ │ │ │ │ -00021c60: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -00021c70: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -00021c80: 4675 7475 7265 206f 6620 6163 6c6f 6361 Future of acloca │ │ │ │ │ -00021c90: 6c2c 2020 5072 6576 3a20 5365 7269 616c l, Prev: Serial │ │ │ │ │ -00021ca0: 732c 2020 5570 3a20 6163 6c6f 6361 6c20 s, Up: aclocal │ │ │ │ │ -00021cb0: 496e 766f 6361 7469 6f6e 0a0a 362e 332e Invocation..6.3. │ │ │ │ │ -00021cc0: 3620 5468 6520 4675 7475 7265 206f 6620 6 The Future of │ │ │ │ │ -00021cd0: 2761 636c 6f63 616c 270a 2d2d 2d2d 2d2d 'aclocal'.------ │ │ │ │ │ +0001f760: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4665 6174 ----------..Feat │ │ │ │ │ +0001f770: 7572 6520 7465 7374 7320 6f66 6665 7265 ure tests offere │ │ │ │ │ +0001f780: 6420 6279 2041 7574 6f63 6f6e 6620 646f d by Autoconf do │ │ │ │ │ +0001f790: 206e 6f74 2063 6f76 6572 2061 6c6c 206e not cover all n │ │ │ │ │ +0001f7a0: 6565 6473 2e20 2050 656f 706c 6520 6f66 eeds. People of │ │ │ │ │ +0001f7b0: 7465 6e0a 6861 7665 2074 6f20 7375 7070 ten.have to supp │ │ │ │ │ +0001f7c0: 6c65 6d65 6e74 2065 7869 7374 696e 6720 lement existing │ │ │ │ │ +0001f7d0: 7465 7374 7320 7769 7468 2074 6865 6972 tests with their │ │ │ │ │ +0001f7e0: 206f 776e 206d 6163 726f 732c 206f 7220 own macros, or │ │ │ │ │ +0001f7f0: 7769 7468 0a74 6869 7264 2d70 6172 7479 with.third-party │ │ │ │ │ +0001f800: 206d 6163 726f 732e 0a0a 2020 2054 6865 macros... The │ │ │ │ │ +0001f810: 7265 2061 7265 2074 776f 2077 6179 7320 re are two ways │ │ │ │ │ +0001f820: 746f 206f 7267 616e 697a 6520 6375 7374 to organize cust │ │ │ │ │ +0001f830: 6f6d 206d 6163 726f 7320 696e 2061 2070 om macros in a p │ │ │ │ │ +0001f840: 6163 6b61 6765 2e0a 0a20 2020 5468 6520 ackage... The │ │ │ │ │ +0001f850: 6669 7273 7420 706f 7373 6962 696c 6974 first possibilit │ │ │ │ │ +0001f860: 7920 2874 6865 2068 6973 746f 7269 6361 y (the historica │ │ │ │ │ +0001f870: 6c20 7072 6163 7469 6365 2920 6973 2074 l practice) is t │ │ │ │ │ +0001f880: 6f20 6c69 7374 2061 6c6c 2079 6f75 720a o list all your. │ │ │ │ │ +0001f890: 6d61 6372 6f73 2069 6e20 2761 6369 6e63 macros in 'acinc │ │ │ │ │ +0001f8a0: 6c75 6465 2e6d 3427 2e20 2054 6869 7320 lude.m4'. This │ │ │ │ │ +0001f8b0: 6669 6c65 2077 696c 6c20 6265 2069 6e63 file will be inc │ │ │ │ │ +0001f8c0: 6c75 6465 6420 696e 2027 6163 6c6f 6361 luded in 'acloca │ │ │ │ │ +0001f8d0: 6c2e 6d34 270a 7768 656e 2079 6f75 2072 l.m4'.when you r │ │ │ │ │ +0001f8e0: 756e 2027 6163 6c6f 6361 6c27 2c20 616e un 'aclocal', an │ │ │ │ │ +0001f8f0: 6420 6974 7320 6d61 6372 6f28 7329 2077 d its macro(s) w │ │ │ │ │ +0001f900: 696c 6c20 6865 6e63 6566 6f72 7468 2062 ill henceforth b │ │ │ │ │ +0001f910: 6520 7669 7369 626c 6520 746f 0a27 6175 e visible to.'au │ │ │ │ │ +0001f920: 746f 636f 6e66 272e 2020 486f 7765 7665 toconf'. Howeve │ │ │ │ │ +0001f930: 7220 6966 2069 7420 636f 6e74 6169 6e73 r if it contains │ │ │ │ │ +0001f940: 206e 756d 6572 6f75 7320 6d61 6372 6f73 numerous macros │ │ │ │ │ +0001f950: 2c20 6974 2077 696c 6c20 7261 7069 646c , it will rapidl │ │ │ │ │ +0001f960: 790a 6265 636f 6d65 2064 6966 6669 6375 y.become difficu │ │ │ │ │ +0001f970: 6c74 2074 6f20 6d61 696e 7461 696e 2c20 lt to maintain, │ │ │ │ │ +0001f980: 616e 6420 6974 2077 696c 6c20 6265 2061 and it will be a │ │ │ │ │ +0001f990: 6c6d 6f73 7420 696d 706f 7373 6962 6c65 lmost impossible │ │ │ │ │ +0001f9a0: 2074 6f20 7368 6172 650a 6d61 6372 6f73 to share.macros │ │ │ │ │ +0001f9b0: 2062 6574 7765 656e 2070 6163 6b61 6765 between package │ │ │ │ │ +0001f9c0: 732e 0a0a 2020 2054 6865 2073 6563 6f6e s... The secon │ │ │ │ │ +0001f9d0: 6420 706f 7373 6962 696c 6974 792c 2077 d possibility, w │ │ │ │ │ +0001f9e0: 6869 6368 2077 6520 646f 2072 6563 6f6d hich we do recom │ │ │ │ │ +0001f9f0: 6d65 6e64 2c20 6973 2074 6f20 7772 6974 mend, is to writ │ │ │ │ │ +0001fa00: 6520 6561 6368 206d 6163 726f 0a69 6e20 e each macro.in │ │ │ │ │ +0001fa10: 6974 7320 6f77 6e20 6669 6c65 2061 6e64 its own file and │ │ │ │ │ +0001fa20: 2067 6174 6865 7220 616c 6c20 7468 6573 gather all thes │ │ │ │ │ +0001fa30: 6520 6669 6c65 7320 696e 2061 2064 6972 e files in a dir │ │ │ │ │ +0001fa40: 6563 746f 7279 2e20 2054 6869 730a 6469 ectory. This.di │ │ │ │ │ +0001fa50: 7265 6374 6f72 7920 6973 2075 7375 616c rectory is usual │ │ │ │ │ +0001fa60: 6c79 2063 616c 6c65 6420 276d 342f 272e ly called 'm4/'. │ │ │ │ │ +0001fa70: 2020 546f 2062 7569 6c64 2027 6163 6c6f To build 'aclo │ │ │ │ │ +0001fa80: 6361 6c2e 6d34 272c 206f 6e65 2073 686f cal.m4', one sho │ │ │ │ │ +0001fa90: 756c 640a 7468 6572 6566 6f72 6520 696e uld.therefore in │ │ │ │ │ +0001faa0: 7374 7275 6374 2027 6163 6c6f 6361 6c27 struct 'aclocal' │ │ │ │ │ +0001fab0: 2074 6f20 7363 616e 2027 6d34 2f27 2e20 to scan 'm4/'. │ │ │ │ │ +0001fac0: 2046 726f 6d20 7468 6520 636f 6d6d 616e From the comman │ │ │ │ │ +0001fad0: 6420 6c69 6e65 2c20 7468 6973 0a69 7320 d line, this.is │ │ │ │ │ +0001fae0: 646f 6e65 2077 6974 6820 2761 636c 6f63 done with 'acloc │ │ │ │ │ +0001faf0: 616c 202d 4920 6d34 272e 2020 5468 6520 al -I m4'. The │ │ │ │ │ +0001fb00: 746f 702d 6c65 7665 6c20 274d 616b 6566 top-level 'Makef │ │ │ │ │ +0001fb10: 696c 652e 616d 2720 7368 6f75 6c64 2061 ile.am' should a │ │ │ │ │ +0001fb20: 6c73 6f0a 6265 2075 7064 6174 6564 2074 lso.be updated t │ │ │ │ │ +0001fb30: 6f20 6465 6669 6e65 0a0a 2020 2020 2041 o define.. A │ │ │ │ │ +0001fb40: 434c 4f43 414c 5f41 4d46 4c41 4753 203d CLOCAL_AMFLAGS = │ │ │ │ │ +0001fb50: 202d 4920 6d34 0a0a 2020 2027 4143 4c4f -I m4.. 'ACLO │ │ │ │ │ +0001fb60: 4341 4c5f 414d 464c 4147 5327 2063 6f6e CAL_AMFLAGS' con │ │ │ │ │ +0001fb70: 7461 696e 7320 6f70 7469 6f6e 7320 746f tains options to │ │ │ │ │ +0001fb80: 2070 6173 7320 746f 2027 6163 6c6f 6361 pass to 'acloca │ │ │ │ │ +0001fb90: 6c27 2077 6865 6e0a 2761 636c 6f63 616c l' when.'aclocal │ │ │ │ │ +0001fba0: 2e6d 3427 2069 7320 746f 2062 6520 7265 .m4' is to be re │ │ │ │ │ +0001fbb0: 6275 696c 7420 6279 2027 6d61 6b65 272e built by 'make'. │ │ │ │ │ +0001fbc0: 2020 5468 6973 206c 696e 6520 6973 2061 This line is a │ │ │ │ │ +0001fbd0: 6c73 6f20 7573 6564 2062 790a 2761 7574 lso used by.'aut │ │ │ │ │ +0001fbe0: 6f72 6563 6f6e 6627 2028 2a6e 6f74 6520 oreconf' (*note │ │ │ │ │ +0001fbf0: 5573 696e 6720 2761 7574 6f72 6563 6f6e Using 'autorecon │ │ │ │ │ +0001fc00: 6627 2074 6f20 5570 6461 7465 2027 636f f' to Update 'co │ │ │ │ │ +0001fc10: 6e66 6967 7572 6527 2053 6372 6970 7473 nfigure' Scripts │ │ │ │ │ +0001fc20: 3a0a 2861 7574 6f63 6f6e 6629 6175 746f :.(autoconf)auto │ │ │ │ │ +0001fc30: 7265 636f 6e66 2049 6e76 6f63 6174 696f reconf Invocatio │ │ │ │ │ +0001fc40: 6e2e 2920 746f 2072 756e 2027 6163 6c6f n.) to run 'aclo │ │ │ │ │ +0001fc50: 6361 6c27 2077 6974 6820 7375 6974 6162 cal' with suitab │ │ │ │ │ +0001fc60: 6c65 0a6f 7074 696f 6e73 2c20 6f72 2062 le.options, or b │ │ │ │ │ +0001fc70: 7920 2761 7574 6f70 6f69 6e74 2720 282a y 'autopoint' (* │ │ │ │ │ +0001fc80: 6e6f 7465 2049 6e76 6f6b 696e 6720 7468 note Invoking th │ │ │ │ │ +0001fc90: 6520 2761 7574 6f70 6f69 6e74 2720 5072 e 'autopoint' Pr │ │ │ │ │ +0001fca0: 6f67 7261 6d3a 0a28 6765 7474 6578 7429 ogram:.(gettext) │ │ │ │ │ +0001fcb0: 6175 746f 706f 696e 7420 496e 766f 6361 autopoint Invoca │ │ │ │ │ +0001fcc0: 7469 6f6e 2e29 2061 6e64 2027 6765 7474 tion.) and 'gett │ │ │ │ │ +0001fcd0: 6578 7469 7a65 2720 282a 6e6f 7465 2049 extize' (*note I │ │ │ │ │ +0001fce0: 6e76 6f6b 696e 6720 7468 650a 2767 6574 nvoking the.'get │ │ │ │ │ +0001fcf0: 7465 7874 697a 6527 2050 726f 6772 616d textize' Program │ │ │ │ │ +0001fd00: 3a20 2867 6574 7465 7874 2967 6574 7465 : (gettext)gette │ │ │ │ │ +0001fd10: 7874 697a 6520 496e 766f 6361 7469 6f6e xtize Invocation │ │ │ │ │ +0001fd20: 2e29 2074 6f20 6c6f 6361 7465 2074 6865 .) to locate the │ │ │ │ │ +0001fd30: 0a70 6c61 6365 2077 6865 7265 2047 6574 .place where Get │ │ │ │ │ +0001fd40: 7465 7874 2773 206d 6163 726f 7320 7368 text's macros sh │ │ │ │ │ +0001fd50: 6f75 6c64 2062 6520 696e 7374 616c 6c65 ould be installe │ │ │ │ │ +0001fd60: 642e 2020 536f 2065 7665 6e20 6966 2079 d. So even if y │ │ │ │ │ +0001fd70: 6f75 2064 6f20 6e6f 740a 7265 616c 6c79 ou do not.really │ │ │ │ │ +0001fd80: 2063 6172 6520 6162 6f75 7420 7468 6520 care about the │ │ │ │ │ +0001fd90: 7265 6275 696c 6420 7275 6c65 732c 2079 rebuild rules, y │ │ │ │ │ +0001fda0: 6f75 2073 686f 756c 6420 6465 6669 6e65 ou should define │ │ │ │ │ +0001fdb0: 0a27 4143 4c4f 4341 4c5f 414d 464c 4147 .'ACLOCAL_AMFLAG │ │ │ │ │ +0001fdc0: 5327 2e0a 0a20 2020 5768 656e 2027 6163 S'... When 'ac │ │ │ │ │ +0001fdd0: 6c6f 6361 6c20 2d49 206d 3427 2069 7320 local -I m4' is │ │ │ │ │ +0001fde0: 7275 6e2c 2069 7420 7769 6c6c 2062 7569 run, it will bui │ │ │ │ │ +0001fdf0: 6c64 2061 6e20 2761 636c 6f63 616c 2e6d ld an 'aclocal.m │ │ │ │ │ +0001fe00: 3427 2074 6861 740a 276d 345f 696e 636c 4' that.'m4_incl │ │ │ │ │ +0001fe10: 7564 6527 7320 616e 7920 6669 6c65 2066 ude's any file f │ │ │ │ │ +0001fe20: 726f 6d20 276d 342f 2720 7468 6174 2064 rom 'm4/' that d │ │ │ │ │ +0001fe30: 6566 696e 6573 2061 2072 6571 7569 7265 efines a require │ │ │ │ │ +0001fe40: 6420 6d61 6372 6f2e 2020 4d61 6372 6f73 d macro. Macros │ │ │ │ │ +0001fe50: 0a6e 6f74 2066 6f75 6e64 206c 6f63 616c .not found local │ │ │ │ │ +0001fe60: 6c79 2077 696c 6c20 7374 696c 6c20 6265 ly will still be │ │ │ │ │ +0001fe70: 2073 6561 7263 6865 6420 696e 2073 7973 searched in sys │ │ │ │ │ +0001fe80: 7465 6d2d 7769 6465 2064 6972 6563 746f tem-wide directo │ │ │ │ │ +0001fe90: 7269 6573 2c20 6173 0a65 7870 6c61 696e ries, as.explain │ │ │ │ │ +0001fea0: 6564 2069 6e20 2a6e 6f74 6520 4d61 6372 ed in *note Macr │ │ │ │ │ +0001feb0: 6f20 5365 6172 6368 2050 6174 683a 3a2e o Search Path::. │ │ │ │ │ +0001fec0: 0a0a 2020 2043 7573 746f 6d20 6d61 6372 .. Custom macr │ │ │ │ │ +0001fed0: 6f73 2073 686f 756c 6420 6265 2064 6973 os should be dis │ │ │ │ │ +0001fee0: 7472 6962 7574 6564 2066 6f72 2074 6865 tributed for the │ │ │ │ │ +0001fef0: 2073 616d 6520 7265 6173 6f6e 2074 6861 same reason tha │ │ │ │ │ +0001ff00: 740a 2763 6f6e 6669 6775 7265 2e61 6327 t.'configure.ac' │ │ │ │ │ +0001ff10: 2069 733a 2073 6f20 7468 6174 206f 7468 is: so that oth │ │ │ │ │ +0001ff20: 6572 2070 656f 706c 6520 6861 7665 2061 er people have a │ │ │ │ │ +0001ff30: 6c6c 2074 6865 2073 6f75 7263 6573 206f ll the sources o │ │ │ │ │ +0001ff40: 6620 796f 7572 0a70 6163 6b61 6765 2069 f your.package i │ │ │ │ │ +0001ff50: 6620 7468 6579 2077 616e 7420 746f 2077 f they want to w │ │ │ │ │ +0001ff60: 6f72 6b20 6f6e 2069 742e 2020 4163 7475 ork on it. Actu │ │ │ │ │ +0001ff70: 616c 6c79 2c20 7468 6973 2064 6973 7472 ally, this distr │ │ │ │ │ +0001ff80: 6962 7574 696f 6e20 6861 7070 656e 730a ibution happens. │ │ │ │ │ +0001ff90: 6175 746f 6d61 7469 6361 6c6c 7920 6265 automatically be │ │ │ │ │ +0001ffa0: 6361 7573 6520 616c 6c20 276d 345f 696e cause all 'm4_in │ │ │ │ │ +0001ffb0: 636c 7564 6527 6420 6669 6c65 7320 6172 clude'd files ar │ │ │ │ │ +0001ffc0: 6520 6469 7374 7269 6275 7465 642e 0a0a e distributed... │ │ │ │ │ +0001ffd0: 2020 2048 6f77 6576 6572 2074 6865 7265 However there │ │ │ │ │ +0001ffe0: 2069 7320 6e6f 2063 6f6e 7365 6e73 7573 is no consensus │ │ │ │ │ +0001fff0: 206f 6e20 7468 6520 6469 7374 7269 6275 on the distribu │ │ │ │ │ +00020000: 7469 6f6e 206f 6620 7468 6972 642d 7061 tion of third-pa │ │ │ │ │ +00020010: 7274 790a 6d61 6372 6f73 2074 6861 7420 rty.macros that │ │ │ │ │ +00020020: 796f 7572 2070 6163 6b61 6765 206d 6179 your package may │ │ │ │ │ +00020030: 2075 7365 2e20 204d 616e 7920 6c69 6272 use. Many libr │ │ │ │ │ +00020040: 6172 6965 7320 696e 7374 616c 6c20 7468 aries install th │ │ │ │ │ +00020050: 6569 7220 6f77 6e0a 6d61 6372 6f20 696e eir own.macro in │ │ │ │ │ +00020060: 2074 6865 2073 7973 7465 6d2d 7769 6465 the system-wide │ │ │ │ │ +00020070: 2027 6163 6c6f 6361 6c27 2064 6972 6563 'aclocal' direc │ │ │ │ │ +00020080: 746f 7279 2028 2a6e 6f74 6520 4578 7465 tory (*note Exte │ │ │ │ │ +00020090: 6e64 696e 670a 6163 6c6f 6361 6c3a 3a29 nding.aclocal::) │ │ │ │ │ +000200a0: 2e20 2046 6f72 2069 6e73 7461 6e63 652c . For instance, │ │ │ │ │ +000200b0: 2047 7569 6c65 2073 6869 7073 2077 6974 Guile ships wit │ │ │ │ │ +000200c0: 6820 6120 6669 6c65 2063 616c 6c65 6420 h a file called │ │ │ │ │ +000200d0: 2767 7569 6c65 2e6d 3427 0a74 6861 7420 'guile.m4'.that │ │ │ │ │ +000200e0: 636f 6e74 6169 6e73 2074 6865 206d 6163 contains the mac │ │ │ │ │ +000200f0: 726f 2027 4755 494c 455f 464c 4147 5327 ro 'GUILE_FLAGS' │ │ │ │ │ +00020100: 2074 6861 7420 6361 6e20 6265 2075 7365 that can be use │ │ │ │ │ +00020110: 6420 746f 2064 6566 696e 6520 7365 7475 d to define setu │ │ │ │ │ +00020120: 700a 636f 6d70 696c 6572 2061 6e64 206c p.compiler and l │ │ │ │ │ +00020130: 696e 6b65 7220 666c 6167 7320 6170 7072 inker flags appr │ │ │ │ │ +00020140: 6f70 7269 6174 6520 666f 7220 7573 696e opriate for usin │ │ │ │ │ +00020150: 6720 4775 696c 652e 2020 5573 696e 670a g Guile. Using. │ │ │ │ │ +00020160: 2747 5549 4c45 5f46 4c41 4753 2720 696e 'GUILE_FLAGS' in │ │ │ │ │ +00020170: 2027 636f 6e66 6967 7572 652e 6163 2720 'configure.ac' │ │ │ │ │ +00020180: 7769 6c6c 2063 6175 7365 2027 6163 6c6f will cause 'aclo │ │ │ │ │ +00020190: 6361 6c27 2074 6f20 636f 7079 2027 6775 cal' to copy 'gu │ │ │ │ │ +000201a0: 696c 652e 6d34 270a 696e 746f 2027 6163 ile.m4'.into 'ac │ │ │ │ │ +000201b0: 6c6f 6361 6c2e 6d34 272c 2062 7574 2061 local.m4', but a │ │ │ │ │ +000201c0: 7320 2767 7569 6c65 2e6d 3427 2069 7320 s 'guile.m4' is │ │ │ │ │ +000201d0: 6e6f 7420 7061 7274 206f 6620 7468 6520 not part of the │ │ │ │ │ +000201e0: 7072 6f6a 6563 742c 2069 7420 7769 6c6c project, it will │ │ │ │ │ +000201f0: 0a6e 6f74 2062 6520 6469 7374 7269 6275 .not be distribu │ │ │ │ │ +00020200: 7465 642e 2020 5465 6368 6e69 6361 6c6c ted. Technicall │ │ │ │ │ +00020210: 792c 2074 6861 7420 6d65 616e 7320 6120 y, that means a │ │ │ │ │ +00020220: 7573 6572 2077 686f 206e 6565 6473 2074 user who needs t │ │ │ │ │ +00020230: 6f20 7265 6275 696c 640a 2761 636c 6f63 o rebuild.'acloc │ │ │ │ │ +00020240: 616c 2e6d 3427 2077 696c 6c20 6861 7665 al.m4' will have │ │ │ │ │ +00020250: 2074 6f20 696e 7374 616c 6c20 4775 696c to install Guil │ │ │ │ │ +00020260: 6520 6669 7273 742e 2020 5468 6973 2069 e first. This i │ │ │ │ │ +00020270: 7320 7072 6f62 6162 6c79 204f 4b2c 2069 s probably OK, i │ │ │ │ │ +00020280: 660a 4775 696c 6520 616c 7265 6164 7920 f.Guile already │ │ │ │ │ +00020290: 6973 2061 2072 6571 7569 7265 6d65 6e74 is a requirement │ │ │ │ │ +000202a0: 2074 6f20 6275 696c 6420 7468 6520 7061 to build the pa │ │ │ │ │ +000202b0: 636b 6167 652e 2020 486f 7765 7665 722c ckage. However, │ │ │ │ │ +000202c0: 2069 6620 4775 696c 650a 6973 206f 6e6c if Guile.is onl │ │ │ │ │ +000202d0: 7920 616e 206f 7074 696f 6e61 6c20 6665 y an optional fe │ │ │ │ │ +000202e0: 6174 7572 652c 206f 7220 6966 2079 6f75 ature, or if you │ │ │ │ │ +000202f0: 7220 7061 636b 6167 6520 6d69 6768 7420 r package might │ │ │ │ │ +00020300: 7275 6e20 6f6e 0a61 7263 6869 7465 6374 run on.architect │ │ │ │ │ +00020310: 7572 6573 2077 6865 7265 2047 7569 6c65 ures where Guile │ │ │ │ │ +00020320: 2063 616e 6e6f 7420 6265 2069 6e73 7461 cannot be insta │ │ │ │ │ +00020330: 6c6c 6564 2c20 7468 6973 2072 6571 7569 lled, this requi │ │ │ │ │ +00020340: 7265 6d65 6e74 2077 696c 6c0a 6869 6e64 rement will.hind │ │ │ │ │ +00020350: 6572 2064 6576 656c 6f70 6d65 6e74 2e20 er development. │ │ │ │ │ +00020360: 2041 6e20 6561 7379 2073 6f6c 7574 696f An easy solutio │ │ │ │ │ +00020370: 6e20 6973 2074 6f20 636f 7079 2073 7563 n is to copy suc │ │ │ │ │ +00020380: 6820 7468 6972 642d 7061 7274 7920 6d61 h third-party ma │ │ │ │ │ +00020390: 6372 6f73 0a69 6e20 796f 7572 206c 6f63 cros.in your loc │ │ │ │ │ +000203a0: 616c 2027 6d34 2f27 2064 6972 6563 746f al 'm4/' directo │ │ │ │ │ +000203b0: 7279 2073 6f20 7468 6579 2067 6574 2064 ry so they get d │ │ │ │ │ +000203c0: 6973 7472 6962 7574 6564 2e0a 0a20 2020 istributed... │ │ │ │ │ +000203d0: 5369 6e63 6520 4175 746f 6d61 6b65 2031 Since Automake 1 │ │ │ │ │ +000203e0: 2e31 302c 2027 6163 6c6f 6361 6c27 206f .10, 'aclocal' o │ │ │ │ │ +000203f0: 6666 6572 7320 616e 206f 7074 696f 6e20 ffers an option │ │ │ │ │ +00020400: 746f 2063 6f70 7920 7468 6573 650a 7379 to copy these.sy │ │ │ │ │ +00020410: 7374 656d 2d77 6964 6520 7468 6972 642d stem-wide third- │ │ │ │ │ +00020420: 7061 7274 7920 6d61 6372 6f73 2069 6e20 party macros in │ │ │ │ │ +00020430: 796f 7572 206c 6f63 616c 206d 6163 726f your local macro │ │ │ │ │ +00020440: 2064 6972 6563 746f 7279 2c20 736f 6c76 directory, solv │ │ │ │ │ +00020450: 696e 670a 7468 6520 6162 6f76 6520 7072 ing.the above pr │ │ │ │ │ +00020460: 6f62 6c65 6d2e 2020 5369 6d70 6c79 2075 oblem. Simply u │ │ │ │ │ +00020470: 7365 3a0a 0a20 2020 2020 4143 4c4f 4341 se:.. ACLOCA │ │ │ │ │ +00020480: 4c5f 414d 464c 4147 5320 3d20 2d49 206d L_AMFLAGS = -I m │ │ │ │ │ +00020490: 3420 2d2d 696e 7374 616c 6c0a 0a57 6974 4 --install..Wit │ │ │ │ │ +000204a0: 6820 7468 6973 2073 6574 7570 2c20 7379 h this setup, sy │ │ │ │ │ +000204b0: 7374 656d 2d77 6964 6520 6d61 6372 6f73 stem-wide macros │ │ │ │ │ +000204c0: 2077 696c 6c20 6265 2063 6f70 6965 6420 will be copied │ │ │ │ │ +000204d0: 746f 2027 6d34 2f27 2074 6865 2066 6972 to 'm4/' the fir │ │ │ │ │ +000204e0: 7374 0a74 696d 6520 796f 7520 7275 6e20 st.time you run │ │ │ │ │ +000204f0: 2761 7574 6f72 6563 6f6e 6627 2e20 2054 'autoreconf'. T │ │ │ │ │ +00020500: 6865 6e20 7468 6520 6c6f 6361 6c6c 7920 hen the locally │ │ │ │ │ +00020510: 696e 7374 616c 6c65 6420 6d61 6372 6f73 installed macros │ │ │ │ │ +00020520: 2077 696c 6c20 6861 7665 0a70 7265 6365 will have.prece │ │ │ │ │ +00020530: 6465 6e63 6520 6f76 6572 2074 6865 2073 dence over the s │ │ │ │ │ +00020540: 7973 7465 6d2d 7769 6465 2069 6e73 7461 ystem-wide insta │ │ │ │ │ +00020550: 6c6c 6564 206d 6163 726f 7320 6561 6368 lled macros each │ │ │ │ │ +00020560: 2074 696d 6520 2761 636c 6f63 616c 2720 time 'aclocal' │ │ │ │ │ +00020570: 6973 0a72 756e 2061 6761 696e 2e0a 0a20 is.run again... │ │ │ │ │ +00020580: 2020 4f6e 6520 7265 6173 6f6e 2077 6879 One reason why │ │ │ │ │ +00020590: 2079 6f75 2073 686f 756c 6420 6b65 6570 you should keep │ │ │ │ │ +000205a0: 2027 2d2d 696e 7374 616c 6c27 2069 6e20 '--install' in │ │ │ │ │ +000205b0: 7468 6520 666c 6167 7320 6576 656e 2061 the flags even a │ │ │ │ │ +000205c0: 6674 6572 0a74 6865 2066 6972 7374 2072 fter.the first r │ │ │ │ │ +000205d0: 756e 2069 7320 7468 6174 2077 6865 6e20 un is that when │ │ │ │ │ +000205e0: 796f 7520 6c61 7465 7220 6564 6974 2027 you later edit ' │ │ │ │ │ +000205f0: 636f 6e66 6967 7572 652e 6163 2720 616e configure.ac' an │ │ │ │ │ +00020600: 6420 6465 7065 6e64 206f 6e20 610a 6e65 d depend on a.ne │ │ │ │ │ +00020610: 7720 6d61 6372 6f2c 2074 6869 7320 6d61 w macro, this ma │ │ │ │ │ +00020620: 6372 6f20 7769 6c6c 2062 6520 696e 7374 cro will be inst │ │ │ │ │ +00020630: 616c 6c65 6420 696e 2079 6f75 7220 276d alled in your 'm │ │ │ │ │ +00020640: 342f 2720 6175 746f 6d61 7469 6361 6c6c 4/' automaticall │ │ │ │ │ +00020650: 792e 0a41 6e6f 7468 6572 206f 6e65 2069 y..Another one i │ │ │ │ │ +00020660: 7320 7468 6174 2073 6572 6961 6c20 6e75 s that serial nu │ │ │ │ │ +00020670: 6d62 6572 7320 282a 6e6f 7465 2053 6572 mbers (*note Ser │ │ │ │ │ +00020680: 6961 6c73 3a3a 2920 6361 6e20 6265 2075 ials::) can be u │ │ │ │ │ +00020690: 7365 6420 746f 0a75 7064 6174 6520 7468 sed to.update th │ │ │ │ │ +000206a0: 6520 6d61 6372 6f73 2069 6e20 796f 7572 e macros in your │ │ │ │ │ +000206b0: 2073 6f75 7263 6520 7472 6565 2061 7574 source tree aut │ │ │ │ │ +000206c0: 6f6d 6174 6963 616c 6c79 2077 6865 6e20 omatically when │ │ │ │ │ +000206d0: 6e65 7720 7379 7374 656d 2d77 6964 650a new system-wide. │ │ │ │ │ +000206e0: 7665 7273 696f 6e73 2061 7265 2069 6e73 versions are ins │ │ │ │ │ +000206f0: 7461 6c6c 6564 2e20 2041 2073 6572 6961 talled. A seria │ │ │ │ │ +00020700: 6c20 6e75 6d62 6572 2073 686f 756c 6420 l number should │ │ │ │ │ +00020710: 6265 2061 2073 696e 676c 6520 6c69 6e65 be a single line │ │ │ │ │ +00020720: 206f 6620 7468 650a 666f 726d 0a0a 2020 of the.form.. │ │ │ │ │ +00020730: 2020 2023 7365 7269 616c 204e 4e4e 0a0a #serial NNN.. │ │ │ │ │ +00020740: 7768 6572 6520 4e4e 4e20 636f 6e74 6169 where NNN contai │ │ │ │ │ +00020750: 6e73 206f 6e6c 7920 6469 6769 7473 2061 ns only digits a │ │ │ │ │ +00020760: 6e64 2064 6f74 732e 2020 4974 2073 686f nd dots. It sho │ │ │ │ │ +00020770: 756c 6420 6170 7065 6172 2069 6e20 7468 uld appear in th │ │ │ │ │ +00020780: 6520 4d34 0a66 696c 6520 6265 666f 7265 e M4.file before │ │ │ │ │ +00020790: 2061 6e79 206d 6163 726f 2064 6566 696e any macro defin │ │ │ │ │ +000207a0: 6974 696f 6e2e 2020 4974 2069 7320 6120 ition. It is a │ │ │ │ │ +000207b0: 676f 6f64 2070 7261 6374 6963 6520 746f good practice to │ │ │ │ │ +000207c0: 206d 6169 6e74 6169 6e20 610a 7365 7269 maintain a.seri │ │ │ │ │ +000207d0: 616c 206e 756d 6265 7220 666f 7220 6561 al number for ea │ │ │ │ │ +000207e0: 6368 206d 6163 726f 2079 6f75 2064 6973 ch macro you dis │ │ │ │ │ +000207f0: 7472 6962 7574 652c 2065 7665 6e20 6966 tribute, even if │ │ │ │ │ +00020800: 2079 6f75 2064 6f20 6e6f 7420 7573 6520 you do not use │ │ │ │ │ +00020810: 7468 650a 272d 2d69 6e73 7461 6c6c 2720 the.'--install' │ │ │ │ │ +00020820: 6f70 7469 6f6e 206f 6620 2761 636c 6f63 option of 'acloc │ │ │ │ │ +00020830: 616c 273a 2074 6869 7320 616c 6c6f 7773 al': this allows │ │ │ │ │ +00020840: 206f 7468 6572 2070 656f 706c 6520 746f other people to │ │ │ │ │ +00020850: 2075 7365 2069 742e 0a0a 1f0a 4669 6c65 use it.....File │ │ │ │ │ +00020860: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +00020870: 696e 666f 2c20 204e 6f64 653a 2053 6572 info, Node: Ser │ │ │ │ │ +00020880: 6961 6c73 2c20 204e 6578 743a 2046 7574 ials, Next: Fut │ │ │ │ │ +00020890: 7572 6520 6f66 2061 636c 6f63 616c 2c20 ure of aclocal, │ │ │ │ │ +000208a0: 2050 7265 763a 204c 6f63 616c 204d 6163 Prev: Local Mac │ │ │ │ │ +000208b0: 726f 732c 2020 5570 3a20 6163 6c6f 6361 ros, Up: acloca │ │ │ │ │ +000208c0: 6c20 496e 766f 6361 7469 6f6e 0a0a 362e l Invocation..6. │ │ │ │ │ +000208d0: 332e 3520 5365 7269 616c 204e 756d 6265 3.5 Serial Numbe │ │ │ │ │ +000208e0: 7273 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d rs.------------- │ │ │ │ │ +000208f0: 2d2d 2d2d 2d2d 2d0a 0a42 6563 6175 7365 -------..Because │ │ │ │ │ +00020900: 2074 6869 7264 2d70 6172 7479 206d 6163 third-party mac │ │ │ │ │ +00020910: 726f 7320 6465 6669 6e65 6420 696e 2027 ros defined in ' │ │ │ │ │ +00020920: 2a2e 6d34 2720 6669 6c65 7320 6172 6520 *.m4' files are │ │ │ │ │ +00020930: 6e61 7475 7261 6c6c 7920 7368 6172 6564 naturally shared │ │ │ │ │ +00020940: 0a62 6574 7765 656e 206d 756c 7469 706c .between multipl │ │ │ │ │ +00020950: 6520 7072 6f6a 6563 7473 2c20 736f 6d65 e projects, some │ │ │ │ │ +00020960: 2070 656f 706c 6520 6c69 6b65 2074 6f20 people like to │ │ │ │ │ +00020970: 7665 7273 696f 6e20 7468 656d 2e20 2054 version them. T │ │ │ │ │ +00020980: 6869 7320 6d61 6b65 730a 6974 2065 6173 his makes.it eas │ │ │ │ │ +00020990: 6965 7220 746f 2074 656c 6c20 7768 6963 ier to tell whic │ │ │ │ │ +000209a0: 6820 6f66 2074 776f 204d 3420 6669 6c65 h of two M4 file │ │ │ │ │ +000209b0: 7320 6973 206e 6577 6572 2e20 2053 696e s is newer. Sin │ │ │ │ │ +000209c0: 6365 2061 7420 6c65 6173 7420 3139 3936 ce at least 1996 │ │ │ │ │ +000209d0: 2c0a 7468 6520 7472 6164 6974 696f 6e20 ,.the tradition │ │ │ │ │ +000209e0: 6973 2074 6f20 7573 6520 6120 2723 7365 is to use a '#se │ │ │ │ │ +000209f0: 7269 616c 2720 6c69 6e65 2066 6f72 2074 rial' line for t │ │ │ │ │ +00020a00: 6869 732e 0a0a 2020 2041 2073 6572 6961 his... A seria │ │ │ │ │ +00020a10: 6c20 6e75 6d62 6572 2073 686f 756c 6420 l number should │ │ │ │ │ +00020a20: 6265 2061 2073 696e 676c 6520 6c69 6e65 be a single line │ │ │ │ │ +00020a30: 206f 6620 7468 6520 666f 726d 0a0a 2020 of the form.. │ │ │ │ │ +00020a40: 2020 2023 2073 6572 6961 6c20 5645 5253 # serial VERS │ │ │ │ │ +00020a50: 494f 4e0a 0a77 6865 7265 2056 4552 5349 ION..where VERSI │ │ │ │ │ +00020a60: 4f4e 2069 7320 6120 7665 7273 696f 6e20 ON is a version │ │ │ │ │ +00020a70: 6e75 6d62 6572 2063 6f6e 7461 696e 696e number containin │ │ │ │ │ +00020a80: 6720 6f6e 6c79 2064 6967 6974 7320 616e g only digits an │ │ │ │ │ +00020a90: 6420 646f 7473 2e0a 5573 7561 6c6c 7920 d dots..Usually │ │ │ │ │ +00020aa0: 7065 6f70 6c65 2075 7365 2061 2073 696e people use a sin │ │ │ │ │ +00020ab0: 676c 6520 696e 7465 6765 722c 2061 6e64 gle integer, and │ │ │ │ │ +00020ac0: 2074 6865 7920 696e 6372 656d 656e 7420 they increment │ │ │ │ │ +00020ad0: 6974 2065 6163 6820 7469 6d65 0a74 6865 it each time.the │ │ │ │ │ +00020ae0: 7920 6368 616e 6765 2074 6865 206d 6163 y change the mac │ │ │ │ │ +00020af0: 726f 2028 6865 6e63 6520 7468 6520 6e61 ro (hence the na │ │ │ │ │ +00020b00: 6d65 206f 6620 2273 6572 6961 6c22 292e me of "serial"). │ │ │ │ │ +00020b10: 2020 5375 6368 2061 206c 696e 6520 7368 Such a line sh │ │ │ │ │ +00020b20: 6f75 6c64 0a61 7070 6561 7220 696e 2074 ould.appear in t │ │ │ │ │ +00020b30: 6865 204d 3420 6669 6c65 2062 6566 6f72 he M4 file befor │ │ │ │ │ +00020b40: 6520 616e 7920 6d61 6372 6f20 6465 6669 e any macro defi │ │ │ │ │ +00020b50: 6e69 7469 6f6e 2e0a 0a20 2020 5468 6520 nition... The │ │ │ │ │ +00020b60: 2723 2720 6d75 7374 2062 6520 7468 6520 '#' must be the │ │ │ │ │ +00020b70: 6669 7273 7420 6368 6172 6163 7465 7220 first character │ │ │ │ │ +00020b80: 6f6e 2074 6865 206c 696e 652c 2061 6e64 on the line, and │ │ │ │ │ +00020b90: 2069 7420 6973 204f 4b20 746f 2068 6176 it is OK to hav │ │ │ │ │ +00020ba0: 650a 6578 7472 6120 776f 7264 7320 6166 e.extra words af │ │ │ │ │ +00020bb0: 7465 7220 7468 6520 7665 7273 696f 6e2c ter the version, │ │ │ │ │ +00020bc0: 2061 7320 696e 0a0a 2020 2020 2023 7365 as in.. #se │ │ │ │ │ +00020bd0: 7269 616c 2056 4552 5349 4f4e 2047 4152 rial VERSION GAR │ │ │ │ │ +00020be0: 4241 4745 0a0a 2020 204e 6f72 6d61 6c6c BAGE.. Normall │ │ │ │ │ +00020bf0: 7920 7468 6573 6520 7365 7269 616c 206e y these serial n │ │ │ │ │ +00020c00: 756d 6265 7273 2061 7265 2063 6f6d 706c umbers are compl │ │ │ │ │ +00020c10: 6574 656c 7920 6967 6e6f 7265 6420 6279 etely ignored by │ │ │ │ │ +00020c20: 2027 6163 6c6f 6361 6c27 2061 6e64 0a27 'aclocal' and.' │ │ │ │ │ +00020c30: 6175 746f 636f 6e66 272c 206c 696b 6520 autoconf', like │ │ │ │ │ +00020c40: 616e 7920 6765 6e75 696e 6520 636f 6d6d any genuine comm │ │ │ │ │ +00020c50: 656e 742e 2020 486f 7765 7665 7220 7768 ent. However wh │ │ │ │ │ +00020c60: 656e 2075 7369 6e67 2027 6163 6c6f 6361 en using 'acloca │ │ │ │ │ +00020c70: 6c27 2773 0a27 2d2d 696e 7374 616c 6c27 l''s.'--install' │ │ │ │ │ +00020c80: 2066 6561 7475 7265 2c20 7468 6573 6520 feature, these │ │ │ │ │ +00020c90: 7365 7269 616c 206e 756d 6265 7273 2077 serial numbers w │ │ │ │ │ +00020ca0: 696c 6c20 6d6f 6469 6679 2074 6865 2077 ill modify the w │ │ │ │ │ +00020cb0: 6179 2027 6163 6c6f 6361 6c27 0a73 656c ay 'aclocal'.sel │ │ │ │ │ +00020cc0: 6563 7473 2074 6865 206d 6163 726f 7320 ects the macros │ │ │ │ │ +00020cd0: 746f 2069 6e73 7461 6c6c 2069 6e20 7468 to install in th │ │ │ │ │ +00020ce0: 6520 7061 636b 6167 653a 2069 6620 7477 e package: if tw │ │ │ │ │ +00020cf0: 6f20 6669 6c65 7320 7769 7468 2074 6865 o files with the │ │ │ │ │ +00020d00: 2073 616d 650a 6261 7365 6e61 6d65 2065 same.basename e │ │ │ │ │ +00020d10: 7869 7374 2069 6e20 796f 7572 2073 6561 xist in your sea │ │ │ │ │ +00020d20: 7263 6820 7061 7468 2c20 616e 6420 6966 rch path, and if │ │ │ │ │ +00020d30: 2061 7420 6c65 6173 7420 6f6e 6520 6f66 at least one of │ │ │ │ │ +00020d40: 2074 6865 6d20 7573 6573 2061 0a27 2373 them uses a.'#s │ │ │ │ │ +00020d50: 6572 6961 6c27 206c 696e 652c 2027 6163 erial' line, 'ac │ │ │ │ │ +00020d60: 6c6f 6361 6c27 2077 696c 6c20 6967 6e6f local' will igno │ │ │ │ │ +00020d70: 7265 2074 6865 2066 696c 6520 7468 6174 re the file that │ │ │ │ │ +00020d80: 2068 6173 2074 6865 206f 6c64 6572 0a27 has the older.' │ │ │ │ │ +00020d90: 2373 6572 6961 6c27 206c 696e 6520 286f #serial' line (o │ │ │ │ │ +00020da0: 7220 7468 6520 6669 6c65 2074 6861 7420 r the file that │ │ │ │ │ +00020db0: 6861 7320 6e6f 6e65 292e 0a0a 2020 204e has none)... N │ │ │ │ │ +00020dc0: 6f74 6520 7468 6174 2061 2073 6572 6961 ote that a seria │ │ │ │ │ +00020dd0: 6c20 6e75 6d62 6572 2061 7070 6c69 6573 l number applies │ │ │ │ │ +00020de0: 2074 6f20 6120 7768 6f6c 6520 4d34 2066 to a whole M4 f │ │ │ │ │ +00020df0: 696c 652c 206e 6f74 2074 6f20 616e 790a ile, not to any. │ │ │ │ │ +00020e00: 6d61 6372 6f20 6974 2063 6f6e 7461 696e macro it contain │ │ │ │ │ +00020e10: 732e 2020 4120 6669 6c65 2063 616e 2063 s. A file can c │ │ │ │ │ +00020e20: 6f6e 7461 696e 7320 6d75 6c74 6970 6c65 ontains multiple │ │ │ │ │ +00020e30: 206d 6163 726f 732c 2062 7574 206f 6e6c macros, but onl │ │ │ │ │ +00020e40: 7920 6f6e 650a 7365 7269 616c 2e0a 0a20 y one.serial... │ │ │ │ │ +00020e50: 2020 4865 7265 2069 7320 6120 7573 6520 Here is a use │ │ │ │ │ +00020e60: 6361 7365 2074 6861 7420 696c 6c75 7374 case that illust │ │ │ │ │ +00020e70: 7261 7465 7320 7468 6520 7573 6520 6f66 rates the use of │ │ │ │ │ +00020e80: 2027 2d2d 696e 7374 616c 6c27 2061 6e64 '--install' and │ │ │ │ │ +00020e90: 2069 7473 0a69 6e74 6572 6163 7469 6f6e its.interaction │ │ │ │ │ +00020ea0: 2077 6974 6820 7365 7269 616c 206e 756d with serial num │ │ │ │ │ +00020eb0: 6265 7273 2e20 204c 6574 2773 2061 7373 bers. Let's ass │ │ │ │ │ +00020ec0: 756d 6520 7765 206d 6169 6e74 6169 6e20 ume we maintain │ │ │ │ │ +00020ed0: 6120 7061 636b 6167 650a 6361 6c6c 6564 a package.called │ │ │ │ │ +00020ee0: 204d 7950 6163 6b61 6765 2c20 7468 6520 MyPackage, the │ │ │ │ │ +00020ef0: 2763 6f6e 6669 6775 7265 2e61 6327 206f 'configure.ac' o │ │ │ │ │ +00020f00: 6620 7768 6963 6820 7265 7175 6972 6573 f which requires │ │ │ │ │ +00020f10: 2061 2074 6869 7264 2d70 6172 7479 0a6d a third-party.m │ │ │ │ │ +00020f20: 6163 726f 2027 4158 5f54 4849 5244 5f50 acro 'AX_THIRD_P │ │ │ │ │ +00020f30: 4152 5459 2720 6465 6669 6e65 6420 696e ARTY' defined in │ │ │ │ │ +00020f40: 2027 2f75 7372 2f73 6861 7265 2f61 636c '/usr/share/acl │ │ │ │ │ +00020f50: 6f63 616c 2f74 6869 7264 7061 7274 792e ocal/thirdparty. │ │ │ │ │ +00020f60: 6d34 2720 6173 0a66 6f6c 6c6f 7773 3a0a m4' as.follows:. │ │ │ │ │ +00020f70: 0a20 2020 2020 2320 7365 7269 616c 2031 . # serial 1 │ │ │ │ │ +00020f80: 0a20 2020 2020 4143 5f44 4546 554e 285b . AC_DEFUN([ │ │ │ │ │ +00020f90: 4158 5f54 4849 5244 5f50 4152 5459 5d2c AX_THIRD_PARTY], │ │ │ │ │ +00020fa0: 205b 2e2e 2e5d 290a 0a20 2020 4d79 5061 [...]).. MyPa │ │ │ │ │ +00020fb0: 636b 6167 6520 7573 6573 2061 6e20 276d ckage uses an 'm │ │ │ │ │ +00020fc0: 342f 2720 6469 7265 6374 6f72 7920 746f 4/' directory to │ │ │ │ │ +00020fd0: 2073 746f 7265 206c 6f63 616c 206d 6163 store local mac │ │ │ │ │ +00020fe0: 726f 7320 6173 2065 7870 6c61 696e 6564 ros as explained │ │ │ │ │ +00020ff0: 0a69 6e20 2a6e 6f74 6520 4c6f 6361 6c20 .in *note Local │ │ │ │ │ +00021000: 4d61 6372 6f73 3a3a 2c20 616e 6420 6861 Macros::, and ha │ │ │ │ │ +00021010: 730a 0a20 2020 2020 4143 4c4f 4341 4c5f s.. ACLOCAL_ │ │ │ │ │ +00021020: 414d 464c 4147 5320 3d20 2d49 206d 3420 AMFLAGS = -I m4 │ │ │ │ │ +00021030: 2d2d 696e 7374 616c 6c0a 0a69 6e20 6974 --install..in it │ │ │ │ │ +00021040: 7320 746f 702d 6c65 7665 6c20 274d 616b s top-level 'Mak │ │ │ │ │ +00021050: 6566 696c 652e 616d 272e 0a0a 2020 2049 efile.am'... I │ │ │ │ │ +00021060: 6e69 7469 616c 6c79 2074 6865 2027 6d34 nitially the 'm4 │ │ │ │ │ +00021070: 2f27 2064 6972 6563 746f 7279 2069 7320 /' directory is │ │ │ │ │ +00021080: 656d 7074 792e 2020 5468 6520 6669 7273 empty. The firs │ │ │ │ │ +00021090: 7420 7469 6d65 2077 6520 7275 6e0a 2761 t time we run.'a │ │ │ │ │ +000210a0: 7574 6f72 6563 6f6e 6627 2c20 6974 2077 utoreconf', it w │ │ │ │ │ +000210b0: 696c 6c20 6665 7463 6820 7468 6520 6f70 ill fetch the op │ │ │ │ │ +000210c0: 7469 6f6e 7320 746f 2070 6173 7320 746f tions to pass to │ │ │ │ │ +000210d0: 2027 6163 6c6f 6361 6c27 2069 6e0a 274d 'aclocal' in.'M │ │ │ │ │ +000210e0: 616b 6566 696c 652e 616d 272c 2061 6e64 akefile.am', and │ │ │ │ │ +000210f0: 2072 756e 2027 6163 6c6f 6361 6c20 2d49 run 'aclocal -I │ │ │ │ │ +00021100: 206d 3420 2d2d 696e 7374 616c 6c27 2e20 m4 --install'. │ │ │ │ │ +00021110: 2027 6163 6c6f 6361 6c27 2077 696c 6c20 'aclocal' will │ │ │ │ │ +00021120: 6e6f 7469 6365 0a74 6861 740a 0a20 2020 notice.that.. │ │ │ │ │ +00021130: 2a20 2763 6f6e 6669 6775 7265 2e61 6327 * 'configure.ac' │ │ │ │ │ +00021140: 2075 7365 7320 2741 585f 5448 4952 445f uses 'AX_THIRD_ │ │ │ │ │ +00021150: 5041 5254 5927 0a20 2020 2a20 4e6f 206c PARTY'. * No l │ │ │ │ │ +00021160: 6f63 616c 206d 6163 726f 7320 6465 6669 ocal macros defi │ │ │ │ │ +00021170: 6e65 2027 4158 5f54 4849 5244 5f50 4152 ne 'AX_THIRD_PAR │ │ │ │ │ +00021180: 5459 270a 2020 202a 2027 2f75 7372 2f73 TY'. * '/usr/s │ │ │ │ │ +00021190: 6861 7265 2f61 636c 6f63 616c 2f74 6869 hare/aclocal/thi │ │ │ │ │ +000211a0: 7264 7061 7274 792e 6d34 2720 6465 6669 rdparty.m4' defi │ │ │ │ │ +000211b0: 6e65 7320 2741 585f 5448 4952 445f 5041 nes 'AX_THIRD_PA │ │ │ │ │ +000211c0: 5254 5927 2077 6974 680a 2020 2020 2073 RTY' with. s │ │ │ │ │ +000211d0: 6572 6961 6c20 312e 0a0a 4265 6361 7573 erial 1...Becaus │ │ │ │ │ +000211e0: 6520 272f 7573 722f 7368 6172 652f 6163 e '/usr/share/ac │ │ │ │ │ +000211f0: 6c6f 6361 6c2f 7468 6972 6470 6172 7479 local/thirdparty │ │ │ │ │ +00021200: 2e6d 3427 2069 7320 6120 7379 7374 656d .m4' is a system │ │ │ │ │ +00021210: 2d77 6964 6520 6d61 6372 6f20 616e 640a -wide macro and. │ │ │ │ │ +00021220: 2761 636c 6f63 616c 2720 7761 7320 6769 'aclocal' was gi │ │ │ │ │ +00021230: 7665 6e20 7468 6520 272d 2d69 6e73 7461 ven the '--insta │ │ │ │ │ +00021240: 6c6c 2720 6f70 7469 6f6e 2c20 6974 2077 ll' option, it w │ │ │ │ │ +00021250: 696c 6c20 636f 7079 2074 6869 7320 6669 ill copy this fi │ │ │ │ │ +00021260: 6c65 2069 6e0a 276d 342f 7468 6972 6470 le in.'m4/thirdp │ │ │ │ │ +00021270: 6172 7479 2e6d 3427 2c20 616e 6420 6f75 arty.m4', and ou │ │ │ │ │ +00021280: 7470 7574 2061 6e20 2761 636c 6f63 616c tput an 'aclocal │ │ │ │ │ +00021290: 2e6d 3427 2074 6861 7420 636f 6e74 6169 .m4' that contai │ │ │ │ │ +000212a0: 6e73 0a27 6d34 5f69 6e63 6c75 6465 285b ns.'m4_include([ │ │ │ │ │ +000212b0: 6d34 2f74 6869 7264 7061 7274 792e 6d34 m4/thirdparty.m4 │ │ │ │ │ +000212c0: 5d29 272e 0a0a 2020 2054 6865 206e 6578 ])'... The nex │ │ │ │ │ +000212d0: 7420 7469 6d65 2027 6163 6c6f 6361 6c20 t time 'aclocal │ │ │ │ │ +000212e0: 2d49 206d 3420 2d2d 696e 7374 616c 6c27 -I m4 --install' │ │ │ │ │ +000212f0: 2069 7320 7275 6e20 2865 6974 6865 7220 is run (either │ │ │ │ │ +00021300: 7669 610a 2761 7574 6f72 6563 6f6e 6627 via.'autoreconf' │ │ │ │ │ +00021310: 2c20 6279 2068 616e 642c 206f 7220 6672 , by hand, or fr │ │ │ │ │ +00021320: 6f6d 2074 6865 2027 4d61 6b65 6669 6c65 om the 'Makefile │ │ │ │ │ +00021330: 2720 7265 6275 696c 6420 7275 6c65 7329 ' rebuild rules) │ │ │ │ │ +00021340: 2073 6f6d 6574 6869 6e67 0a64 6966 6665 something.diffe │ │ │ │ │ +00021350: 7265 6e74 2068 6170 7065 6e73 2e20 2027 rent happens. ' │ │ │ │ │ +00021360: 6163 6c6f 6361 6c27 206e 6f74 6963 6573 aclocal' notices │ │ │ │ │ +00021370: 2074 6861 740a 0a20 2020 2a20 2763 6f6e that.. * 'con │ │ │ │ │ +00021380: 6669 6775 7265 2e61 6327 2075 7365 7320 figure.ac' uses │ │ │ │ │ +00021390: 2741 585f 5448 4952 445f 5041 5254 5927 'AX_THIRD_PARTY' │ │ │ │ │ +000213a0: 0a20 2020 2a20 276d 342f 7468 6972 6470 . * 'm4/thirdp │ │ │ │ │ +000213b0: 6172 7479 2e6d 3427 2064 6566 696e 6573 arty.m4' defines │ │ │ │ │ +000213c0: 2027 4158 5f54 4849 5244 5f50 4152 5459 'AX_THIRD_PARTY │ │ │ │ │ +000213d0: 2720 7769 7468 2073 6572 6961 6c20 312e ' with serial 1. │ │ │ │ │ +000213e0: 0a20 2020 2a20 272f 7573 722f 7368 6172 . * '/usr/shar │ │ │ │ │ +000213f0: 652f 6163 6c6f 6361 6c2f 7468 6972 6470 e/aclocal/thirdp │ │ │ │ │ +00021400: 6172 7479 2e6d 3427 2064 6566 696e 6573 arty.m4' defines │ │ │ │ │ +00021410: 2027 4158 5f54 4849 5244 5f50 4152 5459 'AX_THIRD_PARTY │ │ │ │ │ +00021420: 2720 7769 7468 0a20 2020 2020 7365 7269 ' with. seri │ │ │ │ │ +00021430: 616c 2031 2e0a 0a42 6563 6175 7365 2062 al 1...Because b │ │ │ │ │ +00021440: 6f74 6820 6669 6c65 7320 6861 7665 2074 oth files have t │ │ │ │ │ +00021450: 6865 2073 616d 6520 7365 7269 616c 206e he same serial n │ │ │ │ │ +00021460: 756d 6265 722c 2027 6163 6c6f 6361 6c27 umber, 'aclocal' │ │ │ │ │ +00021470: 2075 7365 7320 7468 6520 6669 7273 740a uses the first. │ │ │ │ │ +00021480: 6974 2066 6f75 6e64 2069 6e20 6974 7320 it found in its │ │ │ │ │ +00021490: 7365 6172 6368 2070 6174 6820 6f72 6465 search path orde │ │ │ │ │ +000214a0: 7220 282a 6e6f 7465 204d 6163 726f 2053 r (*note Macro S │ │ │ │ │ +000214b0: 6561 7263 6820 5061 7468 3a3a 292e 0a27 earch Path::)..' │ │ │ │ │ +000214c0: 6163 6c6f 6361 6c27 2074 6865 7265 666f aclocal' therefo │ │ │ │ │ +000214d0: 7265 2069 676e 6f72 6573 2027 2f75 7372 re ignores '/usr │ │ │ │ │ +000214e0: 2f73 6861 7265 2f61 636c 6f63 616c 2f74 /share/aclocal/t │ │ │ │ │ +000214f0: 6869 7264 7061 7274 792e 6d34 2720 616e hirdparty.m4' an │ │ │ │ │ +00021500: 640a 6f75 7470 7574 7320 616e 2027 6163 d.outputs an 'ac │ │ │ │ │ +00021510: 6c6f 6361 6c2e 6d34 2720 7468 6174 2063 local.m4' that c │ │ │ │ │ +00021520: 6f6e 7461 696e 7320 276d 345f 696e 636c ontains 'm4_incl │ │ │ │ │ +00021530: 7564 6528 5b6d 342f 7468 6972 6470 6172 ude([m4/thirdpar │ │ │ │ │ +00021540: 7479 2e6d 345d 2927 2e0a 0a20 2020 4c6f ty.m4])'... Lo │ │ │ │ │ +00021550: 6361 6c20 6469 7265 6374 6f72 6965 7320 cal directories │ │ │ │ │ +00021560: 7370 6563 6966 6965 6420 7769 7468 2027 specified with ' │ │ │ │ │ +00021570: 2d49 2720 6172 6520 616c 7761 7973 2073 -I' are always s │ │ │ │ │ +00021580: 6561 7263 6865 6420 6265 666f 7265 0a73 earched before.s │ │ │ │ │ +00021590: 7973 7465 6d2d 7769 6465 2064 6972 6563 ystem-wide direc │ │ │ │ │ +000215a0: 746f 7269 6573 2c20 736f 2061 206c 6f63 tories, so a loc │ │ │ │ │ +000215b0: 616c 2066 696c 6520 7769 6c6c 2061 6c77 al file will alw │ │ │ │ │ +000215c0: 6179 7320 6265 2070 7265 6665 7272 6564 ays be preferred │ │ │ │ │ +000215d0: 2074 6f20 7468 650a 7379 7374 656d 2d77 to the.system-w │ │ │ │ │ +000215e0: 6964 6520 6669 6c65 2069 6e20 6361 7365 ide file in case │ │ │ │ │ +000215f0: 206f 6620 6571 7561 6c20 7365 7269 616c of equal serial │ │ │ │ │ +00021600: 206e 756d 6265 7273 2e0a 0a20 2020 4e6f numbers... No │ │ │ │ │ +00021610: 7720 7375 7070 6f73 6520 7468 6520 7379 w suppose the sy │ │ │ │ │ +00021620: 7374 656d 2d77 6964 6520 7468 6972 642d stem-wide third- │ │ │ │ │ +00021630: 7061 7274 7920 6d61 6372 6f20 6973 2063 party macro is c │ │ │ │ │ +00021640: 6861 6e67 6564 2e20 2054 6869 7320 6361 hanged. This ca │ │ │ │ │ +00021650: 6e0a 6861 7070 656e 2069 6620 7468 6520 n.happen if the │ │ │ │ │ +00021660: 7061 636b 6167 6520 696e 7374 616c 6c69 package installi │ │ │ │ │ +00021670: 6e67 2074 6869 7320 6d61 6372 6f20 6973 ng this macro is │ │ │ │ │ +00021680: 2075 7064 6174 6564 2e20 204c 6574 2773 updated. Let's │ │ │ │ │ +00021690: 2073 7570 706f 7365 0a74 6865 206e 6577 suppose.the new │ │ │ │ │ +000216a0: 206d 6163 726f 2068 6173 2073 6572 6961 macro has seria │ │ │ │ │ +000216b0: 6c20 6e75 6d62 6572 2032 2e20 2054 6865 l number 2. The │ │ │ │ │ +000216c0: 206e 6578 7420 7469 6d65 2027 6163 6c6f next time 'aclo │ │ │ │ │ +000216d0: 6361 6c20 2d49 206d 340a 2d2d 696e 7374 cal -I m4.--inst │ │ │ │ │ +000216e0: 616c 6c27 2069 7320 7275 6e20 7468 6520 all' is run the │ │ │ │ │ +000216f0: 7369 7475 6174 696f 6e20 6973 2074 6865 situation is the │ │ │ │ │ +00021700: 2066 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 following:.. │ │ │ │ │ +00021710: 2a20 2763 6f6e 6669 6775 7265 2e61 6327 * 'configure.ac' │ │ │ │ │ +00021720: 2075 7365 7320 2741 585f 5448 4952 445f uses 'AX_THIRD_ │ │ │ │ │ +00021730: 5041 5254 5927 0a20 2020 2a20 276d 342f PARTY'. * 'm4/ │ │ │ │ │ +00021740: 7468 6972 6470 6172 7479 2e6d 3427 2064 thirdparty.m4' d │ │ │ │ │ +00021750: 6566 696e 6573 2027 4158 5f54 4849 5244 efines 'AX_THIRD │ │ │ │ │ +00021760: 5f50 4152 5459 2720 7769 7468 2073 6572 _PARTY' with ser │ │ │ │ │ +00021770: 6961 6c20 312e 0a20 2020 2a20 272f 7573 ial 1.. * '/us │ │ │ │ │ +00021780: 722f 7368 6172 652f 6163 6c6f 6361 6c2f r/share/aclocal/ │ │ │ │ │ +00021790: 7468 6972 6470 6172 7479 2e6d 3427 2064 thirdparty.m4' d │ │ │ │ │ +000217a0: 6566 696e 6573 2027 4158 5f54 4849 5244 efines 'AX_THIRD │ │ │ │ │ +000217b0: 5f50 4152 5459 2720 7769 7468 0a20 2020 _PARTY' with. │ │ │ │ │ +000217c0: 2020 7365 7269 616c 2032 2e0a 0a57 6865 serial 2...Whe │ │ │ │ │ +000217d0: 6e20 2761 636c 6f63 616c 2720 7365 6573 n 'aclocal' sees │ │ │ │ │ +000217e0: 2061 2067 7265 6174 6572 2073 6572 6961 a greater seria │ │ │ │ │ +000217f0: 6c20 6e75 6d62 6572 2c20 6974 2069 6d6d l number, it imm │ │ │ │ │ +00021800: 6564 6961 7465 6c79 2066 6f72 6765 7473 ediately forgets │ │ │ │ │ +00021810: 0a61 6e79 7468 696e 6720 6974 206b 6e6f .anything it kno │ │ │ │ │ +00021820: 7773 2066 726f 6d20 6669 6c65 7320 7468 ws from files th │ │ │ │ │ +00021830: 6174 2068 6176 6520 7468 6520 7361 6d65 at have the same │ │ │ │ │ +00021840: 2062 6173 656e 616d 6520 616e 6420 6120 basename and a │ │ │ │ │ +00021850: 736d 616c 6c65 720a 7365 7269 616c 206e smaller.serial n │ │ │ │ │ +00021860: 756d 6265 722e 2020 536f 2061 6674 6572 umber. So after │ │ │ │ │ +00021870: 2069 7420 6861 7320 666f 756e 6420 272f it has found '/ │ │ │ │ │ +00021880: 7573 722f 7368 6172 652f 6163 6c6f 6361 usr/share/acloca │ │ │ │ │ +00021890: 6c2f 7468 6972 6470 6172 7479 2e6d 3427 l/thirdparty.m4' │ │ │ │ │ +000218a0: 0a77 6974 6820 7365 7269 616c 2032 2c20 .with serial 2, │ │ │ │ │ +000218b0: 2761 636c 6f63 616c 2720 7769 6c6c 2070 'aclocal' will p │ │ │ │ │ +000218c0: 726f 6365 6564 2061 7320 6966 2069 7420 roceed as if it │ │ │ │ │ +000218d0: 6861 6420 6e65 7665 7220 7365 656e 0a27 had never seen.' │ │ │ │ │ +000218e0: 6d34 2f74 6869 7264 7061 7274 792e 6d34 m4/thirdparty.m4 │ │ │ │ │ +000218f0: 272e 2020 5468 6973 2062 7269 6e67 7320 '. This brings │ │ │ │ │ +00021900: 7573 2062 6163 6b20 746f 2061 2073 6974 us back to a sit │ │ │ │ │ +00021910: 7561 7469 6f6e 2073 696d 696c 6172 2074 uation similar t │ │ │ │ │ +00021920: 6f20 7468 6174 0a61 7420 7468 6520 6265 o that.at the be │ │ │ │ │ +00021930: 6769 6e6e 696e 6720 6f66 206f 7572 2065 ginning of our e │ │ │ │ │ +00021940: 7861 6d70 6c65 2c20 7768 6572 6520 6e6f xample, where no │ │ │ │ │ +00021950: 206c 6f63 616c 2066 696c 6520 6465 6669 local file defi │ │ │ │ │ +00021960: 6e65 6420 7468 6520 6d61 6372 6f2e 0a27 ned the macro..' │ │ │ │ │ +00021970: 6163 6c6f 6361 6c27 2077 696c 6c20 696e aclocal' will in │ │ │ │ │ +00021980: 7374 616c 6c20 7468 6520 6e65 7720 7665 stall the new ve │ │ │ │ │ +00021990: 7273 696f 6e20 6f66 2074 6865 206d 6163 rsion of the mac │ │ │ │ │ +000219a0: 726f 2069 6e0a 276d 342f 7468 6972 6470 ro in.'m4/thirdp │ │ │ │ │ +000219b0: 6172 7479 2e6d 3427 2c20 696e 2074 6869 arty.m4', in thi │ │ │ │ │ +000219c0: 7320 6361 7365 206f 7665 7272 6964 696e s case overridin │ │ │ │ │ +000219d0: 6720 7468 6520 6f6c 6420 7665 7273 696f g the old versio │ │ │ │ │ +000219e0: 6e2e 2020 4d79 5061 636b 6167 650a 6a75 n. MyPackage.ju │ │ │ │ │ +000219f0: 7374 2068 6164 2069 7473 206d 6163 726f st had its macro │ │ │ │ │ +00021a00: 2075 7064 6174 6564 2061 7320 6120 7369 updated as a si │ │ │ │ │ +00021a10: 6465 2065 6666 6563 7420 6f66 2072 756e de effect of run │ │ │ │ │ +00021a20: 6e69 6e67 2027 6163 6c6f 6361 6c27 2e0a ning 'aclocal'.. │ │ │ │ │ +00021a30: 0a20 2020 4966 2079 6f75 2061 7265 206c . If you are l │ │ │ │ │ +00021a40: 6565 7279 206f 6620 6c65 7474 696e 6720 eery of letting │ │ │ │ │ +00021a50: 2761 636c 6f63 616c 2720 7570 6461 7465 'aclocal' update │ │ │ │ │ +00021a60: 2079 6f75 7220 6c6f 6361 6c20 6d61 6372 your local macr │ │ │ │ │ +00021a70: 6f2c 2079 6f75 0a63 616e 2072 756e 2027 o, you.can run ' │ │ │ │ │ +00021a80: 6163 6c6f 6361 6c20 2d49 206d 3420 2d2d aclocal -I m4 -- │ │ │ │ │ +00021a90: 6469 6666 2720 746f 2072 6576 6965 7720 diff' to review │ │ │ │ │ +00021aa0: 7468 6520 6368 616e 6765 7320 2761 636c the changes 'acl │ │ │ │ │ +00021ab0: 6f63 616c 202d 4920 6d34 0a2d 2d69 6e73 ocal -I m4.--ins │ │ │ │ │ +00021ac0: 7461 6c6c 2720 776f 756c 6420 7065 7266 tall' would perf │ │ │ │ │ +00021ad0: 6f72 6d20 6f6e 2074 6865 7365 206d 6163 orm on these mac │ │ │ │ │ +00021ae0: 726f 732e 0a0a 2020 2046 696e 616c 6c79 ros... Finally │ │ │ │ │ +00021af0: 2c20 6e6f 7465 2074 6861 7420 7468 6520 , note that the │ │ │ │ │ +00021b00: 272d 2d66 6f72 6365 2720 6f70 7469 6f6e '--force' option │ │ │ │ │ +00021b10: 206f 6620 2761 636c 6f63 616c 2720 6861 of 'aclocal' ha │ │ │ │ │ +00021b20: 7320 6162 736f 6c75 7465 6c79 0a6e 6f20 s absolutely.no │ │ │ │ │ +00021b30: 6566 6665 6374 206f 6e20 7468 6520 6669 effect on the fi │ │ │ │ │ +00021b40: 6c65 7320 696e 7374 616c 6c65 6420 6279 les installed by │ │ │ │ │ +00021b50: 2027 2d2d 696e 7374 616c 6c27 2e20 2046 '--install'. F │ │ │ │ │ +00021b60: 6f72 2069 6e73 7461 6e63 652c 2069 6620 or instance, if │ │ │ │ │ +00021b70: 796f 750a 6861 7665 206d 6f64 6966 6965 you.have modifie │ │ │ │ │ +00021b80: 6420 796f 7572 206c 6f63 616c 206d 6163 d your local mac │ │ │ │ │ +00021b90: 726f 732c 2064 6f20 6e6f 7420 6578 7065 ros, do not expe │ │ │ │ │ +00021ba0: 6374 2027 2d2d 696e 7374 616c 6c20 2d2d ct '--install -- │ │ │ │ │ +00021bb0: 666f 7263 6527 2074 6f0a 7265 706c 6163 force' to.replac │ │ │ │ │ +00021bc0: 6520 7468 6520 6c6f 6361 6c20 6d61 6372 e the local macr │ │ │ │ │ +00021bd0: 6f73 2062 7920 7468 6569 7220 7379 7374 os by their syst │ │ │ │ │ +00021be0: 656d 2d77 6964 6520 7665 7273 696f 6e73 em-wide versions │ │ │ │ │ +00021bf0: 2e20 2049 6620 796f 7520 7761 6e74 2074 . If you want t │ │ │ │ │ +00021c00: 6f0a 646f 2073 6f2c 2073 696d 706c 7920 o.do so, simply │ │ │ │ │ +00021c10: 6572 6173 6520 7468 6520 6c6f 6361 6c20 erase the local │ │ │ │ │ +00021c20: 6d61 6372 6f73 2079 6f75 2077 616e 7420 macros you want │ │ │ │ │ +00021c30: 746f 2072 6576 6572 742c 2061 6e64 2072 to revert, and r │ │ │ │ │ +00021c40: 756e 0a27 6163 6c6f 6361 6c20 2d49 206d un.'aclocal -I m │ │ │ │ │ +00021c50: 3420 2d2d 696e 7374 616c 6c27 2e0a 0a1f 4 --install'.... │ │ │ │ │ +00021c60: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +00021c70: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +00021c80: 3a20 4675 7475 7265 206f 6620 6163 6c6f : Future of aclo │ │ │ │ │ +00021c90: 6361 6c2c 2020 5072 6576 3a20 5365 7269 cal, Prev: Seri │ │ │ │ │ +00021ca0: 616c 732c 2020 5570 3a20 6163 6c6f 6361 als, Up: acloca │ │ │ │ │ +00021cb0: 6c20 496e 766f 6361 7469 6f6e 0a0a 362e l Invocation..6. │ │ │ │ │ +00021cc0: 332e 3620 5468 6520 4675 7475 7265 206f 3.6 The Future o │ │ │ │ │ +00021cd0: 6620 2761 636c 6f63 616c 270a 2d2d 2d2d f 'aclocal'.---- │ │ │ │ │ 00021ce0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00021cf0: 2d2d 2d2d 2d2d 2d0a 0a27 6163 6c6f 6361 -------..'acloca │ │ │ │ │ -00021d00: 6c27 2069 7320 6578 7065 6374 6564 2074 l' is expected t │ │ │ │ │ -00021d10: 6f20 6469 7361 7070 6561 722e 2020 5468 o disappear. Th │ │ │ │ │ -00021d20: 6973 2066 6561 7475 7265 2072 6561 6c6c is feature reall │ │ │ │ │ -00021d30: 7920 7368 6f75 6c64 206e 6f74 2062 650a y should not be. │ │ │ │ │ -00021d40: 6f66 6665 7265 6420 6279 2041 7574 6f6d offered by Autom │ │ │ │ │ -00021d50: 616b 652e 2020 4175 746f 6d61 6b65 2073 ake. Automake s │ │ │ │ │ -00021d60: 686f 756c 6420 666f 6375 7320 6f6e 2067 hould focus on g │ │ │ │ │ -00021d70: 656e 6572 6174 696e 6720 274d 616b 6566 enerating 'Makef │ │ │ │ │ -00021d80: 696c 6527 733b 0a64 6561 6c69 6e67 2077 ile's;.dealing w │ │ │ │ │ -00021d90: 6974 6820 4d34 206d 6163 726f 7320 7265 ith M4 macros re │ │ │ │ │ -00021da0: 616c 6c79 2069 7320 4175 746f 636f 6e66 ally is Autoconf │ │ │ │ │ -00021db0: 2773 206a 6f62 2e20 2054 6865 2066 6163 's job. The fac │ │ │ │ │ -00021dc0: 7420 7468 6174 2073 6f6d 650a 7065 6f70 t that some.peop │ │ │ │ │ -00021dd0: 6c65 2069 6e73 7461 6c6c 2041 7574 6f6d le install Autom │ │ │ │ │ -00021de0: 616b 6520 6a75 7374 2074 6f20 7573 6520 ake just to use │ │ │ │ │ -00021df0: 2761 636c 6f63 616c 272c 2062 7574 2064 'aclocal', but d │ │ │ │ │ -00021e00: 6f20 6e6f 7420 7573 6520 2761 7574 6f6d o not use 'autom │ │ │ │ │ -00021e10: 616b 6527 0a6f 7468 6572 7769 7365 2069 ake'.otherwise i │ │ │ │ │ -00021e20: 7320 616e 2069 6e64 6963 6174 696f 6e20 s an indication │ │ │ │ │ -00021e30: 6f66 2068 6f77 2074 6861 7420 6665 6174 of how that feat │ │ │ │ │ -00021e40: 7572 6520 6973 206d 6973 706c 6163 6564 ure is misplaced │ │ │ │ │ -00021e50: 2e0a 0a20 2020 5468 6520 6e65 7720 696d ... The new im │ │ │ │ │ -00021e60: 706c 656d 656e 7461 7469 6f6e 2077 696c plementation wil │ │ │ │ │ -00021e70: 6c20 7072 6f62 6162 6c79 2062 6520 646f l probably be do │ │ │ │ │ -00021e80: 6e65 2073 6c69 6768 746c 7920 6469 6666 ne slightly diff │ │ │ │ │ -00021e90: 6572 656e 746c 792e 0a46 6f72 2069 6e73 erently..For ins │ │ │ │ │ -00021ea0: 7461 6e63 652c 2069 7420 636f 756c 6420 tance, it could │ │ │ │ │ -00021eb0: 656e 666f 7263 6520 7468 6520 276d 342f enforce the 'm4/ │ │ │ │ │ -00021ec0: 272d 7374 796c 6520 6c61 796f 7574 2064 '-style layout d │ │ │ │ │ -00021ed0: 6973 6375 7373 6564 2069 6e20 2a6e 6f74 iscussed in *not │ │ │ │ │ -00021ee0: 650a 4c6f 6361 6c20 4d61 6372 6f73 3a3a e.Local Macros:: │ │ │ │ │ -00021ef0: 2e0a 0a20 2020 5765 2068 6176 6520 6e6f ... We have no │ │ │ │ │ -00021f00: 2069 6465 6120 7768 656e 2061 6e64 2068 idea when and h │ │ │ │ │ -00021f10: 6f77 2074 6869 7320 7769 6c6c 2068 6170 ow this will hap │ │ │ │ │ -00021f20: 7065 6e2e 2020 5468 6973 2068 6173 2062 pen. This has b │ │ │ │ │ -00021f30: 6565 6e0a 6469 7363 7573 7365 6420 7365 een.discussed se │ │ │ │ │ -00021f40: 7665 7261 6c20 7469 6d65 7320 696e 2074 veral times in t │ │ │ │ │ -00021f50: 6865 2070 6173 742c 2062 7574 2073 6f6d he past, but som │ │ │ │ │ -00021f60: 656f 6e65 2073 7469 6c6c 2068 6173 2074 eone still has t │ │ │ │ │ -00021f70: 6f20 636f 6d6d 6974 2074 6f0a 7468 6174 o commit to.that │ │ │ │ │ -00021f80: 206e 6f6e 2d74 7269 7669 616c 2074 6173 non-trivial tas │ │ │ │ │ -00021f90: 6b2e 0a0a 2020 2046 726f 6d20 7468 6520 k... From the │ │ │ │ │ -00021fa0: 7573 6572 2070 6f69 6e74 206f 6620 7669 user point of vi │ │ │ │ │ -00021fb0: 6577 2c20 2761 636c 6f63 616c 2727 7320 ew, 'aclocal''s │ │ │ │ │ -00021fc0: 7265 6d6f 7661 6c20 6d69 6768 7420 7475 removal might tu │ │ │ │ │ -00021fd0: 726e 206f 7574 2074 6f20 6265 0a70 6169 rn out to be.pai │ │ │ │ │ -00021fe0: 6e66 756c 2e20 2054 6865 7265 2069 7320 nful. There is │ │ │ │ │ -00021ff0: 6120 7369 6d70 6c65 2070 7265 6361 7574 a simple precaut │ │ │ │ │ -00022000: 696f 6e20 7468 6174 2079 6f75 206d 6179 ion that you may │ │ │ │ │ -00022010: 2074 616b 6520 746f 206d 616b 6520 7468 take to make th │ │ │ │ │ -00022020: 6174 0a73 7769 7463 6820 6d6f 7265 2073 at.switch more s │ │ │ │ │ -00022030: 6561 6d6c 6573 733a 206e 6576 6572 2063 eamless: never c │ │ │ │ │ -00022040: 616c 6c20 2761 636c 6f63 616c 2720 796f all 'aclocal' yo │ │ │ │ │ -00022050: 7572 7365 6c66 2e20 204b 6565 7020 7468 urself. Keep th │ │ │ │ │ -00022060: 6973 2067 7579 0a75 6e64 6572 2074 6865 is guy.under the │ │ │ │ │ -00022070: 2065 7863 6c75 7369 7665 2063 6f6e 7472 exclusive contr │ │ │ │ │ -00022080: 6f6c 206f 6620 2761 7574 6f72 6563 6f6e ol of 'autorecon │ │ │ │ │ -00022090: 6627 2061 6e64 2041 7574 6f6d 616b 6527 f' and Automake' │ │ │ │ │ -000220a0: 7320 7265 6275 696c 640a 7275 6c65 732e s rebuild.rules. │ │ │ │ │ -000220b0: 2020 486f 7065 6675 6c6c 7920 796f 7520 Hopefully you │ │ │ │ │ -000220c0: 776f 6e27 7420 6e65 6564 2074 6f20 776f won't need to wo │ │ │ │ │ -000220d0: 7272 7920 6162 6f75 7420 7468 696e 6773 rry about things │ │ │ │ │ -000220e0: 2062 7265 616b 696e 672c 2077 6865 6e0a breaking, when. │ │ │ │ │ -000220f0: 2761 636c 6f63 616c 2720 6469 7361 7070 'aclocal' disapp │ │ │ │ │ -00022100: 6561 7273 2c20 6265 6361 7573 6520 6576 ears, because ev │ │ │ │ │ -00022110: 6572 7974 6869 6e67 2077 696c 6c20 6861 erything will ha │ │ │ │ │ -00022120: 7665 2062 6565 6e20 7461 6b65 6e20 6361 ve been taken ca │ │ │ │ │ -00022130: 7265 206f 662e 0a49 6620 6f74 6865 7277 re of..If otherw │ │ │ │ │ -00022140: 6973 6520 796f 7520 7573 6564 2074 6f20 ise you used to │ │ │ │ │ -00022150: 6361 6c6c 2027 6163 6c6f 6361 6c27 2064 call 'aclocal' d │ │ │ │ │ -00022160: 6972 6563 746c 7920 796f 7572 7365 6c66 irectly yourself │ │ │ │ │ -00022170: 206f 7220 6672 6f6d 2073 6f6d 650a 7363 or from some.sc │ │ │ │ │ -00022180: 7269 7074 2c20 796f 7520 7769 6c6c 2071 ript, you will q │ │ │ │ │ -00022190: 7569 636b 6c79 206e 6f74 6963 6520 7468 uickly notice th │ │ │ │ │ -000221a0: 6520 6368 616e 6765 2e0a 0a20 2020 4d61 e change... Ma │ │ │ │ │ -000221b0: 6e79 2070 6163 6b61 6765 7320 636f 6d65 ny packages come │ │ │ │ │ -000221c0: 2077 6974 6820 6120 7363 7269 7074 2063 with a script c │ │ │ │ │ -000221d0: 616c 6c65 6420 2762 6f6f 7473 7472 6170 alled 'bootstrap │ │ │ │ │ -000221e0: 2e73 6827 206f 720a 2761 7574 6f67 656e .sh' or.'autogen │ │ │ │ │ -000221f0: 2e73 6827 2c20 7468 6174 2077 696c 6c20 .sh', that will │ │ │ │ │ -00022200: 6a75 7374 2063 616c 6c20 2761 636c 6f63 just call 'acloc │ │ │ │ │ -00022210: 616c 272c 2027 6c69 6274 6f6f 6c69 7a65 al', 'libtoolize │ │ │ │ │ -00022220: 272c 2027 6765 7474 6578 7469 7a65 270a ', 'gettextize'. │ │ │ │ │ -00022230: 6f72 2027 6175 746f 706f 696e 7427 2c20 or 'autopoint', │ │ │ │ │ -00022240: 2761 7574 6f63 6f6e 6627 2c20 2761 7574 'autoconf', 'aut │ │ │ │ │ -00022250: 6f68 6561 6465 7227 2c20 616e 6420 2761 oheader', and 'a │ │ │ │ │ -00022260: 7574 6f6d 616b 6527 2069 6e20 7468 6520 utomake' in the │ │ │ │ │ -00022270: 7269 6768 740a 6f72 6465 722e 2020 4163 right.order. Ac │ │ │ │ │ -00022280: 7475 616c 6c79 2074 6869 7320 6973 2070 tually this is p │ │ │ │ │ -00022290: 7265 6369 7365 6c79 2077 6861 7420 2761 recisely what 'a │ │ │ │ │ -000222a0: 7574 6f72 6563 6f6e 6627 2063 616e 2064 utoreconf' can d │ │ │ │ │ -000222b0: 6f20 666f 7220 796f 752e 2020 4966 0a79 o for you. If.y │ │ │ │ │ -000222c0: 6f75 7220 7061 636b 6167 6520 6861 7320 our package has │ │ │ │ │ -000222d0: 7375 6368 2061 2027 626f 6f74 7374 7261 such a 'bootstra │ │ │ │ │ -000222e0: 702e 7368 2720 6f72 2027 6175 746f 6765 p.sh' or 'autoge │ │ │ │ │ -000222f0: 6e2e 7368 2720 7363 7269 7074 2c20 636f n.sh' script, co │ │ │ │ │ -00022300: 6e73 6964 6572 0a75 7369 6e67 2027 6175 nsider.using 'au │ │ │ │ │ -00022310: 746f 7265 636f 6e66 272e 2020 5468 6174 toreconf'. That │ │ │ │ │ -00022320: 2073 686f 756c 6420 7369 6d70 6c69 6679 should simplify │ │ │ │ │ -00022330: 2069 7473 206c 6f67 6963 2061 206c 6f74 its logic a lot │ │ │ │ │ -00022340: 2028 6c65 7373 2074 6869 6e67 730a 746f (less things.to │ │ │ │ │ -00022350: 206d 6169 6e74 6169 6e2c 2079 756d 2129 maintain, yum!) │ │ │ │ │ -00022360: 2c20 6974 2773 2065 7665 6e20 6c69 6b65 , it's even like │ │ │ │ │ -00022370: 6c79 2079 6f75 2077 696c 6c20 6e6f 7420 ly you will not │ │ │ │ │ -00022380: 6e65 6564 2074 6865 2073 6372 6970 740a need the script. │ │ │ │ │ -00022390: 616e 796d 6f72 652c 2061 6e64 206d 6f72 anymore, and mor │ │ │ │ │ -000223a0: 6520 746f 2074 6865 2070 6f69 6e74 2079 e to the point y │ │ │ │ │ -000223b0: 6f75 2077 696c 6c20 6e6f 7420 6361 6c6c ou will not call │ │ │ │ │ -000223c0: 2027 6163 6c6f 6361 6c27 2064 6972 6563 'aclocal' direc │ │ │ │ │ -000223d0: 746c 790a 616e 796d 6f72 652e 0a0a 2020 tly.anymore... │ │ │ │ │ -000223e0: 2046 6f72 2074 6865 2074 696d 6520 6265 For the time be │ │ │ │ │ -000223f0: 696e 672c 2074 6869 7264 2d70 6172 7479 ing, third-party │ │ │ │ │ -00022400: 2070 6163 6b61 6765 7320 7368 6f75 6c64 packages should │ │ │ │ │ -00022410: 2063 6f6e 7469 6e75 6520 746f 2069 6e73 continue to ins │ │ │ │ │ -00022420: 7461 6c6c 0a70 7562 6c69 6320 6d61 6372 tall.public macr │ │ │ │ │ -00022430: 6f73 2069 6e74 6f20 272f 7573 722f 7368 os into '/usr/sh │ │ │ │ │ -00022440: 6172 652f 6163 6c6f 6361 6c2f 272e 2020 are/aclocal/'. │ │ │ │ │ -00022450: 4966 2027 6163 6c6f 6361 6c27 2069 7320 If 'aclocal' is │ │ │ │ │ -00022460: 7265 706c 6163 6564 2062 790a 616e 6f74 replaced by.anot │ │ │ │ │ -00022470: 6865 7220 746f 6f6c 2069 7420 6d69 6768 her tool it migh │ │ │ │ │ -00022480: 7420 6d61 6b65 2073 656e 7365 2074 6f20 t make sense to │ │ │ │ │ -00022490: 7265 6e61 6d65 2074 6865 2064 6972 6563 rename the direc │ │ │ │ │ -000224a0: 746f 7279 2c20 6275 7420 7375 7070 6f72 tory, but suppor │ │ │ │ │ -000224b0: 7469 6e67 0a27 2f75 7372 2f73 6861 7265 ting.'/usr/share │ │ │ │ │ -000224c0: 2f61 636c 6f63 616c 2f27 2066 6f72 2062 /aclocal/' for b │ │ │ │ │ -000224d0: 6163 6b77 6172 6420 636f 6d70 6174 6962 ackward compatib │ │ │ │ │ -000224e0: 696c 6974 7920 7368 6f75 6c64 2062 6520 ility should be │ │ │ │ │ -000224f0: 7265 616c 6c79 2065 6173 790a 7072 6f76 really easy.prov │ │ │ │ │ -00022500: 6964 6564 2061 6c6c 206d 6163 726f 7320 ided all macros │ │ │ │ │ -00022510: 6172 6520 7072 6f70 6572 6c79 2077 7269 are properly wri │ │ │ │ │ -00022520: 7474 656e 2028 2a6e 6f74 6520 4578 7465 tten (*note Exte │ │ │ │ │ -00022530: 6e64 696e 6720 6163 6c6f 6361 6c3a 3a29 nding aclocal::) │ │ │ │ │ -00022540: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ -00022550: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -00022560: 4e6f 6465 3a20 4d61 6372 6f73 2c20 2050 Node: Macros, P │ │ │ │ │ -00022570: 7265 763a 2061 636c 6f63 616c 2049 6e76 rev: aclocal Inv │ │ │ │ │ -00022580: 6f63 6174 696f 6e2c 2020 5570 3a20 636f ocation, Up: co │ │ │ │ │ -00022590: 6e66 6967 7572 650a 0a36 2e34 2041 7574 nfigure..6.4 Aut │ │ │ │ │ -000225a0: 6f63 6f6e 6620 6d61 6372 6f73 2073 7570 oconf macros sup │ │ │ │ │ -000225b0: 706c 6965 6420 7769 7468 2041 7574 6f6d plied with Autom │ │ │ │ │ -000225c0: 616b 650a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ake.============ │ │ │ │ │ +00021cf0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a27 6163 6c6f ---------..'aclo │ │ │ │ │ +00021d00: 6361 6c27 2069 7320 6578 7065 6374 6564 cal' is expected │ │ │ │ │ +00021d10: 2074 6f20 6469 7361 7070 6561 722e 2020 to disappear. │ │ │ │ │ +00021d20: 5468 6973 2066 6561 7475 7265 2072 6561 This feature rea │ │ │ │ │ +00021d30: 6c6c 7920 7368 6f75 6c64 206e 6f74 2062 lly should not b │ │ │ │ │ +00021d40: 650a 6f66 6665 7265 6420 6279 2041 7574 e.offered by Aut │ │ │ │ │ +00021d50: 6f6d 616b 652e 2020 4175 746f 6d61 6b65 omake. Automake │ │ │ │ │ +00021d60: 2073 686f 756c 6420 666f 6375 7320 6f6e should focus on │ │ │ │ │ +00021d70: 2067 656e 6572 6174 696e 6720 274d 616b generating 'Mak │ │ │ │ │ +00021d80: 6566 696c 6527 733b 0a64 6561 6c69 6e67 efile's;.dealing │ │ │ │ │ +00021d90: 2077 6974 6820 4d34 206d 6163 726f 7320 with M4 macros │ │ │ │ │ +00021da0: 7265 616c 6c79 2069 7320 4175 746f 636f really is Autoco │ │ │ │ │ +00021db0: 6e66 2773 206a 6f62 2e20 2054 6865 2066 nf's job. The f │ │ │ │ │ +00021dc0: 6163 7420 7468 6174 2073 6f6d 650a 7065 act that some.pe │ │ │ │ │ +00021dd0: 6f70 6c65 2069 6e73 7461 6c6c 2041 7574 ople install Aut │ │ │ │ │ +00021de0: 6f6d 616b 6520 6a75 7374 2074 6f20 7573 omake just to us │ │ │ │ │ +00021df0: 6520 2761 636c 6f63 616c 272c 2062 7574 e 'aclocal', but │ │ │ │ │ +00021e00: 2064 6f20 6e6f 7420 7573 6520 2761 7574 do not use 'aut │ │ │ │ │ +00021e10: 6f6d 616b 6527 0a6f 7468 6572 7769 7365 omake'.otherwise │ │ │ │ │ +00021e20: 2069 7320 616e 2069 6e64 6963 6174 696f is an indicatio │ │ │ │ │ +00021e30: 6e20 6f66 2068 6f77 2074 6861 7420 6665 n of how that fe │ │ │ │ │ +00021e40: 6174 7572 6520 6973 206d 6973 706c 6163 ature is misplac │ │ │ │ │ +00021e50: 6564 2e0a 0a20 2020 5468 6520 6e65 7720 ed... The new │ │ │ │ │ +00021e60: 696d 706c 656d 656e 7461 7469 6f6e 2077 implementation w │ │ │ │ │ +00021e70: 696c 6c20 7072 6f62 6162 6c79 2062 6520 ill probably be │ │ │ │ │ +00021e80: 646f 6e65 2073 6c69 6768 746c 7920 6469 done slightly di │ │ │ │ │ +00021e90: 6666 6572 656e 746c 792e 0a46 6f72 2069 fferently..For i │ │ │ │ │ +00021ea0: 6e73 7461 6e63 652c 2069 7420 636f 756c nstance, it coul │ │ │ │ │ +00021eb0: 6420 656e 666f 7263 6520 7468 6520 276d d enforce the 'm │ │ │ │ │ +00021ec0: 342f 272d 7374 796c 6520 6c61 796f 7574 4/'-style layout │ │ │ │ │ +00021ed0: 2064 6973 6375 7373 6564 2069 6e20 2a6e discussed in *n │ │ │ │ │ +00021ee0: 6f74 650a 4c6f 6361 6c20 4d61 6372 6f73 ote.Local Macros │ │ │ │ │ +00021ef0: 3a3a 2e0a 0a20 2020 5765 2068 6176 6520 ::... We have │ │ │ │ │ +00021f00: 6e6f 2069 6465 6120 7768 656e 2061 6e64 no idea when and │ │ │ │ │ +00021f10: 2068 6f77 2074 6869 7320 7769 6c6c 2068 how this will h │ │ │ │ │ +00021f20: 6170 7065 6e2e 2020 5468 6973 2068 6173 appen. This has │ │ │ │ │ +00021f30: 2062 6565 6e0a 6469 7363 7573 7365 6420 been.discussed │ │ │ │ │ +00021f40: 7365 7665 7261 6c20 7469 6d65 7320 696e several times in │ │ │ │ │ +00021f50: 2074 6865 2070 6173 742c 2062 7574 2073 the past, but s │ │ │ │ │ +00021f60: 6f6d 656f 6e65 2073 7469 6c6c 2068 6173 omeone still has │ │ │ │ │ +00021f70: 2074 6f20 636f 6d6d 6974 2074 6f0a 7468 to commit to.th │ │ │ │ │ +00021f80: 6174 206e 6f6e 2d74 7269 7669 616c 2074 at non-trivial t │ │ │ │ │ +00021f90: 6173 6b2e 0a0a 2020 2046 726f 6d20 7468 ask... From th │ │ │ │ │ +00021fa0: 6520 7573 6572 2070 6f69 6e74 206f 6620 e user point of │ │ │ │ │ +00021fb0: 7669 6577 2c20 2761 636c 6f63 616c 2727 view, 'aclocal'' │ │ │ │ │ +00021fc0: 7320 7265 6d6f 7661 6c20 6d69 6768 7420 s removal might │ │ │ │ │ +00021fd0: 7475 726e 206f 7574 2074 6f20 6265 0a70 turn out to be.p │ │ │ │ │ +00021fe0: 6169 6e66 756c 2e20 2054 6865 7265 2069 ainful. There i │ │ │ │ │ +00021ff0: 7320 6120 7369 6d70 6c65 2070 7265 6361 s a simple preca │ │ │ │ │ +00022000: 7574 696f 6e20 7468 6174 2079 6f75 206d ution that you m │ │ │ │ │ +00022010: 6179 2074 616b 6520 746f 206d 616b 6520 ay take to make │ │ │ │ │ +00022020: 7468 6174 0a73 7769 7463 6820 6d6f 7265 that.switch more │ │ │ │ │ +00022030: 2073 6561 6d6c 6573 733a 206e 6576 6572 seamless: never │ │ │ │ │ +00022040: 2063 616c 6c20 2761 636c 6f63 616c 2720 call 'aclocal' │ │ │ │ │ +00022050: 796f 7572 7365 6c66 2e20 204b 6565 7020 yourself. Keep │ │ │ │ │ +00022060: 7468 6973 2067 7579 0a75 6e64 6572 2074 this guy.under t │ │ │ │ │ +00022070: 6865 2065 7863 6c75 7369 7665 2063 6f6e he exclusive con │ │ │ │ │ +00022080: 7472 6f6c 206f 6620 2761 7574 6f72 6563 trol of 'autorec │ │ │ │ │ +00022090: 6f6e 6627 2061 6e64 2041 7574 6f6d 616b onf' and Automak │ │ │ │ │ +000220a0: 6527 7320 7265 6275 696c 640a 7275 6c65 e's rebuild.rule │ │ │ │ │ +000220b0: 732e 2020 486f 7065 6675 6c6c 7920 796f s. Hopefully yo │ │ │ │ │ +000220c0: 7520 776f 6e27 7420 6e65 6564 2074 6f20 u won't need to │ │ │ │ │ +000220d0: 776f 7272 7920 6162 6f75 7420 7468 696e worry about thin │ │ │ │ │ +000220e0: 6773 2062 7265 616b 696e 672c 2077 6865 gs breaking, whe │ │ │ │ │ +000220f0: 6e0a 2761 636c 6f63 616c 2720 6469 7361 n.'aclocal' disa │ │ │ │ │ +00022100: 7070 6561 7273 2c20 6265 6361 7573 6520 ppears, because │ │ │ │ │ +00022110: 6576 6572 7974 6869 6e67 2077 696c 6c20 everything will │ │ │ │ │ +00022120: 6861 7665 2062 6565 6e20 7461 6b65 6e20 have been taken │ │ │ │ │ +00022130: 6361 7265 206f 662e 0a49 6620 6f74 6865 care of..If othe │ │ │ │ │ +00022140: 7277 6973 6520 796f 7520 7573 6564 2074 rwise you used t │ │ │ │ │ +00022150: 6f20 6361 6c6c 2027 6163 6c6f 6361 6c27 o call 'aclocal' │ │ │ │ │ +00022160: 2064 6972 6563 746c 7920 796f 7572 7365 directly yourse │ │ │ │ │ +00022170: 6c66 206f 7220 6672 6f6d 2073 6f6d 650a lf or from some. │ │ │ │ │ +00022180: 7363 7269 7074 2c20 796f 7520 7769 6c6c script, you will │ │ │ │ │ +00022190: 2071 7569 636b 6c79 206e 6f74 6963 6520 quickly notice │ │ │ │ │ +000221a0: 7468 6520 6368 616e 6765 2e0a 0a20 2020 the change... │ │ │ │ │ +000221b0: 4d61 6e79 2070 6163 6b61 6765 7320 636f Many packages co │ │ │ │ │ +000221c0: 6d65 2077 6974 6820 6120 7363 7269 7074 me with a script │ │ │ │ │ +000221d0: 2063 616c 6c65 6420 2762 6f6f 7473 7472 called 'bootstr │ │ │ │ │ +000221e0: 6170 2e73 6827 206f 720a 2761 7574 6f67 ap.sh' or.'autog │ │ │ │ │ +000221f0: 656e 2e73 6827 2c20 7468 6174 2077 696c en.sh', that wil │ │ │ │ │ +00022200: 6c20 6a75 7374 2063 616c 6c20 2761 636c l just call 'acl │ │ │ │ │ +00022210: 6f63 616c 272c 2027 6c69 6274 6f6f 6c69 ocal', 'libtooli │ │ │ │ │ +00022220: 7a65 272c 2027 6765 7474 6578 7469 7a65 ze', 'gettextize │ │ │ │ │ +00022230: 270a 6f72 2027 6175 746f 706f 696e 7427 '.or 'autopoint' │ │ │ │ │ +00022240: 2c20 2761 7574 6f63 6f6e 6627 2c20 2761 , 'autoconf', 'a │ │ │ │ │ +00022250: 7574 6f68 6561 6465 7227 2c20 616e 6420 utoheader', and │ │ │ │ │ +00022260: 2761 7574 6f6d 616b 6527 2069 6e20 7468 'automake' in th │ │ │ │ │ +00022270: 6520 7269 6768 740a 6f72 6465 722e 2020 e right.order. │ │ │ │ │ +00022280: 4163 7475 616c 6c79 2074 6869 7320 6973 Actually this is │ │ │ │ │ +00022290: 2070 7265 6369 7365 6c79 2077 6861 7420 precisely what │ │ │ │ │ +000222a0: 2761 7574 6f72 6563 6f6e 6627 2063 616e 'autoreconf' can │ │ │ │ │ +000222b0: 2064 6f20 666f 7220 796f 752e 2020 4966 do for you. If │ │ │ │ │ +000222c0: 0a79 6f75 7220 7061 636b 6167 6520 6861 .your package ha │ │ │ │ │ +000222d0: 7320 7375 6368 2061 2027 626f 6f74 7374 s such a 'bootst │ │ │ │ │ +000222e0: 7261 702e 7368 2720 6f72 2027 6175 746f rap.sh' or 'auto │ │ │ │ │ +000222f0: 6765 6e2e 7368 2720 7363 7269 7074 2c20 gen.sh' script, │ │ │ │ │ +00022300: 636f 6e73 6964 6572 0a75 7369 6e67 2027 consider.using ' │ │ │ │ │ +00022310: 6175 746f 7265 636f 6e66 272e 2020 5468 autoreconf'. Th │ │ │ │ │ +00022320: 6174 2073 686f 756c 6420 7369 6d70 6c69 at should simpli │ │ │ │ │ +00022330: 6679 2069 7473 206c 6f67 6963 2061 206c fy its logic a l │ │ │ │ │ +00022340: 6f74 2028 6c65 7373 2074 6869 6e67 730a ot (less things. │ │ │ │ │ +00022350: 746f 206d 6169 6e74 6169 6e2c 2079 756d to maintain, yum │ │ │ │ │ +00022360: 2129 2c20 6974 2773 2065 7665 6e20 6c69 !), it's even li │ │ │ │ │ +00022370: 6b65 6c79 2079 6f75 2077 696c 6c20 6e6f kely you will no │ │ │ │ │ +00022380: 7420 6e65 6564 2074 6865 2073 6372 6970 t need the scrip │ │ │ │ │ +00022390: 740a 616e 796d 6f72 652c 2061 6e64 206d t.anymore, and m │ │ │ │ │ +000223a0: 6f72 6520 746f 2074 6865 2070 6f69 6e74 ore to the point │ │ │ │ │ +000223b0: 2079 6f75 2077 696c 6c20 6e6f 7420 6361 you will not ca │ │ │ │ │ +000223c0: 6c6c 2027 6163 6c6f 6361 6c27 2064 6972 ll 'aclocal' dir │ │ │ │ │ +000223d0: 6563 746c 790a 616e 796d 6f72 652e 0a0a ectly.anymore... │ │ │ │ │ +000223e0: 2020 2046 6f72 2074 6865 2074 696d 6520 For the time │ │ │ │ │ +000223f0: 6265 696e 672c 2074 6869 7264 2d70 6172 being, third-par │ │ │ │ │ +00022400: 7479 2070 6163 6b61 6765 7320 7368 6f75 ty packages shou │ │ │ │ │ +00022410: 6c64 2063 6f6e 7469 6e75 6520 746f 2069 ld continue to i │ │ │ │ │ +00022420: 6e73 7461 6c6c 0a70 7562 6c69 6320 6d61 nstall.public ma │ │ │ │ │ +00022430: 6372 6f73 2069 6e74 6f20 272f 7573 722f cros into '/usr/ │ │ │ │ │ +00022440: 7368 6172 652f 6163 6c6f 6361 6c2f 272e share/aclocal/'. │ │ │ │ │ +00022450: 2020 4966 2027 6163 6c6f 6361 6c27 2069 If 'aclocal' i │ │ │ │ │ +00022460: 7320 7265 706c 6163 6564 2062 790a 616e s replaced by.an │ │ │ │ │ +00022470: 6f74 6865 7220 746f 6f6c 2069 7420 6d69 other tool it mi │ │ │ │ │ +00022480: 6768 7420 6d61 6b65 2073 656e 7365 2074 ght make sense t │ │ │ │ │ +00022490: 6f20 7265 6e61 6d65 2074 6865 2064 6972 o rename the dir │ │ │ │ │ +000224a0: 6563 746f 7279 2c20 6275 7420 7375 7070 ectory, but supp │ │ │ │ │ +000224b0: 6f72 7469 6e67 0a27 2f75 7372 2f73 6861 orting.'/usr/sha │ │ │ │ │ +000224c0: 7265 2f61 636c 6f63 616c 2f27 2066 6f72 re/aclocal/' for │ │ │ │ │ +000224d0: 2062 6163 6b77 6172 6420 636f 6d70 6174 backward compat │ │ │ │ │ +000224e0: 6962 696c 6974 7920 7368 6f75 6c64 2062 ibility should b │ │ │ │ │ +000224f0: 6520 7265 616c 6c79 2065 6173 790a 7072 e really easy.pr │ │ │ │ │ +00022500: 6f76 6964 6564 2061 6c6c 206d 6163 726f ovided all macro │ │ │ │ │ +00022510: 7320 6172 6520 7072 6f70 6572 6c79 2077 s are properly w │ │ │ │ │ +00022520: 7269 7474 656e 2028 2a6e 6f74 6520 4578 ritten (*note Ex │ │ │ │ │ +00022530: 7465 6e64 696e 6720 6163 6c6f 6361 6c3a tending aclocal: │ │ │ │ │ +00022540: 3a29 2e0a 0a1f 0a46 696c 653a 2061 7574 :).....File: aut │ │ │ │ │ +00022550: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +00022560: 2020 4e6f 6465 3a20 4d61 6372 6f73 2c20 Node: Macros, │ │ │ │ │ +00022570: 2050 7265 763a 2061 636c 6f63 616c 2049 Prev: aclocal I │ │ │ │ │ +00022580: 6e76 6f63 6174 696f 6e2c 2020 5570 3a20 nvocation, Up: │ │ │ │ │ +00022590: 636f 6e66 6967 7572 650a 0a36 2e34 2041 configure..6.4 A │ │ │ │ │ +000225a0: 7574 6f63 6f6e 6620 6d61 6372 6f73 2073 utoconf macros s │ │ │ │ │ +000225b0: 7570 706c 6965 6420 7769 7468 2041 7574 upplied with Aut │ │ │ │ │ +000225c0: 6f6d 616b 650a 3d3d 3d3d 3d3d 3d3d 3d3d omake.========== │ │ │ │ │ 000225d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000225e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -000225f0: 4175 746f 6d61 6b65 2073 6869 7073 2077 Automake ships w │ │ │ │ │ -00022600: 6974 6820 7365 7665 7261 6c20 4175 746f ith several Auto │ │ │ │ │ -00022610: 636f 6e66 206d 6163 726f 7320 7468 6174 conf macros that │ │ │ │ │ -00022620: 2079 6f75 2063 616e 2075 7365 2066 726f you can use fro │ │ │ │ │ -00022630: 6d20 796f 7572 0a27 636f 6e66 6967 7572 m your.'configur │ │ │ │ │ -00022640: 652e 6163 272e 2020 5768 656e 2079 6f75 e.ac'. When you │ │ │ │ │ -00022650: 2075 7365 206f 6e65 206f 6620 7468 656d use one of them │ │ │ │ │ -00022660: 2069 7420 7769 6c6c 2062 6520 696e 636c it will be incl │ │ │ │ │ -00022670: 7564 6564 2062 790a 2761 636c 6f63 616c uded by.'aclocal │ │ │ │ │ -00022680: 2720 696e 2027 6163 6c6f 6361 6c2e 6d34 ' in 'aclocal.m4 │ │ │ │ │ -00022690: 272e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2050 '...* Menu:..* P │ │ │ │ │ -000226a0: 7562 6c69 6320 4d61 6372 6f73 3a3a 2020 ublic Macros:: │ │ │ │ │ -000226b0: 2020 2020 2020 2020 2020 2020 204d 6163 Mac │ │ │ │ │ -000226c0: 726f 7320 7468 6174 2079 6f75 2063 616e ros that you can │ │ │ │ │ -000226d0: 2075 7365 2e0a 2a20 4f62 736f 6c65 7465 use..* Obsolete │ │ │ │ │ -000226e0: 204d 6163 726f 733a 3a20 2020 2020 2020 Macros:: │ │ │ │ │ -000226f0: 2020 2020 2020 4d61 6372 6f73 2074 6861 Macros tha │ │ │ │ │ -00022700: 7420 796f 7520 7368 6f75 6c64 2073 746f t you should sto │ │ │ │ │ -00022710: 7020 7573 696e 672e 0a2a 2050 7269 7661 p using..* Priva │ │ │ │ │ -00022720: 7465 204d 6163 726f 733a 3a20 2020 2020 te Macros:: │ │ │ │ │ -00022730: 2020 2020 2020 2020 204d 6163 726f 7320 Macros │ │ │ │ │ -00022740: 7468 6174 2079 6f75 2073 686f 756c 6420 that you should │ │ │ │ │ -00022750: 6e6f 7420 7573 652e 0a0a 1f0a 4669 6c65 not use.....File │ │ │ │ │ -00022760: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -00022770: 696e 666f 2c20 204e 6f64 653a 2050 7562 info, Node: Pub │ │ │ │ │ -00022780: 6c69 6320 4d61 6372 6f73 2c20 204e 6578 lic Macros, Nex │ │ │ │ │ -00022790: 743a 204f 6273 6f6c 6574 6520 4d61 6372 t: Obsolete Macr │ │ │ │ │ -000227a0: 6f73 2c20 2055 703a 204d 6163 726f 730a os, Up: Macros. │ │ │ │ │ -000227b0: 0a36 2e34 2e31 2050 7562 6c69 6320 4d61 .6.4.1 Public Ma │ │ │ │ │ -000227c0: 6372 6f73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d cros.----------- │ │ │ │ │ -000227d0: 2d2d 2d2d 2d2d 2d2d 0a0a 2741 4d5f 454e --------..'AM_EN │ │ │ │ │ -000227e0: 4142 4c45 5f4d 554c 5449 4c49 4227 0a0a ABLE_MULTILIB'.. │ │ │ │ │ -000227f0: 2020 2020 2054 6869 7320 6973 2075 7365 This is use │ │ │ │ │ -00022800: 6420 7768 656e 2061 2022 6d75 6c74 696c d when a "multil │ │ │ │ │ -00022810: 6962 2220 6c69 6272 6172 7920 6973 2062 ib" library is b │ │ │ │ │ -00022820: 6569 6e67 2062 7569 6c74 2e20 2050 6c65 eing built. Ple │ │ │ │ │ -00022830: 6173 6520 6265 0a20 2020 2020 6177 6172 ase be. awar │ │ │ │ │ -00022840: 6520 7468 6174 206d 756c 7469 6c69 6220 e that multilib │ │ │ │ │ -00022850: 7375 7070 6f72 7420 5f77 696c 6c20 6265 support _will be │ │ │ │ │ -00022860: 2072 656d 6f76 6564 5f20 6672 6f6d 2074 removed_ from t │ │ │ │ │ -00022870: 6865 2041 7574 6f6d 616b 650a 2020 2020 he Automake. │ │ │ │ │ -00022880: 2063 6f72 6520 696e 2074 6865 206e 6578 core in the nex │ │ │ │ │ -00022890: 7420 6d61 6a6f 7220 7265 6c65 6173 652c t major release, │ │ │ │ │ -000228a0: 2061 6e64 2074 6865 6e20 5f74 6869 7320 and then _this │ │ │ │ │ -000228b0: 6d61 6372 6f20 7769 6c6c 2067 6f20 6177 macro will go aw │ │ │ │ │ -000228c0: 6179 0a20 2020 2020 6173 2077 656c 6c5f ay. as well_ │ │ │ │ │ -000228d0: 2028 6576 656e 2069 6620 6120 2266 726f (even if a "fro │ │ │ │ │ -000228e0: 7a65 6e22 2076 6572 7369 6f6e 206f 6620 zen" version of │ │ │ │ │ -000228f0: 7769 6c6c 2072 656d 6169 6e20 6176 6169 will remain avai │ │ │ │ │ -00022900: 6c61 626c 6520 696e 0a20 2020 2020 7468 lable in. th │ │ │ │ │ -00022910: 6520 2763 6f6e 7472 6962 2f27 2064 6972 e 'contrib/' dir │ │ │ │ │ -00022920: 6563 746f 7279 206f 6620 7468 6520 4175 ectory of the Au │ │ │ │ │ -00022930: 746f 6d61 6b65 2064 6973 7472 6962 7574 tomake distribut │ │ │ │ │ -00022940: 696f 6e29 2e0a 0a20 2020 2020 5468 6520 ion)... The │ │ │ │ │ -00022950: 6669 7273 7420 6f70 7469 6f6e 616c 2061 first optional a │ │ │ │ │ -00022960: 7267 756d 656e 7420 6973 2074 6865 206e rgument is the n │ │ │ │ │ -00022970: 616d 6520 6f66 2074 6865 2027 4d61 6b65 ame of the 'Make │ │ │ │ │ -00022980: 6669 6c65 2720 6265 696e 670a 2020 2020 file' being. │ │ │ │ │ -00022990: 2067 656e 6572 6174 6564 3b20 6974 2064 generated; it d │ │ │ │ │ -000229a0: 6566 6175 6c74 7320 746f 2027 4d61 6b65 efaults to 'Make │ │ │ │ │ -000229b0: 6669 6c65 272e 2020 5468 6520 7365 636f file'. The seco │ │ │ │ │ -000229c0: 6e64 206f 7074 696f 6e61 6c20 6172 6775 nd optional argu │ │ │ │ │ -000229d0: 6d65 6e74 0a20 2020 2020 6973 2075 7365 ment. is use │ │ │ │ │ -000229e0: 6420 746f 2066 696e 6420 7468 6520 746f d to find the to │ │ │ │ │ -000229f0: 7020 736f 7572 6365 2064 6972 6563 746f p source directo │ │ │ │ │ -00022a00: 7279 3b20 6974 2064 6566 6175 6c74 7320 ry; it defaults │ │ │ │ │ -00022a10: 746f 2074 6865 2065 6d70 7479 0a20 2020 to the empty. │ │ │ │ │ -00022a20: 2020 7374 7269 6e67 2028 6765 6e65 7261 string (genera │ │ │ │ │ -00022a30: 6c6c 7920 7468 6973 2073 686f 756c 6420 lly this should │ │ │ │ │ -00022a40: 6e6f 7420 6265 2075 7365 6420 756e 6c65 not be used unle │ │ │ │ │ -00022a50: 7373 2079 6f75 2061 7265 2066 616d 696c ss you are famil │ │ │ │ │ -00022a60: 6961 720a 2020 2020 2077 6974 6820 7468 iar. with th │ │ │ │ │ -00022a70: 6520 696e 7465 726e 616c 7329 2e20 202a e internals). * │ │ │ │ │ -00022a80: 4e6f 7465 204d 756c 7469 6c69 6273 3a3a Note Multilibs:: │ │ │ │ │ -00022a90: 2e0a 0a27 414d 5f49 4e49 545f 4155 544f ...'AM_INIT_AUTO │ │ │ │ │ -00022aa0: 4d41 4b45 285b 4f50 5449 4f4e 535d 2927 MAKE([OPTIONS])' │ │ │ │ │ -00022ab0: 0a27 414d 5f49 4e49 545f 4155 544f 4d41 .'AM_INIT_AUTOMA │ │ │ │ │ -00022ac0: 4b45 2850 4143 4b41 4745 2c20 5645 5253 KE(PACKAGE, VERS │ │ │ │ │ -00022ad0: 494f 4e2c 205b 4e4f 2d44 4546 494e 455d ION, [NO-DEFINE] │ │ │ │ │ -00022ae0: 2927 0a20 2020 2020 5275 6e73 206d 616e )'. Runs man │ │ │ │ │ -00022af0: 7920 6d61 6372 6f73 2072 6571 7569 7265 y macros require │ │ │ │ │ -00022b00: 6420 666f 7220 7072 6f70 6572 206f 7065 d for proper ope │ │ │ │ │ -00022b10: 7261 7469 6f6e 206f 6620 7468 6520 6765 ration of the ge │ │ │ │ │ -00022b20: 6e65 7261 7465 640a 2020 2020 204d 616b nerated. Mak │ │ │ │ │ -00022b30: 6566 696c 6573 2e0a 0a20 2020 2020 5468 efiles... Th │ │ │ │ │ -00022b40: 6973 206d 6163 726f 2068 6173 2074 776f is macro has two │ │ │ │ │ -00022b50: 2066 6f72 6d73 2c20 7468 6520 6669 7273 forms, the firs │ │ │ │ │ -00022b60: 7420 6f66 2077 6869 6368 2069 7320 7072 t of which is pr │ │ │ │ │ -00022b70: 6566 6572 7265 642e 2020 496e 2074 6869 eferred. In thi │ │ │ │ │ -00022b80: 730a 2020 2020 2066 6f72 6d2c 2027 414d s. form, 'AM │ │ │ │ │ -00022b90: 5f49 4e49 545f 4155 544f 4d41 4b45 2720 _INIT_AUTOMAKE' │ │ │ │ │ -00022ba0: 6973 2063 616c 6c65 6420 7769 7468 2061 is called with a │ │ │ │ │ -00022bb0: 2073 696e 676c 6520 6172 6775 6d65 6e74 single argument │ │ │ │ │ -00022bc0: 3a20 610a 2020 2020 2073 7061 6365 2d73 : a. space-s │ │ │ │ │ -00022bd0: 6570 6172 6174 6564 206c 6973 7420 6f66 eparated list of │ │ │ │ │ -00022be0: 2041 7574 6f6d 616b 6520 6f70 7469 6f6e Automake option │ │ │ │ │ -00022bf0: 7320 7468 6174 2073 686f 756c 6420 6265 s that should be │ │ │ │ │ -00022c00: 2061 7070 6c69 6564 2074 6f0a 2020 2020 applied to. │ │ │ │ │ -00022c10: 2065 7665 7279 2027 4d61 6b65 6669 6c65 every 'Makefile │ │ │ │ │ -00022c20: 2e61 6d27 2069 6e20 7468 6520 7472 6565 .am' in the tree │ │ │ │ │ -00022c30: 2e20 2054 6865 2065 6666 6563 7420 6973 . The effect is │ │ │ │ │ -00022c40: 2061 7320 6966 2065 6163 6820 6f70 7469 as if each opti │ │ │ │ │ -00022c50: 6f6e 0a20 2020 2020 7765 7265 206c 6973 on. were lis │ │ │ │ │ -00022c60: 7465 6420 696e 2027 4155 544f 4d41 4b45 ted in 'AUTOMAKE │ │ │ │ │ -00022c70: 5f4f 5054 494f 4e53 2720 282a 6e6f 7465 _OPTIONS' (*note │ │ │ │ │ -00022c80: 204f 7074 696f 6e73 3a3a 292e 0a0a 2020 Options::)... │ │ │ │ │ -00022c90: 2020 2054 6865 2073 6563 6f6e 642c 2064 The second, d │ │ │ │ │ -00022ca0: 6570 7265 6361 7465 642c 2066 6f72 6d20 eprecated, form │ │ │ │ │ -00022cb0: 6f66 2027 414d 5f49 4e49 545f 4155 544f of 'AM_INIT_AUTO │ │ │ │ │ -00022cc0: 4d41 4b45 2720 6861 7320 7477 6f20 7265 MAKE' has two re │ │ │ │ │ -00022cd0: 7175 6972 6564 0a20 2020 2020 6172 6775 quired. argu │ │ │ │ │ -00022ce0: 6d65 6e74 733a 2074 6865 2070 6163 6b61 ments: the packa │ │ │ │ │ -00022cf0: 6765 2061 6e64 2074 6865 2076 6572 7369 ge and the versi │ │ │ │ │ -00022d00: 6f6e 206e 756d 6265 722e 2020 5468 6973 on number. This │ │ │ │ │ -00022d10: 2066 6f72 6d20 6973 0a20 2020 2020 6f62 form is. ob │ │ │ │ │ -00022d20: 736f 6c65 7465 2062 6563 6175 7365 2074 solete because t │ │ │ │ │ -00022d30: 6865 2050 4143 4b41 4745 2061 6e64 2056 he PACKAGE and V │ │ │ │ │ -00022d40: 4552 5349 4f4e 2063 616e 2062 6520 6f62 ERSION can be ob │ │ │ │ │ -00022d50: 7461 696e 6564 2066 726f 6d0a 2020 2020 tained from. │ │ │ │ │ -00022d60: 2041 7574 6f63 6f6e 6627 7320 2741 435f Autoconf's 'AC_ │ │ │ │ │ -00022d70: 494e 4954 2720 6d61 6372 6f20 2877 6869 INIT' macro (whi │ │ │ │ │ -00022d80: 6368 2069 7473 656c 6620 6861 7320 616e ch itself has an │ │ │ │ │ -00022d90: 206f 6c64 2061 6e64 2061 206e 6577 0a20 old and a new. │ │ │ │ │ -00022da0: 2020 2020 666f 726d 292e 0a0a 2020 2020 form)... │ │ │ │ │ -00022db0: 2049 6620 796f 7572 2027 636f 6e66 6967 If your 'config │ │ │ │ │ -00022dc0: 7572 652e 6163 2720 6861 733a 0a0a 2020 ure.ac' has:.. │ │ │ │ │ -00022dd0: 2020 2020 2020 2020 4143 5f49 4e49 5428 AC_INIT( │ │ │ │ │ -00022de0: 5b73 7263 2f66 6f6f 2e63 5d29 0a20 2020 [src/foo.c]). │ │ │ │ │ -00022df0: 2020 2020 2020 2041 4d5f 494e 4954 5f41 AM_INIT_A │ │ │ │ │ -00022e00: 5554 4f4d 414b 4528 5b6d 756d 626c 655d UTOMAKE([mumble] │ │ │ │ │ -00022e10: 2c20 5b31 2e35 5d29 0a0a 2020 2020 2079 , [1.5]).. y │ │ │ │ │ -00022e20: 6f75 2063 616e 206d 6f64 6572 6e69 7a65 ou can modernize │ │ │ │ │ -00022e30: 2069 7420 6173 2066 6f6c 6c6f 7773 3a0a it as follows:. │ │ │ │ │ -00022e40: 0a20 2020 2020 2020 2020 2041 435f 494e . AC_IN │ │ │ │ │ -00022e50: 4954 285b 6d75 6d62 6c65 5d2c 205b 312e IT([mumble], [1. │ │ │ │ │ -00022e60: 355d 290a 2020 2020 2020 2020 2020 4143 5]). AC │ │ │ │ │ -00022e70: 5f43 4f4e 4649 475f 5352 4344 4952 285b _CONFIG_SRCDIR([ │ │ │ │ │ -00022e80: 7372 632f 666f 6f2e 635d 290a 2020 2020 src/foo.c]). │ │ │ │ │ -00022e90: 2020 2020 2020 414d 5f49 4e49 545f 4155 AM_INIT_AU │ │ │ │ │ -00022ea0: 544f 4d41 4b45 0a0a 2020 2020 204e 6f74 TOMAKE.. Not │ │ │ │ │ -00022eb0: 6520 7468 6174 2069 6620 796f 7527 7265 e that if you're │ │ │ │ │ -00022ec0: 2075 7067 7261 6469 6e67 2079 6f75 7220 upgrading your │ │ │ │ │ -00022ed0: 2763 6f6e 6669 6775 7265 2e61 6327 2066 'configure.ac' f │ │ │ │ │ -00022ee0: 726f 6d20 616e 2065 6172 6c69 6572 0a20 rom an earlier. │ │ │ │ │ -00022ef0: 2020 2020 7665 7273 696f 6e20 6f66 2041 version of A │ │ │ │ │ -00022f00: 7574 6f6d 616b 652c 2069 7420 6973 206e utomake, it is n │ │ │ │ │ -00022f10: 6f74 2061 6c77 6179 7320 636f 7272 6563 ot always correc │ │ │ │ │ -00022f20: 7420 746f 2073 696d 706c 7920 6d6f 7665 t to simply move │ │ │ │ │ -00022f30: 2074 6865 0a20 2020 2020 7061 636b 6167 the. packag │ │ │ │ │ -00022f40: 6520 616e 6420 7665 7273 696f 6e20 6172 e and version ar │ │ │ │ │ -00022f50: 6775 6d65 6e74 7320 6672 6f6d 2027 414d guments from 'AM │ │ │ │ │ -00022f60: 5f49 4e49 545f 4155 544f 4d41 4b45 2720 _INIT_AUTOMAKE' │ │ │ │ │ -00022f70: 6469 7265 6374 6c79 2074 6f0a 2020 2020 directly to. │ │ │ │ │ -00022f80: 2027 4143 5f49 4e49 5427 2c20 6173 2069 'AC_INIT', as i │ │ │ │ │ -00022f90: 6e20 7468 6520 6578 616d 706c 6520 6162 n the example ab │ │ │ │ │ -00022fa0: 6f76 652e 2020 5468 6520 6669 7273 7420 ove. The first │ │ │ │ │ -00022fb0: 6172 6775 6d65 6e74 2074 6f0a 2020 2020 argument to. │ │ │ │ │ -00022fc0: 2027 4143 5f49 4e49 5427 2073 686f 756c 'AC_INIT' shoul │ │ │ │ │ -00022fd0: 6420 6265 2074 6865 206e 616d 6520 6f66 d be the name of │ │ │ │ │ -00022fe0: 2079 6f75 7220 7061 636b 6167 6520 2865 your package (e │ │ │ │ │ -00022ff0: 2e67 2e2c 2027 474e 550a 2020 2020 2041 .g., 'GNU. A │ │ │ │ │ -00023000: 7574 6f6d 616b 6527 292c 206e 6f74 2074 utomake'), not t │ │ │ │ │ -00023010: 6865 2074 6172 6261 6c6c 206e 616d 6520 he tarball name │ │ │ │ │ -00023020: 2865 2e67 2e2c 2027 6175 746f 6d61 6b65 (e.g., 'automake │ │ │ │ │ -00023030: 2729 2074 6861 7420 796f 7520 7573 6564 ') that you used │ │ │ │ │ -00023040: 0a20 2020 2020 746f 2070 6173 7320 746f . to pass to │ │ │ │ │ -00023050: 2027 414d 5f49 4e49 545f 4155 544f 4d41 'AM_INIT_AUTOMA │ │ │ │ │ -00023060: 4b45 272e 2020 4175 746f 636f 6e66 2074 KE'. Autoconf t │ │ │ │ │ -00023070: 7269 6573 2074 6f20 6465 7269 7665 2061 ries to derive a │ │ │ │ │ -00023080: 2074 6172 6261 6c6c 0a20 2020 2020 6e61 tarball. na │ │ │ │ │ -00023090: 6d65 2066 726f 6d20 7468 6520 7061 636b me from the pack │ │ │ │ │ -000230a0: 6167 6520 6e61 6d65 2c20 7768 6963 6820 age name, which │ │ │ │ │ -000230b0: 7368 6f75 6c64 2077 6f72 6b20 666f 7220 should work for │ │ │ │ │ -000230c0: 6d6f 7374 2062 7574 206e 6f74 2061 6c6c most but not all │ │ │ │ │ -000230d0: 0a20 2020 2020 7061 636b 6167 6520 6e61 . package na │ │ │ │ │ -000230e0: 6d65 732e 2020 2849 6620 6974 2064 6f65 mes. (If it doe │ │ │ │ │ -000230f0: 736e 2774 2077 6f72 6b20 666f 7220 796f sn't work for yo │ │ │ │ │ -00023100: 7572 732c 2079 6f75 2063 616e 2075 7365 urs, you can use │ │ │ │ │ -00023110: 2074 6865 0a20 2020 2020 666f 7572 2d61 the. four-a │ │ │ │ │ -00023120: 7267 756d 656e 7420 666f 726d 206f 6620 rgument form of │ │ │ │ │ -00023130: 2741 435f 494e 4954 2720 746f 2070 726f 'AC_INIT' to pro │ │ │ │ │ -00023140: 7669 6465 2074 6865 2074 6172 6261 6c6c vide the tarball │ │ │ │ │ -00023150: 206e 616d 650a 2020 2020 2065 7870 6c69 name. expli │ │ │ │ │ -00023160: 6369 746c 7929 2e0a 0a20 2020 2020 4279 citly)... By │ │ │ │ │ -00023170: 2064 6566 6175 6c74 2074 6869 7320 6d61 default this ma │ │ │ │ │ -00023180: 6372 6f20 2741 435f 4445 4649 4e45 2727 cro 'AC_DEFINE'' │ │ │ │ │ -00023190: 7320 2750 4143 4b41 4745 2720 616e 6420 s 'PACKAGE' and │ │ │ │ │ -000231a0: 2756 4552 5349 4f4e 272e 2020 5468 6973 'VERSION'. This │ │ │ │ │ -000231b0: 0a20 2020 2020 6361 6e20 6265 2061 766f . can be avo │ │ │ │ │ -000231c0: 6964 6564 2062 7920 7061 7373 696e 6720 ided by passing │ │ │ │ │ -000231d0: 7468 6520 276e 6f2d 6465 6669 6e65 2720 the 'no-define' │ │ │ │ │ -000231e0: 6f70 7469 6f6e 2c20 6173 2069 6e3a 0a20 option, as in:. │ │ │ │ │ -000231f0: 2020 2020 2020 2020 2041 4d5f 494e 4954 AM_INIT │ │ │ │ │ -00023200: 5f41 5554 4f4d 414b 4528 5b67 6e69 7473 _AUTOMAKE([gnits │ │ │ │ │ -00023210: 2031 2e35 206e 6f2d 6465 6669 6e65 2064 1.5 no-define d │ │ │ │ │ -00023220: 6973 742d 627a 6970 325d 290a 2020 2020 ist-bzip2]). │ │ │ │ │ -00023230: 206f 7220 6279 2070 6173 7369 6e67 2061 or by passing a │ │ │ │ │ -00023240: 2074 6869 7264 206e 6f6e 2d65 6d70 7479 third non-empty │ │ │ │ │ -00023250: 2061 7267 756d 656e 7420 746f 2074 6865 argument to the │ │ │ │ │ -00023260: 206f 6273 6f6c 6574 6520 666f 726d 2e0a obsolete form.. │ │ │ │ │ -00023270: 0a27 414d 5f50 4154 485f 4c49 5350 4449 .'AM_PATH_LISPDI │ │ │ │ │ -00023280: 5227 0a20 2020 2020 5365 6172 6368 6573 R'. Searches │ │ │ │ │ -00023290: 2066 6f72 2074 6865 2070 726f 6772 616d for the program │ │ │ │ │ -000232a0: 2027 656d 6163 7327 2c20 616e 642c 2069 'emacs', and, i │ │ │ │ │ -000232b0: 6620 666f 756e 642c 2073 6574 7320 7468 f found, sets th │ │ │ │ │ -000232c0: 6520 6f75 7470 7574 0a20 2020 2020 7661 e output. va │ │ │ │ │ -000232d0: 7269 6162 6c65 2027 6c69 7370 6469 7227 riable 'lispdir' │ │ │ │ │ -000232e0: 2074 6f20 7468 6520 6675 6c6c 2070 6174 to the full pat │ │ │ │ │ -000232f0: 6820 746f 2045 6d61 6373 2720 7369 7465 h to Emacs' site │ │ │ │ │ -00023300: 2d6c 6973 7020 6469 7265 6374 6f72 792e -lisp directory. │ │ │ │ │ -00023310: 0a0a 2020 2020 204e 6f74 6520 7468 6174 .. Note that │ │ │ │ │ -00023320: 2074 6869 7320 7465 7374 2061 7373 756d this test assum │ │ │ │ │ -00023330: 6573 2074 6865 2027 656d 6163 7327 2066 es the 'emacs' f │ │ │ │ │ -00023340: 6f75 6e64 2074 6f20 6265 2061 2076 6572 ound to be a ver │ │ │ │ │ -00023350: 7369 6f6e 2074 6861 740a 2020 2020 2073 sion that. s │ │ │ │ │ -00023360: 7570 706f 7274 7320 456d 6163 7320 4c69 upports Emacs Li │ │ │ │ │ -00023370: 7370 2028 7375 6368 2061 7320 474e 5520 sp (such as GNU │ │ │ │ │ -00023380: 456d 6163 7320 6f72 2058 456d 6163 7329 Emacs or XEmacs) │ │ │ │ │ -00023390: 2e20 204f 7468 6572 2065 6d61 6373 656e . Other emacsen │ │ │ │ │ -000233a0: 0a20 2020 2020 6361 6e20 6361 7573 6520 . can cause │ │ │ │ │ -000233b0: 7468 6973 2074 6573 7420 746f 2068 616e this test to han │ │ │ │ │ -000233c0: 6720 2873 6f6d 652c 206c 696b 6520 6f6c g (some, like ol │ │ │ │ │ -000233d0: 6420 7665 7273 696f 6e73 206f 6620 4d69 d versions of Mi │ │ │ │ │ -000233e0: 6372 6f45 6d61 6373 2c0a 2020 2020 2073 croEmacs,. s │ │ │ │ │ -000233f0: 7461 7274 2075 7020 696e 2069 6e74 6572 tart up in inter │ │ │ │ │ -00023400: 6163 7469 7665 206d 6f64 652c 2072 6571 active mode, req │ │ │ │ │ -00023410: 7569 7269 6e67 2027 432d 7820 432d 6327 uiring 'C-x C-c' │ │ │ │ │ -00023420: 2074 6f20 6578 6974 2c20 7768 6963 6820 to exit, which │ │ │ │ │ -00023430: 6973 0a20 2020 2020 6861 7264 6c79 206f is. hardly o │ │ │ │ │ -00023440: 6276 696f 7573 2066 6f72 2061 206e 6f6e bvious for a non │ │ │ │ │ -00023450: 2d65 6d61 6373 2075 7365 7229 2e20 2049 -emacs user). I │ │ │ │ │ -00023460: 6e20 6d6f 7374 2063 6173 6573 2c20 686f n most cases, ho │ │ │ │ │ -00023470: 7765 7665 722c 2079 6f75 0a20 2020 2020 wever, you. │ │ │ │ │ -00023480: 7368 6f75 6c64 2062 6520 6162 6c65 2074 should be able t │ │ │ │ │ -00023490: 6f20 7573 6520 2743 2d63 2720 746f 206b o use 'C-c' to k │ │ │ │ │ -000234a0: 696c 6c20 7468 6520 7465 7374 2e20 2049 ill the test. I │ │ │ │ │ -000234b0: 6e20 6f72 6465 7220 746f 2061 766f 6964 n order to avoid │ │ │ │ │ -000234c0: 0a20 2020 2020 7072 6f62 6c65 6d73 2c20 . problems, │ │ │ │ │ -000234d0: 796f 7520 6361 6e20 7365 7420 2745 4d41 you can set 'EMA │ │ │ │ │ -000234e0: 4353 2720 746f 2022 6e6f 2220 696e 2074 CS' to "no" in t │ │ │ │ │ -000234f0: 6865 2065 6e76 6972 6f6e 6d65 6e74 2c20 he environment, │ │ │ │ │ -00023500: 6f72 2075 7365 0a20 2020 2020 7468 6520 or use. the │ │ │ │ │ -00023510: 272d 2d77 6974 682d 6c69 7370 6469 7227 '--with-lispdir' │ │ │ │ │ -00023520: 206f 7074 696f 6e20 746f 2027 636f 6e66 option to 'conf │ │ │ │ │ -00023530: 6967 7572 6527 2074 6f20 6578 706c 6963 igure' to explic │ │ │ │ │ -00023540: 6974 6c79 2073 6574 2074 6865 0a20 2020 itly set the. │ │ │ │ │ -00023550: 2020 636f 7272 6563 7420 7061 7468 2028 correct path ( │ │ │ │ │ -00023560: 6966 2079 6f75 2772 6520 7375 7265 2079 if you're sure y │ │ │ │ │ -00023570: 6f75 2068 6176 6520 616e 2027 656d 6163 ou have an 'emac │ │ │ │ │ -00023580: 7327 2074 6861 7420 7375 7070 6f72 7473 s' that supports │ │ │ │ │ -00023590: 0a20 2020 2020 456d 6163 7320 4c69 7370 . Emacs Lisp │ │ │ │ │ -000235a0: 292e 0a0a 2741 4d5f 5052 4f47 5f41 5228 )...'AM_PROG_AR( │ │ │ │ │ -000235b0: 5b41 4354 2d49 462d 4641 494c 5d29 270a [ACT-IF-FAIL])'. │ │ │ │ │ -000235c0: 2020 2020 2059 6f75 206d 7573 7420 7573 You must us │ │ │ │ │ -000235d0: 6520 7468 6973 206d 6163 726f 2077 6865 e this macro whe │ │ │ │ │ -000235e0: 6e20 796f 7520 7573 6520 7468 6520 6172 n you use the ar │ │ │ │ │ -000235f0: 6368 6976 6572 2069 6e20 796f 7572 2070 chiver in your p │ │ │ │ │ -00023600: 726f 6a65 6374 2c0a 2020 2020 2069 6620 roject,. if │ │ │ │ │ -00023610: 796f 7520 7761 6e74 2073 7570 706f 7274 you want support │ │ │ │ │ -00023620: 2066 6f72 2075 6e75 7375 616c 2061 7263 for unusual arc │ │ │ │ │ -00023630: 6869 7665 7273 2073 7563 6820 6173 204d hivers such as M │ │ │ │ │ -00023640: 6963 726f 736f 6674 2027 6c69 6227 2e0a icrosoft 'lib'.. │ │ │ │ │ -00023650: 2020 2020 2054 6865 2063 6f6e 7465 6e74 The content │ │ │ │ │ -00023660: 206f 6620 7468 6520 6f70 7469 6f6e 616c of the optional │ │ │ │ │ -00023670: 2061 7267 756d 656e 7420 6973 2065 7865 argument is exe │ │ │ │ │ -00023680: 6375 7465 6420 6966 2074 6865 2061 7263 cuted if the arc │ │ │ │ │ -00023690: 6869 7665 720a 2020 2020 2069 6e74 6572 hiver. inter │ │ │ │ │ -000236a0: 6661 6365 2069 7320 6e6f 7420 7265 636f face is not reco │ │ │ │ │ -000236b0: 676e 697a 6564 3b20 7468 6520 6465 6661 gnized; the defa │ │ │ │ │ -000236c0: 756c 7420 6163 7469 6f6e 2069 7320 746f ult action is to │ │ │ │ │ -000236d0: 2061 626f 7274 0a20 2020 2020 636f 6e66 abort. conf │ │ │ │ │ -000236e0: 6967 7572 6520 7769 7468 2061 6e20 6572 igure with an er │ │ │ │ │ -000236f0: 726f 7220 6d65 7373 6167 652e 0a0a 2741 ror message...'A │ │ │ │ │ -00023700: 4d5f 5052 4f47 5f41 5327 0a20 2020 2020 M_PROG_AS'. │ │ │ │ │ -00023710: 5573 6520 7468 6973 206d 6163 726f 2077 Use this macro w │ │ │ │ │ -00023720: 6865 6e20 796f 7520 6861 7665 2061 7373 hen you have ass │ │ │ │ │ -00023730: 656d 626c 7920 636f 6465 2069 6e20 796f embly code in yo │ │ │ │ │ -00023740: 7572 2070 726f 6a65 6374 2e20 2054 6869 ur project. Thi │ │ │ │ │ -00023750: 730a 2020 2020 2077 696c 6c20 6368 6f6f s. will choo │ │ │ │ │ -00023760: 7365 2074 6865 2061 7373 656d 626c 6572 se the assembler │ │ │ │ │ -00023770: 2066 6f72 2079 6f75 2028 6279 2064 6566 for you (by def │ │ │ │ │ -00023780: 6175 6c74 2074 6865 2043 2063 6f6d 7069 ault the C compi │ │ │ │ │ -00023790: 6c65 7229 2061 6e64 0a20 2020 2020 7365 ler) and. se │ │ │ │ │ -000237a0: 7420 2743 4341 5327 2c20 616e 6420 7769 t 'CCAS', and wi │ │ │ │ │ -000237b0: 6c6c 2061 6c73 6f20 7365 7420 2743 4341 ll also set 'CCA │ │ │ │ │ -000237c0: 5346 4c41 4753 2720 6966 2072 6571 7569 SFLAGS' if requi │ │ │ │ │ -000237d0: 7265 642e 0a0a 2741 4d5f 5052 4f47 5f43 red...'AM_PROG_C │ │ │ │ │ -000237e0: 435f 435f 4f27 0a20 2020 2020 5468 6973 C_C_O'. This │ │ │ │ │ -000237f0: 2069 7320 6c69 6b65 2027 4143 5f50 524f is like 'AC_PRO │ │ │ │ │ -00023800: 475f 4343 5f43 5f4f 272c 2062 7574 2069 G_CC_C_O', but i │ │ │ │ │ -00023810: 7420 6765 6e65 7261 7465 7320 6974 7320 t generates its │ │ │ │ │ -00023820: 7265 7375 6c74 7320 696e 2074 6865 0a20 results in the. │ │ │ │ │ -00023830: 2020 2020 6d61 6e6e 6572 2072 6571 7569 manner requi │ │ │ │ │ -00023840: 7265 6420 6279 2041 7574 6f6d 616b 652e red by Automake. │ │ │ │ │ -00023850: 2020 596f 7520 6d75 7374 2075 7365 2074 You must use t │ │ │ │ │ -00023860: 6869 7320 696e 7374 6561 6420 6f66 0a20 his instead of. │ │ │ │ │ -00023870: 2020 2020 2741 435f 5052 4f47 5f43 435f 'AC_PROG_CC_ │ │ │ │ │ -00023880: 435f 4f27 2077 6865 6e20 796f 7520 6e65 C_O' when you ne │ │ │ │ │ -00023890: 6564 2074 6869 7320 6675 6e63 7469 6f6e ed this function │ │ │ │ │ -000238a0: 616c 6974 792c 2074 6861 7420 6973 2c20 ality, that is, │ │ │ │ │ -000238b0: 7768 656e 0a20 2020 2020 7573 696e 6720 when. using │ │ │ │ │ -000238c0: 7065 722d 7461 7267 6574 2066 6c61 6773 per-target flags │ │ │ │ │ -000238d0: 206f 7220 7375 6264 6972 2d6f 626a 6563 or subdir-objec │ │ │ │ │ -000238e0: 7473 2077 6974 6820 4320 736f 7572 6365 ts with C source │ │ │ │ │ -000238f0: 732e 0a0a 2741 4d5f 5052 4f47 5f4c 4558 s...'AM_PROG_LEX │ │ │ │ │ -00023900: 270a 2020 2020 204c 696b 6520 2741 435f '. Like 'AC_ │ │ │ │ │ -00023910: 5052 4f47 5f4c 4558 2720 282a 6e6f 7465 PROG_LEX' (*note │ │ │ │ │ -00023920: 2050 6172 7469 6375 6c61 7220 5072 6f67 Particular Prog │ │ │ │ │ -00023930: 7261 6d20 4368 6563 6b73 3a0a 2020 2020 ram Checks:. │ │ │ │ │ -00023940: 2028 6175 746f 636f 6e66 2950 6172 7469 (autoconf)Parti │ │ │ │ │ -00023950: 6375 6c61 7220 5072 6f67 7261 6d73 2e29 cular Programs.) │ │ │ │ │ -00023960: 2c20 6275 7420 7573 6573 2074 6865 2027 , but uses the ' │ │ │ │ │ -00023970: 6d69 7373 696e 6727 2073 6372 6970 7420 missing' script │ │ │ │ │ -00023980: 6f6e 0a20 2020 2020 7379 7374 656d 7320 on. systems │ │ │ │ │ -00023990: 7468 6174 2064 6f20 6e6f 7420 6861 7665 that do not have │ │ │ │ │ -000239a0: 2027 6c65 7827 2e20 2048 502d 5558 2031 'lex'. HP-UX 1 │ │ │ │ │ -000239b0: 3020 6973 206f 6e65 2073 7563 6820 7379 0 is one such sy │ │ │ │ │ -000239c0: 7374 656d 2e0a 0a27 414d 5f50 524f 475f stem...'AM_PROG_ │ │ │ │ │ -000239d0: 4743 4a27 0a20 2020 2020 5468 6973 206d GCJ'. This m │ │ │ │ │ -000239e0: 6163 726f 2066 696e 6473 2074 6865 2027 acro finds the ' │ │ │ │ │ -000239f0: 6763 6a27 2070 726f 6772 616d 206f 7220 gcj' program or │ │ │ │ │ -00023a00: 6361 7573 6573 2061 6e20 6572 726f 722e causes an error. │ │ │ │ │ -00023a10: 2020 4974 2073 6574 730a 2020 2020 2027 It sets. ' │ │ │ │ │ -00023a20: 4743 4a27 2061 6e64 2027 4743 4a46 4c41 GCJ' and 'GCJFLA │ │ │ │ │ -00023a30: 4753 272e 2020 2767 636a 2720 6973 2074 GS'. 'gcj' is t │ │ │ │ │ -00023a40: 6865 204a 6176 6120 6672 6f6e 742d 656e he Java front-en │ │ │ │ │ -00023a50: 6420 746f 2074 6865 2047 4e55 0a20 2020 d to the GNU. │ │ │ │ │ -00023a60: 2020 436f 6d70 696c 6572 2043 6f6c 6c65 Compiler Colle │ │ │ │ │ -00023a70: 6374 696f 6e2e 0a0a 2741 4d5f 5052 4f47 ction...'AM_PROG │ │ │ │ │ -00023a80: 5f55 5043 285b 434f 4d50 494c 4552 2d53 _UPC([COMPILER-S │ │ │ │ │ -00023a90: 4541 5243 482d 4c49 5354 5d29 270a 2020 EARCH-LIST])'. │ │ │ │ │ -00023aa0: 2020 2046 696e 6420 6120 636f 6d70 696c Find a compil │ │ │ │ │ -00023ab0: 6572 2066 6f72 2055 6e69 6669 6564 2050 er for Unified P │ │ │ │ │ -00023ac0: 6172 616c 6c65 6c20 4320 616e 6420 6465 arallel C and de │ │ │ │ │ -00023ad0: 6669 6e65 2074 6865 2027 5550 4327 0a20 fine the 'UPC'. │ │ │ │ │ -00023ae0: 2020 2020 7661 7269 6162 6c65 2e20 2054 variable. T │ │ │ │ │ -00023af0: 6865 2064 6566 6175 6c74 2043 4f4d 5049 he default COMPI │ │ │ │ │ -00023b00: 4c45 522d 5345 4152 4348 2d4c 4953 5420 LER-SEARCH-LIST │ │ │ │ │ -00023b10: 6973 2027 7570 6363 2075 7063 272e 2020 is 'upcc upc'. │ │ │ │ │ -00023b20: 5468 6973 0a20 2020 2020 6d61 6372 6f20 This. macro │ │ │ │ │ -00023b30: 7769 6c6c 2061 626f 7274 2027 636f 6e66 will abort 'conf │ │ │ │ │ -00023b40: 6967 7572 6527 2069 6620 6e6f 2055 6e69 igure' if no Uni │ │ │ │ │ -00023b50: 6669 6564 2050 6172 616c 6c65 6c20 4320 fied Parallel C │ │ │ │ │ -00023b60: 636f 6d70 696c 6572 2069 730a 2020 2020 compiler is. │ │ │ │ │ -00023b70: 2066 6f75 6e64 2e0a 0a27 414d 5f53 494c found...'AM_SIL │ │ │ │ │ -00023b80: 454e 545f 5255 4c45 5327 0a20 2020 2020 ENT_RULES'. │ │ │ │ │ -00023b90: 456e 6162 6c65 2074 6865 206d 6163 6869 Enable the machi │ │ │ │ │ -00023ba0: 6e65 7279 2066 6f72 206c 6573 7320 7665 nery for less ve │ │ │ │ │ -00023bb0: 7262 6f73 6520 6275 696c 6420 6f75 7470 rbose build outp │ │ │ │ │ -00023bc0: 7574 2028 2a6e 6f74 650a 2020 2020 204f ut (*note. O │ │ │ │ │ -00023bd0: 7074 696f 6e73 3a3a 292e 0a0a 2741 4d5f ptions::)...'AM_ │ │ │ │ │ -00023be0: 5749 5448 5f44 4d41 4c4c 4f43 270a 2020 WITH_DMALLOC'. │ │ │ │ │ -00023bf0: 2020 2041 6464 2073 7570 706f 7274 2066 Add support f │ │ │ │ │ -00023c00: 6f72 2074 6865 2044 6d61 6c6c 6f63 2070 or the Dmalloc p │ │ │ │ │ -00023c10: 6163 6b61 6765 2028 6874 7470 3a2f 2f64 ackage (http://d │ │ │ │ │ -00023c20: 6d61 6c6c 6f63 2e63 6f6d 2f29 2e20 2049 malloc.com/). I │ │ │ │ │ -00023c30: 6620 7468 650a 2020 2020 2075 7365 7220 f the. user │ │ │ │ │ -00023c40: 7275 6e73 2027 636f 6e66 6967 7572 6527 runs 'configure' │ │ │ │ │ -00023c50: 2077 6974 6820 272d 2d77 6974 682d 646d with '--with-dm │ │ │ │ │ -00023c60: 616c 6c6f 6327 2c20 7468 656e 2064 6566 alloc', then def │ │ │ │ │ -00023c70: 696e 650a 2020 2020 2027 5749 5448 5f44 ine. 'WITH_D │ │ │ │ │ -00023c80: 4d41 4c4c 4f43 2720 616e 6420 6164 6420 MALLOC' and add │ │ │ │ │ -00023c90: 272d 6c64 6d61 6c6c 6f63 2720 746f 2027 '-ldmalloc' to ' │ │ │ │ │ -00023ca0: 4c49 4253 272e 0a0a 1f0a 4669 6c65 3a20 LIBS'.....File: │ │ │ │ │ -00023cb0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -00023cc0: 666f 2c20 204e 6f64 653a 204f 6273 6f6c fo, Node: Obsol │ │ │ │ │ -00023cd0: 6574 6520 4d61 6372 6f73 2c20 204e 6578 ete Macros, Nex │ │ │ │ │ -00023ce0: 743a 2050 7269 7661 7465 204d 6163 726f t: Private Macro │ │ │ │ │ -00023cf0: 732c 2020 5072 6576 3a20 5075 626c 6963 s, Prev: Public │ │ │ │ │ -00023d00: 204d 6163 726f 732c 2020 5570 3a20 4d61 Macros, Up: Ma │ │ │ │ │ -00023d10: 6372 6f73 0a0a 362e 342e 3220 4f62 736f cros..6.4.2 Obso │ │ │ │ │ -00023d20: 6c65 7465 204d 6163 726f 730a 2d2d 2d2d lete Macros.---- │ │ │ │ │ +000225e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000225f0: 0a0a 4175 746f 6d61 6b65 2073 6869 7073 ..Automake ships │ │ │ │ │ +00022600: 2077 6974 6820 7365 7665 7261 6c20 4175 with several Au │ │ │ │ │ +00022610: 746f 636f 6e66 206d 6163 726f 7320 7468 toconf macros th │ │ │ │ │ +00022620: 6174 2079 6f75 2063 616e 2075 7365 2066 at you can use f │ │ │ │ │ +00022630: 726f 6d20 796f 7572 0a27 636f 6e66 6967 rom your.'config │ │ │ │ │ +00022640: 7572 652e 6163 272e 2020 5768 656e 2079 ure.ac'. When y │ │ │ │ │ +00022650: 6f75 2075 7365 206f 6e65 206f 6620 7468 ou use one of th │ │ │ │ │ +00022660: 656d 2069 7420 7769 6c6c 2062 6520 696e em it will be in │ │ │ │ │ +00022670: 636c 7564 6564 2062 790a 2761 636c 6f63 cluded by.'acloc │ │ │ │ │ +00022680: 616c 2720 696e 2027 6163 6c6f 6361 6c2e al' in 'aclocal. │ │ │ │ │ +00022690: 6d34 272e 0a0a 2a20 4d65 6e75 3a0a 0a2a m4'...* Menu:..* │ │ │ │ │ +000226a0: 2050 7562 6c69 6320 4d61 6372 6f73 3a3a Public Macros:: │ │ │ │ │ +000226b0: 2020 2020 2020 2020 2020 2020 2020 204d M │ │ │ │ │ +000226c0: 6163 726f 7320 7468 6174 2079 6f75 2063 acros that you c │ │ │ │ │ +000226d0: 616e 2075 7365 2e0a 2a20 4f62 736f 6c65 an use..* Obsole │ │ │ │ │ +000226e0: 7465 204d 6163 726f 733a 3a20 2020 2020 te Macros:: │ │ │ │ │ +000226f0: 2020 2020 2020 2020 4d61 6372 6f73 2074 Macros t │ │ │ │ │ +00022700: 6861 7420 796f 7520 7368 6f75 6c64 2073 hat you should s │ │ │ │ │ +00022710: 746f 7020 7573 696e 672e 0a2a 2050 7269 top using..* Pri │ │ │ │ │ +00022720: 7661 7465 204d 6163 726f 733a 3a20 2020 vate Macros:: │ │ │ │ │ +00022730: 2020 2020 2020 2020 2020 204d 6163 726f Macro │ │ │ │ │ +00022740: 7320 7468 6174 2079 6f75 2073 686f 756c s that you shoul │ │ │ │ │ +00022750: 6420 6e6f 7420 7573 652e 0a0a 1f0a 4669 d not use.....Fi │ │ │ │ │ +00022760: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +00022770: 312e 696e 666f 2c20 204e 6f64 653a 2050 1.info, Node: P │ │ │ │ │ +00022780: 7562 6c69 6320 4d61 6372 6f73 2c20 204e ublic Macros, N │ │ │ │ │ +00022790: 6578 743a 204f 6273 6f6c 6574 6520 4d61 ext: Obsolete Ma │ │ │ │ │ +000227a0: 6372 6f73 2c20 2055 703a 204d 6163 726f cros, Up: Macro │ │ │ │ │ +000227b0: 730a 0a36 2e34 2e31 2050 7562 6c69 6320 s..6.4.1 Public │ │ │ │ │ +000227c0: 4d61 6372 6f73 0a2d 2d2d 2d2d 2d2d 2d2d Macros.--------- │ │ │ │ │ +000227d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2741 4d5f ----------..'AM_ │ │ │ │ │ +000227e0: 454e 4142 4c45 5f4d 554c 5449 4c49 4227 ENABLE_MULTILIB' │ │ │ │ │ +000227f0: 0a0a 2020 2020 2054 6869 7320 6973 2075 .. This is u │ │ │ │ │ +00022800: 7365 6420 7768 656e 2061 2022 6d75 6c74 sed when a "mult │ │ │ │ │ +00022810: 696c 6962 2220 6c69 6272 6172 7920 6973 ilib" library is │ │ │ │ │ +00022820: 2062 6569 6e67 2062 7569 6c74 2e20 2050 being built. P │ │ │ │ │ +00022830: 6c65 6173 6520 6265 0a20 2020 2020 6177 lease be. aw │ │ │ │ │ +00022840: 6172 6520 7468 6174 206d 756c 7469 6c69 are that multili │ │ │ │ │ +00022850: 6220 7375 7070 6f72 7420 5f77 696c 6c20 b support _will │ │ │ │ │ +00022860: 6265 2072 656d 6f76 6564 5f20 6672 6f6d be removed_ from │ │ │ │ │ +00022870: 2074 6865 2041 7574 6f6d 616b 650a 2020 the Automake. │ │ │ │ │ +00022880: 2020 2063 6f72 6520 696e 2074 6865 206e core in the n │ │ │ │ │ +00022890: 6578 7420 6d61 6a6f 7220 7265 6c65 6173 ext major releas │ │ │ │ │ +000228a0: 652c 2061 6e64 2074 6865 6e20 5f74 6869 e, and then _thi │ │ │ │ │ +000228b0: 7320 6d61 6372 6f20 7769 6c6c 2067 6f20 s macro will go │ │ │ │ │ +000228c0: 6177 6179 0a20 2020 2020 6173 2077 656c away. as wel │ │ │ │ │ +000228d0: 6c5f 2028 6576 656e 2069 6620 6120 2266 l_ (even if a "f │ │ │ │ │ +000228e0: 726f 7a65 6e22 2076 6572 7369 6f6e 206f rozen" version o │ │ │ │ │ +000228f0: 6620 7769 6c6c 2072 656d 6169 6e20 6176 f will remain av │ │ │ │ │ +00022900: 6169 6c61 626c 6520 696e 0a20 2020 2020 ailable in. │ │ │ │ │ +00022910: 7468 6520 2763 6f6e 7472 6962 2f27 2064 the 'contrib/' d │ │ │ │ │ +00022920: 6972 6563 746f 7279 206f 6620 7468 6520 irectory of the │ │ │ │ │ +00022930: 4175 746f 6d61 6b65 2064 6973 7472 6962 Automake distrib │ │ │ │ │ +00022940: 7574 696f 6e29 2e0a 0a20 2020 2020 5468 ution)... Th │ │ │ │ │ +00022950: 6520 6669 7273 7420 6f70 7469 6f6e 616c e first optional │ │ │ │ │ +00022960: 2061 7267 756d 656e 7420 6973 2074 6865 argument is the │ │ │ │ │ +00022970: 206e 616d 6520 6f66 2074 6865 2027 4d61 name of the 'Ma │ │ │ │ │ +00022980: 6b65 6669 6c65 2720 6265 696e 670a 2020 kefile' being. │ │ │ │ │ +00022990: 2020 2067 656e 6572 6174 6564 3b20 6974 generated; it │ │ │ │ │ +000229a0: 2064 6566 6175 6c74 7320 746f 2027 4d61 defaults to 'Ma │ │ │ │ │ +000229b0: 6b65 6669 6c65 272e 2020 5468 6520 7365 kefile'. The se │ │ │ │ │ +000229c0: 636f 6e64 206f 7074 696f 6e61 6c20 6172 cond optional ar │ │ │ │ │ +000229d0: 6775 6d65 6e74 0a20 2020 2020 6973 2075 gument. is u │ │ │ │ │ +000229e0: 7365 6420 746f 2066 696e 6420 7468 6520 sed to find the │ │ │ │ │ +000229f0: 746f 7020 736f 7572 6365 2064 6972 6563 top source direc │ │ │ │ │ +00022a00: 746f 7279 3b20 6974 2064 6566 6175 6c74 tory; it default │ │ │ │ │ +00022a10: 7320 746f 2074 6865 2065 6d70 7479 0a20 s to the empty. │ │ │ │ │ +00022a20: 2020 2020 7374 7269 6e67 2028 6765 6e65 string (gene │ │ │ │ │ +00022a30: 7261 6c6c 7920 7468 6973 2073 686f 756c rally this shoul │ │ │ │ │ +00022a40: 6420 6e6f 7420 6265 2075 7365 6420 756e d not be used un │ │ │ │ │ +00022a50: 6c65 7373 2079 6f75 2061 7265 2066 616d less you are fam │ │ │ │ │ +00022a60: 696c 6961 720a 2020 2020 2077 6974 6820 iliar. with │ │ │ │ │ +00022a70: 7468 6520 696e 7465 726e 616c 7329 2e20 the internals). │ │ │ │ │ +00022a80: 202a 4e6f 7465 204d 756c 7469 6c69 6273 *Note Multilibs │ │ │ │ │ +00022a90: 3a3a 2e0a 0a27 414d 5f49 4e49 545f 4155 ::...'AM_INIT_AU │ │ │ │ │ +00022aa0: 544f 4d41 4b45 285b 4f50 5449 4f4e 535d TOMAKE([OPTIONS] │ │ │ │ │ +00022ab0: 2927 0a27 414d 5f49 4e49 545f 4155 544f )'.'AM_INIT_AUTO │ │ │ │ │ +00022ac0: 4d41 4b45 2850 4143 4b41 4745 2c20 5645 MAKE(PACKAGE, VE │ │ │ │ │ +00022ad0: 5253 494f 4e2c 205b 4e4f 2d44 4546 494e RSION, [NO-DEFIN │ │ │ │ │ +00022ae0: 455d 2927 0a20 2020 2020 5275 6e73 206d E])'. Runs m │ │ │ │ │ +00022af0: 616e 7920 6d61 6372 6f73 2072 6571 7569 any macros requi │ │ │ │ │ +00022b00: 7265 6420 666f 7220 7072 6f70 6572 206f red for proper o │ │ │ │ │ +00022b10: 7065 7261 7469 6f6e 206f 6620 7468 6520 peration of the │ │ │ │ │ +00022b20: 6765 6e65 7261 7465 640a 2020 2020 204d generated. M │ │ │ │ │ +00022b30: 616b 6566 696c 6573 2e0a 0a20 2020 2020 akefiles... │ │ │ │ │ +00022b40: 5468 6973 206d 6163 726f 2068 6173 2074 This macro has t │ │ │ │ │ +00022b50: 776f 2066 6f72 6d73 2c20 7468 6520 6669 wo forms, the fi │ │ │ │ │ +00022b60: 7273 7420 6f66 2077 6869 6368 2069 7320 rst of which is │ │ │ │ │ +00022b70: 7072 6566 6572 7265 642e 2020 496e 2074 preferred. In t │ │ │ │ │ +00022b80: 6869 730a 2020 2020 2066 6f72 6d2c 2027 his. form, ' │ │ │ │ │ +00022b90: 414d 5f49 4e49 545f 4155 544f 4d41 4b45 AM_INIT_AUTOMAKE │ │ │ │ │ +00022ba0: 2720 6973 2063 616c 6c65 6420 7769 7468 ' is called with │ │ │ │ │ +00022bb0: 2061 2073 696e 676c 6520 6172 6775 6d65 a single argume │ │ │ │ │ +00022bc0: 6e74 3a20 610a 2020 2020 2073 7061 6365 nt: a. space │ │ │ │ │ +00022bd0: 2d73 6570 6172 6174 6564 206c 6973 7420 -separated list │ │ │ │ │ +00022be0: 6f66 2041 7574 6f6d 616b 6520 6f70 7469 of Automake opti │ │ │ │ │ +00022bf0: 6f6e 7320 7468 6174 2073 686f 756c 6420 ons that should │ │ │ │ │ +00022c00: 6265 2061 7070 6c69 6564 2074 6f0a 2020 be applied to. │ │ │ │ │ +00022c10: 2020 2065 7665 7279 2027 4d61 6b65 6669 every 'Makefi │ │ │ │ │ +00022c20: 6c65 2e61 6d27 2069 6e20 7468 6520 7472 le.am' in the tr │ │ │ │ │ +00022c30: 6565 2e20 2054 6865 2065 6666 6563 7420 ee. The effect │ │ │ │ │ +00022c40: 6973 2061 7320 6966 2065 6163 6820 6f70 is as if each op │ │ │ │ │ +00022c50: 7469 6f6e 0a20 2020 2020 7765 7265 206c tion. were l │ │ │ │ │ +00022c60: 6973 7465 6420 696e 2027 4155 544f 4d41 isted in 'AUTOMA │ │ │ │ │ +00022c70: 4b45 5f4f 5054 494f 4e53 2720 282a 6e6f KE_OPTIONS' (*no │ │ │ │ │ +00022c80: 7465 204f 7074 696f 6e73 3a3a 292e 0a0a te Options::)... │ │ │ │ │ +00022c90: 2020 2020 2054 6865 2073 6563 6f6e 642c The second, │ │ │ │ │ +00022ca0: 2064 6570 7265 6361 7465 642c 2066 6f72 deprecated, for │ │ │ │ │ +00022cb0: 6d20 6f66 2027 414d 5f49 4e49 545f 4155 m of 'AM_INIT_AU │ │ │ │ │ +00022cc0: 544f 4d41 4b45 2720 6861 7320 7477 6f20 TOMAKE' has two │ │ │ │ │ +00022cd0: 7265 7175 6972 6564 0a20 2020 2020 6172 required. ar │ │ │ │ │ +00022ce0: 6775 6d65 6e74 733a 2074 6865 2070 6163 guments: the pac │ │ │ │ │ +00022cf0: 6b61 6765 2061 6e64 2074 6865 2076 6572 kage and the ver │ │ │ │ │ +00022d00: 7369 6f6e 206e 756d 6265 722e 2020 5468 sion number. Th │ │ │ │ │ +00022d10: 6973 2066 6f72 6d20 6973 0a20 2020 2020 is form is. │ │ │ │ │ +00022d20: 6f62 736f 6c65 7465 2062 6563 6175 7365 obsolete because │ │ │ │ │ +00022d30: 2074 6865 2050 4143 4b41 4745 2061 6e64 the PACKAGE and │ │ │ │ │ +00022d40: 2056 4552 5349 4f4e 2063 616e 2062 6520 VERSION can be │ │ │ │ │ +00022d50: 6f62 7461 696e 6564 2066 726f 6d0a 2020 obtained from. │ │ │ │ │ +00022d60: 2020 2041 7574 6f63 6f6e 6627 7320 2741 Autoconf's 'A │ │ │ │ │ +00022d70: 435f 494e 4954 2720 6d61 6372 6f20 2877 C_INIT' macro (w │ │ │ │ │ +00022d80: 6869 6368 2069 7473 656c 6620 6861 7320 hich itself has │ │ │ │ │ +00022d90: 616e 206f 6c64 2061 6e64 2061 206e 6577 an old and a new │ │ │ │ │ +00022da0: 0a20 2020 2020 666f 726d 292e 0a0a 2020 . form)... │ │ │ │ │ +00022db0: 2020 2049 6620 796f 7572 2027 636f 6e66 If your 'conf │ │ │ │ │ +00022dc0: 6967 7572 652e 6163 2720 6861 733a 0a0a igure.ac' has:.. │ │ │ │ │ +00022dd0: 2020 2020 2020 2020 2020 4143 5f49 4e49 AC_INI │ │ │ │ │ +00022de0: 5428 5b73 7263 2f66 6f6f 2e63 5d29 0a20 T([src/foo.c]). │ │ │ │ │ +00022df0: 2020 2020 2020 2020 2041 4d5f 494e 4954 AM_INIT │ │ │ │ │ +00022e00: 5f41 5554 4f4d 414b 4528 5b6d 756d 626c _AUTOMAKE([mumbl │ │ │ │ │ +00022e10: 655d 2c20 5b31 2e35 5d29 0a0a 2020 2020 e], [1.5]).. │ │ │ │ │ +00022e20: 2079 6f75 2063 616e 206d 6f64 6572 6e69 you can moderni │ │ │ │ │ +00022e30: 7a65 2069 7420 6173 2066 6f6c 6c6f 7773 ze it as follows │ │ │ │ │ +00022e40: 3a0a 0a20 2020 2020 2020 2020 2041 435f :.. AC_ │ │ │ │ │ +00022e50: 494e 4954 285b 6d75 6d62 6c65 5d2c 205b INIT([mumble], [ │ │ │ │ │ +00022e60: 312e 355d 290a 2020 2020 2020 2020 2020 1.5]). │ │ │ │ │ +00022e70: 4143 5f43 4f4e 4649 475f 5352 4344 4952 AC_CONFIG_SRCDIR │ │ │ │ │ +00022e80: 285b 7372 632f 666f 6f2e 635d 290a 2020 ([src/foo.c]). │ │ │ │ │ +00022e90: 2020 2020 2020 2020 414d 5f49 4e49 545f AM_INIT_ │ │ │ │ │ +00022ea0: 4155 544f 4d41 4b45 0a0a 2020 2020 204e AUTOMAKE.. N │ │ │ │ │ +00022eb0: 6f74 6520 7468 6174 2069 6620 796f 7527 ote that if you' │ │ │ │ │ +00022ec0: 7265 2075 7067 7261 6469 6e67 2079 6f75 re upgrading you │ │ │ │ │ +00022ed0: 7220 2763 6f6e 6669 6775 7265 2e61 6327 r 'configure.ac' │ │ │ │ │ +00022ee0: 2066 726f 6d20 616e 2065 6172 6c69 6572 from an earlier │ │ │ │ │ +00022ef0: 0a20 2020 2020 7665 7273 696f 6e20 6f66 . version of │ │ │ │ │ +00022f00: 2041 7574 6f6d 616b 652c 2069 7420 6973 Automake, it is │ │ │ │ │ +00022f10: 206e 6f74 2061 6c77 6179 7320 636f 7272 not always corr │ │ │ │ │ +00022f20: 6563 7420 746f 2073 696d 706c 7920 6d6f ect to simply mo │ │ │ │ │ +00022f30: 7665 2074 6865 0a20 2020 2020 7061 636b ve the. pack │ │ │ │ │ +00022f40: 6167 6520 616e 6420 7665 7273 696f 6e20 age and version │ │ │ │ │ +00022f50: 6172 6775 6d65 6e74 7320 6672 6f6d 2027 arguments from ' │ │ │ │ │ +00022f60: 414d 5f49 4e49 545f 4155 544f 4d41 4b45 AM_INIT_AUTOMAKE │ │ │ │ │ +00022f70: 2720 6469 7265 6374 6c79 2074 6f0a 2020 ' directly to. │ │ │ │ │ +00022f80: 2020 2027 4143 5f49 4e49 5427 2c20 6173 'AC_INIT', as │ │ │ │ │ +00022f90: 2069 6e20 7468 6520 6578 616d 706c 6520 in the example │ │ │ │ │ +00022fa0: 6162 6f76 652e 2020 5468 6520 6669 7273 above. The firs │ │ │ │ │ +00022fb0: 7420 6172 6775 6d65 6e74 2074 6f0a 2020 t argument to. │ │ │ │ │ +00022fc0: 2020 2027 4143 5f49 4e49 5427 2073 686f 'AC_INIT' sho │ │ │ │ │ +00022fd0: 756c 6420 6265 2074 6865 206e 616d 6520 uld be the name │ │ │ │ │ +00022fe0: 6f66 2079 6f75 7220 7061 636b 6167 6520 of your package │ │ │ │ │ +00022ff0: 2865 2e67 2e2c 2027 474e 550a 2020 2020 (e.g., 'GNU. │ │ │ │ │ +00023000: 2041 7574 6f6d 616b 6527 292c 206e 6f74 Automake'), not │ │ │ │ │ +00023010: 2074 6865 2074 6172 6261 6c6c 206e 616d the tarball nam │ │ │ │ │ +00023020: 6520 2865 2e67 2e2c 2027 6175 746f 6d61 e (e.g., 'automa │ │ │ │ │ +00023030: 6b65 2729 2074 6861 7420 796f 7520 7573 ke') that you us │ │ │ │ │ +00023040: 6564 0a20 2020 2020 746f 2070 6173 7320 ed. to pass │ │ │ │ │ +00023050: 746f 2027 414d 5f49 4e49 545f 4155 544f to 'AM_INIT_AUTO │ │ │ │ │ +00023060: 4d41 4b45 272e 2020 4175 746f 636f 6e66 MAKE'. Autoconf │ │ │ │ │ +00023070: 2074 7269 6573 2074 6f20 6465 7269 7665 tries to derive │ │ │ │ │ +00023080: 2061 2074 6172 6261 6c6c 0a20 2020 2020 a tarball. │ │ │ │ │ +00023090: 6e61 6d65 2066 726f 6d20 7468 6520 7061 name from the pa │ │ │ │ │ +000230a0: 636b 6167 6520 6e61 6d65 2c20 7768 6963 ckage name, whic │ │ │ │ │ +000230b0: 6820 7368 6f75 6c64 2077 6f72 6b20 666f h should work fo │ │ │ │ │ +000230c0: 7220 6d6f 7374 2062 7574 206e 6f74 2061 r most but not a │ │ │ │ │ +000230d0: 6c6c 0a20 2020 2020 7061 636b 6167 6520 ll. package │ │ │ │ │ +000230e0: 6e61 6d65 732e 2020 2849 6620 6974 2064 names. (If it d │ │ │ │ │ +000230f0: 6f65 736e 2774 2077 6f72 6b20 666f 7220 oesn't work for │ │ │ │ │ +00023100: 796f 7572 732c 2079 6f75 2063 616e 2075 yours, you can u │ │ │ │ │ +00023110: 7365 2074 6865 0a20 2020 2020 666f 7572 se the. four │ │ │ │ │ +00023120: 2d61 7267 756d 656e 7420 666f 726d 206f -argument form o │ │ │ │ │ +00023130: 6620 2741 435f 494e 4954 2720 746f 2070 f 'AC_INIT' to p │ │ │ │ │ +00023140: 726f 7669 6465 2074 6865 2074 6172 6261 rovide the tarba │ │ │ │ │ +00023150: 6c6c 206e 616d 650a 2020 2020 2065 7870 ll name. exp │ │ │ │ │ +00023160: 6c69 6369 746c 7929 2e0a 0a20 2020 2020 licitly)... │ │ │ │ │ +00023170: 4279 2064 6566 6175 6c74 2074 6869 7320 By default this │ │ │ │ │ +00023180: 6d61 6372 6f20 2741 435f 4445 4649 4e45 macro 'AC_DEFINE │ │ │ │ │ +00023190: 2727 7320 2750 4143 4b41 4745 2720 616e ''s 'PACKAGE' an │ │ │ │ │ +000231a0: 6420 2756 4552 5349 4f4e 272e 2020 5468 d 'VERSION'. Th │ │ │ │ │ +000231b0: 6973 0a20 2020 2020 6361 6e20 6265 2061 is. can be a │ │ │ │ │ +000231c0: 766f 6964 6564 2062 7920 7061 7373 696e voided by passin │ │ │ │ │ +000231d0: 6720 7468 6520 276e 6f2d 6465 6669 6e65 g the 'no-define │ │ │ │ │ +000231e0: 2720 6f70 7469 6f6e 2c20 6173 2069 6e3a ' option, as in: │ │ │ │ │ +000231f0: 0a20 2020 2020 2020 2020 2041 4d5f 494e . AM_IN │ │ │ │ │ +00023200: 4954 5f41 5554 4f4d 414b 4528 5b67 6e69 IT_AUTOMAKE([gni │ │ │ │ │ +00023210: 7473 2031 2e35 206e 6f2d 6465 6669 6e65 ts 1.5 no-define │ │ │ │ │ +00023220: 2064 6973 742d 627a 6970 325d 290a 2020 dist-bzip2]). │ │ │ │ │ +00023230: 2020 206f 7220 6279 2070 6173 7369 6e67 or by passing │ │ │ │ │ +00023240: 2061 2074 6869 7264 206e 6f6e 2d65 6d70 a third non-emp │ │ │ │ │ +00023250: 7479 2061 7267 756d 656e 7420 746f 2074 ty argument to t │ │ │ │ │ +00023260: 6865 206f 6273 6f6c 6574 6520 666f 726d he obsolete form │ │ │ │ │ +00023270: 2e0a 0a27 414d 5f50 4154 485f 4c49 5350 ...'AM_PATH_LISP │ │ │ │ │ +00023280: 4449 5227 0a20 2020 2020 5365 6172 6368 DIR'. Search │ │ │ │ │ +00023290: 6573 2066 6f72 2074 6865 2070 726f 6772 es for the progr │ │ │ │ │ +000232a0: 616d 2027 656d 6163 7327 2c20 616e 642c am 'emacs', and, │ │ │ │ │ +000232b0: 2069 6620 666f 756e 642c 2073 6574 7320 if found, sets │ │ │ │ │ +000232c0: 7468 6520 6f75 7470 7574 0a20 2020 2020 the output. │ │ │ │ │ +000232d0: 7661 7269 6162 6c65 2027 6c69 7370 6469 variable 'lispdi │ │ │ │ │ +000232e0: 7227 2074 6f20 7468 6520 6675 6c6c 2070 r' to the full p │ │ │ │ │ +000232f0: 6174 6820 746f 2045 6d61 6373 2720 7369 ath to Emacs' si │ │ │ │ │ +00023300: 7465 2d6c 6973 7020 6469 7265 6374 6f72 te-lisp director │ │ │ │ │ +00023310: 792e 0a0a 2020 2020 204e 6f74 6520 7468 y... Note th │ │ │ │ │ +00023320: 6174 2074 6869 7320 7465 7374 2061 7373 at this test ass │ │ │ │ │ +00023330: 756d 6573 2074 6865 2027 656d 6163 7327 umes the 'emacs' │ │ │ │ │ +00023340: 2066 6f75 6e64 2074 6f20 6265 2061 2076 found to be a v │ │ │ │ │ +00023350: 6572 7369 6f6e 2074 6861 740a 2020 2020 ersion that. │ │ │ │ │ +00023360: 2073 7570 706f 7274 7320 456d 6163 7320 supports Emacs │ │ │ │ │ +00023370: 4c69 7370 2028 7375 6368 2061 7320 474e Lisp (such as GN │ │ │ │ │ +00023380: 5520 456d 6163 7320 6f72 2058 456d 6163 U Emacs or XEmac │ │ │ │ │ +00023390: 7329 2e20 204f 7468 6572 2065 6d61 6373 s). Other emacs │ │ │ │ │ +000233a0: 656e 0a20 2020 2020 6361 6e20 6361 7573 en. can caus │ │ │ │ │ +000233b0: 6520 7468 6973 2074 6573 7420 746f 2068 e this test to h │ │ │ │ │ +000233c0: 616e 6720 2873 6f6d 652c 206c 696b 6520 ang (some, like │ │ │ │ │ +000233d0: 6f6c 6420 7665 7273 696f 6e73 206f 6620 old versions of │ │ │ │ │ +000233e0: 4d69 6372 6f45 6d61 6373 2c0a 2020 2020 MicroEmacs,. │ │ │ │ │ +000233f0: 2073 7461 7274 2075 7020 696e 2069 6e74 start up in int │ │ │ │ │ +00023400: 6572 6163 7469 7665 206d 6f64 652c 2072 eractive mode, r │ │ │ │ │ +00023410: 6571 7569 7269 6e67 2027 432d 7820 432d equiring 'C-x C- │ │ │ │ │ +00023420: 6327 2074 6f20 6578 6974 2c20 7768 6963 c' to exit, whic │ │ │ │ │ +00023430: 6820 6973 0a20 2020 2020 6861 7264 6c79 h is. hardly │ │ │ │ │ +00023440: 206f 6276 696f 7573 2066 6f72 2061 206e obvious for a n │ │ │ │ │ +00023450: 6f6e 2d65 6d61 6373 2075 7365 7229 2e20 on-emacs user). │ │ │ │ │ +00023460: 2049 6e20 6d6f 7374 2063 6173 6573 2c20 In most cases, │ │ │ │ │ +00023470: 686f 7765 7665 722c 2079 6f75 0a20 2020 however, you. │ │ │ │ │ +00023480: 2020 7368 6f75 6c64 2062 6520 6162 6c65 should be able │ │ │ │ │ +00023490: 2074 6f20 7573 6520 2743 2d63 2720 746f to use 'C-c' to │ │ │ │ │ +000234a0: 206b 696c 6c20 7468 6520 7465 7374 2e20 kill the test. │ │ │ │ │ +000234b0: 2049 6e20 6f72 6465 7220 746f 2061 766f In order to avo │ │ │ │ │ +000234c0: 6964 0a20 2020 2020 7072 6f62 6c65 6d73 id. problems │ │ │ │ │ +000234d0: 2c20 796f 7520 6361 6e20 7365 7420 2745 , you can set 'E │ │ │ │ │ +000234e0: 4d41 4353 2720 746f 2022 6e6f 2220 696e MACS' to "no" in │ │ │ │ │ +000234f0: 2074 6865 2065 6e76 6972 6f6e 6d65 6e74 the environment │ │ │ │ │ +00023500: 2c20 6f72 2075 7365 0a20 2020 2020 7468 , or use. th │ │ │ │ │ +00023510: 6520 272d 2d77 6974 682d 6c69 7370 6469 e '--with-lispdi │ │ │ │ │ +00023520: 7227 206f 7074 696f 6e20 746f 2027 636f r' option to 'co │ │ │ │ │ +00023530: 6e66 6967 7572 6527 2074 6f20 6578 706c nfigure' to expl │ │ │ │ │ +00023540: 6963 6974 6c79 2073 6574 2074 6865 0a20 icitly set the. │ │ │ │ │ +00023550: 2020 2020 636f 7272 6563 7420 7061 7468 correct path │ │ │ │ │ +00023560: 2028 6966 2079 6f75 2772 6520 7375 7265 (if you're sure │ │ │ │ │ +00023570: 2079 6f75 2068 6176 6520 616e 2027 656d you have an 'em │ │ │ │ │ +00023580: 6163 7327 2074 6861 7420 7375 7070 6f72 acs' that suppor │ │ │ │ │ +00023590: 7473 0a20 2020 2020 456d 6163 7320 4c69 ts. Emacs Li │ │ │ │ │ +000235a0: 7370 292e 0a0a 2741 4d5f 5052 4f47 5f41 sp)...'AM_PROG_A │ │ │ │ │ +000235b0: 5228 5b41 4354 2d49 462d 4641 494c 5d29 R([ACT-IF-FAIL]) │ │ │ │ │ +000235c0: 270a 2020 2020 2059 6f75 206d 7573 7420 '. You must │ │ │ │ │ +000235d0: 7573 6520 7468 6973 206d 6163 726f 2077 use this macro w │ │ │ │ │ +000235e0: 6865 6e20 796f 7520 7573 6520 7468 6520 hen you use the │ │ │ │ │ +000235f0: 6172 6368 6976 6572 2069 6e20 796f 7572 archiver in your │ │ │ │ │ +00023600: 2070 726f 6a65 6374 2c0a 2020 2020 2069 project,. i │ │ │ │ │ +00023610: 6620 796f 7520 7761 6e74 2073 7570 706f f you want suppo │ │ │ │ │ +00023620: 7274 2066 6f72 2075 6e75 7375 616c 2061 rt for unusual a │ │ │ │ │ +00023630: 7263 6869 7665 7273 2073 7563 6820 6173 rchivers such as │ │ │ │ │ +00023640: 204d 6963 726f 736f 6674 2027 6c69 6227 Microsoft 'lib' │ │ │ │ │ +00023650: 2e0a 2020 2020 2054 6865 2063 6f6e 7465 .. The conte │ │ │ │ │ +00023660: 6e74 206f 6620 7468 6520 6f70 7469 6f6e nt of the option │ │ │ │ │ +00023670: 616c 2061 7267 756d 656e 7420 6973 2065 al argument is e │ │ │ │ │ +00023680: 7865 6375 7465 6420 6966 2074 6865 2061 xecuted if the a │ │ │ │ │ +00023690: 7263 6869 7665 720a 2020 2020 2069 6e74 rchiver. int │ │ │ │ │ +000236a0: 6572 6661 6365 2069 7320 6e6f 7420 7265 erface is not re │ │ │ │ │ +000236b0: 636f 676e 697a 6564 3b20 7468 6520 6465 cognized; the de │ │ │ │ │ +000236c0: 6661 756c 7420 6163 7469 6f6e 2069 7320 fault action is │ │ │ │ │ +000236d0: 746f 2061 626f 7274 0a20 2020 2020 636f to abort. co │ │ │ │ │ +000236e0: 6e66 6967 7572 6520 7769 7468 2061 6e20 nfigure with an │ │ │ │ │ +000236f0: 6572 726f 7220 6d65 7373 6167 652e 0a0a error message... │ │ │ │ │ +00023700: 2741 4d5f 5052 4f47 5f41 5327 0a20 2020 'AM_PROG_AS'. │ │ │ │ │ +00023710: 2020 5573 6520 7468 6973 206d 6163 726f Use this macro │ │ │ │ │ +00023720: 2077 6865 6e20 796f 7520 6861 7665 2061 when you have a │ │ │ │ │ +00023730: 7373 656d 626c 7920 636f 6465 2069 6e20 ssembly code in │ │ │ │ │ +00023740: 796f 7572 2070 726f 6a65 6374 2e20 2054 your project. T │ │ │ │ │ +00023750: 6869 730a 2020 2020 2077 696c 6c20 6368 his. will ch │ │ │ │ │ +00023760: 6f6f 7365 2074 6865 2061 7373 656d 626c oose the assembl │ │ │ │ │ +00023770: 6572 2066 6f72 2079 6f75 2028 6279 2064 er for you (by d │ │ │ │ │ +00023780: 6566 6175 6c74 2074 6865 2043 2063 6f6d efault the C com │ │ │ │ │ +00023790: 7069 6c65 7229 2061 6e64 0a20 2020 2020 piler) and. │ │ │ │ │ +000237a0: 7365 7420 2743 4341 5327 2c20 616e 6420 set 'CCAS', and │ │ │ │ │ +000237b0: 7769 6c6c 2061 6c73 6f20 7365 7420 2743 will also set 'C │ │ │ │ │ +000237c0: 4341 5346 4c41 4753 2720 6966 2072 6571 CASFLAGS' if req │ │ │ │ │ +000237d0: 7569 7265 642e 0a0a 2741 4d5f 5052 4f47 uired...'AM_PROG │ │ │ │ │ +000237e0: 5f43 435f 435f 4f27 0a20 2020 2020 5468 _CC_C_O'. Th │ │ │ │ │ +000237f0: 6973 2069 7320 6c69 6b65 2027 4143 5f50 is is like 'AC_P │ │ │ │ │ +00023800: 524f 475f 4343 5f43 5f4f 272c 2062 7574 ROG_CC_C_O', but │ │ │ │ │ +00023810: 2069 7420 6765 6e65 7261 7465 7320 6974 it generates it │ │ │ │ │ +00023820: 7320 7265 7375 6c74 7320 696e 2074 6865 s results in the │ │ │ │ │ +00023830: 0a20 2020 2020 6d61 6e6e 6572 2072 6571 . manner req │ │ │ │ │ +00023840: 7569 7265 6420 6279 2041 7574 6f6d 616b uired by Automak │ │ │ │ │ +00023850: 652e 2020 596f 7520 6d75 7374 2075 7365 e. You must use │ │ │ │ │ +00023860: 2074 6869 7320 696e 7374 6561 6420 6f66 this instead of │ │ │ │ │ +00023870: 0a20 2020 2020 2741 435f 5052 4f47 5f43 . 'AC_PROG_C │ │ │ │ │ +00023880: 435f 435f 4f27 2077 6865 6e20 796f 7520 C_C_O' when you │ │ │ │ │ +00023890: 6e65 6564 2074 6869 7320 6675 6e63 7469 need this functi │ │ │ │ │ +000238a0: 6f6e 616c 6974 792c 2074 6861 7420 6973 onality, that is │ │ │ │ │ +000238b0: 2c20 7768 656e 0a20 2020 2020 7573 696e , when. usin │ │ │ │ │ +000238c0: 6720 7065 722d 7461 7267 6574 2066 6c61 g per-target fla │ │ │ │ │ +000238d0: 6773 206f 7220 7375 6264 6972 2d6f 626a gs or subdir-obj │ │ │ │ │ +000238e0: 6563 7473 2077 6974 6820 4320 736f 7572 ects with C sour │ │ │ │ │ +000238f0: 6365 732e 0a0a 2741 4d5f 5052 4f47 5f4c ces...'AM_PROG_L │ │ │ │ │ +00023900: 4558 270a 2020 2020 204c 696b 6520 2741 EX'. Like 'A │ │ │ │ │ +00023910: 435f 5052 4f47 5f4c 4558 2720 282a 6e6f C_PROG_LEX' (*no │ │ │ │ │ +00023920: 7465 2050 6172 7469 6375 6c61 7220 5072 te Particular Pr │ │ │ │ │ +00023930: 6f67 7261 6d20 4368 6563 6b73 3a0a 2020 ogram Checks:. │ │ │ │ │ +00023940: 2020 2028 6175 746f 636f 6e66 2950 6172 (autoconf)Par │ │ │ │ │ +00023950: 7469 6375 6c61 7220 5072 6f67 7261 6d73 ticular Programs │ │ │ │ │ +00023960: 2e29 2c20 6275 7420 7573 6573 2074 6865 .), but uses the │ │ │ │ │ +00023970: 2027 6d69 7373 696e 6727 2073 6372 6970 'missing' scrip │ │ │ │ │ +00023980: 7420 6f6e 0a20 2020 2020 7379 7374 656d t on. system │ │ │ │ │ +00023990: 7320 7468 6174 2064 6f20 6e6f 7420 6861 s that do not ha │ │ │ │ │ +000239a0: 7665 2027 6c65 7827 2e20 2048 502d 5558 ve 'lex'. HP-UX │ │ │ │ │ +000239b0: 2031 3020 6973 206f 6e65 2073 7563 6820 10 is one such │ │ │ │ │ +000239c0: 7379 7374 656d 2e0a 0a27 414d 5f50 524f system...'AM_PRO │ │ │ │ │ +000239d0: 475f 4743 4a27 0a20 2020 2020 5468 6973 G_GCJ'. This │ │ │ │ │ +000239e0: 206d 6163 726f 2066 696e 6473 2074 6865 macro finds the │ │ │ │ │ +000239f0: 2027 6763 6a27 2070 726f 6772 616d 206f 'gcj' program o │ │ │ │ │ +00023a00: 7220 6361 7573 6573 2061 6e20 6572 726f r causes an erro │ │ │ │ │ +00023a10: 722e 2020 4974 2073 6574 730a 2020 2020 r. It sets. │ │ │ │ │ +00023a20: 2027 4743 4a27 2061 6e64 2027 4743 4a46 'GCJ' and 'GCJF │ │ │ │ │ +00023a30: 4c41 4753 272e 2020 2767 636a 2720 6973 LAGS'. 'gcj' is │ │ │ │ │ +00023a40: 2074 6865 204a 6176 6120 6672 6f6e 742d the Java front- │ │ │ │ │ +00023a50: 656e 6420 746f 2074 6865 2047 4e55 0a20 end to the GNU. │ │ │ │ │ +00023a60: 2020 2020 436f 6d70 696c 6572 2043 6f6c Compiler Col │ │ │ │ │ +00023a70: 6c65 6374 696f 6e2e 0a0a 2741 4d5f 5052 lection...'AM_PR │ │ │ │ │ +00023a80: 4f47 5f55 5043 285b 434f 4d50 494c 4552 OG_UPC([COMPILER │ │ │ │ │ +00023a90: 2d53 4541 5243 482d 4c49 5354 5d29 270a -SEARCH-LIST])'. │ │ │ │ │ +00023aa0: 2020 2020 2046 696e 6420 6120 636f 6d70 Find a comp │ │ │ │ │ +00023ab0: 696c 6572 2066 6f72 2055 6e69 6669 6564 iler for Unified │ │ │ │ │ +00023ac0: 2050 6172 616c 6c65 6c20 4320 616e 6420 Parallel C and │ │ │ │ │ +00023ad0: 6465 6669 6e65 2074 6865 2027 5550 4327 define the 'UPC' │ │ │ │ │ +00023ae0: 0a20 2020 2020 7661 7269 6162 6c65 2e20 . variable. │ │ │ │ │ +00023af0: 2054 6865 2064 6566 6175 6c74 2043 4f4d The default COM │ │ │ │ │ +00023b00: 5049 4c45 522d 5345 4152 4348 2d4c 4953 PILER-SEARCH-LIS │ │ │ │ │ +00023b10: 5420 6973 2027 7570 6363 2075 7063 272e T is 'upcc upc'. │ │ │ │ │ +00023b20: 2020 5468 6973 0a20 2020 2020 6d61 6372 This. macr │ │ │ │ │ +00023b30: 6f20 7769 6c6c 2061 626f 7274 2027 636f o will abort 'co │ │ │ │ │ +00023b40: 6e66 6967 7572 6527 2069 6620 6e6f 2055 nfigure' if no U │ │ │ │ │ +00023b50: 6e69 6669 6564 2050 6172 616c 6c65 6c20 nified Parallel │ │ │ │ │ +00023b60: 4320 636f 6d70 696c 6572 2069 730a 2020 C compiler is. │ │ │ │ │ +00023b70: 2020 2066 6f75 6e64 2e0a 0a27 414d 5f53 found...'AM_S │ │ │ │ │ +00023b80: 494c 454e 545f 5255 4c45 5327 0a20 2020 ILENT_RULES'. │ │ │ │ │ +00023b90: 2020 456e 6162 6c65 2074 6865 206d 6163 Enable the mac │ │ │ │ │ +00023ba0: 6869 6e65 7279 2066 6f72 206c 6573 7320 hinery for less │ │ │ │ │ +00023bb0: 7665 7262 6f73 6520 6275 696c 6420 6f75 verbose build ou │ │ │ │ │ +00023bc0: 7470 7574 2028 2a6e 6f74 650a 2020 2020 tput (*note. │ │ │ │ │ +00023bd0: 204f 7074 696f 6e73 3a3a 292e 0a0a 2741 Options::)...'A │ │ │ │ │ +00023be0: 4d5f 5749 5448 5f44 4d41 4c4c 4f43 270a M_WITH_DMALLOC'. │ │ │ │ │ +00023bf0: 2020 2020 2041 6464 2073 7570 706f 7274 Add support │ │ │ │ │ +00023c00: 2066 6f72 2074 6865 2044 6d61 6c6c 6f63 for the Dmalloc │ │ │ │ │ +00023c10: 2070 6163 6b61 6765 2028 6874 7470 3a2f package (http:/ │ │ │ │ │ +00023c20: 2f64 6d61 6c6c 6f63 2e63 6f6d 2f29 2e20 /dmalloc.com/). │ │ │ │ │ +00023c30: 2049 6620 7468 650a 2020 2020 2075 7365 If the. use │ │ │ │ │ +00023c40: 7220 7275 6e73 2027 636f 6e66 6967 7572 r runs 'configur │ │ │ │ │ +00023c50: 6527 2077 6974 6820 272d 2d77 6974 682d e' with '--with- │ │ │ │ │ +00023c60: 646d 616c 6c6f 6327 2c20 7468 656e 2064 dmalloc', then d │ │ │ │ │ +00023c70: 6566 696e 650a 2020 2020 2027 5749 5448 efine. 'WITH │ │ │ │ │ +00023c80: 5f44 4d41 4c4c 4f43 2720 616e 6420 6164 _DMALLOC' and ad │ │ │ │ │ +00023c90: 6420 272d 6c64 6d61 6c6c 6f63 2720 746f d '-ldmalloc' to │ │ │ │ │ +00023ca0: 2027 4c49 4253 272e 0a0a 1f0a 4669 6c65 'LIBS'.....File │ │ │ │ │ +00023cb0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +00023cc0: 696e 666f 2c20 204e 6f64 653a 204f 6273 info, Node: Obs │ │ │ │ │ +00023cd0: 6f6c 6574 6520 4d61 6372 6f73 2c20 204e olete Macros, N │ │ │ │ │ +00023ce0: 6578 743a 2050 7269 7661 7465 204d 6163 ext: Private Mac │ │ │ │ │ +00023cf0: 726f 732c 2020 5072 6576 3a20 5075 626c ros, Prev: Publ │ │ │ │ │ +00023d00: 6963 204d 6163 726f 732c 2020 5570 3a20 ic Macros, Up: │ │ │ │ │ +00023d10: 4d61 6372 6f73 0a0a 362e 342e 3220 4f62 Macros..6.4.2 Ob │ │ │ │ │ +00023d20: 736f 6c65 7465 204d 6163 726f 730a 2d2d solete Macros.-- │ │ │ │ │ 00023d30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00023d40: 2d0a 0a41 6c74 686f 7567 6820 7573 696e -..Although usin │ │ │ │ │ -00023d50: 6720 736f 6d65 206f 6620 7468 6520 666f g some of the fo │ │ │ │ │ -00023d60: 6c6c 6f77 696e 6720 6d61 6372 6f73 2077 llowing macros w │ │ │ │ │ -00023d70: 6173 2072 6571 7569 7265 6420 696e 2070 as required in p │ │ │ │ │ -00023d80: 6173 740a 7265 6c65 6173 6573 2c20 796f ast.releases, yo │ │ │ │ │ -00023d90: 7520 7368 6f75 6c64 206e 6f74 2075 7365 u should not use │ │ │ │ │ -00023da0: 2061 6e79 206f 6620 7468 656d 2069 6e20 any of them in │ │ │ │ │ -00023db0: 6e65 7720 636f 6465 2e20 2052 756e 6e69 new code. Runni │ │ │ │ │ -00023dc0: 6e67 0a27 6175 746f 7570 6461 7465 2720 ng.'autoupdate' │ │ │ │ │ -00023dd0: 7368 6f75 6c64 2061 646a 7573 7420 796f should adjust yo │ │ │ │ │ -00023de0: 7572 2027 636f 6e66 6967 7572 652e 6163 ur 'configure.ac │ │ │ │ │ -00023df0: 2720 6175 746f 6d61 7469 6361 6c6c 7920 ' automatically │ │ │ │ │ -00023e00: 282a 6e6f 7465 0a55 7369 6e67 2027 6175 (*note.Using 'au │ │ │ │ │ -00023e10: 746f 7570 6461 7465 2720 746f 204d 6f64 toupdate' to Mod │ │ │ │ │ -00023e20: 6572 6e69 7a65 2027 636f 6e66 6967 7572 ernize 'configur │ │ │ │ │ -00023e30: 652e 6163 273a 2028 6175 746f 636f 6e66 e.ac': (autoconf │ │ │ │ │ -00023e40: 2961 7574 6f75 7064 6174 650a 496e 766f )autoupdate.Invo │ │ │ │ │ -00023e50: 6361 7469 6f6e 2e29 2e0a 0a27 414d 5f43 cation.)...'AM_C │ │ │ │ │ -00023e60: 5f50 524f 544f 5459 5045 5327 0a20 2020 _PROTOTYPES'. │ │ │ │ │ -00023e70: 2020 4368 6563 6b20 746f 2073 6565 2069 Check to see i │ │ │ │ │ -00023e80: 6620 6675 6e63 7469 6f6e 2070 726f 746f f function proto │ │ │ │ │ -00023e90: 7479 7065 7320 6172 6520 756e 6465 7273 types are unders │ │ │ │ │ -00023ea0: 746f 6f64 2062 7920 7468 6520 636f 6d70 tood by the comp │ │ │ │ │ -00023eb0: 696c 6572 2e0a 2020 2020 2049 6620 736f iler.. If so │ │ │ │ │ -00023ec0: 2c20 6465 6669 6e65 2027 5052 4f54 4f54 , define 'PROTOT │ │ │ │ │ -00023ed0: 5950 4553 2720 616e 6420 7365 7420 7468 YPES' and set th │ │ │ │ │ -00023ee0: 6520 6f75 7470 7574 2076 6172 6961 626c e output variabl │ │ │ │ │ -00023ef0: 6573 2027 5527 2061 6e64 0a20 2020 2020 es 'U' and. │ │ │ │ │ -00023f00: 2741 4e53 4932 4b4e 5227 2074 6f20 7468 'ANSI2KNR' to th │ │ │ │ │ -00023f10: 6520 656d 7074 7920 7374 7269 6e67 2e20 e empty string. │ │ │ │ │ -00023f20: 204f 7468 6572 7769 7365 2c20 7365 7420 Otherwise, set │ │ │ │ │ -00023f30: 2755 2720 746f 2027 5f27 2061 6e64 0a20 'U' to '_' and. │ │ │ │ │ -00023f40: 2020 2020 2741 4e53 4932 4b4e 5227 2074 'ANSI2KNR' t │ │ │ │ │ -00023f50: 6f20 272e 2f61 6e73 6932 6b6e 7227 2e20 o './ansi2knr'. │ │ │ │ │ -00023f60: 2041 7574 6f6d 616b 6520 7573 6564 2074 Automake used t │ │ │ │ │ -00023f70: 6865 7365 2076 616c 7565 7320 746f 0a20 hese values to. │ │ │ │ │ -00023f80: 2020 2020 696d 706c 656d 656e 7420 7468 implement th │ │ │ │ │ -00023f90: 6520 6465 7072 6563 6174 6564 2064 652d e deprecated de- │ │ │ │ │ -00023fa0: 414e 5349 2d66 6963 6174 696f 6e20 6665 ANSI-fication fe │ │ │ │ │ -00023fb0: 6174 7572 653b 2068 6f77 6576 6572 2c20 ature; however, │ │ │ │ │ -00023fc0: 7375 7070 6f72 740a 2020 2020 2066 6f72 support. for │ │ │ │ │ -00023fd0: 205f 7468 6174 2066 6561 7475 7265 2077 _that feature w │ │ │ │ │ -00023fe0: 696c 6c20 6265 2072 656d 6f76 6564 5f20 ill be removed_ │ │ │ │ │ -00023ff0: 696e 2074 6865 206e 6578 7420 6d61 6a6f in the next majo │ │ │ │ │ -00024000: 7220 4175 746f 6d61 6b65 0a20 2020 2020 r Automake. │ │ │ │ │ -00024010: 7265 6c65 6173 652c 2061 6e64 2074 6865 release, and the │ │ │ │ │ -00024020: 6e20 5f74 6865 7365 206d 6163 726f 7320 n _these macros │ │ │ │ │ -00024030: 616e 6420 7661 7269 6162 6c65 7320 7769 and variables wi │ │ │ │ │ -00024040: 6c6c 2067 6f20 6177 6179 2061 730a 2020 ll go away as. │ │ │ │ │ -00024050: 2020 2077 656c 6c5f 2e0a 0a27 414d 5f43 well_...'AM_C │ │ │ │ │ -00024060: 4f4e 4649 475f 4845 4144 4552 270a 2020 ONFIG_HEADER'. │ │ │ │ │ -00024070: 2020 2041 7574 6f6d 616b 6520 7769 6c6c Automake will │ │ │ │ │ -00024080: 2067 656e 6572 6174 6520 7275 6c65 7320 generate rules │ │ │ │ │ -00024090: 746f 2061 7574 6f6d 6174 6963 616c 6c79 to automatically │ │ │ │ │ -000240a0: 2072 6567 656e 6572 6174 6520 7468 6520 regenerate the │ │ │ │ │ -000240b0: 636f 6e66 6967 0a20 2020 2020 6865 6164 config. head │ │ │ │ │ -000240c0: 6572 2e20 2054 6869 7320 6f62 736f 6c65 er. This obsole │ │ │ │ │ -000240d0: 7465 206d 6163 726f 2069 7320 6120 7379 te macro is a sy │ │ │ │ │ -000240e0: 6e6f 6e79 6d20 6f66 2027 4143 5f43 4f4e nonym of 'AC_CON │ │ │ │ │ -000240f0: 4649 475f 4845 4144 4552 5327 0a20 2020 FIG_HEADERS'. │ │ │ │ │ -00024100: 2020 746f 6461 7920 282a 6e6f 7465 204f today (*note O │ │ │ │ │ -00024110: 7074 696f 6e61 6c3a 3a29 2e0a 0a27 414d ptional::)...'AM │ │ │ │ │ -00024120: 5f48 4541 4445 525f 5449 4f43 4757 494e _HEADER_TIOCGWIN │ │ │ │ │ -00024130: 535a 5f4e 4545 4453 5f53 5953 5f49 4f43 SZ_NEEDS_SYS_IOC │ │ │ │ │ -00024140: 544c 270a 2020 2020 2049 6620 7468 6520 TL'. If the │ │ │ │ │ -00024150: 7573 6520 6f66 2027 5449 4f43 4757 494e use of 'TIOCGWIN │ │ │ │ │ -00024160: 535a 2720 7265 7175 6972 6573 2027 3c73 SZ' requires '', th │ │ │ │ │ -00024180: 656e 2064 6566 696e 650a 2020 2020 2027 en define. ' │ │ │ │ │ -00024190: 4757 494e 535a 5f49 4e5f 5359 535f 494f GWINSZ_IN_SYS_IO │ │ │ │ │ -000241a0: 4354 4c27 2e20 204f 7468 6572 7769 7365 CTL'. Otherwise │ │ │ │ │ -000241b0: 2027 5449 4f43 4757 494e 535a 2720 6361 'TIOCGWINSZ' ca │ │ │ │ │ -000241c0: 6e20 6265 2066 6f75 6e64 2069 6e0a 2020 n be found in. │ │ │ │ │ -000241d0: 2020 2027 3c74 6572 6d69 6f73 2e68 3e27 '' │ │ │ │ │ -000241e0: 2e20 2054 6869 7320 6d61 6372 6f20 6973 . This macro is │ │ │ │ │ -000241f0: 206f 6273 6f6c 6574 652c 2079 6f75 2073 obsolete, you s │ │ │ │ │ -00024200: 686f 756c 6420 7573 6520 4175 746f 636f hould use Autoco │ │ │ │ │ -00024210: 6e66 2773 0a20 2020 2020 2741 435f 4845 nf's. 'AC_HE │ │ │ │ │ -00024220: 4144 4552 5f54 494f 4347 5749 4e53 5a27 ADER_TIOCGWINSZ' │ │ │ │ │ -00024230: 2069 6e73 7465 6164 2e0a 0a27 414d 5f50 instead...'AM_P │ │ │ │ │ -00024240: 524f 475f 4d4b 4449 525f 5027 0a0a 2020 ROG_MKDIR_P'.. │ │ │ │ │ -00024250: 2020 2046 726f 6d20 4175 746f 6d61 6b65 From Automake │ │ │ │ │ -00024260: 2031 2e38 2074 6f20 312e 392e 3620 7468 1.8 to 1.9.6 th │ │ │ │ │ -00024270: 6973 206d 6163 726f 2075 7365 6420 746f is macro used to │ │ │ │ │ -00024280: 2064 6566 696e 6520 7468 6520 6f75 7470 define the outp │ │ │ │ │ -00024290: 7574 0a20 2020 2020 7661 7269 6162 6c65 ut. variable │ │ │ │ │ -000242a0: 2027 6d6b 6469 725f 7027 2074 6f20 6f6e 'mkdir_p' to on │ │ │ │ │ -000242b0: 6520 6f66 2027 6d6b 6469 7220 2d70 272c e of 'mkdir -p', │ │ │ │ │ -000242c0: 2027 696e 7374 616c 6c2d 7368 202d 6427 'install-sh -d' │ │ │ │ │ -000242d0: 2c20 6f72 0a20 2020 2020 276d 6b69 6e73 , or. 'mkins │ │ │ │ │ -000242e0: 7461 6c6c 6469 7273 272e 0a0a 2020 2020 talldirs'... │ │ │ │ │ -000242f0: 204e 6f77 6164 6179 7320 4175 746f 636f Nowadays Autoco │ │ │ │ │ -00024300: 6e66 2070 726f 7669 6465 7320 6120 7369 nf provides a si │ │ │ │ │ -00024310: 6d69 6c61 7220 6675 6e63 7469 6f6e 616c milar functional │ │ │ │ │ -00024320: 6974 7920 7769 7468 0a20 2020 2020 2741 ity with. 'A │ │ │ │ │ -00024330: 435f 5052 4f47 5f4d 4b44 4952 5f50 2720 C_PROG_MKDIR_P' │ │ │ │ │ -00024340: 282a 6e6f 7465 2050 6172 7469 6375 6c61 (*note Particula │ │ │ │ │ -00024350: 7220 5072 6f67 7261 6d20 4368 6563 6b73 r Program Checks │ │ │ │ │ -00024360: 3a0a 2020 2020 2028 6175 746f 636f 6e66 :. (autoconf │ │ │ │ │ -00024370: 2950 6172 7469 6375 6c61 7220 5072 6f67 )Particular Prog │ │ │ │ │ -00024380: 7261 6d73 2e29 2c20 686f 7765 7665 7220 rams.), however │ │ │ │ │ -00024390: 7468 6973 2064 6566 696e 6573 2074 6865 this defines the │ │ │ │ │ -000243a0: 206f 7574 7075 740a 2020 2020 2076 6172 output. var │ │ │ │ │ -000243b0: 6961 626c 6520 274d 4b44 4952 5f50 2720 iable 'MKDIR_P' │ │ │ │ │ -000243c0: 696e 7374 6561 642e 2020 5468 6572 6566 instead. Theref │ │ │ │ │ -000243d0: 6f72 6520 2741 4d5f 5052 4f47 5f4d 4b44 ore 'AM_PROG_MKD │ │ │ │ │ -000243e0: 4952 5f50 2720 6861 7320 6265 656e 0a20 IR_P' has been. │ │ │ │ │ -000243f0: 2020 2020 7265 7772 6974 7465 6e20 6173 rewritten as │ │ │ │ │ -00024400: 2061 2074 6869 6e20 7772 6170 7065 7220 a thin wrapper │ │ │ │ │ -00024410: 6172 6f75 6e64 2027 4143 5f50 524f 475f around 'AC_PROG_ │ │ │ │ │ -00024420: 4d4b 4449 525f 5027 2074 6f20 6465 6669 MKDIR_P' to defi │ │ │ │ │ -00024430: 6e65 0a20 2020 2020 276d 6b64 6972 5f70 ne. 'mkdir_p │ │ │ │ │ -00024440: 2720 746f 2074 6865 2073 616d 6520 7661 ' to the same va │ │ │ │ │ -00024450: 6c75 6520 6173 2027 4d4b 4449 525f 5027 lue as 'MKDIR_P' │ │ │ │ │ -00024460: 2066 6f72 2062 6163 6b77 6172 640a 2020 for backward. │ │ │ │ │ -00024470: 2020 2063 6f6d 7061 7469 6269 6c69 7479 compatibility │ │ │ │ │ -00024480: 2e0a 0a20 2020 2020 4966 2079 6f75 2061 ... If you a │ │ │ │ │ -00024490: 7265 2075 7369 6e67 2041 7574 6f6d 616b re using Automak │ │ │ │ │ -000244a0: 652c 2074 6865 7265 2069 7320 6e6f 726d e, there is norm │ │ │ │ │ -000244b0: 616c 6c79 206e 6f20 7265 6173 6f6e 2074 ally no reason t │ │ │ │ │ -000244c0: 6f20 6361 6c6c 2074 6869 730a 2020 2020 o call this. │ │ │ │ │ -000244d0: 206d 6163 726f 2c20 6265 6361 7573 6520 macro, because │ │ │ │ │ -000244e0: 2741 4d5f 494e 4954 5f41 5554 4f4d 414b 'AM_INIT_AUTOMAK │ │ │ │ │ -000244f0: 4527 2061 6c72 6561 6479 2064 6f65 7320 E' already does │ │ │ │ │ -00024500: 736f 2e20 2048 6f77 6576 6572 2c20 6d61 so. However, ma │ │ │ │ │ -00024510: 6b65 0a20 2020 2020 7375 7265 2074 6861 ke. sure tha │ │ │ │ │ -00024520: 7420 7468 6520 6375 7374 6f6d 2072 756c t the custom rul │ │ │ │ │ -00024530: 6573 2069 6e20 796f 7572 2027 4d61 6b65 es in your 'Make │ │ │ │ │ -00024540: 6669 6c65 2773 2075 7365 2027 2428 4d4b file's use '$(MK │ │ │ │ │ -00024550: 4449 525f 5029 2720 616e 640a 2020 2020 DIR_P)' and. │ │ │ │ │ -00024560: 206e 6f74 2027 2428 6d6b 6469 725f 7029 not '$(mkdir_p) │ │ │ │ │ -00024570: 272e 2020 4576 656e 2069 6620 626f 7468 '. Even if both │ │ │ │ │ -00024580: 2076 6172 6961 626c 6573 2073 7469 6c6c variables still │ │ │ │ │ -00024590: 2077 6f72 6b2c 2074 6865 206c 6174 7465 work, the latte │ │ │ │ │ -000245a0: 720a 2020 2020 2073 686f 756c 6420 6265 r. should be │ │ │ │ │ -000245b0: 2063 6f6e 7369 6465 7265 6420 6f62 736f considered obso │ │ │ │ │ -000245c0: 6c65 7465 2e0a 0a20 2020 2020 4966 2079 lete... If y │ │ │ │ │ -000245d0: 6f75 2061 7265 206e 6f74 2075 7369 6e67 ou are not using │ │ │ │ │ -000245e0: 2041 7574 6f6d 616b 652c 2070 6c65 6173 Automake, pleas │ │ │ │ │ -000245f0: 6520 6361 6c6c 2027 4143 5f50 524f 475f e call 'AC_PROG_ │ │ │ │ │ -00024600: 4d4b 4449 525f 5027 0a20 2020 2020 696e MKDIR_P'. in │ │ │ │ │ -00024610: 7374 6561 6420 6f66 2027 414d 5f50 524f stead of 'AM_PRO │ │ │ │ │ -00024620: 475f 4d4b 4449 525f 5027 2e0a 0a27 414d G_MKDIR_P'...'AM │ │ │ │ │ -00024630: 5f53 5953 5f50 4f53 4958 5f54 4552 4d49 _SYS_POSIX_TERMI │ │ │ │ │ -00024640: 4f53 270a 2020 2020 2043 6865 636b 2074 OS'. Check t │ │ │ │ │ -00024650: 6f20 7365 6520 6966 2050 4f53 4958 2074 o see if POSIX t │ │ │ │ │ -00024660: 6572 6d69 6f73 2068 6561 6465 7273 2061 ermios headers a │ │ │ │ │ -00024670: 6e64 2066 756e 6374 696f 6e73 2061 7265 nd functions are │ │ │ │ │ -00024680: 2061 7661 696c 6162 6c65 0a20 2020 2020 available. │ │ │ │ │ -00024690: 6f6e 2074 6865 2073 7973 7465 6d2e 2020 on the system. │ │ │ │ │ -000246a0: 4966 2073 6f2c 2073 6574 2074 6865 2073 If so, set the s │ │ │ │ │ -000246b0: 6865 6c6c 2076 6172 6961 626c 650a 2020 hell variable. │ │ │ │ │ -000246c0: 2020 2027 616d 5f63 765f 7379 735f 706f 'am_cv_sys_po │ │ │ │ │ -000246d0: 7369 785f 7465 726d 696f 7327 2074 6f20 six_termios' to │ │ │ │ │ -000246e0: 2779 6573 272e 2020 4966 206e 6f74 2c20 'yes'. If not, │ │ │ │ │ -000246f0: 7365 7420 7468 6520 7661 7269 6162 6c65 set the variable │ │ │ │ │ -00024700: 2074 6f0a 2020 2020 2027 6e6f 272e 2020 to. 'no'. │ │ │ │ │ -00024710: 5468 6973 206d 6163 726f 2069 7320 6f62 This macro is ob │ │ │ │ │ -00024720: 736f 6c65 7465 2c20 796f 7520 7368 6f75 solete, you shou │ │ │ │ │ -00024730: 6c64 2075 7365 2041 7574 6f63 6f6e 6627 ld use Autoconf' │ │ │ │ │ -00024740: 730a 2020 2020 2027 4143 5f53 5953 5f50 s. 'AC_SYS_P │ │ │ │ │ -00024750: 4f53 4958 5f54 4552 4d49 4f53 2720 696e OSIX_TERMIOS' in │ │ │ │ │ -00024760: 7374 6561 642e 0a0a 2741 4d5f 5749 5448 stead...'AM_WITH │ │ │ │ │ -00024770: 5f52 4547 4558 270a 2020 2020 2041 6464 _REGEX'. Add │ │ │ │ │ -00024780: 7320 272d 2d77 6974 682d 7265 6765 7827 s '--with-regex' │ │ │ │ │ -00024790: 2074 6f20 7468 6520 2763 6f6e 6669 6775 to the 'configu │ │ │ │ │ -000247a0: 7265 2720 636f 6d6d 616e 6420 6c69 6e65 re' command line │ │ │ │ │ -000247b0: 2e20 2049 6620 7370 6563 6966 6965 640a . If specified. │ │ │ │ │ -000247c0: 2020 2020 2028 7468 6520 6465 6661 756c (the defaul │ │ │ │ │ -000247d0: 7429 2c20 7468 656e 2074 6865 2027 7265 t), then the 're │ │ │ │ │ -000247e0: 6765 7827 2072 6567 756c 6172 2065 7870 gex' regular exp │ │ │ │ │ -000247f0: 7265 7373 696f 6e20 6c69 6272 6172 7920 ression library │ │ │ │ │ -00024800: 6973 2075 7365 642c 0a20 2020 2020 2772 is used,. 'r │ │ │ │ │ -00024810: 6567 6578 2e6f 2720 6973 2070 7574 2069 egex.o' is put i │ │ │ │ │ -00024820: 6e74 6f20 274c 4942 4f42 4a53 272c 2061 nto 'LIBOBJS', a │ │ │ │ │ -00024830: 6e64 2027 5749 5448 5f52 4547 4558 2720 nd 'WITH_REGEX' │ │ │ │ │ -00024840: 6973 2064 6566 696e 6564 2e20 2049 660a is defined. If. │ │ │ │ │ -00024850: 2020 2020 2027 2d2d 7769 7468 6f75 742d '--without- │ │ │ │ │ -00024860: 7265 6765 7827 2069 7320 6769 7665 6e2c regex' is given, │ │ │ │ │ -00024870: 2074 6865 6e20 7468 6520 2772 7827 2072 then the 'rx' r │ │ │ │ │ -00024880: 6567 756c 6172 2065 7870 7265 7373 696f egular expressio │ │ │ │ │ -00024890: 6e0a 2020 2020 206c 6962 7261 7279 2069 n. library i │ │ │ │ │ -000248a0: 7320 7573 6564 2c20 616e 6420 2772 782e s used, and 'rx. │ │ │ │ │ -000248b0: 6f27 2069 7320 7075 7420 696e 746f 2027 o' is put into ' │ │ │ │ │ -000248c0: 4c49 424f 424a 5327 2e20 2054 6869 7320 LIBOBJS'. This │ │ │ │ │ -000248d0: 6d61 6372 6f20 6973 0a20 2020 2020 6f62 macro is. ob │ │ │ │ │ -000248e0: 736f 6c65 7465 206e 6f77 2028 7369 6e63 solete now (sinc │ │ │ │ │ -000248f0: 6520 2772 7827 2064 6f65 736e 2774 2073 e 'rx' doesn't s │ │ │ │ │ -00024900: 6565 6d20 746f 2062 6520 6d61 696e 7461 eem to be mainta │ │ │ │ │ -00024910: 696e 6564 292c 2061 6e64 205f 7769 6c6c ined), and _will │ │ │ │ │ -00024920: 0a20 2020 2020 6265 2072 656d 6f76 6564 . be removed │ │ │ │ │ -00024930: 2074 6865 206e 6578 7420 6d61 6a6f 7220 the next major │ │ │ │ │ -00024940: 7665 7273 696f 6e20 6f66 2041 7574 6f6d version of Autom │ │ │ │ │ -00024950: 616b 655f 2e20 2043 6f6e 7369 6465 7220 ake_. Consider │ │ │ │ │ -00024960: 7573 696e 670a 2020 2020 2067 6e75 6c69 using. gnuli │ │ │ │ │ -00024970: 6220 6966 2079 6f75 206e 6565 6420 7265 b if you need re │ │ │ │ │ -00024980: 6765 7820 6675 6e63 7469 6f6e 616c 6974 gex functionalit │ │ │ │ │ -00024990: 792e 0a0a 1f0a 4669 6c65 3a20 6175 746f y.....File: auto │ │ │ │ │ -000249a0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -000249b0: 204e 6f64 653a 2050 7269 7661 7465 204d Node: Private M │ │ │ │ │ -000249c0: 6163 726f 732c 2020 5072 6576 3a20 4f62 acros, Prev: Ob │ │ │ │ │ -000249d0: 736f 6c65 7465 204d 6163 726f 732c 2020 solete Macros, │ │ │ │ │ -000249e0: 5570 3a20 4d61 6372 6f73 0a0a 362e 342e Up: Macros..6.4. │ │ │ │ │ -000249f0: 3320 5072 6976 6174 6520 4d61 6372 6f73 3 Private Macros │ │ │ │ │ -00024a00: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00024a10: 2d2d 2d2d 2d0a 0a54 6865 2066 6f6c 6c6f -----..The follo │ │ │ │ │ -00024a20: 7769 6e67 206d 6163 726f 7320 6172 6520 wing macros are │ │ │ │ │ -00024a30: 7072 6976 6174 6520 6d61 6372 6f73 2079 private macros y │ │ │ │ │ -00024a40: 6f75 2073 686f 756c 6420 6e6f 7420 6361 ou should not ca │ │ │ │ │ -00024a50: 6c6c 2064 6972 6563 746c 792e 0a54 6865 ll directly..The │ │ │ │ │ -00024a60: 7920 6172 6520 6361 6c6c 6564 2062 7920 y are called by │ │ │ │ │ -00024a70: 7468 6520 6f74 6865 7220 7075 626c 6963 the other public │ │ │ │ │ -00024a80: 206d 6163 726f 7320 7768 656e 2061 7070 macros when app │ │ │ │ │ -00024a90: 726f 7072 6961 7465 2e20 2044 6f20 6e6f ropriate. Do no │ │ │ │ │ -00024aa0: 740a 7265 6c79 206f 6e20 7468 656d 2c20 t.rely on them, │ │ │ │ │ -00024ab0: 6173 2074 6865 7920 6d69 6768 7420 6265 as they might be │ │ │ │ │ -00024ac0: 2063 6861 6e67 6564 2069 6e20 6120 6675 changed in a fu │ │ │ │ │ -00024ad0: 7475 7265 2076 6572 7369 6f6e 2e20 2043 ture version. C │ │ │ │ │ -00024ae0: 6f6e 7369 6465 720a 7468 656d 2061 7320 onsider.them as │ │ │ │ │ -00024af0: 696d 706c 656d 656e 7461 7469 6f6e 2064 implementation d │ │ │ │ │ -00024b00: 6574 6169 6c73 3b20 6f72 2062 6574 7465 etails; or bette │ │ │ │ │ -00024b10: 722c 2064 6f20 6e6f 7420 636f 6e73 6964 r, do not consid │ │ │ │ │ -00024b20: 6572 2074 6865 6d20 6174 2061 6c6c 3a0a er them at all:. │ │ │ │ │ -00024b30: 736b 6970 2074 6869 7320 7365 6374 696f skip this sectio │ │ │ │ │ -00024b40: 6e21 0a0a 275f 414d 5f44 4550 454e 4445 n!..'_AM_DEPENDE │ │ │ │ │ -00024b50: 4e43 4945 5327 0a27 414d 5f53 4554 5f44 NCIES'.'AM_SET_D │ │ │ │ │ -00024b60: 4550 4449 5227 0a27 414d 5f44 4550 5f54 EPDIR'.'AM_DEP_T │ │ │ │ │ -00024b70: 5241 434b 270a 2741 4d5f 4f55 5450 5554 RACK'.'AM_OUTPUT │ │ │ │ │ -00024b80: 5f44 4550 454e 4445 4e43 595f 434f 4d4d _DEPENDENCY_COMM │ │ │ │ │ -00024b90: 414e 4453 270a 2020 2020 2054 6865 7365 ANDS'. These │ │ │ │ │ -00024ba0: 206d 6163 726f 7320 6172 6520 7573 6564 macros are used │ │ │ │ │ -00024bb0: 2074 6f20 696d 706c 656d 656e 7420 4175 to implement Au │ │ │ │ │ -00024bc0: 746f 6d61 6b65 2773 2061 7574 6f6d 6174 tomake's automat │ │ │ │ │ -00024bd0: 6963 2064 6570 656e 6465 6e63 790a 2020 ic dependency. │ │ │ │ │ -00024be0: 2020 2074 7261 636b 696e 6720 7363 6865 tracking sche │ │ │ │ │ -00024bf0: 6d65 2e20 2054 6865 7920 6172 6520 6361 me. They are ca │ │ │ │ │ -00024c00: 6c6c 6564 2061 7574 6f6d 6174 6963 616c lled automatical │ │ │ │ │ -00024c10: 6c79 2062 7920 4175 746f 6d61 6b65 2077 ly by Automake w │ │ │ │ │ -00024c20: 6865 6e0a 2020 2020 2072 6571 7569 7265 hen. require │ │ │ │ │ -00024c30: 642c 2061 6e64 2074 6865 7265 2073 686f d, and there sho │ │ │ │ │ -00024c40: 756c 6420 6265 206e 6f20 6e65 6564 2074 uld be no need t │ │ │ │ │ -00024c50: 6f20 696e 766f 6b65 2074 6865 6d20 6d61 o invoke them ma │ │ │ │ │ -00024c60: 6e75 616c 6c79 2e0a 0a27 414d 5f4d 414b nually...'AM_MAK │ │ │ │ │ -00024c70: 455f 494e 434c 5544 4527 0a20 2020 2020 E_INCLUDE'. │ │ │ │ │ -00024c80: 5468 6973 206d 6163 726f 2069 7320 7573 This macro is us │ │ │ │ │ -00024c90: 6564 2074 6f20 6469 7363 6f76 6572 2068 ed to discover h │ │ │ │ │ -00024ca0: 6f77 2074 6865 2075 7365 7227 7320 276d ow the user's 'm │ │ │ │ │ -00024cb0: 616b 6527 2068 616e 646c 6573 0a20 2020 ake' handles. │ │ │ │ │ -00024cc0: 2020 2769 6e63 6c75 6465 2720 7374 6174 'include' stat │ │ │ │ │ -00024cd0: 656d 656e 7473 2e20 2054 6869 7320 6d61 ements. This ma │ │ │ │ │ -00024ce0: 6372 6f20 6973 2061 7574 6f6d 6174 6963 cro is automatic │ │ │ │ │ -00024cf0: 616c 6c79 2069 6e76 6f6b 6564 2077 6865 ally invoked whe │ │ │ │ │ -00024d00: 6e0a 2020 2020 206e 6565 6465 643b 2074 n. needed; t │ │ │ │ │ -00024d10: 6865 7265 2073 686f 756c 6420 6265 206e here should be n │ │ │ │ │ -00024d20: 6f20 6e65 6564 2074 6f20 696e 766f 6b65 o need to invoke │ │ │ │ │ -00024d30: 2069 7420 6d61 6e75 616c 6c79 2e0a 0a27 it manually...' │ │ │ │ │ -00024d40: 414d 5f50 524f 475f 494e 5354 414c 4c5f AM_PROG_INSTALL_ │ │ │ │ │ -00024d50: 5354 5249 5027 0a20 2020 2020 5468 6973 STRIP'. This │ │ │ │ │ -00024d60: 2069 7320 7573 6564 2074 6f20 6669 6e64 is used to find │ │ │ │ │ -00024d70: 2061 2076 6572 7369 6f6e 206f 6620 2769 a version of 'i │ │ │ │ │ -00024d80: 6e73 7461 6c6c 2720 7468 6174 2063 616e nstall' that can │ │ │ │ │ -00024d90: 2062 6520 7573 6564 2074 6f0a 2020 2020 be used to. │ │ │ │ │ -00024da0: 2073 7472 6970 2061 2070 726f 6772 616d strip a program │ │ │ │ │ -00024db0: 2061 7420 696e 7374 616c 6c61 7469 6f6e at installation │ │ │ │ │ -00024dc0: 2074 696d 652e 2020 5468 6973 206d 6163 time. This mac │ │ │ │ │ -00024dd0: 726f 2069 7320 6175 746f 6d61 7469 6361 ro is automatica │ │ │ │ │ -00024de0: 6c6c 790a 2020 2020 2069 6e63 6c75 6465 lly. include │ │ │ │ │ -00024df0: 6420 7768 656e 2072 6571 7569 7265 642e d when required. │ │ │ │ │ -00024e00: 0a0a 2741 4d5f 5341 4e49 5459 5f43 4845 ..'AM_SANITY_CHE │ │ │ │ │ -00024e10: 434b 270a 2020 2020 2054 6869 7320 6368 CK'. This ch │ │ │ │ │ -00024e20: 6563 6b73 2074 6f20 6d61 6b65 2073 7572 ecks to make sur │ │ │ │ │ -00024e30: 6520 7468 6174 2061 2066 696c 6520 6372 e that a file cr │ │ │ │ │ -00024e40: 6561 7465 6420 696e 2074 6865 2062 7569 eated in the bui │ │ │ │ │ -00024e50: 6c64 2064 6972 6563 746f 7279 0a20 2020 ld directory. │ │ │ │ │ -00024e60: 2020 6973 206e 6577 6572 2074 6861 6e20 is newer than │ │ │ │ │ -00024e70: 6120 6669 6c65 2069 6e20 7468 6520 736f a file in the so │ │ │ │ │ -00024e80: 7572 6365 2064 6972 6563 746f 7279 2e20 urce directory. │ │ │ │ │ -00024e90: 2054 6869 7320 6361 6e20 6661 696c 206f This can fail o │ │ │ │ │ -00024ea0: 6e0a 2020 2020 2073 7973 7465 6d73 2077 n. systems w │ │ │ │ │ -00024eb0: 6865 7265 2074 6865 2063 6c6f 636b 2069 here the clock i │ │ │ │ │ -00024ec0: 7320 7365 7420 696e 636f 7272 6563 746c s set incorrectl │ │ │ │ │ -00024ed0: 792e 2020 5468 6973 206d 6163 726f 2069 y. This macro i │ │ │ │ │ -00024ee0: 730a 2020 2020 2061 7574 6f6d 6174 6963 s. automatic │ │ │ │ │ -00024ef0: 616c 6c79 2072 756e 2066 726f 6d20 2741 ally run from 'A │ │ │ │ │ -00024f00: 4d5f 494e 4954 5f41 5554 4f4d 414b 4527 M_INIT_AUTOMAKE' │ │ │ │ │ -00024f10: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ -00024f20: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -00024f30: 4e6f 6465 3a20 4469 7265 6374 6f72 6965 Node: Directorie │ │ │ │ │ -00024f40: 732c 2020 4e65 7874 3a20 5072 6f67 7261 s, Next: Progra │ │ │ │ │ -00024f50: 6d73 2c20 2050 7265 763a 2063 6f6e 6669 ms, Prev: confi │ │ │ │ │ -00024f60: 6775 7265 2c20 2055 703a 2054 6f70 0a0a gure, Up: Top.. │ │ │ │ │ -00024f70: 3720 4469 7265 6374 6f72 6965 730a 2a2a 7 Directories.** │ │ │ │ │ -00024f80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a46 6f72 ***********..For │ │ │ │ │ -00024f90: 2073 696d 706c 6520 7072 6f6a 6563 7473 simple projects │ │ │ │ │ -00024fa0: 2074 6861 7420 6469 7374 7269 6275 7465 that distribute │ │ │ │ │ -00024fb0: 2061 6c6c 2066 696c 6573 2069 6e20 7468 all files in th │ │ │ │ │ -00024fc0: 6520 7361 6d65 2064 6972 6563 746f 7279 e same directory │ │ │ │ │ -00024fd0: 2069 740a 6973 2065 6e6f 7567 6820 746f it.is enough to │ │ │ │ │ -00024fe0: 2068 6176 6520 6120 7369 6e67 6c65 2027 have a single ' │ │ │ │ │ -00024ff0: 4d61 6b65 6669 6c65 2e61 6d27 2074 6861 Makefile.am' tha │ │ │ │ │ -00025000: 7420 6275 696c 6473 2065 7665 7279 7468 t builds everyth │ │ │ │ │ -00025010: 696e 6720 696e 0a70 6c61 6365 2e0a 0a20 ing in.place... │ │ │ │ │ -00025020: 2020 496e 206c 6172 6765 7220 7072 6f6a In larger proj │ │ │ │ │ -00025030: 6563 7473 2069 7420 6973 2063 6f6d 6d6f ects it is commo │ │ │ │ │ -00025040: 6e20 746f 206f 7267 616e 697a 6520 6669 n to organize fi │ │ │ │ │ -00025050: 6c65 7320 696e 2064 6966 6665 7265 6e74 les in different │ │ │ │ │ -00025060: 0a64 6972 6563 746f 7269 6573 2c20 696e .directories, in │ │ │ │ │ -00025070: 2061 2074 7265 652e 2020 466f 7220 696e a tree. For in │ │ │ │ │ -00025080: 7374 616e 6365 206f 6e65 2064 6972 6563 stance one direc │ │ │ │ │ -00025090: 746f 7279 2070 6572 2070 726f 6772 616d tory per program │ │ │ │ │ -000250a0: 2c20 7065 720a 6c69 6272 6172 7920 6f72 , per.library or │ │ │ │ │ -000250b0: 2070 6572 206d 6f64 756c 652e 2020 5468 per module. Th │ │ │ │ │ -000250c0: 6520 7472 6164 6974 696f 6e61 6c20 6170 e traditional ap │ │ │ │ │ -000250d0: 7072 6f61 6368 2069 7320 746f 2062 7569 proach is to bui │ │ │ │ │ -000250e0: 6c64 2074 6865 7365 0a73 7562 6469 7265 ld these.subdire │ │ │ │ │ -000250f0: 6374 6f72 6965 7320 7265 6375 7273 6976 ctories recursiv │ │ │ │ │ -00025100: 656c 793a 2065 6163 6820 6469 7265 6374 ely: each direct │ │ │ │ │ -00025110: 6f72 7920 636f 6e74 6169 6e73 2069 7473 ory contains its │ │ │ │ │ -00025120: 2027 4d61 6b65 6669 6c65 270a 2867 656e 'Makefile'.(gen │ │ │ │ │ -00025130: 6572 6174 6564 2066 726f 6d20 274d 616b erated from 'Mak │ │ │ │ │ -00025140: 6566 696c 652e 616d 2729 2c20 616e 6420 efile.am'), and │ │ │ │ │ -00025150: 7768 656e 2027 6d61 6b65 2720 6973 2072 when 'make' is r │ │ │ │ │ -00025160: 756e 2066 726f 6d20 7468 6520 746f 700a un from the top. │ │ │ │ │ -00025170: 6c65 7665 6c20 6469 7265 6374 6f72 7920 level directory │ │ │ │ │ -00025180: 6974 2065 6e74 6572 7320 6561 6368 2073 it enters each s │ │ │ │ │ -00025190: 7562 6469 7265 6374 6f72 7920 696e 2074 ubdirectory in t │ │ │ │ │ -000251a0: 7572 6e20 746f 2062 7569 6c64 2069 7473 urn to build its │ │ │ │ │ -000251b0: 0a63 6f6e 7465 6e74 732e 0a0a 2a20 4d65 .contents...* Me │ │ │ │ │ -000251c0: 6e75 3a0a 0a2a 2053 7562 6469 7265 6374 nu:..* Subdirect │ │ │ │ │ -000251d0: 6f72 6965 733a 3a20 2020 2020 2020 2020 ories:: │ │ │ │ │ -000251e0: 2020 2020 2042 7569 6c64 696e 6720 7375 Building su │ │ │ │ │ -000251f0: 6264 6972 6563 746f 7269 6573 2072 6563 bdirectories rec │ │ │ │ │ -00025200: 7572 7369 7665 6c79 0a2a 2043 6f6e 6469 ursively.* Condi │ │ │ │ │ -00025210: 7469 6f6e 616c 2053 7562 6469 7265 6374 tional Subdirect │ │ │ │ │ -00025220: 6f72 6965 733a 3a20 2043 6f6e 6469 7469 ories:: Conditi │ │ │ │ │ -00025230: 6f6e 616c 6c79 206e 6f74 2062 7569 6c64 onally not build │ │ │ │ │ -00025240: 696e 6720 6469 7265 6374 6f72 6965 730a ing directories. │ │ │ │ │ -00025250: 2a20 416c 7465 726e 6174 6976 653a 3a20 * Alternative:: │ │ │ │ │ -00025260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00025270: 5375 6264 6972 6563 746f 7269 6573 2077 Subdirectories w │ │ │ │ │ -00025280: 6974 686f 7574 2072 6563 7572 7369 6f6e ithout recursion │ │ │ │ │ -00025290: 0a2a 2053 7562 7061 636b 6167 6573 3a3a .* Subpackages:: │ │ │ │ │ -000252a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000252b0: 204e 6573 7469 6e67 2070 6163 6b61 6765 Nesting package │ │ │ │ │ -000252c0: 730a 0a1f 0a46 696c 653a 2061 7574 6f6d s....File: autom │ │ │ │ │ -000252d0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -000252e0: 4e6f 6465 3a20 5375 6264 6972 6563 746f Node: Subdirecto │ │ │ │ │ -000252f0: 7269 6573 2c20 204e 6578 743a 2043 6f6e ries, Next: Con │ │ │ │ │ -00025300: 6469 7469 6f6e 616c 2053 7562 6469 7265 ditional Subdire │ │ │ │ │ -00025310: 6374 6f72 6965 732c 2020 5570 3a20 4469 ctories, Up: Di │ │ │ │ │ -00025320: 7265 6374 6f72 6965 730a 0a37 2e31 2052 rectories..7.1 R │ │ │ │ │ -00025330: 6563 7572 7369 6e67 2073 7562 6469 7265 ecursing subdire │ │ │ │ │ -00025340: 6374 6f72 6965 730a 3d3d 3d3d 3d3d 3d3d ctories.======== │ │ │ │ │ +00023d40: 2d2d 2d0a 0a41 6c74 686f 7567 6820 7573 ---..Although us │ │ │ │ │ +00023d50: 696e 6720 736f 6d65 206f 6620 7468 6520 ing some of the │ │ │ │ │ +00023d60: 666f 6c6c 6f77 696e 6720 6d61 6372 6f73 following macros │ │ │ │ │ +00023d70: 2077 6173 2072 6571 7569 7265 6420 696e was required in │ │ │ │ │ +00023d80: 2070 6173 740a 7265 6c65 6173 6573 2c20 past.releases, │ │ │ │ │ +00023d90: 796f 7520 7368 6f75 6c64 206e 6f74 2075 you should not u │ │ │ │ │ +00023da0: 7365 2061 6e79 206f 6620 7468 656d 2069 se any of them i │ │ │ │ │ +00023db0: 6e20 6e65 7720 636f 6465 2e20 2052 756e n new code. Run │ │ │ │ │ +00023dc0: 6e69 6e67 0a27 6175 746f 7570 6461 7465 ning.'autoupdate │ │ │ │ │ +00023dd0: 2720 7368 6f75 6c64 2061 646a 7573 7420 ' should adjust │ │ │ │ │ +00023de0: 796f 7572 2027 636f 6e66 6967 7572 652e your 'configure. │ │ │ │ │ +00023df0: 6163 2720 6175 746f 6d61 7469 6361 6c6c ac' automaticall │ │ │ │ │ +00023e00: 7920 282a 6e6f 7465 0a55 7369 6e67 2027 y (*note.Using ' │ │ │ │ │ +00023e10: 6175 746f 7570 6461 7465 2720 746f 204d autoupdate' to M │ │ │ │ │ +00023e20: 6f64 6572 6e69 7a65 2027 636f 6e66 6967 odernize 'config │ │ │ │ │ +00023e30: 7572 652e 6163 273a 2028 6175 746f 636f ure.ac': (autoco │ │ │ │ │ +00023e40: 6e66 2961 7574 6f75 7064 6174 650a 496e nf)autoupdate.In │ │ │ │ │ +00023e50: 766f 6361 7469 6f6e 2e29 2e0a 0a27 414d vocation.)...'AM │ │ │ │ │ +00023e60: 5f43 5f50 524f 544f 5459 5045 5327 0a20 _C_PROTOTYPES'. │ │ │ │ │ +00023e70: 2020 2020 4368 6563 6b20 746f 2073 6565 Check to see │ │ │ │ │ +00023e80: 2069 6620 6675 6e63 7469 6f6e 2070 726f if function pro │ │ │ │ │ +00023e90: 746f 7479 7065 7320 6172 6520 756e 6465 totypes are unde │ │ │ │ │ +00023ea0: 7273 746f 6f64 2062 7920 7468 6520 636f rstood by the co │ │ │ │ │ +00023eb0: 6d70 696c 6572 2e0a 2020 2020 2049 6620 mpiler.. If │ │ │ │ │ +00023ec0: 736f 2c20 6465 6669 6e65 2027 5052 4f54 so, define 'PROT │ │ │ │ │ +00023ed0: 4f54 5950 4553 2720 616e 6420 7365 7420 OTYPES' and set │ │ │ │ │ +00023ee0: 7468 6520 6f75 7470 7574 2076 6172 6961 the output varia │ │ │ │ │ +00023ef0: 626c 6573 2027 5527 2061 6e64 0a20 2020 bles 'U' and. │ │ │ │ │ +00023f00: 2020 2741 4e53 4932 4b4e 5227 2074 6f20 'ANSI2KNR' to │ │ │ │ │ +00023f10: 7468 6520 656d 7074 7920 7374 7269 6e67 the empty string │ │ │ │ │ +00023f20: 2e20 204f 7468 6572 7769 7365 2c20 7365 . Otherwise, se │ │ │ │ │ +00023f30: 7420 2755 2720 746f 2027 5f27 2061 6e64 t 'U' to '_' and │ │ │ │ │ +00023f40: 0a20 2020 2020 2741 4e53 4932 4b4e 5227 . 'ANSI2KNR' │ │ │ │ │ +00023f50: 2074 6f20 272e 2f61 6e73 6932 6b6e 7227 to './ansi2knr' │ │ │ │ │ +00023f60: 2e20 2041 7574 6f6d 616b 6520 7573 6564 . Automake used │ │ │ │ │ +00023f70: 2074 6865 7365 2076 616c 7565 7320 746f these values to │ │ │ │ │ +00023f80: 0a20 2020 2020 696d 706c 656d 656e 7420 . implement │ │ │ │ │ +00023f90: 7468 6520 6465 7072 6563 6174 6564 2064 the deprecated d │ │ │ │ │ +00023fa0: 652d 414e 5349 2d66 6963 6174 696f 6e20 e-ANSI-fication │ │ │ │ │ +00023fb0: 6665 6174 7572 653b 2068 6f77 6576 6572 feature; however │ │ │ │ │ +00023fc0: 2c20 7375 7070 6f72 740a 2020 2020 2066 , support. f │ │ │ │ │ +00023fd0: 6f72 205f 7468 6174 2066 6561 7475 7265 or _that feature │ │ │ │ │ +00023fe0: 2077 696c 6c20 6265 2072 656d 6f76 6564 will be removed │ │ │ │ │ +00023ff0: 5f20 696e 2074 6865 206e 6578 7420 6d61 _ in the next ma │ │ │ │ │ +00024000: 6a6f 7220 4175 746f 6d61 6b65 0a20 2020 jor Automake. │ │ │ │ │ +00024010: 2020 7265 6c65 6173 652c 2061 6e64 2074 release, and t │ │ │ │ │ +00024020: 6865 6e20 5f74 6865 7365 206d 6163 726f hen _these macro │ │ │ │ │ +00024030: 7320 616e 6420 7661 7269 6162 6c65 7320 s and variables │ │ │ │ │ +00024040: 7769 6c6c 2067 6f20 6177 6179 2061 730a will go away as. │ │ │ │ │ +00024050: 2020 2020 2077 656c 6c5f 2e0a 0a27 414d well_...'AM │ │ │ │ │ +00024060: 5f43 4f4e 4649 475f 4845 4144 4552 270a _CONFIG_HEADER'. │ │ │ │ │ +00024070: 2020 2020 2041 7574 6f6d 616b 6520 7769 Automake wi │ │ │ │ │ +00024080: 6c6c 2067 656e 6572 6174 6520 7275 6c65 ll generate rule │ │ │ │ │ +00024090: 7320 746f 2061 7574 6f6d 6174 6963 616c s to automatical │ │ │ │ │ +000240a0: 6c79 2072 6567 656e 6572 6174 6520 7468 ly regenerate th │ │ │ │ │ +000240b0: 6520 636f 6e66 6967 0a20 2020 2020 6865 e config. he │ │ │ │ │ +000240c0: 6164 6572 2e20 2054 6869 7320 6f62 736f ader. This obso │ │ │ │ │ +000240d0: 6c65 7465 206d 6163 726f 2069 7320 6120 lete macro is a │ │ │ │ │ +000240e0: 7379 6e6f 6e79 6d20 6f66 2027 4143 5f43 synonym of 'AC_C │ │ │ │ │ +000240f0: 4f4e 4649 475f 4845 4144 4552 5327 0a20 ONFIG_HEADERS'. │ │ │ │ │ +00024100: 2020 2020 746f 6461 7920 282a 6e6f 7465 today (*note │ │ │ │ │ +00024110: 204f 7074 696f 6e61 6c3a 3a29 2e0a 0a27 Optional::)...' │ │ │ │ │ +00024120: 414d 5f48 4541 4445 525f 5449 4f43 4757 AM_HEADER_TIOCGW │ │ │ │ │ +00024130: 494e 535a 5f4e 4545 4453 5f53 5953 5f49 INSZ_NEEDS_SYS_I │ │ │ │ │ +00024140: 4f43 544c 270a 2020 2020 2049 6620 7468 OCTL'. If th │ │ │ │ │ +00024150: 6520 7573 6520 6f66 2027 5449 4f43 4757 e use of 'TIOCGW │ │ │ │ │ +00024160: 494e 535a 2720 7265 7175 6972 6573 2027 INSZ' requires ' │ │ │ │ │ +00024170: 3c73 7973 2f69 6f63 746c 2e68 3e27 2c20 ', │ │ │ │ │ +00024180: 7468 656e 2064 6566 696e 650a 2020 2020 then define. │ │ │ │ │ +00024190: 2027 4757 494e 535a 5f49 4e5f 5359 535f 'GWINSZ_IN_SYS_ │ │ │ │ │ +000241a0: 494f 4354 4c27 2e20 204f 7468 6572 7769 IOCTL'. Otherwi │ │ │ │ │ +000241b0: 7365 2027 5449 4f43 4757 494e 535a 2720 se 'TIOCGWINSZ' │ │ │ │ │ +000241c0: 6361 6e20 6265 2066 6f75 6e64 2069 6e0a can be found in. │ │ │ │ │ +000241d0: 2020 2020 2027 3c74 6572 6d69 6f73 2e68 ''. This macro │ │ │ │ │ +000241f0: 6973 206f 6273 6f6c 6574 652c 2079 6f75 is obsolete, you │ │ │ │ │ +00024200: 2073 686f 756c 6420 7573 6520 4175 746f should use Auto │ │ │ │ │ +00024210: 636f 6e66 2773 0a20 2020 2020 2741 435f conf's. 'AC_ │ │ │ │ │ +00024220: 4845 4144 4552 5f54 494f 4347 5749 4e53 HEADER_TIOCGWINS │ │ │ │ │ +00024230: 5a27 2069 6e73 7465 6164 2e0a 0a27 414d Z' instead...'AM │ │ │ │ │ +00024240: 5f50 524f 475f 4d4b 4449 525f 5027 0a0a _PROG_MKDIR_P'.. │ │ │ │ │ +00024250: 2020 2020 2046 726f 6d20 4175 746f 6d61 From Automa │ │ │ │ │ +00024260: 6b65 2031 2e38 2074 6f20 312e 392e 3620 ke 1.8 to 1.9.6 │ │ │ │ │ +00024270: 7468 6973 206d 6163 726f 2075 7365 6420 this macro used │ │ │ │ │ +00024280: 746f 2064 6566 696e 6520 7468 6520 6f75 to define the ou │ │ │ │ │ +00024290: 7470 7574 0a20 2020 2020 7661 7269 6162 tput. variab │ │ │ │ │ +000242a0: 6c65 2027 6d6b 6469 725f 7027 2074 6f20 le 'mkdir_p' to │ │ │ │ │ +000242b0: 6f6e 6520 6f66 2027 6d6b 6469 7220 2d70 one of 'mkdir -p │ │ │ │ │ +000242c0: 272c 2027 696e 7374 616c 6c2d 7368 202d ', 'install-sh - │ │ │ │ │ +000242d0: 6427 2c20 6f72 0a20 2020 2020 276d 6b69 d', or. 'mki │ │ │ │ │ +000242e0: 6e73 7461 6c6c 6469 7273 272e 0a0a 2020 nstalldirs'... │ │ │ │ │ +000242f0: 2020 204e 6f77 6164 6179 7320 4175 746f Nowadays Auto │ │ │ │ │ +00024300: 636f 6e66 2070 726f 7669 6465 7320 6120 conf provides a │ │ │ │ │ +00024310: 7369 6d69 6c61 7220 6675 6e63 7469 6f6e similar function │ │ │ │ │ +00024320: 616c 6974 7920 7769 7468 0a20 2020 2020 ality with. │ │ │ │ │ +00024330: 2741 435f 5052 4f47 5f4d 4b44 4952 5f50 'AC_PROG_MKDIR_P │ │ │ │ │ +00024340: 2720 282a 6e6f 7465 2050 6172 7469 6375 ' (*note Particu │ │ │ │ │ +00024350: 6c61 7220 5072 6f67 7261 6d20 4368 6563 lar Program Chec │ │ │ │ │ +00024360: 6b73 3a0a 2020 2020 2028 6175 746f 636f ks:. (autoco │ │ │ │ │ +00024370: 6e66 2950 6172 7469 6375 6c61 7220 5072 nf)Particular Pr │ │ │ │ │ +00024380: 6f67 7261 6d73 2e29 2c20 686f 7765 7665 ograms.), howeve │ │ │ │ │ +00024390: 7220 7468 6973 2064 6566 696e 6573 2074 r this defines t │ │ │ │ │ +000243a0: 6865 206f 7574 7075 740a 2020 2020 2076 he output. v │ │ │ │ │ +000243b0: 6172 6961 626c 6520 274d 4b44 4952 5f50 ariable 'MKDIR_P │ │ │ │ │ +000243c0: 2720 696e 7374 6561 642e 2020 5468 6572 ' instead. Ther │ │ │ │ │ +000243d0: 6566 6f72 6520 2741 4d5f 5052 4f47 5f4d efore 'AM_PROG_M │ │ │ │ │ +000243e0: 4b44 4952 5f50 2720 6861 7320 6265 656e KDIR_P' has been │ │ │ │ │ +000243f0: 0a20 2020 2020 7265 7772 6974 7465 6e20 . rewritten │ │ │ │ │ +00024400: 6173 2061 2074 6869 6e20 7772 6170 7065 as a thin wrappe │ │ │ │ │ +00024410: 7220 6172 6f75 6e64 2027 4143 5f50 524f r around 'AC_PRO │ │ │ │ │ +00024420: 475f 4d4b 4449 525f 5027 2074 6f20 6465 G_MKDIR_P' to de │ │ │ │ │ +00024430: 6669 6e65 0a20 2020 2020 276d 6b64 6972 fine. 'mkdir │ │ │ │ │ +00024440: 5f70 2720 746f 2074 6865 2073 616d 6520 _p' to the same │ │ │ │ │ +00024450: 7661 6c75 6520 6173 2027 4d4b 4449 525f value as 'MKDIR_ │ │ │ │ │ +00024460: 5027 2066 6f72 2062 6163 6b77 6172 640a P' for backward. │ │ │ │ │ +00024470: 2020 2020 2063 6f6d 7061 7469 6269 6c69 compatibili │ │ │ │ │ +00024480: 7479 2e0a 0a20 2020 2020 4966 2079 6f75 ty... If you │ │ │ │ │ +00024490: 2061 7265 2075 7369 6e67 2041 7574 6f6d are using Autom │ │ │ │ │ +000244a0: 616b 652c 2074 6865 7265 2069 7320 6e6f ake, there is no │ │ │ │ │ +000244b0: 726d 616c 6c79 206e 6f20 7265 6173 6f6e rmally no reason │ │ │ │ │ +000244c0: 2074 6f20 6361 6c6c 2074 6869 730a 2020 to call this. │ │ │ │ │ +000244d0: 2020 206d 6163 726f 2c20 6265 6361 7573 macro, becaus │ │ │ │ │ +000244e0: 6520 2741 4d5f 494e 4954 5f41 5554 4f4d e 'AM_INIT_AUTOM │ │ │ │ │ +000244f0: 414b 4527 2061 6c72 6561 6479 2064 6f65 AKE' already doe │ │ │ │ │ +00024500: 7320 736f 2e20 2048 6f77 6576 6572 2c20 s so. However, │ │ │ │ │ +00024510: 6d61 6b65 0a20 2020 2020 7375 7265 2074 make. sure t │ │ │ │ │ +00024520: 6861 7420 7468 6520 6375 7374 6f6d 2072 hat the custom r │ │ │ │ │ +00024530: 756c 6573 2069 6e20 796f 7572 2027 4d61 ules in your 'Ma │ │ │ │ │ +00024540: 6b65 6669 6c65 2773 2075 7365 2027 2428 kefile's use '$( │ │ │ │ │ +00024550: 4d4b 4449 525f 5029 2720 616e 640a 2020 MKDIR_P)' and. │ │ │ │ │ +00024560: 2020 206e 6f74 2027 2428 6d6b 6469 725f not '$(mkdir_ │ │ │ │ │ +00024570: 7029 272e 2020 4576 656e 2069 6620 626f p)'. Even if bo │ │ │ │ │ +00024580: 7468 2076 6172 6961 626c 6573 2073 7469 th variables sti │ │ │ │ │ +00024590: 6c6c 2077 6f72 6b2c 2074 6865 206c 6174 ll work, the lat │ │ │ │ │ +000245a0: 7465 720a 2020 2020 2073 686f 756c 6420 ter. should │ │ │ │ │ +000245b0: 6265 2063 6f6e 7369 6465 7265 6420 6f62 be considered ob │ │ │ │ │ +000245c0: 736f 6c65 7465 2e0a 0a20 2020 2020 4966 solete... If │ │ │ │ │ +000245d0: 2079 6f75 2061 7265 206e 6f74 2075 7369 you are not usi │ │ │ │ │ +000245e0: 6e67 2041 7574 6f6d 616b 652c 2070 6c65 ng Automake, ple │ │ │ │ │ +000245f0: 6173 6520 6361 6c6c 2027 4143 5f50 524f ase call 'AC_PRO │ │ │ │ │ +00024600: 475f 4d4b 4449 525f 5027 0a20 2020 2020 G_MKDIR_P'. │ │ │ │ │ +00024610: 696e 7374 6561 6420 6f66 2027 414d 5f50 instead of 'AM_P │ │ │ │ │ +00024620: 524f 475f 4d4b 4449 525f 5027 2e0a 0a27 ROG_MKDIR_P'...' │ │ │ │ │ +00024630: 414d 5f53 5953 5f50 4f53 4958 5f54 4552 AM_SYS_POSIX_TER │ │ │ │ │ +00024640: 4d49 4f53 270a 2020 2020 2043 6865 636b MIOS'. Check │ │ │ │ │ +00024650: 2074 6f20 7365 6520 6966 2050 4f53 4958 to see if POSIX │ │ │ │ │ +00024660: 2074 6572 6d69 6f73 2068 6561 6465 7273 termios headers │ │ │ │ │ +00024670: 2061 6e64 2066 756e 6374 696f 6e73 2061 and functions a │ │ │ │ │ +00024680: 7265 2061 7661 696c 6162 6c65 0a20 2020 re available. │ │ │ │ │ +00024690: 2020 6f6e 2074 6865 2073 7973 7465 6d2e on the system. │ │ │ │ │ +000246a0: 2020 4966 2073 6f2c 2073 6574 2074 6865 If so, set the │ │ │ │ │ +000246b0: 2073 6865 6c6c 2076 6172 6961 626c 650a shell variable. │ │ │ │ │ +000246c0: 2020 2020 2027 616d 5f63 765f 7379 735f 'am_cv_sys_ │ │ │ │ │ +000246d0: 706f 7369 785f 7465 726d 696f 7327 2074 posix_termios' t │ │ │ │ │ +000246e0: 6f20 2779 6573 272e 2020 4966 206e 6f74 o 'yes'. If not │ │ │ │ │ +000246f0: 2c20 7365 7420 7468 6520 7661 7269 6162 , set the variab │ │ │ │ │ +00024700: 6c65 2074 6f0a 2020 2020 2027 6e6f 272e le to. 'no'. │ │ │ │ │ +00024710: 2020 5468 6973 206d 6163 726f 2069 7320 This macro is │ │ │ │ │ +00024720: 6f62 736f 6c65 7465 2c20 796f 7520 7368 obsolete, you sh │ │ │ │ │ +00024730: 6f75 6c64 2075 7365 2041 7574 6f63 6f6e ould use Autocon │ │ │ │ │ +00024740: 6627 730a 2020 2020 2027 4143 5f53 5953 f's. 'AC_SYS │ │ │ │ │ +00024750: 5f50 4f53 4958 5f54 4552 4d49 4f53 2720 _POSIX_TERMIOS' │ │ │ │ │ +00024760: 696e 7374 6561 642e 0a0a 2741 4d5f 5749 instead...'AM_WI │ │ │ │ │ +00024770: 5448 5f52 4547 4558 270a 2020 2020 2041 TH_REGEX'. A │ │ │ │ │ +00024780: 6464 7320 272d 2d77 6974 682d 7265 6765 dds '--with-rege │ │ │ │ │ +00024790: 7827 2074 6f20 7468 6520 2763 6f6e 6669 x' to the 'confi │ │ │ │ │ +000247a0: 6775 7265 2720 636f 6d6d 616e 6420 6c69 gure' command li │ │ │ │ │ +000247b0: 6e65 2e20 2049 6620 7370 6563 6966 6965 ne. If specifie │ │ │ │ │ +000247c0: 640a 2020 2020 2028 7468 6520 6465 6661 d. (the defa │ │ │ │ │ +000247d0: 756c 7429 2c20 7468 656e 2074 6865 2027 ult), then the ' │ │ │ │ │ +000247e0: 7265 6765 7827 2072 6567 756c 6172 2065 regex' regular e │ │ │ │ │ +000247f0: 7870 7265 7373 696f 6e20 6c69 6272 6172 xpression librar │ │ │ │ │ +00024800: 7920 6973 2075 7365 642c 0a20 2020 2020 y is used,. │ │ │ │ │ +00024810: 2772 6567 6578 2e6f 2720 6973 2070 7574 'regex.o' is put │ │ │ │ │ +00024820: 2069 6e74 6f20 274c 4942 4f42 4a53 272c into 'LIBOBJS', │ │ │ │ │ +00024830: 2061 6e64 2027 5749 5448 5f52 4547 4558 and 'WITH_REGEX │ │ │ │ │ +00024840: 2720 6973 2064 6566 696e 6564 2e20 2049 ' is defined. I │ │ │ │ │ +00024850: 660a 2020 2020 2027 2d2d 7769 7468 6f75 f. '--withou │ │ │ │ │ +00024860: 742d 7265 6765 7827 2069 7320 6769 7665 t-regex' is give │ │ │ │ │ +00024870: 6e2c 2074 6865 6e20 7468 6520 2772 7827 n, then the 'rx' │ │ │ │ │ +00024880: 2072 6567 756c 6172 2065 7870 7265 7373 regular express │ │ │ │ │ +00024890: 696f 6e0a 2020 2020 206c 6962 7261 7279 ion. library │ │ │ │ │ +000248a0: 2069 7320 7573 6564 2c20 616e 6420 2772 is used, and 'r │ │ │ │ │ +000248b0: 782e 6f27 2069 7320 7075 7420 696e 746f x.o' is put into │ │ │ │ │ +000248c0: 2027 4c49 424f 424a 5327 2e20 2054 6869 'LIBOBJS'. Thi │ │ │ │ │ +000248d0: 7320 6d61 6372 6f20 6973 0a20 2020 2020 s macro is. │ │ │ │ │ +000248e0: 6f62 736f 6c65 7465 206e 6f77 2028 7369 obsolete now (si │ │ │ │ │ +000248f0: 6e63 6520 2772 7827 2064 6f65 736e 2774 nce 'rx' doesn't │ │ │ │ │ +00024900: 2073 6565 6d20 746f 2062 6520 6d61 696e seem to be main │ │ │ │ │ +00024910: 7461 696e 6564 292c 2061 6e64 205f 7769 tained), and _wi │ │ │ │ │ +00024920: 6c6c 0a20 2020 2020 6265 2072 656d 6f76 ll. be remov │ │ │ │ │ +00024930: 6564 2074 6865 206e 6578 7420 6d61 6a6f ed the next majo │ │ │ │ │ +00024940: 7220 7665 7273 696f 6e20 6f66 2041 7574 r version of Aut │ │ │ │ │ +00024950: 6f6d 616b 655f 2e20 2043 6f6e 7369 6465 omake_. Conside │ │ │ │ │ +00024960: 7220 7573 696e 670a 2020 2020 2067 6e75 r using. gnu │ │ │ │ │ +00024970: 6c69 6220 6966 2079 6f75 206e 6565 6420 lib if you need │ │ │ │ │ +00024980: 7265 6765 7820 6675 6e63 7469 6f6e 616c regex functional │ │ │ │ │ +00024990: 6974 792e 0a0a 1f0a 4669 6c65 3a20 6175 ity.....File: au │ │ │ │ │ +000249a0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +000249b0: 2c20 204e 6f64 653a 2050 7269 7661 7465 , Node: Private │ │ │ │ │ +000249c0: 204d 6163 726f 732c 2020 5072 6576 3a20 Macros, Prev: │ │ │ │ │ +000249d0: 4f62 736f 6c65 7465 204d 6163 726f 732c Obsolete Macros, │ │ │ │ │ +000249e0: 2020 5570 3a20 4d61 6372 6f73 0a0a 362e Up: Macros..6. │ │ │ │ │ +000249f0: 342e 3320 5072 6976 6174 6520 4d61 6372 4.3 Private Macr │ │ │ │ │ +00024a00: 6f73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d os.------------- │ │ │ │ │ +00024a10: 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066 6f6c -------..The fol │ │ │ │ │ +00024a20: 6c6f 7769 6e67 206d 6163 726f 7320 6172 lowing macros ar │ │ │ │ │ +00024a30: 6520 7072 6976 6174 6520 6d61 6372 6f73 e private macros │ │ │ │ │ +00024a40: 2079 6f75 2073 686f 756c 6420 6e6f 7420 you should not │ │ │ │ │ +00024a50: 6361 6c6c 2064 6972 6563 746c 792e 0a54 call directly..T │ │ │ │ │ +00024a60: 6865 7920 6172 6520 6361 6c6c 6564 2062 hey are called b │ │ │ │ │ +00024a70: 7920 7468 6520 6f74 6865 7220 7075 626c y the other publ │ │ │ │ │ +00024a80: 6963 206d 6163 726f 7320 7768 656e 2061 ic macros when a │ │ │ │ │ +00024a90: 7070 726f 7072 6961 7465 2e20 2044 6f20 ppropriate. Do │ │ │ │ │ +00024aa0: 6e6f 740a 7265 6c79 206f 6e20 7468 656d not.rely on them │ │ │ │ │ +00024ab0: 2c20 6173 2074 6865 7920 6d69 6768 7420 , as they might │ │ │ │ │ +00024ac0: 6265 2063 6861 6e67 6564 2069 6e20 6120 be changed in a │ │ │ │ │ +00024ad0: 6675 7475 7265 2076 6572 7369 6f6e 2e20 future version. │ │ │ │ │ +00024ae0: 2043 6f6e 7369 6465 720a 7468 656d 2061 Consider.them a │ │ │ │ │ +00024af0: 7320 696d 706c 656d 656e 7461 7469 6f6e s implementation │ │ │ │ │ +00024b00: 2064 6574 6169 6c73 3b20 6f72 2062 6574 details; or bet │ │ │ │ │ +00024b10: 7465 722c 2064 6f20 6e6f 7420 636f 6e73 ter, do not cons │ │ │ │ │ +00024b20: 6964 6572 2074 6865 6d20 6174 2061 6c6c ider them at all │ │ │ │ │ +00024b30: 3a0a 736b 6970 2074 6869 7320 7365 6374 :.skip this sect │ │ │ │ │ +00024b40: 696f 6e21 0a0a 275f 414d 5f44 4550 454e ion!..'_AM_DEPEN │ │ │ │ │ +00024b50: 4445 4e43 4945 5327 0a27 414d 5f53 4554 DENCIES'.'AM_SET │ │ │ │ │ +00024b60: 5f44 4550 4449 5227 0a27 414d 5f44 4550 _DEPDIR'.'AM_DEP │ │ │ │ │ +00024b70: 5f54 5241 434b 270a 2741 4d5f 4f55 5450 _TRACK'.'AM_OUTP │ │ │ │ │ +00024b80: 5554 5f44 4550 454e 4445 4e43 595f 434f UT_DEPENDENCY_CO │ │ │ │ │ +00024b90: 4d4d 414e 4453 270a 2020 2020 2054 6865 MMANDS'. The │ │ │ │ │ +00024ba0: 7365 206d 6163 726f 7320 6172 6520 7573 se macros are us │ │ │ │ │ +00024bb0: 6564 2074 6f20 696d 706c 656d 656e 7420 ed to implement │ │ │ │ │ +00024bc0: 4175 746f 6d61 6b65 2773 2061 7574 6f6d Automake's autom │ │ │ │ │ +00024bd0: 6174 6963 2064 6570 656e 6465 6e63 790a atic dependency. │ │ │ │ │ +00024be0: 2020 2020 2074 7261 636b 696e 6720 7363 tracking sc │ │ │ │ │ +00024bf0: 6865 6d65 2e20 2054 6865 7920 6172 6520 heme. They are │ │ │ │ │ +00024c00: 6361 6c6c 6564 2061 7574 6f6d 6174 6963 called automatic │ │ │ │ │ +00024c10: 616c 6c79 2062 7920 4175 746f 6d61 6b65 ally by Automake │ │ │ │ │ +00024c20: 2077 6865 6e0a 2020 2020 2072 6571 7569 when. requi │ │ │ │ │ +00024c30: 7265 642c 2061 6e64 2074 6865 7265 2073 red, and there s │ │ │ │ │ +00024c40: 686f 756c 6420 6265 206e 6f20 6e65 6564 hould be no need │ │ │ │ │ +00024c50: 2074 6f20 696e 766f 6b65 2074 6865 6d20 to invoke them │ │ │ │ │ +00024c60: 6d61 6e75 616c 6c79 2e0a 0a27 414d 5f4d manually...'AM_M │ │ │ │ │ +00024c70: 414b 455f 494e 434c 5544 4527 0a20 2020 AKE_INCLUDE'. │ │ │ │ │ +00024c80: 2020 5468 6973 206d 6163 726f 2069 7320 This macro is │ │ │ │ │ +00024c90: 7573 6564 2074 6f20 6469 7363 6f76 6572 used to discover │ │ │ │ │ +00024ca0: 2068 6f77 2074 6865 2075 7365 7227 7320 how the user's │ │ │ │ │ +00024cb0: 276d 616b 6527 2068 616e 646c 6573 0a20 'make' handles. │ │ │ │ │ +00024cc0: 2020 2020 2769 6e63 6c75 6465 2720 7374 'include' st │ │ │ │ │ +00024cd0: 6174 656d 656e 7473 2e20 2054 6869 7320 atements. This │ │ │ │ │ +00024ce0: 6d61 6372 6f20 6973 2061 7574 6f6d 6174 macro is automat │ │ │ │ │ +00024cf0: 6963 616c 6c79 2069 6e76 6f6b 6564 2077 ically invoked w │ │ │ │ │ +00024d00: 6865 6e0a 2020 2020 206e 6565 6465 643b hen. needed; │ │ │ │ │ +00024d10: 2074 6865 7265 2073 686f 756c 6420 6265 there should be │ │ │ │ │ +00024d20: 206e 6f20 6e65 6564 2074 6f20 696e 766f no need to invo │ │ │ │ │ +00024d30: 6b65 2069 7420 6d61 6e75 616c 6c79 2e0a ke it manually.. │ │ │ │ │ +00024d40: 0a27 414d 5f50 524f 475f 494e 5354 414c .'AM_PROG_INSTAL │ │ │ │ │ +00024d50: 4c5f 5354 5249 5027 0a20 2020 2020 5468 L_STRIP'. Th │ │ │ │ │ +00024d60: 6973 2069 7320 7573 6564 2074 6f20 6669 is is used to fi │ │ │ │ │ +00024d70: 6e64 2061 2076 6572 7369 6f6e 206f 6620 nd a version of │ │ │ │ │ +00024d80: 2769 6e73 7461 6c6c 2720 7468 6174 2063 'install' that c │ │ │ │ │ +00024d90: 616e 2062 6520 7573 6564 2074 6f0a 2020 an be used to. │ │ │ │ │ +00024da0: 2020 2073 7472 6970 2061 2070 726f 6772 strip a progr │ │ │ │ │ +00024db0: 616d 2061 7420 696e 7374 616c 6c61 7469 am at installati │ │ │ │ │ +00024dc0: 6f6e 2074 696d 652e 2020 5468 6973 206d on time. This m │ │ │ │ │ +00024dd0: 6163 726f 2069 7320 6175 746f 6d61 7469 acro is automati │ │ │ │ │ +00024de0: 6361 6c6c 790a 2020 2020 2069 6e63 6c75 cally. inclu │ │ │ │ │ +00024df0: 6465 6420 7768 656e 2072 6571 7569 7265 ded when require │ │ │ │ │ +00024e00: 642e 0a0a 2741 4d5f 5341 4e49 5459 5f43 d...'AM_SANITY_C │ │ │ │ │ +00024e10: 4845 434b 270a 2020 2020 2054 6869 7320 HECK'. This │ │ │ │ │ +00024e20: 6368 6563 6b73 2074 6f20 6d61 6b65 2073 checks to make s │ │ │ │ │ +00024e30: 7572 6520 7468 6174 2061 2066 696c 6520 ure that a file │ │ │ │ │ +00024e40: 6372 6561 7465 6420 696e 2074 6865 2062 created in the b │ │ │ │ │ +00024e50: 7569 6c64 2064 6972 6563 746f 7279 0a20 uild directory. │ │ │ │ │ +00024e60: 2020 2020 6973 206e 6577 6572 2074 6861 is newer tha │ │ │ │ │ +00024e70: 6e20 6120 6669 6c65 2069 6e20 7468 6520 n a file in the │ │ │ │ │ +00024e80: 736f 7572 6365 2064 6972 6563 746f 7279 source directory │ │ │ │ │ +00024e90: 2e20 2054 6869 7320 6361 6e20 6661 696c . This can fail │ │ │ │ │ +00024ea0: 206f 6e0a 2020 2020 2073 7973 7465 6d73 on. systems │ │ │ │ │ +00024eb0: 2077 6865 7265 2074 6865 2063 6c6f 636b where the clock │ │ │ │ │ +00024ec0: 2069 7320 7365 7420 696e 636f 7272 6563 is set incorrec │ │ │ │ │ +00024ed0: 746c 792e 2020 5468 6973 206d 6163 726f tly. This macro │ │ │ │ │ +00024ee0: 2069 730a 2020 2020 2061 7574 6f6d 6174 is. automat │ │ │ │ │ +00024ef0: 6963 616c 6c79 2072 756e 2066 726f 6d20 ically run from │ │ │ │ │ +00024f00: 2741 4d5f 494e 4954 5f41 5554 4f4d 414b 'AM_INIT_AUTOMAK │ │ │ │ │ +00024f10: 4527 2e0a 0a1f 0a46 696c 653a 2061 7574 E'.....File: aut │ │ │ │ │ +00024f20: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +00024f30: 2020 4e6f 6465 3a20 4469 7265 6374 6f72 Node: Director │ │ │ │ │ +00024f40: 6965 732c 2020 4e65 7874 3a20 5072 6f67 ies, Next: Prog │ │ │ │ │ +00024f50: 7261 6d73 2c20 2050 7265 763a 2063 6f6e rams, Prev: con │ │ │ │ │ +00024f60: 6669 6775 7265 2c20 2055 703a 2054 6f70 figure, Up: Top │ │ │ │ │ +00024f70: 0a0a 3720 4469 7265 6374 6f72 6965 730a ..7 Directories. │ │ │ │ │ +00024f80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a46 *************..F │ │ │ │ │ +00024f90: 6f72 2073 696d 706c 6520 7072 6f6a 6563 or simple projec │ │ │ │ │ +00024fa0: 7473 2074 6861 7420 6469 7374 7269 6275 ts that distribu │ │ │ │ │ +00024fb0: 7465 2061 6c6c 2066 696c 6573 2069 6e20 te all files in │ │ │ │ │ +00024fc0: 7468 6520 7361 6d65 2064 6972 6563 746f the same directo │ │ │ │ │ +00024fd0: 7279 2069 740a 6973 2065 6e6f 7567 6820 ry it.is enough │ │ │ │ │ +00024fe0: 746f 2068 6176 6520 6120 7369 6e67 6c65 to have a single │ │ │ │ │ +00024ff0: 2027 4d61 6b65 6669 6c65 2e61 6d27 2074 'Makefile.am' t │ │ │ │ │ +00025000: 6861 7420 6275 696c 6473 2065 7665 7279 hat builds every │ │ │ │ │ +00025010: 7468 696e 6720 696e 0a70 6c61 6365 2e0a thing in.place.. │ │ │ │ │ +00025020: 0a20 2020 496e 206c 6172 6765 7220 7072 . In larger pr │ │ │ │ │ +00025030: 6f6a 6563 7473 2069 7420 6973 2063 6f6d ojects it is com │ │ │ │ │ +00025040: 6d6f 6e20 746f 206f 7267 616e 697a 6520 mon to organize │ │ │ │ │ +00025050: 6669 6c65 7320 696e 2064 6966 6665 7265 files in differe │ │ │ │ │ +00025060: 6e74 0a64 6972 6563 746f 7269 6573 2c20 nt.directories, │ │ │ │ │ +00025070: 696e 2061 2074 7265 652e 2020 466f 7220 in a tree. For │ │ │ │ │ +00025080: 696e 7374 616e 6365 206f 6e65 2064 6972 instance one dir │ │ │ │ │ +00025090: 6563 746f 7279 2070 6572 2070 726f 6772 ectory per progr │ │ │ │ │ +000250a0: 616d 2c20 7065 720a 6c69 6272 6172 7920 am, per.library │ │ │ │ │ +000250b0: 6f72 2070 6572 206d 6f64 756c 652e 2020 or per module. │ │ │ │ │ +000250c0: 5468 6520 7472 6164 6974 696f 6e61 6c20 The traditional │ │ │ │ │ +000250d0: 6170 7072 6f61 6368 2069 7320 746f 2062 approach is to b │ │ │ │ │ +000250e0: 7569 6c64 2074 6865 7365 0a73 7562 6469 uild these.subdi │ │ │ │ │ +000250f0: 7265 6374 6f72 6965 7320 7265 6375 7273 rectories recurs │ │ │ │ │ +00025100: 6976 656c 793a 2065 6163 6820 6469 7265 ively: each dire │ │ │ │ │ +00025110: 6374 6f72 7920 636f 6e74 6169 6e73 2069 ctory contains i │ │ │ │ │ +00025120: 7473 2027 4d61 6b65 6669 6c65 270a 2867 ts 'Makefile'.(g │ │ │ │ │ +00025130: 656e 6572 6174 6564 2066 726f 6d20 274d enerated from 'M │ │ │ │ │ +00025140: 616b 6566 696c 652e 616d 2729 2c20 616e akefile.am'), an │ │ │ │ │ +00025150: 6420 7768 656e 2027 6d61 6b65 2720 6973 d when 'make' is │ │ │ │ │ +00025160: 2072 756e 2066 726f 6d20 7468 6520 746f run from the to │ │ │ │ │ +00025170: 700a 6c65 7665 6c20 6469 7265 6374 6f72 p.level director │ │ │ │ │ +00025180: 7920 6974 2065 6e74 6572 7320 6561 6368 y it enters each │ │ │ │ │ +00025190: 2073 7562 6469 7265 6374 6f72 7920 696e subdirectory in │ │ │ │ │ +000251a0: 2074 7572 6e20 746f 2062 7569 6c64 2069 turn to build i │ │ │ │ │ +000251b0: 7473 0a63 6f6e 7465 6e74 732e 0a0a 2a20 ts.contents...* │ │ │ │ │ +000251c0: 4d65 6e75 3a0a 0a2a 2053 7562 6469 7265 Menu:..* Subdire │ │ │ │ │ +000251d0: 6374 6f72 6965 733a 3a20 2020 2020 2020 ctories:: │ │ │ │ │ +000251e0: 2020 2020 2020 2042 7569 6c64 696e 6720 Building │ │ │ │ │ +000251f0: 7375 6264 6972 6563 746f 7269 6573 2072 subdirectories r │ │ │ │ │ +00025200: 6563 7572 7369 7665 6c79 0a2a 2043 6f6e ecursively.* Con │ │ │ │ │ +00025210: 6469 7469 6f6e 616c 2053 7562 6469 7265 ditional Subdire │ │ │ │ │ +00025220: 6374 6f72 6965 733a 3a20 2043 6f6e 6469 ctories:: Condi │ │ │ │ │ +00025230: 7469 6f6e 616c 6c79 206e 6f74 2062 7569 tionally not bui │ │ │ │ │ +00025240: 6c64 696e 6720 6469 7265 6374 6f72 6965 lding directorie │ │ │ │ │ +00025250: 730a 2a20 416c 7465 726e 6174 6976 653a s.* Alternative: │ │ │ │ │ +00025260: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00025270: 2020 5375 6264 6972 6563 746f 7269 6573 Subdirectories │ │ │ │ │ +00025280: 2077 6974 686f 7574 2072 6563 7572 7369 without recursi │ │ │ │ │ +00025290: 6f6e 0a2a 2053 7562 7061 636b 6167 6573 on.* Subpackages │ │ │ │ │ +000252a0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000252b0: 2020 204e 6573 7469 6e67 2070 6163 6b61 Nesting packa │ │ │ │ │ +000252c0: 6765 730a 0a1f 0a46 696c 653a 2061 7574 ges....File: aut │ │ │ │ │ +000252d0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +000252e0: 2020 4e6f 6465 3a20 5375 6264 6972 6563 Node: Subdirec │ │ │ │ │ +000252f0: 746f 7269 6573 2c20 204e 6578 743a 2043 tories, Next: C │ │ │ │ │ +00025300: 6f6e 6469 7469 6f6e 616c 2053 7562 6469 onditional Subdi │ │ │ │ │ +00025310: 7265 6374 6f72 6965 732c 2020 5570 3a20 rectories, Up: │ │ │ │ │ +00025320: 4469 7265 6374 6f72 6965 730a 0a37 2e31 Directories..7.1 │ │ │ │ │ +00025330: 2052 6563 7572 7369 6e67 2073 7562 6469 Recursing subdi │ │ │ │ │ +00025340: 7265 6374 6f72 6965 730a 3d3d 3d3d 3d3d rectories.====== │ │ │ │ │ 00025350: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00025360: 3d3d 3d3d 0a0a 496e 2070 6163 6b61 6765 ====..In package │ │ │ │ │ -00025370: 7320 7769 7468 2073 7562 6469 7265 6374 s with subdirect │ │ │ │ │ -00025380: 6f72 6965 732c 2074 6865 2074 6f70 206c ories, the top l │ │ │ │ │ -00025390: 6576 656c 2027 4d61 6b65 6669 6c65 2e61 evel 'Makefile.a │ │ │ │ │ -000253a0: 6d27 206d 7573 7420 7465 6c6c 0a41 7574 m' must tell.Aut │ │ │ │ │ -000253b0: 6f6d 616b 6520 7768 6963 6820 7375 6264 omake which subd │ │ │ │ │ -000253c0: 6972 6563 746f 7269 6573 2061 7265 2074 irectories are t │ │ │ │ │ -000253d0: 6f20 6265 2062 7569 6c74 2e20 2054 6869 o be built. Thi │ │ │ │ │ -000253e0: 7320 6973 2064 6f6e 6520 7669 6120 7468 s is done via th │ │ │ │ │ -000253f0: 650a 2753 5542 4449 5253 2720 7661 7269 e.'SUBDIRS' vari │ │ │ │ │ -00025400: 6162 6c65 2e0a 0a20 2020 5468 6520 2753 able... The 'S │ │ │ │ │ -00025410: 5542 4449 5253 2720 7661 7269 6162 6c65 UBDIRS' variable │ │ │ │ │ -00025420: 2068 6f6c 6473 2061 206c 6973 7420 6f66 holds a list of │ │ │ │ │ -00025430: 2073 7562 6469 7265 6374 6f72 6965 7320 subdirectories │ │ │ │ │ -00025440: 696e 2077 6869 6368 0a62 7569 6c64 696e in which.buildin │ │ │ │ │ -00025450: 6720 6f66 2076 6172 696f 7573 2073 6f72 g of various sor │ │ │ │ │ -00025460: 7473 2063 616e 206f 6363 7572 2e20 2054 ts can occur. T │ │ │ │ │ -00025470: 6865 2072 756c 6573 2066 6f72 206d 616e he rules for man │ │ │ │ │ -00025480: 7920 7461 7267 6574 7320 2865 2e67 2e2c y targets (e.g., │ │ │ │ │ -00025490: 0a27 616c 6c27 2920 696e 2074 6865 2067 .'all') in the g │ │ │ │ │ -000254a0: 656e 6572 6174 6564 2027 4d61 6b65 6669 enerated 'Makefi │ │ │ │ │ -000254b0: 6c65 2720 7769 6c6c 2072 756e 2063 6f6d le' will run com │ │ │ │ │ -000254c0: 6d61 6e64 7320 626f 7468 206c 6f63 616c mands both local │ │ │ │ │ -000254d0: 6c79 2061 6e64 2069 6e0a 616c 6c20 7370 ly and in.all sp │ │ │ │ │ -000254e0: 6563 6966 6965 6420 7375 6264 6972 6563 ecified subdirec │ │ │ │ │ -000254f0: 746f 7269 6573 2e20 204e 6f74 6520 7468 tories. Note th │ │ │ │ │ -00025500: 6174 2074 6865 2064 6972 6563 746f 7269 at the directori │ │ │ │ │ -00025510: 6573 206c 6973 7465 6420 696e 0a27 5355 es listed in.'SU │ │ │ │ │ -00025520: 4244 4952 5327 2061 7265 206e 6f74 2072 BDIRS' are not r │ │ │ │ │ -00025530: 6571 7569 7265 6420 746f 2063 6f6e 7461 equired to conta │ │ │ │ │ -00025540: 696e 2027 4d61 6b65 6669 6c65 2e61 6d27 in 'Makefile.am' │ │ │ │ │ -00025550: 733b 206f 6e6c 7920 274d 616b 6566 696c s; only 'Makefil │ │ │ │ │ -00025560: 6527 730a 2861 6674 6572 2063 6f6e 6669 e's.(after confi │ │ │ │ │ -00025570: 6775 7261 7469 6f6e 292e 2020 5468 6973 guration). This │ │ │ │ │ -00025580: 2061 6c6c 6f77 7320 696e 636c 7573 696f allows inclusio │ │ │ │ │ -00025590: 6e20 6f66 206c 6962 7261 7269 6573 2066 n of libraries f │ │ │ │ │ -000255a0: 726f 6d20 7061 636b 6167 6573 0a74 6861 rom packages.tha │ │ │ │ │ -000255b0: 7420 646f 206e 6f74 2075 7365 2041 7574 t do not use Aut │ │ │ │ │ -000255c0: 6f6d 616b 6520 2873 7563 6820 6173 2027 omake (such as ' │ │ │ │ │ -000255d0: 6765 7474 6578 7427 3b20 7365 6520 616c gettext'; see al │ │ │ │ │ -000255e0: 736f 202a 6e6f 7465 2054 6869 7264 2d50 so *note Third-P │ │ │ │ │ -000255f0: 6172 7479 0a4d 616b 6566 696c 6573 3a3a arty.Makefiles:: │ │ │ │ │ -00025600: 292e 0a0a 2020 2049 6e20 7061 636b 6167 )... In packag │ │ │ │ │ -00025610: 6573 2074 6861 7420 7573 6520 7375 6264 es that use subd │ │ │ │ │ -00025620: 6972 6563 746f 7269 6573 2c20 7468 6520 irectories, the │ │ │ │ │ -00025630: 746f 702d 6c65 7665 6c20 274d 616b 6566 top-level 'Makef │ │ │ │ │ -00025640: 696c 652e 616d 2720 6973 0a6f 6674 656e ile.am' is.often │ │ │ │ │ -00025650: 2076 6572 7920 7368 6f72 742e 2020 466f very short. Fo │ │ │ │ │ -00025660: 7220 696e 7374 616e 6365 2c20 6865 7265 r instance, here │ │ │ │ │ -00025670: 2069 7320 7468 6520 274d 616b 6566 696c is the 'Makefil │ │ │ │ │ -00025680: 652e 616d 2720 6672 6f6d 2074 6865 2047 e.am' from the G │ │ │ │ │ -00025690: 4e55 0a48 656c 6c6f 2064 6973 7472 6962 NU.Hello distrib │ │ │ │ │ -000256a0: 7574 696f 6e3a 0a0a 2020 2020 2045 5854 ution:.. EXT │ │ │ │ │ -000256b0: 5241 5f44 4953 5420 3d20 4255 4753 2043 RA_DIST = BUGS C │ │ │ │ │ -000256c0: 6861 6e67 654c 6f67 2e4f 2052 4541 444d hangeLog.O READM │ │ │ │ │ -000256d0: 452d 616c 7068 610a 2020 2020 2053 5542 E-alpha. SUB │ │ │ │ │ -000256e0: 4449 5253 203d 2064 6f63 2069 6e74 6c20 DIRS = doc intl │ │ │ │ │ -000256f0: 706f 2073 7263 2074 6573 7473 0a0a 2020 po src tests.. │ │ │ │ │ -00025700: 2057 6865 6e20 4175 746f 6d61 6b65 2069 When Automake i │ │ │ │ │ -00025710: 6e76 6f6b 6573 2027 6d61 6b65 2720 696e nvokes 'make' in │ │ │ │ │ -00025720: 2061 2073 7562 6469 7265 6374 6f72 792c a subdirectory, │ │ │ │ │ -00025730: 2069 7420 7573 6573 2074 6865 2076 616c it uses the val │ │ │ │ │ -00025740: 7565 206f 660a 7468 6520 274d 414b 4527 ue of.the 'MAKE' │ │ │ │ │ -00025750: 2076 6172 6961 626c 652e 2020 4974 2070 variable. It p │ │ │ │ │ -00025760: 6173 7365 7320 7468 6520 7661 6c75 6520 asses the value │ │ │ │ │ -00025770: 6f66 2074 6865 2076 6172 6961 626c 6520 of the variable │ │ │ │ │ -00025780: 2741 4d5f 4d41 4b45 464c 4147 5327 0a74 'AM_MAKEFLAGS'.t │ │ │ │ │ -00025790: 6f20 7468 6520 276d 616b 6527 2069 6e76 o the 'make' inv │ │ │ │ │ -000257a0: 6f63 6174 696f 6e3b 2074 6869 7320 6361 ocation; this ca │ │ │ │ │ -000257b0: 6e20 6265 2073 6574 2069 6e20 274d 616b n be set in 'Mak │ │ │ │ │ -000257c0: 6566 696c 652e 616d 2720 6966 2074 6865 efile.am' if the │ │ │ │ │ -000257d0: 7265 2061 7265 0a66 6c61 6773 2079 6f75 re are.flags you │ │ │ │ │ -000257e0: 206d 7573 7420 616c 7761 7973 2070 6173 must always pas │ │ │ │ │ -000257f0: 7320 746f 2027 6d61 6b65 272e 0a0a 2020 s to 'make'... │ │ │ │ │ -00025800: 2054 6865 2064 6972 6563 746f 7269 6573 The directories │ │ │ │ │ -00025810: 206d 656e 7469 6f6e 6564 2069 6e20 2753 mentioned in 'S │ │ │ │ │ -00025820: 5542 4449 5253 2720 6172 6520 7573 7561 UBDIRS' are usua │ │ │ │ │ -00025830: 6c6c 7920 6469 7265 6374 2063 6869 6c64 lly direct child │ │ │ │ │ -00025840: 7265 6e20 6f66 0a74 6865 2063 7572 7265 ren of.the curre │ │ │ │ │ -00025850: 6e74 2064 6972 6563 746f 7279 2c20 6561 nt directory, ea │ │ │ │ │ -00025860: 6368 2073 7562 6469 7265 6374 6f72 7920 ch subdirectory │ │ │ │ │ -00025870: 636f 6e74 6169 6e69 6e67 2069 7473 206f containing its o │ │ │ │ │ -00025880: 776e 0a27 4d61 6b65 6669 6c65 2e61 6d27 wn.'Makefile.am' │ │ │ │ │ -00025890: 2077 6974 6820 6120 2753 5542 4449 5253 with a 'SUBDIRS │ │ │ │ │ -000258a0: 2720 706f 696e 7469 6e67 2074 6f20 6465 ' pointing to de │ │ │ │ │ -000258b0: 6570 6572 2073 7562 6469 7265 6374 6f72 eper subdirector │ │ │ │ │ -000258c0: 6965 732e 0a41 7574 6f6d 616b 6520 6361 ies..Automake ca │ │ │ │ │ -000258d0: 6e20 6265 2075 7365 6420 746f 2063 6f6e n be used to con │ │ │ │ │ -000258e0: 7374 7275 6374 2070 6163 6b61 6765 7320 struct packages │ │ │ │ │ -000258f0: 6f66 2061 7262 6974 7261 7279 2064 6570 of arbitrary dep │ │ │ │ │ -00025900: 7468 2074 6869 7320 7761 792e 0a0a 2020 th this way... │ │ │ │ │ -00025910: 2042 7920 6465 6661 756c 742c 2041 7574 By default, Aut │ │ │ │ │ -00025920: 6f6d 616b 6520 6765 6e65 7261 7465 7320 omake generates │ │ │ │ │ -00025930: 274d 616b 6566 696c 6573 2720 7468 6174 'Makefiles' that │ │ │ │ │ -00025940: 2077 6f72 6b20 6465 7074 682d 6669 7273 work depth-firs │ │ │ │ │ -00025950: 7420 696e 0a70 6f73 7466 6978 206f 7264 t in.postfix ord │ │ │ │ │ -00025960: 6572 3a20 7468 6520 7375 6264 6972 6563 er: the subdirec │ │ │ │ │ -00025970: 746f 7269 6573 2061 7265 2062 7569 6c74 tories are built │ │ │ │ │ -00025980: 2062 6566 6f72 6520 7468 6520 6375 7272 before the curr │ │ │ │ │ -00025990: 656e 740a 6469 7265 6374 6f72 792e 2020 ent.directory. │ │ │ │ │ -000259a0: 486f 7765 7665 722c 2069 7420 6973 2070 However, it is p │ │ │ │ │ -000259b0: 6f73 7369 626c 6520 746f 2063 6861 6e67 ossible to chang │ │ │ │ │ -000259c0: 6520 7468 6973 206f 7264 6572 696e 672e e this ordering. │ │ │ │ │ -000259d0: 2020 596f 7520 6361 6e20 646f 0a74 6869 You can do.thi │ │ │ │ │ -000259e0: 7320 6279 2070 7574 7469 6e67 2027 2e27 s by putting '.' │ │ │ │ │ -000259f0: 2069 6e74 6f20 2753 5542 4449 5253 272e into 'SUBDIRS'. │ │ │ │ │ -00025a00: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ -00025a10: 7075 7474 696e 6720 272e 2720 6669 7273 putting '.' firs │ │ │ │ │ -00025a20: 740a 7769 6c6c 2063 6175 7365 2061 2070 t.will cause a p │ │ │ │ │ -00025a30: 7265 6669 7820 6f72 6465 7269 6e67 206f refix ordering o │ │ │ │ │ -00025a40: 6620 6469 7265 6374 6f72 6965 732e 0a0a f directories... │ │ │ │ │ -00025a50: 2020 2055 7369 6e67 0a0a 2020 2020 2053 Using.. S │ │ │ │ │ -00025a60: 5542 4449 5253 203d 206c 6962 2073 7263 UBDIRS = lib src │ │ │ │ │ -00025a70: 202e 2074 6573 740a 0a77 696c 6c20 6361 . test..will ca │ │ │ │ │ -00025a80: 7573 6520 276c 6962 2f27 2074 6f20 6265 use 'lib/' to be │ │ │ │ │ -00025a90: 2062 7569 6c74 2062 6566 6f72 6520 2773 built before 's │ │ │ │ │ -00025aa0: 7263 2f27 2c20 7468 656e 2074 6865 2063 rc/', then the c │ │ │ │ │ -00025ab0: 7572 7265 6e74 2064 6972 6563 746f 7279 urrent directory │ │ │ │ │ -00025ac0: 0a77 696c 6c20 6265 2062 7569 6c74 2c20 .will be built, │ │ │ │ │ -00025ad0: 6669 6e61 6c6c 7920 7468 6520 2774 6573 finally the 'tes │ │ │ │ │ -00025ae0: 742f 2720 6469 7265 6374 6f72 7920 7769 t/' directory wi │ │ │ │ │ -00025af0: 6c6c 2062 6520 6275 696c 742e 2020 4974 ll be built. It │ │ │ │ │ -00025b00: 2069 730a 6375 7374 6f6d 6172 7920 746f is.customary to │ │ │ │ │ -00025b10: 2061 7272 616e 6765 2074 6573 7420 6469 arrange test di │ │ │ │ │ -00025b20: 7265 6374 6f72 6965 7320 746f 2062 6520 rectories to be │ │ │ │ │ -00025b30: 6275 696c 7420 6166 7465 7220 6576 6572 built after ever │ │ │ │ │ -00025b40: 7974 6869 6e67 2065 6c73 650a 7369 6e63 ything else.sinc │ │ │ │ │ -00025b50: 6520 7468 6579 2061 7265 206d 6561 6e74 e they are meant │ │ │ │ │ -00025b60: 2074 6f20 7465 7374 2077 6861 7420 6861 to test what ha │ │ │ │ │ -00025b70: 7320 6265 656e 2063 6f6e 7374 7275 6374 s been construct │ │ │ │ │ -00025b80: 6564 2e0a 0a20 2020 416c 6c20 2763 6c65 ed... All 'cle │ │ │ │ │ -00025b90: 616e 2720 7275 6c65 7320 6172 6520 7275 an' rules are ru │ │ │ │ │ -00025ba0: 6e20 696e 2072 6576 6572 7365 206f 7264 n in reverse ord │ │ │ │ │ -00025bb0: 6572 206f 6620 6275 696c 6420 7275 6c65 er of build rule │ │ │ │ │ -00025bc0: 732e 0a0a 1f0a 4669 6c65 3a20 6175 746f s.....File: auto │ │ │ │ │ -00025bd0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00025be0: 204e 6f64 653a 2043 6f6e 6469 7469 6f6e Node: Condition │ │ │ │ │ -00025bf0: 616c 2053 7562 6469 7265 6374 6f72 6965 al Subdirectorie │ │ │ │ │ -00025c00: 732c 2020 4e65 7874 3a20 416c 7465 726e s, Next: Altern │ │ │ │ │ -00025c10: 6174 6976 652c 2020 5072 6576 3a20 5375 ative, Prev: Su │ │ │ │ │ -00025c20: 6264 6972 6563 746f 7269 6573 2c20 2055 bdirectories, U │ │ │ │ │ -00025c30: 703a 2044 6972 6563 746f 7269 6573 0a0a p: Directories.. │ │ │ │ │ -00025c40: 372e 3220 436f 6e64 6974 696f 6e61 6c20 7.2 Conditional │ │ │ │ │ -00025c50: 5375 6264 6972 6563 746f 7269 6573 0a3d Subdirectories.= │ │ │ │ │ -00025c60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00025c70: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 =============..I │ │ │ │ │ -00025c80: 7420 6973 2070 6f73 7369 626c 6520 746f t is possible to │ │ │ │ │ -00025c90: 2064 6566 696e 6520 7468 6520 2753 5542 define the 'SUB │ │ │ │ │ -00025ca0: 4449 5253 2720 7661 7269 6162 6c65 2063 DIRS' variable c │ │ │ │ │ -00025cb0: 6f6e 6469 7469 6f6e 616c 6c79 2069 662c onditionally if, │ │ │ │ │ -00025cc0: 206c 696b 650a 696e 2074 6865 2063 6173 like.in the cas │ │ │ │ │ -00025cd0: 6520 6f66 2047 4e55 2049 6e65 7475 7469 e of GNU Inetuti │ │ │ │ │ -00025ce0: 6c73 2c20 796f 7520 7761 6e74 2074 6f20 ls, you want to │ │ │ │ │ -00025cf0: 6f6e 6c79 2062 7569 6c64 2061 2073 7562 only build a sub │ │ │ │ │ -00025d00: 7365 7420 6f66 2074 6865 0a65 6e74 6972 set of the.entir │ │ │ │ │ -00025d10: 6520 7061 636b 6167 652e 0a0a 2020 2054 e package... T │ │ │ │ │ -00025d20: 6f20 696c 6c75 7374 7261 7465 2068 6f77 o illustrate how │ │ │ │ │ -00025d30: 2074 6869 7320 776f 726b 732c 206c 6574 this works, let │ │ │ │ │ -00025d40: 2773 2061 7373 756d 6520 7765 2068 6176 's assume we hav │ │ │ │ │ -00025d50: 6520 7477 6f20 6469 7265 6374 6f72 6965 e two directorie │ │ │ │ │ -00025d60: 730a 2773 7263 2f27 2061 6e64 2027 6f70 s.'src/' and 'op │ │ │ │ │ -00025d70: 742f 272e 2020 2773 7263 2f27 2073 686f t/'. 'src/' sho │ │ │ │ │ -00025d80: 756c 6420 616c 7761 7973 2062 6520 6275 uld always be bu │ │ │ │ │ -00025d90: 696c 742c 2062 7574 2077 6520 7761 6e74 ilt, but we want │ │ │ │ │ -00025da0: 2074 6f20 6465 6369 6465 0a69 6e20 2763 to decide.in 'c │ │ │ │ │ -00025db0: 6f6e 6669 6775 7265 2720 7768 6574 6865 onfigure' whethe │ │ │ │ │ -00025dc0: 7220 276f 7074 2f27 2077 696c 6c20 6265 r 'opt/' will be │ │ │ │ │ -00025dd0: 2062 7569 6c74 206f 7220 6e6f 742e 2020 built or not. │ │ │ │ │ -00025de0: 2846 6f72 2074 6869 7320 6578 616d 706c (For this exampl │ │ │ │ │ -00025df0: 650a 7765 2077 696c 6c20 6173 7375 6d65 e.we will assume │ │ │ │ │ -00025e00: 2074 6861 7420 276f 7074 2f27 2073 686f that 'opt/' sho │ │ │ │ │ -00025e10: 756c 6420 6265 2062 7569 6c74 2077 6865 uld be built whe │ │ │ │ │ -00025e20: 6e20 7468 6520 7661 7269 6162 6c65 2027 n the variable ' │ │ │ │ │ -00025e30: 2477 616e 745f 6f70 7427 0a77 6173 2073 $want_opt'.was s │ │ │ │ │ -00025e40: 6574 2074 6f20 2779 6573 272e 290a 0a20 et to 'yes'.).. │ │ │ │ │ -00025e50: 2020 5275 6e6e 696e 6720 276d 616b 6527 Running 'make' │ │ │ │ │ -00025e60: 2073 686f 756c 6420 7468 7573 2072 6563 should thus rec │ │ │ │ │ -00025e70: 7572 7365 2069 6e74 6f20 2773 7263 2f27 urse into 'src/' │ │ │ │ │ -00025e80: 2061 6c77 6179 732c 2061 6e64 2074 6865 always, and the │ │ │ │ │ -00025e90: 6e20 6d61 7962 650a 696e 2027 6f70 742f n maybe.in 'opt/ │ │ │ │ │ -00025ea0: 272e 0a0a 2020 2048 6f77 6576 6572 2027 '... However ' │ │ │ │ │ -00025eb0: 6d61 6b65 2064 6973 7427 2073 686f 756c make dist' shoul │ │ │ │ │ -00025ec0: 6420 616c 7761 7973 2072 6563 7572 7365 d always recurse │ │ │ │ │ -00025ed0: 2069 6e74 6f20 626f 7468 2027 7372 632f into both 'src/ │ │ │ │ │ -00025ee0: 2720 616e 640a 276f 7074 2f27 2e20 2042 ' and.'opt/'. B │ │ │ │ │ -00025ef0: 6563 6175 7365 2027 6f70 742f 2720 7368 ecause 'opt/' sh │ │ │ │ │ -00025f00: 6f75 6c64 2062 6520 6469 7374 7269 6275 ould be distribu │ │ │ │ │ -00025f10: 7465 6420 6576 656e 2069 6620 6974 2069 ted even if it i │ │ │ │ │ -00025f20: 7320 6e6f 7420 6e65 6564 6564 0a69 6e20 s not needed.in │ │ │ │ │ -00025f30: 7468 6520 6375 7272 656e 7420 636f 6e66 the current conf │ │ │ │ │ -00025f40: 6967 7572 6174 696f 6e2e 2020 5468 6973 iguration. This │ │ │ │ │ -00025f50: 206d 6561 6e73 2027 6f70 742f 4d61 6b65 means 'opt/Make │ │ │ │ │ -00025f60: 6669 6c65 2720 7368 6f75 6c64 2062 650a file' should be. │ │ │ │ │ -00025f70: 6372 6561 7465 6420 5f75 6e63 6f6e 6469 created _uncondi │ │ │ │ │ -00025f80: 7469 6f6e 616c 6c79 5f2e 0a0a 2020 2054 tionally_... T │ │ │ │ │ -00025f90: 6865 7265 2061 7265 2074 776f 2077 6179 here are two way │ │ │ │ │ -00025fa0: 7320 746f 2073 6574 7570 2061 2070 726f s to setup a pro │ │ │ │ │ -00025fb0: 6a65 6374 206c 696b 6520 7468 6973 2e20 ject like this. │ │ │ │ │ -00025fc0: 2059 6f75 2063 616e 2075 7365 0a41 7574 You can use.Aut │ │ │ │ │ -00025fd0: 6f6d 616b 6520 636f 6e64 6974 696f 6e61 omake conditiona │ │ │ │ │ -00025fe0: 6c73 2028 2a6e 6f74 6520 436f 6e64 6974 ls (*note Condit │ │ │ │ │ -00025ff0: 696f 6e61 6c73 3a3a 2920 6f72 2075 7365 ionals::) or use │ │ │ │ │ -00026000: 2041 7574 6f63 6f6e 6620 2741 435f 5355 Autoconf 'AC_SU │ │ │ │ │ -00026010: 4253 5427 0a76 6172 6961 626c 6573 2028 BST'.variables ( │ │ │ │ │ -00026020: 2a6e 6f74 6520 5365 7474 696e 6720 4f75 *note Setting Ou │ │ │ │ │ -00026030: 7470 7574 2056 6172 6961 626c 6573 3a20 tput Variables: │ │ │ │ │ -00026040: 2861 7574 6f63 6f6e 6629 5365 7474 696e (autoconf)Settin │ │ │ │ │ -00026050: 6720 4f75 7470 7574 0a56 6172 6961 626c g Output.Variabl │ │ │ │ │ -00026060: 6573 2e29 2e20 2055 7369 6e67 2041 7574 es.). Using Aut │ │ │ │ │ -00026070: 6f6d 616b 6520 636f 6e64 6974 696f 6e61 omake conditiona │ │ │ │ │ -00026080: 6c73 2069 7320 7468 6520 7072 6566 6572 ls is the prefer │ │ │ │ │ -00026090: 7265 6420 736f 6c75 7469 6f6e 2e0a 4265 red solution..Be │ │ │ │ │ -000260a0: 666f 7265 2077 6520 696c 6c75 7374 7261 fore we illustra │ │ │ │ │ -000260b0: 7465 2074 6865 7365 2074 776f 2070 6f73 te these two pos │ │ │ │ │ -000260c0: 7369 6269 6c69 7469 6573 2c20 6c65 7427 sibilities, let' │ │ │ │ │ -000260d0: 7320 696e 7472 6f64 7563 650a 2744 4953 s introduce.'DIS │ │ │ │ │ -000260e0: 545f 5355 4244 4952 5327 2e0a 0a2a 204d T_SUBDIRS'...* M │ │ │ │ │ -000260f0: 656e 753a 0a0a 2a20 5355 4244 4952 5320 enu:..* SUBDIRS │ │ │ │ │ -00026100: 7673 2044 4953 545f 5355 4244 4952 533a vs DIST_SUBDIRS: │ │ │ │ │ -00026110: 3a20 2020 2020 5477 6f20 7365 7473 206f : Two sets o │ │ │ │ │ -00026120: 6620 6469 7265 6374 6f72 6965 730a 2a20 f directories.* │ │ │ │ │ -00026130: 5375 6264 6972 6563 746f 7269 6573 2077 Subdirectories w │ │ │ │ │ -00026140: 6974 6820 414d 5f43 4f4e 4449 5449 4f4e ith AM_CONDITION │ │ │ │ │ -00026150: 414c 3a3a 2020 5370 6563 6966 7969 6e67 AL:: Specifying │ │ │ │ │ -00026160: 2063 6f6e 6469 7469 6f6e 616c 2073 7562 conditional sub │ │ │ │ │ -00026170: 6469 7265 6374 6f72 6965 730a 2a20 5375 directories.* Su │ │ │ │ │ -00026180: 6264 6972 6563 746f 7269 6573 2077 6974 bdirectories wit │ │ │ │ │ -00026190: 6820 4143 5f53 5542 5354 3a3a 2020 416e h AC_SUBST:: An │ │ │ │ │ -000261a0: 6f74 6865 7220 7761 7920 666f 7220 636f other way for co │ │ │ │ │ -000261b0: 6e64 6974 696f 6e61 6c20 7265 6375 7273 nditional recurs │ │ │ │ │ -000261c0: 696f 6e0a 2a20 556e 636f 6e66 6967 7572 ion.* Unconfigur │ │ │ │ │ -000261d0: 6564 2053 7562 6469 7265 6374 6f72 6965 ed Subdirectorie │ │ │ │ │ -000261e0: 733a 3a20 204e 6f74 2065 7665 6e20 6372 s:: Not even cr │ │ │ │ │ -000261f0: 6561 7469 6e67 2061 2027 4d61 6b65 6669 eating a 'Makefi │ │ │ │ │ -00026200: 6c65 270a 0a1f 0a46 696c 653a 2061 7574 le'....File: aut │ │ │ │ │ -00026210: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -00026220: 2020 4e6f 6465 3a20 5355 4244 4952 5320 Node: SUBDIRS │ │ │ │ │ -00026230: 7673 2044 4953 545f 5355 4244 4952 532c vs DIST_SUBDIRS, │ │ │ │ │ -00026240: 2020 4e65 7874 3a20 5375 6264 6972 6563 Next: Subdirec │ │ │ │ │ -00026250: 746f 7269 6573 2077 6974 6820 414d 5f43 tories with AM_C │ │ │ │ │ -00026260: 4f4e 4449 5449 4f4e 414c 2c20 2055 703a ONDITIONAL, Up: │ │ │ │ │ -00026270: 2043 6f6e 6469 7469 6f6e 616c 2053 7562 Conditional Sub │ │ │ │ │ -00026280: 6469 7265 6374 6f72 6965 730a 0a37 2e32 directories..7.2 │ │ │ │ │ -00026290: 2e31 2027 5355 4244 4952 5327 2076 732e .1 'SUBDIRS' vs. │ │ │ │ │ -000262a0: 2027 4449 5354 5f53 5542 4449 5253 270a 'DIST_SUBDIRS'. │ │ │ │ │ -000262b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00025360: 3d3d 3d3d 3d3d 0a0a 496e 2070 6163 6b61 ======..In packa │ │ │ │ │ +00025370: 6765 7320 7769 7468 2073 7562 6469 7265 ges with subdire │ │ │ │ │ +00025380: 6374 6f72 6965 732c 2074 6865 2074 6f70 ctories, the top │ │ │ │ │ +00025390: 206c 6576 656c 2027 4d61 6b65 6669 6c65 level 'Makefile │ │ │ │ │ +000253a0: 2e61 6d27 206d 7573 7420 7465 6c6c 0a41 .am' must tell.A │ │ │ │ │ +000253b0: 7574 6f6d 616b 6520 7768 6963 6820 7375 utomake which su │ │ │ │ │ +000253c0: 6264 6972 6563 746f 7269 6573 2061 7265 bdirectories are │ │ │ │ │ +000253d0: 2074 6f20 6265 2062 7569 6c74 2e20 2054 to be built. T │ │ │ │ │ +000253e0: 6869 7320 6973 2064 6f6e 6520 7669 6120 his is done via │ │ │ │ │ +000253f0: 7468 650a 2753 5542 4449 5253 2720 7661 the.'SUBDIRS' va │ │ │ │ │ +00025400: 7269 6162 6c65 2e0a 0a20 2020 5468 6520 riable... The │ │ │ │ │ +00025410: 2753 5542 4449 5253 2720 7661 7269 6162 'SUBDIRS' variab │ │ │ │ │ +00025420: 6c65 2068 6f6c 6473 2061 206c 6973 7420 le holds a list │ │ │ │ │ +00025430: 6f66 2073 7562 6469 7265 6374 6f72 6965 of subdirectorie │ │ │ │ │ +00025440: 7320 696e 2077 6869 6368 0a62 7569 6c64 s in which.build │ │ │ │ │ +00025450: 696e 6720 6f66 2076 6172 696f 7573 2073 ing of various s │ │ │ │ │ +00025460: 6f72 7473 2063 616e 206f 6363 7572 2e20 orts can occur. │ │ │ │ │ +00025470: 2054 6865 2072 756c 6573 2066 6f72 206d The rules for m │ │ │ │ │ +00025480: 616e 7920 7461 7267 6574 7320 2865 2e67 any targets (e.g │ │ │ │ │ +00025490: 2e2c 0a27 616c 6c27 2920 696e 2074 6865 .,.'all') in the │ │ │ │ │ +000254a0: 2067 656e 6572 6174 6564 2027 4d61 6b65 generated 'Make │ │ │ │ │ +000254b0: 6669 6c65 2720 7769 6c6c 2072 756e 2063 file' will run c │ │ │ │ │ +000254c0: 6f6d 6d61 6e64 7320 626f 7468 206c 6f63 ommands both loc │ │ │ │ │ +000254d0: 616c 6c79 2061 6e64 2069 6e0a 616c 6c20 ally and in.all │ │ │ │ │ +000254e0: 7370 6563 6966 6965 6420 7375 6264 6972 specified subdir │ │ │ │ │ +000254f0: 6563 746f 7269 6573 2e20 204e 6f74 6520 ectories. Note │ │ │ │ │ +00025500: 7468 6174 2074 6865 2064 6972 6563 746f that the directo │ │ │ │ │ +00025510: 7269 6573 206c 6973 7465 6420 696e 0a27 ries listed in.' │ │ │ │ │ +00025520: 5355 4244 4952 5327 2061 7265 206e 6f74 SUBDIRS' are not │ │ │ │ │ +00025530: 2072 6571 7569 7265 6420 746f 2063 6f6e required to con │ │ │ │ │ +00025540: 7461 696e 2027 4d61 6b65 6669 6c65 2e61 tain 'Makefile.a │ │ │ │ │ +00025550: 6d27 733b 206f 6e6c 7920 274d 616b 6566 m's; only 'Makef │ │ │ │ │ +00025560: 696c 6527 730a 2861 6674 6572 2063 6f6e ile's.(after con │ │ │ │ │ +00025570: 6669 6775 7261 7469 6f6e 292e 2020 5468 figuration). Th │ │ │ │ │ +00025580: 6973 2061 6c6c 6f77 7320 696e 636c 7573 is allows inclus │ │ │ │ │ +00025590: 696f 6e20 6f66 206c 6962 7261 7269 6573 ion of libraries │ │ │ │ │ +000255a0: 2066 726f 6d20 7061 636b 6167 6573 0a74 from packages.t │ │ │ │ │ +000255b0: 6861 7420 646f 206e 6f74 2075 7365 2041 hat do not use A │ │ │ │ │ +000255c0: 7574 6f6d 616b 6520 2873 7563 6820 6173 utomake (such as │ │ │ │ │ +000255d0: 2027 6765 7474 6578 7427 3b20 7365 6520 'gettext'; see │ │ │ │ │ +000255e0: 616c 736f 202a 6e6f 7465 2054 6869 7264 also *note Third │ │ │ │ │ +000255f0: 2d50 6172 7479 0a4d 616b 6566 696c 6573 -Party.Makefiles │ │ │ │ │ +00025600: 3a3a 292e 0a0a 2020 2049 6e20 7061 636b ::)... In pack │ │ │ │ │ +00025610: 6167 6573 2074 6861 7420 7573 6520 7375 ages that use su │ │ │ │ │ +00025620: 6264 6972 6563 746f 7269 6573 2c20 7468 bdirectories, th │ │ │ │ │ +00025630: 6520 746f 702d 6c65 7665 6c20 274d 616b e top-level 'Mak │ │ │ │ │ +00025640: 6566 696c 652e 616d 2720 6973 0a6f 6674 efile.am' is.oft │ │ │ │ │ +00025650: 656e 2076 6572 7920 7368 6f72 742e 2020 en very short. │ │ │ │ │ +00025660: 466f 7220 696e 7374 616e 6365 2c20 6865 For instance, he │ │ │ │ │ +00025670: 7265 2069 7320 7468 6520 274d 616b 6566 re is the 'Makef │ │ │ │ │ +00025680: 696c 652e 616d 2720 6672 6f6d 2074 6865 ile.am' from the │ │ │ │ │ +00025690: 2047 4e55 0a48 656c 6c6f 2064 6973 7472 GNU.Hello distr │ │ │ │ │ +000256a0: 6962 7574 696f 6e3a 0a0a 2020 2020 2045 ibution:.. E │ │ │ │ │ +000256b0: 5854 5241 5f44 4953 5420 3d20 4255 4753 XTRA_DIST = BUGS │ │ │ │ │ +000256c0: 2043 6861 6e67 654c 6f67 2e4f 2052 4541 ChangeLog.O REA │ │ │ │ │ +000256d0: 444d 452d 616c 7068 610a 2020 2020 2053 DME-alpha. S │ │ │ │ │ +000256e0: 5542 4449 5253 203d 2064 6f63 2069 6e74 UBDIRS = doc int │ │ │ │ │ +000256f0: 6c20 706f 2073 7263 2074 6573 7473 0a0a l po src tests.. │ │ │ │ │ +00025700: 2020 2057 6865 6e20 4175 746f 6d61 6b65 When Automake │ │ │ │ │ +00025710: 2069 6e76 6f6b 6573 2027 6d61 6b65 2720 invokes 'make' │ │ │ │ │ +00025720: 696e 2061 2073 7562 6469 7265 6374 6f72 in a subdirector │ │ │ │ │ +00025730: 792c 2069 7420 7573 6573 2074 6865 2076 y, it uses the v │ │ │ │ │ +00025740: 616c 7565 206f 660a 7468 6520 274d 414b alue of.the 'MAK │ │ │ │ │ +00025750: 4527 2076 6172 6961 626c 652e 2020 4974 E' variable. It │ │ │ │ │ +00025760: 2070 6173 7365 7320 7468 6520 7661 6c75 passes the valu │ │ │ │ │ +00025770: 6520 6f66 2074 6865 2076 6172 6961 626c e of the variabl │ │ │ │ │ +00025780: 6520 2741 4d5f 4d41 4b45 464c 4147 5327 e 'AM_MAKEFLAGS' │ │ │ │ │ +00025790: 0a74 6f20 7468 6520 276d 616b 6527 2069 .to the 'make' i │ │ │ │ │ +000257a0: 6e76 6f63 6174 696f 6e3b 2074 6869 7320 nvocation; this │ │ │ │ │ +000257b0: 6361 6e20 6265 2073 6574 2069 6e20 274d can be set in 'M │ │ │ │ │ +000257c0: 616b 6566 696c 652e 616d 2720 6966 2074 akefile.am' if t │ │ │ │ │ +000257d0: 6865 7265 2061 7265 0a66 6c61 6773 2079 here are.flags y │ │ │ │ │ +000257e0: 6f75 206d 7573 7420 616c 7761 7973 2070 ou must always p │ │ │ │ │ +000257f0: 6173 7320 746f 2027 6d61 6b65 272e 0a0a ass to 'make'... │ │ │ │ │ +00025800: 2020 2054 6865 2064 6972 6563 746f 7269 The directori │ │ │ │ │ +00025810: 6573 206d 656e 7469 6f6e 6564 2069 6e20 es mentioned in │ │ │ │ │ +00025820: 2753 5542 4449 5253 2720 6172 6520 7573 'SUBDIRS' are us │ │ │ │ │ +00025830: 7561 6c6c 7920 6469 7265 6374 2063 6869 ually direct chi │ │ │ │ │ +00025840: 6c64 7265 6e20 6f66 0a74 6865 2063 7572 ldren of.the cur │ │ │ │ │ +00025850: 7265 6e74 2064 6972 6563 746f 7279 2c20 rent directory, │ │ │ │ │ +00025860: 6561 6368 2073 7562 6469 7265 6374 6f72 each subdirector │ │ │ │ │ +00025870: 7920 636f 6e74 6169 6e69 6e67 2069 7473 y containing its │ │ │ │ │ +00025880: 206f 776e 0a27 4d61 6b65 6669 6c65 2e61 own.'Makefile.a │ │ │ │ │ +00025890: 6d27 2077 6974 6820 6120 2753 5542 4449 m' with a 'SUBDI │ │ │ │ │ +000258a0: 5253 2720 706f 696e 7469 6e67 2074 6f20 RS' pointing to │ │ │ │ │ +000258b0: 6465 6570 6572 2073 7562 6469 7265 6374 deeper subdirect │ │ │ │ │ +000258c0: 6f72 6965 732e 0a41 7574 6f6d 616b 6520 ories..Automake │ │ │ │ │ +000258d0: 6361 6e20 6265 2075 7365 6420 746f 2063 can be used to c │ │ │ │ │ +000258e0: 6f6e 7374 7275 6374 2070 6163 6b61 6765 onstruct package │ │ │ │ │ +000258f0: 7320 6f66 2061 7262 6974 7261 7279 2064 s of arbitrary d │ │ │ │ │ +00025900: 6570 7468 2074 6869 7320 7761 792e 0a0a epth this way... │ │ │ │ │ +00025910: 2020 2042 7920 6465 6661 756c 742c 2041 By default, A │ │ │ │ │ +00025920: 7574 6f6d 616b 6520 6765 6e65 7261 7465 utomake generate │ │ │ │ │ +00025930: 7320 274d 616b 6566 696c 6573 2720 7468 s 'Makefiles' th │ │ │ │ │ +00025940: 6174 2077 6f72 6b20 6465 7074 682d 6669 at work depth-fi │ │ │ │ │ +00025950: 7273 7420 696e 0a70 6f73 7466 6978 206f rst in.postfix o │ │ │ │ │ +00025960: 7264 6572 3a20 7468 6520 7375 6264 6972 rder: the subdir │ │ │ │ │ +00025970: 6563 746f 7269 6573 2061 7265 2062 7569 ectories are bui │ │ │ │ │ +00025980: 6c74 2062 6566 6f72 6520 7468 6520 6375 lt before the cu │ │ │ │ │ +00025990: 7272 656e 740a 6469 7265 6374 6f72 792e rrent.directory. │ │ │ │ │ +000259a0: 2020 486f 7765 7665 722c 2069 7420 6973 However, it is │ │ │ │ │ +000259b0: 2070 6f73 7369 626c 6520 746f 2063 6861 possible to cha │ │ │ │ │ +000259c0: 6e67 6520 7468 6973 206f 7264 6572 696e nge this orderin │ │ │ │ │ +000259d0: 672e 2020 596f 7520 6361 6e20 646f 0a74 g. You can do.t │ │ │ │ │ +000259e0: 6869 7320 6279 2070 7574 7469 6e67 2027 his by putting ' │ │ │ │ │ +000259f0: 2e27 2069 6e74 6f20 2753 5542 4449 5253 .' into 'SUBDIRS │ │ │ │ │ +00025a00: 272e 2020 466f 7220 696e 7374 616e 6365 '. For instance │ │ │ │ │ +00025a10: 2c20 7075 7474 696e 6720 272e 2720 6669 , putting '.' fi │ │ │ │ │ +00025a20: 7273 740a 7769 6c6c 2063 6175 7365 2061 rst.will cause a │ │ │ │ │ +00025a30: 2070 7265 6669 7820 6f72 6465 7269 6e67 prefix ordering │ │ │ │ │ +00025a40: 206f 6620 6469 7265 6374 6f72 6965 732e of directories. │ │ │ │ │ +00025a50: 0a0a 2020 2055 7369 6e67 0a0a 2020 2020 .. Using.. │ │ │ │ │ +00025a60: 2053 5542 4449 5253 203d 206c 6962 2073 SUBDIRS = lib s │ │ │ │ │ +00025a70: 7263 202e 2074 6573 740a 0a77 696c 6c20 rc . test..will │ │ │ │ │ +00025a80: 6361 7573 6520 276c 6962 2f27 2074 6f20 cause 'lib/' to │ │ │ │ │ +00025a90: 6265 2062 7569 6c74 2062 6566 6f72 6520 be built before │ │ │ │ │ +00025aa0: 2773 7263 2f27 2c20 7468 656e 2074 6865 'src/', then the │ │ │ │ │ +00025ab0: 2063 7572 7265 6e74 2064 6972 6563 746f current directo │ │ │ │ │ +00025ac0: 7279 0a77 696c 6c20 6265 2062 7569 6c74 ry.will be built │ │ │ │ │ +00025ad0: 2c20 6669 6e61 6c6c 7920 7468 6520 2774 , finally the 't │ │ │ │ │ +00025ae0: 6573 742f 2720 6469 7265 6374 6f72 7920 est/' directory │ │ │ │ │ +00025af0: 7769 6c6c 2062 6520 6275 696c 742e 2020 will be built. │ │ │ │ │ +00025b00: 4974 2069 730a 6375 7374 6f6d 6172 7920 It is.customary │ │ │ │ │ +00025b10: 746f 2061 7272 616e 6765 2074 6573 7420 to arrange test │ │ │ │ │ +00025b20: 6469 7265 6374 6f72 6965 7320 746f 2062 directories to b │ │ │ │ │ +00025b30: 6520 6275 696c 7420 6166 7465 7220 6576 e built after ev │ │ │ │ │ +00025b40: 6572 7974 6869 6e67 2065 6c73 650a 7369 erything else.si │ │ │ │ │ +00025b50: 6e63 6520 7468 6579 2061 7265 206d 6561 nce they are mea │ │ │ │ │ +00025b60: 6e74 2074 6f20 7465 7374 2077 6861 7420 nt to test what │ │ │ │ │ +00025b70: 6861 7320 6265 656e 2063 6f6e 7374 7275 has been constru │ │ │ │ │ +00025b80: 6374 6564 2e0a 0a20 2020 416c 6c20 2763 cted... All 'c │ │ │ │ │ +00025b90: 6c65 616e 2720 7275 6c65 7320 6172 6520 lean' rules are │ │ │ │ │ +00025ba0: 7275 6e20 696e 2072 6576 6572 7365 206f run in reverse o │ │ │ │ │ +00025bb0: 7264 6572 206f 6620 6275 696c 6420 7275 rder of build ru │ │ │ │ │ +00025bc0: 6c65 732e 0a0a 1f0a 4669 6c65 3a20 6175 les.....File: au │ │ │ │ │ +00025bd0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00025be0: 2c20 204e 6f64 653a 2043 6f6e 6469 7469 , Node: Conditi │ │ │ │ │ +00025bf0: 6f6e 616c 2053 7562 6469 7265 6374 6f72 onal Subdirector │ │ │ │ │ +00025c00: 6965 732c 2020 4e65 7874 3a20 416c 7465 ies, Next: Alte │ │ │ │ │ +00025c10: 726e 6174 6976 652c 2020 5072 6576 3a20 rnative, Prev: │ │ │ │ │ +00025c20: 5375 6264 6972 6563 746f 7269 6573 2c20 Subdirectories, │ │ │ │ │ +00025c30: 2055 703a 2044 6972 6563 746f 7269 6573 Up: Directories │ │ │ │ │ +00025c40: 0a0a 372e 3220 436f 6e64 6974 696f 6e61 ..7.2 Conditiona │ │ │ │ │ +00025c50: 6c20 5375 6264 6972 6563 746f 7269 6573 l Subdirectories │ │ │ │ │ +00025c60: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +00025c70: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00025c80: 0a49 7420 6973 2070 6f73 7369 626c 6520 .It is possible │ │ │ │ │ +00025c90: 746f 2064 6566 696e 6520 7468 6520 2753 to define the 'S │ │ │ │ │ +00025ca0: 5542 4449 5253 2720 7661 7269 6162 6c65 UBDIRS' variable │ │ │ │ │ +00025cb0: 2063 6f6e 6469 7469 6f6e 616c 6c79 2069 conditionally i │ │ │ │ │ +00025cc0: 662c 206c 696b 650a 696e 2074 6865 2063 f, like.in the c │ │ │ │ │ +00025cd0: 6173 6520 6f66 2047 4e55 2049 6e65 7475 ase of GNU Inetu │ │ │ │ │ +00025ce0: 7469 6c73 2c20 796f 7520 7761 6e74 2074 tils, you want t │ │ │ │ │ +00025cf0: 6f20 6f6e 6c79 2062 7569 6c64 2061 2073 o only build a s │ │ │ │ │ +00025d00: 7562 7365 7420 6f66 2074 6865 0a65 6e74 ubset of the.ent │ │ │ │ │ +00025d10: 6972 6520 7061 636b 6167 652e 0a0a 2020 ire package... │ │ │ │ │ +00025d20: 2054 6f20 696c 6c75 7374 7261 7465 2068 To illustrate h │ │ │ │ │ +00025d30: 6f77 2074 6869 7320 776f 726b 732c 206c ow this works, l │ │ │ │ │ +00025d40: 6574 2773 2061 7373 756d 6520 7765 2068 et's assume we h │ │ │ │ │ +00025d50: 6176 6520 7477 6f20 6469 7265 6374 6f72 ave two director │ │ │ │ │ +00025d60: 6965 730a 2773 7263 2f27 2061 6e64 2027 ies.'src/' and ' │ │ │ │ │ +00025d70: 6f70 742f 272e 2020 2773 7263 2f27 2073 opt/'. 'src/' s │ │ │ │ │ +00025d80: 686f 756c 6420 616c 7761 7973 2062 6520 hould always be │ │ │ │ │ +00025d90: 6275 696c 742c 2062 7574 2077 6520 7761 built, but we wa │ │ │ │ │ +00025da0: 6e74 2074 6f20 6465 6369 6465 0a69 6e20 nt to decide.in │ │ │ │ │ +00025db0: 2763 6f6e 6669 6775 7265 2720 7768 6574 'configure' whet │ │ │ │ │ +00025dc0: 6865 7220 276f 7074 2f27 2077 696c 6c20 her 'opt/' will │ │ │ │ │ +00025dd0: 6265 2062 7569 6c74 206f 7220 6e6f 742e be built or not. │ │ │ │ │ +00025de0: 2020 2846 6f72 2074 6869 7320 6578 616d (For this exam │ │ │ │ │ +00025df0: 706c 650a 7765 2077 696c 6c20 6173 7375 ple.we will assu │ │ │ │ │ +00025e00: 6d65 2074 6861 7420 276f 7074 2f27 2073 me that 'opt/' s │ │ │ │ │ +00025e10: 686f 756c 6420 6265 2062 7569 6c74 2077 hould be built w │ │ │ │ │ +00025e20: 6865 6e20 7468 6520 7661 7269 6162 6c65 hen the variable │ │ │ │ │ +00025e30: 2027 2477 616e 745f 6f70 7427 0a77 6173 '$want_opt'.was │ │ │ │ │ +00025e40: 2073 6574 2074 6f20 2779 6573 272e 290a set to 'yes'.). │ │ │ │ │ +00025e50: 0a20 2020 5275 6e6e 696e 6720 276d 616b . Running 'mak │ │ │ │ │ +00025e60: 6527 2073 686f 756c 6420 7468 7573 2072 e' should thus r │ │ │ │ │ +00025e70: 6563 7572 7365 2069 6e74 6f20 2773 7263 ecurse into 'src │ │ │ │ │ +00025e80: 2f27 2061 6c77 6179 732c 2061 6e64 2074 /' always, and t │ │ │ │ │ +00025e90: 6865 6e20 6d61 7962 650a 696e 2027 6f70 hen maybe.in 'op │ │ │ │ │ +00025ea0: 742f 272e 0a0a 2020 2048 6f77 6576 6572 t/'... However │ │ │ │ │ +00025eb0: 2027 6d61 6b65 2064 6973 7427 2073 686f 'make dist' sho │ │ │ │ │ +00025ec0: 756c 6420 616c 7761 7973 2072 6563 7572 uld always recur │ │ │ │ │ +00025ed0: 7365 2069 6e74 6f20 626f 7468 2027 7372 se into both 'sr │ │ │ │ │ +00025ee0: 632f 2720 616e 640a 276f 7074 2f27 2e20 c/' and.'opt/'. │ │ │ │ │ +00025ef0: 2042 6563 6175 7365 2027 6f70 742f 2720 Because 'opt/' │ │ │ │ │ +00025f00: 7368 6f75 6c64 2062 6520 6469 7374 7269 should be distri │ │ │ │ │ +00025f10: 6275 7465 6420 6576 656e 2069 6620 6974 buted even if it │ │ │ │ │ +00025f20: 2069 7320 6e6f 7420 6e65 6564 6564 0a69 is not needed.i │ │ │ │ │ +00025f30: 6e20 7468 6520 6375 7272 656e 7420 636f n the current co │ │ │ │ │ +00025f40: 6e66 6967 7572 6174 696f 6e2e 2020 5468 nfiguration. Th │ │ │ │ │ +00025f50: 6973 206d 6561 6e73 2027 6f70 742f 4d61 is means 'opt/Ma │ │ │ │ │ +00025f60: 6b65 6669 6c65 2720 7368 6f75 6c64 2062 kefile' should b │ │ │ │ │ +00025f70: 650a 6372 6561 7465 6420 5f75 6e63 6f6e e.created _uncon │ │ │ │ │ +00025f80: 6469 7469 6f6e 616c 6c79 5f2e 0a0a 2020 ditionally_... │ │ │ │ │ +00025f90: 2054 6865 7265 2061 7265 2074 776f 2077 There are two w │ │ │ │ │ +00025fa0: 6179 7320 746f 2073 6574 7570 2061 2070 ays to setup a p │ │ │ │ │ +00025fb0: 726f 6a65 6374 206c 696b 6520 7468 6973 roject like this │ │ │ │ │ +00025fc0: 2e20 2059 6f75 2063 616e 2075 7365 0a41 . You can use.A │ │ │ │ │ +00025fd0: 7574 6f6d 616b 6520 636f 6e64 6974 696f utomake conditio │ │ │ │ │ +00025fe0: 6e61 6c73 2028 2a6e 6f74 6520 436f 6e64 nals (*note Cond │ │ │ │ │ +00025ff0: 6974 696f 6e61 6c73 3a3a 2920 6f72 2075 itionals::) or u │ │ │ │ │ +00026000: 7365 2041 7574 6f63 6f6e 6620 2741 435f se Autoconf 'AC_ │ │ │ │ │ +00026010: 5355 4253 5427 0a76 6172 6961 626c 6573 SUBST'.variables │ │ │ │ │ +00026020: 2028 2a6e 6f74 6520 5365 7474 696e 6720 (*note Setting │ │ │ │ │ +00026030: 4f75 7470 7574 2056 6172 6961 626c 6573 Output Variables │ │ │ │ │ +00026040: 3a20 2861 7574 6f63 6f6e 6629 5365 7474 : (autoconf)Sett │ │ │ │ │ +00026050: 696e 6720 4f75 7470 7574 0a56 6172 6961 ing Output.Varia │ │ │ │ │ +00026060: 626c 6573 2e29 2e20 2055 7369 6e67 2041 bles.). Using A │ │ │ │ │ +00026070: 7574 6f6d 616b 6520 636f 6e64 6974 696f utomake conditio │ │ │ │ │ +00026080: 6e61 6c73 2069 7320 7468 6520 7072 6566 nals is the pref │ │ │ │ │ +00026090: 6572 7265 6420 736f 6c75 7469 6f6e 2e0a erred solution.. │ │ │ │ │ +000260a0: 4265 666f 7265 2077 6520 696c 6c75 7374 Before we illust │ │ │ │ │ +000260b0: 7261 7465 2074 6865 7365 2074 776f 2070 rate these two p │ │ │ │ │ +000260c0: 6f73 7369 6269 6c69 7469 6573 2c20 6c65 ossibilities, le │ │ │ │ │ +000260d0: 7427 7320 696e 7472 6f64 7563 650a 2744 t's introduce.'D │ │ │ │ │ +000260e0: 4953 545f 5355 4244 4952 5327 2e0a 0a2a IST_SUBDIRS'...* │ │ │ │ │ +000260f0: 204d 656e 753a 0a0a 2a20 5355 4244 4952 Menu:..* SUBDIR │ │ │ │ │ +00026100: 5320 7673 2044 4953 545f 5355 4244 4952 S vs DIST_SUBDIR │ │ │ │ │ +00026110: 533a 3a20 2020 2020 5477 6f20 7365 7473 S:: Two sets │ │ │ │ │ +00026120: 206f 6620 6469 7265 6374 6f72 6965 730a of directories. │ │ │ │ │ +00026130: 2a20 5375 6264 6972 6563 746f 7269 6573 * Subdirectories │ │ │ │ │ +00026140: 2077 6974 6820 414d 5f43 4f4e 4449 5449 with AM_CONDITI │ │ │ │ │ +00026150: 4f4e 414c 3a3a 2020 5370 6563 6966 7969 ONAL:: Specifyi │ │ │ │ │ +00026160: 6e67 2063 6f6e 6469 7469 6f6e 616c 2073 ng conditional s │ │ │ │ │ +00026170: 7562 6469 7265 6374 6f72 6965 730a 2a20 ubdirectories.* │ │ │ │ │ +00026180: 5375 6264 6972 6563 746f 7269 6573 2077 Subdirectories w │ │ │ │ │ +00026190: 6974 6820 4143 5f53 5542 5354 3a3a 2020 ith AC_SUBST:: │ │ │ │ │ +000261a0: 416e 6f74 6865 7220 7761 7920 666f 7220 Another way for │ │ │ │ │ +000261b0: 636f 6e64 6974 696f 6e61 6c20 7265 6375 conditional recu │ │ │ │ │ +000261c0: 7273 696f 6e0a 2a20 556e 636f 6e66 6967 rsion.* Unconfig │ │ │ │ │ +000261d0: 7572 6564 2053 7562 6469 7265 6374 6f72 ured Subdirector │ │ │ │ │ +000261e0: 6965 733a 3a20 204e 6f74 2065 7665 6e20 ies:: Not even │ │ │ │ │ +000261f0: 6372 6561 7469 6e67 2061 2027 4d61 6b65 creating a 'Make │ │ │ │ │ +00026200: 6669 6c65 270a 0a1f 0a46 696c 653a 2061 file'....File: a │ │ │ │ │ +00026210: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +00026220: 6f2c 2020 4e6f 6465 3a20 5355 4244 4952 o, Node: SUBDIR │ │ │ │ │ +00026230: 5320 7673 2044 4953 545f 5355 4244 4952 S vs DIST_SUBDIR │ │ │ │ │ +00026240: 532c 2020 4e65 7874 3a20 5375 6264 6972 S, Next: Subdir │ │ │ │ │ +00026250: 6563 746f 7269 6573 2077 6974 6820 414d ectories with AM │ │ │ │ │ +00026260: 5f43 4f4e 4449 5449 4f4e 414c 2c20 2055 _CONDITIONAL, U │ │ │ │ │ +00026270: 703a 2043 6f6e 6469 7469 6f6e 616c 2053 p: Conditional S │ │ │ │ │ +00026280: 7562 6469 7265 6374 6f72 6965 730a 0a37 ubdirectories..7 │ │ │ │ │ +00026290: 2e32 2e31 2027 5355 4244 4952 5327 2076 .2.1 'SUBDIRS' v │ │ │ │ │ +000262a0: 732e 2027 4449 5354 5f53 5542 4449 5253 s. 'DIST_SUBDIRS │ │ │ │ │ +000262b0: 270a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d '.-------------- │ │ │ │ │ 000262c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000262d0: 2d2d 0a0a 4175 746f 6d61 6b65 2063 6f6e --..Automake con │ │ │ │ │ -000262e0: 7369 6465 7273 2074 776f 2073 6574 7320 siders two sets │ │ │ │ │ -000262f0: 6f66 2064 6972 6563 746f 7269 6573 2c20 of directories, │ │ │ │ │ -00026300: 6465 6669 6e65 6420 6279 2074 6865 2076 defined by the v │ │ │ │ │ -00026310: 6172 6961 626c 6573 0a27 5355 4244 4952 ariables.'SUBDIR │ │ │ │ │ -00026320: 5327 2061 6e64 2027 4449 5354 5f53 5542 S' and 'DIST_SUB │ │ │ │ │ -00026330: 4449 5253 272e 0a0a 2020 2027 5355 4244 DIRS'... 'SUBD │ │ │ │ │ -00026340: 4952 5327 2063 6f6e 7461 696e 7320 7468 IRS' contains th │ │ │ │ │ -00026350: 6520 7375 6264 6972 6563 746f 7269 6573 e subdirectories │ │ │ │ │ -00026360: 206f 6620 7468 6520 6375 7272 656e 7420 of the current │ │ │ │ │ -00026370: 6469 7265 6374 6f72 7920 7468 6174 0a6d directory that.m │ │ │ │ │ -00026380: 7573 7420 6265 2062 7569 6c74 2028 2a6e ust be built (*n │ │ │ │ │ -00026390: 6f74 6520 5375 6264 6972 6563 746f 7269 ote Subdirectori │ │ │ │ │ -000263a0: 6573 3a3a 292e 2020 4974 206d 7573 7420 es::). It must │ │ │ │ │ -000263b0: 6265 2064 6566 696e 6564 206d 616e 7561 be defined manua │ │ │ │ │ -000263c0: 6c6c 793b 0a41 7574 6f6d 616b 6520 7769 lly;.Automake wi │ │ │ │ │ -000263d0: 6c6c 206e 6576 6572 2067 7565 7373 2061 ll never guess a │ │ │ │ │ -000263e0: 2064 6972 6563 746f 7279 2069 7320 746f directory is to │ │ │ │ │ -000263f0: 2062 6520 6275 696c 742e 2020 4173 2077 be built. As w │ │ │ │ │ -00026400: 6520 7769 6c6c 2073 6565 2069 6e0a 7468 e will see in.th │ │ │ │ │ -00026410: 6520 6e65 7874 2074 776f 2073 6563 7469 e next two secti │ │ │ │ │ -00026420: 6f6e 732c 2069 7420 6973 2070 6f73 7369 ons, it is possi │ │ │ │ │ -00026430: 626c 6520 746f 2064 6566 696e 6520 6974 ble to define it │ │ │ │ │ -00026440: 2063 6f6e 6469 7469 6f6e 616c 6c79 2073 conditionally s │ │ │ │ │ -00026450: 6f20 7468 6174 0a73 6f6d 6520 6469 7265 o that.some dire │ │ │ │ │ -00026460: 6374 6f72 7920 7769 6c6c 2062 6520 6f6d ctory will be om │ │ │ │ │ -00026470: 6974 7465 6420 6672 6f6d 2074 6865 2062 itted from the b │ │ │ │ │ -00026480: 7569 6c64 2e0a 0a20 2020 2744 4953 545f uild... 'DIST_ │ │ │ │ │ -00026490: 5355 4244 4952 5327 2069 7320 7573 6564 SUBDIRS' is used │ │ │ │ │ -000264a0: 2069 6e20 7275 6c65 7320 7468 6174 206e in rules that n │ │ │ │ │ -000264b0: 6565 6420 746f 2072 6563 7572 7365 2069 eed to recurse i │ │ │ │ │ -000264c0: 6e20 616c 6c0a 6469 7265 6374 6f72 6965 n all.directorie │ │ │ │ │ -000264d0: 732c 2065 7665 6e20 7468 6f73 6520 7468 s, even those th │ │ │ │ │ -000264e0: 6174 2068 6176 6520 6265 656e 2063 6f6e at have been con │ │ │ │ │ -000264f0: 6469 7469 6f6e 616c 6c79 206c 6566 7420 ditionally left │ │ │ │ │ -00026500: 6f75 7420 6f66 2074 6865 0a62 7569 6c64 out of the.build │ │ │ │ │ -00026510: 2e20 2052 6563 616c 6c20 6f75 7220 6578 . Recall our ex │ │ │ │ │ -00026520: 616d 706c 6520 7768 6572 6520 7765 206d ample where we m │ │ │ │ │ -00026530: 6179 206e 6f74 2077 616e 7420 746f 2062 ay not want to b │ │ │ │ │ -00026540: 7569 6c64 2073 7562 6469 7265 6374 6f72 uild subdirector │ │ │ │ │ -00026550: 790a 276f 7074 2f27 2c20 6275 7420 7965 y.'opt/', but ye │ │ │ │ │ -00026560: 7420 7765 2077 616e 7420 746f 2064 6973 t we want to dis │ │ │ │ │ -00026570: 7472 6962 7574 6520 6974 3f20 2054 6869 tribute it? Thi │ │ │ │ │ -00026580: 7320 6973 2077 6865 7265 2027 4449 5354 s is where 'DIST │ │ │ │ │ -00026590: 5f53 5542 4449 5253 270a 636f 6d65 7320 _SUBDIRS'.comes │ │ │ │ │ -000265a0: 696e 746f 2070 6c61 793a 2027 6f70 7427 into play: 'opt' │ │ │ │ │ -000265b0: 206d 6179 206e 6f74 2061 7070 6561 7220 may not appear │ │ │ │ │ -000265c0: 696e 2027 5355 4244 4952 5327 2c20 6275 in 'SUBDIRS', bu │ │ │ │ │ -000265d0: 7420 6974 206d 7573 7420 6170 7065 6172 t it must appear │ │ │ │ │ -000265e0: 0a69 6e20 2744 4953 545f 5355 4244 4952 .in 'DIST_SUBDIR │ │ │ │ │ -000265f0: 5327 2e0a 0a20 2020 5072 6563 6973 656c S'... Precisel │ │ │ │ │ -00026600: 792c 2027 4449 5354 5f53 5542 4449 5253 y, 'DIST_SUBDIRS │ │ │ │ │ -00026610: 2720 6973 2075 7365 6420 6279 2027 6d61 ' is used by 'ma │ │ │ │ │ -00026620: 6b65 206d 6169 6e74 6169 6e65 722d 636c ke maintainer-cl │ │ │ │ │ -00026630: 6561 6e27 2c20 276d 616b 650a 6469 7374 ean', 'make.dist │ │ │ │ │ -00026640: 636c 6561 6e27 2061 6e64 2027 6d61 6b65 clean' and 'make │ │ │ │ │ -00026650: 2064 6973 7427 2e20 2041 6c6c 206f 7468 dist'. All oth │ │ │ │ │ -00026660: 6572 2072 6563 7572 7369 7665 2072 756c er recursive rul │ │ │ │ │ -00026670: 6573 2075 7365 2027 5355 4244 4952 5327 es use 'SUBDIRS' │ │ │ │ │ -00026680: 2e0a 0a20 2020 4966 2027 5355 4244 4952 ... If 'SUBDIR │ │ │ │ │ -00026690: 5327 2069 7320 6465 6669 6e65 6420 636f S' is defined co │ │ │ │ │ -000266a0: 6e64 6974 696f 6e61 6c6c 7920 7573 696e nditionally usin │ │ │ │ │ -000266b0: 6720 4175 746f 6d61 6b65 2063 6f6e 6469 g Automake condi │ │ │ │ │ -000266c0: 7469 6f6e 616c 732c 0a41 7574 6f6d 616b tionals,.Automak │ │ │ │ │ -000266d0: 6520 7769 6c6c 2064 6566 696e 6520 2744 e will define 'D │ │ │ │ │ -000266e0: 4953 545f 5355 4244 4952 5327 2061 7574 IST_SUBDIRS' aut │ │ │ │ │ -000266f0: 6f6d 6174 6963 616c 6c79 2066 726f 6d20 omatically from │ │ │ │ │ -00026700: 7468 6520 706f 7373 6962 6c65 0a76 616c the possible.val │ │ │ │ │ -00026710: 7565 7320 6f66 2027 5355 4244 4952 5327 ues of 'SUBDIRS' │ │ │ │ │ -00026720: 2069 6e20 616c 6c20 636f 6e64 6974 696f in all conditio │ │ │ │ │ -00026730: 6e73 2e0a 0a20 2020 4966 2027 5355 4244 ns... If 'SUBD │ │ │ │ │ -00026740: 4952 5327 2063 6f6e 7461 696e 7320 2741 IRS' contains 'A │ │ │ │ │ -00026750: 435f 5355 4253 5427 2076 6172 6961 626c C_SUBST' variabl │ │ │ │ │ -00026760: 6573 2c20 2744 4953 545f 5355 4244 4952 es, 'DIST_SUBDIR │ │ │ │ │ -00026770: 5327 2077 696c 6c20 6e6f 740a 6265 2064 S' will not.be d │ │ │ │ │ -00026780: 6566 696e 6564 2063 6f72 7265 6374 6c79 efined correctly │ │ │ │ │ -00026790: 2062 6563 6175 7365 2041 7574 6f6d 616b because Automak │ │ │ │ │ -000267a0: 6520 646f 6573 206e 6f74 206b 6e6f 7720 e does not know │ │ │ │ │ -000267b0: 7468 6520 706f 7373 6962 6c65 2076 616c the possible val │ │ │ │ │ -000267c0: 7565 730a 6f66 2074 6865 7365 2076 6172 ues.of these var │ │ │ │ │ -000267d0: 6961 626c 6573 2e20 2049 6e20 7468 6973 iables. In this │ │ │ │ │ -000267e0: 2063 6173 6520 2744 4953 545f 5355 4244 case 'DIST_SUBD │ │ │ │ │ -000267f0: 4952 5327 206e 6565 6473 2074 6f20 6265 IRS' needs to be │ │ │ │ │ -00026800: 2064 6566 696e 6564 0a6d 616e 7561 6c6c defined.manuall │ │ │ │ │ -00026810: 792e 0a0a 1f0a 4669 6c65 3a20 6175 746f y.....File: auto │ │ │ │ │ -00026820: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00026830: 204e 6f64 653a 2053 7562 6469 7265 6374 Node: Subdirect │ │ │ │ │ -00026840: 6f72 6965 7320 7769 7468 2041 4d5f 434f ories with AM_CO │ │ │ │ │ -00026850: 4e44 4954 494f 4e41 4c2c 2020 4e65 7874 NDITIONAL, Next │ │ │ │ │ -00026860: 3a20 5375 6264 6972 6563 746f 7269 6573 : Subdirectories │ │ │ │ │ -00026870: 2077 6974 6820 4143 5f53 5542 5354 2c20 with AC_SUBST, │ │ │ │ │ -00026880: 2050 7265 763a 2053 5542 4449 5253 2076 Prev: SUBDIRS v │ │ │ │ │ -00026890: 7320 4449 5354 5f53 5542 4449 5253 2c20 s DIST_SUBDIRS, │ │ │ │ │ -000268a0: 2055 703a 2043 6f6e 6469 7469 6f6e 616c Up: Conditional │ │ │ │ │ -000268b0: 2053 7562 6469 7265 6374 6f72 6965 730a Subdirectories. │ │ │ │ │ -000268c0: 0a37 2e32 2e32 2053 7562 6469 7265 6374 .7.2.2 Subdirect │ │ │ │ │ -000268d0: 6f72 6965 7320 7769 7468 2027 414d 5f43 ories with 'AM_C │ │ │ │ │ -000268e0: 4f4e 4449 5449 4f4e 414c 270a 2d2d 2d2d ONDITIONAL'.---- │ │ │ │ │ +000262d0: 2d2d 2d2d 0a0a 4175 746f 6d61 6b65 2063 ----..Automake c │ │ │ │ │ +000262e0: 6f6e 7369 6465 7273 2074 776f 2073 6574 onsiders two set │ │ │ │ │ +000262f0: 7320 6f66 2064 6972 6563 746f 7269 6573 s of directories │ │ │ │ │ +00026300: 2c20 6465 6669 6e65 6420 6279 2074 6865 , defined by the │ │ │ │ │ +00026310: 2076 6172 6961 626c 6573 0a27 5355 4244 variables.'SUBD │ │ │ │ │ +00026320: 4952 5327 2061 6e64 2027 4449 5354 5f53 IRS' and 'DIST_S │ │ │ │ │ +00026330: 5542 4449 5253 272e 0a0a 2020 2027 5355 UBDIRS'... 'SU │ │ │ │ │ +00026340: 4244 4952 5327 2063 6f6e 7461 696e 7320 BDIRS' contains │ │ │ │ │ +00026350: 7468 6520 7375 6264 6972 6563 746f 7269 the subdirectori │ │ │ │ │ +00026360: 6573 206f 6620 7468 6520 6375 7272 656e es of the curren │ │ │ │ │ +00026370: 7420 6469 7265 6374 6f72 7920 7468 6174 t directory that │ │ │ │ │ +00026380: 0a6d 7573 7420 6265 2062 7569 6c74 2028 .must be built ( │ │ │ │ │ +00026390: 2a6e 6f74 6520 5375 6264 6972 6563 746f *note Subdirecto │ │ │ │ │ +000263a0: 7269 6573 3a3a 292e 2020 4974 206d 7573 ries::). It mus │ │ │ │ │ +000263b0: 7420 6265 2064 6566 696e 6564 206d 616e t be defined man │ │ │ │ │ +000263c0: 7561 6c6c 793b 0a41 7574 6f6d 616b 6520 ually;.Automake │ │ │ │ │ +000263d0: 7769 6c6c 206e 6576 6572 2067 7565 7373 will never guess │ │ │ │ │ +000263e0: 2061 2064 6972 6563 746f 7279 2069 7320 a directory is │ │ │ │ │ +000263f0: 746f 2062 6520 6275 696c 742e 2020 4173 to be built. As │ │ │ │ │ +00026400: 2077 6520 7769 6c6c 2073 6565 2069 6e0a we will see in. │ │ │ │ │ +00026410: 7468 6520 6e65 7874 2074 776f 2073 6563 the next two sec │ │ │ │ │ +00026420: 7469 6f6e 732c 2069 7420 6973 2070 6f73 tions, it is pos │ │ │ │ │ +00026430: 7369 626c 6520 746f 2064 6566 696e 6520 sible to define │ │ │ │ │ +00026440: 6974 2063 6f6e 6469 7469 6f6e 616c 6c79 it conditionally │ │ │ │ │ +00026450: 2073 6f20 7468 6174 0a73 6f6d 6520 6469 so that.some di │ │ │ │ │ +00026460: 7265 6374 6f72 7920 7769 6c6c 2062 6520 rectory will be │ │ │ │ │ +00026470: 6f6d 6974 7465 6420 6672 6f6d 2074 6865 omitted from the │ │ │ │ │ +00026480: 2062 7569 6c64 2e0a 0a20 2020 2744 4953 build... 'DIS │ │ │ │ │ +00026490: 545f 5355 4244 4952 5327 2069 7320 7573 T_SUBDIRS' is us │ │ │ │ │ +000264a0: 6564 2069 6e20 7275 6c65 7320 7468 6174 ed in rules that │ │ │ │ │ +000264b0: 206e 6565 6420 746f 2072 6563 7572 7365 need to recurse │ │ │ │ │ +000264c0: 2069 6e20 616c 6c0a 6469 7265 6374 6f72 in all.director │ │ │ │ │ +000264d0: 6965 732c 2065 7665 6e20 7468 6f73 6520 ies, even those │ │ │ │ │ +000264e0: 7468 6174 2068 6176 6520 6265 656e 2063 that have been c │ │ │ │ │ +000264f0: 6f6e 6469 7469 6f6e 616c 6c79 206c 6566 onditionally lef │ │ │ │ │ +00026500: 7420 6f75 7420 6f66 2074 6865 0a62 7569 t out of the.bui │ │ │ │ │ +00026510: 6c64 2e20 2052 6563 616c 6c20 6f75 7220 ld. Recall our │ │ │ │ │ +00026520: 6578 616d 706c 6520 7768 6572 6520 7765 example where we │ │ │ │ │ +00026530: 206d 6179 206e 6f74 2077 616e 7420 746f may not want to │ │ │ │ │ +00026540: 2062 7569 6c64 2073 7562 6469 7265 6374 build subdirect │ │ │ │ │ +00026550: 6f72 790a 276f 7074 2f27 2c20 6275 7420 ory.'opt/', but │ │ │ │ │ +00026560: 7965 7420 7765 2077 616e 7420 746f 2064 yet we want to d │ │ │ │ │ +00026570: 6973 7472 6962 7574 6520 6974 3f20 2054 istribute it? T │ │ │ │ │ +00026580: 6869 7320 6973 2077 6865 7265 2027 4449 his is where 'DI │ │ │ │ │ +00026590: 5354 5f53 5542 4449 5253 270a 636f 6d65 ST_SUBDIRS'.come │ │ │ │ │ +000265a0: 7320 696e 746f 2070 6c61 793a 2027 6f70 s into play: 'op │ │ │ │ │ +000265b0: 7427 206d 6179 206e 6f74 2061 7070 6561 t' may not appea │ │ │ │ │ +000265c0: 7220 696e 2027 5355 4244 4952 5327 2c20 r in 'SUBDIRS', │ │ │ │ │ +000265d0: 6275 7420 6974 206d 7573 7420 6170 7065 but it must appe │ │ │ │ │ +000265e0: 6172 0a69 6e20 2744 4953 545f 5355 4244 ar.in 'DIST_SUBD │ │ │ │ │ +000265f0: 4952 5327 2e0a 0a20 2020 5072 6563 6973 IRS'... Precis │ │ │ │ │ +00026600: 656c 792c 2027 4449 5354 5f53 5542 4449 ely, 'DIST_SUBDI │ │ │ │ │ +00026610: 5253 2720 6973 2075 7365 6420 6279 2027 RS' is used by ' │ │ │ │ │ +00026620: 6d61 6b65 206d 6169 6e74 6169 6e65 722d make maintainer- │ │ │ │ │ +00026630: 636c 6561 6e27 2c20 276d 616b 650a 6469 clean', 'make.di │ │ │ │ │ +00026640: 7374 636c 6561 6e27 2061 6e64 2027 6d61 stclean' and 'ma │ │ │ │ │ +00026650: 6b65 2064 6973 7427 2e20 2041 6c6c 206f ke dist'. All o │ │ │ │ │ +00026660: 7468 6572 2072 6563 7572 7369 7665 2072 ther recursive r │ │ │ │ │ +00026670: 756c 6573 2075 7365 2027 5355 4244 4952 ules use 'SUBDIR │ │ │ │ │ +00026680: 5327 2e0a 0a20 2020 4966 2027 5355 4244 S'... If 'SUBD │ │ │ │ │ +00026690: 4952 5327 2069 7320 6465 6669 6e65 6420 IRS' is defined │ │ │ │ │ +000266a0: 636f 6e64 6974 696f 6e61 6c6c 7920 7573 conditionally us │ │ │ │ │ +000266b0: 696e 6720 4175 746f 6d61 6b65 2063 6f6e ing Automake con │ │ │ │ │ +000266c0: 6469 7469 6f6e 616c 732c 0a41 7574 6f6d ditionals,.Autom │ │ │ │ │ +000266d0: 616b 6520 7769 6c6c 2064 6566 696e 6520 ake will define │ │ │ │ │ +000266e0: 2744 4953 545f 5355 4244 4952 5327 2061 'DIST_SUBDIRS' a │ │ │ │ │ +000266f0: 7574 6f6d 6174 6963 616c 6c79 2066 726f utomatically fro │ │ │ │ │ +00026700: 6d20 7468 6520 706f 7373 6962 6c65 0a76 m the possible.v │ │ │ │ │ +00026710: 616c 7565 7320 6f66 2027 5355 4244 4952 alues of 'SUBDIR │ │ │ │ │ +00026720: 5327 2069 6e20 616c 6c20 636f 6e64 6974 S' in all condit │ │ │ │ │ +00026730: 696f 6e73 2e0a 0a20 2020 4966 2027 5355 ions... If 'SU │ │ │ │ │ +00026740: 4244 4952 5327 2063 6f6e 7461 696e 7320 BDIRS' contains │ │ │ │ │ +00026750: 2741 435f 5355 4253 5427 2076 6172 6961 'AC_SUBST' varia │ │ │ │ │ +00026760: 626c 6573 2c20 2744 4953 545f 5355 4244 bles, 'DIST_SUBD │ │ │ │ │ +00026770: 4952 5327 2077 696c 6c20 6e6f 740a 6265 IRS' will not.be │ │ │ │ │ +00026780: 2064 6566 696e 6564 2063 6f72 7265 6374 defined correct │ │ │ │ │ +00026790: 6c79 2062 6563 6175 7365 2041 7574 6f6d ly because Autom │ │ │ │ │ +000267a0: 616b 6520 646f 6573 206e 6f74 206b 6e6f ake does not kno │ │ │ │ │ +000267b0: 7720 7468 6520 706f 7373 6962 6c65 2076 w the possible v │ │ │ │ │ +000267c0: 616c 7565 730a 6f66 2074 6865 7365 2076 alues.of these v │ │ │ │ │ +000267d0: 6172 6961 626c 6573 2e20 2049 6e20 7468 ariables. In th │ │ │ │ │ +000267e0: 6973 2063 6173 6520 2744 4953 545f 5355 is case 'DIST_SU │ │ │ │ │ +000267f0: 4244 4952 5327 206e 6565 6473 2074 6f20 BDIRS' needs to │ │ │ │ │ +00026800: 6265 2064 6566 696e 6564 0a6d 616e 7561 be defined.manua │ │ │ │ │ +00026810: 6c6c 792e 0a0a 1f0a 4669 6c65 3a20 6175 lly.....File: au │ │ │ │ │ +00026820: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00026830: 2c20 204e 6f64 653a 2053 7562 6469 7265 , Node: Subdire │ │ │ │ │ +00026840: 6374 6f72 6965 7320 7769 7468 2041 4d5f ctories with AM_ │ │ │ │ │ +00026850: 434f 4e44 4954 494f 4e41 4c2c 2020 4e65 CONDITIONAL, Ne │ │ │ │ │ +00026860: 7874 3a20 5375 6264 6972 6563 746f 7269 xt: Subdirectori │ │ │ │ │ +00026870: 6573 2077 6974 6820 4143 5f53 5542 5354 es with AC_SUBST │ │ │ │ │ +00026880: 2c20 2050 7265 763a 2053 5542 4449 5253 , Prev: SUBDIRS │ │ │ │ │ +00026890: 2076 7320 4449 5354 5f53 5542 4449 5253 vs DIST_SUBDIRS │ │ │ │ │ +000268a0: 2c20 2055 703a 2043 6f6e 6469 7469 6f6e , Up: Condition │ │ │ │ │ +000268b0: 616c 2053 7562 6469 7265 6374 6f72 6965 al Subdirectorie │ │ │ │ │ +000268c0: 730a 0a37 2e32 2e32 2053 7562 6469 7265 s..7.2.2 Subdire │ │ │ │ │ +000268d0: 6374 6f72 6965 7320 7769 7468 2027 414d ctories with 'AM │ │ │ │ │ +000268e0: 5f43 4f4e 4449 5449 4f4e 414c 270a 2d2d _CONDITIONAL'.-- │ │ │ │ │ 000268f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00026900: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00026910: 2d2d 2d2d 2d2d 0a0a 2763 6f6e 6669 6775 ------..'configu │ │ │ │ │ -00026920: 7265 2720 7368 6f75 6c64 206f 7574 7075 re' should outpu │ │ │ │ │ -00026930: 7420 7468 6520 274d 616b 6566 696c 6527 t the 'Makefile' │ │ │ │ │ -00026940: 2066 6f72 2065 6163 6820 6469 7265 6374 for each direct │ │ │ │ │ -00026950: 6f72 7920 616e 6420 6465 6669 6e65 2061 ory and define a │ │ │ │ │ -00026960: 0a63 6f6e 6469 7469 6f6e 2069 6e74 6f20 .condition into │ │ │ │ │ -00026970: 7768 6963 6820 276f 7074 2f27 2073 686f which 'opt/' sho │ │ │ │ │ -00026980: 756c 6420 6265 2062 7569 6c74 2e0a 0a20 uld be built... │ │ │ │ │ -00026990: 2020 2020 2e2e 2e0a 2020 2020 2041 4d5f .... AM_ │ │ │ │ │ -000269a0: 434f 4e44 4954 494f 4e41 4c28 5b43 4f4e CONDITIONAL([CON │ │ │ │ │ -000269b0: 445f 4f50 545d 2c20 5b74 6573 7420 2224 D_OPT], [test "$ │ │ │ │ │ -000269c0: 7761 6e74 5f6f 7074 2220 3d20 7965 735d want_opt" = yes] │ │ │ │ │ -000269d0: 290a 2020 2020 2041 435f 434f 4e46 4947 ). AC_CONFIG │ │ │ │ │ -000269e0: 5f46 494c 4553 285b 4d61 6b65 6669 6c65 _FILES([Makefile │ │ │ │ │ -000269f0: 2073 7263 2f4d 616b 6566 696c 6520 6f70 src/Makefile op │ │ │ │ │ -00026a00: 742f 4d61 6b65 6669 6c65 5d29 0a20 2020 t/Makefile]). │ │ │ │ │ -00026a10: 2020 2e2e 2e0a 0a20 2020 5468 656e 2027 ..... Then ' │ │ │ │ │ -00026a20: 5355 4244 4952 5327 2063 616e 2062 6520 SUBDIRS' can be │ │ │ │ │ -00026a30: 6465 6669 6e65 6420 696e 2074 6865 2074 defined in the t │ │ │ │ │ -00026a40: 6f70 2d6c 6576 656c 2027 4d61 6b65 6669 op-level 'Makefi │ │ │ │ │ -00026a50: 6c65 2e61 6d27 2061 730a 666f 6c6c 6f77 le.am' as.follow │ │ │ │ │ -00026a60: 732e 0a0a 2020 2020 2069 6620 434f 4e44 s... if COND │ │ │ │ │ -00026a70: 5f4f 5054 0a20 2020 2020 2020 4d41 5942 _OPT. MAYB │ │ │ │ │ -00026a80: 455f 4f50 5420 3d20 6f70 740a 2020 2020 E_OPT = opt. │ │ │ │ │ -00026a90: 2065 6e64 6966 0a20 2020 2020 5355 4244 endif. SUBD │ │ │ │ │ -00026aa0: 4952 5320 3d20 7372 6320 2428 4d41 5942 IRS = src $(MAYB │ │ │ │ │ -00026ab0: 455f 4f50 5429 0a0a 2020 2041 7320 796f E_OPT).. As yo │ │ │ │ │ -00026ac0: 7520 6361 6e20 7365 652c 2072 756e 6e69 u can see, runni │ │ │ │ │ -00026ad0: 6e67 2027 6d61 6b65 2720 7769 6c6c 2072 ng 'make' will r │ │ │ │ │ -00026ae0: 6967 6874 6c79 2072 6563 7572 7365 2069 ightly recurse i │ │ │ │ │ -00026af0: 6e74 6f20 2773 7263 2f27 2061 6e64 0a6d nto 'src/' and.m │ │ │ │ │ -00026b00: 6179 6265 2027 6f70 742f 272e 0a0a 2020 aybe 'opt/'... │ │ │ │ │ -00026b10: 2041 7320 796f 7520 6361 6e27 7420 7365 As you can't se │ │ │ │ │ -00026b20: 652c 2072 756e 6e69 6e67 2027 6d61 6b65 e, running 'make │ │ │ │ │ -00026b30: 2064 6973 7427 2077 696c 6c20 7265 6375 dist' will recu │ │ │ │ │ -00026b40: 7273 6520 696e 746f 2062 6f74 6820 2773 rse into both 's │ │ │ │ │ -00026b50: 7263 2f27 0a61 6e64 2027 6f70 742f 2720 rc/'.and 'opt/' │ │ │ │ │ -00026b60: 6469 7265 6374 6f72 6965 7320 6265 6361 directories beca │ │ │ │ │ -00026b70: 7573 6520 276d 616b 6520 6469 7374 272c use 'make dist', │ │ │ │ │ -00026b80: 2075 6e6c 696b 6520 276d 616b 6520 616c unlike 'make al │ │ │ │ │ -00026b90: 6c27 2c20 646f 6573 6e27 740a 7573 6520 l', doesn't.use │ │ │ │ │ -00026ba0: 7468 6520 2753 5542 4449 5253 2720 7661 the 'SUBDIRS' va │ │ │ │ │ -00026bb0: 7269 6162 6c65 2e20 2049 7420 7573 6573 riable. It uses │ │ │ │ │ -00026bc0: 2074 6865 2027 4449 5354 5f53 5542 4449 the 'DIST_SUBDI │ │ │ │ │ -00026bd0: 5253 2720 7661 7269 6162 6c65 2e0a 0a20 RS' variable... │ │ │ │ │ -00026be0: 2020 496e 2074 6869 7320 6361 7365 2041 In this case A │ │ │ │ │ -00026bf0: 7574 6f6d 616b 6520 7769 6c6c 2064 6566 utomake will def │ │ │ │ │ -00026c00: 696e 6520 2744 4953 545f 5355 4244 4952 ine 'DIST_SUBDIR │ │ │ │ │ -00026c10: 5320 3d20 7372 6320 6f70 7427 0a61 7574 S = src opt'.aut │ │ │ │ │ -00026c20: 6f6d 6174 6963 616c 6c79 2062 6563 6175 omatically becau │ │ │ │ │ -00026c30: 7365 2069 7420 6b6e 6f77 7320 7468 6174 se it knows that │ │ │ │ │ -00026c40: 2027 4d41 5942 455f 4f50 5427 2063 616e 'MAYBE_OPT' can │ │ │ │ │ -00026c50: 2063 6f6e 7461 696e 2027 6f70 7427 2069 contain 'opt' i │ │ │ │ │ -00026c60: 6e0a 736f 6d65 2063 6f6e 6469 7469 6f6e n.some condition │ │ │ │ │ -00026c70: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ -00026c80: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -00026c90: 4e6f 6465 3a20 5375 6264 6972 6563 746f Node: Subdirecto │ │ │ │ │ -00026ca0: 7269 6573 2077 6974 6820 4143 5f53 5542 ries with AC_SUB │ │ │ │ │ -00026cb0: 5354 2c20 204e 6578 743a 2055 6e63 6f6e ST, Next: Uncon │ │ │ │ │ -00026cc0: 6669 6775 7265 6420 5375 6264 6972 6563 figured Subdirec │ │ │ │ │ -00026cd0: 746f 7269 6573 2c20 2050 7265 763a 2053 tories, Prev: S │ │ │ │ │ -00026ce0: 7562 6469 7265 6374 6f72 6965 7320 7769 ubdirectories wi │ │ │ │ │ -00026cf0: 7468 2041 4d5f 434f 4e44 4954 494f 4e41 th AM_CONDITIONA │ │ │ │ │ -00026d00: 4c2c 2020 5570 3a20 436f 6e64 6974 696f L, Up: Conditio │ │ │ │ │ -00026d10: 6e61 6c20 5375 6264 6972 6563 746f 7269 nal Subdirectori │ │ │ │ │ -00026d20: 6573 0a0a 372e 322e 3320 5375 6264 6972 es..7.2.3 Subdir │ │ │ │ │ -00026d30: 6563 746f 7269 6573 2077 6974 6820 2741 ectories with 'A │ │ │ │ │ -00026d40: 435f 5355 4253 5427 0a2d 2d2d 2d2d 2d2d C_SUBST'.------- │ │ │ │ │ +00026910: 2d2d 2d2d 2d2d 2d2d 0a0a 2763 6f6e 6669 --------..'confi │ │ │ │ │ +00026920: 6775 7265 2720 7368 6f75 6c64 206f 7574 gure' should out │ │ │ │ │ +00026930: 7075 7420 7468 6520 274d 616b 6566 696c put the 'Makefil │ │ │ │ │ +00026940: 6527 2066 6f72 2065 6163 6820 6469 7265 e' for each dire │ │ │ │ │ +00026950: 6374 6f72 7920 616e 6420 6465 6669 6e65 ctory and define │ │ │ │ │ +00026960: 2061 0a63 6f6e 6469 7469 6f6e 2069 6e74 a.condition int │ │ │ │ │ +00026970: 6f20 7768 6963 6820 276f 7074 2f27 2073 o which 'opt/' s │ │ │ │ │ +00026980: 686f 756c 6420 6265 2062 7569 6c74 2e0a hould be built.. │ │ │ │ │ +00026990: 0a20 2020 2020 2e2e 2e0a 2020 2020 2041 . .... A │ │ │ │ │ +000269a0: 4d5f 434f 4e44 4954 494f 4e41 4c28 5b43 M_CONDITIONAL([C │ │ │ │ │ +000269b0: 4f4e 445f 4f50 545d 2c20 5b74 6573 7420 OND_OPT], [test │ │ │ │ │ +000269c0: 2224 7761 6e74 5f6f 7074 2220 3d20 7965 "$want_opt" = ye │ │ │ │ │ +000269d0: 735d 290a 2020 2020 2041 435f 434f 4e46 s]). AC_CONF │ │ │ │ │ +000269e0: 4947 5f46 494c 4553 285b 4d61 6b65 6669 IG_FILES([Makefi │ │ │ │ │ +000269f0: 6c65 2073 7263 2f4d 616b 6566 696c 6520 le src/Makefile │ │ │ │ │ +00026a00: 6f70 742f 4d61 6b65 6669 6c65 5d29 0a20 opt/Makefile]). │ │ │ │ │ +00026a10: 2020 2020 2e2e 2e0a 0a20 2020 5468 656e ..... Then │ │ │ │ │ +00026a20: 2027 5355 4244 4952 5327 2063 616e 2062 'SUBDIRS' can b │ │ │ │ │ +00026a30: 6520 6465 6669 6e65 6420 696e 2074 6865 e defined in the │ │ │ │ │ +00026a40: 2074 6f70 2d6c 6576 656c 2027 4d61 6b65 top-level 'Make │ │ │ │ │ +00026a50: 6669 6c65 2e61 6d27 2061 730a 666f 6c6c file.am' as.foll │ │ │ │ │ +00026a60: 6f77 732e 0a0a 2020 2020 2069 6620 434f ows... if CO │ │ │ │ │ +00026a70: 4e44 5f4f 5054 0a20 2020 2020 2020 4d41 ND_OPT. MA │ │ │ │ │ +00026a80: 5942 455f 4f50 5420 3d20 6f70 740a 2020 YBE_OPT = opt. │ │ │ │ │ +00026a90: 2020 2065 6e64 6966 0a20 2020 2020 5355 endif. SU │ │ │ │ │ +00026aa0: 4244 4952 5320 3d20 7372 6320 2428 4d41 BDIRS = src $(MA │ │ │ │ │ +00026ab0: 5942 455f 4f50 5429 0a0a 2020 2041 7320 YBE_OPT).. As │ │ │ │ │ +00026ac0: 796f 7520 6361 6e20 7365 652c 2072 756e you can see, run │ │ │ │ │ +00026ad0: 6e69 6e67 2027 6d61 6b65 2720 7769 6c6c ning 'make' will │ │ │ │ │ +00026ae0: 2072 6967 6874 6c79 2072 6563 7572 7365 rightly recurse │ │ │ │ │ +00026af0: 2069 6e74 6f20 2773 7263 2f27 2061 6e64 into 'src/' and │ │ │ │ │ +00026b00: 0a6d 6179 6265 2027 6f70 742f 272e 0a0a .maybe 'opt/'... │ │ │ │ │ +00026b10: 2020 2041 7320 796f 7520 6361 6e27 7420 As you can't │ │ │ │ │ +00026b20: 7365 652c 2072 756e 6e69 6e67 2027 6d61 see, running 'ma │ │ │ │ │ +00026b30: 6b65 2064 6973 7427 2077 696c 6c20 7265 ke dist' will re │ │ │ │ │ +00026b40: 6375 7273 6520 696e 746f 2062 6f74 6820 curse into both │ │ │ │ │ +00026b50: 2773 7263 2f27 0a61 6e64 2027 6f70 742f 'src/'.and 'opt/ │ │ │ │ │ +00026b60: 2720 6469 7265 6374 6f72 6965 7320 6265 ' directories be │ │ │ │ │ +00026b70: 6361 7573 6520 276d 616b 6520 6469 7374 cause 'make dist │ │ │ │ │ +00026b80: 272c 2075 6e6c 696b 6520 276d 616b 6520 ', unlike 'make │ │ │ │ │ +00026b90: 616c 6c27 2c20 646f 6573 6e27 740a 7573 all', doesn't.us │ │ │ │ │ +00026ba0: 6520 7468 6520 2753 5542 4449 5253 2720 e the 'SUBDIRS' │ │ │ │ │ +00026bb0: 7661 7269 6162 6c65 2e20 2049 7420 7573 variable. It us │ │ │ │ │ +00026bc0: 6573 2074 6865 2027 4449 5354 5f53 5542 es the 'DIST_SUB │ │ │ │ │ +00026bd0: 4449 5253 2720 7661 7269 6162 6c65 2e0a DIRS' variable.. │ │ │ │ │ +00026be0: 0a20 2020 496e 2074 6869 7320 6361 7365 . In this case │ │ │ │ │ +00026bf0: 2041 7574 6f6d 616b 6520 7769 6c6c 2064 Automake will d │ │ │ │ │ +00026c00: 6566 696e 6520 2744 4953 545f 5355 4244 efine 'DIST_SUBD │ │ │ │ │ +00026c10: 4952 5320 3d20 7372 6320 6f70 7427 0a61 IRS = src opt'.a │ │ │ │ │ +00026c20: 7574 6f6d 6174 6963 616c 6c79 2062 6563 utomatically bec │ │ │ │ │ +00026c30: 6175 7365 2069 7420 6b6e 6f77 7320 7468 ause it knows th │ │ │ │ │ +00026c40: 6174 2027 4d41 5942 455f 4f50 5427 2063 at 'MAYBE_OPT' c │ │ │ │ │ +00026c50: 616e 2063 6f6e 7461 696e 2027 6f70 7427 an contain 'opt' │ │ │ │ │ +00026c60: 2069 6e0a 736f 6d65 2063 6f6e 6469 7469 in.some conditi │ │ │ │ │ +00026c70: 6f6e 2e0a 0a1f 0a46 696c 653a 2061 7574 on.....File: aut │ │ │ │ │ +00026c80: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +00026c90: 2020 4e6f 6465 3a20 5375 6264 6972 6563 Node: Subdirec │ │ │ │ │ +00026ca0: 746f 7269 6573 2077 6974 6820 4143 5f53 tories with AC_S │ │ │ │ │ +00026cb0: 5542 5354 2c20 204e 6578 743a 2055 6e63 UBST, Next: Unc │ │ │ │ │ +00026cc0: 6f6e 6669 6775 7265 6420 5375 6264 6972 onfigured Subdir │ │ │ │ │ +00026cd0: 6563 746f 7269 6573 2c20 2050 7265 763a ectories, Prev: │ │ │ │ │ +00026ce0: 2053 7562 6469 7265 6374 6f72 6965 7320 Subdirectories │ │ │ │ │ +00026cf0: 7769 7468 2041 4d5f 434f 4e44 4954 494f with AM_CONDITIO │ │ │ │ │ +00026d00: 4e41 4c2c 2020 5570 3a20 436f 6e64 6974 NAL, Up: Condit │ │ │ │ │ +00026d10: 696f 6e61 6c20 5375 6264 6972 6563 746f ional Subdirecto │ │ │ │ │ +00026d20: 7269 6573 0a0a 372e 322e 3320 5375 6264 ries..7.2.3 Subd │ │ │ │ │ +00026d30: 6972 6563 746f 7269 6573 2077 6974 6820 irectories with │ │ │ │ │ +00026d40: 2741 435f 5355 4253 5427 0a2d 2d2d 2d2d 'AC_SUBST'.----- │ │ │ │ │ 00026d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00026d60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a41 -------------..A │ │ │ │ │ -00026d70: 6e6f 7468 6572 2070 6f73 7369 6269 6c69 nother possibili │ │ │ │ │ -00026d80: 7479 2069 7320 746f 2064 6566 696e 6520 ty is to define │ │ │ │ │ -00026d90: 274d 4159 4245 5f4f 5054 2720 6672 6f6d 'MAYBE_OPT' from │ │ │ │ │ -00026da0: 2027 2e2f 636f 6e66 6967 7572 6527 2075 './configure' u │ │ │ │ │ -00026db0: 7369 6e67 0a27 4143 5f53 5542 5354 273a sing.'AC_SUBST': │ │ │ │ │ -00026dc0: 0a0a 2020 2020 202e 2e2e 0a20 2020 2020 .. .... │ │ │ │ │ -00026dd0: 6966 2074 6573 7420 2224 7761 6e74 5f6f if test "$want_o │ │ │ │ │ -00026de0: 7074 2220 3d20 7965 733b 2074 6865 6e0a pt" = yes; then. │ │ │ │ │ -00026df0: 2020 2020 2020 204d 4159 4245 5f4f 5054 MAYBE_OPT │ │ │ │ │ -00026e00: 3d6f 7074 0a20 2020 2020 656c 7365 0a20 =opt. else. │ │ │ │ │ -00026e10: 2020 2020 2020 4d41 5942 455f 4f50 543d MAYBE_OPT= │ │ │ │ │ -00026e20: 0a20 2020 2020 6669 0a20 2020 2020 4143 . fi. AC │ │ │ │ │ -00026e30: 5f53 5542 5354 285b 4d41 5942 455f 4f50 _SUBST([MAYBE_OP │ │ │ │ │ -00026e40: 545d 290a 2020 2020 2041 435f 434f 4e46 T]). AC_CONF │ │ │ │ │ -00026e50: 4947 5f46 494c 4553 285b 4d61 6b65 6669 IG_FILES([Makefi │ │ │ │ │ -00026e60: 6c65 2073 7263 2f4d 616b 6566 696c 6520 le src/Makefile │ │ │ │ │ -00026e70: 6f70 742f 4d61 6b65 6669 6c65 5d29 0a20 opt/Makefile]). │ │ │ │ │ -00026e80: 2020 2020 2e2e 2e0a 0a20 2020 496e 2074 ..... In t │ │ │ │ │ -00026e90: 6869 7320 6361 7365 2074 6865 2074 6f70 his case the top │ │ │ │ │ -00026ea0: 2d6c 6576 656c 2027 4d61 6b65 6669 6c65 -level 'Makefile │ │ │ │ │ -00026eb0: 2e61 6d27 2073 686f 756c 6420 6c6f 6f6b .am' should look │ │ │ │ │ -00026ec0: 2061 7320 666f 6c6c 6f77 732e 0a0a 2020 as follows... │ │ │ │ │ -00026ed0: 2020 2053 5542 4449 5253 203d 2073 7263 SUBDIRS = src │ │ │ │ │ -00026ee0: 2024 284d 4159 4245 5f4f 5054 290a 2020 $(MAYBE_OPT). │ │ │ │ │ -00026ef0: 2020 2044 4953 545f 5355 4244 4952 5320 DIST_SUBDIRS │ │ │ │ │ -00026f00: 3d20 7372 6320 6f70 740a 0a20 2020 5468 = src opt.. Th │ │ │ │ │ -00026f10: 6520 6472 6177 6261 636b 2069 7320 7468 e drawback is th │ │ │ │ │ -00026f20: 6174 2073 696e 6365 2041 7574 6f6d 616b at since Automak │ │ │ │ │ -00026f30: 6520 6361 6e6e 6f74 2067 7565 7373 2077 e cannot guess w │ │ │ │ │ -00026f40: 6861 7420 7468 6520 706f 7373 6962 6c65 hat the possible │ │ │ │ │ -00026f50: 0a76 616c 7565 7320 6f66 2027 4d41 5942 .values of 'MAYB │ │ │ │ │ -00026f60: 455f 4f50 5427 2061 7265 2c20 6974 2069 E_OPT' are, it i │ │ │ │ │ -00026f70: 7320 6e65 6365 7373 6172 7920 746f 2064 s necessary to d │ │ │ │ │ -00026f80: 6566 696e 6520 2744 4953 545f 5355 4244 efine 'DIST_SUBD │ │ │ │ │ -00026f90: 4952 5327 2e0a 0a1f 0a46 696c 653a 2061 IRS'.....File: a │ │ │ │ │ -00026fa0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -00026fb0: 6f2c 2020 4e6f 6465 3a20 556e 636f 6e66 o, Node: Unconf │ │ │ │ │ -00026fc0: 6967 7572 6564 2053 7562 6469 7265 6374 igured Subdirect │ │ │ │ │ -00026fd0: 6f72 6965 732c 2020 5072 6576 3a20 5375 ories, Prev: Su │ │ │ │ │ -00026fe0: 6264 6972 6563 746f 7269 6573 2077 6974 bdirectories wit │ │ │ │ │ -00026ff0: 6820 4143 5f53 5542 5354 2c20 2055 703a h AC_SUBST, Up: │ │ │ │ │ -00027000: 2043 6f6e 6469 7469 6f6e 616c 2053 7562 Conditional Sub │ │ │ │ │ -00027010: 6469 7265 6374 6f72 6965 730a 0a37 2e32 directories..7.2 │ │ │ │ │ -00027020: 2e34 2055 6e63 6f6e 6669 6775 7265 6420 .4 Unconfigured │ │ │ │ │ -00027030: 5375 6264 6972 6563 746f 7269 6573 0a2d Subdirectories.- │ │ │ │ │ -00027040: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00026d60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00026d70: 0a41 6e6f 7468 6572 2070 6f73 7369 6269 .Another possibi │ │ │ │ │ +00026d80: 6c69 7479 2069 7320 746f 2064 6566 696e lity is to defin │ │ │ │ │ +00026d90: 6520 274d 4159 4245 5f4f 5054 2720 6672 e 'MAYBE_OPT' fr │ │ │ │ │ +00026da0: 6f6d 2027 2e2f 636f 6e66 6967 7572 6527 om './configure' │ │ │ │ │ +00026db0: 2075 7369 6e67 0a27 4143 5f53 5542 5354 using.'AC_SUBST │ │ │ │ │ +00026dc0: 273a 0a0a 2020 2020 202e 2e2e 0a20 2020 ':.. .... │ │ │ │ │ +00026dd0: 2020 6966 2074 6573 7420 2224 7761 6e74 if test "$want │ │ │ │ │ +00026de0: 5f6f 7074 2220 3d20 7965 733b 2074 6865 _opt" = yes; the │ │ │ │ │ +00026df0: 6e0a 2020 2020 2020 204d 4159 4245 5f4f n. MAYBE_O │ │ │ │ │ +00026e00: 5054 3d6f 7074 0a20 2020 2020 656c 7365 PT=opt. else │ │ │ │ │ +00026e10: 0a20 2020 2020 2020 4d41 5942 455f 4f50 . MAYBE_OP │ │ │ │ │ +00026e20: 543d 0a20 2020 2020 6669 0a20 2020 2020 T=. fi. │ │ │ │ │ +00026e30: 4143 5f53 5542 5354 285b 4d41 5942 455f AC_SUBST([MAYBE_ │ │ │ │ │ +00026e40: 4f50 545d 290a 2020 2020 2041 435f 434f OPT]). AC_CO │ │ │ │ │ +00026e50: 4e46 4947 5f46 494c 4553 285b 4d61 6b65 NFIG_FILES([Make │ │ │ │ │ +00026e60: 6669 6c65 2073 7263 2f4d 616b 6566 696c file src/Makefil │ │ │ │ │ +00026e70: 6520 6f70 742f 4d61 6b65 6669 6c65 5d29 e opt/Makefile]) │ │ │ │ │ +00026e80: 0a20 2020 2020 2e2e 2e0a 0a20 2020 496e . ..... In │ │ │ │ │ +00026e90: 2074 6869 7320 6361 7365 2074 6865 2074 this case the t │ │ │ │ │ +00026ea0: 6f70 2d6c 6576 656c 2027 4d61 6b65 6669 op-level 'Makefi │ │ │ │ │ +00026eb0: 6c65 2e61 6d27 2073 686f 756c 6420 6c6f le.am' should lo │ │ │ │ │ +00026ec0: 6f6b 2061 7320 666f 6c6c 6f77 732e 0a0a ok as follows... │ │ │ │ │ +00026ed0: 2020 2020 2053 5542 4449 5253 203d 2073 SUBDIRS = s │ │ │ │ │ +00026ee0: 7263 2024 284d 4159 4245 5f4f 5054 290a rc $(MAYBE_OPT). │ │ │ │ │ +00026ef0: 2020 2020 2044 4953 545f 5355 4244 4952 DIST_SUBDIR │ │ │ │ │ +00026f00: 5320 3d20 7372 6320 6f70 740a 0a20 2020 S = src opt.. │ │ │ │ │ +00026f10: 5468 6520 6472 6177 6261 636b 2069 7320 The drawback is │ │ │ │ │ +00026f20: 7468 6174 2073 696e 6365 2041 7574 6f6d that since Autom │ │ │ │ │ +00026f30: 616b 6520 6361 6e6e 6f74 2067 7565 7373 ake cannot guess │ │ │ │ │ +00026f40: 2077 6861 7420 7468 6520 706f 7373 6962 what the possib │ │ │ │ │ +00026f50: 6c65 0a76 616c 7565 7320 6f66 2027 4d41 le.values of 'MA │ │ │ │ │ +00026f60: 5942 455f 4f50 5427 2061 7265 2c20 6974 YBE_OPT' are, it │ │ │ │ │ +00026f70: 2069 7320 6e65 6365 7373 6172 7920 746f is necessary to │ │ │ │ │ +00026f80: 2064 6566 696e 6520 2744 4953 545f 5355 define 'DIST_SU │ │ │ │ │ +00026f90: 4244 4952 5327 2e0a 0a1f 0a46 696c 653a BDIRS'.....File: │ │ │ │ │ +00026fa0: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +00026fb0: 6e66 6f2c 2020 4e6f 6465 3a20 556e 636f nfo, Node: Unco │ │ │ │ │ +00026fc0: 6e66 6967 7572 6564 2053 7562 6469 7265 nfigured Subdire │ │ │ │ │ +00026fd0: 6374 6f72 6965 732c 2020 5072 6576 3a20 ctories, Prev: │ │ │ │ │ +00026fe0: 5375 6264 6972 6563 746f 7269 6573 2077 Subdirectories w │ │ │ │ │ +00026ff0: 6974 6820 4143 5f53 5542 5354 2c20 2055 ith AC_SUBST, U │ │ │ │ │ +00027000: 703a 2043 6f6e 6469 7469 6f6e 616c 2053 p: Conditional S │ │ │ │ │ +00027010: 7562 6469 7265 6374 6f72 6965 730a 0a37 ubdirectories..7 │ │ │ │ │ +00027020: 2e32 2e34 2055 6e63 6f6e 6669 6775 7265 .2.4 Unconfigure │ │ │ │ │ +00027030: 6420 5375 6264 6972 6563 746f 7269 6573 d Subdirectories │ │ │ │ │ +00027040: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ 00027050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00027060: 0a0a 5468 6520 7365 6d61 6e74 6963 7320 ..The semantics │ │ │ │ │ -00027070: 6f66 2027 4449 5354 5f53 5542 4449 5253 of 'DIST_SUBDIRS │ │ │ │ │ -00027080: 2720 6172 6520 6f66 7465 6e20 6d69 7375 ' are often misu │ │ │ │ │ -00027090: 6e64 6572 7374 6f6f 6420 6279 2073 6f6d nderstood by som │ │ │ │ │ -000270a0: 6520 7573 6572 730a 7468 6174 2074 7279 e users.that try │ │ │ │ │ -000270b0: 2074 6f20 5f63 6f6e 6669 6775 7265 2061 to _configure a │ │ │ │ │ -000270c0: 6e64 2062 7569 6c64 5f20 7375 6264 6972 nd build_ subdir │ │ │ │ │ -000270d0: 6563 746f 7269 6573 2063 6f6e 6469 7469 ectories conditi │ │ │ │ │ -000270e0: 6f6e 616c 6c79 2e20 2048 6572 6520 6279 onally. Here by │ │ │ │ │ -000270f0: 0a63 6f6e 6669 6775 7269 6e67 2077 6520 .configuring we │ │ │ │ │ -00027100: 6d65 616e 2063 7265 6174 696e 6720 7468 mean creating th │ │ │ │ │ -00027110: 6520 274d 616b 6566 696c 6527 2028 6974 e 'Makefile' (it │ │ │ │ │ -00027120: 206d 6967 6874 2061 6c73 6f20 696e 766f might also invo │ │ │ │ │ -00027130: 6c76 650a 7275 6e6e 696e 6720 6120 6e65 lve.running a ne │ │ │ │ │ -00027140: 7374 6564 2027 636f 6e66 6967 7572 6527 sted 'configure' │ │ │ │ │ -00027150: 2073 6372 6970 743a 2074 6869 7320 6973 script: this is │ │ │ │ │ -00027160: 2061 2063 6f73 746c 7920 6f70 6572 6174 a costly operat │ │ │ │ │ -00027170: 696f 6e20 7468 6174 0a65 7870 6c61 696e ion that.explain │ │ │ │ │ -00027180: 7320 7768 7920 7065 6f70 6c65 2077 616e s why people wan │ │ │ │ │ -00027190: 7420 746f 2064 6f20 6974 2063 6f6e 6469 t to do it condi │ │ │ │ │ -000271a0: 7469 6f6e 616c 6c79 2c20 6275 7420 6f6e tionally, but on │ │ │ │ │ -000271b0: 6c79 2074 6865 2027 4d61 6b65 6669 6c65 ly the 'Makefile │ │ │ │ │ -000271c0: 270a 6973 2072 656c 6576 616e 7420 746f '.is relevant to │ │ │ │ │ -000271d0: 2074 6865 2064 6973 6375 7373 696f 6e29 the discussion) │ │ │ │ │ -000271e0: 2e0a 0a20 2020 5468 6520 6162 6f76 6520 ... The above │ │ │ │ │ -000271f0: 6578 616d 706c 6573 2061 6c6c 2061 7373 examples all ass │ │ │ │ │ -00027200: 756d 6520 7468 6174 2065 7665 7279 2027 ume that every ' │ │ │ │ │ -00027210: 4d61 6b65 6669 6c65 2720 6973 2063 7265 Makefile' is cre │ │ │ │ │ -00027220: 6174 6564 2c20 6576 656e 0a69 6e20 6469 ated, even.in di │ │ │ │ │ -00027230: 7265 6374 6f72 6965 7320 7468 6174 2061 rectories that a │ │ │ │ │ -00027240: 7265 206e 6f74 2067 6f69 6e67 2074 6f20 re not going to │ │ │ │ │ -00027250: 6265 2062 7569 6c74 2e20 2054 6865 2073 be built. The s │ │ │ │ │ -00027260: 696d 706c 6520 7265 6173 6f6e 2069 730a imple reason is. │ │ │ │ │ -00027270: 7468 6174 2077 6520 7761 6e74 2027 6d61 that we want 'ma │ │ │ │ │ -00027280: 6b65 2064 6973 7427 2074 6f20 6469 7374 ke dist' to dist │ │ │ │ │ -00027290: 7269 6275 7465 2065 7665 6e20 7468 6520 ribute even the │ │ │ │ │ -000272a0: 6469 7265 6374 6f72 6965 7320 7468 6174 directories that │ │ │ │ │ -000272b0: 2061 7265 206e 6f74 0a62 6569 6e67 2062 are not.being b │ │ │ │ │ -000272c0: 7569 6c74 2028 652e 672e 2c20 706c 6174 uilt (e.g., plat │ │ │ │ │ -000272d0: 666f 726d 2d64 6570 656e 6465 6e74 2063 form-dependent c │ │ │ │ │ -000272e0: 6f64 6529 2c20 6865 6e63 6520 276d 616b ode), hence 'mak │ │ │ │ │ -000272f0: 6520 6469 7374 2720 6d75 7374 0a72 6563 e dist' must.rec │ │ │ │ │ -00027300: 7572 7365 2069 6e74 6f20 7468 6520 7375 urse into the su │ │ │ │ │ -00027310: 6264 6972 6563 746f 7279 2c20 6865 6e63 bdirectory, henc │ │ │ │ │ -00027320: 6520 7468 6973 2064 6972 6563 746f 7279 e this directory │ │ │ │ │ -00027330: 206d 7573 7420 6265 2063 6f6e 6669 6775 must be configu │ │ │ │ │ -00027340: 7265 640a 616e 6420 6170 7065 6172 2069 red.and appear i │ │ │ │ │ -00027350: 6e20 2744 4953 545f 5355 4244 4952 5327 n 'DIST_SUBDIRS' │ │ │ │ │ -00027360: 2e0a 0a20 2020 4275 696c 6469 6e67 2070 ... Building p │ │ │ │ │ -00027370: 6163 6b61 6765 7320 7468 6174 2064 6f20 ackages that do │ │ │ │ │ -00027380: 6e6f 7420 636f 6e66 6967 7572 6520 6576 not configure ev │ │ │ │ │ -00027390: 6572 7920 7375 6264 6972 6563 746f 7279 ery subdirectory │ │ │ │ │ -000273a0: 2069 7320 610a 7472 6963 6b79 2062 7573 is a.tricky bus │ │ │ │ │ -000273b0: 696e 6573 732c 2061 6e64 2077 6520 646f iness, and we do │ │ │ │ │ -000273c0: 206e 6f74 2072 6563 6f6d 6d65 6e64 2069 not recommend i │ │ │ │ │ -000273d0: 7420 746f 2074 6865 206e 6f76 6963 6520 t to the novice │ │ │ │ │ -000273e0: 6173 2069 7420 6973 2065 6173 790a 746f as it is easy.to │ │ │ │ │ -000273f0: 2070 726f 6475 6365 2061 6e20 696e 636f produce an inco │ │ │ │ │ -00027400: 6d70 6c65 7465 2074 6172 6261 6c6c 2062 mplete tarball b │ │ │ │ │ -00027410: 7920 6d69 7374 616b 652e 2020 5765 2077 y mistake. We w │ │ │ │ │ -00027420: 696c 6c20 6e6f 7420 6469 7363 7573 7320 ill not discuss │ │ │ │ │ -00027430: 7468 6973 0a74 6f70 6963 2069 6e20 6465 this.topic in de │ │ │ │ │ -00027440: 7074 6820 6865 7265 2c20 7965 7420 666f pth here, yet fo │ │ │ │ │ -00027450: 7220 7468 6520 6164 7665 6e74 7572 6f75 r the adventurou │ │ │ │ │ -00027460: 7320 6865 7265 2061 7265 2061 2066 6577 s here are a few │ │ │ │ │ -00027470: 2072 756c 6573 2074 6f0a 7265 6d65 6d62 rules to.rememb │ │ │ │ │ -00027480: 6572 2e0a 0a20 2020 2a20 2753 5542 4449 er... * 'SUBDI │ │ │ │ │ -00027490: 5253 2720 7368 6f75 6c64 2061 6c77 6179 RS' should alway │ │ │ │ │ -000274a0: 7320 6265 2061 2073 7562 7365 7420 6f66 s be a subset of │ │ │ │ │ -000274b0: 2027 4449 5354 5f53 5542 4449 5253 272e 'DIST_SUBDIRS'. │ │ │ │ │ -000274c0: 0a0a 2020 2020 2049 7420 6d61 6b65 7320 .. It makes │ │ │ │ │ -000274d0: 6c69 7474 6c65 2073 656e 7365 2074 6f20 little sense to │ │ │ │ │ -000274e0: 6861 7665 2061 2064 6972 6563 746f 7279 have a directory │ │ │ │ │ -000274f0: 2069 6e20 2753 5542 4449 5253 2720 7468 in 'SUBDIRS' th │ │ │ │ │ -00027500: 6174 2069 7320 6e6f 740a 2020 2020 2069 at is not. i │ │ │ │ │ -00027510: 6e20 2744 4953 545f 5355 4244 4952 5327 n 'DIST_SUBDIRS' │ │ │ │ │ -00027520: 2e20 2054 6869 6e6b 206f 6620 7468 6520 . Think of the │ │ │ │ │ -00027530: 666f 726d 6572 2061 7320 6120 7761 7920 former as a way │ │ │ │ │ -00027540: 746f 2074 656c 6c20 7768 6963 680a 2020 to tell which. │ │ │ │ │ -00027550: 2020 2064 6972 6563 746f 7269 6573 206c directories l │ │ │ │ │ -00027560: 6973 7465 6420 696e 2074 6865 206c 6174 isted in the lat │ │ │ │ │ -00027570: 7465 7220 7368 6f75 6c64 2062 6520 6275 ter should be bu │ │ │ │ │ -00027580: 696c 742e 0a20 2020 2a20 416e 7920 6469 ilt.. * Any di │ │ │ │ │ -00027590: 7265 6374 6f72 7920 6c69 7374 6564 2069 rectory listed i │ │ │ │ │ -000275a0: 6e20 2744 4953 545f 5355 4244 4952 5327 n 'DIST_SUBDIRS' │ │ │ │ │ -000275b0: 2061 6e64 2027 5355 4244 4952 5327 206d and 'SUBDIRS' m │ │ │ │ │ -000275c0: 7573 7420 6265 0a20 2020 2020 636f 6e66 ust be. conf │ │ │ │ │ -000275d0: 6967 7572 6564 2e0a 0a20 2020 2020 492e igured... I. │ │ │ │ │ -000275e0: 652e 2c20 7468 6520 274d 616b 6566 696c e., the 'Makefil │ │ │ │ │ -000275f0: 6527 206d 7573 7420 6578 6973 7473 206f e' must exists o │ │ │ │ │ -00027600: 7220 7468 6520 7265 6375 7273 6976 6520 r the recursive │ │ │ │ │ -00027610: 276d 616b 6527 2072 756c 6573 2077 696c 'make' rules wil │ │ │ │ │ -00027620: 6c0a 2020 2020 206e 6f74 2062 6520 6162 l. not be ab │ │ │ │ │ -00027630: 6c65 2074 6f20 7072 6f63 6573 7320 7468 le to process th │ │ │ │ │ -00027640: 6520 6469 7265 6374 6f72 792e 0a20 2020 e directory.. │ │ │ │ │ -00027650: 2a20 416e 7920 636f 6e66 6967 7572 6564 * Any configured │ │ │ │ │ -00027660: 2064 6972 6563 746f 7279 206d 7573 7420 directory must │ │ │ │ │ -00027670: 6265 206c 6973 7465 6420 696e 2027 4449 be listed in 'DI │ │ │ │ │ -00027680: 5354 5f53 5542 4449 5253 272e 0a0a 2020 ST_SUBDIRS'... │ │ │ │ │ -00027690: 2020 2053 6f20 7468 6174 2074 6865 2063 So that the c │ │ │ │ │ -000276a0: 6c65 616e 696e 6720 7275 6c65 7320 7265 leaning rules re │ │ │ │ │ -000276b0: 6d6f 7665 2074 6865 2067 656e 6572 6174 move the generat │ │ │ │ │ -000276c0: 6564 2027 4d61 6b65 6669 6c65 2773 2e20 ed 'Makefile's. │ │ │ │ │ -000276d0: 2049 740a 2020 2020 2077 6f75 6c64 2062 It. would b │ │ │ │ │ -000276e0: 6520 636f 7272 6563 7420 746f 2073 6565 e correct to see │ │ │ │ │ -000276f0: 2027 4449 5354 5f53 5542 4449 5253 2720 'DIST_SUBDIRS' │ │ │ │ │ -00027700: 6173 2061 2076 6172 6961 626c 6520 7468 as a variable th │ │ │ │ │ -00027710: 6174 206c 6973 7473 2061 6c6c 0a20 2020 at lists all. │ │ │ │ │ -00027720: 2020 7468 6520 6469 7265 6374 6f72 6965 the directorie │ │ │ │ │ -00027730: 7320 7468 6174 2068 6176 6520 6265 656e s that have been │ │ │ │ │ -00027740: 2063 6f6e 6669 6775 7265 642e 0a0a 2020 configured... │ │ │ │ │ -00027750: 2049 6e20 6f72 6465 7220 746f 2070 7265 In order to pre │ │ │ │ │ -00027760: 7665 6e74 2072 6563 7572 7369 6f6e 2069 vent recursion i │ │ │ │ │ -00027770: 6e20 736f 6d65 2075 6e63 6f6e 6669 6775 n some unconfigu │ │ │ │ │ -00027780: 7265 6420 6469 7265 6374 6f72 7920 796f red directory yo │ │ │ │ │ -00027790: 7520 6d75 7374 0a74 6865 7265 666f 7265 u must.therefore │ │ │ │ │ -000277a0: 2065 6e73 7572 6520 7468 6174 2074 6869 ensure that thi │ │ │ │ │ -000277b0: 7320 6469 7265 6374 6f72 7920 646f 6573 s directory does │ │ │ │ │ -000277c0: 206e 6f74 2061 7070 6561 7220 696e 2027 not appear in ' │ │ │ │ │ -000277d0: 4449 5354 5f53 5542 4449 5253 270a 2861 DIST_SUBDIRS'.(a │ │ │ │ │ -000277e0: 6e64 2027 5355 4244 4952 5327 292e 2020 nd 'SUBDIRS'). │ │ │ │ │ -000277f0: 466f 7220 696e 7374 616e 6365 2c20 6966 For instance, if │ │ │ │ │ -00027800: 2079 6f75 2064 6566 696e 6520 2753 5542 you define 'SUB │ │ │ │ │ -00027810: 4449 5253 2720 636f 6e64 6974 696f 6e61 DIRS' conditiona │ │ │ │ │ -00027820: 6c6c 790a 7573 696e 6720 2741 435f 5355 lly.using 'AC_SU │ │ │ │ │ -00027830: 4253 5427 2061 6e64 2064 6f20 6e6f 7420 BST' and do not │ │ │ │ │ -00027840: 6465 6669 6e65 2027 4449 5354 5f53 5542 define 'DIST_SUB │ │ │ │ │ -00027850: 4449 5253 2720 6578 706c 6963 6974 6c79 DIRS' explicitly │ │ │ │ │ -00027860: 2c20 6974 2077 696c 6c20 6265 0a64 6566 , it will be.def │ │ │ │ │ -00027870: 6175 6c74 2074 6f20 2724 2853 5542 4449 ault to '$(SUBDI │ │ │ │ │ -00027880: 5253 2927 3b20 616e 6f74 6865 7220 706f RS)'; another po │ │ │ │ │ -00027890: 7373 6962 696c 6974 7920 6973 2074 6f20 ssibility is to │ │ │ │ │ -000278a0: 666f 7263 6520 2744 4953 545f 5355 4244 force 'DIST_SUBD │ │ │ │ │ -000278b0: 4952 5320 3d0a 2428 5355 4244 4952 5329 IRS =.$(SUBDIRS) │ │ │ │ │ -000278c0: 272e 0a0a 2020 204f 6620 636f 7572 7365 '... Of course │ │ │ │ │ -000278d0: 2c20 6469 7265 6374 6f72 6965 7320 7468 , directories th │ │ │ │ │ -000278e0: 6174 2061 7265 206f 6d69 7474 6564 2066 at are omitted f │ │ │ │ │ -000278f0: 726f 6d20 2744 4953 545f 5355 4244 4952 rom 'DIST_SUBDIR │ │ │ │ │ -00027900: 5327 2077 696c 6c20 6e6f 740a 6265 2064 S' will not.be d │ │ │ │ │ -00027910: 6973 7472 6962 7574 6564 2075 6e6c 6573 istributed unles │ │ │ │ │ -00027920: 7320 796f 7520 6d61 6b65 206f 7468 6572 s you make other │ │ │ │ │ -00027930: 2061 7272 616e 6765 6d65 6e74 7320 666f arrangements fo │ │ │ │ │ -00027940: 7220 7468 6973 2074 6f20 6861 7070 656e r this to happen │ │ │ │ │ -00027950: 0a28 666f 7220 696e 7374 616e 6365 2c20 .(for instance, │ │ │ │ │ -00027960: 616c 7761 7973 2072 756e 6e69 6e67 2027 always running ' │ │ │ │ │ -00027970: 6d61 6b65 2064 6973 7427 2069 6e20 6120 make dist' in a │ │ │ │ │ -00027980: 636f 6e66 6967 7572 6174 696f 6e20 7768 configuration wh │ │ │ │ │ -00027990: 6572 6520 616c 6c0a 6469 7265 6374 6f72 ere all.director │ │ │ │ │ -000279a0: 6965 7320 6172 6520 6b6e 6f77 6e20 746f ies are known to │ │ │ │ │ -000279b0: 2061 7070 6561 7220 696e 2027 4449 5354 appear in 'DIST │ │ │ │ │ -000279c0: 5f53 5542 4449 5253 273b 206f 7220 7772 _SUBDIRS'; or wr │ │ │ │ │ -000279d0: 6974 696e 6720 610a 2764 6973 742d 686f iting a.'dist-ho │ │ │ │ │ -000279e0: 6f6b 2720 7461 7267 6574 2074 6f20 6469 ok' target to di │ │ │ │ │ -000279f0: 7374 7269 6275 7465 2074 6865 7365 2064 stribute these d │ │ │ │ │ -00027a00: 6972 6563 746f 7269 6573 292e 0a0a 2020 irectories)... │ │ │ │ │ -00027a10: 2049 6e20 6665 7720 7061 636b 6167 6573 In few packages │ │ │ │ │ -00027a20: 2c20 756e 636f 6e66 6967 7572 6564 2064 , unconfigured d │ │ │ │ │ -00027a30: 6972 6563 746f 7269 6573 2061 7265 206e irectories are n │ │ │ │ │ -00027a40: 6f74 2065 7665 6e20 6578 7065 6374 6564 ot even expected │ │ │ │ │ -00027a50: 2074 6f20 6265 0a64 6973 7472 6962 7574 to be.distribut │ │ │ │ │ -00027a60: 6564 2e20 2041 6c74 686f 7567 6820 7468 ed. Although th │ │ │ │ │ -00027a70: 6573 6520 7061 636b 6167 6573 2064 6f20 ese packages do │ │ │ │ │ -00027a80: 6e6f 7420 7265 7175 6972 6520 7468 6520 not require the │ │ │ │ │ -00027a90: 6166 6f72 656d 656e 7469 6f6e 6564 0a65 aforementioned.e │ │ │ │ │ -00027aa0: 7874 7261 2061 7272 616e 6765 6d65 6e74 xtra arrangement │ │ │ │ │ -00027ab0: 732c 2074 6865 7265 2069 7320 616e 6f74 s, there is anot │ │ │ │ │ -00027ac0: 6865 7220 7069 7466 616c 6c2e 2020 4966 her pitfall. If │ │ │ │ │ -00027ad0: 2074 6865 206e 616d 6520 6f66 2061 0a64 the name of a.d │ │ │ │ │ -00027ae0: 6972 6563 746f 7279 2061 7070 6561 7273 irectory appears │ │ │ │ │ -00027af0: 2069 6e20 2753 5542 4449 5253 2720 6f72 in 'SUBDIRS' or │ │ │ │ │ -00027b00: 2027 4449 5354 5f53 5542 4449 5253 272c 'DIST_SUBDIRS', │ │ │ │ │ -00027b10: 2027 6175 746f 6d61 6b65 2720 7769 6c6c 'automake' will │ │ │ │ │ -00027b20: 206d 616b 650a 7375 7265 2074 6865 2064 make.sure the d │ │ │ │ │ -00027b30: 6972 6563 746f 7279 2065 7869 7374 732e irectory exists. │ │ │ │ │ -00027b40: 2020 436f 6e73 6571 7565 6e74 6c79 2027 Consequently ' │ │ │ │ │ -00027b50: 6175 746f 6d61 6b65 2720 6361 6e6e 6f74 automake' cannot │ │ │ │ │ -00027b60: 2062 6520 7275 6e20 6f6e 0a73 7563 6820 be run on.such │ │ │ │ │ -00027b70: 6120 6469 7374 7269 6275 7469 6f6e 2077 a distribution w │ │ │ │ │ -00027b80: 6865 6e20 6f6e 6520 6469 7265 6374 6f72 hen one director │ │ │ │ │ -00027b90: 7920 6861 7320 6265 656e 206f 6d69 7474 y has been omitt │ │ │ │ │ -00027ba0: 6564 2e20 204f 6e65 2077 6179 2074 6f0a ed. One way to. │ │ │ │ │ -00027bb0: 6176 6f69 6420 7468 6973 2063 6865 636b avoid this check │ │ │ │ │ -00027bc0: 2069 7320 746f 2075 7365 2074 6865 2027 is to use the ' │ │ │ │ │ -00027bd0: 4143 5f53 5542 5354 2720 6d65 7468 6f64 AC_SUBST' method │ │ │ │ │ -00027be0: 2074 6f20 6465 636c 6172 6520 636f 6e64 to declare cond │ │ │ │ │ -00027bf0: 6974 696f 6e61 6c0a 6469 7265 6374 6f72 itional.director │ │ │ │ │ -00027c00: 6965 733b 2073 696e 6365 2027 6175 746f ies; since 'auto │ │ │ │ │ -00027c10: 6d61 6b65 2720 646f 6573 206e 6f74 206b make' does not k │ │ │ │ │ -00027c20: 6e6f 7720 7468 6520 7661 6c75 6573 206f now the values o │ │ │ │ │ -00027c30: 6620 2741 435f 5355 4253 5427 0a76 6172 f 'AC_SUBST'.var │ │ │ │ │ -00027c40: 6961 626c 6573 2069 7420 6361 6e6e 6f74 iables it cannot │ │ │ │ │ -00027c50: 2065 6e73 7572 6520 7468 6520 636f 7272 ensure the corr │ │ │ │ │ -00027c60: 6573 706f 6e64 696e 6720 6469 7265 6374 esponding direct │ │ │ │ │ -00027c70: 6f72 7920 6578 6973 7473 2e0a 0a1f 0a46 ory exists.....F │ │ │ │ │ -00027c80: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -00027c90: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -00027ca0: 416c 7465 726e 6174 6976 652c 2020 4e65 Alternative, Ne │ │ │ │ │ -00027cb0: 7874 3a20 5375 6270 6163 6b61 6765 732c xt: Subpackages, │ │ │ │ │ -00027cc0: 2020 5072 6576 3a20 436f 6e64 6974 696f Prev: Conditio │ │ │ │ │ -00027cd0: 6e61 6c20 5375 6264 6972 6563 746f 7269 nal Subdirectori │ │ │ │ │ -00027ce0: 6573 2c20 2055 703a 2044 6972 6563 746f es, Up: Directo │ │ │ │ │ -00027cf0: 7269 6573 0a0a 372e 3320 416e 2041 6c74 ries..7.3 An Alt │ │ │ │ │ -00027d00: 6572 6e61 7469 7665 2041 7070 726f 6163 ernative Approac │ │ │ │ │ -00027d10: 6820 746f 2053 7562 6469 7265 6374 6f72 h to Subdirector │ │ │ │ │ -00027d20: 6965 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ies.============ │ │ │ │ │ +00027060: 2d2d 0a0a 5468 6520 7365 6d61 6e74 6963 --..The semantic │ │ │ │ │ +00027070: 7320 6f66 2027 4449 5354 5f53 5542 4449 s of 'DIST_SUBDI │ │ │ │ │ +00027080: 5253 2720 6172 6520 6f66 7465 6e20 6d69 RS' are often mi │ │ │ │ │ +00027090: 7375 6e64 6572 7374 6f6f 6420 6279 2073 sunderstood by s │ │ │ │ │ +000270a0: 6f6d 6520 7573 6572 730a 7468 6174 2074 ome users.that t │ │ │ │ │ +000270b0: 7279 2074 6f20 5f63 6f6e 6669 6775 7265 ry to _configure │ │ │ │ │ +000270c0: 2061 6e64 2062 7569 6c64 5f20 7375 6264 and build_ subd │ │ │ │ │ +000270d0: 6972 6563 746f 7269 6573 2063 6f6e 6469 irectories condi │ │ │ │ │ +000270e0: 7469 6f6e 616c 6c79 2e20 2048 6572 6520 tionally. Here │ │ │ │ │ +000270f0: 6279 0a63 6f6e 6669 6775 7269 6e67 2077 by.configuring w │ │ │ │ │ +00027100: 6520 6d65 616e 2063 7265 6174 696e 6720 e mean creating │ │ │ │ │ +00027110: 7468 6520 274d 616b 6566 696c 6527 2028 the 'Makefile' ( │ │ │ │ │ +00027120: 6974 206d 6967 6874 2061 6c73 6f20 696e it might also in │ │ │ │ │ +00027130: 766f 6c76 650a 7275 6e6e 696e 6720 6120 volve.running a │ │ │ │ │ +00027140: 6e65 7374 6564 2027 636f 6e66 6967 7572 nested 'configur │ │ │ │ │ +00027150: 6527 2073 6372 6970 743a 2074 6869 7320 e' script: this │ │ │ │ │ +00027160: 6973 2061 2063 6f73 746c 7920 6f70 6572 is a costly oper │ │ │ │ │ +00027170: 6174 696f 6e20 7468 6174 0a65 7870 6c61 ation that.expla │ │ │ │ │ +00027180: 696e 7320 7768 7920 7065 6f70 6c65 2077 ins why people w │ │ │ │ │ +00027190: 616e 7420 746f 2064 6f20 6974 2063 6f6e ant to do it con │ │ │ │ │ +000271a0: 6469 7469 6f6e 616c 6c79 2c20 6275 7420 ditionally, but │ │ │ │ │ +000271b0: 6f6e 6c79 2074 6865 2027 4d61 6b65 6669 only the 'Makefi │ │ │ │ │ +000271c0: 6c65 270a 6973 2072 656c 6576 616e 7420 le'.is relevant │ │ │ │ │ +000271d0: 746f 2074 6865 2064 6973 6375 7373 696f to the discussio │ │ │ │ │ +000271e0: 6e29 2e0a 0a20 2020 5468 6520 6162 6f76 n)... The abov │ │ │ │ │ +000271f0: 6520 6578 616d 706c 6573 2061 6c6c 2061 e examples all a │ │ │ │ │ +00027200: 7373 756d 6520 7468 6174 2065 7665 7279 ssume that every │ │ │ │ │ +00027210: 2027 4d61 6b65 6669 6c65 2720 6973 2063 'Makefile' is c │ │ │ │ │ +00027220: 7265 6174 6564 2c20 6576 656e 0a69 6e20 reated, even.in │ │ │ │ │ +00027230: 6469 7265 6374 6f72 6965 7320 7468 6174 directories that │ │ │ │ │ +00027240: 2061 7265 206e 6f74 2067 6f69 6e67 2074 are not going t │ │ │ │ │ +00027250: 6f20 6265 2062 7569 6c74 2e20 2054 6865 o be built. The │ │ │ │ │ +00027260: 2073 696d 706c 6520 7265 6173 6f6e 2069 simple reason i │ │ │ │ │ +00027270: 730a 7468 6174 2077 6520 7761 6e74 2027 s.that we want ' │ │ │ │ │ +00027280: 6d61 6b65 2064 6973 7427 2074 6f20 6469 make dist' to di │ │ │ │ │ +00027290: 7374 7269 6275 7465 2065 7665 6e20 7468 stribute even th │ │ │ │ │ +000272a0: 6520 6469 7265 6374 6f72 6965 7320 7468 e directories th │ │ │ │ │ +000272b0: 6174 2061 7265 206e 6f74 0a62 6569 6e67 at are not.being │ │ │ │ │ +000272c0: 2062 7569 6c74 2028 652e 672e 2c20 706c built (e.g., pl │ │ │ │ │ +000272d0: 6174 666f 726d 2d64 6570 656e 6465 6e74 atform-dependent │ │ │ │ │ +000272e0: 2063 6f64 6529 2c20 6865 6e63 6520 276d code), hence 'm │ │ │ │ │ +000272f0: 616b 6520 6469 7374 2720 6d75 7374 0a72 ake dist' must.r │ │ │ │ │ +00027300: 6563 7572 7365 2069 6e74 6f20 7468 6520 ecurse into the │ │ │ │ │ +00027310: 7375 6264 6972 6563 746f 7279 2c20 6865 subdirectory, he │ │ │ │ │ +00027320: 6e63 6520 7468 6973 2064 6972 6563 746f nce this directo │ │ │ │ │ +00027330: 7279 206d 7573 7420 6265 2063 6f6e 6669 ry must be confi │ │ │ │ │ +00027340: 6775 7265 640a 616e 6420 6170 7065 6172 gured.and appear │ │ │ │ │ +00027350: 2069 6e20 2744 4953 545f 5355 4244 4952 in 'DIST_SUBDIR │ │ │ │ │ +00027360: 5327 2e0a 0a20 2020 4275 696c 6469 6e67 S'... Building │ │ │ │ │ +00027370: 2070 6163 6b61 6765 7320 7468 6174 2064 packages that d │ │ │ │ │ +00027380: 6f20 6e6f 7420 636f 6e66 6967 7572 6520 o not configure │ │ │ │ │ +00027390: 6576 6572 7920 7375 6264 6972 6563 746f every subdirecto │ │ │ │ │ +000273a0: 7279 2069 7320 610a 7472 6963 6b79 2062 ry is a.tricky b │ │ │ │ │ +000273b0: 7573 696e 6573 732c 2061 6e64 2077 6520 usiness, and we │ │ │ │ │ +000273c0: 646f 206e 6f74 2072 6563 6f6d 6d65 6e64 do not recommend │ │ │ │ │ +000273d0: 2069 7420 746f 2074 6865 206e 6f76 6963 it to the novic │ │ │ │ │ +000273e0: 6520 6173 2069 7420 6973 2065 6173 790a e as it is easy. │ │ │ │ │ +000273f0: 746f 2070 726f 6475 6365 2061 6e20 696e to produce an in │ │ │ │ │ +00027400: 636f 6d70 6c65 7465 2074 6172 6261 6c6c complete tarball │ │ │ │ │ +00027410: 2062 7920 6d69 7374 616b 652e 2020 5765 by mistake. We │ │ │ │ │ +00027420: 2077 696c 6c20 6e6f 7420 6469 7363 7573 will not discus │ │ │ │ │ +00027430: 7320 7468 6973 0a74 6f70 6963 2069 6e20 s this.topic in │ │ │ │ │ +00027440: 6465 7074 6820 6865 7265 2c20 7965 7420 depth here, yet │ │ │ │ │ +00027450: 666f 7220 7468 6520 6164 7665 6e74 7572 for the adventur │ │ │ │ │ +00027460: 6f75 7320 6865 7265 2061 7265 2061 2066 ous here are a f │ │ │ │ │ +00027470: 6577 2072 756c 6573 2074 6f0a 7265 6d65 ew rules to.reme │ │ │ │ │ +00027480: 6d62 6572 2e0a 0a20 2020 2a20 2753 5542 mber... * 'SUB │ │ │ │ │ +00027490: 4449 5253 2720 7368 6f75 6c64 2061 6c77 DIRS' should alw │ │ │ │ │ +000274a0: 6179 7320 6265 2061 2073 7562 7365 7420 ays be a subset │ │ │ │ │ +000274b0: 6f66 2027 4449 5354 5f53 5542 4449 5253 of 'DIST_SUBDIRS │ │ │ │ │ +000274c0: 272e 0a0a 2020 2020 2049 7420 6d61 6b65 '... It make │ │ │ │ │ +000274d0: 7320 6c69 7474 6c65 2073 656e 7365 2074 s little sense t │ │ │ │ │ +000274e0: 6f20 6861 7665 2061 2064 6972 6563 746f o have a directo │ │ │ │ │ +000274f0: 7279 2069 6e20 2753 5542 4449 5253 2720 ry in 'SUBDIRS' │ │ │ │ │ +00027500: 7468 6174 2069 7320 6e6f 740a 2020 2020 that is not. │ │ │ │ │ +00027510: 2069 6e20 2744 4953 545f 5355 4244 4952 in 'DIST_SUBDIR │ │ │ │ │ +00027520: 5327 2e20 2054 6869 6e6b 206f 6620 7468 S'. Think of th │ │ │ │ │ +00027530: 6520 666f 726d 6572 2061 7320 6120 7761 e former as a wa │ │ │ │ │ +00027540: 7920 746f 2074 656c 6c20 7768 6963 680a y to tell which. │ │ │ │ │ +00027550: 2020 2020 2064 6972 6563 746f 7269 6573 directories │ │ │ │ │ +00027560: 206c 6973 7465 6420 696e 2074 6865 206c listed in the l │ │ │ │ │ +00027570: 6174 7465 7220 7368 6f75 6c64 2062 6520 atter should be │ │ │ │ │ +00027580: 6275 696c 742e 0a20 2020 2a20 416e 7920 built.. * Any │ │ │ │ │ +00027590: 6469 7265 6374 6f72 7920 6c69 7374 6564 directory listed │ │ │ │ │ +000275a0: 2069 6e20 2744 4953 545f 5355 4244 4952 in 'DIST_SUBDIR │ │ │ │ │ +000275b0: 5327 2061 6e64 2027 5355 4244 4952 5327 S' and 'SUBDIRS' │ │ │ │ │ +000275c0: 206d 7573 7420 6265 0a20 2020 2020 636f must be. co │ │ │ │ │ +000275d0: 6e66 6967 7572 6564 2e0a 0a20 2020 2020 nfigured... │ │ │ │ │ +000275e0: 492e 652e 2c20 7468 6520 274d 616b 6566 I.e., the 'Makef │ │ │ │ │ +000275f0: 696c 6527 206d 7573 7420 6578 6973 7473 ile' must exists │ │ │ │ │ +00027600: 206f 7220 7468 6520 7265 6375 7273 6976 or the recursiv │ │ │ │ │ +00027610: 6520 276d 616b 6527 2072 756c 6573 2077 e 'make' rules w │ │ │ │ │ +00027620: 696c 6c0a 2020 2020 206e 6f74 2062 6520 ill. not be │ │ │ │ │ +00027630: 6162 6c65 2074 6f20 7072 6f63 6573 7320 able to process │ │ │ │ │ +00027640: 7468 6520 6469 7265 6374 6f72 792e 0a20 the directory.. │ │ │ │ │ +00027650: 2020 2a20 416e 7920 636f 6e66 6967 7572 * Any configur │ │ │ │ │ +00027660: 6564 2064 6972 6563 746f 7279 206d 7573 ed directory mus │ │ │ │ │ +00027670: 7420 6265 206c 6973 7465 6420 696e 2027 t be listed in ' │ │ │ │ │ +00027680: 4449 5354 5f53 5542 4449 5253 272e 0a0a DIST_SUBDIRS'... │ │ │ │ │ +00027690: 2020 2020 2053 6f20 7468 6174 2074 6865 So that the │ │ │ │ │ +000276a0: 2063 6c65 616e 696e 6720 7275 6c65 7320 cleaning rules │ │ │ │ │ +000276b0: 7265 6d6f 7665 2074 6865 2067 656e 6572 remove the gener │ │ │ │ │ +000276c0: 6174 6564 2027 4d61 6b65 6669 6c65 2773 ated 'Makefile's │ │ │ │ │ +000276d0: 2e20 2049 740a 2020 2020 2077 6f75 6c64 . It. would │ │ │ │ │ +000276e0: 2062 6520 636f 7272 6563 7420 746f 2073 be correct to s │ │ │ │ │ +000276f0: 6565 2027 4449 5354 5f53 5542 4449 5253 ee 'DIST_SUBDIRS │ │ │ │ │ +00027700: 2720 6173 2061 2076 6172 6961 626c 6520 ' as a variable │ │ │ │ │ +00027710: 7468 6174 206c 6973 7473 2061 6c6c 0a20 that lists all. │ │ │ │ │ +00027720: 2020 2020 7468 6520 6469 7265 6374 6f72 the director │ │ │ │ │ +00027730: 6965 7320 7468 6174 2068 6176 6520 6265 ies that have be │ │ │ │ │ +00027740: 656e 2063 6f6e 6669 6775 7265 642e 0a0a en configured... │ │ │ │ │ +00027750: 2020 2049 6e20 6f72 6465 7220 746f 2070 In order to p │ │ │ │ │ +00027760: 7265 7665 6e74 2072 6563 7572 7369 6f6e revent recursion │ │ │ │ │ +00027770: 2069 6e20 736f 6d65 2075 6e63 6f6e 6669 in some unconfi │ │ │ │ │ +00027780: 6775 7265 6420 6469 7265 6374 6f72 7920 gured directory │ │ │ │ │ +00027790: 796f 7520 6d75 7374 0a74 6865 7265 666f you must.therefo │ │ │ │ │ +000277a0: 7265 2065 6e73 7572 6520 7468 6174 2074 re ensure that t │ │ │ │ │ +000277b0: 6869 7320 6469 7265 6374 6f72 7920 646f his directory do │ │ │ │ │ +000277c0: 6573 206e 6f74 2061 7070 6561 7220 696e es not appear in │ │ │ │ │ +000277d0: 2027 4449 5354 5f53 5542 4449 5253 270a 'DIST_SUBDIRS'. │ │ │ │ │ +000277e0: 2861 6e64 2027 5355 4244 4952 5327 292e (and 'SUBDIRS'). │ │ │ │ │ +000277f0: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ +00027800: 6966 2079 6f75 2064 6566 696e 6520 2753 if you define 'S │ │ │ │ │ +00027810: 5542 4449 5253 2720 636f 6e64 6974 696f UBDIRS' conditio │ │ │ │ │ +00027820: 6e61 6c6c 790a 7573 696e 6720 2741 435f nally.using 'AC_ │ │ │ │ │ +00027830: 5355 4253 5427 2061 6e64 2064 6f20 6e6f SUBST' and do no │ │ │ │ │ +00027840: 7420 6465 6669 6e65 2027 4449 5354 5f53 t define 'DIST_S │ │ │ │ │ +00027850: 5542 4449 5253 2720 6578 706c 6963 6974 UBDIRS' explicit │ │ │ │ │ +00027860: 6c79 2c20 6974 2077 696c 6c20 6265 0a64 ly, it will be.d │ │ │ │ │ +00027870: 6566 6175 6c74 2074 6f20 2724 2853 5542 efault to '$(SUB │ │ │ │ │ +00027880: 4449 5253 2927 3b20 616e 6f74 6865 7220 DIRS)'; another │ │ │ │ │ +00027890: 706f 7373 6962 696c 6974 7920 6973 2074 possibility is t │ │ │ │ │ +000278a0: 6f20 666f 7263 6520 2744 4953 545f 5355 o force 'DIST_SU │ │ │ │ │ +000278b0: 4244 4952 5320 3d0a 2428 5355 4244 4952 BDIRS =.$(SUBDIR │ │ │ │ │ +000278c0: 5329 272e 0a0a 2020 204f 6620 636f 7572 S)'... Of cour │ │ │ │ │ +000278d0: 7365 2c20 6469 7265 6374 6f72 6965 7320 se, directories │ │ │ │ │ +000278e0: 7468 6174 2061 7265 206f 6d69 7474 6564 that are omitted │ │ │ │ │ +000278f0: 2066 726f 6d20 2744 4953 545f 5355 4244 from 'DIST_SUBD │ │ │ │ │ +00027900: 4952 5327 2077 696c 6c20 6e6f 740a 6265 IRS' will not.be │ │ │ │ │ +00027910: 2064 6973 7472 6962 7574 6564 2075 6e6c distributed unl │ │ │ │ │ +00027920: 6573 7320 796f 7520 6d61 6b65 206f 7468 ess you make oth │ │ │ │ │ +00027930: 6572 2061 7272 616e 6765 6d65 6e74 7320 er arrangements │ │ │ │ │ +00027940: 666f 7220 7468 6973 2074 6f20 6861 7070 for this to happ │ │ │ │ │ +00027950: 656e 0a28 666f 7220 696e 7374 616e 6365 en.(for instance │ │ │ │ │ +00027960: 2c20 616c 7761 7973 2072 756e 6e69 6e67 , always running │ │ │ │ │ +00027970: 2027 6d61 6b65 2064 6973 7427 2069 6e20 'make dist' in │ │ │ │ │ +00027980: 6120 636f 6e66 6967 7572 6174 696f 6e20 a configuration │ │ │ │ │ +00027990: 7768 6572 6520 616c 6c0a 6469 7265 6374 where all.direct │ │ │ │ │ +000279a0: 6f72 6965 7320 6172 6520 6b6e 6f77 6e20 ories are known │ │ │ │ │ +000279b0: 746f 2061 7070 6561 7220 696e 2027 4449 to appear in 'DI │ │ │ │ │ +000279c0: 5354 5f53 5542 4449 5253 273b 206f 7220 ST_SUBDIRS'; or │ │ │ │ │ +000279d0: 7772 6974 696e 6720 610a 2764 6973 742d writing a.'dist- │ │ │ │ │ +000279e0: 686f 6f6b 2720 7461 7267 6574 2074 6f20 hook' target to │ │ │ │ │ +000279f0: 6469 7374 7269 6275 7465 2074 6865 7365 distribute these │ │ │ │ │ +00027a00: 2064 6972 6563 746f 7269 6573 292e 0a0a directories)... │ │ │ │ │ +00027a10: 2020 2049 6e20 6665 7720 7061 636b 6167 In few packag │ │ │ │ │ +00027a20: 6573 2c20 756e 636f 6e66 6967 7572 6564 es, unconfigured │ │ │ │ │ +00027a30: 2064 6972 6563 746f 7269 6573 2061 7265 directories are │ │ │ │ │ +00027a40: 206e 6f74 2065 7665 6e20 6578 7065 6374 not even expect │ │ │ │ │ +00027a50: 6564 2074 6f20 6265 0a64 6973 7472 6962 ed to be.distrib │ │ │ │ │ +00027a60: 7574 6564 2e20 2041 6c74 686f 7567 6820 uted. Although │ │ │ │ │ +00027a70: 7468 6573 6520 7061 636b 6167 6573 2064 these packages d │ │ │ │ │ +00027a80: 6f20 6e6f 7420 7265 7175 6972 6520 7468 o not require th │ │ │ │ │ +00027a90: 6520 6166 6f72 656d 656e 7469 6f6e 6564 e aforementioned │ │ │ │ │ +00027aa0: 0a65 7874 7261 2061 7272 616e 6765 6d65 .extra arrangeme │ │ │ │ │ +00027ab0: 6e74 732c 2074 6865 7265 2069 7320 616e nts, there is an │ │ │ │ │ +00027ac0: 6f74 6865 7220 7069 7466 616c 6c2e 2020 other pitfall. │ │ │ │ │ +00027ad0: 4966 2074 6865 206e 616d 6520 6f66 2061 If the name of a │ │ │ │ │ +00027ae0: 0a64 6972 6563 746f 7279 2061 7070 6561 .directory appea │ │ │ │ │ +00027af0: 7273 2069 6e20 2753 5542 4449 5253 2720 rs in 'SUBDIRS' │ │ │ │ │ +00027b00: 6f72 2027 4449 5354 5f53 5542 4449 5253 or 'DIST_SUBDIRS │ │ │ │ │ +00027b10: 272c 2027 6175 746f 6d61 6b65 2720 7769 ', 'automake' wi │ │ │ │ │ +00027b20: 6c6c 206d 616b 650a 7375 7265 2074 6865 ll make.sure the │ │ │ │ │ +00027b30: 2064 6972 6563 746f 7279 2065 7869 7374 directory exist │ │ │ │ │ +00027b40: 732e 2020 436f 6e73 6571 7565 6e74 6c79 s. Consequently │ │ │ │ │ +00027b50: 2027 6175 746f 6d61 6b65 2720 6361 6e6e 'automake' cann │ │ │ │ │ +00027b60: 6f74 2062 6520 7275 6e20 6f6e 0a73 7563 ot be run on.suc │ │ │ │ │ +00027b70: 6820 6120 6469 7374 7269 6275 7469 6f6e h a distribution │ │ │ │ │ +00027b80: 2077 6865 6e20 6f6e 6520 6469 7265 6374 when one direct │ │ │ │ │ +00027b90: 6f72 7920 6861 7320 6265 656e 206f 6d69 ory has been omi │ │ │ │ │ +00027ba0: 7474 6564 2e20 204f 6e65 2077 6179 2074 tted. One way t │ │ │ │ │ +00027bb0: 6f0a 6176 6f69 6420 7468 6973 2063 6865 o.avoid this che │ │ │ │ │ +00027bc0: 636b 2069 7320 746f 2075 7365 2074 6865 ck is to use the │ │ │ │ │ +00027bd0: 2027 4143 5f53 5542 5354 2720 6d65 7468 'AC_SUBST' meth │ │ │ │ │ +00027be0: 6f64 2074 6f20 6465 636c 6172 6520 636f od to declare co │ │ │ │ │ +00027bf0: 6e64 6974 696f 6e61 6c0a 6469 7265 6374 nditional.direct │ │ │ │ │ +00027c00: 6f72 6965 733b 2073 696e 6365 2027 6175 ories; since 'au │ │ │ │ │ +00027c10: 746f 6d61 6b65 2720 646f 6573 206e 6f74 tomake' does not │ │ │ │ │ +00027c20: 206b 6e6f 7720 7468 6520 7661 6c75 6573 know the values │ │ │ │ │ +00027c30: 206f 6620 2741 435f 5355 4253 5427 0a76 of 'AC_SUBST'.v │ │ │ │ │ +00027c40: 6172 6961 626c 6573 2069 7420 6361 6e6e ariables it cann │ │ │ │ │ +00027c50: 6f74 2065 6e73 7572 6520 7468 6520 636f ot ensure the co │ │ │ │ │ +00027c60: 7272 6573 706f 6e64 696e 6720 6469 7265 rresponding dire │ │ │ │ │ +00027c70: 6374 6f72 7920 6578 6973 7473 2e0a 0a1f ctory exists.... │ │ │ │ │ +00027c80: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +00027c90: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +00027ca0: 3a20 416c 7465 726e 6174 6976 652c 2020 : Alternative, │ │ │ │ │ +00027cb0: 4e65 7874 3a20 5375 6270 6163 6b61 6765 Next: Subpackage │ │ │ │ │ +00027cc0: 732c 2020 5072 6576 3a20 436f 6e64 6974 s, Prev: Condit │ │ │ │ │ +00027cd0: 696f 6e61 6c20 5375 6264 6972 6563 746f ional Subdirecto │ │ │ │ │ +00027ce0: 7269 6573 2c20 2055 703a 2044 6972 6563 ries, Up: Direc │ │ │ │ │ +00027cf0: 746f 7269 6573 0a0a 372e 3320 416e 2041 tories..7.3 An A │ │ │ │ │ +00027d00: 6c74 6572 6e61 7469 7665 2041 7070 726f lternative Appro │ │ │ │ │ +00027d10: 6163 6820 746f 2053 7562 6469 7265 6374 ach to Subdirect │ │ │ │ │ +00027d20: 6f72 6965 730a 3d3d 3d3d 3d3d 3d3d 3d3d ories.========== │ │ │ │ │ 00027d30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00027d40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00027d50: 3d0a 0a49 6620 796f 7527 7665 2065 7665 =..If you've eve │ │ │ │ │ -00027d60: 7220 7265 6164 2050 6574 6572 204d 696c r read Peter Mil │ │ │ │ │ -00027d70: 6c65 7227 7320 6578 6365 6c6c 656e 7420 ler's excellent │ │ │ │ │ -00027d80: 7061 7065 722c 2052 6563 7572 7369 7665 paper, Recursive │ │ │ │ │ -00027d90: 204d 616b 650a 436f 6e73 6964 6572 6564 Make.Considered │ │ │ │ │ -00027da0: 2048 6172 6d66 756c 2028 6874 7470 3a2f Harmful (http:/ │ │ │ │ │ -00027db0: 2f6d 696c 6c65 722e 656d 752e 6964 2e61 /miller.emu.id.a │ │ │ │ │ -00027dc0: 752f 706d 696c 6c65 722f 626f 6f6b 732f u/pmiller/books/ │ │ │ │ │ -00027dd0: 726d 6368 2f29 2c20 7468 650a 7072 6563 rmch/), the.prec │ │ │ │ │ -00027de0: 6564 696e 6720 7365 6374 696f 6e73 206f eding sections o │ │ │ │ │ -00027df0: 6e20 7468 6520 7573 6520 6f66 2073 7562 n the use of sub │ │ │ │ │ -00027e00: 6469 7265 6374 6f72 6965 7320 7769 6c6c directories will │ │ │ │ │ -00027e10: 2070 726f 6261 626c 7920 636f 6d65 2061 probably come a │ │ │ │ │ -00027e20: 730a 756e 7765 6c63 6f6d 6520 6164 7669 s.unwelcome advi │ │ │ │ │ -00027e30: 6365 2e20 2046 6f72 2074 686f 7365 2077 ce. For those w │ │ │ │ │ -00027e40: 686f 2068 6176 656e 2774 2072 6561 6420 ho haven't read │ │ │ │ │ -00027e50: 7468 6520 7061 7065 722c 204d 696c 6c65 the paper, Mille │ │ │ │ │ -00027e60: 7227 7320 6d61 696e 0a74 6865 7369 7320 r's main.thesis │ │ │ │ │ -00027e70: 6973 2074 6861 7420 7265 6375 7273 6976 is that recursiv │ │ │ │ │ -00027e80: 6520 276d 616b 6527 2069 6e76 6f63 6174 e 'make' invocat │ │ │ │ │ -00027e90: 696f 6e73 2061 7265 2062 6f74 6820 736c ions are both sl │ │ │ │ │ -00027ea0: 6f77 2061 6e64 0a65 7272 6f72 2d70 726f ow and.error-pro │ │ │ │ │ -00027eb0: 6e65 2e0a 0a20 2020 4175 746f 6d61 6b65 ne... Automake │ │ │ │ │ -00027ec0: 2070 726f 7669 6465 7320 7375 6666 6963 provides suffic │ │ │ │ │ -00027ed0: 6965 6e74 2063 726f 7373 2d64 6972 6563 ient cross-direc │ │ │ │ │ -00027ee0: 746f 7279 2073 7570 706f 7274 2028 3129 tory support (1) │ │ │ │ │ -00027ef0: 2074 6f20 656e 6162 6c65 0a79 6f75 2074 to enable.you t │ │ │ │ │ -00027f00: 6f20 7772 6974 6520 6120 7369 6e67 6c65 o write a single │ │ │ │ │ -00027f10: 2027 4d61 6b65 6669 6c65 2e61 6d27 2066 'Makefile.am' f │ │ │ │ │ -00027f20: 6f72 2061 2063 6f6d 706c 6578 206d 756c or a complex mul │ │ │ │ │ -00027f30: 7469 2d64 6972 6563 746f 7279 0a70 6163 ti-directory.pac │ │ │ │ │ -00027f40: 6b61 6765 2e0a 0a20 2020 4279 2064 6566 kage... By def │ │ │ │ │ -00027f50: 6175 6c74 2061 6e20 696e 7374 616c 6c61 ault an installa │ │ │ │ │ -00027f60: 626c 6520 6669 6c65 2073 7065 6369 6669 ble file specifi │ │ │ │ │ -00027f70: 6564 2069 6e20 6120 7375 6264 6972 6563 ed in a subdirec │ │ │ │ │ -00027f80: 746f 7279 2077 696c 6c20 6861 7665 0a69 tory will have.i │ │ │ │ │ -00027f90: 7473 2064 6972 6563 746f 7279 206e 616d ts directory nam │ │ │ │ │ -00027fa0: 6520 7374 7269 7070 6564 2062 6566 6f72 e stripped befor │ │ │ │ │ -00027fb0: 6520 696e 7374 616c 6c61 7469 6f6e 2e20 e installation. │ │ │ │ │ -00027fc0: 2046 6f72 2069 6e73 7461 6e63 652c 2069 For instance, i │ │ │ │ │ -00027fd0: 6e20 7468 6973 0a65 7861 6d70 6c65 2c20 n this.example, │ │ │ │ │ -00027fe0: 7468 6520 6865 6164 6572 2066 696c 6520 the header file │ │ │ │ │ -00027ff0: 7769 6c6c 2062 6520 696e 7374 616c 6c65 will be installe │ │ │ │ │ -00028000: 6420 6173 2027 2428 696e 636c 7564 6564 d as '$(included │ │ │ │ │ -00028010: 6972 292f 7374 6469 6f2e 6827 3a0a 0a20 ir)/stdio.h':.. │ │ │ │ │ -00028020: 2020 2020 696e 636c 7564 655f 4845 4144 include_HEAD │ │ │ │ │ -00028030: 4552 5320 3d20 696e 632f 7374 6469 6f2e ERS = inc/stdio. │ │ │ │ │ -00028040: 680a 0a20 2020 486f 7765 7665 722c 2074 h.. However, t │ │ │ │ │ -00028050: 6865 2027 6e6f 6261 7365 5f27 2070 7265 he 'nobase_' pre │ │ │ │ │ -00028060: 6669 7820 6361 6e20 6265 2075 7365 6420 fix can be used │ │ │ │ │ -00028070: 746f 2063 6972 6375 6d76 656e 7420 7468 to circumvent th │ │ │ │ │ -00028080: 6973 2070 6174 680a 7374 7269 7070 696e is path.strippin │ │ │ │ │ -00028090: 672e 2020 496e 2074 6869 7320 6578 616d g. In this exam │ │ │ │ │ -000280a0: 706c 652c 2074 6865 2068 6561 6465 7220 ple, the header │ │ │ │ │ -000280b0: 6669 6c65 2077 696c 6c20 6265 2069 6e73 file will be ins │ │ │ │ │ -000280c0: 7461 6c6c 6564 2061 730a 2724 2869 6e63 talled as.'$(inc │ │ │ │ │ -000280d0: 6c75 6465 6469 7229 2f73 7973 2f74 7970 ludedir)/sys/typ │ │ │ │ │ -000280e0: 6573 2e68 273a 0a0a 2020 2020 206e 6f62 es.h':.. nob │ │ │ │ │ -000280f0: 6173 655f 696e 636c 7564 655f 4845 4144 ase_include_HEAD │ │ │ │ │ -00028100: 4552 5320 3d20 7379 732f 7479 7065 732e ERS = sys/types. │ │ │ │ │ -00028110: 680a 0a20 2020 276e 6f62 6173 655f 2720 h.. 'nobase_' │ │ │ │ │ -00028120: 7368 6f75 6c64 2062 6520 7370 6563 6966 should be specif │ │ │ │ │ -00028130: 6965 6420 6669 7273 7420 7768 656e 2075 ied first when u │ │ │ │ │ -00028140: 7365 6420 696e 2063 6f6e 6a75 6e63 7469 sed in conjuncti │ │ │ │ │ -00028150: 6f6e 2077 6974 680a 6569 7468 6572 2027 on with.either ' │ │ │ │ │ -00028160: 6469 7374 5f27 206f 7220 276e 6f64 6973 dist_' or 'nodis │ │ │ │ │ -00028170: 745f 2720 282a 6e6f 7465 2046 696e 652d t_' (*note Fine- │ │ │ │ │ -00028180: 6772 6169 6e65 6420 4469 7374 7269 6275 grained Distribu │ │ │ │ │ -00028190: 7469 6f6e 2043 6f6e 7472 6f6c 3a3a 292e tion Control::). │ │ │ │ │ -000281a0: 0a46 6f72 2069 6e73 7461 6e63 653a 0a0a .For instance:.. │ │ │ │ │ -000281b0: 2020 2020 206e 6f62 6173 655f 6469 7374 nobase_dist │ │ │ │ │ -000281c0: 5f70 6b67 6461 7461 5f44 4154 4120 3d20 _pkgdata_DATA = │ │ │ │ │ -000281d0: 696d 6167 6573 2f76 6f72 7465 782e 7067 images/vortex.pg │ │ │ │ │ -000281e0: 6d20 736f 756e 6473 2f77 6869 726c 2e6f m sounds/whirl.o │ │ │ │ │ -000281f0: 6767 0a0a 2020 2046 696e 616c 6c79 2c20 gg.. Finally, │ │ │ │ │ -00028200: 6e6f 7465 2074 6861 7420 6120 7661 7269 note that a vari │ │ │ │ │ -00028210: 6162 6c65 2075 7369 6e67 2074 6865 2027 able using the ' │ │ │ │ │ -00028220: 6e6f 6261 7365 5f27 2070 7265 6669 7820 nobase_' prefix │ │ │ │ │ -00028230: 6361 6e20 6f66 7465 6e20 6265 0a72 6570 can often be.rep │ │ │ │ │ -00028240: 6c61 6365 6420 6279 2073 6576 6572 616c laced by several │ │ │ │ │ -00028250: 2076 6172 6961 626c 6573 2c20 6f6e 6520 variables, one │ │ │ │ │ -00028260: 666f 7220 6561 6368 2064 6573 7469 6e61 for each destina │ │ │ │ │ -00028270: 7469 6f6e 2064 6972 6563 746f 7279 2028 tion directory ( │ │ │ │ │ -00028280: 2a6e 6f74 650a 556e 6966 6f72 6d3a 3a29 *note.Uniform::) │ │ │ │ │ -00028290: 2e20 2046 6f72 2069 6e73 7461 6e63 652c . For instance, │ │ │ │ │ -000282a0: 2074 6865 206c 6173 7420 6578 616d 706c the last exampl │ │ │ │ │ -000282b0: 6520 636f 756c 6420 6265 2072 6577 7269 e could be rewri │ │ │ │ │ -000282c0: 7474 656e 2061 730a 666f 6c6c 6f77 733a tten as.follows: │ │ │ │ │ -000282d0: 0a0a 2020 2020 2069 6d61 6765 7364 6972 .. imagesdir │ │ │ │ │ -000282e0: 203d 2024 2870 6b67 6461 7461 6469 7229 = $(pkgdatadir) │ │ │ │ │ -000282f0: 2f69 6d61 6765 730a 2020 2020 2073 6f75 /images. sou │ │ │ │ │ -00028300: 6e64 7364 6972 203d 2024 2870 6b67 6461 ndsdir = $(pkgda │ │ │ │ │ -00028310: 7461 6469 7229 2f73 6f75 6e64 730a 2020 tadir)/sounds. │ │ │ │ │ -00028320: 2020 2064 6973 745f 696d 6167 6573 5f44 dist_images_D │ │ │ │ │ -00028330: 4154 4120 3d20 696d 6167 6573 2f76 6f72 ATA = images/vor │ │ │ │ │ -00028340: 7465 782e 7067 6d0a 2020 2020 2064 6973 tex.pgm. dis │ │ │ │ │ -00028350: 745f 736f 756e 6473 5f44 4154 4120 3d20 t_sounds_DATA = │ │ │ │ │ -00028360: 736f 756e 6473 2f77 6869 726c 2e6f 6767 sounds/whirl.ogg │ │ │ │ │ -00028370: 0a0a 5468 6973 206c 6174 7465 7220 7379 ..This latter sy │ │ │ │ │ -00028380: 6e74 6178 206d 616b 6573 2069 7420 706f ntax makes it po │ │ │ │ │ -00028390: 7373 6962 6c65 2074 6f20 6368 616e 6765 ssible to change │ │ │ │ │ -000283a0: 206f 6e65 2064 6573 7469 6e61 7469 6f6e one destination │ │ │ │ │ -000283b0: 2064 6972 6563 746f 7279 0a77 6974 686f directory.witho │ │ │ │ │ -000283c0: 7574 2063 6861 6e67 696e 6720 7468 6520 ut changing the │ │ │ │ │ -000283d0: 6c61 796f 7574 206f 6620 7468 6520 736f layout of the so │ │ │ │ │ -000283e0: 7572 6365 2074 7265 652e 0a0a 2020 2043 urce tree... C │ │ │ │ │ -000283f0: 7572 7265 6e74 6c79 2c20 276e 6f62 6173 urrently, 'nobas │ │ │ │ │ -00028400: 655f 2a5f 4c54 4c49 4252 4152 4945 5327 e_*_LTLIBRARIES' │ │ │ │ │ -00028410: 2061 7265 2074 6865 206f 6e6c 7920 6578 are the only ex │ │ │ │ │ -00028420: 6365 7074 696f 6e20 746f 2074 6869 730a ception to this. │ │ │ │ │ -00028430: 7275 6c65 2c20 696e 2074 6861 7420 7468 rule, in that th │ │ │ │ │ -00028440: 6572 6520 6973 206e 6f20 7061 7274 6963 ere is no partic │ │ │ │ │ -00028450: 756c 6172 2069 6e73 7461 6c6c 6174 696f ular installatio │ │ │ │ │ -00028460: 6e20 6f72 6465 7220 6775 6172 616e 7465 n order guarante │ │ │ │ │ -00028470: 6520 666f 7220 616e 0a6f 7468 6572 7769 e for an.otherwi │ │ │ │ │ -00028480: 7365 2065 7175 6976 616c 656e 7420 7365 se equivalent se │ │ │ │ │ -00028490: 7420 6f66 2076 6172 6961 626c 6573 2077 t of variables w │ │ │ │ │ -000284a0: 6974 686f 7574 2027 6e6f 6261 7365 5f27 ithout 'nobase_' │ │ │ │ │ -000284b0: 2070 7265 6669 782e 0a0a 2020 202d 2d2d prefix... --- │ │ │ │ │ -000284c0: 2d2d 2d2d 2d2d 2d20 466f 6f74 6e6f 7465 ------- Footnote │ │ │ │ │ -000284d0: 7320 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 s ----------.. │ │ │ │ │ -000284e0: 2028 3129 2057 6520 6265 6c69 6576 652e (1) We believe. │ │ │ │ │ -000284f0: 2020 5468 6973 2077 6f72 6b20 6973 206e This work is n │ │ │ │ │ -00028500: 6577 2061 6e64 2074 6865 7265 2061 7265 ew and there are │ │ │ │ │ -00028510: 2070 726f 6261 626c 7920 7761 7274 732e probably warts. │ │ │ │ │ -00028520: 0a2a 4e6f 7465 2049 6e74 726f 6475 6374 .*Note Introduct │ │ │ │ │ -00028530: 696f 6e3a 3a2c 2066 6f72 2069 6e66 6f72 ion::, for infor │ │ │ │ │ -00028540: 6d61 7469 6f6e 206f 6e20 7265 706f 7274 mation on report │ │ │ │ │ -00028550: 696e 6720 6275 6773 2e0a 0a1f 0a46 696c ing bugs.....Fil │ │ │ │ │ -00028560: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -00028570: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5375 .info, Node: Su │ │ │ │ │ -00028580: 6270 6163 6b61 6765 732c 2020 5072 6576 bpackages, Prev │ │ │ │ │ -00028590: 3a20 416c 7465 726e 6174 6976 652c 2020 : Alternative, │ │ │ │ │ -000285a0: 5570 3a20 4469 7265 6374 6f72 6965 730a Up: Directories. │ │ │ │ │ -000285b0: 0a37 2e34 204e 6573 7469 6e67 2050 6163 .7.4 Nesting Pac │ │ │ │ │ -000285c0: 6b61 6765 730a 3d3d 3d3d 3d3d 3d3d 3d3d kages.========== │ │ │ │ │ -000285d0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 496e 2074 ==========..In t │ │ │ │ │ -000285e0: 6865 2047 4e55 2042 7569 6c64 2053 7973 he GNU Build Sys │ │ │ │ │ -000285f0: 7465 6d2c 2070 6163 6b61 6765 7320 6361 tem, packages ca │ │ │ │ │ -00028600: 6e20 6265 206e 6573 7465 6420 746f 2061 n be nested to a │ │ │ │ │ -00028610: 7262 6974 7261 7279 2064 6570 7468 2e0a rbitrary depth.. │ │ │ │ │ -00028620: 5468 6973 206d 6561 6e73 2074 6861 7420 This means that │ │ │ │ │ -00028630: 6120 7061 636b 6167 6520 6361 6e20 656d a package can em │ │ │ │ │ -00028640: 6265 6420 6f74 6865 7220 7061 636b 6167 bed other packag │ │ │ │ │ -00028650: 6573 2077 6974 6820 7468 6569 7220 6f77 es with their ow │ │ │ │ │ -00028660: 6e0a 2763 6f6e 6669 6775 7265 272c 2027 n.'configure', ' │ │ │ │ │ -00028670: 4d61 6b65 6669 6c65 2773 2c20 6574 632e Makefile's, etc. │ │ │ │ │ -00028680: 0a0a 2020 2054 6865 7365 206f 7468 6572 .. These other │ │ │ │ │ -00028690: 2070 6163 6b61 6765 7320 7368 6f75 6c64 packages should │ │ │ │ │ -000286a0: 206a 7573 7420 6170 7065 6172 2061 7320 just appear as │ │ │ │ │ -000286b0: 7375 6264 6972 6563 746f 7269 6573 206f subdirectories o │ │ │ │ │ -000286c0: 6620 7468 6569 720a 7061 7265 6e74 2070 f their.parent p │ │ │ │ │ -000286d0: 6163 6b61 6765 2e20 2054 6865 7920 6d75 ackage. They mu │ │ │ │ │ -000286e0: 7374 2062 6520 6c69 7374 6564 2069 6e20 st be listed in │ │ │ │ │ -000286f0: 2753 5542 4449 5253 2720 6c69 6b65 206f 'SUBDIRS' like o │ │ │ │ │ -00028700: 7468 6572 206f 7264 696e 6172 790a 6469 ther ordinary.di │ │ │ │ │ -00028710: 7265 6374 6f72 6965 732e 2020 486f 7765 rectories. Howe │ │ │ │ │ -00028720: 7665 7220 7468 6520 7375 6270 6163 6b61 ver the subpacka │ │ │ │ │ -00028730: 6765 2773 2027 4d61 6b65 6669 6c65 2773 ge's 'Makefile's │ │ │ │ │ -00028740: 2073 686f 756c 6420 6265 206f 7574 7075 should be outpu │ │ │ │ │ -00028750: 7420 6279 0a69 7473 206f 776e 2027 636f t by.its own 'co │ │ │ │ │ -00028760: 6e66 6967 7572 6527 2073 6372 6970 742c nfigure' script, │ │ │ │ │ -00028770: 206e 6f74 2062 7920 7468 6520 7061 7265 not by the pare │ │ │ │ │ -00028780: 6e74 2773 2027 636f 6e66 6967 7572 6527 nt's 'configure' │ │ │ │ │ -00028790: 2e20 2054 6869 7320 6973 0a61 6368 6965 . This is.achie │ │ │ │ │ -000287a0: 7665 6420 7573 696e 6720 7468 6520 2741 ved using the 'A │ │ │ │ │ -000287b0: 435f 434f 4e46 4947 5f53 5542 4449 5253 C_CONFIG_SUBDIRS │ │ │ │ │ -000287c0: 2720 4175 746f 636f 6e66 206d 6163 726f ' Autoconf macro │ │ │ │ │ -000287d0: 2028 2a6e 6f74 650a 4143 5f43 4f4e 4649 (*note.AC_CONFI │ │ │ │ │ -000287e0: 475f 5355 4244 4952 533a 2028 6175 746f G_SUBDIRS: (auto │ │ │ │ │ -000287f0: 636f 6e66 2953 7562 6469 7265 6374 6f72 conf)Subdirector │ │ │ │ │ -00028800: 6965 732e 292e 0a0a 2020 2048 6572 6520 ies.)... Here │ │ │ │ │ -00028810: 6973 2061 6e20 6578 616d 706c 6520 7061 is an example pa │ │ │ │ │ -00028820: 636b 6167 6520 666f 7220 616e 2027 6172 ckage for an 'ar │ │ │ │ │ -00028830: 6d27 2070 726f 6772 616d 2074 6861 7420 m' program that │ │ │ │ │ -00028840: 6c69 6e6b 7320 7769 7468 2061 0a27 6861 links with a.'ha │ │ │ │ │ -00028850: 6e64 2720 6c69 6272 6172 7920 7468 6174 nd' library that │ │ │ │ │ -00028860: 2069 7320 6120 6e65 7374 6564 2070 6163 is a nested pac │ │ │ │ │ -00028870: 6b61 6765 2069 6e20 7375 6264 6972 6563 kage in subdirec │ │ │ │ │ -00028880: 746f 7279 2027 6861 6e64 2f27 2e0a 0a20 tory 'hand/'... │ │ │ │ │ -00028890: 2020 2761 726d 2727 7320 2763 6f6e 6669 'arm''s 'confi │ │ │ │ │ -000288a0: 6775 7265 2e61 6327 3a0a 0a20 2020 2020 gure.ac':.. │ │ │ │ │ -000288b0: 4143 5f49 4e49 5428 5b61 726d 5d2c 205b AC_INIT([arm], [ │ │ │ │ │ -000288c0: 312e 305d 290a 2020 2020 2041 435f 434f 1.0]). AC_CO │ │ │ │ │ -000288d0: 4e46 4947 5f41 5558 5f44 4952 285b 2e5d NFIG_AUX_DIR([.] │ │ │ │ │ -000288e0: 290a 2020 2020 2041 4d5f 494e 4954 5f41 ). AM_INIT_A │ │ │ │ │ -000288f0: 5554 4f4d 414b 450a 2020 2020 2041 435f UTOMAKE. AC_ │ │ │ │ │ -00028900: 5052 4f47 5f43 430a 2020 2020 2041 435f PROG_CC. AC_ │ │ │ │ │ -00028910: 434f 4e46 4947 5f46 494c 4553 285b 4d61 CONFIG_FILES([Ma │ │ │ │ │ -00028920: 6b65 6669 6c65 5d29 0a20 2020 2020 2320 kefile]). # │ │ │ │ │ -00028930: 4361 6c6c 2068 616e 6427 7320 2e2f 636f Call hand's ./co │ │ │ │ │ -00028940: 6e66 6967 7572 6520 7363 7269 7074 2072 nfigure script r │ │ │ │ │ -00028950: 6563 7572 7369 7665 6c79 2e0a 2020 2020 ecursively.. │ │ │ │ │ -00028960: 2041 435f 434f 4e46 4947 5f53 5542 4449 AC_CONFIG_SUBDI │ │ │ │ │ -00028970: 5253 285b 6861 6e64 5d29 0a20 2020 2020 RS([hand]). │ │ │ │ │ -00028980: 4143 5f4f 5554 5055 540a 0a20 2020 2761 AC_OUTPUT.. 'a │ │ │ │ │ -00028990: 726d 2727 7320 274d 616b 6566 696c 652e rm''s 'Makefile. │ │ │ │ │ -000289a0: 616d 273a 0a0a 2020 2020 2023 2042 7569 am':.. # Bui │ │ │ │ │ -000289b0: 6c64 2074 6865 206c 6962 7261 7279 2069 ld the library i │ │ │ │ │ -000289c0: 6e20 7468 6520 6861 6e64 2073 7562 6469 n the hand subdi │ │ │ │ │ -000289d0: 7265 6374 6f72 7920 6669 7273 742e 0a20 rectory first.. │ │ │ │ │ -000289e0: 2020 2020 5355 4244 4952 5320 3d20 6861 SUBDIRS = ha │ │ │ │ │ -000289f0: 6e64 0a0a 2020 2020 2023 2049 6e63 6c75 nd.. # Inclu │ │ │ │ │ -00028a00: 6465 2068 616e 6427 7320 6865 6164 6572 de hand's header │ │ │ │ │ -00028a10: 2077 6865 6e20 636f 6d70 696c 696e 6720 when compiling │ │ │ │ │ -00028a20: 7468 6973 2064 6972 6563 746f 7279 2e0a this directory.. │ │ │ │ │ -00028a30: 2020 2020 2041 4d5f 4350 5046 4c41 4753 AM_CPPFLAGS │ │ │ │ │ -00028a40: 203d 202d 4924 2873 7263 6469 7229 2f68 = -I$(srcdir)/h │ │ │ │ │ -00028a50: 616e 640a 0a20 2020 2020 6269 6e5f 5052 and.. bin_PR │ │ │ │ │ -00028a60: 4f47 5241 4d53 203d 2061 726d 0a20 2020 OGRAMS = arm. │ │ │ │ │ -00028a70: 2020 6172 6d5f 534f 5552 4345 5320 3d20 arm_SOURCES = │ │ │ │ │ -00028a80: 6172 6d2e 630a 2020 2020 2023 206c 696e arm.c. # lin │ │ │ │ │ -00028a90: 6b20 7769 7468 2074 6865 2068 616e 6420 k with the hand │ │ │ │ │ -00028aa0: 6c69 6272 6172 792e 0a20 2020 2020 6172 library.. ar │ │ │ │ │ -00028ab0: 6d5f 4c44 4144 4420 3d20 6861 6e64 2f6c m_LDADD = hand/l │ │ │ │ │ -00028ac0: 6962 6861 6e64 2e61 0a0a 2020 204e 6f77 ibhand.a.. Now │ │ │ │ │ -00028ad0: 2068 6572 6520 6973 2027 6861 6e64 2727 here is 'hand'' │ │ │ │ │ -00028ae0: 7320 2768 616e 642f 636f 6e66 6967 7572 s 'hand/configur │ │ │ │ │ -00028af0: 652e 6163 273a 0a0a 2020 2020 2041 435f e.ac':.. AC_ │ │ │ │ │ -00028b00: 494e 4954 285b 6861 6e64 5d2c 205b 312e INIT([hand], [1. │ │ │ │ │ -00028b10: 325d 290a 2020 2020 2041 435f 434f 4e46 2]). AC_CONF │ │ │ │ │ -00028b20: 4947 5f41 5558 5f44 4952 285b 2e5d 290a IG_AUX_DIR([.]). │ │ │ │ │ -00028b30: 2020 2020 2041 4d5f 494e 4954 5f41 5554 AM_INIT_AUT │ │ │ │ │ -00028b40: 4f4d 414b 450a 2020 2020 2041 435f 5052 OMAKE. AC_PR │ │ │ │ │ -00028b50: 4f47 5f43 430a 2020 2020 2041 4d5f 5052 OG_CC. AM_PR │ │ │ │ │ -00028b60: 4f47 5f41 520a 2020 2020 2041 435f 5052 OG_AR. AC_PR │ │ │ │ │ -00028b70: 4f47 5f52 414e 4c49 420a 2020 2020 2041 OG_RANLIB. A │ │ │ │ │ -00028b80: 435f 434f 4e46 4947 5f46 494c 4553 285b C_CONFIG_FILES([ │ │ │ │ │ -00028b90: 4d61 6b65 6669 6c65 5d29 0a20 2020 2020 Makefile]). │ │ │ │ │ -00028ba0: 4143 5f4f 5554 5055 540a 0a61 6e64 2069 AC_OUTPUT..and i │ │ │ │ │ -00028bb0: 7473 2027 6861 6e64 2f4d 616b 6566 696c ts 'hand/Makefil │ │ │ │ │ -00028bc0: 652e 616d 273a 0a0a 2020 2020 206c 6962 e.am':.. lib │ │ │ │ │ -00028bd0: 5f4c 4942 5241 5249 4553 203d 206c 6962 _LIBRARIES = lib │ │ │ │ │ -00028be0: 6861 6e64 2e61 0a20 2020 2020 6c69 6268 hand.a. libh │ │ │ │ │ -00028bf0: 616e 645f 615f 534f 5552 4345 5320 3d20 and_a_SOURCES = │ │ │ │ │ -00028c00: 6861 6e64 2e63 0a0a 2020 2057 6865 6e20 hand.c.. When │ │ │ │ │ -00028c10: 276d 616b 6520 6469 7374 2720 6973 2072 'make dist' is r │ │ │ │ │ -00028c20: 756e 2066 726f 6d20 7468 6520 746f 702d un from the top- │ │ │ │ │ -00028c30: 6c65 7665 6c20 6469 7265 6374 6f72 7920 level directory │ │ │ │ │ -00028c40: 6974 2077 696c 6c20 6372 6561 7465 0a61 it will create.a │ │ │ │ │ -00028c50: 6e20 6172 6368 6976 6520 2761 726d 2d31 n archive 'arm-1 │ │ │ │ │ -00028c60: 2e30 2e74 6172 2e67 7a27 2074 6861 7420 .0.tar.gz' that │ │ │ │ │ -00028c70: 636f 6e74 6169 6e73 2074 6865 2027 6172 contains the 'ar │ │ │ │ │ -00028c80: 6d27 2063 6f64 6520 6173 2077 656c 6c20 m' code as well │ │ │ │ │ -00028c90: 6173 2074 6865 0a27 6861 6e64 2720 7375 as the.'hand' su │ │ │ │ │ -00028ca0: 6264 6972 6563 746f 7279 2e20 2054 6869 bdirectory. Thi │ │ │ │ │ -00028cb0: 7320 7061 636b 6167 6520 6361 6e20 6265 s package can be │ │ │ │ │ -00028cc0: 2062 7569 6c74 2061 6e64 2069 6e73 7461 built and insta │ │ │ │ │ -00028cd0: 6c6c 6564 206c 696b 6520 616e 790a 6f72 lled like any.or │ │ │ │ │ -00028ce0: 6469 6e61 7279 2070 6163 6b61 6765 2c20 dinary package, │ │ │ │ │ -00028cf0: 7769 7468 2074 6865 2075 7375 616c 2027 with the usual ' │ │ │ │ │ -00028d00: 2e2f 636f 6e66 6967 7572 6520 2626 206d ./configure && m │ │ │ │ │ -00028d10: 616b 6520 2626 206d 616b 6520 696e 7374 ake && make inst │ │ │ │ │ -00028d20: 616c 6c27 0a73 6571 7565 6e63 6520 2874 all'.sequence (t │ │ │ │ │ -00028d30: 6865 2027 6861 6e64 2720 7375 6270 6163 he 'hand' subpac │ │ │ │ │ -00028d40: 6b61 6765 2077 696c 6c20 6265 2062 7569 kage will be bui │ │ │ │ │ -00028d50: 6c74 2061 6e64 2069 6e73 7461 6c6c 6564 lt and installed │ │ │ │ │ -00028d60: 2062 7920 7468 650a 7072 6f63 6573 7329 by the.process) │ │ │ │ │ -00028d70: 2e0a 0a20 2020 5768 656e 2027 6d61 6b65 ... When 'make │ │ │ │ │ -00028d80: 2064 6973 7427 2069 7320 7275 6e20 6672 dist' is run fr │ │ │ │ │ -00028d90: 6f6d 2074 6865 2068 616e 6420 6469 7265 om the hand dire │ │ │ │ │ -00028da0: 6374 6f72 792c 2069 7420 7769 6c6c 2063 ctory, it will c │ │ │ │ │ -00028db0: 7265 6174 6520 610a 7365 6c66 2d63 6f6e reate a.self-con │ │ │ │ │ -00028dc0: 7461 696e 6564 2027 6861 6e64 2d31 2e32 tained 'hand-1.2 │ │ │ │ │ -00028dd0: 2e74 6172 2e67 7a27 2061 7263 6869 7665 .tar.gz' archive │ │ │ │ │ -00028de0: 2e20 2053 6f20 616c 7468 6f75 6768 2069 . So although i │ │ │ │ │ -00028df0: 7420 6170 7065 6172 7320 746f 2062 650a t appears to be. │ │ │ │ │ -00028e00: 656d 6265 6464 6564 2069 6e20 616e 6f74 embedded in anot │ │ │ │ │ -00028e10: 6865 7220 7061 636b 6167 652c 2069 7420 her package, it │ │ │ │ │ -00028e20: 6361 6e20 7374 696c 6c20 6265 2075 7365 can still be use │ │ │ │ │ -00028e30: 6420 7365 7061 7261 7465 6c79 2e0a 0a20 d separately... │ │ │ │ │ -00028e40: 2020 5468 6520 7075 7270 6f73 6520 6f66 The purpose of │ │ │ │ │ -00028e50: 2074 6865 2027 4143 5f43 4f4e 4649 475f the 'AC_CONFIG_ │ │ │ │ │ -00028e60: 4155 585f 4449 5228 5b2e 5d29 2720 696e AUX_DIR([.])' in │ │ │ │ │ -00028e70: 7374 7275 6374 696f 6e20 6973 2074 6f20 struction is to │ │ │ │ │ -00028e80: 666f 7263 650a 4175 746f 6d61 6b65 2061 force.Automake a │ │ │ │ │ -00028e90: 6e64 2041 7574 6f63 6f6e 6620 746f 2073 nd Autoconf to s │ │ │ │ │ -00028ea0: 6561 7263 6820 666f 7220 6175 7869 6c69 earch for auxili │ │ │ │ │ -00028eb0: 6172 7920 7363 7269 7074 7320 696e 2074 ary scripts in t │ │ │ │ │ -00028ec0: 6865 2063 7572 7265 6e74 0a64 6972 6563 he current.direc │ │ │ │ │ -00028ed0: 746f 7279 2e20 2046 6f72 2069 6e73 7461 tory. For insta │ │ │ │ │ -00028ee0: 6e63 652c 2074 6869 7320 6d65 616e 7320 nce, this means │ │ │ │ │ -00028ef0: 7468 6174 2074 6865 7265 2077 696c 6c20 that there will │ │ │ │ │ -00028f00: 6265 2074 776f 2063 6f70 6965 7320 6f66 be two copies of │ │ │ │ │ -00028f10: 0a27 696e 7374 616c 6c2d 7368 273a 206f .'install-sh': o │ │ │ │ │ -00028f20: 6e65 2069 6e20 7468 6520 746f 702d 6c65 ne in the top-le │ │ │ │ │ -00028f30: 7665 6c20 6f66 2074 6865 2027 6172 6d27 vel of the 'arm' │ │ │ │ │ -00028f40: 2070 6163 6b61 6765 2c20 616e 6420 616e package, and an │ │ │ │ │ -00028f50: 6f74 6865 7220 6f6e 650a 696e 2074 6865 other one.in the │ │ │ │ │ -00028f60: 2027 6861 6e64 2f27 2073 7562 6469 7265 'hand/' subdire │ │ │ │ │ -00028f70: 6374 6f72 7920 666f 7220 7468 6520 2768 ctory for the 'h │ │ │ │ │ -00028f80: 616e 6427 2070 6163 6b61 6765 2e0a 0a20 and' package... │ │ │ │ │ -00028f90: 2020 5468 6520 6869 7374 6f72 6963 616c The historical │ │ │ │ │ -00028fa0: 2064 6566 6175 6c74 2069 7320 746f 2073 default is to s │ │ │ │ │ -00028fb0: 6561 7263 6820 666f 7220 7468 6573 6520 earch for these │ │ │ │ │ -00028fc0: 6175 7869 6c69 6172 7920 7363 7269 7074 auxiliary script │ │ │ │ │ -00028fd0: 7320 696e 0a74 6865 2070 6172 656e 7420 s in.the parent │ │ │ │ │ -00028fe0: 6469 7265 6374 6f72 7920 616e 6420 7468 directory and th │ │ │ │ │ -00028ff0: 6520 6772 616e 6470 6172 656e 7420 6469 e grandparent di │ │ │ │ │ -00029000: 7265 6374 6f72 792e 2020 536f 2069 6620 rectory. So if │ │ │ │ │ -00029010: 7468 650a 2741 435f 434f 4e46 4947 5f41 the.'AC_CONFIG_A │ │ │ │ │ -00029020: 5558 5f44 4952 285b 2e5d 2927 206c 696e UX_DIR([.])' lin │ │ │ │ │ -00029030: 6520 7761 7320 7265 6d6f 7665 6420 6672 e was removed fr │ │ │ │ │ -00029040: 6f6d 2027 6861 6e64 2f63 6f6e 6669 6775 om 'hand/configu │ │ │ │ │ -00029050: 7265 2e61 6327 2c20 7468 6174 0a73 7562 re.ac', that.sub │ │ │ │ │ -00029060: 7061 636b 6167 6520 776f 756c 6420 7368 package would sh │ │ │ │ │ -00029070: 6172 6520 7468 6520 6175 7869 6c69 6172 are the auxiliar │ │ │ │ │ -00029080: 7920 7363 7269 7074 206f 6620 7468 6520 y script of the │ │ │ │ │ -00029090: 2761 726d 2720 7061 636b 6167 652e 2020 'arm' package. │ │ │ │ │ -000290a0: 5468 6973 0a6d 6179 206c 6f6f 6b73 206c This.may looks l │ │ │ │ │ -000290b0: 696b 6520 6120 6761 696e 2069 6e20 7369 ike a gain in si │ │ │ │ │ -000290c0: 7a65 2028 6120 6665 7720 6b69 6c6f 6279 ze (a few kiloby │ │ │ │ │ -000290d0: 7465 7329 2c20 6275 7420 6974 2069 7320 tes), but it is │ │ │ │ │ -000290e0: 6163 7475 616c 6c79 2061 0a6c 6f73 7320 actually a.loss │ │ │ │ │ -000290f0: 6f66 206d 6f64 756c 6172 6974 7920 6173 of modularity as │ │ │ │ │ -00029100: 2074 6865 2027 6861 6e64 2720 7375 6270 the 'hand' subp │ │ │ │ │ -00029110: 6163 6b61 6765 2069 7320 6e6f 206c 6f6e ackage is no lon │ │ │ │ │ -00029120: 6765 7220 7365 6c66 2d63 6f6e 7461 696e ger self-contain │ │ │ │ │ -00029130: 6564 0a28 276d 616b 6520 6469 7374 2720 ed.('make dist' │ │ │ │ │ -00029140: 696e 2074 6865 2073 7562 6469 7265 6374 in the subdirect │ │ │ │ │ -00029150: 6f72 7920 7769 6c6c 206e 6f74 2077 6f72 ory will not wor │ │ │ │ │ -00029160: 6b20 616e 796d 6f72 6529 2e0a 0a20 2020 k anymore)... │ │ │ │ │ -00029170: 5061 636b 6167 6573 2074 6861 7420 646f Packages that do │ │ │ │ │ -00029180: 206e 6f74 2075 7365 2041 7574 6f6d 616b not use Automak │ │ │ │ │ -00029190: 6520 6e65 6564 206d 6f72 6520 776f 726b e need more work │ │ │ │ │ -000291a0: 2074 6f20 6265 2069 6e74 6567 7261 7465 to be integrate │ │ │ │ │ -000291b0: 640a 7468 6973 2077 6179 2e20 202a 4e6f d.this way. *No │ │ │ │ │ -000291c0: 7465 2054 6869 7264 2d50 6172 7479 204d te Third-Party M │ │ │ │ │ -000291d0: 616b 6566 696c 6573 3a3a 2e0a 0a1f 0a46 akefiles::.....F │ │ │ │ │ -000291e0: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -000291f0: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -00029200: 5072 6f67 7261 6d73 2c20 204e 6578 743a Programs, Next: │ │ │ │ │ -00029210: 204f 7468 6572 204f 626a 6563 7473 2c20 Other Objects, │ │ │ │ │ -00029220: 2050 7265 763a 2044 6972 6563 746f 7269 Prev: Directori │ │ │ │ │ -00029230: 6573 2c20 2055 703a 2054 6f70 0a0a 3820 es, Up: Top..8 │ │ │ │ │ -00029240: 4275 696c 6469 6e67 2050 726f 6772 616d Building Program │ │ │ │ │ -00029250: 7320 616e 6420 4c69 6272 6172 6965 730a s and Libraries. │ │ │ │ │ -00029260: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +00027d50: 3d3d 3d0a 0a49 6620 796f 7527 7665 2065 ===..If you've e │ │ │ │ │ +00027d60: 7665 7220 7265 6164 2050 6574 6572 204d ver read Peter M │ │ │ │ │ +00027d70: 696c 6c65 7227 7320 6578 6365 6c6c 656e iller's excellen │ │ │ │ │ +00027d80: 7420 7061 7065 722c 2052 6563 7572 7369 t paper, Recursi │ │ │ │ │ +00027d90: 7665 204d 616b 650a 436f 6e73 6964 6572 ve Make.Consider │ │ │ │ │ +00027da0: 6564 2048 6172 6d66 756c 2028 6874 7470 ed Harmful (http │ │ │ │ │ +00027db0: 3a2f 2f6d 696c 6c65 722e 656d 752e 6964 ://miller.emu.id │ │ │ │ │ +00027dc0: 2e61 752f 706d 696c 6c65 722f 626f 6f6b .au/pmiller/book │ │ │ │ │ +00027dd0: 732f 726d 6368 2f29 2c20 7468 650a 7072 s/rmch/), the.pr │ │ │ │ │ +00027de0: 6563 6564 696e 6720 7365 6374 696f 6e73 eceding sections │ │ │ │ │ +00027df0: 206f 6e20 7468 6520 7573 6520 6f66 2073 on the use of s │ │ │ │ │ +00027e00: 7562 6469 7265 6374 6f72 6965 7320 7769 ubdirectories wi │ │ │ │ │ +00027e10: 6c6c 2070 726f 6261 626c 7920 636f 6d65 ll probably come │ │ │ │ │ +00027e20: 2061 730a 756e 7765 6c63 6f6d 6520 6164 as.unwelcome ad │ │ │ │ │ +00027e30: 7669 6365 2e20 2046 6f72 2074 686f 7365 vice. For those │ │ │ │ │ +00027e40: 2077 686f 2068 6176 656e 2774 2072 6561 who haven't rea │ │ │ │ │ +00027e50: 6420 7468 6520 7061 7065 722c 204d 696c d the paper, Mil │ │ │ │ │ +00027e60: 6c65 7227 7320 6d61 696e 0a74 6865 7369 ler's main.thesi │ │ │ │ │ +00027e70: 7320 6973 2074 6861 7420 7265 6375 7273 s is that recurs │ │ │ │ │ +00027e80: 6976 6520 276d 616b 6527 2069 6e76 6f63 ive 'make' invoc │ │ │ │ │ +00027e90: 6174 696f 6e73 2061 7265 2062 6f74 6820 ations are both │ │ │ │ │ +00027ea0: 736c 6f77 2061 6e64 0a65 7272 6f72 2d70 slow and.error-p │ │ │ │ │ +00027eb0: 726f 6e65 2e0a 0a20 2020 4175 746f 6d61 rone... Automa │ │ │ │ │ +00027ec0: 6b65 2070 726f 7669 6465 7320 7375 6666 ke provides suff │ │ │ │ │ +00027ed0: 6963 6965 6e74 2063 726f 7373 2d64 6972 icient cross-dir │ │ │ │ │ +00027ee0: 6563 746f 7279 2073 7570 706f 7274 2028 ectory support ( │ │ │ │ │ +00027ef0: 3129 2074 6f20 656e 6162 6c65 0a79 6f75 1) to enable.you │ │ │ │ │ +00027f00: 2074 6f20 7772 6974 6520 6120 7369 6e67 to write a sing │ │ │ │ │ +00027f10: 6c65 2027 4d61 6b65 6669 6c65 2e61 6d27 le 'Makefile.am' │ │ │ │ │ +00027f20: 2066 6f72 2061 2063 6f6d 706c 6578 206d for a complex m │ │ │ │ │ +00027f30: 756c 7469 2d64 6972 6563 746f 7279 0a70 ulti-directory.p │ │ │ │ │ +00027f40: 6163 6b61 6765 2e0a 0a20 2020 4279 2064 ackage... By d │ │ │ │ │ +00027f50: 6566 6175 6c74 2061 6e20 696e 7374 616c efault an instal │ │ │ │ │ +00027f60: 6c61 626c 6520 6669 6c65 2073 7065 6369 lable file speci │ │ │ │ │ +00027f70: 6669 6564 2069 6e20 6120 7375 6264 6972 fied in a subdir │ │ │ │ │ +00027f80: 6563 746f 7279 2077 696c 6c20 6861 7665 ectory will have │ │ │ │ │ +00027f90: 0a69 7473 2064 6972 6563 746f 7279 206e .its directory n │ │ │ │ │ +00027fa0: 616d 6520 7374 7269 7070 6564 2062 6566 ame stripped bef │ │ │ │ │ +00027fb0: 6f72 6520 696e 7374 616c 6c61 7469 6f6e ore installation │ │ │ │ │ +00027fc0: 2e20 2046 6f72 2069 6e73 7461 6e63 652c . For instance, │ │ │ │ │ +00027fd0: 2069 6e20 7468 6973 0a65 7861 6d70 6c65 in this.example │ │ │ │ │ +00027fe0: 2c20 7468 6520 6865 6164 6572 2066 696c , the header fil │ │ │ │ │ +00027ff0: 6520 7769 6c6c 2062 6520 696e 7374 616c e will be instal │ │ │ │ │ +00028000: 6c65 6420 6173 2027 2428 696e 636c 7564 led as '$(includ │ │ │ │ │ +00028010: 6564 6972 292f 7374 6469 6f2e 6827 3a0a edir)/stdio.h':. │ │ │ │ │ +00028020: 0a20 2020 2020 696e 636c 7564 655f 4845 . include_HE │ │ │ │ │ +00028030: 4144 4552 5320 3d20 696e 632f 7374 6469 ADERS = inc/stdi │ │ │ │ │ +00028040: 6f2e 680a 0a20 2020 486f 7765 7665 722c o.h.. However, │ │ │ │ │ +00028050: 2074 6865 2027 6e6f 6261 7365 5f27 2070 the 'nobase_' p │ │ │ │ │ +00028060: 7265 6669 7820 6361 6e20 6265 2075 7365 refix can be use │ │ │ │ │ +00028070: 6420 746f 2063 6972 6375 6d76 656e 7420 d to circumvent │ │ │ │ │ +00028080: 7468 6973 2070 6174 680a 7374 7269 7070 this path.stripp │ │ │ │ │ +00028090: 696e 672e 2020 496e 2074 6869 7320 6578 ing. In this ex │ │ │ │ │ +000280a0: 616d 706c 652c 2074 6865 2068 6561 6465 ample, the heade │ │ │ │ │ +000280b0: 7220 6669 6c65 2077 696c 6c20 6265 2069 r file will be i │ │ │ │ │ +000280c0: 6e73 7461 6c6c 6564 2061 730a 2724 2869 nstalled as.'$(i │ │ │ │ │ +000280d0: 6e63 6c75 6465 6469 7229 2f73 7973 2f74 ncludedir)/sys/t │ │ │ │ │ +000280e0: 7970 6573 2e68 273a 0a0a 2020 2020 206e ypes.h':.. n │ │ │ │ │ +000280f0: 6f62 6173 655f 696e 636c 7564 655f 4845 obase_include_HE │ │ │ │ │ +00028100: 4144 4552 5320 3d20 7379 732f 7479 7065 ADERS = sys/type │ │ │ │ │ +00028110: 732e 680a 0a20 2020 276e 6f62 6173 655f s.h.. 'nobase_ │ │ │ │ │ +00028120: 2720 7368 6f75 6c64 2062 6520 7370 6563 ' should be spec │ │ │ │ │ +00028130: 6966 6965 6420 6669 7273 7420 7768 656e ified first when │ │ │ │ │ +00028140: 2075 7365 6420 696e 2063 6f6e 6a75 6e63 used in conjunc │ │ │ │ │ +00028150: 7469 6f6e 2077 6974 680a 6569 7468 6572 tion with.either │ │ │ │ │ +00028160: 2027 6469 7374 5f27 206f 7220 276e 6f64 'dist_' or 'nod │ │ │ │ │ +00028170: 6973 745f 2720 282a 6e6f 7465 2046 696e ist_' (*note Fin │ │ │ │ │ +00028180: 652d 6772 6169 6e65 6420 4469 7374 7269 e-grained Distri │ │ │ │ │ +00028190: 6275 7469 6f6e 2043 6f6e 7472 6f6c 3a3a bution Control:: │ │ │ │ │ +000281a0: 292e 0a46 6f72 2069 6e73 7461 6e63 653a )..For instance: │ │ │ │ │ +000281b0: 0a0a 2020 2020 206e 6f62 6173 655f 6469 .. nobase_di │ │ │ │ │ +000281c0: 7374 5f70 6b67 6461 7461 5f44 4154 4120 st_pkgdata_DATA │ │ │ │ │ +000281d0: 3d20 696d 6167 6573 2f76 6f72 7465 782e = images/vortex. │ │ │ │ │ +000281e0: 7067 6d20 736f 756e 6473 2f77 6869 726c pgm sounds/whirl │ │ │ │ │ +000281f0: 2e6f 6767 0a0a 2020 2046 696e 616c 6c79 .ogg.. Finally │ │ │ │ │ +00028200: 2c20 6e6f 7465 2074 6861 7420 6120 7661 , note that a va │ │ │ │ │ +00028210: 7269 6162 6c65 2075 7369 6e67 2074 6865 riable using the │ │ │ │ │ +00028220: 2027 6e6f 6261 7365 5f27 2070 7265 6669 'nobase_' prefi │ │ │ │ │ +00028230: 7820 6361 6e20 6f66 7465 6e20 6265 0a72 x can often be.r │ │ │ │ │ +00028240: 6570 6c61 6365 6420 6279 2073 6576 6572 eplaced by sever │ │ │ │ │ +00028250: 616c 2076 6172 6961 626c 6573 2c20 6f6e al variables, on │ │ │ │ │ +00028260: 6520 666f 7220 6561 6368 2064 6573 7469 e for each desti │ │ │ │ │ +00028270: 6e61 7469 6f6e 2064 6972 6563 746f 7279 nation directory │ │ │ │ │ +00028280: 2028 2a6e 6f74 650a 556e 6966 6f72 6d3a (*note.Uniform: │ │ │ │ │ +00028290: 3a29 2e20 2046 6f72 2069 6e73 7461 6e63 :). For instanc │ │ │ │ │ +000282a0: 652c 2074 6865 206c 6173 7420 6578 616d e, the last exam │ │ │ │ │ +000282b0: 706c 6520 636f 756c 6420 6265 2072 6577 ple could be rew │ │ │ │ │ +000282c0: 7269 7474 656e 2061 730a 666f 6c6c 6f77 ritten as.follow │ │ │ │ │ +000282d0: 733a 0a0a 2020 2020 2069 6d61 6765 7364 s:.. imagesd │ │ │ │ │ +000282e0: 6972 203d 2024 2870 6b67 6461 7461 6469 ir = $(pkgdatadi │ │ │ │ │ +000282f0: 7229 2f69 6d61 6765 730a 2020 2020 2073 r)/images. s │ │ │ │ │ +00028300: 6f75 6e64 7364 6972 203d 2024 2870 6b67 oundsdir = $(pkg │ │ │ │ │ +00028310: 6461 7461 6469 7229 2f73 6f75 6e64 730a datadir)/sounds. │ │ │ │ │ +00028320: 2020 2020 2064 6973 745f 696d 6167 6573 dist_images │ │ │ │ │ +00028330: 5f44 4154 4120 3d20 696d 6167 6573 2f76 _DATA = images/v │ │ │ │ │ +00028340: 6f72 7465 782e 7067 6d0a 2020 2020 2064 ortex.pgm. d │ │ │ │ │ +00028350: 6973 745f 736f 756e 6473 5f44 4154 4120 ist_sounds_DATA │ │ │ │ │ +00028360: 3d20 736f 756e 6473 2f77 6869 726c 2e6f = sounds/whirl.o │ │ │ │ │ +00028370: 6767 0a0a 5468 6973 206c 6174 7465 7220 gg..This latter │ │ │ │ │ +00028380: 7379 6e74 6178 206d 616b 6573 2069 7420 syntax makes it │ │ │ │ │ +00028390: 706f 7373 6962 6c65 2074 6f20 6368 616e possible to chan │ │ │ │ │ +000283a0: 6765 206f 6e65 2064 6573 7469 6e61 7469 ge one destinati │ │ │ │ │ +000283b0: 6f6e 2064 6972 6563 746f 7279 0a77 6974 on directory.wit │ │ │ │ │ +000283c0: 686f 7574 2063 6861 6e67 696e 6720 7468 hout changing th │ │ │ │ │ +000283d0: 6520 6c61 796f 7574 206f 6620 7468 6520 e layout of the │ │ │ │ │ +000283e0: 736f 7572 6365 2074 7265 652e 0a0a 2020 source tree... │ │ │ │ │ +000283f0: 2043 7572 7265 6e74 6c79 2c20 276e 6f62 Currently, 'nob │ │ │ │ │ +00028400: 6173 655f 2a5f 4c54 4c49 4252 4152 4945 ase_*_LTLIBRARIE │ │ │ │ │ +00028410: 5327 2061 7265 2074 6865 206f 6e6c 7920 S' are the only │ │ │ │ │ +00028420: 6578 6365 7074 696f 6e20 746f 2074 6869 exception to thi │ │ │ │ │ +00028430: 730a 7275 6c65 2c20 696e 2074 6861 7420 s.rule, in that │ │ │ │ │ +00028440: 7468 6572 6520 6973 206e 6f20 7061 7274 there is no part │ │ │ │ │ +00028450: 6963 756c 6172 2069 6e73 7461 6c6c 6174 icular installat │ │ │ │ │ +00028460: 696f 6e20 6f72 6465 7220 6775 6172 616e ion order guaran │ │ │ │ │ +00028470: 7465 6520 666f 7220 616e 0a6f 7468 6572 tee for an.other │ │ │ │ │ +00028480: 7769 7365 2065 7175 6976 616c 656e 7420 wise equivalent │ │ │ │ │ +00028490: 7365 7420 6f66 2076 6172 6961 626c 6573 set of variables │ │ │ │ │ +000284a0: 2077 6974 686f 7574 2027 6e6f 6261 7365 without 'nobase │ │ │ │ │ +000284b0: 5f27 2070 7265 6669 782e 0a0a 2020 202d _' prefix... - │ │ │ │ │ +000284c0: 2d2d 2d2d 2d2d 2d2d 2d20 466f 6f74 6e6f --------- Footno │ │ │ │ │ +000284d0: 7465 7320 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a tes ----------.. │ │ │ │ │ +000284e0: 2020 2028 3129 2057 6520 6265 6c69 6576 (1) We believ │ │ │ │ │ +000284f0: 652e 2020 5468 6973 2077 6f72 6b20 6973 e. This work is │ │ │ │ │ +00028500: 206e 6577 2061 6e64 2074 6865 7265 2061 new and there a │ │ │ │ │ +00028510: 7265 2070 726f 6261 626c 7920 7761 7274 re probably wart │ │ │ │ │ +00028520: 732e 0a2a 4e6f 7465 2049 6e74 726f 6475 s..*Note Introdu │ │ │ │ │ +00028530: 6374 696f 6e3a 3a2c 2066 6f72 2069 6e66 ction::, for inf │ │ │ │ │ +00028540: 6f72 6d61 7469 6f6e 206f 6e20 7265 706f ormation on repo │ │ │ │ │ +00028550: 7274 696e 6720 6275 6773 2e0a 0a1f 0a46 rting bugs.....F │ │ │ │ │ +00028560: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +00028570: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +00028580: 5375 6270 6163 6b61 6765 732c 2020 5072 Subpackages, Pr │ │ │ │ │ +00028590: 6576 3a20 416c 7465 726e 6174 6976 652c ev: Alternative, │ │ │ │ │ +000285a0: 2020 5570 3a20 4469 7265 6374 6f72 6965 Up: Directorie │ │ │ │ │ +000285b0: 730a 0a37 2e34 204e 6573 7469 6e67 2050 s..7.4 Nesting P │ │ │ │ │ +000285c0: 6163 6b61 6765 730a 3d3d 3d3d 3d3d 3d3d ackages.======== │ │ │ │ │ +000285d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 496e ============..In │ │ │ │ │ +000285e0: 2074 6865 2047 4e55 2042 7569 6c64 2053 the GNU Build S │ │ │ │ │ +000285f0: 7973 7465 6d2c 2070 6163 6b61 6765 7320 ystem, packages │ │ │ │ │ +00028600: 6361 6e20 6265 206e 6573 7465 6420 746f can be nested to │ │ │ │ │ +00028610: 2061 7262 6974 7261 7279 2064 6570 7468 arbitrary depth │ │ │ │ │ +00028620: 2e0a 5468 6973 206d 6561 6e73 2074 6861 ..This means tha │ │ │ │ │ +00028630: 7420 6120 7061 636b 6167 6520 6361 6e20 t a package can │ │ │ │ │ +00028640: 656d 6265 6420 6f74 6865 7220 7061 636b embed other pack │ │ │ │ │ +00028650: 6167 6573 2077 6974 6820 7468 6569 7220 ages with their │ │ │ │ │ +00028660: 6f77 6e0a 2763 6f6e 6669 6775 7265 272c own.'configure', │ │ │ │ │ +00028670: 2027 4d61 6b65 6669 6c65 2773 2c20 6574 'Makefile's, et │ │ │ │ │ +00028680: 632e 0a0a 2020 2054 6865 7365 206f 7468 c... These oth │ │ │ │ │ +00028690: 6572 2070 6163 6b61 6765 7320 7368 6f75 er packages shou │ │ │ │ │ +000286a0: 6c64 206a 7573 7420 6170 7065 6172 2061 ld just appear a │ │ │ │ │ +000286b0: 7320 7375 6264 6972 6563 746f 7269 6573 s subdirectories │ │ │ │ │ +000286c0: 206f 6620 7468 6569 720a 7061 7265 6e74 of their.parent │ │ │ │ │ +000286d0: 2070 6163 6b61 6765 2e20 2054 6865 7920 package. They │ │ │ │ │ +000286e0: 6d75 7374 2062 6520 6c69 7374 6564 2069 must be listed i │ │ │ │ │ +000286f0: 6e20 2753 5542 4449 5253 2720 6c69 6b65 n 'SUBDIRS' like │ │ │ │ │ +00028700: 206f 7468 6572 206f 7264 696e 6172 790a other ordinary. │ │ │ │ │ +00028710: 6469 7265 6374 6f72 6965 732e 2020 486f directories. Ho │ │ │ │ │ +00028720: 7765 7665 7220 7468 6520 7375 6270 6163 wever the subpac │ │ │ │ │ +00028730: 6b61 6765 2773 2027 4d61 6b65 6669 6c65 kage's 'Makefile │ │ │ │ │ +00028740: 2773 2073 686f 756c 6420 6265 206f 7574 's should be out │ │ │ │ │ +00028750: 7075 7420 6279 0a69 7473 206f 776e 2027 put by.its own ' │ │ │ │ │ +00028760: 636f 6e66 6967 7572 6527 2073 6372 6970 configure' scrip │ │ │ │ │ +00028770: 742c 206e 6f74 2062 7920 7468 6520 7061 t, not by the pa │ │ │ │ │ +00028780: 7265 6e74 2773 2027 636f 6e66 6967 7572 rent's 'configur │ │ │ │ │ +00028790: 6527 2e20 2054 6869 7320 6973 0a61 6368 e'. This is.ach │ │ │ │ │ +000287a0: 6965 7665 6420 7573 696e 6720 7468 6520 ieved using the │ │ │ │ │ +000287b0: 2741 435f 434f 4e46 4947 5f53 5542 4449 'AC_CONFIG_SUBDI │ │ │ │ │ +000287c0: 5253 2720 4175 746f 636f 6e66 206d 6163 RS' Autoconf mac │ │ │ │ │ +000287d0: 726f 2028 2a6e 6f74 650a 4143 5f43 4f4e ro (*note.AC_CON │ │ │ │ │ +000287e0: 4649 475f 5355 4244 4952 533a 2028 6175 FIG_SUBDIRS: (au │ │ │ │ │ +000287f0: 746f 636f 6e66 2953 7562 6469 7265 6374 toconf)Subdirect │ │ │ │ │ +00028800: 6f72 6965 732e 292e 0a0a 2020 2048 6572 ories.)... Her │ │ │ │ │ +00028810: 6520 6973 2061 6e20 6578 616d 706c 6520 e is an example │ │ │ │ │ +00028820: 7061 636b 6167 6520 666f 7220 616e 2027 package for an ' │ │ │ │ │ +00028830: 6172 6d27 2070 726f 6772 616d 2074 6861 arm' program tha │ │ │ │ │ +00028840: 7420 6c69 6e6b 7320 7769 7468 2061 0a27 t links with a.' │ │ │ │ │ +00028850: 6861 6e64 2720 6c69 6272 6172 7920 7468 hand' library th │ │ │ │ │ +00028860: 6174 2069 7320 6120 6e65 7374 6564 2070 at is a nested p │ │ │ │ │ +00028870: 6163 6b61 6765 2069 6e20 7375 6264 6972 ackage in subdir │ │ │ │ │ +00028880: 6563 746f 7279 2027 6861 6e64 2f27 2e0a ectory 'hand/'.. │ │ │ │ │ +00028890: 0a20 2020 2761 726d 2727 7320 2763 6f6e . 'arm''s 'con │ │ │ │ │ +000288a0: 6669 6775 7265 2e61 6327 3a0a 0a20 2020 figure.ac':.. │ │ │ │ │ +000288b0: 2020 4143 5f49 4e49 5428 5b61 726d 5d2c AC_INIT([arm], │ │ │ │ │ +000288c0: 205b 312e 305d 290a 2020 2020 2041 435f [1.0]). AC_ │ │ │ │ │ +000288d0: 434f 4e46 4947 5f41 5558 5f44 4952 285b CONFIG_AUX_DIR([ │ │ │ │ │ +000288e0: 2e5d 290a 2020 2020 2041 4d5f 494e 4954 .]). AM_INIT │ │ │ │ │ +000288f0: 5f41 5554 4f4d 414b 450a 2020 2020 2041 _AUTOMAKE. A │ │ │ │ │ +00028900: 435f 5052 4f47 5f43 430a 2020 2020 2041 C_PROG_CC. A │ │ │ │ │ +00028910: 435f 434f 4e46 4947 5f46 494c 4553 285b C_CONFIG_FILES([ │ │ │ │ │ +00028920: 4d61 6b65 6669 6c65 5d29 0a20 2020 2020 Makefile]). │ │ │ │ │ +00028930: 2320 4361 6c6c 2068 616e 6427 7320 2e2f # Call hand's ./ │ │ │ │ │ +00028940: 636f 6e66 6967 7572 6520 7363 7269 7074 configure script │ │ │ │ │ +00028950: 2072 6563 7572 7369 7665 6c79 2e0a 2020 recursively.. │ │ │ │ │ +00028960: 2020 2041 435f 434f 4e46 4947 5f53 5542 AC_CONFIG_SUB │ │ │ │ │ +00028970: 4449 5253 285b 6861 6e64 5d29 0a20 2020 DIRS([hand]). │ │ │ │ │ +00028980: 2020 4143 5f4f 5554 5055 540a 0a20 2020 AC_OUTPUT.. │ │ │ │ │ +00028990: 2761 726d 2727 7320 274d 616b 6566 696c 'arm''s 'Makefil │ │ │ │ │ +000289a0: 652e 616d 273a 0a0a 2020 2020 2023 2042 e.am':.. # B │ │ │ │ │ +000289b0: 7569 6c64 2074 6865 206c 6962 7261 7279 uild the library │ │ │ │ │ +000289c0: 2069 6e20 7468 6520 6861 6e64 2073 7562 in the hand sub │ │ │ │ │ +000289d0: 6469 7265 6374 6f72 7920 6669 7273 742e directory first. │ │ │ │ │ +000289e0: 0a20 2020 2020 5355 4244 4952 5320 3d20 . SUBDIRS = │ │ │ │ │ +000289f0: 6861 6e64 0a0a 2020 2020 2023 2049 6e63 hand.. # Inc │ │ │ │ │ +00028a00: 6c75 6465 2068 616e 6427 7320 6865 6164 lude hand's head │ │ │ │ │ +00028a10: 6572 2077 6865 6e20 636f 6d70 696c 696e er when compilin │ │ │ │ │ +00028a20: 6720 7468 6973 2064 6972 6563 746f 7279 g this directory │ │ │ │ │ +00028a30: 2e0a 2020 2020 2041 4d5f 4350 5046 4c41 .. AM_CPPFLA │ │ │ │ │ +00028a40: 4753 203d 202d 4924 2873 7263 6469 7229 GS = -I$(srcdir) │ │ │ │ │ +00028a50: 2f68 616e 640a 0a20 2020 2020 6269 6e5f /hand.. bin_ │ │ │ │ │ +00028a60: 5052 4f47 5241 4d53 203d 2061 726d 0a20 PROGRAMS = arm. │ │ │ │ │ +00028a70: 2020 2020 6172 6d5f 534f 5552 4345 5320 arm_SOURCES │ │ │ │ │ +00028a80: 3d20 6172 6d2e 630a 2020 2020 2023 206c = arm.c. # l │ │ │ │ │ +00028a90: 696e 6b20 7769 7468 2074 6865 2068 616e ink with the han │ │ │ │ │ +00028aa0: 6420 6c69 6272 6172 792e 0a20 2020 2020 d library.. │ │ │ │ │ +00028ab0: 6172 6d5f 4c44 4144 4420 3d20 6861 6e64 arm_LDADD = hand │ │ │ │ │ +00028ac0: 2f6c 6962 6861 6e64 2e61 0a0a 2020 204e /libhand.a.. N │ │ │ │ │ +00028ad0: 6f77 2068 6572 6520 6973 2027 6861 6e64 ow here is 'hand │ │ │ │ │ +00028ae0: 2727 7320 2768 616e 642f 636f 6e66 6967 ''s 'hand/config │ │ │ │ │ +00028af0: 7572 652e 6163 273a 0a0a 2020 2020 2041 ure.ac':.. A │ │ │ │ │ +00028b00: 435f 494e 4954 285b 6861 6e64 5d2c 205b C_INIT([hand], [ │ │ │ │ │ +00028b10: 312e 325d 290a 2020 2020 2041 435f 434f 1.2]). AC_CO │ │ │ │ │ +00028b20: 4e46 4947 5f41 5558 5f44 4952 285b 2e5d NFIG_AUX_DIR([.] │ │ │ │ │ +00028b30: 290a 2020 2020 2041 4d5f 494e 4954 5f41 ). AM_INIT_A │ │ │ │ │ +00028b40: 5554 4f4d 414b 450a 2020 2020 2041 435f UTOMAKE. AC_ │ │ │ │ │ +00028b50: 5052 4f47 5f43 430a 2020 2020 2041 4d5f PROG_CC. AM_ │ │ │ │ │ +00028b60: 5052 4f47 5f41 520a 2020 2020 2041 435f PROG_AR. AC_ │ │ │ │ │ +00028b70: 5052 4f47 5f52 414e 4c49 420a 2020 2020 PROG_RANLIB. │ │ │ │ │ +00028b80: 2041 435f 434f 4e46 4947 5f46 494c 4553 AC_CONFIG_FILES │ │ │ │ │ +00028b90: 285b 4d61 6b65 6669 6c65 5d29 0a20 2020 ([Makefile]). │ │ │ │ │ +00028ba0: 2020 4143 5f4f 5554 5055 540a 0a61 6e64 AC_OUTPUT..and │ │ │ │ │ +00028bb0: 2069 7473 2027 6861 6e64 2f4d 616b 6566 its 'hand/Makef │ │ │ │ │ +00028bc0: 696c 652e 616d 273a 0a0a 2020 2020 206c ile.am':.. l │ │ │ │ │ +00028bd0: 6962 5f4c 4942 5241 5249 4553 203d 206c ib_LIBRARIES = l │ │ │ │ │ +00028be0: 6962 6861 6e64 2e61 0a20 2020 2020 6c69 ibhand.a. li │ │ │ │ │ +00028bf0: 6268 616e 645f 615f 534f 5552 4345 5320 bhand_a_SOURCES │ │ │ │ │ +00028c00: 3d20 6861 6e64 2e63 0a0a 2020 2057 6865 = hand.c.. Whe │ │ │ │ │ +00028c10: 6e20 276d 616b 6520 6469 7374 2720 6973 n 'make dist' is │ │ │ │ │ +00028c20: 2072 756e 2066 726f 6d20 7468 6520 746f run from the to │ │ │ │ │ +00028c30: 702d 6c65 7665 6c20 6469 7265 6374 6f72 p-level director │ │ │ │ │ +00028c40: 7920 6974 2077 696c 6c20 6372 6561 7465 y it will create │ │ │ │ │ +00028c50: 0a61 6e20 6172 6368 6976 6520 2761 726d .an archive 'arm │ │ │ │ │ +00028c60: 2d31 2e30 2e74 6172 2e67 7a27 2074 6861 -1.0.tar.gz' tha │ │ │ │ │ +00028c70: 7420 636f 6e74 6169 6e73 2074 6865 2027 t contains the ' │ │ │ │ │ +00028c80: 6172 6d27 2063 6f64 6520 6173 2077 656c arm' code as wel │ │ │ │ │ +00028c90: 6c20 6173 2074 6865 0a27 6861 6e64 2720 l as the.'hand' │ │ │ │ │ +00028ca0: 7375 6264 6972 6563 746f 7279 2e20 2054 subdirectory. T │ │ │ │ │ +00028cb0: 6869 7320 7061 636b 6167 6520 6361 6e20 his package can │ │ │ │ │ +00028cc0: 6265 2062 7569 6c74 2061 6e64 2069 6e73 be built and ins │ │ │ │ │ +00028cd0: 7461 6c6c 6564 206c 696b 6520 616e 790a talled like any. │ │ │ │ │ +00028ce0: 6f72 6469 6e61 7279 2070 6163 6b61 6765 ordinary package │ │ │ │ │ +00028cf0: 2c20 7769 7468 2074 6865 2075 7375 616c , with the usual │ │ │ │ │ +00028d00: 2027 2e2f 636f 6e66 6967 7572 6520 2626 './configure && │ │ │ │ │ +00028d10: 206d 616b 6520 2626 206d 616b 6520 696e make && make in │ │ │ │ │ +00028d20: 7374 616c 6c27 0a73 6571 7565 6e63 6520 stall'.sequence │ │ │ │ │ +00028d30: 2874 6865 2027 6861 6e64 2720 7375 6270 (the 'hand' subp │ │ │ │ │ +00028d40: 6163 6b61 6765 2077 696c 6c20 6265 2062 ackage will be b │ │ │ │ │ +00028d50: 7569 6c74 2061 6e64 2069 6e73 7461 6c6c uilt and install │ │ │ │ │ +00028d60: 6564 2062 7920 7468 650a 7072 6f63 6573 ed by the.proces │ │ │ │ │ +00028d70: 7329 2e0a 0a20 2020 5768 656e 2027 6d61 s)... When 'ma │ │ │ │ │ +00028d80: 6b65 2064 6973 7427 2069 7320 7275 6e20 ke dist' is run │ │ │ │ │ +00028d90: 6672 6f6d 2074 6865 2068 616e 6420 6469 from the hand di │ │ │ │ │ +00028da0: 7265 6374 6f72 792c 2069 7420 7769 6c6c rectory, it will │ │ │ │ │ +00028db0: 2063 7265 6174 6520 610a 7365 6c66 2d63 create a.self-c │ │ │ │ │ +00028dc0: 6f6e 7461 696e 6564 2027 6861 6e64 2d31 ontained 'hand-1 │ │ │ │ │ +00028dd0: 2e32 2e74 6172 2e67 7a27 2061 7263 6869 .2.tar.gz' archi │ │ │ │ │ +00028de0: 7665 2e20 2053 6f20 616c 7468 6f75 6768 ve. So although │ │ │ │ │ +00028df0: 2069 7420 6170 7065 6172 7320 746f 2062 it appears to b │ │ │ │ │ +00028e00: 650a 656d 6265 6464 6564 2069 6e20 616e e.embedded in an │ │ │ │ │ +00028e10: 6f74 6865 7220 7061 636b 6167 652c 2069 other package, i │ │ │ │ │ +00028e20: 7420 6361 6e20 7374 696c 6c20 6265 2075 t can still be u │ │ │ │ │ +00028e30: 7365 6420 7365 7061 7261 7465 6c79 2e0a sed separately.. │ │ │ │ │ +00028e40: 0a20 2020 5468 6520 7075 7270 6f73 6520 . The purpose │ │ │ │ │ +00028e50: 6f66 2074 6865 2027 4143 5f43 4f4e 4649 of the 'AC_CONFI │ │ │ │ │ +00028e60: 475f 4155 585f 4449 5228 5b2e 5d29 2720 G_AUX_DIR([.])' │ │ │ │ │ +00028e70: 696e 7374 7275 6374 696f 6e20 6973 2074 instruction is t │ │ │ │ │ +00028e80: 6f20 666f 7263 650a 4175 746f 6d61 6b65 o force.Automake │ │ │ │ │ +00028e90: 2061 6e64 2041 7574 6f63 6f6e 6620 746f and Autoconf to │ │ │ │ │ +00028ea0: 2073 6561 7263 6820 666f 7220 6175 7869 search for auxi │ │ │ │ │ +00028eb0: 6c69 6172 7920 7363 7269 7074 7320 696e liary scripts in │ │ │ │ │ +00028ec0: 2074 6865 2063 7572 7265 6e74 0a64 6972 the current.dir │ │ │ │ │ +00028ed0: 6563 746f 7279 2e20 2046 6f72 2069 6e73 ectory. For ins │ │ │ │ │ +00028ee0: 7461 6e63 652c 2074 6869 7320 6d65 616e tance, this mean │ │ │ │ │ +00028ef0: 7320 7468 6174 2074 6865 7265 2077 696c s that there wil │ │ │ │ │ +00028f00: 6c20 6265 2074 776f 2063 6f70 6965 7320 l be two copies │ │ │ │ │ +00028f10: 6f66 0a27 696e 7374 616c 6c2d 7368 273a of.'install-sh': │ │ │ │ │ +00028f20: 206f 6e65 2069 6e20 7468 6520 746f 702d one in the top- │ │ │ │ │ +00028f30: 6c65 7665 6c20 6f66 2074 6865 2027 6172 level of the 'ar │ │ │ │ │ +00028f40: 6d27 2070 6163 6b61 6765 2c20 616e 6420 m' package, and │ │ │ │ │ +00028f50: 616e 6f74 6865 7220 6f6e 650a 696e 2074 another one.in t │ │ │ │ │ +00028f60: 6865 2027 6861 6e64 2f27 2073 7562 6469 he 'hand/' subdi │ │ │ │ │ +00028f70: 7265 6374 6f72 7920 666f 7220 7468 6520 rectory for the │ │ │ │ │ +00028f80: 2768 616e 6427 2070 6163 6b61 6765 2e0a 'hand' package.. │ │ │ │ │ +00028f90: 0a20 2020 5468 6520 6869 7374 6f72 6963 . The historic │ │ │ │ │ +00028fa0: 616c 2064 6566 6175 6c74 2069 7320 746f al default is to │ │ │ │ │ +00028fb0: 2073 6561 7263 6820 666f 7220 7468 6573 search for thes │ │ │ │ │ +00028fc0: 6520 6175 7869 6c69 6172 7920 7363 7269 e auxiliary scri │ │ │ │ │ +00028fd0: 7074 7320 696e 0a74 6865 2070 6172 656e pts in.the paren │ │ │ │ │ +00028fe0: 7420 6469 7265 6374 6f72 7920 616e 6420 t directory and │ │ │ │ │ +00028ff0: 7468 6520 6772 616e 6470 6172 656e 7420 the grandparent │ │ │ │ │ +00029000: 6469 7265 6374 6f72 792e 2020 536f 2069 directory. So i │ │ │ │ │ +00029010: 6620 7468 650a 2741 435f 434f 4e46 4947 f the.'AC_CONFIG │ │ │ │ │ +00029020: 5f41 5558 5f44 4952 285b 2e5d 2927 206c _AUX_DIR([.])' l │ │ │ │ │ +00029030: 696e 6520 7761 7320 7265 6d6f 7665 6420 ine was removed │ │ │ │ │ +00029040: 6672 6f6d 2027 6861 6e64 2f63 6f6e 6669 from 'hand/confi │ │ │ │ │ +00029050: 6775 7265 2e61 6327 2c20 7468 6174 0a73 gure.ac', that.s │ │ │ │ │ +00029060: 7562 7061 636b 6167 6520 776f 756c 6420 ubpackage would │ │ │ │ │ +00029070: 7368 6172 6520 7468 6520 6175 7869 6c69 share the auxili │ │ │ │ │ +00029080: 6172 7920 7363 7269 7074 206f 6620 7468 ary script of th │ │ │ │ │ +00029090: 6520 2761 726d 2720 7061 636b 6167 652e e 'arm' package. │ │ │ │ │ +000290a0: 2020 5468 6973 0a6d 6179 206c 6f6f 6b73 This.may looks │ │ │ │ │ +000290b0: 206c 696b 6520 6120 6761 696e 2069 6e20 like a gain in │ │ │ │ │ +000290c0: 7369 7a65 2028 6120 6665 7720 6b69 6c6f size (a few kilo │ │ │ │ │ +000290d0: 6279 7465 7329 2c20 6275 7420 6974 2069 bytes), but it i │ │ │ │ │ +000290e0: 7320 6163 7475 616c 6c79 2061 0a6c 6f73 s actually a.los │ │ │ │ │ +000290f0: 7320 6f66 206d 6f64 756c 6172 6974 7920 s of modularity │ │ │ │ │ +00029100: 6173 2074 6865 2027 6861 6e64 2720 7375 as the 'hand' su │ │ │ │ │ +00029110: 6270 6163 6b61 6765 2069 7320 6e6f 206c bpackage is no l │ │ │ │ │ +00029120: 6f6e 6765 7220 7365 6c66 2d63 6f6e 7461 onger self-conta │ │ │ │ │ +00029130: 696e 6564 0a28 276d 616b 6520 6469 7374 ined.('make dist │ │ │ │ │ +00029140: 2720 696e 2074 6865 2073 7562 6469 7265 ' in the subdire │ │ │ │ │ +00029150: 6374 6f72 7920 7769 6c6c 206e 6f74 2077 ctory will not w │ │ │ │ │ +00029160: 6f72 6b20 616e 796d 6f72 6529 2e0a 0a20 ork anymore)... │ │ │ │ │ +00029170: 2020 5061 636b 6167 6573 2074 6861 7420 Packages that │ │ │ │ │ +00029180: 646f 206e 6f74 2075 7365 2041 7574 6f6d do not use Autom │ │ │ │ │ +00029190: 616b 6520 6e65 6564 206d 6f72 6520 776f ake need more wo │ │ │ │ │ +000291a0: 726b 2074 6f20 6265 2069 6e74 6567 7261 rk to be integra │ │ │ │ │ +000291b0: 7465 640a 7468 6973 2077 6179 2e20 202a ted.this way. * │ │ │ │ │ +000291c0: 4e6f 7465 2054 6869 7264 2d50 6172 7479 Note Third-Party │ │ │ │ │ +000291d0: 204d 616b 6566 696c 6573 3a3a 2e0a 0a1f Makefiles::.... │ │ │ │ │ +000291e0: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +000291f0: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +00029200: 3a20 5072 6f67 7261 6d73 2c20 204e 6578 : Programs, Nex │ │ │ │ │ +00029210: 743a 204f 7468 6572 204f 626a 6563 7473 t: Other Objects │ │ │ │ │ +00029220: 2c20 2050 7265 763a 2044 6972 6563 746f , Prev: Directo │ │ │ │ │ +00029230: 7269 6573 2c20 2055 703a 2054 6f70 0a0a ries, Up: Top.. │ │ │ │ │ +00029240: 3820 4275 696c 6469 6e67 2050 726f 6772 8 Building Progr │ │ │ │ │ +00029250: 616d 7320 616e 6420 4c69 6272 6172 6965 ams and Librarie │ │ │ │ │ +00029260: 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a s.************** │ │ │ │ │ 00029270: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00029280: 2a0a 0a41 206c 6172 6765 2070 6172 7420 *..A large part │ │ │ │ │ -00029290: 6f66 2041 7574 6f6d 616b 6527 7320 6675 of Automake's fu │ │ │ │ │ -000292a0: 6e63 7469 6f6e 616c 6974 7920 6973 2064 nctionality is d │ │ │ │ │ -000292b0: 6564 6963 6174 6564 2074 6f20 6d61 6b69 edicated to maki │ │ │ │ │ -000292c0: 6e67 2069 7420 6561 7379 0a74 6f20 6275 ng it easy.to bu │ │ │ │ │ -000292d0: 696c 6420 7072 6f67 7261 6d73 2061 6e64 ild programs and │ │ │ │ │ -000292e0: 206c 6962 7261 7269 6573 2e0a 0a2a 204d libraries...* M │ │ │ │ │ -000292f0: 656e 753a 0a0a 2a20 4120 5072 6f67 7261 enu:..* A Progra │ │ │ │ │ -00029300: 6d3a 3a20 2020 2020 2020 2020 2020 2020 m:: │ │ │ │ │ -00029310: 2020 2020 2020 4275 696c 6469 6e67 2061 Building a │ │ │ │ │ -00029320: 2070 726f 6772 616d 0a2a 2041 204c 6962 program.* A Lib │ │ │ │ │ -00029330: 7261 7279 3a3a 2020 2020 2020 2020 2020 rary:: │ │ │ │ │ -00029340: 2020 2020 2020 2020 2042 7569 6c64 696e Buildin │ │ │ │ │ -00029350: 6720 6120 6c69 6272 6172 790a 2a20 4120 g a library.* A │ │ │ │ │ -00029360: 5368 6172 6564 204c 6962 7261 7279 3a3a Shared Library:: │ │ │ │ │ -00029370: 2020 2020 2020 2020 2020 2020 4275 696c Buil │ │ │ │ │ -00029380: 6469 6e67 2061 204c 6962 746f 6f6c 206c ding a Libtool l │ │ │ │ │ -00029390: 6962 7261 7279 0a2a 2050 726f 6772 616d ibrary.* Program │ │ │ │ │ -000293a0: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ -000293b0: 6961 626c 6573 3a3a 2020 5661 7269 6162 iables:: Variab │ │ │ │ │ -000293c0: 6c65 7320 636f 6e74 726f 6c6c 696e 6720 les controlling │ │ │ │ │ -000293d0: 7072 6f67 7261 6d20 616e 640a 2020 2020 program and. │ │ │ │ │ +00029280: 2a2a 2a0a 0a41 206c 6172 6765 2070 6172 ***..A large par │ │ │ │ │ +00029290: 7420 6f66 2041 7574 6f6d 616b 6527 7320 t of Automake's │ │ │ │ │ +000292a0: 6675 6e63 7469 6f6e 616c 6974 7920 6973 functionality is │ │ │ │ │ +000292b0: 2064 6564 6963 6174 6564 2074 6f20 6d61 dedicated to ma │ │ │ │ │ +000292c0: 6b69 6e67 2069 7420 6561 7379 0a74 6f20 king it easy.to │ │ │ │ │ +000292d0: 6275 696c 6420 7072 6f67 7261 6d73 2061 build programs a │ │ │ │ │ +000292e0: 6e64 206c 6962 7261 7269 6573 2e0a 0a2a nd libraries...* │ │ │ │ │ +000292f0: 204d 656e 753a 0a0a 2a20 4120 5072 6f67 Menu:..* A Prog │ │ │ │ │ +00029300: 7261 6d3a 3a20 2020 2020 2020 2020 2020 ram:: │ │ │ │ │ +00029310: 2020 2020 2020 2020 4275 696c 6469 6e67 Building │ │ │ │ │ +00029320: 2061 2070 726f 6772 616d 0a2a 2041 204c a program.* A L │ │ │ │ │ +00029330: 6962 7261 7279 3a3a 2020 2020 2020 2020 ibrary:: │ │ │ │ │ +00029340: 2020 2020 2020 2020 2020 2042 7569 6c64 Build │ │ │ │ │ +00029350: 696e 6720 6120 6c69 6272 6172 790a 2a20 ing a library.* │ │ │ │ │ +00029360: 4120 5368 6172 6564 204c 6962 7261 7279 A Shared Library │ │ │ │ │ +00029370: 3a3a 2020 2020 2020 2020 2020 2020 4275 :: Bu │ │ │ │ │ +00029380: 696c 6469 6e67 2061 204c 6962 746f 6f6c ilding a Libtool │ │ │ │ │ +00029390: 206c 6962 7261 7279 0a2a 2050 726f 6772 library.* Progr │ │ │ │ │ +000293a0: 616d 2061 6e64 204c 6962 7261 7279 2056 am and Library V │ │ │ │ │ +000293b0: 6172 6961 626c 6573 3a3a 2020 5661 7269 ariables:: Vari │ │ │ │ │ +000293c0: 6162 6c65 7320 636f 6e74 726f 6c6c 696e ables controllin │ │ │ │ │ +000293d0: 6720 7072 6f67 7261 6d20 616e 640a 2020 g program and. │ │ │ │ │ 000293e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000293f0: 2020 2020 2020 2020 2020 2020 6c69 6272 libr │ │ │ │ │ -00029400: 6172 7920 6275 696c 6473 0a2a 2044 6566 ary builds.* Def │ │ │ │ │ -00029410: 6175 6c74 205f 534f 5552 4345 533a 3a20 ault _SOURCES:: │ │ │ │ │ -00029420: 2020 2020 2020 2020 2020 2044 6566 6175 Defau │ │ │ │ │ -00029430: 6c74 2073 6f75 7263 6520 6669 6c65 730a lt source files. │ │ │ │ │ -00029440: 2a20 4c49 424f 424a 533a 3a20 2020 2020 * LIBOBJS:: │ │ │ │ │ +000293f0: 2020 2020 2020 2020 2020 2020 2020 6c69 li │ │ │ │ │ +00029400: 6272 6172 7920 6275 696c 6473 0a2a 2044 brary builds.* D │ │ │ │ │ +00029410: 6566 6175 6c74 205f 534f 5552 4345 533a efault _SOURCES: │ │ │ │ │ +00029420: 3a20 2020 2020 2020 2020 2020 2044 6566 : Def │ │ │ │ │ +00029430: 6175 6c74 2073 6f75 7263 6520 6669 6c65 ault source file │ │ │ │ │ +00029440: 730a 2a20 4c49 424f 424a 533a 3a20 2020 s.* LIBOBJS:: │ │ │ │ │ 00029450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029460: 5370 6563 6961 6c20 6861 6e64 6c69 6e67 Special handling │ │ │ │ │ -00029470: 2066 6f72 204c 4942 4f42 4a53 2061 6e64 for LIBOBJS and │ │ │ │ │ -00029480: 2041 4c4c 4f43 410a 2a20 5072 6f67 7261 ALLOCA.* Progra │ │ │ │ │ -00029490: 6d20 5661 7269 6162 6c65 733a 3a20 2020 m Variables:: │ │ │ │ │ -000294a0: 2020 2020 2020 2020 5661 7269 6162 6c65 Variable │ │ │ │ │ -000294b0: 7320 7573 6564 2077 6865 6e20 6275 696c s used when buil │ │ │ │ │ -000294c0: 6469 6e67 2061 2070 726f 6772 616d 0a2a ding a program.* │ │ │ │ │ -000294d0: 2059 6163 6320 616e 6420 4c65 783a 3a20 Yacc and Lex:: │ │ │ │ │ -000294e0: 2020 2020 2020 2020 2020 2020 2020 2059 Y │ │ │ │ │ -000294f0: 6163 6320 616e 6420 4c65 7820 7375 7070 acc and Lex supp │ │ │ │ │ -00029500: 6f72 740a 2a20 432b 2b20 5375 7070 6f72 ort.* C++ Suppor │ │ │ │ │ -00029510: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -00029520: 2020 2020 436f 6d70 696c 696e 6720 432b Compiling C+ │ │ │ │ │ -00029530: 2b20 736f 7572 6365 730a 2a20 4f62 6a65 + sources.* Obje │ │ │ │ │ -00029540: 6374 6976 6520 4320 5375 7070 6f72 743a ctive C Support: │ │ │ │ │ -00029550: 3a20 2020 2020 2020 2020 436f 6d70 696c : Compil │ │ │ │ │ -00029560: 696e 6720 4f62 6a65 6374 6976 6520 4320 ing Objective C │ │ │ │ │ -00029570: 736f 7572 6365 730a 2a20 556e 6966 6965 sources.* Unifie │ │ │ │ │ -00029580: 6420 5061 7261 6c6c 656c 2043 2053 7570 d Parallel C Sup │ │ │ │ │ -00029590: 706f 7274 3a3a 2020 436f 6d70 696c 696e port:: Compilin │ │ │ │ │ -000295a0: 6720 556e 6966 6965 6420 5061 7261 6c6c g Unified Parall │ │ │ │ │ -000295b0: 656c 2043 2073 6f75 7263 6573 0a2a 2041 el C sources.* A │ │ │ │ │ -000295c0: 7373 656d 626c 7920 5375 7070 6f72 743a ssembly Support: │ │ │ │ │ -000295d0: 3a20 2020 2020 2020 2020 2020 2043 6f6d : Com │ │ │ │ │ -000295e0: 7069 6c69 6e67 2061 7373 656d 626c 7920 piling assembly │ │ │ │ │ -000295f0: 736f 7572 6365 730a 2a20 466f 7274 7261 sources.* Fortra │ │ │ │ │ -00029600: 6e20 3737 2053 7570 706f 7274 3a3a 2020 n 77 Support:: │ │ │ │ │ -00029610: 2020 2020 2020 2020 436f 6d70 696c 696e Compilin │ │ │ │ │ -00029620: 6720 466f 7274 7261 6e20 3737 2073 6f75 g Fortran 77 sou │ │ │ │ │ -00029630: 7263 6573 0a2a 2046 6f72 7472 616e 2039 rces.* Fortran 9 │ │ │ │ │ -00029640: 7820 5375 7070 6f72 743a 3a20 2020 2020 x Support:: │ │ │ │ │ -00029650: 2020 2020 2043 6f6d 7069 6c69 6e67 2046 Compiling F │ │ │ │ │ -00029660: 6f72 7472 616e 2039 7820 736f 7572 6365 ortran 9x source │ │ │ │ │ -00029670: 730a 2a20 4a61 7661 2053 7570 706f 7274 s.* Java Support │ │ │ │ │ -00029680: 2077 6974 6820 6763 6a3a 3a20 2020 2020 with gcj:: │ │ │ │ │ -00029690: 2020 436f 6d70 696c 696e 6720 4a61 7661 Compiling Java │ │ │ │ │ -000296a0: 2073 6f75 7263 6573 2075 7369 6e67 2067 sources using g │ │ │ │ │ -000296b0: 636a 0a2a 2056 616c 6120 5375 7070 6f72 cj.* Vala Suppor │ │ │ │ │ -000296c0: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -000296d0: 2020 2043 6f6d 7069 6c69 6e67 2056 616c Compiling Val │ │ │ │ │ -000296e0: 6120 736f 7572 6365 730a 2a20 5375 7070 a sources.* Supp │ │ │ │ │ -000296f0: 6f72 7420 666f 7220 4f74 6865 7220 4c61 ort for Other La │ │ │ │ │ -00029700: 6e67 7561 6765 733a 3a20 2043 6f6d 7069 nguages:: Compi │ │ │ │ │ -00029710: 6c69 6e67 206f 7468 6572 206c 616e 6775 ling other langu │ │ │ │ │ -00029720: 6167 6573 0a2a 2041 4e53 493a 3a20 2020 ages.* ANSI:: │ │ │ │ │ +00029460: 2020 5370 6563 6961 6c20 6861 6e64 6c69 Special handli │ │ │ │ │ +00029470: 6e67 2066 6f72 204c 4942 4f42 4a53 2061 ng for LIBOBJS a │ │ │ │ │ +00029480: 6e64 2041 4c4c 4f43 410a 2a20 5072 6f67 nd ALLOCA.* Prog │ │ │ │ │ +00029490: 7261 6d20 5661 7269 6162 6c65 733a 3a20 ram Variables:: │ │ │ │ │ +000294a0: 2020 2020 2020 2020 2020 5661 7269 6162 Variab │ │ │ │ │ +000294b0: 6c65 7320 7573 6564 2077 6865 6e20 6275 les used when bu │ │ │ │ │ +000294c0: 696c 6469 6e67 2061 2070 726f 6772 616d ilding a program │ │ │ │ │ +000294d0: 0a2a 2059 6163 6320 616e 6420 4c65 783a .* Yacc and Lex: │ │ │ │ │ +000294e0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000294f0: 2059 6163 6320 616e 6420 4c65 7820 7375 Yacc and Lex su │ │ │ │ │ +00029500: 7070 6f72 740a 2a20 432b 2b20 5375 7070 pport.* C++ Supp │ │ │ │ │ +00029510: 6f72 743a 3a20 2020 2020 2020 2020 2020 ort:: │ │ │ │ │ +00029520: 2020 2020 2020 436f 6d70 696c 696e 6720 Compiling │ │ │ │ │ +00029530: 432b 2b20 736f 7572 6365 730a 2a20 4f62 C++ sources.* Ob │ │ │ │ │ +00029540: 6a65 6374 6976 6520 4320 5375 7070 6f72 jective C Suppor │ │ │ │ │ +00029550: 743a 3a20 2020 2020 2020 2020 436f 6d70 t:: Comp │ │ │ │ │ +00029560: 696c 696e 6720 4f62 6a65 6374 6976 6520 iling Objective │ │ │ │ │ +00029570: 4320 736f 7572 6365 730a 2a20 556e 6966 C sources.* Unif │ │ │ │ │ +00029580: 6965 6420 5061 7261 6c6c 656c 2043 2053 ied Parallel C S │ │ │ │ │ +00029590: 7570 706f 7274 3a3a 2020 436f 6d70 696c upport:: Compil │ │ │ │ │ +000295a0: 696e 6720 556e 6966 6965 6420 5061 7261 ing Unified Para │ │ │ │ │ +000295b0: 6c6c 656c 2043 2073 6f75 7263 6573 0a2a llel C sources.* │ │ │ │ │ +000295c0: 2041 7373 656d 626c 7920 5375 7070 6f72 Assembly Suppor │ │ │ │ │ +000295d0: 743a 3a20 2020 2020 2020 2020 2020 2043 t:: C │ │ │ │ │ +000295e0: 6f6d 7069 6c69 6e67 2061 7373 656d 626c ompiling assembl │ │ │ │ │ +000295f0: 7920 736f 7572 6365 730a 2a20 466f 7274 y sources.* Fort │ │ │ │ │ +00029600: 7261 6e20 3737 2053 7570 706f 7274 3a3a ran 77 Support:: │ │ │ │ │ +00029610: 2020 2020 2020 2020 2020 436f 6d70 696c Compil │ │ │ │ │ +00029620: 696e 6720 466f 7274 7261 6e20 3737 2073 ing Fortran 77 s │ │ │ │ │ +00029630: 6f75 7263 6573 0a2a 2046 6f72 7472 616e ources.* Fortran │ │ │ │ │ +00029640: 2039 7820 5375 7070 6f72 743a 3a20 2020 9x Support:: │ │ │ │ │ +00029650: 2020 2020 2020 2043 6f6d 7069 6c69 6e67 Compiling │ │ │ │ │ +00029660: 2046 6f72 7472 616e 2039 7820 736f 7572 Fortran 9x sour │ │ │ │ │ +00029670: 6365 730a 2a20 4a61 7661 2053 7570 706f ces.* Java Suppo │ │ │ │ │ +00029680: 7274 2077 6974 6820 6763 6a3a 3a20 2020 rt with gcj:: │ │ │ │ │ +00029690: 2020 2020 436f 6d70 696c 696e 6720 4a61 Compiling Ja │ │ │ │ │ +000296a0: 7661 2073 6f75 7263 6573 2075 7369 6e67 va sources using │ │ │ │ │ +000296b0: 2067 636a 0a2a 2056 616c 6120 5375 7070 gcj.* Vala Supp │ │ │ │ │ +000296c0: 6f72 743a 3a20 2020 2020 2020 2020 2020 ort:: │ │ │ │ │ +000296d0: 2020 2020 2043 6f6d 7069 6c69 6e67 2056 Compiling V │ │ │ │ │ +000296e0: 616c 6120 736f 7572 6365 730a 2a20 5375 ala sources.* Su │ │ │ │ │ +000296f0: 7070 6f72 7420 666f 7220 4f74 6865 7220 pport for Other │ │ │ │ │ +00029700: 4c61 6e67 7561 6765 733a 3a20 2043 6f6d Languages:: Com │ │ │ │ │ +00029710: 7069 6c69 6e67 206f 7468 6572 206c 616e piling other lan │ │ │ │ │ +00029720: 6775 6167 6573 0a2a 2041 4e53 493a 3a20 guages.* ANSI:: │ │ │ │ │ 00029730: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029740: 2020 2020 2041 7574 6f6d 6174 6963 2064 Automatic d │ │ │ │ │ -00029750: 652d 414e 5349 2d66 6963 6174 696f 6e20 e-ANSI-fication │ │ │ │ │ -00029760: 2864 6570 7265 6361 7465 642c 2073 6f6f (deprecated, soo │ │ │ │ │ -00029770: 6e20 746f 2062 6520 7265 6d6f 7665 6429 n to be removed) │ │ │ │ │ -00029780: 0a2a 2044 6570 656e 6465 6e63 6965 733a .* Dependencies: │ │ │ │ │ -00029790: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000297a0: 2041 7574 6f6d 6174 6963 2064 6570 656e Automatic depen │ │ │ │ │ -000297b0: 6465 6e63 7920 7472 6163 6b69 6e67 0a2a dency tracking.* │ │ │ │ │ -000297c0: 2045 5845 4558 543a 3a20 2020 2020 2020 EXEEXT:: │ │ │ │ │ -000297d0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -000297e0: 7570 706f 7274 2066 6f72 2065 7865 6375 upport for execu │ │ │ │ │ -000297f0: 7461 626c 6520 6578 7465 6e73 696f 6e73 table extensions │ │ │ │ │ -00029800: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00029810: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00029820: 6f64 653a 2041 2050 726f 6772 616d 2c20 ode: A Program, │ │ │ │ │ -00029830: 204e 6578 743a 2041 204c 6962 7261 7279 Next: A Library │ │ │ │ │ -00029840: 2c20 2055 703a 2050 726f 6772 616d 730a , Up: Programs. │ │ │ │ │ -00029850: 0a38 2e31 2042 7569 6c64 696e 6720 6120 .8.1 Building a │ │ │ │ │ -00029860: 7072 6f67 7261 6d0a 3d3d 3d3d 3d3d 3d3d program.======== │ │ │ │ │ -00029870: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00029880: 496e 206f 7264 6572 2074 6f20 6275 696c In order to buil │ │ │ │ │ -00029890: 6420 6120 7072 6f67 7261 6d2c 2079 6f75 d a program, you │ │ │ │ │ -000298a0: 206e 6565 6420 746f 2074 656c 6c20 4175 need to tell Au │ │ │ │ │ -000298b0: 746f 6d61 6b65 2077 6869 6368 2073 6f75 tomake which sou │ │ │ │ │ -000298c0: 7263 6573 2061 7265 0a70 6172 7420 6f66 rces are.part of │ │ │ │ │ -000298d0: 2069 742c 2061 6e64 2077 6869 6368 206c it, and which l │ │ │ │ │ -000298e0: 6962 7261 7269 6573 2069 7420 7368 6f75 ibraries it shou │ │ │ │ │ -000298f0: 6c64 2062 6520 6c69 6e6b 6564 2077 6974 ld be linked wit │ │ │ │ │ -00029900: 682e 0a0a 2020 2054 6869 7320 7365 6374 h... This sect │ │ │ │ │ -00029910: 696f 6e20 616c 736f 2063 6f76 6572 7320 ion also covers │ │ │ │ │ -00029920: 636f 6e64 6974 696f 6e61 6c20 636f 6d70 conditional comp │ │ │ │ │ -00029930: 696c 6174 696f 6e20 6f66 2073 6f75 7263 ilation of sourc │ │ │ │ │ -00029940: 6573 206f 720a 7072 6f67 7261 6d73 2e20 es or.programs. │ │ │ │ │ -00029950: 204d 6f73 7420 6f66 2074 6865 2063 6f6d Most of the com │ │ │ │ │ -00029960: 6d65 6e74 7320 6162 6f75 7420 7468 6573 ments about thes │ │ │ │ │ -00029970: 6520 616c 736f 2061 7070 6c79 2074 6f20 e also apply to │ │ │ │ │ -00029980: 6c69 6272 6172 6965 730a 282a 6e6f 7465 libraries.(*note │ │ │ │ │ -00029990: 2041 204c 6962 7261 7279 3a3a 2920 616e A Library::) an │ │ │ │ │ -000299a0: 6420 6c69 6274 6f6f 6c20 6c69 6272 6172 d libtool librar │ │ │ │ │ -000299b0: 6965 7320 282a 6e6f 7465 2041 2053 6861 ies (*note A Sha │ │ │ │ │ -000299c0: 7265 6420 4c69 6272 6172 793a 3a29 2e0a red Library::).. │ │ │ │ │ -000299d0: 0a2a 204d 656e 753a 0a0a 2a20 5072 6f67 .* Menu:..* Prog │ │ │ │ │ -000299e0: 7261 6d20 536f 7572 6365 733a 3a20 2020 ram Sources:: │ │ │ │ │ -000299f0: 2020 2020 2020 2020 2020 4465 6669 6e69 Defini │ │ │ │ │ -00029a00: 6e67 2070 726f 6772 616d 2073 6f75 7263 ng program sourc │ │ │ │ │ -00029a10: 6573 0a2a 204c 696e 6b69 6e67 3a3a 2020 es.* Linking:: │ │ │ │ │ +00029740: 2020 2020 2020 2041 7574 6f6d 6174 6963 Automatic │ │ │ │ │ +00029750: 2064 652d 414e 5349 2d66 6963 6174 696f de-ANSI-ficatio │ │ │ │ │ +00029760: 6e20 2864 6570 7265 6361 7465 642c 2073 n (deprecated, s │ │ │ │ │ +00029770: 6f6f 6e20 746f 2062 6520 7265 6d6f 7665 oon to be remove │ │ │ │ │ +00029780: 6429 0a2a 2044 6570 656e 6465 6e63 6965 d).* Dependencie │ │ │ │ │ +00029790: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ +000297a0: 2020 2041 7574 6f6d 6174 6963 2064 6570 Automatic dep │ │ │ │ │ +000297b0: 656e 6465 6e63 7920 7472 6163 6b69 6e67 endency tracking │ │ │ │ │ +000297c0: 0a2a 2045 5845 4558 543a 3a20 2020 2020 .* EXEEXT:: │ │ │ │ │ +000297d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000297e0: 2053 7570 706f 7274 2066 6f72 2065 7865 Support for exe │ │ │ │ │ +000297f0: 6375 7461 626c 6520 6578 7465 6e73 696f cutable extensio │ │ │ │ │ +00029800: 6e73 0a0a 1f0a 4669 6c65 3a20 6175 746f ns....File: auto │ │ │ │ │ +00029810: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +00029820: 204e 6f64 653a 2041 2050 726f 6772 616d Node: A Program │ │ │ │ │ +00029830: 2c20 204e 6578 743a 2041 204c 6962 7261 , Next: A Libra │ │ │ │ │ +00029840: 7279 2c20 2055 703a 2050 726f 6772 616d ry, Up: Program │ │ │ │ │ +00029850: 730a 0a38 2e31 2042 7569 6c64 696e 6720 s..8.1 Building │ │ │ │ │ +00029860: 6120 7072 6f67 7261 6d0a 3d3d 3d3d 3d3d a program.====== │ │ │ │ │ +00029870: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00029880: 0a0a 496e 206f 7264 6572 2074 6f20 6275 ..In order to bu │ │ │ │ │ +00029890: 696c 6420 6120 7072 6f67 7261 6d2c 2079 ild a program, y │ │ │ │ │ +000298a0: 6f75 206e 6565 6420 746f 2074 656c 6c20 ou need to tell │ │ │ │ │ +000298b0: 4175 746f 6d61 6b65 2077 6869 6368 2073 Automake which s │ │ │ │ │ +000298c0: 6f75 7263 6573 2061 7265 0a70 6172 7420 ources are.part │ │ │ │ │ +000298d0: 6f66 2069 742c 2061 6e64 2077 6869 6368 of it, and which │ │ │ │ │ +000298e0: 206c 6962 7261 7269 6573 2069 7420 7368 libraries it sh │ │ │ │ │ +000298f0: 6f75 6c64 2062 6520 6c69 6e6b 6564 2077 ould be linked w │ │ │ │ │ +00029900: 6974 682e 0a0a 2020 2054 6869 7320 7365 ith... This se │ │ │ │ │ +00029910: 6374 696f 6e20 616c 736f 2063 6f76 6572 ction also cover │ │ │ │ │ +00029920: 7320 636f 6e64 6974 696f 6e61 6c20 636f s conditional co │ │ │ │ │ +00029930: 6d70 696c 6174 696f 6e20 6f66 2073 6f75 mpilation of sou │ │ │ │ │ +00029940: 7263 6573 206f 720a 7072 6f67 7261 6d73 rces or.programs │ │ │ │ │ +00029950: 2e20 204d 6f73 7420 6f66 2074 6865 2063 . Most of the c │ │ │ │ │ +00029960: 6f6d 6d65 6e74 7320 6162 6f75 7420 7468 omments about th │ │ │ │ │ +00029970: 6573 6520 616c 736f 2061 7070 6c79 2074 ese also apply t │ │ │ │ │ +00029980: 6f20 6c69 6272 6172 6965 730a 282a 6e6f o libraries.(*no │ │ │ │ │ +00029990: 7465 2041 204c 6962 7261 7279 3a3a 2920 te A Library::) │ │ │ │ │ +000299a0: 616e 6420 6c69 6274 6f6f 6c20 6c69 6272 and libtool libr │ │ │ │ │ +000299b0: 6172 6965 7320 282a 6e6f 7465 2041 2053 aries (*note A S │ │ │ │ │ +000299c0: 6861 7265 6420 4c69 6272 6172 793a 3a29 hared Library::) │ │ │ │ │ +000299d0: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 5072 ...* Menu:..* Pr │ │ │ │ │ +000299e0: 6f67 7261 6d20 536f 7572 6365 733a 3a20 ogram Sources:: │ │ │ │ │ +000299f0: 2020 2020 2020 2020 2020 2020 4465 6669 Defi │ │ │ │ │ +00029a00: 6e69 6e67 2070 726f 6772 616d 2073 6f75 ning program sou │ │ │ │ │ +00029a10: 7263 6573 0a2a 204c 696e 6b69 6e67 3a3a rces.* Linking:: │ │ │ │ │ 00029a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029a30: 2020 204c 696e 6b69 6e67 2077 6974 6820 Linking with │ │ │ │ │ -00029a40: 6c69 6272 6172 6965 7320 6f72 2065 7874 libraries or ext │ │ │ │ │ -00029a50: 7261 206f 626a 6563 7473 0a2a 2043 6f6e ra objects.* Con │ │ │ │ │ -00029a60: 6469 7469 6f6e 616c 2053 6f75 7263 6573 ditional Sources │ │ │ │ │ -00029a70: 3a3a 2020 2020 2020 2020 2048 616e 646c :: Handl │ │ │ │ │ -00029a80: 696e 6720 636f 6e64 6974 696f 6e61 6c20 ing conditional │ │ │ │ │ -00029a90: 736f 7572 6365 730a 2a20 436f 6e64 6974 sources.* Condit │ │ │ │ │ -00029aa0: 696f 6e61 6c20 5072 6f67 7261 6d73 3a3a ional Programs:: │ │ │ │ │ -00029ab0: 2020 2020 2020 2020 4275 696c 6469 6e67 Building │ │ │ │ │ -00029ac0: 2061 2070 726f 6772 616d 2063 6f6e 6469 a program condi │ │ │ │ │ -00029ad0: 7469 6f6e 616c 6c79 0a0a 1f0a 4669 6c65 tionally....File │ │ │ │ │ -00029ae0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -00029af0: 696e 666f 2c20 204e 6f64 653a 2050 726f info, Node: Pro │ │ │ │ │ -00029b00: 6772 616d 2053 6f75 7263 6573 2c20 204e gram Sources, N │ │ │ │ │ -00029b10: 6578 743a 204c 696e 6b69 6e67 2c20 2055 ext: Linking, U │ │ │ │ │ -00029b20: 703a 2041 2050 726f 6772 616d 0a0a 382e p: A Program..8. │ │ │ │ │ -00029b30: 312e 3120 4465 6669 6e69 6e67 2070 726f 1.1 Defining pro │ │ │ │ │ -00029b40: 6772 616d 2073 6f75 7263 6573 0a2d 2d2d gram sources.--- │ │ │ │ │ +00029a30: 2020 2020 204c 696e 6b69 6e67 2077 6974 Linking wit │ │ │ │ │ +00029a40: 6820 6c69 6272 6172 6965 7320 6f72 2065 h libraries or e │ │ │ │ │ +00029a50: 7874 7261 206f 626a 6563 7473 0a2a 2043 xtra objects.* C │ │ │ │ │ +00029a60: 6f6e 6469 7469 6f6e 616c 2053 6f75 7263 onditional Sourc │ │ │ │ │ +00029a70: 6573 3a3a 2020 2020 2020 2020 2048 616e es:: Han │ │ │ │ │ +00029a80: 646c 696e 6720 636f 6e64 6974 696f 6e61 dling conditiona │ │ │ │ │ +00029a90: 6c20 736f 7572 6365 730a 2a20 436f 6e64 l sources.* Cond │ │ │ │ │ +00029aa0: 6974 696f 6e61 6c20 5072 6f67 7261 6d73 itional Programs │ │ │ │ │ +00029ab0: 3a3a 2020 2020 2020 2020 4275 696c 6469 :: Buildi │ │ │ │ │ +00029ac0: 6e67 2061 2070 726f 6772 616d 2063 6f6e ng a program con │ │ │ │ │ +00029ad0: 6469 7469 6f6e 616c 6c79 0a0a 1f0a 4669 ditionally....Fi │ │ │ │ │ +00029ae0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +00029af0: 312e 696e 666f 2c20 204e 6f64 653a 2050 1.info, Node: P │ │ │ │ │ +00029b00: 726f 6772 616d 2053 6f75 7263 6573 2c20 rogram Sources, │ │ │ │ │ +00029b10: 204e 6578 743a 204c 696e 6b69 6e67 2c20 Next: Linking, │ │ │ │ │ +00029b20: 2055 703a 2041 2050 726f 6772 616d 0a0a Up: A Program.. │ │ │ │ │ +00029b30: 382e 312e 3120 4465 6669 6e69 6e67 2070 8.1.1 Defining p │ │ │ │ │ +00029b40: 726f 6772 616d 2073 6f75 7263 6573 0a2d rogram sources.- │ │ │ │ │ 00029b50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00029b60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6e20 -----------..In │ │ │ │ │ -00029b70: 6120 6469 7265 6374 6f72 7920 636f 6e74 a directory cont │ │ │ │ │ -00029b80: 6169 6e69 6e67 2073 6f75 7263 6520 7468 aining source th │ │ │ │ │ -00029b90: 6174 2067 6574 7320 6275 696c 7420 696e at gets built in │ │ │ │ │ -00029ba0: 746f 2061 2070 726f 6772 616d 2028 6173 to a program (as │ │ │ │ │ -00029bb0: 0a6f 7070 6f73 6564 2074 6f20 6120 6c69 .opposed to a li │ │ │ │ │ -00029bc0: 6272 6172 7920 6f72 2061 2073 6372 6970 brary or a scrip │ │ │ │ │ -00029bd0: 7429 2c20 7468 6520 2750 524f 4752 414d t), the 'PROGRAM │ │ │ │ │ -00029be0: 5327 2070 7269 6d61 7279 2069 7320 7573 S' primary is us │ │ │ │ │ -00029bf0: 6564 2e0a 5072 6f67 7261 6d73 2063 616e ed..Programs can │ │ │ │ │ -00029c00: 2062 6520 696e 7374 616c 6c65 6420 696e be installed in │ │ │ │ │ -00029c10: 2027 6269 6e64 6972 272c 2027 7362 696e 'bindir', 'sbin │ │ │ │ │ -00029c20: 6469 7227 2c20 276c 6962 6578 6563 6469 dir', 'libexecdi │ │ │ │ │ -00029c30: 7227 2c0a 2770 6b67 6c69 6265 7865 6364 r',.'pkglibexecd │ │ │ │ │ -00029c40: 6972 272c 206f 7220 6e6f 7420 6174 2061 ir', or not at a │ │ │ │ │ -00029c50: 6c6c 2028 276e 6f69 6e73 745f 2729 2e20 ll ('noinst_'). │ │ │ │ │ -00029c60: 2054 6865 7920 6361 6e20 616c 736f 2062 They can also b │ │ │ │ │ -00029c70: 6520 6275 696c 7420 6f6e 6c79 0a66 6f72 e built only.for │ │ │ │ │ -00029c80: 2027 6d61 6b65 2063 6865 636b 272c 2069 'make check', i │ │ │ │ │ -00029c90: 6e20 7768 6963 6820 6361 7365 2074 6865 n which case the │ │ │ │ │ -00029ca0: 2070 7265 6669 7820 6973 2027 6368 6563 prefix is 'chec │ │ │ │ │ -00029cb0: 6b5f 272e 0a0a 2020 2046 6f72 2069 6e73 k_'... For ins │ │ │ │ │ -00029cc0: 7461 6e63 653a 0a0a 2020 2020 2062 696e tance:.. bin │ │ │ │ │ -00029cd0: 5f50 524f 4752 414d 5320 3d20 6865 6c6c _PROGRAMS = hell │ │ │ │ │ -00029ce0: 6f0a 0a20 2020 496e 2074 6869 7320 7369 o.. In this si │ │ │ │ │ -00029cf0: 6d70 6c65 2063 6173 652c 2074 6865 2072 mple case, the r │ │ │ │ │ -00029d00: 6573 756c 7469 6e67 2027 4d61 6b65 6669 esulting 'Makefi │ │ │ │ │ -00029d10: 6c65 2e69 6e27 2077 696c 6c20 636f 6e74 le.in' will cont │ │ │ │ │ -00029d20: 6169 6e20 636f 6465 2074 6f0a 6765 6e65 ain code to.gene │ │ │ │ │ -00029d30: 7261 7465 2061 2070 726f 6772 616d 206e rate a program n │ │ │ │ │ -00029d40: 616d 6564 2027 6865 6c6c 6f27 2e0a 0a20 amed 'hello'... │ │ │ │ │ -00029d50: 2020 4173 736f 6369 6174 6564 2077 6974 Associated wit │ │ │ │ │ -00029d60: 6820 6561 6368 2070 726f 6772 616d 2061 h each program a │ │ │ │ │ -00029d70: 7265 2073 6576 6572 616c 2061 7373 6973 re several assis │ │ │ │ │ -00029d80: 7469 6e67 2076 6172 6961 626c 6573 2074 ting variables t │ │ │ │ │ -00029d90: 6861 7420 6172 650a 6e61 6d65 6420 6166 hat are.named af │ │ │ │ │ -00029da0: 7465 7220 7468 6520 7072 6f67 7261 6d2e ter the program. │ │ │ │ │ -00029db0: 2020 5468 6573 6520 7661 7269 6162 6c65 These variable │ │ │ │ │ -00029dc0: 7320 6172 6520 616c 6c20 6f70 7469 6f6e s are all option │ │ │ │ │ -00029dd0: 616c 2c20 616e 6420 6861 7665 0a72 6561 al, and have.rea │ │ │ │ │ -00029de0: 736f 6e61 626c 6520 6465 6661 756c 7473 sonable defaults │ │ │ │ │ -00029df0: 2e20 2045 6163 6820 7661 7269 6162 6c65 . Each variable │ │ │ │ │ -00029e00: 2c20 6974 7320 7573 652c 2061 6e64 2064 , its use, and d │ │ │ │ │ -00029e10: 6566 6175 6c74 2069 7320 7370 656c 6c65 efault is spelle │ │ │ │ │ -00029e20: 6420 6f75 740a 6265 6c6f 773b 2077 6520 d out.below; we │ │ │ │ │ -00029e30: 7573 6520 7468 6520 2268 656c 6c6f 2220 use the "hello" │ │ │ │ │ -00029e40: 6578 616d 706c 6520 7468 726f 7567 686f example througho │ │ │ │ │ -00029e50: 7574 2e0a 0a20 2020 5468 6520 7661 7269 ut... The vari │ │ │ │ │ -00029e60: 6162 6c65 2027 6865 6c6c 6f5f 534f 5552 able 'hello_SOUR │ │ │ │ │ -00029e70: 4345 5327 2069 7320 7573 6564 2074 6f20 CES' is used to │ │ │ │ │ -00029e80: 7370 6563 6966 7920 7768 6963 6820 736f specify which so │ │ │ │ │ -00029e90: 7572 6365 2066 696c 6573 0a67 6574 2062 urce files.get b │ │ │ │ │ -00029ea0: 7569 6c74 2069 6e74 6f20 616e 2065 7865 uilt into an exe │ │ │ │ │ -00029eb0: 6375 7461 626c 653a 0a0a 2020 2020 2068 cutable:.. h │ │ │ │ │ -00029ec0: 656c 6c6f 5f53 4f55 5243 4553 203d 2068 ello_SOURCES = h │ │ │ │ │ -00029ed0: 656c 6c6f 2e63 2076 6572 7369 6f6e 2e63 ello.c version.c │ │ │ │ │ -00029ee0: 2067 6574 6f70 742e 6320 6765 746f 7074 getopt.c getopt │ │ │ │ │ -00029ef0: 312e 6320 6765 746f 7074 2e68 2073 7973 1.c getopt.h sys │ │ │ │ │ -00029f00: 7465 6d2e 680a 0a20 2020 5468 6973 2063 tem.h.. This c │ │ │ │ │ -00029f10: 6175 7365 7320 6561 6368 206d 656e 7469 auses each menti │ │ │ │ │ -00029f20: 6f6e 6564 2027 2e63 2720 6669 6c65 2074 oned '.c' file t │ │ │ │ │ -00029f30: 6f20 6265 2063 6f6d 7069 6c65 6420 696e o be compiled in │ │ │ │ │ -00029f40: 746f 2074 6865 0a63 6f72 7265 7370 6f6e to the.correspon │ │ │ │ │ -00029f50: 6469 6e67 2027 2e6f 272e 2020 5468 656e ding '.o'. Then │ │ │ │ │ -00029f60: 2061 6c6c 2061 7265 206c 696e 6b65 6420 all are linked │ │ │ │ │ -00029f70: 746f 2070 726f 6475 6365 2027 6865 6c6c to produce 'hell │ │ │ │ │ -00029f80: 6f27 2e0a 0a20 2020 4966 2027 6865 6c6c o'... If 'hell │ │ │ │ │ -00029f90: 6f5f 534f 5552 4345 5327 2069 7320 6e6f o_SOURCES' is no │ │ │ │ │ -00029fa0: 7420 7370 6563 6966 6965 642c 2074 6865 t specified, the │ │ │ │ │ -00029fb0: 6e20 6974 2064 6566 6175 6c74 7320 746f n it defaults to │ │ │ │ │ -00029fc0: 2074 6865 2073 696e 676c 650a 6669 6c65 the single.file │ │ │ │ │ -00029fd0: 2027 6865 6c6c 6f2e 6327 2028 2a6e 6f74 'hello.c' (*not │ │ │ │ │ -00029fe0: 6520 4465 6661 756c 7420 5f53 4f55 5243 e Default _SOURC │ │ │ │ │ -00029ff0: 4553 3a3a 292e 0a0a 2020 204d 756c 7469 ES::)... Multi │ │ │ │ │ -0002a000: 706c 6520 7072 6f67 7261 6d73 2063 616e ple programs can │ │ │ │ │ -0002a010: 2062 6520 6275 696c 7420 696e 2061 2073 be built in a s │ │ │ │ │ -0002a020: 696e 676c 6520 6469 7265 6374 6f72 792e ingle directory. │ │ │ │ │ -0002a030: 2020 4d75 6c74 6970 6c65 0a70 726f 6772 Multiple.progr │ │ │ │ │ -0002a040: 616d 7320 6361 6e20 7368 6172 6520 6120 ams can share a │ │ │ │ │ -0002a050: 7369 6e67 6c65 2073 6f75 7263 6520 6669 single source fi │ │ │ │ │ -0002a060: 6c65 2c20 7768 6963 6820 6d75 7374 2062 le, which must b │ │ │ │ │ -0002a070: 6520 6c69 7374 6564 2069 6e20 6561 6368 e listed in each │ │ │ │ │ -0002a080: 0a27 5f53 4f55 5243 4553 2720 6465 6669 .'_SOURCES' defi │ │ │ │ │ -0002a090: 6e69 7469 6f6e 2e0a 0a20 2020 4865 6164 nition... Head │ │ │ │ │ -0002a0a0: 6572 2066 696c 6573 206c 6973 7465 6420 er files listed │ │ │ │ │ -0002a0b0: 696e 2061 2027 5f53 4f55 5243 4553 2720 in a '_SOURCES' │ │ │ │ │ -0002a0c0: 6465 6669 6e69 7469 6f6e 2077 696c 6c20 definition will │ │ │ │ │ -0002a0d0: 6265 2069 6e63 6c75 6465 6420 696e 0a74 be included in.t │ │ │ │ │ -0002a0e0: 6865 2064 6973 7472 6962 7574 696f 6e20 he distribution │ │ │ │ │ -0002a0f0: 6275 7420 6f74 6865 7277 6973 6520 6967 but otherwise ig │ │ │ │ │ -0002a100: 6e6f 7265 642e 2020 496e 2063 6173 6520 nored. In case │ │ │ │ │ -0002a110: 6974 2069 736e 2774 206f 6276 696f 7573 it isn't obvious │ │ │ │ │ -0002a120: 2c20 796f 750a 7368 6f75 6c64 206e 6f74 , you.should not │ │ │ │ │ -0002a130: 2069 6e63 6c75 6465 2074 6865 2068 6561 include the hea │ │ │ │ │ -0002a140: 6465 7220 6669 6c65 2067 656e 6572 6174 der file generat │ │ │ │ │ -0002a150: 6564 2062 7920 2763 6f6e 6669 6775 7265 ed by 'configure │ │ │ │ │ -0002a160: 2720 696e 2061 0a27 5f53 4f55 5243 4553 ' in a.'_SOURCES │ │ │ │ │ -0002a170: 2720 7661 7269 6162 6c65 3b20 7468 6973 ' variable; this │ │ │ │ │ -0002a180: 2066 696c 6520 7368 6f75 6c64 206e 6f74 file should not │ │ │ │ │ -0002a190: 2062 6520 6469 7374 7269 6275 7465 642e be distributed. │ │ │ │ │ -0002a1a0: 2020 4c65 7820 2827 2e6c 2729 0a61 6e64 Lex ('.l').and │ │ │ │ │ -0002a1b0: 2059 6163 6320 2827 2e79 2729 2066 696c Yacc ('.y') fil │ │ │ │ │ -0002a1c0: 6573 2063 616e 2061 6c73 6f20 6265 206c es can also be l │ │ │ │ │ -0002a1d0: 6973 7465 643b 2073 6565 202a 6e6f 7465 isted; see *note │ │ │ │ │ -0002a1e0: 2059 6163 6320 616e 6420 4c65 783a 3a2e Yacc and Lex::. │ │ │ │ │ -0002a1f0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -0002a200: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -0002a210: 6f64 653a 204c 696e 6b69 6e67 2c20 204e ode: Linking, N │ │ │ │ │ -0002a220: 6578 743a 2043 6f6e 6469 7469 6f6e 616c ext: Conditional │ │ │ │ │ -0002a230: 2053 6f75 7263 6573 2c20 2050 7265 763a Sources, Prev: │ │ │ │ │ -0002a240: 2050 726f 6772 616d 2053 6f75 7263 6573 Program Sources │ │ │ │ │ -0002a250: 2c20 2055 703a 2041 2050 726f 6772 616d , Up: A Program │ │ │ │ │ -0002a260: 0a0a 382e 312e 3220 4c69 6e6b 696e 6720 ..8.1.2 Linking │ │ │ │ │ -0002a270: 7468 6520 7072 6f67 7261 6d0a 2d2d 2d2d the program.---- │ │ │ │ │ +00029b60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 -------------..I │ │ │ │ │ +00029b70: 6e20 6120 6469 7265 6374 6f72 7920 636f n a directory co │ │ │ │ │ +00029b80: 6e74 6169 6e69 6e67 2073 6f75 7263 6520 ntaining source │ │ │ │ │ +00029b90: 7468 6174 2067 6574 7320 6275 696c 7420 that gets built │ │ │ │ │ +00029ba0: 696e 746f 2061 2070 726f 6772 616d 2028 into a program ( │ │ │ │ │ +00029bb0: 6173 0a6f 7070 6f73 6564 2074 6f20 6120 as.opposed to a │ │ │ │ │ +00029bc0: 6c69 6272 6172 7920 6f72 2061 2073 6372 library or a scr │ │ │ │ │ +00029bd0: 6970 7429 2c20 7468 6520 2750 524f 4752 ipt), the 'PROGR │ │ │ │ │ +00029be0: 414d 5327 2070 7269 6d61 7279 2069 7320 AMS' primary is │ │ │ │ │ +00029bf0: 7573 6564 2e0a 5072 6f67 7261 6d73 2063 used..Programs c │ │ │ │ │ +00029c00: 616e 2062 6520 696e 7374 616c 6c65 6420 an be installed │ │ │ │ │ +00029c10: 696e 2027 6269 6e64 6972 272c 2027 7362 in 'bindir', 'sb │ │ │ │ │ +00029c20: 696e 6469 7227 2c20 276c 6962 6578 6563 indir', 'libexec │ │ │ │ │ +00029c30: 6469 7227 2c0a 2770 6b67 6c69 6265 7865 dir',.'pkglibexe │ │ │ │ │ +00029c40: 6364 6972 272c 206f 7220 6e6f 7420 6174 cdir', or not at │ │ │ │ │ +00029c50: 2061 6c6c 2028 276e 6f69 6e73 745f 2729 all ('noinst_') │ │ │ │ │ +00029c60: 2e20 2054 6865 7920 6361 6e20 616c 736f . They can also │ │ │ │ │ +00029c70: 2062 6520 6275 696c 7420 6f6e 6c79 0a66 be built only.f │ │ │ │ │ +00029c80: 6f72 2027 6d61 6b65 2063 6865 636b 272c or 'make check', │ │ │ │ │ +00029c90: 2069 6e20 7768 6963 6820 6361 7365 2074 in which case t │ │ │ │ │ +00029ca0: 6865 2070 7265 6669 7820 6973 2027 6368 he prefix is 'ch │ │ │ │ │ +00029cb0: 6563 6b5f 272e 0a0a 2020 2046 6f72 2069 eck_'... For i │ │ │ │ │ +00029cc0: 6e73 7461 6e63 653a 0a0a 2020 2020 2062 nstance:.. b │ │ │ │ │ +00029cd0: 696e 5f50 524f 4752 414d 5320 3d20 6865 in_PROGRAMS = he │ │ │ │ │ +00029ce0: 6c6c 6f0a 0a20 2020 496e 2074 6869 7320 llo.. In this │ │ │ │ │ +00029cf0: 7369 6d70 6c65 2063 6173 652c 2074 6865 simple case, the │ │ │ │ │ +00029d00: 2072 6573 756c 7469 6e67 2027 4d61 6b65 resulting 'Make │ │ │ │ │ +00029d10: 6669 6c65 2e69 6e27 2077 696c 6c20 636f file.in' will co │ │ │ │ │ +00029d20: 6e74 6169 6e20 636f 6465 2074 6f0a 6765 ntain code to.ge │ │ │ │ │ +00029d30: 6e65 7261 7465 2061 2070 726f 6772 616d nerate a program │ │ │ │ │ +00029d40: 206e 616d 6564 2027 6865 6c6c 6f27 2e0a named 'hello'.. │ │ │ │ │ +00029d50: 0a20 2020 4173 736f 6369 6174 6564 2077 . Associated w │ │ │ │ │ +00029d60: 6974 6820 6561 6368 2070 726f 6772 616d ith each program │ │ │ │ │ +00029d70: 2061 7265 2073 6576 6572 616c 2061 7373 are several ass │ │ │ │ │ +00029d80: 6973 7469 6e67 2076 6172 6961 626c 6573 isting variables │ │ │ │ │ +00029d90: 2074 6861 7420 6172 650a 6e61 6d65 6420 that are.named │ │ │ │ │ +00029da0: 6166 7465 7220 7468 6520 7072 6f67 7261 after the progra │ │ │ │ │ +00029db0: 6d2e 2020 5468 6573 6520 7661 7269 6162 m. These variab │ │ │ │ │ +00029dc0: 6c65 7320 6172 6520 616c 6c20 6f70 7469 les are all opti │ │ │ │ │ +00029dd0: 6f6e 616c 2c20 616e 6420 6861 7665 0a72 onal, and have.r │ │ │ │ │ +00029de0: 6561 736f 6e61 626c 6520 6465 6661 756c easonable defaul │ │ │ │ │ +00029df0: 7473 2e20 2045 6163 6820 7661 7269 6162 ts. Each variab │ │ │ │ │ +00029e00: 6c65 2c20 6974 7320 7573 652c 2061 6e64 le, its use, and │ │ │ │ │ +00029e10: 2064 6566 6175 6c74 2069 7320 7370 656c default is spel │ │ │ │ │ +00029e20: 6c65 6420 6f75 740a 6265 6c6f 773b 2077 led out.below; w │ │ │ │ │ +00029e30: 6520 7573 6520 7468 6520 2268 656c 6c6f e use the "hello │ │ │ │ │ +00029e40: 2220 6578 616d 706c 6520 7468 726f 7567 " example throug │ │ │ │ │ +00029e50: 686f 7574 2e0a 0a20 2020 5468 6520 7661 hout... The va │ │ │ │ │ +00029e60: 7269 6162 6c65 2027 6865 6c6c 6f5f 534f riable 'hello_SO │ │ │ │ │ +00029e70: 5552 4345 5327 2069 7320 7573 6564 2074 URCES' is used t │ │ │ │ │ +00029e80: 6f20 7370 6563 6966 7920 7768 6963 6820 o specify which │ │ │ │ │ +00029e90: 736f 7572 6365 2066 696c 6573 0a67 6574 source files.get │ │ │ │ │ +00029ea0: 2062 7569 6c74 2069 6e74 6f20 616e 2065 built into an e │ │ │ │ │ +00029eb0: 7865 6375 7461 626c 653a 0a0a 2020 2020 xecutable:.. │ │ │ │ │ +00029ec0: 2068 656c 6c6f 5f53 4f55 5243 4553 203d hello_SOURCES = │ │ │ │ │ +00029ed0: 2068 656c 6c6f 2e63 2076 6572 7369 6f6e hello.c version │ │ │ │ │ +00029ee0: 2e63 2067 6574 6f70 742e 6320 6765 746f .c getopt.c geto │ │ │ │ │ +00029ef0: 7074 312e 6320 6765 746f 7074 2e68 2073 pt1.c getopt.h s │ │ │ │ │ +00029f00: 7973 7465 6d2e 680a 0a20 2020 5468 6973 ystem.h.. This │ │ │ │ │ +00029f10: 2063 6175 7365 7320 6561 6368 206d 656e causes each men │ │ │ │ │ +00029f20: 7469 6f6e 6564 2027 2e63 2720 6669 6c65 tioned '.c' file │ │ │ │ │ +00029f30: 2074 6f20 6265 2063 6f6d 7069 6c65 6420 to be compiled │ │ │ │ │ +00029f40: 696e 746f 2074 6865 0a63 6f72 7265 7370 into the.corresp │ │ │ │ │ +00029f50: 6f6e 6469 6e67 2027 2e6f 272e 2020 5468 onding '.o'. Th │ │ │ │ │ +00029f60: 656e 2061 6c6c 2061 7265 206c 696e 6b65 en all are linke │ │ │ │ │ +00029f70: 6420 746f 2070 726f 6475 6365 2027 6865 d to produce 'he │ │ │ │ │ +00029f80: 6c6c 6f27 2e0a 0a20 2020 4966 2027 6865 llo'... If 'he │ │ │ │ │ +00029f90: 6c6c 6f5f 534f 5552 4345 5327 2069 7320 llo_SOURCES' is │ │ │ │ │ +00029fa0: 6e6f 7420 7370 6563 6966 6965 642c 2074 not specified, t │ │ │ │ │ +00029fb0: 6865 6e20 6974 2064 6566 6175 6c74 7320 hen it defaults │ │ │ │ │ +00029fc0: 746f 2074 6865 2073 696e 676c 650a 6669 to the single.fi │ │ │ │ │ +00029fd0: 6c65 2027 6865 6c6c 6f2e 6327 2028 2a6e le 'hello.c' (*n │ │ │ │ │ +00029fe0: 6f74 6520 4465 6661 756c 7420 5f53 4f55 ote Default _SOU │ │ │ │ │ +00029ff0: 5243 4553 3a3a 292e 0a0a 2020 204d 756c RCES::)... Mul │ │ │ │ │ +0002a000: 7469 706c 6520 7072 6f67 7261 6d73 2063 tiple programs c │ │ │ │ │ +0002a010: 616e 2062 6520 6275 696c 7420 696e 2061 an be built in a │ │ │ │ │ +0002a020: 2073 696e 676c 6520 6469 7265 6374 6f72 single director │ │ │ │ │ +0002a030: 792e 2020 4d75 6c74 6970 6c65 0a70 726f y. Multiple.pro │ │ │ │ │ +0002a040: 6772 616d 7320 6361 6e20 7368 6172 6520 grams can share │ │ │ │ │ +0002a050: 6120 7369 6e67 6c65 2073 6f75 7263 6520 a single source │ │ │ │ │ +0002a060: 6669 6c65 2c20 7768 6963 6820 6d75 7374 file, which must │ │ │ │ │ +0002a070: 2062 6520 6c69 7374 6564 2069 6e20 6561 be listed in ea │ │ │ │ │ +0002a080: 6368 0a27 5f53 4f55 5243 4553 2720 6465 ch.'_SOURCES' de │ │ │ │ │ +0002a090: 6669 6e69 7469 6f6e 2e0a 0a20 2020 4865 finition... He │ │ │ │ │ +0002a0a0: 6164 6572 2066 696c 6573 206c 6973 7465 ader files liste │ │ │ │ │ +0002a0b0: 6420 696e 2061 2027 5f53 4f55 5243 4553 d in a '_SOURCES │ │ │ │ │ +0002a0c0: 2720 6465 6669 6e69 7469 6f6e 2077 696c ' definition wil │ │ │ │ │ +0002a0d0: 6c20 6265 2069 6e63 6c75 6465 6420 696e l be included in │ │ │ │ │ +0002a0e0: 0a74 6865 2064 6973 7472 6962 7574 696f .the distributio │ │ │ │ │ +0002a0f0: 6e20 6275 7420 6f74 6865 7277 6973 6520 n but otherwise │ │ │ │ │ +0002a100: 6967 6e6f 7265 642e 2020 496e 2063 6173 ignored. In cas │ │ │ │ │ +0002a110: 6520 6974 2069 736e 2774 206f 6276 696f e it isn't obvio │ │ │ │ │ +0002a120: 7573 2c20 796f 750a 7368 6f75 6c64 206e us, you.should n │ │ │ │ │ +0002a130: 6f74 2069 6e63 6c75 6465 2074 6865 2068 ot include the h │ │ │ │ │ +0002a140: 6561 6465 7220 6669 6c65 2067 656e 6572 eader file gener │ │ │ │ │ +0002a150: 6174 6564 2062 7920 2763 6f6e 6669 6775 ated by 'configu │ │ │ │ │ +0002a160: 7265 2720 696e 2061 0a27 5f53 4f55 5243 re' in a.'_SOURC │ │ │ │ │ +0002a170: 4553 2720 7661 7269 6162 6c65 3b20 7468 ES' variable; th │ │ │ │ │ +0002a180: 6973 2066 696c 6520 7368 6f75 6c64 206e is file should n │ │ │ │ │ +0002a190: 6f74 2062 6520 6469 7374 7269 6275 7465 ot be distribute │ │ │ │ │ +0002a1a0: 642e 2020 4c65 7820 2827 2e6c 2729 0a61 d. Lex ('.l').a │ │ │ │ │ +0002a1b0: 6e64 2059 6163 6320 2827 2e79 2729 2066 nd Yacc ('.y') f │ │ │ │ │ +0002a1c0: 696c 6573 2063 616e 2061 6c73 6f20 6265 iles can also be │ │ │ │ │ +0002a1d0: 206c 6973 7465 643b 2073 6565 202a 6e6f listed; see *no │ │ │ │ │ +0002a1e0: 7465 2059 6163 6320 616e 6420 4c65 783a te Yacc and Lex: │ │ │ │ │ +0002a1f0: 3a2e 0a0a 1f0a 4669 6c65 3a20 6175 746f :.....File: auto │ │ │ │ │ +0002a200: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +0002a210: 204e 6f64 653a 204c 696e 6b69 6e67 2c20 Node: Linking, │ │ │ │ │ +0002a220: 204e 6578 743a 2043 6f6e 6469 7469 6f6e Next: Condition │ │ │ │ │ +0002a230: 616c 2053 6f75 7263 6573 2c20 2050 7265 al Sources, Pre │ │ │ │ │ +0002a240: 763a 2050 726f 6772 616d 2053 6f75 7263 v: Program Sourc │ │ │ │ │ +0002a250: 6573 2c20 2055 703a 2041 2050 726f 6772 es, Up: A Progr │ │ │ │ │ +0002a260: 616d 0a0a 382e 312e 3220 4c69 6e6b 696e am..8.1.2 Linkin │ │ │ │ │ +0002a270: 6720 7468 6520 7072 6f67 7261 6d0a 2d2d g the program.-- │ │ │ │ │ 0002a280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002a290: 2d2d 2d2d 2d0a 0a49 6620 796f 7520 6e65 -----..If you ne │ │ │ │ │ -0002a2a0: 6564 2074 6f20 6c69 6e6b 2061 6761 696e ed to link again │ │ │ │ │ -0002a2b0: 7374 206c 6962 7261 7269 6573 2074 6861 st libraries tha │ │ │ │ │ -0002a2c0: 7420 6172 6520 6e6f 7420 666f 756e 6420 t are not found │ │ │ │ │ -0002a2d0: 6279 2027 636f 6e66 6967 7572 6527 2c0a by 'configure',. │ │ │ │ │ -0002a2e0: 796f 7520 6361 6e20 7573 6520 274c 4441 you can use 'LDA │ │ │ │ │ -0002a2f0: 4444 2720 746f 2064 6f20 736f 2e20 2054 DD' to do so. T │ │ │ │ │ -0002a300: 6869 7320 7661 7269 6162 6c65 2069 7320 his variable is │ │ │ │ │ -0002a310: 7573 6564 2074 6f20 7370 6563 6966 790a used to specify. │ │ │ │ │ -0002a320: 6164 6469 7469 6f6e 616c 206f 626a 6563 additional objec │ │ │ │ │ -0002a330: 7473 206f 7220 6c69 6272 6172 6965 7320 ts or libraries │ │ │ │ │ -0002a340: 746f 206c 696e 6b20 7769 7468 3b20 6974 to link with; it │ │ │ │ │ -0002a350: 2069 7320 696e 6170 7072 6f70 7269 6174 is inappropriat │ │ │ │ │ -0002a360: 6520 666f 720a 7370 6563 6966 7969 6e67 e for.specifying │ │ │ │ │ -0002a370: 2073 7065 6369 6669 6320 6c69 6e6b 6572 specific linker │ │ │ │ │ -0002a380: 2066 6c61 6773 2c20 796f 7520 7368 6f75 flags, you shou │ │ │ │ │ -0002a390: 6c64 2075 7365 2027 414d 5f4c 4446 4c41 ld use 'AM_LDFLA │ │ │ │ │ -0002a3a0: 4753 2720 666f 7220 7468 6973 0a70 7572 GS' for this.pur │ │ │ │ │ -0002a3b0: 706f 7365 2e0a 0a20 2020 536f 6d65 7469 pose... Someti │ │ │ │ │ -0002a3c0: 6d65 732c 206d 756c 7469 706c 6520 7072 mes, multiple pr │ │ │ │ │ -0002a3d0: 6f67 7261 6d73 2061 7265 2062 7569 6c74 ograms are built │ │ │ │ │ -0002a3e0: 2069 6e20 6f6e 6520 6469 7265 6374 6f72 in one director │ │ │ │ │ -0002a3f0: 7920 6275 7420 646f 206e 6f74 0a73 6861 y but do not.sha │ │ │ │ │ -0002a400: 7265 2074 6865 2073 616d 6520 6c69 6e6b re the same link │ │ │ │ │ -0002a410: 2d74 696d 6520 7265 7175 6972 656d 656e -time requiremen │ │ │ │ │ -0002a420: 7473 2e20 2049 6e20 7468 6973 2063 6173 ts. In this cas │ │ │ │ │ -0002a430: 652c 2079 6f75 2063 616e 2075 7365 2074 e, you can use t │ │ │ │ │ -0002a440: 6865 0a27 5052 4f47 5f4c 4441 4444 2720 he.'PROG_LDADD' │ │ │ │ │ -0002a450: 7661 7269 6162 6c65 2028 7768 6572 6520 variable (where │ │ │ │ │ -0002a460: 5052 4f47 2069 7320 7468 6520 6e61 6d65 PROG is the name │ │ │ │ │ -0002a470: 206f 6620 7468 6520 7072 6f67 7261 6d20 of the program │ │ │ │ │ -0002a480: 6173 2069 740a 6170 7065 6172 7320 696e as it.appears in │ │ │ │ │ -0002a490: 2073 6f6d 6520 275f 5052 4f47 5241 4d53 some '_PROGRAMS │ │ │ │ │ -0002a4a0: 2720 7661 7269 6162 6c65 2c20 616e 6420 ' variable, and │ │ │ │ │ -0002a4b0: 7573 7561 6c6c 7920 7772 6974 7465 6e20 usually written │ │ │ │ │ -0002a4c0: 696e 206c 6f77 6572 6361 7365 290a 746f in lowercase).to │ │ │ │ │ -0002a4d0: 206f 7665 7272 6964 6520 274c 4441 4444 override 'LDADD │ │ │ │ │ -0002a4e0: 272e 2020 4966 2074 6869 7320 7661 7269 '. If this vari │ │ │ │ │ -0002a4f0: 6162 6c65 2065 7869 7374 7320 666f 7220 able exists for │ │ │ │ │ -0002a500: 6120 6769 7665 6e20 7072 6f67 7261 6d2c a given program, │ │ │ │ │ -0002a510: 2074 6865 6e0a 7468 6174 2070 726f 6772 then.that progr │ │ │ │ │ -0002a520: 616d 2069 7320 6e6f 7420 6c69 6e6b 6564 am is not linked │ │ │ │ │ -0002a530: 2075 7369 6e67 2027 4c44 4144 4427 2e0a using 'LDADD'.. │ │ │ │ │ -0002a540: 0a20 2020 466f 7220 696e 7374 616e 6365 . For instance │ │ │ │ │ -0002a550: 2c20 696e 2047 4e55 2063 7069 6f2c 2027 , in GNU cpio, ' │ │ │ │ │ -0002a560: 7061 7827 2c20 2763 7069 6f27 2061 6e64 pax', 'cpio' and │ │ │ │ │ -0002a570: 2027 6d74 2720 6172 6520 6c69 6e6b 6564 'mt' are linked │ │ │ │ │ -0002a580: 2061 6761 696e 7374 0a74 6865 206c 6962 against.the lib │ │ │ │ │ -0002a590: 7261 7279 2027 6c69 6263 7069 6f2e 6127 rary 'libcpio.a' │ │ │ │ │ -0002a5a0: 2e20 2048 6f77 6576 6572 2c20 2772 6d74 . However, 'rmt │ │ │ │ │ -0002a5b0: 2720 6973 2062 7569 6c74 2069 6e20 7468 ' is built in th │ │ │ │ │ -0002a5c0: 6520 7361 6d65 2064 6972 6563 746f 7279 e same directory │ │ │ │ │ -0002a5d0: 2c0a 616e 6420 6861 7320 6e6f 2073 7563 ,.and has no suc │ │ │ │ │ -0002a5e0: 6820 6c69 6e6b 2072 6571 7569 7265 6d65 h link requireme │ │ │ │ │ -0002a5f0: 6e74 2e20 2041 6c73 6f2c 2027 6d74 2720 nt. Also, 'mt' │ │ │ │ │ -0002a600: 616e 6420 2772 6d74 2720 6172 6520 6f6e and 'rmt' are on │ │ │ │ │ -0002a610: 6c79 2062 7569 6c74 0a6f 6e20 6365 7274 ly built.on cert │ │ │ │ │ -0002a620: 6169 6e20 6172 6368 6974 6563 7475 7265 ain architecture │ │ │ │ │ -0002a630: 732e 2020 4865 7265 2069 7320 7768 6174 s. Here is what │ │ │ │ │ -0002a640: 2063 7069 6f27 7320 2773 7263 2f4d 616b cpio's 'src/Mak │ │ │ │ │ -0002a650: 6566 696c 652e 616d 2720 6c6f 6f6b 730a efile.am' looks. │ │ │ │ │ -0002a660: 6c69 6b65 2028 6162 7269 6467 6564 293a like (abridged): │ │ │ │ │ -0002a670: 0a0a 2020 2020 2062 696e 5f50 524f 4752 .. bin_PROGR │ │ │ │ │ -0002a680: 414d 5320 3d20 6370 696f 2070 6178 2024 AMS = cpio pax $ │ │ │ │ │ -0002a690: 284d 5429 0a20 2020 2020 6c69 6265 7865 (MT). libexe │ │ │ │ │ -0002a6a0: 635f 5052 4f47 5241 4d53 203d 2024 2852 c_PROGRAMS = $(R │ │ │ │ │ -0002a6b0: 4d54 290a 2020 2020 2045 5854 5241 5f50 MT). EXTRA_P │ │ │ │ │ -0002a6c0: 524f 4752 414d 5320 3d20 6d74 2072 6d74 ROGRAMS = mt rmt │ │ │ │ │ -0002a6d0: 0a0a 2020 2020 204c 4441 4444 203d 202e .. LDADD = . │ │ │ │ │ -0002a6e0: 2e2f 6c69 622f 6c69 6263 7069 6f2e 6120 ./lib/libcpio.a │ │ │ │ │ -0002a6f0: 2428 494e 544c 4c49 4253 290a 2020 2020 $(INTLLIBS). │ │ │ │ │ -0002a700: 2072 6d74 5f4c 4441 4444 203d 0a0a 2020 rmt_LDADD =.. │ │ │ │ │ -0002a710: 2020 2063 7069 6f5f 534f 5552 4345 5320 cpio_SOURCES │ │ │ │ │ -0002a720: 3d20 2e2e 2e0a 2020 2020 2070 6178 5f53 = .... pax_S │ │ │ │ │ -0002a730: 4f55 5243 4553 203d 202e 2e2e 0a20 2020 OURCES = .... │ │ │ │ │ -0002a740: 2020 6d74 5f53 4f55 5243 4553 203d 202e mt_SOURCES = . │ │ │ │ │ -0002a750: 2e2e 0a20 2020 2020 726d 745f 534f 5552 ... rmt_SOUR │ │ │ │ │ -0002a760: 4345 5320 3d20 2e2e 2e0a 0a20 2020 2750 CES = ..... 'P │ │ │ │ │ -0002a770: 524f 475f 4c44 4144 4427 2069 7320 696e ROG_LDADD' is in │ │ │ │ │ -0002a780: 6170 7072 6f70 7269 6174 6520 666f 7220 appropriate for │ │ │ │ │ -0002a790: 7061 7373 696e 6720 7072 6f67 7261 6d2d passing program- │ │ │ │ │ -0002a7a0: 7370 6563 6966 6963 206c 696e 6b65 720a specific linker. │ │ │ │ │ -0002a7b0: 666c 6167 7320 2865 7863 6570 7420 666f flags (except fo │ │ │ │ │ -0002a7c0: 7220 272d 6c27 2c20 272d 4c27 2c20 272d r '-l', '-L', '- │ │ │ │ │ -0002a7d0: 646c 6f70 656e 2720 616e 6420 272d 646c dlopen' and '-dl │ │ │ │ │ -0002a7e0: 7072 656f 7065 6e27 292e 2020 536f 2c20 preopen'). So, │ │ │ │ │ -0002a7f0: 7573 6520 7468 650a 2750 524f 475f 4c44 use the.'PROG_LD │ │ │ │ │ -0002a800: 464c 4147 5327 2076 6172 6961 626c 6520 FLAGS' variable │ │ │ │ │ -0002a810: 666f 7220 7468 6973 2070 7572 706f 7365 for this purpose │ │ │ │ │ -0002a820: 2e0a 0a20 2020 4974 2069 7320 616c 736f ... It is also │ │ │ │ │ -0002a830: 206f 6363 6173 696f 6e61 6c6c 7920 7573 occasionally us │ │ │ │ │ -0002a840: 6566 756c 2074 6f20 6861 7665 2061 2070 eful to have a p │ │ │ │ │ -0002a850: 726f 6772 616d 2064 6570 656e 6420 6f6e rogram depend on │ │ │ │ │ -0002a860: 2073 6f6d 6520 6f74 6865 720a 7461 7267 some other.targ │ │ │ │ │ -0002a870: 6574 2074 6861 7420 6973 206e 6f74 2061 et that is not a │ │ │ │ │ -0002a880: 6374 7561 6c6c 7920 7061 7274 206f 6620 ctually part of │ │ │ │ │ -0002a890: 7468 6174 2070 726f 6772 616d 2e20 2054 that program. T │ │ │ │ │ -0002a8a0: 6869 7320 6361 6e20 6265 2064 6f6e 650a his can be done. │ │ │ │ │ -0002a8b0: 7573 696e 6720 6569 7468 6572 2074 6865 using either the │ │ │ │ │ -0002a8c0: 2027 5052 4f47 5f44 4550 454e 4445 4e43 'PROG_DEPENDENC │ │ │ │ │ -0002a8d0: 4945 5327 206f 7220 7468 6520 2745 5854 IES' or the 'EXT │ │ │ │ │ -0002a8e0: 5241 5f50 524f 475f 4445 5045 4e44 454e RA_PROG_DEPENDEN │ │ │ │ │ -0002a8f0: 4349 4553 270a 7661 7269 6162 6c65 2e20 CIES'.variable. │ │ │ │ │ -0002a900: 2045 6163 6820 7072 6f67 7261 6d20 6465 Each program de │ │ │ │ │ -0002a910: 7065 6e64 7320 6f6e 2074 6865 2063 6f6e pends on the con │ │ │ │ │ -0002a920: 7465 6e74 7320 626f 7468 2076 6172 6961 tents both varia │ │ │ │ │ -0002a930: 626c 6573 2c20 6275 7420 6e6f 0a66 7572 bles, but no.fur │ │ │ │ │ -0002a940: 7468 6572 2069 6e74 6572 7072 6574 6174 ther interpretat │ │ │ │ │ -0002a950: 696f 6e20 6973 2064 6f6e 652e 0a0a 2020 ion is done... │ │ │ │ │ -0002a960: 2053 696e 6365 2074 6865 7365 2064 6570 Since these dep │ │ │ │ │ -0002a970: 656e 6465 6e63 6965 7320 6172 6520 6173 endencies are as │ │ │ │ │ -0002a980: 736f 6369 6174 6564 2074 6f20 7468 6520 sociated to the │ │ │ │ │ -0002a990: 6c69 6e6b 2072 756c 6520 7573 6564 2074 link rule used t │ │ │ │ │ -0002a9a0: 6f0a 6372 6561 7465 2074 6865 2070 726f o.create the pro │ │ │ │ │ -0002a9b0: 6772 616d 7320 7468 6579 2073 686f 756c grams they shoul │ │ │ │ │ -0002a9c0: 6420 6e6f 726d 616c 6c79 206c 6973 7420 d normally list │ │ │ │ │ -0002a9d0: 6669 6c65 7320 7573 6564 2062 7920 7468 files used by th │ │ │ │ │ -0002a9e0: 6520 6c69 6e6b 0a63 6f6d 6d61 6e64 2e20 e link.command. │ │ │ │ │ -0002a9f0: 2054 6861 7420 6973 2027 2a2e 2428 4f42 That is '*.$(OB │ │ │ │ │ -0002aa00: 4a45 5854 2927 2c20 272a 2e61 272c 206f JEXT)', '*.a', o │ │ │ │ │ -0002aa10: 7220 272a 2e6c 6127 2066 696c 6573 2e20 r '*.la' files. │ │ │ │ │ -0002aa20: 2049 6e20 7261 7265 2063 6173 6573 0a79 In rare cases.y │ │ │ │ │ -0002aa30: 6f75 206d 6179 206e 6565 6420 746f 2061 ou may need to a │ │ │ │ │ -0002aa40: 6464 206f 7468 6572 206b 696e 6473 206f dd other kinds o │ │ │ │ │ -0002aa50: 6620 6669 6c65 7320 7375 6368 2061 7320 f files such as │ │ │ │ │ -0002aa60: 6c69 6e6b 6572 2073 6372 6970 7473 2c20 linker scripts, │ │ │ │ │ -0002aa70: 6275 740a 5f6c 6973 7469 6e67 2061 2073 but._listing a s │ │ │ │ │ -0002aa80: 6f75 7263 6520 6669 6c65 2069 6e20 275f ource file in '_ │ │ │ │ │ -0002aa90: 4445 5045 4e44 454e 4349 4553 2720 6973 DEPENDENCIES' is │ │ │ │ │ -0002aaa0: 2077 726f 6e67 5f2e 2020 4966 2073 6f6d wrong_. If som │ │ │ │ │ -0002aab0: 6520 736f 7572 6365 0a66 696c 6520 6e65 e source.file ne │ │ │ │ │ -0002aac0: 6564 7320 746f 2062 6520 6275 696c 7420 eds to be built │ │ │ │ │ -0002aad0: 6265 666f 7265 2061 6c6c 2074 6865 2063 before all the c │ │ │ │ │ -0002aae0: 6f6d 706f 6e65 6e74 7320 6f66 2061 2070 omponents of a p │ │ │ │ │ -0002aaf0: 726f 6772 616d 2061 7265 2062 7569 6c74 rogram are built │ │ │ │ │ -0002ab00: 2c0a 636f 6e73 6964 6572 2075 7369 6e67 ,.consider using │ │ │ │ │ -0002ab10: 2074 6865 2027 4255 494c 545f 534f 5552 the 'BUILT_SOUR │ │ │ │ │ -0002ab20: 4345 5327 2076 6172 6961 626c 6520 696e CES' variable in │ │ │ │ │ -0002ab30: 7374 6561 6420 282a 6e6f 7465 2053 6f75 stead (*note Sou │ │ │ │ │ -0002ab40: 7263 6573 3a3a 292e 0a0a 2020 2049 6620 rces::)... If │ │ │ │ │ -0002ab50: 2750 524f 475f 4445 5045 4e44 454e 4349 'PROG_DEPENDENCI │ │ │ │ │ -0002ab60: 4553 2720 6973 206e 6f74 2073 7570 706c ES' is not suppl │ │ │ │ │ -0002ab70: 6965 642c 2069 7420 6973 2063 6f6d 7075 ied, it is compu │ │ │ │ │ -0002ab80: 7465 6420 6279 2041 7574 6f6d 616b 652e ted by Automake. │ │ │ │ │ -0002ab90: 0a54 6865 2061 7574 6f6d 6174 6963 616c .The automatical │ │ │ │ │ -0002aba0: 6c79 2d61 7373 6967 6e65 6420 7661 6c75 ly-assigned valu │ │ │ │ │ -0002abb0: 6520 6973 2074 6865 2063 6f6e 7465 6e74 e is the content │ │ │ │ │ -0002abc0: 7320 6f66 2027 5052 4f47 5f4c 4441 4444 s of 'PROG_LDADD │ │ │ │ │ -0002abd0: 272c 2077 6974 680a 6d6f 7374 2063 6f6e ', with.most con │ │ │ │ │ -0002abe0: 6669 6775 7265 2073 7562 7374 6974 7574 figure substitut │ │ │ │ │ -0002abf0: 696f 6e73 2c20 272d 6c27 2c20 272d 4c27 ions, '-l', '-L' │ │ │ │ │ -0002ac00: 2c20 272d 646c 6f70 656e 2720 616e 6420 , '-dlopen' and │ │ │ │ │ -0002ac10: 272d 646c 7072 656f 7065 6e27 0a6f 7074 '-dlpreopen'.opt │ │ │ │ │ -0002ac20: 696f 6e73 2072 656d 6f76 6564 2e20 2054 ions removed. T │ │ │ │ │ -0002ac30: 6865 2063 6f6e 6669 6775 7265 2073 7562 he configure sub │ │ │ │ │ -0002ac40: 7374 6974 7574 696f 6e73 2074 6861 7420 stitutions that │ │ │ │ │ -0002ac50: 6172 6520 6c65 6674 2069 6e20 6172 6520 are left in are │ │ │ │ │ -0002ac60: 6f6e 6c79 0a27 2428 4c49 424f 424a 5329 only.'$(LIBOBJS) │ │ │ │ │ -0002ac70: 2720 616e 6420 2724 2841 4c4c 4f43 4129 ' and '$(ALLOCA) │ │ │ │ │ -0002ac80: 273b 2074 6865 7365 2061 7265 206c 6566 '; these are lef │ │ │ │ │ -0002ac90: 7420 6265 6361 7573 6520 6974 2069 7320 t because it is │ │ │ │ │ -0002aca0: 6b6e 6f77 6e20 7468 6174 0a74 6865 7920 known that.they │ │ │ │ │ -0002acb0: 7769 6c6c 206e 6f74 2063 6175 7365 2061 will not cause a │ │ │ │ │ -0002acc0: 6e20 696e 7661 6c69 6420 7661 6c75 6520 n invalid value │ │ │ │ │ -0002acd0: 666f 7220 2750 524f 475f 4445 5045 4e44 for 'PROG_DEPEND │ │ │ │ │ -0002ace0: 454e 4349 4553 2720 746f 2062 650a 6765 ENCIES' to be.ge │ │ │ │ │ -0002acf0: 6e65 7261 7465 642e 0a0a 2020 202a 6e6f nerated... *no │ │ │ │ │ -0002ad00: 7465 2043 6f6e 6469 7469 6f6e 616c 2053 te Conditional S │ │ │ │ │ -0002ad10: 6f75 7263 6573 3a3a 2073 686f 7773 2061 ources:: shows a │ │ │ │ │ -0002ad20: 2073 6974 7561 7469 6f6e 2077 6865 7265 situation where │ │ │ │ │ -0002ad30: 2027 5f44 4550 454e 4445 4e43 4945 5327 '_DEPENDENCIES' │ │ │ │ │ -0002ad40: 0a6d 6179 2062 6520 7573 6564 2e0a 0a20 .may be used... │ │ │ │ │ -0002ad50: 2020 5468 6520 2745 5854 5241 5f50 524f The 'EXTRA_PRO │ │ │ │ │ -0002ad60: 475f 4445 5045 4e44 454e 4349 4553 2720 G_DEPENDENCIES' │ │ │ │ │ -0002ad70: 6d61 7920 6265 2075 7365 6675 6c20 666f may be useful fo │ │ │ │ │ -0002ad80: 7220 6361 7365 7320 7768 6572 6520 796f r cases where yo │ │ │ │ │ -0002ad90: 750a 6d65 7265 6c79 2077 616e 7420 746f u.merely want to │ │ │ │ │ -0002ada0: 2061 7567 6d65 6e74 2074 6865 2027 6175 augment the 'au │ │ │ │ │ -0002adb0: 746f 6d61 6b65 272d 6765 6e65 7261 7465 tomake'-generate │ │ │ │ │ -0002adc0: 6420 2750 524f 475f 4445 5045 4e44 454e d 'PROG_DEPENDEN │ │ │ │ │ -0002add0: 4349 4553 270a 7261 7468 6572 2074 6861 CIES'.rather tha │ │ │ │ │ -0002ade0: 6e20 7265 706c 6163 696e 6720 6974 2e0a n replacing it.. │ │ │ │ │ -0002adf0: 0a20 2020 5765 2072 6563 6f6d 6d65 6e64 . We recommend │ │ │ │ │ -0002ae00: 2074 6861 7420 796f 7520 6176 6f69 6420 that you avoid │ │ │ │ │ -0002ae10: 7573 696e 6720 272d 6c27 206f 7074 696f using '-l' optio │ │ │ │ │ -0002ae20: 6e73 2069 6e20 274c 4441 4444 2720 6f72 ns in 'LDADD' or │ │ │ │ │ -0002ae30: 0a27 5052 4f47 5f4c 4441 4444 2720 7768 .'PROG_LDADD' wh │ │ │ │ │ -0002ae40: 656e 2072 6566 6572 7269 6e67 2074 6f20 en referring to │ │ │ │ │ -0002ae50: 6c69 6272 6172 6965 7320 6275 696c 7420 libraries built │ │ │ │ │ -0002ae60: 6279 2079 6f75 7220 7061 636b 6167 652e by your package. │ │ │ │ │ -0002ae70: 0a49 6e73 7465 6164 2c20 7772 6974 6520 .Instead, write │ │ │ │ │ -0002ae80: 7468 6520 6669 6c65 206e 616d 6520 6f66 the file name of │ │ │ │ │ -0002ae90: 2074 6865 206c 6962 7261 7279 2065 7870 the library exp │ │ │ │ │ -0002aea0: 6c69 6369 746c 7920 6173 2069 6e20 7468 licitly as in th │ │ │ │ │ -0002aeb0: 6520 6162 6f76 650a 2763 7069 6f27 2065 e above.'cpio' e │ │ │ │ │ -0002aec0: 7861 6d70 6c65 2e20 2055 7365 2027 2d6c xample. Use '-l │ │ │ │ │ -0002aed0: 2720 6f6e 6c79 2074 6f20 6c69 7374 2074 ' only to list t │ │ │ │ │ -0002aee0: 6869 7264 2d70 6172 7479 206c 6962 7261 hird-party libra │ │ │ │ │ -0002aef0: 7269 6573 2e20 2049 6620 796f 750a 666f ries. If you.fo │ │ │ │ │ -0002af00: 6c6c 6f77 2074 6869 7320 7275 6c65 2c20 llow this rule, │ │ │ │ │ -0002af10: 7468 6520 6465 6661 756c 7420 7661 6c75 the default valu │ │ │ │ │ -0002af20: 6520 6f66 2027 5052 4f47 5f44 4550 454e e of 'PROG_DEPEN │ │ │ │ │ -0002af30: 4445 4e43 4945 5327 2077 696c 6c20 6c69 DENCIES' will li │ │ │ │ │ -0002af40: 7374 2061 6c6c 0a79 6f75 7220 6c6f 6361 st all.your loca │ │ │ │ │ -0002af50: 6c20 6c69 6272 6172 6965 7320 616e 6420 l libraries and │ │ │ │ │ -0002af60: 6f6d 6974 2074 6865 206f 7468 6572 206f omit the other o │ │ │ │ │ -0002af70: 6e65 732e 0a0a 1f0a 4669 6c65 3a20 6175 nes.....File: au │ │ │ │ │ -0002af80: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -0002af90: 2c20 204e 6f64 653a 2043 6f6e 6469 7469 , Node: Conditi │ │ │ │ │ -0002afa0: 6f6e 616c 2053 6f75 7263 6573 2c20 204e onal Sources, N │ │ │ │ │ -0002afb0: 6578 743a 2043 6f6e 6469 7469 6f6e 616c ext: Conditional │ │ │ │ │ -0002afc0: 2050 726f 6772 616d 732c 2020 5072 6576 Programs, Prev │ │ │ │ │ -0002afd0: 3a20 4c69 6e6b 696e 672c 2020 5570 3a20 : Linking, Up: │ │ │ │ │ -0002afe0: 4120 5072 6f67 7261 6d0a 0a38 2e31 2e33 A Program..8.1.3 │ │ │ │ │ -0002aff0: 2043 6f6e 6469 7469 6f6e 616c 2063 6f6d Conditional com │ │ │ │ │ -0002b000: 7069 6c61 7469 6f6e 206f 6620 736f 7572 pilation of sour │ │ │ │ │ -0002b010: 6365 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ces.------------ │ │ │ │ │ +0002a290: 2d2d 2d2d 2d2d 2d0a 0a49 6620 796f 7520 -------..If you │ │ │ │ │ +0002a2a0: 6e65 6564 2074 6f20 6c69 6e6b 2061 6761 need to link aga │ │ │ │ │ +0002a2b0: 696e 7374 206c 6962 7261 7269 6573 2074 inst libraries t │ │ │ │ │ +0002a2c0: 6861 7420 6172 6520 6e6f 7420 666f 756e hat are not foun │ │ │ │ │ +0002a2d0: 6420 6279 2027 636f 6e66 6967 7572 6527 d by 'configure' │ │ │ │ │ +0002a2e0: 2c0a 796f 7520 6361 6e20 7573 6520 274c ,.you can use 'L │ │ │ │ │ +0002a2f0: 4441 4444 2720 746f 2064 6f20 736f 2e20 DADD' to do so. │ │ │ │ │ +0002a300: 2054 6869 7320 7661 7269 6162 6c65 2069 This variable i │ │ │ │ │ +0002a310: 7320 7573 6564 2074 6f20 7370 6563 6966 s used to specif │ │ │ │ │ +0002a320: 790a 6164 6469 7469 6f6e 616c 206f 626a y.additional obj │ │ │ │ │ +0002a330: 6563 7473 206f 7220 6c69 6272 6172 6965 ects or librarie │ │ │ │ │ +0002a340: 7320 746f 206c 696e 6b20 7769 7468 3b20 s to link with; │ │ │ │ │ +0002a350: 6974 2069 7320 696e 6170 7072 6f70 7269 it is inappropri │ │ │ │ │ +0002a360: 6174 6520 666f 720a 7370 6563 6966 7969 ate for.specifyi │ │ │ │ │ +0002a370: 6e67 2073 7065 6369 6669 6320 6c69 6e6b ng specific link │ │ │ │ │ +0002a380: 6572 2066 6c61 6773 2c20 796f 7520 7368 er flags, you sh │ │ │ │ │ +0002a390: 6f75 6c64 2075 7365 2027 414d 5f4c 4446 ould use 'AM_LDF │ │ │ │ │ +0002a3a0: 4c41 4753 2720 666f 7220 7468 6973 0a70 LAGS' for this.p │ │ │ │ │ +0002a3b0: 7572 706f 7365 2e0a 0a20 2020 536f 6d65 urpose... Some │ │ │ │ │ +0002a3c0: 7469 6d65 732c 206d 756c 7469 706c 6520 times, multiple │ │ │ │ │ +0002a3d0: 7072 6f67 7261 6d73 2061 7265 2062 7569 programs are bui │ │ │ │ │ +0002a3e0: 6c74 2069 6e20 6f6e 6520 6469 7265 6374 lt in one direct │ │ │ │ │ +0002a3f0: 6f72 7920 6275 7420 646f 206e 6f74 0a73 ory but do not.s │ │ │ │ │ +0002a400: 6861 7265 2074 6865 2073 616d 6520 6c69 hare the same li │ │ │ │ │ +0002a410: 6e6b 2d74 696d 6520 7265 7175 6972 656d nk-time requirem │ │ │ │ │ +0002a420: 656e 7473 2e20 2049 6e20 7468 6973 2063 ents. In this c │ │ │ │ │ +0002a430: 6173 652c 2079 6f75 2063 616e 2075 7365 ase, you can use │ │ │ │ │ +0002a440: 2074 6865 0a27 5052 4f47 5f4c 4441 4444 the.'PROG_LDADD │ │ │ │ │ +0002a450: 2720 7661 7269 6162 6c65 2028 7768 6572 ' variable (wher │ │ │ │ │ +0002a460: 6520 5052 4f47 2069 7320 7468 6520 6e61 e PROG is the na │ │ │ │ │ +0002a470: 6d65 206f 6620 7468 6520 7072 6f67 7261 me of the progra │ │ │ │ │ +0002a480: 6d20 6173 2069 740a 6170 7065 6172 7320 m as it.appears │ │ │ │ │ +0002a490: 696e 2073 6f6d 6520 275f 5052 4f47 5241 in some '_PROGRA │ │ │ │ │ +0002a4a0: 4d53 2720 7661 7269 6162 6c65 2c20 616e MS' variable, an │ │ │ │ │ +0002a4b0: 6420 7573 7561 6c6c 7920 7772 6974 7465 d usually writte │ │ │ │ │ +0002a4c0: 6e20 696e 206c 6f77 6572 6361 7365 290a n in lowercase). │ │ │ │ │ +0002a4d0: 746f 206f 7665 7272 6964 6520 274c 4441 to override 'LDA │ │ │ │ │ +0002a4e0: 4444 272e 2020 4966 2074 6869 7320 7661 DD'. If this va │ │ │ │ │ +0002a4f0: 7269 6162 6c65 2065 7869 7374 7320 666f riable exists fo │ │ │ │ │ +0002a500: 7220 6120 6769 7665 6e20 7072 6f67 7261 r a given progra │ │ │ │ │ +0002a510: 6d2c 2074 6865 6e0a 7468 6174 2070 726f m, then.that pro │ │ │ │ │ +0002a520: 6772 616d 2069 7320 6e6f 7420 6c69 6e6b gram is not link │ │ │ │ │ +0002a530: 6564 2075 7369 6e67 2027 4c44 4144 4427 ed using 'LDADD' │ │ │ │ │ +0002a540: 2e0a 0a20 2020 466f 7220 696e 7374 616e ... For instan │ │ │ │ │ +0002a550: 6365 2c20 696e 2047 4e55 2063 7069 6f2c ce, in GNU cpio, │ │ │ │ │ +0002a560: 2027 7061 7827 2c20 2763 7069 6f27 2061 'pax', 'cpio' a │ │ │ │ │ +0002a570: 6e64 2027 6d74 2720 6172 6520 6c69 6e6b nd 'mt' are link │ │ │ │ │ +0002a580: 6564 2061 6761 696e 7374 0a74 6865 206c ed against.the l │ │ │ │ │ +0002a590: 6962 7261 7279 2027 6c69 6263 7069 6f2e ibrary 'libcpio. │ │ │ │ │ +0002a5a0: 6127 2e20 2048 6f77 6576 6572 2c20 2772 a'. However, 'r │ │ │ │ │ +0002a5b0: 6d74 2720 6973 2062 7569 6c74 2069 6e20 mt' is built in │ │ │ │ │ +0002a5c0: 7468 6520 7361 6d65 2064 6972 6563 746f the same directo │ │ │ │ │ +0002a5d0: 7279 2c0a 616e 6420 6861 7320 6e6f 2073 ry,.and has no s │ │ │ │ │ +0002a5e0: 7563 6820 6c69 6e6b 2072 6571 7569 7265 uch link require │ │ │ │ │ +0002a5f0: 6d65 6e74 2e20 2041 6c73 6f2c 2027 6d74 ment. Also, 'mt │ │ │ │ │ +0002a600: 2720 616e 6420 2772 6d74 2720 6172 6520 ' and 'rmt' are │ │ │ │ │ +0002a610: 6f6e 6c79 2062 7569 6c74 0a6f 6e20 6365 only built.on ce │ │ │ │ │ +0002a620: 7274 6169 6e20 6172 6368 6974 6563 7475 rtain architectu │ │ │ │ │ +0002a630: 7265 732e 2020 4865 7265 2069 7320 7768 res. Here is wh │ │ │ │ │ +0002a640: 6174 2063 7069 6f27 7320 2773 7263 2f4d at cpio's 'src/M │ │ │ │ │ +0002a650: 616b 6566 696c 652e 616d 2720 6c6f 6f6b akefile.am' look │ │ │ │ │ +0002a660: 730a 6c69 6b65 2028 6162 7269 6467 6564 s.like (abridged │ │ │ │ │ +0002a670: 293a 0a0a 2020 2020 2062 696e 5f50 524f ):.. bin_PRO │ │ │ │ │ +0002a680: 4752 414d 5320 3d20 6370 696f 2070 6178 GRAMS = cpio pax │ │ │ │ │ +0002a690: 2024 284d 5429 0a20 2020 2020 6c69 6265 $(MT). libe │ │ │ │ │ +0002a6a0: 7865 635f 5052 4f47 5241 4d53 203d 2024 xec_PROGRAMS = $ │ │ │ │ │ +0002a6b0: 2852 4d54 290a 2020 2020 2045 5854 5241 (RMT). EXTRA │ │ │ │ │ +0002a6c0: 5f50 524f 4752 414d 5320 3d20 6d74 2072 _PROGRAMS = mt r │ │ │ │ │ +0002a6d0: 6d74 0a0a 2020 2020 204c 4441 4444 203d mt.. LDADD = │ │ │ │ │ +0002a6e0: 202e 2e2f 6c69 622f 6c69 6263 7069 6f2e ../lib/libcpio. │ │ │ │ │ +0002a6f0: 6120 2428 494e 544c 4c49 4253 290a 2020 a $(INTLLIBS). │ │ │ │ │ +0002a700: 2020 2072 6d74 5f4c 4441 4444 203d 0a0a rmt_LDADD =.. │ │ │ │ │ +0002a710: 2020 2020 2063 7069 6f5f 534f 5552 4345 cpio_SOURCE │ │ │ │ │ +0002a720: 5320 3d20 2e2e 2e0a 2020 2020 2070 6178 S = .... pax │ │ │ │ │ +0002a730: 5f53 4f55 5243 4553 203d 202e 2e2e 0a20 _SOURCES = .... │ │ │ │ │ +0002a740: 2020 2020 6d74 5f53 4f55 5243 4553 203d mt_SOURCES = │ │ │ │ │ +0002a750: 202e 2e2e 0a20 2020 2020 726d 745f 534f .... rmt_SO │ │ │ │ │ +0002a760: 5552 4345 5320 3d20 2e2e 2e0a 0a20 2020 URCES = ..... │ │ │ │ │ +0002a770: 2750 524f 475f 4c44 4144 4427 2069 7320 'PROG_LDADD' is │ │ │ │ │ +0002a780: 696e 6170 7072 6f70 7269 6174 6520 666f inappropriate fo │ │ │ │ │ +0002a790: 7220 7061 7373 696e 6720 7072 6f67 7261 r passing progra │ │ │ │ │ +0002a7a0: 6d2d 7370 6563 6966 6963 206c 696e 6b65 m-specific linke │ │ │ │ │ +0002a7b0: 720a 666c 6167 7320 2865 7863 6570 7420 r.flags (except │ │ │ │ │ +0002a7c0: 666f 7220 272d 6c27 2c20 272d 4c27 2c20 for '-l', '-L', │ │ │ │ │ +0002a7d0: 272d 646c 6f70 656e 2720 616e 6420 272d '-dlopen' and '- │ │ │ │ │ +0002a7e0: 646c 7072 656f 7065 6e27 292e 2020 536f dlpreopen'). So │ │ │ │ │ +0002a7f0: 2c20 7573 6520 7468 650a 2750 524f 475f , use the.'PROG_ │ │ │ │ │ +0002a800: 4c44 464c 4147 5327 2076 6172 6961 626c LDFLAGS' variabl │ │ │ │ │ +0002a810: 6520 666f 7220 7468 6973 2070 7572 706f e for this purpo │ │ │ │ │ +0002a820: 7365 2e0a 0a20 2020 4974 2069 7320 616c se... It is al │ │ │ │ │ +0002a830: 736f 206f 6363 6173 696f 6e61 6c6c 7920 so occasionally │ │ │ │ │ +0002a840: 7573 6566 756c 2074 6f20 6861 7665 2061 useful to have a │ │ │ │ │ +0002a850: 2070 726f 6772 616d 2064 6570 656e 6420 program depend │ │ │ │ │ +0002a860: 6f6e 2073 6f6d 6520 6f74 6865 720a 7461 on some other.ta │ │ │ │ │ +0002a870: 7267 6574 2074 6861 7420 6973 206e 6f74 rget that is not │ │ │ │ │ +0002a880: 2061 6374 7561 6c6c 7920 7061 7274 206f actually part o │ │ │ │ │ +0002a890: 6620 7468 6174 2070 726f 6772 616d 2e20 f that program. │ │ │ │ │ +0002a8a0: 2054 6869 7320 6361 6e20 6265 2064 6f6e This can be don │ │ │ │ │ +0002a8b0: 650a 7573 696e 6720 6569 7468 6572 2074 e.using either t │ │ │ │ │ +0002a8c0: 6865 2027 5052 4f47 5f44 4550 454e 4445 he 'PROG_DEPENDE │ │ │ │ │ +0002a8d0: 4e43 4945 5327 206f 7220 7468 6520 2745 NCIES' or the 'E │ │ │ │ │ +0002a8e0: 5854 5241 5f50 524f 475f 4445 5045 4e44 XTRA_PROG_DEPEND │ │ │ │ │ +0002a8f0: 454e 4349 4553 270a 7661 7269 6162 6c65 ENCIES'.variable │ │ │ │ │ +0002a900: 2e20 2045 6163 6820 7072 6f67 7261 6d20 . Each program │ │ │ │ │ +0002a910: 6465 7065 6e64 7320 6f6e 2074 6865 2063 depends on the c │ │ │ │ │ +0002a920: 6f6e 7465 6e74 7320 626f 7468 2076 6172 ontents both var │ │ │ │ │ +0002a930: 6961 626c 6573 2c20 6275 7420 6e6f 0a66 iables, but no.f │ │ │ │ │ +0002a940: 7572 7468 6572 2069 6e74 6572 7072 6574 urther interpret │ │ │ │ │ +0002a950: 6174 696f 6e20 6973 2064 6f6e 652e 0a0a ation is done... │ │ │ │ │ +0002a960: 2020 2053 696e 6365 2074 6865 7365 2064 Since these d │ │ │ │ │ +0002a970: 6570 656e 6465 6e63 6965 7320 6172 6520 ependencies are │ │ │ │ │ +0002a980: 6173 736f 6369 6174 6564 2074 6f20 7468 associated to th │ │ │ │ │ +0002a990: 6520 6c69 6e6b 2072 756c 6520 7573 6564 e link rule used │ │ │ │ │ +0002a9a0: 2074 6f0a 6372 6561 7465 2074 6865 2070 to.create the p │ │ │ │ │ +0002a9b0: 726f 6772 616d 7320 7468 6579 2073 686f rograms they sho │ │ │ │ │ +0002a9c0: 756c 6420 6e6f 726d 616c 6c79 206c 6973 uld normally lis │ │ │ │ │ +0002a9d0: 7420 6669 6c65 7320 7573 6564 2062 7920 t files used by │ │ │ │ │ +0002a9e0: 7468 6520 6c69 6e6b 0a63 6f6d 6d61 6e64 the link.command │ │ │ │ │ +0002a9f0: 2e20 2054 6861 7420 6973 2027 2a2e 2428 . That is '*.$( │ │ │ │ │ +0002aa00: 4f42 4a45 5854 2927 2c20 272a 2e61 272c OBJEXT)', '*.a', │ │ │ │ │ +0002aa10: 206f 7220 272a 2e6c 6127 2066 696c 6573 or '*.la' files │ │ │ │ │ +0002aa20: 2e20 2049 6e20 7261 7265 2063 6173 6573 . In rare cases │ │ │ │ │ +0002aa30: 0a79 6f75 206d 6179 206e 6565 6420 746f .you may need to │ │ │ │ │ +0002aa40: 2061 6464 206f 7468 6572 206b 696e 6473 add other kinds │ │ │ │ │ +0002aa50: 206f 6620 6669 6c65 7320 7375 6368 2061 of files such a │ │ │ │ │ +0002aa60: 7320 6c69 6e6b 6572 2073 6372 6970 7473 s linker scripts │ │ │ │ │ +0002aa70: 2c20 6275 740a 5f6c 6973 7469 6e67 2061 , but._listing a │ │ │ │ │ +0002aa80: 2073 6f75 7263 6520 6669 6c65 2069 6e20 source file in │ │ │ │ │ +0002aa90: 275f 4445 5045 4e44 454e 4349 4553 2720 '_DEPENDENCIES' │ │ │ │ │ +0002aaa0: 6973 2077 726f 6e67 5f2e 2020 4966 2073 is wrong_. If s │ │ │ │ │ +0002aab0: 6f6d 6520 736f 7572 6365 0a66 696c 6520 ome source.file │ │ │ │ │ +0002aac0: 6e65 6564 7320 746f 2062 6520 6275 696c needs to be buil │ │ │ │ │ +0002aad0: 7420 6265 666f 7265 2061 6c6c 2074 6865 t before all the │ │ │ │ │ +0002aae0: 2063 6f6d 706f 6e65 6e74 7320 6f66 2061 components of a │ │ │ │ │ +0002aaf0: 2070 726f 6772 616d 2061 7265 2062 7569 program are bui │ │ │ │ │ +0002ab00: 6c74 2c0a 636f 6e73 6964 6572 2075 7369 lt,.consider usi │ │ │ │ │ +0002ab10: 6e67 2074 6865 2027 4255 494c 545f 534f ng the 'BUILT_SO │ │ │ │ │ +0002ab20: 5552 4345 5327 2076 6172 6961 626c 6520 URCES' variable │ │ │ │ │ +0002ab30: 696e 7374 6561 6420 282a 6e6f 7465 2053 instead (*note S │ │ │ │ │ +0002ab40: 6f75 7263 6573 3a3a 292e 0a0a 2020 2049 ources::)... I │ │ │ │ │ +0002ab50: 6620 2750 524f 475f 4445 5045 4e44 454e f 'PROG_DEPENDEN │ │ │ │ │ +0002ab60: 4349 4553 2720 6973 206e 6f74 2073 7570 CIES' is not sup │ │ │ │ │ +0002ab70: 706c 6965 642c 2069 7420 6973 2063 6f6d plied, it is com │ │ │ │ │ +0002ab80: 7075 7465 6420 6279 2041 7574 6f6d 616b puted by Automak │ │ │ │ │ +0002ab90: 652e 0a54 6865 2061 7574 6f6d 6174 6963 e..The automatic │ │ │ │ │ +0002aba0: 616c 6c79 2d61 7373 6967 6e65 6420 7661 ally-assigned va │ │ │ │ │ +0002abb0: 6c75 6520 6973 2074 6865 2063 6f6e 7465 lue is the conte │ │ │ │ │ +0002abc0: 6e74 7320 6f66 2027 5052 4f47 5f4c 4441 nts of 'PROG_LDA │ │ │ │ │ +0002abd0: 4444 272c 2077 6974 680a 6d6f 7374 2063 DD', with.most c │ │ │ │ │ +0002abe0: 6f6e 6669 6775 7265 2073 7562 7374 6974 onfigure substit │ │ │ │ │ +0002abf0: 7574 696f 6e73 2c20 272d 6c27 2c20 272d utions, '-l', '- │ │ │ │ │ +0002ac00: 4c27 2c20 272d 646c 6f70 656e 2720 616e L', '-dlopen' an │ │ │ │ │ +0002ac10: 6420 272d 646c 7072 656f 7065 6e27 0a6f d '-dlpreopen'.o │ │ │ │ │ +0002ac20: 7074 696f 6e73 2072 656d 6f76 6564 2e20 ptions removed. │ │ │ │ │ +0002ac30: 2054 6865 2063 6f6e 6669 6775 7265 2073 The configure s │ │ │ │ │ +0002ac40: 7562 7374 6974 7574 696f 6e73 2074 6861 ubstitutions tha │ │ │ │ │ +0002ac50: 7420 6172 6520 6c65 6674 2069 6e20 6172 t are left in ar │ │ │ │ │ +0002ac60: 6520 6f6e 6c79 0a27 2428 4c49 424f 424a e only.'$(LIBOBJ │ │ │ │ │ +0002ac70: 5329 2720 616e 6420 2724 2841 4c4c 4f43 S)' and '$(ALLOC │ │ │ │ │ +0002ac80: 4129 273b 2074 6865 7365 2061 7265 206c A)'; these are l │ │ │ │ │ +0002ac90: 6566 7420 6265 6361 7573 6520 6974 2069 eft because it i │ │ │ │ │ +0002aca0: 7320 6b6e 6f77 6e20 7468 6174 0a74 6865 s known that.the │ │ │ │ │ +0002acb0: 7920 7769 6c6c 206e 6f74 2063 6175 7365 y will not cause │ │ │ │ │ +0002acc0: 2061 6e20 696e 7661 6c69 6420 7661 6c75 an invalid valu │ │ │ │ │ +0002acd0: 6520 666f 7220 2750 524f 475f 4445 5045 e for 'PROG_DEPE │ │ │ │ │ +0002ace0: 4e44 454e 4349 4553 2720 746f 2062 650a NDENCIES' to be. │ │ │ │ │ +0002acf0: 6765 6e65 7261 7465 642e 0a0a 2020 202a generated... * │ │ │ │ │ +0002ad00: 6e6f 7465 2043 6f6e 6469 7469 6f6e 616c note Conditional │ │ │ │ │ +0002ad10: 2053 6f75 7263 6573 3a3a 2073 686f 7773 Sources:: shows │ │ │ │ │ +0002ad20: 2061 2073 6974 7561 7469 6f6e 2077 6865 a situation whe │ │ │ │ │ +0002ad30: 7265 2027 5f44 4550 454e 4445 4e43 4945 re '_DEPENDENCIE │ │ │ │ │ +0002ad40: 5327 0a6d 6179 2062 6520 7573 6564 2e0a S'.may be used.. │ │ │ │ │ +0002ad50: 0a20 2020 5468 6520 2745 5854 5241 5f50 . The 'EXTRA_P │ │ │ │ │ +0002ad60: 524f 475f 4445 5045 4e44 454e 4349 4553 ROG_DEPENDENCIES │ │ │ │ │ +0002ad70: 2720 6d61 7920 6265 2075 7365 6675 6c20 ' may be useful │ │ │ │ │ +0002ad80: 666f 7220 6361 7365 7320 7768 6572 6520 for cases where │ │ │ │ │ +0002ad90: 796f 750a 6d65 7265 6c79 2077 616e 7420 you.merely want │ │ │ │ │ +0002ada0: 746f 2061 7567 6d65 6e74 2074 6865 2027 to augment the ' │ │ │ │ │ +0002adb0: 6175 746f 6d61 6b65 272d 6765 6e65 7261 automake'-genera │ │ │ │ │ +0002adc0: 7465 6420 2750 524f 475f 4445 5045 4e44 ted 'PROG_DEPEND │ │ │ │ │ +0002add0: 454e 4349 4553 270a 7261 7468 6572 2074 ENCIES'.rather t │ │ │ │ │ +0002ade0: 6861 6e20 7265 706c 6163 696e 6720 6974 han replacing it │ │ │ │ │ +0002adf0: 2e0a 0a20 2020 5765 2072 6563 6f6d 6d65 ... We recomme │ │ │ │ │ +0002ae00: 6e64 2074 6861 7420 796f 7520 6176 6f69 nd that you avoi │ │ │ │ │ +0002ae10: 6420 7573 696e 6720 272d 6c27 206f 7074 d using '-l' opt │ │ │ │ │ +0002ae20: 696f 6e73 2069 6e20 274c 4441 4444 2720 ions in 'LDADD' │ │ │ │ │ +0002ae30: 6f72 0a27 5052 4f47 5f4c 4441 4444 2720 or.'PROG_LDADD' │ │ │ │ │ +0002ae40: 7768 656e 2072 6566 6572 7269 6e67 2074 when referring t │ │ │ │ │ +0002ae50: 6f20 6c69 6272 6172 6965 7320 6275 696c o libraries buil │ │ │ │ │ +0002ae60: 7420 6279 2079 6f75 7220 7061 636b 6167 t by your packag │ │ │ │ │ +0002ae70: 652e 0a49 6e73 7465 6164 2c20 7772 6974 e..Instead, writ │ │ │ │ │ +0002ae80: 6520 7468 6520 6669 6c65 206e 616d 6520 e the file name │ │ │ │ │ +0002ae90: 6f66 2074 6865 206c 6962 7261 7279 2065 of the library e │ │ │ │ │ +0002aea0: 7870 6c69 6369 746c 7920 6173 2069 6e20 xplicitly as in │ │ │ │ │ +0002aeb0: 7468 6520 6162 6f76 650a 2763 7069 6f27 the above.'cpio' │ │ │ │ │ +0002aec0: 2065 7861 6d70 6c65 2e20 2055 7365 2027 example. Use ' │ │ │ │ │ +0002aed0: 2d6c 2720 6f6e 6c79 2074 6f20 6c69 7374 -l' only to list │ │ │ │ │ +0002aee0: 2074 6869 7264 2d70 6172 7479 206c 6962 third-party lib │ │ │ │ │ +0002aef0: 7261 7269 6573 2e20 2049 6620 796f 750a raries. If you. │ │ │ │ │ +0002af00: 666f 6c6c 6f77 2074 6869 7320 7275 6c65 follow this rule │ │ │ │ │ +0002af10: 2c20 7468 6520 6465 6661 756c 7420 7661 , the default va │ │ │ │ │ +0002af20: 6c75 6520 6f66 2027 5052 4f47 5f44 4550 lue of 'PROG_DEP │ │ │ │ │ +0002af30: 454e 4445 4e43 4945 5327 2077 696c 6c20 ENDENCIES' will │ │ │ │ │ +0002af40: 6c69 7374 2061 6c6c 0a79 6f75 7220 6c6f list all.your lo │ │ │ │ │ +0002af50: 6361 6c20 6c69 6272 6172 6965 7320 616e cal libraries an │ │ │ │ │ +0002af60: 6420 6f6d 6974 2074 6865 206f 7468 6572 d omit the other │ │ │ │ │ +0002af70: 206f 6e65 732e 0a0a 1f0a 4669 6c65 3a20 ones.....File: │ │ │ │ │ +0002af80: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +0002af90: 666f 2c20 204e 6f64 653a 2043 6f6e 6469 fo, Node: Condi │ │ │ │ │ +0002afa0: 7469 6f6e 616c 2053 6f75 7263 6573 2c20 tional Sources, │ │ │ │ │ +0002afb0: 204e 6578 743a 2043 6f6e 6469 7469 6f6e Next: Condition │ │ │ │ │ +0002afc0: 616c 2050 726f 6772 616d 732c 2020 5072 al Programs, Pr │ │ │ │ │ +0002afd0: 6576 3a20 4c69 6e6b 696e 672c 2020 5570 ev: Linking, Up │ │ │ │ │ +0002afe0: 3a20 4120 5072 6f67 7261 6d0a 0a38 2e31 : A Program..8.1 │ │ │ │ │ +0002aff0: 2e33 2043 6f6e 6469 7469 6f6e 616c 2063 .3 Conditional c │ │ │ │ │ +0002b000: 6f6d 7069 6c61 7469 6f6e 206f 6620 736f ompilation of so │ │ │ │ │ +0002b010: 7572 6365 730a 2d2d 2d2d 2d2d 2d2d 2d2d urces.---------- │ │ │ │ │ 0002b020: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002b030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 596f ------------..Yo │ │ │ │ │ -0002b040: 7520 6361 6e27 7420 7075 7420 6120 636f u can't put a co │ │ │ │ │ -0002b050: 6e66 6967 7572 6520 7375 6273 7469 7475 nfigure substitu │ │ │ │ │ -0002b060: 7469 6f6e 2028 652e 672e 2c20 2740 464f tion (e.g., '@FO │ │ │ │ │ -0002b070: 4f40 2720 6f72 2027 2428 464f 4f29 2720 O@' or '$(FOO)' │ │ │ │ │ -0002b080: 7768 6572 650a 2746 4f4f 2720 6973 2064 where.'FOO' is d │ │ │ │ │ -0002b090: 6566 696e 6564 2076 6961 2027 4143 5f53 efined via 'AC_S │ │ │ │ │ -0002b0a0: 5542 5354 2729 2069 6e74 6f20 6120 275f UBST') into a '_ │ │ │ │ │ -0002b0b0: 534f 5552 4345 5327 2076 6172 6961 626c SOURCES' variabl │ │ │ │ │ -0002b0c0: 652e 2020 5468 6520 7265 6173 6f6e 0a66 e. The reason.f │ │ │ │ │ -0002b0d0: 6f72 2074 6869 7320 6973 2061 2062 6974 or this is a bit │ │ │ │ │ -0002b0e0: 2068 6172 6420 746f 2065 7870 6c61 696e hard to explain │ │ │ │ │ -0002b0f0: 2c20 6275 7420 7375 6666 6963 6520 746f , but suffice to │ │ │ │ │ -0002b100: 2073 6179 2074 6861 7420 6974 2073 696d say that it sim │ │ │ │ │ -0002b110: 706c 790a 776f 6e27 7420 776f 726b 2e20 ply.won't work. │ │ │ │ │ -0002b120: 2041 7574 6f6d 616b 6520 7769 6c6c 2067 Automake will g │ │ │ │ │ -0002b130: 6976 6520 616e 2065 7272 6f72 2069 6620 ive an error if │ │ │ │ │ -0002b140: 796f 7520 7472 7920 746f 2064 6f20 7468 you try to do th │ │ │ │ │ -0002b150: 6973 2e0a 0a20 2020 466f 7274 756e 6174 is... Fortunat │ │ │ │ │ -0002b160: 656c 7920 7468 6572 6520 6172 6520 7477 ely there are tw │ │ │ │ │ -0002b170: 6f20 6f74 6865 7220 7761 7973 2074 6f20 o other ways to │ │ │ │ │ -0002b180: 6163 6869 6576 6520 7468 6520 7361 6d65 achieve the same │ │ │ │ │ -0002b190: 2072 6573 756c 742e 2020 4f6e 650a 6973 result. One.is │ │ │ │ │ -0002b1a0: 2074 6f20 7573 6520 636f 6e66 6967 7572 to use configur │ │ │ │ │ -0002b1b0: 6520 7375 6273 7469 7475 7469 6f6e 7320 e substitutions │ │ │ │ │ -0002b1c0: 696e 2027 5f4c 4441 4444 2720 7661 7269 in '_LDADD' vari │ │ │ │ │ -0002b1d0: 6162 6c65 732c 2074 6865 206f 7468 6572 ables, the other │ │ │ │ │ -0002b1e0: 2069 7320 746f 0a75 7365 2061 6e20 4175 is to.use an Au │ │ │ │ │ -0002b1f0: 746f 6d61 6b65 2063 6f6e 6469 7469 6f6e tomake condition │ │ │ │ │ -0002b200: 616c 2e0a 0a43 6f6e 6469 7469 6f6e 616c al...Conditional │ │ │ │ │ -0002b210: 2043 6f6d 7069 6c61 7469 6f6e 2075 7369 Compilation usi │ │ │ │ │ -0002b220: 6e67 2027 5f4c 4441 4444 2720 5375 6273 ng '_LDADD' Subs │ │ │ │ │ -0002b230: 7469 7475 7469 6f6e 730a 2e2e 2e2e 2e2e titutions....... │ │ │ │ │ +0002b030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0002b040: 596f 7520 6361 6e27 7420 7075 7420 6120 You can't put a │ │ │ │ │ +0002b050: 636f 6e66 6967 7572 6520 7375 6273 7469 configure substi │ │ │ │ │ +0002b060: 7475 7469 6f6e 2028 652e 672e 2c20 2740 tution (e.g., '@ │ │ │ │ │ +0002b070: 464f 4f40 2720 6f72 2027 2428 464f 4f29 FOO@' or '$(FOO) │ │ │ │ │ +0002b080: 2720 7768 6572 650a 2746 4f4f 2720 6973 ' where.'FOO' is │ │ │ │ │ +0002b090: 2064 6566 696e 6564 2076 6961 2027 4143 defined via 'AC │ │ │ │ │ +0002b0a0: 5f53 5542 5354 2729 2069 6e74 6f20 6120 _SUBST') into a │ │ │ │ │ +0002b0b0: 275f 534f 5552 4345 5327 2076 6172 6961 '_SOURCES' varia │ │ │ │ │ +0002b0c0: 626c 652e 2020 5468 6520 7265 6173 6f6e ble. The reason │ │ │ │ │ +0002b0d0: 0a66 6f72 2074 6869 7320 6973 2061 2062 .for this is a b │ │ │ │ │ +0002b0e0: 6974 2068 6172 6420 746f 2065 7870 6c61 it hard to expla │ │ │ │ │ +0002b0f0: 696e 2c20 6275 7420 7375 6666 6963 6520 in, but suffice │ │ │ │ │ +0002b100: 746f 2073 6179 2074 6861 7420 6974 2073 to say that it s │ │ │ │ │ +0002b110: 696d 706c 790a 776f 6e27 7420 776f 726b imply.won't work │ │ │ │ │ +0002b120: 2e20 2041 7574 6f6d 616b 6520 7769 6c6c . Automake will │ │ │ │ │ +0002b130: 2067 6976 6520 616e 2065 7272 6f72 2069 give an error i │ │ │ │ │ +0002b140: 6620 796f 7520 7472 7920 746f 2064 6f20 f you try to do │ │ │ │ │ +0002b150: 7468 6973 2e0a 0a20 2020 466f 7274 756e this... Fortun │ │ │ │ │ +0002b160: 6174 656c 7920 7468 6572 6520 6172 6520 ately there are │ │ │ │ │ +0002b170: 7477 6f20 6f74 6865 7220 7761 7973 2074 two other ways t │ │ │ │ │ +0002b180: 6f20 6163 6869 6576 6520 7468 6520 7361 o achieve the sa │ │ │ │ │ +0002b190: 6d65 2072 6573 756c 742e 2020 4f6e 650a me result. One. │ │ │ │ │ +0002b1a0: 6973 2074 6f20 7573 6520 636f 6e66 6967 is to use config │ │ │ │ │ +0002b1b0: 7572 6520 7375 6273 7469 7475 7469 6f6e ure substitution │ │ │ │ │ +0002b1c0: 7320 696e 2027 5f4c 4441 4444 2720 7661 s in '_LDADD' va │ │ │ │ │ +0002b1d0: 7269 6162 6c65 732c 2074 6865 206f 7468 riables, the oth │ │ │ │ │ +0002b1e0: 6572 2069 7320 746f 0a75 7365 2061 6e20 er is to.use an │ │ │ │ │ +0002b1f0: 4175 746f 6d61 6b65 2063 6f6e 6469 7469 Automake conditi │ │ │ │ │ +0002b200: 6f6e 616c 2e0a 0a43 6f6e 6469 7469 6f6e onal...Condition │ │ │ │ │ +0002b210: 616c 2043 6f6d 7069 6c61 7469 6f6e 2075 al Compilation u │ │ │ │ │ +0002b220: 7369 6e67 2027 5f4c 4441 4444 2720 5375 sing '_LDADD' Su │ │ │ │ │ +0002b230: 6273 7469 7475 7469 6f6e 730a 2e2e 2e2e bstitutions..... │ │ │ │ │ 0002b240: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 0002b250: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0002b260: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 0a0a ................ │ │ │ │ │ -0002b270: 4175 746f 6d61 6b65 206d 7573 7420 6b6e Automake must kn │ │ │ │ │ -0002b280: 6f77 2061 6c6c 2074 6865 2073 6f75 7263 ow all the sourc │ │ │ │ │ -0002b290: 6520 6669 6c65 7320 7468 6174 2063 6f75 e files that cou │ │ │ │ │ -0002b2a0: 6c64 2070 6f73 7369 626c 7920 676f 2069 ld possibly go i │ │ │ │ │ -0002b2b0: 6e74 6f20 610a 7072 6f67 7261 6d2c 2065 nto a.program, e │ │ │ │ │ -0002b2c0: 7665 6e20 6966 206e 6f74 2061 6c6c 2074 ven if not all t │ │ │ │ │ -0002b2d0: 6865 2066 696c 6573 2061 7265 2062 7569 he files are bui │ │ │ │ │ -0002b2e0: 6c74 2069 6e20 6576 6572 7920 6369 7263 lt in every circ │ │ │ │ │ -0002b2f0: 756d 7374 616e 6365 2e20 2041 6e79 0a66 umstance. Any.f │ │ │ │ │ -0002b300: 696c 6573 2074 6861 7420 6172 6520 6f6e iles that are on │ │ │ │ │ -0002b310: 6c79 2063 6f6e 6469 7469 6f6e 616c 6c79 ly conditionally │ │ │ │ │ -0002b320: 2062 7569 6c74 2073 686f 756c 6420 6265 built should be │ │ │ │ │ -0002b330: 206c 6973 7465 6420 696e 2074 6865 0a61 listed in the.a │ │ │ │ │ -0002b340: 7070 726f 7072 6961 7465 2027 4558 5452 ppropriate 'EXTR │ │ │ │ │ -0002b350: 415f 2720 7661 7269 6162 6c65 2e20 2046 A_' variable. F │ │ │ │ │ -0002b360: 6f72 2069 6e73 7461 6e63 652c 2069 6620 or instance, if │ │ │ │ │ -0002b370: 2768 656c 6c6f 2d6c 696e 7578 2e63 2720 'hello-linux.c' │ │ │ │ │ -0002b380: 6f72 0a27 6865 6c6c 6f2d 6765 6e65 7269 or.'hello-generi │ │ │ │ │ -0002b390: 632e 6327 2077 6572 6520 636f 6e64 6974 c.c' were condit │ │ │ │ │ -0002b3a0: 696f 6e61 6c6c 7920 696e 636c 7564 6564 ionally included │ │ │ │ │ -0002b3b0: 2069 6e20 2768 656c 6c6f 272c 2074 6865 in 'hello', the │ │ │ │ │ -0002b3c0: 0a27 4d61 6b65 6669 6c65 2e61 6d27 2077 .'Makefile.am' w │ │ │ │ │ -0002b3d0: 6f75 6c64 2063 6f6e 7461 696e 3a0a 0a20 ould contain:.. │ │ │ │ │ -0002b3e0: 2020 2020 6269 6e5f 5052 4f47 5241 4d53 bin_PROGRAMS │ │ │ │ │ -0002b3f0: 203d 2068 656c 6c6f 0a20 2020 2020 6865 = hello. he │ │ │ │ │ -0002b400: 6c6c 6f5f 534f 5552 4345 5320 3d20 6865 llo_SOURCES = he │ │ │ │ │ -0002b410: 6c6c 6f2d 636f 6d6d 6f6e 2e63 0a20 2020 llo-common.c. │ │ │ │ │ -0002b420: 2020 4558 5452 415f 6865 6c6c 6f5f 534f EXTRA_hello_SO │ │ │ │ │ -0002b430: 5552 4345 5320 3d20 6865 6c6c 6f2d 6c69 URCES = hello-li │ │ │ │ │ -0002b440: 6e75 782e 6320 6865 6c6c 6f2d 6765 6e65 nux.c hello-gene │ │ │ │ │ -0002b450: 7269 632e 630a 2020 2020 2068 656c 6c6f ric.c. hello │ │ │ │ │ -0002b460: 5f4c 4441 4444 203d 2024 2848 454c 4c4f _LDADD = $(HELLO │ │ │ │ │ -0002b470: 5f53 5953 5445 4d29 0a20 2020 2020 6865 _SYSTEM). he │ │ │ │ │ -0002b480: 6c6c 6f5f 4445 5045 4e44 454e 4349 4553 llo_DEPENDENCIES │ │ │ │ │ -0002b490: 203d 2024 2848 454c 4c4f 5f53 5953 5445 = $(HELLO_SYSTE │ │ │ │ │ -0002b4a0: 4d29 0a0a 596f 7520 6361 6e20 7468 656e M)..You can then │ │ │ │ │ -0002b4b0: 2073 6574 7570 2074 6865 2027 2428 4845 setup the '$(HE │ │ │ │ │ -0002b4c0: 4c4c 4f5f 5359 5354 454d 2927 2073 7562 LLO_SYSTEM)' sub │ │ │ │ │ -0002b4d0: 7374 6974 7574 696f 6e20 6672 6f6d 0a27 stitution from.' │ │ │ │ │ -0002b4e0: 636f 6e66 6967 7572 652e 6163 273a 0a0a configure.ac':.. │ │ │ │ │ -0002b4f0: 2020 2020 202e 2e2e 0a20 2020 2020 6361 .... ca │ │ │ │ │ -0002b500: 7365 2024 686f 7374 2069 6e0a 2020 2020 se $host in. │ │ │ │ │ -0002b510: 2020 202a 6c69 6e75 782a 2920 4845 4c4c *linux*) HELL │ │ │ │ │ -0002b520: 4f5f 5359 5354 454d 3d27 6865 6c6c 6f2d O_SYSTEM='hello- │ │ │ │ │ -0002b530: 6c69 6e75 782e 2428 4f42 4a45 5854 2927 linux.$(OBJEXT)' │ │ │ │ │ -0002b540: 203b 3b0a 2020 2020 2020 202a 2920 2020 ;;. *) │ │ │ │ │ -0002b550: 2020 2020 4845 4c4c 4f5f 5359 5354 454d HELLO_SYSTEM │ │ │ │ │ -0002b560: 3d27 6865 6c6c 6f2d 6765 6e65 7269 632e ='hello-generic. │ │ │ │ │ -0002b570: 2428 4f42 4a45 5854 2927 203b 3b0a 2020 $(OBJEXT)' ;;. │ │ │ │ │ -0002b580: 2020 2065 7361 630a 2020 2020 2041 435f esac. AC_ │ │ │ │ │ -0002b590: 5355 4253 5428 5b48 454c 4c4f 5f53 5953 SUBST([HELLO_SYS │ │ │ │ │ -0002b5a0: 5445 4d5d 290a 2020 2020 202e 2e2e 0a0a TEM]). ..... │ │ │ │ │ -0002b5b0: 2020 2049 6e20 7468 6973 2063 6173 652c In this case, │ │ │ │ │ -0002b5c0: 2074 6865 2076 6172 6961 626c 6520 2748 the variable 'H │ │ │ │ │ -0002b5d0: 454c 4c4f 5f53 5953 5445 4d27 2073 686f ELLO_SYSTEM' sho │ │ │ │ │ -0002b5e0: 756c 6420 6265 2072 6570 6c61 6365 6420 uld be replaced │ │ │ │ │ -0002b5f0: 6279 0a65 6974 6865 7220 2768 656c 6c6f by.either 'hello │ │ │ │ │ -0002b600: 2d6c 696e 7578 2e6f 2720 6f72 2027 6865 -linux.o' or 'he │ │ │ │ │ -0002b610: 6c6c 6f2d 6765 6e65 7269 632e 6f27 2c20 llo-generic.o', │ │ │ │ │ -0002b620: 616e 6420 6164 6465 6420 746f 2062 6f74 and added to bot │ │ │ │ │ -0002b630: 680a 2768 656c 6c6f 5f44 4550 454e 4445 h.'hello_DEPENDE │ │ │ │ │ -0002b640: 4e43 4945 5327 2061 6e64 2027 6865 6c6c NCIES' and 'hell │ │ │ │ │ -0002b650: 6f5f 4c44 4144 4427 2069 6e20 6f72 6465 o_LDADD' in orde │ │ │ │ │ -0002b660: 7220 746f 2062 6520 6275 696c 7420 616e r to be built an │ │ │ │ │ -0002b670: 6420 6c69 6e6b 6564 0a69 6e2e 0a0a 436f d linked.in...Co │ │ │ │ │ -0002b680: 6e64 6974 696f 6e61 6c20 436f 6d70 696c nditional Compil │ │ │ │ │ -0002b690: 6174 696f 6e20 7573 696e 6720 4175 746f ation using Auto │ │ │ │ │ -0002b6a0: 6d61 6b65 2043 6f6e 6469 7469 6f6e 616c make Conditional │ │ │ │ │ -0002b6b0: 730a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e s............... │ │ │ │ │ +0002b260: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ +0002b270: 0a0a 4175 746f 6d61 6b65 206d 7573 7420 ..Automake must │ │ │ │ │ +0002b280: 6b6e 6f77 2061 6c6c 2074 6865 2073 6f75 know all the sou │ │ │ │ │ +0002b290: 7263 6520 6669 6c65 7320 7468 6174 2063 rce files that c │ │ │ │ │ +0002b2a0: 6f75 6c64 2070 6f73 7369 626c 7920 676f ould possibly go │ │ │ │ │ +0002b2b0: 2069 6e74 6f20 610a 7072 6f67 7261 6d2c into a.program, │ │ │ │ │ +0002b2c0: 2065 7665 6e20 6966 206e 6f74 2061 6c6c even if not all │ │ │ │ │ +0002b2d0: 2074 6865 2066 696c 6573 2061 7265 2062 the files are b │ │ │ │ │ +0002b2e0: 7569 6c74 2069 6e20 6576 6572 7920 6369 uilt in every ci │ │ │ │ │ +0002b2f0: 7263 756d 7374 616e 6365 2e20 2041 6e79 rcumstance. Any │ │ │ │ │ +0002b300: 0a66 696c 6573 2074 6861 7420 6172 6520 .files that are │ │ │ │ │ +0002b310: 6f6e 6c79 2063 6f6e 6469 7469 6f6e 616c only conditional │ │ │ │ │ +0002b320: 6c79 2062 7569 6c74 2073 686f 756c 6420 ly built should │ │ │ │ │ +0002b330: 6265 206c 6973 7465 6420 696e 2074 6865 be listed in the │ │ │ │ │ +0002b340: 0a61 7070 726f 7072 6961 7465 2027 4558 .appropriate 'EX │ │ │ │ │ +0002b350: 5452 415f 2720 7661 7269 6162 6c65 2e20 TRA_' variable. │ │ │ │ │ +0002b360: 2046 6f72 2069 6e73 7461 6e63 652c 2069 For instance, i │ │ │ │ │ +0002b370: 6620 2768 656c 6c6f 2d6c 696e 7578 2e63 f 'hello-linux.c │ │ │ │ │ +0002b380: 2720 6f72 0a27 6865 6c6c 6f2d 6765 6e65 ' or.'hello-gene │ │ │ │ │ +0002b390: 7269 632e 6327 2077 6572 6520 636f 6e64 ric.c' were cond │ │ │ │ │ +0002b3a0: 6974 696f 6e61 6c6c 7920 696e 636c 7564 itionally includ │ │ │ │ │ +0002b3b0: 6564 2069 6e20 2768 656c 6c6f 272c 2074 ed in 'hello', t │ │ │ │ │ +0002b3c0: 6865 0a27 4d61 6b65 6669 6c65 2e61 6d27 he.'Makefile.am' │ │ │ │ │ +0002b3d0: 2077 6f75 6c64 2063 6f6e 7461 696e 3a0a would contain:. │ │ │ │ │ +0002b3e0: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ +0002b3f0: 4d53 203d 2068 656c 6c6f 0a20 2020 2020 MS = hello. │ │ │ │ │ +0002b400: 6865 6c6c 6f5f 534f 5552 4345 5320 3d20 hello_SOURCES = │ │ │ │ │ +0002b410: 6865 6c6c 6f2d 636f 6d6d 6f6e 2e63 0a20 hello-common.c. │ │ │ │ │ +0002b420: 2020 2020 4558 5452 415f 6865 6c6c 6f5f EXTRA_hello_ │ │ │ │ │ +0002b430: 534f 5552 4345 5320 3d20 6865 6c6c 6f2d SOURCES = hello- │ │ │ │ │ +0002b440: 6c69 6e75 782e 6320 6865 6c6c 6f2d 6765 linux.c hello-ge │ │ │ │ │ +0002b450: 6e65 7269 632e 630a 2020 2020 2068 656c neric.c. hel │ │ │ │ │ +0002b460: 6c6f 5f4c 4441 4444 203d 2024 2848 454c lo_LDADD = $(HEL │ │ │ │ │ +0002b470: 4c4f 5f53 5953 5445 4d29 0a20 2020 2020 LO_SYSTEM). │ │ │ │ │ +0002b480: 6865 6c6c 6f5f 4445 5045 4e44 454e 4349 hello_DEPENDENCI │ │ │ │ │ +0002b490: 4553 203d 2024 2848 454c 4c4f 5f53 5953 ES = $(HELLO_SYS │ │ │ │ │ +0002b4a0: 5445 4d29 0a0a 596f 7520 6361 6e20 7468 TEM)..You can th │ │ │ │ │ +0002b4b0: 656e 2073 6574 7570 2074 6865 2027 2428 en setup the '$( │ │ │ │ │ +0002b4c0: 4845 4c4c 4f5f 5359 5354 454d 2927 2073 HELLO_SYSTEM)' s │ │ │ │ │ +0002b4d0: 7562 7374 6974 7574 696f 6e20 6672 6f6d ubstitution from │ │ │ │ │ +0002b4e0: 0a27 636f 6e66 6967 7572 652e 6163 273a .'configure.ac': │ │ │ │ │ +0002b4f0: 0a0a 2020 2020 202e 2e2e 0a20 2020 2020 .. .... │ │ │ │ │ +0002b500: 6361 7365 2024 686f 7374 2069 6e0a 2020 case $host in. │ │ │ │ │ +0002b510: 2020 2020 202a 6c69 6e75 782a 2920 4845 *linux*) HE │ │ │ │ │ +0002b520: 4c4c 4f5f 5359 5354 454d 3d27 6865 6c6c LLO_SYSTEM='hell │ │ │ │ │ +0002b530: 6f2d 6c69 6e75 782e 2428 4f42 4a45 5854 o-linux.$(OBJEXT │ │ │ │ │ +0002b540: 2927 203b 3b0a 2020 2020 2020 202a 2920 )' ;;. *) │ │ │ │ │ +0002b550: 2020 2020 2020 4845 4c4c 4f5f 5359 5354 HELLO_SYST │ │ │ │ │ +0002b560: 454d 3d27 6865 6c6c 6f2d 6765 6e65 7269 EM='hello-generi │ │ │ │ │ +0002b570: 632e 2428 4f42 4a45 5854 2927 203b 3b0a c.$(OBJEXT)' ;;. │ │ │ │ │ +0002b580: 2020 2020 2065 7361 630a 2020 2020 2041 esac. A │ │ │ │ │ +0002b590: 435f 5355 4253 5428 5b48 454c 4c4f 5f53 C_SUBST([HELLO_S │ │ │ │ │ +0002b5a0: 5953 5445 4d5d 290a 2020 2020 202e 2e2e YSTEM]). ... │ │ │ │ │ +0002b5b0: 0a0a 2020 2049 6e20 7468 6973 2063 6173 .. In this cas │ │ │ │ │ +0002b5c0: 652c 2074 6865 2076 6172 6961 626c 6520 e, the variable │ │ │ │ │ +0002b5d0: 2748 454c 4c4f 5f53 5953 5445 4d27 2073 'HELLO_SYSTEM' s │ │ │ │ │ +0002b5e0: 686f 756c 6420 6265 2072 6570 6c61 6365 hould be replace │ │ │ │ │ +0002b5f0: 6420 6279 0a65 6974 6865 7220 2768 656c d by.either 'hel │ │ │ │ │ +0002b600: 6c6f 2d6c 696e 7578 2e6f 2720 6f72 2027 lo-linux.o' or ' │ │ │ │ │ +0002b610: 6865 6c6c 6f2d 6765 6e65 7269 632e 6f27 hello-generic.o' │ │ │ │ │ +0002b620: 2c20 616e 6420 6164 6465 6420 746f 2062 , and added to b │ │ │ │ │ +0002b630: 6f74 680a 2768 656c 6c6f 5f44 4550 454e oth.'hello_DEPEN │ │ │ │ │ +0002b640: 4445 4e43 4945 5327 2061 6e64 2027 6865 DENCIES' and 'he │ │ │ │ │ +0002b650: 6c6c 6f5f 4c44 4144 4427 2069 6e20 6f72 llo_LDADD' in or │ │ │ │ │ +0002b660: 6465 7220 746f 2062 6520 6275 696c 7420 der to be built │ │ │ │ │ +0002b670: 616e 6420 6c69 6e6b 6564 0a69 6e2e 0a0a and linked.in... │ │ │ │ │ +0002b680: 436f 6e64 6974 696f 6e61 6c20 436f 6d70 Conditional Comp │ │ │ │ │ +0002b690: 696c 6174 696f 6e20 7573 696e 6720 4175 ilation using Au │ │ │ │ │ +0002b6a0: 746f 6d61 6b65 2043 6f6e 6469 7469 6f6e tomake Condition │ │ │ │ │ +0002b6b0: 616c 730a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e als............. │ │ │ │ │ 0002b6c0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 0002b6d0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0002b6e0: 2e2e 2e2e 2e0a 0a41 6e20 6f66 7465 6e20 .......An often │ │ │ │ │ -0002b6f0: 7369 6d70 6c65 7220 7761 7920 746f 2063 simpler way to c │ │ │ │ │ -0002b700: 6f6d 7069 6c65 2073 6f75 7263 6520 6669 ompile source fi │ │ │ │ │ -0002b710: 6c65 7320 636f 6e64 6974 696f 6e61 6c6c les conditionall │ │ │ │ │ -0002b720: 7920 6973 2074 6f20 7573 650a 4175 746f y is to use.Auto │ │ │ │ │ -0002b730: 6d61 6b65 2063 6f6e 6469 7469 6f6e 616c make conditional │ │ │ │ │ -0002b740: 732e 2020 466f 7220 696e 7374 616e 6365 s. For instance │ │ │ │ │ -0002b750: 2c20 796f 7520 636f 756c 6420 7573 6520 , you could use │ │ │ │ │ -0002b760: 7468 6973 2027 4d61 6b65 6669 6c65 2e61 this 'Makefile.a │ │ │ │ │ -0002b770: 6d27 0a63 6f6e 7374 7275 6374 2074 6f20 m'.construct to │ │ │ │ │ -0002b780: 6275 696c 6420 7468 6520 7361 6d65 2027 build the same ' │ │ │ │ │ -0002b790: 6865 6c6c 6f27 2065 7861 6d70 6c65 3a0a hello' example:. │ │ │ │ │ -0002b7a0: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ -0002b7b0: 4d53 203d 2068 656c 6c6f 0a20 2020 2020 MS = hello. │ │ │ │ │ -0002b7c0: 6966 204c 494e 5558 0a20 2020 2020 6865 if LINUX. he │ │ │ │ │ -0002b7d0: 6c6c 6f5f 534f 5552 4345 5320 3d20 6865 llo_SOURCES = he │ │ │ │ │ -0002b7e0: 6c6c 6f2d 6c69 6e75 782e 6320 6865 6c6c llo-linux.c hell │ │ │ │ │ -0002b7f0: 6f2d 636f 6d6d 6f6e 2e63 0a20 2020 2020 o-common.c. │ │ │ │ │ -0002b800: 656c 7365 0a20 2020 2020 6865 6c6c 6f5f else. hello_ │ │ │ │ │ -0002b810: 534f 5552 4345 5320 3d20 6865 6c6c 6f2d SOURCES = hello- │ │ │ │ │ -0002b820: 6765 6e65 7269 632e 6320 6865 6c6c 6f2d generic.c hello- │ │ │ │ │ -0002b830: 636f 6d6d 6f6e 2e63 0a20 2020 2020 656e common.c. en │ │ │ │ │ -0002b840: 6469 660a 0a20 2020 496e 2074 6869 7320 dif.. In this │ │ │ │ │ -0002b850: 6361 7365 2c20 2763 6f6e 6669 6775 7265 case, 'configure │ │ │ │ │ -0002b860: 2e61 6327 2073 686f 756c 6420 7365 7475 .ac' should setu │ │ │ │ │ -0002b870: 7020 7468 6520 274c 494e 5558 2720 636f p the 'LINUX' co │ │ │ │ │ -0002b880: 6e64 6974 696f 6e61 6c0a 7573 696e 6720 nditional.using │ │ │ │ │ -0002b890: 2741 4d5f 434f 4e44 4954 494f 4e41 4c27 'AM_CONDITIONAL' │ │ │ │ │ -0002b8a0: 2028 2a6e 6f74 6520 436f 6e64 6974 696f (*note Conditio │ │ │ │ │ -0002b8b0: 6e61 6c73 3a3a 292e 0a0a 2020 2057 6865 nals::)... Whe │ │ │ │ │ -0002b8c0: 6e20 7573 696e 6720 636f 6e64 6974 696f n using conditio │ │ │ │ │ -0002b8d0: 6e61 6c73 206c 696b 6520 7468 6973 2079 nals like this y │ │ │ │ │ -0002b8e0: 6f75 2064 6f6e 2774 206e 6565 6420 746f ou don't need to │ │ │ │ │ -0002b8f0: 2075 7365 2074 6865 2027 4558 5452 415f use the 'EXTRA_ │ │ │ │ │ -0002b900: 270a 7661 7269 6162 6c65 2c20 6265 6361 '.variable, beca │ │ │ │ │ -0002b910: 7573 6520 4175 746f 6d61 6b65 2077 696c use Automake wil │ │ │ │ │ -0002b920: 6c20 6578 616d 696e 6520 7468 6520 636f l examine the co │ │ │ │ │ -0002b930: 6e74 656e 7473 206f 6620 6561 6368 2076 ntents of each v │ │ │ │ │ -0002b940: 6172 6961 626c 6520 746f 0a63 6f6e 7374 ariable to.const │ │ │ │ │ -0002b950: 7275 6374 2074 6865 2063 6f6d 706c 6574 ruct the complet │ │ │ │ │ -0002b960: 6520 6c69 7374 206f 6620 736f 7572 6365 e list of source │ │ │ │ │ -0002b970: 2066 696c 6573 2e0a 0a20 2020 4966 2079 files... If y │ │ │ │ │ -0002b980: 6f75 7220 7072 6f67 7261 6d20 7573 6573 our program uses │ │ │ │ │ -0002b990: 2061 206c 6f74 206f 6620 6669 6c65 732c a lot of files, │ │ │ │ │ -0002b9a0: 2079 6f75 2077 696c 6c20 7072 6f62 6162 you will probab │ │ │ │ │ -0002b9b0: 6c79 2070 7265 6665 7220 610a 636f 6e64 ly prefer a.cond │ │ │ │ │ -0002b9c0: 6974 696f 6e61 6c20 272b 3d27 2e0a 0a20 itional '+='... │ │ │ │ │ -0002b9d0: 2020 2020 6269 6e5f 5052 4f47 5241 4d53 bin_PROGRAMS │ │ │ │ │ -0002b9e0: 203d 2068 656c 6c6f 0a20 2020 2020 6865 = hello. he │ │ │ │ │ -0002b9f0: 6c6c 6f5f 534f 5552 4345 5320 3d20 6865 llo_SOURCES = he │ │ │ │ │ -0002ba00: 6c6c 6f2d 636f 6d6d 6f6e 2e63 0a20 2020 llo-common.c. │ │ │ │ │ -0002ba10: 2020 6966 204c 494e 5558 0a20 2020 2020 if LINUX. │ │ │ │ │ -0002ba20: 6865 6c6c 6f5f 534f 5552 4345 5320 2b3d hello_SOURCES += │ │ │ │ │ -0002ba30: 2068 656c 6c6f 2d6c 696e 7578 2e63 0a20 hello-linux.c. │ │ │ │ │ -0002ba40: 2020 2020 656c 7365 0a20 2020 2020 6865 else. he │ │ │ │ │ -0002ba50: 6c6c 6f5f 534f 5552 4345 5320 2b3d 2068 llo_SOURCES += h │ │ │ │ │ -0002ba60: 656c 6c6f 2d67 656e 6572 6963 2e63 0a20 ello-generic.c. │ │ │ │ │ -0002ba70: 2020 2020 656e 6469 660a 0a1f 0a46 696c endif....Fil │ │ │ │ │ -0002ba80: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -0002ba90: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 436f .info, Node: Co │ │ │ │ │ -0002baa0: 6e64 6974 696f 6e61 6c20 5072 6f67 7261 nditional Progra │ │ │ │ │ -0002bab0: 6d73 2c20 2050 7265 763a 2043 6f6e 6469 ms, Prev: Condi │ │ │ │ │ -0002bac0: 7469 6f6e 616c 2053 6f75 7263 6573 2c20 tional Sources, │ │ │ │ │ -0002bad0: 2055 703a 2041 2050 726f 6772 616d 0a0a Up: A Program.. │ │ │ │ │ -0002bae0: 382e 312e 3420 436f 6e64 6974 696f 6e61 8.1.4 Conditiona │ │ │ │ │ -0002baf0: 6c20 636f 6d70 696c 6174 696f 6e20 6f66 l compilation of │ │ │ │ │ -0002bb00: 2070 726f 6772 616d 730a 2d2d 2d2d 2d2d programs.------ │ │ │ │ │ +0002b6e0: 2e2e 2e2e 2e2e 2e0a 0a41 6e20 6f66 7465 .........An ofte │ │ │ │ │ +0002b6f0: 6e20 7369 6d70 6c65 7220 7761 7920 746f n simpler way to │ │ │ │ │ +0002b700: 2063 6f6d 7069 6c65 2073 6f75 7263 6520 compile source │ │ │ │ │ +0002b710: 6669 6c65 7320 636f 6e64 6974 696f 6e61 files conditiona │ │ │ │ │ +0002b720: 6c6c 7920 6973 2074 6f20 7573 650a 4175 lly is to use.Au │ │ │ │ │ +0002b730: 746f 6d61 6b65 2063 6f6e 6469 7469 6f6e tomake condition │ │ │ │ │ +0002b740: 616c 732e 2020 466f 7220 696e 7374 616e als. For instan │ │ │ │ │ +0002b750: 6365 2c20 796f 7520 636f 756c 6420 7573 ce, you could us │ │ │ │ │ +0002b760: 6520 7468 6973 2027 4d61 6b65 6669 6c65 e this 'Makefile │ │ │ │ │ +0002b770: 2e61 6d27 0a63 6f6e 7374 7275 6374 2074 .am'.construct t │ │ │ │ │ +0002b780: 6f20 6275 696c 6420 7468 6520 7361 6d65 o build the same │ │ │ │ │ +0002b790: 2027 6865 6c6c 6f27 2065 7861 6d70 6c65 'hello' example │ │ │ │ │ +0002b7a0: 3a0a 0a20 2020 2020 6269 6e5f 5052 4f47 :.. bin_PROG │ │ │ │ │ +0002b7b0: 5241 4d53 203d 2068 656c 6c6f 0a20 2020 RAMS = hello. │ │ │ │ │ +0002b7c0: 2020 6966 204c 494e 5558 0a20 2020 2020 if LINUX. │ │ │ │ │ +0002b7d0: 6865 6c6c 6f5f 534f 5552 4345 5320 3d20 hello_SOURCES = │ │ │ │ │ +0002b7e0: 6865 6c6c 6f2d 6c69 6e75 782e 6320 6865 hello-linux.c he │ │ │ │ │ +0002b7f0: 6c6c 6f2d 636f 6d6d 6f6e 2e63 0a20 2020 llo-common.c. │ │ │ │ │ +0002b800: 2020 656c 7365 0a20 2020 2020 6865 6c6c else. hell │ │ │ │ │ +0002b810: 6f5f 534f 5552 4345 5320 3d20 6865 6c6c o_SOURCES = hell │ │ │ │ │ +0002b820: 6f2d 6765 6e65 7269 632e 6320 6865 6c6c o-generic.c hell │ │ │ │ │ +0002b830: 6f2d 636f 6d6d 6f6e 2e63 0a20 2020 2020 o-common.c. │ │ │ │ │ +0002b840: 656e 6469 660a 0a20 2020 496e 2074 6869 endif.. In thi │ │ │ │ │ +0002b850: 7320 6361 7365 2c20 2763 6f6e 6669 6775 s case, 'configu │ │ │ │ │ +0002b860: 7265 2e61 6327 2073 686f 756c 6420 7365 re.ac' should se │ │ │ │ │ +0002b870: 7475 7020 7468 6520 274c 494e 5558 2720 tup the 'LINUX' │ │ │ │ │ +0002b880: 636f 6e64 6974 696f 6e61 6c0a 7573 696e conditional.usin │ │ │ │ │ +0002b890: 6720 2741 4d5f 434f 4e44 4954 494f 4e41 g 'AM_CONDITIONA │ │ │ │ │ +0002b8a0: 4c27 2028 2a6e 6f74 6520 436f 6e64 6974 L' (*note Condit │ │ │ │ │ +0002b8b0: 696f 6e61 6c73 3a3a 292e 0a0a 2020 2057 ionals::)... W │ │ │ │ │ +0002b8c0: 6865 6e20 7573 696e 6720 636f 6e64 6974 hen using condit │ │ │ │ │ +0002b8d0: 696f 6e61 6c73 206c 696b 6520 7468 6973 ionals like this │ │ │ │ │ +0002b8e0: 2079 6f75 2064 6f6e 2774 206e 6565 6420 you don't need │ │ │ │ │ +0002b8f0: 746f 2075 7365 2074 6865 2027 4558 5452 to use the 'EXTR │ │ │ │ │ +0002b900: 415f 270a 7661 7269 6162 6c65 2c20 6265 A_'.variable, be │ │ │ │ │ +0002b910: 6361 7573 6520 4175 746f 6d61 6b65 2077 cause Automake w │ │ │ │ │ +0002b920: 696c 6c20 6578 616d 696e 6520 7468 6520 ill examine the │ │ │ │ │ +0002b930: 636f 6e74 656e 7473 206f 6620 6561 6368 contents of each │ │ │ │ │ +0002b940: 2076 6172 6961 626c 6520 746f 0a63 6f6e variable to.con │ │ │ │ │ +0002b950: 7374 7275 6374 2074 6865 2063 6f6d 706c struct the compl │ │ │ │ │ +0002b960: 6574 6520 6c69 7374 206f 6620 736f 7572 ete list of sour │ │ │ │ │ +0002b970: 6365 2066 696c 6573 2e0a 0a20 2020 4966 ce files... If │ │ │ │ │ +0002b980: 2079 6f75 7220 7072 6f67 7261 6d20 7573 your program us │ │ │ │ │ +0002b990: 6573 2061 206c 6f74 206f 6620 6669 6c65 es a lot of file │ │ │ │ │ +0002b9a0: 732c 2079 6f75 2077 696c 6c20 7072 6f62 s, you will prob │ │ │ │ │ +0002b9b0: 6162 6c79 2070 7265 6665 7220 610a 636f ably prefer a.co │ │ │ │ │ +0002b9c0: 6e64 6974 696f 6e61 6c20 272b 3d27 2e0a nditional '+='.. │ │ │ │ │ +0002b9d0: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ +0002b9e0: 4d53 203d 2068 656c 6c6f 0a20 2020 2020 MS = hello. │ │ │ │ │ +0002b9f0: 6865 6c6c 6f5f 534f 5552 4345 5320 3d20 hello_SOURCES = │ │ │ │ │ +0002ba00: 6865 6c6c 6f2d 636f 6d6d 6f6e 2e63 0a20 hello-common.c. │ │ │ │ │ +0002ba10: 2020 2020 6966 204c 494e 5558 0a20 2020 if LINUX. │ │ │ │ │ +0002ba20: 2020 6865 6c6c 6f5f 534f 5552 4345 5320 hello_SOURCES │ │ │ │ │ +0002ba30: 2b3d 2068 656c 6c6f 2d6c 696e 7578 2e63 += hello-linux.c │ │ │ │ │ +0002ba40: 0a20 2020 2020 656c 7365 0a20 2020 2020 . else. │ │ │ │ │ +0002ba50: 6865 6c6c 6f5f 534f 5552 4345 5320 2b3d hello_SOURCES += │ │ │ │ │ +0002ba60: 2068 656c 6c6f 2d67 656e 6572 6963 2e63 hello-generic.c │ │ │ │ │ +0002ba70: 0a20 2020 2020 656e 6469 660a 0a1f 0a46 . endif....F │ │ │ │ │ +0002ba80: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +0002ba90: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +0002baa0: 436f 6e64 6974 696f 6e61 6c20 5072 6f67 Conditional Prog │ │ │ │ │ +0002bab0: 7261 6d73 2c20 2050 7265 763a 2043 6f6e rams, Prev: Con │ │ │ │ │ +0002bac0: 6469 7469 6f6e 616c 2053 6f75 7263 6573 ditional Sources │ │ │ │ │ +0002bad0: 2c20 2055 703a 2041 2050 726f 6772 616d , Up: A Program │ │ │ │ │ +0002bae0: 0a0a 382e 312e 3420 436f 6e64 6974 696f ..8.1.4 Conditio │ │ │ │ │ +0002baf0: 6e61 6c20 636f 6d70 696c 6174 696f 6e20 nal compilation │ │ │ │ │ +0002bb00: 6f66 2070 726f 6772 616d 730a 2d2d 2d2d of programs.---- │ │ │ │ │ 0002bb10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0002bb20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002bb30: 2d2d 2d0a 0a53 6f6d 6574 696d 6573 2069 ---..Sometimes i │ │ │ │ │ -0002bb40: 7420 6973 2075 7365 6675 6c20 746f 2064 t is useful to d │ │ │ │ │ -0002bb50: 6574 6572 6d69 6e65 2074 6865 2070 726f etermine the pro │ │ │ │ │ -0002bb60: 6772 616d 7320 7468 6174 2061 7265 2074 grams that are t │ │ │ │ │ -0002bb70: 6f20 6265 2062 7569 6c74 2061 740a 636f o be built at.co │ │ │ │ │ -0002bb80: 6e66 6967 7572 6520 7469 6d65 2e20 2046 nfigure time. F │ │ │ │ │ -0002bb90: 6f72 2069 6e73 7461 6e63 652c 2047 4e55 or instance, GNU │ │ │ │ │ -0002bba0: 2027 6370 696f 2720 6f6e 6c79 2062 7569 'cpio' only bui │ │ │ │ │ -0002bbb0: 6c64 7320 276d 7427 2061 6e64 2027 726d lds 'mt' and 'rm │ │ │ │ │ -0002bbc0: 7427 0a75 6e64 6572 2073 7065 6369 616c t'.under special │ │ │ │ │ -0002bbd0: 2063 6972 6375 6d73 7461 6e63 6573 2e20 circumstances. │ │ │ │ │ -0002bbe0: 2054 6865 206d 6561 6e73 2074 6f20 6163 The means to ac │ │ │ │ │ -0002bbf0: 6869 6576 6520 636f 6e64 6974 696f 6e61 hieve conditiona │ │ │ │ │ -0002bc00: 6c0a 636f 6d70 696c 6174 696f 6e20 6f66 l.compilation of │ │ │ │ │ -0002bc10: 2070 726f 6772 616d 7320 6172 6520 7468 programs are th │ │ │ │ │ -0002bc20: 6520 7361 6d65 2079 6f75 2063 616e 2075 e same you can u │ │ │ │ │ -0002bc30: 7365 2074 6f20 636f 6d70 696c 6520 736f se to compile so │ │ │ │ │ -0002bc40: 7572 6365 2066 696c 6573 0a63 6f6e 6469 urce files.condi │ │ │ │ │ -0002bc50: 7469 6f6e 616c 6c79 3a20 7375 6273 7469 tionally: substi │ │ │ │ │ -0002bc60: 7475 7469 6f6e 7320 6f72 2063 6f6e 6469 tutions or condi │ │ │ │ │ -0002bc70: 7469 6f6e 616c 732e 0a0a 436f 6e64 6974 tionals...Condit │ │ │ │ │ -0002bc80: 696f 6e61 6c20 5072 6f67 7261 6d73 2075 ional Programs u │ │ │ │ │ -0002bc90: 7369 6e67 2027 636f 6e66 6967 7572 6527 sing 'configure' │ │ │ │ │ -0002bca0: 2053 7562 7374 6974 7574 696f 6e73 0a2e Substitutions.. │ │ │ │ │ -0002bcb0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ +0002bb30: 2d2d 2d2d 2d0a 0a53 6f6d 6574 696d 6573 -----..Sometimes │ │ │ │ │ +0002bb40: 2069 7420 6973 2075 7365 6675 6c20 746f it is useful to │ │ │ │ │ +0002bb50: 2064 6574 6572 6d69 6e65 2074 6865 2070 determine the p │ │ │ │ │ +0002bb60: 726f 6772 616d 7320 7468 6174 2061 7265 rograms that are │ │ │ │ │ +0002bb70: 2074 6f20 6265 2062 7569 6c74 2061 740a to be built at. │ │ │ │ │ +0002bb80: 636f 6e66 6967 7572 6520 7469 6d65 2e20 configure time. │ │ │ │ │ +0002bb90: 2046 6f72 2069 6e73 7461 6e63 652c 2047 For instance, G │ │ │ │ │ +0002bba0: 4e55 2027 6370 696f 2720 6f6e 6c79 2062 NU 'cpio' only b │ │ │ │ │ +0002bbb0: 7569 6c64 7320 276d 7427 2061 6e64 2027 uilds 'mt' and ' │ │ │ │ │ +0002bbc0: 726d 7427 0a75 6e64 6572 2073 7065 6369 rmt'.under speci │ │ │ │ │ +0002bbd0: 616c 2063 6972 6375 6d73 7461 6e63 6573 al circumstances │ │ │ │ │ +0002bbe0: 2e20 2054 6865 206d 6561 6e73 2074 6f20 . The means to │ │ │ │ │ +0002bbf0: 6163 6869 6576 6520 636f 6e64 6974 696f achieve conditio │ │ │ │ │ +0002bc00: 6e61 6c0a 636f 6d70 696c 6174 696f 6e20 nal.compilation │ │ │ │ │ +0002bc10: 6f66 2070 726f 6772 616d 7320 6172 6520 of programs are │ │ │ │ │ +0002bc20: 7468 6520 7361 6d65 2079 6f75 2063 616e the same you can │ │ │ │ │ +0002bc30: 2075 7365 2074 6f20 636f 6d70 696c 6520 use to compile │ │ │ │ │ +0002bc40: 736f 7572 6365 2066 696c 6573 0a63 6f6e source files.con │ │ │ │ │ +0002bc50: 6469 7469 6f6e 616c 6c79 3a20 7375 6273 ditionally: subs │ │ │ │ │ +0002bc60: 7469 7475 7469 6f6e 7320 6f72 2063 6f6e titutions or con │ │ │ │ │ +0002bc70: 6469 7469 6f6e 616c 732e 0a0a 436f 6e64 ditionals...Cond │ │ │ │ │ +0002bc80: 6974 696f 6e61 6c20 5072 6f67 7261 6d73 itional Programs │ │ │ │ │ +0002bc90: 2075 7369 6e67 2027 636f 6e66 6967 7572 using 'configur │ │ │ │ │ +0002bca0: 6527 2053 7562 7374 6974 7574 696f 6e73 e' Substitutions │ │ │ │ │ +0002bcb0: 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 0002bcc0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 0002bcd0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0002bce0: 2e2e 2e0a 0a49 6e20 7468 6973 2063 6173 .....In this cas │ │ │ │ │ -0002bcf0: 652c 2079 6f75 206d 7573 7420 6e6f 7469 e, you must noti │ │ │ │ │ -0002bd00: 6679 2041 7574 6f6d 616b 6520 6f66 2061 fy Automake of a │ │ │ │ │ -0002bd10: 6c6c 2074 6865 2070 726f 6772 616d 7320 ll the programs │ │ │ │ │ -0002bd20: 7468 6174 2063 616e 0a70 6f73 7369 626c that can.possibl │ │ │ │ │ -0002bd30: 7920 6265 2062 7569 6c74 2c20 6275 7420 y be built, but │ │ │ │ │ -0002bd40: 6174 2074 6865 2073 616d 6520 7469 6d65 at the same time │ │ │ │ │ -0002bd50: 2063 6175 7365 2074 6865 2067 656e 6572 cause the gener │ │ │ │ │ -0002bd60: 6174 6564 0a27 4d61 6b65 6669 6c65 2e69 ated.'Makefile.i │ │ │ │ │ -0002bd70: 6e27 2074 6f20 7573 6520 7468 6520 7072 n' to use the pr │ │ │ │ │ -0002bd80: 6f67 7261 6d73 2073 7065 6369 6669 6564 ograms specified │ │ │ │ │ -0002bd90: 2062 7920 2763 6f6e 6669 6775 7265 272e by 'configure'. │ │ │ │ │ -0002bda0: 2020 5468 6973 2069 730a 646f 6e65 2062 This is.done b │ │ │ │ │ -0002bdb0: 7920 6861 7669 6e67 2027 636f 6e66 6967 y having 'config │ │ │ │ │ -0002bdc0: 7572 6527 2073 7562 7374 6974 7574 6520 ure' substitute │ │ │ │ │ -0002bdd0: 7661 6c75 6573 2069 6e74 6f20 6561 6368 values into each │ │ │ │ │ -0002bde0: 2027 5f50 524f 4752 414d 5327 0a64 6566 '_PROGRAMS'.def │ │ │ │ │ -0002bdf0: 696e 6974 696f 6e2c 2077 6869 6c65 206c inition, while l │ │ │ │ │ -0002be00: 6973 7469 6e67 2061 6c6c 206f 7074 696f isting all optio │ │ │ │ │ -0002be10: 6e61 6c6c 7920 6275 696c 7420 7072 6f67 nally built prog │ │ │ │ │ -0002be20: 7261 6d73 2069 6e0a 2745 5854 5241 5f50 rams in.'EXTRA_P │ │ │ │ │ -0002be30: 524f 4752 414d 5327 2e0a 0a20 2020 2020 ROGRAMS'... │ │ │ │ │ -0002be40: 6269 6e5f 5052 4f47 5241 4d53 203d 2063 bin_PROGRAMS = c │ │ │ │ │ -0002be50: 7069 6f20 7061 7820 2428 4d54 290a 2020 pio pax $(MT). │ │ │ │ │ -0002be60: 2020 206c 6962 6578 6563 5f50 524f 4752 libexec_PROGR │ │ │ │ │ -0002be70: 414d 5320 3d20 2428 524d 5429 0a20 2020 AMS = $(RMT). │ │ │ │ │ -0002be80: 2020 4558 5452 415f 5052 4f47 5241 4d53 EXTRA_PROGRAMS │ │ │ │ │ -0002be90: 203d 206d 7420 726d 740a 0a20 2020 4173 = mt rmt.. As │ │ │ │ │ -0002bea0: 2065 7870 6c61 696e 6564 2069 6e20 2a6e explained in *n │ │ │ │ │ -0002beb0: 6f74 6520 4558 4545 5854 3a3a 2c20 4175 ote EXEEXT::, Au │ │ │ │ │ -0002bec0: 746f 6d61 6b65 2077 696c 6c20 7265 7772 tomake will rewr │ │ │ │ │ -0002bed0: 6974 6520 2762 696e 5f50 524f 4752 414d ite 'bin_PROGRAM │ │ │ │ │ -0002bee0: 5327 2c0a 276c 6962 6578 6563 5f50 524f S',.'libexec_PRO │ │ │ │ │ -0002bef0: 4752 414d 5327 2c20 616e 6420 2745 5854 GRAMS', and 'EXT │ │ │ │ │ -0002bf00: 5241 5f50 524f 4752 414d 5327 2c20 6170 RA_PROGRAMS', ap │ │ │ │ │ -0002bf10: 7065 6e64 696e 6720 2724 2845 5845 4558 pending '$(EXEEX │ │ │ │ │ -0002bf20: 5429 2720 746f 2065 6163 680a 6269 6e61 T)' to each.bina │ │ │ │ │ -0002bf30: 7279 2e20 204f 6276 696f 7573 6c79 2069 ry. Obviously i │ │ │ │ │ -0002bf40: 7420 6361 6e6e 6f74 2072 6577 7269 7465 t cannot rewrite │ │ │ │ │ -0002bf50: 2076 616c 7565 7320 6f62 7461 696e 6564 values obtained │ │ │ │ │ -0002bf60: 2061 7420 7275 6e2d 7469 6d65 2074 6872 at run-time thr │ │ │ │ │ -0002bf70: 6f75 6768 0a27 636f 6e66 6967 7572 6527 ough.'configure' │ │ │ │ │ -0002bf80: 2073 7562 7374 6974 7574 696f 6e73 2c20 substitutions, │ │ │ │ │ -0002bf90: 7468 6572 6566 6f72 6520 796f 7520 7368 therefore you sh │ │ │ │ │ -0002bfa0: 6f75 6c64 2074 616b 6520 6361 7265 206f ould take care o │ │ │ │ │ -0002bfb0: 6620 6170 7065 6e64 696e 670a 2724 2845 f appending.'$(E │ │ │ │ │ -0002bfc0: 5845 4558 5429 2720 796f 7572 7365 6c66 XEEXT)' yourself │ │ │ │ │ -0002bfd0: 2c20 6173 2069 6e20 2741 435f 5355 4253 , as in 'AC_SUBS │ │ │ │ │ -0002bfe0: 5428 5b4d 545d 2c20 5b27 6d74 247b 4558 T([MT], ['mt${EX │ │ │ │ │ -0002bff0: 4545 5854 7d27 5d29 272e 0a0a 436f 6e64 EEXT}'])'...Cond │ │ │ │ │ -0002c000: 6974 696f 6e61 6c20 5072 6f67 7261 6d73 itional Programs │ │ │ │ │ -0002c010: 2075 7369 6e67 2041 7574 6f6d 616b 6520 using Automake │ │ │ │ │ -0002c020: 436f 6e64 6974 696f 6e61 6c73 0a2e 2e2e Conditionals.... │ │ │ │ │ +0002bce0: 2e2e 2e2e 2e0a 0a49 6e20 7468 6973 2063 .......In this c │ │ │ │ │ +0002bcf0: 6173 652c 2079 6f75 206d 7573 7420 6e6f ase, you must no │ │ │ │ │ +0002bd00: 7469 6679 2041 7574 6f6d 616b 6520 6f66 tify Automake of │ │ │ │ │ +0002bd10: 2061 6c6c 2074 6865 2070 726f 6772 616d all the program │ │ │ │ │ +0002bd20: 7320 7468 6174 2063 616e 0a70 6f73 7369 s that can.possi │ │ │ │ │ +0002bd30: 626c 7920 6265 2062 7569 6c74 2c20 6275 bly be built, bu │ │ │ │ │ +0002bd40: 7420 6174 2074 6865 2073 616d 6520 7469 t at the same ti │ │ │ │ │ +0002bd50: 6d65 2063 6175 7365 2074 6865 2067 656e me cause the gen │ │ │ │ │ +0002bd60: 6572 6174 6564 0a27 4d61 6b65 6669 6c65 erated.'Makefile │ │ │ │ │ +0002bd70: 2e69 6e27 2074 6f20 7573 6520 7468 6520 .in' to use the │ │ │ │ │ +0002bd80: 7072 6f67 7261 6d73 2073 7065 6369 6669 programs specifi │ │ │ │ │ +0002bd90: 6564 2062 7920 2763 6f6e 6669 6775 7265 ed by 'configure │ │ │ │ │ +0002bda0: 272e 2020 5468 6973 2069 730a 646f 6e65 '. This is.done │ │ │ │ │ +0002bdb0: 2062 7920 6861 7669 6e67 2027 636f 6e66 by having 'conf │ │ │ │ │ +0002bdc0: 6967 7572 6527 2073 7562 7374 6974 7574 igure' substitut │ │ │ │ │ +0002bdd0: 6520 7661 6c75 6573 2069 6e74 6f20 6561 e values into ea │ │ │ │ │ +0002bde0: 6368 2027 5f50 524f 4752 414d 5327 0a64 ch '_PROGRAMS'.d │ │ │ │ │ +0002bdf0: 6566 696e 6974 696f 6e2c 2077 6869 6c65 efinition, while │ │ │ │ │ +0002be00: 206c 6973 7469 6e67 2061 6c6c 206f 7074 listing all opt │ │ │ │ │ +0002be10: 696f 6e61 6c6c 7920 6275 696c 7420 7072 ionally built pr │ │ │ │ │ +0002be20: 6f67 7261 6d73 2069 6e0a 2745 5854 5241 ograms in.'EXTRA │ │ │ │ │ +0002be30: 5f50 524f 4752 414d 5327 2e0a 0a20 2020 _PROGRAMS'... │ │ │ │ │ +0002be40: 2020 6269 6e5f 5052 4f47 5241 4d53 203d bin_PROGRAMS = │ │ │ │ │ +0002be50: 2063 7069 6f20 7061 7820 2428 4d54 290a cpio pax $(MT). │ │ │ │ │ +0002be60: 2020 2020 206c 6962 6578 6563 5f50 524f libexec_PRO │ │ │ │ │ +0002be70: 4752 414d 5320 3d20 2428 524d 5429 0a20 GRAMS = $(RMT). │ │ │ │ │ +0002be80: 2020 2020 4558 5452 415f 5052 4f47 5241 EXTRA_PROGRA │ │ │ │ │ +0002be90: 4d53 203d 206d 7420 726d 740a 0a20 2020 MS = mt rmt.. │ │ │ │ │ +0002bea0: 4173 2065 7870 6c61 696e 6564 2069 6e20 As explained in │ │ │ │ │ +0002beb0: 2a6e 6f74 6520 4558 4545 5854 3a3a 2c20 *note EXEEXT::, │ │ │ │ │ +0002bec0: 4175 746f 6d61 6b65 2077 696c 6c20 7265 Automake will re │ │ │ │ │ +0002bed0: 7772 6974 6520 2762 696e 5f50 524f 4752 write 'bin_PROGR │ │ │ │ │ +0002bee0: 414d 5327 2c0a 276c 6962 6578 6563 5f50 AMS',.'libexec_P │ │ │ │ │ +0002bef0: 524f 4752 414d 5327 2c20 616e 6420 2745 ROGRAMS', and 'E │ │ │ │ │ +0002bf00: 5854 5241 5f50 524f 4752 414d 5327 2c20 XTRA_PROGRAMS', │ │ │ │ │ +0002bf10: 6170 7065 6e64 696e 6720 2724 2845 5845 appending '$(EXE │ │ │ │ │ +0002bf20: 4558 5429 2720 746f 2065 6163 680a 6269 EXT)' to each.bi │ │ │ │ │ +0002bf30: 6e61 7279 2e20 204f 6276 696f 7573 6c79 nary. Obviously │ │ │ │ │ +0002bf40: 2069 7420 6361 6e6e 6f74 2072 6577 7269 it cannot rewri │ │ │ │ │ +0002bf50: 7465 2076 616c 7565 7320 6f62 7461 696e te values obtain │ │ │ │ │ +0002bf60: 6564 2061 7420 7275 6e2d 7469 6d65 2074 ed at run-time t │ │ │ │ │ +0002bf70: 6872 6f75 6768 0a27 636f 6e66 6967 7572 hrough.'configur │ │ │ │ │ +0002bf80: 6527 2073 7562 7374 6974 7574 696f 6e73 e' substitutions │ │ │ │ │ +0002bf90: 2c20 7468 6572 6566 6f72 6520 796f 7520 , therefore you │ │ │ │ │ +0002bfa0: 7368 6f75 6c64 2074 616b 6520 6361 7265 should take care │ │ │ │ │ +0002bfb0: 206f 6620 6170 7065 6e64 696e 670a 2724 of appending.'$ │ │ │ │ │ +0002bfc0: 2845 5845 4558 5429 2720 796f 7572 7365 (EXEEXT)' yourse │ │ │ │ │ +0002bfd0: 6c66 2c20 6173 2069 6e20 2741 435f 5355 lf, as in 'AC_SU │ │ │ │ │ +0002bfe0: 4253 5428 5b4d 545d 2c20 5b27 6d74 247b BST([MT], ['mt${ │ │ │ │ │ +0002bff0: 4558 4545 5854 7d27 5d29 272e 0a0a 436f EXEEXT}'])'...Co │ │ │ │ │ +0002c000: 6e64 6974 696f 6e61 6c20 5072 6f67 7261 nditional Progra │ │ │ │ │ +0002c010: 6d73 2075 7369 6e67 2041 7574 6f6d 616b ms using Automak │ │ │ │ │ +0002c020: 6520 436f 6e64 6974 696f 6e61 6c73 0a2e e Conditionals.. │ │ │ │ │ 0002c030: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 0002c040: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0002c050: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a59 ...............Y │ │ │ │ │ -0002c060: 6f75 2063 616e 2061 6c73 6f20 7573 6520 ou can also use │ │ │ │ │ -0002c070: 4175 746f 6d61 6b65 2063 6f6e 6469 7469 Automake conditi │ │ │ │ │ -0002c080: 6f6e 616c 7320 282a 6e6f 7465 2043 6f6e onals (*note Con │ │ │ │ │ -0002c090: 6469 7469 6f6e 616c 733a 3a29 2074 6f20 ditionals::) to │ │ │ │ │ -0002c0a0: 7365 6c65 6374 0a70 726f 6772 616d 7320 select.programs │ │ │ │ │ -0002c0b0: 746f 2062 6520 6275 696c 742e 2020 496e to be built. In │ │ │ │ │ -0002c0c0: 2074 6869 7320 6361 7365 2079 6f75 2064 this case you d │ │ │ │ │ -0002c0d0: 6f6e 2774 2068 6176 6520 746f 2077 6f72 on't have to wor │ │ │ │ │ -0002c0e0: 7279 2061 626f 7574 0a27 2428 4558 4545 ry about.'$(EXEE │ │ │ │ │ -0002c0f0: 5854 2927 206f 7220 2745 5854 5241 5f50 XT)' or 'EXTRA_P │ │ │ │ │ -0002c100: 524f 4752 414d 5327 2e0a 0a20 2020 2020 ROGRAMS'... │ │ │ │ │ -0002c110: 6269 6e5f 5052 4f47 5241 4d53 203d 2063 bin_PROGRAMS = c │ │ │ │ │ -0002c120: 7069 6f20 7061 780a 2020 2020 2069 6620 pio pax. if │ │ │ │ │ -0002c130: 5741 4e54 5f4d 540a 2020 2020 2020 2062 WANT_MT. b │ │ │ │ │ -0002c140: 696e 5f50 524f 4752 414d 5320 2b3d 206d in_PROGRAMS += m │ │ │ │ │ -0002c150: 740a 2020 2020 2065 6e64 6966 0a20 2020 t. endif. │ │ │ │ │ -0002c160: 2020 6966 2057 414e 545f 524d 540a 2020 if WANT_RMT. │ │ │ │ │ -0002c170: 2020 2020 206c 6962 6578 6563 5f50 524f libexec_PRO │ │ │ │ │ -0002c180: 4752 414d 5320 3d20 726d 740a 2020 2020 GRAMS = rmt. │ │ │ │ │ -0002c190: 2065 6e64 6966 0a0a 1f0a 4669 6c65 3a20 endif....File: │ │ │ │ │ -0002c1a0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -0002c1b0: 666f 2c20 204e 6f64 653a 2041 204c 6962 fo, Node: A Lib │ │ │ │ │ -0002c1c0: 7261 7279 2c20 204e 6578 743a 2041 2053 rary, Next: A S │ │ │ │ │ -0002c1d0: 6861 7265 6420 4c69 6272 6172 792c 2020 hared Library, │ │ │ │ │ -0002c1e0: 5072 6576 3a20 4120 5072 6f67 7261 6d2c Prev: A Program, │ │ │ │ │ -0002c1f0: 2020 5570 3a20 5072 6f67 7261 6d73 0a0a Up: Programs.. │ │ │ │ │ -0002c200: 382e 3220 4275 696c 6469 6e67 2061 206c 8.2 Building a l │ │ │ │ │ -0002c210: 6962 7261 7279 0a3d 3d3d 3d3d 3d3d 3d3d ibrary.========= │ │ │ │ │ -0002c220: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a42 =============..B │ │ │ │ │ -0002c230: 7569 6c64 696e 6720 6120 6c69 6272 6172 uilding a librar │ │ │ │ │ -0002c240: 7920 6973 206d 7563 6820 6c69 6b65 2062 y is much like b │ │ │ │ │ -0002c250: 7569 6c64 696e 6720 6120 7072 6f67 7261 uilding a progra │ │ │ │ │ -0002c260: 6d2e 2020 496e 2074 6869 7320 6361 7365 m. In this case │ │ │ │ │ -0002c270: 2c20 7468 650a 6e61 6d65 206f 6620 7468 , the.name of th │ │ │ │ │ -0002c280: 6520 7072 696d 6172 7920 6973 2027 4c49 e primary is 'LI │ │ │ │ │ -0002c290: 4252 4152 4945 5327 2e20 204c 6962 7261 BRARIES'. Libra │ │ │ │ │ -0002c2a0: 7269 6573 2063 616e 2062 6520 696e 7374 ries can be inst │ │ │ │ │ -0002c2b0: 616c 6c65 6420 696e 0a27 6c69 6264 6972 alled in.'libdir │ │ │ │ │ -0002c2c0: 2720 6f72 2027 706b 676c 6962 6469 7227 ' or 'pkglibdir' │ │ │ │ │ -0002c2d0: 2e0a 0a20 2020 2a4e 6f74 6520 4120 5368 ... *Note A Sh │ │ │ │ │ -0002c2e0: 6172 6564 204c 6962 7261 7279 3a3a 2c20 ared Library::, │ │ │ │ │ -0002c2f0: 666f 7220 696e 666f 726d 6174 696f 6e20 for information │ │ │ │ │ -0002c300: 6f6e 2068 6f77 2074 6f20 6275 696c 6420 on how to build │ │ │ │ │ -0002c310: 7368 6172 6564 0a6c 6962 7261 7269 6573 shared.libraries │ │ │ │ │ -0002c320: 2075 7369 6e67 206c 6962 746f 6f6c 2061 using libtool a │ │ │ │ │ -0002c330: 6e64 2074 6865 2027 4c54 4c49 4252 4152 nd the 'LTLIBRAR │ │ │ │ │ -0002c340: 4945 5327 2070 7269 6d61 7279 2e0a 0a20 IES' primary... │ │ │ │ │ -0002c350: 2020 4561 6368 2027 5f4c 4942 5241 5249 Each '_LIBRARI │ │ │ │ │ -0002c360: 4553 2720 7661 7269 6162 6c65 2069 7320 ES' variable is │ │ │ │ │ -0002c370: 6120 6c69 7374 206f 6620 7468 6520 6c69 a list of the li │ │ │ │ │ -0002c380: 6272 6172 6965 7320 746f 2062 6520 6275 braries to be bu │ │ │ │ │ -0002c390: 696c 742e 0a46 6f72 2069 6e73 7461 6e63 ilt..For instanc │ │ │ │ │ -0002c3a0: 652c 2074 6f20 6372 6561 7465 2061 206c e, to create a l │ │ │ │ │ -0002c3b0: 6962 7261 7279 206e 616d 6564 2027 6c69 ibrary named 'li │ │ │ │ │ -0002c3c0: 6263 7069 6f2e 6127 2c20 6275 7420 6e6f bcpio.a', but no │ │ │ │ │ -0002c3d0: 7420 696e 7374 616c 6c20 6974 2c0a 796f t install it,.yo │ │ │ │ │ -0002c3e0: 7520 776f 756c 6420 7772 6974 653a 0a0a u would write:.. │ │ │ │ │ -0002c3f0: 2020 2020 206e 6f69 6e73 745f 4c49 4252 noinst_LIBR │ │ │ │ │ -0002c400: 4152 4945 5320 3d20 6c69 6263 7069 6f2e ARIES = libcpio. │ │ │ │ │ -0002c410: 610a 2020 2020 206c 6962 6370 696f 5f61 a. libcpio_a │ │ │ │ │ -0002c420: 5f53 4f55 5243 4553 203d 202e 2e2e 0a0a _SOURCES = ..... │ │ │ │ │ -0002c430: 2020 2054 6865 2073 6f75 7263 6573 2074 The sources t │ │ │ │ │ -0002c440: 6861 7420 676f 2069 6e74 6f20 6120 6c69 hat go into a li │ │ │ │ │ -0002c450: 6272 6172 7920 6172 6520 6465 7465 726d brary are determ │ │ │ │ │ -0002c460: 696e 6564 2065 7861 6374 6c79 2061 7320 ined exactly as │ │ │ │ │ -0002c470: 7468 6579 2061 7265 0a66 6f72 2070 726f they are.for pro │ │ │ │ │ -0002c480: 6772 616d 732c 2076 6961 2074 6865 2027 grams, via the ' │ │ │ │ │ -0002c490: 5f53 4f55 5243 4553 2720 7661 7269 6162 _SOURCES' variab │ │ │ │ │ -0002c4a0: 6c65 732e 2020 4e6f 7465 2074 6861 7420 les. Note that │ │ │ │ │ -0002c4b0: 7468 6520 6c69 6272 6172 7920 6e61 6d65 the library name │ │ │ │ │ -0002c4c0: 0a69 7320 6361 6e6f 6e69 6361 6c69 7a65 .is canonicalize │ │ │ │ │ -0002c4d0: 6420 282a 6e6f 7465 2043 616e 6f6e 6963 d (*note Canonic │ │ │ │ │ -0002c4e0: 616c 697a 6174 696f 6e3a 3a29 2c20 736f alization::), so │ │ │ │ │ -0002c4f0: 2074 6865 2027 5f53 4f55 5243 4553 2720 the '_SOURCES' │ │ │ │ │ -0002c500: 7661 7269 6162 6c65 0a63 6f72 7265 7370 variable.corresp │ │ │ │ │ -0002c510: 6f6e 6469 6e67 2074 6f20 276c 6962 6370 onding to 'libcp │ │ │ │ │ -0002c520: 696f 2e61 2720 6973 2027 6c69 6263 7069 io.a' is 'libcpi │ │ │ │ │ -0002c530: 6f5f 615f 534f 5552 4345 5327 2c20 6e6f o_a_SOURCES', no │ │ │ │ │ -0002c540: 740a 276c 6962 6370 696f 2e61 5f53 4f55 t.'libcpio.a_SOU │ │ │ │ │ -0002c550: 5243 4553 272e 0a0a 2020 2045 7874 7261 RCES'... Extra │ │ │ │ │ -0002c560: 206f 626a 6563 7473 2063 616e 2062 6520 objects can be │ │ │ │ │ -0002c570: 6164 6465 6420 746f 2061 206c 6962 7261 added to a libra │ │ │ │ │ -0002c580: 7279 2075 7369 6e67 2074 6865 2027 4c49 ry using the 'LI │ │ │ │ │ -0002c590: 4252 4152 595f 4c49 4241 4444 270a 7661 BRARY_LIBADD'.va │ │ │ │ │ -0002c5a0: 7269 6162 6c65 2e20 2054 6869 7320 7368 riable. This sh │ │ │ │ │ -0002c5b0: 6f75 6c64 2062 6520 7573 6564 2066 6f72 ould be used for │ │ │ │ │ -0002c5c0: 206f 626a 6563 7473 2064 6574 6572 6d69 objects determi │ │ │ │ │ -0002c5d0: 6e65 6420 6279 2027 636f 6e66 6967 7572 ned by 'configur │ │ │ │ │ -0002c5e0: 6527 2e0a 4167 6169 6e20 6672 6f6d 2027 e'..Again from ' │ │ │ │ │ -0002c5f0: 6370 696f 273a 0a0a 2020 2020 206c 6962 cpio':.. lib │ │ │ │ │ -0002c600: 6370 696f 5f61 5f4c 4942 4144 4420 3d20 cpio_a_LIBADD = │ │ │ │ │ -0002c610: 2428 4c49 424f 424a 5329 2024 2841 4c4c $(LIBOBJS) $(ALL │ │ │ │ │ -0002c620: 4f43 4129 0a0a 2020 2049 6e20 6164 6469 OCA).. In addi │ │ │ │ │ -0002c630: 7469 6f6e 2c20 736f 7572 6365 7320 666f tion, sources fo │ │ │ │ │ -0002c640: 7220 6578 7472 6120 6f62 6a65 6374 7320 r extra objects │ │ │ │ │ -0002c650: 7468 6174 2077 696c 6c20 6e6f 7420 6578 that will not ex │ │ │ │ │ -0002c660: 6973 7420 756e 7469 6c0a 636f 6e66 6967 ist until.config │ │ │ │ │ -0002c670: 7572 652d 7469 6d65 206d 7573 7420 6265 ure-time must be │ │ │ │ │ -0002c680: 2061 6464 6564 2074 6f20 7468 6520 2742 added to the 'B │ │ │ │ │ -0002c690: 5549 4c54 5f53 4f55 5243 4553 2720 7661 UILT_SOURCES' va │ │ │ │ │ -0002c6a0: 7269 6162 6c65 2028 2a6e 6f74 650a 536f riable (*note.So │ │ │ │ │ -0002c6b0: 7572 6365 733a 3a29 2e0a 0a20 2020 4275 urces::)... Bu │ │ │ │ │ -0002c6c0: 696c 6469 6e67 2061 2073 7461 7469 6320 ilding a static │ │ │ │ │ -0002c6d0: 6c69 6272 6172 7920 6973 2064 6f6e 6520 library is done │ │ │ │ │ -0002c6e0: 6279 2063 6f6d 7069 6c69 6e67 2061 6c6c by compiling all │ │ │ │ │ -0002c6f0: 206f 626a 6563 7420 6669 6c65 732c 2074 object files, t │ │ │ │ │ -0002c700: 6865 6e0a 6279 2069 6e76 6f6b 696e 6720 hen.by invoking │ │ │ │ │ -0002c710: 2724 2841 5229 2024 2841 5246 4c41 4753 '$(AR) $(ARFLAGS │ │ │ │ │ -0002c720: 2927 2066 6f6c 6c6f 7765 6420 6279 2074 )' followed by t │ │ │ │ │ -0002c730: 6865 206e 616d 6520 6f66 2074 6865 206c he name of the l │ │ │ │ │ -0002c740: 6962 7261 7279 2061 6e64 0a74 6865 206c ibrary and.the l │ │ │ │ │ -0002c750: 6973 7420 6f66 206f 626a 6563 7473 2c20 ist of objects, │ │ │ │ │ -0002c760: 616e 6420 6669 6e61 6c6c 7920 6279 2063 and finally by c │ │ │ │ │ -0002c770: 616c 6c69 6e67 2027 2428 5241 4e4c 4942 alling '$(RANLIB │ │ │ │ │ -0002c780: 2927 206f 6e20 7468 6174 206c 6962 7261 )' on that libra │ │ │ │ │ -0002c790: 7279 2e0a 596f 7520 7368 6f75 6c64 2063 ry..You should c │ │ │ │ │ -0002c7a0: 616c 6c20 2741 435f 5052 4f47 5f52 414e all 'AC_PROG_RAN │ │ │ │ │ -0002c7b0: 4c49 4227 2066 726f 6d20 796f 7572 2027 LIB' from your ' │ │ │ │ │ -0002c7c0: 636f 6e66 6967 7572 652e 6163 2720 746f configure.ac' to │ │ │ │ │ -0002c7d0: 2064 6566 696e 650a 2752 414e 4c49 4227 define.'RANLIB' │ │ │ │ │ -0002c7e0: 2028 4175 746f 6d61 6b65 2077 696c 6c20 (Automake will │ │ │ │ │ -0002c7f0: 636f 6d70 6c61 696e 206f 7468 6572 7769 complain otherwi │ │ │ │ │ -0002c800: 7365 292e 2020 596f 7520 7368 6f75 6c64 se). You should │ │ │ │ │ -0002c810: 2061 6c73 6f20 6361 6c6c 0a27 414d 5f50 also call.'AM_P │ │ │ │ │ -0002c820: 524f 475f 4152 2720 746f 2064 6566 696e ROG_AR' to defin │ │ │ │ │ -0002c830: 6520 2741 5227 2c20 696e 206f 7264 6572 e 'AR', in order │ │ │ │ │ -0002c840: 2074 6f20 7375 7070 6f72 7420 756e 7573 to support unus │ │ │ │ │ -0002c850: 7561 6c20 6172 6368 6976 6572 7320 7375 ual archivers su │ │ │ │ │ -0002c860: 6368 0a61 7320 4d69 6372 6f73 6f66 7420 ch.as Microsoft │ │ │ │ │ -0002c870: 6c69 622e 2020 2741 5246 4c41 4753 2720 lib. 'ARFLAGS' │ │ │ │ │ -0002c880: 7769 6c6c 2064 6566 6175 6c74 2074 6f20 will default to │ │ │ │ │ -0002c890: 2763 7275 273b 2079 6f75 2063 616e 206f 'cru'; you can o │ │ │ │ │ -0002c8a0: 7665 7272 6964 650a 7468 6973 2076 6172 verride.this var │ │ │ │ │ -0002c8b0: 6961 626c 6520 6279 2073 6574 7469 6e67 iable by setting │ │ │ │ │ -0002c8c0: 2069 7420 696e 2079 6f75 7220 274d 616b it in your 'Mak │ │ │ │ │ -0002c8d0: 6566 696c 652e 616d 2720 6f72 2062 7920 efile.am' or by │ │ │ │ │ -0002c8e0: 2741 435f 5355 4253 5427 696e 6720 6974 'AC_SUBST'ing it │ │ │ │ │ -0002c8f0: 0a66 726f 6d20 796f 7572 2027 636f 6e66 .from your 'conf │ │ │ │ │ -0002c900: 6967 7572 652e 6163 272e 2020 596f 7520 igure.ac'. You │ │ │ │ │ -0002c910: 6361 6e20 6f76 6572 7269 6465 2074 6865 can override the │ │ │ │ │ -0002c920: 2027 4152 2720 7661 7269 6162 6c65 2062 'AR' variable b │ │ │ │ │ -0002c930: 790a 6465 6669 6e69 6e67 2061 2070 6572 y.defining a per │ │ │ │ │ -0002c940: 2d6c 6962 7261 7279 2027 6d61 7564 655f -library 'maude_ │ │ │ │ │ -0002c950: 4152 2720 7661 7269 6162 6c65 2028 2a6e AR' variable (*n │ │ │ │ │ -0002c960: 6f74 6520 5072 6f67 7261 6d20 616e 6420 ote Program and │ │ │ │ │ -0002c970: 4c69 6272 6172 790a 5661 7269 6162 6c65 Library.Variable │ │ │ │ │ -0002c980: 733a 3a29 2e0a 0a20 2020 4265 2063 6172 s::)... Be car │ │ │ │ │ -0002c990: 6566 756c 2077 6865 6e20 7365 6c65 6374 eful when select │ │ │ │ │ -0002c9a0: 696e 6720 6c69 6272 6172 7920 636f 6d70 ing library comp │ │ │ │ │ -0002c9b0: 6f6e 656e 7473 2063 6f6e 6469 7469 6f6e onents condition │ │ │ │ │ -0002c9c0: 616c 6c79 2e20 2042 6563 6175 7365 0a62 ally. Because.b │ │ │ │ │ -0002c9d0: 7569 6c64 696e 6720 616e 2065 6d70 7479 uilding an empty │ │ │ │ │ -0002c9e0: 206c 6962 7261 7279 2069 7320 6e6f 7420 library is not │ │ │ │ │ -0002c9f0: 706f 7274 6162 6c65 2c20 796f 7520 7368 portable, you sh │ │ │ │ │ -0002ca00: 6f75 6c64 2065 6e73 7572 6520 7468 6174 ould ensure that │ │ │ │ │ -0002ca10: 2061 6e79 0a6c 6962 7261 7279 2061 6c77 any.library alw │ │ │ │ │ -0002ca20: 6179 7320 636f 6e74 6169 6e73 2061 7420 ays contains at │ │ │ │ │ -0002ca30: 6c65 6173 7420 6f6e 6520 6f62 6a65 6374 least one object │ │ │ │ │ -0002ca40: 2e0a 0a20 2020 546f 2075 7365 2061 2073 ... To use a s │ │ │ │ │ -0002ca50: 7461 7469 6320 6c69 6272 6172 7920 7768 tatic library wh │ │ │ │ │ -0002ca60: 656e 2062 7569 6c64 696e 6720 6120 7072 en building a pr │ │ │ │ │ -0002ca70: 6f67 7261 6d2c 2061 6464 2069 7420 746f ogram, add it to │ │ │ │ │ -0002ca80: 2027 4c44 4144 4427 0a66 6f72 2074 6869 'LDADD'.for thi │ │ │ │ │ -0002ca90: 7320 7072 6f67 7261 6d2e 2020 496e 2074 s program. In t │ │ │ │ │ -0002caa0: 6865 2066 6f6c 6c6f 7769 6e67 2065 7861 he following exa │ │ │ │ │ -0002cab0: 6d70 6c65 2c20 7468 6520 7072 6f67 7261 mple, the progra │ │ │ │ │ -0002cac0: 6d20 2763 7069 6f27 2069 730a 7374 6174 m 'cpio' is.stat │ │ │ │ │ -0002cad0: 6963 616c 6c79 206c 696e 6b65 6420 7769 ically linked wi │ │ │ │ │ -0002cae0: 7468 2074 6865 206c 6962 7261 7279 2027 th the library ' │ │ │ │ │ -0002caf0: 6c69 6263 7069 6f2e 6127 2e0a 0a20 2020 libcpio.a'... │ │ │ │ │ -0002cb00: 2020 6e6f 696e 7374 5f4c 4942 5241 5249 noinst_LIBRARI │ │ │ │ │ -0002cb10: 4553 203d 206c 6962 6370 696f 2e61 0a20 ES = libcpio.a. │ │ │ │ │ -0002cb20: 2020 2020 6c69 6263 7069 6f5f 615f 534f libcpio_a_SO │ │ │ │ │ -0002cb30: 5552 4345 5320 3d20 2e2e 2e0a 0a20 2020 URCES = ..... │ │ │ │ │ -0002cb40: 2020 6269 6e5f 5052 4f47 5241 4d53 203d bin_PROGRAMS = │ │ │ │ │ -0002cb50: 2063 7069 6f0a 2020 2020 2063 7069 6f5f cpio. cpio_ │ │ │ │ │ -0002cb60: 534f 5552 4345 5320 3d20 6370 696f 2e63 SOURCES = cpio.c │ │ │ │ │ -0002cb70: 202e 2e2e 0a20 2020 2020 6370 696f 5f4c .... cpio_L │ │ │ │ │ -0002cb80: 4441 4444 203d 206c 6962 6370 696f 2e61 DADD = libcpio.a │ │ │ │ │ -0002cb90: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -0002cba0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -0002cbb0: 6f64 653a 2041 2053 6861 7265 6420 4c69 ode: A Shared Li │ │ │ │ │ -0002cbc0: 6272 6172 792c 2020 4e65 7874 3a20 5072 brary, Next: Pr │ │ │ │ │ -0002cbd0: 6f67 7261 6d20 616e 6420 4c69 6272 6172 ogram and Librar │ │ │ │ │ -0002cbe0: 7920 5661 7269 6162 6c65 732c 2020 5072 y Variables, Pr │ │ │ │ │ -0002cbf0: 6576 3a20 4120 4c69 6272 6172 792c 2020 ev: A Library, │ │ │ │ │ -0002cc00: 5570 3a20 5072 6f67 7261 6d73 0a0a 382e Up: Programs..8. │ │ │ │ │ -0002cc10: 3320 4275 696c 6469 6e67 2061 2053 6861 3 Building a Sha │ │ │ │ │ -0002cc20: 7265 6420 4c69 6272 6172 790a 3d3d 3d3d red Library.==== │ │ │ │ │ +0002c050: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a ................ │ │ │ │ │ +0002c060: 0a59 6f75 2063 616e 2061 6c73 6f20 7573 .You can also us │ │ │ │ │ +0002c070: 6520 4175 746f 6d61 6b65 2063 6f6e 6469 e Automake condi │ │ │ │ │ +0002c080: 7469 6f6e 616c 7320 282a 6e6f 7465 2043 tionals (*note C │ │ │ │ │ +0002c090: 6f6e 6469 7469 6f6e 616c 733a 3a29 2074 onditionals::) t │ │ │ │ │ +0002c0a0: 6f20 7365 6c65 6374 0a70 726f 6772 616d o select.program │ │ │ │ │ +0002c0b0: 7320 746f 2062 6520 6275 696c 742e 2020 s to be built. │ │ │ │ │ +0002c0c0: 496e 2074 6869 7320 6361 7365 2079 6f75 In this case you │ │ │ │ │ +0002c0d0: 2064 6f6e 2774 2068 6176 6520 746f 2077 don't have to w │ │ │ │ │ +0002c0e0: 6f72 7279 2061 626f 7574 0a27 2428 4558 orry about.'$(EX │ │ │ │ │ +0002c0f0: 4545 5854 2927 206f 7220 2745 5854 5241 EEXT)' or 'EXTRA │ │ │ │ │ +0002c100: 5f50 524f 4752 414d 5327 2e0a 0a20 2020 _PROGRAMS'... │ │ │ │ │ +0002c110: 2020 6269 6e5f 5052 4f47 5241 4d53 203d bin_PROGRAMS = │ │ │ │ │ +0002c120: 2063 7069 6f20 7061 780a 2020 2020 2069 cpio pax. i │ │ │ │ │ +0002c130: 6620 5741 4e54 5f4d 540a 2020 2020 2020 f WANT_MT. │ │ │ │ │ +0002c140: 2062 696e 5f50 524f 4752 414d 5320 2b3d bin_PROGRAMS += │ │ │ │ │ +0002c150: 206d 740a 2020 2020 2065 6e64 6966 0a20 mt. endif. │ │ │ │ │ +0002c160: 2020 2020 6966 2057 414e 545f 524d 540a if WANT_RMT. │ │ │ │ │ +0002c170: 2020 2020 2020 206c 6962 6578 6563 5f50 libexec_P │ │ │ │ │ +0002c180: 524f 4752 414d 5320 3d20 726d 740a 2020 ROGRAMS = rmt. │ │ │ │ │ +0002c190: 2020 2065 6e64 6966 0a0a 1f0a 4669 6c65 endif....File │ │ │ │ │ +0002c1a0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +0002c1b0: 696e 666f 2c20 204e 6f64 653a 2041 204c info, Node: A L │ │ │ │ │ +0002c1c0: 6962 7261 7279 2c20 204e 6578 743a 2041 ibrary, Next: A │ │ │ │ │ +0002c1d0: 2053 6861 7265 6420 4c69 6272 6172 792c Shared Library, │ │ │ │ │ +0002c1e0: 2020 5072 6576 3a20 4120 5072 6f67 7261 Prev: A Progra │ │ │ │ │ +0002c1f0: 6d2c 2020 5570 3a20 5072 6f67 7261 6d73 m, Up: Programs │ │ │ │ │ +0002c200: 0a0a 382e 3220 4275 696c 6469 6e67 2061 ..8.2 Building a │ │ │ │ │ +0002c210: 206c 6962 7261 7279 0a3d 3d3d 3d3d 3d3d library.======= │ │ │ │ │ +0002c220: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +0002c230: 0a42 7569 6c64 696e 6720 6120 6c69 6272 .Building a libr │ │ │ │ │ +0002c240: 6172 7920 6973 206d 7563 6820 6c69 6b65 ary is much like │ │ │ │ │ +0002c250: 2062 7569 6c64 696e 6720 6120 7072 6f67 building a prog │ │ │ │ │ +0002c260: 7261 6d2e 2020 496e 2074 6869 7320 6361 ram. In this ca │ │ │ │ │ +0002c270: 7365 2c20 7468 650a 6e61 6d65 206f 6620 se, the.name of │ │ │ │ │ +0002c280: 7468 6520 7072 696d 6172 7920 6973 2027 the primary is ' │ │ │ │ │ +0002c290: 4c49 4252 4152 4945 5327 2e20 204c 6962 LIBRARIES'. Lib │ │ │ │ │ +0002c2a0: 7261 7269 6573 2063 616e 2062 6520 696e raries can be in │ │ │ │ │ +0002c2b0: 7374 616c 6c65 6420 696e 0a27 6c69 6264 stalled in.'libd │ │ │ │ │ +0002c2c0: 6972 2720 6f72 2027 706b 676c 6962 6469 ir' or 'pkglibdi │ │ │ │ │ +0002c2d0: 7227 2e0a 0a20 2020 2a4e 6f74 6520 4120 r'... *Note A │ │ │ │ │ +0002c2e0: 5368 6172 6564 204c 6962 7261 7279 3a3a Shared Library:: │ │ │ │ │ +0002c2f0: 2c20 666f 7220 696e 666f 726d 6174 696f , for informatio │ │ │ │ │ +0002c300: 6e20 6f6e 2068 6f77 2074 6f20 6275 696c n on how to buil │ │ │ │ │ +0002c310: 6420 7368 6172 6564 0a6c 6962 7261 7269 d shared.librari │ │ │ │ │ +0002c320: 6573 2075 7369 6e67 206c 6962 746f 6f6c es using libtool │ │ │ │ │ +0002c330: 2061 6e64 2074 6865 2027 4c54 4c49 4252 and the 'LTLIBR │ │ │ │ │ +0002c340: 4152 4945 5327 2070 7269 6d61 7279 2e0a ARIES' primary.. │ │ │ │ │ +0002c350: 0a20 2020 4561 6368 2027 5f4c 4942 5241 . Each '_LIBRA │ │ │ │ │ +0002c360: 5249 4553 2720 7661 7269 6162 6c65 2069 RIES' variable i │ │ │ │ │ +0002c370: 7320 6120 6c69 7374 206f 6620 7468 6520 s a list of the │ │ │ │ │ +0002c380: 6c69 6272 6172 6965 7320 746f 2062 6520 libraries to be │ │ │ │ │ +0002c390: 6275 696c 742e 0a46 6f72 2069 6e73 7461 built..For insta │ │ │ │ │ +0002c3a0: 6e63 652c 2074 6f20 6372 6561 7465 2061 nce, to create a │ │ │ │ │ +0002c3b0: 206c 6962 7261 7279 206e 616d 6564 2027 library named ' │ │ │ │ │ +0002c3c0: 6c69 6263 7069 6f2e 6127 2c20 6275 7420 libcpio.a', but │ │ │ │ │ +0002c3d0: 6e6f 7420 696e 7374 616c 6c20 6974 2c0a not install it,. │ │ │ │ │ +0002c3e0: 796f 7520 776f 756c 6420 7772 6974 653a you would write: │ │ │ │ │ +0002c3f0: 0a0a 2020 2020 206e 6f69 6e73 745f 4c49 .. noinst_LI │ │ │ │ │ +0002c400: 4252 4152 4945 5320 3d20 6c69 6263 7069 BRARIES = libcpi │ │ │ │ │ +0002c410: 6f2e 610a 2020 2020 206c 6962 6370 696f o.a. libcpio │ │ │ │ │ +0002c420: 5f61 5f53 4f55 5243 4553 203d 202e 2e2e _a_SOURCES = ... │ │ │ │ │ +0002c430: 0a0a 2020 2054 6865 2073 6f75 7263 6573 .. The sources │ │ │ │ │ +0002c440: 2074 6861 7420 676f 2069 6e74 6f20 6120 that go into a │ │ │ │ │ +0002c450: 6c69 6272 6172 7920 6172 6520 6465 7465 library are dete │ │ │ │ │ +0002c460: 726d 696e 6564 2065 7861 6374 6c79 2061 rmined exactly a │ │ │ │ │ +0002c470: 7320 7468 6579 2061 7265 0a66 6f72 2070 s they are.for p │ │ │ │ │ +0002c480: 726f 6772 616d 732c 2076 6961 2074 6865 rograms, via the │ │ │ │ │ +0002c490: 2027 5f53 4f55 5243 4553 2720 7661 7269 '_SOURCES' vari │ │ │ │ │ +0002c4a0: 6162 6c65 732e 2020 4e6f 7465 2074 6861 ables. Note tha │ │ │ │ │ +0002c4b0: 7420 7468 6520 6c69 6272 6172 7920 6e61 t the library na │ │ │ │ │ +0002c4c0: 6d65 0a69 7320 6361 6e6f 6e69 6361 6c69 me.is canonicali │ │ │ │ │ +0002c4d0: 7a65 6420 282a 6e6f 7465 2043 616e 6f6e zed (*note Canon │ │ │ │ │ +0002c4e0: 6963 616c 697a 6174 696f 6e3a 3a29 2c20 icalization::), │ │ │ │ │ +0002c4f0: 736f 2074 6865 2027 5f53 4f55 5243 4553 so the '_SOURCES │ │ │ │ │ +0002c500: 2720 7661 7269 6162 6c65 0a63 6f72 7265 ' variable.corre │ │ │ │ │ +0002c510: 7370 6f6e 6469 6e67 2074 6f20 276c 6962 sponding to 'lib │ │ │ │ │ +0002c520: 6370 696f 2e61 2720 6973 2027 6c69 6263 cpio.a' is 'libc │ │ │ │ │ +0002c530: 7069 6f5f 615f 534f 5552 4345 5327 2c20 pio_a_SOURCES', │ │ │ │ │ +0002c540: 6e6f 740a 276c 6962 6370 696f 2e61 5f53 not.'libcpio.a_S │ │ │ │ │ +0002c550: 4f55 5243 4553 272e 0a0a 2020 2045 7874 OURCES'... Ext │ │ │ │ │ +0002c560: 7261 206f 626a 6563 7473 2063 616e 2062 ra objects can b │ │ │ │ │ +0002c570: 6520 6164 6465 6420 746f 2061 206c 6962 e added to a lib │ │ │ │ │ +0002c580: 7261 7279 2075 7369 6e67 2074 6865 2027 rary using the ' │ │ │ │ │ +0002c590: 4c49 4252 4152 595f 4c49 4241 4444 270a LIBRARY_LIBADD'. │ │ │ │ │ +0002c5a0: 7661 7269 6162 6c65 2e20 2054 6869 7320 variable. This │ │ │ │ │ +0002c5b0: 7368 6f75 6c64 2062 6520 7573 6564 2066 should be used f │ │ │ │ │ +0002c5c0: 6f72 206f 626a 6563 7473 2064 6574 6572 or objects deter │ │ │ │ │ +0002c5d0: 6d69 6e65 6420 6279 2027 636f 6e66 6967 mined by 'config │ │ │ │ │ +0002c5e0: 7572 6527 2e0a 4167 6169 6e20 6672 6f6d ure'..Again from │ │ │ │ │ +0002c5f0: 2027 6370 696f 273a 0a0a 2020 2020 206c 'cpio':.. l │ │ │ │ │ +0002c600: 6962 6370 696f 5f61 5f4c 4942 4144 4420 ibcpio_a_LIBADD │ │ │ │ │ +0002c610: 3d20 2428 4c49 424f 424a 5329 2024 2841 = $(LIBOBJS) $(A │ │ │ │ │ +0002c620: 4c4c 4f43 4129 0a0a 2020 2049 6e20 6164 LLOCA).. In ad │ │ │ │ │ +0002c630: 6469 7469 6f6e 2c20 736f 7572 6365 7320 dition, sources │ │ │ │ │ +0002c640: 666f 7220 6578 7472 6120 6f62 6a65 6374 for extra object │ │ │ │ │ +0002c650: 7320 7468 6174 2077 696c 6c20 6e6f 7420 s that will not │ │ │ │ │ +0002c660: 6578 6973 7420 756e 7469 6c0a 636f 6e66 exist until.conf │ │ │ │ │ +0002c670: 6967 7572 652d 7469 6d65 206d 7573 7420 igure-time must │ │ │ │ │ +0002c680: 6265 2061 6464 6564 2074 6f20 7468 6520 be added to the │ │ │ │ │ +0002c690: 2742 5549 4c54 5f53 4f55 5243 4553 2720 'BUILT_SOURCES' │ │ │ │ │ +0002c6a0: 7661 7269 6162 6c65 2028 2a6e 6f74 650a variable (*note. │ │ │ │ │ +0002c6b0: 536f 7572 6365 733a 3a29 2e0a 0a20 2020 Sources::)... │ │ │ │ │ +0002c6c0: 4275 696c 6469 6e67 2061 2073 7461 7469 Building a stati │ │ │ │ │ +0002c6d0: 6320 6c69 6272 6172 7920 6973 2064 6f6e c library is don │ │ │ │ │ +0002c6e0: 6520 6279 2063 6f6d 7069 6c69 6e67 2061 e by compiling a │ │ │ │ │ +0002c6f0: 6c6c 206f 626a 6563 7420 6669 6c65 732c ll object files, │ │ │ │ │ +0002c700: 2074 6865 6e0a 6279 2069 6e76 6f6b 696e then.by invokin │ │ │ │ │ +0002c710: 6720 2724 2841 5229 2024 2841 5246 4c41 g '$(AR) $(ARFLA │ │ │ │ │ +0002c720: 4753 2927 2066 6f6c 6c6f 7765 6420 6279 GS)' followed by │ │ │ │ │ +0002c730: 2074 6865 206e 616d 6520 6f66 2074 6865 the name of the │ │ │ │ │ +0002c740: 206c 6962 7261 7279 2061 6e64 0a74 6865 library and.the │ │ │ │ │ +0002c750: 206c 6973 7420 6f66 206f 626a 6563 7473 list of objects │ │ │ │ │ +0002c760: 2c20 616e 6420 6669 6e61 6c6c 7920 6279 , and finally by │ │ │ │ │ +0002c770: 2063 616c 6c69 6e67 2027 2428 5241 4e4c calling '$(RANL │ │ │ │ │ +0002c780: 4942 2927 206f 6e20 7468 6174 206c 6962 IB)' on that lib │ │ │ │ │ +0002c790: 7261 7279 2e0a 596f 7520 7368 6f75 6c64 rary..You should │ │ │ │ │ +0002c7a0: 2063 616c 6c20 2741 435f 5052 4f47 5f52 call 'AC_PROG_R │ │ │ │ │ +0002c7b0: 414e 4c49 4227 2066 726f 6d20 796f 7572 ANLIB' from your │ │ │ │ │ +0002c7c0: 2027 636f 6e66 6967 7572 652e 6163 2720 'configure.ac' │ │ │ │ │ +0002c7d0: 746f 2064 6566 696e 650a 2752 414e 4c49 to define.'RANLI │ │ │ │ │ +0002c7e0: 4227 2028 4175 746f 6d61 6b65 2077 696c B' (Automake wil │ │ │ │ │ +0002c7f0: 6c20 636f 6d70 6c61 696e 206f 7468 6572 l complain other │ │ │ │ │ +0002c800: 7769 7365 292e 2020 596f 7520 7368 6f75 wise). You shou │ │ │ │ │ +0002c810: 6c64 2061 6c73 6f20 6361 6c6c 0a27 414d ld also call.'AM │ │ │ │ │ +0002c820: 5f50 524f 475f 4152 2720 746f 2064 6566 _PROG_AR' to def │ │ │ │ │ +0002c830: 696e 6520 2741 5227 2c20 696e 206f 7264 ine 'AR', in ord │ │ │ │ │ +0002c840: 6572 2074 6f20 7375 7070 6f72 7420 756e er to support un │ │ │ │ │ +0002c850: 7573 7561 6c20 6172 6368 6976 6572 7320 usual archivers │ │ │ │ │ +0002c860: 7375 6368 0a61 7320 4d69 6372 6f73 6f66 such.as Microsof │ │ │ │ │ +0002c870: 7420 6c69 622e 2020 2741 5246 4c41 4753 t lib. 'ARFLAGS │ │ │ │ │ +0002c880: 2720 7769 6c6c 2064 6566 6175 6c74 2074 ' will default t │ │ │ │ │ +0002c890: 6f20 2763 7275 273b 2079 6f75 2063 616e o 'cru'; you can │ │ │ │ │ +0002c8a0: 206f 7665 7272 6964 650a 7468 6973 2076 override.this v │ │ │ │ │ +0002c8b0: 6172 6961 626c 6520 6279 2073 6574 7469 ariable by setti │ │ │ │ │ +0002c8c0: 6e67 2069 7420 696e 2079 6f75 7220 274d ng it in your 'M │ │ │ │ │ +0002c8d0: 616b 6566 696c 652e 616d 2720 6f72 2062 akefile.am' or b │ │ │ │ │ +0002c8e0: 7920 2741 435f 5355 4253 5427 696e 6720 y 'AC_SUBST'ing │ │ │ │ │ +0002c8f0: 6974 0a66 726f 6d20 796f 7572 2027 636f it.from your 'co │ │ │ │ │ +0002c900: 6e66 6967 7572 652e 6163 272e 2020 596f nfigure.ac'. Yo │ │ │ │ │ +0002c910: 7520 6361 6e20 6f76 6572 7269 6465 2074 u can override t │ │ │ │ │ +0002c920: 6865 2027 4152 2720 7661 7269 6162 6c65 he 'AR' variable │ │ │ │ │ +0002c930: 2062 790a 6465 6669 6e69 6e67 2061 2070 by.defining a p │ │ │ │ │ +0002c940: 6572 2d6c 6962 7261 7279 2027 6d61 7564 er-library 'maud │ │ │ │ │ +0002c950: 655f 4152 2720 7661 7269 6162 6c65 2028 e_AR' variable ( │ │ │ │ │ +0002c960: 2a6e 6f74 6520 5072 6f67 7261 6d20 616e *note Program an │ │ │ │ │ +0002c970: 6420 4c69 6272 6172 790a 5661 7269 6162 d Library.Variab │ │ │ │ │ +0002c980: 6c65 733a 3a29 2e0a 0a20 2020 4265 2063 les::)... Be c │ │ │ │ │ +0002c990: 6172 6566 756c 2077 6865 6e20 7365 6c65 areful when sele │ │ │ │ │ +0002c9a0: 6374 696e 6720 6c69 6272 6172 7920 636f cting library co │ │ │ │ │ +0002c9b0: 6d70 6f6e 656e 7473 2063 6f6e 6469 7469 mponents conditi │ │ │ │ │ +0002c9c0: 6f6e 616c 6c79 2e20 2042 6563 6175 7365 onally. Because │ │ │ │ │ +0002c9d0: 0a62 7569 6c64 696e 6720 616e 2065 6d70 .building an emp │ │ │ │ │ +0002c9e0: 7479 206c 6962 7261 7279 2069 7320 6e6f ty library is no │ │ │ │ │ +0002c9f0: 7420 706f 7274 6162 6c65 2c20 796f 7520 t portable, you │ │ │ │ │ +0002ca00: 7368 6f75 6c64 2065 6e73 7572 6520 7468 should ensure th │ │ │ │ │ +0002ca10: 6174 2061 6e79 0a6c 6962 7261 7279 2061 at any.library a │ │ │ │ │ +0002ca20: 6c77 6179 7320 636f 6e74 6169 6e73 2061 lways contains a │ │ │ │ │ +0002ca30: 7420 6c65 6173 7420 6f6e 6520 6f62 6a65 t least one obje │ │ │ │ │ +0002ca40: 6374 2e0a 0a20 2020 546f 2075 7365 2061 ct... To use a │ │ │ │ │ +0002ca50: 2073 7461 7469 6320 6c69 6272 6172 7920 static library │ │ │ │ │ +0002ca60: 7768 656e 2062 7569 6c64 696e 6720 6120 when building a │ │ │ │ │ +0002ca70: 7072 6f67 7261 6d2c 2061 6464 2069 7420 program, add it │ │ │ │ │ +0002ca80: 746f 2027 4c44 4144 4427 0a66 6f72 2074 to 'LDADD'.for t │ │ │ │ │ +0002ca90: 6869 7320 7072 6f67 7261 6d2e 2020 496e his program. In │ │ │ │ │ +0002caa0: 2074 6865 2066 6f6c 6c6f 7769 6e67 2065 the following e │ │ │ │ │ +0002cab0: 7861 6d70 6c65 2c20 7468 6520 7072 6f67 xample, the prog │ │ │ │ │ +0002cac0: 7261 6d20 2763 7069 6f27 2069 730a 7374 ram 'cpio' is.st │ │ │ │ │ +0002cad0: 6174 6963 616c 6c79 206c 696e 6b65 6420 atically linked │ │ │ │ │ +0002cae0: 7769 7468 2074 6865 206c 6962 7261 7279 with the library │ │ │ │ │ +0002caf0: 2027 6c69 6263 7069 6f2e 6127 2e0a 0a20 'libcpio.a'... │ │ │ │ │ +0002cb00: 2020 2020 6e6f 696e 7374 5f4c 4942 5241 noinst_LIBRA │ │ │ │ │ +0002cb10: 5249 4553 203d 206c 6962 6370 696f 2e61 RIES = libcpio.a │ │ │ │ │ +0002cb20: 0a20 2020 2020 6c69 6263 7069 6f5f 615f . libcpio_a_ │ │ │ │ │ +0002cb30: 534f 5552 4345 5320 3d20 2e2e 2e0a 0a20 SOURCES = ..... │ │ │ │ │ +0002cb40: 2020 2020 6269 6e5f 5052 4f47 5241 4d53 bin_PROGRAMS │ │ │ │ │ +0002cb50: 203d 2063 7069 6f0a 2020 2020 2063 7069 = cpio. cpi │ │ │ │ │ +0002cb60: 6f5f 534f 5552 4345 5320 3d20 6370 696f o_SOURCES = cpio │ │ │ │ │ +0002cb70: 2e63 202e 2e2e 0a20 2020 2020 6370 696f .c .... cpio │ │ │ │ │ +0002cb80: 5f4c 4441 4444 203d 206c 6962 6370 696f _LDADD = libcpio │ │ │ │ │ +0002cb90: 2e61 0a0a 1f0a 4669 6c65 3a20 6175 746f .a....File: auto │ │ │ │ │ +0002cba0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +0002cbb0: 204e 6f64 653a 2041 2053 6861 7265 6420 Node: A Shared │ │ │ │ │ +0002cbc0: 4c69 6272 6172 792c 2020 4e65 7874 3a20 Library, Next: │ │ │ │ │ +0002cbd0: 5072 6f67 7261 6d20 616e 6420 4c69 6272 Program and Libr │ │ │ │ │ +0002cbe0: 6172 7920 5661 7269 6162 6c65 732c 2020 ary Variables, │ │ │ │ │ +0002cbf0: 5072 6576 3a20 4120 4c69 6272 6172 792c Prev: A Library, │ │ │ │ │ +0002cc00: 2020 5570 3a20 5072 6f67 7261 6d73 0a0a Up: Programs.. │ │ │ │ │ +0002cc10: 382e 3320 4275 696c 6469 6e67 2061 2053 8.3 Building a S │ │ │ │ │ +0002cc20: 6861 7265 6420 4c69 6272 6172 790a 3d3d hared Library.== │ │ │ │ │ 0002cc30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0002cc40: 3d3d 3d3d 3d3d 3d3d 3d0a 0a42 7569 6c64 =========..Build │ │ │ │ │ -0002cc50: 696e 6720 7368 6172 6564 206c 6962 7261 ing shared libra │ │ │ │ │ -0002cc60: 7269 6573 2070 6f72 7461 626c 7920 6973 ries portably is │ │ │ │ │ -0002cc70: 2061 2072 656c 6174 6976 656c 7920 636f a relatively co │ │ │ │ │ -0002cc80: 6d70 6c65 7820 6d61 7474 6572 2e20 2046 mplex matter. F │ │ │ │ │ -0002cc90: 6f72 0a74 6869 7320 7265 6173 6f6e 2c20 or.this reason, │ │ │ │ │ -0002cca0: 474e 5520 4c69 6274 6f6f 6c20 282a 6e6f GNU Libtool (*no │ │ │ │ │ -0002ccb0: 7465 2049 6e74 726f 6475 6374 696f 6e3a te Introduction: │ │ │ │ │ -0002ccc0: 2028 6c69 6274 6f6f 6c29 546f 702e 2920 (libtool)Top.) │ │ │ │ │ -0002ccd0: 7761 7320 6372 6561 7465 640a 746f 2068 was created.to h │ │ │ │ │ -0002cce0: 656c 7020 6275 696c 6420 7368 6172 6564 elp build shared │ │ │ │ │ -0002ccf0: 206c 6962 7261 7269 6573 2069 6e20 6120 libraries in a │ │ │ │ │ -0002cd00: 706c 6174 666f 726d 2d69 6e64 6570 656e platform-indepen │ │ │ │ │ -0002cd10: 6465 6e74 2077 6179 2e0a 0a2a 204d 656e dent way...* Men │ │ │ │ │ -0002cd20: 753a 0a0a 2a20 4c69 6274 6f6f 6c20 436f u:..* Libtool Co │ │ │ │ │ -0002cd30: 6e63 6570 743a 3a20 2020 2020 2020 2020 ncept:: │ │ │ │ │ -0002cd40: 2020 2020 496e 7472 6f64 7563 696e 6720 Introducing │ │ │ │ │ -0002cd50: 4c69 6274 6f6f 6c0a 2a20 4c69 6274 6f6f Libtool.* Libtoo │ │ │ │ │ -0002cd60: 6c20 4c69 6272 6172 6965 733a 3a20 2020 l Libraries:: │ │ │ │ │ -0002cd70: 2020 2020 2020 2020 4465 636c 6172 696e Declarin │ │ │ │ │ -0002cd80: 6720 4c69 6274 6f6f 6c20 4c69 6272 6172 g Libtool Librar │ │ │ │ │ -0002cd90: 6965 730a 2a20 436f 6e64 6974 696f 6e61 ies.* Conditiona │ │ │ │ │ -0002cda0: 6c20 4c69 6274 6f6f 6c20 4c69 6272 6172 l Libtool Librar │ │ │ │ │ -0002cdb0: 6965 733a 3a20 2042 7569 6c64 696e 6720 ies:: Building │ │ │ │ │ -0002cdc0: 4c69 6274 6f6f 6c20 4c69 6272 6172 6965 Libtool Librarie │ │ │ │ │ -0002cdd0: 7320 436f 6e64 6974 696f 6e61 6c6c 790a s Conditionally. │ │ │ │ │ -0002cde0: 2a20 436f 6e64 6974 696f 6e61 6c20 4c69 * Conditional Li │ │ │ │ │ -0002cdf0: 6274 6f6f 6c20 536f 7572 6365 733a 3a20 btool Sources:: │ │ │ │ │ -0002ce00: 2043 686f 6f73 696e 6720 4c69 6272 6172 Choosing Librar │ │ │ │ │ -0002ce10: 7920 536f 7572 6365 7320 436f 6e64 6974 y Sources Condit │ │ │ │ │ -0002ce20: 696f 6e61 6c6c 790a 2a20 4c69 6274 6f6f ionally.* Libtoo │ │ │ │ │ -0002ce30: 6c20 436f 6e76 656e 6965 6e63 6520 4c69 l Convenience Li │ │ │ │ │ -0002ce40: 6272 6172 6965 733a 3a20 2042 7569 6c64 braries:: Build │ │ │ │ │ -0002ce50: 696e 6720 436f 6e76 656e 6965 6e63 6520 ing Convenience │ │ │ │ │ -0002ce60: 4c69 6274 6f6f 6c20 4c69 6272 6172 6965 Libtool Librarie │ │ │ │ │ -0002ce70: 730a 2a20 4c69 6274 6f6f 6c20 4d6f 6475 s.* Libtool Modu │ │ │ │ │ -0002ce80: 6c65 733a 3a20 2020 2020 2020 2020 2020 les:: │ │ │ │ │ -0002ce90: 2020 4275 696c 6469 6e67 204c 6962 746f Building Libto │ │ │ │ │ -0002cea0: 6f6c 204d 6f64 756c 6573 0a2a 204c 6962 ol Modules.* Lib │ │ │ │ │ -0002ceb0: 746f 6f6c 2046 6c61 6773 3a3a 2020 2020 tool Flags:: │ │ │ │ │ -0002cec0: 2020 2020 2020 2020 2020 2055 7369 6e67 Using │ │ │ │ │ -0002ced0: 205f 4c49 4241 4444 2c20 5f4c 4446 4c41 _LIBADD, _LDFLA │ │ │ │ │ -0002cee0: 4753 2c20 616e 6420 5f4c 4942 544f 4f4c GS, and _LIBTOOL │ │ │ │ │ -0002cef0: 464c 4147 530a 2a20 4c54 4c49 424f 424a FLAGS.* LTLIBOBJ │ │ │ │ │ -0002cf00: 533a 3a20 2020 2020 2020 2020 2020 2020 S:: │ │ │ │ │ -0002cf10: 2020 2020 2020 5573 696e 6720 2428 4c54 Using $(LT │ │ │ │ │ -0002cf20: 4c49 424f 424a 5329 2061 6e64 2024 284c LIBOBJS) and $(L │ │ │ │ │ -0002cf30: 5441 4c4c 4f43 4129 0a2a 204c 6962 746f TALLOCA).* Libto │ │ │ │ │ -0002cf40: 6f6c 2049 7373 7565 733a 3a20 2020 2020 ol Issues:: │ │ │ │ │ -0002cf50: 2020 2020 2020 2020 2043 6f6d 6d6f 6e20 Common │ │ │ │ │ -0002cf60: 4973 7375 6573 2052 656c 6174 6564 2074 Issues Related t │ │ │ │ │ -0002cf70: 6f20 4c69 6274 6f6f 6c27 7320 5573 650a o Libtool's Use. │ │ │ │ │ -0002cf80: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -0002cf90: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -0002cfa0: 6465 3a20 4c69 6274 6f6f 6c20 436f 6e63 de: Libtool Conc │ │ │ │ │ -0002cfb0: 6570 742c 2020 4e65 7874 3a20 4c69 6274 ept, Next: Libt │ │ │ │ │ -0002cfc0: 6f6f 6c20 4c69 6272 6172 6965 732c 2020 ool Libraries, │ │ │ │ │ -0002cfd0: 5570 3a20 4120 5368 6172 6564 204c 6962 Up: A Shared Lib │ │ │ │ │ -0002cfe0: 7261 7279 0a0a 382e 332e 3120 5468 6520 rary..8.3.1 The │ │ │ │ │ -0002cff0: 4c69 6274 6f6f 6c20 436f 6e63 6570 740a Libtool Concept. │ │ │ │ │ -0002d000: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002d010: 2d2d 2d2d 2d2d 2d2d 2d0a 0a4c 6962 746f ---------..Libto │ │ │ │ │ -0002d020: 6f6c 2061 6273 7472 6163 7473 2073 6861 ol abstracts sha │ │ │ │ │ -0002d030: 7265 6420 616e 6420 7374 6174 6963 206c red and static l │ │ │ │ │ -0002d040: 6962 7261 7269 6573 2069 6e74 6f20 6120 ibraries into a │ │ │ │ │ -0002d050: 756e 6966 6965 6420 636f 6e63 6570 740a unified concept. │ │ │ │ │ -0002d060: 6865 6e63 6566 6f72 7468 2063 616c 6c65 henceforth calle │ │ │ │ │ -0002d070: 6420 226c 6962 746f 6f6c 206c 6962 7261 d "libtool libra │ │ │ │ │ -0002d080: 7269 6573 222e 2020 4c69 6274 6f6f 6c20 ries". Libtool │ │ │ │ │ -0002d090: 6c69 6272 6172 6965 7320 6172 6520 6669 libraries are fi │ │ │ │ │ -0002d0a0: 6c65 730a 7573 696e 6720 7468 6520 272e les.using the '. │ │ │ │ │ -0002d0b0: 6c61 2720 7375 6666 6978 2c20 616e 6420 la' suffix, and │ │ │ │ │ -0002d0c0: 6361 6e20 6465 7369 676e 6174 6520 6120 can designate a │ │ │ │ │ -0002d0d0: 7374 6174 6963 206c 6962 7261 7279 2c20 static library, │ │ │ │ │ -0002d0e0: 6120 7368 6172 6564 0a6c 6962 7261 7279 a shared.library │ │ │ │ │ -0002d0f0: 2c20 6f72 206d 6179 6265 2062 6f74 682e , or maybe both. │ │ │ │ │ -0002d100: 2020 5468 6569 7220 6578 6163 7420 6e61 Their exact na │ │ │ │ │ -0002d110: 7475 7265 2063 616e 6e6f 7420 6265 2064 ture cannot be d │ │ │ │ │ -0002d120: 6574 6572 6d69 6e65 6420 756e 7469 6c0a etermined until. │ │ │ │ │ -0002d130: 272e 2f63 6f6e 6669 6775 7265 2720 6973 './configure' is │ │ │ │ │ -0002d140: 2072 756e 3a20 6e6f 7420 616c 6c20 706c run: not all pl │ │ │ │ │ -0002d150: 6174 666f 726d 7320 7375 7070 6f72 7420 atforms support │ │ │ │ │ -0002d160: 616c 6c20 6b69 6e64 7320 6f66 206c 6962 all kinds of lib │ │ │ │ │ -0002d170: 7261 7269 6573 2c0a 616e 6420 7573 6572 raries,.and user │ │ │ │ │ -0002d180: 7320 6361 6e20 6578 706c 6963 6974 6c79 s can explicitly │ │ │ │ │ -0002d190: 2073 656c 6563 7420 7768 6963 6820 6c69 select which li │ │ │ │ │ -0002d1a0: 6272 6172 6965 7320 7368 6f75 6c64 2062 braries should b │ │ │ │ │ -0002d1b0: 6520 6275 696c 742e 0a28 486f 7765 7665 e built..(Howeve │ │ │ │ │ -0002d1c0: 7220 7468 6520 7061 636b 6167 6527 7320 r the package's │ │ │ │ │ -0002d1d0: 6d61 696e 7461 696e 6572 7320 6361 6e20 maintainers can │ │ │ │ │ -0002d1e0: 7475 6e65 2074 6865 2064 6566 6175 6c74 tune the default │ │ │ │ │ -0002d1f0: 2c20 2a6e 6f74 6520 5468 650a 2741 435f , *note The.'AC_ │ │ │ │ │ -0002d200: 5052 4f47 5f4c 4942 544f 4f4c 2720 6d61 PROG_LIBTOOL' ma │ │ │ │ │ -0002d210: 6372 6f3a 2028 6c69 6274 6f6f 6c29 4143 cro: (libtool)AC │ │ │ │ │ -0002d220: 5f50 524f 475f 4c49 4254 4f4f 4c2e 290a _PROG_LIBTOOL.). │ │ │ │ │ -0002d230: 0a20 2020 4265 6361 7573 6520 6f62 6a65 . Because obje │ │ │ │ │ -0002d240: 6374 2066 696c 6573 2066 6f72 2073 6861 ct files for sha │ │ │ │ │ -0002d250: 7265 6420 616e 6420 7374 6174 6963 206c red and static l │ │ │ │ │ -0002d260: 6962 7261 7269 6573 206d 7573 7420 6265 ibraries must be │ │ │ │ │ -0002d270: 2063 6f6d 7069 6c65 640a 6469 6666 6572 compiled.differ │ │ │ │ │ -0002d280: 656e 746c 792c 206c 6962 746f 6f6c 2069 ently, libtool i │ │ │ │ │ -0002d290: 7320 616c 736f 2075 7365 6420 6475 7269 s also used duri │ │ │ │ │ -0002d2a0: 6e67 2063 6f6d 7069 6c61 7469 6f6e 2e20 ng compilation. │ │ │ │ │ -0002d2b0: 204f 626a 6563 7420 6669 6c65 730a 6275 Object files.bu │ │ │ │ │ -0002d2c0: 696c 7420 6279 206c 6962 746f 6f6c 2061 ilt by libtool a │ │ │ │ │ -0002d2d0: 7265 2063 616c 6c65 6420 226c 6962 746f re called "libto │ │ │ │ │ -0002d2e0: 6f6c 206f 626a 6563 7473 223a 2074 6865 ol objects": the │ │ │ │ │ -0002d2f0: 7365 2061 7265 2066 696c 6573 2075 7369 se are files usi │ │ │ │ │ -0002d300: 6e67 2074 6865 0a27 2e6c 6f27 2073 7566 ng the.'.lo' suf │ │ │ │ │ -0002d310: 6669 782e 2020 4c69 6274 6f6f 6c20 6c69 fix. Libtool li │ │ │ │ │ -0002d320: 6272 6172 6965 7320 6172 6520 6275 696c braries are buil │ │ │ │ │ -0002d330: 7420 6672 6f6d 2074 6865 7365 206c 6962 t from these lib │ │ │ │ │ -0002d340: 746f 6f6c 206f 626a 6563 7473 2e0a 0a20 tool objects... │ │ │ │ │ -0002d350: 2020 596f 7520 7368 6f75 6c64 206e 6f74 You should not │ │ │ │ │ -0002d360: 2061 7373 756d 6520 616e 7974 6869 6e67 assume anything │ │ │ │ │ -0002d370: 2061 626f 7574 2074 6865 2073 7472 7563 about the struc │ │ │ │ │ -0002d380: 7475 7265 206f 6620 272e 6c61 2720 6f72 ture of '.la' or │ │ │ │ │ -0002d390: 2027 2e6c 6f27 0a66 696c 6573 2061 6e64 '.lo'.files and │ │ │ │ │ -0002d3a0: 2068 6f77 206c 6962 746f 6f6c 2063 6f6e how libtool con │ │ │ │ │ -0002d3b0: 7374 7275 6374 7320 7468 656d 3a20 7468 structs them: th │ │ │ │ │ -0002d3c0: 6973 2069 7320 6c69 6274 6f6f 6c27 7320 is is libtool's │ │ │ │ │ -0002d3d0: 636f 6e63 6572 6e2c 2061 6e64 0a74 6865 concern, and.the │ │ │ │ │ -0002d3e0: 206c 6173 7420 7468 696e 6720 6f6e 6520 last thing one │ │ │ │ │ -0002d3f0: 7761 6e74 7320 6973 2074 6f20 6c65 6172 wants is to lear │ │ │ │ │ -0002d400: 6e20 6162 6f75 7420 6c69 6274 6f6f 6c27 n about libtool' │ │ │ │ │ -0002d410: 7320 6775 7473 2e20 2048 6f77 6576 6572 s guts. However │ │ │ │ │ -0002d420: 2074 6865 0a65 7869 7374 656e 6365 206f the.existence o │ │ │ │ │ -0002d430: 6620 7468 6573 6520 6669 6c65 7320 6d61 f these files ma │ │ │ │ │ -0002d440: 7474 6572 732c 2062 6563 6175 7365 2074 tters, because t │ │ │ │ │ -0002d450: 6865 7920 6172 6520 7573 6564 2061 7320 hey are used as │ │ │ │ │ -0002d460: 7461 7267 6574 7320 616e 640a 6465 7065 targets and.depe │ │ │ │ │ -0002d470: 6e64 656e 6369 6573 2069 6e20 274d 616b ndencies in 'Mak │ │ │ │ │ -0002d480: 6566 696c 6527 7320 7275 6c65 7320 7768 efile's rules wh │ │ │ │ │ -0002d490: 656e 2062 7569 6c64 696e 6720 6c69 6274 en building libt │ │ │ │ │ -0002d4a0: 6f6f 6c20 6c69 6272 6172 6965 732e 0a54 ool libraries..T │ │ │ │ │ -0002d4b0: 6865 7265 2061 7265 2073 6974 7561 7469 here are situati │ │ │ │ │ -0002d4c0: 6f6e 7320 7768 6572 6520 796f 7520 6d61 ons where you ma │ │ │ │ │ -0002d4d0: 7920 6861 7665 2074 6f20 7265 6665 7220 y have to refer │ │ │ │ │ -0002d4e0: 746f 2074 6865 7365 2c20 666f 7220 696e to these, for in │ │ │ │ │ -0002d4f0: 7374 616e 6365 0a77 6865 6e20 6578 7072 stance.when expr │ │ │ │ │ -0002d500: 6573 7369 6e67 2064 6570 656e 6465 6e63 essing dependenc │ │ │ │ │ -0002d510: 6965 7320 666f 7220 6275 696c 6469 6e67 ies for building │ │ │ │ │ -0002d520: 2073 6f75 7263 6520 6669 6c65 7320 636f source files co │ │ │ │ │ -0002d530: 6e64 6974 696f 6e61 6c6c 790a 282a 6e6f nditionally.(*no │ │ │ │ │ -0002d540: 7465 2043 6f6e 6469 7469 6f6e 616c 204c te Conditional L │ │ │ │ │ -0002d550: 6962 746f 6f6c 2053 6f75 7263 6573 3a3a ibtool Sources:: │ │ │ │ │ -0002d560: 292e 0a0a 2020 2050 656f 706c 6520 636f )... People co │ │ │ │ │ -0002d570: 6e73 6964 6572 696e 6720 7772 6974 696e nsidering writin │ │ │ │ │ -0002d580: 6720 6120 706c 7567 2d69 6e20 7379 7374 g a plug-in syst │ │ │ │ │ -0002d590: 656d 2c20 7769 7468 2064 796e 616d 6963 em, with dynamic │ │ │ │ │ -0002d5a0: 616c 6c79 206c 6f61 6465 640a 6d6f 6475 ally loaded.modu │ │ │ │ │ -0002d5b0: 6c65 732c 2073 686f 756c 6420 6c6f 6f6b les, should look │ │ │ │ │ -0002d5c0: 2069 6e74 6f20 276c 6962 6c74 646c 273a into 'libltdl': │ │ │ │ │ -0002d5d0: 206c 6962 746f 6f6c 2773 2064 6c6f 7065 libtool's dlope │ │ │ │ │ -0002d5e0: 6e69 6e67 206c 6962 7261 7279 2028 2a6e ning library (*n │ │ │ │ │ -0002d5f0: 6f74 650a 5573 696e 6720 6c69 626c 7464 ote.Using libltd │ │ │ │ │ -0002d600: 6c3a 2028 6c69 6274 6f6f 6c29 5573 696e l: (libtool)Usin │ │ │ │ │ -0002d610: 6720 6c69 626c 7464 6c2e 292e 2020 5468 g libltdl.). Th │ │ │ │ │ -0002d620: 6973 206f 6666 6572 7320 6120 706f 7274 is offers a port │ │ │ │ │ -0002d630: 6162 6c65 0a64 6c6f 7065 6e69 6e67 2066 able.dlopening f │ │ │ │ │ -0002d640: 6163 696c 6974 7920 746f 206c 6f61 6420 acility to load │ │ │ │ │ -0002d650: 6c69 6274 6f6f 6c20 6c69 6272 6172 6965 libtool librarie │ │ │ │ │ -0002d660: 7320 6479 6e61 6d69 6361 6c6c 792c 2061 s dynamically, a │ │ │ │ │ -0002d670: 6e64 2063 616e 2061 6c73 6f0a 6163 6869 nd can also.achi │ │ │ │ │ -0002d680: 6576 6520 7374 6174 6963 206c 696e 6b69 eve static linki │ │ │ │ │ -0002d690: 6e67 2077 6865 7265 2075 6e61 766f 6964 ng where unavoid │ │ │ │ │ -0002d6a0: 6162 6c65 2e0a 0a20 2020 4265 666f 7265 able... Before │ │ │ │ │ -0002d6b0: 2077 6520 6469 7363 7573 7320 686f 7720 we discuss how │ │ │ │ │ -0002d6c0: 746f 2075 7365 206c 6962 746f 6f6c 2077 to use libtool w │ │ │ │ │ -0002d6d0: 6974 6820 4175 746f 6d61 6b65 2069 6e20 ith Automake in │ │ │ │ │ -0002d6e0: 6465 7461 696c 732c 2069 740a 7368 6f75 details, it.shou │ │ │ │ │ -0002d6f0: 6c64 2062 6520 6e6f 7465 6420 7468 6174 ld be noted that │ │ │ │ │ -0002d700: 2074 6865 206c 6962 746f 6f6c 206d 616e the libtool man │ │ │ │ │ -0002d710: 7561 6c20 616c 736f 2068 6173 2061 2073 ual also has a s │ │ │ │ │ -0002d720: 6563 7469 6f6e 2061 626f 7574 2068 6f77 ection about how │ │ │ │ │ -0002d730: 2074 6f0a 7573 6520 4175 746f 6d61 6b65 to.use Automake │ │ │ │ │ -0002d740: 2077 6974 6820 6c69 6274 6f6f 6c20 282a with libtool (* │ │ │ │ │ -0002d750: 6e6f 7465 2055 7369 6e67 2041 7574 6f6d note Using Autom │ │ │ │ │ -0002d760: 616b 6520 7769 7468 204c 6962 746f 6f6c ake with Libtool │ │ │ │ │ -0002d770: 3a0a 286c 6962 746f 6f6c 2955 7369 6e67 :.(libtool)Using │ │ │ │ │ -0002d780: 2041 7574 6f6d 616b 652e 292e 0a0a 1f0a Automake.)..... │ │ │ │ │ -0002d790: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ -0002d7a0: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ -0002d7b0: 204c 6962 746f 6f6c 204c 6962 7261 7269 Libtool Librari │ │ │ │ │ -0002d7c0: 6573 2c20 204e 6578 743a 2043 6f6e 6469 es, Next: Condi │ │ │ │ │ -0002d7d0: 7469 6f6e 616c 204c 6962 746f 6f6c 204c tional Libtool L │ │ │ │ │ -0002d7e0: 6962 7261 7269 6573 2c20 2050 7265 763a ibraries, Prev: │ │ │ │ │ -0002d7f0: 204c 6962 746f 6f6c 2043 6f6e 6365 7074 Libtool Concept │ │ │ │ │ -0002d800: 2c20 2055 703a 2041 2053 6861 7265 6420 , Up: A Shared │ │ │ │ │ -0002d810: 4c69 6272 6172 790a 0a38 2e33 2e32 2042 Library..8.3.2 B │ │ │ │ │ -0002d820: 7569 6c64 696e 6720 4c69 6274 6f6f 6c20 uilding Libtool │ │ │ │ │ -0002d830: 4c69 6272 6172 6965 730a 2d2d 2d2d 2d2d Libraries.------ │ │ │ │ │ +0002cc40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a42 7569 ===========..Bui │ │ │ │ │ +0002cc50: 6c64 696e 6720 7368 6172 6564 206c 6962 lding shared lib │ │ │ │ │ +0002cc60: 7261 7269 6573 2070 6f72 7461 626c 7920 raries portably │ │ │ │ │ +0002cc70: 6973 2061 2072 656c 6174 6976 656c 7920 is a relatively │ │ │ │ │ +0002cc80: 636f 6d70 6c65 7820 6d61 7474 6572 2e20 complex matter. │ │ │ │ │ +0002cc90: 2046 6f72 0a74 6869 7320 7265 6173 6f6e For.this reason │ │ │ │ │ +0002cca0: 2c20 474e 5520 4c69 6274 6f6f 6c20 282a , GNU Libtool (* │ │ │ │ │ +0002ccb0: 6e6f 7465 2049 6e74 726f 6475 6374 696f note Introductio │ │ │ │ │ +0002ccc0: 6e3a 2028 6c69 6274 6f6f 6c29 546f 702e n: (libtool)Top. │ │ │ │ │ +0002ccd0: 2920 7761 7320 6372 6561 7465 640a 746f ) was created.to │ │ │ │ │ +0002cce0: 2068 656c 7020 6275 696c 6420 7368 6172 help build shar │ │ │ │ │ +0002ccf0: 6564 206c 6962 7261 7269 6573 2069 6e20 ed libraries in │ │ │ │ │ +0002cd00: 6120 706c 6174 666f 726d 2d69 6e64 6570 a platform-indep │ │ │ │ │ +0002cd10: 656e 6465 6e74 2077 6179 2e0a 0a2a 204d endent way...* M │ │ │ │ │ +0002cd20: 656e 753a 0a0a 2a20 4c69 6274 6f6f 6c20 enu:..* Libtool │ │ │ │ │ +0002cd30: 436f 6e63 6570 743a 3a20 2020 2020 2020 Concept:: │ │ │ │ │ +0002cd40: 2020 2020 2020 496e 7472 6f64 7563 696e Introducin │ │ │ │ │ +0002cd50: 6720 4c69 6274 6f6f 6c0a 2a20 4c69 6274 g Libtool.* Libt │ │ │ │ │ +0002cd60: 6f6f 6c20 4c69 6272 6172 6965 733a 3a20 ool Libraries:: │ │ │ │ │ +0002cd70: 2020 2020 2020 2020 2020 4465 636c 6172 Declar │ │ │ │ │ +0002cd80: 696e 6720 4c69 6274 6f6f 6c20 4c69 6272 ing Libtool Libr │ │ │ │ │ +0002cd90: 6172 6965 730a 2a20 436f 6e64 6974 696f aries.* Conditio │ │ │ │ │ +0002cda0: 6e61 6c20 4c69 6274 6f6f 6c20 4c69 6272 nal Libtool Libr │ │ │ │ │ +0002cdb0: 6172 6965 733a 3a20 2042 7569 6c64 696e aries:: Buildin │ │ │ │ │ +0002cdc0: 6720 4c69 6274 6f6f 6c20 4c69 6272 6172 g Libtool Librar │ │ │ │ │ +0002cdd0: 6965 7320 436f 6e64 6974 696f 6e61 6c6c ies Conditionall │ │ │ │ │ +0002cde0: 790a 2a20 436f 6e64 6974 696f 6e61 6c20 y.* Conditional │ │ │ │ │ +0002cdf0: 4c69 6274 6f6f 6c20 536f 7572 6365 733a Libtool Sources: │ │ │ │ │ +0002ce00: 3a20 2043 686f 6f73 696e 6720 4c69 6272 : Choosing Libr │ │ │ │ │ +0002ce10: 6172 7920 536f 7572 6365 7320 436f 6e64 ary Sources Cond │ │ │ │ │ +0002ce20: 6974 696f 6e61 6c6c 790a 2a20 4c69 6274 itionally.* Libt │ │ │ │ │ +0002ce30: 6f6f 6c20 436f 6e76 656e 6965 6e63 6520 ool Convenience │ │ │ │ │ +0002ce40: 4c69 6272 6172 6965 733a 3a20 2042 7569 Libraries:: Bui │ │ │ │ │ +0002ce50: 6c64 696e 6720 436f 6e76 656e 6965 6e63 lding Convenienc │ │ │ │ │ +0002ce60: 6520 4c69 6274 6f6f 6c20 4c69 6272 6172 e Libtool Librar │ │ │ │ │ +0002ce70: 6965 730a 2a20 4c69 6274 6f6f 6c20 4d6f ies.* Libtool Mo │ │ │ │ │ +0002ce80: 6475 6c65 733a 3a20 2020 2020 2020 2020 dules:: │ │ │ │ │ +0002ce90: 2020 2020 4275 696c 6469 6e67 204c 6962 Building Lib │ │ │ │ │ +0002cea0: 746f 6f6c 204d 6f64 756c 6573 0a2a 204c tool Modules.* L │ │ │ │ │ +0002ceb0: 6962 746f 6f6c 2046 6c61 6773 3a3a 2020 ibtool Flags:: │ │ │ │ │ +0002cec0: 2020 2020 2020 2020 2020 2020 2055 7369 Usi │ │ │ │ │ +0002ced0: 6e67 205f 4c49 4241 4444 2c20 5f4c 4446 ng _LIBADD, _LDF │ │ │ │ │ +0002cee0: 4c41 4753 2c20 616e 6420 5f4c 4942 544f LAGS, and _LIBTO │ │ │ │ │ +0002cef0: 4f4c 464c 4147 530a 2a20 4c54 4c49 424f OLFLAGS.* LTLIBO │ │ │ │ │ +0002cf00: 424a 533a 3a20 2020 2020 2020 2020 2020 BJS:: │ │ │ │ │ +0002cf10: 2020 2020 2020 2020 5573 696e 6720 2428 Using $( │ │ │ │ │ +0002cf20: 4c54 4c49 424f 424a 5329 2061 6e64 2024 LTLIBOBJS) and $ │ │ │ │ │ +0002cf30: 284c 5441 4c4c 4f43 4129 0a2a 204c 6962 (LTALLOCA).* Lib │ │ │ │ │ +0002cf40: 746f 6f6c 2049 7373 7565 733a 3a20 2020 tool Issues:: │ │ │ │ │ +0002cf50: 2020 2020 2020 2020 2020 2043 6f6d 6d6f Commo │ │ │ │ │ +0002cf60: 6e20 4973 7375 6573 2052 656c 6174 6564 n Issues Related │ │ │ │ │ +0002cf70: 2074 6f20 4c69 6274 6f6f 6c27 7320 5573 to Libtool's Us │ │ │ │ │ +0002cf80: 650a 0a1f 0a46 696c 653a 2061 7574 6f6d e....File: autom │ │ │ │ │ +0002cf90: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +0002cfa0: 4e6f 6465 3a20 4c69 6274 6f6f 6c20 436f Node: Libtool Co │ │ │ │ │ +0002cfb0: 6e63 6570 742c 2020 4e65 7874 3a20 4c69 ncept, Next: Li │ │ │ │ │ +0002cfc0: 6274 6f6f 6c20 4c69 6272 6172 6965 732c btool Libraries, │ │ │ │ │ +0002cfd0: 2020 5570 3a20 4120 5368 6172 6564 204c Up: A Shared L │ │ │ │ │ +0002cfe0: 6962 7261 7279 0a0a 382e 332e 3120 5468 ibrary..8.3.1 Th │ │ │ │ │ +0002cff0: 6520 4c69 6274 6f6f 6c20 436f 6e63 6570 e Libtool Concep │ │ │ │ │ +0002d000: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ │ +0002d010: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a4c 6962 -----------..Lib │ │ │ │ │ +0002d020: 746f 6f6c 2061 6273 7472 6163 7473 2073 tool abstracts s │ │ │ │ │ +0002d030: 6861 7265 6420 616e 6420 7374 6174 6963 hared and static │ │ │ │ │ +0002d040: 206c 6962 7261 7269 6573 2069 6e74 6f20 libraries into │ │ │ │ │ +0002d050: 6120 756e 6966 6965 6420 636f 6e63 6570 a unified concep │ │ │ │ │ +0002d060: 740a 6865 6e63 6566 6f72 7468 2063 616c t.henceforth cal │ │ │ │ │ +0002d070: 6c65 6420 226c 6962 746f 6f6c 206c 6962 led "libtool lib │ │ │ │ │ +0002d080: 7261 7269 6573 222e 2020 4c69 6274 6f6f raries". Libtoo │ │ │ │ │ +0002d090: 6c20 6c69 6272 6172 6965 7320 6172 6520 l libraries are │ │ │ │ │ +0002d0a0: 6669 6c65 730a 7573 696e 6720 7468 6520 files.using the │ │ │ │ │ +0002d0b0: 272e 6c61 2720 7375 6666 6978 2c20 616e '.la' suffix, an │ │ │ │ │ +0002d0c0: 6420 6361 6e20 6465 7369 676e 6174 6520 d can designate │ │ │ │ │ +0002d0d0: 6120 7374 6174 6963 206c 6962 7261 7279 a static library │ │ │ │ │ +0002d0e0: 2c20 6120 7368 6172 6564 0a6c 6962 7261 , a shared.libra │ │ │ │ │ +0002d0f0: 7279 2c20 6f72 206d 6179 6265 2062 6f74 ry, or maybe bot │ │ │ │ │ +0002d100: 682e 2020 5468 6569 7220 6578 6163 7420 h. Their exact │ │ │ │ │ +0002d110: 6e61 7475 7265 2063 616e 6e6f 7420 6265 nature cannot be │ │ │ │ │ +0002d120: 2064 6574 6572 6d69 6e65 6420 756e 7469 determined unti │ │ │ │ │ +0002d130: 6c0a 272e 2f63 6f6e 6669 6775 7265 2720 l.'./configure' │ │ │ │ │ +0002d140: 6973 2072 756e 3a20 6e6f 7420 616c 6c20 is run: not all │ │ │ │ │ +0002d150: 706c 6174 666f 726d 7320 7375 7070 6f72 platforms suppor │ │ │ │ │ +0002d160: 7420 616c 6c20 6b69 6e64 7320 6f66 206c t all kinds of l │ │ │ │ │ +0002d170: 6962 7261 7269 6573 2c0a 616e 6420 7573 ibraries,.and us │ │ │ │ │ +0002d180: 6572 7320 6361 6e20 6578 706c 6963 6974 ers can explicit │ │ │ │ │ +0002d190: 6c79 2073 656c 6563 7420 7768 6963 6820 ly select which │ │ │ │ │ +0002d1a0: 6c69 6272 6172 6965 7320 7368 6f75 6c64 libraries should │ │ │ │ │ +0002d1b0: 2062 6520 6275 696c 742e 0a28 486f 7765 be built..(Howe │ │ │ │ │ +0002d1c0: 7665 7220 7468 6520 7061 636b 6167 6527 ver the package' │ │ │ │ │ +0002d1d0: 7320 6d61 696e 7461 696e 6572 7320 6361 s maintainers ca │ │ │ │ │ +0002d1e0: 6e20 7475 6e65 2074 6865 2064 6566 6175 n tune the defau │ │ │ │ │ +0002d1f0: 6c74 2c20 2a6e 6f74 6520 5468 650a 2741 lt, *note The.'A │ │ │ │ │ +0002d200: 435f 5052 4f47 5f4c 4942 544f 4f4c 2720 C_PROG_LIBTOOL' │ │ │ │ │ +0002d210: 6d61 6372 6f3a 2028 6c69 6274 6f6f 6c29 macro: (libtool) │ │ │ │ │ +0002d220: 4143 5f50 524f 475f 4c49 4254 4f4f 4c2e AC_PROG_LIBTOOL. │ │ │ │ │ +0002d230: 290a 0a20 2020 4265 6361 7573 6520 6f62 ).. Because ob │ │ │ │ │ +0002d240: 6a65 6374 2066 696c 6573 2066 6f72 2073 ject files for s │ │ │ │ │ +0002d250: 6861 7265 6420 616e 6420 7374 6174 6963 hared and static │ │ │ │ │ +0002d260: 206c 6962 7261 7269 6573 206d 7573 7420 libraries must │ │ │ │ │ +0002d270: 6265 2063 6f6d 7069 6c65 640a 6469 6666 be compiled.diff │ │ │ │ │ +0002d280: 6572 656e 746c 792c 206c 6962 746f 6f6c erently, libtool │ │ │ │ │ +0002d290: 2069 7320 616c 736f 2075 7365 6420 6475 is also used du │ │ │ │ │ +0002d2a0: 7269 6e67 2063 6f6d 7069 6c61 7469 6f6e ring compilation │ │ │ │ │ +0002d2b0: 2e20 204f 626a 6563 7420 6669 6c65 730a . Object files. │ │ │ │ │ +0002d2c0: 6275 696c 7420 6279 206c 6962 746f 6f6c built by libtool │ │ │ │ │ +0002d2d0: 2061 7265 2063 616c 6c65 6420 226c 6962 are called "lib │ │ │ │ │ +0002d2e0: 746f 6f6c 206f 626a 6563 7473 223a 2074 tool objects": t │ │ │ │ │ +0002d2f0: 6865 7365 2061 7265 2066 696c 6573 2075 hese are files u │ │ │ │ │ +0002d300: 7369 6e67 2074 6865 0a27 2e6c 6f27 2073 sing the.'.lo' s │ │ │ │ │ +0002d310: 7566 6669 782e 2020 4c69 6274 6f6f 6c20 uffix. Libtool │ │ │ │ │ +0002d320: 6c69 6272 6172 6965 7320 6172 6520 6275 libraries are bu │ │ │ │ │ +0002d330: 696c 7420 6672 6f6d 2074 6865 7365 206c ilt from these l │ │ │ │ │ +0002d340: 6962 746f 6f6c 206f 626a 6563 7473 2e0a ibtool objects.. │ │ │ │ │ +0002d350: 0a20 2020 596f 7520 7368 6f75 6c64 206e . You should n │ │ │ │ │ +0002d360: 6f74 2061 7373 756d 6520 616e 7974 6869 ot assume anythi │ │ │ │ │ +0002d370: 6e67 2061 626f 7574 2074 6865 2073 7472 ng about the str │ │ │ │ │ +0002d380: 7563 7475 7265 206f 6620 272e 6c61 2720 ucture of '.la' │ │ │ │ │ +0002d390: 6f72 2027 2e6c 6f27 0a66 696c 6573 2061 or '.lo'.files a │ │ │ │ │ +0002d3a0: 6e64 2068 6f77 206c 6962 746f 6f6c 2063 nd how libtool c │ │ │ │ │ +0002d3b0: 6f6e 7374 7275 6374 7320 7468 656d 3a20 onstructs them: │ │ │ │ │ +0002d3c0: 7468 6973 2069 7320 6c69 6274 6f6f 6c27 this is libtool' │ │ │ │ │ +0002d3d0: 7320 636f 6e63 6572 6e2c 2061 6e64 0a74 s concern, and.t │ │ │ │ │ +0002d3e0: 6865 206c 6173 7420 7468 696e 6720 6f6e he last thing on │ │ │ │ │ +0002d3f0: 6520 7761 6e74 7320 6973 2074 6f20 6c65 e wants is to le │ │ │ │ │ +0002d400: 6172 6e20 6162 6f75 7420 6c69 6274 6f6f arn about libtoo │ │ │ │ │ +0002d410: 6c27 7320 6775 7473 2e20 2048 6f77 6576 l's guts. Howev │ │ │ │ │ +0002d420: 6572 2074 6865 0a65 7869 7374 656e 6365 er the.existence │ │ │ │ │ +0002d430: 206f 6620 7468 6573 6520 6669 6c65 7320 of these files │ │ │ │ │ +0002d440: 6d61 7474 6572 732c 2062 6563 6175 7365 matters, because │ │ │ │ │ +0002d450: 2074 6865 7920 6172 6520 7573 6564 2061 they are used a │ │ │ │ │ +0002d460: 7320 7461 7267 6574 7320 616e 640a 6465 s targets and.de │ │ │ │ │ +0002d470: 7065 6e64 656e 6369 6573 2069 6e20 274d pendencies in 'M │ │ │ │ │ +0002d480: 616b 6566 696c 6527 7320 7275 6c65 7320 akefile's rules │ │ │ │ │ +0002d490: 7768 656e 2062 7569 6c64 696e 6720 6c69 when building li │ │ │ │ │ +0002d4a0: 6274 6f6f 6c20 6c69 6272 6172 6965 732e btool libraries. │ │ │ │ │ +0002d4b0: 0a54 6865 7265 2061 7265 2073 6974 7561 .There are situa │ │ │ │ │ +0002d4c0: 7469 6f6e 7320 7768 6572 6520 796f 7520 tions where you │ │ │ │ │ +0002d4d0: 6d61 7920 6861 7665 2074 6f20 7265 6665 may have to refe │ │ │ │ │ +0002d4e0: 7220 746f 2074 6865 7365 2c20 666f 7220 r to these, for │ │ │ │ │ +0002d4f0: 696e 7374 616e 6365 0a77 6865 6e20 6578 instance.when ex │ │ │ │ │ +0002d500: 7072 6573 7369 6e67 2064 6570 656e 6465 pressing depende │ │ │ │ │ +0002d510: 6e63 6965 7320 666f 7220 6275 696c 6469 ncies for buildi │ │ │ │ │ +0002d520: 6e67 2073 6f75 7263 6520 6669 6c65 7320 ng source files │ │ │ │ │ +0002d530: 636f 6e64 6974 696f 6e61 6c6c 790a 282a conditionally.(* │ │ │ │ │ +0002d540: 6e6f 7465 2043 6f6e 6469 7469 6f6e 616c note Conditional │ │ │ │ │ +0002d550: 204c 6962 746f 6f6c 2053 6f75 7263 6573 Libtool Sources │ │ │ │ │ +0002d560: 3a3a 292e 0a0a 2020 2050 656f 706c 6520 ::)... People │ │ │ │ │ +0002d570: 636f 6e73 6964 6572 696e 6720 7772 6974 considering writ │ │ │ │ │ +0002d580: 696e 6720 6120 706c 7567 2d69 6e20 7379 ing a plug-in sy │ │ │ │ │ +0002d590: 7374 656d 2c20 7769 7468 2064 796e 616d stem, with dynam │ │ │ │ │ +0002d5a0: 6963 616c 6c79 206c 6f61 6465 640a 6d6f ically loaded.mo │ │ │ │ │ +0002d5b0: 6475 6c65 732c 2073 686f 756c 6420 6c6f dules, should lo │ │ │ │ │ +0002d5c0: 6f6b 2069 6e74 6f20 276c 6962 6c74 646c ok into 'libltdl │ │ │ │ │ +0002d5d0: 273a 206c 6962 746f 6f6c 2773 2064 6c6f ': libtool's dlo │ │ │ │ │ +0002d5e0: 7065 6e69 6e67 206c 6962 7261 7279 2028 pening library ( │ │ │ │ │ +0002d5f0: 2a6e 6f74 650a 5573 696e 6720 6c69 626c *note.Using libl │ │ │ │ │ +0002d600: 7464 6c3a 2028 6c69 6274 6f6f 6c29 5573 tdl: (libtool)Us │ │ │ │ │ +0002d610: 696e 6720 6c69 626c 7464 6c2e 292e 2020 ing libltdl.). │ │ │ │ │ +0002d620: 5468 6973 206f 6666 6572 7320 6120 706f This offers a po │ │ │ │ │ +0002d630: 7274 6162 6c65 0a64 6c6f 7065 6e69 6e67 rtable.dlopening │ │ │ │ │ +0002d640: 2066 6163 696c 6974 7920 746f 206c 6f61 facility to loa │ │ │ │ │ +0002d650: 6420 6c69 6274 6f6f 6c20 6c69 6272 6172 d libtool librar │ │ │ │ │ +0002d660: 6965 7320 6479 6e61 6d69 6361 6c6c 792c ies dynamically, │ │ │ │ │ +0002d670: 2061 6e64 2063 616e 2061 6c73 6f0a 6163 and can also.ac │ │ │ │ │ +0002d680: 6869 6576 6520 7374 6174 6963 206c 696e hieve static lin │ │ │ │ │ +0002d690: 6b69 6e67 2077 6865 7265 2075 6e61 766f king where unavo │ │ │ │ │ +0002d6a0: 6964 6162 6c65 2e0a 0a20 2020 4265 666f idable... Befo │ │ │ │ │ +0002d6b0: 7265 2077 6520 6469 7363 7573 7320 686f re we discuss ho │ │ │ │ │ +0002d6c0: 7720 746f 2075 7365 206c 6962 746f 6f6c w to use libtool │ │ │ │ │ +0002d6d0: 2077 6974 6820 4175 746f 6d61 6b65 2069 with Automake i │ │ │ │ │ +0002d6e0: 6e20 6465 7461 696c 732c 2069 740a 7368 n details, it.sh │ │ │ │ │ +0002d6f0: 6f75 6c64 2062 6520 6e6f 7465 6420 7468 ould be noted th │ │ │ │ │ +0002d700: 6174 2074 6865 206c 6962 746f 6f6c 206d at the libtool m │ │ │ │ │ +0002d710: 616e 7561 6c20 616c 736f 2068 6173 2061 anual also has a │ │ │ │ │ +0002d720: 2073 6563 7469 6f6e 2061 626f 7574 2068 section about h │ │ │ │ │ +0002d730: 6f77 2074 6f0a 7573 6520 4175 746f 6d61 ow to.use Automa │ │ │ │ │ +0002d740: 6b65 2077 6974 6820 6c69 6274 6f6f 6c20 ke with libtool │ │ │ │ │ +0002d750: 282a 6e6f 7465 2055 7369 6e67 2041 7574 (*note Using Aut │ │ │ │ │ +0002d760: 6f6d 616b 6520 7769 7468 204c 6962 746f omake with Libto │ │ │ │ │ +0002d770: 6f6c 3a0a 286c 6962 746f 6f6c 2955 7369 ol:.(libtool)Usi │ │ │ │ │ +0002d780: 6e67 2041 7574 6f6d 616b 652e 292e 0a0a ng Automake.)... │ │ │ │ │ +0002d790: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +0002d7a0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +0002d7b0: 653a 204c 6962 746f 6f6c 204c 6962 7261 e: Libtool Libra │ │ │ │ │ +0002d7c0: 7269 6573 2c20 204e 6578 743a 2043 6f6e ries, Next: Con │ │ │ │ │ +0002d7d0: 6469 7469 6f6e 616c 204c 6962 746f 6f6c ditional Libtool │ │ │ │ │ +0002d7e0: 204c 6962 7261 7269 6573 2c20 2050 7265 Libraries, Pre │ │ │ │ │ +0002d7f0: 763a 204c 6962 746f 6f6c 2043 6f6e 6365 v: Libtool Conce │ │ │ │ │ +0002d800: 7074 2c20 2055 703a 2041 2053 6861 7265 pt, Up: A Share │ │ │ │ │ +0002d810: 6420 4c69 6272 6172 790a 0a38 2e33 2e32 d Library..8.3.2 │ │ │ │ │ +0002d820: 2042 7569 6c64 696e 6720 4c69 6274 6f6f Building Libtoo │ │ │ │ │ +0002d830: 6c20 4c69 6272 6172 6965 730a 2d2d 2d2d l Libraries.---- │ │ │ │ │ 0002d840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002d850: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4175 746f ----------..Auto │ │ │ │ │ -0002d860: 6d61 6b65 2075 7365 7320 6c69 6274 6f6f make uses libtoo │ │ │ │ │ -0002d870: 6c20 746f 2062 7569 6c64 206c 6962 7261 l to build libra │ │ │ │ │ -0002d880: 7269 6573 2064 6563 6c61 7265 6420 7769 ries declared wi │ │ │ │ │ -0002d890: 7468 2074 6865 2027 4c54 4c49 4252 4152 th the 'LTLIBRAR │ │ │ │ │ -0002d8a0: 4945 5327 0a70 7269 6d61 7279 2e20 2045 IES'.primary. E │ │ │ │ │ -0002d8b0: 6163 6820 275f 4c54 4c49 4252 4152 4945 ach '_LTLIBRARIE │ │ │ │ │ -0002d8c0: 5327 2076 6172 6961 626c 6520 6973 2061 S' variable is a │ │ │ │ │ -0002d8d0: 206c 6973 7420 6f66 206c 6962 746f 6f6c list of libtool │ │ │ │ │ -0002d8e0: 206c 6962 7261 7269 6573 2074 6f0a 6275 libraries to.bu │ │ │ │ │ -0002d8f0: 696c 642e 2020 466f 7220 696e 7374 616e ild. For instan │ │ │ │ │ -0002d900: 6365 2c20 746f 2063 7265 6174 6520 6120 ce, to create a │ │ │ │ │ -0002d910: 6c69 6274 6f6f 6c20 6c69 6272 6172 7920 libtool library │ │ │ │ │ -0002d920: 6e61 6d65 6420 276c 6962 6765 7474 6578 named 'libgettex │ │ │ │ │ -0002d930: 742e 6c61 272c 0a61 6e64 2069 6e73 7461 t.la',.and insta │ │ │ │ │ -0002d940: 6c6c 2069 7420 696e 2027 6c69 6264 6972 ll it in 'libdir │ │ │ │ │ -0002d950: 272c 2077 7269 7465 3a0a 0a20 2020 2020 ', write:.. │ │ │ │ │ -0002d960: 6c69 625f 4c54 4c49 4252 4152 4945 5320 lib_LTLIBRARIES │ │ │ │ │ -0002d970: 3d20 6c69 6267 6574 7465 7874 2e6c 610a = libgettext.la. │ │ │ │ │ -0002d980: 2020 2020 206c 6962 6765 7474 6578 745f libgettext_ │ │ │ │ │ -0002d990: 6c61 5f53 4f55 5243 4553 203d 2067 6574 la_SOURCES = get │ │ │ │ │ -0002d9a0: 7465 7874 2e63 2067 6574 7465 7874 2e68 text.c gettext.h │ │ │ │ │ -0002d9b0: 202e 2e2e 0a0a 2020 2041 7574 6f6d 616b ..... Automak │ │ │ │ │ -0002d9c0: 6520 7072 6564 6566 696e 6573 2074 6865 e predefines the │ │ │ │ │ -0002d9d0: 2076 6172 6961 626c 6520 2770 6b67 6c69 variable 'pkgli │ │ │ │ │ -0002d9e0: 6264 6972 272c 2073 6f20 796f 7520 6361 bdir', so you ca │ │ │ │ │ -0002d9f0: 6e20 7573 650a 2770 6b67 6c69 625f 4c54 n use.'pkglib_LT │ │ │ │ │ -0002da00: 4c49 4252 4152 4945 5327 2074 6f20 696e LIBRARIES' to in │ │ │ │ │ -0002da10: 7374 616c 6c20 6c69 6272 6172 6965 7320 stall libraries │ │ │ │ │ -0002da20: 696e 2027 2428 6c69 6264 6972 292f 4050 in '$(libdir)/@P │ │ │ │ │ -0002da30: 4143 4b41 4745 402f 272e 0a0a 2020 2049 ACKAGE@/'... I │ │ │ │ │ -0002da40: 6620 2767 6574 7465 7874 2e68 2720 6973 f 'gettext.h' is │ │ │ │ │ -0002da50: 2061 2070 7562 6c69 6320 6865 6164 6572 a public header │ │ │ │ │ -0002da60: 2066 696c 6520 7468 6174 206e 6565 6473 file that needs │ │ │ │ │ -0002da70: 2074 6f20 6265 2069 6e73 7461 6c6c 6564 to be installed │ │ │ │ │ -0002da80: 2069 6e0a 6f72 6465 7220 666f 7220 7065 in.order for pe │ │ │ │ │ -0002da90: 6f70 6c65 2074 6f20 7573 6520 7468 6520 ople to use the │ │ │ │ │ -0002daa0: 6c69 6272 6172 792c 2069 7420 7368 6f75 library, it shou │ │ │ │ │ -0002dab0: 6c64 2062 6520 6465 636c 6172 6564 2075 ld be declared u │ │ │ │ │ -0002dac0: 7369 6e67 2061 0a27 5f48 4541 4445 5253 sing a.'_HEADERS │ │ │ │ │ -0002dad0: 2720 7661 7269 6162 6c65 2c20 6e6f 7420 ' variable, not │ │ │ │ │ -0002dae0: 696e 2027 6c69 6267 6574 7465 7874 5f6c in 'libgettext_l │ │ │ │ │ -0002daf0: 615f 534f 5552 4345 5327 2e20 2048 6561 a_SOURCES'. Hea │ │ │ │ │ -0002db00: 6465 7273 206c 6973 7465 6420 696e 0a74 ders listed in.t │ │ │ │ │ -0002db10: 6865 206c 6174 7465 7220 7368 6f75 6c64 he latter should │ │ │ │ │ -0002db20: 2062 6520 696e 7465 726e 616c 2068 6561 be internal hea │ │ │ │ │ -0002db30: 6465 7273 2074 6861 7420 6172 6520 6e6f ders that are no │ │ │ │ │ -0002db40: 7420 7061 7274 206f 6620 7468 6520 7075 t part of the pu │ │ │ │ │ -0002db50: 626c 6963 0a69 6e74 6572 6661 6365 2e0a blic.interface.. │ │ │ │ │ -0002db60: 0a20 2020 2020 6c69 625f 4c54 4c49 4252 . lib_LTLIBR │ │ │ │ │ -0002db70: 4152 4945 5320 3d20 6c69 6267 6574 7465 ARIES = libgette │ │ │ │ │ -0002db80: 7874 2e6c 610a 2020 2020 206c 6962 6765 xt.la. libge │ │ │ │ │ -0002db90: 7474 6578 745f 6c61 5f53 4f55 5243 4553 ttext_la_SOURCES │ │ │ │ │ -0002dba0: 203d 2067 6574 7465 7874 2e63 202e 2e2e = gettext.c ... │ │ │ │ │ -0002dbb0: 0a20 2020 2020 696e 636c 7564 655f 4845 . include_HE │ │ │ │ │ -0002dbc0: 4144 4552 5320 3d20 6765 7474 6578 742e ADERS = gettext. │ │ │ │ │ -0002dbd0: 6820 2e2e 2e0a 0a20 2020 4120 7061 636b h ..... A pack │ │ │ │ │ -0002dbe0: 6167 6520 6361 6e20 6275 696c 6420 616e age can build an │ │ │ │ │ -0002dbf0: 6420 696e 7374 616c 6c20 7375 6368 2061 d install such a │ │ │ │ │ -0002dc00: 206c 6962 7261 7279 2061 6c6f 6e67 2077 library along w │ │ │ │ │ -0002dc10: 6974 6820 6f74 6865 720a 7072 6f67 7261 ith other.progra │ │ │ │ │ -0002dc20: 6d73 2074 6861 7420 7573 6520 6974 2e20 ms that use it. │ │ │ │ │ -0002dc30: 2054 6869 7320 6465 7065 6e64 656e 6379 This dependency │ │ │ │ │ -0002dc40: 2073 686f 756c 6420 6265 2073 7065 6369 should be speci │ │ │ │ │ -0002dc50: 6669 6564 2075 7369 6e67 0a27 4c44 4144 fied using.'LDAD │ │ │ │ │ -0002dc60: 4427 2e20 2054 6865 2066 6f6c 6c6f 7769 D'. The followi │ │ │ │ │ -0002dc70: 6e67 2065 7861 6d70 6c65 2062 7569 6c64 ng example build │ │ │ │ │ -0002dc80: 7320 6120 7072 6f67 7261 6d20 6e61 6d65 s a program name │ │ │ │ │ -0002dc90: 6420 2768 656c 6c6f 2720 7468 6174 2069 d 'hello' that i │ │ │ │ │ -0002dca0: 730a 6c69 6e6b 6564 2077 6974 6820 276c s.linked with 'l │ │ │ │ │ -0002dcb0: 6962 6765 7474 6578 742e 6c61 272e 0a0a ibgettext.la'... │ │ │ │ │ -0002dcc0: 2020 2020 206c 6962 5f4c 544c 4942 5241 lib_LTLIBRA │ │ │ │ │ -0002dcd0: 5249 4553 203d 206c 6962 6765 7474 6578 RIES = libgettex │ │ │ │ │ -0002dce0: 742e 6c61 0a20 2020 2020 6c69 6267 6574 t.la. libget │ │ │ │ │ -0002dcf0: 7465 7874 5f6c 615f 534f 5552 4345 5320 text_la_SOURCES │ │ │ │ │ -0002dd00: 3d20 6765 7474 6578 742e 6320 2e2e 2e0a = gettext.c .... │ │ │ │ │ -0002dd10: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ -0002dd20: 4d53 203d 2068 656c 6c6f 0a20 2020 2020 MS = hello. │ │ │ │ │ -0002dd30: 6865 6c6c 6f5f 534f 5552 4345 5320 3d20 hello_SOURCES = │ │ │ │ │ -0002dd40: 6865 6c6c 6f2e 6320 2e2e 2e0a 2020 2020 hello.c .... │ │ │ │ │ -0002dd50: 2068 656c 6c6f 5f4c 4441 4444 203d 206c hello_LDADD = l │ │ │ │ │ -0002dd60: 6962 6765 7474 6578 742e 6c61 0a0a 5768 ibgettext.la..Wh │ │ │ │ │ -0002dd70: 6574 6865 7220 2768 656c 6c6f 2720 6973 ether 'hello' is │ │ │ │ │ -0002dd80: 2073 7461 7469 6361 6c6c 7920 6f72 2064 statically or d │ │ │ │ │ -0002dd90: 796e 616d 6963 616c 6c79 206c 696e 6b65 ynamically linke │ │ │ │ │ -0002dda0: 6420 7769 7468 2027 6c69 6267 6574 7465 d with 'libgette │ │ │ │ │ -0002ddb0: 7874 2e6c 6127 0a69 7320 6e6f 7420 7965 xt.la'.is not ye │ │ │ │ │ -0002ddc0: 7420 6b6e 6f77 6e3a 2074 6869 7320 7769 t known: this wi │ │ │ │ │ -0002ddd0: 6c6c 2064 6570 656e 6420 6f6e 2074 6865 ll depend on the │ │ │ │ │ -0002dde0: 2063 6f6e 6669 6775 7261 7469 6f6e 206f configuration o │ │ │ │ │ -0002ddf0: 6620 6c69 6274 6f6f 6c20 616e 640a 7468 f libtool and.th │ │ │ │ │ -0002de00: 6520 6361 7061 6269 6c69 7469 6573 206f e capabilities o │ │ │ │ │ -0002de10: 6620 7468 6520 686f 7374 2e0a 0a1f 0a46 f the host.....F │ │ │ │ │ -0002de20: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -0002de30: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -0002de40: 436f 6e64 6974 696f 6e61 6c20 4c69 6274 Conditional Libt │ │ │ │ │ -0002de50: 6f6f 6c20 4c69 6272 6172 6965 732c 2020 ool Libraries, │ │ │ │ │ -0002de60: 4e65 7874 3a20 436f 6e64 6974 696f 6e61 Next: Conditiona │ │ │ │ │ -0002de70: 6c20 4c69 6274 6f6f 6c20 536f 7572 6365 l Libtool Source │ │ │ │ │ -0002de80: 732c 2020 5072 6576 3a20 4c69 6274 6f6f s, Prev: Libtoo │ │ │ │ │ -0002de90: 6c20 4c69 6272 6172 6965 732c 2020 5570 l Libraries, Up │ │ │ │ │ -0002dea0: 3a20 4120 5368 6172 6564 204c 6962 7261 : A Shared Libra │ │ │ │ │ -0002deb0: 7279 0a0a 382e 332e 3320 4275 696c 6469 ry..8.3.3 Buildi │ │ │ │ │ -0002dec0: 6e67 204c 6962 746f 6f6c 204c 6962 7261 ng Libtool Libra │ │ │ │ │ -0002ded0: 7269 6573 2043 6f6e 6469 7469 6f6e 616c ries Conditional │ │ │ │ │ -0002dee0: 6c79 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ly.------------- │ │ │ │ │ +0002d850: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4175 ------------..Au │ │ │ │ │ +0002d860: 746f 6d61 6b65 2075 7365 7320 6c69 6274 tomake uses libt │ │ │ │ │ +0002d870: 6f6f 6c20 746f 2062 7569 6c64 206c 6962 ool to build lib │ │ │ │ │ +0002d880: 7261 7269 6573 2064 6563 6c61 7265 6420 raries declared │ │ │ │ │ +0002d890: 7769 7468 2074 6865 2027 4c54 4c49 4252 with the 'LTLIBR │ │ │ │ │ +0002d8a0: 4152 4945 5327 0a70 7269 6d61 7279 2e20 ARIES'.primary. │ │ │ │ │ +0002d8b0: 2045 6163 6820 275f 4c54 4c49 4252 4152 Each '_LTLIBRAR │ │ │ │ │ +0002d8c0: 4945 5327 2076 6172 6961 626c 6520 6973 IES' variable is │ │ │ │ │ +0002d8d0: 2061 206c 6973 7420 6f66 206c 6962 746f a list of libto │ │ │ │ │ +0002d8e0: 6f6c 206c 6962 7261 7269 6573 2074 6f0a ol libraries to. │ │ │ │ │ +0002d8f0: 6275 696c 642e 2020 466f 7220 696e 7374 build. For inst │ │ │ │ │ +0002d900: 616e 6365 2c20 746f 2063 7265 6174 6520 ance, to create │ │ │ │ │ +0002d910: 6120 6c69 6274 6f6f 6c20 6c69 6272 6172 a libtool librar │ │ │ │ │ +0002d920: 7920 6e61 6d65 6420 276c 6962 6765 7474 y named 'libgett │ │ │ │ │ +0002d930: 6578 742e 6c61 272c 0a61 6e64 2069 6e73 ext.la',.and ins │ │ │ │ │ +0002d940: 7461 6c6c 2069 7420 696e 2027 6c69 6264 tall it in 'libd │ │ │ │ │ +0002d950: 6972 272c 2077 7269 7465 3a0a 0a20 2020 ir', write:.. │ │ │ │ │ +0002d960: 2020 6c69 625f 4c54 4c49 4252 4152 4945 lib_LTLIBRARIE │ │ │ │ │ +0002d970: 5320 3d20 6c69 6267 6574 7465 7874 2e6c S = libgettext.l │ │ │ │ │ +0002d980: 610a 2020 2020 206c 6962 6765 7474 6578 a. libgettex │ │ │ │ │ +0002d990: 745f 6c61 5f53 4f55 5243 4553 203d 2067 t_la_SOURCES = g │ │ │ │ │ +0002d9a0: 6574 7465 7874 2e63 2067 6574 7465 7874 ettext.c gettext │ │ │ │ │ +0002d9b0: 2e68 202e 2e2e 0a0a 2020 2041 7574 6f6d .h ..... Autom │ │ │ │ │ +0002d9c0: 616b 6520 7072 6564 6566 696e 6573 2074 ake predefines t │ │ │ │ │ +0002d9d0: 6865 2076 6172 6961 626c 6520 2770 6b67 he variable 'pkg │ │ │ │ │ +0002d9e0: 6c69 6264 6972 272c 2073 6f20 796f 7520 libdir', so you │ │ │ │ │ +0002d9f0: 6361 6e20 7573 650a 2770 6b67 6c69 625f can use.'pkglib_ │ │ │ │ │ +0002da00: 4c54 4c49 4252 4152 4945 5327 2074 6f20 LTLIBRARIES' to │ │ │ │ │ +0002da10: 696e 7374 616c 6c20 6c69 6272 6172 6965 install librarie │ │ │ │ │ +0002da20: 7320 696e 2027 2428 6c69 6264 6972 292f s in '$(libdir)/ │ │ │ │ │ +0002da30: 4050 4143 4b41 4745 402f 272e 0a0a 2020 @PACKAGE@/'... │ │ │ │ │ +0002da40: 2049 6620 2767 6574 7465 7874 2e68 2720 If 'gettext.h' │ │ │ │ │ +0002da50: 6973 2061 2070 7562 6c69 6320 6865 6164 is a public head │ │ │ │ │ +0002da60: 6572 2066 696c 6520 7468 6174 206e 6565 er file that nee │ │ │ │ │ +0002da70: 6473 2074 6f20 6265 2069 6e73 7461 6c6c ds to be install │ │ │ │ │ +0002da80: 6564 2069 6e0a 6f72 6465 7220 666f 7220 ed in.order for │ │ │ │ │ +0002da90: 7065 6f70 6c65 2074 6f20 7573 6520 7468 people to use th │ │ │ │ │ +0002daa0: 6520 6c69 6272 6172 792c 2069 7420 7368 e library, it sh │ │ │ │ │ +0002dab0: 6f75 6c64 2062 6520 6465 636c 6172 6564 ould be declared │ │ │ │ │ +0002dac0: 2075 7369 6e67 2061 0a27 5f48 4541 4445 using a.'_HEADE │ │ │ │ │ +0002dad0: 5253 2720 7661 7269 6162 6c65 2c20 6e6f RS' variable, no │ │ │ │ │ +0002dae0: 7420 696e 2027 6c69 6267 6574 7465 7874 t in 'libgettext │ │ │ │ │ +0002daf0: 5f6c 615f 534f 5552 4345 5327 2e20 2048 _la_SOURCES'. H │ │ │ │ │ +0002db00: 6561 6465 7273 206c 6973 7465 6420 696e eaders listed in │ │ │ │ │ +0002db10: 0a74 6865 206c 6174 7465 7220 7368 6f75 .the latter shou │ │ │ │ │ +0002db20: 6c64 2062 6520 696e 7465 726e 616c 2068 ld be internal h │ │ │ │ │ +0002db30: 6561 6465 7273 2074 6861 7420 6172 6520 eaders that are │ │ │ │ │ +0002db40: 6e6f 7420 7061 7274 206f 6620 7468 6520 not part of the │ │ │ │ │ +0002db50: 7075 626c 6963 0a69 6e74 6572 6661 6365 public.interface │ │ │ │ │ +0002db60: 2e0a 0a20 2020 2020 6c69 625f 4c54 4c49 ... lib_LTLI │ │ │ │ │ +0002db70: 4252 4152 4945 5320 3d20 6c69 6267 6574 BRARIES = libget │ │ │ │ │ +0002db80: 7465 7874 2e6c 610a 2020 2020 206c 6962 text.la. lib │ │ │ │ │ +0002db90: 6765 7474 6578 745f 6c61 5f53 4f55 5243 gettext_la_SOURC │ │ │ │ │ +0002dba0: 4553 203d 2067 6574 7465 7874 2e63 202e ES = gettext.c . │ │ │ │ │ +0002dbb0: 2e2e 0a20 2020 2020 696e 636c 7564 655f ... include_ │ │ │ │ │ +0002dbc0: 4845 4144 4552 5320 3d20 6765 7474 6578 HEADERS = gettex │ │ │ │ │ +0002dbd0: 742e 6820 2e2e 2e0a 0a20 2020 4120 7061 t.h ..... A pa │ │ │ │ │ +0002dbe0: 636b 6167 6520 6361 6e20 6275 696c 6420 ckage can build │ │ │ │ │ +0002dbf0: 616e 6420 696e 7374 616c 6c20 7375 6368 and install such │ │ │ │ │ +0002dc00: 2061 206c 6962 7261 7279 2061 6c6f 6e67 a library along │ │ │ │ │ +0002dc10: 2077 6974 6820 6f74 6865 720a 7072 6f67 with other.prog │ │ │ │ │ +0002dc20: 7261 6d73 2074 6861 7420 7573 6520 6974 rams that use it │ │ │ │ │ +0002dc30: 2e20 2054 6869 7320 6465 7065 6e64 656e . This dependen │ │ │ │ │ +0002dc40: 6379 2073 686f 756c 6420 6265 2073 7065 cy should be spe │ │ │ │ │ +0002dc50: 6369 6669 6564 2075 7369 6e67 0a27 4c44 cified using.'LD │ │ │ │ │ +0002dc60: 4144 4427 2e20 2054 6865 2066 6f6c 6c6f ADD'. The follo │ │ │ │ │ +0002dc70: 7769 6e67 2065 7861 6d70 6c65 2062 7569 wing example bui │ │ │ │ │ +0002dc80: 6c64 7320 6120 7072 6f67 7261 6d20 6e61 lds a program na │ │ │ │ │ +0002dc90: 6d65 6420 2768 656c 6c6f 2720 7468 6174 med 'hello' that │ │ │ │ │ +0002dca0: 2069 730a 6c69 6e6b 6564 2077 6974 6820 is.linked with │ │ │ │ │ +0002dcb0: 276c 6962 6765 7474 6578 742e 6c61 272e 'libgettext.la'. │ │ │ │ │ +0002dcc0: 0a0a 2020 2020 206c 6962 5f4c 544c 4942 .. lib_LTLIB │ │ │ │ │ +0002dcd0: 5241 5249 4553 203d 206c 6962 6765 7474 RARIES = libgett │ │ │ │ │ +0002dce0: 6578 742e 6c61 0a20 2020 2020 6c69 6267 ext.la. libg │ │ │ │ │ +0002dcf0: 6574 7465 7874 5f6c 615f 534f 5552 4345 ettext_la_SOURCE │ │ │ │ │ +0002dd00: 5320 3d20 6765 7474 6578 742e 6320 2e2e S = gettext.c .. │ │ │ │ │ +0002dd10: 2e0a 0a20 2020 2020 6269 6e5f 5052 4f47 ... bin_PROG │ │ │ │ │ +0002dd20: 5241 4d53 203d 2068 656c 6c6f 0a20 2020 RAMS = hello. │ │ │ │ │ +0002dd30: 2020 6865 6c6c 6f5f 534f 5552 4345 5320 hello_SOURCES │ │ │ │ │ +0002dd40: 3d20 6865 6c6c 6f2e 6320 2e2e 2e0a 2020 = hello.c .... │ │ │ │ │ +0002dd50: 2020 2068 656c 6c6f 5f4c 4441 4444 203d hello_LDADD = │ │ │ │ │ +0002dd60: 206c 6962 6765 7474 6578 742e 6c61 0a0a libgettext.la.. │ │ │ │ │ +0002dd70: 5768 6574 6865 7220 2768 656c 6c6f 2720 Whether 'hello' │ │ │ │ │ +0002dd80: 6973 2073 7461 7469 6361 6c6c 7920 6f72 is statically or │ │ │ │ │ +0002dd90: 2064 796e 616d 6963 616c 6c79 206c 696e dynamically lin │ │ │ │ │ +0002dda0: 6b65 6420 7769 7468 2027 6c69 6267 6574 ked with 'libget │ │ │ │ │ +0002ddb0: 7465 7874 2e6c 6127 0a69 7320 6e6f 7420 text.la'.is not │ │ │ │ │ +0002ddc0: 7965 7420 6b6e 6f77 6e3a 2074 6869 7320 yet known: this │ │ │ │ │ +0002ddd0: 7769 6c6c 2064 6570 656e 6420 6f6e 2074 will depend on t │ │ │ │ │ +0002dde0: 6865 2063 6f6e 6669 6775 7261 7469 6f6e he configuration │ │ │ │ │ +0002ddf0: 206f 6620 6c69 6274 6f6f 6c20 616e 640a of libtool and. │ │ │ │ │ +0002de00: 7468 6520 6361 7061 6269 6c69 7469 6573 the capabilities │ │ │ │ │ +0002de10: 206f 6620 7468 6520 686f 7374 2e0a 0a1f of the host.... │ │ │ │ │ +0002de20: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +0002de30: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +0002de40: 3a20 436f 6e64 6974 696f 6e61 6c20 4c69 : Conditional Li │ │ │ │ │ +0002de50: 6274 6f6f 6c20 4c69 6272 6172 6965 732c btool Libraries, │ │ │ │ │ +0002de60: 2020 4e65 7874 3a20 436f 6e64 6974 696f Next: Conditio │ │ │ │ │ +0002de70: 6e61 6c20 4c69 6274 6f6f 6c20 536f 7572 nal Libtool Sour │ │ │ │ │ +0002de80: 6365 732c 2020 5072 6576 3a20 4c69 6274 ces, Prev: Libt │ │ │ │ │ +0002de90: 6f6f 6c20 4c69 6272 6172 6965 732c 2020 ool Libraries, │ │ │ │ │ +0002dea0: 5570 3a20 4120 5368 6172 6564 204c 6962 Up: A Shared Lib │ │ │ │ │ +0002deb0: 7261 7279 0a0a 382e 332e 3320 4275 696c rary..8.3.3 Buil │ │ │ │ │ +0002dec0: 6469 6e67 204c 6962 746f 6f6c 204c 6962 ding Libtool Lib │ │ │ │ │ +0002ded0: 7261 7269 6573 2043 6f6e 6469 7469 6f6e raries Condition │ │ │ │ │ +0002dee0: 616c 6c79 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d ally.----------- │ │ │ │ │ 0002def0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0002df00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002df10: 2d0a 0a4c 696b 6520 636f 6e64 6974 696f -..Like conditio │ │ │ │ │ -0002df20: 6e61 6c20 7072 6f67 7261 6d73 2028 2a6e nal programs (*n │ │ │ │ │ -0002df30: 6f74 6520 436f 6e64 6974 696f 6e61 6c20 ote Conditional │ │ │ │ │ -0002df40: 5072 6f67 7261 6d73 3a3a 292c 2074 6865 Programs::), the │ │ │ │ │ -0002df50: 7265 2061 7265 2074 776f 0a6d 6169 6e20 re are two.main │ │ │ │ │ -0002df60: 7761 7973 2074 6f20 6275 696c 6420 636f ways to build co │ │ │ │ │ -0002df70: 6e64 6974 696f 6e61 6c20 6c69 6272 6172 nditional librar │ │ │ │ │ -0002df80: 6965 733a 2075 7369 6e67 2041 7574 6f6d ies: using Autom │ │ │ │ │ -0002df90: 616b 6520 636f 6e64 6974 696f 6e61 6c73 ake conditionals │ │ │ │ │ -0002dfa0: 206f 720a 7573 696e 6720 4175 746f 636f or.using Autoco │ │ │ │ │ -0002dfb0: 6e66 2027 4143 5f53 5542 5354 2769 7475 nf 'AC_SUBST'itu │ │ │ │ │ -0002dfc0: 7469 6f6e 732e 0a0a 2020 2054 6865 2069 tions... The i │ │ │ │ │ -0002dfd0: 6d70 6f72 7461 6e74 2069 6d70 6c65 6d65 mportant impleme │ │ │ │ │ -0002dfe0: 6e74 6174 696f 6e20 6465 7461 696c 2079 ntation detail y │ │ │ │ │ -0002dff0: 6f75 2068 6176 6520 746f 2062 6520 6177 ou have to be aw │ │ │ │ │ -0002e000: 6172 6520 6f66 2069 7320 7468 6174 0a74 are of is that.t │ │ │ │ │ -0002e010: 6865 2070 6c61 6365 2077 6865 7265 2061 he place where a │ │ │ │ │ -0002e020: 206c 6962 7261 7279 2077 696c 6c20 6265 library will be │ │ │ │ │ -0002e030: 2069 6e73 7461 6c6c 6564 206d 6174 7465 installed matte │ │ │ │ │ -0002e040: 7273 2074 6f20 6c69 6274 6f6f 6c3a 2069 rs to libtool: i │ │ │ │ │ -0002e050: 7420 6e65 6564 730a 746f 2062 6520 696e t needs.to be in │ │ │ │ │ -0002e060: 6469 6361 7465 6420 5f61 7420 6c69 6e6b dicated _at link │ │ │ │ │ -0002e070: 2d74 696d 655f 2075 7369 6e67 2074 6865 -time_ using the │ │ │ │ │ -0002e080: 2027 2d72 7061 7468 2720 6f70 7469 6f6e '-rpath' option │ │ │ │ │ -0002e090: 2e0a 0a20 2020 466f 7220 6c69 6272 6172 ... For librar │ │ │ │ │ -0002e0a0: 6965 7320 7768 6f73 6520 6465 7374 696e ies whose destin │ │ │ │ │ -0002e0b0: 6174 696f 6e20 6469 7265 6374 6f72 7920 ation directory │ │ │ │ │ -0002e0c0: 6973 206b 6e6f 776e 2077 6865 6e20 4175 is known when Au │ │ │ │ │ -0002e0d0: 746f 6d61 6b65 0a72 756e 732c 2041 7574 tomake.runs, Aut │ │ │ │ │ -0002e0e0: 6f6d 616b 6520 7769 6c6c 2061 7574 6f6d omake will autom │ │ │ │ │ -0002e0f0: 6174 6963 616c 6c79 2073 7570 706c 7920 atically supply │ │ │ │ │ -0002e100: 7468 6520 6170 7072 6f70 7269 6174 6520 the appropriate │ │ │ │ │ -0002e110: 272d 7270 6174 6827 206f 7074 696f 6e0a '-rpath' option. │ │ │ │ │ -0002e120: 746f 206c 6962 746f 6f6c 2e20 2054 6869 to libtool. Thi │ │ │ │ │ -0002e130: 7320 6973 2074 6865 2063 6173 6520 666f s is the case fo │ │ │ │ │ -0002e140: 7220 6c69 6272 6172 6965 7320 6c69 7374 r libraries list │ │ │ │ │ -0002e150: 6564 2065 7870 6c69 6369 746c 7920 696e ed explicitly in │ │ │ │ │ -0002e160: 2073 6f6d 650a 696e 7374 616c 6c61 626c some.installabl │ │ │ │ │ -0002e170: 6520 275f 4c54 4c49 4252 4152 4945 5327 e '_LTLIBRARIES' │ │ │ │ │ -0002e180: 2076 6172 6961 626c 6573 2073 7563 6820 variables such │ │ │ │ │ -0002e190: 6173 2027 6c69 625f 4c54 4c49 4252 4152 as 'lib_LTLIBRAR │ │ │ │ │ -0002e1a0: 4945 5327 2e0a 0a20 2020 486f 7765 7665 IES'... Howeve │ │ │ │ │ -0002e1b0: 722c 2066 6f72 206c 6962 7261 7269 6573 r, for libraries │ │ │ │ │ -0002e1c0: 2064 6574 6572 6d69 6e65 6420 6174 2063 determined at c │ │ │ │ │ -0002e1d0: 6f6e 6669 6775 7265 2074 696d 6520 2861 onfigure time (a │ │ │ │ │ -0002e1e0: 6e64 2074 6875 730a 6d65 6e74 696f 6e65 nd thus.mentione │ │ │ │ │ -0002e1f0: 6420 696e 2027 4558 5452 415f 4c54 4c49 d in 'EXTRA_LTLI │ │ │ │ │ -0002e200: 4252 4152 4945 5327 292c 2041 7574 6f6d BRARIES'), Autom │ │ │ │ │ -0002e210: 616b 6520 646f 6573 206e 6f74 206b 6e6f ake does not kno │ │ │ │ │ -0002e220: 7720 7468 6520 6669 6e61 6c0a 696e 7374 w the final.inst │ │ │ │ │ -0002e230: 616c 6c61 7469 6f6e 2064 6972 6563 746f allation directo │ │ │ │ │ -0002e240: 7279 2e20 2046 6f72 2073 7563 6820 6c69 ry. For such li │ │ │ │ │ -0002e250: 6272 6172 6965 7320 796f 7520 6d75 7374 braries you must │ │ │ │ │ -0002e260: 2061 6464 2074 6865 2027 2d72 7061 7468 add the '-rpath │ │ │ │ │ -0002e270: 270a 6f70 7469 6f6e 2074 6f20 7468 6520 '.option to the │ │ │ │ │ -0002e280: 6170 7072 6f70 7269 6174 6520 275f 4c44 appropriate '_LD │ │ │ │ │ -0002e290: 464c 4147 5327 2076 6172 6961 626c 6520 FLAGS' variable │ │ │ │ │ -0002e2a0: 6279 2068 616e 642e 0a0a 2020 2054 6865 by hand... The │ │ │ │ │ -0002e2b0: 2065 7861 6d70 6c65 7320 6265 6c6f 7720 examples below │ │ │ │ │ -0002e2c0: 696c 6c75 7374 7261 7465 2074 6865 2064 illustrate the d │ │ │ │ │ -0002e2d0: 6966 6665 7265 6e63 6573 2062 6574 7765 ifferences betwe │ │ │ │ │ -0002e2e0: 656e 2074 6865 7365 2074 776f 0a6d 6574 en these two.met │ │ │ │ │ -0002e2f0: 686f 6473 2e0a 0a20 2020 4865 7265 2069 hods... Here i │ │ │ │ │ -0002e300: 7320 616e 2065 7861 6d70 6c65 2077 6865 s an example whe │ │ │ │ │ -0002e310: 7265 2027 5741 4e54 4544 4c49 4253 2720 re 'WANTEDLIBS' │ │ │ │ │ -0002e320: 6973 2061 6e20 2741 435f 5355 4253 5427 is an 'AC_SUBST' │ │ │ │ │ -0002e330: 6564 2076 6172 6961 626c 6520 7365 740a ed variable set. │ │ │ │ │ -0002e340: 6174 2027 2e2f 636f 6e66 6967 7572 6527 at './configure' │ │ │ │ │ -0002e350: 2d74 696d 6520 746f 2065 6974 6865 7220 -time to either │ │ │ │ │ -0002e360: 276c 6962 666f 6f2e 6c61 272c 2027 6c69 'libfoo.la', 'li │ │ │ │ │ -0002e370: 6262 6172 2e6c 6127 2c20 626f 7468 2c20 bbar.la', both, │ │ │ │ │ -0002e380: 6f72 206e 6f6e 652e 0a41 6c74 686f 7567 or none..Althoug │ │ │ │ │ -0002e390: 6820 2724 2857 414e 5445 444c 4942 5329 h '$(WANTEDLIBS) │ │ │ │ │ -0002e3a0: 2720 6170 7065 6172 7320 696e 2074 6865 ' appears in the │ │ │ │ │ -0002e3b0: 2027 6c69 625f 4c54 4c49 4252 4152 4945 'lib_LTLIBRARIE │ │ │ │ │ -0002e3c0: 5327 2c20 4175 746f 6d61 6b65 0a63 616e S', Automake.can │ │ │ │ │ -0002e3d0: 6e6f 7420 6775 6573 7320 6974 2072 656c not guess it rel │ │ │ │ │ -0002e3e0: 6174 6573 2074 6f20 276c 6962 666f 6f2e ates to 'libfoo. │ │ │ │ │ -0002e3f0: 6c61 2720 6f72 2027 6c69 6262 6172 2e6c la' or 'libbar.l │ │ │ │ │ -0002e400: 6127 2061 7420 7468 6520 7469 6d65 2069 a' at the time i │ │ │ │ │ -0002e410: 740a 6372 6561 7465 7320 7468 6520 6c69 t.creates the li │ │ │ │ │ -0002e420: 6e6b 2072 756c 6520 666f 7220 7468 6573 nk rule for thes │ │ │ │ │ -0002e430: 6520 7477 6f20 6c69 6272 6172 6965 732e e two libraries. │ │ │ │ │ -0002e440: 2020 5468 6572 6566 6f72 6520 7468 6520 Therefore the │ │ │ │ │ -0002e450: 272d 7270 6174 6827 0a61 7267 756d 656e '-rpath'.argumen │ │ │ │ │ -0002e460: 7420 6d75 7374 2062 6520 6578 706c 6963 t must be explic │ │ │ │ │ -0002e470: 6974 6c79 2073 7570 706c 6965 642e 0a0a itly supplied... │ │ │ │ │ -0002e480: 2020 2020 2045 5854 5241 5f4c 544c 4942 EXTRA_LTLIB │ │ │ │ │ -0002e490: 5241 5249 4553 203d 206c 6962 666f 6f2e RARIES = libfoo. │ │ │ │ │ -0002e4a0: 6c61 206c 6962 6261 722e 6c61 0a20 2020 la libbar.la. │ │ │ │ │ -0002e4b0: 2020 6c69 625f 4c54 4c49 4252 4152 4945 lib_LTLIBRARIE │ │ │ │ │ -0002e4c0: 5320 3d20 2428 5741 4e54 4544 4c49 4253 S = $(WANTEDLIBS │ │ │ │ │ -0002e4d0: 290a 2020 2020 206c 6962 666f 6f5f 6c61 ). libfoo_la │ │ │ │ │ -0002e4e0: 5f53 4f55 5243 4553 203d 2066 6f6f 2e63 _SOURCES = foo.c │ │ │ │ │ -0002e4f0: 202e 2e2e 0a20 2020 2020 6c69 6266 6f6f .... libfoo │ │ │ │ │ -0002e500: 5f6c 615f 4c44 464c 4147 5320 3d20 2d72 _la_LDFLAGS = -r │ │ │ │ │ -0002e510: 7061 7468 2027 2428 6c69 6264 6972 2927 path '$(libdir)' │ │ │ │ │ -0002e520: 0a20 2020 2020 6c69 6262 6172 5f6c 615f . libbar_la_ │ │ │ │ │ -0002e530: 534f 5552 4345 5320 3d20 6261 722e 6320 SOURCES = bar.c │ │ │ │ │ -0002e540: 2e2e 2e0a 2020 2020 206c 6962 6261 725f .... libbar_ │ │ │ │ │ -0002e550: 6c61 5f4c 4446 4c41 4753 203d 202d 7270 la_LDFLAGS = -rp │ │ │ │ │ -0002e560: 6174 6820 2724 286c 6962 6469 7229 270a ath '$(libdir)'. │ │ │ │ │ -0002e570: 0a20 2020 4865 7265 2069 7320 686f 7720 . Here is how │ │ │ │ │ -0002e580: 7468 6520 7361 6d65 2027 4d61 6b65 6669 the same 'Makefi │ │ │ │ │ -0002e590: 6c65 2e61 6d27 2077 6f75 6c64 206c 6f6f le.am' would loo │ │ │ │ │ -0002e5a0: 6b20 7573 696e 6720 4175 746f 6d61 6b65 k using Automake │ │ │ │ │ -0002e5b0: 0a63 6f6e 6469 7469 6f6e 616c 7320 6e61 .conditionals na │ │ │ │ │ -0002e5c0: 6d65 6420 2757 414e 545f 4c49 4246 4f4f med 'WANT_LIBFOO │ │ │ │ │ -0002e5d0: 2720 616e 6420 2757 414e 545f 4c49 4242 ' and 'WANT_LIBB │ │ │ │ │ -0002e5e0: 4152 272e 2020 4e6f 7720 4175 746f 6d61 AR'. Now Automa │ │ │ │ │ -0002e5f0: 6b65 2069 730a 6162 6c65 2074 6f20 636f ke is.able to co │ │ │ │ │ -0002e600: 6d70 7574 6520 7468 6520 272d 7270 6174 mpute the '-rpat │ │ │ │ │ -0002e610: 6827 2073 6574 7469 6e67 2069 7473 656c h' setting itsel │ │ │ │ │ -0002e620: 662c 2062 6563 6175 7365 2069 7427 7320 f, because it's │ │ │ │ │ -0002e630: 636c 6561 7220 7468 6174 0a62 6f74 6820 clear that.both │ │ │ │ │ -0002e640: 6c69 6272 6172 6965 7320 7769 6c6c 2065 libraries will e │ │ │ │ │ -0002e650: 6e64 2075 7020 696e 2027 2428 6c69 6264 nd up in '$(libd │ │ │ │ │ -0002e660: 6972 2927 2069 6620 7468 6579 2061 7265 ir)' if they are │ │ │ │ │ -0002e670: 2069 6e73 7461 6c6c 6564 2e0a 0a20 2020 installed... │ │ │ │ │ -0002e680: 2020 6c69 625f 4c54 4c49 4252 4152 4945 lib_LTLIBRARIE │ │ │ │ │ -0002e690: 5320 3d0a 2020 2020 2069 6620 5741 4e54 S =. if WANT │ │ │ │ │ -0002e6a0: 5f4c 4942 464f 4f0a 2020 2020 206c 6962 _LIBFOO. lib │ │ │ │ │ -0002e6b0: 5f4c 544c 4942 5241 5249 4553 202b 3d20 _LTLIBRARIES += │ │ │ │ │ -0002e6c0: 6c69 6266 6f6f 2e6c 610a 2020 2020 2065 libfoo.la. e │ │ │ │ │ -0002e6d0: 6e64 6966 0a20 2020 2020 6966 2057 414e ndif. if WAN │ │ │ │ │ -0002e6e0: 545f 4c49 4242 4152 0a20 2020 2020 6c69 T_LIBBAR. li │ │ │ │ │ -0002e6f0: 625f 4c54 4c49 4252 4152 4945 5320 2b3d b_LTLIBRARIES += │ │ │ │ │ -0002e700: 206c 6962 6261 722e 6c61 0a20 2020 2020 libbar.la. │ │ │ │ │ -0002e710: 656e 6469 660a 2020 2020 206c 6962 666f endif. libfo │ │ │ │ │ -0002e720: 6f5f 6c61 5f53 4f55 5243 4553 203d 2066 o_la_SOURCES = f │ │ │ │ │ -0002e730: 6f6f 2e63 202e 2e2e 0a20 2020 2020 6c69 oo.c .... li │ │ │ │ │ -0002e740: 6262 6172 5f6c 615f 534f 5552 4345 5320 bbar_la_SOURCES │ │ │ │ │ -0002e750: 3d20 6261 722e 6320 2e2e 2e0a 0a1f 0a46 = bar.c .......F │ │ │ │ │ -0002e760: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -0002e770: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -0002e780: 436f 6e64 6974 696f 6e61 6c20 4c69 6274 Conditional Libt │ │ │ │ │ -0002e790: 6f6f 6c20 536f 7572 6365 732c 2020 4e65 ool Sources, Ne │ │ │ │ │ -0002e7a0: 7874 3a20 4c69 6274 6f6f 6c20 436f 6e76 xt: Libtool Conv │ │ │ │ │ -0002e7b0: 656e 6965 6e63 6520 4c69 6272 6172 6965 enience Librarie │ │ │ │ │ -0002e7c0: 732c 2020 5072 6576 3a20 436f 6e64 6974 s, Prev: Condit │ │ │ │ │ -0002e7d0: 696f 6e61 6c20 4c69 6274 6f6f 6c20 4c69 ional Libtool Li │ │ │ │ │ -0002e7e0: 6272 6172 6965 732c 2020 5570 3a20 4120 braries, Up: A │ │ │ │ │ -0002e7f0: 5368 6172 6564 204c 6962 7261 7279 0a0a Shared Library.. │ │ │ │ │ -0002e800: 382e 332e 3420 4c69 6274 6f6f 6c20 4c69 8.3.4 Libtool Li │ │ │ │ │ -0002e810: 6272 6172 6965 7320 7769 7468 2043 6f6e braries with Con │ │ │ │ │ -0002e820: 6469 7469 6f6e 616c 2053 6f75 7263 6573 ditional Sources │ │ │ │ │ -0002e830: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0002df10: 2d2d 2d0a 0a4c 696b 6520 636f 6e64 6974 ---..Like condit │ │ │ │ │ +0002df20: 696f 6e61 6c20 7072 6f67 7261 6d73 2028 ional programs ( │ │ │ │ │ +0002df30: 2a6e 6f74 6520 436f 6e64 6974 696f 6e61 *note Conditiona │ │ │ │ │ +0002df40: 6c20 5072 6f67 7261 6d73 3a3a 292c 2074 l Programs::), t │ │ │ │ │ +0002df50: 6865 7265 2061 7265 2074 776f 0a6d 6169 here are two.mai │ │ │ │ │ +0002df60: 6e20 7761 7973 2074 6f20 6275 696c 6420 n ways to build │ │ │ │ │ +0002df70: 636f 6e64 6974 696f 6e61 6c20 6c69 6272 conditional libr │ │ │ │ │ +0002df80: 6172 6965 733a 2075 7369 6e67 2041 7574 aries: using Aut │ │ │ │ │ +0002df90: 6f6d 616b 6520 636f 6e64 6974 696f 6e61 omake conditiona │ │ │ │ │ +0002dfa0: 6c73 206f 720a 7573 696e 6720 4175 746f ls or.using Auto │ │ │ │ │ +0002dfb0: 636f 6e66 2027 4143 5f53 5542 5354 2769 conf 'AC_SUBST'i │ │ │ │ │ +0002dfc0: 7475 7469 6f6e 732e 0a0a 2020 2054 6865 tutions... The │ │ │ │ │ +0002dfd0: 2069 6d70 6f72 7461 6e74 2069 6d70 6c65 important imple │ │ │ │ │ +0002dfe0: 6d65 6e74 6174 696f 6e20 6465 7461 696c mentation detail │ │ │ │ │ +0002dff0: 2079 6f75 2068 6176 6520 746f 2062 6520 you have to be │ │ │ │ │ +0002e000: 6177 6172 6520 6f66 2069 7320 7468 6174 aware of is that │ │ │ │ │ +0002e010: 0a74 6865 2070 6c61 6365 2077 6865 7265 .the place where │ │ │ │ │ +0002e020: 2061 206c 6962 7261 7279 2077 696c 6c20 a library will │ │ │ │ │ +0002e030: 6265 2069 6e73 7461 6c6c 6564 206d 6174 be installed mat │ │ │ │ │ +0002e040: 7465 7273 2074 6f20 6c69 6274 6f6f 6c3a ters to libtool: │ │ │ │ │ +0002e050: 2069 7420 6e65 6564 730a 746f 2062 6520 it needs.to be │ │ │ │ │ +0002e060: 696e 6469 6361 7465 6420 5f61 7420 6c69 indicated _at li │ │ │ │ │ +0002e070: 6e6b 2d74 696d 655f 2075 7369 6e67 2074 nk-time_ using t │ │ │ │ │ +0002e080: 6865 2027 2d72 7061 7468 2720 6f70 7469 he '-rpath' opti │ │ │ │ │ +0002e090: 6f6e 2e0a 0a20 2020 466f 7220 6c69 6272 on... For libr │ │ │ │ │ +0002e0a0: 6172 6965 7320 7768 6f73 6520 6465 7374 aries whose dest │ │ │ │ │ +0002e0b0: 696e 6174 696f 6e20 6469 7265 6374 6f72 ination director │ │ │ │ │ +0002e0c0: 7920 6973 206b 6e6f 776e 2077 6865 6e20 y is known when │ │ │ │ │ +0002e0d0: 4175 746f 6d61 6b65 0a72 756e 732c 2041 Automake.runs, A │ │ │ │ │ +0002e0e0: 7574 6f6d 616b 6520 7769 6c6c 2061 7574 utomake will aut │ │ │ │ │ +0002e0f0: 6f6d 6174 6963 616c 6c79 2073 7570 706c omatically suppl │ │ │ │ │ +0002e100: 7920 7468 6520 6170 7072 6f70 7269 6174 y the appropriat │ │ │ │ │ +0002e110: 6520 272d 7270 6174 6827 206f 7074 696f e '-rpath' optio │ │ │ │ │ +0002e120: 6e0a 746f 206c 6962 746f 6f6c 2e20 2054 n.to libtool. T │ │ │ │ │ +0002e130: 6869 7320 6973 2074 6865 2063 6173 6520 his is the case │ │ │ │ │ +0002e140: 666f 7220 6c69 6272 6172 6965 7320 6c69 for libraries li │ │ │ │ │ +0002e150: 7374 6564 2065 7870 6c69 6369 746c 7920 sted explicitly │ │ │ │ │ +0002e160: 696e 2073 6f6d 650a 696e 7374 616c 6c61 in some.installa │ │ │ │ │ +0002e170: 626c 6520 275f 4c54 4c49 4252 4152 4945 ble '_LTLIBRARIE │ │ │ │ │ +0002e180: 5327 2076 6172 6961 626c 6573 2073 7563 S' variables suc │ │ │ │ │ +0002e190: 6820 6173 2027 6c69 625f 4c54 4c49 4252 h as 'lib_LTLIBR │ │ │ │ │ +0002e1a0: 4152 4945 5327 2e0a 0a20 2020 486f 7765 ARIES'... Howe │ │ │ │ │ +0002e1b0: 7665 722c 2066 6f72 206c 6962 7261 7269 ver, for librari │ │ │ │ │ +0002e1c0: 6573 2064 6574 6572 6d69 6e65 6420 6174 es determined at │ │ │ │ │ +0002e1d0: 2063 6f6e 6669 6775 7265 2074 696d 6520 configure time │ │ │ │ │ +0002e1e0: 2861 6e64 2074 6875 730a 6d65 6e74 696f (and thus.mentio │ │ │ │ │ +0002e1f0: 6e65 6420 696e 2027 4558 5452 415f 4c54 ned in 'EXTRA_LT │ │ │ │ │ +0002e200: 4c49 4252 4152 4945 5327 292c 2041 7574 LIBRARIES'), Aut │ │ │ │ │ +0002e210: 6f6d 616b 6520 646f 6573 206e 6f74 206b omake does not k │ │ │ │ │ +0002e220: 6e6f 7720 7468 6520 6669 6e61 6c0a 696e now the final.in │ │ │ │ │ +0002e230: 7374 616c 6c61 7469 6f6e 2064 6972 6563 stallation direc │ │ │ │ │ +0002e240: 746f 7279 2e20 2046 6f72 2073 7563 6820 tory. For such │ │ │ │ │ +0002e250: 6c69 6272 6172 6965 7320 796f 7520 6d75 libraries you mu │ │ │ │ │ +0002e260: 7374 2061 6464 2074 6865 2027 2d72 7061 st add the '-rpa │ │ │ │ │ +0002e270: 7468 270a 6f70 7469 6f6e 2074 6f20 7468 th'.option to th │ │ │ │ │ +0002e280: 6520 6170 7072 6f70 7269 6174 6520 275f e appropriate '_ │ │ │ │ │ +0002e290: 4c44 464c 4147 5327 2076 6172 6961 626c LDFLAGS' variabl │ │ │ │ │ +0002e2a0: 6520 6279 2068 616e 642e 0a0a 2020 2054 e by hand... T │ │ │ │ │ +0002e2b0: 6865 2065 7861 6d70 6c65 7320 6265 6c6f he examples belo │ │ │ │ │ +0002e2c0: 7720 696c 6c75 7374 7261 7465 2074 6865 w illustrate the │ │ │ │ │ +0002e2d0: 2064 6966 6665 7265 6e63 6573 2062 6574 differences bet │ │ │ │ │ +0002e2e0: 7765 656e 2074 6865 7365 2074 776f 0a6d ween these two.m │ │ │ │ │ +0002e2f0: 6574 686f 6473 2e0a 0a20 2020 4865 7265 ethods... Here │ │ │ │ │ +0002e300: 2069 7320 616e 2065 7861 6d70 6c65 2077 is an example w │ │ │ │ │ +0002e310: 6865 7265 2027 5741 4e54 4544 4c49 4253 here 'WANTEDLIBS │ │ │ │ │ +0002e320: 2720 6973 2061 6e20 2741 435f 5355 4253 ' is an 'AC_SUBS │ │ │ │ │ +0002e330: 5427 6564 2076 6172 6961 626c 6520 7365 T'ed variable se │ │ │ │ │ +0002e340: 740a 6174 2027 2e2f 636f 6e66 6967 7572 t.at './configur │ │ │ │ │ +0002e350: 6527 2d74 696d 6520 746f 2065 6974 6865 e'-time to eithe │ │ │ │ │ +0002e360: 7220 276c 6962 666f 6f2e 6c61 272c 2027 r 'libfoo.la', ' │ │ │ │ │ +0002e370: 6c69 6262 6172 2e6c 6127 2c20 626f 7468 libbar.la', both │ │ │ │ │ +0002e380: 2c20 6f72 206e 6f6e 652e 0a41 6c74 686f , or none..Altho │ │ │ │ │ +0002e390: 7567 6820 2724 2857 414e 5445 444c 4942 ugh '$(WANTEDLIB │ │ │ │ │ +0002e3a0: 5329 2720 6170 7065 6172 7320 696e 2074 S)' appears in t │ │ │ │ │ +0002e3b0: 6865 2027 6c69 625f 4c54 4c49 4252 4152 he 'lib_LTLIBRAR │ │ │ │ │ +0002e3c0: 4945 5327 2c20 4175 746f 6d61 6b65 0a63 IES', Automake.c │ │ │ │ │ +0002e3d0: 616e 6e6f 7420 6775 6573 7320 6974 2072 annot guess it r │ │ │ │ │ +0002e3e0: 656c 6174 6573 2074 6f20 276c 6962 666f elates to 'libfo │ │ │ │ │ +0002e3f0: 6f2e 6c61 2720 6f72 2027 6c69 6262 6172 o.la' or 'libbar │ │ │ │ │ +0002e400: 2e6c 6127 2061 7420 7468 6520 7469 6d65 .la' at the time │ │ │ │ │ +0002e410: 2069 740a 6372 6561 7465 7320 7468 6520 it.creates the │ │ │ │ │ +0002e420: 6c69 6e6b 2072 756c 6520 666f 7220 7468 link rule for th │ │ │ │ │ +0002e430: 6573 6520 7477 6f20 6c69 6272 6172 6965 ese two librarie │ │ │ │ │ +0002e440: 732e 2020 5468 6572 6566 6f72 6520 7468 s. Therefore th │ │ │ │ │ +0002e450: 6520 272d 7270 6174 6827 0a61 7267 756d e '-rpath'.argum │ │ │ │ │ +0002e460: 656e 7420 6d75 7374 2062 6520 6578 706c ent must be expl │ │ │ │ │ +0002e470: 6963 6974 6c79 2073 7570 706c 6965 642e icitly supplied. │ │ │ │ │ +0002e480: 0a0a 2020 2020 2045 5854 5241 5f4c 544c .. EXTRA_LTL │ │ │ │ │ +0002e490: 4942 5241 5249 4553 203d 206c 6962 666f IBRARIES = libfo │ │ │ │ │ +0002e4a0: 6f2e 6c61 206c 6962 6261 722e 6c61 0a20 o.la libbar.la. │ │ │ │ │ +0002e4b0: 2020 2020 6c69 625f 4c54 4c49 4252 4152 lib_LTLIBRAR │ │ │ │ │ +0002e4c0: 4945 5320 3d20 2428 5741 4e54 4544 4c49 IES = $(WANTEDLI │ │ │ │ │ +0002e4d0: 4253 290a 2020 2020 206c 6962 666f 6f5f BS). libfoo_ │ │ │ │ │ +0002e4e0: 6c61 5f53 4f55 5243 4553 203d 2066 6f6f la_SOURCES = foo │ │ │ │ │ +0002e4f0: 2e63 202e 2e2e 0a20 2020 2020 6c69 6266 .c .... libf │ │ │ │ │ +0002e500: 6f6f 5f6c 615f 4c44 464c 4147 5320 3d20 oo_la_LDFLAGS = │ │ │ │ │ +0002e510: 2d72 7061 7468 2027 2428 6c69 6264 6972 -rpath '$(libdir │ │ │ │ │ +0002e520: 2927 0a20 2020 2020 6c69 6262 6172 5f6c )'. libbar_l │ │ │ │ │ +0002e530: 615f 534f 5552 4345 5320 3d20 6261 722e a_SOURCES = bar. │ │ │ │ │ +0002e540: 6320 2e2e 2e0a 2020 2020 206c 6962 6261 c .... libba │ │ │ │ │ +0002e550: 725f 6c61 5f4c 4446 4c41 4753 203d 202d r_la_LDFLAGS = - │ │ │ │ │ +0002e560: 7270 6174 6820 2724 286c 6962 6469 7229 rpath '$(libdir) │ │ │ │ │ +0002e570: 270a 0a20 2020 4865 7265 2069 7320 686f '.. Here is ho │ │ │ │ │ +0002e580: 7720 7468 6520 7361 6d65 2027 4d61 6b65 w the same 'Make │ │ │ │ │ +0002e590: 6669 6c65 2e61 6d27 2077 6f75 6c64 206c file.am' would l │ │ │ │ │ +0002e5a0: 6f6f 6b20 7573 696e 6720 4175 746f 6d61 ook using Automa │ │ │ │ │ +0002e5b0: 6b65 0a63 6f6e 6469 7469 6f6e 616c 7320 ke.conditionals │ │ │ │ │ +0002e5c0: 6e61 6d65 6420 2757 414e 545f 4c49 4246 named 'WANT_LIBF │ │ │ │ │ +0002e5d0: 4f4f 2720 616e 6420 2757 414e 545f 4c49 OO' and 'WANT_LI │ │ │ │ │ +0002e5e0: 4242 4152 272e 2020 4e6f 7720 4175 746f BBAR'. Now Auto │ │ │ │ │ +0002e5f0: 6d61 6b65 2069 730a 6162 6c65 2074 6f20 make is.able to │ │ │ │ │ +0002e600: 636f 6d70 7574 6520 7468 6520 272d 7270 compute the '-rp │ │ │ │ │ +0002e610: 6174 6827 2073 6574 7469 6e67 2069 7473 ath' setting its │ │ │ │ │ +0002e620: 656c 662c 2062 6563 6175 7365 2069 7427 elf, because it' │ │ │ │ │ +0002e630: 7320 636c 6561 7220 7468 6174 0a62 6f74 s clear that.bot │ │ │ │ │ +0002e640: 6820 6c69 6272 6172 6965 7320 7769 6c6c h libraries will │ │ │ │ │ +0002e650: 2065 6e64 2075 7020 696e 2027 2428 6c69 end up in '$(li │ │ │ │ │ +0002e660: 6264 6972 2927 2069 6620 7468 6579 2061 bdir)' if they a │ │ │ │ │ +0002e670: 7265 2069 6e73 7461 6c6c 6564 2e0a 0a20 re installed... │ │ │ │ │ +0002e680: 2020 2020 6c69 625f 4c54 4c49 4252 4152 lib_LTLIBRAR │ │ │ │ │ +0002e690: 4945 5320 3d0a 2020 2020 2069 6620 5741 IES =. if WA │ │ │ │ │ +0002e6a0: 4e54 5f4c 4942 464f 4f0a 2020 2020 206c NT_LIBFOO. l │ │ │ │ │ +0002e6b0: 6962 5f4c 544c 4942 5241 5249 4553 202b ib_LTLIBRARIES + │ │ │ │ │ +0002e6c0: 3d20 6c69 6266 6f6f 2e6c 610a 2020 2020 = libfoo.la. │ │ │ │ │ +0002e6d0: 2065 6e64 6966 0a20 2020 2020 6966 2057 endif. if W │ │ │ │ │ +0002e6e0: 414e 545f 4c49 4242 4152 0a20 2020 2020 ANT_LIBBAR. │ │ │ │ │ +0002e6f0: 6c69 625f 4c54 4c49 4252 4152 4945 5320 lib_LTLIBRARIES │ │ │ │ │ +0002e700: 2b3d 206c 6962 6261 722e 6c61 0a20 2020 += libbar.la. │ │ │ │ │ +0002e710: 2020 656e 6469 660a 2020 2020 206c 6962 endif. lib │ │ │ │ │ +0002e720: 666f 6f5f 6c61 5f53 4f55 5243 4553 203d foo_la_SOURCES = │ │ │ │ │ +0002e730: 2066 6f6f 2e63 202e 2e2e 0a20 2020 2020 foo.c .... │ │ │ │ │ +0002e740: 6c69 6262 6172 5f6c 615f 534f 5552 4345 libbar_la_SOURCE │ │ │ │ │ +0002e750: 5320 3d20 6261 722e 6320 2e2e 2e0a 0a1f S = bar.c ...... │ │ │ │ │ +0002e760: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +0002e770: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +0002e780: 3a20 436f 6e64 6974 696f 6e61 6c20 4c69 : Conditional Li │ │ │ │ │ +0002e790: 6274 6f6f 6c20 536f 7572 6365 732c 2020 btool Sources, │ │ │ │ │ +0002e7a0: 4e65 7874 3a20 4c69 6274 6f6f 6c20 436f Next: Libtool Co │ │ │ │ │ +0002e7b0: 6e76 656e 6965 6e63 6520 4c69 6272 6172 nvenience Librar │ │ │ │ │ +0002e7c0: 6965 732c 2020 5072 6576 3a20 436f 6e64 ies, Prev: Cond │ │ │ │ │ +0002e7d0: 6974 696f 6e61 6c20 4c69 6274 6f6f 6c20 itional Libtool │ │ │ │ │ +0002e7e0: 4c69 6272 6172 6965 732c 2020 5570 3a20 Libraries, Up: │ │ │ │ │ +0002e7f0: 4120 5368 6172 6564 204c 6962 7261 7279 A Shared Library │ │ │ │ │ +0002e800: 0a0a 382e 332e 3420 4c69 6274 6f6f 6c20 ..8.3.4 Libtool │ │ │ │ │ +0002e810: 4c69 6272 6172 6965 7320 7769 7468 2043 Libraries with C │ │ │ │ │ +0002e820: 6f6e 6469 7469 6f6e 616c 2053 6f75 7263 onditional Sourc │ │ │ │ │ +0002e830: 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d es.------------- │ │ │ │ │ 0002e840: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0002e850: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002e860: 2d0a 0a43 6f6e 6469 7469 6f6e 616c 2063 -..Conditional c │ │ │ │ │ -0002e870: 6f6d 7069 6c61 7469 6f6e 206f 6620 736f ompilation of so │ │ │ │ │ -0002e880: 7572 6365 7320 696e 2061 206c 6962 7261 urces in a libra │ │ │ │ │ -0002e890: 7279 2063 616e 2062 6520 6163 6869 6576 ry can be achiev │ │ │ │ │ -0002e8a0: 6564 2069 6e20 7468 650a 7361 6d65 2077 ed in the.same w │ │ │ │ │ -0002e8b0: 6179 2061 7320 636f 6e64 6974 696f 6e61 ay as conditiona │ │ │ │ │ -0002e8c0: 6c20 636f 6d70 696c 6174 696f 6e20 6f66 l compilation of │ │ │ │ │ -0002e8d0: 2073 6f75 7263 6573 2069 6e20 6120 7072 sources in a pr │ │ │ │ │ -0002e8e0: 6f67 7261 6d20 282a 6e6f 7465 0a43 6f6e ogram (*note.Con │ │ │ │ │ -0002e8f0: 6469 7469 6f6e 616c 2053 6f75 7263 6573 ditional Sources │ │ │ │ │ -0002e900: 3a3a 292e 2020 5468 6520 6f6e 6c79 2064 ::). The only d │ │ │ │ │ -0002e910: 6966 6665 7265 6e63 6520 6973 2074 6861 ifference is tha │ │ │ │ │ -0002e920: 7420 275f 4c49 4241 4444 2720 7368 6f75 t '_LIBADD' shou │ │ │ │ │ -0002e930: 6c64 2062 650a 7573 6564 2069 6e73 7465 ld be.used inste │ │ │ │ │ -0002e940: 6164 206f 6620 275f 4c44 4144 4427 2061 ad of '_LDADD' a │ │ │ │ │ -0002e950: 6e64 2074 6861 7420 6974 2073 686f 756c nd that it shoul │ │ │ │ │ -0002e960: 6420 6d65 6e74 696f 6e20 6c69 6274 6f6f d mention libtoo │ │ │ │ │ -0002e970: 6c20 6f62 6a65 6374 730a 2827 2e6c 6f27 l objects.('.lo' │ │ │ │ │ -0002e980: 2066 696c 6573 292e 0a0a 2020 2053 6f2c files)... So, │ │ │ │ │ -0002e990: 2074 6f20 6d69 6d69 6320 7468 6520 2768 to mimic the 'h │ │ │ │ │ -0002e9a0: 656c 6c6f 2720 6578 616d 706c 6520 6672 ello' example fr │ │ │ │ │ -0002e9b0: 6f6d 202a 6e6f 7465 2043 6f6e 6469 7469 om *note Conditi │ │ │ │ │ -0002e9c0: 6f6e 616c 2053 6f75 7263 6573 3a3a 2c20 onal Sources::, │ │ │ │ │ -0002e9d0: 7765 0a63 6f75 6c64 2062 7569 6c64 2061 we.could build a │ │ │ │ │ -0002e9e0: 2027 6c69 6268 656c 6c6f 2e6c 6127 206c 'libhello.la' l │ │ │ │ │ -0002e9f0: 6962 7261 7279 2075 7369 6e67 2065 6974 ibrary using eit │ │ │ │ │ -0002ea00: 6865 7220 2768 656c 6c6f 2d6c 696e 7578 her 'hello-linux │ │ │ │ │ -0002ea10: 2e63 2720 6f72 0a27 6865 6c6c 6f2d 6765 .c' or.'hello-ge │ │ │ │ │ -0002ea20: 6e65 7269 632e 6327 2077 6974 6820 7468 neric.c' with th │ │ │ │ │ -0002ea30: 6520 666f 6c6c 6f77 696e 6720 274d 616b e following 'Mak │ │ │ │ │ -0002ea40: 6566 696c 652e 616d 272e 0a0a 2020 2020 efile.am'... │ │ │ │ │ -0002ea50: 206c 6962 5f4c 544c 4942 5241 5249 4553 lib_LTLIBRARIES │ │ │ │ │ -0002ea60: 203d 206c 6962 6865 6c6c 6f2e 6c61 0a20 = libhello.la. │ │ │ │ │ -0002ea70: 2020 2020 6c69 6268 656c 6c6f 5f6c 615f libhello_la_ │ │ │ │ │ -0002ea80: 534f 5552 4345 5320 3d20 6865 6c6c 6f2d SOURCES = hello- │ │ │ │ │ -0002ea90: 636f 6d6d 6f6e 2e63 0a20 2020 2020 4558 common.c. EX │ │ │ │ │ -0002eaa0: 5452 415f 6c69 6268 656c 6c6f 5f6c 615f TRA_libhello_la_ │ │ │ │ │ -0002eab0: 534f 5552 4345 5320 3d20 6865 6c6c 6f2d SOURCES = hello- │ │ │ │ │ -0002eac0: 6c69 6e75 782e 6320 6865 6c6c 6f2d 6765 linux.c hello-ge │ │ │ │ │ -0002ead0: 6e65 7269 632e 630a 2020 2020 206c 6962 neric.c. lib │ │ │ │ │ -0002eae0: 6865 6c6c 6f5f 6c61 5f4c 4942 4144 4420 hello_la_LIBADD │ │ │ │ │ -0002eaf0: 3d20 2428 4845 4c4c 4f5f 5359 5354 454d = $(HELLO_SYSTEM │ │ │ │ │ -0002eb00: 290a 2020 2020 206c 6962 6865 6c6c 6f5f ). libhello_ │ │ │ │ │ -0002eb10: 6c61 5f44 4550 454e 4445 4e43 4945 5320 la_DEPENDENCIES │ │ │ │ │ -0002eb20: 3d20 2428 4845 4c4c 4f5f 5359 5354 454d = $(HELLO_SYSTEM │ │ │ │ │ -0002eb30: 290a 0a41 6e64 206d 616b 6520 7375 7265 )..And make sure │ │ │ │ │ -0002eb40: 2027 636f 6e66 6967 7572 6527 2064 6566 'configure' def │ │ │ │ │ -0002eb50: 696e 6573 2027 4845 4c4c 4f5f 5359 5354 ines 'HELLO_SYST │ │ │ │ │ -0002eb60: 454d 2720 6173 2065 6974 6865 720a 2768 EM' as either.'h │ │ │ │ │ -0002eb70: 656c 6c6f 2d6c 696e 7578 2e6c 6f27 206f ello-linux.lo' o │ │ │ │ │ -0002eb80: 7220 2768 656c 6c6f 2d67 656e 6572 6963 r 'hello-generic │ │ │ │ │ -0002eb90: 2e6c 6f27 2e0a 0a20 2020 4f72 2077 6520 .lo'... Or we │ │ │ │ │ -0002eba0: 636f 756c 6420 7369 6d70 6c79 2075 7365 could simply use │ │ │ │ │ -0002ebb0: 2061 6e20 4175 746f 6d61 6b65 2063 6f6e an Automake con │ │ │ │ │ -0002ebc0: 6469 7469 6f6e 616c 2061 7320 666f 6c6c ditional as foll │ │ │ │ │ -0002ebd0: 6f77 732e 0a0a 2020 2020 206c 6962 5f4c ows... lib_L │ │ │ │ │ -0002ebe0: 544c 4942 5241 5249 4553 203d 206c 6962 TLIBRARIES = lib │ │ │ │ │ -0002ebf0: 6865 6c6c 6f2e 6c61 0a20 2020 2020 6c69 hello.la. li │ │ │ │ │ -0002ec00: 6268 656c 6c6f 5f6c 615f 534f 5552 4345 bhello_la_SOURCE │ │ │ │ │ -0002ec10: 5320 3d20 6865 6c6c 6f2d 636f 6d6d 6f6e S = hello-common │ │ │ │ │ -0002ec20: 2e63 0a20 2020 2020 6966 204c 494e 5558 .c. if LINUX │ │ │ │ │ -0002ec30: 0a20 2020 2020 6c69 6268 656c 6c6f 5f6c . libhello_l │ │ │ │ │ -0002ec40: 615f 534f 5552 4345 5320 2b3d 2068 656c a_SOURCES += hel │ │ │ │ │ -0002ec50: 6c6f 2d6c 696e 7578 2e63 0a20 2020 2020 lo-linux.c. │ │ │ │ │ -0002ec60: 656c 7365 0a20 2020 2020 6c69 6268 656c else. libhel │ │ │ │ │ -0002ec70: 6c6f 5f6c 615f 534f 5552 4345 5320 2b3d lo_la_SOURCES += │ │ │ │ │ -0002ec80: 2068 656c 6c6f 2d67 656e 6572 6963 2e63 hello-generic.c │ │ │ │ │ -0002ec90: 0a20 2020 2020 656e 6469 660a 0a1f 0a46 . endif....F │ │ │ │ │ -0002eca0: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -0002ecb0: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -0002ecc0: 4c69 6274 6f6f 6c20 436f 6e76 656e 6965 Libtool Convenie │ │ │ │ │ -0002ecd0: 6e63 6520 4c69 6272 6172 6965 732c 2020 nce Libraries, │ │ │ │ │ -0002ece0: 4e65 7874 3a20 4c69 6274 6f6f 6c20 4d6f Next: Libtool Mo │ │ │ │ │ -0002ecf0: 6475 6c65 732c 2020 5072 6576 3a20 436f dules, Prev: Co │ │ │ │ │ -0002ed00: 6e64 6974 696f 6e61 6c20 4c69 6274 6f6f nditional Libtoo │ │ │ │ │ -0002ed10: 6c20 536f 7572 6365 732c 2020 5570 3a20 l Sources, Up: │ │ │ │ │ -0002ed20: 4120 5368 6172 6564 204c 6962 7261 7279 A Shared Library │ │ │ │ │ -0002ed30: 0a0a 382e 332e 3520 4c69 6274 6f6f 6c20 ..8.3.5 Libtool │ │ │ │ │ -0002ed40: 436f 6e76 656e 6965 6e63 6520 4c69 6272 Convenience Libr │ │ │ │ │ -0002ed50: 6172 6965 730a 2d2d 2d2d 2d2d 2d2d 2d2d aries.---------- │ │ │ │ │ +0002e860: 2d2d 2d0a 0a43 6f6e 6469 7469 6f6e 616c ---..Conditional │ │ │ │ │ +0002e870: 2063 6f6d 7069 6c61 7469 6f6e 206f 6620 compilation of │ │ │ │ │ +0002e880: 736f 7572 6365 7320 696e 2061 206c 6962 sources in a lib │ │ │ │ │ +0002e890: 7261 7279 2063 616e 2062 6520 6163 6869 rary can be achi │ │ │ │ │ +0002e8a0: 6576 6564 2069 6e20 7468 650a 7361 6d65 eved in the.same │ │ │ │ │ +0002e8b0: 2077 6179 2061 7320 636f 6e64 6974 696f way as conditio │ │ │ │ │ +0002e8c0: 6e61 6c20 636f 6d70 696c 6174 696f 6e20 nal compilation │ │ │ │ │ +0002e8d0: 6f66 2073 6f75 7263 6573 2069 6e20 6120 of sources in a │ │ │ │ │ +0002e8e0: 7072 6f67 7261 6d20 282a 6e6f 7465 0a43 program (*note.C │ │ │ │ │ +0002e8f0: 6f6e 6469 7469 6f6e 616c 2053 6f75 7263 onditional Sourc │ │ │ │ │ +0002e900: 6573 3a3a 292e 2020 5468 6520 6f6e 6c79 es::). The only │ │ │ │ │ +0002e910: 2064 6966 6665 7265 6e63 6520 6973 2074 difference is t │ │ │ │ │ +0002e920: 6861 7420 275f 4c49 4241 4444 2720 7368 hat '_LIBADD' sh │ │ │ │ │ +0002e930: 6f75 6c64 2062 650a 7573 6564 2069 6e73 ould be.used ins │ │ │ │ │ +0002e940: 7465 6164 206f 6620 275f 4c44 4144 4427 tead of '_LDADD' │ │ │ │ │ +0002e950: 2061 6e64 2074 6861 7420 6974 2073 686f and that it sho │ │ │ │ │ +0002e960: 756c 6420 6d65 6e74 696f 6e20 6c69 6274 uld mention libt │ │ │ │ │ +0002e970: 6f6f 6c20 6f62 6a65 6374 730a 2827 2e6c ool objects.('.l │ │ │ │ │ +0002e980: 6f27 2066 696c 6573 292e 0a0a 2020 2053 o' files)... S │ │ │ │ │ +0002e990: 6f2c 2074 6f20 6d69 6d69 6320 7468 6520 o, to mimic the │ │ │ │ │ +0002e9a0: 2768 656c 6c6f 2720 6578 616d 706c 6520 'hello' example │ │ │ │ │ +0002e9b0: 6672 6f6d 202a 6e6f 7465 2043 6f6e 6469 from *note Condi │ │ │ │ │ +0002e9c0: 7469 6f6e 616c 2053 6f75 7263 6573 3a3a tional Sources:: │ │ │ │ │ +0002e9d0: 2c20 7765 0a63 6f75 6c64 2062 7569 6c64 , we.could build │ │ │ │ │ +0002e9e0: 2061 2027 6c69 6268 656c 6c6f 2e6c 6127 a 'libhello.la' │ │ │ │ │ +0002e9f0: 206c 6962 7261 7279 2075 7369 6e67 2065 library using e │ │ │ │ │ +0002ea00: 6974 6865 7220 2768 656c 6c6f 2d6c 696e ither 'hello-lin │ │ │ │ │ +0002ea10: 7578 2e63 2720 6f72 0a27 6865 6c6c 6f2d ux.c' or.'hello- │ │ │ │ │ +0002ea20: 6765 6e65 7269 632e 6327 2077 6974 6820 generic.c' with │ │ │ │ │ +0002ea30: 7468 6520 666f 6c6c 6f77 696e 6720 274d the following 'M │ │ │ │ │ +0002ea40: 616b 6566 696c 652e 616d 272e 0a0a 2020 akefile.am'... │ │ │ │ │ +0002ea50: 2020 206c 6962 5f4c 544c 4942 5241 5249 lib_LTLIBRARI │ │ │ │ │ +0002ea60: 4553 203d 206c 6962 6865 6c6c 6f2e 6c61 ES = libhello.la │ │ │ │ │ +0002ea70: 0a20 2020 2020 6c69 6268 656c 6c6f 5f6c . libhello_l │ │ │ │ │ +0002ea80: 615f 534f 5552 4345 5320 3d20 6865 6c6c a_SOURCES = hell │ │ │ │ │ +0002ea90: 6f2d 636f 6d6d 6f6e 2e63 0a20 2020 2020 o-common.c. │ │ │ │ │ +0002eaa0: 4558 5452 415f 6c69 6268 656c 6c6f 5f6c EXTRA_libhello_l │ │ │ │ │ +0002eab0: 615f 534f 5552 4345 5320 3d20 6865 6c6c a_SOURCES = hell │ │ │ │ │ +0002eac0: 6f2d 6c69 6e75 782e 6320 6865 6c6c 6f2d o-linux.c hello- │ │ │ │ │ +0002ead0: 6765 6e65 7269 632e 630a 2020 2020 206c generic.c. l │ │ │ │ │ +0002eae0: 6962 6865 6c6c 6f5f 6c61 5f4c 4942 4144 ibhello_la_LIBAD │ │ │ │ │ +0002eaf0: 4420 3d20 2428 4845 4c4c 4f5f 5359 5354 D = $(HELLO_SYST │ │ │ │ │ +0002eb00: 454d 290a 2020 2020 206c 6962 6865 6c6c EM). libhell │ │ │ │ │ +0002eb10: 6f5f 6c61 5f44 4550 454e 4445 4e43 4945 o_la_DEPENDENCIE │ │ │ │ │ +0002eb20: 5320 3d20 2428 4845 4c4c 4f5f 5359 5354 S = $(HELLO_SYST │ │ │ │ │ +0002eb30: 454d 290a 0a41 6e64 206d 616b 6520 7375 EM)..And make su │ │ │ │ │ +0002eb40: 7265 2027 636f 6e66 6967 7572 6527 2064 re 'configure' d │ │ │ │ │ +0002eb50: 6566 696e 6573 2027 4845 4c4c 4f5f 5359 efines 'HELLO_SY │ │ │ │ │ +0002eb60: 5354 454d 2720 6173 2065 6974 6865 720a STEM' as either. │ │ │ │ │ +0002eb70: 2768 656c 6c6f 2d6c 696e 7578 2e6c 6f27 'hello-linux.lo' │ │ │ │ │ +0002eb80: 206f 7220 2768 656c 6c6f 2d67 656e 6572 or 'hello-gener │ │ │ │ │ +0002eb90: 6963 2e6c 6f27 2e0a 0a20 2020 4f72 2077 ic.lo'... Or w │ │ │ │ │ +0002eba0: 6520 636f 756c 6420 7369 6d70 6c79 2075 e could simply u │ │ │ │ │ +0002ebb0: 7365 2061 6e20 4175 746f 6d61 6b65 2063 se an Automake c │ │ │ │ │ +0002ebc0: 6f6e 6469 7469 6f6e 616c 2061 7320 666f onditional as fo │ │ │ │ │ +0002ebd0: 6c6c 6f77 732e 0a0a 2020 2020 206c 6962 llows... lib │ │ │ │ │ +0002ebe0: 5f4c 544c 4942 5241 5249 4553 203d 206c _LTLIBRARIES = l │ │ │ │ │ +0002ebf0: 6962 6865 6c6c 6f2e 6c61 0a20 2020 2020 ibhello.la. │ │ │ │ │ +0002ec00: 6c69 6268 656c 6c6f 5f6c 615f 534f 5552 libhello_la_SOUR │ │ │ │ │ +0002ec10: 4345 5320 3d20 6865 6c6c 6f2d 636f 6d6d CES = hello-comm │ │ │ │ │ +0002ec20: 6f6e 2e63 0a20 2020 2020 6966 204c 494e on.c. if LIN │ │ │ │ │ +0002ec30: 5558 0a20 2020 2020 6c69 6268 656c 6c6f UX. libhello │ │ │ │ │ +0002ec40: 5f6c 615f 534f 5552 4345 5320 2b3d 2068 _la_SOURCES += h │ │ │ │ │ +0002ec50: 656c 6c6f 2d6c 696e 7578 2e63 0a20 2020 ello-linux.c. │ │ │ │ │ +0002ec60: 2020 656c 7365 0a20 2020 2020 6c69 6268 else. libh │ │ │ │ │ +0002ec70: 656c 6c6f 5f6c 615f 534f 5552 4345 5320 ello_la_SOURCES │ │ │ │ │ +0002ec80: 2b3d 2068 656c 6c6f 2d67 656e 6572 6963 += hello-generic │ │ │ │ │ +0002ec90: 2e63 0a20 2020 2020 656e 6469 660a 0a1f .c. endif... │ │ │ │ │ +0002eca0: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +0002ecb0: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +0002ecc0: 3a20 4c69 6274 6f6f 6c20 436f 6e76 656e : Libtool Conven │ │ │ │ │ +0002ecd0: 6965 6e63 6520 4c69 6272 6172 6965 732c ience Libraries, │ │ │ │ │ +0002ece0: 2020 4e65 7874 3a20 4c69 6274 6f6f 6c20 Next: Libtool │ │ │ │ │ +0002ecf0: 4d6f 6475 6c65 732c 2020 5072 6576 3a20 Modules, Prev: │ │ │ │ │ +0002ed00: 436f 6e64 6974 696f 6e61 6c20 4c69 6274 Conditional Libt │ │ │ │ │ +0002ed10: 6f6f 6c20 536f 7572 6365 732c 2020 5570 ool Sources, Up │ │ │ │ │ +0002ed20: 3a20 4120 5368 6172 6564 204c 6962 7261 : A Shared Libra │ │ │ │ │ +0002ed30: 7279 0a0a 382e 332e 3520 4c69 6274 6f6f ry..8.3.5 Libtoo │ │ │ │ │ +0002ed40: 6c20 436f 6e76 656e 6965 6e63 6520 4c69 l Convenience Li │ │ │ │ │ +0002ed50: 6272 6172 6965 730a 2d2d 2d2d 2d2d 2d2d braries.-------- │ │ │ │ │ 0002ed60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002ed70: 2d2d 2d2d 2d2d 2d2d 2d0a 0a53 6f6d 6574 ---------..Somet │ │ │ │ │ -0002ed80: 696d 6573 2079 6f75 2077 616e 7420 746f imes you want to │ │ │ │ │ -0002ed90: 2062 7569 6c64 206c 6962 746f 6f6c 206c build libtool l │ │ │ │ │ -0002eda0: 6962 7261 7269 6573 2074 6861 7420 7368 ibraries that sh │ │ │ │ │ -0002edb0: 6f75 6c64 206e 6f74 2062 650a 696e 7374 ould not be.inst │ │ │ │ │ -0002edc0: 616c 6c65 642e 2020 5468 6573 6520 6172 alled. These ar │ │ │ │ │ -0002edd0: 6520 6361 6c6c 6564 2022 6c69 6274 6f6f e called "libtoo │ │ │ │ │ -0002ede0: 6c20 636f 6e76 656e 6965 6e63 6520 6c69 l convenience li │ │ │ │ │ -0002edf0: 6272 6172 6965 7322 2061 6e64 2061 7265 braries" and are │ │ │ │ │ -0002ee00: 0a74 7970 6963 616c 6c79 2075 7365 6420 .typically used │ │ │ │ │ -0002ee10: 746f 2065 6e63 6170 7375 6c61 7465 206d to encapsulate m │ │ │ │ │ -0002ee20: 616e 7920 7375 626c 6962 7261 7269 6573 any sublibraries │ │ │ │ │ -0002ee30: 2c20 6c61 7465 7220 6761 7468 6572 6564 , later gathered │ │ │ │ │ -0002ee40: 2069 6e74 6f20 6f6e 650a 6269 6720 696e into one.big in │ │ │ │ │ -0002ee50: 7374 616c 6c65 6420 6c69 6272 6172 792e stalled library. │ │ │ │ │ -0002ee60: 0a0a 2020 204c 6962 746f 6f6c 2063 6f6e .. Libtool con │ │ │ │ │ -0002ee70: 7665 6e69 656e 6365 206c 6962 7261 7269 venience librari │ │ │ │ │ -0002ee80: 6573 2061 7265 2064 6563 6c61 7265 6420 es are declared │ │ │ │ │ -0002ee90: 6279 2064 6972 6563 746f 7279 2d6c 6573 by directory-les │ │ │ │ │ -0002eea0: 730a 7661 7269 6162 6c65 7320 7375 6368 s.variables such │ │ │ │ │ -0002eeb0: 2061 7320 276e 6f69 6e73 745f 4c54 4c49 as 'noinst_LTLI │ │ │ │ │ -0002eec0: 4252 4152 4945 5327 2c20 2763 6865 636b BRARIES', 'check │ │ │ │ │ -0002eed0: 5f4c 544c 4942 5241 5249 4553 272c 206f _LTLIBRARIES', o │ │ │ │ │ -0002eee0: 7220 6576 656e 0a27 4558 5452 415f 4c54 r even.'EXTRA_LT │ │ │ │ │ -0002eef0: 4c49 4252 4152 4945 5327 2e20 2055 6e6c LIBRARIES'. Unl │ │ │ │ │ -0002ef00: 696b 6520 696e 7374 616c 6c65 6420 6c69 ike installed li │ │ │ │ │ -0002ef10: 6274 6f6f 6c20 6c69 6272 6172 6965 7320 btool libraries │ │ │ │ │ -0002ef20: 7468 6579 2064 6f20 6e6f 740a 6e65 6564 they do not.need │ │ │ │ │ -0002ef30: 2061 6e20 272d 7270 6174 6827 2066 6c61 an '-rpath' fla │ │ │ │ │ -0002ef40: 6720 6174 206c 696e 6b20 7469 6d65 2028 g at link time ( │ │ │ │ │ -0002ef50: 6163 7475 616c 6c79 2074 6869 7320 6973 actually this is │ │ │ │ │ -0002ef60: 2074 6865 206f 6e6c 790a 6469 6666 6572 the only.differ │ │ │ │ │ -0002ef70: 656e 6365 292e 0a0a 2020 2043 6f6e 7665 ence)... Conve │ │ │ │ │ -0002ef80: 6e69 656e 6365 206c 6962 7261 7269 6573 nience libraries │ │ │ │ │ -0002ef90: 206c 6973 7465 6420 696e 2027 6e6f 696e listed in 'noin │ │ │ │ │ -0002efa0: 7374 5f4c 544c 4942 5241 5249 4553 2720 st_LTLIBRARIES' │ │ │ │ │ -0002efb0: 6172 6520 616c 7761 7973 0a62 7569 6c74 are always.built │ │ │ │ │ -0002efc0: 2e20 2054 686f 7365 206c 6973 7465 6420 . Those listed │ │ │ │ │ -0002efd0: 696e 2027 6368 6563 6b5f 4c54 4c49 4252 in 'check_LTLIBR │ │ │ │ │ -0002efe0: 4152 4945 5327 2061 7265 2062 7569 6c74 ARIES' are built │ │ │ │ │ -0002eff0: 206f 6e6c 7920 7570 6f6e 2027 6d61 6b65 only upon 'make │ │ │ │ │ -0002f000: 0a63 6865 636b 272e 2020 4669 6e61 6c6c .check'. Finall │ │ │ │ │ -0002f010: 792c 206c 6962 7261 7269 6573 206c 6973 y, libraries lis │ │ │ │ │ -0002f020: 7465 6420 696e 2027 4558 5452 415f 4c54 ted in 'EXTRA_LT │ │ │ │ │ -0002f030: 4c49 4252 4152 4945 5327 2061 7265 206e LIBRARIES' are n │ │ │ │ │ -0002f040: 6576 6572 0a62 7569 6c74 2065 7870 6c69 ever.built expli │ │ │ │ │ -0002f050: 6369 746c 793a 2041 7574 6f6d 616b 6520 citly: Automake │ │ │ │ │ -0002f060: 6f75 7470 7574 7320 7275 6c65 7320 746f outputs rules to │ │ │ │ │ -0002f070: 2062 7569 6c64 2074 6865 6d2c 2062 7574 build them, but │ │ │ │ │ -0002f080: 2069 6620 7468 650a 6c69 6272 6172 7920 if the.library │ │ │ │ │ -0002f090: 646f 6573 206e 6f74 2061 7070 6561 7220 does not appear │ │ │ │ │ -0002f0a0: 6173 2061 204d 616b 6566 696c 6520 6465 as a Makefile de │ │ │ │ │ -0002f0b0: 7065 6e64 656e 6379 2061 6e79 7768 6572 pendency anywher │ │ │ │ │ -0002f0c0: 6520 6974 2077 6f6e 2774 2062 650a 6275 e it won't be.bu │ │ │ │ │ -0002f0d0: 696c 7420 2874 6869 7320 6973 2077 6879 ilt (this is why │ │ │ │ │ -0002f0e0: 2027 4558 5452 415f 4c54 4c49 4252 4152 'EXTRA_LTLIBRAR │ │ │ │ │ -0002f0f0: 4945 5327 2069 7320 7573 6564 2066 6f72 IES' is used for │ │ │ │ │ -0002f100: 2063 6f6e 6469 7469 6f6e 616c 0a63 6f6d conditional.com │ │ │ │ │ -0002f110: 7069 6c61 7469 6f6e 292e 0a0a 2020 2048 pilation)... H │ │ │ │ │ -0002f120: 6572 6520 6973 2061 2073 616d 706c 6520 ere is a sample │ │ │ │ │ -0002f130: 7365 7475 7020 6d65 7267 696e 6720 6c69 setup merging li │ │ │ │ │ -0002f140: 6274 6f6f 6c20 636f 6e76 656e 6965 6e63 btool convenienc │ │ │ │ │ -0002f150: 6520 6c69 6272 6172 6965 7320 6672 6f6d e libraries from │ │ │ │ │ -0002f160: 0a73 7562 6469 7265 6374 6f72 6965 7320 .subdirectories │ │ │ │ │ -0002f170: 696e 746f 206f 6e65 206d 6169 6e20 276c into one main 'l │ │ │ │ │ -0002f180: 6962 746f 702e 6c61 2720 6c69 6272 6172 ibtop.la' librar │ │ │ │ │ -0002f190: 792e 0a0a 2020 2020 2023 202d 2d20 546f y... # -- To │ │ │ │ │ -0002f1a0: 702d 6c65 7665 6c20 4d61 6b65 6669 6c65 p-level Makefile │ │ │ │ │ -0002f1b0: 2e61 6d20 2d2d 0a20 2020 2020 5355 4244 .am --. SUBD │ │ │ │ │ -0002f1c0: 4952 5320 3d20 7375 6231 2073 7562 3220 IRS = sub1 sub2 │ │ │ │ │ -0002f1d0: 2e2e 2e0a 2020 2020 206c 6962 5f4c 544c .... lib_LTL │ │ │ │ │ -0002f1e0: 4942 5241 5249 4553 203d 206c 6962 746f IBRARIES = libto │ │ │ │ │ -0002f1f0: 702e 6c61 0a20 2020 2020 6c69 6274 6f70 p.la. libtop │ │ │ │ │ -0002f200: 5f6c 615f 534f 5552 4345 5320 3d0a 2020 _la_SOURCES =. │ │ │ │ │ -0002f210: 2020 206c 6962 746f 705f 6c61 5f4c 4942 libtop_la_LIB │ │ │ │ │ -0002f220: 4144 4420 3d20 5c0a 2020 2020 2020 2073 ADD = \. s │ │ │ │ │ -0002f230: 7562 312f 6c69 6273 7562 312e 6c61 205c ub1/libsub1.la \ │ │ │ │ │ -0002f240: 0a20 2020 2020 2020 7375 6232 2f6c 6962 . sub2/lib │ │ │ │ │ -0002f250: 7375 6232 2e6c 6120 5c0a 2020 2020 2020 sub2.la \. │ │ │ │ │ -0002f260: 202e 2e2e 0a0a 2020 2020 2023 202d 2d20 ..... # -- │ │ │ │ │ -0002f270: 7375 6231 2f4d 616b 6566 696c 652e 616d sub1/Makefile.am │ │ │ │ │ -0002f280: 202d 2d0a 2020 2020 206e 6f69 6e73 745f --. noinst_ │ │ │ │ │ -0002f290: 4c54 4c49 4252 4152 4945 5320 3d20 6c69 LTLIBRARIES = li │ │ │ │ │ -0002f2a0: 6273 7562 312e 6c61 0a20 2020 2020 6c69 bsub1.la. li │ │ │ │ │ -0002f2b0: 6273 7562 315f 6c61 5f53 4f55 5243 4553 bsub1_la_SOURCES │ │ │ │ │ -0002f2c0: 203d 202e 2e2e 0a0a 2020 2020 2023 202d = ..... # - │ │ │ │ │ -0002f2d0: 2d20 7375 6232 2f4d 616b 6566 696c 652e - sub2/Makefile. │ │ │ │ │ -0002f2e0: 616d 202d 2d0a 2020 2020 2023 2073 686f am --. # sho │ │ │ │ │ -0002f2f0: 7769 6e67 206e 6573 7465 6420 636f 6e76 wing nested conv │ │ │ │ │ -0002f300: 656e 6965 6e63 6520 6c69 6272 6172 6965 enience librarie │ │ │ │ │ -0002f310: 730a 2020 2020 2053 5542 4449 5253 203d s. SUBDIRS = │ │ │ │ │ -0002f320: 2073 7562 322e 3120 7375 6232 2e32 202e sub2.1 sub2.2 . │ │ │ │ │ -0002f330: 2e2e 0a20 2020 2020 6e6f 696e 7374 5f4c ... noinst_L │ │ │ │ │ -0002f340: 544c 4942 5241 5249 4553 203d 206c 6962 TLIBRARIES = lib │ │ │ │ │ -0002f350: 7375 6232 2e6c 610a 2020 2020 206c 6962 sub2.la. lib │ │ │ │ │ -0002f360: 7375 6232 5f6c 615f 534f 5552 4345 5320 sub2_la_SOURCES │ │ │ │ │ -0002f370: 3d0a 2020 2020 206c 6962 7375 6232 5f6c =. libsub2_l │ │ │ │ │ -0002f380: 615f 4c49 4241 4444 203d 205c 0a20 2020 a_LIBADD = \. │ │ │ │ │ -0002f390: 2020 2020 7375 6232 312f 6c69 6273 7562 sub21/libsub │ │ │ │ │ -0002f3a0: 3231 2e6c 6120 5c0a 2020 2020 2020 2073 21.la \. s │ │ │ │ │ -0002f3b0: 7562 3232 2f6c 6962 7375 6232 322e 6c61 ub22/libsub22.la │ │ │ │ │ -0002f3c0: 205c 0a20 2020 2020 2020 2e2e 2e0a 0a20 \. ..... │ │ │ │ │ -0002f3d0: 2020 5768 656e 2075 7369 6e67 2073 7563 When using suc │ │ │ │ │ -0002f3e0: 6820 7365 7475 702c 2062 6577 6172 6520 h setup, beware │ │ │ │ │ -0002f3f0: 7468 6174 2027 6175 746f 6d61 6b65 2720 that 'automake' │ │ │ │ │ -0002f400: 7769 6c6c 2061 7373 756d 6520 276c 6962 will assume 'lib │ │ │ │ │ -0002f410: 746f 702e 6c61 270a 6973 2074 6f20 6265 top.la'.is to be │ │ │ │ │ -0002f420: 206c 696e 6b65 6420 7769 7468 2074 6865 linked with the │ │ │ │ │ -0002f430: 2043 206c 696e 6b65 722e 2020 5468 6973 C linker. This │ │ │ │ │ -0002f440: 2069 7320 6265 6361 7573 6520 276c 6962 is because 'lib │ │ │ │ │ -0002f450: 746f 705f 6c61 5f53 4f55 5243 4553 270a top_la_SOURCES'. │ │ │ │ │ -0002f460: 6973 2065 6d70 7479 2c20 736f 2027 6175 is empty, so 'au │ │ │ │ │ -0002f470: 746f 6d61 6b65 2720 7069 636b 7320 4320 tomake' picks C │ │ │ │ │ -0002f480: 6173 2064 6566 6175 6c74 206c 616e 6775 as default langu │ │ │ │ │ -0002f490: 6167 652e 2020 4966 0a27 6c69 6274 6f70 age. If.'libtop │ │ │ │ │ -0002f4a0: 5f6c 615f 534f 5552 4345 5327 2077 6173 _la_SOURCES' was │ │ │ │ │ -0002f4b0: 206e 6f74 2065 6d70 7479 2c20 2761 7574 not empty, 'aut │ │ │ │ │ -0002f4c0: 6f6d 616b 6527 2077 6f75 6c64 2073 656c omake' would sel │ │ │ │ │ -0002f4d0: 6563 7420 7468 6520 6c69 6e6b 6572 2061 ect the linker a │ │ │ │ │ -0002f4e0: 730a 6578 706c 6169 6e65 6420 696e 202a s.explained in * │ │ │ │ │ -0002f4f0: 6e6f 7465 2048 6f77 2074 6865 204c 696e note How the Lin │ │ │ │ │ -0002f500: 6b65 7220 6973 2043 686f 7365 6e3a 3a2e ker is Chosen::. │ │ │ │ │ -0002f510: 0a0a 2020 2049 6620 6f6e 6520 6f66 2074 .. If one of t │ │ │ │ │ -0002f520: 6865 2073 7562 6c69 6272 6172 6965 7320 he sublibraries │ │ │ │ │ -0002f530: 636f 6e74 6169 6e73 206e 6f6e 2d43 2073 contains non-C s │ │ │ │ │ -0002f540: 6f75 7263 652c 2069 7420 6973 2069 6d70 ource, it is imp │ │ │ │ │ -0002f550: 6f72 7461 6e74 0a74 6861 7420 7468 6520 ortant.that the │ │ │ │ │ -0002f560: 6170 7072 6f70 7269 6174 6520 6c69 6e6b appropriate link │ │ │ │ │ -0002f570: 6572 2062 6520 6368 6f73 656e 2e20 204f er be chosen. O │ │ │ │ │ -0002f580: 6e65 2077 6179 2074 6f20 6163 6869 6576 ne way to achiev │ │ │ │ │ -0002f590: 6520 7468 6973 2069 7320 746f 0a70 7265 e this is to.pre │ │ │ │ │ -0002f5a0: 7465 6e64 2074 6861 7420 7468 6572 6520 tend that there │ │ │ │ │ -0002f5b0: 6973 2073 7563 6820 6120 6e6f 6e2d 4320 is such a non-C │ │ │ │ │ -0002f5c0: 6669 6c65 2061 6d6f 6e67 2074 6865 2073 file among the s │ │ │ │ │ -0002f5d0: 6f75 7263 6573 206f 6620 7468 650a 6c69 ources of the.li │ │ │ │ │ -0002f5e0: 6272 6172 792c 2074 6875 7320 666f 7263 brary, thus forc │ │ │ │ │ -0002f5f0: 696e 6720 2761 7574 6f6d 616b 6527 2074 ing 'automake' t │ │ │ │ │ -0002f600: 6f20 7365 6c65 6374 2074 6865 2061 7070 o select the app │ │ │ │ │ -0002f610: 726f 7072 6961 7465 206c 696e 6b65 722e ropriate linker. │ │ │ │ │ -0002f620: 2020 4865 7265 0a69 7320 7468 6520 746f Here.is the to │ │ │ │ │ -0002f630: 702d 6c65 7665 6c20 274d 616b 6566 696c p-level 'Makefil │ │ │ │ │ -0002f640: 6527 206f 6620 6f75 7220 6578 616d 706c e' of our exampl │ │ │ │ │ -0002f650: 6520 7570 6461 7465 6420 746f 2066 6f72 e updated to for │ │ │ │ │ -0002f660: 6365 2043 2b2b 206c 696e 6b69 6e67 2e0a ce C++ linking.. │ │ │ │ │ -0002f670: 0a20 2020 2020 5355 4244 4952 5320 3d20 . SUBDIRS = │ │ │ │ │ -0002f680: 7375 6231 2073 7562 3220 2e2e 2e0a 2020 sub1 sub2 .... │ │ │ │ │ -0002f690: 2020 206c 6962 5f4c 544c 4942 5241 5249 lib_LTLIBRARI │ │ │ │ │ -0002f6a0: 4553 203d 206c 6962 746f 702e 6c61 0a20 ES = libtop.la. │ │ │ │ │ -0002f6b0: 2020 2020 6c69 6274 6f70 5f6c 615f 534f libtop_la_SO │ │ │ │ │ -0002f6c0: 5552 4345 5320 3d0a 2020 2020 2023 2044 URCES =. # D │ │ │ │ │ -0002f6d0: 756d 6d79 2043 2b2b 2073 6f75 7263 6520 ummy C++ source │ │ │ │ │ -0002f6e0: 746f 2063 6175 7365 2043 2b2b 206c 696e to cause C++ lin │ │ │ │ │ -0002f6f0: 6b69 6e67 2e0a 2020 2020 206e 6f64 6973 king.. nodis │ │ │ │ │ -0002f700: 745f 4558 5452 415f 6c69 6274 6f70 5f6c t_EXTRA_libtop_l │ │ │ │ │ -0002f710: 615f 534f 5552 4345 5320 3d20 6475 6d6d a_SOURCES = dumm │ │ │ │ │ -0002f720: 792e 6378 780a 2020 2020 206c 6962 746f y.cxx. libto │ │ │ │ │ -0002f730: 705f 6c61 5f4c 4942 4144 4420 3d20 5c0a p_la_LIBADD = \. │ │ │ │ │ -0002f740: 2020 2020 2020 2073 7562 312f 6c69 6273 sub1/libs │ │ │ │ │ -0002f750: 7562 312e 6c61 205c 0a20 2020 2020 2020 ub1.la \. │ │ │ │ │ -0002f760: 7375 6232 2f6c 6962 7375 6232 2e6c 6120 sub2/libsub2.la │ │ │ │ │ -0002f770: 5c0a 2020 2020 2020 202e 2e2e 0a0a 2020 \. ..... │ │ │ │ │ -0002f780: 2027 4558 5452 415f 2a5f 534f 5552 4345 'EXTRA_*_SOURCE │ │ │ │ │ -0002f790: 5327 2076 6172 6961 626c 6573 2061 7265 S' variables are │ │ │ │ │ -0002f7a0: 2075 7365 6420 746f 206b 6565 7020 7472 used to keep tr │ │ │ │ │ -0002f7b0: 6163 6b20 6f66 2073 6f75 7263 6520 6669 ack of source fi │ │ │ │ │ -0002f7c0: 6c65 730a 7468 6174 206d 6967 6874 2062 les.that might b │ │ │ │ │ -0002f7d0: 6520 636f 6d70 696c 6564 2028 7468 6973 e compiled (this │ │ │ │ │ -0002f7e0: 2069 7320 6d6f 7374 6c79 2075 7365 6675 is mostly usefu │ │ │ │ │ -0002f7f0: 6c20 7768 656e 2064 6f69 6e67 2063 6f6e l when doing con │ │ │ │ │ -0002f800: 6469 7469 6f6e 616c 0a63 6f6d 7069 6c61 ditional.compila │ │ │ │ │ -0002f810: 7469 6f6e 2075 7369 6e67 2027 4143 5f53 tion using 'AC_S │ │ │ │ │ -0002f820: 5542 5354 272c 202a 6e6f 7465 2043 6f6e UBST', *note Con │ │ │ │ │ -0002f830: 6469 7469 6f6e 616c 204c 6962 746f 6f6c ditional Libtool │ │ │ │ │ -0002f840: 2053 6f75 7263 6573 3a3a 292c 2061 6e64 Sources::), and │ │ │ │ │ -0002f850: 0a74 6865 2027 6e6f 6469 7374 5f27 2070 .the 'nodist_' p │ │ │ │ │ -0002f860: 7265 6669 7820 6d65 616e 7320 7468 6520 refix means the │ │ │ │ │ -0002f870: 6c69 7374 6564 2073 6f75 7263 6573 2061 listed sources a │ │ │ │ │ -0002f880: 7265 206e 6f74 2074 6f20 6265 2064 6973 re not to be dis │ │ │ │ │ -0002f890: 7472 6962 7574 6564 0a28 2a6e 6f74 6520 tributed.(*note │ │ │ │ │ -0002f8a0: 5072 6f67 7261 6d20 616e 6420 4c69 6272 Program and Libr │ │ │ │ │ -0002f8b0: 6172 7920 5661 7269 6162 6c65 733a 3a29 ary Variables::) │ │ │ │ │ -0002f8c0: 2e20 2049 6e20 6566 6665 6374 2074 6865 . In effect the │ │ │ │ │ -0002f8d0: 2066 696c 6520 2764 756d 6d79 2e63 7878 file 'dummy.cxx │ │ │ │ │ -0002f8e0: 270a 646f 6573 206e 6f74 206e 6565 6420 '.does not need │ │ │ │ │ -0002f8f0: 746f 2065 7869 7374 2069 6e20 7468 6520 to exist in the │ │ │ │ │ -0002f900: 736f 7572 6365 2074 7265 652e 2020 4f66 source tree. Of │ │ │ │ │ -0002f910: 2063 6f75 7273 6520 6966 2079 6f75 2068 course if you h │ │ │ │ │ -0002f920: 6176 6520 736f 6d65 0a72 6561 6c20 736f ave some.real so │ │ │ │ │ -0002f930: 7572 6365 2066 696c 6520 746f 206c 6973 urce file to lis │ │ │ │ │ -0002f940: 7420 696e 2027 6c69 6274 6f70 5f6c 615f t in 'libtop_la_ │ │ │ │ │ -0002f950: 534f 5552 4345 5327 2074 6865 7265 2069 SOURCES' there i │ │ │ │ │ -0002f960: 7320 6e6f 2070 6f69 6e74 2069 6e0a 6368 s no point in.ch │ │ │ │ │ -0002f970: 6561 7469 6e67 2077 6974 6820 276e 6f64 eating with 'nod │ │ │ │ │ -0002f980: 6973 745f 4558 5452 415f 6c69 6274 6f70 ist_EXTRA_libtop │ │ │ │ │ -0002f990: 5f6c 615f 534f 5552 4345 5327 2e0a 0a1f _la_SOURCES'.... │ │ │ │ │ -0002f9a0: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -0002f9b0: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -0002f9c0: 3a20 4c69 6274 6f6f 6c20 4d6f 6475 6c65 : Libtool Module │ │ │ │ │ -0002f9d0: 732c 2020 4e65 7874 3a20 4c69 6274 6f6f s, Next: Libtoo │ │ │ │ │ -0002f9e0: 6c20 466c 6167 732c 2020 5072 6576 3a20 l Flags, Prev: │ │ │ │ │ -0002f9f0: 4c69 6274 6f6f 6c20 436f 6e76 656e 6965 Libtool Convenie │ │ │ │ │ -0002fa00: 6e63 6520 4c69 6272 6172 6965 732c 2020 nce Libraries, │ │ │ │ │ -0002fa10: 5570 3a20 4120 5368 6172 6564 204c 6962 Up: A Shared Lib │ │ │ │ │ -0002fa20: 7261 7279 0a0a 382e 332e 3620 4c69 6274 rary..8.3.6 Libt │ │ │ │ │ -0002fa30: 6f6f 6c20 4d6f 6475 6c65 730a 2d2d 2d2d ool Modules.---- │ │ │ │ │ +0002ed70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a53 6f6d -----------..Som │ │ │ │ │ +0002ed80: 6574 696d 6573 2079 6f75 2077 616e 7420 etimes you want │ │ │ │ │ +0002ed90: 746f 2062 7569 6c64 206c 6962 746f 6f6c to build libtool │ │ │ │ │ +0002eda0: 206c 6962 7261 7269 6573 2074 6861 7420 libraries that │ │ │ │ │ +0002edb0: 7368 6f75 6c64 206e 6f74 2062 650a 696e should not be.in │ │ │ │ │ +0002edc0: 7374 616c 6c65 642e 2020 5468 6573 6520 stalled. These │ │ │ │ │ +0002edd0: 6172 6520 6361 6c6c 6564 2022 6c69 6274 are called "libt │ │ │ │ │ +0002ede0: 6f6f 6c20 636f 6e76 656e 6965 6e63 6520 ool convenience │ │ │ │ │ +0002edf0: 6c69 6272 6172 6965 7322 2061 6e64 2061 libraries" and a │ │ │ │ │ +0002ee00: 7265 0a74 7970 6963 616c 6c79 2075 7365 re.typically use │ │ │ │ │ +0002ee10: 6420 746f 2065 6e63 6170 7375 6c61 7465 d to encapsulate │ │ │ │ │ +0002ee20: 206d 616e 7920 7375 626c 6962 7261 7269 many sublibrari │ │ │ │ │ +0002ee30: 6573 2c20 6c61 7465 7220 6761 7468 6572 es, later gather │ │ │ │ │ +0002ee40: 6564 2069 6e74 6f20 6f6e 650a 6269 6720 ed into one.big │ │ │ │ │ +0002ee50: 696e 7374 616c 6c65 6420 6c69 6272 6172 installed librar │ │ │ │ │ +0002ee60: 792e 0a0a 2020 204c 6962 746f 6f6c 2063 y... Libtool c │ │ │ │ │ +0002ee70: 6f6e 7665 6e69 656e 6365 206c 6962 7261 onvenience libra │ │ │ │ │ +0002ee80: 7269 6573 2061 7265 2064 6563 6c61 7265 ries are declare │ │ │ │ │ +0002ee90: 6420 6279 2064 6972 6563 746f 7279 2d6c d by directory-l │ │ │ │ │ +0002eea0: 6573 730a 7661 7269 6162 6c65 7320 7375 ess.variables su │ │ │ │ │ +0002eeb0: 6368 2061 7320 276e 6f69 6e73 745f 4c54 ch as 'noinst_LT │ │ │ │ │ +0002eec0: 4c49 4252 4152 4945 5327 2c20 2763 6865 LIBRARIES', 'che │ │ │ │ │ +0002eed0: 636b 5f4c 544c 4942 5241 5249 4553 272c ck_LTLIBRARIES', │ │ │ │ │ +0002eee0: 206f 7220 6576 656e 0a27 4558 5452 415f or even.'EXTRA_ │ │ │ │ │ +0002eef0: 4c54 4c49 4252 4152 4945 5327 2e20 2055 LTLIBRARIES'. U │ │ │ │ │ +0002ef00: 6e6c 696b 6520 696e 7374 616c 6c65 6420 nlike installed │ │ │ │ │ +0002ef10: 6c69 6274 6f6f 6c20 6c69 6272 6172 6965 libtool librarie │ │ │ │ │ +0002ef20: 7320 7468 6579 2064 6f20 6e6f 740a 6e65 s they do not.ne │ │ │ │ │ +0002ef30: 6564 2061 6e20 272d 7270 6174 6827 2066 ed an '-rpath' f │ │ │ │ │ +0002ef40: 6c61 6720 6174 206c 696e 6b20 7469 6d65 lag at link time │ │ │ │ │ +0002ef50: 2028 6163 7475 616c 6c79 2074 6869 7320 (actually this │ │ │ │ │ +0002ef60: 6973 2074 6865 206f 6e6c 790a 6469 6666 is the only.diff │ │ │ │ │ +0002ef70: 6572 656e 6365 292e 0a0a 2020 2043 6f6e erence)... Con │ │ │ │ │ +0002ef80: 7665 6e69 656e 6365 206c 6962 7261 7269 venience librari │ │ │ │ │ +0002ef90: 6573 206c 6973 7465 6420 696e 2027 6e6f es listed in 'no │ │ │ │ │ +0002efa0: 696e 7374 5f4c 544c 4942 5241 5249 4553 inst_LTLIBRARIES │ │ │ │ │ +0002efb0: 2720 6172 6520 616c 7761 7973 0a62 7569 ' are always.bui │ │ │ │ │ +0002efc0: 6c74 2e20 2054 686f 7365 206c 6973 7465 lt. Those liste │ │ │ │ │ +0002efd0: 6420 696e 2027 6368 6563 6b5f 4c54 4c49 d in 'check_LTLI │ │ │ │ │ +0002efe0: 4252 4152 4945 5327 2061 7265 2062 7569 BRARIES' are bui │ │ │ │ │ +0002eff0: 6c74 206f 6e6c 7920 7570 6f6e 2027 6d61 lt only upon 'ma │ │ │ │ │ +0002f000: 6b65 0a63 6865 636b 272e 2020 4669 6e61 ke.check'. Fina │ │ │ │ │ +0002f010: 6c6c 792c 206c 6962 7261 7269 6573 206c lly, libraries l │ │ │ │ │ +0002f020: 6973 7465 6420 696e 2027 4558 5452 415f isted in 'EXTRA_ │ │ │ │ │ +0002f030: 4c54 4c49 4252 4152 4945 5327 2061 7265 LTLIBRARIES' are │ │ │ │ │ +0002f040: 206e 6576 6572 0a62 7569 6c74 2065 7870 never.built exp │ │ │ │ │ +0002f050: 6c69 6369 746c 793a 2041 7574 6f6d 616b licitly: Automak │ │ │ │ │ +0002f060: 6520 6f75 7470 7574 7320 7275 6c65 7320 e outputs rules │ │ │ │ │ +0002f070: 746f 2062 7569 6c64 2074 6865 6d2c 2062 to build them, b │ │ │ │ │ +0002f080: 7574 2069 6620 7468 650a 6c69 6272 6172 ut if the.librar │ │ │ │ │ +0002f090: 7920 646f 6573 206e 6f74 2061 7070 6561 y does not appea │ │ │ │ │ +0002f0a0: 7220 6173 2061 204d 616b 6566 696c 6520 r as a Makefile │ │ │ │ │ +0002f0b0: 6465 7065 6e64 656e 6379 2061 6e79 7768 dependency anywh │ │ │ │ │ +0002f0c0: 6572 6520 6974 2077 6f6e 2774 2062 650a ere it won't be. │ │ │ │ │ +0002f0d0: 6275 696c 7420 2874 6869 7320 6973 2077 built (this is w │ │ │ │ │ +0002f0e0: 6879 2027 4558 5452 415f 4c54 4c49 4252 hy 'EXTRA_LTLIBR │ │ │ │ │ +0002f0f0: 4152 4945 5327 2069 7320 7573 6564 2066 ARIES' is used f │ │ │ │ │ +0002f100: 6f72 2063 6f6e 6469 7469 6f6e 616c 0a63 or conditional.c │ │ │ │ │ +0002f110: 6f6d 7069 6c61 7469 6f6e 292e 0a0a 2020 ompilation)... │ │ │ │ │ +0002f120: 2048 6572 6520 6973 2061 2073 616d 706c Here is a sampl │ │ │ │ │ +0002f130: 6520 7365 7475 7020 6d65 7267 696e 6720 e setup merging │ │ │ │ │ +0002f140: 6c69 6274 6f6f 6c20 636f 6e76 656e 6965 libtool convenie │ │ │ │ │ +0002f150: 6e63 6520 6c69 6272 6172 6965 7320 6672 nce libraries fr │ │ │ │ │ +0002f160: 6f6d 0a73 7562 6469 7265 6374 6f72 6965 om.subdirectorie │ │ │ │ │ +0002f170: 7320 696e 746f 206f 6e65 206d 6169 6e20 s into one main │ │ │ │ │ +0002f180: 276c 6962 746f 702e 6c61 2720 6c69 6272 'libtop.la' libr │ │ │ │ │ +0002f190: 6172 792e 0a0a 2020 2020 2023 202d 2d20 ary... # -- │ │ │ │ │ +0002f1a0: 546f 702d 6c65 7665 6c20 4d61 6b65 6669 Top-level Makefi │ │ │ │ │ +0002f1b0: 6c65 2e61 6d20 2d2d 0a20 2020 2020 5355 le.am --. SU │ │ │ │ │ +0002f1c0: 4244 4952 5320 3d20 7375 6231 2073 7562 BDIRS = sub1 sub │ │ │ │ │ +0002f1d0: 3220 2e2e 2e0a 2020 2020 206c 6962 5f4c 2 .... lib_L │ │ │ │ │ +0002f1e0: 544c 4942 5241 5249 4553 203d 206c 6962 TLIBRARIES = lib │ │ │ │ │ +0002f1f0: 746f 702e 6c61 0a20 2020 2020 6c69 6274 top.la. libt │ │ │ │ │ +0002f200: 6f70 5f6c 615f 534f 5552 4345 5320 3d0a op_la_SOURCES =. │ │ │ │ │ +0002f210: 2020 2020 206c 6962 746f 705f 6c61 5f4c libtop_la_L │ │ │ │ │ +0002f220: 4942 4144 4420 3d20 5c0a 2020 2020 2020 IBADD = \. │ │ │ │ │ +0002f230: 2073 7562 312f 6c69 6273 7562 312e 6c61 sub1/libsub1.la │ │ │ │ │ +0002f240: 205c 0a20 2020 2020 2020 7375 6232 2f6c \. sub2/l │ │ │ │ │ +0002f250: 6962 7375 6232 2e6c 6120 5c0a 2020 2020 ibsub2.la \. │ │ │ │ │ +0002f260: 2020 202e 2e2e 0a0a 2020 2020 2023 202d ..... # - │ │ │ │ │ +0002f270: 2d20 7375 6231 2f4d 616b 6566 696c 652e - sub1/Makefile. │ │ │ │ │ +0002f280: 616d 202d 2d0a 2020 2020 206e 6f69 6e73 am --. noins │ │ │ │ │ +0002f290: 745f 4c54 4c49 4252 4152 4945 5320 3d20 t_LTLIBRARIES = │ │ │ │ │ +0002f2a0: 6c69 6273 7562 312e 6c61 0a20 2020 2020 libsub1.la. │ │ │ │ │ +0002f2b0: 6c69 6273 7562 315f 6c61 5f53 4f55 5243 libsub1_la_SOURC │ │ │ │ │ +0002f2c0: 4553 203d 202e 2e2e 0a0a 2020 2020 2023 ES = ..... # │ │ │ │ │ +0002f2d0: 202d 2d20 7375 6232 2f4d 616b 6566 696c -- sub2/Makefil │ │ │ │ │ +0002f2e0: 652e 616d 202d 2d0a 2020 2020 2023 2073 e.am --. # s │ │ │ │ │ +0002f2f0: 686f 7769 6e67 206e 6573 7465 6420 636f howing nested co │ │ │ │ │ +0002f300: 6e76 656e 6965 6e63 6520 6c69 6272 6172 nvenience librar │ │ │ │ │ +0002f310: 6965 730a 2020 2020 2053 5542 4449 5253 ies. SUBDIRS │ │ │ │ │ +0002f320: 203d 2073 7562 322e 3120 7375 6232 2e32 = sub2.1 sub2.2 │ │ │ │ │ +0002f330: 202e 2e2e 0a20 2020 2020 6e6f 696e 7374 .... noinst │ │ │ │ │ +0002f340: 5f4c 544c 4942 5241 5249 4553 203d 206c _LTLIBRARIES = l │ │ │ │ │ +0002f350: 6962 7375 6232 2e6c 610a 2020 2020 206c ibsub2.la. l │ │ │ │ │ +0002f360: 6962 7375 6232 5f6c 615f 534f 5552 4345 ibsub2_la_SOURCE │ │ │ │ │ +0002f370: 5320 3d0a 2020 2020 206c 6962 7375 6232 S =. libsub2 │ │ │ │ │ +0002f380: 5f6c 615f 4c49 4241 4444 203d 205c 0a20 _la_LIBADD = \. │ │ │ │ │ +0002f390: 2020 2020 2020 7375 6232 312f 6c69 6273 sub21/libs │ │ │ │ │ +0002f3a0: 7562 3231 2e6c 6120 5c0a 2020 2020 2020 ub21.la \. │ │ │ │ │ +0002f3b0: 2073 7562 3232 2f6c 6962 7375 6232 322e sub22/libsub22. │ │ │ │ │ +0002f3c0: 6c61 205c 0a20 2020 2020 2020 2e2e 2e0a la \. .... │ │ │ │ │ +0002f3d0: 0a20 2020 5768 656e 2075 7369 6e67 2073 . When using s │ │ │ │ │ +0002f3e0: 7563 6820 7365 7475 702c 2062 6577 6172 uch setup, bewar │ │ │ │ │ +0002f3f0: 6520 7468 6174 2027 6175 746f 6d61 6b65 e that 'automake │ │ │ │ │ +0002f400: 2720 7769 6c6c 2061 7373 756d 6520 276c ' will assume 'l │ │ │ │ │ +0002f410: 6962 746f 702e 6c61 270a 6973 2074 6f20 ibtop.la'.is to │ │ │ │ │ +0002f420: 6265 206c 696e 6b65 6420 7769 7468 2074 be linked with t │ │ │ │ │ +0002f430: 6865 2043 206c 696e 6b65 722e 2020 5468 he C linker. Th │ │ │ │ │ +0002f440: 6973 2069 7320 6265 6361 7573 6520 276c is is because 'l │ │ │ │ │ +0002f450: 6962 746f 705f 6c61 5f53 4f55 5243 4553 ibtop_la_SOURCES │ │ │ │ │ +0002f460: 270a 6973 2065 6d70 7479 2c20 736f 2027 '.is empty, so ' │ │ │ │ │ +0002f470: 6175 746f 6d61 6b65 2720 7069 636b 7320 automake' picks │ │ │ │ │ +0002f480: 4320 6173 2064 6566 6175 6c74 206c 616e C as default lan │ │ │ │ │ +0002f490: 6775 6167 652e 2020 4966 0a27 6c69 6274 guage. If.'libt │ │ │ │ │ +0002f4a0: 6f70 5f6c 615f 534f 5552 4345 5327 2077 op_la_SOURCES' w │ │ │ │ │ +0002f4b0: 6173 206e 6f74 2065 6d70 7479 2c20 2761 as not empty, 'a │ │ │ │ │ +0002f4c0: 7574 6f6d 616b 6527 2077 6f75 6c64 2073 utomake' would s │ │ │ │ │ +0002f4d0: 656c 6563 7420 7468 6520 6c69 6e6b 6572 elect the linker │ │ │ │ │ +0002f4e0: 2061 730a 6578 706c 6169 6e65 6420 696e as.explained in │ │ │ │ │ +0002f4f0: 202a 6e6f 7465 2048 6f77 2074 6865 204c *note How the L │ │ │ │ │ +0002f500: 696e 6b65 7220 6973 2043 686f 7365 6e3a inker is Chosen: │ │ │ │ │ +0002f510: 3a2e 0a0a 2020 2049 6620 6f6e 6520 6f66 :... If one of │ │ │ │ │ +0002f520: 2074 6865 2073 7562 6c69 6272 6172 6965 the sublibrarie │ │ │ │ │ +0002f530: 7320 636f 6e74 6169 6e73 206e 6f6e 2d43 s contains non-C │ │ │ │ │ +0002f540: 2073 6f75 7263 652c 2069 7420 6973 2069 source, it is i │ │ │ │ │ +0002f550: 6d70 6f72 7461 6e74 0a74 6861 7420 7468 mportant.that th │ │ │ │ │ +0002f560: 6520 6170 7072 6f70 7269 6174 6520 6c69 e appropriate li │ │ │ │ │ +0002f570: 6e6b 6572 2062 6520 6368 6f73 656e 2e20 nker be chosen. │ │ │ │ │ +0002f580: 204f 6e65 2077 6179 2074 6f20 6163 6869 One way to achi │ │ │ │ │ +0002f590: 6576 6520 7468 6973 2069 7320 746f 0a70 eve this is to.p │ │ │ │ │ +0002f5a0: 7265 7465 6e64 2074 6861 7420 7468 6572 retend that ther │ │ │ │ │ +0002f5b0: 6520 6973 2073 7563 6820 6120 6e6f 6e2d e is such a non- │ │ │ │ │ +0002f5c0: 4320 6669 6c65 2061 6d6f 6e67 2074 6865 C file among the │ │ │ │ │ +0002f5d0: 2073 6f75 7263 6573 206f 6620 7468 650a sources of the. │ │ │ │ │ +0002f5e0: 6c69 6272 6172 792c 2074 6875 7320 666f library, thus fo │ │ │ │ │ +0002f5f0: 7263 696e 6720 2761 7574 6f6d 616b 6527 rcing 'automake' │ │ │ │ │ +0002f600: 2074 6f20 7365 6c65 6374 2074 6865 2061 to select the a │ │ │ │ │ +0002f610: 7070 726f 7072 6961 7465 206c 696e 6b65 ppropriate linke │ │ │ │ │ +0002f620: 722e 2020 4865 7265 0a69 7320 7468 6520 r. Here.is the │ │ │ │ │ +0002f630: 746f 702d 6c65 7665 6c20 274d 616b 6566 top-level 'Makef │ │ │ │ │ +0002f640: 696c 6527 206f 6620 6f75 7220 6578 616d ile' of our exam │ │ │ │ │ +0002f650: 706c 6520 7570 6461 7465 6420 746f 2066 ple updated to f │ │ │ │ │ +0002f660: 6f72 6365 2043 2b2b 206c 696e 6b69 6e67 orce C++ linking │ │ │ │ │ +0002f670: 2e0a 0a20 2020 2020 5355 4244 4952 5320 ... SUBDIRS │ │ │ │ │ +0002f680: 3d20 7375 6231 2073 7562 3220 2e2e 2e0a = sub1 sub2 .... │ │ │ │ │ +0002f690: 2020 2020 206c 6962 5f4c 544c 4942 5241 lib_LTLIBRA │ │ │ │ │ +0002f6a0: 5249 4553 203d 206c 6962 746f 702e 6c61 RIES = libtop.la │ │ │ │ │ +0002f6b0: 0a20 2020 2020 6c69 6274 6f70 5f6c 615f . libtop_la_ │ │ │ │ │ +0002f6c0: 534f 5552 4345 5320 3d0a 2020 2020 2023 SOURCES =. # │ │ │ │ │ +0002f6d0: 2044 756d 6d79 2043 2b2b 2073 6f75 7263 Dummy C++ sourc │ │ │ │ │ +0002f6e0: 6520 746f 2063 6175 7365 2043 2b2b 206c e to cause C++ l │ │ │ │ │ +0002f6f0: 696e 6b69 6e67 2e0a 2020 2020 206e 6f64 inking.. nod │ │ │ │ │ +0002f700: 6973 745f 4558 5452 415f 6c69 6274 6f70 ist_EXTRA_libtop │ │ │ │ │ +0002f710: 5f6c 615f 534f 5552 4345 5320 3d20 6475 _la_SOURCES = du │ │ │ │ │ +0002f720: 6d6d 792e 6378 780a 2020 2020 206c 6962 mmy.cxx. lib │ │ │ │ │ +0002f730: 746f 705f 6c61 5f4c 4942 4144 4420 3d20 top_la_LIBADD = │ │ │ │ │ +0002f740: 5c0a 2020 2020 2020 2073 7562 312f 6c69 \. sub1/li │ │ │ │ │ +0002f750: 6273 7562 312e 6c61 205c 0a20 2020 2020 bsub1.la \. │ │ │ │ │ +0002f760: 2020 7375 6232 2f6c 6962 7375 6232 2e6c sub2/libsub2.l │ │ │ │ │ +0002f770: 6120 5c0a 2020 2020 2020 202e 2e2e 0a0a a \. ..... │ │ │ │ │ +0002f780: 2020 2027 4558 5452 415f 2a5f 534f 5552 'EXTRA_*_SOUR │ │ │ │ │ +0002f790: 4345 5327 2076 6172 6961 626c 6573 2061 CES' variables a │ │ │ │ │ +0002f7a0: 7265 2075 7365 6420 746f 206b 6565 7020 re used to keep │ │ │ │ │ +0002f7b0: 7472 6163 6b20 6f66 2073 6f75 7263 6520 track of source │ │ │ │ │ +0002f7c0: 6669 6c65 730a 7468 6174 206d 6967 6874 files.that might │ │ │ │ │ +0002f7d0: 2062 6520 636f 6d70 696c 6564 2028 7468 be compiled (th │ │ │ │ │ +0002f7e0: 6973 2069 7320 6d6f 7374 6c79 2075 7365 is is mostly use │ │ │ │ │ +0002f7f0: 6675 6c20 7768 656e 2064 6f69 6e67 2063 ful when doing c │ │ │ │ │ +0002f800: 6f6e 6469 7469 6f6e 616c 0a63 6f6d 7069 onditional.compi │ │ │ │ │ +0002f810: 6c61 7469 6f6e 2075 7369 6e67 2027 4143 lation using 'AC │ │ │ │ │ +0002f820: 5f53 5542 5354 272c 202a 6e6f 7465 2043 _SUBST', *note C │ │ │ │ │ +0002f830: 6f6e 6469 7469 6f6e 616c 204c 6962 746f onditional Libto │ │ │ │ │ +0002f840: 6f6c 2053 6f75 7263 6573 3a3a 292c 2061 ol Sources::), a │ │ │ │ │ +0002f850: 6e64 0a74 6865 2027 6e6f 6469 7374 5f27 nd.the 'nodist_' │ │ │ │ │ +0002f860: 2070 7265 6669 7820 6d65 616e 7320 7468 prefix means th │ │ │ │ │ +0002f870: 6520 6c69 7374 6564 2073 6f75 7263 6573 e listed sources │ │ │ │ │ +0002f880: 2061 7265 206e 6f74 2074 6f20 6265 2064 are not to be d │ │ │ │ │ +0002f890: 6973 7472 6962 7574 6564 0a28 2a6e 6f74 istributed.(*not │ │ │ │ │ +0002f8a0: 6520 5072 6f67 7261 6d20 616e 6420 4c69 e Program and Li │ │ │ │ │ +0002f8b0: 6272 6172 7920 5661 7269 6162 6c65 733a brary Variables: │ │ │ │ │ +0002f8c0: 3a29 2e20 2049 6e20 6566 6665 6374 2074 :). In effect t │ │ │ │ │ +0002f8d0: 6865 2066 696c 6520 2764 756d 6d79 2e63 he file 'dummy.c │ │ │ │ │ +0002f8e0: 7878 270a 646f 6573 206e 6f74 206e 6565 xx'.does not nee │ │ │ │ │ +0002f8f0: 6420 746f 2065 7869 7374 2069 6e20 7468 d to exist in th │ │ │ │ │ +0002f900: 6520 736f 7572 6365 2074 7265 652e 2020 e source tree. │ │ │ │ │ +0002f910: 4f66 2063 6f75 7273 6520 6966 2079 6f75 Of course if you │ │ │ │ │ +0002f920: 2068 6176 6520 736f 6d65 0a72 6561 6c20 have some.real │ │ │ │ │ +0002f930: 736f 7572 6365 2066 696c 6520 746f 206c source file to l │ │ │ │ │ +0002f940: 6973 7420 696e 2027 6c69 6274 6f70 5f6c ist in 'libtop_l │ │ │ │ │ +0002f950: 615f 534f 5552 4345 5327 2074 6865 7265 a_SOURCES' there │ │ │ │ │ +0002f960: 2069 7320 6e6f 2070 6f69 6e74 2069 6e0a is no point in. │ │ │ │ │ +0002f970: 6368 6561 7469 6e67 2077 6974 6820 276e cheating with 'n │ │ │ │ │ +0002f980: 6f64 6973 745f 4558 5452 415f 6c69 6274 odist_EXTRA_libt │ │ │ │ │ +0002f990: 6f70 5f6c 615f 534f 5552 4345 5327 2e0a op_la_SOURCES'.. │ │ │ │ │ +0002f9a0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +0002f9b0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +0002f9c0: 6465 3a20 4c69 6274 6f6f 6c20 4d6f 6475 de: Libtool Modu │ │ │ │ │ +0002f9d0: 6c65 732c 2020 4e65 7874 3a20 4c69 6274 les, Next: Libt │ │ │ │ │ +0002f9e0: 6f6f 6c20 466c 6167 732c 2020 5072 6576 ool Flags, Prev │ │ │ │ │ +0002f9f0: 3a20 4c69 6274 6f6f 6c20 436f 6e76 656e : Libtool Conven │ │ │ │ │ +0002fa00: 6965 6e63 6520 4c69 6272 6172 6965 732c ience Libraries, │ │ │ │ │ +0002fa10: 2020 5570 3a20 4120 5368 6172 6564 204c Up: A Shared L │ │ │ │ │ +0002fa20: 6962 7261 7279 0a0a 382e 332e 3620 4c69 ibrary..8.3.6 Li │ │ │ │ │ +0002fa30: 6274 6f6f 6c20 4d6f 6475 6c65 730a 2d2d btool Modules.-- │ │ │ │ │ 0002fa40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002fa50: 2d0a 0a54 6865 7365 2061 7265 206c 6962 -..These are lib │ │ │ │ │ -0002fa60: 746f 6f6c 206c 6962 7261 7269 6573 206d tool libraries m │ │ │ │ │ -0002fa70: 6561 6e74 2074 6f20 6265 2064 6c6f 7065 eant to be dlope │ │ │ │ │ -0002fa80: 6e65 642e 2020 5468 6579 2061 7265 2069 ned. They are i │ │ │ │ │ -0002fa90: 6e64 6963 6174 6564 2074 6f0a 6c69 6274 ndicated to.libt │ │ │ │ │ -0002faa0: 6f6f 6c20 6279 2070 6173 7369 6e67 2027 ool by passing ' │ │ │ │ │ -0002fab0: 2d6d 6f64 756c 6527 2061 7420 6c69 6e6b -module' at link │ │ │ │ │ -0002fac0: 2d74 696d 652e 0a0a 2020 2020 2070 6b67 -time... pkg │ │ │ │ │ -0002fad0: 6c69 625f 4c54 4c49 4252 4152 4945 5320 lib_LTLIBRARIES │ │ │ │ │ -0002fae0: 3d20 6d79 6d6f 6475 6c65 2e6c 610a 2020 = mymodule.la. │ │ │ │ │ -0002faf0: 2020 206d 796d 6f64 756c 655f 6c61 5f53 mymodule_la_S │ │ │ │ │ -0002fb00: 4f55 5243 4553 203d 2064 6f69 742e 630a OURCES = doit.c. │ │ │ │ │ -0002fb10: 2020 2020 206d 796d 6f64 756c 655f 6c61 mymodule_la │ │ │ │ │ -0002fb20: 5f4c 4446 4c41 4753 203d 202d 6d6f 6475 _LDFLAGS = -modu │ │ │ │ │ -0002fb30: 6c65 0a0a 2020 204f 7264 696e 6172 696c le.. Ordinaril │ │ │ │ │ -0002fb40: 792c 2041 7574 6f6d 616b 6520 7265 7175 y, Automake requ │ │ │ │ │ -0002fb50: 6972 6573 2074 6861 7420 6120 6c69 6272 ires that a libr │ │ │ │ │ -0002fb60: 6172 7927 7320 6e61 6d65 2073 7461 7274 ary's name start │ │ │ │ │ -0002fb70: 2077 6974 6820 276c 6962 272e 0a48 6f77 with 'lib'..How │ │ │ │ │ -0002fb80: 6576 6572 2c20 7768 656e 2062 7569 6c64 ever, when build │ │ │ │ │ -0002fb90: 696e 6720 6120 6479 6e61 6d69 6361 6c6c ing a dynamicall │ │ │ │ │ -0002fba0: 7920 6c6f 6164 6162 6c65 206d 6f64 756c y loadable modul │ │ │ │ │ -0002fbb0: 6520 796f 7520 6d69 6768 7420 7769 7368 e you might wish │ │ │ │ │ -0002fbc0: 2074 6f0a 7573 6520 6120 226e 6f6e 7374 to.use a "nonst │ │ │ │ │ -0002fbd0: 616e 6461 7264 2220 6e61 6d65 2e20 2041 andard" name. A │ │ │ │ │ -0002fbe0: 7574 6f6d 616b 6520 7769 6c6c 206e 6f74 utomake will not │ │ │ │ │ -0002fbf0: 2063 6f6d 706c 6169 6e20 6162 6f75 7420 complain about │ │ │ │ │ -0002fc00: 7375 6368 0a6e 6f6e 7374 616e 6461 7264 such.nonstandard │ │ │ │ │ -0002fc10: 206e 616d 6573 2069 6620 6974 206b 6e6f names if it kno │ │ │ │ │ -0002fc20: 7773 2074 6865 206c 6962 7261 7279 2062 ws the library b │ │ │ │ │ -0002fc30: 6569 6e67 2062 7569 6c74 2069 7320 6120 eing built is a │ │ │ │ │ -0002fc40: 6c69 6274 6f6f 6c0a 6d6f 6475 6c65 2c20 libtool.module, │ │ │ │ │ -0002fc50: 692e 652e 2c20 6966 2027 2d6d 6f64 756c i.e., if '-modul │ │ │ │ │ -0002fc60: 6527 2065 7870 6c69 6369 746c 7920 6170 e' explicitly ap │ │ │ │ │ -0002fc70: 7065 6172 7320 696e 2074 6865 206c 6962 pears in the lib │ │ │ │ │ -0002fc80: 7261 7279 2773 0a27 5f4c 4446 4c41 4753 rary's.'_LDFLAGS │ │ │ │ │ -0002fc90: 2720 7661 7269 6162 6c65 2028 6f72 2069 ' variable (or i │ │ │ │ │ -0002fca0: 6e20 7468 6520 636f 6d6d 6f6e 2027 414d n the common 'AM │ │ │ │ │ -0002fcb0: 5f4c 4446 4c41 4753 2720 7661 7269 6162 _LDFLAGS' variab │ │ │ │ │ -0002fcc0: 6c65 2077 6865 6e20 6e6f 0a70 6572 2d6c le when no.per-l │ │ │ │ │ -0002fcd0: 6962 7261 7279 2027 5f4c 4446 4c41 4753 ibrary '_LDFLAGS │ │ │ │ │ -0002fce0: 2720 7661 7269 6162 6c65 2069 7320 6465 ' variable is de │ │ │ │ │ -0002fcf0: 6669 6e65 6429 2e0a 0a20 2020 4173 2061 fined)... As a │ │ │ │ │ -0002fd00: 6c77 6179 732c 2027 4143 5f53 5542 5354 lways, 'AC_SUBST │ │ │ │ │ -0002fd10: 2720 7661 7269 6162 6c65 7320 6172 6520 ' variables are │ │ │ │ │ -0002fd20: 626c 6163 6b20 626f 7865 7320 746f 2041 black boxes to A │ │ │ │ │ -0002fd30: 7574 6f6d 616b 6520 7369 6e63 650a 7468 utomake since.th │ │ │ │ │ -0002fd40: 6569 7220 7661 6c75 6573 2061 7265 206e eir values are n │ │ │ │ │ -0002fd50: 6f74 2079 6574 206b 6e6f 776e 2077 6865 ot yet known whe │ │ │ │ │ -0002fd60: 6e20 2761 7574 6f6d 616b 6527 2069 7320 n 'automake' is │ │ │ │ │ -0002fd70: 7275 6e2e 2020 5468 6572 6566 6f72 6520 run. Therefore │ │ │ │ │ -0002fd80: 6966 0a27 2d6d 6f64 756c 6527 2069 7320 if.'-module' is │ │ │ │ │ -0002fd90: 7365 7420 7669 6120 7375 6368 2061 2076 set via such a v │ │ │ │ │ -0002fda0: 6172 6961 626c 652c 2041 7574 6f6d 616b ariable, Automak │ │ │ │ │ -0002fdb0: 6520 6361 6e6e 6f74 206e 6f74 6963 6520 e cannot notice │ │ │ │ │ -0002fdc0: 6974 2061 6e64 2077 696c 6c0a 7072 6f63 it and will.proc │ │ │ │ │ -0002fdd0: 6565 6420 6173 2069 6620 7468 6520 6c69 eed as if the li │ │ │ │ │ -0002fde0: 6272 6172 7920 7761 7320 616e 206f 7264 brary was an ord │ │ │ │ │ -0002fdf0: 696e 6172 7920 6c69 6274 6f6f 6c20 6c69 inary libtool li │ │ │ │ │ -0002fe00: 6272 6172 792c 2077 6974 6820 7374 7269 brary, with stri │ │ │ │ │ -0002fe10: 6374 0a6e 616d 696e 672e 0a0a 2020 2049 ct.naming... I │ │ │ │ │ -0002fe20: 6620 276d 796d 6f64 756c 655f 6c61 5f53 f 'mymodule_la_S │ │ │ │ │ -0002fe30: 4f55 5243 4553 2720 6973 206e 6f74 2073 OURCES' is not s │ │ │ │ │ -0002fe40: 7065 6369 6669 6564 2c20 7468 656e 2069 pecified, then i │ │ │ │ │ -0002fe50: 7420 6465 6661 756c 7473 2074 6f20 7468 t defaults to th │ │ │ │ │ -0002fe60: 650a 7369 6e67 6c65 2066 696c 6520 276d e.single file 'm │ │ │ │ │ -0002fe70: 796d 6f64 756c 652e 6327 2028 2a6e 6f74 ymodule.c' (*not │ │ │ │ │ -0002fe80: 6520 4465 6661 756c 7420 5f53 4f55 5243 e Default _SOURC │ │ │ │ │ -0002fe90: 4553 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 ES::).....File: │ │ │ │ │ -0002fea0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -0002feb0: 666f 2c20 204e 6f64 653a 204c 6962 746f fo, Node: Libto │ │ │ │ │ -0002fec0: 6f6c 2046 6c61 6773 2c20 204e 6578 743a ol Flags, Next: │ │ │ │ │ -0002fed0: 204c 544c 4942 4f42 4a53 2c20 2050 7265 LTLIBOBJS, Pre │ │ │ │ │ -0002fee0: 763a 204c 6962 746f 6f6c 204d 6f64 756c v: Libtool Modul │ │ │ │ │ -0002fef0: 6573 2c20 2055 703a 2041 2053 6861 7265 es, Up: A Share │ │ │ │ │ -0002ff00: 6420 4c69 6272 6172 790a 0a38 2e33 2e37 d Library..8.3.7 │ │ │ │ │ -0002ff10: 2027 5f4c 4942 4144 4427 2c20 275f 4c44 '_LIBADD', '_LD │ │ │ │ │ -0002ff20: 464c 4147 5327 2c20 616e 6420 275f 4c49 FLAGS', and '_LI │ │ │ │ │ -0002ff30: 4254 4f4f 4c46 4c41 4753 270a 2d2d 2d2d BTOOLFLAGS'.---- │ │ │ │ │ +0002fa50: 2d2d 2d0a 0a54 6865 7365 2061 7265 206c ---..These are l │ │ │ │ │ +0002fa60: 6962 746f 6f6c 206c 6962 7261 7269 6573 ibtool libraries │ │ │ │ │ +0002fa70: 206d 6561 6e74 2074 6f20 6265 2064 6c6f meant to be dlo │ │ │ │ │ +0002fa80: 7065 6e65 642e 2020 5468 6579 2061 7265 pened. They are │ │ │ │ │ +0002fa90: 2069 6e64 6963 6174 6564 2074 6f0a 6c69 indicated to.li │ │ │ │ │ +0002faa0: 6274 6f6f 6c20 6279 2070 6173 7369 6e67 btool by passing │ │ │ │ │ +0002fab0: 2027 2d6d 6f64 756c 6527 2061 7420 6c69 '-module' at li │ │ │ │ │ +0002fac0: 6e6b 2d74 696d 652e 0a0a 2020 2020 2070 nk-time... p │ │ │ │ │ +0002fad0: 6b67 6c69 625f 4c54 4c49 4252 4152 4945 kglib_LTLIBRARIE │ │ │ │ │ +0002fae0: 5320 3d20 6d79 6d6f 6475 6c65 2e6c 610a S = mymodule.la. │ │ │ │ │ +0002faf0: 2020 2020 206d 796d 6f64 756c 655f 6c61 mymodule_la │ │ │ │ │ +0002fb00: 5f53 4f55 5243 4553 203d 2064 6f69 742e _SOURCES = doit. │ │ │ │ │ +0002fb10: 630a 2020 2020 206d 796d 6f64 756c 655f c. mymodule_ │ │ │ │ │ +0002fb20: 6c61 5f4c 4446 4c41 4753 203d 202d 6d6f la_LDFLAGS = -mo │ │ │ │ │ +0002fb30: 6475 6c65 0a0a 2020 204f 7264 696e 6172 dule.. Ordinar │ │ │ │ │ +0002fb40: 696c 792c 2041 7574 6f6d 616b 6520 7265 ily, Automake re │ │ │ │ │ +0002fb50: 7175 6972 6573 2074 6861 7420 6120 6c69 quires that a li │ │ │ │ │ +0002fb60: 6272 6172 7927 7320 6e61 6d65 2073 7461 brary's name sta │ │ │ │ │ +0002fb70: 7274 2077 6974 6820 276c 6962 272e 0a48 rt with 'lib'..H │ │ │ │ │ +0002fb80: 6f77 6576 6572 2c20 7768 656e 2062 7569 owever, when bui │ │ │ │ │ +0002fb90: 6c64 696e 6720 6120 6479 6e61 6d69 6361 lding a dynamica │ │ │ │ │ +0002fba0: 6c6c 7920 6c6f 6164 6162 6c65 206d 6f64 lly loadable mod │ │ │ │ │ +0002fbb0: 756c 6520 796f 7520 6d69 6768 7420 7769 ule you might wi │ │ │ │ │ +0002fbc0: 7368 2074 6f0a 7573 6520 6120 226e 6f6e sh to.use a "non │ │ │ │ │ +0002fbd0: 7374 616e 6461 7264 2220 6e61 6d65 2e20 standard" name. │ │ │ │ │ +0002fbe0: 2041 7574 6f6d 616b 6520 7769 6c6c 206e Automake will n │ │ │ │ │ +0002fbf0: 6f74 2063 6f6d 706c 6169 6e20 6162 6f75 ot complain abou │ │ │ │ │ +0002fc00: 7420 7375 6368 0a6e 6f6e 7374 616e 6461 t such.nonstanda │ │ │ │ │ +0002fc10: 7264 206e 616d 6573 2069 6620 6974 206b rd names if it k │ │ │ │ │ +0002fc20: 6e6f 7773 2074 6865 206c 6962 7261 7279 nows the library │ │ │ │ │ +0002fc30: 2062 6569 6e67 2062 7569 6c74 2069 7320 being built is │ │ │ │ │ +0002fc40: 6120 6c69 6274 6f6f 6c0a 6d6f 6475 6c65 a libtool.module │ │ │ │ │ +0002fc50: 2c20 692e 652e 2c20 6966 2027 2d6d 6f64 , i.e., if '-mod │ │ │ │ │ +0002fc60: 756c 6527 2065 7870 6c69 6369 746c 7920 ule' explicitly │ │ │ │ │ +0002fc70: 6170 7065 6172 7320 696e 2074 6865 206c appears in the l │ │ │ │ │ +0002fc80: 6962 7261 7279 2773 0a27 5f4c 4446 4c41 ibrary's.'_LDFLA │ │ │ │ │ +0002fc90: 4753 2720 7661 7269 6162 6c65 2028 6f72 GS' variable (or │ │ │ │ │ +0002fca0: 2069 6e20 7468 6520 636f 6d6d 6f6e 2027 in the common ' │ │ │ │ │ +0002fcb0: 414d 5f4c 4446 4c41 4753 2720 7661 7269 AM_LDFLAGS' vari │ │ │ │ │ +0002fcc0: 6162 6c65 2077 6865 6e20 6e6f 0a70 6572 able when no.per │ │ │ │ │ +0002fcd0: 2d6c 6962 7261 7279 2027 5f4c 4446 4c41 -library '_LDFLA │ │ │ │ │ +0002fce0: 4753 2720 7661 7269 6162 6c65 2069 7320 GS' variable is │ │ │ │ │ +0002fcf0: 6465 6669 6e65 6429 2e0a 0a20 2020 4173 defined)... As │ │ │ │ │ +0002fd00: 2061 6c77 6179 732c 2027 4143 5f53 5542 always, 'AC_SUB │ │ │ │ │ +0002fd10: 5354 2720 7661 7269 6162 6c65 7320 6172 ST' variables ar │ │ │ │ │ +0002fd20: 6520 626c 6163 6b20 626f 7865 7320 746f e black boxes to │ │ │ │ │ +0002fd30: 2041 7574 6f6d 616b 6520 7369 6e63 650a Automake since. │ │ │ │ │ +0002fd40: 7468 6569 7220 7661 6c75 6573 2061 7265 their values are │ │ │ │ │ +0002fd50: 206e 6f74 2079 6574 206b 6e6f 776e 2077 not yet known w │ │ │ │ │ +0002fd60: 6865 6e20 2761 7574 6f6d 616b 6527 2069 hen 'automake' i │ │ │ │ │ +0002fd70: 7320 7275 6e2e 2020 5468 6572 6566 6f72 s run. Therefor │ │ │ │ │ +0002fd80: 6520 6966 0a27 2d6d 6f64 756c 6527 2069 e if.'-module' i │ │ │ │ │ +0002fd90: 7320 7365 7420 7669 6120 7375 6368 2061 s set via such a │ │ │ │ │ +0002fda0: 2076 6172 6961 626c 652c 2041 7574 6f6d variable, Autom │ │ │ │ │ +0002fdb0: 616b 6520 6361 6e6e 6f74 206e 6f74 6963 ake cannot notic │ │ │ │ │ +0002fdc0: 6520 6974 2061 6e64 2077 696c 6c0a 7072 e it and will.pr │ │ │ │ │ +0002fdd0: 6f63 6565 6420 6173 2069 6620 7468 6520 oceed as if the │ │ │ │ │ +0002fde0: 6c69 6272 6172 7920 7761 7320 616e 206f library was an o │ │ │ │ │ +0002fdf0: 7264 696e 6172 7920 6c69 6274 6f6f 6c20 rdinary libtool │ │ │ │ │ +0002fe00: 6c69 6272 6172 792c 2077 6974 6820 7374 library, with st │ │ │ │ │ +0002fe10: 7269 6374 0a6e 616d 696e 672e 0a0a 2020 rict.naming... │ │ │ │ │ +0002fe20: 2049 6620 276d 796d 6f64 756c 655f 6c61 If 'mymodule_la │ │ │ │ │ +0002fe30: 5f53 4f55 5243 4553 2720 6973 206e 6f74 _SOURCES' is not │ │ │ │ │ +0002fe40: 2073 7065 6369 6669 6564 2c20 7468 656e specified, then │ │ │ │ │ +0002fe50: 2069 7420 6465 6661 756c 7473 2074 6f20 it defaults to │ │ │ │ │ +0002fe60: 7468 650a 7369 6e67 6c65 2066 696c 6520 the.single file │ │ │ │ │ +0002fe70: 276d 796d 6f64 756c 652e 6327 2028 2a6e 'mymodule.c' (*n │ │ │ │ │ +0002fe80: 6f74 6520 4465 6661 756c 7420 5f53 4f55 ote Default _SOU │ │ │ │ │ +0002fe90: 5243 4553 3a3a 292e 0a0a 1f0a 4669 6c65 RCES::).....File │ │ │ │ │ +0002fea0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +0002feb0: 696e 666f 2c20 204e 6f64 653a 204c 6962 info, Node: Lib │ │ │ │ │ +0002fec0: 746f 6f6c 2046 6c61 6773 2c20 204e 6578 tool Flags, Nex │ │ │ │ │ +0002fed0: 743a 204c 544c 4942 4f42 4a53 2c20 2050 t: LTLIBOBJS, P │ │ │ │ │ +0002fee0: 7265 763a 204c 6962 746f 6f6c 204d 6f64 rev: Libtool Mod │ │ │ │ │ +0002fef0: 756c 6573 2c20 2055 703a 2041 2053 6861 ules, Up: A Sha │ │ │ │ │ +0002ff00: 7265 6420 4c69 6272 6172 790a 0a38 2e33 red Library..8.3 │ │ │ │ │ +0002ff10: 2e37 2027 5f4c 4942 4144 4427 2c20 275f .7 '_LIBADD', '_ │ │ │ │ │ +0002ff20: 4c44 464c 4147 5327 2c20 616e 6420 275f LDFLAGS', and '_ │ │ │ │ │ +0002ff30: 4c49 4254 4f4f 4c46 4c41 4753 270a 2d2d LIBTOOLFLAGS'.-- │ │ │ │ │ 0002ff40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0002ff50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002ff60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4173 ------------..As │ │ │ │ │ -0002ff70: 2073 686f 776e 2069 6e20 7072 6576 696f shown in previo │ │ │ │ │ -0002ff80: 7573 2073 6563 7469 6f6e 732c 2074 6865 us sections, the │ │ │ │ │ -0002ff90: 2027 4c49 4252 4152 595f 4c49 4241 4444 'LIBRARY_LIBADD │ │ │ │ │ -0002ffa0: 2720 7661 7269 6162 6c65 2073 686f 756c ' variable shoul │ │ │ │ │ -0002ffb0: 6420 6265 0a75 7365 6420 746f 206c 6973 d be.used to lis │ │ │ │ │ -0002ffc0: 7420 6578 7472 6120 6c69 6274 6f6f 6c20 t extra libtool │ │ │ │ │ -0002ffd0: 6f62 6a65 6374 7320 2827 2e6c 6f27 2066 objects ('.lo' f │ │ │ │ │ -0002ffe0: 696c 6573 2920 6f72 206c 6962 746f 6f6c iles) or libtool │ │ │ │ │ -0002fff0: 206c 6962 7261 7269 6573 0a28 272e 6c61 libraries.('.la │ │ │ │ │ -00030000: 2729 2074 6f20 6164 6420 746f 204c 4942 ') to add to LIB │ │ │ │ │ -00030010: 5241 5259 2e0a 0a20 2020 5468 6520 274c RARY... The 'L │ │ │ │ │ -00030020: 4942 5241 5259 5f4c 4446 4c41 4753 2720 IBRARY_LDFLAGS' │ │ │ │ │ -00030030: 7661 7269 6162 6c65 2069 7320 7468 6520 variable is the │ │ │ │ │ -00030040: 706c 6163 6520 746f 206c 6973 7420 6164 place to list ad │ │ │ │ │ -00030050: 6469 7469 6f6e 616c 0a6c 6962 746f 6f6c ditional.libtool │ │ │ │ │ -00030060: 206c 696e 6b69 6e67 2066 6c61 6773 2c20 linking flags, │ │ │ │ │ -00030070: 7375 6368 2061 7320 272d 7665 7273 696f such as '-versio │ │ │ │ │ -00030080: 6e2d 696e 666f 272c 2027 2d73 7461 7469 n-info', '-stati │ │ │ │ │ -00030090: 6327 2c20 616e 6420 6120 6c6f 740a 6d6f c', and a lot.mo │ │ │ │ │ -000300a0: 7265 2e20 202a 4e6f 7465 204c 696e 6b20 re. *Note Link │ │ │ │ │ -000300b0: 6d6f 6465 3a20 286c 6962 746f 6f6c 294c mode: (libtool)L │ │ │ │ │ -000300c0: 696e 6b20 6d6f 6465 2e0a 0a20 2020 5468 ink mode... Th │ │ │ │ │ -000300d0: 6520 276c 6962 746f 6f6c 2720 636f 6d6d e 'libtool' comm │ │ │ │ │ -000300e0: 616e 6420 6861 7320 7477 6f20 6b69 6e64 and has two kind │ │ │ │ │ -000300f0: 7320 6f66 206f 7074 696f 6e73 3a20 6d6f s of options: mo │ │ │ │ │ -00030100: 6465 2d73 7065 6369 6669 6320 6f70 7469 de-specific opti │ │ │ │ │ -00030110: 6f6e 730a 616e 6420 6765 6e65 7269 6320 ons.and generic │ │ │ │ │ -00030120: 6f70 7469 6f6e 732e 2020 4d6f 6465 2d73 options. Mode-s │ │ │ │ │ -00030130: 7065 6369 6669 6320 6f70 7469 6f6e 7320 pecific options │ │ │ │ │ -00030140: 7375 6368 2061 7320 7468 6520 6166 6f72 such as the afor │ │ │ │ │ -00030150: 656d 656e 7469 6f6e 6564 0a6c 696e 6b69 ementioned.linki │ │ │ │ │ -00030160: 6e67 2066 6c61 6773 2073 686f 756c 6420 ng flags should │ │ │ │ │ -00030170: 6265 206c 756d 7065 6420 7769 7468 2074 be lumped with t │ │ │ │ │ -00030180: 6865 206f 7468 6572 2066 6c61 6773 2070 he other flags p │ │ │ │ │ -00030190: 6173 7365 6420 746f 2074 6865 2074 6f6f assed to the too │ │ │ │ │ -000301a0: 6c0a 696e 766f 6b65 6420 6279 2027 6c69 l.invoked by 'li │ │ │ │ │ -000301b0: 6274 6f6f 6c27 2028 6865 6e63 6520 7468 btool' (hence th │ │ │ │ │ -000301c0: 6520 7573 6520 6f66 2027 4c49 4252 4152 e use of 'LIBRAR │ │ │ │ │ -000301d0: 595f 4c44 464c 4147 5327 2066 6f72 206c Y_LDFLAGS' for l │ │ │ │ │ -000301e0: 6962 746f 6f6c 0a6c 696e 6b69 6e67 2066 ibtool.linking f │ │ │ │ │ -000301f0: 6c61 6773 292e 2020 4765 6e65 7269 6320 lags). Generic │ │ │ │ │ -00030200: 6f70 7469 6f6e 7320 696e 636c 7564 6520 options include │ │ │ │ │ -00030210: 272d 2d74 6167 3d54 4147 2720 616e 6420 '--tag=TAG' and │ │ │ │ │ -00030220: 272d 2d73 696c 656e 7427 0a28 2a6e 6f74 '--silent'.(*not │ │ │ │ │ -00030230: 6520 496e 766f 6b69 6e67 2027 6c69 6274 e Invoking 'libt │ │ │ │ │ -00030240: 6f6f 6c27 3a20 286c 6962 746f 6f6c 2949 ool': (libtool)I │ │ │ │ │ -00030250: 6e76 6f6b 696e 6720 6c69 6274 6f6f 6c2e nvoking libtool. │ │ │ │ │ -00030260: 2066 6f72 206d 6f72 6520 6f70 7469 6f6e for more option │ │ │ │ │ -00030270: 7329 0a73 686f 756c 6420 6170 7065 6172 s).should appear │ │ │ │ │ -00030280: 2062 6566 6f72 6520 7468 6520 6d6f 6465 before the mode │ │ │ │ │ -00030290: 2073 656c 6563 7469 6f6e 206f 6e20 7468 selection on th │ │ │ │ │ -000302a0: 6520 636f 6d6d 616e 6420 6c69 6e65 3b20 e command line; │ │ │ │ │ -000302b0: 696e 0a27 4d61 6b65 6669 6c65 2e61 6d27 in.'Makefile.am' │ │ │ │ │ -000302c0: 7320 7468 6579 2073 686f 756c 6420 6265 s they should be │ │ │ │ │ -000302d0: 206c 6973 7465 6420 696e 2074 6865 2027 listed in the ' │ │ │ │ │ -000302e0: 4c49 4252 4152 595f 4c49 4254 4f4f 4c46 LIBRARY_LIBTOOLF │ │ │ │ │ -000302f0: 4c41 4753 270a 7661 7269 6162 6c65 2e0a LAGS'.variable.. │ │ │ │ │ -00030300: 0a20 2020 4966 2027 4c49 4252 4152 595f . If 'LIBRARY_ │ │ │ │ │ -00030310: 4c49 4254 4f4f 4c46 4c41 4753 2720 6973 LIBTOOLFLAGS' is │ │ │ │ │ -00030320: 206e 6f74 2064 6566 696e 6564 2c20 7468 not defined, th │ │ │ │ │ -00030330: 656e 2074 6865 2076 6172 6961 626c 650a en the variable. │ │ │ │ │ -00030340: 2741 4d5f 4c49 4254 4f4f 4c46 4c41 4753 'AM_LIBTOOLFLAGS │ │ │ │ │ -00030350: 2720 6973 2075 7365 6420 696e 7374 6561 ' is used instea │ │ │ │ │ -00030360: 642e 0a0a 2020 2054 6865 7365 2066 6c61 d... These fla │ │ │ │ │ -00030370: 6773 2061 7265 2070 6173 7365 6420 746f gs are passed to │ │ │ │ │ -00030380: 206c 6962 746f 6f6c 2061 6674 6572 2074 libtool after t │ │ │ │ │ -00030390: 6865 2027 2d2d 7461 673d 5441 4727 206f he '--tag=TAG' o │ │ │ │ │ -000303a0: 7074 696f 6e0a 636f 6d70 7574 6564 2062 ption.computed b │ │ │ │ │ -000303b0: 7920 4175 746f 6d61 6b65 2028 6966 2061 y Automake (if a │ │ │ │ │ -000303c0: 6e79 292c 2073 6f20 274c 4942 5241 5259 ny), so 'LIBRARY │ │ │ │ │ -000303d0: 5f4c 4942 544f 4f4c 464c 4147 5327 2028 _LIBTOOLFLAGS' ( │ │ │ │ │ -000303e0: 6f72 0a27 414d 5f4c 4942 544f 4f4c 464c or.'AM_LIBTOOLFL │ │ │ │ │ -000303f0: 4147 5327 2920 6973 2061 2067 6f6f 6420 AGS') is a good │ │ │ │ │ -00030400: 706c 6163 6520 746f 206f 7665 7272 6964 place to overrid │ │ │ │ │ -00030410: 6520 6f72 2073 7570 706c 656d 656e 7420 e or supplement │ │ │ │ │ -00030420: 7468 650a 272d 2d74 6167 3d54 4147 2720 the.'--tag=TAG' │ │ │ │ │ -00030430: 7365 7474 696e 672e 0a0a 2020 2054 6865 setting... The │ │ │ │ │ -00030440: 206c 6962 746f 6f6c 2072 756c 6573 2061 libtool rules a │ │ │ │ │ -00030450: 6c73 6f20 7573 6520 6120 274c 4942 544f lso use a 'LIBTO │ │ │ │ │ -00030460: 4f4c 464c 4147 5327 2076 6172 6961 626c OLFLAGS' variabl │ │ │ │ │ -00030470: 6520 7468 6174 2073 686f 756c 6420 6e6f e that should no │ │ │ │ │ -00030480: 740a 6265 2073 6574 2069 6e20 274d 616b t.be set in 'Mak │ │ │ │ │ -00030490: 6566 696c 652e 616d 273a 2074 6869 7320 efile.am': this │ │ │ │ │ -000304a0: 6973 2061 2075 7365 7220 7661 7269 6162 is a user variab │ │ │ │ │ -000304b0: 6c65 2028 2a6e 6f74 6520 466c 6167 2056 le (*note Flag V │ │ │ │ │ -000304c0: 6172 6961 626c 6573 0a4f 7264 6572 696e ariables.Orderin │ │ │ │ │ -000304d0: 673a 3a2e 2020 4974 2061 6c6c 6f77 7320 g::. It allows │ │ │ │ │ -000304e0: 7573 6572 7320 746f 2072 756e 2027 6d61 users to run 'ma │ │ │ │ │ -000304f0: 6b65 204c 4942 544f 4f4c 464c 4147 533d ke LIBTOOLFLAGS= │ │ │ │ │ -00030500: 2d2d 7369 6c65 6e74 272c 2066 6f72 0a69 --silent', for.i │ │ │ │ │ -00030510: 6e73 7461 6e63 652e 2020 4e6f 7465 2074 nstance. Note t │ │ │ │ │ -00030520: 6861 7420 7468 6520 7665 7262 6f73 6974 hat the verbosit │ │ │ │ │ -00030530: 7920 6f66 2027 6c69 6274 6f6f 6c27 2063 y of 'libtool' c │ │ │ │ │ -00030540: 616e 2061 6c73 6f20 6265 2069 6e66 6c75 an also be influ │ │ │ │ │ -00030550: 656e 6365 640a 7769 7468 2074 6865 2041 enced.with the A │ │ │ │ │ -00030560: 7574 6f6d 616b 6520 2773 696c 656e 742d utomake 'silent- │ │ │ │ │ -00030570: 7275 6c65 7327 206f 7074 696f 6e20 282a rules' option (* │ │ │ │ │ -00030580: 6e6f 7465 204f 7074 696f 6e73 3a3a 292e note Options::). │ │ │ │ │ -00030590: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -000305a0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -000305b0: 6f64 653a 204c 544c 4942 4f42 4a53 2c20 ode: LTLIBOBJS, │ │ │ │ │ -000305c0: 204e 6578 743a 204c 6962 746f 6f6c 2049 Next: Libtool I │ │ │ │ │ -000305d0: 7373 7565 732c 2020 5072 6576 3a20 4c69 ssues, Prev: Li │ │ │ │ │ -000305e0: 6274 6f6f 6c20 466c 6167 732c 2020 5570 btool Flags, Up │ │ │ │ │ -000305f0: 3a20 4120 5368 6172 6564 204c 6962 7261 : A Shared Libra │ │ │ │ │ -00030600: 7279 0a0a 382e 332e 3820 274c 544c 4942 ry..8.3.8 'LTLIB │ │ │ │ │ -00030610: 4f42 4a53 2720 616e 6420 274c 5441 4c4c OBJS' and 'LTALL │ │ │ │ │ -00030620: 4f43 4127 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d OCA'.----------- │ │ │ │ │ +0002ff60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0002ff70: 4173 2073 686f 776e 2069 6e20 7072 6576 As shown in prev │ │ │ │ │ +0002ff80: 696f 7573 2073 6563 7469 6f6e 732c 2074 ious sections, t │ │ │ │ │ +0002ff90: 6865 2027 4c49 4252 4152 595f 4c49 4241 he 'LIBRARY_LIBA │ │ │ │ │ +0002ffa0: 4444 2720 7661 7269 6162 6c65 2073 686f DD' variable sho │ │ │ │ │ +0002ffb0: 756c 6420 6265 0a75 7365 6420 746f 206c uld be.used to l │ │ │ │ │ +0002ffc0: 6973 7420 6578 7472 6120 6c69 6274 6f6f ist extra libtoo │ │ │ │ │ +0002ffd0: 6c20 6f62 6a65 6374 7320 2827 2e6c 6f27 l objects ('.lo' │ │ │ │ │ +0002ffe0: 2066 696c 6573 2920 6f72 206c 6962 746f files) or libto │ │ │ │ │ +0002fff0: 6f6c 206c 6962 7261 7269 6573 0a28 272e ol libraries.('. │ │ │ │ │ +00030000: 6c61 2729 2074 6f20 6164 6420 746f 204c la') to add to L │ │ │ │ │ +00030010: 4942 5241 5259 2e0a 0a20 2020 5468 6520 IBRARY... The │ │ │ │ │ +00030020: 274c 4942 5241 5259 5f4c 4446 4c41 4753 'LIBRARY_LDFLAGS │ │ │ │ │ +00030030: 2720 7661 7269 6162 6c65 2069 7320 7468 ' variable is th │ │ │ │ │ +00030040: 6520 706c 6163 6520 746f 206c 6973 7420 e place to list │ │ │ │ │ +00030050: 6164 6469 7469 6f6e 616c 0a6c 6962 746f additional.libto │ │ │ │ │ +00030060: 6f6c 206c 696e 6b69 6e67 2066 6c61 6773 ol linking flags │ │ │ │ │ +00030070: 2c20 7375 6368 2061 7320 272d 7665 7273 , such as '-vers │ │ │ │ │ +00030080: 696f 6e2d 696e 666f 272c 2027 2d73 7461 ion-info', '-sta │ │ │ │ │ +00030090: 7469 6327 2c20 616e 6420 6120 6c6f 740a tic', and a lot. │ │ │ │ │ +000300a0: 6d6f 7265 2e20 202a 4e6f 7465 204c 696e more. *Note Lin │ │ │ │ │ +000300b0: 6b20 6d6f 6465 3a20 286c 6962 746f 6f6c k mode: (libtool │ │ │ │ │ +000300c0: 294c 696e 6b20 6d6f 6465 2e0a 0a20 2020 )Link mode... │ │ │ │ │ +000300d0: 5468 6520 276c 6962 746f 6f6c 2720 636f The 'libtool' co │ │ │ │ │ +000300e0: 6d6d 616e 6420 6861 7320 7477 6f20 6b69 mmand has two ki │ │ │ │ │ +000300f0: 6e64 7320 6f66 206f 7074 696f 6e73 3a20 nds of options: │ │ │ │ │ +00030100: 6d6f 6465 2d73 7065 6369 6669 6320 6f70 mode-specific op │ │ │ │ │ +00030110: 7469 6f6e 730a 616e 6420 6765 6e65 7269 tions.and generi │ │ │ │ │ +00030120: 6320 6f70 7469 6f6e 732e 2020 4d6f 6465 c options. Mode │ │ │ │ │ +00030130: 2d73 7065 6369 6669 6320 6f70 7469 6f6e -specific option │ │ │ │ │ +00030140: 7320 7375 6368 2061 7320 7468 6520 6166 s such as the af │ │ │ │ │ +00030150: 6f72 656d 656e 7469 6f6e 6564 0a6c 696e orementioned.lin │ │ │ │ │ +00030160: 6b69 6e67 2066 6c61 6773 2073 686f 756c king flags shoul │ │ │ │ │ +00030170: 6420 6265 206c 756d 7065 6420 7769 7468 d be lumped with │ │ │ │ │ +00030180: 2074 6865 206f 7468 6572 2066 6c61 6773 the other flags │ │ │ │ │ +00030190: 2070 6173 7365 6420 746f 2074 6865 2074 passed to the t │ │ │ │ │ +000301a0: 6f6f 6c0a 696e 766f 6b65 6420 6279 2027 ool.invoked by ' │ │ │ │ │ +000301b0: 6c69 6274 6f6f 6c27 2028 6865 6e63 6520 libtool' (hence │ │ │ │ │ +000301c0: 7468 6520 7573 6520 6f66 2027 4c49 4252 the use of 'LIBR │ │ │ │ │ +000301d0: 4152 595f 4c44 464c 4147 5327 2066 6f72 ARY_LDFLAGS' for │ │ │ │ │ +000301e0: 206c 6962 746f 6f6c 0a6c 696e 6b69 6e67 libtool.linking │ │ │ │ │ +000301f0: 2066 6c61 6773 292e 2020 4765 6e65 7269 flags). Generi │ │ │ │ │ +00030200: 6320 6f70 7469 6f6e 7320 696e 636c 7564 c options includ │ │ │ │ │ +00030210: 6520 272d 2d74 6167 3d54 4147 2720 616e e '--tag=TAG' an │ │ │ │ │ +00030220: 6420 272d 2d73 696c 656e 7427 0a28 2a6e d '--silent'.(*n │ │ │ │ │ +00030230: 6f74 6520 496e 766f 6b69 6e67 2027 6c69 ote Invoking 'li │ │ │ │ │ +00030240: 6274 6f6f 6c27 3a20 286c 6962 746f 6f6c btool': (libtool │ │ │ │ │ +00030250: 2949 6e76 6f6b 696e 6720 6c69 6274 6f6f )Invoking libtoo │ │ │ │ │ +00030260: 6c2e 2066 6f72 206d 6f72 6520 6f70 7469 l. for more opti │ │ │ │ │ +00030270: 6f6e 7329 0a73 686f 756c 6420 6170 7065 ons).should appe │ │ │ │ │ +00030280: 6172 2062 6566 6f72 6520 7468 6520 6d6f ar before the mo │ │ │ │ │ +00030290: 6465 2073 656c 6563 7469 6f6e 206f 6e20 de selection on │ │ │ │ │ +000302a0: 7468 6520 636f 6d6d 616e 6420 6c69 6e65 the command line │ │ │ │ │ +000302b0: 3b20 696e 0a27 4d61 6b65 6669 6c65 2e61 ; in.'Makefile.a │ │ │ │ │ +000302c0: 6d27 7320 7468 6579 2073 686f 756c 6420 m's they should │ │ │ │ │ +000302d0: 6265 206c 6973 7465 6420 696e 2074 6865 be listed in the │ │ │ │ │ +000302e0: 2027 4c49 4252 4152 595f 4c49 4254 4f4f 'LIBRARY_LIBTOO │ │ │ │ │ +000302f0: 4c46 4c41 4753 270a 7661 7269 6162 6c65 LFLAGS'.variable │ │ │ │ │ +00030300: 2e0a 0a20 2020 4966 2027 4c49 4252 4152 ... If 'LIBRAR │ │ │ │ │ +00030310: 595f 4c49 4254 4f4f 4c46 4c41 4753 2720 Y_LIBTOOLFLAGS' │ │ │ │ │ +00030320: 6973 206e 6f74 2064 6566 696e 6564 2c20 is not defined, │ │ │ │ │ +00030330: 7468 656e 2074 6865 2076 6172 6961 626c then the variabl │ │ │ │ │ +00030340: 650a 2741 4d5f 4c49 4254 4f4f 4c46 4c41 e.'AM_LIBTOOLFLA │ │ │ │ │ +00030350: 4753 2720 6973 2075 7365 6420 696e 7374 GS' is used inst │ │ │ │ │ +00030360: 6561 642e 0a0a 2020 2054 6865 7365 2066 ead... These f │ │ │ │ │ +00030370: 6c61 6773 2061 7265 2070 6173 7365 6420 lags are passed │ │ │ │ │ +00030380: 746f 206c 6962 746f 6f6c 2061 6674 6572 to libtool after │ │ │ │ │ +00030390: 2074 6865 2027 2d2d 7461 673d 5441 4727 the '--tag=TAG' │ │ │ │ │ +000303a0: 206f 7074 696f 6e0a 636f 6d70 7574 6564 option.computed │ │ │ │ │ +000303b0: 2062 7920 4175 746f 6d61 6b65 2028 6966 by Automake (if │ │ │ │ │ +000303c0: 2061 6e79 292c 2073 6f20 274c 4942 5241 any), so 'LIBRA │ │ │ │ │ +000303d0: 5259 5f4c 4942 544f 4f4c 464c 4147 5327 RY_LIBTOOLFLAGS' │ │ │ │ │ +000303e0: 2028 6f72 0a27 414d 5f4c 4942 544f 4f4c (or.'AM_LIBTOOL │ │ │ │ │ +000303f0: 464c 4147 5327 2920 6973 2061 2067 6f6f FLAGS') is a goo │ │ │ │ │ +00030400: 6420 706c 6163 6520 746f 206f 7665 7272 d place to overr │ │ │ │ │ +00030410: 6964 6520 6f72 2073 7570 706c 656d 656e ide or supplemen │ │ │ │ │ +00030420: 7420 7468 650a 272d 2d74 6167 3d54 4147 t the.'--tag=TAG │ │ │ │ │ +00030430: 2720 7365 7474 696e 672e 0a0a 2020 2054 ' setting... T │ │ │ │ │ +00030440: 6865 206c 6962 746f 6f6c 2072 756c 6573 he libtool rules │ │ │ │ │ +00030450: 2061 6c73 6f20 7573 6520 6120 274c 4942 also use a 'LIB │ │ │ │ │ +00030460: 544f 4f4c 464c 4147 5327 2076 6172 6961 TOOLFLAGS' varia │ │ │ │ │ +00030470: 626c 6520 7468 6174 2073 686f 756c 6420 ble that should │ │ │ │ │ +00030480: 6e6f 740a 6265 2073 6574 2069 6e20 274d not.be set in 'M │ │ │ │ │ +00030490: 616b 6566 696c 652e 616d 273a 2074 6869 akefile.am': thi │ │ │ │ │ +000304a0: 7320 6973 2061 2075 7365 7220 7661 7269 s is a user vari │ │ │ │ │ +000304b0: 6162 6c65 2028 2a6e 6f74 6520 466c 6167 able (*note Flag │ │ │ │ │ +000304c0: 2056 6172 6961 626c 6573 0a4f 7264 6572 Variables.Order │ │ │ │ │ +000304d0: 696e 673a 3a2e 2020 4974 2061 6c6c 6f77 ing::. It allow │ │ │ │ │ +000304e0: 7320 7573 6572 7320 746f 2072 756e 2027 s users to run ' │ │ │ │ │ +000304f0: 6d61 6b65 204c 4942 544f 4f4c 464c 4147 make LIBTOOLFLAG │ │ │ │ │ +00030500: 533d 2d2d 7369 6c65 6e74 272c 2066 6f72 S=--silent', for │ │ │ │ │ +00030510: 0a69 6e73 7461 6e63 652e 2020 4e6f 7465 .instance. Note │ │ │ │ │ +00030520: 2074 6861 7420 7468 6520 7665 7262 6f73 that the verbos │ │ │ │ │ +00030530: 6974 7920 6f66 2027 6c69 6274 6f6f 6c27 ity of 'libtool' │ │ │ │ │ +00030540: 2063 616e 2061 6c73 6f20 6265 2069 6e66 can also be inf │ │ │ │ │ +00030550: 6c75 656e 6365 640a 7769 7468 2074 6865 luenced.with the │ │ │ │ │ +00030560: 2041 7574 6f6d 616b 6520 2773 696c 656e Automake 'silen │ │ │ │ │ +00030570: 742d 7275 6c65 7327 206f 7074 696f 6e20 t-rules' option │ │ │ │ │ +00030580: 282a 6e6f 7465 204f 7074 696f 6e73 3a3a (*note Options:: │ │ │ │ │ +00030590: 292e 0a0a 1f0a 4669 6c65 3a20 6175 746f ).....File: auto │ │ │ │ │ +000305a0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +000305b0: 204e 6f64 653a 204c 544c 4942 4f42 4a53 Node: LTLIBOBJS │ │ │ │ │ +000305c0: 2c20 204e 6578 743a 204c 6962 746f 6f6c , Next: Libtool │ │ │ │ │ +000305d0: 2049 7373 7565 732c 2020 5072 6576 3a20 Issues, Prev: │ │ │ │ │ +000305e0: 4c69 6274 6f6f 6c20 466c 6167 732c 2020 Libtool Flags, │ │ │ │ │ +000305f0: 5570 3a20 4120 5368 6172 6564 204c 6962 Up: A Shared Lib │ │ │ │ │ +00030600: 7261 7279 0a0a 382e 332e 3820 274c 544c rary..8.3.8 'LTL │ │ │ │ │ +00030610: 4942 4f42 4a53 2720 616e 6420 274c 5441 IBOBJS' and 'LTA │ │ │ │ │ +00030620: 4c4c 4f43 4127 0a2d 2d2d 2d2d 2d2d 2d2d LLOCA'.--------- │ │ │ │ │ 00030630: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00030640: 2d2d 2d2d 2d0a 0a57 6865 7265 2061 6e20 -----..Where an │ │ │ │ │ -00030650: 6f72 6469 6e61 7279 206c 6962 7261 7279 ordinary library │ │ │ │ │ -00030660: 206d 6967 6874 2069 6e63 6c75 6465 2027 might include ' │ │ │ │ │ -00030670: 2428 4c49 424f 424a 5329 2720 6f72 2027 $(LIBOBJS)' or ' │ │ │ │ │ -00030680: 2428 414c 4c4f 4341 2927 0a28 2a6e 6f74 $(ALLOCA)'.(*not │ │ │ │ │ -00030690: 6520 4c49 424f 424a 533a 3a29 2c20 6120 e LIBOBJS::), a │ │ │ │ │ -000306a0: 6c69 6274 6f6f 6c20 6c69 6272 6172 7920 libtool library │ │ │ │ │ -000306b0: 6d75 7374 2075 7365 2027 2428 4c54 4c49 must use '$(LTLI │ │ │ │ │ -000306c0: 424f 424a 5329 2720 6f72 0a27 2428 4c54 BOBJS)' or.'$(LT │ │ │ │ │ -000306d0: 414c 4c4f 4341 2927 2e20 2054 6869 7320 ALLOCA)'. This │ │ │ │ │ -000306e0: 6973 2072 6571 7569 7265 6420 6265 6361 is required beca │ │ │ │ │ -000306f0: 7573 6520 7468 6520 6f62 6a65 6374 2066 use the object f │ │ │ │ │ -00030700: 696c 6573 2074 6861 7420 6c69 6274 6f6f iles that libtoo │ │ │ │ │ -00030710: 6c0a 6f70 6572 6174 6573 206f 6e20 646f l.operates on do │ │ │ │ │ -00030720: 206e 6f74 206e 6563 6573 7361 7269 6c79 not necessarily │ │ │ │ │ -00030730: 2065 6e64 2069 6e20 272e 6f27 2e0a 0a20 end in '.o'... │ │ │ │ │ -00030740: 2020 4e6f 7761 6461 7973 2c20 7468 6520 Nowadays, the │ │ │ │ │ -00030750: 636f 6d70 7574 6174 696f 6e20 6f66 2027 computation of ' │ │ │ │ │ -00030760: 4c54 4c49 424f 424a 5327 2066 726f 6d20 LTLIBOBJS' from │ │ │ │ │ -00030770: 274c 4942 4f42 4a53 2720 6973 2070 6572 'LIBOBJS' is per │ │ │ │ │ -00030780: 666f 726d 6564 0a61 7574 6f6d 6174 6963 formed.automatic │ │ │ │ │ -00030790: 616c 6c79 2062 7920 4175 746f 636f 6e66 ally by Autoconf │ │ │ │ │ -000307a0: 2028 2a6e 6f74 6520 2741 435f 4c49 424f (*note 'AC_LIBO │ │ │ │ │ -000307b0: 424a 2720 7673 2e20 274c 4942 4f42 4a53 BJ' vs. 'LIBOBJS │ │ │ │ │ -000307c0: 273a 0a28 6175 746f 636f 6e66 2941 435f ':.(autoconf)AC_ │ │ │ │ │ -000307d0: 4c49 424f 424a 2076 7320 4c49 424f 424a LIBOBJ vs LIBOBJ │ │ │ │ │ -000307e0: 532e 292e 0a0a 1f0a 4669 6c65 3a20 6175 S.).....File: au │ │ │ │ │ -000307f0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -00030800: 2c20 204e 6f64 653a 204c 6962 746f 6f6c , Node: Libtool │ │ │ │ │ -00030810: 2049 7373 7565 732c 2020 5072 6576 3a20 Issues, Prev: │ │ │ │ │ -00030820: 4c54 4c49 424f 424a 532c 2020 5570 3a20 LTLIBOBJS, Up: │ │ │ │ │ -00030830: 4120 5368 6172 6564 204c 6962 7261 7279 A Shared Library │ │ │ │ │ -00030840: 0a0a 382e 332e 3920 436f 6d6d 6f6e 2049 ..8.3.9 Common I │ │ │ │ │ -00030850: 7373 7565 7320 5265 6c61 7465 6420 746f ssues Related to │ │ │ │ │ -00030860: 204c 6962 746f 6f6c 2773 2055 7365 0a2d Libtool's Use.- │ │ │ │ │ -00030870: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00030640: 2d2d 2d2d 2d2d 2d0a 0a57 6865 7265 2061 -------..Where a │ │ │ │ │ +00030650: 6e20 6f72 6469 6e61 7279 206c 6962 7261 n ordinary libra │ │ │ │ │ +00030660: 7279 206d 6967 6874 2069 6e63 6c75 6465 ry might include │ │ │ │ │ +00030670: 2027 2428 4c49 424f 424a 5329 2720 6f72 '$(LIBOBJS)' or │ │ │ │ │ +00030680: 2027 2428 414c 4c4f 4341 2927 0a28 2a6e '$(ALLOCA)'.(*n │ │ │ │ │ +00030690: 6f74 6520 4c49 424f 424a 533a 3a29 2c20 ote LIBOBJS::), │ │ │ │ │ +000306a0: 6120 6c69 6274 6f6f 6c20 6c69 6272 6172 a libtool librar │ │ │ │ │ +000306b0: 7920 6d75 7374 2075 7365 2027 2428 4c54 y must use '$(LT │ │ │ │ │ +000306c0: 4c49 424f 424a 5329 2720 6f72 0a27 2428 LIBOBJS)' or.'$( │ │ │ │ │ +000306d0: 4c54 414c 4c4f 4341 2927 2e20 2054 6869 LTALLOCA)'. Thi │ │ │ │ │ +000306e0: 7320 6973 2072 6571 7569 7265 6420 6265 s is required be │ │ │ │ │ +000306f0: 6361 7573 6520 7468 6520 6f62 6a65 6374 cause the object │ │ │ │ │ +00030700: 2066 696c 6573 2074 6861 7420 6c69 6274 files that libt │ │ │ │ │ +00030710: 6f6f 6c0a 6f70 6572 6174 6573 206f 6e20 ool.operates on │ │ │ │ │ +00030720: 646f 206e 6f74 206e 6563 6573 7361 7269 do not necessari │ │ │ │ │ +00030730: 6c79 2065 6e64 2069 6e20 272e 6f27 2e0a ly end in '.o'.. │ │ │ │ │ +00030740: 0a20 2020 4e6f 7761 6461 7973 2c20 7468 . Nowadays, th │ │ │ │ │ +00030750: 6520 636f 6d70 7574 6174 696f 6e20 6f66 e computation of │ │ │ │ │ +00030760: 2027 4c54 4c49 424f 424a 5327 2066 726f 'LTLIBOBJS' fro │ │ │ │ │ +00030770: 6d20 274c 4942 4f42 4a53 2720 6973 2070 m 'LIBOBJS' is p │ │ │ │ │ +00030780: 6572 666f 726d 6564 0a61 7574 6f6d 6174 erformed.automat │ │ │ │ │ +00030790: 6963 616c 6c79 2062 7920 4175 746f 636f ically by Autoco │ │ │ │ │ +000307a0: 6e66 2028 2a6e 6f74 6520 2741 435f 4c49 nf (*note 'AC_LI │ │ │ │ │ +000307b0: 424f 424a 2720 7673 2e20 274c 4942 4f42 BOBJ' vs. 'LIBOB │ │ │ │ │ +000307c0: 4a53 273a 0a28 6175 746f 636f 6e66 2941 JS':.(autoconf)A │ │ │ │ │ +000307d0: 435f 4c49 424f 424a 2076 7320 4c49 424f C_LIBOBJ vs LIBO │ │ │ │ │ +000307e0: 424a 532e 292e 0a0a 1f0a 4669 6c65 3a20 BJS.).....File: │ │ │ │ │ +000307f0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +00030800: 666f 2c20 204e 6f64 653a 204c 6962 746f fo, Node: Libto │ │ │ │ │ +00030810: 6f6c 2049 7373 7565 732c 2020 5072 6576 ol Issues, Prev │ │ │ │ │ +00030820: 3a20 4c54 4c49 424f 424a 532c 2020 5570 : LTLIBOBJS, Up │ │ │ │ │ +00030830: 3a20 4120 5368 6172 6564 204c 6962 7261 : A Shared Libra │ │ │ │ │ +00030840: 7279 0a0a 382e 332e 3920 436f 6d6d 6f6e ry..8.3.9 Common │ │ │ │ │ +00030850: 2049 7373 7565 7320 5265 6c61 7465 6420 Issues Related │ │ │ │ │ +00030860: 746f 204c 6962 746f 6f6c 2773 2055 7365 to Libtool's Use │ │ │ │ │ +00030870: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ 00030880: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00030890: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 204d -----------..* M │ │ │ │ │ -000308a0: 656e 753a 0a0a 2a20 4572 726f 7220 7265 enu:..* Error re │ │ │ │ │ -000308b0: 7175 6972 6564 2066 696c 6520 6c74 6d61 quired file ltma │ │ │ │ │ -000308c0: 696e 2e73 6820 6e6f 7420 666f 756e 643a in.sh not found: │ │ │ │ │ -000308d0: 3a20 2054 6865 206e 6565 6420 746f 2072 : The need to r │ │ │ │ │ -000308e0: 756e 206c 6962 746f 6f6c 697a 650a 2a20 un libtoolize.* │ │ │ │ │ -000308f0: 4f62 6a65 6374 7320 6372 6561 7465 6420 Objects created │ │ │ │ │ -00030900: 626f 7468 2077 6974 6820 6c69 6274 6f6f both with libtoo │ │ │ │ │ -00030910: 6c20 616e 6420 7769 7468 6f75 743a 3a20 l and without:: │ │ │ │ │ -00030920: 2041 766f 6964 2061 2073 7065 6369 6669 Avoid a specifi │ │ │ │ │ -00030930: 6320 6275 696c 6420 7261 6365 0a0a 1f0a c build race.... │ │ │ │ │ -00030940: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ -00030950: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ -00030960: 2045 7272 6f72 2072 6571 7569 7265 6420 Error required │ │ │ │ │ -00030970: 6669 6c65 206c 746d 6169 6e2e 7368 206e file ltmain.sh n │ │ │ │ │ -00030980: 6f74 2066 6f75 6e64 2c20 204e 6578 743a ot found, Next: │ │ │ │ │ -00030990: 204f 626a 6563 7473 2063 7265 6174 6564 Objects created │ │ │ │ │ -000309a0: 2062 6f74 6820 7769 7468 206c 6962 746f both with libto │ │ │ │ │ -000309b0: 6f6c 2061 6e64 2077 6974 686f 7574 2c20 ol and without, │ │ │ │ │ -000309c0: 2055 703a 204c 6962 746f 6f6c 2049 7373 Up: Libtool Iss │ │ │ │ │ -000309d0: 7565 730a 0a38 2e33 2e39 2e31 2045 7272 ues..8.3.9.1 Err │ │ │ │ │ -000309e0: 6f72 3a20 2772 6571 7569 7265 6420 6669 or: 'required fi │ │ │ │ │ -000309f0: 6c65 2060 2e2f 6c74 6d61 696e 2e73 6827 le `./ltmain.sh' │ │ │ │ │ -00030a00: 206e 6f74 2066 6f75 6e64 270a 2e2e 2e2e not found'..... │ │ │ │ │ +00030890: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a -------------..* │ │ │ │ │ +000308a0: 204d 656e 753a 0a0a 2a20 4572 726f 7220 Menu:..* Error │ │ │ │ │ +000308b0: 7265 7175 6972 6564 2066 696c 6520 6c74 required file lt │ │ │ │ │ +000308c0: 6d61 696e 2e73 6820 6e6f 7420 666f 756e main.sh not foun │ │ │ │ │ +000308d0: 643a 3a20 2054 6865 206e 6565 6420 746f d:: The need to │ │ │ │ │ +000308e0: 2072 756e 206c 6962 746f 6f6c 697a 650a run libtoolize. │ │ │ │ │ +000308f0: 2a20 4f62 6a65 6374 7320 6372 6561 7465 * Objects create │ │ │ │ │ +00030900: 6420 626f 7468 2077 6974 6820 6c69 6274 d both with libt │ │ │ │ │ +00030910: 6f6f 6c20 616e 6420 7769 7468 6f75 743a ool and without: │ │ │ │ │ +00030920: 3a20 2041 766f 6964 2061 2073 7065 6369 : Avoid a speci │ │ │ │ │ +00030930: 6669 6320 6275 696c 6420 7261 6365 0a0a fic build race.. │ │ │ │ │ +00030940: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +00030950: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +00030960: 653a 2045 7272 6f72 2072 6571 7569 7265 e: Error require │ │ │ │ │ +00030970: 6420 6669 6c65 206c 746d 6169 6e2e 7368 d file ltmain.sh │ │ │ │ │ +00030980: 206e 6f74 2066 6f75 6e64 2c20 204e 6578 not found, Nex │ │ │ │ │ +00030990: 743a 204f 626a 6563 7473 2063 7265 6174 t: Objects creat │ │ │ │ │ +000309a0: 6564 2062 6f74 6820 7769 7468 206c 6962 ed both with lib │ │ │ │ │ +000309b0: 746f 6f6c 2061 6e64 2077 6974 686f 7574 tool and without │ │ │ │ │ +000309c0: 2c20 2055 703a 204c 6962 746f 6f6c 2049 , Up: Libtool I │ │ │ │ │ +000309d0: 7373 7565 730a 0a38 2e33 2e39 2e31 2045 ssues..8.3.9.1 E │ │ │ │ │ +000309e0: 7272 6f72 3a20 2772 6571 7569 7265 6420 rror: 'required │ │ │ │ │ +000309f0: 6669 6c65 2060 2e2f 6c74 6d61 696e 2e73 file `./ltmain.s │ │ │ │ │ +00030a00: 6827 206e 6f74 2066 6f75 6e64 270a 2e2e h' not found'... │ │ │ │ │ 00030a10: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 00030a20: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 00030a30: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -00030a40: 2e2e 0a0a 4c69 6274 6f6f 6c20 636f 6d65 ....Libtool come │ │ │ │ │ -00030a50: 7320 7769 7468 2061 2074 6f6f 6c20 6361 s with a tool ca │ │ │ │ │ -00030a60: 6c6c 6564 2027 6c69 6274 6f6f 6c69 7a65 lled 'libtoolize │ │ │ │ │ -00030a70: 2720 7468 6174 2077 696c 6c20 696e 7374 ' that will inst │ │ │ │ │ -00030a80: 616c 6c0a 6c69 6274 6f6f 6c27 7320 7375 all.libtool's su │ │ │ │ │ -00030a90: 7070 6f72 7469 6e67 2066 696c 6573 2069 pporting files i │ │ │ │ │ -00030aa0: 6e74 6f20 6120 7061 636b 6167 652e 2020 nto a package. │ │ │ │ │ -00030ab0: 5275 6e6e 696e 6720 7468 6973 2063 6f6d Running this com │ │ │ │ │ -00030ac0: 6d61 6e64 2077 696c 6c0a 696e 7374 616c mand will.instal │ │ │ │ │ -00030ad0: 6c20 276c 746d 6169 6e2e 7368 272e 2020 l 'ltmain.sh'. │ │ │ │ │ -00030ae0: 596f 7520 7368 6f75 6c64 2065 7865 6375 You should execu │ │ │ │ │ -00030af0: 7465 2069 7420 6265 666f 7265 2027 6163 te it before 'ac │ │ │ │ │ -00030b00: 6c6f 6361 6c27 2061 6e64 0a27 6175 746f local' and.'auto │ │ │ │ │ -00030b10: 6d61 6b65 272e 0a0a 2020 2050 656f 706c make'... Peopl │ │ │ │ │ -00030b20: 6520 7570 6772 6164 696e 6720 6f6c 6420 e upgrading old │ │ │ │ │ -00030b30: 7061 636b 6167 6573 2074 6f20 6e65 7765 packages to newe │ │ │ │ │ -00030b40: 7220 6175 746f 746f 6f6c 7320 6172 6520 r autotools are │ │ │ │ │ -00030b50: 6c69 6b65 6c79 2074 6f20 6661 6365 0a74 likely to face.t │ │ │ │ │ -00030b60: 6869 7320 6973 7375 6520 6265 6361 7573 his issue becaus │ │ │ │ │ -00030b70: 6520 6f6c 6465 7220 4175 746f 6d61 6b65 e older Automake │ │ │ │ │ -00030b80: 2076 6572 7369 6f6e 7320 7573 6564 2074 versions used t │ │ │ │ │ -00030b90: 6f20 6361 6c6c 2027 6c69 6274 6f6f 6c69 o call 'libtooli │ │ │ │ │ -00030ba0: 7a65 272e 0a54 6865 7265 666f 7265 206f ze'..Therefore o │ │ │ │ │ -00030bb0: 6c64 2062 7569 6c64 2073 6372 6970 7473 ld build scripts │ │ │ │ │ -00030bc0: 2064 6f20 6e6f 7420 6361 6c6c 2027 6c69 do not call 'li │ │ │ │ │ -00030bd0: 6274 6f6f 6c69 7a65 272e 0a0a 2020 2053 btoolize'... S │ │ │ │ │ -00030be0: 696e 6365 2041 7574 6f6d 616b 6520 312e ince Automake 1. │ │ │ │ │ -00030bf0: 362c 2069 7420 6861 7320 6265 656e 2064 6, it has been d │ │ │ │ │ -00030c00: 6563 6964 6564 2074 6861 7420 7275 6e6e ecided that runn │ │ │ │ │ -00030c10: 696e 6720 276c 6962 746f 6f6c 697a 6527 ing 'libtoolize' │ │ │ │ │ -00030c20: 2077 6173 0a6e 6f6e 6520 6f66 2041 7574 was.none of Aut │ │ │ │ │ -00030c30: 6f6d 616b 6527 7320 6275 7369 6e65 7373 omake's business │ │ │ │ │ -00030c40: 2e20 2049 6e73 7465 6164 2c20 7468 6174 . Instead, that │ │ │ │ │ -00030c50: 2066 756e 6374 696f 6e61 6c69 7479 2068 functionality h │ │ │ │ │ -00030c60: 6173 2062 6565 6e20 6d6f 7665 640a 696e as been moved.in │ │ │ │ │ -00030c70: 746f 2074 6865 2027 6175 746f 7265 636f to the 'autoreco │ │ │ │ │ -00030c80: 6e66 2720 636f 6d6d 616e 6420 282a 6e6f nf' command (*no │ │ │ │ │ -00030c90: 7465 2055 7369 6e67 2027 6175 746f 7265 te Using 'autore │ │ │ │ │ -00030ca0: 636f 6e66 273a 0a28 6175 746f 636f 6e66 conf':.(autoconf │ │ │ │ │ -00030cb0: 2961 7574 6f72 6563 6f6e 6620 496e 766f )autoreconf Invo │ │ │ │ │ -00030cc0: 6361 7469 6f6e 2e29 2e20 2049 6620 796f cation.). If yo │ │ │ │ │ -00030cd0: 7520 646f 206e 6f74 2077 616e 7420 746f u do not want to │ │ │ │ │ -00030ce0: 2072 656d 656d 6265 7220 7768 6174 0a74 remember what.t │ │ │ │ │ -00030cf0: 6f20 7275 6e20 616e 6420 7768 656e 2c20 o run and when, │ │ │ │ │ -00030d00: 6a75 7374 206c 6561 726e 2074 6865 2027 just learn the ' │ │ │ │ │ -00030d10: 6175 746f 7265 636f 6e66 2720 636f 6d6d autoreconf' comm │ │ │ │ │ -00030d20: 616e 642e 2020 486f 7065 6675 6c6c 792c and. Hopefully, │ │ │ │ │ -00030d30: 0a72 6570 6c61 6369 6e67 2065 7869 7374 .replacing exist │ │ │ │ │ -00030d40: 696e 6720 2762 6f6f 7473 7472 6170 2e73 ing 'bootstrap.s │ │ │ │ │ -00030d50: 6827 206f 7220 2761 7574 6f67 656e 2e73 h' or 'autogen.s │ │ │ │ │ -00030d60: 6827 2073 6372 6970 7473 2062 7920 6120 h' scripts by a │ │ │ │ │ -00030d70: 6361 6c6c 2074 6f0a 2761 7574 6f72 6563 call to.'autorec │ │ │ │ │ -00030d80: 6f6e 6627 2073 686f 756c 6420 616c 736f onf' should also │ │ │ │ │ -00030d90: 2066 7265 6520 796f 7520 6672 6f6d 2061 free you from a │ │ │ │ │ -00030da0: 6e79 2073 696d 696c 6172 2069 6e63 6f6d ny similar incom │ │ │ │ │ -00030db0: 7061 7469 626c 6520 6368 616e 6765 0a69 patible change.i │ │ │ │ │ -00030dc0: 6e20 7468 6520 6675 7475 7265 2e0a 0a1f n the future.... │ │ │ │ │ -00030dd0: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -00030de0: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -00030df0: 3a20 4f62 6a65 6374 7320 6372 6561 7465 : Objects create │ │ │ │ │ -00030e00: 6420 626f 7468 2077 6974 6820 6c69 6274 d both with libt │ │ │ │ │ -00030e10: 6f6f 6c20 616e 6420 7769 7468 6f75 742c ool and without, │ │ │ │ │ -00030e20: 2020 5072 6576 3a20 4572 726f 7220 7265 Prev: Error re │ │ │ │ │ -00030e30: 7175 6972 6564 2066 696c 6520 6c74 6d61 quired file ltma │ │ │ │ │ -00030e40: 696e 2e73 6820 6e6f 7420 666f 756e 642c in.sh not found, │ │ │ │ │ -00030e50: 2020 5570 3a20 4c69 6274 6f6f 6c20 4973 Up: Libtool Is │ │ │ │ │ -00030e60: 7375 6573 0a0a 382e 332e 392e 3220 4f62 sues..8.3.9.2 Ob │ │ │ │ │ -00030e70: 6a65 6374 7320 2763 7265 6174 6564 2077 jects 'created w │ │ │ │ │ -00030e80: 6974 6820 626f 7468 206c 6962 746f 6f6c ith both libtool │ │ │ │ │ -00030e90: 2061 6e64 2077 6974 686f 7574 270a 2e2e and without'... │ │ │ │ │ +00030a40: 2e2e 2e2e 0a0a 4c69 6274 6f6f 6c20 636f ......Libtool co │ │ │ │ │ +00030a50: 6d65 7320 7769 7468 2061 2074 6f6f 6c20 mes with a tool │ │ │ │ │ +00030a60: 6361 6c6c 6564 2027 6c69 6274 6f6f 6c69 called 'libtooli │ │ │ │ │ +00030a70: 7a65 2720 7468 6174 2077 696c 6c20 696e ze' that will in │ │ │ │ │ +00030a80: 7374 616c 6c0a 6c69 6274 6f6f 6c27 7320 stall.libtool's │ │ │ │ │ +00030a90: 7375 7070 6f72 7469 6e67 2066 696c 6573 supporting files │ │ │ │ │ +00030aa0: 2069 6e74 6f20 6120 7061 636b 6167 652e into a package. │ │ │ │ │ +00030ab0: 2020 5275 6e6e 696e 6720 7468 6973 2063 Running this c │ │ │ │ │ +00030ac0: 6f6d 6d61 6e64 2077 696c 6c0a 696e 7374 ommand will.inst │ │ │ │ │ +00030ad0: 616c 6c20 276c 746d 6169 6e2e 7368 272e all 'ltmain.sh'. │ │ │ │ │ +00030ae0: 2020 596f 7520 7368 6f75 6c64 2065 7865 You should exe │ │ │ │ │ +00030af0: 6375 7465 2069 7420 6265 666f 7265 2027 cute it before ' │ │ │ │ │ +00030b00: 6163 6c6f 6361 6c27 2061 6e64 0a27 6175 aclocal' and.'au │ │ │ │ │ +00030b10: 746f 6d61 6b65 272e 0a0a 2020 2050 656f tomake'... Peo │ │ │ │ │ +00030b20: 706c 6520 7570 6772 6164 696e 6720 6f6c ple upgrading ol │ │ │ │ │ +00030b30: 6420 7061 636b 6167 6573 2074 6f20 6e65 d packages to ne │ │ │ │ │ +00030b40: 7765 7220 6175 746f 746f 6f6c 7320 6172 wer autotools ar │ │ │ │ │ +00030b50: 6520 6c69 6b65 6c79 2074 6f20 6661 6365 e likely to face │ │ │ │ │ +00030b60: 0a74 6869 7320 6973 7375 6520 6265 6361 .this issue beca │ │ │ │ │ +00030b70: 7573 6520 6f6c 6465 7220 4175 746f 6d61 use older Automa │ │ │ │ │ +00030b80: 6b65 2076 6572 7369 6f6e 7320 7573 6564 ke versions used │ │ │ │ │ +00030b90: 2074 6f20 6361 6c6c 2027 6c69 6274 6f6f to call 'libtoo │ │ │ │ │ +00030ba0: 6c69 7a65 272e 0a54 6865 7265 666f 7265 lize'..Therefore │ │ │ │ │ +00030bb0: 206f 6c64 2062 7569 6c64 2073 6372 6970 old build scrip │ │ │ │ │ +00030bc0: 7473 2064 6f20 6e6f 7420 6361 6c6c 2027 ts do not call ' │ │ │ │ │ +00030bd0: 6c69 6274 6f6f 6c69 7a65 272e 0a0a 2020 libtoolize'... │ │ │ │ │ +00030be0: 2053 696e 6365 2041 7574 6f6d 616b 6520 Since Automake │ │ │ │ │ +00030bf0: 312e 362c 2069 7420 6861 7320 6265 656e 1.6, it has been │ │ │ │ │ +00030c00: 2064 6563 6964 6564 2074 6861 7420 7275 decided that ru │ │ │ │ │ +00030c10: 6e6e 696e 6720 276c 6962 746f 6f6c 697a nning 'libtooliz │ │ │ │ │ +00030c20: 6527 2077 6173 0a6e 6f6e 6520 6f66 2041 e' was.none of A │ │ │ │ │ +00030c30: 7574 6f6d 616b 6527 7320 6275 7369 6e65 utomake's busine │ │ │ │ │ +00030c40: 7373 2e20 2049 6e73 7465 6164 2c20 7468 ss. Instead, th │ │ │ │ │ +00030c50: 6174 2066 756e 6374 696f 6e61 6c69 7479 at functionality │ │ │ │ │ +00030c60: 2068 6173 2062 6565 6e20 6d6f 7665 640a has been moved. │ │ │ │ │ +00030c70: 696e 746f 2074 6865 2027 6175 746f 7265 into the 'autore │ │ │ │ │ +00030c80: 636f 6e66 2720 636f 6d6d 616e 6420 282a conf' command (* │ │ │ │ │ +00030c90: 6e6f 7465 2055 7369 6e67 2027 6175 746f note Using 'auto │ │ │ │ │ +00030ca0: 7265 636f 6e66 273a 0a28 6175 746f 636f reconf':.(autoco │ │ │ │ │ +00030cb0: 6e66 2961 7574 6f72 6563 6f6e 6620 496e nf)autoreconf In │ │ │ │ │ +00030cc0: 766f 6361 7469 6f6e 2e29 2e20 2049 6620 vocation.). If │ │ │ │ │ +00030cd0: 796f 7520 646f 206e 6f74 2077 616e 7420 you do not want │ │ │ │ │ +00030ce0: 746f 2072 656d 656d 6265 7220 7768 6174 to remember what │ │ │ │ │ +00030cf0: 0a74 6f20 7275 6e20 616e 6420 7768 656e .to run and when │ │ │ │ │ +00030d00: 2c20 6a75 7374 206c 6561 726e 2074 6865 , just learn the │ │ │ │ │ +00030d10: 2027 6175 746f 7265 636f 6e66 2720 636f 'autoreconf' co │ │ │ │ │ +00030d20: 6d6d 616e 642e 2020 486f 7065 6675 6c6c mmand. Hopefull │ │ │ │ │ +00030d30: 792c 0a72 6570 6c61 6369 6e67 2065 7869 y,.replacing exi │ │ │ │ │ +00030d40: 7374 696e 6720 2762 6f6f 7473 7472 6170 sting 'bootstrap │ │ │ │ │ +00030d50: 2e73 6827 206f 7220 2761 7574 6f67 656e .sh' or 'autogen │ │ │ │ │ +00030d60: 2e73 6827 2073 6372 6970 7473 2062 7920 .sh' scripts by │ │ │ │ │ +00030d70: 6120 6361 6c6c 2074 6f0a 2761 7574 6f72 a call to.'autor │ │ │ │ │ +00030d80: 6563 6f6e 6627 2073 686f 756c 6420 616c econf' should al │ │ │ │ │ +00030d90: 736f 2066 7265 6520 796f 7520 6672 6f6d so free you from │ │ │ │ │ +00030da0: 2061 6e79 2073 696d 696c 6172 2069 6e63 any similar inc │ │ │ │ │ +00030db0: 6f6d 7061 7469 626c 6520 6368 616e 6765 ompatible change │ │ │ │ │ +00030dc0: 0a69 6e20 7468 6520 6675 7475 7265 2e0a .in the future.. │ │ │ │ │ +00030dd0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +00030de0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +00030df0: 6465 3a20 4f62 6a65 6374 7320 6372 6561 de: Objects crea │ │ │ │ │ +00030e00: 7465 6420 626f 7468 2077 6974 6820 6c69 ted both with li │ │ │ │ │ +00030e10: 6274 6f6f 6c20 616e 6420 7769 7468 6f75 btool and withou │ │ │ │ │ +00030e20: 742c 2020 5072 6576 3a20 4572 726f 7220 t, Prev: Error │ │ │ │ │ +00030e30: 7265 7175 6972 6564 2066 696c 6520 6c74 required file lt │ │ │ │ │ +00030e40: 6d61 696e 2e73 6820 6e6f 7420 666f 756e main.sh not foun │ │ │ │ │ +00030e50: 642c 2020 5570 3a20 4c69 6274 6f6f 6c20 d, Up: Libtool │ │ │ │ │ +00030e60: 4973 7375 6573 0a0a 382e 332e 392e 3220 Issues..8.3.9.2 │ │ │ │ │ +00030e70: 4f62 6a65 6374 7320 2763 7265 6174 6564 Objects 'created │ │ │ │ │ +00030e80: 2077 6974 6820 626f 7468 206c 6962 746f with both libto │ │ │ │ │ +00030e90: 6f6c 2061 6e64 2077 6974 686f 7574 270a ol and without'. │ │ │ │ │ 00030ea0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 00030eb0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ 00030ec0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -00030ed0: 2e2e 2e2e 2e0a 0a53 6f6d 6574 696d 6573 .......Sometimes │ │ │ │ │ -00030ee0: 2c20 7468 6520 7361 6d65 2073 6f75 7263 , the same sourc │ │ │ │ │ -00030ef0: 6520 6669 6c65 2069 7320 7573 6564 2062 e file is used b │ │ │ │ │ -00030f00: 6f74 6820 746f 2062 7569 6c64 2061 206c oth to build a l │ │ │ │ │ -00030f10: 6962 746f 6f6c 206c 6962 7261 7279 0a61 ibtool library.a │ │ │ │ │ -00030f20: 6e64 2074 6f20 6275 696c 6420 616e 6f74 nd to build anot │ │ │ │ │ -00030f30: 6865 7220 6e6f 6e2d 6c69 6274 6f6f 6c20 her non-libtool │ │ │ │ │ -00030f40: 7461 7267 6574 2028 6265 2069 7420 6120 target (be it a │ │ │ │ │ -00030f50: 7072 6f67 7261 6d20 6f72 2061 6e6f 7468 program or anoth │ │ │ │ │ -00030f60: 6572 0a6c 6962 7261 7279 292e 0a0a 2020 er.library)... │ │ │ │ │ -00030f70: 204c 6574 2773 2063 6f6e 7369 6465 7220 Let's consider │ │ │ │ │ -00030f80: 7468 6520 666f 6c6c 6f77 696e 6720 274d the following 'M │ │ │ │ │ -00030f90: 616b 6566 696c 652e 616d 272e 0a0a 2020 akefile.am'... │ │ │ │ │ -00030fa0: 2020 2062 696e 5f50 524f 4752 414d 5320 bin_PROGRAMS │ │ │ │ │ -00030fb0: 3d20 7072 6f67 0a20 2020 2020 7072 6f67 = prog. prog │ │ │ │ │ -00030fc0: 5f53 4f55 5243 4553 203d 2070 726f 672e _SOURCES = prog. │ │ │ │ │ -00030fd0: 6320 666f 6f2e 6320 2e2e 2e0a 0a20 2020 c foo.c ..... │ │ │ │ │ -00030fe0: 2020 6c69 625f 4c54 4c49 4252 4152 4945 lib_LTLIBRARIE │ │ │ │ │ -00030ff0: 5320 3d20 6c69 6266 6f6f 2e6c 610a 2020 S = libfoo.la. │ │ │ │ │ -00031000: 2020 206c 6962 666f 6f5f 6c61 5f53 4f55 libfoo_la_SOU │ │ │ │ │ -00031010: 5243 4553 203d 2066 6f6f 2e63 202e 2e2e RCES = foo.c ... │ │ │ │ │ -00031020: 0a0a 2849 6e20 7468 6973 2074 7269 7669 ..(In this trivi │ │ │ │ │ -00031030: 616c 2063 6173 6520 7468 6520 6973 7375 al case the issu │ │ │ │ │ -00031040: 6520 636f 756c 6420 6265 2061 766f 6964 e could be avoid │ │ │ │ │ -00031050: 6564 2062 7920 6c69 6e6b 696e 6720 276c ed by linking 'l │ │ │ │ │ -00031060: 6962 666f 6f2e 6c61 270a 7769 7468 2027 ibfoo.la'.with ' │ │ │ │ │ -00031070: 7072 6f67 2720 696e 7374 6561 6420 6f66 prog' instead of │ │ │ │ │ -00031080: 206c 6973 7469 6e67 2027 666f 6f2e 6327 listing 'foo.c' │ │ │ │ │ -00031090: 2069 6e20 2770 726f 675f 534f 5552 4345 in 'prog_SOURCE │ │ │ │ │ -000310a0: 5327 2e20 2042 7574 206c 6574 2773 0a61 S'. But let's.a │ │ │ │ │ -000310b0: 7373 756d 6520 7765 2072 6561 6c6c 7920 ssume we really │ │ │ │ │ -000310c0: 7761 6e74 2074 6f20 6b65 6570 2027 7072 want to keep 'pr │ │ │ │ │ -000310d0: 6f67 2720 616e 6420 276c 6962 666f 6f2e og' and 'libfoo. │ │ │ │ │ -000310e0: 6c61 2720 7365 7061 7261 7465 2e29 0a0a la' separate.).. │ │ │ │ │ -000310f0: 2020 2054 6563 686e 6963 616c 6c79 2c20 Technically, │ │ │ │ │ -00031100: 6974 206d 6561 6e73 2074 6861 7420 7765 it means that we │ │ │ │ │ -00031110: 2073 686f 756c 6420 6275 696c 6420 2766 should build 'f │ │ │ │ │ -00031120: 6f6f 2e24 284f 424a 4558 5429 2720 666f oo.$(OBJEXT)' fo │ │ │ │ │ -00031130: 720a 2770 726f 6727 2c20 616e 6420 2766 r.'prog', and 'f │ │ │ │ │ -00031140: 6f6f 2e6c 6f27 2066 6f72 2027 6c69 6266 oo.lo' for 'libf │ │ │ │ │ -00031150: 6f6f 2e6c 6127 2e20 2054 6865 2070 726f oo.la'. The pro │ │ │ │ │ -00031160: 626c 656d 2069 7320 7468 6174 2069 6e20 blem is that in │ │ │ │ │ -00031170: 7468 6520 636f 7572 7365 0a6f 6620 6372 the course.of cr │ │ │ │ │ -00031180: 6561 7469 6e67 2027 666f 6f2e 6c6f 272c eating 'foo.lo', │ │ │ │ │ -00031190: 206c 6962 746f 6f6c 206d 6179 2065 7261 libtool may era │ │ │ │ │ -000311a0: 7365 2028 6f72 2072 6570 6c61 6365 2920 se (or replace) │ │ │ │ │ -000311b0: 2766 6f6f 2e24 284f 424a 4558 5429 272c 'foo.$(OBJEXT)', │ │ │ │ │ -000311c0: 0a61 6e64 2074 6869 7320 6361 6e6e 6f74 .and this cannot │ │ │ │ │ -000311d0: 2062 6520 6176 6f69 6465 642e 0a0a 2020 be avoided... │ │ │ │ │ -000311e0: 2054 6865 7265 666f 7265 2c20 7768 656e Therefore, when │ │ │ │ │ -000311f0: 2041 7574 6f6d 616b 6520 6465 7465 6374 Automake detect │ │ │ │ │ -00031200: 7320 7468 6973 2073 6974 7561 7469 6f6e s this situation │ │ │ │ │ -00031210: 2069 7420 7769 6c6c 2063 6f6d 706c 6169 it will complai │ │ │ │ │ -00031220: 6e20 7769 7468 0a61 206d 6573 7361 6765 n with.a message │ │ │ │ │ -00031230: 2073 7563 6820 6173 0a20 2020 2020 6f62 such as. ob │ │ │ │ │ -00031240: 6a65 6374 2060 666f 6f2e 2428 4f42 4a45 ject `foo.$(OBJE │ │ │ │ │ -00031250: 5854 2927 2063 7265 6174 6564 2062 6f74 XT)' created bot │ │ │ │ │ -00031260: 6820 7769 7468 206c 6962 746f 6f6c 2061 h with libtool a │ │ │ │ │ -00031270: 6e64 2077 6974 686f 7574 0a0a 2020 2041 nd without.. A │ │ │ │ │ -00031280: 2077 6f72 6b61 726f 756e 6420 666f 7220 workaround for │ │ │ │ │ -00031290: 7468 6973 2069 7373 7565 2069 7320 746f this issue is to │ │ │ │ │ -000312a0: 2065 6e73 7572 6520 7468 6174 2074 6865 ensure that the │ │ │ │ │ -000312b0: 7365 2074 776f 206f 626a 6563 7473 2067 se two objects g │ │ │ │ │ -000312c0: 6574 0a64 6966 6665 7265 6e74 2062 6173 et.different bas │ │ │ │ │ -000312d0: 656e 616d 6573 2e20 2041 7320 6578 706c enames. As expl │ │ │ │ │ -000312e0: 6169 6e65 6420 696e 202a 6e6f 7465 2052 ained in *note R │ │ │ │ │ -000312f0: 656e 616d 6564 204f 626a 6563 7473 3a3a enamed Objects:: │ │ │ │ │ -00031300: 2c20 7468 6973 0a68 6170 7065 6e73 2061 , this.happens a │ │ │ │ │ -00031310: 7574 6f6d 6174 6963 616c 6c79 2077 6865 utomatically whe │ │ │ │ │ -00031320: 6e20 7065 722d 7461 7267 6574 7320 666c n per-targets fl │ │ │ │ │ -00031330: 6167 7320 6172 6520 7573 6564 2e0a 0a20 ags are used... │ │ │ │ │ -00031340: 2020 2020 6269 6e5f 5052 4f47 5241 4d53 bin_PROGRAMS │ │ │ │ │ -00031350: 203d 2070 726f 670a 2020 2020 2070 726f = prog. pro │ │ │ │ │ -00031360: 675f 534f 5552 4345 5320 3d20 7072 6f67 g_SOURCES = prog │ │ │ │ │ -00031370: 2e63 2066 6f6f 2e63 202e 2e2e 0a20 2020 .c foo.c .... │ │ │ │ │ -00031380: 2020 7072 6f67 5f43 464c 4147 5320 3d20 prog_CFLAGS = │ │ │ │ │ -00031390: 2428 414d 5f43 464c 4147 5329 0a0a 2020 $(AM_CFLAGS).. │ │ │ │ │ -000313a0: 2020 206c 6962 5f4c 544c 4942 5241 5249 lib_LTLIBRARI │ │ │ │ │ -000313b0: 4553 203d 206c 6962 666f 6f2e 6c61 0a20 ES = libfoo.la. │ │ │ │ │ -000313c0: 2020 2020 6c69 6266 6f6f 5f6c 615f 534f libfoo_la_SO │ │ │ │ │ -000313d0: 5552 4345 5320 3d20 666f 6f2e 6320 2e2e URCES = foo.c .. │ │ │ │ │ -000313e0: 2e0a 0a41 6464 696e 6720 2770 726f 675f ...Adding 'prog_ │ │ │ │ │ -000313f0: 4346 4c41 4753 203d 2024 2841 4d5f 4346 CFLAGS = $(AM_CF │ │ │ │ │ -00031400: 4c41 4753 2927 2069 7320 616c 6d6f 7374 LAGS)' is almost │ │ │ │ │ -00031410: 2061 206e 6f2d 6f70 2c20 6265 6361 7573 a no-op, becaus │ │ │ │ │ -00031420: 6520 7768 656e 2074 6865 0a27 7072 6f67 e when the.'prog │ │ │ │ │ -00031430: 5f43 464c 4147 5327 2069 7320 6465 6669 _CFLAGS' is defi │ │ │ │ │ -00031440: 6e65 642c 2069 7420 6973 2075 7365 6420 ned, it is used │ │ │ │ │ -00031450: 696e 7374 6561 6420 6f66 2027 414d 5f43 instead of 'AM_C │ │ │ │ │ -00031460: 464c 4147 5327 2e20 2048 6f77 6576 6572 FLAGS'. However │ │ │ │ │ -00031470: 2061 730a 6120 7369 6465 2065 6666 6563 as.a side effec │ │ │ │ │ -00031480: 7420 6974 2077 696c 6c20 6361 7573 6520 t it will cause │ │ │ │ │ -00031490: 2770 726f 672e 6327 2061 6e64 2027 666f 'prog.c' and 'fo │ │ │ │ │ -000314a0: 6f2e 6327 2074 6f20 6265 2063 6f6d 7069 o.c' to be compi │ │ │ │ │ -000314b0: 6c65 6420 6173 0a27 7072 6f67 2d70 726f led as.'prog-pro │ │ │ │ │ -000314c0: 672e 2428 4f42 4a45 5854 2927 2061 6e64 g.$(OBJEXT)' and │ │ │ │ │ -000314d0: 2027 7072 6f67 2d66 6f6f 2e24 284f 424a 'prog-foo.$(OBJ │ │ │ │ │ -000314e0: 4558 5429 272c 2077 6869 6368 2073 6f6c EXT)', which sol │ │ │ │ │ -000314f0: 7665 7320 7468 6520 6973 7375 652e 0a0a ves the issue... │ │ │ │ │ -00031500: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -00031510: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -00031520: 653a 2050 726f 6772 616d 2061 6e64 204c e: Program and L │ │ │ │ │ -00031530: 6962 7261 7279 2056 6172 6961 626c 6573 ibrary Variables │ │ │ │ │ -00031540: 2c20 204e 6578 743a 2044 6566 6175 6c74 , Next: Default │ │ │ │ │ -00031550: 205f 534f 5552 4345 532c 2020 5072 6576 _SOURCES, Prev │ │ │ │ │ -00031560: 3a20 4120 5368 6172 6564 204c 6962 7261 : A Shared Libra │ │ │ │ │ -00031570: 7279 2c20 2055 703a 2050 726f 6772 616d ry, Up: Program │ │ │ │ │ -00031580: 730a 0a38 2e34 2050 726f 6772 616d 2061 s..8.4 Program a │ │ │ │ │ -00031590: 6e64 204c 6962 7261 7279 2056 6172 6961 nd Library Varia │ │ │ │ │ -000315a0: 626c 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d bles.=========== │ │ │ │ │ +00030ed0: 2e2e 2e2e 2e2e 2e0a 0a53 6f6d 6574 696d .........Sometim │ │ │ │ │ +00030ee0: 6573 2c20 7468 6520 7361 6d65 2073 6f75 es, the same sou │ │ │ │ │ +00030ef0: 7263 6520 6669 6c65 2069 7320 7573 6564 rce file is used │ │ │ │ │ +00030f00: 2062 6f74 6820 746f 2062 7569 6c64 2061 both to build a │ │ │ │ │ +00030f10: 206c 6962 746f 6f6c 206c 6962 7261 7279 libtool library │ │ │ │ │ +00030f20: 0a61 6e64 2074 6f20 6275 696c 6420 616e .and to build an │ │ │ │ │ +00030f30: 6f74 6865 7220 6e6f 6e2d 6c69 6274 6f6f other non-libtoo │ │ │ │ │ +00030f40: 6c20 7461 7267 6574 2028 6265 2069 7420 l target (be it │ │ │ │ │ +00030f50: 6120 7072 6f67 7261 6d20 6f72 2061 6e6f a program or ano │ │ │ │ │ +00030f60: 7468 6572 0a6c 6962 7261 7279 292e 0a0a ther.library)... │ │ │ │ │ +00030f70: 2020 204c 6574 2773 2063 6f6e 7369 6465 Let's conside │ │ │ │ │ +00030f80: 7220 7468 6520 666f 6c6c 6f77 696e 6720 r the following │ │ │ │ │ +00030f90: 274d 616b 6566 696c 652e 616d 272e 0a0a 'Makefile.am'... │ │ │ │ │ +00030fa0: 2020 2020 2062 696e 5f50 524f 4752 414d bin_PROGRAM │ │ │ │ │ +00030fb0: 5320 3d20 7072 6f67 0a20 2020 2020 7072 S = prog. pr │ │ │ │ │ +00030fc0: 6f67 5f53 4f55 5243 4553 203d 2070 726f og_SOURCES = pro │ │ │ │ │ +00030fd0: 672e 6320 666f 6f2e 6320 2e2e 2e0a 0a20 g.c foo.c ..... │ │ │ │ │ +00030fe0: 2020 2020 6c69 625f 4c54 4c49 4252 4152 lib_LTLIBRAR │ │ │ │ │ +00030ff0: 4945 5320 3d20 6c69 6266 6f6f 2e6c 610a IES = libfoo.la. │ │ │ │ │ +00031000: 2020 2020 206c 6962 666f 6f5f 6c61 5f53 libfoo_la_S │ │ │ │ │ +00031010: 4f55 5243 4553 203d 2066 6f6f 2e63 202e OURCES = foo.c . │ │ │ │ │ +00031020: 2e2e 0a0a 2849 6e20 7468 6973 2074 7269 ....(In this tri │ │ │ │ │ +00031030: 7669 616c 2063 6173 6520 7468 6520 6973 vial case the is │ │ │ │ │ +00031040: 7375 6520 636f 756c 6420 6265 2061 766f sue could be avo │ │ │ │ │ +00031050: 6964 6564 2062 7920 6c69 6e6b 696e 6720 ided by linking │ │ │ │ │ +00031060: 276c 6962 666f 6f2e 6c61 270a 7769 7468 'libfoo.la'.with │ │ │ │ │ +00031070: 2027 7072 6f67 2720 696e 7374 6561 6420 'prog' instead │ │ │ │ │ +00031080: 6f66 206c 6973 7469 6e67 2027 666f 6f2e of listing 'foo. │ │ │ │ │ +00031090: 6327 2069 6e20 2770 726f 675f 534f 5552 c' in 'prog_SOUR │ │ │ │ │ +000310a0: 4345 5327 2e20 2042 7574 206c 6574 2773 CES'. But let's │ │ │ │ │ +000310b0: 0a61 7373 756d 6520 7765 2072 6561 6c6c .assume we reall │ │ │ │ │ +000310c0: 7920 7761 6e74 2074 6f20 6b65 6570 2027 y want to keep ' │ │ │ │ │ +000310d0: 7072 6f67 2720 616e 6420 276c 6962 666f prog' and 'libfo │ │ │ │ │ +000310e0: 6f2e 6c61 2720 7365 7061 7261 7465 2e29 o.la' separate.) │ │ │ │ │ +000310f0: 0a0a 2020 2054 6563 686e 6963 616c 6c79 .. Technically │ │ │ │ │ +00031100: 2c20 6974 206d 6561 6e73 2074 6861 7420 , it means that │ │ │ │ │ +00031110: 7765 2073 686f 756c 6420 6275 696c 6420 we should build │ │ │ │ │ +00031120: 2766 6f6f 2e24 284f 424a 4558 5429 2720 'foo.$(OBJEXT)' │ │ │ │ │ +00031130: 666f 720a 2770 726f 6727 2c20 616e 6420 for.'prog', and │ │ │ │ │ +00031140: 2766 6f6f 2e6c 6f27 2066 6f72 2027 6c69 'foo.lo' for 'li │ │ │ │ │ +00031150: 6266 6f6f 2e6c 6127 2e20 2054 6865 2070 bfoo.la'. The p │ │ │ │ │ +00031160: 726f 626c 656d 2069 7320 7468 6174 2069 roblem is that i │ │ │ │ │ +00031170: 6e20 7468 6520 636f 7572 7365 0a6f 6620 n the course.of │ │ │ │ │ +00031180: 6372 6561 7469 6e67 2027 666f 6f2e 6c6f creating 'foo.lo │ │ │ │ │ +00031190: 272c 206c 6962 746f 6f6c 206d 6179 2065 ', libtool may e │ │ │ │ │ +000311a0: 7261 7365 2028 6f72 2072 6570 6c61 6365 rase (or replace │ │ │ │ │ +000311b0: 2920 2766 6f6f 2e24 284f 424a 4558 5429 ) 'foo.$(OBJEXT) │ │ │ │ │ +000311c0: 272c 0a61 6e64 2074 6869 7320 6361 6e6e ',.and this cann │ │ │ │ │ +000311d0: 6f74 2062 6520 6176 6f69 6465 642e 0a0a ot be avoided... │ │ │ │ │ +000311e0: 2020 2054 6865 7265 666f 7265 2c20 7768 Therefore, wh │ │ │ │ │ +000311f0: 656e 2041 7574 6f6d 616b 6520 6465 7465 en Automake dete │ │ │ │ │ +00031200: 6374 7320 7468 6973 2073 6974 7561 7469 cts this situati │ │ │ │ │ +00031210: 6f6e 2069 7420 7769 6c6c 2063 6f6d 706c on it will compl │ │ │ │ │ +00031220: 6169 6e20 7769 7468 0a61 206d 6573 7361 ain with.a messa │ │ │ │ │ +00031230: 6765 2073 7563 6820 6173 0a20 2020 2020 ge such as. │ │ │ │ │ +00031240: 6f62 6a65 6374 2060 666f 6f2e 2428 4f42 object `foo.$(OB │ │ │ │ │ +00031250: 4a45 5854 2927 2063 7265 6174 6564 2062 JEXT)' created b │ │ │ │ │ +00031260: 6f74 6820 7769 7468 206c 6962 746f 6f6c oth with libtool │ │ │ │ │ +00031270: 2061 6e64 2077 6974 686f 7574 0a0a 2020 and without.. │ │ │ │ │ +00031280: 2041 2077 6f72 6b61 726f 756e 6420 666f A workaround fo │ │ │ │ │ +00031290: 7220 7468 6973 2069 7373 7565 2069 7320 r this issue is │ │ │ │ │ +000312a0: 746f 2065 6e73 7572 6520 7468 6174 2074 to ensure that t │ │ │ │ │ +000312b0: 6865 7365 2074 776f 206f 626a 6563 7473 hese two objects │ │ │ │ │ +000312c0: 2067 6574 0a64 6966 6665 7265 6e74 2062 get.different b │ │ │ │ │ +000312d0: 6173 656e 616d 6573 2e20 2041 7320 6578 asenames. As ex │ │ │ │ │ +000312e0: 706c 6169 6e65 6420 696e 202a 6e6f 7465 plained in *note │ │ │ │ │ +000312f0: 2052 656e 616d 6564 204f 626a 6563 7473 Renamed Objects │ │ │ │ │ +00031300: 3a3a 2c20 7468 6973 0a68 6170 7065 6e73 ::, this.happens │ │ │ │ │ +00031310: 2061 7574 6f6d 6174 6963 616c 6c79 2077 automatically w │ │ │ │ │ +00031320: 6865 6e20 7065 722d 7461 7267 6574 7320 hen per-targets │ │ │ │ │ +00031330: 666c 6167 7320 6172 6520 7573 6564 2e0a flags are used.. │ │ │ │ │ +00031340: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ +00031350: 4d53 203d 2070 726f 670a 2020 2020 2070 MS = prog. p │ │ │ │ │ +00031360: 726f 675f 534f 5552 4345 5320 3d20 7072 rog_SOURCES = pr │ │ │ │ │ +00031370: 6f67 2e63 2066 6f6f 2e63 202e 2e2e 0a20 og.c foo.c .... │ │ │ │ │ +00031380: 2020 2020 7072 6f67 5f43 464c 4147 5320 prog_CFLAGS │ │ │ │ │ +00031390: 3d20 2428 414d 5f43 464c 4147 5329 0a0a = $(AM_CFLAGS).. │ │ │ │ │ +000313a0: 2020 2020 206c 6962 5f4c 544c 4942 5241 lib_LTLIBRA │ │ │ │ │ +000313b0: 5249 4553 203d 206c 6962 666f 6f2e 6c61 RIES = libfoo.la │ │ │ │ │ +000313c0: 0a20 2020 2020 6c69 6266 6f6f 5f6c 615f . libfoo_la_ │ │ │ │ │ +000313d0: 534f 5552 4345 5320 3d20 666f 6f2e 6320 SOURCES = foo.c │ │ │ │ │ +000313e0: 2e2e 2e0a 0a41 6464 696e 6720 2770 726f .....Adding 'pro │ │ │ │ │ +000313f0: 675f 4346 4c41 4753 203d 2024 2841 4d5f g_CFLAGS = $(AM_ │ │ │ │ │ +00031400: 4346 4c41 4753 2927 2069 7320 616c 6d6f CFLAGS)' is almo │ │ │ │ │ +00031410: 7374 2061 206e 6f2d 6f70 2c20 6265 6361 st a no-op, beca │ │ │ │ │ +00031420: 7573 6520 7768 656e 2074 6865 0a27 7072 use when the.'pr │ │ │ │ │ +00031430: 6f67 5f43 464c 4147 5327 2069 7320 6465 og_CFLAGS' is de │ │ │ │ │ +00031440: 6669 6e65 642c 2069 7420 6973 2075 7365 fined, it is use │ │ │ │ │ +00031450: 6420 696e 7374 6561 6420 6f66 2027 414d d instead of 'AM │ │ │ │ │ +00031460: 5f43 464c 4147 5327 2e20 2048 6f77 6576 _CFLAGS'. Howev │ │ │ │ │ +00031470: 6572 2061 730a 6120 7369 6465 2065 6666 er as.a side eff │ │ │ │ │ +00031480: 6563 7420 6974 2077 696c 6c20 6361 7573 ect it will caus │ │ │ │ │ +00031490: 6520 2770 726f 672e 6327 2061 6e64 2027 e 'prog.c' and ' │ │ │ │ │ +000314a0: 666f 6f2e 6327 2074 6f20 6265 2063 6f6d foo.c' to be com │ │ │ │ │ +000314b0: 7069 6c65 6420 6173 0a27 7072 6f67 2d70 piled as.'prog-p │ │ │ │ │ +000314c0: 726f 672e 2428 4f42 4a45 5854 2927 2061 rog.$(OBJEXT)' a │ │ │ │ │ +000314d0: 6e64 2027 7072 6f67 2d66 6f6f 2e24 284f nd 'prog-foo.$(O │ │ │ │ │ +000314e0: 424a 4558 5429 272c 2077 6869 6368 2073 BJEXT)', which s │ │ │ │ │ +000314f0: 6f6c 7665 7320 7468 6520 6973 7375 652e olves the issue. │ │ │ │ │ +00031500: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +00031510: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +00031520: 6f64 653a 2050 726f 6772 616d 2061 6e64 ode: Program and │ │ │ │ │ +00031530: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ +00031540: 6573 2c20 204e 6578 743a 2044 6566 6175 es, Next: Defau │ │ │ │ │ +00031550: 6c74 205f 534f 5552 4345 532c 2020 5072 lt _SOURCES, Pr │ │ │ │ │ +00031560: 6576 3a20 4120 5368 6172 6564 204c 6962 ev: A Shared Lib │ │ │ │ │ +00031570: 7261 7279 2c20 2055 703a 2050 726f 6772 rary, Up: Progr │ │ │ │ │ +00031580: 616d 730a 0a38 2e34 2050 726f 6772 616d ams..8.4 Program │ │ │ │ │ +00031590: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ +000315a0: 6961 626c 6573 0a3d 3d3d 3d3d 3d3d 3d3d iables.========= │ │ │ │ │ 000315b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000315c0: 3d3d 3d3d 3d3d 0a0a 4173 736f 6369 6174 ======..Associat │ │ │ │ │ -000315d0: 6564 2077 6974 6820 6561 6368 2070 726f ed with each pro │ │ │ │ │ -000315e0: 6772 616d 2069 7320 6120 636f 6c6c 6563 gram is a collec │ │ │ │ │ -000315f0: 7469 6f6e 206f 6620 7661 7269 6162 6c65 tion of variable │ │ │ │ │ -00031600: 7320 7468 6174 2063 616e 2062 650a 7573 s that can be.us │ │ │ │ │ -00031610: 6564 2074 6f20 6d6f 6469 6679 2068 6f77 ed to modify how │ │ │ │ │ -00031620: 2074 6861 7420 7072 6f67 7261 6d20 6973 that program is │ │ │ │ │ -00031630: 2062 7569 6c74 2e20 2054 6865 7265 2069 built. There i │ │ │ │ │ -00031640: 7320 6120 7369 6d69 6c61 7220 6c69 7374 s a similar list │ │ │ │ │ -00031650: 206f 660a 7375 6368 2076 6172 6961 626c of.such variabl │ │ │ │ │ -00031660: 6573 2066 6f72 2065 6163 6820 6c69 6272 es for each libr │ │ │ │ │ -00031670: 6172 792e 2020 5468 6520 6361 6e6f 6e69 ary. The canoni │ │ │ │ │ -00031680: 6361 6c20 6e61 6d65 206f 6620 7468 6520 cal name of the │ │ │ │ │ -00031690: 7072 6f67 7261 6d20 286f 720a 6c69 6272 program (or.libr │ │ │ │ │ -000316a0: 6172 7929 2069 7320 7573 6564 2061 7320 ary) is used as │ │ │ │ │ -000316b0: 6120 6261 7365 2066 6f72 206e 616d 696e a base for namin │ │ │ │ │ -000316c0: 6720 7468 6573 6520 7661 7269 6162 6c65 g these variable │ │ │ │ │ -000316d0: 732e 0a0a 2020 2049 6e20 7468 6520 6c69 s... In the li │ │ │ │ │ -000316e0: 7374 2062 656c 6f77 2c20 7765 2075 7365 st below, we use │ │ │ │ │ -000316f0: 2074 6865 206e 616d 6520 226d 6175 6465 the name "maude │ │ │ │ │ -00031700: 2220 746f 2072 6566 6572 2074 6f20 7468 " to refer to th │ │ │ │ │ -00031710: 6520 7072 6f67 7261 6d20 6f72 0a6c 6962 e program or.lib │ │ │ │ │ -00031720: 7261 7279 2e20 2049 6e20 796f 7572 2027 rary. In your ' │ │ │ │ │ -00031730: 4d61 6b65 6669 6c65 2e61 6d27 2079 6f75 Makefile.am' you │ │ │ │ │ -00031740: 2077 6f75 6c64 2072 6570 6c61 6365 2074 would replace t │ │ │ │ │ -00031750: 6869 7320 7769 7468 2074 6865 0a63 616e his with the.can │ │ │ │ │ -00031760: 6f6e 6963 616c 206e 616d 6520 6f66 2079 onical name of y │ │ │ │ │ -00031770: 6f75 7220 7072 6f67 7261 6d2e 2020 5468 our program. Th │ │ │ │ │ -00031780: 6973 206c 6973 7420 616c 736f 2072 6566 is list also ref │ │ │ │ │ -00031790: 6572 7320 746f 2022 6d61 7564 6522 2061 ers to "maude" a │ │ │ │ │ -000317a0: 7320 610a 7072 6f67 7261 6d2c 2062 7574 s a.program, but │ │ │ │ │ -000317b0: 2069 6e20 6765 6e65 7261 6c20 7468 6520 in general the │ │ │ │ │ -000317c0: 7361 6d65 2072 756c 6573 2061 7070 6c79 same rules apply │ │ │ │ │ -000317d0: 2066 6f72 2062 6f74 6820 7374 6174 6963 for both static │ │ │ │ │ -000317e0: 2061 6e64 2064 796e 616d 6963 0a6c 6962 and dynamic.lib │ │ │ │ │ -000317f0: 7261 7269 6573 3b20 7468 6520 646f 6375 raries; the docu │ │ │ │ │ -00031800: 6d65 6e74 6174 696f 6e20 6265 6c6f 7720 mentation below │ │ │ │ │ -00031810: 6e6f 7465 7320 7369 7475 6174 696f 6e73 notes situations │ │ │ │ │ -00031820: 2077 6865 7265 2070 726f 6772 616d 7320 where programs │ │ │ │ │ -00031830: 616e 640a 6c69 6272 6172 6965 7320 6469 and.libraries di │ │ │ │ │ -00031840: 6666 6572 2e0a 0a27 6d61 7564 655f 534f ffer...'maude_SO │ │ │ │ │ -00031850: 5552 4345 5327 0a20 2020 2020 5468 6973 URCES'. This │ │ │ │ │ -00031860: 2076 6172 6961 626c 652c 2069 6620 6974 variable, if it │ │ │ │ │ -00031870: 2065 7869 7374 732c 206c 6973 7473 2061 exists, lists a │ │ │ │ │ -00031880: 6c6c 2074 6865 2073 6f75 7263 6520 6669 ll the source fi │ │ │ │ │ -00031890: 6c65 7320 7468 6174 2061 7265 0a20 2020 les that are. │ │ │ │ │ -000318a0: 2020 636f 6d70 696c 6564 2074 6f20 6275 compiled to bu │ │ │ │ │ -000318b0: 696c 6420 7468 6520 7072 6f67 7261 6d2e ild the program. │ │ │ │ │ -000318c0: 2020 5468 6573 6520 6669 6c65 7320 6172 These files ar │ │ │ │ │ -000318d0: 6520 6164 6465 6420 746f 2074 6865 0a20 e added to the. │ │ │ │ │ -000318e0: 2020 2020 6469 7374 7269 6275 7469 6f6e distribution │ │ │ │ │ -000318f0: 2062 7920 6465 6661 756c 742e 2020 5768 by default. Wh │ │ │ │ │ -00031900: 656e 2062 7569 6c64 696e 6720 7468 6520 en building the │ │ │ │ │ -00031910: 7072 6f67 7261 6d2c 2041 7574 6f6d 616b program, Automak │ │ │ │ │ -00031920: 6520 7769 6c6c 0a20 2020 2020 6361 7573 e will. caus │ │ │ │ │ -00031930: 6520 6561 6368 2073 6f75 7263 6520 6669 e each source fi │ │ │ │ │ -00031940: 6c65 2074 6f20 6265 2063 6f6d 7069 6c65 le to be compile │ │ │ │ │ -00031950: 6420 746f 2061 2073 696e 676c 6520 272e d to a single '. │ │ │ │ │ -00031960: 6f27 2066 696c 6520 286f 720a 2020 2020 o' file (or. │ │ │ │ │ -00031970: 2027 2e6c 6f27 2077 6865 6e20 7573 696e '.lo' when usin │ │ │ │ │ -00031980: 6720 6c69 6274 6f6f 6c29 2e20 204e 6f72 g libtool). Nor │ │ │ │ │ -00031990: 6d61 6c6c 7920 7468 6573 6520 6f62 6a65 mally these obje │ │ │ │ │ -000319a0: 6374 2066 696c 6573 2061 7265 206e 616d ct files are nam │ │ │ │ │ -000319b0: 6564 0a20 2020 2020 6166 7465 7220 7468 ed. after th │ │ │ │ │ -000319c0: 6520 736f 7572 6365 2066 696c 652c 2062 e source file, b │ │ │ │ │ -000319d0: 7574 206f 7468 6572 2066 6163 746f 7273 ut other factors │ │ │ │ │ -000319e0: 2063 616e 2063 6861 6e67 6520 7468 6973 can change this │ │ │ │ │ -000319f0: 2e20 2049 6620 610a 2020 2020 2066 696c . If a. fil │ │ │ │ │ -00031a00: 6520 696e 2074 6865 2027 5f53 4f55 5243 e in the '_SOURC │ │ │ │ │ -00031a10: 4553 2720 7661 7269 6162 6c65 2068 6173 ES' variable has │ │ │ │ │ -00031a20: 2061 6e20 756e 7265 636f 676e 697a 6564 an unrecognized │ │ │ │ │ -00031a30: 2065 7874 656e 7369 6f6e 2c0a 2020 2020 extension,. │ │ │ │ │ -00031a40: 2041 7574 6f6d 616b 6520 7769 6c6c 2064 Automake will d │ │ │ │ │ -00031a50: 6f20 6f6e 6520 6f66 2074 776f 2074 6869 o one of two thi │ │ │ │ │ -00031a60: 6e67 7320 7769 7468 2069 742e 2020 4966 ngs with it. If │ │ │ │ │ -00031a70: 2061 2073 7566 6669 7820 7275 6c65 0a20 a suffix rule. │ │ │ │ │ -00031a80: 2020 2020 6578 6973 7473 2066 6f72 2074 exists for t │ │ │ │ │ -00031a90: 7572 6e69 6e67 2066 696c 6573 2077 6974 urning files wit │ │ │ │ │ -00031aa0: 6820 7468 6520 756e 7265 636f 676e 697a h the unrecogniz │ │ │ │ │ -00031ab0: 6564 2065 7874 656e 7369 6f6e 2069 6e74 ed extension int │ │ │ │ │ -00031ac0: 6f20 272e 6f27 0a20 2020 2020 6669 6c65 o '.o'. file │ │ │ │ │ -00031ad0: 732c 2074 6865 6e20 2761 7574 6f6d 616b s, then 'automak │ │ │ │ │ -00031ae0: 6527 2077 696c 6c20 7472 6561 7420 7468 e' will treat th │ │ │ │ │ -00031af0: 6973 2066 696c 6520 6173 2069 7420 7769 is file as it wi │ │ │ │ │ -00031b00: 6c6c 2061 6e79 206f 7468 6572 0a20 2020 ll any other. │ │ │ │ │ -00031b10: 2020 736f 7572 6365 2066 696c 6520 282a source file (* │ │ │ │ │ -00031b20: 6e6f 7465 2053 7570 706f 7274 2066 6f72 note Support for │ │ │ │ │ -00031b30: 204f 7468 6572 204c 616e 6775 6167 6573 Other Languages │ │ │ │ │ -00031b40: 3a3a 292e 2020 4f74 6865 7277 6973 652c ::). Otherwise, │ │ │ │ │ -00031b50: 2074 6865 0a20 2020 2020 6669 6c65 2077 the. file w │ │ │ │ │ -00031b60: 696c 6c20 6265 2069 676e 6f72 6564 2061 ill be ignored a │ │ │ │ │ -00031b70: 7320 7468 6f75 6768 2069 7420 7765 7265 s though it were │ │ │ │ │ -00031b80: 2061 2068 6561 6465 7220 6669 6c65 2e0a a header file.. │ │ │ │ │ -00031b90: 0a20 2020 2020 5468 6520 7072 6566 6978 . The prefix │ │ │ │ │ -00031ba0: 6573 2027 6469 7374 5f27 2061 6e64 2027 es 'dist_' and ' │ │ │ │ │ -00031bb0: 6e6f 6469 7374 5f27 2063 616e 2062 6520 nodist_' can be │ │ │ │ │ -00031bc0: 7573 6564 2074 6f20 636f 6e74 726f 6c20 used to control │ │ │ │ │ -00031bd0: 7768 6574 6865 720a 2020 2020 2066 696c whether. fil │ │ │ │ │ -00031be0: 6573 206c 6973 7465 6420 696e 2061 2027 es listed in a ' │ │ │ │ │ -00031bf0: 5f53 4f55 5243 4553 2720 7661 7269 6162 _SOURCES' variab │ │ │ │ │ -00031c00: 6c65 2061 7265 2064 6973 7472 6962 7574 le are distribut │ │ │ │ │ -00031c10: 6564 2e20 2027 6469 7374 5f27 2069 730a ed. 'dist_' is. │ │ │ │ │ -00031c20: 2020 2020 2072 6564 756e 6461 6e74 2c20 redundant, │ │ │ │ │ -00031c30: 6173 2073 6f75 7263 6573 2061 7265 2064 as sources are d │ │ │ │ │ -00031c40: 6973 7472 6962 7574 6564 2062 7920 6465 istributed by de │ │ │ │ │ -00031c50: 6661 756c 742c 2062 7574 2069 7420 6361 fault, but it ca │ │ │ │ │ -00031c60: 6e20 6265 0a20 2020 2020 7370 6563 6966 n be. specif │ │ │ │ │ -00031c70: 6965 6420 666f 7220 636c 6172 6974 7920 ied for clarity │ │ │ │ │ -00031c80: 6966 2064 6573 6972 6564 2e0a 0a20 2020 if desired... │ │ │ │ │ -00031c90: 2020 4974 2069 7320 706f 7373 6962 6c65 It is possible │ │ │ │ │ -00031ca0: 2074 6f20 6861 7665 2062 6f74 6820 2764 to have both 'd │ │ │ │ │ -00031cb0: 6973 745f 2720 616e 6420 276e 6f64 6973 ist_' and 'nodis │ │ │ │ │ -00031cc0: 745f 2720 7661 7269 616e 7473 206f 6620 t_' variants of │ │ │ │ │ -00031cd0: 610a 2020 2020 2067 6976 656e 2027 5f53 a. given '_S │ │ │ │ │ -00031ce0: 4f55 5243 4553 2720 7661 7269 6162 6c65 OURCES' variable │ │ │ │ │ -00031cf0: 2061 7420 6f6e 6365 3b20 7468 6973 206c at once; this l │ │ │ │ │ -00031d00: 6574 7320 796f 7520 6561 7369 6c79 2064 ets you easily d │ │ │ │ │ -00031d10: 6973 7472 6962 7574 650a 2020 2020 2073 istribute. s │ │ │ │ │ -00031d20: 6f6d 6520 6669 6c65 7320 616e 6420 6e6f ome files and no │ │ │ │ │ -00031d30: 7420 6f74 6865 7273 2c20 666f 7220 696e t others, for in │ │ │ │ │ -00031d40: 7374 616e 6365 3a0a 0a20 2020 2020 2020 stance:.. │ │ │ │ │ -00031d50: 2020 206e 6f64 6973 745f 6d61 7564 655f nodist_maude_ │ │ │ │ │ -00031d60: 534f 5552 4345 5320 3d20 6e6f 6469 7374 SOURCES = nodist │ │ │ │ │ -00031d70: 2e63 0a20 2020 2020 2020 2020 2064 6973 .c. dis │ │ │ │ │ -00031d80: 745f 6d61 7564 655f 534f 5552 4345 5320 t_maude_SOURCES │ │ │ │ │ -00031d90: 3d20 6469 7374 2d6d 652e 630a 0a20 2020 = dist-me.c.. │ │ │ │ │ -00031da0: 2020 4279 2064 6566 6175 6c74 2074 6865 By default the │ │ │ │ │ -00031db0: 206f 7574 7075 7420 6669 6c65 2028 6f6e output file (on │ │ │ │ │ -00031dc0: 2055 6e69 7820 7379 7374 656d 732c 2074 Unix systems, t │ │ │ │ │ -00031dd0: 6865 2027 2e6f 2720 6669 6c65 2920 7769 he '.o' file) wi │ │ │ │ │ -00031de0: 6c6c 2062 650a 2020 2020 2070 7574 2069 ll be. put i │ │ │ │ │ -00031df0: 6e74 6f20 7468 6520 6375 7272 656e 7420 nto the current │ │ │ │ │ -00031e00: 6275 696c 6420 6469 7265 6374 6f72 792e build directory. │ │ │ │ │ -00031e10: 2020 486f 7765 7665 722c 2069 6620 7468 However, if th │ │ │ │ │ -00031e20: 6520 6f70 7469 6f6e 0a20 2020 2020 2773 e option. 's │ │ │ │ │ -00031e30: 7562 6469 722d 6f62 6a65 6374 7327 2069 ubdir-objects' i │ │ │ │ │ -00031e40: 7320 696e 2065 6666 6563 7420 696e 2074 s in effect in t │ │ │ │ │ -00031e50: 6865 2063 7572 7265 6e74 2064 6972 6563 he current direc │ │ │ │ │ -00031e60: 746f 7279 2074 6865 6e20 7468 650a 2020 tory then the. │ │ │ │ │ -00031e70: 2020 2027 2e6f 2720 6669 6c65 2077 696c '.o' file wil │ │ │ │ │ -00031e80: 6c20 6265 2070 7574 2069 6e74 6f20 7468 l be put into th │ │ │ │ │ -00031e90: 6520 7375 6264 6972 6563 746f 7279 206e e subdirectory n │ │ │ │ │ -00031ea0: 616d 6564 2061 6674 6572 2074 6865 2073 amed after the s │ │ │ │ │ -00031eb0: 6f75 7263 650a 2020 2020 2066 696c 652e ource. file. │ │ │ │ │ -00031ec0: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ -00031ed0: 7769 7468 2027 7375 6264 6972 2d6f 626a with 'subdir-obj │ │ │ │ │ -00031ee0: 6563 7473 2720 656e 6162 6c65 642c 0a20 ects' enabled,. │ │ │ │ │ -00031ef0: 2020 2020 2773 7562 2f64 6972 2f66 696c 'sub/dir/fil │ │ │ │ │ -00031f00: 652e 6327 2077 696c 6c20 6265 2063 6f6d e.c' will be com │ │ │ │ │ -00031f10: 7069 6c65 6420 746f 2027 7375 622f 6469 piled to 'sub/di │ │ │ │ │ -00031f20: 722f 6669 6c65 2e6f 272e 2020 536f 6d65 r/file.o'. Some │ │ │ │ │ -00031f30: 2070 656f 706c 650a 2020 2020 2070 7265 people. pre │ │ │ │ │ -00031f40: 6665 7220 7468 6973 206d 6f64 6520 6f66 fer this mode of │ │ │ │ │ -00031f50: 206f 7065 7261 7469 6f6e 2e20 2059 6f75 operation. You │ │ │ │ │ -00031f60: 2063 616e 2073 7065 6369 6679 2027 7375 can specify 'su │ │ │ │ │ -00031f70: 6264 6972 2d6f 626a 6563 7473 2720 696e bdir-objects' in │ │ │ │ │ -00031f80: 0a20 2020 2020 2741 5554 4f4d 414b 455f . 'AUTOMAKE_ │ │ │ │ │ -00031f90: 4f50 5449 4f4e 5327 2028 2a6e 6f74 6520 OPTIONS' (*note │ │ │ │ │ -00031fa0: 4f70 7469 6f6e 733a 3a29 2e0a 0a27 4558 Options::)...'EX │ │ │ │ │ -00031fb0: 5452 415f 6d61 7564 655f 534f 5552 4345 TRA_maude_SOURCE │ │ │ │ │ -00031fc0: 5327 0a20 2020 2020 4175 746f 6d61 6b65 S'. Automake │ │ │ │ │ -00031fd0: 206e 6565 6473 2074 6f20 6b6e 6f77 2074 needs to know t │ │ │ │ │ -00031fe0: 6865 206c 6973 7420 6f66 2066 696c 6573 he list of files │ │ │ │ │ -00031ff0: 2079 6f75 2069 6e74 656e 6420 746f 2063 you intend to c │ │ │ │ │ -00032000: 6f6d 7069 6c65 0a20 2020 2020 5f73 7461 ompile. _sta │ │ │ │ │ -00032010: 7469 6361 6c6c 795f 2e20 2046 6f72 206f tically_. For o │ │ │ │ │ -00032020: 6e65 2074 6869 6e67 2c20 7468 6973 2069 ne thing, this i │ │ │ │ │ -00032030: 7320 7468 6520 6f6e 6c79 2077 6179 2041 s the only way A │ │ │ │ │ -00032040: 7574 6f6d 616b 6520 6861 7320 6f66 0a20 utomake has of. │ │ │ │ │ -00032050: 2020 2020 6b6e 6f77 696e 6720 7768 6174 knowing what │ │ │ │ │ -00032060: 2073 6f72 7420 6f66 206c 616e 6775 6167 sort of languag │ │ │ │ │ -00032070: 6520 7375 7070 6f72 7420 6120 6769 7665 e support a give │ │ │ │ │ -00032080: 6e20 274d 616b 6566 696c 652e 696e 270a n 'Makefile.in'. │ │ │ │ │ -00032090: 2020 2020 2072 6571 7569 7265 732e 2020 requires. │ │ │ │ │ -000320a0: 2831 2920 5468 6973 206d 6561 6e73 2074 (1) This means t │ │ │ │ │ -000320b0: 6861 742c 2066 6f72 2065 7861 6d70 6c65 hat, for example │ │ │ │ │ -000320c0: 2c20 796f 7520 6361 6e27 7420 7075 7420 , you can't put │ │ │ │ │ -000320d0: 610a 2020 2020 2063 6f6e 6669 6775 7265 a. configure │ │ │ │ │ -000320e0: 2073 7562 7374 6974 7574 696f 6e20 6c69 substitution li │ │ │ │ │ -000320f0: 6b65 2027 406d 795f 736f 7572 6365 7340 ke '@my_sources@ │ │ │ │ │ -00032100: 2720 696e 746f 2061 2027 5f53 4f55 5243 ' into a '_SOURC │ │ │ │ │ -00032110: 4553 270a 2020 2020 2076 6172 6961 626c ES'. variabl │ │ │ │ │ -00032120: 652e 2020 4966 2079 6f75 2069 6e74 656e e. If you inten │ │ │ │ │ -00032130: 6420 746f 2063 6f6e 6469 7469 6f6e 616c d to conditional │ │ │ │ │ -00032140: 6c79 2063 6f6d 7069 6c65 2073 6f75 7263 ly compile sourc │ │ │ │ │ -00032150: 6520 6669 6c65 7320 616e 640a 2020 2020 e files and. │ │ │ │ │ -00032160: 2075 7365 2027 636f 6e66 6967 7572 6527 use 'configure' │ │ │ │ │ -00032170: 2074 6f20 7375 6273 7469 7475 7465 2074 to substitute t │ │ │ │ │ -00032180: 6865 2061 7070 726f 7072 6961 7465 206f he appropriate o │ │ │ │ │ -00032190: 626a 6563 7420 6e61 6d65 7320 696e 746f bject names into │ │ │ │ │ -000321a0: 2c0a 2020 2020 2065 2e67 2e2c 2027 5f4c ,. e.g., '_L │ │ │ │ │ -000321b0: 4441 4444 2720 2873 6565 2062 656c 6f77 DADD' (see below │ │ │ │ │ -000321c0: 292c 2074 6865 6e20 796f 7520 7368 6f75 ), then you shou │ │ │ │ │ -000321d0: 6c64 206c 6973 7420 7468 6520 636f 7272 ld list the corr │ │ │ │ │ -000321e0: 6573 706f 6e64 696e 670a 2020 2020 2073 esponding. s │ │ │ │ │ -000321f0: 6f75 7263 6520 6669 6c65 7320 696e 2074 ource files in t │ │ │ │ │ -00032200: 6865 2027 4558 5452 415f 2720 7661 7269 he 'EXTRA_' vari │ │ │ │ │ -00032210: 6162 6c65 2e0a 0a20 2020 2020 5468 6973 able... This │ │ │ │ │ -00032220: 2076 6172 6961 626c 6520 616c 736f 2073 variable also s │ │ │ │ │ -00032230: 7570 706f 7274 7320 2764 6973 745f 2720 upports 'dist_' │ │ │ │ │ -00032240: 616e 6420 276e 6f64 6973 745f 2720 7072 and 'nodist_' pr │ │ │ │ │ -00032250: 6566 6978 6573 2e20 2046 6f72 0a20 2020 efixes. For. │ │ │ │ │ -00032260: 2020 696e 7374 616e 6365 2c20 276e 6f64 instance, 'nod │ │ │ │ │ -00032270: 6973 745f 4558 5452 415f 6d61 7564 655f ist_EXTRA_maude_ │ │ │ │ │ -00032280: 534f 5552 4345 5327 2077 6f75 6c64 206c SOURCES' would l │ │ │ │ │ -00032290: 6973 7420 6578 7472 6120 736f 7572 6365 ist extra source │ │ │ │ │ -000322a0: 730a 2020 2020 2074 6861 7420 6d61 7920 s. that may │ │ │ │ │ -000322b0: 6e65 6564 2074 6f20 6265 2062 7569 6c74 need to be built │ │ │ │ │ -000322c0: 2c20 6275 7420 7368 6f75 6c64 206e 6f74 , but should not │ │ │ │ │ -000322d0: 2062 6520 6469 7374 7269 6275 7465 642e be distributed. │ │ │ │ │ -000322e0: 0a0a 276d 6175 6465 5f41 5227 0a20 2020 ..'maude_AR'. │ │ │ │ │ -000322f0: 2020 4120 7374 6174 6963 206c 6962 7261 A static libra │ │ │ │ │ -00032300: 7279 2069 7320 6372 6561 7465 6420 6279 ry is created by │ │ │ │ │ -00032310: 2064 6566 6175 6c74 2062 7920 696e 766f default by invo │ │ │ │ │ -00032320: 6b69 6e67 2027 2428 4152 290a 2020 2020 king '$(AR). │ │ │ │ │ -00032330: 2024 2841 5246 4c41 4753 2927 2066 6f6c $(ARFLAGS)' fol │ │ │ │ │ -00032340: 6c6f 7765 6420 6279 2074 6865 206e 616d lowed by the nam │ │ │ │ │ -00032350: 6520 6f66 2074 6865 206c 6962 7261 7279 e of the library │ │ │ │ │ -00032360: 2061 6e64 2074 6865 6e20 7468 650a 2020 and then the. │ │ │ │ │ -00032370: 2020 206f 626a 6563 7473 2062 6569 6e67 objects being │ │ │ │ │ -00032380: 2070 7574 2069 6e74 6f20 7468 6520 6c69 put into the li │ │ │ │ │ -00032390: 6272 6172 792e 2020 596f 7520 6361 6e20 brary. You can │ │ │ │ │ -000323a0: 6f76 6572 7269 6465 2074 6869 7320 6279 override this by │ │ │ │ │ -000323b0: 0a20 2020 2020 7365 7474 696e 6720 7468 . setting th │ │ │ │ │ -000323c0: 6520 275f 4152 2720 7661 7269 6162 6c65 e '_AR' variable │ │ │ │ │ -000323d0: 2e20 2054 6869 7320 6973 2075 7375 616c . This is usual │ │ │ │ │ -000323e0: 6c79 2075 7365 6420 7769 7468 2043 2b2b ly used with C++ │ │ │ │ │ -000323f0: 3b20 736f 6d65 0a20 2020 2020 432b 2b20 ; some. C++ │ │ │ │ │ -00032400: 636f 6d70 696c 6572 7320 7265 7175 6972 compilers requir │ │ │ │ │ -00032410: 6520 6120 7370 6563 6961 6c20 696e 766f e a special invo │ │ │ │ │ -00032420: 6361 7469 6f6e 2069 6e20 6f72 6465 7220 cation in order │ │ │ │ │ -00032430: 746f 2069 6e73 7461 6e74 6961 7465 0a20 to instantiate. │ │ │ │ │ -00032440: 2020 2020 616c 6c20 7468 6520 7465 6d70 all the temp │ │ │ │ │ -00032450: 6c61 7465 7320 7468 6174 2073 686f 756c lates that shoul │ │ │ │ │ -00032460: 6420 676f 2069 6e74 6f20 6120 6c69 6272 d go into a libr │ │ │ │ │ -00032470: 6172 792e 2020 466f 7220 696e 7374 616e ary. For instan │ │ │ │ │ -00032480: 6365 2c20 7468 650a 2020 2020 2053 4749 ce, the. SGI │ │ │ │ │ -00032490: 2043 2b2b 2063 6f6d 7069 6c65 7220 6c69 C++ compiler li │ │ │ │ │ -000324a0: 6b65 7320 7468 6973 2076 6172 6961 626c kes this variabl │ │ │ │ │ -000324b0: 6520 7365 7420 6c69 6b65 2073 6f3a 0a20 e set like so:. │ │ │ │ │ -000324c0: 2020 2020 2020 2020 206c 6962 6d61 7564 libmaud │ │ │ │ │ -000324d0: 655f 615f 4152 203d 2024 2843 5858 2920 e_a_AR = $(CXX) │ │ │ │ │ -000324e0: 2d61 7220 2d6f 0a0a 276d 6175 6465 5f4c -ar -o..'maude_L │ │ │ │ │ -000324f0: 4942 4144 4427 0a20 2020 2020 4578 7472 IBADD'. Extr │ │ │ │ │ -00032500: 6120 6f62 6a65 6374 7320 6361 6e20 6265 a objects can be │ │ │ │ │ -00032510: 2061 6464 6564 2074 6f20 6120 5f6c 6962 added to a _lib │ │ │ │ │ -00032520: 7261 7279 5f20 7573 696e 6720 7468 6520 rary_ using the │ │ │ │ │ -00032530: 275f 4c49 4241 4444 270a 2020 2020 2076 '_LIBADD'. v │ │ │ │ │ -00032540: 6172 6961 626c 652e 2020 466f 7220 696e ariable. For in │ │ │ │ │ -00032550: 7374 616e 6365 2c20 7468 6973 2073 686f stance, this sho │ │ │ │ │ -00032560: 756c 6420 6265 2075 7365 6420 666f 7220 uld be used for │ │ │ │ │ -00032570: 6f62 6a65 6374 7320 6465 7465 726d 696e objects determin │ │ │ │ │ -00032580: 6564 0a20 2020 2020 6279 2027 636f 6e66 ed. by 'conf │ │ │ │ │ -00032590: 6967 7572 6527 2028 2a6e 6f74 6520 4120 igure' (*note A │ │ │ │ │ -000325a0: 4c69 6272 6172 793a 3a29 2e0a 0a20 2020 Library::)... │ │ │ │ │ -000325b0: 2020 496e 2074 6865 2063 6173 6520 6f66 In the case of │ │ │ │ │ -000325c0: 206c 6962 746f 6f6c 206c 6962 7261 7269 libtool librari │ │ │ │ │ -000325d0: 6573 2c20 276d 6175 6465 5f4c 4942 4144 es, 'maude_LIBAD │ │ │ │ │ -000325e0: 4427 2063 616e 2061 6c73 6f20 7265 6665 D' can also refe │ │ │ │ │ -000325f0: 7220 746f 0a20 2020 2020 6f74 6865 7220 r to. other │ │ │ │ │ -00032600: 6c69 6274 6f6f 6c20 6c69 6272 6172 6965 libtool librarie │ │ │ │ │ -00032610: 732e 0a0a 276d 6175 6465 5f4c 4441 4444 s...'maude_LDADD │ │ │ │ │ -00032620: 270a 2020 2020 2045 7874 7261 206f 626a '. Extra obj │ │ │ │ │ -00032630: 6563 7473 2028 272a 2e24 284f 424a 4558 ects ('*.$(OBJEX │ │ │ │ │ -00032640: 5429 2729 2061 6e64 206c 6962 7261 7269 T)') and librari │ │ │ │ │ -00032650: 6573 2028 272a 2e61 272c 2027 2a2e 6c61 es ('*.a', '*.la │ │ │ │ │ -00032660: 2729 2063 616e 2062 650a 2020 2020 2061 ') can be. a │ │ │ │ │ -00032670: 6464 6564 2074 6f20 6120 5f70 726f 6772 dded to a _progr │ │ │ │ │ -00032680: 616d 5f20 6279 206c 6973 7469 6e67 2074 am_ by listing t │ │ │ │ │ -00032690: 6865 6d20 696e 2074 6865 2027 5f4c 4441 hem in the '_LDA │ │ │ │ │ -000326a0: 4444 2720 7661 7269 6162 6c65 2e20 2046 DD' variable. F │ │ │ │ │ -000326b0: 6f72 0a20 2020 2020 696e 7374 616e 6365 or. instance │ │ │ │ │ -000326c0: 2c20 7468 6973 2073 686f 756c 6420 6265 , this should be │ │ │ │ │ -000326d0: 2075 7365 6420 666f 7220 6f62 6a65 6374 used for object │ │ │ │ │ -000326e0: 7320 6465 7465 726d 696e 6564 2062 7920 s determined by │ │ │ │ │ -000326f0: 2763 6f6e 6669 6775 7265 270a 2020 2020 'configure'. │ │ │ │ │ -00032700: 2028 2a6e 6f74 6520 4c69 6e6b 696e 673a (*note Linking: │ │ │ │ │ -00032710: 3a29 2e0a 0a20 2020 2020 275f 4c44 4144 :)... '_LDAD │ │ │ │ │ -00032720: 4427 2061 6e64 2027 5f4c 4942 4144 4427 D' and '_LIBADD' │ │ │ │ │ -00032730: 2061 7265 2069 6e61 7070 726f 7072 6961 are inappropria │ │ │ │ │ -00032740: 7465 2066 6f72 2070 6173 7369 6e67 0a20 te for passing. │ │ │ │ │ -00032750: 2020 2020 7072 6f67 7261 6d2d 7370 6563 program-spec │ │ │ │ │ -00032760: 6966 6963 206c 696e 6b65 7220 666c 6167 ific linker flag │ │ │ │ │ -00032770: 7320 2865 7863 6570 7420 666f 7220 272d s (except for '- │ │ │ │ │ -00032780: 6c27 2c20 272d 4c27 2c20 272d 646c 6f70 l', '-L', '-dlop │ │ │ │ │ -00032790: 656e 2720 616e 640a 2020 2020 2027 2d64 en' and. '-d │ │ │ │ │ -000327a0: 6c70 7265 6f70 656e 2729 2e20 2055 7365 lpreopen'). Use │ │ │ │ │ -000327b0: 2074 6865 2027 5f4c 4446 4c41 4753 2720 the '_LDFLAGS' │ │ │ │ │ -000327c0: 7661 7269 6162 6c65 2066 6f72 2074 6869 variable for thi │ │ │ │ │ -000327d0: 7320 7075 7270 6f73 652e 0a0a 2020 2020 s purpose... │ │ │ │ │ -000327e0: 2046 6f72 2069 6e73 7461 6e63 652c 2069 For instance, i │ │ │ │ │ -000327f0: 6620 796f 7572 2027 636f 6e66 6967 7572 f your 'configur │ │ │ │ │ -00032800: 652e 6163 2720 7573 6573 2027 4143 5f50 e.ac' uses 'AC_P │ │ │ │ │ -00032810: 4154 485f 5854 5241 272c 2079 6f75 2063 ATH_XTRA', you c │ │ │ │ │ -00032820: 6f75 6c64 0a20 2020 2020 6c69 6e6b 2079 ould. link y │ │ │ │ │ -00032830: 6f75 7220 7072 6f67 7261 6d20 6167 6169 our program agai │ │ │ │ │ -00032840: 6e73 7420 7468 6520 5820 6c69 6272 6172 nst the X librar │ │ │ │ │ -00032850: 6965 7320 6c69 6b65 2073 6f3a 0a0a 2020 ies like so:.. │ │ │ │ │ -00032860: 2020 2020 2020 2020 6d61 7564 655f 4c44 maude_LD │ │ │ │ │ -00032870: 4144 4420 3d20 2428 585f 5052 455f 4c49 ADD = $(X_PRE_LI │ │ │ │ │ -00032880: 4253 2920 2428 585f 4c49 4253 2920 2428 BS) $(X_LIBS) $( │ │ │ │ │ -00032890: 585f 4558 5452 415f 4c49 4253 290a 0a20 X_EXTRA_LIBS).. │ │ │ │ │ -000328a0: 2020 2020 5765 2072 6563 6f6d 6d65 6e64 We recommend │ │ │ │ │ -000328b0: 2074 6861 7420 796f 7520 7573 6520 272d that you use '- │ │ │ │ │ -000328c0: 6c27 2061 6e64 2027 2d4c 2720 6f6e 6c79 l' and '-L' only │ │ │ │ │ -000328d0: 2077 6865 6e20 7265 6665 7272 696e 6720 when referring │ │ │ │ │ -000328e0: 746f 0a20 2020 2020 7468 6972 642d 7061 to. third-pa │ │ │ │ │ -000328f0: 7274 7920 6c69 6272 6172 6965 732c 2061 rty libraries, a │ │ │ │ │ -00032900: 6e64 2067 6976 6520 7468 6520 6578 706c nd give the expl │ │ │ │ │ -00032910: 6963 6974 2066 696c 6520 6e61 6d65 7320 icit file names │ │ │ │ │ -00032920: 6f66 2061 6e79 0a20 2020 2020 6c69 6272 of any. libr │ │ │ │ │ -00032930: 6172 7920 6275 696c 7420 6279 2079 6f75 ary built by you │ │ │ │ │ -00032940: 7220 7061 636b 6167 652e 2020 446f 696e r package. Doin │ │ │ │ │ -00032950: 6720 736f 2077 696c 6c20 656e 7375 7265 g so will ensure │ │ │ │ │ -00032960: 2074 6861 740a 2020 2020 2027 6d61 7564 that. 'maud │ │ │ │ │ -00032970: 655f 4445 5045 4e44 454e 4349 4553 2720 e_DEPENDENCIES' │ │ │ │ │ -00032980: 2873 6565 2062 656c 6f77 2920 6973 2063 (see below) is c │ │ │ │ │ -00032990: 6f72 7265 6374 6c79 2064 6566 696e 6564 orrectly defined │ │ │ │ │ -000329a0: 2062 7920 6465 6661 756c 742e 0a0a 276d by default...'m │ │ │ │ │ -000329b0: 6175 6465 5f4c 4446 4c41 4753 270a 2020 aude_LDFLAGS'. │ │ │ │ │ -000329c0: 2020 2054 6869 7320 7661 7269 6162 6c65 This variable │ │ │ │ │ -000329d0: 2069 7320 7573 6564 2074 6f20 7061 7373 is used to pass │ │ │ │ │ -000329e0: 2065 7874 7261 2066 6c61 6773 2074 6f20 extra flags to │ │ │ │ │ -000329f0: 7468 6520 6c69 6e6b 2073 7465 7020 6f66 the link step of │ │ │ │ │ -00032a00: 2061 0a20 2020 2020 7072 6f67 7261 6d20 a. program │ │ │ │ │ -00032a10: 6f72 2061 2073 6861 7265 6420 6c69 6272 or a shared libr │ │ │ │ │ -00032a20: 6172 792e 2020 4974 206f 7665 7272 6964 ary. It overrid │ │ │ │ │ -00032a30: 6573 2074 6865 2027 414d 5f4c 4446 4c41 es the 'AM_LDFLA │ │ │ │ │ -00032a40: 4753 270a 2020 2020 2076 6172 6961 626c GS'. variabl │ │ │ │ │ -00032a50: 652e 0a0a 276d 6175 6465 5f4c 4942 544f e...'maude_LIBTO │ │ │ │ │ -00032a60: 4f4c 464c 4147 5327 0a20 2020 2020 5468 OLFLAGS'. Th │ │ │ │ │ -00032a70: 6973 2076 6172 6961 626c 6520 6973 2075 is variable is u │ │ │ │ │ -00032a80: 7365 6420 746f 2070 6173 7320 6578 7472 sed to pass extr │ │ │ │ │ -00032a90: 6120 6f70 7469 6f6e 7320 746f 2027 6c69 a options to 'li │ │ │ │ │ -00032aa0: 6274 6f6f 6c27 2e20 2049 740a 2020 2020 btool'. It. │ │ │ │ │ -00032ab0: 206f 7665 7272 6964 6573 2074 6865 2027 overrides the ' │ │ │ │ │ -00032ac0: 414d 5f4c 4942 544f 4f4c 464c 4147 5327 AM_LIBTOOLFLAGS' │ │ │ │ │ -00032ad0: 2076 6172 6961 626c 652e 2020 5468 6573 variable. Thes │ │ │ │ │ -00032ae0: 6520 6f70 7469 6f6e 7320 6172 6520 6f75 e options are ou │ │ │ │ │ -00032af0: 7470 7574 0a20 2020 2020 6265 666f 7265 tput. before │ │ │ │ │ -00032b00: 2027 6c69 6274 6f6f 6c27 2773 2027 2d2d 'libtool''s '-- │ │ │ │ │ -00032b10: 6d6f 6465 3d4d 4f44 4527 206f 7074 696f mode=MODE' optio │ │ │ │ │ -00032b20: 6e2c 2073 6f20 7468 6579 2073 686f 756c n, so they shoul │ │ │ │ │ -00032b30: 6420 6e6f 7420 6265 0a20 2020 2020 6d6f d not be. mo │ │ │ │ │ -00032b40: 6465 2d73 7065 6369 6669 6320 6f70 7469 de-specific opti │ │ │ │ │ -00032b50: 6f6e 7320 2874 686f 7365 2062 656c 6f6e ons (those belon │ │ │ │ │ -00032b60: 6720 746f 2074 6865 2063 6f6d 7069 6c65 g to the compile │ │ │ │ │ -00032b70: 7220 6f72 206c 696e 6b65 720a 2020 2020 r or linker. │ │ │ │ │ -00032b80: 2066 6c61 6773 292e 2020 2a4e 6f74 6520 flags). *Note │ │ │ │ │ -00032b90: 4c69 6274 6f6f 6c20 466c 6167 733a 3a2e Libtool Flags::. │ │ │ │ │ -00032ba0: 0a0a 276d 6175 6465 5f44 4550 454e 4445 ..'maude_DEPENDE │ │ │ │ │ -00032bb0: 4e43 4945 5327 0a27 4558 5452 415f 6d61 NCIES'.'EXTRA_ma │ │ │ │ │ -00032bc0: 7564 655f 4445 5045 4e44 454e 4349 4553 ude_DEPENDENCIES │ │ │ │ │ -00032bd0: 270a 2020 2020 2049 7420 6973 2061 6c73 '. It is als │ │ │ │ │ -00032be0: 6f20 6f63 6361 7369 6f6e 616c 6c79 2075 o occasionally u │ │ │ │ │ -00032bf0: 7365 6675 6c20 746f 2068 6176 6520 6120 seful to have a │ │ │ │ │ -00032c00: 7461 7267 6574 2028 7072 6f67 7261 6d20 target (program │ │ │ │ │ -00032c10: 6f72 0a20 2020 2020 6c69 6272 6172 7929 or. library) │ │ │ │ │ -00032c20: 2064 6570 656e 6420 6f6e 2073 6f6d 6520 depend on some │ │ │ │ │ -00032c30: 6f74 6865 7220 6669 6c65 2074 6861 7420 other file that │ │ │ │ │ -00032c40: 6973 206e 6f74 2061 6374 7561 6c6c 7920 is not actually │ │ │ │ │ -00032c50: 7061 7274 206f 660a 2020 2020 2074 6861 part of. tha │ │ │ │ │ -00032c60: 7420 7461 7267 6574 2e20 2054 6869 7320 t target. This │ │ │ │ │ -00032c70: 6361 6e20 6265 2064 6f6e 6520 7573 696e can be done usin │ │ │ │ │ -00032c80: 6720 7468 6520 275f 4445 5045 4e44 454e g the '_DEPENDEN │ │ │ │ │ -00032c90: 4349 4553 2720 7661 7269 6162 6c65 2e0a CIES' variable.. │ │ │ │ │ -00032ca0: 2020 2020 2045 6163 6820 7461 7267 6574 Each target │ │ │ │ │ -00032cb0: 2064 6570 656e 6473 206f 6e20 7468 6520 depends on the │ │ │ │ │ -00032cc0: 636f 6e74 656e 7473 206f 6620 7375 6368 contents of such │ │ │ │ │ -00032cd0: 2061 2076 6172 6961 626c 652c 2062 7574 a variable, but │ │ │ │ │ -00032ce0: 206e 6f0a 2020 2020 2066 7572 7468 6572 no. further │ │ │ │ │ -00032cf0: 2069 6e74 6572 7072 6574 6174 696f 6e20 interpretation │ │ │ │ │ -00032d00: 6973 2064 6f6e 652e 0a0a 2020 2020 2053 is done... S │ │ │ │ │ -00032d10: 696e 6365 2074 6865 7365 2064 6570 656e ince these depen │ │ │ │ │ -00032d20: 6465 6e63 6965 7320 6172 6520 6173 736f dencies are asso │ │ │ │ │ -00032d30: 6369 6174 6564 2074 6f20 7468 6520 6c69 ciated to the li │ │ │ │ │ -00032d40: 6e6b 2072 756c 6520 7573 6564 2074 6f0a nk rule used to. │ │ │ │ │ -00032d50: 2020 2020 2063 7265 6174 6520 7468 6520 create the │ │ │ │ │ -00032d60: 7072 6f67 7261 6d73 2074 6865 7920 7368 programs they sh │ │ │ │ │ -00032d70: 6f75 6c64 206e 6f72 6d61 6c6c 7920 6c69 ould normally li │ │ │ │ │ -00032d80: 7374 2066 696c 6573 2075 7365 6420 6279 st files used by │ │ │ │ │ -00032d90: 2074 6865 0a20 2020 2020 6c69 6e6b 2063 the. link c │ │ │ │ │ -00032da0: 6f6d 6d61 6e64 2e20 2054 6861 7420 6973 ommand. That is │ │ │ │ │ -00032db0: 2027 2a2e 2428 4f42 4a45 5854 2927 2c20 '*.$(OBJEXT)', │ │ │ │ │ -00032dc0: 272a 2e61 272c 206f 7220 272a 2e6c 6127 '*.a', or '*.la' │ │ │ │ │ -00032dd0: 2066 696c 6573 2066 6f72 0a20 2020 2020 files for. │ │ │ │ │ -00032de0: 7072 6f67 7261 6d73 3b20 272a 2e6c 6f27 programs; '*.lo' │ │ │ │ │ -00032df0: 2061 6e64 2027 2a2e 6c61 2720 6669 6c65 and '*.la' file │ │ │ │ │ -00032e00: 7320 666f 7220 4c69 6274 6f6f 6c20 6c69 s for Libtool li │ │ │ │ │ -00032e10: 6272 6172 6965 733b 2061 6e64 0a20 2020 braries; and. │ │ │ │ │ -00032e20: 2020 272a 2e24 284f 424a 4558 5429 2720 '*.$(OBJEXT)' │ │ │ │ │ -00032e30: 6669 6c65 7320 666f 7220 7374 6174 6963 files for static │ │ │ │ │ -00032e40: 206c 6962 7261 7269 6573 2e20 2049 6e20 libraries. In │ │ │ │ │ -00032e50: 7261 7265 2063 6173 6573 2079 6f75 206d rare cases you m │ │ │ │ │ -00032e60: 6179 0a20 2020 2020 6e65 6564 2074 6f20 ay. need to │ │ │ │ │ -00032e70: 6164 6420 6f74 6865 7220 6b69 6e64 7320 add other kinds │ │ │ │ │ -00032e80: 6f66 2066 696c 6573 2073 7563 6820 6173 of files such as │ │ │ │ │ -00032e90: 206c 696e 6b65 7220 7363 7269 7074 732c linker scripts, │ │ │ │ │ -00032ea0: 2062 7574 0a20 2020 2020 5f6c 6973 7469 but. _listi │ │ │ │ │ -00032eb0: 6e67 2061 2073 6f75 7263 6520 6669 6c65 ng a source file │ │ │ │ │ -00032ec0: 2069 6e20 275f 4445 5045 4e44 454e 4349 in '_DEPENDENCI │ │ │ │ │ -00032ed0: 4553 2720 6973 2077 726f 6e67 5f2e 2020 ES' is wrong_. │ │ │ │ │ -00032ee0: 4966 2073 6f6d 650a 2020 2020 2073 6f75 If some. sou │ │ │ │ │ -00032ef0: 7263 6520 6669 6c65 206e 6565 6473 2074 rce file needs t │ │ │ │ │ -00032f00: 6f20 6265 2062 7569 6c74 2062 6566 6f72 o be built befor │ │ │ │ │ -00032f10: 6520 616c 6c20 7468 6520 636f 6d70 6f6e e all the compon │ │ │ │ │ -00032f20: 656e 7473 206f 6620 610a 2020 2020 2070 ents of a. p │ │ │ │ │ -00032f30: 726f 6772 616d 2061 7265 2062 7569 6c74 rogram are built │ │ │ │ │ -00032f40: 2c20 636f 6e73 6964 6572 2075 7369 6e67 , consider using │ │ │ │ │ -00032f50: 2074 6865 2027 4255 494c 545f 534f 5552 the 'BUILT_SOUR │ │ │ │ │ -00032f60: 4345 5327 2076 6172 6961 626c 650a 2020 CES' variable. │ │ │ │ │ -00032f70: 2020 2028 2a6e 6f74 6520 536f 7572 6365 (*note Source │ │ │ │ │ -00032f80: 733a 3a29 2e0a 0a20 2020 2020 4966 2027 s::)... If ' │ │ │ │ │ -00032f90: 5f44 4550 454e 4445 4e43 4945 5327 2069 _DEPENDENCIES' i │ │ │ │ │ -00032fa0: 7320 6e6f 7420 7375 7070 6c69 6564 2c20 s not supplied, │ │ │ │ │ -00032fb0: 6974 2069 7320 636f 6d70 7574 6564 2062 it is computed b │ │ │ │ │ -00032fc0: 7920 4175 746f 6d61 6b65 2e0a 2020 2020 y Automake.. │ │ │ │ │ -00032fd0: 2054 6865 2061 7574 6f6d 6174 6963 616c The automatical │ │ │ │ │ -00032fe0: 6c79 2d61 7373 6967 6e65 6420 7661 6c75 ly-assigned valu │ │ │ │ │ -00032ff0: 6520 6973 2074 6865 2063 6f6e 7465 6e74 e is the content │ │ │ │ │ -00033000: 7320 6f66 2027 5f4c 4441 4444 2720 6f72 s of '_LDADD' or │ │ │ │ │ -00033010: 0a20 2020 2020 275f 4c49 4241 4444 272c . '_LIBADD', │ │ │ │ │ -00033020: 2077 6974 6820 6d6f 7374 2063 6f6e 6669 with most confi │ │ │ │ │ -00033030: 6775 7265 2073 7562 7374 6974 7574 696f gure substitutio │ │ │ │ │ -00033040: 6e73 2c20 272d 6c27 2c20 272d 4c27 2c20 ns, '-l', '-L', │ │ │ │ │ -00033050: 272d 646c 6f70 656e 270a 2020 2020 2061 '-dlopen'. a │ │ │ │ │ -00033060: 6e64 2027 2d64 6c70 7265 6f70 656e 2720 nd '-dlpreopen' │ │ │ │ │ -00033070: 6f70 7469 6f6e 7320 7265 6d6f 7665 642e options removed. │ │ │ │ │ -00033080: 2020 5468 6520 636f 6e66 6967 7572 6520 The configure │ │ │ │ │ -00033090: 7375 6273 7469 7475 7469 6f6e 7320 7468 substitutions th │ │ │ │ │ -000330a0: 6174 0a20 2020 2020 6172 6520 6c65 6674 at. are left │ │ │ │ │ -000330b0: 2069 6e20 6172 6520 6f6e 6c79 2027 2428 in are only '$( │ │ │ │ │ -000330c0: 4c49 424f 424a 5329 2720 616e 6420 2724 LIBOBJS)' and '$ │ │ │ │ │ -000330d0: 2841 4c4c 4f43 4129 273b 2074 6865 7365 (ALLOCA)'; these │ │ │ │ │ -000330e0: 2061 7265 206c 6566 740a 2020 2020 2062 are left. b │ │ │ │ │ -000330f0: 6563 6175 7365 2069 7420 6973 206b 6e6f ecause it is kno │ │ │ │ │ -00033100: 776e 2074 6861 7420 7468 6579 2077 696c wn that they wil │ │ │ │ │ -00033110: 6c20 6e6f 7420 6361 7573 6520 616e 2069 l not cause an i │ │ │ │ │ -00033120: 6e76 616c 6964 2076 616c 7565 2066 6f72 nvalid value for │ │ │ │ │ -00033130: 0a20 2020 2020 275f 4445 5045 4e44 454e . '_DEPENDEN │ │ │ │ │ -00033140: 4349 4553 2720 746f 2062 6520 6765 6e65 CIES' to be gene │ │ │ │ │ -00033150: 7261 7465 642e 0a0a 2020 2020 2027 5f44 rated... '_D │ │ │ │ │ -00033160: 4550 454e 4445 4e43 4945 5327 2069 7320 EPENDENCIES' is │ │ │ │ │ -00033170: 6d6f 7265 206c 696b 656c 7920 7573 6564 more likely used │ │ │ │ │ -00033180: 2074 6f20 7065 7266 6f72 6d20 636f 6e64 to perform cond │ │ │ │ │ -00033190: 6974 696f 6e61 6c0a 2020 2020 2063 6f6d itional. com │ │ │ │ │ -000331a0: 7069 6c61 7469 6f6e 2075 7369 6e67 2061 pilation using a │ │ │ │ │ -000331b0: 6e20 2741 435f 5355 4253 5427 2076 6172 n 'AC_SUBST' var │ │ │ │ │ -000331c0: 6961 626c 6520 7468 6174 2063 6f6e 7461 iable that conta │ │ │ │ │ -000331d0: 696e 7320 6120 6c69 7374 206f 660a 2020 ins a list of. │ │ │ │ │ -000331e0: 2020 206f 626a 6563 7473 2e20 202a 4e6f objects. *No │ │ │ │ │ -000331f0: 7465 2043 6f6e 6469 7469 6f6e 616c 2053 te Conditional S │ │ │ │ │ -00033200: 6f75 7263 6573 3a3a 2c20 616e 6420 2a6e ources::, and *n │ │ │ │ │ -00033210: 6f74 6520 436f 6e64 6974 696f 6e61 6c0a ote Conditional. │ │ │ │ │ -00033220: 2020 2020 204c 6962 746f 6f6c 2053 6f75 Libtool Sou │ │ │ │ │ -00033230: 7263 6573 3a3a 2e0a 0a20 2020 2020 5468 rces::... Th │ │ │ │ │ -00033240: 6520 2745 5854 5241 5f2a 5f44 4550 454e e 'EXTRA_*_DEPEN │ │ │ │ │ -00033250: 4445 4e43 4945 5327 2076 6172 6961 626c DENCIES' variabl │ │ │ │ │ -00033260: 6520 6d61 7920 6265 2075 7365 6675 6c20 e may be useful │ │ │ │ │ -00033270: 666f 7220 6361 7365 7320 7768 6572 650a for cases where. │ │ │ │ │ -00033280: 2020 2020 2079 6f75 206d 6572 656c 7920 you merely │ │ │ │ │ -00033290: 7761 6e74 2074 6f20 6175 676d 656e 7420 want to augment │ │ │ │ │ -000332a0: 7468 6520 2761 7574 6f6d 616b 6527 2d67 the 'automake'-g │ │ │ │ │ -000332b0: 656e 6572 6174 6564 2027 5f44 4550 454e enerated '_DEPEN │ │ │ │ │ -000332c0: 4445 4e43 4945 5327 0a20 2020 2020 7661 DENCIES'. va │ │ │ │ │ -000332d0: 7269 6162 6c65 2072 6174 6865 7220 7468 riable rather th │ │ │ │ │ -000332e0: 616e 2072 6570 6c61 6369 6e67 2069 742e an replacing it. │ │ │ │ │ -000332f0: 0a0a 276d 6175 6465 5f4c 494e 4b27 0a20 ..'maude_LINK'. │ │ │ │ │ -00033300: 2020 2020 596f 7520 6361 6e20 6f76 6572 You can over │ │ │ │ │ -00033310: 7269 6465 2074 6865 206c 696e 6b65 7220 ride the linker │ │ │ │ │ -00033320: 6f6e 2061 2070 6572 2d70 726f 6772 616d on a per-program │ │ │ │ │ -00033330: 2062 6173 6973 2e20 2042 7920 6465 6661 basis. By defa │ │ │ │ │ -00033340: 756c 7420 7468 650a 2020 2020 206c 696e ult the. lin │ │ │ │ │ -00033350: 6b65 7220 6973 2063 686f 7365 6e20 6163 ker is chosen ac │ │ │ │ │ -00033360: 636f 7264 696e 6720 746f 2074 6865 206c cording to the l │ │ │ │ │ -00033370: 616e 6775 6167 6573 2075 7365 6420 6279 anguages used by │ │ │ │ │ -00033380: 2074 6865 2070 726f 6772 616d 2e0a 2020 the program.. │ │ │ │ │ -00033390: 2020 2046 6f72 2069 6e73 7461 6e63 652c For instance, │ │ │ │ │ -000333a0: 2061 2070 726f 6772 616d 2074 6861 7420 a program that │ │ │ │ │ -000333b0: 696e 636c 7564 6573 2043 2b2b 2073 6f75 includes C++ sou │ │ │ │ │ -000333c0: 7263 6520 636f 6465 2077 6f75 6c64 2075 rce code would u │ │ │ │ │ -000333d0: 7365 2074 6865 0a20 2020 2020 432b 2b20 se the. C++ │ │ │ │ │ -000333e0: 636f 6d70 696c 6572 2074 6f20 6c69 6e6b compiler to link │ │ │ │ │ -000333f0: 2e20 2054 6865 2027 5f4c 494e 4b27 2076 . The '_LINK' v │ │ │ │ │ -00033400: 6172 6961 626c 6520 6d75 7374 2068 6f6c ariable must hol │ │ │ │ │ -00033410: 6420 7468 6520 6e61 6d65 206f 6620 610a d the name of a. │ │ │ │ │ -00033420: 2020 2020 2063 6f6d 6d61 6e64 2074 6861 command tha │ │ │ │ │ -00033430: 7420 6361 6e20 6265 2070 6173 7365 6420 t can be passed │ │ │ │ │ -00033440: 616c 6c20 7468 6520 272e 6f27 2066 696c all the '.o' fil │ │ │ │ │ -00033450: 6520 6e61 6d65 7320 616e 6420 6c69 6272 e names and libr │ │ │ │ │ -00033460: 6172 6965 7320 746f 0a20 2020 2020 6c69 aries to. li │ │ │ │ │ -00033470: 6e6b 2061 6761 696e 7374 2061 7320 6172 nk against as ar │ │ │ │ │ -00033480: 6775 6d65 6e74 732e 2020 4e6f 7465 2074 guments. Note t │ │ │ │ │ -00033490: 6861 7420 7468 6520 6e61 6d65 206f 6620 hat the name of │ │ │ │ │ -000334a0: 7468 6520 756e 6465 726c 7969 6e67 0a20 the underlying. │ │ │ │ │ -000334b0: 2020 2020 7072 6f67 7261 6d20 6973 205f program is _ │ │ │ │ │ -000334c0: 6e6f 745f 2070 6173 7365 6420 746f 2027 not_ passed to ' │ │ │ │ │ -000334d0: 5f4c 494e 4b27 3b20 7479 7069 6361 6c6c _LINK'; typicall │ │ │ │ │ -000334e0: 7920 6f6e 6520 7573 6573 2027 2440 273a y one uses '$@': │ │ │ │ │ -000334f0: 0a0a 2020 2020 2020 2020 2020 6d61 7564 .. maud │ │ │ │ │ -00033500: 655f 4c49 4e4b 203d 2024 2843 434c 4429 e_LINK = $(CCLD) │ │ │ │ │ -00033510: 202d 6d61 6769 6320 2d6f 2024 400a 0a20 -magic -o $@.. │ │ │ │ │ -00033520: 2020 2020 4966 2061 2027 5f4c 494e 4b27 If a '_LINK' │ │ │ │ │ -00033530: 2076 6172 6961 626c 6520 6973 206e 6f74 variable is not │ │ │ │ │ -00033540: 2073 7570 706c 6965 642c 2069 7420 6d61 supplied, it ma │ │ │ │ │ -00033550: 7920 7374 696c 6c20 6265 2067 656e 6572 y still be gener │ │ │ │ │ -00033560: 6174 6564 0a20 2020 2020 616e 6420 7573 ated. and us │ │ │ │ │ -00033570: 6564 2062 7920 4175 746f 6d61 6b65 2064 ed by Automake d │ │ │ │ │ -00033580: 7565 2074 6f20 7468 6520 7573 6520 6f66 ue to the use of │ │ │ │ │ -00033590: 2070 6572 2d74 6172 6765 7420 6c69 6e6b per-target link │ │ │ │ │ -000335a0: 2066 6c61 6773 2073 7563 680a 2020 2020 flags such. │ │ │ │ │ -000335b0: 2061 7320 275f 4346 4c41 4753 272c 2027 as '_CFLAGS', ' │ │ │ │ │ -000335c0: 5f4c 4446 4c41 4753 2720 6f72 2027 5f4c _LDFLAGS' or '_L │ │ │ │ │ -000335d0: 4942 544f 4f4c 464c 4147 5327 2c20 696e IBTOOLFLAGS', in │ │ │ │ │ -000335e0: 2063 6173 6573 2077 6865 7265 2074 6865 cases where the │ │ │ │ │ -000335f0: 790a 2020 2020 2061 7070 6c79 2e0a 0a27 y. apply...' │ │ │ │ │ -00033600: 6d61 7564 655f 4343 4153 464c 4147 5327 maude_CCASFLAGS' │ │ │ │ │ -00033610: 0a27 6d61 7564 655f 4346 4c41 4753 270a .'maude_CFLAGS'. │ │ │ │ │ -00033620: 276d 6175 6465 5f43 5050 464c 4147 5327 'maude_CPPFLAGS' │ │ │ │ │ -00033630: 0a27 6d61 7564 655f 4358 5846 4c41 4753 .'maude_CXXFLAGS │ │ │ │ │ -00033640: 270a 276d 6175 6465 5f46 464c 4147 5327 '.'maude_FFLAGS' │ │ │ │ │ -00033650: 0a27 6d61 7564 655f 4743 4a46 4c41 4753 .'maude_GCJFLAGS │ │ │ │ │ -00033660: 270a 276d 6175 6465 5f4c 464c 4147 5327 '.'maude_LFLAGS' │ │ │ │ │ -00033670: 0a27 6d61 7564 655f 4f42 4a43 464c 4147 .'maude_OBJCFLAG │ │ │ │ │ -00033680: 5327 0a27 6d61 7564 655f 5246 4c41 4753 S'.'maude_RFLAGS │ │ │ │ │ -00033690: 270a 276d 6175 6465 5f55 5043 464c 4147 '.'maude_UPCFLAG │ │ │ │ │ -000336a0: 5327 0a27 6d61 7564 655f 5946 4c41 4753 S'.'maude_YFLAGS │ │ │ │ │ -000336b0: 270a 2020 2020 2041 7574 6f6d 616b 6520 '. Automake │ │ │ │ │ -000336c0: 616c 6c6f 7773 2079 6f75 2074 6f20 7365 allows you to se │ │ │ │ │ -000336d0: 7420 636f 6d70 696c 6174 696f 6e20 666c t compilation fl │ │ │ │ │ -000336e0: 6167 7320 6f6e 2061 2070 6572 2d70 726f ags on a per-pro │ │ │ │ │ -000336f0: 6772 616d 2028 6f72 0a20 2020 2020 7065 gram (or. pe │ │ │ │ │ -00033700: 722d 6c69 6272 6172 7929 2062 6173 6973 r-library) basis │ │ │ │ │ -00033710: 2e20 2041 2073 696e 676c 6520 736f 7572 . A single sour │ │ │ │ │ -00033720: 6365 2066 696c 6520 6361 6e20 6265 2069 ce file can be i │ │ │ │ │ -00033730: 6e63 6c75 6465 6420 696e 0a20 2020 2020 ncluded in. │ │ │ │ │ -00033740: 7365 7665 7261 6c20 7072 6f67 7261 6d73 several programs │ │ │ │ │ -00033750: 2c20 616e 6420 6974 2077 696c 6c20 706f , and it will po │ │ │ │ │ -00033760: 7465 6e74 6961 6c6c 7920 6265 2063 6f6d tentially be com │ │ │ │ │ -00033770: 7069 6c65 6420 7769 7468 0a20 2020 2020 piled with. │ │ │ │ │ -00033780: 6469 6666 6572 656e 7420 666c 6167 7320 different flags │ │ │ │ │ -00033790: 666f 7220 6561 6368 2070 726f 6772 616d for each program │ │ │ │ │ -000337a0: 2e20 2054 6869 7320 776f 726b 7320 666f . This works fo │ │ │ │ │ -000337b0: 7220 616e 7920 6c61 6e67 7561 6765 0a20 r any language. │ │ │ │ │ -000337c0: 2020 2020 6469 7265 6374 6c79 2073 7570 directly sup │ │ │ │ │ -000337d0: 706f 7274 6564 2062 7920 4175 746f 6d61 ported by Automa │ │ │ │ │ -000337e0: 6b65 2e20 2054 6865 7365 2022 7065 722d ke. These "per- │ │ │ │ │ -000337f0: 7461 7267 6574 2063 6f6d 7069 6c61 7469 target compilati │ │ │ │ │ -00033800: 6f6e 0a20 2020 2020 666c 6167 7322 2061 on. flags" a │ │ │ │ │ -00033810: 7265 2027 5f43 4341 5346 4c41 4753 272c re '_CCASFLAGS', │ │ │ │ │ -00033820: 2027 5f43 464c 4147 5327 2c20 275f 4350 '_CFLAGS', '_CP │ │ │ │ │ -00033830: 5046 4c41 4753 272c 2027 5f43 5858 464c PFLAGS', '_CXXFL │ │ │ │ │ -00033840: 4147 5327 2c0a 2020 2020 2027 5f46 464c AGS',. '_FFL │ │ │ │ │ -00033850: 4147 5327 2c20 275f 4743 4a46 4c41 4753 AGS', '_GCJFLAGS │ │ │ │ │ -00033860: 272c 2027 5f4c 464c 4147 5327 2c20 275f ', '_LFLAGS', '_ │ │ │ │ │ -00033870: 4f42 4a43 464c 4147 5327 2c20 275f 5246 OBJCFLAGS', '_RF │ │ │ │ │ -00033880: 4c41 4753 272c 0a20 2020 2020 275f 5550 LAGS',. '_UP │ │ │ │ │ -00033890: 4346 4c41 4753 272c 2061 6e64 2027 5f59 CFLAGS', and '_Y │ │ │ │ │ -000338a0: 464c 4147 5327 2e0a 0a20 2020 2020 5768 FLAGS'... Wh │ │ │ │ │ -000338b0: 656e 2075 7369 6e67 2061 2070 6572 2d74 en using a per-t │ │ │ │ │ -000338c0: 6172 6765 7420 636f 6d70 696c 6174 696f arget compilatio │ │ │ │ │ -000338d0: 6e20 666c 6167 2c20 4175 746f 6d61 6b65 n flag, Automake │ │ │ │ │ -000338e0: 2077 696c 6c20 6368 6f6f 7365 2061 0a20 will choose a. │ │ │ │ │ -000338f0: 2020 2020 6469 6666 6572 656e 7420 6e61 different na │ │ │ │ │ -00033900: 6d65 2066 6f72 2074 6865 2069 6e74 6572 me for the inter │ │ │ │ │ -00033910: 6d65 6469 6174 6520 6f62 6a65 6374 2066 mediate object f │ │ │ │ │ -00033920: 696c 6573 2e20 204f 7264 696e 6172 696c iles. Ordinaril │ │ │ │ │ -00033930: 7920 610a 2020 2020 2066 696c 6520 6c69 y a. file li │ │ │ │ │ -00033940: 6b65 2027 7361 6d70 6c65 2e63 2720 7769 ke 'sample.c' wi │ │ │ │ │ -00033950: 6c6c 2062 6520 636f 6d70 696c 6564 2074 ll be compiled t │ │ │ │ │ -00033960: 6f20 7072 6f64 7563 6520 2773 616d 706c o produce 'sampl │ │ │ │ │ -00033970: 652e 6f27 2e0a 2020 2020 2048 6f77 6576 e.o'.. Howev │ │ │ │ │ -00033980: 6572 2c20 6966 2074 6865 2070 726f 6772 er, if the progr │ │ │ │ │ -00033990: 616d 2773 2027 5f43 464c 4147 5327 2076 am's '_CFLAGS' v │ │ │ │ │ -000339a0: 6172 6961 626c 6520 6973 2073 6574 2c20 ariable is set, │ │ │ │ │ -000339b0: 7468 656e 2074 6865 0a20 2020 2020 6f62 then the. ob │ │ │ │ │ -000339c0: 6a65 6374 2066 696c 6520 7769 6c6c 2062 ject file will b │ │ │ │ │ -000339d0: 6520 6e61 6d65 642c 2066 6f72 2069 6e73 e named, for ins │ │ │ │ │ -000339e0: 7461 6e63 652c 2027 6d61 7564 652d 7361 tance, 'maude-sa │ │ │ │ │ -000339f0: 6d70 6c65 2e6f 272e 2020 2853 6565 0a20 mple.o'. (See. │ │ │ │ │ -00033a00: 2020 2020 616c 736f 202a 6e6f 7465 2052 also *note R │ │ │ │ │ -00033a10: 656e 616d 6564 204f 626a 6563 7473 3a3a enamed Objects:: │ │ │ │ │ -00033a20: 2e29 2020 5468 6520 7573 6520 6f66 2070 .) The use of p │ │ │ │ │ -00033a30: 6572 2d74 6172 6765 7420 636f 6d70 696c er-target compil │ │ │ │ │ -00033a40: 6174 696f 6e0a 2020 2020 2066 6c61 6773 ation. flags │ │ │ │ │ -00033a50: 2077 6974 6820 4320 736f 7572 6365 7320 with C sources │ │ │ │ │ -00033a60: 7265 7175 6972 6573 2074 6861 7420 7468 requires that th │ │ │ │ │ -00033a70: 6520 6d61 6372 6f20 2741 4d5f 5052 4f47 e macro 'AM_PROG │ │ │ │ │ -00033a80: 5f43 435f 435f 4f27 2062 650a 2020 2020 _CC_C_O' be. │ │ │ │ │ -00033a90: 2063 616c 6c65 6420 6672 6f6d 2027 636f called from 'co │ │ │ │ │ -00033aa0: 6e66 6967 7572 652e 6163 272e 0a0a 2020 nfigure.ac'... │ │ │ │ │ -00033ab0: 2020 2049 6e20 636f 6d70 696c 6174 696f In compilatio │ │ │ │ │ -00033ac0: 6e73 2077 6974 6820 7065 722d 7461 7267 ns with per-targ │ │ │ │ │ -00033ad0: 6574 2066 6c61 6773 2c20 7468 6520 6f72 et flags, the or │ │ │ │ │ -00033ae0: 6469 6e61 7279 2027 414d 5f27 2066 6f72 dinary 'AM_' for │ │ │ │ │ -00033af0: 6d20 6f66 0a20 2020 2020 7468 6520 666c m of. the fl │ │ │ │ │ -00033b00: 6167 7320 7661 7269 6162 6c65 2069 7320 ags variable is │ │ │ │ │ -00033b10: 5f6e 6f74 5f20 6175 746f 6d61 7469 6361 _not_ automatica │ │ │ │ │ -00033b20: 6c6c 7920 696e 636c 7564 6564 2069 6e20 lly included in │ │ │ │ │ -00033b30: 7468 650a 2020 2020 2063 6f6d 7069 6c61 the. compila │ │ │ │ │ -00033b40: 7469 6f6e 2028 686f 7765 7665 722c 2074 tion (however, t │ │ │ │ │ -00033b50: 6865 2075 7365 7220 666f 726d 206f 6620 he user form of │ │ │ │ │ -00033b60: 7468 6520 7661 7269 6162 6c65 205f 6973 the variable _is │ │ │ │ │ -00033b70: 5f20 696e 636c 7564 6564 292e 0a20 2020 _ included).. │ │ │ │ │ -00033b80: 2020 536f 2066 6f72 2069 6e73 7461 6e63 So for instanc │ │ │ │ │ -00033b90: 652c 2069 6620 796f 7520 7761 6e74 2074 e, if you want t │ │ │ │ │ -00033ba0: 6865 2068 7970 6f74 6865 7469 6361 6c20 he hypothetical │ │ │ │ │ -00033bb0: 276d 6175 6465 2720 636f 6d70 696c 6174 'maude' compilat │ │ │ │ │ -00033bc0: 696f 6e73 0a20 2020 2020 746f 2061 6c73 ions. to als │ │ │ │ │ -00033bd0: 6f20 7573 6520 7468 6520 7661 6c75 6520 o use the value │ │ │ │ │ -00033be0: 6f66 2027 414d 5f43 464c 4147 5327 2c20 of 'AM_CFLAGS', │ │ │ │ │ -00033bf0: 796f 7520 776f 756c 6420 6e65 6564 2074 you would need t │ │ │ │ │ -00033c00: 6f20 7772 6974 653a 0a0a 2020 2020 2020 o write:.. │ │ │ │ │ -00033c10: 2020 2020 6d61 7564 655f 4346 4c41 4753 maude_CFLAGS │ │ │ │ │ -00033c20: 203d 202e 2e2e 2079 6f75 7220 666c 6167 = ... your flag │ │ │ │ │ -00033c30: 7320 2e2e 2e20 2428 414d 5f43 464c 4147 s ... $(AM_CFLAG │ │ │ │ │ -00033c40: 5329 0a0a 2020 2020 202a 4e6f 7465 2046 S).. *Note F │ │ │ │ │ -00033c50: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ -00033c60: 6465 7269 6e67 3a3a 2c20 666f 7220 6d6f dering::, for mo │ │ │ │ │ -00033c70: 7265 2064 6973 6375 7373 696f 6e20 6162 re discussion ab │ │ │ │ │ -00033c80: 6f75 7420 7468 650a 2020 2020 2069 6e74 out the. int │ │ │ │ │ -00033c90: 6572 6163 7469 6f6e 2062 6574 7765 656e eraction between │ │ │ │ │ -00033ca0: 2075 7365 7220 7661 7269 6162 6c65 732c user variables, │ │ │ │ │ -00033cb0: 2027 414d 5f27 2073 6861 646f 7720 7661 'AM_' shadow va │ │ │ │ │ -00033cc0: 7269 6162 6c65 732c 2061 6e64 0a20 2020 riables, and. │ │ │ │ │ -00033cd0: 2020 7065 722d 7461 7267 6574 2076 6172 per-target var │ │ │ │ │ -00033ce0: 6961 626c 6573 2e0a 0a27 6d61 7564 655f iables...'maude_ │ │ │ │ │ -00033cf0: 5348 4f52 544e 414d 4527 0a20 2020 2020 SHORTNAME'. │ │ │ │ │ -00033d00: 4f6e 2073 6f6d 6520 706c 6174 666f 726d On some platform │ │ │ │ │ -00033d10: 7320 7468 6520 616c 6c6f 7761 626c 6520 s the allowable │ │ │ │ │ -00033d20: 6669 6c65 206e 616d 6573 2061 7265 2076 file names are v │ │ │ │ │ -00033d30: 6572 7920 7368 6f72 742e 2020 496e 0a20 ery short. In. │ │ │ │ │ -00033d40: 2020 2020 6f72 6465 7220 746f 2073 7570 order to sup │ │ │ │ │ -00033d50: 706f 7274 2074 6865 7365 2073 7973 7465 port these syste │ │ │ │ │ -00033d60: 6d73 2061 6e64 2070 6572 2d74 6172 6765 ms and per-targe │ │ │ │ │ -00033d70: 7420 636f 6d70 696c 6174 696f 6e20 666c t compilation fl │ │ │ │ │ -00033d80: 6167 7320 6174 0a20 2020 2020 7468 6520 ags at. the │ │ │ │ │ -00033d90: 7361 6d65 2074 696d 652c 2041 7574 6f6d same time, Autom │ │ │ │ │ -00033da0: 616b 6520 616c 6c6f 7773 2079 6f75 2074 ake allows you t │ │ │ │ │ -00033db0: 6f20 7365 7420 6120 2273 686f 7274 206e o set a "short n │ │ │ │ │ -00033dc0: 616d 6522 2074 6861 7420 7769 6c6c 0a20 ame" that will. │ │ │ │ │ -00033dd0: 2020 2020 696e 666c 7565 6e63 6520 686f influence ho │ │ │ │ │ -00033de0: 7720 696e 7465 726d 6564 6961 7465 206f w intermediate o │ │ │ │ │ -00033df0: 626a 6563 7420 6669 6c65 7320 6172 6520 bject files are │ │ │ │ │ -00033e00: 6e61 6d65 642e 2020 466f 7220 696e 7374 named. For inst │ │ │ │ │ -00033e10: 616e 6365 2c0a 2020 2020 2069 6e20 7468 ance,. in th │ │ │ │ │ -00033e20: 6520 666f 6c6c 6f77 696e 6720 6578 616d e following exam │ │ │ │ │ -00033e30: 706c 652c 0a0a 2020 2020 2020 2020 2020 ple,.. │ │ │ │ │ -00033e40: 6269 6e5f 5052 4f47 5241 4d53 203d 206d bin_PROGRAMS = m │ │ │ │ │ -00033e50: 6175 6465 0a20 2020 2020 2020 2020 206d aude. m │ │ │ │ │ -00033e60: 6175 6465 5f43 5050 464c 4147 5320 3d20 aude_CPPFLAGS = │ │ │ │ │ -00033e70: 2d44 534f 4d45 464c 4147 0a20 2020 2020 -DSOMEFLAG. │ │ │ │ │ -00033e80: 2020 2020 206d 6175 6465 5f53 484f 5254 maude_SHORT │ │ │ │ │ -00033e90: 4e41 4d45 203d 206d 0a20 2020 2020 2020 NAME = m. │ │ │ │ │ -00033ea0: 2020 206d 6175 6465 5f53 4f55 5243 4553 maude_SOURCES │ │ │ │ │ -00033eb0: 203d 2073 616d 706c 652e 6320 2e2e 2e0a = sample.c .... │ │ │ │ │ -00033ec0: 0a20 2020 2020 7468 6520 6f62 6a65 6374 . the object │ │ │ │ │ -00033ed0: 2066 696c 6520 776f 756c 6420 6265 206e file would be n │ │ │ │ │ -00033ee0: 616d 6564 2027 6d2d 7361 6d70 6c65 2e6f amed 'm-sample.o │ │ │ │ │ -00033ef0: 2720 7261 7468 6572 2074 6861 6e0a 2020 ' rather than. │ │ │ │ │ -00033f00: 2020 2027 6d61 7564 652d 7361 6d70 6c65 'maude-sample │ │ │ │ │ -00033f10: 2e6f 272e 0a0a 2020 2020 2054 6869 7320 .o'... This │ │ │ │ │ -00033f20: 6661 6369 6c69 7479 2069 7320 7261 7265 facility is rare │ │ │ │ │ -00033f30: 6c79 206e 6565 6465 6420 696e 2070 7261 ly needed in pra │ │ │ │ │ -00033f40: 6374 6963 652c 2061 6e64 2077 6520 7265 ctice, and we re │ │ │ │ │ -00033f50: 636f 6d6d 656e 640a 2020 2020 2061 766f commend. avo │ │ │ │ │ -00033f60: 6964 696e 6720 6974 2075 6e74 696c 2079 iding it until y │ │ │ │ │ -00033f70: 6f75 2066 696e 6420 6974 2069 7320 7265 ou find it is re │ │ │ │ │ -00033f80: 7175 6972 6564 2e0a 0a20 2020 2d2d 2d2d quired... ---- │ │ │ │ │ -00033f90: 2d2d 2d2d 2d2d 2046 6f6f 746e 6f74 6573 ------ Footnotes │ │ │ │ │ -00033fa0: 202d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 ----------.. │ │ │ │ │ -00033fb0: 2831 2920 5468 6572 6520 6172 6520 6f74 (1) There are ot │ │ │ │ │ -00033fc0: 6865 722c 206d 6f72 6520 6f62 7363 7572 her, more obscur │ │ │ │ │ -00033fd0: 6520 7265 6173 6f6e 7320 666f 7220 7468 e reasons for th │ │ │ │ │ -00033fe0: 6973 206c 696d 6974 6174 696f 6e20 6173 is limitation as │ │ │ │ │ -00033ff0: 0a77 656c 6c2e 0a0a 1f0a 4669 6c65 3a20 .well.....File: │ │ │ │ │ -00034000: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -00034010: 666f 2c20 204e 6f64 653a 2044 6566 6175 fo, Node: Defau │ │ │ │ │ -00034020: 6c74 205f 534f 5552 4345 532c 2020 4e65 lt _SOURCES, Ne │ │ │ │ │ -00034030: 7874 3a20 4c49 424f 424a 532c 2020 5072 xt: LIBOBJS, Pr │ │ │ │ │ -00034040: 6576 3a20 5072 6f67 7261 6d20 616e 6420 ev: Program and │ │ │ │ │ -00034050: 4c69 6272 6172 7920 5661 7269 6162 6c65 Library Variable │ │ │ │ │ -00034060: 732c 2020 5570 3a20 5072 6f67 7261 6d73 s, Up: Programs │ │ │ │ │ -00034070: 0a0a 382e 3520 4465 6661 756c 7420 275f ..8.5 Default '_ │ │ │ │ │ -00034080: 534f 5552 4345 5327 0a3d 3d3d 3d3d 3d3d SOURCES'.======= │ │ │ │ │ -00034090: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -000340a0: 0a27 5f53 4f55 5243 4553 2720 7661 7269 .'_SOURCES' vari │ │ │ │ │ -000340b0: 6162 6c65 7320 6172 6520 7573 6564 2074 ables are used t │ │ │ │ │ -000340c0: 6f20 7370 6563 6966 7920 736f 7572 6365 o specify source │ │ │ │ │ -000340d0: 2066 696c 6573 206f 6620 7072 6f67 7261 files of progra │ │ │ │ │ -000340e0: 6d73 2028 2a6e 6f74 650a 4120 5072 6f67 ms (*note.A Prog │ │ │ │ │ -000340f0: 7261 6d3a 3a29 2c20 6c69 6272 6172 6965 ram::), librarie │ │ │ │ │ -00034100: 7320 282a 6e6f 7465 2041 204c 6962 7261 s (*note A Libra │ │ │ │ │ -00034110: 7279 3a3a 292c 2061 6e64 204c 6962 746f ry::), and Libto │ │ │ │ │ -00034120: 6f6c 206c 6962 7261 7269 6573 0a28 2a6e ol libraries.(*n │ │ │ │ │ -00034130: 6f74 6520 4120 5368 6172 6564 204c 6962 ote A Shared Lib │ │ │ │ │ -00034140: 7261 7279 3a3a 292e 0a0a 2020 2057 6865 rary::)... Whe │ │ │ │ │ -00034150: 6e20 6e6f 2073 7563 6820 7661 7269 6162 n no such variab │ │ │ │ │ -00034160: 6c65 2069 7320 7370 6563 6966 6965 6420 le is specified │ │ │ │ │ -00034170: 666f 7220 6120 7461 7267 6574 2c20 4175 for a target, Au │ │ │ │ │ -00034180: 746f 6d61 6b65 2077 696c 6c20 6465 6669 tomake will defi │ │ │ │ │ -00034190: 6e65 0a6f 6e65 2069 7473 656c 662e 2020 ne.one itself. │ │ │ │ │ -000341a0: 5468 6520 6465 6661 756c 7420 6973 2074 The default is t │ │ │ │ │ -000341b0: 6f20 636f 6d70 696c 6520 6120 7369 6e67 o compile a sing │ │ │ │ │ -000341c0: 6c65 2043 2066 696c 6520 7768 6f73 6520 le C file whose │ │ │ │ │ -000341d0: 6261 7365 206e 616d 650a 6973 2074 6865 base name.is the │ │ │ │ │ -000341e0: 206e 616d 6520 6f66 2074 6865 2074 6172 name of the tar │ │ │ │ │ -000341f0: 6765 7420 6974 7365 6c66 2c20 7769 7468 get itself, with │ │ │ │ │ -00034200: 2061 6e79 2065 7874 656e 7369 6f6e 2072 any extension r │ │ │ │ │ -00034210: 6570 6c61 6365 6420 6279 0a27 414d 5f44 eplaced by.'AM_D │ │ │ │ │ -00034220: 4546 4155 4c54 5f53 4f55 5243 455f 4558 EFAULT_SOURCE_EX │ │ │ │ │ -00034230: 5427 2c20 7768 6963 6820 6465 6661 756c T', which defaul │ │ │ │ │ -00034240: 7473 2074 6f20 272e 6327 2e0a 0a20 2020 ts to '.c'... │ │ │ │ │ -00034250: 466f 7220 6578 616d 706c 6520 6966 2079 For example if y │ │ │ │ │ -00034260: 6f75 2068 6176 6520 7468 6520 666f 6c6c ou have the foll │ │ │ │ │ -00034270: 6f77 696e 6720 736f 6d65 7768 6572 6520 owing somewhere │ │ │ │ │ -00034280: 696e 2079 6f75 7220 274d 616b 6566 696c in your 'Makefil │ │ │ │ │ -00034290: 652e 616d 270a 7769 7468 206e 6f20 636f e.am'.with no co │ │ │ │ │ -000342a0: 7272 6573 706f 6e64 696e 6720 276c 6962 rresponding 'lib │ │ │ │ │ -000342b0: 666f 6f5f 615f 534f 5552 4345 5327 3a0a foo_a_SOURCES':. │ │ │ │ │ -000342c0: 0a20 2020 2020 6c69 625f 4c49 4252 4152 . lib_LIBRAR │ │ │ │ │ -000342d0: 4945 5320 3d20 6c69 6266 6f6f 2e61 2073 IES = libfoo.a s │ │ │ │ │ -000342e0: 7562 2f6c 6962 632b 2b2e 610a 0a27 6c69 ub/libc++.a..'li │ │ │ │ │ -000342f0: 6266 6f6f 2e61 2720 7769 6c6c 2062 6520 bfoo.a' will be │ │ │ │ │ -00034300: 6275 696c 7420 7573 696e 6720 6120 6465 built using a de │ │ │ │ │ -00034310: 6661 756c 7420 736f 7572 6365 2066 696c fault source fil │ │ │ │ │ -00034320: 6520 6e61 6d65 6420 276c 6962 666f 6f2e e named 'libfoo. │ │ │ │ │ -00034330: 6327 2c0a 616e 6420 2773 7562 2f6c 6962 c',.and 'sub/lib │ │ │ │ │ -00034340: 632b 2b2e 6127 2077 696c 6c20 6265 2062 c++.a' will be b │ │ │ │ │ -00034350: 7569 6c74 2066 726f 6d20 2773 7562 2f6c uilt from 'sub/l │ │ │ │ │ -00034360: 6962 632b 2b2e 6327 2e20 2028 496e 206f ibc++.c'. (In o │ │ │ │ │ -00034370: 6c64 6572 0a76 6572 7369 6f6e 7320 2773 lder.versions 's │ │ │ │ │ -00034380: 7562 2f6c 6962 632b 2b2e 6127 2077 6f75 ub/libc++.a' wou │ │ │ │ │ -00034390: 6c64 2062 6520 6275 696c 7420 6672 6f6d ld be built from │ │ │ │ │ -000343a0: 2027 7375 625f 6c69 6263 5f5f 5f61 2e63 'sub_libc___a.c │ │ │ │ │ -000343b0: 272c 2069 2e65 2e2c 2074 6865 0a64 6566 ', i.e., the.def │ │ │ │ │ -000343c0: 6175 6c74 2073 6f75 7263 6520 7761 7320 ault source was │ │ │ │ │ -000343d0: 7468 6520 6361 6e6f 6e69 7a65 6420 6e61 the canonized na │ │ │ │ │ -000343e0: 6d65 206f 6620 7468 6520 7461 7267 6574 me of the target │ │ │ │ │ -000343f0: 2c20 7769 7468 2027 2e63 2720 6170 7065 , with '.c' appe │ │ │ │ │ -00034400: 6e64 6564 2e0a 5765 2062 656c 6965 7665 nded..We believe │ │ │ │ │ -00034410: 2074 6865 206e 6577 2062 6568 6176 696f the new behavio │ │ │ │ │ -00034420: 7220 6973 206d 6f72 6520 7365 6e73 6962 r is more sensib │ │ │ │ │ -00034430: 6c65 2c20 6275 7420 666f 7220 6261 636b le, but for back │ │ │ │ │ -00034440: 7761 7264 0a63 6f6d 7061 7469 6269 6c69 ward.compatibili │ │ │ │ │ -00034450: 7479 2027 6175 746f 6d61 6b65 2720 7769 ty 'automake' wi │ │ │ │ │ -00034460: 6c6c 2075 7365 2074 6865 206f 6c64 206e ll use the old n │ │ │ │ │ -00034470: 616d 6520 6966 2061 2066 696c 6520 6f72 ame if a file or │ │ │ │ │ -00034480: 2061 2072 756c 6520 7769 7468 0a74 6861 a rule with.tha │ │ │ │ │ -00034490: 7420 6e61 6d65 2065 7869 7374 7320 616e t name exists an │ │ │ │ │ -000344a0: 6420 2741 4d5f 4445 4641 554c 545f 534f d 'AM_DEFAULT_SO │ │ │ │ │ -000344b0: 5552 4345 5f45 5854 2720 6973 206e 6f74 URCE_EXT' is not │ │ │ │ │ -000344c0: 2075 7365 642e 290a 0a20 2020 4465 6661 used.).. Defa │ │ │ │ │ -000344d0: 756c 7420 736f 7572 6365 7320 6172 6520 ult sources are │ │ │ │ │ -000344e0: 6d61 696e 6c79 2075 7365 6675 6c20 696e mainly useful in │ │ │ │ │ -000344f0: 2074 6573 7420 7375 6974 6573 2c20 7768 test suites, wh │ │ │ │ │ -00034500: 656e 2062 7569 6c64 696e 6720 6d61 6e79 en building many │ │ │ │ │ -00034510: 0a74 6573 7420 7072 6f67 7261 6d73 2065 .test programs e │ │ │ │ │ -00034520: 6163 6820 6672 6f6d 2061 2073 696e 676c ach from a singl │ │ │ │ │ -00034530: 6520 736f 7572 6365 2e20 2046 6f72 2069 e source. For i │ │ │ │ │ -00034540: 6e73 7461 6e63 652c 2069 6e0a 0a20 2020 nstance, in.. │ │ │ │ │ -00034550: 2020 6368 6563 6b5f 5052 4f47 5241 4d53 check_PROGRAMS │ │ │ │ │ -00034560: 203d 2074 6573 7431 2074 6573 7432 2074 = test1 test2 t │ │ │ │ │ -00034570: 6573 7433 0a20 2020 2020 414d 5f44 4546 est3. AM_DEF │ │ │ │ │ -00034580: 4155 4c54 5f53 4f55 5243 455f 4558 5420 AULT_SOURCE_EXT │ │ │ │ │ -00034590: 3d20 2e63 7070 0a0a 2774 6573 7431 272c = .cpp..'test1', │ │ │ │ │ -000345a0: 2027 7465 7374 3227 2c20 616e 6420 2774 'test2', and 't │ │ │ │ │ -000345b0: 6573 7433 2720 7769 6c6c 2062 6520 6275 est3' will be bu │ │ │ │ │ -000345c0: 696c 7420 6672 6f6d 2027 7465 7374 312e ilt from 'test1. │ │ │ │ │ -000345d0: 6370 7027 2c0a 2774 6573 7432 2e63 7070 cpp',.'test2.cpp │ │ │ │ │ -000345e0: 272c 2061 6e64 2027 7465 7374 332e 6370 ', and 'test3.cp │ │ │ │ │ -000345f0: 7027 2e20 2057 6974 686f 7574 2074 6865 p'. Without the │ │ │ │ │ -00034600: 206c 6173 7420 6c69 6e65 2c20 7468 6579 last line, they │ │ │ │ │ -00034610: 2077 696c 6c20 6265 2062 7569 6c74 0a66 will be built.f │ │ │ │ │ -00034620: 726f 6d20 2774 6573 7431 2e63 272c 2027 rom 'test1.c', ' │ │ │ │ │ -00034630: 7465 7374 322e 6327 2c20 616e 6420 2774 test2.c', and 't │ │ │ │ │ -00034640: 6573 7433 2e63 272e 0a0a 2020 2041 6e6f est3.c'... Ano │ │ │ │ │ -00034650: 7468 6572 2063 6173 6520 7768 6572 6520 ther case where │ │ │ │ │ -00034660: 7468 6973 2069 7320 636f 6e76 656e 6965 this is convenie │ │ │ │ │ -00034670: 6e74 2069 7320 6275 696c 6469 6e67 206d nt is building m │ │ │ │ │ -00034680: 616e 7920 4c69 6274 6f6f 6c0a 6d6f 6475 any Libtool.modu │ │ │ │ │ -00034690: 6c65 7320 2827 6d6f 6475 6c65 4e2e 6c61 les ('moduleN.la │ │ │ │ │ -000346a0: 2729 2c20 6561 6368 2064 6566 696e 6564 '), each defined │ │ │ │ │ -000346b0: 2069 6e20 6974 7320 6f77 6e20 6669 6c65 in its own file │ │ │ │ │ -000346c0: 2028 276d 6f64 756c 654e 2e63 2729 2e0a ('moduleN.c').. │ │ │ │ │ -000346d0: 0a20 2020 2020 414d 5f4c 4446 4c41 4753 . AM_LDFLAGS │ │ │ │ │ -000346e0: 203d 202d 6d6f 6475 6c65 0a20 2020 2020 = -module. │ │ │ │ │ -000346f0: 6c69 625f 4c54 4c49 4252 4152 4945 5320 lib_LTLIBRARIES │ │ │ │ │ -00034700: 3d20 6d6f 6475 6c65 312e 6c61 206d 6f64 = module1.la mod │ │ │ │ │ -00034710: 756c 6532 2e6c 6120 6d6f 6475 6c65 332e ule2.la module3. │ │ │ │ │ -00034720: 6c61 0a0a 2020 2046 696e 616c 6c79 2c20 la.. Finally, │ │ │ │ │ -00034730: 7468 6572 6520 6973 206f 6e65 2073 6974 there is one sit │ │ │ │ │ -00034740: 7561 7469 6f6e 2077 6865 7265 2074 6869 uation where thi │ │ │ │ │ -00034750: 7320 6465 6661 756c 7420 736f 7572 6365 s default source │ │ │ │ │ -00034760: 2063 6f6d 7075 7461 7469 6f6e 0a6e 6565 computation.nee │ │ │ │ │ -00034770: 6473 2074 6f20 6265 2061 766f 6964 6564 ds to be avoided │ │ │ │ │ -00034780: 3a20 7768 656e 2061 2074 6172 6765 7420 : when a target │ │ │ │ │ -00034790: 7368 6f75 6c64 206e 6f74 2062 6520 6275 should not be bu │ │ │ │ │ -000347a0: 696c 7420 6672 6f6d 2073 6f75 7263 6573 ilt from sources │ │ │ │ │ -000347b0: 2e20 2057 650a 616c 7265 6164 7920 7361 . We.already sa │ │ │ │ │ -000347c0: 7720 7375 6368 2061 6e20 6578 616d 706c w such an exampl │ │ │ │ │ -000347d0: 6520 696e 202a 6e6f 7465 2074 7275 653a e in *note true: │ │ │ │ │ -000347e0: 3a3b 2074 6869 7320 6861 7070 656e 7320 :; this happens │ │ │ │ │ -000347f0: 7768 656e 2061 6c6c 2074 6865 0a63 6f6e when all the.con │ │ │ │ │ -00034800: 7374 6974 7565 6e74 7320 6f66 2061 2074 stituents of a t │ │ │ │ │ -00034810: 6172 6765 7420 6861 7665 2061 6c72 6561 arget have alrea │ │ │ │ │ -00034820: 6479 2062 6565 6e20 636f 6d70 696c 6564 dy been compiled │ │ │ │ │ -00034830: 2061 6e64 206a 7573 7420 6e65 6564 2074 and just need t │ │ │ │ │ -00034840: 6f20 6265 0a63 6f6d 6269 6e65 6420 7573 o be.combined us │ │ │ │ │ -00034850: 696e 6720 6120 275f 4c44 4144 4427 2076 ing a '_LDADD' v │ │ │ │ │ -00034860: 6172 6961 626c 652e 2020 5468 656e 2069 ariable. Then i │ │ │ │ │ -00034870: 7420 6973 206e 6563 6573 7361 7279 2074 t is necessary t │ │ │ │ │ -00034880: 6f20 6465 6669 6e65 2061 6e0a 656d 7074 o define an.empt │ │ │ │ │ -00034890: 7920 275f 534f 5552 4345 5327 2076 6172 y '_SOURCES' var │ │ │ │ │ -000348a0: 6961 626c 652c 2073 6f20 7468 6174 2027 iable, so that ' │ │ │ │ │ -000348b0: 6175 746f 6d61 6b65 2720 646f 6573 206e automake' does n │ │ │ │ │ -000348c0: 6f74 2063 6f6d 7075 7465 2061 0a64 6566 ot compute a.def │ │ │ │ │ -000348d0: 6175 6c74 2e0a 0a20 2020 2020 6269 6e5f ault... bin_ │ │ │ │ │ -000348e0: 5052 4f47 5241 4d53 203d 2074 6172 6765 PROGRAMS = targe │ │ │ │ │ -000348f0: 740a 2020 2020 2074 6172 6765 745f 534f t. target_SO │ │ │ │ │ -00034900: 5552 4345 5320 3d0a 2020 2020 2074 6172 URCES =. tar │ │ │ │ │ -00034910: 6765 745f 4c44 4144 4420 3d20 6c69 626d get_LDADD = libm │ │ │ │ │ -00034920: 6169 6e2e 6120 6c69 626d 6973 632e 610a ain.a libmisc.a. │ │ │ │ │ -00034930: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -00034940: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -00034950: 6465 3a20 4c49 424f 424a 532c 2020 4e65 de: LIBOBJS, Ne │ │ │ │ │ -00034960: 7874 3a20 5072 6f67 7261 6d20 5661 7269 xt: Program Vari │ │ │ │ │ -00034970: 6162 6c65 732c 2020 5072 6576 3a20 4465 ables, Prev: De │ │ │ │ │ -00034980: 6661 756c 7420 5f53 4f55 5243 4553 2c20 fault _SOURCES, │ │ │ │ │ -00034990: 2055 703a 2050 726f 6772 616d 730a 0a38 Up: Programs..8 │ │ │ │ │ -000349a0: 2e36 2053 7065 6369 616c 2068 616e 646c .6 Special handl │ │ │ │ │ -000349b0: 696e 6720 666f 7220 274c 4942 4f42 4a53 ing for 'LIBOBJS │ │ │ │ │ -000349c0: 2720 616e 6420 2741 4c4c 4f43 4127 0a3d ' and 'ALLOCA'.= │ │ │ │ │ -000349d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000315c0: 3d3d 3d3d 3d3d 3d3d 0a0a 4173 736f 6369 ========..Associ │ │ │ │ │ +000315d0: 6174 6564 2077 6974 6820 6561 6368 2070 ated with each p │ │ │ │ │ +000315e0: 726f 6772 616d 2069 7320 6120 636f 6c6c rogram is a coll │ │ │ │ │ +000315f0: 6563 7469 6f6e 206f 6620 7661 7269 6162 ection of variab │ │ │ │ │ +00031600: 6c65 7320 7468 6174 2063 616e 2062 650a les that can be. │ │ │ │ │ +00031610: 7573 6564 2074 6f20 6d6f 6469 6679 2068 used to modify h │ │ │ │ │ +00031620: 6f77 2074 6861 7420 7072 6f67 7261 6d20 ow that program │ │ │ │ │ +00031630: 6973 2062 7569 6c74 2e20 2054 6865 7265 is built. There │ │ │ │ │ +00031640: 2069 7320 6120 7369 6d69 6c61 7220 6c69 is a similar li │ │ │ │ │ +00031650: 7374 206f 660a 7375 6368 2076 6172 6961 st of.such varia │ │ │ │ │ +00031660: 626c 6573 2066 6f72 2065 6163 6820 6c69 bles for each li │ │ │ │ │ +00031670: 6272 6172 792e 2020 5468 6520 6361 6e6f brary. The cano │ │ │ │ │ +00031680: 6e69 6361 6c20 6e61 6d65 206f 6620 7468 nical name of th │ │ │ │ │ +00031690: 6520 7072 6f67 7261 6d20 286f 720a 6c69 e program (or.li │ │ │ │ │ +000316a0: 6272 6172 7929 2069 7320 7573 6564 2061 brary) is used a │ │ │ │ │ +000316b0: 7320 6120 6261 7365 2066 6f72 206e 616d s a base for nam │ │ │ │ │ +000316c0: 696e 6720 7468 6573 6520 7661 7269 6162 ing these variab │ │ │ │ │ +000316d0: 6c65 732e 0a0a 2020 2049 6e20 7468 6520 les... In the │ │ │ │ │ +000316e0: 6c69 7374 2062 656c 6f77 2c20 7765 2075 list below, we u │ │ │ │ │ +000316f0: 7365 2074 6865 206e 616d 6520 226d 6175 se the name "mau │ │ │ │ │ +00031700: 6465 2220 746f 2072 6566 6572 2074 6f20 de" to refer to │ │ │ │ │ +00031710: 7468 6520 7072 6f67 7261 6d20 6f72 0a6c the program or.l │ │ │ │ │ +00031720: 6962 7261 7279 2e20 2049 6e20 796f 7572 ibrary. In your │ │ │ │ │ +00031730: 2027 4d61 6b65 6669 6c65 2e61 6d27 2079 'Makefile.am' y │ │ │ │ │ +00031740: 6f75 2077 6f75 6c64 2072 6570 6c61 6365 ou would replace │ │ │ │ │ +00031750: 2074 6869 7320 7769 7468 2074 6865 0a63 this with the.c │ │ │ │ │ +00031760: 616e 6f6e 6963 616c 206e 616d 6520 6f66 anonical name of │ │ │ │ │ +00031770: 2079 6f75 7220 7072 6f67 7261 6d2e 2020 your program. │ │ │ │ │ +00031780: 5468 6973 206c 6973 7420 616c 736f 2072 This list also r │ │ │ │ │ +00031790: 6566 6572 7320 746f 2022 6d61 7564 6522 efers to "maude" │ │ │ │ │ +000317a0: 2061 7320 610a 7072 6f67 7261 6d2c 2062 as a.program, b │ │ │ │ │ +000317b0: 7574 2069 6e20 6765 6e65 7261 6c20 7468 ut in general th │ │ │ │ │ +000317c0: 6520 7361 6d65 2072 756c 6573 2061 7070 e same rules app │ │ │ │ │ +000317d0: 6c79 2066 6f72 2062 6f74 6820 7374 6174 ly for both stat │ │ │ │ │ +000317e0: 6963 2061 6e64 2064 796e 616d 6963 0a6c ic and dynamic.l │ │ │ │ │ +000317f0: 6962 7261 7269 6573 3b20 7468 6520 646f ibraries; the do │ │ │ │ │ +00031800: 6375 6d65 6e74 6174 696f 6e20 6265 6c6f cumentation belo │ │ │ │ │ +00031810: 7720 6e6f 7465 7320 7369 7475 6174 696f w notes situatio │ │ │ │ │ +00031820: 6e73 2077 6865 7265 2070 726f 6772 616d ns where program │ │ │ │ │ +00031830: 7320 616e 640a 6c69 6272 6172 6965 7320 s and.libraries │ │ │ │ │ +00031840: 6469 6666 6572 2e0a 0a27 6d61 7564 655f differ...'maude_ │ │ │ │ │ +00031850: 534f 5552 4345 5327 0a20 2020 2020 5468 SOURCES'. Th │ │ │ │ │ +00031860: 6973 2076 6172 6961 626c 652c 2069 6620 is variable, if │ │ │ │ │ +00031870: 6974 2065 7869 7374 732c 206c 6973 7473 it exists, lists │ │ │ │ │ +00031880: 2061 6c6c 2074 6865 2073 6f75 7263 6520 all the source │ │ │ │ │ +00031890: 6669 6c65 7320 7468 6174 2061 7265 0a20 files that are. │ │ │ │ │ +000318a0: 2020 2020 636f 6d70 696c 6564 2074 6f20 compiled to │ │ │ │ │ +000318b0: 6275 696c 6420 7468 6520 7072 6f67 7261 build the progra │ │ │ │ │ +000318c0: 6d2e 2020 5468 6573 6520 6669 6c65 7320 m. These files │ │ │ │ │ +000318d0: 6172 6520 6164 6465 6420 746f 2074 6865 are added to the │ │ │ │ │ +000318e0: 0a20 2020 2020 6469 7374 7269 6275 7469 . distributi │ │ │ │ │ +000318f0: 6f6e 2062 7920 6465 6661 756c 742e 2020 on by default. │ │ │ │ │ +00031900: 5768 656e 2062 7569 6c64 696e 6720 7468 When building th │ │ │ │ │ +00031910: 6520 7072 6f67 7261 6d2c 2041 7574 6f6d e program, Autom │ │ │ │ │ +00031920: 616b 6520 7769 6c6c 0a20 2020 2020 6361 ake will. ca │ │ │ │ │ +00031930: 7573 6520 6561 6368 2073 6f75 7263 6520 use each source │ │ │ │ │ +00031940: 6669 6c65 2074 6f20 6265 2063 6f6d 7069 file to be compi │ │ │ │ │ +00031950: 6c65 6420 746f 2061 2073 696e 676c 6520 led to a single │ │ │ │ │ +00031960: 272e 6f27 2066 696c 6520 286f 720a 2020 '.o' file (or. │ │ │ │ │ +00031970: 2020 2027 2e6c 6f27 2077 6865 6e20 7573 '.lo' when us │ │ │ │ │ +00031980: 696e 6720 6c69 6274 6f6f 6c29 2e20 204e ing libtool). N │ │ │ │ │ +00031990: 6f72 6d61 6c6c 7920 7468 6573 6520 6f62 ormally these ob │ │ │ │ │ +000319a0: 6a65 6374 2066 696c 6573 2061 7265 206e ject files are n │ │ │ │ │ +000319b0: 616d 6564 0a20 2020 2020 6166 7465 7220 amed. after │ │ │ │ │ +000319c0: 7468 6520 736f 7572 6365 2066 696c 652c the source file, │ │ │ │ │ +000319d0: 2062 7574 206f 7468 6572 2066 6163 746f but other facto │ │ │ │ │ +000319e0: 7273 2063 616e 2063 6861 6e67 6520 7468 rs can change th │ │ │ │ │ +000319f0: 6973 2e20 2049 6620 610a 2020 2020 2066 is. If a. f │ │ │ │ │ +00031a00: 696c 6520 696e 2074 6865 2027 5f53 4f55 ile in the '_SOU │ │ │ │ │ +00031a10: 5243 4553 2720 7661 7269 6162 6c65 2068 RCES' variable h │ │ │ │ │ +00031a20: 6173 2061 6e20 756e 7265 636f 676e 697a as an unrecogniz │ │ │ │ │ +00031a30: 6564 2065 7874 656e 7369 6f6e 2c0a 2020 ed extension,. │ │ │ │ │ +00031a40: 2020 2041 7574 6f6d 616b 6520 7769 6c6c Automake will │ │ │ │ │ +00031a50: 2064 6f20 6f6e 6520 6f66 2074 776f 2074 do one of two t │ │ │ │ │ +00031a60: 6869 6e67 7320 7769 7468 2069 742e 2020 hings with it. │ │ │ │ │ +00031a70: 4966 2061 2073 7566 6669 7820 7275 6c65 If a suffix rule │ │ │ │ │ +00031a80: 0a20 2020 2020 6578 6973 7473 2066 6f72 . exists for │ │ │ │ │ +00031a90: 2074 7572 6e69 6e67 2066 696c 6573 2077 turning files w │ │ │ │ │ +00031aa0: 6974 6820 7468 6520 756e 7265 636f 676e ith the unrecogn │ │ │ │ │ +00031ab0: 697a 6564 2065 7874 656e 7369 6f6e 2069 ized extension i │ │ │ │ │ +00031ac0: 6e74 6f20 272e 6f27 0a20 2020 2020 6669 nto '.o'. fi │ │ │ │ │ +00031ad0: 6c65 732c 2074 6865 6e20 2761 7574 6f6d les, then 'autom │ │ │ │ │ +00031ae0: 616b 6527 2077 696c 6c20 7472 6561 7420 ake' will treat │ │ │ │ │ +00031af0: 7468 6973 2066 696c 6520 6173 2069 7420 this file as it │ │ │ │ │ +00031b00: 7769 6c6c 2061 6e79 206f 7468 6572 0a20 will any other. │ │ │ │ │ +00031b10: 2020 2020 736f 7572 6365 2066 696c 6520 source file │ │ │ │ │ +00031b20: 282a 6e6f 7465 2053 7570 706f 7274 2066 (*note Support f │ │ │ │ │ +00031b30: 6f72 204f 7468 6572 204c 616e 6775 6167 or Other Languag │ │ │ │ │ +00031b40: 6573 3a3a 292e 2020 4f74 6865 7277 6973 es::). Otherwis │ │ │ │ │ +00031b50: 652c 2074 6865 0a20 2020 2020 6669 6c65 e, the. file │ │ │ │ │ +00031b60: 2077 696c 6c20 6265 2069 676e 6f72 6564 will be ignored │ │ │ │ │ +00031b70: 2061 7320 7468 6f75 6768 2069 7420 7765 as though it we │ │ │ │ │ +00031b80: 7265 2061 2068 6561 6465 7220 6669 6c65 re a header file │ │ │ │ │ +00031b90: 2e0a 0a20 2020 2020 5468 6520 7072 6566 ... The pref │ │ │ │ │ +00031ba0: 6978 6573 2027 6469 7374 5f27 2061 6e64 ixes 'dist_' and │ │ │ │ │ +00031bb0: 2027 6e6f 6469 7374 5f27 2063 616e 2062 'nodist_' can b │ │ │ │ │ +00031bc0: 6520 7573 6564 2074 6f20 636f 6e74 726f e used to contro │ │ │ │ │ +00031bd0: 6c20 7768 6574 6865 720a 2020 2020 2066 l whether. f │ │ │ │ │ +00031be0: 696c 6573 206c 6973 7465 6420 696e 2061 iles listed in a │ │ │ │ │ +00031bf0: 2027 5f53 4f55 5243 4553 2720 7661 7269 '_SOURCES' vari │ │ │ │ │ +00031c00: 6162 6c65 2061 7265 2064 6973 7472 6962 able are distrib │ │ │ │ │ +00031c10: 7574 6564 2e20 2027 6469 7374 5f27 2069 uted. 'dist_' i │ │ │ │ │ +00031c20: 730a 2020 2020 2072 6564 756e 6461 6e74 s. redundant │ │ │ │ │ +00031c30: 2c20 6173 2073 6f75 7263 6573 2061 7265 , as sources are │ │ │ │ │ +00031c40: 2064 6973 7472 6962 7574 6564 2062 7920 distributed by │ │ │ │ │ +00031c50: 6465 6661 756c 742c 2062 7574 2069 7420 default, but it │ │ │ │ │ +00031c60: 6361 6e20 6265 0a20 2020 2020 7370 6563 can be. spec │ │ │ │ │ +00031c70: 6966 6965 6420 666f 7220 636c 6172 6974 ified for clarit │ │ │ │ │ +00031c80: 7920 6966 2064 6573 6972 6564 2e0a 0a20 y if desired... │ │ │ │ │ +00031c90: 2020 2020 4974 2069 7320 706f 7373 6962 It is possib │ │ │ │ │ +00031ca0: 6c65 2074 6f20 6861 7665 2062 6f74 6820 le to have both │ │ │ │ │ +00031cb0: 2764 6973 745f 2720 616e 6420 276e 6f64 'dist_' and 'nod │ │ │ │ │ +00031cc0: 6973 745f 2720 7661 7269 616e 7473 206f ist_' variants o │ │ │ │ │ +00031cd0: 6620 610a 2020 2020 2067 6976 656e 2027 f a. given ' │ │ │ │ │ +00031ce0: 5f53 4f55 5243 4553 2720 7661 7269 6162 _SOURCES' variab │ │ │ │ │ +00031cf0: 6c65 2061 7420 6f6e 6365 3b20 7468 6973 le at once; this │ │ │ │ │ +00031d00: 206c 6574 7320 796f 7520 6561 7369 6c79 lets you easily │ │ │ │ │ +00031d10: 2064 6973 7472 6962 7574 650a 2020 2020 distribute. │ │ │ │ │ +00031d20: 2073 6f6d 6520 6669 6c65 7320 616e 6420 some files and │ │ │ │ │ +00031d30: 6e6f 7420 6f74 6865 7273 2c20 666f 7220 not others, for │ │ │ │ │ +00031d40: 696e 7374 616e 6365 3a0a 0a20 2020 2020 instance:.. │ │ │ │ │ +00031d50: 2020 2020 206e 6f64 6973 745f 6d61 7564 nodist_maud │ │ │ │ │ +00031d60: 655f 534f 5552 4345 5320 3d20 6e6f 6469 e_SOURCES = nodi │ │ │ │ │ +00031d70: 7374 2e63 0a20 2020 2020 2020 2020 2064 st.c. d │ │ │ │ │ +00031d80: 6973 745f 6d61 7564 655f 534f 5552 4345 ist_maude_SOURCE │ │ │ │ │ +00031d90: 5320 3d20 6469 7374 2d6d 652e 630a 0a20 S = dist-me.c.. │ │ │ │ │ +00031da0: 2020 2020 4279 2064 6566 6175 6c74 2074 By default t │ │ │ │ │ +00031db0: 6865 206f 7574 7075 7420 6669 6c65 2028 he output file ( │ │ │ │ │ +00031dc0: 6f6e 2055 6e69 7820 7379 7374 656d 732c on Unix systems, │ │ │ │ │ +00031dd0: 2074 6865 2027 2e6f 2720 6669 6c65 2920 the '.o' file) │ │ │ │ │ +00031de0: 7769 6c6c 2062 650a 2020 2020 2070 7574 will be. put │ │ │ │ │ +00031df0: 2069 6e74 6f20 7468 6520 6375 7272 656e into the curren │ │ │ │ │ +00031e00: 7420 6275 696c 6420 6469 7265 6374 6f72 t build director │ │ │ │ │ +00031e10: 792e 2020 486f 7765 7665 722c 2069 6620 y. However, if │ │ │ │ │ +00031e20: 7468 6520 6f70 7469 6f6e 0a20 2020 2020 the option. │ │ │ │ │ +00031e30: 2773 7562 6469 722d 6f62 6a65 6374 7327 'subdir-objects' │ │ │ │ │ +00031e40: 2069 7320 696e 2065 6666 6563 7420 696e is in effect in │ │ │ │ │ +00031e50: 2074 6865 2063 7572 7265 6e74 2064 6972 the current dir │ │ │ │ │ +00031e60: 6563 746f 7279 2074 6865 6e20 7468 650a ectory then the. │ │ │ │ │ +00031e70: 2020 2020 2027 2e6f 2720 6669 6c65 2077 '.o' file w │ │ │ │ │ +00031e80: 696c 6c20 6265 2070 7574 2069 6e74 6f20 ill be put into │ │ │ │ │ +00031e90: 7468 6520 7375 6264 6972 6563 746f 7279 the subdirectory │ │ │ │ │ +00031ea0: 206e 616d 6564 2061 6674 6572 2074 6865 named after the │ │ │ │ │ +00031eb0: 2073 6f75 7263 650a 2020 2020 2066 696c source. fil │ │ │ │ │ +00031ec0: 652e 2020 466f 7220 696e 7374 616e 6365 e. For instance │ │ │ │ │ +00031ed0: 2c20 7769 7468 2027 7375 6264 6972 2d6f , with 'subdir-o │ │ │ │ │ +00031ee0: 626a 6563 7473 2720 656e 6162 6c65 642c bjects' enabled, │ │ │ │ │ +00031ef0: 0a20 2020 2020 2773 7562 2f64 6972 2f66 . 'sub/dir/f │ │ │ │ │ +00031f00: 696c 652e 6327 2077 696c 6c20 6265 2063 ile.c' will be c │ │ │ │ │ +00031f10: 6f6d 7069 6c65 6420 746f 2027 7375 622f ompiled to 'sub/ │ │ │ │ │ +00031f20: 6469 722f 6669 6c65 2e6f 272e 2020 536f dir/file.o'. So │ │ │ │ │ +00031f30: 6d65 2070 656f 706c 650a 2020 2020 2070 me people. p │ │ │ │ │ +00031f40: 7265 6665 7220 7468 6973 206d 6f64 6520 refer this mode │ │ │ │ │ +00031f50: 6f66 206f 7065 7261 7469 6f6e 2e20 2059 of operation. Y │ │ │ │ │ +00031f60: 6f75 2063 616e 2073 7065 6369 6679 2027 ou can specify ' │ │ │ │ │ +00031f70: 7375 6264 6972 2d6f 626a 6563 7473 2720 subdir-objects' │ │ │ │ │ +00031f80: 696e 0a20 2020 2020 2741 5554 4f4d 414b in. 'AUTOMAK │ │ │ │ │ +00031f90: 455f 4f50 5449 4f4e 5327 2028 2a6e 6f74 E_OPTIONS' (*not │ │ │ │ │ +00031fa0: 6520 4f70 7469 6f6e 733a 3a29 2e0a 0a27 e Options::)...' │ │ │ │ │ +00031fb0: 4558 5452 415f 6d61 7564 655f 534f 5552 EXTRA_maude_SOUR │ │ │ │ │ +00031fc0: 4345 5327 0a20 2020 2020 4175 746f 6d61 CES'. Automa │ │ │ │ │ +00031fd0: 6b65 206e 6565 6473 2074 6f20 6b6e 6f77 ke needs to know │ │ │ │ │ +00031fe0: 2074 6865 206c 6973 7420 6f66 2066 696c the list of fil │ │ │ │ │ +00031ff0: 6573 2079 6f75 2069 6e74 656e 6420 746f es you intend to │ │ │ │ │ +00032000: 2063 6f6d 7069 6c65 0a20 2020 2020 5f73 compile. _s │ │ │ │ │ +00032010: 7461 7469 6361 6c6c 795f 2e20 2046 6f72 tatically_. For │ │ │ │ │ +00032020: 206f 6e65 2074 6869 6e67 2c20 7468 6973 one thing, this │ │ │ │ │ +00032030: 2069 7320 7468 6520 6f6e 6c79 2077 6179 is the only way │ │ │ │ │ +00032040: 2041 7574 6f6d 616b 6520 6861 7320 6f66 Automake has of │ │ │ │ │ +00032050: 0a20 2020 2020 6b6e 6f77 696e 6720 7768 . knowing wh │ │ │ │ │ +00032060: 6174 2073 6f72 7420 6f66 206c 616e 6775 at sort of langu │ │ │ │ │ +00032070: 6167 6520 7375 7070 6f72 7420 6120 6769 age support a gi │ │ │ │ │ +00032080: 7665 6e20 274d 616b 6566 696c 652e 696e ven 'Makefile.in │ │ │ │ │ +00032090: 270a 2020 2020 2072 6571 7569 7265 732e '. requires. │ │ │ │ │ +000320a0: 2020 2831 2920 5468 6973 206d 6561 6e73 (1) This means │ │ │ │ │ +000320b0: 2074 6861 742c 2066 6f72 2065 7861 6d70 that, for examp │ │ │ │ │ +000320c0: 6c65 2c20 796f 7520 6361 6e27 7420 7075 le, you can't pu │ │ │ │ │ +000320d0: 7420 610a 2020 2020 2063 6f6e 6669 6775 t a. configu │ │ │ │ │ +000320e0: 7265 2073 7562 7374 6974 7574 696f 6e20 re substitution │ │ │ │ │ +000320f0: 6c69 6b65 2027 406d 795f 736f 7572 6365 like '@my_source │ │ │ │ │ +00032100: 7340 2720 696e 746f 2061 2027 5f53 4f55 s@' into a '_SOU │ │ │ │ │ +00032110: 5243 4553 270a 2020 2020 2076 6172 6961 RCES'. varia │ │ │ │ │ +00032120: 626c 652e 2020 4966 2079 6f75 2069 6e74 ble. If you int │ │ │ │ │ +00032130: 656e 6420 746f 2063 6f6e 6469 7469 6f6e end to condition │ │ │ │ │ +00032140: 616c 6c79 2063 6f6d 7069 6c65 2073 6f75 ally compile sou │ │ │ │ │ +00032150: 7263 6520 6669 6c65 7320 616e 640a 2020 rce files and. │ │ │ │ │ +00032160: 2020 2075 7365 2027 636f 6e66 6967 7572 use 'configur │ │ │ │ │ +00032170: 6527 2074 6f20 7375 6273 7469 7475 7465 e' to substitute │ │ │ │ │ +00032180: 2074 6865 2061 7070 726f 7072 6961 7465 the appropriate │ │ │ │ │ +00032190: 206f 626a 6563 7420 6e61 6d65 7320 696e object names in │ │ │ │ │ +000321a0: 746f 2c0a 2020 2020 2065 2e67 2e2c 2027 to,. e.g., ' │ │ │ │ │ +000321b0: 5f4c 4441 4444 2720 2873 6565 2062 656c _LDADD' (see bel │ │ │ │ │ +000321c0: 6f77 292c 2074 6865 6e20 796f 7520 7368 ow), then you sh │ │ │ │ │ +000321d0: 6f75 6c64 206c 6973 7420 7468 6520 636f ould list the co │ │ │ │ │ +000321e0: 7272 6573 706f 6e64 696e 670a 2020 2020 rresponding. │ │ │ │ │ +000321f0: 2073 6f75 7263 6520 6669 6c65 7320 696e source files in │ │ │ │ │ +00032200: 2074 6865 2027 4558 5452 415f 2720 7661 the 'EXTRA_' va │ │ │ │ │ +00032210: 7269 6162 6c65 2e0a 0a20 2020 2020 5468 riable... Th │ │ │ │ │ +00032220: 6973 2076 6172 6961 626c 6520 616c 736f is variable also │ │ │ │ │ +00032230: 2073 7570 706f 7274 7320 2764 6973 745f supports 'dist_ │ │ │ │ │ +00032240: 2720 616e 6420 276e 6f64 6973 745f 2720 ' and 'nodist_' │ │ │ │ │ +00032250: 7072 6566 6978 6573 2e20 2046 6f72 0a20 prefixes. For. │ │ │ │ │ +00032260: 2020 2020 696e 7374 616e 6365 2c20 276e instance, 'n │ │ │ │ │ +00032270: 6f64 6973 745f 4558 5452 415f 6d61 7564 odist_EXTRA_maud │ │ │ │ │ +00032280: 655f 534f 5552 4345 5327 2077 6f75 6c64 e_SOURCES' would │ │ │ │ │ +00032290: 206c 6973 7420 6578 7472 6120 736f 7572 list extra sour │ │ │ │ │ +000322a0: 6365 730a 2020 2020 2074 6861 7420 6d61 ces. that ma │ │ │ │ │ +000322b0: 7920 6e65 6564 2074 6f20 6265 2062 7569 y need to be bui │ │ │ │ │ +000322c0: 6c74 2c20 6275 7420 7368 6f75 6c64 206e lt, but should n │ │ │ │ │ +000322d0: 6f74 2062 6520 6469 7374 7269 6275 7465 ot be distribute │ │ │ │ │ +000322e0: 642e 0a0a 276d 6175 6465 5f41 5227 0a20 d...'maude_AR'. │ │ │ │ │ +000322f0: 2020 2020 4120 7374 6174 6963 206c 6962 A static lib │ │ │ │ │ +00032300: 7261 7279 2069 7320 6372 6561 7465 6420 rary is created │ │ │ │ │ +00032310: 6279 2064 6566 6175 6c74 2062 7920 696e by default by in │ │ │ │ │ +00032320: 766f 6b69 6e67 2027 2428 4152 290a 2020 voking '$(AR). │ │ │ │ │ +00032330: 2020 2024 2841 5246 4c41 4753 2927 2066 $(ARFLAGS)' f │ │ │ │ │ +00032340: 6f6c 6c6f 7765 6420 6279 2074 6865 206e ollowed by the n │ │ │ │ │ +00032350: 616d 6520 6f66 2074 6865 206c 6962 7261 ame of the libra │ │ │ │ │ +00032360: 7279 2061 6e64 2074 6865 6e20 7468 650a ry and then the. │ │ │ │ │ +00032370: 2020 2020 206f 626a 6563 7473 2062 6569 objects bei │ │ │ │ │ +00032380: 6e67 2070 7574 2069 6e74 6f20 7468 6520 ng put into the │ │ │ │ │ +00032390: 6c69 6272 6172 792e 2020 596f 7520 6361 library. You ca │ │ │ │ │ +000323a0: 6e20 6f76 6572 7269 6465 2074 6869 7320 n override this │ │ │ │ │ +000323b0: 6279 0a20 2020 2020 7365 7474 696e 6720 by. setting │ │ │ │ │ +000323c0: 7468 6520 275f 4152 2720 7661 7269 6162 the '_AR' variab │ │ │ │ │ +000323d0: 6c65 2e20 2054 6869 7320 6973 2075 7375 le. This is usu │ │ │ │ │ +000323e0: 616c 6c79 2075 7365 6420 7769 7468 2043 ally used with C │ │ │ │ │ +000323f0: 2b2b 3b20 736f 6d65 0a20 2020 2020 432b ++; some. C+ │ │ │ │ │ +00032400: 2b20 636f 6d70 696c 6572 7320 7265 7175 + compilers requ │ │ │ │ │ +00032410: 6972 6520 6120 7370 6563 6961 6c20 696e ire a special in │ │ │ │ │ +00032420: 766f 6361 7469 6f6e 2069 6e20 6f72 6465 vocation in orde │ │ │ │ │ +00032430: 7220 746f 2069 6e73 7461 6e74 6961 7465 r to instantiate │ │ │ │ │ +00032440: 0a20 2020 2020 616c 6c20 7468 6520 7465 . all the te │ │ │ │ │ +00032450: 6d70 6c61 7465 7320 7468 6174 2073 686f mplates that sho │ │ │ │ │ +00032460: 756c 6420 676f 2069 6e74 6f20 6120 6c69 uld go into a li │ │ │ │ │ +00032470: 6272 6172 792e 2020 466f 7220 696e 7374 brary. For inst │ │ │ │ │ +00032480: 616e 6365 2c20 7468 650a 2020 2020 2053 ance, the. S │ │ │ │ │ +00032490: 4749 2043 2b2b 2063 6f6d 7069 6c65 7220 GI C++ compiler │ │ │ │ │ +000324a0: 6c69 6b65 7320 7468 6973 2076 6172 6961 likes this varia │ │ │ │ │ +000324b0: 626c 6520 7365 7420 6c69 6b65 2073 6f3a ble set like so: │ │ │ │ │ +000324c0: 0a20 2020 2020 2020 2020 206c 6962 6d61 . libma │ │ │ │ │ +000324d0: 7564 655f 615f 4152 203d 2024 2843 5858 ude_a_AR = $(CXX │ │ │ │ │ +000324e0: 2920 2d61 7220 2d6f 0a0a 276d 6175 6465 ) -ar -o..'maude │ │ │ │ │ +000324f0: 5f4c 4942 4144 4427 0a20 2020 2020 4578 _LIBADD'. Ex │ │ │ │ │ +00032500: 7472 6120 6f62 6a65 6374 7320 6361 6e20 tra objects can │ │ │ │ │ +00032510: 6265 2061 6464 6564 2074 6f20 6120 5f6c be added to a _l │ │ │ │ │ +00032520: 6962 7261 7279 5f20 7573 696e 6720 7468 ibrary_ using th │ │ │ │ │ +00032530: 6520 275f 4c49 4241 4444 270a 2020 2020 e '_LIBADD'. │ │ │ │ │ +00032540: 2076 6172 6961 626c 652e 2020 466f 7220 variable. For │ │ │ │ │ +00032550: 696e 7374 616e 6365 2c20 7468 6973 2073 instance, this s │ │ │ │ │ +00032560: 686f 756c 6420 6265 2075 7365 6420 666f hould be used fo │ │ │ │ │ +00032570: 7220 6f62 6a65 6374 7320 6465 7465 726d r objects determ │ │ │ │ │ +00032580: 696e 6564 0a20 2020 2020 6279 2027 636f ined. by 'co │ │ │ │ │ +00032590: 6e66 6967 7572 6527 2028 2a6e 6f74 6520 nfigure' (*note │ │ │ │ │ +000325a0: 4120 4c69 6272 6172 793a 3a29 2e0a 0a20 A Library::)... │ │ │ │ │ +000325b0: 2020 2020 496e 2074 6865 2063 6173 6520 In the case │ │ │ │ │ +000325c0: 6f66 206c 6962 746f 6f6c 206c 6962 7261 of libtool libra │ │ │ │ │ +000325d0: 7269 6573 2c20 276d 6175 6465 5f4c 4942 ries, 'maude_LIB │ │ │ │ │ +000325e0: 4144 4427 2063 616e 2061 6c73 6f20 7265 ADD' can also re │ │ │ │ │ +000325f0: 6665 7220 746f 0a20 2020 2020 6f74 6865 fer to. othe │ │ │ │ │ +00032600: 7220 6c69 6274 6f6f 6c20 6c69 6272 6172 r libtool librar │ │ │ │ │ +00032610: 6965 732e 0a0a 276d 6175 6465 5f4c 4441 ies...'maude_LDA │ │ │ │ │ +00032620: 4444 270a 2020 2020 2045 7874 7261 206f DD'. Extra o │ │ │ │ │ +00032630: 626a 6563 7473 2028 272a 2e24 284f 424a bjects ('*.$(OBJ │ │ │ │ │ +00032640: 4558 5429 2729 2061 6e64 206c 6962 7261 EXT)') and libra │ │ │ │ │ +00032650: 7269 6573 2028 272a 2e61 272c 2027 2a2e ries ('*.a', '*. │ │ │ │ │ +00032660: 6c61 2729 2063 616e 2062 650a 2020 2020 la') can be. │ │ │ │ │ +00032670: 2061 6464 6564 2074 6f20 6120 5f70 726f added to a _pro │ │ │ │ │ +00032680: 6772 616d 5f20 6279 206c 6973 7469 6e67 gram_ by listing │ │ │ │ │ +00032690: 2074 6865 6d20 696e 2074 6865 2027 5f4c them in the '_L │ │ │ │ │ +000326a0: 4441 4444 2720 7661 7269 6162 6c65 2e20 DADD' variable. │ │ │ │ │ +000326b0: 2046 6f72 0a20 2020 2020 696e 7374 616e For. instan │ │ │ │ │ +000326c0: 6365 2c20 7468 6973 2073 686f 756c 6420 ce, this should │ │ │ │ │ +000326d0: 6265 2075 7365 6420 666f 7220 6f62 6a65 be used for obje │ │ │ │ │ +000326e0: 6374 7320 6465 7465 726d 696e 6564 2062 cts determined b │ │ │ │ │ +000326f0: 7920 2763 6f6e 6669 6775 7265 270a 2020 y 'configure'. │ │ │ │ │ +00032700: 2020 2028 2a6e 6f74 6520 4c69 6e6b 696e (*note Linkin │ │ │ │ │ +00032710: 673a 3a29 2e0a 0a20 2020 2020 275f 4c44 g::)... '_LD │ │ │ │ │ +00032720: 4144 4427 2061 6e64 2027 5f4c 4942 4144 ADD' and '_LIBAD │ │ │ │ │ +00032730: 4427 2061 7265 2069 6e61 7070 726f 7072 D' are inappropr │ │ │ │ │ +00032740: 6961 7465 2066 6f72 2070 6173 7369 6e67 iate for passing │ │ │ │ │ +00032750: 0a20 2020 2020 7072 6f67 7261 6d2d 7370 . program-sp │ │ │ │ │ +00032760: 6563 6966 6963 206c 696e 6b65 7220 666c ecific linker fl │ │ │ │ │ +00032770: 6167 7320 2865 7863 6570 7420 666f 7220 ags (except for │ │ │ │ │ +00032780: 272d 6c27 2c20 272d 4c27 2c20 272d 646c '-l', '-L', '-dl │ │ │ │ │ +00032790: 6f70 656e 2720 616e 640a 2020 2020 2027 open' and. ' │ │ │ │ │ +000327a0: 2d64 6c70 7265 6f70 656e 2729 2e20 2055 -dlpreopen'). U │ │ │ │ │ +000327b0: 7365 2074 6865 2027 5f4c 4446 4c41 4753 se the '_LDFLAGS │ │ │ │ │ +000327c0: 2720 7661 7269 6162 6c65 2066 6f72 2074 ' variable for t │ │ │ │ │ +000327d0: 6869 7320 7075 7270 6f73 652e 0a0a 2020 his purpose... │ │ │ │ │ +000327e0: 2020 2046 6f72 2069 6e73 7461 6e63 652c For instance, │ │ │ │ │ +000327f0: 2069 6620 796f 7572 2027 636f 6e66 6967 if your 'config │ │ │ │ │ +00032800: 7572 652e 6163 2720 7573 6573 2027 4143 ure.ac' uses 'AC │ │ │ │ │ +00032810: 5f50 4154 485f 5854 5241 272c 2079 6f75 _PATH_XTRA', you │ │ │ │ │ +00032820: 2063 6f75 6c64 0a20 2020 2020 6c69 6e6b could. link │ │ │ │ │ +00032830: 2079 6f75 7220 7072 6f67 7261 6d20 6167 your program ag │ │ │ │ │ +00032840: 6169 6e73 7420 7468 6520 5820 6c69 6272 ainst the X libr │ │ │ │ │ +00032850: 6172 6965 7320 6c69 6b65 2073 6f3a 0a0a aries like so:.. │ │ │ │ │ +00032860: 2020 2020 2020 2020 2020 6d61 7564 655f maude_ │ │ │ │ │ +00032870: 4c44 4144 4420 3d20 2428 585f 5052 455f LDADD = $(X_PRE_ │ │ │ │ │ +00032880: 4c49 4253 2920 2428 585f 4c49 4253 2920 LIBS) $(X_LIBS) │ │ │ │ │ +00032890: 2428 585f 4558 5452 415f 4c49 4253 290a $(X_EXTRA_LIBS). │ │ │ │ │ +000328a0: 0a20 2020 2020 5765 2072 6563 6f6d 6d65 . We recomme │ │ │ │ │ +000328b0: 6e64 2074 6861 7420 796f 7520 7573 6520 nd that you use │ │ │ │ │ +000328c0: 272d 6c27 2061 6e64 2027 2d4c 2720 6f6e '-l' and '-L' on │ │ │ │ │ +000328d0: 6c79 2077 6865 6e20 7265 6665 7272 696e ly when referrin │ │ │ │ │ +000328e0: 6720 746f 0a20 2020 2020 7468 6972 642d g to. third- │ │ │ │ │ +000328f0: 7061 7274 7920 6c69 6272 6172 6965 732c party libraries, │ │ │ │ │ +00032900: 2061 6e64 2067 6976 6520 7468 6520 6578 and give the ex │ │ │ │ │ +00032910: 706c 6963 6974 2066 696c 6520 6e61 6d65 plicit file name │ │ │ │ │ +00032920: 7320 6f66 2061 6e79 0a20 2020 2020 6c69 s of any. li │ │ │ │ │ +00032930: 6272 6172 7920 6275 696c 7420 6279 2079 brary built by y │ │ │ │ │ +00032940: 6f75 7220 7061 636b 6167 652e 2020 446f our package. Do │ │ │ │ │ +00032950: 696e 6720 736f 2077 696c 6c20 656e 7375 ing so will ensu │ │ │ │ │ +00032960: 7265 2074 6861 740a 2020 2020 2027 6d61 re that. 'ma │ │ │ │ │ +00032970: 7564 655f 4445 5045 4e44 454e 4349 4553 ude_DEPENDENCIES │ │ │ │ │ +00032980: 2720 2873 6565 2062 656c 6f77 2920 6973 ' (see below) is │ │ │ │ │ +00032990: 2063 6f72 7265 6374 6c79 2064 6566 696e correctly defin │ │ │ │ │ +000329a0: 6564 2062 7920 6465 6661 756c 742e 0a0a ed by default... │ │ │ │ │ +000329b0: 276d 6175 6465 5f4c 4446 4c41 4753 270a 'maude_LDFLAGS'. │ │ │ │ │ +000329c0: 2020 2020 2054 6869 7320 7661 7269 6162 This variab │ │ │ │ │ +000329d0: 6c65 2069 7320 7573 6564 2074 6f20 7061 le is used to pa │ │ │ │ │ +000329e0: 7373 2065 7874 7261 2066 6c61 6773 2074 ss extra flags t │ │ │ │ │ +000329f0: 6f20 7468 6520 6c69 6e6b 2073 7465 7020 o the link step │ │ │ │ │ +00032a00: 6f66 2061 0a20 2020 2020 7072 6f67 7261 of a. progra │ │ │ │ │ +00032a10: 6d20 6f72 2061 2073 6861 7265 6420 6c69 m or a shared li │ │ │ │ │ +00032a20: 6272 6172 792e 2020 4974 206f 7665 7272 brary. It overr │ │ │ │ │ +00032a30: 6964 6573 2074 6865 2027 414d 5f4c 4446 ides the 'AM_LDF │ │ │ │ │ +00032a40: 4c41 4753 270a 2020 2020 2076 6172 6961 LAGS'. varia │ │ │ │ │ +00032a50: 626c 652e 0a0a 276d 6175 6465 5f4c 4942 ble...'maude_LIB │ │ │ │ │ +00032a60: 544f 4f4c 464c 4147 5327 0a20 2020 2020 TOOLFLAGS'. │ │ │ │ │ +00032a70: 5468 6973 2076 6172 6961 626c 6520 6973 This variable is │ │ │ │ │ +00032a80: 2075 7365 6420 746f 2070 6173 7320 6578 used to pass ex │ │ │ │ │ +00032a90: 7472 6120 6f70 7469 6f6e 7320 746f 2027 tra options to ' │ │ │ │ │ +00032aa0: 6c69 6274 6f6f 6c27 2e20 2049 740a 2020 libtool'. It. │ │ │ │ │ +00032ab0: 2020 206f 7665 7272 6964 6573 2074 6865 overrides the │ │ │ │ │ +00032ac0: 2027 414d 5f4c 4942 544f 4f4c 464c 4147 'AM_LIBTOOLFLAG │ │ │ │ │ +00032ad0: 5327 2076 6172 6961 626c 652e 2020 5468 S' variable. Th │ │ │ │ │ +00032ae0: 6573 6520 6f70 7469 6f6e 7320 6172 6520 ese options are │ │ │ │ │ +00032af0: 6f75 7470 7574 0a20 2020 2020 6265 666f output. befo │ │ │ │ │ +00032b00: 7265 2027 6c69 6274 6f6f 6c27 2773 2027 re 'libtool''s ' │ │ │ │ │ +00032b10: 2d2d 6d6f 6465 3d4d 4f44 4527 206f 7074 --mode=MODE' opt │ │ │ │ │ +00032b20: 696f 6e2c 2073 6f20 7468 6579 2073 686f ion, so they sho │ │ │ │ │ +00032b30: 756c 6420 6e6f 7420 6265 0a20 2020 2020 uld not be. │ │ │ │ │ +00032b40: 6d6f 6465 2d73 7065 6369 6669 6320 6f70 mode-specific op │ │ │ │ │ +00032b50: 7469 6f6e 7320 2874 686f 7365 2062 656c tions (those bel │ │ │ │ │ +00032b60: 6f6e 6720 746f 2074 6865 2063 6f6d 7069 ong to the compi │ │ │ │ │ +00032b70: 6c65 7220 6f72 206c 696e 6b65 720a 2020 ler or linker. │ │ │ │ │ +00032b80: 2020 2066 6c61 6773 292e 2020 2a4e 6f74 flags). *Not │ │ │ │ │ +00032b90: 6520 4c69 6274 6f6f 6c20 466c 6167 733a e Libtool Flags: │ │ │ │ │ +00032ba0: 3a2e 0a0a 276d 6175 6465 5f44 4550 454e :...'maude_DEPEN │ │ │ │ │ +00032bb0: 4445 4e43 4945 5327 0a27 4558 5452 415f DENCIES'.'EXTRA_ │ │ │ │ │ +00032bc0: 6d61 7564 655f 4445 5045 4e44 454e 4349 maude_DEPENDENCI │ │ │ │ │ +00032bd0: 4553 270a 2020 2020 2049 7420 6973 2061 ES'. It is a │ │ │ │ │ +00032be0: 6c73 6f20 6f63 6361 7369 6f6e 616c 6c79 lso occasionally │ │ │ │ │ +00032bf0: 2075 7365 6675 6c20 746f 2068 6176 6520 useful to have │ │ │ │ │ +00032c00: 6120 7461 7267 6574 2028 7072 6f67 7261 a target (progra │ │ │ │ │ +00032c10: 6d20 6f72 0a20 2020 2020 6c69 6272 6172 m or. librar │ │ │ │ │ +00032c20: 7929 2064 6570 656e 6420 6f6e 2073 6f6d y) depend on som │ │ │ │ │ +00032c30: 6520 6f74 6865 7220 6669 6c65 2074 6861 e other file tha │ │ │ │ │ +00032c40: 7420 6973 206e 6f74 2061 6374 7561 6c6c t is not actuall │ │ │ │ │ +00032c50: 7920 7061 7274 206f 660a 2020 2020 2074 y part of. t │ │ │ │ │ +00032c60: 6861 7420 7461 7267 6574 2e20 2054 6869 hat target. Thi │ │ │ │ │ +00032c70: 7320 6361 6e20 6265 2064 6f6e 6520 7573 s can be done us │ │ │ │ │ +00032c80: 696e 6720 7468 6520 275f 4445 5045 4e44 ing the '_DEPEND │ │ │ │ │ +00032c90: 454e 4349 4553 2720 7661 7269 6162 6c65 ENCIES' variable │ │ │ │ │ +00032ca0: 2e0a 2020 2020 2045 6163 6820 7461 7267 .. Each targ │ │ │ │ │ +00032cb0: 6574 2064 6570 656e 6473 206f 6e20 7468 et depends on th │ │ │ │ │ +00032cc0: 6520 636f 6e74 656e 7473 206f 6620 7375 e contents of su │ │ │ │ │ +00032cd0: 6368 2061 2076 6172 6961 626c 652c 2062 ch a variable, b │ │ │ │ │ +00032ce0: 7574 206e 6f0a 2020 2020 2066 7572 7468 ut no. furth │ │ │ │ │ +00032cf0: 6572 2069 6e74 6572 7072 6574 6174 696f er interpretatio │ │ │ │ │ +00032d00: 6e20 6973 2064 6f6e 652e 0a0a 2020 2020 n is done... │ │ │ │ │ +00032d10: 2053 696e 6365 2074 6865 7365 2064 6570 Since these dep │ │ │ │ │ +00032d20: 656e 6465 6e63 6965 7320 6172 6520 6173 endencies are as │ │ │ │ │ +00032d30: 736f 6369 6174 6564 2074 6f20 7468 6520 sociated to the │ │ │ │ │ +00032d40: 6c69 6e6b 2072 756c 6520 7573 6564 2074 link rule used t │ │ │ │ │ +00032d50: 6f0a 2020 2020 2063 7265 6174 6520 7468 o. create th │ │ │ │ │ +00032d60: 6520 7072 6f67 7261 6d73 2074 6865 7920 e programs they │ │ │ │ │ +00032d70: 7368 6f75 6c64 206e 6f72 6d61 6c6c 7920 should normally │ │ │ │ │ +00032d80: 6c69 7374 2066 696c 6573 2075 7365 6420 list files used │ │ │ │ │ +00032d90: 6279 2074 6865 0a20 2020 2020 6c69 6e6b by the. link │ │ │ │ │ +00032da0: 2063 6f6d 6d61 6e64 2e20 2054 6861 7420 command. That │ │ │ │ │ +00032db0: 6973 2027 2a2e 2428 4f42 4a45 5854 2927 is '*.$(OBJEXT)' │ │ │ │ │ +00032dc0: 2c20 272a 2e61 272c 206f 7220 272a 2e6c , '*.a', or '*.l │ │ │ │ │ +00032dd0: 6127 2066 696c 6573 2066 6f72 0a20 2020 a' files for. │ │ │ │ │ +00032de0: 2020 7072 6f67 7261 6d73 3b20 272a 2e6c programs; '*.l │ │ │ │ │ +00032df0: 6f27 2061 6e64 2027 2a2e 6c61 2720 6669 o' and '*.la' fi │ │ │ │ │ +00032e00: 6c65 7320 666f 7220 4c69 6274 6f6f 6c20 les for Libtool │ │ │ │ │ +00032e10: 6c69 6272 6172 6965 733b 2061 6e64 0a20 libraries; and. │ │ │ │ │ +00032e20: 2020 2020 272a 2e24 284f 424a 4558 5429 '*.$(OBJEXT) │ │ │ │ │ +00032e30: 2720 6669 6c65 7320 666f 7220 7374 6174 ' files for stat │ │ │ │ │ +00032e40: 6963 206c 6962 7261 7269 6573 2e20 2049 ic libraries. I │ │ │ │ │ +00032e50: 6e20 7261 7265 2063 6173 6573 2079 6f75 n rare cases you │ │ │ │ │ +00032e60: 206d 6179 0a20 2020 2020 6e65 6564 2074 may. need t │ │ │ │ │ +00032e70: 6f20 6164 6420 6f74 6865 7220 6b69 6e64 o add other kind │ │ │ │ │ +00032e80: 7320 6f66 2066 696c 6573 2073 7563 6820 s of files such │ │ │ │ │ +00032e90: 6173 206c 696e 6b65 7220 7363 7269 7074 as linker script │ │ │ │ │ +00032ea0: 732c 2062 7574 0a20 2020 2020 5f6c 6973 s, but. _lis │ │ │ │ │ +00032eb0: 7469 6e67 2061 2073 6f75 7263 6520 6669 ting a source fi │ │ │ │ │ +00032ec0: 6c65 2069 6e20 275f 4445 5045 4e44 454e le in '_DEPENDEN │ │ │ │ │ +00032ed0: 4349 4553 2720 6973 2077 726f 6e67 5f2e CIES' is wrong_. │ │ │ │ │ +00032ee0: 2020 4966 2073 6f6d 650a 2020 2020 2073 If some. s │ │ │ │ │ +00032ef0: 6f75 7263 6520 6669 6c65 206e 6565 6473 ource file needs │ │ │ │ │ +00032f00: 2074 6f20 6265 2062 7569 6c74 2062 6566 to be built bef │ │ │ │ │ +00032f10: 6f72 6520 616c 6c20 7468 6520 636f 6d70 ore all the comp │ │ │ │ │ +00032f20: 6f6e 656e 7473 206f 6620 610a 2020 2020 onents of a. │ │ │ │ │ +00032f30: 2070 726f 6772 616d 2061 7265 2062 7569 program are bui │ │ │ │ │ +00032f40: 6c74 2c20 636f 6e73 6964 6572 2075 7369 lt, consider usi │ │ │ │ │ +00032f50: 6e67 2074 6865 2027 4255 494c 545f 534f ng the 'BUILT_SO │ │ │ │ │ +00032f60: 5552 4345 5327 2076 6172 6961 626c 650a URCES' variable. │ │ │ │ │ +00032f70: 2020 2020 2028 2a6e 6f74 6520 536f 7572 (*note Sour │ │ │ │ │ +00032f80: 6365 733a 3a29 2e0a 0a20 2020 2020 4966 ces::)... If │ │ │ │ │ +00032f90: 2027 5f44 4550 454e 4445 4e43 4945 5327 '_DEPENDENCIES' │ │ │ │ │ +00032fa0: 2069 7320 6e6f 7420 7375 7070 6c69 6564 is not supplied │ │ │ │ │ +00032fb0: 2c20 6974 2069 7320 636f 6d70 7574 6564 , it is computed │ │ │ │ │ +00032fc0: 2062 7920 4175 746f 6d61 6b65 2e0a 2020 by Automake.. │ │ │ │ │ +00032fd0: 2020 2054 6865 2061 7574 6f6d 6174 6963 The automatic │ │ │ │ │ +00032fe0: 616c 6c79 2d61 7373 6967 6e65 6420 7661 ally-assigned va │ │ │ │ │ +00032ff0: 6c75 6520 6973 2074 6865 2063 6f6e 7465 lue is the conte │ │ │ │ │ +00033000: 6e74 7320 6f66 2027 5f4c 4441 4444 2720 nts of '_LDADD' │ │ │ │ │ +00033010: 6f72 0a20 2020 2020 275f 4c49 4241 4444 or. '_LIBADD │ │ │ │ │ +00033020: 272c 2077 6974 6820 6d6f 7374 2063 6f6e ', with most con │ │ │ │ │ +00033030: 6669 6775 7265 2073 7562 7374 6974 7574 figure substitut │ │ │ │ │ +00033040: 696f 6e73 2c20 272d 6c27 2c20 272d 4c27 ions, '-l', '-L' │ │ │ │ │ +00033050: 2c20 272d 646c 6f70 656e 270a 2020 2020 , '-dlopen'. │ │ │ │ │ +00033060: 2061 6e64 2027 2d64 6c70 7265 6f70 656e and '-dlpreopen │ │ │ │ │ +00033070: 2720 6f70 7469 6f6e 7320 7265 6d6f 7665 ' options remove │ │ │ │ │ +00033080: 642e 2020 5468 6520 636f 6e66 6967 7572 d. The configur │ │ │ │ │ +00033090: 6520 7375 6273 7469 7475 7469 6f6e 7320 e substitutions │ │ │ │ │ +000330a0: 7468 6174 0a20 2020 2020 6172 6520 6c65 that. are le │ │ │ │ │ +000330b0: 6674 2069 6e20 6172 6520 6f6e 6c79 2027 ft in are only ' │ │ │ │ │ +000330c0: 2428 4c49 424f 424a 5329 2720 616e 6420 $(LIBOBJS)' and │ │ │ │ │ +000330d0: 2724 2841 4c4c 4f43 4129 273b 2074 6865 '$(ALLOCA)'; the │ │ │ │ │ +000330e0: 7365 2061 7265 206c 6566 740a 2020 2020 se are left. │ │ │ │ │ +000330f0: 2062 6563 6175 7365 2069 7420 6973 206b because it is k │ │ │ │ │ +00033100: 6e6f 776e 2074 6861 7420 7468 6579 2077 nown that they w │ │ │ │ │ +00033110: 696c 6c20 6e6f 7420 6361 7573 6520 616e ill not cause an │ │ │ │ │ +00033120: 2069 6e76 616c 6964 2076 616c 7565 2066 invalid value f │ │ │ │ │ +00033130: 6f72 0a20 2020 2020 275f 4445 5045 4e44 or. '_DEPEND │ │ │ │ │ +00033140: 454e 4349 4553 2720 746f 2062 6520 6765 ENCIES' to be ge │ │ │ │ │ +00033150: 6e65 7261 7465 642e 0a0a 2020 2020 2027 nerated... ' │ │ │ │ │ +00033160: 5f44 4550 454e 4445 4e43 4945 5327 2069 _DEPENDENCIES' i │ │ │ │ │ +00033170: 7320 6d6f 7265 206c 696b 656c 7920 7573 s more likely us │ │ │ │ │ +00033180: 6564 2074 6f20 7065 7266 6f72 6d20 636f ed to perform co │ │ │ │ │ +00033190: 6e64 6974 696f 6e61 6c0a 2020 2020 2063 nditional. c │ │ │ │ │ +000331a0: 6f6d 7069 6c61 7469 6f6e 2075 7369 6e67 ompilation using │ │ │ │ │ +000331b0: 2061 6e20 2741 435f 5355 4253 5427 2076 an 'AC_SUBST' v │ │ │ │ │ +000331c0: 6172 6961 626c 6520 7468 6174 2063 6f6e ariable that con │ │ │ │ │ +000331d0: 7461 696e 7320 6120 6c69 7374 206f 660a tains a list of. │ │ │ │ │ +000331e0: 2020 2020 206f 626a 6563 7473 2e20 202a objects. * │ │ │ │ │ +000331f0: 4e6f 7465 2043 6f6e 6469 7469 6f6e 616c Note Conditional │ │ │ │ │ +00033200: 2053 6f75 7263 6573 3a3a 2c20 616e 6420 Sources::, and │ │ │ │ │ +00033210: 2a6e 6f74 6520 436f 6e64 6974 696f 6e61 *note Conditiona │ │ │ │ │ +00033220: 6c0a 2020 2020 204c 6962 746f 6f6c 2053 l. Libtool S │ │ │ │ │ +00033230: 6f75 7263 6573 3a3a 2e0a 0a20 2020 2020 ources::... │ │ │ │ │ +00033240: 5468 6520 2745 5854 5241 5f2a 5f44 4550 The 'EXTRA_*_DEP │ │ │ │ │ +00033250: 454e 4445 4e43 4945 5327 2076 6172 6961 ENDENCIES' varia │ │ │ │ │ +00033260: 626c 6520 6d61 7920 6265 2075 7365 6675 ble may be usefu │ │ │ │ │ +00033270: 6c20 666f 7220 6361 7365 7320 7768 6572 l for cases wher │ │ │ │ │ +00033280: 650a 2020 2020 2079 6f75 206d 6572 656c e. you merel │ │ │ │ │ +00033290: 7920 7761 6e74 2074 6f20 6175 676d 656e y want to augmen │ │ │ │ │ +000332a0: 7420 7468 6520 2761 7574 6f6d 616b 6527 t the 'automake' │ │ │ │ │ +000332b0: 2d67 656e 6572 6174 6564 2027 5f44 4550 -generated '_DEP │ │ │ │ │ +000332c0: 454e 4445 4e43 4945 5327 0a20 2020 2020 ENDENCIES'. │ │ │ │ │ +000332d0: 7661 7269 6162 6c65 2072 6174 6865 7220 variable rather │ │ │ │ │ +000332e0: 7468 616e 2072 6570 6c61 6369 6e67 2069 than replacing i │ │ │ │ │ +000332f0: 742e 0a0a 276d 6175 6465 5f4c 494e 4b27 t...'maude_LINK' │ │ │ │ │ +00033300: 0a20 2020 2020 596f 7520 6361 6e20 6f76 . You can ov │ │ │ │ │ +00033310: 6572 7269 6465 2074 6865 206c 696e 6b65 erride the linke │ │ │ │ │ +00033320: 7220 6f6e 2061 2070 6572 2d70 726f 6772 r on a per-progr │ │ │ │ │ +00033330: 616d 2062 6173 6973 2e20 2042 7920 6465 am basis. By de │ │ │ │ │ +00033340: 6661 756c 7420 7468 650a 2020 2020 206c fault the. l │ │ │ │ │ +00033350: 696e 6b65 7220 6973 2063 686f 7365 6e20 inker is chosen │ │ │ │ │ +00033360: 6163 636f 7264 696e 6720 746f 2074 6865 according to the │ │ │ │ │ +00033370: 206c 616e 6775 6167 6573 2075 7365 6420 languages used │ │ │ │ │ +00033380: 6279 2074 6865 2070 726f 6772 616d 2e0a by the program.. │ │ │ │ │ +00033390: 2020 2020 2046 6f72 2069 6e73 7461 6e63 For instanc │ │ │ │ │ +000333a0: 652c 2061 2070 726f 6772 616d 2074 6861 e, a program tha │ │ │ │ │ +000333b0: 7420 696e 636c 7564 6573 2043 2b2b 2073 t includes C++ s │ │ │ │ │ +000333c0: 6f75 7263 6520 636f 6465 2077 6f75 6c64 ource code would │ │ │ │ │ +000333d0: 2075 7365 2074 6865 0a20 2020 2020 432b use the. C+ │ │ │ │ │ +000333e0: 2b20 636f 6d70 696c 6572 2074 6f20 6c69 + compiler to li │ │ │ │ │ +000333f0: 6e6b 2e20 2054 6865 2027 5f4c 494e 4b27 nk. The '_LINK' │ │ │ │ │ +00033400: 2076 6172 6961 626c 6520 6d75 7374 2068 variable must h │ │ │ │ │ +00033410: 6f6c 6420 7468 6520 6e61 6d65 206f 6620 old the name of │ │ │ │ │ +00033420: 610a 2020 2020 2063 6f6d 6d61 6e64 2074 a. command t │ │ │ │ │ +00033430: 6861 7420 6361 6e20 6265 2070 6173 7365 hat can be passe │ │ │ │ │ +00033440: 6420 616c 6c20 7468 6520 272e 6f27 2066 d all the '.o' f │ │ │ │ │ +00033450: 696c 6520 6e61 6d65 7320 616e 6420 6c69 ile names and li │ │ │ │ │ +00033460: 6272 6172 6965 7320 746f 0a20 2020 2020 braries to. │ │ │ │ │ +00033470: 6c69 6e6b 2061 6761 696e 7374 2061 7320 link against as │ │ │ │ │ +00033480: 6172 6775 6d65 6e74 732e 2020 4e6f 7465 arguments. Note │ │ │ │ │ +00033490: 2074 6861 7420 7468 6520 6e61 6d65 206f that the name o │ │ │ │ │ +000334a0: 6620 7468 6520 756e 6465 726c 7969 6e67 f the underlying │ │ │ │ │ +000334b0: 0a20 2020 2020 7072 6f67 7261 6d20 6973 . program is │ │ │ │ │ +000334c0: 205f 6e6f 745f 2070 6173 7365 6420 746f _not_ passed to │ │ │ │ │ +000334d0: 2027 5f4c 494e 4b27 3b20 7479 7069 6361 '_LINK'; typica │ │ │ │ │ +000334e0: 6c6c 7920 6f6e 6520 7573 6573 2027 2440 lly one uses '$@ │ │ │ │ │ +000334f0: 273a 0a0a 2020 2020 2020 2020 2020 6d61 ':.. ma │ │ │ │ │ +00033500: 7564 655f 4c49 4e4b 203d 2024 2843 434c ude_LINK = $(CCL │ │ │ │ │ +00033510: 4429 202d 6d61 6769 6320 2d6f 2024 400a D) -magic -o $@. │ │ │ │ │ +00033520: 0a20 2020 2020 4966 2061 2027 5f4c 494e . If a '_LIN │ │ │ │ │ +00033530: 4b27 2076 6172 6961 626c 6520 6973 206e K' variable is n │ │ │ │ │ +00033540: 6f74 2073 7570 706c 6965 642c 2069 7420 ot supplied, it │ │ │ │ │ +00033550: 6d61 7920 7374 696c 6c20 6265 2067 656e may still be gen │ │ │ │ │ +00033560: 6572 6174 6564 0a20 2020 2020 616e 6420 erated. and │ │ │ │ │ +00033570: 7573 6564 2062 7920 4175 746f 6d61 6b65 used by Automake │ │ │ │ │ +00033580: 2064 7565 2074 6f20 7468 6520 7573 6520 due to the use │ │ │ │ │ +00033590: 6f66 2070 6572 2d74 6172 6765 7420 6c69 of per-target li │ │ │ │ │ +000335a0: 6e6b 2066 6c61 6773 2073 7563 680a 2020 nk flags such. │ │ │ │ │ +000335b0: 2020 2061 7320 275f 4346 4c41 4753 272c as '_CFLAGS', │ │ │ │ │ +000335c0: 2027 5f4c 4446 4c41 4753 2720 6f72 2027 '_LDFLAGS' or ' │ │ │ │ │ +000335d0: 5f4c 4942 544f 4f4c 464c 4147 5327 2c20 _LIBTOOLFLAGS', │ │ │ │ │ +000335e0: 696e 2063 6173 6573 2077 6865 7265 2074 in cases where t │ │ │ │ │ +000335f0: 6865 790a 2020 2020 2061 7070 6c79 2e0a hey. apply.. │ │ │ │ │ +00033600: 0a27 6d61 7564 655f 4343 4153 464c 4147 .'maude_CCASFLAG │ │ │ │ │ +00033610: 5327 0a27 6d61 7564 655f 4346 4c41 4753 S'.'maude_CFLAGS │ │ │ │ │ +00033620: 270a 276d 6175 6465 5f43 5050 464c 4147 '.'maude_CPPFLAG │ │ │ │ │ +00033630: 5327 0a27 6d61 7564 655f 4358 5846 4c41 S'.'maude_CXXFLA │ │ │ │ │ +00033640: 4753 270a 276d 6175 6465 5f46 464c 4147 GS'.'maude_FFLAG │ │ │ │ │ +00033650: 5327 0a27 6d61 7564 655f 4743 4a46 4c41 S'.'maude_GCJFLA │ │ │ │ │ +00033660: 4753 270a 276d 6175 6465 5f4c 464c 4147 GS'.'maude_LFLAG │ │ │ │ │ +00033670: 5327 0a27 6d61 7564 655f 4f42 4a43 464c S'.'maude_OBJCFL │ │ │ │ │ +00033680: 4147 5327 0a27 6d61 7564 655f 5246 4c41 AGS'.'maude_RFLA │ │ │ │ │ +00033690: 4753 270a 276d 6175 6465 5f55 5043 464c GS'.'maude_UPCFL │ │ │ │ │ +000336a0: 4147 5327 0a27 6d61 7564 655f 5946 4c41 AGS'.'maude_YFLA │ │ │ │ │ +000336b0: 4753 270a 2020 2020 2041 7574 6f6d 616b GS'. Automak │ │ │ │ │ +000336c0: 6520 616c 6c6f 7773 2079 6f75 2074 6f20 e allows you to │ │ │ │ │ +000336d0: 7365 7420 636f 6d70 696c 6174 696f 6e20 set compilation │ │ │ │ │ +000336e0: 666c 6167 7320 6f6e 2061 2070 6572 2d70 flags on a per-p │ │ │ │ │ +000336f0: 726f 6772 616d 2028 6f72 0a20 2020 2020 rogram (or. │ │ │ │ │ +00033700: 7065 722d 6c69 6272 6172 7929 2062 6173 per-library) bas │ │ │ │ │ +00033710: 6973 2e20 2041 2073 696e 676c 6520 736f is. A single so │ │ │ │ │ +00033720: 7572 6365 2066 696c 6520 6361 6e20 6265 urce file can be │ │ │ │ │ +00033730: 2069 6e63 6c75 6465 6420 696e 0a20 2020 included in. │ │ │ │ │ +00033740: 2020 7365 7665 7261 6c20 7072 6f67 7261 several progra │ │ │ │ │ +00033750: 6d73 2c20 616e 6420 6974 2077 696c 6c20 ms, and it will │ │ │ │ │ +00033760: 706f 7465 6e74 6961 6c6c 7920 6265 2063 potentially be c │ │ │ │ │ +00033770: 6f6d 7069 6c65 6420 7769 7468 0a20 2020 ompiled with. │ │ │ │ │ +00033780: 2020 6469 6666 6572 656e 7420 666c 6167 different flag │ │ │ │ │ +00033790: 7320 666f 7220 6561 6368 2070 726f 6772 s for each progr │ │ │ │ │ +000337a0: 616d 2e20 2054 6869 7320 776f 726b 7320 am. This works │ │ │ │ │ +000337b0: 666f 7220 616e 7920 6c61 6e67 7561 6765 for any language │ │ │ │ │ +000337c0: 0a20 2020 2020 6469 7265 6374 6c79 2073 . directly s │ │ │ │ │ +000337d0: 7570 706f 7274 6564 2062 7920 4175 746f upported by Auto │ │ │ │ │ +000337e0: 6d61 6b65 2e20 2054 6865 7365 2022 7065 make. These "pe │ │ │ │ │ +000337f0: 722d 7461 7267 6574 2063 6f6d 7069 6c61 r-target compila │ │ │ │ │ +00033800: 7469 6f6e 0a20 2020 2020 666c 6167 7322 tion. flags" │ │ │ │ │ +00033810: 2061 7265 2027 5f43 4341 5346 4c41 4753 are '_CCASFLAGS │ │ │ │ │ +00033820: 272c 2027 5f43 464c 4147 5327 2c20 275f ', '_CFLAGS', '_ │ │ │ │ │ +00033830: 4350 5046 4c41 4753 272c 2027 5f43 5858 CPPFLAGS', '_CXX │ │ │ │ │ +00033840: 464c 4147 5327 2c0a 2020 2020 2027 5f46 FLAGS',. '_F │ │ │ │ │ +00033850: 464c 4147 5327 2c20 275f 4743 4a46 4c41 FLAGS', '_GCJFLA │ │ │ │ │ +00033860: 4753 272c 2027 5f4c 464c 4147 5327 2c20 GS', '_LFLAGS', │ │ │ │ │ +00033870: 275f 4f42 4a43 464c 4147 5327 2c20 275f '_OBJCFLAGS', '_ │ │ │ │ │ +00033880: 5246 4c41 4753 272c 0a20 2020 2020 275f RFLAGS',. '_ │ │ │ │ │ +00033890: 5550 4346 4c41 4753 272c 2061 6e64 2027 UPCFLAGS', and ' │ │ │ │ │ +000338a0: 5f59 464c 4147 5327 2e0a 0a20 2020 2020 _YFLAGS'... │ │ │ │ │ +000338b0: 5768 656e 2075 7369 6e67 2061 2070 6572 When using a per │ │ │ │ │ +000338c0: 2d74 6172 6765 7420 636f 6d70 696c 6174 -target compilat │ │ │ │ │ +000338d0: 696f 6e20 666c 6167 2c20 4175 746f 6d61 ion flag, Automa │ │ │ │ │ +000338e0: 6b65 2077 696c 6c20 6368 6f6f 7365 2061 ke will choose a │ │ │ │ │ +000338f0: 0a20 2020 2020 6469 6666 6572 656e 7420 . different │ │ │ │ │ +00033900: 6e61 6d65 2066 6f72 2074 6865 2069 6e74 name for the int │ │ │ │ │ +00033910: 6572 6d65 6469 6174 6520 6f62 6a65 6374 ermediate object │ │ │ │ │ +00033920: 2066 696c 6573 2e20 204f 7264 696e 6172 files. Ordinar │ │ │ │ │ +00033930: 696c 7920 610a 2020 2020 2066 696c 6520 ily a. file │ │ │ │ │ +00033940: 6c69 6b65 2027 7361 6d70 6c65 2e63 2720 like 'sample.c' │ │ │ │ │ +00033950: 7769 6c6c 2062 6520 636f 6d70 696c 6564 will be compiled │ │ │ │ │ +00033960: 2074 6f20 7072 6f64 7563 6520 2773 616d to produce 'sam │ │ │ │ │ +00033970: 706c 652e 6f27 2e0a 2020 2020 2048 6f77 ple.o'.. How │ │ │ │ │ +00033980: 6576 6572 2c20 6966 2074 6865 2070 726f ever, if the pro │ │ │ │ │ +00033990: 6772 616d 2773 2027 5f43 464c 4147 5327 gram's '_CFLAGS' │ │ │ │ │ +000339a0: 2076 6172 6961 626c 6520 6973 2073 6574 variable is set │ │ │ │ │ +000339b0: 2c20 7468 656e 2074 6865 0a20 2020 2020 , then the. │ │ │ │ │ +000339c0: 6f62 6a65 6374 2066 696c 6520 7769 6c6c object file will │ │ │ │ │ +000339d0: 2062 6520 6e61 6d65 642c 2066 6f72 2069 be named, for i │ │ │ │ │ +000339e0: 6e73 7461 6e63 652c 2027 6d61 7564 652d nstance, 'maude- │ │ │ │ │ +000339f0: 7361 6d70 6c65 2e6f 272e 2020 2853 6565 sample.o'. (See │ │ │ │ │ +00033a00: 0a20 2020 2020 616c 736f 202a 6e6f 7465 . also *note │ │ │ │ │ +00033a10: 2052 656e 616d 6564 204f 626a 6563 7473 Renamed Objects │ │ │ │ │ +00033a20: 3a3a 2e29 2020 5468 6520 7573 6520 6f66 ::.) The use of │ │ │ │ │ +00033a30: 2070 6572 2d74 6172 6765 7420 636f 6d70 per-target comp │ │ │ │ │ +00033a40: 696c 6174 696f 6e0a 2020 2020 2066 6c61 ilation. fla │ │ │ │ │ +00033a50: 6773 2077 6974 6820 4320 736f 7572 6365 gs with C source │ │ │ │ │ +00033a60: 7320 7265 7175 6972 6573 2074 6861 7420 s requires that │ │ │ │ │ +00033a70: 7468 6520 6d61 6372 6f20 2741 4d5f 5052 the macro 'AM_PR │ │ │ │ │ +00033a80: 4f47 5f43 435f 435f 4f27 2062 650a 2020 OG_CC_C_O' be. │ │ │ │ │ +00033a90: 2020 2063 616c 6c65 6420 6672 6f6d 2027 called from ' │ │ │ │ │ +00033aa0: 636f 6e66 6967 7572 652e 6163 272e 0a0a configure.ac'... │ │ │ │ │ +00033ab0: 2020 2020 2049 6e20 636f 6d70 696c 6174 In compilat │ │ │ │ │ +00033ac0: 696f 6e73 2077 6974 6820 7065 722d 7461 ions with per-ta │ │ │ │ │ +00033ad0: 7267 6574 2066 6c61 6773 2c20 7468 6520 rget flags, the │ │ │ │ │ +00033ae0: 6f72 6469 6e61 7279 2027 414d 5f27 2066 ordinary 'AM_' f │ │ │ │ │ +00033af0: 6f72 6d20 6f66 0a20 2020 2020 7468 6520 orm of. the │ │ │ │ │ +00033b00: 666c 6167 7320 7661 7269 6162 6c65 2069 flags variable i │ │ │ │ │ +00033b10: 7320 5f6e 6f74 5f20 6175 746f 6d61 7469 s _not_ automati │ │ │ │ │ +00033b20: 6361 6c6c 7920 696e 636c 7564 6564 2069 cally included i │ │ │ │ │ +00033b30: 6e20 7468 650a 2020 2020 2063 6f6d 7069 n the. compi │ │ │ │ │ +00033b40: 6c61 7469 6f6e 2028 686f 7765 7665 722c lation (however, │ │ │ │ │ +00033b50: 2074 6865 2075 7365 7220 666f 726d 206f the user form o │ │ │ │ │ +00033b60: 6620 7468 6520 7661 7269 6162 6c65 205f f the variable _ │ │ │ │ │ +00033b70: 6973 5f20 696e 636c 7564 6564 292e 0a20 is_ included).. │ │ │ │ │ +00033b80: 2020 2020 536f 2066 6f72 2069 6e73 7461 So for insta │ │ │ │ │ +00033b90: 6e63 652c 2069 6620 796f 7520 7761 6e74 nce, if you want │ │ │ │ │ +00033ba0: 2074 6865 2068 7970 6f74 6865 7469 6361 the hypothetica │ │ │ │ │ +00033bb0: 6c20 276d 6175 6465 2720 636f 6d70 696c l 'maude' compil │ │ │ │ │ +00033bc0: 6174 696f 6e73 0a20 2020 2020 746f 2061 ations. to a │ │ │ │ │ +00033bd0: 6c73 6f20 7573 6520 7468 6520 7661 6c75 lso use the valu │ │ │ │ │ +00033be0: 6520 6f66 2027 414d 5f43 464c 4147 5327 e of 'AM_CFLAGS' │ │ │ │ │ +00033bf0: 2c20 796f 7520 776f 756c 6420 6e65 6564 , you would need │ │ │ │ │ +00033c00: 2074 6f20 7772 6974 653a 0a0a 2020 2020 to write:.. │ │ │ │ │ +00033c10: 2020 2020 2020 6d61 7564 655f 4346 4c41 maude_CFLA │ │ │ │ │ +00033c20: 4753 203d 202e 2e2e 2079 6f75 7220 666c GS = ... your fl │ │ │ │ │ +00033c30: 6167 7320 2e2e 2e20 2428 414d 5f43 464c ags ... $(AM_CFL │ │ │ │ │ +00033c40: 4147 5329 0a0a 2020 2020 202a 4e6f 7465 AGS).. *Note │ │ │ │ │ +00033c50: 2046 6c61 6720 5661 7269 6162 6c65 7320 Flag Variables │ │ │ │ │ +00033c60: 4f72 6465 7269 6e67 3a3a 2c20 666f 7220 Ordering::, for │ │ │ │ │ +00033c70: 6d6f 7265 2064 6973 6375 7373 696f 6e20 more discussion │ │ │ │ │ +00033c80: 6162 6f75 7420 7468 650a 2020 2020 2069 about the. i │ │ │ │ │ +00033c90: 6e74 6572 6163 7469 6f6e 2062 6574 7765 nteraction betwe │ │ │ │ │ +00033ca0: 656e 2075 7365 7220 7661 7269 6162 6c65 en user variable │ │ │ │ │ +00033cb0: 732c 2027 414d 5f27 2073 6861 646f 7720 s, 'AM_' shadow │ │ │ │ │ +00033cc0: 7661 7269 6162 6c65 732c 2061 6e64 0a20 variables, and. │ │ │ │ │ +00033cd0: 2020 2020 7065 722d 7461 7267 6574 2076 per-target v │ │ │ │ │ +00033ce0: 6172 6961 626c 6573 2e0a 0a27 6d61 7564 ariables...'maud │ │ │ │ │ +00033cf0: 655f 5348 4f52 544e 414d 4527 0a20 2020 e_SHORTNAME'. │ │ │ │ │ +00033d00: 2020 4f6e 2073 6f6d 6520 706c 6174 666f On some platfo │ │ │ │ │ +00033d10: 726d 7320 7468 6520 616c 6c6f 7761 626c rms the allowabl │ │ │ │ │ +00033d20: 6520 6669 6c65 206e 616d 6573 2061 7265 e file names are │ │ │ │ │ +00033d30: 2076 6572 7920 7368 6f72 742e 2020 496e very short. In │ │ │ │ │ +00033d40: 0a20 2020 2020 6f72 6465 7220 746f 2073 . order to s │ │ │ │ │ +00033d50: 7570 706f 7274 2074 6865 7365 2073 7973 upport these sys │ │ │ │ │ +00033d60: 7465 6d73 2061 6e64 2070 6572 2d74 6172 tems and per-tar │ │ │ │ │ +00033d70: 6765 7420 636f 6d70 696c 6174 696f 6e20 get compilation │ │ │ │ │ +00033d80: 666c 6167 7320 6174 0a20 2020 2020 7468 flags at. th │ │ │ │ │ +00033d90: 6520 7361 6d65 2074 696d 652c 2041 7574 e same time, Aut │ │ │ │ │ +00033da0: 6f6d 616b 6520 616c 6c6f 7773 2079 6f75 omake allows you │ │ │ │ │ +00033db0: 2074 6f20 7365 7420 6120 2273 686f 7274 to set a "short │ │ │ │ │ +00033dc0: 206e 616d 6522 2074 6861 7420 7769 6c6c name" that will │ │ │ │ │ +00033dd0: 0a20 2020 2020 696e 666c 7565 6e63 6520 . influence │ │ │ │ │ +00033de0: 686f 7720 696e 7465 726d 6564 6961 7465 how intermediate │ │ │ │ │ +00033df0: 206f 626a 6563 7420 6669 6c65 7320 6172 object files ar │ │ │ │ │ +00033e00: 6520 6e61 6d65 642e 2020 466f 7220 696e e named. For in │ │ │ │ │ +00033e10: 7374 616e 6365 2c0a 2020 2020 2069 6e20 stance,. in │ │ │ │ │ +00033e20: 7468 6520 666f 6c6c 6f77 696e 6720 6578 the following ex │ │ │ │ │ +00033e30: 616d 706c 652c 0a0a 2020 2020 2020 2020 ample,.. │ │ │ │ │ +00033e40: 2020 6269 6e5f 5052 4f47 5241 4d53 203d bin_PROGRAMS = │ │ │ │ │ +00033e50: 206d 6175 6465 0a20 2020 2020 2020 2020 maude. │ │ │ │ │ +00033e60: 206d 6175 6465 5f43 5050 464c 4147 5320 maude_CPPFLAGS │ │ │ │ │ +00033e70: 3d20 2d44 534f 4d45 464c 4147 0a20 2020 = -DSOMEFLAG. │ │ │ │ │ +00033e80: 2020 2020 2020 206d 6175 6465 5f53 484f maude_SHO │ │ │ │ │ +00033e90: 5254 4e41 4d45 203d 206d 0a20 2020 2020 RTNAME = m. │ │ │ │ │ +00033ea0: 2020 2020 206d 6175 6465 5f53 4f55 5243 maude_SOURC │ │ │ │ │ +00033eb0: 4553 203d 2073 616d 706c 652e 6320 2e2e ES = sample.c .. │ │ │ │ │ +00033ec0: 2e0a 0a20 2020 2020 7468 6520 6f62 6a65 ... the obje │ │ │ │ │ +00033ed0: 6374 2066 696c 6520 776f 756c 6420 6265 ct file would be │ │ │ │ │ +00033ee0: 206e 616d 6564 2027 6d2d 7361 6d70 6c65 named 'm-sample │ │ │ │ │ +00033ef0: 2e6f 2720 7261 7468 6572 2074 6861 6e0a .o' rather than. │ │ │ │ │ +00033f00: 2020 2020 2027 6d61 7564 652d 7361 6d70 'maude-samp │ │ │ │ │ +00033f10: 6c65 2e6f 272e 0a0a 2020 2020 2054 6869 le.o'... Thi │ │ │ │ │ +00033f20: 7320 6661 6369 6c69 7479 2069 7320 7261 s facility is ra │ │ │ │ │ +00033f30: 7265 6c79 206e 6565 6465 6420 696e 2070 rely needed in p │ │ │ │ │ +00033f40: 7261 6374 6963 652c 2061 6e64 2077 6520 ractice, and we │ │ │ │ │ +00033f50: 7265 636f 6d6d 656e 640a 2020 2020 2061 recommend. a │ │ │ │ │ +00033f60: 766f 6964 696e 6720 6974 2075 6e74 696c voiding it until │ │ │ │ │ +00033f70: 2079 6f75 2066 696e 6420 6974 2069 7320 you find it is │ │ │ │ │ +00033f80: 7265 7175 6972 6564 2e0a 0a20 2020 2d2d required... -- │ │ │ │ │ +00033f90: 2d2d 2d2d 2d2d 2d2d 2046 6f6f 746e 6f74 -------- Footnot │ │ │ │ │ +00033fa0: 6573 202d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 es ----------.. │ │ │ │ │ +00033fb0: 2020 2831 2920 5468 6572 6520 6172 6520 (1) There are │ │ │ │ │ +00033fc0: 6f74 6865 722c 206d 6f72 6520 6f62 7363 other, more obsc │ │ │ │ │ +00033fd0: 7572 6520 7265 6173 6f6e 7320 666f 7220 ure reasons for │ │ │ │ │ +00033fe0: 7468 6973 206c 696d 6974 6174 696f 6e20 this limitation │ │ │ │ │ +00033ff0: 6173 0a77 656c 6c2e 0a0a 1f0a 4669 6c65 as.well.....File │ │ │ │ │ +00034000: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +00034010: 696e 666f 2c20 204e 6f64 653a 2044 6566 info, Node: Def │ │ │ │ │ +00034020: 6175 6c74 205f 534f 5552 4345 532c 2020 ault _SOURCES, │ │ │ │ │ +00034030: 4e65 7874 3a20 4c49 424f 424a 532c 2020 Next: LIBOBJS, │ │ │ │ │ +00034040: 5072 6576 3a20 5072 6f67 7261 6d20 616e Prev: Program an │ │ │ │ │ +00034050: 6420 4c69 6272 6172 7920 5661 7269 6162 d Library Variab │ │ │ │ │ +00034060: 6c65 732c 2020 5570 3a20 5072 6f67 7261 les, Up: Progra │ │ │ │ │ +00034070: 6d73 0a0a 382e 3520 4465 6661 756c 7420 ms..8.5 Default │ │ │ │ │ +00034080: 275f 534f 5552 4345 5327 0a3d 3d3d 3d3d '_SOURCES'.===== │ │ │ │ │ +00034090: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000340a0: 3d0a 0a27 5f53 4f55 5243 4553 2720 7661 =..'_SOURCES' va │ │ │ │ │ +000340b0: 7269 6162 6c65 7320 6172 6520 7573 6564 riables are used │ │ │ │ │ +000340c0: 2074 6f20 7370 6563 6966 7920 736f 7572 to specify sour │ │ │ │ │ +000340d0: 6365 2066 696c 6573 206f 6620 7072 6f67 ce files of prog │ │ │ │ │ +000340e0: 7261 6d73 2028 2a6e 6f74 650a 4120 5072 rams (*note.A Pr │ │ │ │ │ +000340f0: 6f67 7261 6d3a 3a29 2c20 6c69 6272 6172 ogram::), librar │ │ │ │ │ +00034100: 6965 7320 282a 6e6f 7465 2041 204c 6962 ies (*note A Lib │ │ │ │ │ +00034110: 7261 7279 3a3a 292c 2061 6e64 204c 6962 rary::), and Lib │ │ │ │ │ +00034120: 746f 6f6c 206c 6962 7261 7269 6573 0a28 tool libraries.( │ │ │ │ │ +00034130: 2a6e 6f74 6520 4120 5368 6172 6564 204c *note A Shared L │ │ │ │ │ +00034140: 6962 7261 7279 3a3a 292e 0a0a 2020 2057 ibrary::)... W │ │ │ │ │ +00034150: 6865 6e20 6e6f 2073 7563 6820 7661 7269 hen no such vari │ │ │ │ │ +00034160: 6162 6c65 2069 7320 7370 6563 6966 6965 able is specifie │ │ │ │ │ +00034170: 6420 666f 7220 6120 7461 7267 6574 2c20 d for a target, │ │ │ │ │ +00034180: 4175 746f 6d61 6b65 2077 696c 6c20 6465 Automake will de │ │ │ │ │ +00034190: 6669 6e65 0a6f 6e65 2069 7473 656c 662e fine.one itself. │ │ │ │ │ +000341a0: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ │ +000341b0: 2074 6f20 636f 6d70 696c 6520 6120 7369 to compile a si │ │ │ │ │ +000341c0: 6e67 6c65 2043 2066 696c 6520 7768 6f73 ngle C file whos │ │ │ │ │ +000341d0: 6520 6261 7365 206e 616d 650a 6973 2074 e base name.is t │ │ │ │ │ +000341e0: 6865 206e 616d 6520 6f66 2074 6865 2074 he name of the t │ │ │ │ │ +000341f0: 6172 6765 7420 6974 7365 6c66 2c20 7769 arget itself, wi │ │ │ │ │ +00034200: 7468 2061 6e79 2065 7874 656e 7369 6f6e th any extension │ │ │ │ │ +00034210: 2072 6570 6c61 6365 6420 6279 0a27 414d replaced by.'AM │ │ │ │ │ +00034220: 5f44 4546 4155 4c54 5f53 4f55 5243 455f _DEFAULT_SOURCE_ │ │ │ │ │ +00034230: 4558 5427 2c20 7768 6963 6820 6465 6661 EXT', which defa │ │ │ │ │ +00034240: 756c 7473 2074 6f20 272e 6327 2e0a 0a20 ults to '.c'... │ │ │ │ │ +00034250: 2020 466f 7220 6578 616d 706c 6520 6966 For example if │ │ │ │ │ +00034260: 2079 6f75 2068 6176 6520 7468 6520 666f you have the fo │ │ │ │ │ +00034270: 6c6c 6f77 696e 6720 736f 6d65 7768 6572 llowing somewher │ │ │ │ │ +00034280: 6520 696e 2079 6f75 7220 274d 616b 6566 e in your 'Makef │ │ │ │ │ +00034290: 696c 652e 616d 270a 7769 7468 206e 6f20 ile.am'.with no │ │ │ │ │ +000342a0: 636f 7272 6573 706f 6e64 696e 6720 276c corresponding 'l │ │ │ │ │ +000342b0: 6962 666f 6f5f 615f 534f 5552 4345 5327 ibfoo_a_SOURCES' │ │ │ │ │ +000342c0: 3a0a 0a20 2020 2020 6c69 625f 4c49 4252 :.. lib_LIBR │ │ │ │ │ +000342d0: 4152 4945 5320 3d20 6c69 6266 6f6f 2e61 ARIES = libfoo.a │ │ │ │ │ +000342e0: 2073 7562 2f6c 6962 632b 2b2e 610a 0a27 sub/libc++.a..' │ │ │ │ │ +000342f0: 6c69 6266 6f6f 2e61 2720 7769 6c6c 2062 libfoo.a' will b │ │ │ │ │ +00034300: 6520 6275 696c 7420 7573 696e 6720 6120 e built using a │ │ │ │ │ +00034310: 6465 6661 756c 7420 736f 7572 6365 2066 default source f │ │ │ │ │ +00034320: 696c 6520 6e61 6d65 6420 276c 6962 666f ile named 'libfo │ │ │ │ │ +00034330: 6f2e 6327 2c0a 616e 6420 2773 7562 2f6c o.c',.and 'sub/l │ │ │ │ │ +00034340: 6962 632b 2b2e 6127 2077 696c 6c20 6265 ibc++.a' will be │ │ │ │ │ +00034350: 2062 7569 6c74 2066 726f 6d20 2773 7562 built from 'sub │ │ │ │ │ +00034360: 2f6c 6962 632b 2b2e 6327 2e20 2028 496e /libc++.c'. (In │ │ │ │ │ +00034370: 206f 6c64 6572 0a76 6572 7369 6f6e 7320 older.versions │ │ │ │ │ +00034380: 2773 7562 2f6c 6962 632b 2b2e 6127 2077 'sub/libc++.a' w │ │ │ │ │ +00034390: 6f75 6c64 2062 6520 6275 696c 7420 6672 ould be built fr │ │ │ │ │ +000343a0: 6f6d 2027 7375 625f 6c69 6263 5f5f 5f61 om 'sub_libc___a │ │ │ │ │ +000343b0: 2e63 272c 2069 2e65 2e2c 2074 6865 0a64 .c', i.e., the.d │ │ │ │ │ +000343c0: 6566 6175 6c74 2073 6f75 7263 6520 7761 efault source wa │ │ │ │ │ +000343d0: 7320 7468 6520 6361 6e6f 6e69 7a65 6420 s the canonized │ │ │ │ │ +000343e0: 6e61 6d65 206f 6620 7468 6520 7461 7267 name of the targ │ │ │ │ │ +000343f0: 6574 2c20 7769 7468 2027 2e63 2720 6170 et, with '.c' ap │ │ │ │ │ +00034400: 7065 6e64 6564 2e0a 5765 2062 656c 6965 pended..We belie │ │ │ │ │ +00034410: 7665 2074 6865 206e 6577 2062 6568 6176 ve the new behav │ │ │ │ │ +00034420: 696f 7220 6973 206d 6f72 6520 7365 6e73 ior is more sens │ │ │ │ │ +00034430: 6962 6c65 2c20 6275 7420 666f 7220 6261 ible, but for ba │ │ │ │ │ +00034440: 636b 7761 7264 0a63 6f6d 7061 7469 6269 ckward.compatibi │ │ │ │ │ +00034450: 6c69 7479 2027 6175 746f 6d61 6b65 2720 lity 'automake' │ │ │ │ │ +00034460: 7769 6c6c 2075 7365 2074 6865 206f 6c64 will use the old │ │ │ │ │ +00034470: 206e 616d 6520 6966 2061 2066 696c 6520 name if a file │ │ │ │ │ +00034480: 6f72 2061 2072 756c 6520 7769 7468 0a74 or a rule with.t │ │ │ │ │ +00034490: 6861 7420 6e61 6d65 2065 7869 7374 7320 hat name exists │ │ │ │ │ +000344a0: 616e 6420 2741 4d5f 4445 4641 554c 545f and 'AM_DEFAULT_ │ │ │ │ │ +000344b0: 534f 5552 4345 5f45 5854 2720 6973 206e SOURCE_EXT' is n │ │ │ │ │ +000344c0: 6f74 2075 7365 642e 290a 0a20 2020 4465 ot used.).. De │ │ │ │ │ +000344d0: 6661 756c 7420 736f 7572 6365 7320 6172 fault sources ar │ │ │ │ │ +000344e0: 6520 6d61 696e 6c79 2075 7365 6675 6c20 e mainly useful │ │ │ │ │ +000344f0: 696e 2074 6573 7420 7375 6974 6573 2c20 in test suites, │ │ │ │ │ +00034500: 7768 656e 2062 7569 6c64 696e 6720 6d61 when building ma │ │ │ │ │ +00034510: 6e79 0a74 6573 7420 7072 6f67 7261 6d73 ny.test programs │ │ │ │ │ +00034520: 2065 6163 6820 6672 6f6d 2061 2073 696e each from a sin │ │ │ │ │ +00034530: 676c 6520 736f 7572 6365 2e20 2046 6f72 gle source. For │ │ │ │ │ +00034540: 2069 6e73 7461 6e63 652c 2069 6e0a 0a20 instance, in.. │ │ │ │ │ +00034550: 2020 2020 6368 6563 6b5f 5052 4f47 5241 check_PROGRA │ │ │ │ │ +00034560: 4d53 203d 2074 6573 7431 2074 6573 7432 MS = test1 test2 │ │ │ │ │ +00034570: 2074 6573 7433 0a20 2020 2020 414d 5f44 test3. AM_D │ │ │ │ │ +00034580: 4546 4155 4c54 5f53 4f55 5243 455f 4558 EFAULT_SOURCE_EX │ │ │ │ │ +00034590: 5420 3d20 2e63 7070 0a0a 2774 6573 7431 T = .cpp..'test1 │ │ │ │ │ +000345a0: 272c 2027 7465 7374 3227 2c20 616e 6420 ', 'test2', and │ │ │ │ │ +000345b0: 2774 6573 7433 2720 7769 6c6c 2062 6520 'test3' will be │ │ │ │ │ +000345c0: 6275 696c 7420 6672 6f6d 2027 7465 7374 built from 'test │ │ │ │ │ +000345d0: 312e 6370 7027 2c0a 2774 6573 7432 2e63 1.cpp',.'test2.c │ │ │ │ │ +000345e0: 7070 272c 2061 6e64 2027 7465 7374 332e pp', and 'test3. │ │ │ │ │ +000345f0: 6370 7027 2e20 2057 6974 686f 7574 2074 cpp'. Without t │ │ │ │ │ +00034600: 6865 206c 6173 7420 6c69 6e65 2c20 7468 he last line, th │ │ │ │ │ +00034610: 6579 2077 696c 6c20 6265 2062 7569 6c74 ey will be built │ │ │ │ │ +00034620: 0a66 726f 6d20 2774 6573 7431 2e63 272c .from 'test1.c', │ │ │ │ │ +00034630: 2027 7465 7374 322e 6327 2c20 616e 6420 'test2.c', and │ │ │ │ │ +00034640: 2774 6573 7433 2e63 272e 0a0a 2020 2041 'test3.c'... A │ │ │ │ │ +00034650: 6e6f 7468 6572 2063 6173 6520 7768 6572 nother case wher │ │ │ │ │ +00034660: 6520 7468 6973 2069 7320 636f 6e76 656e e this is conven │ │ │ │ │ +00034670: 6965 6e74 2069 7320 6275 696c 6469 6e67 ient is building │ │ │ │ │ +00034680: 206d 616e 7920 4c69 6274 6f6f 6c0a 6d6f many Libtool.mo │ │ │ │ │ +00034690: 6475 6c65 7320 2827 6d6f 6475 6c65 4e2e dules ('moduleN. │ │ │ │ │ +000346a0: 6c61 2729 2c20 6561 6368 2064 6566 696e la'), each defin │ │ │ │ │ +000346b0: 6564 2069 6e20 6974 7320 6f77 6e20 6669 ed in its own fi │ │ │ │ │ +000346c0: 6c65 2028 276d 6f64 756c 654e 2e63 2729 le ('moduleN.c') │ │ │ │ │ +000346d0: 2e0a 0a20 2020 2020 414d 5f4c 4446 4c41 ... AM_LDFLA │ │ │ │ │ +000346e0: 4753 203d 202d 6d6f 6475 6c65 0a20 2020 GS = -module. │ │ │ │ │ +000346f0: 2020 6c69 625f 4c54 4c49 4252 4152 4945 lib_LTLIBRARIE │ │ │ │ │ +00034700: 5320 3d20 6d6f 6475 6c65 312e 6c61 206d S = module1.la m │ │ │ │ │ +00034710: 6f64 756c 6532 2e6c 6120 6d6f 6475 6c65 odule2.la module │ │ │ │ │ +00034720: 332e 6c61 0a0a 2020 2046 696e 616c 6c79 3.la.. Finally │ │ │ │ │ +00034730: 2c20 7468 6572 6520 6973 206f 6e65 2073 , there is one s │ │ │ │ │ +00034740: 6974 7561 7469 6f6e 2077 6865 7265 2074 ituation where t │ │ │ │ │ +00034750: 6869 7320 6465 6661 756c 7420 736f 7572 his default sour │ │ │ │ │ +00034760: 6365 2063 6f6d 7075 7461 7469 6f6e 0a6e ce computation.n │ │ │ │ │ +00034770: 6565 6473 2074 6f20 6265 2061 766f 6964 eeds to be avoid │ │ │ │ │ +00034780: 6564 3a20 7768 656e 2061 2074 6172 6765 ed: when a targe │ │ │ │ │ +00034790: 7420 7368 6f75 6c64 206e 6f74 2062 6520 t should not be │ │ │ │ │ +000347a0: 6275 696c 7420 6672 6f6d 2073 6f75 7263 built from sourc │ │ │ │ │ +000347b0: 6573 2e20 2057 650a 616c 7265 6164 7920 es. We.already │ │ │ │ │ +000347c0: 7361 7720 7375 6368 2061 6e20 6578 616d saw such an exam │ │ │ │ │ +000347d0: 706c 6520 696e 202a 6e6f 7465 2074 7275 ple in *note tru │ │ │ │ │ +000347e0: 653a 3a3b 2074 6869 7320 6861 7070 656e e::; this happen │ │ │ │ │ +000347f0: 7320 7768 656e 2061 6c6c 2074 6865 0a63 s when all the.c │ │ │ │ │ +00034800: 6f6e 7374 6974 7565 6e74 7320 6f66 2061 onstituents of a │ │ │ │ │ +00034810: 2074 6172 6765 7420 6861 7665 2061 6c72 target have alr │ │ │ │ │ +00034820: 6561 6479 2062 6565 6e20 636f 6d70 696c eady been compil │ │ │ │ │ +00034830: 6564 2061 6e64 206a 7573 7420 6e65 6564 ed and just need │ │ │ │ │ +00034840: 2074 6f20 6265 0a63 6f6d 6269 6e65 6420 to be.combined │ │ │ │ │ +00034850: 7573 696e 6720 6120 275f 4c44 4144 4427 using a '_LDADD' │ │ │ │ │ +00034860: 2076 6172 6961 626c 652e 2020 5468 656e variable. Then │ │ │ │ │ +00034870: 2069 7420 6973 206e 6563 6573 7361 7279 it is necessary │ │ │ │ │ +00034880: 2074 6f20 6465 6669 6e65 2061 6e0a 656d to define an.em │ │ │ │ │ +00034890: 7074 7920 275f 534f 5552 4345 5327 2076 pty '_SOURCES' v │ │ │ │ │ +000348a0: 6172 6961 626c 652c 2073 6f20 7468 6174 ariable, so that │ │ │ │ │ +000348b0: 2027 6175 746f 6d61 6b65 2720 646f 6573 'automake' does │ │ │ │ │ +000348c0: 206e 6f74 2063 6f6d 7075 7465 2061 0a64 not compute a.d │ │ │ │ │ +000348d0: 6566 6175 6c74 2e0a 0a20 2020 2020 6269 efault... bi │ │ │ │ │ +000348e0: 6e5f 5052 4f47 5241 4d53 203d 2074 6172 n_PROGRAMS = tar │ │ │ │ │ +000348f0: 6765 740a 2020 2020 2074 6172 6765 745f get. target_ │ │ │ │ │ +00034900: 534f 5552 4345 5320 3d0a 2020 2020 2074 SOURCES =. t │ │ │ │ │ +00034910: 6172 6765 745f 4c44 4144 4420 3d20 6c69 arget_LDADD = li │ │ │ │ │ +00034920: 626d 6169 6e2e 6120 6c69 626d 6973 632e bmain.a libmisc. │ │ │ │ │ +00034930: 610a 0a1f 0a46 696c 653a 2061 7574 6f6d a....File: autom │ │ │ │ │ +00034940: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +00034950: 4e6f 6465 3a20 4c49 424f 424a 532c 2020 Node: LIBOBJS, │ │ │ │ │ +00034960: 4e65 7874 3a20 5072 6f67 7261 6d20 5661 Next: Program Va │ │ │ │ │ +00034970: 7269 6162 6c65 732c 2020 5072 6576 3a20 riables, Prev: │ │ │ │ │ +00034980: 4465 6661 756c 7420 5f53 4f55 5243 4553 Default _SOURCES │ │ │ │ │ +00034990: 2c20 2055 703a 2050 726f 6772 616d 730a , Up: Programs. │ │ │ │ │ +000349a0: 0a38 2e36 2053 7065 6369 616c 2068 616e .8.6 Special han │ │ │ │ │ +000349b0: 646c 696e 6720 666f 7220 274c 4942 4f42 dling for 'LIBOB │ │ │ │ │ +000349c0: 4a53 2720 616e 6420 2741 4c4c 4f43 4127 JS' and 'ALLOCA' │ │ │ │ │ +000349d0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ 000349e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000349f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00034a00: 5468 6520 2724 284c 4942 4f42 4a53 2927 The '$(LIBOBJS)' │ │ │ │ │ -00034a10: 2061 6e64 2027 2428 414c 4c4f 4341 2927 and '$(ALLOCA)' │ │ │ │ │ -00034a20: 2076 6172 6961 626c 6573 206c 6973 7420 variables list │ │ │ │ │ -00034a30: 6f62 6a65 6374 2066 696c 6573 2074 6861 object files tha │ │ │ │ │ -00034a40: 7420 7368 6f75 6c64 0a62 6520 636f 6d70 t should.be comp │ │ │ │ │ -00034a50: 696c 6564 2069 6e74 6f20 7468 6520 7072 iled into the pr │ │ │ │ │ -00034a60: 6f6a 6563 7420 746f 2070 726f 7669 6465 oject to provide │ │ │ │ │ -00034a70: 2061 6e20 696d 706c 656d 656e 7461 7469 an implementati │ │ │ │ │ -00034a80: 6f6e 2066 6f72 2066 756e 6374 696f 6e73 on for functions │ │ │ │ │ -00034a90: 0a74 6861 7420 6172 6520 6d69 7373 696e .that are missin │ │ │ │ │ -00034aa0: 6720 6f72 2062 726f 6b65 6e20 6f6e 2074 g or broken on t │ │ │ │ │ -00034ab0: 6865 2068 6f73 7420 7379 7374 656d 2e20 he host system. │ │ │ │ │ -00034ac0: 2054 6865 7920 6172 6520 7375 6273 7469 They are substi │ │ │ │ │ -00034ad0: 7475 7465 6420 6279 0a27 636f 6e66 6967 tuted by.'config │ │ │ │ │ -00034ae0: 7572 6527 2e0a 0a20 2020 5468 6573 6520 ure'... These │ │ │ │ │ -00034af0: 7661 7269 6162 6c65 7320 6172 6520 6465 variables are de │ │ │ │ │ -00034b00: 6669 6e65 6420 6279 2041 7574 6f63 6f6e fined by Autocon │ │ │ │ │ -00034b10: 6620 6d61 6372 6f73 2073 7563 6820 6173 f macros such as │ │ │ │ │ -00034b20: 2027 4143 5f4c 4942 4f42 4a27 2c0a 2741 'AC_LIBOBJ',.'A │ │ │ │ │ -00034b30: 435f 5245 504c 4143 455f 4655 4e43 5327 C_REPLACE_FUNCS' │ │ │ │ │ -00034b40: 2028 2a6e 6f74 6520 4765 6e65 7269 6320 (*note Generic │ │ │ │ │ -00034b50: 4675 6e63 7469 6f6e 2043 6865 636b 733a Function Checks: │ │ │ │ │ -00034b60: 2028 6175 746f 636f 6e66 2947 656e 6572 (autoconf)Gener │ │ │ │ │ -00034b70: 6963 0a46 756e 6374 696f 6e73 2e29 2c20 ic.Functions.), │ │ │ │ │ -00034b80: 6f72 2027 4143 5f46 554e 435f 414c 4c4f or 'AC_FUNC_ALLO │ │ │ │ │ -00034b90: 4341 2720 282a 6e6f 7465 2050 6172 7469 CA' (*note Parti │ │ │ │ │ -00034ba0: 6375 6c61 7220 4675 6e63 7469 6f6e 2043 cular Function C │ │ │ │ │ -00034bb0: 6865 636b 733a 0a28 6175 746f 636f 6e66 hecks:.(autoconf │ │ │ │ │ -00034bc0: 2950 6172 7469 6375 6c61 7220 4675 6e63 )Particular Func │ │ │ │ │ -00034bd0: 7469 6f6e 732e 292e 2020 4d61 6e79 206f tions.). Many o │ │ │ │ │ -00034be0: 7468 6572 2041 7574 6f63 6f6e 6620 6d61 ther Autoconf ma │ │ │ │ │ -00034bf0: 6372 6f73 2063 616c 6c0a 2741 435f 4c49 cros call.'AC_LI │ │ │ │ │ -00034c00: 424f 424a 2720 6f72 2027 4143 5f52 4550 BOBJ' or 'AC_REP │ │ │ │ │ -00034c10: 4c41 4345 5f46 554e 4353 2720 746f 2070 LACE_FUNCS' to p │ │ │ │ │ -00034c20: 6f70 756c 6174 6520 2724 284c 4942 4f42 opulate '$(LIBOB │ │ │ │ │ -00034c30: 4a53 2927 2e0a 0a20 2020 5573 696e 6720 JS)'... Using │ │ │ │ │ -00034c40: 7468 6573 6520 7661 7269 6162 6c65 7320 these variables │ │ │ │ │ -00034c50: 6973 2076 6572 7920 7369 6d69 6c61 7220 is very similar │ │ │ │ │ -00034c60: 746f 2064 6f69 6e67 2063 6f6e 6469 7469 to doing conditi │ │ │ │ │ -00034c70: 6f6e 616c 0a63 6f6d 7069 6c61 7469 6f6e onal.compilation │ │ │ │ │ -00034c80: 2075 7369 6e67 2027 4143 5f53 5542 5354 using 'AC_SUBST │ │ │ │ │ -00034c90: 2720 7661 7269 6162 6c65 732c 2061 7320 ' variables, as │ │ │ │ │ -00034ca0: 6465 7363 7269 6265 6420 696e 202a 6e6f described in *no │ │ │ │ │ -00034cb0: 7465 0a43 6f6e 6469 7469 6f6e 616c 2053 te.Conditional S │ │ │ │ │ -00034cc0: 6f75 7263 6573 3a3a 2e20 2054 6861 7420 ources::. That │ │ │ │ │ -00034cd0: 6973 2c20 7768 656e 2062 7569 6c64 696e is, when buildin │ │ │ │ │ -00034ce0: 6720 6120 7072 6f67 7261 6d2c 2027 2428 g a program, '$( │ │ │ │ │ -00034cf0: 4c49 424f 424a 5329 270a 616e 6420 2724 LIBOBJS)'.and '$ │ │ │ │ │ -00034d00: 2841 4c4c 4f43 4129 2720 7368 6f75 6c64 (ALLOCA)' should │ │ │ │ │ -00034d10: 2062 6520 6164 6465 6420 746f 2074 6865 be added to the │ │ │ │ │ -00034d20: 2061 7373 6f63 6961 7465 6420 272a 5f4c associated '*_L │ │ │ │ │ -00034d30: 4441 4444 2720 7661 7269 6162 6c65 2c20 DADD' variable, │ │ │ │ │ -00034d40: 6f72 0a74 6f20 7468 6520 272a 5f4c 4942 or.to the '*_LIB │ │ │ │ │ -00034d50: 4144 4427 2076 6172 6961 626c 6520 7768 ADD' variable wh │ │ │ │ │ -00034d60: 656e 2062 7569 6c64 696e 6720 6120 6c69 en building a li │ │ │ │ │ -00034d70: 6272 6172 792e 2020 486f 7765 7665 7220 brary. However │ │ │ │ │ -00034d80: 7468 6572 6520 6973 206e 6f0a 6e65 6564 there is no.need │ │ │ │ │ -00034d90: 2074 6f20 6c69 7374 2074 6865 2063 6f72 to list the cor │ │ │ │ │ -00034da0: 7265 7370 6f6e 6469 6e67 2073 6f75 7263 responding sourc │ │ │ │ │ -00034db0: 6573 2069 6e20 2745 5854 5241 5f2a 5f53 es in 'EXTRA_*_S │ │ │ │ │ -00034dc0: 4f55 5243 4553 2720 6e6f 7220 746f 0a64 OURCES' nor to.d │ │ │ │ │ -00034dd0: 6566 696e 6520 272a 5f44 4550 454e 4445 efine '*_DEPENDE │ │ │ │ │ -00034de0: 4e43 4945 5327 2e20 2041 7574 6f6d 616b NCIES'. Automak │ │ │ │ │ -00034df0: 6520 6175 746f 6d61 7469 6361 6c6c 7920 e automatically │ │ │ │ │ -00034e00: 6164 6473 2027 2428 4c49 424f 424a 5329 adds '$(LIBOBJS) │ │ │ │ │ -00034e10: 2720 616e 640a 2724 2841 4c4c 4f43 4129 ' and.'$(ALLOCA) │ │ │ │ │ -00034e20: 2720 746f 2074 6865 2064 6570 656e 6465 ' to the depende │ │ │ │ │ -00034e30: 6e63 6965 732c 2061 6e64 2069 7420 7769 ncies, and it wi │ │ │ │ │ -00034e40: 6c6c 2064 6973 636f 7665 7220 7468 6520 ll discover the │ │ │ │ │ -00034e50: 6c69 7374 206f 660a 636f 7272 6573 706f list of.correspo │ │ │ │ │ -00034e60: 6e64 696e 6720 736f 7572 6365 2066 696c nding source fil │ │ │ │ │ -00034e70: 6573 2061 7574 6f6d 6174 6963 616c 6c79 es automatically │ │ │ │ │ -00034e80: 2028 6279 2074 7261 6369 6e67 2074 6865 (by tracing the │ │ │ │ │ -00034e90: 2069 6e76 6f63 6174 696f 6e73 206f 660a invocations of. │ │ │ │ │ -00034ea0: 7468 6520 2741 435f 4c49 4253 4f55 5243 the 'AC_LIBSOURC │ │ │ │ │ -00034eb0: 4527 2041 7574 6f63 6f6e 6620 6d61 6372 E' Autoconf macr │ │ │ │ │ -00034ec0: 6f73 292e 2020 4966 2079 6f75 2068 6176 os). If you hav │ │ │ │ │ -00034ed0: 6520 616c 7265 6164 7920 6465 6669 6e65 e already define │ │ │ │ │ -00034ee0: 640a 272a 5f44 4550 454e 4445 4e43 4945 d.'*_DEPENDENCIE │ │ │ │ │ -00034ef0: 5327 2065 7870 6c69 6369 746c 7920 666f S' explicitly fo │ │ │ │ │ -00034f00: 7220 616e 2075 6e72 656c 6174 6564 2072 r an unrelated r │ │ │ │ │ -00034f10: 6561 736f 6e2c 2074 6865 6e20 796f 7520 eason, then you │ │ │ │ │ -00034f20: 6569 7468 6572 0a6e 6565 6420 746f 2061 either.need to a │ │ │ │ │ -00034f30: 6464 2074 6865 7365 2076 6172 6961 626c dd these variabl │ │ │ │ │ -00034f40: 6573 206d 616e 7561 6c6c 792c 206f 7220 es manually, or │ │ │ │ │ -00034f50: 7573 6520 2745 5854 5241 5f2a 5f44 4550 use 'EXTRA_*_DEP │ │ │ │ │ -00034f60: 454e 4445 4e43 4945 5327 0a69 6e73 7465 ENDENCIES'.inste │ │ │ │ │ -00034f70: 6164 206f 6620 272a 5f44 4550 454e 4445 ad of '*_DEPENDE │ │ │ │ │ -00034f80: 4e43 4945 5327 2e0a 0a20 2020 5468 6573 NCIES'... Thes │ │ │ │ │ -00034f90: 6520 7661 7269 6162 6c65 7320 6172 6520 e variables are │ │ │ │ │ -00034fa0: 7573 7561 6c6c 7920 7573 6564 2074 6f20 usually used to │ │ │ │ │ -00034fb0: 6275 696c 6420 6120 706f 7274 6162 696c build a portabil │ │ │ │ │ -00034fc0: 6974 7920 6c69 6272 6172 7920 7468 6174 ity library that │ │ │ │ │ -00034fd0: 0a69 7320 6c69 6e6b 6564 2077 6974 6820 .is linked with │ │ │ │ │ -00034fe0: 616c 6c20 7468 6520 7072 6f67 7261 6d73 all the programs │ │ │ │ │ -00034ff0: 206f 6620 7468 6520 7072 6f6a 6563 742e of the project. │ │ │ │ │ -00035000: 2020 5765 206e 6f77 2072 6576 6965 7720 We now review │ │ │ │ │ -00035010: 6120 7361 6d70 6c65 0a73 6574 7570 2e20 a sample.setup. │ │ │ │ │ -00035020: 2046 6972 7374 2c20 2763 6f6e 6669 6775 First, 'configu │ │ │ │ │ -00035030: 7265 2e61 6327 2063 6f6e 7461 696e 7320 re.ac' contains │ │ │ │ │ -00035040: 736f 6d65 2063 6865 636b 7320 7468 6174 some checks that │ │ │ │ │ -00035050: 2061 6666 6563 7420 6569 7468 6572 0a27 affect either.' │ │ │ │ │ -00035060: 4c49 424f 424a 5327 206f 7220 2741 4c4c LIBOBJS' or 'ALL │ │ │ │ │ -00035070: 4f43 4127 2e0a 0a20 2020 2020 2320 636f OCA'... # co │ │ │ │ │ -00035080: 6e66 6967 7572 652e 6163 0a20 2020 2020 nfigure.ac. │ │ │ │ │ -00035090: 2e2e 2e0a 2020 2020 2041 435f 434f 4e46 .... AC_CONF │ │ │ │ │ -000350a0: 4947 5f4c 4942 4f42 4a5f 4449 5228 5b6c IG_LIBOBJ_DIR([l │ │ │ │ │ -000350b0: 6962 5d29 0a20 2020 2020 2e2e 2e0a 2020 ib]). .... │ │ │ │ │ -000350c0: 2020 2041 435f 4655 4e43 5f4d 414c 4c4f AC_FUNC_MALLO │ │ │ │ │ -000350d0: 4320 2020 2020 2020 2020 2020 2020 646e C dn │ │ │ │ │ -000350e0: 6c20 4d61 7920 6164 6420 6d61 6c6c 6f63 l May add malloc │ │ │ │ │ -000350f0: 2e24 284f 424a 4558 5429 2074 6f20 4c49 .$(OBJEXT) to LI │ │ │ │ │ -00035100: 424f 424a 530a 2020 2020 2041 435f 4655 BOBJS. AC_FU │ │ │ │ │ -00035110: 4e43 5f4d 454d 434d 5020 2020 2020 2020 NC_MEMCMP │ │ │ │ │ -00035120: 2020 2020 2020 646e 6c20 4d61 7920 6164 dnl May ad │ │ │ │ │ -00035130: 6420 6d65 6d63 6d70 2e24 284f 424a 4558 d memcmp.$(OBJEX │ │ │ │ │ -00035140: 5429 2074 6f20 4c49 424f 424a 530a 2020 T) to LIBOBJS. │ │ │ │ │ -00035150: 2020 2041 435f 5245 504c 4143 455f 4655 AC_REPLACE_FU │ │ │ │ │ -00035160: 4e43 5328 5b73 7472 6475 705d 2920 646e NCS([strdup]) dn │ │ │ │ │ -00035170: 6c20 4d61 7920 6164 6420 7374 7264 7570 l May add strdup │ │ │ │ │ -00035180: 2e24 284f 424a 4558 5429 2074 6f20 4c49 .$(OBJEXT) to LI │ │ │ │ │ -00035190: 424f 424a 530a 2020 2020 2041 435f 4655 BOBJS. AC_FU │ │ │ │ │ -000351a0: 4e43 5f41 4c4c 4f43 4120 2020 2020 2020 NC_ALLOCA │ │ │ │ │ -000351b0: 2020 2020 2020 646e 6c20 4d61 7920 6164 dnl May ad │ │ │ │ │ -000351c0: 6420 616c 6c6f 6361 2e24 284f 424a 4558 d alloca.$(OBJEX │ │ │ │ │ -000351d0: 5429 2074 6f20 414c 4c4f 4341 0a20 2020 T) to ALLOCA. │ │ │ │ │ -000351e0: 2020 2e2e 2e0a 2020 2020 2041 435f 434f .... AC_CO │ │ │ │ │ -000351f0: 4e46 4947 5f46 494c 4553 285b 0a20 2020 NFIG_FILES([. │ │ │ │ │ -00035200: 2020 2020 6c69 622f 4d61 6b65 6669 6c65 lib/Makefile │ │ │ │ │ -00035210: 0a20 2020 2020 2020 7372 632f 4d61 6b65 . src/Make │ │ │ │ │ -00035220: 6669 6c65 0a20 2020 2020 5d29 0a20 2020 file. ]). │ │ │ │ │ -00035230: 2020 4143 5f4f 5554 5055 540a 0a20 2020 AC_OUTPUT.. │ │ │ │ │ -00035240: 5468 6520 2741 435f 434f 4e46 4947 5f4c The 'AC_CONFIG_L │ │ │ │ │ -00035250: 4942 4f42 4a5f 4449 5227 2074 656c 6c73 IBOBJ_DIR' tells │ │ │ │ │ -00035260: 2041 7574 6f63 6f6e 6620 7468 6174 2074 Autoconf that t │ │ │ │ │ -00035270: 6865 2073 6f75 7263 6520 6669 6c65 7320 he source files │ │ │ │ │ -00035280: 6f66 0a74 6865 7365 206f 626a 6563 7420 of.these object │ │ │ │ │ -00035290: 6669 6c65 7320 6172 6520 746f 2062 6520 files are to be │ │ │ │ │ -000352a0: 666f 756e 6420 696e 2074 6865 2027 6c69 found in the 'li │ │ │ │ │ -000352b0: 622f 2720 6469 7265 6374 6f72 792e 2020 b/' directory. │ │ │ │ │ -000352c0: 4175 746f 6d61 6b65 0a63 616e 2061 6c73 Automake.can als │ │ │ │ │ -000352d0: 6f20 7573 6520 7468 6973 2069 6e66 6f72 o use this infor │ │ │ │ │ -000352e0: 6d61 7469 6f6e 2c20 6f74 6865 7277 6973 mation, otherwis │ │ │ │ │ -000352f0: 6520 6974 2065 7870 6563 7473 2074 6865 e it expects the │ │ │ │ │ -00035300: 2073 6f75 7263 6520 6669 6c65 7320 6172 source files ar │ │ │ │ │ -00035310: 650a 746f 2062 6520 696e 2074 6865 2064 e.to be in the d │ │ │ │ │ -00035320: 6972 6563 746f 7279 2077 6865 7265 2074 irectory where t │ │ │ │ │ -00035330: 6865 2027 2428 4c49 424f 424a 5329 2720 he '$(LIBOBJS)' │ │ │ │ │ -00035340: 616e 6420 2724 2841 4c4c 4f43 4129 2720 and '$(ALLOCA)' │ │ │ │ │ -00035350: 7661 7269 6162 6c65 730a 6172 6520 7573 variables.are us │ │ │ │ │ -00035360: 6564 2e0a 0a20 2020 5468 6520 276c 6962 ed... The 'lib │ │ │ │ │ -00035370: 2f27 2064 6972 6563 746f 7279 2073 686f /' directory sho │ │ │ │ │ -00035380: 756c 6420 7468 6572 6566 6f72 6520 636f uld therefore co │ │ │ │ │ -00035390: 6e74 6169 6e20 276d 616c 6c6f 632e 6327 ntain 'malloc.c' │ │ │ │ │ -000353a0: 2c20 276d 656d 636d 702e 6327 2c0a 2773 , 'memcmp.c',.'s │ │ │ │ │ -000353b0: 7472 6475 702e 6327 2c20 2761 6c6c 6f63 trdup.c', 'alloc │ │ │ │ │ -000353c0: 612e 6327 2e20 2048 6572 6520 6973 2069 a.c'. Here is i │ │ │ │ │ -000353d0: 7473 2027 4d61 6b65 6669 6c65 2e61 6d27 ts 'Makefile.am' │ │ │ │ │ -000353e0: 3a0a 0a20 2020 2020 2320 6c69 622f 4d61 :.. # lib/Ma │ │ │ │ │ -000353f0: 6b65 6669 6c65 2e61 6d0a 0a20 2020 2020 kefile.am.. │ │ │ │ │ -00035400: 6e6f 696e 7374 5f4c 4942 5241 5249 4553 noinst_LIBRARIES │ │ │ │ │ -00035410: 203d 206c 6962 636f 6d70 6174 2e61 0a20 = libcompat.a. │ │ │ │ │ -00035420: 2020 2020 6c69 6263 6f6d 7061 745f 615f libcompat_a_ │ │ │ │ │ -00035430: 534f 5552 4345 5320 3d0a 2020 2020 206c SOURCES =. l │ │ │ │ │ -00035440: 6962 636f 6d70 6174 5f61 5f4c 4942 4144 ibcompat_a_LIBAD │ │ │ │ │ -00035450: 4420 3d20 2428 4c49 424f 424a 5329 2024 D = $(LIBOBJS) $ │ │ │ │ │ -00035460: 2841 4c4c 4f43 4129 0a0a 2020 2054 6865 (ALLOCA).. The │ │ │ │ │ -00035470: 206c 6962 7261 7279 2063 616e 2068 6176 library can hav │ │ │ │ │ -00035480: 6520 616e 7920 6e61 6d65 2c20 6f66 2063 e any name, of c │ │ │ │ │ -00035490: 6f75 7273 652c 2061 6e64 2061 6e79 7761 ourse, and anywa │ │ │ │ │ -000354a0: 7920 6974 2069 7320 6e6f 7420 676f 696e y it is not goin │ │ │ │ │ -000354b0: 670a 746f 2062 6520 696e 7374 616c 6c65 g.to be installe │ │ │ │ │ -000354c0: 643a 2069 7420 6a75 7374 2068 6f6c 6473 d: it just holds │ │ │ │ │ -000354d0: 2074 6865 2072 6570 6c61 6365 6d65 6e74 the replacement │ │ │ │ │ -000354e0: 2076 6572 7369 6f6e 7320 6f66 2074 6865 versions of the │ │ │ │ │ -000354f0: 206d 6973 7369 6e67 0a6f 7220 6272 6f6b missing.or brok │ │ │ │ │ -00035500: 656e 2066 756e 6374 696f 6e73 2073 6f20 en functions so │ │ │ │ │ -00035510: 7765 2063 616e 206c 6174 6572 206c 696e we can later lin │ │ │ │ │ -00035520: 6b20 7468 656d 2069 6e2e 2020 4d61 6e79 k them in. Many │ │ │ │ │ -00035530: 2070 726f 6a65 6374 7320 616c 736f 0a69 projects also.i │ │ │ │ │ -00035540: 6e63 6c75 6465 2065 7874 7261 2066 756e nclude extra fun │ │ │ │ │ -00035550: 6374 696f 6e73 2c20 7370 6563 6966 6963 ctions, specific │ │ │ │ │ -00035560: 2074 6f20 7468 6520 7072 6f6a 6563 742c to the project, │ │ │ │ │ -00035570: 2069 6e20 7468 6174 206c 6962 7261 7279 in that library │ │ │ │ │ -00035580: 3a20 7468 6579 0a61 7265 2073 696d 706c : they.are simpl │ │ │ │ │ -00035590: 7920 6164 6465 6420 6f6e 2074 6865 2027 y added on the ' │ │ │ │ │ -000355a0: 5f53 4f55 5243 4553 2720 6c69 6e65 2e0a _SOURCES' line.. │ │ │ │ │ -000355b0: 0a20 2020 5468 6572 6520 6973 2061 2073 . There is a s │ │ │ │ │ -000355c0: 6d61 6c6c 2074 7261 7020 6865 7265 2c20 mall trap here, │ │ │ │ │ -000355d0: 7468 6f75 6768 3a20 2724 284c 4942 4f42 though: '$(LIBOB │ │ │ │ │ -000355e0: 4a53 2927 2061 6e64 2027 2428 414c 4c4f JS)' and '$(ALLO │ │ │ │ │ -000355f0: 4341 2927 0a6d 6967 6874 2062 6520 656d CA)'.might be em │ │ │ │ │ -00035600: 7074 792c 2061 6e64 2062 7569 6c64 696e pty, and buildin │ │ │ │ │ -00035610: 6720 616e 2065 6d70 7479 206c 6962 7261 g an empty libra │ │ │ │ │ -00035620: 7279 2069 7320 6e6f 7420 706f 7274 6162 ry is not portab │ │ │ │ │ -00035630: 6c65 2e20 2059 6f75 0a73 686f 756c 6420 le. You.should │ │ │ │ │ -00035640: 656e 7375 7265 2074 6861 7420 7468 6572 ensure that ther │ │ │ │ │ -00035650: 6520 6973 2061 6c77 6179 7320 736f 6d65 e is always some │ │ │ │ │ -00035660: 7468 696e 6720 746f 2070 7574 2069 6e20 thing to put in │ │ │ │ │ -00035670: 276c 6962 636f 6d70 6174 2e61 272e 0a4d 'libcompat.a'..M │ │ │ │ │ -00035680: 6f73 7420 7072 6f6a 6563 7473 2077 696c ost projects wil │ │ │ │ │ -00035690: 6c20 616c 736f 2061 6464 2073 6f6d 6520 l also add some │ │ │ │ │ -000356a0: 7574 696c 6974 7920 6675 6e63 7469 6f6e utility function │ │ │ │ │ -000356b0: 7320 696e 2074 6861 7420 6469 7265 6374 s in that direct │ │ │ │ │ -000356c0: 6f72 792c 0a61 6e64 206c 6973 7420 7468 ory,.and list th │ │ │ │ │ -000356d0: 656d 2069 6e20 276c 6962 636f 6d70 6174 em in 'libcompat │ │ │ │ │ -000356e0: 5f61 5f53 4f55 5243 4553 272c 2073 6f20 _a_SOURCES', so │ │ │ │ │ -000356f0: 696e 2070 7261 6374 6963 6520 276c 6962 in practice 'lib │ │ │ │ │ -00035700: 636f 6d70 6174 2e61 270a 6361 6e6e 6f74 compat.a'.cannot │ │ │ │ │ -00035710: 2062 6520 656d 7074 792e 0a0a 2020 2046 be empty... F │ │ │ │ │ -00035720: 696e 616c 6c79 2068 6572 6520 6973 2068 inally here is h │ │ │ │ │ -00035730: 6f77 2074 6869 7320 6c69 6272 6172 7920 ow this library │ │ │ │ │ -00035740: 636f 756c 6420 6265 2075 7365 6420 6672 could be used fr │ │ │ │ │ -00035750: 6f6d 2074 6865 2027 7372 632f 270a 6469 om the 'src/'.di │ │ │ │ │ -00035760: 7265 6374 6f72 792e 0a0a 2020 2020 2023 rectory... # │ │ │ │ │ -00035770: 2073 7263 2f4d 616b 6566 696c 652e 616d src/Makefile.am │ │ │ │ │ -00035780: 0a0a 2020 2020 2023 204c 696e 6b20 616c .. # Link al │ │ │ │ │ -00035790: 6c20 7072 6f67 7261 6d73 2069 6e20 7468 l programs in th │ │ │ │ │ -000357a0: 6973 2064 6972 6563 746f 7279 2077 6974 is directory wit │ │ │ │ │ -000357b0: 6820 6c69 6263 6f6d 7061 742e 610a 2020 h libcompat.a. │ │ │ │ │ -000357c0: 2020 204c 4441 4444 203d 202e 2e2f 6c69 LDADD = ../li │ │ │ │ │ -000357d0: 622f 6c69 6263 6f6d 7061 742e 610a 0a20 b/libcompat.a.. │ │ │ │ │ -000357e0: 2020 2020 6269 6e5f 5052 4f47 5241 4d53 bin_PROGRAMS │ │ │ │ │ -000357f0: 203d 2074 6f6f 6c31 2074 6f6f 6c32 202e = tool1 tool2 . │ │ │ │ │ -00035800: 2e2e 0a20 2020 2020 746f 6f6c 315f 534f ... tool1_SO │ │ │ │ │ -00035810: 5552 4345 5320 3d20 2e2e 2e0a 2020 2020 URCES = .... │ │ │ │ │ -00035820: 2074 6f6f 6c32 5f53 4f55 5243 4553 203d tool2_SOURCES = │ │ │ │ │ -00035830: 202e 2e2e 0a0a 2020 2057 6865 6e20 6f70 ..... When op │ │ │ │ │ -00035840: 7469 6f6e 2027 7375 6264 6972 2d6f 626a tion 'subdir-obj │ │ │ │ │ -00035850: 6563 7473 2720 6973 206e 6f74 2075 7365 ects' is not use │ │ │ │ │ -00035860: 642c 2061 7320 696e 2074 6865 2061 626f d, as in the abo │ │ │ │ │ -00035870: 7665 2065 7861 6d70 6c65 2c0a 7468 6520 ve example,.the │ │ │ │ │ -00035880: 7661 7269 6162 6c65 7320 2724 284c 4942 variables '$(LIB │ │ │ │ │ -00035890: 4f42 4a53 2927 206f 7220 2724 2841 4c4c OBJS)' or '$(ALL │ │ │ │ │ -000358a0: 4f43 4129 2720 6361 6e20 6f6e 6c79 2062 OCA)' can only b │ │ │ │ │ -000358b0: 6520 7573 6564 2069 6e20 7468 650a 6469 e used in the.di │ │ │ │ │ -000358c0: 7265 6374 6f72 7920 7768 6572 6520 7468 rectory where th │ │ │ │ │ -000358d0: 6569 7220 736f 7572 6365 7320 6c69 652e eir sources lie. │ │ │ │ │ -000358e0: 2020 452e 672e 2c20 6865 7265 2069 7420 E.g., here it │ │ │ │ │ -000358f0: 776f 756c 6420 6265 2077 726f 6e67 2074 would be wrong t │ │ │ │ │ -00035900: 6f20 7573 650a 2724 284c 4942 4f42 4a53 o use.'$(LIBOBJS │ │ │ │ │ -00035910: 2927 206f 7220 2724 2841 4c4c 4f43 4129 )' or '$(ALLOCA) │ │ │ │ │ -00035920: 2720 696e 2027 7372 632f 4d61 6b65 6669 ' in 'src/Makefi │ │ │ │ │ -00035930: 6c65 2e61 6d27 2e20 2048 6f77 6576 6572 le.am'. However │ │ │ │ │ -00035940: 2069 6620 626f 7468 0a27 7375 6264 6972 if both.'subdir │ │ │ │ │ -00035950: 2d6f 626a 6563 7473 2720 616e 6420 2741 -objects' and 'A │ │ │ │ │ -00035960: 435f 434f 4e46 4947 5f4c 4942 4f42 4a5f C_CONFIG_LIBOBJ_ │ │ │ │ │ -00035970: 4449 5227 2061 7265 2075 7365 642c 2069 DIR' are used, i │ │ │ │ │ -00035980: 7420 6973 204f 4b20 746f 2075 7365 0a74 t is OK to use.t │ │ │ │ │ -00035990: 6865 7365 2076 6172 6961 626c 6573 2069 hese variables i │ │ │ │ │ -000359a0: 6e20 6f74 6865 7220 6469 7265 6374 6f72 n other director │ │ │ │ │ -000359b0: 6965 732e 2020 466f 7220 696e 7374 616e ies. For instan │ │ │ │ │ -000359c0: 6365 2027 7372 632f 4d61 6b65 6669 6c65 ce 'src/Makefile │ │ │ │ │ -000359d0: 2e61 6d27 0a63 6f75 6c64 2062 6520 6368 .am'.could be ch │ │ │ │ │ -000359e0: 616e 6765 6420 6173 2066 6f6c 6c6f 7773 anged as follows │ │ │ │ │ -000359f0: 2e0a 0a20 2020 2020 2320 7372 632f 4d61 ... # src/Ma │ │ │ │ │ -00035a00: 6b65 6669 6c65 2e61 6d0a 0a20 2020 2020 kefile.am.. │ │ │ │ │ -00035a10: 4155 544f 4d41 4b45 5f4f 5054 494f 4e53 AUTOMAKE_OPTIONS │ │ │ │ │ -00035a20: 203d 2073 7562 6469 722d 6f62 6a65 6374 = subdir-object │ │ │ │ │ -00035a30: 730a 2020 2020 204c 4441 4444 203d 2024 s. LDADD = $ │ │ │ │ │ -00035a40: 284c 4942 4f42 4a53 2920 2428 414c 4c4f (LIBOBJS) $(ALLO │ │ │ │ │ -00035a50: 4341 290a 0a20 2020 2020 6269 6e5f 5052 CA).. bin_PR │ │ │ │ │ -00035a60: 4f47 5241 4d53 203d 2074 6f6f 6c31 2074 OGRAMS = tool1 t │ │ │ │ │ -00035a70: 6f6f 6c32 202e 2e2e 0a20 2020 2020 746f ool2 .... to │ │ │ │ │ -00035a80: 6f6c 315f 534f 5552 4345 5320 3d20 2e2e ol1_SOURCES = .. │ │ │ │ │ -00035a90: 2e0a 2020 2020 2074 6f6f 6c32 5f53 4f55 .. tool2_SOU │ │ │ │ │ -00035aa0: 5243 4553 203d 202e 2e2e 0a0a 2020 2042 RCES = ..... B │ │ │ │ │ -00035ab0: 6563 6175 7365 2027 2428 4c49 424f 424a ecause '$(LIBOBJ │ │ │ │ │ -00035ac0: 5329 2720 616e 6420 2724 2841 4c4c 4f43 S)' and '$(ALLOC │ │ │ │ │ -00035ad0: 4129 2720 636f 6e74 6169 6e20 6f62 6a65 A)' contain obje │ │ │ │ │ -00035ae0: 6374 2066 696c 6520 6e61 6d65 7320 7468 ct file names th │ │ │ │ │ -00035af0: 6174 0a65 6e64 2077 6974 6820 272e 2428 at.end with '.$( │ │ │ │ │ -00035b00: 4f42 4a45 5854 2927 2c20 7468 6579 2061 OBJEXT)', they a │ │ │ │ │ -00035b10: 7265 206e 6f74 2073 7569 7461 626c 6520 re not suitable │ │ │ │ │ -00035b20: 666f 7220 4c69 6274 6f6f 6c20 6c69 6272 for Libtool libr │ │ │ │ │ -00035b30: 6172 6965 730a 2877 6865 7265 2074 6865 aries.(where the │ │ │ │ │ -00035b40: 2065 7870 6563 7465 6420 6f62 6a65 6374 expected object │ │ │ │ │ -00035b50: 2065 7874 656e 7369 6f6e 2069 7320 272e extension is '. │ │ │ │ │ -00035b60: 6c6f 2729 3a20 274c 544c 4942 4f42 4a53 lo'): 'LTLIBOBJS │ │ │ │ │ -00035b70: 2720 616e 640a 274c 5441 4c4c 4f43 4127 ' and.'LTALLOCA' │ │ │ │ │ -00035b80: 2073 686f 756c 6420 6265 2075 7365 6420 should be used │ │ │ │ │ -00035b90: 696e 7374 6561 642e 0a0a 2020 2027 4c54 instead... 'LT │ │ │ │ │ -00035ba0: 4c49 424f 424a 5327 2069 7320 6465 6669 LIBOBJS' is defi │ │ │ │ │ -00035bb0: 6e65 6420 6175 746f 6d61 7469 6361 6c6c ned automaticall │ │ │ │ │ -00035bc0: 7920 6279 2041 7574 6f63 6f6e 6620 616e y by Autoconf an │ │ │ │ │ -00035bd0: 6420 7368 6f75 6c64 206e 6f74 2062 650a d should not be. │ │ │ │ │ -00035be0: 6465 6669 6e65 6420 6279 2068 616e 6420 defined by hand │ │ │ │ │ -00035bf0: 2861 7320 696e 2074 6865 2070 6173 7429 (as in the past) │ │ │ │ │ -00035c00: 2c20 686f 7765 7665 7220 6174 2074 6865 , however at the │ │ │ │ │ -00035c10: 2074 696d 6520 6f66 2077 7269 7469 6e67 time of writing │ │ │ │ │ -00035c20: 0a27 4c54 414c 4c4f 4341 2720 7374 696c .'LTALLOCA' stil │ │ │ │ │ -00035c30: 6c20 6e65 6564 7320 746f 2062 6520 6465 l needs to be de │ │ │ │ │ -00035c40: 6669 6e65 6420 6672 6f6d 2027 414c 4c4f fined from 'ALLO │ │ │ │ │ -00035c50: 4341 2720 6d61 6e75 616c 6c79 2e20 202a CA' manually. * │ │ │ │ │ -00035c60: 4e6f 7465 0a27 4143 5f4c 4942 4f42 4a27 Note.'AC_LIBOBJ' │ │ │ │ │ -00035c70: 2076 732e 2027 4c49 424f 424a 5327 3a20 vs. 'LIBOBJS': │ │ │ │ │ -00035c80: 2861 7574 6f63 6f6e 6629 4143 5f4c 4942 (autoconf)AC_LIB │ │ │ │ │ -00035c90: 4f42 4a20 7673 204c 4942 4f42 4a53 2e0a OBJ vs LIBOBJS.. │ │ │ │ │ -00035ca0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -00035cb0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -00035cc0: 6465 3a20 5072 6f67 7261 6d20 5661 7269 de: Program Vari │ │ │ │ │ -00035cd0: 6162 6c65 732c 2020 4e65 7874 3a20 5961 ables, Next: Ya │ │ │ │ │ -00035ce0: 6363 2061 6e64 204c 6578 2c20 2050 7265 cc and Lex, Pre │ │ │ │ │ -00035cf0: 763a 204c 4942 4f42 4a53 2c20 2055 703a v: LIBOBJS, Up: │ │ │ │ │ -00035d00: 2050 726f 6772 616d 730a 0a38 2e37 2056 Programs..8.7 V │ │ │ │ │ -00035d10: 6172 6961 626c 6573 2075 7365 6420 7768 ariables used wh │ │ │ │ │ -00035d20: 656e 2062 7569 6c64 696e 6720 6120 7072 en building a pr │ │ │ │ │ -00035d30: 6f67 7261 6d0a 3d3d 3d3d 3d3d 3d3d 3d3d ogram.========== │ │ │ │ │ +000349f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00034a00: 0a0a 5468 6520 2724 284c 4942 4f42 4a53 ..The '$(LIBOBJS │ │ │ │ │ +00034a10: 2927 2061 6e64 2027 2428 414c 4c4f 4341 )' and '$(ALLOCA │ │ │ │ │ +00034a20: 2927 2076 6172 6961 626c 6573 206c 6973 )' variables lis │ │ │ │ │ +00034a30: 7420 6f62 6a65 6374 2066 696c 6573 2074 t object files t │ │ │ │ │ +00034a40: 6861 7420 7368 6f75 6c64 0a62 6520 636f hat should.be co │ │ │ │ │ +00034a50: 6d70 696c 6564 2069 6e74 6f20 7468 6520 mpiled into the │ │ │ │ │ +00034a60: 7072 6f6a 6563 7420 746f 2070 726f 7669 project to provi │ │ │ │ │ +00034a70: 6465 2061 6e20 696d 706c 656d 656e 7461 de an implementa │ │ │ │ │ +00034a80: 7469 6f6e 2066 6f72 2066 756e 6374 696f tion for functio │ │ │ │ │ +00034a90: 6e73 0a74 6861 7420 6172 6520 6d69 7373 ns.that are miss │ │ │ │ │ +00034aa0: 696e 6720 6f72 2062 726f 6b65 6e20 6f6e ing or broken on │ │ │ │ │ +00034ab0: 2074 6865 2068 6f73 7420 7379 7374 656d the host system │ │ │ │ │ +00034ac0: 2e20 2054 6865 7920 6172 6520 7375 6273 . They are subs │ │ │ │ │ +00034ad0: 7469 7475 7465 6420 6279 0a27 636f 6e66 tituted by.'conf │ │ │ │ │ +00034ae0: 6967 7572 6527 2e0a 0a20 2020 5468 6573 igure'... Thes │ │ │ │ │ +00034af0: 6520 7661 7269 6162 6c65 7320 6172 6520 e variables are │ │ │ │ │ +00034b00: 6465 6669 6e65 6420 6279 2041 7574 6f63 defined by Autoc │ │ │ │ │ +00034b10: 6f6e 6620 6d61 6372 6f73 2073 7563 6820 onf macros such │ │ │ │ │ +00034b20: 6173 2027 4143 5f4c 4942 4f42 4a27 2c0a as 'AC_LIBOBJ',. │ │ │ │ │ +00034b30: 2741 435f 5245 504c 4143 455f 4655 4e43 'AC_REPLACE_FUNC │ │ │ │ │ +00034b40: 5327 2028 2a6e 6f74 6520 4765 6e65 7269 S' (*note Generi │ │ │ │ │ +00034b50: 6320 4675 6e63 7469 6f6e 2043 6865 636b c Function Check │ │ │ │ │ +00034b60: 733a 2028 6175 746f 636f 6e66 2947 656e s: (autoconf)Gen │ │ │ │ │ +00034b70: 6572 6963 0a46 756e 6374 696f 6e73 2e29 eric.Functions.) │ │ │ │ │ +00034b80: 2c20 6f72 2027 4143 5f46 554e 435f 414c , or 'AC_FUNC_AL │ │ │ │ │ +00034b90: 4c4f 4341 2720 282a 6e6f 7465 2050 6172 LOCA' (*note Par │ │ │ │ │ +00034ba0: 7469 6375 6c61 7220 4675 6e63 7469 6f6e ticular Function │ │ │ │ │ +00034bb0: 2043 6865 636b 733a 0a28 6175 746f 636f Checks:.(autoco │ │ │ │ │ +00034bc0: 6e66 2950 6172 7469 6375 6c61 7220 4675 nf)Particular Fu │ │ │ │ │ +00034bd0: 6e63 7469 6f6e 732e 292e 2020 4d61 6e79 nctions.). Many │ │ │ │ │ +00034be0: 206f 7468 6572 2041 7574 6f63 6f6e 6620 other Autoconf │ │ │ │ │ +00034bf0: 6d61 6372 6f73 2063 616c 6c0a 2741 435f macros call.'AC_ │ │ │ │ │ +00034c00: 4c49 424f 424a 2720 6f72 2027 4143 5f52 LIBOBJ' or 'AC_R │ │ │ │ │ +00034c10: 4550 4c41 4345 5f46 554e 4353 2720 746f EPLACE_FUNCS' to │ │ │ │ │ +00034c20: 2070 6f70 756c 6174 6520 2724 284c 4942 populate '$(LIB │ │ │ │ │ +00034c30: 4f42 4a53 2927 2e0a 0a20 2020 5573 696e OBJS)'... Usin │ │ │ │ │ +00034c40: 6720 7468 6573 6520 7661 7269 6162 6c65 g these variable │ │ │ │ │ +00034c50: 7320 6973 2076 6572 7920 7369 6d69 6c61 s is very simila │ │ │ │ │ +00034c60: 7220 746f 2064 6f69 6e67 2063 6f6e 6469 r to doing condi │ │ │ │ │ +00034c70: 7469 6f6e 616c 0a63 6f6d 7069 6c61 7469 tional.compilati │ │ │ │ │ +00034c80: 6f6e 2075 7369 6e67 2027 4143 5f53 5542 on using 'AC_SUB │ │ │ │ │ +00034c90: 5354 2720 7661 7269 6162 6c65 732c 2061 ST' variables, a │ │ │ │ │ +00034ca0: 7320 6465 7363 7269 6265 6420 696e 202a s described in * │ │ │ │ │ +00034cb0: 6e6f 7465 0a43 6f6e 6469 7469 6f6e 616c note.Conditional │ │ │ │ │ +00034cc0: 2053 6f75 7263 6573 3a3a 2e20 2054 6861 Sources::. Tha │ │ │ │ │ +00034cd0: 7420 6973 2c20 7768 656e 2062 7569 6c64 t is, when build │ │ │ │ │ +00034ce0: 696e 6720 6120 7072 6f67 7261 6d2c 2027 ing a program, ' │ │ │ │ │ +00034cf0: 2428 4c49 424f 424a 5329 270a 616e 6420 $(LIBOBJS)'.and │ │ │ │ │ +00034d00: 2724 2841 4c4c 4f43 4129 2720 7368 6f75 '$(ALLOCA)' shou │ │ │ │ │ +00034d10: 6c64 2062 6520 6164 6465 6420 746f 2074 ld be added to t │ │ │ │ │ +00034d20: 6865 2061 7373 6f63 6961 7465 6420 272a he associated '* │ │ │ │ │ +00034d30: 5f4c 4441 4444 2720 7661 7269 6162 6c65 _LDADD' variable │ │ │ │ │ +00034d40: 2c20 6f72 0a74 6f20 7468 6520 272a 5f4c , or.to the '*_L │ │ │ │ │ +00034d50: 4942 4144 4427 2076 6172 6961 626c 6520 IBADD' variable │ │ │ │ │ +00034d60: 7768 656e 2062 7569 6c64 696e 6720 6120 when building a │ │ │ │ │ +00034d70: 6c69 6272 6172 792e 2020 486f 7765 7665 library. Howeve │ │ │ │ │ +00034d80: 7220 7468 6572 6520 6973 206e 6f0a 6e65 r there is no.ne │ │ │ │ │ +00034d90: 6564 2074 6f20 6c69 7374 2074 6865 2063 ed to list the c │ │ │ │ │ +00034da0: 6f72 7265 7370 6f6e 6469 6e67 2073 6f75 orresponding sou │ │ │ │ │ +00034db0: 7263 6573 2069 6e20 2745 5854 5241 5f2a rces in 'EXTRA_* │ │ │ │ │ +00034dc0: 5f53 4f55 5243 4553 2720 6e6f 7220 746f _SOURCES' nor to │ │ │ │ │ +00034dd0: 0a64 6566 696e 6520 272a 5f44 4550 454e .define '*_DEPEN │ │ │ │ │ +00034de0: 4445 4e43 4945 5327 2e20 2041 7574 6f6d DENCIES'. Autom │ │ │ │ │ +00034df0: 616b 6520 6175 746f 6d61 7469 6361 6c6c ake automaticall │ │ │ │ │ +00034e00: 7920 6164 6473 2027 2428 4c49 424f 424a y adds '$(LIBOBJ │ │ │ │ │ +00034e10: 5329 2720 616e 640a 2724 2841 4c4c 4f43 S)' and.'$(ALLOC │ │ │ │ │ +00034e20: 4129 2720 746f 2074 6865 2064 6570 656e A)' to the depen │ │ │ │ │ +00034e30: 6465 6e63 6965 732c 2061 6e64 2069 7420 dencies, and it │ │ │ │ │ +00034e40: 7769 6c6c 2064 6973 636f 7665 7220 7468 will discover th │ │ │ │ │ +00034e50: 6520 6c69 7374 206f 660a 636f 7272 6573 e list of.corres │ │ │ │ │ +00034e60: 706f 6e64 696e 6720 736f 7572 6365 2066 ponding source f │ │ │ │ │ +00034e70: 696c 6573 2061 7574 6f6d 6174 6963 616c iles automatical │ │ │ │ │ +00034e80: 6c79 2028 6279 2074 7261 6369 6e67 2074 ly (by tracing t │ │ │ │ │ +00034e90: 6865 2069 6e76 6f63 6174 696f 6e73 206f he invocations o │ │ │ │ │ +00034ea0: 660a 7468 6520 2741 435f 4c49 4253 4f55 f.the 'AC_LIBSOU │ │ │ │ │ +00034eb0: 5243 4527 2041 7574 6f63 6f6e 6620 6d61 RCE' Autoconf ma │ │ │ │ │ +00034ec0: 6372 6f73 292e 2020 4966 2079 6f75 2068 cros). If you h │ │ │ │ │ +00034ed0: 6176 6520 616c 7265 6164 7920 6465 6669 ave already defi │ │ │ │ │ +00034ee0: 6e65 640a 272a 5f44 4550 454e 4445 4e43 ned.'*_DEPENDENC │ │ │ │ │ +00034ef0: 4945 5327 2065 7870 6c69 6369 746c 7920 IES' explicitly │ │ │ │ │ +00034f00: 666f 7220 616e 2075 6e72 656c 6174 6564 for an unrelated │ │ │ │ │ +00034f10: 2072 6561 736f 6e2c 2074 6865 6e20 796f reason, then yo │ │ │ │ │ +00034f20: 7520 6569 7468 6572 0a6e 6565 6420 746f u either.need to │ │ │ │ │ +00034f30: 2061 6464 2074 6865 7365 2076 6172 6961 add these varia │ │ │ │ │ +00034f40: 626c 6573 206d 616e 7561 6c6c 792c 206f bles manually, o │ │ │ │ │ +00034f50: 7220 7573 6520 2745 5854 5241 5f2a 5f44 r use 'EXTRA_*_D │ │ │ │ │ +00034f60: 4550 454e 4445 4e43 4945 5327 0a69 6e73 EPENDENCIES'.ins │ │ │ │ │ +00034f70: 7465 6164 206f 6620 272a 5f44 4550 454e tead of '*_DEPEN │ │ │ │ │ +00034f80: 4445 4e43 4945 5327 2e0a 0a20 2020 5468 DENCIES'... Th │ │ │ │ │ +00034f90: 6573 6520 7661 7269 6162 6c65 7320 6172 ese variables ar │ │ │ │ │ +00034fa0: 6520 7573 7561 6c6c 7920 7573 6564 2074 e usually used t │ │ │ │ │ +00034fb0: 6f20 6275 696c 6420 6120 706f 7274 6162 o build a portab │ │ │ │ │ +00034fc0: 696c 6974 7920 6c69 6272 6172 7920 7468 ility library th │ │ │ │ │ +00034fd0: 6174 0a69 7320 6c69 6e6b 6564 2077 6974 at.is linked wit │ │ │ │ │ +00034fe0: 6820 616c 6c20 7468 6520 7072 6f67 7261 h all the progra │ │ │ │ │ +00034ff0: 6d73 206f 6620 7468 6520 7072 6f6a 6563 ms of the projec │ │ │ │ │ +00035000: 742e 2020 5765 206e 6f77 2072 6576 6965 t. We now revie │ │ │ │ │ +00035010: 7720 6120 7361 6d70 6c65 0a73 6574 7570 w a sample.setup │ │ │ │ │ +00035020: 2e20 2046 6972 7374 2c20 2763 6f6e 6669 . First, 'confi │ │ │ │ │ +00035030: 6775 7265 2e61 6327 2063 6f6e 7461 696e gure.ac' contain │ │ │ │ │ +00035040: 7320 736f 6d65 2063 6865 636b 7320 7468 s some checks th │ │ │ │ │ +00035050: 6174 2061 6666 6563 7420 6569 7468 6572 at affect either │ │ │ │ │ +00035060: 0a27 4c49 424f 424a 5327 206f 7220 2741 .'LIBOBJS' or 'A │ │ │ │ │ +00035070: 4c4c 4f43 4127 2e0a 0a20 2020 2020 2320 LLOCA'... # │ │ │ │ │ +00035080: 636f 6e66 6967 7572 652e 6163 0a20 2020 configure.ac. │ │ │ │ │ +00035090: 2020 2e2e 2e0a 2020 2020 2041 435f 434f .... AC_CO │ │ │ │ │ +000350a0: 4e46 4947 5f4c 4942 4f42 4a5f 4449 5228 NFIG_LIBOBJ_DIR( │ │ │ │ │ +000350b0: 5b6c 6962 5d29 0a20 2020 2020 2e2e 2e0a [lib]). .... │ │ │ │ │ +000350c0: 2020 2020 2041 435f 4655 4e43 5f4d 414c AC_FUNC_MAL │ │ │ │ │ +000350d0: 4c4f 4320 2020 2020 2020 2020 2020 2020 LOC │ │ │ │ │ +000350e0: 646e 6c20 4d61 7920 6164 6420 6d61 6c6c dnl May add mall │ │ │ │ │ +000350f0: 6f63 2e24 284f 424a 4558 5429 2074 6f20 oc.$(OBJEXT) to │ │ │ │ │ +00035100: 4c49 424f 424a 530a 2020 2020 2041 435f LIBOBJS. AC_ │ │ │ │ │ +00035110: 4655 4e43 5f4d 454d 434d 5020 2020 2020 FUNC_MEMCMP │ │ │ │ │ +00035120: 2020 2020 2020 2020 646e 6c20 4d61 7920 dnl May │ │ │ │ │ +00035130: 6164 6420 6d65 6d63 6d70 2e24 284f 424a add memcmp.$(OBJ │ │ │ │ │ +00035140: 4558 5429 2074 6f20 4c49 424f 424a 530a EXT) to LIBOBJS. │ │ │ │ │ +00035150: 2020 2020 2041 435f 5245 504c 4143 455f AC_REPLACE_ │ │ │ │ │ +00035160: 4655 4e43 5328 5b73 7472 6475 705d 2920 FUNCS([strdup]) │ │ │ │ │ +00035170: 646e 6c20 4d61 7920 6164 6420 7374 7264 dnl May add strd │ │ │ │ │ +00035180: 7570 2e24 284f 424a 4558 5429 2074 6f20 up.$(OBJEXT) to │ │ │ │ │ +00035190: 4c49 424f 424a 530a 2020 2020 2041 435f LIBOBJS. AC_ │ │ │ │ │ +000351a0: 4655 4e43 5f41 4c4c 4f43 4120 2020 2020 FUNC_ALLOCA │ │ │ │ │ +000351b0: 2020 2020 2020 2020 646e 6c20 4d61 7920 dnl May │ │ │ │ │ +000351c0: 6164 6420 616c 6c6f 6361 2e24 284f 424a add alloca.$(OBJ │ │ │ │ │ +000351d0: 4558 5429 2074 6f20 414c 4c4f 4341 0a20 EXT) to ALLOCA. │ │ │ │ │ +000351e0: 2020 2020 2e2e 2e0a 2020 2020 2041 435f .... AC_ │ │ │ │ │ +000351f0: 434f 4e46 4947 5f46 494c 4553 285b 0a20 CONFIG_FILES([. │ │ │ │ │ +00035200: 2020 2020 2020 6c69 622f 4d61 6b65 6669 lib/Makefi │ │ │ │ │ +00035210: 6c65 0a20 2020 2020 2020 7372 632f 4d61 le. src/Ma │ │ │ │ │ +00035220: 6b65 6669 6c65 0a20 2020 2020 5d29 0a20 kefile. ]). │ │ │ │ │ +00035230: 2020 2020 4143 5f4f 5554 5055 540a 0a20 AC_OUTPUT.. │ │ │ │ │ +00035240: 2020 5468 6520 2741 435f 434f 4e46 4947 The 'AC_CONFIG │ │ │ │ │ +00035250: 5f4c 4942 4f42 4a5f 4449 5227 2074 656c _LIBOBJ_DIR' tel │ │ │ │ │ +00035260: 6c73 2041 7574 6f63 6f6e 6620 7468 6174 ls Autoconf that │ │ │ │ │ +00035270: 2074 6865 2073 6f75 7263 6520 6669 6c65 the source file │ │ │ │ │ +00035280: 7320 6f66 0a74 6865 7365 206f 626a 6563 s of.these objec │ │ │ │ │ +00035290: 7420 6669 6c65 7320 6172 6520 746f 2062 t files are to b │ │ │ │ │ +000352a0: 6520 666f 756e 6420 696e 2074 6865 2027 e found in the ' │ │ │ │ │ +000352b0: 6c69 622f 2720 6469 7265 6374 6f72 792e lib/' directory. │ │ │ │ │ +000352c0: 2020 4175 746f 6d61 6b65 0a63 616e 2061 Automake.can a │ │ │ │ │ +000352d0: 6c73 6f20 7573 6520 7468 6973 2069 6e66 lso use this inf │ │ │ │ │ +000352e0: 6f72 6d61 7469 6f6e 2c20 6f74 6865 7277 ormation, otherw │ │ │ │ │ +000352f0: 6973 6520 6974 2065 7870 6563 7473 2074 ise it expects t │ │ │ │ │ +00035300: 6865 2073 6f75 7263 6520 6669 6c65 7320 he source files │ │ │ │ │ +00035310: 6172 650a 746f 2062 6520 696e 2074 6865 are.to be in the │ │ │ │ │ +00035320: 2064 6972 6563 746f 7279 2077 6865 7265 directory where │ │ │ │ │ +00035330: 2074 6865 2027 2428 4c49 424f 424a 5329 the '$(LIBOBJS) │ │ │ │ │ +00035340: 2720 616e 6420 2724 2841 4c4c 4f43 4129 ' and '$(ALLOCA) │ │ │ │ │ +00035350: 2720 7661 7269 6162 6c65 730a 6172 6520 ' variables.are │ │ │ │ │ +00035360: 7573 6564 2e0a 0a20 2020 5468 6520 276c used... The 'l │ │ │ │ │ +00035370: 6962 2f27 2064 6972 6563 746f 7279 2073 ib/' directory s │ │ │ │ │ +00035380: 686f 756c 6420 7468 6572 6566 6f72 6520 hould therefore │ │ │ │ │ +00035390: 636f 6e74 6169 6e20 276d 616c 6c6f 632e contain 'malloc. │ │ │ │ │ +000353a0: 6327 2c20 276d 656d 636d 702e 6327 2c0a c', 'memcmp.c',. │ │ │ │ │ +000353b0: 2773 7472 6475 702e 6327 2c20 2761 6c6c 'strdup.c', 'all │ │ │ │ │ +000353c0: 6f63 612e 6327 2e20 2048 6572 6520 6973 oca.c'. Here is │ │ │ │ │ +000353d0: 2069 7473 2027 4d61 6b65 6669 6c65 2e61 its 'Makefile.a │ │ │ │ │ +000353e0: 6d27 3a0a 0a20 2020 2020 2320 6c69 622f m':.. # lib/ │ │ │ │ │ +000353f0: 4d61 6b65 6669 6c65 2e61 6d0a 0a20 2020 Makefile.am.. │ │ │ │ │ +00035400: 2020 6e6f 696e 7374 5f4c 4942 5241 5249 noinst_LIBRARI │ │ │ │ │ +00035410: 4553 203d 206c 6962 636f 6d70 6174 2e61 ES = libcompat.a │ │ │ │ │ +00035420: 0a20 2020 2020 6c69 6263 6f6d 7061 745f . libcompat_ │ │ │ │ │ +00035430: 615f 534f 5552 4345 5320 3d0a 2020 2020 a_SOURCES =. │ │ │ │ │ +00035440: 206c 6962 636f 6d70 6174 5f61 5f4c 4942 libcompat_a_LIB │ │ │ │ │ +00035450: 4144 4420 3d20 2428 4c49 424f 424a 5329 ADD = $(LIBOBJS) │ │ │ │ │ +00035460: 2024 2841 4c4c 4f43 4129 0a0a 2020 2054 $(ALLOCA).. T │ │ │ │ │ +00035470: 6865 206c 6962 7261 7279 2063 616e 2068 he library can h │ │ │ │ │ +00035480: 6176 6520 616e 7920 6e61 6d65 2c20 6f66 ave any name, of │ │ │ │ │ +00035490: 2063 6f75 7273 652c 2061 6e64 2061 6e79 course, and any │ │ │ │ │ +000354a0: 7761 7920 6974 2069 7320 6e6f 7420 676f way it is not go │ │ │ │ │ +000354b0: 696e 670a 746f 2062 6520 696e 7374 616c ing.to be instal │ │ │ │ │ +000354c0: 6c65 643a 2069 7420 6a75 7374 2068 6f6c led: it just hol │ │ │ │ │ +000354d0: 6473 2074 6865 2072 6570 6c61 6365 6d65 ds the replaceme │ │ │ │ │ +000354e0: 6e74 2076 6572 7369 6f6e 7320 6f66 2074 nt versions of t │ │ │ │ │ +000354f0: 6865 206d 6973 7369 6e67 0a6f 7220 6272 he missing.or br │ │ │ │ │ +00035500: 6f6b 656e 2066 756e 6374 696f 6e73 2073 oken functions s │ │ │ │ │ +00035510: 6f20 7765 2063 616e 206c 6174 6572 206c o we can later l │ │ │ │ │ +00035520: 696e 6b20 7468 656d 2069 6e2e 2020 4d61 ink them in. Ma │ │ │ │ │ +00035530: 6e79 2070 726f 6a65 6374 7320 616c 736f ny projects also │ │ │ │ │ +00035540: 0a69 6e63 6c75 6465 2065 7874 7261 2066 .include extra f │ │ │ │ │ +00035550: 756e 6374 696f 6e73 2c20 7370 6563 6966 unctions, specif │ │ │ │ │ +00035560: 6963 2074 6f20 7468 6520 7072 6f6a 6563 ic to the projec │ │ │ │ │ +00035570: 742c 2069 6e20 7468 6174 206c 6962 7261 t, in that libra │ │ │ │ │ +00035580: 7279 3a20 7468 6579 0a61 7265 2073 696d ry: they.are sim │ │ │ │ │ +00035590: 706c 7920 6164 6465 6420 6f6e 2074 6865 ply added on the │ │ │ │ │ +000355a0: 2027 5f53 4f55 5243 4553 2720 6c69 6e65 '_SOURCES' line │ │ │ │ │ +000355b0: 2e0a 0a20 2020 5468 6572 6520 6973 2061 ... There is a │ │ │ │ │ +000355c0: 2073 6d61 6c6c 2074 7261 7020 6865 7265 small trap here │ │ │ │ │ +000355d0: 2c20 7468 6f75 6768 3a20 2724 284c 4942 , though: '$(LIB │ │ │ │ │ +000355e0: 4f42 4a53 2927 2061 6e64 2027 2428 414c OBJS)' and '$(AL │ │ │ │ │ +000355f0: 4c4f 4341 2927 0a6d 6967 6874 2062 6520 LOCA)'.might be │ │ │ │ │ +00035600: 656d 7074 792c 2061 6e64 2062 7569 6c64 empty, and build │ │ │ │ │ +00035610: 696e 6720 616e 2065 6d70 7479 206c 6962 ing an empty lib │ │ │ │ │ +00035620: 7261 7279 2069 7320 6e6f 7420 706f 7274 rary is not port │ │ │ │ │ +00035630: 6162 6c65 2e20 2059 6f75 0a73 686f 756c able. You.shoul │ │ │ │ │ +00035640: 6420 656e 7375 7265 2074 6861 7420 7468 d ensure that th │ │ │ │ │ +00035650: 6572 6520 6973 2061 6c77 6179 7320 736f ere is always so │ │ │ │ │ +00035660: 6d65 7468 696e 6720 746f 2070 7574 2069 mething to put i │ │ │ │ │ +00035670: 6e20 276c 6962 636f 6d70 6174 2e61 272e n 'libcompat.a'. │ │ │ │ │ +00035680: 0a4d 6f73 7420 7072 6f6a 6563 7473 2077 .Most projects w │ │ │ │ │ +00035690: 696c 6c20 616c 736f 2061 6464 2073 6f6d ill also add som │ │ │ │ │ +000356a0: 6520 7574 696c 6974 7920 6675 6e63 7469 e utility functi │ │ │ │ │ +000356b0: 6f6e 7320 696e 2074 6861 7420 6469 7265 ons in that dire │ │ │ │ │ +000356c0: 6374 6f72 792c 0a61 6e64 206c 6973 7420 ctory,.and list │ │ │ │ │ +000356d0: 7468 656d 2069 6e20 276c 6962 636f 6d70 them in 'libcomp │ │ │ │ │ +000356e0: 6174 5f61 5f53 4f55 5243 4553 272c 2073 at_a_SOURCES', s │ │ │ │ │ +000356f0: 6f20 696e 2070 7261 6374 6963 6520 276c o in practice 'l │ │ │ │ │ +00035700: 6962 636f 6d70 6174 2e61 270a 6361 6e6e ibcompat.a'.cann │ │ │ │ │ +00035710: 6f74 2062 6520 656d 7074 792e 0a0a 2020 ot be empty... │ │ │ │ │ +00035720: 2046 696e 616c 6c79 2068 6572 6520 6973 Finally here is │ │ │ │ │ +00035730: 2068 6f77 2074 6869 7320 6c69 6272 6172 how this librar │ │ │ │ │ +00035740: 7920 636f 756c 6420 6265 2075 7365 6420 y could be used │ │ │ │ │ +00035750: 6672 6f6d 2074 6865 2027 7372 632f 270a from the 'src/'. │ │ │ │ │ +00035760: 6469 7265 6374 6f72 792e 0a0a 2020 2020 directory... │ │ │ │ │ +00035770: 2023 2073 7263 2f4d 616b 6566 696c 652e # src/Makefile. │ │ │ │ │ +00035780: 616d 0a0a 2020 2020 2023 204c 696e 6b20 am.. # Link │ │ │ │ │ +00035790: 616c 6c20 7072 6f67 7261 6d73 2069 6e20 all programs in │ │ │ │ │ +000357a0: 7468 6973 2064 6972 6563 746f 7279 2077 this directory w │ │ │ │ │ +000357b0: 6974 6820 6c69 6263 6f6d 7061 742e 610a ith libcompat.a. │ │ │ │ │ +000357c0: 2020 2020 204c 4441 4444 203d 202e 2e2f LDADD = ../ │ │ │ │ │ +000357d0: 6c69 622f 6c69 6263 6f6d 7061 742e 610a lib/libcompat.a. │ │ │ │ │ +000357e0: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ +000357f0: 4d53 203d 2074 6f6f 6c31 2074 6f6f 6c32 MS = tool1 tool2 │ │ │ │ │ +00035800: 202e 2e2e 0a20 2020 2020 746f 6f6c 315f .... tool1_ │ │ │ │ │ +00035810: 534f 5552 4345 5320 3d20 2e2e 2e0a 2020 SOURCES = .... │ │ │ │ │ +00035820: 2020 2074 6f6f 6c32 5f53 4f55 5243 4553 tool2_SOURCES │ │ │ │ │ +00035830: 203d 202e 2e2e 0a0a 2020 2057 6865 6e20 = ..... When │ │ │ │ │ +00035840: 6f70 7469 6f6e 2027 7375 6264 6972 2d6f option 'subdir-o │ │ │ │ │ +00035850: 626a 6563 7473 2720 6973 206e 6f74 2075 bjects' is not u │ │ │ │ │ +00035860: 7365 642c 2061 7320 696e 2074 6865 2061 sed, as in the a │ │ │ │ │ +00035870: 626f 7665 2065 7861 6d70 6c65 2c0a 7468 bove example,.th │ │ │ │ │ +00035880: 6520 7661 7269 6162 6c65 7320 2724 284c e variables '$(L │ │ │ │ │ +00035890: 4942 4f42 4a53 2927 206f 7220 2724 2841 IBOBJS)' or '$(A │ │ │ │ │ +000358a0: 4c4c 4f43 4129 2720 6361 6e20 6f6e 6c79 LLOCA)' can only │ │ │ │ │ +000358b0: 2062 6520 7573 6564 2069 6e20 7468 650a be used in the. │ │ │ │ │ +000358c0: 6469 7265 6374 6f72 7920 7768 6572 6520 directory where │ │ │ │ │ +000358d0: 7468 6569 7220 736f 7572 6365 7320 6c69 their sources li │ │ │ │ │ +000358e0: 652e 2020 452e 672e 2c20 6865 7265 2069 e. E.g., here i │ │ │ │ │ +000358f0: 7420 776f 756c 6420 6265 2077 726f 6e67 t would be wrong │ │ │ │ │ +00035900: 2074 6f20 7573 650a 2724 284c 4942 4f42 to use.'$(LIBOB │ │ │ │ │ +00035910: 4a53 2927 206f 7220 2724 2841 4c4c 4f43 JS)' or '$(ALLOC │ │ │ │ │ +00035920: 4129 2720 696e 2027 7372 632f 4d61 6b65 A)' in 'src/Make │ │ │ │ │ +00035930: 6669 6c65 2e61 6d27 2e20 2048 6f77 6576 file.am'. Howev │ │ │ │ │ +00035940: 6572 2069 6620 626f 7468 0a27 7375 6264 er if both.'subd │ │ │ │ │ +00035950: 6972 2d6f 626a 6563 7473 2720 616e 6420 ir-objects' and │ │ │ │ │ +00035960: 2741 435f 434f 4e46 4947 5f4c 4942 4f42 'AC_CONFIG_LIBOB │ │ │ │ │ +00035970: 4a5f 4449 5227 2061 7265 2075 7365 642c J_DIR' are used, │ │ │ │ │ +00035980: 2069 7420 6973 204f 4b20 746f 2075 7365 it is OK to use │ │ │ │ │ +00035990: 0a74 6865 7365 2076 6172 6961 626c 6573 .these variables │ │ │ │ │ +000359a0: 2069 6e20 6f74 6865 7220 6469 7265 6374 in other direct │ │ │ │ │ +000359b0: 6f72 6965 732e 2020 466f 7220 696e 7374 ories. For inst │ │ │ │ │ +000359c0: 616e 6365 2027 7372 632f 4d61 6b65 6669 ance 'src/Makefi │ │ │ │ │ +000359d0: 6c65 2e61 6d27 0a63 6f75 6c64 2062 6520 le.am'.could be │ │ │ │ │ +000359e0: 6368 616e 6765 6420 6173 2066 6f6c 6c6f changed as follo │ │ │ │ │ +000359f0: 7773 2e0a 0a20 2020 2020 2320 7372 632f ws... # src/ │ │ │ │ │ +00035a00: 4d61 6b65 6669 6c65 2e61 6d0a 0a20 2020 Makefile.am.. │ │ │ │ │ +00035a10: 2020 4155 544f 4d41 4b45 5f4f 5054 494f AUTOMAKE_OPTIO │ │ │ │ │ +00035a20: 4e53 203d 2073 7562 6469 722d 6f62 6a65 NS = subdir-obje │ │ │ │ │ +00035a30: 6374 730a 2020 2020 204c 4441 4444 203d cts. LDADD = │ │ │ │ │ +00035a40: 2024 284c 4942 4f42 4a53 2920 2428 414c $(LIBOBJS) $(AL │ │ │ │ │ +00035a50: 4c4f 4341 290a 0a20 2020 2020 6269 6e5f LOCA).. bin_ │ │ │ │ │ +00035a60: 5052 4f47 5241 4d53 203d 2074 6f6f 6c31 PROGRAMS = tool1 │ │ │ │ │ +00035a70: 2074 6f6f 6c32 202e 2e2e 0a20 2020 2020 tool2 .... │ │ │ │ │ +00035a80: 746f 6f6c 315f 534f 5552 4345 5320 3d20 tool1_SOURCES = │ │ │ │ │ +00035a90: 2e2e 2e0a 2020 2020 2074 6f6f 6c32 5f53 .... tool2_S │ │ │ │ │ +00035aa0: 4f55 5243 4553 203d 202e 2e2e 0a0a 2020 OURCES = ..... │ │ │ │ │ +00035ab0: 2042 6563 6175 7365 2027 2428 4c49 424f Because '$(LIBO │ │ │ │ │ +00035ac0: 424a 5329 2720 616e 6420 2724 2841 4c4c BJS)' and '$(ALL │ │ │ │ │ +00035ad0: 4f43 4129 2720 636f 6e74 6169 6e20 6f62 OCA)' contain ob │ │ │ │ │ +00035ae0: 6a65 6374 2066 696c 6520 6e61 6d65 7320 ject file names │ │ │ │ │ +00035af0: 7468 6174 0a65 6e64 2077 6974 6820 272e that.end with '. │ │ │ │ │ +00035b00: 2428 4f42 4a45 5854 2927 2c20 7468 6579 $(OBJEXT)', they │ │ │ │ │ +00035b10: 2061 7265 206e 6f74 2073 7569 7461 626c are not suitabl │ │ │ │ │ +00035b20: 6520 666f 7220 4c69 6274 6f6f 6c20 6c69 e for Libtool li │ │ │ │ │ +00035b30: 6272 6172 6965 730a 2877 6865 7265 2074 braries.(where t │ │ │ │ │ +00035b40: 6865 2065 7870 6563 7465 6420 6f62 6a65 he expected obje │ │ │ │ │ +00035b50: 6374 2065 7874 656e 7369 6f6e 2069 7320 ct extension is │ │ │ │ │ +00035b60: 272e 6c6f 2729 3a20 274c 544c 4942 4f42 '.lo'): 'LTLIBOB │ │ │ │ │ +00035b70: 4a53 2720 616e 640a 274c 5441 4c4c 4f43 JS' and.'LTALLOC │ │ │ │ │ +00035b80: 4127 2073 686f 756c 6420 6265 2075 7365 A' should be use │ │ │ │ │ +00035b90: 6420 696e 7374 6561 642e 0a0a 2020 2027 d instead... ' │ │ │ │ │ +00035ba0: 4c54 4c49 424f 424a 5327 2069 7320 6465 LTLIBOBJS' is de │ │ │ │ │ +00035bb0: 6669 6e65 6420 6175 746f 6d61 7469 6361 fined automatica │ │ │ │ │ +00035bc0: 6c6c 7920 6279 2041 7574 6f63 6f6e 6620 lly by Autoconf │ │ │ │ │ +00035bd0: 616e 6420 7368 6f75 6c64 206e 6f74 2062 and should not b │ │ │ │ │ +00035be0: 650a 6465 6669 6e65 6420 6279 2068 616e e.defined by han │ │ │ │ │ +00035bf0: 6420 2861 7320 696e 2074 6865 2070 6173 d (as in the pas │ │ │ │ │ +00035c00: 7429 2c20 686f 7765 7665 7220 6174 2074 t), however at t │ │ │ │ │ +00035c10: 6865 2074 696d 6520 6f66 2077 7269 7469 he time of writi │ │ │ │ │ +00035c20: 6e67 0a27 4c54 414c 4c4f 4341 2720 7374 ng.'LTALLOCA' st │ │ │ │ │ +00035c30: 696c 6c20 6e65 6564 7320 746f 2062 6520 ill needs to be │ │ │ │ │ +00035c40: 6465 6669 6e65 6420 6672 6f6d 2027 414c defined from 'AL │ │ │ │ │ +00035c50: 4c4f 4341 2720 6d61 6e75 616c 6c79 2e20 LOCA' manually. │ │ │ │ │ +00035c60: 202a 4e6f 7465 0a27 4143 5f4c 4942 4f42 *Note.'AC_LIBOB │ │ │ │ │ +00035c70: 4a27 2076 732e 2027 4c49 424f 424a 5327 J' vs. 'LIBOBJS' │ │ │ │ │ +00035c80: 3a20 2861 7574 6f63 6f6e 6629 4143 5f4c : (autoconf)AC_L │ │ │ │ │ +00035c90: 4942 4f42 4a20 7673 204c 4942 4f42 4a53 IBOBJ vs LIBOBJS │ │ │ │ │ +00035ca0: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +00035cb0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +00035cc0: 4e6f 6465 3a20 5072 6f67 7261 6d20 5661 Node: Program Va │ │ │ │ │ +00035cd0: 7269 6162 6c65 732c 2020 4e65 7874 3a20 riables, Next: │ │ │ │ │ +00035ce0: 5961 6363 2061 6e64 204c 6578 2c20 2050 Yacc and Lex, P │ │ │ │ │ +00035cf0: 7265 763a 204c 4942 4f42 4a53 2c20 2055 rev: LIBOBJS, U │ │ │ │ │ +00035d00: 703a 2050 726f 6772 616d 730a 0a38 2e37 p: Programs..8.7 │ │ │ │ │ +00035d10: 2056 6172 6961 626c 6573 2075 7365 6420 Variables used │ │ │ │ │ +00035d20: 7768 656e 2062 7569 6c64 696e 6720 6120 when building a │ │ │ │ │ +00035d30: 7072 6f67 7261 6d0a 3d3d 3d3d 3d3d 3d3d program.======== │ │ │ │ │ 00035d40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00035d50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00035d60: 0a0a 4f63 6361 7369 6f6e 616c 6c79 2069 ..Occasionally i │ │ │ │ │ -00035d70: 7420 6973 2075 7365 6675 6c20 746f 206b t is useful to k │ │ │ │ │ -00035d80: 6e6f 7720 7768 6963 6820 274d 616b 6566 now which 'Makef │ │ │ │ │ -00035d90: 696c 6527 2076 6172 6961 626c 6573 2041 ile' variables A │ │ │ │ │ -00035da0: 7574 6f6d 616b 650a 7573 6573 2066 6f72 utomake.uses for │ │ │ │ │ -00035db0: 2063 6f6d 7069 6c61 7469 6f6e 732c 2061 compilations, a │ │ │ │ │ -00035dc0: 6e64 2069 6e20 7768 6963 6820 6f72 6465 nd in which orde │ │ │ │ │ -00035dd0: 7220 282a 6e6f 7465 2046 6c61 6720 5661 r (*note Flag Va │ │ │ │ │ -00035de0: 7269 6162 6c65 730a 4f72 6465 7269 6e67 riables.Ordering │ │ │ │ │ -00035df0: 3a3a 293b 2066 6f72 2069 6e73 7461 6e63 ::); for instanc │ │ │ │ │ -00035e00: 652c 2079 6f75 206d 6967 6874 206e 6565 e, you might nee │ │ │ │ │ -00035e10: 6420 746f 2064 6f20 796f 7572 206f 776e d to do your own │ │ │ │ │ -00035e20: 2063 6f6d 7069 6c61 7469 6f6e 2069 6e0a compilation in. │ │ │ │ │ -00035e30: 736f 6d65 2073 7065 6369 616c 2063 6173 some special cas │ │ │ │ │ -00035e40: 6573 2e0a 0a20 2020 536f 6d65 2076 6172 es... Some var │ │ │ │ │ -00035e50: 6961 626c 6573 2061 7265 2069 6e68 6572 iables are inher │ │ │ │ │ -00035e60: 6974 6564 2066 726f 6d20 4175 746f 636f ited from Autoco │ │ │ │ │ -00035e70: 6e66 3b20 7468 6573 6520 6172 6520 2743 nf; these are 'C │ │ │ │ │ -00035e80: 4327 2c20 2743 464c 4147 5327 2c0a 2743 C', 'CFLAGS',.'C │ │ │ │ │ -00035e90: 5050 464c 4147 5327 2c20 2744 4546 5327 PPFLAGS', 'DEFS' │ │ │ │ │ -00035ea0: 2c20 274c 4446 4c41 4753 272c 2061 6e64 , 'LDFLAGS', and │ │ │ │ │ -00035eb0: 2027 4c49 4253 272e 0a0a 2020 2054 6865 'LIBS'... The │ │ │ │ │ -00035ec0: 7265 2061 7265 2073 6f6d 6520 6164 6469 re are some addi │ │ │ │ │ -00035ed0: 7469 6f6e 616c 2076 6172 6961 626c 6573 tional variables │ │ │ │ │ -00035ee0: 2074 6861 7420 4175 746f 6d61 6b65 2064 that Automake d │ │ │ │ │ -00035ef0: 6566 696e 6573 206f 6e20 6974 7320 6f77 efines on its ow │ │ │ │ │ -00035f00: 6e3a 0a0a 2741 4d5f 4350 5046 4c41 4753 n:..'AM_CPPFLAGS │ │ │ │ │ -00035f10: 270a 2020 2020 2054 6865 2063 6f6e 7465 '. The conte │ │ │ │ │ -00035f20: 6e74 7320 6f66 2074 6869 7320 7661 7269 nts of this vari │ │ │ │ │ -00035f30: 6162 6c65 2061 7265 2070 6173 7365 6420 able are passed │ │ │ │ │ -00035f40: 746f 2065 7665 7279 2063 6f6d 7069 6c61 to every compila │ │ │ │ │ -00035f50: 7469 6f6e 2074 6861 740a 2020 2020 2069 tion that. i │ │ │ │ │ -00035f60: 6e76 6f6b 6573 2074 6865 2043 2070 7265 nvokes the C pre │ │ │ │ │ -00035f70: 7072 6f63 6573 736f 723b 2069 7420 6973 processor; it is │ │ │ │ │ -00035f80: 2061 206c 6973 7420 6f66 2061 7267 756d a list of argum │ │ │ │ │ -00035f90: 656e 7473 2074 6f20 7468 650a 2020 2020 ents to the. │ │ │ │ │ -00035fa0: 2070 7265 7072 6f63 6573 736f 722e 2020 preprocessor. │ │ │ │ │ -00035fb0: 466f 7220 696e 7374 616e 6365 2c20 272d For instance, '- │ │ │ │ │ -00035fc0: 4927 2061 6e64 2027 2d44 2720 6f70 7469 I' and '-D' opti │ │ │ │ │ -00035fd0: 6f6e 7320 7368 6f75 6c64 2062 6520 6c69 ons should be li │ │ │ │ │ -00035fe0: 7374 6564 0a20 2020 2020 6865 7265 2e0a sted. here.. │ │ │ │ │ -00035ff0: 0a20 2020 2020 4175 746f 6d61 6b65 2061 . Automake a │ │ │ │ │ -00036000: 6c72 6561 6479 2070 726f 7669 6465 7320 lready provides │ │ │ │ │ -00036010: 736f 6d65 2027 2d49 2720 6f70 7469 6f6e some '-I' option │ │ │ │ │ -00036020: 7320 6175 746f 6d61 7469 6361 6c6c 792c s automatically, │ │ │ │ │ -00036030: 2069 6e20 610a 2020 2020 2073 6570 6172 in a. separ │ │ │ │ │ -00036040: 6174 6520 7661 7269 6162 6c65 2074 6861 ate variable tha │ │ │ │ │ -00036050: 7420 6973 2061 6c73 6f20 7061 7373 6564 t is also passed │ │ │ │ │ -00036060: 2074 6f20 6576 6572 7920 636f 6d70 696c to every compil │ │ │ │ │ -00036070: 6174 696f 6e20 7468 6174 0a20 2020 2020 ation that. │ │ │ │ │ -00036080: 696e 766f 6b65 7320 7468 6520 4320 7072 invokes the C pr │ │ │ │ │ -00036090: 6570 726f 6365 7373 6f72 2e20 2049 6e20 eprocessor. In │ │ │ │ │ -000360a0: 7061 7274 6963 756c 6172 2069 7420 6765 particular it ge │ │ │ │ │ -000360b0: 6e65 7261 7465 7320 272d 492e 272c 0a20 nerates '-I.',. │ │ │ │ │ -000360c0: 2020 2020 272d 4924 2873 7263 6469 7229 '-I$(srcdir) │ │ │ │ │ -000360d0: 272c 2061 6e64 2061 2027 2d49 2720 706f ', and a '-I' po │ │ │ │ │ -000360e0: 696e 7469 6e67 2074 6f20 7468 6520 6469 inting to the di │ │ │ │ │ -000360f0: 7265 6374 6f72 7920 686f 6c64 696e 670a rectory holding. │ │ │ │ │ -00036100: 2020 2020 2027 636f 6e66 6967 2e68 2720 'config.h' │ │ │ │ │ -00036110: 2869 6620 796f 7527 7665 2075 7365 6420 (if you've used │ │ │ │ │ -00036120: 2741 435f 434f 4e46 4947 5f48 4541 4445 'AC_CONFIG_HEADE │ │ │ │ │ -00036130: 5253 2720 6f72 0a20 2020 2020 2741 4d5f RS' or. 'AM_ │ │ │ │ │ -00036140: 434f 4e46 4947 5f48 4541 4445 5227 292e CONFIG_HEADER'). │ │ │ │ │ -00036150: 2020 596f 7520 6361 6e20 6469 7361 626c You can disabl │ │ │ │ │ -00036160: 6520 7468 6520 6465 6661 756c 7420 272d e the default '- │ │ │ │ │ -00036170: 4927 206f 7074 696f 6e73 0a20 2020 2020 I' options. │ │ │ │ │ -00036180: 7573 696e 6720 7468 6520 276e 6f73 7464 using the 'nostd │ │ │ │ │ -00036190: 696e 6327 206f 7074 696f 6e2e 0a0a 2020 inc' option... │ │ │ │ │ -000361a0: 2020 2057 6865 6e20 6120 6669 6c65 2074 When a file t │ │ │ │ │ -000361b0: 6f20 6265 2069 6e63 6c75 6465 6420 6973 o be included is │ │ │ │ │ -000361c0: 2067 656e 6572 6174 6564 2064 7572 696e generated durin │ │ │ │ │ -000361d0: 6720 7468 6520 6275 696c 6420 616e 6420 g the build and │ │ │ │ │ -000361e0: 6e6f 740a 2020 2020 2070 6172 7420 6f66 not. part of │ │ │ │ │ -000361f0: 2061 2064 6973 7472 6962 7574 696f 6e20 a distribution │ │ │ │ │ -00036200: 7461 7262 616c 6c2c 2069 7473 206c 6f63 tarball, its loc │ │ │ │ │ -00036210: 6174 696f 6e20 6973 2075 6e64 6572 0a20 ation is under. │ │ │ │ │ -00036220: 2020 2020 2724 2862 7569 6c64 6469 7229 '$(builddir) │ │ │ │ │ -00036230: 272c 206e 6f74 2075 6e64 6572 2027 2428 ', not under '$( │ │ │ │ │ -00036240: 7372 6364 6972 2927 2e20 2054 6869 7320 srcdir)'. This │ │ │ │ │ -00036250: 6d61 7474 6572 7320 6573 7065 6369 616c matters especial │ │ │ │ │ -00036260: 6c79 2066 6f72 0a20 2020 2020 7061 636b ly for. pack │ │ │ │ │ -00036270: 6167 6573 2074 6861 7420 7573 6520 6865 ages that use he │ │ │ │ │ -00036280: 6164 6572 2066 696c 6573 2070 6c61 6365 ader files place │ │ │ │ │ -00036290: 6420 696e 2073 7562 2d64 6972 6563 746f d in sub-directo │ │ │ │ │ -000362a0: 7269 6573 2061 6e64 2077 616e 740a 2020 ries and want. │ │ │ │ │ -000362b0: 2020 2074 6f20 616c 6c6f 7720 6275 696c to allow buil │ │ │ │ │ -000362c0: 6473 206f 7574 7369 6465 2074 6865 2073 ds outside the s │ │ │ │ │ -000362d0: 6f75 7263 6520 7472 6565 2028 2a6e 6f74 ource tree (*not │ │ │ │ │ -000362e0: 6520 5650 4154 4820 4275 696c 6473 3a3a e VPATH Builds:: │ │ │ │ │ -000362f0: 292e 2020 496e 0a20 2020 2020 7468 6174 ). In. that │ │ │ │ │ -00036300: 2063 6173 6520 7765 2072 6563 6f6d 6d65 case we recomme │ │ │ │ │ -00036310: 6e64 2074 6f20 7573 6520 6120 7061 6972 nd to use a pair │ │ │ │ │ -00036320: 206f 6620 272d 4927 206f 7074 696f 6e73 of '-I' options │ │ │ │ │ -00036330: 2c20 7375 6368 2061 732c 0a20 2020 2020 , such as,. │ │ │ │ │ -00036340: 652e 672e 2c20 272d 4973 6f6d 652f 7375 e.g., '-Isome/su │ │ │ │ │ -00036350: 6264 6972 202d 4924 2873 7263 6469 7229 bdir -I$(srcdir) │ │ │ │ │ -00036360: 2f73 6f6d 652f 7375 6264 6972 2720 6f72 /some/subdir' or │ │ │ │ │ -00036370: 0a20 2020 2020 272d 4924 2874 6f70 5f62 . '-I$(top_b │ │ │ │ │ -00036380: 7569 6c64 6469 7229 2f73 6f6d 652f 7375 uilddir)/some/su │ │ │ │ │ -00036390: 6264 6972 202d 4924 2874 6f70 5f73 7263 bdir -I$(top_src │ │ │ │ │ -000363a0: 6469 7229 2f73 6f6d 652f 7375 6264 6972 dir)/some/subdir │ │ │ │ │ -000363b0: 272e 2020 4e6f 7465 0a20 2020 2020 7468 '. Note. th │ │ │ │ │ -000363c0: 6174 2074 6865 2072 6566 6572 656e 6365 at the reference │ │ │ │ │ -000363d0: 2074 6f20 7468 6520 6275 696c 6420 7472 to the build tr │ │ │ │ │ -000363e0: 6565 2073 686f 756c 6420 636f 6d65 2062 ee should come b │ │ │ │ │ -000363f0: 6566 6f72 6520 7468 650a 2020 2020 2072 efore the. r │ │ │ │ │ -00036400: 6566 6572 656e 6365 2074 6f20 7468 6520 eference to the │ │ │ │ │ -00036410: 736f 7572 6365 2074 7265 652c 2073 6f20 source tree, so │ │ │ │ │ -00036420: 7468 6174 2061 6363 6964 656e 7461 6c6c that accidentall │ │ │ │ │ -00036430: 7920 6c65 6674 6f76 6572 0a20 2020 2020 y leftover. │ │ │ │ │ -00036440: 6765 6e65 7261 7465 6420 6669 6c65 7320 generated files │ │ │ │ │ -00036450: 696e 2074 6865 2073 6f75 7263 6520 6469 in the source di │ │ │ │ │ -00036460: 7265 6374 6f72 7920 6172 6520 6967 6e6f rectory are igno │ │ │ │ │ -00036470: 7265 642e 0a0a 2020 2020 2027 414d 5f43 red... 'AM_C │ │ │ │ │ -00036480: 5050 464c 4147 5327 2069 7320 6967 6e6f PPFLAGS' is igno │ │ │ │ │ -00036490: 7265 6420 696e 2070 7265 6665 7265 6e63 red in preferenc │ │ │ │ │ -000364a0: 6520 746f 2061 2070 6572 2d65 7865 6375 e to a per-execu │ │ │ │ │ -000364b0: 7461 626c 6520 286f 720a 2020 2020 2070 table (or. p │ │ │ │ │ -000364c0: 6572 2d6c 6962 7261 7279 2920 275f 4350 er-library) '_CP │ │ │ │ │ -000364d0: 5046 4c41 4753 2720 7661 7269 6162 6c65 PFLAGS' variable │ │ │ │ │ -000364e0: 2069 6620 6974 2069 7320 6465 6669 6e65 if it is define │ │ │ │ │ -000364f0: 642e 0a0a 2749 4e43 4c55 4445 5327 0a20 d...'INCLUDES'. │ │ │ │ │ -00036500: 2020 2020 5468 6973 2064 6f65 7320 7468 This does th │ │ │ │ │ -00036510: 6520 7361 6d65 206a 6f62 2061 7320 2741 e same job as 'A │ │ │ │ │ -00036520: 4d5f 4350 5046 4c41 4753 2720 286f 7220 M_CPPFLAGS' (or │ │ │ │ │ -00036530: 616e 7920 7065 722d 7461 7267 6574 0a20 any per-target. │ │ │ │ │ -00036540: 2020 2020 275f 4350 5046 4c41 4753 2720 '_CPPFLAGS' │ │ │ │ │ -00036550: 7661 7269 6162 6c65 2069 6620 6974 2069 variable if it i │ │ │ │ │ -00036560: 7320 7573 6564 292e 2020 4974 2069 7320 s used). It is │ │ │ │ │ -00036570: 616e 206f 6c64 6572 206e 616d 6520 666f an older name fo │ │ │ │ │ -00036580: 7220 7468 650a 2020 2020 2073 616d 6520 r the. same │ │ │ │ │ -00036590: 6675 6e63 7469 6f6e 616c 6974 792e 2020 functionality. │ │ │ │ │ -000365a0: 5468 6973 2076 6172 6961 626c 6520 6973 This variable is │ │ │ │ │ -000365b0: 2064 6570 7265 6361 7465 643b 2077 6520 deprecated; we │ │ │ │ │ -000365c0: 7375 6767 6573 7420 7573 696e 670a 2020 suggest using. │ │ │ │ │ -000365d0: 2020 2027 414d 5f43 5050 464c 4147 5327 'AM_CPPFLAGS' │ │ │ │ │ -000365e0: 2061 6e64 2070 6572 2d74 6172 6765 7420 and per-target │ │ │ │ │ -000365f0: 275f 4350 5046 4c41 4753 2720 696e 7374 '_CPPFLAGS' inst │ │ │ │ │ -00036600: 6561 642e 0a0a 2741 4d5f 4346 4c41 4753 ead...'AM_CFLAGS │ │ │ │ │ -00036610: 270a 2020 2020 2054 6869 7320 6973 2074 '. This is t │ │ │ │ │ -00036620: 6865 2076 6172 6961 626c 6520 7468 6520 he variable the │ │ │ │ │ -00036630: 274d 616b 6566 696c 652e 616d 2720 6175 'Makefile.am' au │ │ │ │ │ -00036640: 7468 6f72 2063 616e 2075 7365 2074 6f20 thor can use to │ │ │ │ │ -00036650: 7061 7373 2069 6e0a 2020 2020 2061 6464 pass in. add │ │ │ │ │ -00036660: 6974 696f 6e61 6c20 4320 636f 6d70 696c itional C compil │ │ │ │ │ -00036670: 6572 2066 6c61 6773 2e20 2049 7420 6973 er flags. It is │ │ │ │ │ -00036680: 206d 6f72 6520 6675 6c6c 7920 646f 6375 more fully docu │ │ │ │ │ -00036690: 6d65 6e74 6564 0a20 2020 2020 656c 7365 mented. else │ │ │ │ │ -000366a0: 7768 6572 652e 2020 496e 2073 6f6d 6520 where. In some │ │ │ │ │ -000366b0: 7369 7475 6174 696f 6e73 2c20 7468 6973 situations, this │ │ │ │ │ -000366c0: 2069 7320 6e6f 7420 7573 6564 2c20 696e is not used, in │ │ │ │ │ -000366d0: 2070 7265 6665 7265 6e63 6520 746f 0a20 preference to. │ │ │ │ │ -000366e0: 2020 2020 7468 6520 7065 722d 6578 6563 the per-exec │ │ │ │ │ -000366f0: 7574 6162 6c65 2028 6f72 2070 6572 2d6c utable (or per-l │ │ │ │ │ -00036700: 6962 7261 7279 2920 275f 4346 4c41 4753 ibrary) '_CFLAGS │ │ │ │ │ -00036710: 272e 0a0a 2743 4f4d 5049 4c45 270a 2020 '...'COMPILE'. │ │ │ │ │ -00036720: 2020 2054 6869 7320 6973 2074 6865 2063 This is the c │ │ │ │ │ -00036730: 6f6d 6d61 6e64 2075 7365 6420 746f 2061 ommand used to a │ │ │ │ │ -00036740: 6374 7561 6c6c 7920 636f 6d70 696c 6520 ctually compile │ │ │ │ │ -00036750: 6120 4320 736f 7572 6365 2066 696c 652e a C source file. │ │ │ │ │ -00036760: 2020 5468 650a 2020 2020 2066 696c 6520 The. file │ │ │ │ │ -00036770: 6e61 6d65 2069 7320 6170 7065 6e64 6564 name is appended │ │ │ │ │ -00036780: 2074 6f20 666f 726d 2074 6865 2063 6f6d to form the com │ │ │ │ │ -00036790: 706c 6574 6520 636f 6d6d 616e 6420 6c69 plete command li │ │ │ │ │ -000367a0: 6e65 2e0a 0a27 414d 5f4c 4446 4c41 4753 ne...'AM_LDFLAGS │ │ │ │ │ -000367b0: 270a 2020 2020 2054 6869 7320 6973 2074 '. This is t │ │ │ │ │ -000367c0: 6865 2076 6172 6961 626c 6520 7468 6520 he variable the │ │ │ │ │ -000367d0: 274d 616b 6566 696c 652e 616d 2720 6175 'Makefile.am' au │ │ │ │ │ -000367e0: 7468 6f72 2063 616e 2075 7365 2074 6f20 thor can use to │ │ │ │ │ -000367f0: 7061 7373 2069 6e0a 2020 2020 2061 6464 pass in. add │ │ │ │ │ -00036800: 6974 696f 6e61 6c20 6c69 6e6b 6572 2066 itional linker f │ │ │ │ │ -00036810: 6c61 6773 2e20 2049 6e20 736f 6d65 2073 lags. In some s │ │ │ │ │ -00036820: 6974 7561 7469 6f6e 732c 2074 6869 7320 ituations, this │ │ │ │ │ -00036830: 6973 206e 6f74 2075 7365 642c 2069 6e0a is not used, in. │ │ │ │ │ -00036840: 2020 2020 2070 7265 6665 7265 6e63 6520 preference │ │ │ │ │ -00036850: 746f 2074 6865 2070 6572 2d65 7865 6375 to the per-execu │ │ │ │ │ -00036860: 7461 626c 6520 286f 7220 7065 722d 6c69 table (or per-li │ │ │ │ │ -00036870: 6272 6172 7929 2027 5f4c 4446 4c41 4753 brary) '_LDFLAGS │ │ │ │ │ -00036880: 272e 0a0a 274c 494e 4b27 0a20 2020 2020 '...'LINK'. │ │ │ │ │ -00036890: 5468 6973 2069 7320 7468 6520 636f 6d6d This is the comm │ │ │ │ │ -000368a0: 616e 6420 7573 6564 2074 6f20 6163 7475 and used to actu │ │ │ │ │ -000368b0: 616c 6c79 206c 696e 6b20 6120 4320 7072 ally link a C pr │ │ │ │ │ -000368c0: 6f67 7261 6d2e 2020 4974 2061 6c72 6561 ogram. It alrea │ │ │ │ │ -000368d0: 6479 0a20 2020 2020 696e 636c 7564 6573 dy. includes │ │ │ │ │ -000368e0: 2027 2d6f 2024 4027 2061 6e64 2074 6865 '-o $@' and the │ │ │ │ │ -000368f0: 2075 7375 616c 2076 6172 6961 626c 6520 usual variable │ │ │ │ │ -00036900: 7265 6665 7265 6e63 6573 2028 666f 7220 references (for │ │ │ │ │ -00036910: 696e 7374 616e 6365 2c0a 2020 2020 2027 instance,. ' │ │ │ │ │ -00036920: 4346 4c41 4753 2729 3b20 6974 2074 616b CFLAGS'); it tak │ │ │ │ │ -00036930: 6573 2061 7320 2261 7267 756d 656e 7473 es as "arguments │ │ │ │ │ -00036940: 2220 7468 6520 6e61 6d65 7320 6f66 2074 " the names of t │ │ │ │ │ -00036950: 6865 206f 626a 6563 7420 6669 6c65 730a he object files. │ │ │ │ │ -00036960: 2020 2020 2061 6e64 206c 6962 7261 7269 and librari │ │ │ │ │ -00036970: 6573 2074 6f20 6c69 6e6b 2069 6e2e 2020 es to link in. │ │ │ │ │ -00036980: 5468 6973 2076 6172 6961 626c 6520 6973 This variable is │ │ │ │ │ -00036990: 206e 6f74 2075 7365 6420 7768 656e 2074 not used when t │ │ │ │ │ -000369a0: 6865 0a20 2020 2020 6c69 6e6b 6572 2069 he. linker i │ │ │ │ │ -000369b0: 7320 6f76 6572 7269 6464 656e 2077 6974 s overridden wit │ │ │ │ │ -000369c0: 6820 6120 7065 722d 7461 7267 6574 2027 h a per-target ' │ │ │ │ │ -000369d0: 5f4c 494e 4b27 2076 6172 6961 626c 6520 _LINK' variable │ │ │ │ │ -000369e0: 6f72 0a20 2020 2020 7065 722d 7461 7267 or. per-targ │ │ │ │ │ -000369f0: 6574 2066 6c61 6773 2063 6175 7365 2041 et flags cause A │ │ │ │ │ -00036a00: 7574 6f6d 616b 6520 746f 2064 6566 696e utomake to defin │ │ │ │ │ -00036a10: 6520 7375 6368 2061 2027 5f4c 494e 4b27 e such a '_LINK' │ │ │ │ │ -00036a20: 2076 6172 6961 626c 652e 0a0a 1f0a 4669 variable.....Fi │ │ │ │ │ -00036a30: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ -00036a40: 312e 696e 666f 2c20 204e 6f64 653a 2059 1.info, Node: Y │ │ │ │ │ -00036a50: 6163 6320 616e 6420 4c65 782c 2020 4e65 acc and Lex, Ne │ │ │ │ │ -00036a60: 7874 3a20 432b 2b20 5375 7070 6f72 742c xt: C++ Support, │ │ │ │ │ -00036a70: 2020 5072 6576 3a20 5072 6f67 7261 6d20 Prev: Program │ │ │ │ │ -00036a80: 5661 7269 6162 6c65 732c 2020 5570 3a20 Variables, Up: │ │ │ │ │ -00036a90: 5072 6f67 7261 6d73 0a0a 382e 3820 5961 Programs..8.8 Ya │ │ │ │ │ -00036aa0: 6363 2061 6e64 204c 6578 2073 7570 706f cc and Lex suppo │ │ │ │ │ -00036ab0: 7274 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d rt.============= │ │ │ │ │ -00036ac0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 ===========..Aut │ │ │ │ │ -00036ad0: 6f6d 616b 6520 6861 7320 736f 6d65 7768 omake has somewh │ │ │ │ │ -00036ae0: 6174 2069 6469 6f73 796e 6372 6174 6963 at idiosyncratic │ │ │ │ │ -00036af0: 2073 7570 706f 7274 2066 6f72 2059 6163 support for Yac │ │ │ │ │ -00036b00: 6320 616e 6420 4c65 782e 0a0a 2020 2041 c and Lex... A │ │ │ │ │ -00036b10: 7574 6f6d 616b 6520 6173 7375 6d65 7320 utomake assumes │ │ │ │ │ -00036b20: 7468 6174 2074 6865 2027 2e63 2720 6669 that the '.c' fi │ │ │ │ │ -00036b30: 6c65 2067 656e 6572 6174 6564 2062 7920 le generated by │ │ │ │ │ -00036b40: 2779 6163 6327 2028 6f72 2027 6c65 7827 'yacc' (or 'lex' │ │ │ │ │ -00036b50: 290a 7368 6f75 6c64 2062 6520 6e61 6d65 ).should be name │ │ │ │ │ -00036b60: 6420 7573 696e 6720 7468 6520 6261 7365 d using the base │ │ │ │ │ -00036b70: 6e61 6d65 206f 6620 7468 6520 696e 7075 name of the inpu │ │ │ │ │ -00036b80: 7420 6669 6c65 2e20 2054 6861 7420 6973 t file. That is │ │ │ │ │ -00036b90: 2c20 666f 7220 610a 7961 6363 2073 6f75 , for a.yacc sou │ │ │ │ │ -00036ba0: 7263 6520 6669 6c65 2027 666f 6f2e 7927 rce file 'foo.y' │ │ │ │ │ -00036bb0: 2c20 4175 746f 6d61 6b65 2077 696c 6c20 , Automake will │ │ │ │ │ -00036bc0: 6361 7573 6520 7468 6520 696e 7465 726d cause the interm │ │ │ │ │ -00036bd0: 6564 6961 7465 2066 696c 6520 746f 0a62 ediate file to.b │ │ │ │ │ -00036be0: 6520 6e61 6d65 6420 2766 6f6f 2e63 2720 e named 'foo.c' │ │ │ │ │ -00036bf0: 2861 7320 6f70 706f 7365 6420 746f 2027 (as opposed to ' │ │ │ │ │ -00036c00: 792e 7461 622e 6327 2c20 7768 6963 6820 y.tab.c', which │ │ │ │ │ -00036c10: 6973 206d 6f72 6520 7472 6164 6974 696f is more traditio │ │ │ │ │ -00036c20: 6e61 6c29 2e0a 0a20 2020 5468 6520 6578 nal)... The ex │ │ │ │ │ -00036c30: 7465 6e73 696f 6e20 6f66 2061 2079 6163 tension of a yac │ │ │ │ │ -00036c40: 6320 736f 7572 6365 2066 696c 6520 6973 c source file is │ │ │ │ │ -00036c50: 2075 7365 6420 746f 2064 6574 6572 6d69 used to determi │ │ │ │ │ -00036c60: 6e65 2074 6865 0a65 7874 656e 7369 6f6e ne the.extension │ │ │ │ │ -00036c70: 206f 6620 7468 6520 7265 7375 6c74 696e of the resultin │ │ │ │ │ -00036c80: 6720 4320 6f72 2043 2b2b 2066 696c 652e g C or C++ file. │ │ │ │ │ -00036c90: 2020 4669 6c65 7320 7769 7468 2074 6865 Files with the │ │ │ │ │ -00036ca0: 2065 7874 656e 7369 6f6e 2027 2e79 270a extension '.y'. │ │ │ │ │ -00036cb0: 7769 6c6c 2062 6520 7475 726e 6564 2069 will be turned i │ │ │ │ │ -00036cc0: 6e74 6f20 272e 6327 2066 696c 6573 3b20 nto '.c' files; │ │ │ │ │ -00036cd0: 6c69 6b65 7769 7365 2c20 272e 7979 2720 likewise, '.yy' │ │ │ │ │ -00036ce0: 7769 6c6c 2062 6563 6f6d 6520 272e 6363 will become '.cc │ │ │ │ │ -00036cf0: 273b 0a27 2e79 2b2b 272c 2027 632b 2b27 ';.'.y++', 'c++' │ │ │ │ │ -00036d00: 3b20 272e 7978 7827 2c20 272e 6378 7827 ; '.yxx', '.cxx' │ │ │ │ │ -00036d10: 3b20 616e 6420 272e 7970 7027 2c20 272e ; and '.ypp', '. │ │ │ │ │ -00036d20: 6370 7027 2e0a 0a20 2020 4c69 6b65 7769 cpp'... Likewi │ │ │ │ │ -00036d30: 7365 2c20 6c65 7820 736f 7572 6365 2066 se, lex source f │ │ │ │ │ -00036d40: 696c 6573 2063 616e 2062 6520 7573 6564 iles can be used │ │ │ │ │ -00036d50: 2074 6f20 6765 6e65 7261 7465 2043 206f to generate C o │ │ │ │ │ -00036d60: 7220 432b 2b3b 2074 6865 0a65 7874 656e r C++; the.exten │ │ │ │ │ -00036d70: 7369 6f6e 7320 272e 6c27 2c20 272e 6c6c sions '.l', '.ll │ │ │ │ │ -00036d80: 272c 2027 2e6c 2b2b 272c 2027 2e6c 7878 ', '.l++', '.lxx │ │ │ │ │ -00036d90: 272c 2061 6e64 2027 2e6c 7070 2720 6172 ', and '.lpp' ar │ │ │ │ │ -00036da0: 6520 7265 636f 676e 697a 6564 2e0a 0a20 e recognized... │ │ │ │ │ -00036db0: 2020 596f 7520 7368 6f75 6c64 206e 6576 You should nev │ │ │ │ │ -00036dc0: 6572 2065 7870 6c69 6369 746c 7920 6d65 er explicitly me │ │ │ │ │ -00036dd0: 6e74 696f 6e20 7468 6520 696e 7465 726d ntion the interm │ │ │ │ │ -00036de0: 6564 6961 7465 2028 4320 6f72 2043 2b2b ediate (C or C++ │ │ │ │ │ -00036df0: 2920 6669 6c65 0a69 6e20 616e 7920 2753 ) file.in any 'S │ │ │ │ │ -00036e00: 4f55 5243 4553 2720 7661 7269 6162 6c65 OURCES' variable │ │ │ │ │ -00036e10: 3b20 6f6e 6c79 206c 6973 7420 7468 6520 ; only list the │ │ │ │ │ -00036e20: 736f 7572 6365 2066 696c 652e 0a0a 2020 source file... │ │ │ │ │ -00036e30: 2054 6865 2069 6e74 6572 6d65 6469 6174 The intermediat │ │ │ │ │ -00036e40: 6520 6669 6c65 7320 6765 6e65 7261 7465 e files generate │ │ │ │ │ -00036e50: 6420 6279 2027 7961 6363 2720 286f 7220 d by 'yacc' (or │ │ │ │ │ -00036e60: 276c 6578 2729 2077 696c 6c20 6265 0a69 'lex') will be.i │ │ │ │ │ -00036e70: 6e63 6c75 6465 6420 696e 2061 6e79 2064 ncluded in any d │ │ │ │ │ -00036e80: 6973 7472 6962 7574 696f 6e20 7468 6174 istribution that │ │ │ │ │ -00036e90: 2069 7320 6d61 6465 2e20 2054 6861 7420 is made. That │ │ │ │ │ -00036ea0: 7761 7920 7468 6520 7573 6572 2064 6f65 way the user doe │ │ │ │ │ -00036eb0: 736e 2774 0a6e 6565 6420 746f 2068 6176 sn't.need to hav │ │ │ │ │ -00036ec0: 6520 2779 6163 6327 206f 7220 276c 6578 e 'yacc' or 'lex │ │ │ │ │ -00036ed0: 272e 0a0a 2020 2049 6620 6120 2779 6163 '... If a 'yac │ │ │ │ │ -00036ee0: 6327 2073 6f75 7263 6520 6669 6c65 2069 c' source file i │ │ │ │ │ -00036ef0: 7320 7365 656e 2c20 7468 656e 2079 6f75 s seen, then you │ │ │ │ │ -00036f00: 7220 2763 6f6e 6669 6775 7265 2e61 6327 r 'configure.ac' │ │ │ │ │ -00036f10: 206d 7573 7420 6465 6669 6e65 0a74 6865 must define.the │ │ │ │ │ -00036f20: 2076 6172 6961 626c 6520 2759 4143 4327 variable 'YACC' │ │ │ │ │ -00036f30: 2e20 2054 6869 7320 6973 206d 6f73 7420 . This is most │ │ │ │ │ -00036f40: 6561 7369 6c79 2064 6f6e 6520 6279 2069 easily done by i │ │ │ │ │ -00036f50: 6e76 6f6b 696e 6720 7468 6520 6d61 6372 nvoking the macr │ │ │ │ │ -00036f60: 6f0a 2741 435f 5052 4f47 5f59 4143 4327 o.'AC_PROG_YACC' │ │ │ │ │ -00036f70: 2028 2a6e 6f74 6520 5061 7274 6963 756c (*note Particul │ │ │ │ │ -00036f80: 6172 2050 726f 6772 616d 2043 6865 636b ar Program Check │ │ │ │ │ -00036f90: 733a 2028 6175 746f 636f 6e66 2950 6172 s: (autoconf)Par │ │ │ │ │ -00036fa0: 7469 6375 6c61 720a 5072 6f67 7261 6d73 ticular.Programs │ │ │ │ │ -00036fb0: 2e29 2e0a 0a20 2020 5768 656e 2027 7961 .)... When 'ya │ │ │ │ │ -00036fc0: 6363 2720 6973 2069 6e76 6f6b 6564 2c20 cc' is invoked, │ │ │ │ │ -00036fd0: 6974 2069 7320 7061 7373 6564 2027 414d it is passed 'AM │ │ │ │ │ -00036fe0: 5f59 464c 4147 5327 2061 6e64 2027 5946 _YFLAGS' and 'YF │ │ │ │ │ -00036ff0: 4c41 4753 272e 2020 5468 650a 6c61 7474 LAGS'. The.latt │ │ │ │ │ -00037000: 6572 2069 7320 6120 7573 6572 2076 6172 er is a user var │ │ │ │ │ -00037010: 6961 626c 6520 616e 6420 7468 6520 666f iable and the fo │ │ │ │ │ -00037020: 726d 6572 2069 7320 696e 7465 6e64 6564 rmer is intended │ │ │ │ │ -00037030: 2066 6f72 2074 6865 0a27 4d61 6b65 6669 for the.'Makefi │ │ │ │ │ -00037040: 6c65 2e61 6d27 2061 7574 686f 722e 0a0a le.am' author... │ │ │ │ │ -00037050: 2020 2027 414d 5f59 464c 4147 5327 2069 'AM_YFLAGS' i │ │ │ │ │ -00037060: 7320 7573 7561 6c6c 7920 7573 6564 2074 s usually used t │ │ │ │ │ -00037070: 6f20 7061 7373 2074 6865 2027 2d64 2720 o pass the '-d' │ │ │ │ │ -00037080: 6f70 7469 6f6e 2074 6f20 2779 6163 6327 option to 'yacc' │ │ │ │ │ -00037090: 2e0a 4175 746f 6d61 6b65 206b 6e6f 7773 ..Automake knows │ │ │ │ │ -000370a0: 2077 6861 7420 7468 6973 206d 6561 6e73 what this means │ │ │ │ │ -000370b0: 2061 6e64 2077 696c 6c20 6175 746f 6d61 and will automa │ │ │ │ │ -000370c0: 7469 6361 6c6c 7920 6164 6a75 7374 2069 tically adjust i │ │ │ │ │ -000370d0: 7473 2072 756c 6573 0a74 6f20 7570 6461 ts rules.to upda │ │ │ │ │ -000370e0: 7465 2061 6e64 2064 6973 7472 6962 7574 te and distribut │ │ │ │ │ -000370f0: 6520 7468 6520 6865 6164 6572 2066 696c e the header fil │ │ │ │ │ -00037100: 6520 6275 696c 7420 6279 2027 7961 6363 e built by 'yacc │ │ │ │ │ -00037110: 202d 6427 2831 292e 2020 5768 6174 0a41 -d'(1). What.A │ │ │ │ │ -00037120: 7574 6f6d 616b 6520 6361 6e6e 6f74 2067 utomake cannot g │ │ │ │ │ -00037130: 7565 7373 2c20 7468 6f75 6768 2c20 6973 uess, though, is │ │ │ │ │ -00037140: 2077 6865 7265 2074 6869 7320 6865 6164 where this head │ │ │ │ │ -00037150: 6572 2077 696c 6c20 6265 2075 7365 643a er will be used: │ │ │ │ │ -00037160: 2069 7420 6973 0a75 7020 746f 2079 6f75 it is.up to you │ │ │ │ │ -00037170: 2074 6f20 656e 7375 7265 2074 6865 2068 to ensure the h │ │ │ │ │ -00037180: 6561 6465 7220 6765 7473 2062 7569 6c74 eader gets built │ │ │ │ │ -00037190: 2062 6566 6f72 6520 6974 2069 7320 6669 before it is fi │ │ │ │ │ -000371a0: 7273 7420 7573 6564 2e0a 5479 7069 6361 rst used..Typica │ │ │ │ │ -000371b0: 6c6c 7920 7468 6973 2069 7320 6e65 6365 lly this is nece │ │ │ │ │ -000371c0: 7373 6172 7920 696e 206f 7264 6572 2066 ssary in order f │ │ │ │ │ -000371d0: 6f72 2064 6570 656e 6465 6e63 7920 7472 or dependency tr │ │ │ │ │ -000371e0: 6163 6b69 6e67 2074 6f20 776f 726b 0a77 acking to work.w │ │ │ │ │ -000371f0: 6865 6e20 7468 6520 6865 6164 6572 2069 hen the header i │ │ │ │ │ -00037200: 7320 696e 636c 7564 6564 2062 7920 616e s included by an │ │ │ │ │ -00037210: 6f74 6865 7220 6669 6c65 2e20 2054 6865 other file. The │ │ │ │ │ -00037220: 2063 6f6d 6d6f 6e20 736f 6c75 7469 6f6e common solution │ │ │ │ │ -00037230: 2069 730a 6c69 7374 696e 6720 7468 6520 is.listing the │ │ │ │ │ -00037240: 6865 6164 6572 2066 696c 6520 696e 2027 header file in ' │ │ │ │ │ -00037250: 4255 494c 545f 534f 5552 4345 5327 2028 BUILT_SOURCES' ( │ │ │ │ │ -00037260: 2a6e 6f74 6520 536f 7572 6365 733a 3a29 *note Sources::) │ │ │ │ │ -00037270: 2061 7320 666f 6c6c 6f77 732e 0a0a 2020 as follows... │ │ │ │ │ -00037280: 2020 2042 5549 4c54 5f53 4f55 5243 4553 BUILT_SOURCES │ │ │ │ │ -00037290: 203d 2070 6172 7365 722e 680a 2020 2020 = parser.h. │ │ │ │ │ -000372a0: 2041 4d5f 5946 4c41 4753 203d 202d 640a AM_YFLAGS = -d. │ │ │ │ │ -000372b0: 2020 2020 2062 696e 5f50 524f 4752 414d bin_PROGRAM │ │ │ │ │ -000372c0: 5320 3d20 666f 6f0a 2020 2020 2066 6f6f S = foo. foo │ │ │ │ │ -000372d0: 5f53 4f55 5243 4553 203d 202e 2e2e 2070 _SOURCES = ... p │ │ │ │ │ -000372e0: 6172 7365 722e 7920 2e2e 2e0a 0a20 2020 arser.y ..... │ │ │ │ │ -000372f0: 4966 2061 2027 6c65 7827 2073 6f75 7263 If a 'lex' sourc │ │ │ │ │ -00037300: 6520 6669 6c65 2069 7320 7365 656e 2c20 e file is seen, │ │ │ │ │ -00037310: 7468 656e 2079 6f75 7220 2763 6f6e 6669 then your 'confi │ │ │ │ │ -00037320: 6775 7265 2e61 6327 206d 7573 7420 6465 gure.ac' must de │ │ │ │ │ -00037330: 6669 6e65 0a74 6865 2076 6172 6961 626c fine.the variabl │ │ │ │ │ -00037340: 6520 274c 4558 272e 2020 596f 7520 6361 e 'LEX'. You ca │ │ │ │ │ -00037350: 6e20 7573 6520 2741 435f 5052 4f47 5f4c n use 'AC_PROG_L │ │ │ │ │ -00037360: 4558 2720 746f 2064 6f20 7468 6973 2028 EX' to do this ( │ │ │ │ │ -00037370: 2a6e 6f74 650a 5061 7274 6963 756c 6172 *note.Particular │ │ │ │ │ -00037380: 2050 726f 6772 616d 2043 6865 636b 733a Program Checks: │ │ │ │ │ -00037390: 2028 6175 746f 636f 6e66 2950 6172 7469 (autoconf)Parti │ │ │ │ │ -000373a0: 6375 6c61 7220 5072 6f67 7261 6d73 2e29 cular Programs.) │ │ │ │ │ -000373b0: 2c20 6275 7420 7573 696e 670a 2741 4d5f , but using.'AM_ │ │ │ │ │ -000373c0: 5052 4f47 5f4c 4558 2720 6d61 6372 6f20 PROG_LEX' macro │ │ │ │ │ -000373d0: 282a 6e6f 7465 204d 6163 726f 733a 3a29 (*note Macros::) │ │ │ │ │ -000373e0: 2069 7320 7265 636f 6d6d 656e 6465 642e is recommended. │ │ │ │ │ -000373f0: 0a0a 2020 2057 6865 6e20 276c 6578 2720 .. When 'lex' │ │ │ │ │ -00037400: 6973 2069 6e76 6f6b 6564 2c20 6974 2069 is invoked, it i │ │ │ │ │ -00037410: 7320 7061 7373 6564 2027 414d 5f4c 464c s passed 'AM_LFL │ │ │ │ │ -00037420: 4147 5327 2061 6e64 2027 4c46 4c41 4753 AGS' and 'LFLAGS │ │ │ │ │ -00037430: 272e 2020 5468 650a 6c61 7474 6572 2069 '. The.latter i │ │ │ │ │ -00037440: 7320 6120 7573 6572 2076 6172 6961 626c s a user variabl │ │ │ │ │ -00037450: 6520 616e 6420 7468 6520 666f 726d 6572 e and the former │ │ │ │ │ -00037460: 2069 7320 696e 7465 6e64 6564 2066 6f72 is intended for │ │ │ │ │ -00037470: 2074 6865 0a27 4d61 6b65 6669 6c65 2e61 the.'Makefile.a │ │ │ │ │ -00037480: 6d27 2061 7574 686f 722e 0a0a 2020 2057 m' author... W │ │ │ │ │ -00037490: 6865 6e20 2741 4d5f 4d41 494e 5441 494e hen 'AM_MAINTAIN │ │ │ │ │ -000374a0: 4552 5f4d 4f44 4527 2028 2a6e 6f74 6520 ER_MODE' (*note │ │ │ │ │ -000374b0: 6d61 696e 7461 696e 6572 2d6d 6f64 653a maintainer-mode: │ │ │ │ │ -000374c0: 3a29 2069 7320 7573 6564 2c20 7468 650a :) is used, the. │ │ │ │ │ -000374d0: 7265 6275 696c 6420 7275 6c65 2066 6f72 rebuild rule for │ │ │ │ │ -000374e0: 2064 6973 7472 6962 7574 6564 2059 6163 distributed Yac │ │ │ │ │ -000374f0: 6320 616e 6420 4c65 7820 736f 7572 6365 c and Lex source │ │ │ │ │ -00037500: 7320 6172 6520 6f6e 6c79 2075 7365 6420 s are only used │ │ │ │ │ -00037510: 7768 656e 0a27 6d61 696e 7461 696e 6572 when.'maintainer │ │ │ │ │ -00037520: 2d6d 6f64 6527 2069 7320 656e 6162 6c65 -mode' is enable │ │ │ │ │ -00037530: 642c 206f 7220 7768 656e 2074 6865 2066 d, or when the f │ │ │ │ │ -00037540: 696c 6573 2068 6176 6520 6265 656e 2065 iles have been e │ │ │ │ │ -00037550: 7261 7365 642e 0a0a 2020 2057 6865 6e20 rased... When │ │ │ │ │ -00037560: 276c 6578 2720 6f72 2027 7961 6363 2720 'lex' or 'yacc' │ │ │ │ │ -00037570: 736f 7572 6365 7320 6172 6520 7573 6564 sources are used │ │ │ │ │ -00037580: 2c20 2761 7574 6f6d 616b 6520 2d69 2720 , 'automake -i' │ │ │ │ │ -00037590: 6175 746f 6d61 7469 6361 6c6c 790a 696e automatically.in │ │ │ │ │ -000375a0: 7374 616c 6c73 2061 6e20 6175 7869 6c69 stalls an auxili │ │ │ │ │ -000375b0: 6172 7920 7072 6f67 7261 6d20 6361 6c6c ary program call │ │ │ │ │ -000375c0: 6564 2027 796c 7772 6170 2720 696e 2079 ed 'ylwrap' in y │ │ │ │ │ -000375d0: 6f75 7220 7061 636b 6167 6520 282a 6e6f our package (*no │ │ │ │ │ -000375e0: 7465 0a41 7578 696c 6961 7279 2050 726f te.Auxiliary Pro │ │ │ │ │ -000375f0: 6772 616d 733a 3a29 2e20 2054 6869 7320 grams::). This │ │ │ │ │ -00037600: 7072 6f67 7261 6d20 6973 2075 7365 6420 program is used │ │ │ │ │ -00037610: 6279 2074 6865 2062 7569 6c64 2072 756c by the build rul │ │ │ │ │ -00037620: 6573 2074 6f0a 7265 6e61 6d65 2074 6865 es to.rename the │ │ │ │ │ -00037630: 206f 7574 7075 7420 6f66 2074 6865 7365 output of these │ │ │ │ │ -00037640: 2074 6f6f 6c73 2c20 616e 6420 6d61 6b65 tools, and make │ │ │ │ │ -00037650: 7320 6974 2070 6f73 7369 626c 6520 746f s it possible to │ │ │ │ │ -00037660: 2069 6e63 6c75 6465 0a6d 756c 7469 706c include.multipl │ │ │ │ │ -00037670: 6520 2779 6163 6327 2028 6f72 2027 6c65 e 'yacc' (or 'le │ │ │ │ │ -00037680: 7827 2920 736f 7572 6365 2066 696c 6573 x') source files │ │ │ │ │ -00037690: 2069 6e20 6120 7369 6e67 6c65 2064 6972 in a single dir │ │ │ │ │ -000376a0: 6563 746f 7279 2e20 2028 5468 6973 2069 ectory. (This i │ │ │ │ │ -000376b0: 730a 6e65 6365 7373 6172 7920 6265 6361 s.necessary beca │ │ │ │ │ -000376c0: 7573 6520 7961 6363 2773 206f 7574 7075 use yacc's outpu │ │ │ │ │ -000376d0: 7420 6669 6c65 206e 616d 6520 6973 2066 t file name is f │ │ │ │ │ -000376e0: 6978 6564 2c20 616e 6420 6120 7061 7261 ixed, and a para │ │ │ │ │ -000376f0: 6c6c 656c 206d 616b 650a 636f 756c 6420 llel make.could │ │ │ │ │ -00037700: 636f 6e63 6569 7661 626c 7920 696e 766f conceivably invo │ │ │ │ │ -00037710: 6b65 206d 6f72 6520 7468 616e 206f 6e65 ke more than one │ │ │ │ │ -00037720: 2069 6e73 7461 6e63 6520 6f66 2027 7961 instance of 'ya │ │ │ │ │ -00037730: 6363 270a 7369 6d75 6c74 616e 656f 7573 cc'.simultaneous │ │ │ │ │ -00037740: 6c79 2e29 0a0a 2020 2046 6f72 2027 7961 ly.).. For 'ya │ │ │ │ │ -00037750: 6363 272c 2073 696d 706c 7920 6d61 6e61 cc', simply mana │ │ │ │ │ -00037760: 6769 6e67 206c 6f63 6b69 6e67 2069 7320 ging locking is │ │ │ │ │ -00037770: 696e 7375 6666 6963 6965 6e74 2e20 2054 insufficient. T │ │ │ │ │ -00037780: 6865 206f 7574 7075 7420 6f66 0a27 7961 he output of.'ya │ │ │ │ │ -00037790: 6363 2720 616c 7761 7973 2075 7365 7320 cc' always uses │ │ │ │ │ -000377a0: 7468 6520 7361 6d65 2073 796d 626f 6c20 the same symbol │ │ │ │ │ -000377b0: 6e61 6d65 7320 696e 7465 726e 616c 6c79 names internally │ │ │ │ │ -000377c0: 2c20 736f 2069 7420 6973 6e27 740a 706f , so it isn't.po │ │ │ │ │ -000377d0: 7373 6962 6c65 2074 6f20 6c69 6e6b 2074 ssible to link t │ │ │ │ │ -000377e0: 776f 2027 7961 6363 2720 7061 7273 6572 wo 'yacc' parser │ │ │ │ │ -000377f0: 7320 696e 746f 2074 6865 2073 616d 6520 s into the same │ │ │ │ │ -00037800: 6578 6563 7574 6162 6c65 2e0a 0a20 2020 executable... │ │ │ │ │ -00037810: 5765 2072 6563 6f6d 6d65 6e64 2075 7369 We recommend usi │ │ │ │ │ -00037820: 6e67 2074 6865 2066 6f6c 6c6f 7769 6e67 ng the following │ │ │ │ │ -00037830: 2072 656e 616d 696e 6720 6861 636b 2075 renaming hack u │ │ │ │ │ -00037840: 7365 6420 696e 2027 6764 6227 3a0a 2020 sed in 'gdb':. │ │ │ │ │ -00037850: 2020 2023 6465 6669 6e65 2079 796d 6178 #define yymax │ │ │ │ │ -00037860: 6465 7074 6820 635f 6d61 7864 6570 7468 depth c_maxdepth │ │ │ │ │ -00037870: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ -00037880: 7061 7273 6520 635f 7061 7273 650a 2020 parse c_parse. │ │ │ │ │ -00037890: 2020 2023 6465 6669 6e65 2079 796c 6578 #define yylex │ │ │ │ │ -000378a0: 2020 2063 5f6c 6578 0a20 2020 2020 2364 c_lex. #d │ │ │ │ │ -000378b0: 6566 696e 6520 7979 6572 726f 7220 635f efine yyerror c_ │ │ │ │ │ -000378c0: 6572 726f 720a 2020 2020 2023 6465 6669 error. #defi │ │ │ │ │ -000378d0: 6e65 2079 796c 7661 6c20 2063 5f6c 7661 ne yylval c_lva │ │ │ │ │ -000378e0: 6c0a 2020 2020 2023 6465 6669 6e65 2079 l. #define y │ │ │ │ │ -000378f0: 7963 6861 7220 2063 5f63 6861 720a 2020 ychar c_char. │ │ │ │ │ -00037900: 2020 2023 6465 6669 6e65 2079 7964 6562 #define yydeb │ │ │ │ │ -00037910: 7567 2063 5f64 6562 7567 0a20 2020 2020 ug c_debug. │ │ │ │ │ -00037920: 2364 6566 696e 6520 7979 7061 6374 2020 #define yypact │ │ │ │ │ -00037930: 635f 7061 6374 0a20 2020 2020 2364 6566 c_pact. #def │ │ │ │ │ -00037940: 696e 6520 7979 7231 2020 2020 635f 7231 ine yyr1 c_r1 │ │ │ │ │ -00037950: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ -00037960: 7232 2020 2020 635f 7232 0a20 2020 2020 r2 c_r2. │ │ │ │ │ -00037970: 2364 6566 696e 6520 7979 6465 6620 2020 #define yydef │ │ │ │ │ -00037980: 635f 6465 660a 2020 2020 2023 6465 6669 c_def. #defi │ │ │ │ │ -00037990: 6e65 2079 7963 686b 2020 2063 5f63 686b ne yychk c_chk │ │ │ │ │ -000379a0: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ -000379b0: 7067 6f20 2020 635f 7067 6f0a 2020 2020 pgo c_pgo. │ │ │ │ │ -000379c0: 2023 6465 6669 6e65 2079 7961 6374 2020 #define yyact │ │ │ │ │ -000379d0: 2063 5f61 6374 0a20 2020 2020 2364 6566 c_act. #def │ │ │ │ │ -000379e0: 696e 6520 7979 6578 6361 2020 635f 6578 ine yyexca c_ex │ │ │ │ │ -000379f0: 6361 0a20 2020 2020 2364 6566 696e 6520 ca. #define │ │ │ │ │ -00037a00: 7979 6572 7266 6c61 6720 635f 6572 7266 yyerrflag c_errf │ │ │ │ │ -00037a10: 6c61 670a 2020 2020 2023 6465 6669 6e65 lag. #define │ │ │ │ │ -00037a20: 2079 796e 6572 7273 2063 5f6e 6572 7273 yynerrs c_nerrs │ │ │ │ │ -00037a30: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ -00037a40: 7073 2020 2020 635f 7073 0a20 2020 2020 ps c_ps. │ │ │ │ │ -00037a50: 2364 6566 696e 6520 7979 7076 2020 2020 #define yypv │ │ │ │ │ -00037a60: 635f 7076 0a20 2020 2020 2364 6566 696e c_pv. #defin │ │ │ │ │ -00037a70: 6520 7979 7320 2020 2020 635f 730a 2020 e yys c_s. │ │ │ │ │ -00037a80: 2020 2023 6465 6669 6e65 2079 795f 7979 #define yy_yy │ │ │ │ │ -00037a90: 7320 2063 5f79 7973 0a20 2020 2020 2364 s c_yys. #d │ │ │ │ │ -00037aa0: 6566 696e 6520 7979 7374 6174 6520 635f efine yystate c_ │ │ │ │ │ -00037ab0: 7374 6174 650a 2020 2020 2023 6465 6669 state. #defi │ │ │ │ │ -00037ac0: 6e65 2079 7974 6d70 2020 2063 5f74 6d70 ne yytmp c_tmp │ │ │ │ │ -00037ad0: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ -00037ae0: 7620 2020 2020 635f 760a 2020 2020 2023 v c_v. # │ │ │ │ │ -00037af0: 6465 6669 6e65 2079 795f 7979 7620 2063 define yy_yyv c │ │ │ │ │ -00037b00: 5f79 7976 0a20 2020 2020 2364 6566 696e _yyv. #defin │ │ │ │ │ -00037b10: 6520 7979 7661 6c20 2020 635f 7661 6c0a e yyval c_val. │ │ │ │ │ -00037b20: 2020 2020 2023 6465 6669 6e65 2079 796c #define yyl │ │ │ │ │ -00037b30: 6c6f 6320 2063 5f6c 6c6f 630a 2020 2020 loc c_lloc. │ │ │ │ │ -00037b40: 2023 6465 6669 6e65 2079 7972 6564 7320 #define yyreds │ │ │ │ │ -00037b50: 2063 5f72 6564 730a 2020 2020 2023 6465 c_reds. #de │ │ │ │ │ -00037b60: 6669 6e65 2079 7974 6f6b 7320 2063 5f74 fine yytoks c_t │ │ │ │ │ -00037b70: 6f6b 730a 2020 2020 2023 6465 6669 6e65 oks. #define │ │ │ │ │ -00037b80: 2079 796c 6873 2020 2063 5f79 796c 6873 yylhs c_yylhs │ │ │ │ │ -00037b90: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ -00037ba0: 6c65 6e20 2020 635f 7979 6c65 6e0a 2020 len c_yylen. │ │ │ │ │ -00037bb0: 2020 2023 6465 6669 6e65 2079 7964 6566 #define yydef │ │ │ │ │ -00037bc0: 7265 6420 635f 7979 6465 6672 6564 0a20 red c_yydefred. │ │ │ │ │ -00037bd0: 2020 2020 2364 6566 696e 6520 7979 6467 #define yydg │ │ │ │ │ -00037be0: 6f74 6f20 2063 5f79 7964 676f 746f 0a20 oto c_yydgoto. │ │ │ │ │ -00037bf0: 2020 2020 2364 6566 696e 6520 7979 7369 #define yysi │ │ │ │ │ -00037c00: 6e64 6578 2063 5f79 7973 696e 6465 780a ndex c_yysindex. │ │ │ │ │ -00037c10: 2020 2020 2023 6465 6669 6e65 2079 7972 #define yyr │ │ │ │ │ -00037c20: 696e 6465 7820 635f 7979 7269 6e64 6578 index c_yyrindex │ │ │ │ │ -00037c30: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ -00037c40: 6769 6e64 6578 2063 5f79 7967 696e 6465 gindex c_yyginde │ │ │ │ │ -00037c50: 780a 2020 2020 2023 6465 6669 6e65 2079 x. #define y │ │ │ │ │ -00037c60: 7974 6162 6c65 2020 635f 7979 7461 626c ytable c_yytabl │ │ │ │ │ -00037c70: 650a 2020 2020 2023 6465 6669 6e65 2079 e. #define y │ │ │ │ │ -00037c80: 7963 6865 636b 2020 635f 7979 6368 6563 ycheck c_yychec │ │ │ │ │ -00037c90: 6b0a 2020 2020 2023 6465 6669 6e65 2079 k. #define y │ │ │ │ │ -00037ca0: 796e 616d 6520 2020 635f 7979 6e61 6d65 yname c_yyname │ │ │ │ │ -00037cb0: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ -00037cc0: 7275 6c65 2020 2063 5f79 7972 756c 650a rule c_yyrule. │ │ │ │ │ -00037cd0: 0a20 2020 466f 7220 6561 6368 2064 6566 . For each def │ │ │ │ │ -00037ce0: 696e 652c 2072 6570 6c61 6365 2074 6865 ine, replace the │ │ │ │ │ -00037cf0: 2027 635f 2720 7072 6566 6978 2077 6974 'c_' prefix wit │ │ │ │ │ -00037d00: 6820 7768 6174 6576 6572 2079 6f75 206c h whatever you l │ │ │ │ │ -00037d10: 696b 652e 0a54 6865 7365 2064 6566 696e ike..These defin │ │ │ │ │ -00037d20: 6573 2077 6f72 6b20 666f 7220 2762 6973 es work for 'bis │ │ │ │ │ -00037d30: 6f6e 272c 2027 6279 6163 6327 2c20 616e on', 'byacc', an │ │ │ │ │ -00037d40: 6420 7472 6164 6974 696f 6e61 6c20 2779 d traditional 'y │ │ │ │ │ -00037d50: 6163 6327 732e 2020 4966 0a79 6f75 2066 acc's. If.you f │ │ │ │ │ -00037d60: 696e 6420 6120 7061 7273 6572 2067 656e ind a parser gen │ │ │ │ │ -00037d70: 6572 6174 6f72 2074 6861 7420 7573 6573 erator that uses │ │ │ │ │ -00037d80: 2061 2073 796d 626f 6c20 6e6f 7420 636f a symbol not co │ │ │ │ │ -00037d90: 7665 7265 6420 6865 7265 2c20 706c 6561 vered here, plea │ │ │ │ │ -00037da0: 7365 0a72 6570 6f72 7420 7468 6520 6e65 se.report the ne │ │ │ │ │ -00037db0: 7720 6e61 6d65 2073 6f20 6974 2063 616e w name so it can │ │ │ │ │ -00037dc0: 2062 6520 6164 6465 6420 746f 2074 6865 be added to the │ │ │ │ │ -00037dd0: 206c 6973 742e 0a0a 2020 202d 2d2d 2d2d list... ----- │ │ │ │ │ -00037de0: 2d2d 2d2d 2d20 466f 6f74 6e6f 7465 7320 ----- Footnotes │ │ │ │ │ -00037df0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 2028 ----------.. ( │ │ │ │ │ -00037e00: 3129 2050 6c65 6173 6520 6e6f 7465 2074 1) Please note t │ │ │ │ │ -00037e10: 6861 7420 2761 7574 6f6d 616b 6527 2072 hat 'automake' r │ │ │ │ │ -00037e20: 6563 6f67 6e69 7a65 7320 272d 6427 2069 ecognizes '-d' i │ │ │ │ │ -00037e30: 6e20 2741 4d5f 5946 4c41 4753 2720 6f6e n 'AM_YFLAGS' on │ │ │ │ │ -00037e40: 6c79 0a69 6620 6974 2069 7320 6e6f 7420 ly.if it is not │ │ │ │ │ -00037e50: 636c 7573 7465 7265 6420 7769 7468 206f clustered with o │ │ │ │ │ -00037e60: 7468 6572 206f 7074 696f 6e73 3b20 666f ther options; fo │ │ │ │ │ -00037e70: 7220 6578 616d 706c 652c 2069 7420 776f r example, it wo │ │ │ │ │ -00037e80: 6e27 7420 6265 0a72 6563 6f67 6e69 7a65 n't be.recognize │ │ │ │ │ -00037e90: 6420 6966 2027 414d 5f59 464c 4147 5327 d if 'AM_YFLAGS' │ │ │ │ │ -00037ea0: 2069 7320 272d 6474 272c 2062 7574 2069 is '-dt', but i │ │ │ │ │ -00037eb0: 7420 7769 6c6c 2062 6520 6966 2027 414d t will be if 'AM │ │ │ │ │ -00037ec0: 5f59 464c 4147 5327 2069 7320 272d 640a _YFLAGS' is '-d. │ │ │ │ │ -00037ed0: 2d74 2720 6f72 2027 2d64 202d 7427 0a0a -t' or '-d -t'.. │ │ │ │ │ -00037ee0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -00037ef0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -00037f00: 653a 2043 2b2b 2053 7570 706f 7274 2c20 e: C++ Support, │ │ │ │ │ -00037f10: 204e 6578 743a 204f 626a 6563 7469 7665 Next: Objective │ │ │ │ │ -00037f20: 2043 2053 7570 706f 7274 2c20 2050 7265 C Support, Pre │ │ │ │ │ -00037f30: 763a 2059 6163 6320 616e 6420 4c65 782c v: Yacc and Lex, │ │ │ │ │ -00037f40: 2020 5570 3a20 5072 6f67 7261 6d73 0a0a Up: Programs.. │ │ │ │ │ -00037f50: 382e 3920 432b 2b20 5375 7070 6f72 740a 8.9 C++ Support. │ │ │ │ │ -00037f60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -00037f70: 0a41 7574 6f6d 616b 6520 696e 636c 7564 .Automake includ │ │ │ │ │ -00037f80: 6573 2066 756c 6c20 7375 7070 6f72 7420 es full support │ │ │ │ │ -00037f90: 666f 7220 432b 2b2e 0a0a 2020 2041 6e79 for C++... Any │ │ │ │ │ -00037fa0: 2070 6163 6b61 6765 2069 6e63 6c75 6469 package includi │ │ │ │ │ -00037fb0: 6e67 2043 2b2b 2063 6f64 6520 6d75 7374 ng C++ code must │ │ │ │ │ -00037fc0: 2064 6566 696e 6520 7468 6520 6f75 7470 define the outp │ │ │ │ │ -00037fd0: 7574 2076 6172 6961 626c 6520 2743 5858 ut variable 'CXX │ │ │ │ │ -00037fe0: 270a 696e 2027 636f 6e66 6967 7572 652e '.in 'configure. │ │ │ │ │ -00037ff0: 6163 273b 2074 6865 2073 696d 706c 6573 ac'; the simples │ │ │ │ │ -00038000: 7420 7761 7920 746f 2064 6f20 7468 6973 t way to do this │ │ │ │ │ -00038010: 2069 7320 746f 2075 7365 2074 6865 0a27 is to use the.' │ │ │ │ │ -00038020: 4143 5f50 524f 475f 4358 5827 206d 6163 AC_PROG_CXX' mac │ │ │ │ │ -00038030: 726f 2028 2a6e 6f74 6520 5061 7274 6963 ro (*note Partic │ │ │ │ │ -00038040: 756c 6172 2050 726f 6772 616d 2043 6865 ular Program Che │ │ │ │ │ -00038050: 636b 733a 0a28 6175 746f 636f 6e66 2950 cks:.(autoconf)P │ │ │ │ │ -00038060: 6172 7469 6375 6c61 7220 5072 6f67 7261 articular Progra │ │ │ │ │ -00038070: 6d73 2e29 2e0a 0a20 2020 4120 6665 7720 ms.)... A few │ │ │ │ │ -00038080: 6164 6469 7469 6f6e 616c 2076 6172 6961 additional varia │ │ │ │ │ -00038090: 626c 6573 2061 7265 2064 6566 696e 6564 bles are defined │ │ │ │ │ -000380a0: 2077 6865 6e20 6120 432b 2b20 736f 7572 when a C++ sour │ │ │ │ │ -000380b0: 6365 2066 696c 6520 6973 0a73 6565 6e3a ce file is.seen: │ │ │ │ │ -000380c0: 0a0a 2743 5858 270a 2020 2020 2054 6865 ..'CXX'. The │ │ │ │ │ -000380d0: 206e 616d 6520 6f66 2074 6865 2043 2b2b name of the C++ │ │ │ │ │ -000380e0: 2063 6f6d 7069 6c65 722e 0a0a 2743 5858 compiler...'CXX │ │ │ │ │ -000380f0: 464c 4147 5327 0a20 2020 2020 416e 7920 FLAGS'. Any │ │ │ │ │ -00038100: 666c 6167 7320 746f 2070 6173 7320 746f flags to pass to │ │ │ │ │ -00038110: 2074 6865 2043 2b2b 2063 6f6d 7069 6c65 the C++ compile │ │ │ │ │ -00038120: 722e 0a0a 2741 4d5f 4358 5846 4c41 4753 r...'AM_CXXFLAGS │ │ │ │ │ -00038130: 270a 2020 2020 2054 6865 206d 6169 6e74 '. The maint │ │ │ │ │ -00038140: 6169 6e65 7227 7320 7661 7269 616e 7420 ainer's variant │ │ │ │ │ -00038150: 6f66 2027 4358 5846 4c41 4753 272e 0a0a of 'CXXFLAGS'... │ │ │ │ │ -00038160: 2743 5858 434f 4d50 494c 4527 0a20 2020 'CXXCOMPILE'. │ │ │ │ │ -00038170: 2020 5468 6520 636f 6d6d 616e 6420 7573 The command us │ │ │ │ │ -00038180: 6564 2074 6f20 6163 7475 616c 6c79 2063 ed to actually c │ │ │ │ │ -00038190: 6f6d 7069 6c65 2061 2043 2b2b 2073 6f75 ompile a C++ sou │ │ │ │ │ -000381a0: 7263 6520 6669 6c65 2e20 2054 6865 2066 rce file. The f │ │ │ │ │ -000381b0: 696c 650a 2020 2020 206e 616d 6520 6973 ile. name is │ │ │ │ │ -000381c0: 2061 7070 656e 6465 6420 746f 2066 6f72 appended to for │ │ │ │ │ -000381d0: 6d20 7468 6520 636f 6d70 6c65 7465 2063 m the complete c │ │ │ │ │ -000381e0: 6f6d 6d61 6e64 206c 696e 652e 0a0a 2743 ommand line...'C │ │ │ │ │ -000381f0: 5858 4c49 4e4b 270a 2020 2020 2054 6865 XXLINK'. The │ │ │ │ │ -00038200: 2063 6f6d 6d61 6e64 2075 7365 6420 746f command used to │ │ │ │ │ -00038210: 2061 6374 7561 6c6c 7920 6c69 6e6b 2061 actually link a │ │ │ │ │ -00038220: 2043 2b2b 2070 726f 6772 616d 2e0a 0a1f C++ program.... │ │ │ │ │ -00038230: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -00038240: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -00038250: 3a20 4f62 6a65 6374 6976 6520 4320 5375 : Objective C Su │ │ │ │ │ -00038260: 7070 6f72 742c 2020 4e65 7874 3a20 556e pport, Next: Un │ │ │ │ │ -00038270: 6966 6965 6420 5061 7261 6c6c 656c 2043 ified Parallel C │ │ │ │ │ -00038280: 2053 7570 706f 7274 2c20 2050 7265 763a Support, Prev: │ │ │ │ │ -00038290: 2043 2b2b 2053 7570 706f 7274 2c20 2055 C++ Support, U │ │ │ │ │ -000382a0: 703a 2050 726f 6772 616d 730a 0a38 2e31 p: Programs..8.1 │ │ │ │ │ -000382b0: 3020 4f62 6a65 6374 6976 6520 4320 5375 0 Objective C Su │ │ │ │ │ -000382c0: 7070 6f72 740a 3d3d 3d3d 3d3d 3d3d 3d3d pport.========== │ │ │ │ │ -000382d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -000382e0: 4175 746f 6d61 6b65 2069 6e63 6c75 6465 Automake include │ │ │ │ │ -000382f0: 7320 736f 6d65 2073 7570 706f 7274 2066 s some support f │ │ │ │ │ -00038300: 6f72 204f 626a 6563 7469 7665 2043 2e0a or Objective C.. │ │ │ │ │ -00038310: 0a20 2020 416e 7920 7061 636b 6167 6520 . Any package │ │ │ │ │ -00038320: 696e 636c 7564 696e 6720 4f62 6a65 6374 including Object │ │ │ │ │ -00038330: 6976 6520 4320 636f 6465 206d 7573 7420 ive C code must │ │ │ │ │ -00038340: 6465 6669 6e65 2074 6865 206f 7574 7075 define the outpu │ │ │ │ │ -00038350: 740a 7661 7269 6162 6c65 2027 4f42 4a43 t.variable 'OBJC │ │ │ │ │ -00038360: 2720 696e 2027 636f 6e66 6967 7572 652e ' in 'configure. │ │ │ │ │ -00038370: 6163 273b 2074 6865 2073 696d 706c 6573 ac'; the simples │ │ │ │ │ -00038380: 7420 7761 7920 746f 2064 6f20 7468 6973 t way to do this │ │ │ │ │ -00038390: 2069 7320 746f 2075 7365 0a74 6865 2027 is to use.the ' │ │ │ │ │ -000383a0: 4143 5f50 524f 475f 4f42 4a43 2720 6d61 AC_PROG_OBJC' ma │ │ │ │ │ -000383b0: 6372 6f20 282a 6e6f 7465 2050 6172 7469 cro (*note Parti │ │ │ │ │ -000383c0: 6375 6c61 7220 5072 6f67 7261 6d20 4368 cular Program Ch │ │ │ │ │ -000383d0: 6563 6b73 3a0a 2861 7574 6f63 6f6e 6629 ecks:.(autoconf) │ │ │ │ │ -000383e0: 5061 7274 6963 756c 6172 2050 726f 6772 Particular Progr │ │ │ │ │ -000383f0: 616d 732e 292e 0a0a 2020 2041 2066 6577 ams.)... A few │ │ │ │ │ -00038400: 2061 6464 6974 696f 6e61 6c20 7661 7269 additional vari │ │ │ │ │ -00038410: 6162 6c65 7320 6172 6520 6465 6669 6e65 ables are define │ │ │ │ │ -00038420: 6420 7768 656e 2061 6e20 4f62 6a65 6374 d when an Object │ │ │ │ │ -00038430: 6976 6520 4320 736f 7572 6365 0a66 696c ive C source.fil │ │ │ │ │ -00038440: 6520 6973 2073 6565 6e3a 0a0a 274f 424a e is seen:..'OBJ │ │ │ │ │ -00038450: 4327 0a20 2020 2020 5468 6520 6e61 6d65 C'. The name │ │ │ │ │ -00038460: 206f 6620 7468 6520 4f62 6a65 6374 6976 of the Objectiv │ │ │ │ │ -00038470: 6520 4320 636f 6d70 696c 6572 2e0a 0a27 e C compiler...' │ │ │ │ │ -00038480: 4f42 4a43 464c 4147 5327 0a20 2020 2020 OBJCFLAGS'. │ │ │ │ │ -00038490: 416e 7920 666c 6167 7320 746f 2070 6173 Any flags to pas │ │ │ │ │ -000384a0: 7320 746f 2074 6865 204f 626a 6563 7469 s to the Objecti │ │ │ │ │ -000384b0: 7665 2043 2063 6f6d 7069 6c65 722e 0a0a ve C compiler... │ │ │ │ │ -000384c0: 2741 4d5f 4f42 4a43 464c 4147 5327 0a20 'AM_OBJCFLAGS'. │ │ │ │ │ -000384d0: 2020 2020 5468 6520 6d61 696e 7461 696e The maintain │ │ │ │ │ -000384e0: 6572 2773 2076 6172 6961 6e74 206f 6620 er's variant of │ │ │ │ │ -000384f0: 274f 424a 4346 4c41 4753 272e 0a0a 274f 'OBJCFLAGS'...'O │ │ │ │ │ -00038500: 424a 4343 4f4d 5049 4c45 270a 2020 2020 BJCCOMPILE'. │ │ │ │ │ -00038510: 2054 6865 2063 6f6d 6d61 6e64 2075 7365 The command use │ │ │ │ │ -00038520: 6420 746f 2061 6374 7561 6c6c 7920 636f d to actually co │ │ │ │ │ -00038530: 6d70 696c 6520 616e 204f 626a 6563 7469 mpile an Objecti │ │ │ │ │ -00038540: 7665 2043 2073 6f75 7263 6520 6669 6c65 ve C source file │ │ │ │ │ -00038550: 2e0a 2020 2020 2054 6865 2066 696c 6520 .. The file │ │ │ │ │ -00038560: 6e61 6d65 2069 7320 6170 7065 6e64 6564 name is appended │ │ │ │ │ -00038570: 2074 6f20 666f 726d 2074 6865 2063 6f6d to form the com │ │ │ │ │ -00038580: 706c 6574 6520 636f 6d6d 616e 6420 6c69 plete command li │ │ │ │ │ -00038590: 6e65 2e0a 0a27 4f42 4a43 4c49 4e4b 270a ne...'OBJCLINK'. │ │ │ │ │ -000385a0: 2020 2020 2054 6865 2063 6f6d 6d61 6e64 The command │ │ │ │ │ -000385b0: 2075 7365 6420 746f 2061 6374 7561 6c6c used to actuall │ │ │ │ │ -000385c0: 7920 6c69 6e6b 2061 6e20 4f62 6a65 6374 y link an Object │ │ │ │ │ -000385d0: 6976 6520 4320 7072 6f67 7261 6d2e 0a0a ive C program... │ │ │ │ │ -000385e0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -000385f0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -00038600: 653a 2055 6e69 6669 6564 2050 6172 616c e: Unified Paral │ │ │ │ │ -00038610: 6c65 6c20 4320 5375 7070 6f72 742c 2020 lel C Support, │ │ │ │ │ -00038620: 4e65 7874 3a20 4173 7365 6d62 6c79 2053 Next: Assembly S │ │ │ │ │ -00038630: 7570 706f 7274 2c20 2050 7265 763a 204f upport, Prev: O │ │ │ │ │ -00038640: 626a 6563 7469 7665 2043 2053 7570 706f bjective C Suppo │ │ │ │ │ -00038650: 7274 2c20 2055 703a 2050 726f 6772 616d rt, Up: Program │ │ │ │ │ -00038660: 730a 0a38 2e31 3120 556e 6966 6965 6420 s..8.11 Unified │ │ │ │ │ -00038670: 5061 7261 6c6c 656c 2043 2053 7570 706f Parallel C Suppo │ │ │ │ │ -00038680: 7274 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d rt.============= │ │ │ │ │ +00035d60: 3d3d 0a0a 4f63 6361 7369 6f6e 616c 6c79 ==..Occasionally │ │ │ │ │ +00035d70: 2069 7420 6973 2075 7365 6675 6c20 746f it is useful to │ │ │ │ │ +00035d80: 206b 6e6f 7720 7768 6963 6820 274d 616b know which 'Mak │ │ │ │ │ +00035d90: 6566 696c 6527 2076 6172 6961 626c 6573 efile' variables │ │ │ │ │ +00035da0: 2041 7574 6f6d 616b 650a 7573 6573 2066 Automake.uses f │ │ │ │ │ +00035db0: 6f72 2063 6f6d 7069 6c61 7469 6f6e 732c or compilations, │ │ │ │ │ +00035dc0: 2061 6e64 2069 6e20 7768 6963 6820 6f72 and in which or │ │ │ │ │ +00035dd0: 6465 7220 282a 6e6f 7465 2046 6c61 6720 der (*note Flag │ │ │ │ │ +00035de0: 5661 7269 6162 6c65 730a 4f72 6465 7269 Variables.Orderi │ │ │ │ │ +00035df0: 6e67 3a3a 293b 2066 6f72 2069 6e73 7461 ng::); for insta │ │ │ │ │ +00035e00: 6e63 652c 2079 6f75 206d 6967 6874 206e nce, you might n │ │ │ │ │ +00035e10: 6565 6420 746f 2064 6f20 796f 7572 206f eed to do your o │ │ │ │ │ +00035e20: 776e 2063 6f6d 7069 6c61 7469 6f6e 2069 wn compilation i │ │ │ │ │ +00035e30: 6e0a 736f 6d65 2073 7065 6369 616c 2063 n.some special c │ │ │ │ │ +00035e40: 6173 6573 2e0a 0a20 2020 536f 6d65 2076 ases... Some v │ │ │ │ │ +00035e50: 6172 6961 626c 6573 2061 7265 2069 6e68 ariables are inh │ │ │ │ │ +00035e60: 6572 6974 6564 2066 726f 6d20 4175 746f erited from Auto │ │ │ │ │ +00035e70: 636f 6e66 3b20 7468 6573 6520 6172 6520 conf; these are │ │ │ │ │ +00035e80: 2743 4327 2c20 2743 464c 4147 5327 2c0a 'CC', 'CFLAGS',. │ │ │ │ │ +00035e90: 2743 5050 464c 4147 5327 2c20 2744 4546 'CPPFLAGS', 'DEF │ │ │ │ │ +00035ea0: 5327 2c20 274c 4446 4c41 4753 272c 2061 S', 'LDFLAGS', a │ │ │ │ │ +00035eb0: 6e64 2027 4c49 4253 272e 0a0a 2020 2054 nd 'LIBS'... T │ │ │ │ │ +00035ec0: 6865 7265 2061 7265 2073 6f6d 6520 6164 here are some ad │ │ │ │ │ +00035ed0: 6469 7469 6f6e 616c 2076 6172 6961 626c ditional variabl │ │ │ │ │ +00035ee0: 6573 2074 6861 7420 4175 746f 6d61 6b65 es that Automake │ │ │ │ │ +00035ef0: 2064 6566 696e 6573 206f 6e20 6974 7320 defines on its │ │ │ │ │ +00035f00: 6f77 6e3a 0a0a 2741 4d5f 4350 5046 4c41 own:..'AM_CPPFLA │ │ │ │ │ +00035f10: 4753 270a 2020 2020 2054 6865 2063 6f6e GS'. The con │ │ │ │ │ +00035f20: 7465 6e74 7320 6f66 2074 6869 7320 7661 tents of this va │ │ │ │ │ +00035f30: 7269 6162 6c65 2061 7265 2070 6173 7365 riable are passe │ │ │ │ │ +00035f40: 6420 746f 2065 7665 7279 2063 6f6d 7069 d to every compi │ │ │ │ │ +00035f50: 6c61 7469 6f6e 2074 6861 740a 2020 2020 lation that. │ │ │ │ │ +00035f60: 2069 6e76 6f6b 6573 2074 6865 2043 2070 invokes the C p │ │ │ │ │ +00035f70: 7265 7072 6f63 6573 736f 723b 2069 7420 reprocessor; it │ │ │ │ │ +00035f80: 6973 2061 206c 6973 7420 6f66 2061 7267 is a list of arg │ │ │ │ │ +00035f90: 756d 656e 7473 2074 6f20 7468 650a 2020 uments to the. │ │ │ │ │ +00035fa0: 2020 2070 7265 7072 6f63 6573 736f 722e preprocessor. │ │ │ │ │ +00035fb0: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ +00035fc0: 272d 4927 2061 6e64 2027 2d44 2720 6f70 '-I' and '-D' op │ │ │ │ │ +00035fd0: 7469 6f6e 7320 7368 6f75 6c64 2062 6520 tions should be │ │ │ │ │ +00035fe0: 6c69 7374 6564 0a20 2020 2020 6865 7265 listed. here │ │ │ │ │ +00035ff0: 2e0a 0a20 2020 2020 4175 746f 6d61 6b65 ... Automake │ │ │ │ │ +00036000: 2061 6c72 6561 6479 2070 726f 7669 6465 already provide │ │ │ │ │ +00036010: 7320 736f 6d65 2027 2d49 2720 6f70 7469 s some '-I' opti │ │ │ │ │ +00036020: 6f6e 7320 6175 746f 6d61 7469 6361 6c6c ons automaticall │ │ │ │ │ +00036030: 792c 2069 6e20 610a 2020 2020 2073 6570 y, in a. sep │ │ │ │ │ +00036040: 6172 6174 6520 7661 7269 6162 6c65 2074 arate variable t │ │ │ │ │ +00036050: 6861 7420 6973 2061 6c73 6f20 7061 7373 hat is also pass │ │ │ │ │ +00036060: 6564 2074 6f20 6576 6572 7920 636f 6d70 ed to every comp │ │ │ │ │ +00036070: 696c 6174 696f 6e20 7468 6174 0a20 2020 ilation that. │ │ │ │ │ +00036080: 2020 696e 766f 6b65 7320 7468 6520 4320 invokes the C │ │ │ │ │ +00036090: 7072 6570 726f 6365 7373 6f72 2e20 2049 preprocessor. I │ │ │ │ │ +000360a0: 6e20 7061 7274 6963 756c 6172 2069 7420 n particular it │ │ │ │ │ +000360b0: 6765 6e65 7261 7465 7320 272d 492e 272c generates '-I.', │ │ │ │ │ +000360c0: 0a20 2020 2020 272d 4924 2873 7263 6469 . '-I$(srcdi │ │ │ │ │ +000360d0: 7229 272c 2061 6e64 2061 2027 2d49 2720 r)', and a '-I' │ │ │ │ │ +000360e0: 706f 696e 7469 6e67 2074 6f20 7468 6520 pointing to the │ │ │ │ │ +000360f0: 6469 7265 6374 6f72 7920 686f 6c64 696e directory holdin │ │ │ │ │ +00036100: 670a 2020 2020 2027 636f 6e66 6967 2e68 g. 'config.h │ │ │ │ │ +00036110: 2720 2869 6620 796f 7527 7665 2075 7365 ' (if you've use │ │ │ │ │ +00036120: 6420 2741 435f 434f 4e46 4947 5f48 4541 d 'AC_CONFIG_HEA │ │ │ │ │ +00036130: 4445 5253 2720 6f72 0a20 2020 2020 2741 DERS' or. 'A │ │ │ │ │ +00036140: 4d5f 434f 4e46 4947 5f48 4541 4445 5227 M_CONFIG_HEADER' │ │ │ │ │ +00036150: 292e 2020 596f 7520 6361 6e20 6469 7361 ). You can disa │ │ │ │ │ +00036160: 626c 6520 7468 6520 6465 6661 756c 7420 ble the default │ │ │ │ │ +00036170: 272d 4927 206f 7074 696f 6e73 0a20 2020 '-I' options. │ │ │ │ │ +00036180: 2020 7573 696e 6720 7468 6520 276e 6f73 using the 'nos │ │ │ │ │ +00036190: 7464 696e 6327 206f 7074 696f 6e2e 0a0a tdinc' option... │ │ │ │ │ +000361a0: 2020 2020 2057 6865 6e20 6120 6669 6c65 When a file │ │ │ │ │ +000361b0: 2074 6f20 6265 2069 6e63 6c75 6465 6420 to be included │ │ │ │ │ +000361c0: 6973 2067 656e 6572 6174 6564 2064 7572 is generated dur │ │ │ │ │ +000361d0: 696e 6720 7468 6520 6275 696c 6420 616e ing the build an │ │ │ │ │ +000361e0: 6420 6e6f 740a 2020 2020 2070 6172 7420 d not. part │ │ │ │ │ +000361f0: 6f66 2061 2064 6973 7472 6962 7574 696f of a distributio │ │ │ │ │ +00036200: 6e20 7461 7262 616c 6c2c 2069 7473 206c n tarball, its l │ │ │ │ │ +00036210: 6f63 6174 696f 6e20 6973 2075 6e64 6572 ocation is under │ │ │ │ │ +00036220: 0a20 2020 2020 2724 2862 7569 6c64 6469 . '$(builddi │ │ │ │ │ +00036230: 7229 272c 206e 6f74 2075 6e64 6572 2027 r)', not under ' │ │ │ │ │ +00036240: 2428 7372 6364 6972 2927 2e20 2054 6869 $(srcdir)'. Thi │ │ │ │ │ +00036250: 7320 6d61 7474 6572 7320 6573 7065 6369 s matters especi │ │ │ │ │ +00036260: 616c 6c79 2066 6f72 0a20 2020 2020 7061 ally for. pa │ │ │ │ │ +00036270: 636b 6167 6573 2074 6861 7420 7573 6520 ckages that use │ │ │ │ │ +00036280: 6865 6164 6572 2066 696c 6573 2070 6c61 header files pla │ │ │ │ │ +00036290: 6365 6420 696e 2073 7562 2d64 6972 6563 ced in sub-direc │ │ │ │ │ +000362a0: 746f 7269 6573 2061 6e64 2077 616e 740a tories and want. │ │ │ │ │ +000362b0: 2020 2020 2074 6f20 616c 6c6f 7720 6275 to allow bu │ │ │ │ │ +000362c0: 696c 6473 206f 7574 7369 6465 2074 6865 ilds outside the │ │ │ │ │ +000362d0: 2073 6f75 7263 6520 7472 6565 2028 2a6e source tree (*n │ │ │ │ │ +000362e0: 6f74 6520 5650 4154 4820 4275 696c 6473 ote VPATH Builds │ │ │ │ │ +000362f0: 3a3a 292e 2020 496e 0a20 2020 2020 7468 ::). In. th │ │ │ │ │ +00036300: 6174 2063 6173 6520 7765 2072 6563 6f6d at case we recom │ │ │ │ │ +00036310: 6d65 6e64 2074 6f20 7573 6520 6120 7061 mend to use a pa │ │ │ │ │ +00036320: 6972 206f 6620 272d 4927 206f 7074 696f ir of '-I' optio │ │ │ │ │ +00036330: 6e73 2c20 7375 6368 2061 732c 0a20 2020 ns, such as,. │ │ │ │ │ +00036340: 2020 652e 672e 2c20 272d 4973 6f6d 652f e.g., '-Isome/ │ │ │ │ │ +00036350: 7375 6264 6972 202d 4924 2873 7263 6469 subdir -I$(srcdi │ │ │ │ │ +00036360: 7229 2f73 6f6d 652f 7375 6264 6972 2720 r)/some/subdir' │ │ │ │ │ +00036370: 6f72 0a20 2020 2020 272d 4924 2874 6f70 or. '-I$(top │ │ │ │ │ +00036380: 5f62 7569 6c64 6469 7229 2f73 6f6d 652f _builddir)/some/ │ │ │ │ │ +00036390: 7375 6264 6972 202d 4924 2874 6f70 5f73 subdir -I$(top_s │ │ │ │ │ +000363a0: 7263 6469 7229 2f73 6f6d 652f 7375 6264 rcdir)/some/subd │ │ │ │ │ +000363b0: 6972 272e 2020 4e6f 7465 0a20 2020 2020 ir'. Note. │ │ │ │ │ +000363c0: 7468 6174 2074 6865 2072 6566 6572 656e that the referen │ │ │ │ │ +000363d0: 6365 2074 6f20 7468 6520 6275 696c 6420 ce to the build │ │ │ │ │ +000363e0: 7472 6565 2073 686f 756c 6420 636f 6d65 tree should come │ │ │ │ │ +000363f0: 2062 6566 6f72 6520 7468 650a 2020 2020 before the. │ │ │ │ │ +00036400: 2072 6566 6572 656e 6365 2074 6f20 7468 reference to th │ │ │ │ │ +00036410: 6520 736f 7572 6365 2074 7265 652c 2073 e source tree, s │ │ │ │ │ +00036420: 6f20 7468 6174 2061 6363 6964 656e 7461 o that accidenta │ │ │ │ │ +00036430: 6c6c 7920 6c65 6674 6f76 6572 0a20 2020 lly leftover. │ │ │ │ │ +00036440: 2020 6765 6e65 7261 7465 6420 6669 6c65 generated file │ │ │ │ │ +00036450: 7320 696e 2074 6865 2073 6f75 7263 6520 s in the source │ │ │ │ │ +00036460: 6469 7265 6374 6f72 7920 6172 6520 6967 directory are ig │ │ │ │ │ +00036470: 6e6f 7265 642e 0a0a 2020 2020 2027 414d nored... 'AM │ │ │ │ │ +00036480: 5f43 5050 464c 4147 5327 2069 7320 6967 _CPPFLAGS' is ig │ │ │ │ │ +00036490: 6e6f 7265 6420 696e 2070 7265 6665 7265 nored in prefere │ │ │ │ │ +000364a0: 6e63 6520 746f 2061 2070 6572 2d65 7865 nce to a per-exe │ │ │ │ │ +000364b0: 6375 7461 626c 6520 286f 720a 2020 2020 cutable (or. │ │ │ │ │ +000364c0: 2070 6572 2d6c 6962 7261 7279 2920 275f per-library) '_ │ │ │ │ │ +000364d0: 4350 5046 4c41 4753 2720 7661 7269 6162 CPPFLAGS' variab │ │ │ │ │ +000364e0: 6c65 2069 6620 6974 2069 7320 6465 6669 le if it is defi │ │ │ │ │ +000364f0: 6e65 642e 0a0a 2749 4e43 4c55 4445 5327 ned...'INCLUDES' │ │ │ │ │ +00036500: 0a20 2020 2020 5468 6973 2064 6f65 7320 . This does │ │ │ │ │ +00036510: 7468 6520 7361 6d65 206a 6f62 2061 7320 the same job as │ │ │ │ │ +00036520: 2741 4d5f 4350 5046 4c41 4753 2720 286f 'AM_CPPFLAGS' (o │ │ │ │ │ +00036530: 7220 616e 7920 7065 722d 7461 7267 6574 r any per-target │ │ │ │ │ +00036540: 0a20 2020 2020 275f 4350 5046 4c41 4753 . '_CPPFLAGS │ │ │ │ │ +00036550: 2720 7661 7269 6162 6c65 2069 6620 6974 ' variable if it │ │ │ │ │ +00036560: 2069 7320 7573 6564 292e 2020 4974 2069 is used). It i │ │ │ │ │ +00036570: 7320 616e 206f 6c64 6572 206e 616d 6520 s an older name │ │ │ │ │ +00036580: 666f 7220 7468 650a 2020 2020 2073 616d for the. sam │ │ │ │ │ +00036590: 6520 6675 6e63 7469 6f6e 616c 6974 792e e functionality. │ │ │ │ │ +000365a0: 2020 5468 6973 2076 6172 6961 626c 6520 This variable │ │ │ │ │ +000365b0: 6973 2064 6570 7265 6361 7465 643b 2077 is deprecated; w │ │ │ │ │ +000365c0: 6520 7375 6767 6573 7420 7573 696e 670a e suggest using. │ │ │ │ │ +000365d0: 2020 2020 2027 414d 5f43 5050 464c 4147 'AM_CPPFLAG │ │ │ │ │ +000365e0: 5327 2061 6e64 2070 6572 2d74 6172 6765 S' and per-targe │ │ │ │ │ +000365f0: 7420 275f 4350 5046 4c41 4753 2720 696e t '_CPPFLAGS' in │ │ │ │ │ +00036600: 7374 6561 642e 0a0a 2741 4d5f 4346 4c41 stead...'AM_CFLA │ │ │ │ │ +00036610: 4753 270a 2020 2020 2054 6869 7320 6973 GS'. This is │ │ │ │ │ +00036620: 2074 6865 2076 6172 6961 626c 6520 7468 the variable th │ │ │ │ │ +00036630: 6520 274d 616b 6566 696c 652e 616d 2720 e 'Makefile.am' │ │ │ │ │ +00036640: 6175 7468 6f72 2063 616e 2075 7365 2074 author can use t │ │ │ │ │ +00036650: 6f20 7061 7373 2069 6e0a 2020 2020 2061 o pass in. a │ │ │ │ │ +00036660: 6464 6974 696f 6e61 6c20 4320 636f 6d70 dditional C comp │ │ │ │ │ +00036670: 696c 6572 2066 6c61 6773 2e20 2049 7420 iler flags. It │ │ │ │ │ +00036680: 6973 206d 6f72 6520 6675 6c6c 7920 646f is more fully do │ │ │ │ │ +00036690: 6375 6d65 6e74 6564 0a20 2020 2020 656c cumented. el │ │ │ │ │ +000366a0: 7365 7768 6572 652e 2020 496e 2073 6f6d sewhere. In som │ │ │ │ │ +000366b0: 6520 7369 7475 6174 696f 6e73 2c20 7468 e situations, th │ │ │ │ │ +000366c0: 6973 2069 7320 6e6f 7420 7573 6564 2c20 is is not used, │ │ │ │ │ +000366d0: 696e 2070 7265 6665 7265 6e63 6520 746f in preference to │ │ │ │ │ +000366e0: 0a20 2020 2020 7468 6520 7065 722d 6578 . the per-ex │ │ │ │ │ +000366f0: 6563 7574 6162 6c65 2028 6f72 2070 6572 ecutable (or per │ │ │ │ │ +00036700: 2d6c 6962 7261 7279 2920 275f 4346 4c41 -library) '_CFLA │ │ │ │ │ +00036710: 4753 272e 0a0a 2743 4f4d 5049 4c45 270a GS'...'COMPILE'. │ │ │ │ │ +00036720: 2020 2020 2054 6869 7320 6973 2074 6865 This is the │ │ │ │ │ +00036730: 2063 6f6d 6d61 6e64 2075 7365 6420 746f command used to │ │ │ │ │ +00036740: 2061 6374 7561 6c6c 7920 636f 6d70 696c actually compil │ │ │ │ │ +00036750: 6520 6120 4320 736f 7572 6365 2066 696c e a C source fil │ │ │ │ │ +00036760: 652e 2020 5468 650a 2020 2020 2066 696c e. The. fil │ │ │ │ │ +00036770: 6520 6e61 6d65 2069 7320 6170 7065 6e64 e name is append │ │ │ │ │ +00036780: 6564 2074 6f20 666f 726d 2074 6865 2063 ed to form the c │ │ │ │ │ +00036790: 6f6d 706c 6574 6520 636f 6d6d 616e 6420 omplete command │ │ │ │ │ +000367a0: 6c69 6e65 2e0a 0a27 414d 5f4c 4446 4c41 line...'AM_LDFLA │ │ │ │ │ +000367b0: 4753 270a 2020 2020 2054 6869 7320 6973 GS'. This is │ │ │ │ │ +000367c0: 2074 6865 2076 6172 6961 626c 6520 7468 the variable th │ │ │ │ │ +000367d0: 6520 274d 616b 6566 696c 652e 616d 2720 e 'Makefile.am' │ │ │ │ │ +000367e0: 6175 7468 6f72 2063 616e 2075 7365 2074 author can use t │ │ │ │ │ +000367f0: 6f20 7061 7373 2069 6e0a 2020 2020 2061 o pass in. a │ │ │ │ │ +00036800: 6464 6974 696f 6e61 6c20 6c69 6e6b 6572 dditional linker │ │ │ │ │ +00036810: 2066 6c61 6773 2e20 2049 6e20 736f 6d65 flags. In some │ │ │ │ │ +00036820: 2073 6974 7561 7469 6f6e 732c 2074 6869 situations, thi │ │ │ │ │ +00036830: 7320 6973 206e 6f74 2075 7365 642c 2069 s is not used, i │ │ │ │ │ +00036840: 6e0a 2020 2020 2070 7265 6665 7265 6e63 n. preferenc │ │ │ │ │ +00036850: 6520 746f 2074 6865 2070 6572 2d65 7865 e to the per-exe │ │ │ │ │ +00036860: 6375 7461 626c 6520 286f 7220 7065 722d cutable (or per- │ │ │ │ │ +00036870: 6c69 6272 6172 7929 2027 5f4c 4446 4c41 library) '_LDFLA │ │ │ │ │ +00036880: 4753 272e 0a0a 274c 494e 4b27 0a20 2020 GS'...'LINK'. │ │ │ │ │ +00036890: 2020 5468 6973 2069 7320 7468 6520 636f This is the co │ │ │ │ │ +000368a0: 6d6d 616e 6420 7573 6564 2074 6f20 6163 mmand used to ac │ │ │ │ │ +000368b0: 7475 616c 6c79 206c 696e 6b20 6120 4320 tually link a C │ │ │ │ │ +000368c0: 7072 6f67 7261 6d2e 2020 4974 2061 6c72 program. It alr │ │ │ │ │ +000368d0: 6561 6479 0a20 2020 2020 696e 636c 7564 eady. includ │ │ │ │ │ +000368e0: 6573 2027 2d6f 2024 4027 2061 6e64 2074 es '-o $@' and t │ │ │ │ │ +000368f0: 6865 2075 7375 616c 2076 6172 6961 626c he usual variabl │ │ │ │ │ +00036900: 6520 7265 6665 7265 6e63 6573 2028 666f e references (fo │ │ │ │ │ +00036910: 7220 696e 7374 616e 6365 2c0a 2020 2020 r instance,. │ │ │ │ │ +00036920: 2027 4346 4c41 4753 2729 3b20 6974 2074 'CFLAGS'); it t │ │ │ │ │ +00036930: 616b 6573 2061 7320 2261 7267 756d 656e akes as "argumen │ │ │ │ │ +00036940: 7473 2220 7468 6520 6e61 6d65 7320 6f66 ts" the names of │ │ │ │ │ +00036950: 2074 6865 206f 626a 6563 7420 6669 6c65 the object file │ │ │ │ │ +00036960: 730a 2020 2020 2061 6e64 206c 6962 7261 s. and libra │ │ │ │ │ +00036970: 7269 6573 2074 6f20 6c69 6e6b 2069 6e2e ries to link in. │ │ │ │ │ +00036980: 2020 5468 6973 2076 6172 6961 626c 6520 This variable │ │ │ │ │ +00036990: 6973 206e 6f74 2075 7365 6420 7768 656e is not used when │ │ │ │ │ +000369a0: 2074 6865 0a20 2020 2020 6c69 6e6b 6572 the. linker │ │ │ │ │ +000369b0: 2069 7320 6f76 6572 7269 6464 656e 2077 is overridden w │ │ │ │ │ +000369c0: 6974 6820 6120 7065 722d 7461 7267 6574 ith a per-target │ │ │ │ │ +000369d0: 2027 5f4c 494e 4b27 2076 6172 6961 626c '_LINK' variabl │ │ │ │ │ +000369e0: 6520 6f72 0a20 2020 2020 7065 722d 7461 e or. per-ta │ │ │ │ │ +000369f0: 7267 6574 2066 6c61 6773 2063 6175 7365 rget flags cause │ │ │ │ │ +00036a00: 2041 7574 6f6d 616b 6520 746f 2064 6566 Automake to def │ │ │ │ │ +00036a10: 696e 6520 7375 6368 2061 2027 5f4c 494e ine such a '_LIN │ │ │ │ │ +00036a20: 4b27 2076 6172 6961 626c 652e 0a0a 1f0a K' variable..... │ │ │ │ │ +00036a30: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +00036a40: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +00036a50: 2059 6163 6320 616e 6420 4c65 782c 2020 Yacc and Lex, │ │ │ │ │ +00036a60: 4e65 7874 3a20 432b 2b20 5375 7070 6f72 Next: C++ Suppor │ │ │ │ │ +00036a70: 742c 2020 5072 6576 3a20 5072 6f67 7261 t, Prev: Progra │ │ │ │ │ +00036a80: 6d20 5661 7269 6162 6c65 732c 2020 5570 m Variables, Up │ │ │ │ │ +00036a90: 3a20 5072 6f67 7261 6d73 0a0a 382e 3820 : Programs..8.8 │ │ │ │ │ +00036aa0: 5961 6363 2061 6e64 204c 6578 2073 7570 Yacc and Lex sup │ │ │ │ │ +00036ab0: 706f 7274 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d port.=========== │ │ │ │ │ +00036ac0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 =============..A │ │ │ │ │ +00036ad0: 7574 6f6d 616b 6520 6861 7320 736f 6d65 utomake has some │ │ │ │ │ +00036ae0: 7768 6174 2069 6469 6f73 796e 6372 6174 what idiosyncrat │ │ │ │ │ +00036af0: 6963 2073 7570 706f 7274 2066 6f72 2059 ic support for Y │ │ │ │ │ +00036b00: 6163 6320 616e 6420 4c65 782e 0a0a 2020 acc and Lex... │ │ │ │ │ +00036b10: 2041 7574 6f6d 616b 6520 6173 7375 6d65 Automake assume │ │ │ │ │ +00036b20: 7320 7468 6174 2074 6865 2027 2e63 2720 s that the '.c' │ │ │ │ │ +00036b30: 6669 6c65 2067 656e 6572 6174 6564 2062 file generated b │ │ │ │ │ +00036b40: 7920 2779 6163 6327 2028 6f72 2027 6c65 y 'yacc' (or 'le │ │ │ │ │ +00036b50: 7827 290a 7368 6f75 6c64 2062 6520 6e61 x').should be na │ │ │ │ │ +00036b60: 6d65 6420 7573 696e 6720 7468 6520 6261 med using the ba │ │ │ │ │ +00036b70: 7365 6e61 6d65 206f 6620 7468 6520 696e sename of the in │ │ │ │ │ +00036b80: 7075 7420 6669 6c65 2e20 2054 6861 7420 put file. That │ │ │ │ │ +00036b90: 6973 2c20 666f 7220 610a 7961 6363 2073 is, for a.yacc s │ │ │ │ │ +00036ba0: 6f75 7263 6520 6669 6c65 2027 666f 6f2e ource file 'foo. │ │ │ │ │ +00036bb0: 7927 2c20 4175 746f 6d61 6b65 2077 696c y', Automake wil │ │ │ │ │ +00036bc0: 6c20 6361 7573 6520 7468 6520 696e 7465 l cause the inte │ │ │ │ │ +00036bd0: 726d 6564 6961 7465 2066 696c 6520 746f rmediate file to │ │ │ │ │ +00036be0: 0a62 6520 6e61 6d65 6420 2766 6f6f 2e63 .be named 'foo.c │ │ │ │ │ +00036bf0: 2720 2861 7320 6f70 706f 7365 6420 746f ' (as opposed to │ │ │ │ │ +00036c00: 2027 792e 7461 622e 6327 2c20 7768 6963 'y.tab.c', whic │ │ │ │ │ +00036c10: 6820 6973 206d 6f72 6520 7472 6164 6974 h is more tradit │ │ │ │ │ +00036c20: 696f 6e61 6c29 2e0a 0a20 2020 5468 6520 ional)... The │ │ │ │ │ +00036c30: 6578 7465 6e73 696f 6e20 6f66 2061 2079 extension of a y │ │ │ │ │ +00036c40: 6163 6320 736f 7572 6365 2066 696c 6520 acc source file │ │ │ │ │ +00036c50: 6973 2075 7365 6420 746f 2064 6574 6572 is used to deter │ │ │ │ │ +00036c60: 6d69 6e65 2074 6865 0a65 7874 656e 7369 mine the.extensi │ │ │ │ │ +00036c70: 6f6e 206f 6620 7468 6520 7265 7375 6c74 on of the result │ │ │ │ │ +00036c80: 696e 6720 4320 6f72 2043 2b2b 2066 696c ing C or C++ fil │ │ │ │ │ +00036c90: 652e 2020 4669 6c65 7320 7769 7468 2074 e. Files with t │ │ │ │ │ +00036ca0: 6865 2065 7874 656e 7369 6f6e 2027 2e79 he extension '.y │ │ │ │ │ +00036cb0: 270a 7769 6c6c 2062 6520 7475 726e 6564 '.will be turned │ │ │ │ │ +00036cc0: 2069 6e74 6f20 272e 6327 2066 696c 6573 into '.c' files │ │ │ │ │ +00036cd0: 3b20 6c69 6b65 7769 7365 2c20 272e 7979 ; likewise, '.yy │ │ │ │ │ +00036ce0: 2720 7769 6c6c 2062 6563 6f6d 6520 272e ' will become '. │ │ │ │ │ +00036cf0: 6363 273b 0a27 2e79 2b2b 272c 2027 632b cc';.'.y++', 'c+ │ │ │ │ │ +00036d00: 2b27 3b20 272e 7978 7827 2c20 272e 6378 +'; '.yxx', '.cx │ │ │ │ │ +00036d10: 7827 3b20 616e 6420 272e 7970 7027 2c20 x'; and '.ypp', │ │ │ │ │ +00036d20: 272e 6370 7027 2e0a 0a20 2020 4c69 6b65 '.cpp'... Like │ │ │ │ │ +00036d30: 7769 7365 2c20 6c65 7820 736f 7572 6365 wise, lex source │ │ │ │ │ +00036d40: 2066 696c 6573 2063 616e 2062 6520 7573 files can be us │ │ │ │ │ +00036d50: 6564 2074 6f20 6765 6e65 7261 7465 2043 ed to generate C │ │ │ │ │ +00036d60: 206f 7220 432b 2b3b 2074 6865 0a65 7874 or C++; the.ext │ │ │ │ │ +00036d70: 656e 7369 6f6e 7320 272e 6c27 2c20 272e ensions '.l', '. │ │ │ │ │ +00036d80: 6c6c 272c 2027 2e6c 2b2b 272c 2027 2e6c ll', '.l++', '.l │ │ │ │ │ +00036d90: 7878 272c 2061 6e64 2027 2e6c 7070 2720 xx', and '.lpp' │ │ │ │ │ +00036da0: 6172 6520 7265 636f 676e 697a 6564 2e0a are recognized.. │ │ │ │ │ +00036db0: 0a20 2020 596f 7520 7368 6f75 6c64 206e . You should n │ │ │ │ │ +00036dc0: 6576 6572 2065 7870 6c69 6369 746c 7920 ever explicitly │ │ │ │ │ +00036dd0: 6d65 6e74 696f 6e20 7468 6520 696e 7465 mention the inte │ │ │ │ │ +00036de0: 726d 6564 6961 7465 2028 4320 6f72 2043 rmediate (C or C │ │ │ │ │ +00036df0: 2b2b 2920 6669 6c65 0a69 6e20 616e 7920 ++) file.in any │ │ │ │ │ +00036e00: 2753 4f55 5243 4553 2720 7661 7269 6162 'SOURCES' variab │ │ │ │ │ +00036e10: 6c65 3b20 6f6e 6c79 206c 6973 7420 7468 le; only list th │ │ │ │ │ +00036e20: 6520 736f 7572 6365 2066 696c 652e 0a0a e source file... │ │ │ │ │ +00036e30: 2020 2054 6865 2069 6e74 6572 6d65 6469 The intermedi │ │ │ │ │ +00036e40: 6174 6520 6669 6c65 7320 6765 6e65 7261 ate files genera │ │ │ │ │ +00036e50: 7465 6420 6279 2027 7961 6363 2720 286f ted by 'yacc' (o │ │ │ │ │ +00036e60: 7220 276c 6578 2729 2077 696c 6c20 6265 r 'lex') will be │ │ │ │ │ +00036e70: 0a69 6e63 6c75 6465 6420 696e 2061 6e79 .included in any │ │ │ │ │ +00036e80: 2064 6973 7472 6962 7574 696f 6e20 7468 distribution th │ │ │ │ │ +00036e90: 6174 2069 7320 6d61 6465 2e20 2054 6861 at is made. Tha │ │ │ │ │ +00036ea0: 7420 7761 7920 7468 6520 7573 6572 2064 t way the user d │ │ │ │ │ +00036eb0: 6f65 736e 2774 0a6e 6565 6420 746f 2068 oesn't.need to h │ │ │ │ │ +00036ec0: 6176 6520 2779 6163 6327 206f 7220 276c ave 'yacc' or 'l │ │ │ │ │ +00036ed0: 6578 272e 0a0a 2020 2049 6620 6120 2779 ex'... If a 'y │ │ │ │ │ +00036ee0: 6163 6327 2073 6f75 7263 6520 6669 6c65 acc' source file │ │ │ │ │ +00036ef0: 2069 7320 7365 656e 2c20 7468 656e 2079 is seen, then y │ │ │ │ │ +00036f00: 6f75 7220 2763 6f6e 6669 6775 7265 2e61 our 'configure.a │ │ │ │ │ +00036f10: 6327 206d 7573 7420 6465 6669 6e65 0a74 c' must define.t │ │ │ │ │ +00036f20: 6865 2076 6172 6961 626c 6520 2759 4143 he variable 'YAC │ │ │ │ │ +00036f30: 4327 2e20 2054 6869 7320 6973 206d 6f73 C'. This is mos │ │ │ │ │ +00036f40: 7420 6561 7369 6c79 2064 6f6e 6520 6279 t easily done by │ │ │ │ │ +00036f50: 2069 6e76 6f6b 696e 6720 7468 6520 6d61 invoking the ma │ │ │ │ │ +00036f60: 6372 6f0a 2741 435f 5052 4f47 5f59 4143 cro.'AC_PROG_YAC │ │ │ │ │ +00036f70: 4327 2028 2a6e 6f74 6520 5061 7274 6963 C' (*note Partic │ │ │ │ │ +00036f80: 756c 6172 2050 726f 6772 616d 2043 6865 ular Program Che │ │ │ │ │ +00036f90: 636b 733a 2028 6175 746f 636f 6e66 2950 cks: (autoconf)P │ │ │ │ │ +00036fa0: 6172 7469 6375 6c61 720a 5072 6f67 7261 articular.Progra │ │ │ │ │ +00036fb0: 6d73 2e29 2e0a 0a20 2020 5768 656e 2027 ms.)... When ' │ │ │ │ │ +00036fc0: 7961 6363 2720 6973 2069 6e76 6f6b 6564 yacc' is invoked │ │ │ │ │ +00036fd0: 2c20 6974 2069 7320 7061 7373 6564 2027 , it is passed ' │ │ │ │ │ +00036fe0: 414d 5f59 464c 4147 5327 2061 6e64 2027 AM_YFLAGS' and ' │ │ │ │ │ +00036ff0: 5946 4c41 4753 272e 2020 5468 650a 6c61 YFLAGS'. The.la │ │ │ │ │ +00037000: 7474 6572 2069 7320 6120 7573 6572 2076 tter is a user v │ │ │ │ │ +00037010: 6172 6961 626c 6520 616e 6420 7468 6520 ariable and the │ │ │ │ │ +00037020: 666f 726d 6572 2069 7320 696e 7465 6e64 former is intend │ │ │ │ │ +00037030: 6564 2066 6f72 2074 6865 0a27 4d61 6b65 ed for the.'Make │ │ │ │ │ +00037040: 6669 6c65 2e61 6d27 2061 7574 686f 722e file.am' author. │ │ │ │ │ +00037050: 0a0a 2020 2027 414d 5f59 464c 4147 5327 .. 'AM_YFLAGS' │ │ │ │ │ +00037060: 2069 7320 7573 7561 6c6c 7920 7573 6564 is usually used │ │ │ │ │ +00037070: 2074 6f20 7061 7373 2074 6865 2027 2d64 to pass the '-d │ │ │ │ │ +00037080: 2720 6f70 7469 6f6e 2074 6f20 2779 6163 ' option to 'yac │ │ │ │ │ +00037090: 6327 2e0a 4175 746f 6d61 6b65 206b 6e6f c'..Automake kno │ │ │ │ │ +000370a0: 7773 2077 6861 7420 7468 6973 206d 6561 ws what this mea │ │ │ │ │ +000370b0: 6e73 2061 6e64 2077 696c 6c20 6175 746f ns and will auto │ │ │ │ │ +000370c0: 6d61 7469 6361 6c6c 7920 6164 6a75 7374 matically adjust │ │ │ │ │ +000370d0: 2069 7473 2072 756c 6573 0a74 6f20 7570 its rules.to up │ │ │ │ │ +000370e0: 6461 7465 2061 6e64 2064 6973 7472 6962 date and distrib │ │ │ │ │ +000370f0: 7574 6520 7468 6520 6865 6164 6572 2066 ute the header f │ │ │ │ │ +00037100: 696c 6520 6275 696c 7420 6279 2027 7961 ile built by 'ya │ │ │ │ │ +00037110: 6363 202d 6427 2831 292e 2020 5768 6174 cc -d'(1). What │ │ │ │ │ +00037120: 0a41 7574 6f6d 616b 6520 6361 6e6e 6f74 .Automake cannot │ │ │ │ │ +00037130: 2067 7565 7373 2c20 7468 6f75 6768 2c20 guess, though, │ │ │ │ │ +00037140: 6973 2077 6865 7265 2074 6869 7320 6865 is where this he │ │ │ │ │ +00037150: 6164 6572 2077 696c 6c20 6265 2075 7365 ader will be use │ │ │ │ │ +00037160: 643a 2069 7420 6973 0a75 7020 746f 2079 d: it is.up to y │ │ │ │ │ +00037170: 6f75 2074 6f20 656e 7375 7265 2074 6865 ou to ensure the │ │ │ │ │ +00037180: 2068 6561 6465 7220 6765 7473 2062 7569 header gets bui │ │ │ │ │ +00037190: 6c74 2062 6566 6f72 6520 6974 2069 7320 lt before it is │ │ │ │ │ +000371a0: 6669 7273 7420 7573 6564 2e0a 5479 7069 first used..Typi │ │ │ │ │ +000371b0: 6361 6c6c 7920 7468 6973 2069 7320 6e65 cally this is ne │ │ │ │ │ +000371c0: 6365 7373 6172 7920 696e 206f 7264 6572 cessary in order │ │ │ │ │ +000371d0: 2066 6f72 2064 6570 656e 6465 6e63 7920 for dependency │ │ │ │ │ +000371e0: 7472 6163 6b69 6e67 2074 6f20 776f 726b tracking to work │ │ │ │ │ +000371f0: 0a77 6865 6e20 7468 6520 6865 6164 6572 .when the header │ │ │ │ │ +00037200: 2069 7320 696e 636c 7564 6564 2062 7920 is included by │ │ │ │ │ +00037210: 616e 6f74 6865 7220 6669 6c65 2e20 2054 another file. T │ │ │ │ │ +00037220: 6865 2063 6f6d 6d6f 6e20 736f 6c75 7469 he common soluti │ │ │ │ │ +00037230: 6f6e 2069 730a 6c69 7374 696e 6720 7468 on is.listing th │ │ │ │ │ +00037240: 6520 6865 6164 6572 2066 696c 6520 696e e header file in │ │ │ │ │ +00037250: 2027 4255 494c 545f 534f 5552 4345 5327 'BUILT_SOURCES' │ │ │ │ │ +00037260: 2028 2a6e 6f74 6520 536f 7572 6365 733a (*note Sources: │ │ │ │ │ +00037270: 3a29 2061 7320 666f 6c6c 6f77 732e 0a0a :) as follows... │ │ │ │ │ +00037280: 2020 2020 2042 5549 4c54 5f53 4f55 5243 BUILT_SOURC │ │ │ │ │ +00037290: 4553 203d 2070 6172 7365 722e 680a 2020 ES = parser.h. │ │ │ │ │ +000372a0: 2020 2041 4d5f 5946 4c41 4753 203d 202d AM_YFLAGS = - │ │ │ │ │ +000372b0: 640a 2020 2020 2062 696e 5f50 524f 4752 d. bin_PROGR │ │ │ │ │ +000372c0: 414d 5320 3d20 666f 6f0a 2020 2020 2066 AMS = foo. f │ │ │ │ │ +000372d0: 6f6f 5f53 4f55 5243 4553 203d 202e 2e2e oo_SOURCES = ... │ │ │ │ │ +000372e0: 2070 6172 7365 722e 7920 2e2e 2e0a 0a20 parser.y ..... │ │ │ │ │ +000372f0: 2020 4966 2061 2027 6c65 7827 2073 6f75 If a 'lex' sou │ │ │ │ │ +00037300: 7263 6520 6669 6c65 2069 7320 7365 656e rce file is seen │ │ │ │ │ +00037310: 2c20 7468 656e 2079 6f75 7220 2763 6f6e , then your 'con │ │ │ │ │ +00037320: 6669 6775 7265 2e61 6327 206d 7573 7420 figure.ac' must │ │ │ │ │ +00037330: 6465 6669 6e65 0a74 6865 2076 6172 6961 define.the varia │ │ │ │ │ +00037340: 626c 6520 274c 4558 272e 2020 596f 7520 ble 'LEX'. You │ │ │ │ │ +00037350: 6361 6e20 7573 6520 2741 435f 5052 4f47 can use 'AC_PROG │ │ │ │ │ +00037360: 5f4c 4558 2720 746f 2064 6f20 7468 6973 _LEX' to do this │ │ │ │ │ +00037370: 2028 2a6e 6f74 650a 5061 7274 6963 756c (*note.Particul │ │ │ │ │ +00037380: 6172 2050 726f 6772 616d 2043 6865 636b ar Program Check │ │ │ │ │ +00037390: 733a 2028 6175 746f 636f 6e66 2950 6172 s: (autoconf)Par │ │ │ │ │ +000373a0: 7469 6375 6c61 7220 5072 6f67 7261 6d73 ticular Programs │ │ │ │ │ +000373b0: 2e29 2c20 6275 7420 7573 696e 670a 2741 .), but using.'A │ │ │ │ │ +000373c0: 4d5f 5052 4f47 5f4c 4558 2720 6d61 6372 M_PROG_LEX' macr │ │ │ │ │ +000373d0: 6f20 282a 6e6f 7465 204d 6163 726f 733a o (*note Macros: │ │ │ │ │ +000373e0: 3a29 2069 7320 7265 636f 6d6d 656e 6465 :) is recommende │ │ │ │ │ +000373f0: 642e 0a0a 2020 2057 6865 6e20 276c 6578 d... When 'lex │ │ │ │ │ +00037400: 2720 6973 2069 6e76 6f6b 6564 2c20 6974 ' is invoked, it │ │ │ │ │ +00037410: 2069 7320 7061 7373 6564 2027 414d 5f4c is passed 'AM_L │ │ │ │ │ +00037420: 464c 4147 5327 2061 6e64 2027 4c46 4c41 FLAGS' and 'LFLA │ │ │ │ │ +00037430: 4753 272e 2020 5468 650a 6c61 7474 6572 GS'. The.latter │ │ │ │ │ +00037440: 2069 7320 6120 7573 6572 2076 6172 6961 is a user varia │ │ │ │ │ +00037450: 626c 6520 616e 6420 7468 6520 666f 726d ble and the form │ │ │ │ │ +00037460: 6572 2069 7320 696e 7465 6e64 6564 2066 er is intended f │ │ │ │ │ +00037470: 6f72 2074 6865 0a27 4d61 6b65 6669 6c65 or the.'Makefile │ │ │ │ │ +00037480: 2e61 6d27 2061 7574 686f 722e 0a0a 2020 .am' author... │ │ │ │ │ +00037490: 2057 6865 6e20 2741 4d5f 4d41 494e 5441 When 'AM_MAINTA │ │ │ │ │ +000374a0: 494e 4552 5f4d 4f44 4527 2028 2a6e 6f74 INER_MODE' (*not │ │ │ │ │ +000374b0: 6520 6d61 696e 7461 696e 6572 2d6d 6f64 e maintainer-mod │ │ │ │ │ +000374c0: 653a 3a29 2069 7320 7573 6564 2c20 7468 e::) is used, th │ │ │ │ │ +000374d0: 650a 7265 6275 696c 6420 7275 6c65 2066 e.rebuild rule f │ │ │ │ │ +000374e0: 6f72 2064 6973 7472 6962 7574 6564 2059 or distributed Y │ │ │ │ │ +000374f0: 6163 6320 616e 6420 4c65 7820 736f 7572 acc and Lex sour │ │ │ │ │ +00037500: 6365 7320 6172 6520 6f6e 6c79 2075 7365 ces are only use │ │ │ │ │ +00037510: 6420 7768 656e 0a27 6d61 696e 7461 696e d when.'maintain │ │ │ │ │ +00037520: 6572 2d6d 6f64 6527 2069 7320 656e 6162 er-mode' is enab │ │ │ │ │ +00037530: 6c65 642c 206f 7220 7768 656e 2074 6865 led, or when the │ │ │ │ │ +00037540: 2066 696c 6573 2068 6176 6520 6265 656e files have been │ │ │ │ │ +00037550: 2065 7261 7365 642e 0a0a 2020 2057 6865 erased... Whe │ │ │ │ │ +00037560: 6e20 276c 6578 2720 6f72 2027 7961 6363 n 'lex' or 'yacc │ │ │ │ │ +00037570: 2720 736f 7572 6365 7320 6172 6520 7573 ' sources are us │ │ │ │ │ +00037580: 6564 2c20 2761 7574 6f6d 616b 6520 2d69 ed, 'automake -i │ │ │ │ │ +00037590: 2720 6175 746f 6d61 7469 6361 6c6c 790a ' automatically. │ │ │ │ │ +000375a0: 696e 7374 616c 6c73 2061 6e20 6175 7869 installs an auxi │ │ │ │ │ +000375b0: 6c69 6172 7920 7072 6f67 7261 6d20 6361 liary program ca │ │ │ │ │ +000375c0: 6c6c 6564 2027 796c 7772 6170 2720 696e lled 'ylwrap' in │ │ │ │ │ +000375d0: 2079 6f75 7220 7061 636b 6167 6520 282a your package (* │ │ │ │ │ +000375e0: 6e6f 7465 0a41 7578 696c 6961 7279 2050 note.Auxiliary P │ │ │ │ │ +000375f0: 726f 6772 616d 733a 3a29 2e20 2054 6869 rograms::). Thi │ │ │ │ │ +00037600: 7320 7072 6f67 7261 6d20 6973 2075 7365 s program is use │ │ │ │ │ +00037610: 6420 6279 2074 6865 2062 7569 6c64 2072 d by the build r │ │ │ │ │ +00037620: 756c 6573 2074 6f0a 7265 6e61 6d65 2074 ules to.rename t │ │ │ │ │ +00037630: 6865 206f 7574 7075 7420 6f66 2074 6865 he output of the │ │ │ │ │ +00037640: 7365 2074 6f6f 6c73 2c20 616e 6420 6d61 se tools, and ma │ │ │ │ │ +00037650: 6b65 7320 6974 2070 6f73 7369 626c 6520 kes it possible │ │ │ │ │ +00037660: 746f 2069 6e63 6c75 6465 0a6d 756c 7469 to include.multi │ │ │ │ │ +00037670: 706c 6520 2779 6163 6327 2028 6f72 2027 ple 'yacc' (or ' │ │ │ │ │ +00037680: 6c65 7827 2920 736f 7572 6365 2066 696c lex') source fil │ │ │ │ │ +00037690: 6573 2069 6e20 6120 7369 6e67 6c65 2064 es in a single d │ │ │ │ │ +000376a0: 6972 6563 746f 7279 2e20 2028 5468 6973 irectory. (This │ │ │ │ │ +000376b0: 2069 730a 6e65 6365 7373 6172 7920 6265 is.necessary be │ │ │ │ │ +000376c0: 6361 7573 6520 7961 6363 2773 206f 7574 cause yacc's out │ │ │ │ │ +000376d0: 7075 7420 6669 6c65 206e 616d 6520 6973 put file name is │ │ │ │ │ +000376e0: 2066 6978 6564 2c20 616e 6420 6120 7061 fixed, and a pa │ │ │ │ │ +000376f0: 7261 6c6c 656c 206d 616b 650a 636f 756c rallel make.coul │ │ │ │ │ +00037700: 6420 636f 6e63 6569 7661 626c 7920 696e d conceivably in │ │ │ │ │ +00037710: 766f 6b65 206d 6f72 6520 7468 616e 206f voke more than o │ │ │ │ │ +00037720: 6e65 2069 6e73 7461 6e63 6520 6f66 2027 ne instance of ' │ │ │ │ │ +00037730: 7961 6363 270a 7369 6d75 6c74 616e 656f yacc'.simultaneo │ │ │ │ │ +00037740: 7573 6c79 2e29 0a0a 2020 2046 6f72 2027 usly.).. For ' │ │ │ │ │ +00037750: 7961 6363 272c 2073 696d 706c 7920 6d61 yacc', simply ma │ │ │ │ │ +00037760: 6e61 6769 6e67 206c 6f63 6b69 6e67 2069 naging locking i │ │ │ │ │ +00037770: 7320 696e 7375 6666 6963 6965 6e74 2e20 s insufficient. │ │ │ │ │ +00037780: 2054 6865 206f 7574 7075 7420 6f66 0a27 The output of.' │ │ │ │ │ +00037790: 7961 6363 2720 616c 7761 7973 2075 7365 yacc' always use │ │ │ │ │ +000377a0: 7320 7468 6520 7361 6d65 2073 796d 626f s the same symbo │ │ │ │ │ +000377b0: 6c20 6e61 6d65 7320 696e 7465 726e 616c l names internal │ │ │ │ │ +000377c0: 6c79 2c20 736f 2069 7420 6973 6e27 740a ly, so it isn't. │ │ │ │ │ +000377d0: 706f 7373 6962 6c65 2074 6f20 6c69 6e6b possible to link │ │ │ │ │ +000377e0: 2074 776f 2027 7961 6363 2720 7061 7273 two 'yacc' pars │ │ │ │ │ +000377f0: 6572 7320 696e 746f 2074 6865 2073 616d ers into the sam │ │ │ │ │ +00037800: 6520 6578 6563 7574 6162 6c65 2e0a 0a20 e executable... │ │ │ │ │ +00037810: 2020 5765 2072 6563 6f6d 6d65 6e64 2075 We recommend u │ │ │ │ │ +00037820: 7369 6e67 2074 6865 2066 6f6c 6c6f 7769 sing the followi │ │ │ │ │ +00037830: 6e67 2072 656e 616d 696e 6720 6861 636b ng renaming hack │ │ │ │ │ +00037840: 2075 7365 6420 696e 2027 6764 6227 3a0a used in 'gdb':. │ │ │ │ │ +00037850: 2020 2020 2023 6465 6669 6e65 2079 796d #define yym │ │ │ │ │ +00037860: 6178 6465 7074 6820 635f 6d61 7864 6570 axdepth c_maxdep │ │ │ │ │ +00037870: 7468 0a20 2020 2020 2364 6566 696e 6520 th. #define │ │ │ │ │ +00037880: 7979 7061 7273 6520 635f 7061 7273 650a yyparse c_parse. │ │ │ │ │ +00037890: 2020 2020 2023 6465 6669 6e65 2079 796c #define yyl │ │ │ │ │ +000378a0: 6578 2020 2063 5f6c 6578 0a20 2020 2020 ex c_lex. │ │ │ │ │ +000378b0: 2364 6566 696e 6520 7979 6572 726f 7220 #define yyerror │ │ │ │ │ +000378c0: 635f 6572 726f 720a 2020 2020 2023 6465 c_error. #de │ │ │ │ │ +000378d0: 6669 6e65 2079 796c 7661 6c20 2063 5f6c fine yylval c_l │ │ │ │ │ +000378e0: 7661 6c0a 2020 2020 2023 6465 6669 6e65 val. #define │ │ │ │ │ +000378f0: 2079 7963 6861 7220 2063 5f63 6861 720a yychar c_char. │ │ │ │ │ +00037900: 2020 2020 2023 6465 6669 6e65 2079 7964 #define yyd │ │ │ │ │ +00037910: 6562 7567 2063 5f64 6562 7567 0a20 2020 ebug c_debug. │ │ │ │ │ +00037920: 2020 2364 6566 696e 6520 7979 7061 6374 #define yypact │ │ │ │ │ +00037930: 2020 635f 7061 6374 0a20 2020 2020 2364 c_pact. #d │ │ │ │ │ +00037940: 6566 696e 6520 7979 7231 2020 2020 635f efine yyr1 c_ │ │ │ │ │ +00037950: 7231 0a20 2020 2020 2364 6566 696e 6520 r1. #define │ │ │ │ │ +00037960: 7979 7232 2020 2020 635f 7232 0a20 2020 yyr2 c_r2. │ │ │ │ │ +00037970: 2020 2364 6566 696e 6520 7979 6465 6620 #define yydef │ │ │ │ │ +00037980: 2020 635f 6465 660a 2020 2020 2023 6465 c_def. #de │ │ │ │ │ +00037990: 6669 6e65 2079 7963 686b 2020 2063 5f63 fine yychk c_c │ │ │ │ │ +000379a0: 686b 0a20 2020 2020 2364 6566 696e 6520 hk. #define │ │ │ │ │ +000379b0: 7979 7067 6f20 2020 635f 7067 6f0a 2020 yypgo c_pgo. │ │ │ │ │ +000379c0: 2020 2023 6465 6669 6e65 2079 7961 6374 #define yyact │ │ │ │ │ +000379d0: 2020 2063 5f61 6374 0a20 2020 2020 2364 c_act. #d │ │ │ │ │ +000379e0: 6566 696e 6520 7979 6578 6361 2020 635f efine yyexca c_ │ │ │ │ │ +000379f0: 6578 6361 0a20 2020 2020 2364 6566 696e exca. #defin │ │ │ │ │ +00037a00: 6520 7979 6572 7266 6c61 6720 635f 6572 e yyerrflag c_er │ │ │ │ │ +00037a10: 7266 6c61 670a 2020 2020 2023 6465 6669 rflag. #defi │ │ │ │ │ +00037a20: 6e65 2079 796e 6572 7273 2063 5f6e 6572 ne yynerrs c_ner │ │ │ │ │ +00037a30: 7273 0a20 2020 2020 2364 6566 696e 6520 rs. #define │ │ │ │ │ +00037a40: 7979 7073 2020 2020 635f 7073 0a20 2020 yyps c_ps. │ │ │ │ │ +00037a50: 2020 2364 6566 696e 6520 7979 7076 2020 #define yypv │ │ │ │ │ +00037a60: 2020 635f 7076 0a20 2020 2020 2364 6566 c_pv. #def │ │ │ │ │ +00037a70: 696e 6520 7979 7320 2020 2020 635f 730a ine yys c_s. │ │ │ │ │ +00037a80: 2020 2020 2023 6465 6669 6e65 2079 795f #define yy_ │ │ │ │ │ +00037a90: 7979 7320 2063 5f79 7973 0a20 2020 2020 yys c_yys. │ │ │ │ │ +00037aa0: 2364 6566 696e 6520 7979 7374 6174 6520 #define yystate │ │ │ │ │ +00037ab0: 635f 7374 6174 650a 2020 2020 2023 6465 c_state. #de │ │ │ │ │ +00037ac0: 6669 6e65 2079 7974 6d70 2020 2063 5f74 fine yytmp c_t │ │ │ │ │ +00037ad0: 6d70 0a20 2020 2020 2364 6566 696e 6520 mp. #define │ │ │ │ │ +00037ae0: 7979 7620 2020 2020 635f 760a 2020 2020 yyv c_v. │ │ │ │ │ +00037af0: 2023 6465 6669 6e65 2079 795f 7979 7620 #define yy_yyv │ │ │ │ │ +00037b00: 2063 5f79 7976 0a20 2020 2020 2364 6566 c_yyv. #def │ │ │ │ │ +00037b10: 696e 6520 7979 7661 6c20 2020 635f 7661 ine yyval c_va │ │ │ │ │ +00037b20: 6c0a 2020 2020 2023 6465 6669 6e65 2079 l. #define y │ │ │ │ │ +00037b30: 796c 6c6f 6320 2063 5f6c 6c6f 630a 2020 ylloc c_lloc. │ │ │ │ │ +00037b40: 2020 2023 6465 6669 6e65 2079 7972 6564 #define yyred │ │ │ │ │ +00037b50: 7320 2063 5f72 6564 730a 2020 2020 2023 s c_reds. # │ │ │ │ │ +00037b60: 6465 6669 6e65 2079 7974 6f6b 7320 2063 define yytoks c │ │ │ │ │ +00037b70: 5f74 6f6b 730a 2020 2020 2023 6465 6669 _toks. #defi │ │ │ │ │ +00037b80: 6e65 2079 796c 6873 2020 2063 5f79 796c ne yylhs c_yyl │ │ │ │ │ +00037b90: 6873 0a20 2020 2020 2364 6566 696e 6520 hs. #define │ │ │ │ │ +00037ba0: 7979 6c65 6e20 2020 635f 7979 6c65 6e0a yylen c_yylen. │ │ │ │ │ +00037bb0: 2020 2020 2023 6465 6669 6e65 2079 7964 #define yyd │ │ │ │ │ +00037bc0: 6566 7265 6420 635f 7979 6465 6672 6564 efred c_yydefred │ │ │ │ │ +00037bd0: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ +00037be0: 6467 6f74 6f20 2063 5f79 7964 676f 746f dgoto c_yydgoto │ │ │ │ │ +00037bf0: 0a20 2020 2020 2364 6566 696e 6520 7979 . #define yy │ │ │ │ │ +00037c00: 7369 6e64 6578 2063 5f79 7973 696e 6465 sindex c_yysinde │ │ │ │ │ +00037c10: 780a 2020 2020 2023 6465 6669 6e65 2079 x. #define y │ │ │ │ │ +00037c20: 7972 696e 6465 7820 635f 7979 7269 6e64 yrindex c_yyrind │ │ │ │ │ +00037c30: 6578 0a20 2020 2020 2364 6566 696e 6520 ex. #define │ │ │ │ │ +00037c40: 7979 6769 6e64 6578 2063 5f79 7967 696e yygindex c_yygin │ │ │ │ │ +00037c50: 6465 780a 2020 2020 2023 6465 6669 6e65 dex. #define │ │ │ │ │ +00037c60: 2079 7974 6162 6c65 2020 635f 7979 7461 yytable c_yyta │ │ │ │ │ +00037c70: 626c 650a 2020 2020 2023 6465 6669 6e65 ble. #define │ │ │ │ │ +00037c80: 2079 7963 6865 636b 2020 635f 7979 6368 yycheck c_yych │ │ │ │ │ +00037c90: 6563 6b0a 2020 2020 2023 6465 6669 6e65 eck. #define │ │ │ │ │ +00037ca0: 2079 796e 616d 6520 2020 635f 7979 6e61 yyname c_yyna │ │ │ │ │ +00037cb0: 6d65 0a20 2020 2020 2364 6566 696e 6520 me. #define │ │ │ │ │ +00037cc0: 7979 7275 6c65 2020 2063 5f79 7972 756c yyrule c_yyrul │ │ │ │ │ +00037cd0: 650a 0a20 2020 466f 7220 6561 6368 2064 e.. For each d │ │ │ │ │ +00037ce0: 6566 696e 652c 2072 6570 6c61 6365 2074 efine, replace t │ │ │ │ │ +00037cf0: 6865 2027 635f 2720 7072 6566 6978 2077 he 'c_' prefix w │ │ │ │ │ +00037d00: 6974 6820 7768 6174 6576 6572 2079 6f75 ith whatever you │ │ │ │ │ +00037d10: 206c 696b 652e 0a54 6865 7365 2064 6566 like..These def │ │ │ │ │ +00037d20: 696e 6573 2077 6f72 6b20 666f 7220 2762 ines work for 'b │ │ │ │ │ +00037d30: 6973 6f6e 272c 2027 6279 6163 6327 2c20 ison', 'byacc', │ │ │ │ │ +00037d40: 616e 6420 7472 6164 6974 696f 6e61 6c20 and traditional │ │ │ │ │ +00037d50: 2779 6163 6327 732e 2020 4966 0a79 6f75 'yacc's. If.you │ │ │ │ │ +00037d60: 2066 696e 6420 6120 7061 7273 6572 2067 find a parser g │ │ │ │ │ +00037d70: 656e 6572 6174 6f72 2074 6861 7420 7573 enerator that us │ │ │ │ │ +00037d80: 6573 2061 2073 796d 626f 6c20 6e6f 7420 es a symbol not │ │ │ │ │ +00037d90: 636f 7665 7265 6420 6865 7265 2c20 706c covered here, pl │ │ │ │ │ +00037da0: 6561 7365 0a72 6570 6f72 7420 7468 6520 ease.report the │ │ │ │ │ +00037db0: 6e65 7720 6e61 6d65 2073 6f20 6974 2063 new name so it c │ │ │ │ │ +00037dc0: 616e 2062 6520 6164 6465 6420 746f 2074 an be added to t │ │ │ │ │ +00037dd0: 6865 206c 6973 742e 0a0a 2020 202d 2d2d he list... --- │ │ │ │ │ +00037de0: 2d2d 2d2d 2d2d 2d20 466f 6f74 6e6f 7465 ------- Footnote │ │ │ │ │ +00037df0: 7320 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 s ----------.. │ │ │ │ │ +00037e00: 2028 3129 2050 6c65 6173 6520 6e6f 7465 (1) Please note │ │ │ │ │ +00037e10: 2074 6861 7420 2761 7574 6f6d 616b 6527 that 'automake' │ │ │ │ │ +00037e20: 2072 6563 6f67 6e69 7a65 7320 272d 6427 recognizes '-d' │ │ │ │ │ +00037e30: 2069 6e20 2741 4d5f 5946 4c41 4753 2720 in 'AM_YFLAGS' │ │ │ │ │ +00037e40: 6f6e 6c79 0a69 6620 6974 2069 7320 6e6f only.if it is no │ │ │ │ │ +00037e50: 7420 636c 7573 7465 7265 6420 7769 7468 t clustered with │ │ │ │ │ +00037e60: 206f 7468 6572 206f 7074 696f 6e73 3b20 other options; │ │ │ │ │ +00037e70: 666f 7220 6578 616d 706c 652c 2069 7420 for example, it │ │ │ │ │ +00037e80: 776f 6e27 7420 6265 0a72 6563 6f67 6e69 won't be.recogni │ │ │ │ │ +00037e90: 7a65 6420 6966 2027 414d 5f59 464c 4147 zed if 'AM_YFLAG │ │ │ │ │ +00037ea0: 5327 2069 7320 272d 6474 272c 2062 7574 S' is '-dt', but │ │ │ │ │ +00037eb0: 2069 7420 7769 6c6c 2062 6520 6966 2027 it will be if ' │ │ │ │ │ +00037ec0: 414d 5f59 464c 4147 5327 2069 7320 272d AM_YFLAGS' is '- │ │ │ │ │ +00037ed0: 640a 2d74 2720 6f72 2027 2d64 202d 7427 d.-t' or '-d -t' │ │ │ │ │ +00037ee0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +00037ef0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +00037f00: 6f64 653a 2043 2b2b 2053 7570 706f 7274 ode: C++ Support │ │ │ │ │ +00037f10: 2c20 204e 6578 743a 204f 626a 6563 7469 , Next: Objecti │ │ │ │ │ +00037f20: 7665 2043 2053 7570 706f 7274 2c20 2050 ve C Support, P │ │ │ │ │ +00037f30: 7265 763a 2059 6163 6320 616e 6420 4c65 rev: Yacc and Le │ │ │ │ │ +00037f40: 782c 2020 5570 3a20 5072 6f67 7261 6d73 x, Up: Programs │ │ │ │ │ +00037f50: 0a0a 382e 3920 432b 2b20 5375 7070 6f72 ..8.9 C++ Suppor │ │ │ │ │ +00037f60: 740a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d t.============== │ │ │ │ │ +00037f70: 3d0a 0a41 7574 6f6d 616b 6520 696e 636c =..Automake incl │ │ │ │ │ +00037f80: 7564 6573 2066 756c 6c20 7375 7070 6f72 udes full suppor │ │ │ │ │ +00037f90: 7420 666f 7220 432b 2b2e 0a0a 2020 2041 t for C++... A │ │ │ │ │ +00037fa0: 6e79 2070 6163 6b61 6765 2069 6e63 6c75 ny package inclu │ │ │ │ │ +00037fb0: 6469 6e67 2043 2b2b 2063 6f64 6520 6d75 ding C++ code mu │ │ │ │ │ +00037fc0: 7374 2064 6566 696e 6520 7468 6520 6f75 st define the ou │ │ │ │ │ +00037fd0: 7470 7574 2076 6172 6961 626c 6520 2743 tput variable 'C │ │ │ │ │ +00037fe0: 5858 270a 696e 2027 636f 6e66 6967 7572 XX'.in 'configur │ │ │ │ │ +00037ff0: 652e 6163 273b 2074 6865 2073 696d 706c e.ac'; the simpl │ │ │ │ │ +00038000: 6573 7420 7761 7920 746f 2064 6f20 7468 est way to do th │ │ │ │ │ +00038010: 6973 2069 7320 746f 2075 7365 2074 6865 is is to use the │ │ │ │ │ +00038020: 0a27 4143 5f50 524f 475f 4358 5827 206d .'AC_PROG_CXX' m │ │ │ │ │ +00038030: 6163 726f 2028 2a6e 6f74 6520 5061 7274 acro (*note Part │ │ │ │ │ +00038040: 6963 756c 6172 2050 726f 6772 616d 2043 icular Program C │ │ │ │ │ +00038050: 6865 636b 733a 0a28 6175 746f 636f 6e66 hecks:.(autoconf │ │ │ │ │ +00038060: 2950 6172 7469 6375 6c61 7220 5072 6f67 )Particular Prog │ │ │ │ │ +00038070: 7261 6d73 2e29 2e0a 0a20 2020 4120 6665 rams.)... A fe │ │ │ │ │ +00038080: 7720 6164 6469 7469 6f6e 616c 2076 6172 w additional var │ │ │ │ │ +00038090: 6961 626c 6573 2061 7265 2064 6566 696e iables are defin │ │ │ │ │ +000380a0: 6564 2077 6865 6e20 6120 432b 2b20 736f ed when a C++ so │ │ │ │ │ +000380b0: 7572 6365 2066 696c 6520 6973 0a73 6565 urce file is.see │ │ │ │ │ +000380c0: 6e3a 0a0a 2743 5858 270a 2020 2020 2054 n:..'CXX'. T │ │ │ │ │ +000380d0: 6865 206e 616d 6520 6f66 2074 6865 2043 he name of the C │ │ │ │ │ +000380e0: 2b2b 2063 6f6d 7069 6c65 722e 0a0a 2743 ++ compiler...'C │ │ │ │ │ +000380f0: 5858 464c 4147 5327 0a20 2020 2020 416e XXFLAGS'. An │ │ │ │ │ +00038100: 7920 666c 6167 7320 746f 2070 6173 7320 y flags to pass │ │ │ │ │ +00038110: 746f 2074 6865 2043 2b2b 2063 6f6d 7069 to the C++ compi │ │ │ │ │ +00038120: 6c65 722e 0a0a 2741 4d5f 4358 5846 4c41 ler...'AM_CXXFLA │ │ │ │ │ +00038130: 4753 270a 2020 2020 2054 6865 206d 6169 GS'. The mai │ │ │ │ │ +00038140: 6e74 6169 6e65 7227 7320 7661 7269 616e ntainer's varian │ │ │ │ │ +00038150: 7420 6f66 2027 4358 5846 4c41 4753 272e t of 'CXXFLAGS'. │ │ │ │ │ +00038160: 0a0a 2743 5858 434f 4d50 494c 4527 0a20 ..'CXXCOMPILE'. │ │ │ │ │ +00038170: 2020 2020 5468 6520 636f 6d6d 616e 6420 The command │ │ │ │ │ +00038180: 7573 6564 2074 6f20 6163 7475 616c 6c79 used to actually │ │ │ │ │ +00038190: 2063 6f6d 7069 6c65 2061 2043 2b2b 2073 compile a C++ s │ │ │ │ │ +000381a0: 6f75 7263 6520 6669 6c65 2e20 2054 6865 ource file. The │ │ │ │ │ +000381b0: 2066 696c 650a 2020 2020 206e 616d 6520 file. name │ │ │ │ │ +000381c0: 6973 2061 7070 656e 6465 6420 746f 2066 is appended to f │ │ │ │ │ +000381d0: 6f72 6d20 7468 6520 636f 6d70 6c65 7465 orm the complete │ │ │ │ │ +000381e0: 2063 6f6d 6d61 6e64 206c 696e 652e 0a0a command line... │ │ │ │ │ +000381f0: 2743 5858 4c49 4e4b 270a 2020 2020 2054 'CXXLINK'. T │ │ │ │ │ +00038200: 6865 2063 6f6d 6d61 6e64 2075 7365 6420 he command used │ │ │ │ │ +00038210: 746f 2061 6374 7561 6c6c 7920 6c69 6e6b to actually link │ │ │ │ │ +00038220: 2061 2043 2b2b 2070 726f 6772 616d 2e0a a C++ program.. │ │ │ │ │ +00038230: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +00038240: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +00038250: 6465 3a20 4f62 6a65 6374 6976 6520 4320 de: Objective C │ │ │ │ │ +00038260: 5375 7070 6f72 742c 2020 4e65 7874 3a20 Support, Next: │ │ │ │ │ +00038270: 556e 6966 6965 6420 5061 7261 6c6c 656c Unified Parallel │ │ │ │ │ +00038280: 2043 2053 7570 706f 7274 2c20 2050 7265 C Support, Pre │ │ │ │ │ +00038290: 763a 2043 2b2b 2053 7570 706f 7274 2c20 v: C++ Support, │ │ │ │ │ +000382a0: 2055 703a 2050 726f 6772 616d 730a 0a38 Up: Programs..8 │ │ │ │ │ +000382b0: 2e31 3020 4f62 6a65 6374 6976 6520 4320 .10 Objective C │ │ │ │ │ +000382c0: 5375 7070 6f72 740a 3d3d 3d3d 3d3d 3d3d Support.======== │ │ │ │ │ +000382d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000382e0: 0a0a 4175 746f 6d61 6b65 2069 6e63 6c75 ..Automake inclu │ │ │ │ │ +000382f0: 6465 7320 736f 6d65 2073 7570 706f 7274 des some support │ │ │ │ │ +00038300: 2066 6f72 204f 626a 6563 7469 7665 2043 for Objective C │ │ │ │ │ +00038310: 2e0a 0a20 2020 416e 7920 7061 636b 6167 ... Any packag │ │ │ │ │ +00038320: 6520 696e 636c 7564 696e 6720 4f62 6a65 e including Obje │ │ │ │ │ +00038330: 6374 6976 6520 4320 636f 6465 206d 7573 ctive C code mus │ │ │ │ │ +00038340: 7420 6465 6669 6e65 2074 6865 206f 7574 t define the out │ │ │ │ │ +00038350: 7075 740a 7661 7269 6162 6c65 2027 4f42 put.variable 'OB │ │ │ │ │ +00038360: 4a43 2720 696e 2027 636f 6e66 6967 7572 JC' in 'configur │ │ │ │ │ +00038370: 652e 6163 273b 2074 6865 2073 696d 706c e.ac'; the simpl │ │ │ │ │ +00038380: 6573 7420 7761 7920 746f 2064 6f20 7468 est way to do th │ │ │ │ │ +00038390: 6973 2069 7320 746f 2075 7365 0a74 6865 is is to use.the │ │ │ │ │ +000383a0: 2027 4143 5f50 524f 475f 4f42 4a43 2720 'AC_PROG_OBJC' │ │ │ │ │ +000383b0: 6d61 6372 6f20 282a 6e6f 7465 2050 6172 macro (*note Par │ │ │ │ │ +000383c0: 7469 6375 6c61 7220 5072 6f67 7261 6d20 ticular Program │ │ │ │ │ +000383d0: 4368 6563 6b73 3a0a 2861 7574 6f63 6f6e Checks:.(autocon │ │ │ │ │ +000383e0: 6629 5061 7274 6963 756c 6172 2050 726f f)Particular Pro │ │ │ │ │ +000383f0: 6772 616d 732e 292e 0a0a 2020 2041 2066 grams.)... A f │ │ │ │ │ +00038400: 6577 2061 6464 6974 696f 6e61 6c20 7661 ew additional va │ │ │ │ │ +00038410: 7269 6162 6c65 7320 6172 6520 6465 6669 riables are defi │ │ │ │ │ +00038420: 6e65 6420 7768 656e 2061 6e20 4f62 6a65 ned when an Obje │ │ │ │ │ +00038430: 6374 6976 6520 4320 736f 7572 6365 0a66 ctive C source.f │ │ │ │ │ +00038440: 696c 6520 6973 2073 6565 6e3a 0a0a 274f ile is seen:..'O │ │ │ │ │ +00038450: 424a 4327 0a20 2020 2020 5468 6520 6e61 BJC'. The na │ │ │ │ │ +00038460: 6d65 206f 6620 7468 6520 4f62 6a65 6374 me of the Object │ │ │ │ │ +00038470: 6976 6520 4320 636f 6d70 696c 6572 2e0a ive C compiler.. │ │ │ │ │ +00038480: 0a27 4f42 4a43 464c 4147 5327 0a20 2020 .'OBJCFLAGS'. │ │ │ │ │ +00038490: 2020 416e 7920 666c 6167 7320 746f 2070 Any flags to p │ │ │ │ │ +000384a0: 6173 7320 746f 2074 6865 204f 626a 6563 ass to the Objec │ │ │ │ │ +000384b0: 7469 7665 2043 2063 6f6d 7069 6c65 722e tive C compiler. │ │ │ │ │ +000384c0: 0a0a 2741 4d5f 4f42 4a43 464c 4147 5327 ..'AM_OBJCFLAGS' │ │ │ │ │ +000384d0: 0a20 2020 2020 5468 6520 6d61 696e 7461 . The mainta │ │ │ │ │ +000384e0: 696e 6572 2773 2076 6172 6961 6e74 206f iner's variant o │ │ │ │ │ +000384f0: 6620 274f 424a 4346 4c41 4753 272e 0a0a f 'OBJCFLAGS'... │ │ │ │ │ +00038500: 274f 424a 4343 4f4d 5049 4c45 270a 2020 'OBJCCOMPILE'. │ │ │ │ │ +00038510: 2020 2054 6865 2063 6f6d 6d61 6e64 2075 The command u │ │ │ │ │ +00038520: 7365 6420 746f 2061 6374 7561 6c6c 7920 sed to actually │ │ │ │ │ +00038530: 636f 6d70 696c 6520 616e 204f 626a 6563 compile an Objec │ │ │ │ │ +00038540: 7469 7665 2043 2073 6f75 7263 6520 6669 tive C source fi │ │ │ │ │ +00038550: 6c65 2e0a 2020 2020 2054 6865 2066 696c le.. The fil │ │ │ │ │ +00038560: 6520 6e61 6d65 2069 7320 6170 7065 6e64 e name is append │ │ │ │ │ +00038570: 6564 2074 6f20 666f 726d 2074 6865 2063 ed to form the c │ │ │ │ │ +00038580: 6f6d 706c 6574 6520 636f 6d6d 616e 6420 omplete command │ │ │ │ │ +00038590: 6c69 6e65 2e0a 0a27 4f42 4a43 4c49 4e4b line...'OBJCLINK │ │ │ │ │ +000385a0: 270a 2020 2020 2054 6865 2063 6f6d 6d61 '. The comma │ │ │ │ │ +000385b0: 6e64 2075 7365 6420 746f 2061 6374 7561 nd used to actua │ │ │ │ │ +000385c0: 6c6c 7920 6c69 6e6b 2061 6e20 4f62 6a65 lly link an Obje │ │ │ │ │ +000385d0: 6374 6976 6520 4320 7072 6f67 7261 6d2e ctive C program. │ │ │ │ │ +000385e0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +000385f0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +00038600: 6f64 653a 2055 6e69 6669 6564 2050 6172 ode: Unified Par │ │ │ │ │ +00038610: 616c 6c65 6c20 4320 5375 7070 6f72 742c allel C Support, │ │ │ │ │ +00038620: 2020 4e65 7874 3a20 4173 7365 6d62 6c79 Next: Assembly │ │ │ │ │ +00038630: 2053 7570 706f 7274 2c20 2050 7265 763a Support, Prev: │ │ │ │ │ +00038640: 204f 626a 6563 7469 7665 2043 2053 7570 Objective C Sup │ │ │ │ │ +00038650: 706f 7274 2c20 2055 703a 2050 726f 6772 port, Up: Progr │ │ │ │ │ +00038660: 616d 730a 0a38 2e31 3120 556e 6966 6965 ams..8.11 Unifie │ │ │ │ │ +00038670: 6420 5061 7261 6c6c 656c 2043 2053 7570 d Parallel C Sup │ │ │ │ │ +00038680: 706f 7274 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d port.=========== │ │ │ │ │ 00038690: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000386a0: 3d3d 0a0a 4175 746f 6d61 6b65 2069 6e63 ==..Automake inc │ │ │ │ │ -000386b0: 6c75 6465 7320 736f 6d65 2073 7570 706f ludes some suppo │ │ │ │ │ -000386c0: 7274 2066 6f72 2055 6e69 6669 6564 2050 rt for Unified P │ │ │ │ │ -000386d0: 6172 616c 6c65 6c20 432e 0a0a 2020 2041 arallel C... A │ │ │ │ │ -000386e0: 6e79 2070 6163 6b61 6765 2069 6e63 6c75 ny package inclu │ │ │ │ │ -000386f0: 6469 6e67 2055 6e69 6669 6564 2050 6172 ding Unified Par │ │ │ │ │ -00038700: 616c 6c65 6c20 4320 636f 6465 206d 7573 allel C code mus │ │ │ │ │ -00038710: 7420 6465 6669 6e65 2074 6865 206f 7574 t define the out │ │ │ │ │ -00038720: 7075 740a 7661 7269 6162 6c65 2027 5550 put.variable 'UP │ │ │ │ │ -00038730: 4327 2069 6e20 2763 6f6e 6669 6775 7265 C' in 'configure │ │ │ │ │ -00038740: 2e61 6327 3b20 7468 6520 7369 6d70 6c65 .ac'; the simple │ │ │ │ │ -00038750: 7374 2077 6179 2074 6f20 646f 2074 6869 st way to do thi │ │ │ │ │ -00038760: 7320 6973 2074 6f20 7573 650a 7468 6520 s is to use.the │ │ │ │ │ -00038770: 2741 4d5f 5052 4f47 5f55 5043 2720 6d61 'AM_PROG_UPC' ma │ │ │ │ │ -00038780: 6372 6f20 282a 6e6f 7465 2050 7562 6c69 cro (*note Publi │ │ │ │ │ -00038790: 6320 4d61 6372 6f73 3a3a 292e 0a0a 2020 c Macros::)... │ │ │ │ │ -000387a0: 2041 2066 6577 2061 6464 6974 696f 6e61 A few additiona │ │ │ │ │ -000387b0: 6c20 7661 7269 6162 6c65 7320 6172 6520 l variables are │ │ │ │ │ -000387c0: 6465 6669 6e65 6420 7768 656e 2061 2055 defined when a U │ │ │ │ │ -000387d0: 6e69 6669 6564 2050 6172 616c 6c65 6c20 nified Parallel │ │ │ │ │ -000387e0: 430a 736f 7572 6365 2066 696c 6520 6973 C.source file is │ │ │ │ │ -000387f0: 2073 6565 6e3a 0a0a 2755 5043 270a 2020 seen:..'UPC'. │ │ │ │ │ -00038800: 2020 2054 6865 206e 616d 6520 6f66 2074 The name of t │ │ │ │ │ -00038810: 6865 2055 6e69 6669 6564 2050 6172 616c he Unified Paral │ │ │ │ │ -00038820: 6c65 6c20 4320 636f 6d70 696c 6572 2e0a lel C compiler.. │ │ │ │ │ -00038830: 0a27 5550 4346 4c41 4753 270a 2020 2020 .'UPCFLAGS'. │ │ │ │ │ -00038840: 2041 6e79 2066 6c61 6773 2074 6f20 7061 Any flags to pa │ │ │ │ │ -00038850: 7373 2074 6f20 7468 6520 556e 6966 6965 ss to the Unifie │ │ │ │ │ -00038860: 6420 5061 7261 6c6c 656c 2043 2063 6f6d d Parallel C com │ │ │ │ │ -00038870: 7069 6c65 722e 0a0a 2741 4d5f 5550 4346 piler...'AM_UPCF │ │ │ │ │ -00038880: 4c41 4753 270a 2020 2020 2054 6865 206d LAGS'. The m │ │ │ │ │ -00038890: 6169 6e74 6169 6e65 7227 7320 7661 7269 aintainer's vari │ │ │ │ │ -000388a0: 616e 7420 6f66 2027 5550 4346 4c41 4753 ant of 'UPCFLAGS │ │ │ │ │ -000388b0: 272e 0a0a 2755 5043 434f 4d50 494c 4527 '...'UPCCOMPILE' │ │ │ │ │ -000388c0: 0a20 2020 2020 5468 6520 636f 6d6d 616e . The comman │ │ │ │ │ -000388d0: 6420 7573 6564 2074 6f20 6163 7475 616c d used to actual │ │ │ │ │ -000388e0: 6c79 2063 6f6d 7069 6c65 2061 2055 6e69 ly compile a Uni │ │ │ │ │ -000388f0: 6669 6564 2050 6172 616c 6c65 6c20 4320 fied Parallel C │ │ │ │ │ -00038900: 736f 7572 6365 0a20 2020 2020 6669 6c65 source. file │ │ │ │ │ -00038910: 2e20 2054 6865 2066 696c 6520 6e61 6d65 . The file name │ │ │ │ │ -00038920: 2069 7320 6170 7065 6e64 6564 2074 6f20 is appended to │ │ │ │ │ -00038930: 666f 726d 2074 6865 2063 6f6d 706c 6574 form the complet │ │ │ │ │ -00038940: 6520 636f 6d6d 616e 6420 6c69 6e65 2e0a e command line.. │ │ │ │ │ -00038950: 0a27 5550 434c 494e 4b27 0a20 2020 2020 .'UPCLINK'. │ │ │ │ │ -00038960: 5468 6520 636f 6d6d 616e 6420 7573 6564 The command used │ │ │ │ │ -00038970: 2074 6f20 6163 7475 616c 6c79 206c 696e to actually lin │ │ │ │ │ -00038980: 6b20 6120 556e 6966 6965 6420 5061 7261 k a Unified Para │ │ │ │ │ -00038990: 6c6c 656c 2043 2070 726f 6772 616d 2e0a llel C program.. │ │ │ │ │ -000389a0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -000389b0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -000389c0: 6465 3a20 4173 7365 6d62 6c79 2053 7570 de: Assembly Sup │ │ │ │ │ -000389d0: 706f 7274 2c20 204e 6578 743a 2046 6f72 port, Next: For │ │ │ │ │ -000389e0: 7472 616e 2037 3720 5375 7070 6f72 742c tran 77 Support, │ │ │ │ │ -000389f0: 2020 5072 6576 3a20 556e 6966 6965 6420 Prev: Unified │ │ │ │ │ -00038a00: 5061 7261 6c6c 656c 2043 2053 7570 706f Parallel C Suppo │ │ │ │ │ -00038a10: 7274 2c20 2055 703a 2050 726f 6772 616d rt, Up: Program │ │ │ │ │ -00038a20: 730a 0a38 2e31 3220 4173 7365 6d62 6c79 s..8.12 Assembly │ │ │ │ │ -00038a30: 2053 7570 706f 7274 0a3d 3d3d 3d3d 3d3d Support.======= │ │ │ │ │ -00038a40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00038a50: 4175 746f 6d61 6b65 2069 6e63 6c75 6465 Automake include │ │ │ │ │ -00038a60: 7320 736f 6d65 2073 7570 706f 7274 2066 s some support f │ │ │ │ │ -00038a70: 6f72 2061 7373 656d 626c 7920 636f 6465 or assembly code │ │ │ │ │ -00038a80: 2e20 2054 6865 7265 2061 7265 2074 776f . There are two │ │ │ │ │ -00038a90: 2066 6f72 6d73 0a6f 6620 6173 7365 6d62 forms.of assemb │ │ │ │ │ -00038aa0: 6c65 7220 6669 6c65 733a 206e 6f72 6d61 ler files: norma │ │ │ │ │ -00038ab0: 6c20 2827 2a2e 7327 2920 616e 6420 7072 l ('*.s') and pr │ │ │ │ │ -00038ac0: 6570 726f 6365 7373 6564 2062 7920 2743 eprocessed by 'C │ │ │ │ │ -00038ad0: 5050 2720 2827 2a2e 5327 206f 720a 272a PP' ('*.S' or.'* │ │ │ │ │ -00038ae0: 2e73 7827 292e 0a0a 2020 2054 6865 2076 .sx')... The v │ │ │ │ │ -00038af0: 6172 6961 626c 6520 2743 4341 5327 2068 ariable 'CCAS' h │ │ │ │ │ -00038b00: 6f6c 6473 2074 6865 206e 616d 6520 6f66 olds the name of │ │ │ │ │ -00038b10: 2074 6865 2063 6f6d 7069 6c65 7220 7573 the compiler us │ │ │ │ │ -00038b20: 6564 2074 6f20 6275 696c 640a 6173 7365 ed to build.asse │ │ │ │ │ -00038b30: 6d62 6c79 2063 6f64 652e 2020 5468 6973 mbly code. This │ │ │ │ │ -00038b40: 2063 6f6d 7069 6c65 7220 6d75 7374 2077 compiler must w │ │ │ │ │ -00038b50: 6f72 6b20 6120 6269 7420 6c69 6b65 2061 ork a bit like a │ │ │ │ │ -00038b60: 2043 2063 6f6d 7069 6c65 723b 2069 6e0a C compiler; in. │ │ │ │ │ -00038b70: 7061 7274 6963 756c 6172 2069 7420 6d75 particular it mu │ │ │ │ │ -00038b80: 7374 2061 6363 6570 7420 272d 6327 2061 st accept '-c' a │ │ │ │ │ -00038b90: 6e64 2027 2d6f 272e 2020 5468 6520 7661 nd '-o'. The va │ │ │ │ │ -00038ba0: 6c75 6573 206f 6620 2743 4341 5346 4c41 lues of 'CCASFLA │ │ │ │ │ -00038bb0: 4753 2720 616e 640a 2741 4d5f 4343 4153 GS' and.'AM_CCAS │ │ │ │ │ -00038bc0: 464c 4147 5327 2028 6f72 2069 7473 2070 FLAGS' (or its p │ │ │ │ │ -00038bd0: 6572 2d74 6172 6765 7420 6465 6669 6e69 er-target defini │ │ │ │ │ -00038be0: 7469 6f6e 2920 6973 2070 6173 7365 6420 tion) is passed │ │ │ │ │ -00038bf0: 746f 2074 6865 0a63 6f6d 7069 6c61 7469 to the.compilati │ │ │ │ │ -00038c00: 6f6e 2e20 2046 6f72 2070 7265 7072 6f63 on. For preproc │ │ │ │ │ -00038c10: 6573 7365 6420 6669 6c65 732c 2027 4445 essed files, 'DE │ │ │ │ │ -00038c20: 4653 272c 2027 4445 4641 554c 545f 494e FS', 'DEFAULT_IN │ │ │ │ │ -00038c30: 434c 5544 4553 272c 0a27 494e 434c 5544 CLUDES',.'INCLUD │ │ │ │ │ -00038c40: 4553 272c 2027 4350 5046 4c41 4753 2720 ES', 'CPPFLAGS' │ │ │ │ │ -00038c50: 616e 6420 2741 4d5f 4350 5046 4c41 4753 and 'AM_CPPFLAGS │ │ │ │ │ -00038c60: 2720 6172 6520 616c 736f 2075 7365 642e ' are also used. │ │ │ │ │ -00038c70: 0a0a 2020 2054 6865 2061 7574 6f63 6f6e .. The autocon │ │ │ │ │ -00038c80: 6620 6d61 6372 6f20 2741 4d5f 5052 4f47 f macro 'AM_PROG │ │ │ │ │ -00038c90: 5f41 5327 2077 696c 6c20 6465 6669 6e65 _AS' will define │ │ │ │ │ -00038ca0: 2027 4343 4153 2720 616e 6420 2743 4341 'CCAS' and 'CCA │ │ │ │ │ -00038cb0: 5346 4c41 4753 270a 666f 7220 796f 7520 SFLAGS'.for you │ │ │ │ │ -00038cc0: 2875 6e6c 6573 7320 7468 6579 2061 7265 (unless they are │ │ │ │ │ -00038cd0: 2061 6c72 6561 6479 2073 6574 2c20 6974 already set, it │ │ │ │ │ -00038ce0: 2073 696d 706c 7920 7365 7473 2027 4343 simply sets 'CC │ │ │ │ │ -00038cf0: 4153 2720 746f 2074 6865 2043 0a63 6f6d AS' to the C.com │ │ │ │ │ -00038d00: 7069 6c65 7220 616e 6420 2743 4341 5346 piler and 'CCASF │ │ │ │ │ -00038d10: 4c41 4753 2720 746f 2074 6865 2043 2063 LAGS' to the C c │ │ │ │ │ -00038d20: 6f6d 7069 6c65 7220 666c 6167 7329 2c20 ompiler flags), │ │ │ │ │ -00038d30: 6275 7420 796f 7520 6172 6520 6672 6565 but you are free │ │ │ │ │ -00038d40: 2074 6f0a 6465 6669 6e65 2074 6865 7365 to.define these │ │ │ │ │ -00038d50: 2076 6172 6961 626c 6573 2062 7920 6f74 variables by ot │ │ │ │ │ -00038d60: 6865 7220 6d65 616e 732e 0a0a 2020 204f her means... O │ │ │ │ │ -00038d70: 6e6c 7920 7468 6520 7375 6666 6978 6573 nly the suffixes │ │ │ │ │ -00038d80: 2027 2e73 272c 2027 2e53 272c 2061 6e64 '.s', '.S', and │ │ │ │ │ -00038d90: 2027 2e73 7827 2061 7265 2072 6563 6f67 '.sx' are recog │ │ │ │ │ -00038da0: 6e69 7a65 6420 6279 2027 6175 746f 6d61 nized by 'automa │ │ │ │ │ -00038db0: 6b65 270a 6173 2062 6569 6e67 2066 696c ke'.as being fil │ │ │ │ │ -00038dc0: 6573 2063 6f6e 7461 696e 696e 6720 6173 es containing as │ │ │ │ │ -00038dd0: 7365 6d62 6c79 2063 6f64 652e 0a0a 1f0a sembly code..... │ │ │ │ │ -00038de0: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ -00038df0: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ -00038e00: 2046 6f72 7472 616e 2037 3720 5375 7070 Fortran 77 Supp │ │ │ │ │ -00038e10: 6f72 742c 2020 4e65 7874 3a20 466f 7274 ort, Next: Fort │ │ │ │ │ -00038e20: 7261 6e20 3978 2053 7570 706f 7274 2c20 ran 9x Support, │ │ │ │ │ -00038e30: 2050 7265 763a 2041 7373 656d 626c 7920 Prev: Assembly │ │ │ │ │ -00038e40: 5375 7070 6f72 742c 2020 5570 3a20 5072 Support, Up: Pr │ │ │ │ │ -00038e50: 6f67 7261 6d73 0a0a 382e 3133 2046 6f72 ograms..8.13 For │ │ │ │ │ -00038e60: 7472 616e 2037 3720 5375 7070 6f72 740a tran 77 Support. │ │ │ │ │ -00038e70: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00038e80: 3d3d 3d3d 3d3d 3d0a 0a41 7574 6f6d 616b =======..Automak │ │ │ │ │ -00038e90: 6520 696e 636c 7564 6573 2066 756c 6c20 e includes full │ │ │ │ │ -00038ea0: 7375 7070 6f72 7420 666f 7220 466f 7274 support for Fort │ │ │ │ │ -00038eb0: 7261 6e20 3737 2e0a 0a20 2020 416e 7920 ran 77... Any │ │ │ │ │ -00038ec0: 7061 636b 6167 6520 696e 636c 7564 696e package includin │ │ │ │ │ -00038ed0: 6720 466f 7274 7261 6e20 3737 2063 6f64 g Fortran 77 cod │ │ │ │ │ -00038ee0: 6520 6d75 7374 2064 6566 696e 6520 7468 e must define th │ │ │ │ │ -00038ef0: 6520 6f75 7470 7574 2076 6172 6961 626c e output variabl │ │ │ │ │ -00038f00: 650a 2746 3737 2720 696e 2027 636f 6e66 e.'F77' in 'conf │ │ │ │ │ -00038f10: 6967 7572 652e 6163 273b 2074 6865 2073 igure.ac'; the s │ │ │ │ │ -00038f20: 696d 706c 6573 7420 7761 7920 746f 2064 implest way to d │ │ │ │ │ -00038f30: 6f20 7468 6973 2069 7320 746f 2075 7365 o this is to use │ │ │ │ │ -00038f40: 2074 6865 0a27 4143 5f50 524f 475f 4637 the.'AC_PROG_F7 │ │ │ │ │ -00038f50: 3727 206d 6163 726f 2028 2a6e 6f74 6520 7' macro (*note │ │ │ │ │ -00038f60: 5061 7274 6963 756c 6172 2050 726f 6772 Particular Progr │ │ │ │ │ -00038f70: 616d 2043 6865 636b 733a 0a28 6175 746f am Checks:.(auto │ │ │ │ │ -00038f80: 636f 6e66 2950 6172 7469 6375 6c61 7220 conf)Particular │ │ │ │ │ -00038f90: 5072 6f67 7261 6d73 2e29 2e0a 0a20 2020 Programs.)... │ │ │ │ │ -00038fa0: 4120 6665 7720 6164 6469 7469 6f6e 616c A few additional │ │ │ │ │ -00038fb0: 2076 6172 6961 626c 6573 2061 7265 2064 variables are d │ │ │ │ │ -00038fc0: 6566 696e 6564 2077 6865 6e20 6120 466f efined when a Fo │ │ │ │ │ -00038fd0: 7274 7261 6e20 3737 2073 6f75 7263 6520 rtran 77 source │ │ │ │ │ -00038fe0: 6669 6c65 0a69 7320 7365 656e 3a0a 0a27 file.is seen:..' │ │ │ │ │ -00038ff0: 4637 3727 0a20 2020 2020 5468 6520 6e61 F77'. The na │ │ │ │ │ -00039000: 6d65 206f 6620 7468 6520 466f 7274 7261 me of the Fortra │ │ │ │ │ -00039010: 6e20 3737 2063 6f6d 7069 6c65 722e 0a0a n 77 compiler... │ │ │ │ │ -00039020: 2746 464c 4147 5327 0a20 2020 2020 416e 'FFLAGS'. An │ │ │ │ │ -00039030: 7920 666c 6167 7320 746f 2070 6173 7320 y flags to pass │ │ │ │ │ -00039040: 746f 2074 6865 2046 6f72 7472 616e 2037 to the Fortran 7 │ │ │ │ │ -00039050: 3720 636f 6d70 696c 6572 2e0a 0a27 414d 7 compiler...'AM │ │ │ │ │ -00039060: 5f46 464c 4147 5327 0a20 2020 2020 5468 _FFLAGS'. Th │ │ │ │ │ -00039070: 6520 6d61 696e 7461 696e 6572 2773 2076 e maintainer's v │ │ │ │ │ -00039080: 6172 6961 6e74 206f 6620 2746 464c 4147 ariant of 'FFLAG │ │ │ │ │ -00039090: 5327 2e0a 0a27 5246 4c41 4753 270a 2020 S'...'RFLAGS'. │ │ │ │ │ -000390a0: 2020 2041 6e79 2066 6c61 6773 2074 6f20 Any flags to │ │ │ │ │ -000390b0: 7061 7373 2074 6f20 7468 6520 5261 7466 pass to the Ratf │ │ │ │ │ -000390c0: 6f72 2063 6f6d 7069 6c65 722e 0a0a 2741 or compiler...'A │ │ │ │ │ -000390d0: 4d5f 5246 4c41 4753 270a 2020 2020 2054 M_RFLAGS'. T │ │ │ │ │ -000390e0: 6865 206d 6169 6e74 6169 6e65 7227 7320 he maintainer's │ │ │ │ │ -000390f0: 7661 7269 616e 7420 6f66 2027 5246 4c41 variant of 'RFLA │ │ │ │ │ -00039100: 4753 272e 0a0a 2746 3737 434f 4d50 494c GS'...'F77COMPIL │ │ │ │ │ -00039110: 4527 0a20 2020 2020 5468 6520 636f 6d6d E'. The comm │ │ │ │ │ -00039120: 616e 6420 7573 6564 2074 6f20 6163 7475 and used to actu │ │ │ │ │ -00039130: 616c 6c79 2063 6f6d 7069 6c65 2061 2046 ally compile a F │ │ │ │ │ -00039140: 6f72 7472 616e 2037 3720 736f 7572 6365 ortran 77 source │ │ │ │ │ -00039150: 2066 696c 652e 2020 5468 650a 2020 2020 file. The. │ │ │ │ │ -00039160: 2066 696c 6520 6e61 6d65 2069 7320 6170 file name is ap │ │ │ │ │ -00039170: 7065 6e64 6564 2074 6f20 666f 726d 2074 pended to form t │ │ │ │ │ -00039180: 6865 2063 6f6d 706c 6574 6520 636f 6d6d he complete comm │ │ │ │ │ -00039190: 616e 6420 6c69 6e65 2e0a 0a27 464c 494e and line...'FLIN │ │ │ │ │ -000391a0: 4b27 0a20 2020 2020 5468 6520 636f 6d6d K'. The comm │ │ │ │ │ -000391b0: 616e 6420 7573 6564 2074 6f20 6163 7475 and used to actu │ │ │ │ │ -000391c0: 616c 6c79 206c 696e 6b20 6120 7075 7265 ally link a pure │ │ │ │ │ -000391d0: 2046 6f72 7472 616e 2037 3720 7072 6f67 Fortran 77 prog │ │ │ │ │ -000391e0: 7261 6d20 6f72 0a20 2020 2020 7368 6172 ram or. shar │ │ │ │ │ -000391f0: 6564 206c 6962 7261 7279 2e0a 0a20 2020 ed library... │ │ │ │ │ -00039200: 4175 746f 6d61 6b65 2063 616e 2068 616e Automake can han │ │ │ │ │ -00039210: 646c 6520 7072 6570 726f 6365 7373 696e dle preprocessin │ │ │ │ │ -00039220: 6720 466f 7274 7261 6e20 3737 2061 6e64 g Fortran 77 and │ │ │ │ │ -00039230: 2052 6174 666f 7220 736f 7572 6365 2066 Ratfor source f │ │ │ │ │ -00039240: 696c 6573 0a69 6e20 6164 6469 7469 6f6e iles.in addition │ │ │ │ │ -00039250: 2074 6f20 636f 6d70 696c 696e 6720 7468 to compiling th │ │ │ │ │ -00039260: 656d 2831 292e 2020 4175 746f 6d61 6b65 em(1). Automake │ │ │ │ │ -00039270: 2061 6c73 6f20 636f 6e74 6169 6e73 2073 also contains s │ │ │ │ │ -00039280: 6f6d 6520 7375 7070 6f72 740a 666f 7220 ome support.for │ │ │ │ │ -00039290: 6372 6561 7469 6e67 2070 726f 6772 616d creating program │ │ │ │ │ -000392a0: 7320 616e 6420 7368 6172 6564 206c 6962 s and shared lib │ │ │ │ │ -000392b0: 7261 7269 6573 2074 6861 7420 6172 6520 raries that are │ │ │ │ │ -000392c0: 6120 6d69 7874 7572 6520 6f66 2046 6f72 a mixture of For │ │ │ │ │ -000392d0: 7472 616e 0a37 3720 616e 6420 6f74 6865 tran.77 and othe │ │ │ │ │ -000392e0: 7220 6c61 6e67 7561 6765 7320 282a 6e6f r languages (*no │ │ │ │ │ -000392f0: 7465 204d 6978 696e 6720 466f 7274 7261 te Mixing Fortra │ │ │ │ │ -00039300: 6e20 3737 2057 6974 6820 4320 616e 6420 n 77 With C and │ │ │ │ │ -00039310: 432b 2b3a 3a29 2e0a 0a20 2020 5468 6573 C++::)... Thes │ │ │ │ │ -00039320: 6520 6973 7375 6573 2061 7265 2063 6f76 e issues are cov │ │ │ │ │ -00039330: 6572 6564 2069 6e20 7468 6520 666f 6c6c ered in the foll │ │ │ │ │ -00039340: 6f77 696e 6720 7365 6374 696f 6e73 2e0a owing sections.. │ │ │ │ │ -00039350: 0a2a 204d 656e 753a 0a0a 2a20 5072 6570 .* Menu:..* Prep │ │ │ │ │ -00039360: 726f 6365 7373 696e 6720 466f 7274 7261 rocessing Fortra │ │ │ │ │ -00039370: 6e20 3737 3a3a 2020 2020 5072 6570 726f n 77:: Prepro │ │ │ │ │ -00039380: 6365 7373 696e 6720 466f 7274 7261 6e20 cessing Fortran │ │ │ │ │ -00039390: 3737 2073 6f75 7263 6573 0a2a 2043 6f6d 77 sources.* Com │ │ │ │ │ -000393a0: 7069 6c69 6e67 2046 6f72 7472 616e 2037 piling Fortran 7 │ │ │ │ │ -000393b0: 3720 4669 6c65 733a 3a20 2043 6f6d 7069 7 Files:: Compi │ │ │ │ │ -000393c0: 6c69 6e67 2046 6f72 7472 616e 2037 3720 ling Fortran 77 │ │ │ │ │ -000393d0: 736f 7572 6365 730a 2a20 4d69 7869 6e67 sources.* Mixing │ │ │ │ │ -000393e0: 2046 6f72 7472 616e 2037 3720 5769 7468 Fortran 77 With │ │ │ │ │ -000393f0: 2043 2061 6e64 2043 2b2b 3a3a 2020 4d69 C and C++:: Mi │ │ │ │ │ -00039400: 7869 6e67 2046 6f72 7472 616e 2037 3720 xing Fortran 77 │ │ │ │ │ -00039410: 5769 7468 2043 2061 6e64 2043 2b2b 0a0a With C and C++.. │ │ │ │ │ -00039420: 2020 202d 2d2d 2d2d 2d2d 2d2d 2d20 466f ---------- Fo │ │ │ │ │ -00039430: 6f74 6e6f 7465 7320 2d2d 2d2d 2d2d 2d2d otnotes -------- │ │ │ │ │ -00039440: 2d2d 0a0a 2020 2028 3129 204d 7563 682c --.. (1) Much, │ │ │ │ │ -00039450: 2069 6620 6e6f 7420 6d6f 7374 2c20 6f66 if not most, of │ │ │ │ │ -00039460: 2074 6865 2069 6e66 6f72 6d61 7469 6f6e the information │ │ │ │ │ -00039470: 2069 6e20 7468 6520 666f 6c6c 6f77 696e in the followin │ │ │ │ │ -00039480: 6720 7365 6374 696f 6e73 0a70 6572 7461 g sections.perta │ │ │ │ │ -00039490: 696e 696e 6720 746f 2070 7265 7072 6f63 ining to preproc │ │ │ │ │ -000394a0: 6573 7369 6e67 2046 6f72 7472 616e 2037 essing Fortran 7 │ │ │ │ │ -000394b0: 3720 7072 6f67 7261 6d73 2077 6173 2074 7 programs was t │ │ │ │ │ -000394c0: 616b 656e 2061 6c6d 6f73 740a 7665 7262 aken almost.verb │ │ │ │ │ -000394d0: 6174 696d 2066 726f 6d20 2a6e 6f74 6520 atim from *note │ │ │ │ │ -000394e0: 4361 7461 6c6f 6775 6520 6f66 2052 756c Catalogue of Rul │ │ │ │ │ -000394f0: 6573 3a20 286d 616b 6529 4361 7461 6c6f es: (make)Catalo │ │ │ │ │ -00039500: 6775 6520 6f66 2052 756c 6573 2e0a 0a1f gue of Rules.... │ │ │ │ │ -00039510: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -00039520: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -00039530: 3a20 5072 6570 726f 6365 7373 696e 6720 : Preprocessing │ │ │ │ │ -00039540: 466f 7274 7261 6e20 3737 2c20 204e 6578 Fortran 77, Nex │ │ │ │ │ -00039550: 743a 2043 6f6d 7069 6c69 6e67 2046 6f72 t: Compiling For │ │ │ │ │ -00039560: 7472 616e 2037 3720 4669 6c65 732c 2020 tran 77 Files, │ │ │ │ │ -00039570: 5570 3a20 466f 7274 7261 6e20 3737 2053 Up: Fortran 77 S │ │ │ │ │ -00039580: 7570 706f 7274 0a0a 382e 3133 2e31 2050 upport..8.13.1 P │ │ │ │ │ -00039590: 7265 7072 6f63 6573 7369 6e67 2046 6f72 reprocessing For │ │ │ │ │ -000395a0: 7472 616e 2037 370a 2d2d 2d2d 2d2d 2d2d tran 77.-------- │ │ │ │ │ +000386a0: 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 2069 ====..Automake i │ │ │ │ │ +000386b0: 6e63 6c75 6465 7320 736f 6d65 2073 7570 ncludes some sup │ │ │ │ │ +000386c0: 706f 7274 2066 6f72 2055 6e69 6669 6564 port for Unified │ │ │ │ │ +000386d0: 2050 6172 616c 6c65 6c20 432e 0a0a 2020 Parallel C... │ │ │ │ │ +000386e0: 2041 6e79 2070 6163 6b61 6765 2069 6e63 Any package inc │ │ │ │ │ +000386f0: 6c75 6469 6e67 2055 6e69 6669 6564 2050 luding Unified P │ │ │ │ │ +00038700: 6172 616c 6c65 6c20 4320 636f 6465 206d arallel C code m │ │ │ │ │ +00038710: 7573 7420 6465 6669 6e65 2074 6865 206f ust define the o │ │ │ │ │ +00038720: 7574 7075 740a 7661 7269 6162 6c65 2027 utput.variable ' │ │ │ │ │ +00038730: 5550 4327 2069 6e20 2763 6f6e 6669 6775 UPC' in 'configu │ │ │ │ │ +00038740: 7265 2e61 6327 3b20 7468 6520 7369 6d70 re.ac'; the simp │ │ │ │ │ +00038750: 6c65 7374 2077 6179 2074 6f20 646f 2074 lest way to do t │ │ │ │ │ +00038760: 6869 7320 6973 2074 6f20 7573 650a 7468 his is to use.th │ │ │ │ │ +00038770: 6520 2741 4d5f 5052 4f47 5f55 5043 2720 e 'AM_PROG_UPC' │ │ │ │ │ +00038780: 6d61 6372 6f20 282a 6e6f 7465 2050 7562 macro (*note Pub │ │ │ │ │ +00038790: 6c69 6320 4d61 6372 6f73 3a3a 292e 0a0a lic Macros::)... │ │ │ │ │ +000387a0: 2020 2041 2066 6577 2061 6464 6974 696f A few additio │ │ │ │ │ +000387b0: 6e61 6c20 7661 7269 6162 6c65 7320 6172 nal variables ar │ │ │ │ │ +000387c0: 6520 6465 6669 6e65 6420 7768 656e 2061 e defined when a │ │ │ │ │ +000387d0: 2055 6e69 6669 6564 2050 6172 616c 6c65 Unified Paralle │ │ │ │ │ +000387e0: 6c20 430a 736f 7572 6365 2066 696c 6520 l C.source file │ │ │ │ │ +000387f0: 6973 2073 6565 6e3a 0a0a 2755 5043 270a is seen:..'UPC'. │ │ │ │ │ +00038800: 2020 2020 2054 6865 206e 616d 6520 6f66 The name of │ │ │ │ │ +00038810: 2074 6865 2055 6e69 6669 6564 2050 6172 the Unified Par │ │ │ │ │ +00038820: 616c 6c65 6c20 4320 636f 6d70 696c 6572 allel C compiler │ │ │ │ │ +00038830: 2e0a 0a27 5550 4346 4c41 4753 270a 2020 ...'UPCFLAGS'. │ │ │ │ │ +00038840: 2020 2041 6e79 2066 6c61 6773 2074 6f20 Any flags to │ │ │ │ │ +00038850: 7061 7373 2074 6f20 7468 6520 556e 6966 pass to the Unif │ │ │ │ │ +00038860: 6965 6420 5061 7261 6c6c 656c 2043 2063 ied Parallel C c │ │ │ │ │ +00038870: 6f6d 7069 6c65 722e 0a0a 2741 4d5f 5550 ompiler...'AM_UP │ │ │ │ │ +00038880: 4346 4c41 4753 270a 2020 2020 2054 6865 CFLAGS'. The │ │ │ │ │ +00038890: 206d 6169 6e74 6169 6e65 7227 7320 7661 maintainer's va │ │ │ │ │ +000388a0: 7269 616e 7420 6f66 2027 5550 4346 4c41 riant of 'UPCFLA │ │ │ │ │ +000388b0: 4753 272e 0a0a 2755 5043 434f 4d50 494c GS'...'UPCCOMPIL │ │ │ │ │ +000388c0: 4527 0a20 2020 2020 5468 6520 636f 6d6d E'. The comm │ │ │ │ │ +000388d0: 616e 6420 7573 6564 2074 6f20 6163 7475 and used to actu │ │ │ │ │ +000388e0: 616c 6c79 2063 6f6d 7069 6c65 2061 2055 ally compile a U │ │ │ │ │ +000388f0: 6e69 6669 6564 2050 6172 616c 6c65 6c20 nified Parallel │ │ │ │ │ +00038900: 4320 736f 7572 6365 0a20 2020 2020 6669 C source. fi │ │ │ │ │ +00038910: 6c65 2e20 2054 6865 2066 696c 6520 6e61 le. The file na │ │ │ │ │ +00038920: 6d65 2069 7320 6170 7065 6e64 6564 2074 me is appended t │ │ │ │ │ +00038930: 6f20 666f 726d 2074 6865 2063 6f6d 706c o form the compl │ │ │ │ │ +00038940: 6574 6520 636f 6d6d 616e 6420 6c69 6e65 ete command line │ │ │ │ │ +00038950: 2e0a 0a27 5550 434c 494e 4b27 0a20 2020 ...'UPCLINK'. │ │ │ │ │ +00038960: 2020 5468 6520 636f 6d6d 616e 6420 7573 The command us │ │ │ │ │ +00038970: 6564 2074 6f20 6163 7475 616c 6c79 206c ed to actually l │ │ │ │ │ +00038980: 696e 6b20 6120 556e 6966 6965 6420 5061 ink a Unified Pa │ │ │ │ │ +00038990: 7261 6c6c 656c 2043 2070 726f 6772 616d rallel C program │ │ │ │ │ +000389a0: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +000389b0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +000389c0: 4e6f 6465 3a20 4173 7365 6d62 6c79 2053 Node: Assembly S │ │ │ │ │ +000389d0: 7570 706f 7274 2c20 204e 6578 743a 2046 upport, Next: F │ │ │ │ │ +000389e0: 6f72 7472 616e 2037 3720 5375 7070 6f72 ortran 77 Suppor │ │ │ │ │ +000389f0: 742c 2020 5072 6576 3a20 556e 6966 6965 t, Prev: Unifie │ │ │ │ │ +00038a00: 6420 5061 7261 6c6c 656c 2043 2053 7570 d Parallel C Sup │ │ │ │ │ +00038a10: 706f 7274 2c20 2055 703a 2050 726f 6772 port, Up: Progr │ │ │ │ │ +00038a20: 616d 730a 0a38 2e31 3220 4173 7365 6d62 ams..8.12 Assemb │ │ │ │ │ +00038a30: 6c79 2053 7570 706f 7274 0a3d 3d3d 3d3d ly Support.===== │ │ │ │ │ +00038a40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00038a50: 0a0a 4175 746f 6d61 6b65 2069 6e63 6c75 ..Automake inclu │ │ │ │ │ +00038a60: 6465 7320 736f 6d65 2073 7570 706f 7274 des some support │ │ │ │ │ +00038a70: 2066 6f72 2061 7373 656d 626c 7920 636f for assembly co │ │ │ │ │ +00038a80: 6465 2e20 2054 6865 7265 2061 7265 2074 de. There are t │ │ │ │ │ +00038a90: 776f 2066 6f72 6d73 0a6f 6620 6173 7365 wo forms.of asse │ │ │ │ │ +00038aa0: 6d62 6c65 7220 6669 6c65 733a 206e 6f72 mbler files: nor │ │ │ │ │ +00038ab0: 6d61 6c20 2827 2a2e 7327 2920 616e 6420 mal ('*.s') and │ │ │ │ │ +00038ac0: 7072 6570 726f 6365 7373 6564 2062 7920 preprocessed by │ │ │ │ │ +00038ad0: 2743 5050 2720 2827 2a2e 5327 206f 720a 'CPP' ('*.S' or. │ │ │ │ │ +00038ae0: 272a 2e73 7827 292e 0a0a 2020 2054 6865 '*.sx')... The │ │ │ │ │ +00038af0: 2076 6172 6961 626c 6520 2743 4341 5327 variable 'CCAS' │ │ │ │ │ +00038b00: 2068 6f6c 6473 2074 6865 206e 616d 6520 holds the name │ │ │ │ │ +00038b10: 6f66 2074 6865 2063 6f6d 7069 6c65 7220 of the compiler │ │ │ │ │ +00038b20: 7573 6564 2074 6f20 6275 696c 640a 6173 used to build.as │ │ │ │ │ +00038b30: 7365 6d62 6c79 2063 6f64 652e 2020 5468 sembly code. Th │ │ │ │ │ +00038b40: 6973 2063 6f6d 7069 6c65 7220 6d75 7374 is compiler must │ │ │ │ │ +00038b50: 2077 6f72 6b20 6120 6269 7420 6c69 6b65 work a bit like │ │ │ │ │ +00038b60: 2061 2043 2063 6f6d 7069 6c65 723b 2069 a C compiler; i │ │ │ │ │ +00038b70: 6e0a 7061 7274 6963 756c 6172 2069 7420 n.particular it │ │ │ │ │ +00038b80: 6d75 7374 2061 6363 6570 7420 272d 6327 must accept '-c' │ │ │ │ │ +00038b90: 2061 6e64 2027 2d6f 272e 2020 5468 6520 and '-o'. The │ │ │ │ │ +00038ba0: 7661 6c75 6573 206f 6620 2743 4341 5346 values of 'CCASF │ │ │ │ │ +00038bb0: 4c41 4753 2720 616e 640a 2741 4d5f 4343 LAGS' and.'AM_CC │ │ │ │ │ +00038bc0: 4153 464c 4147 5327 2028 6f72 2069 7473 ASFLAGS' (or its │ │ │ │ │ +00038bd0: 2070 6572 2d74 6172 6765 7420 6465 6669 per-target defi │ │ │ │ │ +00038be0: 6e69 7469 6f6e 2920 6973 2070 6173 7365 nition) is passe │ │ │ │ │ +00038bf0: 6420 746f 2074 6865 0a63 6f6d 7069 6c61 d to the.compila │ │ │ │ │ +00038c00: 7469 6f6e 2e20 2046 6f72 2070 7265 7072 tion. For prepr │ │ │ │ │ +00038c10: 6f63 6573 7365 6420 6669 6c65 732c 2027 ocessed files, ' │ │ │ │ │ +00038c20: 4445 4653 272c 2027 4445 4641 554c 545f DEFS', 'DEFAULT_ │ │ │ │ │ +00038c30: 494e 434c 5544 4553 272c 0a27 494e 434c INCLUDES',.'INCL │ │ │ │ │ +00038c40: 5544 4553 272c 2027 4350 5046 4c41 4753 UDES', 'CPPFLAGS │ │ │ │ │ +00038c50: 2720 616e 6420 2741 4d5f 4350 5046 4c41 ' and 'AM_CPPFLA │ │ │ │ │ +00038c60: 4753 2720 6172 6520 616c 736f 2075 7365 GS' are also use │ │ │ │ │ +00038c70: 642e 0a0a 2020 2054 6865 2061 7574 6f63 d... The autoc │ │ │ │ │ +00038c80: 6f6e 6620 6d61 6372 6f20 2741 4d5f 5052 onf macro 'AM_PR │ │ │ │ │ +00038c90: 4f47 5f41 5327 2077 696c 6c20 6465 6669 OG_AS' will defi │ │ │ │ │ +00038ca0: 6e65 2027 4343 4153 2720 616e 6420 2743 ne 'CCAS' and 'C │ │ │ │ │ +00038cb0: 4341 5346 4c41 4753 270a 666f 7220 796f CASFLAGS'.for yo │ │ │ │ │ +00038cc0: 7520 2875 6e6c 6573 7320 7468 6579 2061 u (unless they a │ │ │ │ │ +00038cd0: 7265 2061 6c72 6561 6479 2073 6574 2c20 re already set, │ │ │ │ │ +00038ce0: 6974 2073 696d 706c 7920 7365 7473 2027 it simply sets ' │ │ │ │ │ +00038cf0: 4343 4153 2720 746f 2074 6865 2043 0a63 CCAS' to the C.c │ │ │ │ │ +00038d00: 6f6d 7069 6c65 7220 616e 6420 2743 4341 ompiler and 'CCA │ │ │ │ │ +00038d10: 5346 4c41 4753 2720 746f 2074 6865 2043 SFLAGS' to the C │ │ │ │ │ +00038d20: 2063 6f6d 7069 6c65 7220 666c 6167 7329 compiler flags) │ │ │ │ │ +00038d30: 2c20 6275 7420 796f 7520 6172 6520 6672 , but you are fr │ │ │ │ │ +00038d40: 6565 2074 6f0a 6465 6669 6e65 2074 6865 ee to.define the │ │ │ │ │ +00038d50: 7365 2076 6172 6961 626c 6573 2062 7920 se variables by │ │ │ │ │ +00038d60: 6f74 6865 7220 6d65 616e 732e 0a0a 2020 other means... │ │ │ │ │ +00038d70: 204f 6e6c 7920 7468 6520 7375 6666 6978 Only the suffix │ │ │ │ │ +00038d80: 6573 2027 2e73 272c 2027 2e53 272c 2061 es '.s', '.S', a │ │ │ │ │ +00038d90: 6e64 2027 2e73 7827 2061 7265 2072 6563 nd '.sx' are rec │ │ │ │ │ +00038da0: 6f67 6e69 7a65 6420 6279 2027 6175 746f ognized by 'auto │ │ │ │ │ +00038db0: 6d61 6b65 270a 6173 2062 6569 6e67 2066 make'.as being f │ │ │ │ │ +00038dc0: 696c 6573 2063 6f6e 7461 696e 696e 6720 iles containing │ │ │ │ │ +00038dd0: 6173 7365 6d62 6c79 2063 6f64 652e 0a0a assembly code... │ │ │ │ │ +00038de0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +00038df0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +00038e00: 653a 2046 6f72 7472 616e 2037 3720 5375 e: Fortran 77 Su │ │ │ │ │ +00038e10: 7070 6f72 742c 2020 4e65 7874 3a20 466f pport, Next: Fo │ │ │ │ │ +00038e20: 7274 7261 6e20 3978 2053 7570 706f 7274 rtran 9x Support │ │ │ │ │ +00038e30: 2c20 2050 7265 763a 2041 7373 656d 626c , Prev: Assembl │ │ │ │ │ +00038e40: 7920 5375 7070 6f72 742c 2020 5570 3a20 y Support, Up: │ │ │ │ │ +00038e50: 5072 6f67 7261 6d73 0a0a 382e 3133 2046 Programs..8.13 F │ │ │ │ │ +00038e60: 6f72 7472 616e 2037 3720 5375 7070 6f72 ortran 77 Suppor │ │ │ │ │ +00038e70: 740a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d t.============== │ │ │ │ │ +00038e80: 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 6f6d =========..Autom │ │ │ │ │ +00038e90: 616b 6520 696e 636c 7564 6573 2066 756c ake includes ful │ │ │ │ │ +00038ea0: 6c20 7375 7070 6f72 7420 666f 7220 466f l support for Fo │ │ │ │ │ +00038eb0: 7274 7261 6e20 3737 2e0a 0a20 2020 416e rtran 77... An │ │ │ │ │ +00038ec0: 7920 7061 636b 6167 6520 696e 636c 7564 y package includ │ │ │ │ │ +00038ed0: 696e 6720 466f 7274 7261 6e20 3737 2063 ing Fortran 77 c │ │ │ │ │ +00038ee0: 6f64 6520 6d75 7374 2064 6566 696e 6520 ode must define │ │ │ │ │ +00038ef0: 7468 6520 6f75 7470 7574 2076 6172 6961 the output varia │ │ │ │ │ +00038f00: 626c 650a 2746 3737 2720 696e 2027 636f ble.'F77' in 'co │ │ │ │ │ +00038f10: 6e66 6967 7572 652e 6163 273b 2074 6865 nfigure.ac'; the │ │ │ │ │ +00038f20: 2073 696d 706c 6573 7420 7761 7920 746f simplest way to │ │ │ │ │ +00038f30: 2064 6f20 7468 6973 2069 7320 746f 2075 do this is to u │ │ │ │ │ +00038f40: 7365 2074 6865 0a27 4143 5f50 524f 475f se the.'AC_PROG_ │ │ │ │ │ +00038f50: 4637 3727 206d 6163 726f 2028 2a6e 6f74 F77' macro (*not │ │ │ │ │ +00038f60: 6520 5061 7274 6963 756c 6172 2050 726f e Particular Pro │ │ │ │ │ +00038f70: 6772 616d 2043 6865 636b 733a 0a28 6175 gram Checks:.(au │ │ │ │ │ +00038f80: 746f 636f 6e66 2950 6172 7469 6375 6c61 toconf)Particula │ │ │ │ │ +00038f90: 7220 5072 6f67 7261 6d73 2e29 2e0a 0a20 r Programs.)... │ │ │ │ │ +00038fa0: 2020 4120 6665 7720 6164 6469 7469 6f6e A few addition │ │ │ │ │ +00038fb0: 616c 2076 6172 6961 626c 6573 2061 7265 al variables are │ │ │ │ │ +00038fc0: 2064 6566 696e 6564 2077 6865 6e20 6120 defined when a │ │ │ │ │ +00038fd0: 466f 7274 7261 6e20 3737 2073 6f75 7263 Fortran 77 sourc │ │ │ │ │ +00038fe0: 6520 6669 6c65 0a69 7320 7365 656e 3a0a e file.is seen:. │ │ │ │ │ +00038ff0: 0a27 4637 3727 0a20 2020 2020 5468 6520 .'F77'. The │ │ │ │ │ +00039000: 6e61 6d65 206f 6620 7468 6520 466f 7274 name of the Fort │ │ │ │ │ +00039010: 7261 6e20 3737 2063 6f6d 7069 6c65 722e ran 77 compiler. │ │ │ │ │ +00039020: 0a0a 2746 464c 4147 5327 0a20 2020 2020 ..'FFLAGS'. │ │ │ │ │ +00039030: 416e 7920 666c 6167 7320 746f 2070 6173 Any flags to pas │ │ │ │ │ +00039040: 7320 746f 2074 6865 2046 6f72 7472 616e s to the Fortran │ │ │ │ │ +00039050: 2037 3720 636f 6d70 696c 6572 2e0a 0a27 77 compiler...' │ │ │ │ │ +00039060: 414d 5f46 464c 4147 5327 0a20 2020 2020 AM_FFLAGS'. │ │ │ │ │ +00039070: 5468 6520 6d61 696e 7461 696e 6572 2773 The maintainer's │ │ │ │ │ +00039080: 2076 6172 6961 6e74 206f 6620 2746 464c variant of 'FFL │ │ │ │ │ +00039090: 4147 5327 2e0a 0a27 5246 4c41 4753 270a AGS'...'RFLAGS'. │ │ │ │ │ +000390a0: 2020 2020 2041 6e79 2066 6c61 6773 2074 Any flags t │ │ │ │ │ +000390b0: 6f20 7061 7373 2074 6f20 7468 6520 5261 o pass to the Ra │ │ │ │ │ +000390c0: 7466 6f72 2063 6f6d 7069 6c65 722e 0a0a tfor compiler... │ │ │ │ │ +000390d0: 2741 4d5f 5246 4c41 4753 270a 2020 2020 'AM_RFLAGS'. │ │ │ │ │ +000390e0: 2054 6865 206d 6169 6e74 6169 6e65 7227 The maintainer' │ │ │ │ │ +000390f0: 7320 7661 7269 616e 7420 6f66 2027 5246 s variant of 'RF │ │ │ │ │ +00039100: 4c41 4753 272e 0a0a 2746 3737 434f 4d50 LAGS'...'F77COMP │ │ │ │ │ +00039110: 494c 4527 0a20 2020 2020 5468 6520 636f ILE'. The co │ │ │ │ │ +00039120: 6d6d 616e 6420 7573 6564 2074 6f20 6163 mmand used to ac │ │ │ │ │ +00039130: 7475 616c 6c79 2063 6f6d 7069 6c65 2061 tually compile a │ │ │ │ │ +00039140: 2046 6f72 7472 616e 2037 3720 736f 7572 Fortran 77 sour │ │ │ │ │ +00039150: 6365 2066 696c 652e 2020 5468 650a 2020 ce file. The. │ │ │ │ │ +00039160: 2020 2066 696c 6520 6e61 6d65 2069 7320 file name is │ │ │ │ │ +00039170: 6170 7065 6e64 6564 2074 6f20 666f 726d appended to form │ │ │ │ │ +00039180: 2074 6865 2063 6f6d 706c 6574 6520 636f the complete co │ │ │ │ │ +00039190: 6d6d 616e 6420 6c69 6e65 2e0a 0a27 464c mmand line...'FL │ │ │ │ │ +000391a0: 494e 4b27 0a20 2020 2020 5468 6520 636f INK'. The co │ │ │ │ │ +000391b0: 6d6d 616e 6420 7573 6564 2074 6f20 6163 mmand used to ac │ │ │ │ │ +000391c0: 7475 616c 6c79 206c 696e 6b20 6120 7075 tually link a pu │ │ │ │ │ +000391d0: 7265 2046 6f72 7472 616e 2037 3720 7072 re Fortran 77 pr │ │ │ │ │ +000391e0: 6f67 7261 6d20 6f72 0a20 2020 2020 7368 ogram or. sh │ │ │ │ │ +000391f0: 6172 6564 206c 6962 7261 7279 2e0a 0a20 ared library... │ │ │ │ │ +00039200: 2020 4175 746f 6d61 6b65 2063 616e 2068 Automake can h │ │ │ │ │ +00039210: 616e 646c 6520 7072 6570 726f 6365 7373 andle preprocess │ │ │ │ │ +00039220: 696e 6720 466f 7274 7261 6e20 3737 2061 ing Fortran 77 a │ │ │ │ │ +00039230: 6e64 2052 6174 666f 7220 736f 7572 6365 nd Ratfor source │ │ │ │ │ +00039240: 2066 696c 6573 0a69 6e20 6164 6469 7469 files.in additi │ │ │ │ │ +00039250: 6f6e 2074 6f20 636f 6d70 696c 696e 6720 on to compiling │ │ │ │ │ +00039260: 7468 656d 2831 292e 2020 4175 746f 6d61 them(1). Automa │ │ │ │ │ +00039270: 6b65 2061 6c73 6f20 636f 6e74 6169 6e73 ke also contains │ │ │ │ │ +00039280: 2073 6f6d 6520 7375 7070 6f72 740a 666f some support.fo │ │ │ │ │ +00039290: 7220 6372 6561 7469 6e67 2070 726f 6772 r creating progr │ │ │ │ │ +000392a0: 616d 7320 616e 6420 7368 6172 6564 206c ams and shared l │ │ │ │ │ +000392b0: 6962 7261 7269 6573 2074 6861 7420 6172 ibraries that ar │ │ │ │ │ +000392c0: 6520 6120 6d69 7874 7572 6520 6f66 2046 e a mixture of F │ │ │ │ │ +000392d0: 6f72 7472 616e 0a37 3720 616e 6420 6f74 ortran.77 and ot │ │ │ │ │ +000392e0: 6865 7220 6c61 6e67 7561 6765 7320 282a her languages (* │ │ │ │ │ +000392f0: 6e6f 7465 204d 6978 696e 6720 466f 7274 note Mixing Fort │ │ │ │ │ +00039300: 7261 6e20 3737 2057 6974 6820 4320 616e ran 77 With C an │ │ │ │ │ +00039310: 6420 432b 2b3a 3a29 2e0a 0a20 2020 5468 d C++::)... Th │ │ │ │ │ +00039320: 6573 6520 6973 7375 6573 2061 7265 2063 ese issues are c │ │ │ │ │ +00039330: 6f76 6572 6564 2069 6e20 7468 6520 666f overed in the fo │ │ │ │ │ +00039340: 6c6c 6f77 696e 6720 7365 6374 696f 6e73 llowing sections │ │ │ │ │ +00039350: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 5072 ...* Menu:..* Pr │ │ │ │ │ +00039360: 6570 726f 6365 7373 696e 6720 466f 7274 eprocessing Fort │ │ │ │ │ +00039370: 7261 6e20 3737 3a3a 2020 2020 5072 6570 ran 77:: Prep │ │ │ │ │ +00039380: 726f 6365 7373 696e 6720 466f 7274 7261 rocessing Fortra │ │ │ │ │ +00039390: 6e20 3737 2073 6f75 7263 6573 0a2a 2043 n 77 sources.* C │ │ │ │ │ +000393a0: 6f6d 7069 6c69 6e67 2046 6f72 7472 616e ompiling Fortran │ │ │ │ │ +000393b0: 2037 3720 4669 6c65 733a 3a20 2043 6f6d 77 Files:: Com │ │ │ │ │ +000393c0: 7069 6c69 6e67 2046 6f72 7472 616e 2037 piling Fortran 7 │ │ │ │ │ +000393d0: 3720 736f 7572 6365 730a 2a20 4d69 7869 7 sources.* Mixi │ │ │ │ │ +000393e0: 6e67 2046 6f72 7472 616e 2037 3720 5769 ng Fortran 77 Wi │ │ │ │ │ +000393f0: 7468 2043 2061 6e64 2043 2b2b 3a3a 2020 th C and C++:: │ │ │ │ │ +00039400: 4d69 7869 6e67 2046 6f72 7472 616e 2037 Mixing Fortran 7 │ │ │ │ │ +00039410: 3720 5769 7468 2043 2061 6e64 2043 2b2b 7 With C and C++ │ │ │ │ │ +00039420: 0a0a 2020 202d 2d2d 2d2d 2d2d 2d2d 2d20 .. ---------- │ │ │ │ │ +00039430: 466f 6f74 6e6f 7465 7320 2d2d 2d2d 2d2d Footnotes ------ │ │ │ │ │ +00039440: 2d2d 2d2d 0a0a 2020 2028 3129 204d 7563 ----.. (1) Muc │ │ │ │ │ +00039450: 682c 2069 6620 6e6f 7420 6d6f 7374 2c20 h, if not most, │ │ │ │ │ +00039460: 6f66 2074 6865 2069 6e66 6f72 6d61 7469 of the informati │ │ │ │ │ +00039470: 6f6e 2069 6e20 7468 6520 666f 6c6c 6f77 on in the follow │ │ │ │ │ +00039480: 696e 6720 7365 6374 696f 6e73 0a70 6572 ing sections.per │ │ │ │ │ +00039490: 7461 696e 696e 6720 746f 2070 7265 7072 taining to prepr │ │ │ │ │ +000394a0: 6f63 6573 7369 6e67 2046 6f72 7472 616e ocessing Fortran │ │ │ │ │ +000394b0: 2037 3720 7072 6f67 7261 6d73 2077 6173 77 programs was │ │ │ │ │ +000394c0: 2074 616b 656e 2061 6c6d 6f73 740a 7665 taken almost.ve │ │ │ │ │ +000394d0: 7262 6174 696d 2066 726f 6d20 2a6e 6f74 rbatim from *not │ │ │ │ │ +000394e0: 6520 4361 7461 6c6f 6775 6520 6f66 2052 e Catalogue of R │ │ │ │ │ +000394f0: 756c 6573 3a20 286d 616b 6529 4361 7461 ules: (make)Cata │ │ │ │ │ +00039500: 6c6f 6775 6520 6f66 2052 756c 6573 2e0a logue of Rules.. │ │ │ │ │ +00039510: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +00039520: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +00039530: 6465 3a20 5072 6570 726f 6365 7373 696e de: Preprocessin │ │ │ │ │ +00039540: 6720 466f 7274 7261 6e20 3737 2c20 204e g Fortran 77, N │ │ │ │ │ +00039550: 6578 743a 2043 6f6d 7069 6c69 6e67 2046 ext: Compiling F │ │ │ │ │ +00039560: 6f72 7472 616e 2037 3720 4669 6c65 732c ortran 77 Files, │ │ │ │ │ +00039570: 2020 5570 3a20 466f 7274 7261 6e20 3737 Up: Fortran 77 │ │ │ │ │ +00039580: 2053 7570 706f 7274 0a0a 382e 3133 2e31 Support..8.13.1 │ │ │ │ │ +00039590: 2050 7265 7072 6f63 6573 7369 6e67 2046 Preprocessing F │ │ │ │ │ +000395a0: 6f72 7472 616e 2037 370a 2d2d 2d2d 2d2d ortran 77.------ │ │ │ │ │ 000395b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000395c0: 2d2d 2d2d 2d2d 2d0a 0a27 4e2e 6627 2069 -------..'N.f' i │ │ │ │ │ -000395d0: 7320 6d61 6465 2061 7574 6f6d 6174 6963 s made automatic │ │ │ │ │ -000395e0: 616c 6c79 2066 726f 6d20 274e 2e46 2720 ally from 'N.F' │ │ │ │ │ -000395f0: 6f72 2027 4e2e 7227 2e20 2054 6869 7320 or 'N.r'. This │ │ │ │ │ -00039600: 7275 6c65 2072 756e 7320 6a75 7374 0a74 rule runs just.t │ │ │ │ │ -00039610: 6865 2070 7265 7072 6f63 6573 736f 7220 he preprocessor │ │ │ │ │ -00039620: 746f 2063 6f6e 7665 7274 2061 2070 7265 to convert a pre │ │ │ │ │ -00039630: 7072 6f63 6573 7361 626c 6520 466f 7274 processable Fort │ │ │ │ │ -00039640: 7261 6e20 3737 206f 7220 5261 7466 6f72 ran 77 or Ratfor │ │ │ │ │ -00039650: 2073 6f75 7263 650a 6669 6c65 2069 6e74 source.file int │ │ │ │ │ -00039660: 6f20 6120 7374 7269 6374 2046 6f72 7472 o a strict Fortr │ │ │ │ │ -00039670: 616e 2037 3720 736f 7572 6365 2066 696c an 77 source fil │ │ │ │ │ -00039680: 652e 2020 5468 6520 7072 6563 6973 6520 e. The precise │ │ │ │ │ -00039690: 636f 6d6d 616e 6420 7573 6564 2069 730a command used is. │ │ │ │ │ -000396a0: 6173 2066 6f6c 6c6f 7773 3a0a 0a27 2e46 as follows:..'.F │ │ │ │ │ -000396b0: 270a 2020 2020 2027 2428 4637 3729 202d '. '$(F77) - │ │ │ │ │ -000396c0: 4620 2428 4445 4653 2920 2428 494e 434c F $(DEFS) $(INCL │ │ │ │ │ -000396d0: 5544 4553 2920 2428 414d 5f43 5050 464c UDES) $(AM_CPPFL │ │ │ │ │ -000396e0: 4147 5329 2024 2843 5050 464c 4147 5329 AGS) $(CPPFLAGS) │ │ │ │ │ -000396f0: 0a20 2020 2020 2428 414d 5f46 464c 4147 . $(AM_FFLAG │ │ │ │ │ -00039700: 5329 2024 2846 464c 4147 5329 270a 0a27 S) $(FFLAGS)'..' │ │ │ │ │ -00039710: 2e72 270a 2020 2020 2027 2428 4637 3729 .r'. '$(F77) │ │ │ │ │ -00039720: 202d 4620 2428 414d 5f46 464c 4147 5329 -F $(AM_FFLAGS) │ │ │ │ │ -00039730: 2024 2846 464c 4147 5329 2024 2841 4d5f $(FFLAGS) $(AM_ │ │ │ │ │ -00039740: 5246 4c41 4753 2920 2428 5246 4c41 4753 RFLAGS) $(RFLAGS │ │ │ │ │ -00039750: 2927 0a0a 1f0a 4669 6c65 3a20 6175 746f )'....File: auto │ │ │ │ │ -00039760: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00039770: 204e 6f64 653a 2043 6f6d 7069 6c69 6e67 Node: Compiling │ │ │ │ │ -00039780: 2046 6f72 7472 616e 2037 3720 4669 6c65 Fortran 77 File │ │ │ │ │ -00039790: 732c 2020 4e65 7874 3a20 4d69 7869 6e67 s, Next: Mixing │ │ │ │ │ -000397a0: 2046 6f72 7472 616e 2037 3720 5769 7468 Fortran 77 With │ │ │ │ │ -000397b0: 2043 2061 6e64 2043 2b2b 2c20 2050 7265 C and C++, Pre │ │ │ │ │ -000397c0: 763a 2050 7265 7072 6f63 6573 7369 6e67 v: Preprocessing │ │ │ │ │ -000397d0: 2046 6f72 7472 616e 2037 372c 2020 5570 Fortran 77, Up │ │ │ │ │ -000397e0: 3a20 466f 7274 7261 6e20 3737 2053 7570 : Fortran 77 Sup │ │ │ │ │ -000397f0: 706f 7274 0a0a 382e 3133 2e32 2043 6f6d port..8.13.2 Com │ │ │ │ │ -00039800: 7069 6c69 6e67 2046 6f72 7472 616e 2037 piling Fortran 7 │ │ │ │ │ -00039810: 3720 4669 6c65 730a 2d2d 2d2d 2d2d 2d2d 7 Files.-------- │ │ │ │ │ +000395c0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a27 4e2e 6627 ---------..'N.f' │ │ │ │ │ +000395d0: 2069 7320 6d61 6465 2061 7574 6f6d 6174 is made automat │ │ │ │ │ +000395e0: 6963 616c 6c79 2066 726f 6d20 274e 2e46 ically from 'N.F │ │ │ │ │ +000395f0: 2720 6f72 2027 4e2e 7227 2e20 2054 6869 ' or 'N.r'. Thi │ │ │ │ │ +00039600: 7320 7275 6c65 2072 756e 7320 6a75 7374 s rule runs just │ │ │ │ │ +00039610: 0a74 6865 2070 7265 7072 6f63 6573 736f .the preprocesso │ │ │ │ │ +00039620: 7220 746f 2063 6f6e 7665 7274 2061 2070 r to convert a p │ │ │ │ │ +00039630: 7265 7072 6f63 6573 7361 626c 6520 466f reprocessable Fo │ │ │ │ │ +00039640: 7274 7261 6e20 3737 206f 7220 5261 7466 rtran 77 or Ratf │ │ │ │ │ +00039650: 6f72 2073 6f75 7263 650a 6669 6c65 2069 or source.file i │ │ │ │ │ +00039660: 6e74 6f20 6120 7374 7269 6374 2046 6f72 nto a strict For │ │ │ │ │ +00039670: 7472 616e 2037 3720 736f 7572 6365 2066 tran 77 source f │ │ │ │ │ +00039680: 696c 652e 2020 5468 6520 7072 6563 6973 ile. The precis │ │ │ │ │ +00039690: 6520 636f 6d6d 616e 6420 7573 6564 2069 e command used i │ │ │ │ │ +000396a0: 730a 6173 2066 6f6c 6c6f 7773 3a0a 0a27 s.as follows:..' │ │ │ │ │ +000396b0: 2e46 270a 2020 2020 2027 2428 4637 3729 .F'. '$(F77) │ │ │ │ │ +000396c0: 202d 4620 2428 4445 4653 2920 2428 494e -F $(DEFS) $(IN │ │ │ │ │ +000396d0: 434c 5544 4553 2920 2428 414d 5f43 5050 CLUDES) $(AM_CPP │ │ │ │ │ +000396e0: 464c 4147 5329 2024 2843 5050 464c 4147 FLAGS) $(CPPFLAG │ │ │ │ │ +000396f0: 5329 0a20 2020 2020 2428 414d 5f46 464c S). $(AM_FFL │ │ │ │ │ +00039700: 4147 5329 2024 2846 464c 4147 5329 270a AGS) $(FFLAGS)'. │ │ │ │ │ +00039710: 0a27 2e72 270a 2020 2020 2027 2428 4637 .'.r'. '$(F7 │ │ │ │ │ +00039720: 3729 202d 4620 2428 414d 5f46 464c 4147 7) -F $(AM_FFLAG │ │ │ │ │ +00039730: 5329 2024 2846 464c 4147 5329 2024 2841 S) $(FFLAGS) $(A │ │ │ │ │ +00039740: 4d5f 5246 4c41 4753 2920 2428 5246 4c41 M_RFLAGS) $(RFLA │ │ │ │ │ +00039750: 4753 2927 0a0a 1f0a 4669 6c65 3a20 6175 GS)'....File: au │ │ │ │ │ +00039760: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00039770: 2c20 204e 6f64 653a 2043 6f6d 7069 6c69 , Node: Compili │ │ │ │ │ +00039780: 6e67 2046 6f72 7472 616e 2037 3720 4669 ng Fortran 77 Fi │ │ │ │ │ +00039790: 6c65 732c 2020 4e65 7874 3a20 4d69 7869 les, Next: Mixi │ │ │ │ │ +000397a0: 6e67 2046 6f72 7472 616e 2037 3720 5769 ng Fortran 77 Wi │ │ │ │ │ +000397b0: 7468 2043 2061 6e64 2043 2b2b 2c20 2050 th C and C++, P │ │ │ │ │ +000397c0: 7265 763a 2050 7265 7072 6f63 6573 7369 rev: Preprocessi │ │ │ │ │ +000397d0: 6e67 2046 6f72 7472 616e 2037 372c 2020 ng Fortran 77, │ │ │ │ │ +000397e0: 5570 3a20 466f 7274 7261 6e20 3737 2053 Up: Fortran 77 S │ │ │ │ │ +000397f0: 7570 706f 7274 0a0a 382e 3133 2e32 2043 upport..8.13.2 C │ │ │ │ │ +00039800: 6f6d 7069 6c69 6e67 2046 6f72 7472 616e ompiling Fortran │ │ │ │ │ +00039810: 2037 3720 4669 6c65 730a 2d2d 2d2d 2d2d 77 Files.------ │ │ │ │ │ 00039820: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00039830: 2d2d 2d2d 2d2d 2d2d 2d0a 0a27 4e2e 6f27 ---------..'N.o' │ │ │ │ │ -00039840: 2069 7320 6d61 6465 2061 7574 6f6d 6174 is made automat │ │ │ │ │ -00039850: 6963 616c 6c79 2066 726f 6d20 274e 2e66 ically from 'N.f │ │ │ │ │ -00039860: 272c 2027 4e2e 4627 206f 7220 274e 2e72 ', 'N.F' or 'N.r │ │ │ │ │ -00039870: 2720 6279 2072 756e 6e69 6e67 2074 6865 ' by running the │ │ │ │ │ -00039880: 0a46 6f72 7472 616e 2037 3720 636f 6d70 .Fortran 77 comp │ │ │ │ │ -00039890: 696c 6572 2e20 2054 6865 2070 7265 6369 iler. The preci │ │ │ │ │ -000398a0: 7365 2063 6f6d 6d61 6e64 2075 7365 6420 se command used │ │ │ │ │ -000398b0: 6973 2061 7320 666f 6c6c 6f77 733a 0a0a is as follows:.. │ │ │ │ │ -000398c0: 272e 6627 0a20 2020 2020 2724 2846 3737 '.f'. '$(F77 │ │ │ │ │ -000398d0: 2920 2d63 2024 2841 4d5f 4646 4c41 4753 ) -c $(AM_FFLAGS │ │ │ │ │ -000398e0: 2920 2428 4646 4c41 4753 2927 0a0a 272e ) $(FFLAGS)'..'. │ │ │ │ │ -000398f0: 4627 0a20 2020 2020 2724 2846 3737 2920 F'. '$(F77) │ │ │ │ │ -00039900: 2d63 2024 2844 4546 5329 2024 2849 4e43 -c $(DEFS) $(INC │ │ │ │ │ -00039910: 4c55 4445 5329 2024 2841 4d5f 4350 5046 LUDES) $(AM_CPPF │ │ │ │ │ -00039920: 4c41 4753 2920 2428 4350 5046 4c41 4753 LAGS) $(CPPFLAGS │ │ │ │ │ -00039930: 290a 2020 2020 2024 2841 4d5f 4646 4c41 ). $(AM_FFLA │ │ │ │ │ -00039940: 4753 2920 2428 4646 4c41 4753 2927 0a0a GS) $(FFLAGS)'.. │ │ │ │ │ -00039950: 272e 7227 0a20 2020 2020 2724 2846 3737 '.r'. '$(F77 │ │ │ │ │ -00039960: 2920 2d63 2024 2841 4d5f 4646 4c41 4753 ) -c $(AM_FFLAGS │ │ │ │ │ -00039970: 2920 2428 4646 4c41 4753 2920 2428 414d ) $(FFLAGS) $(AM │ │ │ │ │ -00039980: 5f52 464c 4147 5329 2024 2852 464c 4147 _RFLAGS) $(RFLAG │ │ │ │ │ -00039990: 5329 270a 0a1f 0a46 696c 653a 2061 7574 S)'....File: aut │ │ │ │ │ -000399a0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -000399b0: 2020 4e6f 6465 3a20 4d69 7869 6e67 2046 Node: Mixing F │ │ │ │ │ -000399c0: 6f72 7472 616e 2037 3720 5769 7468 2043 ortran 77 With C │ │ │ │ │ -000399d0: 2061 6e64 2043 2b2b 2c20 2050 7265 763a and C++, Prev: │ │ │ │ │ -000399e0: 2043 6f6d 7069 6c69 6e67 2046 6f72 7472 Compiling Fortr │ │ │ │ │ -000399f0: 616e 2037 3720 4669 6c65 732c 2020 5570 an 77 Files, Up │ │ │ │ │ -00039a00: 3a20 466f 7274 7261 6e20 3737 2053 7570 : Fortran 77 Sup │ │ │ │ │ -00039a10: 706f 7274 0a0a 382e 3133 2e33 204d 6978 port..8.13.3 Mix │ │ │ │ │ -00039a20: 696e 6720 466f 7274 7261 6e20 3737 2057 ing Fortran 77 W │ │ │ │ │ -00039a30: 6974 6820 4320 616e 6420 432b 2b0a 2d2d ith C and C++.-- │ │ │ │ │ +00039830: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a27 4e2e -----------..'N. │ │ │ │ │ +00039840: 6f27 2069 7320 6d61 6465 2061 7574 6f6d o' is made autom │ │ │ │ │ +00039850: 6174 6963 616c 6c79 2066 726f 6d20 274e atically from 'N │ │ │ │ │ +00039860: 2e66 272c 2027 4e2e 4627 206f 7220 274e .f', 'N.F' or 'N │ │ │ │ │ +00039870: 2e72 2720 6279 2072 756e 6e69 6e67 2074 .r' by running t │ │ │ │ │ +00039880: 6865 0a46 6f72 7472 616e 2037 3720 636f he.Fortran 77 co │ │ │ │ │ +00039890: 6d70 696c 6572 2e20 2054 6865 2070 7265 mpiler. The pre │ │ │ │ │ +000398a0: 6369 7365 2063 6f6d 6d61 6e64 2075 7365 cise command use │ │ │ │ │ +000398b0: 6420 6973 2061 7320 666f 6c6c 6f77 733a d is as follows: │ │ │ │ │ +000398c0: 0a0a 272e 6627 0a20 2020 2020 2724 2846 ..'.f'. '$(F │ │ │ │ │ +000398d0: 3737 2920 2d63 2024 2841 4d5f 4646 4c41 77) -c $(AM_FFLA │ │ │ │ │ +000398e0: 4753 2920 2428 4646 4c41 4753 2927 0a0a GS) $(FFLAGS)'.. │ │ │ │ │ +000398f0: 272e 4627 0a20 2020 2020 2724 2846 3737 '.F'. '$(F77 │ │ │ │ │ +00039900: 2920 2d63 2024 2844 4546 5329 2024 2849 ) -c $(DEFS) $(I │ │ │ │ │ +00039910: 4e43 4c55 4445 5329 2024 2841 4d5f 4350 NCLUDES) $(AM_CP │ │ │ │ │ +00039920: 5046 4c41 4753 2920 2428 4350 5046 4c41 PFLAGS) $(CPPFLA │ │ │ │ │ +00039930: 4753 290a 2020 2020 2024 2841 4d5f 4646 GS). $(AM_FF │ │ │ │ │ +00039940: 4c41 4753 2920 2428 4646 4c41 4753 2927 LAGS) $(FFLAGS)' │ │ │ │ │ +00039950: 0a0a 272e 7227 0a20 2020 2020 2724 2846 ..'.r'. '$(F │ │ │ │ │ +00039960: 3737 2920 2d63 2024 2841 4d5f 4646 4c41 77) -c $(AM_FFLA │ │ │ │ │ +00039970: 4753 2920 2428 4646 4c41 4753 2920 2428 GS) $(FFLAGS) $( │ │ │ │ │ +00039980: 414d 5f52 464c 4147 5329 2024 2852 464c AM_RFLAGS) $(RFL │ │ │ │ │ +00039990: 4147 5329 270a 0a1f 0a46 696c 653a 2061 AGS)'....File: a │ │ │ │ │ +000399a0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +000399b0: 6f2c 2020 4e6f 6465 3a20 4d69 7869 6e67 o, Node: Mixing │ │ │ │ │ +000399c0: 2046 6f72 7472 616e 2037 3720 5769 7468 Fortran 77 With │ │ │ │ │ +000399d0: 2043 2061 6e64 2043 2b2b 2c20 2050 7265 C and C++, Pre │ │ │ │ │ +000399e0: 763a 2043 6f6d 7069 6c69 6e67 2046 6f72 v: Compiling For │ │ │ │ │ +000399f0: 7472 616e 2037 3720 4669 6c65 732c 2020 tran 77 Files, │ │ │ │ │ +00039a00: 5570 3a20 466f 7274 7261 6e20 3737 2053 Up: Fortran 77 S │ │ │ │ │ +00039a10: 7570 706f 7274 0a0a 382e 3133 2e33 204d upport..8.13.3 M │ │ │ │ │ +00039a20: 6978 696e 6720 466f 7274 7261 6e20 3737 ixing Fortran 77 │ │ │ │ │ +00039a30: 2057 6974 6820 4320 616e 6420 432b 2b0a With C and C++. │ │ │ │ │ 00039a40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00039a50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00039a60: 2d2d 2d2d 2d0a 0a41 7574 6f6d 616b 6520 -----..Automake │ │ │ │ │ -00039a70: 6375 7272 656e 746c 7920 7072 6f76 6964 currently provid │ │ │ │ │ -00039a80: 6573 205f 6c69 6d69 7465 645f 2073 7570 es _limited_ sup │ │ │ │ │ -00039a90: 706f 7274 2066 6f72 2063 7265 6174 696e port for creatin │ │ │ │ │ -00039aa0: 6720 7072 6f67 7261 6d73 2061 6e64 0a73 g programs and.s │ │ │ │ │ -00039ab0: 6861 7265 6420 6c69 6272 6172 6965 7320 hared libraries │ │ │ │ │ -00039ac0: 7468 6174 2061 7265 2061 206d 6978 7475 that are a mixtu │ │ │ │ │ -00039ad0: 7265 206f 6620 466f 7274 7261 6e20 3737 re of Fortran 77 │ │ │ │ │ -00039ae0: 2061 6e64 2043 2061 6e64 2f6f 7220 432b and C and/or C+ │ │ │ │ │ -00039af0: 2b2e 0a48 6f77 6576 6572 2c20 7468 6572 +..However, ther │ │ │ │ │ -00039b00: 6520 6172 6520 6d61 6e79 206f 7468 6572 e are many other │ │ │ │ │ -00039b10: 2069 7373 7565 7320 7265 6c61 7465 6420 issues related │ │ │ │ │ -00039b20: 746f 206d 6978 696e 6720 466f 7274 7261 to mixing Fortra │ │ │ │ │ -00039b30: 6e20 3737 2077 6974 680a 6f74 6865 7220 n 77 with.other │ │ │ │ │ -00039b40: 6c61 6e67 7561 6765 7320 7468 6174 2061 languages that a │ │ │ │ │ -00039b50: 7265 205f 6e6f 745f 2028 6375 7272 656e re _not_ (curren │ │ │ │ │ -00039b60: 746c 7929 2068 616e 646c 6564 2062 7920 tly) handled by │ │ │ │ │ -00039b70: 4175 746f 6d61 6b65 2c20 6275 7420 7468 Automake, but th │ │ │ │ │ -00039b80: 6174 0a61 7265 2068 616e 646c 6564 2062 at.are handled b │ │ │ │ │ -00039b90: 7920 6f74 6865 7220 7061 636b 6167 6573 y other packages │ │ │ │ │ -00039ba0: 2831 292e 0a0a 2020 2041 7574 6f6d 616b (1)... Automak │ │ │ │ │ -00039bb0: 6520 6361 6e20 6865 6c70 2069 6e20 7477 e can help in tw │ │ │ │ │ -00039bc0: 6f20 7761 7973 3a0a 0a20 2031 2e20 4175 o ways:.. 1. Au │ │ │ │ │ -00039bd0: 746f 6d61 7469 6320 7365 6c65 6374 696f tomatic selectio │ │ │ │ │ -00039be0: 6e20 6f66 2074 6865 206c 696e 6b65 7220 n of the linker │ │ │ │ │ -00039bf0: 6465 7065 6e64 696e 6720 6f6e 2077 6869 depending on whi │ │ │ │ │ -00039c00: 6368 2063 6f6d 6269 6e61 7469 6f6e 730a ch combinations. │ │ │ │ │ -00039c10: 2020 2020 206f 6620 736f 7572 6365 2063 of source c │ │ │ │ │ -00039c20: 6f64 652e 0a0a 2020 322e 2041 7574 6f6d ode... 2. Autom │ │ │ │ │ -00039c30: 6174 6963 2073 656c 6563 7469 6f6e 206f atic selection o │ │ │ │ │ -00039c40: 6620 7468 6520 6170 7072 6f70 7269 6174 f the appropriat │ │ │ │ │ -00039c50: 6520 6c69 6e6b 6572 2066 6c61 6773 2028 e linker flags ( │ │ │ │ │ -00039c60: 652e 672e 2c20 272d 4c27 2061 6e64 0a20 e.g., '-L' and. │ │ │ │ │ -00039c70: 2020 2020 272d 6c27 2920 746f 2070 6173 '-l') to pas │ │ │ │ │ -00039c80: 7320 746f 2074 6865 2061 7574 6f6d 6174 s to the automat │ │ │ │ │ -00039c90: 6963 616c 6c79 2073 656c 6563 7465 6420 ically selected │ │ │ │ │ -00039ca0: 6c69 6e6b 6572 2069 6e20 6f72 6465 7220 linker in order │ │ │ │ │ -00039cb0: 746f 206c 696e 6b0a 2020 2020 2069 6e20 to link. in │ │ │ │ │ -00039cc0: 7468 6520 6170 7072 6f70 7269 6174 6520 the appropriate │ │ │ │ │ -00039cd0: 466f 7274 7261 6e20 3737 2069 6e74 7269 Fortran 77 intri │ │ │ │ │ -00039ce0: 6e73 6963 2061 6e64 2072 756e 2d74 696d nsic and run-tim │ │ │ │ │ -00039cf0: 6520 6c69 6272 6172 6965 732e 0a0a 2020 e libraries... │ │ │ │ │ -00039d00: 2020 2054 6865 7365 2065 7874 7261 2046 These extra F │ │ │ │ │ -00039d10: 6f72 7472 616e 2037 3720 6c69 6e6b 6572 ortran 77 linker │ │ │ │ │ -00039d20: 2066 6c61 6773 2061 7265 2073 7570 706c flags are suppl │ │ │ │ │ -00039d30: 6965 6420 696e 2074 6865 206f 7574 7075 ied in the outpu │ │ │ │ │ -00039d40: 740a 2020 2020 2076 6172 6961 626c 6520 t. variable │ │ │ │ │ -00039d50: 2746 4c49 4253 2720 6279 2074 6865 2027 'FLIBS' by the ' │ │ │ │ │ -00039d60: 4143 5f46 3737 5f4c 4942 5241 5259 5f4c AC_F77_LIBRARY_L │ │ │ │ │ -00039d70: 4446 4c41 4753 2720 4175 746f 636f 6e66 DFLAGS' Autoconf │ │ │ │ │ -00039d80: 206d 6163 726f 0a20 2020 2020 7375 7070 macro. supp │ │ │ │ │ -00039d90: 6c69 6564 2077 6974 6820 6e65 7765 7220 lied with newer │ │ │ │ │ -00039da0: 7665 7273 696f 6e73 206f 6620 4175 746f versions of Auto │ │ │ │ │ -00039db0: 636f 6e66 2028 4175 746f 636f 6e66 2076 conf (Autoconf v │ │ │ │ │ -00039dc0: 6572 7369 6f6e 2032 2e31 3320 616e 640a ersion 2.13 and. │ │ │ │ │ -00039dd0: 2020 2020 206c 6174 6572 292e 2020 2a4e later). *N │ │ │ │ │ -00039de0: 6f74 6520 466f 7274 7261 6e20 436f 6d70 ote Fortran Comp │ │ │ │ │ -00039df0: 696c 6572 2043 6861 7261 6374 6572 6973 iler Characteris │ │ │ │ │ -00039e00: 7469 6373 3a20 2861 7574 6f63 6f6e 6629 tics: (autoconf) │ │ │ │ │ -00039e10: 466f 7274 7261 6e0a 2020 2020 2043 6f6d Fortran. Com │ │ │ │ │ -00039e20: 7069 6c65 722e 0a0a 2020 2049 6620 4175 piler... If Au │ │ │ │ │ -00039e30: 746f 6d61 6b65 2064 6574 6563 7473 2074 tomake detects t │ │ │ │ │ -00039e40: 6861 7420 6120 7072 6f67 7261 6d20 6f72 hat a program or │ │ │ │ │ -00039e50: 2073 6861 7265 6420 6c69 6272 6172 7920 shared library │ │ │ │ │ -00039e60: 2861 7320 6d65 6e74 696f 6e65 6420 696e (as mentioned in │ │ │ │ │ -00039e70: 0a73 6f6d 6520 275f 5052 4f47 5241 4d53 .some '_PROGRAMS │ │ │ │ │ -00039e80: 2720 6f72 2027 5f4c 544c 4942 5241 5249 ' or '_LTLIBRARI │ │ │ │ │ -00039e90: 4553 2720 7072 696d 6172 7929 2063 6f6e ES' primary) con │ │ │ │ │ -00039ea0: 7461 696e 7320 736f 7572 6365 2063 6f64 tains source cod │ │ │ │ │ -00039eb0: 6520 7468 6174 2069 730a 6120 6d69 7874 e that is.a mixt │ │ │ │ │ -00039ec0: 7572 6520 6f66 2046 6f72 7472 616e 2037 ure of Fortran 7 │ │ │ │ │ -00039ed0: 3720 616e 6420 4320 616e 642f 6f72 2043 7 and C and/or C │ │ │ │ │ -00039ee0: 2b2b 2c20 7468 656e 2069 7420 7265 7175 ++, then it requ │ │ │ │ │ -00039ef0: 6972 6573 2074 6861 7420 7468 650a 6d61 ires that the.ma │ │ │ │ │ -00039f00: 6372 6f20 2741 435f 4637 375f 4c49 4252 cro 'AC_F77_LIBR │ │ │ │ │ -00039f10: 4152 595f 4c44 464c 4147 5327 2062 6520 ARY_LDFLAGS' be │ │ │ │ │ -00039f20: 6361 6c6c 6564 2069 6e20 2763 6f6e 6669 called in 'confi │ │ │ │ │ -00039f30: 6775 7265 2e61 6327 2c20 616e 6420 7468 gure.ac', and th │ │ │ │ │ -00039f40: 6174 0a65 6974 6865 7220 2724 2846 4c49 at.either '$(FLI │ │ │ │ │ -00039f50: 4253 2927 2061 7070 6561 7220 696e 2074 BS)' appear in t │ │ │ │ │ -00039f60: 6865 2061 7070 726f 7072 6961 7465 2027 he appropriate ' │ │ │ │ │ -00039f70: 5f4c 4441 4444 2720 2866 6f72 2070 726f _LDADD' (for pro │ │ │ │ │ -00039f80: 6772 616d 7329 206f 720a 275f 4c49 4241 grams) or.'_LIBA │ │ │ │ │ -00039f90: 4444 2720 2866 6f72 2073 6861 7265 6420 DD' (for shared │ │ │ │ │ -00039fa0: 6c69 6272 6172 6965 7329 2076 6172 6961 libraries) varia │ │ │ │ │ -00039fb0: 626c 6573 2e20 2049 7420 6973 2074 6865 bles. It is the │ │ │ │ │ -00039fc0: 2072 6573 706f 6e73 6962 696c 6974 7920 responsibility │ │ │ │ │ -00039fd0: 6f66 0a74 6865 2070 6572 736f 6e20 7772 of.the person wr │ │ │ │ │ -00039fe0: 6974 696e 6720 7468 6520 274d 616b 6566 iting the 'Makef │ │ │ │ │ -00039ff0: 696c 652e 616d 2720 746f 206d 616b 6520 ile.am' to make │ │ │ │ │ -0003a000: 7375 7265 2074 6861 7420 2724 2846 4c49 sure that '$(FLI │ │ │ │ │ -0003a010: 4253 2927 0a61 7070 6561 7273 2069 6e20 BS)'.appears in │ │ │ │ │ -0003a020: 7468 6520 6170 7072 6f70 7269 6174 6520 the appropriate │ │ │ │ │ -0003a030: 275f 4c44 4144 4427 206f 7220 275f 4c49 '_LDADD' or '_LI │ │ │ │ │ -0003a040: 4241 4444 2720 7661 7269 6162 6c65 2e0a BADD' variable.. │ │ │ │ │ -0003a050: 0a20 2020 466f 7220 6578 616d 706c 652c . For example, │ │ │ │ │ -0003a060: 2063 6f6e 7369 6465 7220 7468 6520 666f consider the fo │ │ │ │ │ -0003a070: 6c6c 6f77 696e 6720 274d 616b 6566 696c llowing 'Makefil │ │ │ │ │ -0003a080: 652e 616d 273a 0a0a 2020 2020 2062 696e e.am':.. bin │ │ │ │ │ -0003a090: 5f50 524f 4752 414d 5320 3d20 666f 6f0a _PROGRAMS = foo. │ │ │ │ │ -0003a0a0: 2020 2020 2066 6f6f 5f53 4f55 5243 4553 foo_SOURCES │ │ │ │ │ -0003a0b0: 2020 3d20 6d61 696e 2e63 6320 666f 6f2e = main.cc foo. │ │ │ │ │ -0003a0c0: 660a 2020 2020 2066 6f6f 5f4c 4441 4444 f. foo_LDADD │ │ │ │ │ -0003a0d0: 2020 2020 3d20 6c69 6266 6f6f 2e6c 6120 = libfoo.la │ │ │ │ │ -0003a0e0: 2428 464c 4942 5329 0a0a 2020 2020 2070 $(FLIBS).. p │ │ │ │ │ -0003a0f0: 6b67 6c69 625f 4c54 4c49 4252 4152 4945 kglib_LTLIBRARIE │ │ │ │ │ -0003a100: 5320 3d20 6c69 6266 6f6f 2e6c 610a 2020 S = libfoo.la. │ │ │ │ │ -0003a110: 2020 206c 6962 666f 6f5f 6c61 5f53 4f55 libfoo_la_SOU │ │ │ │ │ -0003a120: 5243 4553 2020 3d20 6261 722e 6620 6261 RCES = bar.f ba │ │ │ │ │ -0003a130: 7a2e 6320 7a61 7264 6f7a 2e63 630a 2020 z.c zardoz.cc. │ │ │ │ │ -0003a140: 2020 206c 6962 666f 6f5f 6c61 5f4c 4942 libfoo_la_LIB │ │ │ │ │ -0003a150: 4144 4420 2020 3d20 2428 464c 4942 5329 ADD = $(FLIBS) │ │ │ │ │ -0003a160: 0a0a 2020 2049 6e20 7468 6973 2063 6173 .. In this cas │ │ │ │ │ -0003a170: 652c 2041 7574 6f6d 616b 6520 7769 6c6c e, Automake will │ │ │ │ │ -0003a180: 2069 6e73 6973 7420 7468 6174 2027 4143 insist that 'AC │ │ │ │ │ -0003a190: 5f46 3737 5f4c 4942 5241 5259 5f4c 4446 _F77_LIBRARY_LDF │ │ │ │ │ -0003a1a0: 4c41 4753 2720 6973 0a6d 656e 7469 6f6e LAGS' is.mention │ │ │ │ │ -0003a1b0: 6564 2069 6e20 2763 6f6e 6669 6775 7265 ed in 'configure │ │ │ │ │ -0003a1c0: 2e61 6327 2e20 2041 6c73 6f2c 2069 6620 .ac'. Also, if │ │ │ │ │ -0003a1d0: 2724 2846 4c49 4253 2927 2068 6164 6e27 '$(FLIBS)' hadn' │ │ │ │ │ -0003a1e0: 7420 6265 656e 206d 656e 7469 6f6e 6564 t been mentioned │ │ │ │ │ -0003a1f0: 0a69 6e20 2766 6f6f 5f4c 4441 4444 2720 .in 'foo_LDADD' │ │ │ │ │ -0003a200: 616e 6420 276c 6962 666f 6f5f 6c61 5f4c and 'libfoo_la_L │ │ │ │ │ -0003a210: 4942 4144 4427 2c20 7468 656e 2041 7574 IBADD', then Aut │ │ │ │ │ -0003a220: 6f6d 616b 6520 776f 756c 6420 6861 7665 omake would have │ │ │ │ │ -0003a230: 2069 7373 7565 6420 610a 7761 726e 696e issued a.warnin │ │ │ │ │ -0003a240: 672e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2048 g...* Menu:..* H │ │ │ │ │ -0003a250: 6f77 2074 6865 204c 696e 6b65 7220 6973 ow the Linker is │ │ │ │ │ -0003a260: 2043 686f 7365 6e3a 3a20 2020 2041 7574 Chosen:: Aut │ │ │ │ │ -0003a270: 6f6d 6174 6963 206c 696e 6b65 7220 7365 omatic linker se │ │ │ │ │ -0003a280: 6c65 6374 696f 6e0a 0a20 2020 2d2d 2d2d lection.. ---- │ │ │ │ │ -0003a290: 2d2d 2d2d 2d2d 2046 6f6f 746e 6f74 6573 ------ Footnotes │ │ │ │ │ -0003a2a0: 202d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 ----------.. │ │ │ │ │ -0003a2b0: 2831 2920 466f 7220 6578 616d 706c 652c (1) For example, │ │ │ │ │ -0003a2c0: 2074 6865 2063 666f 7274 7261 6e20 7061 the cfortran pa │ │ │ │ │ -0003a2d0: 636b 6167 650a 2868 7474 703a 2f2f 7777 ckage.(http://ww │ │ │ │ │ -0003a2e0: 772d 7a65 7573 2e64 6573 792e 6465 2f7e w-zeus.desy.de/~ │ │ │ │ │ -0003a2f0: 6275 726f 772f 6366 6f72 7472 616e 2f29 burow/cfortran/) │ │ │ │ │ -0003a300: 2061 6464 7265 7373 6573 2061 6c6c 206f addresses all o │ │ │ │ │ -0003a310: 6620 7468 6573 650a 696e 7465 722d 6c61 f these.inter-la │ │ │ │ │ -0003a320: 6e67 7561 6765 2069 7373 7565 732c 2061 nguage issues, a │ │ │ │ │ -0003a330: 6e64 2072 756e 7320 756e 6465 7220 6e65 nd runs under ne │ │ │ │ │ -0003a340: 6172 6c79 2061 6c6c 2046 6f72 7472 616e arly all Fortran │ │ │ │ │ -0003a350: 2037 372c 2043 2061 6e64 2043 2b2b 0a63 77, C and C++.c │ │ │ │ │ -0003a360: 6f6d 7069 6c65 7273 206f 6e20 6e65 6172 ompilers on near │ │ │ │ │ -0003a370: 6c79 2061 6c6c 2070 6c61 7466 6f72 6d73 ly all platforms │ │ │ │ │ -0003a380: 2e20 2048 6f77 6576 6572 2c20 2763 666f . However, 'cfo │ │ │ │ │ -0003a390: 7274 7261 6e27 2069 7320 6e6f 7420 7965 rtran' is not ye │ │ │ │ │ -0003a3a0: 7420 4672 6565 0a53 6f66 7477 6172 652c t Free.Software, │ │ │ │ │ -0003a3b0: 2062 7574 2069 7420 7769 6c6c 2062 6520 but it will be │ │ │ │ │ -0003a3c0: 696e 2074 6865 206e 6578 7420 6d61 6a6f in the next majo │ │ │ │ │ -0003a3d0: 7220 7265 6c65 6173 652e 0a0a 1f0a 4669 r release.....Fi │ │ │ │ │ -0003a3e0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ -0003a3f0: 312e 696e 666f 2c20 204e 6f64 653a 2048 1.info, Node: H │ │ │ │ │ -0003a400: 6f77 2074 6865 204c 696e 6b65 7220 6973 ow the Linker is │ │ │ │ │ -0003a410: 2043 686f 7365 6e2c 2020 5570 3a20 4d69 Chosen, Up: Mi │ │ │ │ │ -0003a420: 7869 6e67 2046 6f72 7472 616e 2037 3720 xing Fortran 77 │ │ │ │ │ -0003a430: 5769 7468 2043 2061 6e64 2043 2b2b 0a0a With C and C++.. │ │ │ │ │ -0003a440: 382e 3133 2e33 2e31 2048 6f77 2074 6865 8.13.3.1 How the │ │ │ │ │ -0003a450: 204c 696e 6b65 7220 6973 2043 686f 7365 Linker is Chose │ │ │ │ │ -0003a460: 6e0a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e n............... │ │ │ │ │ +00039a60: 2d2d 2d2d 2d2d 2d0a 0a41 7574 6f6d 616b -------..Automak │ │ │ │ │ +00039a70: 6520 6375 7272 656e 746c 7920 7072 6f76 e currently prov │ │ │ │ │ +00039a80: 6964 6573 205f 6c69 6d69 7465 645f 2073 ides _limited_ s │ │ │ │ │ +00039a90: 7570 706f 7274 2066 6f72 2063 7265 6174 upport for creat │ │ │ │ │ +00039aa0: 696e 6720 7072 6f67 7261 6d73 2061 6e64 ing programs and │ │ │ │ │ +00039ab0: 0a73 6861 7265 6420 6c69 6272 6172 6965 .shared librarie │ │ │ │ │ +00039ac0: 7320 7468 6174 2061 7265 2061 206d 6978 s that are a mix │ │ │ │ │ +00039ad0: 7475 7265 206f 6620 466f 7274 7261 6e20 ture of Fortran │ │ │ │ │ +00039ae0: 3737 2061 6e64 2043 2061 6e64 2f6f 7220 77 and C and/or │ │ │ │ │ +00039af0: 432b 2b2e 0a48 6f77 6576 6572 2c20 7468 C++..However, th │ │ │ │ │ +00039b00: 6572 6520 6172 6520 6d61 6e79 206f 7468 ere are many oth │ │ │ │ │ +00039b10: 6572 2069 7373 7565 7320 7265 6c61 7465 er issues relate │ │ │ │ │ +00039b20: 6420 746f 206d 6978 696e 6720 466f 7274 d to mixing Fort │ │ │ │ │ +00039b30: 7261 6e20 3737 2077 6974 680a 6f74 6865 ran 77 with.othe │ │ │ │ │ +00039b40: 7220 6c61 6e67 7561 6765 7320 7468 6174 r languages that │ │ │ │ │ +00039b50: 2061 7265 205f 6e6f 745f 2028 6375 7272 are _not_ (curr │ │ │ │ │ +00039b60: 656e 746c 7929 2068 616e 646c 6564 2062 ently) handled b │ │ │ │ │ +00039b70: 7920 4175 746f 6d61 6b65 2c20 6275 7420 y Automake, but │ │ │ │ │ +00039b80: 7468 6174 0a61 7265 2068 616e 646c 6564 that.are handled │ │ │ │ │ +00039b90: 2062 7920 6f74 6865 7220 7061 636b 6167 by other packag │ │ │ │ │ +00039ba0: 6573 2831 292e 0a0a 2020 2041 7574 6f6d es(1)... Autom │ │ │ │ │ +00039bb0: 616b 6520 6361 6e20 6865 6c70 2069 6e20 ake can help in │ │ │ │ │ +00039bc0: 7477 6f20 7761 7973 3a0a 0a20 2031 2e20 two ways:.. 1. │ │ │ │ │ +00039bd0: 4175 746f 6d61 7469 6320 7365 6c65 6374 Automatic select │ │ │ │ │ +00039be0: 696f 6e20 6f66 2074 6865 206c 696e 6b65 ion of the linke │ │ │ │ │ +00039bf0: 7220 6465 7065 6e64 696e 6720 6f6e 2077 r depending on w │ │ │ │ │ +00039c00: 6869 6368 2063 6f6d 6269 6e61 7469 6f6e hich combination │ │ │ │ │ +00039c10: 730a 2020 2020 206f 6620 736f 7572 6365 s. of source │ │ │ │ │ +00039c20: 2063 6f64 652e 0a0a 2020 322e 2041 7574 code... 2. Aut │ │ │ │ │ +00039c30: 6f6d 6174 6963 2073 656c 6563 7469 6f6e omatic selection │ │ │ │ │ +00039c40: 206f 6620 7468 6520 6170 7072 6f70 7269 of the appropri │ │ │ │ │ +00039c50: 6174 6520 6c69 6e6b 6572 2066 6c61 6773 ate linker flags │ │ │ │ │ +00039c60: 2028 652e 672e 2c20 272d 4c27 2061 6e64 (e.g., '-L' and │ │ │ │ │ +00039c70: 0a20 2020 2020 272d 6c27 2920 746f 2070 . '-l') to p │ │ │ │ │ +00039c80: 6173 7320 746f 2074 6865 2061 7574 6f6d ass to the autom │ │ │ │ │ +00039c90: 6174 6963 616c 6c79 2073 656c 6563 7465 atically selecte │ │ │ │ │ +00039ca0: 6420 6c69 6e6b 6572 2069 6e20 6f72 6465 d linker in orde │ │ │ │ │ +00039cb0: 7220 746f 206c 696e 6b0a 2020 2020 2069 r to link. i │ │ │ │ │ +00039cc0: 6e20 7468 6520 6170 7072 6f70 7269 6174 n the appropriat │ │ │ │ │ +00039cd0: 6520 466f 7274 7261 6e20 3737 2069 6e74 e Fortran 77 int │ │ │ │ │ +00039ce0: 7269 6e73 6963 2061 6e64 2072 756e 2d74 rinsic and run-t │ │ │ │ │ +00039cf0: 696d 6520 6c69 6272 6172 6965 732e 0a0a ime libraries... │ │ │ │ │ +00039d00: 2020 2020 2054 6865 7365 2065 7874 7261 These extra │ │ │ │ │ +00039d10: 2046 6f72 7472 616e 2037 3720 6c69 6e6b Fortran 77 link │ │ │ │ │ +00039d20: 6572 2066 6c61 6773 2061 7265 2073 7570 er flags are sup │ │ │ │ │ +00039d30: 706c 6965 6420 696e 2074 6865 206f 7574 plied in the out │ │ │ │ │ +00039d40: 7075 740a 2020 2020 2076 6172 6961 626c put. variabl │ │ │ │ │ +00039d50: 6520 2746 4c49 4253 2720 6279 2074 6865 e 'FLIBS' by the │ │ │ │ │ +00039d60: 2027 4143 5f46 3737 5f4c 4942 5241 5259 'AC_F77_LIBRARY │ │ │ │ │ +00039d70: 5f4c 4446 4c41 4753 2720 4175 746f 636f _LDFLAGS' Autoco │ │ │ │ │ +00039d80: 6e66 206d 6163 726f 0a20 2020 2020 7375 nf macro. su │ │ │ │ │ +00039d90: 7070 6c69 6564 2077 6974 6820 6e65 7765 pplied with newe │ │ │ │ │ +00039da0: 7220 7665 7273 696f 6e73 206f 6620 4175 r versions of Au │ │ │ │ │ +00039db0: 746f 636f 6e66 2028 4175 746f 636f 6e66 toconf (Autoconf │ │ │ │ │ +00039dc0: 2076 6572 7369 6f6e 2032 2e31 3320 616e version 2.13 an │ │ │ │ │ +00039dd0: 640a 2020 2020 206c 6174 6572 292e 2020 d. later). │ │ │ │ │ +00039de0: 2a4e 6f74 6520 466f 7274 7261 6e20 436f *Note Fortran Co │ │ │ │ │ +00039df0: 6d70 696c 6572 2043 6861 7261 6374 6572 mpiler Character │ │ │ │ │ +00039e00: 6973 7469 6373 3a20 2861 7574 6f63 6f6e istics: (autocon │ │ │ │ │ +00039e10: 6629 466f 7274 7261 6e0a 2020 2020 2043 f)Fortran. C │ │ │ │ │ +00039e20: 6f6d 7069 6c65 722e 0a0a 2020 2049 6620 ompiler... If │ │ │ │ │ +00039e30: 4175 746f 6d61 6b65 2064 6574 6563 7473 Automake detects │ │ │ │ │ +00039e40: 2074 6861 7420 6120 7072 6f67 7261 6d20 that a program │ │ │ │ │ +00039e50: 6f72 2073 6861 7265 6420 6c69 6272 6172 or shared librar │ │ │ │ │ +00039e60: 7920 2861 7320 6d65 6e74 696f 6e65 6420 y (as mentioned │ │ │ │ │ +00039e70: 696e 0a73 6f6d 6520 275f 5052 4f47 5241 in.some '_PROGRA │ │ │ │ │ +00039e80: 4d53 2720 6f72 2027 5f4c 544c 4942 5241 MS' or '_LTLIBRA │ │ │ │ │ +00039e90: 5249 4553 2720 7072 696d 6172 7929 2063 RIES' primary) c │ │ │ │ │ +00039ea0: 6f6e 7461 696e 7320 736f 7572 6365 2063 ontains source c │ │ │ │ │ +00039eb0: 6f64 6520 7468 6174 2069 730a 6120 6d69 ode that is.a mi │ │ │ │ │ +00039ec0: 7874 7572 6520 6f66 2046 6f72 7472 616e xture of Fortran │ │ │ │ │ +00039ed0: 2037 3720 616e 6420 4320 616e 642f 6f72 77 and C and/or │ │ │ │ │ +00039ee0: 2043 2b2b 2c20 7468 656e 2069 7420 7265 C++, then it re │ │ │ │ │ +00039ef0: 7175 6972 6573 2074 6861 7420 7468 650a quires that the. │ │ │ │ │ +00039f00: 6d61 6372 6f20 2741 435f 4637 375f 4c49 macro 'AC_F77_LI │ │ │ │ │ +00039f10: 4252 4152 595f 4c44 464c 4147 5327 2062 BRARY_LDFLAGS' b │ │ │ │ │ +00039f20: 6520 6361 6c6c 6564 2069 6e20 2763 6f6e e called in 'con │ │ │ │ │ +00039f30: 6669 6775 7265 2e61 6327 2c20 616e 6420 figure.ac', and │ │ │ │ │ +00039f40: 7468 6174 0a65 6974 6865 7220 2724 2846 that.either '$(F │ │ │ │ │ +00039f50: 4c49 4253 2927 2061 7070 6561 7220 696e LIBS)' appear in │ │ │ │ │ +00039f60: 2074 6865 2061 7070 726f 7072 6961 7465 the appropriate │ │ │ │ │ +00039f70: 2027 5f4c 4441 4444 2720 2866 6f72 2070 '_LDADD' (for p │ │ │ │ │ +00039f80: 726f 6772 616d 7329 206f 720a 275f 4c49 rograms) or.'_LI │ │ │ │ │ +00039f90: 4241 4444 2720 2866 6f72 2073 6861 7265 BADD' (for share │ │ │ │ │ +00039fa0: 6420 6c69 6272 6172 6965 7329 2076 6172 d libraries) var │ │ │ │ │ +00039fb0: 6961 626c 6573 2e20 2049 7420 6973 2074 iables. It is t │ │ │ │ │ +00039fc0: 6865 2072 6573 706f 6e73 6962 696c 6974 he responsibilit │ │ │ │ │ +00039fd0: 7920 6f66 0a74 6865 2070 6572 736f 6e20 y of.the person │ │ │ │ │ +00039fe0: 7772 6974 696e 6720 7468 6520 274d 616b writing the 'Mak │ │ │ │ │ +00039ff0: 6566 696c 652e 616d 2720 746f 206d 616b efile.am' to mak │ │ │ │ │ +0003a000: 6520 7375 7265 2074 6861 7420 2724 2846 e sure that '$(F │ │ │ │ │ +0003a010: 4c49 4253 2927 0a61 7070 6561 7273 2069 LIBS)'.appears i │ │ │ │ │ +0003a020: 6e20 7468 6520 6170 7072 6f70 7269 6174 n the appropriat │ │ │ │ │ +0003a030: 6520 275f 4c44 4144 4427 206f 7220 275f e '_LDADD' or '_ │ │ │ │ │ +0003a040: 4c49 4241 4444 2720 7661 7269 6162 6c65 LIBADD' variable │ │ │ │ │ +0003a050: 2e0a 0a20 2020 466f 7220 6578 616d 706c ... For exampl │ │ │ │ │ +0003a060: 652c 2063 6f6e 7369 6465 7220 7468 6520 e, consider the │ │ │ │ │ +0003a070: 666f 6c6c 6f77 696e 6720 274d 616b 6566 following 'Makef │ │ │ │ │ +0003a080: 696c 652e 616d 273a 0a0a 2020 2020 2062 ile.am':.. b │ │ │ │ │ +0003a090: 696e 5f50 524f 4752 414d 5320 3d20 666f in_PROGRAMS = fo │ │ │ │ │ +0003a0a0: 6f0a 2020 2020 2066 6f6f 5f53 4f55 5243 o. foo_SOURC │ │ │ │ │ +0003a0b0: 4553 2020 3d20 6d61 696e 2e63 6320 666f ES = main.cc fo │ │ │ │ │ +0003a0c0: 6f2e 660a 2020 2020 2066 6f6f 5f4c 4441 o.f. foo_LDA │ │ │ │ │ +0003a0d0: 4444 2020 2020 3d20 6c69 6266 6f6f 2e6c DD = libfoo.l │ │ │ │ │ +0003a0e0: 6120 2428 464c 4942 5329 0a0a 2020 2020 a $(FLIBS).. │ │ │ │ │ +0003a0f0: 2070 6b67 6c69 625f 4c54 4c49 4252 4152 pkglib_LTLIBRAR │ │ │ │ │ +0003a100: 4945 5320 3d20 6c69 6266 6f6f 2e6c 610a IES = libfoo.la. │ │ │ │ │ +0003a110: 2020 2020 206c 6962 666f 6f5f 6c61 5f53 libfoo_la_S │ │ │ │ │ +0003a120: 4f55 5243 4553 2020 3d20 6261 722e 6620 OURCES = bar.f │ │ │ │ │ +0003a130: 6261 7a2e 6320 7a61 7264 6f7a 2e63 630a baz.c zardoz.cc. │ │ │ │ │ +0003a140: 2020 2020 206c 6962 666f 6f5f 6c61 5f4c libfoo_la_L │ │ │ │ │ +0003a150: 4942 4144 4420 2020 3d20 2428 464c 4942 IBADD = $(FLIB │ │ │ │ │ +0003a160: 5329 0a0a 2020 2049 6e20 7468 6973 2063 S).. In this c │ │ │ │ │ +0003a170: 6173 652c 2041 7574 6f6d 616b 6520 7769 ase, Automake wi │ │ │ │ │ +0003a180: 6c6c 2069 6e73 6973 7420 7468 6174 2027 ll insist that ' │ │ │ │ │ +0003a190: 4143 5f46 3737 5f4c 4942 5241 5259 5f4c AC_F77_LIBRARY_L │ │ │ │ │ +0003a1a0: 4446 4c41 4753 2720 6973 0a6d 656e 7469 DFLAGS' is.menti │ │ │ │ │ +0003a1b0: 6f6e 6564 2069 6e20 2763 6f6e 6669 6775 oned in 'configu │ │ │ │ │ +0003a1c0: 7265 2e61 6327 2e20 2041 6c73 6f2c 2069 re.ac'. Also, i │ │ │ │ │ +0003a1d0: 6620 2724 2846 4c49 4253 2927 2068 6164 f '$(FLIBS)' had │ │ │ │ │ +0003a1e0: 6e27 7420 6265 656e 206d 656e 7469 6f6e n't been mention │ │ │ │ │ +0003a1f0: 6564 0a69 6e20 2766 6f6f 5f4c 4441 4444 ed.in 'foo_LDADD │ │ │ │ │ +0003a200: 2720 616e 6420 276c 6962 666f 6f5f 6c61 ' and 'libfoo_la │ │ │ │ │ +0003a210: 5f4c 4942 4144 4427 2c20 7468 656e 2041 _LIBADD', then A │ │ │ │ │ +0003a220: 7574 6f6d 616b 6520 776f 756c 6420 6861 utomake would ha │ │ │ │ │ +0003a230: 7665 2069 7373 7565 6420 610a 7761 726e ve issued a.warn │ │ │ │ │ +0003a240: 696e 672e 0a0a 2a20 4d65 6e75 3a0a 0a2a ing...* Menu:..* │ │ │ │ │ +0003a250: 2048 6f77 2074 6865 204c 696e 6b65 7220 How the Linker │ │ │ │ │ +0003a260: 6973 2043 686f 7365 6e3a 3a20 2020 2041 is Chosen:: A │ │ │ │ │ +0003a270: 7574 6f6d 6174 6963 206c 696e 6b65 7220 utomatic linker │ │ │ │ │ +0003a280: 7365 6c65 6374 696f 6e0a 0a20 2020 2d2d selection.. -- │ │ │ │ │ +0003a290: 2d2d 2d2d 2d2d 2d2d 2046 6f6f 746e 6f74 -------- Footnot │ │ │ │ │ +0003a2a0: 6573 202d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 es ----------.. │ │ │ │ │ +0003a2b0: 2020 2831 2920 466f 7220 6578 616d 706c (1) For exampl │ │ │ │ │ +0003a2c0: 652c 2074 6865 2063 666f 7274 7261 6e20 e, the cfortran │ │ │ │ │ +0003a2d0: 7061 636b 6167 650a 2868 7474 703a 2f2f package.(http:// │ │ │ │ │ +0003a2e0: 7777 772d 7a65 7573 2e64 6573 792e 6465 www-zeus.desy.de │ │ │ │ │ +0003a2f0: 2f7e 6275 726f 772f 6366 6f72 7472 616e /~burow/cfortran │ │ │ │ │ +0003a300: 2f29 2061 6464 7265 7373 6573 2061 6c6c /) addresses all │ │ │ │ │ +0003a310: 206f 6620 7468 6573 650a 696e 7465 722d of these.inter- │ │ │ │ │ +0003a320: 6c61 6e67 7561 6765 2069 7373 7565 732c language issues, │ │ │ │ │ +0003a330: 2061 6e64 2072 756e 7320 756e 6465 7220 and runs under │ │ │ │ │ +0003a340: 6e65 6172 6c79 2061 6c6c 2046 6f72 7472 nearly all Fortr │ │ │ │ │ +0003a350: 616e 2037 372c 2043 2061 6e64 2043 2b2b an 77, C and C++ │ │ │ │ │ +0003a360: 0a63 6f6d 7069 6c65 7273 206f 6e20 6e65 .compilers on ne │ │ │ │ │ +0003a370: 6172 6c79 2061 6c6c 2070 6c61 7466 6f72 arly all platfor │ │ │ │ │ +0003a380: 6d73 2e20 2048 6f77 6576 6572 2c20 2763 ms. However, 'c │ │ │ │ │ +0003a390: 666f 7274 7261 6e27 2069 7320 6e6f 7420 fortran' is not │ │ │ │ │ +0003a3a0: 7965 7420 4672 6565 0a53 6f66 7477 6172 yet Free.Softwar │ │ │ │ │ +0003a3b0: 652c 2062 7574 2069 7420 7769 6c6c 2062 e, but it will b │ │ │ │ │ +0003a3c0: 6520 696e 2074 6865 206e 6578 7420 6d61 e in the next ma │ │ │ │ │ +0003a3d0: 6a6f 7220 7265 6c65 6173 652e 0a0a 1f0a jor release..... │ │ │ │ │ +0003a3e0: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +0003a3f0: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +0003a400: 2048 6f77 2074 6865 204c 696e 6b65 7220 How the Linker │ │ │ │ │ +0003a410: 6973 2043 686f 7365 6e2c 2020 5570 3a20 is Chosen, Up: │ │ │ │ │ +0003a420: 4d69 7869 6e67 2046 6f72 7472 616e 2037 Mixing Fortran 7 │ │ │ │ │ +0003a430: 3720 5769 7468 2043 2061 6e64 2043 2b2b 7 With C and C++ │ │ │ │ │ +0003a440: 0a0a 382e 3133 2e33 2e31 2048 6f77 2074 ..8.13.3.1 How t │ │ │ │ │ +0003a450: 6865 204c 696e 6b65 7220 6973 2043 686f he Linker is Cho │ │ │ │ │ +0003a460: 7365 6e0a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e sen............. │ │ │ │ │ 0003a470: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -0003a480: 2e2e 2e0a 0a57 6865 6e20 6120 7072 6f67 .....When a prog │ │ │ │ │ -0003a490: 7261 6d20 6f72 206c 6962 7261 7279 206d ram or library m │ │ │ │ │ -0003a4a0: 6978 6573 2073 6576 6572 616c 206c 616e ixes several lan │ │ │ │ │ -0003a4b0: 6775 6167 6573 2c20 4175 746f 6d61 6b65 guages, Automake │ │ │ │ │ -0003a4c0: 2063 686f 6f73 6520 7468 650a 6c69 6e6b choose the.link │ │ │ │ │ -0003a4d0: 6572 2061 6363 6f72 6469 6e67 2074 6f20 er according to │ │ │ │ │ -0003a4e0: 7468 6520 666f 6c6c 6f77 696e 6720 7072 the following pr │ │ │ │ │ -0003a4f0: 696f 7269 7469 6573 2e20 2028 5468 6520 iorities. (The │ │ │ │ │ -0003a500: 6e61 6d65 7320 696e 2070 6172 656e 7468 names in parenth │ │ │ │ │ -0003a510: 6573 6573 0a61 7265 2074 6865 2076 6172 eses.are the var │ │ │ │ │ -0003a520: 6961 626c 6573 2063 6f6e 7461 696e 696e iables containin │ │ │ │ │ -0003a530: 6720 7468 6520 6c69 6e6b 2063 6f6d 6d61 g the link comma │ │ │ │ │ -0003a540: 6e64 2e29 0a0a 2020 312e 204e 6174 6976 nd.).. 1. Nativ │ │ │ │ │ -0003a550: 6520 4a61 7661 2028 2747 434a 4c49 4e4b e Java ('GCJLINK │ │ │ │ │ -0003a560: 2729 0a20 2032 2e20 432b 2b20 2827 4358 '). 2. C++ ('CX │ │ │ │ │ -0003a570: 584c 494e 4b27 290a 2020 332e 2046 6f72 XLINK'). 3. For │ │ │ │ │ -0003a580: 7472 616e 2037 3720 2827 4637 374c 494e tran 77 ('F77LIN │ │ │ │ │ -0003a590: 4b27 290a 2020 342e 2046 6f72 7472 616e K'). 4. Fortran │ │ │ │ │ -0003a5a0: 2028 2746 434c 494e 4b27 290a 2020 352e ('FCLINK'). 5. │ │ │ │ │ -0003a5b0: 204f 626a 6563 7469 7665 2043 2028 274f Objective C ('O │ │ │ │ │ -0003a5c0: 424a 434c 494e 4b27 290a 2020 362e 2055 BJCLINK'). 6. U │ │ │ │ │ -0003a5d0: 6e69 6669 6564 2050 6172 616c 6c65 6c20 nified Parallel │ │ │ │ │ -0003a5e0: 4320 2827 5550 434c 494e 4b27 290a 2020 C ('UPCLINK'). │ │ │ │ │ -0003a5f0: 372e 2043 2028 274c 494e 4b27 290a 0a20 7. C ('LINK').. │ │ │ │ │ -0003a600: 2020 466f 7220 6578 616d 706c 652c 2069 For example, i │ │ │ │ │ -0003a610: 6620 466f 7274 7261 6e20 3737 2c20 4320 f Fortran 77, C │ │ │ │ │ -0003a620: 616e 6420 432b 2b20 736f 7572 6365 2063 and C++ source c │ │ │ │ │ -0003a630: 6f64 6520 6973 2063 6f6d 7069 6c65 6420 ode is compiled │ │ │ │ │ -0003a640: 696e 746f 2061 0a70 726f 6772 616d 2c20 into a.program, │ │ │ │ │ -0003a650: 7468 656e 2074 6865 2043 2b2b 206c 696e then the C++ lin │ │ │ │ │ -0003a660: 6b65 7220 7769 6c6c 2062 6520 7573 6564 ker will be used │ │ │ │ │ -0003a670: 2e20 2049 6e20 7468 6973 2063 6173 652c . In this case, │ │ │ │ │ -0003a680: 2069 6620 7468 6520 4320 6f72 0a46 6f72 if the C or.For │ │ │ │ │ -0003a690: 7472 616e 2037 3720 6c69 6e6b 6572 7320 tran 77 linkers │ │ │ │ │ -0003a6a0: 7265 7175 6972 6564 2061 6e79 2073 7065 required any spe │ │ │ │ │ -0003a6b0: 6369 616c 206c 6962 7261 7269 6573 2074 cial libraries t │ │ │ │ │ -0003a6c0: 6861 7420 7765 7265 6e27 7420 696e 636c hat weren't incl │ │ │ │ │ -0003a6d0: 7564 6564 0a62 7920 7468 6520 432b 2b20 uded.by the C++ │ │ │ │ │ -0003a6e0: 6c69 6e6b 6572 2c20 7468 656e 2074 6865 linker, then the │ │ │ │ │ -0003a6f0: 7920 6d75 7374 2062 6520 6d61 6e75 616c y must be manual │ │ │ │ │ -0003a700: 6c79 2061 6464 6564 2074 6f20 616e 2027 ly added to an ' │ │ │ │ │ -0003a710: 5f4c 4441 4444 2720 6f72 0a27 5f4c 4942 _LDADD' or.'_LIB │ │ │ │ │ -0003a720: 4144 4427 2076 6172 6961 626c 6520 6279 ADD' variable by │ │ │ │ │ -0003a730: 2074 6865 2075 7365 7220 7772 6974 696e the user writin │ │ │ │ │ -0003a740: 6720 7468 6520 274d 616b 6566 696c 652e g the 'Makefile. │ │ │ │ │ -0003a750: 616d 272e 0a0a 2020 2041 7574 6f6d 616b am'... Automak │ │ │ │ │ -0003a760: 6520 6f6e 6c79 206c 6f6f 6b73 2061 7420 e only looks at │ │ │ │ │ -0003a770: 7468 6520 6669 6c65 206e 616d 6573 206c the file names l │ │ │ │ │ -0003a780: 6973 7465 6420 696e 2027 5f53 4f55 5243 isted in '_SOURC │ │ │ │ │ -0003a790: 4553 2720 7661 7269 6162 6c65 730a 746f ES' variables.to │ │ │ │ │ -0003a7a0: 2063 686f 6f73 6520 7468 6520 6c69 6e6b choose the link │ │ │ │ │ -0003a7b0: 6572 2c20 616e 6420 6465 6661 756c 7473 er, and defaults │ │ │ │ │ -0003a7c0: 2074 6f20 7468 6520 4320 6c69 6e6b 6572 to the C linker │ │ │ │ │ -0003a7d0: 2e20 2053 6f6d 6574 696d 6573 2074 6869 . Sometimes thi │ │ │ │ │ -0003a7e0: 7320 6973 0a69 6e63 6f6e 7665 6e69 656e s is.inconvenien │ │ │ │ │ -0003a7f0: 7420 6265 6361 7573 6520 796f 7520 6172 t because you ar │ │ │ │ │ -0003a800: 6520 6c69 6e6b 696e 6720 6167 6169 6e73 e linking agains │ │ │ │ │ -0003a810: 7420 6120 6c69 6272 6172 7920 7772 6974 t a library writ │ │ │ │ │ -0003a820: 7465 6e20 696e 0a61 6e6f 7468 6572 206c ten in.another l │ │ │ │ │ -0003a830: 616e 6775 6167 6520 616e 6420 776f 756c anguage and woul │ │ │ │ │ -0003a840: 6420 6c69 6b65 2074 6f20 7365 7420 7468 d like to set th │ │ │ │ │ -0003a850: 6520 6c69 6e6b 6572 206d 6f72 6520 6170 e linker more ap │ │ │ │ │ -0003a860: 7072 6f70 7269 6174 656c 792e 0a2a 4e6f propriately..*No │ │ │ │ │ -0003a870: 7465 204c 6962 746f 6f6c 2043 6f6e 7665 te Libtool Conve │ │ │ │ │ -0003a880: 6e69 656e 6365 204c 6962 7261 7269 6573 nience Libraries │ │ │ │ │ -0003a890: 3a3a 2c20 666f 7220 6120 7472 6963 6b20 ::, for a trick │ │ │ │ │ -0003a8a0: 7769 7468 0a27 6e6f 6469 7374 5f45 5854 with.'nodist_EXT │ │ │ │ │ -0003a8b0: 5241 5f2e 2e2e 5f53 4f55 5243 4553 272e RA_..._SOURCES'. │ │ │ │ │ -0003a8c0: 0a0a 2020 2041 2070 6572 2d74 6172 6765 .. A per-targe │ │ │ │ │ -0003a8d0: 7420 275f 4c49 4e4b 2720 7661 7269 6162 t '_LINK' variab │ │ │ │ │ -0003a8e0: 6c65 2077 696c 6c20 6f76 6572 7269 6465 le will override │ │ │ │ │ -0003a8f0: 2074 6865 2061 626f 7665 2073 656c 6563 the above selec │ │ │ │ │ -0003a900: 7469 6f6e 2e0a 5065 722d 7461 7267 6574 tion..Per-target │ │ │ │ │ -0003a910: 206c 696e 6b20 666c 6167 7320 7769 6c6c link flags will │ │ │ │ │ -0003a920: 2063 6175 7365 2041 7574 6f6d 616b 6520 cause Automake │ │ │ │ │ -0003a930: 746f 2077 7269 7465 2061 2070 6572 2d74 to write a per-t │ │ │ │ │ -0003a940: 6172 6765 7420 275f 4c49 4e4b 270a 7661 arget '_LINK'.va │ │ │ │ │ -0003a950: 7269 6162 6c65 2061 6363 6f72 6469 6e67 riable according │ │ │ │ │ -0003a960: 2074 6f20 7468 6520 6c61 6e67 7561 6765 to the language │ │ │ │ │ -0003a970: 2063 686f 7365 6e20 6173 2061 626f 7665 chosen as above │ │ │ │ │ -0003a980: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ -0003a990: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -0003a9a0: 4e6f 6465 3a20 466f 7274 7261 6e20 3978 Node: Fortran 9x │ │ │ │ │ -0003a9b0: 2053 7570 706f 7274 2c20 204e 6578 743a Support, Next: │ │ │ │ │ -0003a9c0: 204a 6176 6120 5375 7070 6f72 7420 7769 Java Support wi │ │ │ │ │ -0003a9d0: 7468 2067 636a 2c20 2050 7265 763a 2046 th gcj, Prev: F │ │ │ │ │ -0003a9e0: 6f72 7472 616e 2037 3720 5375 7070 6f72 ortran 77 Suppor │ │ │ │ │ -0003a9f0: 742c 2020 5570 3a20 5072 6f67 7261 6d73 t, Up: Programs │ │ │ │ │ -0003aa00: 0a0a 382e 3134 2046 6f72 7472 616e 2039 ..8.14 Fortran 9 │ │ │ │ │ -0003aa10: 7820 5375 7070 6f72 740a 3d3d 3d3d 3d3d x Support.====== │ │ │ │ │ +0003a480: 2e2e 2e2e 2e0a 0a57 6865 6e20 6120 7072 .......When a pr │ │ │ │ │ +0003a490: 6f67 7261 6d20 6f72 206c 6962 7261 7279 ogram or library │ │ │ │ │ +0003a4a0: 206d 6978 6573 2073 6576 6572 616c 206c mixes several l │ │ │ │ │ +0003a4b0: 616e 6775 6167 6573 2c20 4175 746f 6d61 anguages, Automa │ │ │ │ │ +0003a4c0: 6b65 2063 686f 6f73 6520 7468 650a 6c69 ke choose the.li │ │ │ │ │ +0003a4d0: 6e6b 6572 2061 6363 6f72 6469 6e67 2074 nker according t │ │ │ │ │ +0003a4e0: 6f20 7468 6520 666f 6c6c 6f77 696e 6720 o the following │ │ │ │ │ +0003a4f0: 7072 696f 7269 7469 6573 2e20 2028 5468 priorities. (Th │ │ │ │ │ +0003a500: 6520 6e61 6d65 7320 696e 2070 6172 656e e names in paren │ │ │ │ │ +0003a510: 7468 6573 6573 0a61 7265 2074 6865 2076 theses.are the v │ │ │ │ │ +0003a520: 6172 6961 626c 6573 2063 6f6e 7461 696e ariables contain │ │ │ │ │ +0003a530: 696e 6720 7468 6520 6c69 6e6b 2063 6f6d ing the link com │ │ │ │ │ +0003a540: 6d61 6e64 2e29 0a0a 2020 312e 204e 6174 mand.).. 1. Nat │ │ │ │ │ +0003a550: 6976 6520 4a61 7661 2028 2747 434a 4c49 ive Java ('GCJLI │ │ │ │ │ +0003a560: 4e4b 2729 0a20 2032 2e20 432b 2b20 2827 NK'). 2. C++ (' │ │ │ │ │ +0003a570: 4358 584c 494e 4b27 290a 2020 332e 2046 CXXLINK'). 3. F │ │ │ │ │ +0003a580: 6f72 7472 616e 2037 3720 2827 4637 374c ortran 77 ('F77L │ │ │ │ │ +0003a590: 494e 4b27 290a 2020 342e 2046 6f72 7472 INK'). 4. Fortr │ │ │ │ │ +0003a5a0: 616e 2028 2746 434c 494e 4b27 290a 2020 an ('FCLINK'). │ │ │ │ │ +0003a5b0: 352e 204f 626a 6563 7469 7665 2043 2028 5. Objective C ( │ │ │ │ │ +0003a5c0: 274f 424a 434c 494e 4b27 290a 2020 362e 'OBJCLINK'). 6. │ │ │ │ │ +0003a5d0: 2055 6e69 6669 6564 2050 6172 616c 6c65 Unified Paralle │ │ │ │ │ +0003a5e0: 6c20 4320 2827 5550 434c 494e 4b27 290a l C ('UPCLINK'). │ │ │ │ │ +0003a5f0: 2020 372e 2043 2028 274c 494e 4b27 290a 7. C ('LINK'). │ │ │ │ │ +0003a600: 0a20 2020 466f 7220 6578 616d 706c 652c . For example, │ │ │ │ │ +0003a610: 2069 6620 466f 7274 7261 6e20 3737 2c20 if Fortran 77, │ │ │ │ │ +0003a620: 4320 616e 6420 432b 2b20 736f 7572 6365 C and C++ source │ │ │ │ │ +0003a630: 2063 6f64 6520 6973 2063 6f6d 7069 6c65 code is compile │ │ │ │ │ +0003a640: 6420 696e 746f 2061 0a70 726f 6772 616d d into a.program │ │ │ │ │ +0003a650: 2c20 7468 656e 2074 6865 2043 2b2b 206c , then the C++ l │ │ │ │ │ +0003a660: 696e 6b65 7220 7769 6c6c 2062 6520 7573 inker will be us │ │ │ │ │ +0003a670: 6564 2e20 2049 6e20 7468 6973 2063 6173 ed. In this cas │ │ │ │ │ +0003a680: 652c 2069 6620 7468 6520 4320 6f72 0a46 e, if the C or.F │ │ │ │ │ +0003a690: 6f72 7472 616e 2037 3720 6c69 6e6b 6572 ortran 77 linker │ │ │ │ │ +0003a6a0: 7320 7265 7175 6972 6564 2061 6e79 2073 s required any s │ │ │ │ │ +0003a6b0: 7065 6369 616c 206c 6962 7261 7269 6573 pecial libraries │ │ │ │ │ +0003a6c0: 2074 6861 7420 7765 7265 6e27 7420 696e that weren't in │ │ │ │ │ +0003a6d0: 636c 7564 6564 0a62 7920 7468 6520 432b cluded.by the C+ │ │ │ │ │ +0003a6e0: 2b20 6c69 6e6b 6572 2c20 7468 656e 2074 + linker, then t │ │ │ │ │ +0003a6f0: 6865 7920 6d75 7374 2062 6520 6d61 6e75 hey must be manu │ │ │ │ │ +0003a700: 616c 6c79 2061 6464 6564 2074 6f20 616e ally added to an │ │ │ │ │ +0003a710: 2027 5f4c 4441 4444 2720 6f72 0a27 5f4c '_LDADD' or.'_L │ │ │ │ │ +0003a720: 4942 4144 4427 2076 6172 6961 626c 6520 IBADD' variable │ │ │ │ │ +0003a730: 6279 2074 6865 2075 7365 7220 7772 6974 by the user writ │ │ │ │ │ +0003a740: 696e 6720 7468 6520 274d 616b 6566 696c ing the 'Makefil │ │ │ │ │ +0003a750: 652e 616d 272e 0a0a 2020 2041 7574 6f6d e.am'... Autom │ │ │ │ │ +0003a760: 616b 6520 6f6e 6c79 206c 6f6f 6b73 2061 ake only looks a │ │ │ │ │ +0003a770: 7420 7468 6520 6669 6c65 206e 616d 6573 t the file names │ │ │ │ │ +0003a780: 206c 6973 7465 6420 696e 2027 5f53 4f55 listed in '_SOU │ │ │ │ │ +0003a790: 5243 4553 2720 7661 7269 6162 6c65 730a RCES' variables. │ │ │ │ │ +0003a7a0: 746f 2063 686f 6f73 6520 7468 6520 6c69 to choose the li │ │ │ │ │ +0003a7b0: 6e6b 6572 2c20 616e 6420 6465 6661 756c nker, and defaul │ │ │ │ │ +0003a7c0: 7473 2074 6f20 7468 6520 4320 6c69 6e6b ts to the C link │ │ │ │ │ +0003a7d0: 6572 2e20 2053 6f6d 6574 696d 6573 2074 er. Sometimes t │ │ │ │ │ +0003a7e0: 6869 7320 6973 0a69 6e63 6f6e 7665 6e69 his is.inconveni │ │ │ │ │ +0003a7f0: 656e 7420 6265 6361 7573 6520 796f 7520 ent because you │ │ │ │ │ +0003a800: 6172 6520 6c69 6e6b 696e 6720 6167 6169 are linking agai │ │ │ │ │ +0003a810: 6e73 7420 6120 6c69 6272 6172 7920 7772 nst a library wr │ │ │ │ │ +0003a820: 6974 7465 6e20 696e 0a61 6e6f 7468 6572 itten in.another │ │ │ │ │ +0003a830: 206c 616e 6775 6167 6520 616e 6420 776f language and wo │ │ │ │ │ +0003a840: 756c 6420 6c69 6b65 2074 6f20 7365 7420 uld like to set │ │ │ │ │ +0003a850: 7468 6520 6c69 6e6b 6572 206d 6f72 6520 the linker more │ │ │ │ │ +0003a860: 6170 7072 6f70 7269 6174 656c 792e 0a2a appropriately..* │ │ │ │ │ +0003a870: 4e6f 7465 204c 6962 746f 6f6c 2043 6f6e Note Libtool Con │ │ │ │ │ +0003a880: 7665 6e69 656e 6365 204c 6962 7261 7269 venience Librari │ │ │ │ │ +0003a890: 6573 3a3a 2c20 666f 7220 6120 7472 6963 es::, for a tric │ │ │ │ │ +0003a8a0: 6b20 7769 7468 0a27 6e6f 6469 7374 5f45 k with.'nodist_E │ │ │ │ │ +0003a8b0: 5854 5241 5f2e 2e2e 5f53 4f55 5243 4553 XTRA_..._SOURCES │ │ │ │ │ +0003a8c0: 272e 0a0a 2020 2041 2070 6572 2d74 6172 '... A per-tar │ │ │ │ │ +0003a8d0: 6765 7420 275f 4c49 4e4b 2720 7661 7269 get '_LINK' vari │ │ │ │ │ +0003a8e0: 6162 6c65 2077 696c 6c20 6f76 6572 7269 able will overri │ │ │ │ │ +0003a8f0: 6465 2074 6865 2061 626f 7665 2073 656c de the above sel │ │ │ │ │ +0003a900: 6563 7469 6f6e 2e0a 5065 722d 7461 7267 ection..Per-targ │ │ │ │ │ +0003a910: 6574 206c 696e 6b20 666c 6167 7320 7769 et link flags wi │ │ │ │ │ +0003a920: 6c6c 2063 6175 7365 2041 7574 6f6d 616b ll cause Automak │ │ │ │ │ +0003a930: 6520 746f 2077 7269 7465 2061 2070 6572 e to write a per │ │ │ │ │ +0003a940: 2d74 6172 6765 7420 275f 4c49 4e4b 270a -target '_LINK'. │ │ │ │ │ +0003a950: 7661 7269 6162 6c65 2061 6363 6f72 6469 variable accordi │ │ │ │ │ +0003a960: 6e67 2074 6f20 7468 6520 6c61 6e67 7561 ng to the langua │ │ │ │ │ +0003a970: 6765 2063 686f 7365 6e20 6173 2061 626f ge chosen as abo │ │ │ │ │ +0003a980: 7665 2e0a 0a1f 0a46 696c 653a 2061 7574 ve.....File: aut │ │ │ │ │ +0003a990: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +0003a9a0: 2020 4e6f 6465 3a20 466f 7274 7261 6e20 Node: Fortran │ │ │ │ │ +0003a9b0: 3978 2053 7570 706f 7274 2c20 204e 6578 9x Support, Nex │ │ │ │ │ +0003a9c0: 743a 204a 6176 6120 5375 7070 6f72 7420 t: Java Support │ │ │ │ │ +0003a9d0: 7769 7468 2067 636a 2c20 2050 7265 763a with gcj, Prev: │ │ │ │ │ +0003a9e0: 2046 6f72 7472 616e 2037 3720 5375 7070 Fortran 77 Supp │ │ │ │ │ +0003a9f0: 6f72 742c 2020 5570 3a20 5072 6f67 7261 ort, Up: Progra │ │ │ │ │ +0003aa00: 6d73 0a0a 382e 3134 2046 6f72 7472 616e ms..8.14 Fortran │ │ │ │ │ +0003aa10: 2039 7820 5375 7070 6f72 740a 3d3d 3d3d 9x Support.==== │ │ │ │ │ 0003aa20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003aa30: 3d0a 0a41 7574 6f6d 616b 6520 696e 636c =..Automake incl │ │ │ │ │ -0003aa40: 7564 6573 2073 7570 706f 7274 2066 6f72 udes support for │ │ │ │ │ -0003aa50: 2046 6f72 7472 616e 2039 782e 0a0a 2020 Fortran 9x... │ │ │ │ │ -0003aa60: 2041 6e79 2070 6163 6b61 6765 2069 6e63 Any package inc │ │ │ │ │ -0003aa70: 6c75 6469 6e67 2046 6f72 7472 616e 2039 luding Fortran 9 │ │ │ │ │ -0003aa80: 7820 636f 6465 206d 7573 7420 6465 6669 x code must defi │ │ │ │ │ -0003aa90: 6e65 2074 6865 206f 7574 7075 7420 7661 ne the output va │ │ │ │ │ -0003aaa0: 7269 6162 6c65 0a27 4643 2720 696e 2027 riable.'FC' in ' │ │ │ │ │ -0003aab0: 636f 6e66 6967 7572 652e 6163 273b 2074 configure.ac'; t │ │ │ │ │ -0003aac0: 6865 2073 696d 706c 6573 7420 7761 7920 he simplest way │ │ │ │ │ -0003aad0: 746f 2064 6f20 7468 6973 2069 7320 746f to do this is to │ │ │ │ │ -0003aae0: 2075 7365 2074 6865 0a27 4143 5f50 524f use the.'AC_PRO │ │ │ │ │ -0003aaf0: 475f 4643 2720 6d61 6372 6f20 282a 6e6f G_FC' macro (*no │ │ │ │ │ -0003ab00: 7465 2050 6172 7469 6375 6c61 7220 5072 te Particular Pr │ │ │ │ │ -0003ab10: 6f67 7261 6d20 4368 6563 6b73 3a0a 2861 ogram Checks:.(a │ │ │ │ │ -0003ab20: 7574 6f63 6f6e 6629 5061 7274 6963 756c utoconf)Particul │ │ │ │ │ -0003ab30: 6172 2050 726f 6772 616d 732e 292e 0a0a ar Programs.)... │ │ │ │ │ -0003ab40: 2020 2041 2066 6577 2061 6464 6974 696f A few additio │ │ │ │ │ -0003ab50: 6e61 6c20 7661 7269 6162 6c65 7320 6172 nal variables ar │ │ │ │ │ -0003ab60: 6520 6465 6669 6e65 6420 7768 656e 2061 e defined when a │ │ │ │ │ -0003ab70: 2046 6f72 7472 616e 2039 7820 736f 7572 Fortran 9x sour │ │ │ │ │ -0003ab80: 6365 2066 696c 650a 6973 2073 6565 6e3a ce file.is seen: │ │ │ │ │ -0003ab90: 0a0a 2746 4327 0a20 2020 2020 5468 6520 ..'FC'. The │ │ │ │ │ -0003aba0: 6e61 6d65 206f 6620 7468 6520 466f 7274 name of the Fort │ │ │ │ │ -0003abb0: 7261 6e20 3978 2063 6f6d 7069 6c65 722e ran 9x compiler. │ │ │ │ │ -0003abc0: 0a0a 2746 4346 4c41 4753 270a 2020 2020 ..'FCFLAGS'. │ │ │ │ │ -0003abd0: 2041 6e79 2066 6c61 6773 2074 6f20 7061 Any flags to pa │ │ │ │ │ -0003abe0: 7373 2074 6f20 7468 6520 466f 7274 7261 ss to the Fortra │ │ │ │ │ -0003abf0: 6e20 3978 2063 6f6d 7069 6c65 722e 0a0a n 9x compiler... │ │ │ │ │ -0003ac00: 2741 4d5f 4643 464c 4147 5327 0a20 2020 'AM_FCFLAGS'. │ │ │ │ │ -0003ac10: 2020 5468 6520 6d61 696e 7461 696e 6572 The maintainer │ │ │ │ │ -0003ac20: 2773 2076 6172 6961 6e74 206f 6620 2746 's variant of 'F │ │ │ │ │ -0003ac30: 4346 4c41 4753 272e 0a0a 2746 4343 4f4d CFLAGS'...'FCCOM │ │ │ │ │ -0003ac40: 5049 4c45 270a 2020 2020 2054 6865 2063 PILE'. The c │ │ │ │ │ -0003ac50: 6f6d 6d61 6e64 2075 7365 6420 746f 2061 ommand used to a │ │ │ │ │ -0003ac60: 6374 7561 6c6c 7920 636f 6d70 696c 6520 ctually compile │ │ │ │ │ -0003ac70: 6120 466f 7274 7261 6e20 3978 2073 6f75 a Fortran 9x sou │ │ │ │ │ -0003ac80: 7263 6520 6669 6c65 2e20 2054 6865 0a20 rce file. The. │ │ │ │ │ -0003ac90: 2020 2020 6669 6c65 206e 616d 6520 6973 file name is │ │ │ │ │ -0003aca0: 2061 7070 656e 6465 6420 746f 2066 6f72 appended to for │ │ │ │ │ -0003acb0: 6d20 7468 6520 636f 6d70 6c65 7465 2063 m the complete c │ │ │ │ │ -0003acc0: 6f6d 6d61 6e64 206c 696e 652e 0a0a 2746 ommand line...'F │ │ │ │ │ -0003acd0: 434c 494e 4b27 0a20 2020 2020 5468 6520 CLINK'. The │ │ │ │ │ -0003ace0: 636f 6d6d 616e 6420 7573 6564 2074 6f20 command used to │ │ │ │ │ -0003acf0: 6163 7475 616c 6c79 206c 696e 6b20 6120 actually link a │ │ │ │ │ -0003ad00: 7075 7265 2046 6f72 7472 616e 2039 7820 pure Fortran 9x │ │ │ │ │ -0003ad10: 7072 6f67 7261 6d20 6f72 0a20 2020 2020 program or. │ │ │ │ │ -0003ad20: 7368 6172 6564 206c 6962 7261 7279 2e0a shared library.. │ │ │ │ │ -0003ad30: 0a2a 204d 656e 753a 0a0a 2a20 436f 6d70 .* Menu:..* Comp │ │ │ │ │ -0003ad40: 696c 696e 6720 466f 7274 7261 6e20 3978 iling Fortran 9x │ │ │ │ │ -0003ad50: 2046 696c 6573 3a3a 2020 436f 6d70 696c Files:: Compil │ │ │ │ │ -0003ad60: 696e 6720 466f 7274 7261 6e20 3978 2073 ing Fortran 9x s │ │ │ │ │ -0003ad70: 6f75 7263 6573 0a0a 1f0a 4669 6c65 3a20 ources....File: │ │ │ │ │ -0003ad80: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -0003ad90: 666f 2c20 204e 6f64 653a 2043 6f6d 7069 fo, Node: Compi │ │ │ │ │ -0003ada0: 6c69 6e67 2046 6f72 7472 616e 2039 7820 ling Fortran 9x │ │ │ │ │ -0003adb0: 4669 6c65 732c 2020 5570 3a20 466f 7274 Files, Up: Fort │ │ │ │ │ -0003adc0: 7261 6e20 3978 2053 7570 706f 7274 0a0a ran 9x Support.. │ │ │ │ │ -0003add0: 382e 3134 2e31 2043 6f6d 7069 6c69 6e67 8.14.1 Compiling │ │ │ │ │ -0003ade0: 2046 6f72 7472 616e 2039 7820 4669 6c65 Fortran 9x File │ │ │ │ │ -0003adf0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d s.-------------- │ │ │ │ │ +0003aa30: 3d3d 3d0a 0a41 7574 6f6d 616b 6520 696e ===..Automake in │ │ │ │ │ +0003aa40: 636c 7564 6573 2073 7570 706f 7274 2066 cludes support f │ │ │ │ │ +0003aa50: 6f72 2046 6f72 7472 616e 2039 782e 0a0a or Fortran 9x... │ │ │ │ │ +0003aa60: 2020 2041 6e79 2070 6163 6b61 6765 2069 Any package i │ │ │ │ │ +0003aa70: 6e63 6c75 6469 6e67 2046 6f72 7472 616e ncluding Fortran │ │ │ │ │ +0003aa80: 2039 7820 636f 6465 206d 7573 7420 6465 9x code must de │ │ │ │ │ +0003aa90: 6669 6e65 2074 6865 206f 7574 7075 7420 fine the output │ │ │ │ │ +0003aaa0: 7661 7269 6162 6c65 0a27 4643 2720 696e variable.'FC' in │ │ │ │ │ +0003aab0: 2027 636f 6e66 6967 7572 652e 6163 273b 'configure.ac'; │ │ │ │ │ +0003aac0: 2074 6865 2073 696d 706c 6573 7420 7761 the simplest wa │ │ │ │ │ +0003aad0: 7920 746f 2064 6f20 7468 6973 2069 7320 y to do this is │ │ │ │ │ +0003aae0: 746f 2075 7365 2074 6865 0a27 4143 5f50 to use the.'AC_P │ │ │ │ │ +0003aaf0: 524f 475f 4643 2720 6d61 6372 6f20 282a ROG_FC' macro (* │ │ │ │ │ +0003ab00: 6e6f 7465 2050 6172 7469 6375 6c61 7220 note Particular │ │ │ │ │ +0003ab10: 5072 6f67 7261 6d20 4368 6563 6b73 3a0a Program Checks:. │ │ │ │ │ +0003ab20: 2861 7574 6f63 6f6e 6629 5061 7274 6963 (autoconf)Partic │ │ │ │ │ +0003ab30: 756c 6172 2050 726f 6772 616d 732e 292e ular Programs.). │ │ │ │ │ +0003ab40: 0a0a 2020 2041 2066 6577 2061 6464 6974 .. A few addit │ │ │ │ │ +0003ab50: 696f 6e61 6c20 7661 7269 6162 6c65 7320 ional variables │ │ │ │ │ +0003ab60: 6172 6520 6465 6669 6e65 6420 7768 656e are defined when │ │ │ │ │ +0003ab70: 2061 2046 6f72 7472 616e 2039 7820 736f a Fortran 9x so │ │ │ │ │ +0003ab80: 7572 6365 2066 696c 650a 6973 2073 6565 urce file.is see │ │ │ │ │ +0003ab90: 6e3a 0a0a 2746 4327 0a20 2020 2020 5468 n:..'FC'. Th │ │ │ │ │ +0003aba0: 6520 6e61 6d65 206f 6620 7468 6520 466f e name of the Fo │ │ │ │ │ +0003abb0: 7274 7261 6e20 3978 2063 6f6d 7069 6c65 rtran 9x compile │ │ │ │ │ +0003abc0: 722e 0a0a 2746 4346 4c41 4753 270a 2020 r...'FCFLAGS'. │ │ │ │ │ +0003abd0: 2020 2041 6e79 2066 6c61 6773 2074 6f20 Any flags to │ │ │ │ │ +0003abe0: 7061 7373 2074 6f20 7468 6520 466f 7274 pass to the Fort │ │ │ │ │ +0003abf0: 7261 6e20 3978 2063 6f6d 7069 6c65 722e ran 9x compiler. │ │ │ │ │ +0003ac00: 0a0a 2741 4d5f 4643 464c 4147 5327 0a20 ..'AM_FCFLAGS'. │ │ │ │ │ +0003ac10: 2020 2020 5468 6520 6d61 696e 7461 696e The maintain │ │ │ │ │ +0003ac20: 6572 2773 2076 6172 6961 6e74 206f 6620 er's variant of │ │ │ │ │ +0003ac30: 2746 4346 4c41 4753 272e 0a0a 2746 4343 'FCFLAGS'...'FCC │ │ │ │ │ +0003ac40: 4f4d 5049 4c45 270a 2020 2020 2054 6865 OMPILE'. The │ │ │ │ │ +0003ac50: 2063 6f6d 6d61 6e64 2075 7365 6420 746f command used to │ │ │ │ │ +0003ac60: 2061 6374 7561 6c6c 7920 636f 6d70 696c actually compil │ │ │ │ │ +0003ac70: 6520 6120 466f 7274 7261 6e20 3978 2073 e a Fortran 9x s │ │ │ │ │ +0003ac80: 6f75 7263 6520 6669 6c65 2e20 2054 6865 ource file. The │ │ │ │ │ +0003ac90: 0a20 2020 2020 6669 6c65 206e 616d 6520 . file name │ │ │ │ │ +0003aca0: 6973 2061 7070 656e 6465 6420 746f 2066 is appended to f │ │ │ │ │ +0003acb0: 6f72 6d20 7468 6520 636f 6d70 6c65 7465 orm the complete │ │ │ │ │ +0003acc0: 2063 6f6d 6d61 6e64 206c 696e 652e 0a0a command line... │ │ │ │ │ +0003acd0: 2746 434c 494e 4b27 0a20 2020 2020 5468 'FCLINK'. Th │ │ │ │ │ +0003ace0: 6520 636f 6d6d 616e 6420 7573 6564 2074 e command used t │ │ │ │ │ +0003acf0: 6f20 6163 7475 616c 6c79 206c 696e 6b20 o actually link │ │ │ │ │ +0003ad00: 6120 7075 7265 2046 6f72 7472 616e 2039 a pure Fortran 9 │ │ │ │ │ +0003ad10: 7820 7072 6f67 7261 6d20 6f72 0a20 2020 x program or. │ │ │ │ │ +0003ad20: 2020 7368 6172 6564 206c 6962 7261 7279 shared library │ │ │ │ │ +0003ad30: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 436f ...* Menu:..* Co │ │ │ │ │ +0003ad40: 6d70 696c 696e 6720 466f 7274 7261 6e20 mpiling Fortran │ │ │ │ │ +0003ad50: 3978 2046 696c 6573 3a3a 2020 436f 6d70 9x Files:: Comp │ │ │ │ │ +0003ad60: 696c 696e 6720 466f 7274 7261 6e20 3978 iling Fortran 9x │ │ │ │ │ +0003ad70: 2073 6f75 7263 6573 0a0a 1f0a 4669 6c65 sources....File │ │ │ │ │ +0003ad80: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +0003ad90: 696e 666f 2c20 204e 6f64 653a 2043 6f6d info, Node: Com │ │ │ │ │ +0003ada0: 7069 6c69 6e67 2046 6f72 7472 616e 2039 piling Fortran 9 │ │ │ │ │ +0003adb0: 7820 4669 6c65 732c 2020 5570 3a20 466f x Files, Up: Fo │ │ │ │ │ +0003adc0: 7274 7261 6e20 3978 2053 7570 706f 7274 rtran 9x Support │ │ │ │ │ +0003add0: 0a0a 382e 3134 2e31 2043 6f6d 7069 6c69 ..8.14.1 Compili │ │ │ │ │ +0003ade0: 6e67 2046 6f72 7472 616e 2039 7820 4669 ng Fortran 9x Fi │ │ │ │ │ +0003adf0: 6c65 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d les.------------ │ │ │ │ │ 0003ae00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0003ae10: 2d2d 2d0a 0a27 4649 4c45 2e6f 2720 6973 ---..'FILE.o' is │ │ │ │ │ -0003ae20: 206d 6164 6520 6175 746f 6d61 7469 6361 made automatica │ │ │ │ │ -0003ae30: 6c6c 7920 6672 6f6d 2027 4649 4c45 2e66 lly from 'FILE.f │ │ │ │ │ -0003ae40: 3930 272c 2027 4649 4c45 2e66 3935 272c 90', 'FILE.f95', │ │ │ │ │ -0003ae50: 2027 4649 4c45 2e66 3033 272c 0a6f 7220 'FILE.f03',.or │ │ │ │ │ -0003ae60: 2746 494c 452e 6630 3827 2062 7920 7275 'FILE.f08' by ru │ │ │ │ │ -0003ae70: 6e6e 696e 6720 7468 6520 466f 7274 7261 nning the Fortra │ │ │ │ │ -0003ae80: 6e20 3978 2063 6f6d 7069 6c65 722e 2020 n 9x compiler. │ │ │ │ │ -0003ae90: 5468 6520 7072 6563 6973 6520 636f 6d6d The precise comm │ │ │ │ │ -0003aea0: 616e 640a 7573 6564 2069 7320 6173 2066 and.used is as f │ │ │ │ │ -0003aeb0: 6f6c 6c6f 7773 3a0a 0a27 2e66 3930 270a ollows:..'.f90'. │ │ │ │ │ -0003aec0: 2020 2020 2027 2428 4643 2920 2428 414d '$(FC) $(AM │ │ │ │ │ -0003aed0: 5f46 4346 4c41 4753 2920 2428 4643 464c _FCFLAGS) $(FCFL │ │ │ │ │ -0003aee0: 4147 5329 202d 6320 2428 4643 464c 4147 AGS) -c $(FCFLAG │ │ │ │ │ -0003aef0: 535f 6639 3029 2024 3c27 0a0a 272e 6639 S_f90) $<'..'.f9 │ │ │ │ │ -0003af00: 3527 0a20 2020 2020 2724 2846 4329 2024 5'. '$(FC) $ │ │ │ │ │ -0003af10: 2841 4d5f 4643 464c 4147 5329 2024 2846 (AM_FCFLAGS) $(F │ │ │ │ │ -0003af20: 4346 4c41 4753 2920 2d63 2024 2846 4346 CFLAGS) -c $(FCF │ │ │ │ │ -0003af30: 4c41 4753 5f66 3935 2920 243c 270a 0a27 LAGS_f95) $<'..' │ │ │ │ │ -0003af40: 2e66 3033 270a 2020 2020 2027 2428 4643 .f03'. '$(FC │ │ │ │ │ -0003af50: 2920 2428 414d 5f46 4346 4c41 4753 2920 ) $(AM_FCFLAGS) │ │ │ │ │ -0003af60: 2428 4643 464c 4147 5329 202d 6320 2428 $(FCFLAGS) -c $( │ │ │ │ │ -0003af70: 4643 464c 4147 535f 6630 3329 2024 3c27 FCFLAGS_f03) $<' │ │ │ │ │ -0003af80: 0a0a 272e 6630 3827 0a20 2020 2020 2724 ..'.f08'. '$ │ │ │ │ │ -0003af90: 2846 4329 2024 2841 4d5f 4643 464c 4147 (FC) $(AM_FCFLAG │ │ │ │ │ -0003afa0: 5329 2024 2846 4346 4c41 4753 2920 2d63 S) $(FCFLAGS) -c │ │ │ │ │ -0003afb0: 2024 2846 4346 4c41 4753 5f66 3038 2920 $(FCFLAGS_f08) │ │ │ │ │ -0003afc0: 243c 270a 0a1f 0a46 696c 653a 2061 7574 $<'....File: aut │ │ │ │ │ -0003afd0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -0003afe0: 2020 4e6f 6465 3a20 4a61 7661 2053 7570 Node: Java Sup │ │ │ │ │ -0003aff0: 706f 7274 2077 6974 6820 6763 6a2c 2020 port with gcj, │ │ │ │ │ -0003b000: 4e65 7874 3a20 5661 6c61 2053 7570 706f Next: Vala Suppo │ │ │ │ │ -0003b010: 7274 2c20 2050 7265 763a 2046 6f72 7472 rt, Prev: Fortr │ │ │ │ │ -0003b020: 616e 2039 7820 5375 7070 6f72 742c 2020 an 9x Support, │ │ │ │ │ -0003b030: 5570 3a20 5072 6f67 7261 6d73 0a0a 382e Up: Programs..8. │ │ │ │ │ -0003b040: 3135 2043 6f6d 7069 6c69 6e67 204a 6176 15 Compiling Jav │ │ │ │ │ -0003b050: 6120 736f 7572 6365 7320 7573 696e 6720 a sources using │ │ │ │ │ -0003b060: 6763 6a0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d gcj.============ │ │ │ │ │ +0003ae10: 2d2d 2d2d 2d0a 0a27 4649 4c45 2e6f 2720 -----..'FILE.o' │ │ │ │ │ +0003ae20: 6973 206d 6164 6520 6175 746f 6d61 7469 is made automati │ │ │ │ │ +0003ae30: 6361 6c6c 7920 6672 6f6d 2027 4649 4c45 cally from 'FILE │ │ │ │ │ +0003ae40: 2e66 3930 272c 2027 4649 4c45 2e66 3935 .f90', 'FILE.f95 │ │ │ │ │ +0003ae50: 272c 2027 4649 4c45 2e66 3033 272c 0a6f ', 'FILE.f03',.o │ │ │ │ │ +0003ae60: 7220 2746 494c 452e 6630 3827 2062 7920 r 'FILE.f08' by │ │ │ │ │ +0003ae70: 7275 6e6e 696e 6720 7468 6520 466f 7274 running the Fort │ │ │ │ │ +0003ae80: 7261 6e20 3978 2063 6f6d 7069 6c65 722e ran 9x compiler. │ │ │ │ │ +0003ae90: 2020 5468 6520 7072 6563 6973 6520 636f The precise co │ │ │ │ │ +0003aea0: 6d6d 616e 640a 7573 6564 2069 7320 6173 mmand.used is as │ │ │ │ │ +0003aeb0: 2066 6f6c 6c6f 7773 3a0a 0a27 2e66 3930 follows:..'.f90 │ │ │ │ │ +0003aec0: 270a 2020 2020 2027 2428 4643 2920 2428 '. '$(FC) $( │ │ │ │ │ +0003aed0: 414d 5f46 4346 4c41 4753 2920 2428 4643 AM_FCFLAGS) $(FC │ │ │ │ │ +0003aee0: 464c 4147 5329 202d 6320 2428 4643 464c FLAGS) -c $(FCFL │ │ │ │ │ +0003aef0: 4147 535f 6639 3029 2024 3c27 0a0a 272e AGS_f90) $<'..'. │ │ │ │ │ +0003af00: 6639 3527 0a20 2020 2020 2724 2846 4329 f95'. '$(FC) │ │ │ │ │ +0003af10: 2024 2841 4d5f 4643 464c 4147 5329 2024 $(AM_FCFLAGS) $ │ │ │ │ │ +0003af20: 2846 4346 4c41 4753 2920 2d63 2024 2846 (FCFLAGS) -c $(F │ │ │ │ │ +0003af30: 4346 4c41 4753 5f66 3935 2920 243c 270a CFLAGS_f95) $<'. │ │ │ │ │ +0003af40: 0a27 2e66 3033 270a 2020 2020 2027 2428 .'.f03'. '$( │ │ │ │ │ +0003af50: 4643 2920 2428 414d 5f46 4346 4c41 4753 FC) $(AM_FCFLAGS │ │ │ │ │ +0003af60: 2920 2428 4643 464c 4147 5329 202d 6320 ) $(FCFLAGS) -c │ │ │ │ │ +0003af70: 2428 4643 464c 4147 535f 6630 3329 2024 $(FCFLAGS_f03) $ │ │ │ │ │ +0003af80: 3c27 0a0a 272e 6630 3827 0a20 2020 2020 <'..'.f08'. │ │ │ │ │ +0003af90: 2724 2846 4329 2024 2841 4d5f 4643 464c '$(FC) $(AM_FCFL │ │ │ │ │ +0003afa0: 4147 5329 2024 2846 4346 4c41 4753 2920 AGS) $(FCFLAGS) │ │ │ │ │ +0003afb0: 2d63 2024 2846 4346 4c41 4753 5f66 3038 -c $(FCFLAGS_f08 │ │ │ │ │ +0003afc0: 2920 243c 270a 0a1f 0a46 696c 653a 2061 ) $<'....File: a │ │ │ │ │ +0003afd0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +0003afe0: 6f2c 2020 4e6f 6465 3a20 4a61 7661 2053 o, Node: Java S │ │ │ │ │ +0003aff0: 7570 706f 7274 2077 6974 6820 6763 6a2c upport with gcj, │ │ │ │ │ +0003b000: 2020 4e65 7874 3a20 5661 6c61 2053 7570 Next: Vala Sup │ │ │ │ │ +0003b010: 706f 7274 2c20 2050 7265 763a 2046 6f72 port, Prev: For │ │ │ │ │ +0003b020: 7472 616e 2039 7820 5375 7070 6f72 742c tran 9x Support, │ │ │ │ │ +0003b030: 2020 5570 3a20 5072 6f67 7261 6d73 0a0a Up: Programs.. │ │ │ │ │ +0003b040: 382e 3135 2043 6f6d 7069 6c69 6e67 204a 8.15 Compiling J │ │ │ │ │ +0003b050: 6176 6120 736f 7572 6365 7320 7573 696e ava sources usin │ │ │ │ │ +0003b060: 6720 6763 6a0a 3d3d 3d3d 3d3d 3d3d 3d3d g gcj.========== │ │ │ │ │ 0003b070: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003b080: 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 6f6d =========..Autom │ │ │ │ │ -0003b090: 616b 6520 696e 636c 7564 6573 2073 7570 ake includes sup │ │ │ │ │ -0003b0a0: 706f 7274 2066 6f72 206e 6174 6976 656c port for nativel │ │ │ │ │ -0003b0b0: 7920 636f 6d70 696c 6564 204a 6176 612c y compiled Java, │ │ │ │ │ -0003b0c0: 2075 7369 6e67 2027 6763 6a27 2c20 7468 using 'gcj', th │ │ │ │ │ -0003b0d0: 650a 4a61 7661 2066 726f 6e74 2065 6e64 e.Java front end │ │ │ │ │ -0003b0e0: 2074 6f20 7468 6520 474e 5520 436f 6d70 to the GNU Comp │ │ │ │ │ -0003b0f0: 696c 6572 2043 6f6c 6c65 6374 696f 6e20 iler Collection │ │ │ │ │ -0003b100: 2872 7564 696d 656e 7461 7279 2073 7570 (rudimentary sup │ │ │ │ │ -0003b110: 706f 7274 2066 6f72 0a63 6f6d 7069 6c69 port for.compili │ │ │ │ │ -0003b120: 6e67 204a 6176 6120 746f 2062 7974 6563 ng Java to bytec │ │ │ │ │ -0003b130: 6f64 6520 7573 696e 6720 7468 6520 276a ode using the 'j │ │ │ │ │ -0003b140: 6176 6163 2720 636f 6d70 696c 6572 2069 avac' compiler i │ │ │ │ │ -0003b150: 7320 616c 736f 2070 7265 7365 6e74 2c0a s also present,. │ │ │ │ │ -0003b160: 5f61 6c62 6569 7420 6465 7072 6563 6174 _albeit deprecat │ │ │ │ │ -0003b170: 6564 5f3b 202a 6e6f 7465 204a 6176 613a ed_; *note Java: │ │ │ │ │ -0003b180: 3a29 2e0a 0a20 2020 416e 7920 7061 636b :)... Any pack │ │ │ │ │ -0003b190: 6167 6520 696e 636c 7564 696e 6720 4a61 age including Ja │ │ │ │ │ -0003b1a0: 7661 2063 6f64 6520 746f 2062 6520 636f va code to be co │ │ │ │ │ -0003b1b0: 6d70 696c 6564 206d 7573 7420 6465 6669 mpiled must defi │ │ │ │ │ -0003b1c0: 6e65 2074 6865 206f 7574 7075 740a 7661 ne the output.va │ │ │ │ │ -0003b1d0: 7269 6162 6c65 2027 4743 4a27 2069 6e20 riable 'GCJ' in │ │ │ │ │ -0003b1e0: 2763 6f6e 6669 6775 7265 2e61 6327 3b20 'configure.ac'; │ │ │ │ │ -0003b1f0: 7468 6520 7661 7269 6162 6c65 2027 4743 the variable 'GC │ │ │ │ │ -0003b200: 4a46 4c41 4753 2720 6d75 7374 2061 6c73 JFLAGS' must als │ │ │ │ │ -0003b210: 6f20 6265 0a64 6566 696e 6564 2073 6f6d o be.defined som │ │ │ │ │ -0003b220: 6568 6f77 2028 6569 7468 6572 2069 6e20 ehow (either in │ │ │ │ │ -0003b230: 2763 6f6e 6669 6775 7265 2e61 6327 206f 'configure.ac' o │ │ │ │ │ -0003b240: 7220 274d 616b 6566 696c 652e 616d 2729 r 'Makefile.am') │ │ │ │ │ -0003b250: 2e20 2054 6865 0a73 696d 706c 6573 7420 . The.simplest │ │ │ │ │ -0003b260: 7761 7920 746f 2064 6f20 7468 6973 2069 way to do this i │ │ │ │ │ -0003b270: 7320 746f 2075 7365 2074 6865 2027 414d s to use the 'AM │ │ │ │ │ -0003b280: 5f50 524f 475f 4743 4a27 206d 6163 726f _PROG_GCJ' macro │ │ │ │ │ -0003b290: 2e0a 0a20 2020 4279 2064 6566 6175 6c74 ... By default │ │ │ │ │ -0003b2a0: 2c20 7072 6f67 7261 6d73 2069 6e63 6c75 , programs inclu │ │ │ │ │ -0003b2b0: 6469 6e67 204a 6176 6120 736f 7572 6365 ding Java source │ │ │ │ │ -0003b2c0: 2066 696c 6573 2061 7265 206c 696e 6b65 files are linke │ │ │ │ │ -0003b2d0: 6420 7769 7468 0a27 6763 6a27 2e0a 0a20 d with.'gcj'... │ │ │ │ │ -0003b2e0: 2020 4173 2061 6c77 6179 732c 2074 6865 As always, the │ │ │ │ │ -0003b2f0: 2063 6f6e 7465 6e74 7320 6f66 2027 414d contents of 'AM │ │ │ │ │ -0003b300: 5f47 434a 464c 4147 5327 2061 7265 2070 _GCJFLAGS' are p │ │ │ │ │ -0003b310: 6173 7365 6420 746f 2065 7665 7279 0a63 assed to every.c │ │ │ │ │ -0003b320: 6f6d 7069 6c61 7469 6f6e 2069 6e76 6f6b ompilation invok │ │ │ │ │ -0003b330: 696e 6720 2767 636a 2720 2869 6e20 6974 ing 'gcj' (in it │ │ │ │ │ -0003b340: 7320 726f 6c65 2061 7320 616e 2061 6865 s role as an ahe │ │ │ │ │ -0003b350: 6164 2d6f 662d 7469 6d65 2063 6f6d 7069 ad-of-time compi │ │ │ │ │ -0003b360: 6c65 722c 0a77 6865 6e20 696e 766f 6b69 ler,.when invoki │ │ │ │ │ -0003b370: 6e67 2069 7420 746f 2063 7265 6174 6520 ng it to create │ │ │ │ │ -0003b380: 272e 636c 6173 7327 2066 696c 6573 2c20 '.class' files, │ │ │ │ │ -0003b390: 2741 4d5f 4a41 5641 4346 4c41 4753 2720 'AM_JAVACFLAGS' │ │ │ │ │ -0003b3a0: 6973 2075 7365 640a 696e 7374 6561 6429 is used.instead) │ │ │ │ │ -0003b3b0: 2e20 2049 6620 6974 2069 7320 6e65 6365 . If it is nece │ │ │ │ │ -0003b3c0: 7373 6172 7920 746f 2070 6173 7320 6f70 ssary to pass op │ │ │ │ │ -0003b3d0: 7469 6f6e 7320 746f 2027 6763 6a27 2066 tions to 'gcj' f │ │ │ │ │ -0003b3e0: 726f 6d0a 274d 616b 6566 696c 652e 616d rom.'Makefile.am │ │ │ │ │ -0003b3f0: 272c 2074 6869 7320 7661 7269 6162 6c65 ', this variable │ │ │ │ │ -0003b400: 2c20 616e 6420 6e6f 7420 7468 6520 7573 , and not the us │ │ │ │ │ -0003b410: 6572 2076 6172 6961 626c 6520 2747 434a er variable 'GCJ │ │ │ │ │ -0003b420: 464c 4147 5327 2c0a 7368 6f75 6c64 2062 FLAGS',.should b │ │ │ │ │ -0003b430: 6520 7573 6564 2e0a 0a20 2020 2767 636a e used... 'gcj │ │ │ │ │ -0003b440: 2720 6361 6e20 6265 2075 7365 6420 746f ' can be used to │ │ │ │ │ -0003b450: 2063 6f6d 7069 6c65 2027 2e6a 6176 6127 compile '.java' │ │ │ │ │ -0003b460: 2c20 272e 636c 6173 7327 2c20 272e 7a69 , '.class', '.zi │ │ │ │ │ -0003b470: 7027 2c20 6f72 2027 2e6a 6172 270a 6669 p', or '.jar'.fi │ │ │ │ │ -0003b480: 6c65 732e 0a0a 2020 2057 6865 6e20 6c69 les... When li │ │ │ │ │ -0003b490: 6e6b 696e 672c 2027 6763 6a27 2072 6571 nking, 'gcj' req │ │ │ │ │ -0003b4a0: 7569 7265 7320 7468 6174 2074 6865 206d uires that the m │ │ │ │ │ -0003b4b0: 6169 6e20 636c 6173 7320 6265 2073 7065 ain class be spe │ │ │ │ │ -0003b4c0: 6369 6669 6564 2075 7369 6e67 0a74 6865 cified using.the │ │ │ │ │ -0003b4d0: 2027 2d2d 6d61 696e 3d27 206f 7074 696f '--main=' optio │ │ │ │ │ -0003b4e0: 6e2e 2020 5468 6520 6561 7369 6573 7420 n. The easiest │ │ │ │ │ -0003b4f0: 7761 7920 746f 2064 6f20 7468 6973 2069 way to do this i │ │ │ │ │ -0003b500: 7320 746f 2075 7365 2074 6865 0a27 5f4c s to use the.'_L │ │ │ │ │ -0003b510: 4446 4c41 4753 2720 7661 7269 6162 6c65 DFLAGS' variable │ │ │ │ │ -0003b520: 2066 6f72 2074 6865 2070 726f 6772 616d for the program │ │ │ │ │ -0003b530: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ -0003b540: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -0003b550: 4e6f 6465 3a20 5661 6c61 2053 7570 706f Node: Vala Suppo │ │ │ │ │ -0003b560: 7274 2c20 204e 6578 743a 2053 7570 706f rt, Next: Suppo │ │ │ │ │ -0003b570: 7274 2066 6f72 204f 7468 6572 204c 616e rt for Other Lan │ │ │ │ │ -0003b580: 6775 6167 6573 2c20 2050 7265 763a 204a guages, Prev: J │ │ │ │ │ -0003b590: 6176 6120 5375 7070 6f72 7420 7769 7468 ava Support with │ │ │ │ │ -0003b5a0: 2067 636a 2c20 2055 703a 2050 726f 6772 gcj, Up: Progr │ │ │ │ │ -0003b5b0: 616d 730a 0a38 2e31 3620 5661 6c61 2053 ams..8.16 Vala S │ │ │ │ │ -0003b5c0: 7570 706f 7274 0a3d 3d3d 3d3d 3d3d 3d3d upport.========= │ │ │ │ │ -0003b5d0: 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 ========..Automa │ │ │ │ │ -0003b5e0: 6b65 2070 726f 7669 6465 7320 696e 6974 ke provides init │ │ │ │ │ -0003b5f0: 6961 6c20 7375 7070 6f72 7420 666f 7220 ial support for │ │ │ │ │ -0003b600: 5661 6c61 0a28 3c68 7474 703a 2f2f 7777 Vala.(). This req │ │ │ │ │ -0003b630: 7569 7265 7320 7661 6c61 6320 7665 7273 uires valac vers │ │ │ │ │ -0003b640: 696f 6e20 302e 372e 3020 6f72 0a6c 6174 ion 0.7.0 or.lat │ │ │ │ │ -0003b650: 6572 2c20 616e 6420 6375 7272 656e 746c er, and currentl │ │ │ │ │ -0003b660: 7920 7265 7175 6972 6573 2074 6865 2075 y requires the u │ │ │ │ │ -0003b670: 7365 7220 746f 2075 7365 2047 4e55 2027 ser to use GNU ' │ │ │ │ │ -0003b680: 6d61 6b65 272e 0a0a 2020 2020 2066 6f6f make'... foo │ │ │ │ │ -0003b690: 5f53 4f55 5243 4553 203d 2066 6f6f 2e76 _SOURCES = foo.v │ │ │ │ │ -0003b6a0: 616c 6120 6261 722e 7661 6c61 207a 6172 ala bar.vala zar │ │ │ │ │ -0003b6b0: 646f 632e 630a 0a20 2020 416e 7920 272e doc.c.. Any '. │ │ │ │ │ -0003b6c0: 7661 6c61 2720 6669 6c65 206c 6973 7465 vala' file liste │ │ │ │ │ -0003b6d0: 6420 696e 2061 2027 5f53 4f55 5243 4553 d in a '_SOURCES │ │ │ │ │ -0003b6e0: 2720 7661 7269 6162 6c65 2077 696c 6c20 ' variable will │ │ │ │ │ -0003b6f0: 6265 2063 6f6d 7069 6c65 640a 696e 746f be compiled.into │ │ │ │ │ -0003b700: 2043 2063 6f64 6520 6279 2074 6865 2056 C code by the V │ │ │ │ │ -0003b710: 616c 6120 636f 6d70 696c 6572 2e20 2054 ala compiler. T │ │ │ │ │ -0003b720: 6865 2067 656e 6572 6174 6564 2027 2e63 he generated '.c │ │ │ │ │ -0003b730: 2720 6669 6c65 7320 6172 650a 6469 7374 ' files are.dist │ │ │ │ │ -0003b740: 7269 6275 7465 642e 2020 5468 6520 656e ributed. The en │ │ │ │ │ -0003b750: 6420 7573 6572 2064 6f65 7320 6e6f 7420 d user does not │ │ │ │ │ -0003b760: 6e65 6564 2074 6f20 6861 7665 2061 2056 need to have a V │ │ │ │ │ -0003b770: 616c 6120 636f 6d70 696c 6572 0a69 6e73 ala compiler.ins │ │ │ │ │ -0003b780: 7461 6c6c 6564 2e0a 0a20 2020 4175 746f talled... Auto │ │ │ │ │ -0003b790: 6d61 6b65 2073 6869 7073 2077 6974 6820 make ships with │ │ │ │ │ -0003b7a0: 616e 2041 7574 6f63 6f6e 6620 6d61 6372 an Autoconf macr │ │ │ │ │ -0003b7b0: 6f20 6361 6c6c 6564 2027 414d 5f50 524f o called 'AM_PRO │ │ │ │ │ -0003b7c0: 475f 5641 4c41 4327 2074 6861 740a 7769 G_VALAC' that.wi │ │ │ │ │ -0003b7d0: 6c6c 206c 6f63 6174 6520 7468 6520 5661 ll locate the Va │ │ │ │ │ -0003b7e0: 6c61 2063 6f6d 7069 6c65 7220 616e 6420 la compiler and │ │ │ │ │ -0003b7f0: 6f70 7469 6f6e 616c 6c79 2063 6865 636b optionally check │ │ │ │ │ -0003b800: 2069 7473 2076 6572 7369 6f6e 206e 756d its version num │ │ │ │ │ -0003b810: 6265 722e 0a0a 202d 2d20 4d61 6372 6f3a ber... -- Macro: │ │ │ │ │ -0003b820: 2041 4d5f 5052 4f47 5f56 414c 4143 2028 AM_PROG_VALAC ( │ │ │ │ │ -0003b830: 5b4d 494e 494d 554d 2d56 4552 5349 4f4e [MINIMUM-VERSION │ │ │ │ │ -0003b840: 5d29 0a20 2020 2020 5472 7920 746f 2066 ]). Try to f │ │ │ │ │ -0003b850: 696e 6420 6120 5661 6c61 2063 6f6d 7069 ind a Vala compi │ │ │ │ │ -0003b860: 6c65 7220 696e 2027 5041 5448 272e 2020 ler in 'PATH'. │ │ │ │ │ -0003b870: 4966 2069 7420 6973 2066 6f75 6e64 2c20 If it is found, │ │ │ │ │ -0003b880: 7468 650a 2020 2020 2076 6172 6961 626c the. variabl │ │ │ │ │ -0003b890: 6520 2756 414c 4143 2720 6973 2073 6574 e 'VALAC' is set │ │ │ │ │ -0003b8a0: 2e20 204f 7074 696f 6e61 6c6c 7920 6120 . Optionally a │ │ │ │ │ -0003b8b0: 6d69 6e69 6d75 6d20 7265 6c65 6173 6520 minimum release │ │ │ │ │ -0003b8c0: 6e75 6d62 6572 206f 660a 2020 2020 2074 number of. t │ │ │ │ │ -0003b8d0: 6865 2063 6f6d 7069 6c65 7220 6361 6e20 he compiler can │ │ │ │ │ -0003b8e0: 6265 2072 6571 7565 7374 6564 3a0a 0a20 be requested:.. │ │ │ │ │ -0003b8f0: 2020 2020 2020 2020 2041 4d5f 5052 4f47 AM_PROG │ │ │ │ │ -0003b900: 5f56 414c 4143 285b 302e 372e 305d 290a _VALAC([0.7.0]). │ │ │ │ │ -0003b910: 0a20 2020 5468 6572 6520 6172 6520 6120 . There are a │ │ │ │ │ -0003b920: 6665 7720 7661 7269 6162 6c65 7320 7468 few variables th │ │ │ │ │ -0003b930: 6174 2061 7265 2075 7365 6420 7768 656e at are used when │ │ │ │ │ -0003b940: 2063 6f6d 7069 6c69 6e67 2056 616c 6120 compiling Vala │ │ │ │ │ -0003b950: 736f 7572 6365 733a 0a0a 2756 414c 4143 sources:..'VALAC │ │ │ │ │ -0003b960: 270a 2020 2020 2050 6174 6820 746f 2074 '. Path to t │ │ │ │ │ -0003b970: 6865 2056 616c 6120 636f 6d70 696c 6572 he Vala compiler │ │ │ │ │ -0003b980: 2e0a 0a27 5641 4c41 464c 4147 5327 0a20 ...'VALAFLAGS'. │ │ │ │ │ -0003b990: 2020 2020 4164 6469 7469 6f6e 616c 2061 Additional a │ │ │ │ │ -0003b9a0: 7267 756d 656e 7473 2066 6f72 2074 6865 rguments for the │ │ │ │ │ -0003b9b0: 2056 616c 6120 636f 6d70 696c 6572 2e0a Vala compiler.. │ │ │ │ │ -0003b9c0: 0a27 414d 5f56 414c 4146 4c41 4753 270a .'AM_VALAFLAGS'. │ │ │ │ │ -0003b9d0: 2020 2020 2054 6865 206d 6169 6e74 6169 The maintai │ │ │ │ │ -0003b9e0: 6e65 7227 7320 7661 7269 616e 7420 6f66 ner's variant of │ │ │ │ │ -0003b9f0: 2027 5641 4c41 464c 4147 5327 2e0a 0a20 'VALAFLAGS'... │ │ │ │ │ -0003ba00: 2020 2020 2020 2020 206c 6962 5f4c 544c lib_LTL │ │ │ │ │ -0003ba10: 4942 5241 5249 4553 203d 206c 6962 666f IBRARIES = libfo │ │ │ │ │ -0003ba20: 6f2e 6c61 0a20 2020 2020 2020 2020 206c o.la. l │ │ │ │ │ -0003ba30: 6962 666f 6f5f 6c61 5f53 4f55 5243 4553 ibfoo_la_SOURCES │ │ │ │ │ -0003ba40: 203d 2066 6f6f 2e76 616c 610a 0a20 2020 = foo.vala.. │ │ │ │ │ -0003ba50: 4e6f 7465 2074 6861 7420 6375 7272 656e Note that curren │ │ │ │ │ -0003ba60: 746c 792c 2079 6f75 2063 616e 6e6f 7420 tly, you cannot │ │ │ │ │ -0003ba70: 7573 6520 7065 722d 7461 7267 6574 2027 use per-target ' │ │ │ │ │ -0003ba80: 2a5f 5641 4c41 464c 4147 5327 2028 2a6e *_VALAFLAGS' (*n │ │ │ │ │ -0003ba90: 6f74 650a 5265 6e61 6d65 6420 4f62 6a65 ote.Renamed Obje │ │ │ │ │ -0003baa0: 6374 733a 3a29 2074 6f20 7072 6f64 7563 cts::) to produc │ │ │ │ │ -0003bab0: 6520 6469 6666 6572 656e 7420 4320 6669 e different C fi │ │ │ │ │ -0003bac0: 6c65 7320 6672 6f6d 206f 6e65 2056 616c les from one Val │ │ │ │ │ -0003bad0: 6120 736f 7572 6365 0a66 696c 652e 0a0a a source.file... │ │ │ │ │ -0003bae0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -0003baf0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -0003bb00: 653a 2053 7570 706f 7274 2066 6f72 204f e: Support for O │ │ │ │ │ -0003bb10: 7468 6572 204c 616e 6775 6167 6573 2c20 ther Languages, │ │ │ │ │ -0003bb20: 204e 6578 743a 2041 4e53 492c 2020 5072 Next: ANSI, Pr │ │ │ │ │ -0003bb30: 6576 3a20 5661 6c61 2053 7570 706f 7274 ev: Vala Support │ │ │ │ │ -0003bb40: 2c20 2055 703a 2050 726f 6772 616d 730a , Up: Programs. │ │ │ │ │ -0003bb50: 0a38 2e31 3720 5375 7070 6f72 7420 666f .8.17 Support fo │ │ │ │ │ -0003bb60: 7220 4f74 6865 7220 4c61 6e67 7561 6765 r Other Language │ │ │ │ │ -0003bb70: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ +0003b080: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 ===========..Aut │ │ │ │ │ +0003b090: 6f6d 616b 6520 696e 636c 7564 6573 2073 omake includes s │ │ │ │ │ +0003b0a0: 7570 706f 7274 2066 6f72 206e 6174 6976 upport for nativ │ │ │ │ │ +0003b0b0: 656c 7920 636f 6d70 696c 6564 204a 6176 ely compiled Jav │ │ │ │ │ +0003b0c0: 612c 2075 7369 6e67 2027 6763 6a27 2c20 a, using 'gcj', │ │ │ │ │ +0003b0d0: 7468 650a 4a61 7661 2066 726f 6e74 2065 the.Java front e │ │ │ │ │ +0003b0e0: 6e64 2074 6f20 7468 6520 474e 5520 436f nd to the GNU Co │ │ │ │ │ +0003b0f0: 6d70 696c 6572 2043 6f6c 6c65 6374 696f mpiler Collectio │ │ │ │ │ +0003b100: 6e20 2872 7564 696d 656e 7461 7279 2073 n (rudimentary s │ │ │ │ │ +0003b110: 7570 706f 7274 2066 6f72 0a63 6f6d 7069 upport for.compi │ │ │ │ │ +0003b120: 6c69 6e67 204a 6176 6120 746f 2062 7974 ling Java to byt │ │ │ │ │ +0003b130: 6563 6f64 6520 7573 696e 6720 7468 6520 ecode using the │ │ │ │ │ +0003b140: 276a 6176 6163 2720 636f 6d70 696c 6572 'javac' compiler │ │ │ │ │ +0003b150: 2069 7320 616c 736f 2070 7265 7365 6e74 is also present │ │ │ │ │ +0003b160: 2c0a 5f61 6c62 6569 7420 6465 7072 6563 ,._albeit deprec │ │ │ │ │ +0003b170: 6174 6564 5f3b 202a 6e6f 7465 204a 6176 ated_; *note Jav │ │ │ │ │ +0003b180: 613a 3a29 2e0a 0a20 2020 416e 7920 7061 a::)... Any pa │ │ │ │ │ +0003b190: 636b 6167 6520 696e 636c 7564 696e 6720 ckage including │ │ │ │ │ +0003b1a0: 4a61 7661 2063 6f64 6520 746f 2062 6520 Java code to be │ │ │ │ │ +0003b1b0: 636f 6d70 696c 6564 206d 7573 7420 6465 compiled must de │ │ │ │ │ +0003b1c0: 6669 6e65 2074 6865 206f 7574 7075 740a fine the output. │ │ │ │ │ +0003b1d0: 7661 7269 6162 6c65 2027 4743 4a27 2069 variable 'GCJ' i │ │ │ │ │ +0003b1e0: 6e20 2763 6f6e 6669 6775 7265 2e61 6327 n 'configure.ac' │ │ │ │ │ +0003b1f0: 3b20 7468 6520 7661 7269 6162 6c65 2027 ; the variable ' │ │ │ │ │ +0003b200: 4743 4a46 4c41 4753 2720 6d75 7374 2061 GCJFLAGS' must a │ │ │ │ │ +0003b210: 6c73 6f20 6265 0a64 6566 696e 6564 2073 lso be.defined s │ │ │ │ │ +0003b220: 6f6d 6568 6f77 2028 6569 7468 6572 2069 omehow (either i │ │ │ │ │ +0003b230: 6e20 2763 6f6e 6669 6775 7265 2e61 6327 n 'configure.ac' │ │ │ │ │ +0003b240: 206f 7220 274d 616b 6566 696c 652e 616d or 'Makefile.am │ │ │ │ │ +0003b250: 2729 2e20 2054 6865 0a73 696d 706c 6573 '). The.simples │ │ │ │ │ +0003b260: 7420 7761 7920 746f 2064 6f20 7468 6973 t way to do this │ │ │ │ │ +0003b270: 2069 7320 746f 2075 7365 2074 6865 2027 is to use the ' │ │ │ │ │ +0003b280: 414d 5f50 524f 475f 4743 4a27 206d 6163 AM_PROG_GCJ' mac │ │ │ │ │ +0003b290: 726f 2e0a 0a20 2020 4279 2064 6566 6175 ro... By defau │ │ │ │ │ +0003b2a0: 6c74 2c20 7072 6f67 7261 6d73 2069 6e63 lt, programs inc │ │ │ │ │ +0003b2b0: 6c75 6469 6e67 204a 6176 6120 736f 7572 luding Java sour │ │ │ │ │ +0003b2c0: 6365 2066 696c 6573 2061 7265 206c 696e ce files are lin │ │ │ │ │ +0003b2d0: 6b65 6420 7769 7468 0a27 6763 6a27 2e0a ked with.'gcj'.. │ │ │ │ │ +0003b2e0: 0a20 2020 4173 2061 6c77 6179 732c 2074 . As always, t │ │ │ │ │ +0003b2f0: 6865 2063 6f6e 7465 6e74 7320 6f66 2027 he contents of ' │ │ │ │ │ +0003b300: 414d 5f47 434a 464c 4147 5327 2061 7265 AM_GCJFLAGS' are │ │ │ │ │ +0003b310: 2070 6173 7365 6420 746f 2065 7665 7279 passed to every │ │ │ │ │ +0003b320: 0a63 6f6d 7069 6c61 7469 6f6e 2069 6e76 .compilation inv │ │ │ │ │ +0003b330: 6f6b 696e 6720 2767 636a 2720 2869 6e20 oking 'gcj' (in │ │ │ │ │ +0003b340: 6974 7320 726f 6c65 2061 7320 616e 2061 its role as an a │ │ │ │ │ +0003b350: 6865 6164 2d6f 662d 7469 6d65 2063 6f6d head-of-time com │ │ │ │ │ +0003b360: 7069 6c65 722c 0a77 6865 6e20 696e 766f piler,.when invo │ │ │ │ │ +0003b370: 6b69 6e67 2069 7420 746f 2063 7265 6174 king it to creat │ │ │ │ │ +0003b380: 6520 272e 636c 6173 7327 2066 696c 6573 e '.class' files │ │ │ │ │ +0003b390: 2c20 2741 4d5f 4a41 5641 4346 4c41 4753 , 'AM_JAVACFLAGS │ │ │ │ │ +0003b3a0: 2720 6973 2075 7365 640a 696e 7374 6561 ' is used.instea │ │ │ │ │ +0003b3b0: 6429 2e20 2049 6620 6974 2069 7320 6e65 d). If it is ne │ │ │ │ │ +0003b3c0: 6365 7373 6172 7920 746f 2070 6173 7320 cessary to pass │ │ │ │ │ +0003b3d0: 6f70 7469 6f6e 7320 746f 2027 6763 6a27 options to 'gcj' │ │ │ │ │ +0003b3e0: 2066 726f 6d0a 274d 616b 6566 696c 652e from.'Makefile. │ │ │ │ │ +0003b3f0: 616d 272c 2074 6869 7320 7661 7269 6162 am', this variab │ │ │ │ │ +0003b400: 6c65 2c20 616e 6420 6e6f 7420 7468 6520 le, and not the │ │ │ │ │ +0003b410: 7573 6572 2076 6172 6961 626c 6520 2747 user variable 'G │ │ │ │ │ +0003b420: 434a 464c 4147 5327 2c0a 7368 6f75 6c64 CJFLAGS',.should │ │ │ │ │ +0003b430: 2062 6520 7573 6564 2e0a 0a20 2020 2767 be used... 'g │ │ │ │ │ +0003b440: 636a 2720 6361 6e20 6265 2075 7365 6420 cj' can be used │ │ │ │ │ +0003b450: 746f 2063 6f6d 7069 6c65 2027 2e6a 6176 to compile '.jav │ │ │ │ │ +0003b460: 6127 2c20 272e 636c 6173 7327 2c20 272e a', '.class', '. │ │ │ │ │ +0003b470: 7a69 7027 2c20 6f72 2027 2e6a 6172 270a zip', or '.jar'. │ │ │ │ │ +0003b480: 6669 6c65 732e 0a0a 2020 2057 6865 6e20 files... When │ │ │ │ │ +0003b490: 6c69 6e6b 696e 672c 2027 6763 6a27 2072 linking, 'gcj' r │ │ │ │ │ +0003b4a0: 6571 7569 7265 7320 7468 6174 2074 6865 equires that the │ │ │ │ │ +0003b4b0: 206d 6169 6e20 636c 6173 7320 6265 2073 main class be s │ │ │ │ │ +0003b4c0: 7065 6369 6669 6564 2075 7369 6e67 0a74 pecified using.t │ │ │ │ │ +0003b4d0: 6865 2027 2d2d 6d61 696e 3d27 206f 7074 he '--main=' opt │ │ │ │ │ +0003b4e0: 696f 6e2e 2020 5468 6520 6561 7369 6573 ion. The easies │ │ │ │ │ +0003b4f0: 7420 7761 7920 746f 2064 6f20 7468 6973 t way to do this │ │ │ │ │ +0003b500: 2069 7320 746f 2075 7365 2074 6865 0a27 is to use the.' │ │ │ │ │ +0003b510: 5f4c 4446 4c41 4753 2720 7661 7269 6162 _LDFLAGS' variab │ │ │ │ │ +0003b520: 6c65 2066 6f72 2074 6865 2070 726f 6772 le for the progr │ │ │ │ │ +0003b530: 616d 2e0a 0a1f 0a46 696c 653a 2061 7574 am.....File: aut │ │ │ │ │ +0003b540: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +0003b550: 2020 4e6f 6465 3a20 5661 6c61 2053 7570 Node: Vala Sup │ │ │ │ │ +0003b560: 706f 7274 2c20 204e 6578 743a 2053 7570 port, Next: Sup │ │ │ │ │ +0003b570: 706f 7274 2066 6f72 204f 7468 6572 204c port for Other L │ │ │ │ │ +0003b580: 616e 6775 6167 6573 2c20 2050 7265 763a anguages, Prev: │ │ │ │ │ +0003b590: 204a 6176 6120 5375 7070 6f72 7420 7769 Java Support wi │ │ │ │ │ +0003b5a0: 7468 2067 636a 2c20 2055 703a 2050 726f th gcj, Up: Pro │ │ │ │ │ +0003b5b0: 6772 616d 730a 0a38 2e31 3620 5661 6c61 grams..8.16 Vala │ │ │ │ │ +0003b5c0: 2053 7570 706f 7274 0a3d 3d3d 3d3d 3d3d Support.======= │ │ │ │ │ +0003b5d0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f ==========..Auto │ │ │ │ │ +0003b5e0: 6d61 6b65 2070 726f 7669 6465 7320 696e make provides in │ │ │ │ │ +0003b5f0: 6974 6961 6c20 7375 7070 6f72 7420 666f itial support fo │ │ │ │ │ +0003b600: 7220 5661 6c61 0a28 3c68 7474 703a 2f2f r Vala.(). This r │ │ │ │ │ +0003b630: 6571 7569 7265 7320 7661 6c61 6320 7665 equires valac ve │ │ │ │ │ +0003b640: 7273 696f 6e20 302e 372e 3020 6f72 0a6c rsion 0.7.0 or.l │ │ │ │ │ +0003b650: 6174 6572 2c20 616e 6420 6375 7272 656e ater, and curren │ │ │ │ │ +0003b660: 746c 7920 7265 7175 6972 6573 2074 6865 tly requires the │ │ │ │ │ +0003b670: 2075 7365 7220 746f 2075 7365 2047 4e55 user to use GNU │ │ │ │ │ +0003b680: 2027 6d61 6b65 272e 0a0a 2020 2020 2066 'make'... f │ │ │ │ │ +0003b690: 6f6f 5f53 4f55 5243 4553 203d 2066 6f6f oo_SOURCES = foo │ │ │ │ │ +0003b6a0: 2e76 616c 6120 6261 722e 7661 6c61 207a .vala bar.vala z │ │ │ │ │ +0003b6b0: 6172 646f 632e 630a 0a20 2020 416e 7920 ardoc.c.. Any │ │ │ │ │ +0003b6c0: 272e 7661 6c61 2720 6669 6c65 206c 6973 '.vala' file lis │ │ │ │ │ +0003b6d0: 7465 6420 696e 2061 2027 5f53 4f55 5243 ted in a '_SOURC │ │ │ │ │ +0003b6e0: 4553 2720 7661 7269 6162 6c65 2077 696c ES' variable wil │ │ │ │ │ +0003b6f0: 6c20 6265 2063 6f6d 7069 6c65 640a 696e l be compiled.in │ │ │ │ │ +0003b700: 746f 2043 2063 6f64 6520 6279 2074 6865 to C code by the │ │ │ │ │ +0003b710: 2056 616c 6120 636f 6d70 696c 6572 2e20 Vala compiler. │ │ │ │ │ +0003b720: 2054 6865 2067 656e 6572 6174 6564 2027 The generated ' │ │ │ │ │ +0003b730: 2e63 2720 6669 6c65 7320 6172 650a 6469 .c' files are.di │ │ │ │ │ +0003b740: 7374 7269 6275 7465 642e 2020 5468 6520 stributed. The │ │ │ │ │ +0003b750: 656e 6420 7573 6572 2064 6f65 7320 6e6f end user does no │ │ │ │ │ +0003b760: 7420 6e65 6564 2074 6f20 6861 7665 2061 t need to have a │ │ │ │ │ +0003b770: 2056 616c 6120 636f 6d70 696c 6572 0a69 Vala compiler.i │ │ │ │ │ +0003b780: 6e73 7461 6c6c 6564 2e0a 0a20 2020 4175 nstalled... Au │ │ │ │ │ +0003b790: 746f 6d61 6b65 2073 6869 7073 2077 6974 tomake ships wit │ │ │ │ │ +0003b7a0: 6820 616e 2041 7574 6f63 6f6e 6620 6d61 h an Autoconf ma │ │ │ │ │ +0003b7b0: 6372 6f20 6361 6c6c 6564 2027 414d 5f50 cro called 'AM_P │ │ │ │ │ +0003b7c0: 524f 475f 5641 4c41 4327 2074 6861 740a ROG_VALAC' that. │ │ │ │ │ +0003b7d0: 7769 6c6c 206c 6f63 6174 6520 7468 6520 will locate the │ │ │ │ │ +0003b7e0: 5661 6c61 2063 6f6d 7069 6c65 7220 616e Vala compiler an │ │ │ │ │ +0003b7f0: 6420 6f70 7469 6f6e 616c 6c79 2063 6865 d optionally che │ │ │ │ │ +0003b800: 636b 2069 7473 2076 6572 7369 6f6e 206e ck its version n │ │ │ │ │ +0003b810: 756d 6265 722e 0a0a 202d 2d20 4d61 6372 umber... -- Macr │ │ │ │ │ +0003b820: 6f3a 2041 4d5f 5052 4f47 5f56 414c 4143 o: AM_PROG_VALAC │ │ │ │ │ +0003b830: 2028 5b4d 494e 494d 554d 2d56 4552 5349 ([MINIMUM-VERSI │ │ │ │ │ +0003b840: 4f4e 5d29 0a20 2020 2020 5472 7920 746f ON]). Try to │ │ │ │ │ +0003b850: 2066 696e 6420 6120 5661 6c61 2063 6f6d find a Vala com │ │ │ │ │ +0003b860: 7069 6c65 7220 696e 2027 5041 5448 272e piler in 'PATH'. │ │ │ │ │ +0003b870: 2020 4966 2069 7420 6973 2066 6f75 6e64 If it is found │ │ │ │ │ +0003b880: 2c20 7468 650a 2020 2020 2076 6172 6961 , the. varia │ │ │ │ │ +0003b890: 626c 6520 2756 414c 4143 2720 6973 2073 ble 'VALAC' is s │ │ │ │ │ +0003b8a0: 6574 2e20 204f 7074 696f 6e61 6c6c 7920 et. Optionally │ │ │ │ │ +0003b8b0: 6120 6d69 6e69 6d75 6d20 7265 6c65 6173 a minimum releas │ │ │ │ │ +0003b8c0: 6520 6e75 6d62 6572 206f 660a 2020 2020 e number of. │ │ │ │ │ +0003b8d0: 2074 6865 2063 6f6d 7069 6c65 7220 6361 the compiler ca │ │ │ │ │ +0003b8e0: 6e20 6265 2072 6571 7565 7374 6564 3a0a n be requested:. │ │ │ │ │ +0003b8f0: 0a20 2020 2020 2020 2020 2041 4d5f 5052 . AM_PR │ │ │ │ │ +0003b900: 4f47 5f56 414c 4143 285b 302e 372e 305d OG_VALAC([0.7.0] │ │ │ │ │ +0003b910: 290a 0a20 2020 5468 6572 6520 6172 6520 ).. There are │ │ │ │ │ +0003b920: 6120 6665 7720 7661 7269 6162 6c65 7320 a few variables │ │ │ │ │ +0003b930: 7468 6174 2061 7265 2075 7365 6420 7768 that are used wh │ │ │ │ │ +0003b940: 656e 2063 6f6d 7069 6c69 6e67 2056 616c en compiling Val │ │ │ │ │ +0003b950: 6120 736f 7572 6365 733a 0a0a 2756 414c a sources:..'VAL │ │ │ │ │ +0003b960: 4143 270a 2020 2020 2050 6174 6820 746f AC'. Path to │ │ │ │ │ +0003b970: 2074 6865 2056 616c 6120 636f 6d70 696c the Vala compil │ │ │ │ │ +0003b980: 6572 2e0a 0a27 5641 4c41 464c 4147 5327 er...'VALAFLAGS' │ │ │ │ │ +0003b990: 0a20 2020 2020 4164 6469 7469 6f6e 616c . Additional │ │ │ │ │ +0003b9a0: 2061 7267 756d 656e 7473 2066 6f72 2074 arguments for t │ │ │ │ │ +0003b9b0: 6865 2056 616c 6120 636f 6d70 696c 6572 he Vala compiler │ │ │ │ │ +0003b9c0: 2e0a 0a27 414d 5f56 414c 4146 4c41 4753 ...'AM_VALAFLAGS │ │ │ │ │ +0003b9d0: 270a 2020 2020 2054 6865 206d 6169 6e74 '. The maint │ │ │ │ │ +0003b9e0: 6169 6e65 7227 7320 7661 7269 616e 7420 ainer's variant │ │ │ │ │ +0003b9f0: 6f66 2027 5641 4c41 464c 4147 5327 2e0a of 'VALAFLAGS'.. │ │ │ │ │ +0003ba00: 0a20 2020 2020 2020 2020 206c 6962 5f4c . lib_L │ │ │ │ │ +0003ba10: 544c 4942 5241 5249 4553 203d 206c 6962 TLIBRARIES = lib │ │ │ │ │ +0003ba20: 666f 6f2e 6c61 0a20 2020 2020 2020 2020 foo.la. │ │ │ │ │ +0003ba30: 206c 6962 666f 6f5f 6c61 5f53 4f55 5243 libfoo_la_SOURC │ │ │ │ │ +0003ba40: 4553 203d 2066 6f6f 2e76 616c 610a 0a20 ES = foo.vala.. │ │ │ │ │ +0003ba50: 2020 4e6f 7465 2074 6861 7420 6375 7272 Note that curr │ │ │ │ │ +0003ba60: 656e 746c 792c 2079 6f75 2063 616e 6e6f ently, you canno │ │ │ │ │ +0003ba70: 7420 7573 6520 7065 722d 7461 7267 6574 t use per-target │ │ │ │ │ +0003ba80: 2027 2a5f 5641 4c41 464c 4147 5327 2028 '*_VALAFLAGS' ( │ │ │ │ │ +0003ba90: 2a6e 6f74 650a 5265 6e61 6d65 6420 4f62 *note.Renamed Ob │ │ │ │ │ +0003baa0: 6a65 6374 733a 3a29 2074 6f20 7072 6f64 jects::) to prod │ │ │ │ │ +0003bab0: 7563 6520 6469 6666 6572 656e 7420 4320 uce different C │ │ │ │ │ +0003bac0: 6669 6c65 7320 6672 6f6d 206f 6e65 2056 files from one V │ │ │ │ │ +0003bad0: 616c 6120 736f 7572 6365 0a66 696c 652e ala source.file. │ │ │ │ │ +0003bae0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +0003baf0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +0003bb00: 6f64 653a 2053 7570 706f 7274 2066 6f72 ode: Support for │ │ │ │ │ +0003bb10: 204f 7468 6572 204c 616e 6775 6167 6573 Other Languages │ │ │ │ │ +0003bb20: 2c20 204e 6578 743a 2041 4e53 492c 2020 , Next: ANSI, │ │ │ │ │ +0003bb30: 5072 6576 3a20 5661 6c61 2053 7570 706f Prev: Vala Suppo │ │ │ │ │ +0003bb40: 7274 2c20 2055 703a 2050 726f 6772 616d rt, Up: Program │ │ │ │ │ +0003bb50: 730a 0a38 2e31 3720 5375 7070 6f72 7420 s..8.17 Support │ │ │ │ │ +0003bb60: 666f 7220 4f74 6865 7220 4c61 6e67 7561 for Other Langua │ │ │ │ │ +0003bb70: 6765 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ges.============ │ │ │ │ │ 0003bb80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003bb90: 3d3d 0a0a 4175 746f 6d61 6b65 2063 7572 ==..Automake cur │ │ │ │ │ -0003bba0: 7265 6e74 6c79 206f 6e6c 7920 696e 636c rently only incl │ │ │ │ │ -0003bbb0: 7564 6573 2066 756c 6c20 7375 7070 6f72 udes full suppor │ │ │ │ │ -0003bbc0: 7420 666f 7220 432c 2043 2b2b 2028 2a6e t for C, C++ (*n │ │ │ │ │ -0003bbd0: 6f74 6520 432b 2b0a 5375 7070 6f72 743a ote C++.Support: │ │ │ │ │ -0003bbe0: 3a29 2c20 4f62 6a65 6374 6976 6520 4320 :), Objective C │ │ │ │ │ -0003bbf0: 282a 6e6f 7465 204f 626a 6563 7469 7665 (*note Objective │ │ │ │ │ -0003bc00: 2043 2053 7570 706f 7274 3a3a 292c 2046 C Support::), F │ │ │ │ │ -0003bc10: 6f72 7472 616e 2037 3720 282a 6e6f 7465 ortran 77 (*note │ │ │ │ │ -0003bc20: 0a46 6f72 7472 616e 2037 3720 5375 7070 .Fortran 77 Supp │ │ │ │ │ -0003bc30: 6f72 743a 3a29 2c20 466f 7274 7261 6e20 ort::), Fortran │ │ │ │ │ -0003bc40: 3978 2028 2a6e 6f74 6520 466f 7274 7261 9x (*note Fortra │ │ │ │ │ -0003bc50: 6e20 3978 2053 7570 706f 7274 3a3a 292c n 9x Support::), │ │ │ │ │ -0003bc60: 2061 6e64 204a 6176 610a 282a 6e6f 7465 and Java.(*note │ │ │ │ │ -0003bc70: 204a 6176 6120 5375 7070 6f72 7420 7769 Java Support wi │ │ │ │ │ -0003bc80: 7468 2067 636a 3a3a 292e 2020 5468 6572 th gcj::). Ther │ │ │ │ │ -0003bc90: 6520 6973 206f 6e6c 7920 7275 6469 6d65 e is only rudime │ │ │ │ │ -0003bca0: 6e74 6172 7920 7375 7070 6f72 7420 666f ntary support fo │ │ │ │ │ -0003bcb0: 720a 6f74 6865 7220 6c61 6e67 7561 6765 r.other language │ │ │ │ │ -0003bcc0: 732c 2073 7570 706f 7274 2066 6f72 2077 s, support for w │ │ │ │ │ -0003bcd0: 6869 6368 2077 696c 6c20 6265 2069 6d70 hich will be imp │ │ │ │ │ -0003bce0: 726f 7665 6420 6261 7365 6420 6f6e 2075 roved based on u │ │ │ │ │ -0003bcf0: 7365 720a 6465 6d61 6e64 2e0a 0a20 2020 ser.demand... │ │ │ │ │ -0003bd00: 536f 6d65 206c 696d 6974 6564 2073 7570 Some limited sup │ │ │ │ │ -0003bd10: 706f 7274 2066 6f72 2061 6464 696e 6720 port for adding │ │ │ │ │ -0003bd20: 796f 7572 206f 776e 206c 616e 6775 6167 your own languag │ │ │ │ │ -0003bd30: 6573 2069 7320 6176 6169 6c61 626c 6520 es is available │ │ │ │ │ -0003bd40: 7669 610a 7468 6520 7375 6666 6978 2072 via.the suffix r │ │ │ │ │ -0003bd50: 756c 6520 6861 6e64 6c69 6e67 2028 2a6e ule handling (*n │ │ │ │ │ -0003bd60: 6f74 6520 5375 6666 6978 6573 3a3a 292e ote Suffixes::). │ │ │ │ │ -0003bd70: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -0003bd80: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -0003bd90: 6f64 653a 2041 4e53 492c 2020 4e65 7874 ode: ANSI, Next │ │ │ │ │ -0003bda0: 3a20 4465 7065 6e64 656e 6369 6573 2c20 : Dependencies, │ │ │ │ │ -0003bdb0: 2050 7265 763a 2053 7570 706f 7274 2066 Prev: Support f │ │ │ │ │ -0003bdc0: 6f72 204f 7468 6572 204c 616e 6775 6167 or Other Languag │ │ │ │ │ -0003bdd0: 6573 2c20 2055 703a 2050 726f 6772 616d es, Up: Program │ │ │ │ │ -0003bde0: 730a 0a38 2e31 3820 4175 746f 6d61 7469 s..8.18 Automati │ │ │ │ │ -0003bdf0: 6320 6465 2d41 4e53 492d 6669 6361 7469 c de-ANSI-ficati │ │ │ │ │ -0003be00: 6f6e 2028 6465 7072 6563 6174 6564 2c20 on (deprecated, │ │ │ │ │ -0003be10: 736f 6f6e 2074 6f20 6265 2072 656d 6f76 soon to be remov │ │ │ │ │ -0003be20: 6564 290a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ed).============ │ │ │ │ │ +0003bb90: 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 2063 ====..Automake c │ │ │ │ │ +0003bba0: 7572 7265 6e74 6c79 206f 6e6c 7920 696e urrently only in │ │ │ │ │ +0003bbb0: 636c 7564 6573 2066 756c 6c20 7375 7070 cludes full supp │ │ │ │ │ +0003bbc0: 6f72 7420 666f 7220 432c 2043 2b2b 2028 ort for C, C++ ( │ │ │ │ │ +0003bbd0: 2a6e 6f74 6520 432b 2b0a 5375 7070 6f72 *note C++.Suppor │ │ │ │ │ +0003bbe0: 743a 3a29 2c20 4f62 6a65 6374 6976 6520 t::), Objective │ │ │ │ │ +0003bbf0: 4320 282a 6e6f 7465 204f 626a 6563 7469 C (*note Objecti │ │ │ │ │ +0003bc00: 7665 2043 2053 7570 706f 7274 3a3a 292c ve C Support::), │ │ │ │ │ +0003bc10: 2046 6f72 7472 616e 2037 3720 282a 6e6f Fortran 77 (*no │ │ │ │ │ +0003bc20: 7465 0a46 6f72 7472 616e 2037 3720 5375 te.Fortran 77 Su │ │ │ │ │ +0003bc30: 7070 6f72 743a 3a29 2c20 466f 7274 7261 pport::), Fortra │ │ │ │ │ +0003bc40: 6e20 3978 2028 2a6e 6f74 6520 466f 7274 n 9x (*note Fort │ │ │ │ │ +0003bc50: 7261 6e20 3978 2053 7570 706f 7274 3a3a ran 9x Support:: │ │ │ │ │ +0003bc60: 292c 2061 6e64 204a 6176 610a 282a 6e6f ), and Java.(*no │ │ │ │ │ +0003bc70: 7465 204a 6176 6120 5375 7070 6f72 7420 te Java Support │ │ │ │ │ +0003bc80: 7769 7468 2067 636a 3a3a 292e 2020 5468 with gcj::). Th │ │ │ │ │ +0003bc90: 6572 6520 6973 206f 6e6c 7920 7275 6469 ere is only rudi │ │ │ │ │ +0003bca0: 6d65 6e74 6172 7920 7375 7070 6f72 7420 mentary support │ │ │ │ │ +0003bcb0: 666f 720a 6f74 6865 7220 6c61 6e67 7561 for.other langua │ │ │ │ │ +0003bcc0: 6765 732c 2073 7570 706f 7274 2066 6f72 ges, support for │ │ │ │ │ +0003bcd0: 2077 6869 6368 2077 696c 6c20 6265 2069 which will be i │ │ │ │ │ +0003bce0: 6d70 726f 7665 6420 6261 7365 6420 6f6e mproved based on │ │ │ │ │ +0003bcf0: 2075 7365 720a 6465 6d61 6e64 2e0a 0a20 user.demand... │ │ │ │ │ +0003bd00: 2020 536f 6d65 206c 696d 6974 6564 2073 Some limited s │ │ │ │ │ +0003bd10: 7570 706f 7274 2066 6f72 2061 6464 696e upport for addin │ │ │ │ │ +0003bd20: 6720 796f 7572 206f 776e 206c 616e 6775 g your own langu │ │ │ │ │ +0003bd30: 6167 6573 2069 7320 6176 6169 6c61 626c ages is availabl │ │ │ │ │ +0003bd40: 6520 7669 610a 7468 6520 7375 6666 6978 e via.the suffix │ │ │ │ │ +0003bd50: 2072 756c 6520 6861 6e64 6c69 6e67 2028 rule handling ( │ │ │ │ │ +0003bd60: 2a6e 6f74 6520 5375 6666 6978 6573 3a3a *note Suffixes:: │ │ │ │ │ +0003bd70: 292e 0a0a 1f0a 4669 6c65 3a20 6175 746f ).....File: auto │ │ │ │ │ +0003bd80: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +0003bd90: 204e 6f64 653a 2041 4e53 492c 2020 4e65 Node: ANSI, Ne │ │ │ │ │ +0003bda0: 7874 3a20 4465 7065 6e64 656e 6369 6573 xt: Dependencies │ │ │ │ │ +0003bdb0: 2c20 2050 7265 763a 2053 7570 706f 7274 , Prev: Support │ │ │ │ │ +0003bdc0: 2066 6f72 204f 7468 6572 204c 616e 6775 for Other Langu │ │ │ │ │ +0003bdd0: 6167 6573 2c20 2055 703a 2050 726f 6772 ages, Up: Progr │ │ │ │ │ +0003bde0: 616d 730a 0a38 2e31 3820 4175 746f 6d61 ams..8.18 Automa │ │ │ │ │ +0003bdf0: 7469 6320 6465 2d41 4e53 492d 6669 6361 tic de-ANSI-fica │ │ │ │ │ +0003be00: 7469 6f6e 2028 6465 7072 6563 6174 6564 tion (deprecated │ │ │ │ │ +0003be10: 2c20 736f 6f6e 2074 6f20 6265 2072 656d , soon to be rem │ │ │ │ │ +0003be20: 6f76 6564 290a 3d3d 3d3d 3d3d 3d3d 3d3d oved).========== │ │ │ │ │ 0003be30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003be40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003be50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003be60: 3d3d 3d3d 0a0a 5f54 6865 2066 6561 7475 ====.._The featu │ │ │ │ │ -0003be70: 7265 7320 6465 7363 7269 6265 6420 696e res described in │ │ │ │ │ -0003be80: 2074 6869 7320 7365 6374 696f 6e20 6172 this section ar │ │ │ │ │ -0003be90: 6520 6465 7072 6563 6174 6564 3b20 796f e deprecated; yo │ │ │ │ │ -0003bea0: 7520 6d75 7374 206e 6f74 2075 7365 0a61 u must not use.a │ │ │ │ │ -0003beb0: 6e79 206f 6620 7468 656d 2069 6e20 6e65 ny of them in ne │ │ │ │ │ -0003bec0: 7720 636f 6465 2c20 616e 6420 7265 6d6f w code, and remo │ │ │ │ │ -0003bed0: 7665 2074 6865 6972 2075 7365 2066 726f ve their use fro │ │ │ │ │ -0003bee0: 6d20 6f6c 6465 7220 6275 7420 7374 696c m older but stil │ │ │ │ │ -0003bef0: 6c0a 6d61 696e 7461 696e 6564 2063 6f64 l.maintained cod │ │ │ │ │ -0003bf00: 653a 2074 6865 7920 7769 6c6c 2062 6520 e: they will be │ │ │ │ │ -0003bf10: 7769 7468 6472 6177 6e20 696e 2074 6865 withdrawn in the │ │ │ │ │ -0003bf20: 206e 6578 7420 6d61 6a6f 7220 4175 746f next major Auto │ │ │ │ │ -0003bf30: 6d61 6b65 0a72 656c 6561 7365 2e5f 0a0a make.release._.. │ │ │ │ │ -0003bf40: 2020 2057 6865 6e20 7468 6520 4320 6c61 When the C la │ │ │ │ │ -0003bf50: 6e67 7561 6765 2077 6173 2073 7461 6e64 nguage was stand │ │ │ │ │ -0003bf60: 6172 6469 7a65 6420 696e 2031 3938 392c ardized in 1989, │ │ │ │ │ -0003bf70: 2074 6865 7265 2077 6173 2061 206c 6f6e there was a lon │ │ │ │ │ -0003bf80: 670a 7472 616e 7369 7469 6f6e 2070 6572 g.transition per │ │ │ │ │ -0003bf90: 696f 6420 7768 6572 6520 7061 636b 6167 iod where packag │ │ │ │ │ -0003bfa0: 6520 6465 7665 6c6f 7065 7273 206e 6565 e developers nee │ │ │ │ │ -0003bfb0: 6465 6420 746f 2077 6f72 7279 2061 626f ded to worry abo │ │ │ │ │ -0003bfc0: 7574 2070 6f72 7469 6e67 0a74 6f20 6f6c ut porting.to ol │ │ │ │ │ -0003bfd0: 6465 7220 7379 7374 656d 7320 7468 6174 der systems that │ │ │ │ │ -0003bfe0: 2064 6964 206e 6f74 2073 7570 706f 7274 did not support │ │ │ │ │ -0003bff0: 2041 4e53 4920 4320 6279 2064 6566 6175 ANSI C by defau │ │ │ │ │ -0003c000: 6c74 2e20 2054 6865 7365 206f 6c64 6572 lt. These older │ │ │ │ │ -0003c010: 0a73 7973 7465 6d73 2061 7265 206e 6f20 .systems are no │ │ │ │ │ -0003c020: 6c6f 6e67 6572 2069 6e20 7072 6163 7469 longer in practi │ │ │ │ │ -0003c030: 6361 6c20 7573 6520 616e 6420 6172 6520 cal use and are │ │ │ │ │ -0003c040: 6e6f 206c 6f6e 6765 7220 7375 7070 6f72 no longer suppor │ │ │ │ │ -0003c050: 7465 6420 6279 0a74 6865 6972 206f 7269 ted by.their ori │ │ │ │ │ -0003c060: 6769 6e61 6c20 7375 7070 6c69 6572 732c ginal suppliers, │ │ │ │ │ -0003c070: 2073 6f20 6465 7665 6c6f 7065 7273 206e so developers n │ │ │ │ │ -0003c080: 6565 6420 6e6f 7420 776f 7272 7920 6162 eed not worry ab │ │ │ │ │ -0003c090: 6f75 7420 7468 6973 0a70 726f 626c 656d out this.problem │ │ │ │ │ -0003c0a0: 2061 6e79 206d 6f72 652e 0a0a 2020 2041 any more... A │ │ │ │ │ -0003c0b0: 7574 6f6d 616b 6520 616c 6c6f 7773 2079 utomake allows y │ │ │ │ │ -0003c0c0: 6f75 2074 6f20 7772 6974 6520 7061 636b ou to write pack │ │ │ │ │ -0003c0d0: 6167 6573 2074 6861 7420 6172 6520 706f ages that are po │ │ │ │ │ -0003c0e0: 7274 6162 6c65 2074 6f20 4b26 5220 4320 rtable to K&R C │ │ │ │ │ -0003c0f0: 6279 0a22 6465 2d41 4e53 492d 6679 696e by."de-ANSI-fyin │ │ │ │ │ -0003c100: 6722 2065 6163 6820 736f 7572 6365 2066 g" each source f │ │ │ │ │ -0003c110: 696c 6520 6265 666f 7265 2074 6865 2061 ile before the a │ │ │ │ │ -0003c120: 6374 7561 6c20 636f 6d70 696c 6174 696f ctual compilatio │ │ │ │ │ -0003c130: 6e20 7461 6b65 730a 706c 6163 652e 0a0a n takes.place... │ │ │ │ │ -0003c140: 2020 2049 6620 7468 6520 274d 616b 6566 If the 'Makef │ │ │ │ │ -0003c150: 696c 652e 616d 2720 7661 7269 6162 6c65 ile.am' variable │ │ │ │ │ -0003c160: 2027 4155 544f 4d41 4b45 5f4f 5054 494f 'AUTOMAKE_OPTIO │ │ │ │ │ -0003c170: 4e53 2720 282a 6e6f 7465 204f 7074 696f NS' (*note Optio │ │ │ │ │ -0003c180: 6e73 3a3a 290a 636f 6e74 6169 6e73 2074 ns::).contains t │ │ │ │ │ -0003c190: 6865 206f 7074 696f 6e20 2761 6e73 6932 he option 'ansi2 │ │ │ │ │ -0003c1a0: 6b6e 7227 2074 6865 6e20 636f 6465 2074 knr' then code t │ │ │ │ │ -0003c1b0: 6f20 6861 6e64 6c65 2064 652d 414e 5349 o handle de-ANSI │ │ │ │ │ -0003c1c0: 2d66 6963 6174 696f 6e20 6973 0a69 6e73 -fication is.ins │ │ │ │ │ -0003c1d0: 6572 7465 6420 696e 746f 2074 6865 2067 erted into the g │ │ │ │ │ -0003c1e0: 656e 6572 6174 6564 2027 4d61 6b65 6669 enerated 'Makefi │ │ │ │ │ -0003c1f0: 6c65 2e69 6e27 2e0a 0a20 2020 5468 6973 le.in'... This │ │ │ │ │ -0003c200: 2063 6175 7365 7320 6561 6368 2043 2073 causes each C s │ │ │ │ │ -0003c210: 6f75 7263 6520 6669 6c65 2069 6e20 7468 ource file in th │ │ │ │ │ -0003c220: 6520 6469 7265 6374 6f72 7920 746f 2062 e directory to b │ │ │ │ │ -0003c230: 6520 7472 6561 7465 6420 6173 2041 4e53 e treated as ANS │ │ │ │ │ -0003c240: 490a 432e 2020 4966 2061 6e20 414e 5349 I.C. If an ANSI │ │ │ │ │ -0003c250: 2043 2063 6f6d 7069 6c65 7220 6973 2061 C compiler is a │ │ │ │ │ -0003c260: 7661 696c 6162 6c65 2c20 6974 2069 7320 vailable, it is │ │ │ │ │ -0003c270: 7573 6564 2e20 2049 6620 6e6f 2041 4e53 used. If no ANS │ │ │ │ │ -0003c280: 4920 430a 636f 6d70 696c 6572 2069 7320 I C.compiler is │ │ │ │ │ -0003c290: 6176 6169 6c61 626c 652c 2074 6865 2027 available, the ' │ │ │ │ │ -0003c2a0: 616e 7369 326b 6e72 2720 7072 6f67 7261 ansi2knr' progra │ │ │ │ │ -0003c2b0: 6d20 6973 2075 7365 6420 746f 2063 6f6e m is used to con │ │ │ │ │ -0003c2c0: 7665 7274 2074 6865 0a73 6f75 7263 6520 vert the.source │ │ │ │ │ -0003c2d0: 6669 6c65 7320 696e 746f 204b 2652 2043 files into K&R C │ │ │ │ │ -0003c2e0: 2c20 7768 6963 6820 6973 2074 6865 6e20 , which is then │ │ │ │ │ -0003c2f0: 636f 6d70 696c 6564 2e0a 0a20 2020 5468 compiled... Th │ │ │ │ │ -0003c300: 6520 2761 6e73 6932 6b6e 7227 2070 726f e 'ansi2knr' pro │ │ │ │ │ -0003c310: 6772 616d 2069 7320 7369 6d70 6c65 2d6d gram is simple-m │ │ │ │ │ -0003c320: 696e 6465 642e 2020 4974 2061 7373 756d inded. It assum │ │ │ │ │ -0003c330: 6573 2074 6865 2073 6f75 7263 6520 636f es the source co │ │ │ │ │ -0003c340: 6465 0a77 696c 6c20 6265 2066 6f72 6d61 de.will be forma │ │ │ │ │ -0003c350: 7474 6564 2069 6e20 6120 7061 7274 6963 tted in a partic │ │ │ │ │ -0003c360: 756c 6172 2077 6179 3b20 7365 6520 7468 ular way; see th │ │ │ │ │ -0003c370: 6520 2761 6e73 6932 6b6e 7227 206d 616e e 'ansi2knr' man │ │ │ │ │ -0003c380: 2070 6167 6520 666f 720a 6465 7461 696c page for.detail │ │ │ │ │ -0003c390: 732e 0a0a 2020 2053 7570 706f 7274 2066 s... Support f │ │ │ │ │ -0003c3a0: 6f72 2074 6865 206f 6273 6f6c 6574 6520 or the obsolete │ │ │ │ │ -0003c3b0: 6465 2d41 4e53 492d 6669 6361 7469 6f6e de-ANSI-fication │ │ │ │ │ -0003c3c0: 2066 6561 7475 7265 2072 6571 7569 7265 feature require │ │ │ │ │ -0003c3d0: 7320 7468 6520 736f 7572 6365 0a66 696c s the source.fil │ │ │ │ │ -0003c3e0: 6573 2027 616e 7369 326b 6e72 2e63 2720 es 'ansi2knr.c' │ │ │ │ │ -0003c3f0: 616e 6420 2761 6e73 6932 6b6e 722e 3127 and 'ansi2knr.1' │ │ │ │ │ -0003c400: 2074 6f20 6265 2069 6e20 7468 6520 7361 to be in the sa │ │ │ │ │ -0003c410: 6d65 2070 6163 6b61 6765 2061 7320 7468 me package as th │ │ │ │ │ -0003c420: 650a 414e 5349 2043 2073 6f75 7263 653b e.ANSI C source; │ │ │ │ │ -0003c430: 2074 6865 7365 2066 696c 6573 2061 7265 these files are │ │ │ │ │ -0003c440: 2064 6973 7472 6962 7574 6564 2077 6974 distributed wit │ │ │ │ │ -0003c450: 6820 4175 746f 6d61 6b65 2e20 2041 6c73 h Automake. Als │ │ │ │ │ -0003c460: 6f2c 2074 6865 0a70 6163 6b61 6765 2027 o, the.package ' │ │ │ │ │ -0003c470: 636f 6e66 6967 7572 652e 6163 2720 6d75 configure.ac' mu │ │ │ │ │ -0003c480: 7374 2063 616c 6c20 7468 6520 6d61 6372 st call the macr │ │ │ │ │ -0003c490: 6f20 2741 4d5f 435f 5052 4f54 4f54 5950 o 'AM_C_PROTOTYP │ │ │ │ │ -0003c4a0: 4553 2720 282a 6e6f 7465 0a4d 6163 726f ES' (*note.Macro │ │ │ │ │ -0003c4b0: 733a 3a29 2e0a 0a20 2020 4175 746f 6d61 s::)... Automa │ │ │ │ │ -0003c4c0: 6b65 2061 6c73 6f20 6861 6e64 6c65 7320 ke also handles │ │ │ │ │ -0003c4d0: 6669 6e64 696e 6720 7468 6520 2761 6e73 finding the 'ans │ │ │ │ │ -0003c4e0: 6932 6b6e 7227 2073 7570 706f 7274 2066 i2knr' support f │ │ │ │ │ -0003c4f0: 696c 6573 2069 6e20 736f 6d65 0a6f 7468 iles in some.oth │ │ │ │ │ -0003c500: 6572 2064 6972 6563 746f 7279 2069 6e20 er directory in │ │ │ │ │ -0003c510: 7468 6520 6375 7272 656e 7420 7061 636b the current pack │ │ │ │ │ -0003c520: 6167 652e 2020 5468 6973 2069 7320 646f age. This is do │ │ │ │ │ -0003c530: 6e65 2062 7920 7072 6570 656e 6469 6e67 ne by prepending │ │ │ │ │ -0003c540: 2074 6865 0a72 656c 6174 6976 6520 7061 the.relative pa │ │ │ │ │ -0003c550: 7468 2074 6f20 7468 6520 6170 7072 6f70 th to the approp │ │ │ │ │ -0003c560: 7269 6174 6520 6469 7265 6374 6f72 7920 riate directory │ │ │ │ │ -0003c570: 746f 2074 6865 2027 616e 7369 326b 6e72 to the 'ansi2knr │ │ │ │ │ -0003c580: 2720 6f70 7469 6f6e 2e0a 466f 7220 696e ' option..For in │ │ │ │ │ -0003c590: 7374 616e 6365 2c20 7375 7070 6f73 6520 stance, suppose │ │ │ │ │ -0003c5a0: 7468 6520 7061 636b 6167 6520 6861 7320 the package has │ │ │ │ │ -0003c5b0: 414e 5349 2043 2063 6f64 6520 696e 2074 ANSI C code in t │ │ │ │ │ -0003c5c0: 6865 2027 7372 6327 2061 6e64 2027 6c69 he 'src' and 'li │ │ │ │ │ -0003c5d0: 6227 0a73 7562 6469 7265 6374 6f72 6965 b'.subdirectorie │ │ │ │ │ -0003c5e0: 732e 2020 5468 6520 6669 6c65 7320 2761 s. The files 'a │ │ │ │ │ -0003c5f0: 6e73 6932 6b6e 722e 6327 2061 6e64 2027 nsi2knr.c' and ' │ │ │ │ │ -0003c600: 616e 7369 326b 6e72 2e31 2720 6170 7065 ansi2knr.1' appe │ │ │ │ │ -0003c610: 6172 2069 6e0a 276c 6962 272e 2020 5468 ar in.'lib'. Th │ │ │ │ │ -0003c620: 656e 2074 6869 7320 636f 756c 6420 6170 en this could ap │ │ │ │ │ -0003c630: 7065 6172 2069 6e20 2773 7263 2f4d 616b pear in 'src/Mak │ │ │ │ │ -0003c640: 6566 696c 652e 616d 273a 0a0a 2020 2020 efile.am':.. │ │ │ │ │ -0003c650: 2041 5554 4f4d 414b 455f 4f50 5449 4f4e AUTOMAKE_OPTION │ │ │ │ │ -0003c660: 5320 3d20 2e2e 2f6c 6962 2f61 6e73 6932 S = ../lib/ansi2 │ │ │ │ │ -0003c670: 6b6e 720a 0a20 2020 4966 206e 6f20 6469 knr.. If no di │ │ │ │ │ -0003c680: 7265 6374 6f72 7920 7072 6566 6978 2069 rectory prefix i │ │ │ │ │ -0003c690: 7320 6769 7665 6e2c 2074 6865 2066 696c s given, the fil │ │ │ │ │ -0003c6a0: 6573 2061 7265 2061 7373 756d 6564 2074 es are assumed t │ │ │ │ │ -0003c6b0: 6f20 6265 2069 6e20 7468 650a 6375 7272 o be in the.curr │ │ │ │ │ -0003c6c0: 656e 7420 6469 7265 6374 6f72 792e 0a0a ent directory... │ │ │ │ │ -0003c6d0: 2020 204e 6f74 6520 7468 6174 2061 7574 Note that aut │ │ │ │ │ -0003c6e0: 6f6d 6174 6963 2064 652d 414e 5349 2d66 omatic de-ANSI-f │ │ │ │ │ -0003c6f0: 6963 6174 696f 6e20 7769 6c6c 206e 6f74 ication will not │ │ │ │ │ -0003c700: 2077 6f72 6b20 7768 656e 2074 6865 2070 work when the p │ │ │ │ │ -0003c710: 6163 6b61 6765 0a69 7320 6265 696e 6720 ackage.is being │ │ │ │ │ -0003c720: 6275 696c 7420 666f 7220 6120 6469 6666 built for a diff │ │ │ │ │ -0003c730: 6572 656e 7420 686f 7374 2061 7263 6869 erent host archi │ │ │ │ │ -0003c740: 7465 6374 7572 652e 2020 5468 6174 2069 tecture. That i │ │ │ │ │ -0003c750: 7320 6265 6361 7573 650a 2761 7574 6f6d s because.'autom │ │ │ │ │ -0003c760: 616b 6527 2063 7572 7265 6e74 6c79 2068 ake' currently h │ │ │ │ │ -0003c770: 6173 206e 6f20 7761 7920 746f 2062 7569 as no way to bui │ │ │ │ │ -0003c780: 6c64 2027 616e 7369 326b 6e72 2720 666f ld 'ansi2knr' fo │ │ │ │ │ -0003c790: 7220 7468 6520 6275 696c 640a 6d61 6368 r the build.mach │ │ │ │ │ -0003c7a0: 696e 652e 0a0a 2020 2055 7369 6e67 2027 ine... Using ' │ │ │ │ │ -0003c7b0: 4c49 424f 424a 5327 2077 6974 6820 736f LIBOBJS' with so │ │ │ │ │ -0003c7c0: 7572 6365 2064 652d 414e 5349 2d66 6963 urce de-ANSI-fic │ │ │ │ │ -0003c7d0: 6174 696f 6e20 7573 6564 2074 6f20 7265 ation used to re │ │ │ │ │ -0003c7e0: 7175 6972 650a 6861 6e64 2d63 7261 6674 quire.hand-craft │ │ │ │ │ -0003c7f0: 6564 2063 6f64 6520 696e 2027 636f 6e66 ed code in 'conf │ │ │ │ │ -0003c800: 6967 7572 6527 2074 6f20 6170 7065 6e64 igure' to append │ │ │ │ │ -0003c810: 2027 2455 2720 746f 2062 6173 656e 616d '$U' to basenam │ │ │ │ │ -0003c820: 6573 2069 6e0a 274c 4942 4f42 4a53 272e es in.'LIBOBJS'. │ │ │ │ │ -0003c830: 2020 5468 6973 2069 7320 6e6f 206c 6f6e This is no lon │ │ │ │ │ -0003c840: 6765 7220 7472 7565 2074 6f64 6179 2e20 ger true today. │ │ │ │ │ -0003c850: 2053 7461 7274 696e 6720 7769 7468 2076 Starting with v │ │ │ │ │ -0003c860: 6572 7369 6f6e 2032 2e35 342c 0a41 7574 ersion 2.54,.Aut │ │ │ │ │ -0003c870: 6f63 6f6e 6620 7461 6b65 7320 6361 7265 oconf takes care │ │ │ │ │ -0003c880: 206f 6620 7265 7772 6974 696e 6720 274c of rewriting 'L │ │ │ │ │ -0003c890: 4942 4f42 4a53 2720 616e 6420 274c 544c IBOBJS' and 'LTL │ │ │ │ │ -0003c8a0: 4942 4f42 4a53 272e 2020 282a 6e6f 7465 IBOBJS'. (*note │ │ │ │ │ -0003c8b0: 0a27 4143 5f4c 4942 4f42 4a27 2076 732e .'AC_LIBOBJ' vs. │ │ │ │ │ -0003c8c0: 2027 4c49 424f 424a 5327 3a20 2861 7574 'LIBOBJS': (aut │ │ │ │ │ -0003c8d0: 6f63 6f6e 6629 4143 5f4c 4942 4f42 4a20 oconf)AC_LIBOBJ │ │ │ │ │ -0003c8e0: 7673 204c 4942 4f42 4a53 2e29 0a0a 1f0a vs LIBOBJS.).... │ │ │ │ │ -0003c8f0: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ -0003c900: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ -0003c910: 2044 6570 656e 6465 6e63 6965 732c 2020 Dependencies, │ │ │ │ │ -0003c920: 4e65 7874 3a20 4558 4545 5854 2c20 2050 Next: EXEEXT, P │ │ │ │ │ -0003c930: 7265 763a 2041 4e53 492c 2020 5570 3a20 rev: ANSI, Up: │ │ │ │ │ -0003c940: 5072 6f67 7261 6d73 0a0a 382e 3139 2041 Programs..8.19 A │ │ │ │ │ -0003c950: 7574 6f6d 6174 6963 2064 6570 656e 6465 utomatic depende │ │ │ │ │ -0003c960: 6e63 7920 7472 6163 6b69 6e67 0a3d 3d3d ncy tracking.=== │ │ │ │ │ +0003be60: 3d3d 3d3d 3d3d 0a0a 5f54 6865 2066 6561 ======.._The fea │ │ │ │ │ +0003be70: 7475 7265 7320 6465 7363 7269 6265 6420 tures described │ │ │ │ │ +0003be80: 696e 2074 6869 7320 7365 6374 696f 6e20 in this section │ │ │ │ │ +0003be90: 6172 6520 6465 7072 6563 6174 6564 3b20 are deprecated; │ │ │ │ │ +0003bea0: 796f 7520 6d75 7374 206e 6f74 2075 7365 you must not use │ │ │ │ │ +0003beb0: 0a61 6e79 206f 6620 7468 656d 2069 6e20 .any of them in │ │ │ │ │ +0003bec0: 6e65 7720 636f 6465 2c20 616e 6420 7265 new code, and re │ │ │ │ │ +0003bed0: 6d6f 7665 2074 6865 6972 2075 7365 2066 move their use f │ │ │ │ │ +0003bee0: 726f 6d20 6f6c 6465 7220 6275 7420 7374 rom older but st │ │ │ │ │ +0003bef0: 696c 6c0a 6d61 696e 7461 696e 6564 2063 ill.maintained c │ │ │ │ │ +0003bf00: 6f64 653a 2074 6865 7920 7769 6c6c 2062 ode: they will b │ │ │ │ │ +0003bf10: 6520 7769 7468 6472 6177 6e20 696e 2074 e withdrawn in t │ │ │ │ │ +0003bf20: 6865 206e 6578 7420 6d61 6a6f 7220 4175 he next major Au │ │ │ │ │ +0003bf30: 746f 6d61 6b65 0a72 656c 6561 7365 2e5f tomake.release._ │ │ │ │ │ +0003bf40: 0a0a 2020 2057 6865 6e20 7468 6520 4320 .. When the C │ │ │ │ │ +0003bf50: 6c61 6e67 7561 6765 2077 6173 2073 7461 language was sta │ │ │ │ │ +0003bf60: 6e64 6172 6469 7a65 6420 696e 2031 3938 ndardized in 198 │ │ │ │ │ +0003bf70: 392c 2074 6865 7265 2077 6173 2061 206c 9, there was a l │ │ │ │ │ +0003bf80: 6f6e 670a 7472 616e 7369 7469 6f6e 2070 ong.transition p │ │ │ │ │ +0003bf90: 6572 696f 6420 7768 6572 6520 7061 636b eriod where pack │ │ │ │ │ +0003bfa0: 6167 6520 6465 7665 6c6f 7065 7273 206e age developers n │ │ │ │ │ +0003bfb0: 6565 6465 6420 746f 2077 6f72 7279 2061 eeded to worry a │ │ │ │ │ +0003bfc0: 626f 7574 2070 6f72 7469 6e67 0a74 6f20 bout porting.to │ │ │ │ │ +0003bfd0: 6f6c 6465 7220 7379 7374 656d 7320 7468 older systems th │ │ │ │ │ +0003bfe0: 6174 2064 6964 206e 6f74 2073 7570 706f at did not suppo │ │ │ │ │ +0003bff0: 7274 2041 4e53 4920 4320 6279 2064 6566 rt ANSI C by def │ │ │ │ │ +0003c000: 6175 6c74 2e20 2054 6865 7365 206f 6c64 ault. These old │ │ │ │ │ +0003c010: 6572 0a73 7973 7465 6d73 2061 7265 206e er.systems are n │ │ │ │ │ +0003c020: 6f20 6c6f 6e67 6572 2069 6e20 7072 6163 o longer in prac │ │ │ │ │ +0003c030: 7469 6361 6c20 7573 6520 616e 6420 6172 tical use and ar │ │ │ │ │ +0003c040: 6520 6e6f 206c 6f6e 6765 7220 7375 7070 e no longer supp │ │ │ │ │ +0003c050: 6f72 7465 6420 6279 0a74 6865 6972 206f orted by.their o │ │ │ │ │ +0003c060: 7269 6769 6e61 6c20 7375 7070 6c69 6572 riginal supplier │ │ │ │ │ +0003c070: 732c 2073 6f20 6465 7665 6c6f 7065 7273 s, so developers │ │ │ │ │ +0003c080: 206e 6565 6420 6e6f 7420 776f 7272 7920 need not worry │ │ │ │ │ +0003c090: 6162 6f75 7420 7468 6973 0a70 726f 626c about this.probl │ │ │ │ │ +0003c0a0: 656d 2061 6e79 206d 6f72 652e 0a0a 2020 em any more... │ │ │ │ │ +0003c0b0: 2041 7574 6f6d 616b 6520 616c 6c6f 7773 Automake allows │ │ │ │ │ +0003c0c0: 2079 6f75 2074 6f20 7772 6974 6520 7061 you to write pa │ │ │ │ │ +0003c0d0: 636b 6167 6573 2074 6861 7420 6172 6520 ckages that are │ │ │ │ │ +0003c0e0: 706f 7274 6162 6c65 2074 6f20 4b26 5220 portable to K&R │ │ │ │ │ +0003c0f0: 4320 6279 0a22 6465 2d41 4e53 492d 6679 C by."de-ANSI-fy │ │ │ │ │ +0003c100: 696e 6722 2065 6163 6820 736f 7572 6365 ing" each source │ │ │ │ │ +0003c110: 2066 696c 6520 6265 666f 7265 2074 6865 file before the │ │ │ │ │ +0003c120: 2061 6374 7561 6c20 636f 6d70 696c 6174 actual compilat │ │ │ │ │ +0003c130: 696f 6e20 7461 6b65 730a 706c 6163 652e ion takes.place. │ │ │ │ │ +0003c140: 0a0a 2020 2049 6620 7468 6520 274d 616b .. If the 'Mak │ │ │ │ │ +0003c150: 6566 696c 652e 616d 2720 7661 7269 6162 efile.am' variab │ │ │ │ │ +0003c160: 6c65 2027 4155 544f 4d41 4b45 5f4f 5054 le 'AUTOMAKE_OPT │ │ │ │ │ +0003c170: 494f 4e53 2720 282a 6e6f 7465 204f 7074 IONS' (*note Opt │ │ │ │ │ +0003c180: 696f 6e73 3a3a 290a 636f 6e74 6169 6e73 ions::).contains │ │ │ │ │ +0003c190: 2074 6865 206f 7074 696f 6e20 2761 6e73 the option 'ans │ │ │ │ │ +0003c1a0: 6932 6b6e 7227 2074 6865 6e20 636f 6465 i2knr' then code │ │ │ │ │ +0003c1b0: 2074 6f20 6861 6e64 6c65 2064 652d 414e to handle de-AN │ │ │ │ │ +0003c1c0: 5349 2d66 6963 6174 696f 6e20 6973 0a69 SI-fication is.i │ │ │ │ │ +0003c1d0: 6e73 6572 7465 6420 696e 746f 2074 6865 nserted into the │ │ │ │ │ +0003c1e0: 2067 656e 6572 6174 6564 2027 4d61 6b65 generated 'Make │ │ │ │ │ +0003c1f0: 6669 6c65 2e69 6e27 2e0a 0a20 2020 5468 file.in'... Th │ │ │ │ │ +0003c200: 6973 2063 6175 7365 7320 6561 6368 2043 is causes each C │ │ │ │ │ +0003c210: 2073 6f75 7263 6520 6669 6c65 2069 6e20 source file in │ │ │ │ │ +0003c220: 7468 6520 6469 7265 6374 6f72 7920 746f the directory to │ │ │ │ │ +0003c230: 2062 6520 7472 6561 7465 6420 6173 2041 be treated as A │ │ │ │ │ +0003c240: 4e53 490a 432e 2020 4966 2061 6e20 414e NSI.C. If an AN │ │ │ │ │ +0003c250: 5349 2043 2063 6f6d 7069 6c65 7220 6973 SI C compiler is │ │ │ │ │ +0003c260: 2061 7661 696c 6162 6c65 2c20 6974 2069 available, it i │ │ │ │ │ +0003c270: 7320 7573 6564 2e20 2049 6620 6e6f 2041 s used. If no A │ │ │ │ │ +0003c280: 4e53 4920 430a 636f 6d70 696c 6572 2069 NSI C.compiler i │ │ │ │ │ +0003c290: 7320 6176 6169 6c61 626c 652c 2074 6865 s available, the │ │ │ │ │ +0003c2a0: 2027 616e 7369 326b 6e72 2720 7072 6f67 'ansi2knr' prog │ │ │ │ │ +0003c2b0: 7261 6d20 6973 2075 7365 6420 746f 2063 ram is used to c │ │ │ │ │ +0003c2c0: 6f6e 7665 7274 2074 6865 0a73 6f75 7263 onvert the.sourc │ │ │ │ │ +0003c2d0: 6520 6669 6c65 7320 696e 746f 204b 2652 e files into K&R │ │ │ │ │ +0003c2e0: 2043 2c20 7768 6963 6820 6973 2074 6865 C, which is the │ │ │ │ │ +0003c2f0: 6e20 636f 6d70 696c 6564 2e0a 0a20 2020 n compiled... │ │ │ │ │ +0003c300: 5468 6520 2761 6e73 6932 6b6e 7227 2070 The 'ansi2knr' p │ │ │ │ │ +0003c310: 726f 6772 616d 2069 7320 7369 6d70 6c65 rogram is simple │ │ │ │ │ +0003c320: 2d6d 696e 6465 642e 2020 4974 2061 7373 -minded. It ass │ │ │ │ │ +0003c330: 756d 6573 2074 6865 2073 6f75 7263 6520 umes the source │ │ │ │ │ +0003c340: 636f 6465 0a77 696c 6c20 6265 2066 6f72 code.will be for │ │ │ │ │ +0003c350: 6d61 7474 6564 2069 6e20 6120 7061 7274 matted in a part │ │ │ │ │ +0003c360: 6963 756c 6172 2077 6179 3b20 7365 6520 icular way; see │ │ │ │ │ +0003c370: 7468 6520 2761 6e73 6932 6b6e 7227 206d the 'ansi2knr' m │ │ │ │ │ +0003c380: 616e 2070 6167 6520 666f 720a 6465 7461 an page for.deta │ │ │ │ │ +0003c390: 696c 732e 0a0a 2020 2053 7570 706f 7274 ils... Support │ │ │ │ │ +0003c3a0: 2066 6f72 2074 6865 206f 6273 6f6c 6574 for the obsolet │ │ │ │ │ +0003c3b0: 6520 6465 2d41 4e53 492d 6669 6361 7469 e de-ANSI-ficati │ │ │ │ │ +0003c3c0: 6f6e 2066 6561 7475 7265 2072 6571 7569 on feature requi │ │ │ │ │ +0003c3d0: 7265 7320 7468 6520 736f 7572 6365 0a66 res the source.f │ │ │ │ │ +0003c3e0: 696c 6573 2027 616e 7369 326b 6e72 2e63 iles 'ansi2knr.c │ │ │ │ │ +0003c3f0: 2720 616e 6420 2761 6e73 6932 6b6e 722e ' and 'ansi2knr. │ │ │ │ │ +0003c400: 3127 2074 6f20 6265 2069 6e20 7468 6520 1' to be in the │ │ │ │ │ +0003c410: 7361 6d65 2070 6163 6b61 6765 2061 7320 same package as │ │ │ │ │ +0003c420: 7468 650a 414e 5349 2043 2073 6f75 7263 the.ANSI C sourc │ │ │ │ │ +0003c430: 653b 2074 6865 7365 2066 696c 6573 2061 e; these files a │ │ │ │ │ +0003c440: 7265 2064 6973 7472 6962 7574 6564 2077 re distributed w │ │ │ │ │ +0003c450: 6974 6820 4175 746f 6d61 6b65 2e20 2041 ith Automake. A │ │ │ │ │ +0003c460: 6c73 6f2c 2074 6865 0a70 6163 6b61 6765 lso, the.package │ │ │ │ │ +0003c470: 2027 636f 6e66 6967 7572 652e 6163 2720 'configure.ac' │ │ │ │ │ +0003c480: 6d75 7374 2063 616c 6c20 7468 6520 6d61 must call the ma │ │ │ │ │ +0003c490: 6372 6f20 2741 4d5f 435f 5052 4f54 4f54 cro 'AM_C_PROTOT │ │ │ │ │ +0003c4a0: 5950 4553 2720 282a 6e6f 7465 0a4d 6163 YPES' (*note.Mac │ │ │ │ │ +0003c4b0: 726f 733a 3a29 2e0a 0a20 2020 4175 746f ros::)... Auto │ │ │ │ │ +0003c4c0: 6d61 6b65 2061 6c73 6f20 6861 6e64 6c65 make also handle │ │ │ │ │ +0003c4d0: 7320 6669 6e64 696e 6720 7468 6520 2761 s finding the 'a │ │ │ │ │ +0003c4e0: 6e73 6932 6b6e 7227 2073 7570 706f 7274 nsi2knr' support │ │ │ │ │ +0003c4f0: 2066 696c 6573 2069 6e20 736f 6d65 0a6f files in some.o │ │ │ │ │ +0003c500: 7468 6572 2064 6972 6563 746f 7279 2069 ther directory i │ │ │ │ │ +0003c510: 6e20 7468 6520 6375 7272 656e 7420 7061 n the current pa │ │ │ │ │ +0003c520: 636b 6167 652e 2020 5468 6973 2069 7320 ckage. This is │ │ │ │ │ +0003c530: 646f 6e65 2062 7920 7072 6570 656e 6469 done by prependi │ │ │ │ │ +0003c540: 6e67 2074 6865 0a72 656c 6174 6976 6520 ng the.relative │ │ │ │ │ +0003c550: 7061 7468 2074 6f20 7468 6520 6170 7072 path to the appr │ │ │ │ │ +0003c560: 6f70 7269 6174 6520 6469 7265 6374 6f72 opriate director │ │ │ │ │ +0003c570: 7920 746f 2074 6865 2027 616e 7369 326b y to the 'ansi2k │ │ │ │ │ +0003c580: 6e72 2720 6f70 7469 6f6e 2e0a 466f 7220 nr' option..For │ │ │ │ │ +0003c590: 696e 7374 616e 6365 2c20 7375 7070 6f73 instance, suppos │ │ │ │ │ +0003c5a0: 6520 7468 6520 7061 636b 6167 6520 6861 e the package ha │ │ │ │ │ +0003c5b0: 7320 414e 5349 2043 2063 6f64 6520 696e s ANSI C code in │ │ │ │ │ +0003c5c0: 2074 6865 2027 7372 6327 2061 6e64 2027 the 'src' and ' │ │ │ │ │ +0003c5d0: 6c69 6227 0a73 7562 6469 7265 6374 6f72 lib'.subdirector │ │ │ │ │ +0003c5e0: 6965 732e 2020 5468 6520 6669 6c65 7320 ies. The files │ │ │ │ │ +0003c5f0: 2761 6e73 6932 6b6e 722e 6327 2061 6e64 'ansi2knr.c' and │ │ │ │ │ +0003c600: 2027 616e 7369 326b 6e72 2e31 2720 6170 'ansi2knr.1' ap │ │ │ │ │ +0003c610: 7065 6172 2069 6e0a 276c 6962 272e 2020 pear in.'lib'. │ │ │ │ │ +0003c620: 5468 656e 2074 6869 7320 636f 756c 6420 Then this could │ │ │ │ │ +0003c630: 6170 7065 6172 2069 6e20 2773 7263 2f4d appear in 'src/M │ │ │ │ │ +0003c640: 616b 6566 696c 652e 616d 273a 0a0a 2020 akefile.am':.. │ │ │ │ │ +0003c650: 2020 2041 5554 4f4d 414b 455f 4f50 5449 AUTOMAKE_OPTI │ │ │ │ │ +0003c660: 4f4e 5320 3d20 2e2e 2f6c 6962 2f61 6e73 ONS = ../lib/ans │ │ │ │ │ +0003c670: 6932 6b6e 720a 0a20 2020 4966 206e 6f20 i2knr.. If no │ │ │ │ │ +0003c680: 6469 7265 6374 6f72 7920 7072 6566 6978 directory prefix │ │ │ │ │ +0003c690: 2069 7320 6769 7665 6e2c 2074 6865 2066 is given, the f │ │ │ │ │ +0003c6a0: 696c 6573 2061 7265 2061 7373 756d 6564 iles are assumed │ │ │ │ │ +0003c6b0: 2074 6f20 6265 2069 6e20 7468 650a 6375 to be in the.cu │ │ │ │ │ +0003c6c0: 7272 656e 7420 6469 7265 6374 6f72 792e rrent directory. │ │ │ │ │ +0003c6d0: 0a0a 2020 204e 6f74 6520 7468 6174 2061 .. Note that a │ │ │ │ │ +0003c6e0: 7574 6f6d 6174 6963 2064 652d 414e 5349 utomatic de-ANSI │ │ │ │ │ +0003c6f0: 2d66 6963 6174 696f 6e20 7769 6c6c 206e -fication will n │ │ │ │ │ +0003c700: 6f74 2077 6f72 6b20 7768 656e 2074 6865 ot work when the │ │ │ │ │ +0003c710: 2070 6163 6b61 6765 0a69 7320 6265 696e package.is bein │ │ │ │ │ +0003c720: 6720 6275 696c 7420 666f 7220 6120 6469 g built for a di │ │ │ │ │ +0003c730: 6666 6572 656e 7420 686f 7374 2061 7263 fferent host arc │ │ │ │ │ +0003c740: 6869 7465 6374 7572 652e 2020 5468 6174 hitecture. That │ │ │ │ │ +0003c750: 2069 7320 6265 6361 7573 650a 2761 7574 is because.'aut │ │ │ │ │ +0003c760: 6f6d 616b 6527 2063 7572 7265 6e74 6c79 omake' currently │ │ │ │ │ +0003c770: 2068 6173 206e 6f20 7761 7920 746f 2062 has no way to b │ │ │ │ │ +0003c780: 7569 6c64 2027 616e 7369 326b 6e72 2720 uild 'ansi2knr' │ │ │ │ │ +0003c790: 666f 7220 7468 6520 6275 696c 640a 6d61 for the build.ma │ │ │ │ │ +0003c7a0: 6368 696e 652e 0a0a 2020 2055 7369 6e67 chine... Using │ │ │ │ │ +0003c7b0: 2027 4c49 424f 424a 5327 2077 6974 6820 'LIBOBJS' with │ │ │ │ │ +0003c7c0: 736f 7572 6365 2064 652d 414e 5349 2d66 source de-ANSI-f │ │ │ │ │ +0003c7d0: 6963 6174 696f 6e20 7573 6564 2074 6f20 ication used to │ │ │ │ │ +0003c7e0: 7265 7175 6972 650a 6861 6e64 2d63 7261 require.hand-cra │ │ │ │ │ +0003c7f0: 6674 6564 2063 6f64 6520 696e 2027 636f fted code in 'co │ │ │ │ │ +0003c800: 6e66 6967 7572 6527 2074 6f20 6170 7065 nfigure' to appe │ │ │ │ │ +0003c810: 6e64 2027 2455 2720 746f 2062 6173 656e nd '$U' to basen │ │ │ │ │ +0003c820: 616d 6573 2069 6e0a 274c 4942 4f42 4a53 ames in.'LIBOBJS │ │ │ │ │ +0003c830: 272e 2020 5468 6973 2069 7320 6e6f 206c '. This is no l │ │ │ │ │ +0003c840: 6f6e 6765 7220 7472 7565 2074 6f64 6179 onger true today │ │ │ │ │ +0003c850: 2e20 2053 7461 7274 696e 6720 7769 7468 . Starting with │ │ │ │ │ +0003c860: 2076 6572 7369 6f6e 2032 2e35 342c 0a41 version 2.54,.A │ │ │ │ │ +0003c870: 7574 6f63 6f6e 6620 7461 6b65 7320 6361 utoconf takes ca │ │ │ │ │ +0003c880: 7265 206f 6620 7265 7772 6974 696e 6720 re of rewriting │ │ │ │ │ +0003c890: 274c 4942 4f42 4a53 2720 616e 6420 274c 'LIBOBJS' and 'L │ │ │ │ │ +0003c8a0: 544c 4942 4f42 4a53 272e 2020 282a 6e6f TLIBOBJS'. (*no │ │ │ │ │ +0003c8b0: 7465 0a27 4143 5f4c 4942 4f42 4a27 2076 te.'AC_LIBOBJ' v │ │ │ │ │ +0003c8c0: 732e 2027 4c49 424f 424a 5327 3a20 2861 s. 'LIBOBJS': (a │ │ │ │ │ +0003c8d0: 7574 6f63 6f6e 6629 4143 5f4c 4942 4f42 utoconf)AC_LIBOB │ │ │ │ │ +0003c8e0: 4a20 7673 204c 4942 4f42 4a53 2e29 0a0a J vs LIBOBJS.).. │ │ │ │ │ +0003c8f0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +0003c900: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +0003c910: 653a 2044 6570 656e 6465 6e63 6965 732c e: Dependencies, │ │ │ │ │ +0003c920: 2020 4e65 7874 3a20 4558 4545 5854 2c20 Next: EXEEXT, │ │ │ │ │ +0003c930: 2050 7265 763a 2041 4e53 492c 2020 5570 Prev: ANSI, Up │ │ │ │ │ +0003c940: 3a20 5072 6f67 7261 6d73 0a0a 382e 3139 : Programs..8.19 │ │ │ │ │ +0003c950: 2041 7574 6f6d 6174 6963 2064 6570 656e Automatic depen │ │ │ │ │ +0003c960: 6465 6e63 7920 7472 6163 6b69 6e67 0a3d dency tracking.= │ │ │ │ │ 0003c970: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003c980: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -0003c990: 0a41 7320 6120 6465 7665 6c6f 7065 7220 .As a developer │ │ │ │ │ -0003c9a0: 6974 2069 7320 6f66 7465 6e20 7061 696e it is often pain │ │ │ │ │ -0003c9b0: 6675 6c20 746f 2063 6f6e 7469 6e75 616c ful to continual │ │ │ │ │ -0003c9c0: 6c79 2075 7064 6174 6520 7468 650a 274d ly update the.'M │ │ │ │ │ -0003c9d0: 616b 6566 696c 652e 616d 2720 7768 656e akefile.am' when │ │ │ │ │ -0003c9e0: 6576 6572 2074 6865 2069 6e63 6c75 6465 ever the include │ │ │ │ │ -0003c9f0: 2d66 696c 6520 6465 7065 6e64 656e 6369 -file dependenci │ │ │ │ │ -0003ca00: 6573 2063 6861 6e67 6520 696e 2061 0a70 es change in a.p │ │ │ │ │ -0003ca10: 726f 6a65 6374 2e20 2041 7574 6f6d 616b roject. Automak │ │ │ │ │ -0003ca20: 6520 7375 7070 6c69 6573 2061 2077 6179 e supplies a way │ │ │ │ │ -0003ca30: 2074 6f20 6175 746f 6d61 7469 6361 6c6c to automaticall │ │ │ │ │ -0003ca40: 7920 7472 6163 6b20 6465 7065 6e64 656e y track dependen │ │ │ │ │ -0003ca50: 6379 0a63 6861 6e67 6573 2028 2a6e 6f74 cy.changes (*not │ │ │ │ │ -0003ca60: 6520 4465 7065 6e64 656e 6379 2054 7261 e Dependency Tra │ │ │ │ │ -0003ca70: 636b 696e 673a 3a29 2e0a 0a20 2020 4175 cking::)... Au │ │ │ │ │ -0003ca80: 746f 6d61 6b65 2061 6c77 6179 7320 7573 tomake always us │ │ │ │ │ -0003ca90: 6573 2063 6f6d 706c 6574 6520 6465 7065 es complete depe │ │ │ │ │ -0003caa0: 6e64 656e 6369 6573 2066 6f72 2061 2063 ndencies for a c │ │ │ │ │ -0003cab0: 6f6d 7069 6c61 7469 6f6e 2c0a 696e 636c ompilation,.incl │ │ │ │ │ -0003cac0: 7564 696e 6720 7379 7374 656d 2068 6561 uding system hea │ │ │ │ │ -0003cad0: 6465 7273 2e20 2041 7574 6f6d 616b 6527 ders. Automake' │ │ │ │ │ -0003cae0: 7320 6d6f 6465 6c20 6973 2074 6861 7420 s model is that │ │ │ │ │ -0003caf0: 6465 7065 6e64 656e 6379 0a63 6f6d 7075 dependency.compu │ │ │ │ │ -0003cb00: 7461 7469 6f6e 2073 686f 756c 6420 6265 tation should be │ │ │ │ │ -0003cb10: 2061 2073 6964 6520 6566 6665 6374 206f a side effect o │ │ │ │ │ -0003cb20: 6620 7468 6520 6275 696c 642e 2020 546f f the build. To │ │ │ │ │ -0003cb30: 2074 6869 7320 656e 642c 0a64 6570 656e this end,.depen │ │ │ │ │ -0003cb40: 6465 6e63 6965 7320 6172 6520 636f 6d70 dencies are comp │ │ │ │ │ -0003cb50: 7574 6564 2062 7920 7275 6e6e 696e 6720 uted by running │ │ │ │ │ -0003cb60: 616c 6c20 636f 6d70 696c 6174 696f 6e73 all compilations │ │ │ │ │ -0003cb70: 2074 6872 6f75 6768 2061 2073 7065 6369 through a speci │ │ │ │ │ -0003cb80: 616c 0a77 7261 7070 6572 2070 726f 6772 al.wrapper progr │ │ │ │ │ -0003cb90: 616d 2063 616c 6c65 6420 2764 6570 636f am called 'depco │ │ │ │ │ -0003cba0: 6d70 272e 2020 2764 6570 636f 6d70 2720 mp'. 'depcomp' │ │ │ │ │ -0003cbb0: 756e 6465 7273 7461 6e64 7320 686f 7720 understands how │ │ │ │ │ -0003cbc0: 746f 2063 6f61 780a 6d61 6e79 2064 6966 to coax.many dif │ │ │ │ │ -0003cbd0: 6665 7265 6e74 2043 2061 6e64 2043 2b2b ferent C and C++ │ │ │ │ │ -0003cbe0: 2063 6f6d 7069 6c65 7273 2069 6e74 6f20 compilers into │ │ │ │ │ -0003cbf0: 6765 6e65 7261 7469 6e67 2064 6570 656e generating depen │ │ │ │ │ -0003cc00: 6465 6e63 790a 696e 666f 726d 6174 696f dency.informatio │ │ │ │ │ -0003cc10: 6e20 696e 2074 6865 2066 6f72 6d61 7420 n in the format │ │ │ │ │ -0003cc20: 6974 2072 6571 7569 7265 732e 2020 2761 it requires. 'a │ │ │ │ │ -0003cc30: 7574 6f6d 616b 6520 2d61 2720 7769 6c6c utomake -a' will │ │ │ │ │ -0003cc40: 2069 6e73 7461 6c6c 0a27 6465 7063 6f6d install.'depcom │ │ │ │ │ -0003cc50: 7027 2069 6e74 6f20 796f 7572 2073 6f75 p' into your sou │ │ │ │ │ -0003cc60: 7263 6520 7472 6565 2066 6f72 2079 6f75 rce tree for you │ │ │ │ │ -0003cc70: 2e20 2049 6620 2764 6570 636f 6d70 2720 . If 'depcomp' │ │ │ │ │ -0003cc80: 6361 6e27 7420 6669 6775 7265 206f 7574 can't figure out │ │ │ │ │ -0003cc90: 0a68 6f77 2074 6f20 7072 6f70 6572 6c79 .how to properly │ │ │ │ │ -0003cca0: 2069 6e76 6f6b 6520 796f 7572 2063 6f6d invoke your com │ │ │ │ │ -0003ccb0: 7069 6c65 722c 2064 6570 656e 6465 6e63 piler, dependenc │ │ │ │ │ -0003ccc0: 7920 7472 6163 6b69 6e67 2077 696c 6c20 y tracking will │ │ │ │ │ -0003ccd0: 7369 6d70 6c79 2062 650a 6469 7361 626c simply be.disabl │ │ │ │ │ -0003cce0: 6564 2066 6f72 2079 6f75 7220 6275 696c ed for your buil │ │ │ │ │ -0003ccf0: 642e 0a0a 2020 2045 7870 6572 6965 6e63 d... Experienc │ │ │ │ │ -0003cd00: 6520 7769 7468 2065 6172 6c69 6572 2076 e with earlier v │ │ │ │ │ -0003cd10: 6572 7369 6f6e 7320 6f66 2041 7574 6f6d ersions of Autom │ │ │ │ │ -0003cd20: 616b 6520 282a 6e6f 7465 2044 6570 656e ake (*note Depen │ │ │ │ │ -0003cd30: 6465 6e63 790a 5472 6163 6b69 6e67 2045 dency.Tracking E │ │ │ │ │ -0003cd40: 766f 6c75 7469 6f6e 3a3a 2920 7461 7567 volution::) taug │ │ │ │ │ -0003cd50: 6874 2075 7320 7468 6174 2069 7420 6973 ht us that it is │ │ │ │ │ -0003cd60: 206e 6f74 2072 656c 6961 626c 6520 746f not reliable to │ │ │ │ │ -0003cd70: 2067 656e 6572 6174 650a 6465 7065 6e64 generate.depend │ │ │ │ │ -0003cd80: 656e 6369 6573 206f 6e6c 7920 6f6e 2074 encies only on t │ │ │ │ │ -0003cd90: 6865 206d 6169 6e74 6169 6e65 7227 7320 he maintainer's │ │ │ │ │ -0003cda0: 7379 7374 656d 2c20 6173 2063 6f6e 6669 system, as confi │ │ │ │ │ -0003cdb0: 6775 7261 7469 6f6e 7320 7661 7279 2074 gurations vary t │ │ │ │ │ -0003cdc0: 6f6f 0a6d 7563 682e 2020 536f 2069 6e73 oo.much. So ins │ │ │ │ │ -0003cdd0: 7465 6164 2041 7574 6f6d 616b 6520 696d tead Automake im │ │ │ │ │ -0003cde0: 706c 656d 656e 7473 2064 6570 656e 6465 plements depende │ │ │ │ │ -0003cdf0: 6e63 7920 7472 6163 6b69 6e67 2061 7420 ncy tracking at │ │ │ │ │ -0003ce00: 6275 696c 6420 7469 6d65 2e0a 0a20 2020 build time... │ │ │ │ │ -0003ce10: 4175 746f 6d61 7469 6320 6465 7065 6e64 Automatic depend │ │ │ │ │ -0003ce20: 656e 6379 2074 7261 636b 696e 6720 6361 ency tracking ca │ │ │ │ │ -0003ce30: 6e20 6265 2073 7570 7072 6573 7365 6420 n be suppressed │ │ │ │ │ -0003ce40: 6279 2070 7574 7469 6e67 0a27 6e6f 2d64 by putting.'no-d │ │ │ │ │ -0003ce50: 6570 656e 6465 6e63 6965 7327 2069 6e20 ependencies' in │ │ │ │ │ -0003ce60: 7468 6520 7661 7269 6162 6c65 2027 4155 the variable 'AU │ │ │ │ │ -0003ce70: 544f 4d41 4b45 5f4f 5054 494f 4e53 272c TOMAKE_OPTIONS', │ │ │ │ │ -0003ce80: 206f 7220 7061 7373 696e 670a 276e 6f2d or passing.'no- │ │ │ │ │ -0003ce90: 6465 7065 6e64 656e 6369 6573 2720 6173 dependencies' as │ │ │ │ │ -0003cea0: 2061 6e20 6172 6775 6d65 6e74 2074 6f20 an argument to │ │ │ │ │ -0003ceb0: 2741 4d5f 494e 4954 5f41 5554 4f4d 414b 'AM_INIT_AUTOMAK │ │ │ │ │ -0003cec0: 4527 2028 7468 6973 2073 686f 756c 6420 E' (this should │ │ │ │ │ -0003ced0: 6265 0a74 6865 2070 7265 6665 7272 6564 be.the preferred │ │ │ │ │ -0003cee0: 2077 6179 292e 2020 4f72 2c20 796f 7520 way). Or, you │ │ │ │ │ -0003cef0: 6361 6e20 696e 766f 6b65 2027 6175 746f can invoke 'auto │ │ │ │ │ -0003cf00: 6d61 6b65 2720 7769 7468 2074 6865 2027 make' with the ' │ │ │ │ │ -0003cf10: 2d69 2720 6f70 7469 6f6e 2e0a 4465 7065 -i' option..Depe │ │ │ │ │ -0003cf20: 6e64 656e 6379 2074 7261 636b 696e 6720 ndency tracking │ │ │ │ │ -0003cf30: 6973 2065 6e61 626c 6564 2062 7920 6465 is enabled by de │ │ │ │ │ -0003cf40: 6661 756c 742e 0a0a 2020 2054 6865 2070 fault... The p │ │ │ │ │ -0003cf50: 6572 736f 6e20 6275 696c 6469 6e67 2079 erson building y │ │ │ │ │ -0003cf60: 6f75 7220 7061 636b 6167 6520 616c 736f our package also │ │ │ │ │ -0003cf70: 2063 616e 2063 686f 6f73 6520 746f 2064 can choose to d │ │ │ │ │ -0003cf80: 6973 6162 6c65 0a64 6570 656e 6465 6e63 isable.dependenc │ │ │ │ │ -0003cf90: 7920 7472 6163 6b69 6e67 2062 7920 636f y tracking by co │ │ │ │ │ -0003cfa0: 6e66 6967 7572 696e 6720 7769 7468 2027 nfiguring with ' │ │ │ │ │ -0003cfb0: 2d2d 6469 7361 626c 652d 6465 7065 6e64 --disable-depend │ │ │ │ │ -0003cfc0: 656e 6379 2d74 7261 636b 696e 6727 2e0a ency-tracking'.. │ │ │ │ │ -0003cfd0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -0003cfe0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -0003cff0: 6465 3a20 4558 4545 5854 2c20 2050 7265 de: EXEEXT, Pre │ │ │ │ │ -0003d000: 763a 2044 6570 656e 6465 6e63 6965 732c v: Dependencies, │ │ │ │ │ -0003d010: 2020 5570 3a20 5072 6f67 7261 6d73 0a0a Up: Programs.. │ │ │ │ │ -0003d020: 382e 3230 2053 7570 706f 7274 2066 6f72 8.20 Support for │ │ │ │ │ -0003d030: 2065 7865 6375 7461 626c 6520 6578 7465 executable exte │ │ │ │ │ -0003d040: 6e73 696f 6e73 0a3d 3d3d 3d3d 3d3d 3d3d nsions.========= │ │ │ │ │ +0003c980: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0003c990: 3d0a 0a41 7320 6120 6465 7665 6c6f 7065 =..As a develope │ │ │ │ │ +0003c9a0: 7220 6974 2069 7320 6f66 7465 6e20 7061 r it is often pa │ │ │ │ │ +0003c9b0: 696e 6675 6c20 746f 2063 6f6e 7469 6e75 inful to continu │ │ │ │ │ +0003c9c0: 616c 6c79 2075 7064 6174 6520 7468 650a ally update the. │ │ │ │ │ +0003c9d0: 274d 616b 6566 696c 652e 616d 2720 7768 'Makefile.am' wh │ │ │ │ │ +0003c9e0: 656e 6576 6572 2074 6865 2069 6e63 6c75 enever the inclu │ │ │ │ │ +0003c9f0: 6465 2d66 696c 6520 6465 7065 6e64 656e de-file dependen │ │ │ │ │ +0003ca00: 6369 6573 2063 6861 6e67 6520 696e 2061 cies change in a │ │ │ │ │ +0003ca10: 0a70 726f 6a65 6374 2e20 2041 7574 6f6d .project. Autom │ │ │ │ │ +0003ca20: 616b 6520 7375 7070 6c69 6573 2061 2077 ake supplies a w │ │ │ │ │ +0003ca30: 6179 2074 6f20 6175 746f 6d61 7469 6361 ay to automatica │ │ │ │ │ +0003ca40: 6c6c 7920 7472 6163 6b20 6465 7065 6e64 lly track depend │ │ │ │ │ +0003ca50: 656e 6379 0a63 6861 6e67 6573 2028 2a6e ency.changes (*n │ │ │ │ │ +0003ca60: 6f74 6520 4465 7065 6e64 656e 6379 2054 ote Dependency T │ │ │ │ │ +0003ca70: 7261 636b 696e 673a 3a29 2e0a 0a20 2020 racking::)... │ │ │ │ │ +0003ca80: 4175 746f 6d61 6b65 2061 6c77 6179 7320 Automake always │ │ │ │ │ +0003ca90: 7573 6573 2063 6f6d 706c 6574 6520 6465 uses complete de │ │ │ │ │ +0003caa0: 7065 6e64 656e 6369 6573 2066 6f72 2061 pendencies for a │ │ │ │ │ +0003cab0: 2063 6f6d 7069 6c61 7469 6f6e 2c0a 696e compilation,.in │ │ │ │ │ +0003cac0: 636c 7564 696e 6720 7379 7374 656d 2068 cluding system h │ │ │ │ │ +0003cad0: 6561 6465 7273 2e20 2041 7574 6f6d 616b eaders. Automak │ │ │ │ │ +0003cae0: 6527 7320 6d6f 6465 6c20 6973 2074 6861 e's model is tha │ │ │ │ │ +0003caf0: 7420 6465 7065 6e64 656e 6379 0a63 6f6d t dependency.com │ │ │ │ │ +0003cb00: 7075 7461 7469 6f6e 2073 686f 756c 6420 putation should │ │ │ │ │ +0003cb10: 6265 2061 2073 6964 6520 6566 6665 6374 be a side effect │ │ │ │ │ +0003cb20: 206f 6620 7468 6520 6275 696c 642e 2020 of the build. │ │ │ │ │ +0003cb30: 546f 2074 6869 7320 656e 642c 0a64 6570 To this end,.dep │ │ │ │ │ +0003cb40: 656e 6465 6e63 6965 7320 6172 6520 636f endencies are co │ │ │ │ │ +0003cb50: 6d70 7574 6564 2062 7920 7275 6e6e 696e mputed by runnin │ │ │ │ │ +0003cb60: 6720 616c 6c20 636f 6d70 696c 6174 696f g all compilatio │ │ │ │ │ +0003cb70: 6e73 2074 6872 6f75 6768 2061 2073 7065 ns through a spe │ │ │ │ │ +0003cb80: 6369 616c 0a77 7261 7070 6572 2070 726f cial.wrapper pro │ │ │ │ │ +0003cb90: 6772 616d 2063 616c 6c65 6420 2764 6570 gram called 'dep │ │ │ │ │ +0003cba0: 636f 6d70 272e 2020 2764 6570 636f 6d70 comp'. 'depcomp │ │ │ │ │ +0003cbb0: 2720 756e 6465 7273 7461 6e64 7320 686f ' understands ho │ │ │ │ │ +0003cbc0: 7720 746f 2063 6f61 780a 6d61 6e79 2064 w to coax.many d │ │ │ │ │ +0003cbd0: 6966 6665 7265 6e74 2043 2061 6e64 2043 ifferent C and C │ │ │ │ │ +0003cbe0: 2b2b 2063 6f6d 7069 6c65 7273 2069 6e74 ++ compilers int │ │ │ │ │ +0003cbf0: 6f20 6765 6e65 7261 7469 6e67 2064 6570 o generating dep │ │ │ │ │ +0003cc00: 656e 6465 6e63 790a 696e 666f 726d 6174 endency.informat │ │ │ │ │ +0003cc10: 696f 6e20 696e 2074 6865 2066 6f72 6d61 ion in the forma │ │ │ │ │ +0003cc20: 7420 6974 2072 6571 7569 7265 732e 2020 t it requires. │ │ │ │ │ +0003cc30: 2761 7574 6f6d 616b 6520 2d61 2720 7769 'automake -a' wi │ │ │ │ │ +0003cc40: 6c6c 2069 6e73 7461 6c6c 0a27 6465 7063 ll install.'depc │ │ │ │ │ +0003cc50: 6f6d 7027 2069 6e74 6f20 796f 7572 2073 omp' into your s │ │ │ │ │ +0003cc60: 6f75 7263 6520 7472 6565 2066 6f72 2079 ource tree for y │ │ │ │ │ +0003cc70: 6f75 2e20 2049 6620 2764 6570 636f 6d70 ou. If 'depcomp │ │ │ │ │ +0003cc80: 2720 6361 6e27 7420 6669 6775 7265 206f ' can't figure o │ │ │ │ │ +0003cc90: 7574 0a68 6f77 2074 6f20 7072 6f70 6572 ut.how to proper │ │ │ │ │ +0003cca0: 6c79 2069 6e76 6f6b 6520 796f 7572 2063 ly invoke your c │ │ │ │ │ +0003ccb0: 6f6d 7069 6c65 722c 2064 6570 656e 6465 ompiler, depende │ │ │ │ │ +0003ccc0: 6e63 7920 7472 6163 6b69 6e67 2077 696c ncy tracking wil │ │ │ │ │ +0003ccd0: 6c20 7369 6d70 6c79 2062 650a 6469 7361 l simply be.disa │ │ │ │ │ +0003cce0: 626c 6564 2066 6f72 2079 6f75 7220 6275 bled for your bu │ │ │ │ │ +0003ccf0: 696c 642e 0a0a 2020 2045 7870 6572 6965 ild... Experie │ │ │ │ │ +0003cd00: 6e63 6520 7769 7468 2065 6172 6c69 6572 nce with earlier │ │ │ │ │ +0003cd10: 2076 6572 7369 6f6e 7320 6f66 2041 7574 versions of Aut │ │ │ │ │ +0003cd20: 6f6d 616b 6520 282a 6e6f 7465 2044 6570 omake (*note Dep │ │ │ │ │ +0003cd30: 656e 6465 6e63 790a 5472 6163 6b69 6e67 endency.Tracking │ │ │ │ │ +0003cd40: 2045 766f 6c75 7469 6f6e 3a3a 2920 7461 Evolution::) ta │ │ │ │ │ +0003cd50: 7567 6874 2075 7320 7468 6174 2069 7420 ught us that it │ │ │ │ │ +0003cd60: 6973 206e 6f74 2072 656c 6961 626c 6520 is not reliable │ │ │ │ │ +0003cd70: 746f 2067 656e 6572 6174 650a 6465 7065 to generate.depe │ │ │ │ │ +0003cd80: 6e64 656e 6369 6573 206f 6e6c 7920 6f6e ndencies only on │ │ │ │ │ +0003cd90: 2074 6865 206d 6169 6e74 6169 6e65 7227 the maintainer' │ │ │ │ │ +0003cda0: 7320 7379 7374 656d 2c20 6173 2063 6f6e s system, as con │ │ │ │ │ +0003cdb0: 6669 6775 7261 7469 6f6e 7320 7661 7279 figurations vary │ │ │ │ │ +0003cdc0: 2074 6f6f 0a6d 7563 682e 2020 536f 2069 too.much. So i │ │ │ │ │ +0003cdd0: 6e73 7465 6164 2041 7574 6f6d 616b 6520 nstead Automake │ │ │ │ │ +0003cde0: 696d 706c 656d 656e 7473 2064 6570 656e implements depen │ │ │ │ │ +0003cdf0: 6465 6e63 7920 7472 6163 6b69 6e67 2061 dency tracking a │ │ │ │ │ +0003ce00: 7420 6275 696c 6420 7469 6d65 2e0a 0a20 t build time... │ │ │ │ │ +0003ce10: 2020 4175 746f 6d61 7469 6320 6465 7065 Automatic depe │ │ │ │ │ +0003ce20: 6e64 656e 6379 2074 7261 636b 696e 6720 ndency tracking │ │ │ │ │ +0003ce30: 6361 6e20 6265 2073 7570 7072 6573 7365 can be suppresse │ │ │ │ │ +0003ce40: 6420 6279 2070 7574 7469 6e67 0a27 6e6f d by putting.'no │ │ │ │ │ +0003ce50: 2d64 6570 656e 6465 6e63 6965 7327 2069 -dependencies' i │ │ │ │ │ +0003ce60: 6e20 7468 6520 7661 7269 6162 6c65 2027 n the variable ' │ │ │ │ │ +0003ce70: 4155 544f 4d41 4b45 5f4f 5054 494f 4e53 AUTOMAKE_OPTIONS │ │ │ │ │ +0003ce80: 272c 206f 7220 7061 7373 696e 670a 276e ', or passing.'n │ │ │ │ │ +0003ce90: 6f2d 6465 7065 6e64 656e 6369 6573 2720 o-dependencies' │ │ │ │ │ +0003cea0: 6173 2061 6e20 6172 6775 6d65 6e74 2074 as an argument t │ │ │ │ │ +0003ceb0: 6f20 2741 4d5f 494e 4954 5f41 5554 4f4d o 'AM_INIT_AUTOM │ │ │ │ │ +0003cec0: 414b 4527 2028 7468 6973 2073 686f 756c AKE' (this shoul │ │ │ │ │ +0003ced0: 6420 6265 0a74 6865 2070 7265 6665 7272 d be.the preferr │ │ │ │ │ +0003cee0: 6564 2077 6179 292e 2020 4f72 2c20 796f ed way). Or, yo │ │ │ │ │ +0003cef0: 7520 6361 6e20 696e 766f 6b65 2027 6175 u can invoke 'au │ │ │ │ │ +0003cf00: 746f 6d61 6b65 2720 7769 7468 2074 6865 tomake' with the │ │ │ │ │ +0003cf10: 2027 2d69 2720 6f70 7469 6f6e 2e0a 4465 '-i' option..De │ │ │ │ │ +0003cf20: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ +0003cf30: 6720 6973 2065 6e61 626c 6564 2062 7920 g is enabled by │ │ │ │ │ +0003cf40: 6465 6661 756c 742e 0a0a 2020 2054 6865 default... The │ │ │ │ │ +0003cf50: 2070 6572 736f 6e20 6275 696c 6469 6e67 person building │ │ │ │ │ +0003cf60: 2079 6f75 7220 7061 636b 6167 6520 616c your package al │ │ │ │ │ +0003cf70: 736f 2063 616e 2063 686f 6f73 6520 746f so can choose to │ │ │ │ │ +0003cf80: 2064 6973 6162 6c65 0a64 6570 656e 6465 disable.depende │ │ │ │ │ +0003cf90: 6e63 7920 7472 6163 6b69 6e67 2062 7920 ncy tracking by │ │ │ │ │ +0003cfa0: 636f 6e66 6967 7572 696e 6720 7769 7468 configuring with │ │ │ │ │ +0003cfb0: 2027 2d2d 6469 7361 626c 652d 6465 7065 '--disable-depe │ │ │ │ │ +0003cfc0: 6e64 656e 6379 2d74 7261 636b 696e 6727 ndency-tracking' │ │ │ │ │ +0003cfd0: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +0003cfe0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +0003cff0: 4e6f 6465 3a20 4558 4545 5854 2c20 2050 Node: EXEEXT, P │ │ │ │ │ +0003d000: 7265 763a 2044 6570 656e 6465 6e63 6965 rev: Dependencie │ │ │ │ │ +0003d010: 732c 2020 5570 3a20 5072 6f67 7261 6d73 s, Up: Programs │ │ │ │ │ +0003d020: 0a0a 382e 3230 2053 7570 706f 7274 2066 ..8.20 Support f │ │ │ │ │ +0003d030: 6f72 2065 7865 6375 7461 626c 6520 6578 or executable ex │ │ │ │ │ +0003d040: 7465 6e73 696f 6e73 0a3d 3d3d 3d3d 3d3d tensions.======= │ │ │ │ │ 0003d050: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003d060: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a4f =============..O │ │ │ │ │ -0003d070: 6e20 736f 6d65 2070 6c61 7466 6f72 6d73 n some platforms │ │ │ │ │ -0003d080: 2c20 7375 6368 2061 7320 5769 6e64 6f77 , such as Window │ │ │ │ │ -0003d090: 732c 2065 7865 6375 7461 626c 6573 2061 s, executables a │ │ │ │ │ -0003d0a0: 7265 2065 7870 6563 7465 6420 746f 2068 re expected to h │ │ │ │ │ -0003d0b0: 6176 6520 616e 0a65 7874 656e 7369 6f6e ave an.extension │ │ │ │ │ -0003d0c0: 2073 7563 6820 6173 2027 2e65 7865 272e such as '.exe'. │ │ │ │ │ -0003d0d0: 2020 4f6e 2074 6865 7365 2070 6c61 7466 On these platf │ │ │ │ │ -0003d0e0: 6f72 6d73 2c20 736f 6d65 2063 6f6d 7069 orms, some compi │ │ │ │ │ -0003d0f0: 6c65 7273 2028 4743 4320 616d 6f6e 670a lers (GCC among. │ │ │ │ │ -0003d100: 7468 656d 2920 7769 6c6c 2061 7574 6f6d them) will autom │ │ │ │ │ -0003d110: 6174 6963 616c 6c79 2067 656e 6572 6174 atically generat │ │ │ │ │ -0003d120: 6520 2766 6f6f 2e65 7865 2720 7768 656e e 'foo.exe' when │ │ │ │ │ -0003d130: 2061 736b 6564 2074 6f20 6765 6e65 7261 asked to genera │ │ │ │ │ -0003d140: 7465 0a27 666f 6f27 2e0a 0a20 2020 4175 te.'foo'... Au │ │ │ │ │ -0003d150: 746f 6d61 6b65 2070 726f 7669 6465 7320 tomake provides │ │ │ │ │ -0003d160: 6d6f 7374 6c79 2d74 7261 6e73 7061 7265 mostly-transpare │ │ │ │ │ -0003d170: 6e74 2073 7570 706f 7274 2066 6f72 2074 nt support for t │ │ │ │ │ -0003d180: 6869 732e 2020 556e 666f 7274 756e 6174 his. Unfortunat │ │ │ │ │ -0003d190: 656c 790a 5f6d 6f73 746c 795f 2064 6f65 ely._mostly_ doe │ │ │ │ │ -0003d1a0: 736e 2774 2079 6574 206d 6561 6e20 5f66 sn't yet mean _f │ │ │ │ │ -0003d1b0: 756c 6c79 5f2e 2020 556e 7469 6c20 7468 ully_. Until th │ │ │ │ │ -0003d1c0: 6520 456e 676c 6973 6820 6469 6374 696f e English dictio │ │ │ │ │ -0003d1d0: 6e61 7279 2069 730a 7265 7669 7365 642c nary is.revised, │ │ │ │ │ -0003d1e0: 2079 6f75 2077 696c 6c20 6861 7665 2074 you will have t │ │ │ │ │ -0003d1f0: 6f20 6173 7369 7374 2041 7574 6f6d 616b o assist Automak │ │ │ │ │ -0003d200: 6520 6966 2079 6f75 7220 7061 636b 6167 e if your packag │ │ │ │ │ -0003d210: 6520 6d75 7374 2073 7570 706f 7274 0a74 e must support.t │ │ │ │ │ -0003d220: 686f 7365 2070 6c61 7466 6f72 6d73 2e0a hose platforms.. │ │ │ │ │ -0003d230: 0a20 2020 4f6e 6520 7468 696e 6720 796f . One thing yo │ │ │ │ │ -0003d240: 7520 6d75 7374 2062 6520 6177 6172 6520 u must be aware │ │ │ │ │ -0003d250: 6f66 2069 7320 7468 6174 2c20 696e 7465 of is that, inte │ │ │ │ │ -0003d260: 726e 616c 6c79 2c20 4175 746f 6d61 6b65 rnally, Automake │ │ │ │ │ -0003d270: 2072 6577 7269 7465 730a 736f 6d65 7468 rewrites.someth │ │ │ │ │ -0003d280: 696e 6720 6c69 6b65 2074 6869 733a 0a0a ing like this:.. │ │ │ │ │ -0003d290: 2020 2020 2062 696e 5f50 524f 4752 414d bin_PROGRAM │ │ │ │ │ -0003d2a0: 5320 3d20 6c69 7665 720a 0a20 2020 746f S = liver.. to │ │ │ │ │ -0003d2b0: 2074 6869 733a 0a0a 2020 2020 2062 696e this:.. bin │ │ │ │ │ -0003d2c0: 5f50 524f 4752 414d 5320 3d20 6c69 7665 _PROGRAMS = live │ │ │ │ │ -0003d2d0: 7224 2845 5845 4558 5429 0a0a 2020 2054 r$(EXEEXT).. T │ │ │ │ │ -0003d2e0: 6865 2074 6172 6765 7473 2041 7574 6f6d he targets Autom │ │ │ │ │ -0003d2f0: 616b 6520 6765 6e65 7261 7465 7320 6172 ake generates ar │ │ │ │ │ -0003d300: 6520 6c69 6b65 7769 7365 2067 6976 656e e likewise given │ │ │ │ │ -0003d310: 2074 6865 2027 2428 4558 4545 5854 2927 the '$(EXEEXT)' │ │ │ │ │ -0003d320: 0a65 7874 656e 7369 6f6e 2e0a 0a20 2020 .extension... │ │ │ │ │ -0003d330: 5468 6520 7661 7269 6162 6c65 7320 2754 The variables 'T │ │ │ │ │ -0003d340: 4553 5453 2720 616e 6420 2758 4641 494c ESTS' and 'XFAIL │ │ │ │ │ -0003d350: 5f54 4553 5453 2720 282a 6e6f 7465 2053 _TESTS' (*note S │ │ │ │ │ -0003d360: 696d 706c 6520 5465 7374 733a 3a29 2061 imple Tests::) a │ │ │ │ │ -0003d370: 7265 0a61 6c73 6f20 7265 7772 6974 7465 re.also rewritte │ │ │ │ │ -0003d380: 6e20 6966 2074 6865 7920 636f 6e74 6169 n if they contai │ │ │ │ │ -0003d390: 6e20 6669 6c65 6e61 6d65 7320 7468 6174 n filenames that │ │ │ │ │ -0003d3a0: 2068 6176 6520 6265 656e 2064 6563 6c61 have been decla │ │ │ │ │ -0003d3b0: 7265 6420 6173 0a70 726f 6772 616d 7320 red as.programs │ │ │ │ │ -0003d3c0: 696e 2074 6865 2073 616d 6520 274d 616b in the same 'Mak │ │ │ │ │ -0003d3d0: 6566 696c 6527 2e20 2028 5468 6973 2069 efile'. (This i │ │ │ │ │ -0003d3e0: 7320 6d6f 7374 6c79 2075 7365 6675 6c20 s mostly useful │ │ │ │ │ -0003d3f0: 7768 656e 2073 6f6d 650a 7072 6f67 7261 when some.progra │ │ │ │ │ -0003d400: 6d73 2066 726f 6d20 2763 6865 636b 5f50 ms from 'check_P │ │ │ │ │ -0003d410: 524f 4752 414d 5327 2061 7265 206c 6973 ROGRAMS' are lis │ │ │ │ │ -0003d420: 7465 6420 696e 2027 5445 5354 5327 2e29 ted in 'TESTS'.) │ │ │ │ │ -0003d430: 0a0a 2020 2048 6f77 6576 6572 2c20 4175 .. However, Au │ │ │ │ │ -0003d440: 746f 6d61 6b65 2063 616e 6e6f 7420 6170 tomake cannot ap │ │ │ │ │ -0003d450: 706c 7920 7468 6973 2072 6577 7269 7469 ply this rewriti │ │ │ │ │ -0003d460: 6e67 2074 6f20 2763 6f6e 6669 6775 7265 ng to 'configure │ │ │ │ │ -0003d470: 270a 7375 6273 7469 7475 7469 6f6e 732e '.substitutions. │ │ │ │ │ -0003d480: 2020 5468 6973 206d 6561 6e73 2074 6861 This means tha │ │ │ │ │ -0003d490: 7420 6966 2079 6f75 2061 7265 2063 6f6e t if you are con │ │ │ │ │ -0003d4a0: 6469 7469 6f6e 616c 6c79 2062 7569 6c64 ditionally build │ │ │ │ │ -0003d4b0: 696e 6720 610a 7072 6f67 7261 6d20 7573 ing a.program us │ │ │ │ │ -0003d4c0: 696e 6720 7375 6368 2061 2073 7562 7374 ing such a subst │ │ │ │ │ -0003d4d0: 6974 7574 696f 6e2c 2074 6865 6e20 796f itution, then yo │ │ │ │ │ -0003d4e0: 7572 2027 636f 6e66 6967 7572 652e 6163 ur 'configure.ac │ │ │ │ │ -0003d4f0: 2720 6d75 7374 2074 616b 650a 6361 7265 ' must take.care │ │ │ │ │ -0003d500: 2074 6f20 6164 6420 2724 2845 5845 4558 to add '$(EXEEX │ │ │ │ │ -0003d510: 5429 2720 7768 656e 2063 6f6e 7374 7275 T)' when constru │ │ │ │ │ -0003d520: 6374 696e 6720 7468 6520 6f75 7470 7574 cting the output │ │ │ │ │ -0003d530: 2076 6172 6961 626c 652e 0a0a 2020 2057 variable... W │ │ │ │ │ -0003d540: 6974 6820 4175 746f 636f 6e66 2032 2e31 ith Autoconf 2.1 │ │ │ │ │ -0003d550: 3320 616e 6420 6561 726c 6965 722c 2079 3 and earlier, y │ │ │ │ │ -0003d560: 6f75 206d 7573 7420 6578 706c 6963 6974 ou must explicit │ │ │ │ │ -0003d570: 6c79 2075 7365 2027 4143 5f45 5845 4558 ly use 'AC_EXEEX │ │ │ │ │ -0003d580: 5427 0a74 6f20 6765 7420 7468 6973 2073 T'.to get this s │ │ │ │ │ -0003d590: 7570 706f 7274 2e20 2057 6974 6820 4175 upport. With Au │ │ │ │ │ -0003d5a0: 746f 636f 6e66 2032 2e35 302c 2027 4143 toconf 2.50, 'AC │ │ │ │ │ -0003d5b0: 5f45 5845 4558 5427 2069 7320 7275 6e0a _EXEEXT' is run. │ │ │ │ │ -0003d5c0: 6175 746f 6d61 7469 6361 6c6c 7920 6966 automatically if │ │ │ │ │ -0003d5d0: 2079 6f75 2063 6f6e 6669 6775 7265 2061 you configure a │ │ │ │ │ -0003d5e0: 2063 6f6d 7069 6c65 7220 2873 6179 2c20 compiler (say, │ │ │ │ │ -0003d5f0: 7468 726f 7567 6820 2741 435f 5052 4f47 through 'AC_PROG │ │ │ │ │ -0003d600: 5f43 4327 292e 0a0a 2020 2053 6f6d 6574 _CC')... Somet │ │ │ │ │ -0003d610: 696d 6573 206d 6169 6e74 6169 6e65 7273 imes maintainers │ │ │ │ │ -0003d620: 206c 696b 6520 746f 2077 7269 7465 2061 like to write a │ │ │ │ │ -0003d630: 6e20 6578 706c 6963 6974 206c 696e 6b20 n explicit link │ │ │ │ │ -0003d640: 7275 6c65 2066 6f72 2074 6865 6972 0a70 rule for their.p │ │ │ │ │ -0003d650: 726f 6772 616d 2e20 2057 6974 686f 7574 rogram. Without │ │ │ │ │ -0003d660: 2065 7865 6375 7461 626c 6520 6578 7465 executable exte │ │ │ │ │ -0003d670: 6e73 696f 6e20 7375 7070 6f72 742c 2074 nsion support, t │ │ │ │ │ -0003d680: 6869 7320 6973 2065 6173 792d 2d79 6f75 his is easy--you │ │ │ │ │ -0003d690: 2073 696d 706c 790a 7772 6974 6520 6120 simply.write a │ │ │ │ │ -0003d6a0: 7275 6c65 2077 686f 7365 2074 6172 6765 rule whose targe │ │ │ │ │ -0003d6b0: 7420 6973 2074 6865 206e 616d 6520 6f66 t is the name of │ │ │ │ │ -0003d6c0: 2074 6865 2070 726f 6772 616d 2e20 2048 the program. H │ │ │ │ │ -0003d6d0: 6f77 6576 6572 2c20 7768 656e 0a65 7865 owever, when.exe │ │ │ │ │ -0003d6e0: 6375 7461 626c 6520 6578 7465 6e73 696f cutable extensio │ │ │ │ │ -0003d6f0: 6e20 7375 7070 6f72 7420 6973 2065 6e61 n support is ena │ │ │ │ │ -0003d700: 626c 6564 2c20 796f 7520 6d75 7374 2069 bled, you must i │ │ │ │ │ -0003d710: 6e73 7465 6164 2061 6464 2074 6865 0a27 nstead add the.' │ │ │ │ │ -0003d720: 2428 4558 4545 5854 2927 2073 7566 6669 $(EXEEXT)' suffi │ │ │ │ │ -0003d730: 782e 0a0a 2020 2055 6e66 6f72 7475 6e61 x... Unfortuna │ │ │ │ │ -0003d740: 7465 6c79 2c20 6475 6520 746f 2074 6865 tely, due to the │ │ │ │ │ -0003d750: 2063 6861 6e67 6520 696e 2041 7574 6f63 change in Autoc │ │ │ │ │ -0003d760: 6f6e 6620 322e 3530 2c20 7468 6973 206d onf 2.50, this m │ │ │ │ │ -0003d770: 6561 6e73 2079 6f75 0a6d 7573 7420 616c eans you.must al │ │ │ │ │ -0003d780: 7761 7973 2061 6464 2074 6869 7320 6578 ways add this ex │ │ │ │ │ -0003d790: 7465 6e73 696f 6e2e 2020 486f 7765 7665 tension. Howeve │ │ │ │ │ -0003d7a0: 722c 2074 6869 7320 6973 2061 2070 726f r, this is a pro │ │ │ │ │ -0003d7b0: 626c 656d 2066 6f72 0a6d 6169 6e74 6169 blem for.maintai │ │ │ │ │ -0003d7c0: 6e65 7273 2077 686f 206b 6e6f 7720 7468 ners who know th │ │ │ │ │ -0003d7d0: 6569 7220 7061 636b 6167 6520 7769 6c6c eir package will │ │ │ │ │ -0003d7e0: 206e 6576 6572 2072 756e 206f 6e20 6120 never run on a │ │ │ │ │ -0003d7f0: 706c 6174 666f 726d 2074 6861 7420 6861 platform that ha │ │ │ │ │ -0003d800: 730a 6578 6563 7574 6162 6c65 2065 7874 s.executable ext │ │ │ │ │ -0003d810: 656e 7369 6f6e 732e 2020 466f 7220 7468 ensions. For th │ │ │ │ │ -0003d820: 6f73 6520 6d61 696e 7461 696e 6572 732c ose maintainers, │ │ │ │ │ -0003d830: 2074 6865 2027 6e6f 2d65 7865 6578 7427 the 'no-exeext' │ │ │ │ │ -0003d840: 206f 7074 696f 6e0a 282a 6e6f 7465 204f option.(*note O │ │ │ │ │ -0003d850: 7074 696f 6e73 3a3a 2920 7769 6c6c 2064 ptions::) will d │ │ │ │ │ -0003d860: 6973 6162 6c65 2074 6869 7320 6665 6174 isable this feat │ │ │ │ │ -0003d870: 7572 652e 2020 5468 6973 2077 6f72 6b73 ure. This works │ │ │ │ │ -0003d880: 2069 6e20 6120 6661 6972 6c79 0a75 676c in a fairly.ugl │ │ │ │ │ -0003d890: 7920 7761 793b 2069 6620 276e 6f2d 6578 y way; if 'no-ex │ │ │ │ │ -0003d8a0: 6565 7874 2720 6973 2073 6565 6e2c 2074 eext' is seen, t │ │ │ │ │ -0003d8b0: 6865 6e20 7468 6520 7072 6573 656e 6365 hen the presence │ │ │ │ │ -0003d8c0: 206f 6620 6120 7275 6c65 2066 6f72 2061 of a rule for a │ │ │ │ │ -0003d8d0: 0a74 6172 6765 7420 6e61 6d65 6420 2766 .target named 'f │ │ │ │ │ -0003d8e0: 6f6f 2720 696e 2027 4d61 6b65 6669 6c65 oo' in 'Makefile │ │ │ │ │ -0003d8f0: 2e61 6d27 2077 696c 6c20 6f76 6572 7269 .am' will overri │ │ │ │ │ -0003d900: 6465 2061 6e0a 2761 7574 6f6d 616b 6527 de an.'automake' │ │ │ │ │ -0003d910: 2d67 656e 6572 6174 6564 2072 756c 6520 -generated rule │ │ │ │ │ -0003d920: 666f 7220 2766 6f6f 2428 4558 4545 5854 for 'foo$(EXEEXT │ │ │ │ │ -0003d930: 2927 2e20 2057 6974 686f 7574 2074 6865 )'. Without the │ │ │ │ │ -0003d940: 2027 6e6f 2d65 7865 6578 7427 0a6f 7074 'no-exeext'.opt │ │ │ │ │ -0003d950: 696f 6e2c 2074 6869 7320 7573 6520 7769 ion, this use wi │ │ │ │ │ -0003d960: 6c6c 2067 6976 6520 6120 6469 6167 6e6f ll give a diagno │ │ │ │ │ -0003d970: 7374 6963 2e0a 0a1f 0a46 696c 653a 2061 stic.....File: a │ │ │ │ │ -0003d980: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -0003d990: 6f2c 2020 4e6f 6465 3a20 4f74 6865 7220 o, Node: Other │ │ │ │ │ -0003d9a0: 4f62 6a65 6374 732c 2020 4e65 7874 3a20 Objects, Next: │ │ │ │ │ -0003d9b0: 4f74 6865 7220 474e 5520 546f 6f6c 732c Other GNU Tools, │ │ │ │ │ -0003d9c0: 2020 5072 6576 3a20 5072 6f67 7261 6d73 Prev: Programs │ │ │ │ │ -0003d9d0: 2c20 2055 703a 2054 6f70 0a0a 3920 4f74 , Up: Top..9 Ot │ │ │ │ │ -0003d9e0: 6865 7220 4465 7269 7665 6420 4f62 6a65 her Derived Obje │ │ │ │ │ -0003d9f0: 6374 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a cts.************ │ │ │ │ │ -0003da00: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a41 7574 ***********..Aut │ │ │ │ │ -0003da10: 6f6d 616b 6520 6361 6e20 6861 6e64 6c65 omake can handle │ │ │ │ │ -0003da20: 2064 6572 6976 6564 206f 626a 6563 7473 derived objects │ │ │ │ │ -0003da30: 2074 6861 7420 6172 6520 6e6f 7420 4320 that are not C │ │ │ │ │ -0003da40: 7072 6f67 7261 6d73 2e20 2053 6f6d 6574 programs. Somet │ │ │ │ │ -0003da50: 696d 6573 0a74 6865 2073 7570 706f 7274 imes.the support │ │ │ │ │ -0003da60: 2066 6f72 2061 6374 7561 6c6c 7920 6275 for actually bu │ │ │ │ │ -0003da70: 696c 6469 6e67 2073 7563 6820 6f62 6a65 ilding such obje │ │ │ │ │ -0003da80: 6374 7320 6d75 7374 2062 6520 6578 706c cts must be expl │ │ │ │ │ -0003da90: 6963 6974 6c79 0a73 7570 706c 6965 642c icitly.supplied, │ │ │ │ │ -0003daa0: 2062 7574 2041 7574 6f6d 616b 6520 7769 but Automake wi │ │ │ │ │ -0003dab0: 6c6c 2073 7469 6c6c 2061 7574 6f6d 6174 ll still automat │ │ │ │ │ -0003dac0: 6963 616c 6c79 2068 616e 646c 6520 696e ically handle in │ │ │ │ │ -0003dad0: 7374 616c 6c61 7469 6f6e 2061 6e64 0a64 stallation and.d │ │ │ │ │ -0003dae0: 6973 7472 6962 7574 696f 6e2e 0a0a 2a20 istribution...* │ │ │ │ │ -0003daf0: 4d65 6e75 3a0a 0a2a 2053 6372 6970 7473 Menu:..* Scripts │ │ │ │ │ -0003db00: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -0003db10: 2020 2020 2020 2045 7865 6375 7461 626c Executabl │ │ │ │ │ -0003db20: 6520 7363 7269 7074 730a 2a20 4865 6164 e scripts.* Head │ │ │ │ │ -0003db30: 6572 733a 3a20 2020 2020 2020 2020 2020 ers:: │ │ │ │ │ -0003db40: 2020 2020 2020 2020 2020 4865 6164 6572 Header │ │ │ │ │ -0003db50: 2066 696c 6573 0a2a 2044 6174 613a 3a20 files.* Data:: │ │ │ │ │ -0003db60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003db70: 2020 2020 2020 2041 7263 6869 7465 6374 Architect │ │ │ │ │ -0003db80: 7572 652d 696e 6465 7065 6e64 656e 7420 ure-independent │ │ │ │ │ -0003db90: 6461 7461 2066 696c 6573 0a2a 2053 6f75 data files.* Sou │ │ │ │ │ -0003dba0: 7263 6573 3a3a 2020 2020 2020 2020 2020 rces:: │ │ │ │ │ -0003dbb0: 2020 2020 2020 2020 2020 2044 6572 6976 Deriv │ │ │ │ │ -0003dbc0: 6564 2073 6f75 7263 6573 0a0a 1f0a 4669 ed sources....Fi │ │ │ │ │ -0003dbd0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ -0003dbe0: 312e 696e 666f 2c20 204e 6f64 653a 2053 1.info, Node: S │ │ │ │ │ -0003dbf0: 6372 6970 7473 2c20 204e 6578 743a 2048 cripts, Next: H │ │ │ │ │ -0003dc00: 6561 6465 7273 2c20 2055 703a 204f 7468 eaders, Up: Oth │ │ │ │ │ -0003dc10: 6572 204f 626a 6563 7473 0a0a 392e 3120 er Objects..9.1 │ │ │ │ │ -0003dc20: 4578 6563 7574 6162 6c65 2053 6372 6970 Executable Scrip │ │ │ │ │ -0003dc30: 7473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ts.============= │ │ │ │ │ -0003dc40: 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 7420 6973 =========..It is │ │ │ │ │ -0003dc50: 2070 6f73 7369 626c 6520 746f 2064 6566 possible to def │ │ │ │ │ -0003dc60: 696e 6520 616e 6420 696e 7374 616c 6c20 ine and install │ │ │ │ │ -0003dc70: 7072 6f67 7261 6d73 2074 6861 7420 6172 programs that ar │ │ │ │ │ -0003dc80: 6520 7363 7269 7074 732e 2020 5375 6368 e scripts. Such │ │ │ │ │ -0003dc90: 0a70 726f 6772 616d 7320 6172 6520 6c69 .programs are li │ │ │ │ │ -0003dca0: 7374 6564 2075 7369 6e67 2074 6865 2027 sted using the ' │ │ │ │ │ -0003dcb0: 5343 5249 5054 5327 2070 7269 6d61 7279 SCRIPTS' primary │ │ │ │ │ -0003dcc0: 206e 616d 652e 2020 5768 656e 2074 6865 name. When the │ │ │ │ │ -0003dcd0: 2073 6372 6970 740a 6973 2064 6973 7472 script.is distr │ │ │ │ │ -0003dce0: 6962 7574 6564 2069 6e20 6974 7320 6669 ibuted in its fi │ │ │ │ │ -0003dcf0: 6e61 6c2c 2069 6e73 7461 6c6c 6162 6c65 nal, installable │ │ │ │ │ -0003dd00: 2066 6f72 6d2c 2074 6865 2027 4d61 6b65 form, the 'Make │ │ │ │ │ -0003dd10: 6669 6c65 2720 7573 7561 6c6c 790a 6c6f file' usually.lo │ │ │ │ │ -0003dd20: 6f6b 7320 6173 2066 6f6c 6c6f 7773 3a0a oks as follows:. │ │ │ │ │ -0003dd30: 0a20 2020 2020 2320 496e 7374 616c 6c20 . # Install │ │ │ │ │ -0003dd40: 6d79 5f73 6372 6970 7420 696e 2024 2862 my_script in $(b │ │ │ │ │ -0003dd50: 696e 6469 7229 2061 6e64 2064 6973 7472 indir) and distr │ │ │ │ │ -0003dd60: 6962 7574 6520 6974 2e0a 2020 2020 2064 ibute it.. d │ │ │ │ │ -0003dd70: 6973 745f 6269 6e5f 5343 5249 5054 5320 ist_bin_SCRIPTS │ │ │ │ │ -0003dd80: 3d20 6d79 5f73 6372 6970 740a 0a20 2020 = my_script.. │ │ │ │ │ -0003dd90: 5363 7269 7074 7320 6172 6520 6e6f 7420 Scripts are not │ │ │ │ │ -0003dda0: 6469 7374 7269 6275 7465 6420 6279 2064 distributed by d │ │ │ │ │ -0003ddb0: 6566 6175 6c74 3b20 6173 2077 6520 6861 efault; as we ha │ │ │ │ │ -0003ddc0: 7665 206a 7573 7420 7365 656e 2c20 7468 ve just seen, th │ │ │ │ │ -0003ddd0: 6f73 650a 7468 6174 2073 686f 756c 6420 ose.that should │ │ │ │ │ -0003dde0: 6265 2064 6973 7472 6962 7574 6564 2063 be distributed c │ │ │ │ │ -0003ddf0: 616e 2062 6520 7370 6563 6966 6965 6420 an be specified │ │ │ │ │ -0003de00: 7573 696e 6720 6120 2764 6973 745f 2720 using a 'dist_' │ │ │ │ │ -0003de10: 7072 6566 6978 2061 730a 7769 7468 206f prefix as.with o │ │ │ │ │ -0003de20: 7468 6572 2070 7269 6d61 7269 6573 2e0a ther primaries.. │ │ │ │ │ -0003de30: 0a20 2020 5363 7269 7074 7320 6361 6e20 . Scripts can │ │ │ │ │ -0003de40: 6265 2069 6e73 7461 6c6c 6564 2069 6e20 be installed in │ │ │ │ │ -0003de50: 2762 696e 6469 7227 2c20 2773 6269 6e64 'bindir', 'sbind │ │ │ │ │ -0003de60: 6972 272c 2027 6c69 6265 7865 6364 6972 ir', 'libexecdir │ │ │ │ │ -0003de70: 272c 0a27 706b 676c 6962 6578 6563 6469 ',.'pkglibexecdi │ │ │ │ │ -0003de80: 7227 2c20 6f72 2027 706b 6764 6174 6164 r', or 'pkgdatad │ │ │ │ │ -0003de90: 6972 272e 0a0a 2020 2053 6372 6970 7473 ir'... Scripts │ │ │ │ │ -0003dea0: 2074 6861 7420 6e65 6564 206e 6f74 2062 that need not b │ │ │ │ │ -0003deb0: 6520 696e 7374 616c 6c65 6420 6361 6e20 e installed can │ │ │ │ │ -0003dec0: 6265 206c 6973 7465 6420 696e 2027 6e6f be listed in 'no │ │ │ │ │ -0003ded0: 696e 7374 5f53 4352 4950 5453 272c 0a61 inst_SCRIPTS',.a │ │ │ │ │ -0003dee0: 6e64 2061 6d6f 6e67 2074 6865 6d2c 2074 nd among them, t │ │ │ │ │ -0003def0: 686f 7365 2077 6869 6368 2061 7265 206e hose which are n │ │ │ │ │ -0003df00: 6565 6465 6420 6f6e 6c79 2062 7920 276d eeded only by 'm │ │ │ │ │ -0003df10: 616b 6520 6368 6563 6b27 2073 686f 756c ake check' shoul │ │ │ │ │ -0003df20: 6420 676f 2069 6e0a 2763 6865 636b 5f53 d go in.'check_S │ │ │ │ │ -0003df30: 4352 4950 5453 272e 0a0a 2020 2057 6865 CRIPTS'... Whe │ │ │ │ │ -0003df40: 6e20 6120 7363 7269 7074 206e 6565 6473 n a script needs │ │ │ │ │ -0003df50: 2074 6f20 6265 2062 7569 6c74 2c20 7468 to be built, th │ │ │ │ │ -0003df60: 6520 274d 616b 6566 696c 652e 616d 2720 e 'Makefile.am' │ │ │ │ │ -0003df70: 7368 6f75 6c64 2069 6e63 6c75 6465 2074 should include t │ │ │ │ │ -0003df80: 6865 0a61 7070 726f 7072 6961 7465 2072 he.appropriate r │ │ │ │ │ -0003df90: 756c 6573 2e20 2046 6f72 2069 6e73 7461 ules. For insta │ │ │ │ │ -0003dfa0: 6e63 6520 7468 6520 2761 7574 6f6d 616b nce the 'automak │ │ │ │ │ -0003dfb0: 6527 2070 726f 6772 616d 2069 7473 656c e' program itsel │ │ │ │ │ -0003dfc0: 6620 6973 2061 2050 6572 6c0a 7363 7269 f is a Perl.scri │ │ │ │ │ -0003dfd0: 7074 2074 6861 7420 6973 2067 656e 6572 pt that is gener │ │ │ │ │ -0003dfe0: 6174 6564 2066 726f 6d20 2761 7574 6f6d ated from 'autom │ │ │ │ │ -0003dff0: 616b 652e 696e 272e 2020 4865 7265 2069 ake.in'. Here i │ │ │ │ │ -0003e000: 7320 686f 7720 7468 6973 2069 730a 6861 s how this is.ha │ │ │ │ │ -0003e010: 6e64 6c65 643a 0a0a 2020 2020 2062 696e ndled:.. bin │ │ │ │ │ -0003e020: 5f53 4352 4950 5453 203d 2061 7574 6f6d _SCRIPTS = autom │ │ │ │ │ -0003e030: 616b 650a 2020 2020 2043 4c45 414e 4649 ake. CLEANFI │ │ │ │ │ -0003e040: 4c45 5320 3d20 2428 6269 6e5f 5343 5249 LES = $(bin_SCRI │ │ │ │ │ -0003e050: 5054 5329 0a20 2020 2020 4558 5452 415f PTS). EXTRA_ │ │ │ │ │ -0003e060: 4449 5354 203d 2061 7574 6f6d 616b 652e DIST = automake. │ │ │ │ │ -0003e070: 696e 0a0a 2020 2020 2064 6f5f 7375 6273 in.. do_subs │ │ │ │ │ -0003e080: 7420 3d20 7365 6420 2d65 2027 732c 5b40 t = sed -e 's,[@ │ │ │ │ │ -0003e090: 5d64 6174 6164 6972 5b40 5d2c 2428 6461 ]datadir[@],$(da │ │ │ │ │ -0003e0a0: 7461 6469 7229 2c67 2720 5c0a 2020 2020 tadir),g' \. │ │ │ │ │ -0003e0b0: 2020 2020 2020 2020 2020 2020 202d 6520 -e │ │ │ │ │ -0003e0c0: 2773 2c5b 405d 5045 524c 5b40 5d2c 2428 's,[@]PERL[@],$( │ │ │ │ │ -0003e0d0: 5045 524c 292c 6727 205c 0a20 2020 2020 PERL),g' \. │ │ │ │ │ -0003e0e0: 2020 2020 2020 2020 2020 2020 2d65 2027 -e ' │ │ │ │ │ -0003e0f0: 732c 5b40 5d50 4143 4b41 4745 5b40 5d2c s,[@]PACKAGE[@], │ │ │ │ │ -0003e100: 2428 5041 434b 4147 4529 2c67 2720 5c0a $(PACKAGE),g' \. │ │ │ │ │ -0003e110: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e120: 202d 6520 2773 2c5b 405d 5645 5253 494f -e 's,[@]VERSIO │ │ │ │ │ -0003e130: 4e5b 405d 2c24 2856 4552 5349 4f4e 292c N[@],$(VERSION), │ │ │ │ │ -0003e140: 6727 205c 0a20 2020 2020 2020 2020 2020 g' \. │ │ │ │ │ -0003e150: 2020 2020 2020 2e2e 2e0a 0a20 2020 2020 ..... │ │ │ │ │ -0003e160: 6175 746f 6d61 6b65 3a20 6175 746f 6d61 automake: automa │ │ │ │ │ -0003e170: 6b65 2e69 6e20 4d61 6b65 6669 6c65 0a20 ke.in Makefile. │ │ │ │ │ -0003e180: 2020 2020 2020 2020 2020 2020 2428 646f $(do │ │ │ │ │ -0003e190: 5f73 7562 7374 2920 3c20 2428 7372 6364 _subst) < $(srcd │ │ │ │ │ -0003e1a0: 6972 292f 6175 746f 6d61 6b65 2e69 6e20 ir)/automake.in │ │ │ │ │ -0003e1b0: 3e20 6175 746f 6d61 6b65 0a20 2020 2020 > automake. │ │ │ │ │ -0003e1c0: 2020 2020 2020 2020 6368 6d6f 6420 2b78 chmod +x │ │ │ │ │ -0003e1d0: 2061 7574 6f6d 616b 650a 0a20 2020 5375 automake.. Su │ │ │ │ │ -0003e1e0: 6368 2073 6372 6970 7473 2066 6f72 2077 ch scripts for w │ │ │ │ │ -0003e1f0: 6869 6368 2061 2062 7569 6c64 2072 756c hich a build rul │ │ │ │ │ -0003e200: 6520 6861 7320 6265 656e 2073 7570 706c e has been suppl │ │ │ │ │ -0003e210: 6965 6420 6e65 6564 2074 6f20 6265 0a64 ied need to be.d │ │ │ │ │ -0003e220: 656c 6574 6564 2065 7870 6c69 6369 746c eleted explicitl │ │ │ │ │ -0003e230: 7920 7573 696e 6720 2743 4c45 414e 4649 y using 'CLEANFI │ │ │ │ │ -0003e240: 4c45 5327 2028 2a6e 6f74 6520 436c 6561 LES' (*note Clea │ │ │ │ │ -0003e250: 6e3a 3a29 2c20 616e 6420 7468 6569 7220 n::), and their │ │ │ │ │ -0003e260: 736f 7572 6365 730a 6861 7665 2074 6f20 sources.have to │ │ │ │ │ -0003e270: 6265 2064 6973 7472 6962 7574 6564 2c20 be distributed, │ │ │ │ │ -0003e280: 7573 7561 6c6c 7920 7769 7468 2027 4558 usually with 'EX │ │ │ │ │ -0003e290: 5452 415f 4449 5354 2720 282a 6e6f 7465 TRA_DIST' (*note │ │ │ │ │ -0003e2a0: 2042 6173 6963 7320 6f66 0a44 6973 7472 Basics of.Distr │ │ │ │ │ -0003e2b0: 6962 7574 696f 6e3a 3a29 2e0a 0a20 2020 ibution::)... │ │ │ │ │ -0003e2c0: 416e 6f74 6865 7220 636f 6d6d 6f6e 2077 Another common w │ │ │ │ │ -0003e2d0: 6179 2074 6f20 6275 696c 6420 7363 7269 ay to build scri │ │ │ │ │ -0003e2e0: 7074 7320 6973 2074 6f20 7072 6f63 6573 pts is to proces │ │ │ │ │ -0003e2f0: 7320 7468 656d 2066 726f 6d0a 2763 6f6e s them from.'con │ │ │ │ │ -0003e300: 6669 6775 7265 2720 7769 7468 2027 4143 figure' with 'AC │ │ │ │ │ -0003e310: 5f43 4f4e 4649 475f 4649 4c45 5327 2e20 _CONFIG_FILES'. │ │ │ │ │ -0003e320: 2049 6e20 7468 6973 2073 6974 7561 7469 In this situati │ │ │ │ │ -0003e330: 6f6e 2041 7574 6f6d 616b 6520 6b6e 6f77 on Automake know │ │ │ │ │ -0003e340: 730a 7768 6963 6820 6669 6c65 7320 7368 s.which files sh │ │ │ │ │ -0003e350: 6f75 6c64 2062 6520 636c 6561 6e65 6420 ould be cleaned │ │ │ │ │ -0003e360: 616e 6420 6469 7374 7269 6275 7465 642c and distributed, │ │ │ │ │ -0003e370: 2061 6e64 2077 6861 7420 7468 6520 7265 and what the re │ │ │ │ │ -0003e380: 6275 696c 640a 7275 6c65 7320 7368 6f75 build.rules shou │ │ │ │ │ -0003e390: 6c64 206c 6f6f 6b20 6c69 6b65 2e0a 0a20 ld look like... │ │ │ │ │ -0003e3a0: 2020 466f 7220 696e 7374 616e 6365 2069 For instance i │ │ │ │ │ -0003e3b0: 6620 2763 6f6e 6669 6775 7265 2e61 6327 f 'configure.ac' │ │ │ │ │ -0003e3c0: 2063 6f6e 7461 696e 730a 0a20 2020 2020 contains.. │ │ │ │ │ -0003e3d0: 4143 5f43 4f4e 4649 475f 4649 4c45 5328 AC_CONFIG_FILES( │ │ │ │ │ -0003e3e0: 5b73 7263 2f6d 795f 7363 7269 7074 5d2c [src/my_script], │ │ │ │ │ -0003e3f0: 205b 6368 6d6f 6420 2b78 2073 7263 2f6d [chmod +x src/m │ │ │ │ │ -0003e400: 795f 7363 7269 7074 5d29 0a0a 746f 2062 y_script])..to b │ │ │ │ │ -0003e410: 7569 6c64 2027 7372 632f 6d79 5f73 6372 uild 'src/my_scr │ │ │ │ │ -0003e420: 6970 7427 2066 726f 6d20 2773 7263 2f6d ipt' from 'src/m │ │ │ │ │ -0003e430: 795f 7363 7269 7074 2e69 6e27 2c20 7468 y_script.in', th │ │ │ │ │ -0003e440: 656e 2061 0a27 7372 632f 4d61 6b65 6669 en a.'src/Makefi │ │ │ │ │ -0003e450: 6c65 2e61 6d27 2074 6f20 696e 7374 616c le.am' to instal │ │ │ │ │ -0003e460: 6c20 7468 6973 2073 6372 6970 7420 696e l this script in │ │ │ │ │ -0003e470: 2027 2428 6269 6e64 6972 2927 2063 616e '$(bindir)' can │ │ │ │ │ -0003e480: 2062 6520 6173 2073 696d 706c 650a 6173 be as simple.as │ │ │ │ │ -0003e490: 0a0a 2020 2020 2062 696e 5f53 4352 4950 .. bin_SCRIP │ │ │ │ │ -0003e4a0: 5453 203d 206d 795f 7363 7269 7074 0a20 TS = my_script. │ │ │ │ │ -0003e4b0: 2020 2020 434c 4541 4e46 494c 4553 203d CLEANFILES = │ │ │ │ │ -0003e4c0: 2024 2862 696e 5f53 4352 4950 5453 290a $(bin_SCRIPTS). │ │ │ │ │ -0003e4d0: 0a54 6865 7265 2069 7320 6e6f 206e 6565 .There is no nee │ │ │ │ │ -0003e4e0: 6420 666f 7220 2745 5854 5241 5f44 4953 d for 'EXTRA_DIS │ │ │ │ │ -0003e4f0: 5427 206f 7220 616e 7920 6275 696c 6420 T' or any build │ │ │ │ │ -0003e500: 7275 6c65 3a20 4175 746f 6d61 6b65 2069 rule: Automake i │ │ │ │ │ -0003e510: 6e66 6572 730a 7468 656d 2066 726f 6d20 nfers.them from │ │ │ │ │ -0003e520: 2741 435f 434f 4e46 4947 5f46 494c 4553 'AC_CONFIG_FILES │ │ │ │ │ -0003e530: 2720 282a 6e6f 7465 2052 6571 7569 7265 ' (*note Require │ │ │ │ │ -0003e540: 6d65 6e74 733a 3a29 2e20 2027 434c 4541 ments::). 'CLEA │ │ │ │ │ -0003e550: 4e46 494c 4553 2720 6973 0a73 7469 6c6c NFILES' is.still │ │ │ │ │ -0003e560: 2075 7365 6675 6c2c 2062 6563 6175 7365 useful, because │ │ │ │ │ -0003e570: 2062 7920 6465 6661 756c 7420 4175 746f by default Auto │ │ │ │ │ -0003e580: 6d61 6b65 2077 696c 6c20 636c 6561 6e20 make will clean │ │ │ │ │ -0003e590: 7461 7267 6574 7320 6f66 0a27 4143 5f43 targets of.'AC_C │ │ │ │ │ -0003e5a0: 4f4e 4649 475f 4649 4c45 5327 2069 6e20 ONFIG_FILES' in │ │ │ │ │ -0003e5b0: 2764 6973 7463 6c65 616e 272c 206e 6f74 'distclean', not │ │ │ │ │ -0003e5c0: 2027 636c 6561 6e27 2e0a 0a20 2020 416c 'clean'... Al │ │ │ │ │ -0003e5d0: 7468 6f75 6768 2074 6869 7320 6c6f 6f6b though this look │ │ │ │ │ -0003e5e0: 7320 7369 6d70 6c65 722c 2062 7569 6c64 s simpler, build │ │ │ │ │ -0003e5f0: 696e 6720 7363 7269 7074 7320 7468 6973 ing scripts this │ │ │ │ │ -0003e600: 2077 6179 2068 6173 206f 6e65 0a64 7261 way has one.dra │ │ │ │ │ -0003e610: 7762 6163 6b3a 2064 6972 6563 746f 7279 wback: directory │ │ │ │ │ -0003e620: 2076 6172 6961 626c 6573 2073 7563 6820 variables such │ │ │ │ │ -0003e630: 6173 2027 2428 6461 7461 6469 7229 2720 as '$(datadir)' │ │ │ │ │ -0003e640: 6172 6520 6e6f 7420 6675 6c6c 790a 6578 are not fully.ex │ │ │ │ │ -0003e650: 7061 6e64 6564 2061 6e64 206d 6179 2072 panded and may r │ │ │ │ │ -0003e660: 6566 6572 2074 6f20 6f74 6865 7220 6469 efer to other di │ │ │ │ │ -0003e670: 7265 6374 6f72 7920 7661 7269 6162 6c65 rectory variable │ │ │ │ │ -0003e680: 732e 0a0a 1f0a 4669 6c65 3a20 6175 746f s.....File: auto │ │ │ │ │ -0003e690: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -0003e6a0: 204e 6f64 653a 2048 6561 6465 7273 2c20 Node: Headers, │ │ │ │ │ -0003e6b0: 204e 6578 743a 2044 6174 612c 2020 5072 Next: Data, Pr │ │ │ │ │ -0003e6c0: 6576 3a20 5363 7269 7074 732c 2020 5570 ev: Scripts, Up │ │ │ │ │ -0003e6d0: 3a20 4f74 6865 7220 4f62 6a65 6374 730a : Other Objects. │ │ │ │ │ -0003e6e0: 0a39 2e32 2048 6561 6465 7220 6669 6c65 .9.2 Header file │ │ │ │ │ -0003e6f0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ -0003e700: 3d3d 0a0a 4865 6164 6572 2066 696c 6573 ==..Header files │ │ │ │ │ -0003e710: 2074 6861 7420 6d75 7374 2062 6520 696e that must be in │ │ │ │ │ -0003e720: 7374 616c 6c65 6420 6172 6520 7370 6563 stalled are spec │ │ │ │ │ -0003e730: 6966 6965 6420 6279 2074 6865 2027 4845 ified by the 'HE │ │ │ │ │ -0003e740: 4144 4552 5327 0a66 616d 696c 7920 6f66 ADERS'.family of │ │ │ │ │ -0003e750: 2076 6172 6961 626c 6573 2e20 2048 6561 variables. Hea │ │ │ │ │ -0003e760: 6465 7273 2063 616e 2062 6520 696e 7374 ders can be inst │ │ │ │ │ -0003e770: 616c 6c65 6420 696e 2027 696e 636c 7564 alled in 'includ │ │ │ │ │ -0003e780: 6564 6972 272c 0a27 6f6c 6469 6e63 6c75 edir',.'oldinclu │ │ │ │ │ -0003e790: 6465 6469 7227 2c20 2770 6b67 696e 636c dedir', 'pkgincl │ │ │ │ │ -0003e7a0: 7564 6564 6972 2720 6f72 2061 6e79 206f udedir' or any o │ │ │ │ │ -0003e7b0: 7468 6572 2064 6972 6563 746f 7279 2079 ther directory y │ │ │ │ │ -0003e7c0: 6f75 206d 6179 2068 6176 650a 6465 6669 ou may have.defi │ │ │ │ │ -0003e7d0: 6e65 6420 282a 6e6f 7465 2055 6e69 666f ned (*note Unifo │ │ │ │ │ -0003e7e0: 726d 3a3a 292e 2020 466f 7220 696e 7374 rm::). For inst │ │ │ │ │ -0003e7f0: 616e 6365 2c0a 0a20 2020 2020 696e 636c ance,.. incl │ │ │ │ │ -0003e800: 7564 655f 4845 4144 4552 5320 3d20 666f ude_HEADERS = fo │ │ │ │ │ -0003e810: 6f2e 6820 6261 722f 6261 722e 680a 0a77 o.h bar/bar.h..w │ │ │ │ │ -0003e820: 696c 6c20 696e 7374 616c 6c20 7468 6520 ill install the │ │ │ │ │ -0003e830: 7477 6f20 6669 6c65 7320 6173 2027 2428 two files as '$( │ │ │ │ │ -0003e840: 696e 636c 7564 6564 6972 292f 666f 6f2e includedir)/foo. │ │ │ │ │ -0003e850: 6827 2061 6e64 0a27 2428 696e 636c 7564 h' and.'$(includ │ │ │ │ │ -0003e860: 6564 6972 292f 6261 722e 6827 2e0a 0a20 edir)/bar.h'... │ │ │ │ │ -0003e870: 2020 5468 6520 276e 6f62 6173 655f 2720 The 'nobase_' │ │ │ │ │ -0003e880: 7072 6566 6978 2069 7320 616c 736f 2073 prefix is also s │ │ │ │ │ -0003e890: 7570 706f 7274 6564 2c0a 0a20 2020 2020 upported,.. │ │ │ │ │ -0003e8a0: 6e6f 6261 7365 5f69 6e63 6c75 6465 5f48 nobase_include_H │ │ │ │ │ -0003e8b0: 4541 4445 5253 203d 2066 6f6f 2e68 2062 EADERS = foo.h b │ │ │ │ │ -0003e8c0: 6172 2f62 6172 2e68 0a0a 7769 6c6c 2069 ar/bar.h..will i │ │ │ │ │ -0003e8d0: 6e73 7461 6c6c 2074 6865 2074 776f 2066 nstall the two f │ │ │ │ │ -0003e8e0: 696c 6573 2061 7320 2724 2869 6e63 6c75 iles as '$(inclu │ │ │ │ │ -0003e8f0: 6465 6469 7229 2f66 6f6f 2e68 2720 616e dedir)/foo.h' an │ │ │ │ │ -0003e900: 640a 2724 2869 6e63 6c75 6465 6469 7229 d.'$(includedir) │ │ │ │ │ -0003e910: 2f62 6172 2f62 6172 2e68 2720 282a 6e6f /bar/bar.h' (*no │ │ │ │ │ -0003e920: 7465 2041 6c74 6572 6e61 7469 7665 3a3a te Alternative:: │ │ │ │ │ -0003e930: 292e 0a0a 2020 2055 7375 616c 6c79 2c20 )... Usually, │ │ │ │ │ -0003e940: 6f6e 6c79 2068 6561 6465 7220 6669 6c65 only header file │ │ │ │ │ -0003e950: 7320 7468 6174 2061 6363 6f6d 7061 6e79 s that accompany │ │ │ │ │ -0003e960: 2069 6e73 7461 6c6c 6564 206c 6962 7261 installed libra │ │ │ │ │ -0003e970: 7269 6573 206e 6565 6420 746f 0a62 6520 ries need to.be │ │ │ │ │ -0003e980: 696e 7374 616c 6c65 642e 2020 4865 6164 installed. Head │ │ │ │ │ -0003e990: 6572 7320 7573 6564 2062 7920 7072 6f67 ers used by prog │ │ │ │ │ -0003e9a0: 7261 6d73 206f 7220 636f 6e76 656e 6965 rams or convenie │ │ │ │ │ -0003e9b0: 6e63 6520 6c69 6272 6172 6965 7320 6172 nce libraries ar │ │ │ │ │ -0003e9c0: 6520 6e6f 740a 696e 7374 616c 6c65 642e e not.installed. │ │ │ │ │ -0003e9d0: 2020 5468 6520 276e 6f69 6e73 745f 4845 The 'noinst_HE │ │ │ │ │ -0003e9e0: 4144 4552 5327 2076 6172 6961 626c 6520 ADERS' variable │ │ │ │ │ -0003e9f0: 6361 6e20 6265 2075 7365 6420 666f 7220 can be used for │ │ │ │ │ -0003ea00: 7375 6368 2068 6561 6465 7273 2e0a 486f such headers..Ho │ │ │ │ │ -0003ea10: 7765 7665 7220 7768 656e 2074 6865 2068 wever when the h │ │ │ │ │ -0003ea20: 6561 6465 7220 6163 7475 616c 6c79 2062 eader actually b │ │ │ │ │ -0003ea30: 656c 6f6e 6773 2074 6f20 6120 7369 6e67 elongs to a sing │ │ │ │ │ -0003ea40: 6c65 2063 6f6e 7665 6e69 656e 6365 206c le convenience l │ │ │ │ │ -0003ea50: 6962 7261 7279 0a6f 7220 7072 6f67 7261 ibrary.or progra │ │ │ │ │ -0003ea60: 6d2c 2077 6520 7265 636f 6d6d 656e 6420 m, we recommend │ │ │ │ │ -0003ea70: 6c69 7374 696e 6720 6974 2069 6e20 7468 listing it in th │ │ │ │ │ -0003ea80: 6520 7072 6f67 7261 6d27 7320 6f72 206c e program's or l │ │ │ │ │ -0003ea90: 6962 7261 7279 2773 0a27 5f53 4f55 5243 ibrary's.'_SOURC │ │ │ │ │ -0003eaa0: 4553 2720 7661 7269 6162 6c65 2028 2a6e ES' variable (*n │ │ │ │ │ -0003eab0: 6f74 6520 5072 6f67 7261 6d20 536f 7572 ote Program Sour │ │ │ │ │ -0003eac0: 6365 733a 3a29 2069 6e73 7465 6164 206f ces::) instead o │ │ │ │ │ -0003ead0: 6620 696e 0a27 6e6f 696e 7374 5f48 4541 f in.'noinst_HEA │ │ │ │ │ -0003eae0: 4445 5253 272e 2020 5468 6973 2069 7320 DERS'. This is │ │ │ │ │ -0003eaf0: 636c 6561 7265 7220 666f 7220 7468 6520 clearer for the │ │ │ │ │ -0003eb00: 274d 616b 6566 696c 652e 616d 2720 7265 'Makefile.am' re │ │ │ │ │ -0003eb10: 6164 6572 2e0a 276e 6f69 6e73 745f 4845 ader..'noinst_HE │ │ │ │ │ -0003eb20: 4144 4552 5327 2077 6f75 6c64 2062 6520 ADERS' would be │ │ │ │ │ -0003eb30: 7468 6520 7269 6768 7420 7661 7269 6162 the right variab │ │ │ │ │ -0003eb40: 6c65 2074 6f20 7573 6520 696e 2061 2064 le to use in a d │ │ │ │ │ -0003eb50: 6972 6563 746f 7279 0a63 6f6e 7461 696e irectory.contain │ │ │ │ │ -0003eb60: 696e 6720 6f6e 6c79 2068 6561 6465 7273 ing only headers │ │ │ │ │ -0003eb70: 2061 6e64 206e 6f20 6173 736f 6369 6174 and no associat │ │ │ │ │ -0003eb80: 6564 206c 6962 7261 7279 206f 7220 7072 ed library or pr │ │ │ │ │ -0003eb90: 6f67 7261 6d2e 0a0a 2020 2041 6c6c 2068 ogram... All h │ │ │ │ │ -0003eba0: 6561 6465 7220 6669 6c65 7320 6d75 7374 eader files must │ │ │ │ │ -0003ebb0: 2062 6520 6c69 7374 6564 2073 6f6d 6577 be listed somew │ │ │ │ │ -0003ebc0: 6865 7265 3b20 696e 2061 2027 5f53 4f55 here; in a '_SOU │ │ │ │ │ -0003ebd0: 5243 4553 2720 7661 7269 6162 6c65 0a6f RCES' variable.o │ │ │ │ │ -0003ebe0: 7220 696e 2061 2027 5f48 4541 4445 5253 r in a '_HEADERS │ │ │ │ │ -0003ebf0: 2720 7661 7269 6162 6c65 2e20 204d 6973 ' variable. Mis │ │ │ │ │ -0003ec00: 7369 6e67 206f 6e65 7320 7769 6c6c 206e sing ones will n │ │ │ │ │ -0003ec10: 6f74 2061 7070 6561 7220 696e 2074 6865 ot appear in the │ │ │ │ │ -0003ec20: 0a64 6973 7472 6962 7574 696f 6e2e 0a0a .distribution... │ │ │ │ │ -0003ec30: 2020 2046 6f72 2068 6561 6465 7220 6669 For header fi │ │ │ │ │ -0003ec40: 6c65 7320 7468 6174 2061 7265 2062 7569 les that are bui │ │ │ │ │ -0003ec50: 6c74 2061 6e64 206d 7573 7420 6e6f 7420 lt and must not │ │ │ │ │ -0003ec60: 6265 2064 6973 7472 6962 7574 6564 2c20 be distributed, │ │ │ │ │ -0003ec70: 7573 6520 7468 650a 276e 6f64 6973 745f use the.'nodist_ │ │ │ │ │ -0003ec80: 2720 7072 6566 6978 2061 7320 696e 2027 ' prefix as in ' │ │ │ │ │ -0003ec90: 6e6f 6469 7374 5f69 6e63 6c75 6465 5f48 nodist_include_H │ │ │ │ │ -0003eca0: 4541 4445 5253 2720 6f72 0a27 6e6f 6469 EADERS' or.'nodi │ │ │ │ │ -0003ecb0: 7374 5f70 726f 675f 534f 5552 4345 5327 st_prog_SOURCES' │ │ │ │ │ -0003ecc0: 2e20 2049 6620 7468 6573 6520 6765 6e65 . If these gene │ │ │ │ │ -0003ecd0: 7261 7465 6420 6865 6164 6572 7320 6172 rated headers ar │ │ │ │ │ -0003ece0: 6520 6e65 6564 6564 2064 7572 696e 6720 e needed during │ │ │ │ │ -0003ecf0: 7468 650a 6275 696c 642c 2079 6f75 206d the.build, you m │ │ │ │ │ -0003ed00: 7573 7420 616c 736f 2065 6e73 7572 6520 ust also ensure │ │ │ │ │ -0003ed10: 7468 6579 2065 7869 7374 2062 6566 6f72 they exist befor │ │ │ │ │ -0003ed20: 6520 7468 6579 2061 7265 2075 7365 6420 e they are used │ │ │ │ │ -0003ed30: 282a 6e6f 7465 0a53 6f75 7263 6573 3a3a (*note.Sources:: │ │ │ │ │ -0003ed40: 292e 0a0a 1f0a 4669 6c65 3a20 6175 746f ).....File: auto │ │ │ │ │ -0003ed50: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -0003ed60: 204e 6f64 653a 2044 6174 612c 2020 4e65 Node: Data, Ne │ │ │ │ │ -0003ed70: 7874 3a20 536f 7572 6365 732c 2020 5072 xt: Sources, Pr │ │ │ │ │ -0003ed80: 6576 3a20 4865 6164 6572 732c 2020 5570 ev: Headers, Up │ │ │ │ │ -0003ed90: 3a20 4f74 6865 7220 4f62 6a65 6374 730a : Other Objects. │ │ │ │ │ -0003eda0: 0a39 2e33 2041 7263 6869 7465 6374 7572 .9.3 Architectur │ │ │ │ │ -0003edb0: 652d 696e 6465 7065 6e64 656e 7420 6461 e-independent da │ │ │ │ │ -0003edc0: 7461 2066 696c 6573 0a3d 3d3d 3d3d 3d3d ta files.======= │ │ │ │ │ +0003d060: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +0003d070: 0a4f 6e20 736f 6d65 2070 6c61 7466 6f72 .On some platfor │ │ │ │ │ +0003d080: 6d73 2c20 7375 6368 2061 7320 5769 6e64 ms, such as Wind │ │ │ │ │ +0003d090: 6f77 732c 2065 7865 6375 7461 626c 6573 ows, executables │ │ │ │ │ +0003d0a0: 2061 7265 2065 7870 6563 7465 6420 746f are expected to │ │ │ │ │ +0003d0b0: 2068 6176 6520 616e 0a65 7874 656e 7369 have an.extensi │ │ │ │ │ +0003d0c0: 6f6e 2073 7563 6820 6173 2027 2e65 7865 on such as '.exe │ │ │ │ │ +0003d0d0: 272e 2020 4f6e 2074 6865 7365 2070 6c61 '. On these pla │ │ │ │ │ +0003d0e0: 7466 6f72 6d73 2c20 736f 6d65 2063 6f6d tforms, some com │ │ │ │ │ +0003d0f0: 7069 6c65 7273 2028 4743 4320 616d 6f6e pilers (GCC amon │ │ │ │ │ +0003d100: 670a 7468 656d 2920 7769 6c6c 2061 7574 g.them) will aut │ │ │ │ │ +0003d110: 6f6d 6174 6963 616c 6c79 2067 656e 6572 omatically gener │ │ │ │ │ +0003d120: 6174 6520 2766 6f6f 2e65 7865 2720 7768 ate 'foo.exe' wh │ │ │ │ │ +0003d130: 656e 2061 736b 6564 2074 6f20 6765 6e65 en asked to gene │ │ │ │ │ +0003d140: 7261 7465 0a27 666f 6f27 2e0a 0a20 2020 rate.'foo'... │ │ │ │ │ +0003d150: 4175 746f 6d61 6b65 2070 726f 7669 6465 Automake provide │ │ │ │ │ +0003d160: 7320 6d6f 7374 6c79 2d74 7261 6e73 7061 s mostly-transpa │ │ │ │ │ +0003d170: 7265 6e74 2073 7570 706f 7274 2066 6f72 rent support for │ │ │ │ │ +0003d180: 2074 6869 732e 2020 556e 666f 7274 756e this. Unfortun │ │ │ │ │ +0003d190: 6174 656c 790a 5f6d 6f73 746c 795f 2064 ately._mostly_ d │ │ │ │ │ +0003d1a0: 6f65 736e 2774 2079 6574 206d 6561 6e20 oesn't yet mean │ │ │ │ │ +0003d1b0: 5f66 756c 6c79 5f2e 2020 556e 7469 6c20 _fully_. Until │ │ │ │ │ +0003d1c0: 7468 6520 456e 676c 6973 6820 6469 6374 the English dict │ │ │ │ │ +0003d1d0: 696f 6e61 7279 2069 730a 7265 7669 7365 ionary is.revise │ │ │ │ │ +0003d1e0: 642c 2079 6f75 2077 696c 6c20 6861 7665 d, you will have │ │ │ │ │ +0003d1f0: 2074 6f20 6173 7369 7374 2041 7574 6f6d to assist Autom │ │ │ │ │ +0003d200: 616b 6520 6966 2079 6f75 7220 7061 636b ake if your pack │ │ │ │ │ +0003d210: 6167 6520 6d75 7374 2073 7570 706f 7274 age must support │ │ │ │ │ +0003d220: 0a74 686f 7365 2070 6c61 7466 6f72 6d73 .those platforms │ │ │ │ │ +0003d230: 2e0a 0a20 2020 4f6e 6520 7468 696e 6720 ... One thing │ │ │ │ │ +0003d240: 796f 7520 6d75 7374 2062 6520 6177 6172 you must be awar │ │ │ │ │ +0003d250: 6520 6f66 2069 7320 7468 6174 2c20 696e e of is that, in │ │ │ │ │ +0003d260: 7465 726e 616c 6c79 2c20 4175 746f 6d61 ternally, Automa │ │ │ │ │ +0003d270: 6b65 2072 6577 7269 7465 730a 736f 6d65 ke rewrites.some │ │ │ │ │ +0003d280: 7468 696e 6720 6c69 6b65 2074 6869 733a thing like this: │ │ │ │ │ +0003d290: 0a0a 2020 2020 2062 696e 5f50 524f 4752 .. bin_PROGR │ │ │ │ │ +0003d2a0: 414d 5320 3d20 6c69 7665 720a 0a20 2020 AMS = liver.. │ │ │ │ │ +0003d2b0: 746f 2074 6869 733a 0a0a 2020 2020 2062 to this:.. b │ │ │ │ │ +0003d2c0: 696e 5f50 524f 4752 414d 5320 3d20 6c69 in_PROGRAMS = li │ │ │ │ │ +0003d2d0: 7665 7224 2845 5845 4558 5429 0a0a 2020 ver$(EXEEXT).. │ │ │ │ │ +0003d2e0: 2054 6865 2074 6172 6765 7473 2041 7574 The targets Aut │ │ │ │ │ +0003d2f0: 6f6d 616b 6520 6765 6e65 7261 7465 7320 omake generates │ │ │ │ │ +0003d300: 6172 6520 6c69 6b65 7769 7365 2067 6976 are likewise giv │ │ │ │ │ +0003d310: 656e 2074 6865 2027 2428 4558 4545 5854 en the '$(EXEEXT │ │ │ │ │ +0003d320: 2927 0a65 7874 656e 7369 6f6e 2e0a 0a20 )'.extension... │ │ │ │ │ +0003d330: 2020 5468 6520 7661 7269 6162 6c65 7320 The variables │ │ │ │ │ +0003d340: 2754 4553 5453 2720 616e 6420 2758 4641 'TESTS' and 'XFA │ │ │ │ │ +0003d350: 494c 5f54 4553 5453 2720 282a 6e6f 7465 IL_TESTS' (*note │ │ │ │ │ +0003d360: 2053 696d 706c 6520 5465 7374 733a 3a29 Simple Tests::) │ │ │ │ │ +0003d370: 2061 7265 0a61 6c73 6f20 7265 7772 6974 are.also rewrit │ │ │ │ │ +0003d380: 7465 6e20 6966 2074 6865 7920 636f 6e74 ten if they cont │ │ │ │ │ +0003d390: 6169 6e20 6669 6c65 6e61 6d65 7320 7468 ain filenames th │ │ │ │ │ +0003d3a0: 6174 2068 6176 6520 6265 656e 2064 6563 at have been dec │ │ │ │ │ +0003d3b0: 6c61 7265 6420 6173 0a70 726f 6772 616d lared as.program │ │ │ │ │ +0003d3c0: 7320 696e 2074 6865 2073 616d 6520 274d s in the same 'M │ │ │ │ │ +0003d3d0: 616b 6566 696c 6527 2e20 2028 5468 6973 akefile'. (This │ │ │ │ │ +0003d3e0: 2069 7320 6d6f 7374 6c79 2075 7365 6675 is mostly usefu │ │ │ │ │ +0003d3f0: 6c20 7768 656e 2073 6f6d 650a 7072 6f67 l when some.prog │ │ │ │ │ +0003d400: 7261 6d73 2066 726f 6d20 2763 6865 636b rams from 'check │ │ │ │ │ +0003d410: 5f50 524f 4752 414d 5327 2061 7265 206c _PROGRAMS' are l │ │ │ │ │ +0003d420: 6973 7465 6420 696e 2027 5445 5354 5327 isted in 'TESTS' │ │ │ │ │ +0003d430: 2e29 0a0a 2020 2048 6f77 6576 6572 2c20 .).. However, │ │ │ │ │ +0003d440: 4175 746f 6d61 6b65 2063 616e 6e6f 7420 Automake cannot │ │ │ │ │ +0003d450: 6170 706c 7920 7468 6973 2072 6577 7269 apply this rewri │ │ │ │ │ +0003d460: 7469 6e67 2074 6f20 2763 6f6e 6669 6775 ting to 'configu │ │ │ │ │ +0003d470: 7265 270a 7375 6273 7469 7475 7469 6f6e re'.substitution │ │ │ │ │ +0003d480: 732e 2020 5468 6973 206d 6561 6e73 2074 s. This means t │ │ │ │ │ +0003d490: 6861 7420 6966 2079 6f75 2061 7265 2063 hat if you are c │ │ │ │ │ +0003d4a0: 6f6e 6469 7469 6f6e 616c 6c79 2062 7569 onditionally bui │ │ │ │ │ +0003d4b0: 6c64 696e 6720 610a 7072 6f67 7261 6d20 lding a.program │ │ │ │ │ +0003d4c0: 7573 696e 6720 7375 6368 2061 2073 7562 using such a sub │ │ │ │ │ +0003d4d0: 7374 6974 7574 696f 6e2c 2074 6865 6e20 stitution, then │ │ │ │ │ +0003d4e0: 796f 7572 2027 636f 6e66 6967 7572 652e your 'configure. │ │ │ │ │ +0003d4f0: 6163 2720 6d75 7374 2074 616b 650a 6361 ac' must take.ca │ │ │ │ │ +0003d500: 7265 2074 6f20 6164 6420 2724 2845 5845 re to add '$(EXE │ │ │ │ │ +0003d510: 4558 5429 2720 7768 656e 2063 6f6e 7374 EXT)' when const │ │ │ │ │ +0003d520: 7275 6374 696e 6720 7468 6520 6f75 7470 ructing the outp │ │ │ │ │ +0003d530: 7574 2076 6172 6961 626c 652e 0a0a 2020 ut variable... │ │ │ │ │ +0003d540: 2057 6974 6820 4175 746f 636f 6e66 2032 With Autoconf 2 │ │ │ │ │ +0003d550: 2e31 3320 616e 6420 6561 726c 6965 722c .13 and earlier, │ │ │ │ │ +0003d560: 2079 6f75 206d 7573 7420 6578 706c 6963 you must explic │ │ │ │ │ +0003d570: 6974 6c79 2075 7365 2027 4143 5f45 5845 itly use 'AC_EXE │ │ │ │ │ +0003d580: 4558 5427 0a74 6f20 6765 7420 7468 6973 EXT'.to get this │ │ │ │ │ +0003d590: 2073 7570 706f 7274 2e20 2057 6974 6820 support. With │ │ │ │ │ +0003d5a0: 4175 746f 636f 6e66 2032 2e35 302c 2027 Autoconf 2.50, ' │ │ │ │ │ +0003d5b0: 4143 5f45 5845 4558 5427 2069 7320 7275 AC_EXEEXT' is ru │ │ │ │ │ +0003d5c0: 6e0a 6175 746f 6d61 7469 6361 6c6c 7920 n.automatically │ │ │ │ │ +0003d5d0: 6966 2079 6f75 2063 6f6e 6669 6775 7265 if you configure │ │ │ │ │ +0003d5e0: 2061 2063 6f6d 7069 6c65 7220 2873 6179 a compiler (say │ │ │ │ │ +0003d5f0: 2c20 7468 726f 7567 6820 2741 435f 5052 , through 'AC_PR │ │ │ │ │ +0003d600: 4f47 5f43 4327 292e 0a0a 2020 2053 6f6d OG_CC')... Som │ │ │ │ │ +0003d610: 6574 696d 6573 206d 6169 6e74 6169 6e65 etimes maintaine │ │ │ │ │ +0003d620: 7273 206c 696b 6520 746f 2077 7269 7465 rs like to write │ │ │ │ │ +0003d630: 2061 6e20 6578 706c 6963 6974 206c 696e an explicit lin │ │ │ │ │ +0003d640: 6b20 7275 6c65 2066 6f72 2074 6865 6972 k rule for their │ │ │ │ │ +0003d650: 0a70 726f 6772 616d 2e20 2057 6974 686f .program. Witho │ │ │ │ │ +0003d660: 7574 2065 7865 6375 7461 626c 6520 6578 ut executable ex │ │ │ │ │ +0003d670: 7465 6e73 696f 6e20 7375 7070 6f72 742c tension support, │ │ │ │ │ +0003d680: 2074 6869 7320 6973 2065 6173 792d 2d79 this is easy--y │ │ │ │ │ +0003d690: 6f75 2073 696d 706c 790a 7772 6974 6520 ou simply.write │ │ │ │ │ +0003d6a0: 6120 7275 6c65 2077 686f 7365 2074 6172 a rule whose tar │ │ │ │ │ +0003d6b0: 6765 7420 6973 2074 6865 206e 616d 6520 get is the name │ │ │ │ │ +0003d6c0: 6f66 2074 6865 2070 726f 6772 616d 2e20 of the program. │ │ │ │ │ +0003d6d0: 2048 6f77 6576 6572 2c20 7768 656e 0a65 However, when.e │ │ │ │ │ +0003d6e0: 7865 6375 7461 626c 6520 6578 7465 6e73 xecutable extens │ │ │ │ │ +0003d6f0: 696f 6e20 7375 7070 6f72 7420 6973 2065 ion support is e │ │ │ │ │ +0003d700: 6e61 626c 6564 2c20 796f 7520 6d75 7374 nabled, you must │ │ │ │ │ +0003d710: 2069 6e73 7465 6164 2061 6464 2074 6865 instead add the │ │ │ │ │ +0003d720: 0a27 2428 4558 4545 5854 2927 2073 7566 .'$(EXEEXT)' suf │ │ │ │ │ +0003d730: 6669 782e 0a0a 2020 2055 6e66 6f72 7475 fix... Unfortu │ │ │ │ │ +0003d740: 6e61 7465 6c79 2c20 6475 6520 746f 2074 nately, due to t │ │ │ │ │ +0003d750: 6865 2063 6861 6e67 6520 696e 2041 7574 he change in Aut │ │ │ │ │ +0003d760: 6f63 6f6e 6620 322e 3530 2c20 7468 6973 oconf 2.50, this │ │ │ │ │ +0003d770: 206d 6561 6e73 2079 6f75 0a6d 7573 7420 means you.must │ │ │ │ │ +0003d780: 616c 7761 7973 2061 6464 2074 6869 7320 always add this │ │ │ │ │ +0003d790: 6578 7465 6e73 696f 6e2e 2020 486f 7765 extension. Howe │ │ │ │ │ +0003d7a0: 7665 722c 2074 6869 7320 6973 2061 2070 ver, this is a p │ │ │ │ │ +0003d7b0: 726f 626c 656d 2066 6f72 0a6d 6169 6e74 roblem for.maint │ │ │ │ │ +0003d7c0: 6169 6e65 7273 2077 686f 206b 6e6f 7720 ainers who know │ │ │ │ │ +0003d7d0: 7468 6569 7220 7061 636b 6167 6520 7769 their package wi │ │ │ │ │ +0003d7e0: 6c6c 206e 6576 6572 2072 756e 206f 6e20 ll never run on │ │ │ │ │ +0003d7f0: 6120 706c 6174 666f 726d 2074 6861 7420 a platform that │ │ │ │ │ +0003d800: 6861 730a 6578 6563 7574 6162 6c65 2065 has.executable e │ │ │ │ │ +0003d810: 7874 656e 7369 6f6e 732e 2020 466f 7220 xtensions. For │ │ │ │ │ +0003d820: 7468 6f73 6520 6d61 696e 7461 696e 6572 those maintainer │ │ │ │ │ +0003d830: 732c 2074 6865 2027 6e6f 2d65 7865 6578 s, the 'no-exeex │ │ │ │ │ +0003d840: 7427 206f 7074 696f 6e0a 282a 6e6f 7465 t' option.(*note │ │ │ │ │ +0003d850: 204f 7074 696f 6e73 3a3a 2920 7769 6c6c Options::) will │ │ │ │ │ +0003d860: 2064 6973 6162 6c65 2074 6869 7320 6665 disable this fe │ │ │ │ │ +0003d870: 6174 7572 652e 2020 5468 6973 2077 6f72 ature. This wor │ │ │ │ │ +0003d880: 6b73 2069 6e20 6120 6661 6972 6c79 0a75 ks in a fairly.u │ │ │ │ │ +0003d890: 676c 7920 7761 793b 2069 6620 276e 6f2d gly way; if 'no- │ │ │ │ │ +0003d8a0: 6578 6565 7874 2720 6973 2073 6565 6e2c exeext' is seen, │ │ │ │ │ +0003d8b0: 2074 6865 6e20 7468 6520 7072 6573 656e then the presen │ │ │ │ │ +0003d8c0: 6365 206f 6620 6120 7275 6c65 2066 6f72 ce of a rule for │ │ │ │ │ +0003d8d0: 2061 0a74 6172 6765 7420 6e61 6d65 6420 a.target named │ │ │ │ │ +0003d8e0: 2766 6f6f 2720 696e 2027 4d61 6b65 6669 'foo' in 'Makefi │ │ │ │ │ +0003d8f0: 6c65 2e61 6d27 2077 696c 6c20 6f76 6572 le.am' will over │ │ │ │ │ +0003d900: 7269 6465 2061 6e0a 2761 7574 6f6d 616b ride an.'automak │ │ │ │ │ +0003d910: 6527 2d67 656e 6572 6174 6564 2072 756c e'-generated rul │ │ │ │ │ +0003d920: 6520 666f 7220 2766 6f6f 2428 4558 4545 e for 'foo$(EXEE │ │ │ │ │ +0003d930: 5854 2927 2e20 2057 6974 686f 7574 2074 XT)'. Without t │ │ │ │ │ +0003d940: 6865 2027 6e6f 2d65 7865 6578 7427 0a6f he 'no-exeext'.o │ │ │ │ │ +0003d950: 7074 696f 6e2c 2074 6869 7320 7573 6520 ption, this use │ │ │ │ │ +0003d960: 7769 6c6c 2067 6976 6520 6120 6469 6167 will give a diag │ │ │ │ │ +0003d970: 6e6f 7374 6963 2e0a 0a1f 0a46 696c 653a nostic.....File: │ │ │ │ │ +0003d980: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +0003d990: 6e66 6f2c 2020 4e6f 6465 3a20 4f74 6865 nfo, Node: Othe │ │ │ │ │ +0003d9a0: 7220 4f62 6a65 6374 732c 2020 4e65 7874 r Objects, Next │ │ │ │ │ +0003d9b0: 3a20 4f74 6865 7220 474e 5520 546f 6f6c : Other GNU Tool │ │ │ │ │ +0003d9c0: 732c 2020 5072 6576 3a20 5072 6f67 7261 s, Prev: Progra │ │ │ │ │ +0003d9d0: 6d73 2c20 2055 703a 2054 6f70 0a0a 3920 ms, Up: Top..9 │ │ │ │ │ +0003d9e0: 4f74 6865 7220 4465 7269 7665 6420 4f62 Other Derived Ob │ │ │ │ │ +0003d9f0: 6a65 6374 730a 2a2a 2a2a 2a2a 2a2a 2a2a jects.********** │ │ │ │ │ +0003da00: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a41 *************..A │ │ │ │ │ +0003da10: 7574 6f6d 616b 6520 6361 6e20 6861 6e64 utomake can hand │ │ │ │ │ +0003da20: 6c65 2064 6572 6976 6564 206f 626a 6563 le derived objec │ │ │ │ │ +0003da30: 7473 2074 6861 7420 6172 6520 6e6f 7420 ts that are not │ │ │ │ │ +0003da40: 4320 7072 6f67 7261 6d73 2e20 2053 6f6d C programs. Som │ │ │ │ │ +0003da50: 6574 696d 6573 0a74 6865 2073 7570 706f etimes.the suppo │ │ │ │ │ +0003da60: 7274 2066 6f72 2061 6374 7561 6c6c 7920 rt for actually │ │ │ │ │ +0003da70: 6275 696c 6469 6e67 2073 7563 6820 6f62 building such ob │ │ │ │ │ +0003da80: 6a65 6374 7320 6d75 7374 2062 6520 6578 jects must be ex │ │ │ │ │ +0003da90: 706c 6963 6974 6c79 0a73 7570 706c 6965 plicitly.supplie │ │ │ │ │ +0003daa0: 642c 2062 7574 2041 7574 6f6d 616b 6520 d, but Automake │ │ │ │ │ +0003dab0: 7769 6c6c 2073 7469 6c6c 2061 7574 6f6d will still autom │ │ │ │ │ +0003dac0: 6174 6963 616c 6c79 2068 616e 646c 6520 atically handle │ │ │ │ │ +0003dad0: 696e 7374 616c 6c61 7469 6f6e 2061 6e64 installation and │ │ │ │ │ +0003dae0: 0a64 6973 7472 6962 7574 696f 6e2e 0a0a .distribution... │ │ │ │ │ +0003daf0: 2a20 4d65 6e75 3a0a 0a2a 2053 6372 6970 * Menu:..* Scrip │ │ │ │ │ +0003db00: 7473 3a3a 2020 2020 2020 2020 2020 2020 ts:: │ │ │ │ │ +0003db10: 2020 2020 2020 2020 2045 7865 6375 7461 Executa │ │ │ │ │ +0003db20: 626c 6520 7363 7269 7074 730a 2a20 4865 ble scripts.* He │ │ │ │ │ +0003db30: 6164 6572 733a 3a20 2020 2020 2020 2020 aders:: │ │ │ │ │ +0003db40: 2020 2020 2020 2020 2020 2020 4865 6164 Head │ │ │ │ │ +0003db50: 6572 2066 696c 6573 0a2a 2044 6174 613a er files.* Data: │ │ │ │ │ +0003db60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003db70: 2020 2020 2020 2020 2041 7263 6869 7465 Archite │ │ │ │ │ +0003db80: 6374 7572 652d 696e 6465 7065 6e64 656e cture-independen │ │ │ │ │ +0003db90: 7420 6461 7461 2066 696c 6573 0a2a 2053 t data files.* S │ │ │ │ │ +0003dba0: 6f75 7263 6573 3a3a 2020 2020 2020 2020 ources:: │ │ │ │ │ +0003dbb0: 2020 2020 2020 2020 2020 2020 2044 6572 Der │ │ │ │ │ +0003dbc0: 6976 6564 2073 6f75 7263 6573 0a0a 1f0a ived sources.... │ │ │ │ │ +0003dbd0: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +0003dbe0: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +0003dbf0: 2053 6372 6970 7473 2c20 204e 6578 743a Scripts, Next: │ │ │ │ │ +0003dc00: 2048 6561 6465 7273 2c20 2055 703a 204f Headers, Up: O │ │ │ │ │ +0003dc10: 7468 6572 204f 626a 6563 7473 0a0a 392e ther Objects..9. │ │ │ │ │ +0003dc20: 3120 4578 6563 7574 6162 6c65 2053 6372 1 Executable Scr │ │ │ │ │ +0003dc30: 6970 7473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ipts.=========== │ │ │ │ │ +0003dc40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 7420 ===========..It │ │ │ │ │ +0003dc50: 6973 2070 6f73 7369 626c 6520 746f 2064 is possible to d │ │ │ │ │ +0003dc60: 6566 696e 6520 616e 6420 696e 7374 616c efine and instal │ │ │ │ │ +0003dc70: 6c20 7072 6f67 7261 6d73 2074 6861 7420 l programs that │ │ │ │ │ +0003dc80: 6172 6520 7363 7269 7074 732e 2020 5375 are scripts. Su │ │ │ │ │ +0003dc90: 6368 0a70 726f 6772 616d 7320 6172 6520 ch.programs are │ │ │ │ │ +0003dca0: 6c69 7374 6564 2075 7369 6e67 2074 6865 listed using the │ │ │ │ │ +0003dcb0: 2027 5343 5249 5054 5327 2070 7269 6d61 'SCRIPTS' prima │ │ │ │ │ +0003dcc0: 7279 206e 616d 652e 2020 5768 656e 2074 ry name. When t │ │ │ │ │ +0003dcd0: 6865 2073 6372 6970 740a 6973 2064 6973 he script.is dis │ │ │ │ │ +0003dce0: 7472 6962 7574 6564 2069 6e20 6974 7320 tributed in its │ │ │ │ │ +0003dcf0: 6669 6e61 6c2c 2069 6e73 7461 6c6c 6162 final, installab │ │ │ │ │ +0003dd00: 6c65 2066 6f72 6d2c 2074 6865 2027 4d61 le form, the 'Ma │ │ │ │ │ +0003dd10: 6b65 6669 6c65 2720 7573 7561 6c6c 790a kefile' usually. │ │ │ │ │ +0003dd20: 6c6f 6f6b 7320 6173 2066 6f6c 6c6f 7773 looks as follows │ │ │ │ │ +0003dd30: 3a0a 0a20 2020 2020 2320 496e 7374 616c :.. # Instal │ │ │ │ │ +0003dd40: 6c20 6d79 5f73 6372 6970 7420 696e 2024 l my_script in $ │ │ │ │ │ +0003dd50: 2862 696e 6469 7229 2061 6e64 2064 6973 (bindir) and dis │ │ │ │ │ +0003dd60: 7472 6962 7574 6520 6974 2e0a 2020 2020 tribute it.. │ │ │ │ │ +0003dd70: 2064 6973 745f 6269 6e5f 5343 5249 5054 dist_bin_SCRIPT │ │ │ │ │ +0003dd80: 5320 3d20 6d79 5f73 6372 6970 740a 0a20 S = my_script.. │ │ │ │ │ +0003dd90: 2020 5363 7269 7074 7320 6172 6520 6e6f Scripts are no │ │ │ │ │ +0003dda0: 7420 6469 7374 7269 6275 7465 6420 6279 t distributed by │ │ │ │ │ +0003ddb0: 2064 6566 6175 6c74 3b20 6173 2077 6520 default; as we │ │ │ │ │ +0003ddc0: 6861 7665 206a 7573 7420 7365 656e 2c20 have just seen, │ │ │ │ │ +0003ddd0: 7468 6f73 650a 7468 6174 2073 686f 756c those.that shoul │ │ │ │ │ +0003dde0: 6420 6265 2064 6973 7472 6962 7574 6564 d be distributed │ │ │ │ │ +0003ddf0: 2063 616e 2062 6520 7370 6563 6966 6965 can be specifie │ │ │ │ │ +0003de00: 6420 7573 696e 6720 6120 2764 6973 745f d using a 'dist_ │ │ │ │ │ +0003de10: 2720 7072 6566 6978 2061 730a 7769 7468 ' prefix as.with │ │ │ │ │ +0003de20: 206f 7468 6572 2070 7269 6d61 7269 6573 other primaries │ │ │ │ │ +0003de30: 2e0a 0a20 2020 5363 7269 7074 7320 6361 ... Scripts ca │ │ │ │ │ +0003de40: 6e20 6265 2069 6e73 7461 6c6c 6564 2069 n be installed i │ │ │ │ │ +0003de50: 6e20 2762 696e 6469 7227 2c20 2773 6269 n 'bindir', 'sbi │ │ │ │ │ +0003de60: 6e64 6972 272c 2027 6c69 6265 7865 6364 ndir', 'libexecd │ │ │ │ │ +0003de70: 6972 272c 0a27 706b 676c 6962 6578 6563 ir',.'pkglibexec │ │ │ │ │ +0003de80: 6469 7227 2c20 6f72 2027 706b 6764 6174 dir', or 'pkgdat │ │ │ │ │ +0003de90: 6164 6972 272e 0a0a 2020 2053 6372 6970 adir'... Scrip │ │ │ │ │ +0003dea0: 7473 2074 6861 7420 6e65 6564 206e 6f74 ts that need not │ │ │ │ │ +0003deb0: 2062 6520 696e 7374 616c 6c65 6420 6361 be installed ca │ │ │ │ │ +0003dec0: 6e20 6265 206c 6973 7465 6420 696e 2027 n be listed in ' │ │ │ │ │ +0003ded0: 6e6f 696e 7374 5f53 4352 4950 5453 272c noinst_SCRIPTS', │ │ │ │ │ +0003dee0: 0a61 6e64 2061 6d6f 6e67 2074 6865 6d2c .and among them, │ │ │ │ │ +0003def0: 2074 686f 7365 2077 6869 6368 2061 7265 those which are │ │ │ │ │ +0003df00: 206e 6565 6465 6420 6f6e 6c79 2062 7920 needed only by │ │ │ │ │ +0003df10: 276d 616b 6520 6368 6563 6b27 2073 686f 'make check' sho │ │ │ │ │ +0003df20: 756c 6420 676f 2069 6e0a 2763 6865 636b uld go in.'check │ │ │ │ │ +0003df30: 5f53 4352 4950 5453 272e 0a0a 2020 2057 _SCRIPTS'... W │ │ │ │ │ +0003df40: 6865 6e20 6120 7363 7269 7074 206e 6565 hen a script nee │ │ │ │ │ +0003df50: 6473 2074 6f20 6265 2062 7569 6c74 2c20 ds to be built, │ │ │ │ │ +0003df60: 7468 6520 274d 616b 6566 696c 652e 616d the 'Makefile.am │ │ │ │ │ +0003df70: 2720 7368 6f75 6c64 2069 6e63 6c75 6465 ' should include │ │ │ │ │ +0003df80: 2074 6865 0a61 7070 726f 7072 6961 7465 the.appropriate │ │ │ │ │ +0003df90: 2072 756c 6573 2e20 2046 6f72 2069 6e73 rules. For ins │ │ │ │ │ +0003dfa0: 7461 6e63 6520 7468 6520 2761 7574 6f6d tance the 'autom │ │ │ │ │ +0003dfb0: 616b 6527 2070 726f 6772 616d 2069 7473 ake' program its │ │ │ │ │ +0003dfc0: 656c 6620 6973 2061 2050 6572 6c0a 7363 elf is a Perl.sc │ │ │ │ │ +0003dfd0: 7269 7074 2074 6861 7420 6973 2067 656e ript that is gen │ │ │ │ │ +0003dfe0: 6572 6174 6564 2066 726f 6d20 2761 7574 erated from 'aut │ │ │ │ │ +0003dff0: 6f6d 616b 652e 696e 272e 2020 4865 7265 omake.in'. Here │ │ │ │ │ +0003e000: 2069 7320 686f 7720 7468 6973 2069 730a is how this is. │ │ │ │ │ +0003e010: 6861 6e64 6c65 643a 0a0a 2020 2020 2062 handled:.. b │ │ │ │ │ +0003e020: 696e 5f53 4352 4950 5453 203d 2061 7574 in_SCRIPTS = aut │ │ │ │ │ +0003e030: 6f6d 616b 650a 2020 2020 2043 4c45 414e omake. CLEAN │ │ │ │ │ +0003e040: 4649 4c45 5320 3d20 2428 6269 6e5f 5343 FILES = $(bin_SC │ │ │ │ │ +0003e050: 5249 5054 5329 0a20 2020 2020 4558 5452 RIPTS). EXTR │ │ │ │ │ +0003e060: 415f 4449 5354 203d 2061 7574 6f6d 616b A_DIST = automak │ │ │ │ │ +0003e070: 652e 696e 0a0a 2020 2020 2064 6f5f 7375 e.in.. do_su │ │ │ │ │ +0003e080: 6273 7420 3d20 7365 6420 2d65 2027 732c bst = sed -e 's, │ │ │ │ │ +0003e090: 5b40 5d64 6174 6164 6972 5b40 5d2c 2428 [@]datadir[@],$( │ │ │ │ │ +0003e0a0: 6461 7461 6469 7229 2c67 2720 5c0a 2020 datadir),g' \. │ │ │ │ │ +0003e0b0: 2020 2020 2020 2020 2020 2020 2020 202d - │ │ │ │ │ +0003e0c0: 6520 2773 2c5b 405d 5045 524c 5b40 5d2c e 's,[@]PERL[@], │ │ │ │ │ +0003e0d0: 2428 5045 524c 292c 6727 205c 0a20 2020 $(PERL),g' \. │ │ │ │ │ +0003e0e0: 2020 2020 2020 2020 2020 2020 2020 2d65 -e │ │ │ │ │ +0003e0f0: 2027 732c 5b40 5d50 4143 4b41 4745 5b40 's,[@]PACKAGE[@ │ │ │ │ │ +0003e100: 5d2c 2428 5041 434b 4147 4529 2c67 2720 ],$(PACKAGE),g' │ │ │ │ │ +0003e110: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0003e120: 2020 202d 6520 2773 2c5b 405d 5645 5253 -e 's,[@]VERS │ │ │ │ │ +0003e130: 494f 4e5b 405d 2c24 2856 4552 5349 4f4e ION[@],$(VERSION │ │ │ │ │ +0003e140: 292c 6727 205c 0a20 2020 2020 2020 2020 ),g' \. │ │ │ │ │ +0003e150: 2020 2020 2020 2020 2e2e 2e0a 0a20 2020 ..... │ │ │ │ │ +0003e160: 2020 6175 746f 6d61 6b65 3a20 6175 746f automake: auto │ │ │ │ │ +0003e170: 6d61 6b65 2e69 6e20 4d61 6b65 6669 6c65 make.in Makefile │ │ │ │ │ +0003e180: 0a20 2020 2020 2020 2020 2020 2020 2428 . $( │ │ │ │ │ +0003e190: 646f 5f73 7562 7374 2920 3c20 2428 7372 do_subst) < $(sr │ │ │ │ │ +0003e1a0: 6364 6972 292f 6175 746f 6d61 6b65 2e69 cdir)/automake.i │ │ │ │ │ +0003e1b0: 6e20 3e20 6175 746f 6d61 6b65 0a20 2020 n > automake. │ │ │ │ │ +0003e1c0: 2020 2020 2020 2020 2020 6368 6d6f 6420 chmod │ │ │ │ │ +0003e1d0: 2b78 2061 7574 6f6d 616b 650a 0a20 2020 +x automake.. │ │ │ │ │ +0003e1e0: 5375 6368 2073 6372 6970 7473 2066 6f72 Such scripts for │ │ │ │ │ +0003e1f0: 2077 6869 6368 2061 2062 7569 6c64 2072 which a build r │ │ │ │ │ +0003e200: 756c 6520 6861 7320 6265 656e 2073 7570 ule has been sup │ │ │ │ │ +0003e210: 706c 6965 6420 6e65 6564 2074 6f20 6265 plied need to be │ │ │ │ │ +0003e220: 0a64 656c 6574 6564 2065 7870 6c69 6369 .deleted explici │ │ │ │ │ +0003e230: 746c 7920 7573 696e 6720 2743 4c45 414e tly using 'CLEAN │ │ │ │ │ +0003e240: 4649 4c45 5327 2028 2a6e 6f74 6520 436c FILES' (*note Cl │ │ │ │ │ +0003e250: 6561 6e3a 3a29 2c20 616e 6420 7468 6569 ean::), and thei │ │ │ │ │ +0003e260: 7220 736f 7572 6365 730a 6861 7665 2074 r sources.have t │ │ │ │ │ +0003e270: 6f20 6265 2064 6973 7472 6962 7574 6564 o be distributed │ │ │ │ │ +0003e280: 2c20 7573 7561 6c6c 7920 7769 7468 2027 , usually with ' │ │ │ │ │ +0003e290: 4558 5452 415f 4449 5354 2720 282a 6e6f EXTRA_DIST' (*no │ │ │ │ │ +0003e2a0: 7465 2042 6173 6963 7320 6f66 0a44 6973 te Basics of.Dis │ │ │ │ │ +0003e2b0: 7472 6962 7574 696f 6e3a 3a29 2e0a 0a20 tribution::)... │ │ │ │ │ +0003e2c0: 2020 416e 6f74 6865 7220 636f 6d6d 6f6e Another common │ │ │ │ │ +0003e2d0: 2077 6179 2074 6f20 6275 696c 6420 7363 way to build sc │ │ │ │ │ +0003e2e0: 7269 7074 7320 6973 2074 6f20 7072 6f63 ripts is to proc │ │ │ │ │ +0003e2f0: 6573 7320 7468 656d 2066 726f 6d0a 2763 ess them from.'c │ │ │ │ │ +0003e300: 6f6e 6669 6775 7265 2720 7769 7468 2027 onfigure' with ' │ │ │ │ │ +0003e310: 4143 5f43 4f4e 4649 475f 4649 4c45 5327 AC_CONFIG_FILES' │ │ │ │ │ +0003e320: 2e20 2049 6e20 7468 6973 2073 6974 7561 . In this situa │ │ │ │ │ +0003e330: 7469 6f6e 2041 7574 6f6d 616b 6520 6b6e tion Automake kn │ │ │ │ │ +0003e340: 6f77 730a 7768 6963 6820 6669 6c65 7320 ows.which files │ │ │ │ │ +0003e350: 7368 6f75 6c64 2062 6520 636c 6561 6e65 should be cleane │ │ │ │ │ +0003e360: 6420 616e 6420 6469 7374 7269 6275 7465 d and distribute │ │ │ │ │ +0003e370: 642c 2061 6e64 2077 6861 7420 7468 6520 d, and what the │ │ │ │ │ +0003e380: 7265 6275 696c 640a 7275 6c65 7320 7368 rebuild.rules sh │ │ │ │ │ +0003e390: 6f75 6c64 206c 6f6f 6b20 6c69 6b65 2e0a ould look like.. │ │ │ │ │ +0003e3a0: 0a20 2020 466f 7220 696e 7374 616e 6365 . For instance │ │ │ │ │ +0003e3b0: 2069 6620 2763 6f6e 6669 6775 7265 2e61 if 'configure.a │ │ │ │ │ +0003e3c0: 6327 2063 6f6e 7461 696e 730a 0a20 2020 c' contains.. │ │ │ │ │ +0003e3d0: 2020 4143 5f43 4f4e 4649 475f 4649 4c45 AC_CONFIG_FILE │ │ │ │ │ +0003e3e0: 5328 5b73 7263 2f6d 795f 7363 7269 7074 S([src/my_script │ │ │ │ │ +0003e3f0: 5d2c 205b 6368 6d6f 6420 2b78 2073 7263 ], [chmod +x src │ │ │ │ │ +0003e400: 2f6d 795f 7363 7269 7074 5d29 0a0a 746f /my_script])..to │ │ │ │ │ +0003e410: 2062 7569 6c64 2027 7372 632f 6d79 5f73 build 'src/my_s │ │ │ │ │ +0003e420: 6372 6970 7427 2066 726f 6d20 2773 7263 cript' from 'src │ │ │ │ │ +0003e430: 2f6d 795f 7363 7269 7074 2e69 6e27 2c20 /my_script.in', │ │ │ │ │ +0003e440: 7468 656e 2061 0a27 7372 632f 4d61 6b65 then a.'src/Make │ │ │ │ │ +0003e450: 6669 6c65 2e61 6d27 2074 6f20 696e 7374 file.am' to inst │ │ │ │ │ +0003e460: 616c 6c20 7468 6973 2073 6372 6970 7420 all this script │ │ │ │ │ +0003e470: 696e 2027 2428 6269 6e64 6972 2927 2063 in '$(bindir)' c │ │ │ │ │ +0003e480: 616e 2062 6520 6173 2073 696d 706c 650a an be as simple. │ │ │ │ │ +0003e490: 6173 0a0a 2020 2020 2062 696e 5f53 4352 as.. bin_SCR │ │ │ │ │ +0003e4a0: 4950 5453 203d 206d 795f 7363 7269 7074 IPTS = my_script │ │ │ │ │ +0003e4b0: 0a20 2020 2020 434c 4541 4e46 494c 4553 . CLEANFILES │ │ │ │ │ +0003e4c0: 203d 2024 2862 696e 5f53 4352 4950 5453 = $(bin_SCRIPTS │ │ │ │ │ +0003e4d0: 290a 0a54 6865 7265 2069 7320 6e6f 206e )..There is no n │ │ │ │ │ +0003e4e0: 6565 6420 666f 7220 2745 5854 5241 5f44 eed for 'EXTRA_D │ │ │ │ │ +0003e4f0: 4953 5427 206f 7220 616e 7920 6275 696c IST' or any buil │ │ │ │ │ +0003e500: 6420 7275 6c65 3a20 4175 746f 6d61 6b65 d rule: Automake │ │ │ │ │ +0003e510: 2069 6e66 6572 730a 7468 656d 2066 726f infers.them fro │ │ │ │ │ +0003e520: 6d20 2741 435f 434f 4e46 4947 5f46 494c m 'AC_CONFIG_FIL │ │ │ │ │ +0003e530: 4553 2720 282a 6e6f 7465 2052 6571 7569 ES' (*note Requi │ │ │ │ │ +0003e540: 7265 6d65 6e74 733a 3a29 2e20 2027 434c rements::). 'CL │ │ │ │ │ +0003e550: 4541 4e46 494c 4553 2720 6973 0a73 7469 EANFILES' is.sti │ │ │ │ │ +0003e560: 6c6c 2075 7365 6675 6c2c 2062 6563 6175 ll useful, becau │ │ │ │ │ +0003e570: 7365 2062 7920 6465 6661 756c 7420 4175 se by default Au │ │ │ │ │ +0003e580: 746f 6d61 6b65 2077 696c 6c20 636c 6561 tomake will clea │ │ │ │ │ +0003e590: 6e20 7461 7267 6574 7320 6f66 0a27 4143 n targets of.'AC │ │ │ │ │ +0003e5a0: 5f43 4f4e 4649 475f 4649 4c45 5327 2069 _CONFIG_FILES' i │ │ │ │ │ +0003e5b0: 6e20 2764 6973 7463 6c65 616e 272c 206e n 'distclean', n │ │ │ │ │ +0003e5c0: 6f74 2027 636c 6561 6e27 2e0a 0a20 2020 ot 'clean'... │ │ │ │ │ +0003e5d0: 416c 7468 6f75 6768 2074 6869 7320 6c6f Although this lo │ │ │ │ │ +0003e5e0: 6f6b 7320 7369 6d70 6c65 722c 2062 7569 oks simpler, bui │ │ │ │ │ +0003e5f0: 6c64 696e 6720 7363 7269 7074 7320 7468 lding scripts th │ │ │ │ │ +0003e600: 6973 2077 6179 2068 6173 206f 6e65 0a64 is way has one.d │ │ │ │ │ +0003e610: 7261 7762 6163 6b3a 2064 6972 6563 746f rawback: directo │ │ │ │ │ +0003e620: 7279 2076 6172 6961 626c 6573 2073 7563 ry variables suc │ │ │ │ │ +0003e630: 6820 6173 2027 2428 6461 7461 6469 7229 h as '$(datadir) │ │ │ │ │ +0003e640: 2720 6172 6520 6e6f 7420 6675 6c6c 790a ' are not fully. │ │ │ │ │ +0003e650: 6578 7061 6e64 6564 2061 6e64 206d 6179 expanded and may │ │ │ │ │ +0003e660: 2072 6566 6572 2074 6f20 6f74 6865 7220 refer to other │ │ │ │ │ +0003e670: 6469 7265 6374 6f72 7920 7661 7269 6162 directory variab │ │ │ │ │ +0003e680: 6c65 732e 0a0a 1f0a 4669 6c65 3a20 6175 les.....File: au │ │ │ │ │ +0003e690: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +0003e6a0: 2c20 204e 6f64 653a 2048 6561 6465 7273 , Node: Headers │ │ │ │ │ +0003e6b0: 2c20 204e 6578 743a 2044 6174 612c 2020 , Next: Data, │ │ │ │ │ +0003e6c0: 5072 6576 3a20 5363 7269 7074 732c 2020 Prev: Scripts, │ │ │ │ │ +0003e6d0: 5570 3a20 4f74 6865 7220 4f62 6a65 6374 Up: Other Object │ │ │ │ │ +0003e6e0: 730a 0a39 2e32 2048 6561 6465 7220 6669 s..9.2 Header fi │ │ │ │ │ +0003e6f0: 6c65 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d les.============ │ │ │ │ │ +0003e700: 3d3d 3d3d 0a0a 4865 6164 6572 2066 696c ====..Header fil │ │ │ │ │ +0003e710: 6573 2074 6861 7420 6d75 7374 2062 6520 es that must be │ │ │ │ │ +0003e720: 696e 7374 616c 6c65 6420 6172 6520 7370 installed are sp │ │ │ │ │ +0003e730: 6563 6966 6965 6420 6279 2074 6865 2027 ecified by the ' │ │ │ │ │ +0003e740: 4845 4144 4552 5327 0a66 616d 696c 7920 HEADERS'.family │ │ │ │ │ +0003e750: 6f66 2076 6172 6961 626c 6573 2e20 2048 of variables. H │ │ │ │ │ +0003e760: 6561 6465 7273 2063 616e 2062 6520 696e eaders can be in │ │ │ │ │ +0003e770: 7374 616c 6c65 6420 696e 2027 696e 636c stalled in 'incl │ │ │ │ │ +0003e780: 7564 6564 6972 272c 0a27 6f6c 6469 6e63 udedir',.'oldinc │ │ │ │ │ +0003e790: 6c75 6465 6469 7227 2c20 2770 6b67 696e ludedir', 'pkgin │ │ │ │ │ +0003e7a0: 636c 7564 6564 6972 2720 6f72 2061 6e79 cludedir' or any │ │ │ │ │ +0003e7b0: 206f 7468 6572 2064 6972 6563 746f 7279 other directory │ │ │ │ │ +0003e7c0: 2079 6f75 206d 6179 2068 6176 650a 6465 you may have.de │ │ │ │ │ +0003e7d0: 6669 6e65 6420 282a 6e6f 7465 2055 6e69 fined (*note Uni │ │ │ │ │ +0003e7e0: 666f 726d 3a3a 292e 2020 466f 7220 696e form::). For in │ │ │ │ │ +0003e7f0: 7374 616e 6365 2c0a 0a20 2020 2020 696e stance,.. in │ │ │ │ │ +0003e800: 636c 7564 655f 4845 4144 4552 5320 3d20 clude_HEADERS = │ │ │ │ │ +0003e810: 666f 6f2e 6820 6261 722f 6261 722e 680a foo.h bar/bar.h. │ │ │ │ │ +0003e820: 0a77 696c 6c20 696e 7374 616c 6c20 7468 .will install th │ │ │ │ │ +0003e830: 6520 7477 6f20 6669 6c65 7320 6173 2027 e two files as ' │ │ │ │ │ +0003e840: 2428 696e 636c 7564 6564 6972 292f 666f $(includedir)/fo │ │ │ │ │ +0003e850: 6f2e 6827 2061 6e64 0a27 2428 696e 636c o.h' and.'$(incl │ │ │ │ │ +0003e860: 7564 6564 6972 292f 6261 722e 6827 2e0a udedir)/bar.h'.. │ │ │ │ │ +0003e870: 0a20 2020 5468 6520 276e 6f62 6173 655f . The 'nobase_ │ │ │ │ │ +0003e880: 2720 7072 6566 6978 2069 7320 616c 736f ' prefix is also │ │ │ │ │ +0003e890: 2073 7570 706f 7274 6564 2c0a 0a20 2020 supported,.. │ │ │ │ │ +0003e8a0: 2020 6e6f 6261 7365 5f69 6e63 6c75 6465 nobase_include │ │ │ │ │ +0003e8b0: 5f48 4541 4445 5253 203d 2066 6f6f 2e68 _HEADERS = foo.h │ │ │ │ │ +0003e8c0: 2062 6172 2f62 6172 2e68 0a0a 7769 6c6c bar/bar.h..will │ │ │ │ │ +0003e8d0: 2069 6e73 7461 6c6c 2074 6865 2074 776f install the two │ │ │ │ │ +0003e8e0: 2066 696c 6573 2061 7320 2724 2869 6e63 files as '$(inc │ │ │ │ │ +0003e8f0: 6c75 6465 6469 7229 2f66 6f6f 2e68 2720 ludedir)/foo.h' │ │ │ │ │ +0003e900: 616e 640a 2724 2869 6e63 6c75 6465 6469 and.'$(includedi │ │ │ │ │ +0003e910: 7229 2f62 6172 2f62 6172 2e68 2720 282a r)/bar/bar.h' (* │ │ │ │ │ +0003e920: 6e6f 7465 2041 6c74 6572 6e61 7469 7665 note Alternative │ │ │ │ │ +0003e930: 3a3a 292e 0a0a 2020 2055 7375 616c 6c79 ::)... Usually │ │ │ │ │ +0003e940: 2c20 6f6e 6c79 2068 6561 6465 7220 6669 , only header fi │ │ │ │ │ +0003e950: 6c65 7320 7468 6174 2061 6363 6f6d 7061 les that accompa │ │ │ │ │ +0003e960: 6e79 2069 6e73 7461 6c6c 6564 206c 6962 ny installed lib │ │ │ │ │ +0003e970: 7261 7269 6573 206e 6565 6420 746f 0a62 raries need to.b │ │ │ │ │ +0003e980: 6520 696e 7374 616c 6c65 642e 2020 4865 e installed. He │ │ │ │ │ +0003e990: 6164 6572 7320 7573 6564 2062 7920 7072 aders used by pr │ │ │ │ │ +0003e9a0: 6f67 7261 6d73 206f 7220 636f 6e76 656e ograms or conven │ │ │ │ │ +0003e9b0: 6965 6e63 6520 6c69 6272 6172 6965 7320 ience libraries │ │ │ │ │ +0003e9c0: 6172 6520 6e6f 740a 696e 7374 616c 6c65 are not.installe │ │ │ │ │ +0003e9d0: 642e 2020 5468 6520 276e 6f69 6e73 745f d. The 'noinst_ │ │ │ │ │ +0003e9e0: 4845 4144 4552 5327 2076 6172 6961 626c HEADERS' variabl │ │ │ │ │ +0003e9f0: 6520 6361 6e20 6265 2075 7365 6420 666f e can be used fo │ │ │ │ │ +0003ea00: 7220 7375 6368 2068 6561 6465 7273 2e0a r such headers.. │ │ │ │ │ +0003ea10: 486f 7765 7665 7220 7768 656e 2074 6865 However when the │ │ │ │ │ +0003ea20: 2068 6561 6465 7220 6163 7475 616c 6c79 header actually │ │ │ │ │ +0003ea30: 2062 656c 6f6e 6773 2074 6f20 6120 7369 belongs to a si │ │ │ │ │ +0003ea40: 6e67 6c65 2063 6f6e 7665 6e69 656e 6365 ngle convenience │ │ │ │ │ +0003ea50: 206c 6962 7261 7279 0a6f 7220 7072 6f67 library.or prog │ │ │ │ │ +0003ea60: 7261 6d2c 2077 6520 7265 636f 6d6d 656e ram, we recommen │ │ │ │ │ +0003ea70: 6420 6c69 7374 696e 6720 6974 2069 6e20 d listing it in │ │ │ │ │ +0003ea80: 7468 6520 7072 6f67 7261 6d27 7320 6f72 the program's or │ │ │ │ │ +0003ea90: 206c 6962 7261 7279 2773 0a27 5f53 4f55 library's.'_SOU │ │ │ │ │ +0003eaa0: 5243 4553 2720 7661 7269 6162 6c65 2028 RCES' variable ( │ │ │ │ │ +0003eab0: 2a6e 6f74 6520 5072 6f67 7261 6d20 536f *note Program So │ │ │ │ │ +0003eac0: 7572 6365 733a 3a29 2069 6e73 7465 6164 urces::) instead │ │ │ │ │ +0003ead0: 206f 6620 696e 0a27 6e6f 696e 7374 5f48 of in.'noinst_H │ │ │ │ │ +0003eae0: 4541 4445 5253 272e 2020 5468 6973 2069 EADERS'. This i │ │ │ │ │ +0003eaf0: 7320 636c 6561 7265 7220 666f 7220 7468 s clearer for th │ │ │ │ │ +0003eb00: 6520 274d 616b 6566 696c 652e 616d 2720 e 'Makefile.am' │ │ │ │ │ +0003eb10: 7265 6164 6572 2e0a 276e 6f69 6e73 745f reader..'noinst_ │ │ │ │ │ +0003eb20: 4845 4144 4552 5327 2077 6f75 6c64 2062 HEADERS' would b │ │ │ │ │ +0003eb30: 6520 7468 6520 7269 6768 7420 7661 7269 e the right vari │ │ │ │ │ +0003eb40: 6162 6c65 2074 6f20 7573 6520 696e 2061 able to use in a │ │ │ │ │ +0003eb50: 2064 6972 6563 746f 7279 0a63 6f6e 7461 directory.conta │ │ │ │ │ +0003eb60: 696e 696e 6720 6f6e 6c79 2068 6561 6465 ining only heade │ │ │ │ │ +0003eb70: 7273 2061 6e64 206e 6f20 6173 736f 6369 rs and no associ │ │ │ │ │ +0003eb80: 6174 6564 206c 6962 7261 7279 206f 7220 ated library or │ │ │ │ │ +0003eb90: 7072 6f67 7261 6d2e 0a0a 2020 2041 6c6c program... All │ │ │ │ │ +0003eba0: 2068 6561 6465 7220 6669 6c65 7320 6d75 header files mu │ │ │ │ │ +0003ebb0: 7374 2062 6520 6c69 7374 6564 2073 6f6d st be listed som │ │ │ │ │ +0003ebc0: 6577 6865 7265 3b20 696e 2061 2027 5f53 ewhere; in a '_S │ │ │ │ │ +0003ebd0: 4f55 5243 4553 2720 7661 7269 6162 6c65 OURCES' variable │ │ │ │ │ +0003ebe0: 0a6f 7220 696e 2061 2027 5f48 4541 4445 .or in a '_HEADE │ │ │ │ │ +0003ebf0: 5253 2720 7661 7269 6162 6c65 2e20 204d RS' variable. M │ │ │ │ │ +0003ec00: 6973 7369 6e67 206f 6e65 7320 7769 6c6c issing ones will │ │ │ │ │ +0003ec10: 206e 6f74 2061 7070 6561 7220 696e 2074 not appear in t │ │ │ │ │ +0003ec20: 6865 0a64 6973 7472 6962 7574 696f 6e2e he.distribution. │ │ │ │ │ +0003ec30: 0a0a 2020 2046 6f72 2068 6561 6465 7220 .. For header │ │ │ │ │ +0003ec40: 6669 6c65 7320 7468 6174 2061 7265 2062 files that are b │ │ │ │ │ +0003ec50: 7569 6c74 2061 6e64 206d 7573 7420 6e6f uilt and must no │ │ │ │ │ +0003ec60: 7420 6265 2064 6973 7472 6962 7574 6564 t be distributed │ │ │ │ │ +0003ec70: 2c20 7573 6520 7468 650a 276e 6f64 6973 , use the.'nodis │ │ │ │ │ +0003ec80: 745f 2720 7072 6566 6978 2061 7320 696e t_' prefix as in │ │ │ │ │ +0003ec90: 2027 6e6f 6469 7374 5f69 6e63 6c75 6465 'nodist_include │ │ │ │ │ +0003eca0: 5f48 4541 4445 5253 2720 6f72 0a27 6e6f _HEADERS' or.'no │ │ │ │ │ +0003ecb0: 6469 7374 5f70 726f 675f 534f 5552 4345 dist_prog_SOURCE │ │ │ │ │ +0003ecc0: 5327 2e20 2049 6620 7468 6573 6520 6765 S'. If these ge │ │ │ │ │ +0003ecd0: 6e65 7261 7465 6420 6865 6164 6572 7320 nerated headers │ │ │ │ │ +0003ece0: 6172 6520 6e65 6564 6564 2064 7572 696e are needed durin │ │ │ │ │ +0003ecf0: 6720 7468 650a 6275 696c 642c 2079 6f75 g the.build, you │ │ │ │ │ +0003ed00: 206d 7573 7420 616c 736f 2065 6e73 7572 must also ensur │ │ │ │ │ +0003ed10: 6520 7468 6579 2065 7869 7374 2062 6566 e they exist bef │ │ │ │ │ +0003ed20: 6f72 6520 7468 6579 2061 7265 2075 7365 ore they are use │ │ │ │ │ +0003ed30: 6420 282a 6e6f 7465 0a53 6f75 7263 6573 d (*note.Sources │ │ │ │ │ +0003ed40: 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 6175 ::).....File: au │ │ │ │ │ +0003ed50: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +0003ed60: 2c20 204e 6f64 653a 2044 6174 612c 2020 , Node: Data, │ │ │ │ │ +0003ed70: 4e65 7874 3a20 536f 7572 6365 732c 2020 Next: Sources, │ │ │ │ │ +0003ed80: 5072 6576 3a20 4865 6164 6572 732c 2020 Prev: Headers, │ │ │ │ │ +0003ed90: 5570 3a20 4f74 6865 7220 4f62 6a65 6374 Up: Other Object │ │ │ │ │ +0003eda0: 730a 0a39 2e33 2041 7263 6869 7465 6374 s..9.3 Architect │ │ │ │ │ +0003edb0: 7572 652d 696e 6465 7065 6e64 656e 7420 ure-independent │ │ │ │ │ +0003edc0: 6461 7461 2066 696c 6573 0a3d 3d3d 3d3d data files.===== │ │ │ │ │ 0003edd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003ede0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003edf0: 0a0a 4175 746f 6d61 6b65 2073 7570 706f ..Automake suppo │ │ │ │ │ -0003ee00: 7274 7320 7468 6520 696e 7374 616c 6c61 rts the installa │ │ │ │ │ -0003ee10: 7469 6f6e 206f 6620 6d69 7363 656c 6c61 tion of miscella │ │ │ │ │ -0003ee20: 6e65 6f75 7320 6461 7461 2066 696c 6573 neous data files │ │ │ │ │ -0003ee30: 2075 7369 6e67 2074 6865 0a27 4441 5441 using the.'DATA │ │ │ │ │ -0003ee40: 2720 6661 6d69 6c79 206f 6620 7661 7269 ' family of vari │ │ │ │ │ -0003ee50: 6162 6c65 732e 0a0a 2020 2053 7563 6820 ables... Such │ │ │ │ │ -0003ee60: 6461 7461 2063 616e 2062 6520 696e 7374 data can be inst │ │ │ │ │ -0003ee70: 616c 6c65 6420 696e 2074 6865 2064 6972 alled in the dir │ │ │ │ │ -0003ee80: 6563 746f 7269 6573 2027 6461 7461 6469 ectories 'datadi │ │ │ │ │ -0003ee90: 7227 2c0a 2773 7973 636f 6e66 6469 7227 r',.'sysconfdir' │ │ │ │ │ -0003eea0: 2c20 2773 6861 7265 6473 7461 7465 6469 , 'sharedstatedi │ │ │ │ │ -0003eeb0: 7227 2c20 276c 6f63 616c 7374 6174 6564 r', 'localstated │ │ │ │ │ -0003eec0: 6972 272c 206f 7220 2770 6b67 6461 7461 ir', or 'pkgdata │ │ │ │ │ -0003eed0: 6469 7227 2e0a 0a20 2020 4279 2064 6566 dir'... By def │ │ │ │ │ -0003eee0: 6175 6c74 2c20 6461 7461 2066 696c 6573 ault, data files │ │ │ │ │ -0003eef0: 2061 7265 205f 6e6f 745f 2069 6e63 6c75 are _not_ inclu │ │ │ │ │ -0003ef00: 6465 6420 696e 2061 2064 6973 7472 6962 ded in a distrib │ │ │ │ │ -0003ef10: 7574 696f 6e2e 2020 4f66 0a63 6f75 7273 ution. Of.cours │ │ │ │ │ -0003ef20: 652c 2079 6f75 2063 616e 2075 7365 2074 e, you can use t │ │ │ │ │ -0003ef30: 6865 2027 6469 7374 5f27 2070 7265 6669 he 'dist_' prefi │ │ │ │ │ -0003ef40: 7820 746f 2063 6861 6e67 6520 7468 6973 x to change this │ │ │ │ │ -0003ef50: 206f 6e20 6120 7065 722d 7661 7269 6162 on a per-variab │ │ │ │ │ -0003ef60: 6c65 0a62 6173 6973 2e0a 0a20 2020 4865 le.basis... He │ │ │ │ │ -0003ef70: 7265 2069 7320 686f 7720 4175 746f 6d61 re is how Automa │ │ │ │ │ -0003ef80: 6b65 2064 6563 6c61 7265 7320 6974 7320 ke declares its │ │ │ │ │ -0003ef90: 6175 7869 6c69 6172 7920 6461 7461 2066 auxiliary data f │ │ │ │ │ -0003efa0: 696c 6573 3a0a 0a20 2020 2020 6469 7374 iles:.. dist │ │ │ │ │ -0003efb0: 5f70 6b67 6461 7461 5f44 4154 4120 3d20 _pkgdata_DATA = │ │ │ │ │ -0003efc0: 636c 6561 6e2d 6b72 2e61 6d20 636c 6561 clean-kr.am clea │ │ │ │ │ -0003efd0: 6e2e 616d 202e 2e2e 0a0a 1f0a 4669 6c65 n.am .......File │ │ │ │ │ -0003efe0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -0003eff0: 696e 666f 2c20 204e 6f64 653a 2053 6f75 info, Node: Sou │ │ │ │ │ -0003f000: 7263 6573 2c20 2050 7265 763a 2044 6174 rces, Prev: Dat │ │ │ │ │ -0003f010: 612c 2020 5570 3a20 4f74 6865 7220 4f62 a, Up: Other Ob │ │ │ │ │ -0003f020: 6a65 6374 730a 0a39 2e34 2042 7569 6c74 jects..9.4 Built │ │ │ │ │ -0003f030: 2053 6f75 7263 6573 0a3d 3d3d 3d3d 3d3d Sources.======= │ │ │ │ │ -0003f040: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4265 6361 ==========..Beca │ │ │ │ │ -0003f050: 7573 6520 4175 746f 6d61 6b65 2773 2061 use Automake's a │ │ │ │ │ -0003f060: 7574 6f6d 6174 6963 2064 6570 656e 6465 utomatic depende │ │ │ │ │ -0003f070: 6e63 7920 7472 6163 6b69 6e67 2077 6f72 ncy tracking wor │ │ │ │ │ -0003f080: 6b73 2061 7320 6120 7369 6465 2d65 6666 ks as a side-eff │ │ │ │ │ -0003f090: 6563 740a 6f66 2063 6f6d 7069 6c61 7469 ect.of compilati │ │ │ │ │ -0003f0a0: 6f6e 2028 2a6e 6f74 6520 4465 7065 6e64 on (*note Depend │ │ │ │ │ -0003f0b0: 656e 6369 6573 3a3a 2920 7468 6572 6520 encies::) there │ │ │ │ │ -0003f0c0: 6973 2061 2062 6f6f 7473 7472 6170 2069 is a bootstrap i │ │ │ │ │ -0003f0d0: 7373 7565 3a20 610a 7461 7267 6574 2073 ssue: a.target s │ │ │ │ │ -0003f0e0: 686f 756c 6420 6e6f 7420 6265 2063 6f6d hould not be com │ │ │ │ │ -0003f0f0: 7069 6c65 6420 6265 666f 7265 2069 7473 piled before its │ │ │ │ │ -0003f100: 2064 6570 656e 6465 6e63 6965 7320 6172 dependencies ar │ │ │ │ │ -0003f110: 6520 6d61 6465 2c20 6275 740a 7468 6573 e made, but.thes │ │ │ │ │ -0003f120: 6520 6465 7065 6e64 656e 6369 6573 2061 e dependencies a │ │ │ │ │ -0003f130: 7265 2075 6e6b 6e6f 776e 2075 6e74 696c re unknown until │ │ │ │ │ -0003f140: 2074 6865 2074 6172 6765 7420 6973 2066 the target is f │ │ │ │ │ -0003f150: 6972 7374 2063 6f6d 7069 6c65 642e 0a0a irst compiled... │ │ │ │ │ -0003f160: 2020 204f 7264 696e 6172 696c 7920 7468 Ordinarily th │ │ │ │ │ -0003f170: 6973 2069 7320 6e6f 7420 6120 7072 6f62 is is not a prob │ │ │ │ │ -0003f180: 6c65 6d2c 2062 6563 6175 7365 2064 6570 lem, because dep │ │ │ │ │ -0003f190: 656e 6465 6e63 6965 7320 6172 650a 6469 endencies are.di │ │ │ │ │ -0003f1a0: 7374 7269 6275 7465 6420 736f 7572 6365 stributed source │ │ │ │ │ -0003f1b0: 733a 2074 6865 7920 7072 6565 7869 7374 s: they preexist │ │ │ │ │ -0003f1c0: 2061 6e64 2064 6f20 6e6f 7420 6e65 6564 and do not need │ │ │ │ │ -0003f1d0: 2074 6f20 6265 2062 7569 6c74 2e20 2053 to be built. S │ │ │ │ │ -0003f1e0: 7570 706f 7365 0a74 6861 7420 2766 6f6f uppose.that 'foo │ │ │ │ │ -0003f1f0: 2e63 2720 696e 636c 7564 6573 2027 666f .c' includes 'fo │ │ │ │ │ -0003f200: 6f2e 6827 2e20 2057 6865 6e20 6974 2066 o.h'. When it f │ │ │ │ │ -0003f210: 6972 7374 2063 6f6d 7069 6c65 7320 2766 irst compiles 'f │ │ │ │ │ -0003f220: 6f6f 2e6f 272c 2027 6d61 6b65 270a 6f6e oo.o', 'make'.on │ │ │ │ │ -0003f230: 6c79 206b 6e6f 7773 2074 6861 7420 2766 ly knows that 'f │ │ │ │ │ -0003f240: 6f6f 2e6f 2720 6465 7065 6e64 7320 6f6e oo.o' depends on │ │ │ │ │ -0003f250: 2027 666f 6f2e 6327 2e20 2041 7320 6120 'foo.c'. As a │ │ │ │ │ -0003f260: 7369 6465 2d65 6666 6563 7420 6f66 2074 side-effect of t │ │ │ │ │ -0003f270: 6869 730a 636f 6d70 696c 6174 696f 6e20 his.compilation │ │ │ │ │ -0003f280: 2764 6570 636f 6d70 2720 7265 636f 7264 'depcomp' record │ │ │ │ │ -0003f290: 7320 7468 6520 2766 6f6f 2e68 2720 6465 s the 'foo.h' de │ │ │ │ │ -0003f2a0: 7065 6e64 656e 6379 2073 6f20 7468 6174 pendency so that │ │ │ │ │ -0003f2b0: 2066 6f6c 6c6f 7769 6e67 0a69 6e76 6f63 following.invoc │ │ │ │ │ -0003f2c0: 6174 696f 6e73 206f 6620 276d 616b 6527 ations of 'make' │ │ │ │ │ -0003f2d0: 2077 696c 6c20 686f 6e6f 7220 6974 2e20 will honor it. │ │ │ │ │ -0003f2e0: 2049 6e20 7468 6573 6520 636f 6e64 6974 In these condit │ │ │ │ │ -0003f2f0: 696f 6e73 2c20 6974 2773 2063 6c65 6172 ions, it's clear │ │ │ │ │ -0003f300: 0a74 6865 7265 2069 7320 6e6f 2070 726f .there is no pro │ │ │ │ │ -0003f310: 626c 656d 3a20 6569 7468 6572 2027 666f blem: either 'fo │ │ │ │ │ -0003f320: 6f2e 6f27 2064 6f65 736e 2774 2065 7869 o.o' doesn't exi │ │ │ │ │ -0003f330: 7374 2061 6e64 2068 6173 2074 6f20 6265 st and has to be │ │ │ │ │ -0003f340: 2062 7569 6c74 0a28 7265 6761 7264 6c65 built.(regardle │ │ │ │ │ -0003f350: 7373 206f 6620 7468 6520 6465 7065 6e64 ss of the depend │ │ │ │ │ -0003f360: 656e 6369 6573 292c 206f 7220 6163 6375 encies), or accu │ │ │ │ │ -0003f370: 7261 7465 2064 6570 656e 6465 6e63 6965 rate dependencie │ │ │ │ │ -0003f380: 7320 6578 6973 7420 616e 640a 7468 6579 s exist and.they │ │ │ │ │ -0003f390: 2063 616e 2062 6520 7573 6564 2074 6f20 can be used to │ │ │ │ │ -0003f3a0: 6465 6369 6465 2077 6865 7468 6572 2027 decide whether ' │ │ │ │ │ -0003f3b0: 666f 6f2e 6f27 2073 686f 756c 6420 6265 foo.o' should be │ │ │ │ │ -0003f3c0: 2072 6562 7569 6c74 2e0a 0a20 2020 4974 rebuilt... It │ │ │ │ │ -0003f3d0: 2773 2061 2064 6966 6665 7265 6e74 2073 's a different s │ │ │ │ │ -0003f3e0: 746f 7279 2069 6620 2766 6f6f 2e68 2720 tory if 'foo.h' │ │ │ │ │ -0003f3f0: 646f 6573 6e27 7420 6578 6973 7420 6279 doesn't exist by │ │ │ │ │ -0003f400: 2074 6865 2066 6972 7374 2027 6d61 6b65 the first 'make │ │ │ │ │ -0003f410: 270a 7275 6e2e 2020 466f 7220 696e 7374 '.run. For inst │ │ │ │ │ -0003f420: 616e 6365 2c20 7468 6572 6520 6d69 6768 ance, there migh │ │ │ │ │ -0003f430: 7420 6265 2061 2072 756c 6520 746f 2062 t be a rule to b │ │ │ │ │ -0003f440: 7569 6c64 2027 666f 6f2e 6827 2e20 2054 uild 'foo.h'. T │ │ │ │ │ -0003f450: 6869 7320 7469 6d65 0a27 6669 6c65 2e6f his time.'file.o │ │ │ │ │ -0003f460: 2727 7320 6275 696c 6420 7769 6c6c 2066 ''s build will f │ │ │ │ │ -0003f470: 6169 6c20 6265 6361 7573 6520 7468 6520 ail because the │ │ │ │ │ -0003f480: 636f 6d70 696c 6572 2063 616e 2774 2066 compiler can't f │ │ │ │ │ -0003f490: 696e 6420 2766 6f6f 2e68 272e 0a27 6d61 ind 'foo.h'..'ma │ │ │ │ │ -0003f4a0: 6b65 2720 6661 696c 6564 2074 6f20 7472 ke' failed to tr │ │ │ │ │ -0003f4b0: 6967 6765 7220 7468 6520 7275 6c65 2074 igger the rule t │ │ │ │ │ -0003f4c0: 6f20 6275 696c 6420 2766 6f6f 2e68 2720 o build 'foo.h' │ │ │ │ │ -0003f4d0: 6669 7273 7420 6279 206c 6163 6b20 6f66 first by lack of │ │ │ │ │ -0003f4e0: 0a64 6570 656e 6465 6e63 7920 696e 666f .dependency info │ │ │ │ │ -0003f4f0: 726d 6174 696f 6e2e 0a0a 2020 2054 6865 rmation... The │ │ │ │ │ -0003f500: 2027 4255 494c 545f 534f 5552 4345 5327 'BUILT_SOURCES' │ │ │ │ │ -0003f510: 2076 6172 6961 626c 6520 6973 2061 2077 variable is a w │ │ │ │ │ -0003f520: 6f72 6b61 726f 756e 6420 666f 7220 7468 orkaround for th │ │ │ │ │ -0003f530: 6973 2070 726f 626c 656d 2e20 2041 0a73 is problem. A.s │ │ │ │ │ -0003f540: 6f75 7263 6520 6669 6c65 206c 6973 7465 ource file liste │ │ │ │ │ -0003f550: 6420 696e 2027 4255 494c 545f 534f 5552 d in 'BUILT_SOUR │ │ │ │ │ -0003f560: 4345 5327 2069 7320 6d61 6465 206f 6e20 CES' is made on │ │ │ │ │ -0003f570: 276d 616b 6520 616c 6c27 206f 7220 276d 'make all' or 'm │ │ │ │ │ -0003f580: 616b 650a 6368 6563 6b27 2028 6f72 2065 ake.check' (or e │ │ │ │ │ -0003f590: 7665 6e20 276d 616b 6520 696e 7374 616c ven 'make instal │ │ │ │ │ -0003f5a0: 6c27 2920 6265 666f 7265 206f 7468 6572 l') before other │ │ │ │ │ -0003f5b0: 2074 6172 6765 7473 2061 7265 2070 726f targets are pro │ │ │ │ │ -0003f5c0: 6365 7373 6564 2e0a 486f 7765 7665 722c cessed..However, │ │ │ │ │ -0003f5d0: 2073 7563 6820 6120 736f 7572 6365 2066 such a source f │ │ │ │ │ -0003f5e0: 696c 6520 6973 206e 6f74 205f 636f 6d70 ile is not _comp │ │ │ │ │ -0003f5f0: 696c 6564 5f20 756e 6c65 7373 2065 7870 iled_ unless exp │ │ │ │ │ -0003f600: 6c69 6369 746c 790a 7265 7175 6573 7465 licitly.requeste │ │ │ │ │ -0003f610: 6420 6279 206d 656e 7469 6f6e 696e 6720 d by mentioning │ │ │ │ │ -0003f620: 6974 2069 6e20 736f 6d65 206f 7468 6572 it in some other │ │ │ │ │ -0003f630: 2027 5f53 4f55 5243 4553 2720 7661 7269 '_SOURCES' vari │ │ │ │ │ -0003f640: 6162 6c65 2e0a 0a20 2020 536f 2c20 746f able... So, to │ │ │ │ │ -0003f650: 2063 6f6e 636c 7564 6520 6f75 7220 696e conclude our in │ │ │ │ │ -0003f660: 7472 6f64 7563 746f 7279 2065 7861 6d70 troductory examp │ │ │ │ │ -0003f670: 6c65 2c20 7765 2063 6f75 6c64 2075 7365 le, we could use │ │ │ │ │ -0003f680: 2027 4255 494c 545f 534f 5552 4345 530a 'BUILT_SOURCES. │ │ │ │ │ -0003f690: 3d20 666f 6f2e 6827 2074 6f20 656e 7375 = foo.h' to ensu │ │ │ │ │ -0003f6a0: 7265 2027 666f 6f2e 6827 2067 6574 7320 re 'foo.h' gets │ │ │ │ │ -0003f6b0: 6275 696c 7420 6265 666f 7265 2061 6e79 built before any │ │ │ │ │ -0003f6c0: 206f 7468 6572 2074 6172 6765 7420 2869 other target (i │ │ │ │ │ -0003f6d0: 6e63 6c75 6469 6e67 0a27 666f 6f2e 6f27 ncluding.'foo.o' │ │ │ │ │ -0003f6e0: 2920 6475 7269 6e67 2027 6d61 6b65 2061 ) during 'make a │ │ │ │ │ -0003f6f0: 6c6c 2720 6f72 2027 6d61 6b65 2063 6865 ll' or 'make che │ │ │ │ │ -0003f700: 636b 272e 0a0a 2020 2027 4255 494c 545f ck'... 'BUILT_ │ │ │ │ │ -0003f710: 534f 5552 4345 5327 2069 7320 6163 7475 SOURCES' is actu │ │ │ │ │ -0003f720: 616c 6c79 2061 2062 6974 206f 6620 6120 ally a bit of a │ │ │ │ │ -0003f730: 6d69 736e 6f6d 6572 2c20 6173 2061 6e79 misnomer, as any │ │ │ │ │ -0003f740: 2066 696c 6520 7768 6963 680a 6d75 7374 file which.must │ │ │ │ │ -0003f750: 2062 6520 6372 6561 7465 6420 6561 726c be created earl │ │ │ │ │ -0003f760: 7920 696e 2074 6865 2062 7569 6c64 2070 y in the build p │ │ │ │ │ -0003f770: 726f 6365 7373 2063 616e 2062 6520 6c69 rocess can be li │ │ │ │ │ -0003f780: 7374 6564 2069 6e20 7468 6973 0a76 6172 sted in this.var │ │ │ │ │ -0003f790: 6961 626c 652e 2020 4d6f 7265 6f76 6572 iable. Moreover │ │ │ │ │ -0003f7a0: 2c20 616c 6c20 6275 696c 7420 736f 7572 , all built sour │ │ │ │ │ -0003f7b0: 6365 7320 646f 206e 6f74 206e 6563 6573 ces do not neces │ │ │ │ │ -0003f7c0: 7361 7269 6c79 2068 6176 6520 746f 2062 sarily have to b │ │ │ │ │ -0003f7d0: 650a 6c69 7374 6564 2069 6e20 2742 5549 e.listed in 'BUI │ │ │ │ │ -0003f7e0: 4c54 5f53 4f55 5243 4553 272e 2020 466f LT_SOURCES'. Fo │ │ │ │ │ -0003f7f0: 7220 696e 7374 616e 6365 2c20 6120 6765 r instance, a ge │ │ │ │ │ -0003f800: 6e65 7261 7465 6420 272e 6327 2066 696c nerated '.c' fil │ │ │ │ │ -0003f810: 6520 646f 6573 6e27 740a 6e65 6564 2074 e doesn't.need t │ │ │ │ │ -0003f820: 6f20 6170 7065 6172 2069 6e20 2742 5549 o appear in 'BUI │ │ │ │ │ -0003f830: 4c54 5f53 4f55 5243 4553 2720 2875 6e6c LT_SOURCES' (unl │ │ │ │ │ -0003f840: 6573 7320 6974 2069 7320 696e 636c 7564 ess it is includ │ │ │ │ │ -0003f850: 6564 2062 7920 616e 6f74 6865 720a 736f ed by another.so │ │ │ │ │ -0003f860: 7572 6365 292c 2062 6563 6175 7365 2069 urce), because i │ │ │ │ │ -0003f870: 7427 7320 6120 6b6e 6f77 6e20 6465 7065 t's a known depe │ │ │ │ │ -0003f880: 6e64 656e 6379 206f 6620 7468 6520 6173 ndency of the as │ │ │ │ │ -0003f890: 736f 6369 6174 6564 206f 626a 6563 742e sociated object. │ │ │ │ │ -0003f8a0: 0a0a 2020 2049 7420 6d69 6768 7420 6265 .. It might be │ │ │ │ │ -0003f8b0: 2069 6d70 6f72 7461 6e74 2074 6f20 656d important to em │ │ │ │ │ -0003f8c0: 7068 6173 697a 6520 7468 6174 2027 4255 phasize that 'BU │ │ │ │ │ -0003f8d0: 494c 545f 534f 5552 4345 5327 2069 7320 ILT_SOURCES' is │ │ │ │ │ -0003f8e0: 686f 6e6f 7265 640a 6f6e 6c79 2062 7920 honored.only by │ │ │ │ │ -0003f8f0: 276d 616b 6520 616c 6c27 2c20 276d 616b 'make all', 'mak │ │ │ │ │ -0003f900: 6520 6368 6563 6b27 2061 6e64 2027 6d61 e check' and 'ma │ │ │ │ │ -0003f910: 6b65 2069 6e73 7461 6c6c 272e 2020 5468 ke install'. Th │ │ │ │ │ -0003f920: 6973 206d 6561 6e73 2079 6f75 0a63 616e is means you.can │ │ │ │ │ -0003f930: 6e6f 7420 6275 696c 6420 6120 7370 6563 not build a spec │ │ │ │ │ -0003f940: 6966 6963 2074 6172 6765 7420 2865 2e67 ific target (e.g │ │ │ │ │ -0003f950: 2e2c 2027 6d61 6b65 2066 6f6f 2729 2069 ., 'make foo') i │ │ │ │ │ -0003f960: 6e20 6120 636c 6561 6e20 7472 6565 2069 n a clean tree i │ │ │ │ │ -0003f970: 6620 6974 0a64 6570 656e 6473 206f 6e20 f it.depends on │ │ │ │ │ -0003f980: 6120 6275 696c 7420 736f 7572 6365 2e20 a built source. │ │ │ │ │ -0003f990: 2048 6f77 6576 6572 2069 7420 7769 6c6c However it will │ │ │ │ │ -0003f9a0: 2073 7563 6365 6564 2069 6620 796f 7520 succeed if you │ │ │ │ │ -0003f9b0: 6861 7665 2072 756e 0a27 6d61 6b65 2061 have run.'make a │ │ │ │ │ -0003f9c0: 6c6c 2720 6561 726c 6965 722c 2062 6563 ll' earlier, bec │ │ │ │ │ -0003f9d0: 6175 7365 2061 6363 7572 6174 6520 6465 ause accurate de │ │ │ │ │ -0003f9e0: 7065 6e64 656e 6369 6573 2061 7265 2061 pendencies are a │ │ │ │ │ -0003f9f0: 6c72 6561 6479 2061 7661 696c 6162 6c65 lready available │ │ │ │ │ -0003fa00: 2e0a 0a20 2020 5468 6520 6e65 7874 2073 ... The next s │ │ │ │ │ -0003fa10: 6563 7469 6f6e 2069 6c6c 7573 7472 6174 ection illustrat │ │ │ │ │ -0003fa20: 6573 2061 6e64 2064 6973 6375 7373 6573 es and discusses │ │ │ │ │ -0003fa30: 2074 6865 2068 616e 646c 696e 6720 6f66 the handling of │ │ │ │ │ -0003fa40: 2062 7569 6c74 0a73 6f75 7263 6573 206f built.sources o │ │ │ │ │ -0003fa50: 6e20 6120 746f 7920 6578 616d 706c 652e n a toy example. │ │ │ │ │ -0003fa60: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2042 7569 ..* Menu:..* Bui │ │ │ │ │ -0003fa70: 6c74 2053 6f75 7263 6573 2045 7861 6d70 lt Sources Examp │ │ │ │ │ -0003fa80: 6c65 3a3a 2020 2020 2020 2053 6576 6572 le:: Sever │ │ │ │ │ -0003fa90: 616c 2077 6179 7320 746f 2068 616e 646c al ways to handl │ │ │ │ │ -0003faa0: 6520 6275 696c 7420 736f 7572 6365 732e e built sources. │ │ │ │ │ -0003fab0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -0003fac0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -0003fad0: 6f64 653a 2042 7569 6c74 2053 6f75 7263 ode: Built Sourc │ │ │ │ │ -0003fae0: 6573 2045 7861 6d70 6c65 2c20 2055 703a es Example, Up: │ │ │ │ │ -0003faf0: 2053 6f75 7263 6573 0a0a 392e 342e 3120 Sources..9.4.1 │ │ │ │ │ -0003fb00: 4275 696c 7420 536f 7572 6365 7320 4578 Built Sources Ex │ │ │ │ │ -0003fb10: 616d 706c 650a 2d2d 2d2d 2d2d 2d2d 2d2d ample.---------- │ │ │ │ │ +0003edf0: 3d3d 0a0a 4175 746f 6d61 6b65 2073 7570 ==..Automake sup │ │ │ │ │ +0003ee00: 706f 7274 7320 7468 6520 696e 7374 616c ports the instal │ │ │ │ │ +0003ee10: 6c61 7469 6f6e 206f 6620 6d69 7363 656c lation of miscel │ │ │ │ │ +0003ee20: 6c61 6e65 6f75 7320 6461 7461 2066 696c laneous data fil │ │ │ │ │ +0003ee30: 6573 2075 7369 6e67 2074 6865 0a27 4441 es using the.'DA │ │ │ │ │ +0003ee40: 5441 2720 6661 6d69 6c79 206f 6620 7661 TA' family of va │ │ │ │ │ +0003ee50: 7269 6162 6c65 732e 0a0a 2020 2053 7563 riables... Suc │ │ │ │ │ +0003ee60: 6820 6461 7461 2063 616e 2062 6520 696e h data can be in │ │ │ │ │ +0003ee70: 7374 616c 6c65 6420 696e 2074 6865 2064 stalled in the d │ │ │ │ │ +0003ee80: 6972 6563 746f 7269 6573 2027 6461 7461 irectories 'data │ │ │ │ │ +0003ee90: 6469 7227 2c0a 2773 7973 636f 6e66 6469 dir',.'sysconfdi │ │ │ │ │ +0003eea0: 7227 2c20 2773 6861 7265 6473 7461 7465 r', 'sharedstate │ │ │ │ │ +0003eeb0: 6469 7227 2c20 276c 6f63 616c 7374 6174 dir', 'localstat │ │ │ │ │ +0003eec0: 6564 6972 272c 206f 7220 2770 6b67 6461 edir', or 'pkgda │ │ │ │ │ +0003eed0: 7461 6469 7227 2e0a 0a20 2020 4279 2064 tadir'... By d │ │ │ │ │ +0003eee0: 6566 6175 6c74 2c20 6461 7461 2066 696c efault, data fil │ │ │ │ │ +0003eef0: 6573 2061 7265 205f 6e6f 745f 2069 6e63 es are _not_ inc │ │ │ │ │ +0003ef00: 6c75 6465 6420 696e 2061 2064 6973 7472 luded in a distr │ │ │ │ │ +0003ef10: 6962 7574 696f 6e2e 2020 4f66 0a63 6f75 ibution. Of.cou │ │ │ │ │ +0003ef20: 7273 652c 2079 6f75 2063 616e 2075 7365 rse, you can use │ │ │ │ │ +0003ef30: 2074 6865 2027 6469 7374 5f27 2070 7265 the 'dist_' pre │ │ │ │ │ +0003ef40: 6669 7820 746f 2063 6861 6e67 6520 7468 fix to change th │ │ │ │ │ +0003ef50: 6973 206f 6e20 6120 7065 722d 7661 7269 is on a per-vari │ │ │ │ │ +0003ef60: 6162 6c65 0a62 6173 6973 2e0a 0a20 2020 able.basis... │ │ │ │ │ +0003ef70: 4865 7265 2069 7320 686f 7720 4175 746f Here is how Auto │ │ │ │ │ +0003ef80: 6d61 6b65 2064 6563 6c61 7265 7320 6974 make declares it │ │ │ │ │ +0003ef90: 7320 6175 7869 6c69 6172 7920 6461 7461 s auxiliary data │ │ │ │ │ +0003efa0: 2066 696c 6573 3a0a 0a20 2020 2020 6469 files:.. di │ │ │ │ │ +0003efb0: 7374 5f70 6b67 6461 7461 5f44 4154 4120 st_pkgdata_DATA │ │ │ │ │ +0003efc0: 3d20 636c 6561 6e2d 6b72 2e61 6d20 636c = clean-kr.am cl │ │ │ │ │ +0003efd0: 6561 6e2e 616d 202e 2e2e 0a0a 1f0a 4669 ean.am .......Fi │ │ │ │ │ +0003efe0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +0003eff0: 312e 696e 666f 2c20 204e 6f64 653a 2053 1.info, Node: S │ │ │ │ │ +0003f000: 6f75 7263 6573 2c20 2050 7265 763a 2044 ources, Prev: D │ │ │ │ │ +0003f010: 6174 612c 2020 5570 3a20 4f74 6865 7220 ata, Up: Other │ │ │ │ │ +0003f020: 4f62 6a65 6374 730a 0a39 2e34 2042 7569 Objects..9.4 Bui │ │ │ │ │ +0003f030: 6c74 2053 6f75 7263 6573 0a3d 3d3d 3d3d lt Sources.===== │ │ │ │ │ +0003f040: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4265 ============..Be │ │ │ │ │ +0003f050: 6361 7573 6520 4175 746f 6d61 6b65 2773 cause Automake's │ │ │ │ │ +0003f060: 2061 7574 6f6d 6174 6963 2064 6570 656e automatic depen │ │ │ │ │ +0003f070: 6465 6e63 7920 7472 6163 6b69 6e67 2077 dency tracking w │ │ │ │ │ +0003f080: 6f72 6b73 2061 7320 6120 7369 6465 2d65 orks as a side-e │ │ │ │ │ +0003f090: 6666 6563 740a 6f66 2063 6f6d 7069 6c61 ffect.of compila │ │ │ │ │ +0003f0a0: 7469 6f6e 2028 2a6e 6f74 6520 4465 7065 tion (*note Depe │ │ │ │ │ +0003f0b0: 6e64 656e 6369 6573 3a3a 2920 7468 6572 ndencies::) ther │ │ │ │ │ +0003f0c0: 6520 6973 2061 2062 6f6f 7473 7472 6170 e is a bootstrap │ │ │ │ │ +0003f0d0: 2069 7373 7565 3a20 610a 7461 7267 6574 issue: a.target │ │ │ │ │ +0003f0e0: 2073 686f 756c 6420 6e6f 7420 6265 2063 should not be c │ │ │ │ │ +0003f0f0: 6f6d 7069 6c65 6420 6265 666f 7265 2069 ompiled before i │ │ │ │ │ +0003f100: 7473 2064 6570 656e 6465 6e63 6965 7320 ts dependencies │ │ │ │ │ +0003f110: 6172 6520 6d61 6465 2c20 6275 740a 7468 are made, but.th │ │ │ │ │ +0003f120: 6573 6520 6465 7065 6e64 656e 6369 6573 ese dependencies │ │ │ │ │ +0003f130: 2061 7265 2075 6e6b 6e6f 776e 2075 6e74 are unknown unt │ │ │ │ │ +0003f140: 696c 2074 6865 2074 6172 6765 7420 6973 il the target is │ │ │ │ │ +0003f150: 2066 6972 7374 2063 6f6d 7069 6c65 642e first compiled. │ │ │ │ │ +0003f160: 0a0a 2020 204f 7264 696e 6172 696c 7920 .. Ordinarily │ │ │ │ │ +0003f170: 7468 6973 2069 7320 6e6f 7420 6120 7072 this is not a pr │ │ │ │ │ +0003f180: 6f62 6c65 6d2c 2062 6563 6175 7365 2064 oblem, because d │ │ │ │ │ +0003f190: 6570 656e 6465 6e63 6965 7320 6172 650a ependencies are. │ │ │ │ │ +0003f1a0: 6469 7374 7269 6275 7465 6420 736f 7572 distributed sour │ │ │ │ │ +0003f1b0: 6365 733a 2074 6865 7920 7072 6565 7869 ces: they preexi │ │ │ │ │ +0003f1c0: 7374 2061 6e64 2064 6f20 6e6f 7420 6e65 st and do not ne │ │ │ │ │ +0003f1d0: 6564 2074 6f20 6265 2062 7569 6c74 2e20 ed to be built. │ │ │ │ │ +0003f1e0: 2053 7570 706f 7365 0a74 6861 7420 2766 Suppose.that 'f │ │ │ │ │ +0003f1f0: 6f6f 2e63 2720 696e 636c 7564 6573 2027 oo.c' includes ' │ │ │ │ │ +0003f200: 666f 6f2e 6827 2e20 2057 6865 6e20 6974 foo.h'. When it │ │ │ │ │ +0003f210: 2066 6972 7374 2063 6f6d 7069 6c65 7320 first compiles │ │ │ │ │ +0003f220: 2766 6f6f 2e6f 272c 2027 6d61 6b65 270a 'foo.o', 'make'. │ │ │ │ │ +0003f230: 6f6e 6c79 206b 6e6f 7773 2074 6861 7420 only knows that │ │ │ │ │ +0003f240: 2766 6f6f 2e6f 2720 6465 7065 6e64 7320 'foo.o' depends │ │ │ │ │ +0003f250: 6f6e 2027 666f 6f2e 6327 2e20 2041 7320 on 'foo.c'. As │ │ │ │ │ +0003f260: 6120 7369 6465 2d65 6666 6563 7420 6f66 a side-effect of │ │ │ │ │ +0003f270: 2074 6869 730a 636f 6d70 696c 6174 696f this.compilatio │ │ │ │ │ +0003f280: 6e20 2764 6570 636f 6d70 2720 7265 636f n 'depcomp' reco │ │ │ │ │ +0003f290: 7264 7320 7468 6520 2766 6f6f 2e68 2720 rds the 'foo.h' │ │ │ │ │ +0003f2a0: 6465 7065 6e64 656e 6379 2073 6f20 7468 dependency so th │ │ │ │ │ +0003f2b0: 6174 2066 6f6c 6c6f 7769 6e67 0a69 6e76 at following.inv │ │ │ │ │ +0003f2c0: 6f63 6174 696f 6e73 206f 6620 276d 616b ocations of 'mak │ │ │ │ │ +0003f2d0: 6527 2077 696c 6c20 686f 6e6f 7220 6974 e' will honor it │ │ │ │ │ +0003f2e0: 2e20 2049 6e20 7468 6573 6520 636f 6e64 . In these cond │ │ │ │ │ +0003f2f0: 6974 696f 6e73 2c20 6974 2773 2063 6c65 itions, it's cle │ │ │ │ │ +0003f300: 6172 0a74 6865 7265 2069 7320 6e6f 2070 ar.there is no p │ │ │ │ │ +0003f310: 726f 626c 656d 3a20 6569 7468 6572 2027 roblem: either ' │ │ │ │ │ +0003f320: 666f 6f2e 6f27 2064 6f65 736e 2774 2065 foo.o' doesn't e │ │ │ │ │ +0003f330: 7869 7374 2061 6e64 2068 6173 2074 6f20 xist and has to │ │ │ │ │ +0003f340: 6265 2062 7569 6c74 0a28 7265 6761 7264 be built.(regard │ │ │ │ │ +0003f350: 6c65 7373 206f 6620 7468 6520 6465 7065 less of the depe │ │ │ │ │ +0003f360: 6e64 656e 6369 6573 292c 206f 7220 6163 ndencies), or ac │ │ │ │ │ +0003f370: 6375 7261 7465 2064 6570 656e 6465 6e63 curate dependenc │ │ │ │ │ +0003f380: 6965 7320 6578 6973 7420 616e 640a 7468 ies exist and.th │ │ │ │ │ +0003f390: 6579 2063 616e 2062 6520 7573 6564 2074 ey can be used t │ │ │ │ │ +0003f3a0: 6f20 6465 6369 6465 2077 6865 7468 6572 o decide whether │ │ │ │ │ +0003f3b0: 2027 666f 6f2e 6f27 2073 686f 756c 6420 'foo.o' should │ │ │ │ │ +0003f3c0: 6265 2072 6562 7569 6c74 2e0a 0a20 2020 be rebuilt... │ │ │ │ │ +0003f3d0: 4974 2773 2061 2064 6966 6665 7265 6e74 It's a different │ │ │ │ │ +0003f3e0: 2073 746f 7279 2069 6620 2766 6f6f 2e68 story if 'foo.h │ │ │ │ │ +0003f3f0: 2720 646f 6573 6e27 7420 6578 6973 7420 ' doesn't exist │ │ │ │ │ +0003f400: 6279 2074 6865 2066 6972 7374 2027 6d61 by the first 'ma │ │ │ │ │ +0003f410: 6b65 270a 7275 6e2e 2020 466f 7220 696e ke'.run. For in │ │ │ │ │ +0003f420: 7374 616e 6365 2c20 7468 6572 6520 6d69 stance, there mi │ │ │ │ │ +0003f430: 6768 7420 6265 2061 2072 756c 6520 746f ght be a rule to │ │ │ │ │ +0003f440: 2062 7569 6c64 2027 666f 6f2e 6827 2e20 build 'foo.h'. │ │ │ │ │ +0003f450: 2054 6869 7320 7469 6d65 0a27 6669 6c65 This time.'file │ │ │ │ │ +0003f460: 2e6f 2727 7320 6275 696c 6420 7769 6c6c .o''s build will │ │ │ │ │ +0003f470: 2066 6169 6c20 6265 6361 7573 6520 7468 fail because th │ │ │ │ │ +0003f480: 6520 636f 6d70 696c 6572 2063 616e 2774 e compiler can't │ │ │ │ │ +0003f490: 2066 696e 6420 2766 6f6f 2e68 272e 0a27 find 'foo.h'..' │ │ │ │ │ +0003f4a0: 6d61 6b65 2720 6661 696c 6564 2074 6f20 make' failed to │ │ │ │ │ +0003f4b0: 7472 6967 6765 7220 7468 6520 7275 6c65 trigger the rule │ │ │ │ │ +0003f4c0: 2074 6f20 6275 696c 6420 2766 6f6f 2e68 to build 'foo.h │ │ │ │ │ +0003f4d0: 2720 6669 7273 7420 6279 206c 6163 6b20 ' first by lack │ │ │ │ │ +0003f4e0: 6f66 0a64 6570 656e 6465 6e63 7920 696e of.dependency in │ │ │ │ │ +0003f4f0: 666f 726d 6174 696f 6e2e 0a0a 2020 2054 formation... T │ │ │ │ │ +0003f500: 6865 2027 4255 494c 545f 534f 5552 4345 he 'BUILT_SOURCE │ │ │ │ │ +0003f510: 5327 2076 6172 6961 626c 6520 6973 2061 S' variable is a │ │ │ │ │ +0003f520: 2077 6f72 6b61 726f 756e 6420 666f 7220 workaround for │ │ │ │ │ +0003f530: 7468 6973 2070 726f 626c 656d 2e20 2041 this problem. A │ │ │ │ │ +0003f540: 0a73 6f75 7263 6520 6669 6c65 206c 6973 .source file lis │ │ │ │ │ +0003f550: 7465 6420 696e 2027 4255 494c 545f 534f ted in 'BUILT_SO │ │ │ │ │ +0003f560: 5552 4345 5327 2069 7320 6d61 6465 206f URCES' is made o │ │ │ │ │ +0003f570: 6e20 276d 616b 6520 616c 6c27 206f 7220 n 'make all' or │ │ │ │ │ +0003f580: 276d 616b 650a 6368 6563 6b27 2028 6f72 'make.check' (or │ │ │ │ │ +0003f590: 2065 7665 6e20 276d 616b 6520 696e 7374 even 'make inst │ │ │ │ │ +0003f5a0: 616c 6c27 2920 6265 666f 7265 206f 7468 all') before oth │ │ │ │ │ +0003f5b0: 6572 2074 6172 6765 7473 2061 7265 2070 er targets are p │ │ │ │ │ +0003f5c0: 726f 6365 7373 6564 2e0a 486f 7765 7665 rocessed..Howeve │ │ │ │ │ +0003f5d0: 722c 2073 7563 6820 6120 736f 7572 6365 r, such a source │ │ │ │ │ +0003f5e0: 2066 696c 6520 6973 206e 6f74 205f 636f file is not _co │ │ │ │ │ +0003f5f0: 6d70 696c 6564 5f20 756e 6c65 7373 2065 mpiled_ unless e │ │ │ │ │ +0003f600: 7870 6c69 6369 746c 790a 7265 7175 6573 xplicitly.reques │ │ │ │ │ +0003f610: 7465 6420 6279 206d 656e 7469 6f6e 696e ted by mentionin │ │ │ │ │ +0003f620: 6720 6974 2069 6e20 736f 6d65 206f 7468 g it in some oth │ │ │ │ │ +0003f630: 6572 2027 5f53 4f55 5243 4553 2720 7661 er '_SOURCES' va │ │ │ │ │ +0003f640: 7269 6162 6c65 2e0a 0a20 2020 536f 2c20 riable... So, │ │ │ │ │ +0003f650: 746f 2063 6f6e 636c 7564 6520 6f75 7220 to conclude our │ │ │ │ │ +0003f660: 696e 7472 6f64 7563 746f 7279 2065 7861 introductory exa │ │ │ │ │ +0003f670: 6d70 6c65 2c20 7765 2063 6f75 6c64 2075 mple, we could u │ │ │ │ │ +0003f680: 7365 2027 4255 494c 545f 534f 5552 4345 se 'BUILT_SOURCE │ │ │ │ │ +0003f690: 530a 3d20 666f 6f2e 6827 2074 6f20 656e S.= foo.h' to en │ │ │ │ │ +0003f6a0: 7375 7265 2027 666f 6f2e 6827 2067 6574 sure 'foo.h' get │ │ │ │ │ +0003f6b0: 7320 6275 696c 7420 6265 666f 7265 2061 s built before a │ │ │ │ │ +0003f6c0: 6e79 206f 7468 6572 2074 6172 6765 7420 ny other target │ │ │ │ │ +0003f6d0: 2869 6e63 6c75 6469 6e67 0a27 666f 6f2e (including.'foo. │ │ │ │ │ +0003f6e0: 6f27 2920 6475 7269 6e67 2027 6d61 6b65 o') during 'make │ │ │ │ │ +0003f6f0: 2061 6c6c 2720 6f72 2027 6d61 6b65 2063 all' or 'make c │ │ │ │ │ +0003f700: 6865 636b 272e 0a0a 2020 2027 4255 494c heck'... 'BUIL │ │ │ │ │ +0003f710: 545f 534f 5552 4345 5327 2069 7320 6163 T_SOURCES' is ac │ │ │ │ │ +0003f720: 7475 616c 6c79 2061 2062 6974 206f 6620 tually a bit of │ │ │ │ │ +0003f730: 6120 6d69 736e 6f6d 6572 2c20 6173 2061 a misnomer, as a │ │ │ │ │ +0003f740: 6e79 2066 696c 6520 7768 6963 680a 6d75 ny file which.mu │ │ │ │ │ +0003f750: 7374 2062 6520 6372 6561 7465 6420 6561 st be created ea │ │ │ │ │ +0003f760: 726c 7920 696e 2074 6865 2062 7569 6c64 rly in the build │ │ │ │ │ +0003f770: 2070 726f 6365 7373 2063 616e 2062 6520 process can be │ │ │ │ │ +0003f780: 6c69 7374 6564 2069 6e20 7468 6973 0a76 listed in this.v │ │ │ │ │ +0003f790: 6172 6961 626c 652e 2020 4d6f 7265 6f76 ariable. Moreov │ │ │ │ │ +0003f7a0: 6572 2c20 616c 6c20 6275 696c 7420 736f er, all built so │ │ │ │ │ +0003f7b0: 7572 6365 7320 646f 206e 6f74 206e 6563 urces do not nec │ │ │ │ │ +0003f7c0: 6573 7361 7269 6c79 2068 6176 6520 746f essarily have to │ │ │ │ │ +0003f7d0: 2062 650a 6c69 7374 6564 2069 6e20 2742 be.listed in 'B │ │ │ │ │ +0003f7e0: 5549 4c54 5f53 4f55 5243 4553 272e 2020 UILT_SOURCES'. │ │ │ │ │ +0003f7f0: 466f 7220 696e 7374 616e 6365 2c20 6120 For instance, a │ │ │ │ │ +0003f800: 6765 6e65 7261 7465 6420 272e 6327 2066 generated '.c' f │ │ │ │ │ +0003f810: 696c 6520 646f 6573 6e27 740a 6e65 6564 ile doesn't.need │ │ │ │ │ +0003f820: 2074 6f20 6170 7065 6172 2069 6e20 2742 to appear in 'B │ │ │ │ │ +0003f830: 5549 4c54 5f53 4f55 5243 4553 2720 2875 UILT_SOURCES' (u │ │ │ │ │ +0003f840: 6e6c 6573 7320 6974 2069 7320 696e 636c nless it is incl │ │ │ │ │ +0003f850: 7564 6564 2062 7920 616e 6f74 6865 720a uded by another. │ │ │ │ │ +0003f860: 736f 7572 6365 292c 2062 6563 6175 7365 source), because │ │ │ │ │ +0003f870: 2069 7427 7320 6120 6b6e 6f77 6e20 6465 it's a known de │ │ │ │ │ +0003f880: 7065 6e64 656e 6379 206f 6620 7468 6520 pendency of the │ │ │ │ │ +0003f890: 6173 736f 6369 6174 6564 206f 626a 6563 associated objec │ │ │ │ │ +0003f8a0: 742e 0a0a 2020 2049 7420 6d69 6768 7420 t... It might │ │ │ │ │ +0003f8b0: 6265 2069 6d70 6f72 7461 6e74 2074 6f20 be important to │ │ │ │ │ +0003f8c0: 656d 7068 6173 697a 6520 7468 6174 2027 emphasize that ' │ │ │ │ │ +0003f8d0: 4255 494c 545f 534f 5552 4345 5327 2069 BUILT_SOURCES' i │ │ │ │ │ +0003f8e0: 7320 686f 6e6f 7265 640a 6f6e 6c79 2062 s honored.only b │ │ │ │ │ +0003f8f0: 7920 276d 616b 6520 616c 6c27 2c20 276d y 'make all', 'm │ │ │ │ │ +0003f900: 616b 6520 6368 6563 6b27 2061 6e64 2027 ake check' and ' │ │ │ │ │ +0003f910: 6d61 6b65 2069 6e73 7461 6c6c 272e 2020 make install'. │ │ │ │ │ +0003f920: 5468 6973 206d 6561 6e73 2079 6f75 0a63 This means you.c │ │ │ │ │ +0003f930: 616e 6e6f 7420 6275 696c 6420 6120 7370 annot build a sp │ │ │ │ │ +0003f940: 6563 6966 6963 2074 6172 6765 7420 2865 ecific target (e │ │ │ │ │ +0003f950: 2e67 2e2c 2027 6d61 6b65 2066 6f6f 2729 .g., 'make foo') │ │ │ │ │ +0003f960: 2069 6e20 6120 636c 6561 6e20 7472 6565 in a clean tree │ │ │ │ │ +0003f970: 2069 6620 6974 0a64 6570 656e 6473 206f if it.depends o │ │ │ │ │ +0003f980: 6e20 6120 6275 696c 7420 736f 7572 6365 n a built source │ │ │ │ │ +0003f990: 2e20 2048 6f77 6576 6572 2069 7420 7769 . However it wi │ │ │ │ │ +0003f9a0: 6c6c 2073 7563 6365 6564 2069 6620 796f ll succeed if yo │ │ │ │ │ +0003f9b0: 7520 6861 7665 2072 756e 0a27 6d61 6b65 u have run.'make │ │ │ │ │ +0003f9c0: 2061 6c6c 2720 6561 726c 6965 722c 2062 all' earlier, b │ │ │ │ │ +0003f9d0: 6563 6175 7365 2061 6363 7572 6174 6520 ecause accurate │ │ │ │ │ +0003f9e0: 6465 7065 6e64 656e 6369 6573 2061 7265 dependencies are │ │ │ │ │ +0003f9f0: 2061 6c72 6561 6479 2061 7661 696c 6162 already availab │ │ │ │ │ +0003fa00: 6c65 2e0a 0a20 2020 5468 6520 6e65 7874 le... The next │ │ │ │ │ +0003fa10: 2073 6563 7469 6f6e 2069 6c6c 7573 7472 section illustr │ │ │ │ │ +0003fa20: 6174 6573 2061 6e64 2064 6973 6375 7373 ates and discuss │ │ │ │ │ +0003fa30: 6573 2074 6865 2068 616e 646c 696e 6720 es the handling │ │ │ │ │ +0003fa40: 6f66 2062 7569 6c74 0a73 6f75 7263 6573 of built.sources │ │ │ │ │ +0003fa50: 206f 6e20 6120 746f 7920 6578 616d 706c on a toy exampl │ │ │ │ │ +0003fa60: 652e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2042 e...* Menu:..* B │ │ │ │ │ +0003fa70: 7569 6c74 2053 6f75 7263 6573 2045 7861 uilt Sources Exa │ │ │ │ │ +0003fa80: 6d70 6c65 3a3a 2020 2020 2020 2053 6576 mple:: Sev │ │ │ │ │ +0003fa90: 6572 616c 2077 6179 7320 746f 2068 616e eral ways to han │ │ │ │ │ +0003faa0: 646c 6520 6275 696c 7420 736f 7572 6365 dle built source │ │ │ │ │ +0003fab0: 732e 0a0a 1f0a 4669 6c65 3a20 6175 746f s.....File: auto │ │ │ │ │ +0003fac0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +0003fad0: 204e 6f64 653a 2042 7569 6c74 2053 6f75 Node: Built Sou │ │ │ │ │ +0003fae0: 7263 6573 2045 7861 6d70 6c65 2c20 2055 rces Example, U │ │ │ │ │ +0003faf0: 703a 2053 6f75 7263 6573 0a0a 392e 342e p: Sources..9.4. │ │ │ │ │ +0003fb00: 3120 4275 696c 7420 536f 7572 6365 7320 1 Built Sources │ │ │ │ │ +0003fb10: 4578 616d 706c 650a 2d2d 2d2d 2d2d 2d2d Example.-------- │ │ │ │ │ 0003fb20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0003fb30: 2d0a 0a53 7570 706f 7365 2074 6861 7420 -..Suppose that │ │ │ │ │ -0003fb40: 2766 6f6f 2e63 2720 696e 636c 7564 6573 'foo.c' includes │ │ │ │ │ -0003fb50: 2027 6269 6e64 6972 2e68 272c 2077 6869 'bindir.h', whi │ │ │ │ │ -0003fb60: 6368 2069 730a 696e 7374 616c 6c61 7469 ch is.installati │ │ │ │ │ -0003fb70: 6f6e 2d64 6570 656e 6465 6e74 2061 6e64 on-dependent and │ │ │ │ │ -0003fb80: 206e 6f74 2064 6973 7472 6962 7574 6564 not distributed │ │ │ │ │ -0003fb90: 3a20 6974 206e 6565 6473 2074 6f20 6265 : it needs to be │ │ │ │ │ -0003fba0: 2062 7569 6c74 2e20 2048 6572 650a 2762 built. Here.'b │ │ │ │ │ -0003fbb0: 696e 6469 722e 6827 2064 6566 696e 6573 indir.h' defines │ │ │ │ │ -0003fbc0: 2074 6865 2070 7265 7072 6f63 6573 736f the preprocesso │ │ │ │ │ -0003fbd0: 7220 6d61 6372 6f20 2762 696e 6469 7227 r macro 'bindir' │ │ │ │ │ -0003fbe0: 2074 6f20 7468 6520 7661 6c75 6520 6f66 to the value of │ │ │ │ │ -0003fbf0: 2074 6865 0a27 6d61 6b65 2720 7661 7269 the.'make' vari │ │ │ │ │ -0003fc00: 6162 6c65 2027 6269 6e64 6972 2720 2869 able 'bindir' (i │ │ │ │ │ -0003fc10: 6e68 6572 6974 6564 2066 726f 6d20 2763 nherited from 'c │ │ │ │ │ -0003fc20: 6f6e 6669 6775 7265 2729 2e0a 0a20 2020 onfigure')... │ │ │ │ │ -0003fc30: 5765 2073 7567 6765 7374 2073 6576 6572 We suggest sever │ │ │ │ │ -0003fc40: 616c 2069 6d70 6c65 6d65 6e74 6174 696f al implementatio │ │ │ │ │ -0003fc50: 6e73 2062 656c 6f77 2e20 2049 7427 7320 ns below. It's │ │ │ │ │ -0003fc60: 6e6f 7420 6d65 616e 7420 746f 2062 6520 not meant to be │ │ │ │ │ -0003fc70: 616e 0a65 7868 6175 7374 6976 6520 6c69 an.exhaustive li │ │ │ │ │ -0003fc80: 7374 696e 6720 6f66 2061 6c6c 2077 6179 sting of all way │ │ │ │ │ -0003fc90: 7320 746f 2068 616e 646c 6520 6275 696c s to handle buil │ │ │ │ │ -0003fca0: 7420 736f 7572 6365 732c 2062 7574 2069 t sources, but i │ │ │ │ │ -0003fcb0: 7420 7769 6c6c 2067 6976 650a 796f 7520 t will give.you │ │ │ │ │ -0003fcc0: 6120 6665 7720 6964 6561 7320 6966 2079 a few ideas if y │ │ │ │ │ -0003fcd0: 6f75 2065 6e63 6f75 6e74 6572 2074 6869 ou encounter thi │ │ │ │ │ -0003fce0: 7320 6973 7375 652e 0a0a 4669 7273 7420 s issue...First │ │ │ │ │ -0003fcf0: 5472 790a 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 Try............T │ │ │ │ │ -0003fd00: 6869 7320 6669 7273 7420 696d 706c 656d his first implem │ │ │ │ │ -0003fd10: 656e 7461 7469 6f6e 2077 696c 6c20 696c entation will il │ │ │ │ │ -0003fd20: 6c75 7374 7261 7465 2074 6865 2062 6f6f lustrate the boo │ │ │ │ │ -0003fd30: 7473 7472 6170 2069 7373 7565 206d 656e tstrap issue men │ │ │ │ │ -0003fd40: 7469 6f6e 6564 0a69 6e20 7468 6520 7072 tioned.in the pr │ │ │ │ │ -0003fd50: 6576 696f 7573 2073 6563 7469 6f6e 2028 evious section ( │ │ │ │ │ -0003fd60: 2a6e 6f74 6520 536f 7572 6365 733a 3a29 *note Sources::) │ │ │ │ │ -0003fd70: 2e0a 0a20 2020 4865 7265 2069 7320 6120 ... Here is a │ │ │ │ │ -0003fd80: 7465 6e74 6174 6976 6520 274d 616b 6566 tentative 'Makef │ │ │ │ │ -0003fd90: 696c 652e 616d 272e 0a0a 2020 2020 2023 ile.am'... # │ │ │ │ │ -0003fda0: 2054 6869 7320 776f 6e27 7420 776f 726b This won't work │ │ │ │ │ -0003fdb0: 2e0a 2020 2020 2062 696e 5f50 524f 4752 .. bin_PROGR │ │ │ │ │ -0003fdc0: 414d 5320 3d20 666f 6f0a 2020 2020 2066 AMS = foo. f │ │ │ │ │ -0003fdd0: 6f6f 5f53 4f55 5243 4553 203d 2066 6f6f oo_SOURCES = foo │ │ │ │ │ -0003fde0: 2e63 0a20 2020 2020 6e6f 6469 7374 5f66 .c. nodist_f │ │ │ │ │ -0003fdf0: 6f6f 5f53 4f55 5243 4553 203d 2062 696e oo_SOURCES = bin │ │ │ │ │ -0003fe00: 6469 722e 680a 2020 2020 2043 4c45 414e dir.h. CLEAN │ │ │ │ │ -0003fe10: 4649 4c45 5320 3d20 6269 6e64 6972 2e68 FILES = bindir.h │ │ │ │ │ -0003fe20: 0a20 2020 2020 6269 6e64 6972 2e68 3a20 . bindir.h: │ │ │ │ │ -0003fe30: 4d61 6b65 6669 6c65 0a20 2020 2020 2020 Makefile. │ │ │ │ │ -0003fe40: 2020 2020 2020 6563 686f 2027 2364 6566 echo '#def │ │ │ │ │ -0003fe50: 696e 6520 6269 6e64 6972 2022 2428 6269 ine bindir "$(bi │ │ │ │ │ -0003fe60: 6e64 6972 2922 2720 3e24 400a 0a20 2020 ndir)"' >$@.. │ │ │ │ │ -0003fe70: 5468 6973 2073 6574 7570 2064 6f65 736e This setup doesn │ │ │ │ │ -0003fe80: 2774 2077 6f72 6b2c 2062 6563 6175 7365 't work, because │ │ │ │ │ -0003fe90: 2041 7574 6f6d 616b 6520 646f 6573 6e27 Automake doesn' │ │ │ │ │ -0003fea0: 7420 6b6e 6f77 2074 6861 7420 2766 6f6f t know that 'foo │ │ │ │ │ -0003feb0: 2e63 270a 696e 636c 7564 6573 2027 6269 .c'.includes 'bi │ │ │ │ │ -0003fec0: 6e64 6972 2e68 272e 2020 5265 6d65 6d62 ndir.h'. Rememb │ │ │ │ │ -0003fed0: 6572 2c20 6175 746f 6d61 7469 6320 6465 er, automatic de │ │ │ │ │ -0003fee0: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ -0003fef0: 6720 776f 726b 7320 6173 2061 0a73 6964 g works as a.sid │ │ │ │ │ -0003ff00: 652d 6566 6665 6374 206f 6620 636f 6d70 e-effect of comp │ │ │ │ │ -0003ff10: 696c 6174 696f 6e2c 2073 6f20 7468 6520 ilation, so the │ │ │ │ │ -0003ff20: 6465 7065 6e64 656e 6369 6573 206f 6620 dependencies of │ │ │ │ │ -0003ff30: 2766 6f6f 2e6f 2720 7769 6c6c 2062 6520 'foo.o' will be │ │ │ │ │ -0003ff40: 6b6e 6f77 6e0a 6f6e 6c79 2061 6674 6572 known.only after │ │ │ │ │ -0003ff50: 2027 666f 6f2e 6f27 2068 6173 2062 6565 'foo.o' has bee │ │ │ │ │ -0003ff60: 6e20 636f 6d70 696c 6564 2028 2a6e 6f74 n compiled (*not │ │ │ │ │ -0003ff70: 6520 4465 7065 6e64 656e 6369 6573 3a3a e Dependencies:: │ │ │ │ │ -0003ff80: 292e 2020 5468 650a 7379 6d70 746f 6d20 ). The.symptom │ │ │ │ │ -0003ff90: 6973 2061 7320 666f 6c6c 6f77 732e 0a0a is as follows... │ │ │ │ │ -0003ffa0: 2020 2020 2025 206d 616b 650a 2020 2020 % make. │ │ │ │ │ -0003ffb0: 2073 6f75 7263 653d 2766 6f6f 2e63 2720 source='foo.c' │ │ │ │ │ -0003ffc0: 6f62 6a65 6374 3d27 666f 6f2e 6f27 206c object='foo.o' l │ │ │ │ │ -0003ffd0: 6962 746f 6f6c 3d6e 6f20 5c0a 2020 2020 ibtool=no \. │ │ │ │ │ -0003ffe0: 2064 6570 6669 6c65 3d27 2e64 6570 732f depfile='.deps/ │ │ │ │ │ -0003fff0: 666f 6f2e 506f 2720 746d 7064 6570 6669 foo.Po' tmpdepfi │ │ │ │ │ -00040000: 6c65 3d27 2e64 6570 732f 666f 6f2e 5450 le='.deps/foo.TP │ │ │ │ │ -00040010: 6f27 205c 0a20 2020 2020 6465 706d 6f64 o' \. depmod │ │ │ │ │ -00040020: 653d 6763 6320 2f62 696e 2f73 6820 2e2f e=gcc /bin/sh ./ │ │ │ │ │ -00040030: 6465 7063 6f6d 7020 5c0a 2020 2020 2067 depcomp \. g │ │ │ │ │ -00040040: 6363 202d 492e 202d 492e 202d 6720 2d4f cc -I. -I. -g -O │ │ │ │ │ -00040050: 3220 2d63 2060 7465 7374 202d 6620 2766 2 -c `test -f 'f │ │ │ │ │ -00040060: 6f6f 2e63 2720 7c7c 2065 6368 6f20 272e oo.c' || echo '. │ │ │ │ │ -00040070: 2f27 6066 6f6f 2e63 0a20 2020 2020 666f /'`foo.c. fo │ │ │ │ │ -00040080: 6f2e 633a 323a 2062 696e 6469 722e 683a o.c:2: bindir.h: │ │ │ │ │ -00040090: 204e 6f20 7375 6368 2066 696c 6520 6f72 No such file or │ │ │ │ │ -000400a0: 2064 6972 6563 746f 7279 0a20 2020 2020 directory. │ │ │ │ │ -000400b0: 6d61 6b65 3a20 2a2a 2a20 5b66 6f6f 2e6f make: *** [foo.o │ │ │ │ │ -000400c0: 5d20 4572 726f 7220 310a 0a20 2020 496e ] Error 1.. In │ │ │ │ │ -000400d0: 2074 6869 7320 6578 616d 706c 6520 2762 this example 'b │ │ │ │ │ -000400e0: 696e 6469 722e 6827 2069 7320 6e6f 7420 indir.h' is not │ │ │ │ │ -000400f0: 6469 7374 7269 6275 7465 6420 6e6f 7220 distributed nor │ │ │ │ │ -00040100: 696e 7374 616c 6c65 642c 2061 6e64 2069 installed, and i │ │ │ │ │ -00040110: 740a 6973 206e 6f74 2065 7665 6e20 6265 t.is not even be │ │ │ │ │ -00040120: 696e 6720 6275 696c 7420 6f6e 2d74 696d ing built on-tim │ │ │ │ │ -00040130: 652e 2020 4f6e 6520 6d61 7920 776f 6e64 e. One may wond │ │ │ │ │ -00040140: 6572 2069 6620 7468 650a 276e 6f64 6973 er if the.'nodis │ │ │ │ │ -00040150: 745f 666f 6f5f 534f 5552 4345 5320 3d20 t_foo_SOURCES = │ │ │ │ │ -00040160: 6269 6e64 6972 2e68 2720 6c69 6e65 2068 bindir.h' line h │ │ │ │ │ -00040170: 6173 2061 6e79 2075 7365 2061 7420 616c as any use at al │ │ │ │ │ -00040180: 6c2e 2020 5468 6973 206c 696e 650a 7369 l. This line.si │ │ │ │ │ -00040190: 6d70 6c79 2073 7461 7465 7320 7468 6174 mply states that │ │ │ │ │ -000401a0: 2027 6269 6e64 6972 2e68 2720 6973 2061 'bindir.h' is a │ │ │ │ │ -000401b0: 2073 6f75 7263 6520 6f66 2027 666f 6f27 source of 'foo' │ │ │ │ │ -000401c0: 2c20 736f 2066 6f72 2069 6e73 7461 6e63 , so for instanc │ │ │ │ │ -000401d0: 652c 2069 740a 7368 6f75 6c64 2062 6520 e, it.should be │ │ │ │ │ -000401e0: 696e 7370 6563 7465 6420 7768 696c 6520 inspected while │ │ │ │ │ -000401f0: 6765 6e65 7261 7469 6e67 2074 6167 7320 generating tags │ │ │ │ │ -00040200: 282a 6e6f 7465 2054 6167 733a 3a29 2e20 (*note Tags::). │ │ │ │ │ -00040210: 2049 6e20 6f74 6865 720a 776f 7264 732c In other.words, │ │ │ │ │ -00040220: 2069 7420 646f 6573 206e 6f74 2068 656c it does not hel │ │ │ │ │ -00040230: 7020 6f75 7220 7072 6573 656e 7420 7072 p our present pr │ │ │ │ │ -00040240: 6f62 6c65 6d2c 2061 6e64 2074 6865 2062 oblem, and the b │ │ │ │ │ -00040250: 7569 6c64 2077 6f75 6c64 2066 6169 6c0a uild would fail. │ │ │ │ │ -00040260: 6964 656e 7469 6361 6c6c 7920 7769 7468 identically with │ │ │ │ │ -00040270: 6f75 7420 6974 2e0a 0a55 7369 6e67 2027 out it...Using ' │ │ │ │ │ -00040280: 4255 494c 545f 534f 5552 4345 5327 0a2e BUILT_SOURCES'.. │ │ │ │ │ -00040290: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -000402a0: 2e2e 2e2e 0a0a 4120 736f 6c75 7469 6f6e ......A solution │ │ │ │ │ -000402b0: 2069 7320 746f 2072 6571 7569 7265 2027 is to require ' │ │ │ │ │ -000402c0: 6269 6e64 6972 2e68 2720 746f 2062 6520 bindir.h' to be │ │ │ │ │ -000402d0: 6275 696c 7420 6265 666f 7265 2061 6e79 built before any │ │ │ │ │ -000402e0: 7468 696e 6720 656c 7365 2e0a 5468 6973 thing else..This │ │ │ │ │ -000402f0: 2069 7320 7768 6174 2027 4255 494c 545f is what 'BUILT_ │ │ │ │ │ -00040300: 534f 5552 4345 5327 2069 7320 6d65 616e SOURCES' is mean │ │ │ │ │ -00040310: 7420 666f 7220 282a 6e6f 7465 2053 6f75 t for (*note Sou │ │ │ │ │ -00040320: 7263 6573 3a3a 292e 0a0a 2020 2020 2062 rces::)... b │ │ │ │ │ -00040330: 696e 5f50 524f 4752 414d 5320 3d20 666f in_PROGRAMS = fo │ │ │ │ │ -00040340: 6f0a 2020 2020 2066 6f6f 5f53 4f55 5243 o. foo_SOURC │ │ │ │ │ -00040350: 4553 203d 2066 6f6f 2e63 0a20 2020 2020 ES = foo.c. │ │ │ │ │ -00040360: 6e6f 6469 7374 5f66 6f6f 5f53 4f55 5243 nodist_foo_SOURC │ │ │ │ │ -00040370: 4553 203d 2062 696e 6469 722e 680a 2020 ES = bindir.h. │ │ │ │ │ -00040380: 2020 2042 5549 4c54 5f53 4f55 5243 4553 BUILT_SOURCES │ │ │ │ │ -00040390: 203d 2062 696e 6469 722e 680a 2020 2020 = bindir.h. │ │ │ │ │ -000403a0: 2043 4c45 414e 4649 4c45 5320 3d20 6269 CLEANFILES = bi │ │ │ │ │ -000403b0: 6e64 6972 2e68 0a20 2020 2020 6269 6e64 ndir.h. bind │ │ │ │ │ -000403c0: 6972 2e68 3a20 4d61 6b65 6669 6c65 0a20 ir.h: Makefile. │ │ │ │ │ -000403d0: 2020 2020 2020 2020 2020 2020 6563 686f echo │ │ │ │ │ -000403e0: 2027 2364 6566 696e 6520 6269 6e64 6972 '#define bindir │ │ │ │ │ -000403f0: 2022 2428 6269 6e64 6972 2922 2720 3e24 "$(bindir)"' >$ │ │ │ │ │ -00040400: 400a 0a20 2020 5365 6520 686f 7720 2762 @.. See how 'b │ │ │ │ │ -00040410: 696e 6469 722e 6827 2067 6574 7320 6275 indir.h' gets bu │ │ │ │ │ -00040420: 696c 7420 6669 7273 743a 0a0a 2020 2020 ilt first:.. │ │ │ │ │ -00040430: 2025 206d 616b 650a 2020 2020 2065 6368 % make. ech │ │ │ │ │ -00040440: 6f20 2723 6465 6669 6e65 2062 696e 6469 o '#define bindi │ │ │ │ │ -00040450: 7220 222f 7573 722f 6c6f 6361 6c2f 6269 r "/usr/local/bi │ │ │ │ │ -00040460: 6e22 2720 3e62 696e 6469 722e 680a 2020 n"' >bindir.h. │ │ │ │ │ -00040470: 2020 206d 616b 6520 2061 6c6c 2d61 6d0a make all-am. │ │ │ │ │ -00040480: 2020 2020 206d 616b 655b 315d 3a20 456e make[1]: En │ │ │ │ │ -00040490: 7465 7269 6e67 2064 6972 6563 746f 7279 tering directory │ │ │ │ │ -000404a0: 2060 2f68 6f6d 652f 6164 6c2f 746d 7027 `/home/adl/tmp' │ │ │ │ │ -000404b0: 0a20 2020 2020 736f 7572 6365 3d27 666f . source='fo │ │ │ │ │ -000404c0: 6f2e 6327 206f 626a 6563 743d 2766 6f6f o.c' object='foo │ │ │ │ │ -000404d0: 2e6f 2720 6c69 6274 6f6f 6c3d 6e6f 205c .o' libtool=no \ │ │ │ │ │ -000404e0: 0a20 2020 2020 6465 7066 696c 653d 272e . depfile='. │ │ │ │ │ -000404f0: 6465 7073 2f66 6f6f 2e50 6f27 2074 6d70 deps/foo.Po' tmp │ │ │ │ │ -00040500: 6465 7066 696c 653d 272e 6465 7073 2f66 depfile='.deps/f │ │ │ │ │ -00040510: 6f6f 2e54 506f 2720 5c0a 2020 2020 2064 oo.TPo' \. d │ │ │ │ │ -00040520: 6570 6d6f 6465 3d67 6363 202f 6269 6e2f epmode=gcc /bin/ │ │ │ │ │ -00040530: 7368 202e 2f64 6570 636f 6d70 205c 0a20 sh ./depcomp \. │ │ │ │ │ -00040540: 2020 2020 6763 6320 2d49 2e20 2d49 2e20 gcc -I. -I. │ │ │ │ │ -00040550: 2d67 202d 4f32 202d 6320 6074 6573 7420 -g -O2 -c `test │ │ │ │ │ -00040560: 2d66 2027 666f 6f2e 6327 207c 7c20 6563 -f 'foo.c' || ec │ │ │ │ │ -00040570: 686f 2027 2e2f 2760 666f 6f2e 630a 2020 ho './'`foo.c. │ │ │ │ │ -00040580: 2020 2067 6363 2020 2d67 202d 4f32 2020 gcc -g -O2 │ │ │ │ │ -00040590: 202d 6f20 666f 6f20 2066 6f6f 2e6f 0a20 -o foo foo.o. │ │ │ │ │ -000405a0: 2020 2020 6d61 6b65 5b31 5d3a 204c 6561 make[1]: Lea │ │ │ │ │ -000405b0: 7669 6e67 2064 6972 6563 746f 7279 2060 ving directory ` │ │ │ │ │ -000405c0: 2f68 6f6d 652f 6164 6c2f 746d 7027 0a0a /home/adl/tmp'.. │ │ │ │ │ -000405d0: 2020 2048 6f77 6576 6572 2c20 6173 2073 However, as s │ │ │ │ │ -000405e0: 6169 6420 6561 726c 6965 722c 2027 4255 aid earlier, 'BU │ │ │ │ │ -000405f0: 494c 545f 534f 5552 4345 5327 2061 7070 ILT_SOURCES' app │ │ │ │ │ -00040600: 6c69 6573 206f 6e6c 7920 746f 2074 6865 lies only to the │ │ │ │ │ -00040610: 2027 616c 6c27 2c0a 2763 6865 636b 272c 'all',.'check', │ │ │ │ │ -00040620: 2061 6e64 2027 696e 7374 616c 6c27 2074 and 'install' t │ │ │ │ │ -00040630: 6172 6765 7473 2e20 2049 7420 7374 696c argets. It stil │ │ │ │ │ -00040640: 6c20 6661 696c 7320 6966 2079 6f75 2074 l fails if you t │ │ │ │ │ -00040650: 7279 2074 6f20 7275 6e20 276d 616b 650a ry to run 'make. │ │ │ │ │ -00040660: 666f 6f27 2065 7870 6c69 6369 746c 793a foo' explicitly: │ │ │ │ │ -00040670: 0a0a 2020 2020 2025 206d 616b 6520 636c .. % make cl │ │ │ │ │ -00040680: 6561 6e0a 2020 2020 2074 6573 7420 2d7a ean. test -z │ │ │ │ │ -00040690: 2022 6269 6e64 6972 2e68 2220 7c7c 2072 "bindir.h" || r │ │ │ │ │ -000406a0: 6d20 2d66 2062 696e 6469 722e 680a 2020 m -f bindir.h. │ │ │ │ │ -000406b0: 2020 2074 6573 7420 2d7a 2022 666f 6f22 test -z "foo" │ │ │ │ │ -000406c0: 207c 7c20 726d 202d 6620 666f 6f0a 2020 || rm -f foo. │ │ │ │ │ -000406d0: 2020 2072 6d20 2d66 202a 2e6f 0a20 2020 rm -f *.o. │ │ │ │ │ -000406e0: 2020 2520 3a20 3e20 2e64 6570 732f 666f % : > .deps/fo │ │ │ │ │ -000406f0: 6f2e 506f 2023 2053 7570 7072 6573 7320 o.Po # Suppress │ │ │ │ │ -00040700: 7072 6576 696f 7573 6c79 2072 6563 6f72 previously recor │ │ │ │ │ -00040710: 6465 6420 6465 7065 6e64 656e 6369 6573 ded dependencies │ │ │ │ │ -00040720: 0a20 2020 2020 2520 6d61 6b65 2066 6f6f . % make foo │ │ │ │ │ -00040730: 0a20 2020 2020 736f 7572 6365 3d27 666f . source='fo │ │ │ │ │ -00040740: 6f2e 6327 206f 626a 6563 743d 2766 6f6f o.c' object='foo │ │ │ │ │ -00040750: 2e6f 2720 6c69 6274 6f6f 6c3d 6e6f 205c .o' libtool=no \ │ │ │ │ │ -00040760: 0a20 2020 2020 6465 7066 696c 653d 272e . depfile='. │ │ │ │ │ -00040770: 6465 7073 2f66 6f6f 2e50 6f27 2074 6d70 deps/foo.Po' tmp │ │ │ │ │ -00040780: 6465 7066 696c 653d 272e 6465 7073 2f66 depfile='.deps/f │ │ │ │ │ -00040790: 6f6f 2e54 506f 2720 5c0a 2020 2020 2064 oo.TPo' \. d │ │ │ │ │ -000407a0: 6570 6d6f 6465 3d67 6363 202f 6269 6e2f epmode=gcc /bin/ │ │ │ │ │ -000407b0: 7368 202e 2f64 6570 636f 6d70 205c 0a20 sh ./depcomp \. │ │ │ │ │ -000407c0: 2020 2020 6763 6320 2d49 2e20 2d49 2e20 gcc -I. -I. │ │ │ │ │ -000407d0: 2d67 202d 4f32 202d 6320 6074 6573 7420 -g -O2 -c `test │ │ │ │ │ -000407e0: 2d66 2027 666f 6f2e 6327 207c 7c20 6563 -f 'foo.c' || ec │ │ │ │ │ -000407f0: 686f 2027 2e2f 2760 666f 6f2e 630a 2020 ho './'`foo.c. │ │ │ │ │ -00040800: 2020 2066 6f6f 2e63 3a32 3a20 6269 6e64 foo.c:2: bind │ │ │ │ │ -00040810: 6972 2e68 3a20 4e6f 2073 7563 6820 6669 ir.h: No such fi │ │ │ │ │ -00040820: 6c65 206f 7220 6469 7265 6374 6f72 790a le or directory. │ │ │ │ │ -00040830: 2020 2020 206d 616b 653a 202a 2a2a 205b make: *** [ │ │ │ │ │ -00040840: 666f 6f2e 6f5d 2045 7272 6f72 2031 0a0a foo.o] Error 1.. │ │ │ │ │ -00040850: 5265 636f 7264 696e 6720 4465 7065 6e64 Recording Depend │ │ │ │ │ -00040860: 656e 6369 6573 206d 616e 7561 6c6c 790a encies manually. │ │ │ │ │ -00040870: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -00040880: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a ................ │ │ │ │ │ -00040890: 0a55 7375 616c 6c79 2070 656f 706c 6520 .Usually people │ │ │ │ │ -000408a0: 6172 6520 6861 7070 7920 656e 6f75 6768 are happy enough │ │ │ │ │ -000408b0: 2077 6974 6820 2742 5549 4c54 5f53 4f55 with 'BUILT_SOU │ │ │ │ │ -000408c0: 5243 4553 2720 6265 6361 7573 6520 7468 RCES' because th │ │ │ │ │ -000408d0: 6579 206e 6576 6572 0a62 7569 6c64 2074 ey never.build t │ │ │ │ │ -000408e0: 6172 6765 7473 2073 7563 6820 6173 2027 argets such as ' │ │ │ │ │ -000408f0: 6d61 6b65 2066 6f6f 2720 6265 666f 7265 make foo' before │ │ │ │ │ -00040900: 2027 6d61 6b65 2061 6c6c 272c 2061 7320 'make all', as │ │ │ │ │ -00040910: 696e 2074 6865 2070 7265 7669 6f75 730a in the previous. │ │ │ │ │ -00040920: 6578 616d 706c 652e 2020 486f 7765 7665 example. Howeve │ │ │ │ │ -00040930: 7220 6966 2074 6869 7320 6d61 7474 6572 r if this matter │ │ │ │ │ -00040940: 7320 746f 2079 6f75 2c20 796f 7520 6361 s to you, you ca │ │ │ │ │ -00040950: 6e20 6176 6f69 6420 2742 5549 4c54 5f53 n avoid 'BUILT_S │ │ │ │ │ -00040960: 4f55 5243 4553 270a 616e 6420 7265 636f OURCES'.and reco │ │ │ │ │ -00040970: 7264 2073 7563 6820 6465 7065 6e64 656e rd such dependen │ │ │ │ │ -00040980: 6369 6573 2065 7870 6c69 6369 746c 7920 cies explicitly │ │ │ │ │ -00040990: 696e 2074 6865 2027 4d61 6b65 6669 6c65 in the 'Makefile │ │ │ │ │ -000409a0: 2e61 6d27 2e0a 0a20 2020 2020 6269 6e5f .am'... bin_ │ │ │ │ │ -000409b0: 5052 4f47 5241 4d53 203d 2066 6f6f 0a20 PROGRAMS = foo. │ │ │ │ │ -000409c0: 2020 2020 666f 6f5f 534f 5552 4345 5320 foo_SOURCES │ │ │ │ │ -000409d0: 3d20 666f 6f2e 630a 2020 2020 206e 6f64 = foo.c. nod │ │ │ │ │ -000409e0: 6973 745f 666f 6f5f 534f 5552 4345 5320 ist_foo_SOURCES │ │ │ │ │ -000409f0: 3d20 6269 6e64 6972 2e68 0a20 2020 2020 = bindir.h. │ │ │ │ │ -00040a00: 666f 6f2e 2428 4f42 4a45 5854 293a 2062 foo.$(OBJEXT): b │ │ │ │ │ -00040a10: 696e 6469 722e 680a 2020 2020 2043 4c45 indir.h. CLE │ │ │ │ │ -00040a20: 414e 4649 4c45 5320 3d20 6269 6e64 6972 ANFILES = bindir │ │ │ │ │ -00040a30: 2e68 0a20 2020 2020 6269 6e64 6972 2e68 .h. bindir.h │ │ │ │ │ -00040a40: 3a20 4d61 6b65 6669 6c65 0a20 2020 2020 : Makefile. │ │ │ │ │ -00040a50: 2020 2020 2020 2020 6563 686f 2027 2364 echo '#d │ │ │ │ │ -00040a60: 6566 696e 6520 6269 6e64 6972 2022 2428 efine bindir "$( │ │ │ │ │ -00040a70: 6269 6e64 6972 2922 2720 3e24 400a 0a20 bindir)"' >$@.. │ │ │ │ │ -00040a80: 2020 596f 7520 646f 6e27 7420 6861 7665 You don't have │ │ │ │ │ -00040a90: 2074 6f20 6c69 7374 205f 616c 6c5f 2074 to list _all_ t │ │ │ │ │ -00040aa0: 6865 2064 6570 656e 6465 6e63 6965 7320 he dependencies │ │ │ │ │ -00040ab0: 6f66 2027 666f 6f2e 6f27 2065 7870 6c69 of 'foo.o' expli │ │ │ │ │ -00040ac0: 6369 746c 792c 0a6f 6e6c 7920 7468 6f73 citly,.only thos │ │ │ │ │ -00040ad0: 6520 7468 6174 206d 6967 6874 206e 6565 e that might nee │ │ │ │ │ -00040ae0: 6420 746f 2062 6520 6275 696c 742e 2020 d to be built. │ │ │ │ │ -00040af0: 4966 2061 2064 6570 656e 6465 6e63 7920 If a dependency │ │ │ │ │ -00040b00: 616c 7265 6164 7920 6578 6973 7473 2c0a already exists,. │ │ │ │ │ -00040b10: 6974 2077 696c 6c20 6e6f 7420 6869 6e64 it will not hind │ │ │ │ │ -00040b20: 6572 2074 6865 2066 6972 7374 2063 6f6d er the first com │ │ │ │ │ -00040b30: 7069 6c61 7469 6f6e 2061 6e64 2077 696c pilation and wil │ │ │ │ │ -00040b40: 6c20 6265 2072 6563 6f72 6465 6420 6279 l be recorded by │ │ │ │ │ -00040b50: 2074 6865 0a6e 6f72 6d61 6c20 6465 7065 the.normal depe │ │ │ │ │ -00040b60: 6e64 656e 6379 2074 7261 636b 696e 6720 ndency tracking │ │ │ │ │ -00040b70: 636f 6465 2e20 2028 4e6f 7465 2074 6861 code. (Note tha │ │ │ │ │ -00040b80: 7420 6166 7465 7220 7468 6973 2066 6972 t after this fir │ │ │ │ │ -00040b90: 7374 0a63 6f6d 7069 6c61 7469 6f6e 2074 st.compilation t │ │ │ │ │ -00040ba0: 6865 2064 6570 656e 6465 6e63 7920 7472 he dependency tr │ │ │ │ │ -00040bb0: 6163 6b69 6e67 2063 6f64 6520 7769 6c6c acking code will │ │ │ │ │ -00040bc0: 2061 6c73 6f20 6861 7665 2072 6563 6f72 also have recor │ │ │ │ │ -00040bd0: 6465 6420 7468 650a 6465 7065 6e64 656e ded the.dependen │ │ │ │ │ -00040be0: 6379 2062 6574 7765 656e 2027 666f 6f2e cy between 'foo. │ │ │ │ │ -00040bf0: 6f27 2061 6e64 2027 6269 6e64 6972 2e68 o' and 'bindir.h │ │ │ │ │ -00040c00: 273b 2073 6f20 6f75 7220 6578 706c 6963 '; so our explic │ │ │ │ │ -00040c10: 6974 2064 6570 656e 6465 6e63 7920 6973 it dependency is │ │ │ │ │ -00040c20: 0a72 6561 6c6c 7920 7573 6566 756c 2074 .really useful t │ │ │ │ │ -00040c30: 6f20 7468 6520 6669 7273 7420 6275 696c o the first buil │ │ │ │ │ -00040c40: 6420 6f6e 6c79 2e29 0a0a 2020 2041 6464 d only.).. Add │ │ │ │ │ -00040c50: 696e 6720 6578 706c 6963 6974 2064 6570 ing explicit dep │ │ │ │ │ -00040c60: 656e 6465 6e63 6965 7320 6c69 6b65 2074 endencies like t │ │ │ │ │ -00040c70: 6869 7320 6361 6e20 6265 2061 2062 6974 his can be a bit │ │ │ │ │ -00040c80: 2064 616e 6765 726f 7573 2069 6620 796f dangerous if yo │ │ │ │ │ -00040c90: 750a 6172 6520 6e6f 7420 6361 7265 6675 u.are not carefu │ │ │ │ │ -00040ca0: 6c20 656e 6f75 6768 2e20 2054 6869 7320 l enough. This │ │ │ │ │ -00040cb0: 6973 2064 7565 2074 6f20 7468 6520 7761 is due to the wa │ │ │ │ │ -00040cc0: 7920 4175 746f 6d61 6b65 2074 7269 6573 y Automake tries │ │ │ │ │ -00040cd0: 206e 6f74 2074 6f0a 6f76 6572 7772 6974 not to.overwrit │ │ │ │ │ -00040ce0: 6520 796f 7572 2072 756c 6573 2028 6974 e your rules (it │ │ │ │ │ -00040cf0: 2061 7373 756d 6573 2079 6f75 206b 6e6f assumes you kno │ │ │ │ │ -00040d00: 7720 6265 7474 6572 2074 6861 6e20 6974 w better than it │ │ │ │ │ -00040d10: 292e 0a27 666f 6f2e 2428 4f42 4a45 5854 )..'foo.$(OBJEXT │ │ │ │ │ -00040d20: 293a 2062 696e 6469 722e 6827 2073 7570 ): bindir.h' sup │ │ │ │ │ -00040d30: 6572 7365 6465 7320 616e 7920 7275 6c65 ersedes any rule │ │ │ │ │ -00040d40: 2041 7574 6f6d 616b 6520 6d61 7920 7761 Automake may wa │ │ │ │ │ -00040d50: 6e74 2074 6f0a 6f75 7470 7574 2074 6f20 nt to.output to │ │ │ │ │ -00040d60: 6275 696c 6420 2766 6f6f 2e24 284f 424a build 'foo.$(OBJ │ │ │ │ │ -00040d70: 4558 5429 272e 2020 4974 2068 6170 7065 EXT)'. It happe │ │ │ │ │ -00040d80: 6e73 2074 6f20 776f 726b 2069 6e20 7468 ns to work in th │ │ │ │ │ -00040d90: 6973 2063 6173 650a 6265 6361 7573 6520 is case.because │ │ │ │ │ -00040da0: 4175 746f 6d61 6b65 2064 6f65 736e 2774 Automake doesn't │ │ │ │ │ -00040db0: 2068 6176 6520 746f 206f 7574 7075 7420 have to output │ │ │ │ │ -00040dc0: 616e 7920 2766 6f6f 2e24 284f 424a 4558 any 'foo.$(OBJEX │ │ │ │ │ -00040dd0: 5429 3a27 2074 6172 6765 743a 2069 740a T):' target: it. │ │ │ │ │ -00040de0: 7265 6c69 6573 206f 6e20 6120 7375 6666 relies on a suff │ │ │ │ │ -00040df0: 6978 2072 756c 6520 696e 7374 6561 6420 ix rule instead │ │ │ │ │ -00040e00: 2869 2e65 2e2c 2027 2e63 2e24 284f 424a (i.e., '.c.$(OBJ │ │ │ │ │ -00040e10: 4558 5429 3a27 292e 2020 416c 7761 7973 EXT):'). Always │ │ │ │ │ -00040e20: 2063 6865 636b 0a74 6865 2067 656e 6572 check.the gener │ │ │ │ │ -00040e30: 6174 6564 2027 4d61 6b65 6669 6c65 2e69 ated 'Makefile.i │ │ │ │ │ -00040e40: 6e27 2069 6620 796f 7520 646f 2074 6869 n' if you do thi │ │ │ │ │ -00040e50: 732e 0a0a 4275 696c 6420 2762 696e 6469 s...Build 'bindi │ │ │ │ │ -00040e60: 722e 6827 2066 726f 6d20 2763 6f6e 6669 r.h' from 'confi │ │ │ │ │ -00040e70: 6775 7265 270a 2e2e 2e2e 2e2e 2e2e 2e2e gure'........... │ │ │ │ │ +0003fb30: 2d2d 2d0a 0a53 7570 706f 7365 2074 6861 ---..Suppose tha │ │ │ │ │ +0003fb40: 7420 2766 6f6f 2e63 2720 696e 636c 7564 t 'foo.c' includ │ │ │ │ │ +0003fb50: 6573 2027 6269 6e64 6972 2e68 272c 2077 es 'bindir.h', w │ │ │ │ │ +0003fb60: 6869 6368 2069 730a 696e 7374 616c 6c61 hich is.installa │ │ │ │ │ +0003fb70: 7469 6f6e 2d64 6570 656e 6465 6e74 2061 tion-dependent a │ │ │ │ │ +0003fb80: 6e64 206e 6f74 2064 6973 7472 6962 7574 nd not distribut │ │ │ │ │ +0003fb90: 6564 3a20 6974 206e 6565 6473 2074 6f20 ed: it needs to │ │ │ │ │ +0003fba0: 6265 2062 7569 6c74 2e20 2048 6572 650a be built. Here. │ │ │ │ │ +0003fbb0: 2762 696e 6469 722e 6827 2064 6566 696e 'bindir.h' defin │ │ │ │ │ +0003fbc0: 6573 2074 6865 2070 7265 7072 6f63 6573 es the preproces │ │ │ │ │ +0003fbd0: 736f 7220 6d61 6372 6f20 2762 696e 6469 sor macro 'bindi │ │ │ │ │ +0003fbe0: 7227 2074 6f20 7468 6520 7661 6c75 6520 r' to the value │ │ │ │ │ +0003fbf0: 6f66 2074 6865 0a27 6d61 6b65 2720 7661 of the.'make' va │ │ │ │ │ +0003fc00: 7269 6162 6c65 2027 6269 6e64 6972 2720 riable 'bindir' │ │ │ │ │ +0003fc10: 2869 6e68 6572 6974 6564 2066 726f 6d20 (inherited from │ │ │ │ │ +0003fc20: 2763 6f6e 6669 6775 7265 2729 2e0a 0a20 'configure')... │ │ │ │ │ +0003fc30: 2020 5765 2073 7567 6765 7374 2073 6576 We suggest sev │ │ │ │ │ +0003fc40: 6572 616c 2069 6d70 6c65 6d65 6e74 6174 eral implementat │ │ │ │ │ +0003fc50: 696f 6e73 2062 656c 6f77 2e20 2049 7427 ions below. It' │ │ │ │ │ +0003fc60: 7320 6e6f 7420 6d65 616e 7420 746f 2062 s not meant to b │ │ │ │ │ +0003fc70: 6520 616e 0a65 7868 6175 7374 6976 6520 e an.exhaustive │ │ │ │ │ +0003fc80: 6c69 7374 696e 6720 6f66 2061 6c6c 2077 listing of all w │ │ │ │ │ +0003fc90: 6179 7320 746f 2068 616e 646c 6520 6275 ays to handle bu │ │ │ │ │ +0003fca0: 696c 7420 736f 7572 6365 732c 2062 7574 ilt sources, but │ │ │ │ │ +0003fcb0: 2069 7420 7769 6c6c 2067 6976 650a 796f it will give.yo │ │ │ │ │ +0003fcc0: 7520 6120 6665 7720 6964 6561 7320 6966 u a few ideas if │ │ │ │ │ +0003fcd0: 2079 6f75 2065 6e63 6f75 6e74 6572 2074 you encounter t │ │ │ │ │ +0003fce0: 6869 7320 6973 7375 652e 0a0a 4669 7273 his issue...Firs │ │ │ │ │ +0003fcf0: 7420 5472 790a 2e2e 2e2e 2e2e 2e2e 2e0a t Try........... │ │ │ │ │ +0003fd00: 0a54 6869 7320 6669 7273 7420 696d 706c .This first impl │ │ │ │ │ +0003fd10: 656d 656e 7461 7469 6f6e 2077 696c 6c20 ementation will │ │ │ │ │ +0003fd20: 696c 6c75 7374 7261 7465 2074 6865 2062 illustrate the b │ │ │ │ │ +0003fd30: 6f6f 7473 7472 6170 2069 7373 7565 206d ootstrap issue m │ │ │ │ │ +0003fd40: 656e 7469 6f6e 6564 0a69 6e20 7468 6520 entioned.in the │ │ │ │ │ +0003fd50: 7072 6576 696f 7573 2073 6563 7469 6f6e previous section │ │ │ │ │ +0003fd60: 2028 2a6e 6f74 6520 536f 7572 6365 733a (*note Sources: │ │ │ │ │ +0003fd70: 3a29 2e0a 0a20 2020 4865 7265 2069 7320 :)... Here is │ │ │ │ │ +0003fd80: 6120 7465 6e74 6174 6976 6520 274d 616b a tentative 'Mak │ │ │ │ │ +0003fd90: 6566 696c 652e 616d 272e 0a0a 2020 2020 efile.am'... │ │ │ │ │ +0003fda0: 2023 2054 6869 7320 776f 6e27 7420 776f # This won't wo │ │ │ │ │ +0003fdb0: 726b 2e0a 2020 2020 2062 696e 5f50 524f rk.. bin_PRO │ │ │ │ │ +0003fdc0: 4752 414d 5320 3d20 666f 6f0a 2020 2020 GRAMS = foo. │ │ │ │ │ +0003fdd0: 2066 6f6f 5f53 4f55 5243 4553 203d 2066 foo_SOURCES = f │ │ │ │ │ +0003fde0: 6f6f 2e63 0a20 2020 2020 6e6f 6469 7374 oo.c. nodist │ │ │ │ │ +0003fdf0: 5f66 6f6f 5f53 4f55 5243 4553 203d 2062 _foo_SOURCES = b │ │ │ │ │ +0003fe00: 696e 6469 722e 680a 2020 2020 2043 4c45 indir.h. CLE │ │ │ │ │ +0003fe10: 414e 4649 4c45 5320 3d20 6269 6e64 6972 ANFILES = bindir │ │ │ │ │ +0003fe20: 2e68 0a20 2020 2020 6269 6e64 6972 2e68 .h. bindir.h │ │ │ │ │ +0003fe30: 3a20 4d61 6b65 6669 6c65 0a20 2020 2020 : Makefile. │ │ │ │ │ +0003fe40: 2020 2020 2020 2020 6563 686f 2027 2364 echo '#d │ │ │ │ │ +0003fe50: 6566 696e 6520 6269 6e64 6972 2022 2428 efine bindir "$( │ │ │ │ │ +0003fe60: 6269 6e64 6972 2922 2720 3e24 400a 0a20 bindir)"' >$@.. │ │ │ │ │ +0003fe70: 2020 5468 6973 2073 6574 7570 2064 6f65 This setup doe │ │ │ │ │ +0003fe80: 736e 2774 2077 6f72 6b2c 2062 6563 6175 sn't work, becau │ │ │ │ │ +0003fe90: 7365 2041 7574 6f6d 616b 6520 646f 6573 se Automake does │ │ │ │ │ +0003fea0: 6e27 7420 6b6e 6f77 2074 6861 7420 2766 n't know that 'f │ │ │ │ │ +0003feb0: 6f6f 2e63 270a 696e 636c 7564 6573 2027 oo.c'.includes ' │ │ │ │ │ +0003fec0: 6269 6e64 6972 2e68 272e 2020 5265 6d65 bindir.h'. Reme │ │ │ │ │ +0003fed0: 6d62 6572 2c20 6175 746f 6d61 7469 6320 mber, automatic │ │ │ │ │ +0003fee0: 6465 7065 6e64 656e 6379 2074 7261 636b dependency track │ │ │ │ │ +0003fef0: 696e 6720 776f 726b 7320 6173 2061 0a73 ing works as a.s │ │ │ │ │ +0003ff00: 6964 652d 6566 6665 6374 206f 6620 636f ide-effect of co │ │ │ │ │ +0003ff10: 6d70 696c 6174 696f 6e2c 2073 6f20 7468 mpilation, so th │ │ │ │ │ +0003ff20: 6520 6465 7065 6e64 656e 6369 6573 206f e dependencies o │ │ │ │ │ +0003ff30: 6620 2766 6f6f 2e6f 2720 7769 6c6c 2062 f 'foo.o' will b │ │ │ │ │ +0003ff40: 6520 6b6e 6f77 6e0a 6f6e 6c79 2061 6674 e known.only aft │ │ │ │ │ +0003ff50: 6572 2027 666f 6f2e 6f27 2068 6173 2062 er 'foo.o' has b │ │ │ │ │ +0003ff60: 6565 6e20 636f 6d70 696c 6564 2028 2a6e een compiled (*n │ │ │ │ │ +0003ff70: 6f74 6520 4465 7065 6e64 656e 6369 6573 ote Dependencies │ │ │ │ │ +0003ff80: 3a3a 292e 2020 5468 650a 7379 6d70 746f ::). The.sympto │ │ │ │ │ +0003ff90: 6d20 6973 2061 7320 666f 6c6c 6f77 732e m is as follows. │ │ │ │ │ +0003ffa0: 0a0a 2020 2020 2025 206d 616b 650a 2020 .. % make. │ │ │ │ │ +0003ffb0: 2020 2073 6f75 7263 653d 2766 6f6f 2e63 source='foo.c │ │ │ │ │ +0003ffc0: 2720 6f62 6a65 6374 3d27 666f 6f2e 6f27 ' object='foo.o' │ │ │ │ │ +0003ffd0: 206c 6962 746f 6f6c 3d6e 6f20 5c0a 2020 libtool=no \. │ │ │ │ │ +0003ffe0: 2020 2064 6570 6669 6c65 3d27 2e64 6570 depfile='.dep │ │ │ │ │ +0003fff0: 732f 666f 6f2e 506f 2720 746d 7064 6570 s/foo.Po' tmpdep │ │ │ │ │ +00040000: 6669 6c65 3d27 2e64 6570 732f 666f 6f2e file='.deps/foo. │ │ │ │ │ +00040010: 5450 6f27 205c 0a20 2020 2020 6465 706d TPo' \. depm │ │ │ │ │ +00040020: 6f64 653d 6763 6320 2f62 696e 2f73 6820 ode=gcc /bin/sh │ │ │ │ │ +00040030: 2e2f 6465 7063 6f6d 7020 5c0a 2020 2020 ./depcomp \. │ │ │ │ │ +00040040: 2067 6363 202d 492e 202d 492e 202d 6720 gcc -I. -I. -g │ │ │ │ │ +00040050: 2d4f 3220 2d63 2060 7465 7374 202d 6620 -O2 -c `test -f │ │ │ │ │ +00040060: 2766 6f6f 2e63 2720 7c7c 2065 6368 6f20 'foo.c' || echo │ │ │ │ │ +00040070: 272e 2f27 6066 6f6f 2e63 0a20 2020 2020 './'`foo.c. │ │ │ │ │ +00040080: 666f 6f2e 633a 323a 2062 696e 6469 722e foo.c:2: bindir. │ │ │ │ │ +00040090: 683a 204e 6f20 7375 6368 2066 696c 6520 h: No such file │ │ │ │ │ +000400a0: 6f72 2064 6972 6563 746f 7279 0a20 2020 or directory. │ │ │ │ │ +000400b0: 2020 6d61 6b65 3a20 2a2a 2a20 5b66 6f6f make: *** [foo │ │ │ │ │ +000400c0: 2e6f 5d20 4572 726f 7220 310a 0a20 2020 .o] Error 1.. │ │ │ │ │ +000400d0: 496e 2074 6869 7320 6578 616d 706c 6520 In this example │ │ │ │ │ +000400e0: 2762 696e 6469 722e 6827 2069 7320 6e6f 'bindir.h' is no │ │ │ │ │ +000400f0: 7420 6469 7374 7269 6275 7465 6420 6e6f t distributed no │ │ │ │ │ +00040100: 7220 696e 7374 616c 6c65 642c 2061 6e64 r installed, and │ │ │ │ │ +00040110: 2069 740a 6973 206e 6f74 2065 7665 6e20 it.is not even │ │ │ │ │ +00040120: 6265 696e 6720 6275 696c 7420 6f6e 2d74 being built on-t │ │ │ │ │ +00040130: 696d 652e 2020 4f6e 6520 6d61 7920 776f ime. One may wo │ │ │ │ │ +00040140: 6e64 6572 2069 6620 7468 650a 276e 6f64 nder if the.'nod │ │ │ │ │ +00040150: 6973 745f 666f 6f5f 534f 5552 4345 5320 ist_foo_SOURCES │ │ │ │ │ +00040160: 3d20 6269 6e64 6972 2e68 2720 6c69 6e65 = bindir.h' line │ │ │ │ │ +00040170: 2068 6173 2061 6e79 2075 7365 2061 7420 has any use at │ │ │ │ │ +00040180: 616c 6c2e 2020 5468 6973 206c 696e 650a all. This line. │ │ │ │ │ +00040190: 7369 6d70 6c79 2073 7461 7465 7320 7468 simply states th │ │ │ │ │ +000401a0: 6174 2027 6269 6e64 6972 2e68 2720 6973 at 'bindir.h' is │ │ │ │ │ +000401b0: 2061 2073 6f75 7263 6520 6f66 2027 666f a source of 'fo │ │ │ │ │ +000401c0: 6f27 2c20 736f 2066 6f72 2069 6e73 7461 o', so for insta │ │ │ │ │ +000401d0: 6e63 652c 2069 740a 7368 6f75 6c64 2062 nce, it.should b │ │ │ │ │ +000401e0: 6520 696e 7370 6563 7465 6420 7768 696c e inspected whil │ │ │ │ │ +000401f0: 6520 6765 6e65 7261 7469 6e67 2074 6167 e generating tag │ │ │ │ │ +00040200: 7320 282a 6e6f 7465 2054 6167 733a 3a29 s (*note Tags::) │ │ │ │ │ +00040210: 2e20 2049 6e20 6f74 6865 720a 776f 7264 . In other.word │ │ │ │ │ +00040220: 732c 2069 7420 646f 6573 206e 6f74 2068 s, it does not h │ │ │ │ │ +00040230: 656c 7020 6f75 7220 7072 6573 656e 7420 elp our present │ │ │ │ │ +00040240: 7072 6f62 6c65 6d2c 2061 6e64 2074 6865 problem, and the │ │ │ │ │ +00040250: 2062 7569 6c64 2077 6f75 6c64 2066 6169 build would fai │ │ │ │ │ +00040260: 6c0a 6964 656e 7469 6361 6c6c 7920 7769 l.identically wi │ │ │ │ │ +00040270: 7468 6f75 7420 6974 2e0a 0a55 7369 6e67 thout it...Using │ │ │ │ │ +00040280: 2027 4255 494c 545f 534f 5552 4345 5327 'BUILT_SOURCES' │ │ │ │ │ +00040290: 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ +000402a0: 2e2e 2e2e 2e2e 0a0a 4120 736f 6c75 7469 ........A soluti │ │ │ │ │ +000402b0: 6f6e 2069 7320 746f 2072 6571 7569 7265 on is to require │ │ │ │ │ +000402c0: 2027 6269 6e64 6972 2e68 2720 746f 2062 'bindir.h' to b │ │ │ │ │ +000402d0: 6520 6275 696c 7420 6265 666f 7265 2061 e built before a │ │ │ │ │ +000402e0: 6e79 7468 696e 6720 656c 7365 2e0a 5468 nything else..Th │ │ │ │ │ +000402f0: 6973 2069 7320 7768 6174 2027 4255 494c is is what 'BUIL │ │ │ │ │ +00040300: 545f 534f 5552 4345 5327 2069 7320 6d65 T_SOURCES' is me │ │ │ │ │ +00040310: 616e 7420 666f 7220 282a 6e6f 7465 2053 ant for (*note S │ │ │ │ │ +00040320: 6f75 7263 6573 3a3a 292e 0a0a 2020 2020 ources::)... │ │ │ │ │ +00040330: 2062 696e 5f50 524f 4752 414d 5320 3d20 bin_PROGRAMS = │ │ │ │ │ +00040340: 666f 6f0a 2020 2020 2066 6f6f 5f53 4f55 foo. foo_SOU │ │ │ │ │ +00040350: 5243 4553 203d 2066 6f6f 2e63 0a20 2020 RCES = foo.c. │ │ │ │ │ +00040360: 2020 6e6f 6469 7374 5f66 6f6f 5f53 4f55 nodist_foo_SOU │ │ │ │ │ +00040370: 5243 4553 203d 2062 696e 6469 722e 680a RCES = bindir.h. │ │ │ │ │ +00040380: 2020 2020 2042 5549 4c54 5f53 4f55 5243 BUILT_SOURC │ │ │ │ │ +00040390: 4553 203d 2062 696e 6469 722e 680a 2020 ES = bindir.h. │ │ │ │ │ +000403a0: 2020 2043 4c45 414e 4649 4c45 5320 3d20 CLEANFILES = │ │ │ │ │ +000403b0: 6269 6e64 6972 2e68 0a20 2020 2020 6269 bindir.h. bi │ │ │ │ │ +000403c0: 6e64 6972 2e68 3a20 4d61 6b65 6669 6c65 ndir.h: Makefile │ │ │ │ │ +000403d0: 0a20 2020 2020 2020 2020 2020 2020 6563 . ec │ │ │ │ │ +000403e0: 686f 2027 2364 6566 696e 6520 6269 6e64 ho '#define bind │ │ │ │ │ +000403f0: 6972 2022 2428 6269 6e64 6972 2922 2720 ir "$(bindir)"' │ │ │ │ │ +00040400: 3e24 400a 0a20 2020 5365 6520 686f 7720 >$@.. See how │ │ │ │ │ +00040410: 2762 696e 6469 722e 6827 2067 6574 7320 'bindir.h' gets │ │ │ │ │ +00040420: 6275 696c 7420 6669 7273 743a 0a0a 2020 built first:.. │ │ │ │ │ +00040430: 2020 2025 206d 616b 650a 2020 2020 2065 % make. e │ │ │ │ │ +00040440: 6368 6f20 2723 6465 6669 6e65 2062 696e cho '#define bin │ │ │ │ │ +00040450: 6469 7220 222f 7573 722f 6c6f 6361 6c2f dir "/usr/local/ │ │ │ │ │ +00040460: 6269 6e22 2720 3e62 696e 6469 722e 680a bin"' >bindir.h. │ │ │ │ │ +00040470: 2020 2020 206d 616b 6520 2061 6c6c 2d61 make all-a │ │ │ │ │ +00040480: 6d0a 2020 2020 206d 616b 655b 315d 3a20 m. make[1]: │ │ │ │ │ +00040490: 456e 7465 7269 6e67 2064 6972 6563 746f Entering directo │ │ │ │ │ +000404a0: 7279 2060 2f68 6f6d 652f 6164 6c2f 746d ry `/home/adl/tm │ │ │ │ │ +000404b0: 7027 0a20 2020 2020 736f 7572 6365 3d27 p'. source=' │ │ │ │ │ +000404c0: 666f 6f2e 6327 206f 626a 6563 743d 2766 foo.c' object='f │ │ │ │ │ +000404d0: 6f6f 2e6f 2720 6c69 6274 6f6f 6c3d 6e6f oo.o' libtool=no │ │ │ │ │ +000404e0: 205c 0a20 2020 2020 6465 7066 696c 653d \. depfile= │ │ │ │ │ +000404f0: 272e 6465 7073 2f66 6f6f 2e50 6f27 2074 '.deps/foo.Po' t │ │ │ │ │ +00040500: 6d70 6465 7066 696c 653d 272e 6465 7073 mpdepfile='.deps │ │ │ │ │ +00040510: 2f66 6f6f 2e54 506f 2720 5c0a 2020 2020 /foo.TPo' \. │ │ │ │ │ +00040520: 2064 6570 6d6f 6465 3d67 6363 202f 6269 depmode=gcc /bi │ │ │ │ │ +00040530: 6e2f 7368 202e 2f64 6570 636f 6d70 205c n/sh ./depcomp \ │ │ │ │ │ +00040540: 0a20 2020 2020 6763 6320 2d49 2e20 2d49 . gcc -I. -I │ │ │ │ │ +00040550: 2e20 2d67 202d 4f32 202d 6320 6074 6573 . -g -O2 -c `tes │ │ │ │ │ +00040560: 7420 2d66 2027 666f 6f2e 6327 207c 7c20 t -f 'foo.c' || │ │ │ │ │ +00040570: 6563 686f 2027 2e2f 2760 666f 6f2e 630a echo './'`foo.c. │ │ │ │ │ +00040580: 2020 2020 2067 6363 2020 2d67 202d 4f32 gcc -g -O2 │ │ │ │ │ +00040590: 2020 202d 6f20 666f 6f20 2066 6f6f 2e6f -o foo foo.o │ │ │ │ │ +000405a0: 0a20 2020 2020 6d61 6b65 5b31 5d3a 204c . make[1]: L │ │ │ │ │ +000405b0: 6561 7669 6e67 2064 6972 6563 746f 7279 eaving directory │ │ │ │ │ +000405c0: 2060 2f68 6f6d 652f 6164 6c2f 746d 7027 `/home/adl/tmp' │ │ │ │ │ +000405d0: 0a0a 2020 2048 6f77 6576 6572 2c20 6173 .. However, as │ │ │ │ │ +000405e0: 2073 6169 6420 6561 726c 6965 722c 2027 said earlier, ' │ │ │ │ │ +000405f0: 4255 494c 545f 534f 5552 4345 5327 2061 BUILT_SOURCES' a │ │ │ │ │ +00040600: 7070 6c69 6573 206f 6e6c 7920 746f 2074 pplies only to t │ │ │ │ │ +00040610: 6865 2027 616c 6c27 2c0a 2763 6865 636b he 'all',.'check │ │ │ │ │ +00040620: 272c 2061 6e64 2027 696e 7374 616c 6c27 ', and 'install' │ │ │ │ │ +00040630: 2074 6172 6765 7473 2e20 2049 7420 7374 targets. It st │ │ │ │ │ +00040640: 696c 6c20 6661 696c 7320 6966 2079 6f75 ill fails if you │ │ │ │ │ +00040650: 2074 7279 2074 6f20 7275 6e20 276d 616b try to run 'mak │ │ │ │ │ +00040660: 650a 666f 6f27 2065 7870 6c69 6369 746c e.foo' explicitl │ │ │ │ │ +00040670: 793a 0a0a 2020 2020 2025 206d 616b 6520 y:.. % make │ │ │ │ │ +00040680: 636c 6561 6e0a 2020 2020 2074 6573 7420 clean. test │ │ │ │ │ +00040690: 2d7a 2022 6269 6e64 6972 2e68 2220 7c7c -z "bindir.h" || │ │ │ │ │ +000406a0: 2072 6d20 2d66 2062 696e 6469 722e 680a rm -f bindir.h. │ │ │ │ │ +000406b0: 2020 2020 2074 6573 7420 2d7a 2022 666f test -z "fo │ │ │ │ │ +000406c0: 6f22 207c 7c20 726d 202d 6620 666f 6f0a o" || rm -f foo. │ │ │ │ │ +000406d0: 2020 2020 2072 6d20 2d66 202a 2e6f 0a20 rm -f *.o. │ │ │ │ │ +000406e0: 2020 2020 2520 3a20 3e20 2e64 6570 732f % : > .deps/ │ │ │ │ │ +000406f0: 666f 6f2e 506f 2023 2053 7570 7072 6573 foo.Po # Suppres │ │ │ │ │ +00040700: 7320 7072 6576 696f 7573 6c79 2072 6563 s previously rec │ │ │ │ │ +00040710: 6f72 6465 6420 6465 7065 6e64 656e 6369 orded dependenci │ │ │ │ │ +00040720: 6573 0a20 2020 2020 2520 6d61 6b65 2066 es. % make f │ │ │ │ │ +00040730: 6f6f 0a20 2020 2020 736f 7572 6365 3d27 oo. source=' │ │ │ │ │ +00040740: 666f 6f2e 6327 206f 626a 6563 743d 2766 foo.c' object='f │ │ │ │ │ +00040750: 6f6f 2e6f 2720 6c69 6274 6f6f 6c3d 6e6f oo.o' libtool=no │ │ │ │ │ +00040760: 205c 0a20 2020 2020 6465 7066 696c 653d \. depfile= │ │ │ │ │ +00040770: 272e 6465 7073 2f66 6f6f 2e50 6f27 2074 '.deps/foo.Po' t │ │ │ │ │ +00040780: 6d70 6465 7066 696c 653d 272e 6465 7073 mpdepfile='.deps │ │ │ │ │ +00040790: 2f66 6f6f 2e54 506f 2720 5c0a 2020 2020 /foo.TPo' \. │ │ │ │ │ +000407a0: 2064 6570 6d6f 6465 3d67 6363 202f 6269 depmode=gcc /bi │ │ │ │ │ +000407b0: 6e2f 7368 202e 2f64 6570 636f 6d70 205c n/sh ./depcomp \ │ │ │ │ │ +000407c0: 0a20 2020 2020 6763 6320 2d49 2e20 2d49 . gcc -I. -I │ │ │ │ │ +000407d0: 2e20 2d67 202d 4f32 202d 6320 6074 6573 . -g -O2 -c `tes │ │ │ │ │ +000407e0: 7420 2d66 2027 666f 6f2e 6327 207c 7c20 t -f 'foo.c' || │ │ │ │ │ +000407f0: 6563 686f 2027 2e2f 2760 666f 6f2e 630a echo './'`foo.c. │ │ │ │ │ +00040800: 2020 2020 2066 6f6f 2e63 3a32 3a20 6269 foo.c:2: bi │ │ │ │ │ +00040810: 6e64 6972 2e68 3a20 4e6f 2073 7563 6820 ndir.h: No such │ │ │ │ │ +00040820: 6669 6c65 206f 7220 6469 7265 6374 6f72 file or director │ │ │ │ │ +00040830: 790a 2020 2020 206d 616b 653a 202a 2a2a y. make: *** │ │ │ │ │ +00040840: 205b 666f 6f2e 6f5d 2045 7272 6f72 2031 [foo.o] Error 1 │ │ │ │ │ +00040850: 0a0a 5265 636f 7264 696e 6720 4465 7065 ..Recording Depe │ │ │ │ │ +00040860: 6e64 656e 6369 6573 206d 616e 7561 6c6c ndencies manuall │ │ │ │ │ +00040870: 790a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e y............... │ │ │ │ │ +00040880: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ +00040890: 2e0a 0a55 7375 616c 6c79 2070 656f 706c ...Usually peopl │ │ │ │ │ +000408a0: 6520 6172 6520 6861 7070 7920 656e 6f75 e are happy enou │ │ │ │ │ +000408b0: 6768 2077 6974 6820 2742 5549 4c54 5f53 gh with 'BUILT_S │ │ │ │ │ +000408c0: 4f55 5243 4553 2720 6265 6361 7573 6520 OURCES' because │ │ │ │ │ +000408d0: 7468 6579 206e 6576 6572 0a62 7569 6c64 they never.build │ │ │ │ │ +000408e0: 2074 6172 6765 7473 2073 7563 6820 6173 targets such as │ │ │ │ │ +000408f0: 2027 6d61 6b65 2066 6f6f 2720 6265 666f 'make foo' befo │ │ │ │ │ +00040900: 7265 2027 6d61 6b65 2061 6c6c 272c 2061 re 'make all', a │ │ │ │ │ +00040910: 7320 696e 2074 6865 2070 7265 7669 6f75 s in the previou │ │ │ │ │ +00040920: 730a 6578 616d 706c 652e 2020 486f 7765 s.example. Howe │ │ │ │ │ +00040930: 7665 7220 6966 2074 6869 7320 6d61 7474 ver if this matt │ │ │ │ │ +00040940: 6572 7320 746f 2079 6f75 2c20 796f 7520 ers to you, you │ │ │ │ │ +00040950: 6361 6e20 6176 6f69 6420 2742 5549 4c54 can avoid 'BUILT │ │ │ │ │ +00040960: 5f53 4f55 5243 4553 270a 616e 6420 7265 _SOURCES'.and re │ │ │ │ │ +00040970: 636f 7264 2073 7563 6820 6465 7065 6e64 cord such depend │ │ │ │ │ +00040980: 656e 6369 6573 2065 7870 6c69 6369 746c encies explicitl │ │ │ │ │ +00040990: 7920 696e 2074 6865 2027 4d61 6b65 6669 y in the 'Makefi │ │ │ │ │ +000409a0: 6c65 2e61 6d27 2e0a 0a20 2020 2020 6269 le.am'... bi │ │ │ │ │ +000409b0: 6e5f 5052 4f47 5241 4d53 203d 2066 6f6f n_PROGRAMS = foo │ │ │ │ │ +000409c0: 0a20 2020 2020 666f 6f5f 534f 5552 4345 . foo_SOURCE │ │ │ │ │ +000409d0: 5320 3d20 666f 6f2e 630a 2020 2020 206e S = foo.c. n │ │ │ │ │ +000409e0: 6f64 6973 745f 666f 6f5f 534f 5552 4345 odist_foo_SOURCE │ │ │ │ │ +000409f0: 5320 3d20 6269 6e64 6972 2e68 0a20 2020 S = bindir.h. │ │ │ │ │ +00040a00: 2020 666f 6f2e 2428 4f42 4a45 5854 293a foo.$(OBJEXT): │ │ │ │ │ +00040a10: 2062 696e 6469 722e 680a 2020 2020 2043 bindir.h. C │ │ │ │ │ +00040a20: 4c45 414e 4649 4c45 5320 3d20 6269 6e64 LEANFILES = bind │ │ │ │ │ +00040a30: 6972 2e68 0a20 2020 2020 6269 6e64 6972 ir.h. bindir │ │ │ │ │ +00040a40: 2e68 3a20 4d61 6b65 6669 6c65 0a20 2020 .h: Makefile. │ │ │ │ │ +00040a50: 2020 2020 2020 2020 2020 6563 686f 2027 echo ' │ │ │ │ │ +00040a60: 2364 6566 696e 6520 6269 6e64 6972 2022 #define bindir " │ │ │ │ │ +00040a70: 2428 6269 6e64 6972 2922 2720 3e24 400a $(bindir)"' >$@. │ │ │ │ │ +00040a80: 0a20 2020 596f 7520 646f 6e27 7420 6861 . You don't ha │ │ │ │ │ +00040a90: 7665 2074 6f20 6c69 7374 205f 616c 6c5f ve to list _all_ │ │ │ │ │ +00040aa0: 2074 6865 2064 6570 656e 6465 6e63 6965 the dependencie │ │ │ │ │ +00040ab0: 7320 6f66 2027 666f 6f2e 6f27 2065 7870 s of 'foo.o' exp │ │ │ │ │ +00040ac0: 6c69 6369 746c 792c 0a6f 6e6c 7920 7468 licitly,.only th │ │ │ │ │ +00040ad0: 6f73 6520 7468 6174 206d 6967 6874 206e ose that might n │ │ │ │ │ +00040ae0: 6565 6420 746f 2062 6520 6275 696c 742e eed to be built. │ │ │ │ │ +00040af0: 2020 4966 2061 2064 6570 656e 6465 6e63 If a dependenc │ │ │ │ │ +00040b00: 7920 616c 7265 6164 7920 6578 6973 7473 y already exists │ │ │ │ │ +00040b10: 2c0a 6974 2077 696c 6c20 6e6f 7420 6869 ,.it will not hi │ │ │ │ │ +00040b20: 6e64 6572 2074 6865 2066 6972 7374 2063 nder the first c │ │ │ │ │ +00040b30: 6f6d 7069 6c61 7469 6f6e 2061 6e64 2077 ompilation and w │ │ │ │ │ +00040b40: 696c 6c20 6265 2072 6563 6f72 6465 6420 ill be recorded │ │ │ │ │ +00040b50: 6279 2074 6865 0a6e 6f72 6d61 6c20 6465 by the.normal de │ │ │ │ │ +00040b60: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ +00040b70: 6720 636f 6465 2e20 2028 4e6f 7465 2074 g code. (Note t │ │ │ │ │ +00040b80: 6861 7420 6166 7465 7220 7468 6973 2066 hat after this f │ │ │ │ │ +00040b90: 6972 7374 0a63 6f6d 7069 6c61 7469 6f6e irst.compilation │ │ │ │ │ +00040ba0: 2074 6865 2064 6570 656e 6465 6e63 7920 the dependency │ │ │ │ │ +00040bb0: 7472 6163 6b69 6e67 2063 6f64 6520 7769 tracking code wi │ │ │ │ │ +00040bc0: 6c6c 2061 6c73 6f20 6861 7665 2072 6563 ll also have rec │ │ │ │ │ +00040bd0: 6f72 6465 6420 7468 650a 6465 7065 6e64 orded the.depend │ │ │ │ │ +00040be0: 656e 6379 2062 6574 7765 656e 2027 666f ency between 'fo │ │ │ │ │ +00040bf0: 6f2e 6f27 2061 6e64 2027 6269 6e64 6972 o.o' and 'bindir │ │ │ │ │ +00040c00: 2e68 273b 2073 6f20 6f75 7220 6578 706c .h'; so our expl │ │ │ │ │ +00040c10: 6963 6974 2064 6570 656e 6465 6e63 7920 icit dependency │ │ │ │ │ +00040c20: 6973 0a72 6561 6c6c 7920 7573 6566 756c is.really useful │ │ │ │ │ +00040c30: 2074 6f20 7468 6520 6669 7273 7420 6275 to the first bu │ │ │ │ │ +00040c40: 696c 6420 6f6e 6c79 2e29 0a0a 2020 2041 ild only.).. A │ │ │ │ │ +00040c50: 6464 696e 6720 6578 706c 6963 6974 2064 dding explicit d │ │ │ │ │ +00040c60: 6570 656e 6465 6e63 6965 7320 6c69 6b65 ependencies like │ │ │ │ │ +00040c70: 2074 6869 7320 6361 6e20 6265 2061 2062 this can be a b │ │ │ │ │ +00040c80: 6974 2064 616e 6765 726f 7573 2069 6620 it dangerous if │ │ │ │ │ +00040c90: 796f 750a 6172 6520 6e6f 7420 6361 7265 you.are not care │ │ │ │ │ +00040ca0: 6675 6c20 656e 6f75 6768 2e20 2054 6869 ful enough. Thi │ │ │ │ │ +00040cb0: 7320 6973 2064 7565 2074 6f20 7468 6520 s is due to the │ │ │ │ │ +00040cc0: 7761 7920 4175 746f 6d61 6b65 2074 7269 way Automake tri │ │ │ │ │ +00040cd0: 6573 206e 6f74 2074 6f0a 6f76 6572 7772 es not to.overwr │ │ │ │ │ +00040ce0: 6974 6520 796f 7572 2072 756c 6573 2028 ite your rules ( │ │ │ │ │ +00040cf0: 6974 2061 7373 756d 6573 2079 6f75 206b it assumes you k │ │ │ │ │ +00040d00: 6e6f 7720 6265 7474 6572 2074 6861 6e20 now better than │ │ │ │ │ +00040d10: 6974 292e 0a27 666f 6f2e 2428 4f42 4a45 it)..'foo.$(OBJE │ │ │ │ │ +00040d20: 5854 293a 2062 696e 6469 722e 6827 2073 XT): bindir.h' s │ │ │ │ │ +00040d30: 7570 6572 7365 6465 7320 616e 7920 7275 upersedes any ru │ │ │ │ │ +00040d40: 6c65 2041 7574 6f6d 616b 6520 6d61 7920 le Automake may │ │ │ │ │ +00040d50: 7761 6e74 2074 6f0a 6f75 7470 7574 2074 want to.output t │ │ │ │ │ +00040d60: 6f20 6275 696c 6420 2766 6f6f 2e24 284f o build 'foo.$(O │ │ │ │ │ +00040d70: 424a 4558 5429 272e 2020 4974 2068 6170 BJEXT)'. It hap │ │ │ │ │ +00040d80: 7065 6e73 2074 6f20 776f 726b 2069 6e20 pens to work in │ │ │ │ │ +00040d90: 7468 6973 2063 6173 650a 6265 6361 7573 this case.becaus │ │ │ │ │ +00040da0: 6520 4175 746f 6d61 6b65 2064 6f65 736e e Automake doesn │ │ │ │ │ +00040db0: 2774 2068 6176 6520 746f 206f 7574 7075 't have to outpu │ │ │ │ │ +00040dc0: 7420 616e 7920 2766 6f6f 2e24 284f 424a t any 'foo.$(OBJ │ │ │ │ │ +00040dd0: 4558 5429 3a27 2074 6172 6765 743a 2069 EXT):' target: i │ │ │ │ │ +00040de0: 740a 7265 6c69 6573 206f 6e20 6120 7375 t.relies on a su │ │ │ │ │ +00040df0: 6666 6978 2072 756c 6520 696e 7374 6561 ffix rule instea │ │ │ │ │ +00040e00: 6420 2869 2e65 2e2c 2027 2e63 2e24 284f d (i.e., '.c.$(O │ │ │ │ │ +00040e10: 424a 4558 5429 3a27 292e 2020 416c 7761 BJEXT):'). Alwa │ │ │ │ │ +00040e20: 7973 2063 6865 636b 0a74 6865 2067 656e ys check.the gen │ │ │ │ │ +00040e30: 6572 6174 6564 2027 4d61 6b65 6669 6c65 erated 'Makefile │ │ │ │ │ +00040e40: 2e69 6e27 2069 6620 796f 7520 646f 2074 .in' if you do t │ │ │ │ │ +00040e50: 6869 732e 0a0a 4275 696c 6420 2762 696e his...Build 'bin │ │ │ │ │ +00040e60: 6469 722e 6827 2066 726f 6d20 2763 6f6e dir.h' from 'con │ │ │ │ │ +00040e70: 6669 6775 7265 270a 2e2e 2e2e 2e2e 2e2e figure'......... │ │ │ │ │ 00040e80: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -00040e90: 2e2e 2e2e 2e2e 2e0a 0a49 7427 7320 706f .........It's po │ │ │ │ │ -00040ea0: 7373 6962 6c65 2074 6f20 6465 6669 6e65 ssible to define │ │ │ │ │ -00040eb0: 2074 6869 7320 7072 6570 726f 6365 7373 this preprocess │ │ │ │ │ -00040ec0: 6f72 206d 6163 726f 2066 726f 6d20 2763 or macro from 'c │ │ │ │ │ -00040ed0: 6f6e 6669 6775 7265 272c 2065 6974 6865 onfigure', eithe │ │ │ │ │ -00040ee0: 720a 696e 2027 636f 6e66 6967 2e68 2720 r.in 'config.h' │ │ │ │ │ -00040ef0: 282a 6e6f 7465 2044 6566 696e 696e 6720 (*note Defining │ │ │ │ │ -00040f00: 4469 7265 6374 6f72 6965 733a 2028 6175 Directories: (au │ │ │ │ │ -00040f10: 746f 636f 6e66 2944 6566 696e 696e 670a toconf)Defining. │ │ │ │ │ -00040f20: 4469 7265 6374 6f72 6965 732e 292c 206f Directories.), o │ │ │ │ │ -00040f30: 7220 6279 2070 726f 6365 7373 696e 6720 r by processing │ │ │ │ │ -00040f40: 6120 2762 696e 6469 722e 682e 696e 2720 a 'bindir.h.in' │ │ │ │ │ -00040f50: 6669 6c65 2075 7369 6e67 0a27 4143 5f43 file using.'AC_C │ │ │ │ │ -00040f60: 4f4e 4649 475f 4649 4c45 5327 2028 2a6e ONFIG_FILES' (*n │ │ │ │ │ -00040f70: 6f74 6520 436f 6e66 6967 7572 6174 696f ote Configuratio │ │ │ │ │ -00040f80: 6e20 4163 7469 6f6e 733a 2028 6175 746f n Actions: (auto │ │ │ │ │ -00040f90: 636f 6e66 2943 6f6e 6669 6775 7261 7469 conf)Configurati │ │ │ │ │ -00040fa0: 6f6e 0a41 6374 696f 6e73 2e29 2e0a 0a20 on.Actions.)... │ │ │ │ │ -00040fb0: 2020 4174 2074 6869 7320 706f 696e 7420 At this point │ │ │ │ │ -00040fc0: 6974 2073 686f 756c 6420 6265 2063 6c65 it should be cle │ │ │ │ │ -00040fd0: 6172 2074 6861 7420 6275 696c 6469 6e67 ar that building │ │ │ │ │ -00040fe0: 2027 6269 6e64 6972 2e68 2720 6672 6f6d 'bindir.h' from │ │ │ │ │ -00040ff0: 0a27 636f 6e66 6967 7572 6527 2077 6f72 .'configure' wor │ │ │ │ │ -00041000: 6b73 2077 656c 6c20 666f 7220 7468 6973 ks well for this │ │ │ │ │ -00041010: 2065 7861 6d70 6c65 2e20 2027 6269 6e64 example. 'bind │ │ │ │ │ -00041020: 6972 2e68 2720 7769 6c6c 2065 7869 7374 ir.h' will exist │ │ │ │ │ -00041030: 2062 6566 6f72 650a 796f 7520 6275 696c before.you buil │ │ │ │ │ -00041040: 6420 616e 7920 7461 7267 6574 2c20 6865 d any target, he │ │ │ │ │ -00041050: 6e63 6520 7769 6c6c 206e 6f74 2063 6175 nce will not cau │ │ │ │ │ -00041060: 7365 2061 6e79 2064 6570 656e 6465 6e63 se any dependenc │ │ │ │ │ -00041070: 7920 6973 7375 652e 0a0a 2020 2054 6865 y issue... The │ │ │ │ │ -00041080: 204d 616b 6566 696c 6520 6361 6e20 6265 Makefile can be │ │ │ │ │ -00041090: 2073 6872 756e 6b20 6173 2066 6f6c 6c6f shrunk as follo │ │ │ │ │ -000410a0: 7773 2e20 2057 6520 646f 206e 6f74 2065 ws. We do not e │ │ │ │ │ -000410b0: 7665 6e20 6861 7665 2074 6f0a 6d65 6e74 ven have to.ment │ │ │ │ │ -000410c0: 696f 6e20 2762 696e 6469 722e 6827 2e0a ion 'bindir.h'.. │ │ │ │ │ -000410d0: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ -000410e0: 4d53 203d 2066 6f6f 0a20 2020 2020 666f MS = foo. fo │ │ │ │ │ -000410f0: 6f5f 534f 5552 4345 5320 3d20 666f 6f2e o_SOURCES = foo. │ │ │ │ │ -00041100: 630a 0a20 2020 486f 7765 7665 722c 2069 c.. However, i │ │ │ │ │ -00041110: 7427 7320 6e6f 7420 616c 7761 7973 2070 t's not always p │ │ │ │ │ -00041120: 6f73 7369 626c 6520 746f 2062 7569 6c64 ossible to build │ │ │ │ │ -00041130: 2073 6f75 7263 6573 2066 726f 6d20 2763 sources from 'c │ │ │ │ │ -00041140: 6f6e 6669 6775 7265 272c 0a65 7370 6563 onfigure',.espec │ │ │ │ │ -00041150: 6961 6c6c 7920 7768 656e 2074 6865 7365 ially when these │ │ │ │ │ -00041160: 2073 6f75 7263 6573 2061 7265 2067 656e sources are gen │ │ │ │ │ -00041170: 6572 6174 6564 2062 7920 6120 746f 6f6c erated by a tool │ │ │ │ │ -00041180: 2074 6861 7420 6e65 6564 7320 746f 2062 that needs to b │ │ │ │ │ -00041190: 650a 6275 696c 7420 6669 7273 742e 0a0a e.built first... │ │ │ │ │ -000411a0: 4275 696c 6420 2762 696e 6469 722e 6327 Build 'bindir.c' │ │ │ │ │ -000411b0: 2c20 6e6f 7420 2762 696e 6469 722e 6827 , not 'bindir.h' │ │ │ │ │ -000411c0: 2e0a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ +00040e90: 2e2e 2e2e 2e2e 2e2e 2e0a 0a49 7427 7320 ...........It's │ │ │ │ │ +00040ea0: 706f 7373 6962 6c65 2074 6f20 6465 6669 possible to defi │ │ │ │ │ +00040eb0: 6e65 2074 6869 7320 7072 6570 726f 6365 ne this preproce │ │ │ │ │ +00040ec0: 7373 6f72 206d 6163 726f 2066 726f 6d20 ssor macro from │ │ │ │ │ +00040ed0: 2763 6f6e 6669 6775 7265 272c 2065 6974 'configure', eit │ │ │ │ │ +00040ee0: 6865 720a 696e 2027 636f 6e66 6967 2e68 her.in 'config.h │ │ │ │ │ +00040ef0: 2720 282a 6e6f 7465 2044 6566 696e 696e ' (*note Definin │ │ │ │ │ +00040f00: 6720 4469 7265 6374 6f72 6965 733a 2028 g Directories: ( │ │ │ │ │ +00040f10: 6175 746f 636f 6e66 2944 6566 696e 696e autoconf)Definin │ │ │ │ │ +00040f20: 670a 4469 7265 6374 6f72 6965 732e 292c g.Directories.), │ │ │ │ │ +00040f30: 206f 7220 6279 2070 726f 6365 7373 696e or by processin │ │ │ │ │ +00040f40: 6720 6120 2762 696e 6469 722e 682e 696e g a 'bindir.h.in │ │ │ │ │ +00040f50: 2720 6669 6c65 2075 7369 6e67 0a27 4143 ' file using.'AC │ │ │ │ │ +00040f60: 5f43 4f4e 4649 475f 4649 4c45 5327 2028 _CONFIG_FILES' ( │ │ │ │ │ +00040f70: 2a6e 6f74 6520 436f 6e66 6967 7572 6174 *note Configurat │ │ │ │ │ +00040f80: 696f 6e20 4163 7469 6f6e 733a 2028 6175 ion Actions: (au │ │ │ │ │ +00040f90: 746f 636f 6e66 2943 6f6e 6669 6775 7261 toconf)Configura │ │ │ │ │ +00040fa0: 7469 6f6e 0a41 6374 696f 6e73 2e29 2e0a tion.Actions.).. │ │ │ │ │ +00040fb0: 0a20 2020 4174 2074 6869 7320 706f 696e . At this poin │ │ │ │ │ +00040fc0: 7420 6974 2073 686f 756c 6420 6265 2063 t it should be c │ │ │ │ │ +00040fd0: 6c65 6172 2074 6861 7420 6275 696c 6469 lear that buildi │ │ │ │ │ +00040fe0: 6e67 2027 6269 6e64 6972 2e68 2720 6672 ng 'bindir.h' fr │ │ │ │ │ +00040ff0: 6f6d 0a27 636f 6e66 6967 7572 6527 2077 om.'configure' w │ │ │ │ │ +00041000: 6f72 6b73 2077 656c 6c20 666f 7220 7468 orks well for th │ │ │ │ │ +00041010: 6973 2065 7861 6d70 6c65 2e20 2027 6269 is example. 'bi │ │ │ │ │ +00041020: 6e64 6972 2e68 2720 7769 6c6c 2065 7869 ndir.h' will exi │ │ │ │ │ +00041030: 7374 2062 6566 6f72 650a 796f 7520 6275 st before.you bu │ │ │ │ │ +00041040: 696c 6420 616e 7920 7461 7267 6574 2c20 ild any target, │ │ │ │ │ +00041050: 6865 6e63 6520 7769 6c6c 206e 6f74 2063 hence will not c │ │ │ │ │ +00041060: 6175 7365 2061 6e79 2064 6570 656e 6465 ause any depende │ │ │ │ │ +00041070: 6e63 7920 6973 7375 652e 0a0a 2020 2054 ncy issue... T │ │ │ │ │ +00041080: 6865 204d 616b 6566 696c 6520 6361 6e20 he Makefile can │ │ │ │ │ +00041090: 6265 2073 6872 756e 6b20 6173 2066 6f6c be shrunk as fol │ │ │ │ │ +000410a0: 6c6f 7773 2e20 2057 6520 646f 206e 6f74 lows. We do not │ │ │ │ │ +000410b0: 2065 7665 6e20 6861 7665 2074 6f0a 6d65 even have to.me │ │ │ │ │ +000410c0: 6e74 696f 6e20 2762 696e 6469 722e 6827 ntion 'bindir.h' │ │ │ │ │ +000410d0: 2e0a 0a20 2020 2020 6269 6e5f 5052 4f47 ... bin_PROG │ │ │ │ │ +000410e0: 5241 4d53 203d 2066 6f6f 0a20 2020 2020 RAMS = foo. │ │ │ │ │ +000410f0: 666f 6f5f 534f 5552 4345 5320 3d20 666f foo_SOURCES = fo │ │ │ │ │ +00041100: 6f2e 630a 0a20 2020 486f 7765 7665 722c o.c.. However, │ │ │ │ │ +00041110: 2069 7427 7320 6e6f 7420 616c 7761 7973 it's not always │ │ │ │ │ +00041120: 2070 6f73 7369 626c 6520 746f 2062 7569 possible to bui │ │ │ │ │ +00041130: 6c64 2073 6f75 7263 6573 2066 726f 6d20 ld sources from │ │ │ │ │ +00041140: 2763 6f6e 6669 6775 7265 272c 0a65 7370 'configure',.esp │ │ │ │ │ +00041150: 6563 6961 6c6c 7920 7768 656e 2074 6865 ecially when the │ │ │ │ │ +00041160: 7365 2073 6f75 7263 6573 2061 7265 2067 se sources are g │ │ │ │ │ +00041170: 656e 6572 6174 6564 2062 7920 6120 746f enerated by a to │ │ │ │ │ +00041180: 6f6c 2074 6861 7420 6e65 6564 7320 746f ol that needs to │ │ │ │ │ +00041190: 2062 650a 6275 696c 7420 6669 7273 742e be.built first. │ │ │ │ │ +000411a0: 0a0a 4275 696c 6420 2762 696e 6469 722e ..Build 'bindir. │ │ │ │ │ +000411b0: 6327 2c20 6e6f 7420 2762 696e 6469 722e c', not 'bindir. │ │ │ │ │ +000411c0: 6827 2e0a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e h'.............. │ │ │ │ │ 000411d0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -000411e0: 2e2e 2e0a 0a41 6e6f 7468 6572 2061 7474 .....Another att │ │ │ │ │ -000411f0: 7261 6374 6976 6520 6964 6561 2069 7320 ractive idea is │ │ │ │ │ -00041200: 746f 2064 6566 696e 6520 2762 696e 6469 to define 'bindi │ │ │ │ │ -00041210: 7227 2061 7320 6120 7661 7269 6162 6c65 r' as a variable │ │ │ │ │ -00041220: 206f 7220 6675 6e63 7469 6f6e 0a65 7870 or function.exp │ │ │ │ │ -00041230: 6f72 7465 6420 6672 6f6d 2027 6269 6e64 orted from 'bind │ │ │ │ │ -00041240: 6972 2e6f 272c 2061 6e64 2062 7569 6c64 ir.o', and build │ │ │ │ │ -00041250: 2027 6269 6e64 6972 2e63 2720 696e 7374 'bindir.c' inst │ │ │ │ │ -00041260: 6561 6420 6f66 2027 6269 6e64 6972 2e68 ead of 'bindir.h │ │ │ │ │ -00041270: 272e 0a0a 2020 2020 206e 6f69 6e73 745f '... noinst_ │ │ │ │ │ -00041280: 5052 4f47 5241 4d53 203d 2066 6f6f 0a20 PROGRAMS = foo. │ │ │ │ │ -00041290: 2020 2020 666f 6f5f 534f 5552 4345 5320 foo_SOURCES │ │ │ │ │ -000412a0: 3d20 666f 6f2e 6320 6269 6e64 6972 2e68 = foo.c bindir.h │ │ │ │ │ -000412b0: 0a20 2020 2020 6e6f 6469 7374 5f66 6f6f . nodist_foo │ │ │ │ │ -000412c0: 5f53 4f55 5243 4553 203d 2062 696e 6469 _SOURCES = bindi │ │ │ │ │ -000412d0: 722e 630a 2020 2020 2043 4c45 414e 4649 r.c. CLEANFI │ │ │ │ │ -000412e0: 4c45 5320 3d20 6269 6e64 6972 2e63 0a20 LES = bindir.c. │ │ │ │ │ -000412f0: 2020 2020 6269 6e64 6972 2e63 3a20 4d61 bindir.c: Ma │ │ │ │ │ -00041300: 6b65 6669 6c65 0a20 2020 2020 2020 2020 kefile. │ │ │ │ │ -00041310: 2020 2020 6563 686f 2027 636f 6e73 7420 echo 'const │ │ │ │ │ -00041320: 6368 6172 2062 696e 6469 725b 5d20 3d20 char bindir[] = │ │ │ │ │ -00041330: 2224 2862 696e 6469 7229 223b 2720 3e24 "$(bindir)";' >$ │ │ │ │ │ -00041340: 400a 0a20 2020 2762 696e 6469 722e 6827 @.. 'bindir.h' │ │ │ │ │ -00041350: 2063 6f6e 7461 696e 7320 6a75 7374 2074 contains just t │ │ │ │ │ -00041360: 6865 2076 6172 6961 626c 6527 7320 6465 he variable's de │ │ │ │ │ -00041370: 636c 6172 6174 696f 6e20 616e 6420 646f claration and do │ │ │ │ │ -00041380: 6573 6e27 7420 6e65 6564 0a74 6f20 6265 esn't need.to be │ │ │ │ │ -00041390: 2062 7569 6c74 2c20 736f 2069 7420 776f built, so it wo │ │ │ │ │ -000413a0: 6e27 7420 6361 7573 6520 616e 7920 7472 n't cause any tr │ │ │ │ │ -000413b0: 6f75 626c 652e 2020 2762 696e 6469 722e ouble. 'bindir. │ │ │ │ │ -000413c0: 6f27 2069 7320 616c 7761 7973 0a64 6570 o' is always.dep │ │ │ │ │ -000413d0: 656e 6465 6e74 206f 6e20 2762 696e 6469 endent on 'bindi │ │ │ │ │ -000413e0: 722e 6327 2c20 736f 2027 6269 6e64 6972 r.c', so 'bindir │ │ │ │ │ -000413f0: 2e63 2720 7769 6c6c 2067 6574 2062 7569 .c' will get bui │ │ │ │ │ -00041400: 6c74 2066 6972 7374 2e0a 0a57 6869 6368 lt first...Which │ │ │ │ │ -00041410: 2069 7320 6265 7374 3f0a 2e2e 2e2e 2e2e is best?....... │ │ │ │ │ -00041420: 2e2e 2e2e 2e2e 2e2e 0a0a 5468 6572 6520 ..........There │ │ │ │ │ -00041430: 6973 206e 6f20 7061 6e61 6365 612c 206f is no panacea, o │ │ │ │ │ -00041440: 6620 636f 7572 7365 2e20 2045 6163 6820 f course. Each │ │ │ │ │ -00041450: 736f 6c75 7469 6f6e 2068 6173 2069 7473 solution has its │ │ │ │ │ -00041460: 206d 6572 6974 7320 616e 640a 6472 6177 merits and.draw │ │ │ │ │ -00041470: 6261 636b 732e 0a0a 2020 2059 6f75 2063 backs... You c │ │ │ │ │ -00041480: 616e 6e6f 7420 7573 6520 2742 5549 4c54 annot use 'BUILT │ │ │ │ │ -00041490: 5f53 4f55 5243 4553 2720 6966 2074 6865 _SOURCES' if the │ │ │ │ │ -000414a0: 2061 6269 6c69 7479 2074 6f20 7275 6e20 ability to run │ │ │ │ │ -000414b0: 276d 616b 6520 666f 6f27 206f 6e20 610a 'make foo' on a. │ │ │ │ │ -000414c0: 636c 6561 6e20 7472 6565 2069 7320 696d clean tree is im │ │ │ │ │ -000414d0: 706f 7274 616e 7420 746f 2079 6f75 2e0a portant to you.. │ │ │ │ │ -000414e0: 0a20 2020 596f 7520 776f 6e27 7420 6164 . You won't ad │ │ │ │ │ -000414f0: 6420 6578 706c 6963 6974 2064 6570 656e d explicit depen │ │ │ │ │ -00041500: 6465 6e63 6965 7320 6966 2079 6f75 2061 dencies if you a │ │ │ │ │ -00041510: 7265 206c 6565 7279 206f 6620 6f76 6572 re leery of over │ │ │ │ │ -00041520: 7269 6469 6e67 2061 6e0a 4175 746f 6d61 riding an.Automa │ │ │ │ │ -00041530: 6b65 2072 756c 6520 6279 206d 6973 7461 ke rule by mista │ │ │ │ │ -00041540: 6b65 2e0a 0a20 2020 4275 696c 6469 6e67 ke... Building │ │ │ │ │ -00041550: 2066 696c 6573 2066 726f 6d20 272e 2f63 files from './c │ │ │ │ │ -00041560: 6f6e 6669 6775 7265 2720 6973 206e 6f74 onfigure' is not │ │ │ │ │ -00041570: 2061 6c77 6179 7320 706f 7373 6962 6c65 always possible │ │ │ │ │ -00041580: 2c20 6e65 6974 6865 7220 6973 0a63 6f6e , neither is.con │ │ │ │ │ -00041590: 7665 7274 696e 6720 272e 6827 2066 696c verting '.h' fil │ │ │ │ │ -000415a0: 6573 2069 6e74 6f20 272e 6327 2066 696c es into '.c' fil │ │ │ │ │ -000415b0: 6573 2e0a 0a1f 0a46 696c 653a 2061 7574 es.....File: aut │ │ │ │ │ -000415c0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -000415d0: 2020 4e6f 6465 3a20 4f74 6865 7220 474e Node: Other GN │ │ │ │ │ -000415e0: 5520 546f 6f6c 732c 2020 4e65 7874 3a20 U Tools, Next: │ │ │ │ │ -000415f0: 446f 6375 6d65 6e74 6174 696f 6e2c 2020 Documentation, │ │ │ │ │ -00041600: 5072 6576 3a20 4f74 6865 7220 4f62 6a65 Prev: Other Obje │ │ │ │ │ -00041610: 6374 732c 2020 5570 3a20 546f 700a 0a31 cts, Up: Top..1 │ │ │ │ │ -00041620: 3020 4f74 6865 7220 474e 5520 546f 6f6c 0 Other GNU Tool │ │ │ │ │ -00041630: 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a s.************** │ │ │ │ │ -00041640: 2a2a 2a2a 0a0a 5369 6e63 6520 4175 746f ****..Since Auto │ │ │ │ │ -00041650: 6d61 6b65 2069 7320 7072 696d 6172 696c make is primaril │ │ │ │ │ -00041660: 7920 696e 7465 6e64 6564 2074 6f20 6765 y intended to ge │ │ │ │ │ -00041670: 6e65 7261 7465 2027 4d61 6b65 6669 6c65 nerate 'Makefile │ │ │ │ │ -00041680: 2e69 6e27 7320 666f 7220 7573 650a 696e .in's for use.in │ │ │ │ │ -00041690: 2047 4e55 2070 726f 6772 616d 732c 2069 GNU programs, i │ │ │ │ │ -000416a0: 7420 7472 6965 7320 6861 7264 2074 6f20 t tries hard to │ │ │ │ │ -000416b0: 696e 7465 726f 7065 7261 7465 2077 6974 interoperate wit │ │ │ │ │ -000416c0: 6820 6f74 6865 7220 474e 5520 746f 6f6c h other GNU tool │ │ │ │ │ -000416d0: 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2045 s...* Menu:..* E │ │ │ │ │ -000416e0: 6d61 6373 204c 6973 703a 3a20 2020 2020 macs Lisp:: │ │ │ │ │ -000416f0: 2020 2020 2020 2020 2020 2020 2045 6d61 Ema │ │ │ │ │ -00041700: 6373 204c 6973 700a 2a20 6765 7474 6578 cs Lisp.* gettex │ │ │ │ │ -00041710: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -00041720: 2020 2020 2020 2020 4765 7474 6578 740a Gettext. │ │ │ │ │ -00041730: 2a20 4c69 6274 6f6f 6c3a 3a20 2020 2020 * Libtool:: │ │ │ │ │ +000411e0: 2e2e 2e2e 2e0a 0a41 6e6f 7468 6572 2061 .......Another a │ │ │ │ │ +000411f0: 7474 7261 6374 6976 6520 6964 6561 2069 ttractive idea i │ │ │ │ │ +00041200: 7320 746f 2064 6566 696e 6520 2762 696e s to define 'bin │ │ │ │ │ +00041210: 6469 7227 2061 7320 6120 7661 7269 6162 dir' as a variab │ │ │ │ │ +00041220: 6c65 206f 7220 6675 6e63 7469 6f6e 0a65 le or function.e │ │ │ │ │ +00041230: 7870 6f72 7465 6420 6672 6f6d 2027 6269 xported from 'bi │ │ │ │ │ +00041240: 6e64 6972 2e6f 272c 2061 6e64 2062 7569 ndir.o', and bui │ │ │ │ │ +00041250: 6c64 2027 6269 6e64 6972 2e63 2720 696e ld 'bindir.c' in │ │ │ │ │ +00041260: 7374 6561 6420 6f66 2027 6269 6e64 6972 stead of 'bindir │ │ │ │ │ +00041270: 2e68 272e 0a0a 2020 2020 206e 6f69 6e73 .h'... noins │ │ │ │ │ +00041280: 745f 5052 4f47 5241 4d53 203d 2066 6f6f t_PROGRAMS = foo │ │ │ │ │ +00041290: 0a20 2020 2020 666f 6f5f 534f 5552 4345 . foo_SOURCE │ │ │ │ │ +000412a0: 5320 3d20 666f 6f2e 6320 6269 6e64 6972 S = foo.c bindir │ │ │ │ │ +000412b0: 2e68 0a20 2020 2020 6e6f 6469 7374 5f66 .h. nodist_f │ │ │ │ │ +000412c0: 6f6f 5f53 4f55 5243 4553 203d 2062 696e oo_SOURCES = bin │ │ │ │ │ +000412d0: 6469 722e 630a 2020 2020 2043 4c45 414e dir.c. CLEAN │ │ │ │ │ +000412e0: 4649 4c45 5320 3d20 6269 6e64 6972 2e63 FILES = bindir.c │ │ │ │ │ +000412f0: 0a20 2020 2020 6269 6e64 6972 2e63 3a20 . bindir.c: │ │ │ │ │ +00041300: 4d61 6b65 6669 6c65 0a20 2020 2020 2020 Makefile. │ │ │ │ │ +00041310: 2020 2020 2020 6563 686f 2027 636f 6e73 echo 'cons │ │ │ │ │ +00041320: 7420 6368 6172 2062 696e 6469 725b 5d20 t char bindir[] │ │ │ │ │ +00041330: 3d20 2224 2862 696e 6469 7229 223b 2720 = "$(bindir)";' │ │ │ │ │ +00041340: 3e24 400a 0a20 2020 2762 696e 6469 722e >$@.. 'bindir. │ │ │ │ │ +00041350: 6827 2063 6f6e 7461 696e 7320 6a75 7374 h' contains just │ │ │ │ │ +00041360: 2074 6865 2076 6172 6961 626c 6527 7320 the variable's │ │ │ │ │ +00041370: 6465 636c 6172 6174 696f 6e20 616e 6420 declaration and │ │ │ │ │ +00041380: 646f 6573 6e27 7420 6e65 6564 0a74 6f20 doesn't need.to │ │ │ │ │ +00041390: 6265 2062 7569 6c74 2c20 736f 2069 7420 be built, so it │ │ │ │ │ +000413a0: 776f 6e27 7420 6361 7573 6520 616e 7920 won't cause any │ │ │ │ │ +000413b0: 7472 6f75 626c 652e 2020 2762 696e 6469 trouble. 'bindi │ │ │ │ │ +000413c0: 722e 6f27 2069 7320 616c 7761 7973 0a64 r.o' is always.d │ │ │ │ │ +000413d0: 6570 656e 6465 6e74 206f 6e20 2762 696e ependent on 'bin │ │ │ │ │ +000413e0: 6469 722e 6327 2c20 736f 2027 6269 6e64 dir.c', so 'bind │ │ │ │ │ +000413f0: 6972 2e63 2720 7769 6c6c 2067 6574 2062 ir.c' will get b │ │ │ │ │ +00041400: 7569 6c74 2066 6972 7374 2e0a 0a57 6869 uilt first...Whi │ │ │ │ │ +00041410: 6368 2069 7320 6265 7374 3f0a 2e2e 2e2e ch is best?..... │ │ │ │ │ +00041420: 2e2e 2e2e 2e2e 2e2e 2e2e 0a0a 5468 6572 ............Ther │ │ │ │ │ +00041430: 6520 6973 206e 6f20 7061 6e61 6365 612c e is no panacea, │ │ │ │ │ +00041440: 206f 6620 636f 7572 7365 2e20 2045 6163 of course. Eac │ │ │ │ │ +00041450: 6820 736f 6c75 7469 6f6e 2068 6173 2069 h solution has i │ │ │ │ │ +00041460: 7473 206d 6572 6974 7320 616e 640a 6472 ts merits and.dr │ │ │ │ │ +00041470: 6177 6261 636b 732e 0a0a 2020 2059 6f75 awbacks... You │ │ │ │ │ +00041480: 2063 616e 6e6f 7420 7573 6520 2742 5549 cannot use 'BUI │ │ │ │ │ +00041490: 4c54 5f53 4f55 5243 4553 2720 6966 2074 LT_SOURCES' if t │ │ │ │ │ +000414a0: 6865 2061 6269 6c69 7479 2074 6f20 7275 he ability to ru │ │ │ │ │ +000414b0: 6e20 276d 616b 6520 666f 6f27 206f 6e20 n 'make foo' on │ │ │ │ │ +000414c0: 610a 636c 6561 6e20 7472 6565 2069 7320 a.clean tree is │ │ │ │ │ +000414d0: 696d 706f 7274 616e 7420 746f 2079 6f75 important to you │ │ │ │ │ +000414e0: 2e0a 0a20 2020 596f 7520 776f 6e27 7420 ... You won't │ │ │ │ │ +000414f0: 6164 6420 6578 706c 6963 6974 2064 6570 add explicit dep │ │ │ │ │ +00041500: 656e 6465 6e63 6965 7320 6966 2079 6f75 endencies if you │ │ │ │ │ +00041510: 2061 7265 206c 6565 7279 206f 6620 6f76 are leery of ov │ │ │ │ │ +00041520: 6572 7269 6469 6e67 2061 6e0a 4175 746f erriding an.Auto │ │ │ │ │ +00041530: 6d61 6b65 2072 756c 6520 6279 206d 6973 make rule by mis │ │ │ │ │ +00041540: 7461 6b65 2e0a 0a20 2020 4275 696c 6469 take... Buildi │ │ │ │ │ +00041550: 6e67 2066 696c 6573 2066 726f 6d20 272e ng files from '. │ │ │ │ │ +00041560: 2f63 6f6e 6669 6775 7265 2720 6973 206e /configure' is n │ │ │ │ │ +00041570: 6f74 2061 6c77 6179 7320 706f 7373 6962 ot always possib │ │ │ │ │ +00041580: 6c65 2c20 6e65 6974 6865 7220 6973 0a63 le, neither is.c │ │ │ │ │ +00041590: 6f6e 7665 7274 696e 6720 272e 6827 2066 onverting '.h' f │ │ │ │ │ +000415a0: 696c 6573 2069 6e74 6f20 272e 6327 2066 iles into '.c' f │ │ │ │ │ +000415b0: 696c 6573 2e0a 0a1f 0a46 696c 653a 2061 iles.....File: a │ │ │ │ │ +000415c0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +000415d0: 6f2c 2020 4e6f 6465 3a20 4f74 6865 7220 o, Node: Other │ │ │ │ │ +000415e0: 474e 5520 546f 6f6c 732c 2020 4e65 7874 GNU Tools, Next │ │ │ │ │ +000415f0: 3a20 446f 6375 6d65 6e74 6174 696f 6e2c : Documentation, │ │ │ │ │ +00041600: 2020 5072 6576 3a20 4f74 6865 7220 4f62 Prev: Other Ob │ │ │ │ │ +00041610: 6a65 6374 732c 2020 5570 3a20 546f 700a jects, Up: Top. │ │ │ │ │ +00041620: 0a31 3020 4f74 6865 7220 474e 5520 546f .10 Other GNU To │ │ │ │ │ +00041630: 6f6c 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ols.************ │ │ │ │ │ +00041640: 2a2a 2a2a 2a2a 0a0a 5369 6e63 6520 4175 ******..Since Au │ │ │ │ │ +00041650: 746f 6d61 6b65 2069 7320 7072 696d 6172 tomake is primar │ │ │ │ │ +00041660: 696c 7920 696e 7465 6e64 6564 2074 6f20 ily intended to │ │ │ │ │ +00041670: 6765 6e65 7261 7465 2027 4d61 6b65 6669 generate 'Makefi │ │ │ │ │ +00041680: 6c65 2e69 6e27 7320 666f 7220 7573 650a le.in's for use. │ │ │ │ │ +00041690: 696e 2047 4e55 2070 726f 6772 616d 732c in GNU programs, │ │ │ │ │ +000416a0: 2069 7420 7472 6965 7320 6861 7264 2074 it tries hard t │ │ │ │ │ +000416b0: 6f20 696e 7465 726f 7065 7261 7465 2077 o interoperate w │ │ │ │ │ +000416c0: 6974 6820 6f74 6865 7220 474e 5520 746f ith other GNU to │ │ │ │ │ +000416d0: 6f6c 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a ols...* Menu:..* │ │ │ │ │ +000416e0: 2045 6d61 6373 204c 6973 703a 3a20 2020 Emacs Lisp:: │ │ │ │ │ +000416f0: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +00041700: 6d61 6373 204c 6973 700a 2a20 6765 7474 macs Lisp.* gett │ │ │ │ │ +00041710: 6578 743a 3a20 2020 2020 2020 2020 2020 ext:: │ │ │ │ │ +00041720: 2020 2020 2020 2020 2020 4765 7474 6578 Gettex │ │ │ │ │ +00041730: 740a 2a20 4c69 6274 6f6f 6c3a 3a20 2020 t.* Libtool:: │ │ │ │ │ 00041740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041750: 4c69 6274 6f6f 6c0a 2a20 4a61 7661 3a3a Libtool.* Java:: │ │ │ │ │ -00041760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041770: 2020 2020 2020 2020 4a61 7661 2062 7974 Java byt │ │ │ │ │ -00041780: 6563 6f64 6520 636f 6d70 696c 6174 696f ecode compilatio │ │ │ │ │ -00041790: 6e20 2864 6570 7265 6361 7465 6429 0a2a n (deprecated).* │ │ │ │ │ -000417a0: 2050 7974 686f 6e3a 3a20 2020 2020 2020 Python:: │ │ │ │ │ -000417b0: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -000417c0: 7974 686f 6e0a 0a1f 0a46 696c 653a 2061 ython....File: a │ │ │ │ │ -000417d0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -000417e0: 6f2c 2020 4e6f 6465 3a20 456d 6163 7320 o, Node: Emacs │ │ │ │ │ -000417f0: 4c69 7370 2c20 204e 6578 743a 2067 6574 Lisp, Next: get │ │ │ │ │ -00041800: 7465 7874 2c20 2055 703a 204f 7468 6572 text, Up: Other │ │ │ │ │ -00041810: 2047 4e55 2054 6f6f 6c73 0a0a 3130 2e31 GNU Tools..10.1 │ │ │ │ │ -00041820: 2045 6d61 6373 204c 6973 700a 3d3d 3d3d Emacs Lisp.==== │ │ │ │ │ -00041830: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 ===========..Aut │ │ │ │ │ -00041840: 6f6d 616b 6520 7072 6f76 6964 6573 2073 omake provides s │ │ │ │ │ -00041850: 6f6d 6520 7375 7070 6f72 7420 666f 7220 ome support for │ │ │ │ │ -00041860: 456d 6163 7320 4c69 7370 2e20 2054 6865 Emacs Lisp. The │ │ │ │ │ -00041870: 2027 4c49 5350 2720 7072 696d 6172 7920 'LISP' primary │ │ │ │ │ -00041880: 6973 0a75 7365 6420 746f 2068 6f6c 6420 is.used to hold │ │ │ │ │ -00041890: 6120 6c69 7374 206f 6620 272e 656c 2720 a list of '.el' │ │ │ │ │ -000418a0: 6669 6c65 732e 2020 506f 7373 6962 6c65 files. Possible │ │ │ │ │ -000418b0: 2070 7265 6669 7865 7320 666f 7220 7468 prefixes for th │ │ │ │ │ -000418c0: 6973 2070 7269 6d61 7279 0a61 7265 2027 is primary.are ' │ │ │ │ │ -000418d0: 6c69 7370 5f27 2061 6e64 2027 6e6f 696e lisp_' and 'noin │ │ │ │ │ -000418e0: 7374 5f27 2e20 204e 6f74 6520 7468 6174 st_'. Note that │ │ │ │ │ -000418f0: 2069 6620 276c 6973 705f 4c49 5350 2720 if 'lisp_LISP' │ │ │ │ │ -00041900: 6973 2064 6566 696e 6564 2c20 7468 656e is defined, then │ │ │ │ │ -00041910: 0a27 636f 6e66 6967 7572 652e 6163 2720 .'configure.ac' │ │ │ │ │ -00041920: 6d75 7374 2072 756e 2027 414d 5f50 4154 must run 'AM_PAT │ │ │ │ │ -00041930: 485f 4c49 5350 4449 5227 2028 2a6e 6f74 H_LISPDIR' (*not │ │ │ │ │ -00041940: 6520 4d61 6372 6f73 3a3a 292e 0a0a 2020 e Macros::)... │ │ │ │ │ -00041950: 204c 6973 7020 736f 7572 6365 7320 6172 Lisp sources ar │ │ │ │ │ -00041960: 6520 6e6f 7420 6469 7374 7269 6275 7465 e not distribute │ │ │ │ │ -00041970: 6420 6279 2064 6566 6175 6c74 2e20 2059 d by default. Y │ │ │ │ │ -00041980: 6f75 2063 616e 2070 7265 6669 7820 7468 ou can prefix th │ │ │ │ │ -00041990: 650a 274c 4953 5027 2070 7269 6d61 7279 e.'LISP' primary │ │ │ │ │ -000419a0: 2077 6974 6820 2764 6973 745f 272c 2061 with 'dist_', a │ │ │ │ │ -000419b0: 7320 696e 2027 6469 7374 5f6c 6973 705f s in 'dist_lisp_ │ │ │ │ │ -000419c0: 4c49 5350 2720 6f72 0a27 6469 7374 5f6e LISP' or.'dist_n │ │ │ │ │ -000419d0: 6f69 6e73 745f 4c49 5350 272c 2074 6f20 oinst_LISP', to │ │ │ │ │ -000419e0: 696e 6469 6361 7465 2074 6861 7420 7468 indicate that th │ │ │ │ │ -000419f0: 6573 6520 6669 6c65 7320 7368 6f75 6c64 ese files should │ │ │ │ │ -00041a00: 2062 6520 6469 7374 7269 6275 7465 642e be distributed. │ │ │ │ │ -00041a10: 0a0a 2020 2041 7574 6f6d 616b 6520 7769 .. Automake wi │ │ │ │ │ -00041a20: 6c6c 2062 7974 652d 636f 6d70 696c 6520 ll byte-compile │ │ │ │ │ -00041a30: 616c 6c20 456d 6163 7320 4c69 7370 2073 all Emacs Lisp s │ │ │ │ │ -00041a40: 6f75 7263 6520 6669 6c65 7320 7573 696e ource files usin │ │ │ │ │ -00041a50: 6720 7468 650a 456d 6163 7320 666f 756e g the.Emacs foun │ │ │ │ │ -00041a60: 6420 6279 2027 414d 5f50 4154 485f 4c49 d by 'AM_PATH_LI │ │ │ │ │ -00041a70: 5350 4449 5227 2c20 6966 2061 6e79 2077 SPDIR', if any w │ │ │ │ │ -00041a80: 6173 2066 6f75 6e64 2e0a 0a20 2020 4279 as found... By │ │ │ │ │ -00041a90: 7465 2d63 6f6d 7069 6c65 6420 456d 6163 te-compiled Emac │ │ │ │ │ -00041aa0: 7320 4c69 7370 2066 696c 6573 2061 7265 s Lisp files are │ │ │ │ │ -00041ab0: 206e 6f74 2070 6f72 7461 626c 6520 616d not portable am │ │ │ │ │ -00041ac0: 6f6e 6720 616c 6c20 7665 7273 696f 6e73 ong all versions │ │ │ │ │ -00041ad0: 206f 660a 456d 6163 732c 2073 6f20 6974 of.Emacs, so it │ │ │ │ │ -00041ae0: 206d 616b 6573 2073 656e 7365 2074 6f20 makes sense to │ │ │ │ │ -00041af0: 7475 726e 2074 6869 7320 6f66 6620 6966 turn this off if │ │ │ │ │ -00041b00: 2079 6f75 2065 7870 6563 7420 7369 7465 you expect site │ │ │ │ │ -00041b10: 7320 746f 2068 6176 650a 6d6f 7265 2074 s to have.more t │ │ │ │ │ -00041b20: 6861 6e20 6f6e 6520 7665 7273 696f 6e20 han one version │ │ │ │ │ -00041b30: 6f66 2045 6d61 6373 2069 6e73 7461 6c6c of Emacs install │ │ │ │ │ -00041b40: 6564 2e20 2046 7572 7468 6572 6d6f 7265 ed. Furthermore │ │ │ │ │ -00041b50: 2c20 6d61 6e79 2070 6163 6b61 6765 730a , many packages. │ │ │ │ │ -00041b60: 646f 6e27 7420 6163 7475 616c 6c79 2062 don't actually b │ │ │ │ │ -00041b70: 656e 6566 6974 2066 726f 6d20 6279 7465 enefit from byte │ │ │ │ │ -00041b80: 2d63 6f6d 7069 6c61 7469 6f6e 2e20 2053 -compilation. S │ │ │ │ │ -00041b90: 7469 6c6c 2c20 7765 2072 6563 6f6d 6d65 till, we recomme │ │ │ │ │ -00041ba0: 6e64 2074 6861 740a 796f 7520 6279 7465 nd that.you byte │ │ │ │ │ -00041bb0: 2d63 6f6d 7069 6c65 2079 6f75 7220 456d -compile your Em │ │ │ │ │ -00041bc0: 6163 7320 4c69 7370 2073 6f75 7263 6573 acs Lisp sources │ │ │ │ │ -00041bd0: 2e20 2049 7420 6973 2070 726f 6261 626c . It is probabl │ │ │ │ │ -00041be0: 7920 6265 7474 6572 2066 6f72 0a73 6974 y better for.sit │ │ │ │ │ -00041bf0: 6573 2077 6974 6820 7374 7261 6e67 6520 es with strange │ │ │ │ │ -00041c00: 7365 7475 7073 2074 6f20 636f 7065 2066 setups to cope f │ │ │ │ │ -00041c10: 6f72 2074 6865 6d73 656c 7665 7320 7468 or themselves th │ │ │ │ │ -00041c20: 616e 2074 6f20 6d61 6b65 2074 6865 0a69 an to make the.i │ │ │ │ │ -00041c30: 6e73 7461 6c6c 6174 696f 6e20 6c65 7373 nstallation less │ │ │ │ │ -00041c40: 206e 6963 6520 666f 7220 6576 6572 7962 nice for everyb │ │ │ │ │ -00041c50: 6f64 7920 656c 7365 2e0a 0a20 2020 5468 ody else... Th │ │ │ │ │ -00041c60: 6572 6520 6172 6520 7477 6f20 7761 7973 ere are two ways │ │ │ │ │ -00041c70: 2074 6f20 6176 6f69 6420 6279 7465 2d63 to avoid byte-c │ │ │ │ │ -00041c80: 6f6d 7069 6c69 6e67 2e20 2048 6973 746f ompiling. Histo │ │ │ │ │ -00041c90: 7269 6361 6c6c 792c 2077 6520 6861 7665 rically, we have │ │ │ │ │ -00041ca0: 0a72 6563 6f6d 6d65 6e64 6564 2074 6865 .recommended the │ │ │ │ │ -00041cb0: 2066 6f6c 6c6f 7769 6e67 2063 6f6e 7374 following const │ │ │ │ │ -00041cc0: 7275 6374 2e0a 0a20 2020 2020 6c69 7370 ruct... lisp │ │ │ │ │ -00041cd0: 5f4c 4953 5020 3d20 6669 6c65 312e 656c _LISP = file1.el │ │ │ │ │ -00041ce0: 2066 696c 6532 2e65 6c0a 2020 2020 2045 file2.el. E │ │ │ │ │ -00041cf0: 4c43 4649 4c45 5320 3d0a 0a27 454c 4346 LCFILES =..'ELCF │ │ │ │ │ -00041d00: 494c 4553 2720 6973 2061 6e20 696e 7465 ILES' is an inte │ │ │ │ │ -00041d10: 726e 616c 2041 7574 6f6d 616b 6520 7661 rnal Automake va │ │ │ │ │ -00041d20: 7269 6162 6c65 2074 6861 7420 6e6f 726d riable that norm │ │ │ │ │ -00041d30: 616c 6c79 206c 6973 7473 2061 6c6c 0a27 ally lists all.' │ │ │ │ │ -00041d40: 2e65 6c63 2720 6669 6c65 7320 7468 6174 .elc' files that │ │ │ │ │ -00041d50: 206d 7573 7420 6265 2062 7974 652d 636f must be byte-co │ │ │ │ │ -00041d60: 6d70 696c 6564 2e20 2041 7574 6f6d 616b mpiled. Automak │ │ │ │ │ -00041d70: 6520 6465 6669 6e65 7320 2745 4c43 4649 e defines 'ELCFI │ │ │ │ │ -00041d80: 4c45 5327 0a61 7574 6f6d 6174 6963 616c LES'.automatical │ │ │ │ │ -00041d90: 6c79 2066 726f 6d20 276c 6973 705f 4c49 ly from 'lisp_LI │ │ │ │ │ -00041da0: 5350 272e 2020 456d 7074 7969 6e67 2074 SP'. Emptying t │ │ │ │ │ -00041db0: 6869 7320 7661 7269 6162 6c65 2065 7870 his variable exp │ │ │ │ │ -00041dc0: 6c69 6369 746c 790a 7072 6576 656e 7473 licitly.prevents │ │ │ │ │ -00041dd0: 2062 7974 652d 636f 6d70 696c 6174 696f byte-compilatio │ │ │ │ │ -00041de0: 6e2e 0a0a 2020 2053 696e 6365 2041 7574 n... Since Aut │ │ │ │ │ -00041df0: 6f6d 616b 6520 312e 382c 2077 6520 6e6f omake 1.8, we no │ │ │ │ │ -00041e00: 7720 7265 636f 6d6d 656e 6420 7573 696e w recommend usin │ │ │ │ │ -00041e10: 6720 276c 6973 705f 4441 5441 2720 696e g 'lisp_DATA' in │ │ │ │ │ -00041e20: 7374 6561 643a 0a0a 2020 2020 206c 6973 stead:.. lis │ │ │ │ │ -00041e30: 705f 4441 5441 203d 2066 696c 6531 2e65 p_DATA = file1.e │ │ │ │ │ -00041e40: 6c20 6669 6c65 322e 656c 0a0a 2020 204e l file2.el.. N │ │ │ │ │ -00041e50: 6f74 6520 7468 6174 2074 6865 7365 2074 ote that these t │ │ │ │ │ -00041e60: 776f 2063 6f6e 7374 7275 6374 7320 6172 wo constructs ar │ │ │ │ │ -00041e70: 6520 6e6f 7420 6571 7569 7661 6c65 6e74 e not equivalent │ │ │ │ │ -00041e80: 2e20 2027 5f4c 4953 5027 2077 696c 6c20 . '_LISP' will │ │ │ │ │ -00041e90: 6e6f 740a 696e 7374 616c 6c20 6120 6669 not.install a fi │ │ │ │ │ -00041ea0: 6c65 2069 6620 456d 6163 7320 6973 206e le if Emacs is n │ │ │ │ │ -00041eb0: 6f74 2069 6e73 7461 6c6c 6564 2c20 7768 ot installed, wh │ │ │ │ │ -00041ec0: 696c 6520 275f 4441 5441 2720 7769 6c6c ile '_DATA' will │ │ │ │ │ -00041ed0: 2061 6c77 6179 730a 696e 7374 616c 6c20 always.install │ │ │ │ │ -00041ee0: 6974 7320 6669 6c65 732e 0a0a 1f0a 4669 its files.....Fi │ │ │ │ │ -00041ef0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ -00041f00: 312e 696e 666f 2c20 204e 6f64 653a 2067 1.info, Node: g │ │ │ │ │ -00041f10: 6574 7465 7874 2c20 204e 6578 743a 204c ettext, Next: L │ │ │ │ │ -00041f20: 6962 746f 6f6c 2c20 2050 7265 763a 2045 ibtool, Prev: E │ │ │ │ │ -00041f30: 6d61 6373 204c 6973 702c 2020 5570 3a20 macs Lisp, Up: │ │ │ │ │ -00041f40: 4f74 6865 7220 474e 5520 546f 6f6c 730a Other GNU Tools. │ │ │ │ │ -00041f50: 0a31 302e 3220 4765 7474 6578 740a 3d3d .10.2 Gettext.== │ │ │ │ │ -00041f60: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2027 ==========..If ' │ │ │ │ │ -00041f70: 414d 5f47 4e55 5f47 4554 5445 5854 2720 AM_GNU_GETTEXT' │ │ │ │ │ -00041f80: 6973 2073 6565 6e20 696e 2027 636f 6e66 is seen in 'conf │ │ │ │ │ -00041f90: 6967 7572 652e 6163 272c 2074 6865 6e20 igure.ac', then │ │ │ │ │ -00041fa0: 4175 746f 6d61 6b65 2074 7572 6e73 206f Automake turns o │ │ │ │ │ -00041fb0: 6e0a 7375 7070 6f72 7420 666f 7220 474e n.support for GN │ │ │ │ │ -00041fc0: 5520 6765 7474 6578 742c 2061 206d 6573 U gettext, a mes │ │ │ │ │ -00041fd0: 7361 6765 2063 6174 616c 6f67 2073 7973 sage catalog sys │ │ │ │ │ -00041fe0: 7465 6d20 666f 720a 696e 7465 726e 6174 tem for.internat │ │ │ │ │ -00041ff0: 696f 6e61 6c69 7a61 7469 6f6e 2028 2a6e ionalization (*n │ │ │ │ │ -00042000: 6f74 6520 496e 7472 6f64 7563 7469 6f6e ote Introduction │ │ │ │ │ -00042010: 3a20 2867 6574 7465 7874 2954 6f70 2e29 : (gettext)Top.) │ │ │ │ │ -00042020: 2e0a 0a20 2020 5468 6520 2767 6574 7465 ... The 'gette │ │ │ │ │ -00042030: 7874 2720 7375 7070 6f72 7420 696e 2041 xt' support in A │ │ │ │ │ -00042040: 7574 6f6d 616b 6520 7265 7175 6972 6573 utomake requires │ │ │ │ │ -00042050: 2074 6865 2061 6464 6974 696f 6e20 6f66 the addition of │ │ │ │ │ -00042060: 206f 6e65 206f 7220 7477 6f0a 7375 6264 one or two.subd │ │ │ │ │ -00042070: 6972 6563 746f 7269 6573 2074 6f20 7468 irectories to th │ │ │ │ │ -00042080: 6520 7061 636b 6167 653a 2027 706f 2720 e package: 'po' │ │ │ │ │ -00042090: 616e 6420 706f 7373 6962 6c79 2061 6c73 and possibly als │ │ │ │ │ -000420a0: 6f20 2769 6e74 6c27 2e20 2054 6865 0a6c o 'intl'. The.l │ │ │ │ │ -000420b0: 6174 7465 7220 6973 206e 6565 6465 6420 atter is needed │ │ │ │ │ -000420c0: 6966 2027 414d 5f47 4e55 5f47 4554 5445 if 'AM_GNU_GETTE │ │ │ │ │ -000420d0: 5854 2720 6973 206e 6f74 2069 6e76 6f6b XT' is not invok │ │ │ │ │ -000420e0: 6564 2077 6974 6820 7468 6520 2765 7874 ed with the 'ext │ │ │ │ │ -000420f0: 6572 6e61 6c27 0a61 7267 756d 656e 742c ernal'.argument, │ │ │ │ │ -00042100: 206f 7220 6966 2027 414d 5f47 4e55 5f47 or if 'AM_GNU_G │ │ │ │ │ -00042110: 4554 5445 5854 5f49 4e54 4c5f 5355 4244 ETTEXT_INTL_SUBD │ │ │ │ │ -00042120: 4952 2720 6973 2075 7365 642e 2020 4175 IR' is used. Au │ │ │ │ │ -00042130: 746f 6d61 6b65 2065 6e73 7572 6573 0a74 tomake ensures.t │ │ │ │ │ -00042140: 6861 7420 7468 6573 6520 6469 7265 6374 hat these direct │ │ │ │ │ -00042150: 6f72 6965 7320 6578 6973 7420 616e 6420 ories exist and │ │ │ │ │ -00042160: 6172 6520 6d65 6e74 696f 6e65 6420 696e are mentioned in │ │ │ │ │ -00042170: 2027 5355 4244 4952 5327 2e0a 0a1f 0a46 'SUBDIRS'.....F │ │ │ │ │ -00042180: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -00042190: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -000421a0: 4c69 6274 6f6f 6c2c 2020 4e65 7874 3a20 Libtool, Next: │ │ │ │ │ -000421b0: 4a61 7661 2c20 2050 7265 763a 2067 6574 Java, Prev: get │ │ │ │ │ -000421c0: 7465 7874 2c20 2055 703a 204f 7468 6572 text, Up: Other │ │ │ │ │ -000421d0: 2047 4e55 2054 6f6f 6c73 0a0a 3130 2e33 GNU Tools..10.3 │ │ │ │ │ -000421e0: 204c 6962 746f 6f6c 0a3d 3d3d 3d3d 3d3d Libtool.======= │ │ │ │ │ -000421f0: 3d3d 3d3d 3d0a 0a41 7574 6f6d 616b 6520 =====..Automake │ │ │ │ │ -00042200: 7072 6f76 6964 6573 2073 7570 706f 7274 provides support │ │ │ │ │ -00042210: 2066 6f72 2047 4e55 204c 6962 746f 6f6c for GNU Libtool │ │ │ │ │ -00042220: 2028 2a6e 6f74 6520 496e 7472 6f64 7563 (*note Introduc │ │ │ │ │ -00042230: 7469 6f6e 3a0a 286c 6962 746f 6f6c 2954 tion:.(libtool)T │ │ │ │ │ -00042240: 6f70 2e29 2077 6974 6820 7468 6520 274c op.) with the 'L │ │ │ │ │ -00042250: 544c 4942 5241 5249 4553 2720 7072 696d TLIBRARIES' prim │ │ │ │ │ -00042260: 6172 792e 2020 2a4e 6f74 6520 4120 5368 ary. *Note A Sh │ │ │ │ │ -00042270: 6172 6564 0a4c 6962 7261 7279 3a3a 2e0a ared.Library::.. │ │ │ │ │ -00042280: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -00042290: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -000422a0: 6465 3a20 4a61 7661 2c20 204e 6578 743a de: Java, Next: │ │ │ │ │ -000422b0: 2050 7974 686f 6e2c 2020 5072 6576 3a20 Python, Prev: │ │ │ │ │ -000422c0: 4c69 6274 6f6f 6c2c 2020 5570 3a20 4f74 Libtool, Up: Ot │ │ │ │ │ -000422d0: 6865 7220 474e 5520 546f 6f6c 730a 0a31 her GNU Tools..1 │ │ │ │ │ -000422e0: 302e 3420 4a61 7661 2062 7974 6563 6f64 0.4 Java bytecod │ │ │ │ │ -000422f0: 6520 636f 6d70 696c 6174 696f 6e20 2864 e compilation (d │ │ │ │ │ -00042300: 6570 7265 6361 7465 6429 0a3d 3d3d 3d3d eprecated).===== │ │ │ │ │ +00041750: 2020 4c69 6274 6f6f 6c0a 2a20 4a61 7661 Libtool.* Java │ │ │ │ │ +00041760: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00041770: 2020 2020 2020 2020 2020 4a61 7661 2062 Java b │ │ │ │ │ +00041780: 7974 6563 6f64 6520 636f 6d70 696c 6174 ytecode compilat │ │ │ │ │ +00041790: 696f 6e20 2864 6570 7265 6361 7465 6429 ion (deprecated) │ │ │ │ │ +000417a0: 0a2a 2050 7974 686f 6e3a 3a20 2020 2020 .* Python:: │ │ │ │ │ +000417b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000417c0: 2050 7974 686f 6e0a 0a1f 0a46 696c 653a Python....File: │ │ │ │ │ +000417d0: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +000417e0: 6e66 6f2c 2020 4e6f 6465 3a20 456d 6163 nfo, Node: Emac │ │ │ │ │ +000417f0: 7320 4c69 7370 2c20 204e 6578 743a 2067 s Lisp, Next: g │ │ │ │ │ +00041800: 6574 7465 7874 2c20 2055 703a 204f 7468 ettext, Up: Oth │ │ │ │ │ +00041810: 6572 2047 4e55 2054 6f6f 6c73 0a0a 3130 er GNU Tools..10 │ │ │ │ │ +00041820: 2e31 2045 6d61 6373 204c 6973 700a 3d3d .1 Emacs Lisp.== │ │ │ │ │ +00041830: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 =============..A │ │ │ │ │ +00041840: 7574 6f6d 616b 6520 7072 6f76 6964 6573 utomake provides │ │ │ │ │ +00041850: 2073 6f6d 6520 7375 7070 6f72 7420 666f some support fo │ │ │ │ │ +00041860: 7220 456d 6163 7320 4c69 7370 2e20 2054 r Emacs Lisp. T │ │ │ │ │ +00041870: 6865 2027 4c49 5350 2720 7072 696d 6172 he 'LISP' primar │ │ │ │ │ +00041880: 7920 6973 0a75 7365 6420 746f 2068 6f6c y is.used to hol │ │ │ │ │ +00041890: 6420 6120 6c69 7374 206f 6620 272e 656c d a list of '.el │ │ │ │ │ +000418a0: 2720 6669 6c65 732e 2020 506f 7373 6962 ' files. Possib │ │ │ │ │ +000418b0: 6c65 2070 7265 6669 7865 7320 666f 7220 le prefixes for │ │ │ │ │ +000418c0: 7468 6973 2070 7269 6d61 7279 0a61 7265 this primary.are │ │ │ │ │ +000418d0: 2027 6c69 7370 5f27 2061 6e64 2027 6e6f 'lisp_' and 'no │ │ │ │ │ +000418e0: 696e 7374 5f27 2e20 204e 6f74 6520 7468 inst_'. Note th │ │ │ │ │ +000418f0: 6174 2069 6620 276c 6973 705f 4c49 5350 at if 'lisp_LISP │ │ │ │ │ +00041900: 2720 6973 2064 6566 696e 6564 2c20 7468 ' is defined, th │ │ │ │ │ +00041910: 656e 0a27 636f 6e66 6967 7572 652e 6163 en.'configure.ac │ │ │ │ │ +00041920: 2720 6d75 7374 2072 756e 2027 414d 5f50 ' must run 'AM_P │ │ │ │ │ +00041930: 4154 485f 4c49 5350 4449 5227 2028 2a6e ATH_LISPDIR' (*n │ │ │ │ │ +00041940: 6f74 6520 4d61 6372 6f73 3a3a 292e 0a0a ote Macros::)... │ │ │ │ │ +00041950: 2020 204c 6973 7020 736f 7572 6365 7320 Lisp sources │ │ │ │ │ +00041960: 6172 6520 6e6f 7420 6469 7374 7269 6275 are not distribu │ │ │ │ │ +00041970: 7465 6420 6279 2064 6566 6175 6c74 2e20 ted by default. │ │ │ │ │ +00041980: 2059 6f75 2063 616e 2070 7265 6669 7820 You can prefix │ │ │ │ │ +00041990: 7468 650a 274c 4953 5027 2070 7269 6d61 the.'LISP' prima │ │ │ │ │ +000419a0: 7279 2077 6974 6820 2764 6973 745f 272c ry with 'dist_', │ │ │ │ │ +000419b0: 2061 7320 696e 2027 6469 7374 5f6c 6973 as in 'dist_lis │ │ │ │ │ +000419c0: 705f 4c49 5350 2720 6f72 0a27 6469 7374 p_LISP' or.'dist │ │ │ │ │ +000419d0: 5f6e 6f69 6e73 745f 4c49 5350 272c 2074 _noinst_LISP', t │ │ │ │ │ +000419e0: 6f20 696e 6469 6361 7465 2074 6861 7420 o indicate that │ │ │ │ │ +000419f0: 7468 6573 6520 6669 6c65 7320 7368 6f75 these files shou │ │ │ │ │ +00041a00: 6c64 2062 6520 6469 7374 7269 6275 7465 ld be distribute │ │ │ │ │ +00041a10: 642e 0a0a 2020 2041 7574 6f6d 616b 6520 d... Automake │ │ │ │ │ +00041a20: 7769 6c6c 2062 7974 652d 636f 6d70 696c will byte-compil │ │ │ │ │ +00041a30: 6520 616c 6c20 456d 6163 7320 4c69 7370 e all Emacs Lisp │ │ │ │ │ +00041a40: 2073 6f75 7263 6520 6669 6c65 7320 7573 source files us │ │ │ │ │ +00041a50: 696e 6720 7468 650a 456d 6163 7320 666f ing the.Emacs fo │ │ │ │ │ +00041a60: 756e 6420 6279 2027 414d 5f50 4154 485f und by 'AM_PATH_ │ │ │ │ │ +00041a70: 4c49 5350 4449 5227 2c20 6966 2061 6e79 LISPDIR', if any │ │ │ │ │ +00041a80: 2077 6173 2066 6f75 6e64 2e0a 0a20 2020 was found... │ │ │ │ │ +00041a90: 4279 7465 2d63 6f6d 7069 6c65 6420 456d Byte-compiled Em │ │ │ │ │ +00041aa0: 6163 7320 4c69 7370 2066 696c 6573 2061 acs Lisp files a │ │ │ │ │ +00041ab0: 7265 206e 6f74 2070 6f72 7461 626c 6520 re not portable │ │ │ │ │ +00041ac0: 616d 6f6e 6720 616c 6c20 7665 7273 696f among all versio │ │ │ │ │ +00041ad0: 6e73 206f 660a 456d 6163 732c 2073 6f20 ns of.Emacs, so │ │ │ │ │ +00041ae0: 6974 206d 616b 6573 2073 656e 7365 2074 it makes sense t │ │ │ │ │ +00041af0: 6f20 7475 726e 2074 6869 7320 6f66 6620 o turn this off │ │ │ │ │ +00041b00: 6966 2079 6f75 2065 7870 6563 7420 7369 if you expect si │ │ │ │ │ +00041b10: 7465 7320 746f 2068 6176 650a 6d6f 7265 tes to have.more │ │ │ │ │ +00041b20: 2074 6861 6e20 6f6e 6520 7665 7273 696f than one versio │ │ │ │ │ +00041b30: 6e20 6f66 2045 6d61 6373 2069 6e73 7461 n of Emacs insta │ │ │ │ │ +00041b40: 6c6c 6564 2e20 2046 7572 7468 6572 6d6f lled. Furthermo │ │ │ │ │ +00041b50: 7265 2c20 6d61 6e79 2070 6163 6b61 6765 re, many package │ │ │ │ │ +00041b60: 730a 646f 6e27 7420 6163 7475 616c 6c79 s.don't actually │ │ │ │ │ +00041b70: 2062 656e 6566 6974 2066 726f 6d20 6279 benefit from by │ │ │ │ │ +00041b80: 7465 2d63 6f6d 7069 6c61 7469 6f6e 2e20 te-compilation. │ │ │ │ │ +00041b90: 2053 7469 6c6c 2c20 7765 2072 6563 6f6d Still, we recom │ │ │ │ │ +00041ba0: 6d65 6e64 2074 6861 740a 796f 7520 6279 mend that.you by │ │ │ │ │ +00041bb0: 7465 2d63 6f6d 7069 6c65 2079 6f75 7220 te-compile your │ │ │ │ │ +00041bc0: 456d 6163 7320 4c69 7370 2073 6f75 7263 Emacs Lisp sourc │ │ │ │ │ +00041bd0: 6573 2e20 2049 7420 6973 2070 726f 6261 es. It is proba │ │ │ │ │ +00041be0: 626c 7920 6265 7474 6572 2066 6f72 0a73 bly better for.s │ │ │ │ │ +00041bf0: 6974 6573 2077 6974 6820 7374 7261 6e67 ites with strang │ │ │ │ │ +00041c00: 6520 7365 7475 7073 2074 6f20 636f 7065 e setups to cope │ │ │ │ │ +00041c10: 2066 6f72 2074 6865 6d73 656c 7665 7320 for themselves │ │ │ │ │ +00041c20: 7468 616e 2074 6f20 6d61 6b65 2074 6865 than to make the │ │ │ │ │ +00041c30: 0a69 6e73 7461 6c6c 6174 696f 6e20 6c65 .installation le │ │ │ │ │ +00041c40: 7373 206e 6963 6520 666f 7220 6576 6572 ss nice for ever │ │ │ │ │ +00041c50: 7962 6f64 7920 656c 7365 2e0a 0a20 2020 ybody else... │ │ │ │ │ +00041c60: 5468 6572 6520 6172 6520 7477 6f20 7761 There are two wa │ │ │ │ │ +00041c70: 7973 2074 6f20 6176 6f69 6420 6279 7465 ys to avoid byte │ │ │ │ │ +00041c80: 2d63 6f6d 7069 6c69 6e67 2e20 2048 6973 -compiling. His │ │ │ │ │ +00041c90: 746f 7269 6361 6c6c 792c 2077 6520 6861 torically, we ha │ │ │ │ │ +00041ca0: 7665 0a72 6563 6f6d 6d65 6e64 6564 2074 ve.recommended t │ │ │ │ │ +00041cb0: 6865 2066 6f6c 6c6f 7769 6e67 2063 6f6e he following con │ │ │ │ │ +00041cc0: 7374 7275 6374 2e0a 0a20 2020 2020 6c69 struct... li │ │ │ │ │ +00041cd0: 7370 5f4c 4953 5020 3d20 6669 6c65 312e sp_LISP = file1. │ │ │ │ │ +00041ce0: 656c 2066 696c 6532 2e65 6c0a 2020 2020 el file2.el. │ │ │ │ │ +00041cf0: 2045 4c43 4649 4c45 5320 3d0a 0a27 454c ELCFILES =..'EL │ │ │ │ │ +00041d00: 4346 494c 4553 2720 6973 2061 6e20 696e CFILES' is an in │ │ │ │ │ +00041d10: 7465 726e 616c 2041 7574 6f6d 616b 6520 ternal Automake │ │ │ │ │ +00041d20: 7661 7269 6162 6c65 2074 6861 7420 6e6f variable that no │ │ │ │ │ +00041d30: 726d 616c 6c79 206c 6973 7473 2061 6c6c rmally lists all │ │ │ │ │ +00041d40: 0a27 2e65 6c63 2720 6669 6c65 7320 7468 .'.elc' files th │ │ │ │ │ +00041d50: 6174 206d 7573 7420 6265 2062 7974 652d at must be byte- │ │ │ │ │ +00041d60: 636f 6d70 696c 6564 2e20 2041 7574 6f6d compiled. Autom │ │ │ │ │ +00041d70: 616b 6520 6465 6669 6e65 7320 2745 4c43 ake defines 'ELC │ │ │ │ │ +00041d80: 4649 4c45 5327 0a61 7574 6f6d 6174 6963 FILES'.automatic │ │ │ │ │ +00041d90: 616c 6c79 2066 726f 6d20 276c 6973 705f ally from 'lisp_ │ │ │ │ │ +00041da0: 4c49 5350 272e 2020 456d 7074 7969 6e67 LISP'. Emptying │ │ │ │ │ +00041db0: 2074 6869 7320 7661 7269 6162 6c65 2065 this variable e │ │ │ │ │ +00041dc0: 7870 6c69 6369 746c 790a 7072 6576 656e xplicitly.preven │ │ │ │ │ +00041dd0: 7473 2062 7974 652d 636f 6d70 696c 6174 ts byte-compilat │ │ │ │ │ +00041de0: 696f 6e2e 0a0a 2020 2053 696e 6365 2041 ion... Since A │ │ │ │ │ +00041df0: 7574 6f6d 616b 6520 312e 382c 2077 6520 utomake 1.8, we │ │ │ │ │ +00041e00: 6e6f 7720 7265 636f 6d6d 656e 6420 7573 now recommend us │ │ │ │ │ +00041e10: 696e 6720 276c 6973 705f 4441 5441 2720 ing 'lisp_DATA' │ │ │ │ │ +00041e20: 696e 7374 6561 643a 0a0a 2020 2020 206c instead:.. l │ │ │ │ │ +00041e30: 6973 705f 4441 5441 203d 2066 696c 6531 isp_DATA = file1 │ │ │ │ │ +00041e40: 2e65 6c20 6669 6c65 322e 656c 0a0a 2020 .el file2.el.. │ │ │ │ │ +00041e50: 204e 6f74 6520 7468 6174 2074 6865 7365 Note that these │ │ │ │ │ +00041e60: 2074 776f 2063 6f6e 7374 7275 6374 7320 two constructs │ │ │ │ │ +00041e70: 6172 6520 6e6f 7420 6571 7569 7661 6c65 are not equivale │ │ │ │ │ +00041e80: 6e74 2e20 2027 5f4c 4953 5027 2077 696c nt. '_LISP' wil │ │ │ │ │ +00041e90: 6c20 6e6f 740a 696e 7374 616c 6c20 6120 l not.install a │ │ │ │ │ +00041ea0: 6669 6c65 2069 6620 456d 6163 7320 6973 file if Emacs is │ │ │ │ │ +00041eb0: 206e 6f74 2069 6e73 7461 6c6c 6564 2c20 not installed, │ │ │ │ │ +00041ec0: 7768 696c 6520 275f 4441 5441 2720 7769 while '_DATA' wi │ │ │ │ │ +00041ed0: 6c6c 2061 6c77 6179 730a 696e 7374 616c ll always.instal │ │ │ │ │ +00041ee0: 6c20 6974 7320 6669 6c65 732e 0a0a 1f0a l its files..... │ │ │ │ │ +00041ef0: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +00041f00: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +00041f10: 2067 6574 7465 7874 2c20 204e 6578 743a gettext, Next: │ │ │ │ │ +00041f20: 204c 6962 746f 6f6c 2c20 2050 7265 763a Libtool, Prev: │ │ │ │ │ +00041f30: 2045 6d61 6373 204c 6973 702c 2020 5570 Emacs Lisp, Up │ │ │ │ │ +00041f40: 3a20 4f74 6865 7220 474e 5520 546f 6f6c : Other GNU Tool │ │ │ │ │ +00041f50: 730a 0a31 302e 3220 4765 7474 6578 740a s..10.2 Gettext. │ │ │ │ │ +00041f60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4966 ============..If │ │ │ │ │ +00041f70: 2027 414d 5f47 4e55 5f47 4554 5445 5854 'AM_GNU_GETTEXT │ │ │ │ │ +00041f80: 2720 6973 2073 6565 6e20 696e 2027 636f ' is seen in 'co │ │ │ │ │ +00041f90: 6e66 6967 7572 652e 6163 272c 2074 6865 nfigure.ac', the │ │ │ │ │ +00041fa0: 6e20 4175 746f 6d61 6b65 2074 7572 6e73 n Automake turns │ │ │ │ │ +00041fb0: 206f 6e0a 7375 7070 6f72 7420 666f 7220 on.support for │ │ │ │ │ +00041fc0: 474e 5520 6765 7474 6578 742c 2061 206d GNU gettext, a m │ │ │ │ │ +00041fd0: 6573 7361 6765 2063 6174 616c 6f67 2073 essage catalog s │ │ │ │ │ +00041fe0: 7973 7465 6d20 666f 720a 696e 7465 726e ystem for.intern │ │ │ │ │ +00041ff0: 6174 696f 6e61 6c69 7a61 7469 6f6e 2028 ationalization ( │ │ │ │ │ +00042000: 2a6e 6f74 6520 496e 7472 6f64 7563 7469 *note Introducti │ │ │ │ │ +00042010: 6f6e 3a20 2867 6574 7465 7874 2954 6f70 on: (gettext)Top │ │ │ │ │ +00042020: 2e29 2e0a 0a20 2020 5468 6520 2767 6574 .)... The 'get │ │ │ │ │ +00042030: 7465 7874 2720 7375 7070 6f72 7420 696e text' support in │ │ │ │ │ +00042040: 2041 7574 6f6d 616b 6520 7265 7175 6972 Automake requir │ │ │ │ │ +00042050: 6573 2074 6865 2061 6464 6974 696f 6e20 es the addition │ │ │ │ │ +00042060: 6f66 206f 6e65 206f 7220 7477 6f0a 7375 of one or two.su │ │ │ │ │ +00042070: 6264 6972 6563 746f 7269 6573 2074 6f20 bdirectories to │ │ │ │ │ +00042080: 7468 6520 7061 636b 6167 653a 2027 706f the package: 'po │ │ │ │ │ +00042090: 2720 616e 6420 706f 7373 6962 6c79 2061 ' and possibly a │ │ │ │ │ +000420a0: 6c73 6f20 2769 6e74 6c27 2e20 2054 6865 lso 'intl'. The │ │ │ │ │ +000420b0: 0a6c 6174 7465 7220 6973 206e 6565 6465 .latter is neede │ │ │ │ │ +000420c0: 6420 6966 2027 414d 5f47 4e55 5f47 4554 d if 'AM_GNU_GET │ │ │ │ │ +000420d0: 5445 5854 2720 6973 206e 6f74 2069 6e76 TEXT' is not inv │ │ │ │ │ +000420e0: 6f6b 6564 2077 6974 6820 7468 6520 2765 oked with the 'e │ │ │ │ │ +000420f0: 7874 6572 6e61 6c27 0a61 7267 756d 656e xternal'.argumen │ │ │ │ │ +00042100: 742c 206f 7220 6966 2027 414d 5f47 4e55 t, or if 'AM_GNU │ │ │ │ │ +00042110: 5f47 4554 5445 5854 5f49 4e54 4c5f 5355 _GETTEXT_INTL_SU │ │ │ │ │ +00042120: 4244 4952 2720 6973 2075 7365 642e 2020 BDIR' is used. │ │ │ │ │ +00042130: 4175 746f 6d61 6b65 2065 6e73 7572 6573 Automake ensures │ │ │ │ │ +00042140: 0a74 6861 7420 7468 6573 6520 6469 7265 .that these dire │ │ │ │ │ +00042150: 6374 6f72 6965 7320 6578 6973 7420 616e ctories exist an │ │ │ │ │ +00042160: 6420 6172 6520 6d65 6e74 696f 6e65 6420 d are mentioned │ │ │ │ │ +00042170: 696e 2027 5355 4244 4952 5327 2e0a 0a1f in 'SUBDIRS'.... │ │ │ │ │ +00042180: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +00042190: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +000421a0: 3a20 4c69 6274 6f6f 6c2c 2020 4e65 7874 : Libtool, Next │ │ │ │ │ +000421b0: 3a20 4a61 7661 2c20 2050 7265 763a 2067 : Java, Prev: g │ │ │ │ │ +000421c0: 6574 7465 7874 2c20 2055 703a 204f 7468 ettext, Up: Oth │ │ │ │ │ +000421d0: 6572 2047 4e55 2054 6f6f 6c73 0a0a 3130 er GNU Tools..10 │ │ │ │ │ +000421e0: 2e33 204c 6962 746f 6f6c 0a3d 3d3d 3d3d .3 Libtool.===== │ │ │ │ │ +000421f0: 3d3d 3d3d 3d3d 3d0a 0a41 7574 6f6d 616b =======..Automak │ │ │ │ │ +00042200: 6520 7072 6f76 6964 6573 2073 7570 706f e provides suppo │ │ │ │ │ +00042210: 7274 2066 6f72 2047 4e55 204c 6962 746f rt for GNU Libto │ │ │ │ │ +00042220: 6f6c 2028 2a6e 6f74 6520 496e 7472 6f64 ol (*note Introd │ │ │ │ │ +00042230: 7563 7469 6f6e 3a0a 286c 6962 746f 6f6c uction:.(libtool │ │ │ │ │ +00042240: 2954 6f70 2e29 2077 6974 6820 7468 6520 )Top.) with the │ │ │ │ │ +00042250: 274c 544c 4942 5241 5249 4553 2720 7072 'LTLIBRARIES' pr │ │ │ │ │ +00042260: 696d 6172 792e 2020 2a4e 6f74 6520 4120 imary. *Note A │ │ │ │ │ +00042270: 5368 6172 6564 0a4c 6962 7261 7279 3a3a Shared.Library:: │ │ │ │ │ +00042280: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +00042290: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +000422a0: 4e6f 6465 3a20 4a61 7661 2c20 204e 6578 Node: Java, Nex │ │ │ │ │ +000422b0: 743a 2050 7974 686f 6e2c 2020 5072 6576 t: Python, Prev │ │ │ │ │ +000422c0: 3a20 4c69 6274 6f6f 6c2c 2020 5570 3a20 : Libtool, Up: │ │ │ │ │ +000422d0: 4f74 6865 7220 474e 5520 546f 6f6c 730a Other GNU Tools. │ │ │ │ │ +000422e0: 0a31 302e 3420 4a61 7661 2062 7974 6563 .10.4 Java bytec │ │ │ │ │ +000422f0: 6f64 6520 636f 6d70 696c 6174 696f 6e20 ode compilation │ │ │ │ │ +00042300: 2864 6570 7265 6361 7465 6429 0a3d 3d3d (deprecated).=== │ │ │ │ │ 00042310: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00042320: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00042330: 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 ======..Automake │ │ │ │ │ -00042340: 2070 726f 7669 6465 7320 736f 6d65 206d provides some m │ │ │ │ │ -00042350: 696e 696d 616c 2073 7570 706f 7274 2066 inimal support f │ │ │ │ │ -00042360: 6f72 204a 6176 6120 6279 7465 636f 6465 or Java bytecode │ │ │ │ │ -00042370: 2063 6f6d 7069 6c61 7469 6f6e 0a77 6974 compilation.wit │ │ │ │ │ -00042380: 6820 7468 6520 274a 4156 4127 2070 7269 h the 'JAVA' pri │ │ │ │ │ -00042390: 6d61 7279 2028 696e 2061 6464 6974 696f mary (in additio │ │ │ │ │ -000423a0: 6e20 746f 2074 6865 2073 7570 706f 7274 n to the support │ │ │ │ │ -000423b0: 2066 6f72 2063 6f6d 7069 6c69 6e67 204a for compiling J │ │ │ │ │ -000423c0: 6176 610a 746f 206e 6174 6976 6520 6d61 ava.to native ma │ │ │ │ │ -000423d0: 6368 696e 6520 636f 6465 3b20 2a6e 6f74 chine code; *not │ │ │ │ │ -000423e0: 6520 4a61 7661 2053 7570 706f 7274 2077 e Java Support w │ │ │ │ │ -000423f0: 6974 6820 6763 6a3a 3a29 2e20 204e 6f74 ith gcj::). Not │ │ │ │ │ -00042400: 6520 686f 7765 7665 720a 7468 6174 205f e however.that _ │ │ │ │ │ -00042410: 7468 6520 696e 7465 7266 6163 6520 616e the interface an │ │ │ │ │ -00042420: 6420 6d6f 7374 2066 6561 7475 7265 7320 d most features │ │ │ │ │ -00042430: 6465 7363 7269 6265 6420 6865 7265 2061 described here a │ │ │ │ │ -00042440: 7265 2064 6570 7265 6361 7465 645f 3b0a re deprecated_;. │ │ │ │ │ -00042450: 7468 6520 6e65 7874 2061 7574 6f6d 616b the next automak │ │ │ │ │ -00042460: 6520 7265 6c65 6173 6520 7769 6c6c 2073 e release will s │ │ │ │ │ -00042470: 7472 6976 6520 746f 2070 726f 7669 6465 trive to provide │ │ │ │ │ -00042480: 2061 2062 6574 7465 7220 616e 6420 636c a better and cl │ │ │ │ │ -00042490: 6561 6e65 720a 696e 7465 7266 6163 652c eaner.interface, │ │ │ │ │ -000424a0: 2077 6869 6368 2068 6f77 6576 6572 205f which however _ │ │ │ │ │ -000424b0: 776f 6e27 7420 6265 2062 6163 6b77 6172 won't be backwar │ │ │ │ │ -000424c0: 642d 636f 6d70 6174 6962 6c65 5f3b 2074 d-compatible_; t │ │ │ │ │ -000424d0: 6865 2070 7265 7365 6e74 0a69 6e74 6572 he present.inter │ │ │ │ │ -000424e0: 6661 6365 2077 696c 6c20 7072 6f62 6162 face will probab │ │ │ │ │ -000424f0: 6c79 2062 6520 7265 6d6f 7665 6420 616c ly be removed al │ │ │ │ │ -00042500: 746f 6765 7468 6572 2069 6e20 6675 7475 together in futu │ │ │ │ │ -00042510: 7265 2061 7574 6f6d 616b 650a 7265 6c65 re automake.rele │ │ │ │ │ -00042520: 6173 6573 2028 312e 3133 206f 7220 6c61 ases (1.13 or la │ │ │ │ │ -00042530: 7465 7229 2c20 736f 2064 6f6e 2774 2075 ter), so don't u │ │ │ │ │ -00042540: 7365 2069 7420 696e 206e 6577 2063 6f64 se it in new cod │ │ │ │ │ -00042550: 652e 0a0a 2020 2041 6e79 2027 2e6a 6176 e... Any '.jav │ │ │ │ │ -00042560: 6127 2066 696c 6573 206c 6973 7465 6420 a' files listed │ │ │ │ │ -00042570: 696e 2061 2027 5f4a 4156 4127 2076 6172 in a '_JAVA' var │ │ │ │ │ -00042580: 6961 626c 6520 7769 6c6c 2062 6520 636f iable will be co │ │ │ │ │ -00042590: 6d70 696c 6564 2077 6974 680a 274a 4156 mpiled with.'JAV │ │ │ │ │ -000425a0: 4143 2720 6174 2062 7569 6c64 2074 696d AC' at build tim │ │ │ │ │ -000425b0: 652e 2020 4279 2064 6566 6175 6c74 2c20 e. By default, │ │ │ │ │ -000425c0: 272e 6a61 7661 2720 6669 6c65 7320 6172 '.java' files ar │ │ │ │ │ -000425d0: 6520 6e6f 7420 696e 636c 7564 6564 2069 e not included i │ │ │ │ │ -000425e0: 6e0a 7468 6520 6469 7374 7269 6275 7469 n.the distributi │ │ │ │ │ -000425f0: 6f6e 2c20 796f 7520 7368 6f75 6c64 2075 on, you should u │ │ │ │ │ -00042600: 7365 2074 6865 2027 6469 7374 5f27 2070 se the 'dist_' p │ │ │ │ │ -00042610: 7265 6669 7820 746f 2064 6973 7472 6962 refix to distrib │ │ │ │ │ -00042620: 7574 6520 7468 656d 2e0a 0a20 2020 4865 ute them... He │ │ │ │ │ -00042630: 7265 2069 7320 6120 7479 7069 6361 6c20 re is a typical │ │ │ │ │ -00042640: 7365 7475 7020 666f 7220 6469 7374 7269 setup for distri │ │ │ │ │ -00042650: 6275 7469 6e67 2027 2e6a 6176 6127 2066 buting '.java' f │ │ │ │ │ -00042660: 696c 6573 2061 6e64 2069 6e73 7461 6c6c iles and install │ │ │ │ │ -00042670: 696e 670a 7468 6520 272e 636c 6173 7327 ing.the '.class' │ │ │ │ │ -00042680: 2066 696c 6573 2072 6573 756c 7469 6e67 files resulting │ │ │ │ │ -00042690: 2066 726f 6d20 7468 6569 7220 636f 6d70 from their comp │ │ │ │ │ -000426a0: 696c 6174 696f 6e2e 0a0a 2020 2020 206a ilation... j │ │ │ │ │ -000426b0: 6176 6164 6972 203d 2024 2864 6174 6164 avadir = $(datad │ │ │ │ │ -000426c0: 6972 292f 6a61 7661 0a20 2020 2020 6469 ir)/java. di │ │ │ │ │ -000426d0: 7374 5f6a 6176 615f 4a41 5641 203d 2061 st_java_JAVA = a │ │ │ │ │ -000426e0: 2e6a 6176 6120 622e 6a61 7661 202e 2e2e .java b.java ... │ │ │ │ │ -000426f0: 0a0a 2020 2043 7572 7265 6e74 6c79 2041 .. Currently A │ │ │ │ │ -00042700: 7574 6f6d 616b 6520 656e 666f 7263 6573 utomake enforces │ │ │ │ │ -00042710: 2074 6865 2072 6573 7472 6963 7469 6f6e the restriction │ │ │ │ │ -00042720: 2074 6861 7420 6f6e 6c79 206f 6e65 2027 that only one ' │ │ │ │ │ -00042730: 5f4a 4156 4127 0a70 7269 6d61 7279 2063 _JAVA'.primary c │ │ │ │ │ -00042740: 616e 2062 6520 7573 6564 2069 6e20 6120 an be used in a │ │ │ │ │ -00042750: 6769 7665 6e20 274d 616b 6566 696c 652e given 'Makefile. │ │ │ │ │ -00042760: 616d 272e 2020 5468 6520 7265 6173 6f6e am'. The reason │ │ │ │ │ -00042770: 2066 6f72 2074 6869 730a 7265 7374 7269 for this.restri │ │ │ │ │ -00042780: 6374 696f 6e20 6973 2074 6861 742c 2069 ction is that, i │ │ │ │ │ -00042790: 6e20 6765 6e65 7261 6c2c 2069 7420 6973 n general, it is │ │ │ │ │ -000427a0: 6e27 7420 706f 7373 6962 6c65 2074 6f20 n't possible to │ │ │ │ │ -000427b0: 6b6e 6f77 2077 6869 6368 0a27 2e63 6c61 know which.'.cla │ │ │ │ │ -000427c0: 7373 2720 6669 6c65 7320 7765 7265 2067 ss' files were g │ │ │ │ │ -000427d0: 656e 6572 6174 6564 2066 726f 6d20 7768 enerated from wh │ │ │ │ │ -000427e0: 6963 6820 272e 6a61 7661 2720 6669 6c65 ich '.java' file │ │ │ │ │ -000427f0: 732c 2073 6f20 6974 2077 6f75 6c64 2062 s, so it would b │ │ │ │ │ -00042800: 650a 696d 706f 7373 6962 6c65 2074 6f20 e.impossible to │ │ │ │ │ -00042810: 6b6e 6f77 2077 6869 6368 2066 696c 6573 know which files │ │ │ │ │ -00042820: 2074 6f20 696e 7374 616c 6c20 7768 6572 to install wher │ │ │ │ │ -00042830: 652e 2020 466f 7220 696e 7374 616e 6365 e. For instance │ │ │ │ │ -00042840: 2c20 610a 272e 6a61 7661 2720 6669 6c65 , a.'.java' file │ │ │ │ │ -00042850: 2063 616e 2064 6566 696e 6520 6d75 6c74 can define mult │ │ │ │ │ -00042860: 6970 6c65 2063 6c61 7373 6573 3b20 7468 iple classes; th │ │ │ │ │ -00042870: 6520 7265 7375 6c74 696e 6720 272e 636c e resulting '.cl │ │ │ │ │ -00042880: 6173 7327 2066 696c 650a 6e61 6d65 7320 ass' file.names │ │ │ │ │ -00042890: 6361 6e6e 6f74 2062 6520 7072 6564 6963 cannot be predic │ │ │ │ │ -000428a0: 7465 6420 7769 7468 6f75 7420 7061 7273 ted without pars │ │ │ │ │ -000428b0: 696e 6720 7468 6520 272e 6a61 7661 2720 ing the '.java' │ │ │ │ │ -000428c0: 6669 6c65 2e0a 0a20 2020 5468 6572 6520 file... There │ │ │ │ │ -000428d0: 6172 6520 6120 6665 7720 7661 7269 6162 are a few variab │ │ │ │ │ -000428e0: 6c65 7320 7468 6174 2061 7265 2075 7365 les that are use │ │ │ │ │ -000428f0: 6420 7768 656e 2063 6f6d 7069 6c69 6e67 d when compiling │ │ │ │ │ -00042900: 204a 6176 6120 736f 7572 6365 733a 0a0a Java sources:.. │ │ │ │ │ -00042910: 274a 4156 4143 270a 2020 2020 2054 6865 'JAVAC'. The │ │ │ │ │ -00042920: 206e 616d 6520 6f66 2074 6865 204a 6176 name of the Jav │ │ │ │ │ -00042930: 6120 636f 6d70 696c 6572 2e20 2054 6869 a compiler. Thi │ │ │ │ │ -00042940: 7320 6465 6661 756c 7473 2074 6f20 276a s defaults to 'j │ │ │ │ │ -00042950: 6176 6163 272e 0a0a 274a 4156 4143 464c avac'...'JAVACFL │ │ │ │ │ -00042960: 4147 5327 0a20 2020 2020 5468 6520 666c AGS'. The fl │ │ │ │ │ -00042970: 6167 7320 746f 2070 6173 7320 746f 2074 ags to pass to t │ │ │ │ │ -00042980: 6865 2063 6f6d 7069 6c65 722e 2020 5468 he compiler. Th │ │ │ │ │ -00042990: 6973 2069 7320 636f 6e73 6964 6572 6564 is is considered │ │ │ │ │ -000429a0: 2074 6f20 6265 2061 2075 7365 720a 2020 to be a user. │ │ │ │ │ -000429b0: 2020 2076 6172 6961 626c 6520 282a 6e6f variable (*no │ │ │ │ │ -000429c0: 7465 2055 7365 7220 5661 7269 6162 6c65 te User Variable │ │ │ │ │ -000429d0: 733a 3a29 2e0a 0a27 414d 5f4a 4156 4143 s::)...'AM_JAVAC │ │ │ │ │ -000429e0: 464c 4147 5327 0a20 2020 2020 4d6f 7265 FLAGS'. More │ │ │ │ │ -000429f0: 2066 6c61 6773 2074 6f20 7061 7373 2074 flags to pass t │ │ │ │ │ -00042a00: 6f20 7468 6520 4a61 7661 2063 6f6d 7069 o the Java compi │ │ │ │ │ -00042a10: 6c65 722e 2020 5468 6973 2c20 616e 6420 ler. This, and │ │ │ │ │ -00042a20: 6e6f 740a 2020 2020 2027 4a41 5641 4346 not. 'JAVACF │ │ │ │ │ -00042a30: 4c41 4753 272c 2073 686f 756c 6420 6265 LAGS', should be │ │ │ │ │ -00042a40: 2075 7365 6420 7768 656e 2069 7420 6973 used when it is │ │ │ │ │ -00042a50: 206e 6563 6573 7361 7279 2074 6f20 7075 necessary to pu │ │ │ │ │ -00042a60: 7420 4a61 7661 0a20 2020 2020 636f 6d70 t Java. comp │ │ │ │ │ -00042a70: 696c 6572 2066 6c61 6773 2069 6e74 6f20 iler flags into │ │ │ │ │ -00042a80: 274d 616b 6566 696c 652e 616d 272e 0a0a 'Makefile.am'... │ │ │ │ │ -00042a90: 274a 4156 4152 4f4f 5427 0a20 2020 2020 'JAVAROOT'. │ │ │ │ │ -00042aa0: 5468 6520 7661 6c75 6520 6f66 2074 6869 The value of thi │ │ │ │ │ -00042ab0: 7320 7661 7269 6162 6c65 2069 7320 7061 s variable is pa │ │ │ │ │ -00042ac0: 7373 6564 2074 6f20 7468 6520 272d 6427 ssed to the '-d' │ │ │ │ │ -00042ad0: 206f 7074 696f 6e20 746f 2027 6a61 7661 option to 'java │ │ │ │ │ -00042ae0: 6327 2e0a 2020 2020 2049 7420 6465 6661 c'.. It defa │ │ │ │ │ -00042af0: 756c 7473 2074 6f20 2724 2874 6f70 5f62 ults to '$(top_b │ │ │ │ │ -00042b00: 7569 6c64 6469 7229 272e 0a0a 2743 4c41 uilddir)'...'CLA │ │ │ │ │ -00042b10: 5353 5041 5448 5f45 4e56 270a 2020 2020 SSPATH_ENV'. │ │ │ │ │ -00042b20: 2054 6869 7320 7661 7269 6162 6c65 2069 This variable i │ │ │ │ │ -00042b30: 7320 6120 7368 656c 6c20 6578 7072 6573 s a shell expres │ │ │ │ │ -00042b40: 7369 6f6e 2074 6861 7420 6973 2075 7365 sion that is use │ │ │ │ │ -00042b50: 6420 746f 2073 6574 2074 6865 0a20 2020 d to set the. │ │ │ │ │ -00042b60: 2020 2743 4c41 5353 5041 5448 2720 656e 'CLASSPATH' en │ │ │ │ │ -00042b70: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -00042b80: 6c65 206f 6e20 7468 6520 276a 6176 6163 le on the 'javac │ │ │ │ │ -00042b90: 2720 636f 6d6d 616e 6420 6c69 6e65 2e20 ' command line. │ │ │ │ │ -00042ba0: 2028 496e 0a20 2020 2020 7468 6520 6675 (In. the fu │ │ │ │ │ -00042bb0: 7475 7265 2077 6520 7769 6c6c 2070 726f ture we will pro │ │ │ │ │ -00042bc0: 6261 626c 7920 6861 6e64 6c65 2063 6c61 bably handle cla │ │ │ │ │ -00042bd0: 7373 2070 6174 6820 7365 7474 696e 6720 ss path setting │ │ │ │ │ -00042be0: 6469 6666 6572 656e 746c 792e 290a 0a1f differently.)... │ │ │ │ │ -00042bf0: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -00042c00: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -00042c10: 3a20 5079 7468 6f6e 2c20 2050 7265 763a : Python, Prev: │ │ │ │ │ -00042c20: 204a 6176 612c 2020 5570 3a20 4f74 6865 Java, Up: Othe │ │ │ │ │ -00042c30: 7220 474e 5520 546f 6f6c 730a 0a31 302e r GNU Tools..10. │ │ │ │ │ -00042c40: 3520 5079 7468 6f6e 0a3d 3d3d 3d3d 3d3d 5 Python.======= │ │ │ │ │ -00042c50: 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 2070 ====..Automake p │ │ │ │ │ -00042c60: 726f 7669 6465 7320 7375 7070 6f72 7420 rovides support │ │ │ │ │ -00042c70: 666f 7220 5079 7468 6f6e 2063 6f6d 7069 for Python compi │ │ │ │ │ -00042c80: 6c61 7469 6f6e 2077 6974 6820 7468 6520 lation with the │ │ │ │ │ -00042c90: 2750 5954 484f 4e27 0a70 7269 6d61 7279 'PYTHON'.primary │ │ │ │ │ -00042ca0: 2e20 2041 2074 7970 6963 616c 2073 6574 . A typical set │ │ │ │ │ -00042cb0: 7570 2069 7320 746f 2063 616c 6c20 2741 up is to call 'A │ │ │ │ │ -00042cc0: 4d5f 5041 5448 5f50 5954 484f 4e27 2069 M_PATH_PYTHON' i │ │ │ │ │ -00042cd0: 6e20 2763 6f6e 6669 6775 7265 2e61 6327 n 'configure.ac' │ │ │ │ │ -00042ce0: 0a61 6e64 2075 7365 2061 206c 696e 6520 .and use a line │ │ │ │ │ -00042cf0: 6c69 6b65 2074 6865 2066 6f6c 6c6f 7769 like the followi │ │ │ │ │ -00042d00: 6e67 2069 6e20 274d 616b 6566 696c 652e ng in 'Makefile. │ │ │ │ │ -00042d10: 616d 273a 0a0a 2020 2020 2070 7974 686f am':.. pytho │ │ │ │ │ -00042d20: 6e5f 5059 5448 4f4e 203d 2074 7265 652e n_PYTHON = tree. │ │ │ │ │ -00042d30: 7079 206c 6561 7665 2e70 790a 0a20 2020 py leave.py.. │ │ │ │ │ -00042d40: 416e 7920 6669 6c65 7320 6c69 7374 6564 Any files listed │ │ │ │ │ -00042d50: 2069 6e20 6120 275f 5059 5448 4f4e 2720 in a '_PYTHON' │ │ │ │ │ -00042d60: 7661 7269 6162 6c65 2077 696c 6c20 6265 variable will be │ │ │ │ │ -00042d70: 2062 7974 652d 636f 6d70 696c 6564 2077 byte-compiled w │ │ │ │ │ -00042d80: 6974 680a 2770 792d 636f 6d70 696c 6527 ith.'py-compile' │ │ │ │ │ -00042d90: 2061 7420 696e 7374 616c 6c20 7469 6d65 at install time │ │ │ │ │ -00042da0: 2e20 2027 7079 2d63 6f6d 7069 6c65 2720 . 'py-compile' │ │ │ │ │ -00042db0: 6163 7475 616c 6c79 2063 7265 6174 6573 actually creates │ │ │ │ │ -00042dc0: 2062 6f74 680a 7374 616e 6461 7264 2028 both.standard ( │ │ │ │ │ -00042dd0: 272e 7079 6327 2920 616e 6420 6f70 7469 '.pyc') and opti │ │ │ │ │ -00042de0: 6d69 7a65 6420 2827 2e70 796f 2729 2062 mized ('.pyo') b │ │ │ │ │ -00042df0: 7974 652d 636f 6d70 696c 6564 2076 6572 yte-compiled ver │ │ │ │ │ -00042e00: 7369 6f6e 7320 6f66 2074 6865 0a73 6f75 sions of the.sou │ │ │ │ │ -00042e10: 7263 6520 6669 6c65 732e 2020 4e6f 7465 rce files. Note │ │ │ │ │ -00042e20: 2074 6861 7420 6265 6361 7573 6520 6279 that because by │ │ │ │ │ -00042e30: 7465 2d63 6f6d 7069 6c61 7469 6f6e 206f te-compilation o │ │ │ │ │ -00042e40: 6363 7572 7320 6174 2069 6e73 7461 6c6c ccurs at install │ │ │ │ │ -00042e50: 0a74 696d 652c 2061 6e79 2066 696c 6573 .time, any files │ │ │ │ │ -00042e60: 206c 6973 7465 6420 696e 2027 6e6f 696e listed in 'noin │ │ │ │ │ -00042e70: 7374 5f50 5954 484f 4e27 2077 696c 6c20 st_PYTHON' will │ │ │ │ │ -00042e80: 6e6f 7420 6265 2063 6f6d 7069 6c65 642e not be compiled. │ │ │ │ │ -00042e90: 2020 5079 7468 6f6e 0a73 6f75 7263 6520 Python.source │ │ │ │ │ -00042ea0: 6669 6c65 7320 6172 6520 696e 636c 7564 files are includ │ │ │ │ │ -00042eb0: 6564 2069 6e20 7468 6520 6469 7374 7269 ed in the distri │ │ │ │ │ -00042ec0: 6275 7469 6f6e 2062 7920 6465 6661 756c bution by defaul │ │ │ │ │ -00042ed0: 742c 2070 7265 7065 6e64 0a27 6e6f 6469 t, prepend.'nodi │ │ │ │ │ -00042ee0: 7374 5f27 2028 6173 2069 6e20 276e 6f64 st_' (as in 'nod │ │ │ │ │ -00042ef0: 6973 745f 7079 7468 6f6e 5f50 5954 484f ist_python_PYTHO │ │ │ │ │ -00042f00: 4e27 2920 746f 206f 6d69 7420 7468 656d N') to omit them │ │ │ │ │ -00042f10: 2e0a 0a20 2020 4175 746f 6d61 6b65 2073 ... Automake s │ │ │ │ │ -00042f20: 6869 7073 2077 6974 6820 616e 2041 7574 hips with an Aut │ │ │ │ │ -00042f30: 6f63 6f6e 6620 6d61 6372 6f20 6361 6c6c oconf macro call │ │ │ │ │ -00042f40: 6564 2027 414d 5f50 4154 485f 5059 5448 ed 'AM_PATH_PYTH │ │ │ │ │ -00042f50: 4f4e 2720 7468 6174 0a77 696c 6c20 6465 ON' that.will de │ │ │ │ │ -00042f60: 7465 726d 696e 6520 736f 6d65 2050 7974 termine some Pyt │ │ │ │ │ -00042f70: 686f 6e2d 7265 6c61 7465 6420 6469 7265 hon-related dire │ │ │ │ │ -00042f80: 6374 6f72 7920 7661 7269 6162 6c65 7320 ctory variables │ │ │ │ │ -00042f90: 2873 6565 2062 656c 6f77 292e 2020 4966 (see below). If │ │ │ │ │ -00042fa0: 0a79 6f75 2068 6176 6520 6361 6c6c 6564 .you have called │ │ │ │ │ -00042fb0: 2027 414d 5f50 4154 485f 5059 5448 4f4e 'AM_PATH_PYTHON │ │ │ │ │ -00042fc0: 2720 6672 6f6d 2027 636f 6e66 6967 7572 ' from 'configur │ │ │ │ │ -00042fd0: 652e 6163 272c 2074 6865 6e20 796f 7520 e.ac', then you │ │ │ │ │ -00042fe0: 6d61 7920 7573 650a 7468 6520 7661 7269 may use.the vari │ │ │ │ │ -00042ff0: 6162 6c65 7320 2770 7974 686f 6e5f 5059 ables 'python_PY │ │ │ │ │ -00043000: 5448 4f4e 2720 6f72 2027 706b 6770 7974 THON' or 'pkgpyt │ │ │ │ │ -00043010: 686f 6e5f 5059 5448 4f4e 2720 746f 206c hon_PYTHON' to l │ │ │ │ │ -00043020: 6973 7420 5079 7468 6f6e 0a73 6f75 7263 ist Python.sourc │ │ │ │ │ -00043030: 6520 6669 6c65 7320 696e 2079 6f75 7220 e files in your │ │ │ │ │ -00043040: 274d 616b 6566 696c 652e 616d 272c 2064 'Makefile.am', d │ │ │ │ │ -00043050: 6570 656e 6469 6e67 206f 6e20 7768 6572 epending on wher │ │ │ │ │ -00043060: 6520 796f 7520 7761 6e74 2079 6f75 720a e you want your. │ │ │ │ │ -00043070: 6669 6c65 7320 696e 7374 616c 6c65 6420 files installed │ │ │ │ │ -00043080: 2873 6565 2074 6865 2064 6566 696e 6974 (see the definit │ │ │ │ │ -00043090: 696f 6e73 206f 6620 2770 7974 686f 6e64 ions of 'pythond │ │ │ │ │ -000430a0: 6972 2720 616e 6420 2770 6b67 7079 7468 ir' and 'pkgpyth │ │ │ │ │ -000430b0: 6f6e 6469 7227 0a62 656c 6f77 292e 0a0a ondir'.below)... │ │ │ │ │ -000430c0: 202d 2d20 4d61 6372 6f3a 2041 4d5f 5041 -- Macro: AM_PA │ │ │ │ │ -000430d0: 5448 5f50 5954 484f 4e20 285b 5645 5253 TH_PYTHON ([VERS │ │ │ │ │ -000430e0: 494f 4e5d 2c20 5b41 4354 494f 4e2d 4946 ION], [ACTION-IF │ │ │ │ │ -000430f0: 2d46 4f55 4e44 5d2c 0a20 2020 2020 5b41 -FOUND],. [A │ │ │ │ │ -00043100: 4354 494f 4e2d 4946 2d4e 4f54 2d46 4f55 CTION-IF-NOT-FOU │ │ │ │ │ -00043110: 4e44 5d29 0a0a 2020 2020 2053 6561 7263 ND]).. Searc │ │ │ │ │ -00043120: 6820 666f 7220 6120 5079 7468 6f6e 2069 h for a Python i │ │ │ │ │ -00043130: 6e74 6572 7072 6574 6572 206f 6e20 7468 nterpreter on th │ │ │ │ │ -00043140: 6520 7379 7374 656d 2e20 2054 6869 7320 e system. This │ │ │ │ │ -00043150: 6d61 6372 6f20 7461 6b65 730a 2020 2020 macro takes. │ │ │ │ │ -00043160: 2074 6872 6565 206f 7074 696f 6e61 6c20 three optional │ │ │ │ │ -00043170: 6172 6775 6d65 6e74 732e 2020 5468 6520 arguments. The │ │ │ │ │ -00043180: 6669 7273 7420 6172 6775 6d65 6e74 2c20 first argument, │ │ │ │ │ -00043190: 6966 2070 7265 7365 6e74 2c20 6973 2074 if present, is t │ │ │ │ │ -000431a0: 6865 0a20 2020 2020 6d69 6e69 6d75 6d20 he. minimum │ │ │ │ │ -000431b0: 7665 7273 696f 6e20 6f66 2050 7974 686f version of Pytho │ │ │ │ │ -000431c0: 6e20 7265 7175 6972 6564 2066 6f72 2074 n required for t │ │ │ │ │ -000431d0: 6869 7320 7061 636b 6167 653a 0a20 2020 his package:. │ │ │ │ │ -000431e0: 2020 2741 4d5f 5041 5448 5f50 5954 484f 'AM_PATH_PYTHO │ │ │ │ │ -000431f0: 4e27 2077 696c 6c20 736b 6970 2061 6e79 N' will skip any │ │ │ │ │ -00043200: 2050 7974 686f 6e20 696e 7465 7270 7265 Python interpre │ │ │ │ │ -00043210: 7465 7220 7468 6174 2069 7320 6f6c 6465 ter that is olde │ │ │ │ │ -00043220: 720a 2020 2020 2074 6861 6e20 5645 5253 r. than VERS │ │ │ │ │ -00043230: 494f 4e2e 2020 4966 2061 6e20 696e 7465 ION. If an inte │ │ │ │ │ -00043240: 7270 7265 7465 7220 6973 2066 6f75 6e64 rpreter is found │ │ │ │ │ -00043250: 2061 6e64 2073 6174 6973 6669 6573 2056 and satisfies V │ │ │ │ │ -00043260: 4552 5349 4f4e 2c0a 2020 2020 2074 6865 ERSION,. the │ │ │ │ │ -00043270: 6e20 4143 5449 4f4e 2d49 462d 464f 554e n ACTION-IF-FOUN │ │ │ │ │ -00043280: 4420 6973 2072 756e 2e20 204f 7468 6572 D is run. Other │ │ │ │ │ -00043290: 7769 7365 2c20 4143 5449 4f4e 2d49 462d wise, ACTION-IF- │ │ │ │ │ -000432a0: 4e4f 542d 464f 554e 4420 6973 0a20 2020 NOT-FOUND is. │ │ │ │ │ -000432b0: 2020 7275 6e2e 0a0a 2020 2020 2049 6620 run... If │ │ │ │ │ -000432c0: 4143 5449 4f4e 2d49 462d 4e4f 542d 464f ACTION-IF-NOT-FO │ │ │ │ │ -000432d0: 554e 4420 6973 206e 6f74 2073 7065 6369 UND is not speci │ │ │ │ │ -000432e0: 6669 6564 2c20 6173 2069 6e20 7468 6520 fied, as in the │ │ │ │ │ -000432f0: 666f 6c6c 6f77 696e 670a 2020 2020 2065 following. e │ │ │ │ │ -00043300: 7861 6d70 6c65 2c20 7468 6520 6465 6661 xample, the defa │ │ │ │ │ -00043310: 756c 7420 6973 2074 6f20 6162 6f72 7420 ult is to abort │ │ │ │ │ -00043320: 2763 6f6e 6669 6775 7265 272e 0a0a 2020 'configure'... │ │ │ │ │ -00043330: 2020 2020 2020 2020 414d 5f50 4154 485f AM_PATH_ │ │ │ │ │ -00043340: 5059 5448 4f4e 285b 322e 325d 290a 0a20 PYTHON([2.2]).. │ │ │ │ │ -00043350: 2020 2020 5468 6973 2069 7320 6669 6e65 This is fine │ │ │ │ │ -00043360: 2077 6865 6e20 5079 7468 6f6e 2069 7320 when Python is │ │ │ │ │ -00043370: 616e 2061 6273 6f6c 7574 6520 7265 7175 an absolute requ │ │ │ │ │ -00043380: 6972 656d 656e 7420 666f 7220 7468 650a irement for the. │ │ │ │ │ -00043390: 2020 2020 2070 6163 6b61 6765 2e20 2049 package. I │ │ │ │ │ -000433a0: 6620 5079 7468 6f6e 203e 3d20 322e 3520 f Python >= 2.5 │ │ │ │ │ -000433b0: 7761 7320 6f6e 6c79 205f 6f70 7469 6f6e was only _option │ │ │ │ │ -000433c0: 616c 5f20 746f 2074 6865 2070 6163 6b61 al_ to the packa │ │ │ │ │ -000433d0: 6765 2c0a 2020 2020 2027 414d 5f50 4154 ge,. 'AM_PAT │ │ │ │ │ -000433e0: 485f 5059 5448 4f4e 2720 636f 756c 6420 H_PYTHON' could │ │ │ │ │ -000433f0: 6265 2063 616c 6c65 6420 6173 2066 6f6c be called as fol │ │ │ │ │ -00043400: 6c6f 7773 2e0a 0a20 2020 2020 2020 2020 lows... │ │ │ │ │ -00043410: 2041 4d5f 5041 5448 5f50 5954 484f 4e28 AM_PATH_PYTHON( │ │ │ │ │ -00043420: 5b32 2e35 5d2c 2c20 5b3a 5d29 0a0a 2020 [2.5],, [:]).. │ │ │ │ │ -00043430: 2020 2049 6620 7468 6520 2750 5954 484f If the 'PYTHO │ │ │ │ │ -00043440: 4e27 2076 6172 6961 626c 6520 6973 2073 N' variable is s │ │ │ │ │ -00043450: 6574 2077 6865 6e20 2741 4d5f 5041 5448 et when 'AM_PATH │ │ │ │ │ -00043460: 5f50 5954 484f 4e27 2069 7320 6361 6c6c _PYTHON' is call │ │ │ │ │ -00043470: 6564 2c0a 2020 2020 2074 6865 6e20 7468 ed,. then th │ │ │ │ │ -00043480: 6174 2077 696c 6c20 6265 2074 6865 206f at will be the o │ │ │ │ │ -00043490: 6e6c 7920 5079 7468 6f6e 2069 6e74 6572 nly Python inter │ │ │ │ │ -000434a0: 7072 6574 6572 2074 6861 7420 6973 2074 preter that is t │ │ │ │ │ -000434b0: 7269 6564 2e0a 0a20 2020 2020 2741 4d5f ried... 'AM_ │ │ │ │ │ -000434c0: 5041 5448 5f50 5954 484f 4e27 2063 7265 PATH_PYTHON' cre │ │ │ │ │ -000434d0: 6174 6573 2074 6865 2066 6f6c 6c6f 7769 ates the followi │ │ │ │ │ -000434e0: 6e67 206f 7574 7075 7420 7661 7269 6162 ng output variab │ │ │ │ │ -000434f0: 6c65 7320 6261 7365 6420 6f6e 0a20 2020 les based on. │ │ │ │ │ -00043500: 2020 7468 6520 5079 7468 6f6e 2069 6e73 the Python ins │ │ │ │ │ -00043510: 7461 6c6c 6174 696f 6e20 666f 756e 6420 tallation found │ │ │ │ │ -00043520: 6475 7269 6e67 2063 6f6e 6669 6775 7261 during configura │ │ │ │ │ -00043530: 7469 6f6e 2e0a 0a27 5059 5448 4f4e 270a tion...'PYTHON'. │ │ │ │ │ -00043540: 2020 2020 2054 6865 206e 616d 6520 6f66 The name of │ │ │ │ │ -00043550: 2074 6865 2050 7974 686f 6e20 6578 6563 the Python exec │ │ │ │ │ -00043560: 7574 6162 6c65 2c20 6f72 2027 3a27 2069 utable, or ':' i │ │ │ │ │ -00043570: 6620 6e6f 2073 7569 7461 626c 650a 2020 f no suitable. │ │ │ │ │ -00043580: 2020 2069 6e74 6572 7072 6574 6572 2063 interpreter c │ │ │ │ │ -00043590: 6f75 6c64 2062 6520 666f 756e 642e 0a0a ould be found... │ │ │ │ │ -000435a0: 2020 2020 2041 7373 756d 696e 6720 4143 Assuming AC │ │ │ │ │ -000435b0: 5449 4f4e 2d49 462d 4e4f 542d 464f 554e TION-IF-NOT-FOUN │ │ │ │ │ -000435c0: 4420 6973 2075 7365 6420 286f 7468 6572 D is used (other │ │ │ │ │ -000435d0: 7769 7365 2027 2e2f 636f 6e66 6967 7572 wise './configur │ │ │ │ │ -000435e0: 6527 2077 696c 6c0a 2020 2020 2061 626f e' will. abo │ │ │ │ │ -000435f0: 7274 2069 6620 5079 7468 6f6e 2069 7320 rt if Python is │ │ │ │ │ -00043600: 6162 7365 6e74 292c 2074 6865 2076 616c absent), the val │ │ │ │ │ -00043610: 7565 206f 6620 2750 5954 484f 4e27 2063 ue of 'PYTHON' c │ │ │ │ │ -00043620: 616e 2062 6520 7573 6564 2074 6f0a 2020 an be used to. │ │ │ │ │ -00043630: 2020 2073 6574 7570 2061 2063 6f6e 6469 setup a condi │ │ │ │ │ -00043640: 7469 6f6e 616c 2069 6e20 6f72 6465 7220 tional in order │ │ │ │ │ -00043650: 746f 2064 6973 6162 6c65 2074 6865 2072 to disable the r │ │ │ │ │ -00043660: 656c 6576 616e 7420 7061 7274 206f 6620 elevant part of │ │ │ │ │ -00043670: 610a 2020 2020 2062 7569 6c64 2061 7320 a. build as │ │ │ │ │ -00043680: 666f 6c6c 6f77 732e 0a0a 2020 2020 2020 follows... │ │ │ │ │ -00043690: 2020 2020 414d 5f50 4154 485f 5059 5448 AM_PATH_PYTH │ │ │ │ │ -000436a0: 4f4e 282c 2c20 5b3a 5d29 0a20 2020 2020 ON(,, [:]). │ │ │ │ │ -000436b0: 2020 2020 2041 4d5f 434f 4e44 4954 494f AM_CONDITIO │ │ │ │ │ -000436c0: 4e41 4c28 5b48 4156 455f 5059 5448 4f4e NAL([HAVE_PYTHON │ │ │ │ │ -000436d0: 5d2c 205b 7465 7374 2022 2450 5954 484f ], [test "$PYTHO │ │ │ │ │ -000436e0: 4e22 2021 3d20 3a5d 290a 0a27 5059 5448 N" != :])..'PYTH │ │ │ │ │ -000436f0: 4f4e 5f56 4552 5349 4f4e 270a 2020 2020 ON_VERSION'. │ │ │ │ │ -00043700: 2054 6865 2050 7974 686f 6e20 7665 7273 The Python vers │ │ │ │ │ -00043710: 696f 6e20 6e75 6d62 6572 2c20 696e 2074 ion number, in t │ │ │ │ │ -00043720: 6865 2066 6f72 6d20 4d41 4a4f 522e 4d49 he form MAJOR.MI │ │ │ │ │ -00043730: 4e4f 5220 2865 2e67 2e2c 2027 322e 3527 NOR (e.g., '2.5' │ │ │ │ │ -00043740: 292e 0a20 2020 2020 5468 6973 2069 7320 ).. This is │ │ │ │ │ -00043750: 6375 7272 656e 746c 7920 7468 6520 7661 currently the va │ │ │ │ │ -00043760: 6c75 6520 6f66 2027 7379 732e 7665 7273 lue of 'sys.vers │ │ │ │ │ -00043770: 696f 6e5b 3a33 5d27 2e0a 0a27 5059 5448 ion[:3]'...'PYTH │ │ │ │ │ -00043780: 4f4e 5f50 5245 4649 5827 0a20 2020 2020 ON_PREFIX'. │ │ │ │ │ -00043790: 5468 6520 7374 7269 6e67 2027 247b 7072 The string '${pr │ │ │ │ │ -000437a0: 6566 6978 7d27 2e20 2054 6869 7320 7465 efix}'. This te │ │ │ │ │ -000437b0: 726d 206d 6179 2062 6520 7573 6564 2069 rm may be used i │ │ │ │ │ -000437c0: 6e20 6675 7475 7265 2077 6f72 6b20 7468 n future work th │ │ │ │ │ -000437d0: 6174 0a20 2020 2020 6e65 6564 7320 7468 at. needs th │ │ │ │ │ -000437e0: 6520 636f 6e74 656e 7473 206f 6620 5079 e contents of Py │ │ │ │ │ -000437f0: 7468 6f6e 2773 2027 7379 732e 7072 6566 thon's 'sys.pref │ │ │ │ │ -00043800: 6978 272c 2062 7574 2067 656e 6572 616c ix', but general │ │ │ │ │ -00043810: 2063 6f6e 7365 6e73 7573 0a20 2020 2020 consensus. │ │ │ │ │ -00043820: 6973 2074 6f20 616c 7761 7973 2075 7365 is to always use │ │ │ │ │ -00043830: 2074 6865 2076 616c 7565 2066 726f 6d20 the value from │ │ │ │ │ -00043840: 2763 6f6e 6669 6775 7265 272e 0a0a 2750 'configure'...'P │ │ │ │ │ -00043850: 5954 484f 4e5f 4558 4543 5f50 5245 4649 YTHON_EXEC_PREFI │ │ │ │ │ -00043860: 5827 0a20 2020 2020 5468 6520 7374 7269 X'. The stri │ │ │ │ │ -00043870: 6e67 2027 247b 6578 6563 5f70 7265 6669 ng '${exec_prefi │ │ │ │ │ -00043880: 787d 272e 2020 5468 6973 2074 6572 6d20 x}'. This term │ │ │ │ │ -00043890: 6d61 7920 6265 2075 7365 6420 696e 2066 may be used in f │ │ │ │ │ -000438a0: 7574 7572 6520 776f 726b 0a20 2020 2020 uture work. │ │ │ │ │ -000438b0: 7468 6174 206e 6565 6473 2074 6865 2063 that needs the c │ │ │ │ │ -000438c0: 6f6e 7465 6e74 7320 6f66 2050 7974 686f ontents of Pytho │ │ │ │ │ -000438d0: 6e27 7320 2773 7973 2e65 7865 635f 7072 n's 'sys.exec_pr │ │ │ │ │ -000438e0: 6566 6978 272c 2062 7574 2067 656e 6572 efix', but gener │ │ │ │ │ -000438f0: 616c 0a20 2020 2020 636f 6e73 656e 7375 al. consensu │ │ │ │ │ -00043900: 7320 6973 2074 6f20 616c 7761 7973 2075 s is to always u │ │ │ │ │ -00043910: 7365 2074 6865 2076 616c 7565 2066 726f se the value fro │ │ │ │ │ -00043920: 6d20 2763 6f6e 6669 6775 7265 272e 0a0a m 'configure'... │ │ │ │ │ -00043930: 2750 5954 484f 4e5f 504c 4154 464f 524d 'PYTHON_PLATFORM │ │ │ │ │ -00043940: 270a 2020 2020 2054 6865 2063 616e 6f6e '. The canon │ │ │ │ │ -00043950: 6963 616c 206e 616d 6520 7573 6564 2062 ical name used b │ │ │ │ │ -00043960: 7920 5079 7468 6f6e 2074 6f20 6465 7363 y Python to desc │ │ │ │ │ -00043970: 7269 6265 2074 6865 206f 7065 7261 7469 ribe the operati │ │ │ │ │ -00043980: 6e67 2073 7973 7465 6d2c 0a20 2020 2020 ng system,. │ │ │ │ │ -00043990: 6173 2067 6976 656e 2062 7920 2773 7973 as given by 'sys │ │ │ │ │ -000439a0: 2e70 6c61 7466 6f72 6d27 2e20 2054 6869 .platform'. Thi │ │ │ │ │ -000439b0: 7320 7661 6c75 6520 6973 2073 6f6d 6574 s value is somet │ │ │ │ │ -000439c0: 696d 6573 206e 6565 6465 6420 7768 656e imes needed when │ │ │ │ │ -000439d0: 0a20 2020 2020 6275 696c 6469 6e67 2050 . building P │ │ │ │ │ -000439e0: 7974 686f 6e20 6578 7465 6e73 696f 6e73 ython extensions │ │ │ │ │ -000439f0: 2e0a 0a27 7079 7468 6f6e 6469 7227 0a20 ...'pythondir'. │ │ │ │ │ -00043a00: 2020 2020 5468 6520 6469 7265 6374 6f72 The director │ │ │ │ │ -00043a10: 7920 6e61 6d65 2066 6f72 2074 6865 2027 y name for the ' │ │ │ │ │ -00043a20: 7369 7465 2d70 6163 6b61 6765 7327 2073 site-packages' s │ │ │ │ │ -00043a30: 7562 6469 7265 6374 6f72 7920 6f66 2074 ubdirectory of t │ │ │ │ │ -00043a40: 6865 0a20 2020 2020 7374 616e 6461 7264 he. standard │ │ │ │ │ -00043a50: 2050 7974 686f 6e20 696e 7374 616c 6c20 Python install │ │ │ │ │ -00043a60: 7472 6565 2e0a 0a27 706b 6770 7974 686f tree...'pkgpytho │ │ │ │ │ -00043a70: 6e64 6972 270a 2020 2020 2054 6869 7320 ndir'. This │ │ │ │ │ -00043a80: 6973 2074 6865 2064 6972 6563 746f 7279 is the directory │ │ │ │ │ -00043a90: 2075 6e64 6572 2027 7079 7468 6f6e 6469 under 'pythondi │ │ │ │ │ -00043aa0: 7227 2074 6861 7420 6973 206e 616d 6564 r' that is named │ │ │ │ │ -00043ab0: 2061 6674 6572 2074 6865 0a20 2020 2020 after the. │ │ │ │ │ -00043ac0: 7061 636b 6167 652e 2020 5468 6174 2069 package. That i │ │ │ │ │ -00043ad0: 732c 2069 7420 6973 2027 2428 7079 7468 s, it is '$(pyth │ │ │ │ │ -00043ae0: 6f6e 6469 7229 2f24 2850 4143 4b41 4745 ondir)/$(PACKAGE │ │ │ │ │ -00043af0: 2927 2e20 2049 7420 6973 2070 726f 7669 )'. It is provi │ │ │ │ │ -00043b00: 6465 640a 2020 2020 2061 7320 6120 636f ded. as a co │ │ │ │ │ -00043b10: 6e76 656e 6965 6e63 652e 0a0a 2770 7965 nvenience...'pye │ │ │ │ │ -00043b20: 7865 6364 6972 270a 2020 2020 2054 6869 xecdir'. Thi │ │ │ │ │ -00043b30: 7320 6973 2074 6865 2064 6972 6563 746f s is the directo │ │ │ │ │ -00043b40: 7279 2077 6865 7265 2050 7974 686f 6e20 ry where Python │ │ │ │ │ -00043b50: 6578 7465 6e73 696f 6e20 6d6f 6475 6c65 extension module │ │ │ │ │ -00043b60: 7320 2873 6861 7265 640a 2020 2020 206c s (shared. l │ │ │ │ │ -00043b70: 6962 7261 7269 6573 2920 7368 6f75 6c64 ibraries) should │ │ │ │ │ -00043b80: 2062 6520 696e 7374 616c 6c65 642e 2020 be installed. │ │ │ │ │ -00043b90: 416e 2065 7874 656e 7369 6f6e 206d 6f64 An extension mod │ │ │ │ │ -00043ba0: 756c 6520 7772 6974 7465 6e20 696e 2043 ule written in C │ │ │ │ │ -00043bb0: 0a20 2020 2020 636f 756c 6420 6265 2064 . could be d │ │ │ │ │ -00043bc0: 6563 6c61 7265 6420 6173 2066 6f6c 6c6f eclared as follo │ │ │ │ │ -00043bd0: 7773 2074 6f20 4175 746f 6d61 6b65 3a0a ws to Automake:. │ │ │ │ │ -00043be0: 0a20 2020 2020 2020 2020 2070 7965 7865 . pyexe │ │ │ │ │ -00043bf0: 635f 4c54 4c49 4252 4152 4945 5320 3d20 c_LTLIBRARIES = │ │ │ │ │ -00043c00: 7175 6174 6572 6e69 6f6e 2e6c 610a 2020 quaternion.la. │ │ │ │ │ -00043c10: 2020 2020 2020 2020 7175 6174 6572 6e69 quaterni │ │ │ │ │ -00043c20: 6f6e 5f6c 615f 534f 5552 4345 5320 3d20 on_la_SOURCES = │ │ │ │ │ -00043c30: 7175 6174 6572 6e69 6f6e 2e63 2073 7570 quaternion.c sup │ │ │ │ │ -00043c40: 706f 7274 2e63 2073 7570 706f 7274 2e68 port.c support.h │ │ │ │ │ -00043c50: 0a20 2020 2020 2020 2020 2071 7561 7465 . quate │ │ │ │ │ -00043c60: 726e 696f 6e5f 6c61 5f4c 4446 4c41 4753 rnion_la_LDFLAGS │ │ │ │ │ -00043c70: 203d 202d 6176 6f69 642d 7665 7273 696f = -avoid-versio │ │ │ │ │ -00043c80: 6e20 2d6d 6f64 756c 650a 0a27 706b 6770 n -module..'pkgp │ │ │ │ │ -00043c90: 7965 7865 6364 6972 270a 2020 2020 2054 yexecdir'. T │ │ │ │ │ -00043ca0: 6869 7320 6973 2061 2063 6f6e 7665 6e69 his is a conveni │ │ │ │ │ -00043cb0: 656e 6365 2076 6172 6961 626c 6520 7468 ence variable th │ │ │ │ │ -00043cc0: 6174 2069 7320 6465 6669 6e65 6420 6173 at is defined as │ │ │ │ │ -00043cd0: 0a20 2020 2020 2724 2870 7965 7865 6364 . '$(pyexecd │ │ │ │ │ -00043ce0: 6972 292f 2428 5041 434b 4147 4529 272e ir)/$(PACKAGE)'. │ │ │ │ │ -00043cf0: 0a0a 2020 2041 6c6c 2074 6865 7365 2064 .. All these d │ │ │ │ │ -00043d00: 6972 6563 746f 7279 2076 6172 6961 626c irectory variabl │ │ │ │ │ -00043d10: 6573 2068 6176 6520 7661 6c75 6573 2074 es have values t │ │ │ │ │ -00043d20: 6861 7420 7374 6172 7420 7769 7468 2065 hat start with e │ │ │ │ │ -00043d30: 6974 6865 720a 2724 7b70 7265 6669 787d ither.'${prefix} │ │ │ │ │ -00043d40: 2720 6f72 2027 247b 6578 6563 5f70 7265 ' or '${exec_pre │ │ │ │ │ -00043d50: 6669 787d 2720 756e 6578 7061 6e64 6564 fix}' unexpanded │ │ │ │ │ -00043d60: 2e20 2054 6869 7320 776f 726b 7320 6669 . This works fi │ │ │ │ │ -00043d70: 6e65 2069 6e0a 274d 616b 6566 696c 6573 ne in.'Makefiles │ │ │ │ │ -00043d80: 272c 2062 7574 2069 7420 6d61 6b65 7320 ', but it makes │ │ │ │ │ -00043d90: 7468 6573 6520 7661 7269 6162 6c65 7320 these variables │ │ │ │ │ -00043da0: 6861 7264 2074 6f20 7573 6520 696e 2027 hard to use in ' │ │ │ │ │ -00043db0: 636f 6e66 6967 7572 6527 2e0a 5468 6973 configure'..This │ │ │ │ │ -00043dc0: 2069 7320 6d61 6e64 6174 6564 2062 7920 is mandated by │ │ │ │ │ -00043dd0: 7468 6520 474e 5520 636f 6469 6e67 2073 the GNU coding s │ │ │ │ │ -00043de0: 7461 6e64 6172 6473 2c20 736f 2074 6861 tandards, so tha │ │ │ │ │ -00043df0: 7420 7468 6520 7573 6572 2063 616e 2072 t the user can r │ │ │ │ │ -00043e00: 756e 0a27 6d61 6b65 2070 7265 6669 783d un.'make prefix= │ │ │ │ │ -00043e10: 2f66 6f6f 2069 6e73 7461 6c6c 272e 2020 /foo install'. │ │ │ │ │ -00043e20: 5468 6520 4175 746f 636f 6e66 206d 616e The Autoconf man │ │ │ │ │ -00043e30: 7561 6c20 6861 7320 6120 7365 6374 696f ual has a sectio │ │ │ │ │ -00043e40: 6e20 7769 7468 206d 6f72 650a 6465 7461 n with more.deta │ │ │ │ │ -00043e50: 696c 7320 6f6e 2074 6869 7320 746f 7069 ils on this topi │ │ │ │ │ -00043e60: 6320 282a 6e6f 7465 2049 6e73 7461 6c6c c (*note Install │ │ │ │ │ -00043e70: 6174 696f 6e20 4469 7265 6374 6f72 7920 ation Directory │ │ │ │ │ -00043e80: 5661 7269 6162 6c65 733a 0a28 6175 746f Variables:.(auto │ │ │ │ │ -00043e90: 636f 6e66 2949 6e73 7461 6c6c 6174 696f conf)Installatio │ │ │ │ │ -00043ea0: 6e20 4469 7265 6374 6f72 7920 5661 7269 n Directory Vari │ │ │ │ │ -00043eb0: 6162 6c65 732e 292e 2020 5365 6520 616c ables.). See al │ │ │ │ │ -00043ec0: 736f 202a 6e6f 7465 2048 6172 642d 436f so *note Hard-Co │ │ │ │ │ -00043ed0: 6465 640a 496e 7374 616c 6c20 5061 7468 ded.Install Path │ │ │ │ │ -00043ee0: 733a 3a2e 0a0a 1f0a 4669 6c65 3a20 6175 s::.....File: au │ │ │ │ │ -00043ef0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -00043f00: 2c20 204e 6f64 653a 2044 6f63 756d 656e , Node: Documen │ │ │ │ │ -00043f10: 7461 7469 6f6e 2c20 204e 6578 743a 2049 tation, Next: I │ │ │ │ │ -00043f20: 6e73 7461 6c6c 2c20 2050 7265 763a 204f nstall, Prev: O │ │ │ │ │ -00043f30: 7468 6572 2047 4e55 2054 6f6f 6c73 2c20 ther GNU Tools, │ │ │ │ │ -00043f40: 2055 703a 2054 6f70 0a0a 3131 2042 7569 Up: Top..11 Bui │ │ │ │ │ -00043f50: 6c64 696e 6720 646f 6375 6d65 6e74 6174 lding documentat │ │ │ │ │ -00043f60: 696f 6e0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ion.************ │ │ │ │ │ -00043f70: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a43 *************..C │ │ │ │ │ -00043f80: 7572 7265 6e74 6c79 2041 7574 6f6d 616b urrently Automak │ │ │ │ │ -00043f90: 6520 7072 6f76 6964 6573 2073 7570 706f e provides suppo │ │ │ │ │ -00043fa0: 7274 2066 6f72 2054 6578 696e 666f 2061 rt for Texinfo a │ │ │ │ │ -00043fb0: 6e64 206d 616e 2070 6167 6573 2e0a 0a2a nd man pages...* │ │ │ │ │ -00043fc0: 204d 656e 753a 0a0a 2a20 5465 7869 6e66 Menu:..* Texinf │ │ │ │ │ -00043fd0: 6f3a 3a20 2020 2020 2020 2020 2020 2020 o:: │ │ │ │ │ -00043fe0: 2020 2020 2020 2020 5465 7869 6e66 6f0a Texinfo. │ │ │ │ │ -00043ff0: 2a20 4d61 6e20 5061 6765 733a 3a20 2020 * Man Pages:: │ │ │ │ │ +00042330: 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 ========..Automa │ │ │ │ │ +00042340: 6b65 2070 726f 7669 6465 7320 736f 6d65 ke provides some │ │ │ │ │ +00042350: 206d 696e 696d 616c 2073 7570 706f 7274 minimal support │ │ │ │ │ +00042360: 2066 6f72 204a 6176 6120 6279 7465 636f for Java byteco │ │ │ │ │ +00042370: 6465 2063 6f6d 7069 6c61 7469 6f6e 0a77 de compilation.w │ │ │ │ │ +00042380: 6974 6820 7468 6520 274a 4156 4127 2070 ith the 'JAVA' p │ │ │ │ │ +00042390: 7269 6d61 7279 2028 696e 2061 6464 6974 rimary (in addit │ │ │ │ │ +000423a0: 696f 6e20 746f 2074 6865 2073 7570 706f ion to the suppo │ │ │ │ │ +000423b0: 7274 2066 6f72 2063 6f6d 7069 6c69 6e67 rt for compiling │ │ │ │ │ +000423c0: 204a 6176 610a 746f 206e 6174 6976 6520 Java.to native │ │ │ │ │ +000423d0: 6d61 6368 696e 6520 636f 6465 3b20 2a6e machine code; *n │ │ │ │ │ +000423e0: 6f74 6520 4a61 7661 2053 7570 706f 7274 ote Java Support │ │ │ │ │ +000423f0: 2077 6974 6820 6763 6a3a 3a29 2e20 204e with gcj::). N │ │ │ │ │ +00042400: 6f74 6520 686f 7765 7665 720a 7468 6174 ote however.that │ │ │ │ │ +00042410: 205f 7468 6520 696e 7465 7266 6163 6520 _the interface │ │ │ │ │ +00042420: 616e 6420 6d6f 7374 2066 6561 7475 7265 and most feature │ │ │ │ │ +00042430: 7320 6465 7363 7269 6265 6420 6865 7265 s described here │ │ │ │ │ +00042440: 2061 7265 2064 6570 7265 6361 7465 645f are deprecated_ │ │ │ │ │ +00042450: 3b0a 7468 6520 6e65 7874 2061 7574 6f6d ;.the next autom │ │ │ │ │ +00042460: 616b 6520 7265 6c65 6173 6520 7769 6c6c ake release will │ │ │ │ │ +00042470: 2073 7472 6976 6520 746f 2070 726f 7669 strive to provi │ │ │ │ │ +00042480: 6465 2061 2062 6574 7465 7220 616e 6420 de a better and │ │ │ │ │ +00042490: 636c 6561 6e65 720a 696e 7465 7266 6163 cleaner.interfac │ │ │ │ │ +000424a0: 652c 2077 6869 6368 2068 6f77 6576 6572 e, which however │ │ │ │ │ +000424b0: 205f 776f 6e27 7420 6265 2062 6163 6b77 _won't be backw │ │ │ │ │ +000424c0: 6172 642d 636f 6d70 6174 6962 6c65 5f3b ard-compatible_; │ │ │ │ │ +000424d0: 2074 6865 2070 7265 7365 6e74 0a69 6e74 the present.int │ │ │ │ │ +000424e0: 6572 6661 6365 2077 696c 6c20 7072 6f62 erface will prob │ │ │ │ │ +000424f0: 6162 6c79 2062 6520 7265 6d6f 7665 6420 ably be removed │ │ │ │ │ +00042500: 616c 746f 6765 7468 6572 2069 6e20 6675 altogether in fu │ │ │ │ │ +00042510: 7475 7265 2061 7574 6f6d 616b 650a 7265 ture automake.re │ │ │ │ │ +00042520: 6c65 6173 6573 2028 312e 3133 206f 7220 leases (1.13 or │ │ │ │ │ +00042530: 6c61 7465 7229 2c20 736f 2064 6f6e 2774 later), so don't │ │ │ │ │ +00042540: 2075 7365 2069 7420 696e 206e 6577 2063 use it in new c │ │ │ │ │ +00042550: 6f64 652e 0a0a 2020 2041 6e79 2027 2e6a ode... Any '.j │ │ │ │ │ +00042560: 6176 6127 2066 696c 6573 206c 6973 7465 ava' files liste │ │ │ │ │ +00042570: 6420 696e 2061 2027 5f4a 4156 4127 2076 d in a '_JAVA' v │ │ │ │ │ +00042580: 6172 6961 626c 6520 7769 6c6c 2062 6520 ariable will be │ │ │ │ │ +00042590: 636f 6d70 696c 6564 2077 6974 680a 274a compiled with.'J │ │ │ │ │ +000425a0: 4156 4143 2720 6174 2062 7569 6c64 2074 AVAC' at build t │ │ │ │ │ +000425b0: 696d 652e 2020 4279 2064 6566 6175 6c74 ime. By default │ │ │ │ │ +000425c0: 2c20 272e 6a61 7661 2720 6669 6c65 7320 , '.java' files │ │ │ │ │ +000425d0: 6172 6520 6e6f 7420 696e 636c 7564 6564 are not included │ │ │ │ │ +000425e0: 2069 6e0a 7468 6520 6469 7374 7269 6275 in.the distribu │ │ │ │ │ +000425f0: 7469 6f6e 2c20 796f 7520 7368 6f75 6c64 tion, you should │ │ │ │ │ +00042600: 2075 7365 2074 6865 2027 6469 7374 5f27 use the 'dist_' │ │ │ │ │ +00042610: 2070 7265 6669 7820 746f 2064 6973 7472 prefix to distr │ │ │ │ │ +00042620: 6962 7574 6520 7468 656d 2e0a 0a20 2020 ibute them... │ │ │ │ │ +00042630: 4865 7265 2069 7320 6120 7479 7069 6361 Here is a typica │ │ │ │ │ +00042640: 6c20 7365 7475 7020 666f 7220 6469 7374 l setup for dist │ │ │ │ │ +00042650: 7269 6275 7469 6e67 2027 2e6a 6176 6127 ributing '.java' │ │ │ │ │ +00042660: 2066 696c 6573 2061 6e64 2069 6e73 7461 files and insta │ │ │ │ │ +00042670: 6c6c 696e 670a 7468 6520 272e 636c 6173 lling.the '.clas │ │ │ │ │ +00042680: 7327 2066 696c 6573 2072 6573 756c 7469 s' files resulti │ │ │ │ │ +00042690: 6e67 2066 726f 6d20 7468 6569 7220 636f ng from their co │ │ │ │ │ +000426a0: 6d70 696c 6174 696f 6e2e 0a0a 2020 2020 mpilation... │ │ │ │ │ +000426b0: 206a 6176 6164 6972 203d 2024 2864 6174 javadir = $(dat │ │ │ │ │ +000426c0: 6164 6972 292f 6a61 7661 0a20 2020 2020 adir)/java. │ │ │ │ │ +000426d0: 6469 7374 5f6a 6176 615f 4a41 5641 203d dist_java_JAVA = │ │ │ │ │ +000426e0: 2061 2e6a 6176 6120 622e 6a61 7661 202e a.java b.java . │ │ │ │ │ +000426f0: 2e2e 0a0a 2020 2043 7572 7265 6e74 6c79 .... Currently │ │ │ │ │ +00042700: 2041 7574 6f6d 616b 6520 656e 666f 7263 Automake enforc │ │ │ │ │ +00042710: 6573 2074 6865 2072 6573 7472 6963 7469 es the restricti │ │ │ │ │ +00042720: 6f6e 2074 6861 7420 6f6e 6c79 206f 6e65 on that only one │ │ │ │ │ +00042730: 2027 5f4a 4156 4127 0a70 7269 6d61 7279 '_JAVA'.primary │ │ │ │ │ +00042740: 2063 616e 2062 6520 7573 6564 2069 6e20 can be used in │ │ │ │ │ +00042750: 6120 6769 7665 6e20 274d 616b 6566 696c a given 'Makefil │ │ │ │ │ +00042760: 652e 616d 272e 2020 5468 6520 7265 6173 e.am'. The reas │ │ │ │ │ +00042770: 6f6e 2066 6f72 2074 6869 730a 7265 7374 on for this.rest │ │ │ │ │ +00042780: 7269 6374 696f 6e20 6973 2074 6861 742c riction is that, │ │ │ │ │ +00042790: 2069 6e20 6765 6e65 7261 6c2c 2069 7420 in general, it │ │ │ │ │ +000427a0: 6973 6e27 7420 706f 7373 6962 6c65 2074 isn't possible t │ │ │ │ │ +000427b0: 6f20 6b6e 6f77 2077 6869 6368 0a27 2e63 o know which.'.c │ │ │ │ │ +000427c0: 6c61 7373 2720 6669 6c65 7320 7765 7265 lass' files were │ │ │ │ │ +000427d0: 2067 656e 6572 6174 6564 2066 726f 6d20 generated from │ │ │ │ │ +000427e0: 7768 6963 6820 272e 6a61 7661 2720 6669 which '.java' fi │ │ │ │ │ +000427f0: 6c65 732c 2073 6f20 6974 2077 6f75 6c64 les, so it would │ │ │ │ │ +00042800: 2062 650a 696d 706f 7373 6962 6c65 2074 be.impossible t │ │ │ │ │ +00042810: 6f20 6b6e 6f77 2077 6869 6368 2066 696c o know which fil │ │ │ │ │ +00042820: 6573 2074 6f20 696e 7374 616c 6c20 7768 es to install wh │ │ │ │ │ +00042830: 6572 652e 2020 466f 7220 696e 7374 616e ere. For instan │ │ │ │ │ +00042840: 6365 2c20 610a 272e 6a61 7661 2720 6669 ce, a.'.java' fi │ │ │ │ │ +00042850: 6c65 2063 616e 2064 6566 696e 6520 6d75 le can define mu │ │ │ │ │ +00042860: 6c74 6970 6c65 2063 6c61 7373 6573 3b20 ltiple classes; │ │ │ │ │ +00042870: 7468 6520 7265 7375 6c74 696e 6720 272e the resulting '. │ │ │ │ │ +00042880: 636c 6173 7327 2066 696c 650a 6e61 6d65 class' file.name │ │ │ │ │ +00042890: 7320 6361 6e6e 6f74 2062 6520 7072 6564 s cannot be pred │ │ │ │ │ +000428a0: 6963 7465 6420 7769 7468 6f75 7420 7061 icted without pa │ │ │ │ │ +000428b0: 7273 696e 6720 7468 6520 272e 6a61 7661 rsing the '.java │ │ │ │ │ +000428c0: 2720 6669 6c65 2e0a 0a20 2020 5468 6572 ' file... Ther │ │ │ │ │ +000428d0: 6520 6172 6520 6120 6665 7720 7661 7269 e are a few vari │ │ │ │ │ +000428e0: 6162 6c65 7320 7468 6174 2061 7265 2075 ables that are u │ │ │ │ │ +000428f0: 7365 6420 7768 656e 2063 6f6d 7069 6c69 sed when compili │ │ │ │ │ +00042900: 6e67 204a 6176 6120 736f 7572 6365 733a ng Java sources: │ │ │ │ │ +00042910: 0a0a 274a 4156 4143 270a 2020 2020 2054 ..'JAVAC'. T │ │ │ │ │ +00042920: 6865 206e 616d 6520 6f66 2074 6865 204a he name of the J │ │ │ │ │ +00042930: 6176 6120 636f 6d70 696c 6572 2e20 2054 ava compiler. T │ │ │ │ │ +00042940: 6869 7320 6465 6661 756c 7473 2074 6f20 his defaults to │ │ │ │ │ +00042950: 276a 6176 6163 272e 0a0a 274a 4156 4143 'javac'...'JAVAC │ │ │ │ │ +00042960: 464c 4147 5327 0a20 2020 2020 5468 6520 FLAGS'. The │ │ │ │ │ +00042970: 666c 6167 7320 746f 2070 6173 7320 746f flags to pass to │ │ │ │ │ +00042980: 2074 6865 2063 6f6d 7069 6c65 722e 2020 the compiler. │ │ │ │ │ +00042990: 5468 6973 2069 7320 636f 6e73 6964 6572 This is consider │ │ │ │ │ +000429a0: 6564 2074 6f20 6265 2061 2075 7365 720a ed to be a user. │ │ │ │ │ +000429b0: 2020 2020 2076 6172 6961 626c 6520 282a variable (* │ │ │ │ │ +000429c0: 6e6f 7465 2055 7365 7220 5661 7269 6162 note User Variab │ │ │ │ │ +000429d0: 6c65 733a 3a29 2e0a 0a27 414d 5f4a 4156 les::)...'AM_JAV │ │ │ │ │ +000429e0: 4143 464c 4147 5327 0a20 2020 2020 4d6f ACFLAGS'. Mo │ │ │ │ │ +000429f0: 7265 2066 6c61 6773 2074 6f20 7061 7373 re flags to pass │ │ │ │ │ +00042a00: 2074 6f20 7468 6520 4a61 7661 2063 6f6d to the Java com │ │ │ │ │ +00042a10: 7069 6c65 722e 2020 5468 6973 2c20 616e piler. This, an │ │ │ │ │ +00042a20: 6420 6e6f 740a 2020 2020 2027 4a41 5641 d not. 'JAVA │ │ │ │ │ +00042a30: 4346 4c41 4753 272c 2073 686f 756c 6420 CFLAGS', should │ │ │ │ │ +00042a40: 6265 2075 7365 6420 7768 656e 2069 7420 be used when it │ │ │ │ │ +00042a50: 6973 206e 6563 6573 7361 7279 2074 6f20 is necessary to │ │ │ │ │ +00042a60: 7075 7420 4a61 7661 0a20 2020 2020 636f put Java. co │ │ │ │ │ +00042a70: 6d70 696c 6572 2066 6c61 6773 2069 6e74 mpiler flags int │ │ │ │ │ +00042a80: 6f20 274d 616b 6566 696c 652e 616d 272e o 'Makefile.am'. │ │ │ │ │ +00042a90: 0a0a 274a 4156 4152 4f4f 5427 0a20 2020 ..'JAVAROOT'. │ │ │ │ │ +00042aa0: 2020 5468 6520 7661 6c75 6520 6f66 2074 The value of t │ │ │ │ │ +00042ab0: 6869 7320 7661 7269 6162 6c65 2069 7320 his variable is │ │ │ │ │ +00042ac0: 7061 7373 6564 2074 6f20 7468 6520 272d passed to the '- │ │ │ │ │ +00042ad0: 6427 206f 7074 696f 6e20 746f 2027 6a61 d' option to 'ja │ │ │ │ │ +00042ae0: 7661 6327 2e0a 2020 2020 2049 7420 6465 vac'.. It de │ │ │ │ │ +00042af0: 6661 756c 7473 2074 6f20 2724 2874 6f70 faults to '$(top │ │ │ │ │ +00042b00: 5f62 7569 6c64 6469 7229 272e 0a0a 2743 _builddir)'...'C │ │ │ │ │ +00042b10: 4c41 5353 5041 5448 5f45 4e56 270a 2020 LASSPATH_ENV'. │ │ │ │ │ +00042b20: 2020 2054 6869 7320 7661 7269 6162 6c65 This variable │ │ │ │ │ +00042b30: 2069 7320 6120 7368 656c 6c20 6578 7072 is a shell expr │ │ │ │ │ +00042b40: 6573 7369 6f6e 2074 6861 7420 6973 2075 ession that is u │ │ │ │ │ +00042b50: 7365 6420 746f 2073 6574 2074 6865 0a20 sed to set the. │ │ │ │ │ +00042b60: 2020 2020 2743 4c41 5353 5041 5448 2720 'CLASSPATH' │ │ │ │ │ +00042b70: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +00042b80: 6162 6c65 206f 6e20 7468 6520 276a 6176 able on the 'jav │ │ │ │ │ +00042b90: 6163 2720 636f 6d6d 616e 6420 6c69 6e65 ac' command line │ │ │ │ │ +00042ba0: 2e20 2028 496e 0a20 2020 2020 7468 6520 . (In. the │ │ │ │ │ +00042bb0: 6675 7475 7265 2077 6520 7769 6c6c 2070 future we will p │ │ │ │ │ +00042bc0: 726f 6261 626c 7920 6861 6e64 6c65 2063 robably handle c │ │ │ │ │ +00042bd0: 6c61 7373 2070 6174 6820 7365 7474 696e lass path settin │ │ │ │ │ +00042be0: 6720 6469 6666 6572 656e 746c 792e 290a g differently.). │ │ │ │ │ +00042bf0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +00042c00: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +00042c10: 6465 3a20 5079 7468 6f6e 2c20 2050 7265 de: Python, Pre │ │ │ │ │ +00042c20: 763a 204a 6176 612c 2020 5570 3a20 4f74 v: Java, Up: Ot │ │ │ │ │ +00042c30: 6865 7220 474e 5520 546f 6f6c 730a 0a31 her GNU Tools..1 │ │ │ │ │ +00042c40: 302e 3520 5079 7468 6f6e 0a3d 3d3d 3d3d 0.5 Python.===== │ │ │ │ │ +00042c50: 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 ======..Automake │ │ │ │ │ +00042c60: 2070 726f 7669 6465 7320 7375 7070 6f72 provides suppor │ │ │ │ │ +00042c70: 7420 666f 7220 5079 7468 6f6e 2063 6f6d t for Python com │ │ │ │ │ +00042c80: 7069 6c61 7469 6f6e 2077 6974 6820 7468 pilation with th │ │ │ │ │ +00042c90: 6520 2750 5954 484f 4e27 0a70 7269 6d61 e 'PYTHON'.prima │ │ │ │ │ +00042ca0: 7279 2e20 2041 2074 7970 6963 616c 2073 ry. A typical s │ │ │ │ │ +00042cb0: 6574 7570 2069 7320 746f 2063 616c 6c20 etup is to call │ │ │ │ │ +00042cc0: 2741 4d5f 5041 5448 5f50 5954 484f 4e27 'AM_PATH_PYTHON' │ │ │ │ │ +00042cd0: 2069 6e20 2763 6f6e 6669 6775 7265 2e61 in 'configure.a │ │ │ │ │ +00042ce0: 6327 0a61 6e64 2075 7365 2061 206c 696e c'.and use a lin │ │ │ │ │ +00042cf0: 6520 6c69 6b65 2074 6865 2066 6f6c 6c6f e like the follo │ │ │ │ │ +00042d00: 7769 6e67 2069 6e20 274d 616b 6566 696c wing in 'Makefil │ │ │ │ │ +00042d10: 652e 616d 273a 0a0a 2020 2020 2070 7974 e.am':.. pyt │ │ │ │ │ +00042d20: 686f 6e5f 5059 5448 4f4e 203d 2074 7265 hon_PYTHON = tre │ │ │ │ │ +00042d30: 652e 7079 206c 6561 7665 2e70 790a 0a20 e.py leave.py.. │ │ │ │ │ +00042d40: 2020 416e 7920 6669 6c65 7320 6c69 7374 Any files list │ │ │ │ │ +00042d50: 6564 2069 6e20 6120 275f 5059 5448 4f4e ed in a '_PYTHON │ │ │ │ │ +00042d60: 2720 7661 7269 6162 6c65 2077 696c 6c20 ' variable will │ │ │ │ │ +00042d70: 6265 2062 7974 652d 636f 6d70 696c 6564 be byte-compiled │ │ │ │ │ +00042d80: 2077 6974 680a 2770 792d 636f 6d70 696c with.'py-compil │ │ │ │ │ +00042d90: 6527 2061 7420 696e 7374 616c 6c20 7469 e' at install ti │ │ │ │ │ +00042da0: 6d65 2e20 2027 7079 2d63 6f6d 7069 6c65 me. 'py-compile │ │ │ │ │ +00042db0: 2720 6163 7475 616c 6c79 2063 7265 6174 ' actually creat │ │ │ │ │ +00042dc0: 6573 2062 6f74 680a 7374 616e 6461 7264 es both.standard │ │ │ │ │ +00042dd0: 2028 272e 7079 6327 2920 616e 6420 6f70 ('.pyc') and op │ │ │ │ │ +00042de0: 7469 6d69 7a65 6420 2827 2e70 796f 2729 timized ('.pyo') │ │ │ │ │ +00042df0: 2062 7974 652d 636f 6d70 696c 6564 2076 byte-compiled v │ │ │ │ │ +00042e00: 6572 7369 6f6e 7320 6f66 2074 6865 0a73 ersions of the.s │ │ │ │ │ +00042e10: 6f75 7263 6520 6669 6c65 732e 2020 4e6f ource files. No │ │ │ │ │ +00042e20: 7465 2074 6861 7420 6265 6361 7573 6520 te that because │ │ │ │ │ +00042e30: 6279 7465 2d63 6f6d 7069 6c61 7469 6f6e byte-compilation │ │ │ │ │ +00042e40: 206f 6363 7572 7320 6174 2069 6e73 7461 occurs at insta │ │ │ │ │ +00042e50: 6c6c 0a74 696d 652c 2061 6e79 2066 696c ll.time, any fil │ │ │ │ │ +00042e60: 6573 206c 6973 7465 6420 696e 2027 6e6f es listed in 'no │ │ │ │ │ +00042e70: 696e 7374 5f50 5954 484f 4e27 2077 696c inst_PYTHON' wil │ │ │ │ │ +00042e80: 6c20 6e6f 7420 6265 2063 6f6d 7069 6c65 l not be compile │ │ │ │ │ +00042e90: 642e 2020 5079 7468 6f6e 0a73 6f75 7263 d. Python.sourc │ │ │ │ │ +00042ea0: 6520 6669 6c65 7320 6172 6520 696e 636c e files are incl │ │ │ │ │ +00042eb0: 7564 6564 2069 6e20 7468 6520 6469 7374 uded in the dist │ │ │ │ │ +00042ec0: 7269 6275 7469 6f6e 2062 7920 6465 6661 ribution by defa │ │ │ │ │ +00042ed0: 756c 742c 2070 7265 7065 6e64 0a27 6e6f ult, prepend.'no │ │ │ │ │ +00042ee0: 6469 7374 5f27 2028 6173 2069 6e20 276e dist_' (as in 'n │ │ │ │ │ +00042ef0: 6f64 6973 745f 7079 7468 6f6e 5f50 5954 odist_python_PYT │ │ │ │ │ +00042f00: 484f 4e27 2920 746f 206f 6d69 7420 7468 HON') to omit th │ │ │ │ │ +00042f10: 656d 2e0a 0a20 2020 4175 746f 6d61 6b65 em... Automake │ │ │ │ │ +00042f20: 2073 6869 7073 2077 6974 6820 616e 2041 ships with an A │ │ │ │ │ +00042f30: 7574 6f63 6f6e 6620 6d61 6372 6f20 6361 utoconf macro ca │ │ │ │ │ +00042f40: 6c6c 6564 2027 414d 5f50 4154 485f 5059 lled 'AM_PATH_PY │ │ │ │ │ +00042f50: 5448 4f4e 2720 7468 6174 0a77 696c 6c20 THON' that.will │ │ │ │ │ +00042f60: 6465 7465 726d 696e 6520 736f 6d65 2050 determine some P │ │ │ │ │ +00042f70: 7974 686f 6e2d 7265 6c61 7465 6420 6469 ython-related di │ │ │ │ │ +00042f80: 7265 6374 6f72 7920 7661 7269 6162 6c65 rectory variable │ │ │ │ │ +00042f90: 7320 2873 6565 2062 656c 6f77 292e 2020 s (see below). │ │ │ │ │ +00042fa0: 4966 0a79 6f75 2068 6176 6520 6361 6c6c If.you have call │ │ │ │ │ +00042fb0: 6564 2027 414d 5f50 4154 485f 5059 5448 ed 'AM_PATH_PYTH │ │ │ │ │ +00042fc0: 4f4e 2720 6672 6f6d 2027 636f 6e66 6967 ON' from 'config │ │ │ │ │ +00042fd0: 7572 652e 6163 272c 2074 6865 6e20 796f ure.ac', then yo │ │ │ │ │ +00042fe0: 7520 6d61 7920 7573 650a 7468 6520 7661 u may use.the va │ │ │ │ │ +00042ff0: 7269 6162 6c65 7320 2770 7974 686f 6e5f riables 'python_ │ │ │ │ │ +00043000: 5059 5448 4f4e 2720 6f72 2027 706b 6770 PYTHON' or 'pkgp │ │ │ │ │ +00043010: 7974 686f 6e5f 5059 5448 4f4e 2720 746f ython_PYTHON' to │ │ │ │ │ +00043020: 206c 6973 7420 5079 7468 6f6e 0a73 6f75 list Python.sou │ │ │ │ │ +00043030: 7263 6520 6669 6c65 7320 696e 2079 6f75 rce files in you │ │ │ │ │ +00043040: 7220 274d 616b 6566 696c 652e 616d 272c r 'Makefile.am', │ │ │ │ │ +00043050: 2064 6570 656e 6469 6e67 206f 6e20 7768 depending on wh │ │ │ │ │ +00043060: 6572 6520 796f 7520 7761 6e74 2079 6f75 ere you want you │ │ │ │ │ +00043070: 720a 6669 6c65 7320 696e 7374 616c 6c65 r.files installe │ │ │ │ │ +00043080: 6420 2873 6565 2074 6865 2064 6566 696e d (see the defin │ │ │ │ │ +00043090: 6974 696f 6e73 206f 6620 2770 7974 686f itions of 'pytho │ │ │ │ │ +000430a0: 6e64 6972 2720 616e 6420 2770 6b67 7079 ndir' and 'pkgpy │ │ │ │ │ +000430b0: 7468 6f6e 6469 7227 0a62 656c 6f77 292e thondir'.below). │ │ │ │ │ +000430c0: 0a0a 202d 2d20 4d61 6372 6f3a 2041 4d5f .. -- Macro: AM_ │ │ │ │ │ +000430d0: 5041 5448 5f50 5954 484f 4e20 285b 5645 PATH_PYTHON ([VE │ │ │ │ │ +000430e0: 5253 494f 4e5d 2c20 5b41 4354 494f 4e2d RSION], [ACTION- │ │ │ │ │ +000430f0: 4946 2d46 4f55 4e44 5d2c 0a20 2020 2020 IF-FOUND],. │ │ │ │ │ +00043100: 5b41 4354 494f 4e2d 4946 2d4e 4f54 2d46 [ACTION-IF-NOT-F │ │ │ │ │ +00043110: 4f55 4e44 5d29 0a0a 2020 2020 2053 6561 OUND]).. Sea │ │ │ │ │ +00043120: 7263 6820 666f 7220 6120 5079 7468 6f6e rch for a Python │ │ │ │ │ +00043130: 2069 6e74 6572 7072 6574 6572 206f 6e20 interpreter on │ │ │ │ │ +00043140: 7468 6520 7379 7374 656d 2e20 2054 6869 the system. Thi │ │ │ │ │ +00043150: 7320 6d61 6372 6f20 7461 6b65 730a 2020 s macro takes. │ │ │ │ │ +00043160: 2020 2074 6872 6565 206f 7074 696f 6e61 three optiona │ │ │ │ │ +00043170: 6c20 6172 6775 6d65 6e74 732e 2020 5468 l arguments. Th │ │ │ │ │ +00043180: 6520 6669 7273 7420 6172 6775 6d65 6e74 e first argument │ │ │ │ │ +00043190: 2c20 6966 2070 7265 7365 6e74 2c20 6973 , if present, is │ │ │ │ │ +000431a0: 2074 6865 0a20 2020 2020 6d69 6e69 6d75 the. minimu │ │ │ │ │ +000431b0: 6d20 7665 7273 696f 6e20 6f66 2050 7974 m version of Pyt │ │ │ │ │ +000431c0: 686f 6e20 7265 7175 6972 6564 2066 6f72 hon required for │ │ │ │ │ +000431d0: 2074 6869 7320 7061 636b 6167 653a 0a20 this package:. │ │ │ │ │ +000431e0: 2020 2020 2741 4d5f 5041 5448 5f50 5954 'AM_PATH_PYT │ │ │ │ │ +000431f0: 484f 4e27 2077 696c 6c20 736b 6970 2061 HON' will skip a │ │ │ │ │ +00043200: 6e79 2050 7974 686f 6e20 696e 7465 7270 ny Python interp │ │ │ │ │ +00043210: 7265 7465 7220 7468 6174 2069 7320 6f6c reter that is ol │ │ │ │ │ +00043220: 6465 720a 2020 2020 2074 6861 6e20 5645 der. than VE │ │ │ │ │ +00043230: 5253 494f 4e2e 2020 4966 2061 6e20 696e RSION. If an in │ │ │ │ │ +00043240: 7465 7270 7265 7465 7220 6973 2066 6f75 terpreter is fou │ │ │ │ │ +00043250: 6e64 2061 6e64 2073 6174 6973 6669 6573 nd and satisfies │ │ │ │ │ +00043260: 2056 4552 5349 4f4e 2c0a 2020 2020 2074 VERSION,. t │ │ │ │ │ +00043270: 6865 6e20 4143 5449 4f4e 2d49 462d 464f hen ACTION-IF-FO │ │ │ │ │ +00043280: 554e 4420 6973 2072 756e 2e20 204f 7468 UND is run. Oth │ │ │ │ │ +00043290: 6572 7769 7365 2c20 4143 5449 4f4e 2d49 erwise, ACTION-I │ │ │ │ │ +000432a0: 462d 4e4f 542d 464f 554e 4420 6973 0a20 F-NOT-FOUND is. │ │ │ │ │ +000432b0: 2020 2020 7275 6e2e 0a0a 2020 2020 2049 run... I │ │ │ │ │ +000432c0: 6620 4143 5449 4f4e 2d49 462d 4e4f 542d f ACTION-IF-NOT- │ │ │ │ │ +000432d0: 464f 554e 4420 6973 206e 6f74 2073 7065 FOUND is not spe │ │ │ │ │ +000432e0: 6369 6669 6564 2c20 6173 2069 6e20 7468 cified, as in th │ │ │ │ │ +000432f0: 6520 666f 6c6c 6f77 696e 670a 2020 2020 e following. │ │ │ │ │ +00043300: 2065 7861 6d70 6c65 2c20 7468 6520 6465 example, the de │ │ │ │ │ +00043310: 6661 756c 7420 6973 2074 6f20 6162 6f72 fault is to abor │ │ │ │ │ +00043320: 7420 2763 6f6e 6669 6775 7265 272e 0a0a t 'configure'... │ │ │ │ │ +00043330: 2020 2020 2020 2020 2020 414d 5f50 4154 AM_PAT │ │ │ │ │ +00043340: 485f 5059 5448 4f4e 285b 322e 325d 290a H_PYTHON([2.2]). │ │ │ │ │ +00043350: 0a20 2020 2020 5468 6973 2069 7320 6669 . This is fi │ │ │ │ │ +00043360: 6e65 2077 6865 6e20 5079 7468 6f6e 2069 ne when Python i │ │ │ │ │ +00043370: 7320 616e 2061 6273 6f6c 7574 6520 7265 s an absolute re │ │ │ │ │ +00043380: 7175 6972 656d 656e 7420 666f 7220 7468 quirement for th │ │ │ │ │ +00043390: 650a 2020 2020 2070 6163 6b61 6765 2e20 e. package. │ │ │ │ │ +000433a0: 2049 6620 5079 7468 6f6e 203e 3d20 322e If Python >= 2. │ │ │ │ │ +000433b0: 3520 7761 7320 6f6e 6c79 205f 6f70 7469 5 was only _opti │ │ │ │ │ +000433c0: 6f6e 616c 5f20 746f 2074 6865 2070 6163 onal_ to the pac │ │ │ │ │ +000433d0: 6b61 6765 2c0a 2020 2020 2027 414d 5f50 kage,. 'AM_P │ │ │ │ │ +000433e0: 4154 485f 5059 5448 4f4e 2720 636f 756c ATH_PYTHON' coul │ │ │ │ │ +000433f0: 6420 6265 2063 616c 6c65 6420 6173 2066 d be called as f │ │ │ │ │ +00043400: 6f6c 6c6f 7773 2e0a 0a20 2020 2020 2020 ollows... │ │ │ │ │ +00043410: 2020 2041 4d5f 5041 5448 5f50 5954 484f AM_PATH_PYTHO │ │ │ │ │ +00043420: 4e28 5b32 2e35 5d2c 2c20 5b3a 5d29 0a0a N([2.5],, [:]).. │ │ │ │ │ +00043430: 2020 2020 2049 6620 7468 6520 2750 5954 If the 'PYT │ │ │ │ │ +00043440: 484f 4e27 2076 6172 6961 626c 6520 6973 HON' variable is │ │ │ │ │ +00043450: 2073 6574 2077 6865 6e20 2741 4d5f 5041 set when 'AM_PA │ │ │ │ │ +00043460: 5448 5f50 5954 484f 4e27 2069 7320 6361 TH_PYTHON' is ca │ │ │ │ │ +00043470: 6c6c 6564 2c0a 2020 2020 2074 6865 6e20 lled,. then │ │ │ │ │ +00043480: 7468 6174 2077 696c 6c20 6265 2074 6865 that will be the │ │ │ │ │ +00043490: 206f 6e6c 7920 5079 7468 6f6e 2069 6e74 only Python int │ │ │ │ │ +000434a0: 6572 7072 6574 6572 2074 6861 7420 6973 erpreter that is │ │ │ │ │ +000434b0: 2074 7269 6564 2e0a 0a20 2020 2020 2741 tried... 'A │ │ │ │ │ +000434c0: 4d5f 5041 5448 5f50 5954 484f 4e27 2063 M_PATH_PYTHON' c │ │ │ │ │ +000434d0: 7265 6174 6573 2074 6865 2066 6f6c 6c6f reates the follo │ │ │ │ │ +000434e0: 7769 6e67 206f 7574 7075 7420 7661 7269 wing output vari │ │ │ │ │ +000434f0: 6162 6c65 7320 6261 7365 6420 6f6e 0a20 ables based on. │ │ │ │ │ +00043500: 2020 2020 7468 6520 5079 7468 6f6e 2069 the Python i │ │ │ │ │ +00043510: 6e73 7461 6c6c 6174 696f 6e20 666f 756e nstallation foun │ │ │ │ │ +00043520: 6420 6475 7269 6e67 2063 6f6e 6669 6775 d during configu │ │ │ │ │ +00043530: 7261 7469 6f6e 2e0a 0a27 5059 5448 4f4e ration...'PYTHON │ │ │ │ │ +00043540: 270a 2020 2020 2054 6865 206e 616d 6520 '. The name │ │ │ │ │ +00043550: 6f66 2074 6865 2050 7974 686f 6e20 6578 of the Python ex │ │ │ │ │ +00043560: 6563 7574 6162 6c65 2c20 6f72 2027 3a27 ecutable, or ':' │ │ │ │ │ +00043570: 2069 6620 6e6f 2073 7569 7461 626c 650a if no suitable. │ │ │ │ │ +00043580: 2020 2020 2069 6e74 6572 7072 6574 6572 interpreter │ │ │ │ │ +00043590: 2063 6f75 6c64 2062 6520 666f 756e 642e could be found. │ │ │ │ │ +000435a0: 0a0a 2020 2020 2041 7373 756d 696e 6720 .. Assuming │ │ │ │ │ +000435b0: 4143 5449 4f4e 2d49 462d 4e4f 542d 464f ACTION-IF-NOT-FO │ │ │ │ │ +000435c0: 554e 4420 6973 2075 7365 6420 286f 7468 UND is used (oth │ │ │ │ │ +000435d0: 6572 7769 7365 2027 2e2f 636f 6e66 6967 erwise './config │ │ │ │ │ +000435e0: 7572 6527 2077 696c 6c0a 2020 2020 2061 ure' will. a │ │ │ │ │ +000435f0: 626f 7274 2069 6620 5079 7468 6f6e 2069 bort if Python i │ │ │ │ │ +00043600: 7320 6162 7365 6e74 292c 2074 6865 2076 s absent), the v │ │ │ │ │ +00043610: 616c 7565 206f 6620 2750 5954 484f 4e27 alue of 'PYTHON' │ │ │ │ │ +00043620: 2063 616e 2062 6520 7573 6564 2074 6f0a can be used to. │ │ │ │ │ +00043630: 2020 2020 2073 6574 7570 2061 2063 6f6e setup a con │ │ │ │ │ +00043640: 6469 7469 6f6e 616c 2069 6e20 6f72 6465 ditional in orde │ │ │ │ │ +00043650: 7220 746f 2064 6973 6162 6c65 2074 6865 r to disable the │ │ │ │ │ +00043660: 2072 656c 6576 616e 7420 7061 7274 206f relevant part o │ │ │ │ │ +00043670: 6620 610a 2020 2020 2062 7569 6c64 2061 f a. build a │ │ │ │ │ +00043680: 7320 666f 6c6c 6f77 732e 0a0a 2020 2020 s follows... │ │ │ │ │ +00043690: 2020 2020 2020 414d 5f50 4154 485f 5059 AM_PATH_PY │ │ │ │ │ +000436a0: 5448 4f4e 282c 2c20 5b3a 5d29 0a20 2020 THON(,, [:]). │ │ │ │ │ +000436b0: 2020 2020 2020 2041 4d5f 434f 4e44 4954 AM_CONDIT │ │ │ │ │ +000436c0: 494f 4e41 4c28 5b48 4156 455f 5059 5448 IONAL([HAVE_PYTH │ │ │ │ │ +000436d0: 4f4e 5d2c 205b 7465 7374 2022 2450 5954 ON], [test "$PYT │ │ │ │ │ +000436e0: 484f 4e22 2021 3d20 3a5d 290a 0a27 5059 HON" != :])..'PY │ │ │ │ │ +000436f0: 5448 4f4e 5f56 4552 5349 4f4e 270a 2020 THON_VERSION'. │ │ │ │ │ +00043700: 2020 2054 6865 2050 7974 686f 6e20 7665 The Python ve │ │ │ │ │ +00043710: 7273 696f 6e20 6e75 6d62 6572 2c20 696e rsion number, in │ │ │ │ │ +00043720: 2074 6865 2066 6f72 6d20 4d41 4a4f 522e the form MAJOR. │ │ │ │ │ +00043730: 4d49 4e4f 5220 2865 2e67 2e2c 2027 322e MINOR (e.g., '2. │ │ │ │ │ +00043740: 3527 292e 0a20 2020 2020 5468 6973 2069 5').. This i │ │ │ │ │ +00043750: 7320 6375 7272 656e 746c 7920 7468 6520 s currently the │ │ │ │ │ +00043760: 7661 6c75 6520 6f66 2027 7379 732e 7665 value of 'sys.ve │ │ │ │ │ +00043770: 7273 696f 6e5b 3a33 5d27 2e0a 0a27 5059 rsion[:3]'...'PY │ │ │ │ │ +00043780: 5448 4f4e 5f50 5245 4649 5827 0a20 2020 THON_PREFIX'. │ │ │ │ │ +00043790: 2020 5468 6520 7374 7269 6e67 2027 247b The string '${ │ │ │ │ │ +000437a0: 7072 6566 6978 7d27 2e20 2054 6869 7320 prefix}'. This │ │ │ │ │ +000437b0: 7465 726d 206d 6179 2062 6520 7573 6564 term may be used │ │ │ │ │ +000437c0: 2069 6e20 6675 7475 7265 2077 6f72 6b20 in future work │ │ │ │ │ +000437d0: 7468 6174 0a20 2020 2020 6e65 6564 7320 that. needs │ │ │ │ │ +000437e0: 7468 6520 636f 6e74 656e 7473 206f 6620 the contents of │ │ │ │ │ +000437f0: 5079 7468 6f6e 2773 2027 7379 732e 7072 Python's 'sys.pr │ │ │ │ │ +00043800: 6566 6978 272c 2062 7574 2067 656e 6572 efix', but gener │ │ │ │ │ +00043810: 616c 2063 6f6e 7365 6e73 7573 0a20 2020 al consensus. │ │ │ │ │ +00043820: 2020 6973 2074 6f20 616c 7761 7973 2075 is to always u │ │ │ │ │ +00043830: 7365 2074 6865 2076 616c 7565 2066 726f se the value fro │ │ │ │ │ +00043840: 6d20 2763 6f6e 6669 6775 7265 272e 0a0a m 'configure'... │ │ │ │ │ +00043850: 2750 5954 484f 4e5f 4558 4543 5f50 5245 'PYTHON_EXEC_PRE │ │ │ │ │ +00043860: 4649 5827 0a20 2020 2020 5468 6520 7374 FIX'. The st │ │ │ │ │ +00043870: 7269 6e67 2027 247b 6578 6563 5f70 7265 ring '${exec_pre │ │ │ │ │ +00043880: 6669 787d 272e 2020 5468 6973 2074 6572 fix}'. This ter │ │ │ │ │ +00043890: 6d20 6d61 7920 6265 2075 7365 6420 696e m may be used in │ │ │ │ │ +000438a0: 2066 7574 7572 6520 776f 726b 0a20 2020 future work. │ │ │ │ │ +000438b0: 2020 7468 6174 206e 6565 6473 2074 6865 that needs the │ │ │ │ │ +000438c0: 2063 6f6e 7465 6e74 7320 6f66 2050 7974 contents of Pyt │ │ │ │ │ +000438d0: 686f 6e27 7320 2773 7973 2e65 7865 635f hon's 'sys.exec_ │ │ │ │ │ +000438e0: 7072 6566 6978 272c 2062 7574 2067 656e prefix', but gen │ │ │ │ │ +000438f0: 6572 616c 0a20 2020 2020 636f 6e73 656e eral. consen │ │ │ │ │ +00043900: 7375 7320 6973 2074 6f20 616c 7761 7973 sus is to always │ │ │ │ │ +00043910: 2075 7365 2074 6865 2076 616c 7565 2066 use the value f │ │ │ │ │ +00043920: 726f 6d20 2763 6f6e 6669 6775 7265 272e rom 'configure'. │ │ │ │ │ +00043930: 0a0a 2750 5954 484f 4e5f 504c 4154 464f ..'PYTHON_PLATFO │ │ │ │ │ +00043940: 524d 270a 2020 2020 2054 6865 2063 616e RM'. The can │ │ │ │ │ +00043950: 6f6e 6963 616c 206e 616d 6520 7573 6564 onical name used │ │ │ │ │ +00043960: 2062 7920 5079 7468 6f6e 2074 6f20 6465 by Python to de │ │ │ │ │ +00043970: 7363 7269 6265 2074 6865 206f 7065 7261 scribe the opera │ │ │ │ │ +00043980: 7469 6e67 2073 7973 7465 6d2c 0a20 2020 ting system,. │ │ │ │ │ +00043990: 2020 6173 2067 6976 656e 2062 7920 2773 as given by 's │ │ │ │ │ +000439a0: 7973 2e70 6c61 7466 6f72 6d27 2e20 2054 ys.platform'. T │ │ │ │ │ +000439b0: 6869 7320 7661 6c75 6520 6973 2073 6f6d his value is som │ │ │ │ │ +000439c0: 6574 696d 6573 206e 6565 6465 6420 7768 etimes needed wh │ │ │ │ │ +000439d0: 656e 0a20 2020 2020 6275 696c 6469 6e67 en. building │ │ │ │ │ +000439e0: 2050 7974 686f 6e20 6578 7465 6e73 696f Python extensio │ │ │ │ │ +000439f0: 6e73 2e0a 0a27 7079 7468 6f6e 6469 7227 ns...'pythondir' │ │ │ │ │ +00043a00: 0a20 2020 2020 5468 6520 6469 7265 6374 . The direct │ │ │ │ │ +00043a10: 6f72 7920 6e61 6d65 2066 6f72 2074 6865 ory name for the │ │ │ │ │ +00043a20: 2027 7369 7465 2d70 6163 6b61 6765 7327 'site-packages' │ │ │ │ │ +00043a30: 2073 7562 6469 7265 6374 6f72 7920 6f66 subdirectory of │ │ │ │ │ +00043a40: 2074 6865 0a20 2020 2020 7374 616e 6461 the. standa │ │ │ │ │ +00043a50: 7264 2050 7974 686f 6e20 696e 7374 616c rd Python instal │ │ │ │ │ +00043a60: 6c20 7472 6565 2e0a 0a27 706b 6770 7974 l tree...'pkgpyt │ │ │ │ │ +00043a70: 686f 6e64 6972 270a 2020 2020 2054 6869 hondir'. Thi │ │ │ │ │ +00043a80: 7320 6973 2074 6865 2064 6972 6563 746f s is the directo │ │ │ │ │ +00043a90: 7279 2075 6e64 6572 2027 7079 7468 6f6e ry under 'python │ │ │ │ │ +00043aa0: 6469 7227 2074 6861 7420 6973 206e 616d dir' that is nam │ │ │ │ │ +00043ab0: 6564 2061 6674 6572 2074 6865 0a20 2020 ed after the. │ │ │ │ │ +00043ac0: 2020 7061 636b 6167 652e 2020 5468 6174 package. That │ │ │ │ │ +00043ad0: 2069 732c 2069 7420 6973 2027 2428 7079 is, it is '$(py │ │ │ │ │ +00043ae0: 7468 6f6e 6469 7229 2f24 2850 4143 4b41 thondir)/$(PACKA │ │ │ │ │ +00043af0: 4745 2927 2e20 2049 7420 6973 2070 726f GE)'. It is pro │ │ │ │ │ +00043b00: 7669 6465 640a 2020 2020 2061 7320 6120 vided. as a │ │ │ │ │ +00043b10: 636f 6e76 656e 6965 6e63 652e 0a0a 2770 convenience...'p │ │ │ │ │ +00043b20: 7965 7865 6364 6972 270a 2020 2020 2054 yexecdir'. T │ │ │ │ │ +00043b30: 6869 7320 6973 2074 6865 2064 6972 6563 his is the direc │ │ │ │ │ +00043b40: 746f 7279 2077 6865 7265 2050 7974 686f tory where Pytho │ │ │ │ │ +00043b50: 6e20 6578 7465 6e73 696f 6e20 6d6f 6475 n extension modu │ │ │ │ │ +00043b60: 6c65 7320 2873 6861 7265 640a 2020 2020 les (shared. │ │ │ │ │ +00043b70: 206c 6962 7261 7269 6573 2920 7368 6f75 libraries) shou │ │ │ │ │ +00043b80: 6c64 2062 6520 696e 7374 616c 6c65 642e ld be installed. │ │ │ │ │ +00043b90: 2020 416e 2065 7874 656e 7369 6f6e 206d An extension m │ │ │ │ │ +00043ba0: 6f64 756c 6520 7772 6974 7465 6e20 696e odule written in │ │ │ │ │ +00043bb0: 2043 0a20 2020 2020 636f 756c 6420 6265 C. could be │ │ │ │ │ +00043bc0: 2064 6563 6c61 7265 6420 6173 2066 6f6c declared as fol │ │ │ │ │ +00043bd0: 6c6f 7773 2074 6f20 4175 746f 6d61 6b65 lows to Automake │ │ │ │ │ +00043be0: 3a0a 0a20 2020 2020 2020 2020 2070 7965 :.. pye │ │ │ │ │ +00043bf0: 7865 635f 4c54 4c49 4252 4152 4945 5320 xec_LTLIBRARIES │ │ │ │ │ +00043c00: 3d20 7175 6174 6572 6e69 6f6e 2e6c 610a = quaternion.la. │ │ │ │ │ +00043c10: 2020 2020 2020 2020 2020 7175 6174 6572 quater │ │ │ │ │ +00043c20: 6e69 6f6e 5f6c 615f 534f 5552 4345 5320 nion_la_SOURCES │ │ │ │ │ +00043c30: 3d20 7175 6174 6572 6e69 6f6e 2e63 2073 = quaternion.c s │ │ │ │ │ +00043c40: 7570 706f 7274 2e63 2073 7570 706f 7274 upport.c support │ │ │ │ │ +00043c50: 2e68 0a20 2020 2020 2020 2020 2071 7561 .h. qua │ │ │ │ │ +00043c60: 7465 726e 696f 6e5f 6c61 5f4c 4446 4c41 ternion_la_LDFLA │ │ │ │ │ +00043c70: 4753 203d 202d 6176 6f69 642d 7665 7273 GS = -avoid-vers │ │ │ │ │ +00043c80: 696f 6e20 2d6d 6f64 756c 650a 0a27 706b ion -module..'pk │ │ │ │ │ +00043c90: 6770 7965 7865 6364 6972 270a 2020 2020 gpyexecdir'. │ │ │ │ │ +00043ca0: 2054 6869 7320 6973 2061 2063 6f6e 7665 This is a conve │ │ │ │ │ +00043cb0: 6e69 656e 6365 2076 6172 6961 626c 6520 nience variable │ │ │ │ │ +00043cc0: 7468 6174 2069 7320 6465 6669 6e65 6420 that is defined │ │ │ │ │ +00043cd0: 6173 0a20 2020 2020 2724 2870 7965 7865 as. '$(pyexe │ │ │ │ │ +00043ce0: 6364 6972 292f 2428 5041 434b 4147 4529 cdir)/$(PACKAGE) │ │ │ │ │ +00043cf0: 272e 0a0a 2020 2041 6c6c 2074 6865 7365 '... All these │ │ │ │ │ +00043d00: 2064 6972 6563 746f 7279 2076 6172 6961 directory varia │ │ │ │ │ +00043d10: 626c 6573 2068 6176 6520 7661 6c75 6573 bles have values │ │ │ │ │ +00043d20: 2074 6861 7420 7374 6172 7420 7769 7468 that start with │ │ │ │ │ +00043d30: 2065 6974 6865 720a 2724 7b70 7265 6669 either.'${prefi │ │ │ │ │ +00043d40: 787d 2720 6f72 2027 247b 6578 6563 5f70 x}' or '${exec_p │ │ │ │ │ +00043d50: 7265 6669 787d 2720 756e 6578 7061 6e64 refix}' unexpand │ │ │ │ │ +00043d60: 6564 2e20 2054 6869 7320 776f 726b 7320 ed. This works │ │ │ │ │ +00043d70: 6669 6e65 2069 6e0a 274d 616b 6566 696c fine in.'Makefil │ │ │ │ │ +00043d80: 6573 272c 2062 7574 2069 7420 6d61 6b65 es', but it make │ │ │ │ │ +00043d90: 7320 7468 6573 6520 7661 7269 6162 6c65 s these variable │ │ │ │ │ +00043da0: 7320 6861 7264 2074 6f20 7573 6520 696e s hard to use in │ │ │ │ │ +00043db0: 2027 636f 6e66 6967 7572 6527 2e0a 5468 'configure'..Th │ │ │ │ │ +00043dc0: 6973 2069 7320 6d61 6e64 6174 6564 2062 is is mandated b │ │ │ │ │ +00043dd0: 7920 7468 6520 474e 5520 636f 6469 6e67 y the GNU coding │ │ │ │ │ +00043de0: 2073 7461 6e64 6172 6473 2c20 736f 2074 standards, so t │ │ │ │ │ +00043df0: 6861 7420 7468 6520 7573 6572 2063 616e hat the user can │ │ │ │ │ +00043e00: 2072 756e 0a27 6d61 6b65 2070 7265 6669 run.'make prefi │ │ │ │ │ +00043e10: 783d 2f66 6f6f 2069 6e73 7461 6c6c 272e x=/foo install'. │ │ │ │ │ +00043e20: 2020 5468 6520 4175 746f 636f 6e66 206d The Autoconf m │ │ │ │ │ +00043e30: 616e 7561 6c20 6861 7320 6120 7365 6374 anual has a sect │ │ │ │ │ +00043e40: 696f 6e20 7769 7468 206d 6f72 650a 6465 ion with more.de │ │ │ │ │ +00043e50: 7461 696c 7320 6f6e 2074 6869 7320 746f tails on this to │ │ │ │ │ +00043e60: 7069 6320 282a 6e6f 7465 2049 6e73 7461 pic (*note Insta │ │ │ │ │ +00043e70: 6c6c 6174 696f 6e20 4469 7265 6374 6f72 llation Director │ │ │ │ │ +00043e80: 7920 5661 7269 6162 6c65 733a 0a28 6175 y Variables:.(au │ │ │ │ │ +00043e90: 746f 636f 6e66 2949 6e73 7461 6c6c 6174 toconf)Installat │ │ │ │ │ +00043ea0: 696f 6e20 4469 7265 6374 6f72 7920 5661 ion Directory Va │ │ │ │ │ +00043eb0: 7269 6162 6c65 732e 292e 2020 5365 6520 riables.). See │ │ │ │ │ +00043ec0: 616c 736f 202a 6e6f 7465 2048 6172 642d also *note Hard- │ │ │ │ │ +00043ed0: 436f 6465 640a 496e 7374 616c 6c20 5061 Coded.Install Pa │ │ │ │ │ +00043ee0: 7468 733a 3a2e 0a0a 1f0a 4669 6c65 3a20 ths::.....File: │ │ │ │ │ +00043ef0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +00043f00: 666f 2c20 204e 6f64 653a 2044 6f63 756d fo, Node: Docum │ │ │ │ │ +00043f10: 656e 7461 7469 6f6e 2c20 204e 6578 743a entation, Next: │ │ │ │ │ +00043f20: 2049 6e73 7461 6c6c 2c20 2050 7265 763a Install, Prev: │ │ │ │ │ +00043f30: 204f 7468 6572 2047 4e55 2054 6f6f 6c73 Other GNU Tools │ │ │ │ │ +00043f40: 2c20 2055 703a 2054 6f70 0a0a 3131 2042 , Up: Top..11 B │ │ │ │ │ +00043f50: 7569 6c64 696e 6720 646f 6375 6d65 6e74 uilding document │ │ │ │ │ +00043f60: 6174 696f 6e0a 2a2a 2a2a 2a2a 2a2a 2a2a ation.********** │ │ │ │ │ +00043f70: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ +00043f80: 0a43 7572 7265 6e74 6c79 2041 7574 6f6d .Currently Autom │ │ │ │ │ +00043f90: 616b 6520 7072 6f76 6964 6573 2073 7570 ake provides sup │ │ │ │ │ +00043fa0: 706f 7274 2066 6f72 2054 6578 696e 666f port for Texinfo │ │ │ │ │ +00043fb0: 2061 6e64 206d 616e 2070 6167 6573 2e0a and man pages.. │ │ │ │ │ +00043fc0: 0a2a 204d 656e 753a 0a0a 2a20 5465 7869 .* Menu:..* Texi │ │ │ │ │ +00043fd0: 6e66 6f3a 3a20 2020 2020 2020 2020 2020 nfo:: │ │ │ │ │ +00043fe0: 2020 2020 2020 2020 2020 5465 7869 6e66 Texinf │ │ │ │ │ +00043ff0: 6f0a 2a20 4d61 6e20 5061 6765 733a 3a20 o.* Man Pages:: │ │ │ │ │ 00044000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044010: 4d61 6e20 7061 6765 730a 0a1f 0a46 696c Man pages....Fil │ │ │ │ │ -00044020: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -00044030: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5465 .info, Node: Te │ │ │ │ │ -00044040: 7869 6e66 6f2c 2020 4e65 7874 3a20 4d61 xinfo, Next: Ma │ │ │ │ │ -00044050: 6e20 5061 6765 732c 2020 5570 3a20 446f n Pages, Up: Do │ │ │ │ │ -00044060: 6375 6d65 6e74 6174 696f 6e0a 0a31 312e cumentation..11. │ │ │ │ │ -00044070: 3120 5465 7869 6e66 6f0a 3d3d 3d3d 3d3d 1 Texinfo.====== │ │ │ │ │ -00044080: 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 2063 ======..If the c │ │ │ │ │ -00044090: 7572 7265 6e74 2064 6972 6563 746f 7279 urrent directory │ │ │ │ │ -000440a0: 2063 6f6e 7461 696e 7320 5465 7869 6e66 contains Texinf │ │ │ │ │ -000440b0: 6f20 736f 7572 6365 2c20 796f 7520 6d75 o source, you mu │ │ │ │ │ -000440c0: 7374 2064 6563 6c61 7265 2069 740a 7769 st declare it.wi │ │ │ │ │ -000440d0: 7468 2074 6865 2027 5445 5849 4e46 4f53 th the 'TEXINFOS │ │ │ │ │ -000440e0: 2720 7072 696d 6172 792e 2020 4765 6e65 ' primary. Gene │ │ │ │ │ -000440f0: 7261 6c6c 7920 5465 7869 6e66 6f20 6669 rally Texinfo fi │ │ │ │ │ -00044100: 6c65 7320 6172 6520 636f 6e76 6572 7465 les are converte │ │ │ │ │ -00044110: 6420 696e 746f 0a69 6e66 6f2c 2061 6e64 d into.info, and │ │ │ │ │ -00044120: 2074 6875 7320 7468 6520 2769 6e66 6f5f thus the 'info_ │ │ │ │ │ -00044130: 5445 5849 4e46 4f53 2720 7661 7269 6162 TEXINFOS' variab │ │ │ │ │ -00044140: 6c65 2069 7320 6d6f 7374 2063 6f6d 6d6f le is most commo │ │ │ │ │ -00044150: 6e6c 7920 7573 6564 2068 6572 652e 0a41 nly used here..A │ │ │ │ │ -00044160: 6e79 2054 6578 696e 666f 2073 6f75 7263 ny Texinfo sourc │ │ │ │ │ -00044170: 6520 6669 6c65 206d 7573 7420 656e 6420 e file must end │ │ │ │ │ -00044180: 696e 2074 6865 2027 2e74 6578 6927 2c20 in the '.texi', │ │ │ │ │ -00044190: 272e 7478 6927 2c20 6f72 2027 2e74 6578 '.txi', or '.tex │ │ │ │ │ -000441a0: 696e 666f 270a 6578 7465 6e73 696f 6e2e info'.extension. │ │ │ │ │ -000441b0: 2020 5765 2072 6563 6f6d 6d65 6e64 2027 We recommend ' │ │ │ │ │ -000441c0: 2e74 6578 6927 2066 6f72 206e 6577 206d .texi' for new m │ │ │ │ │ -000441d0: 616e 7561 6c73 2e0a 0a20 2020 4175 746f anuals... Auto │ │ │ │ │ -000441e0: 6d61 6b65 2067 656e 6572 6174 6573 2072 make generates r │ │ │ │ │ -000441f0: 756c 6573 2074 6f20 6275 696c 6420 272e ules to build '. │ │ │ │ │ -00044200: 696e 666f 272c 2027 2e64 7669 272c 2027 info', '.dvi', ' │ │ │ │ │ -00044210: 2e70 7327 2c20 272e 7064 6627 2061 6e64 .ps', '.pdf' and │ │ │ │ │ -00044220: 0a27 2e68 746d 6c27 2066 696c 6573 2066 .'.html' files f │ │ │ │ │ -00044230: 726f 6d20 796f 7572 2054 6578 696e 666f rom your Texinfo │ │ │ │ │ -00044240: 2073 6f75 7263 6573 2e20 2046 6f6c 6c6f sources. Follo │ │ │ │ │ -00044250: 7769 6e67 2074 6865 2047 4e55 2043 6f64 wing the GNU Cod │ │ │ │ │ -00044260: 696e 670a 5374 616e 6461 7264 732c 206f ing.Standards, o │ │ │ │ │ -00044270: 6e6c 7920 7468 6520 272e 696e 666f 2720 nly the '.info' │ │ │ │ │ -00044280: 6669 6c65 7320 6172 6520 6275 696c 7420 files are built │ │ │ │ │ -00044290: 6279 2027 6d61 6b65 2061 6c6c 2720 616e by 'make all' an │ │ │ │ │ -000442a0: 6420 696e 7374 616c 6c65 640a 6279 2027 d installed.by ' │ │ │ │ │ -000442b0: 6d61 6b65 2069 6e73 7461 6c6c 2720 2875 make install' (u │ │ │ │ │ -000442c0: 6e6c 6573 7320 796f 7520 7573 6520 276e nless you use 'n │ │ │ │ │ -000442d0: 6f2d 696e 7374 616c 6c69 6e66 6f27 2c20 o-installinfo', │ │ │ │ │ -000442e0: 7365 6520 6265 6c6f 7729 2e0a 4675 7274 see below)..Furt │ │ │ │ │ -000442f0: 6865 726d 6f72 652c 2027 2e69 6e66 6f27 hermore, '.info' │ │ │ │ │ -00044300: 2066 696c 6573 2061 7265 2061 7574 6f6d files are autom │ │ │ │ │ -00044310: 6174 6963 616c 6c79 2064 6973 7472 6962 atically distrib │ │ │ │ │ -00044320: 7574 6564 2073 6f20 7468 6174 2054 6578 uted so that Tex │ │ │ │ │ -00044330: 696e 666f 0a69 7320 6e6f 7420 6120 7072 info.is not a pr │ │ │ │ │ -00044340: 6572 6571 7569 7369 7465 2066 6f72 2069 erequisite for i │ │ │ │ │ -00044350: 6e73 7461 6c6c 696e 6720 796f 7572 2070 nstalling your p │ │ │ │ │ -00044360: 6163 6b61 6765 2e0a 0a20 2020 4f74 6865 ackage... Othe │ │ │ │ │ -00044370: 7220 646f 6375 6d65 6e74 6174 696f 6e20 r documentation │ │ │ │ │ -00044380: 666f 726d 6174 7320 6361 6e20 6265 2062 formats can be b │ │ │ │ │ -00044390: 7569 6c74 206f 6e20 7265 7175 6573 7420 uilt on request │ │ │ │ │ -000443a0: 6279 2027 6d61 6b65 2064 7669 272c 0a27 by 'make dvi',.' │ │ │ │ │ -000443b0: 6d61 6b65 2070 7327 2c20 276d 616b 6520 make ps', 'make │ │ │ │ │ -000443c0: 7064 6627 2061 6e64 2027 6d61 6b65 2068 pdf' and 'make h │ │ │ │ │ -000443d0: 746d 6c27 2c20 616e 6420 7468 6579 2063 tml', and they c │ │ │ │ │ -000443e0: 616e 2062 6520 696e 7374 616c 6c65 6420 an be installed │ │ │ │ │ -000443f0: 7769 7468 0a27 6d61 6b65 2069 6e73 7461 with.'make insta │ │ │ │ │ -00044400: 6c6c 2d64 7669 272c 2027 6d61 6b65 2069 ll-dvi', 'make i │ │ │ │ │ -00044410: 6e73 7461 6c6c 2d70 7327 2c20 276d 616b nstall-ps', 'mak │ │ │ │ │ -00044420: 6520 696e 7374 616c 6c2d 7064 6627 2061 e install-pdf' a │ │ │ │ │ -00044430: 6e64 2027 6d61 6b65 0a69 6e73 7461 6c6c nd 'make.install │ │ │ │ │ -00044440: 2d68 746d 6c27 2065 7870 6c69 6369 746c -html' explicitl │ │ │ │ │ -00044450: 792e 2020 276d 616b 6520 756e 696e 7374 y. 'make uninst │ │ │ │ │ -00044460: 616c 6c27 2077 696c 6c20 7265 6d6f 7665 all' will remove │ │ │ │ │ -00044470: 2065 7665 7279 7468 696e 673a 2074 6865 everything: the │ │ │ │ │ -00044480: 0a54 6578 696e 666f 2064 6f63 756d 656e .Texinfo documen │ │ │ │ │ -00044490: 7461 7469 6f6e 2069 6e73 7461 6c6c 6564 tation installed │ │ │ │ │ -000444a0: 2062 7920 6465 6661 756c 7420 6173 2077 by default as w │ │ │ │ │ -000444b0: 656c 6c20 6173 2061 6c6c 2074 6865 2061 ell as all the a │ │ │ │ │ -000444c0: 626f 7665 0a6f 7074 696f 6e61 6c20 666f bove.optional fo │ │ │ │ │ -000444d0: 726d 6174 732e 0a0a 2020 2041 6c6c 2074 rmats... All t │ │ │ │ │ -000444e0: 6865 7365 2074 6172 6765 7473 2063 616e hese targets can │ │ │ │ │ -000444f0: 2062 6520 6578 7465 6e64 6564 2075 7369 be extended usi │ │ │ │ │ -00044500: 6e67 2027 2d6c 6f63 616c 2720 7275 6c65 ng '-local' rule │ │ │ │ │ -00044510: 7320 282a 6e6f 7465 0a45 7874 656e 6469 s (*note.Extendi │ │ │ │ │ -00044520: 6e67 3a3a 292e 0a0a 2020 2049 6620 7468 ng::)... If th │ │ │ │ │ -00044530: 6520 272e 7465 7869 2720 6669 6c65 2027 e '.texi' file ' │ │ │ │ │ -00044540: 4069 6e63 6c75 6465 2773 2027 7665 7273 @include's 'vers │ │ │ │ │ -00044550: 696f 6e2e 7465 7869 272c 2074 6865 6e20 ion.texi', then │ │ │ │ │ -00044560: 7468 6174 2066 696c 6520 7769 6c6c 0a62 that file will.b │ │ │ │ │ -00044570: 6520 6175 746f 6d61 7469 6361 6c6c 7920 e automatically │ │ │ │ │ -00044580: 6765 6e65 7261 7465 642e 2020 5468 6520 generated. The │ │ │ │ │ -00044590: 6669 6c65 2027 7665 7273 696f 6e2e 7465 file 'version.te │ │ │ │ │ -000445a0: 7869 2720 6465 6669 6e65 7320 666f 7572 xi' defines four │ │ │ │ │ -000445b0: 0a54 6578 696e 666f 2066 6c61 6720 796f .Texinfo flag yo │ │ │ │ │ -000445c0: 7520 6361 6e20 7265 6665 7265 6e63 6520 u can reference │ │ │ │ │ -000445d0: 7573 696e 6720 2740 7661 6c75 657b 4544 using '@value{ED │ │ │ │ │ -000445e0: 4954 494f 4e7d 272c 0a27 4076 616c 7565 ITION}',.'@value │ │ │ │ │ -000445f0: 7b56 4552 5349 4f4e 7d27 2c20 2740 7661 {VERSION}', '@va │ │ │ │ │ -00044600: 6c75 657b 5550 4441 5445 447d 272c 2061 lue{UPDATED}', a │ │ │ │ │ -00044610: 6e64 2027 4076 616c 7565 7b55 5044 4154 nd '@value{UPDAT │ │ │ │ │ -00044620: 4544 2d4d 4f4e 5448 7d27 2e0a 0a27 4544 ED-MONTH}'...'ED │ │ │ │ │ -00044630: 4954 494f 4e27 0a27 5645 5253 494f 4e27 ITION'.'VERSION' │ │ │ │ │ -00044640: 0a20 2020 2020 426f 7468 206f 6620 7468 . Both of th │ │ │ │ │ -00044650: 6573 6520 666c 6167 7320 686f 6c64 2074 ese flags hold t │ │ │ │ │ -00044660: 6865 2076 6572 7369 6f6e 206e 756d 6265 he version numbe │ │ │ │ │ -00044670: 7220 6f66 2079 6f75 7220 7072 6f67 7261 r of your progra │ │ │ │ │ -00044680: 6d2e 2020 5468 6579 0a20 2020 2020 6172 m. They. ar │ │ │ │ │ -00044690: 6520 6b65 7074 2073 6570 6172 6174 6520 e kept separate │ │ │ │ │ -000446a0: 666f 7220 636c 6172 6974 792e 0a0a 2755 for clarity...'U │ │ │ │ │ -000446b0: 5044 4154 4544 270a 2020 2020 2054 6869 PDATED'. Thi │ │ │ │ │ -000446c0: 7320 686f 6c64 7320 7468 6520 6461 7465 s holds the date │ │ │ │ │ -000446d0: 2074 6865 2070 7269 6d61 7279 2027 2e74 the primary '.t │ │ │ │ │ -000446e0: 6578 6927 2066 696c 6520 7761 7320 6c61 exi' file was la │ │ │ │ │ -000446f0: 7374 206d 6f64 6966 6965 642e 0a0a 2755 st modified...'U │ │ │ │ │ -00044700: 5044 4154 4544 2d4d 4f4e 5448 270a 2020 PDATED-MONTH'. │ │ │ │ │ -00044710: 2020 2054 6869 7320 686f 6c64 7320 7468 This holds th │ │ │ │ │ -00044720: 6520 6e61 6d65 206f 6620 7468 6520 6d6f e name of the mo │ │ │ │ │ -00044730: 6e74 6820 696e 2077 6869 6368 2074 6865 nth in which the │ │ │ │ │ -00044740: 2070 7269 6d61 7279 2027 2e74 6578 6927 primary '.texi' │ │ │ │ │ -00044750: 2066 696c 650a 2020 2020 2077 6173 206c file. was l │ │ │ │ │ -00044760: 6173 7420 6d6f 6469 6669 6564 2e0a 0a20 ast modified... │ │ │ │ │ -00044770: 2020 5468 6520 2776 6572 7369 6f6e 2e74 The 'version.t │ │ │ │ │ -00044780: 6578 6927 2073 7570 706f 7274 2072 6571 exi' support req │ │ │ │ │ -00044790: 7569 7265 7320 7468 6520 276d 6461 7465 uires the 'mdate │ │ │ │ │ -000447a0: 2d73 6827 2073 6372 6970 743b 2074 6869 -sh' script; thi │ │ │ │ │ -000447b0: 730a 7363 7269 7074 2069 7320 7375 7070 s.script is supp │ │ │ │ │ -000447c0: 6c69 6564 2077 6974 6820 4175 746f 6d61 lied with Automa │ │ │ │ │ -000447d0: 6b65 2061 6e64 2061 7574 6f6d 6174 6963 ke and automatic │ │ │ │ │ -000447e0: 616c 6c79 2069 6e63 6c75 6465 6420 7768 ally included wh │ │ │ │ │ -000447f0: 656e 0a27 6175 746f 6d61 6b65 2720 6973 en.'automake' is │ │ │ │ │ -00044800: 2069 6e76 6f6b 6564 2077 6974 6820 7468 invoked with th │ │ │ │ │ -00044810: 6520 272d 2d61 6464 2d6d 6973 7369 6e67 e '--add-missing │ │ │ │ │ -00044820: 2720 6f70 7469 6f6e 2e0a 0a20 2020 4966 ' option... If │ │ │ │ │ -00044830: 2079 6f75 2068 6176 6520 6d75 6c74 6970 you have multip │ │ │ │ │ -00044840: 6c65 2054 6578 696e 666f 2066 696c 6573 le Texinfo files │ │ │ │ │ -00044850: 2c20 616e 6420 796f 7520 7761 6e74 2074 , and you want t │ │ │ │ │ -00044860: 6f20 7573 6520 7468 650a 2776 6572 7369 o use the.'versi │ │ │ │ │ -00044870: 6f6e 2e74 6578 6927 2066 6561 7475 7265 on.texi' feature │ │ │ │ │ -00044880: 2c20 7468 656e 2079 6f75 2068 6176 6520 , then you have │ │ │ │ │ -00044890: 746f 2068 6176 6520 6120 7365 7061 7261 to have a separa │ │ │ │ │ -000448a0: 7465 2076 6572 7369 6f6e 2066 696c 650a te version file. │ │ │ │ │ -000448b0: 666f 7220 6561 6368 2054 6578 696e 666f for each Texinfo │ │ │ │ │ -000448c0: 2066 696c 652e 2020 4175 746f 6d61 6b65 file. Automake │ │ │ │ │ -000448d0: 2077 696c 6c20 7472 6561 7420 616e 7920 will treat any │ │ │ │ │ -000448e0: 696e 636c 7564 6520 696e 2061 2054 6578 include in a Tex │ │ │ │ │ -000448f0: 696e 666f 0a66 696c 6520 7468 6174 206d info.file that m │ │ │ │ │ -00044900: 6174 6368 6573 2027 7665 7273 2a2e 7465 atches 'vers*.te │ │ │ │ │ -00044910: 7869 2720 6a75 7374 2061 7320 616e 2061 xi' just as an a │ │ │ │ │ -00044920: 7574 6f6d 6174 6963 616c 6c79 2067 656e utomatically gen │ │ │ │ │ -00044930: 6572 6174 6564 0a76 6572 7369 6f6e 2066 erated.version f │ │ │ │ │ -00044940: 696c 652e 0a0a 2020 2053 6f6d 6574 696d ile... Sometim │ │ │ │ │ -00044950: 6573 2061 6e20 696e 666f 2066 696c 6520 es an info file │ │ │ │ │ -00044960: 6163 7475 616c 6c79 2064 6570 656e 6473 actually depends │ │ │ │ │ -00044970: 206f 6e20 6d6f 7265 2074 6861 6e20 6f6e on more than on │ │ │ │ │ -00044980: 6520 272e 7465 7869 270a 6669 6c65 2e20 e '.texi'.file. │ │ │ │ │ -00044990: 2046 6f72 2069 6e73 7461 6e63 652c 2069 For instance, i │ │ │ │ │ -000449a0: 6e20 474e 5520 4865 6c6c 6f2c 2027 6865 n GNU Hello, 'he │ │ │ │ │ -000449b0: 6c6c 6f2e 7465 7869 2720 696e 636c 7564 llo.texi' includ │ │ │ │ │ -000449c0: 6573 2074 6865 2066 696c 650a 2766 646c es the file.'fdl │ │ │ │ │ -000449d0: 2e74 6578 6927 2e20 2059 6f75 2063 616e .texi'. You can │ │ │ │ │ -000449e0: 2074 656c 6c20 4175 746f 6d61 6b65 2061 tell Automake a │ │ │ │ │ -000449f0: 626f 7574 2074 6865 7365 2064 6570 656e bout these depen │ │ │ │ │ -00044a00: 6465 6e63 6965 7320 7573 696e 6720 7468 dencies using th │ │ │ │ │ -00044a10: 650a 2754 4558 495f 5445 5849 4e46 4f53 e.'TEXI_TEXINFOS │ │ │ │ │ -00044a20: 2720 7661 7269 6162 6c65 2e20 2048 6572 ' variable. Her │ │ │ │ │ -00044a30: 6520 6973 2068 6f77 2047 4e55 2048 656c e is how GNU Hel │ │ │ │ │ -00044a40: 6c6f 2064 6f65 7320 6974 3a0a 0a20 2020 lo does it:.. │ │ │ │ │ -00044a50: 2020 696e 666f 5f54 4558 494e 464f 5320 info_TEXINFOS │ │ │ │ │ -00044a60: 3d20 6865 6c6c 6f2e 7465 7869 0a20 2020 = hello.texi. │ │ │ │ │ -00044a70: 2020 6865 6c6c 6f5f 5445 5849 4e46 4f53 hello_TEXINFOS │ │ │ │ │ -00044a80: 203d 2066 646c 2e74 6578 690a 0a20 2020 = fdl.texi.. │ │ │ │ │ -00044a90: 4279 2064 6566 6175 6c74 2c20 4175 746f By default, Auto │ │ │ │ │ -00044aa0: 6d61 6b65 2072 6571 7569 7265 7320 7468 make requires th │ │ │ │ │ -00044ab0: 6520 6669 6c65 2027 7465 7869 6e66 6f2e e file 'texinfo. │ │ │ │ │ -00044ac0: 7465 7827 2074 6f20 6170 7065 6172 2069 tex' to appear i │ │ │ │ │ -00044ad0: 6e20 7468 650a 7361 6d65 2064 6972 6563 n the.same direc │ │ │ │ │ -00044ae0: 746f 7279 2061 7320 7468 6520 274d 616b tory as the 'Mak │ │ │ │ │ -00044af0: 6566 696c 652e 616d 2720 6669 6c65 2074 efile.am' file t │ │ │ │ │ -00044b00: 6861 7420 6c69 7374 7320 7468 6520 272e hat lists the '. │ │ │ │ │ -00044b10: 7465 7869 2720 6669 6c65 732e 0a49 6620 texi' files..If │ │ │ │ │ -00044b20: 796f 7520 7573 6564 2027 4143 5f43 4f4e you used 'AC_CON │ │ │ │ │ -00044b30: 4649 475f 4155 585f 4449 5227 2069 6e20 FIG_AUX_DIR' in │ │ │ │ │ -00044b40: 2763 6f6e 6669 6775 7265 2e61 6327 2028 'configure.ac' ( │ │ │ │ │ -00044b50: 2a6e 6f74 6520 4669 6e64 696e 670a 2763 *note Finding.'c │ │ │ │ │ -00044b60: 6f6e 6669 6775 7265 2720 496e 7075 743a onfigure' Input: │ │ │ │ │ -00044b70: 2028 6175 746f 636f 6e66 2949 6e70 7574 (autoconf)Input │ │ │ │ │ -00044b80: 2e29 2c20 7468 656e 2027 7465 7869 6e66 .), then 'texinf │ │ │ │ │ -00044b90: 6f2e 7465 7827 2069 7320 6c6f 6f6b 6564 o.tex' is looked │ │ │ │ │ -00044ba0: 2066 6f72 0a74 6865 7265 2e20 2049 6e20 for.there. In │ │ │ │ │ -00044bb0: 626f 7468 2063 6173 6573 2c20 2761 7574 both cases, 'aut │ │ │ │ │ -00044bc0: 6f6d 616b 6527 2074 6865 6e20 7375 7070 omake' then supp │ │ │ │ │ -00044bd0: 6c69 6573 2027 7465 7869 6e66 6f2e 7465 lies 'texinfo.te │ │ │ │ │ -00044be0: 7827 2069 660a 272d 2d61 6464 2d6d 6973 x' if.'--add-mis │ │ │ │ │ -00044bf0: 7369 6e67 2720 6973 2067 6976 656e 2c20 sing' is given, │ │ │ │ │ -00044c00: 616e 6420 7461 6b65 7320 6361 7265 206f and takes care o │ │ │ │ │ -00044c10: 6620 6974 7320 6469 7374 7269 6275 7469 f its distributi │ │ │ │ │ -00044c20: 6f6e 2e20 2048 6f77 6576 6572 2c0a 6966 on. However,.if │ │ │ │ │ -00044c30: 2079 6f75 2073 6574 2074 6865 2027 5445 you set the 'TE │ │ │ │ │ -00044c40: 5849 4e46 4f5f 5445 5827 2076 6172 6961 XINFO_TEX' varia │ │ │ │ │ -00044c50: 626c 6520 2873 6565 2062 656c 6f77 292c ble (see below), │ │ │ │ │ -00044c60: 2069 7420 6f76 6572 7269 6465 7320 7468 it overrides th │ │ │ │ │ -00044c70: 650a 6c6f 6361 7469 6f6e 206f 6620 7468 e.location of th │ │ │ │ │ -00044c80: 6520 6669 6c65 2061 6e64 2074 7572 6e73 e file and turns │ │ │ │ │ -00044c90: 206f 6666 2069 7473 2069 6e73 7461 6c6c off its install │ │ │ │ │ -00044ca0: 6174 696f 6e20 696e 746f 2074 6865 2073 ation into the s │ │ │ │ │ -00044cb0: 6f75 7263 6520 6173 0a77 656c 6c20 6173 ource as.well as │ │ │ │ │ -00044cc0: 2069 7473 2064 6973 7472 6962 7574 696f its distributio │ │ │ │ │ -00044cd0: 6e2e 0a0a 2020 2054 6865 206f 7074 696f n... The optio │ │ │ │ │ -00044ce0: 6e20 276e 6f2d 7465 7869 6e66 6f2e 7465 n 'no-texinfo.te │ │ │ │ │ -00044cf0: 7827 2063 616e 2062 6520 7573 6564 2074 x' can be used t │ │ │ │ │ -00044d00: 6f20 656c 696d 696e 6174 6520 7468 6520 o eliminate the │ │ │ │ │ -00044d10: 7265 7175 6972 656d 656e 740a 666f 7220 requirement.for │ │ │ │ │ -00044d20: 7468 6520 6669 6c65 2027 7465 7869 6e66 the file 'texinf │ │ │ │ │ -00044d30: 6f2e 7465 7827 2e20 2055 7365 206f 6620 o.tex'. Use of │ │ │ │ │ -00044d40: 7468 6520 7661 7269 6162 6c65 2027 5445 the variable 'TE │ │ │ │ │ -00044d50: 5849 4e46 4f5f 5445 5827 2069 730a 7072 XINFO_TEX' is.pr │ │ │ │ │ -00044d60: 6566 6572 6162 6c65 2c20 686f 7765 7665 eferable, howeve │ │ │ │ │ -00044d70: 722c 2062 6563 6175 7365 2074 6861 7420 r, because that │ │ │ │ │ -00044d80: 616c 6c6f 7773 2074 6865 2027 6476 6927 allows the 'dvi' │ │ │ │ │ -00044d90: 2c20 2770 7327 2c20 616e 6420 2770 6466 , 'ps', and 'pdf │ │ │ │ │ -00044da0: 270a 7461 7267 6574 7320 746f 2073 7469 '.targets to sti │ │ │ │ │ -00044db0: 6c6c 2077 6f72 6b2e 0a0a 2020 2041 7574 ll work... Aut │ │ │ │ │ -00044dc0: 6f6d 616b 6520 6765 6e65 7261 7465 7320 omake generates │ │ │ │ │ -00044dd0: 616e 2027 696e 7374 616c 6c2d 696e 666f an 'install-info │ │ │ │ │ -00044de0: 2720 7275 6c65 3b20 736f 6d65 2070 656f ' rule; some peo │ │ │ │ │ -00044df0: 706c 6520 6170 7061 7265 6e74 6c79 2075 ple apparently u │ │ │ │ │ -00044e00: 7365 0a74 6869 732e 2020 4279 2064 6566 se.this. By def │ │ │ │ │ -00044e10: 6175 6c74 2c20 696e 666f 2070 6167 6573 ault, info pages │ │ │ │ │ -00044e20: 2061 7265 2069 6e73 7461 6c6c 6564 2062 are installed b │ │ │ │ │ -00044e30: 7920 276d 616b 6520 696e 7374 616c 6c27 y 'make install' │ │ │ │ │ -00044e40: 2c20 736f 0a72 756e 6e69 6e67 2027 6d61 , so.running 'ma │ │ │ │ │ -00044e50: 6b65 2069 6e73 7461 6c6c 2d69 6e66 6f27 ke install-info' │ │ │ │ │ -00044e60: 2069 7320 706f 696e 746c 6573 732e 2020 is pointless. │ │ │ │ │ -00044e70: 5468 6973 2063 616e 2062 6520 7072 6576 This can be prev │ │ │ │ │ -00044e80: 656e 7465 6420 7669 6120 7468 650a 276e ented via the.'n │ │ │ │ │ -00044e90: 6f2d 696e 7374 616c 6c69 6e66 6f27 206f o-installinfo' o │ │ │ │ │ -00044ea0: 7074 696f 6e2e 2020 496e 2074 6869 7320 ption. In this │ │ │ │ │ -00044eb0: 6361 7365 2c20 272e 696e 666f 2720 6669 case, '.info' fi │ │ │ │ │ -00044ec0: 6c65 7320 6172 6520 6e6f 7420 696e 7374 les are not inst │ │ │ │ │ -00044ed0: 616c 6c65 640a 6279 2064 6566 6175 6c74 alled.by default │ │ │ │ │ -00044ee0: 2c20 616e 6420 7573 6572 206d 7573 7420 , and user must │ │ │ │ │ -00044ef0: 7265 7175 6573 7420 7468 6973 2065 7870 request this exp │ │ │ │ │ -00044f00: 6c69 6369 746c 7920 7573 696e 6720 276d licitly using 'm │ │ │ │ │ -00044f10: 616b 650a 696e 7374 616c 6c2d 696e 666f ake.install-info │ │ │ │ │ -00044f20: 272e 0a0a 2020 2042 7920 6465 6661 756c '... By defaul │ │ │ │ │ -00044f30: 742c 2027 6d61 6b65 2069 6e73 7461 6c6c t, 'make install │ │ │ │ │ -00044f40: 2d69 6e66 6f27 2061 6e64 2027 6d61 6b65 -info' and 'make │ │ │ │ │ -00044f50: 2069 6e73 7461 6c6c 2d69 6e66 6f27 2077 install-info' w │ │ │ │ │ -00044f60: 696c 6c20 7472 7920 746f 0a72 756e 2074 ill try to.run t │ │ │ │ │ -00044f70: 6865 2027 696e 7374 616c 6c2d 696e 666f he 'install-info │ │ │ │ │ -00044f80: 2720 7072 6f67 7261 6d20 2869 6620 6176 ' program (if av │ │ │ │ │ -00044f90: 6169 6c61 626c 6529 2074 6f20 7570 6461 ailable) to upda │ │ │ │ │ -00044fa0: 7465 2028 6f72 2063 7265 6174 6529 2074 te (or create) t │ │ │ │ │ -00044fb0: 6865 0a27 247b 696e 666f 6469 727d 2f64 he.'${infodir}/d │ │ │ │ │ -00044fc0: 6972 2720 696e 6465 782e 2020 4966 2074 ir' index. If t │ │ │ │ │ -00044fd0: 6869 7320 6973 2075 6e64 6573 6972 6564 his is undesired │ │ │ │ │ -00044fe0: 2c20 6974 2063 616e 2062 6520 7072 6576 , it can be prev │ │ │ │ │ -00044ff0: 656e 7465 6420 6279 0a65 7870 6f72 7469 ented by.exporti │ │ │ │ │ -00045000: 6e67 2074 6865 2027 414d 5f55 5044 4154 ng the 'AM_UPDAT │ │ │ │ │ -00045010: 455f 494e 464f 5f44 4952 2720 7661 7269 E_INFO_DIR' vari │ │ │ │ │ -00045020: 6162 6c65 2074 6f20 2227 6e6f 2722 2e0a able to "'no'".. │ │ │ │ │ -00045030: 0a20 2020 5468 6520 666f 6c6c 6f77 696e . The followin │ │ │ │ │ -00045040: 6720 7661 7269 6162 6c65 7320 6172 6520 g variables are │ │ │ │ │ -00045050: 7573 6564 2062 7920 7468 6520 5465 7869 used by the Texi │ │ │ │ │ -00045060: 6e66 6f20 6275 696c 6420 7275 6c65 732e nfo build rules. │ │ │ │ │ -00045070: 0a0a 274d 414b 4549 4e46 4f27 0a20 2020 ..'MAKEINFO'. │ │ │ │ │ -00045080: 2020 5468 6520 6e61 6d65 206f 6620 7468 The name of th │ │ │ │ │ -00045090: 6520 7072 6f67 7261 6d20 696e 766f 6b65 e program invoke │ │ │ │ │ -000450a0: 6420 746f 2062 7569 6c64 2027 2e69 6e66 d to build '.inf │ │ │ │ │ -000450b0: 6f27 2066 696c 6573 2e20 2054 6869 730a o' files. This. │ │ │ │ │ -000450c0: 2020 2020 2076 6172 6961 626c 6520 6973 variable is │ │ │ │ │ -000450d0: 2064 6566 696e 6564 2062 7920 4175 746f defined by Auto │ │ │ │ │ -000450e0: 6d61 6b65 2e20 2049 6620 7468 6520 276d make. If the 'm │ │ │ │ │ -000450f0: 616b 6569 6e66 6f27 2070 726f 6772 616d akeinfo' program │ │ │ │ │ -00045100: 2069 730a 2020 2020 2066 6f75 6e64 206f is. found o │ │ │ │ │ -00045110: 6e20 7468 6520 7379 7374 656d 2074 6865 n the system the │ │ │ │ │ -00045120: 6e20 6974 2077 696c 6c20 6265 2075 7365 n it will be use │ │ │ │ │ -00045130: 6420 6279 2064 6566 6175 6c74 3b20 6f74 d by default; ot │ │ │ │ │ -00045140: 6865 7277 6973 650a 2020 2020 2027 6d69 herwise. 'mi │ │ │ │ │ -00045150: 7373 696e 6727 2077 696c 6c20 6265 2075 ssing' will be u │ │ │ │ │ -00045160: 7365 6420 696e 7374 6561 642e 0a0a 274d sed instead...'M │ │ │ │ │ -00045170: 414b 4549 4e46 4f48 544d 4c27 0a20 2020 AKEINFOHTML'. │ │ │ │ │ -00045180: 2020 5468 6520 636f 6d6d 616e 6420 696e The command in │ │ │ │ │ -00045190: 766f 6b65 6420 746f 2062 7569 6c64 2027 voked to build ' │ │ │ │ │ -000451a0: 2e68 746d 6c27 2066 696c 6573 2e20 2041 .html' files. A │ │ │ │ │ -000451b0: 7574 6f6d 616b 6520 6465 6669 6e65 7320 utomake defines │ │ │ │ │ -000451c0: 7468 6973 0a20 2020 2020 746f 2027 2428 this. to '$( │ │ │ │ │ -000451d0: 4d41 4b45 494e 464f 2920 2d2d 6874 6d6c MAKEINFO) --html │ │ │ │ │ -000451e0: 272e 0a0a 274d 414b 4549 4e46 4f46 4c41 '...'MAKEINFOFLA │ │ │ │ │ -000451f0: 4753 270a 2020 2020 2055 7365 7220 666c GS'. User fl │ │ │ │ │ -00045200: 6167 7320 7061 7373 6564 2074 6f20 6561 ags passed to ea │ │ │ │ │ -00045210: 6368 2069 6e76 6f63 6174 696f 6e20 6f66 ch invocation of │ │ │ │ │ -00045220: 2027 2428 4d41 4b45 494e 464f 2927 2061 '$(MAKEINFO)' a │ │ │ │ │ -00045230: 6e64 0a20 2020 2020 2724 284d 414b 4549 nd. '$(MAKEI │ │ │ │ │ -00045240: 4e46 4f48 544d 4c29 272e 2020 5468 6973 NFOHTML)'. This │ │ │ │ │ -00045250: 2075 7365 7220 7661 7269 6162 6c65 2028 user variable ( │ │ │ │ │ -00045260: 2a6e 6f74 6520 5573 6572 2056 6172 6961 *note User Varia │ │ │ │ │ -00045270: 626c 6573 3a3a 2920 6973 0a20 2020 2020 bles::) is. │ │ │ │ │ -00045280: 6e6f 7420 6578 7065 6374 6564 2074 6f20 not expected to │ │ │ │ │ -00045290: 6265 2064 6566 696e 6564 2069 6e20 616e be defined in an │ │ │ │ │ -000452a0: 7920 274d 616b 6566 696c 6527 3b20 6974 y 'Makefile'; it │ │ │ │ │ -000452b0: 2063 616e 2062 6520 7573 6564 2062 790a can be used by. │ │ │ │ │ -000452c0: 2020 2020 2075 7365 7273 2074 6f20 7061 users to pa │ │ │ │ │ -000452d0: 7373 2065 7874 7261 2066 6c61 6773 2074 ss extra flags t │ │ │ │ │ -000452e0: 6f20 7375 6974 2074 6865 6972 206e 6565 o suit their nee │ │ │ │ │ -000452f0: 6473 2e0a 0a27 414d 5f4d 414b 4549 4e46 ds...'AM_MAKEINF │ │ │ │ │ -00045300: 4f46 4c41 4753 270a 2741 4d5f 4d41 4b45 OFLAGS'.'AM_MAKE │ │ │ │ │ -00045310: 494e 464f 4854 4d4c 464c 4147 5327 0a20 INFOHTMLFLAGS'. │ │ │ │ │ -00045320: 2020 2020 4d61 696e 7461 696e 6572 2066 Maintainer f │ │ │ │ │ -00045330: 6c61 6773 2070 6173 7365 6420 746f 2065 lags passed to e │ │ │ │ │ -00045340: 6163 6820 276d 616b 6569 6e66 6f27 2069 ach 'makeinfo' i │ │ │ │ │ -00045350: 6e76 6f63 6174 696f 6e2e 2020 556e 6c69 nvocation. Unli │ │ │ │ │ -00045360: 6b65 0a20 2020 2020 274d 414b 4549 4e46 ke. 'MAKEINF │ │ │ │ │ -00045370: 4f46 4c41 4753 272c 2074 6865 7365 2076 OFLAGS', these v │ │ │ │ │ -00045380: 6172 6961 626c 6573 2061 7265 206d 6561 ariables are mea │ │ │ │ │ -00045390: 6e74 2074 6f20 6265 2064 6566 696e 6564 nt to be defined │ │ │ │ │ -000453a0: 2062 790a 2020 2020 206d 6169 6e74 6169 by. maintai │ │ │ │ │ -000453b0: 6e65 7273 2069 6e20 274d 616b 6566 696c ners in 'Makefil │ │ │ │ │ -000453c0: 652e 616d 272e 2020 2724 2841 4d5f 4d41 e.am'. '$(AM_MA │ │ │ │ │ -000453d0: 4b45 494e 464f 464c 4147 5329 2720 6973 KEINFOFLAGS)' is │ │ │ │ │ -000453e0: 2070 6173 7365 6420 746f 0a20 2020 2020 passed to. │ │ │ │ │ -000453f0: 276d 616b 6569 6e66 6f27 2077 6865 6e20 'makeinfo' when │ │ │ │ │ -00045400: 6275 696c 6469 6e67 2027 2e69 6e66 6f27 building '.info' │ │ │ │ │ -00045410: 2066 696c 6573 3b20 616e 640a 2020 2020 files; and. │ │ │ │ │ -00045420: 2027 2428 414d 5f4d 414b 4549 4e46 4f48 '$(AM_MAKEINFOH │ │ │ │ │ -00045430: 544d 4c46 4c41 4753 2927 2069 7320 7573 TMLFLAGS)' is us │ │ │ │ │ -00045440: 6564 2077 6865 6e20 6275 696c 6469 6e67 ed when building │ │ │ │ │ -00045450: 2027 2e68 746d 6c27 2066 696c 6573 2e0a '.html' files.. │ │ │ │ │ -00045460: 0a20 2020 2020 466f 7220 696e 7374 616e . For instan │ │ │ │ │ -00045470: 6365 2c20 7468 6520 666f 6c6c 6f77 696e ce, the followin │ │ │ │ │ -00045480: 6720 7365 7474 696e 6720 6361 6e20 6265 g setting can be │ │ │ │ │ -00045490: 2075 7365 6420 746f 206f 6274 6169 6e20 used to obtain │ │ │ │ │ -000454a0: 6f6e 650a 2020 2020 2073 696e 676c 6520 one. single │ │ │ │ │ -000454b0: 272e 6874 6d6c 2720 6669 6c65 2070 6572 '.html' file per │ │ │ │ │ -000454c0: 206d 616e 7561 6c2c 2077 6974 686f 7574 manual, without │ │ │ │ │ -000454d0: 206e 6f64 6520 7365 7061 7261 746f 7273 node separators │ │ │ │ │ -000454e0: 2e0a 2020 2020 2020 2020 2020 414d 5f4d .. AM_M │ │ │ │ │ -000454f0: 414b 4549 4e46 4f48 544d 4c46 4c41 4753 AKEINFOHTMLFLAGS │ │ │ │ │ -00045500: 203d 202d 2d6e 6f2d 6865 6164 6572 7320 = --no-headers │ │ │ │ │ -00045510: 2d2d 6e6f 2d73 706c 6974 0a0a 2020 2020 --no-split.. │ │ │ │ │ -00045520: 2027 414d 5f4d 414b 4549 4e46 4f48 544d 'AM_MAKEINFOHTM │ │ │ │ │ -00045530: 4c46 4c41 4753 2720 6465 6661 756c 7473 LFLAGS' defaults │ │ │ │ │ -00045540: 2074 6f20 2724 2841 4d5f 4d41 4b45 494e to '$(AM_MAKEIN │ │ │ │ │ -00045550: 464f 464c 4147 5329 272e 2020 5468 6973 FOFLAGS)'. This │ │ │ │ │ -00045560: 0a20 2020 2020 6d65 616e 7320 7468 6174 . means that │ │ │ │ │ -00045570: 2064 6566 696e 696e 6720 2741 4d5f 4d41 defining 'AM_MA │ │ │ │ │ -00045580: 4b45 494e 464f 464c 4147 5327 2077 6974 KEINFOFLAGS' wit │ │ │ │ │ -00045590: 686f 7574 2064 6566 696e 696e 670a 2020 hout defining. │ │ │ │ │ -000455a0: 2020 2027 414d 5f4d 414b 4549 4e46 4f48 'AM_MAKEINFOH │ │ │ │ │ -000455b0: 544d 4c46 4c41 4753 2720 7769 6c6c 2069 TMLFLAGS' will i │ │ │ │ │ -000455c0: 6d70 6163 7420 6275 696c 6473 206f 6620 mpact builds of │ │ │ │ │ -000455d0: 626f 7468 2027 2e69 6e66 6f27 2061 6e64 both '.info' and │ │ │ │ │ -000455e0: 0a20 2020 2020 272e 6874 6d6c 2720 6669 . '.html' fi │ │ │ │ │ -000455f0: 6c65 732e 0a0a 2754 4558 4932 4456 4927 les...'TEXI2DVI' │ │ │ │ │ -00045600: 0a20 2020 2020 5468 6520 6e61 6d65 206f . The name o │ │ │ │ │ -00045610: 6620 7468 6520 636f 6d6d 616e 6420 7468 f the command th │ │ │ │ │ -00045620: 6174 2063 6f6e 7665 7274 7320 6120 272e at converts a '. │ │ │ │ │ -00045630: 7465 7869 2720 6669 6c65 2069 6e74 6f20 texi' file into │ │ │ │ │ -00045640: 6120 272e 6476 6927 0a20 2020 2020 6669 a '.dvi'. fi │ │ │ │ │ -00045650: 6c65 2e20 2054 6869 7320 6465 6661 756c le. This defaul │ │ │ │ │ -00045660: 7473 2074 6f20 2774 6578 6932 6476 6927 ts to 'texi2dvi' │ │ │ │ │ -00045670: 2c20 6120 7363 7269 7074 2074 6861 7420 , a script that │ │ │ │ │ -00045680: 7368 6970 7320 7769 7468 2074 6865 0a20 ships with the. │ │ │ │ │ -00045690: 2020 2020 5465 7869 6e66 6f20 7061 636b Texinfo pack │ │ │ │ │ -000456a0: 6167 652e 0a0a 2754 4558 4932 5044 4627 age...'TEXI2PDF' │ │ │ │ │ -000456b0: 0a20 2020 2020 5468 6520 6e61 6d65 206f . The name o │ │ │ │ │ -000456c0: 6620 7468 6520 636f 6d6d 616e 6420 7468 f the command th │ │ │ │ │ -000456d0: 6174 2074 7261 6e73 6c61 7465 7320 6120 at translates a │ │ │ │ │ -000456e0: 272e 7465 7869 2720 6669 6c65 2069 6e74 '.texi' file int │ │ │ │ │ -000456f0: 6f20 610a 2020 2020 2027 2e70 6466 2720 o a. '.pdf' │ │ │ │ │ -00045700: 6669 6c65 2e20 2054 6869 7320 6465 6661 file. This defa │ │ │ │ │ -00045710: 756c 7473 2074 6f20 2724 2854 4558 4932 ults to '$(TEXI2 │ │ │ │ │ -00045720: 4456 4929 202d 2d70 6466 202d 2d62 6174 DVI) --pdf --bat │ │ │ │ │ -00045730: 6368 272e 0a0a 2744 5649 5053 270a 2020 ch'...'DVIPS'. │ │ │ │ │ -00045740: 2020 2054 6865 206e 616d 6520 6f66 2074 The name of t │ │ │ │ │ -00045750: 6865 2063 6f6d 6d61 6e64 2074 6861 7420 he command that │ │ │ │ │ -00045760: 6275 696c 6473 2061 2027 2e70 7327 2066 builds a '.ps' f │ │ │ │ │ -00045770: 696c 6520 6f75 7420 6f66 2061 2027 2e64 ile out of a '.d │ │ │ │ │ -00045780: 7669 270a 2020 2020 2066 696c 652e 2020 vi'. file. │ │ │ │ │ -00045790: 5468 6973 2064 6566 6175 6c74 7320 746f This defaults to │ │ │ │ │ -000457a0: 2027 6476 6970 7327 2e0a 0a27 5445 5849 'dvips'...'TEXI │ │ │ │ │ -000457b0: 4e46 4f5f 5445 5827 0a0a 2020 2020 2049 NFO_TEX'.. I │ │ │ │ │ -000457c0: 6620 796f 7572 2070 6163 6b61 6765 2068 f your package h │ │ │ │ │ -000457d0: 6173 2054 6578 696e 666f 2066 696c 6573 as Texinfo files │ │ │ │ │ -000457e0: 2069 6e20 6d61 6e79 2064 6972 6563 746f in many directo │ │ │ │ │ -000457f0: 7269 6573 2c20 796f 7520 6361 6e20 7573 ries, you can us │ │ │ │ │ -00045800: 650a 2020 2020 2074 6865 2076 6172 6961 e. the varia │ │ │ │ │ -00045810: 626c 6520 2754 4558 494e 464f 5f54 4558 ble 'TEXINFO_TEX │ │ │ │ │ -00045820: 2720 746f 2074 656c 6c20 4175 746f 6d61 ' to tell Automa │ │ │ │ │ -00045830: 6b65 2077 6865 7265 2074 6f20 6669 6e64 ke where to find │ │ │ │ │ -00045840: 2074 6865 0a20 2020 2020 6361 6e6f 6e69 the. canoni │ │ │ │ │ -00045850: 6361 6c20 2774 6578 696e 666f 2e74 6578 cal 'texinfo.tex │ │ │ │ │ -00045860: 2720 666f 7220 796f 7572 2070 6163 6b61 ' for your packa │ │ │ │ │ -00045870: 6765 2e20 2054 6865 2076 616c 7565 206f ge. The value o │ │ │ │ │ -00045880: 6620 7468 6973 0a20 2020 2020 7661 7269 f this. vari │ │ │ │ │ -00045890: 6162 6c65 2073 686f 756c 6420 6265 2074 able should be t │ │ │ │ │ -000458a0: 6865 2072 656c 6174 6976 6520 7061 7468 he relative path │ │ │ │ │ -000458b0: 2066 726f 6d20 7468 6520 6375 7272 656e from the curren │ │ │ │ │ -000458c0: 7420 274d 616b 6566 696c 652e 616d 270a t 'Makefile.am'. │ │ │ │ │ -000458d0: 2020 2020 2074 6f20 2774 6578 696e 666f to 'texinfo │ │ │ │ │ -000458e0: 2e74 6578 273a 0a0a 2020 2020 2020 2020 .tex':.. │ │ │ │ │ -000458f0: 2020 5445 5849 4e46 4f5f 5445 5820 3d20 TEXINFO_TEX = │ │ │ │ │ -00045900: 2e2e 2f64 6f63 2f74 6578 696e 666f 2e74 ../doc/texinfo.t │ │ │ │ │ -00045910: 6578 0a0a 1f0a 4669 6c65 3a20 6175 746f ex....File: auto │ │ │ │ │ -00045920: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00045930: 204e 6f64 653a 204d 616e 2050 6167 6573 Node: Man Pages │ │ │ │ │ -00045940: 2c20 2050 7265 763a 2054 6578 696e 666f , Prev: Texinfo │ │ │ │ │ -00045950: 2c20 2055 703a 2044 6f63 756d 656e 7461 , Up: Documenta │ │ │ │ │ -00045960: 7469 6f6e 0a0a 3131 2e32 204d 616e 2050 tion..11.2 Man P │ │ │ │ │ -00045970: 6167 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ages.=========== │ │ │ │ │ -00045980: 3d3d 3d0a 0a41 2070 6163 6b61 6765 2063 ===..A package c │ │ │ │ │ -00045990: 616e 2061 6c73 6f20 696e 636c 7564 6520 an also include │ │ │ │ │ -000459a0: 6d61 6e20 7061 6765 7320 2862 7574 2073 man pages (but s │ │ │ │ │ -000459b0: 6565 2074 6865 2047 4e55 2073 7461 6e64 ee the GNU stand │ │ │ │ │ -000459c0: 6172 6473 206f 6e20 7468 6973 0a6d 6174 ards on this.mat │ │ │ │ │ -000459d0: 7465 722c 202a 6e6f 7465 2028 7374 616e ter, *note (stan │ │ │ │ │ -000459e0: 6461 7264 7329 4d61 6e20 5061 6765 733a dards)Man Pages: │ │ │ │ │ -000459f0: 3a2e 2920 204d 616e 2070 6167 6573 2061 :.) Man pages a │ │ │ │ │ -00045a00: 7265 2064 6563 6c61 7265 6420 7573 696e re declared usin │ │ │ │ │ -00045a10: 6720 7468 650a 274d 414e 5327 2070 7269 g the.'MANS' pri │ │ │ │ │ -00045a20: 6d61 7279 2e20 2047 656e 6572 616c 6c79 mary. Generally │ │ │ │ │ -00045a30: 2074 6865 2027 6d61 6e5f 4d41 4e53 2720 the 'man_MANS' │ │ │ │ │ -00045a40: 7661 7269 6162 6c65 2069 7320 7573 6564 variable is used │ │ │ │ │ -00045a50: 2e20 204d 616e 2070 6167 6573 0a61 7265 . Man pages.are │ │ │ │ │ -00045a60: 2061 7574 6f6d 6174 6963 616c 6c79 2069 automatically i │ │ │ │ │ -00045a70: 6e73 7461 6c6c 6564 2069 6e20 7468 6520 nstalled in the │ │ │ │ │ -00045a80: 636f 7272 6563 7420 7375 6264 6972 6563 correct subdirec │ │ │ │ │ -00045a90: 746f 7279 206f 6620 276d 616e 6469 7227 tory of 'mandir' │ │ │ │ │ -00045aa0: 2c0a 6261 7365 6420 6f6e 2074 6865 2066 ,.based on the f │ │ │ │ │ -00045ab0: 696c 6520 6578 7465 6e73 696f 6e2e 0a0a ile extension... │ │ │ │ │ -00045ac0: 2020 2046 696c 6520 6578 7465 6e73 696f File extensio │ │ │ │ │ -00045ad0: 6e73 2073 7563 6820 6173 2027 2e31 6327 ns such as '.1c' │ │ │ │ │ -00045ae0: 2061 7265 2068 616e 646c 6564 2062 7920 are handled by │ │ │ │ │ -00045af0: 6c6f 6f6b 696e 6720 666f 7220 7468 6520 looking for the │ │ │ │ │ -00045b00: 7661 6c69 640a 7061 7274 206f 6620 7468 valid.part of th │ │ │ │ │ -00045b10: 6520 6578 7465 6e73 696f 6e20 616e 6420 e extension and │ │ │ │ │ -00045b20: 7573 696e 6720 7468 6174 2074 6f20 6465 using that to de │ │ │ │ │ -00045b30: 7465 726d 696e 6520 7468 6520 636f 7272 termine the corr │ │ │ │ │ -00045b40: 6563 740a 7375 6264 6972 6563 746f 7279 ect.subdirectory │ │ │ │ │ -00045b50: 206f 6620 276d 616e 6469 7227 2e20 2056 of 'mandir'. V │ │ │ │ │ -00045b60: 616c 6964 2073 6563 7469 6f6e 206e 616d alid section nam │ │ │ │ │ -00045b70: 6573 2061 7265 2074 6865 2064 6967 6974 es are the digit │ │ │ │ │ -00045b80: 7320 2730 270a 7468 726f 7567 6820 2739 s '0'.through '9 │ │ │ │ │ -00045b90: 272c 2061 6e64 2074 6865 206c 6574 7465 ', and the lette │ │ │ │ │ -00045ba0: 7273 2027 6c27 2061 6e64 2027 6e27 2e0a rs 'l' and 'n'.. │ │ │ │ │ -00045bb0: 0a20 2020 536f 6d65 7469 6d65 7320 6465 . Sometimes de │ │ │ │ │ -00045bc0: 7665 6c6f 7065 7273 2070 7265 6665 7220 velopers prefer │ │ │ │ │ -00045bd0: 746f 206e 616d 6520 6120 6d61 6e20 7061 to name a man pa │ │ │ │ │ -00045be0: 6765 2073 6f6d 6574 6869 6e67 206c 696b ge something lik │ │ │ │ │ -00045bf0: 650a 2766 6f6f 2e6d 616e 2720 696e 2074 e.'foo.man' in t │ │ │ │ │ -00045c00: 6865 2073 6f75 7263 652c 2061 6e64 2074 he source, and t │ │ │ │ │ -00045c10: 6865 6e20 7265 6e61 6d65 2069 7420 746f hen rename it to │ │ │ │ │ -00045c20: 2068 6176 6520 7468 6520 636f 7272 6563 have the correc │ │ │ │ │ -00045c30: 7420 7375 6666 6978 2c0a 666f 7220 6578 t suffix,.for ex │ │ │ │ │ -00045c40: 616d 706c 6520 2766 6f6f 2e31 272c 2077 ample 'foo.1', w │ │ │ │ │ -00045c50: 6865 6e20 696e 7374 616c 6c69 6e67 2074 hen installing t │ │ │ │ │ -00045c60: 6865 2066 696c 652e 2020 4175 746f 6d61 he file. Automa │ │ │ │ │ -00045c70: 6b65 2061 6c73 6f20 7375 7070 6f72 7473 ke also supports │ │ │ │ │ -00045c80: 0a74 6869 7320 6d6f 6465 2e20 2046 6f72 .this mode. For │ │ │ │ │ -00045c90: 2061 2076 616c 6964 2073 6563 7469 6f6e a valid section │ │ │ │ │ -00045ca0: 206e 616d 6564 2053 4543 5449 4f4e 2c20 named SECTION, │ │ │ │ │ -00045cb0: 7468 6572 6520 6973 2061 2063 6f72 7265 there is a corre │ │ │ │ │ -00045cc0: 7370 6f6e 6469 6e67 0a64 6972 6563 746f sponding.directo │ │ │ │ │ -00045cd0: 7279 206e 616d 6564 2027 6d61 6e53 4543 ry named 'manSEC │ │ │ │ │ -00045ce0: 5449 4f4e 6469 7227 2c20 616e 6420 6120 TIONdir', and a │ │ │ │ │ -00045cf0: 636f 7272 6573 706f 6e64 696e 6720 275f corresponding '_ │ │ │ │ │ -00045d00: 4d41 4e53 2720 7661 7269 6162 6c65 2e0a MANS' variable.. │ │ │ │ │ -00045d10: 4669 6c65 7320 6c69 7374 6564 2069 6e20 Files listed in │ │ │ │ │ -00045d20: 7375 6368 2061 2076 6172 6961 626c 6520 such a variable │ │ │ │ │ -00045d30: 6172 6520 696e 7374 616c 6c65 6420 696e are installed in │ │ │ │ │ -00045d40: 2074 6865 2069 6e64 6963 6174 6564 2073 the indicated s │ │ │ │ │ -00045d50: 6563 7469 6f6e 2e0a 4966 2074 6865 2066 ection..If the f │ │ │ │ │ -00045d60: 696c 6520 616c 7265 6164 7920 6861 7320 ile already has │ │ │ │ │ -00045d70: 6120 7661 6c69 6420 7375 6666 6978 2c20 a valid suffix, │ │ │ │ │ -00045d80: 7468 656e 2069 7420 6973 2069 6e73 7461 then it is insta │ │ │ │ │ -00045d90: 6c6c 6564 2061 732d 6973 3b0a 6f74 6865 lled as-is;.othe │ │ │ │ │ -00045da0: 7277 6973 6520 7468 6520 6669 6c65 2073 rwise the file s │ │ │ │ │ -00045db0: 7566 6669 7820 6973 2063 6861 6e67 6564 uffix is changed │ │ │ │ │ -00045dc0: 2074 6f20 6d61 7463 6820 7468 6520 7365 to match the se │ │ │ │ │ -00045dd0: 6374 696f 6e2e 0a0a 2020 2046 6f72 2069 ction... For i │ │ │ │ │ -00045de0: 6e73 7461 6e63 652c 2063 6f6e 7369 6465 nstance, conside │ │ │ │ │ -00045df0: 7220 7468 6973 2065 7861 6d70 6c65 3a0a r this example:. │ │ │ │ │ -00045e00: 2020 2020 206d 616e 315f 4d41 4e53 203d man1_MANS = │ │ │ │ │ -00045e10: 2072 656e 616d 652e 6d61 6e20 7468 6573 rename.man thes │ │ │ │ │ -00045e20: 616d 652e 3120 616c 736f 7468 6573 616d ame.1 alsothesam │ │ │ │ │ -00045e30: 652e 3163 0a0a 496e 2074 6869 7320 6361 e.1c..In this ca │ │ │ │ │ -00045e40: 7365 2c20 2772 656e 616d 652e 6d61 6e27 se, 'rename.man' │ │ │ │ │ -00045e50: 2077 696c 6c20 6265 2072 656e 616d 6564 will be renamed │ │ │ │ │ -00045e60: 2074 6f20 2772 656e 616d 652e 3127 2077 to 'rename.1' w │ │ │ │ │ -00045e70: 6865 6e20 696e 7374 616c 6c65 642c 0a62 hen installed,.b │ │ │ │ │ -00045e80: 7574 2074 6865 206f 7468 6572 2066 696c ut the other fil │ │ │ │ │ -00045e90: 6573 2077 696c 6c20 6b65 6570 2074 6865 es will keep the │ │ │ │ │ -00045ea0: 6972 206e 616d 6573 2e0a 0a20 2020 4279 ir names... By │ │ │ │ │ -00045eb0: 2064 6566 6175 6c74 2c20 6d61 6e20 7061 default, man pa │ │ │ │ │ -00045ec0: 6765 7320 6172 6520 696e 7374 616c 6c65 ges are installe │ │ │ │ │ -00045ed0: 6420 6279 2027 6d61 6b65 2069 6e73 7461 d by 'make insta │ │ │ │ │ -00045ee0: 6c6c 272e 2020 486f 7765 7665 722c 0a73 ll'. However,.s │ │ │ │ │ -00045ef0: 696e 6365 2074 6865 2047 4e55 2070 726f ince the GNU pro │ │ │ │ │ -00045f00: 6a65 6374 2064 6f65 7320 6e6f 7420 7265 ject does not re │ │ │ │ │ -00045f10: 7175 6972 6520 6d61 6e20 7061 6765 732c quire man pages, │ │ │ │ │ -00045f20: 206d 616e 7920 6d61 696e 7461 696e 6572 many maintainer │ │ │ │ │ -00045f30: 7320 646f 0a6e 6f74 2065 7870 656e 6420 s do.not expend │ │ │ │ │ -00045f40: 6566 666f 7274 2074 6f20 6b65 6570 2074 effort to keep t │ │ │ │ │ -00045f50: 6865 206d 616e 2070 6167 6573 2075 7020 he man pages up │ │ │ │ │ -00045f60: 746f 2064 6174 652e 2020 496e 2074 6865 to date. In the │ │ │ │ │ -00045f70: 7365 2063 6173 6573 2c20 7468 650a 276e se cases, the.'n │ │ │ │ │ -00045f80: 6f2d 696e 7374 616c 6c6d 616e 2720 6f70 o-installman' op │ │ │ │ │ -00045f90: 7469 6f6e 2077 696c 6c20 7072 6576 656e tion will preven │ │ │ │ │ -00045fa0: 7420 7468 6520 6d61 6e20 7061 6765 7320 t the man pages │ │ │ │ │ -00045fb0: 6672 6f6d 2062 6569 6e67 2069 6e73 7461 from being insta │ │ │ │ │ -00045fc0: 6c6c 6564 0a62 7920 6465 6661 756c 742e lled.by default. │ │ │ │ │ -00045fd0: 2020 5468 6520 7573 6572 2063 616e 2073 The user can s │ │ │ │ │ -00045fe0: 7469 6c6c 2065 7870 6c69 6369 746c 7920 till explicitly │ │ │ │ │ -00045ff0: 696e 7374 616c 6c20 7468 656d 2076 6961 install them via │ │ │ │ │ -00046000: 2027 6d61 6b65 0a69 6e73 7461 6c6c 2d6d 'make.install-m │ │ │ │ │ -00046010: 616e 272e 0a0a 2020 2046 6f72 2066 6173 an'... For fas │ │ │ │ │ -00046020: 7420 696e 7374 616c 6c61 7469 6f6e 2c20 t installation, │ │ │ │ │ -00046030: 7769 7468 206d 616e 7920 6669 6c65 7320 with many files │ │ │ │ │ -00046040: 6974 2069 7320 7072 6566 6572 6162 6c65 it is preferable │ │ │ │ │ -00046050: 2074 6f20 7573 650a 276d 616e 5345 4354 to use.'manSECT │ │ │ │ │ -00046060: 494f 4e5f 4d41 4e53 2720 6f76 6572 2027 ION_MANS' over ' │ │ │ │ │ -00046070: 6d61 6e5f 4d41 4e53 2720 6173 2077 656c man_MANS' as wel │ │ │ │ │ -00046080: 6c20 6173 2066 696c 6573 2074 6861 7420 l as files that │ │ │ │ │ -00046090: 646f 206e 6f74 206e 6565 6420 746f 0a62 do not need to.b │ │ │ │ │ -000460a0: 6520 7265 6e61 6d65 642e 0a0a 2020 204d e renamed... M │ │ │ │ │ -000460b0: 616e 2070 6167 6573 2061 7265 206e 6f74 an pages are not │ │ │ │ │ -000460c0: 2063 7572 7265 6e74 6c79 2063 6f6e 7369 currently consi │ │ │ │ │ -000460d0: 6465 7265 6420 746f 2062 6520 736f 7572 dered to be sour │ │ │ │ │ -000460e0: 6365 2c20 6265 6361 7573 6520 6974 2069 ce, because it i │ │ │ │ │ -000460f0: 730a 6e6f 7420 756e 636f 6d6d 6f6e 2066 s.not uncommon f │ │ │ │ │ -00046100: 6f72 206d 616e 2070 6167 6573 2074 6f20 or man pages to │ │ │ │ │ -00046110: 6265 2061 7574 6f6d 6174 6963 616c 6c79 be automatically │ │ │ │ │ -00046120: 2067 656e 6572 6174 6564 2e20 2054 6865 generated. The │ │ │ │ │ -00046130: 7265 666f 7265 0a74 6865 7920 6172 6520 refore.they are │ │ │ │ │ -00046140: 6e6f 7420 6175 746f 6d61 7469 6361 6c6c not automaticall │ │ │ │ │ -00046150: 7920 696e 636c 7564 6564 2069 6e20 7468 y included in th │ │ │ │ │ -00046160: 6520 6469 7374 7269 6275 7469 6f6e 2e20 e distribution. │ │ │ │ │ -00046170: 2048 6f77 6576 6572 2c20 7468 6973 0a63 However, this.c │ │ │ │ │ -00046180: 616e 2062 6520 6368 616e 6765 6420 6279 an be changed by │ │ │ │ │ -00046190: 2075 7365 206f 6620 7468 6520 2764 6973 use of the 'dis │ │ │ │ │ -000461a0: 745f 2720 7072 6566 6978 2e20 2046 6f72 t_' prefix. For │ │ │ │ │ -000461b0: 2069 6e73 7461 6e63 6520 6865 7265 2069 instance here i │ │ │ │ │ -000461c0: 7320 686f 770a 746f 2064 6973 7472 6962 s how.to distrib │ │ │ │ │ -000461d0: 7574 6520 616e 6420 696e 7374 616c 6c20 ute and install │ │ │ │ │ -000461e0: 7468 6520 7477 6f20 6d61 6e20 7061 6765 the two man page │ │ │ │ │ -000461f0: 7320 6f66 2047 4e55 2027 6370 696f 2720 s of GNU 'cpio' │ │ │ │ │ -00046200: 2877 6869 6368 0a69 6e63 6c75 6465 7320 (which.includes │ │ │ │ │ -00046210: 626f 7468 2054 6578 696e 666f 2064 6f63 both Texinfo doc │ │ │ │ │ -00046220: 756d 656e 7461 7469 6f6e 2061 6e64 206d umentation and m │ │ │ │ │ -00046230: 616e 2070 6167 6573 293a 0a0a 2020 2020 an pages):.. │ │ │ │ │ -00046240: 2064 6973 745f 6d61 6e5f 4d41 4e53 203d dist_man_MANS = │ │ │ │ │ -00046250: 2063 7069 6f2e 3120 6d74 2e31 0a0a 2020 cpio.1 mt.1.. │ │ │ │ │ -00046260: 2054 6865 2027 6e6f 6261 7365 5f27 2070 The 'nobase_' p │ │ │ │ │ -00046270: 7265 6669 7820 6973 206d 6561 6e69 6e67 refix is meaning │ │ │ │ │ -00046280: 6c65 7373 2066 6f72 206d 616e 2070 6167 less for man pag │ │ │ │ │ -00046290: 6573 2061 6e64 2069 7320 6469 7361 6c6c es and is disall │ │ │ │ │ -000462a0: 6f77 6564 2e0a 0a20 2020 4578 6563 7574 owed... Execut │ │ │ │ │ -000462b0: 6162 6c65 7320 616e 6420 6d61 6e70 6167 ables and manpag │ │ │ │ │ -000462c0: 6573 206d 6179 2062 6520 7265 6e61 6d65 es may be rename │ │ │ │ │ -000462d0: 6420 7570 6f6e 2069 6e73 7461 6c6c 6174 d upon installat │ │ │ │ │ -000462e0: 696f 6e20 282a 6e6f 7465 0a52 656e 616d ion (*note.Renam │ │ │ │ │ -000462f0: 696e 673a 3a29 2e20 2046 6f72 206d 616e ing::). For man │ │ │ │ │ -00046300: 7061 6765 7320 7468 6973 2063 616e 2062 pages this can b │ │ │ │ │ -00046310: 6520 6176 6f69 6465 6420 6279 2075 7365 e avoided by use │ │ │ │ │ -00046320: 206f 6620 7468 6520 276e 6f74 7261 6e73 of the 'notrans │ │ │ │ │ -00046330: 5f27 0a70 7265 6669 782e 2020 466f 7220 _'.prefix. For │ │ │ │ │ -00046340: 696e 7374 616e 6365 2c20 7375 7070 6f73 instance, suppos │ │ │ │ │ -00046350: 6520 616e 2065 7865 6375 7461 626c 6520 e an executable │ │ │ │ │ -00046360: 2766 6f6f 2720 616c 6c6f 7769 6e67 2074 'foo' allowing t │ │ │ │ │ -00046370: 6f20 6163 6365 7373 2061 0a6c 6962 7261 o access a.libra │ │ │ │ │ -00046380: 7279 2066 756e 6374 696f 6e20 2766 6f6f ry function 'foo │ │ │ │ │ -00046390: 2720 6672 6f6d 2074 6865 2063 6f6d 6d61 ' from the comma │ │ │ │ │ -000463a0: 6e64 206c 696e 652e 2020 5468 6520 7761 nd line. The wa │ │ │ │ │ -000463b0: 7920 746f 2061 766f 6964 2072 656e 616d y to avoid renam │ │ │ │ │ -000463c0: 696e 670a 6f66 2074 6865 2027 666f 6f2e ing.of the 'foo. │ │ │ │ │ -000463d0: 3327 206d 616e 7061 6765 2069 733a 0a0a 3' manpage is:.. │ │ │ │ │ -000463e0: 2020 2020 206d 616e 5f4d 414e 5320 3d20 man_MANS = │ │ │ │ │ -000463f0: 666f 6f2e 310a 2020 2020 206e 6f74 7261 foo.1. notra │ │ │ │ │ -00046400: 6e73 5f6d 616e 5f4d 414e 5320 3d20 666f ns_man_MANS = fo │ │ │ │ │ -00046410: 6f2e 330a 0a20 2020 276e 6f74 7261 6e73 o.3.. 'notrans │ │ │ │ │ -00046420: 5f27 206d 7573 7420 6265 2073 7065 6369 _' must be speci │ │ │ │ │ -00046430: 6669 6564 2066 6972 7374 2077 6865 6e20 fied first when │ │ │ │ │ -00046440: 7573 6564 2069 6e20 636f 6e6a 756e 6374 used in conjunct │ │ │ │ │ -00046450: 696f 6e20 7769 7468 0a65 6974 6865 7220 ion with.either │ │ │ │ │ -00046460: 2764 6973 745f 2720 6f72 2027 6e6f 6469 'dist_' or 'nodi │ │ │ │ │ -00046470: 7374 5f27 2028 2a6e 6f74 6520 4669 6e65 st_' (*note Fine │ │ │ │ │ -00046480: 2d67 7261 696e 6564 2044 6973 7472 6962 -grained Distrib │ │ │ │ │ -00046490: 7574 696f 6e20 436f 6e74 726f 6c3a 3a29 ution Control::) │ │ │ │ │ -000464a0: 2e0a 466f 7220 696e 7374 616e 6365 3a0a ..For instance:. │ │ │ │ │ -000464b0: 0a20 2020 2020 6e6f 7472 616e 735f 6469 . notrans_di │ │ │ │ │ -000464c0: 7374 5f6d 616e 335f 4d41 4e53 203d 2062 st_man3_MANS = b │ │ │ │ │ -000464d0: 6172 2e33 0a0a 1f0a 4669 6c65 3a20 6175 ar.3....File: au │ │ │ │ │ -000464e0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -000464f0: 2c20 204e 6f64 653a 2049 6e73 7461 6c6c , Node: Install │ │ │ │ │ -00046500: 2c20 204e 6578 743a 2043 6c65 616e 2c20 , Next: Clean, │ │ │ │ │ -00046510: 2050 7265 763a 2044 6f63 756d 656e 7461 Prev: Documenta │ │ │ │ │ -00046520: 7469 6f6e 2c20 2055 703a 2054 6f70 0a0a tion, Up: Top.. │ │ │ │ │ -00046530: 3132 2057 6861 7420 4765 7473 2049 6e73 12 What Gets Ins │ │ │ │ │ -00046540: 7461 6c6c 6564 0a2a 2a2a 2a2a 2a2a 2a2a talled.********* │ │ │ │ │ -00046550: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a4e *************..N │ │ │ │ │ -00046560: 6174 7572 616c 6c79 2c20 4175 746f 6d61 aturally, Automa │ │ │ │ │ -00046570: 6b65 2068 616e 646c 6573 2074 6865 2064 ke handles the d │ │ │ │ │ -00046580: 6574 6169 6c73 206f 6620 6163 7475 616c etails of actual │ │ │ │ │ -00046590: 6c79 2069 6e73 7461 6c6c 696e 6720 796f ly installing yo │ │ │ │ │ -000465a0: 7572 0a70 726f 6772 616d 206f 6e63 6520 ur.program once │ │ │ │ │ -000465b0: 6974 2068 6173 2062 6565 6e20 6275 696c it has been buil │ │ │ │ │ -000465c0: 742e 2020 416c 6c20 6669 6c65 7320 6e61 t. All files na │ │ │ │ │ -000465d0: 6d65 6420 6279 2074 6865 2076 6172 696f med by the vario │ │ │ │ │ -000465e0: 7573 0a70 7269 6d61 7269 6573 2061 7265 us.primaries are │ │ │ │ │ -000465f0: 2061 7574 6f6d 6174 6963 616c 6c79 2069 automatically i │ │ │ │ │ -00046600: 6e73 7461 6c6c 6564 2069 6e20 7468 6520 nstalled in the │ │ │ │ │ -00046610: 6170 7072 6f70 7269 6174 6520 706c 6163 appropriate plac │ │ │ │ │ -00046620: 6573 2077 6865 6e20 7468 650a 7573 6572 es when the.user │ │ │ │ │ -00046630: 2072 756e 7320 276d 616b 6520 696e 7374 runs 'make inst │ │ │ │ │ -00046640: 616c 6c27 2e0a 0a2a 204d 656e 753a 0a0a all'...* Menu:.. │ │ │ │ │ -00046650: 2a20 4261 7369 6373 206f 6620 496e 7374 * Basics of Inst │ │ │ │ │ -00046660: 616c 6c61 7469 6f6e 3a3a 2020 2020 2020 allation:: │ │ │ │ │ -00046670: 5768 6174 2067 6574 7320 696e 7374 616c What gets instal │ │ │ │ │ -00046680: 6c65 6420 7768 6572 650a 2a20 5468 6520 led where.* The │ │ │ │ │ -00046690: 5477 6f20 5061 7274 7320 6f66 2049 6e73 Two Parts of Ins │ │ │ │ │ -000466a0: 7461 6c6c 3a3a 2020 2020 496e 7374 616c tall:: Instal │ │ │ │ │ -000466b0: 6c69 6e67 2064 6174 6120 616e 6420 7072 ling data and pr │ │ │ │ │ -000466c0: 6f67 7261 6d73 2073 6570 6172 6174 656c ograms separatel │ │ │ │ │ -000466d0: 790a 2a20 4578 7465 6e64 696e 6720 496e y.* Extending In │ │ │ │ │ -000466e0: 7374 616c 6c61 7469 6f6e 3a3a 2020 2020 stallation:: │ │ │ │ │ -000466f0: 2020 4164 6469 6e67 2079 6f75 7220 6f77 Adding your ow │ │ │ │ │ -00046700: 6e20 7275 6c65 7320 666f 7220 696e 7374 n rules for inst │ │ │ │ │ -00046710: 616c 6c61 7469 6f6e 0a2a 2053 7461 6765 allation.* Stage │ │ │ │ │ -00046720: 6420 496e 7374 616c 6c73 3a3a 2020 2020 d Installs:: │ │ │ │ │ -00046730: 2020 2020 2020 2020 2049 6e73 7461 6c6c Install │ │ │ │ │ -00046740: 6174 696f 6e20 696e 2061 2074 656d 706f ation in a tempo │ │ │ │ │ -00046750: 7261 7279 206c 6f63 6174 696f 6e0a 2a20 rary location.* │ │ │ │ │ -00046760: 496e 7374 616c 6c20 5275 6c65 7320 666f Install Rules fo │ │ │ │ │ -00046770: 7220 7468 6520 5573 6572 3a3a 2020 5573 r the User:: Us │ │ │ │ │ -00046780: 6566 756c 2061 6464 6974 696f 6e61 6c20 eful additional │ │ │ │ │ -00046790: 7275 6c65 730a 0a1f 0a46 696c 653a 2061 rules....File: a │ │ │ │ │ -000467a0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -000467b0: 6f2c 2020 4e6f 6465 3a20 4261 7369 6373 o, Node: Basics │ │ │ │ │ -000467c0: 206f 6620 496e 7374 616c 6c61 7469 6f6e of Installation │ │ │ │ │ -000467d0: 2c20 204e 6578 743a 2054 6865 2054 776f , Next: The Two │ │ │ │ │ -000467e0: 2050 6172 7473 206f 6620 496e 7374 616c Parts of Instal │ │ │ │ │ -000467f0: 6c2c 2020 5570 3a20 496e 7374 616c 6c0a l, Up: Install. │ │ │ │ │ -00046800: 0a31 322e 3120 4261 7369 6373 206f 6620 .12.1 Basics of │ │ │ │ │ -00046810: 496e 7374 616c 6c61 7469 6f6e 0a3d 3d3d Installation.=== │ │ │ │ │ +00044010: 2020 4d61 6e20 7061 6765 730a 0a1f 0a46 Man pages....F │ │ │ │ │ +00044020: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +00044030: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +00044040: 5465 7869 6e66 6f2c 2020 4e65 7874 3a20 Texinfo, Next: │ │ │ │ │ +00044050: 4d61 6e20 5061 6765 732c 2020 5570 3a20 Man Pages, Up: │ │ │ │ │ +00044060: 446f 6375 6d65 6e74 6174 696f 6e0a 0a31 Documentation..1 │ │ │ │ │ +00044070: 312e 3120 5465 7869 6e66 6f0a 3d3d 3d3d 1.1 Texinfo.==== │ │ │ │ │ +00044080: 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 ========..If the │ │ │ │ │ +00044090: 2063 7572 7265 6e74 2064 6972 6563 746f current directo │ │ │ │ │ +000440a0: 7279 2063 6f6e 7461 696e 7320 5465 7869 ry contains Texi │ │ │ │ │ +000440b0: 6e66 6f20 736f 7572 6365 2c20 796f 7520 nfo source, you │ │ │ │ │ +000440c0: 6d75 7374 2064 6563 6c61 7265 2069 740a must declare it. │ │ │ │ │ +000440d0: 7769 7468 2074 6865 2027 5445 5849 4e46 with the 'TEXINF │ │ │ │ │ +000440e0: 4f53 2720 7072 696d 6172 792e 2020 4765 OS' primary. Ge │ │ │ │ │ +000440f0: 6e65 7261 6c6c 7920 5465 7869 6e66 6f20 nerally Texinfo │ │ │ │ │ +00044100: 6669 6c65 7320 6172 6520 636f 6e76 6572 files are conver │ │ │ │ │ +00044110: 7465 6420 696e 746f 0a69 6e66 6f2c 2061 ted into.info, a │ │ │ │ │ +00044120: 6e64 2074 6875 7320 7468 6520 2769 6e66 nd thus the 'inf │ │ │ │ │ +00044130: 6f5f 5445 5849 4e46 4f53 2720 7661 7269 o_TEXINFOS' vari │ │ │ │ │ +00044140: 6162 6c65 2069 7320 6d6f 7374 2063 6f6d able is most com │ │ │ │ │ +00044150: 6d6f 6e6c 7920 7573 6564 2068 6572 652e monly used here. │ │ │ │ │ +00044160: 0a41 6e79 2054 6578 696e 666f 2073 6f75 .Any Texinfo sou │ │ │ │ │ +00044170: 7263 6520 6669 6c65 206d 7573 7420 656e rce file must en │ │ │ │ │ +00044180: 6420 696e 2074 6865 2027 2e74 6578 6927 d in the '.texi' │ │ │ │ │ +00044190: 2c20 272e 7478 6927 2c20 6f72 2027 2e74 , '.txi', or '.t │ │ │ │ │ +000441a0: 6578 696e 666f 270a 6578 7465 6e73 696f exinfo'.extensio │ │ │ │ │ +000441b0: 6e2e 2020 5765 2072 6563 6f6d 6d65 6e64 n. We recommend │ │ │ │ │ +000441c0: 2027 2e74 6578 6927 2066 6f72 206e 6577 '.texi' for new │ │ │ │ │ +000441d0: 206d 616e 7561 6c73 2e0a 0a20 2020 4175 manuals... Au │ │ │ │ │ +000441e0: 746f 6d61 6b65 2067 656e 6572 6174 6573 tomake generates │ │ │ │ │ +000441f0: 2072 756c 6573 2074 6f20 6275 696c 6420 rules to build │ │ │ │ │ +00044200: 272e 696e 666f 272c 2027 2e64 7669 272c '.info', '.dvi', │ │ │ │ │ +00044210: 2027 2e70 7327 2c20 272e 7064 6627 2061 '.ps', '.pdf' a │ │ │ │ │ +00044220: 6e64 0a27 2e68 746d 6c27 2066 696c 6573 nd.'.html' files │ │ │ │ │ +00044230: 2066 726f 6d20 796f 7572 2054 6578 696e from your Texin │ │ │ │ │ +00044240: 666f 2073 6f75 7263 6573 2e20 2046 6f6c fo sources. Fol │ │ │ │ │ +00044250: 6c6f 7769 6e67 2074 6865 2047 4e55 2043 lowing the GNU C │ │ │ │ │ +00044260: 6f64 696e 670a 5374 616e 6461 7264 732c oding.Standards, │ │ │ │ │ +00044270: 206f 6e6c 7920 7468 6520 272e 696e 666f only the '.info │ │ │ │ │ +00044280: 2720 6669 6c65 7320 6172 6520 6275 696c ' files are buil │ │ │ │ │ +00044290: 7420 6279 2027 6d61 6b65 2061 6c6c 2720 t by 'make all' │ │ │ │ │ +000442a0: 616e 6420 696e 7374 616c 6c65 640a 6279 and installed.by │ │ │ │ │ +000442b0: 2027 6d61 6b65 2069 6e73 7461 6c6c 2720 'make install' │ │ │ │ │ +000442c0: 2875 6e6c 6573 7320 796f 7520 7573 6520 (unless you use │ │ │ │ │ +000442d0: 276e 6f2d 696e 7374 616c 6c69 6e66 6f27 'no-installinfo' │ │ │ │ │ +000442e0: 2c20 7365 6520 6265 6c6f 7729 2e0a 4675 , see below)..Fu │ │ │ │ │ +000442f0: 7274 6865 726d 6f72 652c 2027 2e69 6e66 rthermore, '.inf │ │ │ │ │ +00044300: 6f27 2066 696c 6573 2061 7265 2061 7574 o' files are aut │ │ │ │ │ +00044310: 6f6d 6174 6963 616c 6c79 2064 6973 7472 omatically distr │ │ │ │ │ +00044320: 6962 7574 6564 2073 6f20 7468 6174 2054 ibuted so that T │ │ │ │ │ +00044330: 6578 696e 666f 0a69 7320 6e6f 7420 6120 exinfo.is not a │ │ │ │ │ +00044340: 7072 6572 6571 7569 7369 7465 2066 6f72 prerequisite for │ │ │ │ │ +00044350: 2069 6e73 7461 6c6c 696e 6720 796f 7572 installing your │ │ │ │ │ +00044360: 2070 6163 6b61 6765 2e0a 0a20 2020 4f74 package... Ot │ │ │ │ │ +00044370: 6865 7220 646f 6375 6d65 6e74 6174 696f her documentatio │ │ │ │ │ +00044380: 6e20 666f 726d 6174 7320 6361 6e20 6265 n formats can be │ │ │ │ │ +00044390: 2062 7569 6c74 206f 6e20 7265 7175 6573 built on reques │ │ │ │ │ +000443a0: 7420 6279 2027 6d61 6b65 2064 7669 272c t by 'make dvi', │ │ │ │ │ +000443b0: 0a27 6d61 6b65 2070 7327 2c20 276d 616b .'make ps', 'mak │ │ │ │ │ +000443c0: 6520 7064 6627 2061 6e64 2027 6d61 6b65 e pdf' and 'make │ │ │ │ │ +000443d0: 2068 746d 6c27 2c20 616e 6420 7468 6579 html', and they │ │ │ │ │ +000443e0: 2063 616e 2062 6520 696e 7374 616c 6c65 can be installe │ │ │ │ │ +000443f0: 6420 7769 7468 0a27 6d61 6b65 2069 6e73 d with.'make ins │ │ │ │ │ +00044400: 7461 6c6c 2d64 7669 272c 2027 6d61 6b65 tall-dvi', 'make │ │ │ │ │ +00044410: 2069 6e73 7461 6c6c 2d70 7327 2c20 276d install-ps', 'm │ │ │ │ │ +00044420: 616b 6520 696e 7374 616c 6c2d 7064 6627 ake install-pdf' │ │ │ │ │ +00044430: 2061 6e64 2027 6d61 6b65 0a69 6e73 7461 and 'make.insta │ │ │ │ │ +00044440: 6c6c 2d68 746d 6c27 2065 7870 6c69 6369 ll-html' explici │ │ │ │ │ +00044450: 746c 792e 2020 276d 616b 6520 756e 696e tly. 'make unin │ │ │ │ │ +00044460: 7374 616c 6c27 2077 696c 6c20 7265 6d6f stall' will remo │ │ │ │ │ +00044470: 7665 2065 7665 7279 7468 696e 673a 2074 ve everything: t │ │ │ │ │ +00044480: 6865 0a54 6578 696e 666f 2064 6f63 756d he.Texinfo docum │ │ │ │ │ +00044490: 656e 7461 7469 6f6e 2069 6e73 7461 6c6c entation install │ │ │ │ │ +000444a0: 6564 2062 7920 6465 6661 756c 7420 6173 ed by default as │ │ │ │ │ +000444b0: 2077 656c 6c20 6173 2061 6c6c 2074 6865 well as all the │ │ │ │ │ +000444c0: 2061 626f 7665 0a6f 7074 696f 6e61 6c20 above.optional │ │ │ │ │ +000444d0: 666f 726d 6174 732e 0a0a 2020 2041 6c6c formats... All │ │ │ │ │ +000444e0: 2074 6865 7365 2074 6172 6765 7473 2063 these targets c │ │ │ │ │ +000444f0: 616e 2062 6520 6578 7465 6e64 6564 2075 an be extended u │ │ │ │ │ +00044500: 7369 6e67 2027 2d6c 6f63 616c 2720 7275 sing '-local' ru │ │ │ │ │ +00044510: 6c65 7320 282a 6e6f 7465 0a45 7874 656e les (*note.Exten │ │ │ │ │ +00044520: 6469 6e67 3a3a 292e 0a0a 2020 2049 6620 ding::)... If │ │ │ │ │ +00044530: 7468 6520 272e 7465 7869 2720 6669 6c65 the '.texi' file │ │ │ │ │ +00044540: 2027 4069 6e63 6c75 6465 2773 2027 7665 '@include's 've │ │ │ │ │ +00044550: 7273 696f 6e2e 7465 7869 272c 2074 6865 rsion.texi', the │ │ │ │ │ +00044560: 6e20 7468 6174 2066 696c 6520 7769 6c6c n that file will │ │ │ │ │ +00044570: 0a62 6520 6175 746f 6d61 7469 6361 6c6c .be automaticall │ │ │ │ │ +00044580: 7920 6765 6e65 7261 7465 642e 2020 5468 y generated. Th │ │ │ │ │ +00044590: 6520 6669 6c65 2027 7665 7273 696f 6e2e e file 'version. │ │ │ │ │ +000445a0: 7465 7869 2720 6465 6669 6e65 7320 666f texi' defines fo │ │ │ │ │ +000445b0: 7572 0a54 6578 696e 666f 2066 6c61 6720 ur.Texinfo flag │ │ │ │ │ +000445c0: 796f 7520 6361 6e20 7265 6665 7265 6e63 you can referenc │ │ │ │ │ +000445d0: 6520 7573 696e 6720 2740 7661 6c75 657b e using '@value{ │ │ │ │ │ +000445e0: 4544 4954 494f 4e7d 272c 0a27 4076 616c EDITION}',.'@val │ │ │ │ │ +000445f0: 7565 7b56 4552 5349 4f4e 7d27 2c20 2740 ue{VERSION}', '@ │ │ │ │ │ +00044600: 7661 6c75 657b 5550 4441 5445 447d 272c value{UPDATED}', │ │ │ │ │ +00044610: 2061 6e64 2027 4076 616c 7565 7b55 5044 and '@value{UPD │ │ │ │ │ +00044620: 4154 4544 2d4d 4f4e 5448 7d27 2e0a 0a27 ATED-MONTH}'...' │ │ │ │ │ +00044630: 4544 4954 494f 4e27 0a27 5645 5253 494f EDITION'.'VERSIO │ │ │ │ │ +00044640: 4e27 0a20 2020 2020 426f 7468 206f 6620 N'. Both of │ │ │ │ │ +00044650: 7468 6573 6520 666c 6167 7320 686f 6c64 these flags hold │ │ │ │ │ +00044660: 2074 6865 2076 6572 7369 6f6e 206e 756d the version num │ │ │ │ │ +00044670: 6265 7220 6f66 2079 6f75 7220 7072 6f67 ber of your prog │ │ │ │ │ +00044680: 7261 6d2e 2020 5468 6579 0a20 2020 2020 ram. They. │ │ │ │ │ +00044690: 6172 6520 6b65 7074 2073 6570 6172 6174 are kept separat │ │ │ │ │ +000446a0: 6520 666f 7220 636c 6172 6974 792e 0a0a e for clarity... │ │ │ │ │ +000446b0: 2755 5044 4154 4544 270a 2020 2020 2054 'UPDATED'. T │ │ │ │ │ +000446c0: 6869 7320 686f 6c64 7320 7468 6520 6461 his holds the da │ │ │ │ │ +000446d0: 7465 2074 6865 2070 7269 6d61 7279 2027 te the primary ' │ │ │ │ │ +000446e0: 2e74 6578 6927 2066 696c 6520 7761 7320 .texi' file was │ │ │ │ │ +000446f0: 6c61 7374 206d 6f64 6966 6965 642e 0a0a last modified... │ │ │ │ │ +00044700: 2755 5044 4154 4544 2d4d 4f4e 5448 270a 'UPDATED-MONTH'. │ │ │ │ │ +00044710: 2020 2020 2054 6869 7320 686f 6c64 7320 This holds │ │ │ │ │ +00044720: 7468 6520 6e61 6d65 206f 6620 7468 6520 the name of the │ │ │ │ │ +00044730: 6d6f 6e74 6820 696e 2077 6869 6368 2074 month in which t │ │ │ │ │ +00044740: 6865 2070 7269 6d61 7279 2027 2e74 6578 he primary '.tex │ │ │ │ │ +00044750: 6927 2066 696c 650a 2020 2020 2077 6173 i' file. was │ │ │ │ │ +00044760: 206c 6173 7420 6d6f 6469 6669 6564 2e0a last modified.. │ │ │ │ │ +00044770: 0a20 2020 5468 6520 2776 6572 7369 6f6e . The 'version │ │ │ │ │ +00044780: 2e74 6578 6927 2073 7570 706f 7274 2072 .texi' support r │ │ │ │ │ +00044790: 6571 7569 7265 7320 7468 6520 276d 6461 equires the 'mda │ │ │ │ │ +000447a0: 7465 2d73 6827 2073 6372 6970 743b 2074 te-sh' script; t │ │ │ │ │ +000447b0: 6869 730a 7363 7269 7074 2069 7320 7375 his.script is su │ │ │ │ │ +000447c0: 7070 6c69 6564 2077 6974 6820 4175 746f pplied with Auto │ │ │ │ │ +000447d0: 6d61 6b65 2061 6e64 2061 7574 6f6d 6174 make and automat │ │ │ │ │ +000447e0: 6963 616c 6c79 2069 6e63 6c75 6465 6420 ically included │ │ │ │ │ +000447f0: 7768 656e 0a27 6175 746f 6d61 6b65 2720 when.'automake' │ │ │ │ │ +00044800: 6973 2069 6e76 6f6b 6564 2077 6974 6820 is invoked with │ │ │ │ │ +00044810: 7468 6520 272d 2d61 6464 2d6d 6973 7369 the '--add-missi │ │ │ │ │ +00044820: 6e67 2720 6f70 7469 6f6e 2e0a 0a20 2020 ng' option... │ │ │ │ │ +00044830: 4966 2079 6f75 2068 6176 6520 6d75 6c74 If you have mult │ │ │ │ │ +00044840: 6970 6c65 2054 6578 696e 666f 2066 696c iple Texinfo fil │ │ │ │ │ +00044850: 6573 2c20 616e 6420 796f 7520 7761 6e74 es, and you want │ │ │ │ │ +00044860: 2074 6f20 7573 6520 7468 650a 2776 6572 to use the.'ver │ │ │ │ │ +00044870: 7369 6f6e 2e74 6578 6927 2066 6561 7475 sion.texi' featu │ │ │ │ │ +00044880: 7265 2c20 7468 656e 2079 6f75 2068 6176 re, then you hav │ │ │ │ │ +00044890: 6520 746f 2068 6176 6520 6120 7365 7061 e to have a sepa │ │ │ │ │ +000448a0: 7261 7465 2076 6572 7369 6f6e 2066 696c rate version fil │ │ │ │ │ +000448b0: 650a 666f 7220 6561 6368 2054 6578 696e e.for each Texin │ │ │ │ │ +000448c0: 666f 2066 696c 652e 2020 4175 746f 6d61 fo file. Automa │ │ │ │ │ +000448d0: 6b65 2077 696c 6c20 7472 6561 7420 616e ke will treat an │ │ │ │ │ +000448e0: 7920 696e 636c 7564 6520 696e 2061 2054 y include in a T │ │ │ │ │ +000448f0: 6578 696e 666f 0a66 696c 6520 7468 6174 exinfo.file that │ │ │ │ │ +00044900: 206d 6174 6368 6573 2027 7665 7273 2a2e matches 'vers*. │ │ │ │ │ +00044910: 7465 7869 2720 6a75 7374 2061 7320 616e texi' just as an │ │ │ │ │ +00044920: 2061 7574 6f6d 6174 6963 616c 6c79 2067 automatically g │ │ │ │ │ +00044930: 656e 6572 6174 6564 0a76 6572 7369 6f6e enerated.version │ │ │ │ │ +00044940: 2066 696c 652e 0a0a 2020 2053 6f6d 6574 file... Somet │ │ │ │ │ +00044950: 696d 6573 2061 6e20 696e 666f 2066 696c imes an info fil │ │ │ │ │ +00044960: 6520 6163 7475 616c 6c79 2064 6570 656e e actually depen │ │ │ │ │ +00044970: 6473 206f 6e20 6d6f 7265 2074 6861 6e20 ds on more than │ │ │ │ │ +00044980: 6f6e 6520 272e 7465 7869 270a 6669 6c65 one '.texi'.file │ │ │ │ │ +00044990: 2e20 2046 6f72 2069 6e73 7461 6e63 652c . For instance, │ │ │ │ │ +000449a0: 2069 6e20 474e 5520 4865 6c6c 6f2c 2027 in GNU Hello, ' │ │ │ │ │ +000449b0: 6865 6c6c 6f2e 7465 7869 2720 696e 636c hello.texi' incl │ │ │ │ │ +000449c0: 7564 6573 2074 6865 2066 696c 650a 2766 udes the file.'f │ │ │ │ │ +000449d0: 646c 2e74 6578 6927 2e20 2059 6f75 2063 dl.texi'. You c │ │ │ │ │ +000449e0: 616e 2074 656c 6c20 4175 746f 6d61 6b65 an tell Automake │ │ │ │ │ +000449f0: 2061 626f 7574 2074 6865 7365 2064 6570 about these dep │ │ │ │ │ +00044a00: 656e 6465 6e63 6965 7320 7573 696e 6720 endencies using │ │ │ │ │ +00044a10: 7468 650a 2754 4558 495f 5445 5849 4e46 the.'TEXI_TEXINF │ │ │ │ │ +00044a20: 4f53 2720 7661 7269 6162 6c65 2e20 2048 OS' variable. H │ │ │ │ │ +00044a30: 6572 6520 6973 2068 6f77 2047 4e55 2048 ere is how GNU H │ │ │ │ │ +00044a40: 656c 6c6f 2064 6f65 7320 6974 3a0a 0a20 ello does it:.. │ │ │ │ │ +00044a50: 2020 2020 696e 666f 5f54 4558 494e 464f info_TEXINFO │ │ │ │ │ +00044a60: 5320 3d20 6865 6c6c 6f2e 7465 7869 0a20 S = hello.texi. │ │ │ │ │ +00044a70: 2020 2020 6865 6c6c 6f5f 5445 5849 4e46 hello_TEXINF │ │ │ │ │ +00044a80: 4f53 203d 2066 646c 2e74 6578 690a 0a20 OS = fdl.texi.. │ │ │ │ │ +00044a90: 2020 4279 2064 6566 6175 6c74 2c20 4175 By default, Au │ │ │ │ │ +00044aa0: 746f 6d61 6b65 2072 6571 7569 7265 7320 tomake requires │ │ │ │ │ +00044ab0: 7468 6520 6669 6c65 2027 7465 7869 6e66 the file 'texinf │ │ │ │ │ +00044ac0: 6f2e 7465 7827 2074 6f20 6170 7065 6172 o.tex' to appear │ │ │ │ │ +00044ad0: 2069 6e20 7468 650a 7361 6d65 2064 6972 in the.same dir │ │ │ │ │ +00044ae0: 6563 746f 7279 2061 7320 7468 6520 274d ectory as the 'M │ │ │ │ │ +00044af0: 616b 6566 696c 652e 616d 2720 6669 6c65 akefile.am' file │ │ │ │ │ +00044b00: 2074 6861 7420 6c69 7374 7320 7468 6520 that lists the │ │ │ │ │ +00044b10: 272e 7465 7869 2720 6669 6c65 732e 0a49 '.texi' files..I │ │ │ │ │ +00044b20: 6620 796f 7520 7573 6564 2027 4143 5f43 f you used 'AC_C │ │ │ │ │ +00044b30: 4f4e 4649 475f 4155 585f 4449 5227 2069 ONFIG_AUX_DIR' i │ │ │ │ │ +00044b40: 6e20 2763 6f6e 6669 6775 7265 2e61 6327 n 'configure.ac' │ │ │ │ │ +00044b50: 2028 2a6e 6f74 6520 4669 6e64 696e 670a (*note Finding. │ │ │ │ │ +00044b60: 2763 6f6e 6669 6775 7265 2720 496e 7075 'configure' Inpu │ │ │ │ │ +00044b70: 743a 2028 6175 746f 636f 6e66 2949 6e70 t: (autoconf)Inp │ │ │ │ │ +00044b80: 7574 2e29 2c20 7468 656e 2027 7465 7869 ut.), then 'texi │ │ │ │ │ +00044b90: 6e66 6f2e 7465 7827 2069 7320 6c6f 6f6b nfo.tex' is look │ │ │ │ │ +00044ba0: 6564 2066 6f72 0a74 6865 7265 2e20 2049 ed for.there. I │ │ │ │ │ +00044bb0: 6e20 626f 7468 2063 6173 6573 2c20 2761 n both cases, 'a │ │ │ │ │ +00044bc0: 7574 6f6d 616b 6527 2074 6865 6e20 7375 utomake' then su │ │ │ │ │ +00044bd0: 7070 6c69 6573 2027 7465 7869 6e66 6f2e pplies 'texinfo. │ │ │ │ │ +00044be0: 7465 7827 2069 660a 272d 2d61 6464 2d6d tex' if.'--add-m │ │ │ │ │ +00044bf0: 6973 7369 6e67 2720 6973 2067 6976 656e issing' is given │ │ │ │ │ +00044c00: 2c20 616e 6420 7461 6b65 7320 6361 7265 , and takes care │ │ │ │ │ +00044c10: 206f 6620 6974 7320 6469 7374 7269 6275 of its distribu │ │ │ │ │ +00044c20: 7469 6f6e 2e20 2048 6f77 6576 6572 2c0a tion. However,. │ │ │ │ │ +00044c30: 6966 2079 6f75 2073 6574 2074 6865 2027 if you set the ' │ │ │ │ │ +00044c40: 5445 5849 4e46 4f5f 5445 5827 2076 6172 TEXINFO_TEX' var │ │ │ │ │ +00044c50: 6961 626c 6520 2873 6565 2062 656c 6f77 iable (see below │ │ │ │ │ +00044c60: 292c 2069 7420 6f76 6572 7269 6465 7320 ), it overrides │ │ │ │ │ +00044c70: 7468 650a 6c6f 6361 7469 6f6e 206f 6620 the.location of │ │ │ │ │ +00044c80: 7468 6520 6669 6c65 2061 6e64 2074 7572 the file and tur │ │ │ │ │ +00044c90: 6e73 206f 6666 2069 7473 2069 6e73 7461 ns off its insta │ │ │ │ │ +00044ca0: 6c6c 6174 696f 6e20 696e 746f 2074 6865 llation into the │ │ │ │ │ +00044cb0: 2073 6f75 7263 6520 6173 0a77 656c 6c20 source as.well │ │ │ │ │ +00044cc0: 6173 2069 7473 2064 6973 7472 6962 7574 as its distribut │ │ │ │ │ +00044cd0: 696f 6e2e 0a0a 2020 2054 6865 206f 7074 ion... The opt │ │ │ │ │ +00044ce0: 696f 6e20 276e 6f2d 7465 7869 6e66 6f2e ion 'no-texinfo. │ │ │ │ │ +00044cf0: 7465 7827 2063 616e 2062 6520 7573 6564 tex' can be used │ │ │ │ │ +00044d00: 2074 6f20 656c 696d 696e 6174 6520 7468 to eliminate th │ │ │ │ │ +00044d10: 6520 7265 7175 6972 656d 656e 740a 666f e requirement.fo │ │ │ │ │ +00044d20: 7220 7468 6520 6669 6c65 2027 7465 7869 r the file 'texi │ │ │ │ │ +00044d30: 6e66 6f2e 7465 7827 2e20 2055 7365 206f nfo.tex'. Use o │ │ │ │ │ +00044d40: 6620 7468 6520 7661 7269 6162 6c65 2027 f the variable ' │ │ │ │ │ +00044d50: 5445 5849 4e46 4f5f 5445 5827 2069 730a TEXINFO_TEX' is. │ │ │ │ │ +00044d60: 7072 6566 6572 6162 6c65 2c20 686f 7765 preferable, howe │ │ │ │ │ +00044d70: 7665 722c 2062 6563 6175 7365 2074 6861 ver, because tha │ │ │ │ │ +00044d80: 7420 616c 6c6f 7773 2074 6865 2027 6476 t allows the 'dv │ │ │ │ │ +00044d90: 6927 2c20 2770 7327 2c20 616e 6420 2770 i', 'ps', and 'p │ │ │ │ │ +00044da0: 6466 270a 7461 7267 6574 7320 746f 2073 df'.targets to s │ │ │ │ │ +00044db0: 7469 6c6c 2077 6f72 6b2e 0a0a 2020 2041 till work... A │ │ │ │ │ +00044dc0: 7574 6f6d 616b 6520 6765 6e65 7261 7465 utomake generate │ │ │ │ │ +00044dd0: 7320 616e 2027 696e 7374 616c 6c2d 696e s an 'install-in │ │ │ │ │ +00044de0: 666f 2720 7275 6c65 3b20 736f 6d65 2070 fo' rule; some p │ │ │ │ │ +00044df0: 656f 706c 6520 6170 7061 7265 6e74 6c79 eople apparently │ │ │ │ │ +00044e00: 2075 7365 0a74 6869 732e 2020 4279 2064 use.this. By d │ │ │ │ │ +00044e10: 6566 6175 6c74 2c20 696e 666f 2070 6167 efault, info pag │ │ │ │ │ +00044e20: 6573 2061 7265 2069 6e73 7461 6c6c 6564 es are installed │ │ │ │ │ +00044e30: 2062 7920 276d 616b 6520 696e 7374 616c by 'make instal │ │ │ │ │ +00044e40: 6c27 2c20 736f 0a72 756e 6e69 6e67 2027 l', so.running ' │ │ │ │ │ +00044e50: 6d61 6b65 2069 6e73 7461 6c6c 2d69 6e66 make install-inf │ │ │ │ │ +00044e60: 6f27 2069 7320 706f 696e 746c 6573 732e o' is pointless. │ │ │ │ │ +00044e70: 2020 5468 6973 2063 616e 2062 6520 7072 This can be pr │ │ │ │ │ +00044e80: 6576 656e 7465 6420 7669 6120 7468 650a evented via the. │ │ │ │ │ +00044e90: 276e 6f2d 696e 7374 616c 6c69 6e66 6f27 'no-installinfo' │ │ │ │ │ +00044ea0: 206f 7074 696f 6e2e 2020 496e 2074 6869 option. In thi │ │ │ │ │ +00044eb0: 7320 6361 7365 2c20 272e 696e 666f 2720 s case, '.info' │ │ │ │ │ +00044ec0: 6669 6c65 7320 6172 6520 6e6f 7420 696e files are not in │ │ │ │ │ +00044ed0: 7374 616c 6c65 640a 6279 2064 6566 6175 stalled.by defau │ │ │ │ │ +00044ee0: 6c74 2c20 616e 6420 7573 6572 206d 7573 lt, and user mus │ │ │ │ │ +00044ef0: 7420 7265 7175 6573 7420 7468 6973 2065 t request this e │ │ │ │ │ +00044f00: 7870 6c69 6369 746c 7920 7573 696e 6720 xplicitly using │ │ │ │ │ +00044f10: 276d 616b 650a 696e 7374 616c 6c2d 696e 'make.install-in │ │ │ │ │ +00044f20: 666f 272e 0a0a 2020 2042 7920 6465 6661 fo'... By defa │ │ │ │ │ +00044f30: 756c 742c 2027 6d61 6b65 2069 6e73 7461 ult, 'make insta │ │ │ │ │ +00044f40: 6c6c 2d69 6e66 6f27 2061 6e64 2027 6d61 ll-info' and 'ma │ │ │ │ │ +00044f50: 6b65 2069 6e73 7461 6c6c 2d69 6e66 6f27 ke install-info' │ │ │ │ │ +00044f60: 2077 696c 6c20 7472 7920 746f 0a72 756e will try to.run │ │ │ │ │ +00044f70: 2074 6865 2027 696e 7374 616c 6c2d 696e the 'install-in │ │ │ │ │ +00044f80: 666f 2720 7072 6f67 7261 6d20 2869 6620 fo' program (if │ │ │ │ │ +00044f90: 6176 6169 6c61 626c 6529 2074 6f20 7570 available) to up │ │ │ │ │ +00044fa0: 6461 7465 2028 6f72 2063 7265 6174 6529 date (or create) │ │ │ │ │ +00044fb0: 2074 6865 0a27 247b 696e 666f 6469 727d the.'${infodir} │ │ │ │ │ +00044fc0: 2f64 6972 2720 696e 6465 782e 2020 4966 /dir' index. If │ │ │ │ │ +00044fd0: 2074 6869 7320 6973 2075 6e64 6573 6972 this is undesir │ │ │ │ │ +00044fe0: 6564 2c20 6974 2063 616e 2062 6520 7072 ed, it can be pr │ │ │ │ │ +00044ff0: 6576 656e 7465 6420 6279 0a65 7870 6f72 evented by.expor │ │ │ │ │ +00045000: 7469 6e67 2074 6865 2027 414d 5f55 5044 ting the 'AM_UPD │ │ │ │ │ +00045010: 4154 455f 494e 464f 5f44 4952 2720 7661 ATE_INFO_DIR' va │ │ │ │ │ +00045020: 7269 6162 6c65 2074 6f20 2227 6e6f 2722 riable to "'no'" │ │ │ │ │ +00045030: 2e0a 0a20 2020 5468 6520 666f 6c6c 6f77 ... The follow │ │ │ │ │ +00045040: 696e 6720 7661 7269 6162 6c65 7320 6172 ing variables ar │ │ │ │ │ +00045050: 6520 7573 6564 2062 7920 7468 6520 5465 e used by the Te │ │ │ │ │ +00045060: 7869 6e66 6f20 6275 696c 6420 7275 6c65 xinfo build rule │ │ │ │ │ +00045070: 732e 0a0a 274d 414b 4549 4e46 4f27 0a20 s...'MAKEINFO'. │ │ │ │ │ +00045080: 2020 2020 5468 6520 6e61 6d65 206f 6620 The name of │ │ │ │ │ +00045090: 7468 6520 7072 6f67 7261 6d20 696e 766f the program invo │ │ │ │ │ +000450a0: 6b65 6420 746f 2062 7569 6c64 2027 2e69 ked to build '.i │ │ │ │ │ +000450b0: 6e66 6f27 2066 696c 6573 2e20 2054 6869 nfo' files. Thi │ │ │ │ │ +000450c0: 730a 2020 2020 2076 6172 6961 626c 6520 s. variable │ │ │ │ │ +000450d0: 6973 2064 6566 696e 6564 2062 7920 4175 is defined by Au │ │ │ │ │ +000450e0: 746f 6d61 6b65 2e20 2049 6620 7468 6520 tomake. If the │ │ │ │ │ +000450f0: 276d 616b 6569 6e66 6f27 2070 726f 6772 'makeinfo' progr │ │ │ │ │ +00045100: 616d 2069 730a 2020 2020 2066 6f75 6e64 am is. found │ │ │ │ │ +00045110: 206f 6e20 7468 6520 7379 7374 656d 2074 on the system t │ │ │ │ │ +00045120: 6865 6e20 6974 2077 696c 6c20 6265 2075 hen it will be u │ │ │ │ │ +00045130: 7365 6420 6279 2064 6566 6175 6c74 3b20 sed by default; │ │ │ │ │ +00045140: 6f74 6865 7277 6973 650a 2020 2020 2027 otherwise. ' │ │ │ │ │ +00045150: 6d69 7373 696e 6727 2077 696c 6c20 6265 missing' will be │ │ │ │ │ +00045160: 2075 7365 6420 696e 7374 6561 642e 0a0a used instead... │ │ │ │ │ +00045170: 274d 414b 4549 4e46 4f48 544d 4c27 0a20 'MAKEINFOHTML'. │ │ │ │ │ +00045180: 2020 2020 5468 6520 636f 6d6d 616e 6420 The command │ │ │ │ │ +00045190: 696e 766f 6b65 6420 746f 2062 7569 6c64 invoked to build │ │ │ │ │ +000451a0: 2027 2e68 746d 6c27 2066 696c 6573 2e20 '.html' files. │ │ │ │ │ +000451b0: 2041 7574 6f6d 616b 6520 6465 6669 6e65 Automake define │ │ │ │ │ +000451c0: 7320 7468 6973 0a20 2020 2020 746f 2027 s this. to ' │ │ │ │ │ +000451d0: 2428 4d41 4b45 494e 464f 2920 2d2d 6874 $(MAKEINFO) --ht │ │ │ │ │ +000451e0: 6d6c 272e 0a0a 274d 414b 4549 4e46 4f46 ml'...'MAKEINFOF │ │ │ │ │ +000451f0: 4c41 4753 270a 2020 2020 2055 7365 7220 LAGS'. User │ │ │ │ │ +00045200: 666c 6167 7320 7061 7373 6564 2074 6f20 flags passed to │ │ │ │ │ +00045210: 6561 6368 2069 6e76 6f63 6174 696f 6e20 each invocation │ │ │ │ │ +00045220: 6f66 2027 2428 4d41 4b45 494e 464f 2927 of '$(MAKEINFO)' │ │ │ │ │ +00045230: 2061 6e64 0a20 2020 2020 2724 284d 414b and. '$(MAK │ │ │ │ │ +00045240: 4549 4e46 4f48 544d 4c29 272e 2020 5468 EINFOHTML)'. Th │ │ │ │ │ +00045250: 6973 2075 7365 7220 7661 7269 6162 6c65 is user variable │ │ │ │ │ +00045260: 2028 2a6e 6f74 6520 5573 6572 2056 6172 (*note User Var │ │ │ │ │ +00045270: 6961 626c 6573 3a3a 2920 6973 0a20 2020 iables::) is. │ │ │ │ │ +00045280: 2020 6e6f 7420 6578 7065 6374 6564 2074 not expected t │ │ │ │ │ +00045290: 6f20 6265 2064 6566 696e 6564 2069 6e20 o be defined in │ │ │ │ │ +000452a0: 616e 7920 274d 616b 6566 696c 6527 3b20 any 'Makefile'; │ │ │ │ │ +000452b0: 6974 2063 616e 2062 6520 7573 6564 2062 it can be used b │ │ │ │ │ +000452c0: 790a 2020 2020 2075 7365 7273 2074 6f20 y. users to │ │ │ │ │ +000452d0: 7061 7373 2065 7874 7261 2066 6c61 6773 pass extra flags │ │ │ │ │ +000452e0: 2074 6f20 7375 6974 2074 6865 6972 206e to suit their n │ │ │ │ │ +000452f0: 6565 6473 2e0a 0a27 414d 5f4d 414b 4549 eeds...'AM_MAKEI │ │ │ │ │ +00045300: 4e46 4f46 4c41 4753 270a 2741 4d5f 4d41 NFOFLAGS'.'AM_MA │ │ │ │ │ +00045310: 4b45 494e 464f 4854 4d4c 464c 4147 5327 KEINFOHTMLFLAGS' │ │ │ │ │ +00045320: 0a20 2020 2020 4d61 696e 7461 696e 6572 . Maintainer │ │ │ │ │ +00045330: 2066 6c61 6773 2070 6173 7365 6420 746f flags passed to │ │ │ │ │ +00045340: 2065 6163 6820 276d 616b 6569 6e66 6f27 each 'makeinfo' │ │ │ │ │ +00045350: 2069 6e76 6f63 6174 696f 6e2e 2020 556e invocation. Un │ │ │ │ │ +00045360: 6c69 6b65 0a20 2020 2020 274d 414b 4549 like. 'MAKEI │ │ │ │ │ +00045370: 4e46 4f46 4c41 4753 272c 2074 6865 7365 NFOFLAGS', these │ │ │ │ │ +00045380: 2076 6172 6961 626c 6573 2061 7265 206d variables are m │ │ │ │ │ +00045390: 6561 6e74 2074 6f20 6265 2064 6566 696e eant to be defin │ │ │ │ │ +000453a0: 6564 2062 790a 2020 2020 206d 6169 6e74 ed by. maint │ │ │ │ │ +000453b0: 6169 6e65 7273 2069 6e20 274d 616b 6566 ainers in 'Makef │ │ │ │ │ +000453c0: 696c 652e 616d 272e 2020 2724 2841 4d5f ile.am'. '$(AM_ │ │ │ │ │ +000453d0: 4d41 4b45 494e 464f 464c 4147 5329 2720 MAKEINFOFLAGS)' │ │ │ │ │ +000453e0: 6973 2070 6173 7365 6420 746f 0a20 2020 is passed to. │ │ │ │ │ +000453f0: 2020 276d 616b 6569 6e66 6f27 2077 6865 'makeinfo' whe │ │ │ │ │ +00045400: 6e20 6275 696c 6469 6e67 2027 2e69 6e66 n building '.inf │ │ │ │ │ +00045410: 6f27 2066 696c 6573 3b20 616e 640a 2020 o' files; and. │ │ │ │ │ +00045420: 2020 2027 2428 414d 5f4d 414b 4549 4e46 '$(AM_MAKEINF │ │ │ │ │ +00045430: 4f48 544d 4c46 4c41 4753 2927 2069 7320 OHTMLFLAGS)' is │ │ │ │ │ +00045440: 7573 6564 2077 6865 6e20 6275 696c 6469 used when buildi │ │ │ │ │ +00045450: 6e67 2027 2e68 746d 6c27 2066 696c 6573 ng '.html' files │ │ │ │ │ +00045460: 2e0a 0a20 2020 2020 466f 7220 696e 7374 ... For inst │ │ │ │ │ +00045470: 616e 6365 2c20 7468 6520 666f 6c6c 6f77 ance, the follow │ │ │ │ │ +00045480: 696e 6720 7365 7474 696e 6720 6361 6e20 ing setting can │ │ │ │ │ +00045490: 6265 2075 7365 6420 746f 206f 6274 6169 be used to obtai │ │ │ │ │ +000454a0: 6e20 6f6e 650a 2020 2020 2073 696e 676c n one. singl │ │ │ │ │ +000454b0: 6520 272e 6874 6d6c 2720 6669 6c65 2070 e '.html' file p │ │ │ │ │ +000454c0: 6572 206d 616e 7561 6c2c 2077 6974 686f er manual, witho │ │ │ │ │ +000454d0: 7574 206e 6f64 6520 7365 7061 7261 746f ut node separato │ │ │ │ │ +000454e0: 7273 2e0a 2020 2020 2020 2020 2020 414d rs.. AM │ │ │ │ │ +000454f0: 5f4d 414b 4549 4e46 4f48 544d 4c46 4c41 _MAKEINFOHTMLFLA │ │ │ │ │ +00045500: 4753 203d 202d 2d6e 6f2d 6865 6164 6572 GS = --no-header │ │ │ │ │ +00045510: 7320 2d2d 6e6f 2d73 706c 6974 0a0a 2020 s --no-split.. │ │ │ │ │ +00045520: 2020 2027 414d 5f4d 414b 4549 4e46 4f48 'AM_MAKEINFOH │ │ │ │ │ +00045530: 544d 4c46 4c41 4753 2720 6465 6661 756c TMLFLAGS' defaul │ │ │ │ │ +00045540: 7473 2074 6f20 2724 2841 4d5f 4d41 4b45 ts to '$(AM_MAKE │ │ │ │ │ +00045550: 494e 464f 464c 4147 5329 272e 2020 5468 INFOFLAGS)'. Th │ │ │ │ │ +00045560: 6973 0a20 2020 2020 6d65 616e 7320 7468 is. means th │ │ │ │ │ +00045570: 6174 2064 6566 696e 696e 6720 2741 4d5f at defining 'AM_ │ │ │ │ │ +00045580: 4d41 4b45 494e 464f 464c 4147 5327 2077 MAKEINFOFLAGS' w │ │ │ │ │ +00045590: 6974 686f 7574 2064 6566 696e 696e 670a ithout defining. │ │ │ │ │ +000455a0: 2020 2020 2027 414d 5f4d 414b 4549 4e46 'AM_MAKEINF │ │ │ │ │ +000455b0: 4f48 544d 4c46 4c41 4753 2720 7769 6c6c OHTMLFLAGS' will │ │ │ │ │ +000455c0: 2069 6d70 6163 7420 6275 696c 6473 206f impact builds o │ │ │ │ │ +000455d0: 6620 626f 7468 2027 2e69 6e66 6f27 2061 f both '.info' a │ │ │ │ │ +000455e0: 6e64 0a20 2020 2020 272e 6874 6d6c 2720 nd. '.html' │ │ │ │ │ +000455f0: 6669 6c65 732e 0a0a 2754 4558 4932 4456 files...'TEXI2DV │ │ │ │ │ +00045600: 4927 0a20 2020 2020 5468 6520 6e61 6d65 I'. The name │ │ │ │ │ +00045610: 206f 6620 7468 6520 636f 6d6d 616e 6420 of the command │ │ │ │ │ +00045620: 7468 6174 2063 6f6e 7665 7274 7320 6120 that converts a │ │ │ │ │ +00045630: 272e 7465 7869 2720 6669 6c65 2069 6e74 '.texi' file int │ │ │ │ │ +00045640: 6f20 6120 272e 6476 6927 0a20 2020 2020 o a '.dvi'. │ │ │ │ │ +00045650: 6669 6c65 2e20 2054 6869 7320 6465 6661 file. This defa │ │ │ │ │ +00045660: 756c 7473 2074 6f20 2774 6578 6932 6476 ults to 'texi2dv │ │ │ │ │ +00045670: 6927 2c20 6120 7363 7269 7074 2074 6861 i', a script tha │ │ │ │ │ +00045680: 7420 7368 6970 7320 7769 7468 2074 6865 t ships with the │ │ │ │ │ +00045690: 0a20 2020 2020 5465 7869 6e66 6f20 7061 . Texinfo pa │ │ │ │ │ +000456a0: 636b 6167 652e 0a0a 2754 4558 4932 5044 ckage...'TEXI2PD │ │ │ │ │ +000456b0: 4627 0a20 2020 2020 5468 6520 6e61 6d65 F'. The name │ │ │ │ │ +000456c0: 206f 6620 7468 6520 636f 6d6d 616e 6420 of the command │ │ │ │ │ +000456d0: 7468 6174 2074 7261 6e73 6c61 7465 7320 that translates │ │ │ │ │ +000456e0: 6120 272e 7465 7869 2720 6669 6c65 2069 a '.texi' file i │ │ │ │ │ +000456f0: 6e74 6f20 610a 2020 2020 2027 2e70 6466 nto a. '.pdf │ │ │ │ │ +00045700: 2720 6669 6c65 2e20 2054 6869 7320 6465 ' file. This de │ │ │ │ │ +00045710: 6661 756c 7473 2074 6f20 2724 2854 4558 faults to '$(TEX │ │ │ │ │ +00045720: 4932 4456 4929 202d 2d70 6466 202d 2d62 I2DVI) --pdf --b │ │ │ │ │ +00045730: 6174 6368 272e 0a0a 2744 5649 5053 270a atch'...'DVIPS'. │ │ │ │ │ +00045740: 2020 2020 2054 6865 206e 616d 6520 6f66 The name of │ │ │ │ │ +00045750: 2074 6865 2063 6f6d 6d61 6e64 2074 6861 the command tha │ │ │ │ │ +00045760: 7420 6275 696c 6473 2061 2027 2e70 7327 t builds a '.ps' │ │ │ │ │ +00045770: 2066 696c 6520 6f75 7420 6f66 2061 2027 file out of a ' │ │ │ │ │ +00045780: 2e64 7669 270a 2020 2020 2066 696c 652e .dvi'. file. │ │ │ │ │ +00045790: 2020 5468 6973 2064 6566 6175 6c74 7320 This defaults │ │ │ │ │ +000457a0: 746f 2027 6476 6970 7327 2e0a 0a27 5445 to 'dvips'...'TE │ │ │ │ │ +000457b0: 5849 4e46 4f5f 5445 5827 0a0a 2020 2020 XINFO_TEX'.. │ │ │ │ │ +000457c0: 2049 6620 796f 7572 2070 6163 6b61 6765 If your package │ │ │ │ │ +000457d0: 2068 6173 2054 6578 696e 666f 2066 696c has Texinfo fil │ │ │ │ │ +000457e0: 6573 2069 6e20 6d61 6e79 2064 6972 6563 es in many direc │ │ │ │ │ +000457f0: 746f 7269 6573 2c20 796f 7520 6361 6e20 tories, you can │ │ │ │ │ +00045800: 7573 650a 2020 2020 2074 6865 2076 6172 use. the var │ │ │ │ │ +00045810: 6961 626c 6520 2754 4558 494e 464f 5f54 iable 'TEXINFO_T │ │ │ │ │ +00045820: 4558 2720 746f 2074 656c 6c20 4175 746f EX' to tell Auto │ │ │ │ │ +00045830: 6d61 6b65 2077 6865 7265 2074 6f20 6669 make where to fi │ │ │ │ │ +00045840: 6e64 2074 6865 0a20 2020 2020 6361 6e6f nd the. cano │ │ │ │ │ +00045850: 6e69 6361 6c20 2774 6578 696e 666f 2e74 nical 'texinfo.t │ │ │ │ │ +00045860: 6578 2720 666f 7220 796f 7572 2070 6163 ex' for your pac │ │ │ │ │ +00045870: 6b61 6765 2e20 2054 6865 2076 616c 7565 kage. The value │ │ │ │ │ +00045880: 206f 6620 7468 6973 0a20 2020 2020 7661 of this. va │ │ │ │ │ +00045890: 7269 6162 6c65 2073 686f 756c 6420 6265 riable should be │ │ │ │ │ +000458a0: 2074 6865 2072 656c 6174 6976 6520 7061 the relative pa │ │ │ │ │ +000458b0: 7468 2066 726f 6d20 7468 6520 6375 7272 th from the curr │ │ │ │ │ +000458c0: 656e 7420 274d 616b 6566 696c 652e 616d ent 'Makefile.am │ │ │ │ │ +000458d0: 270a 2020 2020 2074 6f20 2774 6578 696e '. to 'texin │ │ │ │ │ +000458e0: 666f 2e74 6578 273a 0a0a 2020 2020 2020 fo.tex':.. │ │ │ │ │ +000458f0: 2020 2020 5445 5849 4e46 4f5f 5445 5820 TEXINFO_TEX │ │ │ │ │ +00045900: 3d20 2e2e 2f64 6f63 2f74 6578 696e 666f = ../doc/texinfo │ │ │ │ │ +00045910: 2e74 6578 0a0a 1f0a 4669 6c65 3a20 6175 .tex....File: au │ │ │ │ │ +00045920: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00045930: 2c20 204e 6f64 653a 204d 616e 2050 6167 , Node: Man Pag │ │ │ │ │ +00045940: 6573 2c20 2050 7265 763a 2054 6578 696e es, Prev: Texin │ │ │ │ │ +00045950: 666f 2c20 2055 703a 2044 6f63 756d 656e fo, Up: Documen │ │ │ │ │ +00045960: 7461 7469 6f6e 0a0a 3131 2e32 204d 616e tation..11.2 Man │ │ │ │ │ +00045970: 2050 6167 6573 0a3d 3d3d 3d3d 3d3d 3d3d Pages.========= │ │ │ │ │ +00045980: 3d3d 3d3d 3d0a 0a41 2070 6163 6b61 6765 =====..A package │ │ │ │ │ +00045990: 2063 616e 2061 6c73 6f20 696e 636c 7564 can also includ │ │ │ │ │ +000459a0: 6520 6d61 6e20 7061 6765 7320 2862 7574 e man pages (but │ │ │ │ │ +000459b0: 2073 6565 2074 6865 2047 4e55 2073 7461 see the GNU sta │ │ │ │ │ +000459c0: 6e64 6172 6473 206f 6e20 7468 6973 0a6d ndards on this.m │ │ │ │ │ +000459d0: 6174 7465 722c 202a 6e6f 7465 2028 7374 atter, *note (st │ │ │ │ │ +000459e0: 616e 6461 7264 7329 4d61 6e20 5061 6765 andards)Man Page │ │ │ │ │ +000459f0: 733a 3a2e 2920 204d 616e 2070 6167 6573 s::.) Man pages │ │ │ │ │ +00045a00: 2061 7265 2064 6563 6c61 7265 6420 7573 are declared us │ │ │ │ │ +00045a10: 696e 6720 7468 650a 274d 414e 5327 2070 ing the.'MANS' p │ │ │ │ │ +00045a20: 7269 6d61 7279 2e20 2047 656e 6572 616c rimary. General │ │ │ │ │ +00045a30: 6c79 2074 6865 2027 6d61 6e5f 4d41 4e53 ly the 'man_MANS │ │ │ │ │ +00045a40: 2720 7661 7269 6162 6c65 2069 7320 7573 ' variable is us │ │ │ │ │ +00045a50: 6564 2e20 204d 616e 2070 6167 6573 0a61 ed. Man pages.a │ │ │ │ │ +00045a60: 7265 2061 7574 6f6d 6174 6963 616c 6c79 re automatically │ │ │ │ │ +00045a70: 2069 6e73 7461 6c6c 6564 2069 6e20 7468 installed in th │ │ │ │ │ +00045a80: 6520 636f 7272 6563 7420 7375 6264 6972 e correct subdir │ │ │ │ │ +00045a90: 6563 746f 7279 206f 6620 276d 616e 6469 ectory of 'mandi │ │ │ │ │ +00045aa0: 7227 2c0a 6261 7365 6420 6f6e 2074 6865 r',.based on the │ │ │ │ │ +00045ab0: 2066 696c 6520 6578 7465 6e73 696f 6e2e file extension. │ │ │ │ │ +00045ac0: 0a0a 2020 2046 696c 6520 6578 7465 6e73 .. File extens │ │ │ │ │ +00045ad0: 696f 6e73 2073 7563 6820 6173 2027 2e31 ions such as '.1 │ │ │ │ │ +00045ae0: 6327 2061 7265 2068 616e 646c 6564 2062 c' are handled b │ │ │ │ │ +00045af0: 7920 6c6f 6f6b 696e 6720 666f 7220 7468 y looking for th │ │ │ │ │ +00045b00: 6520 7661 6c69 640a 7061 7274 206f 6620 e valid.part of │ │ │ │ │ +00045b10: 7468 6520 6578 7465 6e73 696f 6e20 616e the extension an │ │ │ │ │ +00045b20: 6420 7573 696e 6720 7468 6174 2074 6f20 d using that to │ │ │ │ │ +00045b30: 6465 7465 726d 696e 6520 7468 6520 636f determine the co │ │ │ │ │ +00045b40: 7272 6563 740a 7375 6264 6972 6563 746f rrect.subdirecto │ │ │ │ │ +00045b50: 7279 206f 6620 276d 616e 6469 7227 2e20 ry of 'mandir'. │ │ │ │ │ +00045b60: 2056 616c 6964 2073 6563 7469 6f6e 206e Valid section n │ │ │ │ │ +00045b70: 616d 6573 2061 7265 2074 6865 2064 6967 ames are the dig │ │ │ │ │ +00045b80: 6974 7320 2730 270a 7468 726f 7567 6820 its '0'.through │ │ │ │ │ +00045b90: 2739 272c 2061 6e64 2074 6865 206c 6574 '9', and the let │ │ │ │ │ +00045ba0: 7465 7273 2027 6c27 2061 6e64 2027 6e27 ters 'l' and 'n' │ │ │ │ │ +00045bb0: 2e0a 0a20 2020 536f 6d65 7469 6d65 7320 ... Sometimes │ │ │ │ │ +00045bc0: 6465 7665 6c6f 7065 7273 2070 7265 6665 developers prefe │ │ │ │ │ +00045bd0: 7220 746f 206e 616d 6520 6120 6d61 6e20 r to name a man │ │ │ │ │ +00045be0: 7061 6765 2073 6f6d 6574 6869 6e67 206c page something l │ │ │ │ │ +00045bf0: 696b 650a 2766 6f6f 2e6d 616e 2720 696e ike.'foo.man' in │ │ │ │ │ +00045c00: 2074 6865 2073 6f75 7263 652c 2061 6e64 the source, and │ │ │ │ │ +00045c10: 2074 6865 6e20 7265 6e61 6d65 2069 7420 then rename it │ │ │ │ │ +00045c20: 746f 2068 6176 6520 7468 6520 636f 7272 to have the corr │ │ │ │ │ +00045c30: 6563 7420 7375 6666 6978 2c0a 666f 7220 ect suffix,.for │ │ │ │ │ +00045c40: 6578 616d 706c 6520 2766 6f6f 2e31 272c example 'foo.1', │ │ │ │ │ +00045c50: 2077 6865 6e20 696e 7374 616c 6c69 6e67 when installing │ │ │ │ │ +00045c60: 2074 6865 2066 696c 652e 2020 4175 746f the file. Auto │ │ │ │ │ +00045c70: 6d61 6b65 2061 6c73 6f20 7375 7070 6f72 make also suppor │ │ │ │ │ +00045c80: 7473 0a74 6869 7320 6d6f 6465 2e20 2046 ts.this mode. F │ │ │ │ │ +00045c90: 6f72 2061 2076 616c 6964 2073 6563 7469 or a valid secti │ │ │ │ │ +00045ca0: 6f6e 206e 616d 6564 2053 4543 5449 4f4e on named SECTION │ │ │ │ │ +00045cb0: 2c20 7468 6572 6520 6973 2061 2063 6f72 , there is a cor │ │ │ │ │ +00045cc0: 7265 7370 6f6e 6469 6e67 0a64 6972 6563 responding.direc │ │ │ │ │ +00045cd0: 746f 7279 206e 616d 6564 2027 6d61 6e53 tory named 'manS │ │ │ │ │ +00045ce0: 4543 5449 4f4e 6469 7227 2c20 616e 6420 ECTIONdir', and │ │ │ │ │ +00045cf0: 6120 636f 7272 6573 706f 6e64 696e 6720 a corresponding │ │ │ │ │ +00045d00: 275f 4d41 4e53 2720 7661 7269 6162 6c65 '_MANS' variable │ │ │ │ │ +00045d10: 2e0a 4669 6c65 7320 6c69 7374 6564 2069 ..Files listed i │ │ │ │ │ +00045d20: 6e20 7375 6368 2061 2076 6172 6961 626c n such a variabl │ │ │ │ │ +00045d30: 6520 6172 6520 696e 7374 616c 6c65 6420 e are installed │ │ │ │ │ +00045d40: 696e 2074 6865 2069 6e64 6963 6174 6564 in the indicated │ │ │ │ │ +00045d50: 2073 6563 7469 6f6e 2e0a 4966 2074 6865 section..If the │ │ │ │ │ +00045d60: 2066 696c 6520 616c 7265 6164 7920 6861 file already ha │ │ │ │ │ +00045d70: 7320 6120 7661 6c69 6420 7375 6666 6978 s a valid suffix │ │ │ │ │ +00045d80: 2c20 7468 656e 2069 7420 6973 2069 6e73 , then it is ins │ │ │ │ │ +00045d90: 7461 6c6c 6564 2061 732d 6973 3b0a 6f74 talled as-is;.ot │ │ │ │ │ +00045da0: 6865 7277 6973 6520 7468 6520 6669 6c65 herwise the file │ │ │ │ │ +00045db0: 2073 7566 6669 7820 6973 2063 6861 6e67 suffix is chang │ │ │ │ │ +00045dc0: 6564 2074 6f20 6d61 7463 6820 7468 6520 ed to match the │ │ │ │ │ +00045dd0: 7365 6374 696f 6e2e 0a0a 2020 2046 6f72 section... For │ │ │ │ │ +00045de0: 2069 6e73 7461 6e63 652c 2063 6f6e 7369 instance, consi │ │ │ │ │ +00045df0: 6465 7220 7468 6973 2065 7861 6d70 6c65 der this example │ │ │ │ │ +00045e00: 3a0a 2020 2020 206d 616e 315f 4d41 4e53 :. man1_MANS │ │ │ │ │ +00045e10: 203d 2072 656e 616d 652e 6d61 6e20 7468 = rename.man th │ │ │ │ │ +00045e20: 6573 616d 652e 3120 616c 736f 7468 6573 esame.1 alsothes │ │ │ │ │ +00045e30: 616d 652e 3163 0a0a 496e 2074 6869 7320 ame.1c..In this │ │ │ │ │ +00045e40: 6361 7365 2c20 2772 656e 616d 652e 6d61 case, 'rename.ma │ │ │ │ │ +00045e50: 6e27 2077 696c 6c20 6265 2072 656e 616d n' will be renam │ │ │ │ │ +00045e60: 6564 2074 6f20 2772 656e 616d 652e 3127 ed to 'rename.1' │ │ │ │ │ +00045e70: 2077 6865 6e20 696e 7374 616c 6c65 642c when installed, │ │ │ │ │ +00045e80: 0a62 7574 2074 6865 206f 7468 6572 2066 .but the other f │ │ │ │ │ +00045e90: 696c 6573 2077 696c 6c20 6b65 6570 2074 iles will keep t │ │ │ │ │ +00045ea0: 6865 6972 206e 616d 6573 2e0a 0a20 2020 heir names... │ │ │ │ │ +00045eb0: 4279 2064 6566 6175 6c74 2c20 6d61 6e20 By default, man │ │ │ │ │ +00045ec0: 7061 6765 7320 6172 6520 696e 7374 616c pages are instal │ │ │ │ │ +00045ed0: 6c65 6420 6279 2027 6d61 6b65 2069 6e73 led by 'make ins │ │ │ │ │ +00045ee0: 7461 6c6c 272e 2020 486f 7765 7665 722c tall'. However, │ │ │ │ │ +00045ef0: 0a73 696e 6365 2074 6865 2047 4e55 2070 .since the GNU p │ │ │ │ │ +00045f00: 726f 6a65 6374 2064 6f65 7320 6e6f 7420 roject does not │ │ │ │ │ +00045f10: 7265 7175 6972 6520 6d61 6e20 7061 6765 require man page │ │ │ │ │ +00045f20: 732c 206d 616e 7920 6d61 696e 7461 696e s, many maintain │ │ │ │ │ +00045f30: 6572 7320 646f 0a6e 6f74 2065 7870 656e ers do.not expen │ │ │ │ │ +00045f40: 6420 6566 666f 7274 2074 6f20 6b65 6570 d effort to keep │ │ │ │ │ +00045f50: 2074 6865 206d 616e 2070 6167 6573 2075 the man pages u │ │ │ │ │ +00045f60: 7020 746f 2064 6174 652e 2020 496e 2074 p to date. In t │ │ │ │ │ +00045f70: 6865 7365 2063 6173 6573 2c20 7468 650a hese cases, the. │ │ │ │ │ +00045f80: 276e 6f2d 696e 7374 616c 6c6d 616e 2720 'no-installman' │ │ │ │ │ +00045f90: 6f70 7469 6f6e 2077 696c 6c20 7072 6576 option will prev │ │ │ │ │ +00045fa0: 656e 7420 7468 6520 6d61 6e20 7061 6765 ent the man page │ │ │ │ │ +00045fb0: 7320 6672 6f6d 2062 6569 6e67 2069 6e73 s from being ins │ │ │ │ │ +00045fc0: 7461 6c6c 6564 0a62 7920 6465 6661 756c talled.by defaul │ │ │ │ │ +00045fd0: 742e 2020 5468 6520 7573 6572 2063 616e t. The user can │ │ │ │ │ +00045fe0: 2073 7469 6c6c 2065 7870 6c69 6369 746c still explicitl │ │ │ │ │ +00045ff0: 7920 696e 7374 616c 6c20 7468 656d 2076 y install them v │ │ │ │ │ +00046000: 6961 2027 6d61 6b65 0a69 6e73 7461 6c6c ia 'make.install │ │ │ │ │ +00046010: 2d6d 616e 272e 0a0a 2020 2046 6f72 2066 -man'... For f │ │ │ │ │ +00046020: 6173 7420 696e 7374 616c 6c61 7469 6f6e ast installation │ │ │ │ │ +00046030: 2c20 7769 7468 206d 616e 7920 6669 6c65 , with many file │ │ │ │ │ +00046040: 7320 6974 2069 7320 7072 6566 6572 6162 s it is preferab │ │ │ │ │ +00046050: 6c65 2074 6f20 7573 650a 276d 616e 5345 le to use.'manSE │ │ │ │ │ +00046060: 4354 494f 4e5f 4d41 4e53 2720 6f76 6572 CTION_MANS' over │ │ │ │ │ +00046070: 2027 6d61 6e5f 4d41 4e53 2720 6173 2077 'man_MANS' as w │ │ │ │ │ +00046080: 656c 6c20 6173 2066 696c 6573 2074 6861 ell as files tha │ │ │ │ │ +00046090: 7420 646f 206e 6f74 206e 6565 6420 746f t do not need to │ │ │ │ │ +000460a0: 0a62 6520 7265 6e61 6d65 642e 0a0a 2020 .be renamed... │ │ │ │ │ +000460b0: 204d 616e 2070 6167 6573 2061 7265 206e Man pages are n │ │ │ │ │ +000460c0: 6f74 2063 7572 7265 6e74 6c79 2063 6f6e ot currently con │ │ │ │ │ +000460d0: 7369 6465 7265 6420 746f 2062 6520 736f sidered to be so │ │ │ │ │ +000460e0: 7572 6365 2c20 6265 6361 7573 6520 6974 urce, because it │ │ │ │ │ +000460f0: 2069 730a 6e6f 7420 756e 636f 6d6d 6f6e is.not uncommon │ │ │ │ │ +00046100: 2066 6f72 206d 616e 2070 6167 6573 2074 for man pages t │ │ │ │ │ +00046110: 6f20 6265 2061 7574 6f6d 6174 6963 616c o be automatical │ │ │ │ │ +00046120: 6c79 2067 656e 6572 6174 6564 2e20 2054 ly generated. T │ │ │ │ │ +00046130: 6865 7265 666f 7265 0a74 6865 7920 6172 herefore.they ar │ │ │ │ │ +00046140: 6520 6e6f 7420 6175 746f 6d61 7469 6361 e not automatica │ │ │ │ │ +00046150: 6c6c 7920 696e 636c 7564 6564 2069 6e20 lly included in │ │ │ │ │ +00046160: 7468 6520 6469 7374 7269 6275 7469 6f6e the distribution │ │ │ │ │ +00046170: 2e20 2048 6f77 6576 6572 2c20 7468 6973 . However, this │ │ │ │ │ +00046180: 0a63 616e 2062 6520 6368 616e 6765 6420 .can be changed │ │ │ │ │ +00046190: 6279 2075 7365 206f 6620 7468 6520 2764 by use of the 'd │ │ │ │ │ +000461a0: 6973 745f 2720 7072 6566 6978 2e20 2046 ist_' prefix. F │ │ │ │ │ +000461b0: 6f72 2069 6e73 7461 6e63 6520 6865 7265 or instance here │ │ │ │ │ +000461c0: 2069 7320 686f 770a 746f 2064 6973 7472 is how.to distr │ │ │ │ │ +000461d0: 6962 7574 6520 616e 6420 696e 7374 616c ibute and instal │ │ │ │ │ +000461e0: 6c20 7468 6520 7477 6f20 6d61 6e20 7061 l the two man pa │ │ │ │ │ +000461f0: 6765 7320 6f66 2047 4e55 2027 6370 696f ges of GNU 'cpio │ │ │ │ │ +00046200: 2720 2877 6869 6368 0a69 6e63 6c75 6465 ' (which.include │ │ │ │ │ +00046210: 7320 626f 7468 2054 6578 696e 666f 2064 s both Texinfo d │ │ │ │ │ +00046220: 6f63 756d 656e 7461 7469 6f6e 2061 6e64 ocumentation and │ │ │ │ │ +00046230: 206d 616e 2070 6167 6573 293a 0a0a 2020 man pages):.. │ │ │ │ │ +00046240: 2020 2064 6973 745f 6d61 6e5f 4d41 4e53 dist_man_MANS │ │ │ │ │ +00046250: 203d 2063 7069 6f2e 3120 6d74 2e31 0a0a = cpio.1 mt.1.. │ │ │ │ │ +00046260: 2020 2054 6865 2027 6e6f 6261 7365 5f27 The 'nobase_' │ │ │ │ │ +00046270: 2070 7265 6669 7820 6973 206d 6561 6e69 prefix is meani │ │ │ │ │ +00046280: 6e67 6c65 7373 2066 6f72 206d 616e 2070 ngless for man p │ │ │ │ │ +00046290: 6167 6573 2061 6e64 2069 7320 6469 7361 ages and is disa │ │ │ │ │ +000462a0: 6c6c 6f77 6564 2e0a 0a20 2020 4578 6563 llowed... Exec │ │ │ │ │ +000462b0: 7574 6162 6c65 7320 616e 6420 6d61 6e70 utables and manp │ │ │ │ │ +000462c0: 6167 6573 206d 6179 2062 6520 7265 6e61 ages may be rena │ │ │ │ │ +000462d0: 6d65 6420 7570 6f6e 2069 6e73 7461 6c6c med upon install │ │ │ │ │ +000462e0: 6174 696f 6e20 282a 6e6f 7465 0a52 656e ation (*note.Ren │ │ │ │ │ +000462f0: 616d 696e 673a 3a29 2e20 2046 6f72 206d aming::). For m │ │ │ │ │ +00046300: 616e 7061 6765 7320 7468 6973 2063 616e anpages this can │ │ │ │ │ +00046310: 2062 6520 6176 6f69 6465 6420 6279 2075 be avoided by u │ │ │ │ │ +00046320: 7365 206f 6620 7468 6520 276e 6f74 7261 se of the 'notra │ │ │ │ │ +00046330: 6e73 5f27 0a70 7265 6669 782e 2020 466f ns_'.prefix. Fo │ │ │ │ │ +00046340: 7220 696e 7374 616e 6365 2c20 7375 7070 r instance, supp │ │ │ │ │ +00046350: 6f73 6520 616e 2065 7865 6375 7461 626c ose an executabl │ │ │ │ │ +00046360: 6520 2766 6f6f 2720 616c 6c6f 7769 6e67 e 'foo' allowing │ │ │ │ │ +00046370: 2074 6f20 6163 6365 7373 2061 0a6c 6962 to access a.lib │ │ │ │ │ +00046380: 7261 7279 2066 756e 6374 696f 6e20 2766 rary function 'f │ │ │ │ │ +00046390: 6f6f 2720 6672 6f6d 2074 6865 2063 6f6d oo' from the com │ │ │ │ │ +000463a0: 6d61 6e64 206c 696e 652e 2020 5468 6520 mand line. The │ │ │ │ │ +000463b0: 7761 7920 746f 2061 766f 6964 2072 656e way to avoid ren │ │ │ │ │ +000463c0: 616d 696e 670a 6f66 2074 6865 2027 666f aming.of the 'fo │ │ │ │ │ +000463d0: 6f2e 3327 206d 616e 7061 6765 2069 733a o.3' manpage is: │ │ │ │ │ +000463e0: 0a0a 2020 2020 206d 616e 5f4d 414e 5320 .. man_MANS │ │ │ │ │ +000463f0: 3d20 666f 6f2e 310a 2020 2020 206e 6f74 = foo.1. not │ │ │ │ │ +00046400: 7261 6e73 5f6d 616e 5f4d 414e 5320 3d20 rans_man_MANS = │ │ │ │ │ +00046410: 666f 6f2e 330a 0a20 2020 276e 6f74 7261 foo.3.. 'notra │ │ │ │ │ +00046420: 6e73 5f27 206d 7573 7420 6265 2073 7065 ns_' must be spe │ │ │ │ │ +00046430: 6369 6669 6564 2066 6972 7374 2077 6865 cified first whe │ │ │ │ │ +00046440: 6e20 7573 6564 2069 6e20 636f 6e6a 756e n used in conjun │ │ │ │ │ +00046450: 6374 696f 6e20 7769 7468 0a65 6974 6865 ction with.eithe │ │ │ │ │ +00046460: 7220 2764 6973 745f 2720 6f72 2027 6e6f r 'dist_' or 'no │ │ │ │ │ +00046470: 6469 7374 5f27 2028 2a6e 6f74 6520 4669 dist_' (*note Fi │ │ │ │ │ +00046480: 6e65 2d67 7261 696e 6564 2044 6973 7472 ne-grained Distr │ │ │ │ │ +00046490: 6962 7574 696f 6e20 436f 6e74 726f 6c3a ibution Control: │ │ │ │ │ +000464a0: 3a29 2e0a 466f 7220 696e 7374 616e 6365 :)..For instance │ │ │ │ │ +000464b0: 3a0a 0a20 2020 2020 6e6f 7472 616e 735f :.. notrans_ │ │ │ │ │ +000464c0: 6469 7374 5f6d 616e 335f 4d41 4e53 203d dist_man3_MANS = │ │ │ │ │ +000464d0: 2062 6172 2e33 0a0a 1f0a 4669 6c65 3a20 bar.3....File: │ │ │ │ │ +000464e0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +000464f0: 666f 2c20 204e 6f64 653a 2049 6e73 7461 fo, Node: Insta │ │ │ │ │ +00046500: 6c6c 2c20 204e 6578 743a 2043 6c65 616e ll, Next: Clean │ │ │ │ │ +00046510: 2c20 2050 7265 763a 2044 6f63 756d 656e , Prev: Documen │ │ │ │ │ +00046520: 7461 7469 6f6e 2c20 2055 703a 2054 6f70 tation, Up: Top │ │ │ │ │ +00046530: 0a0a 3132 2057 6861 7420 4765 7473 2049 ..12 What Gets I │ │ │ │ │ +00046540: 6e73 7461 6c6c 6564 0a2a 2a2a 2a2a 2a2a nstalled.******* │ │ │ │ │ +00046550: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ +00046560: 0a4e 6174 7572 616c 6c79 2c20 4175 746f .Naturally, Auto │ │ │ │ │ +00046570: 6d61 6b65 2068 616e 646c 6573 2074 6865 make handles the │ │ │ │ │ +00046580: 2064 6574 6169 6c73 206f 6620 6163 7475 details of actu │ │ │ │ │ +00046590: 616c 6c79 2069 6e73 7461 6c6c 696e 6720 ally installing │ │ │ │ │ +000465a0: 796f 7572 0a70 726f 6772 616d 206f 6e63 your.program onc │ │ │ │ │ +000465b0: 6520 6974 2068 6173 2062 6565 6e20 6275 e it has been bu │ │ │ │ │ +000465c0: 696c 742e 2020 416c 6c20 6669 6c65 7320 ilt. All files │ │ │ │ │ +000465d0: 6e61 6d65 6420 6279 2074 6865 2076 6172 named by the var │ │ │ │ │ +000465e0: 696f 7573 0a70 7269 6d61 7269 6573 2061 ious.primaries a │ │ │ │ │ +000465f0: 7265 2061 7574 6f6d 6174 6963 616c 6c79 re automatically │ │ │ │ │ +00046600: 2069 6e73 7461 6c6c 6564 2069 6e20 7468 installed in th │ │ │ │ │ +00046610: 6520 6170 7072 6f70 7269 6174 6520 706c e appropriate pl │ │ │ │ │ +00046620: 6163 6573 2077 6865 6e20 7468 650a 7573 aces when the.us │ │ │ │ │ +00046630: 6572 2072 756e 7320 276d 616b 6520 696e er runs 'make in │ │ │ │ │ +00046640: 7374 616c 6c27 2e0a 0a2a 204d 656e 753a stall'...* Menu: │ │ │ │ │ +00046650: 0a0a 2a20 4261 7369 6373 206f 6620 496e ..* Basics of In │ │ │ │ │ +00046660: 7374 616c 6c61 7469 6f6e 3a3a 2020 2020 stallation:: │ │ │ │ │ +00046670: 2020 5768 6174 2067 6574 7320 696e 7374 What gets inst │ │ │ │ │ +00046680: 616c 6c65 6420 7768 6572 650a 2a20 5468 alled where.* Th │ │ │ │ │ +00046690: 6520 5477 6f20 5061 7274 7320 6f66 2049 e Two Parts of I │ │ │ │ │ +000466a0: 6e73 7461 6c6c 3a3a 2020 2020 496e 7374 nstall:: Inst │ │ │ │ │ +000466b0: 616c 6c69 6e67 2064 6174 6120 616e 6420 alling data and │ │ │ │ │ +000466c0: 7072 6f67 7261 6d73 2073 6570 6172 6174 programs separat │ │ │ │ │ +000466d0: 656c 790a 2a20 4578 7465 6e64 696e 6720 ely.* Extending │ │ │ │ │ +000466e0: 496e 7374 616c 6c61 7469 6f6e 3a3a 2020 Installation:: │ │ │ │ │ +000466f0: 2020 2020 4164 6469 6e67 2079 6f75 7220 Adding your │ │ │ │ │ +00046700: 6f77 6e20 7275 6c65 7320 666f 7220 696e own rules for in │ │ │ │ │ +00046710: 7374 616c 6c61 7469 6f6e 0a2a 2053 7461 stallation.* Sta │ │ │ │ │ +00046720: 6765 6420 496e 7374 616c 6c73 3a3a 2020 ged Installs:: │ │ │ │ │ +00046730: 2020 2020 2020 2020 2020 2049 6e73 7461 Insta │ │ │ │ │ +00046740: 6c6c 6174 696f 6e20 696e 2061 2074 656d llation in a tem │ │ │ │ │ +00046750: 706f 7261 7279 206c 6f63 6174 696f 6e0a porary location. │ │ │ │ │ +00046760: 2a20 496e 7374 616c 6c20 5275 6c65 7320 * Install Rules │ │ │ │ │ +00046770: 666f 7220 7468 6520 5573 6572 3a3a 2020 for the User:: │ │ │ │ │ +00046780: 5573 6566 756c 2061 6464 6974 696f 6e61 Useful additiona │ │ │ │ │ +00046790: 6c20 7275 6c65 730a 0a1f 0a46 696c 653a l rules....File: │ │ │ │ │ +000467a0: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +000467b0: 6e66 6f2c 2020 4e6f 6465 3a20 4261 7369 nfo, Node: Basi │ │ │ │ │ +000467c0: 6373 206f 6620 496e 7374 616c 6c61 7469 cs of Installati │ │ │ │ │ +000467d0: 6f6e 2c20 204e 6578 743a 2054 6865 2054 on, Next: The T │ │ │ │ │ +000467e0: 776f 2050 6172 7473 206f 6620 496e 7374 wo Parts of Inst │ │ │ │ │ +000467f0: 616c 6c2c 2020 5570 3a20 496e 7374 616c all, Up: Instal │ │ │ │ │ +00046800: 6c0a 0a31 322e 3120 4261 7369 6373 206f l..12.1 Basics o │ │ │ │ │ +00046810: 6620 496e 7374 616c 6c61 7469 6f6e 0a3d f Installation.= │ │ │ │ │ 00046820: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00046830: 3d3d 3d3d 3d3d 3d3d 0a0a 4120 6669 6c65 ========..A file │ │ │ │ │ -00046840: 206e 616d 6564 2069 6e20 6120 7072 696d named in a prim │ │ │ │ │ -00046850: 6172 7920 6973 2069 6e73 7461 6c6c 6564 ary is installed │ │ │ │ │ -00046860: 2062 7920 636f 7079 696e 6720 7468 6520 by copying the │ │ │ │ │ -00046870: 6275 696c 7420 6669 6c65 2069 6e74 6f0a built file into. │ │ │ │ │ -00046880: 7468 6520 6170 7072 6f70 7269 6174 6520 the appropriate │ │ │ │ │ -00046890: 6469 7265 6374 6f72 792e 2020 5468 6520 directory. The │ │ │ │ │ -000468a0: 6261 7365 206e 616d 6520 6f66 2074 6865 base name of the │ │ │ │ │ -000468b0: 2066 696c 6520 6973 2075 7365 6420 7768 file is used wh │ │ │ │ │ -000468c0: 656e 0a69 6e73 7461 6c6c 696e 672e 0a0a en.installing... │ │ │ │ │ -000468d0: 2020 2020 2062 696e 5f50 524f 4752 414d bin_PROGRAM │ │ │ │ │ -000468e0: 5320 3d20 6865 6c6c 6f20 7375 6264 6972 S = hello subdir │ │ │ │ │ -000468f0: 2f67 6f6f 6462 7965 0a0a 2020 2049 6e20 /goodbye.. In │ │ │ │ │ -00046900: 7468 6973 2065 7861 6d70 6c65 2c20 626f this example, bo │ │ │ │ │ -00046910: 7468 2027 6865 6c6c 6f27 2061 6e64 2027 th 'hello' and ' │ │ │ │ │ -00046920: 676f 6f64 6279 6527 2077 696c 6c20 6265 goodbye' will be │ │ │ │ │ -00046930: 2069 6e73 7461 6c6c 6564 2069 6e0a 2724 installed in.'$ │ │ │ │ │ -00046940: 2862 696e 6469 7229 272e 0a0a 2020 2053 (bindir)'... S │ │ │ │ │ -00046950: 6f6d 6574 696d 6573 2069 7420 6973 2075 ometimes it is u │ │ │ │ │ -00046960: 7365 6675 6c20 746f 2061 766f 6964 2074 seful to avoid t │ │ │ │ │ -00046970: 6865 2062 6173 656e 616d 6520 7374 6570 he basename step │ │ │ │ │ -00046980: 2061 7420 696e 7374 616c 6c20 7469 6d65 at install time │ │ │ │ │ -00046990: 2e0a 466f 7220 696e 7374 616e 6365 2c20 ..For instance, │ │ │ │ │ -000469a0: 796f 7520 6d69 6768 7420 6861 7665 2061 you might have a │ │ │ │ │ -000469b0: 206e 756d 6265 7220 6f66 2068 6561 6465 number of heade │ │ │ │ │ -000469c0: 7220 6669 6c65 7320 696e 2073 7562 6469 r files in subdi │ │ │ │ │ -000469d0: 7265 6374 6f72 6965 730a 6f66 2074 6865 rectories.of the │ │ │ │ │ -000469e0: 2073 6f75 7263 6520 7472 6565 2074 6861 source tree tha │ │ │ │ │ -000469f0: 7420 6172 6520 6c61 6964 206f 7574 2070 t are laid out p │ │ │ │ │ -00046a00: 7265 6369 7365 6c79 2068 6f77 2079 6f75 recisely how you │ │ │ │ │ -00046a10: 2077 616e 7420 746f 2069 6e73 7461 6c6c want to install │ │ │ │ │ -00046a20: 0a74 6865 6d2e 2020 496e 2074 6869 7320 .them. In this │ │ │ │ │ -00046a30: 7369 7475 6174 696f 6e20 796f 7520 6361 situation you ca │ │ │ │ │ -00046a40: 6e20 7573 6520 7468 6520 276e 6f62 6173 n use the 'nobas │ │ │ │ │ -00046a50: 655f 2720 7072 6566 6978 2074 6f20 7375 e_' prefix to su │ │ │ │ │ -00046a60: 7070 7265 7373 0a74 6865 2062 6173 6520 ppress.the base │ │ │ │ │ -00046a70: 6e61 6d65 2073 7465 702e 2020 466f 7220 name step. For │ │ │ │ │ -00046a80: 6578 616d 706c 653a 0a0a 2020 2020 206e example:.. n │ │ │ │ │ -00046a90: 6f62 6173 655f 696e 636c 7564 655f 4845 obase_include_HE │ │ │ │ │ -00046aa0: 4144 4552 5320 3d20 7374 6469 6f2e 6820 ADERS = stdio.h │ │ │ │ │ -00046ab0: 7379 732f 7479 7065 732e 680a 0a77 696c sys/types.h..wil │ │ │ │ │ -00046ac0: 6c20 696e 7374 616c 6c20 2773 7464 696f l install 'stdio │ │ │ │ │ -00046ad0: 2e68 2720 696e 2027 2428 696e 636c 7564 .h' in '$(includ │ │ │ │ │ -00046ae0: 6564 6972 2927 2061 6e64 2027 7479 7065 edir)' and 'type │ │ │ │ │ -00046af0: 732e 6827 2069 6e0a 2724 2869 6e63 6c75 s.h' in.'$(inclu │ │ │ │ │ -00046b00: 6465 6469 7229 2f73 7973 272e 0a0a 2020 dedir)/sys'... │ │ │ │ │ -00046b10: 2046 6f72 206d 6f73 7420 6669 6c65 2074 For most file t │ │ │ │ │ -00046b20: 7970 6573 2c20 4175 746f 6d61 6b65 2077 ypes, Automake w │ │ │ │ │ -00046b30: 696c 6c20 696e 7374 616c 6c20 6d75 6c74 ill install mult │ │ │ │ │ -00046b40: 6970 6c65 2066 696c 6573 2061 7420 6f6e iple files at on │ │ │ │ │ -00046b50: 6365 2c0a 7768 696c 6520 6176 6f69 6469 ce,.while avoidi │ │ │ │ │ -00046b60: 6e67 2063 6f6d 6d61 6e64 206c 696e 6520 ng command line │ │ │ │ │ -00046b70: 6c65 6e67 7468 2069 7373 7565 7320 282a length issues (* │ │ │ │ │ -00046b80: 6e6f 7465 204c 656e 6774 6820 4c69 6d69 note Length Limi │ │ │ │ │ -00046b90: 7461 7469 6f6e 733a 3a29 2e0a 5369 6e63 tations::)..Sinc │ │ │ │ │ -00046ba0: 6520 736f 6d65 2027 696e 7374 616c 6c27 e some 'install' │ │ │ │ │ -00046bb0: 2070 726f 6772 616d 7320 7769 6c6c 206e programs will n │ │ │ │ │ -00046bc0: 6f74 2069 6e73 7461 6c6c 2074 6865 2073 ot install the s │ │ │ │ │ -00046bd0: 616d 6520 6669 6c65 2074 7769 6365 2069 ame file twice i │ │ │ │ │ -00046be0: 6e0a 6f6e 6520 696e 766f 6361 7469 6f6e n.one invocation │ │ │ │ │ -00046bf0: 2c20 796f 7520 6d61 7920 6e65 6564 2074 , you may need t │ │ │ │ │ -00046c00: 6f20 656e 7375 7265 2074 6861 7420 6669 o ensure that fi │ │ │ │ │ -00046c10: 6c65 206c 6973 7473 2061 7265 2075 6e69 le lists are uni │ │ │ │ │ -00046c20: 7175 6520 7769 7468 696e 0a6f 6e65 2076 que within.one v │ │ │ │ │ -00046c30: 6172 6961 626c 6520 7375 6368 2061 7320 ariable such as │ │ │ │ │ -00046c40: 276e 6f62 6173 655f 696e 636c 7564 655f 'nobase_include_ │ │ │ │ │ -00046c50: 4845 4144 4552 5327 2061 626f 7665 2e0a HEADERS' above.. │ │ │ │ │ -00046c60: 0a20 2020 596f 7520 7368 6f75 6c64 206e . You should n │ │ │ │ │ -00046c70: 6f74 2072 656c 7920 6f6e 2074 6865 206f ot rely on the o │ │ │ │ │ -00046c80: 7264 6572 2069 6e20 7768 6963 6820 6669 rder in which fi │ │ │ │ │ -00046c90: 6c65 7320 6c69 7374 6564 2069 6e20 6f6e les listed in on │ │ │ │ │ -00046ca0: 650a 7661 7269 6162 6c65 2061 7265 2069 e.variable are i │ │ │ │ │ -00046cb0: 6e73 7461 6c6c 6564 2e20 204c 696b 6577 nstalled. Likew │ │ │ │ │ -00046cc0: 6973 652c 2074 6f20 6361 7465 7220 666f ise, to cater fo │ │ │ │ │ -00046cd0: 7220 7061 7261 6c6c 656c 206d 616b 652c r parallel make, │ │ │ │ │ -00046ce0: 2079 6f75 0a73 686f 756c 6420 6e6f 7420 you.should not │ │ │ │ │ -00046cf0: 7265 6c79 206f 6e20 616e 7920 7061 7274 rely on any part │ │ │ │ │ -00046d00: 6963 756c 6172 2066 696c 6520 696e 7374 icular file inst │ │ │ │ │ -00046d10: 616c 6c61 7469 6f6e 206f 7264 6572 2065 allation order e │ │ │ │ │ -00046d20: 7665 6e20 616d 6f6e 670a 6469 6666 6572 ven among.differ │ │ │ │ │ -00046d30: 656e 7420 6669 6c65 2074 7970 6573 2028 ent file types ( │ │ │ │ │ -00046d40: 6c69 6272 6172 7920 6465 7065 6e64 656e library dependen │ │ │ │ │ -00046d50: 6369 6573 2061 7265 2061 6e20 6578 6365 cies are an exce │ │ │ │ │ -00046d60: 7074 696f 6e20 6865 7265 292e 0a0a 1f0a ption here)..... │ │ │ │ │ -00046d70: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ -00046d80: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ -00046d90: 2054 6865 2054 776f 2050 6172 7473 206f The Two Parts o │ │ │ │ │ -00046da0: 6620 496e 7374 616c 6c2c 2020 4e65 7874 f Install, Next │ │ │ │ │ -00046db0: 3a20 4578 7465 6e64 696e 6720 496e 7374 : Extending Inst │ │ │ │ │ -00046dc0: 616c 6c61 7469 6f6e 2c20 2050 7265 763a allation, Prev: │ │ │ │ │ -00046dd0: 2042 6173 6963 7320 6f66 2049 6e73 7461 Basics of Insta │ │ │ │ │ -00046de0: 6c6c 6174 696f 6e2c 2020 5570 3a20 496e llation, Up: In │ │ │ │ │ -00046df0: 7374 616c 6c0a 0a31 322e 3220 5468 6520 stall..12.2 The │ │ │ │ │ -00046e00: 5477 6f20 5061 7274 7320 6f66 2049 6e73 Two Parts of Ins │ │ │ │ │ -00046e10: 7461 6c6c 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d tall.=========== │ │ │ │ │ +00046830: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4120 6669 ==========..A fi │ │ │ │ │ +00046840: 6c65 206e 616d 6564 2069 6e20 6120 7072 le named in a pr │ │ │ │ │ +00046850: 696d 6172 7920 6973 2069 6e73 7461 6c6c imary is install │ │ │ │ │ +00046860: 6564 2062 7920 636f 7079 696e 6720 7468 ed by copying th │ │ │ │ │ +00046870: 6520 6275 696c 7420 6669 6c65 2069 6e74 e built file int │ │ │ │ │ +00046880: 6f0a 7468 6520 6170 7072 6f70 7269 6174 o.the appropriat │ │ │ │ │ +00046890: 6520 6469 7265 6374 6f72 792e 2020 5468 e directory. Th │ │ │ │ │ +000468a0: 6520 6261 7365 206e 616d 6520 6f66 2074 e base name of t │ │ │ │ │ +000468b0: 6865 2066 696c 6520 6973 2075 7365 6420 he file is used │ │ │ │ │ +000468c0: 7768 656e 0a69 6e73 7461 6c6c 696e 672e when.installing. │ │ │ │ │ +000468d0: 0a0a 2020 2020 2062 696e 5f50 524f 4752 .. bin_PROGR │ │ │ │ │ +000468e0: 414d 5320 3d20 6865 6c6c 6f20 7375 6264 AMS = hello subd │ │ │ │ │ +000468f0: 6972 2f67 6f6f 6462 7965 0a0a 2020 2049 ir/goodbye.. I │ │ │ │ │ +00046900: 6e20 7468 6973 2065 7861 6d70 6c65 2c20 n this example, │ │ │ │ │ +00046910: 626f 7468 2027 6865 6c6c 6f27 2061 6e64 both 'hello' and │ │ │ │ │ +00046920: 2027 676f 6f64 6279 6527 2077 696c 6c20 'goodbye' will │ │ │ │ │ +00046930: 6265 2069 6e73 7461 6c6c 6564 2069 6e0a be installed in. │ │ │ │ │ +00046940: 2724 2862 696e 6469 7229 272e 0a0a 2020 '$(bindir)'... │ │ │ │ │ +00046950: 2053 6f6d 6574 696d 6573 2069 7420 6973 Sometimes it is │ │ │ │ │ +00046960: 2075 7365 6675 6c20 746f 2061 766f 6964 useful to avoid │ │ │ │ │ +00046970: 2074 6865 2062 6173 656e 616d 6520 7374 the basename st │ │ │ │ │ +00046980: 6570 2061 7420 696e 7374 616c 6c20 7469 ep at install ti │ │ │ │ │ +00046990: 6d65 2e0a 466f 7220 696e 7374 616e 6365 me..For instance │ │ │ │ │ +000469a0: 2c20 796f 7520 6d69 6768 7420 6861 7665 , you might have │ │ │ │ │ +000469b0: 2061 206e 756d 6265 7220 6f66 2068 6561 a number of hea │ │ │ │ │ +000469c0: 6465 7220 6669 6c65 7320 696e 2073 7562 der files in sub │ │ │ │ │ +000469d0: 6469 7265 6374 6f72 6965 730a 6f66 2074 directories.of t │ │ │ │ │ +000469e0: 6865 2073 6f75 7263 6520 7472 6565 2074 he source tree t │ │ │ │ │ +000469f0: 6861 7420 6172 6520 6c61 6964 206f 7574 hat are laid out │ │ │ │ │ +00046a00: 2070 7265 6369 7365 6c79 2068 6f77 2079 precisely how y │ │ │ │ │ +00046a10: 6f75 2077 616e 7420 746f 2069 6e73 7461 ou want to insta │ │ │ │ │ +00046a20: 6c6c 0a74 6865 6d2e 2020 496e 2074 6869 ll.them. In thi │ │ │ │ │ +00046a30: 7320 7369 7475 6174 696f 6e20 796f 7520 s situation you │ │ │ │ │ +00046a40: 6361 6e20 7573 6520 7468 6520 276e 6f62 can use the 'nob │ │ │ │ │ +00046a50: 6173 655f 2720 7072 6566 6978 2074 6f20 ase_' prefix to │ │ │ │ │ +00046a60: 7375 7070 7265 7373 0a74 6865 2062 6173 suppress.the bas │ │ │ │ │ +00046a70: 6520 6e61 6d65 2073 7465 702e 2020 466f e name step. Fo │ │ │ │ │ +00046a80: 7220 6578 616d 706c 653a 0a0a 2020 2020 r example:.. │ │ │ │ │ +00046a90: 206e 6f62 6173 655f 696e 636c 7564 655f nobase_include_ │ │ │ │ │ +00046aa0: 4845 4144 4552 5320 3d20 7374 6469 6f2e HEADERS = stdio. │ │ │ │ │ +00046ab0: 6820 7379 732f 7479 7065 732e 680a 0a77 h sys/types.h..w │ │ │ │ │ +00046ac0: 696c 6c20 696e 7374 616c 6c20 2773 7464 ill install 'std │ │ │ │ │ +00046ad0: 696f 2e68 2720 696e 2027 2428 696e 636c io.h' in '$(incl │ │ │ │ │ +00046ae0: 7564 6564 6972 2927 2061 6e64 2027 7479 udedir)' and 'ty │ │ │ │ │ +00046af0: 7065 732e 6827 2069 6e0a 2724 2869 6e63 pes.h' in.'$(inc │ │ │ │ │ +00046b00: 6c75 6465 6469 7229 2f73 7973 272e 0a0a ludedir)/sys'... │ │ │ │ │ +00046b10: 2020 2046 6f72 206d 6f73 7420 6669 6c65 For most file │ │ │ │ │ +00046b20: 2074 7970 6573 2c20 4175 746f 6d61 6b65 types, Automake │ │ │ │ │ +00046b30: 2077 696c 6c20 696e 7374 616c 6c20 6d75 will install mu │ │ │ │ │ +00046b40: 6c74 6970 6c65 2066 696c 6573 2061 7420 ltiple files at │ │ │ │ │ +00046b50: 6f6e 6365 2c0a 7768 696c 6520 6176 6f69 once,.while avoi │ │ │ │ │ +00046b60: 6469 6e67 2063 6f6d 6d61 6e64 206c 696e ding command lin │ │ │ │ │ +00046b70: 6520 6c65 6e67 7468 2069 7373 7565 7320 e length issues │ │ │ │ │ +00046b80: 282a 6e6f 7465 204c 656e 6774 6820 4c69 (*note Length Li │ │ │ │ │ +00046b90: 6d69 7461 7469 6f6e 733a 3a29 2e0a 5369 mitations::)..Si │ │ │ │ │ +00046ba0: 6e63 6520 736f 6d65 2027 696e 7374 616c nce some 'instal │ │ │ │ │ +00046bb0: 6c27 2070 726f 6772 616d 7320 7769 6c6c l' programs will │ │ │ │ │ +00046bc0: 206e 6f74 2069 6e73 7461 6c6c 2074 6865 not install the │ │ │ │ │ +00046bd0: 2073 616d 6520 6669 6c65 2074 7769 6365 same file twice │ │ │ │ │ +00046be0: 2069 6e0a 6f6e 6520 696e 766f 6361 7469 in.one invocati │ │ │ │ │ +00046bf0: 6f6e 2c20 796f 7520 6d61 7920 6e65 6564 on, you may need │ │ │ │ │ +00046c00: 2074 6f20 656e 7375 7265 2074 6861 7420 to ensure that │ │ │ │ │ +00046c10: 6669 6c65 206c 6973 7473 2061 7265 2075 file lists are u │ │ │ │ │ +00046c20: 6e69 7175 6520 7769 7468 696e 0a6f 6e65 nique within.one │ │ │ │ │ +00046c30: 2076 6172 6961 626c 6520 7375 6368 2061 variable such a │ │ │ │ │ +00046c40: 7320 276e 6f62 6173 655f 696e 636c 7564 s 'nobase_includ │ │ │ │ │ +00046c50: 655f 4845 4144 4552 5327 2061 626f 7665 e_HEADERS' above │ │ │ │ │ +00046c60: 2e0a 0a20 2020 596f 7520 7368 6f75 6c64 ... You should │ │ │ │ │ +00046c70: 206e 6f74 2072 656c 7920 6f6e 2074 6865 not rely on the │ │ │ │ │ +00046c80: 206f 7264 6572 2069 6e20 7768 6963 6820 order in which │ │ │ │ │ +00046c90: 6669 6c65 7320 6c69 7374 6564 2069 6e20 files listed in │ │ │ │ │ +00046ca0: 6f6e 650a 7661 7269 6162 6c65 2061 7265 one.variable are │ │ │ │ │ +00046cb0: 2069 6e73 7461 6c6c 6564 2e20 204c 696b installed. Lik │ │ │ │ │ +00046cc0: 6577 6973 652c 2074 6f20 6361 7465 7220 ewise, to cater │ │ │ │ │ +00046cd0: 666f 7220 7061 7261 6c6c 656c 206d 616b for parallel mak │ │ │ │ │ +00046ce0: 652c 2079 6f75 0a73 686f 756c 6420 6e6f e, you.should no │ │ │ │ │ +00046cf0: 7420 7265 6c79 206f 6e20 616e 7920 7061 t rely on any pa │ │ │ │ │ +00046d00: 7274 6963 756c 6172 2066 696c 6520 696e rticular file in │ │ │ │ │ +00046d10: 7374 616c 6c61 7469 6f6e 206f 7264 6572 stallation order │ │ │ │ │ +00046d20: 2065 7665 6e20 616d 6f6e 670a 6469 6666 even among.diff │ │ │ │ │ +00046d30: 6572 656e 7420 6669 6c65 2074 7970 6573 erent file types │ │ │ │ │ +00046d40: 2028 6c69 6272 6172 7920 6465 7065 6e64 (library depend │ │ │ │ │ +00046d50: 656e 6369 6573 2061 7265 2061 6e20 6578 encies are an ex │ │ │ │ │ +00046d60: 6365 7074 696f 6e20 6865 7265 292e 0a0a ception here)... │ │ │ │ │ +00046d70: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +00046d80: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +00046d90: 653a 2054 6865 2054 776f 2050 6172 7473 e: The Two Parts │ │ │ │ │ +00046da0: 206f 6620 496e 7374 616c 6c2c 2020 4e65 of Install, Ne │ │ │ │ │ +00046db0: 7874 3a20 4578 7465 6e64 696e 6720 496e xt: Extending In │ │ │ │ │ +00046dc0: 7374 616c 6c61 7469 6f6e 2c20 2050 7265 stallation, Pre │ │ │ │ │ +00046dd0: 763a 2042 6173 6963 7320 6f66 2049 6e73 v: Basics of Ins │ │ │ │ │ +00046de0: 7461 6c6c 6174 696f 6e2c 2020 5570 3a20 tallation, Up: │ │ │ │ │ +00046df0: 496e 7374 616c 6c0a 0a31 322e 3220 5468 Install..12.2 Th │ │ │ │ │ +00046e00: 6520 5477 6f20 5061 7274 7320 6f66 2049 e Two Parts of I │ │ │ │ │ +00046e10: 6e73 7461 6c6c 0a3d 3d3d 3d3d 3d3d 3d3d nstall.========= │ │ │ │ │ 00046e20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00046e30: 3d3d 0a0a 4175 746f 6d61 6b65 2067 656e ==..Automake gen │ │ │ │ │ -00046e40: 6572 6174 6573 2073 6570 6172 6174 6520 erates separate │ │ │ │ │ -00046e50: 2769 6e73 7461 6c6c 2d64 6174 6127 2061 'install-data' a │ │ │ │ │ -00046e60: 6e64 2027 696e 7374 616c 6c2d 6578 6563 nd 'install-exec │ │ │ │ │ -00046e70: 2720 7275 6c65 732c 2069 6e0a 6361 7365 ' rules, in.case │ │ │ │ │ -00046e80: 2074 6865 2069 6e73 7461 6c6c 6572 2069 the installer i │ │ │ │ │ -00046e90: 7320 696e 7374 616c 6c69 6e67 206f 6e20 s installing on │ │ │ │ │ -00046ea0: 6d75 6c74 6970 6c65 206d 6163 6869 6e65 multiple machine │ │ │ │ │ -00046eb0: 7320 7468 6174 2073 6861 7265 0a64 6972 s that share.dir │ │ │ │ │ -00046ec0: 6563 746f 7279 2073 7472 7563 7475 7265 ectory structure │ │ │ │ │ -00046ed0: 2d2d 7468 6573 6520 7461 7267 6574 7320 --these targets │ │ │ │ │ -00046ee0: 616c 6c6f 7720 7468 6520 6d61 6368 696e allow the machin │ │ │ │ │ -00046ef0: 652d 696e 6465 7065 6e64 656e 7420 7061 e-independent pa │ │ │ │ │ -00046f00: 7274 730a 746f 2062 6520 696e 7374 616c rts.to be instal │ │ │ │ │ -00046f10: 6c65 6420 6f6e 6c79 206f 6e63 652e 2020 led only once. │ │ │ │ │ -00046f20: 2769 6e73 7461 6c6c 2d65 7865 6327 2069 'install-exec' i │ │ │ │ │ -00046f30: 6e73 7461 6c6c 7320 706c 6174 666f 726d nstalls platform │ │ │ │ │ -00046f40: 2d64 6570 656e 6465 6e74 0a66 696c 6573 -dependent.files │ │ │ │ │ -00046f50: 2c20 616e 6420 2769 6e73 7461 6c6c 2d64 , and 'install-d │ │ │ │ │ -00046f60: 6174 6127 2069 6e73 7461 6c6c 7320 706c ata' installs pl │ │ │ │ │ -00046f70: 6174 666f 726d 2d69 6e64 6570 656e 6465 atform-independe │ │ │ │ │ -00046f80: 6e74 2066 696c 6573 2e20 2054 6865 0a27 nt files. The.' │ │ │ │ │ -00046f90: 696e 7374 616c 6c27 2074 6172 6765 7420 install' target │ │ │ │ │ -00046fa0: 6465 7065 6e64 7320 6f6e 2062 6f74 6820 depends on both │ │ │ │ │ -00046fb0: 6f66 2074 6865 7365 2074 6172 6765 7473 of these targets │ │ │ │ │ -00046fc0: 2e20 2057 6869 6c65 2041 7574 6f6d 616b . While Automak │ │ │ │ │ -00046fd0: 6520 7472 6965 730a 746f 2061 7574 6f6d e tries.to autom │ │ │ │ │ -00046fe0: 6174 6963 616c 6c79 2073 6567 7265 6761 atically segrega │ │ │ │ │ -00046ff0: 7465 206f 626a 6563 7473 2069 6e74 6f20 te objects into │ │ │ │ │ -00047000: 7468 6520 636f 7272 6563 7420 6361 7465 the correct cate │ │ │ │ │ -00047010: 676f 7279 2c20 7468 650a 274d 616b 6566 gory, the.'Makef │ │ │ │ │ -00047020: 696c 652e 616d 2720 6175 7468 6f72 2069 ile.am' author i │ │ │ │ │ -00047030: 732c 2069 6e20 7468 6520 656e 642c 2072 s, in the end, r │ │ │ │ │ -00047040: 6573 706f 6e73 6962 6c65 2066 6f72 206d esponsible for m │ │ │ │ │ -00047050: 616b 696e 6720 7375 7265 2074 6869 7320 aking sure this │ │ │ │ │ -00047060: 6973 0a64 6f6e 6520 636f 7272 6563 746c is.done correctl │ │ │ │ │ -00047070: 792e 0a0a 2020 2056 6172 6961 626c 6573 y... Variables │ │ │ │ │ -00047080: 2075 7369 6e67 2074 6865 2073 7461 6e64 using the stand │ │ │ │ │ -00047090: 6172 6420 6469 7265 6374 6f72 7920 7072 ard directory pr │ │ │ │ │ -000470a0: 6566 6978 6573 2027 6461 7461 272c 2027 efixes 'data', ' │ │ │ │ │ -000470b0: 696e 666f 272c 0a27 6d61 6e27 2c20 2769 info',.'man', 'i │ │ │ │ │ -000470c0: 6e63 6c75 6465 272c 2027 6f6c 6469 6e63 nclude', 'oldinc │ │ │ │ │ -000470d0: 6c75 6465 272c 2027 706b 6764 6174 6127 lude', 'pkgdata' │ │ │ │ │ -000470e0: 2c20 6f72 2027 706b 6769 6e63 6c75 6465 , or 'pkginclude │ │ │ │ │ -000470f0: 2720 6172 6520 696e 7374 616c 6c65 640a ' are installed. │ │ │ │ │ -00047100: 6279 2027 696e 7374 616c 6c2d 6461 7461 by 'install-data │ │ │ │ │ -00047110: 272e 0a0a 2020 2056 6172 6961 626c 6573 '... Variables │ │ │ │ │ -00047120: 2075 7369 6e67 2074 6865 2073 7461 6e64 using the stand │ │ │ │ │ -00047130: 6172 6420 6469 7265 6374 6f72 7920 7072 ard directory pr │ │ │ │ │ -00047140: 6566 6978 6573 2027 6269 6e27 2c20 2773 efixes 'bin', 's │ │ │ │ │ -00047150: 6269 6e27 2c0a 276c 6962 6578 6563 272c bin',.'libexec', │ │ │ │ │ -00047160: 2027 7379 7363 6f6e 6627 2c20 276c 6f63 'sysconf', 'loc │ │ │ │ │ -00047170: 616c 7374 6174 6527 2c20 276c 6962 272c alstate', 'lib', │ │ │ │ │ -00047180: 206f 7220 2770 6b67 6c69 6227 2061 7265 or 'pkglib' are │ │ │ │ │ -00047190: 2069 6e73 7461 6c6c 6564 2062 790a 2769 installed by.'i │ │ │ │ │ -000471a0: 6e73 7461 6c6c 2d65 7865 6327 2e0a 0a20 nstall-exec'... │ │ │ │ │ -000471b0: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ -000471c0: 2764 6174 615f 4441 5441 2720 6669 6c65 'data_DATA' file │ │ │ │ │ -000471d0: 7320 6172 6520 696e 7374 616c 6c65 6420 s are installed │ │ │ │ │ -000471e0: 6279 2027 696e 7374 616c 6c2d 6461 7461 by 'install-data │ │ │ │ │ -000471f0: 272c 0a77 6869 6c65 2027 6269 6e5f 5052 ',.while 'bin_PR │ │ │ │ │ -00047200: 4f47 5241 4d53 2720 6669 6c65 7320 6172 OGRAMS' files ar │ │ │ │ │ -00047210: 6520 696e 7374 616c 6c65 6420 6279 2027 e installed by ' │ │ │ │ │ -00047220: 696e 7374 616c 6c2d 6578 6563 272e 0a0a install-exec'... │ │ │ │ │ -00047230: 2020 2041 6e79 2076 6172 6961 626c 6520 Any variable │ │ │ │ │ -00047240: 7573 696e 6720 6120 7573 6572 2d64 6566 using a user-def │ │ │ │ │ -00047250: 696e 6564 2064 6972 6563 746f 7279 2070 ined directory p │ │ │ │ │ -00047260: 7265 6669 7820 7769 7468 2027 6578 6563 refix with 'exec │ │ │ │ │ -00047270: 2720 696e 2074 6865 0a6e 616d 6520 2865 ' in the.name (e │ │ │ │ │ -00047280: 2e67 2e2c 2027 6d79 6578 6563 6269 6e5f .g., 'myexecbin_ │ │ │ │ │ -00047290: 5052 4f47 5241 4d53 2729 2069 7320 696e PROGRAMS') is in │ │ │ │ │ -000472a0: 7374 616c 6c65 6420 6279 2027 696e 7374 stalled by 'inst │ │ │ │ │ -000472b0: 616c 6c2d 6578 6563 272e 2020 416c 6c0a all-exec'. All. │ │ │ │ │ -000472c0: 6f74 6865 7220 7573 6572 2d64 6566 696e other user-defin │ │ │ │ │ -000472d0: 6564 2070 7265 6669 7865 7320 6172 6520 ed prefixes are │ │ │ │ │ -000472e0: 696e 7374 616c 6c65 6420 6279 2027 696e installed by 'in │ │ │ │ │ -000472f0: 7374 616c 6c2d 6461 7461 272e 0a0a 1f0a stall-data'..... │ │ │ │ │ -00047300: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ -00047310: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ -00047320: 2045 7874 656e 6469 6e67 2049 6e73 7461 Extending Insta │ │ │ │ │ -00047330: 6c6c 6174 696f 6e2c 2020 4e65 7874 3a20 llation, Next: │ │ │ │ │ -00047340: 5374 6167 6564 2049 6e73 7461 6c6c 732c Staged Installs, │ │ │ │ │ -00047350: 2020 5072 6576 3a20 5468 6520 5477 6f20 Prev: The Two │ │ │ │ │ -00047360: 5061 7274 7320 6f66 2049 6e73 7461 6c6c Parts of Install │ │ │ │ │ -00047370: 2c20 2055 703a 2049 6e73 7461 6c6c 0a0a , Up: Install.. │ │ │ │ │ -00047380: 3132 2e33 2045 7874 656e 6469 6e67 2049 12.3 Extending I │ │ │ │ │ -00047390: 6e73 7461 6c6c 6174 696f 6e0a 3d3d 3d3d nstallation.==== │ │ │ │ │ +00046e30: 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 2067 ====..Automake g │ │ │ │ │ +00046e40: 656e 6572 6174 6573 2073 6570 6172 6174 enerates separat │ │ │ │ │ +00046e50: 6520 2769 6e73 7461 6c6c 2d64 6174 6127 e 'install-data' │ │ │ │ │ +00046e60: 2061 6e64 2027 696e 7374 616c 6c2d 6578 and 'install-ex │ │ │ │ │ +00046e70: 6563 2720 7275 6c65 732c 2069 6e0a 6361 ec' rules, in.ca │ │ │ │ │ +00046e80: 7365 2074 6865 2069 6e73 7461 6c6c 6572 se the installer │ │ │ │ │ +00046e90: 2069 7320 696e 7374 616c 6c69 6e67 206f is installing o │ │ │ │ │ +00046ea0: 6e20 6d75 6c74 6970 6c65 206d 6163 6869 n multiple machi │ │ │ │ │ +00046eb0: 6e65 7320 7468 6174 2073 6861 7265 0a64 nes that share.d │ │ │ │ │ +00046ec0: 6972 6563 746f 7279 2073 7472 7563 7475 irectory structu │ │ │ │ │ +00046ed0: 7265 2d2d 7468 6573 6520 7461 7267 6574 re--these target │ │ │ │ │ +00046ee0: 7320 616c 6c6f 7720 7468 6520 6d61 6368 s allow the mach │ │ │ │ │ +00046ef0: 696e 652d 696e 6465 7065 6e64 656e 7420 ine-independent │ │ │ │ │ +00046f00: 7061 7274 730a 746f 2062 6520 696e 7374 parts.to be inst │ │ │ │ │ +00046f10: 616c 6c65 6420 6f6e 6c79 206f 6e63 652e alled only once. │ │ │ │ │ +00046f20: 2020 2769 6e73 7461 6c6c 2d65 7865 6327 'install-exec' │ │ │ │ │ +00046f30: 2069 6e73 7461 6c6c 7320 706c 6174 666f installs platfo │ │ │ │ │ +00046f40: 726d 2d64 6570 656e 6465 6e74 0a66 696c rm-dependent.fil │ │ │ │ │ +00046f50: 6573 2c20 616e 6420 2769 6e73 7461 6c6c es, and 'install │ │ │ │ │ +00046f60: 2d64 6174 6127 2069 6e73 7461 6c6c 7320 -data' installs │ │ │ │ │ +00046f70: 706c 6174 666f 726d 2d69 6e64 6570 656e platform-indepen │ │ │ │ │ +00046f80: 6465 6e74 2066 696c 6573 2e20 2054 6865 dent files. The │ │ │ │ │ +00046f90: 0a27 696e 7374 616c 6c27 2074 6172 6765 .'install' targe │ │ │ │ │ +00046fa0: 7420 6465 7065 6e64 7320 6f6e 2062 6f74 t depends on bot │ │ │ │ │ +00046fb0: 6820 6f66 2074 6865 7365 2074 6172 6765 h of these targe │ │ │ │ │ +00046fc0: 7473 2e20 2057 6869 6c65 2041 7574 6f6d ts. While Autom │ │ │ │ │ +00046fd0: 616b 6520 7472 6965 730a 746f 2061 7574 ake tries.to aut │ │ │ │ │ +00046fe0: 6f6d 6174 6963 616c 6c79 2073 6567 7265 omatically segre │ │ │ │ │ +00046ff0: 6761 7465 206f 626a 6563 7473 2069 6e74 gate objects int │ │ │ │ │ +00047000: 6f20 7468 6520 636f 7272 6563 7420 6361 o the correct ca │ │ │ │ │ +00047010: 7465 676f 7279 2c20 7468 650a 274d 616b tegory, the.'Mak │ │ │ │ │ +00047020: 6566 696c 652e 616d 2720 6175 7468 6f72 efile.am' author │ │ │ │ │ +00047030: 2069 732c 2069 6e20 7468 6520 656e 642c is, in the end, │ │ │ │ │ +00047040: 2072 6573 706f 6e73 6962 6c65 2066 6f72 responsible for │ │ │ │ │ +00047050: 206d 616b 696e 6720 7375 7265 2074 6869 making sure thi │ │ │ │ │ +00047060: 7320 6973 0a64 6f6e 6520 636f 7272 6563 s is.done correc │ │ │ │ │ +00047070: 746c 792e 0a0a 2020 2056 6172 6961 626c tly... Variabl │ │ │ │ │ +00047080: 6573 2075 7369 6e67 2074 6865 2073 7461 es using the sta │ │ │ │ │ +00047090: 6e64 6172 6420 6469 7265 6374 6f72 7920 ndard directory │ │ │ │ │ +000470a0: 7072 6566 6978 6573 2027 6461 7461 272c prefixes 'data', │ │ │ │ │ +000470b0: 2027 696e 666f 272c 0a27 6d61 6e27 2c20 'info',.'man', │ │ │ │ │ +000470c0: 2769 6e63 6c75 6465 272c 2027 6f6c 6469 'include', 'oldi │ │ │ │ │ +000470d0: 6e63 6c75 6465 272c 2027 706b 6764 6174 nclude', 'pkgdat │ │ │ │ │ +000470e0: 6127 2c20 6f72 2027 706b 6769 6e63 6c75 a', or 'pkginclu │ │ │ │ │ +000470f0: 6465 2720 6172 6520 696e 7374 616c 6c65 de' are installe │ │ │ │ │ +00047100: 640a 6279 2027 696e 7374 616c 6c2d 6461 d.by 'install-da │ │ │ │ │ +00047110: 7461 272e 0a0a 2020 2056 6172 6961 626c ta'... Variabl │ │ │ │ │ +00047120: 6573 2075 7369 6e67 2074 6865 2073 7461 es using the sta │ │ │ │ │ +00047130: 6e64 6172 6420 6469 7265 6374 6f72 7920 ndard directory │ │ │ │ │ +00047140: 7072 6566 6978 6573 2027 6269 6e27 2c20 prefixes 'bin', │ │ │ │ │ +00047150: 2773 6269 6e27 2c0a 276c 6962 6578 6563 'sbin',.'libexec │ │ │ │ │ +00047160: 272c 2027 7379 7363 6f6e 6627 2c20 276c ', 'sysconf', 'l │ │ │ │ │ +00047170: 6f63 616c 7374 6174 6527 2c20 276c 6962 ocalstate', 'lib │ │ │ │ │ +00047180: 272c 206f 7220 2770 6b67 6c69 6227 2061 ', or 'pkglib' a │ │ │ │ │ +00047190: 7265 2069 6e73 7461 6c6c 6564 2062 790a re installed by. │ │ │ │ │ +000471a0: 2769 6e73 7461 6c6c 2d65 7865 6327 2e0a 'install-exec'.. │ │ │ │ │ +000471b0: 0a20 2020 466f 7220 696e 7374 616e 6365 . For instance │ │ │ │ │ +000471c0: 2c20 2764 6174 615f 4441 5441 2720 6669 , 'data_DATA' fi │ │ │ │ │ +000471d0: 6c65 7320 6172 6520 696e 7374 616c 6c65 les are installe │ │ │ │ │ +000471e0: 6420 6279 2027 696e 7374 616c 6c2d 6461 d by 'install-da │ │ │ │ │ +000471f0: 7461 272c 0a77 6869 6c65 2027 6269 6e5f ta',.while 'bin_ │ │ │ │ │ +00047200: 5052 4f47 5241 4d53 2720 6669 6c65 7320 PROGRAMS' files │ │ │ │ │ +00047210: 6172 6520 696e 7374 616c 6c65 6420 6279 are installed by │ │ │ │ │ +00047220: 2027 696e 7374 616c 6c2d 6578 6563 272e 'install-exec'. │ │ │ │ │ +00047230: 0a0a 2020 2041 6e79 2076 6172 6961 626c .. Any variabl │ │ │ │ │ +00047240: 6520 7573 696e 6720 6120 7573 6572 2d64 e using a user-d │ │ │ │ │ +00047250: 6566 696e 6564 2064 6972 6563 746f 7279 efined directory │ │ │ │ │ +00047260: 2070 7265 6669 7820 7769 7468 2027 6578 prefix with 'ex │ │ │ │ │ +00047270: 6563 2720 696e 2074 6865 0a6e 616d 6520 ec' in the.name │ │ │ │ │ +00047280: 2865 2e67 2e2c 2027 6d79 6578 6563 6269 (e.g., 'myexecbi │ │ │ │ │ +00047290: 6e5f 5052 4f47 5241 4d53 2729 2069 7320 n_PROGRAMS') is │ │ │ │ │ +000472a0: 696e 7374 616c 6c65 6420 6279 2027 696e installed by 'in │ │ │ │ │ +000472b0: 7374 616c 6c2d 6578 6563 272e 2020 416c stall-exec'. Al │ │ │ │ │ +000472c0: 6c0a 6f74 6865 7220 7573 6572 2d64 6566 l.other user-def │ │ │ │ │ +000472d0: 696e 6564 2070 7265 6669 7865 7320 6172 ined prefixes ar │ │ │ │ │ +000472e0: 6520 696e 7374 616c 6c65 6420 6279 2027 e installed by ' │ │ │ │ │ +000472f0: 696e 7374 616c 6c2d 6461 7461 272e 0a0a install-data'... │ │ │ │ │ +00047300: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +00047310: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +00047320: 653a 2045 7874 656e 6469 6e67 2049 6e73 e: Extending Ins │ │ │ │ │ +00047330: 7461 6c6c 6174 696f 6e2c 2020 4e65 7874 tallation, Next │ │ │ │ │ +00047340: 3a20 5374 6167 6564 2049 6e73 7461 6c6c : Staged Install │ │ │ │ │ +00047350: 732c 2020 5072 6576 3a20 5468 6520 5477 s, Prev: The Tw │ │ │ │ │ +00047360: 6f20 5061 7274 7320 6f66 2049 6e73 7461 o Parts of Insta │ │ │ │ │ +00047370: 6c6c 2c20 2055 703a 2049 6e73 7461 6c6c ll, Up: Install │ │ │ │ │ +00047380: 0a0a 3132 2e33 2045 7874 656e 6469 6e67 ..12.3 Extending │ │ │ │ │ +00047390: 2049 6e73 7461 6c6c 6174 696f 6e0a 3d3d Installation.== │ │ │ │ │ 000473a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000473b0: 3d3d 3d3d 3d3d 3d0a 0a49 7420 6973 2070 =======..It is p │ │ │ │ │ -000473c0: 6f73 7369 626c 6520 746f 2065 7874 656e ossible to exten │ │ │ │ │ -000473d0: 6420 7468 6973 206d 6563 6861 6e69 736d d this mechanism │ │ │ │ │ -000473e0: 2062 7920 6465 6669 6e69 6e67 2061 6e0a by defining an. │ │ │ │ │ -000473f0: 2769 6e73 7461 6c6c 2d65 7865 632d 6c6f 'install-exec-lo │ │ │ │ │ -00047400: 6361 6c27 206f 7220 2769 6e73 7461 6c6c cal' or 'install │ │ │ │ │ -00047410: 2d64 6174 612d 6c6f 6361 6c27 2072 756c -data-local' rul │ │ │ │ │ -00047420: 652e 2020 4966 2074 6865 7365 2072 756c e. If these rul │ │ │ │ │ -00047430: 6573 0a65 7869 7374 2c20 7468 6579 2077 es.exist, they w │ │ │ │ │ -00047440: 696c 6c20 6265 2072 756e 2061 7420 276d ill be run at 'm │ │ │ │ │ -00047450: 616b 6520 696e 7374 616c 6c27 2074 696d ake install' tim │ │ │ │ │ -00047460: 652e 2020 5468 6573 6520 7275 6c65 7320 e. These rules │ │ │ │ │ -00047470: 6361 6e20 646f 0a61 6c6d 6f73 7420 616e can do.almost an │ │ │ │ │ -00047480: 7974 6869 6e67 3b20 6361 7265 2069 7320 ything; care is │ │ │ │ │ -00047490: 7265 7175 6972 6564 2e0a 0a20 2020 4175 required... Au │ │ │ │ │ -000474a0: 746f 6d61 6b65 2061 6c73 6f20 7375 7070 tomake also supp │ │ │ │ │ -000474b0: 6f72 7473 2074 776f 2069 6e73 7461 6c6c orts two install │ │ │ │ │ -000474c0: 2068 6f6f 6b73 2c20 2769 6e73 7461 6c6c hooks, 'install │ │ │ │ │ -000474d0: 2d65 7865 632d 686f 6f6b 2720 616e 640a -exec-hook' and. │ │ │ │ │ -000474e0: 2769 6e73 7461 6c6c 2d64 6174 612d 686f 'install-data-ho │ │ │ │ │ -000474f0: 6f6b 272e 2020 5468 6573 6520 686f 6f6b ok'. These hook │ │ │ │ │ -00047500: 7320 6172 6520 7275 6e20 6166 7465 7220 s are run after │ │ │ │ │ -00047510: 616c 6c20 6f74 6865 7220 696e 7374 616c all other instal │ │ │ │ │ -00047520: 6c20 7275 6c65 730a 6f66 2074 6865 2061 l rules.of the a │ │ │ │ │ -00047530: 7070 726f 7072 6961 7465 2074 7970 652c ppropriate type, │ │ │ │ │ -00047540: 2065 7865 6320 6f72 2064 6174 612c 2068 exec or data, h │ │ │ │ │ -00047550: 6176 6520 636f 6d70 6c65 7465 642e 2020 ave completed. │ │ │ │ │ -00047560: 536f 2c20 666f 720a 696e 7374 616e 6365 So, for.instance │ │ │ │ │ -00047570: 2c20 6974 2069 7320 706f 7373 6962 6c65 , it is possible │ │ │ │ │ -00047580: 2074 6f20 7065 7266 6f72 6d20 706f 7374 to perform post │ │ │ │ │ -00047590: 2d69 6e73 7461 6c6c 6174 696f 6e20 6d6f -installation mo │ │ │ │ │ -000475a0: 6469 6669 6361 7469 6f6e 730a 7573 696e difications.usin │ │ │ │ │ -000475b0: 6720 616e 2069 6e73 7461 6c6c 2068 6f6f g an install hoo │ │ │ │ │ -000475c0: 6b2e 2020 2a4e 6f74 6520 4578 7465 6e64 k. *Note Extend │ │ │ │ │ -000475d0: 696e 673a 3a2c 2066 6f72 2073 6f6d 6520 ing::, for some │ │ │ │ │ -000475e0: 6578 616d 706c 6573 2e0a 0a1f 0a46 696c examples.....Fil │ │ │ │ │ -000475f0: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -00047600: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5374 .info, Node: St │ │ │ │ │ -00047610: 6167 6564 2049 6e73 7461 6c6c 732c 2020 aged Installs, │ │ │ │ │ -00047620: 4e65 7874 3a20 496e 7374 616c 6c20 5275 Next: Install Ru │ │ │ │ │ -00047630: 6c65 7320 666f 7220 7468 6520 5573 6572 les for the User │ │ │ │ │ -00047640: 2c20 2050 7265 763a 2045 7874 656e 6469 , Prev: Extendi │ │ │ │ │ -00047650: 6e67 2049 6e73 7461 6c6c 6174 696f 6e2c ng Installation, │ │ │ │ │ -00047660: 2020 5570 3a20 496e 7374 616c 6c0a 0a31 Up: Install..1 │ │ │ │ │ -00047670: 322e 3420 5374 6167 6564 2049 6e73 7461 2.4 Staged Insta │ │ │ │ │ -00047680: 6c6c 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d lls.============ │ │ │ │ │ -00047690: 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 ========..Automa │ │ │ │ │ -000476a0: 6b65 2067 656e 6572 6174 6573 2073 7570 ke generates sup │ │ │ │ │ -000476b0: 706f 7274 2066 6f72 2074 6865 2027 4445 port for the 'DE │ │ │ │ │ -000476c0: 5354 4449 5227 2076 6172 6961 626c 6520 STDIR' variable │ │ │ │ │ -000476d0: 696e 2061 6c6c 2069 6e73 7461 6c6c 0a72 in all install.r │ │ │ │ │ -000476e0: 756c 6573 2e20 2027 4445 5354 4449 5227 ules. 'DESTDIR' │ │ │ │ │ -000476f0: 2069 7320 7573 6564 2064 7572 696e 6720 is used during │ │ │ │ │ -00047700: 7468 6520 276d 616b 6520 696e 7374 616c the 'make instal │ │ │ │ │ -00047710: 6c27 2073 7465 7020 746f 2072 656c 6f63 l' step to reloc │ │ │ │ │ -00047720: 6174 650a 696e 7374 616c 6c20 6f62 6a65 ate.install obje │ │ │ │ │ -00047730: 6374 7320 696e 746f 2061 2073 7461 6769 cts into a stagi │ │ │ │ │ -00047740: 6e67 2061 7265 612e 2020 4561 6368 206f ng area. Each o │ │ │ │ │ -00047750: 626a 6563 7420 616e 6420 7061 7468 2069 bject and path i │ │ │ │ │ -00047760: 7320 7072 6566 6978 6564 0a77 6974 6820 s prefixed.with │ │ │ │ │ -00047770: 7468 6520 7661 6c75 6520 6f66 2027 4445 the value of 'DE │ │ │ │ │ -00047780: 5354 4449 5227 2062 6566 6f72 6520 6265 STDIR' before be │ │ │ │ │ -00047790: 696e 6720 636f 7069 6564 2069 6e74 6f20 ing copied into │ │ │ │ │ -000477a0: 7468 6520 696e 7374 616c 6c20 6172 6561 the install area │ │ │ │ │ -000477b0: 2e0a 4865 7265 2069 7320 616e 2065 7861 ..Here is an exa │ │ │ │ │ -000477c0: 6d70 6c65 206f 6620 7479 7069 6361 6c20 mple of typical │ │ │ │ │ -000477d0: 4445 5354 4449 5220 7573 6167 653a 0a0a DESTDIR usage:.. │ │ │ │ │ -000477e0: 2020 2020 206d 6b64 6972 202f 746d 702f mkdir /tmp/ │ │ │ │ │ -000477f0: 7374 6167 696e 6720 2626 0a20 2020 2020 staging &&. │ │ │ │ │ -00047800: 6d61 6b65 2044 4553 5444 4952 3d2f 746d make DESTDIR=/tm │ │ │ │ │ -00047810: 702f 7374 6167 696e 6720 696e 7374 616c p/staging instal │ │ │ │ │ -00047820: 6c0a 0a20 2020 5468 6520 276d 6b64 6972 l.. The 'mkdir │ │ │ │ │ -00047830: 2720 636f 6d6d 616e 6420 6176 6f69 6473 ' command avoids │ │ │ │ │ -00047840: 2061 2073 6563 7572 6974 7920 7072 6f62 a security prob │ │ │ │ │ -00047850: 6c65 6d20 6966 2074 6865 2061 7474 6163 lem if the attac │ │ │ │ │ -00047860: 6b65 7220 6372 6561 7465 730a 6120 7379 ker creates.a sy │ │ │ │ │ -00047870: 6d62 6f6c 6963 206c 696e 6b20 6672 6f6d mbolic link from │ │ │ │ │ -00047880: 2027 2f74 6d70 2f73 7461 6769 6e67 2720 '/tmp/staging' │ │ │ │ │ -00047890: 746f 2061 2076 6963 7469 6d20 6172 6561 to a victim area │ │ │ │ │ -000478a0: 3b20 7468 656e 2027 6d61 6b65 2720 706c ; then 'make' pl │ │ │ │ │ -000478b0: 6163 6573 0a69 6e73 7461 6c6c 206f 626a aces.install obj │ │ │ │ │ -000478c0: 6563 7473 2069 6e20 6120 6469 7265 6374 ects in a direct │ │ │ │ │ -000478d0: 6f72 7920 7472 6565 2062 7569 6c74 2075 ory tree built u │ │ │ │ │ -000478e0: 6e64 6572 2027 2f74 6d70 2f73 7461 6769 nder '/tmp/stagi │ │ │ │ │ -000478f0: 6e67 272e 2020 4966 0a27 2f67 6e75 2f62 ng'. If.'/gnu/b │ │ │ │ │ -00047900: 696e 2f66 6f6f 2720 616e 6420 272f 676e in/foo' and '/gn │ │ │ │ │ -00047910: 752f 7368 6172 652f 6163 6c6f 6361 6c2f u/share/aclocal/ │ │ │ │ │ -00047920: 666f 6f2e 6d34 2720 6172 6520 746f 2062 foo.m4' are to b │ │ │ │ │ -00047930: 6520 696e 7374 616c 6c65 642c 2074 6865 e installed, the │ │ │ │ │ -00047940: 0a61 626f 7665 2063 6f6d 6d61 6e64 2077 .above command w │ │ │ │ │ -00047950: 6f75 6c64 2069 6e73 7461 6c6c 2027 2f74 ould install '/t │ │ │ │ │ -00047960: 6d70 2f73 7461 6769 6e67 2f67 6e75 2f62 mp/staging/gnu/b │ │ │ │ │ -00047970: 696e 2f66 6f6f 2720 616e 640a 272f 746d in/foo' and.'/tm │ │ │ │ │ -00047980: 702f 7374 6167 696e 672f 676e 752f 7368 p/staging/gnu/sh │ │ │ │ │ -00047990: 6172 652f 6163 6c6f 6361 6c2f 666f 6f2e are/aclocal/foo. │ │ │ │ │ -000479a0: 6d34 272e 0a0a 2020 2054 6869 7320 6665 m4'... This fe │ │ │ │ │ -000479b0: 6174 7572 6520 6973 2063 6f6d 6d6f 6e6c ature is commonl │ │ │ │ │ -000479c0: 7920 7573 6564 2074 6f20 6275 696c 6420 y used to build │ │ │ │ │ -000479d0: 696e 7374 616c 6c20 696d 6167 6573 2061 install images a │ │ │ │ │ -000479e0: 6e64 2070 6163 6b61 6765 730a 282a 6e6f nd packages.(*no │ │ │ │ │ -000479f0: 7465 2044 4553 5444 4952 3a3a 292e 0a0a te DESTDIR::)... │ │ │ │ │ -00047a00: 2020 2053 7570 706f 7274 2066 6f72 2027 Support for ' │ │ │ │ │ -00047a10: 4445 5354 4449 5227 2069 7320 696d 706c DESTDIR' is impl │ │ │ │ │ -00047a20: 656d 656e 7465 6420 6279 2063 6f64 696e emented by codin │ │ │ │ │ -00047a30: 6720 6974 2064 6972 6563 746c 7920 696e g it directly in │ │ │ │ │ -00047a40: 746f 2074 6865 0a69 6e73 7461 6c6c 2072 to the.install r │ │ │ │ │ -00047a50: 756c 6573 2e20 2049 6620 796f 7572 2027 ules. If your ' │ │ │ │ │ -00047a60: 4d61 6b65 6669 6c65 2e61 6d27 2075 7365 Makefile.am' use │ │ │ │ │ -00047a70: 7320 6120 6c6f 6361 6c20 696e 7374 616c s a local instal │ │ │ │ │ -00047a80: 6c20 7275 6c65 2028 652e 672e 2c0a 2769 l rule (e.g.,.'i │ │ │ │ │ -00047a90: 6e73 7461 6c6c 2d65 7865 632d 6c6f 6361 nstall-exec-loca │ │ │ │ │ -00047aa0: 6c27 2920 6f72 2061 6e20 696e 7374 616c l') or an instal │ │ │ │ │ -00047ab0: 6c20 686f 6f6b 2c20 7468 656e 2079 6f75 l hook, then you │ │ │ │ │ -00047ac0: 206d 7573 7420 7772 6974 6520 7468 6174 must write that │ │ │ │ │ -00047ad0: 2063 6f64 650a 746f 2072 6573 7065 6374 code.to respect │ │ │ │ │ -00047ae0: 2027 4445 5354 4449 5227 2e0a 0a20 2020 'DESTDIR'... │ │ │ │ │ -00047af0: 2a4e 6f74 6520 2873 7461 6e64 6172 6473 *Note (standards │ │ │ │ │ -00047b00: 294d 616b 6566 696c 6520 436f 6e76 656e )Makefile Conven │ │ │ │ │ -00047b10: 7469 6f6e 733a 3a2c 2066 6f72 2061 6e6f tions::, for ano │ │ │ │ │ -00047b20: 7468 6572 2075 7361 6765 2065 7861 6d70 ther usage examp │ │ │ │ │ -00047b30: 6c65 2e0a 0a1f 0a46 696c 653a 2061 7574 le.....File: aut │ │ │ │ │ -00047b40: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -00047b50: 2020 4e6f 6465 3a20 496e 7374 616c 6c20 Node: Install │ │ │ │ │ -00047b60: 5275 6c65 7320 666f 7220 7468 6520 5573 Rules for the Us │ │ │ │ │ -00047b70: 6572 2c20 2050 7265 763a 2053 7461 6765 er, Prev: Stage │ │ │ │ │ -00047b80: 6420 496e 7374 616c 6c73 2c20 2055 703a d Installs, Up: │ │ │ │ │ -00047b90: 2049 6e73 7461 6c6c 0a0a 3132 2e35 2049 Install..12.5 I │ │ │ │ │ -00047ba0: 6e73 7461 6c6c 2052 756c 6573 2066 6f72 nstall Rules for │ │ │ │ │ -00047bb0: 2074 6865 2055 7365 720a 3d3d 3d3d 3d3d the User.====== │ │ │ │ │ +000473b0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 7420 6973 =========..It is │ │ │ │ │ +000473c0: 2070 6f73 7369 626c 6520 746f 2065 7874 possible to ext │ │ │ │ │ +000473d0: 656e 6420 7468 6973 206d 6563 6861 6e69 end this mechani │ │ │ │ │ +000473e0: 736d 2062 7920 6465 6669 6e69 6e67 2061 sm by defining a │ │ │ │ │ +000473f0: 6e0a 2769 6e73 7461 6c6c 2d65 7865 632d n.'install-exec- │ │ │ │ │ +00047400: 6c6f 6361 6c27 206f 7220 2769 6e73 7461 local' or 'insta │ │ │ │ │ +00047410: 6c6c 2d64 6174 612d 6c6f 6361 6c27 2072 ll-data-local' r │ │ │ │ │ +00047420: 756c 652e 2020 4966 2074 6865 7365 2072 ule. If these r │ │ │ │ │ +00047430: 756c 6573 0a65 7869 7374 2c20 7468 6579 ules.exist, they │ │ │ │ │ +00047440: 2077 696c 6c20 6265 2072 756e 2061 7420 will be run at │ │ │ │ │ +00047450: 276d 616b 6520 696e 7374 616c 6c27 2074 'make install' t │ │ │ │ │ +00047460: 696d 652e 2020 5468 6573 6520 7275 6c65 ime. These rule │ │ │ │ │ +00047470: 7320 6361 6e20 646f 0a61 6c6d 6f73 7420 s can do.almost │ │ │ │ │ +00047480: 616e 7974 6869 6e67 3b20 6361 7265 2069 anything; care i │ │ │ │ │ +00047490: 7320 7265 7175 6972 6564 2e0a 0a20 2020 s required... │ │ │ │ │ +000474a0: 4175 746f 6d61 6b65 2061 6c73 6f20 7375 Automake also su │ │ │ │ │ +000474b0: 7070 6f72 7473 2074 776f 2069 6e73 7461 pports two insta │ │ │ │ │ +000474c0: 6c6c 2068 6f6f 6b73 2c20 2769 6e73 7461 ll hooks, 'insta │ │ │ │ │ +000474d0: 6c6c 2d65 7865 632d 686f 6f6b 2720 616e ll-exec-hook' an │ │ │ │ │ +000474e0: 640a 2769 6e73 7461 6c6c 2d64 6174 612d d.'install-data- │ │ │ │ │ +000474f0: 686f 6f6b 272e 2020 5468 6573 6520 686f hook'. These ho │ │ │ │ │ +00047500: 6f6b 7320 6172 6520 7275 6e20 6166 7465 oks are run afte │ │ │ │ │ +00047510: 7220 616c 6c20 6f74 6865 7220 696e 7374 r all other inst │ │ │ │ │ +00047520: 616c 6c20 7275 6c65 730a 6f66 2074 6865 all rules.of the │ │ │ │ │ +00047530: 2061 7070 726f 7072 6961 7465 2074 7970 appropriate typ │ │ │ │ │ +00047540: 652c 2065 7865 6320 6f72 2064 6174 612c e, exec or data, │ │ │ │ │ +00047550: 2068 6176 6520 636f 6d70 6c65 7465 642e have completed. │ │ │ │ │ +00047560: 2020 536f 2c20 666f 720a 696e 7374 616e So, for.instan │ │ │ │ │ +00047570: 6365 2c20 6974 2069 7320 706f 7373 6962 ce, it is possib │ │ │ │ │ +00047580: 6c65 2074 6f20 7065 7266 6f72 6d20 706f le to perform po │ │ │ │ │ +00047590: 7374 2d69 6e73 7461 6c6c 6174 696f 6e20 st-installation │ │ │ │ │ +000475a0: 6d6f 6469 6669 6361 7469 6f6e 730a 7573 modifications.us │ │ │ │ │ +000475b0: 696e 6720 616e 2069 6e73 7461 6c6c 2068 ing an install h │ │ │ │ │ +000475c0: 6f6f 6b2e 2020 2a4e 6f74 6520 4578 7465 ook. *Note Exte │ │ │ │ │ +000475d0: 6e64 696e 673a 3a2c 2066 6f72 2073 6f6d nding::, for som │ │ │ │ │ +000475e0: 6520 6578 616d 706c 6573 2e0a 0a1f 0a46 e examples.....F │ │ │ │ │ +000475f0: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +00047600: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +00047610: 5374 6167 6564 2049 6e73 7461 6c6c 732c Staged Installs, │ │ │ │ │ +00047620: 2020 4e65 7874 3a20 496e 7374 616c 6c20 Next: Install │ │ │ │ │ +00047630: 5275 6c65 7320 666f 7220 7468 6520 5573 Rules for the Us │ │ │ │ │ +00047640: 6572 2c20 2050 7265 763a 2045 7874 656e er, Prev: Exten │ │ │ │ │ +00047650: 6469 6e67 2049 6e73 7461 6c6c 6174 696f ding Installatio │ │ │ │ │ +00047660: 6e2c 2020 5570 3a20 496e 7374 616c 6c0a n, Up: Install. │ │ │ │ │ +00047670: 0a31 322e 3420 5374 6167 6564 2049 6e73 .12.4 Staged Ins │ │ │ │ │ +00047680: 7461 6c6c 730a 3d3d 3d3d 3d3d 3d3d 3d3d talls.========== │ │ │ │ │ +00047690: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f ==========..Auto │ │ │ │ │ +000476a0: 6d61 6b65 2067 656e 6572 6174 6573 2073 make generates s │ │ │ │ │ +000476b0: 7570 706f 7274 2066 6f72 2074 6865 2027 upport for the ' │ │ │ │ │ +000476c0: 4445 5354 4449 5227 2076 6172 6961 626c DESTDIR' variabl │ │ │ │ │ +000476d0: 6520 696e 2061 6c6c 2069 6e73 7461 6c6c e in all install │ │ │ │ │ +000476e0: 0a72 756c 6573 2e20 2027 4445 5354 4449 .rules. 'DESTDI │ │ │ │ │ +000476f0: 5227 2069 7320 7573 6564 2064 7572 696e R' is used durin │ │ │ │ │ +00047700: 6720 7468 6520 276d 616b 6520 696e 7374 g the 'make inst │ │ │ │ │ +00047710: 616c 6c27 2073 7465 7020 746f 2072 656c all' step to rel │ │ │ │ │ +00047720: 6f63 6174 650a 696e 7374 616c 6c20 6f62 ocate.install ob │ │ │ │ │ +00047730: 6a65 6374 7320 696e 746f 2061 2073 7461 jects into a sta │ │ │ │ │ +00047740: 6769 6e67 2061 7265 612e 2020 4561 6368 ging area. Each │ │ │ │ │ +00047750: 206f 626a 6563 7420 616e 6420 7061 7468 object and path │ │ │ │ │ +00047760: 2069 7320 7072 6566 6978 6564 0a77 6974 is prefixed.wit │ │ │ │ │ +00047770: 6820 7468 6520 7661 6c75 6520 6f66 2027 h the value of ' │ │ │ │ │ +00047780: 4445 5354 4449 5227 2062 6566 6f72 6520 DESTDIR' before │ │ │ │ │ +00047790: 6265 696e 6720 636f 7069 6564 2069 6e74 being copied int │ │ │ │ │ +000477a0: 6f20 7468 6520 696e 7374 616c 6c20 6172 o the install ar │ │ │ │ │ +000477b0: 6561 2e0a 4865 7265 2069 7320 616e 2065 ea..Here is an e │ │ │ │ │ +000477c0: 7861 6d70 6c65 206f 6620 7479 7069 6361 xample of typica │ │ │ │ │ +000477d0: 6c20 4445 5354 4449 5220 7573 6167 653a l DESTDIR usage: │ │ │ │ │ +000477e0: 0a0a 2020 2020 206d 6b64 6972 202f 746d .. mkdir /tm │ │ │ │ │ +000477f0: 702f 7374 6167 696e 6720 2626 0a20 2020 p/staging &&. │ │ │ │ │ +00047800: 2020 6d61 6b65 2044 4553 5444 4952 3d2f make DESTDIR=/ │ │ │ │ │ +00047810: 746d 702f 7374 6167 696e 6720 696e 7374 tmp/staging inst │ │ │ │ │ +00047820: 616c 6c0a 0a20 2020 5468 6520 276d 6b64 all.. The 'mkd │ │ │ │ │ +00047830: 6972 2720 636f 6d6d 616e 6420 6176 6f69 ir' command avoi │ │ │ │ │ +00047840: 6473 2061 2073 6563 7572 6974 7920 7072 ds a security pr │ │ │ │ │ +00047850: 6f62 6c65 6d20 6966 2074 6865 2061 7474 oblem if the att │ │ │ │ │ +00047860: 6163 6b65 7220 6372 6561 7465 730a 6120 acker creates.a │ │ │ │ │ +00047870: 7379 6d62 6f6c 6963 206c 696e 6b20 6672 symbolic link fr │ │ │ │ │ +00047880: 6f6d 2027 2f74 6d70 2f73 7461 6769 6e67 om '/tmp/staging │ │ │ │ │ +00047890: 2720 746f 2061 2076 6963 7469 6d20 6172 ' to a victim ar │ │ │ │ │ +000478a0: 6561 3b20 7468 656e 2027 6d61 6b65 2720 ea; then 'make' │ │ │ │ │ +000478b0: 706c 6163 6573 0a69 6e73 7461 6c6c 206f places.install o │ │ │ │ │ +000478c0: 626a 6563 7473 2069 6e20 6120 6469 7265 bjects in a dire │ │ │ │ │ +000478d0: 6374 6f72 7920 7472 6565 2062 7569 6c74 ctory tree built │ │ │ │ │ +000478e0: 2075 6e64 6572 2027 2f74 6d70 2f73 7461 under '/tmp/sta │ │ │ │ │ +000478f0: 6769 6e67 272e 2020 4966 0a27 2f67 6e75 ging'. If.'/gnu │ │ │ │ │ +00047900: 2f62 696e 2f66 6f6f 2720 616e 6420 272f /bin/foo' and '/ │ │ │ │ │ +00047910: 676e 752f 7368 6172 652f 6163 6c6f 6361 gnu/share/acloca │ │ │ │ │ +00047920: 6c2f 666f 6f2e 6d34 2720 6172 6520 746f l/foo.m4' are to │ │ │ │ │ +00047930: 2062 6520 696e 7374 616c 6c65 642c 2074 be installed, t │ │ │ │ │ +00047940: 6865 0a61 626f 7665 2063 6f6d 6d61 6e64 he.above command │ │ │ │ │ +00047950: 2077 6f75 6c64 2069 6e73 7461 6c6c 2027 would install ' │ │ │ │ │ +00047960: 2f74 6d70 2f73 7461 6769 6e67 2f67 6e75 /tmp/staging/gnu │ │ │ │ │ +00047970: 2f62 696e 2f66 6f6f 2720 616e 640a 272f /bin/foo' and.'/ │ │ │ │ │ +00047980: 746d 702f 7374 6167 696e 672f 676e 752f tmp/staging/gnu/ │ │ │ │ │ +00047990: 7368 6172 652f 6163 6c6f 6361 6c2f 666f share/aclocal/fo │ │ │ │ │ +000479a0: 6f2e 6d34 272e 0a0a 2020 2054 6869 7320 o.m4'... This │ │ │ │ │ +000479b0: 6665 6174 7572 6520 6973 2063 6f6d 6d6f feature is commo │ │ │ │ │ +000479c0: 6e6c 7920 7573 6564 2074 6f20 6275 696c nly used to buil │ │ │ │ │ +000479d0: 6420 696e 7374 616c 6c20 696d 6167 6573 d install images │ │ │ │ │ +000479e0: 2061 6e64 2070 6163 6b61 6765 730a 282a and packages.(* │ │ │ │ │ +000479f0: 6e6f 7465 2044 4553 5444 4952 3a3a 292e note DESTDIR::). │ │ │ │ │ +00047a00: 0a0a 2020 2053 7570 706f 7274 2066 6f72 .. Support for │ │ │ │ │ +00047a10: 2027 4445 5354 4449 5227 2069 7320 696d 'DESTDIR' is im │ │ │ │ │ +00047a20: 706c 656d 656e 7465 6420 6279 2063 6f64 plemented by cod │ │ │ │ │ +00047a30: 696e 6720 6974 2064 6972 6563 746c 7920 ing it directly │ │ │ │ │ +00047a40: 696e 746f 2074 6865 0a69 6e73 7461 6c6c into the.install │ │ │ │ │ +00047a50: 2072 756c 6573 2e20 2049 6620 796f 7572 rules. If your │ │ │ │ │ +00047a60: 2027 4d61 6b65 6669 6c65 2e61 6d27 2075 'Makefile.am' u │ │ │ │ │ +00047a70: 7365 7320 6120 6c6f 6361 6c20 696e 7374 ses a local inst │ │ │ │ │ +00047a80: 616c 6c20 7275 6c65 2028 652e 672e 2c0a all rule (e.g.,. │ │ │ │ │ +00047a90: 2769 6e73 7461 6c6c 2d65 7865 632d 6c6f 'install-exec-lo │ │ │ │ │ +00047aa0: 6361 6c27 2920 6f72 2061 6e20 696e 7374 cal') or an inst │ │ │ │ │ +00047ab0: 616c 6c20 686f 6f6b 2c20 7468 656e 2079 all hook, then y │ │ │ │ │ +00047ac0: 6f75 206d 7573 7420 7772 6974 6520 7468 ou must write th │ │ │ │ │ +00047ad0: 6174 2063 6f64 650a 746f 2072 6573 7065 at code.to respe │ │ │ │ │ +00047ae0: 6374 2027 4445 5354 4449 5227 2e0a 0a20 ct 'DESTDIR'... │ │ │ │ │ +00047af0: 2020 2a4e 6f74 6520 2873 7461 6e64 6172 *Note (standar │ │ │ │ │ +00047b00: 6473 294d 616b 6566 696c 6520 436f 6e76 ds)Makefile Conv │ │ │ │ │ +00047b10: 656e 7469 6f6e 733a 3a2c 2066 6f72 2061 entions::, for a │ │ │ │ │ +00047b20: 6e6f 7468 6572 2075 7361 6765 2065 7861 nother usage exa │ │ │ │ │ +00047b30: 6d70 6c65 2e0a 0a1f 0a46 696c 653a 2061 mple.....File: a │ │ │ │ │ +00047b40: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +00047b50: 6f2c 2020 4e6f 6465 3a20 496e 7374 616c o, Node: Instal │ │ │ │ │ +00047b60: 6c20 5275 6c65 7320 666f 7220 7468 6520 l Rules for the │ │ │ │ │ +00047b70: 5573 6572 2c20 2050 7265 763a 2053 7461 User, Prev: Sta │ │ │ │ │ +00047b80: 6765 6420 496e 7374 616c 6c73 2c20 2055 ged Installs, U │ │ │ │ │ +00047b90: 703a 2049 6e73 7461 6c6c 0a0a 3132 2e35 p: Install..12.5 │ │ │ │ │ +00047ba0: 2049 6e73 7461 6c6c 2052 756c 6573 2066 Install Rules f │ │ │ │ │ +00047bb0: 6f72 2074 6865 2055 7365 720a 3d3d 3d3d or the User.==== │ │ │ │ │ 00047bc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00047bd0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 6f6d =========..Autom │ │ │ │ │ -00047be0: 616b 6520 616c 736f 2067 656e 6572 6174 ake also generat │ │ │ │ │ -00047bf0: 6573 2072 756c 6573 2066 6f72 2074 6172 es rules for tar │ │ │ │ │ -00047c00: 6765 7473 2027 756e 696e 7374 616c 6c27 gets 'uninstall' │ │ │ │ │ -00047c10: 2c20 2769 6e73 7461 6c6c 6469 7273 272c , 'installdirs', │ │ │ │ │ -00047c20: 0a61 6e64 2027 696e 7374 616c 6c2d 7374 .and 'install-st │ │ │ │ │ -00047c30: 7269 7027 2e0a 0a20 2020 4175 746f 6d61 rip'... Automa │ │ │ │ │ -00047c40: 6b65 2073 7570 706f 7274 7320 2775 6e69 ke supports 'uni │ │ │ │ │ -00047c50: 6e73 7461 6c6c 2d6c 6f63 616c 2720 616e nstall-local' an │ │ │ │ │ -00047c60: 6420 2775 6e69 6e73 7461 6c6c 2d68 6f6f d 'uninstall-hoo │ │ │ │ │ -00047c70: 6b27 2e20 2054 6865 7265 2069 730a 6e6f k'. There is.no │ │ │ │ │ -00047c80: 206e 6f74 696f 6e20 6f66 2073 6570 6172 notion of separ │ │ │ │ │ -00047c90: 6174 6520 756e 696e 7374 616c 6c73 2066 ate uninstalls f │ │ │ │ │ -00047ca0: 6f72 2022 6578 6563 2220 616e 6420 2264 or "exec" and "d │ │ │ │ │ -00047cb0: 6174 6122 2c20 6173 2074 6865 7365 0a66 ata", as these.f │ │ │ │ │ -00047cc0: 6561 7475 7265 7320 776f 756c 6420 6e6f eatures would no │ │ │ │ │ -00047cd0: 7420 7072 6f76 6964 6520 6164 6469 7469 t provide additi │ │ │ │ │ -00047ce0: 6f6e 616c 2066 756e 6374 696f 6e61 6c69 onal functionali │ │ │ │ │ -00047cf0: 7479 2e0a 0a20 2020 4e6f 7465 2074 6861 ty... Note tha │ │ │ │ │ -00047d00: 7420 2775 6e69 6e73 7461 6c6c 2720 6973 t 'uninstall' is │ │ │ │ │ -00047d10: 206e 6f74 206d 6561 6e74 2061 7320 6120 not meant as a │ │ │ │ │ -00047d20: 7265 706c 6163 656d 656e 7420 666f 7220 replacement for │ │ │ │ │ -00047d30: 6120 7265 616c 0a70 6163 6b61 6769 6e67 a real.packaging │ │ │ │ │ -00047d40: 2074 6f6f 6c2e 0a0a 1f0a 4669 6c65 3a20 tool.....File: │ │ │ │ │ -00047d50: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -00047d60: 666f 2c20 204e 6f64 653a 2043 6c65 616e fo, Node: Clean │ │ │ │ │ -00047d70: 2c20 204e 6578 743a 2044 6973 742c 2020 , Next: Dist, │ │ │ │ │ -00047d80: 5072 6576 3a20 496e 7374 616c 6c2c 2020 Prev: Install, │ │ │ │ │ -00047d90: 5570 3a20 546f 700a 0a31 3320 5768 6174 Up: Top..13 What │ │ │ │ │ -00047da0: 2047 6574 7320 436c 6561 6e65 640a 2a2a Gets Cleaned.** │ │ │ │ │ +00047bd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 ===========..Aut │ │ │ │ │ +00047be0: 6f6d 616b 6520 616c 736f 2067 656e 6572 omake also gener │ │ │ │ │ +00047bf0: 6174 6573 2072 756c 6573 2066 6f72 2074 ates rules for t │ │ │ │ │ +00047c00: 6172 6765 7473 2027 756e 696e 7374 616c argets 'uninstal │ │ │ │ │ +00047c10: 6c27 2c20 2769 6e73 7461 6c6c 6469 7273 l', 'installdirs │ │ │ │ │ +00047c20: 272c 0a61 6e64 2027 696e 7374 616c 6c2d ',.and 'install- │ │ │ │ │ +00047c30: 7374 7269 7027 2e0a 0a20 2020 4175 746f strip'... Auto │ │ │ │ │ +00047c40: 6d61 6b65 2073 7570 706f 7274 7320 2775 make supports 'u │ │ │ │ │ +00047c50: 6e69 6e73 7461 6c6c 2d6c 6f63 616c 2720 ninstall-local' │ │ │ │ │ +00047c60: 616e 6420 2775 6e69 6e73 7461 6c6c 2d68 and 'uninstall-h │ │ │ │ │ +00047c70: 6f6f 6b27 2e20 2054 6865 7265 2069 730a ook'. There is. │ │ │ │ │ +00047c80: 6e6f 206e 6f74 696f 6e20 6f66 2073 6570 no notion of sep │ │ │ │ │ +00047c90: 6172 6174 6520 756e 696e 7374 616c 6c73 arate uninstalls │ │ │ │ │ +00047ca0: 2066 6f72 2022 6578 6563 2220 616e 6420 for "exec" and │ │ │ │ │ +00047cb0: 2264 6174 6122 2c20 6173 2074 6865 7365 "data", as these │ │ │ │ │ +00047cc0: 0a66 6561 7475 7265 7320 776f 756c 6420 .features would │ │ │ │ │ +00047cd0: 6e6f 7420 7072 6f76 6964 6520 6164 6469 not provide addi │ │ │ │ │ +00047ce0: 7469 6f6e 616c 2066 756e 6374 696f 6e61 tional functiona │ │ │ │ │ +00047cf0: 6c69 7479 2e0a 0a20 2020 4e6f 7465 2074 lity... Note t │ │ │ │ │ +00047d00: 6861 7420 2775 6e69 6e73 7461 6c6c 2720 hat 'uninstall' │ │ │ │ │ +00047d10: 6973 206e 6f74 206d 6561 6e74 2061 7320 is not meant as │ │ │ │ │ +00047d20: 6120 7265 706c 6163 656d 656e 7420 666f a replacement fo │ │ │ │ │ +00047d30: 7220 6120 7265 616c 0a70 6163 6b61 6769 r a real.packagi │ │ │ │ │ +00047d40: 6e67 2074 6f6f 6c2e 0a0a 1f0a 4669 6c65 ng tool.....File │ │ │ │ │ +00047d50: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +00047d60: 696e 666f 2c20 204e 6f64 653a 2043 6c65 info, Node: Cle │ │ │ │ │ +00047d70: 616e 2c20 204e 6578 743a 2044 6973 742c an, Next: Dist, │ │ │ │ │ +00047d80: 2020 5072 6576 3a20 496e 7374 616c 6c2c Prev: Install, │ │ │ │ │ +00047d90: 2020 5570 3a20 546f 700a 0a31 3320 5768 Up: Top..13 Wh │ │ │ │ │ +00047da0: 6174 2047 6574 7320 436c 6561 6e65 640a at Gets Cleaned. │ │ │ │ │ 00047db0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00047dc0: 2a2a 0a0a 5468 6520 474e 5520 4d61 6b65 **..The GNU Make │ │ │ │ │ -00047dd0: 6669 6c65 2053 7461 6e64 6172 6473 2073 file Standards s │ │ │ │ │ -00047de0: 7065 6369 6679 2061 206e 756d 6265 7220 pecify a number │ │ │ │ │ -00047df0: 6f66 2064 6966 6665 7265 6e74 2063 6c65 of different cle │ │ │ │ │ -00047e00: 616e 2072 756c 6573 2e0a 2a4e 6f74 6520 an rules..*Note │ │ │ │ │ -00047e10: 5374 616e 6461 7264 2054 6172 6765 7473 Standard Targets │ │ │ │ │ -00047e20: 2066 6f72 2055 7365 7273 3a20 2873 7461 for Users: (sta │ │ │ │ │ -00047e30: 6e64 6172 6473 2953 7461 6e64 6172 6420 ndards)Standard │ │ │ │ │ -00047e40: 5461 7267 6574 732e 0a0a 2020 2047 656e Targets... Gen │ │ │ │ │ -00047e50: 6572 616c 6c79 2074 6865 2066 696c 6573 erally the files │ │ │ │ │ -00047e60: 2074 6861 7420 6361 6e20 6265 2063 6c65 that can be cle │ │ │ │ │ -00047e70: 616e 6564 2061 7265 2064 6574 6572 6d69 aned are determi │ │ │ │ │ -00047e80: 6e65 6420 6175 746f 6d61 7469 6361 6c6c ned automaticall │ │ │ │ │ -00047e90: 790a 6279 2041 7574 6f6d 616b 652e 2020 y.by Automake. │ │ │ │ │ -00047ea0: 4f66 2063 6f75 7273 652c 2041 7574 6f6d Of course, Autom │ │ │ │ │ -00047eb0: 616b 6520 616c 736f 2072 6563 6f67 6e69 ake also recogni │ │ │ │ │ -00047ec0: 7a65 7320 736f 6d65 2076 6172 6961 626c zes some variabl │ │ │ │ │ -00047ed0: 6573 2074 6861 740a 6361 6e20 6265 2064 es that.can be d │ │ │ │ │ -00047ee0: 6566 696e 6564 2074 6f20 7370 6563 6966 efined to specif │ │ │ │ │ -00047ef0: 7920 6164 6469 7469 6f6e 616c 2066 696c y additional fil │ │ │ │ │ -00047f00: 6573 2074 6f20 636c 6561 6e2e 2020 5468 es to clean. Th │ │ │ │ │ -00047f10: 6573 6520 7661 7269 6162 6c65 730a 6172 ese variables.ar │ │ │ │ │ -00047f20: 6520 274d 4f53 544c 5943 4c45 414e 4649 e 'MOSTLYCLEANFI │ │ │ │ │ -00047f30: 4c45 5327 2c20 2743 4c45 414e 4649 4c45 LES', 'CLEANFILE │ │ │ │ │ -00047f40: 5327 2c20 2744 4953 5443 4c45 414e 4649 S', 'DISTCLEANFI │ │ │ │ │ -00047f50: 4c45 5327 2c20 616e 640a 274d 4149 4e54 LES', and.'MAINT │ │ │ │ │ -00047f60: 4149 4e45 5243 4c45 414e 4649 4c45 5327 AINERCLEANFILES' │ │ │ │ │ -00047f70: 2e0a 0a20 2020 5768 656e 2063 6c65 616e ... When clean │ │ │ │ │ -00047f80: 696e 6720 696e 766f 6c76 6573 206d 6f72 ing involves mor │ │ │ │ │ -00047f90: 6520 7468 616e 2064 656c 6574 696e 6720 e than deleting │ │ │ │ │ -00047fa0: 736f 6d65 2068 6172 642d 636f 6465 6420 some hard-coded │ │ │ │ │ -00047fb0: 6c69 7374 206f 660a 6669 6c65 732c 2069 list of.files, i │ │ │ │ │ -00047fc0: 7420 6973 2061 6c73 6f20 706f 7373 6962 t is also possib │ │ │ │ │ -00047fd0: 6c65 2074 6f20 7375 7070 6c65 6d65 6e74 le to supplement │ │ │ │ │ -00047fe0: 2074 6865 2063 6c65 616e 696e 6720 7275 the cleaning ru │ │ │ │ │ -00047ff0: 6c65 7320 7769 7468 2079 6f75 720a 6f77 les with your.ow │ │ │ │ │ -00048000: 6e20 636f 6d6d 616e 6473 2e20 2053 696d n commands. Sim │ │ │ │ │ -00048010: 706c 7920 6465 6669 6e65 2061 2072 756c ply define a rul │ │ │ │ │ -00048020: 6520 666f 7220 616e 7920 6f66 2074 6865 e for any of the │ │ │ │ │ -00048030: 2027 6d6f 7374 6c79 636c 6561 6e2d 6c6f 'mostlyclean-lo │ │ │ │ │ -00048040: 6361 6c27 2c0a 2763 6c65 616e 2d6c 6f63 cal',.'clean-loc │ │ │ │ │ -00048050: 616c 272c 2027 6469 7374 636c 6561 6e2d al', 'distclean- │ │ │ │ │ -00048060: 6c6f 6361 6c27 2c20 6f72 2027 6d61 696e local', or 'main │ │ │ │ │ -00048070: 7461 696e 6572 2d63 6c65 616e 2d6c 6f63 tainer-clean-loc │ │ │ │ │ -00048080: 616c 2720 7461 7267 6574 730a 282a 6e6f al' targets.(*no │ │ │ │ │ -00048090: 7465 2045 7874 656e 6469 6e67 3a3a 292e te Extending::). │ │ │ │ │ -000480a0: 2020 4120 636f 6d6d 6f6e 2063 6173 6520 A common case │ │ │ │ │ -000480b0: 6973 2064 656c 6574 696e 6720 6120 6469 is deleting a di │ │ │ │ │ -000480c0: 7265 6374 6f72 792c 2066 6f72 0a69 6e73 rectory, for.ins │ │ │ │ │ -000480d0: 7461 6e63 652c 2061 2064 6972 6563 746f tance, a directo │ │ │ │ │ -000480e0: 7279 2063 7265 6174 6564 2062 7920 7468 ry created by th │ │ │ │ │ -000480f0: 6520 7465 7374 2073 7569 7465 3a0a 0a20 e test suite:.. │ │ │ │ │ -00048100: 2020 2020 636c 6561 6e2d 6c6f 6361 6c3a clean-local: │ │ │ │ │ -00048110: 0a20 2020 2020 2020 2020 2020 2020 2d72 . -r │ │ │ │ │ -00048120: 6d20 2d72 6620 7465 7374 5375 6244 6972 m -rf testSubDir │ │ │ │ │ -00048130: 0a0a 2020 2053 696e 6365 2027 6d61 6b65 .. Since 'make │ │ │ │ │ -00048140: 2720 616c 6c6f 7773 206f 6e6c 7920 6f6e ' allows only on │ │ │ │ │ -00048150: 6520 7365 7420 6f66 2072 756c 6573 2066 e set of rules f │ │ │ │ │ -00048160: 6f72 2061 2067 6976 656e 2074 6172 6765 or a given targe │ │ │ │ │ -00048170: 742c 2061 206d 6f72 650a 6578 7465 6e73 t, a more.extens │ │ │ │ │ -00048180: 6962 6c65 2077 6179 206f 6620 7772 6974 ible way of writ │ │ │ │ │ -00048190: 696e 6720 7468 6973 2069 7320 746f 2075 ing this is to u │ │ │ │ │ -000481a0: 7365 2061 2073 6570 6172 6174 6520 7461 se a separate ta │ │ │ │ │ -000481b0: 7267 6574 206c 6973 7465 6420 6173 2061 rget listed as a │ │ │ │ │ -000481c0: 0a64 6570 656e 6465 6e63 793a 0a0a 2020 .dependency:.. │ │ │ │ │ -000481d0: 2020 2063 6c65 616e 2d6c 6f63 616c 3a20 clean-local: │ │ │ │ │ -000481e0: 636c 6561 6e2d 6c6f 6361 6c2d 6368 6563 clean-local-chec │ │ │ │ │ -000481f0: 6b0a 2020 2020 202e 5048 4f4e 593a 2063 k. .PHONY: c │ │ │ │ │ -00048200: 6c65 616e 2d6c 6f63 616c 2d63 6865 636b lean-local-check │ │ │ │ │ -00048210: 0a20 2020 2020 636c 6561 6e2d 6c6f 6361 . clean-loca │ │ │ │ │ -00048220: 6c2d 6368 6563 6b3a 0a20 2020 2020 2020 l-check:. │ │ │ │ │ -00048230: 2020 2020 2020 2d72 6d20 2d72 6620 7465 -rm -rf te │ │ │ │ │ -00048240: 7374 5375 6244 6972 0a0a 2020 2041 7320 stSubDir.. As │ │ │ │ │ -00048250: 7468 6520 474e 5520 5374 616e 6461 7264 the GNU Standard │ │ │ │ │ -00048260: 7320 6172 656e 2774 2061 6c77 6179 7320 s aren't always │ │ │ │ │ -00048270: 6578 706c 6963 6974 2061 7320 746f 2077 explicit as to w │ │ │ │ │ -00048280: 6869 6368 2066 696c 6573 2073 686f 756c hich files shoul │ │ │ │ │ -00048290: 640a 6265 2072 656d 6f76 6564 2062 7920 d.be removed by │ │ │ │ │ -000482a0: 7768 6963 6820 7275 6c65 2c20 7765 2776 which rule, we'v │ │ │ │ │ -000482b0: 6520 6164 6f70 7465 6420 6120 6865 7572 e adopted a heur │ │ │ │ │ -000482c0: 6973 7469 6320 7468 6174 2077 6520 6265 istic that we be │ │ │ │ │ -000482d0: 6c69 6576 6520 7761 730a 6669 7273 7420 lieve was.first │ │ │ │ │ -000482e0: 666f 726d 756c 6174 6564 2062 7920 4672 formulated by Fr │ │ │ │ │ -000482f0: 616e c3a7 6f69 7320 5069 6e61 7264 3a0a an..ois Pinard:. │ │ │ │ │ -00048300: 0a20 2020 2a20 4966 2027 6d61 6b65 2720 . * If 'make' │ │ │ │ │ -00048310: 6275 696c 7420 6974 2c20 616e 6420 6974 built it, and it │ │ │ │ │ -00048320: 2069 7320 636f 6d6d 6f6e 6c79 2073 6f6d is commonly som │ │ │ │ │ -00048330: 6574 6869 6e67 2074 6861 7420 6f6e 6520 ething that one │ │ │ │ │ -00048340: 776f 756c 640a 2020 2020 2077 616e 7420 would. want │ │ │ │ │ -00048350: 746f 2072 6562 7569 6c64 2028 666f 7220 to rebuild (for │ │ │ │ │ -00048360: 696e 7374 616e 6365 2c20 6120 272e 6f27 instance, a '.o' │ │ │ │ │ -00048370: 2066 696c 6529 2c20 7468 656e 2027 6d6f file), then 'mo │ │ │ │ │ -00048380: 7374 6c79 636c 6561 6e27 0a20 2020 2020 stlyclean'. │ │ │ │ │ -00048390: 7368 6f75 6c64 2064 656c 6574 6520 6974 should delete it │ │ │ │ │ -000483a0: 2e0a 0a20 2020 2a20 4f74 6865 7277 6973 ... * Otherwis │ │ │ │ │ -000483b0: 652c 2069 6620 276d 616b 6527 2062 7569 e, if 'make' bui │ │ │ │ │ -000483c0: 6c74 2069 742c 2074 6865 6e20 2763 6c65 lt it, then 'cle │ │ │ │ │ -000483d0: 616e 2720 7368 6f75 6c64 2064 656c 6574 an' should delet │ │ │ │ │ -000483e0: 6520 6974 2e0a 0a20 2020 2a20 4966 2027 e it... * If ' │ │ │ │ │ -000483f0: 636f 6e66 6967 7572 6527 2062 7569 6c74 configure' built │ │ │ │ │ -00048400: 2069 742c 2074 6865 6e20 2764 6973 7463 it, then 'distc │ │ │ │ │ -00048410: 6c65 616e 2720 7368 6f75 6c64 2064 656c lean' should del │ │ │ │ │ -00048420: 6574 6520 6974 2e0a 0a20 2020 2a20 4966 ete it... * If │ │ │ │ │ -00048430: 2074 6865 206d 6169 6e74 6169 6e65 7220 the maintainer │ │ │ │ │ -00048440: 6275 696c 7420 6974 2028 666f 7220 696e built it (for in │ │ │ │ │ -00048450: 7374 616e 6365 2c20 6120 272e 696e 666f stance, a '.info │ │ │ │ │ -00048460: 2720 6669 6c65 292c 2074 6865 6e0a 2020 ' file), then. │ │ │ │ │ -00048470: 2020 2027 6d61 696e 7461 696e 6572 2d63 'maintainer-c │ │ │ │ │ -00048480: 6c65 616e 2720 7368 6f75 6c64 2064 656c lean' should del │ │ │ │ │ -00048490: 6574 6520 6974 2e20 2048 6f77 6576 6572 ete it. However │ │ │ │ │ -000484a0: 2027 6d61 696e 7461 696e 6572 2d63 6c65 'maintainer-cle │ │ │ │ │ -000484b0: 616e 270a 2020 2020 2073 686f 756c 6420 an'. should │ │ │ │ │ -000484c0: 6e6f 7420 6465 6c65 7465 2061 6e79 7468 not delete anyth │ │ │ │ │ -000484d0: 696e 6720 7468 6174 206e 6565 6473 2074 ing that needs t │ │ │ │ │ -000484e0: 6f20 6578 6973 7420 696e 206f 7264 6572 o exist in order │ │ │ │ │ -000484f0: 2074 6f20 7275 6e0a 2020 2020 2027 2e2f to run. './ │ │ │ │ │ -00048500: 636f 6e66 6967 7572 6520 2626 206d 616b configure && mak │ │ │ │ │ -00048510: 6527 2e0a 0a20 2020 5765 2072 6563 6f6d e'... We recom │ │ │ │ │ -00048520: 6d65 6e64 2074 6861 7420 796f 7520 666f mend that you fo │ │ │ │ │ -00048530: 6c6c 6f77 2074 6869 7320 7361 6d65 2073 llow this same s │ │ │ │ │ -00048540: 6574 206f 6620 6865 7572 6973 7469 6373 et of heuristics │ │ │ │ │ -00048550: 2069 6e20 796f 7572 0a27 4d61 6b65 6669 in your.'Makefi │ │ │ │ │ -00048560: 6c65 2e61 6d27 2e0a 0a1f 0a46 696c 653a le.am'.....File: │ │ │ │ │ -00048570: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ -00048580: 6e66 6f2c 2020 4e6f 6465 3a20 4469 7374 nfo, Node: Dist │ │ │ │ │ -00048590: 2c20 204e 6578 743a 2054 6573 7473 2c20 , Next: Tests, │ │ │ │ │ -000485a0: 2050 7265 763a 2043 6c65 616e 2c20 2055 Prev: Clean, U │ │ │ │ │ -000485b0: 703a 2054 6f70 0a0a 3134 2057 6861 7420 p: Top..14 What │ │ │ │ │ -000485c0: 476f 6573 2069 6e20 6120 4469 7374 7269 Goes in a Distri │ │ │ │ │ -000485d0: 6275 7469 6f6e 0a2a 2a2a 2a2a 2a2a 2a2a bution.********* │ │ │ │ │ +00047dc0: 2a2a 2a2a 0a0a 5468 6520 474e 5520 4d61 ****..The GNU Ma │ │ │ │ │ +00047dd0: 6b65 6669 6c65 2053 7461 6e64 6172 6473 kefile Standards │ │ │ │ │ +00047de0: 2073 7065 6369 6679 2061 206e 756d 6265 specify a numbe │ │ │ │ │ +00047df0: 7220 6f66 2064 6966 6665 7265 6e74 2063 r of different c │ │ │ │ │ +00047e00: 6c65 616e 2072 756c 6573 2e0a 2a4e 6f74 lean rules..*Not │ │ │ │ │ +00047e10: 6520 5374 616e 6461 7264 2054 6172 6765 e Standard Targe │ │ │ │ │ +00047e20: 7473 2066 6f72 2055 7365 7273 3a20 2873 ts for Users: (s │ │ │ │ │ +00047e30: 7461 6e64 6172 6473 2953 7461 6e64 6172 tandards)Standar │ │ │ │ │ +00047e40: 6420 5461 7267 6574 732e 0a0a 2020 2047 d Targets... G │ │ │ │ │ +00047e50: 656e 6572 616c 6c79 2074 6865 2066 696c enerally the fil │ │ │ │ │ +00047e60: 6573 2074 6861 7420 6361 6e20 6265 2063 es that can be c │ │ │ │ │ +00047e70: 6c65 616e 6564 2061 7265 2064 6574 6572 leaned are deter │ │ │ │ │ +00047e80: 6d69 6e65 6420 6175 746f 6d61 7469 6361 mined automatica │ │ │ │ │ +00047e90: 6c6c 790a 6279 2041 7574 6f6d 616b 652e lly.by Automake. │ │ │ │ │ +00047ea0: 2020 4f66 2063 6f75 7273 652c 2041 7574 Of course, Aut │ │ │ │ │ +00047eb0: 6f6d 616b 6520 616c 736f 2072 6563 6f67 omake also recog │ │ │ │ │ +00047ec0: 6e69 7a65 7320 736f 6d65 2076 6172 6961 nizes some varia │ │ │ │ │ +00047ed0: 626c 6573 2074 6861 740a 6361 6e20 6265 bles that.can be │ │ │ │ │ +00047ee0: 2064 6566 696e 6564 2074 6f20 7370 6563 defined to spec │ │ │ │ │ +00047ef0: 6966 7920 6164 6469 7469 6f6e 616c 2066 ify additional f │ │ │ │ │ +00047f00: 696c 6573 2074 6f20 636c 6561 6e2e 2020 iles to clean. │ │ │ │ │ +00047f10: 5468 6573 6520 7661 7269 6162 6c65 730a These variables. │ │ │ │ │ +00047f20: 6172 6520 274d 4f53 544c 5943 4c45 414e are 'MOSTLYCLEAN │ │ │ │ │ +00047f30: 4649 4c45 5327 2c20 2743 4c45 414e 4649 FILES', 'CLEANFI │ │ │ │ │ +00047f40: 4c45 5327 2c20 2744 4953 5443 4c45 414e LES', 'DISTCLEAN │ │ │ │ │ +00047f50: 4649 4c45 5327 2c20 616e 640a 274d 4149 FILES', and.'MAI │ │ │ │ │ +00047f60: 4e54 4149 4e45 5243 4c45 414e 4649 4c45 NTAINERCLEANFILE │ │ │ │ │ +00047f70: 5327 2e0a 0a20 2020 5768 656e 2063 6c65 S'... When cle │ │ │ │ │ +00047f80: 616e 696e 6720 696e 766f 6c76 6573 206d aning involves m │ │ │ │ │ +00047f90: 6f72 6520 7468 616e 2064 656c 6574 696e ore than deletin │ │ │ │ │ +00047fa0: 6720 736f 6d65 2068 6172 642d 636f 6465 g some hard-code │ │ │ │ │ +00047fb0: 6420 6c69 7374 206f 660a 6669 6c65 732c d list of.files, │ │ │ │ │ +00047fc0: 2069 7420 6973 2061 6c73 6f20 706f 7373 it is also poss │ │ │ │ │ +00047fd0: 6962 6c65 2074 6f20 7375 7070 6c65 6d65 ible to suppleme │ │ │ │ │ +00047fe0: 6e74 2074 6865 2063 6c65 616e 696e 6720 nt the cleaning │ │ │ │ │ +00047ff0: 7275 6c65 7320 7769 7468 2079 6f75 720a rules with your. │ │ │ │ │ +00048000: 6f77 6e20 636f 6d6d 616e 6473 2e20 2053 own commands. S │ │ │ │ │ +00048010: 696d 706c 7920 6465 6669 6e65 2061 2072 imply define a r │ │ │ │ │ +00048020: 756c 6520 666f 7220 616e 7920 6f66 2074 ule for any of t │ │ │ │ │ +00048030: 6865 2027 6d6f 7374 6c79 636c 6561 6e2d he 'mostlyclean- │ │ │ │ │ +00048040: 6c6f 6361 6c27 2c0a 2763 6c65 616e 2d6c local',.'clean-l │ │ │ │ │ +00048050: 6f63 616c 272c 2027 6469 7374 636c 6561 ocal', 'distclea │ │ │ │ │ +00048060: 6e2d 6c6f 6361 6c27 2c20 6f72 2027 6d61 n-local', or 'ma │ │ │ │ │ +00048070: 696e 7461 696e 6572 2d63 6c65 616e 2d6c intainer-clean-l │ │ │ │ │ +00048080: 6f63 616c 2720 7461 7267 6574 730a 282a ocal' targets.(* │ │ │ │ │ +00048090: 6e6f 7465 2045 7874 656e 6469 6e67 3a3a note Extending:: │ │ │ │ │ +000480a0: 292e 2020 4120 636f 6d6d 6f6e 2063 6173 ). A common cas │ │ │ │ │ +000480b0: 6520 6973 2064 656c 6574 696e 6720 6120 e is deleting a │ │ │ │ │ +000480c0: 6469 7265 6374 6f72 792c 2066 6f72 0a69 directory, for.i │ │ │ │ │ +000480d0: 6e73 7461 6e63 652c 2061 2064 6972 6563 nstance, a direc │ │ │ │ │ +000480e0: 746f 7279 2063 7265 6174 6564 2062 7920 tory created by │ │ │ │ │ +000480f0: 7468 6520 7465 7374 2073 7569 7465 3a0a the test suite:. │ │ │ │ │ +00048100: 0a20 2020 2020 636c 6561 6e2d 6c6f 6361 . clean-loca │ │ │ │ │ +00048110: 6c3a 0a20 2020 2020 2020 2020 2020 2020 l:. │ │ │ │ │ +00048120: 2d72 6d20 2d72 6620 7465 7374 5375 6244 -rm -rf testSubD │ │ │ │ │ +00048130: 6972 0a0a 2020 2053 696e 6365 2027 6d61 ir.. Since 'ma │ │ │ │ │ +00048140: 6b65 2720 616c 6c6f 7773 206f 6e6c 7920 ke' allows only │ │ │ │ │ +00048150: 6f6e 6520 7365 7420 6f66 2072 756c 6573 one set of rules │ │ │ │ │ +00048160: 2066 6f72 2061 2067 6976 656e 2074 6172 for a given tar │ │ │ │ │ +00048170: 6765 742c 2061 206d 6f72 650a 6578 7465 get, a more.exte │ │ │ │ │ +00048180: 6e73 6962 6c65 2077 6179 206f 6620 7772 nsible way of wr │ │ │ │ │ +00048190: 6974 696e 6720 7468 6973 2069 7320 746f iting this is to │ │ │ │ │ +000481a0: 2075 7365 2061 2073 6570 6172 6174 6520 use a separate │ │ │ │ │ +000481b0: 7461 7267 6574 206c 6973 7465 6420 6173 target listed as │ │ │ │ │ +000481c0: 2061 0a64 6570 656e 6465 6e63 793a 0a0a a.dependency:.. │ │ │ │ │ +000481d0: 2020 2020 2063 6c65 616e 2d6c 6f63 616c clean-local │ │ │ │ │ +000481e0: 3a20 636c 6561 6e2d 6c6f 6361 6c2d 6368 : clean-local-ch │ │ │ │ │ +000481f0: 6563 6b0a 2020 2020 202e 5048 4f4e 593a eck. .PHONY: │ │ │ │ │ +00048200: 2063 6c65 616e 2d6c 6f63 616c 2d63 6865 clean-local-che │ │ │ │ │ +00048210: 636b 0a20 2020 2020 636c 6561 6e2d 6c6f ck. clean-lo │ │ │ │ │ +00048220: 6361 6c2d 6368 6563 6b3a 0a20 2020 2020 cal-check:. │ │ │ │ │ +00048230: 2020 2020 2020 2020 2d72 6d20 2d72 6620 -rm -rf │ │ │ │ │ +00048240: 7465 7374 5375 6244 6972 0a0a 2020 2041 testSubDir.. A │ │ │ │ │ +00048250: 7320 7468 6520 474e 5520 5374 616e 6461 s the GNU Standa │ │ │ │ │ +00048260: 7264 7320 6172 656e 2774 2061 6c77 6179 rds aren't alway │ │ │ │ │ +00048270: 7320 6578 706c 6963 6974 2061 7320 746f s explicit as to │ │ │ │ │ +00048280: 2077 6869 6368 2066 696c 6573 2073 686f which files sho │ │ │ │ │ +00048290: 756c 640a 6265 2072 656d 6f76 6564 2062 uld.be removed b │ │ │ │ │ +000482a0: 7920 7768 6963 6820 7275 6c65 2c20 7765 y which rule, we │ │ │ │ │ +000482b0: 2776 6520 6164 6f70 7465 6420 6120 6865 've adopted a he │ │ │ │ │ +000482c0: 7572 6973 7469 6320 7468 6174 2077 6520 uristic that we │ │ │ │ │ +000482d0: 6265 6c69 6576 6520 7761 730a 6669 7273 believe was.firs │ │ │ │ │ +000482e0: 7420 666f 726d 756c 6174 6564 2062 7920 t formulated by │ │ │ │ │ +000482f0: 4672 616e c3a7 6f69 7320 5069 6e61 7264 Fran..ois Pinard │ │ │ │ │ +00048300: 3a0a 0a20 2020 2a20 4966 2027 6d61 6b65 :.. * If 'make │ │ │ │ │ +00048310: 2720 6275 696c 7420 6974 2c20 616e 6420 ' built it, and │ │ │ │ │ +00048320: 6974 2069 7320 636f 6d6d 6f6e 6c79 2073 it is commonly s │ │ │ │ │ +00048330: 6f6d 6574 6869 6e67 2074 6861 7420 6f6e omething that on │ │ │ │ │ +00048340: 6520 776f 756c 640a 2020 2020 2077 616e e would. wan │ │ │ │ │ +00048350: 7420 746f 2072 6562 7569 6c64 2028 666f t to rebuild (fo │ │ │ │ │ +00048360: 7220 696e 7374 616e 6365 2c20 6120 272e r instance, a '. │ │ │ │ │ +00048370: 6f27 2066 696c 6529 2c20 7468 656e 2027 o' file), then ' │ │ │ │ │ +00048380: 6d6f 7374 6c79 636c 6561 6e27 0a20 2020 mostlyclean'. │ │ │ │ │ +00048390: 2020 7368 6f75 6c64 2064 656c 6574 6520 should delete │ │ │ │ │ +000483a0: 6974 2e0a 0a20 2020 2a20 4f74 6865 7277 it... * Otherw │ │ │ │ │ +000483b0: 6973 652c 2069 6620 276d 616b 6527 2062 ise, if 'make' b │ │ │ │ │ +000483c0: 7569 6c74 2069 742c 2074 6865 6e20 2763 uilt it, then 'c │ │ │ │ │ +000483d0: 6c65 616e 2720 7368 6f75 6c64 2064 656c lean' should del │ │ │ │ │ +000483e0: 6574 6520 6974 2e0a 0a20 2020 2a20 4966 ete it... * If │ │ │ │ │ +000483f0: 2027 636f 6e66 6967 7572 6527 2062 7569 'configure' bui │ │ │ │ │ +00048400: 6c74 2069 742c 2074 6865 6e20 2764 6973 lt it, then 'dis │ │ │ │ │ +00048410: 7463 6c65 616e 2720 7368 6f75 6c64 2064 tclean' should d │ │ │ │ │ +00048420: 656c 6574 6520 6974 2e0a 0a20 2020 2a20 elete it... * │ │ │ │ │ +00048430: 4966 2074 6865 206d 6169 6e74 6169 6e65 If the maintaine │ │ │ │ │ +00048440: 7220 6275 696c 7420 6974 2028 666f 7220 r built it (for │ │ │ │ │ +00048450: 696e 7374 616e 6365 2c20 6120 272e 696e instance, a '.in │ │ │ │ │ +00048460: 666f 2720 6669 6c65 292c 2074 6865 6e0a fo' file), then. │ │ │ │ │ +00048470: 2020 2020 2027 6d61 696e 7461 696e 6572 'maintainer │ │ │ │ │ +00048480: 2d63 6c65 616e 2720 7368 6f75 6c64 2064 -clean' should d │ │ │ │ │ +00048490: 656c 6574 6520 6974 2e20 2048 6f77 6576 elete it. Howev │ │ │ │ │ +000484a0: 6572 2027 6d61 696e 7461 696e 6572 2d63 er 'maintainer-c │ │ │ │ │ +000484b0: 6c65 616e 270a 2020 2020 2073 686f 756c lean'. shoul │ │ │ │ │ +000484c0: 6420 6e6f 7420 6465 6c65 7465 2061 6e79 d not delete any │ │ │ │ │ +000484d0: 7468 696e 6720 7468 6174 206e 6565 6473 thing that needs │ │ │ │ │ +000484e0: 2074 6f20 6578 6973 7420 696e 206f 7264 to exist in ord │ │ │ │ │ +000484f0: 6572 2074 6f20 7275 6e0a 2020 2020 2027 er to run. ' │ │ │ │ │ +00048500: 2e2f 636f 6e66 6967 7572 6520 2626 206d ./configure && m │ │ │ │ │ +00048510: 616b 6527 2e0a 0a20 2020 5765 2072 6563 ake'... We rec │ │ │ │ │ +00048520: 6f6d 6d65 6e64 2074 6861 7420 796f 7520 ommend that you │ │ │ │ │ +00048530: 666f 6c6c 6f77 2074 6869 7320 7361 6d65 follow this same │ │ │ │ │ +00048540: 2073 6574 206f 6620 6865 7572 6973 7469 set of heuristi │ │ │ │ │ +00048550: 6373 2069 6e20 796f 7572 0a27 4d61 6b65 cs in your.'Make │ │ │ │ │ +00048560: 6669 6c65 2e61 6d27 2e0a 0a1f 0a46 696c file.am'.....Fil │ │ │ │ │ +00048570: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ +00048580: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4469 .info, Node: Di │ │ │ │ │ +00048590: 7374 2c20 204e 6578 743a 2054 6573 7473 st, Next: Tests │ │ │ │ │ +000485a0: 2c20 2050 7265 763a 2043 6c65 616e 2c20 , Prev: Clean, │ │ │ │ │ +000485b0: 2055 703a 2054 6f70 0a0a 3134 2057 6861 Up: Top..14 Wha │ │ │ │ │ +000485c0: 7420 476f 6573 2069 6e20 6120 4469 7374 t Goes in a Dist │ │ │ │ │ +000485d0: 7269 6275 7469 6f6e 0a2a 2a2a 2a2a 2a2a ribution.******* │ │ │ │ │ 000485e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000485f0: 2a2a 2a2a 2a0a 0a2a 204d 656e 753a 0a0a *****..* Menu:.. │ │ │ │ │ -00048600: 2a20 4261 7369 6373 206f 6620 4469 7374 * Basics of Dist │ │ │ │ │ -00048610: 7269 6275 7469 6f6e 3a3a 2020 2020 2020 ribution:: │ │ │ │ │ -00048620: 4669 6c65 7320 6469 7374 7269 6275 7465 Files distribute │ │ │ │ │ -00048630: 6420 6279 2064 6566 6175 6c74 0a2a 2046 d by default.* F │ │ │ │ │ -00048640: 696e 652d 6772 6169 6e65 6420 4469 7374 ine-grained Dist │ │ │ │ │ -00048650: 7269 6275 7469 6f6e 2043 6f6e 7472 6f6c ribution Control │ │ │ │ │ -00048660: 3a3a 2020 2764 6973 745f 2720 616e 6420 :: 'dist_' and │ │ │ │ │ -00048670: 276e 6f64 6973 745f 2720 7072 6566 6978 'nodist_' prefix │ │ │ │ │ -00048680: 6573 0a2a 2054 6865 2064 6973 7420 486f es.* The dist Ho │ │ │ │ │ -00048690: 6f6b 3a3a 2020 2020 2020 2020 2020 2020 ok:: │ │ │ │ │ -000486a0: 2020 2041 2074 6172 6765 7420 666f 7220 A target for │ │ │ │ │ -000486b0: 6c61 7374 2d6d 696e 7574 6520 6469 7374 last-minute dist │ │ │ │ │ -000486c0: 7269 6275 7469 6f6e 2063 6861 6e67 6573 ribution changes │ │ │ │ │ -000486d0: 0a2a 2043 6865 636b 696e 6720 7468 6520 .* Checking the │ │ │ │ │ -000486e0: 4469 7374 7269 6275 7469 6f6e 3a3a 2020 Distribution:: │ │ │ │ │ -000486f0: 2027 6d61 6b65 2064 6973 7463 6865 636b 'make distcheck │ │ │ │ │ -00048700: 2720 6578 706c 6169 6e65 640a 2a20 5468 ' explained.* Th │ │ │ │ │ -00048710: 6520 5479 7065 7320 6f66 2044 6973 7472 e Types of Distr │ │ │ │ │ -00048720: 6962 7574 696f 6e73 3a3a 2020 4120 7661 ibutions:: A va │ │ │ │ │ -00048730: 7269 6574 7920 6f66 2066 6f72 6d61 7473 riety of formats │ │ │ │ │ -00048740: 2061 6e64 2063 6f6d 7072 6573 7369 6f6e and compression │ │ │ │ │ -00048750: 206d 6574 686f 6473 0a0a 1f0a 4669 6c65 methods....File │ │ │ │ │ -00048760: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -00048770: 696e 666f 2c20 204e 6f64 653a 2042 6173 info, Node: Bas │ │ │ │ │ -00048780: 6963 7320 6f66 2044 6973 7472 6962 7574 ics of Distribut │ │ │ │ │ -00048790: 696f 6e2c 2020 4e65 7874 3a20 4669 6e65 ion, Next: Fine │ │ │ │ │ -000487a0: 2d67 7261 696e 6564 2044 6973 7472 6962 -grained Distrib │ │ │ │ │ -000487b0: 7574 696f 6e20 436f 6e74 726f 6c2c 2020 ution Control, │ │ │ │ │ -000487c0: 5570 3a20 4469 7374 0a0a 3134 2e31 2042 Up: Dist..14.1 B │ │ │ │ │ -000487d0: 6173 6963 7320 6f66 2044 6973 7472 6962 asics of Distrib │ │ │ │ │ -000487e0: 7574 696f 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d ution.========== │ │ │ │ │ +000485f0: 2a2a 2a2a 2a2a 2a0a 0a2a 204d 656e 753a *******..* Menu: │ │ │ │ │ +00048600: 0a0a 2a20 4261 7369 6373 206f 6620 4469 ..* Basics of Di │ │ │ │ │ +00048610: 7374 7269 6275 7469 6f6e 3a3a 2020 2020 stribution:: │ │ │ │ │ +00048620: 2020 4669 6c65 7320 6469 7374 7269 6275 Files distribu │ │ │ │ │ +00048630: 7465 6420 6279 2064 6566 6175 6c74 0a2a ted by default.* │ │ │ │ │ +00048640: 2046 696e 652d 6772 6169 6e65 6420 4469 Fine-grained Di │ │ │ │ │ +00048650: 7374 7269 6275 7469 6f6e 2043 6f6e 7472 stribution Contr │ │ │ │ │ +00048660: 6f6c 3a3a 2020 2764 6973 745f 2720 616e ol:: 'dist_' an │ │ │ │ │ +00048670: 6420 276e 6f64 6973 745f 2720 7072 6566 d 'nodist_' pref │ │ │ │ │ +00048680: 6978 6573 0a2a 2054 6865 2064 6973 7420 ixes.* The dist │ │ │ │ │ +00048690: 486f 6f6b 3a3a 2020 2020 2020 2020 2020 Hook:: │ │ │ │ │ +000486a0: 2020 2020 2041 2074 6172 6765 7420 666f A target fo │ │ │ │ │ +000486b0: 7220 6c61 7374 2d6d 696e 7574 6520 6469 r last-minute di │ │ │ │ │ +000486c0: 7374 7269 6275 7469 6f6e 2063 6861 6e67 stribution chang │ │ │ │ │ +000486d0: 6573 0a2a 2043 6865 636b 696e 6720 7468 es.* Checking th │ │ │ │ │ +000486e0: 6520 4469 7374 7269 6275 7469 6f6e 3a3a e Distribution:: │ │ │ │ │ +000486f0: 2020 2027 6d61 6b65 2064 6973 7463 6865 'make distche │ │ │ │ │ +00048700: 636b 2720 6578 706c 6169 6e65 640a 2a20 ck' explained.* │ │ │ │ │ +00048710: 5468 6520 5479 7065 7320 6f66 2044 6973 The Types of Dis │ │ │ │ │ +00048720: 7472 6962 7574 696f 6e73 3a3a 2020 4120 tributions:: A │ │ │ │ │ +00048730: 7661 7269 6574 7920 6f66 2066 6f72 6d61 variety of forma │ │ │ │ │ +00048740: 7473 2061 6e64 2063 6f6d 7072 6573 7369 ts and compressi │ │ │ │ │ +00048750: 6f6e 206d 6574 686f 6473 0a0a 1f0a 4669 on methods....Fi │ │ │ │ │ +00048760: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +00048770: 312e 696e 666f 2c20 204e 6f64 653a 2042 1.info, Node: B │ │ │ │ │ +00048780: 6173 6963 7320 6f66 2044 6973 7472 6962 asics of Distrib │ │ │ │ │ +00048790: 7574 696f 6e2c 2020 4e65 7874 3a20 4669 ution, Next: Fi │ │ │ │ │ +000487a0: 6e65 2d67 7261 696e 6564 2044 6973 7472 ne-grained Distr │ │ │ │ │ +000487b0: 6962 7574 696f 6e20 436f 6e74 726f 6c2c ibution Control, │ │ │ │ │ +000487c0: 2020 5570 3a20 4469 7374 0a0a 3134 2e31 Up: Dist..14.1 │ │ │ │ │ +000487d0: 2042 6173 6963 7320 6f66 2044 6973 7472 Basics of Distr │ │ │ │ │ +000487e0: 6962 7574 696f 6e0a 3d3d 3d3d 3d3d 3d3d ibution.======== │ │ │ │ │ 000487f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00048800: 3d0a 0a54 6865 2027 6469 7374 2720 7275 =..The 'dist' ru │ │ │ │ │ -00048810: 6c65 2069 6e20 7468 6520 6765 6e65 7261 le in the genera │ │ │ │ │ -00048820: 7465 6420 274d 616b 6566 696c 652e 696e ted 'Makefile.in │ │ │ │ │ -00048830: 2720 6361 6e20 6265 2075 7365 6420 746f ' can be used to │ │ │ │ │ -00048840: 2067 656e 6572 6174 6520 610a 677a 6970 generate a.gzip │ │ │ │ │ -00048850: 7065 6420 2774 6172 2720 6669 6c65 2061 ped 'tar' file a │ │ │ │ │ -00048860: 6e64 206f 7468 6572 2066 6c61 766f 7273 nd other flavors │ │ │ │ │ -00048870: 206f 6620 6172 6368 6976 6520 666f 7220 of archive for │ │ │ │ │ -00048880: 6469 7374 7269 6275 7469 6f6e 2e20 2054 distribution. T │ │ │ │ │ -00048890: 6865 0a66 696c 6520 6973 206e 616d 6564 he.file is named │ │ │ │ │ -000488a0: 2062 6173 6564 206f 6e20 7468 6520 2750 based on the 'P │ │ │ │ │ -000488b0: 4143 4b41 4745 2720 616e 6420 2756 4552 ACKAGE' and 'VER │ │ │ │ │ -000488c0: 5349 4f4e 2720 7661 7269 6162 6c65 7320 SION' variables │ │ │ │ │ -000488d0: 6465 6669 6e65 6420 6279 0a27 414d 5f49 defined by.'AM_I │ │ │ │ │ -000488e0: 4e49 545f 4155 544f 4d41 4b45 2720 282a NIT_AUTOMAKE' (* │ │ │ │ │ -000488f0: 6e6f 7465 204d 6163 726f 733a 3a29 3b20 note Macros::); │ │ │ │ │ -00048900: 6d6f 7265 2070 7265 6369 7365 6c79 2074 more precisely t │ │ │ │ │ -00048910: 6865 2067 7a69 7070 6564 2027 7461 7227 he gzipped 'tar' │ │ │ │ │ -00048920: 0a66 696c 6520 6973 206e 616d 6564 2027 .file is named ' │ │ │ │ │ -00048930: 5041 434b 4147 452d 5645 5253 494f 4e2e PACKAGE-VERSION. │ │ │ │ │ -00048940: 7461 722e 677a 272e 2020 596f 7520 6361 tar.gz'. You ca │ │ │ │ │ -00048950: 6e20 7573 6520 7468 6520 276d 616b 6527 n use the 'make' │ │ │ │ │ -00048960: 2076 6172 6961 626c 650a 2747 5a49 505f variable.'GZIP_ │ │ │ │ │ -00048970: 454e 5627 2074 6f20 636f 6e74 726f 6c20 ENV' to control │ │ │ │ │ -00048980: 686f 7720 677a 6970 2069 7320 7275 6e2e how gzip is run. │ │ │ │ │ -00048990: 2020 5468 6520 6465 6661 756c 7420 7365 The default se │ │ │ │ │ -000489a0: 7474 696e 6720 6973 2027 2d2d 6265 7374 tting is '--best │ │ │ │ │ -000489b0: 272e 0a0a 2020 2046 6f72 2074 6865 206d '... For the m │ │ │ │ │ -000489c0: 6f73 7420 7061 7274 2c20 7468 6520 6669 ost part, the fi │ │ │ │ │ -000489d0: 6c65 7320 746f 2064 6973 7472 6962 7574 les to distribut │ │ │ │ │ -000489e0: 6520 6172 6520 6175 746f 6d61 7469 6361 e are automatica │ │ │ │ │ -000489f0: 6c6c 7920 666f 756e 6420 6279 0a41 7574 lly found by.Aut │ │ │ │ │ -00048a00: 6f6d 616b 653a 2061 6c6c 2073 6f75 7263 omake: all sourc │ │ │ │ │ -00048a10: 6520 6669 6c65 7320 6172 6520 6175 746f e files are auto │ │ │ │ │ -00048a20: 6d61 7469 6361 6c6c 7920 696e 636c 7564 matically includ │ │ │ │ │ -00048a30: 6564 2069 6e20 6120 6469 7374 7269 6275 ed in a distribu │ │ │ │ │ -00048a40: 7469 6f6e 2c0a 6173 2061 7265 2061 6c6c tion,.as are all │ │ │ │ │ -00048a50: 2027 4d61 6b65 6669 6c65 2e61 6d27 2061 'Makefile.am' a │ │ │ │ │ -00048a60: 6e64 2027 4d61 6b65 6669 6c65 2e69 6e27 nd 'Makefile.in' │ │ │ │ │ -00048a70: 2066 696c 6573 2e20 2041 7574 6f6d 616b files. Automak │ │ │ │ │ -00048a80: 6520 616c 736f 2068 6173 2061 0a62 7569 e also has a.bui │ │ │ │ │ -00048a90: 6c74 2d69 6e20 6c69 7374 206f 6620 636f lt-in list of co │ │ │ │ │ -00048aa0: 6d6d 6f6e 6c79 2075 7365 6420 6669 6c65 mmonly used file │ │ │ │ │ -00048ab0: 7320 7468 6174 2061 7265 2061 7574 6f6d s that are autom │ │ │ │ │ -00048ac0: 6174 6963 616c 6c79 2069 6e63 6c75 6465 atically include │ │ │ │ │ -00048ad0: 6420 6966 0a74 6865 7920 6172 6520 666f d if.they are fo │ │ │ │ │ -00048ae0: 756e 6420 696e 2074 6865 2063 7572 7265 und in the curre │ │ │ │ │ -00048af0: 6e74 2064 6972 6563 746f 7279 2028 6569 nt directory (ei │ │ │ │ │ -00048b00: 7468 6572 2070 6879 7369 6361 6c6c 792c ther physically, │ │ │ │ │ -00048b10: 206f 7220 6173 2074 6865 0a74 6172 6765 or as the.targe │ │ │ │ │ -00048b20: 7420 6f66 2061 2027 4d61 6b65 6669 6c65 t of a 'Makefile │ │ │ │ │ -00048b30: 2e61 6d27 2072 756c 6529 3b20 7468 6973 .am' rule); this │ │ │ │ │ -00048b40: 206c 6973 7420 6973 2070 7269 6e74 6564 list is printed │ │ │ │ │ -00048b50: 2062 7920 2761 7574 6f6d 616b 650a 2d2d by 'automake.-- │ │ │ │ │ -00048b60: 6865 6c70 272e 2020 4e6f 7465 2074 6861 help'. Note tha │ │ │ │ │ -00048b70: 7420 736f 6d65 2066 696c 6573 2069 6e20 t some files in │ │ │ │ │ -00048b80: 7468 6973 206c 6973 7420 6172 6520 6163 this list are ac │ │ │ │ │ -00048b90: 7475 616c 6c79 2064 6973 7472 6962 7574 tually distribut │ │ │ │ │ -00048ba0: 6564 0a6f 6e6c 7920 6966 206f 7468 6572 ed.only if other │ │ │ │ │ -00048bb0: 2063 6572 7461 696e 2063 6f6e 6469 7469 certain conditi │ │ │ │ │ -00048bc0: 6f6e 7320 686f 6c64 2028 666f 7220 6578 ons hold (for ex │ │ │ │ │ -00048bd0: 616d 706c 652c 2074 6865 2027 636f 6e66 ample, the 'conf │ │ │ │ │ -00048be0: 6967 2e68 2e74 6f70 270a 616e 6420 2763 ig.h.top'.and 'c │ │ │ │ │ -00048bf0: 6f6e 6669 672e 682e 626f 7427 2066 696c onfig.h.bot' fil │ │ │ │ │ -00048c00: 6573 2061 7265 2061 7574 6f6d 6174 6963 es are automatic │ │ │ │ │ -00048c10: 616c 6c79 2064 6973 7472 6962 7574 6564 ally distributed │ │ │ │ │ -00048c20: 206f 6e6c 7920 6966 2c20 652e 672e 2c0a only if, e.g.,. │ │ │ │ │ -00048c30: 2741 435f 434f 4e46 4947 5f48 4541 4445 'AC_CONFIG_HEADE │ │ │ │ │ -00048c40: 5253 285b 636f 6e66 6967 2e68 5d29 2720 RS([config.h])' │ │ │ │ │ -00048c50: 6973 2075 7365 6420 696e 2027 636f 6e66 is used in 'conf │ │ │ │ │ -00048c60: 6967 7572 652e 6163 2729 2e20 2041 6c73 igure.ac'). Als │ │ │ │ │ -00048c70: 6f2c 2066 696c 6573 0a74 6861 7420 6172 o, files.that ar │ │ │ │ │ -00048c80: 6520 7265 6164 2062 7920 2763 6f6e 6669 e read by 'confi │ │ │ │ │ -00048c90: 6775 7265 2720 2869 2e65 2e20 7468 6520 gure' (i.e. the │ │ │ │ │ -00048ca0: 736f 7572 6365 2066 696c 6573 2063 6f72 source files cor │ │ │ │ │ -00048cb0: 7265 7370 6f6e 6469 6e67 2074 6f20 7468 responding to th │ │ │ │ │ -00048cc0: 650a 6669 6c65 7320 7370 6563 6966 6965 e.files specifie │ │ │ │ │ -00048cd0: 6420 696e 2076 6172 696f 7573 2041 7574 d in various Aut │ │ │ │ │ -00048ce0: 6f63 6f6e 6620 6d61 6372 6f73 2073 7563 oconf macros suc │ │ │ │ │ -00048cf0: 6820 6173 2027 4143 5f43 4f4e 4649 475f h as 'AC_CONFIG_ │ │ │ │ │ -00048d00: 4649 4c45 5327 2061 6e64 0a73 6962 6c69 FILES' and.sibli │ │ │ │ │ -00048d10: 6e67 7329 2061 7265 2061 7574 6f6d 6174 ngs) are automat │ │ │ │ │ -00048d20: 6963 616c 6c79 2064 6973 7472 6962 7574 ically distribut │ │ │ │ │ -00048d30: 6564 2e20 2046 696c 6573 2069 6e63 6c75 ed. Files inclu │ │ │ │ │ -00048d40: 6465 6420 696e 2061 0a27 4d61 6b65 6669 ded in a.'Makefi │ │ │ │ │ -00048d50: 6c65 2e61 6d27 2028 7573 696e 6720 2769 le.am' (using 'i │ │ │ │ │ -00048d60: 6e63 6c75 6465 2729 206f 7220 696e 2027 nclude') or in ' │ │ │ │ │ -00048d70: 636f 6e66 6967 7572 652e 6163 2720 2875 configure.ac' (u │ │ │ │ │ -00048d80: 7369 6e67 0a27 6d34 5f69 6e63 6c75 6465 sing.'m4_include │ │ │ │ │ -00048d90: 2729 2c20 616e 6420 6865 6c70 6572 2073 '), and helper s │ │ │ │ │ -00048da0: 6372 6970 7473 2069 6e73 7461 6c6c 6564 cripts installed │ │ │ │ │ -00048db0: 2077 6974 6820 2761 7574 6f6d 616b 650a with 'automake. │ │ │ │ │ -00048dc0: 2d2d 6164 642d 6d69 7373 696e 6727 2061 --add-missing' a │ │ │ │ │ -00048dd0: 7265 2061 6c73 6f20 6469 7374 7269 6275 re also distribu │ │ │ │ │ -00048de0: 7465 642e 0a0a 2020 2053 7469 6c6c 2c20 ted... Still, │ │ │ │ │ -00048df0: 736f 6d65 7469 6d65 7320 7468 6572 6520 sometimes there │ │ │ │ │ -00048e00: 6172 6520 6669 6c65 7320 7468 6174 206d are files that m │ │ │ │ │ -00048e10: 7573 7420 6265 2064 6973 7472 6962 7574 ust be distribut │ │ │ │ │ -00048e20: 6564 2c20 6275 7420 7768 6963 680a 6172 ed, but which.ar │ │ │ │ │ -00048e30: 6520 6e6f 7420 636f 7665 7265 6420 696e e not covered in │ │ │ │ │ -00048e40: 2074 6865 2061 7574 6f6d 6174 6963 2072 the automatic r │ │ │ │ │ -00048e50: 756c 6573 2e20 2054 6865 7365 2066 696c ules. These fil │ │ │ │ │ -00048e60: 6573 2073 686f 756c 6420 6265 206c 6973 es should be lis │ │ │ │ │ -00048e70: 7465 6420 696e 0a74 6865 2027 4558 5452 ted in.the 'EXTR │ │ │ │ │ -00048e80: 415f 4449 5354 2720 7661 7269 6162 6c65 A_DIST' variable │ │ │ │ │ -00048e90: 2e20 2059 6f75 2063 616e 206d 656e 7469 . You can menti │ │ │ │ │ -00048ea0: 6f6e 2066 696c 6573 2066 726f 6d20 7375 on files from su │ │ │ │ │ -00048eb0: 6264 6972 6563 746f 7269 6573 2069 6e0a bdirectories in. │ │ │ │ │ -00048ec0: 2745 5854 5241 5f44 4953 5427 2e0a 0a20 'EXTRA_DIST'... │ │ │ │ │ -00048ed0: 2020 596f 7520 6361 6e20 616c 736f 206d You can also m │ │ │ │ │ -00048ee0: 656e 7469 6f6e 2061 2064 6972 6563 746f ention a directo │ │ │ │ │ -00048ef0: 7279 2069 6e20 2745 5854 5241 5f44 4953 ry in 'EXTRA_DIS │ │ │ │ │ -00048f00: 5427 3b20 696e 2074 6869 7320 6361 7365 T'; in this case │ │ │ │ │ -00048f10: 2074 6865 0a65 6e74 6972 6520 6469 7265 the.entire dire │ │ │ │ │ -00048f20: 6374 6f72 7920 7769 6c6c 2062 6520 7265 ctory will be re │ │ │ │ │ -00048f30: 6375 7273 6976 656c 7920 636f 7069 6564 cursively copied │ │ │ │ │ -00048f40: 2069 6e74 6f20 7468 6520 6469 7374 7269 into the distri │ │ │ │ │ -00048f50: 6275 7469 6f6e 2e0a 506c 6561 7365 206e bution..Please n │ │ │ │ │ -00048f60: 6f74 6520 7468 6174 2074 6869 7320 7769 ote that this wi │ │ │ │ │ -00048f70: 6c6c 2061 6c73 6f20 636f 7079 205f 6576 ll also copy _ev │ │ │ │ │ -00048f80: 6572 7974 6869 6e67 5f20 696e 2074 6865 erything_ in the │ │ │ │ │ -00048f90: 2064 6972 6563 746f 7279 2c0a 696e 636c directory,.incl │ │ │ │ │ -00048fa0: 7564 696e 672c 2065 2e67 2e2c 2053 7562 uding, e.g., Sub │ │ │ │ │ -00048fb0: 7665 7273 696f 6e27 7320 272e 7376 6e27 version's '.svn' │ │ │ │ │ -00048fc0: 2070 7269 7661 7465 2064 6972 6563 746f private directo │ │ │ │ │ -00048fd0: 7269 6573 206f 7220 4356 532f 5243 530a ries or CVS/RCS. │ │ │ │ │ -00048fe0: 7665 7273 696f 6e20 636f 6e74 726f 6c20 version control │ │ │ │ │ -00048ff0: 6669 6c65 732e 2020 5765 2072 6563 6f6d files. We recom │ │ │ │ │ -00049000: 6d65 6e64 2061 6761 696e 7374 2075 7369 mend against usi │ │ │ │ │ -00049010: 6e67 2074 6869 7320 6665 6174 7572 652e ng this feature. │ │ │ │ │ -00049020: 0a0a 2020 2049 6620 796f 7520 6465 6669 .. If you defi │ │ │ │ │ -00049030: 6e65 2027 5355 4244 4952 5327 2c20 4175 ne 'SUBDIRS', Au │ │ │ │ │ -00049040: 746f 6d61 6b65 2077 696c 6c20 7265 6375 tomake will recu │ │ │ │ │ -00049050: 7273 6976 656c 7920 696e 636c 7564 6520 rsively include │ │ │ │ │ -00049060: 7468 650a 7375 6264 6972 6563 746f 7269 the.subdirectori │ │ │ │ │ -00049070: 6573 2069 6e20 7468 6520 6469 7374 7269 es in the distri │ │ │ │ │ -00049080: 6275 7469 6f6e 2e20 2049 6620 2753 5542 bution. If 'SUB │ │ │ │ │ -00049090: 4449 5253 2720 6973 2064 6566 696e 6564 DIRS' is defined │ │ │ │ │ -000490a0: 0a63 6f6e 6469 7469 6f6e 616c 6c79 2028 .conditionally ( │ │ │ │ │ -000490b0: 2a6e 6f74 6520 436f 6e64 6974 696f 6e61 *note Conditiona │ │ │ │ │ -000490c0: 6c73 3a3a 292c 2041 7574 6f6d 616b 6520 ls::), Automake │ │ │ │ │ -000490d0: 7769 6c6c 206e 6f72 6d61 6c6c 7920 696e will normally in │ │ │ │ │ -000490e0: 636c 7564 6520 616c 6c0a 6469 7265 6374 clude all.direct │ │ │ │ │ -000490f0: 6f72 6965 7320 7468 6174 2063 6f75 6c64 ories that could │ │ │ │ │ -00049100: 2070 6f73 7369 626c 7920 6170 7065 6172 possibly appear │ │ │ │ │ -00049110: 2069 6e20 2753 5542 4449 5253 2720 696e in 'SUBDIRS' in │ │ │ │ │ -00049120: 2074 6865 2064 6973 7472 6962 7574 696f the distributio │ │ │ │ │ -00049130: 6e2e 0a49 6620 796f 7520 6e65 6564 2074 n..If you need t │ │ │ │ │ -00049140: 6f20 7370 6563 6966 7920 7468 6520 7365 o specify the se │ │ │ │ │ -00049150: 7420 6f66 2064 6972 6563 746f 7269 6573 t of directories │ │ │ │ │ -00049160: 2063 6f6e 6469 7469 6f6e 616c 6c79 2c20 conditionally, │ │ │ │ │ -00049170: 796f 7520 6361 6e20 7365 740a 7468 6520 you can set.the │ │ │ │ │ -00049180: 7661 7269 6162 6c65 2027 4449 5354 5f53 variable 'DIST_S │ │ │ │ │ -00049190: 5542 4449 5253 2720 746f 2074 6865 2065 UBDIRS' to the e │ │ │ │ │ -000491a0: 7861 6374 206c 6973 7420 6f66 2073 7562 xact list of sub │ │ │ │ │ -000491b0: 6469 7265 6374 6f72 6965 7320 746f 0a69 directories to.i │ │ │ │ │ -000491c0: 6e63 6c75 6465 2069 6e20 7468 6520 6469 nclude in the di │ │ │ │ │ -000491d0: 7374 7269 6275 7469 6f6e 2028 2a6e 6f74 stribution (*not │ │ │ │ │ -000491e0: 6520 436f 6e64 6974 696f 6e61 6c20 5375 e Conditional Su │ │ │ │ │ -000491f0: 6264 6972 6563 746f 7269 6573 3a3a 292e bdirectories::). │ │ │ │ │ -00049200: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00049210: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00049220: 6f64 653a 2046 696e 652d 6772 6169 6e65 ode: Fine-graine │ │ │ │ │ -00049230: 6420 4469 7374 7269 6275 7469 6f6e 2043 d Distribution C │ │ │ │ │ -00049240: 6f6e 7472 6f6c 2c20 204e 6578 743a 2054 ontrol, Next: T │ │ │ │ │ -00049250: 6865 2064 6973 7420 486f 6f6b 2c20 2050 he dist Hook, P │ │ │ │ │ -00049260: 7265 763a 2042 6173 6963 7320 6f66 2044 rev: Basics of D │ │ │ │ │ -00049270: 6973 7472 6962 7574 696f 6e2c 2020 5570 istribution, Up │ │ │ │ │ -00049280: 3a20 4469 7374 0a0a 3134 2e32 2046 696e : Dist..14.2 Fin │ │ │ │ │ -00049290: 652d 6772 6169 6e65 6420 4469 7374 7269 e-grained Distri │ │ │ │ │ -000492a0: 6275 7469 6f6e 2043 6f6e 7472 6f6c 0a3d bution Control.= │ │ │ │ │ -000492b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00048800: 3d3d 3d0a 0a54 6865 2027 6469 7374 2720 ===..The 'dist' │ │ │ │ │ +00048810: 7275 6c65 2069 6e20 7468 6520 6765 6e65 rule in the gene │ │ │ │ │ +00048820: 7261 7465 6420 274d 616b 6566 696c 652e rated 'Makefile. │ │ │ │ │ +00048830: 696e 2720 6361 6e20 6265 2075 7365 6420 in' can be used │ │ │ │ │ +00048840: 746f 2067 656e 6572 6174 6520 610a 677a to generate a.gz │ │ │ │ │ +00048850: 6970 7065 6420 2774 6172 2720 6669 6c65 ipped 'tar' file │ │ │ │ │ +00048860: 2061 6e64 206f 7468 6572 2066 6c61 766f and other flavo │ │ │ │ │ +00048870: 7273 206f 6620 6172 6368 6976 6520 666f rs of archive fo │ │ │ │ │ +00048880: 7220 6469 7374 7269 6275 7469 6f6e 2e20 r distribution. │ │ │ │ │ +00048890: 2054 6865 0a66 696c 6520 6973 206e 616d The.file is nam │ │ │ │ │ +000488a0: 6564 2062 6173 6564 206f 6e20 7468 6520 ed based on the │ │ │ │ │ +000488b0: 2750 4143 4b41 4745 2720 616e 6420 2756 'PACKAGE' and 'V │ │ │ │ │ +000488c0: 4552 5349 4f4e 2720 7661 7269 6162 6c65 ERSION' variable │ │ │ │ │ +000488d0: 7320 6465 6669 6e65 6420 6279 0a27 414d s defined by.'AM │ │ │ │ │ +000488e0: 5f49 4e49 545f 4155 544f 4d41 4b45 2720 _INIT_AUTOMAKE' │ │ │ │ │ +000488f0: 282a 6e6f 7465 204d 6163 726f 733a 3a29 (*note Macros::) │ │ │ │ │ +00048900: 3b20 6d6f 7265 2070 7265 6369 7365 6c79 ; more precisely │ │ │ │ │ +00048910: 2074 6865 2067 7a69 7070 6564 2027 7461 the gzipped 'ta │ │ │ │ │ +00048920: 7227 0a66 696c 6520 6973 206e 616d 6564 r'.file is named │ │ │ │ │ +00048930: 2027 5041 434b 4147 452d 5645 5253 494f 'PACKAGE-VERSIO │ │ │ │ │ +00048940: 4e2e 7461 722e 677a 272e 2020 596f 7520 N.tar.gz'. You │ │ │ │ │ +00048950: 6361 6e20 7573 6520 7468 6520 276d 616b can use the 'mak │ │ │ │ │ +00048960: 6527 2076 6172 6961 626c 650a 2747 5a49 e' variable.'GZI │ │ │ │ │ +00048970: 505f 454e 5627 2074 6f20 636f 6e74 726f P_ENV' to contro │ │ │ │ │ +00048980: 6c20 686f 7720 677a 6970 2069 7320 7275 l how gzip is ru │ │ │ │ │ +00048990: 6e2e 2020 5468 6520 6465 6661 756c 7420 n. The default │ │ │ │ │ +000489a0: 7365 7474 696e 6720 6973 2027 2d2d 6265 setting is '--be │ │ │ │ │ +000489b0: 7374 272e 0a0a 2020 2046 6f72 2074 6865 st'... For the │ │ │ │ │ +000489c0: 206d 6f73 7420 7061 7274 2c20 7468 6520 most part, the │ │ │ │ │ +000489d0: 6669 6c65 7320 746f 2064 6973 7472 6962 files to distrib │ │ │ │ │ +000489e0: 7574 6520 6172 6520 6175 746f 6d61 7469 ute are automati │ │ │ │ │ +000489f0: 6361 6c6c 7920 666f 756e 6420 6279 0a41 cally found by.A │ │ │ │ │ +00048a00: 7574 6f6d 616b 653a 2061 6c6c 2073 6f75 utomake: all sou │ │ │ │ │ +00048a10: 7263 6520 6669 6c65 7320 6172 6520 6175 rce files are au │ │ │ │ │ +00048a20: 746f 6d61 7469 6361 6c6c 7920 696e 636c tomatically incl │ │ │ │ │ +00048a30: 7564 6564 2069 6e20 6120 6469 7374 7269 uded in a distri │ │ │ │ │ +00048a40: 6275 7469 6f6e 2c0a 6173 2061 7265 2061 bution,.as are a │ │ │ │ │ +00048a50: 6c6c 2027 4d61 6b65 6669 6c65 2e61 6d27 ll 'Makefile.am' │ │ │ │ │ +00048a60: 2061 6e64 2027 4d61 6b65 6669 6c65 2e69 and 'Makefile.i │ │ │ │ │ +00048a70: 6e27 2066 696c 6573 2e20 2041 7574 6f6d n' files. Autom │ │ │ │ │ +00048a80: 616b 6520 616c 736f 2068 6173 2061 0a62 ake also has a.b │ │ │ │ │ +00048a90: 7569 6c74 2d69 6e20 6c69 7374 206f 6620 uilt-in list of │ │ │ │ │ +00048aa0: 636f 6d6d 6f6e 6c79 2075 7365 6420 6669 commonly used fi │ │ │ │ │ +00048ab0: 6c65 7320 7468 6174 2061 7265 2061 7574 les that are aut │ │ │ │ │ +00048ac0: 6f6d 6174 6963 616c 6c79 2069 6e63 6c75 omatically inclu │ │ │ │ │ +00048ad0: 6465 6420 6966 0a74 6865 7920 6172 6520 ded if.they are │ │ │ │ │ +00048ae0: 666f 756e 6420 696e 2074 6865 2063 7572 found in the cur │ │ │ │ │ +00048af0: 7265 6e74 2064 6972 6563 746f 7279 2028 rent directory ( │ │ │ │ │ +00048b00: 6569 7468 6572 2070 6879 7369 6361 6c6c either physicall │ │ │ │ │ +00048b10: 792c 206f 7220 6173 2074 6865 0a74 6172 y, or as the.tar │ │ │ │ │ +00048b20: 6765 7420 6f66 2061 2027 4d61 6b65 6669 get of a 'Makefi │ │ │ │ │ +00048b30: 6c65 2e61 6d27 2072 756c 6529 3b20 7468 le.am' rule); th │ │ │ │ │ +00048b40: 6973 206c 6973 7420 6973 2070 7269 6e74 is list is print │ │ │ │ │ +00048b50: 6564 2062 7920 2761 7574 6f6d 616b 650a ed by 'automake. │ │ │ │ │ +00048b60: 2d2d 6865 6c70 272e 2020 4e6f 7465 2074 --help'. Note t │ │ │ │ │ +00048b70: 6861 7420 736f 6d65 2066 696c 6573 2069 hat some files i │ │ │ │ │ +00048b80: 6e20 7468 6973 206c 6973 7420 6172 6520 n this list are │ │ │ │ │ +00048b90: 6163 7475 616c 6c79 2064 6973 7472 6962 actually distrib │ │ │ │ │ +00048ba0: 7574 6564 0a6f 6e6c 7920 6966 206f 7468 uted.only if oth │ │ │ │ │ +00048bb0: 6572 2063 6572 7461 696e 2063 6f6e 6469 er certain condi │ │ │ │ │ +00048bc0: 7469 6f6e 7320 686f 6c64 2028 666f 7220 tions hold (for │ │ │ │ │ +00048bd0: 6578 616d 706c 652c 2074 6865 2027 636f example, the 'co │ │ │ │ │ +00048be0: 6e66 6967 2e68 2e74 6f70 270a 616e 6420 nfig.h.top'.and │ │ │ │ │ +00048bf0: 2763 6f6e 6669 672e 682e 626f 7427 2066 'config.h.bot' f │ │ │ │ │ +00048c00: 696c 6573 2061 7265 2061 7574 6f6d 6174 iles are automat │ │ │ │ │ +00048c10: 6963 616c 6c79 2064 6973 7472 6962 7574 ically distribut │ │ │ │ │ +00048c20: 6564 206f 6e6c 7920 6966 2c20 652e 672e ed only if, e.g. │ │ │ │ │ +00048c30: 2c0a 2741 435f 434f 4e46 4947 5f48 4541 ,.'AC_CONFIG_HEA │ │ │ │ │ +00048c40: 4445 5253 285b 636f 6e66 6967 2e68 5d29 DERS([config.h]) │ │ │ │ │ +00048c50: 2720 6973 2075 7365 6420 696e 2027 636f ' is used in 'co │ │ │ │ │ +00048c60: 6e66 6967 7572 652e 6163 2729 2e20 2041 nfigure.ac'). A │ │ │ │ │ +00048c70: 6c73 6f2c 2066 696c 6573 0a74 6861 7420 lso, files.that │ │ │ │ │ +00048c80: 6172 6520 7265 6164 2062 7920 2763 6f6e are read by 'con │ │ │ │ │ +00048c90: 6669 6775 7265 2720 2869 2e65 2e20 7468 figure' (i.e. th │ │ │ │ │ +00048ca0: 6520 736f 7572 6365 2066 696c 6573 2063 e source files c │ │ │ │ │ +00048cb0: 6f72 7265 7370 6f6e 6469 6e67 2074 6f20 orresponding to │ │ │ │ │ +00048cc0: 7468 650a 6669 6c65 7320 7370 6563 6966 the.files specif │ │ │ │ │ +00048cd0: 6965 6420 696e 2076 6172 696f 7573 2041 ied in various A │ │ │ │ │ +00048ce0: 7574 6f63 6f6e 6620 6d61 6372 6f73 2073 utoconf macros s │ │ │ │ │ +00048cf0: 7563 6820 6173 2027 4143 5f43 4f4e 4649 uch as 'AC_CONFI │ │ │ │ │ +00048d00: 475f 4649 4c45 5327 2061 6e64 0a73 6962 G_FILES' and.sib │ │ │ │ │ +00048d10: 6c69 6e67 7329 2061 7265 2061 7574 6f6d lings) are autom │ │ │ │ │ +00048d20: 6174 6963 616c 6c79 2064 6973 7472 6962 atically distrib │ │ │ │ │ +00048d30: 7574 6564 2e20 2046 696c 6573 2069 6e63 uted. Files inc │ │ │ │ │ +00048d40: 6c75 6465 6420 696e 2061 0a27 4d61 6b65 luded in a.'Make │ │ │ │ │ +00048d50: 6669 6c65 2e61 6d27 2028 7573 696e 6720 file.am' (using │ │ │ │ │ +00048d60: 2769 6e63 6c75 6465 2729 206f 7220 696e 'include') or in │ │ │ │ │ +00048d70: 2027 636f 6e66 6967 7572 652e 6163 2720 'configure.ac' │ │ │ │ │ +00048d80: 2875 7369 6e67 0a27 6d34 5f69 6e63 6c75 (using.'m4_inclu │ │ │ │ │ +00048d90: 6465 2729 2c20 616e 6420 6865 6c70 6572 de'), and helper │ │ │ │ │ +00048da0: 2073 6372 6970 7473 2069 6e73 7461 6c6c scripts install │ │ │ │ │ +00048db0: 6564 2077 6974 6820 2761 7574 6f6d 616b ed with 'automak │ │ │ │ │ +00048dc0: 650a 2d2d 6164 642d 6d69 7373 696e 6727 e.--add-missing' │ │ │ │ │ +00048dd0: 2061 7265 2061 6c73 6f20 6469 7374 7269 are also distri │ │ │ │ │ +00048de0: 6275 7465 642e 0a0a 2020 2053 7469 6c6c buted... Still │ │ │ │ │ +00048df0: 2c20 736f 6d65 7469 6d65 7320 7468 6572 , sometimes ther │ │ │ │ │ +00048e00: 6520 6172 6520 6669 6c65 7320 7468 6174 e are files that │ │ │ │ │ +00048e10: 206d 7573 7420 6265 2064 6973 7472 6962 must be distrib │ │ │ │ │ +00048e20: 7574 6564 2c20 6275 7420 7768 6963 680a uted, but which. │ │ │ │ │ +00048e30: 6172 6520 6e6f 7420 636f 7665 7265 6420 are not covered │ │ │ │ │ +00048e40: 696e 2074 6865 2061 7574 6f6d 6174 6963 in the automatic │ │ │ │ │ +00048e50: 2072 756c 6573 2e20 2054 6865 7365 2066 rules. These f │ │ │ │ │ +00048e60: 696c 6573 2073 686f 756c 6420 6265 206c iles should be l │ │ │ │ │ +00048e70: 6973 7465 6420 696e 0a74 6865 2027 4558 isted in.the 'EX │ │ │ │ │ +00048e80: 5452 415f 4449 5354 2720 7661 7269 6162 TRA_DIST' variab │ │ │ │ │ +00048e90: 6c65 2e20 2059 6f75 2063 616e 206d 656e le. You can men │ │ │ │ │ +00048ea0: 7469 6f6e 2066 696c 6573 2066 726f 6d20 tion files from │ │ │ │ │ +00048eb0: 7375 6264 6972 6563 746f 7269 6573 2069 subdirectories i │ │ │ │ │ +00048ec0: 6e0a 2745 5854 5241 5f44 4953 5427 2e0a n.'EXTRA_DIST'.. │ │ │ │ │ +00048ed0: 0a20 2020 596f 7520 6361 6e20 616c 736f . You can also │ │ │ │ │ +00048ee0: 206d 656e 7469 6f6e 2061 2064 6972 6563 mention a direc │ │ │ │ │ +00048ef0: 746f 7279 2069 6e20 2745 5854 5241 5f44 tory in 'EXTRA_D │ │ │ │ │ +00048f00: 4953 5427 3b20 696e 2074 6869 7320 6361 IST'; in this ca │ │ │ │ │ +00048f10: 7365 2074 6865 0a65 6e74 6972 6520 6469 se the.entire di │ │ │ │ │ +00048f20: 7265 6374 6f72 7920 7769 6c6c 2062 6520 rectory will be │ │ │ │ │ +00048f30: 7265 6375 7273 6976 656c 7920 636f 7069 recursively copi │ │ │ │ │ +00048f40: 6564 2069 6e74 6f20 7468 6520 6469 7374 ed into the dist │ │ │ │ │ +00048f50: 7269 6275 7469 6f6e 2e0a 506c 6561 7365 ribution..Please │ │ │ │ │ +00048f60: 206e 6f74 6520 7468 6174 2074 6869 7320 note that this │ │ │ │ │ +00048f70: 7769 6c6c 2061 6c73 6f20 636f 7079 205f will also copy _ │ │ │ │ │ +00048f80: 6576 6572 7974 6869 6e67 5f20 696e 2074 everything_ in t │ │ │ │ │ +00048f90: 6865 2064 6972 6563 746f 7279 2c0a 696e he directory,.in │ │ │ │ │ +00048fa0: 636c 7564 696e 672c 2065 2e67 2e2c 2053 cluding, e.g., S │ │ │ │ │ +00048fb0: 7562 7665 7273 696f 6e27 7320 272e 7376 ubversion's '.sv │ │ │ │ │ +00048fc0: 6e27 2070 7269 7661 7465 2064 6972 6563 n' private direc │ │ │ │ │ +00048fd0: 746f 7269 6573 206f 7220 4356 532f 5243 tories or CVS/RC │ │ │ │ │ +00048fe0: 530a 7665 7273 696f 6e20 636f 6e74 726f S.version contro │ │ │ │ │ +00048ff0: 6c20 6669 6c65 732e 2020 5765 2072 6563 l files. We rec │ │ │ │ │ +00049000: 6f6d 6d65 6e64 2061 6761 696e 7374 2075 ommend against u │ │ │ │ │ +00049010: 7369 6e67 2074 6869 7320 6665 6174 7572 sing this featur │ │ │ │ │ +00049020: 652e 0a0a 2020 2049 6620 796f 7520 6465 e... If you de │ │ │ │ │ +00049030: 6669 6e65 2027 5355 4244 4952 5327 2c20 fine 'SUBDIRS', │ │ │ │ │ +00049040: 4175 746f 6d61 6b65 2077 696c 6c20 7265 Automake will re │ │ │ │ │ +00049050: 6375 7273 6976 656c 7920 696e 636c 7564 cursively includ │ │ │ │ │ +00049060: 6520 7468 650a 7375 6264 6972 6563 746f e the.subdirecto │ │ │ │ │ +00049070: 7269 6573 2069 6e20 7468 6520 6469 7374 ries in the dist │ │ │ │ │ +00049080: 7269 6275 7469 6f6e 2e20 2049 6620 2753 ribution. If 'S │ │ │ │ │ +00049090: 5542 4449 5253 2720 6973 2064 6566 696e UBDIRS' is defin │ │ │ │ │ +000490a0: 6564 0a63 6f6e 6469 7469 6f6e 616c 6c79 ed.conditionally │ │ │ │ │ +000490b0: 2028 2a6e 6f74 6520 436f 6e64 6974 696f (*note Conditio │ │ │ │ │ +000490c0: 6e61 6c73 3a3a 292c 2041 7574 6f6d 616b nals::), Automak │ │ │ │ │ +000490d0: 6520 7769 6c6c 206e 6f72 6d61 6c6c 7920 e will normally │ │ │ │ │ +000490e0: 696e 636c 7564 6520 616c 6c0a 6469 7265 include all.dire │ │ │ │ │ +000490f0: 6374 6f72 6965 7320 7468 6174 2063 6f75 ctories that cou │ │ │ │ │ +00049100: 6c64 2070 6f73 7369 626c 7920 6170 7065 ld possibly appe │ │ │ │ │ +00049110: 6172 2069 6e20 2753 5542 4449 5253 2720 ar in 'SUBDIRS' │ │ │ │ │ +00049120: 696e 2074 6865 2064 6973 7472 6962 7574 in the distribut │ │ │ │ │ +00049130: 696f 6e2e 0a49 6620 796f 7520 6e65 6564 ion..If you need │ │ │ │ │ +00049140: 2074 6f20 7370 6563 6966 7920 7468 6520 to specify the │ │ │ │ │ +00049150: 7365 7420 6f66 2064 6972 6563 746f 7269 set of directori │ │ │ │ │ +00049160: 6573 2063 6f6e 6469 7469 6f6e 616c 6c79 es conditionally │ │ │ │ │ +00049170: 2c20 796f 7520 6361 6e20 7365 740a 7468 , you can set.th │ │ │ │ │ +00049180: 6520 7661 7269 6162 6c65 2027 4449 5354 e variable 'DIST │ │ │ │ │ +00049190: 5f53 5542 4449 5253 2720 746f 2074 6865 _SUBDIRS' to the │ │ │ │ │ +000491a0: 2065 7861 6374 206c 6973 7420 6f66 2073 exact list of s │ │ │ │ │ +000491b0: 7562 6469 7265 6374 6f72 6965 7320 746f ubdirectories to │ │ │ │ │ +000491c0: 0a69 6e63 6c75 6465 2069 6e20 7468 6520 .include in the │ │ │ │ │ +000491d0: 6469 7374 7269 6275 7469 6f6e 2028 2a6e distribution (*n │ │ │ │ │ +000491e0: 6f74 6520 436f 6e64 6974 696f 6e61 6c20 ote Conditional │ │ │ │ │ +000491f0: 5375 6264 6972 6563 746f 7269 6573 3a3a Subdirectories:: │ │ │ │ │ +00049200: 292e 0a0a 1f0a 4669 6c65 3a20 6175 746f ).....File: auto │ │ │ │ │ +00049210: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +00049220: 204e 6f64 653a 2046 696e 652d 6772 6169 Node: Fine-grai │ │ │ │ │ +00049230: 6e65 6420 4469 7374 7269 6275 7469 6f6e ned Distribution │ │ │ │ │ +00049240: 2043 6f6e 7472 6f6c 2c20 204e 6578 743a Control, Next: │ │ │ │ │ +00049250: 2054 6865 2064 6973 7420 486f 6f6b 2c20 The dist Hook, │ │ │ │ │ +00049260: 2050 7265 763a 2042 6173 6963 7320 6f66 Prev: Basics of │ │ │ │ │ +00049270: 2044 6973 7472 6962 7574 696f 6e2c 2020 Distribution, │ │ │ │ │ +00049280: 5570 3a20 4469 7374 0a0a 3134 2e32 2046 Up: Dist..14.2 F │ │ │ │ │ +00049290: 696e 652d 6772 6169 6e65 6420 4469 7374 ine-grained Dist │ │ │ │ │ +000492a0: 7269 6275 7469 6f6e 2043 6f6e 7472 6f6c ribution Control │ │ │ │ │ +000492b0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ 000492c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000492d0: 3d3d 3d3d 3d0a 0a53 6f6d 6574 696d 6573 =====..Sometimes │ │ │ │ │ -000492e0: 2079 6f75 206e 6565 6420 7469 6768 7465 you need tighte │ │ │ │ │ -000492f0: 7220 636f 6e74 726f 6c20 6f76 6572 2077 r control over w │ │ │ │ │ -00049300: 6861 7420 646f 6573 205f 6e6f 745f 2067 hat does _not_ g │ │ │ │ │ -00049310: 6f20 696e 746f 2074 6865 0a64 6973 7472 o into the.distr │ │ │ │ │ -00049320: 6962 7574 696f 6e3b 2066 6f72 2069 6e73 ibution; for ins │ │ │ │ │ -00049330: 7461 6e63 652c 2079 6f75 206d 6967 6874 tance, you might │ │ │ │ │ -00049340: 2068 6176 6520 736f 7572 6365 2066 696c have source fil │ │ │ │ │ -00049350: 6573 2074 6861 7420 6172 650a 6765 6e65 es that are.gene │ │ │ │ │ -00049360: 7261 7465 6420 616e 6420 7468 6174 2079 rated and that y │ │ │ │ │ -00049370: 6f75 2064 6f20 6e6f 7420 7761 6e74 2074 ou do not want t │ │ │ │ │ -00049380: 6f20 6469 7374 7269 6275 7465 2e20 2049 o distribute. I │ │ │ │ │ -00049390: 6e20 7468 6973 2063 6173 6520 4175 746f n this case Auto │ │ │ │ │ -000493a0: 6d61 6b65 0a67 6976 6573 2066 696e 652d make.gives fine- │ │ │ │ │ -000493b0: 6772 6169 6e65 6420 636f 6e74 726f 6c20 grained control │ │ │ │ │ -000493c0: 7573 696e 6720 7468 6520 2764 6973 7427 using the 'dist' │ │ │ │ │ -000493d0: 2061 6e64 2027 6e6f 6469 7374 2720 7072 and 'nodist' pr │ │ │ │ │ -000493e0: 6566 6978 6573 2e20 2041 6e79 0a70 7269 efixes. Any.pri │ │ │ │ │ -000493f0: 6d61 7279 206f 7220 275f 534f 5552 4345 mary or '_SOURCE │ │ │ │ │ -00049400: 5327 2076 6172 6961 626c 6520 6361 6e20 S' variable can │ │ │ │ │ -00049410: 6265 2070 7265 6669 7865 6420 7769 7468 be prefixed with │ │ │ │ │ -00049420: 2027 6469 7374 5f27 2074 6f20 6164 6420 'dist_' to add │ │ │ │ │ -00049430: 7468 650a 6c69 7374 6564 2066 696c 6573 the.listed files │ │ │ │ │ -00049440: 2074 6f20 7468 6520 6469 7374 7269 6275 to the distribu │ │ │ │ │ -00049450: 7469 6f6e 2e20 2053 696d 696c 6172 6c79 tion. Similarly │ │ │ │ │ -00049460: 2c20 276e 6f64 6973 745f 2720 6361 6e20 , 'nodist_' can │ │ │ │ │ -00049470: 6265 2075 7365 6420 746f 0a6f 6d69 7420 be used to.omit │ │ │ │ │ -00049480: 7468 6520 6669 6c65 7320 6672 6f6d 2074 the files from t │ │ │ │ │ -00049490: 6865 2064 6973 7472 6962 7574 696f 6e2e he distribution. │ │ │ │ │ -000494a0: 0a0a 2020 2041 7320 616e 2065 7861 6d70 .. As an examp │ │ │ │ │ -000494b0: 6c65 2c20 6865 7265 2069 7320 686f 7720 le, here is how │ │ │ │ │ -000494c0: 796f 7520 776f 756c 6420 6361 7573 6520 you would cause │ │ │ │ │ -000494d0: 736f 6d65 2064 6174 6120 746f 2062 650a some data to be. │ │ │ │ │ -000494e0: 6469 7374 7269 6275 7465 6420 7768 696c distributed whil │ │ │ │ │ -000494f0: 6520 6c65 6176 696e 6720 736f 6d65 2073 e leaving some s │ │ │ │ │ -00049500: 6f75 7263 6520 636f 6465 206f 7574 206f ource code out o │ │ │ │ │ -00049510: 6620 7468 6520 6469 7374 7269 6275 7469 f the distributi │ │ │ │ │ -00049520: 6f6e 3a0a 0a20 2020 2020 6469 7374 5f64 on:.. dist_d │ │ │ │ │ -00049530: 6174 615f 4441 5441 203d 2064 6973 7472 ata_DATA = distr │ │ │ │ │ -00049540: 6962 7574 652d 7468 6973 0a20 2020 2020 ibute-this. │ │ │ │ │ -00049550: 6269 6e5f 5052 4f47 5241 4d53 203d 2066 bin_PROGRAMS = f │ │ │ │ │ -00049560: 6f6f 0a20 2020 2020 6e6f 6469 7374 5f66 oo. nodist_f │ │ │ │ │ -00049570: 6f6f 5f53 4f55 5243 4553 203d 2064 6f2d oo_SOURCES = do- │ │ │ │ │ -00049580: 6e6f 742d 6469 7374 7269 6275 7465 2e63 not-distribute.c │ │ │ │ │ -00049590: 0a0a .. │ │ │ │ │ +000492d0: 3d3d 3d3d 3d3d 3d0a 0a53 6f6d 6574 696d =======..Sometim │ │ │ │ │ +000492e0: 6573 2079 6f75 206e 6565 6420 7469 6768 es you need tigh │ │ │ │ │ +000492f0: 7465 7220 636f 6e74 726f 6c20 6f76 6572 ter control over │ │ │ │ │ +00049300: 2077 6861 7420 646f 6573 205f 6e6f 745f what does _not_ │ │ │ │ │ +00049310: 2067 6f20 696e 746f 2074 6865 0a64 6973 go into the.dis │ │ │ │ │ +00049320: 7472 6962 7574 696f 6e3b 2066 6f72 2069 tribution; for i │ │ │ │ │ +00049330: 6e73 7461 6e63 652c 2079 6f75 206d 6967 nstance, you mig │ │ │ │ │ +00049340: 6874 2068 6176 6520 736f 7572 6365 2066 ht have source f │ │ │ │ │ +00049350: 696c 6573 2074 6861 7420 6172 650a 6765 iles that are.ge │ │ │ │ │ +00049360: 6e65 7261 7465 6420 616e 6420 7468 6174 nerated and that │ │ │ │ │ +00049370: 2079 6f75 2064 6f20 6e6f 7420 7761 6e74 you do not want │ │ │ │ │ +00049380: 2074 6f20 6469 7374 7269 6275 7465 2e20 to distribute. │ │ │ │ │ +00049390: 2049 6e20 7468 6973 2063 6173 6520 4175 In this case Au │ │ │ │ │ +000493a0: 746f 6d61 6b65 0a67 6976 6573 2066 696e tomake.gives fin │ │ │ │ │ +000493b0: 652d 6772 6169 6e65 6420 636f 6e74 726f e-grained contro │ │ │ │ │ +000493c0: 6c20 7573 696e 6720 7468 6520 2764 6973 l using the 'dis │ │ │ │ │ +000493d0: 7427 2061 6e64 2027 6e6f 6469 7374 2720 t' and 'nodist' │ │ │ │ │ +000493e0: 7072 6566 6978 6573 2e20 2041 6e79 0a70 prefixes. Any.p │ │ │ │ │ +000493f0: 7269 6d61 7279 206f 7220 275f 534f 5552 rimary or '_SOUR │ │ │ │ │ +00049400: 4345 5327 2076 6172 6961 626c 6520 6361 CES' variable ca │ │ │ │ │ +00049410: 6e20 6265 2070 7265 6669 7865 6420 7769 n be prefixed wi │ │ │ │ │ +00049420: 7468 2027 6469 7374 5f27 2074 6f20 6164 th 'dist_' to ad │ │ │ │ │ +00049430: 6420 7468 650a 6c69 7374 6564 2066 696c d the.listed fil │ │ │ │ │ +00049440: 6573 2074 6f20 7468 6520 6469 7374 7269 es to the distri │ │ │ │ │ +00049450: 6275 7469 6f6e 2e20 2053 696d 696c 6172 bution. Similar │ │ │ │ │ +00049460: 6c79 2c20 276e 6f64 6973 745f 2720 6361 ly, 'nodist_' ca │ │ │ │ │ +00049470: 6e20 6265 2075 7365 6420 746f 0a6f 6d69 n be used to.omi │ │ │ │ │ +00049480: 7420 7468 6520 6669 6c65 7320 6672 6f6d t the files from │ │ │ │ │ +00049490: 2074 6865 2064 6973 7472 6962 7574 696f the distributio │ │ │ │ │ +000494a0: 6e2e 0a0a 2020 2041 7320 616e 2065 7861 n... As an exa │ │ │ │ │ +000494b0: 6d70 6c65 2c20 6865 7265 2069 7320 686f mple, here is ho │ │ │ │ │ +000494c0: 7720 796f 7520 776f 756c 6420 6361 7573 w you would caus │ │ │ │ │ +000494d0: 6520 736f 6d65 2064 6174 6120 746f 2062 e some data to b │ │ │ │ │ +000494e0: 650a 6469 7374 7269 6275 7465 6420 7768 e.distributed wh │ │ │ │ │ +000494f0: 696c 6520 6c65 6176 696e 6720 736f 6d65 ile leaving some │ │ │ │ │ +00049500: 2073 6f75 7263 6520 636f 6465 206f 7574 source code out │ │ │ │ │ +00049510: 206f 6620 7468 6520 6469 7374 7269 6275 of the distribu │ │ │ │ │ +00049520: 7469 6f6e 3a0a 0a20 2020 2020 6469 7374 tion:.. dist │ │ │ │ │ +00049530: 5f64 6174 615f 4441 5441 203d 2064 6973 _data_DATA = dis │ │ │ │ │ +00049540: 7472 6962 7574 652d 7468 6973 0a20 2020 tribute-this. │ │ │ │ │ +00049550: 2020 6269 6e5f 5052 4f47 5241 4d53 203d bin_PROGRAMS = │ │ │ │ │ +00049560: 2066 6f6f 0a20 2020 2020 6e6f 6469 7374 foo. nodist │ │ │ │ │ +00049570: 5f66 6f6f 5f53 4f55 5243 4553 203d 2064 _foo_SOURCES = d │ │ │ │ │ +00049580: 6f2d 6e6f 742d 6469 7374 7269 6275 7465 o-not-distribute │ │ │ │ │ +00049590: 2e63 0a0a .c.. │ │ │ ├── ./usr/share/info/automake-1.11.info-2.gz │ │ │ │ ├── automake-1.11.info-2 │ │ │ │ │ @@ -2,19699 +2,19699 @@ │ │ │ │ │ 00000010: 2d31 2e31 312e 696e 666f 2c20 7072 6f64 -1.11.info, prod │ │ │ │ │ 00000020: 7563 6564 2062 7920 6d61 6b65 696e 666f uced by makeinfo │ │ │ │ │ 00000030: 2076 6572 7369 6f6e 2036 2e37 2066 726f version 6.7 fro │ │ │ │ │ 00000040: 6d0a 6175 746f 6d61 6b65 2e74 6578 692e m.automake.texi. │ │ │ │ │ 00000050: 0a0a 5468 6973 206d 616e 7561 6c20 6973 ..This manual is │ │ │ │ │ 00000060: 2066 6f72 2047 4e55 2041 7574 6f6d 616b for GNU Automak │ │ │ │ │ 00000070: 6520 2876 6572 7369 6f6e 2031 2e31 312e e (version 1.11. │ │ │ │ │ -00000080: 362c 2031 3420 4a61 6e75 6172 7920 3230 6, 14 January 20 │ │ │ │ │ -00000090: 3234 292c 2061 0a70 726f 6772 616d 2074 24), a.program t │ │ │ │ │ -000000a0: 6861 7420 6372 6561 7465 7320 474e 5520 hat creates GNU │ │ │ │ │ -000000b0: 7374 616e 6461 7264 732d 636f 6d70 6c69 standards-compli │ │ │ │ │ -000000c0: 616e 7420 4d61 6b65 6669 6c65 7320 6672 ant Makefiles fr │ │ │ │ │ -000000d0: 6f6d 2074 656d 706c 6174 650a 6669 6c65 om template.file │ │ │ │ │ -000000e0: 732e 0a0a 2020 2043 6f70 7972 6967 6874 s... Copyright │ │ │ │ │ -000000f0: 2028 4329 2031 3939 352c 2031 3939 362c (C) 1995, 1996, │ │ │ │ │ -00000100: 2031 3939 372c 2031 3939 382c 2031 3939 1997, 1998, 199 │ │ │ │ │ -00000110: 392c 2032 3030 302c 2032 3030 312c 2032 9, 2000, 2001, 2 │ │ │ │ │ -00000120: 3030 322c 2032 3030 332c 0a32 3030 342c 002, 2003,.2004, │ │ │ │ │ -00000130: 2032 3030 352c 2032 3030 362c 2032 3030 2005, 2006, 200 │ │ │ │ │ -00000140: 372c 2032 3030 382c 2032 3030 392c 2032 7, 2008, 2009, 2 │ │ │ │ │ -00000150: 3031 302c 2032 3031 312c 2032 3031 3220 010, 2011, 2012 │ │ │ │ │ -00000160: 4672 6565 2053 6f66 7477 6172 650a 466f Free Software.Fo │ │ │ │ │ -00000170: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ -00000180: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ -00000190: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ -000001a0: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ -000001b0: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ -000001c0: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ -000001d0: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ -000001e0: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ -000001f0: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ -00000200: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ -00000210: 696f 6e20 312e 3320 6f72 2061 6e79 206c ion 1.3 or any l │ │ │ │ │ -00000220: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ -00000230: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ -00000240: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ -00000250: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ -00000260: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ -00000270: 6563 7469 6f6e 732c 2077 6974 6820 6e6f ections, with no │ │ │ │ │ -00000280: 2046 726f 6e74 2d43 6f76 6572 2074 6578 Front-Cover tex │ │ │ │ │ -00000290: 7473 2c0a 2020 2020 2061 6e64 2077 6974 ts,. and wit │ │ │ │ │ -000002a0: 6820 6e6f 2042 6163 6b2d 436f 7665 7220 h no Back-Cover │ │ │ │ │ -000002b0: 5465 7874 732e 2020 4120 636f 7079 206f Texts. A copy o │ │ │ │ │ -000002c0: 6620 7468 6520 6c69 6365 6e73 6520 6973 f the license is │ │ │ │ │ -000002d0: 2069 6e63 6c75 6465 6420 696e 0a20 2020 included in. │ │ │ │ │ -000002e0: 2020 7468 6520 7365 6374 696f 6e20 656e the section en │ │ │ │ │ -000002f0: 7469 746c 6564 2022 474e 5520 4672 6565 titled "GNU Free │ │ │ │ │ -00000300: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00000310: 6963 656e 7365 2e22 0a0a 494e 464f 2d44 icense."..INFO-D │ │ │ │ │ -00000320: 4952 2d53 4543 5449 4f4e 2053 6f66 7477 IR-SECTION Softw │ │ │ │ │ -00000330: 6172 6520 6465 7665 6c6f 706d 656e 740a are development. │ │ │ │ │ -00000340: 5354 4152 542d 494e 464f 2d44 4952 2d45 START-INFO-DIR-E │ │ │ │ │ -00000350: 4e54 5259 0a2a 2041 7574 6f6d 616b 653a NTRY.* Automake: │ │ │ │ │ -00000360: 2028 6175 746f 6d61 6b65 2d31 2e31 3129 (automake-1.11) │ │ │ │ │ -00000370: 2e20 2020 2020 2020 2020 4d61 6b69 6e67 . Making │ │ │ │ │ -00000380: 2047 4e55 2073 7461 6e64 6172 6473 2d63 GNU standards-c │ │ │ │ │ -00000390: 6f6d 706c 6961 6e74 204d 616b 6566 696c ompliant Makefil │ │ │ │ │ -000003a0: 6573 2e0a 454e 442d 494e 464f 2d44 4952 es..END-INFO-DIR │ │ │ │ │ -000003b0: 2d45 4e54 5259 0a0a 494e 464f 2d44 4952 -ENTRY..INFO-DIR │ │ │ │ │ -000003c0: 2d53 4543 5449 4f4e 2049 6e64 6976 6964 -SECTION Individ │ │ │ │ │ -000003d0: 7561 6c20 7574 696c 6974 6965 730a 5354 ual utilities.ST │ │ │ │ │ -000003e0: 4152 542d 494e 464f 2d44 4952 2d45 4e54 ART-INFO-DIR-ENT │ │ │ │ │ -000003f0: 5259 0a2a 2061 636c 6f63 616c 2d69 6e76 RY.* aclocal-inv │ │ │ │ │ -00000400: 6f63 6174 696f 6e3a 2028 6175 746f 6d61 ocation: (automa │ │ │ │ │ -00000410: 6b65 2d31 2e31 3129 6163 6c6f 6361 6c20 ke-1.11)aclocal │ │ │ │ │ -00000420: 496e 766f 6361 7469 6f6e 2e20 2047 656e Invocation. Gen │ │ │ │ │ -00000430: 6572 6174 696e 6720 6163 6c6f 6361 6c2e erating aclocal. │ │ │ │ │ -00000440: 6d34 2e0a 2a20 6175 746f 6d61 6b65 2d69 m4..* automake-i │ │ │ │ │ -00000450: 6e76 6f63 6174 696f 6e3a 2028 6175 746f nvocation: (auto │ │ │ │ │ -00000460: 6d61 6b65 2d31 2e31 3129 6175 746f 6d61 make-1.11)automa │ │ │ │ │ -00000470: 6b65 2049 6e76 6f63 6174 696f 6e2e 2047 ke Invocation. G │ │ │ │ │ -00000480: 656e 6572 6174 696e 6720 4d61 6b65 6669 enerating Makefi │ │ │ │ │ -00000490: 6c65 2e69 6e2e 0a45 4e44 2d49 4e46 4f2d le.in..END-INFO- │ │ │ │ │ -000004a0: 4449 522d 454e 5452 590a 0a1f 0a46 696c DIR-ENTRY....Fil │ │ │ │ │ -000004b0: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -000004c0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5468 .info, Node: Th │ │ │ │ │ -000004d0: 6520 6469 7374 2048 6f6f 6b2c 2020 4e65 e dist Hook, Ne │ │ │ │ │ -000004e0: 7874 3a20 4368 6563 6b69 6e67 2074 6865 xt: Checking the │ │ │ │ │ -000004f0: 2044 6973 7472 6962 7574 696f 6e2c 2020 Distribution, │ │ │ │ │ -00000500: 5072 6576 3a20 4669 6e65 2d67 7261 696e Prev: Fine-grain │ │ │ │ │ -00000510: 6564 2044 6973 7472 6962 7574 696f 6e20 ed Distribution │ │ │ │ │ -00000520: 436f 6e74 726f 6c2c 2020 5570 3a20 4469 Control, Up: Di │ │ │ │ │ -00000530: 7374 0a0a 3134 2e33 2054 6865 2064 6973 st..14.3 The dis │ │ │ │ │ -00000540: 7420 486f 6f6b 0a3d 3d3d 3d3d 3d3d 3d3d t Hook.========= │ │ │ │ │ -00000550: 3d3d 3d3d 3d3d 3d3d 3d0a 0a4f 6363 6173 =========..Occas │ │ │ │ │ -00000560: 696f 6e61 6c6c 7920 6974 2069 7320 7573 ionally it is us │ │ │ │ │ -00000570: 6566 756c 2074 6f20 6265 2061 626c 6520 eful to be able │ │ │ │ │ -00000580: 746f 2063 6861 6e67 6520 7468 6520 6469 to change the di │ │ │ │ │ -00000590: 7374 7269 6275 7469 6f6e 2062 6566 6f72 stribution befor │ │ │ │ │ -000005a0: 650a 6974 2069 7320 7061 636b 6167 6564 e.it is packaged │ │ │ │ │ -000005b0: 2075 702e 2020 4966 2074 6865 2027 6469 up. If the 'di │ │ │ │ │ -000005c0: 7374 2d68 6f6f 6b27 2072 756c 6520 6578 st-hook' rule ex │ │ │ │ │ -000005d0: 6973 7473 2c20 6974 2069 7320 7275 6e20 ists, it is run │ │ │ │ │ -000005e0: 6166 7465 7220 7468 650a 6469 7374 7269 after the.distri │ │ │ │ │ -000005f0: 6275 7469 6f6e 2064 6972 6563 746f 7279 bution directory │ │ │ │ │ -00000600: 2069 7320 6669 6c6c 6564 2c20 6275 7420 is filled, but │ │ │ │ │ -00000610: 6265 666f 7265 2074 6865 2061 6374 7561 before the actua │ │ │ │ │ -00000620: 6c20 7461 7220 286f 7220 7368 6172 290a l tar (or shar). │ │ │ │ │ -00000630: 6669 6c65 2069 7320 6372 6561 7465 642e file is created. │ │ │ │ │ -00000640: 2020 4f6e 6520 7761 7920 746f 2075 7365 One way to use │ │ │ │ │ -00000650: 2074 6869 7320 6973 2066 6f72 2064 6973 this is for dis │ │ │ │ │ -00000660: 7472 6962 7574 696e 6720 6669 6c65 7320 tributing files │ │ │ │ │ -00000670: 696e 0a73 7562 6469 7265 6374 6f72 6965 in.subdirectorie │ │ │ │ │ -00000680: 7320 666f 7220 7768 6963 6820 6120 6e65 s for which a ne │ │ │ │ │ -00000690: 7720 274d 616b 6566 696c 652e 616d 2720 w 'Makefile.am' │ │ │ │ │ -000006a0: 6973 206f 7665 726b 696c 6c3a 0a0a 2020 is overkill:.. │ │ │ │ │ -000006b0: 2020 2064 6973 742d 686f 6f6b 3a0a 2020 dist-hook:. │ │ │ │ │ -000006c0: 2020 2020 2020 2020 2020 206d 6b64 6972 mkdir │ │ │ │ │ -000006d0: 2024 2864 6973 7464 6972 292f 7261 6e64 $(distdir)/rand │ │ │ │ │ -000006e0: 6f6d 0a20 2020 2020 2020 2020 2020 2020 om. │ │ │ │ │ -000006f0: 6370 202d 7020 2428 7372 6364 6972 292f cp -p $(srcdir)/ │ │ │ │ │ -00000700: 7261 6e64 6f6d 2f61 3120 2428 7372 6364 random/a1 $(srcd │ │ │ │ │ -00000710: 6972 292f 7261 6e64 6f6d 2f61 3220 2428 ir)/random/a2 $( │ │ │ │ │ -00000720: 6469 7374 6469 7229 2f72 616e 646f 6d0a distdir)/random. │ │ │ │ │ -00000730: 0a20 2020 416e 6f74 6865 7220 7761 7920 . Another way │ │ │ │ │ -00000740: 746f 2075 7365 2074 6869 7320 6973 2066 to use this is f │ │ │ │ │ -00000750: 6f72 2072 656d 6f76 696e 6720 756e 6e65 or removing unne │ │ │ │ │ -00000760: 6365 7373 6172 7920 6669 6c65 7320 7468 cessary files th │ │ │ │ │ -00000770: 6174 2067 6574 0a72 6563 7572 7369 7665 at get.recursive │ │ │ │ │ -00000780: 6c79 2069 6e63 6c75 6465 6420 6279 2073 ly included by s │ │ │ │ │ -00000790: 7065 6369 6679 696e 6720 6120 6469 7265 pecifying a dire │ │ │ │ │ -000007a0: 6374 6f72 7920 696e 2045 5854 5241 5f44 ctory in EXTRA_D │ │ │ │ │ -000007b0: 4953 543a 0a0a 2020 2020 2045 5854 5241 IST:.. EXTRA │ │ │ │ │ -000007c0: 5f44 4953 5420 3d20 646f 630a 0a20 2020 _DIST = doc.. │ │ │ │ │ -000007d0: 2020 6469 7374 2d68 6f6f 6b3a 0a20 2020 dist-hook:. │ │ │ │ │ -000007e0: 2020 2020 2020 2020 2020 726d 202d 7266 rm -rf │ │ │ │ │ -000007f0: 2060 6669 6e64 2024 2864 6973 7464 6972 `find $(distdir │ │ │ │ │ -00000800: 292f 646f 6320 2d74 7970 6520 6420 2d6e )/doc -type d -n │ │ │ │ │ -00000810: 616d 6520 2e73 766e 600a 0a20 2020 5477 ame .svn`.. Tw │ │ │ │ │ -00000820: 6f20 7661 7269 6162 6c65 7320 7468 6174 o variables that │ │ │ │ │ -00000830: 2063 6f6d 6520 6861 6e64 7920 7768 656e come handy when │ │ │ │ │ -00000840: 2077 7269 7469 6e67 2027 6469 7374 2d68 writing 'dist-h │ │ │ │ │ -00000850: 6f6f 6b27 2072 756c 6573 2061 7265 0a27 ook' rules are.' │ │ │ │ │ -00000860: 2428 6469 7374 6469 7229 2720 616e 6420 $(distdir)' and │ │ │ │ │ -00000870: 2724 2874 6f70 5f64 6973 7464 6972 2927 '$(top_distdir)' │ │ │ │ │ -00000880: 2e0a 0a20 2020 2724 2864 6973 7464 6972 ... '$(distdir │ │ │ │ │ -00000890: 2927 2070 6f69 6e74 7320 746f 2074 6865 )' points to the │ │ │ │ │ -000008a0: 2064 6972 6563 746f 7279 2077 6865 7265 directory where │ │ │ │ │ -000008b0: 2074 6865 2027 6469 7374 2720 7275 6c65 the 'dist' rule │ │ │ │ │ -000008c0: 2077 696c 6c20 636f 7079 0a66 696c 6573 will copy.files │ │ │ │ │ -000008d0: 2066 726f 6d20 7468 6520 6375 7272 656e from the curren │ │ │ │ │ -000008e0: 7420 6469 7265 6374 6f72 7920 6265 666f t directory befo │ │ │ │ │ -000008f0: 7265 2063 7265 6174 696e 6720 7468 6520 re creating the │ │ │ │ │ -00000900: 7461 7262 616c 6c2e 2020 4966 2079 6f75 tarball. If you │ │ │ │ │ -00000910: 0a61 7265 2061 7420 7468 6520 746f 702d .are at the top- │ │ │ │ │ -00000920: 6c65 7665 6c20 6469 7265 6374 6f72 792c level directory, │ │ │ │ │ -00000930: 2074 6865 6e20 2764 6973 7464 6972 203d then 'distdir = │ │ │ │ │ -00000940: 2024 2850 4143 4b41 4745 292d 2428 5645 $(PACKAGE)-$(VE │ │ │ │ │ -00000950: 5253 494f 4e29 272e 0a57 6865 6e20 7573 RSION)'..When us │ │ │ │ │ -00000960: 6564 2066 726f 6d20 7375 6264 6972 6563 ed from subdirec │ │ │ │ │ -00000970: 746f 7279 206e 616d 6564 2027 666f 6f2f tory named 'foo/ │ │ │ │ │ -00000980: 272c 2074 6865 6e20 2764 6973 7464 6972 ', then 'distdir │ │ │ │ │ -00000990: 203d 0a2e 2e2f 2428 5041 434b 4147 4529 =.../$(PACKAGE) │ │ │ │ │ -000009a0: 2d24 2856 4552 5349 4f4e 292f 666f 6f27 -$(VERSION)/foo' │ │ │ │ │ -000009b0: 2e20 2027 2428 6469 7374 6469 7229 2720 . '$(distdir)' │ │ │ │ │ -000009c0: 6361 6e20 6265 2061 2072 656c 6174 6976 can be a relativ │ │ │ │ │ -000009d0: 6520 6f72 0a61 6273 6f6c 7574 6520 7061 e or.absolute pa │ │ │ │ │ -000009e0: 7468 2c20 646f 206e 6f74 2061 7373 756d th, do not assum │ │ │ │ │ -000009f0: 6520 616e 7920 666f 726d 2e0a 0a20 2020 e any form... │ │ │ │ │ -00000a00: 2724 2874 6f70 5f64 6973 7464 6972 2927 '$(top_distdir)' │ │ │ │ │ -00000a10: 2061 6c77 6179 7320 706f 696e 7473 2074 always points t │ │ │ │ │ -00000a20: 6f20 7468 6520 726f 6f74 2064 6972 6563 o the root direc │ │ │ │ │ -00000a30: 746f 7279 206f 6620 7468 650a 6469 7374 tory of the.dist │ │ │ │ │ -00000a40: 7269 6275 7465 6420 7472 6565 2e20 2041 ributed tree. A │ │ │ │ │ -00000a50: 7420 7468 6520 746f 702d 6c65 7665 6c20 t the top-level │ │ │ │ │ -00000a60: 6974 2773 2065 7175 616c 2074 6f20 2724 it's equal to '$ │ │ │ │ │ -00000a70: 2864 6973 7464 6972 2927 2e20 2049 6e20 (distdir)'. In │ │ │ │ │ -00000a80: 7468 650a 2766 6f6f 2f27 2073 7562 6469 the.'foo/' subdi │ │ │ │ │ -00000a90: 7265 6374 6f72 7920 2774 6f70 5f64 6973 rectory 'top_dis │ │ │ │ │ -00000aa0: 7464 6972 203d 202e 2e2f 2428 5041 434b tdir = ../$(PACK │ │ │ │ │ -00000ab0: 4147 4529 2d24 2856 4552 5349 4f4e 2927 AGE)-$(VERSION)' │ │ │ │ │ -00000ac0: 2e0a 2724 2874 6f70 5f64 6973 7464 6972 ..'$(top_distdir │ │ │ │ │ -00000ad0: 2927 2074 6f6f 2063 616e 2062 6520 6120 )' too can be a │ │ │ │ │ -00000ae0: 7265 6c61 7469 7665 206f 7220 6162 736f relative or abso │ │ │ │ │ -00000af0: 6c75 7465 2070 6174 682e 0a0a 2020 204e lute path... N │ │ │ │ │ -00000b00: 6f74 6520 7468 6174 2077 6865 6e20 7061 ote that when pa │ │ │ │ │ -00000b10: 636b 6167 6573 2061 7265 206e 6573 7465 ckages are neste │ │ │ │ │ -00000b20: 6420 7573 696e 6720 2741 435f 434f 4e46 d using 'AC_CONF │ │ │ │ │ -00000b30: 4947 5f53 5542 4449 5253 2720 282a 6e6f IG_SUBDIRS' (*no │ │ │ │ │ -00000b40: 7465 0a53 7562 7061 636b 6167 6573 3a3a te.Subpackages:: │ │ │ │ │ -00000b50: 292c 2074 6865 6e20 2724 2864 6973 7464 ), then '$(distd │ │ │ │ │ -00000b60: 6972 2927 2061 6e64 2027 2428 746f 705f ir)' and '$(top_ │ │ │ │ │ -00000b70: 6469 7374 6469 7229 2720 6172 6520 7265 distdir)' are re │ │ │ │ │ -00000b80: 6c61 7469 7665 2074 6f0a 7468 6520 7061 lative to.the pa │ │ │ │ │ -00000b90: 636b 6167 6520 7768 6572 6520 276d 616b ckage where 'mak │ │ │ │ │ -00000ba0: 6520 6469 7374 2720 7761 7320 7275 6e2c e dist' was run, │ │ │ │ │ -00000bb0: 206e 6f74 2074 6f20 616e 7920 7375 622d not to any sub- │ │ │ │ │ -00000bc0: 7061 636b 6167 6573 2069 6e76 6f6c 7665 packages involve │ │ │ │ │ -00000bd0: 642e 0a0a 1f0a 4669 6c65 3a20 6175 746f d.....File: auto │ │ │ │ │ -00000be0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00000bf0: 204e 6f64 653a 2043 6865 636b 696e 6720 Node: Checking │ │ │ │ │ -00000c00: 7468 6520 4469 7374 7269 6275 7469 6f6e the Distribution │ │ │ │ │ -00000c10: 2c20 204e 6578 743a 2054 6865 2054 7970 , Next: The Typ │ │ │ │ │ -00000c20: 6573 206f 6620 4469 7374 7269 6275 7469 es of Distributi │ │ │ │ │ -00000c30: 6f6e 732c 2020 5072 6576 3a20 5468 6520 ons, Prev: The │ │ │ │ │ -00000c40: 6469 7374 2048 6f6f 6b2c 2020 5570 3a20 dist Hook, Up: │ │ │ │ │ -00000c50: 4469 7374 0a0a 3134 2e34 2043 6865 636b Dist..14.4 Check │ │ │ │ │ -00000c60: 696e 6720 7468 6520 4469 7374 7269 6275 ing the Distribu │ │ │ │ │ -00000c70: 7469 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d tion.=========== │ │ │ │ │ +00000080: 362c 2031 3620 4665 6272 7561 7279 2032 6, 16 February 2 │ │ │ │ │ +00000090: 3032 3529 2c20 610a 7072 6f67 7261 6d20 025), a.program │ │ │ │ │ +000000a0: 7468 6174 2063 7265 6174 6573 2047 4e55 that creates GNU │ │ │ │ │ +000000b0: 2073 7461 6e64 6172 6473 2d63 6f6d 706c standards-compl │ │ │ │ │ +000000c0: 6961 6e74 204d 616b 6566 696c 6573 2066 iant Makefiles f │ │ │ │ │ +000000d0: 726f 6d20 7465 6d70 6c61 7465 0a66 696c rom template.fil │ │ │ │ │ +000000e0: 6573 2e0a 0a20 2020 436f 7079 7269 6768 es... Copyrigh │ │ │ │ │ +000000f0: 7420 2843 2920 3139 3935 2c20 3139 3936 t (C) 1995, 1996 │ │ │ │ │ +00000100: 2c20 3139 3937 2c20 3139 3938 2c20 3139 , 1997, 1998, 19 │ │ │ │ │ +00000110: 3939 2c20 3230 3030 2c20 3230 3031 2c20 99, 2000, 2001, │ │ │ │ │ +00000120: 3230 3032 2c20 3230 3033 2c0a 3230 3034 2002, 2003,.2004 │ │ │ │ │ +00000130: 2c20 3230 3035 2c20 3230 3036 2c20 3230 , 2005, 2006, 20 │ │ │ │ │ +00000140: 3037 2c20 3230 3038 2c20 3230 3039 2c20 07, 2008, 2009, │ │ │ │ │ +00000150: 3230 3130 2c20 3230 3131 2c20 3230 3132 2010, 2011, 2012 │ │ │ │ │ +00000160: 2046 7265 6520 536f 6674 7761 7265 0a46 Free Software.F │ │ │ │ │ +00000170: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ +00000180: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ +00000190: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ +000001a0: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ +000001b0: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ +000001c0: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ +000001d0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ +000001e0: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ +000001f0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ +00000200: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ +00000210: 7369 6f6e 2031 2e33 206f 7220 616e 7920 sion 1.3 or any │ │ │ │ │ +00000220: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ +00000230: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ +00000240: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ +00000250: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ +00000260: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ +00000270: 5365 6374 696f 6e73 2c20 7769 7468 206e Sections, with n │ │ │ │ │ +00000280: 6f20 4672 6f6e 742d 436f 7665 7220 7465 o Front-Cover te │ │ │ │ │ +00000290: 7874 732c 0a20 2020 2020 616e 6420 7769 xts,. and wi │ │ │ │ │ +000002a0: 7468 206e 6f20 4261 636b 2d43 6f76 6572 th no Back-Cover │ │ │ │ │ +000002b0: 2054 6578 7473 2e20 2041 2063 6f70 7920 Texts. A copy │ │ │ │ │ +000002c0: 6f66 2074 6865 206c 6963 656e 7365 2069 of the license i │ │ │ │ │ +000002d0: 7320 696e 636c 7564 6564 2069 6e0a 2020 s included in. │ │ │ │ │ +000002e0: 2020 2074 6865 2073 6563 7469 6f6e 2065 the section e │ │ │ │ │ +000002f0: 6e74 6974 6c65 6420 2247 4e55 2046 7265 ntitled "GNU Fre │ │ │ │ │ +00000300: 6520 446f 6375 6d65 6e74 6174 696f 6e20 e Documentation │ │ │ │ │ +00000310: 4c69 6365 6e73 652e 220a 0a49 4e46 4f2d License."..INFO- │ │ │ │ │ +00000320: 4449 522d 5345 4354 494f 4e20 536f 6674 DIR-SECTION Soft │ │ │ │ │ +00000330: 7761 7265 2064 6576 656c 6f70 6d65 6e74 ware development │ │ │ │ │ +00000340: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000350: 454e 5452 590a 2a20 4175 746f 6d61 6b65 ENTRY.* Automake │ │ │ │ │ +00000360: 3a20 2861 7574 6f6d 616b 652d 312e 3131 : (automake-1.11 │ │ │ │ │ +00000370: 292e 2020 2020 2020 2020 204d 616b 696e ). Makin │ │ │ │ │ +00000380: 6720 474e 5520 7374 616e 6461 7264 732d g GNU standards- │ │ │ │ │ +00000390: 636f 6d70 6c69 616e 7420 4d61 6b65 6669 compliant Makefi │ │ │ │ │ +000003a0: 6c65 732e 0a45 4e44 2d49 4e46 4f2d 4449 les..END-INFO-DI │ │ │ │ │ +000003b0: 522d 454e 5452 590a 0a49 4e46 4f2d 4449 R-ENTRY..INFO-DI │ │ │ │ │ +000003c0: 522d 5345 4354 494f 4e20 496e 6469 7669 R-SECTION Indivi │ │ │ │ │ +000003d0: 6475 616c 2075 7469 6c69 7469 6573 0a53 dual utilities.S │ │ │ │ │ +000003e0: 5441 5254 2d49 4e46 4f2d 4449 522d 454e TART-INFO-DIR-EN │ │ │ │ │ +000003f0: 5452 590a 2a20 6163 6c6f 6361 6c2d 696e TRY.* aclocal-in │ │ │ │ │ +00000400: 766f 6361 7469 6f6e 3a20 2861 7574 6f6d vocation: (autom │ │ │ │ │ +00000410: 616b 652d 312e 3131 2961 636c 6f63 616c ake-1.11)aclocal │ │ │ │ │ +00000420: 2049 6e76 6f63 6174 696f 6e2e 2020 4765 Invocation. Ge │ │ │ │ │ +00000430: 6e65 7261 7469 6e67 2061 636c 6f63 616c nerating aclocal │ │ │ │ │ +00000440: 2e6d 342e 0a2a 2061 7574 6f6d 616b 652d .m4..* automake- │ │ │ │ │ +00000450: 696e 766f 6361 7469 6f6e 3a20 2861 7574 invocation: (aut │ │ │ │ │ +00000460: 6f6d 616b 652d 312e 3131 2961 7574 6f6d omake-1.11)autom │ │ │ │ │ +00000470: 616b 6520 496e 766f 6361 7469 6f6e 2e20 ake Invocation. │ │ │ │ │ +00000480: 4765 6e65 7261 7469 6e67 204d 616b 6566 Generating Makef │ │ │ │ │ +00000490: 696c 652e 696e 2e0a 454e 442d 494e 464f ile.in..END-INFO │ │ │ │ │ +000004a0: 2d44 4952 2d45 4e54 5259 0a0a 1f0a 4669 -DIR-ENTRY....Fi │ │ │ │ │ +000004b0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +000004c0: 312e 696e 666f 2c20 204e 6f64 653a 2054 1.info, Node: T │ │ │ │ │ +000004d0: 6865 2064 6973 7420 486f 6f6b 2c20 204e he dist Hook, N │ │ │ │ │ +000004e0: 6578 743a 2043 6865 636b 696e 6720 7468 ext: Checking th │ │ │ │ │ +000004f0: 6520 4469 7374 7269 6275 7469 6f6e 2c20 e Distribution, │ │ │ │ │ +00000500: 2050 7265 763a 2046 696e 652d 6772 6169 Prev: Fine-grai │ │ │ │ │ +00000510: 6e65 6420 4469 7374 7269 6275 7469 6f6e ned Distribution │ │ │ │ │ +00000520: 2043 6f6e 7472 6f6c 2c20 2055 703a 2044 Control, Up: D │ │ │ │ │ +00000530: 6973 740a 0a31 342e 3320 5468 6520 6469 ist..14.3 The di │ │ │ │ │ +00000540: 7374 2048 6f6f 6b0a 3d3d 3d3d 3d3d 3d3d st Hook.======== │ │ │ │ │ +00000550: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4f63 6361 ==========..Occa │ │ │ │ │ +00000560: 7369 6f6e 616c 6c79 2069 7420 6973 2075 sionally it is u │ │ │ │ │ +00000570: 7365 6675 6c20 746f 2062 6520 6162 6c65 seful to be able │ │ │ │ │ +00000580: 2074 6f20 6368 616e 6765 2074 6865 2064 to change the d │ │ │ │ │ +00000590: 6973 7472 6962 7574 696f 6e20 6265 666f istribution befo │ │ │ │ │ +000005a0: 7265 0a69 7420 6973 2070 6163 6b61 6765 re.it is package │ │ │ │ │ +000005b0: 6420 7570 2e20 2049 6620 7468 6520 2764 d up. If the 'd │ │ │ │ │ +000005c0: 6973 742d 686f 6f6b 2720 7275 6c65 2065 ist-hook' rule e │ │ │ │ │ +000005d0: 7869 7374 732c 2069 7420 6973 2072 756e xists, it is run │ │ │ │ │ +000005e0: 2061 6674 6572 2074 6865 0a64 6973 7472 after the.distr │ │ │ │ │ +000005f0: 6962 7574 696f 6e20 6469 7265 6374 6f72 ibution director │ │ │ │ │ +00000600: 7920 6973 2066 696c 6c65 642c 2062 7574 y is filled, but │ │ │ │ │ +00000610: 2062 6566 6f72 6520 7468 6520 6163 7475 before the actu │ │ │ │ │ +00000620: 616c 2074 6172 2028 6f72 2073 6861 7229 al tar (or shar) │ │ │ │ │ +00000630: 0a66 696c 6520 6973 2063 7265 6174 6564 .file is created │ │ │ │ │ +00000640: 2e20 204f 6e65 2077 6179 2074 6f20 7573 . One way to us │ │ │ │ │ +00000650: 6520 7468 6973 2069 7320 666f 7220 6469 e this is for di │ │ │ │ │ +00000660: 7374 7269 6275 7469 6e67 2066 696c 6573 stributing files │ │ │ │ │ +00000670: 2069 6e0a 7375 6264 6972 6563 746f 7269 in.subdirectori │ │ │ │ │ +00000680: 6573 2066 6f72 2077 6869 6368 2061 206e es for which a n │ │ │ │ │ +00000690: 6577 2027 4d61 6b65 6669 6c65 2e61 6d27 ew 'Makefile.am' │ │ │ │ │ +000006a0: 2069 7320 6f76 6572 6b69 6c6c 3a0a 0a20 is overkill:.. │ │ │ │ │ +000006b0: 2020 2020 6469 7374 2d68 6f6f 6b3a 0a20 dist-hook:. │ │ │ │ │ +000006c0: 2020 2020 2020 2020 2020 2020 6d6b 6469 mkdi │ │ │ │ │ +000006d0: 7220 2428 6469 7374 6469 7229 2f72 616e r $(distdir)/ran │ │ │ │ │ +000006e0: 646f 6d0a 2020 2020 2020 2020 2020 2020 dom. │ │ │ │ │ +000006f0: 2063 7020 2d70 2024 2873 7263 6469 7229 cp -p $(srcdir) │ │ │ │ │ +00000700: 2f72 616e 646f 6d2f 6131 2024 2873 7263 /random/a1 $(src │ │ │ │ │ +00000710: 6469 7229 2f72 616e 646f 6d2f 6132 2024 dir)/random/a2 $ │ │ │ │ │ +00000720: 2864 6973 7464 6972 292f 7261 6e64 6f6d (distdir)/random │ │ │ │ │ +00000730: 0a0a 2020 2041 6e6f 7468 6572 2077 6179 .. Another way │ │ │ │ │ +00000740: 2074 6f20 7573 6520 7468 6973 2069 7320 to use this is │ │ │ │ │ +00000750: 666f 7220 7265 6d6f 7669 6e67 2075 6e6e for removing unn │ │ │ │ │ +00000760: 6563 6573 7361 7279 2066 696c 6573 2074 ecessary files t │ │ │ │ │ +00000770: 6861 7420 6765 740a 7265 6375 7273 6976 hat get.recursiv │ │ │ │ │ +00000780: 656c 7920 696e 636c 7564 6564 2062 7920 ely included by │ │ │ │ │ +00000790: 7370 6563 6966 7969 6e67 2061 2064 6972 specifying a dir │ │ │ │ │ +000007a0: 6563 746f 7279 2069 6e20 4558 5452 415f ectory in EXTRA_ │ │ │ │ │ +000007b0: 4449 5354 3a0a 0a20 2020 2020 4558 5452 DIST:.. EXTR │ │ │ │ │ +000007c0: 415f 4449 5354 203d 2064 6f63 0a0a 2020 A_DIST = doc.. │ │ │ │ │ +000007d0: 2020 2064 6973 742d 686f 6f6b 3a0a 2020 dist-hook:. │ │ │ │ │ +000007e0: 2020 2020 2020 2020 2020 2072 6d20 2d72 rm -r │ │ │ │ │ +000007f0: 6620 6066 696e 6420 2428 6469 7374 6469 f `find $(distdi │ │ │ │ │ +00000800: 7229 2f64 6f63 202d 7479 7065 2064 202d r)/doc -type d - │ │ │ │ │ +00000810: 6e61 6d65 202e 7376 6e60 0a0a 2020 2054 name .svn`.. T │ │ │ │ │ +00000820: 776f 2076 6172 6961 626c 6573 2074 6861 wo variables tha │ │ │ │ │ +00000830: 7420 636f 6d65 2068 616e 6479 2077 6865 t come handy whe │ │ │ │ │ +00000840: 6e20 7772 6974 696e 6720 2764 6973 742d n writing 'dist- │ │ │ │ │ +00000850: 686f 6f6b 2720 7275 6c65 7320 6172 650a hook' rules are. │ │ │ │ │ +00000860: 2724 2864 6973 7464 6972 2927 2061 6e64 '$(distdir)' and │ │ │ │ │ +00000870: 2027 2428 746f 705f 6469 7374 6469 7229 '$(top_distdir) │ │ │ │ │ +00000880: 272e 0a0a 2020 2027 2428 6469 7374 6469 '... '$(distdi │ │ │ │ │ +00000890: 7229 2720 706f 696e 7473 2074 6f20 7468 r)' points to th │ │ │ │ │ +000008a0: 6520 6469 7265 6374 6f72 7920 7768 6572 e directory wher │ │ │ │ │ +000008b0: 6520 7468 6520 2764 6973 7427 2072 756c e the 'dist' rul │ │ │ │ │ +000008c0: 6520 7769 6c6c 2063 6f70 790a 6669 6c65 e will copy.file │ │ │ │ │ +000008d0: 7320 6672 6f6d 2074 6865 2063 7572 7265 s from the curre │ │ │ │ │ +000008e0: 6e74 2064 6972 6563 746f 7279 2062 6566 nt directory bef │ │ │ │ │ +000008f0: 6f72 6520 6372 6561 7469 6e67 2074 6865 ore creating the │ │ │ │ │ +00000900: 2074 6172 6261 6c6c 2e20 2049 6620 796f tarball. If yo │ │ │ │ │ +00000910: 750a 6172 6520 6174 2074 6865 2074 6f70 u.are at the top │ │ │ │ │ +00000920: 2d6c 6576 656c 2064 6972 6563 746f 7279 -level directory │ │ │ │ │ +00000930: 2c20 7468 656e 2027 6469 7374 6469 7220 , then 'distdir │ │ │ │ │ +00000940: 3d20 2428 5041 434b 4147 4529 2d24 2856 = $(PACKAGE)-$(V │ │ │ │ │ +00000950: 4552 5349 4f4e 2927 2e0a 5768 656e 2075 ERSION)'..When u │ │ │ │ │ +00000960: 7365 6420 6672 6f6d 2073 7562 6469 7265 sed from subdire │ │ │ │ │ +00000970: 6374 6f72 7920 6e61 6d65 6420 2766 6f6f ctory named 'foo │ │ │ │ │ +00000980: 2f27 2c20 7468 656e 2027 6469 7374 6469 /', then 'distdi │ │ │ │ │ +00000990: 7220 3d0a 2e2e 2f24 2850 4143 4b41 4745 r =.../$(PACKAGE │ │ │ │ │ +000009a0: 292d 2428 5645 5253 494f 4e29 2f66 6f6f )-$(VERSION)/foo │ │ │ │ │ +000009b0: 272e 2020 2724 2864 6973 7464 6972 2927 '. '$(distdir)' │ │ │ │ │ +000009c0: 2063 616e 2062 6520 6120 7265 6c61 7469 can be a relati │ │ │ │ │ +000009d0: 7665 206f 720a 6162 736f 6c75 7465 2070 ve or.absolute p │ │ │ │ │ +000009e0: 6174 682c 2064 6f20 6e6f 7420 6173 7375 ath, do not assu │ │ │ │ │ +000009f0: 6d65 2061 6e79 2066 6f72 6d2e 0a0a 2020 me any form... │ │ │ │ │ +00000a00: 2027 2428 746f 705f 6469 7374 6469 7229 '$(top_distdir) │ │ │ │ │ +00000a10: 2720 616c 7761 7973 2070 6f69 6e74 7320 ' always points │ │ │ │ │ +00000a20: 746f 2074 6865 2072 6f6f 7420 6469 7265 to the root dire │ │ │ │ │ +00000a30: 6374 6f72 7920 6f66 2074 6865 0a64 6973 ctory of the.dis │ │ │ │ │ +00000a40: 7472 6962 7574 6564 2074 7265 652e 2020 tributed tree. │ │ │ │ │ +00000a50: 4174 2074 6865 2074 6f70 2d6c 6576 656c At the top-level │ │ │ │ │ +00000a60: 2069 7427 7320 6571 7561 6c20 746f 2027 it's equal to ' │ │ │ │ │ +00000a70: 2428 6469 7374 6469 7229 272e 2020 496e $(distdir)'. In │ │ │ │ │ +00000a80: 2074 6865 0a27 666f 6f2f 2720 7375 6264 the.'foo/' subd │ │ │ │ │ +00000a90: 6972 6563 746f 7279 2027 746f 705f 6469 irectory 'top_di │ │ │ │ │ +00000aa0: 7374 6469 7220 3d20 2e2e 2f24 2850 4143 stdir = ../$(PAC │ │ │ │ │ +00000ab0: 4b41 4745 292d 2428 5645 5253 494f 4e29 KAGE)-$(VERSION) │ │ │ │ │ +00000ac0: 272e 0a27 2428 746f 705f 6469 7374 6469 '..'$(top_distdi │ │ │ │ │ +00000ad0: 7229 2720 746f 6f20 6361 6e20 6265 2061 r)' too can be a │ │ │ │ │ +00000ae0: 2072 656c 6174 6976 6520 6f72 2061 6273 relative or abs │ │ │ │ │ +00000af0: 6f6c 7574 6520 7061 7468 2e0a 0a20 2020 olute path... │ │ │ │ │ +00000b00: 4e6f 7465 2074 6861 7420 7768 656e 2070 Note that when p │ │ │ │ │ +00000b10: 6163 6b61 6765 7320 6172 6520 6e65 7374 ackages are nest │ │ │ │ │ +00000b20: 6564 2075 7369 6e67 2027 4143 5f43 4f4e ed using 'AC_CON │ │ │ │ │ +00000b30: 4649 475f 5355 4244 4952 5327 2028 2a6e FIG_SUBDIRS' (*n │ │ │ │ │ +00000b40: 6f74 650a 5375 6270 6163 6b61 6765 733a ote.Subpackages: │ │ │ │ │ +00000b50: 3a29 2c20 7468 656e 2027 2428 6469 7374 :), then '$(dist │ │ │ │ │ +00000b60: 6469 7229 2720 616e 6420 2724 2874 6f70 dir)' and '$(top │ │ │ │ │ +00000b70: 5f64 6973 7464 6972 2927 2061 7265 2072 _distdir)' are r │ │ │ │ │ +00000b80: 656c 6174 6976 6520 746f 0a74 6865 2070 elative to.the p │ │ │ │ │ +00000b90: 6163 6b61 6765 2077 6865 7265 2027 6d61 ackage where 'ma │ │ │ │ │ +00000ba0: 6b65 2064 6973 7427 2077 6173 2072 756e ke dist' was run │ │ │ │ │ +00000bb0: 2c20 6e6f 7420 746f 2061 6e79 2073 7562 , not to any sub │ │ │ │ │ +00000bc0: 2d70 6163 6b61 6765 7320 696e 766f 6c76 -packages involv │ │ │ │ │ +00000bd0: 6564 2e0a 0a1f 0a46 696c 653a 2061 7574 ed.....File: aut │ │ │ │ │ +00000be0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +00000bf0: 2020 4e6f 6465 3a20 4368 6563 6b69 6e67 Node: Checking │ │ │ │ │ +00000c00: 2074 6865 2044 6973 7472 6962 7574 696f the Distributio │ │ │ │ │ +00000c10: 6e2c 2020 4e65 7874 3a20 5468 6520 5479 n, Next: The Ty │ │ │ │ │ +00000c20: 7065 7320 6f66 2044 6973 7472 6962 7574 pes of Distribut │ │ │ │ │ +00000c30: 696f 6e73 2c20 2050 7265 763a 2054 6865 ions, Prev: The │ │ │ │ │ +00000c40: 2064 6973 7420 486f 6f6b 2c20 2055 703a dist Hook, Up: │ │ │ │ │ +00000c50: 2044 6973 740a 0a31 342e 3420 4368 6563 Dist..14.4 Chec │ │ │ │ │ +00000c60: 6b69 6e67 2074 6865 2044 6973 7472 6962 king the Distrib │ │ │ │ │ +00000c70: 7574 696f 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d ution.========== │ │ │ │ │ 00000c80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00000c90: 3d3d 3d0a 0a41 7574 6f6d 616b 6520 616c ===..Automake al │ │ │ │ │ -00000ca0: 736f 2067 656e 6572 6174 6573 2061 2027 so generates a ' │ │ │ │ │ -00000cb0: 6469 7374 6368 6563 6b27 2072 756c 6520 distcheck' rule │ │ │ │ │ -00000cc0: 7468 6174 2063 616e 2062 6520 6f66 2068 that can be of h │ │ │ │ │ -00000cd0: 656c 7020 746f 2065 6e73 7572 650a 7468 elp to ensure.th │ │ │ │ │ -00000ce0: 6174 2061 2067 6976 656e 2064 6973 7472 at a given distr │ │ │ │ │ -00000cf0: 6962 7574 696f 6e20 7769 6c6c 2061 6374 ibution will act │ │ │ │ │ -00000d00: 7561 6c6c 7920 776f 726b 2e20 2027 6469 ually work. 'di │ │ │ │ │ -00000d10: 7374 6368 6563 6b27 206d 616b 6573 2061 stcheck' makes a │ │ │ │ │ -00000d20: 0a64 6973 7472 6962 7574 696f 6e2c 2074 .distribution, t │ │ │ │ │ -00000d30: 6865 6e20 7472 6965 7320 746f 2064 6f20 hen tries to do │ │ │ │ │ -00000d40: 6120 2756 5041 5448 2720 6275 696c 6420 a 'VPATH' build │ │ │ │ │ -00000d50: 282a 6e6f 7465 2056 5041 5448 2042 7569 (*note VPATH Bui │ │ │ │ │ -00000d60: 6c64 733a 3a29 2c0a 7275 6e20 7468 6520 lds::),.run the │ │ │ │ │ -00000d70: 7465 7374 2073 7569 7465 2c20 616e 6420 test suite, and │ │ │ │ │ -00000d80: 6669 6e61 6c6c 7920 6d61 6b65 2061 6e6f finally make ano │ │ │ │ │ -00000d90: 7468 6572 2074 6172 6261 6c6c 2074 6f20 ther tarball to │ │ │ │ │ -00000da0: 656e 7375 7265 2074 6865 0a64 6973 7472 ensure the.distr │ │ │ │ │ -00000db0: 6962 7574 696f 6e20 6973 2073 656c 662d ibution is self- │ │ │ │ │ -00000dc0: 636f 6e74 6169 6e65 642e 0a0a 2020 2042 contained... B │ │ │ │ │ -00000dd0: 7569 6c64 696e 6720 7468 6520 7061 636b uilding the pack │ │ │ │ │ -00000de0: 6167 6520 696e 766f 6c76 6573 2072 756e age involves run │ │ │ │ │ -00000df0: 6e69 6e67 2027 2e2f 636f 6e66 6967 7572 ning './configur │ │ │ │ │ -00000e00: 6527 2e20 2049 6620 796f 7520 6e65 6564 e'. If you need │ │ │ │ │ -00000e10: 2074 6f0a 7375 7070 6c79 2061 6464 6974 to.supply addit │ │ │ │ │ -00000e20: 696f 6e61 6c20 666c 6167 7320 746f 2027 ional flags to ' │ │ │ │ │ -00000e30: 636f 6e66 6967 7572 6527 2c20 6465 6669 configure', defi │ │ │ │ │ -00000e40: 6e65 2074 6865 6d20 696e 2074 6865 0a27 ne them in the.' │ │ │ │ │ -00000e50: 414d 5f44 4953 5443 4845 434b 5f43 4f4e AM_DISTCHECK_CON │ │ │ │ │ -00000e60: 4649 4755 5245 5f46 4c41 4753 2720 7661 FIGURE_FLAGS' va │ │ │ │ │ -00000e70: 7269 6162 6c65 2069 6e20 796f 7572 2074 riable in your t │ │ │ │ │ -00000e80: 6f70 2d6c 6576 656c 2027 4d61 6b65 6669 op-level 'Makefi │ │ │ │ │ -00000e90: 6c65 2e61 6d27 2e0a 5468 6520 7573 6572 le.am'..The user │ │ │ │ │ -00000ea0: 2063 616e 2073 7469 6c6c 2065 7874 656e can still exten │ │ │ │ │ -00000eb0: 6420 6f72 206f 7665 7272 6964 6520 7468 d or override th │ │ │ │ │ -00000ec0: 6520 666c 6167 7320 7072 6f76 6964 6564 e flags provided │ │ │ │ │ -00000ed0: 2074 6865 7265 2062 790a 6465 6669 6e69 there by.defini │ │ │ │ │ -00000ee0: 6e67 2074 6865 2027 4449 5354 4348 4543 ng the 'DISTCHEC │ │ │ │ │ -00000ef0: 4b5f 434f 4e46 4947 5552 455f 464c 4147 K_CONFIGURE_FLAG │ │ │ │ │ -00000f00: 5327 2076 6172 6961 626c 652c 206f 6e20 S' variable, on │ │ │ │ │ -00000f10: 7468 6520 636f 6d6d 616e 6420 6c69 6e65 the command line │ │ │ │ │ -00000f20: 0a77 6865 6e20 696e 766f 6b69 6e67 2027 .when invoking ' │ │ │ │ │ -00000f30: 6d61 6b65 272e 0a0a 2020 2053 7469 6c6c make'... Still │ │ │ │ │ -00000f40: 2c20 6465 7665 6c6f 7065 7273 2061 7265 , developers are │ │ │ │ │ -00000f50: 2065 6e63 6f75 7261 6765 6420 746f 2073 encouraged to s │ │ │ │ │ -00000f60: 7472 6976 6520 746f 206d 616b 6520 7468 trive to make th │ │ │ │ │ -00000f70: 6569 7220 636f 6465 0a62 7569 6c64 6162 eir code.buildab │ │ │ │ │ -00000f80: 6c65 2077 6974 686f 7574 2072 6571 7569 le without requi │ │ │ │ │ -00000f90: 7269 6e67 2061 6e79 2073 7065 6369 616c ring any special │ │ │ │ │ -00000fa0: 2063 6f6e 6669 6775 7265 206f 7074 696f configure optio │ │ │ │ │ -00000fb0: 6e3b 2074 6875 732c 2069 6e0a 6765 6e65 n; thus, in.gene │ │ │ │ │ -00000fc0: 7261 6c2c 2079 6f75 2073 686f 756c 646e ral, you shouldn │ │ │ │ │ -00000fd0: 2774 2064 6566 696e 6520 2741 4d5f 4449 't define 'AM_DI │ │ │ │ │ -00000fe0: 5354 4348 4543 4b5f 434f 4e46 4947 5552 STCHECK_CONFIGUR │ │ │ │ │ -00000ff0: 455f 464c 4147 5327 2e20 2048 6f77 6576 E_FLAGS'. Howev │ │ │ │ │ -00001000: 6572 2c0a 7468 6572 6520 6d69 6768 7420 er,.there might │ │ │ │ │ -00001010: 6265 2066 6577 2073 6365 6e61 7269 6f73 be few scenarios │ │ │ │ │ -00001020: 2069 6e20 7768 6963 6820 7468 6520 7573 in which the us │ │ │ │ │ -00001030: 6520 6f66 2074 6869 7320 7661 7269 6162 e of this variab │ │ │ │ │ -00001040: 6c65 2069 730a 6a75 7374 6966 6965 642e le is.justified. │ │ │ │ │ -00001050: 2020 474e 5520 276d 3427 206f 6666 6572 GNU 'm4' offer │ │ │ │ │ -00001060: 7320 616e 2065 7861 6d70 6c65 2e20 2047 s an example. G │ │ │ │ │ -00001070: 4e55 2027 6d34 2720 636f 6e66 6967 7572 NU 'm4' configur │ │ │ │ │ -00001080: 6573 2062 7920 6465 6661 756c 740a 7769 es by default.wi │ │ │ │ │ -00001090: 7468 2069 7473 2065 7870 6572 696d 656e th its experimen │ │ │ │ │ -000010a0: 7461 6c20 616e 6420 7365 6c64 6f6d 2075 tal and seldom u │ │ │ │ │ -000010b0: 7365 6420 2263 6861 6e67 6577 6f72 6422 sed "changeword" │ │ │ │ │ -000010c0: 2066 6561 7475 7265 2064 6973 6162 6c65 feature disable │ │ │ │ │ -000010d0: 643b 2073 6f0a 696e 2069 7473 2063 6173 d; so.in its cas │ │ │ │ │ -000010e0: 6520 6974 2069 7320 7573 6566 756c 2074 e it is useful t │ │ │ │ │ -000010f0: 6f20 6861 7665 2027 6d61 6b65 2064 6973 o have 'make dis │ │ │ │ │ -00001100: 7463 6865 636b 2720 7275 6e20 636f 6e66 tcheck' run conf │ │ │ │ │ -00001110: 6967 7572 6520 7769 7468 2074 6865 0a27 igure with the.' │ │ │ │ │ -00001120: 2d2d 7769 7468 2d63 6861 6e67 6577 6f72 --with-changewor │ │ │ │ │ -00001130: 6427 206f 7074 696f 6e2c 2074 6f20 656e d' option, to en │ │ │ │ │ -00001140: 7375 7265 2074 6861 7420 7468 6520 636f sure that the co │ │ │ │ │ -00001150: 6465 2066 6f72 2063 6861 6e67 6577 6f72 de for changewor │ │ │ │ │ -00001160: 640a 7375 7070 6f72 7420 7374 696c 6c20 d.support still │ │ │ │ │ -00001170: 636f 6d70 696c 6573 2063 6f72 7265 6374 compiles correct │ │ │ │ │ -00001180: 6c79 2e20 2047 4e55 2027 6d34 2720 616c ly. GNU 'm4' al │ │ │ │ │ -00001190: 736f 2065 6d70 6c6f 7973 2074 6865 0a27 so employs the.' │ │ │ │ │ -000011a0: 414d 5f44 4953 5443 4845 434b 5f43 4f4e AM_DISTCHECK_CON │ │ │ │ │ -000011b0: 4649 4755 5245 5f46 4c41 4753 2720 7661 FIGURE_FLAGS' va │ │ │ │ │ -000011c0: 7269 6162 6c65 2074 6f20 7374 7265 7373 riable to stress │ │ │ │ │ -000011d0: 2d74 6573 7420 7468 6520 7573 6520 6f66 -test the use of │ │ │ │ │ -000011e0: 0a27 2d2d 7072 6f67 7261 6d2d 7072 6566 .'--program-pref │ │ │ │ │ -000011f0: 6978 3d67 272c 2073 696e 6365 2061 7420 ix=g', since at │ │ │ │ │ -00001200: 6f6e 6520 706f 696e 7420 7468 6520 276d one point the 'm │ │ │ │ │ -00001210: 3427 2062 7569 6c64 2073 7973 7465 6d20 4' build system │ │ │ │ │ -00001220: 6861 6420 6120 6275 670a 7768 6572 6520 had a bug.where │ │ │ │ │ -00001230: 276d 616b 6520 696e 7374 616c 6c63 6865 'make installche │ │ │ │ │ -00001240: 636b 2720 7761 7320 7772 6f6e 676c 7920 ck' was wrongly │ │ │ │ │ -00001250: 6173 7375 6d69 6e67 2069 7420 636f 756c assuming it coul │ │ │ │ │ -00001260: 6420 626c 696e 646c 7920 7465 7374 0a22 d blindly test." │ │ │ │ │ -00001270: 276d 3427 222c 2072 6174 6865 7220 7468 'm4'", rather th │ │ │ │ │ -00001280: 616e 2074 6865 206a 7573 742d 696e 7374 an the just-inst │ │ │ │ │ -00001290: 616c 6c65 6420 2227 676d 3427 222e 0a0a alled "'gm4'"... │ │ │ │ │ -000012a0: 2020 2049 6620 7468 6520 2764 6973 7463 If the 'distc │ │ │ │ │ -000012b0: 6865 636b 2d68 6f6f 6b27 2072 756c 6520 heck-hook' rule │ │ │ │ │ -000012c0: 6973 2064 6566 696e 6564 2069 6e20 796f is defined in yo │ │ │ │ │ -000012d0: 7572 2074 6f70 2d6c 6576 656c 0a27 4d61 ur top-level.'Ma │ │ │ │ │ -000012e0: 6b65 6669 6c65 2e61 6d27 2c20 7468 656e kefile.am', then │ │ │ │ │ -000012f0: 2069 7420 7769 6c6c 2062 6520 696e 766f it will be invo │ │ │ │ │ -00001300: 6b65 6420 6279 2027 6469 7374 6368 6563 ked by 'distchec │ │ │ │ │ -00001310: 6b27 2061 6674 6572 2074 6865 206e 6577 k' after the new │ │ │ │ │ -00001320: 0a64 6973 7472 6962 7574 696f 6e20 6861 .distribution ha │ │ │ │ │ -00001330: 7320 6265 656e 2075 6e70 6163 6b65 642c s been unpacked, │ │ │ │ │ -00001340: 2062 7574 2062 6566 6f72 6520 7468 6520 but before the │ │ │ │ │ -00001350: 756e 7061 636b 6564 2063 6f70 7920 6973 unpacked copy is │ │ │ │ │ -00001360: 0a63 6f6e 6669 6775 7265 6420 616e 6420 .configured and │ │ │ │ │ -00001370: 6275 696c 742e 2020 596f 7572 2027 6469 built. Your 'di │ │ │ │ │ -00001380: 7374 6368 6563 6b2d 686f 6f6b 2720 6361 stcheck-hook' ca │ │ │ │ │ -00001390: 6e20 646f 2061 6c6d 6f73 7420 616e 7974 n do almost anyt │ │ │ │ │ -000013a0: 6869 6e67 2c0a 7468 6f75 6768 2061 7320 hing,.though as │ │ │ │ │ -000013b0: 616c 7761 7973 2063 6175 7469 6f6e 2069 always caution i │ │ │ │ │ -000013c0: 7320 6164 7669 7365 642e 2020 4765 6e65 s advised. Gene │ │ │ │ │ -000013d0: 7261 6c6c 7920 7468 6973 2068 6f6f 6b20 rally this hook │ │ │ │ │ -000013e0: 6973 2075 7365 6420 746f 0a63 6865 636b is used to.check │ │ │ │ │ -000013f0: 2066 6f72 2070 6f74 656e 7469 616c 2064 for potential d │ │ │ │ │ -00001400: 6973 7472 6962 7574 696f 6e20 6572 726f istribution erro │ │ │ │ │ -00001410: 7273 206e 6f74 2063 6175 6768 7420 6279 rs not caught by │ │ │ │ │ -00001420: 2074 6865 2073 7461 6e64 6172 640a 6d65 the standard.me │ │ │ │ │ -00001430: 6368 616e 6973 6d2e 2020 4e6f 7465 2074 chanism. Note t │ │ │ │ │ -00001440: 6861 7420 2764 6973 7463 6865 636b 2d68 hat 'distcheck-h │ │ │ │ │ -00001450: 6f6f 6b27 2061 7320 7765 6c6c 2061 730a ook' as well as. │ │ │ │ │ -00001460: 2741 4d5f 4449 5354 4348 4543 4b5f 434f 'AM_DISTCHECK_CO │ │ │ │ │ -00001470: 4e46 4947 5552 455f 464c 4147 5327 2061 NFIGURE_FLAGS' a │ │ │ │ │ -00001480: 6e64 2027 4449 5354 4348 4543 4b5f 434f nd 'DISTCHECK_CO │ │ │ │ │ -00001490: 4e46 4947 5552 455f 464c 4147 5327 2061 NFIGURE_FLAGS' a │ │ │ │ │ -000014a0: 7265 206e 6f74 0a68 6f6e 6f72 6564 2069 re not.honored i │ │ │ │ │ -000014b0: 6e20 6120 7375 6270 6163 6b61 6765 2027 n a subpackage ' │ │ │ │ │ -000014c0: 4d61 6b65 6669 6c65 2e61 6d27 2c20 6275 Makefile.am', bu │ │ │ │ │ -000014d0: 7420 7468 6520 666c 6167 7320 6672 6f6d t the flags from │ │ │ │ │ -000014e0: 0a27 414d 5f44 4953 5443 4845 434b 5f43 .'AM_DISTCHECK_C │ │ │ │ │ -000014f0: 4f4e 4649 4755 5245 5f46 4c41 4753 2720 ONFIGURE_FLAGS' │ │ │ │ │ -00001500: 616e 6420 2744 4953 5443 4845 434b 5f43 and 'DISTCHECK_C │ │ │ │ │ -00001510: 4f4e 4649 4755 5245 5f46 4c41 4753 2720 ONFIGURE_FLAGS' │ │ │ │ │ -00001520: 6172 650a 7061 7373 6564 2064 6f77 6e20 are.passed down │ │ │ │ │ -00001530: 746f 2074 6865 2027 636f 6e66 6967 7572 to the 'configur │ │ │ │ │ -00001540: 6527 2073 6372 6970 7420 6f66 2074 6865 e' script of the │ │ │ │ │ -00001550: 2073 7562 7061 636b 6167 652e 0a0a 2020 subpackage... │ │ │ │ │ -00001560: 2053 7065 616b 696e 6720 6f66 2070 6f74 Speaking of pot │ │ │ │ │ -00001570: 656e 7469 616c 2064 6973 7472 6962 7574 ential distribut │ │ │ │ │ -00001580: 696f 6e20 6572 726f 7273 2c20 2764 6973 ion errors, 'dis │ │ │ │ │ -00001590: 7463 6865 636b 2720 616c 736f 2065 6e73 tcheck' also ens │ │ │ │ │ -000015a0: 7572 6573 0a74 6861 7420 7468 6520 2764 ures.that the 'd │ │ │ │ │ -000015b0: 6973 7463 6c65 616e 2720 7275 6c65 2061 istclean' rule a │ │ │ │ │ -000015c0: 6374 7561 6c6c 7920 7265 6d6f 7665 7320 ctually removes │ │ │ │ │ -000015d0: 616c 6c20 6275 696c 7420 6669 6c65 732e all built files. │ │ │ │ │ -000015e0: 2020 5468 6973 2069 730a 646f 6e65 2062 This is.done b │ │ │ │ │ -000015f0: 7920 7275 6e6e 696e 6720 276d 616b 6520 y running 'make │ │ │ │ │ -00001600: 6469 7374 636c 6561 6e63 6865 636b 2720 distcleancheck' │ │ │ │ │ -00001610: 6174 2074 6865 2065 6e64 206f 6620 7468 at the end of th │ │ │ │ │ -00001620: 6520 2756 5041 5448 2720 6275 696c 642e e 'VPATH' build. │ │ │ │ │ -00001630: 0a42 7920 6465 6661 756c 742c 2027 6469 .By default, 'di │ │ │ │ │ -00001640: 7374 636c 6561 6e63 6865 636b 2720 7769 stcleancheck' wi │ │ │ │ │ -00001650: 6c6c 2072 756e 2027 6469 7374 636c 6561 ll run 'distclea │ │ │ │ │ -00001660: 6e27 2061 6e64 2074 6865 6e20 6d61 6b65 n' and then make │ │ │ │ │ -00001670: 2073 7572 6520 7468 650a 6275 696c 6420 sure the.build │ │ │ │ │ -00001680: 7472 6565 2068 6173 2062 6565 6e20 656d tree has been em │ │ │ │ │ -00001690: 7074 6965 6420 6279 2072 756e 6e69 6e67 ptied by running │ │ │ │ │ -000016a0: 2027 2428 6469 7374 636c 6561 6e63 6865 '$(distcleanche │ │ │ │ │ -000016b0: 636b 5f6c 6973 7466 696c 6573 2927 2e0a ck_listfiles)'.. │ │ │ │ │ -000016c0: 5573 7561 6c6c 7920 7468 6973 2063 6865 Usually this che │ │ │ │ │ -000016d0: 636b 2077 696c 6c20 6669 6e64 2067 656e ck will find gen │ │ │ │ │ -000016e0: 6572 6174 6564 2066 696c 6573 2074 6861 erated files tha │ │ │ │ │ -000016f0: 7420 796f 7520 666f 7267 6f74 2074 6f20 t you forgot to │ │ │ │ │ -00001700: 6164 6420 746f 0a74 6865 2027 4449 5354 add to.the 'DIST │ │ │ │ │ -00001710: 434c 4541 4e46 494c 4553 2720 7661 7269 CLEANFILES' vari │ │ │ │ │ -00001720: 6162 6c65 2028 2a6e 6f74 6520 436c 6561 able (*note Clea │ │ │ │ │ -00001730: 6e3a 3a29 2e0a 0a20 2020 5468 6520 2764 n::)... The 'd │ │ │ │ │ -00001740: 6973 7463 6c65 616e 6368 6563 6b27 2062 istcleancheck' b │ │ │ │ │ -00001750: 6568 6176 696f 7220 7368 6f75 6c64 2062 ehavior should b │ │ │ │ │ -00001760: 6520 4f4b 2066 6f72 206d 6f73 7420 7061 e OK for most pa │ │ │ │ │ -00001770: 636b 6167 6573 2c0a 6f74 6865 7277 6973 ckages,.otherwis │ │ │ │ │ -00001780: 6520 796f 7520 6861 7665 2074 6865 2070 e you have the p │ │ │ │ │ -00001790: 6f73 7369 6269 6c69 7479 2074 6f20 6f76 ossibility to ov │ │ │ │ │ -000017a0: 6572 7269 6465 2074 6865 2064 6566 696e erride the defin │ │ │ │ │ -000017b0: 6974 696f 6e20 6f66 2065 6974 6865 720a ition of either. │ │ │ │ │ -000017c0: 7468 6520 2764 6973 7463 6c65 616e 6368 the 'distcleanch │ │ │ │ │ -000017d0: 6563 6b27 2072 756c 652c 206f 7220 7468 eck' rule, or th │ │ │ │ │ -000017e0: 6520 2724 2864 6973 7463 6c65 616e 6368 e '$(distcleanch │ │ │ │ │ -000017f0: 6563 6b5f 6c69 7374 6669 6c65 7329 270a eck_listfiles)'. │ │ │ │ │ -00001800: 7661 7269 6162 6c65 2e20 2046 6f72 2069 variable. For i │ │ │ │ │ -00001810: 6e73 7461 6e63 652c 2074 6f20 6469 7361 nstance, to disa │ │ │ │ │ -00001820: 626c 6520 2764 6973 7463 6c65 616e 6368 ble 'distcleanch │ │ │ │ │ -00001830: 6563 6b27 2063 6f6d 706c 6574 656c 792c eck' completely, │ │ │ │ │ -00001840: 2061 6464 2074 6865 0a66 6f6c 6c6f 7769 add the.followi │ │ │ │ │ -00001850: 6e67 2072 756c 6520 746f 2079 6f75 7220 ng rule to your │ │ │ │ │ -00001860: 746f 702d 6c65 7665 6c20 274d 616b 6566 top-level 'Makef │ │ │ │ │ -00001870: 696c 652e 616d 273a 0a0a 2020 2020 2064 ile.am':.. d │ │ │ │ │ -00001880: 6973 7463 6c65 616e 6368 6563 6b3a 0a20 istcleancheck:. │ │ │ │ │ -00001890: 2020 2020 2020 2020 2020 2020 403a 0a0a @:.. │ │ │ │ │ -000018a0: 2020 2049 6620 796f 7520 7761 6e74 2027 If you want ' │ │ │ │ │ -000018b0: 6469 7374 636c 6561 6e63 6865 636b 2720 distcleancheck' │ │ │ │ │ -000018c0: 746f 2069 676e 6f72 6520 6275 696c 7420 to ignore built │ │ │ │ │ -000018d0: 6669 6c65 7320 7468 6174 2068 6176 6520 files that have │ │ │ │ │ -000018e0: 6e6f 7420 6265 656e 0a63 6c65 616e 6564 not been.cleaned │ │ │ │ │ -000018f0: 2062 6563 6175 7365 2074 6865 7920 6172 because they ar │ │ │ │ │ -00001900: 6520 616c 736f 2070 6172 7420 6f66 2074 e also part of t │ │ │ │ │ -00001910: 6865 2064 6973 7472 6962 7574 696f 6e2c he distribution, │ │ │ │ │ -00001920: 2061 6464 2074 6865 0a66 6f6c 6c6f 7769 add the.followi │ │ │ │ │ -00001930: 6e67 2064 6566 696e 6974 696f 6e20 696e ng definition in │ │ │ │ │ -00001940: 7374 6561 643a 0a0a 2020 2020 2064 6973 stead:.. dis │ │ │ │ │ -00001950: 7463 6c65 616e 6368 6563 6b5f 6c69 7374 tcleancheck_list │ │ │ │ │ -00001960: 6669 6c65 7320 3d20 5c0a 2020 2020 2020 files = \. │ │ │ │ │ -00001970: 2066 696e 6420 2e20 2d74 7970 6520 6620 find . -type f │ │ │ │ │ -00001980: 2d65 7865 6320 7368 202d 6320 2774 6573 -exec sh -c 'tes │ │ │ │ │ -00001990: 7420 2d66 2024 2873 7263 6469 7229 2f24 t -f $(srcdir)/$ │ │ │ │ │ -000019a0: 2431 207c 7c20 6563 686f 2024 2431 2720 $1 || echo $$1' │ │ │ │ │ -000019b0: 5c0a 2020 2020 2020 2020 2020 2020 7368 \. sh │ │ │ │ │ -000019c0: 2027 7b7d 2720 273b 270a 0a20 2020 5468 '{}' ';'.. Th │ │ │ │ │ -000019d0: 6520 6162 6f76 6520 6465 6669 6e69 7469 e above definiti │ │ │ │ │ -000019e0: 6f6e 2069 7320 6e6f 7420 7468 6520 6465 on is not the de │ │ │ │ │ -000019f0: 6661 756c 7420 6265 6361 7573 6520 6974 fault because it │ │ │ │ │ -00001a00: 2773 2075 7375 616c 6c79 2061 6e20 6572 's usually an er │ │ │ │ │ -00001a10: 726f 720a 6966 2079 6f75 7220 4d61 6b65 ror.if your Make │ │ │ │ │ -00001a20: 6669 6c65 7320 6361 7573 6520 736f 6d65 files cause some │ │ │ │ │ -00001a30: 2064 6973 7472 6962 7574 6564 2066 696c distributed fil │ │ │ │ │ -00001a40: 6573 2074 6f20 6265 2072 6562 7569 6c74 es to be rebuilt │ │ │ │ │ -00001a50: 2077 6865 6e20 7468 650a 7573 6572 2062 when the.user b │ │ │ │ │ -00001a60: 7569 6c64 2074 6865 2070 6163 6b61 6765 uild the package │ │ │ │ │ -00001a70: 2e20 2028 5468 696e 6b20 6162 6f75 7420 . (Think about │ │ │ │ │ -00001a80: 7468 6520 7573 6572 206d 6973 7369 6e67 the user missing │ │ │ │ │ -00001a90: 2074 6865 2074 6f6f 6c20 7265 7175 6972 the tool requir │ │ │ │ │ -00001aa0: 6564 0a74 6f20 6275 696c 6420 7468 6520 ed.to build the │ │ │ │ │ -00001ab0: 6669 6c65 3b20 6f72 2069 6620 7468 6520 file; or if the │ │ │ │ │ -00001ac0: 7265 7175 6972 6564 2074 6f6f 6c20 6973 required tool is │ │ │ │ │ -00001ad0: 2062 7569 6c74 2062 7920 796f 7572 2070 built by your p │ │ │ │ │ -00001ae0: 6163 6b61 6765 2c0a 636f 6e73 6964 6572 ackage,.consider │ │ │ │ │ -00001af0: 2074 6865 2063 726f 7373 2d63 6f6d 7069 the cross-compi │ │ │ │ │ -00001b00: 6c61 7469 6f6e 2063 6173 6520 7768 6572 lation case wher │ │ │ │ │ -00001b10: 6520 6974 2063 616e 2774 2062 6520 7275 e it can't be ru │ │ │ │ │ -00001b20: 6e2e 2920 2054 6865 7265 2069 7320 616e n.) There is an │ │ │ │ │ -00001b30: 0a65 6e74 7279 2069 6e20 7468 6520 4641 .entry in the FA │ │ │ │ │ -00001b40: 5120 6162 6f75 7420 7468 6973 2028 2a6e Q about this (*n │ │ │ │ │ -00001b50: 6f74 6520 6469 7374 636c 6561 6e63 6865 ote distcleanche │ │ │ │ │ -00001b60: 636b 3a3a 292c 206d 616b 6520 7375 7265 ck::), make sure │ │ │ │ │ -00001b70: 2079 6f75 2072 6561 640a 6974 2062 6566 you read.it bef │ │ │ │ │ -00001b80: 6f72 6520 706c 6179 696e 6720 7769 7468 ore playing with │ │ │ │ │ -00001b90: 2027 6469 7374 636c 6561 6e63 6865 636b 'distcleancheck │ │ │ │ │ -00001ba0: 5f6c 6973 7466 696c 6573 272e 0a0a 2020 _listfiles'... │ │ │ │ │ -00001bb0: 2027 6469 7374 6368 6563 6b27 2061 6c73 'distcheck' als │ │ │ │ │ -00001bc0: 6f20 6368 6563 6b73 2074 6861 7420 7468 o checks that th │ │ │ │ │ -00001bd0: 6520 2775 6e69 6e73 7461 6c6c 2720 7275 e 'uninstall' ru │ │ │ │ │ -00001be0: 6c65 2077 6f72 6b73 2070 726f 7065 726c le works properl │ │ │ │ │ -00001bf0: 792c 0a62 6f74 6820 666f 7220 6f72 6469 y,.both for ordi │ │ │ │ │ -00001c00: 6e61 7279 2061 6e64 2027 4445 5354 4449 nary and 'DESTDI │ │ │ │ │ -00001c10: 5227 2062 7569 6c64 732e 2020 4974 2064 R' builds. It d │ │ │ │ │ -00001c20: 6f65 7320 7468 6973 2062 7920 696e 766f oes this by invo │ │ │ │ │ -00001c30: 6b69 6e67 2027 6d61 6b65 0a75 6e69 6e73 king 'make.unins │ │ │ │ │ -00001c40: 7461 6c6c 272c 2061 6e64 2074 6865 6e20 tall', and then │ │ │ │ │ -00001c50: 6974 2063 6865 636b 7320 7468 6520 696e it checks the in │ │ │ │ │ -00001c60: 7374 616c 6c20 7472 6565 2074 6f20 7365 stall tree to se │ │ │ │ │ -00001c70: 6520 6966 2061 6e79 2066 696c 6573 2061 e if any files a │ │ │ │ │ -00001c80: 7265 0a6c 6566 7420 6f76 6572 2e20 2054 re.left over. T │ │ │ │ │ -00001c90: 6869 7320 6368 6563 6b20 7769 6c6c 206d his check will m │ │ │ │ │ -00001ca0: 616b 6520 7375 7265 2074 6861 7420 796f ake sure that yo │ │ │ │ │ -00001cb0: 7520 636f 7272 6563 746c 7920 636f 6465 u correctly code │ │ │ │ │ -00001cc0: 6420 796f 7572 0a27 756e 696e 7374 616c d your.'uninstal │ │ │ │ │ -00001cd0: 6c27 2d72 656c 6174 6564 2072 756c 6573 l'-related rules │ │ │ │ │ -00001ce0: 2e0a 0a20 2020 4279 2064 6566 6175 6c74 ... By default │ │ │ │ │ -00001cf0: 2c20 7468 6520 6368 6563 6b69 6e67 2069 , the checking i │ │ │ │ │ -00001d00: 7320 646f 6e65 2062 7920 7468 6520 2764 s done by the 'd │ │ │ │ │ -00001d10: 6973 7475 6e69 6e73 7461 6c6c 6368 6563 istuninstallchec │ │ │ │ │ -00001d20: 6b27 2072 756c 652c 0a61 6e64 2074 6865 k' rule,.and the │ │ │ │ │ -00001d30: 206c 6973 7420 6f66 2066 696c 6573 2069 list of files i │ │ │ │ │ -00001d40: 6e20 7468 6520 696e 7374 616c 6c20 7472 n the install tr │ │ │ │ │ -00001d50: 6565 2069 7320 6765 6e65 7261 7465 6420 ee is generated │ │ │ │ │ -00001d60: 6279 0a27 2428 6469 7374 756e 696e 7374 by.'$(distuninst │ │ │ │ │ -00001d70: 616c 6c63 6865 636b 5f6c 6973 7466 696c allcheck_listfil │ │ │ │ │ -00001d80: 6573 2927 2028 7468 6973 2069 7320 6120 es)' (this is a │ │ │ │ │ -00001d90: 7661 7269 6162 6c65 2077 686f 7365 2076 variable whose v │ │ │ │ │ -00001da0: 616c 7565 2069 7320 610a 7368 656c 6c20 alue is a.shell │ │ │ │ │ -00001db0: 636f 6d6d 616e 6420 746f 2072 756e 2074 command to run t │ │ │ │ │ -00001dc0: 6861 7420 7072 696e 7473 2074 6865 206c hat prints the l │ │ │ │ │ -00001dd0: 6973 7420 6f66 2066 696c 6573 2074 6f20 ist of files to │ │ │ │ │ -00001de0: 7374 646f 7574 292e 0a0a 2020 2045 6974 stdout)... Eit │ │ │ │ │ -00001df0: 6865 7220 6f66 2074 6865 7365 2063 616e her of these can │ │ │ │ │ -00001e00: 2062 6520 6f76 6572 7269 6464 656e 2074 be overridden t │ │ │ │ │ -00001e10: 6f20 6d6f 6469 6679 2074 6865 2062 6568 o modify the beh │ │ │ │ │ -00001e20: 6176 696f 7220 6f66 0a27 6469 7374 6368 avior of.'distch │ │ │ │ │ -00001e30: 6563 6b27 2e20 2046 6f72 2069 6e73 7461 eck'. For insta │ │ │ │ │ -00001e40: 6e63 652c 2074 6f20 6469 7361 626c 6520 nce, to disable │ │ │ │ │ -00001e50: 7468 6973 2063 6865 636b 2063 6f6d 706c this check compl │ │ │ │ │ -00001e60: 6574 656c 792c 2079 6f75 2077 6f75 6c64 etely, you would │ │ │ │ │ -00001e70: 0a77 7269 7465 3a0a 0a20 2020 2020 6469 .write:.. di │ │ │ │ │ -00001e80: 7374 756e 696e 7374 616c 6c63 6865 636b stuninstallcheck │ │ │ │ │ -00001e90: 3a0a 2020 2020 2020 2020 2020 2020 2040 :. @ │ │ │ │ │ -00001ea0: 3a0a 0a1f 0a46 696c 653a 2061 7574 6f6d :....File: autom │ │ │ │ │ -00001eb0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -00001ec0: 4e6f 6465 3a20 5468 6520 5479 7065 7320 Node: The Types │ │ │ │ │ -00001ed0: 6f66 2044 6973 7472 6962 7574 696f 6e73 of Distributions │ │ │ │ │ -00001ee0: 2c20 2050 7265 763a 2043 6865 636b 696e , Prev: Checkin │ │ │ │ │ -00001ef0: 6720 7468 6520 4469 7374 7269 6275 7469 g the Distributi │ │ │ │ │ -00001f00: 6f6e 2c20 2055 703a 2044 6973 740a 0a31 on, Up: Dist..1 │ │ │ │ │ -00001f10: 342e 3520 5468 6520 5479 7065 7320 6f66 4.5 The Types of │ │ │ │ │ -00001f20: 2044 6973 7472 6962 7574 696f 6e73 0a3d Distributions.= │ │ │ │ │ +00000c90: 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 2061 ====..Automake a │ │ │ │ │ +00000ca0: 6c73 6f20 6765 6e65 7261 7465 7320 6120 lso generates a │ │ │ │ │ +00000cb0: 2764 6973 7463 6865 636b 2720 7275 6c65 'distcheck' rule │ │ │ │ │ +00000cc0: 2074 6861 7420 6361 6e20 6265 206f 6620 that can be of │ │ │ │ │ +00000cd0: 6865 6c70 2074 6f20 656e 7375 7265 0a74 help to ensure.t │ │ │ │ │ +00000ce0: 6861 7420 6120 6769 7665 6e20 6469 7374 hat a given dist │ │ │ │ │ +00000cf0: 7269 6275 7469 6f6e 2077 696c 6c20 6163 ribution will ac │ │ │ │ │ +00000d00: 7475 616c 6c79 2077 6f72 6b2e 2020 2764 tually work. 'd │ │ │ │ │ +00000d10: 6973 7463 6865 636b 2720 6d61 6b65 7320 istcheck' makes │ │ │ │ │ +00000d20: 610a 6469 7374 7269 6275 7469 6f6e 2c20 a.distribution, │ │ │ │ │ +00000d30: 7468 656e 2074 7269 6573 2074 6f20 646f then tries to do │ │ │ │ │ +00000d40: 2061 2027 5650 4154 4827 2062 7569 6c64 a 'VPATH' build │ │ │ │ │ +00000d50: 2028 2a6e 6f74 6520 5650 4154 4820 4275 (*note VPATH Bu │ │ │ │ │ +00000d60: 696c 6473 3a3a 292c 0a72 756e 2074 6865 ilds::),.run the │ │ │ │ │ +00000d70: 2074 6573 7420 7375 6974 652c 2061 6e64 test suite, and │ │ │ │ │ +00000d80: 2066 696e 616c 6c79 206d 616b 6520 616e finally make an │ │ │ │ │ +00000d90: 6f74 6865 7220 7461 7262 616c 6c20 746f other tarball to │ │ │ │ │ +00000da0: 2065 6e73 7572 6520 7468 650a 6469 7374 ensure the.dist │ │ │ │ │ +00000db0: 7269 6275 7469 6f6e 2069 7320 7365 6c66 ribution is self │ │ │ │ │ +00000dc0: 2d63 6f6e 7461 696e 6564 2e0a 0a20 2020 -contained... │ │ │ │ │ +00000dd0: 4275 696c 6469 6e67 2074 6865 2070 6163 Building the pac │ │ │ │ │ +00000de0: 6b61 6765 2069 6e76 6f6c 7665 7320 7275 kage involves ru │ │ │ │ │ +00000df0: 6e6e 696e 6720 272e 2f63 6f6e 6669 6775 nning './configu │ │ │ │ │ +00000e00: 7265 272e 2020 4966 2079 6f75 206e 6565 re'. If you nee │ │ │ │ │ +00000e10: 6420 746f 0a73 7570 706c 7920 6164 6469 d to.supply addi │ │ │ │ │ +00000e20: 7469 6f6e 616c 2066 6c61 6773 2074 6f20 tional flags to │ │ │ │ │ +00000e30: 2763 6f6e 6669 6775 7265 272c 2064 6566 'configure', def │ │ │ │ │ +00000e40: 696e 6520 7468 656d 2069 6e20 7468 650a ine them in the. │ │ │ │ │ +00000e50: 2741 4d5f 4449 5354 4348 4543 4b5f 434f 'AM_DISTCHECK_CO │ │ │ │ │ +00000e60: 4e46 4947 5552 455f 464c 4147 5327 2076 NFIGURE_FLAGS' v │ │ │ │ │ +00000e70: 6172 6961 626c 6520 696e 2079 6f75 7220 ariable in your │ │ │ │ │ +00000e80: 746f 702d 6c65 7665 6c20 274d 616b 6566 top-level 'Makef │ │ │ │ │ +00000e90: 696c 652e 616d 272e 0a54 6865 2075 7365 ile.am'..The use │ │ │ │ │ +00000ea0: 7220 6361 6e20 7374 696c 6c20 6578 7465 r can still exte │ │ │ │ │ +00000eb0: 6e64 206f 7220 6f76 6572 7269 6465 2074 nd or override t │ │ │ │ │ +00000ec0: 6865 2066 6c61 6773 2070 726f 7669 6465 he flags provide │ │ │ │ │ +00000ed0: 6420 7468 6572 6520 6279 0a64 6566 696e d there by.defin │ │ │ │ │ +00000ee0: 696e 6720 7468 6520 2744 4953 5443 4845 ing the 'DISTCHE │ │ │ │ │ +00000ef0: 434b 5f43 4f4e 4649 4755 5245 5f46 4c41 CK_CONFIGURE_FLA │ │ │ │ │ +00000f00: 4753 2720 7661 7269 6162 6c65 2c20 6f6e GS' variable, on │ │ │ │ │ +00000f10: 2074 6865 2063 6f6d 6d61 6e64 206c 696e the command lin │ │ │ │ │ +00000f20: 650a 7768 656e 2069 6e76 6f6b 696e 6720 e.when invoking │ │ │ │ │ +00000f30: 276d 616b 6527 2e0a 0a20 2020 5374 696c 'make'... Stil │ │ │ │ │ +00000f40: 6c2c 2064 6576 656c 6f70 6572 7320 6172 l, developers ar │ │ │ │ │ +00000f50: 6520 656e 636f 7572 6167 6564 2074 6f20 e encouraged to │ │ │ │ │ +00000f60: 7374 7269 7665 2074 6f20 6d61 6b65 2074 strive to make t │ │ │ │ │ +00000f70: 6865 6972 2063 6f64 650a 6275 696c 6461 heir code.builda │ │ │ │ │ +00000f80: 626c 6520 7769 7468 6f75 7420 7265 7175 ble without requ │ │ │ │ │ +00000f90: 6972 696e 6720 616e 7920 7370 6563 6961 iring any specia │ │ │ │ │ +00000fa0: 6c20 636f 6e66 6967 7572 6520 6f70 7469 l configure opti │ │ │ │ │ +00000fb0: 6f6e 3b20 7468 7573 2c20 696e 0a67 656e on; thus, in.gen │ │ │ │ │ +00000fc0: 6572 616c 2c20 796f 7520 7368 6f75 6c64 eral, you should │ │ │ │ │ +00000fd0: 6e27 7420 6465 6669 6e65 2027 414d 5f44 n't define 'AM_D │ │ │ │ │ +00000fe0: 4953 5443 4845 434b 5f43 4f4e 4649 4755 ISTCHECK_CONFIGU │ │ │ │ │ +00000ff0: 5245 5f46 4c41 4753 272e 2020 486f 7765 RE_FLAGS'. Howe │ │ │ │ │ +00001000: 7665 722c 0a74 6865 7265 206d 6967 6874 ver,.there might │ │ │ │ │ +00001010: 2062 6520 6665 7720 7363 656e 6172 696f be few scenario │ │ │ │ │ +00001020: 7320 696e 2077 6869 6368 2074 6865 2075 s in which the u │ │ │ │ │ +00001030: 7365 206f 6620 7468 6973 2076 6172 6961 se of this varia │ │ │ │ │ +00001040: 626c 6520 6973 0a6a 7573 7469 6669 6564 ble is.justified │ │ │ │ │ +00001050: 2e20 2047 4e55 2027 6d34 2720 6f66 6665 . GNU 'm4' offe │ │ │ │ │ +00001060: 7273 2061 6e20 6578 616d 706c 652e 2020 rs an example. │ │ │ │ │ +00001070: 474e 5520 276d 3427 2063 6f6e 6669 6775 GNU 'm4' configu │ │ │ │ │ +00001080: 7265 7320 6279 2064 6566 6175 6c74 0a77 res by default.w │ │ │ │ │ +00001090: 6974 6820 6974 7320 6578 7065 7269 6d65 ith its experime │ │ │ │ │ +000010a0: 6e74 616c 2061 6e64 2073 656c 646f 6d20 ntal and seldom │ │ │ │ │ +000010b0: 7573 6564 2022 6368 616e 6765 776f 7264 used "changeword │ │ │ │ │ +000010c0: 2220 6665 6174 7572 6520 6469 7361 626c " feature disabl │ │ │ │ │ +000010d0: 6564 3b20 736f 0a69 6e20 6974 7320 6361 ed; so.in its ca │ │ │ │ │ +000010e0: 7365 2069 7420 6973 2075 7365 6675 6c20 se it is useful │ │ │ │ │ +000010f0: 746f 2068 6176 6520 276d 616b 6520 6469 to have 'make di │ │ │ │ │ +00001100: 7374 6368 6563 6b27 2072 756e 2063 6f6e stcheck' run con │ │ │ │ │ +00001110: 6669 6775 7265 2077 6974 6820 7468 650a figure with the. │ │ │ │ │ +00001120: 272d 2d77 6974 682d 6368 616e 6765 776f '--with-changewo │ │ │ │ │ +00001130: 7264 2720 6f70 7469 6f6e 2c20 746f 2065 rd' option, to e │ │ │ │ │ +00001140: 6e73 7572 6520 7468 6174 2074 6865 2063 nsure that the c │ │ │ │ │ +00001150: 6f64 6520 666f 7220 6368 616e 6765 776f ode for changewo │ │ │ │ │ +00001160: 7264 0a73 7570 706f 7274 2073 7469 6c6c rd.support still │ │ │ │ │ +00001170: 2063 6f6d 7069 6c65 7320 636f 7272 6563 compiles correc │ │ │ │ │ +00001180: 746c 792e 2020 474e 5520 276d 3427 2061 tly. GNU 'm4' a │ │ │ │ │ +00001190: 6c73 6f20 656d 706c 6f79 7320 7468 650a lso employs the. │ │ │ │ │ +000011a0: 2741 4d5f 4449 5354 4348 4543 4b5f 434f 'AM_DISTCHECK_CO │ │ │ │ │ +000011b0: 4e46 4947 5552 455f 464c 4147 5327 2076 NFIGURE_FLAGS' v │ │ │ │ │ +000011c0: 6172 6961 626c 6520 746f 2073 7472 6573 ariable to stres │ │ │ │ │ +000011d0: 732d 7465 7374 2074 6865 2075 7365 206f s-test the use o │ │ │ │ │ +000011e0: 660a 272d 2d70 726f 6772 616d 2d70 7265 f.'--program-pre │ │ │ │ │ +000011f0: 6669 783d 6727 2c20 7369 6e63 6520 6174 fix=g', since at │ │ │ │ │ +00001200: 206f 6e65 2070 6f69 6e74 2074 6865 2027 one point the ' │ │ │ │ │ +00001210: 6d34 2720 6275 696c 6420 7379 7374 656d m4' build system │ │ │ │ │ +00001220: 2068 6164 2061 2062 7567 0a77 6865 7265 had a bug.where │ │ │ │ │ +00001230: 2027 6d61 6b65 2069 6e73 7461 6c6c 6368 'make installch │ │ │ │ │ +00001240: 6563 6b27 2077 6173 2077 726f 6e67 6c79 eck' was wrongly │ │ │ │ │ +00001250: 2061 7373 756d 696e 6720 6974 2063 6f75 assuming it cou │ │ │ │ │ +00001260: 6c64 2062 6c69 6e64 6c79 2074 6573 740a ld blindly test. │ │ │ │ │ +00001270: 2227 6d34 2722 2c20 7261 7468 6572 2074 "'m4'", rather t │ │ │ │ │ +00001280: 6861 6e20 7468 6520 6a75 7374 2d69 6e73 han the just-ins │ │ │ │ │ +00001290: 7461 6c6c 6564 2022 2767 6d34 2722 2e0a talled "'gm4'".. │ │ │ │ │ +000012a0: 0a20 2020 4966 2074 6865 2027 6469 7374 . If the 'dist │ │ │ │ │ +000012b0: 6368 6563 6b2d 686f 6f6b 2720 7275 6c65 check-hook' rule │ │ │ │ │ +000012c0: 2069 7320 6465 6669 6e65 6420 696e 2079 is defined in y │ │ │ │ │ +000012d0: 6f75 7220 746f 702d 6c65 7665 6c0a 274d our top-level.'M │ │ │ │ │ +000012e0: 616b 6566 696c 652e 616d 272c 2074 6865 akefile.am', the │ │ │ │ │ +000012f0: 6e20 6974 2077 696c 6c20 6265 2069 6e76 n it will be inv │ │ │ │ │ +00001300: 6f6b 6564 2062 7920 2764 6973 7463 6865 oked by 'distche │ │ │ │ │ +00001310: 636b 2720 6166 7465 7220 7468 6520 6e65 ck' after the ne │ │ │ │ │ +00001320: 770a 6469 7374 7269 6275 7469 6f6e 2068 w.distribution h │ │ │ │ │ +00001330: 6173 2062 6565 6e20 756e 7061 636b 6564 as been unpacked │ │ │ │ │ +00001340: 2c20 6275 7420 6265 666f 7265 2074 6865 , but before the │ │ │ │ │ +00001350: 2075 6e70 6163 6b65 6420 636f 7079 2069 unpacked copy i │ │ │ │ │ +00001360: 730a 636f 6e66 6967 7572 6564 2061 6e64 s.configured and │ │ │ │ │ +00001370: 2062 7569 6c74 2e20 2059 6f75 7220 2764 built. Your 'd │ │ │ │ │ +00001380: 6973 7463 6865 636b 2d68 6f6f 6b27 2063 istcheck-hook' c │ │ │ │ │ +00001390: 616e 2064 6f20 616c 6d6f 7374 2061 6e79 an do almost any │ │ │ │ │ +000013a0: 7468 696e 672c 0a74 686f 7567 6820 6173 thing,.though as │ │ │ │ │ +000013b0: 2061 6c77 6179 7320 6361 7574 696f 6e20 always caution │ │ │ │ │ +000013c0: 6973 2061 6476 6973 6564 2e20 2047 656e is advised. Gen │ │ │ │ │ +000013d0: 6572 616c 6c79 2074 6869 7320 686f 6f6b erally this hook │ │ │ │ │ +000013e0: 2069 7320 7573 6564 2074 6f0a 6368 6563 is used to.chec │ │ │ │ │ +000013f0: 6b20 666f 7220 706f 7465 6e74 6961 6c20 k for potential │ │ │ │ │ +00001400: 6469 7374 7269 6275 7469 6f6e 2065 7272 distribution err │ │ │ │ │ +00001410: 6f72 7320 6e6f 7420 6361 7567 6874 2062 ors not caught b │ │ │ │ │ +00001420: 7920 7468 6520 7374 616e 6461 7264 0a6d y the standard.m │ │ │ │ │ +00001430: 6563 6861 6e69 736d 2e20 204e 6f74 6520 echanism. Note │ │ │ │ │ +00001440: 7468 6174 2027 6469 7374 6368 6563 6b2d that 'distcheck- │ │ │ │ │ +00001450: 686f 6f6b 2720 6173 2077 656c 6c20 6173 hook' as well as │ │ │ │ │ +00001460: 0a27 414d 5f44 4953 5443 4845 434b 5f43 .'AM_DISTCHECK_C │ │ │ │ │ +00001470: 4f4e 4649 4755 5245 5f46 4c41 4753 2720 ONFIGURE_FLAGS' │ │ │ │ │ +00001480: 616e 6420 2744 4953 5443 4845 434b 5f43 and 'DISTCHECK_C │ │ │ │ │ +00001490: 4f4e 4649 4755 5245 5f46 4c41 4753 2720 ONFIGURE_FLAGS' │ │ │ │ │ +000014a0: 6172 6520 6e6f 740a 686f 6e6f 7265 6420 are not.honored │ │ │ │ │ +000014b0: 696e 2061 2073 7562 7061 636b 6167 6520 in a subpackage │ │ │ │ │ +000014c0: 274d 616b 6566 696c 652e 616d 272c 2062 'Makefile.am', b │ │ │ │ │ +000014d0: 7574 2074 6865 2066 6c61 6773 2066 726f ut the flags fro │ │ │ │ │ +000014e0: 6d0a 2741 4d5f 4449 5354 4348 4543 4b5f m.'AM_DISTCHECK_ │ │ │ │ │ +000014f0: 434f 4e46 4947 5552 455f 464c 4147 5327 CONFIGURE_FLAGS' │ │ │ │ │ +00001500: 2061 6e64 2027 4449 5354 4348 4543 4b5f and 'DISTCHECK_ │ │ │ │ │ +00001510: 434f 4e46 4947 5552 455f 464c 4147 5327 CONFIGURE_FLAGS' │ │ │ │ │ +00001520: 2061 7265 0a70 6173 7365 6420 646f 776e are.passed down │ │ │ │ │ +00001530: 2074 6f20 7468 6520 2763 6f6e 6669 6775 to the 'configu │ │ │ │ │ +00001540: 7265 2720 7363 7269 7074 206f 6620 7468 re' script of th │ │ │ │ │ +00001550: 6520 7375 6270 6163 6b61 6765 2e0a 0a20 e subpackage... │ │ │ │ │ +00001560: 2020 5370 6561 6b69 6e67 206f 6620 706f Speaking of po │ │ │ │ │ +00001570: 7465 6e74 6961 6c20 6469 7374 7269 6275 tential distribu │ │ │ │ │ +00001580: 7469 6f6e 2065 7272 6f72 732c 2027 6469 tion errors, 'di │ │ │ │ │ +00001590: 7374 6368 6563 6b27 2061 6c73 6f20 656e stcheck' also en │ │ │ │ │ +000015a0: 7375 7265 730a 7468 6174 2074 6865 2027 sures.that the ' │ │ │ │ │ +000015b0: 6469 7374 636c 6561 6e27 2072 756c 6520 distclean' rule │ │ │ │ │ +000015c0: 6163 7475 616c 6c79 2072 656d 6f76 6573 actually removes │ │ │ │ │ +000015d0: 2061 6c6c 2062 7569 6c74 2066 696c 6573 all built files │ │ │ │ │ +000015e0: 2e20 2054 6869 7320 6973 0a64 6f6e 6520 . This is.done │ │ │ │ │ +000015f0: 6279 2072 756e 6e69 6e67 2027 6d61 6b65 by running 'make │ │ │ │ │ +00001600: 2064 6973 7463 6c65 616e 6368 6563 6b27 distcleancheck' │ │ │ │ │ +00001610: 2061 7420 7468 6520 656e 6420 6f66 2074 at the end of t │ │ │ │ │ +00001620: 6865 2027 5650 4154 4827 2062 7569 6c64 he 'VPATH' build │ │ │ │ │ +00001630: 2e0a 4279 2064 6566 6175 6c74 2c20 2764 ..By default, 'd │ │ │ │ │ +00001640: 6973 7463 6c65 616e 6368 6563 6b27 2077 istcleancheck' w │ │ │ │ │ +00001650: 696c 6c20 7275 6e20 2764 6973 7463 6c65 ill run 'distcle │ │ │ │ │ +00001660: 616e 2720 616e 6420 7468 656e 206d 616b an' and then mak │ │ │ │ │ +00001670: 6520 7375 7265 2074 6865 0a62 7569 6c64 e sure the.build │ │ │ │ │ +00001680: 2074 7265 6520 6861 7320 6265 656e 2065 tree has been e │ │ │ │ │ +00001690: 6d70 7469 6564 2062 7920 7275 6e6e 696e mptied by runnin │ │ │ │ │ +000016a0: 6720 2724 2864 6973 7463 6c65 616e 6368 g '$(distcleanch │ │ │ │ │ +000016b0: 6563 6b5f 6c69 7374 6669 6c65 7329 272e eck_listfiles)'. │ │ │ │ │ +000016c0: 0a55 7375 616c 6c79 2074 6869 7320 6368 .Usually this ch │ │ │ │ │ +000016d0: 6563 6b20 7769 6c6c 2066 696e 6420 6765 eck will find ge │ │ │ │ │ +000016e0: 6e65 7261 7465 6420 6669 6c65 7320 7468 nerated files th │ │ │ │ │ +000016f0: 6174 2079 6f75 2066 6f72 676f 7420 746f at you forgot to │ │ │ │ │ +00001700: 2061 6464 2074 6f0a 7468 6520 2744 4953 add to.the 'DIS │ │ │ │ │ +00001710: 5443 4c45 414e 4649 4c45 5327 2076 6172 TCLEANFILES' var │ │ │ │ │ +00001720: 6961 626c 6520 282a 6e6f 7465 2043 6c65 iable (*note Cle │ │ │ │ │ +00001730: 616e 3a3a 292e 0a0a 2020 2054 6865 2027 an::)... The ' │ │ │ │ │ +00001740: 6469 7374 636c 6561 6e63 6865 636b 2720 distcleancheck' │ │ │ │ │ +00001750: 6265 6861 7669 6f72 2073 686f 756c 6420 behavior should │ │ │ │ │ +00001760: 6265 204f 4b20 666f 7220 6d6f 7374 2070 be OK for most p │ │ │ │ │ +00001770: 6163 6b61 6765 732c 0a6f 7468 6572 7769 ackages,.otherwi │ │ │ │ │ +00001780: 7365 2079 6f75 2068 6176 6520 7468 6520 se you have the │ │ │ │ │ +00001790: 706f 7373 6962 696c 6974 7920 746f 206f possibility to o │ │ │ │ │ +000017a0: 7665 7272 6964 6520 7468 6520 6465 6669 verride the defi │ │ │ │ │ +000017b0: 6e69 7469 6f6e 206f 6620 6569 7468 6572 nition of either │ │ │ │ │ +000017c0: 0a74 6865 2027 6469 7374 636c 6561 6e63 .the 'distcleanc │ │ │ │ │ +000017d0: 6865 636b 2720 7275 6c65 2c20 6f72 2074 heck' rule, or t │ │ │ │ │ +000017e0: 6865 2027 2428 6469 7374 636c 6561 6e63 he '$(distcleanc │ │ │ │ │ +000017f0: 6865 636b 5f6c 6973 7466 696c 6573 2927 heck_listfiles)' │ │ │ │ │ +00001800: 0a76 6172 6961 626c 652e 2020 466f 7220 .variable. For │ │ │ │ │ +00001810: 696e 7374 616e 6365 2c20 746f 2064 6973 instance, to dis │ │ │ │ │ +00001820: 6162 6c65 2027 6469 7374 636c 6561 6e63 able 'distcleanc │ │ │ │ │ +00001830: 6865 636b 2720 636f 6d70 6c65 7465 6c79 heck' completely │ │ │ │ │ +00001840: 2c20 6164 6420 7468 650a 666f 6c6c 6f77 , add the.follow │ │ │ │ │ +00001850: 696e 6720 7275 6c65 2074 6f20 796f 7572 ing rule to your │ │ │ │ │ +00001860: 2074 6f70 2d6c 6576 656c 2027 4d61 6b65 top-level 'Make │ │ │ │ │ +00001870: 6669 6c65 2e61 6d27 3a0a 0a20 2020 2020 file.am':.. │ │ │ │ │ +00001880: 6469 7374 636c 6561 6e63 6865 636b 3a0a distcleancheck:. │ │ │ │ │ +00001890: 2020 2020 2020 2020 2020 2020 2040 3a0a @:. │ │ │ │ │ +000018a0: 0a20 2020 4966 2079 6f75 2077 616e 7420 . If you want │ │ │ │ │ +000018b0: 2764 6973 7463 6c65 616e 6368 6563 6b27 'distcleancheck' │ │ │ │ │ +000018c0: 2074 6f20 6967 6e6f 7265 2062 7569 6c74 to ignore built │ │ │ │ │ +000018d0: 2066 696c 6573 2074 6861 7420 6861 7665 files that have │ │ │ │ │ +000018e0: 206e 6f74 2062 6565 6e0a 636c 6561 6e65 not been.cleane │ │ │ │ │ +000018f0: 6420 6265 6361 7573 6520 7468 6579 2061 d because they a │ │ │ │ │ +00001900: 7265 2061 6c73 6f20 7061 7274 206f 6620 re also part of │ │ │ │ │ +00001910: 7468 6520 6469 7374 7269 6275 7469 6f6e the distribution │ │ │ │ │ +00001920: 2c20 6164 6420 7468 650a 666f 6c6c 6f77 , add the.follow │ │ │ │ │ +00001930: 696e 6720 6465 6669 6e69 7469 6f6e 2069 ing definition i │ │ │ │ │ +00001940: 6e73 7465 6164 3a0a 0a20 2020 2020 6469 nstead:.. di │ │ │ │ │ +00001950: 7374 636c 6561 6e63 6865 636b 5f6c 6973 stcleancheck_lis │ │ │ │ │ +00001960: 7466 696c 6573 203d 205c 0a20 2020 2020 tfiles = \. │ │ │ │ │ +00001970: 2020 6669 6e64 202e 202d 7479 7065 2066 find . -type f │ │ │ │ │ +00001980: 202d 6578 6563 2073 6820 2d63 2027 7465 -exec sh -c 'te │ │ │ │ │ +00001990: 7374 202d 6620 2428 7372 6364 6972 292f st -f $(srcdir)/ │ │ │ │ │ +000019a0: 2424 3120 7c7c 2065 6368 6f20 2424 3127 $$1 || echo $$1' │ │ │ │ │ +000019b0: 205c 0a20 2020 2020 2020 2020 2020 2073 \. s │ │ │ │ │ +000019c0: 6820 277b 7d27 2027 3b27 0a0a 2020 2054 h '{}' ';'.. T │ │ │ │ │ +000019d0: 6865 2061 626f 7665 2064 6566 696e 6974 he above definit │ │ │ │ │ +000019e0: 696f 6e20 6973 206e 6f74 2074 6865 2064 ion is not the d │ │ │ │ │ +000019f0: 6566 6175 6c74 2062 6563 6175 7365 2069 efault because i │ │ │ │ │ +00001a00: 7427 7320 7573 7561 6c6c 7920 616e 2065 t's usually an e │ │ │ │ │ +00001a10: 7272 6f72 0a69 6620 796f 7572 204d 616b rror.if your Mak │ │ │ │ │ +00001a20: 6566 696c 6573 2063 6175 7365 2073 6f6d efiles cause som │ │ │ │ │ +00001a30: 6520 6469 7374 7269 6275 7465 6420 6669 e distributed fi │ │ │ │ │ +00001a40: 6c65 7320 746f 2062 6520 7265 6275 696c les to be rebuil │ │ │ │ │ +00001a50: 7420 7768 656e 2074 6865 0a75 7365 7220 t when the.user │ │ │ │ │ +00001a60: 6275 696c 6420 7468 6520 7061 636b 6167 build the packag │ │ │ │ │ +00001a70: 652e 2020 2854 6869 6e6b 2061 626f 7574 e. (Think about │ │ │ │ │ +00001a80: 2074 6865 2075 7365 7220 6d69 7373 696e the user missin │ │ │ │ │ +00001a90: 6720 7468 6520 746f 6f6c 2072 6571 7569 g the tool requi │ │ │ │ │ +00001aa0: 7265 640a 746f 2062 7569 6c64 2074 6865 red.to build the │ │ │ │ │ +00001ab0: 2066 696c 653b 206f 7220 6966 2074 6865 file; or if the │ │ │ │ │ +00001ac0: 2072 6571 7569 7265 6420 746f 6f6c 2069 required tool i │ │ │ │ │ +00001ad0: 7320 6275 696c 7420 6279 2079 6f75 7220 s built by your │ │ │ │ │ +00001ae0: 7061 636b 6167 652c 0a63 6f6e 7369 6465 package,.conside │ │ │ │ │ +00001af0: 7220 7468 6520 6372 6f73 732d 636f 6d70 r the cross-comp │ │ │ │ │ +00001b00: 696c 6174 696f 6e20 6361 7365 2077 6865 ilation case whe │ │ │ │ │ +00001b10: 7265 2069 7420 6361 6e27 7420 6265 2072 re it can't be r │ │ │ │ │ +00001b20: 756e 2e29 2020 5468 6572 6520 6973 2061 un.) There is a │ │ │ │ │ +00001b30: 6e0a 656e 7472 7920 696e 2074 6865 2046 n.entry in the F │ │ │ │ │ +00001b40: 4151 2061 626f 7574 2074 6869 7320 282a AQ about this (* │ │ │ │ │ +00001b50: 6e6f 7465 2064 6973 7463 6c65 616e 6368 note distcleanch │ │ │ │ │ +00001b60: 6563 6b3a 3a29 2c20 6d61 6b65 2073 7572 eck::), make sur │ │ │ │ │ +00001b70: 6520 796f 7520 7265 6164 0a69 7420 6265 e you read.it be │ │ │ │ │ +00001b80: 666f 7265 2070 6c61 7969 6e67 2077 6974 fore playing wit │ │ │ │ │ +00001b90: 6820 2764 6973 7463 6c65 616e 6368 6563 h 'distcleanchec │ │ │ │ │ +00001ba0: 6b5f 6c69 7374 6669 6c65 7327 2e0a 0a20 k_listfiles'... │ │ │ │ │ +00001bb0: 2020 2764 6973 7463 6865 636b 2720 616c 'distcheck' al │ │ │ │ │ +00001bc0: 736f 2063 6865 636b 7320 7468 6174 2074 so checks that t │ │ │ │ │ +00001bd0: 6865 2027 756e 696e 7374 616c 6c27 2072 he 'uninstall' r │ │ │ │ │ +00001be0: 756c 6520 776f 726b 7320 7072 6f70 6572 ule works proper │ │ │ │ │ +00001bf0: 6c79 2c0a 626f 7468 2066 6f72 206f 7264 ly,.both for ord │ │ │ │ │ +00001c00: 696e 6172 7920 616e 6420 2744 4553 5444 inary and 'DESTD │ │ │ │ │ +00001c10: 4952 2720 6275 696c 6473 2e20 2049 7420 IR' builds. It │ │ │ │ │ +00001c20: 646f 6573 2074 6869 7320 6279 2069 6e76 does this by inv │ │ │ │ │ +00001c30: 6f6b 696e 6720 276d 616b 650a 756e 696e oking 'make.unin │ │ │ │ │ +00001c40: 7374 616c 6c27 2c20 616e 6420 7468 656e stall', and then │ │ │ │ │ +00001c50: 2069 7420 6368 6563 6b73 2074 6865 2069 it checks the i │ │ │ │ │ +00001c60: 6e73 7461 6c6c 2074 7265 6520 746f 2073 nstall tree to s │ │ │ │ │ +00001c70: 6565 2069 6620 616e 7920 6669 6c65 7320 ee if any files │ │ │ │ │ +00001c80: 6172 650a 6c65 6674 206f 7665 722e 2020 are.left over. │ │ │ │ │ +00001c90: 5468 6973 2063 6865 636b 2077 696c 6c20 This check will │ │ │ │ │ +00001ca0: 6d61 6b65 2073 7572 6520 7468 6174 2079 make sure that y │ │ │ │ │ +00001cb0: 6f75 2063 6f72 7265 6374 6c79 2063 6f64 ou correctly cod │ │ │ │ │ +00001cc0: 6564 2079 6f75 720a 2775 6e69 6e73 7461 ed your.'uninsta │ │ │ │ │ +00001cd0: 6c6c 272d 7265 6c61 7465 6420 7275 6c65 ll'-related rule │ │ │ │ │ +00001ce0: 732e 0a0a 2020 2042 7920 6465 6661 756c s... By defaul │ │ │ │ │ +00001cf0: 742c 2074 6865 2063 6865 636b 696e 6720 t, the checking │ │ │ │ │ +00001d00: 6973 2064 6f6e 6520 6279 2074 6865 2027 is done by the ' │ │ │ │ │ +00001d10: 6469 7374 756e 696e 7374 616c 6c63 6865 distuninstallche │ │ │ │ │ +00001d20: 636b 2720 7275 6c65 2c0a 616e 6420 7468 ck' rule,.and th │ │ │ │ │ +00001d30: 6520 6c69 7374 206f 6620 6669 6c65 7320 e list of files │ │ │ │ │ +00001d40: 696e 2074 6865 2069 6e73 7461 6c6c 2074 in the install t │ │ │ │ │ +00001d50: 7265 6520 6973 2067 656e 6572 6174 6564 ree is generated │ │ │ │ │ +00001d60: 2062 790a 2724 2864 6973 7475 6e69 6e73 by.'$(distunins │ │ │ │ │ +00001d70: 7461 6c6c 6368 6563 6b5f 6c69 7374 6669 tallcheck_listfi │ │ │ │ │ +00001d80: 6c65 7329 2720 2874 6869 7320 6973 2061 les)' (this is a │ │ │ │ │ +00001d90: 2076 6172 6961 626c 6520 7768 6f73 6520 variable whose │ │ │ │ │ +00001da0: 7661 6c75 6520 6973 2061 0a73 6865 6c6c value is a.shell │ │ │ │ │ +00001db0: 2063 6f6d 6d61 6e64 2074 6f20 7275 6e20 command to run │ │ │ │ │ +00001dc0: 7468 6174 2070 7269 6e74 7320 7468 6520 that prints the │ │ │ │ │ +00001dd0: 6c69 7374 206f 6620 6669 6c65 7320 746f list of files to │ │ │ │ │ +00001de0: 2073 7464 6f75 7429 2e0a 0a20 2020 4569 stdout)... Ei │ │ │ │ │ +00001df0: 7468 6572 206f 6620 7468 6573 6520 6361 ther of these ca │ │ │ │ │ +00001e00: 6e20 6265 206f 7665 7272 6964 6465 6e20 n be overridden │ │ │ │ │ +00001e10: 746f 206d 6f64 6966 7920 7468 6520 6265 to modify the be │ │ │ │ │ +00001e20: 6861 7669 6f72 206f 660a 2764 6973 7463 havior of.'distc │ │ │ │ │ +00001e30: 6865 636b 272e 2020 466f 7220 696e 7374 heck'. For inst │ │ │ │ │ +00001e40: 616e 6365 2c20 746f 2064 6973 6162 6c65 ance, to disable │ │ │ │ │ +00001e50: 2074 6869 7320 6368 6563 6b20 636f 6d70 this check comp │ │ │ │ │ +00001e60: 6c65 7465 6c79 2c20 796f 7520 776f 756c letely, you woul │ │ │ │ │ +00001e70: 640a 7772 6974 653a 0a0a 2020 2020 2064 d.write:.. d │ │ │ │ │ +00001e80: 6973 7475 6e69 6e73 7461 6c6c 6368 6563 istuninstallchec │ │ │ │ │ +00001e90: 6b3a 0a20 2020 2020 2020 2020 2020 2020 k:. │ │ │ │ │ +00001ea0: 403a 0a0a 1f0a 4669 6c65 3a20 6175 746f @:....File: auto │ │ │ │ │ +00001eb0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +00001ec0: 204e 6f64 653a 2054 6865 2054 7970 6573 Node: The Types │ │ │ │ │ +00001ed0: 206f 6620 4469 7374 7269 6275 7469 6f6e of Distribution │ │ │ │ │ +00001ee0: 732c 2020 5072 6576 3a20 4368 6563 6b69 s, Prev: Checki │ │ │ │ │ +00001ef0: 6e67 2074 6865 2044 6973 7472 6962 7574 ng the Distribut │ │ │ │ │ +00001f00: 696f 6e2c 2020 5570 3a20 4469 7374 0a0a ion, Up: Dist.. │ │ │ │ │ +00001f10: 3134 2e35 2054 6865 2054 7970 6573 206f 14.5 The Types o │ │ │ │ │ +00001f20: 6620 4469 7374 7269 6275 7469 6f6e 730a f Distributions. │ │ │ │ │ 00001f30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00001f40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00001f50: 4175 746f 6d61 6b65 2067 656e 6572 6174 Automake generat │ │ │ │ │ -00001f60: 6573 2072 756c 6573 2074 6f20 7072 6f76 es rules to prov │ │ │ │ │ -00001f70: 6964 6520 6172 6368 6976 6573 206f 6620 ide archives of │ │ │ │ │ -00001f80: 7468 6520 7072 6f6a 6563 7420 666f 720a the project for. │ │ │ │ │ -00001f90: 6469 7374 7269 6275 7469 6f6e 7320 696e distributions in │ │ │ │ │ -00001fa0: 2076 6172 696f 7573 2066 6f72 6d61 7473 various formats │ │ │ │ │ -00001fb0: 2e20 2054 6865 6972 2074 6172 6765 7473 . Their targets │ │ │ │ │ -00001fc0: 2061 7265 3a0a 0a27 6469 7374 2d62 7a69 are:..'dist-bzi │ │ │ │ │ -00001fd0: 7032 270a 2020 2020 2047 656e 6572 6174 p2'. Generat │ │ │ │ │ -00001fe0: 6520 6120 627a 6970 3220 7461 7220 6172 e a bzip2 tar ar │ │ │ │ │ -00001ff0: 6368 6976 6520 6f66 2074 6865 2064 6973 chive of the dis │ │ │ │ │ -00002000: 7472 6962 7574 696f 6e2e 2020 627a 6970 tribution. bzip │ │ │ │ │ -00002010: 3220 6172 6368 6976 6573 0a20 2020 2020 2 archives. │ │ │ │ │ -00002020: 6172 6520 6672 6571 7565 6e74 6c79 2073 are frequently s │ │ │ │ │ -00002030: 6d61 6c6c 6572 2074 6861 6e20 677a 6970 maller than gzip │ │ │ │ │ -00002040: 7065 6420 6172 6368 6976 6573 2e20 2042 ped archives. B │ │ │ │ │ -00002050: 7920 6465 6661 756c 742c 2074 6869 730a y default, this. │ │ │ │ │ -00002060: 2020 2020 2072 756c 6520 6d61 6b65 7320 rule makes │ │ │ │ │ -00002070: 2762 7a69 7032 2720 7573 6520 6120 636f 'bzip2' use a co │ │ │ │ │ -00002080: 6d70 7265 7373 696f 6e20 6f70 7469 6f6e mpression option │ │ │ │ │ -00002090: 206f 6620 272d 3927 2e20 2054 6f20 6d61 of '-9'. To ma │ │ │ │ │ -000020a0: 6b65 2069 740a 2020 2020 2075 7365 2061 ke it. use a │ │ │ │ │ -000020b0: 2064 6966 6665 7265 6e74 206f 6e65 2c20 different one, │ │ │ │ │ -000020c0: 7365 7420 7468 6520 2742 5a49 5032 2720 set the 'BZIP2' │ │ │ │ │ -000020d0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -000020e0: 6162 6c65 2e20 2046 6f72 0a20 2020 2020 able. For. │ │ │ │ │ -000020f0: 6578 616d 706c 652c 2027 6d61 6b65 2064 example, 'make d │ │ │ │ │ -00002100: 6973 742d 627a 6970 3220 425a 4950 323d ist-bzip2 BZIP2= │ │ │ │ │ -00002110: 2d37 272e 0a0a 2764 6973 742d 677a 6970 -7'...'dist-gzip │ │ │ │ │ -00002120: 270a 2020 2020 2047 656e 6572 6174 6520 '. Generate │ │ │ │ │ -00002130: 6120 677a 6970 2074 6172 2061 7263 6869 a gzip tar archi │ │ │ │ │ -00002140: 7665 206f 6620 7468 6520 6469 7374 7269 ve of the distri │ │ │ │ │ -00002150: 6275 7469 6f6e 2e0a 0a27 6469 7374 2d6c bution...'dist-l │ │ │ │ │ -00002160: 7a69 7027 0a20 2020 2020 4765 6e65 7261 zip'. Genera │ │ │ │ │ -00002170: 7465 2061 2027 6c7a 6970 2720 7461 7220 te a 'lzip' tar │ │ │ │ │ -00002180: 6172 6368 6976 6520 6f66 2074 6865 2064 archive of the d │ │ │ │ │ -00002190: 6973 7472 6962 7574 696f 6e2e 2020 276c istribution. 'l │ │ │ │ │ -000021a0: 7a69 7027 2061 7263 6869 7665 730a 2020 zip' archives. │ │ │ │ │ -000021b0: 2020 2061 7265 2066 7265 7175 656e 746c are frequentl │ │ │ │ │ -000021c0: 7920 736d 616c 6c65 7220 7468 616e 2027 y smaller than ' │ │ │ │ │ -000021d0: 627a 6970 3227 2d63 6f6d 7072 6573 7365 bzip2'-compresse │ │ │ │ │ -000021e0: 6420 6172 6368 6976 6573 2e0a 0a27 6469 d archives...'di │ │ │ │ │ -000021f0: 7374 2d6c 7a6d 6127 0a20 2020 2020 4765 st-lzma'. Ge │ │ │ │ │ -00002200: 6e65 7261 7465 2061 6e20 276c 7a6d 6127 nerate an 'lzma' │ │ │ │ │ -00002210: 2074 6172 2061 7263 6869 7665 206f 6620 tar archive of │ │ │ │ │ -00002220: 7468 6520 6469 7374 7269 6275 7469 6f6e the distribution │ │ │ │ │ -00002230: 2e20 2054 6865 2027 6c7a 6d61 270a 2020 . The 'lzma'. │ │ │ │ │ -00002240: 2020 2066 6f72 6d61 7420 6973 206f 6273 format is obs │ │ │ │ │ -00002250: 6f6c 6574 652c 2079 6f75 2073 686f 756c olete, you shoul │ │ │ │ │ -00002260: 6420 7573 6520 7468 6520 2778 7a27 2066 d use the 'xz' f │ │ │ │ │ -00002270: 6f72 6d61 7420 696e 7374 6561 642e 0a20 ormat instead.. │ │ │ │ │ -00002280: 2020 2020 5f53 7570 706f 7274 2066 6f72 _Support for │ │ │ │ │ -00002290: 2027 6c7a 6d61 272d 636f 6d70 7265 7373 'lzma'-compress │ │ │ │ │ -000022a0: 6564 2061 7263 6869 7665 7320 7769 6c6c ed archives will │ │ │ │ │ -000022b0: 2062 6520 7265 6d6f 7665 6420 696e 2074 be removed in t │ │ │ │ │ -000022c0: 6865 206e 6578 740a 2020 2020 206d 616a he next. maj │ │ │ │ │ -000022d0: 6f72 2041 7574 6f6d 616b 6520 7265 6c65 or Automake rele │ │ │ │ │ -000022e0: 6173 652e 5f0a 0a27 6469 7374 2d73 6861 ase._..'dist-sha │ │ │ │ │ -000022f0: 7227 0a20 2020 2020 4765 6e65 7261 7465 r'. Generate │ │ │ │ │ -00002300: 2061 2073 6861 7220 6172 6368 6976 6520 a shar archive │ │ │ │ │ -00002310: 6f66 2074 6865 2064 6973 7472 6962 7574 of the distribut │ │ │ │ │ -00002320: 696f 6e2e 0a0a 2764 6973 742d 787a 270a ion...'dist-xz'. │ │ │ │ │ -00002330: 2020 2020 2047 656e 6572 6174 6520 616e Generate an │ │ │ │ │ -00002340: 2027 787a 2720 7461 7220 6172 6368 6976 'xz' tar archiv │ │ │ │ │ -00002350: 6520 6f66 2074 6865 2064 6973 7472 6962 e of the distrib │ │ │ │ │ -00002360: 7574 696f 6e2e 2020 2778 7a27 2061 7263 ution. 'xz' arc │ │ │ │ │ -00002370: 6869 7665 730a 2020 2020 2061 7265 2066 hives. are f │ │ │ │ │ -00002380: 7265 7175 656e 746c 7920 736d 616c 6c65 requently smalle │ │ │ │ │ -00002390: 7220 7468 616e 2027 627a 6970 3227 2d63 r than 'bzip2'-c │ │ │ │ │ -000023a0: 6f6d 7072 6573 7365 6420 6172 6368 6976 ompressed archiv │ │ │ │ │ -000023b0: 6573 2e20 2054 6865 2027 787a 270a 2020 es. The 'xz'. │ │ │ │ │ -000023c0: 2020 2066 6f72 6d61 7420 6469 7370 6c61 format displa │ │ │ │ │ -000023d0: 6365 7320 7468 6520 6f62 736f 6c65 7465 ces the obsolete │ │ │ │ │ -000023e0: 2027 6c7a 6d61 2720 666f 726d 6174 2e20 'lzma' format. │ │ │ │ │ -000023f0: 2042 7920 6465 6661 756c 742c 2074 6869 By default, thi │ │ │ │ │ -00002400: 7320 7275 6c65 0a20 2020 2020 6d61 6b65 s rule. make │ │ │ │ │ -00002410: 7320 2778 7a27 2075 7365 2061 2063 6f6d s 'xz' use a com │ │ │ │ │ -00002420: 7072 6573 7369 6f6e 206f 7074 696f 6e20 pression option │ │ │ │ │ -00002430: 6f66 2027 2d65 272e 2020 546f 206d 616b of '-e'. To mak │ │ │ │ │ -00002440: 6520 6974 2075 7365 2061 0a20 2020 2020 e it use a. │ │ │ │ │ -00002450: 6469 6666 6572 656e 7420 6f6e 652c 2073 different one, s │ │ │ │ │ -00002460: 6574 2074 6865 2027 585a 5f4f 5054 2720 et the 'XZ_OPT' │ │ │ │ │ -00002470: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00002480: 6162 6c65 2e20 2046 6f72 2065 7861 6d70 able. For examp │ │ │ │ │ -00002490: 6c65 2c0a 2020 2020 2072 756e 2074 6869 le,. run thi │ │ │ │ │ -000024a0: 7320 636f 6d6d 616e 6420 746f 2075 7365 s command to use │ │ │ │ │ -000024b0: 2074 6865 2064 6566 6175 6c74 2063 6f6d the default com │ │ │ │ │ -000024c0: 7072 6573 7369 6f6e 2072 6174 696f 2c20 pression ratio, │ │ │ │ │ -000024d0: 6275 7420 7769 7468 2061 0a20 2020 2020 but with a. │ │ │ │ │ -000024e0: 7072 6f67 7265 7373 2069 6e64 6963 6174 progress indicat │ │ │ │ │ -000024f0: 6f72 3a20 276d 616b 6520 6469 7374 2d78 or: 'make dist-x │ │ │ │ │ -00002500: 7a20 585a 5f4f 5054 3d2d 3765 272e 0a0a z XZ_OPT=-7e'... │ │ │ │ │ -00002510: 2764 6973 742d 7a69 7027 0a20 2020 2020 'dist-zip'. │ │ │ │ │ -00002520: 4765 6e65 7261 7465 2061 207a 6970 2061 Generate a zip a │ │ │ │ │ -00002530: 7263 6869 7665 206f 6620 7468 6520 6469 rchive of the di │ │ │ │ │ -00002540: 7374 7269 6275 7469 6f6e 2e0a 0a27 6469 stribution...'di │ │ │ │ │ -00002550: 7374 2d74 6172 5a27 0a20 2020 2020 4765 st-tarZ'. Ge │ │ │ │ │ -00002560: 6e65 7261 7465 2061 2063 6f6d 7072 6573 nerate a compres │ │ │ │ │ -00002570: 7365 6420 7461 7220 6172 6368 6976 6520 sed tar archive │ │ │ │ │ -00002580: 6f66 2074 6865 2064 6973 7472 6962 7574 of the distribut │ │ │ │ │ -00002590: 696f 6e2e 0a0a 2020 2054 6865 2072 756c ion... The rul │ │ │ │ │ -000025a0: 6520 2764 6973 7427 2028 616e 6420 6974 e 'dist' (and it │ │ │ │ │ -000025b0: 7320 6869 7374 6f72 6963 616c 2073 796e s historical syn │ │ │ │ │ -000025c0: 6f6e 796d 2027 6469 7374 2d61 6c6c 2729 onym 'dist-all') │ │ │ │ │ -000025d0: 2077 696c 6c20 6372 6561 7465 0a61 7263 will create.arc │ │ │ │ │ -000025e0: 6869 7665 7320 696e 2061 6c6c 2074 6865 hives in all the │ │ │ │ │ -000025f0: 2065 6e61 626c 6564 2066 6f72 6d61 7473 enabled formats │ │ │ │ │ -00002600: 2c20 2a6e 6f74 6520 4f70 7469 6f6e 733a , *note Options: │ │ │ │ │ -00002610: 3a2e 2020 4279 2064 6566 6175 6c74 2c20 :. By default, │ │ │ │ │ -00002620: 6f6e 6c79 0a74 6865 2027 6469 7374 2d67 only.the 'dist-g │ │ │ │ │ -00002630: 7a69 7027 2074 6172 6765 7420 6973 2068 zip' target is h │ │ │ │ │ -00002640: 6f6f 6b65 6420 746f 2027 6469 7374 272e ooked to 'dist'. │ │ │ │ │ -00002650: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00002660: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00002670: 6f64 653a 2054 6573 7473 2c20 204e 6578 ode: Tests, Nex │ │ │ │ │ -00002680: 743a 2052 6562 7569 6c64 696e 672c 2020 t: Rebuilding, │ │ │ │ │ -00002690: 5072 6576 3a20 4469 7374 2c20 2055 703a Prev: Dist, Up: │ │ │ │ │ -000026a0: 2054 6f70 0a0a 3135 2053 7570 706f 7274 Top..15 Support │ │ │ │ │ -000026b0: 2066 6f72 2074 6573 7420 7375 6974 6573 for test suites │ │ │ │ │ -000026c0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -000026d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a41 7574 ***********..Aut │ │ │ │ │ -000026e0: 6f6d 616b 6520 7375 7070 6f72 7473 2074 omake supports t │ │ │ │ │ -000026f0: 6872 6565 2066 6f72 6d73 206f 6620 7465 hree forms of te │ │ │ │ │ -00002700: 7374 2073 7569 7465 732c 2074 6865 2066 st suites, the f │ │ │ │ │ -00002710: 6972 7374 2074 776f 206f 6620 7768 6963 irst two of whic │ │ │ │ │ -00002720: 6820 6172 650a 7665 7279 2073 696d 696c h are.very simil │ │ │ │ │ -00002730: 6172 2e0a 0a2a 204d 656e 753a 0a0a 2a20 ar...* Menu:..* │ │ │ │ │ -00002740: 5369 6d70 6c65 2054 6573 7473 3a3a 2020 Simple Tests:: │ │ │ │ │ -00002750: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ │ -00002760: 7374 696e 6720 7072 6f67 7261 6d73 2061 sting programs a │ │ │ │ │ -00002770: 6e64 2073 6372 6970 7473 2069 6e20 2754 nd scripts in 'T │ │ │ │ │ -00002780: 4553 5453 270a 2a20 5369 6d70 6c65 2054 ESTS'.* Simple T │ │ │ │ │ -00002790: 6573 7473 2075 7369 6e67 2070 6172 616c ests using paral │ │ │ │ │ -000027a0: 6c65 6c2d 7465 7374 733a 3a20 204d 6f72 lel-tests:: Mor │ │ │ │ │ -000027b0: 6520 706f 7765 7266 756c 2074 6573 7420 e powerful test │ │ │ │ │ -000027c0: 6472 6976 6572 0a2a 2044 656a 6147 6e75 driver.* DejaGnu │ │ │ │ │ -000027d0: 2054 6573 7473 3a3a 2020 2020 2020 2020 Tests:: │ │ │ │ │ -000027e0: 2020 2020 2020 2049 6e74 6572 6661 6369 Interfaci │ │ │ │ │ -000027f0: 6e67 2077 6974 6820 7468 6520 6578 7465 ng with the exte │ │ │ │ │ -00002800: 726e 616c 2074 6573 7469 6e67 2066 7261 rnal testing fra │ │ │ │ │ -00002810: 6d65 776f 726b 0a2a 2049 6e73 7461 6c6c mework.* Install │ │ │ │ │ -00002820: 2054 6573 7473 3a3a 2020 2020 2020 2020 Tests:: │ │ │ │ │ -00002830: 2020 2020 2020 2052 756e 6e69 6e67 2074 Running t │ │ │ │ │ -00002840: 6573 7473 206f 6e20 696e 7374 616c 6c65 ests on installe │ │ │ │ │ -00002850: 6420 7061 636b 6167 6573 0a0a 1f0a 4669 d packages....Fi │ │ │ │ │ -00002860: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ -00002870: 312e 696e 666f 2c20 204e 6f64 653a 2053 1.info, Node: S │ │ │ │ │ -00002880: 696d 706c 6520 5465 7374 732c 2020 4e65 imple Tests, Ne │ │ │ │ │ -00002890: 7874 3a20 5369 6d70 6c65 2054 6573 7473 xt: Simple Tests │ │ │ │ │ -000028a0: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ -000028b0: 7465 7374 732c 2020 5570 3a20 5465 7374 tests, Up: Test │ │ │ │ │ -000028c0: 730a 0a31 352e 3120 5369 6d70 6c65 2054 s..15.1 Simple T │ │ │ │ │ -000028d0: 6573 7473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ests.=========== │ │ │ │ │ -000028e0: 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 2076 ======..If the v │ │ │ │ │ -000028f0: 6172 6961 626c 6520 2754 4553 5453 2720 ariable 'TESTS' │ │ │ │ │ -00002900: 6973 2064 6566 696e 6564 2c20 6974 7320 is defined, its │ │ │ │ │ -00002910: 7661 6c75 6520 6973 2074 616b 656e 2074 value is taken t │ │ │ │ │ -00002920: 6f20 6265 2061 206c 6973 7420 6f66 0a70 o be a list of.p │ │ │ │ │ -00002930: 726f 6772 616d 7320 6f72 2073 6372 6970 rograms or scrip │ │ │ │ │ -00002940: 7473 2074 6f20 7275 6e20 696e 206f 7264 ts to run in ord │ │ │ │ │ -00002950: 6572 2074 6f20 646f 2074 6865 2074 6573 er to do the tes │ │ │ │ │ -00002960: 7469 6e67 2e20 2050 726f 6772 616d 7320 ting. Programs │ │ │ │ │ -00002970: 6e65 6564 696e 670a 6461 7461 2066 696c needing.data fil │ │ │ │ │ -00002980: 6573 2073 686f 756c 6420 6c6f 6f6b 2066 es should look f │ │ │ │ │ -00002990: 6f72 2074 6865 6d20 696e 2027 7372 6364 or them in 'srcd │ │ │ │ │ -000029a0: 6972 2720 2877 6869 6368 2069 7320 626f ir' (which is bo │ │ │ │ │ -000029b0: 7468 2061 6e0a 656e 7669 726f 6e6d 656e th an.environmen │ │ │ │ │ -000029c0: 7420 7661 7269 6162 6c65 2061 6e64 2061 t variable and a │ │ │ │ │ -000029d0: 206d 616b 6520 7661 7269 6162 6c65 2920 make variable) │ │ │ │ │ -000029e0: 736f 2074 6865 7920 776f 726b 2077 6865 so they work whe │ │ │ │ │ -000029f0: 6e20 6275 696c 6469 6e67 2069 6e0a 6120 n building in.a │ │ │ │ │ -00002a00: 7365 7061 7261 7465 2064 6972 6563 746f separate directo │ │ │ │ │ -00002a10: 7279 2028 2a6e 6f74 6520 4275 696c 6420 ry (*note Build │ │ │ │ │ -00002a20: 4469 7265 6374 6f72 6965 733a 2028 6175 Directories: (au │ │ │ │ │ -00002a30: 746f 636f 6e66 2942 7569 6c64 0a44 6972 toconf)Build.Dir │ │ │ │ │ -00002a40: 6563 746f 7269 6573 2e29 2c20 616e 6420 ectories.), and │ │ │ │ │ -00002a50: 696e 2070 6172 7469 6375 6c61 7220 666f in particular fo │ │ │ │ │ -00002a60: 7220 7468 6520 2764 6973 7463 6865 636b r the 'distcheck │ │ │ │ │ -00002a70: 2720 7275 6c65 2028 2a6e 6f74 650a 4368 ' rule (*note.Ch │ │ │ │ │ -00002a80: 6563 6b69 6e67 2074 6865 2044 6973 7472 ecking the Distr │ │ │ │ │ -00002a90: 6962 7574 696f 6e3a 3a29 2e0a 0a20 2020 ibution::)... │ │ │ │ │ -00002aa0: 466f 7220 6561 6368 206f 6620 7468 6520 For each of the │ │ │ │ │ -00002ab0: 2754 4553 5453 272c 2074 6865 2072 6573 'TESTS', the res │ │ │ │ │ -00002ac0: 756c 7420 6f66 2065 7865 6375 7469 6f6e ult of execution │ │ │ │ │ -00002ad0: 2069 7320 7072 696e 7465 6420 616c 6f6e is printed alon │ │ │ │ │ -00002ae0: 670a 7769 7468 2074 6865 2074 6573 7420 g.with the test │ │ │ │ │ -00002af0: 6e61 6d65 2c20 7768 6572 6520 2750 4153 name, where 'PAS │ │ │ │ │ -00002b00: 5327 2064 656e 6f74 6573 2061 2073 7563 S' denotes a suc │ │ │ │ │ -00002b10: 6365 7373 6675 6c20 7465 7374 2c20 2746 cessful test, 'F │ │ │ │ │ -00002b20: 4149 4c27 0a64 656e 6f74 6573 2061 2066 AIL'.denotes a f │ │ │ │ │ -00002b30: 6169 6c65 6420 7465 7374 2c20 2758 4641 ailed test, 'XFA │ │ │ │ │ -00002b40: 494c 2720 616e 2065 7870 6563 7465 6420 IL' an expected │ │ │ │ │ -00002b50: 6661 696c 7572 652c 2027 5850 4153 5327 failure, 'XPASS' │ │ │ │ │ -00002b60: 2061 6e0a 756e 6578 7065 6374 6564 2070 an.unexpected p │ │ │ │ │ -00002b70: 6173 7320 666f 7220 6120 7465 7374 2074 ass for a test t │ │ │ │ │ -00002b80: 6861 7420 6973 2073 7570 706f 7365 6420 hat is supposed │ │ │ │ │ -00002b90: 746f 2066 6169 6c2c 2061 6e64 2027 534b to fail, and 'SK │ │ │ │ │ -00002ba0: 4950 2720 6465 6e6f 7465 730a 6120 736b IP' denotes.a sk │ │ │ │ │ -00002bb0: 6970 7065 6420 7465 7374 2e0a 0a20 2020 ipped test... │ │ │ │ │ -00002bc0: 5468 6520 6e75 6d62 6572 206f 6620 6661 The number of fa │ │ │ │ │ -00002bd0: 696c 7572 6573 2077 696c 6c20 6265 2070 ilures will be p │ │ │ │ │ -00002be0: 7269 6e74 6564 2061 7420 7468 6520 656e rinted at the en │ │ │ │ │ -00002bf0: 6420 6f66 2074 6865 2072 756e 2e20 2049 d of the run. I │ │ │ │ │ -00002c00: 6620 610a 6769 7665 6e20 7465 7374 2070 f a.given test p │ │ │ │ │ -00002c10: 726f 6772 616d 2065 7869 7473 2077 6974 rogram exits wit │ │ │ │ │ -00002c20: 6820 6120 7374 6174 7573 206f 6620 3737 h a status of 77 │ │ │ │ │ -00002c30: 2c20 7468 656e 2069 7473 2072 6573 756c , then its resul │ │ │ │ │ -00002c40: 7420 6973 2069 676e 6f72 6564 0a69 6e20 t is ignored.in │ │ │ │ │ -00002c50: 7468 6520 6669 6e61 6c20 636f 756e 742e the final count. │ │ │ │ │ -00002c60: 2020 5468 6973 2066 6561 7475 7265 2061 This feature a │ │ │ │ │ -00002c70: 6c6c 6f77 7320 6e6f 6e2d 706f 7274 6162 llows non-portab │ │ │ │ │ -00002c80: 6c65 2074 6573 7473 2074 6f20 6265 0a69 le tests to be.i │ │ │ │ │ -00002c90: 676e 6f72 6564 2069 6e20 656e 7669 726f gnored in enviro │ │ │ │ │ -00002ca0: 6e6d 656e 7473 2077 6865 7265 2074 6865 nments where the │ │ │ │ │ -00002cb0: 7920 646f 6e27 7420 6d61 6b65 2073 656e y don't make sen │ │ │ │ │ -00002cc0: 7365 2e0a 0a20 2020 4966 2074 6865 2041 se... If the A │ │ │ │ │ -00002cd0: 7574 6f6d 616b 6520 6f70 7469 6f6e 2027 utomake option ' │ │ │ │ │ -00002ce0: 636f 6c6f 722d 7465 7374 7327 2069 7320 color-tests' is │ │ │ │ │ -00002cf0: 7573 6564 2028 2a6e 6f74 6520 4f70 7469 used (*note Opti │ │ │ │ │ -00002d00: 6f6e 733a 3a29 2061 6e64 0a73 7461 6e64 ons::) and.stand │ │ │ │ │ -00002d10: 6172 6420 6f75 7470 7574 2069 7320 636f ard output is co │ │ │ │ │ -00002d20: 6e6e 6563 7465 6420 746f 2061 2063 6170 nnected to a cap │ │ │ │ │ -00002d30: 6162 6c65 2074 6572 6d69 6e61 6c2c 2074 able terminal, t │ │ │ │ │ -00002d40: 6865 6e20 7468 6520 7465 7374 0a72 6573 hen the test.res │ │ │ │ │ -00002d50: 756c 7473 2061 6e64 2074 6865 2073 756d ults and the sum │ │ │ │ │ -00002d60: 6d61 7279 2061 7265 2063 6f6c 6f72 6564 mary are colored │ │ │ │ │ -00002d70: 2061 7070 726f 7072 6961 7465 6c79 2e20 appropriately. │ │ │ │ │ -00002d80: 2054 6865 2075 7365 7220 6361 6e20 6469 The user can di │ │ │ │ │ -00002d90: 7361 626c 650a 636f 6c6f 7265 6420 6f75 sable.colored ou │ │ │ │ │ -00002da0: 7470 7574 2062 7920 7365 7474 696e 6720 tput by setting │ │ │ │ │ -00002db0: 7468 6520 276d 616b 6527 2076 6172 6961 the 'make' varia │ │ │ │ │ -00002dc0: 626c 6520 2741 4d5f 434f 4c4f 525f 5445 ble 'AM_COLOR_TE │ │ │ │ │ -00002dd0: 5354 533d 6e6f 272c 206f 720a 666f 7263 STS=no', or.forc │ │ │ │ │ -00002de0: 6520 636f 6c6f 7265 6420 6f75 7470 7574 e colored output │ │ │ │ │ -00002df0: 2065 7665 6e20 7769 7468 6f75 7420 6120 even without a │ │ │ │ │ -00002e00: 636f 6e6e 6563 7469 6e67 2074 6572 6d69 connecting termi │ │ │ │ │ -00002e10: 6e61 6c20 7769 7468 0a27 414d 5f43 4f4c nal with.'AM_COL │ │ │ │ │ -00002e20: 4f52 5f54 4553 5453 3d61 6c77 6179 7327 OR_TESTS=always' │ │ │ │ │ -00002e30: 2e0a 0a20 2020 4e6f 7465 2074 6861 7420 ... Note that │ │ │ │ │ -00002e40: 7468 6520 7365 6d61 6e74 6963 7320 6f66 the semantics of │ │ │ │ │ -00002e50: 2073 6f6d 6520 276d 616b 6527 2069 6d70 some 'make' imp │ │ │ │ │ -00002e60: 6c65 6d65 6e74 6174 696f 6e73 2077 6865 lementations whe │ │ │ │ │ -00002e70: 6e20 7573 6564 2069 6e0a 7061 7261 6c6c n used in.parall │ │ │ │ │ -00002e80: 656c 206d 6f64 6520 282a 6e6f 7465 2028 el mode (*note ( │ │ │ │ │ -00002e90: 6175 746f 636f 6e66 2950 6172 616c 6c65 autoconf)Paralle │ │ │ │ │ -00002ea0: 6c20 6d61 6b65 3a3a 2920 6361 6e20 6361 l make::) can ca │ │ │ │ │ -00002eb0: 7573 6520 7468 6520 6175 746f 6d61 7469 use the automati │ │ │ │ │ -00002ec0: 630a 6465 7465 6374 696f 6e20 6f66 2061 c.detection of a │ │ │ │ │ -00002ed0: 2063 6f6e 6e65 6374 696f 6e20 746f 2061 connection to a │ │ │ │ │ -00002ee0: 2063 6170 6162 6c65 2074 6572 6d69 6e61 capable termina │ │ │ │ │ -00002ef0: 6c20 746f 2066 6169 6c2e 2020 496e 2074 l to fail. In t │ │ │ │ │ -00002f00: 6861 7420 6361 7365 2c0a 796f 7520 6361 hat case,.you ca │ │ │ │ │ -00002f10: 6e20 7374 696c 6c20 7265 736f 7274 2074 n still resort t │ │ │ │ │ -00002f20: 6f20 7468 6520 7573 6520 6f66 2027 414d o the use of 'AM │ │ │ │ │ -00002f30: 5f43 4f4c 4f52 5f54 4553 5453 3d61 6c77 _COLOR_TESTS=alw │ │ │ │ │ -00002f40: 6179 7327 2e0a 0a20 2020 5468 6520 7661 ays'... The va │ │ │ │ │ -00002f50: 7269 6162 6c65 2027 5445 5354 535f 454e riable 'TESTS_EN │ │ │ │ │ -00002f60: 5649 524f 4e4d 454e 5427 2063 616e 2062 VIRONMENT' can b │ │ │ │ │ -00002f70: 6520 7573 6564 2074 6f20 7365 7420 656e e used to set en │ │ │ │ │ -00002f80: 7669 726f 6e6d 656e 740a 7661 7269 6162 vironment.variab │ │ │ │ │ -00002f90: 6c65 7320 666f 7220 7468 6520 7465 7374 les for the test │ │ │ │ │ -00002fa0: 2072 756e 3b20 7468 6520 656e 7669 726f run; the enviro │ │ │ │ │ -00002fb0: 6e6d 656e 7420 7661 7269 6162 6c65 2027 nment variable ' │ │ │ │ │ -00002fc0: 7372 6364 6972 2720 6973 2073 6574 2069 srcdir' is set i │ │ │ │ │ -00002fd0: 6e0a 7468 6520 7275 6c65 2e20 2049 6620 n.the rule. If │ │ │ │ │ -00002fe0: 616c 6c20 796f 7572 2074 6573 7420 7072 all your test pr │ │ │ │ │ -00002ff0: 6f67 7261 6d73 2061 7265 2073 6372 6970 ograms are scrip │ │ │ │ │ -00003000: 7473 2c20 796f 7520 6361 6e20 616c 736f ts, you can also │ │ │ │ │ -00003010: 2073 6574 0a27 5445 5354 535f 454e 5649 set.'TESTS_ENVI │ │ │ │ │ -00003020: 524f 4e4d 454e 5427 2074 6f20 616e 2069 RONMENT' to an i │ │ │ │ │ -00003030: 6e76 6f63 6174 696f 6e20 6f66 2074 6865 nvocation of the │ │ │ │ │ -00003040: 2073 6865 6c6c 2028 652e 672e 2020 2724 shell (e.g. '$ │ │ │ │ │ -00003050: 2853 4845 4c4c 2920 2d78 270a 6361 6e20 (SHELL) -x'.can │ │ │ │ │ -00003060: 6265 2075 7365 6675 6c20 666f 7220 6465 be useful for de │ │ │ │ │ -00003070: 6275 6767 696e 6720 7468 6520 7465 7374 bugging the test │ │ │ │ │ -00003080: 7329 2c20 6f72 2061 6e79 206f 7468 6572 s), or any other │ │ │ │ │ -00003090: 2069 6e74 6572 7072 6574 6572 2e20 2046 interpreter. F │ │ │ │ │ -000030a0: 6f72 0a69 6e73 7461 6e63 652c 2074 6865 or.instance, the │ │ │ │ │ -000030b0: 2066 6f6c 6c6f 7769 6e67 2073 6574 7570 following setup │ │ │ │ │ -000030c0: 206d 6179 2062 6520 7573 6564 2074 6f20 may be used to │ │ │ │ │ -000030d0: 7275 6e20 7465 7374 7320 7769 7468 2050 run tests with P │ │ │ │ │ -000030e0: 6572 6c3a 0a0a 2020 2020 2054 4553 5453 erl:.. TESTS │ │ │ │ │ -000030f0: 5f45 4e56 4952 4f4e 4d45 4e54 203d 2024 _ENVIRONMENT = $ │ │ │ │ │ -00003100: 2850 4552 4c29 202d 4d73 7472 6963 7420 (PERL) -Mstrict │ │ │ │ │ -00003110: 2d77 0a20 2020 2020 5445 5354 5320 3d20 -w. TESTS = │ │ │ │ │ -00003120: 666f 6f2e 706c 2062 6172 2e70 6c20 6261 foo.pl bar.pl ba │ │ │ │ │ -00003130: 7a2e 706c 0a0a 2020 204e 6f74 6520 7468 z.pl.. Note th │ │ │ │ │ -00003140: 6174 2074 6865 2027 7061 7261 6c6c 656c at the 'parallel │ │ │ │ │ -00003150: 2d74 6573 7473 2720 6472 6976 6572 2070 -tests' driver p │ │ │ │ │ -00003160: 726f 7669 6465 7320 6120 6d6f 7265 2065 rovides a more e │ │ │ │ │ -00003170: 6c65 6761 6e74 2077 6179 2074 6f0a 6163 legant way to.ac │ │ │ │ │ -00003180: 6869 6576 6520 7468 6520 7361 6d65 2065 hieve the same e │ │ │ │ │ -00003190: 6666 6563 742c 2066 7265 6569 6e67 2074 ffect, freeing t │ │ │ │ │ -000031a0: 6865 2027 5445 5354 535f 454e 5649 524f he 'TESTS_ENVIRO │ │ │ │ │ -000031b0: 4e4d 454e 5427 2076 6172 6961 626c 6520 NMENT' variable │ │ │ │ │ -000031c0: 666f 720a 7468 6520 7573 6572 2074 6f20 for.the user to │ │ │ │ │ -000031d0: 6f76 6572 7269 6465 2028 2a6e 6f74 6520 override (*note │ │ │ │ │ -000031e0: 5369 6d70 6c65 2054 6573 7473 2075 7369 Simple Tests usi │ │ │ │ │ -000031f0: 6e67 2070 6172 616c 6c65 6c2d 7465 7374 ng parallel-test │ │ │ │ │ -00003200: 733a 3a29 2e0a 0a20 2020 596f 7520 6d61 s::)... You ma │ │ │ │ │ -00003210: 7920 6465 6669 6e65 2074 6865 2076 6172 y define the var │ │ │ │ │ -00003220: 6961 626c 6520 2758 4641 494c 5f54 4553 iable 'XFAIL_TES │ │ │ │ │ -00003230: 5453 2720 746f 2061 206c 6973 7420 6f66 TS' to a list of │ │ │ │ │ -00003240: 2074 6573 7473 2028 7573 7561 6c6c 790a tests (usually. │ │ │ │ │ -00003250: 6120 7375 6273 6574 206f 6620 2754 4553 a subset of 'TES │ │ │ │ │ -00003260: 5453 2729 2074 6861 7420 6172 6520 6578 TS') that are ex │ │ │ │ │ -00003270: 7065 6374 6564 2074 6f20 6661 696c 2e20 pected to fail. │ │ │ │ │ -00003280: 2054 6869 7320 7769 6c6c 2072 6576 6572 This will rever │ │ │ │ │ -00003290: 7365 2074 6865 0a72 6573 756c 7420 6f66 se the.result of │ │ │ │ │ -000032a0: 2074 686f 7365 2074 6573 7473 2e0a 0a20 those tests... │ │ │ │ │ -000032b0: 2020 4175 746f 6d61 6b65 2065 6e73 7572 Automake ensur │ │ │ │ │ -000032c0: 6573 2074 6861 7420 6561 6368 2066 696c es that each fil │ │ │ │ │ -000032d0: 6520 6c69 7374 6564 2069 6e20 2754 4553 e listed in 'TES │ │ │ │ │ -000032e0: 5453 2720 6973 2062 7569 6c74 2062 6566 TS' is built bef │ │ │ │ │ -000032f0: 6f72 6520 616e 790a 7465 7374 7320 6172 ore any.tests ar │ │ │ │ │ -00003300: 6520 7275 6e3b 2079 6f75 2063 616e 206c e run; you can l │ │ │ │ │ -00003310: 6973 7420 626f 7468 2073 6f75 7263 6520 ist both source │ │ │ │ │ -00003320: 616e 6420 6465 7269 7665 6420 7072 6f67 and derived prog │ │ │ │ │ -00003330: 7261 6d73 2028 6f72 0a73 6372 6970 7473 rams (or.scripts │ │ │ │ │ -00003340: 2920 696e 2027 5445 5354 5327 3b20 7468 ) in 'TESTS'; th │ │ │ │ │ -00003350: 6520 6765 6e65 7261 7465 6420 7275 6c65 e generated rule │ │ │ │ │ -00003360: 2077 696c 6c20 6c6f 6f6b 2062 6f74 6820 will look both │ │ │ │ │ -00003370: 696e 2027 7372 6364 6972 2720 616e 640a in 'srcdir' and. │ │ │ │ │ -00003380: 272e 272e 2020 466f 7220 696e 7374 616e '.'. For instan │ │ │ │ │ -00003390: 6365 2c20 796f 7520 6d69 6768 7420 7761 ce, you might wa │ │ │ │ │ -000033a0: 6e74 2074 6f20 7275 6e20 6120 4320 7072 nt to run a C pr │ │ │ │ │ -000033b0: 6f67 7261 6d20 6173 2061 2074 6573 742e ogram as a test. │ │ │ │ │ -000033c0: 2020 546f 2064 6f0a 7468 6973 2079 6f75 To do.this you │ │ │ │ │ -000033d0: 2077 6f75 6c64 206c 6973 7420 6974 7320 would list its │ │ │ │ │ -000033e0: 6e61 6d65 2069 6e20 2754 4553 5453 2720 name in 'TESTS' │ │ │ │ │ -000033f0: 616e 6420 616c 736f 2069 6e20 2763 6865 and also in 'che │ │ │ │ │ -00003400: 636b 5f50 524f 4752 414d 5327 2c0a 616e ck_PROGRAMS',.an │ │ │ │ │ -00003410: 6420 7468 656e 2073 7065 6369 6679 2069 d then specify i │ │ │ │ │ -00003420: 7420 6173 2079 6f75 2077 6f75 6c64 2061 t as you would a │ │ │ │ │ -00003430: 6e79 206f 7468 6572 2070 726f 6772 616d ny other program │ │ │ │ │ -00003440: 2e0a 0a20 2020 5072 6f67 7261 6d73 206c ... Programs l │ │ │ │ │ -00003450: 6973 7465 6420 696e 2027 6368 6563 6b5f isted in 'check_ │ │ │ │ │ -00003460: 5052 4f47 5241 4d53 2720 2861 6e64 2027 PROGRAMS' (and ' │ │ │ │ │ -00003470: 6368 6563 6b5f 4c49 4252 4152 4945 5327 check_LIBRARIES' │ │ │ │ │ -00003480: 2c0a 2763 6865 636b 5f4c 544c 4942 5241 ,.'check_LTLIBRA │ │ │ │ │ -00003490: 5249 4553 272e 2e2e 2920 2061 7265 206f RIES'...) are o │ │ │ │ │ -000034a0: 6e6c 7920 6275 696c 7420 6475 7269 6e67 nly built during │ │ │ │ │ -000034b0: 2027 6d61 6b65 2063 6865 636b 272c 206e 'make check', n │ │ │ │ │ -000034c0: 6f74 2064 7572 696e 670a 276d 616b 6520 ot during.'make │ │ │ │ │ -000034d0: 616c 6c27 2e20 2059 6f75 2073 686f 756c all'. You shoul │ │ │ │ │ -000034e0: 6420 6c69 7374 2074 6865 7265 2061 6e79 d list there any │ │ │ │ │ -000034f0: 2070 726f 6772 616d 206e 6565 6465 6420 program needed │ │ │ │ │ -00003500: 6279 2079 6f75 7220 7465 7374 7320 7468 by your tests th │ │ │ │ │ -00003510: 6174 0a64 6f65 7320 6e6f 7420 6e65 6564 at.does not need │ │ │ │ │ -00003520: 2074 6f20 6265 2062 7569 6c74 2062 7920 to be built by │ │ │ │ │ -00003530: 276d 616b 6520 616c 6c27 2e20 204e 6f74 'make all'. Not │ │ │ │ │ -00003540: 6520 7468 6174 2027 6368 6563 6b5f 5052 e that 'check_PR │ │ │ │ │ -00003550: 4f47 5241 4d53 2720 6172 650a 5f6e 6f74 OGRAMS' are._not │ │ │ │ │ -00003560: 5f20 6175 746f 6d61 7469 6361 6c6c 7920 _ automatically │ │ │ │ │ -00003570: 6164 6465 6420 746f 2027 5445 5354 5327 added to 'TESTS' │ │ │ │ │ -00003580: 2062 6563 6175 7365 2027 6368 6563 6b5f because 'check_ │ │ │ │ │ -00003590: 5052 4f47 5241 4d53 2720 7573 7561 6c6c PROGRAMS' usuall │ │ │ │ │ -000035a0: 790a 6c69 7374 7320 7072 6f67 7261 6d73 y.lists programs │ │ │ │ │ -000035b0: 2075 7365 6420 6279 2074 6865 2074 6573 used by the tes │ │ │ │ │ -000035c0: 7473 2c20 6e6f 7420 7468 6520 7465 7374 ts, not the test │ │ │ │ │ -000035d0: 7320 7468 656d 7365 6c76 6573 2e20 204f s themselves. O │ │ │ │ │ -000035e0: 6620 636f 7572 7365 0a79 6f75 2063 616e f course.you can │ │ │ │ │ -000035f0: 2073 6574 2027 5445 5354 5320 3d20 2428 set 'TESTS = $( │ │ │ │ │ -00003600: 6368 6563 6b5f 5052 4f47 5241 4d53 2927 check_PROGRAMS)' │ │ │ │ │ -00003610: 2069 6620 616c 6c20 796f 7572 2070 726f if all your pro │ │ │ │ │ -00003620: 6772 616d 7320 6172 6520 7465 7374 0a63 grams are test.c │ │ │ │ │ -00003630: 6173 6573 2e0a 0a1f 0a46 696c 653a 2061 ases.....File: a │ │ │ │ │ -00003640: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -00003650: 6f2c 2020 4e6f 6465 3a20 5369 6d70 6c65 o, Node: Simple │ │ │ │ │ -00003660: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ -00003670: 616c 6c65 6c2d 7465 7374 732c 2020 4e65 allel-tests, Ne │ │ │ │ │ -00003680: 7874 3a20 4465 6a61 476e 7520 5465 7374 xt: DejaGnu Test │ │ │ │ │ -00003690: 732c 2020 5072 6576 3a20 5369 6d70 6c65 s, Prev: Simple │ │ │ │ │ -000036a0: 2054 6573 7473 2c20 2055 703a 2054 6573 Tests, Up: Tes │ │ │ │ │ -000036b0: 7473 0a0a 3135 2e32 2053 696d 706c 6520 ts..15.2 Simple │ │ │ │ │ -000036c0: 5465 7374 7320 7573 696e 6720 2770 6172 Tests using 'par │ │ │ │ │ -000036d0: 616c 6c65 6c2d 7465 7374 7327 0a3d 3d3d allel-tests'.=== │ │ │ │ │ +00001f40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00001f50: 0a41 7574 6f6d 616b 6520 6765 6e65 7261 .Automake genera │ │ │ │ │ +00001f60: 7465 7320 7275 6c65 7320 746f 2070 726f tes rules to pro │ │ │ │ │ +00001f70: 7669 6465 2061 7263 6869 7665 7320 6f66 vide archives of │ │ │ │ │ +00001f80: 2074 6865 2070 726f 6a65 6374 2066 6f72 the project for │ │ │ │ │ +00001f90: 0a64 6973 7472 6962 7574 696f 6e73 2069 .distributions i │ │ │ │ │ +00001fa0: 6e20 7661 7269 6f75 7320 666f 726d 6174 n various format │ │ │ │ │ +00001fb0: 732e 2020 5468 6569 7220 7461 7267 6574 s. Their target │ │ │ │ │ +00001fc0: 7320 6172 653a 0a0a 2764 6973 742d 627a s are:..'dist-bz │ │ │ │ │ +00001fd0: 6970 3227 0a20 2020 2020 4765 6e65 7261 ip2'. Genera │ │ │ │ │ +00001fe0: 7465 2061 2062 7a69 7032 2074 6172 2061 te a bzip2 tar a │ │ │ │ │ +00001ff0: 7263 6869 7665 206f 6620 7468 6520 6469 rchive of the di │ │ │ │ │ +00002000: 7374 7269 6275 7469 6f6e 2e20 2062 7a69 stribution. bzi │ │ │ │ │ +00002010: 7032 2061 7263 6869 7665 730a 2020 2020 p2 archives. │ │ │ │ │ +00002020: 2061 7265 2066 7265 7175 656e 746c 7920 are frequently │ │ │ │ │ +00002030: 736d 616c 6c65 7220 7468 616e 2067 7a69 smaller than gzi │ │ │ │ │ +00002040: 7070 6564 2061 7263 6869 7665 732e 2020 pped archives. │ │ │ │ │ +00002050: 4279 2064 6566 6175 6c74 2c20 7468 6973 By default, this │ │ │ │ │ +00002060: 0a20 2020 2020 7275 6c65 206d 616b 6573 . rule makes │ │ │ │ │ +00002070: 2027 627a 6970 3227 2075 7365 2061 2063 'bzip2' use a c │ │ │ │ │ +00002080: 6f6d 7072 6573 7369 6f6e 206f 7074 696f ompression optio │ │ │ │ │ +00002090: 6e20 6f66 2027 2d39 272e 2020 546f 206d n of '-9'. To m │ │ │ │ │ +000020a0: 616b 6520 6974 0a20 2020 2020 7573 6520 ake it. use │ │ │ │ │ +000020b0: 6120 6469 6666 6572 656e 7420 6f6e 652c a different one, │ │ │ │ │ +000020c0: 2073 6574 2074 6865 2027 425a 4950 3227 set the 'BZIP2' │ │ │ │ │ +000020d0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +000020e0: 6961 626c 652e 2020 466f 720a 2020 2020 iable. For. │ │ │ │ │ +000020f0: 2065 7861 6d70 6c65 2c20 276d 616b 6520 example, 'make │ │ │ │ │ +00002100: 6469 7374 2d62 7a69 7032 2042 5a49 5032 dist-bzip2 BZIP2 │ │ │ │ │ +00002110: 3d2d 3727 2e0a 0a27 6469 7374 2d67 7a69 =-7'...'dist-gzi │ │ │ │ │ +00002120: 7027 0a20 2020 2020 4765 6e65 7261 7465 p'. Generate │ │ │ │ │ +00002130: 2061 2067 7a69 7020 7461 7220 6172 6368 a gzip tar arch │ │ │ │ │ +00002140: 6976 6520 6f66 2074 6865 2064 6973 7472 ive of the distr │ │ │ │ │ +00002150: 6962 7574 696f 6e2e 0a0a 2764 6973 742d ibution...'dist- │ │ │ │ │ +00002160: 6c7a 6970 270a 2020 2020 2047 656e 6572 lzip'. Gener │ │ │ │ │ +00002170: 6174 6520 6120 276c 7a69 7027 2074 6172 ate a 'lzip' tar │ │ │ │ │ +00002180: 2061 7263 6869 7665 206f 6620 7468 6520 archive of the │ │ │ │ │ +00002190: 6469 7374 7269 6275 7469 6f6e 2e20 2027 distribution. ' │ │ │ │ │ +000021a0: 6c7a 6970 2720 6172 6368 6976 6573 0a20 lzip' archives. │ │ │ │ │ +000021b0: 2020 2020 6172 6520 6672 6571 7565 6e74 are frequent │ │ │ │ │ +000021c0: 6c79 2073 6d61 6c6c 6572 2074 6861 6e20 ly smaller than │ │ │ │ │ +000021d0: 2762 7a69 7032 272d 636f 6d70 7265 7373 'bzip2'-compress │ │ │ │ │ +000021e0: 6564 2061 7263 6869 7665 732e 0a0a 2764 ed archives...'d │ │ │ │ │ +000021f0: 6973 742d 6c7a 6d61 270a 2020 2020 2047 ist-lzma'. G │ │ │ │ │ +00002200: 656e 6572 6174 6520 616e 2027 6c7a 6d61 enerate an 'lzma │ │ │ │ │ +00002210: 2720 7461 7220 6172 6368 6976 6520 6f66 ' tar archive of │ │ │ │ │ +00002220: 2074 6865 2064 6973 7472 6962 7574 696f the distributio │ │ │ │ │ +00002230: 6e2e 2020 5468 6520 276c 7a6d 6127 0a20 n. The 'lzma'. │ │ │ │ │ +00002240: 2020 2020 666f 726d 6174 2069 7320 6f62 format is ob │ │ │ │ │ +00002250: 736f 6c65 7465 2c20 796f 7520 7368 6f75 solete, you shou │ │ │ │ │ +00002260: 6c64 2075 7365 2074 6865 2027 787a 2720 ld use the 'xz' │ │ │ │ │ +00002270: 666f 726d 6174 2069 6e73 7465 6164 2e0a format instead.. │ │ │ │ │ +00002280: 2020 2020 205f 5375 7070 6f72 7420 666f _Support fo │ │ │ │ │ +00002290: 7220 276c 7a6d 6127 2d63 6f6d 7072 6573 r 'lzma'-compres │ │ │ │ │ +000022a0: 7365 6420 6172 6368 6976 6573 2077 696c sed archives wil │ │ │ │ │ +000022b0: 6c20 6265 2072 656d 6f76 6564 2069 6e20 l be removed in │ │ │ │ │ +000022c0: 7468 6520 6e65 7874 0a20 2020 2020 6d61 the next. ma │ │ │ │ │ +000022d0: 6a6f 7220 4175 746f 6d61 6b65 2072 656c jor Automake rel │ │ │ │ │ +000022e0: 6561 7365 2e5f 0a0a 2764 6973 742d 7368 ease._..'dist-sh │ │ │ │ │ +000022f0: 6172 270a 2020 2020 2047 656e 6572 6174 ar'. Generat │ │ │ │ │ +00002300: 6520 6120 7368 6172 2061 7263 6869 7665 e a shar archive │ │ │ │ │ +00002310: 206f 6620 7468 6520 6469 7374 7269 6275 of the distribu │ │ │ │ │ +00002320: 7469 6f6e 2e0a 0a27 6469 7374 2d78 7a27 tion...'dist-xz' │ │ │ │ │ +00002330: 0a20 2020 2020 4765 6e65 7261 7465 2061 . Generate a │ │ │ │ │ +00002340: 6e20 2778 7a27 2074 6172 2061 7263 6869 n 'xz' tar archi │ │ │ │ │ +00002350: 7665 206f 6620 7468 6520 6469 7374 7269 ve of the distri │ │ │ │ │ +00002360: 6275 7469 6f6e 2e20 2027 787a 2720 6172 bution. 'xz' ar │ │ │ │ │ +00002370: 6368 6976 6573 0a20 2020 2020 6172 6520 chives. are │ │ │ │ │ +00002380: 6672 6571 7565 6e74 6c79 2073 6d61 6c6c frequently small │ │ │ │ │ +00002390: 6572 2074 6861 6e20 2762 7a69 7032 272d er than 'bzip2'- │ │ │ │ │ +000023a0: 636f 6d70 7265 7373 6564 2061 7263 6869 compressed archi │ │ │ │ │ +000023b0: 7665 732e 2020 5468 6520 2778 7a27 0a20 ves. The 'xz'. │ │ │ │ │ +000023c0: 2020 2020 666f 726d 6174 2064 6973 706c format displ │ │ │ │ │ +000023d0: 6163 6573 2074 6865 206f 6273 6f6c 6574 aces the obsolet │ │ │ │ │ +000023e0: 6520 276c 7a6d 6127 2066 6f72 6d61 742e e 'lzma' format. │ │ │ │ │ +000023f0: 2020 4279 2064 6566 6175 6c74 2c20 7468 By default, th │ │ │ │ │ +00002400: 6973 2072 756c 650a 2020 2020 206d 616b is rule. mak │ │ │ │ │ +00002410: 6573 2027 787a 2720 7573 6520 6120 636f es 'xz' use a co │ │ │ │ │ +00002420: 6d70 7265 7373 696f 6e20 6f70 7469 6f6e mpression option │ │ │ │ │ +00002430: 206f 6620 272d 6527 2e20 2054 6f20 6d61 of '-e'. To ma │ │ │ │ │ +00002440: 6b65 2069 7420 7573 6520 610a 2020 2020 ke it use a. │ │ │ │ │ +00002450: 2064 6966 6665 7265 6e74 206f 6e65 2c20 different one, │ │ │ │ │ +00002460: 7365 7420 7468 6520 2758 5a5f 4f50 5427 set the 'XZ_OPT' │ │ │ │ │ +00002470: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +00002480: 6961 626c 652e 2020 466f 7220 6578 616d iable. For exam │ │ │ │ │ +00002490: 706c 652c 0a20 2020 2020 7275 6e20 7468 ple,. run th │ │ │ │ │ +000024a0: 6973 2063 6f6d 6d61 6e64 2074 6f20 7573 is command to us │ │ │ │ │ +000024b0: 6520 7468 6520 6465 6661 756c 7420 636f e the default co │ │ │ │ │ +000024c0: 6d70 7265 7373 696f 6e20 7261 7469 6f2c mpression ratio, │ │ │ │ │ +000024d0: 2062 7574 2077 6974 6820 610a 2020 2020 but with a. │ │ │ │ │ +000024e0: 2070 726f 6772 6573 7320 696e 6469 6361 progress indica │ │ │ │ │ +000024f0: 746f 723a 2027 6d61 6b65 2064 6973 742d tor: 'make dist- │ │ │ │ │ +00002500: 787a 2058 5a5f 4f50 543d 2d37 6527 2e0a xz XZ_OPT=-7e'.. │ │ │ │ │ +00002510: 0a27 6469 7374 2d7a 6970 270a 2020 2020 .'dist-zip'. │ │ │ │ │ +00002520: 2047 656e 6572 6174 6520 6120 7a69 7020 Generate a zip │ │ │ │ │ +00002530: 6172 6368 6976 6520 6f66 2074 6865 2064 archive of the d │ │ │ │ │ +00002540: 6973 7472 6962 7574 696f 6e2e 0a0a 2764 istribution...'d │ │ │ │ │ +00002550: 6973 742d 7461 725a 270a 2020 2020 2047 ist-tarZ'. G │ │ │ │ │ +00002560: 656e 6572 6174 6520 6120 636f 6d70 7265 enerate a compre │ │ │ │ │ +00002570: 7373 6564 2074 6172 2061 7263 6869 7665 ssed tar archive │ │ │ │ │ +00002580: 206f 6620 7468 6520 6469 7374 7269 6275 of the distribu │ │ │ │ │ +00002590: 7469 6f6e 2e0a 0a20 2020 5468 6520 7275 tion... The ru │ │ │ │ │ +000025a0: 6c65 2027 6469 7374 2720 2861 6e64 2069 le 'dist' (and i │ │ │ │ │ +000025b0: 7473 2068 6973 746f 7269 6361 6c20 7379 ts historical sy │ │ │ │ │ +000025c0: 6e6f 6e79 6d20 2764 6973 742d 616c 6c27 nonym 'dist-all' │ │ │ │ │ +000025d0: 2920 7769 6c6c 2063 7265 6174 650a 6172 ) will create.ar │ │ │ │ │ +000025e0: 6368 6976 6573 2069 6e20 616c 6c20 7468 chives in all th │ │ │ │ │ +000025f0: 6520 656e 6162 6c65 6420 666f 726d 6174 e enabled format │ │ │ │ │ +00002600: 732c 202a 6e6f 7465 204f 7074 696f 6e73 s, *note Options │ │ │ │ │ +00002610: 3a3a 2e20 2042 7920 6465 6661 756c 742c ::. By default, │ │ │ │ │ +00002620: 206f 6e6c 790a 7468 6520 2764 6973 742d only.the 'dist- │ │ │ │ │ +00002630: 677a 6970 2720 7461 7267 6574 2069 7320 gzip' target is │ │ │ │ │ +00002640: 686f 6f6b 6564 2074 6f20 2764 6973 7427 hooked to 'dist' │ │ │ │ │ +00002650: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +00002660: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +00002670: 4e6f 6465 3a20 5465 7374 732c 2020 4e65 Node: Tests, Ne │ │ │ │ │ +00002680: 7874 3a20 5265 6275 696c 6469 6e67 2c20 xt: Rebuilding, │ │ │ │ │ +00002690: 2050 7265 763a 2044 6973 742c 2020 5570 Prev: Dist, Up │ │ │ │ │ +000026a0: 3a20 546f 700a 0a31 3520 5375 7070 6f72 : Top..15 Suppor │ │ │ │ │ +000026b0: 7420 666f 7220 7465 7374 2073 7569 7465 t for test suite │ │ │ │ │ +000026c0: 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a s.************** │ │ │ │ │ +000026d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4175 ************..Au │ │ │ │ │ +000026e0: 746f 6d61 6b65 2073 7570 706f 7274 7320 tomake supports │ │ │ │ │ +000026f0: 7468 7265 6520 666f 726d 7320 6f66 2074 three forms of t │ │ │ │ │ +00002700: 6573 7420 7375 6974 6573 2c20 7468 6520 est suites, the │ │ │ │ │ +00002710: 6669 7273 7420 7477 6f20 6f66 2077 6869 first two of whi │ │ │ │ │ +00002720: 6368 2061 7265 0a76 6572 7920 7369 6d69 ch are.very simi │ │ │ │ │ +00002730: 6c61 722e 0a0a 2a20 4d65 6e75 3a0a 0a2a lar...* Menu:..* │ │ │ │ │ +00002740: 2053 696d 706c 6520 5465 7374 733a 3a20 Simple Tests:: │ │ │ │ │ +00002750: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ │ +00002760: 6973 7469 6e67 2070 726f 6772 616d 7320 isting programs │ │ │ │ │ +00002770: 616e 6420 7363 7269 7074 7320 696e 2027 and scripts in ' │ │ │ │ │ +00002780: 5445 5354 5327 0a2a 2053 696d 706c 6520 TESTS'.* Simple │ │ │ │ │ +00002790: 5465 7374 7320 7573 696e 6720 7061 7261 Tests using para │ │ │ │ │ +000027a0: 6c6c 656c 2d74 6573 7473 3a3a 2020 4d6f llel-tests:: Mo │ │ │ │ │ +000027b0: 7265 2070 6f77 6572 6675 6c20 7465 7374 re powerful test │ │ │ │ │ +000027c0: 2064 7269 7665 720a 2a20 4465 6a61 476e driver.* DejaGn │ │ │ │ │ +000027d0: 7520 5465 7374 733a 3a20 2020 2020 2020 u Tests:: │ │ │ │ │ +000027e0: 2020 2020 2020 2020 496e 7465 7266 6163 Interfac │ │ │ │ │ +000027f0: 696e 6720 7769 7468 2074 6865 2065 7874 ing with the ext │ │ │ │ │ +00002800: 6572 6e61 6c20 7465 7374 696e 6720 6672 ernal testing fr │ │ │ │ │ +00002810: 616d 6577 6f72 6b0a 2a20 496e 7374 616c amework.* Instal │ │ │ │ │ +00002820: 6c20 5465 7374 733a 3a20 2020 2020 2020 l Tests:: │ │ │ │ │ +00002830: 2020 2020 2020 2020 5275 6e6e 696e 6720 Running │ │ │ │ │ +00002840: 7465 7374 7320 6f6e 2069 6e73 7461 6c6c tests on install │ │ │ │ │ +00002850: 6564 2070 6163 6b61 6765 730a 0a1f 0a46 ed packages....F │ │ │ │ │ +00002860: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +00002870: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +00002880: 5369 6d70 6c65 2054 6573 7473 2c20 204e Simple Tests, N │ │ │ │ │ +00002890: 6578 743a 2053 696d 706c 6520 5465 7374 ext: Simple Test │ │ │ │ │ +000028a0: 7320 7573 696e 6720 7061 7261 6c6c 656c s using parallel │ │ │ │ │ +000028b0: 2d74 6573 7473 2c20 2055 703a 2054 6573 -tests, Up: Tes │ │ │ │ │ +000028c0: 7473 0a0a 3135 2e31 2053 696d 706c 6520 ts..15.1 Simple │ │ │ │ │ +000028d0: 5465 7374 730a 3d3d 3d3d 3d3d 3d3d 3d3d Tests.========== │ │ │ │ │ +000028e0: 3d3d 3d3d 3d3d 3d0a 0a49 6620 7468 6520 =======..If the │ │ │ │ │ +000028f0: 7661 7269 6162 6c65 2027 5445 5354 5327 variable 'TESTS' │ │ │ │ │ +00002900: 2069 7320 6465 6669 6e65 642c 2069 7473 is defined, its │ │ │ │ │ +00002910: 2076 616c 7565 2069 7320 7461 6b65 6e20 value is taken │ │ │ │ │ +00002920: 746f 2062 6520 6120 6c69 7374 206f 660a to be a list of. │ │ │ │ │ +00002930: 7072 6f67 7261 6d73 206f 7220 7363 7269 programs or scri │ │ │ │ │ +00002940: 7074 7320 746f 2072 756e 2069 6e20 6f72 pts to run in or │ │ │ │ │ +00002950: 6465 7220 746f 2064 6f20 7468 6520 7465 der to do the te │ │ │ │ │ +00002960: 7374 696e 672e 2020 5072 6f67 7261 6d73 sting. Programs │ │ │ │ │ +00002970: 206e 6565 6469 6e67 0a64 6174 6120 6669 needing.data fi │ │ │ │ │ +00002980: 6c65 7320 7368 6f75 6c64 206c 6f6f 6b20 les should look │ │ │ │ │ +00002990: 666f 7220 7468 656d 2069 6e20 2773 7263 for them in 'src │ │ │ │ │ +000029a0: 6469 7227 2028 7768 6963 6820 6973 2062 dir' (which is b │ │ │ │ │ +000029b0: 6f74 6820 616e 0a65 6e76 6972 6f6e 6d65 oth an.environme │ │ │ │ │ +000029c0: 6e74 2076 6172 6961 626c 6520 616e 6420 nt variable and │ │ │ │ │ +000029d0: 6120 6d61 6b65 2076 6172 6961 626c 6529 a make variable) │ │ │ │ │ +000029e0: 2073 6f20 7468 6579 2077 6f72 6b20 7768 so they work wh │ │ │ │ │ +000029f0: 656e 2062 7569 6c64 696e 6720 696e 0a61 en building in.a │ │ │ │ │ +00002a00: 2073 6570 6172 6174 6520 6469 7265 6374 separate direct │ │ │ │ │ +00002a10: 6f72 7920 282a 6e6f 7465 2042 7569 6c64 ory (*note Build │ │ │ │ │ +00002a20: 2044 6972 6563 746f 7269 6573 3a20 2861 Directories: (a │ │ │ │ │ +00002a30: 7574 6f63 6f6e 6629 4275 696c 640a 4469 utoconf)Build.Di │ │ │ │ │ +00002a40: 7265 6374 6f72 6965 732e 292c 2061 6e64 rectories.), and │ │ │ │ │ +00002a50: 2069 6e20 7061 7274 6963 756c 6172 2066 in particular f │ │ │ │ │ +00002a60: 6f72 2074 6865 2027 6469 7374 6368 6563 or the 'distchec │ │ │ │ │ +00002a70: 6b27 2072 756c 6520 282a 6e6f 7465 0a43 k' rule (*note.C │ │ │ │ │ +00002a80: 6865 636b 696e 6720 7468 6520 4469 7374 hecking the Dist │ │ │ │ │ +00002a90: 7269 6275 7469 6f6e 3a3a 292e 0a0a 2020 ribution::)... │ │ │ │ │ +00002aa0: 2046 6f72 2065 6163 6820 6f66 2074 6865 For each of the │ │ │ │ │ +00002ab0: 2027 5445 5354 5327 2c20 7468 6520 7265 'TESTS', the re │ │ │ │ │ +00002ac0: 7375 6c74 206f 6620 6578 6563 7574 696f sult of executio │ │ │ │ │ +00002ad0: 6e20 6973 2070 7269 6e74 6564 2061 6c6f n is printed alo │ │ │ │ │ +00002ae0: 6e67 0a77 6974 6820 7468 6520 7465 7374 ng.with the test │ │ │ │ │ +00002af0: 206e 616d 652c 2077 6865 7265 2027 5041 name, where 'PA │ │ │ │ │ +00002b00: 5353 2720 6465 6e6f 7465 7320 6120 7375 SS' denotes a su │ │ │ │ │ +00002b10: 6363 6573 7366 756c 2074 6573 742c 2027 ccessful test, ' │ │ │ │ │ +00002b20: 4641 494c 270a 6465 6e6f 7465 7320 6120 FAIL'.denotes a │ │ │ │ │ +00002b30: 6661 696c 6564 2074 6573 742c 2027 5846 failed test, 'XF │ │ │ │ │ +00002b40: 4149 4c27 2061 6e20 6578 7065 6374 6564 AIL' an expected │ │ │ │ │ +00002b50: 2066 6169 6c75 7265 2c20 2758 5041 5353 failure, 'XPASS │ │ │ │ │ +00002b60: 2720 616e 0a75 6e65 7870 6563 7465 6420 ' an.unexpected │ │ │ │ │ +00002b70: 7061 7373 2066 6f72 2061 2074 6573 7420 pass for a test │ │ │ │ │ +00002b80: 7468 6174 2069 7320 7375 7070 6f73 6564 that is supposed │ │ │ │ │ +00002b90: 2074 6f20 6661 696c 2c20 616e 6420 2753 to fail, and 'S │ │ │ │ │ +00002ba0: 4b49 5027 2064 656e 6f74 6573 0a61 2073 KIP' denotes.a s │ │ │ │ │ +00002bb0: 6b69 7070 6564 2074 6573 742e 0a0a 2020 kipped test... │ │ │ │ │ +00002bc0: 2054 6865 206e 756d 6265 7220 6f66 2066 The number of f │ │ │ │ │ +00002bd0: 6169 6c75 7265 7320 7769 6c6c 2062 6520 ailures will be │ │ │ │ │ +00002be0: 7072 696e 7465 6420 6174 2074 6865 2065 printed at the e │ │ │ │ │ +00002bf0: 6e64 206f 6620 7468 6520 7275 6e2e 2020 nd of the run. │ │ │ │ │ +00002c00: 4966 2061 0a67 6976 656e 2074 6573 7420 If a.given test │ │ │ │ │ +00002c10: 7072 6f67 7261 6d20 6578 6974 7320 7769 program exits wi │ │ │ │ │ +00002c20: 7468 2061 2073 7461 7475 7320 6f66 2037 th a status of 7 │ │ │ │ │ +00002c30: 372c 2074 6865 6e20 6974 7320 7265 7375 7, then its resu │ │ │ │ │ +00002c40: 6c74 2069 7320 6967 6e6f 7265 640a 696e lt is ignored.in │ │ │ │ │ +00002c50: 2074 6865 2066 696e 616c 2063 6f75 6e74 the final count │ │ │ │ │ +00002c60: 2e20 2054 6869 7320 6665 6174 7572 6520 . This feature │ │ │ │ │ +00002c70: 616c 6c6f 7773 206e 6f6e 2d70 6f72 7461 allows non-porta │ │ │ │ │ +00002c80: 626c 6520 7465 7374 7320 746f 2062 650a ble tests to be. │ │ │ │ │ +00002c90: 6967 6e6f 7265 6420 696e 2065 6e76 6972 ignored in envir │ │ │ │ │ +00002ca0: 6f6e 6d65 6e74 7320 7768 6572 6520 7468 onments where th │ │ │ │ │ +00002cb0: 6579 2064 6f6e 2774 206d 616b 6520 7365 ey don't make se │ │ │ │ │ +00002cc0: 6e73 652e 0a0a 2020 2049 6620 7468 6520 nse... If the │ │ │ │ │ +00002cd0: 4175 746f 6d61 6b65 206f 7074 696f 6e20 Automake option │ │ │ │ │ +00002ce0: 2763 6f6c 6f72 2d74 6573 7473 2720 6973 'color-tests' is │ │ │ │ │ +00002cf0: 2075 7365 6420 282a 6e6f 7465 204f 7074 used (*note Opt │ │ │ │ │ +00002d00: 696f 6e73 3a3a 2920 616e 640a 7374 616e ions::) and.stan │ │ │ │ │ +00002d10: 6461 7264 206f 7574 7075 7420 6973 2063 dard output is c │ │ │ │ │ +00002d20: 6f6e 6e65 6374 6564 2074 6f20 6120 6361 onnected to a ca │ │ │ │ │ +00002d30: 7061 626c 6520 7465 726d 696e 616c 2c20 pable terminal, │ │ │ │ │ +00002d40: 7468 656e 2074 6865 2074 6573 740a 7265 then the test.re │ │ │ │ │ +00002d50: 7375 6c74 7320 616e 6420 7468 6520 7375 sults and the su │ │ │ │ │ +00002d60: 6d6d 6172 7920 6172 6520 636f 6c6f 7265 mmary are colore │ │ │ │ │ +00002d70: 6420 6170 7072 6f70 7269 6174 656c 792e d appropriately. │ │ │ │ │ +00002d80: 2020 5468 6520 7573 6572 2063 616e 2064 The user can d │ │ │ │ │ +00002d90: 6973 6162 6c65 0a63 6f6c 6f72 6564 206f isable.colored o │ │ │ │ │ +00002da0: 7574 7075 7420 6279 2073 6574 7469 6e67 utput by setting │ │ │ │ │ +00002db0: 2074 6865 2027 6d61 6b65 2720 7661 7269 the 'make' vari │ │ │ │ │ +00002dc0: 6162 6c65 2027 414d 5f43 4f4c 4f52 5f54 able 'AM_COLOR_T │ │ │ │ │ +00002dd0: 4553 5453 3d6e 6f27 2c20 6f72 0a66 6f72 ESTS=no', or.for │ │ │ │ │ +00002de0: 6365 2063 6f6c 6f72 6564 206f 7574 7075 ce colored outpu │ │ │ │ │ +00002df0: 7420 6576 656e 2077 6974 686f 7574 2061 t even without a │ │ │ │ │ +00002e00: 2063 6f6e 6e65 6374 696e 6720 7465 726d connecting term │ │ │ │ │ +00002e10: 696e 616c 2077 6974 680a 2741 4d5f 434f inal with.'AM_CO │ │ │ │ │ +00002e20: 4c4f 525f 5445 5354 533d 616c 7761 7973 LOR_TESTS=always │ │ │ │ │ +00002e30: 272e 0a0a 2020 204e 6f74 6520 7468 6174 '... Note that │ │ │ │ │ +00002e40: 2074 6865 2073 656d 616e 7469 6373 206f the semantics o │ │ │ │ │ +00002e50: 6620 736f 6d65 2027 6d61 6b65 2720 696d f some 'make' im │ │ │ │ │ +00002e60: 706c 656d 656e 7461 7469 6f6e 7320 7768 plementations wh │ │ │ │ │ +00002e70: 656e 2075 7365 6420 696e 0a70 6172 616c en used in.paral │ │ │ │ │ +00002e80: 6c65 6c20 6d6f 6465 2028 2a6e 6f74 6520 lel mode (*note │ │ │ │ │ +00002e90: 2861 7574 6f63 6f6e 6629 5061 7261 6c6c (autoconf)Parall │ │ │ │ │ +00002ea0: 656c 206d 616b 653a 3a29 2063 616e 2063 el make::) can c │ │ │ │ │ +00002eb0: 6175 7365 2074 6865 2061 7574 6f6d 6174 ause the automat │ │ │ │ │ +00002ec0: 6963 0a64 6574 6563 7469 6f6e 206f 6620 ic.detection of │ │ │ │ │ +00002ed0: 6120 636f 6e6e 6563 7469 6f6e 2074 6f20 a connection to │ │ │ │ │ +00002ee0: 6120 6361 7061 626c 6520 7465 726d 696e a capable termin │ │ │ │ │ +00002ef0: 616c 2074 6f20 6661 696c 2e20 2049 6e20 al to fail. In │ │ │ │ │ +00002f00: 7468 6174 2063 6173 652c 0a79 6f75 2063 that case,.you c │ │ │ │ │ +00002f10: 616e 2073 7469 6c6c 2072 6573 6f72 7420 an still resort │ │ │ │ │ +00002f20: 746f 2074 6865 2075 7365 206f 6620 2741 to the use of 'A │ │ │ │ │ +00002f30: 4d5f 434f 4c4f 525f 5445 5354 533d 616c M_COLOR_TESTS=al │ │ │ │ │ +00002f40: 7761 7973 272e 0a0a 2020 2054 6865 2076 ways'... The v │ │ │ │ │ +00002f50: 6172 6961 626c 6520 2754 4553 5453 5f45 ariable 'TESTS_E │ │ │ │ │ +00002f60: 4e56 4952 4f4e 4d45 4e54 2720 6361 6e20 NVIRONMENT' can │ │ │ │ │ +00002f70: 6265 2075 7365 6420 746f 2073 6574 2065 be used to set e │ │ │ │ │ +00002f80: 6e76 6972 6f6e 6d65 6e74 0a76 6172 6961 nvironment.varia │ │ │ │ │ +00002f90: 626c 6573 2066 6f72 2074 6865 2074 6573 bles for the tes │ │ │ │ │ +00002fa0: 7420 7275 6e3b 2074 6865 2065 6e76 6972 t run; the envir │ │ │ │ │ +00002fb0: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ │ +00002fc0: 2773 7263 6469 7227 2069 7320 7365 7420 'srcdir' is set │ │ │ │ │ +00002fd0: 696e 0a74 6865 2072 756c 652e 2020 4966 in.the rule. If │ │ │ │ │ +00002fe0: 2061 6c6c 2079 6f75 7220 7465 7374 2070 all your test p │ │ │ │ │ +00002ff0: 726f 6772 616d 7320 6172 6520 7363 7269 rograms are scri │ │ │ │ │ +00003000: 7074 732c 2079 6f75 2063 616e 2061 6c73 pts, you can als │ │ │ │ │ +00003010: 6f20 7365 740a 2754 4553 5453 5f45 4e56 o set.'TESTS_ENV │ │ │ │ │ +00003020: 4952 4f4e 4d45 4e54 2720 746f 2061 6e20 IRONMENT' to an │ │ │ │ │ +00003030: 696e 766f 6361 7469 6f6e 206f 6620 7468 invocation of th │ │ │ │ │ +00003040: 6520 7368 656c 6c20 2865 2e67 2e20 2027 e shell (e.g. ' │ │ │ │ │ +00003050: 2428 5348 454c 4c29 202d 7827 0a63 616e $(SHELL) -x'.can │ │ │ │ │ +00003060: 2062 6520 7573 6566 756c 2066 6f72 2064 be useful for d │ │ │ │ │ +00003070: 6562 7567 6769 6e67 2074 6865 2074 6573 ebugging the tes │ │ │ │ │ +00003080: 7473 292c 206f 7220 616e 7920 6f74 6865 ts), or any othe │ │ │ │ │ +00003090: 7220 696e 7465 7270 7265 7465 722e 2020 r interpreter. │ │ │ │ │ +000030a0: 466f 720a 696e 7374 616e 6365 2c20 7468 For.instance, th │ │ │ │ │ +000030b0: 6520 666f 6c6c 6f77 696e 6720 7365 7475 e following setu │ │ │ │ │ +000030c0: 7020 6d61 7920 6265 2075 7365 6420 746f p may be used to │ │ │ │ │ +000030d0: 2072 756e 2074 6573 7473 2077 6974 6820 run tests with │ │ │ │ │ +000030e0: 5065 726c 3a0a 0a20 2020 2020 5445 5354 Perl:.. TEST │ │ │ │ │ +000030f0: 535f 454e 5649 524f 4e4d 454e 5420 3d20 S_ENVIRONMENT = │ │ │ │ │ +00003100: 2428 5045 524c 2920 2d4d 7374 7269 6374 $(PERL) -Mstrict │ │ │ │ │ +00003110: 202d 770a 2020 2020 2054 4553 5453 203d -w. TESTS = │ │ │ │ │ +00003120: 2066 6f6f 2e70 6c20 6261 722e 706c 2062 foo.pl bar.pl b │ │ │ │ │ +00003130: 617a 2e70 6c0a 0a20 2020 4e6f 7465 2074 az.pl.. Note t │ │ │ │ │ +00003140: 6861 7420 7468 6520 2770 6172 616c 6c65 hat the 'paralle │ │ │ │ │ +00003150: 6c2d 7465 7374 7327 2064 7269 7665 7220 l-tests' driver │ │ │ │ │ +00003160: 7072 6f76 6964 6573 2061 206d 6f72 6520 provides a more │ │ │ │ │ +00003170: 656c 6567 616e 7420 7761 7920 746f 0a61 elegant way to.a │ │ │ │ │ +00003180: 6368 6965 7665 2074 6865 2073 616d 6520 chieve the same │ │ │ │ │ +00003190: 6566 6665 6374 2c20 6672 6565 696e 6720 effect, freeing │ │ │ │ │ +000031a0: 7468 6520 2754 4553 5453 5f45 4e56 4952 the 'TESTS_ENVIR │ │ │ │ │ +000031b0: 4f4e 4d45 4e54 2720 7661 7269 6162 6c65 ONMENT' variable │ │ │ │ │ +000031c0: 2066 6f72 0a74 6865 2075 7365 7220 746f for.the user to │ │ │ │ │ +000031d0: 206f 7665 7272 6964 6520 282a 6e6f 7465 override (*note │ │ │ │ │ +000031e0: 2053 696d 706c 6520 5465 7374 7320 7573 Simple Tests us │ │ │ │ │ +000031f0: 696e 6720 7061 7261 6c6c 656c 2d74 6573 ing parallel-tes │ │ │ │ │ +00003200: 7473 3a3a 292e 0a0a 2020 2059 6f75 206d ts::)... You m │ │ │ │ │ +00003210: 6179 2064 6566 696e 6520 7468 6520 7661 ay define the va │ │ │ │ │ +00003220: 7269 6162 6c65 2027 5846 4149 4c5f 5445 riable 'XFAIL_TE │ │ │ │ │ +00003230: 5354 5327 2074 6f20 6120 6c69 7374 206f STS' to a list o │ │ │ │ │ +00003240: 6620 7465 7374 7320 2875 7375 616c 6c79 f tests (usually │ │ │ │ │ +00003250: 0a61 2073 7562 7365 7420 6f66 2027 5445 .a subset of 'TE │ │ │ │ │ +00003260: 5354 5327 2920 7468 6174 2061 7265 2065 STS') that are e │ │ │ │ │ +00003270: 7870 6563 7465 6420 746f 2066 6169 6c2e xpected to fail. │ │ │ │ │ +00003280: 2020 5468 6973 2077 696c 6c20 7265 7665 This will reve │ │ │ │ │ +00003290: 7273 6520 7468 650a 7265 7375 6c74 206f rse the.result o │ │ │ │ │ +000032a0: 6620 7468 6f73 6520 7465 7374 732e 0a0a f those tests... │ │ │ │ │ +000032b0: 2020 2041 7574 6f6d 616b 6520 656e 7375 Automake ensu │ │ │ │ │ +000032c0: 7265 7320 7468 6174 2065 6163 6820 6669 res that each fi │ │ │ │ │ +000032d0: 6c65 206c 6973 7465 6420 696e 2027 5445 le listed in 'TE │ │ │ │ │ +000032e0: 5354 5327 2069 7320 6275 696c 7420 6265 STS' is built be │ │ │ │ │ +000032f0: 666f 7265 2061 6e79 0a74 6573 7473 2061 fore any.tests a │ │ │ │ │ +00003300: 7265 2072 756e 3b20 796f 7520 6361 6e20 re run; you can │ │ │ │ │ +00003310: 6c69 7374 2062 6f74 6820 736f 7572 6365 list both source │ │ │ │ │ +00003320: 2061 6e64 2064 6572 6976 6564 2070 726f and derived pro │ │ │ │ │ +00003330: 6772 616d 7320 286f 720a 7363 7269 7074 grams (or.script │ │ │ │ │ +00003340: 7329 2069 6e20 2754 4553 5453 273b 2074 s) in 'TESTS'; t │ │ │ │ │ +00003350: 6865 2067 656e 6572 6174 6564 2072 756c he generated rul │ │ │ │ │ +00003360: 6520 7769 6c6c 206c 6f6f 6b20 626f 7468 e will look both │ │ │ │ │ +00003370: 2069 6e20 2773 7263 6469 7227 2061 6e64 in 'srcdir' and │ │ │ │ │ +00003380: 0a27 2e27 2e20 2046 6f72 2069 6e73 7461 .'.'. For insta │ │ │ │ │ +00003390: 6e63 652c 2079 6f75 206d 6967 6874 2077 nce, you might w │ │ │ │ │ +000033a0: 616e 7420 746f 2072 756e 2061 2043 2070 ant to run a C p │ │ │ │ │ +000033b0: 726f 6772 616d 2061 7320 6120 7465 7374 rogram as a test │ │ │ │ │ +000033c0: 2e20 2054 6f20 646f 0a74 6869 7320 796f . To do.this yo │ │ │ │ │ +000033d0: 7520 776f 756c 6420 6c69 7374 2069 7473 u would list its │ │ │ │ │ +000033e0: 206e 616d 6520 696e 2027 5445 5354 5327 name in 'TESTS' │ │ │ │ │ +000033f0: 2061 6e64 2061 6c73 6f20 696e 2027 6368 and also in 'ch │ │ │ │ │ +00003400: 6563 6b5f 5052 4f47 5241 4d53 272c 0a61 eck_PROGRAMS',.a │ │ │ │ │ +00003410: 6e64 2074 6865 6e20 7370 6563 6966 7920 nd then specify │ │ │ │ │ +00003420: 6974 2061 7320 796f 7520 776f 756c 6420 it as you would │ │ │ │ │ +00003430: 616e 7920 6f74 6865 7220 7072 6f67 7261 any other progra │ │ │ │ │ +00003440: 6d2e 0a0a 2020 2050 726f 6772 616d 7320 m... Programs │ │ │ │ │ +00003450: 6c69 7374 6564 2069 6e20 2763 6865 636b listed in 'check │ │ │ │ │ +00003460: 5f50 524f 4752 414d 5327 2028 616e 6420 _PROGRAMS' (and │ │ │ │ │ +00003470: 2763 6865 636b 5f4c 4942 5241 5249 4553 'check_LIBRARIES │ │ │ │ │ +00003480: 272c 0a27 6368 6563 6b5f 4c54 4c49 4252 ',.'check_LTLIBR │ │ │ │ │ +00003490: 4152 4945 5327 2e2e 2e29 2020 6172 6520 ARIES'...) are │ │ │ │ │ +000034a0: 6f6e 6c79 2062 7569 6c74 2064 7572 696e only built durin │ │ │ │ │ +000034b0: 6720 276d 616b 6520 6368 6563 6b27 2c20 g 'make check', │ │ │ │ │ +000034c0: 6e6f 7420 6475 7269 6e67 0a27 6d61 6b65 not during.'make │ │ │ │ │ +000034d0: 2061 6c6c 272e 2020 596f 7520 7368 6f75 all'. You shou │ │ │ │ │ +000034e0: 6c64 206c 6973 7420 7468 6572 6520 616e ld list there an │ │ │ │ │ +000034f0: 7920 7072 6f67 7261 6d20 6e65 6564 6564 y program needed │ │ │ │ │ +00003500: 2062 7920 796f 7572 2074 6573 7473 2074 by your tests t │ │ │ │ │ +00003510: 6861 740a 646f 6573 206e 6f74 206e 6565 hat.does not nee │ │ │ │ │ +00003520: 6420 746f 2062 6520 6275 696c 7420 6279 d to be built by │ │ │ │ │ +00003530: 2027 6d61 6b65 2061 6c6c 272e 2020 4e6f 'make all'. No │ │ │ │ │ +00003540: 7465 2074 6861 7420 2763 6865 636b 5f50 te that 'check_P │ │ │ │ │ +00003550: 524f 4752 414d 5327 2061 7265 0a5f 6e6f ROGRAMS' are._no │ │ │ │ │ +00003560: 745f 2061 7574 6f6d 6174 6963 616c 6c79 t_ automatically │ │ │ │ │ +00003570: 2061 6464 6564 2074 6f20 2754 4553 5453 added to 'TESTS │ │ │ │ │ +00003580: 2720 6265 6361 7573 6520 2763 6865 636b ' because 'check │ │ │ │ │ +00003590: 5f50 524f 4752 414d 5327 2075 7375 616c _PROGRAMS' usual │ │ │ │ │ +000035a0: 6c79 0a6c 6973 7473 2070 726f 6772 616d ly.lists program │ │ │ │ │ +000035b0: 7320 7573 6564 2062 7920 7468 6520 7465 s used by the te │ │ │ │ │ +000035c0: 7374 732c 206e 6f74 2074 6865 2074 6573 sts, not the tes │ │ │ │ │ +000035d0: 7473 2074 6865 6d73 656c 7665 732e 2020 ts themselves. │ │ │ │ │ +000035e0: 4f66 2063 6f75 7273 650a 796f 7520 6361 Of course.you ca │ │ │ │ │ +000035f0: 6e20 7365 7420 2754 4553 5453 203d 2024 n set 'TESTS = $ │ │ │ │ │ +00003600: 2863 6865 636b 5f50 524f 4752 414d 5329 (check_PROGRAMS) │ │ │ │ │ +00003610: 2720 6966 2061 6c6c 2079 6f75 7220 7072 ' if all your pr │ │ │ │ │ +00003620: 6f67 7261 6d73 2061 7265 2074 6573 740a ograms are test. │ │ │ │ │ +00003630: 6361 7365 732e 0a0a 1f0a 4669 6c65 3a20 cases.....File: │ │ │ │ │ +00003640: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +00003650: 666f 2c20 204e 6f64 653a 2053 696d 706c fo, Node: Simpl │ │ │ │ │ +00003660: 6520 5465 7374 7320 7573 696e 6720 7061 e Tests using pa │ │ │ │ │ +00003670: 7261 6c6c 656c 2d74 6573 7473 2c20 204e rallel-tests, N │ │ │ │ │ +00003680: 6578 743a 2044 656a 6147 6e75 2054 6573 ext: DejaGnu Tes │ │ │ │ │ +00003690: 7473 2c20 2050 7265 763a 2053 696d 706c ts, Prev: Simpl │ │ │ │ │ +000036a0: 6520 5465 7374 732c 2020 5570 3a20 5465 e Tests, Up: Te │ │ │ │ │ +000036b0: 7374 730a 0a31 352e 3220 5369 6d70 6c65 sts..15.2 Simple │ │ │ │ │ +000036c0: 2054 6573 7473 2075 7369 6e67 2027 7061 Tests using 'pa │ │ │ │ │ +000036d0: 7261 6c6c 656c 2d74 6573 7473 270a 3d3d rallel-tests'.== │ │ │ │ │ 000036e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000036f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00003700: 3d3d 3d3d 3d0a 0a54 6865 206f 7074 696f =====..The optio │ │ │ │ │ -00003710: 6e20 2770 6172 616c 6c65 6c2d 7465 7374 n 'parallel-test │ │ │ │ │ -00003720: 7327 2028 2a6e 6f74 6520 4f70 7469 6f6e s' (*note Option │ │ │ │ │ -00003730: 733a 3a29 2065 6e61 626c 6573 2061 2074 s::) enables a t │ │ │ │ │ -00003740: 6573 7420 7375 6974 650a 6472 6976 6572 est suite.driver │ │ │ │ │ -00003750: 2074 6861 7420 6973 206d 6f73 746c 7920 that is mostly │ │ │ │ │ -00003760: 636f 6d70 6174 6962 6c65 2074 6f20 7468 compatible to th │ │ │ │ │ -00003770: 6520 7369 6d70 6c65 2074 6573 7420 6472 e simple test dr │ │ │ │ │ -00003780: 6976 6572 2064 6573 6372 6962 6564 2069 iver described i │ │ │ │ │ -00003790: 6e0a 7468 6520 7072 6576 696f 7573 2073 n.the previous s │ │ │ │ │ -000037a0: 6563 7469 6f6e 2c20 6275 7420 7072 6f76 ection, but prov │ │ │ │ │ -000037b0: 6964 6573 2061 2066 6577 206d 6f72 6520 ides a few more │ │ │ │ │ -000037c0: 6665 6174 7572 6573 2061 6e64 2073 6c69 features and sli │ │ │ │ │ -000037d0: 6768 746c 790a 6469 6666 6572 656e 7420 ghtly.different │ │ │ │ │ -000037e0: 7365 6d61 6e74 6963 732e 2020 4974 2066 semantics. It f │ │ │ │ │ -000037f0: 6561 7475 7265 7320 636f 6e63 7572 7265 eatures concurre │ │ │ │ │ -00003800: 6e74 2065 7865 6375 7469 6f6e 206f 6620 nt execution of │ │ │ │ │ -00003810: 7465 7374 7320 7769 7468 0a27 6d61 6b65 tests with.'make │ │ │ │ │ -00003820: 202d 6a27 2061 6e64 2061 7574 6f6d 6174 -j' and automat │ │ │ │ │ -00003830: 6963 2063 6f6c 6c65 6374 696f 6e20 6f66 ic collection of │ │ │ │ │ -00003840: 2074 6865 2074 6573 7420 7363 7269 7074 the test script │ │ │ │ │ -00003850: 7320 6f75 7470 7574 2061 6e64 0a73 756d s output and.sum │ │ │ │ │ -00003860: 6d61 7279 2074 6865 7265 6f66 2069 6e20 mary thereof in │ │ │ │ │ -00003870: 272e 6c6f 6727 2066 696c 6573 2c20 616e '.log' files, an │ │ │ │ │ -00003880: 6420 616c 6c6f 7773 2074 6f20 7370 6563 d allows to spec │ │ │ │ │ -00003890: 6966 7920 696e 7465 722d 7465 7374 0a64 ify inter-test.d │ │ │ │ │ -000038a0: 6570 656e 6465 6e63 6965 732c 206c 617a ependencies, laz │ │ │ │ │ -000038b0: 7920 7265 7275 6e73 206f 6620 7465 7374 y reruns of test │ │ │ │ │ -000038c0: 7320 7468 6174 2068 6176 6520 6e6f 7420 s that have not │ │ │ │ │ -000038d0: 636f 6d70 6c65 7465 6420 696e 2061 2070 completed in a p │ │ │ │ │ -000038e0: 7269 6f72 0a72 756e 2c20 616e 6420 6861 rior.run, and ha │ │ │ │ │ -000038f0: 7264 2065 7272 6f72 7320 666f 7220 6578 rd errors for ex │ │ │ │ │ -00003900: 6365 7074 696f 6e61 6c20 6661 696c 7572 ceptional failur │ │ │ │ │ -00003910: 6573 2e20 2053 696d 696c 6172 2074 6f20 es. Similar to │ │ │ │ │ -00003920: 7468 6520 7369 6d70 6c65 0a74 6573 7420 the simple.test │ │ │ │ │ -00003930: 6472 6976 6572 2c20 2754 4553 5453 5f45 driver, 'TESTS_E │ │ │ │ │ -00003940: 4e56 4952 4f4e 4d45 4e54 272c 2027 414d NVIRONMENT', 'AM │ │ │ │ │ -00003950: 5f43 4f4c 4f52 5f54 4553 5453 272c 2027 _COLOR_TESTS', ' │ │ │ │ │ -00003960: 5846 4149 4c5f 5445 5354 5327 2c20 616e XFAIL_TESTS', an │ │ │ │ │ -00003970: 640a 7468 6520 2763 6865 636b 5f2a 2720 d.the 'check_*' │ │ │ │ │ -00003980: 7661 7269 6162 6c65 7320 6172 6520 686f variables are ho │ │ │ │ │ -00003990: 6e6f 7265 642c 2061 6e64 2074 6865 2065 nored, and the e │ │ │ │ │ -000039a0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -000039b0: 626c 650a 2773 7263 6469 7227 2069 7320 ble.'srcdir' is │ │ │ │ │ -000039c0: 7365 7420 6475 7269 6e67 2074 6573 7420 set during test │ │ │ │ │ -000039d0: 6578 6563 7574 696f 6e2e 0a0a 2020 2054 execution... T │ │ │ │ │ -000039e0: 6869 7320 7465 7374 2064 7269 7665 7220 his test driver │ │ │ │ │ -000039f0: 6973 2073 7469 6c6c 2065 7870 6572 696d is still experim │ │ │ │ │ -00003a00: 656e 7461 6c20 616e 6420 6d61 7920 756e ental and may un │ │ │ │ │ -00003a10: 6465 7267 6f20 6368 616e 6765 7320 696e dergo changes in │ │ │ │ │ -00003a20: 0a6f 7264 6572 2074 6f20 7361 7469 7366 .order to satisf │ │ │ │ │ -00003a30: 7920 6164 6469 7469 6f6e 616c 2070 6f72 y additional por │ │ │ │ │ -00003a40: 7461 6269 6c69 7479 2072 6571 7569 7265 tability require │ │ │ │ │ -00003a50: 6d65 6e74 732e 0a0a 2020 2054 6865 2064 ments... The d │ │ │ │ │ -00003a60: 7269 7665 7220 6f70 6572 6174 6573 2062 river operates b │ │ │ │ │ -00003a70: 7920 6465 6669 6e69 6e67 2061 2073 6574 y defining a set │ │ │ │ │ -00003a80: 206f 6620 276d 616b 6527 2072 756c 6573 of 'make' rules │ │ │ │ │ -00003a90: 2074 6f20 6372 6561 7465 2061 0a73 756d to create a.sum │ │ │ │ │ -00003aa0: 6d61 7279 206c 6f67 2066 696c 652c 2027 mary log file, ' │ │ │ │ │ -00003ab0: 5445 5354 5f53 5549 5445 5f4c 4f47 272c TEST_SUITE_LOG', │ │ │ │ │ -00003ac0: 2077 6869 6368 2064 6566 6175 6c74 7320 which defaults │ │ │ │ │ -00003ad0: 746f 2027 7465 7374 2d73 7569 7465 2e6c to 'test-suite.l │ │ │ │ │ -00003ae0: 6f67 270a 616e 6420 7265 7175 6972 6573 og'.and requires │ │ │ │ │ -00003af0: 2061 2027 2e6c 6f67 2720 7375 6666 6978 a '.log' suffix │ │ │ │ │ -00003b00: 2e20 2054 6869 7320 6669 6c65 2064 6570 . This file dep │ │ │ │ │ -00003b10: 656e 6473 2075 706f 6e20 6c6f 6720 6669 ends upon log fi │ │ │ │ │ -00003b20: 6c65 7320 6372 6561 7465 640a 666f 7220 les created.for │ │ │ │ │ -00003b30: 6561 6368 2073 696e 676c 6520 7465 7374 each single test │ │ │ │ │ -00003b40: 2070 726f 6772 616d 206c 6973 7465 6420 program listed │ │ │ │ │ -00003b50: 696e 2027 5445 5354 5327 2c20 7768 6963 in 'TESTS', whic │ │ │ │ │ -00003b60: 6820 696e 2074 7572 6e20 636f 6e74 6169 h in turn contai │ │ │ │ │ -00003b70: 6e0a 616c 6c20 6f75 7470 7574 2070 726f n.all output pro │ │ │ │ │ -00003b80: 6475 6365 6420 6279 2074 6865 2063 6f72 duced by the cor │ │ │ │ │ -00003b90: 7265 7370 6f6e 6469 6e67 2074 6573 7473 responding tests │ │ │ │ │ -00003ba0: 2e0a 0a20 2020 4561 6368 206c 6f67 2066 ... Each log f │ │ │ │ │ -00003bb0: 696c 6520 6973 2063 7265 6174 6564 2077 ile is created w │ │ │ │ │ -00003bc0: 6865 6e20 7468 6520 636f 7272 6573 706f hen the correspo │ │ │ │ │ -00003bd0: 6e64 696e 6720 7465 7374 2068 6173 2063 nding test has c │ │ │ │ │ -00003be0: 6f6d 706c 6574 6564 2e0a 5468 6520 7365 ompleted..The se │ │ │ │ │ -00003bf0: 7420 6f66 206c 6f67 2066 696c 6573 2069 t of log files i │ │ │ │ │ -00003c00: 7320 6c69 7374 6564 2069 6e20 7468 6520 s listed in the │ │ │ │ │ -00003c10: 7265 6164 2d6f 6e6c 7920 7661 7269 6162 read-only variab │ │ │ │ │ -00003c20: 6c65 2027 5445 5354 5f4c 4f47 5327 2c0a le 'TEST_LOGS',. │ │ │ │ │ -00003c30: 616e 6420 6465 6661 756c 7473 2074 6f20 and defaults to │ │ │ │ │ -00003c40: 2754 4553 5453 272c 2077 6974 6820 7468 'TESTS', with th │ │ │ │ │ -00003c50: 6520 6578 6563 7574 6162 6c65 2065 7874 e executable ext │ │ │ │ │ -00003c60: 656e 7369 6f6e 2069 6620 616e 7920 282a ension if any (* │ │ │ │ │ -00003c70: 6e6f 7465 0a45 5845 4558 543a 3a29 2c20 note.EXEEXT::), │ │ │ │ │ -00003c80: 6173 2077 656c 6c20 6173 2061 6e79 2073 as well as any s │ │ │ │ │ -00003c90: 7566 6669 7820 6c69 7374 6564 2069 6e20 uffix listed in │ │ │ │ │ -00003ca0: 2754 4553 545f 4558 5445 4e53 494f 4e53 'TEST_EXTENSIONS │ │ │ │ │ -00003cb0: 2720 7265 6d6f 7665 642c 0a61 6e64 2027 ' removed,.and ' │ │ │ │ │ -00003cc0: 2e6c 6f67 2720 6170 7065 6e64 6564 2e20 .log' appended. │ │ │ │ │ -00003cd0: 2052 6573 756c 7473 2061 7265 2075 6e64 Results are und │ │ │ │ │ -00003ce0: 6566 696e 6564 2069 6620 6120 7465 7374 efined if a test │ │ │ │ │ -00003cf0: 2066 696c 6520 6e61 6d65 2065 6e64 7320 file name ends │ │ │ │ │ -00003d00: 696e 0a73 6576 6572 616c 2063 6f6e 6361 in.several conca │ │ │ │ │ -00003d10: 7465 6e61 7465 6420 7375 6666 6978 6573 tenated suffixes │ │ │ │ │ -00003d20: 2e20 2027 5445 5354 5f45 5854 454e 5349 . 'TEST_EXTENSI │ │ │ │ │ -00003d30: 4f4e 5327 2064 6566 6175 6c74 7320 746f ONS' defaults to │ │ │ │ │ -00003d40: 2027 2e74 6573 7427 3b0a 6974 2063 616e '.test';.it can │ │ │ │ │ -00003d50: 2062 6520 6f76 6572 7269 6464 656e 2062 be overridden b │ │ │ │ │ -00003d60: 7920 7468 6520 7573 6572 2c20 696e 2077 y the user, in w │ │ │ │ │ -00003d70: 6869 6368 2063 6173 6520 616e 7920 6578 hich case any ex │ │ │ │ │ -00003d80: 7465 6e73 696f 6e20 6c69 7374 6564 2069 tension listed i │ │ │ │ │ -00003d90: 6e0a 6974 206d 7573 7420 6265 2063 6f6e n.it must be con │ │ │ │ │ -00003da0: 7374 6974 7574 6564 2062 7920 6120 646f stituted by a do │ │ │ │ │ -00003db0: 742c 2066 6f6c 6c6f 7765 6420 6279 2061 t, followed by a │ │ │ │ │ -00003dc0: 206e 6f6e 2d64 6967 6974 2061 6c70 6861 non-digit alpha │ │ │ │ │ -00003dd0: 6265 7469 630a 6368 6172 6163 7465 722c betic.character, │ │ │ │ │ -00003de0: 2066 6f6c 6c6f 7765 6420 6279 2061 6e79 followed by any │ │ │ │ │ -00003df0: 206e 756d 6265 7220 6f66 2061 6c70 6861 number of alpha │ │ │ │ │ -00003e00: 6265 7469 6320 6368 6172 6163 7465 7273 betic characters │ │ │ │ │ -00003e10: 2e20 2046 6f72 0a65 7861 6d70 6c65 2c20 . For.example, │ │ │ │ │ -00003e20: 272e 7368 272c 2027 2e54 2720 616e 6420 '.sh', '.T' and │ │ │ │ │ -00003e30: 272e 7431 2720 6172 6520 7661 6c69 6420 '.t1' are valid │ │ │ │ │ -00003e40: 6578 7465 6e73 696f 6e73 2c20 7768 696c extensions, whil │ │ │ │ │ -00003e50: 6520 272e 782d 7927 2c20 272e 3663 270a e '.x-y', '.6c'. │ │ │ │ │ -00003e60: 616e 6420 272e 742e 3127 2061 7265 206e and '.t.1' are n │ │ │ │ │ -00003e70: 6f74 2e0a 0a20 2020 466f 7220 7465 7374 ot... For test │ │ │ │ │ -00003e80: 7320 7468 6174 206d 6174 6368 2061 6e20 s that match an │ │ │ │ │ -00003e90: 6578 7465 6e73 696f 6e20 272e 4558 5427 extension '.EXT' │ │ │ │ │ -00003ea0: 206c 6973 7465 6420 696e 2027 5445 5354 listed in 'TEST │ │ │ │ │ -00003eb0: 5f45 5854 454e 5349 4f4e 5327 2c0a 796f _EXTENSIONS',.yo │ │ │ │ │ -00003ec0: 7520 6361 6e20 7072 6f76 6964 6520 6120 u can provide a │ │ │ │ │ -00003ed0: 7465 7374 2064 7269 7665 7220 7573 696e test driver usin │ │ │ │ │ -00003ee0: 6720 7468 6520 7661 7269 6162 6c65 2027 g the variable ' │ │ │ │ │ -00003ef0: 4558 545f 4c4f 475f 434f 4d50 494c 4552 EXT_LOG_COMPILER │ │ │ │ │ -00003f00: 270a 286e 6f74 6520 7468 6520 7570 7065 '.(note the uppe │ │ │ │ │ -00003f10: 722d 6361 7365 2065 7874 656e 7369 6f6e r-case extension │ │ │ │ │ -00003f20: 2920 616e 6420 7061 7373 206f 7074 696f ) and pass optio │ │ │ │ │ -00003f30: 6e73 2069 6e20 2741 4d5f 4558 545f 4c4f ns in 'AM_EXT_LO │ │ │ │ │ -00003f40: 475f 464c 4147 5327 0a61 6e64 2061 6c6c G_FLAGS'.and all │ │ │ │ │ -00003f50: 6f77 2074 6865 2075 7365 7220 746f 2070 ow the user to p │ │ │ │ │ -00003f60: 6173 7320 6f70 7469 6f6e 7320 696e 2027 ass options in ' │ │ │ │ │ -00003f70: 4558 545f 4c4f 475f 464c 4147 5327 2e20 EXT_LOG_FLAGS'. │ │ │ │ │ -00003f80: 2049 7420 7769 6c6c 2063 6175 7365 0a61 It will cause.a │ │ │ │ │ -00003f90: 6c6c 2074 6573 7473 2077 6974 6820 7468 ll tests with th │ │ │ │ │ -00003fa0: 6973 2065 7874 656e 7369 6f6e 2074 6f20 is extension to │ │ │ │ │ -00003fb0: 6265 2063 616c 6c65 6420 7769 7468 2074 be called with t │ │ │ │ │ -00003fc0: 6869 7320 6472 6976 6572 2e20 2046 6f72 his driver. For │ │ │ │ │ -00003fd0: 2061 6c6c 0a74 6573 7473 2077 6974 686f all.tests witho │ │ │ │ │ -00003fe0: 7574 2061 2072 6567 6973 7465 7265 6420 ut a registered │ │ │ │ │ -00003ff0: 6578 7465 6e73 696f 6e2c 2074 6865 2076 extension, the v │ │ │ │ │ -00004000: 6172 6961 626c 6573 2027 4c4f 475f 434f ariables 'LOG_CO │ │ │ │ │ -00004010: 4d50 494c 4552 272c 0a27 414d 5f4c 4f47 MPILER',.'AM_LOG │ │ │ │ │ -00004020: 5f46 4c41 4753 272c 2061 6e64 2027 4c4f _FLAGS', and 'LO │ │ │ │ │ -00004030: 475f 464c 4147 5327 206d 6179 2062 6520 G_FLAGS' may be │ │ │ │ │ -00004040: 7573 6564 2e20 2046 6f72 2065 7861 6d70 used. For examp │ │ │ │ │ -00004050: 6c65 2c0a 0a20 2020 2020 5445 5354 5320 le,.. TESTS │ │ │ │ │ -00004060: 3d20 666f 6f2e 706c 2062 6172 2e70 7920 = foo.pl bar.py │ │ │ │ │ -00004070: 6261 7a0a 2020 2020 2054 4553 545f 4558 baz. TEST_EX │ │ │ │ │ -00004080: 5445 4e53 494f 4e53 203d 202e 706c 202e TENSIONS = .pl . │ │ │ │ │ -00004090: 7079 0a20 2020 2020 504c 5f4c 4f47 5f43 py. PL_LOG_C │ │ │ │ │ -000040a0: 4f4d 5049 4c45 5220 3d20 2428 5045 524c OMPILER = $(PERL │ │ │ │ │ -000040b0: 290a 2020 2020 2041 4d5f 504c 5f4c 4f47 ). AM_PL_LOG │ │ │ │ │ -000040c0: 5f46 4c41 4753 203d 202d 770a 2020 2020 _FLAGS = -w. │ │ │ │ │ -000040d0: 2050 595f 4c4f 475f 434f 4d50 494c 4552 PY_LOG_COMPILER │ │ │ │ │ -000040e0: 203d 2024 2850 5954 484f 4e29 0a20 2020 = $(PYTHON). │ │ │ │ │ -000040f0: 2020 414d 5f50 595f 4c4f 475f 464c 4147 AM_PY_LOG_FLAG │ │ │ │ │ -00004100: 5320 3d20 2d76 0a20 2020 2020 4c4f 475f S = -v. LOG_ │ │ │ │ │ -00004110: 434f 4d50 494c 4552 203d 202e 2f77 7261 COMPILER = ./wra │ │ │ │ │ -00004120: 7070 6572 2d73 6372 6970 740a 2020 2020 pper-script. │ │ │ │ │ -00004130: 2041 4d5f 4c4f 475f 464c 4147 5320 3d20 AM_LOG_FLAGS = │ │ │ │ │ -00004140: 2d64 0a0a 7769 6c6c 2069 6e76 6f6b 6520 -d..will invoke │ │ │ │ │ -00004150: 2724 2850 4552 4c29 202d 7720 666f 6f2e '$(PERL) -w foo. │ │ │ │ │ -00004160: 706c 272c 2027 2428 5059 5448 4f4e 2920 pl', '$(PYTHON) │ │ │ │ │ -00004170: 2d76 2062 6172 2e70 7927 2c20 616e 640a -v bar.py', and. │ │ │ │ │ -00004180: 272e 2f77 7261 7070 6572 2d73 6372 6970 './wrapper-scrip │ │ │ │ │ -00004190: 7420 2d64 2062 617a 2720 746f 2070 726f t -d baz' to pro │ │ │ │ │ -000041a0: 6475 6365 2027 666f 6f2e 6c6f 6727 2c20 duce 'foo.log', │ │ │ │ │ -000041b0: 2762 6172 2e6c 6f67 272c 2061 6e64 0a27 'bar.log', and.' │ │ │ │ │ -000041c0: 6261 7a2e 6c6f 6727 2c20 7265 7370 6563 baz.log', respec │ │ │ │ │ -000041d0: 7469 7665 6c79 2e20 2054 6865 2027 5445 tively. The 'TE │ │ │ │ │ -000041e0: 5354 535f 454e 5649 524f 4e4d 454e 5427 STS_ENVIRONMENT' │ │ │ │ │ -000041f0: 2076 6172 6961 626c 6520 6973 2073 7469 variable is sti │ │ │ │ │ -00004200: 6c6c 0a65 7870 616e 6465 6420 6265 666f ll.expanded befo │ │ │ │ │ -00004210: 7265 2074 6865 2064 7269 7665 722c 2062 re the driver, b │ │ │ │ │ -00004220: 7574 2073 686f 756c 6420 6265 2072 6573 ut should be res │ │ │ │ │ -00004230: 6572 7665 6420 666f 7220 7468 6520 7573 erved for the us │ │ │ │ │ -00004240: 6572 2e0a 0a20 2020 4173 2077 6974 6820 er... As with │ │ │ │ │ -00004250: 7468 6520 7369 6d70 6c65 2064 7269 7665 the simple drive │ │ │ │ │ -00004260: 7220 6162 6f76 652c 2062 7920 6465 6661 r above, by defa │ │ │ │ │ -00004270: 756c 7420 6f6e 6520 7374 6174 7573 206c ult one status l │ │ │ │ │ -00004280: 696e 6520 6973 0a70 7269 6e74 6564 2070 ine is.printed p │ │ │ │ │ -00004290: 6572 2063 6f6d 706c 6574 6564 2074 6573 er completed tes │ │ │ │ │ -000042a0: 742c 2061 6e64 2061 2073 686f 7274 2073 t, and a short s │ │ │ │ │ -000042b0: 756d 6d61 7279 2061 6674 6572 2074 6865 ummary after the │ │ │ │ │ -000042c0: 2073 7569 7465 2068 6173 0a63 6f6d 706c suite has.compl │ │ │ │ │ -000042d0: 6574 6564 2e20 2048 6f77 6576 6572 2c20 eted. However, │ │ │ │ │ -000042e0: 7374 616e 6461 7264 206f 7574 7075 7420 standard output │ │ │ │ │ -000042f0: 616e 6420 7374 616e 6461 7264 2065 7272 and standard err │ │ │ │ │ -00004300: 6f72 206f 6620 7468 6520 7465 7374 2061 or of the test a │ │ │ │ │ -00004310: 7265 0a72 6564 6972 6563 7465 6420 746f re.redirected to │ │ │ │ │ -00004320: 2061 2070 6572 2d74 6573 7420 6c6f 6720 a per-test log │ │ │ │ │ -00004330: 6669 6c65 2c20 736f 2074 6861 7420 7061 file, so that pa │ │ │ │ │ -00004340: 7261 6c6c 656c 2065 7865 6375 7469 6f6e rallel execution │ │ │ │ │ -00004350: 2064 6f65 7320 6e6f 740a 7072 6f64 7563 does not.produc │ │ │ │ │ -00004360: 6520 696e 7465 726d 696e 676c 6564 206f e intermingled o │ │ │ │ │ -00004370: 7574 7075 742e 2020 5468 6520 6f75 7470 utput. The outp │ │ │ │ │ -00004380: 7574 2066 726f 6d20 6661 696c 6564 2074 ut from failed t │ │ │ │ │ -00004390: 6573 7473 2069 7320 636f 6c6c 6563 7465 ests is collecte │ │ │ │ │ -000043a0: 640a 696e 2074 6865 2027 7465 7374 2d73 d.in the 'test-s │ │ │ │ │ -000043b0: 7569 7465 2e6c 6f67 2720 6669 6c65 2e20 uite.log' file. │ │ │ │ │ -000043c0: 2049 6620 7468 6520 7661 7269 6162 6c65 If the variable │ │ │ │ │ -000043d0: 2027 5645 5242 4f53 4527 2069 7320 7365 'VERBOSE' is se │ │ │ │ │ -000043e0: 742c 2074 6869 730a 6669 6c65 2069 7320 t, this.file is │ │ │ │ │ -000043f0: 6f75 7470 7574 2061 6674 6572 2074 6865 output after the │ │ │ │ │ -00004400: 2073 756d 6d61 7279 2e20 2046 6f72 2062 summary. For b │ │ │ │ │ -00004410: 6573 7420 7265 7375 6c74 732c 2074 6865 est results, the │ │ │ │ │ -00004420: 2074 6573 7473 2073 686f 756c 6420 6265 tests should be │ │ │ │ │ -00004430: 0a76 6572 626f 7365 2062 7920 6465 6661 .verbose by defa │ │ │ │ │ -00004440: 756c 7420 6e6f 772e 0a0a 2020 2050 7265 ult now... Pre │ │ │ │ │ -00004450: 7669 6f75 7320 7665 7273 696f 6e73 206f vious versions o │ │ │ │ │ -00004460: 6620 6175 746f 6d61 6b65 2075 7365 6420 f automake used │ │ │ │ │ -00004470: 746f 2070 726f 7669 6465 2061 2027 6368 to provide a 'ch │ │ │ │ │ -00004480: 6563 6b2d 6874 6d6c 2720 7461 7267 6574 eck-html' target │ │ │ │ │ -00004490: 0a74 6f20 636f 6e76 6572 7420 7468 6520 .to convert the │ │ │ │ │ -000044a0: 6c6f 6720 6669 6c65 7320 746f 2048 544d log files to HTM │ │ │ │ │ -000044b0: 4c2e 2054 6869 7320 6665 6174 7572 6520 L. This feature │ │ │ │ │ -000044c0: 6973 206e 6f77 2064 6570 7265 6361 7465 is now deprecate │ │ │ │ │ -000044d0: 642c 2061 6e64 0a5f 7769 6c6c 2062 6520 d, and._will be │ │ │ │ │ -000044e0: 7265 6d6f 7665 645f 2069 6e20 7468 6520 removed_ in the │ │ │ │ │ -000044f0: 6e65 7874 206d 616a 6f72 2041 7574 6f6d next major Autom │ │ │ │ │ -00004500: 616b 6520 7265 6c65 6173 652c 2073 6f20 ake release, so │ │ │ │ │ -00004510: 646f 6e27 7420 7265 6c79 206f 6e0a 6974 don't rely on.it │ │ │ │ │ -00004520: 2061 6e79 6d6f 7265 2e0a 0a20 2020 4576 anymore... Ev │ │ │ │ │ -00004530: 656e 2069 6e20 7468 6520 7072 6573 656e en in the presen │ │ │ │ │ -00004540: 6365 206f 6620 6578 7065 6374 6564 2066 ce of expected f │ │ │ │ │ -00004550: 6169 6c75 7265 7320 2873 6565 2027 5846 ailures (see 'XF │ │ │ │ │ -00004560: 4149 4c5f 5445 5354 5327 292c 2074 6865 AIL_TESTS'), the │ │ │ │ │ -00004570: 7265 0a6d 6179 2062 6520 636f 6e64 6974 re.may be condit │ │ │ │ │ -00004580: 696f 6e73 2075 6e64 6572 2077 6869 6368 ions under which │ │ │ │ │ -00004590: 2061 2074 6573 7420 6f75 7463 6f6d 6520 a test outcome │ │ │ │ │ -000045a0: 6e65 6564 7320 6174 7465 6e74 696f 6e2e needs attention. │ │ │ │ │ -000045b0: 2020 466f 720a 6578 616d 706c 652c 2077 For.example, w │ │ │ │ │ -000045c0: 6974 6820 7465 7374 2d64 7269 7665 6e20 ith test-driven │ │ │ │ │ -000045d0: 6465 7665 6c6f 706d 656e 742c 2079 6f75 development, you │ │ │ │ │ -000045e0: 206d 6179 2077 7269 7465 2074 6573 7473 may write tests │ │ │ │ │ -000045f0: 2066 6f72 2066 6561 7475 7265 730a 7468 for features.th │ │ │ │ │ -00004600: 6174 2079 6f75 2068 6176 6520 6e6f 7420 at you have not │ │ │ │ │ -00004610: 696d 706c 656d 656e 7465 6420 7965 742c implemented yet, │ │ │ │ │ -00004620: 2061 6e64 2074 6875 7320 6d61 726b 2074 and thus mark t │ │ │ │ │ -00004630: 6865 7365 2074 6573 7473 2061 7320 6578 hese tests as ex │ │ │ │ │ -00004640: 7065 6374 6564 0a74 6f20 6661 696c 2e20 pected.to fail. │ │ │ │ │ -00004650: 2048 6f77 6576 6572 2c20 796f 7520 6d61 However, you ma │ │ │ │ │ -00004660: 7920 7374 696c 6c20 6265 2069 6e74 6572 y still be inter │ │ │ │ │ -00004670: 6573 7465 6420 696e 2065 7863 6570 7469 ested in excepti │ │ │ │ │ -00004680: 6f6e 616c 0a63 6f6e 6469 7469 6f6e 732c onal.conditions, │ │ │ │ │ -00004690: 2066 6f72 2065 7861 6d70 6c65 2c20 7465 for example, te │ │ │ │ │ -000046a0: 7374 7320 7468 6174 2066 6169 6c20 6475 sts that fail du │ │ │ │ │ -000046b0: 6520 746f 2061 2073 6567 6d65 6e74 6174 e to a segmentat │ │ │ │ │ -000046c0: 696f 6e20 7669 6f6c 6174 696f 6e0a 6f72 ion violation.or │ │ │ │ │ -000046d0: 2061 6e6f 7468 6572 2065 7272 6f72 2074 another error t │ │ │ │ │ -000046e0: 6861 7420 6973 2069 6e64 6570 656e 6465 hat is independe │ │ │ │ │ -000046f0: 6e74 206f 6620 7468 6520 6665 6174 7572 nt of the featur │ │ │ │ │ -00004700: 6520 6177 6169 7469 6e67 0a69 6d70 6c65 e awaiting.imple │ │ │ │ │ -00004710: 6d65 6e74 6174 696f 6e2e 2020 5465 7374 mentation. Test │ │ │ │ │ -00004720: 7320 6361 6e20 6578 6974 2077 6974 6820 s can exit with │ │ │ │ │ -00004730: 616e 2065 7869 7420 7374 6174 7573 206f an exit status o │ │ │ │ │ -00004740: 6620 3939 2074 6f20 7369 676e 616c 2073 f 99 to signal s │ │ │ │ │ -00004750: 7563 680a 6120 5f68 6172 6420 6572 726f uch.a _hard erro │ │ │ │ │ -00004760: 725f 2e20 2055 6e6c 6573 7320 7468 6520 r_. Unless the │ │ │ │ │ -00004770: 7661 7269 6162 6c65 2027 4449 5341 424c variable 'DISABL │ │ │ │ │ -00004780: 455f 4841 5244 5f45 5252 4f52 5327 2069 E_HARD_ERRORS' i │ │ │ │ │ -00004790: 7320 7365 7420 746f 2061 0a6e 6f6e 656d s set to a.nonem │ │ │ │ │ -000047a0: 7074 7920 7661 6c75 652c 2073 7563 6820 pty value, such │ │ │ │ │ -000047b0: 7465 7374 7320 7769 6c6c 2062 6520 636f tests will be co │ │ │ │ │ -000047c0: 756e 7465 6420 6173 2066 6169 6c65 642e unted as failed. │ │ │ │ │ -000047d0: 0a0a 2020 2042 7920 6465 6661 756c 742c .. By default, │ │ │ │ │ -000047e0: 2074 6865 2074 6573 7420 7375 6974 6520 the test suite │ │ │ │ │ -000047f0: 6472 6976 6572 2077 696c 6c20 7275 6e20 driver will run │ │ │ │ │ -00004800: 616c 6c20 7465 7374 732c 2062 7574 2074 all tests, but t │ │ │ │ │ -00004810: 6865 7265 2061 7265 0a73 6576 6572 616c here are.several │ │ │ │ │ -00004820: 2077 6179 7320 746f 206c 696d 6974 2074 ways to limit t │ │ │ │ │ -00004830: 6865 2073 6574 206f 6620 7465 7374 7320 he set of tests │ │ │ │ │ -00004840: 7468 6174 2061 7265 2072 756e 3a0a 0a20 that are run:.. │ │ │ │ │ -00004850: 2020 2a20 596f 7520 6361 6e20 7365 7420 * You can set │ │ │ │ │ -00004860: 7468 6520 2754 4553 5453 2720 7661 7269 the 'TESTS' vari │ │ │ │ │ -00004870: 6162 6c65 2c20 7369 6d69 6c61 726c 7920 able, similarly │ │ │ │ │ -00004880: 746f 2068 6f77 2079 6f75 2063 616e 2077 to how you can w │ │ │ │ │ -00004890: 6974 6820 7468 650a 2020 2020 2073 696d ith the. sim │ │ │ │ │ -000048a0: 706c 6520 7465 7374 2064 7269 7665 7220 ple test driver │ │ │ │ │ -000048b0: 6672 6f6d 2074 6865 2070 7265 7669 6f75 from the previou │ │ │ │ │ -000048c0: 7320 7365 6374 696f 6e2e 2020 466f 7220 s section. For │ │ │ │ │ -000048d0: 6578 616d 706c 652c 2079 6f75 2063 616e example, you can │ │ │ │ │ -000048e0: 0a20 2020 2020 7573 6520 6120 636f 6d6d . use a comm │ │ │ │ │ -000048f0: 616e 6420 6c69 6b65 2074 6869 7320 746f and like this to │ │ │ │ │ -00004900: 2072 756e 206f 6e6c 7920 6120 7375 6273 run only a subs │ │ │ │ │ -00004910: 6574 206f 6620 7468 6520 7465 7374 733a et of the tests: │ │ │ │ │ -00004920: 0a0a 2020 2020 2020 2020 2020 656e 7620 .. env │ │ │ │ │ -00004930: 5445 5354 533d 2266 6f6f 2e74 6573 7420 TESTS="foo.test │ │ │ │ │ -00004940: 6261 722e 7465 7374 2220 6d61 6b65 202d bar.test" make - │ │ │ │ │ -00004950: 6520 6368 6563 6b0a 0a20 2020 2020 4e6f e check.. No │ │ │ │ │ -00004960: 7465 2068 6f77 6576 6572 2074 6861 7420 te however that │ │ │ │ │ -00004970: 7468 6520 636f 6d6d 616e 6420 6162 6f76 the command abov │ │ │ │ │ -00004980: 6520 7769 6c6c 2075 6e63 6f6e 6469 7469 e will unconditi │ │ │ │ │ -00004990: 6f6e 616c 6c79 206f 7665 7277 7269 7465 onally overwrite │ │ │ │ │ -000049a0: 0a20 2020 2020 7468 6520 2774 6573 742d . the 'test- │ │ │ │ │ -000049b0: 7375 6974 652e 6c6f 6727 2066 696c 652c suite.log' file, │ │ │ │ │ -000049c0: 2074 6875 7320 636c 6f62 6265 7269 6e67 thus clobbering │ │ │ │ │ -000049d0: 2074 6865 2072 6563 6f72 6465 6420 7265 the recorded re │ │ │ │ │ -000049e0: 7375 6c74 7320 6f66 0a20 2020 2020 616e sults of. an │ │ │ │ │ -000049f0: 7920 7072 6576 696f 7573 2074 6573 7473 y previous tests │ │ │ │ │ -00004a00: 7569 7465 2072 756e 2e20 2054 6869 7320 uite run. This │ │ │ │ │ -00004a10: 6d69 6768 7420 6265 2075 6e64 6573 6972 might be undesir │ │ │ │ │ -00004a20: 6162 6c65 2066 6f72 2070 6163 6b61 6765 able for package │ │ │ │ │ -00004a30: 730a 2020 2020 2077 686f 7365 2074 6573 s. whose tes │ │ │ │ │ -00004a40: 7473 7569 7465 2074 616b 6573 206c 6f6e tsuite takes lon │ │ │ │ │ -00004a50: 6720 7469 6d65 2074 6f20 6578 6563 7574 g time to execut │ │ │ │ │ -00004a60: 652e 2020 4c75 636b 696c 792c 2074 6869 e. Luckily, thi │ │ │ │ │ -00004a70: 7320 7072 6f62 6c65 6d0a 2020 2020 2063 s problem. c │ │ │ │ │ -00004a80: 616e 2065 6173 696c 7920 6265 2061 766f an easily be avo │ │ │ │ │ -00004a90: 6964 6564 2062 7920 6f76 6572 7269 6469 ided by overridi │ │ │ │ │ -00004aa0: 6e67 2061 6c73 6f20 2754 4553 545f 5355 ng also 'TEST_SU │ │ │ │ │ -00004ab0: 4954 455f 4c4f 4727 2061 740a 2020 2020 ITE_LOG' at. │ │ │ │ │ -00004ac0: 2072 756e 7469 6d65 3b20 666f 7220 6578 runtime; for ex │ │ │ │ │ -00004ad0: 616d 706c 652c 0a0a 2020 2020 2020 2020 ample,.. │ │ │ │ │ -00004ae0: 2020 656e 7620 5445 5354 5f53 5549 5445 env TEST_SUITE │ │ │ │ │ -00004af0: 5f4c 4f47 3d70 6172 7469 616c 2e6c 6f67 _LOG=partial.log │ │ │ │ │ -00004b00: 2054 4553 5453 3d22 2e2e 2e22 206d 616b TESTS="..." mak │ │ │ │ │ -00004b10: 6520 2d65 2063 6865 636b 0a0a 2020 2020 e -e check.. │ │ │ │ │ -00004b20: 2077 696c 6c20 7772 6974 6520 7468 6520 will write the │ │ │ │ │ -00004b30: 7265 7375 6c74 206f 6620 7468 6520 7061 result of the pa │ │ │ │ │ -00004b40: 7274 6961 6c20 7465 7374 7375 6974 6520 rtial testsuite │ │ │ │ │ -00004b50: 7275 6e73 2074 6f20 7468 650a 2020 2020 runs to the. │ │ │ │ │ -00004b60: 2027 7061 7274 6961 6c2e 6c6f 6727 2c20 'partial.log', │ │ │ │ │ -00004b70: 7769 7468 6f75 7420 746f 7563 6869 6e67 without touching │ │ │ │ │ -00004b80: 2027 7465 7374 2d73 7569 7465 2e6c 6f67 'test-suite.log │ │ │ │ │ -00004b90: 272e 0a0a 2020 202a 2059 6f75 2063 616e '... * You can │ │ │ │ │ -00004ba0: 2073 6574 2074 6865 2027 5445 5354 5f4c set the 'TEST_L │ │ │ │ │ -00004bb0: 4f47 5327 2076 6172 6961 626c 652e 2020 OGS' variable. │ │ │ │ │ -00004bc0: 4279 2064 6566 6175 6c74 2c20 7468 6973 By default, this │ │ │ │ │ -00004bd0: 2076 6172 6961 626c 6520 6973 0a20 2020 variable is. │ │ │ │ │ -00004be0: 2020 636f 6d70 7574 6564 2061 7420 276d computed at 'm │ │ │ │ │ -00004bf0: 616b 6527 2072 756e 2074 696d 6520 6672 ake' run time fr │ │ │ │ │ -00004c00: 6f6d 2074 6865 2076 616c 7565 206f 6620 om the value of │ │ │ │ │ -00004c10: 2754 4553 5453 2720 6173 2064 6573 6372 'TESTS' as descr │ │ │ │ │ -00004c20: 6962 6564 0a20 2020 2020 6162 6f76 652e ibed. above. │ │ │ │ │ -00004c30: 2020 466f 7220 6578 616d 706c 652c 2079 For example, y │ │ │ │ │ -00004c40: 6f75 2063 616e 2075 7365 2074 6865 2066 ou can use the f │ │ │ │ │ -00004c50: 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 2020 ollowing:.. │ │ │ │ │ -00004c60: 2020 2020 2073 6574 2078 2073 7562 7365 set x subse │ │ │ │ │ -00004c70: 742a 2e6c 6f67 3b20 7368 6966 740a 2020 t*.log; shift. │ │ │ │ │ -00004c80: 2020 2020 2020 2020 656e 7620 5445 5354 env TEST │ │ │ │ │ -00004c90: 5f4c 4f47 533d 2266 6f6f 2e6c 6f67 2024 _LOGS="foo.log $ │ │ │ │ │ -00004ca0: 2a22 206d 616b 6520 2d65 2063 6865 636b *" make -e check │ │ │ │ │ -00004cb0: 0a0a 2020 2020 2054 6865 2063 6f6d 6d65 .. The comme │ │ │ │ │ -00004cc0: 6e74 7320 6d61 6465 2061 626f 7665 2061 nts made above a │ │ │ │ │ -00004cd0: 626f 7574 2027 5445 5354 5f53 5549 5445 bout 'TEST_SUITE │ │ │ │ │ -00004ce0: 5f4c 4f47 2720 6f76 6572 7269 6469 6e67 _LOG' overriding │ │ │ │ │ -00004cf0: 2061 7070 6c69 6573 0a20 2020 2020 6865 applies. he │ │ │ │ │ -00004d00: 7265 2074 6f6f 2e0a 0a20 2020 2a20 4279 re too... * By │ │ │ │ │ -00004d10: 2064 6566 6175 6c74 2c20 7468 6520 7465 default, the te │ │ │ │ │ -00004d20: 7374 2064 7269 7665 7220 7265 6d6f 7665 st driver remove │ │ │ │ │ -00004d30: 7320 616c 6c20 6f6c 6420 7065 722d 7465 s all old per-te │ │ │ │ │ -00004d40: 7374 206c 6f67 2066 696c 6573 0a20 2020 st log files. │ │ │ │ │ -00004d50: 2020 6265 666f 7265 2069 7420 7374 6172 before it star │ │ │ │ │ -00004d60: 7473 2072 756e 6e69 6e67 2074 6573 7473 ts running tests │ │ │ │ │ -00004d70: 2074 6f20 7265 6765 6e65 7261 7465 2074 to regenerate t │ │ │ │ │ -00004d80: 6865 6d2e 2020 5468 6520 7661 7269 6162 hem. The variab │ │ │ │ │ -00004d90: 6c65 0a20 2020 2020 2752 4543 4845 434b le. 'RECHECK │ │ │ │ │ -00004da0: 5f4c 4f47 5327 2063 6f6e 7461 696e 7320 _LOGS' contains │ │ │ │ │ -00004db0: 7468 6520 7365 7420 6f66 206c 6f67 2066 the set of log f │ │ │ │ │ -00004dc0: 696c 6573 2077 6869 6368 2061 7265 2072 iles which are r │ │ │ │ │ -00004dd0: 656d 6f76 6564 2e0a 2020 2020 2027 5245 emoved.. 'RE │ │ │ │ │ -00004de0: 4348 4543 4b5f 4c4f 4753 2720 6465 6661 CHECK_LOGS' defa │ │ │ │ │ -00004df0: 756c 7473 2074 6f20 2754 4553 545f 4c4f ults to 'TEST_LO │ │ │ │ │ -00004e00: 4753 272c 2077 6869 6368 206d 6561 6e73 GS', which means │ │ │ │ │ -00004e10: 2061 6c6c 2074 6573 7473 206e 6565 640a all tests need. │ │ │ │ │ -00004e20: 2020 2020 2074 6f20 6265 2072 6563 6865 to be reche │ │ │ │ │ -00004e30: 636b 6564 2e20 2042 7920 6f76 6572 7269 cked. By overri │ │ │ │ │ -00004e40: 6469 6e67 2074 6869 7320 7661 7269 6162 ding this variab │ │ │ │ │ -00004e50: 6c65 2c20 796f 7520 6361 6e20 6368 6f6f le, you can choo │ │ │ │ │ -00004e60: 7365 2077 6869 6368 0a20 2020 2020 7465 se which. te │ │ │ │ │ -00004e70: 7374 7320 6e65 6564 2074 6f20 6265 2072 sts need to be r │ │ │ │ │ -00004e80: 6563 6f6e 7369 6465 7265 642e 2020 466f econsidered. Fo │ │ │ │ │ -00004e90: 7220 6578 616d 706c 652c 2079 6f75 2063 r example, you c │ │ │ │ │ -00004ea0: 616e 206c 617a 696c 7920 7265 7275 6e0a an lazily rerun. │ │ │ │ │ -00004eb0: 2020 2020 206f 6e6c 7920 7468 6f73 6520 only those │ │ │ │ │ -00004ec0: 7465 7374 7320 7768 6963 6820 6172 6520 tests which are │ │ │ │ │ -00004ed0: 6f75 7464 6174 6564 2c20 692e 652e 2c20 outdated, i.e., │ │ │ │ │ -00004ee0: 6f6c 6465 7220 7468 616e 2074 6865 6972 older than their │ │ │ │ │ -00004ef0: 0a20 2020 2020 7072 6572 6571 7569 7369 . prerequisi │ │ │ │ │ -00004f00: 7465 2074 6573 7420 6669 6c65 732c 2062 te test files, b │ │ │ │ │ -00004f10: 7920 7365 7474 696e 6720 7468 6973 2076 y setting this v │ │ │ │ │ -00004f20: 6172 6961 626c 6520 746f 2074 6865 2065 ariable to the e │ │ │ │ │ -00004f30: 6d70 7479 0a20 2020 2020 7661 6c75 653a mpty. value: │ │ │ │ │ -00004f40: 0a0a 2020 2020 2020 2020 2020 656e 7620 .. env │ │ │ │ │ -00004f50: 5245 4348 4543 4b5f 4c4f 4753 3d20 6d61 RECHECK_LOGS= ma │ │ │ │ │ -00004f60: 6b65 202d 6520 6368 6563 6b0a 0a20 2020 ke -e check.. │ │ │ │ │ -00004f70: 2a20 596f 7520 6361 6e20 656e 7375 7265 * You can ensure │ │ │ │ │ -00004f80: 2074 6861 7420 616c 6c20 7465 7374 7320 that all tests │ │ │ │ │ -00004f90: 6172 6520 7265 7275 6e20 7768 6963 6820 are rerun which │ │ │ │ │ -00004fa0: 6861 7665 2066 6169 6c65 6420 6f72 2070 have failed or p │ │ │ │ │ -00004fb0: 6173 7365 640a 2020 2020 2075 6e65 7870 assed. unexp │ │ │ │ │ -00004fc0: 6563 7465 646c 792c 2062 7920 7275 6e6e ectedly, by runn │ │ │ │ │ -00004fd0: 696e 6720 276d 616b 6520 7265 6368 6563 ing 'make rechec │ │ │ │ │ -00004fe0: 6b27 2069 6e20 7468 6520 7465 7374 2064 k' in the test d │ │ │ │ │ -00004ff0: 6972 6563 746f 7279 2e0a 2020 2020 2054 irectory.. T │ │ │ │ │ -00005000: 6869 7320 636f 6e76 656e 6965 6e63 6520 his convenience │ │ │ │ │ -00005010: 7461 7267 6574 2077 696c 6c20 7365 7420 target will set │ │ │ │ │ -00005020: 2752 4543 4845 434b 5f4c 4f47 5327 2061 'RECHECK_LOGS' a │ │ │ │ │ -00005030: 7070 726f 7072 6961 7465 6c79 0a20 2020 ppropriately. │ │ │ │ │ -00005040: 2020 6265 666f 7265 2069 6e76 6f6b 696e before invokin │ │ │ │ │ -00005050: 6720 7468 6520 6d61 696e 2074 6573 7420 g the main test │ │ │ │ │ -00005060: 6472 6976 6572 2e0a 0a20 2020 496e 206f driver... In o │ │ │ │ │ -00005070: 7264 6572 2074 6f20 6775 6172 616e 7465 rder to guarante │ │ │ │ │ -00005080: 6520 616e 206f 7264 6572 696e 6720 6265 e an ordering be │ │ │ │ │ -00005090: 7477 6565 6e20 7465 7374 7320 6576 656e tween tests even │ │ │ │ │ -000050a0: 2077 6974 6820 276d 616b 6520 2d6a 4e27 with 'make -jN' │ │ │ │ │ -000050b0: 2c0a 6465 7065 6e64 656e 6369 6573 2062 ,.dependencies b │ │ │ │ │ -000050c0: 6574 7765 656e 2074 6865 2063 6f72 7265 etween the corre │ │ │ │ │ -000050d0: 7370 6f6e 6469 6e67 206c 6f67 2066 696c sponding log fil │ │ │ │ │ -000050e0: 6573 206d 6179 2062 6520 7370 6563 6966 es may be specif │ │ │ │ │ -000050f0: 6965 640a 7468 726f 7567 6820 7573 7561 ied.through usua │ │ │ │ │ -00005100: 6c20 276d 616b 6527 2064 6570 656e 6465 l 'make' depende │ │ │ │ │ -00005110: 6e63 6965 732e 2020 466f 7220 6578 616d ncies. For exam │ │ │ │ │ -00005120: 706c 652c 2074 6865 2066 6f6c 6c6f 7769 ple, the followi │ │ │ │ │ -00005130: 6e67 2073 6e69 7070 6574 0a6c 6574 7320 ng snippet.lets │ │ │ │ │ -00005140: 7468 6520 7465 7374 206e 616d 6564 2027 the test named ' │ │ │ │ │ -00005150: 666f 6f2d 6578 6563 7574 652e 7465 7374 foo-execute.test │ │ │ │ │ -00005160: 2720 6465 7065 6e64 2075 706f 6e20 636f ' depend upon co │ │ │ │ │ -00005170: 6d70 6c65 7469 6f6e 206f 6620 7468 650a mpletion of the. │ │ │ │ │ -00005180: 7465 7374 2027 666f 6f2d 636f 6d70 696c test 'foo-compil │ │ │ │ │ -00005190: 652e 7465 7374 273a 0a0a 2020 2020 2054 e.test':.. T │ │ │ │ │ -000051a0: 4553 5453 203d 2066 6f6f 2d63 6f6d 7069 ESTS = foo-compi │ │ │ │ │ -000051b0: 6c65 2e74 6573 7420 666f 6f2d 6578 6563 le.test foo-exec │ │ │ │ │ -000051c0: 7574 652e 7465 7374 0a20 2020 2020 666f ute.test. fo │ │ │ │ │ -000051d0: 6f2d 6578 6563 7574 652e 6c6f 673a 2066 o-execute.log: f │ │ │ │ │ -000051e0: 6f6f 2d63 6f6d 7069 6c65 2e6c 6f67 0a0a oo-compile.log.. │ │ │ │ │ -000051f0: 506c 6561 7365 206e 6f74 6520 7468 6174 Please note that │ │ │ │ │ -00005200: 2074 6869 7320 6f72 6465 7269 6e67 2069 this ordering i │ │ │ │ │ -00005210: 676e 6f72 6573 2074 6865 205f 7265 7375 gnores the _resu │ │ │ │ │ -00005220: 6c74 735f 206f 6620 7265 7175 6972 6564 lts_ of required │ │ │ │ │ -00005230: 2074 6573 7473 2c0a 7468 7573 2074 6865 tests,.thus the │ │ │ │ │ -00005240: 2074 6573 7420 2766 6f6f 2d65 7865 6375 test 'foo-execu │ │ │ │ │ -00005250: 7465 2e74 6573 7427 2069 7320 7275 6e20 te.test' is run │ │ │ │ │ -00005260: 6576 656e 2069 6620 7468 6520 7465 7374 even if the test │ │ │ │ │ -00005270: 0a27 666f 6f2d 636f 6d70 696c 652e 7465 .'foo-compile.te │ │ │ │ │ -00005280: 7374 2720 6661 696c 6564 206f 7220 7761 st' failed or wa │ │ │ │ │ -00005290: 7320 736b 6970 7065 6420 6265 666f 7265 s skipped before │ │ │ │ │ -000052a0: 6861 6e64 2e20 2046 7572 7468 6572 2c20 hand. Further, │ │ │ │ │ -000052b0: 706c 6561 7365 0a6e 6f74 6520 7468 6174 please.note that │ │ │ │ │ -000052c0: 2073 7065 6369 6679 696e 6720 7375 6368 specifying such │ │ │ │ │ -000052d0: 2064 6570 656e 6465 6e63 6965 7320 6375 dependencies cu │ │ │ │ │ -000052e0: 7272 656e 746c 7920 776f 726b 7320 6f6e rrently works on │ │ │ │ │ -000052f0: 6c79 2066 6f72 2074 6573 7473 0a74 6861 ly for tests.tha │ │ │ │ │ -00005300: 7420 656e 6420 696e 206f 6e65 206f 6620 t end in one of │ │ │ │ │ -00005310: 7468 6520 7375 6666 6978 6573 206c 6973 the suffixes lis │ │ │ │ │ -00005320: 7465 6420 696e 2027 5445 5354 5f45 5854 ted in 'TEST_EXT │ │ │ │ │ -00005330: 454e 5349 4f4e 5327 2e0a 0a20 2020 5465 ENSIONS'... Te │ │ │ │ │ -00005340: 7374 7320 7769 7468 6f75 7420 7375 6368 sts without such │ │ │ │ │ -00005350: 2073 7065 6369 6669 6564 2064 6570 656e specified depen │ │ │ │ │ -00005360: 6465 6e63 6965 7320 6d61 7920 6265 2072 dencies may be r │ │ │ │ │ -00005370: 756e 2063 6f6e 6375 7272 656e 746c 790a un concurrently. │ │ │ │ │ -00005380: 7769 7468 2070 6172 616c 6c65 6c20 276d with parallel 'm │ │ │ │ │ -00005390: 616b 6520 2d6a 4e27 2c20 736f 2062 6520 ake -jN', so be │ │ │ │ │ -000053a0: 7375 7265 2074 6865 7920 6172 6520 7072 sure they are pr │ │ │ │ │ -000053b0: 6570 6172 6564 2066 6f72 2063 6f6e 6375 epared for concu │ │ │ │ │ -000053c0: 7272 656e 740a 6578 6563 7574 696f 6e2e rrent.execution. │ │ │ │ │ -000053d0: 0a0a 2020 2054 6865 2063 6f6d 6269 6e61 .. The combina │ │ │ │ │ -000053e0: 7469 6f6e 206f 6620 6c61 7a79 2074 6573 tion of lazy tes │ │ │ │ │ -000053f0: 7420 6578 6563 7574 696f 6e20 616e 6420 t execution and │ │ │ │ │ -00005400: 636f 7272 6563 7420 6465 7065 6e64 656e correct dependen │ │ │ │ │ -00005410: 6369 6573 0a62 6574 7765 656e 2074 6573 cies.between tes │ │ │ │ │ -00005420: 7473 2061 6e64 2074 6865 6972 2073 6f75 ts and their sou │ │ │ │ │ -00005430: 7263 6573 206d 6179 2062 6520 6578 706c rces may be expl │ │ │ │ │ -00005440: 6f69 7465 6420 666f 7220 6566 6669 6369 oited for effici │ │ │ │ │ -00005450: 656e 7420 756e 6974 0a74 6573 7469 6e67 ent unit.testing │ │ │ │ │ -00005460: 2064 7572 696e 6720 6465 7665 6c6f 706d during developm │ │ │ │ │ -00005470: 656e 742e 2020 546f 2066 7572 7468 6572 ent. To further │ │ │ │ │ -00005480: 2073 7065 6564 2075 7020 7468 6520 6564 speed up the ed │ │ │ │ │ -00005490: 6974 2d63 6f6d 7069 6c65 2d74 6573 740a it-compile-test. │ │ │ │ │ -000054a0: 6379 636c 652c 2069 7420 6d61 7920 6576 cycle, it may ev │ │ │ │ │ -000054b0: 656e 2062 6520 7573 6566 756c 2074 6f20 en be useful to │ │ │ │ │ -000054c0: 7370 6563 6966 7920 636f 6d70 696c 6564 specify compiled │ │ │ │ │ -000054d0: 2070 726f 6772 616d 7320 696e 0a27 4558 programs in.'EX │ │ │ │ │ -000054e0: 5452 415f 5052 4f47 5241 4d53 2720 696e TRA_PROGRAMS' in │ │ │ │ │ -000054f0: 7374 6561 6420 6f66 2077 6974 6820 2763 stead of with 'c │ │ │ │ │ -00005500: 6865 636b 5f50 524f 4752 414d 5327 2c20 heck_PROGRAMS', │ │ │ │ │ -00005510: 6173 2074 6865 2066 6f72 6d65 7220 616c as the former al │ │ │ │ │ -00005520: 6c6f 7773 0a69 6e74 6572 7477 696e 6564 lows.intertwined │ │ │ │ │ -00005530: 2063 6f6d 7069 6c61 7469 6f6e 2061 6e64 compilation and │ │ │ │ │ -00005540: 2074 6573 7420 6578 6563 7574 696f 6e20 test execution │ │ │ │ │ -00005550: 2862 7574 206e 6f74 6520 7468 6174 0a27 (but note that.' │ │ │ │ │ -00005560: 4558 5452 415f 5052 4f47 5241 4d53 2720 EXTRA_PROGRAMS' │ │ │ │ │ -00005570: 6172 6520 6e6f 7420 636c 6561 6e65 6420 are not cleaned │ │ │ │ │ -00005580: 6175 746f 6d61 7469 6361 6c6c 792c 202a automatically, * │ │ │ │ │ -00005590: 6e6f 7465 2055 6e69 666f 726d 3a3a 292e note Uniform::). │ │ │ │ │ -000055a0: 0a0a 2020 2054 6865 2076 6172 6961 626c .. The variabl │ │ │ │ │ -000055b0: 6573 2027 5445 5354 5327 2061 6e64 2027 es 'TESTS' and ' │ │ │ │ │ -000055c0: 5846 4149 4c5f 5445 5354 5327 206d 6179 XFAIL_TESTS' may │ │ │ │ │ -000055d0: 2063 6f6e 7461 696e 2063 6f6e 6469 7469 contain conditi │ │ │ │ │ -000055e0: 6f6e 616c 2070 6172 7473 0a61 7320 7765 onal parts.as we │ │ │ │ │ -000055f0: 6c6c 2061 7320 636f 6e66 6967 7572 6520 ll as configure │ │ │ │ │ -00005600: 7375 6273 7469 7475 7469 6f6e 732e 2020 substitutions. │ │ │ │ │ -00005610: 496e 2074 6865 206c 6174 7465 7220 6361 In the latter ca │ │ │ │ │ -00005620: 7365 2c20 686f 7765 7665 722c 0a63 6572 se, however,.cer │ │ │ │ │ -00005630: 7461 696e 2072 6573 7472 6963 7469 6f6e tain restriction │ │ │ │ │ -00005640: 7320 6170 706c 793a 2073 7562 7374 6974 s apply: substit │ │ │ │ │ -00005650: 7574 6564 2074 6573 7420 6e61 6d65 7320 uted test names │ │ │ │ │ -00005660: 6d75 7374 2065 6e64 2077 6974 6820 610a must end with a. │ │ │ │ │ -00005670: 6e6f 6e65 6d70 7479 2074 6573 7420 7375 nonempty test su │ │ │ │ │ -00005680: 6666 6978 206c 696b 6520 272e 7465 7374 ffix like '.test │ │ │ │ │ -00005690: 272c 2073 6f20 7468 6174 206f 6e65 206f ', so that one o │ │ │ │ │ -000056a0: 6620 7468 6520 696e 6665 7265 6e63 6520 f the inference │ │ │ │ │ -000056b0: 7275 6c65 730a 6765 6e65 7261 7465 6420 rules.generated │ │ │ │ │ -000056c0: 6279 2027 6175 746f 6d61 6b65 2720 6361 by 'automake' ca │ │ │ │ │ -000056d0: 6e20 6170 706c 792e 2020 466f 7220 6c69 n apply. For li │ │ │ │ │ -000056e0: 7465 7261 6c20 7465 7374 206e 616d 6573 teral test names │ │ │ │ │ -000056f0: 2c20 2761 7574 6f6d 616b 6527 0a63 616e , 'automake'.can │ │ │ │ │ -00005700: 2067 656e 6572 6174 6520 7065 722d 7461 generate per-ta │ │ │ │ │ -00005710: 7267 6574 2072 756c 6573 2074 6f20 6176 rget rules to av │ │ │ │ │ -00005720: 6f69 6420 7468 6973 206c 696d 6974 6174 oid this limitat │ │ │ │ │ -00005730: 696f 6e2e 0a0a 2020 2050 6c65 6173 6520 ion... Please │ │ │ │ │ -00005740: 6e6f 7465 2074 6861 7420 6974 2069 7320 note that it is │ │ │ │ │ -00005750: 6375 7272 656e 746c 7920 6e6f 7420 706f currently not po │ │ │ │ │ -00005760: 7373 6962 6c65 2074 6f20 7573 6520 2724 ssible to use '$ │ │ │ │ │ -00005770: 2873 7263 6469 7229 2f27 206f 720a 2724 (srcdir)/' or.'$ │ │ │ │ │ -00005780: 2874 6f70 5f73 7263 6469 7229 2f27 2069 (top_srcdir)/' i │ │ │ │ │ -00005790: 6e20 7468 6520 2754 4553 5453 2720 7661 n the 'TESTS' va │ │ │ │ │ -000057a0: 7269 6162 6c65 2e20 2054 6869 7320 7465 riable. This te │ │ │ │ │ -000057b0: 6368 6e69 6361 6c20 6c69 6d69 7461 7469 chnical limitati │ │ │ │ │ -000057c0: 6f6e 2069 730a 6e65 6365 7373 6172 7920 on is.necessary │ │ │ │ │ -000057d0: 746f 2061 766f 6964 2067 656e 6572 6174 to avoid generat │ │ │ │ │ -000057e0: 696e 6720 7465 7374 206c 6f67 7320 696e ing test logs in │ │ │ │ │ -000057f0: 2074 6865 2073 6f75 7263 6520 7472 6565 the source tree │ │ │ │ │ -00005800: 2061 6e64 2068 6173 2074 6865 0a75 6e66 and has the.unf │ │ │ │ │ -00005810: 6f72 7475 6e61 7465 2063 6f6e 7365 7175 ortunate consequ │ │ │ │ │ -00005820: 656e 6365 2074 6861 7420 6974 2069 7320 ence that it is │ │ │ │ │ -00005830: 6e6f 7420 706f 7373 6962 6c65 2074 6f20 not possible to │ │ │ │ │ -00005840: 7370 6563 6966 7920 6469 7374 7269 6275 specify distribu │ │ │ │ │ -00005850: 7465 640a 7465 7374 7320 7468 6174 2061 ted.tests that a │ │ │ │ │ -00005860: 7265 2074 6865 6d73 656c 7665 7320 6765 re themselves ge │ │ │ │ │ -00005870: 6e65 7261 7465 6420 6279 206d 6561 6e73 nerated by means │ │ │ │ │ -00005880: 206f 6620 6578 706c 6963 6974 2072 756c of explicit rul │ │ │ │ │ -00005890: 6573 2c20 696e 2061 2077 6179 0a74 6861 es, in a way.tha │ │ │ │ │ -000058a0: 7420 6973 2070 6f72 7461 626c 6520 746f t is portable to │ │ │ │ │ -000058b0: 2061 6c6c 2027 6d61 6b65 2720 696d 706c all 'make' impl │ │ │ │ │ -000058c0: 656d 656e 7461 7469 6f6e 7320 282a 6e6f ementations (*no │ │ │ │ │ -000058d0: 7465 2028 6175 746f 636f 6e66 294d 616b te (autoconf)Mak │ │ │ │ │ -000058e0: 650a 5461 7267 6574 204c 6f6f 6b75 703a e.Target Lookup: │ │ │ │ │ -000058f0: 3a2c 2074 6865 2073 656d 616e 7469 6373 :, the semantics │ │ │ │ │ -00005900: 206f 6620 4672 6565 4253 4420 616e 6420 of FreeBSD and │ │ │ │ │ -00005910: 4f70 656e 4253 4420 276d 616b 6527 2063 OpenBSD 'make' c │ │ │ │ │ -00005920: 6f6e 666c 6963 740a 7769 7468 2074 6869 onflict.with thi │ │ │ │ │ -00005930: 7329 2e20 2049 6e20 6361 7365 206f 6620 s). In case of │ │ │ │ │ -00005940: 646f 7562 7420 796f 7520 6d61 7920 7761 doubt you may wa │ │ │ │ │ -00005950: 6e74 2074 6f20 7265 7175 6972 6520 746f nt to require to │ │ │ │ │ -00005960: 2075 7365 2047 4e55 2027 6d61 6b65 272c use GNU 'make', │ │ │ │ │ -00005970: 0a6f 7220 776f 726b 2061 726f 756e 6420 .or work around │ │ │ │ │ -00005980: 7468 6520 6973 7375 6520 7769 7468 2069 the issue with i │ │ │ │ │ -00005990: 6e66 6572 656e 6365 2072 756c 6573 2074 nference rules t │ │ │ │ │ -000059a0: 6f20 6765 6e65 7261 7465 2074 6865 2074 o generate the t │ │ │ │ │ -000059b0: 6573 7473 2e0a 0a1f 0a46 696c 653a 2061 ests.....File: a │ │ │ │ │ -000059c0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -000059d0: 6f2c 2020 4e6f 6465 3a20 4465 6a61 476e o, Node: DejaGn │ │ │ │ │ -000059e0: 7520 5465 7374 732c 2020 4e65 7874 3a20 u Tests, Next: │ │ │ │ │ -000059f0: 496e 7374 616c 6c20 5465 7374 732c 2020 Install Tests, │ │ │ │ │ -00005a00: 5072 6576 3a20 5369 6d70 6c65 2054 6573 Prev: Simple Tes │ │ │ │ │ -00005a10: 7473 2075 7369 6e67 2070 6172 616c 6c65 ts using paralle │ │ │ │ │ -00005a20: 6c2d 7465 7374 732c 2020 5570 3a20 5465 l-tests, Up: Te │ │ │ │ │ -00005a30: 7374 730a 0a31 352e 3320 4465 6a61 476e sts..15.3 DejaGn │ │ │ │ │ -00005a40: 7520 5465 7374 730a 3d3d 3d3d 3d3d 3d3d u Tests.======== │ │ │ │ │ -00005a50: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2027 ==========..If ' │ │ │ │ │ -00005a60: 6465 6a61 676e 7527 2028 6674 703a 2f2f dejagnu' (ftp:// │ │ │ │ │ -00005a70: 6674 702e 676e 752e 6f72 672f 676e 752f ftp.gnu.org/gnu/ │ │ │ │ │ -00005a80: 6465 6a61 676e 752f 2920 6170 7065 6172 dejagnu/) appear │ │ │ │ │ -00005a90: 7320 696e 0a27 4155 544f 4d41 4b45 5f4f s in.'AUTOMAKE_O │ │ │ │ │ -00005aa0: 5054 494f 4e53 272c 2074 6865 6e20 6120 PTIONS', then a │ │ │ │ │ -00005ab0: 2764 656a 6167 6e75 272d 6261 7365 6420 'dejagnu'-based │ │ │ │ │ -00005ac0: 7465 7374 2073 7569 7465 2069 7320 6173 test suite is as │ │ │ │ │ -00005ad0: 7375 6d65 642e 2020 5468 650a 7661 7269 sumed. The.vari │ │ │ │ │ -00005ae0: 6162 6c65 2027 4445 4a41 544f 4f4c 2720 able 'DEJATOOL' │ │ │ │ │ -00005af0: 6973 2061 206c 6973 7420 6f66 206e 616d is a list of nam │ │ │ │ │ -00005b00: 6573 2074 6861 7420 6172 6520 7061 7373 es that are pass │ │ │ │ │ -00005b10: 6564 2c20 6f6e 6520 6174 2061 2074 696d ed, one at a tim │ │ │ │ │ -00005b20: 652c 0a61 7320 7468 6520 272d 2d74 6f6f e,.as the '--too │ │ │ │ │ -00005b30: 6c27 2061 7267 756d 656e 7420 746f 2027 l' argument to ' │ │ │ │ │ -00005b40: 7275 6e74 6573 7427 2069 6e76 6f63 6174 runtest' invocat │ │ │ │ │ -00005b50: 696f 6e73 3b20 6974 2064 6566 6175 6c74 ions; it default │ │ │ │ │ -00005b60: 7320 746f 2074 6865 0a6e 616d 6520 6f66 s to the.name of │ │ │ │ │ -00005b70: 2074 6865 2070 6163 6b61 6765 2e0a 0a20 the package... │ │ │ │ │ -00005b80: 2020 5468 6520 7661 7269 6162 6c65 2027 The variable ' │ │ │ │ │ -00005b90: 5255 4e54 4553 5444 4546 4155 4c54 464c RUNTESTDEFAULTFL │ │ │ │ │ -00005ba0: 4147 5327 2068 6f6c 6473 2074 6865 2027 AGS' holds the ' │ │ │ │ │ -00005bb0: 2d2d 746f 6f6c 2720 616e 6420 272d 2d73 --tool' and '--s │ │ │ │ │ -00005bc0: 7263 6469 7227 0a66 6c61 6773 2074 6861 rcdir'.flags tha │ │ │ │ │ -00005bd0: 7420 6172 6520 7061 7373 6564 2074 6f20 t are passed to │ │ │ │ │ -00005be0: 6465 6a61 676e 7520 6279 2064 6566 6175 dejagnu by defau │ │ │ │ │ -00005bf0: 6c74 3b20 7468 6973 2063 616e 2062 6520 lt; this can be │ │ │ │ │ -00005c00: 6f76 6572 7269 6464 656e 2069 660a 6e65 overridden if.ne │ │ │ │ │ -00005c10: 6365 7373 6172 792e 0a0a 2020 2054 6865 cessary... The │ │ │ │ │ -00005c20: 2076 6172 6961 626c 6573 2027 4558 5045 variables 'EXPE │ │ │ │ │ -00005c30: 4354 2720 616e 6420 2752 554e 5445 5354 CT' and 'RUNTEST │ │ │ │ │ -00005c40: 2720 6361 6e20 616c 736f 2062 6520 6f76 ' can also be ov │ │ │ │ │ -00005c50: 6572 7269 6464 656e 2074 6f0a 7072 6f76 erridden to.prov │ │ │ │ │ -00005c60: 6964 6520 7072 6f6a 6563 742d 7370 6563 ide project-spec │ │ │ │ │ -00005c70: 6966 6963 2076 616c 7565 732e 2020 466f ific values. Fo │ │ │ │ │ -00005c80: 7220 696e 7374 616e 6365 2c20 796f 7520 r instance, you │ │ │ │ │ -00005c90: 7769 6c6c 206e 6565 6420 746f 2064 6f20 will need to do │ │ │ │ │ -00005ca0: 7468 6973 0a69 6620 796f 7520 6172 6520 this.if you are │ │ │ │ │ -00005cb0: 7465 7374 696e 6720 6120 636f 6d70 696c testing a compil │ │ │ │ │ -00005cc0: 6572 2074 6f6f 6c63 6861 696e 2c20 6265 er toolchain, be │ │ │ │ │ -00005cd0: 6361 7573 6520 7468 6520 6465 6661 756c cause the defaul │ │ │ │ │ -00005ce0: 7420 7661 6c75 6573 2064 6f0a 6e6f 7420 t values do.not │ │ │ │ │ -00005cf0: 7461 6b65 2069 6e74 6f20 6163 636f 756e take into accoun │ │ │ │ │ -00005d00: 7420 686f 7374 2061 6e64 2074 6172 6765 t host and targe │ │ │ │ │ -00005d10: 7420 6e61 6d65 732e 0a0a 2020 2054 6865 t names... The │ │ │ │ │ -00005d20: 2063 6f6e 7465 6e74 7320 6f66 2074 6865 contents of the │ │ │ │ │ -00005d30: 2076 6172 6961 626c 6520 2752 554e 5445 variable 'RUNTE │ │ │ │ │ -00005d40: 5354 464c 4147 5327 2061 7265 2070 6173 STFLAGS' are pas │ │ │ │ │ -00005d50: 7365 6420 746f 2074 6865 0a27 7275 6e74 sed to the.'runt │ │ │ │ │ -00005d60: 6573 7427 2069 6e76 6f63 6174 696f 6e2e est' invocation. │ │ │ │ │ -00005d70: 2020 5468 6973 2069 7320 636f 6e73 6964 This is consid │ │ │ │ │ -00005d80: 6572 6564 2061 2022 7573 6572 2076 6172 ered a "user var │ │ │ │ │ -00005d90: 6961 626c 6522 2028 2a6e 6f74 6520 5573 iable" (*note Us │ │ │ │ │ -00005da0: 6572 0a56 6172 6961 626c 6573 3a3a 292e er.Variables::). │ │ │ │ │ -00005db0: 2020 4966 2079 6f75 206e 6565 6420 746f If you need to │ │ │ │ │ -00005dc0: 2073 6574 2027 7275 6e74 6573 7427 2066 set 'runtest' f │ │ │ │ │ -00005dd0: 6c61 6773 2069 6e20 274d 616b 6566 696c lags in 'Makefil │ │ │ │ │ -00005de0: 652e 616d 272c 2079 6f75 0a63 616e 2075 e.am', you.can u │ │ │ │ │ -00005df0: 7365 2027 414d 5f52 554e 5445 5354 464c se 'AM_RUNTESTFL │ │ │ │ │ -00005e00: 4147 5327 2069 6e73 7465 6164 2e0a 0a20 AGS' instead... │ │ │ │ │ -00005e10: 2020 4175 746f 6d61 6b65 2077 696c 6c20 Automake will │ │ │ │ │ -00005e20: 6765 6e65 7261 7465 2072 756c 6573 2074 generate rules t │ │ │ │ │ -00005e30: 6f20 6372 6561 7465 2061 206c 6f63 616c o create a local │ │ │ │ │ -00005e40: 2027 7369 7465 2e65 7870 2720 6669 6c65 'site.exp' file │ │ │ │ │ -00005e50: 2c0a 6465 6669 6e69 6e67 2076 6172 696f ,.defining vario │ │ │ │ │ -00005e60: 7573 2076 6172 6961 626c 6573 2064 6574 us variables det │ │ │ │ │ -00005e70: 6563 7465 6420 6279 2027 636f 6e66 6967 ected by 'config │ │ │ │ │ -00005e80: 7572 6527 2e20 2054 6869 7320 6669 6c65 ure'. This file │ │ │ │ │ -00005e90: 2069 730a 6175 746f 6d61 7469 6361 6c6c is.automaticall │ │ │ │ │ -00005ea0: 7920 7265 6164 2062 7920 4465 6a61 476e y read by DejaGn │ │ │ │ │ -00005eb0: 752e 2020 4974 2069 7320 4f4b 2066 6f72 u. It is OK for │ │ │ │ │ -00005ec0: 2074 6865 2075 7365 7220 6f66 2061 2070 the user of a p │ │ │ │ │ -00005ed0: 6163 6b61 6765 2074 6f0a 6564 6974 2074 ackage to.edit t │ │ │ │ │ -00005ee0: 6869 7320 6669 6c65 2069 6e20 6f72 6465 his file in orde │ │ │ │ │ -00005ef0: 7220 746f 2074 756e 6520 7468 6520 7465 r to tune the te │ │ │ │ │ -00005f00: 7374 2073 7569 7465 2e20 2048 6f77 6576 st suite. Howev │ │ │ │ │ -00005f10: 6572 2074 6869 7320 6973 206e 6f74 2074 er this is not t │ │ │ │ │ -00005f20: 6865 0a70 6c61 6365 2077 6865 7265 2074 he.place where t │ │ │ │ │ -00005f30: 6865 2074 6573 7420 7375 6974 6520 6175 he test suite au │ │ │ │ │ -00005f40: 7468 6f72 2073 686f 756c 6420 6465 6669 thor should defi │ │ │ │ │ -00005f50: 6e65 206e 6577 2076 6172 6961 626c 6573 ne new variables │ │ │ │ │ -00005f60: 3a20 7468 6973 0a73 686f 756c 6420 6265 : this.should be │ │ │ │ │ -00005f70: 2064 6f6e 6520 656c 7365 7768 6572 6520 done elsewhere │ │ │ │ │ -00005f80: 696e 2074 6865 2072 6561 6c20 7465 7374 in the real test │ │ │ │ │ -00005f90: 2073 7569 7465 2063 6f64 652e 2020 4573 suite code. Es │ │ │ │ │ -00005fa0: 7065 6369 616c 6c79 2c0a 2773 6974 652e pecially,.'site. │ │ │ │ │ -00005fb0: 6578 7027 2073 686f 756c 6420 6e6f 7420 exp' should not │ │ │ │ │ -00005fc0: 6265 2064 6973 7472 6962 7574 6564 2e0a be distributed.. │ │ │ │ │ -00005fd0: 0a20 2020 5374 696c 6c2c 2069 6620 7468 . Still, if th │ │ │ │ │ -00005fe0: 6520 7061 636b 6167 6520 6175 7468 6f72 e package author │ │ │ │ │ -00005ff0: 2068 6173 206c 6567 6974 696d 6174 6520 has legitimate │ │ │ │ │ -00006000: 7265 6173 6f6e 7320 746f 2065 7874 656e reasons to exten │ │ │ │ │ -00006010: 640a 2773 6974 652e 6578 7027 2061 7420 d.'site.exp' at │ │ │ │ │ -00006020: 276d 616b 6527 2074 696d 652c 2068 6520 'make' time, he │ │ │ │ │ -00006030: 6361 6e20 646f 2073 6f20 6279 2064 6566 can do so by def │ │ │ │ │ -00006040: 696e 696e 6720 7468 6520 7661 7269 6162 ining the variab │ │ │ │ │ -00006050: 6c65 0a27 4558 5452 415f 4445 4a41 474e le.'EXTRA_DEJAGN │ │ │ │ │ -00006060: 555f 5349 5445 5f43 4f4e 4649 4727 3b20 U_SITE_CONFIG'; │ │ │ │ │ -00006070: 7468 6520 6669 6c65 7320 6c69 7374 6564 the files listed │ │ │ │ │ -00006080: 2074 6865 7265 2077 696c 6c20 6265 2063 there will be c │ │ │ │ │ -00006090: 6f6e 7369 6465 7265 640a 2773 6974 652e onsidered.'site. │ │ │ │ │ -000060a0: 6578 7027 2070 7265 7265 7175 6973 6974 exp' prerequisit │ │ │ │ │ -000060b0: 6573 2c20 616e 6420 7468 6569 7220 636f es, and their co │ │ │ │ │ -000060c0: 6e74 656e 7420 7769 6c6c 2062 6520 6170 ntent will be ap │ │ │ │ │ -000060d0: 7065 6e64 6564 2074 6f20 6974 2028 696e pended to it (in │ │ │ │ │ -000060e0: 0a74 6865 2073 616d 6520 6f72 6465 7220 .the same order │ │ │ │ │ -000060f0: 696e 2077 6869 6368 2074 6865 7920 6170 in which they ap │ │ │ │ │ -00006100: 7065 6172 2069 6e20 2745 5854 5241 5f44 pear in 'EXTRA_D │ │ │ │ │ -00006110: 454a 4147 4e55 5f53 4954 455f 434f 4e46 EJAGNU_SITE_CONF │ │ │ │ │ -00006120: 4947 2729 2e0a 4e6f 7465 2074 6861 7420 IG')..Note that │ │ │ │ │ -00006130: 6669 6c65 7320 6172 6520 5f6e 6f74 5f20 files are _not_ │ │ │ │ │ -00006140: 6469 7374 7269 6275 7465 6420 6279 2064 distributed by d │ │ │ │ │ -00006150: 6566 6175 6c74 2e0a 0a20 2020 466f 7220 efault... For │ │ │ │ │ -00006160: 6d6f 7265 2069 6e66 6f72 6d61 7469 6f6e more information │ │ │ │ │ -00006170: 2072 6567 6172 6469 6e67 2044 656a 6147 regarding DejaG │ │ │ │ │ -00006180: 6e75 2074 6573 7420 7375 6974 6573 2c20 nu test suites, │ │ │ │ │ -00006190: 7365 6520 2a6e 6f74 650a 2864 656a 6167 see *note.(dejag │ │ │ │ │ -000061a0: 6e75 2954 6f70 3a3a 2e0a 0a20 2020 496e nu)Top::... In │ │ │ │ │ -000061b0: 2065 6974 6865 7220 6361 7365 2c20 7468 either case, th │ │ │ │ │ -000061c0: 6520 7465 7374 696e 6720 6973 2064 6f6e e testing is don │ │ │ │ │ -000061d0: 6520 7669 6120 276d 616b 6520 6368 6563 e via 'make chec │ │ │ │ │ -000061e0: 6b27 2e0a 0a1f 0a46 696c 653a 2061 7574 k'.....File: aut │ │ │ │ │ -000061f0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -00006200: 2020 4e6f 6465 3a20 496e 7374 616c 6c20 Node: Install │ │ │ │ │ -00006210: 5465 7374 732c 2020 5072 6576 3a20 4465 Tests, Prev: De │ │ │ │ │ -00006220: 6a61 476e 7520 5465 7374 732c 2020 5570 jaGnu Tests, Up │ │ │ │ │ -00006230: 3a20 5465 7374 730a 0a31 352e 3420 496e : Tests..15.4 In │ │ │ │ │ -00006240: 7374 616c 6c20 5465 7374 730a 3d3d 3d3d stall Tests.==== │ │ │ │ │ -00006250: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00006260: 5468 6520 2769 6e73 7461 6c6c 6368 6563 The 'installchec │ │ │ │ │ -00006270: 6b27 2074 6172 6765 7420 6973 2061 7661 k' target is ava │ │ │ │ │ -00006280: 696c 6162 6c65 2074 6f20 7468 6520 7573 ilable to the us │ │ │ │ │ -00006290: 6572 2061 7320 6120 7761 7920 746f 2072 er as a way to r │ │ │ │ │ -000062a0: 756e 2061 6e79 0a74 6573 7473 2061 6674 un any.tests aft │ │ │ │ │ -000062b0: 6572 2074 6865 2070 6163 6b61 6765 2068 er the package h │ │ │ │ │ -000062c0: 6173 2062 6565 6e20 696e 7374 616c 6c65 as been installe │ │ │ │ │ -000062d0: 642e 2020 596f 7520 6361 6e20 6164 6420 d. You can add │ │ │ │ │ -000062e0: 7465 7374 7320 746f 2074 6869 730a 6279 tests to this.by │ │ │ │ │ -000062f0: 2077 7269 7469 6e67 2061 6e20 2769 6e73 writing an 'ins │ │ │ │ │ -00006300: 7461 6c6c 6368 6563 6b2d 6c6f 6361 6c27 tallcheck-local' │ │ │ │ │ -00006310: 2072 756c 652e 0a0a 1f0a 4669 6c65 3a20 rule.....File: │ │ │ │ │ -00006320: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -00006330: 666f 2c20 204e 6f64 653a 2052 6562 7569 fo, Node: Rebui │ │ │ │ │ -00006340: 6c64 696e 672c 2020 4e65 7874 3a20 4f70 lding, Next: Op │ │ │ │ │ -00006350: 7469 6f6e 732c 2020 5072 6576 3a20 5465 tions, Prev: Te │ │ │ │ │ -00006360: 7374 732c 2020 5570 3a20 546f 700a 0a31 sts, Up: Top..1 │ │ │ │ │ -00006370: 3620 5265 6275 696c 6469 6e67 204d 616b 6 Rebuilding Mak │ │ │ │ │ -00006380: 6566 696c 6573 0a2a 2a2a 2a2a 2a2a 2a2a efiles.********* │ │ │ │ │ -00006390: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ -000063a0: 4175 746f 6d61 6b65 2067 656e 6572 6174 Automake generat │ │ │ │ │ -000063b0: 6573 2072 756c 6573 2074 6f20 6175 746f es rules to auto │ │ │ │ │ -000063c0: 6d61 7469 6361 6c6c 7920 7265 6275 696c matically rebuil │ │ │ │ │ -000063d0: 6420 274d 616b 6566 696c 6527 732c 0a27 d 'Makefile's,.' │ │ │ │ │ -000063e0: 636f 6e66 6967 7572 6527 2c20 616e 6420 configure', and │ │ │ │ │ -000063f0: 6f74 6865 7220 6465 7269 7665 6420 6669 other derived fi │ │ │ │ │ -00006400: 6c65 7320 6c69 6b65 2027 4d61 6b65 6669 les like 'Makefi │ │ │ │ │ -00006410: 6c65 2e69 6e27 2e0a 0a20 2020 4966 2079 le.in'... If y │ │ │ │ │ -00006420: 6f75 2061 7265 2075 7369 6e67 2027 414d ou are using 'AM │ │ │ │ │ -00006430: 5f4d 4149 4e54 4149 4e45 525f 4d4f 4445 _MAINTAINER_MODE │ │ │ │ │ -00006440: 2720 696e 2027 636f 6e66 6967 7572 652e ' in 'configure. │ │ │ │ │ -00006450: 6163 272c 2074 6865 6e20 7468 6573 650a ac', then these. │ │ │ │ │ -00006460: 6175 746f 6d61 7469 6320 7265 6275 696c automatic rebuil │ │ │ │ │ -00006470: 6469 6e67 2072 756c 6573 2061 7265 206f ding rules are o │ │ │ │ │ -00006480: 6e6c 7920 656e 6162 6c65 6420 696e 206d nly enabled in m │ │ │ │ │ -00006490: 6169 6e74 6169 6e65 7220 6d6f 6465 2e0a aintainer mode.. │ │ │ │ │ -000064a0: 0a20 2020 536f 6d65 7469 6d65 7320 796f . Sometimes yo │ │ │ │ │ -000064b0: 7520 6e65 6564 2074 6f20 7275 6e20 2761 u need to run 'a │ │ │ │ │ -000064c0: 636c 6f63 616c 2720 7769 7468 2061 6e20 clocal' with an │ │ │ │ │ -000064d0: 6172 6775 6d65 6e74 206c 696b 6520 272d argument like '- │ │ │ │ │ -000064e0: 4927 2074 6f0a 7465 6c6c 2069 7420 7768 I' to.tell it wh │ │ │ │ │ -000064f0: 6572 6520 746f 2066 696e 6420 272e 6d34 ere to find '.m4 │ │ │ │ │ -00006500: 2720 6669 6c65 732e 2020 5369 6e63 6520 ' files. Since │ │ │ │ │ -00006510: 736f 6d65 7469 6d65 7320 276d 616b 6527 sometimes 'make' │ │ │ │ │ -00006520: 2077 696c 6c0a 6175 746f 6d61 7469 6361 will.automatica │ │ │ │ │ -00006530: 6c6c 7920 7275 6e20 2761 636c 6f63 616c lly run 'aclocal │ │ │ │ │ -00006540: 272c 2079 6f75 206e 6565 6420 6120 7761 ', you need a wa │ │ │ │ │ -00006550: 7920 746f 2073 7065 6369 6679 2074 6865 y to specify the │ │ │ │ │ -00006560: 7365 2061 7267 756d 656e 7473 2e0a 596f se arguments..Yo │ │ │ │ │ -00006570: 7520 6361 6e20 646f 2074 6869 7320 6279 u can do this by │ │ │ │ │ -00006580: 2064 6566 696e 696e 6720 2741 434c 4f43 defining 'ACLOC │ │ │ │ │ -00006590: 414c 5f41 4d46 4c41 4753 273b 2074 6869 AL_AMFLAGS'; thi │ │ │ │ │ -000065a0: 7320 686f 6c64 7320 6172 6775 6d65 6e74 s holds argument │ │ │ │ │ -000065b0: 7320 7468 6174 0a61 7265 2070 6173 7365 s that.are passe │ │ │ │ │ -000065c0: 6420 7665 7262 6174 696d 2074 6f20 2761 d verbatim to 'a │ │ │ │ │ -000065d0: 636c 6f63 616c 272e 2020 5468 6973 2076 clocal'. This v │ │ │ │ │ -000065e0: 6172 6961 626c 6520 6973 206f 6e6c 7920 ariable is only │ │ │ │ │ -000065f0: 7573 6566 756c 2069 6e20 7468 650a 746f useful in the.to │ │ │ │ │ -00006600: 702d 6c65 7665 6c20 274d 616b 6566 696c p-level 'Makefil │ │ │ │ │ -00006610: 652e 616d 272e 0a0a 2020 2053 6f6d 6574 e.am'... Somet │ │ │ │ │ -00006620: 696d 6573 2069 7420 6973 2063 6f6e 7665 imes it is conve │ │ │ │ │ -00006630: 6e69 656e 7420 746f 2073 7570 706c 656d nient to supplem │ │ │ │ │ -00006640: 656e 7420 7468 6520 7265 6275 696c 6420 ent the rebuild │ │ │ │ │ -00006650: 7275 6c65 7320 666f 720a 2763 6f6e 6669 rules for.'confi │ │ │ │ │ -00006660: 6775 7265 2720 6f72 2027 636f 6e66 6967 gure' or 'config │ │ │ │ │ -00006670: 2e73 7461 7475 7327 2077 6974 6820 6164 .status' with ad │ │ │ │ │ -00006680: 6469 7469 6f6e 616c 2064 6570 656e 6465 ditional depende │ │ │ │ │ -00006690: 6e63 6965 732e 2020 5468 650a 7661 7269 ncies. The.vari │ │ │ │ │ -000066a0: 6162 6c65 7320 2743 4f4e 4649 4755 5245 ables 'CONFIGURE │ │ │ │ │ -000066b0: 5f44 4550 454e 4445 4e43 4945 5327 2061 _DEPENDENCIES' a │ │ │ │ │ -000066c0: 6e64 2027 434f 4e46 4947 5f53 5441 5455 nd 'CONFIG_STATU │ │ │ │ │ -000066d0: 535f 4445 5045 4e44 454e 4349 4553 2720 S_DEPENDENCIES' │ │ │ │ │ -000066e0: 6361 6e0a 6265 2075 7365 6420 746f 206c can.be used to l │ │ │ │ │ -000066f0: 6973 7420 7468 6573 6520 6578 7472 6120 ist these extra │ │ │ │ │ -00006700: 6465 7065 6e64 656e 6369 6573 2e20 2054 dependencies. T │ │ │ │ │ -00006710: 6865 7365 2076 6172 6961 626c 6573 2073 hese variables s │ │ │ │ │ -00006720: 686f 756c 6420 6265 0a64 6566 696e 6564 hould be.defined │ │ │ │ │ -00006730: 2069 6e20 616c 6c20 274d 616b 6566 696c in all 'Makefil │ │ │ │ │ -00006740: 6527 7320 6f66 2074 6865 2074 7265 6520 e's of the tree │ │ │ │ │ -00006750: 2862 6563 6175 7365 2074 6865 7365 2074 (because these t │ │ │ │ │ -00006760: 776f 2072 6562 7569 6c64 2072 756c 6573 wo rebuild rules │ │ │ │ │ -00006770: 0a61 7265 206f 7574 7075 7420 696e 2061 .are output in a │ │ │ │ │ -00006780: 6c6c 2074 6865 6d29 2c20 736f 2069 7420 ll them), so it │ │ │ │ │ -00006790: 6973 2073 6166 6572 2061 6e64 2065 6173 is safer and eas │ │ │ │ │ -000067a0: 6965 7220 746f 2027 4143 5f53 5542 5354 ier to 'AC_SUBST │ │ │ │ │ -000067b0: 2720 7468 656d 0a66 726f 6d20 2763 6f6e ' them.from 'con │ │ │ │ │ -000067c0: 6669 6775 7265 2e61 6327 2e20 2046 6f72 figure.ac'. For │ │ │ │ │ -000067d0: 2069 6e73 7461 6e63 652c 2074 6865 2066 instance, the f │ │ │ │ │ -000067e0: 6f6c 6c6f 7769 6e67 2073 7461 7465 6d65 ollowing stateme │ │ │ │ │ -000067f0: 6e74 2077 696c 6c20 6361 7573 650a 2763 nt will cause.'c │ │ │ │ │ -00006800: 6f6e 6669 6775 7265 2720 746f 2062 6520 onfigure' to be │ │ │ │ │ -00006810: 7265 7275 6e20 6561 6368 2074 696d 6520 rerun each time │ │ │ │ │ -00006820: 2776 6572 7369 6f6e 2e73 6827 2069 7320 'version.sh' is │ │ │ │ │ -00006830: 6368 616e 6765 642e 0a0a 2020 2020 2041 changed... A │ │ │ │ │ -00006840: 435f 5355 4253 5428 5b43 4f4e 4649 475f C_SUBST([CONFIG_ │ │ │ │ │ -00006850: 5354 4154 5553 5f44 4550 454e 4445 4e43 STATUS_DEPENDENC │ │ │ │ │ -00006860: 4945 535d 2c20 5b27 2428 746f 705f 7372 IES], ['$(top_sr │ │ │ │ │ -00006870: 6364 6972 292f 7665 7273 696f 6e2e 7368 cdir)/version.sh │ │ │ │ │ -00006880: 275d 290a 0a4e 6f74 6520 7468 6520 2724 '])..Note the '$ │ │ │ │ │ -00006890: 2874 6f70 5f73 7263 6469 7229 2f27 2069 (top_srcdir)/' i │ │ │ │ │ -000068a0: 6e20 7468 6520 6669 6c65 206e 616d 652e n the file name. │ │ │ │ │ -000068b0: 2020 5369 6e63 6520 7468 6973 2076 6172 Since this var │ │ │ │ │ -000068c0: 6961 626c 6520 6973 2074 6f0a 6265 2075 iable is to.be u │ │ │ │ │ -000068d0: 7365 6420 696e 2061 6c6c 2027 4d61 6b65 sed in all 'Make │ │ │ │ │ -000068e0: 6669 6c65 2773 2c20 6974 7320 7661 6c75 file's, its valu │ │ │ │ │ -000068f0: 6520 6d75 7374 2062 6520 7365 6e73 6962 e must be sensib │ │ │ │ │ -00006900: 6c65 2061 7420 616e 7920 6c65 7665 6c20 le at any level │ │ │ │ │ -00006910: 696e 0a74 6865 2062 7569 6c64 2068 6965 in.the build hie │ │ │ │ │ -00006920: 7261 7263 6879 2e0a 0a20 2020 4265 7761 rarchy... Bewa │ │ │ │ │ -00006930: 7265 206e 6f74 2074 6f20 6d69 7374 616b re not to mistak │ │ │ │ │ -00006940: 6520 2743 4f4e 4649 4755 5245 5f44 4550 e 'CONFIGURE_DEP │ │ │ │ │ -00006950: 454e 4445 4e43 4945 5327 2066 6f72 0a27 ENDENCIES' for.' │ │ │ │ │ -00006960: 434f 4e46 4947 5f53 5441 5455 535f 4445 CONFIG_STATUS_DE │ │ │ │ │ -00006970: 5045 4e44 454e 4349 4553 272e 0a0a 2020 PENDENCIES'... │ │ │ │ │ -00006980: 2027 434f 4e46 4947 5552 455f 4445 5045 'CONFIGURE_DEPE │ │ │ │ │ -00006990: 4e44 454e 4349 4553 2720 6164 6473 2064 NDENCIES' adds d │ │ │ │ │ -000069a0: 6570 656e 6465 6e63 6965 7320 746f 2074 ependencies to t │ │ │ │ │ -000069b0: 6865 2027 636f 6e66 6967 7572 6527 2072 he 'configure' r │ │ │ │ │ -000069c0: 756c 652c 0a77 686f 7365 2065 6666 6563 ule,.whose effec │ │ │ │ │ -000069d0: 7420 6973 2074 6f20 7275 6e20 2761 7574 t is to run 'aut │ │ │ │ │ -000069e0: 6f63 6f6e 6627 2e20 2054 6869 7320 7661 oconf'. This va │ │ │ │ │ -000069f0: 7269 6162 6c65 2073 686f 756c 6420 6265 riable should be │ │ │ │ │ -00006a00: 2073 656c 646f 6d20 7573 6564 2c0a 6265 seldom used,.be │ │ │ │ │ -00006a10: 6361 7573 6520 2761 7574 6f6d 616b 6527 cause 'automake' │ │ │ │ │ -00006a20: 2061 6c72 6561 6479 2074 7261 636b 7320 already tracks │ │ │ │ │ -00006a30: 276d 345f 696e 636c 7564 6527 6420 6669 'm4_include'd fi │ │ │ │ │ -00006a40: 6c65 732e 2020 486f 7765 7665 7220 6974 les. However it │ │ │ │ │ -00006a50: 2063 616e 0a62 6520 7573 6566 756c 2077 can.be useful w │ │ │ │ │ -00006a60: 6865 6e20 706c 6179 696e 6720 7472 6963 hen playing tric │ │ │ │ │ -00006a70: 6b79 2067 616d 6573 2077 6974 6820 276d ky games with 'm │ │ │ │ │ -00006a80: 345f 6573 7973 636d 6427 206f 7220 7369 4_esyscmd' or si │ │ │ │ │ -00006a90: 6d69 6c61 720a 6e6f 6e2d 7265 636f 6d6d milar.non-recomm │ │ │ │ │ -00006aa0: 656e 6461 626c 6520 6d61 6372 6f73 2077 endable macros w │ │ │ │ │ -00006ab0: 6974 6820 7369 6465 2065 6666 6563 7473 ith side effects │ │ │ │ │ -00006ac0: 2e0a 0a20 2020 2743 4f4e 4649 475f 5354 ... 'CONFIG_ST │ │ │ │ │ -00006ad0: 4154 5553 5f44 4550 454e 4445 4e43 4945 ATUS_DEPENDENCIE │ │ │ │ │ -00006ae0: 5327 2061 6464 7320 6465 7065 6e64 656e S' adds dependen │ │ │ │ │ -00006af0: 6369 6573 2074 6f20 7468 6520 2763 6f6e cies to the 'con │ │ │ │ │ -00006b00: 6669 672e 7374 6174 7573 270a 7275 6c65 fig.status'.rule │ │ │ │ │ -00006b10: 2c20 7768 6f73 6520 6566 6665 6374 2069 , whose effect i │ │ │ │ │ -00006b20: 7320 746f 2072 756e 2027 636f 6e66 6967 s to run 'config │ │ │ │ │ -00006b30: 7572 6527 2e20 2054 6869 7320 7661 7269 ure'. This vari │ │ │ │ │ -00006b40: 6162 6c65 2073 686f 756c 640a 7468 6572 able should.ther │ │ │ │ │ -00006b50: 6566 6f72 6520 6361 7272 7920 616e 7920 efore carry any │ │ │ │ │ -00006b60: 6e6f 6e2d 7374 616e 6461 7264 2073 6f75 non-standard sou │ │ │ │ │ -00006b70: 7263 6520 7468 6174 206d 6179 2062 6520 rce that may be │ │ │ │ │ -00006b80: 7265 6164 2061 7320 6120 7369 6465 0a65 read as a side.e │ │ │ │ │ -00006b90: 6666 6563 7420 6f66 2072 756e 6e69 6e67 ffect of running │ │ │ │ │ -00006ba0: 2027 636f 6e66 6967 7572 6527 2c20 6c69 'configure', li │ │ │ │ │ -00006bb0: 6b65 2027 7665 7273 696f 6e2e 7368 2720 ke 'version.sh' │ │ │ │ │ -00006bc0: 696e 2074 6865 2065 7861 6d70 6c65 2061 in the example a │ │ │ │ │ -00006bd0: 626f 7665 2e0a 0a20 2020 5370 6561 6b69 bove... Speaki │ │ │ │ │ -00006be0: 6e67 206f 6620 2776 6572 7369 6f6e 2e73 ng of 'version.s │ │ │ │ │ -00006bf0: 6827 2073 6372 6970 7473 2c20 7765 2072 h' scripts, we r │ │ │ │ │ -00006c00: 6563 6f6d 6d65 6e64 2061 6761 696e 7374 ecommend against │ │ │ │ │ -00006c10: 2074 6865 6d20 746f 6461 792e 0a54 6865 them today..The │ │ │ │ │ -00006c20: 7920 6172 6520 6d61 696e 6c79 2075 7365 y are mainly use │ │ │ │ │ -00006c30: 6420 7768 656e 2074 6865 2076 6572 7369 d when the versi │ │ │ │ │ -00006c40: 6f6e 206f 6620 6120 7061 636b 6167 6520 on of a package │ │ │ │ │ -00006c50: 6973 2075 7064 6174 6564 0a61 7574 6f6d is updated.autom │ │ │ │ │ -00006c60: 6174 6963 616c 6c79 2062 7920 6120 7363 atically by a sc │ │ │ │ │ -00006c70: 7269 7074 2028 652e 672e 2c20 696e 2064 ript (e.g., in d │ │ │ │ │ -00006c80: 6169 6c79 2062 7569 6c64 7329 2e20 2048 aily builds). H │ │ │ │ │ -00006c90: 6572 6520 6973 2077 6861 7420 736f 6d65 ere is what some │ │ │ │ │ -00006ca0: 0a6f 6c64 2d73 7479 6c65 2027 636f 6e66 .old-style 'conf │ │ │ │ │ -00006cb0: 6967 7572 652e 6163 2773 206d 6179 206c igure.ac's may l │ │ │ │ │ -00006cc0: 6f6f 6b20 6c69 6b65 3a0a 0a20 2020 2020 ook like:.. │ │ │ │ │ -00006cd0: 4143 5f49 4e49 540a 2020 2020 202e 2024 AC_INIT. . $ │ │ │ │ │ -00006ce0: 7372 6364 6972 2f76 6572 7369 6f6e 2e73 srcdir/version.s │ │ │ │ │ -00006cf0: 680a 2020 2020 2041 4d5f 494e 4954 5f41 h. AM_INIT_A │ │ │ │ │ -00006d00: 5554 4f4d 414b 4528 5b6e 616d 655d 2c20 UTOMAKE([name], │ │ │ │ │ -00006d10: 2456 4552 5349 4f4e 5f4e 554d 4245 5229 $VERSION_NUMBER) │ │ │ │ │ -00006d20: 0a20 2020 2020 2e2e 2e0a 0a48 6572 652c . .....Here, │ │ │ │ │ -00006d30: 2027 7665 7273 696f 6e2e 7368 2720 6973 'version.sh' is │ │ │ │ │ -00006d40: 2061 2073 6865 6c6c 2066 7261 676d 656e a shell fragmen │ │ │ │ │ -00006d50: 7420 7468 6174 2073 6574 7320 2756 4552 t that sets 'VER │ │ │ │ │ -00006d60: 5349 4f4e 5f4e 554d 4245 5227 2e20 2054 SION_NUMBER'. T │ │ │ │ │ -00006d70: 6865 0a70 726f 626c 656d 2077 6974 6820 he.problem with │ │ │ │ │ -00006d80: 7468 6973 2065 7861 6d70 6c65 2069 7320 this example is │ │ │ │ │ -00006d90: 7468 6174 2027 6175 746f 6d61 6b65 2720 that 'automake' │ │ │ │ │ -00006da0: 6361 6e6e 6f74 2074 7261 636b 2064 6570 cannot track dep │ │ │ │ │ -00006db0: 656e 6465 6e63 6965 730a 286c 6973 7469 endencies.(listi │ │ │ │ │ -00006dc0: 6e67 2027 7665 7273 696f 6e2e 7368 2720 ng 'version.sh' │ │ │ │ │ -00006dd0: 696e 2027 434f 4e46 4947 5f53 5441 5455 in 'CONFIG_STATU │ │ │ │ │ -00006de0: 535f 4445 5045 4e44 454e 4349 4553 272c S_DEPENDENCIES', │ │ │ │ │ -00006df0: 2061 6e64 2064 6973 7472 6962 7574 696e and distributin │ │ │ │ │ -00006e00: 670a 7468 6973 2066 696c 6520 6973 2075 g.this file is u │ │ │ │ │ -00006e10: 7020 746f 2074 6865 2075 7365 7229 2c20 p to the user), │ │ │ │ │ -00006e20: 616e 6420 7468 6174 2069 7420 7573 6573 and that it uses │ │ │ │ │ -00006e30: 2074 6865 206f 6273 6f6c 6574 6520 666f the obsolete fo │ │ │ │ │ -00006e40: 726d 206f 660a 2741 435f 494e 4954 2720 rm of.'AC_INIT' │ │ │ │ │ -00006e50: 616e 6420 2741 4d5f 494e 4954 5f41 5554 and 'AM_INIT_AUT │ │ │ │ │ -00006e60: 4f4d 414b 4527 2e20 2055 7067 7261 6469 OMAKE'. Upgradi │ │ │ │ │ -00006e70: 6e67 2074 6f20 7468 6520 6e65 7720 7379 ng to the new sy │ │ │ │ │ -00006e80: 6e74 6178 2069 7320 6e6f 740a 7374 7261 ntax is not.stra │ │ │ │ │ -00006e90: 6967 6874 666f 7277 6172 642c 2062 6563 ightforward, bec │ │ │ │ │ -00006ea0: 6175 7365 2073 6865 6c6c 2076 6172 6961 ause shell varia │ │ │ │ │ -00006eb0: 626c 6573 2061 7265 206e 6f74 2061 6c6c bles are not all │ │ │ │ │ -00006ec0: 6f77 6564 2069 6e20 2741 435f 494e 4954 owed in 'AC_INIT │ │ │ │ │ -00006ed0: 2727 730a 6172 6775 6d65 6e74 732e 2020 ''s.arguments. │ │ │ │ │ -00006ee0: 5765 2072 6563 6f6d 6d65 6e64 2074 6861 We recommend tha │ │ │ │ │ -00006ef0: 7420 2776 6572 7369 6f6e 2e73 6827 2062 t 'version.sh' b │ │ │ │ │ -00006f00: 6520 7265 706c 6163 6564 2062 7920 616e e replaced by an │ │ │ │ │ -00006f10: 204d 3420 6669 6c65 0a74 6861 7420 6973 M4 file.that is │ │ │ │ │ -00006f20: 2069 6e63 6c75 6465 6420 6279 2027 636f included by 'co │ │ │ │ │ -00006f30: 6e66 6967 7572 652e 6163 273a 0a0a 2020 nfigure.ac':.. │ │ │ │ │ -00006f40: 2020 206d 345f 696e 636c 7564 6528 5b76 m4_include([v │ │ │ │ │ -00006f50: 6572 7369 6f6e 2e6d 345d 290a 2020 2020 ersion.m4]). │ │ │ │ │ -00006f60: 2041 435f 494e 4954 285b 6e61 6d65 5d2c AC_INIT([name], │ │ │ │ │ -00006f70: 2056 4552 5349 4f4e 5f4e 554d 4245 5229 VERSION_NUMBER) │ │ │ │ │ -00006f80: 0a20 2020 2020 414d 5f49 4e49 545f 4155 . AM_INIT_AU │ │ │ │ │ -00006f90: 544f 4d41 4b45 0a20 2020 2020 2e2e 2e0a TOMAKE. .... │ │ │ │ │ -00006fa0: 0a48 6572 6520 2776 6572 7369 6f6e 2e6d .Here 'version.m │ │ │ │ │ -00006fb0: 3427 2063 6f75 6c64 2063 6f6e 7461 696e 4' could contain │ │ │ │ │ -00006fc0: 2073 6f6d 6574 6869 6e67 206c 696b 650a something like. │ │ │ │ │ -00006fd0: 276d 345f 6465 6669 6e65 285b 5645 5253 'm4_define([VERS │ │ │ │ │ -00006fe0: 494f 4e5f 4e55 4d42 4552 5d2c 205b 312e ION_NUMBER], [1. │ │ │ │ │ -00006ff0: 325d 2927 2e20 2054 6865 2061 6476 616e 2])'. The advan │ │ │ │ │ -00007000: 7461 6765 206f 6620 7468 6973 2073 6563 tage of this sec │ │ │ │ │ -00007010: 6f6e 6420 666f 726d 0a69 7320 7468 6174 ond form.is that │ │ │ │ │ -00007020: 2027 6175 746f 6d61 6b65 2720 7769 6c6c 'automake' will │ │ │ │ │ -00007030: 2074 616b 6520 6361 7265 206f 6620 7468 take care of th │ │ │ │ │ -00007040: 6520 6465 7065 6e64 656e 6369 6573 2077 e dependencies w │ │ │ │ │ -00007050: 6865 6e20 6465 6669 6e69 6e67 2074 6865 hen defining the │ │ │ │ │ -00007060: 0a72 6562 7569 6c64 2072 756c 652c 2061 .rebuild rule, a │ │ │ │ │ -00007070: 6e64 2077 696c 6c20 616c 736f 2064 6973 nd will also dis │ │ │ │ │ -00007080: 7472 6962 7574 6520 7468 6520 6669 6c65 tribute the file │ │ │ │ │ -00007090: 2061 7574 6f6d 6174 6963 616c 6c79 2e20 automatically. │ │ │ │ │ -000070a0: 2041 6e0a 696e 636f 6e76 656e 6965 6e63 An.inconvenienc │ │ │ │ │ -000070b0: 6520 6973 2074 6861 7420 2761 7574 6f63 e is that 'autoc │ │ │ │ │ -000070c0: 6f6e 6627 2077 696c 6c20 6e6f 7720 6265 onf' will now be │ │ │ │ │ -000070d0: 2072 6572 756e 2065 6163 6820 7469 6d65 rerun each time │ │ │ │ │ -000070e0: 2074 6865 2076 6572 7369 6f6e 0a6e 756d the version.num │ │ │ │ │ -000070f0: 6265 7220 6973 2062 756d 7065 642c 2077 ber is bumped, w │ │ │ │ │ -00007100: 6865 6e20 6f6e 6c79 2027 636f 6e66 6967 hen only 'config │ │ │ │ │ -00007110: 7572 6527 2068 6164 2074 6f20 6265 2072 ure' had to be r │ │ │ │ │ -00007120: 6572 756e 2069 6e20 7468 6520 7072 6576 erun in the prev │ │ │ │ │ -00007130: 696f 7573 0a73 6574 7570 2e0a 0a1f 0a46 ious.setup.....F │ │ │ │ │ -00007140: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -00007150: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -00007160: 4f70 7469 6f6e 732c 2020 4e65 7874 3a20 Options, Next: │ │ │ │ │ -00007170: 4d69 7363 656c 6c61 6e65 6f75 732c 2020 Miscellaneous, │ │ │ │ │ -00007180: 5072 6576 3a20 5265 6275 696c 6469 6e67 Prev: Rebuilding │ │ │ │ │ -00007190: 2c20 2055 703a 2054 6f70 0a0a 3137 2043 , Up: Top..17 C │ │ │ │ │ -000071a0: 6861 6e67 696e 6720 4175 746f 6d61 6b65 hanging Automake │ │ │ │ │ -000071b0: 2773 2042 6568 6176 696f 720a 2a2a 2a2a 's Behavior.**** │ │ │ │ │ +00003700: 3d3d 3d3d 3d3d 0a0a 5468 6520 6f70 7469 ======..The opti │ │ │ │ │ +00003710: 6f6e 2027 7061 7261 6c6c 656c 2d74 6573 on 'parallel-tes │ │ │ │ │ +00003720: 7473 2720 282a 6e6f 7465 204f 7074 696f ts' (*note Optio │ │ │ │ │ +00003730: 6e73 3a3a 2920 656e 6162 6c65 7320 6120 ns::) enables a │ │ │ │ │ +00003740: 7465 7374 2073 7569 7465 0a64 7269 7665 test suite.drive │ │ │ │ │ +00003750: 7220 7468 6174 2069 7320 6d6f 7374 6c79 r that is mostly │ │ │ │ │ +00003760: 2063 6f6d 7061 7469 626c 6520 746f 2074 compatible to t │ │ │ │ │ +00003770: 6865 2073 696d 706c 6520 7465 7374 2064 he simple test d │ │ │ │ │ +00003780: 7269 7665 7220 6465 7363 7269 6265 6420 river described │ │ │ │ │ +00003790: 696e 0a74 6865 2070 7265 7669 6f75 7320 in.the previous │ │ │ │ │ +000037a0: 7365 6374 696f 6e2c 2062 7574 2070 726f section, but pro │ │ │ │ │ +000037b0: 7669 6465 7320 6120 6665 7720 6d6f 7265 vides a few more │ │ │ │ │ +000037c0: 2066 6561 7475 7265 7320 616e 6420 736c features and sl │ │ │ │ │ +000037d0: 6967 6874 6c79 0a64 6966 6665 7265 6e74 ightly.different │ │ │ │ │ +000037e0: 2073 656d 616e 7469 6373 2e20 2049 7420 semantics. It │ │ │ │ │ +000037f0: 6665 6174 7572 6573 2063 6f6e 6375 7272 features concurr │ │ │ │ │ +00003800: 656e 7420 6578 6563 7574 696f 6e20 6f66 ent execution of │ │ │ │ │ +00003810: 2074 6573 7473 2077 6974 680a 276d 616b tests with.'mak │ │ │ │ │ +00003820: 6520 2d6a 2720 616e 6420 6175 746f 6d61 e -j' and automa │ │ │ │ │ +00003830: 7469 6320 636f 6c6c 6563 7469 6f6e 206f tic collection o │ │ │ │ │ +00003840: 6620 7468 6520 7465 7374 2073 6372 6970 f the test scrip │ │ │ │ │ +00003850: 7473 206f 7574 7075 7420 616e 640a 7375 ts output and.su │ │ │ │ │ +00003860: 6d6d 6172 7920 7468 6572 656f 6620 696e mmary thereof in │ │ │ │ │ +00003870: 2027 2e6c 6f67 2720 6669 6c65 732c 2061 '.log' files, a │ │ │ │ │ +00003880: 6e64 2061 6c6c 6f77 7320 746f 2073 7065 nd allows to spe │ │ │ │ │ +00003890: 6369 6679 2069 6e74 6572 2d74 6573 740a cify inter-test. │ │ │ │ │ +000038a0: 6465 7065 6e64 656e 6369 6573 2c20 6c61 dependencies, la │ │ │ │ │ +000038b0: 7a79 2072 6572 756e 7320 6f66 2074 6573 zy reruns of tes │ │ │ │ │ +000038c0: 7473 2074 6861 7420 6861 7665 206e 6f74 ts that have not │ │ │ │ │ +000038d0: 2063 6f6d 706c 6574 6564 2069 6e20 6120 completed in a │ │ │ │ │ +000038e0: 7072 696f 720a 7275 6e2c 2061 6e64 2068 prior.run, and h │ │ │ │ │ +000038f0: 6172 6420 6572 726f 7273 2066 6f72 2065 ard errors for e │ │ │ │ │ +00003900: 7863 6570 7469 6f6e 616c 2066 6169 6c75 xceptional failu │ │ │ │ │ +00003910: 7265 732e 2020 5369 6d69 6c61 7220 746f res. Similar to │ │ │ │ │ +00003920: 2074 6865 2073 696d 706c 650a 7465 7374 the simple.test │ │ │ │ │ +00003930: 2064 7269 7665 722c 2027 5445 5354 535f driver, 'TESTS_ │ │ │ │ │ +00003940: 454e 5649 524f 4e4d 454e 5427 2c20 2741 ENVIRONMENT', 'A │ │ │ │ │ +00003950: 4d5f 434f 4c4f 525f 5445 5354 5327 2c20 M_COLOR_TESTS', │ │ │ │ │ +00003960: 2758 4641 494c 5f54 4553 5453 272c 2061 'XFAIL_TESTS', a │ │ │ │ │ +00003970: 6e64 0a74 6865 2027 6368 6563 6b5f 2a27 nd.the 'check_*' │ │ │ │ │ +00003980: 2076 6172 6961 626c 6573 2061 7265 2068 variables are h │ │ │ │ │ +00003990: 6f6e 6f72 6564 2c20 616e 6420 7468 6520 onored, and the │ │ │ │ │ +000039a0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +000039b0: 6162 6c65 0a27 7372 6364 6972 2720 6973 able.'srcdir' is │ │ │ │ │ +000039c0: 2073 6574 2064 7572 696e 6720 7465 7374 set during test │ │ │ │ │ +000039d0: 2065 7865 6375 7469 6f6e 2e0a 0a20 2020 execution... │ │ │ │ │ +000039e0: 5468 6973 2074 6573 7420 6472 6976 6572 This test driver │ │ │ │ │ +000039f0: 2069 7320 7374 696c 6c20 6578 7065 7269 is still experi │ │ │ │ │ +00003a00: 6d65 6e74 616c 2061 6e64 206d 6179 2075 mental and may u │ │ │ │ │ +00003a10: 6e64 6572 676f 2063 6861 6e67 6573 2069 ndergo changes i │ │ │ │ │ +00003a20: 6e0a 6f72 6465 7220 746f 2073 6174 6973 n.order to satis │ │ │ │ │ +00003a30: 6679 2061 6464 6974 696f 6e61 6c20 706f fy additional po │ │ │ │ │ +00003a40: 7274 6162 696c 6974 7920 7265 7175 6972 rtability requir │ │ │ │ │ +00003a50: 656d 656e 7473 2e0a 0a20 2020 5468 6520 ements... The │ │ │ │ │ +00003a60: 6472 6976 6572 206f 7065 7261 7465 7320 driver operates │ │ │ │ │ +00003a70: 6279 2064 6566 696e 696e 6720 6120 7365 by defining a se │ │ │ │ │ +00003a80: 7420 6f66 2027 6d61 6b65 2720 7275 6c65 t of 'make' rule │ │ │ │ │ +00003a90: 7320 746f 2063 7265 6174 6520 610a 7375 s to create a.su │ │ │ │ │ +00003aa0: 6d6d 6172 7920 6c6f 6720 6669 6c65 2c20 mmary log file, │ │ │ │ │ +00003ab0: 2754 4553 545f 5355 4954 455f 4c4f 4727 'TEST_SUITE_LOG' │ │ │ │ │ +00003ac0: 2c20 7768 6963 6820 6465 6661 756c 7473 , which defaults │ │ │ │ │ +00003ad0: 2074 6f20 2774 6573 742d 7375 6974 652e to 'test-suite. │ │ │ │ │ +00003ae0: 6c6f 6727 0a61 6e64 2072 6571 7569 7265 log'.and require │ │ │ │ │ +00003af0: 7320 6120 272e 6c6f 6727 2073 7566 6669 s a '.log' suffi │ │ │ │ │ +00003b00: 782e 2020 5468 6973 2066 696c 6520 6465 x. This file de │ │ │ │ │ +00003b10: 7065 6e64 7320 7570 6f6e 206c 6f67 2066 pends upon log f │ │ │ │ │ +00003b20: 696c 6573 2063 7265 6174 6564 0a66 6f72 iles created.for │ │ │ │ │ +00003b30: 2065 6163 6820 7369 6e67 6c65 2074 6573 each single tes │ │ │ │ │ +00003b40: 7420 7072 6f67 7261 6d20 6c69 7374 6564 t program listed │ │ │ │ │ +00003b50: 2069 6e20 2754 4553 5453 272c 2077 6869 in 'TESTS', whi │ │ │ │ │ +00003b60: 6368 2069 6e20 7475 726e 2063 6f6e 7461 ch in turn conta │ │ │ │ │ +00003b70: 696e 0a61 6c6c 206f 7574 7075 7420 7072 in.all output pr │ │ │ │ │ +00003b80: 6f64 7563 6564 2062 7920 7468 6520 636f oduced by the co │ │ │ │ │ +00003b90: 7272 6573 706f 6e64 696e 6720 7465 7374 rresponding test │ │ │ │ │ +00003ba0: 732e 0a0a 2020 2045 6163 6820 6c6f 6720 s... Each log │ │ │ │ │ +00003bb0: 6669 6c65 2069 7320 6372 6561 7465 6420 file is created │ │ │ │ │ +00003bc0: 7768 656e 2074 6865 2063 6f72 7265 7370 when the corresp │ │ │ │ │ +00003bd0: 6f6e 6469 6e67 2074 6573 7420 6861 7320 onding test has │ │ │ │ │ +00003be0: 636f 6d70 6c65 7465 642e 0a54 6865 2073 completed..The s │ │ │ │ │ +00003bf0: 6574 206f 6620 6c6f 6720 6669 6c65 7320 et of log files │ │ │ │ │ +00003c00: 6973 206c 6973 7465 6420 696e 2074 6865 is listed in the │ │ │ │ │ +00003c10: 2072 6561 642d 6f6e 6c79 2076 6172 6961 read-only varia │ │ │ │ │ +00003c20: 626c 6520 2754 4553 545f 4c4f 4753 272c ble 'TEST_LOGS', │ │ │ │ │ +00003c30: 0a61 6e64 2064 6566 6175 6c74 7320 746f .and defaults to │ │ │ │ │ +00003c40: 2027 5445 5354 5327 2c20 7769 7468 2074 'TESTS', with t │ │ │ │ │ +00003c50: 6865 2065 7865 6375 7461 626c 6520 6578 he executable ex │ │ │ │ │ +00003c60: 7465 6e73 696f 6e20 6966 2061 6e79 2028 tension if any ( │ │ │ │ │ +00003c70: 2a6e 6f74 650a 4558 4545 5854 3a3a 292c *note.EXEEXT::), │ │ │ │ │ +00003c80: 2061 7320 7765 6c6c 2061 7320 616e 7920 as well as any │ │ │ │ │ +00003c90: 7375 6666 6978 206c 6973 7465 6420 696e suffix listed in │ │ │ │ │ +00003ca0: 2027 5445 5354 5f45 5854 454e 5349 4f4e 'TEST_EXTENSION │ │ │ │ │ +00003cb0: 5327 2072 656d 6f76 6564 2c0a 616e 6420 S' removed,.and │ │ │ │ │ +00003cc0: 272e 6c6f 6727 2061 7070 656e 6465 642e '.log' appended. │ │ │ │ │ +00003cd0: 2020 5265 7375 6c74 7320 6172 6520 756e Results are un │ │ │ │ │ +00003ce0: 6465 6669 6e65 6420 6966 2061 2074 6573 defined if a tes │ │ │ │ │ +00003cf0: 7420 6669 6c65 206e 616d 6520 656e 6473 t file name ends │ │ │ │ │ +00003d00: 2069 6e0a 7365 7665 7261 6c20 636f 6e63 in.several conc │ │ │ │ │ +00003d10: 6174 656e 6174 6564 2073 7566 6669 7865 atenated suffixe │ │ │ │ │ +00003d20: 732e 2020 2754 4553 545f 4558 5445 4e53 s. 'TEST_EXTENS │ │ │ │ │ +00003d30: 494f 4e53 2720 6465 6661 756c 7473 2074 IONS' defaults t │ │ │ │ │ +00003d40: 6f20 272e 7465 7374 273b 0a69 7420 6361 o '.test';.it ca │ │ │ │ │ +00003d50: 6e20 6265 206f 7665 7272 6964 6465 6e20 n be overridden │ │ │ │ │ +00003d60: 6279 2074 6865 2075 7365 722c 2069 6e20 by the user, in │ │ │ │ │ +00003d70: 7768 6963 6820 6361 7365 2061 6e79 2065 which case any e │ │ │ │ │ +00003d80: 7874 656e 7369 6f6e 206c 6973 7465 6420 xtension listed │ │ │ │ │ +00003d90: 696e 0a69 7420 6d75 7374 2062 6520 636f in.it must be co │ │ │ │ │ +00003da0: 6e73 7469 7475 7465 6420 6279 2061 2064 nstituted by a d │ │ │ │ │ +00003db0: 6f74 2c20 666f 6c6c 6f77 6564 2062 7920 ot, followed by │ │ │ │ │ +00003dc0: 6120 6e6f 6e2d 6469 6769 7420 616c 7068 a non-digit alph │ │ │ │ │ +00003dd0: 6162 6574 6963 0a63 6861 7261 6374 6572 abetic.character │ │ │ │ │ +00003de0: 2c20 666f 6c6c 6f77 6564 2062 7920 616e , followed by an │ │ │ │ │ +00003df0: 7920 6e75 6d62 6572 206f 6620 616c 7068 y number of alph │ │ │ │ │ +00003e00: 6162 6574 6963 2063 6861 7261 6374 6572 abetic character │ │ │ │ │ +00003e10: 732e 2020 466f 720a 6578 616d 706c 652c s. For.example, │ │ │ │ │ +00003e20: 2027 2e73 6827 2c20 272e 5427 2061 6e64 '.sh', '.T' and │ │ │ │ │ +00003e30: 2027 2e74 3127 2061 7265 2076 616c 6964 '.t1' are valid │ │ │ │ │ +00003e40: 2065 7874 656e 7369 6f6e 732c 2077 6869 extensions, whi │ │ │ │ │ +00003e50: 6c65 2027 2e78 2d79 272c 2027 2e36 6327 le '.x-y', '.6c' │ │ │ │ │ +00003e60: 0a61 6e64 2027 2e74 2e31 2720 6172 6520 .and '.t.1' are │ │ │ │ │ +00003e70: 6e6f 742e 0a0a 2020 2046 6f72 2074 6573 not... For tes │ │ │ │ │ +00003e80: 7473 2074 6861 7420 6d61 7463 6820 616e ts that match an │ │ │ │ │ +00003e90: 2065 7874 656e 7369 6f6e 2027 2e45 5854 extension '.EXT │ │ │ │ │ +00003ea0: 2720 6c69 7374 6564 2069 6e20 2754 4553 ' listed in 'TES │ │ │ │ │ +00003eb0: 545f 4558 5445 4e53 494f 4e53 272c 0a79 T_EXTENSIONS',.y │ │ │ │ │ +00003ec0: 6f75 2063 616e 2070 726f 7669 6465 2061 ou can provide a │ │ │ │ │ +00003ed0: 2074 6573 7420 6472 6976 6572 2075 7369 test driver usi │ │ │ │ │ +00003ee0: 6e67 2074 6865 2076 6172 6961 626c 6520 ng the variable │ │ │ │ │ +00003ef0: 2745 5854 5f4c 4f47 5f43 4f4d 5049 4c45 'EXT_LOG_COMPILE │ │ │ │ │ +00003f00: 5227 0a28 6e6f 7465 2074 6865 2075 7070 R'.(note the upp │ │ │ │ │ +00003f10: 6572 2d63 6173 6520 6578 7465 6e73 696f er-case extensio │ │ │ │ │ +00003f20: 6e29 2061 6e64 2070 6173 7320 6f70 7469 n) and pass opti │ │ │ │ │ +00003f30: 6f6e 7320 696e 2027 414d 5f45 5854 5f4c ons in 'AM_EXT_L │ │ │ │ │ +00003f40: 4f47 5f46 4c41 4753 270a 616e 6420 616c OG_FLAGS'.and al │ │ │ │ │ +00003f50: 6c6f 7720 7468 6520 7573 6572 2074 6f20 low the user to │ │ │ │ │ +00003f60: 7061 7373 206f 7074 696f 6e73 2069 6e20 pass options in │ │ │ │ │ +00003f70: 2745 5854 5f4c 4f47 5f46 4c41 4753 272e 'EXT_LOG_FLAGS'. │ │ │ │ │ +00003f80: 2020 4974 2077 696c 6c20 6361 7573 650a It will cause. │ │ │ │ │ +00003f90: 616c 6c20 7465 7374 7320 7769 7468 2074 all tests with t │ │ │ │ │ +00003fa0: 6869 7320 6578 7465 6e73 696f 6e20 746f his extension to │ │ │ │ │ +00003fb0: 2062 6520 6361 6c6c 6564 2077 6974 6820 be called with │ │ │ │ │ +00003fc0: 7468 6973 2064 7269 7665 722e 2020 466f this driver. Fo │ │ │ │ │ +00003fd0: 7220 616c 6c0a 7465 7374 7320 7769 7468 r all.tests with │ │ │ │ │ +00003fe0: 6f75 7420 6120 7265 6769 7374 6572 6564 out a registered │ │ │ │ │ +00003ff0: 2065 7874 656e 7369 6f6e 2c20 7468 6520 extension, the │ │ │ │ │ +00004000: 7661 7269 6162 6c65 7320 274c 4f47 5f43 variables 'LOG_C │ │ │ │ │ +00004010: 4f4d 5049 4c45 5227 2c0a 2741 4d5f 4c4f OMPILER',.'AM_LO │ │ │ │ │ +00004020: 475f 464c 4147 5327 2c20 616e 6420 274c G_FLAGS', and 'L │ │ │ │ │ +00004030: 4f47 5f46 4c41 4753 2720 6d61 7920 6265 OG_FLAGS' may be │ │ │ │ │ +00004040: 2075 7365 642e 2020 466f 7220 6578 616d used. For exam │ │ │ │ │ +00004050: 706c 652c 0a0a 2020 2020 2054 4553 5453 ple,.. TESTS │ │ │ │ │ +00004060: 203d 2066 6f6f 2e70 6c20 6261 722e 7079 = foo.pl bar.py │ │ │ │ │ +00004070: 2062 617a 0a20 2020 2020 5445 5354 5f45 baz. TEST_E │ │ │ │ │ +00004080: 5854 454e 5349 4f4e 5320 3d20 2e70 6c20 XTENSIONS = .pl │ │ │ │ │ +00004090: 2e70 790a 2020 2020 2050 4c5f 4c4f 475f .py. PL_LOG_ │ │ │ │ │ +000040a0: 434f 4d50 494c 4552 203d 2024 2850 4552 COMPILER = $(PER │ │ │ │ │ +000040b0: 4c29 0a20 2020 2020 414d 5f50 4c5f 4c4f L). AM_PL_LO │ │ │ │ │ +000040c0: 475f 464c 4147 5320 3d20 2d77 0a20 2020 G_FLAGS = -w. │ │ │ │ │ +000040d0: 2020 5059 5f4c 4f47 5f43 4f4d 5049 4c45 PY_LOG_COMPILE │ │ │ │ │ +000040e0: 5220 3d20 2428 5059 5448 4f4e 290a 2020 R = $(PYTHON). │ │ │ │ │ +000040f0: 2020 2041 4d5f 5059 5f4c 4f47 5f46 4c41 AM_PY_LOG_FLA │ │ │ │ │ +00004100: 4753 203d 202d 760a 2020 2020 204c 4f47 GS = -v. LOG │ │ │ │ │ +00004110: 5f43 4f4d 5049 4c45 5220 3d20 2e2f 7772 _COMPILER = ./wr │ │ │ │ │ +00004120: 6170 7065 722d 7363 7269 7074 0a20 2020 apper-script. │ │ │ │ │ +00004130: 2020 414d 5f4c 4f47 5f46 4c41 4753 203d AM_LOG_FLAGS = │ │ │ │ │ +00004140: 202d 640a 0a77 696c 6c20 696e 766f 6b65 -d..will invoke │ │ │ │ │ +00004150: 2027 2428 5045 524c 2920 2d77 2066 6f6f '$(PERL) -w foo │ │ │ │ │ +00004160: 2e70 6c27 2c20 2724 2850 5954 484f 4e29 .pl', '$(PYTHON) │ │ │ │ │ +00004170: 202d 7620 6261 722e 7079 272c 2061 6e64 -v bar.py', and │ │ │ │ │ +00004180: 0a27 2e2f 7772 6170 7065 722d 7363 7269 .'./wrapper-scri │ │ │ │ │ +00004190: 7074 202d 6420 6261 7a27 2074 6f20 7072 pt -d baz' to pr │ │ │ │ │ +000041a0: 6f64 7563 6520 2766 6f6f 2e6c 6f67 272c oduce 'foo.log', │ │ │ │ │ +000041b0: 2027 6261 722e 6c6f 6727 2c20 616e 640a 'bar.log', and. │ │ │ │ │ +000041c0: 2762 617a 2e6c 6f67 272c 2072 6573 7065 'baz.log', respe │ │ │ │ │ +000041d0: 6374 6976 656c 792e 2020 5468 6520 2754 ctively. The 'T │ │ │ │ │ +000041e0: 4553 5453 5f45 4e56 4952 4f4e 4d45 4e54 ESTS_ENVIRONMENT │ │ │ │ │ +000041f0: 2720 7661 7269 6162 6c65 2069 7320 7374 ' variable is st │ │ │ │ │ +00004200: 696c 6c0a 6578 7061 6e64 6564 2062 6566 ill.expanded bef │ │ │ │ │ +00004210: 6f72 6520 7468 6520 6472 6976 6572 2c20 ore the driver, │ │ │ │ │ +00004220: 6275 7420 7368 6f75 6c64 2062 6520 7265 but should be re │ │ │ │ │ +00004230: 7365 7276 6564 2066 6f72 2074 6865 2075 served for the u │ │ │ │ │ +00004240: 7365 722e 0a0a 2020 2041 7320 7769 7468 ser... As with │ │ │ │ │ +00004250: 2074 6865 2073 696d 706c 6520 6472 6976 the simple driv │ │ │ │ │ +00004260: 6572 2061 626f 7665 2c20 6279 2064 6566 er above, by def │ │ │ │ │ +00004270: 6175 6c74 206f 6e65 2073 7461 7475 7320 ault one status │ │ │ │ │ +00004280: 6c69 6e65 2069 730a 7072 696e 7465 6420 line is.printed │ │ │ │ │ +00004290: 7065 7220 636f 6d70 6c65 7465 6420 7465 per completed te │ │ │ │ │ +000042a0: 7374 2c20 616e 6420 6120 7368 6f72 7420 st, and a short │ │ │ │ │ +000042b0: 7375 6d6d 6172 7920 6166 7465 7220 7468 summary after th │ │ │ │ │ +000042c0: 6520 7375 6974 6520 6861 730a 636f 6d70 e suite has.comp │ │ │ │ │ +000042d0: 6c65 7465 642e 2020 486f 7765 7665 722c leted. However, │ │ │ │ │ +000042e0: 2073 7461 6e64 6172 6420 6f75 7470 7574 standard output │ │ │ │ │ +000042f0: 2061 6e64 2073 7461 6e64 6172 6420 6572 and standard er │ │ │ │ │ +00004300: 726f 7220 6f66 2074 6865 2074 6573 7420 ror of the test │ │ │ │ │ +00004310: 6172 650a 7265 6469 7265 6374 6564 2074 are.redirected t │ │ │ │ │ +00004320: 6f20 6120 7065 722d 7465 7374 206c 6f67 o a per-test log │ │ │ │ │ +00004330: 2066 696c 652c 2073 6f20 7468 6174 2070 file, so that p │ │ │ │ │ +00004340: 6172 616c 6c65 6c20 6578 6563 7574 696f arallel executio │ │ │ │ │ +00004350: 6e20 646f 6573 206e 6f74 0a70 726f 6475 n does not.produ │ │ │ │ │ +00004360: 6365 2069 6e74 6572 6d69 6e67 6c65 6420 ce intermingled │ │ │ │ │ +00004370: 6f75 7470 7574 2e20 2054 6865 206f 7574 output. The out │ │ │ │ │ +00004380: 7075 7420 6672 6f6d 2066 6169 6c65 6420 put from failed │ │ │ │ │ +00004390: 7465 7374 7320 6973 2063 6f6c 6c65 6374 tests is collect │ │ │ │ │ +000043a0: 6564 0a69 6e20 7468 6520 2774 6573 742d ed.in the 'test- │ │ │ │ │ +000043b0: 7375 6974 652e 6c6f 6727 2066 696c 652e suite.log' file. │ │ │ │ │ +000043c0: 2020 4966 2074 6865 2076 6172 6961 626c If the variabl │ │ │ │ │ +000043d0: 6520 2756 4552 424f 5345 2720 6973 2073 e 'VERBOSE' is s │ │ │ │ │ +000043e0: 6574 2c20 7468 6973 0a66 696c 6520 6973 et, this.file is │ │ │ │ │ +000043f0: 206f 7574 7075 7420 6166 7465 7220 7468 output after th │ │ │ │ │ +00004400: 6520 7375 6d6d 6172 792e 2020 466f 7220 e summary. For │ │ │ │ │ +00004410: 6265 7374 2072 6573 756c 7473 2c20 7468 best results, th │ │ │ │ │ +00004420: 6520 7465 7374 7320 7368 6f75 6c64 2062 e tests should b │ │ │ │ │ +00004430: 650a 7665 7262 6f73 6520 6279 2064 6566 e.verbose by def │ │ │ │ │ +00004440: 6175 6c74 206e 6f77 2e0a 0a20 2020 5072 ault now... Pr │ │ │ │ │ +00004450: 6576 696f 7573 2076 6572 7369 6f6e 7320 evious versions │ │ │ │ │ +00004460: 6f66 2061 7574 6f6d 616b 6520 7573 6564 of automake used │ │ │ │ │ +00004470: 2074 6f20 7072 6f76 6964 6520 6120 2763 to provide a 'c │ │ │ │ │ +00004480: 6865 636b 2d68 746d 6c27 2074 6172 6765 heck-html' targe │ │ │ │ │ +00004490: 740a 746f 2063 6f6e 7665 7274 2074 6865 t.to convert the │ │ │ │ │ +000044a0: 206c 6f67 2066 696c 6573 2074 6f20 4854 log files to HT │ │ │ │ │ +000044b0: 4d4c 2e20 5468 6973 2066 6561 7475 7265 ML. This feature │ │ │ │ │ +000044c0: 2069 7320 6e6f 7720 6465 7072 6563 6174 is now deprecat │ │ │ │ │ +000044d0: 6564 2c20 616e 640a 5f77 696c 6c20 6265 ed, and._will be │ │ │ │ │ +000044e0: 2072 656d 6f76 6564 5f20 696e 2074 6865 removed_ in the │ │ │ │ │ +000044f0: 206e 6578 7420 6d61 6a6f 7220 4175 746f next major Auto │ │ │ │ │ +00004500: 6d61 6b65 2072 656c 6561 7365 2c20 736f make release, so │ │ │ │ │ +00004510: 2064 6f6e 2774 2072 656c 7920 6f6e 0a69 don't rely on.i │ │ │ │ │ +00004520: 7420 616e 796d 6f72 652e 0a0a 2020 2045 t anymore... E │ │ │ │ │ +00004530: 7665 6e20 696e 2074 6865 2070 7265 7365 ven in the prese │ │ │ │ │ +00004540: 6e63 6520 6f66 2065 7870 6563 7465 6420 nce of expected │ │ │ │ │ +00004550: 6661 696c 7572 6573 2028 7365 6520 2758 failures (see 'X │ │ │ │ │ +00004560: 4641 494c 5f54 4553 5453 2729 2c20 7468 FAIL_TESTS'), th │ │ │ │ │ +00004570: 6572 650a 6d61 7920 6265 2063 6f6e 6469 ere.may be condi │ │ │ │ │ +00004580: 7469 6f6e 7320 756e 6465 7220 7768 6963 tions under whic │ │ │ │ │ +00004590: 6820 6120 7465 7374 206f 7574 636f 6d65 h a test outcome │ │ │ │ │ +000045a0: 206e 6565 6473 2061 7474 656e 7469 6f6e needs attention │ │ │ │ │ +000045b0: 2e20 2046 6f72 0a65 7861 6d70 6c65 2c20 . For.example, │ │ │ │ │ +000045c0: 7769 7468 2074 6573 742d 6472 6976 656e with test-driven │ │ │ │ │ +000045d0: 2064 6576 656c 6f70 6d65 6e74 2c20 796f development, yo │ │ │ │ │ +000045e0: 7520 6d61 7920 7772 6974 6520 7465 7374 u may write test │ │ │ │ │ +000045f0: 7320 666f 7220 6665 6174 7572 6573 0a74 s for features.t │ │ │ │ │ +00004600: 6861 7420 796f 7520 6861 7665 206e 6f74 hat you have not │ │ │ │ │ +00004610: 2069 6d70 6c65 6d65 6e74 6564 2079 6574 implemented yet │ │ │ │ │ +00004620: 2c20 616e 6420 7468 7573 206d 6172 6b20 , and thus mark │ │ │ │ │ +00004630: 7468 6573 6520 7465 7374 7320 6173 2065 these tests as e │ │ │ │ │ +00004640: 7870 6563 7465 640a 746f 2066 6169 6c2e xpected.to fail. │ │ │ │ │ +00004650: 2020 486f 7765 7665 722c 2079 6f75 206d However, you m │ │ │ │ │ +00004660: 6179 2073 7469 6c6c 2062 6520 696e 7465 ay still be inte │ │ │ │ │ +00004670: 7265 7374 6564 2069 6e20 6578 6365 7074 rested in except │ │ │ │ │ +00004680: 696f 6e61 6c0a 636f 6e64 6974 696f 6e73 ional.conditions │ │ │ │ │ +00004690: 2c20 666f 7220 6578 616d 706c 652c 2074 , for example, t │ │ │ │ │ +000046a0: 6573 7473 2074 6861 7420 6661 696c 2064 ests that fail d │ │ │ │ │ +000046b0: 7565 2074 6f20 6120 7365 676d 656e 7461 ue to a segmenta │ │ │ │ │ +000046c0: 7469 6f6e 2076 696f 6c61 7469 6f6e 0a6f tion violation.o │ │ │ │ │ +000046d0: 7220 616e 6f74 6865 7220 6572 726f 7220 r another error │ │ │ │ │ +000046e0: 7468 6174 2069 7320 696e 6465 7065 6e64 that is independ │ │ │ │ │ +000046f0: 656e 7420 6f66 2074 6865 2066 6561 7475 ent of the featu │ │ │ │ │ +00004700: 7265 2061 7761 6974 696e 670a 696d 706c re awaiting.impl │ │ │ │ │ +00004710: 656d 656e 7461 7469 6f6e 2e20 2054 6573 ementation. Tes │ │ │ │ │ +00004720: 7473 2063 616e 2065 7869 7420 7769 7468 ts can exit with │ │ │ │ │ +00004730: 2061 6e20 6578 6974 2073 7461 7475 7320 an exit status │ │ │ │ │ +00004740: 6f66 2039 3920 746f 2073 6967 6e61 6c20 of 99 to signal │ │ │ │ │ +00004750: 7375 6368 0a61 205f 6861 7264 2065 7272 such.a _hard err │ │ │ │ │ +00004760: 6f72 5f2e 2020 556e 6c65 7373 2074 6865 or_. Unless the │ │ │ │ │ +00004770: 2076 6172 6961 626c 6520 2744 4953 4142 variable 'DISAB │ │ │ │ │ +00004780: 4c45 5f48 4152 445f 4552 524f 5253 2720 LE_HARD_ERRORS' │ │ │ │ │ +00004790: 6973 2073 6574 2074 6f20 610a 6e6f 6e65 is set to a.none │ │ │ │ │ +000047a0: 6d70 7479 2076 616c 7565 2c20 7375 6368 mpty value, such │ │ │ │ │ +000047b0: 2074 6573 7473 2077 696c 6c20 6265 2063 tests will be c │ │ │ │ │ +000047c0: 6f75 6e74 6564 2061 7320 6661 696c 6564 ounted as failed │ │ │ │ │ +000047d0: 2e0a 0a20 2020 4279 2064 6566 6175 6c74 ... By default │ │ │ │ │ +000047e0: 2c20 7468 6520 7465 7374 2073 7569 7465 , the test suite │ │ │ │ │ +000047f0: 2064 7269 7665 7220 7769 6c6c 2072 756e driver will run │ │ │ │ │ +00004800: 2061 6c6c 2074 6573 7473 2c20 6275 7420 all tests, but │ │ │ │ │ +00004810: 7468 6572 6520 6172 650a 7365 7665 7261 there are.severa │ │ │ │ │ +00004820: 6c20 7761 7973 2074 6f20 6c69 6d69 7420 l ways to limit │ │ │ │ │ +00004830: 7468 6520 7365 7420 6f66 2074 6573 7473 the set of tests │ │ │ │ │ +00004840: 2074 6861 7420 6172 6520 7275 6e3a 0a0a that are run:.. │ │ │ │ │ +00004850: 2020 202a 2059 6f75 2063 616e 2073 6574 * You can set │ │ │ │ │ +00004860: 2074 6865 2027 5445 5354 5327 2076 6172 the 'TESTS' var │ │ │ │ │ +00004870: 6961 626c 652c 2073 696d 696c 6172 6c79 iable, similarly │ │ │ │ │ +00004880: 2074 6f20 686f 7720 796f 7520 6361 6e20 to how you can │ │ │ │ │ +00004890: 7769 7468 2074 6865 0a20 2020 2020 7369 with the. si │ │ │ │ │ +000048a0: 6d70 6c65 2074 6573 7420 6472 6976 6572 mple test driver │ │ │ │ │ +000048b0: 2066 726f 6d20 7468 6520 7072 6576 696f from the previo │ │ │ │ │ +000048c0: 7573 2073 6563 7469 6f6e 2e20 2046 6f72 us section. For │ │ │ │ │ +000048d0: 2065 7861 6d70 6c65 2c20 796f 7520 6361 example, you ca │ │ │ │ │ +000048e0: 6e0a 2020 2020 2075 7365 2061 2063 6f6d n. use a com │ │ │ │ │ +000048f0: 6d61 6e64 206c 696b 6520 7468 6973 2074 mand like this t │ │ │ │ │ +00004900: 6f20 7275 6e20 6f6e 6c79 2061 2073 7562 o run only a sub │ │ │ │ │ +00004910: 7365 7420 6f66 2074 6865 2074 6573 7473 set of the tests │ │ │ │ │ +00004920: 3a0a 0a20 2020 2020 2020 2020 2065 6e76 :.. env │ │ │ │ │ +00004930: 2054 4553 5453 3d22 666f 6f2e 7465 7374 TESTS="foo.test │ │ │ │ │ +00004940: 2062 6172 2e74 6573 7422 206d 616b 6520 bar.test" make │ │ │ │ │ +00004950: 2d65 2063 6865 636b 0a0a 2020 2020 204e -e check.. N │ │ │ │ │ +00004960: 6f74 6520 686f 7765 7665 7220 7468 6174 ote however that │ │ │ │ │ +00004970: 2074 6865 2063 6f6d 6d61 6e64 2061 626f the command abo │ │ │ │ │ +00004980: 7665 2077 696c 6c20 756e 636f 6e64 6974 ve will uncondit │ │ │ │ │ +00004990: 696f 6e61 6c6c 7920 6f76 6572 7772 6974 ionally overwrit │ │ │ │ │ +000049a0: 650a 2020 2020 2074 6865 2027 7465 7374 e. the 'test │ │ │ │ │ +000049b0: 2d73 7569 7465 2e6c 6f67 2720 6669 6c65 -suite.log' file │ │ │ │ │ +000049c0: 2c20 7468 7573 2063 6c6f 6262 6572 696e , thus clobberin │ │ │ │ │ +000049d0: 6720 7468 6520 7265 636f 7264 6564 2072 g the recorded r │ │ │ │ │ +000049e0: 6573 756c 7473 206f 660a 2020 2020 2061 esults of. a │ │ │ │ │ +000049f0: 6e79 2070 7265 7669 6f75 7320 7465 7374 ny previous test │ │ │ │ │ +00004a00: 7375 6974 6520 7275 6e2e 2020 5468 6973 suite run. This │ │ │ │ │ +00004a10: 206d 6967 6874 2062 6520 756e 6465 7369 might be undesi │ │ │ │ │ +00004a20: 7261 626c 6520 666f 7220 7061 636b 6167 rable for packag │ │ │ │ │ +00004a30: 6573 0a20 2020 2020 7768 6f73 6520 7465 es. whose te │ │ │ │ │ +00004a40: 7374 7375 6974 6520 7461 6b65 7320 6c6f stsuite takes lo │ │ │ │ │ +00004a50: 6e67 2074 696d 6520 746f 2065 7865 6375 ng time to execu │ │ │ │ │ +00004a60: 7465 2e20 204c 7563 6b69 6c79 2c20 7468 te. Luckily, th │ │ │ │ │ +00004a70: 6973 2070 726f 626c 656d 0a20 2020 2020 is problem. │ │ │ │ │ +00004a80: 6361 6e20 6561 7369 6c79 2062 6520 6176 can easily be av │ │ │ │ │ +00004a90: 6f69 6465 6420 6279 206f 7665 7272 6964 oided by overrid │ │ │ │ │ +00004aa0: 696e 6720 616c 736f 2027 5445 5354 5f53 ing also 'TEST_S │ │ │ │ │ +00004ab0: 5549 5445 5f4c 4f47 2720 6174 0a20 2020 UITE_LOG' at. │ │ │ │ │ +00004ac0: 2020 7275 6e74 696d 653b 2066 6f72 2065 runtime; for e │ │ │ │ │ +00004ad0: 7861 6d70 6c65 2c0a 0a20 2020 2020 2020 xample,.. │ │ │ │ │ +00004ae0: 2020 2065 6e76 2054 4553 545f 5355 4954 env TEST_SUIT │ │ │ │ │ +00004af0: 455f 4c4f 473d 7061 7274 6961 6c2e 6c6f E_LOG=partial.lo │ │ │ │ │ +00004b00: 6720 5445 5354 533d 222e 2e2e 2220 6d61 g TESTS="..." ma │ │ │ │ │ +00004b10: 6b65 202d 6520 6368 6563 6b0a 0a20 2020 ke -e check.. │ │ │ │ │ +00004b20: 2020 7769 6c6c 2077 7269 7465 2074 6865 will write the │ │ │ │ │ +00004b30: 2072 6573 756c 7420 6f66 2074 6865 2070 result of the p │ │ │ │ │ +00004b40: 6172 7469 616c 2074 6573 7473 7569 7465 artial testsuite │ │ │ │ │ +00004b50: 2072 756e 7320 746f 2074 6865 0a20 2020 runs to the. │ │ │ │ │ +00004b60: 2020 2770 6172 7469 616c 2e6c 6f67 272c 'partial.log', │ │ │ │ │ +00004b70: 2077 6974 686f 7574 2074 6f75 6368 696e without touchin │ │ │ │ │ +00004b80: 6720 2774 6573 742d 7375 6974 652e 6c6f g 'test-suite.lo │ │ │ │ │ +00004b90: 6727 2e0a 0a20 2020 2a20 596f 7520 6361 g'... * You ca │ │ │ │ │ +00004ba0: 6e20 7365 7420 7468 6520 2754 4553 545f n set the 'TEST_ │ │ │ │ │ +00004bb0: 4c4f 4753 2720 7661 7269 6162 6c65 2e20 LOGS' variable. │ │ │ │ │ +00004bc0: 2042 7920 6465 6661 756c 742c 2074 6869 By default, thi │ │ │ │ │ +00004bd0: 7320 7661 7269 6162 6c65 2069 730a 2020 s variable is. │ │ │ │ │ +00004be0: 2020 2063 6f6d 7075 7465 6420 6174 2027 computed at ' │ │ │ │ │ +00004bf0: 6d61 6b65 2720 7275 6e20 7469 6d65 2066 make' run time f │ │ │ │ │ +00004c00: 726f 6d20 7468 6520 7661 6c75 6520 6f66 rom the value of │ │ │ │ │ +00004c10: 2027 5445 5354 5327 2061 7320 6465 7363 'TESTS' as desc │ │ │ │ │ +00004c20: 7269 6265 640a 2020 2020 2061 626f 7665 ribed. above │ │ │ │ │ +00004c30: 2e20 2046 6f72 2065 7861 6d70 6c65 2c20 . For example, │ │ │ │ │ +00004c40: 796f 7520 6361 6e20 7573 6520 7468 6520 you can use the │ │ │ │ │ +00004c50: 666f 6c6c 6f77 696e 673a 0a0a 2020 2020 following:.. │ │ │ │ │ +00004c60: 2020 2020 2020 7365 7420 7820 7375 6273 set x subs │ │ │ │ │ +00004c70: 6574 2a2e 6c6f 673b 2073 6869 6674 0a20 et*.log; shift. │ │ │ │ │ +00004c80: 2020 2020 2020 2020 2065 6e76 2054 4553 env TES │ │ │ │ │ +00004c90: 545f 4c4f 4753 3d22 666f 6f2e 6c6f 6720 T_LOGS="foo.log │ │ │ │ │ +00004ca0: 242a 2220 6d61 6b65 202d 6520 6368 6563 $*" make -e chec │ │ │ │ │ +00004cb0: 6b0a 0a20 2020 2020 5468 6520 636f 6d6d k.. The comm │ │ │ │ │ +00004cc0: 656e 7473 206d 6164 6520 6162 6f76 6520 ents made above │ │ │ │ │ +00004cd0: 6162 6f75 7420 2754 4553 545f 5355 4954 about 'TEST_SUIT │ │ │ │ │ +00004ce0: 455f 4c4f 4727 206f 7665 7272 6964 696e E_LOG' overridin │ │ │ │ │ +00004cf0: 6720 6170 706c 6965 730a 2020 2020 2068 g applies. h │ │ │ │ │ +00004d00: 6572 6520 746f 6f2e 0a0a 2020 202a 2042 ere too... * B │ │ │ │ │ +00004d10: 7920 6465 6661 756c 742c 2074 6865 2074 y default, the t │ │ │ │ │ +00004d20: 6573 7420 6472 6976 6572 2072 656d 6f76 est driver remov │ │ │ │ │ +00004d30: 6573 2061 6c6c 206f 6c64 2070 6572 2d74 es all old per-t │ │ │ │ │ +00004d40: 6573 7420 6c6f 6720 6669 6c65 730a 2020 est log files. │ │ │ │ │ +00004d50: 2020 2062 6566 6f72 6520 6974 2073 7461 before it sta │ │ │ │ │ +00004d60: 7274 7320 7275 6e6e 696e 6720 7465 7374 rts running test │ │ │ │ │ +00004d70: 7320 746f 2072 6567 656e 6572 6174 6520 s to regenerate │ │ │ │ │ +00004d80: 7468 656d 2e20 2054 6865 2076 6172 6961 them. The varia │ │ │ │ │ +00004d90: 626c 650a 2020 2020 2027 5245 4348 4543 ble. 'RECHEC │ │ │ │ │ +00004da0: 4b5f 4c4f 4753 2720 636f 6e74 6169 6e73 K_LOGS' contains │ │ │ │ │ +00004db0: 2074 6865 2073 6574 206f 6620 6c6f 6720 the set of log │ │ │ │ │ +00004dc0: 6669 6c65 7320 7768 6963 6820 6172 6520 files which are │ │ │ │ │ +00004dd0: 7265 6d6f 7665 642e 0a20 2020 2020 2752 removed.. 'R │ │ │ │ │ +00004de0: 4543 4845 434b 5f4c 4f47 5327 2064 6566 ECHECK_LOGS' def │ │ │ │ │ +00004df0: 6175 6c74 7320 746f 2027 5445 5354 5f4c aults to 'TEST_L │ │ │ │ │ +00004e00: 4f47 5327 2c20 7768 6963 6820 6d65 616e OGS', which mean │ │ │ │ │ +00004e10: 7320 616c 6c20 7465 7374 7320 6e65 6564 s all tests need │ │ │ │ │ +00004e20: 0a20 2020 2020 746f 2062 6520 7265 6368 . to be rech │ │ │ │ │ +00004e30: 6563 6b65 642e 2020 4279 206f 7665 7272 ecked. By overr │ │ │ │ │ +00004e40: 6964 696e 6720 7468 6973 2076 6172 6961 iding this varia │ │ │ │ │ +00004e50: 626c 652c 2079 6f75 2063 616e 2063 686f ble, you can cho │ │ │ │ │ +00004e60: 6f73 6520 7768 6963 680a 2020 2020 2074 ose which. t │ │ │ │ │ +00004e70: 6573 7473 206e 6565 6420 746f 2062 6520 ests need to be │ │ │ │ │ +00004e80: 7265 636f 6e73 6964 6572 6564 2e20 2046 reconsidered. F │ │ │ │ │ +00004e90: 6f72 2065 7861 6d70 6c65 2c20 796f 7520 or example, you │ │ │ │ │ +00004ea0: 6361 6e20 6c61 7a69 6c79 2072 6572 756e can lazily rerun │ │ │ │ │ +00004eb0: 0a20 2020 2020 6f6e 6c79 2074 686f 7365 . only those │ │ │ │ │ +00004ec0: 2074 6573 7473 2077 6869 6368 2061 7265 tests which are │ │ │ │ │ +00004ed0: 206f 7574 6461 7465 642c 2069 2e65 2e2c outdated, i.e., │ │ │ │ │ +00004ee0: 206f 6c64 6572 2074 6861 6e20 7468 6569 older than thei │ │ │ │ │ +00004ef0: 720a 2020 2020 2070 7265 7265 7175 6973 r. prerequis │ │ │ │ │ +00004f00: 6974 6520 7465 7374 2066 696c 6573 2c20 ite test files, │ │ │ │ │ +00004f10: 6279 2073 6574 7469 6e67 2074 6869 7320 by setting this │ │ │ │ │ +00004f20: 7661 7269 6162 6c65 2074 6f20 7468 6520 variable to the │ │ │ │ │ +00004f30: 656d 7074 790a 2020 2020 2076 616c 7565 empty. value │ │ │ │ │ +00004f40: 3a0a 0a20 2020 2020 2020 2020 2065 6e76 :.. env │ │ │ │ │ +00004f50: 2052 4543 4845 434b 5f4c 4f47 533d 206d RECHECK_LOGS= m │ │ │ │ │ +00004f60: 616b 6520 2d65 2063 6865 636b 0a0a 2020 ake -e check.. │ │ │ │ │ +00004f70: 202a 2059 6f75 2063 616e 2065 6e73 7572 * You can ensur │ │ │ │ │ +00004f80: 6520 7468 6174 2061 6c6c 2074 6573 7473 e that all tests │ │ │ │ │ +00004f90: 2061 7265 2072 6572 756e 2077 6869 6368 are rerun which │ │ │ │ │ +00004fa0: 2068 6176 6520 6661 696c 6564 206f 7220 have failed or │ │ │ │ │ +00004fb0: 7061 7373 6564 0a20 2020 2020 756e 6578 passed. unex │ │ │ │ │ +00004fc0: 7065 6374 6564 6c79 2c20 6279 2072 756e pectedly, by run │ │ │ │ │ +00004fd0: 6e69 6e67 2027 6d61 6b65 2072 6563 6865 ning 'make reche │ │ │ │ │ +00004fe0: 636b 2720 696e 2074 6865 2074 6573 7420 ck' in the test │ │ │ │ │ +00004ff0: 6469 7265 6374 6f72 792e 0a20 2020 2020 directory.. │ │ │ │ │ +00005000: 5468 6973 2063 6f6e 7665 6e69 656e 6365 This convenience │ │ │ │ │ +00005010: 2074 6172 6765 7420 7769 6c6c 2073 6574 target will set │ │ │ │ │ +00005020: 2027 5245 4348 4543 4b5f 4c4f 4753 2720 'RECHECK_LOGS' │ │ │ │ │ +00005030: 6170 7072 6f70 7269 6174 656c 790a 2020 appropriately. │ │ │ │ │ +00005040: 2020 2062 6566 6f72 6520 696e 766f 6b69 before invoki │ │ │ │ │ +00005050: 6e67 2074 6865 206d 6169 6e20 7465 7374 ng the main test │ │ │ │ │ +00005060: 2064 7269 7665 722e 0a0a 2020 2049 6e20 driver... In │ │ │ │ │ +00005070: 6f72 6465 7220 746f 2067 7561 7261 6e74 order to guarant │ │ │ │ │ +00005080: 6565 2061 6e20 6f72 6465 7269 6e67 2062 ee an ordering b │ │ │ │ │ +00005090: 6574 7765 656e 2074 6573 7473 2065 7665 etween tests eve │ │ │ │ │ +000050a0: 6e20 7769 7468 2027 6d61 6b65 202d 6a4e n with 'make -jN │ │ │ │ │ +000050b0: 272c 0a64 6570 656e 6465 6e63 6965 7320 ',.dependencies │ │ │ │ │ +000050c0: 6265 7477 6565 6e20 7468 6520 636f 7272 between the corr │ │ │ │ │ +000050d0: 6573 706f 6e64 696e 6720 6c6f 6720 6669 esponding log fi │ │ │ │ │ +000050e0: 6c65 7320 6d61 7920 6265 2073 7065 6369 les may be speci │ │ │ │ │ +000050f0: 6669 6564 0a74 6872 6f75 6768 2075 7375 fied.through usu │ │ │ │ │ +00005100: 616c 2027 6d61 6b65 2720 6465 7065 6e64 al 'make' depend │ │ │ │ │ +00005110: 656e 6369 6573 2e20 2046 6f72 2065 7861 encies. For exa │ │ │ │ │ +00005120: 6d70 6c65 2c20 7468 6520 666f 6c6c 6f77 mple, the follow │ │ │ │ │ +00005130: 696e 6720 736e 6970 7065 740a 6c65 7473 ing snippet.lets │ │ │ │ │ +00005140: 2074 6865 2074 6573 7420 6e61 6d65 6420 the test named │ │ │ │ │ +00005150: 2766 6f6f 2d65 7865 6375 7465 2e74 6573 'foo-execute.tes │ │ │ │ │ +00005160: 7427 2064 6570 656e 6420 7570 6f6e 2063 t' depend upon c │ │ │ │ │ +00005170: 6f6d 706c 6574 696f 6e20 6f66 2074 6865 ompletion of the │ │ │ │ │ +00005180: 0a74 6573 7420 2766 6f6f 2d63 6f6d 7069 .test 'foo-compi │ │ │ │ │ +00005190: 6c65 2e74 6573 7427 3a0a 0a20 2020 2020 le.test':.. │ │ │ │ │ +000051a0: 5445 5354 5320 3d20 666f 6f2d 636f 6d70 TESTS = foo-comp │ │ │ │ │ +000051b0: 696c 652e 7465 7374 2066 6f6f 2d65 7865 ile.test foo-exe │ │ │ │ │ +000051c0: 6375 7465 2e74 6573 740a 2020 2020 2066 cute.test. f │ │ │ │ │ +000051d0: 6f6f 2d65 7865 6375 7465 2e6c 6f67 3a20 oo-execute.log: │ │ │ │ │ +000051e0: 666f 6f2d 636f 6d70 696c 652e 6c6f 670a foo-compile.log. │ │ │ │ │ +000051f0: 0a50 6c65 6173 6520 6e6f 7465 2074 6861 .Please note tha │ │ │ │ │ +00005200: 7420 7468 6973 206f 7264 6572 696e 6720 t this ordering │ │ │ │ │ +00005210: 6967 6e6f 7265 7320 7468 6520 5f72 6573 ignores the _res │ │ │ │ │ +00005220: 756c 7473 5f20 6f66 2072 6571 7569 7265 ults_ of require │ │ │ │ │ +00005230: 6420 7465 7374 732c 0a74 6875 7320 7468 d tests,.thus th │ │ │ │ │ +00005240: 6520 7465 7374 2027 666f 6f2d 6578 6563 e test 'foo-exec │ │ │ │ │ +00005250: 7574 652e 7465 7374 2720 6973 2072 756e ute.test' is run │ │ │ │ │ +00005260: 2065 7665 6e20 6966 2074 6865 2074 6573 even if the tes │ │ │ │ │ +00005270: 740a 2766 6f6f 2d63 6f6d 7069 6c65 2e74 t.'foo-compile.t │ │ │ │ │ +00005280: 6573 7427 2066 6169 6c65 6420 6f72 2077 est' failed or w │ │ │ │ │ +00005290: 6173 2073 6b69 7070 6564 2062 6566 6f72 as skipped befor │ │ │ │ │ +000052a0: 6568 616e 642e 2020 4675 7274 6865 722c ehand. Further, │ │ │ │ │ +000052b0: 2070 6c65 6173 650a 6e6f 7465 2074 6861 please.note tha │ │ │ │ │ +000052c0: 7420 7370 6563 6966 7969 6e67 2073 7563 t specifying suc │ │ │ │ │ +000052d0: 6820 6465 7065 6e64 656e 6369 6573 2063 h dependencies c │ │ │ │ │ +000052e0: 7572 7265 6e74 6c79 2077 6f72 6b73 206f urrently works o │ │ │ │ │ +000052f0: 6e6c 7920 666f 7220 7465 7374 730a 7468 nly for tests.th │ │ │ │ │ +00005300: 6174 2065 6e64 2069 6e20 6f6e 6520 6f66 at end in one of │ │ │ │ │ +00005310: 2074 6865 2073 7566 6669 7865 7320 6c69 the suffixes li │ │ │ │ │ +00005320: 7374 6564 2069 6e20 2754 4553 545f 4558 sted in 'TEST_EX │ │ │ │ │ +00005330: 5445 4e53 494f 4e53 272e 0a0a 2020 2054 TENSIONS'... T │ │ │ │ │ +00005340: 6573 7473 2077 6974 686f 7574 2073 7563 ests without suc │ │ │ │ │ +00005350: 6820 7370 6563 6966 6965 6420 6465 7065 h specified depe │ │ │ │ │ +00005360: 6e64 656e 6369 6573 206d 6179 2062 6520 ndencies may be │ │ │ │ │ +00005370: 7275 6e20 636f 6e63 7572 7265 6e74 6c79 run concurrently │ │ │ │ │ +00005380: 0a77 6974 6820 7061 7261 6c6c 656c 2027 .with parallel ' │ │ │ │ │ +00005390: 6d61 6b65 202d 6a4e 272c 2073 6f20 6265 make -jN', so be │ │ │ │ │ +000053a0: 2073 7572 6520 7468 6579 2061 7265 2070 sure they are p │ │ │ │ │ +000053b0: 7265 7061 7265 6420 666f 7220 636f 6e63 repared for conc │ │ │ │ │ +000053c0: 7572 7265 6e74 0a65 7865 6375 7469 6f6e urrent.execution │ │ │ │ │ +000053d0: 2e0a 0a20 2020 5468 6520 636f 6d62 696e ... The combin │ │ │ │ │ +000053e0: 6174 696f 6e20 6f66 206c 617a 7920 7465 ation of lazy te │ │ │ │ │ +000053f0: 7374 2065 7865 6375 7469 6f6e 2061 6e64 st execution and │ │ │ │ │ +00005400: 2063 6f72 7265 6374 2064 6570 656e 6465 correct depende │ │ │ │ │ +00005410: 6e63 6965 730a 6265 7477 6565 6e20 7465 ncies.between te │ │ │ │ │ +00005420: 7374 7320 616e 6420 7468 6569 7220 736f sts and their so │ │ │ │ │ +00005430: 7572 6365 7320 6d61 7920 6265 2065 7870 urces may be exp │ │ │ │ │ +00005440: 6c6f 6974 6564 2066 6f72 2065 6666 6963 loited for effic │ │ │ │ │ +00005450: 6965 6e74 2075 6e69 740a 7465 7374 696e ient unit.testin │ │ │ │ │ +00005460: 6720 6475 7269 6e67 2064 6576 656c 6f70 g during develop │ │ │ │ │ +00005470: 6d65 6e74 2e20 2054 6f20 6675 7274 6865 ment. To furthe │ │ │ │ │ +00005480: 7220 7370 6565 6420 7570 2074 6865 2065 r speed up the e │ │ │ │ │ +00005490: 6469 742d 636f 6d70 696c 652d 7465 7374 dit-compile-test │ │ │ │ │ +000054a0: 0a63 7963 6c65 2c20 6974 206d 6179 2065 .cycle, it may e │ │ │ │ │ +000054b0: 7665 6e20 6265 2075 7365 6675 6c20 746f ven be useful to │ │ │ │ │ +000054c0: 2073 7065 6369 6679 2063 6f6d 7069 6c65 specify compile │ │ │ │ │ +000054d0: 6420 7072 6f67 7261 6d73 2069 6e0a 2745 d programs in.'E │ │ │ │ │ +000054e0: 5854 5241 5f50 524f 4752 414d 5327 2069 XTRA_PROGRAMS' i │ │ │ │ │ +000054f0: 6e73 7465 6164 206f 6620 7769 7468 2027 nstead of with ' │ │ │ │ │ +00005500: 6368 6563 6b5f 5052 4f47 5241 4d53 272c check_PROGRAMS', │ │ │ │ │ +00005510: 2061 7320 7468 6520 666f 726d 6572 2061 as the former a │ │ │ │ │ +00005520: 6c6c 6f77 730a 696e 7465 7274 7769 6e65 llows.intertwine │ │ │ │ │ +00005530: 6420 636f 6d70 696c 6174 696f 6e20 616e d compilation an │ │ │ │ │ +00005540: 6420 7465 7374 2065 7865 6375 7469 6f6e d test execution │ │ │ │ │ +00005550: 2028 6275 7420 6e6f 7465 2074 6861 740a (but note that. │ │ │ │ │ +00005560: 2745 5854 5241 5f50 524f 4752 414d 5327 'EXTRA_PROGRAMS' │ │ │ │ │ +00005570: 2061 7265 206e 6f74 2063 6c65 616e 6564 are not cleaned │ │ │ │ │ +00005580: 2061 7574 6f6d 6174 6963 616c 6c79 2c20 automatically, │ │ │ │ │ +00005590: 2a6e 6f74 6520 556e 6966 6f72 6d3a 3a29 *note Uniform::) │ │ │ │ │ +000055a0: 2e0a 0a20 2020 5468 6520 7661 7269 6162 ... The variab │ │ │ │ │ +000055b0: 6c65 7320 2754 4553 5453 2720 616e 6420 les 'TESTS' and │ │ │ │ │ +000055c0: 2758 4641 494c 5f54 4553 5453 2720 6d61 'XFAIL_TESTS' ma │ │ │ │ │ +000055d0: 7920 636f 6e74 6169 6e20 636f 6e64 6974 y contain condit │ │ │ │ │ +000055e0: 696f 6e61 6c20 7061 7274 730a 6173 2077 ional parts.as w │ │ │ │ │ +000055f0: 656c 6c20 6173 2063 6f6e 6669 6775 7265 ell as configure │ │ │ │ │ +00005600: 2073 7562 7374 6974 7574 696f 6e73 2e20 substitutions. │ │ │ │ │ +00005610: 2049 6e20 7468 6520 6c61 7474 6572 2063 In the latter c │ │ │ │ │ +00005620: 6173 652c 2068 6f77 6576 6572 2c0a 6365 ase, however,.ce │ │ │ │ │ +00005630: 7274 6169 6e20 7265 7374 7269 6374 696f rtain restrictio │ │ │ │ │ +00005640: 6e73 2061 7070 6c79 3a20 7375 6273 7469 ns apply: substi │ │ │ │ │ +00005650: 7475 7465 6420 7465 7374 206e 616d 6573 tuted test names │ │ │ │ │ +00005660: 206d 7573 7420 656e 6420 7769 7468 2061 must end with a │ │ │ │ │ +00005670: 0a6e 6f6e 656d 7074 7920 7465 7374 2073 .nonempty test s │ │ │ │ │ +00005680: 7566 6669 7820 6c69 6b65 2027 2e74 6573 uffix like '.tes │ │ │ │ │ +00005690: 7427 2c20 736f 2074 6861 7420 6f6e 6520 t', so that one │ │ │ │ │ +000056a0: 6f66 2074 6865 2069 6e66 6572 656e 6365 of the inference │ │ │ │ │ +000056b0: 2072 756c 6573 0a67 656e 6572 6174 6564 rules.generated │ │ │ │ │ +000056c0: 2062 7920 2761 7574 6f6d 616b 6527 2063 by 'automake' c │ │ │ │ │ +000056d0: 616e 2061 7070 6c79 2e20 2046 6f72 206c an apply. For l │ │ │ │ │ +000056e0: 6974 6572 616c 2074 6573 7420 6e61 6d65 iteral test name │ │ │ │ │ +000056f0: 732c 2027 6175 746f 6d61 6b65 270a 6361 s, 'automake'.ca │ │ │ │ │ +00005700: 6e20 6765 6e65 7261 7465 2070 6572 2d74 n generate per-t │ │ │ │ │ +00005710: 6172 6765 7420 7275 6c65 7320 746f 2061 arget rules to a │ │ │ │ │ +00005720: 766f 6964 2074 6869 7320 6c69 6d69 7461 void this limita │ │ │ │ │ +00005730: 7469 6f6e 2e0a 0a20 2020 506c 6561 7365 tion... Please │ │ │ │ │ +00005740: 206e 6f74 6520 7468 6174 2069 7420 6973 note that it is │ │ │ │ │ +00005750: 2063 7572 7265 6e74 6c79 206e 6f74 2070 currently not p │ │ │ │ │ +00005760: 6f73 7369 626c 6520 746f 2075 7365 2027 ossible to use ' │ │ │ │ │ +00005770: 2428 7372 6364 6972 292f 2720 6f72 0a27 $(srcdir)/' or.' │ │ │ │ │ +00005780: 2428 746f 705f 7372 6364 6972 292f 2720 $(top_srcdir)/' │ │ │ │ │ +00005790: 696e 2074 6865 2027 5445 5354 5327 2076 in the 'TESTS' v │ │ │ │ │ +000057a0: 6172 6961 626c 652e 2020 5468 6973 2074 ariable. This t │ │ │ │ │ +000057b0: 6563 686e 6963 616c 206c 696d 6974 6174 echnical limitat │ │ │ │ │ +000057c0: 696f 6e20 6973 0a6e 6563 6573 7361 7279 ion is.necessary │ │ │ │ │ +000057d0: 2074 6f20 6176 6f69 6420 6765 6e65 7261 to avoid genera │ │ │ │ │ +000057e0: 7469 6e67 2074 6573 7420 6c6f 6773 2069 ting test logs i │ │ │ │ │ +000057f0: 6e20 7468 6520 736f 7572 6365 2074 7265 n the source tre │ │ │ │ │ +00005800: 6520 616e 6420 6861 7320 7468 650a 756e e and has the.un │ │ │ │ │ +00005810: 666f 7274 756e 6174 6520 636f 6e73 6571 fortunate conseq │ │ │ │ │ +00005820: 7565 6e63 6520 7468 6174 2069 7420 6973 uence that it is │ │ │ │ │ +00005830: 206e 6f74 2070 6f73 7369 626c 6520 746f not possible to │ │ │ │ │ +00005840: 2073 7065 6369 6679 2064 6973 7472 6962 specify distrib │ │ │ │ │ +00005850: 7574 6564 0a74 6573 7473 2074 6861 7420 uted.tests that │ │ │ │ │ +00005860: 6172 6520 7468 656d 7365 6c76 6573 2067 are themselves g │ │ │ │ │ +00005870: 656e 6572 6174 6564 2062 7920 6d65 616e enerated by mean │ │ │ │ │ +00005880: 7320 6f66 2065 7870 6c69 6369 7420 7275 s of explicit ru │ │ │ │ │ +00005890: 6c65 732c 2069 6e20 6120 7761 790a 7468 les, in a way.th │ │ │ │ │ +000058a0: 6174 2069 7320 706f 7274 6162 6c65 2074 at is portable t │ │ │ │ │ +000058b0: 6f20 616c 6c20 276d 616b 6527 2069 6d70 o all 'make' imp │ │ │ │ │ +000058c0: 6c65 6d65 6e74 6174 696f 6e73 2028 2a6e lementations (*n │ │ │ │ │ +000058d0: 6f74 6520 2861 7574 6f63 6f6e 6629 4d61 ote (autoconf)Ma │ │ │ │ │ +000058e0: 6b65 0a54 6172 6765 7420 4c6f 6f6b 7570 ke.Target Lookup │ │ │ │ │ +000058f0: 3a3a 2c20 7468 6520 7365 6d61 6e74 6963 ::, the semantic │ │ │ │ │ +00005900: 7320 6f66 2046 7265 6542 5344 2061 6e64 s of FreeBSD and │ │ │ │ │ +00005910: 204f 7065 6e42 5344 2027 6d61 6b65 2720 OpenBSD 'make' │ │ │ │ │ +00005920: 636f 6e66 6c69 6374 0a77 6974 6820 7468 conflict.with th │ │ │ │ │ +00005930: 6973 292e 2020 496e 2063 6173 6520 6f66 is). In case of │ │ │ │ │ +00005940: 2064 6f75 6274 2079 6f75 206d 6179 2077 doubt you may w │ │ │ │ │ +00005950: 616e 7420 746f 2072 6571 7569 7265 2074 ant to require t │ │ │ │ │ +00005960: 6f20 7573 6520 474e 5520 276d 616b 6527 o use GNU 'make' │ │ │ │ │ +00005970: 2c0a 6f72 2077 6f72 6b20 6172 6f75 6e64 ,.or work around │ │ │ │ │ +00005980: 2074 6865 2069 7373 7565 2077 6974 6820 the issue with │ │ │ │ │ +00005990: 696e 6665 7265 6e63 6520 7275 6c65 7320 inference rules │ │ │ │ │ +000059a0: 746f 2067 656e 6572 6174 6520 7468 6520 to generate the │ │ │ │ │ +000059b0: 7465 7374 732e 0a0a 1f0a 4669 6c65 3a20 tests.....File: │ │ │ │ │ +000059c0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +000059d0: 666f 2c20 204e 6f64 653a 2044 656a 6147 fo, Node: DejaG │ │ │ │ │ +000059e0: 6e75 2054 6573 7473 2c20 204e 6578 743a nu Tests, Next: │ │ │ │ │ +000059f0: 2049 6e73 7461 6c6c 2054 6573 7473 2c20 Install Tests, │ │ │ │ │ +00005a00: 2050 7265 763a 2053 696d 706c 6520 5465 Prev: Simple Te │ │ │ │ │ +00005a10: 7374 7320 7573 696e 6720 7061 7261 6c6c sts using parall │ │ │ │ │ +00005a20: 656c 2d74 6573 7473 2c20 2055 703a 2054 el-tests, Up: T │ │ │ │ │ +00005a30: 6573 7473 0a0a 3135 2e33 2044 656a 6147 ests..15.3 DejaG │ │ │ │ │ +00005a40: 6e75 2054 6573 7473 0a3d 3d3d 3d3d 3d3d nu Tests.======= │ │ │ │ │ +00005a50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620 ===========..If │ │ │ │ │ +00005a60: 2764 656a 6167 6e75 2720 2866 7470 3a2f 'dejagnu' (ftp:/ │ │ │ │ │ +00005a70: 2f66 7470 2e67 6e75 2e6f 7267 2f67 6e75 /ftp.gnu.org/gnu │ │ │ │ │ +00005a80: 2f64 656a 6167 6e75 2f29 2061 7070 6561 /dejagnu/) appea │ │ │ │ │ +00005a90: 7273 2069 6e0a 2741 5554 4f4d 414b 455f rs in.'AUTOMAKE_ │ │ │ │ │ +00005aa0: 4f50 5449 4f4e 5327 2c20 7468 656e 2061 OPTIONS', then a │ │ │ │ │ +00005ab0: 2027 6465 6a61 676e 7527 2d62 6173 6564 'dejagnu'-based │ │ │ │ │ +00005ac0: 2074 6573 7420 7375 6974 6520 6973 2061 test suite is a │ │ │ │ │ +00005ad0: 7373 756d 6564 2e20 2054 6865 0a76 6172 ssumed. The.var │ │ │ │ │ +00005ae0: 6961 626c 6520 2744 454a 4154 4f4f 4c27 iable 'DEJATOOL' │ │ │ │ │ +00005af0: 2069 7320 6120 6c69 7374 206f 6620 6e61 is a list of na │ │ │ │ │ +00005b00: 6d65 7320 7468 6174 2061 7265 2070 6173 mes that are pas │ │ │ │ │ +00005b10: 7365 642c 206f 6e65 2061 7420 6120 7469 sed, one at a ti │ │ │ │ │ +00005b20: 6d65 2c0a 6173 2074 6865 2027 2d2d 746f me,.as the '--to │ │ │ │ │ +00005b30: 6f6c 2720 6172 6775 6d65 6e74 2074 6f20 ol' argument to │ │ │ │ │ +00005b40: 2772 756e 7465 7374 2720 696e 766f 6361 'runtest' invoca │ │ │ │ │ +00005b50: 7469 6f6e 733b 2069 7420 6465 6661 756c tions; it defaul │ │ │ │ │ +00005b60: 7473 2074 6f20 7468 650a 6e61 6d65 206f ts to the.name o │ │ │ │ │ +00005b70: 6620 7468 6520 7061 636b 6167 652e 0a0a f the package... │ │ │ │ │ +00005b80: 2020 2054 6865 2076 6172 6961 626c 6520 The variable │ │ │ │ │ +00005b90: 2752 554e 5445 5354 4445 4641 554c 5446 'RUNTESTDEFAULTF │ │ │ │ │ +00005ba0: 4c41 4753 2720 686f 6c64 7320 7468 6520 LAGS' holds the │ │ │ │ │ +00005bb0: 272d 2d74 6f6f 6c27 2061 6e64 2027 2d2d '--tool' and '-- │ │ │ │ │ +00005bc0: 7372 6364 6972 270a 666c 6167 7320 7468 srcdir'.flags th │ │ │ │ │ +00005bd0: 6174 2061 7265 2070 6173 7365 6420 746f at are passed to │ │ │ │ │ +00005be0: 2064 656a 6167 6e75 2062 7920 6465 6661 dejagnu by defa │ │ │ │ │ +00005bf0: 756c 743b 2074 6869 7320 6361 6e20 6265 ult; this can be │ │ │ │ │ +00005c00: 206f 7665 7272 6964 6465 6e20 6966 0a6e overridden if.n │ │ │ │ │ +00005c10: 6563 6573 7361 7279 2e0a 0a20 2020 5468 ecessary... Th │ │ │ │ │ +00005c20: 6520 7661 7269 6162 6c65 7320 2745 5850 e variables 'EXP │ │ │ │ │ +00005c30: 4543 5427 2061 6e64 2027 5255 4e54 4553 ECT' and 'RUNTES │ │ │ │ │ +00005c40: 5427 2063 616e 2061 6c73 6f20 6265 206f T' can also be o │ │ │ │ │ +00005c50: 7665 7272 6964 6465 6e20 746f 0a70 726f verridden to.pro │ │ │ │ │ +00005c60: 7669 6465 2070 726f 6a65 6374 2d73 7065 vide project-spe │ │ │ │ │ +00005c70: 6369 6669 6320 7661 6c75 6573 2e20 2046 cific values. F │ │ │ │ │ +00005c80: 6f72 2069 6e73 7461 6e63 652c 2079 6f75 or instance, you │ │ │ │ │ +00005c90: 2077 696c 6c20 6e65 6564 2074 6f20 646f will need to do │ │ │ │ │ +00005ca0: 2074 6869 730a 6966 2079 6f75 2061 7265 this.if you are │ │ │ │ │ +00005cb0: 2074 6573 7469 6e67 2061 2063 6f6d 7069 testing a compi │ │ │ │ │ +00005cc0: 6c65 7220 746f 6f6c 6368 6169 6e2c 2062 ler toolchain, b │ │ │ │ │ +00005cd0: 6563 6175 7365 2074 6865 2064 6566 6175 ecause the defau │ │ │ │ │ +00005ce0: 6c74 2076 616c 7565 7320 646f 0a6e 6f74 lt values do.not │ │ │ │ │ +00005cf0: 2074 616b 6520 696e 746f 2061 6363 6f75 take into accou │ │ │ │ │ +00005d00: 6e74 2068 6f73 7420 616e 6420 7461 7267 nt host and targ │ │ │ │ │ +00005d10: 6574 206e 616d 6573 2e0a 0a20 2020 5468 et names... Th │ │ │ │ │ +00005d20: 6520 636f 6e74 656e 7473 206f 6620 7468 e contents of th │ │ │ │ │ +00005d30: 6520 7661 7269 6162 6c65 2027 5255 4e54 e variable 'RUNT │ │ │ │ │ +00005d40: 4553 5446 4c41 4753 2720 6172 6520 7061 ESTFLAGS' are pa │ │ │ │ │ +00005d50: 7373 6564 2074 6f20 7468 650a 2772 756e ssed to the.'run │ │ │ │ │ +00005d60: 7465 7374 2720 696e 766f 6361 7469 6f6e test' invocation │ │ │ │ │ +00005d70: 2e20 2054 6869 7320 6973 2063 6f6e 7369 . This is consi │ │ │ │ │ +00005d80: 6465 7265 6420 6120 2275 7365 7220 7661 dered a "user va │ │ │ │ │ +00005d90: 7269 6162 6c65 2220 282a 6e6f 7465 2055 riable" (*note U │ │ │ │ │ +00005da0: 7365 720a 5661 7269 6162 6c65 733a 3a29 ser.Variables::) │ │ │ │ │ +00005db0: 2e20 2049 6620 796f 7520 6e65 6564 2074 . If you need t │ │ │ │ │ +00005dc0: 6f20 7365 7420 2772 756e 7465 7374 2720 o set 'runtest' │ │ │ │ │ +00005dd0: 666c 6167 7320 696e 2027 4d61 6b65 6669 flags in 'Makefi │ │ │ │ │ +00005de0: 6c65 2e61 6d27 2c20 796f 750a 6361 6e20 le.am', you.can │ │ │ │ │ +00005df0: 7573 6520 2741 4d5f 5255 4e54 4553 5446 use 'AM_RUNTESTF │ │ │ │ │ +00005e00: 4c41 4753 2720 696e 7374 6561 642e 0a0a LAGS' instead... │ │ │ │ │ +00005e10: 2020 2041 7574 6f6d 616b 6520 7769 6c6c Automake will │ │ │ │ │ +00005e20: 2067 656e 6572 6174 6520 7275 6c65 7320 generate rules │ │ │ │ │ +00005e30: 746f 2063 7265 6174 6520 6120 6c6f 6361 to create a loca │ │ │ │ │ +00005e40: 6c20 2773 6974 652e 6578 7027 2066 696c l 'site.exp' fil │ │ │ │ │ +00005e50: 652c 0a64 6566 696e 696e 6720 7661 7269 e,.defining vari │ │ │ │ │ +00005e60: 6f75 7320 7661 7269 6162 6c65 7320 6465 ous variables de │ │ │ │ │ +00005e70: 7465 6374 6564 2062 7920 2763 6f6e 6669 tected by 'confi │ │ │ │ │ +00005e80: 6775 7265 272e 2020 5468 6973 2066 696c gure'. This fil │ │ │ │ │ +00005e90: 6520 6973 0a61 7574 6f6d 6174 6963 616c e is.automatical │ │ │ │ │ +00005ea0: 6c79 2072 6561 6420 6279 2044 656a 6147 ly read by DejaG │ │ │ │ │ +00005eb0: 6e75 2e20 2049 7420 6973 204f 4b20 666f nu. It is OK fo │ │ │ │ │ +00005ec0: 7220 7468 6520 7573 6572 206f 6620 6120 r the user of a │ │ │ │ │ +00005ed0: 7061 636b 6167 6520 746f 0a65 6469 7420 package to.edit │ │ │ │ │ +00005ee0: 7468 6973 2066 696c 6520 696e 206f 7264 this file in ord │ │ │ │ │ +00005ef0: 6572 2074 6f20 7475 6e65 2074 6865 2074 er to tune the t │ │ │ │ │ +00005f00: 6573 7420 7375 6974 652e 2020 486f 7765 est suite. Howe │ │ │ │ │ +00005f10: 7665 7220 7468 6973 2069 7320 6e6f 7420 ver this is not │ │ │ │ │ +00005f20: 7468 650a 706c 6163 6520 7768 6572 6520 the.place where │ │ │ │ │ +00005f30: 7468 6520 7465 7374 2073 7569 7465 2061 the test suite a │ │ │ │ │ +00005f40: 7574 686f 7220 7368 6f75 6c64 2064 6566 uthor should def │ │ │ │ │ +00005f50: 696e 6520 6e65 7720 7661 7269 6162 6c65 ine new variable │ │ │ │ │ +00005f60: 733a 2074 6869 730a 7368 6f75 6c64 2062 s: this.should b │ │ │ │ │ +00005f70: 6520 646f 6e65 2065 6c73 6577 6865 7265 e done elsewhere │ │ │ │ │ +00005f80: 2069 6e20 7468 6520 7265 616c 2074 6573 in the real tes │ │ │ │ │ +00005f90: 7420 7375 6974 6520 636f 6465 2e20 2045 t suite code. E │ │ │ │ │ +00005fa0: 7370 6563 6961 6c6c 792c 0a27 7369 7465 specially,.'site │ │ │ │ │ +00005fb0: 2e65 7870 2720 7368 6f75 6c64 206e 6f74 .exp' should not │ │ │ │ │ +00005fc0: 2062 6520 6469 7374 7269 6275 7465 642e be distributed. │ │ │ │ │ +00005fd0: 0a0a 2020 2053 7469 6c6c 2c20 6966 2074 .. Still, if t │ │ │ │ │ +00005fe0: 6865 2070 6163 6b61 6765 2061 7574 686f he package autho │ │ │ │ │ +00005ff0: 7220 6861 7320 6c65 6769 7469 6d61 7465 r has legitimate │ │ │ │ │ +00006000: 2072 6561 736f 6e73 2074 6f20 6578 7465 reasons to exte │ │ │ │ │ +00006010: 6e64 0a27 7369 7465 2e65 7870 2720 6174 nd.'site.exp' at │ │ │ │ │ +00006020: 2027 6d61 6b65 2720 7469 6d65 2c20 6865 'make' time, he │ │ │ │ │ +00006030: 2063 616e 2064 6f20 736f 2062 7920 6465 can do so by de │ │ │ │ │ +00006040: 6669 6e69 6e67 2074 6865 2076 6172 6961 fining the varia │ │ │ │ │ +00006050: 626c 650a 2745 5854 5241 5f44 454a 4147 ble.'EXTRA_DEJAG │ │ │ │ │ +00006060: 4e55 5f53 4954 455f 434f 4e46 4947 273b NU_SITE_CONFIG'; │ │ │ │ │ +00006070: 2074 6865 2066 696c 6573 206c 6973 7465 the files liste │ │ │ │ │ +00006080: 6420 7468 6572 6520 7769 6c6c 2062 6520 d there will be │ │ │ │ │ +00006090: 636f 6e73 6964 6572 6564 0a27 7369 7465 considered.'site │ │ │ │ │ +000060a0: 2e65 7870 2720 7072 6572 6571 7569 7369 .exp' prerequisi │ │ │ │ │ +000060b0: 7465 732c 2061 6e64 2074 6865 6972 2063 tes, and their c │ │ │ │ │ +000060c0: 6f6e 7465 6e74 2077 696c 6c20 6265 2061 ontent will be a │ │ │ │ │ +000060d0: 7070 656e 6465 6420 746f 2069 7420 2869 ppended to it (i │ │ │ │ │ +000060e0: 6e0a 7468 6520 7361 6d65 206f 7264 6572 n.the same order │ │ │ │ │ +000060f0: 2069 6e20 7768 6963 6820 7468 6579 2061 in which they a │ │ │ │ │ +00006100: 7070 6561 7220 696e 2027 4558 5452 415f ppear in 'EXTRA_ │ │ │ │ │ +00006110: 4445 4a41 474e 555f 5349 5445 5f43 4f4e DEJAGNU_SITE_CON │ │ │ │ │ +00006120: 4649 4727 292e 0a4e 6f74 6520 7468 6174 FIG')..Note that │ │ │ │ │ +00006130: 2066 696c 6573 2061 7265 205f 6e6f 745f files are _not_ │ │ │ │ │ +00006140: 2064 6973 7472 6962 7574 6564 2062 7920 distributed by │ │ │ │ │ +00006150: 6465 6661 756c 742e 0a0a 2020 2046 6f72 default... For │ │ │ │ │ +00006160: 206d 6f72 6520 696e 666f 726d 6174 696f more informatio │ │ │ │ │ +00006170: 6e20 7265 6761 7264 696e 6720 4465 6a61 n regarding Deja │ │ │ │ │ +00006180: 476e 7520 7465 7374 2073 7569 7465 732c Gnu test suites, │ │ │ │ │ +00006190: 2073 6565 202a 6e6f 7465 0a28 6465 6a61 see *note.(deja │ │ │ │ │ +000061a0: 676e 7529 546f 703a 3a2e 0a0a 2020 2049 gnu)Top::... I │ │ │ │ │ +000061b0: 6e20 6569 7468 6572 2063 6173 652c 2074 n either case, t │ │ │ │ │ +000061c0: 6865 2074 6573 7469 6e67 2069 7320 646f he testing is do │ │ │ │ │ +000061d0: 6e65 2076 6961 2027 6d61 6b65 2063 6865 ne via 'make che │ │ │ │ │ +000061e0: 636b 272e 0a0a 1f0a 4669 6c65 3a20 6175 ck'.....File: au │ │ │ │ │ +000061f0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00006200: 2c20 204e 6f64 653a 2049 6e73 7461 6c6c , Node: Install │ │ │ │ │ +00006210: 2054 6573 7473 2c20 2050 7265 763a 2044 Tests, Prev: D │ │ │ │ │ +00006220: 656a 6147 6e75 2054 6573 7473 2c20 2055 ejaGnu Tests, U │ │ │ │ │ +00006230: 703a 2054 6573 7473 0a0a 3135 2e34 2049 p: Tests..15.4 I │ │ │ │ │ +00006240: 6e73 7461 6c6c 2054 6573 7473 0a3d 3d3d nstall Tests.=== │ │ │ │ │ +00006250: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00006260: 0a54 6865 2027 696e 7374 616c 6c63 6865 .The 'installche │ │ │ │ │ +00006270: 636b 2720 7461 7267 6574 2069 7320 6176 ck' target is av │ │ │ │ │ +00006280: 6169 6c61 626c 6520 746f 2074 6865 2075 ailable to the u │ │ │ │ │ +00006290: 7365 7220 6173 2061 2077 6179 2074 6f20 ser as a way to │ │ │ │ │ +000062a0: 7275 6e20 616e 790a 7465 7374 7320 6166 run any.tests af │ │ │ │ │ +000062b0: 7465 7220 7468 6520 7061 636b 6167 6520 ter the package │ │ │ │ │ +000062c0: 6861 7320 6265 656e 2069 6e73 7461 6c6c has been install │ │ │ │ │ +000062d0: 6564 2e20 2059 6f75 2063 616e 2061 6464 ed. You can add │ │ │ │ │ +000062e0: 2074 6573 7473 2074 6f20 7468 6973 0a62 tests to this.b │ │ │ │ │ +000062f0: 7920 7772 6974 696e 6720 616e 2027 696e y writing an 'in │ │ │ │ │ +00006300: 7374 616c 6c63 6865 636b 2d6c 6f63 616c stallcheck-local │ │ │ │ │ +00006310: 2720 7275 6c65 2e0a 0a1f 0a46 696c 653a ' rule.....File: │ │ │ │ │ +00006320: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +00006330: 6e66 6f2c 2020 4e6f 6465 3a20 5265 6275 nfo, Node: Rebu │ │ │ │ │ +00006340: 696c 6469 6e67 2c20 204e 6578 743a 204f ilding, Next: O │ │ │ │ │ +00006350: 7074 696f 6e73 2c20 2050 7265 763a 2054 ptions, Prev: T │ │ │ │ │ +00006360: 6573 7473 2c20 2055 703a 2054 6f70 0a0a ests, Up: Top.. │ │ │ │ │ +00006370: 3136 2052 6562 7569 6c64 696e 6720 4d61 16 Rebuilding Ma │ │ │ │ │ +00006380: 6b65 6669 6c65 730a 2a2a 2a2a 2a2a 2a2a kefiles.******** │ │ │ │ │ +00006390: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ +000063a0: 0a41 7574 6f6d 616b 6520 6765 6e65 7261 .Automake genera │ │ │ │ │ +000063b0: 7465 7320 7275 6c65 7320 746f 2061 7574 tes rules to aut │ │ │ │ │ +000063c0: 6f6d 6174 6963 616c 6c79 2072 6562 7569 omatically rebui │ │ │ │ │ +000063d0: 6c64 2027 4d61 6b65 6669 6c65 2773 2c0a ld 'Makefile's,. │ │ │ │ │ +000063e0: 2763 6f6e 6669 6775 7265 272c 2061 6e64 'configure', and │ │ │ │ │ +000063f0: 206f 7468 6572 2064 6572 6976 6564 2066 other derived f │ │ │ │ │ +00006400: 696c 6573 206c 696b 6520 274d 616b 6566 iles like 'Makef │ │ │ │ │ +00006410: 696c 652e 696e 272e 0a0a 2020 2049 6620 ile.in'... If │ │ │ │ │ +00006420: 796f 7520 6172 6520 7573 696e 6720 2741 you are using 'A │ │ │ │ │ +00006430: 4d5f 4d41 494e 5441 494e 4552 5f4d 4f44 M_MAINTAINER_MOD │ │ │ │ │ +00006440: 4527 2069 6e20 2763 6f6e 6669 6775 7265 E' in 'configure │ │ │ │ │ +00006450: 2e61 6327 2c20 7468 656e 2074 6865 7365 .ac', then these │ │ │ │ │ +00006460: 0a61 7574 6f6d 6174 6963 2072 6562 7569 .automatic rebui │ │ │ │ │ +00006470: 6c64 696e 6720 7275 6c65 7320 6172 6520 lding rules are │ │ │ │ │ +00006480: 6f6e 6c79 2065 6e61 626c 6564 2069 6e20 only enabled in │ │ │ │ │ +00006490: 6d61 696e 7461 696e 6572 206d 6f64 652e maintainer mode. │ │ │ │ │ +000064a0: 0a0a 2020 2053 6f6d 6574 696d 6573 2079 .. Sometimes y │ │ │ │ │ +000064b0: 6f75 206e 6565 6420 746f 2072 756e 2027 ou need to run ' │ │ │ │ │ +000064c0: 6163 6c6f 6361 6c27 2077 6974 6820 616e aclocal' with an │ │ │ │ │ +000064d0: 2061 7267 756d 656e 7420 6c69 6b65 2027 argument like ' │ │ │ │ │ +000064e0: 2d49 2720 746f 0a74 656c 6c20 6974 2077 -I' to.tell it w │ │ │ │ │ +000064f0: 6865 7265 2074 6f20 6669 6e64 2027 2e6d here to find '.m │ │ │ │ │ +00006500: 3427 2066 696c 6573 2e20 2053 696e 6365 4' files. Since │ │ │ │ │ +00006510: 2073 6f6d 6574 696d 6573 2027 6d61 6b65 sometimes 'make │ │ │ │ │ +00006520: 2720 7769 6c6c 0a61 7574 6f6d 6174 6963 ' will.automatic │ │ │ │ │ +00006530: 616c 6c79 2072 756e 2027 6163 6c6f 6361 ally run 'acloca │ │ │ │ │ +00006540: 6c27 2c20 796f 7520 6e65 6564 2061 2077 l', you need a w │ │ │ │ │ +00006550: 6179 2074 6f20 7370 6563 6966 7920 7468 ay to specify th │ │ │ │ │ +00006560: 6573 6520 6172 6775 6d65 6e74 732e 0a59 ese arguments..Y │ │ │ │ │ +00006570: 6f75 2063 616e 2064 6f20 7468 6973 2062 ou can do this b │ │ │ │ │ +00006580: 7920 6465 6669 6e69 6e67 2027 4143 4c4f y defining 'ACLO │ │ │ │ │ +00006590: 4341 4c5f 414d 464c 4147 5327 3b20 7468 CAL_AMFLAGS'; th │ │ │ │ │ +000065a0: 6973 2068 6f6c 6473 2061 7267 756d 656e is holds argumen │ │ │ │ │ +000065b0: 7473 2074 6861 740a 6172 6520 7061 7373 ts that.are pass │ │ │ │ │ +000065c0: 6564 2076 6572 6261 7469 6d20 746f 2027 ed verbatim to ' │ │ │ │ │ +000065d0: 6163 6c6f 6361 6c27 2e20 2054 6869 7320 aclocal'. This │ │ │ │ │ +000065e0: 7661 7269 6162 6c65 2069 7320 6f6e 6c79 variable is only │ │ │ │ │ +000065f0: 2075 7365 6675 6c20 696e 2074 6865 0a74 useful in the.t │ │ │ │ │ +00006600: 6f70 2d6c 6576 656c 2027 4d61 6b65 6669 op-level 'Makefi │ │ │ │ │ +00006610: 6c65 2e61 6d27 2e0a 0a20 2020 536f 6d65 le.am'... Some │ │ │ │ │ +00006620: 7469 6d65 7320 6974 2069 7320 636f 6e76 times it is conv │ │ │ │ │ +00006630: 656e 6965 6e74 2074 6f20 7375 7070 6c65 enient to supple │ │ │ │ │ +00006640: 6d65 6e74 2074 6865 2072 6562 7569 6c64 ment the rebuild │ │ │ │ │ +00006650: 2072 756c 6573 2066 6f72 0a27 636f 6e66 rules for.'conf │ │ │ │ │ +00006660: 6967 7572 6527 206f 7220 2763 6f6e 6669 igure' or 'confi │ │ │ │ │ +00006670: 672e 7374 6174 7573 2720 7769 7468 2061 g.status' with a │ │ │ │ │ +00006680: 6464 6974 696f 6e61 6c20 6465 7065 6e64 dditional depend │ │ │ │ │ +00006690: 656e 6369 6573 2e20 2054 6865 0a76 6172 encies. The.var │ │ │ │ │ +000066a0: 6961 626c 6573 2027 434f 4e46 4947 5552 iables 'CONFIGUR │ │ │ │ │ +000066b0: 455f 4445 5045 4e44 454e 4349 4553 2720 E_DEPENDENCIES' │ │ │ │ │ +000066c0: 616e 6420 2743 4f4e 4649 475f 5354 4154 and 'CONFIG_STAT │ │ │ │ │ +000066d0: 5553 5f44 4550 454e 4445 4e43 4945 5327 US_DEPENDENCIES' │ │ │ │ │ +000066e0: 2063 616e 0a62 6520 7573 6564 2074 6f20 can.be used to │ │ │ │ │ +000066f0: 6c69 7374 2074 6865 7365 2065 7874 7261 list these extra │ │ │ │ │ +00006700: 2064 6570 656e 6465 6e63 6965 732e 2020 dependencies. │ │ │ │ │ +00006710: 5468 6573 6520 7661 7269 6162 6c65 7320 These variables │ │ │ │ │ +00006720: 7368 6f75 6c64 2062 650a 6465 6669 6e65 should be.define │ │ │ │ │ +00006730: 6420 696e 2061 6c6c 2027 4d61 6b65 6669 d in all 'Makefi │ │ │ │ │ +00006740: 6c65 2773 206f 6620 7468 6520 7472 6565 le's of the tree │ │ │ │ │ +00006750: 2028 6265 6361 7573 6520 7468 6573 6520 (because these │ │ │ │ │ +00006760: 7477 6f20 7265 6275 696c 6420 7275 6c65 two rebuild rule │ │ │ │ │ +00006770: 730a 6172 6520 6f75 7470 7574 2069 6e20 s.are output in │ │ │ │ │ +00006780: 616c 6c20 7468 656d 292c 2073 6f20 6974 all them), so it │ │ │ │ │ +00006790: 2069 7320 7361 6665 7220 616e 6420 6561 is safer and ea │ │ │ │ │ +000067a0: 7369 6572 2074 6f20 2741 435f 5355 4253 sier to 'AC_SUBS │ │ │ │ │ +000067b0: 5427 2074 6865 6d0a 6672 6f6d 2027 636f T' them.from 'co │ │ │ │ │ +000067c0: 6e66 6967 7572 652e 6163 272e 2020 466f nfigure.ac'. Fo │ │ │ │ │ +000067d0: 7220 696e 7374 616e 6365 2c20 7468 6520 r instance, the │ │ │ │ │ +000067e0: 666f 6c6c 6f77 696e 6720 7374 6174 656d following statem │ │ │ │ │ +000067f0: 656e 7420 7769 6c6c 2063 6175 7365 0a27 ent will cause.' │ │ │ │ │ +00006800: 636f 6e66 6967 7572 6527 2074 6f20 6265 configure' to be │ │ │ │ │ +00006810: 2072 6572 756e 2065 6163 6820 7469 6d65 rerun each time │ │ │ │ │ +00006820: 2027 7665 7273 696f 6e2e 7368 2720 6973 'version.sh' is │ │ │ │ │ +00006830: 2063 6861 6e67 6564 2e0a 0a20 2020 2020 changed... │ │ │ │ │ +00006840: 4143 5f53 5542 5354 285b 434f 4e46 4947 AC_SUBST([CONFIG │ │ │ │ │ +00006850: 5f53 5441 5455 535f 4445 5045 4e44 454e _STATUS_DEPENDEN │ │ │ │ │ +00006860: 4349 4553 5d2c 205b 2724 2874 6f70 5f73 CIES], ['$(top_s │ │ │ │ │ +00006870: 7263 6469 7229 2f76 6572 7369 6f6e 2e73 rcdir)/version.s │ │ │ │ │ +00006880: 6827 5d29 0a0a 4e6f 7465 2074 6865 2027 h'])..Note the ' │ │ │ │ │ +00006890: 2428 746f 705f 7372 6364 6972 292f 2720 $(top_srcdir)/' │ │ │ │ │ +000068a0: 696e 2074 6865 2066 696c 6520 6e61 6d65 in the file name │ │ │ │ │ +000068b0: 2e20 2053 696e 6365 2074 6869 7320 7661 . Since this va │ │ │ │ │ +000068c0: 7269 6162 6c65 2069 7320 746f 0a62 6520 riable is to.be │ │ │ │ │ +000068d0: 7573 6564 2069 6e20 616c 6c20 274d 616b used in all 'Mak │ │ │ │ │ +000068e0: 6566 696c 6527 732c 2069 7473 2076 616c efile's, its val │ │ │ │ │ +000068f0: 7565 206d 7573 7420 6265 2073 656e 7369 ue must be sensi │ │ │ │ │ +00006900: 626c 6520 6174 2061 6e79 206c 6576 656c ble at any level │ │ │ │ │ +00006910: 2069 6e0a 7468 6520 6275 696c 6420 6869 in.the build hi │ │ │ │ │ +00006920: 6572 6172 6368 792e 0a0a 2020 2042 6577 erarchy... Bew │ │ │ │ │ +00006930: 6172 6520 6e6f 7420 746f 206d 6973 7461 are not to mista │ │ │ │ │ +00006940: 6b65 2027 434f 4e46 4947 5552 455f 4445 ke 'CONFIGURE_DE │ │ │ │ │ +00006950: 5045 4e44 454e 4349 4553 2720 666f 720a PENDENCIES' for. │ │ │ │ │ +00006960: 2743 4f4e 4649 475f 5354 4154 5553 5f44 'CONFIG_STATUS_D │ │ │ │ │ +00006970: 4550 454e 4445 4e43 4945 5327 2e0a 0a20 EPENDENCIES'... │ │ │ │ │ +00006980: 2020 2743 4f4e 4649 4755 5245 5f44 4550 'CONFIGURE_DEP │ │ │ │ │ +00006990: 454e 4445 4e43 4945 5327 2061 6464 7320 ENDENCIES' adds │ │ │ │ │ +000069a0: 6465 7065 6e64 656e 6369 6573 2074 6f20 dependencies to │ │ │ │ │ +000069b0: 7468 6520 2763 6f6e 6669 6775 7265 2720 the 'configure' │ │ │ │ │ +000069c0: 7275 6c65 2c0a 7768 6f73 6520 6566 6665 rule,.whose effe │ │ │ │ │ +000069d0: 6374 2069 7320 746f 2072 756e 2027 6175 ct is to run 'au │ │ │ │ │ +000069e0: 746f 636f 6e66 272e 2020 5468 6973 2076 toconf'. This v │ │ │ │ │ +000069f0: 6172 6961 626c 6520 7368 6f75 6c64 2062 ariable should b │ │ │ │ │ +00006a00: 6520 7365 6c64 6f6d 2075 7365 642c 0a62 e seldom used,.b │ │ │ │ │ +00006a10: 6563 6175 7365 2027 6175 746f 6d61 6b65 ecause 'automake │ │ │ │ │ +00006a20: 2720 616c 7265 6164 7920 7472 6163 6b73 ' already tracks │ │ │ │ │ +00006a30: 2027 6d34 5f69 6e63 6c75 6465 2764 2066 'm4_include'd f │ │ │ │ │ +00006a40: 696c 6573 2e20 2048 6f77 6576 6572 2069 iles. However i │ │ │ │ │ +00006a50: 7420 6361 6e0a 6265 2075 7365 6675 6c20 t can.be useful │ │ │ │ │ +00006a60: 7768 656e 2070 6c61 7969 6e67 2074 7269 when playing tri │ │ │ │ │ +00006a70: 636b 7920 6761 6d65 7320 7769 7468 2027 cky games with ' │ │ │ │ │ +00006a80: 6d34 5f65 7379 7363 6d64 2720 6f72 2073 m4_esyscmd' or s │ │ │ │ │ +00006a90: 696d 696c 6172 0a6e 6f6e 2d72 6563 6f6d imilar.non-recom │ │ │ │ │ +00006aa0: 6d65 6e64 6162 6c65 206d 6163 726f 7320 mendable macros │ │ │ │ │ +00006ab0: 7769 7468 2073 6964 6520 6566 6665 6374 with side effect │ │ │ │ │ +00006ac0: 732e 0a0a 2020 2027 434f 4e46 4947 5f53 s... 'CONFIG_S │ │ │ │ │ +00006ad0: 5441 5455 535f 4445 5045 4e44 454e 4349 TATUS_DEPENDENCI │ │ │ │ │ +00006ae0: 4553 2720 6164 6473 2064 6570 656e 6465 ES' adds depende │ │ │ │ │ +00006af0: 6e63 6965 7320 746f 2074 6865 2027 636f ncies to the 'co │ │ │ │ │ +00006b00: 6e66 6967 2e73 7461 7475 7327 0a72 756c nfig.status'.rul │ │ │ │ │ +00006b10: 652c 2077 686f 7365 2065 6666 6563 7420 e, whose effect │ │ │ │ │ +00006b20: 6973 2074 6f20 7275 6e20 2763 6f6e 6669 is to run 'confi │ │ │ │ │ +00006b30: 6775 7265 272e 2020 5468 6973 2076 6172 gure'. This var │ │ │ │ │ +00006b40: 6961 626c 6520 7368 6f75 6c64 0a74 6865 iable should.the │ │ │ │ │ +00006b50: 7265 666f 7265 2063 6172 7279 2061 6e79 refore carry any │ │ │ │ │ +00006b60: 206e 6f6e 2d73 7461 6e64 6172 6420 736f non-standard so │ │ │ │ │ +00006b70: 7572 6365 2074 6861 7420 6d61 7920 6265 urce that may be │ │ │ │ │ +00006b80: 2072 6561 6420 6173 2061 2073 6964 650a read as a side. │ │ │ │ │ +00006b90: 6566 6665 6374 206f 6620 7275 6e6e 696e effect of runnin │ │ │ │ │ +00006ba0: 6720 2763 6f6e 6669 6775 7265 272c 206c g 'configure', l │ │ │ │ │ +00006bb0: 696b 6520 2776 6572 7369 6f6e 2e73 6827 ike 'version.sh' │ │ │ │ │ +00006bc0: 2069 6e20 7468 6520 6578 616d 706c 6520 in the example │ │ │ │ │ +00006bd0: 6162 6f76 652e 0a0a 2020 2053 7065 616b above... Speak │ │ │ │ │ +00006be0: 696e 6720 6f66 2027 7665 7273 696f 6e2e ing of 'version. │ │ │ │ │ +00006bf0: 7368 2720 7363 7269 7074 732c 2077 6520 sh' scripts, we │ │ │ │ │ +00006c00: 7265 636f 6d6d 656e 6420 6167 6169 6e73 recommend agains │ │ │ │ │ +00006c10: 7420 7468 656d 2074 6f64 6179 2e0a 5468 t them today..Th │ │ │ │ │ +00006c20: 6579 2061 7265 206d 6169 6e6c 7920 7573 ey are mainly us │ │ │ │ │ +00006c30: 6564 2077 6865 6e20 7468 6520 7665 7273 ed when the vers │ │ │ │ │ +00006c40: 696f 6e20 6f66 2061 2070 6163 6b61 6765 ion of a package │ │ │ │ │ +00006c50: 2069 7320 7570 6461 7465 640a 6175 746f is updated.auto │ │ │ │ │ +00006c60: 6d61 7469 6361 6c6c 7920 6279 2061 2073 matically by a s │ │ │ │ │ +00006c70: 6372 6970 7420 2865 2e67 2e2c 2069 6e20 cript (e.g., in │ │ │ │ │ +00006c80: 6461 696c 7920 6275 696c 6473 292e 2020 daily builds). │ │ │ │ │ +00006c90: 4865 7265 2069 7320 7768 6174 2073 6f6d Here is what som │ │ │ │ │ +00006ca0: 650a 6f6c 642d 7374 796c 6520 2763 6f6e e.old-style 'con │ │ │ │ │ +00006cb0: 6669 6775 7265 2e61 6327 7320 6d61 7920 figure.ac's may │ │ │ │ │ +00006cc0: 6c6f 6f6b 206c 696b 653a 0a0a 2020 2020 look like:.. │ │ │ │ │ +00006cd0: 2041 435f 494e 4954 0a20 2020 2020 2e20 AC_INIT. . │ │ │ │ │ +00006ce0: 2473 7263 6469 722f 7665 7273 696f 6e2e $srcdir/version. │ │ │ │ │ +00006cf0: 7368 0a20 2020 2020 414d 5f49 4e49 545f sh. AM_INIT_ │ │ │ │ │ +00006d00: 4155 544f 4d41 4b45 285b 6e61 6d65 5d2c AUTOMAKE([name], │ │ │ │ │ +00006d10: 2024 5645 5253 494f 4e5f 4e55 4d42 4552 $VERSION_NUMBER │ │ │ │ │ +00006d20: 290a 2020 2020 202e 2e2e 0a0a 4865 7265 ). .....Here │ │ │ │ │ +00006d30: 2c20 2776 6572 7369 6f6e 2e73 6827 2069 , 'version.sh' i │ │ │ │ │ +00006d40: 7320 6120 7368 656c 6c20 6672 6167 6d65 s a shell fragme │ │ │ │ │ +00006d50: 6e74 2074 6861 7420 7365 7473 2027 5645 nt that sets 'VE │ │ │ │ │ +00006d60: 5253 494f 4e5f 4e55 4d42 4552 272e 2020 RSION_NUMBER'. │ │ │ │ │ +00006d70: 5468 650a 7072 6f62 6c65 6d20 7769 7468 The.problem with │ │ │ │ │ +00006d80: 2074 6869 7320 6578 616d 706c 6520 6973 this example is │ │ │ │ │ +00006d90: 2074 6861 7420 2761 7574 6f6d 616b 6527 that 'automake' │ │ │ │ │ +00006da0: 2063 616e 6e6f 7420 7472 6163 6b20 6465 cannot track de │ │ │ │ │ +00006db0: 7065 6e64 656e 6369 6573 0a28 6c69 7374 pendencies.(list │ │ │ │ │ +00006dc0: 696e 6720 2776 6572 7369 6f6e 2e73 6827 ing 'version.sh' │ │ │ │ │ +00006dd0: 2069 6e20 2743 4f4e 4649 475f 5354 4154 in 'CONFIG_STAT │ │ │ │ │ +00006de0: 5553 5f44 4550 454e 4445 4e43 4945 5327 US_DEPENDENCIES' │ │ │ │ │ +00006df0: 2c20 616e 6420 6469 7374 7269 6275 7469 , and distributi │ │ │ │ │ +00006e00: 6e67 0a74 6869 7320 6669 6c65 2069 7320 ng.this file is │ │ │ │ │ +00006e10: 7570 2074 6f20 7468 6520 7573 6572 292c up to the user), │ │ │ │ │ +00006e20: 2061 6e64 2074 6861 7420 6974 2075 7365 and that it use │ │ │ │ │ +00006e30: 7320 7468 6520 6f62 736f 6c65 7465 2066 s the obsolete f │ │ │ │ │ +00006e40: 6f72 6d20 6f66 0a27 4143 5f49 4e49 5427 orm of.'AC_INIT' │ │ │ │ │ +00006e50: 2061 6e64 2027 414d 5f49 4e49 545f 4155 and 'AM_INIT_AU │ │ │ │ │ +00006e60: 544f 4d41 4b45 272e 2020 5570 6772 6164 TOMAKE'. Upgrad │ │ │ │ │ +00006e70: 696e 6720 746f 2074 6865 206e 6577 2073 ing to the new s │ │ │ │ │ +00006e80: 796e 7461 7820 6973 206e 6f74 0a73 7472 yntax is not.str │ │ │ │ │ +00006e90: 6169 6768 7466 6f72 7761 7264 2c20 6265 aightforward, be │ │ │ │ │ +00006ea0: 6361 7573 6520 7368 656c 6c20 7661 7269 cause shell vari │ │ │ │ │ +00006eb0: 6162 6c65 7320 6172 6520 6e6f 7420 616c ables are not al │ │ │ │ │ +00006ec0: 6c6f 7765 6420 696e 2027 4143 5f49 4e49 lowed in 'AC_INI │ │ │ │ │ +00006ed0: 5427 2773 0a61 7267 756d 656e 7473 2e20 T''s.arguments. │ │ │ │ │ +00006ee0: 2057 6520 7265 636f 6d6d 656e 6420 7468 We recommend th │ │ │ │ │ +00006ef0: 6174 2027 7665 7273 696f 6e2e 7368 2720 at 'version.sh' │ │ │ │ │ +00006f00: 6265 2072 6570 6c61 6365 6420 6279 2061 be replaced by a │ │ │ │ │ +00006f10: 6e20 4d34 2066 696c 650a 7468 6174 2069 n M4 file.that i │ │ │ │ │ +00006f20: 7320 696e 636c 7564 6564 2062 7920 2763 s included by 'c │ │ │ │ │ +00006f30: 6f6e 6669 6775 7265 2e61 6327 3a0a 0a20 onfigure.ac':.. │ │ │ │ │ +00006f40: 2020 2020 6d34 5f69 6e63 6c75 6465 285b m4_include([ │ │ │ │ │ +00006f50: 7665 7273 696f 6e2e 6d34 5d29 0a20 2020 version.m4]). │ │ │ │ │ +00006f60: 2020 4143 5f49 4e49 5428 5b6e 616d 655d AC_INIT([name] │ │ │ │ │ +00006f70: 2c20 5645 5253 494f 4e5f 4e55 4d42 4552 , VERSION_NUMBER │ │ │ │ │ +00006f80: 290a 2020 2020 2041 4d5f 494e 4954 5f41 ). AM_INIT_A │ │ │ │ │ +00006f90: 5554 4f4d 414b 450a 2020 2020 202e 2e2e UTOMAKE. ... │ │ │ │ │ +00006fa0: 0a0a 4865 7265 2027 7665 7273 696f 6e2e ..Here 'version. │ │ │ │ │ +00006fb0: 6d34 2720 636f 756c 6420 636f 6e74 6169 m4' could contai │ │ │ │ │ +00006fc0: 6e20 736f 6d65 7468 696e 6720 6c69 6b65 n something like │ │ │ │ │ +00006fd0: 0a27 6d34 5f64 6566 696e 6528 5b56 4552 .'m4_define([VER │ │ │ │ │ +00006fe0: 5349 4f4e 5f4e 554d 4245 525d 2c20 5b31 SION_NUMBER], [1 │ │ │ │ │ +00006ff0: 2e32 5d29 272e 2020 5468 6520 6164 7661 .2])'. The adva │ │ │ │ │ +00007000: 6e74 6167 6520 6f66 2074 6869 7320 7365 ntage of this se │ │ │ │ │ +00007010: 636f 6e64 2066 6f72 6d0a 6973 2074 6861 cond form.is tha │ │ │ │ │ +00007020: 7420 2761 7574 6f6d 616b 6527 2077 696c t 'automake' wil │ │ │ │ │ +00007030: 6c20 7461 6b65 2063 6172 6520 6f66 2074 l take care of t │ │ │ │ │ +00007040: 6865 2064 6570 656e 6465 6e63 6965 7320 he dependencies │ │ │ │ │ +00007050: 7768 656e 2064 6566 696e 696e 6720 7468 when defining th │ │ │ │ │ +00007060: 650a 7265 6275 696c 6420 7275 6c65 2c20 e.rebuild rule, │ │ │ │ │ +00007070: 616e 6420 7769 6c6c 2061 6c73 6f20 6469 and will also di │ │ │ │ │ +00007080: 7374 7269 6275 7465 2074 6865 2066 696c stribute the fil │ │ │ │ │ +00007090: 6520 6175 746f 6d61 7469 6361 6c6c 792e e automatically. │ │ │ │ │ +000070a0: 2020 416e 0a69 6e63 6f6e 7665 6e69 656e An.inconvenien │ │ │ │ │ +000070b0: 6365 2069 7320 7468 6174 2027 6175 746f ce is that 'auto │ │ │ │ │ +000070c0: 636f 6e66 2720 7769 6c6c 206e 6f77 2062 conf' will now b │ │ │ │ │ +000070d0: 6520 7265 7275 6e20 6561 6368 2074 696d e rerun each tim │ │ │ │ │ +000070e0: 6520 7468 6520 7665 7273 696f 6e0a 6e75 e the version.nu │ │ │ │ │ +000070f0: 6d62 6572 2069 7320 6275 6d70 6564 2c20 mber is bumped, │ │ │ │ │ +00007100: 7768 656e 206f 6e6c 7920 2763 6f6e 6669 when only 'confi │ │ │ │ │ +00007110: 6775 7265 2720 6861 6420 746f 2062 6520 gure' had to be │ │ │ │ │ +00007120: 7265 7275 6e20 696e 2074 6865 2070 7265 rerun in the pre │ │ │ │ │ +00007130: 7669 6f75 730a 7365 7475 702e 0a0a 1f0a vious.setup..... │ │ │ │ │ +00007140: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +00007150: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +00007160: 204f 7074 696f 6e73 2c20 204e 6578 743a Options, Next: │ │ │ │ │ +00007170: 204d 6973 6365 6c6c 616e 656f 7573 2c20 Miscellaneous, │ │ │ │ │ +00007180: 2050 7265 763a 2052 6562 7569 6c64 696e Prev: Rebuildin │ │ │ │ │ +00007190: 672c 2020 5570 3a20 546f 700a 0a31 3720 g, Up: Top..17 │ │ │ │ │ +000071a0: 4368 616e 6769 6e67 2041 7574 6f6d 616b Changing Automak │ │ │ │ │ +000071b0: 6527 7320 4265 6861 7669 6f72 0a2a 2a2a e's Behavior.*** │ │ │ │ │ 000071c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000071d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a56 6172 ***********..Var │ │ │ │ │ -000071e0: 696f 7573 2066 6561 7475 7265 7320 6f66 ious features of │ │ │ │ │ -000071f0: 2041 7574 6f6d 616b 6520 6361 6e20 6265 Automake can be │ │ │ │ │ -00007200: 2063 6f6e 7472 6f6c 6c65 6420 6279 206f controlled by o │ │ │ │ │ -00007210: 7074 696f 6e73 2e20 2045 7863 6570 7420 ptions. Except │ │ │ │ │ -00007220: 7768 6572 650a 6e6f 7465 6420 6f74 6865 where.noted othe │ │ │ │ │ -00007230: 7277 6973 652c 206f 7074 696f 6e73 2063 rwise, options c │ │ │ │ │ -00007240: 616e 2062 6520 7370 6563 6966 6965 6420 an be specified │ │ │ │ │ -00007250: 696e 206f 6e65 206f 6620 7365 7665 7261 in one of severa │ │ │ │ │ -00007260: 6c20 7761 7973 3a20 4d6f 7374 0a6f 7074 l ways: Most.opt │ │ │ │ │ -00007270: 696f 6e73 2063 616e 2062 6520 6170 706c ions can be appl │ │ │ │ │ -00007280: 6965 6420 6f6e 2061 2070 6572 2d27 4d61 ied on a per-'Ma │ │ │ │ │ -00007290: 6b65 6669 6c65 2720 6261 7369 7320 7768 kefile' basis wh │ │ │ │ │ -000072a0: 656e 206c 6973 7465 6420 696e 2061 0a73 en listed in a.s │ │ │ │ │ -000072b0: 7065 6369 616c 2027 4d61 6b65 6669 6c65 pecial 'Makefile │ │ │ │ │ -000072c0: 2720 7661 7269 6162 6c65 206e 616d 6564 ' variable named │ │ │ │ │ -000072d0: 2027 4155 544f 4d41 4b45 5f4f 5054 494f 'AUTOMAKE_OPTIO │ │ │ │ │ -000072e0: 4e53 272e 2020 536f 6d65 206f 6620 7468 NS'. Some of th │ │ │ │ │ -000072f0: 6573 650a 6f70 7469 6f6e 7320 6f6e 6c79 ese.options only │ │ │ │ │ -00007300: 206d 616b 6520 7365 6e73 6520 7768 656e make sense when │ │ │ │ │ -00007310: 2073 7065 6369 6669 6564 2069 6e20 7468 specified in th │ │ │ │ │ -00007320: 6520 746f 706c 6576 656c 2027 4d61 6b65 e toplevel 'Make │ │ │ │ │ -00007330: 6669 6c65 2e61 6d27 0a66 696c 652e 2020 file.am'.file. │ │ │ │ │ -00007340: 4f70 7469 6f6e 7320 6172 6520 6170 706c Options are appl │ │ │ │ │ -00007350: 6965 6420 676c 6f62 616c 6c79 2074 6f20 ied globally to │ │ │ │ │ -00007360: 616c 6c20 7072 6f63 6573 7365 6420 274d all processed 'M │ │ │ │ │ -00007370: 616b 6566 696c 6527 2066 696c 6573 0a77 akefile' files.w │ │ │ │ │ -00007380: 6865 6e20 6c69 7374 6564 2069 6e20 7468 hen listed in th │ │ │ │ │ -00007390: 6520 6669 7273 7420 6172 6775 6d65 6e74 e first argument │ │ │ │ │ -000073a0: 206f 6620 2741 4d5f 494e 4954 5f41 5554 of 'AM_INIT_AUT │ │ │ │ │ -000073b0: 4f4d 414b 4527 2069 6e0a 2763 6f6e 6669 OMAKE' in.'confi │ │ │ │ │ -000073c0: 6775 7265 2e61 6327 2c20 616e 6420 736f gure.ac', and so │ │ │ │ │ -000073d0: 6d65 206f 7074 696f 6e73 2077 6869 6368 me options which │ │ │ │ │ -000073e0: 2072 6571 7569 7265 2063 6861 6e67 6573 require changes │ │ │ │ │ -000073f0: 2074 6f20 7468 650a 2763 6f6e 6669 6775 to the.'configu │ │ │ │ │ -00007400: 7265 2720 7363 7269 7074 2063 616e 206f re' script can o │ │ │ │ │ -00007410: 6e6c 7920 6265 2073 7065 6369 6669 6564 nly be specified │ │ │ │ │ -00007420: 2074 6865 7265 2e20 2054 6865 7365 2061 there. These a │ │ │ │ │ -00007430: 7265 2061 6e6e 6f74 6174 6564 0a62 656c re annotated.bel │ │ │ │ │ -00007440: 6f77 2e0a 0a20 2020 4375 7272 656e 746c ow... Currentl │ │ │ │ │ -00007450: 7920 756e 6465 7273 746f 6f64 206f 7074 y understood opt │ │ │ │ │ -00007460: 696f 6e73 2061 7265 3a0a 0a27 676e 6974 ions are:..'gnit │ │ │ │ │ -00007470: 7327 0a27 676e 7527 0a27 666f 7265 6967 s'.'gnu'.'foreig │ │ │ │ │ -00007480: 6e27 0a27 6379 676e 7573 270a 0a20 2020 n'.'cygnus'.. │ │ │ │ │ -00007490: 2020 5365 7420 7468 6520 7374 7269 6374 Set the strict │ │ │ │ │ -000074a0: 6e65 7373 2061 7320 6170 7072 6f70 7269 ness as appropri │ │ │ │ │ -000074b0: 6174 652e 2020 5468 6520 2767 6e69 7473 ate. The 'gnits │ │ │ │ │ -000074c0: 2720 6f70 7469 6f6e 2061 6c73 6f20 696d ' option also im │ │ │ │ │ -000074d0: 706c 6965 730a 2020 2020 206f 7074 696f plies. optio │ │ │ │ │ -000074e0: 6e73 2027 7265 6164 6d65 2d61 6c70 6861 ns 'readme-alpha │ │ │ │ │ -000074f0: 2720 616e 6420 2763 6865 636b 2d6e 6577 ' and 'check-new │ │ │ │ │ -00007500: 7327 2e0a 0a27 616e 7369 326b 6e72 270a s'...'ansi2knr'. │ │ │ │ │ -00007510: 2750 4154 482f 616e 7369 326b 6e72 270a 'PATH/ansi2knr'. │ │ │ │ │ -00007520: 2020 2020 2054 7572 6e20 6f6e 2074 6865 Turn on the │ │ │ │ │ -00007530: 2064 6570 7265 6361 7465 6420 6465 2d41 deprecated de-A │ │ │ │ │ -00007540: 4e53 492d 6669 6361 7469 6f6e 2066 6561 NSI-fication fea │ │ │ │ │ -00007550: 7475 7265 2028 2a6e 6f74 6520 414e 5349 ture (*note ANSI │ │ │ │ │ -00007560: 3a3a 292e 0a20 2020 2020 4e6f 7465 2074 ::).. Note t │ │ │ │ │ -00007570: 6861 7420 7468 6174 2066 6561 7475 7265 hat that feature │ │ │ │ │ -00007580: 2061 6e64 2074 6869 7320 6f70 7469 6f6e and this option │ │ │ │ │ -00007590: 205f 7769 6c6c 2062 6520 7265 6d6f 7665 _will be remove │ │ │ │ │ -000075a0: 645f 2069 6e20 7468 650a 2020 2020 206e d_ in the. n │ │ │ │ │ -000075b0: 6578 7420 6d61 6a6f 7220 4175 746f 6d61 ext major Automa │ │ │ │ │ -000075c0: 6b65 2072 656c 6561 7365 2e0a 0a20 2020 ke release... │ │ │ │ │ -000075d0: 2020 4966 2070 7265 6365 6465 6420 6279 If preceded by │ │ │ │ │ -000075e0: 2061 2070 6174 682c 2074 6865 2067 656e a path, the gen │ │ │ │ │ -000075f0: 6572 6174 6564 2027 4d61 6b65 6669 6c65 erated 'Makefile │ │ │ │ │ -00007600: 2e69 6e27 2077 696c 6c20 6c6f 6f6b 2069 .in' will look i │ │ │ │ │ -00007610: 6e20 7468 650a 2020 2020 2073 7065 6369 n the. speci │ │ │ │ │ -00007620: 6669 6564 2064 6972 6563 746f 7279 2074 fied directory t │ │ │ │ │ -00007630: 6f20 6669 6e64 2074 6865 2027 616e 7369 o find the 'ansi │ │ │ │ │ -00007640: 326b 6e72 2720 7072 6f67 7261 6d2e 2020 2knr' program. │ │ │ │ │ -00007650: 5468 6520 7061 7468 0a20 2020 2020 7368 The path. sh │ │ │ │ │ -00007660: 6f75 6c64 2062 6520 6120 7265 6c61 7469 ould be a relati │ │ │ │ │ -00007670: 7665 2070 6174 6820 746f 2061 6e6f 7468 ve path to anoth │ │ │ │ │ -00007680: 6572 2064 6972 6563 746f 7279 2069 6e20 er directory in │ │ │ │ │ -00007690: 7468 6520 7361 6d65 0a20 2020 2020 6469 the same. di │ │ │ │ │ -000076a0: 7374 7269 6275 7469 6f6e 2028 4175 746f stribution (Auto │ │ │ │ │ -000076b0: 6d61 6b65 2064 6f65 7320 6e6f 7420 6368 make does not ch │ │ │ │ │ -000076c0: 6563 6b20 7468 6973 292e 0a0a 2763 6865 eck this)...'che │ │ │ │ │ -000076d0: 636b 2d6e 6577 7327 0a20 2020 2020 4361 ck-news'. Ca │ │ │ │ │ -000076e0: 7573 6520 276d 616b 6520 6469 7374 2720 use 'make dist' │ │ │ │ │ -000076f0: 746f 2066 6169 6c20 756e 6c65 7373 2074 to fail unless t │ │ │ │ │ -00007700: 6865 2063 7572 7265 6e74 2076 6572 7369 he current versi │ │ │ │ │ -00007710: 6f6e 206e 756d 6265 7220 6170 7065 6172 on number appear │ │ │ │ │ -00007720: 730a 2020 2020 2069 6e20 7468 6520 6669 s. in the fi │ │ │ │ │ -00007730: 7273 7420 6665 7720 6c69 6e65 7320 6f66 rst few lines of │ │ │ │ │ -00007740: 2074 6865 2027 4e45 5753 2720 6669 6c65 the 'NEWS' file │ │ │ │ │ -00007750: 2e0a 0a27 636f 6c6f 722d 7465 7374 7327 ...'color-tests' │ │ │ │ │ -00007760: 0a20 2020 2020 4361 7573 6520 6f75 7470 . Cause outp │ │ │ │ │ -00007770: 7574 206f 6620 7468 6520 7369 6d70 6c65 ut of the simple │ │ │ │ │ -00007780: 2074 6573 7420 7375 6974 6520 282a 6e6f test suite (*no │ │ │ │ │ -00007790: 7465 2053 696d 706c 6520 5465 7374 733a te Simple Tests: │ │ │ │ │ -000077a0: 3a29 2074 6f20 6265 0a20 2020 2020 636f :) to be. co │ │ │ │ │ -000077b0: 6c6f 7269 7a65 6420 6f6e 2063 6170 6162 lorized on capab │ │ │ │ │ -000077c0: 6c65 2074 6572 6d69 6e61 6c73 2e0a 0a27 le terminals...' │ │ │ │ │ -000077d0: 6465 6a61 676e 7527 0a20 2020 2020 4361 dejagnu'. Ca │ │ │ │ │ -000077e0: 7573 6520 2764 656a 6167 6e75 272d 7370 use 'dejagnu'-sp │ │ │ │ │ -000077f0: 6563 6966 6963 2072 756c 6573 2074 6f20 ecific rules to │ │ │ │ │ -00007800: 6265 2067 656e 6572 6174 6564 2e20 202a be generated. * │ │ │ │ │ -00007810: 4e6f 7465 2044 656a 6147 6e75 0a20 2020 Note DejaGnu. │ │ │ │ │ -00007820: 2020 5465 7374 733a 3a2e 0a0a 2764 6973 Tests::...'dis │ │ │ │ │ -00007830: 742d 627a 6970 3227 0a20 2020 2020 486f t-bzip2'. Ho │ │ │ │ │ -00007840: 6f6b 2027 6469 7374 2d62 7a69 7032 2720 ok 'dist-bzip2' │ │ │ │ │ -00007850: 746f 2027 6469 7374 272e 0a0a 2764 6973 to 'dist'...'dis │ │ │ │ │ -00007860: 742d 6c7a 6970 270a 2020 2020 2048 6f6f t-lzip'. Hoo │ │ │ │ │ -00007870: 6b20 2764 6973 742d 6c7a 6970 2720 746f k 'dist-lzip' to │ │ │ │ │ -00007880: 2027 6469 7374 272e 0a0a 2764 6973 742d 'dist'...'dist- │ │ │ │ │ -00007890: 6c7a 6d61 270a 2020 2020 2048 6f6f 6b20 lzma'. Hook │ │ │ │ │ -000078a0: 2764 6973 742d 6c7a 6d61 2720 746f 2027 'dist-lzma' to ' │ │ │ │ │ -000078b0: 6469 7374 272e 2020 4f62 736f 6c65 7465 dist'. Obsolete │ │ │ │ │ -000078c0: 6420 6279 2027 6469 7374 2d78 7a27 2e0a d by 'dist-xz'.. │ │ │ │ │ -000078d0: 0a27 6469 7374 2d73 6861 7227 0a20 2020 .'dist-shar'. │ │ │ │ │ -000078e0: 2020 486f 6f6b 2027 6469 7374 2d73 6861 Hook 'dist-sha │ │ │ │ │ -000078f0: 7227 2074 6f20 2764 6973 7427 2e0a 0a27 r' to 'dist'...' │ │ │ │ │ -00007900: 6469 7374 2d7a 6970 270a 2020 2020 2048 dist-zip'. H │ │ │ │ │ -00007910: 6f6f 6b20 2764 6973 742d 7a69 7027 2074 ook 'dist-zip' t │ │ │ │ │ -00007920: 6f20 2764 6973 7427 2e0a 0a27 6469 7374 o 'dist'...'dist │ │ │ │ │ -00007930: 2d74 6172 5a27 0a20 2020 2020 486f 6f6b -tarZ'. Hook │ │ │ │ │ -00007940: 2027 6469 7374 2d74 6172 5a27 2074 6f20 'dist-tarZ' to │ │ │ │ │ -00007950: 2764 6973 7427 2e0a 0a27 6669 6c65 6e61 'dist'...'filena │ │ │ │ │ -00007960: 6d65 2d6c 656e 6774 682d 6d61 783d 3939 me-length-max=99 │ │ │ │ │ -00007970: 270a 2020 2020 2041 626f 7274 2069 6620 '. Abort if │ │ │ │ │ -00007980: 6669 6c65 206e 616d 6573 206c 6f6e 6765 file names longe │ │ │ │ │ -00007990: 7220 7468 616e 2039 3920 6368 6172 6163 r than 99 charac │ │ │ │ │ -000079a0: 7465 7273 2061 7265 2066 6f75 6e64 2064 ters are found d │ │ │ │ │ -000079b0: 7572 696e 670a 2020 2020 2027 6d61 6b65 uring. 'make │ │ │ │ │ -000079c0: 2064 6973 7427 2e20 2053 7563 6820 6c6f dist'. Such lo │ │ │ │ │ -000079d0: 6e67 2066 696c 6520 6e61 6d65 7320 6172 ng file names ar │ │ │ │ │ -000079e0: 6520 6765 6e65 7261 6c6c 7920 636f 6e73 e generally cons │ │ │ │ │ -000079f0: 6964 6572 6564 206e 6f74 2074 6f0a 2020 idered not to. │ │ │ │ │ -00007a00: 2020 2062 6520 706f 7274 6162 6c65 2069 be portable i │ │ │ │ │ -00007a10: 6e20 7461 7262 616c 6c73 2e20 2053 6565 n tarballs. See │ │ │ │ │ -00007a20: 2074 6865 2027 7461 722d 7637 2720 616e the 'tar-v7' an │ │ │ │ │ -00007a30: 6420 2774 6172 2d75 7374 6172 2720 6f70 d 'tar-ustar' op │ │ │ │ │ -00007a40: 7469 6f6e 730a 2020 2020 2062 656c 6f77 tions. below │ │ │ │ │ -00007a50: 2e20 2054 6869 7320 6f70 7469 6f6e 2073 . This option s │ │ │ │ │ -00007a60: 686f 756c 6420 6265 2075 7365 6420 696e hould be used in │ │ │ │ │ -00007a70: 2074 6865 2074 6f70 2d6c 6576 656c 2027 the top-level ' │ │ │ │ │ -00007a80: 4d61 6b65 6669 6c65 2e61 6d27 0a20 2020 Makefile.am'. │ │ │ │ │ -00007a90: 2020 6f72 2061 7320 616e 2061 7267 756d or as an argum │ │ │ │ │ -00007aa0: 656e 7420 6f66 2027 414d 5f49 4e49 545f ent of 'AM_INIT_ │ │ │ │ │ -00007ab0: 4155 544f 4d41 4b45 2720 696e 2027 636f AUTOMAKE' in 'co │ │ │ │ │ -00007ac0: 6e66 6967 7572 652e 6163 272c 2069 7420 nfigure.ac', it │ │ │ │ │ -00007ad0: 7769 6c6c 0a20 2020 2020 6265 2069 676e will. be ign │ │ │ │ │ -00007ae0: 6f72 6564 206f 7468 6572 7769 7365 2e20 ored otherwise. │ │ │ │ │ -00007af0: 2049 7420 7769 6c6c 2061 6c73 6f20 6265 It will also be │ │ │ │ │ -00007b00: 2069 676e 6f72 6564 2069 6e20 7375 622d ignored in sub- │ │ │ │ │ -00007b10: 7061 636b 6167 6573 206f 660a 2020 2020 packages of. │ │ │ │ │ -00007b20: 206e 6573 7465 6420 7061 636b 6167 6573 nested packages │ │ │ │ │ -00007b30: 2028 2a6e 6f74 6520 5375 6270 6163 6b61 (*note Subpacka │ │ │ │ │ -00007b40: 6765 733a 3a29 2e0a 0a27 6e6f 2d64 6566 ges::)...'no-def │ │ │ │ │ -00007b50: 696e 6527 0a20 2020 2020 5468 6973 206f ine'. This o │ │ │ │ │ -00007b60: 7074 696f 6e20 6973 206d 6561 6e69 6e67 ption is meaning │ │ │ │ │ -00007b70: 6675 6c20 6f6e 6c79 2077 6865 6e20 7061 ful only when pa │ │ │ │ │ -00007b80: 7373 6564 2061 7320 616e 2061 7267 756d ssed as an argum │ │ │ │ │ -00007b90: 656e 7420 746f 0a20 2020 2020 2741 4d5f ent to. 'AM_ │ │ │ │ │ -00007ba0: 494e 4954 5f41 5554 4f4d 414b 4527 2e20 INIT_AUTOMAKE'. │ │ │ │ │ -00007bb0: 2049 7420 7769 6c6c 2070 7265 7665 6e74 It will prevent │ │ │ │ │ -00007bc0: 2074 6865 2027 5041 434b 4147 4527 2061 the 'PACKAGE' a │ │ │ │ │ -00007bd0: 6e64 2027 5645 5253 494f 4e27 0a20 2020 nd 'VERSION'. │ │ │ │ │ -00007be0: 2020 7661 7269 6162 6c65 7320 6672 6f6d variables from │ │ │ │ │ -00007bf0: 2062 6569 6e67 2027 4143 5f44 4546 494e being 'AC_DEFIN │ │ │ │ │ -00007c00: 4527 642e 0a0a 276e 6f2d 6465 7065 6e64 E'd...'no-depend │ │ │ │ │ -00007c10: 656e 6369 6573 270a 2020 2020 2054 6869 encies'. Thi │ │ │ │ │ -00007c20: 7320 6973 2073 696d 696c 6172 2074 6f20 s is similar to │ │ │ │ │ -00007c30: 7573 696e 6720 272d 2d69 676e 6f72 652d using '--ignore- │ │ │ │ │ -00007c40: 6465 7073 2720 6f6e 2074 6865 2063 6f6d deps' on the com │ │ │ │ │ -00007c50: 6d61 6e64 206c 696e 652c 2062 7574 0a20 mand line, but. │ │ │ │ │ -00007c60: 2020 2020 6973 2075 7365 6675 6c20 666f is useful fo │ │ │ │ │ -00007c70: 7220 7468 6f73 6520 7369 7475 6174 696f r those situatio │ │ │ │ │ -00007c80: 6e73 2077 6865 7265 2079 6f75 2064 6f6e ns where you don │ │ │ │ │ -00007c90: 2774 2068 6176 6520 7468 6520 6e65 6365 't have the nece │ │ │ │ │ -00007ca0: 7373 6172 790a 2020 2020 2062 6974 7320 ssary. bits │ │ │ │ │ -00007cb0: 746f 206d 616b 6520 6175 746f 6d61 7469 to make automati │ │ │ │ │ -00007cc0: 6320 6465 7065 6e64 656e 6379 2074 7261 c dependency tra │ │ │ │ │ -00007cd0: 636b 696e 6720 776f 726b 2028 2a6e 6f74 cking work (*not │ │ │ │ │ -00007ce0: 650a 2020 2020 2044 6570 656e 6465 6e63 e. Dependenc │ │ │ │ │ -00007cf0: 6965 733a 3a29 2e20 2049 6e20 7468 6973 ies::). In this │ │ │ │ │ -00007d00: 2063 6173 6520 7468 6520 6566 6665 6374 case the effect │ │ │ │ │ -00007d10: 2069 7320 746f 2065 6666 6563 7469 7665 is to effective │ │ │ │ │ -00007d20: 6c79 2064 6973 6162 6c65 0a20 2020 2020 ly disable. │ │ │ │ │ -00007d30: 6175 746f 6d61 7469 6320 6465 7065 6e64 automatic depend │ │ │ │ │ -00007d40: 656e 6379 2074 7261 636b 696e 672e 0a0a ency tracking... │ │ │ │ │ -00007d50: 276e 6f2d 6469 7374 270a 2020 2020 2044 'no-dist'. D │ │ │ │ │ -00007d60: 6f6e 2774 2065 6d69 7420 616e 7920 636f on't emit any co │ │ │ │ │ -00007d70: 6465 2072 656c 6174 6564 2074 6f20 2764 de related to 'd │ │ │ │ │ -00007d80: 6973 7427 2074 6172 6765 742e 2020 5468 ist' target. Th │ │ │ │ │ -00007d90: 6973 2069 7320 7573 6566 756c 2077 6865 is is useful whe │ │ │ │ │ -00007da0: 6e0a 2020 2020 2061 2070 6163 6b61 6765 n. a package │ │ │ │ │ -00007db0: 2068 6173 2069 7473 206f 776e 206d 6574 has its own met │ │ │ │ │ -00007dc0: 686f 6420 666f 7220 6d61 6b69 6e67 2064 hod for making d │ │ │ │ │ -00007dd0: 6973 7472 6962 7574 696f 6e73 2e0a 0a27 istributions...' │ │ │ │ │ -00007de0: 6e6f 2d64 6973 742d 677a 6970 270a 2020 no-dist-gzip'. │ │ │ │ │ -00007df0: 2020 2044 6f20 6e6f 7420 686f 6f6b 2027 Do not hook ' │ │ │ │ │ -00007e00: 6469 7374 2d67 7a69 7027 2074 6f20 2764 dist-gzip' to 'd │ │ │ │ │ -00007e10: 6973 7427 2e0a 0a27 6e6f 2d65 7865 6578 ist'...'no-exeex │ │ │ │ │ -00007e20: 7427 0a20 2020 2020 4966 2079 6f75 7220 t'. If your │ │ │ │ │ -00007e30: 274d 616b 6566 696c 652e 616d 2720 6465 'Makefile.am' de │ │ │ │ │ -00007e40: 6669 6e65 7320 6120 7275 6c65 2066 6f72 fines a rule for │ │ │ │ │ -00007e50: 2074 6172 6765 7420 2766 6f6f 272c 2069 target 'foo', i │ │ │ │ │ -00007e60: 7420 7769 6c6c 0a20 2020 2020 6f76 6572 t will. over │ │ │ │ │ -00007e70: 7269 6465 2061 2072 756c 6520 666f 7220 ride a rule for │ │ │ │ │ -00007e80: 6120 7461 7267 6574 206e 616d 6564 2027 a target named ' │ │ │ │ │ -00007e90: 666f 6f24 2845 5845 4558 5429 272e 2020 foo$(EXEEXT)'. │ │ │ │ │ -00007ea0: 5468 6973 2069 730a 2020 2020 206e 6563 This is. nec │ │ │ │ │ -00007eb0: 6573 7361 7279 2077 6865 6e20 2745 5845 essary when 'EXE │ │ │ │ │ -00007ec0: 4558 5427 2069 7320 666f 756e 6420 746f EXT' is found to │ │ │ │ │ -00007ed0: 2062 6520 656d 7074 792e 2020 486f 7765 be empty. Howe │ │ │ │ │ -00007ee0: 7665 722c 2062 7920 6465 6661 756c 740a ver, by default. │ │ │ │ │ -00007ef0: 2020 2020 2027 6175 746f 6d61 6b65 2720 'automake' │ │ │ │ │ -00007f00: 7769 6c6c 2067 656e 6572 6174 6520 616e will generate an │ │ │ │ │ -00007f10: 2065 7272 6f72 2066 6f72 2074 6869 7320 error for this │ │ │ │ │ -00007f20: 7573 652e 2020 5468 6520 276e 6f2d 6578 use. The 'no-ex │ │ │ │ │ -00007f30: 6565 7874 270a 2020 2020 206f 7074 696f eext'. optio │ │ │ │ │ -00007f40: 6e20 7769 6c6c 2064 6973 6162 6c65 2074 n will disable t │ │ │ │ │ -00007f50: 6869 7320 6572 726f 722e 2020 5468 6973 his error. This │ │ │ │ │ -00007f60: 2069 7320 696e 7465 6e64 6564 2066 6f72 is intended for │ │ │ │ │ -00007f70: 2075 7365 206f 6e6c 790a 2020 2020 2077 use only. w │ │ │ │ │ -00007f80: 6865 7265 2069 7420 6973 206b 6e6f 776e here it is known │ │ │ │ │ -00007f90: 2069 6e20 6164 7661 6e63 6520 7468 6174 in advance that │ │ │ │ │ -00007fa0: 2074 6865 2070 6163 6b61 6765 2077 696c the package wil │ │ │ │ │ -00007fb0: 6c20 6e6f 7420 6265 2070 6f72 7465 6420 l not be ported │ │ │ │ │ -00007fc0: 746f 0a20 2020 2020 5769 6e64 6f77 732c to. Windows, │ │ │ │ │ -00007fd0: 206f 7220 616e 7920 6f74 6865 7220 6f70 or any other op │ │ │ │ │ -00007fe0: 6572 6174 696e 6720 7379 7374 656d 2075 erating system u │ │ │ │ │ -00007ff0: 7369 6e67 2065 7874 656e 7369 6f6e 7320 sing extensions │ │ │ │ │ -00008000: 6f6e 0a20 2020 2020 6578 6563 7574 6162 on. executab │ │ │ │ │ -00008010: 6c65 732e 0a0a 276e 6f2d 696e 7374 616c les...'no-instal │ │ │ │ │ -00008020: 6c69 6e66 6f27 0a20 2020 2020 5468 6520 linfo'. The │ │ │ │ │ -00008030: 6765 6e65 7261 7465 6420 274d 616b 6566 generated 'Makef │ │ │ │ │ -00008040: 696c 652e 696e 2720 7769 6c6c 206e 6f74 ile.in' will not │ │ │ │ │ -00008050: 2063 6175 7365 2069 6e66 6f20 7061 6765 cause info page │ │ │ │ │ -00008060: 7320 746f 2062 6520 6275 696c 740a 2020 s to be built. │ │ │ │ │ -00008070: 2020 206f 7220 696e 7374 616c 6c65 6420 or installed │ │ │ │ │ -00008080: 6279 2064 6566 6175 6c74 2e20 2048 6f77 by default. How │ │ │ │ │ -00008090: 6576 6572 2c20 2769 6e66 6f27 2061 6e64 ever, 'info' and │ │ │ │ │ -000080a0: 2027 696e 7374 616c 6c2d 696e 666f 270a 'install-info'. │ │ │ │ │ -000080b0: 2020 2020 2074 6172 6765 7473 2077 696c targets wil │ │ │ │ │ -000080c0: 6c20 7374 696c 6c20 6265 2061 7661 696c l still be avail │ │ │ │ │ -000080d0: 6162 6c65 2e20 2054 6869 7320 6f70 7469 able. This opti │ │ │ │ │ -000080e0: 6f6e 2069 7320 6469 7361 6c6c 6f77 6564 on is disallowed │ │ │ │ │ -000080f0: 2061 740a 2020 2020 2027 676e 7527 2073 at. 'gnu' s │ │ │ │ │ -00008100: 7472 6963 746e 6573 7320 616e 6420 6162 trictness and ab │ │ │ │ │ -00008110: 6f76 652e 0a0a 276e 6f2d 696e 7374 616c ove...'no-instal │ │ │ │ │ -00008120: 6c6d 616e 270a 2020 2020 2054 6865 2067 lman'. The g │ │ │ │ │ -00008130: 656e 6572 6174 6564 2027 4d61 6b65 6669 enerated 'Makefi │ │ │ │ │ -00008140: 6c65 2e69 6e27 2077 696c 6c20 6e6f 7420 le.in' will not │ │ │ │ │ -00008150: 6361 7573 6520 6d61 6e20 7061 6765 7320 cause man pages │ │ │ │ │ -00008160: 746f 2062 650a 2020 2020 2069 6e73 7461 to be. insta │ │ │ │ │ -00008170: 6c6c 6564 2062 7920 6465 6661 756c 742e lled by default. │ │ │ │ │ -00008180: 2020 486f 7765 7665 722c 2061 6e20 2769 However, an 'i │ │ │ │ │ -00008190: 6e73 7461 6c6c 2d6d 616e 2720 7461 7267 nstall-man' targ │ │ │ │ │ -000081a0: 6574 2077 696c 6c20 7374 696c 6c0a 2020 et will still. │ │ │ │ │ -000081b0: 2020 2062 6520 6176 6169 6c61 626c 6520 be available │ │ │ │ │ -000081c0: 666f 7220 6f70 7469 6f6e 616c 2069 6e73 for optional ins │ │ │ │ │ -000081d0: 7461 6c6c 6174 696f 6e2e 2020 5468 6973 tallation. This │ │ │ │ │ -000081e0: 206f 7074 696f 6e20 6973 2064 6973 616c option is disal │ │ │ │ │ -000081f0: 6c6f 7765 640a 2020 2020 2061 7420 2767 lowed. at 'g │ │ │ │ │ -00008200: 6e75 2720 7374 7269 6374 6e65 7373 2061 nu' strictness a │ │ │ │ │ -00008210: 6e64 2061 626f 7665 2e0a 0a27 6e6f 7374 nd above...'nost │ │ │ │ │ -00008220: 6469 6e63 270a 2020 2020 2054 6869 7320 dinc'. This │ │ │ │ │ -00008230: 6f70 7469 6f6e 2063 616e 2062 6520 7573 option can be us │ │ │ │ │ -00008240: 6564 2074 6f20 6469 7361 626c 6520 7468 ed to disable th │ │ │ │ │ -00008250: 6520 7374 616e 6461 7264 2027 2d49 2720 e standard '-I' │ │ │ │ │ -00008260: 6f70 7469 6f6e 7320 7468 6174 0a20 2020 options that. │ │ │ │ │ -00008270: 2020 6172 6520 6f72 6469 6e61 7269 6c79 are ordinarily │ │ │ │ │ -00008280: 2061 7574 6f6d 6174 6963 616c 6c79 2070 automatically p │ │ │ │ │ -00008290: 726f 7669 6465 6420 6279 2041 7574 6f6d rovided by Autom │ │ │ │ │ -000082a0: 616b 652e 0a0a 276e 6f2d 7465 7869 6e66 ake...'no-texinf │ │ │ │ │ -000082b0: 6f2e 7465 7827 0a20 2020 2020 446f 6e27 o.tex'. Don' │ │ │ │ │ -000082c0: 7420 7265 7175 6972 6520 2774 6578 696e t require 'texin │ │ │ │ │ -000082d0: 666f 2e74 6578 272c 2065 7665 6e20 6966 fo.tex', even if │ │ │ │ │ -000082e0: 2074 6865 7265 2061 7265 2074 6578 696e there are texin │ │ │ │ │ -000082f0: 666f 2066 696c 6573 2069 6e0a 2020 2020 fo files in. │ │ │ │ │ -00008300: 2074 6869 7320 6469 7265 6374 6f72 792e this directory. │ │ │ │ │ -00008310: 0a0a 2770 6172 616c 6c65 6c2d 7465 7374 ..'parallel-test │ │ │ │ │ -00008320: 7327 0a20 2020 2020 456e 6162 6c65 2074 s'. Enable t │ │ │ │ │ -00008330: 6573 7420 7375 6974 6520 6472 6976 6572 est suite driver │ │ │ │ │ -00008340: 2066 6f72 2027 5445 5354 5327 2074 6861 for 'TESTS' tha │ │ │ │ │ -00008350: 7420 6361 6e20 7275 6e20 7465 7374 7320 t can run tests │ │ │ │ │ -00008360: 696e 2070 6172 616c 6c65 6c0a 2020 2020 in parallel. │ │ │ │ │ -00008370: 2028 2a6e 6f74 6520 5369 6d70 6c65 2054 (*note Simple T │ │ │ │ │ -00008380: 6573 7473 2075 7369 6e67 2070 6172 616c ests using paral │ │ │ │ │ -00008390: 6c65 6c2d 7465 7374 733a 3a2c 2066 6f72 lel-tests::, for │ │ │ │ │ -000083a0: 206d 6f72 6520 696e 666f 726d 6174 696f more informatio │ │ │ │ │ -000083b0: 6e29 2e0a 0a27 7265 6164 6d65 2d61 6c70 n)...'readme-alp │ │ │ │ │ -000083c0: 6861 270a 2020 2020 2049 6620 7468 6973 ha'. If this │ │ │ │ │ -000083d0: 2072 656c 6561 7365 2069 7320 616e 2061 release is an a │ │ │ │ │ -000083e0: 6c70 6861 2072 656c 6561 7365 2c20 616e lpha release, an │ │ │ │ │ -000083f0: 6420 7468 6520 6669 6c65 2027 5245 4144 d the file 'READ │ │ │ │ │ -00008400: 4d45 2d61 6c70 6861 270a 2020 2020 2065 ME-alpha'. e │ │ │ │ │ -00008410: 7869 7374 732c 2074 6865 6e20 6974 2077 xists, then it w │ │ │ │ │ -00008420: 696c 6c20 6265 2061 6464 6564 2074 6f20 ill be added to │ │ │ │ │ -00008430: 7468 6520 6469 7374 7269 6275 7469 6f6e the distribution │ │ │ │ │ -00008440: 2e20 2049 6620 7468 6973 206f 7074 696f . If this optio │ │ │ │ │ -00008450: 6e0a 2020 2020 2069 7320 6769 7665 6e2c n. is given, │ │ │ │ │ -00008460: 2076 6572 7369 6f6e 206e 756d 6265 7273 version numbers │ │ │ │ │ -00008470: 2061 7265 2065 7870 6563 7465 6420 746f are expected to │ │ │ │ │ -00008480: 2066 6f6c 6c6f 7720 6f6e 6520 6f66 2074 follow one of t │ │ │ │ │ -00008490: 776f 2066 6f72 6d73 2e0a 2020 2020 2054 wo forms.. T │ │ │ │ │ -000084a0: 6865 2066 6972 7374 2066 6f72 6d20 6973 he first form is │ │ │ │ │ -000084b0: 2027 4d41 4a4f 522e 4d49 4e4f 522e 414c 'MAJOR.MINOR.AL │ │ │ │ │ -000084c0: 5048 4127 2c20 7768 6572 6520 6561 6368 PHA', where each │ │ │ │ │ -000084d0: 2065 6c65 6d65 6e74 2069 7320 610a 2020 element is a. │ │ │ │ │ -000084e0: 2020 206e 756d 6265 723b 2074 6865 2066 number; the f │ │ │ │ │ -000084f0: 696e 616c 2070 6572 696f 6420 616e 6420 inal period and │ │ │ │ │ -00008500: 6e75 6d62 6572 2073 686f 756c 6420 6265 number should be │ │ │ │ │ -00008510: 206c 6566 7420 6f66 6620 666f 720a 2020 left off for. │ │ │ │ │ -00008520: 2020 206e 6f6e 2d61 6c70 6861 2072 656c non-alpha rel │ │ │ │ │ -00008530: 6561 7365 732e 2020 5468 6520 7365 636f eases. The seco │ │ │ │ │ -00008540: 6e64 2066 6f72 6d20 6973 2027 4d41 4a4f nd form is 'MAJO │ │ │ │ │ -00008550: 522e 4d49 4e4f 5241 4c50 4841 272c 2077 R.MINORALPHA', w │ │ │ │ │ -00008560: 6865 7265 0a20 2020 2020 414c 5048 4120 here. ALPHA │ │ │ │ │ -00008570: 6973 2061 206c 6574 7465 723b 2069 7420 is a letter; it │ │ │ │ │ -00008580: 7368 6f75 6c64 2062 6520 6f6d 6974 7465 should be omitte │ │ │ │ │ -00008590: 6420 666f 7220 6e6f 6e2d 616c 7068 6120 d for non-alpha │ │ │ │ │ -000085a0: 7265 6c65 6173 6573 2e0a 0a27 7369 6c65 releases...'sile │ │ │ │ │ -000085b0: 6e74 2d72 756c 6573 270a 2020 2020 2045 nt-rules'. E │ │ │ │ │ -000085c0: 6e61 626c 6520 6c65 7373 2076 6572 626f nable less verbo │ │ │ │ │ -000085d0: 7365 2062 7569 6c64 2072 756c 6573 2e20 se build rules. │ │ │ │ │ -000085e0: 2054 6869 7320 6361 6e20 6265 2075 7365 This can be use │ │ │ │ │ -000085f0: 6420 746f 206c 6574 2062 7569 6c64 0a20 d to let build. │ │ │ │ │ -00008600: 2020 2020 7275 6c65 7320 6f75 7470 7574 rules output │ │ │ │ │ -00008610: 2073 7461 7475 7320 6c69 6e65 7320 6f66 status lines of │ │ │ │ │ -00008620: 2074 6865 2066 6f72 6d3a 0a20 2020 2020 the form:. │ │ │ │ │ -00008630: 2020 2020 2047 454e 204f 5554 5055 542d GEN OUTPUT- │ │ │ │ │ -00008640: 4649 4c45 0a20 2020 2020 2020 2020 2020 FILE. │ │ │ │ │ -00008650: 4343 204f 424a 4543 542d 4649 4c45 0a20 CC OBJECT-FILE. │ │ │ │ │ -00008660: 2020 2020 696e 7374 6561 6420 6f66 2070 instead of p │ │ │ │ │ -00008670: 7269 6e74 696e 6720 7468 6520 636f 6d6d rinting the comm │ │ │ │ │ -00008680: 616e 6420 7468 6174 2077 696c 6c20 6265 and that will be │ │ │ │ │ -00008690: 2065 7865 6375 7465 6420 746f 2075 7064 executed to upd │ │ │ │ │ -000086a0: 6174 650a 2020 2020 204f 5554 5055 542d ate. OUTPUT- │ │ │ │ │ -000086b0: 4649 4c45 206f 7220 746f 2063 6f6d 7069 FILE or to compi │ │ │ │ │ -000086c0: 6c65 204f 424a 4543 542d 4649 4c45 2e20 le OBJECT-FILE. │ │ │ │ │ -000086d0: 2049 7420 6361 6e20 616c 736f 2073 696c It can also sil │ │ │ │ │ -000086e0: 656e 6365 0a20 2020 2020 276c 6962 746f ence. 'libto │ │ │ │ │ -000086f0: 6f6c 2720 6f75 7470 7574 2e0a 0a20 2020 ol' output... │ │ │ │ │ -00008700: 2020 466f 7220 6d6f 7265 2069 6e66 6f72 For more infor │ │ │ │ │ -00008710: 6d61 7469 6f6e 2061 626f 7574 2068 6f77 mation about how │ │ │ │ │ -00008720: 2074 6f20 7573 652c 2065 6e61 626c 652c to use, enable, │ │ │ │ │ -00008730: 206f 7220 6469 7361 626c 6520 7369 6c65 or disable sile │ │ │ │ │ -00008740: 6e74 0a20 2020 2020 7275 6c65 732c 202a nt. rules, * │ │ │ │ │ -00008750: 6e6f 7465 2041 7574 6f6d 616b 6520 7369 note Automake si │ │ │ │ │ -00008760: 6c65 6e74 2d72 756c 6573 204f 7074 696f lent-rules Optio │ │ │ │ │ -00008770: 6e3a 3a2e 0a0a 2773 7464 2d6f 7074 696f n::...'std-optio │ │ │ │ │ -00008780: 6e73 270a 0a20 2020 2020 4d61 6b65 2074 ns'.. Make t │ │ │ │ │ -00008790: 6865 2027 696e 7374 616c 6c63 6865 636b he 'installcheck │ │ │ │ │ -000087a0: 2720 7275 6c65 2063 6865 636b 2074 6861 ' rule check tha │ │ │ │ │ -000087b0: 7420 696e 7374 616c 6c65 6420 7363 7269 t installed scri │ │ │ │ │ -000087c0: 7074 7320 616e 640a 2020 2020 2070 726f pts and. pro │ │ │ │ │ -000087d0: 6772 616d 7320 7375 7070 6f72 7420 7468 grams support th │ │ │ │ │ -000087e0: 6520 272d 2d68 656c 7027 2061 6e64 2027 e '--help' and ' │ │ │ │ │ -000087f0: 2d2d 7665 7273 696f 6e27 206f 7074 696f --version' optio │ │ │ │ │ -00008800: 6e73 2e20 2054 6869 7320 616c 736f 0a20 ns. This also. │ │ │ │ │ -00008810: 2020 2020 7072 6f76 6964 6573 2061 2062 provides a b │ │ │ │ │ -00008820: 6173 6963 2063 6865 636b 2074 6861 7420 asic check that │ │ │ │ │ -00008830: 7468 6520 7072 6f67 7261 6d27 7320 7275 the program's ru │ │ │ │ │ -00008840: 6e2d 7469 6d65 2064 6570 656e 6465 6e63 n-time dependenc │ │ │ │ │ -00008850: 6965 7320 6172 650a 2020 2020 2073 6174 ies are. sat │ │ │ │ │ -00008860: 6973 6669 6564 2061 6674 6572 2069 6e73 isfied after ins │ │ │ │ │ -00008870: 7461 6c6c 6174 696f 6e2e 0a0a 2020 2020 tallation... │ │ │ │ │ -00008880: 2049 6e20 6120 6665 7720 7369 7475 6174 In a few situat │ │ │ │ │ -00008890: 696f 6e73 2c20 7072 6f67 7261 6d73 2028 ions, programs ( │ │ │ │ │ -000088a0: 6f72 2073 6372 6970 7473 2920 6861 7665 or scripts) have │ │ │ │ │ -000088b0: 2074 6f20 6265 2065 7865 6d70 7465 6420 to be exempted │ │ │ │ │ -000088c0: 6672 6f6d 0a20 2020 2020 7468 6973 2074 from. this t │ │ │ │ │ -000088d0: 6573 742e 2020 466f 7220 696e 7374 616e est. For instan │ │ │ │ │ -000088e0: 6365 2c20 2766 616c 7365 2720 2866 726f ce, 'false' (fro │ │ │ │ │ -000088f0: 6d20 474e 5520 636f 7265 7574 696c 7329 m GNU coreutils) │ │ │ │ │ -00008900: 2069 7320 6e65 7665 720a 2020 2020 2073 is never. s │ │ │ │ │ -00008910: 7563 6365 7373 6675 6c2c 2065 7665 6e20 uccessful, even │ │ │ │ │ -00008920: 666f 7220 272d 2d68 656c 7027 206f 7220 for '--help' or │ │ │ │ │ -00008930: 272d 2d76 6572 7369 6f6e 272e 2020 596f '--version'. Yo │ │ │ │ │ -00008940: 7520 6361 6e20 6c69 7374 2073 7563 680a u can list such. │ │ │ │ │ -00008950: 2020 2020 2070 726f 6772 616d 7320 696e programs in │ │ │ │ │ -00008960: 2074 6865 2076 6172 6961 626c 6520 2741 the variable 'A │ │ │ │ │ -00008970: 4d5f 494e 5354 414c 4c43 4845 434b 5f53 M_INSTALLCHECK_S │ │ │ │ │ -00008980: 5444 5f4f 5054 494f 4e53 5f45 5845 4d50 TD_OPTIONS_EXEMP │ │ │ │ │ -00008990: 5427 2e0a 2020 2020 2050 726f 6772 616d T'.. Program │ │ │ │ │ -000089a0: 7320 286e 6f74 2073 6372 6970 7473 2920 s (not scripts) │ │ │ │ │ -000089b0: 6c69 7374 6564 2069 6e20 7468 6973 2076 listed in this v │ │ │ │ │ -000089c0: 6172 6961 626c 6520 7368 6f75 6c64 2062 ariable should b │ │ │ │ │ -000089d0: 6520 7375 6666 6978 6564 0a20 2020 2020 e suffixed. │ │ │ │ │ -000089e0: 6279 2027 2428 4558 4545 5854 2927 2066 by '$(EXEEXT)' f │ │ │ │ │ -000089f0: 6f72 2074 6865 2073 616b 6520 6f66 2057 or the sake of W │ │ │ │ │ -00008a00: 696e 3332 206f 7220 4f53 2f32 2e20 2046 in32 or OS/2. F │ │ │ │ │ -00008a10: 6f72 2069 6e73 7461 6e63 652c 0a20 2020 or instance,. │ │ │ │ │ -00008a20: 2020 7375 7070 6f73 6520 7765 2062 7569 suppose we bui │ │ │ │ │ -00008a30: 6c64 2027 6661 6c73 6527 2061 7320 6120 ld 'false' as a │ │ │ │ │ -00008a40: 7072 6f67 7261 6d20 6275 7420 2774 7275 program but 'tru │ │ │ │ │ -00008a50: 652e 7368 2720 6173 2061 2073 6372 6970 e.sh' as a scrip │ │ │ │ │ -00008a60: 742c 0a20 2020 2020 616e 6420 7468 6174 t,. and that │ │ │ │ │ -00008a70: 206e 6569 7468 6572 206f 6620 7468 656d neither of them │ │ │ │ │ -00008a80: 2073 7570 706f 7274 2027 2d2d 6865 6c70 support '--help │ │ │ │ │ -00008a90: 2720 6f72 2027 2d2d 7665 7273 696f 6e27 ' or '--version' │ │ │ │ │ -00008aa0: 3a0a 0a20 2020 2020 2020 2020 2041 5554 :.. AUT │ │ │ │ │ -00008ab0: 4f4d 414b 455f 4f50 5449 4f4e 5320 3d20 OMAKE_OPTIONS = │ │ │ │ │ -00008ac0: 7374 642d 6f70 7469 6f6e 730a 2020 2020 std-options. │ │ │ │ │ -00008ad0: 2020 2020 2020 6269 6e5f 5052 4f47 5241 bin_PROGRA │ │ │ │ │ -00008ae0: 4d53 203d 2066 616c 7365 202e 2e2e 0a20 MS = false .... │ │ │ │ │ -00008af0: 2020 2020 2020 2020 2062 696e 5f53 4352 bin_SCR │ │ │ │ │ -00008b00: 4950 5453 203d 2074 7275 652e 7368 202e IPTS = true.sh . │ │ │ │ │ -00008b10: 2e2e 0a20 2020 2020 2020 2020 2041 4d5f ... AM_ │ │ │ │ │ -00008b20: 494e 5354 414c 4c43 4845 434b 5f53 5444 INSTALLCHECK_STD │ │ │ │ │ -00008b30: 5f4f 5054 494f 4e53 5f45 5845 4d50 5420 _OPTIONS_EXEMPT │ │ │ │ │ -00008b40: 3d20 6661 6c73 6524 2845 5845 4558 5429 = false$(EXEEXT) │ │ │ │ │ -00008b50: 2074 7275 652e 7368 0a0a 2773 7562 6469 true.sh..'subdi │ │ │ │ │ -00008b60: 722d 6f62 6a65 6374 7327 0a20 2020 2020 r-objects'. │ │ │ │ │ -00008b70: 4966 2074 6869 7320 6f70 7469 6f6e 2069 If this option i │ │ │ │ │ -00008b80: 7320 7370 6563 6966 6965 642c 2074 6865 s specified, the │ │ │ │ │ -00008b90: 6e20 6f62 6a65 6374 7320 6172 6520 706c n objects are pl │ │ │ │ │ -00008ba0: 6163 6564 2069 6e74 6f20 7468 650a 2020 aced into the. │ │ │ │ │ -00008bb0: 2020 2073 7562 6469 7265 6374 6f72 7920 subdirectory │ │ │ │ │ -00008bc0: 6f66 2074 6865 2062 7569 6c64 2064 6972 of the build dir │ │ │ │ │ -00008bd0: 6563 746f 7279 2063 6f72 7265 7370 6f6e ectory correspon │ │ │ │ │ -00008be0: 6469 6e67 2074 6f20 7468 650a 2020 2020 ding to the. │ │ │ │ │ -00008bf0: 2073 7562 6469 7265 6374 6f72 7920 6f66 subdirectory of │ │ │ │ │ -00008c00: 2074 6865 2073 6f75 7263 6520 6669 6c65 the source file │ │ │ │ │ -00008c10: 2e20 2046 6f72 2069 6e73 7461 6e63 652c . For instance, │ │ │ │ │ -00008c20: 2069 6620 7468 6520 736f 7572 6365 2066 if the source f │ │ │ │ │ -00008c30: 696c 650a 2020 2020 2069 7320 2773 7562 ile. is 'sub │ │ │ │ │ -00008c40: 6469 722f 6669 6c65 2e63 7878 272c 2074 dir/file.cxx', t │ │ │ │ │ -00008c50: 6865 6e20 7468 6520 6f75 7470 7574 2066 hen the output f │ │ │ │ │ -00008c60: 696c 6520 776f 756c 6420 6265 0a20 2020 ile would be. │ │ │ │ │ -00008c70: 2020 2773 7562 6469 722f 6669 6c65 2e6f 'subdir/file.o │ │ │ │ │ -00008c80: 272e 0a0a 2020 2020 2049 6e20 6f72 6465 '... In orde │ │ │ │ │ -00008c90: 7220 746f 2075 7365 2074 6869 7320 6f70 r to use this op │ │ │ │ │ -00008ca0: 7469 6f6e 2077 6974 6820 4320 736f 7572 tion with C sour │ │ │ │ │ -00008cb0: 6365 732c 2079 6f75 2073 686f 756c 6420 ces, you should │ │ │ │ │ -00008cc0: 6164 640a 2020 2020 2027 414d 5f50 524f add. 'AM_PRO │ │ │ │ │ -00008cd0: 475f 4343 5f43 5f4f 2720 746f 2027 636f G_CC_C_O' to 'co │ │ │ │ │ -00008ce0: 6e66 6967 7572 652e 6163 272e 0a0a 2774 nfigure.ac'...'t │ │ │ │ │ -00008cf0: 6172 2d76 3727 0a27 7461 722d 7573 7461 ar-v7'.'tar-usta │ │ │ │ │ -00008d00: 7227 0a27 7461 722d 7061 7827 0a0a 2020 r'.'tar-pax'.. │ │ │ │ │ -00008d10: 2020 2054 6865 7365 2074 6872 6565 206d These three m │ │ │ │ │ -00008d20: 7574 7561 6c6c 7920 6578 636c 7573 6976 utually exclusiv │ │ │ │ │ -00008d30: 6520 6f70 7469 6f6e 7320 7365 6c65 6374 e options select │ │ │ │ │ -00008d40: 2074 6865 2074 6172 2066 6f72 6d61 7420 the tar format │ │ │ │ │ -00008d50: 746f 2075 7365 0a20 2020 2020 7768 656e to use. when │ │ │ │ │ -00008d60: 2067 656e 6572 6174 696e 6720 7461 7262 generating tarb │ │ │ │ │ -00008d70: 616c 6c73 2077 6974 6820 276d 616b 6520 alls with 'make │ │ │ │ │ -00008d80: 6469 7374 272e 2020 2854 6865 2074 6172 dist'. (The tar │ │ │ │ │ -00008d90: 2066 696c 6520 6372 6561 7465 640a 2020 file created. │ │ │ │ │ -00008da0: 2020 2069 7320 7468 656e 2063 6f6d 7072 is then compr │ │ │ │ │ -00008db0: 6573 7365 6420 6163 636f 7264 696e 6720 essed according │ │ │ │ │ -00008dc0: 746f 2074 6865 2073 6574 206f 6620 276e to the set of 'n │ │ │ │ │ -00008dd0: 6f2d 6469 7374 2d67 7a69 7027 2c0a 2020 o-dist-gzip',. │ │ │ │ │ -00008de0: 2020 2027 6469 7374 2d62 7a69 7032 272c 'dist-bzip2', │ │ │ │ │ -00008df0: 2027 6469 7374 2d6c 7a69 7027 2c20 2764 'dist-lzip', 'd │ │ │ │ │ -00008e00: 6973 742d 787a 2720 616e 6420 2764 6973 ist-xz' and 'dis │ │ │ │ │ -00008e10: 742d 7461 725a 2720 6f70 7469 6f6e 7320 t-tarZ' options │ │ │ │ │ -00008e20: 696e 0a20 2020 2020 7573 652e 290a 0a20 in. use.).. │ │ │ │ │ -00008e30: 2020 2020 5468 6573 6520 6f70 7469 6f6e These option │ │ │ │ │ -00008e40: 7320 6d75 7374 2062 6520 7061 7373 6564 s must be passed │ │ │ │ │ -00008e50: 2061 7320 6172 6775 6d65 6e74 7320 746f as arguments to │ │ │ │ │ -00008e60: 2027 414d 5f49 4e49 545f 4155 544f 4d41 'AM_INIT_AUTOMA │ │ │ │ │ -00008e70: 4b45 270a 2020 2020 2028 2a6e 6f74 6520 KE'. (*note │ │ │ │ │ -00008e80: 4d61 6372 6f73 3a3a 2920 6265 6361 7573 Macros::) becaus │ │ │ │ │ -00008e90: 6520 7468 6579 2063 616e 2072 6571 7569 e they can requi │ │ │ │ │ -00008ea0: 7265 2061 6464 6974 696f 6e61 6c20 636f re additional co │ │ │ │ │ -00008eb0: 6e66 6967 7572 650a 2020 2020 2063 6865 nfigure. che │ │ │ │ │ -00008ec0: 636b 732e 2020 4175 746f 6d61 6b65 2077 cks. Automake w │ │ │ │ │ -00008ed0: 696c 6c20 636f 6d70 6c61 696e 2069 6620 ill complain if │ │ │ │ │ -00008ee0: 6974 2073 6565 7320 7375 6368 206f 7074 it sees such opt │ │ │ │ │ -00008ef0: 696f 6e73 2069 6e20 616e 0a20 2020 2020 ions in an. │ │ │ │ │ -00008f00: 2741 5554 4f4d 414b 455f 4f50 5449 4f4e 'AUTOMAKE_OPTION │ │ │ │ │ -00008f10: 5327 2076 6172 6961 626c 652e 0a0a 2020 S' variable... │ │ │ │ │ -00008f20: 2020 2027 7461 722d 7637 2720 7365 6c65 'tar-v7' sele │ │ │ │ │ -00008f30: 6374 7320 7468 6520 6f6c 6420 5637 2074 cts the old V7 t │ │ │ │ │ -00008f40: 6172 2066 6f72 6d61 742e 2020 5468 6973 ar format. This │ │ │ │ │ -00008f50: 2069 7320 7468 6520 6869 7374 6f72 6963 is the historic │ │ │ │ │ -00008f60: 616c 0a20 2020 2020 6465 6661 756c 742e al. default. │ │ │ │ │ -00008f70: 2020 5468 6973 2061 6e74 6971 7561 7465 This antiquate │ │ │ │ │ -00008f80: 6420 666f 726d 6174 2069 7320 756e 6465 d format is unde │ │ │ │ │ -00008f90: 7273 746f 6f64 2062 7920 616c 6c20 7461 rstood by all ta │ │ │ │ │ -00008fa0: 720a 2020 2020 2069 6d70 6c65 6d65 6e74 r. implement │ │ │ │ │ -00008fb0: 6174 696f 6e73 2061 6e64 2073 7570 706f ations and suppo │ │ │ │ │ -00008fc0: 7274 7320 6669 6c65 206e 616d 6573 2077 rts file names w │ │ │ │ │ -00008fd0: 6974 6820 7570 2074 6f20 3939 2063 6861 ith up to 99 cha │ │ │ │ │ -00008fe0: 7261 6374 6572 732e 0a20 2020 2020 5768 racters.. Wh │ │ │ │ │ -00008ff0: 656e 2067 6976 656e 206c 6f6e 6765 7220 en given longer │ │ │ │ │ -00009000: 6669 6c65 206e 616d 6573 2073 6f6d 6520 file names some │ │ │ │ │ -00009010: 7461 7220 696d 706c 656d 656e 7461 7469 tar implementati │ │ │ │ │ -00009020: 6f6e 7320 7769 6c6c 2064 6961 676e 6f73 ons will diagnos │ │ │ │ │ -00009030: 650a 2020 2020 2074 6865 2070 726f 626c e. the probl │ │ │ │ │ -00009040: 656d 2077 6869 6c65 206f 7468 6572 2077 em while other w │ │ │ │ │ -00009050: 696c 6c20 6765 6e65 7261 7465 2062 726f ill generate bro │ │ │ │ │ -00009060: 6b65 6e20 7461 7262 616c 6c73 206f 7220 ken tarballs or │ │ │ │ │ -00009070: 7573 650a 2020 2020 206e 6f6e 2d70 6f72 use. non-por │ │ │ │ │ -00009080: 7461 626c 6520 6578 7465 6e73 696f 6e73 table extensions │ │ │ │ │ -00009090: 2e20 2046 7572 7468 6572 6d6f 7265 2c20 . Furthermore, │ │ │ │ │ -000090a0: 7468 6520 5637 2066 6f72 6d61 7420 6361 the V7 format ca │ │ │ │ │ -000090b0: 6e6e 6f74 2073 746f 7265 0a20 2020 2020 nnot store. │ │ │ │ │ -000090c0: 656d 7074 7920 6469 7265 6374 6f72 6965 empty directorie │ │ │ │ │ -000090d0: 732e 2020 5768 656e 2075 7369 6e67 2074 s. When using t │ │ │ │ │ -000090e0: 6869 7320 666f 726d 6174 2c20 636f 6e73 his format, cons │ │ │ │ │ -000090f0: 6964 6572 2075 7369 6e67 2074 6865 0a20 ider using the. │ │ │ │ │ -00009100: 2020 2020 2766 696c 656e 616d 652d 6c65 'filename-le │ │ │ │ │ -00009110: 6e67 7468 2d6d 6178 3d39 3927 206f 7074 ngth-max=99' opt │ │ │ │ │ -00009120: 696f 6e20 746f 2063 6174 6368 2066 696c ion to catch fil │ │ │ │ │ -00009130: 6520 6e61 6d65 7320 746f 6f20 6c6f 6e67 e names too long │ │ │ │ │ -00009140: 2e0a 0a20 2020 2020 2774 6172 2d75 7374 ... 'tar-ust │ │ │ │ │ -00009150: 6172 2720 7365 6c65 6374 7320 7468 6520 ar' selects the │ │ │ │ │ -00009160: 7573 7461 7220 666f 726d 6174 2064 6566 ustar format def │ │ │ │ │ -00009170: 696e 6564 2062 7920 504f 5349 5820 3130 ined by POSIX 10 │ │ │ │ │ -00009180: 3033 2e31 2d31 3938 382e 0a20 2020 2020 03.1-1988.. │ │ │ │ │ -00009190: 5468 6973 2066 6f72 6d61 7420 6973 2062 This format is b │ │ │ │ │ -000091a0: 656c 6965 7665 6420 746f 2062 6520 6f6c elieved to be ol │ │ │ │ │ -000091b0: 6420 656e 6f75 6768 2074 6f20 6265 2070 d enough to be p │ │ │ │ │ -000091c0: 6f72 7461 626c 652e 2020 4974 2066 756c ortable. It ful │ │ │ │ │ -000091d0: 6c79 0a20 2020 2020 7375 7070 6f72 7473 ly. supports │ │ │ │ │ -000091e0: 2065 6d70 7479 2064 6972 6563 746f 7269 empty directori │ │ │ │ │ -000091f0: 6573 2e20 2049 7420 6361 6e20 7374 6f72 es. It can stor │ │ │ │ │ -00009200: 6520 6669 6c65 206e 616d 6573 2077 6974 e file names wit │ │ │ │ │ -00009210: 6820 7570 2074 6f20 3235 360a 2020 2020 h up to 256. │ │ │ │ │ -00009220: 2063 6861 7261 6374 6572 732c 2070 726f characters, pro │ │ │ │ │ -00009230: 7669 6465 6420 7468 6174 2074 6865 2066 vided that the f │ │ │ │ │ -00009240: 696c 6520 6e61 6d65 2063 616e 2062 6520 ile name can be │ │ │ │ │ -00009250: 7370 6c69 7420 6174 2064 6972 6563 746f split at directo │ │ │ │ │ -00009260: 7279 0a20 2020 2020 7365 7061 7261 746f ry. separato │ │ │ │ │ -00009270: 7220 696e 2074 776f 2070 6172 7473 2c20 r in two parts, │ │ │ │ │ -00009280: 6669 7273 7420 6f66 2074 6865 6d20 6265 first of them be │ │ │ │ │ -00009290: 696e 6720 6174 206d 6f73 7420 3135 3520 ing at most 155 │ │ │ │ │ -000092a0: 6279 7465 7320 6c6f 6e67 2e0a 2020 2020 bytes long.. │ │ │ │ │ -000092b0: 2053 6f2c 2069 6e20 6d6f 7374 2063 6173 So, in most cas │ │ │ │ │ -000092c0: 6573 2074 6865 206d 6178 696d 756d 2066 es the maximum f │ │ │ │ │ -000092d0: 696c 6520 6e61 6d65 206c 656e 6774 6820 ile name length │ │ │ │ │ -000092e0: 7769 6c6c 2062 6520 7368 6f72 7465 7220 will be shorter │ │ │ │ │ -000092f0: 7468 616e 0a20 2020 2020 3235 3620 6368 than. 256 ch │ │ │ │ │ -00009300: 6172 6163 7465 7273 2e20 2048 6f77 6576 aracters. Howev │ │ │ │ │ -00009310: 6572 2079 6f75 206d 6179 2072 756e 2061 er you may run a │ │ │ │ │ -00009320: 6761 696e 7374 2062 726f 6b65 6e20 7461 gainst broken ta │ │ │ │ │ -00009330: 720a 2020 2020 2069 6d70 6c65 6d65 6e74 r. implement │ │ │ │ │ -00009340: 6174 696f 6e73 2074 6861 7420 696e 636f ations that inco │ │ │ │ │ -00009350: 7272 6563 746c 7920 6861 6e64 6c65 2066 rrectly handle f │ │ │ │ │ -00009360: 696c 6520 6e61 6d65 7320 6c6f 6e67 6572 ile names longer │ │ │ │ │ -00009370: 2074 6861 6e20 3939 0a20 2020 2020 6368 than 99. ch │ │ │ │ │ -00009380: 6172 6163 7465 7273 2028 706c 6561 7365 aracters (please │ │ │ │ │ -00009390: 2072 6570 6f72 7420 7468 656d 2074 6f20 report them to │ │ │ │ │ -000093a0: 3c62 7567 2d61 7574 6f6d 616b 6540 676e so we can │ │ │ │ │ -000093c0: 0a20 2020 2020 646f 6375 6d65 6e74 2074 . document t │ │ │ │ │ -000093d0: 6869 7320 6163 6375 7261 7465 6c79 292e his accurately). │ │ │ │ │ -000093e0: 0a0a 2020 2020 2027 7461 722d 7061 7827 .. 'tar-pax' │ │ │ │ │ -000093f0: 2073 656c 6563 7473 2074 6865 206e 6577 selects the new │ │ │ │ │ -00009400: 2070 6178 2069 6e74 6572 6368 616e 6765 pax interchange │ │ │ │ │ -00009410: 2066 6f72 6d61 7420 6465 6669 6e65 6420 format defined │ │ │ │ │ -00009420: 6279 2050 4f53 4958 0a20 2020 2020 3130 by POSIX. 10 │ │ │ │ │ -00009430: 3033 2e31 2d32 3030 312e 2020 4974 2064 03.1-2001. It d │ │ │ │ │ -00009440: 6f65 7320 6e6f 7420 6c69 6d69 7420 7468 oes not limit th │ │ │ │ │ -00009450: 6520 6c65 6e67 7468 206f 6620 6669 6c65 e length of file │ │ │ │ │ -00009460: 206e 616d 6573 2e20 2048 6f77 6576 6572 names. However │ │ │ │ │ -00009470: 2c0a 2020 2020 2074 6869 7320 666f 726d ,. this form │ │ │ │ │ -00009480: 6174 2069 7320 7665 7279 2079 6f75 6e67 at is very young │ │ │ │ │ -00009490: 2061 6e64 2073 686f 756c 6420 7072 6f62 and should prob │ │ │ │ │ -000094a0: 6162 6c79 2062 6520 7265 7374 7269 6374 ably be restrict │ │ │ │ │ -000094b0: 6564 2074 6f0a 2020 2020 2070 6163 6b61 ed to. packa │ │ │ │ │ -000094c0: 6765 7320 7468 6174 2074 6172 6765 7420 ges that target │ │ │ │ │ -000094d0: 6f6e 6c79 2076 6572 7920 6d6f 6465 726e only very modern │ │ │ │ │ -000094e0: 2070 6c61 7466 6f72 6d73 2e20 2054 6865 platforms. The │ │ │ │ │ -000094f0: 7265 2061 7265 206d 6f76 6573 0a20 2020 re are moves. │ │ │ │ │ -00009500: 2020 746f 2063 6861 6e67 6520 7468 6520 to change the │ │ │ │ │ -00009510: 7061 7820 666f 726d 6174 2069 6e20 616e pax format in an │ │ │ │ │ -00009520: 2075 7077 6172 642d 636f 6d70 6174 6962 upward-compatib │ │ │ │ │ -00009530: 6c65 2077 6179 2c20 736f 2074 6869 730a le way, so this. │ │ │ │ │ -00009540: 2020 2020 206f 7074 696f 6e20 6d61 7920 option may │ │ │ │ │ -00009550: 7265 6665 7220 746f 2061 206d 6f72 6520 refer to a more │ │ │ │ │ -00009560: 7265 6365 6e74 2076 6572 7369 6f6e 2069 recent version i │ │ │ │ │ -00009570: 6e20 7468 6520 6675 7475 7265 2e0a 0a20 n the future... │ │ │ │ │ -00009580: 2020 2020 2a4e 6f74 6520 436f 6e74 726f *Note Contro │ │ │ │ │ -00009590: 6c6c 696e 6720 7468 6520 4172 6368 6976 lling the Archiv │ │ │ │ │ -000095a0: 6520 466f 726d 6174 3a20 2874 6172 2946 e Format: (tar)F │ │ │ │ │ -000095b0: 6f72 6d61 7473 2c20 666f 7220 6675 7274 ormats, for furt │ │ │ │ │ -000095c0: 6865 720a 2020 2020 2064 6973 6375 7373 her. discuss │ │ │ │ │ -000095d0: 696f 6e20 6162 6f75 7420 7461 7220 666f ion about tar fo │ │ │ │ │ -000095e0: 726d 6174 732e 0a0a 2020 2020 2027 636f rmats... 'co │ │ │ │ │ -000095f0: 6e66 6967 7572 6527 206b 6e6f 7773 2073 nfigure' knows s │ │ │ │ │ -00009600: 6576 6572 616c 2077 6179 7320 746f 2063 everal ways to c │ │ │ │ │ -00009610: 6f6e 7374 7275 6374 2074 6865 7365 2066 onstruct these f │ │ │ │ │ -00009620: 6f72 6d61 7473 2e20 2049 7420 7769 6c6c ormats. It will │ │ │ │ │ -00009630: 0a20 2020 2020 6e6f 7420 6162 6f72 7420 . not abort │ │ │ │ │ -00009640: 6966 2069 7420 6361 6e6e 6f74 2066 696e if it cannot fin │ │ │ │ │ -00009650: 6420 6120 746f 6f6c 2075 7020 746f 2074 d a tool up to t │ │ │ │ │ -00009660: 6865 2074 6173 6b20 2873 6f20 7468 6174 he task (so that │ │ │ │ │ -00009670: 2074 6865 0a20 2020 2020 7061 636b 6167 the. packag │ │ │ │ │ -00009680: 6520 6361 6e20 7374 696c 6c20 6265 2062 e can still be b │ │ │ │ │ -00009690: 7569 6c74 292c 2062 7574 2027 6d61 6b65 uilt), but 'make │ │ │ │ │ -000096a0: 2064 6973 7427 2077 696c 6c20 6661 696c dist' will fail │ │ │ │ │ -000096b0: 2e0a 0a56 4552 5349 4f4e 0a20 2020 2020 ...VERSION. │ │ │ │ │ -000096c0: 4120 7665 7273 696f 6e20 6e75 6d62 6572 A version number │ │ │ │ │ -000096d0: 2028 652e 672e 2c20 2730 2e33 3027 2920 (e.g., '0.30') │ │ │ │ │ -000096e0: 6361 6e20 6265 2073 7065 6369 6669 6564 can be specified │ │ │ │ │ -000096f0: 2e20 2049 6620 4175 746f 6d61 6b65 2069 . If Automake i │ │ │ │ │ -00009700: 730a 2020 2020 206e 6f74 206e 6577 6572 s. not newer │ │ │ │ │ -00009710: 2074 6861 6e20 7468 6520 7665 7273 696f than the versio │ │ │ │ │ -00009720: 6e20 7370 6563 6966 6965 642c 2063 7265 n specified, cre │ │ │ │ │ -00009730: 6174 696f 6e20 6f66 2074 6865 2027 4d61 ation of the 'Ma │ │ │ │ │ -00009740: 6b65 6669 6c65 2e69 6e27 0a20 2020 2020 kefile.in'. │ │ │ │ │ -00009750: 7769 6c6c 2062 6520 7375 7070 7265 7373 will be suppress │ │ │ │ │ -00009760: 6564 2e0a 0a27 2d57 4341 5445 474f 5259 ed...'-WCATEGORY │ │ │ │ │ -00009770: 2720 6f72 2027 2d2d 7761 726e 696e 6773 ' or '--warnings │ │ │ │ │ -00009780: 3d43 4154 4547 4f52 5927 0a20 2020 2020 =CATEGORY'. │ │ │ │ │ -00009790: 5468 6573 6520 6f70 7469 6f6e 7320 6265 These options be │ │ │ │ │ -000097a0: 6861 7665 2065 7861 6374 6c79 206c 696b have exactly lik │ │ │ │ │ -000097b0: 6520 7468 6569 7220 636f 6d6d 616e 642d e their command- │ │ │ │ │ -000097c0: 6c69 6e65 2063 6f75 6e74 6572 7061 7274 line counterpart │ │ │ │ │ -000097d0: 0a20 2020 2020 282a 6e6f 7465 2061 7574 . (*note aut │ │ │ │ │ -000097e0: 6f6d 616b 6520 496e 766f 6361 7469 6f6e omake Invocation │ │ │ │ │ -000097f0: 3a3a 292e 2020 5468 6973 2061 6c6c 6f77 ::). This allow │ │ │ │ │ -00009800: 7320 796f 7520 746f 2065 6e61 626c 6520 s you to enable │ │ │ │ │ -00009810: 6f72 0a20 2020 2020 6469 7361 626c 6520 or. disable │ │ │ │ │ -00009820: 736f 6d65 2077 6172 6e69 6e67 2063 6174 some warning cat │ │ │ │ │ -00009830: 6567 6f72 6965 7320 6f6e 2061 2070 6572 egories on a per │ │ │ │ │ -00009840: 2d66 696c 6520 6261 7369 732e 2020 596f -file basis. Yo │ │ │ │ │ -00009850: 7520 6361 6e20 616c 736f 0a20 2020 2020 u can also. │ │ │ │ │ -00009860: 7365 7475 7020 736f 6d65 2077 6172 6e69 setup some warni │ │ │ │ │ -00009870: 6e67 7320 666f 7220 796f 7572 2065 6e74 ngs for your ent │ │ │ │ │ -00009880: 6972 6520 7072 6f6a 6563 743b 2066 6f72 ire project; for │ │ │ │ │ -00009890: 2069 6e73 7461 6e63 652c 2074 7279 0a20 instance, try. │ │ │ │ │ -000098a0: 2020 2020 2741 4d5f 494e 4954 5f41 5554 'AM_INIT_AUT │ │ │ │ │ -000098b0: 4f4d 414b 4528 5b2d 5761 6c6c 5d29 2720 OMAKE([-Wall])' │ │ │ │ │ -000098c0: 696e 2079 6f75 7220 2763 6f6e 6669 6775 in your 'configu │ │ │ │ │ -000098d0: 7265 2e61 6327 2e0a 0a20 2020 556e 7265 re.ac'... Unre │ │ │ │ │ -000098e0: 636f 676e 697a 6564 206f 7074 696f 6e73 cognized options │ │ │ │ │ -000098f0: 2061 7265 2064 6961 676e 6f73 6564 2062 are diagnosed b │ │ │ │ │ -00009900: 7920 2761 7574 6f6d 616b 6527 2e0a 0a20 y 'automake'... │ │ │ │ │ -00009910: 2020 4966 2079 6f75 2077 616e 7420 616e If you want an │ │ │ │ │ -00009920: 206f 7074 696f 6e20 746f 2061 7070 6c79 option to apply │ │ │ │ │ -00009930: 2074 6f20 616c 6c20 7468 6520 6669 6c65 to all the file │ │ │ │ │ -00009940: 7320 696e 2074 6865 2074 7265 652c 2079 s in the tree, y │ │ │ │ │ -00009950: 6f75 2063 616e 0a75 7365 2074 6865 2027 ou can.use the ' │ │ │ │ │ -00009960: 414d 5f49 4e49 545f 4155 544f 4d41 4b45 AM_INIT_AUTOMAKE │ │ │ │ │ -00009970: 2720 6d61 6372 6f20 696e 2027 636f 6e66 ' macro in 'conf │ │ │ │ │ -00009980: 6967 7572 652e 6163 272e 2020 2a4e 6f74 igure.ac'. *Not │ │ │ │ │ -00009990: 6520 4d61 6372 6f73 3a3a 2e0a 0a1f 0a46 e Macros::.....F │ │ │ │ │ -000099a0: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -000099b0: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -000099c0: 4d69 7363 656c 6c61 6e65 6f75 732c 2020 Miscellaneous, │ │ │ │ │ -000099d0: 4e65 7874 3a20 496e 636c 7564 652c 2020 Next: Include, │ │ │ │ │ -000099e0: 5072 6576 3a20 4f70 7469 6f6e 732c 2020 Prev: Options, │ │ │ │ │ -000099f0: 5570 3a20 546f 700a 0a31 3820 4d69 7363 Up: Top..18 Misc │ │ │ │ │ -00009a00: 656c 6c61 6e65 6f75 7320 5275 6c65 730a ellaneous Rules. │ │ │ │ │ -00009a10: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00009a20: 2a2a 2a2a 2a2a 0a0a 5468 6572 6520 6172 ******..There ar │ │ │ │ │ -00009a30: 6520 6120 6665 7720 7275 6c65 7320 616e e a few rules an │ │ │ │ │ -00009a40: 6420 7661 7269 6162 6c65 7320 7468 6174 d variables that │ │ │ │ │ -00009a50: 2064 6964 6e27 7420 6669 7420 616e 7977 didn't fit anyw │ │ │ │ │ -00009a60: 6865 7265 2065 6c73 652e 0a0a 2a20 4d65 here else...* Me │ │ │ │ │ -00009a70: 6e75 3a0a 0a2a 2054 6167 733a 3a20 2020 nu:..* Tags:: │ │ │ │ │ -00009a80: 2020 2020 2049 6e74 6572 6661 6369 6e67 Interfacing │ │ │ │ │ -00009a90: 2074 6f20 6574 6167 7320 616e 6420 6d6b to etags and mk │ │ │ │ │ -00009aa0: 6964 0a2a 2053 7566 6669 7865 733a 3a20 id.* Suffixes:: │ │ │ │ │ -00009ab0: 2020 2048 616e 646c 696e 6720 6e65 7720 Handling new │ │ │ │ │ -00009ac0: 6669 6c65 2065 7874 656e 7369 6f6e 730a file extensions. │ │ │ │ │ -00009ad0: 2a20 4d75 6c74 696c 6962 733a 3a20 2020 * Multilibs:: │ │ │ │ │ -00009ae0: 5375 7070 6f72 7420 666f 7220 6d75 6c74 Support for mult │ │ │ │ │ -00009af0: 696c 6962 7320 2864 6570 7265 6361 7465 ilibs (deprecate │ │ │ │ │ -00009b00: 642c 2073 6f6f 6e20 746f 2062 6520 7265 d, soon to be re │ │ │ │ │ -00009b10: 6d6f 7665 6429 2e0a 0a1f 0a46 696c 653a moved).....File: │ │ │ │ │ -00009b20: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ -00009b30: 6e66 6f2c 2020 4e6f 6465 3a20 5461 6773 nfo, Node: Tags │ │ │ │ │ -00009b40: 2c20 204e 6578 743a 2053 7566 6669 7865 , Next: Suffixe │ │ │ │ │ -00009b50: 732c 2020 5570 3a20 4d69 7363 656c 6c61 s, Up: Miscella │ │ │ │ │ -00009b60: 6e65 6f75 730a 0a31 382e 3120 496e 7465 neous..18.1 Inte │ │ │ │ │ -00009b70: 7266 6163 696e 6720 746f 2027 6574 6167 rfacing to 'etag │ │ │ │ │ -00009b80: 7327 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s'.============= │ │ │ │ │ -00009b90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00009ba0: 4175 746f 6d61 6b65 2077 696c 6c20 6765 Automake will ge │ │ │ │ │ -00009bb0: 6e65 7261 7465 2072 756c 6573 2074 6f20 nerate rules to │ │ │ │ │ -00009bc0: 6765 6e65 7261 7465 2027 5441 4753 2720 generate 'TAGS' │ │ │ │ │ -00009bd0: 6669 6c65 7320 666f 7220 7573 6520 7769 files for use wi │ │ │ │ │ -00009be0: 7468 2047 4e55 0a45 6d61 6373 2075 6e64 th GNU.Emacs und │ │ │ │ │ -00009bf0: 6572 2073 6f6d 6520 6369 7263 756d 7374 er some circumst │ │ │ │ │ -00009c00: 616e 6365 732e 0a0a 2020 2049 6620 616e ances... If an │ │ │ │ │ -00009c10: 7920 432c 2043 2b2b 206f 7220 466f 7274 y C, C++ or Fort │ │ │ │ │ -00009c20: 7261 6e20 3737 2073 6f75 7263 6520 636f ran 77 source co │ │ │ │ │ -00009c30: 6465 206f 7220 6865 6164 6572 7320 6172 de or headers ar │ │ │ │ │ -00009c40: 6520 7072 6573 656e 742c 2074 6865 6e0a e present, then. │ │ │ │ │ -00009c50: 2774 6167 7327 2061 6e64 2027 5441 4753 'tags' and 'TAGS │ │ │ │ │ -00009c60: 2720 7275 6c65 7320 7769 6c6c 2062 6520 ' rules will be │ │ │ │ │ -00009c70: 6765 6e65 7261 7465 6420 666f 7220 7468 generated for th │ │ │ │ │ -00009c80: 6520 6469 7265 6374 6f72 792e 2020 416c e directory. Al │ │ │ │ │ -00009c90: 6c20 6669 6c65 730a 6c69 7374 6564 2075 l files.listed u │ │ │ │ │ -00009ca0: 7369 6e67 2074 6865 2027 5f53 4f55 5243 sing the '_SOURC │ │ │ │ │ -00009cb0: 4553 272c 2027 5f48 4541 4445 5253 272c ES', '_HEADERS', │ │ │ │ │ -00009cc0: 2061 6e64 2027 5f4c 4953 5027 2070 7269 and '_LISP' pri │ │ │ │ │ -00009cd0: 6d61 7269 6573 2077 696c 6c20 6265 0a75 maries will be.u │ │ │ │ │ -00009ce0: 7365 6420 746f 2067 656e 6572 6174 6520 sed to generate │ │ │ │ │ -00009cf0: 7461 6773 2e20 204e 6f74 6520 7468 6174 tags. Note that │ │ │ │ │ -00009d00: 2067 656e 6572 6174 6564 2073 6f75 7263 generated sourc │ │ │ │ │ -00009d10: 6520 6669 6c65 7320 7468 6174 2061 7265 e files that are │ │ │ │ │ -00009d20: 206e 6f74 0a64 6973 7472 6962 7574 6564 not.distributed │ │ │ │ │ -00009d30: 206d 7573 7420 6265 2064 6563 6c61 7265 must be declare │ │ │ │ │ -00009d40: 6420 696e 2076 6172 6961 626c 6573 206c d in variables l │ │ │ │ │ -00009d50: 696b 6520 276e 6f64 6973 745f 6e6f 696e ike 'nodist_noin │ │ │ │ │ -00009d60: 7374 5f48 4541 4445 5253 270a 6f72 2027 st_HEADERS'.or ' │ │ │ │ │ -00009d70: 6e6f 6469 7374 5f50 524f 475f 534f 5552 nodist_PROG_SOUR │ │ │ │ │ -00009d80: 4345 5327 206f 7220 7468 6579 2077 696c CES' or they wil │ │ │ │ │ -00009d90: 6c20 6265 2069 676e 6f72 6564 2e0a 0a20 l be ignored... │ │ │ │ │ -00009da0: 2020 4120 2774 6167 7327 2072 756c 6520 A 'tags' rule │ │ │ │ │ -00009db0: 7769 6c6c 2062 6520 6f75 7470 7574 2061 will be output a │ │ │ │ │ -00009dc0: 7420 7468 6520 746f 706d 6f73 7420 6469 t the topmost di │ │ │ │ │ -00009dd0: 7265 6374 6f72 7920 6f66 2061 0a6d 756c rectory of a.mul │ │ │ │ │ -00009de0: 7469 2d64 6972 6563 746f 7279 2070 6163 ti-directory pac │ │ │ │ │ -00009df0: 6b61 6765 2e20 2057 6865 6e20 7275 6e20 kage. When run │ │ │ │ │ -00009e00: 6672 6f6d 2074 6869 7320 746f 706d 6f73 from this topmos │ │ │ │ │ -00009e10: 7420 6469 7265 6374 6f72 792c 2027 6d61 t directory, 'ma │ │ │ │ │ -00009e20: 6b65 0a74 6167 7327 2077 696c 6c20 6765 ke.tags' will ge │ │ │ │ │ -00009e30: 6e65 7261 7465 2061 2027 5441 4753 2720 nerate a 'TAGS' │ │ │ │ │ -00009e40: 6669 6c65 2074 6861 7420 696e 636c 7564 file that includ │ │ │ │ │ -00009e50: 6573 2062 7920 7265 6665 7265 6e63 6520 es by reference │ │ │ │ │ -00009e60: 616c 6c20 2754 4147 5327 0a66 696c 6573 all 'TAGS'.files │ │ │ │ │ -00009e70: 2066 726f 6d20 7375 6264 6972 6563 746f from subdirecto │ │ │ │ │ -00009e80: 7269 6573 2e0a 0a20 2020 5468 6520 2774 ries... The 't │ │ │ │ │ -00009e90: 6167 7327 2072 756c 6520 7769 6c6c 2061 ags' rule will a │ │ │ │ │ -00009ea0: 6c73 6f20 6265 2067 656e 6572 6174 6564 lso be generated │ │ │ │ │ -00009eb0: 2069 6620 7468 6520 7661 7269 6162 6c65 if the variable │ │ │ │ │ -00009ec0: 2027 4554 4147 535f 4152 4753 270a 6973 'ETAGS_ARGS'.is │ │ │ │ │ -00009ed0: 2064 6566 696e 6564 2e20 2054 6869 7320 defined. This │ │ │ │ │ -00009ee0: 7661 7269 6162 6c65 2069 7320 696e 7465 variable is inte │ │ │ │ │ -00009ef0: 6e64 6564 2066 6f72 2075 7365 2069 6e20 nded for use in │ │ │ │ │ -00009f00: 6469 7265 6374 6f72 6965 7320 7468 6174 directories that │ │ │ │ │ -00009f10: 0a63 6f6e 7461 696e 2074 6167 6761 626c .contain taggabl │ │ │ │ │ -00009f20: 6520 736f 7572 6365 2074 6861 7420 2765 e source that 'e │ │ │ │ │ -00009f30: 7461 6773 2720 646f 6573 206e 6f74 2075 tags' does not u │ │ │ │ │ -00009f40: 6e64 6572 7374 616e 642e 2020 5468 6520 nderstand. The │ │ │ │ │ -00009f50: 7573 6572 2063 616e 0a75 7365 2074 6865 user can.use the │ │ │ │ │ -00009f60: 2027 4554 4147 5346 4c41 4753 2720 746f 'ETAGSFLAGS' to │ │ │ │ │ -00009f70: 2070 6173 7320 6164 6469 7469 6f6e 616c pass additional │ │ │ │ │ -00009f80: 2066 6c61 6773 2074 6f20 2765 7461 6773 flags to 'etags │ │ │ │ │ -00009f90: 273b 0a27 414d 5f45 5441 4753 464c 4147 ';.'AM_ETAGSFLAG │ │ │ │ │ -00009fa0: 5327 2069 7320 616c 736f 2061 7661 696c S' is also avail │ │ │ │ │ -00009fb0: 6162 6c65 2066 6f72 2075 7365 2069 6e20 able for use in │ │ │ │ │ -00009fc0: 274d 616b 6566 696c 652e 616d 272e 0a0a 'Makefile.am'... │ │ │ │ │ -00009fd0: 2020 2048 6572 6520 6973 2068 6f77 2041 Here is how A │ │ │ │ │ -00009fe0: 7574 6f6d 616b 6520 6765 6e65 7261 7465 utomake generate │ │ │ │ │ -00009ff0: 7320 7461 6773 2066 6f72 2069 7473 2073 s tags for its s │ │ │ │ │ -0000a000: 6f75 7263 652c 2061 6e64 2066 6f72 206e ource, and for n │ │ │ │ │ -0000a010: 6f64 6573 2069 6e0a 6974 7320 5465 7869 odes in.its Texi │ │ │ │ │ -0000a020: 6e66 6f20 6669 6c65 3a0a 0a20 2020 2020 nfo file:.. │ │ │ │ │ -0000a030: 4554 4147 535f 4152 4753 203d 2061 7574 ETAGS_ARGS = aut │ │ │ │ │ -0000a040: 6f6d 616b 652e 696e 202d 2d6c 616e 673d omake.in --lang= │ │ │ │ │ -0000a050: 6e6f 6e65 205c 0a20 2020 2020 202d 2d72 none \. --r │ │ │ │ │ -0000a060: 6567 6578 3d27 2f5e 406e 6f64 655b 205c egex='/^@node[ \ │ │ │ │ │ -0000a070: 745d 2b5c 285b 5e2c 5d2b 5c29 2f5c 312f t]+\([^,]+\)/\1/ │ │ │ │ │ -0000a080: 2720 6175 746f 6d61 6b65 2e74 6578 690a ' automake.texi. │ │ │ │ │ -0000a090: 0a20 2020 4966 2079 6f75 2061 6464 2066 . If you add f │ │ │ │ │ -0000a0a0: 696c 6520 6e61 6d65 7320 746f 2027 4554 ile names to 'ET │ │ │ │ │ -0000a0b0: 4147 535f 4152 4753 272c 2079 6f75 2077 AGS_ARGS', you w │ │ │ │ │ -0000a0c0: 696c 6c20 7072 6f62 6162 6c79 2061 6c73 ill probably als │ │ │ │ │ -0000a0d0: 6f20 7761 6e74 2074 6f0a 6465 6669 6e65 o want to.define │ │ │ │ │ -0000a0e0: 2027 5441 4753 5f44 4550 454e 4445 4e43 'TAGS_DEPENDENC │ │ │ │ │ -0000a0f0: 4945 5327 2e20 2054 6865 2063 6f6e 7465 IES'. The conte │ │ │ │ │ -0000a100: 6e74 7320 6f66 2074 6869 7320 7661 7269 nts of this vari │ │ │ │ │ -0000a110: 6162 6c65 2061 7265 2061 6464 6564 0a64 able are added.d │ │ │ │ │ -0000a120: 6972 6563 746c 7920 746f 2074 6865 2064 irectly to the d │ │ │ │ │ -0000a130: 6570 656e 6465 6e63 6965 7320 666f 7220 ependencies for │ │ │ │ │ -0000a140: 7468 6520 2774 6167 7327 2072 756c 652e the 'tags' rule. │ │ │ │ │ -0000a150: 0a0a 2020 2041 7574 6f6d 616b 6520 616c .. Automake al │ │ │ │ │ -0000a160: 736f 2067 656e 6572 6174 6573 2061 2027 so generates a ' │ │ │ │ │ -0000a170: 6374 6167 7327 2072 756c 6520 7468 6174 ctags' rule that │ │ │ │ │ -0000a180: 2063 616e 2062 6520 7573 6564 2074 6f20 can be used to │ │ │ │ │ -0000a190: 6275 696c 640a 2776 6927 2d73 7479 6c65 build.'vi'-style │ │ │ │ │ -0000a1a0: 2027 7461 6773 2720 6669 6c65 732e 2020 'tags' files. │ │ │ │ │ -0000a1b0: 5468 6520 7661 7269 6162 6c65 2027 4354 The variable 'CT │ │ │ │ │ -0000a1c0: 4147 5327 2069 7320 7468 6520 6e61 6d65 AGS' is the name │ │ │ │ │ -0000a1d0: 206f 6620 7468 650a 7072 6f67 7261 6d20 of the.program │ │ │ │ │ -0000a1e0: 746f 2069 6e76 6f6b 6520 2862 7920 6465 to invoke (by de │ │ │ │ │ -0000a1f0: 6661 756c 7420 2763 7461 6773 2729 3b20 fault 'ctags'); │ │ │ │ │ -0000a200: 2743 5441 4753 464c 4147 5327 2063 616e 'CTAGSFLAGS' can │ │ │ │ │ -0000a210: 2062 6520 7573 6564 2062 7920 7468 650a be used by the. │ │ │ │ │ -0000a220: 7573 6572 2074 6f20 7061 7373 2061 6464 user to pass add │ │ │ │ │ -0000a230: 6974 696f 6e61 6c20 666c 6167 732c 2061 itional flags, a │ │ │ │ │ -0000a240: 6e64 2027 414d 5f43 5441 4753 464c 4147 nd 'AM_CTAGSFLAG │ │ │ │ │ -0000a250: 5327 2063 616e 2062 6520 7573 6564 2062 S' can be used b │ │ │ │ │ -0000a260: 7920 7468 650a 274d 616b 6566 696c 652e y the.'Makefile. │ │ │ │ │ -0000a270: 616d 272e 0a0a 2020 2041 7574 6f6d 616b am'... Automak │ │ │ │ │ -0000a280: 6520 7769 6c6c 2061 6c73 6f20 6765 6e65 e will also gene │ │ │ │ │ -0000a290: 7261 7465 2061 6e20 2749 4427 2072 756c rate an 'ID' rul │ │ │ │ │ -0000a2a0: 6520 7468 6174 2077 696c 6c20 7275 6e20 e that will run │ │ │ │ │ -0000a2b0: 276d 6b69 6427 206f 6e20 7468 650a 736f 'mkid' on the.so │ │ │ │ │ -0000a2c0: 7572 6365 2e20 2054 6869 7320 6973 206f urce. This is o │ │ │ │ │ -0000a2d0: 6e6c 7920 7375 7070 6f72 7465 6420 6f6e nly supported on │ │ │ │ │ -0000a2e0: 2061 2064 6972 6563 746f 7279 2d62 792d a directory-by- │ │ │ │ │ -0000a2f0: 6469 7265 6374 6f72 7920 6261 7369 732e directory basis. │ │ │ │ │ -0000a300: 0a0a 2020 2046 696e 616c 6c79 2c20 4175 .. Finally, Au │ │ │ │ │ -0000a310: 746f 6d61 6b65 2061 6c73 6f20 656d 6974 tomake also emit │ │ │ │ │ -0000a320: 7320 7275 6c65 7320 746f 2073 7570 706f s rules to suppo │ │ │ │ │ -0000a330: 7274 2074 6865 2047 4e55 2047 6c6f 6261 rt the GNU Globa │ │ │ │ │ -0000a340: 6c20 5461 6773 0a70 726f 6772 616d 2028 l Tags.program ( │ │ │ │ │ -0000a350: 6874 7470 3a2f 2f77 7777 2e67 6e75 2e6f http://www.gnu.o │ │ │ │ │ -0000a360: 7267 2f73 6f66 7477 6172 652f 676c 6f62 rg/software/glob │ │ │ │ │ -0000a370: 616c 2f29 2e20 2054 6865 2027 4754 4147 al/). The 'GTAG │ │ │ │ │ -0000a380: 5327 2072 756c 6520 7275 6e73 0a47 6c6f S' rule runs.Glo │ │ │ │ │ -0000a390: 6261 6c20 5461 6773 2061 6e64 2070 7574 bal Tags and put │ │ │ │ │ -0000a3a0: 7320 7468 6520 7265 7375 6c74 2069 6e20 s the result in │ │ │ │ │ -0000a3b0: 7468 6520 746f 7020 6275 696c 6420 6469 the top build di │ │ │ │ │ -0000a3c0: 7265 6374 6f72 792e 2020 5468 650a 7661 rectory. The.va │ │ │ │ │ -0000a3d0: 7269 6162 6c65 2027 4754 4147 535f 4152 riable 'GTAGS_AR │ │ │ │ │ -0000a3e0: 4753 2720 686f 6c64 7320 6172 6775 6d65 GS' holds argume │ │ │ │ │ -0000a3f0: 6e74 7320 7468 6174 2061 7265 2070 6173 nts that are pas │ │ │ │ │ -0000a400: 7365 6420 746f 2027 6774 6167 7327 2e0a sed to 'gtags'.. │ │ │ │ │ -0000a410: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -0000a420: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -0000a430: 6465 3a20 5375 6666 6978 6573 2c20 204e de: Suffixes, N │ │ │ │ │ -0000a440: 6578 743a 204d 756c 7469 6c69 6273 2c20 ext: Multilibs, │ │ │ │ │ -0000a450: 2050 7265 763a 2054 6167 732c 2020 5570 Prev: Tags, Up │ │ │ │ │ -0000a460: 3a20 4d69 7363 656c 6c61 6e65 6f75 730a : Miscellaneous. │ │ │ │ │ -0000a470: 0a31 382e 3220 4861 6e64 6c69 6e67 206e .18.2 Handling n │ │ │ │ │ -0000a480: 6577 2066 696c 6520 6578 7465 6e73 696f ew file extensio │ │ │ │ │ -0000a490: 6e73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ns.============= │ │ │ │ │ +000071d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5661 ************..Va │ │ │ │ │ +000071e0: 7269 6f75 7320 6665 6174 7572 6573 206f rious features o │ │ │ │ │ +000071f0: 6620 4175 746f 6d61 6b65 2063 616e 2062 f Automake can b │ │ │ │ │ +00007200: 6520 636f 6e74 726f 6c6c 6564 2062 7920 e controlled by │ │ │ │ │ +00007210: 6f70 7469 6f6e 732e 2020 4578 6365 7074 options. Except │ │ │ │ │ +00007220: 2077 6865 7265 0a6e 6f74 6564 206f 7468 where.noted oth │ │ │ │ │ +00007230: 6572 7769 7365 2c20 6f70 7469 6f6e 7320 erwise, options │ │ │ │ │ +00007240: 6361 6e20 6265 2073 7065 6369 6669 6564 can be specified │ │ │ │ │ +00007250: 2069 6e20 6f6e 6520 6f66 2073 6576 6572 in one of sever │ │ │ │ │ +00007260: 616c 2077 6179 733a 204d 6f73 740a 6f70 al ways: Most.op │ │ │ │ │ +00007270: 7469 6f6e 7320 6361 6e20 6265 2061 7070 tions can be app │ │ │ │ │ +00007280: 6c69 6564 206f 6e20 6120 7065 722d 274d lied on a per-'M │ │ │ │ │ +00007290: 616b 6566 696c 6527 2062 6173 6973 2077 akefile' basis w │ │ │ │ │ +000072a0: 6865 6e20 6c69 7374 6564 2069 6e20 610a hen listed in a. │ │ │ │ │ +000072b0: 7370 6563 6961 6c20 274d 616b 6566 696c special 'Makefil │ │ │ │ │ +000072c0: 6527 2076 6172 6961 626c 6520 6e61 6d65 e' variable name │ │ │ │ │ +000072d0: 6420 2741 5554 4f4d 414b 455f 4f50 5449 d 'AUTOMAKE_OPTI │ │ │ │ │ +000072e0: 4f4e 5327 2e20 2053 6f6d 6520 6f66 2074 ONS'. Some of t │ │ │ │ │ +000072f0: 6865 7365 0a6f 7074 696f 6e73 206f 6e6c hese.options onl │ │ │ │ │ +00007300: 7920 6d61 6b65 2073 656e 7365 2077 6865 y make sense whe │ │ │ │ │ +00007310: 6e20 7370 6563 6966 6965 6420 696e 2074 n specified in t │ │ │ │ │ +00007320: 6865 2074 6f70 6c65 7665 6c20 274d 616b he toplevel 'Mak │ │ │ │ │ +00007330: 6566 696c 652e 616d 270a 6669 6c65 2e20 efile.am'.file. │ │ │ │ │ +00007340: 204f 7074 696f 6e73 2061 7265 2061 7070 Options are app │ │ │ │ │ +00007350: 6c69 6564 2067 6c6f 6261 6c6c 7920 746f lied globally to │ │ │ │ │ +00007360: 2061 6c6c 2070 726f 6365 7373 6564 2027 all processed ' │ │ │ │ │ +00007370: 4d61 6b65 6669 6c65 2720 6669 6c65 730a Makefile' files. │ │ │ │ │ +00007380: 7768 656e 206c 6973 7465 6420 696e 2074 when listed in t │ │ │ │ │ +00007390: 6865 2066 6972 7374 2061 7267 756d 656e he first argumen │ │ │ │ │ +000073a0: 7420 6f66 2027 414d 5f49 4e49 545f 4155 t of 'AM_INIT_AU │ │ │ │ │ +000073b0: 544f 4d41 4b45 2720 696e 0a27 636f 6e66 TOMAKE' in.'conf │ │ │ │ │ +000073c0: 6967 7572 652e 6163 272c 2061 6e64 2073 igure.ac', and s │ │ │ │ │ +000073d0: 6f6d 6520 6f70 7469 6f6e 7320 7768 6963 ome options whic │ │ │ │ │ +000073e0: 6820 7265 7175 6972 6520 6368 616e 6765 h require change │ │ │ │ │ +000073f0: 7320 746f 2074 6865 0a27 636f 6e66 6967 s to the.'config │ │ │ │ │ +00007400: 7572 6527 2073 6372 6970 7420 6361 6e20 ure' script can │ │ │ │ │ +00007410: 6f6e 6c79 2062 6520 7370 6563 6966 6965 only be specifie │ │ │ │ │ +00007420: 6420 7468 6572 652e 2020 5468 6573 6520 d there. These │ │ │ │ │ +00007430: 6172 6520 616e 6e6f 7461 7465 640a 6265 are annotated.be │ │ │ │ │ +00007440: 6c6f 772e 0a0a 2020 2043 7572 7265 6e74 low... Current │ │ │ │ │ +00007450: 6c79 2075 6e64 6572 7374 6f6f 6420 6f70 ly understood op │ │ │ │ │ +00007460: 7469 6f6e 7320 6172 653a 0a0a 2767 6e69 tions are:..'gni │ │ │ │ │ +00007470: 7473 270a 2767 6e75 270a 2766 6f72 6569 ts'.'gnu'.'forei │ │ │ │ │ +00007480: 676e 270a 2763 7967 6e75 7327 0a0a 2020 gn'.'cygnus'.. │ │ │ │ │ +00007490: 2020 2053 6574 2074 6865 2073 7472 6963 Set the stric │ │ │ │ │ +000074a0: 746e 6573 7320 6173 2061 7070 726f 7072 tness as appropr │ │ │ │ │ +000074b0: 6961 7465 2e20 2054 6865 2027 676e 6974 iate. The 'gnit │ │ │ │ │ +000074c0: 7327 206f 7074 696f 6e20 616c 736f 2069 s' option also i │ │ │ │ │ +000074d0: 6d70 6c69 6573 0a20 2020 2020 6f70 7469 mplies. opti │ │ │ │ │ +000074e0: 6f6e 7320 2772 6561 646d 652d 616c 7068 ons 'readme-alph │ │ │ │ │ +000074f0: 6127 2061 6e64 2027 6368 6563 6b2d 6e65 a' and 'check-ne │ │ │ │ │ +00007500: 7773 272e 0a0a 2761 6e73 6932 6b6e 7227 ws'...'ansi2knr' │ │ │ │ │ +00007510: 0a27 5041 5448 2f61 6e73 6932 6b6e 7227 .'PATH/ansi2knr' │ │ │ │ │ +00007520: 0a20 2020 2020 5475 726e 206f 6e20 7468 . Turn on th │ │ │ │ │ +00007530: 6520 6465 7072 6563 6174 6564 2064 652d e deprecated de- │ │ │ │ │ +00007540: 414e 5349 2d66 6963 6174 696f 6e20 6665 ANSI-fication fe │ │ │ │ │ +00007550: 6174 7572 6520 282a 6e6f 7465 2041 4e53 ature (*note ANS │ │ │ │ │ +00007560: 493a 3a29 2e0a 2020 2020 204e 6f74 6520 I::).. Note │ │ │ │ │ +00007570: 7468 6174 2074 6861 7420 6665 6174 7572 that that featur │ │ │ │ │ +00007580: 6520 616e 6420 7468 6973 206f 7074 696f e and this optio │ │ │ │ │ +00007590: 6e20 5f77 696c 6c20 6265 2072 656d 6f76 n _will be remov │ │ │ │ │ +000075a0: 6564 5f20 696e 2074 6865 0a20 2020 2020 ed_ in the. │ │ │ │ │ +000075b0: 6e65 7874 206d 616a 6f72 2041 7574 6f6d next major Autom │ │ │ │ │ +000075c0: 616b 6520 7265 6c65 6173 652e 0a0a 2020 ake release... │ │ │ │ │ +000075d0: 2020 2049 6620 7072 6563 6564 6564 2062 If preceded b │ │ │ │ │ +000075e0: 7920 6120 7061 7468 2c20 7468 6520 6765 y a path, the ge │ │ │ │ │ +000075f0: 6e65 7261 7465 6420 274d 616b 6566 696c nerated 'Makefil │ │ │ │ │ +00007600: 652e 696e 2720 7769 6c6c 206c 6f6f 6b20 e.in' will look │ │ │ │ │ +00007610: 696e 2074 6865 0a20 2020 2020 7370 6563 in the. spec │ │ │ │ │ +00007620: 6966 6965 6420 6469 7265 6374 6f72 7920 ified directory │ │ │ │ │ +00007630: 746f 2066 696e 6420 7468 6520 2761 6e73 to find the 'ans │ │ │ │ │ +00007640: 6932 6b6e 7227 2070 726f 6772 616d 2e20 i2knr' program. │ │ │ │ │ +00007650: 2054 6865 2070 6174 680a 2020 2020 2073 The path. s │ │ │ │ │ +00007660: 686f 756c 6420 6265 2061 2072 656c 6174 hould be a relat │ │ │ │ │ +00007670: 6976 6520 7061 7468 2074 6f20 616e 6f74 ive path to anot │ │ │ │ │ +00007680: 6865 7220 6469 7265 6374 6f72 7920 696e her directory in │ │ │ │ │ +00007690: 2074 6865 2073 616d 650a 2020 2020 2064 the same. d │ │ │ │ │ +000076a0: 6973 7472 6962 7574 696f 6e20 2841 7574 istribution (Aut │ │ │ │ │ +000076b0: 6f6d 616b 6520 646f 6573 206e 6f74 2063 omake does not c │ │ │ │ │ +000076c0: 6865 636b 2074 6869 7329 2e0a 0a27 6368 heck this)...'ch │ │ │ │ │ +000076d0: 6563 6b2d 6e65 7773 270a 2020 2020 2043 eck-news'. C │ │ │ │ │ +000076e0: 6175 7365 2027 6d61 6b65 2064 6973 7427 ause 'make dist' │ │ │ │ │ +000076f0: 2074 6f20 6661 696c 2075 6e6c 6573 7320 to fail unless │ │ │ │ │ +00007700: 7468 6520 6375 7272 656e 7420 7665 7273 the current vers │ │ │ │ │ +00007710: 696f 6e20 6e75 6d62 6572 2061 7070 6561 ion number appea │ │ │ │ │ +00007720: 7273 0a20 2020 2020 696e 2074 6865 2066 rs. in the f │ │ │ │ │ +00007730: 6972 7374 2066 6577 206c 696e 6573 206f irst few lines o │ │ │ │ │ +00007740: 6620 7468 6520 274e 4557 5327 2066 696c f the 'NEWS' fil │ │ │ │ │ +00007750: 652e 0a0a 2763 6f6c 6f72 2d74 6573 7473 e...'color-tests │ │ │ │ │ +00007760: 270a 2020 2020 2043 6175 7365 206f 7574 '. Cause out │ │ │ │ │ +00007770: 7075 7420 6f66 2074 6865 2073 696d 706c put of the simpl │ │ │ │ │ +00007780: 6520 7465 7374 2073 7569 7465 2028 2a6e e test suite (*n │ │ │ │ │ +00007790: 6f74 6520 5369 6d70 6c65 2054 6573 7473 ote Simple Tests │ │ │ │ │ +000077a0: 3a3a 2920 746f 2062 650a 2020 2020 2063 ::) to be. c │ │ │ │ │ +000077b0: 6f6c 6f72 697a 6564 206f 6e20 6361 7061 olorized on capa │ │ │ │ │ +000077c0: 626c 6520 7465 726d 696e 616c 732e 0a0a ble terminals... │ │ │ │ │ +000077d0: 2764 656a 6167 6e75 270a 2020 2020 2043 'dejagnu'. C │ │ │ │ │ +000077e0: 6175 7365 2027 6465 6a61 676e 7527 2d73 ause 'dejagnu'-s │ │ │ │ │ +000077f0: 7065 6369 6669 6320 7275 6c65 7320 746f pecific rules to │ │ │ │ │ +00007800: 2062 6520 6765 6e65 7261 7465 642e 2020 be generated. │ │ │ │ │ +00007810: 2a4e 6f74 6520 4465 6a61 476e 750a 2020 *Note DejaGnu. │ │ │ │ │ +00007820: 2020 2054 6573 7473 3a3a 2e0a 0a27 6469 Tests::...'di │ │ │ │ │ +00007830: 7374 2d62 7a69 7032 270a 2020 2020 2048 st-bzip2'. H │ │ │ │ │ +00007840: 6f6f 6b20 2764 6973 742d 627a 6970 3227 ook 'dist-bzip2' │ │ │ │ │ +00007850: 2074 6f20 2764 6973 7427 2e0a 0a27 6469 to 'dist'...'di │ │ │ │ │ +00007860: 7374 2d6c 7a69 7027 0a20 2020 2020 486f st-lzip'. Ho │ │ │ │ │ +00007870: 6f6b 2027 6469 7374 2d6c 7a69 7027 2074 ok 'dist-lzip' t │ │ │ │ │ +00007880: 6f20 2764 6973 7427 2e0a 0a27 6469 7374 o 'dist'...'dist │ │ │ │ │ +00007890: 2d6c 7a6d 6127 0a20 2020 2020 486f 6f6b -lzma'. Hook │ │ │ │ │ +000078a0: 2027 6469 7374 2d6c 7a6d 6127 2074 6f20 'dist-lzma' to │ │ │ │ │ +000078b0: 2764 6973 7427 2e20 204f 6273 6f6c 6574 'dist'. Obsolet │ │ │ │ │ +000078c0: 6564 2062 7920 2764 6973 742d 787a 272e ed by 'dist-xz'. │ │ │ │ │ +000078d0: 0a0a 2764 6973 742d 7368 6172 270a 2020 ..'dist-shar'. │ │ │ │ │ +000078e0: 2020 2048 6f6f 6b20 2764 6973 742d 7368 Hook 'dist-sh │ │ │ │ │ +000078f0: 6172 2720 746f 2027 6469 7374 272e 0a0a ar' to 'dist'... │ │ │ │ │ +00007900: 2764 6973 742d 7a69 7027 0a20 2020 2020 'dist-zip'. │ │ │ │ │ +00007910: 486f 6f6b 2027 6469 7374 2d7a 6970 2720 Hook 'dist-zip' │ │ │ │ │ +00007920: 746f 2027 6469 7374 272e 0a0a 2764 6973 to 'dist'...'dis │ │ │ │ │ +00007930: 742d 7461 725a 270a 2020 2020 2048 6f6f t-tarZ'. Hoo │ │ │ │ │ +00007940: 6b20 2764 6973 742d 7461 725a 2720 746f k 'dist-tarZ' to │ │ │ │ │ +00007950: 2027 6469 7374 272e 0a0a 2766 696c 656e 'dist'...'filen │ │ │ │ │ +00007960: 616d 652d 6c65 6e67 7468 2d6d 6178 3d39 ame-length-max=9 │ │ │ │ │ +00007970: 3927 0a20 2020 2020 4162 6f72 7420 6966 9'. Abort if │ │ │ │ │ +00007980: 2066 696c 6520 6e61 6d65 7320 6c6f 6e67 file names long │ │ │ │ │ +00007990: 6572 2074 6861 6e20 3939 2063 6861 7261 er than 99 chara │ │ │ │ │ +000079a0: 6374 6572 7320 6172 6520 666f 756e 6420 cters are found │ │ │ │ │ +000079b0: 6475 7269 6e67 0a20 2020 2020 276d 616b during. 'mak │ │ │ │ │ +000079c0: 6520 6469 7374 272e 2020 5375 6368 206c e dist'. Such l │ │ │ │ │ +000079d0: 6f6e 6720 6669 6c65 206e 616d 6573 2061 ong file names a │ │ │ │ │ +000079e0: 7265 2067 656e 6572 616c 6c79 2063 6f6e re generally con │ │ │ │ │ +000079f0: 7369 6465 7265 6420 6e6f 7420 746f 0a20 sidered not to. │ │ │ │ │ +00007a00: 2020 2020 6265 2070 6f72 7461 626c 6520 be portable │ │ │ │ │ +00007a10: 696e 2074 6172 6261 6c6c 732e 2020 5365 in tarballs. Se │ │ │ │ │ +00007a20: 6520 7468 6520 2774 6172 2d76 3727 2061 e the 'tar-v7' a │ │ │ │ │ +00007a30: 6e64 2027 7461 722d 7573 7461 7227 206f nd 'tar-ustar' o │ │ │ │ │ +00007a40: 7074 696f 6e73 0a20 2020 2020 6265 6c6f ptions. belo │ │ │ │ │ +00007a50: 772e 2020 5468 6973 206f 7074 696f 6e20 w. This option │ │ │ │ │ +00007a60: 7368 6f75 6c64 2062 6520 7573 6564 2069 should be used i │ │ │ │ │ +00007a70: 6e20 7468 6520 746f 702d 6c65 7665 6c20 n the top-level │ │ │ │ │ +00007a80: 274d 616b 6566 696c 652e 616d 270a 2020 'Makefile.am'. │ │ │ │ │ +00007a90: 2020 206f 7220 6173 2061 6e20 6172 6775 or as an argu │ │ │ │ │ +00007aa0: 6d65 6e74 206f 6620 2741 4d5f 494e 4954 ment of 'AM_INIT │ │ │ │ │ +00007ab0: 5f41 5554 4f4d 414b 4527 2069 6e20 2763 _AUTOMAKE' in 'c │ │ │ │ │ +00007ac0: 6f6e 6669 6775 7265 2e61 6327 2c20 6974 onfigure.ac', it │ │ │ │ │ +00007ad0: 2077 696c 6c0a 2020 2020 2062 6520 6967 will. be ig │ │ │ │ │ +00007ae0: 6e6f 7265 6420 6f74 6865 7277 6973 652e nored otherwise. │ │ │ │ │ +00007af0: 2020 4974 2077 696c 6c20 616c 736f 2062 It will also b │ │ │ │ │ +00007b00: 6520 6967 6e6f 7265 6420 696e 2073 7562 e ignored in sub │ │ │ │ │ +00007b10: 2d70 6163 6b61 6765 7320 6f66 0a20 2020 -packages of. │ │ │ │ │ +00007b20: 2020 6e65 7374 6564 2070 6163 6b61 6765 nested package │ │ │ │ │ +00007b30: 7320 282a 6e6f 7465 2053 7562 7061 636b s (*note Subpack │ │ │ │ │ +00007b40: 6167 6573 3a3a 292e 0a0a 276e 6f2d 6465 ages::)...'no-de │ │ │ │ │ +00007b50: 6669 6e65 270a 2020 2020 2054 6869 7320 fine'. This │ │ │ │ │ +00007b60: 6f70 7469 6f6e 2069 7320 6d65 616e 696e option is meanin │ │ │ │ │ +00007b70: 6766 756c 206f 6e6c 7920 7768 656e 2070 gful only when p │ │ │ │ │ +00007b80: 6173 7365 6420 6173 2061 6e20 6172 6775 assed as an argu │ │ │ │ │ +00007b90: 6d65 6e74 2074 6f0a 2020 2020 2027 414d ment to. 'AM │ │ │ │ │ +00007ba0: 5f49 4e49 545f 4155 544f 4d41 4b45 272e _INIT_AUTOMAKE'. │ │ │ │ │ +00007bb0: 2020 4974 2077 696c 6c20 7072 6576 656e It will preven │ │ │ │ │ +00007bc0: 7420 7468 6520 2750 4143 4b41 4745 2720 t the 'PACKAGE' │ │ │ │ │ +00007bd0: 616e 6420 2756 4552 5349 4f4e 270a 2020 and 'VERSION'. │ │ │ │ │ +00007be0: 2020 2076 6172 6961 626c 6573 2066 726f variables fro │ │ │ │ │ +00007bf0: 6d20 6265 696e 6720 2741 435f 4445 4649 m being 'AC_DEFI │ │ │ │ │ +00007c00: 4e45 2764 2e0a 0a27 6e6f 2d64 6570 656e NE'd...'no-depen │ │ │ │ │ +00007c10: 6465 6e63 6965 7327 0a20 2020 2020 5468 dencies'. Th │ │ │ │ │ +00007c20: 6973 2069 7320 7369 6d69 6c61 7220 746f is is similar to │ │ │ │ │ +00007c30: 2075 7369 6e67 2027 2d2d 6967 6e6f 7265 using '--ignore │ │ │ │ │ +00007c40: 2d64 6570 7327 206f 6e20 7468 6520 636f -deps' on the co │ │ │ │ │ +00007c50: 6d6d 616e 6420 6c69 6e65 2c20 6275 740a mmand line, but. │ │ │ │ │ +00007c60: 2020 2020 2069 7320 7573 6566 756c 2066 is useful f │ │ │ │ │ +00007c70: 6f72 2074 686f 7365 2073 6974 7561 7469 or those situati │ │ │ │ │ +00007c80: 6f6e 7320 7768 6572 6520 796f 7520 646f ons where you do │ │ │ │ │ +00007c90: 6e27 7420 6861 7665 2074 6865 206e 6563 n't have the nec │ │ │ │ │ +00007ca0: 6573 7361 7279 0a20 2020 2020 6269 7473 essary. bits │ │ │ │ │ +00007cb0: 2074 6f20 6d61 6b65 2061 7574 6f6d 6174 to make automat │ │ │ │ │ +00007cc0: 6963 2064 6570 656e 6465 6e63 7920 7472 ic dependency tr │ │ │ │ │ +00007cd0: 6163 6b69 6e67 2077 6f72 6b20 282a 6e6f acking work (*no │ │ │ │ │ +00007ce0: 7465 0a20 2020 2020 4465 7065 6e64 656e te. Dependen │ │ │ │ │ +00007cf0: 6369 6573 3a3a 292e 2020 496e 2074 6869 cies::). In thi │ │ │ │ │ +00007d00: 7320 6361 7365 2074 6865 2065 6666 6563 s case the effec │ │ │ │ │ +00007d10: 7420 6973 2074 6f20 6566 6665 6374 6976 t is to effectiv │ │ │ │ │ +00007d20: 656c 7920 6469 7361 626c 650a 2020 2020 ely disable. │ │ │ │ │ +00007d30: 2061 7574 6f6d 6174 6963 2064 6570 656e automatic depen │ │ │ │ │ +00007d40: 6465 6e63 7920 7472 6163 6b69 6e67 2e0a dency tracking.. │ │ │ │ │ +00007d50: 0a27 6e6f 2d64 6973 7427 0a20 2020 2020 .'no-dist'. │ │ │ │ │ +00007d60: 446f 6e27 7420 656d 6974 2061 6e79 2063 Don't emit any c │ │ │ │ │ +00007d70: 6f64 6520 7265 6c61 7465 6420 746f 2027 ode related to ' │ │ │ │ │ +00007d80: 6469 7374 2720 7461 7267 6574 2e20 2054 dist' target. T │ │ │ │ │ +00007d90: 6869 7320 6973 2075 7365 6675 6c20 7768 his is useful wh │ │ │ │ │ +00007da0: 656e 0a20 2020 2020 6120 7061 636b 6167 en. a packag │ │ │ │ │ +00007db0: 6520 6861 7320 6974 7320 6f77 6e20 6d65 e has its own me │ │ │ │ │ +00007dc0: 7468 6f64 2066 6f72 206d 616b 696e 6720 thod for making │ │ │ │ │ +00007dd0: 6469 7374 7269 6275 7469 6f6e 732e 0a0a distributions... │ │ │ │ │ +00007de0: 276e 6f2d 6469 7374 2d67 7a69 7027 0a20 'no-dist-gzip'. │ │ │ │ │ +00007df0: 2020 2020 446f 206e 6f74 2068 6f6f 6b20 Do not hook │ │ │ │ │ +00007e00: 2764 6973 742d 677a 6970 2720 746f 2027 'dist-gzip' to ' │ │ │ │ │ +00007e10: 6469 7374 272e 0a0a 276e 6f2d 6578 6565 dist'...'no-exee │ │ │ │ │ +00007e20: 7874 270a 2020 2020 2049 6620 796f 7572 xt'. If your │ │ │ │ │ +00007e30: 2027 4d61 6b65 6669 6c65 2e61 6d27 2064 'Makefile.am' d │ │ │ │ │ +00007e40: 6566 696e 6573 2061 2072 756c 6520 666f efines a rule fo │ │ │ │ │ +00007e50: 7220 7461 7267 6574 2027 666f 6f27 2c20 r target 'foo', │ │ │ │ │ +00007e60: 6974 2077 696c 6c0a 2020 2020 206f 7665 it will. ove │ │ │ │ │ +00007e70: 7272 6964 6520 6120 7275 6c65 2066 6f72 rride a rule for │ │ │ │ │ +00007e80: 2061 2074 6172 6765 7420 6e61 6d65 6420 a target named │ │ │ │ │ +00007e90: 2766 6f6f 2428 4558 4545 5854 2927 2e20 'foo$(EXEEXT)'. │ │ │ │ │ +00007ea0: 2054 6869 7320 6973 0a20 2020 2020 6e65 This is. ne │ │ │ │ │ +00007eb0: 6365 7373 6172 7920 7768 656e 2027 4558 cessary when 'EX │ │ │ │ │ +00007ec0: 4545 5854 2720 6973 2066 6f75 6e64 2074 EEXT' is found t │ │ │ │ │ +00007ed0: 6f20 6265 2065 6d70 7479 2e20 2048 6f77 o be empty. How │ │ │ │ │ +00007ee0: 6576 6572 2c20 6279 2064 6566 6175 6c74 ever, by default │ │ │ │ │ +00007ef0: 0a20 2020 2020 2761 7574 6f6d 616b 6527 . 'automake' │ │ │ │ │ +00007f00: 2077 696c 6c20 6765 6e65 7261 7465 2061 will generate a │ │ │ │ │ +00007f10: 6e20 6572 726f 7220 666f 7220 7468 6973 n error for this │ │ │ │ │ +00007f20: 2075 7365 2e20 2054 6865 2027 6e6f 2d65 use. The 'no-e │ │ │ │ │ +00007f30: 7865 6578 7427 0a20 2020 2020 6f70 7469 xeext'. opti │ │ │ │ │ +00007f40: 6f6e 2077 696c 6c20 6469 7361 626c 6520 on will disable │ │ │ │ │ +00007f50: 7468 6973 2065 7272 6f72 2e20 2054 6869 this error. Thi │ │ │ │ │ +00007f60: 7320 6973 2069 6e74 656e 6465 6420 666f s is intended fo │ │ │ │ │ +00007f70: 7220 7573 6520 6f6e 6c79 0a20 2020 2020 r use only. │ │ │ │ │ +00007f80: 7768 6572 6520 6974 2069 7320 6b6e 6f77 where it is know │ │ │ │ │ +00007f90: 6e20 696e 2061 6476 616e 6365 2074 6861 n in advance tha │ │ │ │ │ +00007fa0: 7420 7468 6520 7061 636b 6167 6520 7769 t the package wi │ │ │ │ │ +00007fb0: 6c6c 206e 6f74 2062 6520 706f 7274 6564 ll not be ported │ │ │ │ │ +00007fc0: 2074 6f0a 2020 2020 2057 696e 646f 7773 to. Windows │ │ │ │ │ +00007fd0: 2c20 6f72 2061 6e79 206f 7468 6572 206f , or any other o │ │ │ │ │ +00007fe0: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ │ +00007ff0: 7573 696e 6720 6578 7465 6e73 696f 6e73 using extensions │ │ │ │ │ +00008000: 206f 6e0a 2020 2020 2065 7865 6375 7461 on. executa │ │ │ │ │ +00008010: 626c 6573 2e0a 0a27 6e6f 2d69 6e73 7461 bles...'no-insta │ │ │ │ │ +00008020: 6c6c 696e 666f 270a 2020 2020 2054 6865 llinfo'. The │ │ │ │ │ +00008030: 2067 656e 6572 6174 6564 2027 4d61 6b65 generated 'Make │ │ │ │ │ +00008040: 6669 6c65 2e69 6e27 2077 696c 6c20 6e6f file.in' will no │ │ │ │ │ +00008050: 7420 6361 7573 6520 696e 666f 2070 6167 t cause info pag │ │ │ │ │ +00008060: 6573 2074 6f20 6265 2062 7569 6c74 0a20 es to be built. │ │ │ │ │ +00008070: 2020 2020 6f72 2069 6e73 7461 6c6c 6564 or installed │ │ │ │ │ +00008080: 2062 7920 6465 6661 756c 742e 2020 486f by default. Ho │ │ │ │ │ +00008090: 7765 7665 722c 2027 696e 666f 2720 616e wever, 'info' an │ │ │ │ │ +000080a0: 6420 2769 6e73 7461 6c6c 2d69 6e66 6f27 d 'install-info' │ │ │ │ │ +000080b0: 0a20 2020 2020 7461 7267 6574 7320 7769 . targets wi │ │ │ │ │ +000080c0: 6c6c 2073 7469 6c6c 2062 6520 6176 6169 ll still be avai │ │ │ │ │ +000080d0: 6c61 626c 652e 2020 5468 6973 206f 7074 lable. This opt │ │ │ │ │ +000080e0: 696f 6e20 6973 2064 6973 616c 6c6f 7765 ion is disallowe │ │ │ │ │ +000080f0: 6420 6174 0a20 2020 2020 2767 6e75 2720 d at. 'gnu' │ │ │ │ │ +00008100: 7374 7269 6374 6e65 7373 2061 6e64 2061 strictness and a │ │ │ │ │ +00008110: 626f 7665 2e0a 0a27 6e6f 2d69 6e73 7461 bove...'no-insta │ │ │ │ │ +00008120: 6c6c 6d61 6e27 0a20 2020 2020 5468 6520 llman'. The │ │ │ │ │ +00008130: 6765 6e65 7261 7465 6420 274d 616b 6566 generated 'Makef │ │ │ │ │ +00008140: 696c 652e 696e 2720 7769 6c6c 206e 6f74 ile.in' will not │ │ │ │ │ +00008150: 2063 6175 7365 206d 616e 2070 6167 6573 cause man pages │ │ │ │ │ +00008160: 2074 6f20 6265 0a20 2020 2020 696e 7374 to be. inst │ │ │ │ │ +00008170: 616c 6c65 6420 6279 2064 6566 6175 6c74 alled by default │ │ │ │ │ +00008180: 2e20 2048 6f77 6576 6572 2c20 616e 2027 . However, an ' │ │ │ │ │ +00008190: 696e 7374 616c 6c2d 6d61 6e27 2074 6172 install-man' tar │ │ │ │ │ +000081a0: 6765 7420 7769 6c6c 2073 7469 6c6c 0a20 get will still. │ │ │ │ │ +000081b0: 2020 2020 6265 2061 7661 696c 6162 6c65 be available │ │ │ │ │ +000081c0: 2066 6f72 206f 7074 696f 6e61 6c20 696e for optional in │ │ │ │ │ +000081d0: 7374 616c 6c61 7469 6f6e 2e20 2054 6869 stallation. Thi │ │ │ │ │ +000081e0: 7320 6f70 7469 6f6e 2069 7320 6469 7361 s option is disa │ │ │ │ │ +000081f0: 6c6c 6f77 6564 0a20 2020 2020 6174 2027 llowed. at ' │ │ │ │ │ +00008200: 676e 7527 2073 7472 6963 746e 6573 7320 gnu' strictness │ │ │ │ │ +00008210: 616e 6420 6162 6f76 652e 0a0a 276e 6f73 and above...'nos │ │ │ │ │ +00008220: 7464 696e 6327 0a20 2020 2020 5468 6973 tdinc'. This │ │ │ │ │ +00008230: 206f 7074 696f 6e20 6361 6e20 6265 2075 option can be u │ │ │ │ │ +00008240: 7365 6420 746f 2064 6973 6162 6c65 2074 sed to disable t │ │ │ │ │ +00008250: 6865 2073 7461 6e64 6172 6420 272d 4927 he standard '-I' │ │ │ │ │ +00008260: 206f 7074 696f 6e73 2074 6861 740a 2020 options that. │ │ │ │ │ +00008270: 2020 2061 7265 206f 7264 696e 6172 696c are ordinaril │ │ │ │ │ +00008280: 7920 6175 746f 6d61 7469 6361 6c6c 7920 y automatically │ │ │ │ │ +00008290: 7072 6f76 6964 6564 2062 7920 4175 746f provided by Auto │ │ │ │ │ +000082a0: 6d61 6b65 2e0a 0a27 6e6f 2d74 6578 696e make...'no-texin │ │ │ │ │ +000082b0: 666f 2e74 6578 270a 2020 2020 2044 6f6e fo.tex'. Don │ │ │ │ │ +000082c0: 2774 2072 6571 7569 7265 2027 7465 7869 't require 'texi │ │ │ │ │ +000082d0: 6e66 6f2e 7465 7827 2c20 6576 656e 2069 nfo.tex', even i │ │ │ │ │ +000082e0: 6620 7468 6572 6520 6172 6520 7465 7869 f there are texi │ │ │ │ │ +000082f0: 6e66 6f20 6669 6c65 7320 696e 0a20 2020 nfo files in. │ │ │ │ │ +00008300: 2020 7468 6973 2064 6972 6563 746f 7279 this directory │ │ │ │ │ +00008310: 2e0a 0a27 7061 7261 6c6c 656c 2d74 6573 ...'parallel-tes │ │ │ │ │ +00008320: 7473 270a 2020 2020 2045 6e61 626c 6520 ts'. Enable │ │ │ │ │ +00008330: 7465 7374 2073 7569 7465 2064 7269 7665 test suite drive │ │ │ │ │ +00008340: 7220 666f 7220 2754 4553 5453 2720 7468 r for 'TESTS' th │ │ │ │ │ +00008350: 6174 2063 616e 2072 756e 2074 6573 7473 at can run tests │ │ │ │ │ +00008360: 2069 6e20 7061 7261 6c6c 656c 0a20 2020 in parallel. │ │ │ │ │ +00008370: 2020 282a 6e6f 7465 2053 696d 706c 6520 (*note Simple │ │ │ │ │ +00008380: 5465 7374 7320 7573 696e 6720 7061 7261 Tests using para │ │ │ │ │ +00008390: 6c6c 656c 2d74 6573 7473 3a3a 2c20 666f llel-tests::, fo │ │ │ │ │ +000083a0: 7220 6d6f 7265 2069 6e66 6f72 6d61 7469 r more informati │ │ │ │ │ +000083b0: 6f6e 292e 0a0a 2772 6561 646d 652d 616c on)...'readme-al │ │ │ │ │ +000083c0: 7068 6127 0a20 2020 2020 4966 2074 6869 pha'. If thi │ │ │ │ │ +000083d0: 7320 7265 6c65 6173 6520 6973 2061 6e20 s release is an │ │ │ │ │ +000083e0: 616c 7068 6120 7265 6c65 6173 652c 2061 alpha release, a │ │ │ │ │ +000083f0: 6e64 2074 6865 2066 696c 6520 2752 4541 nd the file 'REA │ │ │ │ │ +00008400: 444d 452d 616c 7068 6127 0a20 2020 2020 DME-alpha'. │ │ │ │ │ +00008410: 6578 6973 7473 2c20 7468 656e 2069 7420 exists, then it │ │ │ │ │ +00008420: 7769 6c6c 2062 6520 6164 6465 6420 746f will be added to │ │ │ │ │ +00008430: 2074 6865 2064 6973 7472 6962 7574 696f the distributio │ │ │ │ │ +00008440: 6e2e 2020 4966 2074 6869 7320 6f70 7469 n. If this opti │ │ │ │ │ +00008450: 6f6e 0a20 2020 2020 6973 2067 6976 656e on. is given │ │ │ │ │ +00008460: 2c20 7665 7273 696f 6e20 6e75 6d62 6572 , version number │ │ │ │ │ +00008470: 7320 6172 6520 6578 7065 6374 6564 2074 s are expected t │ │ │ │ │ +00008480: 6f20 666f 6c6c 6f77 206f 6e65 206f 6620 o follow one of │ │ │ │ │ +00008490: 7477 6f20 666f 726d 732e 0a20 2020 2020 two forms.. │ │ │ │ │ +000084a0: 5468 6520 6669 7273 7420 666f 726d 2069 The first form i │ │ │ │ │ +000084b0: 7320 274d 414a 4f52 2e4d 494e 4f52 2e41 s 'MAJOR.MINOR.A │ │ │ │ │ +000084c0: 4c50 4841 272c 2077 6865 7265 2065 6163 LPHA', where eac │ │ │ │ │ +000084d0: 6820 656c 656d 656e 7420 6973 2061 0a20 h element is a. │ │ │ │ │ +000084e0: 2020 2020 6e75 6d62 6572 3b20 7468 6520 number; the │ │ │ │ │ +000084f0: 6669 6e61 6c20 7065 7269 6f64 2061 6e64 final period and │ │ │ │ │ +00008500: 206e 756d 6265 7220 7368 6f75 6c64 2062 number should b │ │ │ │ │ +00008510: 6520 6c65 6674 206f 6666 2066 6f72 0a20 e left off for. │ │ │ │ │ +00008520: 2020 2020 6e6f 6e2d 616c 7068 6120 7265 non-alpha re │ │ │ │ │ +00008530: 6c65 6173 6573 2e20 2054 6865 2073 6563 leases. The sec │ │ │ │ │ +00008540: 6f6e 6420 666f 726d 2069 7320 274d 414a ond form is 'MAJ │ │ │ │ │ +00008550: 4f52 2e4d 494e 4f52 414c 5048 4127 2c20 OR.MINORALPHA', │ │ │ │ │ +00008560: 7768 6572 650a 2020 2020 2041 4c50 4841 where. ALPHA │ │ │ │ │ +00008570: 2069 7320 6120 6c65 7474 6572 3b20 6974 is a letter; it │ │ │ │ │ +00008580: 2073 686f 756c 6420 6265 206f 6d69 7474 should be omitt │ │ │ │ │ +00008590: 6564 2066 6f72 206e 6f6e 2d61 6c70 6861 ed for non-alpha │ │ │ │ │ +000085a0: 2072 656c 6561 7365 732e 0a0a 2773 696c releases...'sil │ │ │ │ │ +000085b0: 656e 742d 7275 6c65 7327 0a20 2020 2020 ent-rules'. │ │ │ │ │ +000085c0: 456e 6162 6c65 206c 6573 7320 7665 7262 Enable less verb │ │ │ │ │ +000085d0: 6f73 6520 6275 696c 6420 7275 6c65 732e ose build rules. │ │ │ │ │ +000085e0: 2020 5468 6973 2063 616e 2062 6520 7573 This can be us │ │ │ │ │ +000085f0: 6564 2074 6f20 6c65 7420 6275 696c 640a ed to let build. │ │ │ │ │ +00008600: 2020 2020 2072 756c 6573 206f 7574 7075 rules outpu │ │ │ │ │ +00008610: 7420 7374 6174 7573 206c 696e 6573 206f t status lines o │ │ │ │ │ +00008620: 6620 7468 6520 666f 726d 3a0a 2020 2020 f the form:. │ │ │ │ │ +00008630: 2020 2020 2020 4745 4e20 4f55 5450 5554 GEN OUTPUT │ │ │ │ │ +00008640: 2d46 494c 450a 2020 2020 2020 2020 2020 -FILE. │ │ │ │ │ +00008650: 2043 4320 4f42 4a45 4354 2d46 494c 450a CC OBJECT-FILE. │ │ │ │ │ +00008660: 2020 2020 2069 6e73 7465 6164 206f 6620 instead of │ │ │ │ │ +00008670: 7072 696e 7469 6e67 2074 6865 2063 6f6d printing the com │ │ │ │ │ +00008680: 6d61 6e64 2074 6861 7420 7769 6c6c 2062 mand that will b │ │ │ │ │ +00008690: 6520 6578 6563 7574 6564 2074 6f20 7570 e executed to up │ │ │ │ │ +000086a0: 6461 7465 0a20 2020 2020 4f55 5450 5554 date. OUTPUT │ │ │ │ │ +000086b0: 2d46 494c 4520 6f72 2074 6f20 636f 6d70 -FILE or to comp │ │ │ │ │ +000086c0: 696c 6520 4f42 4a45 4354 2d46 494c 452e ile OBJECT-FILE. │ │ │ │ │ +000086d0: 2020 4974 2063 616e 2061 6c73 6f20 7369 It can also si │ │ │ │ │ +000086e0: 6c65 6e63 650a 2020 2020 2027 6c69 6274 lence. 'libt │ │ │ │ │ +000086f0: 6f6f 6c27 206f 7574 7075 742e 0a0a 2020 ool' output... │ │ │ │ │ +00008700: 2020 2046 6f72 206d 6f72 6520 696e 666f For more info │ │ │ │ │ +00008710: 726d 6174 696f 6e20 6162 6f75 7420 686f rmation about ho │ │ │ │ │ +00008720: 7720 746f 2075 7365 2c20 656e 6162 6c65 w to use, enable │ │ │ │ │ +00008730: 2c20 6f72 2064 6973 6162 6c65 2073 696c , or disable sil │ │ │ │ │ +00008740: 656e 740a 2020 2020 2072 756c 6573 2c20 ent. rules, │ │ │ │ │ +00008750: 2a6e 6f74 6520 4175 746f 6d61 6b65 2073 *note Automake s │ │ │ │ │ +00008760: 696c 656e 742d 7275 6c65 7320 4f70 7469 ilent-rules Opti │ │ │ │ │ +00008770: 6f6e 3a3a 2e0a 0a27 7374 642d 6f70 7469 on::...'std-opti │ │ │ │ │ +00008780: 6f6e 7327 0a0a 2020 2020 204d 616b 6520 ons'.. Make │ │ │ │ │ +00008790: 7468 6520 2769 6e73 7461 6c6c 6368 6563 the 'installchec │ │ │ │ │ +000087a0: 6b27 2072 756c 6520 6368 6563 6b20 7468 k' rule check th │ │ │ │ │ +000087b0: 6174 2069 6e73 7461 6c6c 6564 2073 6372 at installed scr │ │ │ │ │ +000087c0: 6970 7473 2061 6e64 0a20 2020 2020 7072 ipts and. pr │ │ │ │ │ +000087d0: 6f67 7261 6d73 2073 7570 706f 7274 2074 ograms support t │ │ │ │ │ +000087e0: 6865 2027 2d2d 6865 6c70 2720 616e 6420 he '--help' and │ │ │ │ │ +000087f0: 272d 2d76 6572 7369 6f6e 2720 6f70 7469 '--version' opti │ │ │ │ │ +00008800: 6f6e 732e 2020 5468 6973 2061 6c73 6f0a ons. This also. │ │ │ │ │ +00008810: 2020 2020 2070 726f 7669 6465 7320 6120 provides a │ │ │ │ │ +00008820: 6261 7369 6320 6368 6563 6b20 7468 6174 basic check that │ │ │ │ │ +00008830: 2074 6865 2070 726f 6772 616d 2773 2072 the program's r │ │ │ │ │ +00008840: 756e 2d74 696d 6520 6465 7065 6e64 656e un-time dependen │ │ │ │ │ +00008850: 6369 6573 2061 7265 0a20 2020 2020 7361 cies are. sa │ │ │ │ │ +00008860: 7469 7366 6965 6420 6166 7465 7220 696e tisfied after in │ │ │ │ │ +00008870: 7374 616c 6c61 7469 6f6e 2e0a 0a20 2020 stallation... │ │ │ │ │ +00008880: 2020 496e 2061 2066 6577 2073 6974 7561 In a few situa │ │ │ │ │ +00008890: 7469 6f6e 732c 2070 726f 6772 616d 7320 tions, programs │ │ │ │ │ +000088a0: 286f 7220 7363 7269 7074 7329 2068 6176 (or scripts) hav │ │ │ │ │ +000088b0: 6520 746f 2062 6520 6578 656d 7074 6564 e to be exempted │ │ │ │ │ +000088c0: 2066 726f 6d0a 2020 2020 2074 6869 7320 from. this │ │ │ │ │ +000088d0: 7465 7374 2e20 2046 6f72 2069 6e73 7461 test. For insta │ │ │ │ │ +000088e0: 6e63 652c 2027 6661 6c73 6527 2028 6672 nce, 'false' (fr │ │ │ │ │ +000088f0: 6f6d 2047 4e55 2063 6f72 6575 7469 6c73 om GNU coreutils │ │ │ │ │ +00008900: 2920 6973 206e 6576 6572 0a20 2020 2020 ) is never. │ │ │ │ │ +00008910: 7375 6363 6573 7366 756c 2c20 6576 656e successful, even │ │ │ │ │ +00008920: 2066 6f72 2027 2d2d 6865 6c70 2720 6f72 for '--help' or │ │ │ │ │ +00008930: 2027 2d2d 7665 7273 696f 6e27 2e20 2059 '--version'. Y │ │ │ │ │ +00008940: 6f75 2063 616e 206c 6973 7420 7375 6368 ou can list such │ │ │ │ │ +00008950: 0a20 2020 2020 7072 6f67 7261 6d73 2069 . programs i │ │ │ │ │ +00008960: 6e20 7468 6520 7661 7269 6162 6c65 2027 n the variable ' │ │ │ │ │ +00008970: 414d 5f49 4e53 5441 4c4c 4348 4543 4b5f AM_INSTALLCHECK_ │ │ │ │ │ +00008980: 5354 445f 4f50 5449 4f4e 535f 4558 454d STD_OPTIONS_EXEM │ │ │ │ │ +00008990: 5054 272e 0a20 2020 2020 5072 6f67 7261 PT'.. Progra │ │ │ │ │ +000089a0: 6d73 2028 6e6f 7420 7363 7269 7074 7329 ms (not scripts) │ │ │ │ │ +000089b0: 206c 6973 7465 6420 696e 2074 6869 7320 listed in this │ │ │ │ │ +000089c0: 7661 7269 6162 6c65 2073 686f 756c 6420 variable should │ │ │ │ │ +000089d0: 6265 2073 7566 6669 7865 640a 2020 2020 be suffixed. │ │ │ │ │ +000089e0: 2062 7920 2724 2845 5845 4558 5429 2720 by '$(EXEEXT)' │ │ │ │ │ +000089f0: 666f 7220 7468 6520 7361 6b65 206f 6620 for the sake of │ │ │ │ │ +00008a00: 5769 6e33 3220 6f72 204f 532f 322e 2020 Win32 or OS/2. │ │ │ │ │ +00008a10: 466f 7220 696e 7374 616e 6365 2c0a 2020 For instance,. │ │ │ │ │ +00008a20: 2020 2073 7570 706f 7365 2077 6520 6275 suppose we bu │ │ │ │ │ +00008a30: 696c 6420 2766 616c 7365 2720 6173 2061 ild 'false' as a │ │ │ │ │ +00008a40: 2070 726f 6772 616d 2062 7574 2027 7472 program but 'tr │ │ │ │ │ +00008a50: 7565 2e73 6827 2061 7320 6120 7363 7269 ue.sh' as a scri │ │ │ │ │ +00008a60: 7074 2c0a 2020 2020 2061 6e64 2074 6861 pt,. and tha │ │ │ │ │ +00008a70: 7420 6e65 6974 6865 7220 6f66 2074 6865 t neither of the │ │ │ │ │ +00008a80: 6d20 7375 7070 6f72 7420 272d 2d68 656c m support '--hel │ │ │ │ │ +00008a90: 7027 206f 7220 272d 2d76 6572 7369 6f6e p' or '--version │ │ │ │ │ +00008aa0: 273a 0a0a 2020 2020 2020 2020 2020 4155 ':.. AU │ │ │ │ │ +00008ab0: 544f 4d41 4b45 5f4f 5054 494f 4e53 203d TOMAKE_OPTIONS = │ │ │ │ │ +00008ac0: 2073 7464 2d6f 7074 696f 6e73 0a20 2020 std-options. │ │ │ │ │ +00008ad0: 2020 2020 2020 2062 696e 5f50 524f 4752 bin_PROGR │ │ │ │ │ +00008ae0: 414d 5320 3d20 6661 6c73 6520 2e2e 2e0a AMS = false .... │ │ │ │ │ +00008af0: 2020 2020 2020 2020 2020 6269 6e5f 5343 bin_SC │ │ │ │ │ +00008b00: 5249 5054 5320 3d20 7472 7565 2e73 6820 RIPTS = true.sh │ │ │ │ │ +00008b10: 2e2e 2e0a 2020 2020 2020 2020 2020 414d .... AM │ │ │ │ │ +00008b20: 5f49 4e53 5441 4c4c 4348 4543 4b5f 5354 _INSTALLCHECK_ST │ │ │ │ │ +00008b30: 445f 4f50 5449 4f4e 535f 4558 454d 5054 D_OPTIONS_EXEMPT │ │ │ │ │ +00008b40: 203d 2066 616c 7365 2428 4558 4545 5854 = false$(EXEEXT │ │ │ │ │ +00008b50: 2920 7472 7565 2e73 680a 0a27 7375 6264 ) true.sh..'subd │ │ │ │ │ +00008b60: 6972 2d6f 626a 6563 7473 270a 2020 2020 ir-objects'. │ │ │ │ │ +00008b70: 2049 6620 7468 6973 206f 7074 696f 6e20 If this option │ │ │ │ │ +00008b80: 6973 2073 7065 6369 6669 6564 2c20 7468 is specified, th │ │ │ │ │ +00008b90: 656e 206f 626a 6563 7473 2061 7265 2070 en objects are p │ │ │ │ │ +00008ba0: 6c61 6365 6420 696e 746f 2074 6865 0a20 laced into the. │ │ │ │ │ +00008bb0: 2020 2020 7375 6264 6972 6563 746f 7279 subdirectory │ │ │ │ │ +00008bc0: 206f 6620 7468 6520 6275 696c 6420 6469 of the build di │ │ │ │ │ +00008bd0: 7265 6374 6f72 7920 636f 7272 6573 706f rectory correspo │ │ │ │ │ +00008be0: 6e64 696e 6720 746f 2074 6865 0a20 2020 nding to the. │ │ │ │ │ +00008bf0: 2020 7375 6264 6972 6563 746f 7279 206f subdirectory o │ │ │ │ │ +00008c00: 6620 7468 6520 736f 7572 6365 2066 696c f the source fil │ │ │ │ │ +00008c10: 652e 2020 466f 7220 696e 7374 616e 6365 e. For instance │ │ │ │ │ +00008c20: 2c20 6966 2074 6865 2073 6f75 7263 6520 , if the source │ │ │ │ │ +00008c30: 6669 6c65 0a20 2020 2020 6973 2027 7375 file. is 'su │ │ │ │ │ +00008c40: 6264 6972 2f66 696c 652e 6378 7827 2c20 bdir/file.cxx', │ │ │ │ │ +00008c50: 7468 656e 2074 6865 206f 7574 7075 7420 then the output │ │ │ │ │ +00008c60: 6669 6c65 2077 6f75 6c64 2062 650a 2020 file would be. │ │ │ │ │ +00008c70: 2020 2027 7375 6264 6972 2f66 696c 652e 'subdir/file. │ │ │ │ │ +00008c80: 6f27 2e0a 0a20 2020 2020 496e 206f 7264 o'... In ord │ │ │ │ │ +00008c90: 6572 2074 6f20 7573 6520 7468 6973 206f er to use this o │ │ │ │ │ +00008ca0: 7074 696f 6e20 7769 7468 2043 2073 6f75 ption with C sou │ │ │ │ │ +00008cb0: 7263 6573 2c20 796f 7520 7368 6f75 6c64 rces, you should │ │ │ │ │ +00008cc0: 2061 6464 0a20 2020 2020 2741 4d5f 5052 add. 'AM_PR │ │ │ │ │ +00008cd0: 4f47 5f43 435f 435f 4f27 2074 6f20 2763 OG_CC_C_O' to 'c │ │ │ │ │ +00008ce0: 6f6e 6669 6775 7265 2e61 6327 2e0a 0a27 onfigure.ac'...' │ │ │ │ │ +00008cf0: 7461 722d 7637 270a 2774 6172 2d75 7374 tar-v7'.'tar-ust │ │ │ │ │ +00008d00: 6172 270a 2774 6172 2d70 6178 270a 0a20 ar'.'tar-pax'.. │ │ │ │ │ +00008d10: 2020 2020 5468 6573 6520 7468 7265 6520 These three │ │ │ │ │ +00008d20: 6d75 7475 616c 6c79 2065 7863 6c75 7369 mutually exclusi │ │ │ │ │ +00008d30: 7665 206f 7074 696f 6e73 2073 656c 6563 ve options selec │ │ │ │ │ +00008d40: 7420 7468 6520 7461 7220 666f 726d 6174 t the tar format │ │ │ │ │ +00008d50: 2074 6f20 7573 650a 2020 2020 2077 6865 to use. whe │ │ │ │ │ +00008d60: 6e20 6765 6e65 7261 7469 6e67 2074 6172 n generating tar │ │ │ │ │ +00008d70: 6261 6c6c 7320 7769 7468 2027 6d61 6b65 balls with 'make │ │ │ │ │ +00008d80: 2064 6973 7427 2e20 2028 5468 6520 7461 dist'. (The ta │ │ │ │ │ +00008d90: 7220 6669 6c65 2063 7265 6174 6564 0a20 r file created. │ │ │ │ │ +00008da0: 2020 2020 6973 2074 6865 6e20 636f 6d70 is then comp │ │ │ │ │ +00008db0: 7265 7373 6564 2061 6363 6f72 6469 6e67 ressed according │ │ │ │ │ +00008dc0: 2074 6f20 7468 6520 7365 7420 6f66 2027 to the set of ' │ │ │ │ │ +00008dd0: 6e6f 2d64 6973 742d 677a 6970 272c 0a20 no-dist-gzip',. │ │ │ │ │ +00008de0: 2020 2020 2764 6973 742d 627a 6970 3227 'dist-bzip2' │ │ │ │ │ +00008df0: 2c20 2764 6973 742d 6c7a 6970 272c 2027 , 'dist-lzip', ' │ │ │ │ │ +00008e00: 6469 7374 2d78 7a27 2061 6e64 2027 6469 dist-xz' and 'di │ │ │ │ │ +00008e10: 7374 2d74 6172 5a27 206f 7074 696f 6e73 st-tarZ' options │ │ │ │ │ +00008e20: 2069 6e0a 2020 2020 2075 7365 2e29 0a0a in. use.).. │ │ │ │ │ +00008e30: 2020 2020 2054 6865 7365 206f 7074 696f These optio │ │ │ │ │ +00008e40: 6e73 206d 7573 7420 6265 2070 6173 7365 ns must be passe │ │ │ │ │ +00008e50: 6420 6173 2061 7267 756d 656e 7473 2074 d as arguments t │ │ │ │ │ +00008e60: 6f20 2741 4d5f 494e 4954 5f41 5554 4f4d o 'AM_INIT_AUTOM │ │ │ │ │ +00008e70: 414b 4527 0a20 2020 2020 282a 6e6f 7465 AKE'. (*note │ │ │ │ │ +00008e80: 204d 6163 726f 733a 3a29 2062 6563 6175 Macros::) becau │ │ │ │ │ +00008e90: 7365 2074 6865 7920 6361 6e20 7265 7175 se they can requ │ │ │ │ │ +00008ea0: 6972 6520 6164 6469 7469 6f6e 616c 2063 ire additional c │ │ │ │ │ +00008eb0: 6f6e 6669 6775 7265 0a20 2020 2020 6368 onfigure. ch │ │ │ │ │ +00008ec0: 6563 6b73 2e20 2041 7574 6f6d 616b 6520 ecks. Automake │ │ │ │ │ +00008ed0: 7769 6c6c 2063 6f6d 706c 6169 6e20 6966 will complain if │ │ │ │ │ +00008ee0: 2069 7420 7365 6573 2073 7563 6820 6f70 it sees such op │ │ │ │ │ +00008ef0: 7469 6f6e 7320 696e 2061 6e0a 2020 2020 tions in an. │ │ │ │ │ +00008f00: 2027 4155 544f 4d41 4b45 5f4f 5054 494f 'AUTOMAKE_OPTIO │ │ │ │ │ +00008f10: 4e53 2720 7661 7269 6162 6c65 2e0a 0a20 NS' variable... │ │ │ │ │ +00008f20: 2020 2020 2774 6172 2d76 3727 2073 656c 'tar-v7' sel │ │ │ │ │ +00008f30: 6563 7473 2074 6865 206f 6c64 2056 3720 ects the old V7 │ │ │ │ │ +00008f40: 7461 7220 666f 726d 6174 2e20 2054 6869 tar format. Thi │ │ │ │ │ +00008f50: 7320 6973 2074 6865 2068 6973 746f 7269 s is the histori │ │ │ │ │ +00008f60: 6361 6c0a 2020 2020 2064 6566 6175 6c74 cal. default │ │ │ │ │ +00008f70: 2e20 2054 6869 7320 616e 7469 7175 6174 . This antiquat │ │ │ │ │ +00008f80: 6564 2066 6f72 6d61 7420 6973 2075 6e64 ed format is und │ │ │ │ │ +00008f90: 6572 7374 6f6f 6420 6279 2061 6c6c 2074 erstood by all t │ │ │ │ │ +00008fa0: 6172 0a20 2020 2020 696d 706c 656d 656e ar. implemen │ │ │ │ │ +00008fb0: 7461 7469 6f6e 7320 616e 6420 7375 7070 tations and supp │ │ │ │ │ +00008fc0: 6f72 7473 2066 696c 6520 6e61 6d65 7320 orts file names │ │ │ │ │ +00008fd0: 7769 7468 2075 7020 746f 2039 3920 6368 with up to 99 ch │ │ │ │ │ +00008fe0: 6172 6163 7465 7273 2e0a 2020 2020 2057 aracters.. W │ │ │ │ │ +00008ff0: 6865 6e20 6769 7665 6e20 6c6f 6e67 6572 hen given longer │ │ │ │ │ +00009000: 2066 696c 6520 6e61 6d65 7320 736f 6d65 file names some │ │ │ │ │ +00009010: 2074 6172 2069 6d70 6c65 6d65 6e74 6174 tar implementat │ │ │ │ │ +00009020: 696f 6e73 2077 696c 6c20 6469 6167 6e6f ions will diagno │ │ │ │ │ +00009030: 7365 0a20 2020 2020 7468 6520 7072 6f62 se. the prob │ │ │ │ │ +00009040: 6c65 6d20 7768 696c 6520 6f74 6865 7220 lem while other │ │ │ │ │ +00009050: 7769 6c6c 2067 656e 6572 6174 6520 6272 will generate br │ │ │ │ │ +00009060: 6f6b 656e 2074 6172 6261 6c6c 7320 6f72 oken tarballs or │ │ │ │ │ +00009070: 2075 7365 0a20 2020 2020 6e6f 6e2d 706f use. non-po │ │ │ │ │ +00009080: 7274 6162 6c65 2065 7874 656e 7369 6f6e rtable extension │ │ │ │ │ +00009090: 732e 2020 4675 7274 6865 726d 6f72 652c s. Furthermore, │ │ │ │ │ +000090a0: 2074 6865 2056 3720 666f 726d 6174 2063 the V7 format c │ │ │ │ │ +000090b0: 616e 6e6f 7420 7374 6f72 650a 2020 2020 annot store. │ │ │ │ │ +000090c0: 2065 6d70 7479 2064 6972 6563 746f 7269 empty directori │ │ │ │ │ +000090d0: 6573 2e20 2057 6865 6e20 7573 696e 6720 es. When using │ │ │ │ │ +000090e0: 7468 6973 2066 6f72 6d61 742c 2063 6f6e this format, con │ │ │ │ │ +000090f0: 7369 6465 7220 7573 696e 6720 7468 650a sider using the. │ │ │ │ │ +00009100: 2020 2020 2027 6669 6c65 6e61 6d65 2d6c 'filename-l │ │ │ │ │ +00009110: 656e 6774 682d 6d61 783d 3939 2720 6f70 ength-max=99' op │ │ │ │ │ +00009120: 7469 6f6e 2074 6f20 6361 7463 6820 6669 tion to catch fi │ │ │ │ │ +00009130: 6c65 206e 616d 6573 2074 6f6f 206c 6f6e le names too lon │ │ │ │ │ +00009140: 672e 0a0a 2020 2020 2027 7461 722d 7573 g... 'tar-us │ │ │ │ │ +00009150: 7461 7227 2073 656c 6563 7473 2074 6865 tar' selects the │ │ │ │ │ +00009160: 2075 7374 6172 2066 6f72 6d61 7420 6465 ustar format de │ │ │ │ │ +00009170: 6669 6e65 6420 6279 2050 4f53 4958 2031 fined by POSIX 1 │ │ │ │ │ +00009180: 3030 332e 312d 3139 3838 2e0a 2020 2020 003.1-1988.. │ │ │ │ │ +00009190: 2054 6869 7320 666f 726d 6174 2069 7320 This format is │ │ │ │ │ +000091a0: 6265 6c69 6576 6564 2074 6f20 6265 206f believed to be o │ │ │ │ │ +000091b0: 6c64 2065 6e6f 7567 6820 746f 2062 6520 ld enough to be │ │ │ │ │ +000091c0: 706f 7274 6162 6c65 2e20 2049 7420 6675 portable. It fu │ │ │ │ │ +000091d0: 6c6c 790a 2020 2020 2073 7570 706f 7274 lly. support │ │ │ │ │ +000091e0: 7320 656d 7074 7920 6469 7265 6374 6f72 s empty director │ │ │ │ │ +000091f0: 6965 732e 2020 4974 2063 616e 2073 746f ies. It can sto │ │ │ │ │ +00009200: 7265 2066 696c 6520 6e61 6d65 7320 7769 re file names wi │ │ │ │ │ +00009210: 7468 2075 7020 746f 2032 3536 0a20 2020 th up to 256. │ │ │ │ │ +00009220: 2020 6368 6172 6163 7465 7273 2c20 7072 characters, pr │ │ │ │ │ +00009230: 6f76 6964 6564 2074 6861 7420 7468 6520 ovided that the │ │ │ │ │ +00009240: 6669 6c65 206e 616d 6520 6361 6e20 6265 file name can be │ │ │ │ │ +00009250: 2073 706c 6974 2061 7420 6469 7265 6374 split at direct │ │ │ │ │ +00009260: 6f72 790a 2020 2020 2073 6570 6172 6174 ory. separat │ │ │ │ │ +00009270: 6f72 2069 6e20 7477 6f20 7061 7274 732c or in two parts, │ │ │ │ │ +00009280: 2066 6972 7374 206f 6620 7468 656d 2062 first of them b │ │ │ │ │ +00009290: 6569 6e67 2061 7420 6d6f 7374 2031 3535 eing at most 155 │ │ │ │ │ +000092a0: 2062 7974 6573 206c 6f6e 672e 0a20 2020 bytes long.. │ │ │ │ │ +000092b0: 2020 536f 2c20 696e 206d 6f73 7420 6361 So, in most ca │ │ │ │ │ +000092c0: 7365 7320 7468 6520 6d61 7869 6d75 6d20 ses the maximum │ │ │ │ │ +000092d0: 6669 6c65 206e 616d 6520 6c65 6e67 7468 file name length │ │ │ │ │ +000092e0: 2077 696c 6c20 6265 2073 686f 7274 6572 will be shorter │ │ │ │ │ +000092f0: 2074 6861 6e0a 2020 2020 2032 3536 2063 than. 256 c │ │ │ │ │ +00009300: 6861 7261 6374 6572 732e 2020 486f 7765 haracters. Howe │ │ │ │ │ +00009310: 7665 7220 796f 7520 6d61 7920 7275 6e20 ver you may run │ │ │ │ │ +00009320: 6167 6169 6e73 7420 6272 6f6b 656e 2074 against broken t │ │ │ │ │ +00009330: 6172 0a20 2020 2020 696d 706c 656d 656e ar. implemen │ │ │ │ │ +00009340: 7461 7469 6f6e 7320 7468 6174 2069 6e63 tations that inc │ │ │ │ │ +00009350: 6f72 7265 6374 6c79 2068 616e 646c 6520 orrectly handle │ │ │ │ │ +00009360: 6669 6c65 206e 616d 6573 206c 6f6e 6765 file names longe │ │ │ │ │ +00009370: 7220 7468 616e 2039 390a 2020 2020 2063 r than 99. c │ │ │ │ │ +00009380: 6861 7261 6374 6572 7320 2870 6c65 6173 haracters (pleas │ │ │ │ │ +00009390: 6520 7265 706f 7274 2074 6865 6d20 746f e report them to │ │ │ │ │ +000093a0: 203c 6275 672d 6175 746f 6d61 6b65 4067 so we ca │ │ │ │ │ +000093c0: 6e0a 2020 2020 2064 6f63 756d 656e 7420 n. document │ │ │ │ │ +000093d0: 7468 6973 2061 6363 7572 6174 656c 7929 this accurately) │ │ │ │ │ +000093e0: 2e0a 0a20 2020 2020 2774 6172 2d70 6178 ... 'tar-pax │ │ │ │ │ +000093f0: 2720 7365 6c65 6374 7320 7468 6520 6e65 ' selects the ne │ │ │ │ │ +00009400: 7720 7061 7820 696e 7465 7263 6861 6e67 w pax interchang │ │ │ │ │ +00009410: 6520 666f 726d 6174 2064 6566 696e 6564 e format defined │ │ │ │ │ +00009420: 2062 7920 504f 5349 580a 2020 2020 2031 by POSIX. 1 │ │ │ │ │ +00009430: 3030 332e 312d 3230 3031 2e20 2049 7420 003.1-2001. It │ │ │ │ │ +00009440: 646f 6573 206e 6f74 206c 696d 6974 2074 does not limit t │ │ │ │ │ +00009450: 6865 206c 656e 6774 6820 6f66 2066 696c he length of fil │ │ │ │ │ +00009460: 6520 6e61 6d65 732e 2020 486f 7765 7665 e names. Howeve │ │ │ │ │ +00009470: 722c 0a20 2020 2020 7468 6973 2066 6f72 r,. this for │ │ │ │ │ +00009480: 6d61 7420 6973 2076 6572 7920 796f 756e mat is very youn │ │ │ │ │ +00009490: 6720 616e 6420 7368 6f75 6c64 2070 726f g and should pro │ │ │ │ │ +000094a0: 6261 626c 7920 6265 2072 6573 7472 6963 bably be restric │ │ │ │ │ +000094b0: 7465 6420 746f 0a20 2020 2020 7061 636b ted to. pack │ │ │ │ │ +000094c0: 6167 6573 2074 6861 7420 7461 7267 6574 ages that target │ │ │ │ │ +000094d0: 206f 6e6c 7920 7665 7279 206d 6f64 6572 only very moder │ │ │ │ │ +000094e0: 6e20 706c 6174 666f 726d 732e 2020 5468 n platforms. Th │ │ │ │ │ +000094f0: 6572 6520 6172 6520 6d6f 7665 730a 2020 ere are moves. │ │ │ │ │ +00009500: 2020 2074 6f20 6368 616e 6765 2074 6865 to change the │ │ │ │ │ +00009510: 2070 6178 2066 6f72 6d61 7420 696e 2061 pax format in a │ │ │ │ │ +00009520: 6e20 7570 7761 7264 2d63 6f6d 7061 7469 n upward-compati │ │ │ │ │ +00009530: 626c 6520 7761 792c 2073 6f20 7468 6973 ble way, so this │ │ │ │ │ +00009540: 0a20 2020 2020 6f70 7469 6f6e 206d 6179 . option may │ │ │ │ │ +00009550: 2072 6566 6572 2074 6f20 6120 6d6f 7265 refer to a more │ │ │ │ │ +00009560: 2072 6563 656e 7420 7665 7273 696f 6e20 recent version │ │ │ │ │ +00009570: 696e 2074 6865 2066 7574 7572 652e 0a0a in the future... │ │ │ │ │ +00009580: 2020 2020 202a 4e6f 7465 2043 6f6e 7472 *Note Contr │ │ │ │ │ +00009590: 6f6c 6c69 6e67 2074 6865 2041 7263 6869 olling the Archi │ │ │ │ │ +000095a0: 7665 2046 6f72 6d61 743a 2028 7461 7229 ve Format: (tar) │ │ │ │ │ +000095b0: 466f 726d 6174 732c 2066 6f72 2066 7572 Formats, for fur │ │ │ │ │ +000095c0: 7468 6572 0a20 2020 2020 6469 7363 7573 ther. discus │ │ │ │ │ +000095d0: 7369 6f6e 2061 626f 7574 2074 6172 2066 sion about tar f │ │ │ │ │ +000095e0: 6f72 6d61 7473 2e0a 0a20 2020 2020 2763 ormats... 'c │ │ │ │ │ +000095f0: 6f6e 6669 6775 7265 2720 6b6e 6f77 7320 onfigure' knows │ │ │ │ │ +00009600: 7365 7665 7261 6c20 7761 7973 2074 6f20 several ways to │ │ │ │ │ +00009610: 636f 6e73 7472 7563 7420 7468 6573 6520 construct these │ │ │ │ │ +00009620: 666f 726d 6174 732e 2020 4974 2077 696c formats. It wil │ │ │ │ │ +00009630: 6c0a 2020 2020 206e 6f74 2061 626f 7274 l. not abort │ │ │ │ │ +00009640: 2069 6620 6974 2063 616e 6e6f 7420 6669 if it cannot fi │ │ │ │ │ +00009650: 6e64 2061 2074 6f6f 6c20 7570 2074 6f20 nd a tool up to │ │ │ │ │ +00009660: 7468 6520 7461 736b 2028 736f 2074 6861 the task (so tha │ │ │ │ │ +00009670: 7420 7468 650a 2020 2020 2070 6163 6b61 t the. packa │ │ │ │ │ +00009680: 6765 2063 616e 2073 7469 6c6c 2062 6520 ge can still be │ │ │ │ │ +00009690: 6275 696c 7429 2c20 6275 7420 276d 616b built), but 'mak │ │ │ │ │ +000096a0: 6520 6469 7374 2720 7769 6c6c 2066 6169 e dist' will fai │ │ │ │ │ +000096b0: 6c2e 0a0a 5645 5253 494f 4e0a 2020 2020 l...VERSION. │ │ │ │ │ +000096c0: 2041 2076 6572 7369 6f6e 206e 756d 6265 A version numbe │ │ │ │ │ +000096d0: 7220 2865 2e67 2e2c 2027 302e 3330 2729 r (e.g., '0.30') │ │ │ │ │ +000096e0: 2063 616e 2062 6520 7370 6563 6966 6965 can be specifie │ │ │ │ │ +000096f0: 642e 2020 4966 2041 7574 6f6d 616b 6520 d. If Automake │ │ │ │ │ +00009700: 6973 0a20 2020 2020 6e6f 7420 6e65 7765 is. not newe │ │ │ │ │ +00009710: 7220 7468 616e 2074 6865 2076 6572 7369 r than the versi │ │ │ │ │ +00009720: 6f6e 2073 7065 6369 6669 6564 2c20 6372 on specified, cr │ │ │ │ │ +00009730: 6561 7469 6f6e 206f 6620 7468 6520 274d eation of the 'M │ │ │ │ │ +00009740: 616b 6566 696c 652e 696e 270a 2020 2020 akefile.in'. │ │ │ │ │ +00009750: 2077 696c 6c20 6265 2073 7570 7072 6573 will be suppres │ │ │ │ │ +00009760: 7365 642e 0a0a 272d 5743 4154 4547 4f52 sed...'-WCATEGOR │ │ │ │ │ +00009770: 5927 206f 7220 272d 2d77 6172 6e69 6e67 Y' or '--warning │ │ │ │ │ +00009780: 733d 4341 5445 474f 5259 270a 2020 2020 s=CATEGORY'. │ │ │ │ │ +00009790: 2054 6865 7365 206f 7074 696f 6e73 2062 These options b │ │ │ │ │ +000097a0: 6568 6176 6520 6578 6163 746c 7920 6c69 ehave exactly li │ │ │ │ │ +000097b0: 6b65 2074 6865 6972 2063 6f6d 6d61 6e64 ke their command │ │ │ │ │ +000097c0: 2d6c 696e 6520 636f 756e 7465 7270 6172 -line counterpar │ │ │ │ │ +000097d0: 740a 2020 2020 2028 2a6e 6f74 6520 6175 t. (*note au │ │ │ │ │ +000097e0: 746f 6d61 6b65 2049 6e76 6f63 6174 696f tomake Invocatio │ │ │ │ │ +000097f0: 6e3a 3a29 2e20 2054 6869 7320 616c 6c6f n::). This allo │ │ │ │ │ +00009800: 7773 2079 6f75 2074 6f20 656e 6162 6c65 ws you to enable │ │ │ │ │ +00009810: 206f 720a 2020 2020 2064 6973 6162 6c65 or. disable │ │ │ │ │ +00009820: 2073 6f6d 6520 7761 726e 696e 6720 6361 some warning ca │ │ │ │ │ +00009830: 7465 676f 7269 6573 206f 6e20 6120 7065 tegories on a pe │ │ │ │ │ +00009840: 722d 6669 6c65 2062 6173 6973 2e20 2059 r-file basis. Y │ │ │ │ │ +00009850: 6f75 2063 616e 2061 6c73 6f0a 2020 2020 ou can also. │ │ │ │ │ +00009860: 2073 6574 7570 2073 6f6d 6520 7761 726e setup some warn │ │ │ │ │ +00009870: 696e 6773 2066 6f72 2079 6f75 7220 656e ings for your en │ │ │ │ │ +00009880: 7469 7265 2070 726f 6a65 6374 3b20 666f tire project; fo │ │ │ │ │ +00009890: 7220 696e 7374 616e 6365 2c20 7472 790a r instance, try. │ │ │ │ │ +000098a0: 2020 2020 2027 414d 5f49 4e49 545f 4155 'AM_INIT_AU │ │ │ │ │ +000098b0: 544f 4d41 4b45 285b 2d57 616c 6c5d 2927 TOMAKE([-Wall])' │ │ │ │ │ +000098c0: 2069 6e20 796f 7572 2027 636f 6e66 6967 in your 'config │ │ │ │ │ +000098d0: 7572 652e 6163 272e 0a0a 2020 2055 6e72 ure.ac'... Unr │ │ │ │ │ +000098e0: 6563 6f67 6e69 7a65 6420 6f70 7469 6f6e ecognized option │ │ │ │ │ +000098f0: 7320 6172 6520 6469 6167 6e6f 7365 6420 s are diagnosed │ │ │ │ │ +00009900: 6279 2027 6175 746f 6d61 6b65 272e 0a0a by 'automake'... │ │ │ │ │ +00009910: 2020 2049 6620 796f 7520 7761 6e74 2061 If you want a │ │ │ │ │ +00009920: 6e20 6f70 7469 6f6e 2074 6f20 6170 706c n option to appl │ │ │ │ │ +00009930: 7920 746f 2061 6c6c 2074 6865 2066 696c y to all the fil │ │ │ │ │ +00009940: 6573 2069 6e20 7468 6520 7472 6565 2c20 es in the tree, │ │ │ │ │ +00009950: 796f 7520 6361 6e0a 7573 6520 7468 6520 you can.use the │ │ │ │ │ +00009960: 2741 4d5f 494e 4954 5f41 5554 4f4d 414b 'AM_INIT_AUTOMAK │ │ │ │ │ +00009970: 4527 206d 6163 726f 2069 6e20 2763 6f6e E' macro in 'con │ │ │ │ │ +00009980: 6669 6775 7265 2e61 6327 2e20 202a 4e6f figure.ac'. *No │ │ │ │ │ +00009990: 7465 204d 6163 726f 733a 3a2e 0a0a 1f0a te Macros::..... │ │ │ │ │ +000099a0: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +000099b0: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +000099c0: 204d 6973 6365 6c6c 616e 656f 7573 2c20 Miscellaneous, │ │ │ │ │ +000099d0: 204e 6578 743a 2049 6e63 6c75 6465 2c20 Next: Include, │ │ │ │ │ +000099e0: 2050 7265 763a 204f 7074 696f 6e73 2c20 Prev: Options, │ │ │ │ │ +000099f0: 2055 703a 2054 6f70 0a0a 3138 204d 6973 Up: Top..18 Mis │ │ │ │ │ +00009a00: 6365 6c6c 616e 656f 7573 2052 756c 6573 cellaneous Rules │ │ │ │ │ +00009a10: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ +00009a20: 2a2a 2a2a 2a2a 2a0a 0a54 6865 7265 2061 *******..There a │ │ │ │ │ +00009a30: 7265 2061 2066 6577 2072 756c 6573 2061 re a few rules a │ │ │ │ │ +00009a40: 6e64 2076 6172 6961 626c 6573 2074 6861 nd variables tha │ │ │ │ │ +00009a50: 7420 6469 646e 2774 2066 6974 2061 6e79 t didn't fit any │ │ │ │ │ +00009a60: 7768 6572 6520 656c 7365 2e0a 0a2a 204d where else...* M │ │ │ │ │ +00009a70: 656e 753a 0a0a 2a20 5461 6773 3a3a 2020 enu:..* Tags:: │ │ │ │ │ +00009a80: 2020 2020 2020 496e 7465 7266 6163 696e Interfacin │ │ │ │ │ +00009a90: 6720 746f 2065 7461 6773 2061 6e64 206d g to etags and m │ │ │ │ │ +00009aa0: 6b69 640a 2a20 5375 6666 6978 6573 3a3a kid.* Suffixes:: │ │ │ │ │ +00009ab0: 2020 2020 4861 6e64 6c69 6e67 206e 6577 Handling new │ │ │ │ │ +00009ac0: 2066 696c 6520 6578 7465 6e73 696f 6e73 file extensions │ │ │ │ │ +00009ad0: 0a2a 204d 756c 7469 6c69 6273 3a3a 2020 .* Multilibs:: │ │ │ │ │ +00009ae0: 2053 7570 706f 7274 2066 6f72 206d 756c Support for mul │ │ │ │ │ +00009af0: 7469 6c69 6273 2028 6465 7072 6563 6174 tilibs (deprecat │ │ │ │ │ +00009b00: 6564 2c20 736f 6f6e 2074 6f20 6265 2072 ed, soon to be r │ │ │ │ │ +00009b10: 656d 6f76 6564 292e 0a0a 1f0a 4669 6c65 emoved).....File │ │ │ │ │ +00009b20: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ +00009b30: 696e 666f 2c20 204e 6f64 653a 2054 6167 info, Node: Tag │ │ │ │ │ +00009b40: 732c 2020 4e65 7874 3a20 5375 6666 6978 s, Next: Suffix │ │ │ │ │ +00009b50: 6573 2c20 2055 703a 204d 6973 6365 6c6c es, Up: Miscell │ │ │ │ │ +00009b60: 616e 656f 7573 0a0a 3138 2e31 2049 6e74 aneous..18.1 Int │ │ │ │ │ +00009b70: 6572 6661 6369 6e67 2074 6f20 2765 7461 erfacing to 'eta │ │ │ │ │ +00009b80: 6773 270a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d gs'.============ │ │ │ │ │ +00009b90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00009ba0: 0a41 7574 6f6d 616b 6520 7769 6c6c 2067 .Automake will g │ │ │ │ │ +00009bb0: 656e 6572 6174 6520 7275 6c65 7320 746f enerate rules to │ │ │ │ │ +00009bc0: 2067 656e 6572 6174 6520 2754 4147 5327 generate 'TAGS' │ │ │ │ │ +00009bd0: 2066 696c 6573 2066 6f72 2075 7365 2077 files for use w │ │ │ │ │ +00009be0: 6974 6820 474e 550a 456d 6163 7320 756e ith GNU.Emacs un │ │ │ │ │ +00009bf0: 6465 7220 736f 6d65 2063 6972 6375 6d73 der some circums │ │ │ │ │ +00009c00: 7461 6e63 6573 2e0a 0a20 2020 4966 2061 tances... If a │ │ │ │ │ +00009c10: 6e79 2043 2c20 432b 2b20 6f72 2046 6f72 ny C, C++ or For │ │ │ │ │ +00009c20: 7472 616e 2037 3720 736f 7572 6365 2063 tran 77 source c │ │ │ │ │ +00009c30: 6f64 6520 6f72 2068 6561 6465 7273 2061 ode or headers a │ │ │ │ │ +00009c40: 7265 2070 7265 7365 6e74 2c20 7468 656e re present, then │ │ │ │ │ +00009c50: 0a27 7461 6773 2720 616e 6420 2754 4147 .'tags' and 'TAG │ │ │ │ │ +00009c60: 5327 2072 756c 6573 2077 696c 6c20 6265 S' rules will be │ │ │ │ │ +00009c70: 2067 656e 6572 6174 6564 2066 6f72 2074 generated for t │ │ │ │ │ +00009c80: 6865 2064 6972 6563 746f 7279 2e20 2041 he directory. A │ │ │ │ │ +00009c90: 6c6c 2066 696c 6573 0a6c 6973 7465 6420 ll files.listed │ │ │ │ │ +00009ca0: 7573 696e 6720 7468 6520 275f 534f 5552 using the '_SOUR │ │ │ │ │ +00009cb0: 4345 5327 2c20 275f 4845 4144 4552 5327 CES', '_HEADERS' │ │ │ │ │ +00009cc0: 2c20 616e 6420 275f 4c49 5350 2720 7072 , and '_LISP' pr │ │ │ │ │ +00009cd0: 696d 6172 6965 7320 7769 6c6c 2062 650a imaries will be. │ │ │ │ │ +00009ce0: 7573 6564 2074 6f20 6765 6e65 7261 7465 used to generate │ │ │ │ │ +00009cf0: 2074 6167 732e 2020 4e6f 7465 2074 6861 tags. Note tha │ │ │ │ │ +00009d00: 7420 6765 6e65 7261 7465 6420 736f 7572 t generated sour │ │ │ │ │ +00009d10: 6365 2066 696c 6573 2074 6861 7420 6172 ce files that ar │ │ │ │ │ +00009d20: 6520 6e6f 740a 6469 7374 7269 6275 7465 e not.distribute │ │ │ │ │ +00009d30: 6420 6d75 7374 2062 6520 6465 636c 6172 d must be declar │ │ │ │ │ +00009d40: 6564 2069 6e20 7661 7269 6162 6c65 7320 ed in variables │ │ │ │ │ +00009d50: 6c69 6b65 2027 6e6f 6469 7374 5f6e 6f69 like 'nodist_noi │ │ │ │ │ +00009d60: 6e73 745f 4845 4144 4552 5327 0a6f 7220 nst_HEADERS'.or │ │ │ │ │ +00009d70: 276e 6f64 6973 745f 5052 4f47 5f53 4f55 'nodist_PROG_SOU │ │ │ │ │ +00009d80: 5243 4553 2720 6f72 2074 6865 7920 7769 RCES' or they wi │ │ │ │ │ +00009d90: 6c6c 2062 6520 6967 6e6f 7265 642e 0a0a ll be ignored... │ │ │ │ │ +00009da0: 2020 2041 2027 7461 6773 2720 7275 6c65 A 'tags' rule │ │ │ │ │ +00009db0: 2077 696c 6c20 6265 206f 7574 7075 7420 will be output │ │ │ │ │ +00009dc0: 6174 2074 6865 2074 6f70 6d6f 7374 2064 at the topmost d │ │ │ │ │ +00009dd0: 6972 6563 746f 7279 206f 6620 610a 6d75 irectory of a.mu │ │ │ │ │ +00009de0: 6c74 692d 6469 7265 6374 6f72 7920 7061 lti-directory pa │ │ │ │ │ +00009df0: 636b 6167 652e 2020 5768 656e 2072 756e ckage. When run │ │ │ │ │ +00009e00: 2066 726f 6d20 7468 6973 2074 6f70 6d6f from this topmo │ │ │ │ │ +00009e10: 7374 2064 6972 6563 746f 7279 2c20 276d st directory, 'm │ │ │ │ │ +00009e20: 616b 650a 7461 6773 2720 7769 6c6c 2067 ake.tags' will g │ │ │ │ │ +00009e30: 656e 6572 6174 6520 6120 2754 4147 5327 enerate a 'TAGS' │ │ │ │ │ +00009e40: 2066 696c 6520 7468 6174 2069 6e63 6c75 file that inclu │ │ │ │ │ +00009e50: 6465 7320 6279 2072 6566 6572 656e 6365 des by reference │ │ │ │ │ +00009e60: 2061 6c6c 2027 5441 4753 270a 6669 6c65 all 'TAGS'.file │ │ │ │ │ +00009e70: 7320 6672 6f6d 2073 7562 6469 7265 6374 s from subdirect │ │ │ │ │ +00009e80: 6f72 6965 732e 0a0a 2020 2054 6865 2027 ories... The ' │ │ │ │ │ +00009e90: 7461 6773 2720 7275 6c65 2077 696c 6c20 tags' rule will │ │ │ │ │ +00009ea0: 616c 736f 2062 6520 6765 6e65 7261 7465 also be generate │ │ │ │ │ +00009eb0: 6420 6966 2074 6865 2076 6172 6961 626c d if the variabl │ │ │ │ │ +00009ec0: 6520 2745 5441 4753 5f41 5247 5327 0a69 e 'ETAGS_ARGS'.i │ │ │ │ │ +00009ed0: 7320 6465 6669 6e65 642e 2020 5468 6973 s defined. This │ │ │ │ │ +00009ee0: 2076 6172 6961 626c 6520 6973 2069 6e74 variable is int │ │ │ │ │ +00009ef0: 656e 6465 6420 666f 7220 7573 6520 696e ended for use in │ │ │ │ │ +00009f00: 2064 6972 6563 746f 7269 6573 2074 6861 directories tha │ │ │ │ │ +00009f10: 740a 636f 6e74 6169 6e20 7461 6767 6162 t.contain taggab │ │ │ │ │ +00009f20: 6c65 2073 6f75 7263 6520 7468 6174 2027 le source that ' │ │ │ │ │ +00009f30: 6574 6167 7327 2064 6f65 7320 6e6f 7420 etags' does not │ │ │ │ │ +00009f40: 756e 6465 7273 7461 6e64 2e20 2054 6865 understand. The │ │ │ │ │ +00009f50: 2075 7365 7220 6361 6e0a 7573 6520 7468 user can.use th │ │ │ │ │ +00009f60: 6520 2745 5441 4753 464c 4147 5327 2074 e 'ETAGSFLAGS' t │ │ │ │ │ +00009f70: 6f20 7061 7373 2061 6464 6974 696f 6e61 o pass additiona │ │ │ │ │ +00009f80: 6c20 666c 6167 7320 746f 2027 6574 6167 l flags to 'etag │ │ │ │ │ +00009f90: 7327 3b0a 2741 4d5f 4554 4147 5346 4c41 s';.'AM_ETAGSFLA │ │ │ │ │ +00009fa0: 4753 2720 6973 2061 6c73 6f20 6176 6169 GS' is also avai │ │ │ │ │ +00009fb0: 6c61 626c 6520 666f 7220 7573 6520 696e lable for use in │ │ │ │ │ +00009fc0: 2027 4d61 6b65 6669 6c65 2e61 6d27 2e0a 'Makefile.am'.. │ │ │ │ │ +00009fd0: 0a20 2020 4865 7265 2069 7320 686f 7720 . Here is how │ │ │ │ │ +00009fe0: 4175 746f 6d61 6b65 2067 656e 6572 6174 Automake generat │ │ │ │ │ +00009ff0: 6573 2074 6167 7320 666f 7220 6974 7320 es tags for its │ │ │ │ │ +0000a000: 736f 7572 6365 2c20 616e 6420 666f 7220 source, and for │ │ │ │ │ +0000a010: 6e6f 6465 7320 696e 0a69 7473 2054 6578 nodes in.its Tex │ │ │ │ │ +0000a020: 696e 666f 2066 696c 653a 0a0a 2020 2020 info file:.. │ │ │ │ │ +0000a030: 2045 5441 4753 5f41 5247 5320 3d20 6175 ETAGS_ARGS = au │ │ │ │ │ +0000a040: 746f 6d61 6b65 2e69 6e20 2d2d 6c61 6e67 tomake.in --lang │ │ │ │ │ +0000a050: 3d6e 6f6e 6520 5c0a 2020 2020 2020 2d2d =none \. -- │ │ │ │ │ +0000a060: 7265 6765 783d 272f 5e40 6e6f 6465 5b20 regex='/^@node[ │ │ │ │ │ +0000a070: 5c74 5d2b 5c28 5b5e 2c5d 2b5c 292f 5c31 \t]+\([^,]+\)/\1 │ │ │ │ │ +0000a080: 2f27 2061 7574 6f6d 616b 652e 7465 7869 /' automake.texi │ │ │ │ │ +0000a090: 0a0a 2020 2049 6620 796f 7520 6164 6420 .. If you add │ │ │ │ │ +0000a0a0: 6669 6c65 206e 616d 6573 2074 6f20 2745 file names to 'E │ │ │ │ │ +0000a0b0: 5441 4753 5f41 5247 5327 2c20 796f 7520 TAGS_ARGS', you │ │ │ │ │ +0000a0c0: 7769 6c6c 2070 726f 6261 626c 7920 616c will probably al │ │ │ │ │ +0000a0d0: 736f 2077 616e 7420 746f 0a64 6566 696e so want to.defin │ │ │ │ │ +0000a0e0: 6520 2754 4147 535f 4445 5045 4e44 454e e 'TAGS_DEPENDEN │ │ │ │ │ +0000a0f0: 4349 4553 272e 2020 5468 6520 636f 6e74 CIES'. The cont │ │ │ │ │ +0000a100: 656e 7473 206f 6620 7468 6973 2076 6172 ents of this var │ │ │ │ │ +0000a110: 6961 626c 6520 6172 6520 6164 6465 640a iable are added. │ │ │ │ │ +0000a120: 6469 7265 6374 6c79 2074 6f20 7468 6520 directly to the │ │ │ │ │ +0000a130: 6465 7065 6e64 656e 6369 6573 2066 6f72 dependencies for │ │ │ │ │ +0000a140: 2074 6865 2027 7461 6773 2720 7275 6c65 the 'tags' rule │ │ │ │ │ +0000a150: 2e0a 0a20 2020 4175 746f 6d61 6b65 2061 ... Automake a │ │ │ │ │ +0000a160: 6c73 6f20 6765 6e65 7261 7465 7320 6120 lso generates a │ │ │ │ │ +0000a170: 2763 7461 6773 2720 7275 6c65 2074 6861 'ctags' rule tha │ │ │ │ │ +0000a180: 7420 6361 6e20 6265 2075 7365 6420 746f t can be used to │ │ │ │ │ +0000a190: 2062 7569 6c64 0a27 7669 272d 7374 796c build.'vi'-styl │ │ │ │ │ +0000a1a0: 6520 2774 6167 7327 2066 696c 6573 2e20 e 'tags' files. │ │ │ │ │ +0000a1b0: 2054 6865 2076 6172 6961 626c 6520 2743 The variable 'C │ │ │ │ │ +0000a1c0: 5441 4753 2720 6973 2074 6865 206e 616d TAGS' is the nam │ │ │ │ │ +0000a1d0: 6520 6f66 2074 6865 0a70 726f 6772 616d e of the.program │ │ │ │ │ +0000a1e0: 2074 6f20 696e 766f 6b65 2028 6279 2064 to invoke (by d │ │ │ │ │ +0000a1f0: 6566 6175 6c74 2027 6374 6167 7327 293b efault 'ctags'); │ │ │ │ │ +0000a200: 2027 4354 4147 5346 4c41 4753 2720 6361 'CTAGSFLAGS' ca │ │ │ │ │ +0000a210: 6e20 6265 2075 7365 6420 6279 2074 6865 n be used by the │ │ │ │ │ +0000a220: 0a75 7365 7220 746f 2070 6173 7320 6164 .user to pass ad │ │ │ │ │ +0000a230: 6469 7469 6f6e 616c 2066 6c61 6773 2c20 ditional flags, │ │ │ │ │ +0000a240: 616e 6420 2741 4d5f 4354 4147 5346 4c41 and 'AM_CTAGSFLA │ │ │ │ │ +0000a250: 4753 2720 6361 6e20 6265 2075 7365 6420 GS' can be used │ │ │ │ │ +0000a260: 6279 2074 6865 0a27 4d61 6b65 6669 6c65 by the.'Makefile │ │ │ │ │ +0000a270: 2e61 6d27 2e0a 0a20 2020 4175 746f 6d61 .am'... Automa │ │ │ │ │ +0000a280: 6b65 2077 696c 6c20 616c 736f 2067 656e ke will also gen │ │ │ │ │ +0000a290: 6572 6174 6520 616e 2027 4944 2720 7275 erate an 'ID' ru │ │ │ │ │ +0000a2a0: 6c65 2074 6861 7420 7769 6c6c 2072 756e le that will run │ │ │ │ │ +0000a2b0: 2027 6d6b 6964 2720 6f6e 2074 6865 0a73 'mkid' on the.s │ │ │ │ │ +0000a2c0: 6f75 7263 652e 2020 5468 6973 2069 7320 ource. This is │ │ │ │ │ +0000a2d0: 6f6e 6c79 2073 7570 706f 7274 6564 206f only supported o │ │ │ │ │ +0000a2e0: 6e20 6120 6469 7265 6374 6f72 792d 6279 n a directory-by │ │ │ │ │ +0000a2f0: 2d64 6972 6563 746f 7279 2062 6173 6973 -directory basis │ │ │ │ │ +0000a300: 2e0a 0a20 2020 4669 6e61 6c6c 792c 2041 ... Finally, A │ │ │ │ │ +0000a310: 7574 6f6d 616b 6520 616c 736f 2065 6d69 utomake also emi │ │ │ │ │ +0000a320: 7473 2072 756c 6573 2074 6f20 7375 7070 ts rules to supp │ │ │ │ │ +0000a330: 6f72 7420 7468 6520 474e 5520 476c 6f62 ort the GNU Glob │ │ │ │ │ +0000a340: 616c 2054 6167 730a 7072 6f67 7261 6d20 al Tags.program │ │ │ │ │ +0000a350: 2868 7474 703a 2f2f 7777 772e 676e 752e (http://www.gnu. │ │ │ │ │ +0000a360: 6f72 672f 736f 6674 7761 7265 2f67 6c6f org/software/glo │ │ │ │ │ +0000a370: 6261 6c2f 292e 2020 5468 6520 2747 5441 bal/). The 'GTA │ │ │ │ │ +0000a380: 4753 2720 7275 6c65 2072 756e 730a 476c GS' rule runs.Gl │ │ │ │ │ +0000a390: 6f62 616c 2054 6167 7320 616e 6420 7075 obal Tags and pu │ │ │ │ │ +0000a3a0: 7473 2074 6865 2072 6573 756c 7420 696e ts the result in │ │ │ │ │ +0000a3b0: 2074 6865 2074 6f70 2062 7569 6c64 2064 the top build d │ │ │ │ │ +0000a3c0: 6972 6563 746f 7279 2e20 2054 6865 0a76 irectory. The.v │ │ │ │ │ +0000a3d0: 6172 6961 626c 6520 2747 5441 4753 5f41 ariable 'GTAGS_A │ │ │ │ │ +0000a3e0: 5247 5327 2068 6f6c 6473 2061 7267 756d RGS' holds argum │ │ │ │ │ +0000a3f0: 656e 7473 2074 6861 7420 6172 6520 7061 ents that are pa │ │ │ │ │ +0000a400: 7373 6564 2074 6f20 2767 7461 6773 272e ssed to 'gtags'. │ │ │ │ │ +0000a410: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +0000a420: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +0000a430: 6f64 653a 2053 7566 6669 7865 732c 2020 ode: Suffixes, │ │ │ │ │ +0000a440: 4e65 7874 3a20 4d75 6c74 696c 6962 732c Next: Multilibs, │ │ │ │ │ +0000a450: 2020 5072 6576 3a20 5461 6773 2c20 2055 Prev: Tags, U │ │ │ │ │ +0000a460: 703a 204d 6973 6365 6c6c 616e 656f 7573 p: Miscellaneous │ │ │ │ │ +0000a470: 0a0a 3138 2e32 2048 616e 646c 696e 6720 ..18.2 Handling │ │ │ │ │ +0000a480: 6e65 7720 6669 6c65 2065 7874 656e 7369 new file extensi │ │ │ │ │ +0000a490: 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ons.============ │ │ │ │ │ 0000a4a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000a4b0: 3d3d 3d3d 0a0a 4974 2069 7320 736f 6d65 ====..It is some │ │ │ │ │ -0000a4c0: 7469 6d65 7320 7573 6566 756c 2074 6f20 times useful to │ │ │ │ │ -0000a4d0: 696e 7472 6f64 7563 6520 6120 6e65 7720 introduce a new │ │ │ │ │ -0000a4e0: 696d 706c 6963 6974 2072 756c 6520 746f implicit rule to │ │ │ │ │ -0000a4f0: 2068 616e 646c 6520 6120 6669 6c65 0a74 handle a file.t │ │ │ │ │ -0000a500: 7970 6520 7468 6174 2041 7574 6f6d 616b ype that Automak │ │ │ │ │ -0000a510: 6520 646f 6573 206e 6f74 206b 6e6f 7720 e does not know │ │ │ │ │ -0000a520: 6162 6f75 742e 0a0a 2020 2046 6f72 2069 about... For i │ │ │ │ │ -0000a530: 6e73 7461 6e63 652c 2073 7570 706f 7365 nstance, suppose │ │ │ │ │ -0000a540: 2079 6f75 2068 6164 2061 2063 6f6d 7069 you had a compi │ │ │ │ │ -0000a550: 6c65 7220 7468 6174 2063 6f75 6c64 2063 ler that could c │ │ │ │ │ -0000a560: 6f6d 7069 6c65 2027 2e66 6f6f 270a 6669 ompile '.foo'.fi │ │ │ │ │ -0000a570: 6c65 7320 746f 2027 2e6f 2720 6669 6c65 les to '.o' file │ │ │ │ │ -0000a580: 732e 2020 596f 7520 776f 756c 6420 7369 s. You would si │ │ │ │ │ -0000a590: 6d70 6c79 2064 6566 696e 6520 6120 7375 mply define a su │ │ │ │ │ -0000a5a0: 6666 6978 2072 756c 6520 666f 7220 796f ffix rule for yo │ │ │ │ │ -0000a5b0: 7572 0a6c 616e 6775 6167 653a 0a0a 2020 ur.language:.. │ │ │ │ │ -0000a5c0: 2020 202e 666f 6f2e 6f3a 0a20 2020 2020 .foo.o:. │ │ │ │ │ -0000a5d0: 2020 2020 2020 2020 666f 6f63 6320 2d63 foocc -c │ │ │ │ │ -0000a5e0: 202d 6f20 2440 2024 3c0a 0a20 2020 5468 -o $@ $<.. Th │ │ │ │ │ -0000a5f0: 656e 2079 6f75 2063 6f75 6c64 2064 6972 en you could dir │ │ │ │ │ -0000a600: 6563 746c 7920 7573 6520 6120 272e 666f ectly use a '.fo │ │ │ │ │ -0000a610: 6f27 2066 696c 6520 696e 2061 2027 5f53 o' file in a '_S │ │ │ │ │ -0000a620: 4f55 5243 4553 2720 7661 7269 6162 6c65 OURCES' variable │ │ │ │ │ -0000a630: 0a61 6e64 2065 7870 6563 7420 7468 6520 .and expect the │ │ │ │ │ -0000a640: 636f 7272 6563 7420 7265 7375 6c74 733a correct results: │ │ │ │ │ -0000a650: 0a0a 2020 2020 2062 696e 5f50 524f 4752 .. bin_PROGR │ │ │ │ │ -0000a660: 414d 5320 3d20 646f 6974 0a20 2020 2020 AMS = doit. │ │ │ │ │ -0000a670: 646f 6974 5f53 4f55 5243 4553 203d 2064 doit_SOURCES = d │ │ │ │ │ -0000a680: 6f69 742e 666f 6f0a 0a20 2020 5468 6973 oit.foo.. This │ │ │ │ │ -0000a690: 2077 6173 2074 6865 2073 696d 706c 6572 was the simpler │ │ │ │ │ -0000a6a0: 2061 6e64 206d 6f72 6520 636f 6d6d 6f6e and more common │ │ │ │ │ -0000a6b0: 2063 6173 652e 2020 496e 206f 7468 6572 case. In other │ │ │ │ │ -0000a6c0: 2063 6173 6573 2c20 796f 7520 7769 6c6c cases, you will │ │ │ │ │ -0000a6d0: 0a68 6176 6520 746f 2068 656c 7020 4175 .have to help Au │ │ │ │ │ -0000a6e0: 746f 6d61 6b65 2074 6f20 6669 6775 7265 tomake to figure │ │ │ │ │ -0000a6f0: 206f 7574 2077 6869 6368 2065 7874 656e out which exten │ │ │ │ │ -0000a700: 7369 6f6e 7320 796f 7520 6172 6520 6465 sions you are de │ │ │ │ │ -0000a710: 6669 6e69 6e67 0a79 6f75 7220 7375 6666 fining.your suff │ │ │ │ │ -0000a720: 6978 2072 756c 6520 666f 722e 2020 5468 ix rule for. Th │ │ │ │ │ -0000a730: 6973 2075 7375 616c 6c79 2068 6170 7065 is usually happe │ │ │ │ │ -0000a740: 6e73 2077 6865 6e20 796f 7572 2065 7874 ns when your ext │ │ │ │ │ -0000a750: 656e 7369 6f6e 2064 6f65 7320 6e6f 740a ension does not. │ │ │ │ │ -0000a760: 7374 6172 7420 7769 7468 2061 2064 6f74 start with a dot │ │ │ │ │ -0000a770: 2e20 2054 6865 6e2c 2061 6c6c 2079 6f75 . Then, all you │ │ │ │ │ -0000a780: 2068 6176 6520 746f 2064 6f20 6973 2074 have to do is t │ │ │ │ │ -0000a790: 6f20 7075 7420 6120 6c69 7374 206f 6620 o put a list of │ │ │ │ │ -0000a7a0: 6e65 770a 7375 6666 6978 6573 2069 6e20 new.suffixes in │ │ │ │ │ -0000a7b0: 7468 6520 2753 5546 4649 5845 5327 2076 the 'SUFFIXES' v │ │ │ │ │ -0000a7c0: 6172 6961 626c 6520 2a62 6566 6f72 652a ariable *before* │ │ │ │ │ -0000a7d0: 2079 6f75 2064 6566 696e 6520 796f 7572 you define your │ │ │ │ │ -0000a7e0: 2069 6d70 6c69 6369 740a 7275 6c65 2e0a implicit.rule.. │ │ │ │ │ -0000a7f0: 0a20 2020 466f 7220 696e 7374 616e 6365 . For instance │ │ │ │ │ -0000a800: 2c20 7468 6520 666f 6c6c 6f77 696e 6720 , the following │ │ │ │ │ -0000a810: 6465 6669 6e69 7469 6f6e 2070 7265 7665 definition preve │ │ │ │ │ -0000a820: 6e74 7320 4175 746f 6d61 6b65 2066 726f nts Automake fro │ │ │ │ │ -0000a830: 6d0a 6d69 7369 6e74 6572 7072 6574 696e m.misinterpretin │ │ │ │ │ -0000a840: 6720 7468 6520 272e 6964 6c43 2e63 7070 g the '.idlC.cpp │ │ │ │ │ -0000a850: 3a27 2072 756c 6520 6173 2061 6e20 6174 :' rule as an at │ │ │ │ │ -0000a860: 7465 6d70 7420 746f 2074 7261 6e73 666f tempt to transfo │ │ │ │ │ -0000a870: 726d 2027 2e69 646c 4327 0a66 696c 6573 rm '.idlC'.files │ │ │ │ │ -0000a880: 2069 6e74 6f20 272e 6370 7027 2066 696c into '.cpp' fil │ │ │ │ │ -0000a890: 6573 2e0a 0a20 2020 2020 5355 4646 4958 es... SUFFIX │ │ │ │ │ -0000a8a0: 4553 203d 202e 6964 6c20 432e 6370 700a ES = .idl C.cpp. │ │ │ │ │ -0000a8b0: 2020 2020 202e 6964 6c43 2e63 7070 3a0a .idlC.cpp:. │ │ │ │ │ -0000a8c0: 2020 2020 2020 2020 2020 2020 2023 2077 # w │ │ │ │ │ -0000a8d0: 6861 7465 7665 720a 0a20 2020 4173 2079 hatever.. As y │ │ │ │ │ -0000a8e0: 6f75 206d 6179 2068 6176 6520 6e6f 7465 ou may have note │ │ │ │ │ -0000a8f0: 642c 2074 6865 2027 5355 4646 4958 4553 d, the 'SUFFIXES │ │ │ │ │ -0000a900: 2720 7661 7269 6162 6c65 2062 6568 6176 ' variable behav │ │ │ │ │ -0000a910: 6573 206c 696b 6520 7468 650a 272e 5355 es like the.'.SU │ │ │ │ │ -0000a920: 4646 4958 4553 2720 7370 6563 6961 6c20 FFIXES' special │ │ │ │ │ -0000a930: 7461 7267 6574 206f 6620 276d 616b 6527 target of 'make' │ │ │ │ │ -0000a940: 2e20 2059 6f75 2073 686f 756c 6420 6e6f . You should no │ │ │ │ │ -0000a950: 7420 746f 7563 6820 272e 5355 4646 4958 t touch '.SUFFIX │ │ │ │ │ -0000a960: 4553 270a 796f 7572 7365 6c66 2c20 6275 ES'.yourself, bu │ │ │ │ │ -0000a970: 7420 7573 6520 2753 5546 4649 5845 5327 t use 'SUFFIXES' │ │ │ │ │ -0000a980: 2069 6e73 7465 6164 2061 6e64 206c 6574 instead and let │ │ │ │ │ -0000a990: 2041 7574 6f6d 616b 6520 6765 6e65 7261 Automake genera │ │ │ │ │ -0000a9a0: 7465 2074 6865 0a73 7566 6669 7820 6c69 te the.suffix li │ │ │ │ │ -0000a9b0: 7374 2066 6f72 2027 2e53 5546 4649 5845 st for '.SUFFIXE │ │ │ │ │ -0000a9c0: 5327 2e20 2041 6e79 2067 6976 656e 2027 S'. Any given ' │ │ │ │ │ -0000a9d0: 5355 4646 4958 4553 2720 676f 2061 7420 SUFFIXES' go at │ │ │ │ │ -0000a9e0: 7468 6520 7374 6172 7420 6f66 0a74 6865 the start of.the │ │ │ │ │ -0000a9f0: 2067 656e 6572 6174 6564 2073 7566 6669 generated suffi │ │ │ │ │ -0000aa00: 7865 7320 6c69 7374 2c20 666f 6c6c 6f77 xes list, follow │ │ │ │ │ -0000aa10: 6564 2062 7920 4175 746f 6d61 6b65 2067 ed by Automake g │ │ │ │ │ -0000aa20: 656e 6572 6174 6564 2073 7566 6669 7865 enerated suffixe │ │ │ │ │ -0000aa30: 7320 6e6f 740a 616c 7265 6164 7920 696e s not.already in │ │ │ │ │ -0000aa40: 2074 6865 206c 6973 742e 0a0a 1f0a 4669 the list.....Fi │ │ │ │ │ -0000aa50: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ -0000aa60: 312e 696e 666f 2c20 204e 6f64 653a 204d 1.info, Node: M │ │ │ │ │ -0000aa70: 756c 7469 6c69 6273 2c20 2050 7265 763a ultilibs, Prev: │ │ │ │ │ -0000aa80: 2053 7566 6669 7865 732c 2020 5570 3a20 Suffixes, Up: │ │ │ │ │ -0000aa90: 4d69 7363 656c 6c61 6e65 6f75 730a 0a31 Miscellaneous..1 │ │ │ │ │ -0000aaa0: 382e 3320 5375 7070 6f72 7420 666f 7220 8.3 Support for │ │ │ │ │ -0000aab0: 4d75 6c74 696c 6962 7320 2864 6570 7265 Multilibs (depre │ │ │ │ │ -0000aac0: 6361 7465 642c 2073 6f6f 6e20 746f 2062 cated, soon to b │ │ │ │ │ -0000aad0: 6520 7265 6d6f 7665 6429 2e0a 3d3d 3d3d e removed)..==== │ │ │ │ │ +0000a4b0: 3d3d 3d3d 3d0a 0a49 7420 6973 2073 6f6d =====..It is som │ │ │ │ │ +0000a4c0: 6574 696d 6573 2075 7365 6675 6c20 746f etimes useful to │ │ │ │ │ +0000a4d0: 2069 6e74 726f 6475 6365 2061 206e 6577 introduce a new │ │ │ │ │ +0000a4e0: 2069 6d70 6c69 6369 7420 7275 6c65 2074 implicit rule t │ │ │ │ │ +0000a4f0: 6f20 6861 6e64 6c65 2061 2066 696c 650a o handle a file. │ │ │ │ │ +0000a500: 7479 7065 2074 6861 7420 4175 746f 6d61 type that Automa │ │ │ │ │ +0000a510: 6b65 2064 6f65 7320 6e6f 7420 6b6e 6f77 ke does not know │ │ │ │ │ +0000a520: 2061 626f 7574 2e0a 0a20 2020 466f 7220 about... For │ │ │ │ │ +0000a530: 696e 7374 616e 6365 2c20 7375 7070 6f73 instance, suppos │ │ │ │ │ +0000a540: 6520 796f 7520 6861 6420 6120 636f 6d70 e you had a comp │ │ │ │ │ +0000a550: 696c 6572 2074 6861 7420 636f 756c 6420 iler that could │ │ │ │ │ +0000a560: 636f 6d70 696c 6520 272e 666f 6f27 0a66 compile '.foo'.f │ │ │ │ │ +0000a570: 696c 6573 2074 6f20 272e 6f27 2066 696c iles to '.o' fil │ │ │ │ │ +0000a580: 6573 2e20 2059 6f75 2077 6f75 6c64 2073 es. You would s │ │ │ │ │ +0000a590: 696d 706c 7920 6465 6669 6e65 2061 2073 imply define a s │ │ │ │ │ +0000a5a0: 7566 6669 7820 7275 6c65 2066 6f72 2079 uffix rule for y │ │ │ │ │ +0000a5b0: 6f75 720a 6c61 6e67 7561 6765 3a0a 0a20 our.language:.. │ │ │ │ │ +0000a5c0: 2020 2020 2e66 6f6f 2e6f 3a0a 2020 2020 .foo.o:. │ │ │ │ │ +0000a5d0: 2020 2020 2020 2020 2066 6f6f 6363 202d foocc - │ │ │ │ │ +0000a5e0: 6320 2d6f 2024 4020 243c 0a0a 2020 2054 c -o $@ $<.. T │ │ │ │ │ +0000a5f0: 6865 6e20 796f 7520 636f 756c 6420 6469 hen you could di │ │ │ │ │ +0000a600: 7265 6374 6c79 2075 7365 2061 2027 2e66 rectly use a '.f │ │ │ │ │ +0000a610: 6f6f 2720 6669 6c65 2069 6e20 6120 275f oo' file in a '_ │ │ │ │ │ +0000a620: 534f 5552 4345 5327 2076 6172 6961 626c SOURCES' variabl │ │ │ │ │ +0000a630: 650a 616e 6420 6578 7065 6374 2074 6865 e.and expect the │ │ │ │ │ +0000a640: 2063 6f72 7265 6374 2072 6573 756c 7473 correct results │ │ │ │ │ +0000a650: 3a0a 0a20 2020 2020 6269 6e5f 5052 4f47 :.. bin_PROG │ │ │ │ │ +0000a660: 5241 4d53 203d 2064 6f69 740a 2020 2020 RAMS = doit. │ │ │ │ │ +0000a670: 2064 6f69 745f 534f 5552 4345 5320 3d20 doit_SOURCES = │ │ │ │ │ +0000a680: 646f 6974 2e66 6f6f 0a0a 2020 2054 6869 doit.foo.. Thi │ │ │ │ │ +0000a690: 7320 7761 7320 7468 6520 7369 6d70 6c65 s was the simple │ │ │ │ │ +0000a6a0: 7220 616e 6420 6d6f 7265 2063 6f6d 6d6f r and more commo │ │ │ │ │ +0000a6b0: 6e20 6361 7365 2e20 2049 6e20 6f74 6865 n case. In othe │ │ │ │ │ +0000a6c0: 7220 6361 7365 732c 2079 6f75 2077 696c r cases, you wil │ │ │ │ │ +0000a6d0: 6c0a 6861 7665 2074 6f20 6865 6c70 2041 l.have to help A │ │ │ │ │ +0000a6e0: 7574 6f6d 616b 6520 746f 2066 6967 7572 utomake to figur │ │ │ │ │ +0000a6f0: 6520 6f75 7420 7768 6963 6820 6578 7465 e out which exte │ │ │ │ │ +0000a700: 6e73 696f 6e73 2079 6f75 2061 7265 2064 nsions you are d │ │ │ │ │ +0000a710: 6566 696e 696e 670a 796f 7572 2073 7566 efining.your suf │ │ │ │ │ +0000a720: 6669 7820 7275 6c65 2066 6f72 2e20 2054 fix rule for. T │ │ │ │ │ +0000a730: 6869 7320 7573 7561 6c6c 7920 6861 7070 his usually happ │ │ │ │ │ +0000a740: 656e 7320 7768 656e 2079 6f75 7220 6578 ens when your ex │ │ │ │ │ +0000a750: 7465 6e73 696f 6e20 646f 6573 206e 6f74 tension does not │ │ │ │ │ +0000a760: 0a73 7461 7274 2077 6974 6820 6120 646f .start with a do │ │ │ │ │ +0000a770: 742e 2020 5468 656e 2c20 616c 6c20 796f t. Then, all yo │ │ │ │ │ +0000a780: 7520 6861 7665 2074 6f20 646f 2069 7320 u have to do is │ │ │ │ │ +0000a790: 746f 2070 7574 2061 206c 6973 7420 6f66 to put a list of │ │ │ │ │ +0000a7a0: 206e 6577 0a73 7566 6669 7865 7320 696e new.suffixes in │ │ │ │ │ +0000a7b0: 2074 6865 2027 5355 4646 4958 4553 2720 the 'SUFFIXES' │ │ │ │ │ +0000a7c0: 7661 7269 6162 6c65 202a 6265 666f 7265 variable *before │ │ │ │ │ +0000a7d0: 2a20 796f 7520 6465 6669 6e65 2079 6f75 * you define you │ │ │ │ │ +0000a7e0: 7220 696d 706c 6963 6974 0a72 756c 652e r implicit.rule. │ │ │ │ │ +0000a7f0: 0a0a 2020 2046 6f72 2069 6e73 7461 6e63 .. For instanc │ │ │ │ │ +0000a800: 652c 2074 6865 2066 6f6c 6c6f 7769 6e67 e, the following │ │ │ │ │ +0000a810: 2064 6566 696e 6974 696f 6e20 7072 6576 definition prev │ │ │ │ │ +0000a820: 656e 7473 2041 7574 6f6d 616b 6520 6672 ents Automake fr │ │ │ │ │ +0000a830: 6f6d 0a6d 6973 696e 7465 7270 7265 7469 om.misinterpreti │ │ │ │ │ +0000a840: 6e67 2074 6865 2027 2e69 646c 432e 6370 ng the '.idlC.cp │ │ │ │ │ +0000a850: 703a 2720 7275 6c65 2061 7320 616e 2061 p:' rule as an a │ │ │ │ │ +0000a860: 7474 656d 7074 2074 6f20 7472 616e 7366 ttempt to transf │ │ │ │ │ +0000a870: 6f72 6d20 272e 6964 6c43 270a 6669 6c65 orm '.idlC'.file │ │ │ │ │ +0000a880: 7320 696e 746f 2027 2e63 7070 2720 6669 s into '.cpp' fi │ │ │ │ │ +0000a890: 6c65 732e 0a0a 2020 2020 2053 5546 4649 les... SUFFI │ │ │ │ │ +0000a8a0: 5845 5320 3d20 2e69 646c 2043 2e63 7070 XES = .idl C.cpp │ │ │ │ │ +0000a8b0: 0a20 2020 2020 2e69 646c 432e 6370 703a . .idlC.cpp: │ │ │ │ │ +0000a8c0: 0a20 2020 2020 2020 2020 2020 2020 2320 . # │ │ │ │ │ +0000a8d0: 7768 6174 6576 6572 0a0a 2020 2041 7320 whatever.. As │ │ │ │ │ +0000a8e0: 796f 7520 6d61 7920 6861 7665 206e 6f74 you may have not │ │ │ │ │ +0000a8f0: 6564 2c20 7468 6520 2753 5546 4649 5845 ed, the 'SUFFIXE │ │ │ │ │ +0000a900: 5327 2076 6172 6961 626c 6520 6265 6861 S' variable beha │ │ │ │ │ +0000a910: 7665 7320 6c69 6b65 2074 6865 0a27 2e53 ves like the.'.S │ │ │ │ │ +0000a920: 5546 4649 5845 5327 2073 7065 6369 616c UFFIXES' special │ │ │ │ │ +0000a930: 2074 6172 6765 7420 6f66 2027 6d61 6b65 target of 'make │ │ │ │ │ +0000a940: 272e 2020 596f 7520 7368 6f75 6c64 206e '. You should n │ │ │ │ │ +0000a950: 6f74 2074 6f75 6368 2027 2e53 5546 4649 ot touch '.SUFFI │ │ │ │ │ +0000a960: 5845 5327 0a79 6f75 7273 656c 662c 2062 XES'.yourself, b │ │ │ │ │ +0000a970: 7574 2075 7365 2027 5355 4646 4958 4553 ut use 'SUFFIXES │ │ │ │ │ +0000a980: 2720 696e 7374 6561 6420 616e 6420 6c65 ' instead and le │ │ │ │ │ +0000a990: 7420 4175 746f 6d61 6b65 2067 656e 6572 t Automake gener │ │ │ │ │ +0000a9a0: 6174 6520 7468 650a 7375 6666 6978 206c ate the.suffix l │ │ │ │ │ +0000a9b0: 6973 7420 666f 7220 272e 5355 4646 4958 ist for '.SUFFIX │ │ │ │ │ +0000a9c0: 4553 272e 2020 416e 7920 6769 7665 6e20 ES'. Any given │ │ │ │ │ +0000a9d0: 2753 5546 4649 5845 5327 2067 6f20 6174 'SUFFIXES' go at │ │ │ │ │ +0000a9e0: 2074 6865 2073 7461 7274 206f 660a 7468 the start of.th │ │ │ │ │ +0000a9f0: 6520 6765 6e65 7261 7465 6420 7375 6666 e generated suff │ │ │ │ │ +0000aa00: 6978 6573 206c 6973 742c 2066 6f6c 6c6f ixes list, follo │ │ │ │ │ +0000aa10: 7765 6420 6279 2041 7574 6f6d 616b 6520 wed by Automake │ │ │ │ │ +0000aa20: 6765 6e65 7261 7465 6420 7375 6666 6978 generated suffix │ │ │ │ │ +0000aa30: 6573 206e 6f74 0a61 6c72 6561 6479 2069 es not.already i │ │ │ │ │ +0000aa40: 6e20 7468 6520 6c69 7374 2e0a 0a1f 0a46 n the list.....F │ │ │ │ │ +0000aa50: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +0000aa60: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +0000aa70: 4d75 6c74 696c 6962 732c 2020 5072 6576 Multilibs, Prev │ │ │ │ │ +0000aa80: 3a20 5375 6666 6978 6573 2c20 2055 703a : Suffixes, Up: │ │ │ │ │ +0000aa90: 204d 6973 6365 6c6c 616e 656f 7573 0a0a Miscellaneous.. │ │ │ │ │ +0000aaa0: 3138 2e33 2053 7570 706f 7274 2066 6f72 18.3 Support for │ │ │ │ │ +0000aab0: 204d 756c 7469 6c69 6273 2028 6465 7072 Multilibs (depr │ │ │ │ │ +0000aac0: 6563 6174 6564 2c20 736f 6f6e 2074 6f20 ecated, soon to │ │ │ │ │ +0000aad0: 6265 2072 656d 6f76 6564 292e 0a3d 3d3d be removed)..=== │ │ │ │ │ 0000aae0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0000aaf0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0000ab00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000ab10: 3d3d 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 ========..Automa │ │ │ │ │ -0000ab20: 6b65 2075 7365 6420 746f 2073 7570 706f ke used to suppo │ │ │ │ │ -0000ab30: 7274 2061 6e20 6f62 7363 7572 6520 6665 rt an obscure fe │ │ │ │ │ -0000ab40: 6174 7572 6520 6361 6c6c 6564 206d 756c ature called mul │ │ │ │ │ -0000ab50: 7469 6c69 6273 2e20 205f 5468 6973 0a66 tilibs. _This.f │ │ │ │ │ -0000ab60: 6561 7475 7265 2069 7320 6e6f 7720 6465 eature is now de │ │ │ │ │ -0000ab70: 7072 6563 6174 6564 2c20 616e 6420 7769 precated, and wi │ │ │ │ │ -0000ab80: 6c6c 2062 6520 7265 6d6f 7665 6420 696e ll be removed in │ │ │ │ │ -0000ab90: 2074 6865 206e 6578 7420 6d61 6a6f 720a the next major. │ │ │ │ │ -0000aba0: 4175 746f 6d61 6b65 2076 6572 7369 6f6e Automake version │ │ │ │ │ -0000abb0: 5f2e 2020 5374 696c 6c2c 2069 7473 2069 _. Still, its i │ │ │ │ │ -0000abc0: 6d70 6c65 6d65 6e74 6174 696f 6e20 7769 mplementation wi │ │ │ │ │ -0000abd0: 6c6c 2072 656d 6169 6e20 6176 6169 6c61 ll remain availa │ │ │ │ │ -0000abe0: 626c 6520 696e 0a74 6865 2027 636f 6e74 ble in.the 'cont │ │ │ │ │ -0000abf0: 7269 622f 2720 6469 7265 6374 6f72 7920 rib/' directory │ │ │ │ │ -0000ac00: 6f66 2074 6865 2041 7574 6f6d 616b 6520 of the Automake │ │ │ │ │ -0000ac10: 6469 7374 7269 6275 7469 6f6e 2c20 736f distribution, so │ │ │ │ │ -0000ac20: 2069 7420 7368 6f75 6c64 2062 650a 7665 it should be.ve │ │ │ │ │ -0000ac30: 7279 2065 6173 7920 666f 7220 6d6f 7469 ry easy for moti │ │ │ │ │ -0000ac40: 7661 7465 6420 7573 6572 7320 746f 2063 vated users to c │ │ │ │ │ -0000ac50: 6f6e 7469 6e75 6520 746f 2075 7365 2069 ontinue to use i │ │ │ │ │ -0000ac60: 7420 696e 2074 6865 6972 2070 726f 6a65 t in their proje │ │ │ │ │ -0000ac70: 6374 732c 0a69 6620 7468 6579 2072 6561 cts,.if they rea │ │ │ │ │ -0000ac80: 6c6c 7920 6e65 6564 2074 6f2e 0a0a 2020 lly need to... │ │ │ │ │ -0000ac90: 2041 2022 6d75 6c74 696c 6962 2220 6973 A "multilib" is │ │ │ │ │ -0000aca0: 2061 206c 6962 7261 7279 2074 6861 7420 a library that │ │ │ │ │ -0000acb0: 6973 2062 7569 6c74 2066 6f72 206d 756c is built for mul │ │ │ │ │ -0000acc0: 7469 706c 6520 6469 6666 6572 656e 7420 tiple different │ │ │ │ │ -0000acd0: 4142 4973 0a61 7420 6120 7369 6e67 6c65 ABIs.at a single │ │ │ │ │ -0000ace0: 2074 696d 653b 2065 6163 6820 7469 6d65 time; each time │ │ │ │ │ -0000acf0: 2074 6865 206c 6962 7261 7279 2069 7320 the library is │ │ │ │ │ -0000ad00: 6275 696c 7420 7769 7468 2061 2064 6966 built with a dif │ │ │ │ │ -0000ad10: 6665 7265 6e74 2074 6172 6765 740a 666c ferent target.fl │ │ │ │ │ -0000ad20: 6167 2063 6f6d 6269 6e61 7469 6f6e 2e20 ag combination. │ │ │ │ │ -0000ad30: 2054 6869 7320 6973 206f 6e6c 7920 7573 This is only us │ │ │ │ │ -0000ad40: 6566 756c 2077 6865 6e20 7468 6520 6c69 eful when the li │ │ │ │ │ -0000ad50: 6272 6172 7920 6973 2069 6e74 656e 6465 brary is intende │ │ │ │ │ -0000ad60: 6420 746f 0a62 6520 6372 6f73 732d 636f d to.be cross-co │ │ │ │ │ -0000ad70: 6d70 696c 6564 2c20 616e 6420 6974 2069 mpiled, and it i │ │ │ │ │ -0000ad80: 7320 616c 6d6f 7374 2065 7863 6c75 7369 s almost exclusi │ │ │ │ │ -0000ad90: 7665 6c79 2075 7365 6420 666f 7220 636f vely used for co │ │ │ │ │ -0000ada0: 6d70 696c 6572 0a73 7570 706f 7274 206c mpiler.support l │ │ │ │ │ -0000adb0: 6962 7261 7269 6573 2e0a 0a1f 0a46 696c ibraries.....Fil │ │ │ │ │ -0000adc0: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -0000add0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 496e .info, Node: In │ │ │ │ │ -0000ade0: 636c 7564 652c 2020 4e65 7874 3a20 436f clude, Next: Co │ │ │ │ │ -0000adf0: 6e64 6974 696f 6e61 6c73 2c20 2050 7265 nditionals, Pre │ │ │ │ │ -0000ae00: 763a 204d 6973 6365 6c6c 616e 656f 7573 v: Miscellaneous │ │ │ │ │ -0000ae10: 2c20 2055 703a 2054 6f70 0a0a 3139 2049 , Up: Top..19 I │ │ │ │ │ -0000ae20: 6e63 6c75 6465 0a2a 2a2a 2a2a 2a2a 2a2a nclude.********* │ │ │ │ │ -0000ae30: 2a0a 0a41 7574 6f6d 616b 6520 7375 7070 *..Automake supp │ │ │ │ │ -0000ae40: 6f72 7473 2061 6e20 2769 6e63 6c75 6465 orts an 'include │ │ │ │ │ -0000ae50: 2720 6469 7265 6374 6976 6520 7468 6174 ' directive that │ │ │ │ │ -0000ae60: 2063 616e 2062 6520 7573 6564 2074 6f20 can be used to │ │ │ │ │ -0000ae70: 696e 636c 7564 650a 6f74 6865 7220 274d include.other 'M │ │ │ │ │ -0000ae80: 616b 6566 696c 6527 2066 7261 676d 656e akefile' fragmen │ │ │ │ │ -0000ae90: 7473 2077 6865 6e20 2761 7574 6f6d 616b ts when 'automak │ │ │ │ │ -0000aea0: 6527 2069 7320 7275 6e2e 2020 4e6f 7465 e' is run. Note │ │ │ │ │ -0000aeb0: 2074 6861 7420 7468 6573 650a 6672 6167 that these.frag │ │ │ │ │ -0000aec0: 6d65 6e74 7320 6172 6520 7265 6164 2061 ments are read a │ │ │ │ │ -0000aed0: 6e64 2069 6e74 6572 7072 6574 6564 2062 nd interpreted b │ │ │ │ │ -0000aee0: 7920 2761 7574 6f6d 616b 6527 2c20 6e6f y 'automake', no │ │ │ │ │ -0000aef0: 7420 6279 2027 6d61 6b65 272e 2020 4173 t by 'make'. As │ │ │ │ │ -0000af00: 0a77 6974 6820 636f 6e64 6974 696f 6e61 .with conditiona │ │ │ │ │ -0000af10: 6c73 2c20 276d 616b 6527 2068 6173 206e ls, 'make' has n │ │ │ │ │ -0000af20: 6f20 6964 6561 2074 6861 7420 2769 6e63 o idea that 'inc │ │ │ │ │ -0000af30: 6c75 6465 2720 6973 2069 6e20 7573 652e lude' is in use. │ │ │ │ │ -0000af40: 0a0a 2020 2054 6865 7265 2061 7265 2074 .. There are t │ │ │ │ │ -0000af50: 776f 2066 6f72 6d73 206f 6620 2769 6e63 wo forms of 'inc │ │ │ │ │ -0000af60: 6c75 6465 273a 0a0a 2769 6e63 6c75 6465 lude':..'include │ │ │ │ │ -0000af70: 2024 2873 7263 6469 7229 2f66 696c 6527 $(srcdir)/file' │ │ │ │ │ -0000af80: 0a20 2020 2020 496e 636c 7564 6520 6120 . Include a │ │ │ │ │ -0000af90: 6672 6167 6d65 6e74 2074 6861 7420 6973 fragment that is │ │ │ │ │ -0000afa0: 2066 6f75 6e64 2072 656c 6174 6976 6520 found relative │ │ │ │ │ -0000afb0: 746f 2074 6865 2063 7572 7265 6e74 2073 to the current s │ │ │ │ │ -0000afc0: 6f75 7263 650a 2020 2020 2064 6972 6563 ource. direc │ │ │ │ │ -0000afd0: 746f 7279 2e0a 0a27 696e 636c 7564 6520 tory...'include │ │ │ │ │ -0000afe0: 2428 746f 705f 7372 6364 6972 292f 6669 $(top_srcdir)/fi │ │ │ │ │ -0000aff0: 6c65 270a 2020 2020 2049 6e63 6c75 6465 le'. Include │ │ │ │ │ -0000b000: 2061 2066 7261 676d 656e 7420 7468 6174 a fragment that │ │ │ │ │ -0000b010: 2069 7320 666f 756e 6420 7265 6c61 7469 is found relati │ │ │ │ │ -0000b020: 7665 2074 6f20 7468 6520 746f 7020 736f ve to the top so │ │ │ │ │ -0000b030: 7572 6365 0a20 2020 2020 6469 7265 6374 urce. direct │ │ │ │ │ -0000b040: 6f72 792e 0a0a 2020 204e 6f74 6520 7468 ory... Note th │ │ │ │ │ -0000b050: 6174 2069 6620 6120 6672 6167 6d65 6e74 at if a fragment │ │ │ │ │ -0000b060: 2069 7320 696e 636c 7564 6564 2069 6e73 is included ins │ │ │ │ │ -0000b070: 6964 6520 6120 636f 6e64 6974 696f 6e61 ide a conditiona │ │ │ │ │ -0000b080: 6c2c 2074 6865 6e20 7468 650a 636f 6e64 l, then the.cond │ │ │ │ │ -0000b090: 6974 696f 6e20 6170 706c 6965 7320 746f ition applies to │ │ │ │ │ -0000b0a0: 2074 6865 2065 6e74 6972 6520 636f 6e74 the entire cont │ │ │ │ │ -0000b0b0: 656e 7473 206f 6620 7468 6174 2066 7261 ents of that fra │ │ │ │ │ -0000b0c0: 676d 656e 742e 0a0a 2020 204d 616b 6566 gment... Makef │ │ │ │ │ -0000b0d0: 696c 6520 6672 6167 6d65 6e74 7320 696e ile fragments in │ │ │ │ │ -0000b0e0: 636c 7564 6564 2074 6869 7320 7761 7920 cluded this way │ │ │ │ │ -0000b0f0: 6172 6520 616c 7761 7973 2064 6973 7472 are always distr │ │ │ │ │ -0000b100: 6962 7574 6564 2062 6563 6175 7365 0a74 ibuted because.t │ │ │ │ │ -0000b110: 6865 7920 6172 6520 6e65 6564 6564 2074 hey are needed t │ │ │ │ │ -0000b120: 6f20 7265 6275 696c 6420 274d 616b 6566 o rebuild 'Makef │ │ │ │ │ -0000b130: 696c 652e 696e 272e 0a0a 1f0a 4669 6c65 ile.in'.....File │ │ │ │ │ -0000b140: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -0000b150: 696e 666f 2c20 204e 6f64 653a 2043 6f6e info, Node: Con │ │ │ │ │ -0000b160: 6469 7469 6f6e 616c 732c 2020 4e65 7874 ditionals, Next │ │ │ │ │ -0000b170: 3a20 5369 6c65 6e63 696e 6720 4d61 6b65 : Silencing Make │ │ │ │ │ -0000b180: 2c20 2050 7265 763a 2049 6e63 6c75 6465 , Prev: Include │ │ │ │ │ -0000b190: 2c20 2055 703a 2054 6f70 0a0a 3230 2043 , Up: Top..20 C │ │ │ │ │ -0000b1a0: 6f6e 6469 7469 6f6e 616c 730a 2a2a 2a2a onditionals.**** │ │ │ │ │ -0000b1b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a41 7574 ***********..Aut │ │ │ │ │ -0000b1c0: 6f6d 616b 6520 7375 7070 6f72 7473 2061 omake supports a │ │ │ │ │ -0000b1d0: 2073 696d 706c 6520 7479 7065 206f 6620 simple type of │ │ │ │ │ -0000b1e0: 636f 6e64 6974 696f 6e61 6c73 2e0a 0a20 conditionals... │ │ │ │ │ -0000b1f0: 2020 5468 6573 6520 636f 6e64 6974 696f These conditio │ │ │ │ │ -0000b200: 6e61 6c73 2061 7265 206e 6f74 2074 6865 nals are not the │ │ │ │ │ -0000b210: 2073 616d 6520 6173 2063 6f6e 6469 7469 same as conditi │ │ │ │ │ -0000b220: 6f6e 616c 7320 696e 2047 4e55 204d 616b onals in GNU Mak │ │ │ │ │ -0000b230: 652e 0a41 7574 6f6d 616b 6520 636f 6e64 e..Automake cond │ │ │ │ │ -0000b240: 6974 696f 6e61 6c73 2061 7265 2063 6865 itionals are che │ │ │ │ │ -0000b250: 636b 6564 2061 7420 636f 6e66 6967 7572 cked at configur │ │ │ │ │ -0000b260: 6520 7469 6d65 2062 7920 7468 6520 2763 e time by the 'c │ │ │ │ │ -0000b270: 6f6e 6669 6775 7265 270a 7363 7269 7074 onfigure'.script │ │ │ │ │ -0000b280: 2c20 616e 6420 6166 6665 6374 2074 6865 , and affect the │ │ │ │ │ -0000b290: 2074 7261 6e73 6c61 7469 6f6e 2066 726f translation fro │ │ │ │ │ -0000b2a0: 6d20 274d 616b 6566 696c 652e 696e 2720 m 'Makefile.in' │ │ │ │ │ -0000b2b0: 746f 2027 4d61 6b65 6669 6c65 272e 0a54 to 'Makefile'..T │ │ │ │ │ -0000b2c0: 6865 7920 6172 6520 6261 7365 6420 6f6e hey are based on │ │ │ │ │ -0000b2d0: 206f 7074 696f 6e73 2070 6173 7365 6420 options passed │ │ │ │ │ -0000b2e0: 746f 2027 636f 6e66 6967 7572 6527 2061 to 'configure' a │ │ │ │ │ -0000b2f0: 6e64 206f 6e20 7265 7375 6c74 7320 7468 nd on results th │ │ │ │ │ -0000b300: 6174 0a27 636f 6e66 6967 7572 6527 2068 at.'configure' h │ │ │ │ │ -0000b310: 6173 2064 6973 636f 7665 7265 6420 6162 as discovered ab │ │ │ │ │ -0000b320: 6f75 7420 7468 6520 686f 7374 2073 7973 out the host sys │ │ │ │ │ -0000b330: 7465 6d2e 2020 474e 5520 4d61 6b65 2063 tem. GNU Make c │ │ │ │ │ -0000b340: 6f6e 6469 7469 6f6e 616c 730a 6172 6520 onditionals.are │ │ │ │ │ -0000b350: 6368 6563 6b65 6420 6174 2027 6d61 6b65 checked at 'make │ │ │ │ │ -0000b360: 2720 7469 6d65 2c20 616e 6420 6172 6520 ' time, and are │ │ │ │ │ -0000b370: 6261 7365 6420 6f6e 2076 6172 6961 626c based on variabl │ │ │ │ │ -0000b380: 6573 2070 6173 7365 6420 746f 2074 6865 es passed to the │ │ │ │ │ -0000b390: 0a6d 616b 6520 7072 6f67 7261 6d20 6f72 .make program or │ │ │ │ │ -0000b3a0: 2064 6566 696e 6564 2069 6e20 7468 6520 defined in the │ │ │ │ │ -0000b3b0: 274d 616b 6566 696c 6527 2e0a 0a20 2020 'Makefile'... │ │ │ │ │ -0000b3c0: 4175 746f 6d61 6b65 2063 6f6e 6469 7469 Automake conditi │ │ │ │ │ -0000b3d0: 6f6e 616c 7320 7769 6c6c 2077 6f72 6b20 onals will work │ │ │ │ │ -0000b3e0: 7769 7468 2061 6e79 206d 616b 6520 7072 with any make pr │ │ │ │ │ -0000b3f0: 6f67 7261 6d2e 0a0a 2a20 4d65 6e75 3a0a ogram...* Menu:. │ │ │ │ │ -0000b400: 0a2a 2055 7361 6765 206f 6620 436f 6e64 .* Usage of Cond │ │ │ │ │ -0000b410: 6974 696f 6e61 6c73 3a3a 2020 2020 2020 itionals:: │ │ │ │ │ -0000b420: 2044 6563 6c61 7269 6e67 2063 6f6e 6469 Declaring condi │ │ │ │ │ -0000b430: 7469 6f6e 616c 2063 6f6e 7465 6e74 0a2a tional content.* │ │ │ │ │ -0000b440: 204c 696d 6974 7320 6f66 2043 6f6e 6469 Limits of Condi │ │ │ │ │ -0000b450: 7469 6f6e 616c 733a 3a20 2020 2020 2045 tionals:: E │ │ │ │ │ -0000b460: 6e63 6c6f 7369 6e67 2063 6f6d 706c 6574 nclosing complet │ │ │ │ │ -0000b470: 6520 7374 6174 656d 656e 7473 0a0a 1f0a e statements.... │ │ │ │ │ -0000b480: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ -0000b490: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ -0000b4a0: 2055 7361 6765 206f 6620 436f 6e64 6974 Usage of Condit │ │ │ │ │ -0000b4b0: 696f 6e61 6c73 2c20 204e 6578 743a 204c ionals, Next: L │ │ │ │ │ -0000b4c0: 696d 6974 7320 6f66 2043 6f6e 6469 7469 imits of Conditi │ │ │ │ │ -0000b4d0: 6f6e 616c 732c 2020 5570 3a20 436f 6e64 onals, Up: Cond │ │ │ │ │ -0000b4e0: 6974 696f 6e61 6c73 0a0a 3230 2e31 2055 itionals..20.1 U │ │ │ │ │ -0000b4f0: 7361 6765 206f 6620 436f 6e64 6974 696f sage of Conditio │ │ │ │ │ -0000b500: 6e61 6c73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d nals.=========== │ │ │ │ │ -0000b510: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -0000b520: 0a42 6566 6f72 6520 7573 696e 6720 6120 .Before using a │ │ │ │ │ -0000b530: 636f 6e64 6974 696f 6e61 6c2c 2079 6f75 conditional, you │ │ │ │ │ -0000b540: 206d 7573 7420 6465 6669 6e65 2069 7420 must define it │ │ │ │ │ -0000b550: 6279 2075 7369 6e67 2027 414d 5f43 4f4e by using 'AM_CON │ │ │ │ │ -0000b560: 4449 5449 4f4e 414c 270a 696e 2074 6865 DITIONAL'.in the │ │ │ │ │ -0000b570: 2027 636f 6e66 6967 7572 652e 6163 2720 'configure.ac' │ │ │ │ │ -0000b580: 6669 6c65 2028 2a6e 6f74 6520 4d61 6372 file (*note Macr │ │ │ │ │ -0000b590: 6f73 3a3a 292e 0a0a 202d 2d20 4d61 6372 os::)... -- Macr │ │ │ │ │ -0000b5a0: 6f3a 2041 4d5f 434f 4e44 4954 494f 4e41 o: AM_CONDITIONA │ │ │ │ │ -0000b5b0: 4c20 2843 4f4e 4449 5449 4f4e 414c 2c20 L (CONDITIONAL, │ │ │ │ │ -0000b5c0: 434f 4e44 4954 494f 4e29 0a20 2020 2020 CONDITION). │ │ │ │ │ -0000b5d0: 5468 6520 636f 6e64 6974 696f 6e61 6c20 The conditional │ │ │ │ │ -0000b5e0: 6e61 6d65 2c20 434f 4e44 4954 494f 4e41 name, CONDITIONA │ │ │ │ │ -0000b5f0: 4c2c 2073 686f 756c 6420 6265 2061 2073 L, should be a s │ │ │ │ │ -0000b600: 696d 706c 6520 7374 7269 6e67 0a20 2020 imple string. │ │ │ │ │ -0000b610: 2020 7374 6172 7469 6e67 2077 6974 6820 starting with │ │ │ │ │ -0000b620: 6120 6c65 7474 6572 2061 6e64 2063 6f6e a letter and con │ │ │ │ │ -0000b630: 7461 696e 696e 6720 6f6e 6c79 206c 6574 taining only let │ │ │ │ │ -0000b640: 7465 7273 2c20 6469 6769 7473 2c20 616e ters, digits, an │ │ │ │ │ -0000b650: 640a 2020 2020 2075 6e64 6572 7363 6f72 d. underscor │ │ │ │ │ -0000b660: 6573 2e20 2049 7420 6d75 7374 2062 6520 es. It must be │ │ │ │ │ -0000b670: 6469 6666 6572 656e 7420 6672 6f6d 2027 different from ' │ │ │ │ │ -0000b680: 5452 5545 2720 616e 6420 2746 414c 5345 TRUE' and 'FALSE │ │ │ │ │ -0000b690: 2720 7468 6174 2061 7265 0a20 2020 2020 ' that are. │ │ │ │ │ -0000b6a0: 7265 7365 7276 6564 2062 7920 4175 746f reserved by Auto │ │ │ │ │ -0000b6b0: 6d61 6b65 2e0a 0a20 2020 2020 5468 6520 make... The │ │ │ │ │ -0000b6c0: 7368 656c 6c20 434f 4e44 4954 494f 4e20 shell CONDITION │ │ │ │ │ -0000b6d0: 2873 7569 7461 626c 6520 666f 7220 7573 (suitable for us │ │ │ │ │ -0000b6e0: 6520 696e 2061 2073 6865 6c6c 2027 6966 e in a shell 'if │ │ │ │ │ -0000b6f0: 2720 7374 6174 656d 656e 7429 2069 730a ' statement) is. │ │ │ │ │ -0000b700: 2020 2020 2065 7661 6c75 6174 6564 2077 evaluated w │ │ │ │ │ -0000b710: 6865 6e20 2763 6f6e 6669 6775 7265 2720 hen 'configure' │ │ │ │ │ -0000b720: 6973 2072 756e 2e20 204e 6f74 6520 7468 is run. Note th │ │ │ │ │ -0000b730: 6174 2079 6f75 206d 7573 7420 6172 7261 at you must arra │ │ │ │ │ -0000b740: 6e67 6520 666f 720a 2020 2020 205f 6576 nge for. _ev │ │ │ │ │ -0000b750: 6572 795f 2027 414d 5f43 4f4e 4449 5449 ery_ 'AM_CONDITI │ │ │ │ │ -0000b760: 4f4e 414c 2720 746f 2062 6520 696e 766f ONAL' to be invo │ │ │ │ │ -0000b770: 6b65 6420 6576 6572 7920 7469 6d65 2027 ked every time ' │ │ │ │ │ -0000b780: 636f 6e66 6967 7572 6527 2069 730a 2020 configure' is. │ │ │ │ │ -0000b790: 2020 2072 756e 2e20 2049 6620 2741 4d5f run. If 'AM_ │ │ │ │ │ -0000b7a0: 434f 4e44 4954 494f 4e41 4c27 2069 7320 CONDITIONAL' is │ │ │ │ │ -0000b7b0: 7275 6e20 636f 6e64 6974 696f 6e61 6c6c run conditionall │ │ │ │ │ -0000b7c0: 7920 2865 2e67 2e2c 2069 6e20 6120 7368 y (e.g., in a sh │ │ │ │ │ -0000b7d0: 656c 6c0a 2020 2020 2027 6966 2720 7374 ell. 'if' st │ │ │ │ │ -0000b7e0: 6174 656d 656e 7429 2c20 7468 656e 2074 atement), then t │ │ │ │ │ -0000b7f0: 6865 2072 6573 756c 7420 7769 6c6c 2063 he result will c │ │ │ │ │ -0000b800: 6f6e 6675 7365 2027 6175 746f 6d61 6b65 onfuse 'automake │ │ │ │ │ -0000b810: 272e 0a0a 2020 2043 6f6e 6469 7469 6f6e '... Condition │ │ │ │ │ -0000b820: 616c 7320 7479 7069 6361 6c6c 7920 6465 als typically de │ │ │ │ │ -0000b830: 7065 6e64 2075 706f 6e20 6f70 7469 6f6e pend upon option │ │ │ │ │ -0000b840: 7320 7468 6174 2074 6865 2075 7365 7220 s that the user │ │ │ │ │ -0000b850: 7072 6f76 6964 6573 2074 6f0a 7468 6520 provides to.the │ │ │ │ │ -0000b860: 2763 6f6e 6669 6775 7265 2720 7363 7269 'configure' scri │ │ │ │ │ -0000b870: 7074 2e20 2048 6572 6520 6973 2061 6e20 pt. Here is an │ │ │ │ │ -0000b880: 6578 616d 706c 6520 6f66 2068 6f77 2074 example of how t │ │ │ │ │ -0000b890: 6f20 7772 6974 6520 610a 636f 6e64 6974 o write a.condit │ │ │ │ │ -0000b8a0: 696f 6e61 6c20 7468 6174 2069 7320 7472 ional that is tr │ │ │ │ │ -0000b8b0: 7565 2069 6620 7468 6520 7573 6572 2075 ue if the user u │ │ │ │ │ -0000b8c0: 7365 7320 7468 6520 272d 2d65 6e61 626c ses the '--enabl │ │ │ │ │ -0000b8d0: 652d 6465 6275 6727 206f 7074 696f 6e2e e-debug' option. │ │ │ │ │ -0000b8e0: 0a0a 2020 2020 2041 435f 4152 475f 454e .. AC_ARG_EN │ │ │ │ │ -0000b8f0: 4142 4c45 285b 6465 6275 675d 2c0a 2020 ABLE([debug],. │ │ │ │ │ -0000b900: 2020 205b 2020 2d2d 656e 6162 6c65 2d64 [ --enable-d │ │ │ │ │ -0000b910: 6562 7567 2020 2020 5475 726e 206f 6e20 ebug Turn on │ │ │ │ │ -0000b920: 6465 6275 6767 696e 675d 2c0a 2020 2020 debugging],. │ │ │ │ │ -0000b930: 205b 6361 7365 2022 247b 656e 6162 6c65 [case "${enable │ │ │ │ │ -0000b940: 7661 6c7d 2220 696e 0a20 2020 2020 2020 val}" in. │ │ │ │ │ -0000b950: 7965 7329 2064 6562 7567 3d74 7275 6520 yes) debug=true │ │ │ │ │ -0000b960: 3b3b 0a20 2020 2020 2020 6e6f 2920 2064 ;;. no) d │ │ │ │ │ -0000b970: 6562 7567 3d66 616c 7365 203b 3b0a 2020 ebug=false ;;. │ │ │ │ │ -0000b980: 2020 2020 202a 2920 4143 5f4d 5347 5f45 *) AC_MSG_E │ │ │ │ │ -0000b990: 5252 4f52 285b 6261 6420 7661 6c75 6520 RROR([bad value │ │ │ │ │ -0000b9a0: 247b 656e 6162 6c65 7661 6c7d 2066 6f72 ${enableval} for │ │ │ │ │ -0000b9b0: 202d 2d65 6e61 626c 652d 6465 6275 675d --enable-debug] │ │ │ │ │ -0000b9c0: 2920 3b3b 0a20 2020 2020 6573 6163 5d2c ) ;;. esac], │ │ │ │ │ -0000b9d0: 5b64 6562 7567 3d66 616c 7365 5d29 0a20 [debug=false]). │ │ │ │ │ -0000b9e0: 2020 2020 414d 5f43 4f4e 4449 5449 4f4e AM_CONDITION │ │ │ │ │ -0000b9f0: 414c 285b 4445 4255 475d 2c20 5b74 6573 AL([DEBUG], [tes │ │ │ │ │ -0000ba00: 7420 7824 6465 6275 6720 3d20 7874 7275 t x$debug = xtru │ │ │ │ │ -0000ba10: 655d 290a 0a20 2020 4865 7265 2069 7320 e]).. Here is │ │ │ │ │ -0000ba20: 616e 2065 7861 6d70 6c65 206f 6620 686f an example of ho │ │ │ │ │ -0000ba30: 7720 746f 2075 7365 2074 6861 7420 636f w to use that co │ │ │ │ │ -0000ba40: 6e64 6974 696f 6e61 6c20 696e 2027 4d61 nditional in 'Ma │ │ │ │ │ -0000ba50: 6b65 6669 6c65 2e61 6d27 3a0a 0a20 2020 kefile.am':.. │ │ │ │ │ -0000ba60: 2020 6966 2044 4542 5547 0a20 2020 2020 if DEBUG. │ │ │ │ │ -0000ba70: 4442 4720 3d20 6465 6275 670a 2020 2020 DBG = debug. │ │ │ │ │ -0000ba80: 2065 6c73 650a 2020 2020 2044 4247 203d else. DBG = │ │ │ │ │ -0000ba90: 0a20 2020 2020 656e 6469 660a 2020 2020 . endif. │ │ │ │ │ -0000baa0: 206e 6f69 6e73 745f 5052 4f47 5241 4d53 noinst_PROGRAMS │ │ │ │ │ -0000bab0: 203d 2024 2844 4247 290a 0a20 2020 5468 = $(DBG).. Th │ │ │ │ │ -0000bac0: 6973 2074 7269 7669 616c 2065 7861 6d70 is trivial examp │ │ │ │ │ -0000bad0: 6c65 2063 6f75 6c64 2061 6c73 6f20 6265 le could also be │ │ │ │ │ -0000bae0: 2068 616e 646c 6564 2075 7369 6e67 2027 handled using ' │ │ │ │ │ -0000baf0: 4558 5452 415f 5052 4f47 5241 4d53 270a EXTRA_PROGRAMS'. │ │ │ │ │ -0000bb00: 282a 6e6f 7465 2043 6f6e 6469 7469 6f6e (*note Condition │ │ │ │ │ -0000bb10: 616c 2050 726f 6772 616d 733a 3a29 2e0a al Programs::).. │ │ │ │ │ -0000bb20: 0a20 2020 596f 7520 6d61 7920 6f6e 6c79 . You may only │ │ │ │ │ -0000bb30: 2074 6573 7420 6120 7369 6e67 6c65 2076 test a single v │ │ │ │ │ -0000bb40: 6172 6961 626c 6520 696e 2061 6e20 2769 ariable in an 'i │ │ │ │ │ -0000bb50: 6627 2073 7461 7465 6d65 6e74 2c20 706f f' statement, po │ │ │ │ │ -0000bb60: 7373 6962 6c79 0a6e 6567 6174 6564 2075 ssibly.negated u │ │ │ │ │ -0000bb70: 7369 6e67 2027 2127 2e20 2054 6865 2027 sing '!'. The ' │ │ │ │ │ -0000bb80: 656c 7365 2720 7374 6174 656d 656e 7420 else' statement │ │ │ │ │ -0000bb90: 6d61 7920 6265 206f 6d69 7474 6564 2e20 may be omitted. │ │ │ │ │ -0000bba0: 2043 6f6e 6469 7469 6f6e 616c 730a 6d61 Conditionals.ma │ │ │ │ │ -0000bbb0: 7920 6265 206e 6573 7465 6420 746f 2061 y be nested to a │ │ │ │ │ -0000bbc0: 6e79 2064 6570 7468 2e20 2059 6f75 206d ny depth. You m │ │ │ │ │ -0000bbd0: 6179 2073 7065 6369 6679 2061 6e20 6172 ay specify an ar │ │ │ │ │ -0000bbe0: 6775 6d65 6e74 2074 6f20 2765 6c73 6527 gument to 'else' │ │ │ │ │ -0000bbf0: 2069 6e0a 7768 6963 6820 6361 7365 2069 in.which case i │ │ │ │ │ -0000bc00: 7420 6d75 7374 2062 6520 7468 6520 6e65 t must be the ne │ │ │ │ │ -0000bc10: 6761 7469 6f6e 206f 6620 7468 6520 636f gation of the co │ │ │ │ │ -0000bc20: 6e64 6974 696f 6e20 7573 6564 2066 6f72 ndition used for │ │ │ │ │ -0000bc30: 2074 6865 2063 7572 7265 6e74 0a27 6966 the current.'if │ │ │ │ │ -0000bc40: 272e 2020 5369 6d69 6c61 726c 7920 796f '. Similarly yo │ │ │ │ │ -0000bc50: 7520 6d61 7920 7370 6563 6966 7920 7468 u may specify th │ │ │ │ │ -0000bc60: 6520 636f 6e64 6974 696f 6e20 7468 6174 e condition that │ │ │ │ │ -0000bc70: 2069 7320 636c 6f73 6564 206f 6e20 7468 is closed on th │ │ │ │ │ -0000bc80: 650a 2765 6e64 6966 2720 6c69 6e65 3a0a e.'endif' line:. │ │ │ │ │ -0000bc90: 0a20 2020 2020 6966 2044 4542 5547 0a20 . if DEBUG. │ │ │ │ │ -0000bca0: 2020 2020 4442 4720 3d20 6465 6275 670a DBG = debug. │ │ │ │ │ -0000bcb0: 2020 2020 2065 6c73 6520 2144 4542 5547 else !DEBUG │ │ │ │ │ -0000bcc0: 0a20 2020 2020 4442 4720 3d0a 2020 2020 . DBG =. │ │ │ │ │ -0000bcd0: 2065 6e64 6966 2021 4445 4255 470a 0a55 endif !DEBUG..U │ │ │ │ │ -0000bce0: 6e62 616c 616e 6365 6420 636f 6e64 6974 nbalanced condit │ │ │ │ │ -0000bcf0: 696f 6e73 2061 7265 2065 7272 6f72 732e ions are errors. │ │ │ │ │ -0000bd00: 2020 5468 6520 2769 6627 2c20 2765 6c73 The 'if', 'els │ │ │ │ │ -0000bd10: 6527 2c20 616e 6420 2765 6e64 6966 270a e', and 'endif'. │ │ │ │ │ -0000bd20: 7374 6174 656d 656e 7473 2073 686f 756c statements shoul │ │ │ │ │ -0000bd30: 6420 6e6f 7420 6265 2069 6e64 656e 7465 d not be indente │ │ │ │ │ -0000bd40: 642c 2069 2e65 2e2c 2073 7461 7274 206f d, i.e., start o │ │ │ │ │ -0000bd50: 6e20 636f 6c75 6d6e 206f 6e65 2e0a 0a20 n column one... │ │ │ │ │ -0000bd60: 2020 5468 6520 2765 6c73 6527 2062 7261 The 'else' bra │ │ │ │ │ -0000bd70: 6e63 6820 6f66 2074 6865 2061 626f 7665 nch of the above │ │ │ │ │ -0000bd80: 2074 776f 2065 7861 6d70 6c65 7320 636f two examples co │ │ │ │ │ -0000bd90: 756c 6420 6265 206f 6d69 7474 6564 2c20 uld be omitted, │ │ │ │ │ -0000bda0: 7369 6e63 650a 6173 7369 676e 696e 6720 since.assigning │ │ │ │ │ -0000bdb0: 7468 6520 656d 7074 7920 7374 7269 6e67 the empty string │ │ │ │ │ -0000bdc0: 2074 6f20 616e 206f 7468 6572 7769 7365 to an otherwise │ │ │ │ │ -0000bdd0: 2075 6e64 6566 696e 6564 2076 6172 6961 undefined varia │ │ │ │ │ -0000bde0: 626c 6520 6d61 6b65 7320 6e6f 0a64 6966 ble makes no.dif │ │ │ │ │ -0000bdf0: 6665 7265 6e63 652e 0a0a 2020 2049 6e20 ference... In │ │ │ │ │ -0000be00: 6f72 6465 7220 746f 2061 6c6c 6f77 2061 order to allow a │ │ │ │ │ -0000be10: 6363 6573 7320 746f 2074 6865 2063 6f6e ccess to the con │ │ │ │ │ -0000be20: 6469 7469 6f6e 2072 6567 6973 7465 7265 dition registere │ │ │ │ │ -0000be30: 6420 6279 0a27 414d 5f43 4f4e 4449 5449 d by.'AM_CONDITI │ │ │ │ │ -0000be40: 4f4e 414c 2720 696e 7369 6465 2027 636f ONAL' inside 'co │ │ │ │ │ -0000be50: 6e66 6967 7572 652e 6163 272c 2061 6e64 nfigure.ac', and │ │ │ │ │ -0000be60: 2074 6f20 616c 6c6f 7720 636f 6e64 6974 to allow condit │ │ │ │ │ -0000be70: 696f 6e61 6c0a 2741 435f 434f 4e46 4947 ional.'AC_CONFIG │ │ │ │ │ -0000be80: 5f46 494c 4553 272c 2027 414d 5f43 4f4e _FILES', 'AM_CON │ │ │ │ │ -0000be90: 445f 4946 2720 6d61 7920 6265 2075 7365 D_IF' may be use │ │ │ │ │ -0000bea0: 643a 0a0a 202d 2d20 4d61 6372 6f3a 2041 d:.. -- Macro: A │ │ │ │ │ -0000beb0: 4d5f 434f 4e44 5f49 4620 2843 4f4e 4449 M_COND_IF (CONDI │ │ │ │ │ -0000bec0: 5449 4f4e 414c 2c20 5b49 462d 5452 5545 TIONAL, [IF-TRUE │ │ │ │ │ -0000bed0: 5d2c 205b 4946 2d46 414c 5345 5d29 0a20 ], [IF-FALSE]). │ │ │ │ │ -0000bee0: 2020 2020 4966 2043 4f4e 4449 5449 4f4e If CONDITION │ │ │ │ │ -0000bef0: 414c 2069 7320 6675 6c66 696c 6c65 642c AL is fulfilled, │ │ │ │ │ -0000bf00: 2065 7865 6375 7465 2049 462d 5452 5545 execute IF-TRUE │ │ │ │ │ -0000bf10: 2c20 6f74 6865 7277 6973 6520 6578 6563 , otherwise exec │ │ │ │ │ -0000bf20: 7574 650a 2020 2020 2049 462d 4641 4c53 ute. IF-FALS │ │ │ │ │ -0000bf30: 452e 2020 4966 2065 6974 6865 7220 6272 E. If either br │ │ │ │ │ -0000bf40: 616e 6368 2063 6f6e 7461 696e 7320 2741 anch contains 'A │ │ │ │ │ -0000bf50: 435f 434f 4e46 4947 5f46 494c 4553 272c C_CONFIG_FILES', │ │ │ │ │ -0000bf60: 2069 7420 7769 6c6c 0a20 2020 2020 6361 it will. ca │ │ │ │ │ -0000bf70: 7573 6520 2761 7574 6f6d 616b 6527 2074 use 'automake' t │ │ │ │ │ -0000bf80: 6f20 6f75 7470 7574 2074 6865 2072 756c o output the rul │ │ │ │ │ -0000bf90: 6573 2066 6f72 2074 6865 2072 6573 7065 es for the respe │ │ │ │ │ -0000bfa0: 6374 6976 6520 6669 6c65 7320 6f6e 6c79 ctive files only │ │ │ │ │ -0000bfb0: 0a20 2020 2020 666f 7220 7468 6520 6769 . for the gi │ │ │ │ │ -0000bfc0: 7665 6e20 636f 6e64 6974 696f 6e2e 0a0a ven condition... │ │ │ │ │ -0000bfd0: 2020 2027 414d 5f43 4f4e 445f 4946 2720 'AM_COND_IF' │ │ │ │ │ -0000bfe0: 6d61 6372 6f73 206d 6179 2062 6520 6e65 macros may be ne │ │ │ │ │ -0000bff0: 7374 6564 2077 6865 6e20 6d34 2071 756f sted when m4 quo │ │ │ │ │ -0000c000: 7461 7469 6f6e 2069 7320 7573 6564 2070 tation is used p │ │ │ │ │ -0000c010: 726f 7065 726c 790a 282a 6e6f 7465 2028 roperly.(*note ( │ │ │ │ │ -0000c020: 6175 746f 636f 6e66 294d 3420 5175 6f74 autoconf)M4 Quot │ │ │ │ │ -0000c030: 6174 696f 6e3a 3a29 2e0a 0a20 2020 4865 ation::)... He │ │ │ │ │ -0000c040: 7265 2069 7320 616e 2065 7861 6d70 6c65 re is an example │ │ │ │ │ -0000c050: 206f 6620 686f 7720 746f 2064 6566 696e of how to defin │ │ │ │ │ -0000c060: 6520 6120 636f 6e64 6974 696f 6e61 6c20 e a conditional │ │ │ │ │ -0000c070: 636f 6e66 6967 2066 696c 653a 0a0a 2020 config file:.. │ │ │ │ │ -0000c080: 2020 2041 4d5f 434f 4e44 4954 494f 4e41 AM_CONDITIONA │ │ │ │ │ -0000c090: 4c28 5b53 4845 4c4c 5f57 5241 5050 4552 L([SHELL_WRAPPER │ │ │ │ │ -0000c0a0: 5d2c 205b 7465 7374 2022 7824 7769 7468 ], [test "x$with │ │ │ │ │ -0000c0b0: 5f77 7261 7070 6572 2220 3d20 7874 7275 _wrapper" = xtru │ │ │ │ │ -0000c0c0: 655d 290a 2020 2020 2041 4d5f 434f 4e44 e]). AM_COND │ │ │ │ │ -0000c0d0: 5f49 4628 5b53 4845 4c4c 5f57 5241 5050 _IF([SHELL_WRAPP │ │ │ │ │ -0000c0e0: 4552 5d2c 0a20 2020 2020 2020 2020 2020 ER],. │ │ │ │ │ -0000c0f0: 2020 2020 205b 4143 5f43 4f4e 4649 475f [AC_CONFIG_ │ │ │ │ │ -0000c100: 4649 4c45 5328 5b77 7261 7070 6572 3a77 FILES([wrapper:w │ │ │ │ │ -0000c110: 7261 7070 6572 2e69 6e5d 295d 290a 0a1f rapper.in])])... │ │ │ │ │ -0000c120: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -0000c130: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -0000c140: 3a20 4c69 6d69 7473 206f 6620 436f 6e64 : Limits of Cond │ │ │ │ │ -0000c150: 6974 696f 6e61 6c73 2c20 2050 7265 763a itionals, Prev: │ │ │ │ │ -0000c160: 2055 7361 6765 206f 6620 436f 6e64 6974 Usage of Condit │ │ │ │ │ -0000c170: 696f 6e61 6c73 2c20 2055 703a 2043 6f6e ionals, Up: Con │ │ │ │ │ -0000c180: 6469 7469 6f6e 616c 730a 0a32 302e 3220 ditionals..20.2 │ │ │ │ │ -0000c190: 4c69 6d69 7473 206f 6620 436f 6e64 6974 Limits of Condit │ │ │ │ │ -0000c1a0: 696f 6e61 6c73 0a3d 3d3d 3d3d 3d3d 3d3d ionals.========= │ │ │ │ │ +0000ab10: 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 7574 6f6d =========..Autom │ │ │ │ │ +0000ab20: 616b 6520 7573 6564 2074 6f20 7375 7070 ake used to supp │ │ │ │ │ +0000ab30: 6f72 7420 616e 206f 6273 6375 7265 2066 ort an obscure f │ │ │ │ │ +0000ab40: 6561 7475 7265 2063 616c 6c65 6420 6d75 eature called mu │ │ │ │ │ +0000ab50: 6c74 696c 6962 732e 2020 5f54 6869 730a ltilibs. _This. │ │ │ │ │ +0000ab60: 6665 6174 7572 6520 6973 206e 6f77 2064 feature is now d │ │ │ │ │ +0000ab70: 6570 7265 6361 7465 642c 2061 6e64 2077 eprecated, and w │ │ │ │ │ +0000ab80: 696c 6c20 6265 2072 656d 6f76 6564 2069 ill be removed i │ │ │ │ │ +0000ab90: 6e20 7468 6520 6e65 7874 206d 616a 6f72 n the next major │ │ │ │ │ +0000aba0: 0a41 7574 6f6d 616b 6520 7665 7273 696f .Automake versio │ │ │ │ │ +0000abb0: 6e5f 2e20 2053 7469 6c6c 2c20 6974 7320 n_. Still, its │ │ │ │ │ +0000abc0: 696d 706c 656d 656e 7461 7469 6f6e 2077 implementation w │ │ │ │ │ +0000abd0: 696c 6c20 7265 6d61 696e 2061 7661 696c ill remain avail │ │ │ │ │ +0000abe0: 6162 6c65 2069 6e0a 7468 6520 2763 6f6e able in.the 'con │ │ │ │ │ +0000abf0: 7472 6962 2f27 2064 6972 6563 746f 7279 trib/' directory │ │ │ │ │ +0000ac00: 206f 6620 7468 6520 4175 746f 6d61 6b65 of the Automake │ │ │ │ │ +0000ac10: 2064 6973 7472 6962 7574 696f 6e2c 2073 distribution, s │ │ │ │ │ +0000ac20: 6f20 6974 2073 686f 756c 6420 6265 0a76 o it should be.v │ │ │ │ │ +0000ac30: 6572 7920 6561 7379 2066 6f72 206d 6f74 ery easy for mot │ │ │ │ │ +0000ac40: 6976 6174 6564 2075 7365 7273 2074 6f20 ivated users to │ │ │ │ │ +0000ac50: 636f 6e74 696e 7565 2074 6f20 7573 6520 continue to use │ │ │ │ │ +0000ac60: 6974 2069 6e20 7468 6569 7220 7072 6f6a it in their proj │ │ │ │ │ +0000ac70: 6563 7473 2c0a 6966 2074 6865 7920 7265 ects,.if they re │ │ │ │ │ +0000ac80: 616c 6c79 206e 6565 6420 746f 2e0a 0a20 ally need to... │ │ │ │ │ +0000ac90: 2020 4120 226d 756c 7469 6c69 6222 2069 A "multilib" i │ │ │ │ │ +0000aca0: 7320 6120 6c69 6272 6172 7920 7468 6174 s a library that │ │ │ │ │ +0000acb0: 2069 7320 6275 696c 7420 666f 7220 6d75 is built for mu │ │ │ │ │ +0000acc0: 6c74 6970 6c65 2064 6966 6665 7265 6e74 ltiple different │ │ │ │ │ +0000acd0: 2041 4249 730a 6174 2061 2073 696e 676c ABIs.at a singl │ │ │ │ │ +0000ace0: 6520 7469 6d65 3b20 6561 6368 2074 696d e time; each tim │ │ │ │ │ +0000acf0: 6520 7468 6520 6c69 6272 6172 7920 6973 e the library is │ │ │ │ │ +0000ad00: 2062 7569 6c74 2077 6974 6820 6120 6469 built with a di │ │ │ │ │ +0000ad10: 6666 6572 656e 7420 7461 7267 6574 0a66 fferent target.f │ │ │ │ │ +0000ad20: 6c61 6720 636f 6d62 696e 6174 696f 6e2e lag combination. │ │ │ │ │ +0000ad30: 2020 5468 6973 2069 7320 6f6e 6c79 2075 This is only u │ │ │ │ │ +0000ad40: 7365 6675 6c20 7768 656e 2074 6865 206c seful when the l │ │ │ │ │ +0000ad50: 6962 7261 7279 2069 7320 696e 7465 6e64 ibrary is intend │ │ │ │ │ +0000ad60: 6564 2074 6f0a 6265 2063 726f 7373 2d63 ed to.be cross-c │ │ │ │ │ +0000ad70: 6f6d 7069 6c65 642c 2061 6e64 2069 7420 ompiled, and it │ │ │ │ │ +0000ad80: 6973 2061 6c6d 6f73 7420 6578 636c 7573 is almost exclus │ │ │ │ │ +0000ad90: 6976 656c 7920 7573 6564 2066 6f72 2063 ively used for c │ │ │ │ │ +0000ada0: 6f6d 7069 6c65 720a 7375 7070 6f72 7420 ompiler.support │ │ │ │ │ +0000adb0: 6c69 6272 6172 6965 732e 0a0a 1f0a 4669 libraries.....Fi │ │ │ │ │ +0000adc0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +0000add0: 312e 696e 666f 2c20 204e 6f64 653a 2049 1.info, Node: I │ │ │ │ │ +0000ade0: 6e63 6c75 6465 2c20 204e 6578 743a 2043 nclude, Next: C │ │ │ │ │ +0000adf0: 6f6e 6469 7469 6f6e 616c 732c 2020 5072 onditionals, Pr │ │ │ │ │ +0000ae00: 6576 3a20 4d69 7363 656c 6c61 6e65 6f75 ev: Miscellaneou │ │ │ │ │ +0000ae10: 732c 2020 5570 3a20 546f 700a 0a31 3920 s, Up: Top..19 │ │ │ │ │ +0000ae20: 496e 636c 7564 650a 2a2a 2a2a 2a2a 2a2a Include.******** │ │ │ │ │ +0000ae30: 2a2a 0a0a 4175 746f 6d61 6b65 2073 7570 **..Automake sup │ │ │ │ │ +0000ae40: 706f 7274 7320 616e 2027 696e 636c 7564 ports an 'includ │ │ │ │ │ +0000ae50: 6527 2064 6972 6563 7469 7665 2074 6861 e' directive tha │ │ │ │ │ +0000ae60: 7420 6361 6e20 6265 2075 7365 6420 746f t can be used to │ │ │ │ │ +0000ae70: 2069 6e63 6c75 6465 0a6f 7468 6572 2027 include.other ' │ │ │ │ │ +0000ae80: 4d61 6b65 6669 6c65 2720 6672 6167 6d65 Makefile' fragme │ │ │ │ │ +0000ae90: 6e74 7320 7768 656e 2027 6175 746f 6d61 nts when 'automa │ │ │ │ │ +0000aea0: 6b65 2720 6973 2072 756e 2e20 204e 6f74 ke' is run. Not │ │ │ │ │ +0000aeb0: 6520 7468 6174 2074 6865 7365 0a66 7261 e that these.fra │ │ │ │ │ +0000aec0: 676d 656e 7473 2061 7265 2072 6561 6420 gments are read │ │ │ │ │ +0000aed0: 616e 6420 696e 7465 7270 7265 7465 6420 and interpreted │ │ │ │ │ +0000aee0: 6279 2027 6175 746f 6d61 6b65 272c 206e by 'automake', n │ │ │ │ │ +0000aef0: 6f74 2062 7920 276d 616b 6527 2e20 2041 ot by 'make'. A │ │ │ │ │ +0000af00: 730a 7769 7468 2063 6f6e 6469 7469 6f6e s.with condition │ │ │ │ │ +0000af10: 616c 732c 2027 6d61 6b65 2720 6861 7320 als, 'make' has │ │ │ │ │ +0000af20: 6e6f 2069 6465 6120 7468 6174 2027 696e no idea that 'in │ │ │ │ │ +0000af30: 636c 7564 6527 2069 7320 696e 2075 7365 clude' is in use │ │ │ │ │ +0000af40: 2e0a 0a20 2020 5468 6572 6520 6172 6520 ... There are │ │ │ │ │ +0000af50: 7477 6f20 666f 726d 7320 6f66 2027 696e two forms of 'in │ │ │ │ │ +0000af60: 636c 7564 6527 3a0a 0a27 696e 636c 7564 clude':..'includ │ │ │ │ │ +0000af70: 6520 2428 7372 6364 6972 292f 6669 6c65 e $(srcdir)/file │ │ │ │ │ +0000af80: 270a 2020 2020 2049 6e63 6c75 6465 2061 '. Include a │ │ │ │ │ +0000af90: 2066 7261 676d 656e 7420 7468 6174 2069 fragment that i │ │ │ │ │ +0000afa0: 7320 666f 756e 6420 7265 6c61 7469 7665 s found relative │ │ │ │ │ +0000afb0: 2074 6f20 7468 6520 6375 7272 656e 7420 to the current │ │ │ │ │ +0000afc0: 736f 7572 6365 0a20 2020 2020 6469 7265 source. dire │ │ │ │ │ +0000afd0: 6374 6f72 792e 0a0a 2769 6e63 6c75 6465 ctory...'include │ │ │ │ │ +0000afe0: 2024 2874 6f70 5f73 7263 6469 7229 2f66 $(top_srcdir)/f │ │ │ │ │ +0000aff0: 696c 6527 0a20 2020 2020 496e 636c 7564 ile'. Includ │ │ │ │ │ +0000b000: 6520 6120 6672 6167 6d65 6e74 2074 6861 e a fragment tha │ │ │ │ │ +0000b010: 7420 6973 2066 6f75 6e64 2072 656c 6174 t is found relat │ │ │ │ │ +0000b020: 6976 6520 746f 2074 6865 2074 6f70 2073 ive to the top s │ │ │ │ │ +0000b030: 6f75 7263 650a 2020 2020 2064 6972 6563 ource. direc │ │ │ │ │ +0000b040: 746f 7279 2e0a 0a20 2020 4e6f 7465 2074 tory... Note t │ │ │ │ │ +0000b050: 6861 7420 6966 2061 2066 7261 676d 656e hat if a fragmen │ │ │ │ │ +0000b060: 7420 6973 2069 6e63 6c75 6465 6420 696e t is included in │ │ │ │ │ +0000b070: 7369 6465 2061 2063 6f6e 6469 7469 6f6e side a condition │ │ │ │ │ +0000b080: 616c 2c20 7468 656e 2074 6865 0a63 6f6e al, then the.con │ │ │ │ │ +0000b090: 6469 7469 6f6e 2061 7070 6c69 6573 2074 dition applies t │ │ │ │ │ +0000b0a0: 6f20 7468 6520 656e 7469 7265 2063 6f6e o the entire con │ │ │ │ │ +0000b0b0: 7465 6e74 7320 6f66 2074 6861 7420 6672 tents of that fr │ │ │ │ │ +0000b0c0: 6167 6d65 6e74 2e0a 0a20 2020 4d61 6b65 agment... Make │ │ │ │ │ +0000b0d0: 6669 6c65 2066 7261 676d 656e 7473 2069 file fragments i │ │ │ │ │ +0000b0e0: 6e63 6c75 6465 6420 7468 6973 2077 6179 ncluded this way │ │ │ │ │ +0000b0f0: 2061 7265 2061 6c77 6179 7320 6469 7374 are always dist │ │ │ │ │ +0000b100: 7269 6275 7465 6420 6265 6361 7573 650a ributed because. │ │ │ │ │ +0000b110: 7468 6579 2061 7265 206e 6565 6465 6420 they are needed │ │ │ │ │ +0000b120: 746f 2072 6562 7569 6c64 2027 4d61 6b65 to rebuild 'Make │ │ │ │ │ +0000b130: 6669 6c65 2e69 6e27 2e0a 0a1f 0a46 696c file.in'.....Fil │ │ │ │ │ +0000b140: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ +0000b150: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 436f .info, Node: Co │ │ │ │ │ +0000b160: 6e64 6974 696f 6e61 6c73 2c20 204e 6578 nditionals, Nex │ │ │ │ │ +0000b170: 743a 2053 696c 656e 6369 6e67 204d 616b t: Silencing Mak │ │ │ │ │ +0000b180: 652c 2020 5072 6576 3a20 496e 636c 7564 e, Prev: Includ │ │ │ │ │ +0000b190: 652c 2020 5570 3a20 546f 700a 0a32 3020 e, Up: Top..20 │ │ │ │ │ +0000b1a0: 436f 6e64 6974 696f 6e61 6c73 0a2a 2a2a Conditionals.*** │ │ │ │ │ +0000b1b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4175 ************..Au │ │ │ │ │ +0000b1c0: 746f 6d61 6b65 2073 7570 706f 7274 7320 tomake supports │ │ │ │ │ +0000b1d0: 6120 7369 6d70 6c65 2074 7970 6520 6f66 a simple type of │ │ │ │ │ +0000b1e0: 2063 6f6e 6469 7469 6f6e 616c 732e 0a0a conditionals... │ │ │ │ │ +0000b1f0: 2020 2054 6865 7365 2063 6f6e 6469 7469 These conditi │ │ │ │ │ +0000b200: 6f6e 616c 7320 6172 6520 6e6f 7420 7468 onals are not th │ │ │ │ │ +0000b210: 6520 7361 6d65 2061 7320 636f 6e64 6974 e same as condit │ │ │ │ │ +0000b220: 696f 6e61 6c73 2069 6e20 474e 5520 4d61 ionals in GNU Ma │ │ │ │ │ +0000b230: 6b65 2e0a 4175 746f 6d61 6b65 2063 6f6e ke..Automake con │ │ │ │ │ +0000b240: 6469 7469 6f6e 616c 7320 6172 6520 6368 ditionals are ch │ │ │ │ │ +0000b250: 6563 6b65 6420 6174 2063 6f6e 6669 6775 ecked at configu │ │ │ │ │ +0000b260: 7265 2074 696d 6520 6279 2074 6865 2027 re time by the ' │ │ │ │ │ +0000b270: 636f 6e66 6967 7572 6527 0a73 6372 6970 configure'.scrip │ │ │ │ │ +0000b280: 742c 2061 6e64 2061 6666 6563 7420 7468 t, and affect th │ │ │ │ │ +0000b290: 6520 7472 616e 736c 6174 696f 6e20 6672 e translation fr │ │ │ │ │ +0000b2a0: 6f6d 2027 4d61 6b65 6669 6c65 2e69 6e27 om 'Makefile.in' │ │ │ │ │ +0000b2b0: 2074 6f20 274d 616b 6566 696c 6527 2e0a to 'Makefile'.. │ │ │ │ │ +0000b2c0: 5468 6579 2061 7265 2062 6173 6564 206f They are based o │ │ │ │ │ +0000b2d0: 6e20 6f70 7469 6f6e 7320 7061 7373 6564 n options passed │ │ │ │ │ +0000b2e0: 2074 6f20 2763 6f6e 6669 6775 7265 2720 to 'configure' │ │ │ │ │ +0000b2f0: 616e 6420 6f6e 2072 6573 756c 7473 2074 and on results t │ │ │ │ │ +0000b300: 6861 740a 2763 6f6e 6669 6775 7265 2720 hat.'configure' │ │ │ │ │ +0000b310: 6861 7320 6469 7363 6f76 6572 6564 2061 has discovered a │ │ │ │ │ +0000b320: 626f 7574 2074 6865 2068 6f73 7420 7379 bout the host sy │ │ │ │ │ +0000b330: 7374 656d 2e20 2047 4e55 204d 616b 6520 stem. GNU Make │ │ │ │ │ +0000b340: 636f 6e64 6974 696f 6e61 6c73 0a61 7265 conditionals.are │ │ │ │ │ +0000b350: 2063 6865 636b 6564 2061 7420 276d 616b checked at 'mak │ │ │ │ │ +0000b360: 6527 2074 696d 652c 2061 6e64 2061 7265 e' time, and are │ │ │ │ │ +0000b370: 2062 6173 6564 206f 6e20 7661 7269 6162 based on variab │ │ │ │ │ +0000b380: 6c65 7320 7061 7373 6564 2074 6f20 7468 les passed to th │ │ │ │ │ +0000b390: 650a 6d61 6b65 2070 726f 6772 616d 206f e.make program o │ │ │ │ │ +0000b3a0: 7220 6465 6669 6e65 6420 696e 2074 6865 r defined in the │ │ │ │ │ +0000b3b0: 2027 4d61 6b65 6669 6c65 272e 0a0a 2020 'Makefile'... │ │ │ │ │ +0000b3c0: 2041 7574 6f6d 616b 6520 636f 6e64 6974 Automake condit │ │ │ │ │ +0000b3d0: 696f 6e61 6c73 2077 696c 6c20 776f 726b ionals will work │ │ │ │ │ +0000b3e0: 2077 6974 6820 616e 7920 6d61 6b65 2070 with any make p │ │ │ │ │ +0000b3f0: 726f 6772 616d 2e0a 0a2a 204d 656e 753a rogram...* Menu: │ │ │ │ │ +0000b400: 0a0a 2a20 5573 6167 6520 6f66 2043 6f6e ..* Usage of Con │ │ │ │ │ +0000b410: 6469 7469 6f6e 616c 733a 3a20 2020 2020 ditionals:: │ │ │ │ │ +0000b420: 2020 4465 636c 6172 696e 6720 636f 6e64 Declaring cond │ │ │ │ │ +0000b430: 6974 696f 6e61 6c20 636f 6e74 656e 740a itional content. │ │ │ │ │ +0000b440: 2a20 4c69 6d69 7473 206f 6620 436f 6e64 * Limits of Cond │ │ │ │ │ +0000b450: 6974 696f 6e61 6c73 3a3a 2020 2020 2020 itionals:: │ │ │ │ │ +0000b460: 456e 636c 6f73 696e 6720 636f 6d70 6c65 Enclosing comple │ │ │ │ │ +0000b470: 7465 2073 7461 7465 6d65 6e74 730a 0a1f te statements... │ │ │ │ │ +0000b480: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ +0000b490: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ +0000b4a0: 3a20 5573 6167 6520 6f66 2043 6f6e 6469 : Usage of Condi │ │ │ │ │ +0000b4b0: 7469 6f6e 616c 732c 2020 4e65 7874 3a20 tionals, Next: │ │ │ │ │ +0000b4c0: 4c69 6d69 7473 206f 6620 436f 6e64 6974 Limits of Condit │ │ │ │ │ +0000b4d0: 696f 6e61 6c73 2c20 2055 703a 2043 6f6e ionals, Up: Con │ │ │ │ │ +0000b4e0: 6469 7469 6f6e 616c 730a 0a32 302e 3120 ditionals..20.1 │ │ │ │ │ +0000b4f0: 5573 6167 6520 6f66 2043 6f6e 6469 7469 Usage of Conditi │ │ │ │ │ +0000b500: 6f6e 616c 730a 3d3d 3d3d 3d3d 3d3d 3d3d onals.========== │ │ │ │ │ +0000b510: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0000b520: 0a0a 4265 666f 7265 2075 7369 6e67 2061 ..Before using a │ │ │ │ │ +0000b530: 2063 6f6e 6469 7469 6f6e 616c 2c20 796f conditional, yo │ │ │ │ │ +0000b540: 7520 6d75 7374 2064 6566 696e 6520 6974 u must define it │ │ │ │ │ +0000b550: 2062 7920 7573 696e 6720 2741 4d5f 434f by using 'AM_CO │ │ │ │ │ +0000b560: 4e44 4954 494f 4e41 4c27 0a69 6e20 7468 NDITIONAL'.in th │ │ │ │ │ +0000b570: 6520 2763 6f6e 6669 6775 7265 2e61 6327 e 'configure.ac' │ │ │ │ │ +0000b580: 2066 696c 6520 282a 6e6f 7465 204d 6163 file (*note Mac │ │ │ │ │ +0000b590: 726f 733a 3a29 2e0a 0a20 2d2d 204d 6163 ros::)... -- Mac │ │ │ │ │ +0000b5a0: 726f 3a20 414d 5f43 4f4e 4449 5449 4f4e ro: AM_CONDITION │ │ │ │ │ +0000b5b0: 414c 2028 434f 4e44 4954 494f 4e41 4c2c AL (CONDITIONAL, │ │ │ │ │ +0000b5c0: 2043 4f4e 4449 5449 4f4e 290a 2020 2020 CONDITION). │ │ │ │ │ +0000b5d0: 2054 6865 2063 6f6e 6469 7469 6f6e 616c The conditional │ │ │ │ │ +0000b5e0: 206e 616d 652c 2043 4f4e 4449 5449 4f4e name, CONDITION │ │ │ │ │ +0000b5f0: 414c 2c20 7368 6f75 6c64 2062 6520 6120 AL, should be a │ │ │ │ │ +0000b600: 7369 6d70 6c65 2073 7472 696e 670a 2020 simple string. │ │ │ │ │ +0000b610: 2020 2073 7461 7274 696e 6720 7769 7468 starting with │ │ │ │ │ +0000b620: 2061 206c 6574 7465 7220 616e 6420 636f a letter and co │ │ │ │ │ +0000b630: 6e74 6169 6e69 6e67 206f 6e6c 7920 6c65 ntaining only le │ │ │ │ │ +0000b640: 7474 6572 732c 2064 6967 6974 732c 2061 tters, digits, a │ │ │ │ │ +0000b650: 6e64 0a20 2020 2020 756e 6465 7273 636f nd. undersco │ │ │ │ │ +0000b660: 7265 732e 2020 4974 206d 7573 7420 6265 res. It must be │ │ │ │ │ +0000b670: 2064 6966 6665 7265 6e74 2066 726f 6d20 different from │ │ │ │ │ +0000b680: 2754 5255 4527 2061 6e64 2027 4641 4c53 'TRUE' and 'FALS │ │ │ │ │ +0000b690: 4527 2074 6861 7420 6172 650a 2020 2020 E' that are. │ │ │ │ │ +0000b6a0: 2072 6573 6572 7665 6420 6279 2041 7574 reserved by Aut │ │ │ │ │ +0000b6b0: 6f6d 616b 652e 0a0a 2020 2020 2054 6865 omake... The │ │ │ │ │ +0000b6c0: 2073 6865 6c6c 2043 4f4e 4449 5449 4f4e shell CONDITION │ │ │ │ │ +0000b6d0: 2028 7375 6974 6162 6c65 2066 6f72 2075 (suitable for u │ │ │ │ │ +0000b6e0: 7365 2069 6e20 6120 7368 656c 6c20 2769 se in a shell 'i │ │ │ │ │ +0000b6f0: 6627 2073 7461 7465 6d65 6e74 2920 6973 f' statement) is │ │ │ │ │ +0000b700: 0a20 2020 2020 6576 616c 7561 7465 6420 . evaluated │ │ │ │ │ +0000b710: 7768 656e 2027 636f 6e66 6967 7572 6527 when 'configure' │ │ │ │ │ +0000b720: 2069 7320 7275 6e2e 2020 4e6f 7465 2074 is run. Note t │ │ │ │ │ +0000b730: 6861 7420 796f 7520 6d75 7374 2061 7272 hat you must arr │ │ │ │ │ +0000b740: 616e 6765 2066 6f72 0a20 2020 2020 5f65 ange for. _e │ │ │ │ │ +0000b750: 7665 7279 5f20 2741 4d5f 434f 4e44 4954 very_ 'AM_CONDIT │ │ │ │ │ +0000b760: 494f 4e41 4c27 2074 6f20 6265 2069 6e76 IONAL' to be inv │ │ │ │ │ +0000b770: 6f6b 6564 2065 7665 7279 2074 696d 6520 oked every time │ │ │ │ │ +0000b780: 2763 6f6e 6669 6775 7265 2720 6973 0a20 'configure' is. │ │ │ │ │ +0000b790: 2020 2020 7275 6e2e 2020 4966 2027 414d run. If 'AM │ │ │ │ │ +0000b7a0: 5f43 4f4e 4449 5449 4f4e 414c 2720 6973 _CONDITIONAL' is │ │ │ │ │ +0000b7b0: 2072 756e 2063 6f6e 6469 7469 6f6e 616c run conditional │ │ │ │ │ +0000b7c0: 6c79 2028 652e 672e 2c20 696e 2061 2073 ly (e.g., in a s │ │ │ │ │ +0000b7d0: 6865 6c6c 0a20 2020 2020 2769 6627 2073 hell. 'if' s │ │ │ │ │ +0000b7e0: 7461 7465 6d65 6e74 292c 2074 6865 6e20 tatement), then │ │ │ │ │ +0000b7f0: 7468 6520 7265 7375 6c74 2077 696c 6c20 the result will │ │ │ │ │ +0000b800: 636f 6e66 7573 6520 2761 7574 6f6d 616b confuse 'automak │ │ │ │ │ +0000b810: 6527 2e0a 0a20 2020 436f 6e64 6974 696f e'... Conditio │ │ │ │ │ +0000b820: 6e61 6c73 2074 7970 6963 616c 6c79 2064 nals typically d │ │ │ │ │ +0000b830: 6570 656e 6420 7570 6f6e 206f 7074 696f epend upon optio │ │ │ │ │ +0000b840: 6e73 2074 6861 7420 7468 6520 7573 6572 ns that the user │ │ │ │ │ +0000b850: 2070 726f 7669 6465 7320 746f 0a74 6865 provides to.the │ │ │ │ │ +0000b860: 2027 636f 6e66 6967 7572 6527 2073 6372 'configure' scr │ │ │ │ │ +0000b870: 6970 742e 2020 4865 7265 2069 7320 616e ipt. Here is an │ │ │ │ │ +0000b880: 2065 7861 6d70 6c65 206f 6620 686f 7720 example of how │ │ │ │ │ +0000b890: 746f 2077 7269 7465 2061 0a63 6f6e 6469 to write a.condi │ │ │ │ │ +0000b8a0: 7469 6f6e 616c 2074 6861 7420 6973 2074 tional that is t │ │ │ │ │ +0000b8b0: 7275 6520 6966 2074 6865 2075 7365 7220 rue if the user │ │ │ │ │ +0000b8c0: 7573 6573 2074 6865 2027 2d2d 656e 6162 uses the '--enab │ │ │ │ │ +0000b8d0: 6c65 2d64 6562 7567 2720 6f70 7469 6f6e le-debug' option │ │ │ │ │ +0000b8e0: 2e0a 0a20 2020 2020 4143 5f41 5247 5f45 ... AC_ARG_E │ │ │ │ │ +0000b8f0: 4e41 424c 4528 5b64 6562 7567 5d2c 0a20 NABLE([debug],. │ │ │ │ │ +0000b900: 2020 2020 5b20 202d 2d65 6e61 626c 652d [ --enable- │ │ │ │ │ +0000b910: 6465 6275 6720 2020 2054 7572 6e20 6f6e debug Turn on │ │ │ │ │ +0000b920: 2064 6562 7567 6769 6e67 5d2c 0a20 2020 debugging],. │ │ │ │ │ +0000b930: 2020 5b63 6173 6520 2224 7b65 6e61 626c [case "${enabl │ │ │ │ │ +0000b940: 6576 616c 7d22 2069 6e0a 2020 2020 2020 eval}" in. │ │ │ │ │ +0000b950: 2079 6573 2920 6465 6275 673d 7472 7565 yes) debug=true │ │ │ │ │ +0000b960: 203b 3b0a 2020 2020 2020 206e 6f29 2020 ;;. no) │ │ │ │ │ +0000b970: 6465 6275 673d 6661 6c73 6520 3b3b 0a20 debug=false ;;. │ │ │ │ │ +0000b980: 2020 2020 2020 2a29 2041 435f 4d53 475f *) AC_MSG_ │ │ │ │ │ +0000b990: 4552 524f 5228 5b62 6164 2076 616c 7565 ERROR([bad value │ │ │ │ │ +0000b9a0: 2024 7b65 6e61 626c 6576 616c 7d20 666f ${enableval} fo │ │ │ │ │ +0000b9b0: 7220 2d2d 656e 6162 6c65 2d64 6562 7567 r --enable-debug │ │ │ │ │ +0000b9c0: 5d29 203b 3b0a 2020 2020 2065 7361 635d ]) ;;. esac] │ │ │ │ │ +0000b9d0: 2c5b 6465 6275 673d 6661 6c73 655d 290a ,[debug=false]). │ │ │ │ │ +0000b9e0: 2020 2020 2041 4d5f 434f 4e44 4954 494f AM_CONDITIO │ │ │ │ │ +0000b9f0: 4e41 4c28 5b44 4542 5547 5d2c 205b 7465 NAL([DEBUG], [te │ │ │ │ │ +0000ba00: 7374 2078 2464 6562 7567 203d 2078 7472 st x$debug = xtr │ │ │ │ │ +0000ba10: 7565 5d29 0a0a 2020 2048 6572 6520 6973 ue]).. Here is │ │ │ │ │ +0000ba20: 2061 6e20 6578 616d 706c 6520 6f66 2068 an example of h │ │ │ │ │ +0000ba30: 6f77 2074 6f20 7573 6520 7468 6174 2063 ow to use that c │ │ │ │ │ +0000ba40: 6f6e 6469 7469 6f6e 616c 2069 6e20 274d onditional in 'M │ │ │ │ │ +0000ba50: 616b 6566 696c 652e 616d 273a 0a0a 2020 akefile.am':.. │ │ │ │ │ +0000ba60: 2020 2069 6620 4445 4255 470a 2020 2020 if DEBUG. │ │ │ │ │ +0000ba70: 2044 4247 203d 2064 6562 7567 0a20 2020 DBG = debug. │ │ │ │ │ +0000ba80: 2020 656c 7365 0a20 2020 2020 4442 4720 else. DBG │ │ │ │ │ +0000ba90: 3d0a 2020 2020 2065 6e64 6966 0a20 2020 =. endif. │ │ │ │ │ +0000baa0: 2020 6e6f 696e 7374 5f50 524f 4752 414d noinst_PROGRAM │ │ │ │ │ +0000bab0: 5320 3d20 2428 4442 4729 0a0a 2020 2054 S = $(DBG).. T │ │ │ │ │ +0000bac0: 6869 7320 7472 6976 6961 6c20 6578 616d his trivial exam │ │ │ │ │ +0000bad0: 706c 6520 636f 756c 6420 616c 736f 2062 ple could also b │ │ │ │ │ +0000bae0: 6520 6861 6e64 6c65 6420 7573 696e 6720 e handled using │ │ │ │ │ +0000baf0: 2745 5854 5241 5f50 524f 4752 414d 5327 'EXTRA_PROGRAMS' │ │ │ │ │ +0000bb00: 0a28 2a6e 6f74 6520 436f 6e64 6974 696f .(*note Conditio │ │ │ │ │ +0000bb10: 6e61 6c20 5072 6f67 7261 6d73 3a3a 292e nal Programs::). │ │ │ │ │ +0000bb20: 0a0a 2020 2059 6f75 206d 6179 206f 6e6c .. You may onl │ │ │ │ │ +0000bb30: 7920 7465 7374 2061 2073 696e 676c 6520 y test a single │ │ │ │ │ +0000bb40: 7661 7269 6162 6c65 2069 6e20 616e 2027 variable in an ' │ │ │ │ │ +0000bb50: 6966 2720 7374 6174 656d 656e 742c 2070 if' statement, p │ │ │ │ │ +0000bb60: 6f73 7369 626c 790a 6e65 6761 7465 6420 ossibly.negated │ │ │ │ │ +0000bb70: 7573 696e 6720 2721 272e 2020 5468 6520 using '!'. The │ │ │ │ │ +0000bb80: 2765 6c73 6527 2073 7461 7465 6d65 6e74 'else' statement │ │ │ │ │ +0000bb90: 206d 6179 2062 6520 6f6d 6974 7465 642e may be omitted. │ │ │ │ │ +0000bba0: 2020 436f 6e64 6974 696f 6e61 6c73 0a6d Conditionals.m │ │ │ │ │ +0000bbb0: 6179 2062 6520 6e65 7374 6564 2074 6f20 ay be nested to │ │ │ │ │ +0000bbc0: 616e 7920 6465 7074 682e 2020 596f 7520 any depth. You │ │ │ │ │ +0000bbd0: 6d61 7920 7370 6563 6966 7920 616e 2061 may specify an a │ │ │ │ │ +0000bbe0: 7267 756d 656e 7420 746f 2027 656c 7365 rgument to 'else │ │ │ │ │ +0000bbf0: 2720 696e 0a77 6869 6368 2063 6173 6520 ' in.which case │ │ │ │ │ +0000bc00: 6974 206d 7573 7420 6265 2074 6865 206e it must be the n │ │ │ │ │ +0000bc10: 6567 6174 696f 6e20 6f66 2074 6865 2063 egation of the c │ │ │ │ │ +0000bc20: 6f6e 6469 7469 6f6e 2075 7365 6420 666f ondition used fo │ │ │ │ │ +0000bc30: 7220 7468 6520 6375 7272 656e 740a 2769 r the current.'i │ │ │ │ │ +0000bc40: 6627 2e20 2053 696d 696c 6172 6c79 2079 f'. Similarly y │ │ │ │ │ +0000bc50: 6f75 206d 6179 2073 7065 6369 6679 2074 ou may specify t │ │ │ │ │ +0000bc60: 6865 2063 6f6e 6469 7469 6f6e 2074 6861 he condition tha │ │ │ │ │ +0000bc70: 7420 6973 2063 6c6f 7365 6420 6f6e 2074 t is closed on t │ │ │ │ │ +0000bc80: 6865 0a27 656e 6469 6627 206c 696e 653a he.'endif' line: │ │ │ │ │ +0000bc90: 0a0a 2020 2020 2069 6620 4445 4255 470a .. if DEBUG. │ │ │ │ │ +0000bca0: 2020 2020 2044 4247 203d 2064 6562 7567 DBG = debug │ │ │ │ │ +0000bcb0: 0a20 2020 2020 656c 7365 2021 4445 4255 . else !DEBU │ │ │ │ │ +0000bcc0: 470a 2020 2020 2044 4247 203d 0a20 2020 G. DBG =. │ │ │ │ │ +0000bcd0: 2020 656e 6469 6620 2144 4542 5547 0a0a endif !DEBUG.. │ │ │ │ │ +0000bce0: 556e 6261 6c61 6e63 6564 2063 6f6e 6469 Unbalanced condi │ │ │ │ │ +0000bcf0: 7469 6f6e 7320 6172 6520 6572 726f 7273 tions are errors │ │ │ │ │ +0000bd00: 2e20 2054 6865 2027 6966 272c 2027 656c . The 'if', 'el │ │ │ │ │ +0000bd10: 7365 272c 2061 6e64 2027 656e 6469 6627 se', and 'endif' │ │ │ │ │ +0000bd20: 0a73 7461 7465 6d65 6e74 7320 7368 6f75 .statements shou │ │ │ │ │ +0000bd30: 6c64 206e 6f74 2062 6520 696e 6465 6e74 ld not be indent │ │ │ │ │ +0000bd40: 6564 2c20 692e 652e 2c20 7374 6172 7420 ed, i.e., start │ │ │ │ │ +0000bd50: 6f6e 2063 6f6c 756d 6e20 6f6e 652e 0a0a on column one... │ │ │ │ │ +0000bd60: 2020 2054 6865 2027 656c 7365 2720 6272 The 'else' br │ │ │ │ │ +0000bd70: 616e 6368 206f 6620 7468 6520 6162 6f76 anch of the abov │ │ │ │ │ +0000bd80: 6520 7477 6f20 6578 616d 706c 6573 2063 e two examples c │ │ │ │ │ +0000bd90: 6f75 6c64 2062 6520 6f6d 6974 7465 642c ould be omitted, │ │ │ │ │ +0000bda0: 2073 696e 6365 0a61 7373 6967 6e69 6e67 since.assigning │ │ │ │ │ +0000bdb0: 2074 6865 2065 6d70 7479 2073 7472 696e the empty strin │ │ │ │ │ +0000bdc0: 6720 746f 2061 6e20 6f74 6865 7277 6973 g to an otherwis │ │ │ │ │ +0000bdd0: 6520 756e 6465 6669 6e65 6420 7661 7269 e undefined vari │ │ │ │ │ +0000bde0: 6162 6c65 206d 616b 6573 206e 6f0a 6469 able makes no.di │ │ │ │ │ +0000bdf0: 6666 6572 656e 6365 2e0a 0a20 2020 496e fference... In │ │ │ │ │ +0000be00: 206f 7264 6572 2074 6f20 616c 6c6f 7720 order to allow │ │ │ │ │ +0000be10: 6163 6365 7373 2074 6f20 7468 6520 636f access to the co │ │ │ │ │ +0000be20: 6e64 6974 696f 6e20 7265 6769 7374 6572 ndition register │ │ │ │ │ +0000be30: 6564 2062 790a 2741 4d5f 434f 4e44 4954 ed by.'AM_CONDIT │ │ │ │ │ +0000be40: 494f 4e41 4c27 2069 6e73 6964 6520 2763 IONAL' inside 'c │ │ │ │ │ +0000be50: 6f6e 6669 6775 7265 2e61 6327 2c20 616e onfigure.ac', an │ │ │ │ │ +0000be60: 6420 746f 2061 6c6c 6f77 2063 6f6e 6469 d to allow condi │ │ │ │ │ +0000be70: 7469 6f6e 616c 0a27 4143 5f43 4f4e 4649 tional.'AC_CONFI │ │ │ │ │ +0000be80: 475f 4649 4c45 5327 2c20 2741 4d5f 434f G_FILES', 'AM_CO │ │ │ │ │ +0000be90: 4e44 5f49 4627 206d 6179 2062 6520 7573 ND_IF' may be us │ │ │ │ │ +0000bea0: 6564 3a0a 0a20 2d2d 204d 6163 726f 3a20 ed:.. -- Macro: │ │ │ │ │ +0000beb0: 414d 5f43 4f4e 445f 4946 2028 434f 4e44 AM_COND_IF (COND │ │ │ │ │ +0000bec0: 4954 494f 4e41 4c2c 205b 4946 2d54 5255 ITIONAL, [IF-TRU │ │ │ │ │ +0000bed0: 455d 2c20 5b49 462d 4641 4c53 455d 290a E], [IF-FALSE]). │ │ │ │ │ +0000bee0: 2020 2020 2049 6620 434f 4e44 4954 494f If CONDITIO │ │ │ │ │ +0000bef0: 4e41 4c20 6973 2066 756c 6669 6c6c 6564 NAL is fulfilled │ │ │ │ │ +0000bf00: 2c20 6578 6563 7574 6520 4946 2d54 5255 , execute IF-TRU │ │ │ │ │ +0000bf10: 452c 206f 7468 6572 7769 7365 2065 7865 E, otherwise exe │ │ │ │ │ +0000bf20: 6375 7465 0a20 2020 2020 4946 2d46 414c cute. IF-FAL │ │ │ │ │ +0000bf30: 5345 2e20 2049 6620 6569 7468 6572 2062 SE. If either b │ │ │ │ │ +0000bf40: 7261 6e63 6820 636f 6e74 6169 6e73 2027 ranch contains ' │ │ │ │ │ +0000bf50: 4143 5f43 4f4e 4649 475f 4649 4c45 5327 AC_CONFIG_FILES' │ │ │ │ │ +0000bf60: 2c20 6974 2077 696c 6c0a 2020 2020 2063 , it will. c │ │ │ │ │ +0000bf70: 6175 7365 2027 6175 746f 6d61 6b65 2720 ause 'automake' │ │ │ │ │ +0000bf80: 746f 206f 7574 7075 7420 7468 6520 7275 to output the ru │ │ │ │ │ +0000bf90: 6c65 7320 666f 7220 7468 6520 7265 7370 les for the resp │ │ │ │ │ +0000bfa0: 6563 7469 7665 2066 696c 6573 206f 6e6c ective files onl │ │ │ │ │ +0000bfb0: 790a 2020 2020 2066 6f72 2074 6865 2067 y. for the g │ │ │ │ │ +0000bfc0: 6976 656e 2063 6f6e 6469 7469 6f6e 2e0a iven condition.. │ │ │ │ │ +0000bfd0: 0a20 2020 2741 4d5f 434f 4e44 5f49 4627 . 'AM_COND_IF' │ │ │ │ │ +0000bfe0: 206d 6163 726f 7320 6d61 7920 6265 206e macros may be n │ │ │ │ │ +0000bff0: 6573 7465 6420 7768 656e 206d 3420 7175 ested when m4 qu │ │ │ │ │ +0000c000: 6f74 6174 696f 6e20 6973 2075 7365 6420 otation is used │ │ │ │ │ +0000c010: 7072 6f70 6572 6c79 0a28 2a6e 6f74 6520 properly.(*note │ │ │ │ │ +0000c020: 2861 7574 6f63 6f6e 6629 4d34 2051 756f (autoconf)M4 Quo │ │ │ │ │ +0000c030: 7461 7469 6f6e 3a3a 292e 0a0a 2020 2048 tation::)... H │ │ │ │ │ +0000c040: 6572 6520 6973 2061 6e20 6578 616d 706c ere is an exampl │ │ │ │ │ +0000c050: 6520 6f66 2068 6f77 2074 6f20 6465 6669 e of how to defi │ │ │ │ │ +0000c060: 6e65 2061 2063 6f6e 6469 7469 6f6e 616c ne a conditional │ │ │ │ │ +0000c070: 2063 6f6e 6669 6720 6669 6c65 3a0a 0a20 config file:.. │ │ │ │ │ +0000c080: 2020 2020 414d 5f43 4f4e 4449 5449 4f4e AM_CONDITION │ │ │ │ │ +0000c090: 414c 285b 5348 454c 4c5f 5752 4150 5045 AL([SHELL_WRAPPE │ │ │ │ │ +0000c0a0: 525d 2c20 5b74 6573 7420 2278 2477 6974 R], [test "x$wit │ │ │ │ │ +0000c0b0: 685f 7772 6170 7065 7222 203d 2078 7472 h_wrapper" = xtr │ │ │ │ │ +0000c0c0: 7565 5d29 0a20 2020 2020 414d 5f43 4f4e ue]). AM_CON │ │ │ │ │ +0000c0d0: 445f 4946 285b 5348 454c 4c5f 5752 4150 D_IF([SHELL_WRAP │ │ │ │ │ +0000c0e0: 5045 525d 2c0a 2020 2020 2020 2020 2020 PER],. │ │ │ │ │ +0000c0f0: 2020 2020 2020 5b41 435f 434f 4e46 4947 [AC_CONFIG │ │ │ │ │ +0000c100: 5f46 494c 4553 285b 7772 6170 7065 723a _FILES([wrapper: │ │ │ │ │ +0000c110: 7772 6170 7065 722e 696e 5d29 5d29 0a0a wrapper.in])]).. │ │ │ │ │ +0000c120: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +0000c130: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +0000c140: 653a 204c 696d 6974 7320 6f66 2043 6f6e e: Limits of Con │ │ │ │ │ +0000c150: 6469 7469 6f6e 616c 732c 2020 5072 6576 ditionals, Prev │ │ │ │ │ +0000c160: 3a20 5573 6167 6520 6f66 2043 6f6e 6469 : Usage of Condi │ │ │ │ │ +0000c170: 7469 6f6e 616c 732c 2020 5570 3a20 436f tionals, Up: Co │ │ │ │ │ +0000c180: 6e64 6974 696f 6e61 6c73 0a0a 3230 2e32 nditionals..20.2 │ │ │ │ │ +0000c190: 204c 696d 6974 7320 6f66 2043 6f6e 6469 Limits of Condi │ │ │ │ │ +0000c1a0: 7469 6f6e 616c 730a 3d3d 3d3d 3d3d 3d3d tionals.======== │ │ │ │ │ 0000c1b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000c1c0: 3d3d 0a0a 436f 6e64 6974 696f 6e61 6c73 ==..Conditionals │ │ │ │ │ -0000c1d0: 2073 686f 756c 6420 656e 636c 6f73 6520 should enclose │ │ │ │ │ -0000c1e0: 636f 6d70 6c65 7465 2073 7461 7465 6d65 complete stateme │ │ │ │ │ -0000c1f0: 6e74 7320 6c69 6b65 2076 6172 6961 626c nts like variabl │ │ │ │ │ -0000c200: 6573 206f 7220 7275 6c65 730a 6465 6669 es or rules.defi │ │ │ │ │ -0000c210: 6e69 7469 6f6e 732e 2020 4175 746f 6d61 nitions. Automa │ │ │ │ │ -0000c220: 6b65 2063 616e 6e6f 7420 6465 616c 2077 ke cannot deal w │ │ │ │ │ -0000c230: 6974 6820 636f 6e64 6974 696f 6e61 6c73 ith conditionals │ │ │ │ │ -0000c240: 2075 7365 6420 696e 7369 6465 2061 0a76 used inside a.v │ │ │ │ │ -0000c250: 6172 6961 626c 6520 6465 6669 6e69 7469 ariable definiti │ │ │ │ │ -0000c260: 6f6e 2c20 666f 7220 696e 7374 616e 6365 on, for instance │ │ │ │ │ -0000c270: 2c20 616e 6420 6973 206e 6f74 2065 7665 , and is not eve │ │ │ │ │ -0000c280: 6e20 6162 6c65 2074 6f20 6469 6167 6e6f n able to diagno │ │ │ │ │ -0000c290: 7365 2074 6869 730a 7369 7475 6174 696f se this.situatio │ │ │ │ │ -0000c2a0: 6e2e 2020 5468 6520 666f 6c6c 6f77 696e n. The followin │ │ │ │ │ -0000c2b0: 6720 6578 616d 706c 6520 776f 756c 6420 g example would │ │ │ │ │ -0000c2c0: 6e6f 7420 776f 726b 3a0a 0a20 2020 2020 not work:.. │ │ │ │ │ -0000c2d0: 2320 5468 6973 2073 796e 7461 7820 6973 # This syntax is │ │ │ │ │ -0000c2e0: 206e 6f74 2075 6e64 6572 7374 6f6f 6420 not understood │ │ │ │ │ -0000c2f0: 6279 2041 7574 6f6d 616b 650a 2020 2020 by Automake. │ │ │ │ │ -0000c300: 2041 4d5f 4350 5046 4c41 4753 203d 205c AM_CPPFLAGS = \ │ │ │ │ │ -0000c310: 0a20 2020 2020 2020 2d44 4645 4154 5552 . -DFEATUR │ │ │ │ │ -0000c320: 455f 4120 5c0a 2020 2020 2069 6620 5741 E_A \. if WA │ │ │ │ │ -0000c330: 4e54 5f44 4542 5547 0a20 2020 2020 2020 NT_DEBUG. │ │ │ │ │ -0000c340: 2d44 4445 4255 4720 5c0a 2020 2020 2065 -DDEBUG \. e │ │ │ │ │ -0000c350: 6e64 6966 0a20 2020 2020 2020 2d44 4645 ndif. -DFE │ │ │ │ │ -0000c360: 4154 5552 455f 420a 0a20 2020 486f 7765 ATURE_B.. Howe │ │ │ │ │ -0000c370: 7665 7220 7468 6520 696e 7465 6e64 6564 ver the intended │ │ │ │ │ -0000c380: 2064 6566 696e 6974 696f 6e20 6f66 2027 definition of ' │ │ │ │ │ -0000c390: 414d 5f43 5050 464c 4147 5327 2063 616e AM_CPPFLAGS' can │ │ │ │ │ -0000c3a0: 2062 6520 6163 6869 6576 6564 2077 6974 be achieved wit │ │ │ │ │ -0000c3b0: 680a 0a20 2020 2020 6966 2057 414e 545f h.. if WANT_ │ │ │ │ │ -0000c3c0: 4445 4255 470a 2020 2020 2020 2044 4542 DEBUG. DEB │ │ │ │ │ -0000c3d0: 5547 464c 4147 5320 3d20 2d44 4445 4255 UGFLAGS = -DDEBU │ │ │ │ │ -0000c3e0: 470a 2020 2020 2065 6e64 6966 0a20 2020 G. endif. │ │ │ │ │ -0000c3f0: 2020 414d 5f43 5050 464c 4147 5320 3d20 AM_CPPFLAGS = │ │ │ │ │ -0000c400: 2d44 4645 4154 5552 455f 4120 2428 4445 -DFEATURE_A $(DE │ │ │ │ │ -0000c410: 4255 4746 4c41 4753 2920 2d44 4645 4154 BUGFLAGS) -DFEAT │ │ │ │ │ -0000c420: 5552 455f 420a 0a6f 720a 0a20 2020 2020 URE_B..or.. │ │ │ │ │ -0000c430: 414d 5f43 5050 464c 4147 5320 3d20 2d44 AM_CPPFLAGS = -D │ │ │ │ │ -0000c440: 4645 4154 5552 455f 410a 2020 2020 2069 FEATURE_A. i │ │ │ │ │ -0000c450: 6620 5741 4e54 5f44 4542 5547 0a20 2020 f WANT_DEBUG. │ │ │ │ │ -0000c460: 2020 414d 5f43 5050 464c 4147 5320 2b3d AM_CPPFLAGS += │ │ │ │ │ -0000c470: 202d 4444 4542 5547 0a20 2020 2020 656e -DDEBUG. en │ │ │ │ │ -0000c480: 6469 660a 2020 2020 2041 4d5f 4350 5046 dif. AM_CPPF │ │ │ │ │ -0000c490: 4c41 4753 202b 3d20 2d44 4645 4154 5552 LAGS += -DFEATUR │ │ │ │ │ -0000c4a0: 455f 420a 0a20 2020 4d6f 7265 2064 6574 E_B.. More det │ │ │ │ │ -0000c4b0: 6169 6c73 2061 6e64 2065 7861 6d70 6c65 ails and example │ │ │ │ │ -0000c4c0: 7320 6f66 2063 6f6e 6469 7469 6f6e 616c s of conditional │ │ │ │ │ -0000c4d0: 7320 6172 6520 6465 7363 7269 6265 6420 s are described │ │ │ │ │ -0000c4e0: 616c 6f6e 6773 6964 650a 7661 7269 6f75 alongside.variou │ │ │ │ │ -0000c4f0: 7320 4175 746f 6d61 6b65 2066 6561 7475 s Automake featu │ │ │ │ │ -0000c500: 7265 7320 696e 2074 6869 7320 6d61 6e75 res in this manu │ │ │ │ │ -0000c510: 616c 2028 2a6e 6f74 6520 436f 6e64 6974 al (*note Condit │ │ │ │ │ -0000c520: 696f 6e61 6c0a 5375 6264 6972 6563 746f ional.Subdirecto │ │ │ │ │ -0000c530: 7269 6573 3a3a 2c20 2a6e 6f74 6520 436f ries::, *note Co │ │ │ │ │ -0000c540: 6e64 6974 696f 6e61 6c20 536f 7572 6365 nditional Source │ │ │ │ │ -0000c550: 733a 3a2c 202a 6e6f 7465 2043 6f6e 6469 s::, *note Condi │ │ │ │ │ -0000c560: 7469 6f6e 616c 0a50 726f 6772 616d 733a tional.Programs: │ │ │ │ │ -0000c570: 3a2c 202a 6e6f 7465 2043 6f6e 6469 7469 :, *note Conditi │ │ │ │ │ -0000c580: 6f6e 616c 204c 6962 746f 6f6c 204c 6962 onal Libtool Lib │ │ │ │ │ -0000c590: 7261 7269 6573 3a3a 2c20 2a6e 6f74 6520 raries::, *note │ │ │ │ │ -0000c5a0: 436f 6e64 6974 696f 6e61 6c0a 4c69 6274 Conditional.Libt │ │ │ │ │ -0000c5b0: 6f6f 6c20 536f 7572 6365 733a 3a29 2e0a ool Sources::).. │ │ │ │ │ -0000c5c0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -0000c5d0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -0000c5e0: 6465 3a20 5369 6c65 6e63 696e 6720 4d61 de: Silencing Ma │ │ │ │ │ -0000c5f0: 6b65 2c20 204e 6578 743a 2047 6e69 7473 ke, Next: Gnits │ │ │ │ │ -0000c600: 2c20 2050 7265 763a 2043 6f6e 6469 7469 , Prev: Conditi │ │ │ │ │ -0000c610: 6f6e 616c 732c 2020 5570 3a20 546f 700a onals, Up: Top. │ │ │ │ │ -0000c620: 0a32 3120 5369 6c65 6e63 696e 6720 276d .21 Silencing 'm │ │ │ │ │ -0000c630: 616b 6527 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a ake'.*********** │ │ │ │ │ -0000c640: 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 ********..* Menu │ │ │ │ │ -0000c650: 3a0a 0a2a 204d 616b 6520 7665 7262 6f73 :..* Make verbos │ │ │ │ │ -0000c660: 6974 793a 3a20 2020 2020 2020 2020 2020 ity:: │ │ │ │ │ -0000c670: 2020 2020 4d61 6b65 2069 7320 7665 7262 Make is verb │ │ │ │ │ -0000c680: 6f73 6520 6279 2064 6566 6175 6c74 0a2a ose by default.* │ │ │ │ │ -0000c690: 2054 7269 636b 7320 466f 7220 5369 6c65 Tricks For Sile │ │ │ │ │ -0000c6a0: 6e63 696e 6720 4d61 6b65 3a3a 2020 2020 ncing Make:: │ │ │ │ │ -0000c6b0: 5374 616e 6461 7264 2061 6e64 2067 656e Standard and gen │ │ │ │ │ -0000c6c0: 6572 6963 2077 6179 7320 746f 2073 696c eric ways to sil │ │ │ │ │ -0000c6d0: 656e 6365 206d 616b 650a 2a20 4175 746f ence make.* Auto │ │ │ │ │ -0000c6e0: 6d61 6b65 2073 696c 656e 742d 7275 6c65 make silent-rule │ │ │ │ │ -0000c6f0: 7320 4f70 7469 6f6e 3a3a 2048 6f77 2041 s Option:: How A │ │ │ │ │ -0000c700: 7574 6f6d 616b 6520 6361 6e20 6865 6c70 utomake can help │ │ │ │ │ -0000c710: 2069 6e20 7369 6c65 6e63 696e 6720 6d61 in silencing ma │ │ │ │ │ -0000c720: 6b65 0a0a 1f0a 4669 6c65 3a20 6175 746f ke....File: auto │ │ │ │ │ -0000c730: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -0000c740: 204e 6f64 653a 204d 616b 6520 7665 7262 Node: Make verb │ │ │ │ │ -0000c750: 6f73 6974 792c 2020 4e65 7874 3a20 5472 osity, Next: Tr │ │ │ │ │ -0000c760: 6963 6b73 2046 6f72 2053 696c 656e 6369 icks For Silenci │ │ │ │ │ -0000c770: 6e67 204d 616b 652c 2020 5570 3a20 5369 ng Make, Up: Si │ │ │ │ │ -0000c780: 6c65 6e63 696e 6720 4d61 6b65 0a0a 3231 lencing Make..21 │ │ │ │ │ -0000c790: 2e31 204d 616b 6520 6973 2076 6572 626f .1 Make is verbo │ │ │ │ │ -0000c7a0: 7365 2062 7920 6465 6661 756c 740a 3d3d se by default.== │ │ │ │ │ +0000c1c0: 3d3d 3d0a 0a43 6f6e 6469 7469 6f6e 616c ===..Conditional │ │ │ │ │ +0000c1d0: 7320 7368 6f75 6c64 2065 6e63 6c6f 7365 s should enclose │ │ │ │ │ +0000c1e0: 2063 6f6d 706c 6574 6520 7374 6174 656d complete statem │ │ │ │ │ +0000c1f0: 656e 7473 206c 696b 6520 7661 7269 6162 ents like variab │ │ │ │ │ +0000c200: 6c65 7320 6f72 2072 756c 6573 0a64 6566 les or rules.def │ │ │ │ │ +0000c210: 696e 6974 696f 6e73 2e20 2041 7574 6f6d initions. Autom │ │ │ │ │ +0000c220: 616b 6520 6361 6e6e 6f74 2064 6561 6c20 ake cannot deal │ │ │ │ │ +0000c230: 7769 7468 2063 6f6e 6469 7469 6f6e 616c with conditional │ │ │ │ │ +0000c240: 7320 7573 6564 2069 6e73 6964 6520 610a s used inside a. │ │ │ │ │ +0000c250: 7661 7269 6162 6c65 2064 6566 696e 6974 variable definit │ │ │ │ │ +0000c260: 696f 6e2c 2066 6f72 2069 6e73 7461 6e63 ion, for instanc │ │ │ │ │ +0000c270: 652c 2061 6e64 2069 7320 6e6f 7420 6576 e, and is not ev │ │ │ │ │ +0000c280: 656e 2061 626c 6520 746f 2064 6961 676e en able to diagn │ │ │ │ │ +0000c290: 6f73 6520 7468 6973 0a73 6974 7561 7469 ose this.situati │ │ │ │ │ +0000c2a0: 6f6e 2e20 2054 6865 2066 6f6c 6c6f 7769 on. The followi │ │ │ │ │ +0000c2b0: 6e67 2065 7861 6d70 6c65 2077 6f75 6c64 ng example would │ │ │ │ │ +0000c2c0: 206e 6f74 2077 6f72 6b3a 0a0a 2020 2020 not work:.. │ │ │ │ │ +0000c2d0: 2023 2054 6869 7320 7379 6e74 6178 2069 # This syntax i │ │ │ │ │ +0000c2e0: 7320 6e6f 7420 756e 6465 7273 746f 6f64 s not understood │ │ │ │ │ +0000c2f0: 2062 7920 4175 746f 6d61 6b65 0a20 2020 by Automake. │ │ │ │ │ +0000c300: 2020 414d 5f43 5050 464c 4147 5320 3d20 AM_CPPFLAGS = │ │ │ │ │ +0000c310: 5c0a 2020 2020 2020 202d 4446 4541 5455 \. -DFEATU │ │ │ │ │ +0000c320: 5245 5f41 205c 0a20 2020 2020 6966 2057 RE_A \. if W │ │ │ │ │ +0000c330: 414e 545f 4445 4255 470a 2020 2020 2020 ANT_DEBUG. │ │ │ │ │ +0000c340: 202d 4444 4542 5547 205c 0a20 2020 2020 -DDEBUG \. │ │ │ │ │ +0000c350: 656e 6469 660a 2020 2020 2020 202d 4446 endif. -DF │ │ │ │ │ +0000c360: 4541 5455 5245 5f42 0a0a 2020 2048 6f77 EATURE_B.. How │ │ │ │ │ +0000c370: 6576 6572 2074 6865 2069 6e74 656e 6465 ever the intende │ │ │ │ │ +0000c380: 6420 6465 6669 6e69 7469 6f6e 206f 6620 d definition of │ │ │ │ │ +0000c390: 2741 4d5f 4350 5046 4c41 4753 2720 6361 'AM_CPPFLAGS' ca │ │ │ │ │ +0000c3a0: 6e20 6265 2061 6368 6965 7665 6420 7769 n be achieved wi │ │ │ │ │ +0000c3b0: 7468 0a0a 2020 2020 2069 6620 5741 4e54 th.. if WANT │ │ │ │ │ +0000c3c0: 5f44 4542 5547 0a20 2020 2020 2020 4445 _DEBUG. DE │ │ │ │ │ +0000c3d0: 4255 4746 4c41 4753 203d 202d 4444 4542 BUGFLAGS = -DDEB │ │ │ │ │ +0000c3e0: 5547 0a20 2020 2020 656e 6469 660a 2020 UG. endif. │ │ │ │ │ +0000c3f0: 2020 2041 4d5f 4350 5046 4c41 4753 203d AM_CPPFLAGS = │ │ │ │ │ +0000c400: 202d 4446 4541 5455 5245 5f41 2024 2844 -DFEATURE_A $(D │ │ │ │ │ +0000c410: 4542 5547 464c 4147 5329 202d 4446 4541 EBUGFLAGS) -DFEA │ │ │ │ │ +0000c420: 5455 5245 5f42 0a0a 6f72 0a0a 2020 2020 TURE_B..or.. │ │ │ │ │ +0000c430: 2041 4d5f 4350 5046 4c41 4753 203d 202d AM_CPPFLAGS = - │ │ │ │ │ +0000c440: 4446 4541 5455 5245 5f41 0a20 2020 2020 DFEATURE_A. │ │ │ │ │ +0000c450: 6966 2057 414e 545f 4445 4255 470a 2020 if WANT_DEBUG. │ │ │ │ │ +0000c460: 2020 2041 4d5f 4350 5046 4c41 4753 202b AM_CPPFLAGS + │ │ │ │ │ +0000c470: 3d20 2d44 4445 4255 470a 2020 2020 2065 = -DDEBUG. e │ │ │ │ │ +0000c480: 6e64 6966 0a20 2020 2020 414d 5f43 5050 ndif. AM_CPP │ │ │ │ │ +0000c490: 464c 4147 5320 2b3d 202d 4446 4541 5455 FLAGS += -DFEATU │ │ │ │ │ +0000c4a0: 5245 5f42 0a0a 2020 204d 6f72 6520 6465 RE_B.. More de │ │ │ │ │ +0000c4b0: 7461 696c 7320 616e 6420 6578 616d 706c tails and exampl │ │ │ │ │ +0000c4c0: 6573 206f 6620 636f 6e64 6974 696f 6e61 es of conditiona │ │ │ │ │ +0000c4d0: 6c73 2061 7265 2064 6573 6372 6962 6564 ls are described │ │ │ │ │ +0000c4e0: 2061 6c6f 6e67 7369 6465 0a76 6172 696f alongside.vario │ │ │ │ │ +0000c4f0: 7573 2041 7574 6f6d 616b 6520 6665 6174 us Automake feat │ │ │ │ │ +0000c500: 7572 6573 2069 6e20 7468 6973 206d 616e ures in this man │ │ │ │ │ +0000c510: 7561 6c20 282a 6e6f 7465 2043 6f6e 6469 ual (*note Condi │ │ │ │ │ +0000c520: 7469 6f6e 616c 0a53 7562 6469 7265 6374 tional.Subdirect │ │ │ │ │ +0000c530: 6f72 6965 733a 3a2c 202a 6e6f 7465 2043 ories::, *note C │ │ │ │ │ +0000c540: 6f6e 6469 7469 6f6e 616c 2053 6f75 7263 onditional Sourc │ │ │ │ │ +0000c550: 6573 3a3a 2c20 2a6e 6f74 6520 436f 6e64 es::, *note Cond │ │ │ │ │ +0000c560: 6974 696f 6e61 6c0a 5072 6f67 7261 6d73 itional.Programs │ │ │ │ │ +0000c570: 3a3a 2c20 2a6e 6f74 6520 436f 6e64 6974 ::, *note Condit │ │ │ │ │ +0000c580: 696f 6e61 6c20 4c69 6274 6f6f 6c20 4c69 ional Libtool Li │ │ │ │ │ +0000c590: 6272 6172 6965 733a 3a2c 202a 6e6f 7465 braries::, *note │ │ │ │ │ +0000c5a0: 2043 6f6e 6469 7469 6f6e 616c 0a4c 6962 Conditional.Lib │ │ │ │ │ +0000c5b0: 746f 6f6c 2053 6f75 7263 6573 3a3a 292e tool Sources::). │ │ │ │ │ +0000c5c0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +0000c5d0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +0000c5e0: 6f64 653a 2053 696c 656e 6369 6e67 204d ode: Silencing M │ │ │ │ │ +0000c5f0: 616b 652c 2020 4e65 7874 3a20 476e 6974 ake, Next: Gnit │ │ │ │ │ +0000c600: 732c 2020 5072 6576 3a20 436f 6e64 6974 s, Prev: Condit │ │ │ │ │ +0000c610: 696f 6e61 6c73 2c20 2055 703a 2054 6f70 ionals, Up: Top │ │ │ │ │ +0000c620: 0a0a 3231 2053 696c 656e 6369 6e67 2027 ..21 Silencing ' │ │ │ │ │ +0000c630: 6d61 6b65 270a 2a2a 2a2a 2a2a 2a2a 2a2a make'.********** │ │ │ │ │ +0000c640: 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a 204d 656e *********..* Men │ │ │ │ │ +0000c650: 753a 0a0a 2a20 4d61 6b65 2076 6572 626f u:..* Make verbo │ │ │ │ │ +0000c660: 7369 7479 3a3a 2020 2020 2020 2020 2020 sity:: │ │ │ │ │ +0000c670: 2020 2020 204d 616b 6520 6973 2076 6572 Make is ver │ │ │ │ │ +0000c680: 626f 7365 2062 7920 6465 6661 756c 740a bose by default. │ │ │ │ │ +0000c690: 2a20 5472 6963 6b73 2046 6f72 2053 696c * Tricks For Sil │ │ │ │ │ +0000c6a0: 656e 6369 6e67 204d 616b 653a 3a20 2020 encing Make:: │ │ │ │ │ +0000c6b0: 2053 7461 6e64 6172 6420 616e 6420 6765 Standard and ge │ │ │ │ │ +0000c6c0: 6e65 7269 6320 7761 7973 2074 6f20 7369 neric ways to si │ │ │ │ │ +0000c6d0: 6c65 6e63 6520 6d61 6b65 0a2a 2041 7574 lence make.* Aut │ │ │ │ │ +0000c6e0: 6f6d 616b 6520 7369 6c65 6e74 2d72 756c omake silent-rul │ │ │ │ │ +0000c6f0: 6573 204f 7074 696f 6e3a 3a20 486f 7720 es Option:: How │ │ │ │ │ +0000c700: 4175 746f 6d61 6b65 2063 616e 2068 656c Automake can hel │ │ │ │ │ +0000c710: 7020 696e 2073 696c 656e 6369 6e67 206d p in silencing m │ │ │ │ │ +0000c720: 616b 650a 0a1f 0a46 696c 653a 2061 7574 ake....File: aut │ │ │ │ │ +0000c730: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +0000c740: 2020 4e6f 6465 3a20 4d61 6b65 2076 6572 Node: Make ver │ │ │ │ │ +0000c750: 626f 7369 7479 2c20 204e 6578 743a 2054 bosity, Next: T │ │ │ │ │ +0000c760: 7269 636b 7320 466f 7220 5369 6c65 6e63 ricks For Silenc │ │ │ │ │ +0000c770: 696e 6720 4d61 6b65 2c20 2055 703a 2053 ing Make, Up: S │ │ │ │ │ +0000c780: 696c 656e 6369 6e67 204d 616b 650a 0a32 ilencing Make..2 │ │ │ │ │ +0000c790: 312e 3120 4d61 6b65 2069 7320 7665 7262 1.1 Make is verb │ │ │ │ │ +0000c7a0: 6f73 6520 6279 2064 6566 6175 6c74 0a3d ose by default.= │ │ │ │ │ 0000c7b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000c7c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a4e =============..N │ │ │ │ │ -0000c7d0: 6f72 6d61 6c6c 792c 2077 6865 6e20 6578 ormally, when ex │ │ │ │ │ -0000c7e0: 6563 7574 696e 6720 7468 6520 7365 7420 ecuting the set │ │ │ │ │ -0000c7f0: 6f66 2072 756c 6573 2061 7373 6f63 6961 of rules associa │ │ │ │ │ -0000c800: 7465 6420 7769 7468 2061 2074 6172 6765 ted with a targe │ │ │ │ │ -0000c810: 742c 0a27 6d61 6b65 2720 7072 696e 7473 t,.'make' prints │ │ │ │ │ -0000c820: 2065 6163 6820 7275 6c65 2062 6566 6f72 each rule befor │ │ │ │ │ -0000c830: 6520 6974 2069 7320 6578 6563 7574 6564 e it is executed │ │ │ │ │ -0000c840: 2e20 2054 6869 7320 6265 6861 7669 6f75 . This behaviou │ │ │ │ │ -0000c850: 722c 2077 6869 6c65 0a68 6176 696e 6720 r, while.having │ │ │ │ │ -0000c860: 6265 656e 2069 6e20 706c 6163 6520 666f been in place fo │ │ │ │ │ -0000c870: 7220 6120 6c6f 6e67 2074 696d 652c 2061 r a long time, a │ │ │ │ │ -0000c880: 6e64 2062 6569 6e67 2065 7665 6e20 6d61 nd being even ma │ │ │ │ │ -0000c890: 6e64 6174 6564 2062 7920 7468 650a 504f ndated by the.PO │ │ │ │ │ -0000c8a0: 5349 5820 7374 616e 6461 7264 2c20 7374 SIX standard, st │ │ │ │ │ -0000c8b0: 6172 6b6c 7920 7669 6f6c 6174 6573 2074 arkly violates t │ │ │ │ │ -0000c8c0: 6865 2022 7369 6c65 6e63 6520 6973 2067 he "silence is g │ │ │ │ │ -0000c8d0: 6f6c 6465 6e22 2055 4e49 580a 7072 696e olden" UNIX.prin │ │ │ │ │ -0000c8e0: 6369 706c 6528 3129 3a0a 0a20 2020 2020 ciple(1):.. │ │ │ │ │ -0000c8f0: 5768 656e 2061 2070 726f 6772 616d 2068 When a program h │ │ │ │ │ -0000c900: 6173 206e 6f74 6869 6e67 2069 6e74 6572 as nothing inter │ │ │ │ │ -0000c910: 6573 7469 6e67 206f 7220 7375 7270 7269 esting or surpri │ │ │ │ │ -0000c920: 7369 6e67 2074 6f20 7361 792c 2069 740a sing to say, it. │ │ │ │ │ -0000c930: 2020 2020 2073 686f 756c 6420 7361 7920 should say │ │ │ │ │ -0000c940: 6e6f 7468 696e 672e 2020 5765 6c6c 2d62 nothing. Well-b │ │ │ │ │ -0000c950: 6568 6176 6564 2055 6e69 7820 7072 6f67 ehaved Unix prog │ │ │ │ │ -0000c960: 7261 6d73 2064 6f20 7468 6569 7220 6a6f rams do their jo │ │ │ │ │ -0000c970: 6273 0a20 2020 2020 756e 6f62 7472 7573 bs. unobtrus │ │ │ │ │ -0000c980: 6976 656c 792c 2077 6974 6820 6120 6d69 ively, with a mi │ │ │ │ │ -0000c990: 6e69 6d75 6d20 6f66 2066 7573 7320 616e nimum of fuss an │ │ │ │ │ -0000c9a0: 6420 626f 7468 6572 2e20 2053 696c 656e d bother. Silen │ │ │ │ │ -0000c9b0: 6365 2069 730a 2020 2020 2067 6f6c 6465 ce is. golde │ │ │ │ │ -0000c9c0: 6e2e 0a0a 2020 2049 6e20 6661 6374 2c20 n... In fact, │ │ │ │ │ -0000c9d0: 7768 696c 6520 7375 6368 2076 6572 626f while such verbo │ │ │ │ │ -0000c9e0: 7369 7479 206f 6620 276d 616b 6527 2063 sity of 'make' c │ │ │ │ │ -0000c9f0: 616e 2074 6865 6f72 6574 6963 616c 6c79 an theoretically │ │ │ │ │ -0000ca00: 2062 6520 7573 6566 756c 0a74 6f20 7472 be useful.to tr │ │ │ │ │ -0000ca10: 6163 6b20 6275 6773 2061 6e64 2075 6e64 ack bugs and und │ │ │ │ │ -0000ca20: 6572 7374 616e 6420 7265 6173 6f6e 7320 erstand reasons │ │ │ │ │ -0000ca30: 6f66 2066 6169 6c75 7265 7320 7269 6768 of failures righ │ │ │ │ │ -0000ca40: 7420 6177 6179 2c20 6974 2063 616e 2061 t away, it can a │ │ │ │ │ -0000ca50: 6c73 6f0a 6869 6465 2077 6172 6e69 6e67 lso.hide warning │ │ │ │ │ -0000ca60: 2061 6e64 2065 7272 6f72 206d 6573 7361 and error messa │ │ │ │ │ -0000ca70: 6765 7320 6672 6f6d 2027 6d61 6b65 272d ges from 'make'- │ │ │ │ │ -0000ca80: 696e 766f 6b65 6420 746f 6f6c 732c 2064 invoked tools, d │ │ │ │ │ -0000ca90: 726f 776e 696e 6720 7468 656d 0a69 6e20 rowning them.in │ │ │ │ │ -0000caa0: 6120 666c 6f6f 6420 6f66 2075 6e69 6e74 a flood of unint │ │ │ │ │ -0000cab0: 6572 6573 7469 6e67 2061 6e64 2073 656c eresting and sel │ │ │ │ │ -0000cac0: 646f 6d20 7573 6566 756c 206d 6573 7361 dom useful messa │ │ │ │ │ -0000cad0: 6765 732c 2061 6e64 2074 6875 730a 616c ges, and thus.al │ │ │ │ │ -0000cae0: 6c6f 7769 6e67 2074 6865 6d20 746f 2067 lowing them to g │ │ │ │ │ -0000caf0: 6f20 6561 7369 6c79 2075 6e64 6574 6563 o easily undetec │ │ │ │ │ -0000cb00: 7465 642e 0a0a 2020 2054 6869 7320 7072 ted... This pr │ │ │ │ │ -0000cb10: 6f62 6c65 6d20 6361 6e20 6265 2076 6572 oblem can be ver │ │ │ │ │ -0000cb20: 7920 616e 6e6f 7969 6e67 2c20 6573 7065 y annoying, espe │ │ │ │ │ -0000cb30: 6369 616c 6c79 2066 6f72 2064 6576 656c cially for devel │ │ │ │ │ -0000cb40: 6f70 6572 732c 2077 686f 0a75 7375 616c opers, who.usual │ │ │ │ │ -0000cb50: 6c79 206b 6e6f 7720 7175 6974 6520 7765 ly know quite we │ │ │ │ │ -0000cb60: 6c6c 2077 6861 7427 7320 676f 696e 6720 ll what's going │ │ │ │ │ -0000cb70: 6f6e 2062 6568 696e 6420 7468 6520 7363 on behind the sc │ │ │ │ │ -0000cb80: 656e 6573 2c20 616e 6420 666f 7220 7768 enes, and for wh │ │ │ │ │ -0000cb90: 6f6d 0a74 6865 2076 6572 626f 7365 206f om.the verbose o │ │ │ │ │ -0000cba0: 7574 7075 7420 6672 6f6d 2027 6d61 6b65 utput from 'make │ │ │ │ │ -0000cbb0: 2720 656e 6473 2075 7020 6265 696e 6720 ' ends up being │ │ │ │ │ -0000cbc0: 6d6f 7374 6c79 206e 6f69 7365 2074 6861 mostly noise tha │ │ │ │ │ -0000cbd0: 7420 6861 6d70 6572 730a 7468 6520 6561 t hampers.the ea │ │ │ │ │ -0000cbe0: 7379 2064 6574 6563 7469 6f6e 206f 6620 sy detection of │ │ │ │ │ -0000cbf0: 706f 7465 6e74 6961 6c6c 7920 696d 706f potentially impo │ │ │ │ │ -0000cc00: 7274 616e 7420 7761 726e 696e 6720 6d65 rtant warning me │ │ │ │ │ -0000cc10: 7373 6167 6573 2e0a 0a20 2020 2d2d 2d2d ssages... ---- │ │ │ │ │ -0000cc20: 2d2d 2d2d 2d2d 2046 6f6f 746e 6f74 6573 ------ Footnotes │ │ │ │ │ -0000cc30: 202d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 ----------.. │ │ │ │ │ -0000cc40: 2831 2920 5365 6520 616c 736f 203c 6874 (1) See also .....File: a │ │ │ │ │ -0000cc90: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -0000cca0: 6f2c 2020 4e6f 6465 3a20 5472 6963 6b73 o, Node: Tricks │ │ │ │ │ -0000ccb0: 2046 6f72 2053 696c 656e 6369 6e67 204d For Silencing M │ │ │ │ │ -0000ccc0: 616b 652c 2020 4e65 7874 3a20 4175 746f ake, Next: Auto │ │ │ │ │ -0000ccd0: 6d61 6b65 2073 696c 656e 742d 7275 6c65 make silent-rule │ │ │ │ │ -0000cce0: 7320 4f70 7469 6f6e 2c20 2050 7265 763a s Option, Prev: │ │ │ │ │ -0000ccf0: 204d 616b 6520 7665 7262 6f73 6974 792c Make verbosity, │ │ │ │ │ -0000cd00: 2020 5570 3a20 5369 6c65 6e63 696e 6720 Up: Silencing │ │ │ │ │ -0000cd10: 4d61 6b65 0a0a 3231 2e32 2053 7461 6e64 Make..21.2 Stand │ │ │ │ │ -0000cd20: 6172 6420 616e 6420 6765 6e65 7269 6320 ard and generic │ │ │ │ │ -0000cd30: 7761 7973 2074 6f20 7369 6c65 6e63 6520 ways to silence │ │ │ │ │ -0000cd40: 6d61 6b65 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d make.=========== │ │ │ │ │ +0000c7c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +0000c7d0: 4e6f 726d 616c 6c79 2c20 7768 656e 2065 Normally, when e │ │ │ │ │ +0000c7e0: 7865 6375 7469 6e67 2074 6865 2073 6574 xecuting the set │ │ │ │ │ +0000c7f0: 206f 6620 7275 6c65 7320 6173 736f 6369 of rules associ │ │ │ │ │ +0000c800: 6174 6564 2077 6974 6820 6120 7461 7267 ated with a targ │ │ │ │ │ +0000c810: 6574 2c0a 276d 616b 6527 2070 7269 6e74 et,.'make' print │ │ │ │ │ +0000c820: 7320 6561 6368 2072 756c 6520 6265 666f s each rule befo │ │ │ │ │ +0000c830: 7265 2069 7420 6973 2065 7865 6375 7465 re it is execute │ │ │ │ │ +0000c840: 642e 2020 5468 6973 2062 6568 6176 696f d. This behavio │ │ │ │ │ +0000c850: 7572 2c20 7768 696c 650a 6861 7669 6e67 ur, while.having │ │ │ │ │ +0000c860: 2062 6565 6e20 696e 2070 6c61 6365 2066 been in place f │ │ │ │ │ +0000c870: 6f72 2061 206c 6f6e 6720 7469 6d65 2c20 or a long time, │ │ │ │ │ +0000c880: 616e 6420 6265 696e 6720 6576 656e 206d and being even m │ │ │ │ │ +0000c890: 616e 6461 7465 6420 6279 2074 6865 0a50 andated by the.P │ │ │ │ │ +0000c8a0: 4f53 4958 2073 7461 6e64 6172 642c 2073 OSIX standard, s │ │ │ │ │ +0000c8b0: 7461 726b 6c79 2076 696f 6c61 7465 7320 tarkly violates │ │ │ │ │ +0000c8c0: 7468 6520 2273 696c 656e 6365 2069 7320 the "silence is │ │ │ │ │ +0000c8d0: 676f 6c64 656e 2220 554e 4958 0a70 7269 golden" UNIX.pri │ │ │ │ │ +0000c8e0: 6e63 6970 6c65 2831 293a 0a0a 2020 2020 nciple(1):.. │ │ │ │ │ +0000c8f0: 2057 6865 6e20 6120 7072 6f67 7261 6d20 When a program │ │ │ │ │ +0000c900: 6861 7320 6e6f 7468 696e 6720 696e 7465 has nothing inte │ │ │ │ │ +0000c910: 7265 7374 696e 6720 6f72 2073 7572 7072 resting or surpr │ │ │ │ │ +0000c920: 6973 696e 6720 746f 2073 6179 2c20 6974 ising to say, it │ │ │ │ │ +0000c930: 0a20 2020 2020 7368 6f75 6c64 2073 6179 . should say │ │ │ │ │ +0000c940: 206e 6f74 6869 6e67 2e20 2057 656c 6c2d nothing. Well- │ │ │ │ │ +0000c950: 6265 6861 7665 6420 556e 6978 2070 726f behaved Unix pro │ │ │ │ │ +0000c960: 6772 616d 7320 646f 2074 6865 6972 206a grams do their j │ │ │ │ │ +0000c970: 6f62 730a 2020 2020 2075 6e6f 6274 7275 obs. unobtru │ │ │ │ │ +0000c980: 7369 7665 6c79 2c20 7769 7468 2061 206d sively, with a m │ │ │ │ │ +0000c990: 696e 696d 756d 206f 6620 6675 7373 2061 inimum of fuss a │ │ │ │ │ +0000c9a0: 6e64 2062 6f74 6865 722e 2020 5369 6c65 nd bother. Sile │ │ │ │ │ +0000c9b0: 6e63 6520 6973 0a20 2020 2020 676f 6c64 nce is. gold │ │ │ │ │ +0000c9c0: 656e 2e0a 0a20 2020 496e 2066 6163 742c en... In fact, │ │ │ │ │ +0000c9d0: 2077 6869 6c65 2073 7563 6820 7665 7262 while such verb │ │ │ │ │ +0000c9e0: 6f73 6974 7920 6f66 2027 6d61 6b65 2720 osity of 'make' │ │ │ │ │ +0000c9f0: 6361 6e20 7468 656f 7265 7469 6361 6c6c can theoreticall │ │ │ │ │ +0000ca00: 7920 6265 2075 7365 6675 6c0a 746f 2074 y be useful.to t │ │ │ │ │ +0000ca10: 7261 636b 2062 7567 7320 616e 6420 756e rack bugs and un │ │ │ │ │ +0000ca20: 6465 7273 7461 6e64 2072 6561 736f 6e73 derstand reasons │ │ │ │ │ +0000ca30: 206f 6620 6661 696c 7572 6573 2072 6967 of failures rig │ │ │ │ │ +0000ca40: 6874 2061 7761 792c 2069 7420 6361 6e20 ht away, it can │ │ │ │ │ +0000ca50: 616c 736f 0a68 6964 6520 7761 726e 696e also.hide warnin │ │ │ │ │ +0000ca60: 6720 616e 6420 6572 726f 7220 6d65 7373 g and error mess │ │ │ │ │ +0000ca70: 6167 6573 2066 726f 6d20 276d 616b 6527 ages from 'make' │ │ │ │ │ +0000ca80: 2d69 6e76 6f6b 6564 2074 6f6f 6c73 2c20 -invoked tools, │ │ │ │ │ +0000ca90: 6472 6f77 6e69 6e67 2074 6865 6d0a 696e drowning them.in │ │ │ │ │ +0000caa0: 2061 2066 6c6f 6f64 206f 6620 756e 696e a flood of unin │ │ │ │ │ +0000cab0: 7465 7265 7374 696e 6720 616e 6420 7365 teresting and se │ │ │ │ │ +0000cac0: 6c64 6f6d 2075 7365 6675 6c20 6d65 7373 ldom useful mess │ │ │ │ │ +0000cad0: 6167 6573 2c20 616e 6420 7468 7573 0a61 ages, and thus.a │ │ │ │ │ +0000cae0: 6c6c 6f77 696e 6720 7468 656d 2074 6f20 llowing them to │ │ │ │ │ +0000caf0: 676f 2065 6173 696c 7920 756e 6465 7465 go easily undete │ │ │ │ │ +0000cb00: 6374 6564 2e0a 0a20 2020 5468 6973 2070 cted... This p │ │ │ │ │ +0000cb10: 726f 626c 656d 2063 616e 2062 6520 7665 roblem can be ve │ │ │ │ │ +0000cb20: 7279 2061 6e6e 6f79 696e 672c 2065 7370 ry annoying, esp │ │ │ │ │ +0000cb30: 6563 6961 6c6c 7920 666f 7220 6465 7665 ecially for deve │ │ │ │ │ +0000cb40: 6c6f 7065 7273 2c20 7768 6f0a 7573 7561 lopers, who.usua │ │ │ │ │ +0000cb50: 6c6c 7920 6b6e 6f77 2071 7569 7465 2077 lly know quite w │ │ │ │ │ +0000cb60: 656c 6c20 7768 6174 2773 2067 6f69 6e67 ell what's going │ │ │ │ │ +0000cb70: 206f 6e20 6265 6869 6e64 2074 6865 2073 on behind the s │ │ │ │ │ +0000cb80: 6365 6e65 732c 2061 6e64 2066 6f72 2077 cenes, and for w │ │ │ │ │ +0000cb90: 686f 6d0a 7468 6520 7665 7262 6f73 6520 hom.the verbose │ │ │ │ │ +0000cba0: 6f75 7470 7574 2066 726f 6d20 276d 616b output from 'mak │ │ │ │ │ +0000cbb0: 6527 2065 6e64 7320 7570 2062 6569 6e67 e' ends up being │ │ │ │ │ +0000cbc0: 206d 6f73 746c 7920 6e6f 6973 6520 7468 mostly noise th │ │ │ │ │ +0000cbd0: 6174 2068 616d 7065 7273 0a74 6865 2065 at hampers.the e │ │ │ │ │ +0000cbe0: 6173 7920 6465 7465 6374 696f 6e20 6f66 asy detection of │ │ │ │ │ +0000cbf0: 2070 6f74 656e 7469 616c 6c79 2069 6d70 potentially imp │ │ │ │ │ +0000cc00: 6f72 7461 6e74 2077 6172 6e69 6e67 206d ortant warning m │ │ │ │ │ +0000cc10: 6573 7361 6765 732e 0a0a 2020 202d 2d2d essages... --- │ │ │ │ │ +0000cc20: 2d2d 2d2d 2d2d 2d20 466f 6f74 6e6f 7465 ------- Footnote │ │ │ │ │ +0000cc30: 7320 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 s ----------.. │ │ │ │ │ +0000cc40: 2028 3129 2053 6565 2061 6c73 6f20 3c68 (1) See also .....File: │ │ │ │ │ +0000cc90: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +0000cca0: 666f 2c20 204e 6f64 653a 2054 7269 636b fo, Node: Trick │ │ │ │ │ +0000ccb0: 7320 466f 7220 5369 6c65 6e63 696e 6720 s For Silencing │ │ │ │ │ +0000ccc0: 4d61 6b65 2c20 204e 6578 743a 2041 7574 Make, Next: Aut │ │ │ │ │ +0000ccd0: 6f6d 616b 6520 7369 6c65 6e74 2d72 756c omake silent-rul │ │ │ │ │ +0000cce0: 6573 204f 7074 696f 6e2c 2020 5072 6576 es Option, Prev │ │ │ │ │ +0000ccf0: 3a20 4d61 6b65 2076 6572 626f 7369 7479 : Make verbosity │ │ │ │ │ +0000cd00: 2c20 2055 703a 2053 696c 656e 6369 6e67 , Up: Silencing │ │ │ │ │ +0000cd10: 204d 616b 650a 0a32 312e 3220 5374 616e Make..21.2 Stan │ │ │ │ │ +0000cd20: 6461 7264 2061 6e64 2067 656e 6572 6963 dard and generic │ │ │ │ │ +0000cd30: 2077 6179 7320 746f 2073 696c 656e 6365 ways to silence │ │ │ │ │ +0000cd40: 206d 616b 650a 3d3d 3d3d 3d3d 3d3d 3d3d make.========== │ │ │ │ │ 0000cd50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0000cd60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000cd70: 3d3d 3d0a 0a48 6572 6520 7765 2064 6573 ===..Here we des │ │ │ │ │ -0000cd80: 6372 6962 6520 736f 6d65 2063 6f6d 6d6f cribe some commo │ │ │ │ │ -0000cd90: 6e20 6964 696f 6d73 2f74 7269 636b 7320 n idioms/tricks │ │ │ │ │ -0000cda0: 746f 206f 6274 6169 6e20 6120 7175 6965 to obtain a quie │ │ │ │ │ -0000cdb0: 7465 7220 6d61 6b65 0a6f 7574 7075 742c ter make.output, │ │ │ │ │ -0000cdc0: 2077 6974 6820 7468 6569 7220 7265 6c61 with their rela │ │ │ │ │ -0000cdd0: 7469 7665 2061 6476 616e 7461 6765 7320 tive advantages │ │ │ │ │ -0000cde0: 616e 6420 6472 6177 6261 636b 732e 2020 and drawbacks. │ │ │ │ │ -0000cdf0: 496e 2074 6865 206e 6578 740a 7365 6374 In the next.sect │ │ │ │ │ -0000ce00: 696f 6e20 282a 6e6f 7465 2041 7574 6f6d ion (*note Autom │ │ │ │ │ -0000ce10: 616b 6520 7369 6c65 6e74 2d72 756c 6573 ake silent-rules │ │ │ │ │ -0000ce20: 204f 7074 696f 6e3a 3a29 2077 6527 6c6c Option::) we'll │ │ │ │ │ -0000ce30: 2073 6565 2068 6f77 2041 7574 6f6d 616b see how Automak │ │ │ │ │ -0000ce40: 650a 6361 6e20 6865 6c70 2069 6e20 7468 e.can help in th │ │ │ │ │ -0000ce50: 6973 2072 6573 7065 6374 2e0a 0a20 2020 is respect... │ │ │ │ │ -0000ce60: 2a20 276d 616b 6520 2d73 270a 0a20 2020 * 'make -s'.. │ │ │ │ │ -0000ce70: 2020 5468 6973 2073 696d 706c 7920 6361 This simply ca │ │ │ │ │ -0000ce80: 7573 6573 2027 6d61 6b65 2720 6e6f 7420 uses 'make' not │ │ │ │ │ -0000ce90: 746f 2070 7269 6e74 205f 616e 795f 2072 to print _any_ r │ │ │ │ │ -0000cea0: 756c 6520 6265 666f 7265 2065 7865 6375 ule before execu │ │ │ │ │ -0000ceb0: 7469 6e67 0a20 2020 2020 6974 2e0a 0a20 ting. it... │ │ │ │ │ -0000cec0: 2020 2020 5468 6520 272d 7327 2066 6c61 The '-s' fla │ │ │ │ │ -0000ced0: 6720 6973 206d 616e 6461 7465 6420 6279 g is mandated by │ │ │ │ │ -0000cee0: 2050 4f53 4958 2c20 756e 6976 6572 7361 POSIX, universa │ │ │ │ │ -0000cef0: 6c6c 7920 7375 7070 6f72 7465 642c 2061 lly supported, a │ │ │ │ │ -0000cf00: 6e64 2069 7473 0a20 2020 2020 7075 7270 nd its. purp │ │ │ │ │ -0000cf10: 6f73 6520 616e 6420 6675 6e63 7469 6f6e ose and function │ │ │ │ │ -0000cf20: 2061 7265 2065 6173 7920 746f 2075 6e64 are easy to und │ │ │ │ │ -0000cf30: 6572 7374 616e 642e 0a0a 2020 2020 2042 erstand... B │ │ │ │ │ -0000cf40: 7574 2069 7420 616c 736f 2068 6173 2069 ut it also has i │ │ │ │ │ -0000cf50: 7473 2073 6572 696f 7573 206c 696d 6974 ts serious limit │ │ │ │ │ -0000cf60: 6174 696f 6e73 2074 6f6f 2e20 2046 6972 ations too. Fir │ │ │ │ │ -0000cf70: 7374 206f 6620 616c 6c2c 2069 740a 2020 st of all, it. │ │ │ │ │ -0000cf80: 2020 2065 6d62 6f64 6965 7320 616e 2022 embodies an " │ │ │ │ │ -0000cf90: 616c 6c20 6f72 206e 6f74 6869 6e67 2220 all or nothing" │ │ │ │ │ -0000cfa0: 7374 7261 7465 6779 2c20 692e 652e 2c20 strategy, i.e., │ │ │ │ │ -0000cfb0: 6569 7468 6572 2065 7665 7279 7468 696e either everythin │ │ │ │ │ -0000cfc0: 6720 6973 0a20 2020 2020 7369 6c65 6e63 g is. silenc │ │ │ │ │ -0000cfd0: 6564 2c20 6f72 206e 6f74 6869 6e67 2069 ed, or nothing i │ │ │ │ │ -0000cfe0: 733b 2074 6869 7320 6c61 636b 206f 6620 s; this lack of │ │ │ │ │ -0000cff0: 6772 616e 756c 6172 6974 7920 6361 6e20 granularity can │ │ │ │ │ -0000d000: 736f 6d65 7469 6d65 7320 6265 0a20 2020 sometimes be. │ │ │ │ │ -0000d010: 2020 6120 6661 7461 6c20 666c 6177 2e20 a fatal flaw. │ │ │ │ │ -0000d020: 204d 6f72 656f 7665 722c 2077 6865 6e20 Moreover, when │ │ │ │ │ -0000d030: 7468 6520 272d 7327 2066 6c61 6720 6973 the '-s' flag is │ │ │ │ │ -0000d040: 2075 7365 642c 2074 6865 2027 6d61 6b65 used, the 'make │ │ │ │ │ -0000d050: 270a 2020 2020 206f 7574 7075 7420 6d69 '. output mi │ │ │ │ │ -0000d060: 6768 7420 7475 726e 206f 7574 2074 6f20 ght turn out to │ │ │ │ │ -0000d070: 6265 2074 6f6f 206d 7563 6820 7465 7273 be too much ters │ │ │ │ │ -0000d080: 653b 2069 6e20 6361 7365 206f 6620 6572 e; in case of er │ │ │ │ │ -0000d090: 726f 7273 2c20 7468 650a 2020 2020 2075 rors, the. u │ │ │ │ │ -0000d0a0: 7365 7220 776f 6e27 7420 6265 2061 626c ser won't be abl │ │ │ │ │ -0000d0b0: 6520 746f 2065 6173 696c 7920 7365 6520 e to easily see │ │ │ │ │ -0000d0c0: 7768 6174 2072 756c 6520 6f72 2063 6f6d what rule or com │ │ │ │ │ -0000d0d0: 6d61 6e64 2068 6176 6520 6361 7573 6564 mand have caused │ │ │ │ │ -0000d0e0: 0a20 2020 2020 7468 656d 2c20 6f72 2065 . them, or e │ │ │ │ │ -0000d0f0: 7665 6e2c 2069 6e20 6361 7365 206f 6620 ven, in case of │ │ │ │ │ -0000d100: 746f 6f6c 7320 7769 7468 2070 6f6f 7220 tools with poor │ │ │ │ │ -0000d110: 6572 726f 7220 7265 706f 7274 696e 672c error reporting, │ │ │ │ │ -0000d120: 2077 6861 7420 7468 650a 2020 2020 2065 what the. e │ │ │ │ │ -0000d130: 7272 6f72 7320 7765 7265 210a 0a20 2020 rrors were!.. │ │ │ │ │ -0000d140: 2a20 276d 616b 6520 3e2f 6465 762f 6e75 * 'make >/dev/nu │ │ │ │ │ -0000d150: 6c6c 207c 7c20 6d61 6b65 270a 0a20 2020 ll || make'.. │ │ │ │ │ -0000d160: 2020 4170 7061 7265 6e74 6c79 2c20 7468 Apparently, th │ │ │ │ │ -0000d170: 6973 2070 6572 6665 6374 6c79 206f 6265 is perfectly obe │ │ │ │ │ -0000d180: 7973 2074 6865 2022 7369 6c65 6e63 6520 ys the "silence │ │ │ │ │ -0000d190: 6973 2067 6f6c 6465 6e22 2072 756c 653a is golden" rule: │ │ │ │ │ -0000d1a0: 0a20 2020 2020 7761 726e 696e 6773 2066 . warnings f │ │ │ │ │ -0000d1b0: 726f 6d20 7374 6465 7272 2061 7265 2070 rom stderr are p │ │ │ │ │ -0000d1c0: 6173 7365 6420 7468 726f 7567 682c 206f assed through, o │ │ │ │ │ -0000d1d0: 7574 7075 7420 7265 706f 7274 696e 6720 utput reporting │ │ │ │ │ -0000d1e0: 6973 2064 6f6e 650a 2020 2020 206f 6e6c is done. onl │ │ │ │ │ -0000d1f0: 7920 696e 2063 6173 6520 6f66 2065 7272 y in case of err │ │ │ │ │ -0000d200: 6f72 2c20 616e 6420 696e 2074 6861 7420 or, and in that │ │ │ │ │ -0000d210: 6361 7365 2069 7420 7368 6f75 6c64 2070 case it should p │ │ │ │ │ -0000d220: 726f 7669 6465 2061 0a20 2020 2020 7665 rovide a. ve │ │ │ │ │ -0000d230: 7262 6f73 652d 656e 6f75 6768 2072 6570 rbose-enough rep │ │ │ │ │ -0000d240: 6f72 7420 746f 2061 6c6c 6f77 2061 6e20 ort to allow an │ │ │ │ │ -0000d250: 6561 7379 2064 6574 6572 6d69 6e61 7469 easy determinati │ │ │ │ │ -0000d260: 6f6e 206f 6620 7468 6520 6572 726f 720a on of the error. │ │ │ │ │ -0000d270: 2020 2020 206c 6f63 6174 696f 6e20 616e location an │ │ │ │ │ -0000d280: 6420 6361 7573 6573 2e0a 0a20 2020 2020 d causes... │ │ │ │ │ -0000d290: 486f 7765 7665 722c 2063 616c 6c69 6e67 However, calling │ │ │ │ │ -0000d2a0: 2027 6d61 6b65 2720 7477 6f20 7469 6d65 'make' two time │ │ │ │ │ -0000d2b0: 7320 696e 2061 2072 6f77 206d 6967 6874 s in a row might │ │ │ │ │ -0000d2c0: 2068 6964 6520 6572 726f 7273 0a20 2020 hide errors. │ │ │ │ │ -0000d2d0: 2020 2865 7370 6563 6961 6c6c 7920 696e (especially in │ │ │ │ │ -0000d2e0: 7465 726d 6974 7465 6e74 206f 6e65 7329 termittent ones) │ │ │ │ │ -0000d2f0: 2c20 6f72 2073 7562 746c 7920 6368 616e , or subtly chan │ │ │ │ │ -0000d300: 6765 2074 6865 2065 7870 6563 7465 640a ge the expected. │ │ │ │ │ -0000d310: 2020 2020 2073 656d 616e 7469 6320 6f66 semantic of │ │ │ │ │ -0000d320: 2074 6865 2027 6d61 6b65 2720 6361 6c6c the 'make' call │ │ │ │ │ -0000d330: 7320 2d2d 2074 6869 6e67 7320 7468 6573 s -- things thes │ │ │ │ │ -0000d340: 6520 7768 6963 6820 6361 6e20 636c 6561 e which can clea │ │ │ │ │ -0000d350: 726c 7920 6d61 6b65 0a20 2020 2020 6465 rly make. de │ │ │ │ │ -0000d360: 6275 6767 696e 6720 616e 6420 6572 726f bugging and erro │ │ │ │ │ -0000d370: 7220 6173 7365 7373 6d65 6e74 2076 6572 r assessment ver │ │ │ │ │ -0000d380: 7920 6469 6666 6963 756c 742e 0a0a 2020 y difficult... │ │ │ │ │ -0000d390: 202a 2027 6d61 6b65 202d 2d6e 6f2d 7072 * 'make --no-pr │ │ │ │ │ -0000d3a0: 696e 742d 6469 7265 6374 6f72 7927 0a0a int-directory'.. │ │ │ │ │ -0000d3b0: 2020 2020 2054 6869 7320 6973 2047 4e55 This is GNU │ │ │ │ │ -0000d3c0: 2027 6d61 6b65 2720 7370 6563 6966 6963 'make' specific │ │ │ │ │ -0000d3d0: 2e20 2057 6865 6e20 6361 6c6c 6564 2077 . When called w │ │ │ │ │ -0000d3e0: 6974 6820 7468 650a 2020 2020 2027 2d2d ith the. '-- │ │ │ │ │ -0000d3f0: 6e6f 2d70 7269 6e74 2d64 6972 6563 746f no-print-directo │ │ │ │ │ -0000d400: 7279 2720 6f70 7469 6f6e 2c20 474e 5520 ry' option, GNU │ │ │ │ │ -0000d410: 276d 616b 6527 2077 696c 6c20 6469 7361 'make' will disa │ │ │ │ │ -0000d420: 626c 6520 7072 696e 7469 6e67 206f 660a ble printing of. │ │ │ │ │ -0000d430: 2020 2020 2074 6865 2077 6f72 6b69 6e67 the working │ │ │ │ │ -0000d440: 2064 6972 6563 746f 7279 2062 7920 696e directory by in │ │ │ │ │ -0000d450: 766f 6b65 6420 7375 622d 276d 616b 6527 voked sub-'make' │ │ │ │ │ -0000d460: 7320 2874 6865 2077 656c 6c2d 6b6e 6f77 s (the well-know │ │ │ │ │ -0000d470: 6e0a 2020 2020 2022 456e 7465 7269 6e67 n. "Entering │ │ │ │ │ -0000d480: 2f4c 6561 7669 6e67 2064 6972 6563 746f /Leaving directo │ │ │ │ │ -0000d490: 7279 202e 2e2e 2220 206d 6573 7361 6765 ry ..." message │ │ │ │ │ -0000d4a0: 7329 2e20 2054 6869 7320 6865 6c70 7320 s). This helps │ │ │ │ │ -0000d4b0: 746f 0a20 2020 2020 6465 6372 6561 7365 to. decrease │ │ │ │ │ -0000d4c0: 2074 6865 2076 6572 626f 7369 7479 206f the verbosity o │ │ │ │ │ -0000d4d0: 6620 7468 6520 6f75 7470 7574 2c20 6275 f the output, bu │ │ │ │ │ -0000d4e0: 7420 6578 7065 7269 656e 6365 2068 6173 t experience has │ │ │ │ │ -0000d4f0: 2073 686f 776e 2074 6861 740a 2020 2020 shown that. │ │ │ │ │ -0000d500: 2069 7420 6361 6e20 616c 736f 206f 6674 it can also oft │ │ │ │ │ -0000d510: 656e 2072 656e 6465 7220 6465 6275 6767 en render debugg │ │ │ │ │ -0000d520: 696e 6720 636f 6e73 6964 6572 6162 6c79 ing considerably │ │ │ │ │ -0000d530: 2068 6172 6465 7220 696e 2070 726f 6a65 harder in proje │ │ │ │ │ -0000d540: 6374 730a 2020 2020 2075 7369 6e67 2064 cts. using d │ │ │ │ │ -0000d550: 6565 706c 792d 6e65 7374 6564 2027 6d61 eeply-nested 'ma │ │ │ │ │ -0000d560: 6b65 2720 7265 6375 7273 696f 6e2e 0a0a ke' recursion... │ │ │ │ │ -0000d570: 2020 2020 2041 7320 616e 2061 7369 6465 As an aside │ │ │ │ │ -0000d580: 2c20 6e6f 7469 6365 2074 6861 7420 7468 , notice that th │ │ │ │ │ -0000d590: 6520 272d 2d6e 6f2d 7072 696e 742d 6469 e '--no-print-di │ │ │ │ │ -0000d5a0: 7265 6374 6f72 7927 206f 7074 696f 6e20 rectory' option │ │ │ │ │ -0000d5b0: 6973 0a20 2020 2020 6175 746f 6d61 7469 is. automati │ │ │ │ │ -0000d5c0: 6361 6c6c 7920 6163 7469 7661 7465 6420 cally activated │ │ │ │ │ -0000d5d0: 6966 2074 6865 2027 2d73 2720 666c 6167 if the '-s' flag │ │ │ │ │ -0000d5e0: 2069 7320 7573 6564 2e0a 0a1f 0a46 696c is used.....Fil │ │ │ │ │ -0000d5f0: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -0000d600: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4175 .info, Node: Au │ │ │ │ │ -0000d610: 746f 6d61 6b65 2073 696c 656e 742d 7275 tomake silent-ru │ │ │ │ │ -0000d620: 6c65 7320 4f70 7469 6f6e 2c20 2050 7265 les Option, Pre │ │ │ │ │ -0000d630: 763a 2054 7269 636b 7320 466f 7220 5369 v: Tricks For Si │ │ │ │ │ -0000d640: 6c65 6e63 696e 6720 4d61 6b65 2c20 2055 lencing Make, U │ │ │ │ │ -0000d650: 703a 2053 696c 656e 6369 6e67 204d 616b p: Silencing Mak │ │ │ │ │ -0000d660: 650a 0a32 312e 3320 486f 7720 4175 746f e..21.3 How Auto │ │ │ │ │ -0000d670: 6d61 6b65 2063 616e 2068 656c 7020 696e make can help in │ │ │ │ │ -0000d680: 2073 696c 656e 6369 6e67 206d 616b 650a silencing make. │ │ │ │ │ -0000d690: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0000cd70: 3d3d 3d3d 0a0a 4865 7265 2077 6520 6465 ====..Here we de │ │ │ │ │ +0000cd80: 7363 7269 6265 2073 6f6d 6520 636f 6d6d scribe some comm │ │ │ │ │ +0000cd90: 6f6e 2069 6469 6f6d 732f 7472 6963 6b73 on idioms/tricks │ │ │ │ │ +0000cda0: 2074 6f20 6f62 7461 696e 2061 2071 7569 to obtain a qui │ │ │ │ │ +0000cdb0: 6574 6572 206d 616b 650a 6f75 7470 7574 eter make.output │ │ │ │ │ +0000cdc0: 2c20 7769 7468 2074 6865 6972 2072 656c , with their rel │ │ │ │ │ +0000cdd0: 6174 6976 6520 6164 7661 6e74 6167 6573 ative advantages │ │ │ │ │ +0000cde0: 2061 6e64 2064 7261 7762 6163 6b73 2e20 and drawbacks. │ │ │ │ │ +0000cdf0: 2049 6e20 7468 6520 6e65 7874 0a73 6563 In the next.sec │ │ │ │ │ +0000ce00: 7469 6f6e 2028 2a6e 6f74 6520 4175 746f tion (*note Auto │ │ │ │ │ +0000ce10: 6d61 6b65 2073 696c 656e 742d 7275 6c65 make silent-rule │ │ │ │ │ +0000ce20: 7320 4f70 7469 6f6e 3a3a 2920 7765 276c s Option::) we'l │ │ │ │ │ +0000ce30: 6c20 7365 6520 686f 7720 4175 746f 6d61 l see how Automa │ │ │ │ │ +0000ce40: 6b65 0a63 616e 2068 656c 7020 696e 2074 ke.can help in t │ │ │ │ │ +0000ce50: 6869 7320 7265 7370 6563 742e 0a0a 2020 his respect... │ │ │ │ │ +0000ce60: 202a 2027 6d61 6b65 202d 7327 0a0a 2020 * 'make -s'.. │ │ │ │ │ +0000ce70: 2020 2054 6869 7320 7369 6d70 6c79 2063 This simply c │ │ │ │ │ +0000ce80: 6175 7365 7320 276d 616b 6527 206e 6f74 auses 'make' not │ │ │ │ │ +0000ce90: 2074 6f20 7072 696e 7420 5f61 6e79 5f20 to print _any_ │ │ │ │ │ +0000cea0: 7275 6c65 2062 6566 6f72 6520 6578 6563 rule before exec │ │ │ │ │ +0000ceb0: 7574 696e 670a 2020 2020 2069 742e 0a0a uting. it... │ │ │ │ │ +0000cec0: 2020 2020 2054 6865 2027 2d73 2720 666c The '-s' fl │ │ │ │ │ +0000ced0: 6167 2069 7320 6d61 6e64 6174 6564 2062 ag is mandated b │ │ │ │ │ +0000cee0: 7920 504f 5349 582c 2075 6e69 7665 7273 y POSIX, univers │ │ │ │ │ +0000cef0: 616c 6c79 2073 7570 706f 7274 6564 2c20 ally supported, │ │ │ │ │ +0000cf00: 616e 6420 6974 730a 2020 2020 2070 7572 and its. pur │ │ │ │ │ +0000cf10: 706f 7365 2061 6e64 2066 756e 6374 696f pose and functio │ │ │ │ │ +0000cf20: 6e20 6172 6520 6561 7379 2074 6f20 756e n are easy to un │ │ │ │ │ +0000cf30: 6465 7273 7461 6e64 2e0a 0a20 2020 2020 derstand... │ │ │ │ │ +0000cf40: 4275 7420 6974 2061 6c73 6f20 6861 7320 But it also has │ │ │ │ │ +0000cf50: 6974 7320 7365 7269 6f75 7320 6c69 6d69 its serious limi │ │ │ │ │ +0000cf60: 7461 7469 6f6e 7320 746f 6f2e 2020 4669 tations too. Fi │ │ │ │ │ +0000cf70: 7273 7420 6f66 2061 6c6c 2c20 6974 0a20 rst of all, it. │ │ │ │ │ +0000cf80: 2020 2020 656d 626f 6469 6573 2061 6e20 embodies an │ │ │ │ │ +0000cf90: 2261 6c6c 206f 7220 6e6f 7468 696e 6722 "all or nothing" │ │ │ │ │ +0000cfa0: 2073 7472 6174 6567 792c 2069 2e65 2e2c strategy, i.e., │ │ │ │ │ +0000cfb0: 2065 6974 6865 7220 6576 6572 7974 6869 either everythi │ │ │ │ │ +0000cfc0: 6e67 2069 730a 2020 2020 2073 696c 656e ng is. silen │ │ │ │ │ +0000cfd0: 6365 642c 206f 7220 6e6f 7468 696e 6720 ced, or nothing │ │ │ │ │ +0000cfe0: 6973 3b20 7468 6973 206c 6163 6b20 6f66 is; this lack of │ │ │ │ │ +0000cff0: 2067 7261 6e75 6c61 7269 7479 2063 616e granularity can │ │ │ │ │ +0000d000: 2073 6f6d 6574 696d 6573 2062 650a 2020 sometimes be. │ │ │ │ │ +0000d010: 2020 2061 2066 6174 616c 2066 6c61 772e a fatal flaw. │ │ │ │ │ +0000d020: 2020 4d6f 7265 6f76 6572 2c20 7768 656e Moreover, when │ │ │ │ │ +0000d030: 2074 6865 2027 2d73 2720 666c 6167 2069 the '-s' flag i │ │ │ │ │ +0000d040: 7320 7573 6564 2c20 7468 6520 276d 616b s used, the 'mak │ │ │ │ │ +0000d050: 6527 0a20 2020 2020 6f75 7470 7574 206d e'. output m │ │ │ │ │ +0000d060: 6967 6874 2074 7572 6e20 6f75 7420 746f ight turn out to │ │ │ │ │ +0000d070: 2062 6520 746f 6f20 6d75 6368 2074 6572 be too much ter │ │ │ │ │ +0000d080: 7365 3b20 696e 2063 6173 6520 6f66 2065 se; in case of e │ │ │ │ │ +0000d090: 7272 6f72 732c 2074 6865 0a20 2020 2020 rrors, the. │ │ │ │ │ +0000d0a0: 7573 6572 2077 6f6e 2774 2062 6520 6162 user won't be ab │ │ │ │ │ +0000d0b0: 6c65 2074 6f20 6561 7369 6c79 2073 6565 le to easily see │ │ │ │ │ +0000d0c0: 2077 6861 7420 7275 6c65 206f 7220 636f what rule or co │ │ │ │ │ +0000d0d0: 6d6d 616e 6420 6861 7665 2063 6175 7365 mmand have cause │ │ │ │ │ +0000d0e0: 640a 2020 2020 2074 6865 6d2c 206f 7220 d. them, or │ │ │ │ │ +0000d0f0: 6576 656e 2c20 696e 2063 6173 6520 6f66 even, in case of │ │ │ │ │ +0000d100: 2074 6f6f 6c73 2077 6974 6820 706f 6f72 tools with poor │ │ │ │ │ +0000d110: 2065 7272 6f72 2072 6570 6f72 7469 6e67 error reporting │ │ │ │ │ +0000d120: 2c20 7768 6174 2074 6865 0a20 2020 2020 , what the. │ │ │ │ │ +0000d130: 6572 726f 7273 2077 6572 6521 0a0a 2020 errors were!.. │ │ │ │ │ +0000d140: 202a 2027 6d61 6b65 203e 2f64 6576 2f6e * 'make >/dev/n │ │ │ │ │ +0000d150: 756c 6c20 7c7c 206d 616b 6527 0a0a 2020 ull || make'.. │ │ │ │ │ +0000d160: 2020 2041 7070 6172 656e 746c 792c 2074 Apparently, t │ │ │ │ │ +0000d170: 6869 7320 7065 7266 6563 746c 7920 6f62 his perfectly ob │ │ │ │ │ +0000d180: 6579 7320 7468 6520 2273 696c 656e 6365 eys the "silence │ │ │ │ │ +0000d190: 2069 7320 676f 6c64 656e 2220 7275 6c65 is golden" rule │ │ │ │ │ +0000d1a0: 3a0a 2020 2020 2077 6172 6e69 6e67 7320 :. warnings │ │ │ │ │ +0000d1b0: 6672 6f6d 2073 7464 6572 7220 6172 6520 from stderr are │ │ │ │ │ +0000d1c0: 7061 7373 6564 2074 6872 6f75 6768 2c20 passed through, │ │ │ │ │ +0000d1d0: 6f75 7470 7574 2072 6570 6f72 7469 6e67 output reporting │ │ │ │ │ +0000d1e0: 2069 7320 646f 6e65 0a20 2020 2020 6f6e is done. on │ │ │ │ │ +0000d1f0: 6c79 2069 6e20 6361 7365 206f 6620 6572 ly in case of er │ │ │ │ │ +0000d200: 726f 722c 2061 6e64 2069 6e20 7468 6174 ror, and in that │ │ │ │ │ +0000d210: 2063 6173 6520 6974 2073 686f 756c 6420 case it should │ │ │ │ │ +0000d220: 7072 6f76 6964 6520 610a 2020 2020 2076 provide a. v │ │ │ │ │ +0000d230: 6572 626f 7365 2d65 6e6f 7567 6820 7265 erbose-enough re │ │ │ │ │ +0000d240: 706f 7274 2074 6f20 616c 6c6f 7720 616e port to allow an │ │ │ │ │ +0000d250: 2065 6173 7920 6465 7465 726d 696e 6174 easy determinat │ │ │ │ │ +0000d260: 696f 6e20 6f66 2074 6865 2065 7272 6f72 ion of the error │ │ │ │ │ +0000d270: 0a20 2020 2020 6c6f 6361 7469 6f6e 2061 . location a │ │ │ │ │ +0000d280: 6e64 2063 6175 7365 732e 0a0a 2020 2020 nd causes... │ │ │ │ │ +0000d290: 2048 6f77 6576 6572 2c20 6361 6c6c 696e However, callin │ │ │ │ │ +0000d2a0: 6720 276d 616b 6527 2074 776f 2074 696d g 'make' two tim │ │ │ │ │ +0000d2b0: 6573 2069 6e20 6120 726f 7720 6d69 6768 es in a row migh │ │ │ │ │ +0000d2c0: 7420 6869 6465 2065 7272 6f72 730a 2020 t hide errors. │ │ │ │ │ +0000d2d0: 2020 2028 6573 7065 6369 616c 6c79 2069 (especially i │ │ │ │ │ +0000d2e0: 6e74 6572 6d69 7474 656e 7420 6f6e 6573 ntermittent ones │ │ │ │ │ +0000d2f0: 292c 206f 7220 7375 6274 6c79 2063 6861 ), or subtly cha │ │ │ │ │ +0000d300: 6e67 6520 7468 6520 6578 7065 6374 6564 nge the expected │ │ │ │ │ +0000d310: 0a20 2020 2020 7365 6d61 6e74 6963 206f . semantic o │ │ │ │ │ +0000d320: 6620 7468 6520 276d 616b 6527 2063 616c f the 'make' cal │ │ │ │ │ +0000d330: 6c73 202d 2d20 7468 696e 6773 2074 6865 ls -- things the │ │ │ │ │ +0000d340: 7365 2077 6869 6368 2063 616e 2063 6c65 se which can cle │ │ │ │ │ +0000d350: 6172 6c79 206d 616b 650a 2020 2020 2064 arly make. d │ │ │ │ │ +0000d360: 6562 7567 6769 6e67 2061 6e64 2065 7272 ebugging and err │ │ │ │ │ +0000d370: 6f72 2061 7373 6573 736d 656e 7420 7665 or assessment ve │ │ │ │ │ +0000d380: 7279 2064 6966 6669 6375 6c74 2e0a 0a20 ry difficult... │ │ │ │ │ +0000d390: 2020 2a20 276d 616b 6520 2d2d 6e6f 2d70 * 'make --no-p │ │ │ │ │ +0000d3a0: 7269 6e74 2d64 6972 6563 746f 7279 270a rint-directory'. │ │ │ │ │ +0000d3b0: 0a20 2020 2020 5468 6973 2069 7320 474e . This is GN │ │ │ │ │ +0000d3c0: 5520 276d 616b 6527 2073 7065 6369 6669 U 'make' specifi │ │ │ │ │ +0000d3d0: 632e 2020 5768 656e 2063 616c 6c65 6420 c. When called │ │ │ │ │ +0000d3e0: 7769 7468 2074 6865 0a20 2020 2020 272d with the. '- │ │ │ │ │ +0000d3f0: 2d6e 6f2d 7072 696e 742d 6469 7265 6374 -no-print-direct │ │ │ │ │ +0000d400: 6f72 7927 206f 7074 696f 6e2c 2047 4e55 ory' option, GNU │ │ │ │ │ +0000d410: 2027 6d61 6b65 2720 7769 6c6c 2064 6973 'make' will dis │ │ │ │ │ +0000d420: 6162 6c65 2070 7269 6e74 696e 6720 6f66 able printing of │ │ │ │ │ +0000d430: 0a20 2020 2020 7468 6520 776f 726b 696e . the workin │ │ │ │ │ +0000d440: 6720 6469 7265 6374 6f72 7920 6279 2069 g directory by i │ │ │ │ │ +0000d450: 6e76 6f6b 6564 2073 7562 2d27 6d61 6b65 nvoked sub-'make │ │ │ │ │ +0000d460: 2773 2028 7468 6520 7765 6c6c 2d6b 6e6f 's (the well-kno │ │ │ │ │ +0000d470: 776e 0a20 2020 2020 2245 6e74 6572 696e wn. "Enterin │ │ │ │ │ +0000d480: 672f 4c65 6176 696e 6720 6469 7265 6374 g/Leaving direct │ │ │ │ │ +0000d490: 6f72 7920 2e2e 2e22 2020 6d65 7373 6167 ory ..." messag │ │ │ │ │ +0000d4a0: 6573 292e 2020 5468 6973 2068 656c 7073 es). This helps │ │ │ │ │ +0000d4b0: 2074 6f0a 2020 2020 2064 6563 7265 6173 to. decreas │ │ │ │ │ +0000d4c0: 6520 7468 6520 7665 7262 6f73 6974 7920 e the verbosity │ │ │ │ │ +0000d4d0: 6f66 2074 6865 206f 7574 7075 742c 2062 of the output, b │ │ │ │ │ +0000d4e0: 7574 2065 7870 6572 6965 6e63 6520 6861 ut experience ha │ │ │ │ │ +0000d4f0: 7320 7368 6f77 6e20 7468 6174 0a20 2020 s shown that. │ │ │ │ │ +0000d500: 2020 6974 2063 616e 2061 6c73 6f20 6f66 it can also of │ │ │ │ │ +0000d510: 7465 6e20 7265 6e64 6572 2064 6562 7567 ten render debug │ │ │ │ │ +0000d520: 6769 6e67 2063 6f6e 7369 6465 7261 626c ging considerabl │ │ │ │ │ +0000d530: 7920 6861 7264 6572 2069 6e20 7072 6f6a y harder in proj │ │ │ │ │ +0000d540: 6563 7473 0a20 2020 2020 7573 696e 6720 ects. using │ │ │ │ │ +0000d550: 6465 6570 6c79 2d6e 6573 7465 6420 276d deeply-nested 'm │ │ │ │ │ +0000d560: 616b 6527 2072 6563 7572 7369 6f6e 2e0a ake' recursion.. │ │ │ │ │ +0000d570: 0a20 2020 2020 4173 2061 6e20 6173 6964 . As an asid │ │ │ │ │ +0000d580: 652c 206e 6f74 6963 6520 7468 6174 2074 e, notice that t │ │ │ │ │ +0000d590: 6865 2027 2d2d 6e6f 2d70 7269 6e74 2d64 he '--no-print-d │ │ │ │ │ +0000d5a0: 6972 6563 746f 7279 2720 6f70 7469 6f6e irectory' option │ │ │ │ │ +0000d5b0: 2069 730a 2020 2020 2061 7574 6f6d 6174 is. automat │ │ │ │ │ +0000d5c0: 6963 616c 6c79 2061 6374 6976 6174 6564 ically activated │ │ │ │ │ +0000d5d0: 2069 6620 7468 6520 272d 7327 2066 6c61 if the '-s' fla │ │ │ │ │ +0000d5e0: 6720 6973 2075 7365 642e 0a0a 1f0a 4669 g is used.....Fi │ │ │ │ │ +0000d5f0: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +0000d600: 312e 696e 666f 2c20 204e 6f64 653a 2041 1.info, Node: A │ │ │ │ │ +0000d610: 7574 6f6d 616b 6520 7369 6c65 6e74 2d72 utomake silent-r │ │ │ │ │ +0000d620: 756c 6573 204f 7074 696f 6e2c 2020 5072 ules Option, Pr │ │ │ │ │ +0000d630: 6576 3a20 5472 6963 6b73 2046 6f72 2053 ev: Tricks For S │ │ │ │ │ +0000d640: 696c 656e 6369 6e67 204d 616b 652c 2020 ilencing Make, │ │ │ │ │ +0000d650: 5570 3a20 5369 6c65 6e63 696e 6720 4d61 Up: Silencing Ma │ │ │ │ │ +0000d660: 6b65 0a0a 3231 2e33 2048 6f77 2041 7574 ke..21.3 How Aut │ │ │ │ │ +0000d670: 6f6d 616b 6520 6361 6e20 6865 6c70 2069 omake can help i │ │ │ │ │ +0000d680: 6e20 7369 6c65 6e63 696e 6720 6d61 6b65 n silencing make │ │ │ │ │ +0000d690: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ 0000d6a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000d6b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ -0000d6c0: 6520 7472 6963 6b73 2061 6e64 2069 6469 e tricks and idi │ │ │ │ │ -0000d6d0: 6f6d 7320 666f 7220 7369 6c65 6e63 696e oms for silencin │ │ │ │ │ -0000d6e0: 6720 276d 616b 6527 2064 6573 6372 6962 g 'make' describ │ │ │ │ │ -0000d6f0: 6564 2069 6e20 7468 6520 7072 6576 696f ed in the previo │ │ │ │ │ -0000d700: 7573 0a73 6563 7469 6f6e 2063 616e 2062 us.section can b │ │ │ │ │ -0000d710: 6520 7573 6566 756c 2066 726f 6d20 7469 e useful from ti │ │ │ │ │ -0000d720: 6d65 2074 6f20 7469 6d65 2c20 6275 7420 me to time, but │ │ │ │ │ -0000d730: 7765 2776 6520 7365 656e 2074 6861 7420 we've seen that │ │ │ │ │ -0000d740: 7468 6579 2061 6c6c 0a68 6176 6520 7468 they all.have th │ │ │ │ │ -0000d750: 6569 7220 7365 7269 6f75 7320 6472 6177 eir serious draw │ │ │ │ │ -0000d760: 6261 636b 7320 616e 6420 6c69 6d69 7461 backs and limita │ │ │ │ │ -0000d770: 7469 6f6e 732e 2020 5468 6174 2773 2077 tions. That's w │ │ │ │ │ -0000d780: 6879 2061 7574 6f6d 616b 650a 7072 6f76 hy automake.prov │ │ │ │ │ -0000d790: 6964 6573 2073 7570 706f 7274 2066 6f72 ides support for │ │ │ │ │ -0000d7a0: 2061 206d 6f72 6520 6164 7661 6e63 6564 a more advanced │ │ │ │ │ -0000d7b0: 2061 6e64 2066 6c65 7869 626c 6520 7761 and flexible wa │ │ │ │ │ -0000d7c0: 7920 6f66 206f 6274 6169 6e69 6e67 0a71 y of obtaining.q │ │ │ │ │ -0000d7d0: 7569 6574 6572 206f 7574 7075 7420 6672 uieter output fr │ │ │ │ │ -0000d7e0: 6f6d 2027 6d61 6b65 273a 2074 6865 2027 om 'make': the ' │ │ │ │ │ -0000d7f0: 7369 6c65 6e74 2d72 756c 6573 2720 6d6f silent-rules' mo │ │ │ │ │ -0000d800: 6465 2e0a 0a20 2020 546f 2067 6976 6520 de... To give │ │ │ │ │ -0000d810: 7468 6520 6769 7374 206f 6620 7768 6174 the gist of what │ │ │ │ │ -0000d820: 2027 7369 6c65 6e74 2d72 756c 6573 2720 'silent-rules' │ │ │ │ │ -0000d830: 6361 6e20 646f 2c20 6865 7265 2069 7320 can do, here is │ │ │ │ │ -0000d840: 6120 7369 6d70 6c65 0a63 6f6d 7061 7269 a simple.compari │ │ │ │ │ -0000d850: 736f 6e20 6265 7477 6565 6e20 6120 7479 son between a ty │ │ │ │ │ -0000d860: 7069 6361 6c20 276d 616b 6527 206f 7574 pical 'make' out │ │ │ │ │ -0000d870: 7075 7420 2877 6865 7265 2073 696c 656e put (where silen │ │ │ │ │ -0000d880: 7420 7275 6c65 7320 6172 650a 6469 7361 t rules are.disa │ │ │ │ │ -0000d890: 626c 6564 2920 616e 6420 6f6e 6520 7769 bled) and one wi │ │ │ │ │ -0000d8a0: 7468 2073 696c 656e 7420 7275 6c65 7320 th silent rules │ │ │ │ │ -0000d8b0: 656e 6162 6c65 643a 0a0a 2020 2020 2025 enabled:.. % │ │ │ │ │ -0000d8c0: 2063 6174 204d 616b 6566 696c 652e 616d cat Makefile.am │ │ │ │ │ -0000d8d0: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ -0000d8e0: 4d53 203d 2066 6f6f 0a20 2020 2020 666f MS = foo. fo │ │ │ │ │ -0000d8f0: 6f5f 534f 5552 4345 5320 3d20 6d61 696e o_SOURCES = main │ │ │ │ │ -0000d900: 2e63 2066 756e 632e 630a 2020 2020 2025 .c func.c. % │ │ │ │ │ -0000d910: 2063 6174 206d 6169 6e2e 630a 2020 2020 cat main.c. │ │ │ │ │ -0000d920: 2069 6e74 206d 6169 6e20 2876 6f69 6429 int main (void) │ │ │ │ │ -0000d930: 207b 2072 6574 7572 6e20 6675 6e63 2028 { return func ( │ │ │ │ │ -0000d940: 293b 207d 2020 2f2a 2066 756e 6320 7573 ); } /* func us │ │ │ │ │ -0000d950: 6564 2075 6e64 6563 6c61 7265 6420 2a2f ed undeclared */ │ │ │ │ │ -0000d960: 0a20 2020 2020 2520 6361 7420 6675 6e63 . % cat func │ │ │ │ │ -0000d970: 2e63 0a20 2020 2020 696e 7420 6675 6e63 .c. int func │ │ │ │ │ -0000d980: 2028 766f 6964 2920 7b20 696e 7420 693b (void) { int i; │ │ │ │ │ -0000d990: 2072 6574 7572 6e20 693b 207d 202f 2a20 return i; } /* │ │ │ │ │ -0000d9a0: 6920 7573 6564 2075 6e69 6e69 7469 616c i used uninitial │ │ │ │ │ -0000d9b0: 697a 6564 202a 2f0a 0a20 2020 2020 5468 ized */.. Th │ │ │ │ │ -0000d9c0: 6520 6d61 6b65 206f 7574 7075 7420 6973 e make output is │ │ │ │ │ -0000d9d0: 2062 7920 6465 6661 756c 7420 7665 7279 by default very │ │ │ │ │ -0000d9e0: 2076 6572 626f 7365 2e20 2054 6869 7320 verbose. This │ │ │ │ │ -0000d9f0: 6361 7573 6573 2077 6172 6e69 6e67 730a causes warnings. │ │ │ │ │ -0000da00: 2020 2020 2066 726f 6d20 7468 6520 636f from the co │ │ │ │ │ -0000da10: 6d70 696c 6572 2074 6f20 6265 2073 6f6d mpiler to be som │ │ │ │ │ -0000da20: 6577 6861 7420 6869 6464 656e 2c20 616e ewhat hidden, an │ │ │ │ │ -0000da30: 6420 6e6f 7420 696d 6d65 6469 6174 6520 d not immediate │ │ │ │ │ -0000da40: 746f 2073 706f 742e 0a20 2020 2020 2520 to spot.. % │ │ │ │ │ -0000da50: 6d61 6b65 2043 464c 4147 533d 2d57 616c make CFLAGS=-Wal │ │ │ │ │ -0000da60: 6c0a 2020 2020 2067 6363 202d 4450 4143 l. gcc -DPAC │ │ │ │ │ -0000da70: 4b41 4745 5f4e 414d 453d 5c22 666f 6f5c KAGE_NAME=\"foo\ │ │ │ │ │ -0000da80: 2220 2d44 5041 434b 4147 455f 5441 524e " -DPACKAGE_TARN │ │ │ │ │ -0000da90: 414d 453d 5c22 666f 6f5c 2220 2e2e 2e0a AME=\"foo\" .... │ │ │ │ │ -0000daa0: 2020 2020 202d 4450 4143 4b41 4745 5f53 -DPACKAGE_S │ │ │ │ │ -0000dab0: 5452 494e 473d 5c22 666f 6f5c 2031 2e30 TRING=\"foo\ 1.0 │ │ │ │ │ -0000dac0: 5c22 202d 4450 4143 4b41 4745 5f42 5547 \" -DPACKAGE_BUG │ │ │ │ │ -0000dad0: 5245 504f 5254 3d5c 225c 2220 2e2e 2e0a REPORT=\"\" .... │ │ │ │ │ -0000dae0: 2020 2020 202d 4450 4143 4b41 4745 3d5c -DPACKAGE=\ │ │ │ │ │ -0000daf0: 2266 6f6f 5c22 202d 4456 4552 5349 4f4e "foo\" -DVERSION │ │ │ │ │ -0000db00: 3d5c 2231 2e30 5c22 202d 492e 202d 5761 =\"1.0\" -I. -Wa │ │ │ │ │ -0000db10: 6c6c 202d 4d54 206d 6169 6e2e 6f0a 2020 ll -MT main.o. │ │ │ │ │ -0000db20: 2020 202d 4d44 202d 4d50 202d 4d46 202e -MD -MP -MF . │ │ │ │ │ -0000db30: 6465 7073 2f6d 6169 6e2e 5470 6f20 2d63 deps/main.Tpo -c │ │ │ │ │ -0000db40: 202d 6f20 6d61 696e 2e6f 206d 6169 6e2e -o main.o main. │ │ │ │ │ -0000db50: 630a 2020 2020 206d 6169 6e2e 633a 2049 c. main.c: I │ │ │ │ │ -0000db60: 6e20 6675 6e63 7469 6f6e 20e2 8098 6d61 n function ...ma │ │ │ │ │ -0000db70: 696e e280 993a 0a20 2020 2020 6d61 696e in...:. main │ │ │ │ │ -0000db80: 2e63 3a33 3a33 3a20 7761 726e 696e 673a .c:3:3: warning: │ │ │ │ │ -0000db90: 2069 6d70 6c69 6369 7420 6465 636c 6172 implicit declar │ │ │ │ │ -0000dba0: 6174 696f 6e20 6f66 2066 756e 6374 696f ation of functio │ │ │ │ │ -0000dbb0: 6e20 e280 9866 756e 63e2 8099 0a20 2020 n ...func.... │ │ │ │ │ -0000dbc0: 2020 6d76 202d 6620 2e64 6570 732f 6d61 mv -f .deps/ma │ │ │ │ │ -0000dbd0: 696e 2e54 706f 202e 6465 7073 2f6d 6169 in.Tpo .deps/mai │ │ │ │ │ -0000dbe0: 6e2e 506f 0a20 2020 2020 6763 6320 2d44 n.Po. gcc -D │ │ │ │ │ -0000dbf0: 5041 434b 4147 455f 4e41 4d45 3d5c 2266 PACKAGE_NAME=\"f │ │ │ │ │ -0000dc00: 6f6f 5c22 202d 4450 4143 4b41 4745 5f54 oo\" -DPACKAGE_T │ │ │ │ │ -0000dc10: 4152 4e41 4d45 3d5c 2266 6f6f 5c22 202e ARNAME=\"foo\" . │ │ │ │ │ -0000dc20: 2e2e 0a20 2020 2020 2d44 5041 434b 4147 ... -DPACKAG │ │ │ │ │ -0000dc30: 455f 5354 5249 4e47 3d5c 2266 6f6f 5c20 E_STRING=\"foo\ │ │ │ │ │ -0000dc40: 312e 305c 2220 2d44 5041 434b 4147 455f 1.0\" -DPACKAGE_ │ │ │ │ │ -0000dc50: 4255 4752 4550 4f52 543d 5c22 5c22 202e BUGREPORT=\"\" . │ │ │ │ │ -0000dc60: 2e2e 0a20 2020 2020 2d44 5041 434b 4147 ... -DPACKAG │ │ │ │ │ -0000dc70: 453d 5c22 666f 6f5c 2220 2d44 5645 5253 E=\"foo\" -DVERS │ │ │ │ │ -0000dc80: 494f 4e3d 5c22 312e 305c 2220 2d49 2e20 ION=\"1.0\" -I. │ │ │ │ │ -0000dc90: 2d57 616c 6c20 2d4d 5420 6675 6e63 2e6f -Wall -MT func.o │ │ │ │ │ -0000dca0: 0a20 2020 2020 2d4d 4420 2d4d 5020 2d4d . -MD -MP -M │ │ │ │ │ -0000dcb0: 4620 2e64 6570 732f 6675 6e63 2e54 706f F .deps/func.Tpo │ │ │ │ │ -0000dcc0: 202d 6320 2d6f 2066 756e 632e 6f20 6675 -c -o func.o fu │ │ │ │ │ -0000dcd0: 6e63 2e63 0a20 2020 2020 6675 6e63 2e63 nc.c. func.c │ │ │ │ │ -0000dce0: 3a20 496e 2066 756e 6374 696f 6e20 e280 : In function .. │ │ │ │ │ -0000dcf0: 9866 756e 63e2 8099 3a0a 2020 2020 2066 .func...:. f │ │ │ │ │ -0000dd00: 756e 632e 633a 343a 333a 2077 6172 6e69 unc.c:4:3: warni │ │ │ │ │ -0000dd10: 6e67 3a20 e280 9869 e280 9920 7573 6564 ng: ...i... used │ │ │ │ │ -0000dd20: 2075 6e69 6e69 7469 616c 697a 6564 2069 uninitialized i │ │ │ │ │ -0000dd30: 6e20 7468 6973 2066 756e 6374 696f 6e0a n this function. │ │ │ │ │ -0000dd40: 2020 2020 206d 7620 2d66 202e 6465 7073 mv -f .deps │ │ │ │ │ -0000dd50: 2f66 756e 632e 5470 6f20 2e64 6570 732f /func.Tpo .deps/ │ │ │ │ │ -0000dd60: 6675 6e63 2e50 6f0a 2020 2020 2067 6363 func.Po. gcc │ │ │ │ │ -0000dd70: 202d 5761 6c6c 202d 6f20 666f 6f20 6d61 -Wall -o foo ma │ │ │ │ │ -0000dd80: 696e 2e6f 2066 756e 632e 6f0a 0a20 2020 in.o func.o.. │ │ │ │ │ -0000dd90: 2020 436c 6561 6e20 7570 2c20 736f 2074 Clean up, so t │ │ │ │ │ -0000dda0: 6861 7420 7765 2077 6520 6361 6e20 7265 hat we we can re │ │ │ │ │ -0000ddb0: 6275 696c 6420 6576 6572 7974 6869 6e67 build everything │ │ │ │ │ -0000ddc0: 2066 726f 6d20 7363 7261 7463 682e 0a20 from scratch.. │ │ │ │ │ -0000ddd0: 2020 2020 2520 6d61 6b65 2063 6c65 616e % make clean │ │ │ │ │ -0000dde0: 0a20 2020 2020 7465 7374 202d 7a20 2266 . test -z "f │ │ │ │ │ -0000ddf0: 6f6f 2220 7c7c 2072 6d20 2d66 2066 6f6f oo" || rm -f foo │ │ │ │ │ -0000de00: 0a20 2020 2020 726d 202d 6620 2a2e 6f0a . rm -f *.o. │ │ │ │ │ -0000de10: 0a20 2020 2020 5369 6c65 6e74 2072 756c . Silent rul │ │ │ │ │ -0000de20: 6573 2065 6e61 626c 6564 3a20 7468 6520 es enabled: the │ │ │ │ │ -0000de30: 6f75 7470 7574 2069 7320 6d69 6e69 6d61 output is minima │ │ │ │ │ -0000de40: 6c20 6275 7420 696e 666f 726d 6174 6976 l but informativ │ │ │ │ │ -0000de50: 652e 2020 496e 0a20 2020 2020 7061 7274 e. In. part │ │ │ │ │ -0000de60: 6963 756c 6172 2c20 7468 6520 7761 726e icular, the warn │ │ │ │ │ -0000de70: 696e 6773 2066 726f 6d20 7468 6520 636f ings from the co │ │ │ │ │ -0000de80: 6d70 696c 6572 2073 7469 636b 206f 7574 mpiler stick out │ │ │ │ │ -0000de90: 2076 6572 7920 636c 6561 726c 792e 0a20 very clearly.. │ │ │ │ │ -0000dea0: 2020 2020 2520 6d61 6b65 2056 3d30 2043 % make V=0 C │ │ │ │ │ -0000deb0: 464c 4147 533d 2d57 616c 6c0a 2020 2020 FLAGS=-Wall. │ │ │ │ │ -0000dec0: 2020 2043 4320 2020 2020 6d61 696e 2e6f CC main.o │ │ │ │ │ -0000ded0: 0a20 2020 2020 6d61 696e 2e63 3a20 496e . main.c: In │ │ │ │ │ -0000dee0: 2066 756e 6374 696f 6e20 e280 986d 6169 function ...mai │ │ │ │ │ -0000def0: 6ee2 8099 3a0a 2020 2020 206d 6169 6e2e n...:. main. │ │ │ │ │ -0000df00: 633a 333a 333a 2077 6172 6e69 6e67 3a20 c:3:3: warning: │ │ │ │ │ -0000df10: 696d 706c 6963 6974 2064 6563 6c61 7261 implicit declara │ │ │ │ │ -0000df20: 7469 6f6e 206f 6620 6675 6e63 7469 6f6e tion of function │ │ │ │ │ -0000df30: 20e2 8098 6675 6e63 e280 990a 2020 2020 ...func.... │ │ │ │ │ -0000df40: 2020 2043 4320 2020 2020 6675 6e63 2e6f CC func.o │ │ │ │ │ -0000df50: 0a20 2020 2020 6675 6e63 2e63 3a20 496e . func.c: In │ │ │ │ │ -0000df60: 2066 756e 6374 696f 6e20 e280 9866 756e function ...fun │ │ │ │ │ -0000df70: 63e2 8099 3a0a 2020 2020 2066 756e 632e c...:. func. │ │ │ │ │ -0000df80: 633a 343a 333a 2077 6172 6e69 6e67 3a20 c:4:3: warning: │ │ │ │ │ -0000df90: e280 9869 e280 9920 7573 6564 2075 6e69 ...i... used uni │ │ │ │ │ -0000dfa0: 6e69 7469 616c 697a 6564 2069 6e20 7468 nitialized in th │ │ │ │ │ -0000dfb0: 6973 2066 756e 6374 696f 6e0a 2020 2020 is function. │ │ │ │ │ -0000dfc0: 2020 2043 434c 4420 2020 666f 6f0a 0a20 CCLD foo.. │ │ │ │ │ -0000dfd0: 2020 416c 736f 2c20 696e 2070 726f 6a65 Also, in proje │ │ │ │ │ -0000dfe0: 6374 7320 7573 696e 6720 276c 6962 746f cts using 'libto │ │ │ │ │ -0000dff0: 6f6c 272c 2074 6865 2075 7365 206f 6620 ol', the use of │ │ │ │ │ -0000e000: 7369 6c65 6e74 2072 756c 6573 2063 616e silent rules can │ │ │ │ │ -0000e010: 0a61 7574 6f6d 6174 6963 616c 6c79 2065 .automatically e │ │ │ │ │ -0000e020: 6e61 626c 6520 7468 6520 276c 6962 746f nable the 'libto │ │ │ │ │ -0000e030: 6f6c 2727 7320 272d 2d73 696c 656e 7427 ol''s '--silent' │ │ │ │ │ -0000e040: 206f 7074 696f 6e3a 0a0a 2020 2020 2025 option:.. % │ │ │ │ │ -0000e050: 2063 6174 204d 616b 6566 696c 652e 616d cat Makefile.am │ │ │ │ │ -0000e060: 0a20 2020 2020 6c69 625f 4c54 4c49 4252 . lib_LTLIBR │ │ │ │ │ -0000e070: 4152 4945 5320 3d20 6c69 6278 2e6c 610a ARIES = libx.la. │ │ │ │ │ -0000e080: 0a20 2020 2020 2520 6d61 6b65 2023 2042 . % make # B │ │ │ │ │ -0000e090: 6f74 6820 6d61 6b65 2061 6e64 206c 6962 oth make and lib │ │ │ │ │ -0000e0a0: 746f 6f6c 2061 7265 2076 6572 626f 7365 tool are verbose │ │ │ │ │ -0000e0b0: 2062 7920 6465 6661 756c 742e 0a20 2020 by default.. │ │ │ │ │ -0000e0c0: 2020 2e2e 2e0a 2020 2020 206c 6962 746f .... libto │ │ │ │ │ -0000e0d0: 6f6c 3a20 636f 6d70 696c 653a 2067 6363 ol: compile: gcc │ │ │ │ │ -0000e0e0: 202d 4450 4143 4b41 4745 5f4e 414d 453d -DPACKAGE_NAME= │ │ │ │ │ -0000e0f0: 5c22 666f 6f5c 2220 2e2e 2e20 2d44 4c54 \"foo\" ... -DLT │ │ │ │ │ -0000e100: 5f4f 424a 4449 523d 5c22 2e6c 6962 732f _OBJDIR=\".libs/ │ │ │ │ │ -0000e110: 5c22 0a20 2020 2020 2020 2d49 2e20 2d67 \". -I. -g │ │ │ │ │ -0000e120: 202d 4f32 202d 4d54 206c 6962 782e 6c6f -O2 -MT libx.lo │ │ │ │ │ -0000e130: 202d 4d44 202d 4d50 202d 4d46 202e 6465 -MD -MP -MF .de │ │ │ │ │ -0000e140: 7073 2f6c 6962 782e 5470 6f20 2d63 206c ps/libx.Tpo -c l │ │ │ │ │ -0000e150: 6962 782e 6320 2d66 5049 430a 2020 2020 ibx.c -fPIC. │ │ │ │ │ -0000e160: 2020 202d 4450 4943 202d 6f20 2e6c 6962 -DPIC -o .lib │ │ │ │ │ -0000e170: 732f 6c69 6278 2e6f 0a20 2020 2020 6d76 s/libx.o. mv │ │ │ │ │ -0000e180: 202d 6620 2e64 6570 732f 6c69 6278 2e54 -f .deps/libx.T │ │ │ │ │ -0000e190: 706f 202e 6465 7073 2f6c 6962 782e 506c po .deps/libx.Pl │ │ │ │ │ -0000e1a0: 6f0a 2020 2020 202f 6269 6e2f 7368 202e o. /bin/sh . │ │ │ │ │ -0000e1b0: 2f6c 6962 746f 6f6c 202d 2d74 6167 3d43 /libtool --tag=C │ │ │ │ │ -0000e1c0: 4320 2d2d 6d6f 6465 3d6c 696e 6b20 6763 C --mode=link gc │ │ │ │ │ -0000e1d0: 6320 2d67 202d 4f32 202d 6f20 6c69 6278 c -g -O2 -o libx │ │ │ │ │ -0000e1e0: 2e6c 6120 2d72 7061 7468 0a20 2020 2020 .la -rpath. │ │ │ │ │ -0000e1f0: 2020 2f75 7372 2f6c 6f63 616c 2f6c 6962 /usr/local/lib │ │ │ │ │ -0000e200: 206c 6962 782e 6c6f 0a20 2020 2020 6c69 libx.lo. li │ │ │ │ │ -0000e210: 6274 6f6f 6c3a 206c 696e 6b3a 2067 6363 btool: link: gcc │ │ │ │ │ -0000e220: 202d 7368 6172 6564 202e 6c69 6273 2f6c -shared .libs/l │ │ │ │ │ -0000e230: 6962 782e 6f20 2d57 6c2c 2d73 6f6e 616d ibx.o -Wl,-sonam │ │ │ │ │ -0000e240: 6520 2d57 6c2c 6c69 6278 2e73 6f2e 300a e -Wl,libx.so.0. │ │ │ │ │ -0000e250: 2020 2020 2020 202d 6f20 2e6c 6962 732f -o .libs/ │ │ │ │ │ -0000e260: 6c69 6278 2e73 6f2e 302e 302e 300a 2020 libx.so.0.0.0. │ │ │ │ │ -0000e270: 2020 206c 6962 746f 6f6c 3a20 6c69 6e6b libtool: link │ │ │ │ │ -0000e280: 3a20 6364 202e 6c69 6273 2026 2620 726d : cd .libs && rm │ │ │ │ │ -0000e290: 202d 6620 6c69 6278 2e73 6f20 2626 206c -f libx.so && l │ │ │ │ │ -0000e2a0: 6e20 2d73 206c 6962 782e 736f 2e30 2e30 n -s libx.so.0.0 │ │ │ │ │ -0000e2b0: 2e30 206c 6962 782e 736f 0a20 2020 2020 .0 libx.so. │ │ │ │ │ -0000e2c0: 2e2e 2e0a 0a20 2020 2020 2520 6d61 6b65 ..... % make │ │ │ │ │ -0000e2d0: 2056 3d30 0a20 2020 2020 2020 4343 2020 V=0. CC │ │ │ │ │ -0000e2e0: 2020 206c 6962 782e 6c6f 0a20 2020 2020 libx.lo. │ │ │ │ │ -0000e2f0: 2020 4343 4c44 2020 206c 6962 782e 6c61 CCLD libx.la │ │ │ │ │ -0000e300: 0a0a 2020 204c 6574 2773 206e 6f77 2073 .. Let's now s │ │ │ │ │ -0000e310: 6565 2068 6f77 2074 6865 2027 7369 6c65 ee how the 'sile │ │ │ │ │ -0000e320: 6e74 2d72 756c 6573 2720 6d6f 6465 2069 nt-rules' mode i │ │ │ │ │ -0000e330: 6e74 6572 6661 6365 7320 7769 7468 2074 nterfaces with t │ │ │ │ │ -0000e340: 6865 2070 6163 6b61 6765 0a64 6576 656c he package.devel │ │ │ │ │ -0000e350: 6f70 6572 2061 6e64 2074 6865 2070 6163 oper and the pac │ │ │ │ │ -0000e360: 6b61 6765 2075 7365 722e 0a0a 2020 2054 kage user... T │ │ │ │ │ -0000e370: 6f20 656e 6162 6c65 2074 6865 2075 7365 o enable the use │ │ │ │ │ -0000e380: 206f 6620 2773 696c 656e 742d 7275 6c65 of 'silent-rule │ │ │ │ │ -0000e390: 7327 2069 6e20 6869 7320 7061 636b 6167 s' in his packag │ │ │ │ │ -0000e3a0: 652c 2061 2064 6576 656c 6f70 6572 206e e, a developer n │ │ │ │ │ -0000e3b0: 6565 6473 0a74 6f20 646f 2065 6974 6865 eeds.to do eithe │ │ │ │ │ -0000e3c0: 7220 6f66 2074 6865 2066 6f6c 6c6f 7769 r of the followi │ │ │ │ │ -0000e3d0: 6e67 3a0a 0a20 2020 2a20 4164 6420 7468 ng:.. * Add th │ │ │ │ │ -0000e3e0: 6520 2773 696c 656e 742d 7275 6c65 7327 e 'silent-rules' │ │ │ │ │ -0000e3f0: 206f 7074 696f 6e20 6173 2061 7267 756d option as argum │ │ │ │ │ -0000e400: 656e 7420 746f 2027 414d 5f49 4e49 545f ent to 'AM_INIT_ │ │ │ │ │ -0000e410: 4155 544f 4d41 4b45 272e 0a20 2020 2a20 AUTOMAKE'.. * │ │ │ │ │ -0000e420: 4361 6c6c 2074 6865 2027 414d 5f53 494c Call the 'AM_SIL │ │ │ │ │ -0000e430: 454e 545f 5255 4c45 5327 206d 6163 726f ENT_RULES' macro │ │ │ │ │ -0000e440: 2066 726f 6d20 7769 7468 696e 2074 6865 from within the │ │ │ │ │ -0000e450: 2027 636f 6e66 6967 7572 652e 6163 270a 'configure.ac'. │ │ │ │ │ -0000e460: 2020 2020 2066 696c 652e 0a0a 2020 2049 file... I │ │ │ │ │ -0000e470: 7420 6973 206e 6f74 2070 6f73 7369 626c t is not possibl │ │ │ │ │ -0000e480: 6520 746f 2069 6e73 7465 6164 2073 7065 e to instead spe │ │ │ │ │ -0000e490: 6369 6679 2027 7369 6c65 6e74 2d72 756c cify 'silent-rul │ │ │ │ │ -0000e4a0: 6573 2720 696e 2061 0a27 4d61 6b65 6669 es' in a.'Makefi │ │ │ │ │ -0000e4b0: 6c65 2e61 6d27 2066 696c 652e 0a0a 2020 le.am' file... │ │ │ │ │ -0000e4c0: 2049 6620 7468 6520 6465 7665 6c6f 7065 If the develope │ │ │ │ │ -0000e4d0: 7220 6861 7320 646f 6e65 2065 6974 6865 r has done eithe │ │ │ │ │ -0000e4e0: 7220 6f66 2074 6865 2061 626f 7665 2c20 r of the above, │ │ │ │ │ -0000e4f0: 7468 656e 2074 6865 2075 7365 7220 6f66 then the user of │ │ │ │ │ -0000e500: 2074 6865 0a70 6163 6b61 6765 206d 6179 the.package may │ │ │ │ │ -0000e510: 2069 6e66 6c75 656e 6365 2074 6865 2076 influence the v │ │ │ │ │ -0000e520: 6572 626f 7369 7479 2061 7420 2763 6f6e erbosity at 'con │ │ │ │ │ -0000e530: 6669 6775 7265 2720 7275 6e20 7469 6d65 figure' run time │ │ │ │ │ -0000e540: 2061 7320 7765 6c6c 2061 730a 6174 2027 as well as.at ' │ │ │ │ │ -0000e550: 6d61 6b65 2720 7275 6e20 7469 6d65 3a0a make' run time:. │ │ │ │ │ -0000e560: 0a20 2020 2a20 5061 7373 696e 6720 272d . * Passing '- │ │ │ │ │ -0000e570: 2d65 6e61 626c 652d 7369 6c65 6e74 2d72 -enable-silent-r │ │ │ │ │ -0000e580: 756c 6573 2720 746f 2027 636f 6e66 6967 ules' to 'config │ │ │ │ │ -0000e590: 7572 6527 2077 696c 6c20 6361 7573 6520 ure' will cause │ │ │ │ │ -0000e5a0: 6275 696c 640a 2020 2020 2072 756c 6573 build. rules │ │ │ │ │ -0000e5b0: 2074 6f20 6265 206c 6573 7320 7665 7262 to be less verb │ │ │ │ │ -0000e5c0: 6f73 653b 2074 6865 206f 7074 696f 6e20 ose; the option │ │ │ │ │ -0000e5d0: 272d 2d64 6973 6162 6c65 2d73 696c 656e '--disable-silen │ │ │ │ │ -0000e5e0: 742d 7275 6c65 7327 2077 696c 6c0a 2020 t-rules' will. │ │ │ │ │ -0000e5f0: 2020 2063 6175 7365 206e 6f72 6d61 6c20 cause normal │ │ │ │ │ -0000e600: 7665 7262 6f73 6520 6f75 7470 7574 2e0a verbose output.. │ │ │ │ │ -0000e610: 2020 202a 2041 7420 276d 616b 6527 2072 * At 'make' r │ │ │ │ │ -0000e620: 756e 2074 696d 652c 2074 6865 2064 6566 un time, the def │ │ │ │ │ -0000e630: 6175 6c74 2063 686f 7365 6e20 6174 2027 ault chosen at ' │ │ │ │ │ -0000e640: 636f 6e66 6967 7572 6527 2074 696d 6520 configure' time │ │ │ │ │ -0000e650: 6d61 7920 6265 0a20 2020 2020 6f76 6572 may be. over │ │ │ │ │ -0000e660: 7269 6464 656e 3a20 276d 616b 6520 563d ridden: 'make V= │ │ │ │ │ -0000e670: 3127 2077 696c 6c20 7072 6f64 7563 6520 1' will produce │ │ │ │ │ -0000e680: 7665 7262 6f73 6520 6f75 7470 7574 2c20 verbose output, │ │ │ │ │ -0000e690: 276d 616b 6520 563d 3027 206c 6573 730a 'make V=0' less. │ │ │ │ │ -0000e6a0: 2020 2020 2076 6572 626f 7365 206f 7574 verbose out │ │ │ │ │ -0000e6b0: 7075 742e 0a0a 2020 204e 6f74 6520 7468 put... Note th │ │ │ │ │ -0000e6c0: 6174 2073 696c 656e 7420 7275 6c65 7320 at silent rules │ │ │ │ │ -0000e6d0: 6172 6520 5f64 6973 6162 6c65 645f 2062 are _disabled_ b │ │ │ │ │ -0000e6e0: 7920 6465 6661 756c 743b 2074 6865 2075 y default; the u │ │ │ │ │ -0000e6f0: 7365 7220 6d75 7374 0a65 6e61 626c 6520 ser must.enable │ │ │ │ │ -0000e700: 7468 656d 2065 7870 6c69 6369 746c 7920 them explicitly │ │ │ │ │ -0000e710: 6174 2065 6974 6865 7220 2763 6f6e 6669 at either 'confi │ │ │ │ │ -0000e720: 6775 7265 2720 7275 6e20 7469 6d65 206f gure' run time o │ │ │ │ │ -0000e730: 7220 6174 2027 6d61 6b65 2720 7275 6e0a r at 'make' run. │ │ │ │ │ -0000e740: 7469 6d65 2e20 2057 6520 7468 696e 6b20 time. We think │ │ │ │ │ -0000e750: 7468 6174 2074 6869 7320 6973 2061 2067 that this is a g │ │ │ │ │ -0000e760: 6f6f 6420 706f 6c69 6379 2c20 7369 6e63 ood policy, sinc │ │ │ │ │ -0000e770: 6520 6974 2070 726f 7669 6465 7320 7468 e it provides th │ │ │ │ │ -0000e780: 6520 6361 7375 616c 0a75 7365 7220 7769 e casual.user wi │ │ │ │ │ -0000e790: 7468 2065 6e6f 7567 6820 696e 666f 726d th enough inform │ │ │ │ │ -0000e7a0: 6174 696f 6e20 746f 2070 7265 7061 7265 ation to prepare │ │ │ │ │ -0000e7b0: 2061 2067 6f6f 6420 6275 6720 7265 706f a good bug repo │ │ │ │ │ -0000e7c0: 7274 2069 6e20 6361 7365 0a61 6e79 7468 rt in case.anyth │ │ │ │ │ -0000e7d0: 696e 6720 6272 6561 6b73 2e0a 0a20 2020 ing breaks... │ │ │ │ │ -0000e7e0: 5374 696c 6c2c 206e 6f74 7769 7468 7374 Still, notwithst │ │ │ │ │ -0000e7f0: 616e 6469 6e67 2074 6865 2072 6174 696f anding the ratio │ │ │ │ │ -0000e800: 6e61 6c65 7320 6162 6f76 652c 2061 2064 nales above, a d │ │ │ │ │ -0000e810: 6576 656c 6f70 6572 2077 686f 2077 616e eveloper who wan │ │ │ │ │ -0000e820: 7473 2074 6f0a 6d61 6b65 2073 696c 656e ts to.make silen │ │ │ │ │ -0000e830: 7420 7275 6c65 7320 656e 6162 6c65 6420 t rules enabled │ │ │ │ │ -0000e840: 6279 2064 6566 6175 6c74 2069 6e20 6869 by default in hi │ │ │ │ │ -0000e850: 7320 6f77 6e20 7061 636b 6167 6520 6361 s own package ca │ │ │ │ │ -0000e860: 6e20 646f 2073 6f20 6279 0a61 6464 696e n do so by.addin │ │ │ │ │ -0000e870: 6720 6120 2779 6573 2720 6172 6775 6d65 g a 'yes' argume │ │ │ │ │ -0000e880: 6e74 2074 6f20 7468 6520 2741 4d5f 5349 nt to the 'AM_SI │ │ │ │ │ -0000e890: 4c45 4e54 5f52 554c 4553 2720 6361 6c6c LENT_RULES' call │ │ │ │ │ -0000e8a0: 2069 6e20 2763 6f6e 6669 6775 7265 2e61 in 'configure.a │ │ │ │ │ -0000e8b0: 6327 2e0a 5765 2061 6476 6973 6520 6167 c'..We advise ag │ │ │ │ │ -0000e8c0: 6169 6e73 7420 7468 6973 2061 7070 726f ainst this appro │ │ │ │ │ -0000e8d0: 6163 682c 2074 686f 7567 682e 0a0a 2020 ach, though... │ │ │ │ │ -0000e8e0: 2055 7365 7273 2077 686f 2070 7265 6665 Users who prefe │ │ │ │ │ -0000e8f0: 7220 746f 2068 6176 6520 7369 6c65 6e74 r to have silent │ │ │ │ │ -0000e900: 2072 756c 6573 2065 6e61 626c 6564 2062 rules enabled b │ │ │ │ │ -0000e910: 7920 6465 6661 756c 7420 6361 6e20 6564 y default can ed │ │ │ │ │ -0000e920: 6974 0a74 6865 6972 2027 636f 6e66 6967 it.their 'config │ │ │ │ │ -0000e930: 2e73 6974 6527 2066 696c 6520 746f 206d .site' file to m │ │ │ │ │ -0000e940: 616b 6520 7468 6520 7661 7269 6162 6c65 ake the variable │ │ │ │ │ -0000e950: 2027 656e 6162 6c65 5f73 696c 656e 745f 'enable_silent_ │ │ │ │ │ -0000e960: 7275 6c65 7327 0a64 6566 6175 6c74 2074 rules'.default t │ │ │ │ │ -0000e970: 6f20 2779 6573 272e 2020 5468 6973 2073 o 'yes'. This s │ │ │ │ │ -0000e980: 686f 756c 6420 7374 696c 6c20 616c 6c6f hould still allo │ │ │ │ │ -0000e990: 7720 6469 7361 626c 696e 6720 7369 6c65 w disabling sile │ │ │ │ │ -0000e9a0: 6e74 2072 756c 6573 2061 740a 2763 6f6e nt rules at.'con │ │ │ │ │ -0000e9b0: 6669 6775 7265 2720 7469 6d65 2061 6e64 figure' time and │ │ │ │ │ -0000e9c0: 2061 7420 276d 616b 6527 2074 696d 652e at 'make' time. │ │ │ │ │ -0000e9d0: 0a0a 2020 2046 6f72 2070 6f72 7461 6269 .. For portabi │ │ │ │ │ -0000e9e0: 6c69 7479 2074 6f20 6469 6666 6572 656e lity to differen │ │ │ │ │ -0000e9f0: 7420 276d 616b 6527 2069 6d70 6c65 6d65 t 'make' impleme │ │ │ │ │ -0000ea00: 6e74 6174 696f 6e73 2c20 7061 636b 6167 ntations, packag │ │ │ │ │ -0000ea10: 6520 6175 7468 6f72 730a 6172 6520 6164 e authors.are ad │ │ │ │ │ -0000ea20: 7669 7365 6420 746f 206e 6f74 2073 6574 vised to not set │ │ │ │ │ -0000ea30: 2074 6865 2076 6172 6961 626c 6520 2756 the variable 'V │ │ │ │ │ -0000ea40: 2720 696e 7369 6465 2074 6865 2027 4d61 ' inside the 'Ma │ │ │ │ │ -0000ea50: 6b65 6669 6c65 2e61 6d27 2066 696c 652c kefile.am' file, │ │ │ │ │ -0000ea60: 0a74 6f20 616c 6c6f 7720 7468 6520 7573 .to allow the us │ │ │ │ │ -0000ea70: 6572 2074 6f20 6f76 6572 7269 6465 2074 er to override t │ │ │ │ │ -0000ea80: 6865 2076 616c 7565 2066 6f72 2073 7562 he value for sub │ │ │ │ │ -0000ea90: 6469 7265 6374 6f72 6965 7320 6173 2077 directories as w │ │ │ │ │ -0000eaa0: 656c 6c2e 0a0a 2020 2054 6865 2063 7572 ell... The cur │ │ │ │ │ -0000eab0: 7265 6e74 2069 6d70 6c65 6d65 6e74 6174 rent implementat │ │ │ │ │ -0000eac0: 696f 6e20 6f66 2074 6869 7320 6665 6174 ion of this feat │ │ │ │ │ -0000ead0: 7572 6520 6e6f 726d 616c 6c79 2075 7365 ure normally use │ │ │ │ │ -0000eae0: 7320 6e65 7374 6564 0a76 6172 6961 626c s nested.variabl │ │ │ │ │ -0000eaf0: 6520 6578 7061 6e73 696f 6e20 2724 2856 e expansion '$(V │ │ │ │ │ -0000eb00: 4152 3124 2856 2929 272c 2061 2027 4d61 AR1$(V))', a 'Ma │ │ │ │ │ -0000eb10: 6b65 6669 6c65 2720 6665 6174 7572 6520 kefile' feature │ │ │ │ │ -0000eb20: 7468 6174 2069 7320 6e6f 740a 7265 7175 that is not.requ │ │ │ │ │ -0000eb30: 6972 6564 2062 7920 504f 5349 5820 3230 ired by POSIX 20 │ │ │ │ │ -0000eb40: 3038 2062 7574 2069 7320 7769 6465 6c79 08 but is widely │ │ │ │ │ -0000eb50: 2073 7570 706f 7274 6564 2069 6e20 7072 supported in pr │ │ │ │ │ -0000eb60: 6163 7469 6365 2e20 2054 6865 0a27 7369 actice. The.'si │ │ │ │ │ -0000eb70: 6c65 6e74 2d72 756c 6573 2720 6f70 7469 lent-rules' opti │ │ │ │ │ -0000eb80: 6f6e 2074 6875 7320 7475 726e 7320 6f66 on thus turns of │ │ │ │ │ -0000eb90: 6620 7761 726e 696e 6773 2061 626f 7574 f warnings about │ │ │ │ │ -0000eba0: 2072 6563 7572 7369 7665 2076 6172 6961 recursive varia │ │ │ │ │ -0000ebb0: 626c 650a 6578 7061 6e73 696f 6e2c 2077 ble.expansion, w │ │ │ │ │ -0000ebc0: 6869 6368 2061 7265 2069 6e20 7475 726e hich are in turn │ │ │ │ │ -0000ebd0: 2065 6e61 626c 6564 2062 7920 272d 5770 enabled by '-Wp │ │ │ │ │ -0000ebe0: 6f72 7461 6269 6c69 7479 2720 282a 6e6f ortability' (*no │ │ │ │ │ -0000ebf0: 7465 2061 7574 6f6d 616b 650a 496e 766f te automake.Invo │ │ │ │ │ -0000ec00: 6361 7469 6f6e 3a3a 292e 2020 4f6e 2074 cation::). On t │ │ │ │ │ -0000ec10: 6865 2072 6172 6520 276d 616b 6527 2069 he rare 'make' i │ │ │ │ │ -0000ec20: 6d70 6c65 6d65 6e74 6174 696f 6e73 2074 mplementations t │ │ │ │ │ -0000ec30: 6861 7420 646f 206e 6f74 2073 7570 706f hat do not suppo │ │ │ │ │ -0000ec40: 7274 0a6e 6573 7465 6420 7661 7269 6162 rt.nested variab │ │ │ │ │ -0000ec50: 6c65 2065 7870 616e 7369 6f6e 2c20 7768 le expansion, wh │ │ │ │ │ -0000ec60: 6574 6865 7220 7275 6c65 7320 6172 6520 ether rules are │ │ │ │ │ -0000ec70: 7369 6c65 6e74 2069 7320 616c 7761 7973 silent is always │ │ │ │ │ -0000ec80: 2064 6574 6572 6d69 6e65 640a 6174 2063 determined.at c │ │ │ │ │ -0000ec90: 6f6e 6669 6775 7265 2074 696d 652c 2061 onfigure time, a │ │ │ │ │ -0000eca0: 6e64 2063 616e 6e6f 7420 6265 206f 7665 nd cannot be ove │ │ │ │ │ -0000ecb0: 7272 6964 6465 6e20 6174 206d 616b 6520 rridden at make │ │ │ │ │ -0000ecc0: 7469 6d65 2e20 2046 7574 7572 650a 7665 time. Future.ve │ │ │ │ │ -0000ecd0: 7273 696f 6e73 206f 6620 504f 5349 5820 rsions of POSIX │ │ │ │ │ -0000ece0: 6172 6520 6c69 6b65 6c79 2074 6f20 7265 are likely to re │ │ │ │ │ -0000ecf0: 7175 6972 6520 6e65 7374 6564 2076 6172 quire nested var │ │ │ │ │ -0000ed00: 6961 626c 6520 6578 7061 6e73 696f 6e2c iable expansion, │ │ │ │ │ -0000ed10: 2073 6f0a 7468 6973 206d 696e 6f72 206c so.this minor l │ │ │ │ │ -0000ed20: 696d 6974 6174 696f 6e20 7368 6f75 6c64 imitation should │ │ │ │ │ -0000ed30: 2067 6f20 6177 6179 2077 6974 6820 7469 go away with ti │ │ │ │ │ -0000ed40: 6d65 2e0a 0a20 2020 546f 2065 7874 656e me... To exten │ │ │ │ │ -0000ed50: 6420 7468 6520 7369 6c65 6e74 206d 6f64 d the silent mod │ │ │ │ │ -0000ed60: 6520 746f 2079 6f75 7220 6f77 6e20 7275 e to your own ru │ │ │ │ │ -0000ed70: 6c65 732c 2079 6f75 2068 6176 6520 7477 les, you have tw │ │ │ │ │ -0000ed80: 6f20 6368 6f69 6365 733a 0a0a 2020 202a o choices:.. * │ │ │ │ │ -0000ed90: 2059 6f75 2063 616e 2075 7365 2074 6865 You can use the │ │ │ │ │ -0000eda0: 2070 7265 6465 6669 6e65 6420 7661 7269 predefined vari │ │ │ │ │ -0000edb0: 6162 6c65 2027 414d 5f56 5f47 454e 2720 able 'AM_V_GEN' │ │ │ │ │ -0000edc0: 6173 2061 2070 7265 6669 7820 746f 0a20 as a prefix to. │ │ │ │ │ -0000edd0: 2020 2020 636f 6d6d 616e 6473 2074 6861 commands tha │ │ │ │ │ -0000ede0: 7420 7368 6f75 6c64 206f 7574 7075 7420 t should output │ │ │ │ │ -0000edf0: 6120 7374 6174 7573 206c 696e 6520 696e a status line in │ │ │ │ │ -0000ee00: 2073 696c 656e 7420 6d6f 6465 2c20 616e silent mode, an │ │ │ │ │ -0000ee10: 640a 2020 2020 2027 414d 5f56 5f61 7427 d. 'AM_V_at' │ │ │ │ │ -0000ee20: 2061 7320 6120 7072 6566 6978 2074 6f20 as a prefix to │ │ │ │ │ -0000ee30: 636f 6d6d 616e 6473 2074 6861 7420 7368 commands that sh │ │ │ │ │ -0000ee40: 6f75 6c64 206e 6f74 206f 7574 7075 7420 ould not output │ │ │ │ │ -0000ee50: 616e 7974 6869 6e67 0a20 2020 2020 696e anything. in │ │ │ │ │ -0000ee60: 2073 696c 656e 7420 6d6f 6465 2e20 2057 silent mode. W │ │ │ │ │ -0000ee70: 6865 6e20 6f75 7470 7574 2069 7320 746f hen output is to │ │ │ │ │ -0000ee80: 2062 6520 7665 7262 6f73 652c 2062 6f74 be verbose, bot │ │ │ │ │ -0000ee90: 6820 6f66 2074 6865 7365 0a20 2020 2020 h of these. │ │ │ │ │ -0000eea0: 7661 7269 6162 6c65 7320 7769 6c6c 2065 variables will e │ │ │ │ │ -0000eeb0: 7870 616e 6420 746f 2074 6865 2065 6d70 xpand to the emp │ │ │ │ │ -0000eec0: 7479 2073 7472 696e 672e 0a20 2020 2a20 ty string.. * │ │ │ │ │ -0000eed0: 596f 7520 6361 6e20 6164 6420 796f 7572 You can add your │ │ │ │ │ -0000eee0: 206f 776e 2076 6172 6961 626c 6573 2c20 own variables, │ │ │ │ │ -0000eef0: 736f 2073 7472 696e 6773 206f 6620 796f so strings of yo │ │ │ │ │ -0000ef00: 7572 206f 776e 2063 686f 6963 6520 6172 ur own choice ar │ │ │ │ │ -0000ef10: 650a 2020 2020 2073 686f 776e 2e20 2054 e. shown. T │ │ │ │ │ -0000ef20: 6865 2066 6f6c 6c6f 7769 6e67 2073 6e69 he following sni │ │ │ │ │ -0000ef30: 7070 6574 2073 686f 7773 2068 6f77 2079 ppet shows how y │ │ │ │ │ -0000ef40: 6f75 2077 6f75 6c64 2064 6566 696e 6520 ou would define │ │ │ │ │ -0000ef50: 796f 7572 206f 776e 0a20 2020 2020 6571 your own. eq │ │ │ │ │ -0000ef60: 7569 7661 6c65 6e74 206f 6620 2741 4d5f uivalent of 'AM_ │ │ │ │ │ -0000ef70: 565f 4745 4e27 3a0a 0a20 2020 2020 2020 V_GEN':.. │ │ │ │ │ -0000ef80: 2020 2070 6b67 5f76 6572 626f 7365 203d pkg_verbose = │ │ │ │ │ -0000ef90: 2024 2870 6b67 5f76 6572 626f 7365 5f40 $(pkg_verbose_@ │ │ │ │ │ -0000efa0: 414d 5f56 4029 0a20 2020 2020 2020 2020 AM_V@). │ │ │ │ │ -0000efb0: 2070 6b67 5f76 6572 626f 7365 5f20 3d20 pkg_verbose_ = │ │ │ │ │ -0000efc0: 2428 706b 675f 7665 7262 6f73 655f 4041 $(pkg_verbose_@A │ │ │ │ │ -0000efd0: 4d5f 4445 4641 554c 545f 5640 290a 2020 M_DEFAULT_V@). │ │ │ │ │ -0000efe0: 2020 2020 2020 2020 706b 675f 7665 7262 pkg_verb │ │ │ │ │ -0000eff0: 6f73 655f 3020 3d20 4065 6368 6f20 504b ose_0 = @echo PK │ │ │ │ │ -0000f000: 472d 4745 4e20 2440 3b0a 0a20 2020 2020 G-GEN $@;.. │ │ │ │ │ -0000f010: 2020 2020 2066 6f6f 3a20 666f 6f2e 696e foo: foo.in │ │ │ │ │ -0000f020: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -0000f030: 2020 2024 2870 6b67 5f76 6572 626f 7365 $(pkg_verbose │ │ │ │ │ -0000f040: 2963 7020 2428 7372 6364 6972 292f 666f )cp $(srcdir)/fo │ │ │ │ │ -0000f050: 6f2e 696e 2024 400a 0a20 2020 4173 2061 o.in $@.. As a │ │ │ │ │ -0000f060: 2066 696e 616c 206e 6f74 652c 206f 6273 final note, obs │ │ │ │ │ -0000f070: 6572 7665 2074 6861 742c 2065 7665 6e20 erve that, even │ │ │ │ │ -0000f080: 7768 656e 2073 696c 656e 7420 7275 6c65 when silent rule │ │ │ │ │ -0000f090: 7320 6172 6520 656e 6162 6c65 642c 0a74 s are enabled,.t │ │ │ │ │ -0000f0a0: 6865 2027 2d2d 6e6f 2d70 7269 6e74 2d64 he '--no-print-d │ │ │ │ │ -0000f0b0: 6972 6563 746f 7279 2720 6f70 7469 6f6e irectory' option │ │ │ │ │ -0000f0c0: 2069 7320 7374 696c 6c20 7265 7175 6972 is still requir │ │ │ │ │ -0000f0d0: 6564 2077 6974 6820 474e 5520 276d 616b ed with GNU 'mak │ │ │ │ │ -0000f0e0: 6527 2069 660a 7468 6520 2245 6e74 6572 e' if.the "Enter │ │ │ │ │ -0000f0f0: 696e 672f 4c65 6176 696e 6720 6469 7265 ing/Leaving dire │ │ │ │ │ -0000f100: 6374 6f72 7920 2e2e 2e22 2020 6d65 7373 ctory ..." mess │ │ │ │ │ -0000f110: 6167 6573 2061 7265 2074 6f20 6265 2064 ages are to be d │ │ │ │ │ -0000f120: 6973 6162 6c65 642e 0a0a 1f0a 4669 6c65 isabled.....File │ │ │ │ │ -0000f130: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -0000f140: 696e 666f 2c20 204e 6f64 653a 2047 6e69 info, Node: Gni │ │ │ │ │ -0000f150: 7473 2c20 204e 6578 743a 2043 7967 6e75 ts, Next: Cygnu │ │ │ │ │ -0000f160: 732c 2020 5072 6576 3a20 5369 6c65 6e63 s, Prev: Silenc │ │ │ │ │ -0000f170: 696e 6720 4d61 6b65 2c20 2055 703a 2054 ing Make, Up: T │ │ │ │ │ -0000f180: 6f70 0a0a 3232 2054 6865 2065 6666 6563 op..22 The effec │ │ │ │ │ -0000f190: 7420 6f66 2027 2d2d 676e 7527 2061 6e64 t of '--gnu' and │ │ │ │ │ -0000f1a0: 2027 2d2d 676e 6974 7327 0a2a 2a2a 2a2a '--gnits'.***** │ │ │ │ │ +0000d6b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 =============..T │ │ │ │ │ +0000d6c0: 6865 2074 7269 636b 7320 616e 6420 6964 he tricks and id │ │ │ │ │ +0000d6d0: 696f 6d73 2066 6f72 2073 696c 656e 6369 ioms for silenci │ │ │ │ │ +0000d6e0: 6e67 2027 6d61 6b65 2720 6465 7363 7269 ng 'make' descri │ │ │ │ │ +0000d6f0: 6265 6420 696e 2074 6865 2070 7265 7669 bed in the previ │ │ │ │ │ +0000d700: 6f75 730a 7365 6374 696f 6e20 6361 6e20 ous.section can │ │ │ │ │ +0000d710: 6265 2075 7365 6675 6c20 6672 6f6d 2074 be useful from t │ │ │ │ │ +0000d720: 696d 6520 746f 2074 696d 652c 2062 7574 ime to time, but │ │ │ │ │ +0000d730: 2077 6527 7665 2073 6565 6e20 7468 6174 we've seen that │ │ │ │ │ +0000d740: 2074 6865 7920 616c 6c0a 6861 7665 2074 they all.have t │ │ │ │ │ +0000d750: 6865 6972 2073 6572 696f 7573 2064 7261 heir serious dra │ │ │ │ │ +0000d760: 7762 6163 6b73 2061 6e64 206c 696d 6974 wbacks and limit │ │ │ │ │ +0000d770: 6174 696f 6e73 2e20 2054 6861 7427 7320 ations. That's │ │ │ │ │ +0000d780: 7768 7920 6175 746f 6d61 6b65 0a70 726f why automake.pro │ │ │ │ │ +0000d790: 7669 6465 7320 7375 7070 6f72 7420 666f vides support fo │ │ │ │ │ +0000d7a0: 7220 6120 6d6f 7265 2061 6476 616e 6365 r a more advance │ │ │ │ │ +0000d7b0: 6420 616e 6420 666c 6578 6962 6c65 2077 d and flexible w │ │ │ │ │ +0000d7c0: 6179 206f 6620 6f62 7461 696e 696e 670a ay of obtaining. │ │ │ │ │ +0000d7d0: 7175 6965 7465 7220 6f75 7470 7574 2066 quieter output f │ │ │ │ │ +0000d7e0: 726f 6d20 276d 616b 6527 3a20 7468 6520 rom 'make': the │ │ │ │ │ +0000d7f0: 2773 696c 656e 742d 7275 6c65 7327 206d 'silent-rules' m │ │ │ │ │ +0000d800: 6f64 652e 0a0a 2020 2054 6f20 6769 7665 ode... To give │ │ │ │ │ +0000d810: 2074 6865 2067 6973 7420 6f66 2077 6861 the gist of wha │ │ │ │ │ +0000d820: 7420 2773 696c 656e 742d 7275 6c65 7327 t 'silent-rules' │ │ │ │ │ +0000d830: 2063 616e 2064 6f2c 2068 6572 6520 6973 can do, here is │ │ │ │ │ +0000d840: 2061 2073 696d 706c 650a 636f 6d70 6172 a simple.compar │ │ │ │ │ +0000d850: 6973 6f6e 2062 6574 7765 656e 2061 2074 ison between a t │ │ │ │ │ +0000d860: 7970 6963 616c 2027 6d61 6b65 2720 6f75 ypical 'make' ou │ │ │ │ │ +0000d870: 7470 7574 2028 7768 6572 6520 7369 6c65 tput (where sile │ │ │ │ │ +0000d880: 6e74 2072 756c 6573 2061 7265 0a64 6973 nt rules are.dis │ │ │ │ │ +0000d890: 6162 6c65 6429 2061 6e64 206f 6e65 2077 abled) and one w │ │ │ │ │ +0000d8a0: 6974 6820 7369 6c65 6e74 2072 756c 6573 ith silent rules │ │ │ │ │ +0000d8b0: 2065 6e61 626c 6564 3a0a 0a20 2020 2020 enabled:.. │ │ │ │ │ +0000d8c0: 2520 6361 7420 4d61 6b65 6669 6c65 2e61 % cat Makefile.a │ │ │ │ │ +0000d8d0: 6d0a 2020 2020 2062 696e 5f50 524f 4752 m. bin_PROGR │ │ │ │ │ +0000d8e0: 414d 5320 3d20 666f 6f0a 2020 2020 2066 AMS = foo. f │ │ │ │ │ +0000d8f0: 6f6f 5f53 4f55 5243 4553 203d 206d 6169 oo_SOURCES = mai │ │ │ │ │ +0000d900: 6e2e 6320 6675 6e63 2e63 0a20 2020 2020 n.c func.c. │ │ │ │ │ +0000d910: 2520 6361 7420 6d61 696e 2e63 0a20 2020 % cat main.c. │ │ │ │ │ +0000d920: 2020 696e 7420 6d61 696e 2028 766f 6964 int main (void │ │ │ │ │ +0000d930: 2920 7b20 7265 7475 726e 2066 756e 6320 ) { return func │ │ │ │ │ +0000d940: 2829 3b20 7d20 202f 2a20 6675 6e63 2075 (); } /* func u │ │ │ │ │ +0000d950: 7365 6420 756e 6465 636c 6172 6564 202a sed undeclared * │ │ │ │ │ +0000d960: 2f0a 2020 2020 2025 2063 6174 2066 756e /. % cat fun │ │ │ │ │ +0000d970: 632e 630a 2020 2020 2069 6e74 2066 756e c.c. int fun │ │ │ │ │ +0000d980: 6320 2876 6f69 6429 207b 2069 6e74 2069 c (void) { int i │ │ │ │ │ +0000d990: 3b20 7265 7475 726e 2069 3b20 7d20 2f2a ; return i; } /* │ │ │ │ │ +0000d9a0: 2069 2075 7365 6420 756e 696e 6974 6961 i used uninitia │ │ │ │ │ +0000d9b0: 6c69 7a65 6420 2a2f 0a0a 2020 2020 2054 lized */.. T │ │ │ │ │ +0000d9c0: 6865 206d 616b 6520 6f75 7470 7574 2069 he make output i │ │ │ │ │ +0000d9d0: 7320 6279 2064 6566 6175 6c74 2076 6572 s by default ver │ │ │ │ │ +0000d9e0: 7920 7665 7262 6f73 652e 2020 5468 6973 y verbose. This │ │ │ │ │ +0000d9f0: 2063 6175 7365 7320 7761 726e 696e 6773 causes warnings │ │ │ │ │ +0000da00: 0a20 2020 2020 6672 6f6d 2074 6865 2063 . from the c │ │ │ │ │ +0000da10: 6f6d 7069 6c65 7220 746f 2062 6520 736f ompiler to be so │ │ │ │ │ +0000da20: 6d65 7768 6174 2068 6964 6465 6e2c 2061 mewhat hidden, a │ │ │ │ │ +0000da30: 6e64 206e 6f74 2069 6d6d 6564 6961 7465 nd not immediate │ │ │ │ │ +0000da40: 2074 6f20 7370 6f74 2e0a 2020 2020 2025 to spot.. % │ │ │ │ │ +0000da50: 206d 616b 6520 4346 4c41 4753 3d2d 5761 make CFLAGS=-Wa │ │ │ │ │ +0000da60: 6c6c 0a20 2020 2020 6763 6320 2d44 5041 ll. gcc -DPA │ │ │ │ │ +0000da70: 434b 4147 455f 4e41 4d45 3d5c 2266 6f6f CKAGE_NAME=\"foo │ │ │ │ │ +0000da80: 5c22 202d 4450 4143 4b41 4745 5f54 4152 \" -DPACKAGE_TAR │ │ │ │ │ +0000da90: 4e41 4d45 3d5c 2266 6f6f 5c22 202e 2e2e NAME=\"foo\" ... │ │ │ │ │ +0000daa0: 0a20 2020 2020 2d44 5041 434b 4147 455f . -DPACKAGE_ │ │ │ │ │ +0000dab0: 5354 5249 4e47 3d5c 2266 6f6f 5c20 312e STRING=\"foo\ 1. │ │ │ │ │ +0000dac0: 305c 2220 2d44 5041 434b 4147 455f 4255 0\" -DPACKAGE_BU │ │ │ │ │ +0000dad0: 4752 4550 4f52 543d 5c22 5c22 202e 2e2e GREPORT=\"\" ... │ │ │ │ │ +0000dae0: 0a20 2020 2020 2d44 5041 434b 4147 453d . -DPACKAGE= │ │ │ │ │ +0000daf0: 5c22 666f 6f5c 2220 2d44 5645 5253 494f \"foo\" -DVERSIO │ │ │ │ │ +0000db00: 4e3d 5c22 312e 305c 2220 2d49 2e20 2d57 N=\"1.0\" -I. -W │ │ │ │ │ +0000db10: 616c 6c20 2d4d 5420 6d61 696e 2e6f 0a20 all -MT main.o. │ │ │ │ │ +0000db20: 2020 2020 2d4d 4420 2d4d 5020 2d4d 4620 -MD -MP -MF │ │ │ │ │ +0000db30: 2e64 6570 732f 6d61 696e 2e54 706f 202d .deps/main.Tpo - │ │ │ │ │ +0000db40: 6320 2d6f 206d 6169 6e2e 6f20 6d61 696e c -o main.o main │ │ │ │ │ +0000db50: 2e63 0a20 2020 2020 6d61 696e 2e63 3a20 .c. main.c: │ │ │ │ │ +0000db60: 496e 2066 756e 6374 696f 6e20 e280 986d In function ...m │ │ │ │ │ +0000db70: 6169 6ee2 8099 3a0a 2020 2020 206d 6169 ain...:. mai │ │ │ │ │ +0000db80: 6e2e 633a 333a 333a 2077 6172 6e69 6e67 n.c:3:3: warning │ │ │ │ │ +0000db90: 3a20 696d 706c 6963 6974 2064 6563 6c61 : implicit decla │ │ │ │ │ +0000dba0: 7261 7469 6f6e 206f 6620 6675 6e63 7469 ration of functi │ │ │ │ │ +0000dbb0: 6f6e 20e2 8098 6675 6e63 e280 990a 2020 on ...func.... │ │ │ │ │ +0000dbc0: 2020 206d 7620 2d66 202e 6465 7073 2f6d mv -f .deps/m │ │ │ │ │ +0000dbd0: 6169 6e2e 5470 6f20 2e64 6570 732f 6d61 ain.Tpo .deps/ma │ │ │ │ │ +0000dbe0: 696e 2e50 6f0a 2020 2020 2067 6363 202d in.Po. gcc - │ │ │ │ │ +0000dbf0: 4450 4143 4b41 4745 5f4e 414d 453d 5c22 DPACKAGE_NAME=\" │ │ │ │ │ +0000dc00: 666f 6f5c 2220 2d44 5041 434b 4147 455f foo\" -DPACKAGE_ │ │ │ │ │ +0000dc10: 5441 524e 414d 453d 5c22 666f 6f5c 2220 TARNAME=\"foo\" │ │ │ │ │ +0000dc20: 2e2e 2e0a 2020 2020 202d 4450 4143 4b41 .... -DPACKA │ │ │ │ │ +0000dc30: 4745 5f53 5452 494e 473d 5c22 666f 6f5c GE_STRING=\"foo\ │ │ │ │ │ +0000dc40: 2031 2e30 5c22 202d 4450 4143 4b41 4745 1.0\" -DPACKAGE │ │ │ │ │ +0000dc50: 5f42 5547 5245 504f 5254 3d5c 225c 2220 _BUGREPORT=\"\" │ │ │ │ │ +0000dc60: 2e2e 2e0a 2020 2020 202d 4450 4143 4b41 .... -DPACKA │ │ │ │ │ +0000dc70: 4745 3d5c 2266 6f6f 5c22 202d 4456 4552 GE=\"foo\" -DVER │ │ │ │ │ +0000dc80: 5349 4f4e 3d5c 2231 2e30 5c22 202d 492e SION=\"1.0\" -I. │ │ │ │ │ +0000dc90: 202d 5761 6c6c 202d 4d54 2066 756e 632e -Wall -MT func. │ │ │ │ │ +0000dca0: 6f0a 2020 2020 202d 4d44 202d 4d50 202d o. -MD -MP - │ │ │ │ │ +0000dcb0: 4d46 202e 6465 7073 2f66 756e 632e 5470 MF .deps/func.Tp │ │ │ │ │ +0000dcc0: 6f20 2d63 202d 6f20 6675 6e63 2e6f 2066 o -c -o func.o f │ │ │ │ │ +0000dcd0: 756e 632e 630a 2020 2020 2066 756e 632e unc.c. func. │ │ │ │ │ +0000dce0: 633a 2049 6e20 6675 6e63 7469 6f6e 20e2 c: In function . │ │ │ │ │ +0000dcf0: 8098 6675 6e63 e280 993a 0a20 2020 2020 ..func...:. │ │ │ │ │ +0000dd00: 6675 6e63 2e63 3a34 3a33 3a20 7761 726e func.c:4:3: warn │ │ │ │ │ +0000dd10: 696e 673a 20e2 8098 69e2 8099 2075 7365 ing: ...i... use │ │ │ │ │ +0000dd20: 6420 756e 696e 6974 6961 6c69 7a65 6420 d uninitialized │ │ │ │ │ +0000dd30: 696e 2074 6869 7320 6675 6e63 7469 6f6e in this function │ │ │ │ │ +0000dd40: 0a20 2020 2020 6d76 202d 6620 2e64 6570 . mv -f .dep │ │ │ │ │ +0000dd50: 732f 6675 6e63 2e54 706f 202e 6465 7073 s/func.Tpo .deps │ │ │ │ │ +0000dd60: 2f66 756e 632e 506f 0a20 2020 2020 6763 /func.Po. gc │ │ │ │ │ +0000dd70: 6320 2d57 616c 6c20 2d6f 2066 6f6f 206d c -Wall -o foo m │ │ │ │ │ +0000dd80: 6169 6e2e 6f20 6675 6e63 2e6f 0a0a 2020 ain.o func.o.. │ │ │ │ │ +0000dd90: 2020 2043 6c65 616e 2075 702c 2073 6f20 Clean up, so │ │ │ │ │ +0000dda0: 7468 6174 2077 6520 7765 2063 616e 2072 that we we can r │ │ │ │ │ +0000ddb0: 6562 7569 6c64 2065 7665 7279 7468 696e ebuild everythin │ │ │ │ │ +0000ddc0: 6720 6672 6f6d 2073 6372 6174 6368 2e0a g from scratch.. │ │ │ │ │ +0000ddd0: 2020 2020 2025 206d 616b 6520 636c 6561 % make clea │ │ │ │ │ +0000dde0: 6e0a 2020 2020 2074 6573 7420 2d7a 2022 n. test -z " │ │ │ │ │ +0000ddf0: 666f 6f22 207c 7c20 726d 202d 6620 666f foo" || rm -f fo │ │ │ │ │ +0000de00: 6f0a 2020 2020 2072 6d20 2d66 202a 2e6f o. rm -f *.o │ │ │ │ │ +0000de10: 0a0a 2020 2020 2053 696c 656e 7420 7275 .. Silent ru │ │ │ │ │ +0000de20: 6c65 7320 656e 6162 6c65 643a 2074 6865 les enabled: the │ │ │ │ │ +0000de30: 206f 7574 7075 7420 6973 206d 696e 696d output is minim │ │ │ │ │ +0000de40: 616c 2062 7574 2069 6e66 6f72 6d61 7469 al but informati │ │ │ │ │ +0000de50: 7665 2e20 2049 6e0a 2020 2020 2070 6172 ve. In. par │ │ │ │ │ +0000de60: 7469 6375 6c61 722c 2074 6865 2077 6172 ticular, the war │ │ │ │ │ +0000de70: 6e69 6e67 7320 6672 6f6d 2074 6865 2063 nings from the c │ │ │ │ │ +0000de80: 6f6d 7069 6c65 7220 7374 6963 6b20 6f75 ompiler stick ou │ │ │ │ │ +0000de90: 7420 7665 7279 2063 6c65 6172 6c79 2e0a t very clearly.. │ │ │ │ │ +0000dea0: 2020 2020 2025 206d 616b 6520 563d 3020 % make V=0 │ │ │ │ │ +0000deb0: 4346 4c41 4753 3d2d 5761 6c6c 0a20 2020 CFLAGS=-Wall. │ │ │ │ │ +0000dec0: 2020 2020 4343 2020 2020 206d 6169 6e2e CC main. │ │ │ │ │ +0000ded0: 6f0a 2020 2020 206d 6169 6e2e 633a 2049 o. main.c: I │ │ │ │ │ +0000dee0: 6e20 6675 6e63 7469 6f6e 20e2 8098 6d61 n function ...ma │ │ │ │ │ +0000def0: 696e e280 993a 0a20 2020 2020 6d61 696e in...:. main │ │ │ │ │ +0000df00: 2e63 3a33 3a33 3a20 7761 726e 696e 673a .c:3:3: warning: │ │ │ │ │ +0000df10: 2069 6d70 6c69 6369 7420 6465 636c 6172 implicit declar │ │ │ │ │ +0000df20: 6174 696f 6e20 6f66 2066 756e 6374 696f ation of functio │ │ │ │ │ +0000df30: 6e20 e280 9866 756e 63e2 8099 0a20 2020 n ...func.... │ │ │ │ │ +0000df40: 2020 2020 4343 2020 2020 2066 756e 632e CC func. │ │ │ │ │ +0000df50: 6f0a 2020 2020 2066 756e 632e 633a 2049 o. func.c: I │ │ │ │ │ +0000df60: 6e20 6675 6e63 7469 6f6e 20e2 8098 6675 n function ...fu │ │ │ │ │ +0000df70: 6e63 e280 993a 0a20 2020 2020 6675 6e63 nc...:. func │ │ │ │ │ +0000df80: 2e63 3a34 3a33 3a20 7761 726e 696e 673a .c:4:3: warning: │ │ │ │ │ +0000df90: 20e2 8098 69e2 8099 2075 7365 6420 756e ...i... used un │ │ │ │ │ +0000dfa0: 696e 6974 6961 6c69 7a65 6420 696e 2074 initialized in t │ │ │ │ │ +0000dfb0: 6869 7320 6675 6e63 7469 6f6e 0a20 2020 his function. │ │ │ │ │ +0000dfc0: 2020 2020 4343 4c44 2020 2066 6f6f 0a0a CCLD foo.. │ │ │ │ │ +0000dfd0: 2020 2041 6c73 6f2c 2069 6e20 7072 6f6a Also, in proj │ │ │ │ │ +0000dfe0: 6563 7473 2075 7369 6e67 2027 6c69 6274 ects using 'libt │ │ │ │ │ +0000dff0: 6f6f 6c27 2c20 7468 6520 7573 6520 6f66 ool', the use of │ │ │ │ │ +0000e000: 2073 696c 656e 7420 7275 6c65 7320 6361 silent rules ca │ │ │ │ │ +0000e010: 6e0a 6175 746f 6d61 7469 6361 6c6c 7920 n.automatically │ │ │ │ │ +0000e020: 656e 6162 6c65 2074 6865 2027 6c69 6274 enable the 'libt │ │ │ │ │ +0000e030: 6f6f 6c27 2773 2027 2d2d 7369 6c65 6e74 ool''s '--silent │ │ │ │ │ +0000e040: 2720 6f70 7469 6f6e 3a0a 0a20 2020 2020 ' option:.. │ │ │ │ │ +0000e050: 2520 6361 7420 4d61 6b65 6669 6c65 2e61 % cat Makefile.a │ │ │ │ │ +0000e060: 6d0a 2020 2020 206c 6962 5f4c 544c 4942 m. lib_LTLIB │ │ │ │ │ +0000e070: 5241 5249 4553 203d 206c 6962 782e 6c61 RARIES = libx.la │ │ │ │ │ +0000e080: 0a0a 2020 2020 2025 206d 616b 6520 2320 .. % make # │ │ │ │ │ +0000e090: 426f 7468 206d 616b 6520 616e 6420 6c69 Both make and li │ │ │ │ │ +0000e0a0: 6274 6f6f 6c20 6172 6520 7665 7262 6f73 btool are verbos │ │ │ │ │ +0000e0b0: 6520 6279 2064 6566 6175 6c74 2e0a 2020 e by default.. │ │ │ │ │ +0000e0c0: 2020 202e 2e2e 0a20 2020 2020 6c69 6274 .... libt │ │ │ │ │ +0000e0d0: 6f6f 6c3a 2063 6f6d 7069 6c65 3a20 6763 ool: compile: gc │ │ │ │ │ +0000e0e0: 6320 2d44 5041 434b 4147 455f 4e41 4d45 c -DPACKAGE_NAME │ │ │ │ │ +0000e0f0: 3d5c 2266 6f6f 5c22 202e 2e2e 202d 444c =\"foo\" ... -DL │ │ │ │ │ +0000e100: 545f 4f42 4a44 4952 3d5c 222e 6c69 6273 T_OBJDIR=\".libs │ │ │ │ │ +0000e110: 2f5c 220a 2020 2020 2020 202d 492e 202d /\". -I. - │ │ │ │ │ +0000e120: 6720 2d4f 3220 2d4d 5420 6c69 6278 2e6c g -O2 -MT libx.l │ │ │ │ │ +0000e130: 6f20 2d4d 4420 2d4d 5020 2d4d 4620 2e64 o -MD -MP -MF .d │ │ │ │ │ +0000e140: 6570 732f 6c69 6278 2e54 706f 202d 6320 eps/libx.Tpo -c │ │ │ │ │ +0000e150: 6c69 6278 2e63 202d 6650 4943 0a20 2020 libx.c -fPIC. │ │ │ │ │ +0000e160: 2020 2020 2d44 5049 4320 2d6f 202e 6c69 -DPIC -o .li │ │ │ │ │ +0000e170: 6273 2f6c 6962 782e 6f0a 2020 2020 206d bs/libx.o. m │ │ │ │ │ +0000e180: 7620 2d66 202e 6465 7073 2f6c 6962 782e v -f .deps/libx. │ │ │ │ │ +0000e190: 5470 6f20 2e64 6570 732f 6c69 6278 2e50 Tpo .deps/libx.P │ │ │ │ │ +0000e1a0: 6c6f 0a20 2020 2020 2f62 696e 2f73 6820 lo. /bin/sh │ │ │ │ │ +0000e1b0: 2e2f 6c69 6274 6f6f 6c20 2d2d 7461 673d ./libtool --tag= │ │ │ │ │ +0000e1c0: 4343 202d 2d6d 6f64 653d 6c69 6e6b 2067 CC --mode=link g │ │ │ │ │ +0000e1d0: 6363 202d 6720 2d4f 3220 2d6f 206c 6962 cc -g -O2 -o lib │ │ │ │ │ +0000e1e0: 782e 6c61 202d 7270 6174 680a 2020 2020 x.la -rpath. │ │ │ │ │ +0000e1f0: 2020 202f 7573 722f 6c6f 6361 6c2f 6c69 /usr/local/li │ │ │ │ │ +0000e200: 6220 6c69 6278 2e6c 6f0a 2020 2020 206c b libx.lo. l │ │ │ │ │ +0000e210: 6962 746f 6f6c 3a20 6c69 6e6b 3a20 6763 ibtool: link: gc │ │ │ │ │ +0000e220: 6320 2d73 6861 7265 6420 2e6c 6962 732f c -shared .libs/ │ │ │ │ │ +0000e230: 6c69 6278 2e6f 202d 576c 2c2d 736f 6e61 libx.o -Wl,-sona │ │ │ │ │ +0000e240: 6d65 202d 576c 2c6c 6962 782e 736f 2e30 me -Wl,libx.so.0 │ │ │ │ │ +0000e250: 0a20 2020 2020 2020 2d6f 202e 6c69 6273 . -o .libs │ │ │ │ │ +0000e260: 2f6c 6962 782e 736f 2e30 2e30 2e30 0a20 /libx.so.0.0.0. │ │ │ │ │ +0000e270: 2020 2020 6c69 6274 6f6f 6c3a 206c 696e libtool: lin │ │ │ │ │ +0000e280: 6b3a 2063 6420 2e6c 6962 7320 2626 2072 k: cd .libs && r │ │ │ │ │ +0000e290: 6d20 2d66 206c 6962 782e 736f 2026 2620 m -f libx.so && │ │ │ │ │ +0000e2a0: 6c6e 202d 7320 6c69 6278 2e73 6f2e 302e ln -s libx.so.0. │ │ │ │ │ +0000e2b0: 302e 3020 6c69 6278 2e73 6f0a 2020 2020 0.0 libx.so. │ │ │ │ │ +0000e2c0: 202e 2e2e 0a0a 2020 2020 2025 206d 616b ..... % mak │ │ │ │ │ +0000e2d0: 6520 563d 300a 2020 2020 2020 2043 4320 e V=0. CC │ │ │ │ │ +0000e2e0: 2020 2020 6c69 6278 2e6c 6f0a 2020 2020 libx.lo. │ │ │ │ │ +0000e2f0: 2020 2043 434c 4420 2020 6c69 6278 2e6c CCLD libx.l │ │ │ │ │ +0000e300: 610a 0a20 2020 4c65 7427 7320 6e6f 7720 a.. Let's now │ │ │ │ │ +0000e310: 7365 6520 686f 7720 7468 6520 2773 696c see how the 'sil │ │ │ │ │ +0000e320: 656e 742d 7275 6c65 7327 206d 6f64 6520 ent-rules' mode │ │ │ │ │ +0000e330: 696e 7465 7266 6163 6573 2077 6974 6820 interfaces with │ │ │ │ │ +0000e340: 7468 6520 7061 636b 6167 650a 6465 7665 the package.deve │ │ │ │ │ +0000e350: 6c6f 7065 7220 616e 6420 7468 6520 7061 loper and the pa │ │ │ │ │ +0000e360: 636b 6167 6520 7573 6572 2e0a 0a20 2020 ckage user... │ │ │ │ │ +0000e370: 546f 2065 6e61 626c 6520 7468 6520 7573 To enable the us │ │ │ │ │ +0000e380: 6520 6f66 2027 7369 6c65 6e74 2d72 756c e of 'silent-rul │ │ │ │ │ +0000e390: 6573 2720 696e 2068 6973 2070 6163 6b61 es' in his packa │ │ │ │ │ +0000e3a0: 6765 2c20 6120 6465 7665 6c6f 7065 7220 ge, a developer │ │ │ │ │ +0000e3b0: 6e65 6564 730a 746f 2064 6f20 6569 7468 needs.to do eith │ │ │ │ │ +0000e3c0: 6572 206f 6620 7468 6520 666f 6c6c 6f77 er of the follow │ │ │ │ │ +0000e3d0: 696e 673a 0a0a 2020 202a 2041 6464 2074 ing:.. * Add t │ │ │ │ │ +0000e3e0: 6865 2027 7369 6c65 6e74 2d72 756c 6573 he 'silent-rules │ │ │ │ │ +0000e3f0: 2720 6f70 7469 6f6e 2061 7320 6172 6775 ' option as argu │ │ │ │ │ +0000e400: 6d65 6e74 2074 6f20 2741 4d5f 494e 4954 ment to 'AM_INIT │ │ │ │ │ +0000e410: 5f41 5554 4f4d 414b 4527 2e0a 2020 202a _AUTOMAKE'.. * │ │ │ │ │ +0000e420: 2043 616c 6c20 7468 6520 2741 4d5f 5349 Call the 'AM_SI │ │ │ │ │ +0000e430: 4c45 4e54 5f52 554c 4553 2720 6d61 6372 LENT_RULES' macr │ │ │ │ │ +0000e440: 6f20 6672 6f6d 2077 6974 6869 6e20 7468 o from within th │ │ │ │ │ +0000e450: 6520 2763 6f6e 6669 6775 7265 2e61 6327 e 'configure.ac' │ │ │ │ │ +0000e460: 0a20 2020 2020 6669 6c65 2e0a 0a20 2020 . file... │ │ │ │ │ +0000e470: 4974 2069 7320 6e6f 7420 706f 7373 6962 It is not possib │ │ │ │ │ +0000e480: 6c65 2074 6f20 696e 7374 6561 6420 7370 le to instead sp │ │ │ │ │ +0000e490: 6563 6966 7920 2773 696c 656e 742d 7275 ecify 'silent-ru │ │ │ │ │ +0000e4a0: 6c65 7327 2069 6e20 610a 274d 616b 6566 les' in a.'Makef │ │ │ │ │ +0000e4b0: 696c 652e 616d 2720 6669 6c65 2e0a 0a20 ile.am' file... │ │ │ │ │ +0000e4c0: 2020 4966 2074 6865 2064 6576 656c 6f70 If the develop │ │ │ │ │ +0000e4d0: 6572 2068 6173 2064 6f6e 6520 6569 7468 er has done eith │ │ │ │ │ +0000e4e0: 6572 206f 6620 7468 6520 6162 6f76 652c er of the above, │ │ │ │ │ +0000e4f0: 2074 6865 6e20 7468 6520 7573 6572 206f then the user o │ │ │ │ │ +0000e500: 6620 7468 650a 7061 636b 6167 6520 6d61 f the.package ma │ │ │ │ │ +0000e510: 7920 696e 666c 7565 6e63 6520 7468 6520 y influence the │ │ │ │ │ +0000e520: 7665 7262 6f73 6974 7920 6174 2027 636f verbosity at 'co │ │ │ │ │ +0000e530: 6e66 6967 7572 6527 2072 756e 2074 696d nfigure' run tim │ │ │ │ │ +0000e540: 6520 6173 2077 656c 6c20 6173 0a61 7420 e as well as.at │ │ │ │ │ +0000e550: 276d 616b 6527 2072 756e 2074 696d 653a 'make' run time: │ │ │ │ │ +0000e560: 0a0a 2020 202a 2050 6173 7369 6e67 2027 .. * Passing ' │ │ │ │ │ +0000e570: 2d2d 656e 6162 6c65 2d73 696c 656e 742d --enable-silent- │ │ │ │ │ +0000e580: 7275 6c65 7327 2074 6f20 2763 6f6e 6669 rules' to 'confi │ │ │ │ │ +0000e590: 6775 7265 2720 7769 6c6c 2063 6175 7365 gure' will cause │ │ │ │ │ +0000e5a0: 2062 7569 6c64 0a20 2020 2020 7275 6c65 build. rule │ │ │ │ │ +0000e5b0: 7320 746f 2062 6520 6c65 7373 2076 6572 s to be less ver │ │ │ │ │ +0000e5c0: 626f 7365 3b20 7468 6520 6f70 7469 6f6e bose; the option │ │ │ │ │ +0000e5d0: 2027 2d2d 6469 7361 626c 652d 7369 6c65 '--disable-sile │ │ │ │ │ +0000e5e0: 6e74 2d72 756c 6573 2720 7769 6c6c 0a20 nt-rules' will. │ │ │ │ │ +0000e5f0: 2020 2020 6361 7573 6520 6e6f 726d 616c cause normal │ │ │ │ │ +0000e600: 2076 6572 626f 7365 206f 7574 7075 742e verbose output. │ │ │ │ │ +0000e610: 0a20 2020 2a20 4174 2027 6d61 6b65 2720 . * At 'make' │ │ │ │ │ +0000e620: 7275 6e20 7469 6d65 2c20 7468 6520 6465 run time, the de │ │ │ │ │ +0000e630: 6661 756c 7420 6368 6f73 656e 2061 7420 fault chosen at │ │ │ │ │ +0000e640: 2763 6f6e 6669 6775 7265 2720 7469 6d65 'configure' time │ │ │ │ │ +0000e650: 206d 6179 2062 650a 2020 2020 206f 7665 may be. ove │ │ │ │ │ +0000e660: 7272 6964 6465 6e3a 2027 6d61 6b65 2056 rridden: 'make V │ │ │ │ │ +0000e670: 3d31 2720 7769 6c6c 2070 726f 6475 6365 =1' will produce │ │ │ │ │ +0000e680: 2076 6572 626f 7365 206f 7574 7075 742c verbose output, │ │ │ │ │ +0000e690: 2027 6d61 6b65 2056 3d30 2720 6c65 7373 'make V=0' less │ │ │ │ │ +0000e6a0: 0a20 2020 2020 7665 7262 6f73 6520 6f75 . verbose ou │ │ │ │ │ +0000e6b0: 7470 7574 2e0a 0a20 2020 4e6f 7465 2074 tput... Note t │ │ │ │ │ +0000e6c0: 6861 7420 7369 6c65 6e74 2072 756c 6573 hat silent rules │ │ │ │ │ +0000e6d0: 2061 7265 205f 6469 7361 626c 6564 5f20 are _disabled_ │ │ │ │ │ +0000e6e0: 6279 2064 6566 6175 6c74 3b20 7468 6520 by default; the │ │ │ │ │ +0000e6f0: 7573 6572 206d 7573 740a 656e 6162 6c65 user must.enable │ │ │ │ │ +0000e700: 2074 6865 6d20 6578 706c 6963 6974 6c79 them explicitly │ │ │ │ │ +0000e710: 2061 7420 6569 7468 6572 2027 636f 6e66 at either 'conf │ │ │ │ │ +0000e720: 6967 7572 6527 2072 756e 2074 696d 6520 igure' run time │ │ │ │ │ +0000e730: 6f72 2061 7420 276d 616b 6527 2072 756e or at 'make' run │ │ │ │ │ +0000e740: 0a74 696d 652e 2020 5765 2074 6869 6e6b .time. We think │ │ │ │ │ +0000e750: 2074 6861 7420 7468 6973 2069 7320 6120 that this is a │ │ │ │ │ +0000e760: 676f 6f64 2070 6f6c 6963 792c 2073 696e good policy, sin │ │ │ │ │ +0000e770: 6365 2069 7420 7072 6f76 6964 6573 2074 ce it provides t │ │ │ │ │ +0000e780: 6865 2063 6173 7561 6c0a 7573 6572 2077 he casual.user w │ │ │ │ │ +0000e790: 6974 6820 656e 6f75 6768 2069 6e66 6f72 ith enough infor │ │ │ │ │ +0000e7a0: 6d61 7469 6f6e 2074 6f20 7072 6570 6172 mation to prepar │ │ │ │ │ +0000e7b0: 6520 6120 676f 6f64 2062 7567 2072 6570 e a good bug rep │ │ │ │ │ +0000e7c0: 6f72 7420 696e 2063 6173 650a 616e 7974 ort in case.anyt │ │ │ │ │ +0000e7d0: 6869 6e67 2062 7265 616b 732e 0a0a 2020 hing breaks... │ │ │ │ │ +0000e7e0: 2053 7469 6c6c 2c20 6e6f 7477 6974 6873 Still, notwiths │ │ │ │ │ +0000e7f0: 7461 6e64 696e 6720 7468 6520 7261 7469 tanding the rati │ │ │ │ │ +0000e800: 6f6e 616c 6573 2061 626f 7665 2c20 6120 onales above, a │ │ │ │ │ +0000e810: 6465 7665 6c6f 7065 7220 7768 6f20 7761 developer who wa │ │ │ │ │ +0000e820: 6e74 7320 746f 0a6d 616b 6520 7369 6c65 nts to.make sile │ │ │ │ │ +0000e830: 6e74 2072 756c 6573 2065 6e61 626c 6564 nt rules enabled │ │ │ │ │ +0000e840: 2062 7920 6465 6661 756c 7420 696e 2068 by default in h │ │ │ │ │ +0000e850: 6973 206f 776e 2070 6163 6b61 6765 2063 is own package c │ │ │ │ │ +0000e860: 616e 2064 6f20 736f 2062 790a 6164 6469 an do so by.addi │ │ │ │ │ +0000e870: 6e67 2061 2027 7965 7327 2061 7267 756d ng a 'yes' argum │ │ │ │ │ +0000e880: 656e 7420 746f 2074 6865 2027 414d 5f53 ent to the 'AM_S │ │ │ │ │ +0000e890: 494c 454e 545f 5255 4c45 5327 2063 616c ILENT_RULES' cal │ │ │ │ │ +0000e8a0: 6c20 696e 2027 636f 6e66 6967 7572 652e l in 'configure. │ │ │ │ │ +0000e8b0: 6163 272e 0a57 6520 6164 7669 7365 2061 ac'..We advise a │ │ │ │ │ +0000e8c0: 6761 696e 7374 2074 6869 7320 6170 7072 gainst this appr │ │ │ │ │ +0000e8d0: 6f61 6368 2c20 7468 6f75 6768 2e0a 0a20 oach, though... │ │ │ │ │ +0000e8e0: 2020 5573 6572 7320 7768 6f20 7072 6566 Users who pref │ │ │ │ │ +0000e8f0: 6572 2074 6f20 6861 7665 2073 696c 656e er to have silen │ │ │ │ │ +0000e900: 7420 7275 6c65 7320 656e 6162 6c65 6420 t rules enabled │ │ │ │ │ +0000e910: 6279 2064 6566 6175 6c74 2063 616e 2065 by default can e │ │ │ │ │ +0000e920: 6469 740a 7468 6569 7220 2763 6f6e 6669 dit.their 'confi │ │ │ │ │ +0000e930: 672e 7369 7465 2720 6669 6c65 2074 6f20 g.site' file to │ │ │ │ │ +0000e940: 6d61 6b65 2074 6865 2076 6172 6961 626c make the variabl │ │ │ │ │ +0000e950: 6520 2765 6e61 626c 655f 7369 6c65 6e74 e 'enable_silent │ │ │ │ │ +0000e960: 5f72 756c 6573 270a 6465 6661 756c 7420 _rules'.default │ │ │ │ │ +0000e970: 746f 2027 7965 7327 2e20 2054 6869 7320 to 'yes'. This │ │ │ │ │ +0000e980: 7368 6f75 6c64 2073 7469 6c6c 2061 6c6c should still all │ │ │ │ │ +0000e990: 6f77 2064 6973 6162 6c69 6e67 2073 696c ow disabling sil │ │ │ │ │ +0000e9a0: 656e 7420 7275 6c65 7320 6174 0a27 636f ent rules at.'co │ │ │ │ │ +0000e9b0: 6e66 6967 7572 6527 2074 696d 6520 616e nfigure' time an │ │ │ │ │ +0000e9c0: 6420 6174 2027 6d61 6b65 2720 7469 6d65 d at 'make' time │ │ │ │ │ +0000e9d0: 2e0a 0a20 2020 466f 7220 706f 7274 6162 ... For portab │ │ │ │ │ +0000e9e0: 696c 6974 7920 746f 2064 6966 6665 7265 ility to differe │ │ │ │ │ +0000e9f0: 6e74 2027 6d61 6b65 2720 696d 706c 656d nt 'make' implem │ │ │ │ │ +0000ea00: 656e 7461 7469 6f6e 732c 2070 6163 6b61 entations, packa │ │ │ │ │ +0000ea10: 6765 2061 7574 686f 7273 0a61 7265 2061 ge authors.are a │ │ │ │ │ +0000ea20: 6476 6973 6564 2074 6f20 6e6f 7420 7365 dvised to not se │ │ │ │ │ +0000ea30: 7420 7468 6520 7661 7269 6162 6c65 2027 t the variable ' │ │ │ │ │ +0000ea40: 5627 2069 6e73 6964 6520 7468 6520 274d V' inside the 'M │ │ │ │ │ +0000ea50: 616b 6566 696c 652e 616d 2720 6669 6c65 akefile.am' file │ │ │ │ │ +0000ea60: 2c0a 746f 2061 6c6c 6f77 2074 6865 2075 ,.to allow the u │ │ │ │ │ +0000ea70: 7365 7220 746f 206f 7665 7272 6964 6520 ser to override │ │ │ │ │ +0000ea80: 7468 6520 7661 6c75 6520 666f 7220 7375 the value for su │ │ │ │ │ +0000ea90: 6264 6972 6563 746f 7269 6573 2061 7320 bdirectories as │ │ │ │ │ +0000eaa0: 7765 6c6c 2e0a 0a20 2020 5468 6520 6375 well... The cu │ │ │ │ │ +0000eab0: 7272 656e 7420 696d 706c 656d 656e 7461 rrent implementa │ │ │ │ │ +0000eac0: 7469 6f6e 206f 6620 7468 6973 2066 6561 tion of this fea │ │ │ │ │ +0000ead0: 7475 7265 206e 6f72 6d61 6c6c 7920 7573 ture normally us │ │ │ │ │ +0000eae0: 6573 206e 6573 7465 640a 7661 7269 6162 es nested.variab │ │ │ │ │ +0000eaf0: 6c65 2065 7870 616e 7369 6f6e 2027 2428 le expansion '$( │ │ │ │ │ +0000eb00: 5641 5231 2428 5629 2927 2c20 6120 274d VAR1$(V))', a 'M │ │ │ │ │ +0000eb10: 616b 6566 696c 6527 2066 6561 7475 7265 akefile' feature │ │ │ │ │ +0000eb20: 2074 6861 7420 6973 206e 6f74 0a72 6571 that is not.req │ │ │ │ │ +0000eb30: 7569 7265 6420 6279 2050 4f53 4958 2032 uired by POSIX 2 │ │ │ │ │ +0000eb40: 3030 3820 6275 7420 6973 2077 6964 656c 008 but is widel │ │ │ │ │ +0000eb50: 7920 7375 7070 6f72 7465 6420 696e 2070 y supported in p │ │ │ │ │ +0000eb60: 7261 6374 6963 652e 2020 5468 650a 2773 ractice. The.'s │ │ │ │ │ +0000eb70: 696c 656e 742d 7275 6c65 7327 206f 7074 ilent-rules' opt │ │ │ │ │ +0000eb80: 696f 6e20 7468 7573 2074 7572 6e73 206f ion thus turns o │ │ │ │ │ +0000eb90: 6666 2077 6172 6e69 6e67 7320 6162 6f75 ff warnings abou │ │ │ │ │ +0000eba0: 7420 7265 6375 7273 6976 6520 7661 7269 t recursive vari │ │ │ │ │ +0000ebb0: 6162 6c65 0a65 7870 616e 7369 6f6e 2c20 able.expansion, │ │ │ │ │ +0000ebc0: 7768 6963 6820 6172 6520 696e 2074 7572 which are in tur │ │ │ │ │ +0000ebd0: 6e20 656e 6162 6c65 6420 6279 2027 2d57 n enabled by '-W │ │ │ │ │ +0000ebe0: 706f 7274 6162 696c 6974 7927 2028 2a6e portability' (*n │ │ │ │ │ +0000ebf0: 6f74 6520 6175 746f 6d61 6b65 0a49 6e76 ote automake.Inv │ │ │ │ │ +0000ec00: 6f63 6174 696f 6e3a 3a29 2e20 204f 6e20 ocation::). On │ │ │ │ │ +0000ec10: 7468 6520 7261 7265 2027 6d61 6b65 2720 the rare 'make' │ │ │ │ │ +0000ec20: 696d 706c 656d 656e 7461 7469 6f6e 7320 implementations │ │ │ │ │ +0000ec30: 7468 6174 2064 6f20 6e6f 7420 7375 7070 that do not supp │ │ │ │ │ +0000ec40: 6f72 740a 6e65 7374 6564 2076 6172 6961 ort.nested varia │ │ │ │ │ +0000ec50: 626c 6520 6578 7061 6e73 696f 6e2c 2077 ble expansion, w │ │ │ │ │ +0000ec60: 6865 7468 6572 2072 756c 6573 2061 7265 hether rules are │ │ │ │ │ +0000ec70: 2073 696c 656e 7420 6973 2061 6c77 6179 silent is alway │ │ │ │ │ +0000ec80: 7320 6465 7465 726d 696e 6564 0a61 7420 s determined.at │ │ │ │ │ +0000ec90: 636f 6e66 6967 7572 6520 7469 6d65 2c20 configure time, │ │ │ │ │ +0000eca0: 616e 6420 6361 6e6e 6f74 2062 6520 6f76 and cannot be ov │ │ │ │ │ +0000ecb0: 6572 7269 6464 656e 2061 7420 6d61 6b65 erridden at make │ │ │ │ │ +0000ecc0: 2074 696d 652e 2020 4675 7475 7265 0a76 time. Future.v │ │ │ │ │ +0000ecd0: 6572 7369 6f6e 7320 6f66 2050 4f53 4958 ersions of POSIX │ │ │ │ │ +0000ece0: 2061 7265 206c 696b 656c 7920 746f 2072 are likely to r │ │ │ │ │ +0000ecf0: 6571 7569 7265 206e 6573 7465 6420 7661 equire nested va │ │ │ │ │ +0000ed00: 7269 6162 6c65 2065 7870 616e 7369 6f6e riable expansion │ │ │ │ │ +0000ed10: 2c20 736f 0a74 6869 7320 6d69 6e6f 7220 , so.this minor │ │ │ │ │ +0000ed20: 6c69 6d69 7461 7469 6f6e 2073 686f 756c limitation shoul │ │ │ │ │ +0000ed30: 6420 676f 2061 7761 7920 7769 7468 2074 d go away with t │ │ │ │ │ +0000ed40: 696d 652e 0a0a 2020 2054 6f20 6578 7465 ime... To exte │ │ │ │ │ +0000ed50: 6e64 2074 6865 2073 696c 656e 7420 6d6f nd the silent mo │ │ │ │ │ +0000ed60: 6465 2074 6f20 796f 7572 206f 776e 2072 de to your own r │ │ │ │ │ +0000ed70: 756c 6573 2c20 796f 7520 6861 7665 2074 ules, you have t │ │ │ │ │ +0000ed80: 776f 2063 686f 6963 6573 3a0a 0a20 2020 wo choices:.. │ │ │ │ │ +0000ed90: 2a20 596f 7520 6361 6e20 7573 6520 7468 * You can use th │ │ │ │ │ +0000eda0: 6520 7072 6564 6566 696e 6564 2076 6172 e predefined var │ │ │ │ │ +0000edb0: 6961 626c 6520 2741 4d5f 565f 4745 4e27 iable 'AM_V_GEN' │ │ │ │ │ +0000edc0: 2061 7320 6120 7072 6566 6978 2074 6f0a as a prefix to. │ │ │ │ │ +0000edd0: 2020 2020 2063 6f6d 6d61 6e64 7320 7468 commands th │ │ │ │ │ +0000ede0: 6174 2073 686f 756c 6420 6f75 7470 7574 at should output │ │ │ │ │ +0000edf0: 2061 2073 7461 7475 7320 6c69 6e65 2069 a status line i │ │ │ │ │ +0000ee00: 6e20 7369 6c65 6e74 206d 6f64 652c 2061 n silent mode, a │ │ │ │ │ +0000ee10: 6e64 0a20 2020 2020 2741 4d5f 565f 6174 nd. 'AM_V_at │ │ │ │ │ +0000ee20: 2720 6173 2061 2070 7265 6669 7820 746f ' as a prefix to │ │ │ │ │ +0000ee30: 2063 6f6d 6d61 6e64 7320 7468 6174 2073 commands that s │ │ │ │ │ +0000ee40: 686f 756c 6420 6e6f 7420 6f75 7470 7574 hould not output │ │ │ │ │ +0000ee50: 2061 6e79 7468 696e 670a 2020 2020 2069 anything. i │ │ │ │ │ +0000ee60: 6e20 7369 6c65 6e74 206d 6f64 652e 2020 n silent mode. │ │ │ │ │ +0000ee70: 5768 656e 206f 7574 7075 7420 6973 2074 When output is t │ │ │ │ │ +0000ee80: 6f20 6265 2076 6572 626f 7365 2c20 626f o be verbose, bo │ │ │ │ │ +0000ee90: 7468 206f 6620 7468 6573 650a 2020 2020 th of these. │ │ │ │ │ +0000eea0: 2076 6172 6961 626c 6573 2077 696c 6c20 variables will │ │ │ │ │ +0000eeb0: 6578 7061 6e64 2074 6f20 7468 6520 656d expand to the em │ │ │ │ │ +0000eec0: 7074 7920 7374 7269 6e67 2e0a 2020 202a pty string.. * │ │ │ │ │ +0000eed0: 2059 6f75 2063 616e 2061 6464 2079 6f75 You can add you │ │ │ │ │ +0000eee0: 7220 6f77 6e20 7661 7269 6162 6c65 732c r own variables, │ │ │ │ │ +0000eef0: 2073 6f20 7374 7269 6e67 7320 6f66 2079 so strings of y │ │ │ │ │ +0000ef00: 6f75 7220 6f77 6e20 6368 6f69 6365 2061 our own choice a │ │ │ │ │ +0000ef10: 7265 0a20 2020 2020 7368 6f77 6e2e 2020 re. shown. │ │ │ │ │ +0000ef20: 5468 6520 666f 6c6c 6f77 696e 6720 736e The following sn │ │ │ │ │ +0000ef30: 6970 7065 7420 7368 6f77 7320 686f 7720 ippet shows how │ │ │ │ │ +0000ef40: 796f 7520 776f 756c 6420 6465 6669 6e65 you would define │ │ │ │ │ +0000ef50: 2079 6f75 7220 6f77 6e0a 2020 2020 2065 your own. e │ │ │ │ │ +0000ef60: 7175 6976 616c 656e 7420 6f66 2027 414d quivalent of 'AM │ │ │ │ │ +0000ef70: 5f56 5f47 454e 273a 0a0a 2020 2020 2020 _V_GEN':.. │ │ │ │ │ +0000ef80: 2020 2020 706b 675f 7665 7262 6f73 6520 pkg_verbose │ │ │ │ │ +0000ef90: 3d20 2428 706b 675f 7665 7262 6f73 655f = $(pkg_verbose_ │ │ │ │ │ +0000efa0: 4041 4d5f 5640 290a 2020 2020 2020 2020 @AM_V@). │ │ │ │ │ +0000efb0: 2020 706b 675f 7665 7262 6f73 655f 203d pkg_verbose_ = │ │ │ │ │ +0000efc0: 2024 2870 6b67 5f76 6572 626f 7365 5f40 $(pkg_verbose_@ │ │ │ │ │ +0000efd0: 414d 5f44 4546 4155 4c54 5f56 4029 0a20 AM_DEFAULT_V@). │ │ │ │ │ +0000efe0: 2020 2020 2020 2020 2070 6b67 5f76 6572 pkg_ver │ │ │ │ │ +0000eff0: 626f 7365 5f30 203d 2040 6563 686f 2050 bose_0 = @echo P │ │ │ │ │ +0000f000: 4b47 2d47 454e 2024 403b 0a0a 2020 2020 KG-GEN $@;.. │ │ │ │ │ +0000f010: 2020 2020 2020 666f 6f3a 2066 6f6f 2e69 foo: foo.i │ │ │ │ │ +0000f020: 6e0a 2020 2020 2020 2020 2020 2020 2020 n. │ │ │ │ │ +0000f030: 2020 2020 2428 706b 675f 7665 7262 6f73 $(pkg_verbos │ │ │ │ │ +0000f040: 6529 6370 2024 2873 7263 6469 7229 2f66 e)cp $(srcdir)/f │ │ │ │ │ +0000f050: 6f6f 2e69 6e20 2440 0a0a 2020 2041 7320 oo.in $@.. As │ │ │ │ │ +0000f060: 6120 6669 6e61 6c20 6e6f 7465 2c20 6f62 a final note, ob │ │ │ │ │ +0000f070: 7365 7276 6520 7468 6174 2c20 6576 656e serve that, even │ │ │ │ │ +0000f080: 2077 6865 6e20 7369 6c65 6e74 2072 756c when silent rul │ │ │ │ │ +0000f090: 6573 2061 7265 2065 6e61 626c 6564 2c0a es are enabled,. │ │ │ │ │ +0000f0a0: 7468 6520 272d 2d6e 6f2d 7072 696e 742d the '--no-print- │ │ │ │ │ +0000f0b0: 6469 7265 6374 6f72 7927 206f 7074 696f directory' optio │ │ │ │ │ +0000f0c0: 6e20 6973 2073 7469 6c6c 2072 6571 7569 n is still requi │ │ │ │ │ +0000f0d0: 7265 6420 7769 7468 2047 4e55 2027 6d61 red with GNU 'ma │ │ │ │ │ +0000f0e0: 6b65 2720 6966 0a74 6865 2022 456e 7465 ke' if.the "Ente │ │ │ │ │ +0000f0f0: 7269 6e67 2f4c 6561 7669 6e67 2064 6972 ring/Leaving dir │ │ │ │ │ +0000f100: 6563 746f 7279 202e 2e2e 2220 206d 6573 ectory ..." mes │ │ │ │ │ +0000f110: 7361 6765 7320 6172 6520 746f 2062 6520 sages are to be │ │ │ │ │ +0000f120: 6469 7361 626c 6564 2e0a 0a1f 0a46 696c disabled.....Fil │ │ │ │ │ +0000f130: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ +0000f140: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 476e .info, Node: Gn │ │ │ │ │ +0000f150: 6974 732c 2020 4e65 7874 3a20 4379 676e its, Next: Cygn │ │ │ │ │ +0000f160: 7573 2c20 2050 7265 763a 2053 696c 656e us, Prev: Silen │ │ │ │ │ +0000f170: 6369 6e67 204d 616b 652c 2020 5570 3a20 cing Make, Up: │ │ │ │ │ +0000f180: 546f 700a 0a32 3220 5468 6520 6566 6665 Top..22 The effe │ │ │ │ │ +0000f190: 6374 206f 6620 272d 2d67 6e75 2720 616e ct of '--gnu' an │ │ │ │ │ +0000f1a0: 6420 272d 2d67 6e69 7473 270a 2a2a 2a2a d '--gnits'.**** │ │ │ │ │ 0000f1b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 0000f1c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0000f1d0: 2a0a 0a54 6865 2027 2d2d 676e 7527 206f *..The '--gnu' o │ │ │ │ │ -0000f1e0: 7074 696f 6e20 286f 7220 2767 6e75 2720 ption (or 'gnu' │ │ │ │ │ -0000f1f0: 696e 2074 6865 2027 4155 544f 4d41 4b45 in the 'AUTOMAKE │ │ │ │ │ -0000f200: 5f4f 5054 494f 4e53 2720 7661 7269 6162 _OPTIONS' variab │ │ │ │ │ -0000f210: 6c65 2920 6361 7573 6573 0a27 6175 746f le) causes.'auto │ │ │ │ │ -0000f220: 6d61 6b65 2720 746f 2063 6865 636b 2074 make' to check t │ │ │ │ │ -0000f230: 6865 2066 6f6c 6c6f 7769 6e67 3a0a 0a20 he following:.. │ │ │ │ │ -0000f240: 2020 2a20 5468 6520 6669 6c65 7320 2749 * The files 'I │ │ │ │ │ -0000f250: 4e53 5441 4c4c 272c 2027 4e45 5753 272c NSTALL', 'NEWS', │ │ │ │ │ -0000f260: 2027 5245 4144 4d45 272c 2027 4155 5448 'README', 'AUTH │ │ │ │ │ -0000f270: 4f52 5327 2c20 616e 6420 2743 6861 6e67 ORS', and 'Chang │ │ │ │ │ -0000f280: 654c 6f67 272c 0a20 2020 2020 706c 7573 eLog',. plus │ │ │ │ │ -0000f290: 206f 6e65 206f 6620 2743 4f50 5949 4e47 one of 'COPYING │ │ │ │ │ -0000f2a0: 2e4c 4942 272c 2027 434f 5059 494e 472e .LIB', 'COPYING. │ │ │ │ │ -0000f2b0: 4c45 5353 4552 2720 6f72 2027 434f 5059 LESSER' or 'COPY │ │ │ │ │ -0000f2c0: 494e 4727 2c20 6172 650a 2020 2020 2072 ING', are. r │ │ │ │ │ -0000f2d0: 6571 7569 7265 6420 6174 2074 6865 2074 equired at the t │ │ │ │ │ -0000f2e0: 6f70 6d6f 7374 2064 6972 6563 746f 7279 opmost directory │ │ │ │ │ -0000f2f0: 206f 6620 7468 6520 7061 636b 6167 652e of the package. │ │ │ │ │ -0000f300: 0a0a 2020 2020 2049 6620 7468 6520 272d .. If the '- │ │ │ │ │ -0000f310: 2d61 6464 2d6d 6973 7369 6e67 2720 6f70 -add-missing' op │ │ │ │ │ -0000f320: 7469 6f6e 2069 7320 6769 7665 6e2c 2027 tion is given, ' │ │ │ │ │ -0000f330: 6175 746f 6d61 6b65 2720 7769 6c6c 2061 automake' will a │ │ │ │ │ -0000f340: 6464 2061 0a20 2020 2020 6765 6e65 7269 dd a. generi │ │ │ │ │ -0000f350: 6320 7665 7273 696f 6e20 6f66 2074 6865 c version of the │ │ │ │ │ -0000f360: 2027 494e 5354 414c 4c27 2066 696c 6520 'INSTALL' file │ │ │ │ │ -0000f370: 6173 2077 656c 6c20 6173 2074 6865 2027 as well as the ' │ │ │ │ │ -0000f380: 434f 5059 494e 4727 2066 696c 650a 2020 COPYING' file. │ │ │ │ │ -0000f390: 2020 2063 6f6e 7461 696e 696e 6720 7468 containing th │ │ │ │ │ -0000f3a0: 6520 7465 7874 206f 6620 7468 6520 6375 e text of the cu │ │ │ │ │ -0000f3b0: 7272 656e 7420 7665 7273 696f 6e20 6f66 rrent version of │ │ │ │ │ -0000f3c0: 2074 6865 2047 4e55 2047 656e 6572 616c the GNU General │ │ │ │ │ -0000f3d0: 0a20 2020 2020 5075 626c 6963 204c 6963 . Public Lic │ │ │ │ │ -0000f3e0: 656e 7365 2065 7869 7374 696e 6720 6174 ense existing at │ │ │ │ │ -0000f3f0: 2074 6865 2074 696d 6520 6f66 2074 6869 the time of thi │ │ │ │ │ -0000f400: 7320 4175 746f 6d61 6b65 2072 656c 6561 s Automake relea │ │ │ │ │ -0000f410: 7365 0a20 2020 2020 2876 6572 7369 6f6e se. (version │ │ │ │ │ -0000f420: 2033 2061 7320 7468 6973 2069 7320 7772 3 as this is wr │ │ │ │ │ -0000f430: 6974 7465 6e2c 0a20 2020 2020 3c68 7474 itten,. ). However, a │ │ │ │ │ -0000f470: 6e20 6578 6973 7469 6e67 0a20 2020 2020 n existing. │ │ │ │ │ -0000f480: 2743 4f50 5949 4e47 2720 6669 6c65 2077 'COPYING' file w │ │ │ │ │ -0000f490: 696c 6c20 6e65 7665 7220 6265 206f 7665 ill never be ove │ │ │ │ │ -0000f4a0: 7277 7269 7474 656e 2062 7920 2761 7574 rwritten by 'aut │ │ │ │ │ -0000f4b0: 6f6d 616b 6527 2e0a 0a20 2020 2a20 5468 omake'... * Th │ │ │ │ │ -0000f4c0: 6520 6f70 7469 6f6e 7320 276e 6f2d 696e e options 'no-in │ │ │ │ │ -0000f4d0: 7374 616c 6c6d 616e 2720 616e 6420 276e stallman' and 'n │ │ │ │ │ -0000f4e0: 6f2d 696e 7374 616c 6c69 6e66 6f27 2061 o-installinfo' a │ │ │ │ │ -0000f4f0: 7265 2070 726f 6869 6269 7465 642e 0a0a re prohibited... │ │ │ │ │ -0000f500: 2020 204e 6f74 6520 7468 6174 2074 6869 Note that thi │ │ │ │ │ -0000f510: 7320 6f70 7469 6f6e 2077 696c 6c20 6265 s option will be │ │ │ │ │ -0000f520: 2065 7874 656e 6465 6420 696e 2074 6865 extended in the │ │ │ │ │ -0000f530: 2066 7574 7572 6520 746f 2064 6f20 6576 future to do ev │ │ │ │ │ -0000f540: 656e 206d 6f72 650a 6368 6563 6b69 6e67 en more.checking │ │ │ │ │ -0000f550: 3b20 6974 2069 7320 6164 7669 7361 626c ; it is advisabl │ │ │ │ │ -0000f560: 6520 746f 2062 6520 6661 6d69 6c69 6172 e to be familiar │ │ │ │ │ -0000f570: 2077 6974 6820 7468 6520 7072 6563 6973 with the precis │ │ │ │ │ -0000f580: 6520 7265 7175 6972 656d 656e 7473 0a6f e requirements.o │ │ │ │ │ -0000f590: 6620 7468 6520 474e 5520 7374 616e 6461 f the GNU standa │ │ │ │ │ -0000f5a0: 7264 732e 2020 416c 736f 2c20 272d 2d67 rds. Also, '--g │ │ │ │ │ -0000f5b0: 6e75 2720 6361 6e20 7265 7175 6972 6520 nu' can require │ │ │ │ │ -0000f5c0: 6365 7274 6169 6e20 6e6f 6e2d 7374 616e certain non-stan │ │ │ │ │ -0000f5d0: 6461 7264 0a47 4e55 2070 726f 6772 616d dard.GNU program │ │ │ │ │ -0000f5e0: 7320 746f 2065 7869 7374 2066 6f72 2075 s to exist for u │ │ │ │ │ -0000f5f0: 7365 2062 7920 7661 7269 6f75 7320 6d61 se by various ma │ │ │ │ │ -0000f600: 696e 7461 696e 6572 2d6f 6e6c 7920 7275 intainer-only ru │ │ │ │ │ -0000f610: 6c65 733b 2066 6f72 0a69 6e73 7461 6e63 les; for.instanc │ │ │ │ │ -0000f620: 652c 2069 6e20 7468 6520 6675 7475 7265 e, in the future │ │ │ │ │ -0000f630: 2027 7061 7468 6368 6b27 206d 6967 6874 'pathchk' might │ │ │ │ │ -0000f640: 2062 6520 7265 7175 6972 6564 2066 6f72 be required for │ │ │ │ │ -0000f650: 2027 6d61 6b65 2064 6973 7427 2e0a 0a20 'make dist'... │ │ │ │ │ -0000f660: 2020 5468 6520 272d 2d67 6e69 7473 2720 The '--gnits' │ │ │ │ │ -0000f670: 6f70 7469 6f6e 2064 6f65 7320 6576 6572 option does ever │ │ │ │ │ -0000f680: 7974 6869 6e67 2074 6861 7420 272d 2d67 ything that '--g │ │ │ │ │ -0000f690: 6e75 2720 646f 6573 2c20 616e 6420 6368 nu' does, and ch │ │ │ │ │ -0000f6a0: 6563 6b73 0a74 6865 2066 6f6c 6c6f 7769 ecks.the followi │ │ │ │ │ -0000f6b0: 6e67 2061 7320 7765 6c6c 3a0a 0a20 2020 ng as well:.. │ │ │ │ │ -0000f6c0: 2a20 276d 616b 6520 696e 7374 616c 6c63 * 'make installc │ │ │ │ │ -0000f6d0: 6865 636b 2720 7769 6c6c 2063 6865 636b heck' will check │ │ │ │ │ -0000f6e0: 2074 6f20 6d61 6b65 2073 7572 6520 7468 to make sure th │ │ │ │ │ -0000f6f0: 6174 2074 6865 2027 2d2d 6865 6c70 2720 at the '--help' │ │ │ │ │ -0000f700: 616e 640a 2020 2020 2027 2d2d 7665 7273 and. '--vers │ │ │ │ │ -0000f710: 696f 6e27 2072 6561 6c6c 7920 7072 696e ion' really prin │ │ │ │ │ -0000f720: 7420 6120 7573 6167 6520 6d65 7373 6167 t a usage messag │ │ │ │ │ -0000f730: 6520 616e 6420 6120 7665 7273 696f 6e20 e and a version │ │ │ │ │ -0000f740: 7374 7269 6e67 2c0a 2020 2020 2072 6573 string,. res │ │ │ │ │ -0000f750: 7065 6374 6976 656c 792e 2020 5468 6973 pectively. This │ │ │ │ │ -0000f760: 2069 7320 7468 6520 2773 7464 2d6f 7074 is the 'std-opt │ │ │ │ │ -0000f770: 696f 6e73 2720 6f70 7469 6f6e 2028 2a6e ions' option (*n │ │ │ │ │ -0000f780: 6f74 6520 4f70 7469 6f6e 733a 3a29 2e0a ote Options::).. │ │ │ │ │ -0000f790: 0a20 2020 2a20 276d 616b 6520 6469 7374 . * 'make dist │ │ │ │ │ -0000f7a0: 2720 7769 6c6c 2063 6865 636b 2074 6f20 ' will check to │ │ │ │ │ -0000f7b0: 6d61 6b65 2073 7572 6520 7468 6520 274e make sure the 'N │ │ │ │ │ -0000f7c0: 4557 5327 2066 696c 6520 6861 7320 6265 EWS' file has be │ │ │ │ │ -0000f7d0: 656e 0a20 2020 2020 7570 6461 7465 6420 en. updated │ │ │ │ │ -0000f7e0: 746f 2074 6865 2063 7572 7265 6e74 2076 to the current v │ │ │ │ │ -0000f7f0: 6572 7369 6f6e 2e0a 0a20 2020 2a20 2756 ersion... * 'V │ │ │ │ │ -0000f800: 4552 5349 4f4e 2720 6973 2063 6865 636b ERSION' is check │ │ │ │ │ -0000f810: 6564 2074 6f20 6d61 6b65 2073 7572 6520 ed to make sure │ │ │ │ │ -0000f820: 6974 7320 666f 726d 6174 2063 6f6d 706c its format compl │ │ │ │ │ -0000f830: 6965 7320 7769 7468 2047 6e69 7473 0a20 ies with Gnits. │ │ │ │ │ -0000f840: 2020 2020 7374 616e 6461 7264 732e 0a0a standards... │ │ │ │ │ -0000f850: 2020 202a 2049 6620 2756 4552 5349 4f4e * If 'VERSION │ │ │ │ │ -0000f860: 2720 696e 6469 6361 7465 7320 7468 6174 ' indicates that │ │ │ │ │ -0000f870: 2074 6869 7320 6973 2061 6e20 616c 7068 this is an alph │ │ │ │ │ -0000f880: 6120 7265 6c65 6173 652c 2061 6e64 2074 a release, and t │ │ │ │ │ -0000f890: 6865 2066 696c 650a 2020 2020 2027 5245 he file. 'RE │ │ │ │ │ -0000f8a0: 4144 4d45 2d61 6c70 6861 2720 6170 7065 ADME-alpha' appe │ │ │ │ │ -0000f8b0: 6172 7320 696e 2074 6865 2074 6f70 6d6f ars in the topmo │ │ │ │ │ -0000f8c0: 7374 2064 6972 6563 746f 7279 206f 6620 st directory of │ │ │ │ │ -0000f8d0: 6120 7061 636b 6167 652c 2074 6865 6e0a a package, then. │ │ │ │ │ -0000f8e0: 2020 2020 2069 7420 6973 2069 6e63 6c75 it is inclu │ │ │ │ │ -0000f8f0: 6465 6420 696e 2074 6865 2064 6973 7472 ded in the distr │ │ │ │ │ -0000f900: 6962 7574 696f 6e2e 2020 5468 6973 2069 ibution. This i │ │ │ │ │ -0000f910: 7320 646f 6e65 2069 6e20 272d 2d67 6e69 s done in '--gni │ │ │ │ │ -0000f920: 7473 270a 2020 2020 206d 6f64 652c 2061 ts'. mode, a │ │ │ │ │ -0000f930: 6e64 206e 6f20 6f74 6865 722c 2062 6563 nd no other, bec │ │ │ │ │ -0000f940: 6175 7365 2074 6869 7320 6d6f 6465 2069 ause this mode i │ │ │ │ │ -0000f950: 7320 7468 6520 6f6e 6c79 206f 6e65 2077 s the only one w │ │ │ │ │ -0000f960: 6865 7265 2076 6572 7369 6f6e 0a20 2020 here version. │ │ │ │ │ -0000f970: 2020 6e75 6d62 6572 2066 6f72 6d61 7473 number formats │ │ │ │ │ -0000f980: 2061 7265 2063 6f6e 7374 7261 696e 6564 are constrained │ │ │ │ │ -0000f990: 2c20 616e 6420 6865 6e63 6520 7468 6520 , and hence the │ │ │ │ │ -0000f9a0: 6f6e 6c79 206d 6f64 6520 7768 6572 650a only mode where. │ │ │ │ │ -0000f9b0: 2020 2020 2041 7574 6f6d 616b 6520 6361 Automake ca │ │ │ │ │ -0000f9c0: 6e20 6175 746f 6d61 7469 6361 6c6c 7920 n automatically │ │ │ │ │ -0000f9d0: 6465 7465 726d 696e 6520 7768 6574 6865 determine whethe │ │ │ │ │ -0000f9e0: 7220 2752 4541 444d 452d 616c 7068 6127 r 'README-alpha' │ │ │ │ │ -0000f9f0: 2073 686f 756c 640a 2020 2020 2062 6520 should. be │ │ │ │ │ -0000fa00: 696e 636c 7564 6564 2e0a 0a20 2020 2a20 included... * │ │ │ │ │ -0000fa10: 5468 6520 6669 6c65 2027 5448 414e 4b53 The file 'THANKS │ │ │ │ │ -0000fa20: 2720 6973 2072 6571 7569 7265 642e 0a0a ' is required... │ │ │ │ │ -0000fa30: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -0000fa40: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -0000fa50: 653a 2043 7967 6e75 732c 2020 4e65 7874 e: Cygnus, Next │ │ │ │ │ -0000fa60: 3a20 4e6f 7420 456e 6f75 6768 2c20 2050 : Not Enough, P │ │ │ │ │ -0000fa70: 7265 763a 2047 6e69 7473 2c20 2055 703a rev: Gnits, Up: │ │ │ │ │ -0000fa80: 2054 6f70 0a0a 3233 2054 6865 2065 6666 Top..23 The eff │ │ │ │ │ -0000fa90: 6563 7420 6f66 2027 2d2d 6379 676e 7573 ect of '--cygnus │ │ │ │ │ -0000faa0: 270a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a '.************** │ │ │ │ │ -0000fab0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a5f *************.._ │ │ │ │ │ -0000fac0: 5468 6520 6665 6174 7572 6573 2064 6573 The features des │ │ │ │ │ -0000fad0: 6372 6962 6564 2069 6e20 7468 6973 2073 cribed in this s │ │ │ │ │ -0000fae0: 6563 7469 6f6e 2061 7265 2064 6570 7265 ection are depre │ │ │ │ │ -0000faf0: 6361 7465 643b 2079 6f75 206d 7573 7420 cated; you must │ │ │ │ │ -0000fb00: 6e6f 7420 7573 650a 616e 7920 6f66 2074 not use.any of t │ │ │ │ │ -0000fb10: 6865 6d20 696e 206e 6577 2063 6f64 652c hem in new code, │ │ │ │ │ -0000fb20: 2061 6e64 2073 686f 756c 6420 7265 6d6f and should remo │ │ │ │ │ -0000fb30: 7665 2074 6865 6972 2075 7365 2066 726f ve their use fro │ │ │ │ │ -0000fb40: 6d20 6f6c 6465 7220 6275 740a 7374 696c m older but.stil │ │ │ │ │ -0000fb50: 6c20 6d61 696e 7461 696e 6564 2063 6f64 l maintained cod │ │ │ │ │ -0000fb60: 653a 2074 6865 7920 7769 6c6c 2062 6520 e: they will be │ │ │ │ │ -0000fb70: 7769 7468 6472 6177 6e20 696e 2061 2066 withdrawn in a f │ │ │ │ │ -0000fb80: 7574 7572 6520 4175 746f 6d61 6b65 0a72 uture Automake.r │ │ │ │ │ -0000fb90: 656c 6561 7365 2e5f 0a0a 2020 2053 6f6d elease._.. Som │ │ │ │ │ -0000fba0: 6520 7061 636b 6167 6573 2c20 6e6f 7461 e packages, nota │ │ │ │ │ -0000fbb0: 626c 7920 474e 5520 4743 4320 616e 6420 bly GNU GCC and │ │ │ │ │ -0000fbc0: 474e 5520 6764 622c 2075 7365 6420 746f GNU gdb, used to │ │ │ │ │ -0000fbd0: 2068 6176 6520 6120 6275 696c 640a 656e have a build.en │ │ │ │ │ -0000fbe0: 7669 726f 6e6d 656e 7420 6f72 6967 696e vironment origin │ │ │ │ │ -0000fbf0: 616c 6c79 2077 7269 7474 656e 2061 7420 ally written at │ │ │ │ │ -0000fc00: 4379 676e 7573 2053 7570 706f 7274 2028 Cygnus Support ( │ │ │ │ │ -0000fc10: 7375 6273 6571 7565 6e74 6c79 2072 656e subsequently ren │ │ │ │ │ -0000fc20: 616d 6564 0a43 7967 6e75 7320 536f 6c75 amed.Cygnus Solu │ │ │ │ │ -0000fc30: 7469 6f6e 732c 2061 6e64 2074 6865 6e20 tions, and then │ │ │ │ │ -0000fc40: 6c61 7465 7220 7075 7263 6861 7365 6420 later purchased │ │ │ │ │ -0000fc50: 6279 2052 6564 2048 6174 292e 2020 5061 by Red Hat). Pa │ │ │ │ │ -0000fc60: 636b 6167 6573 2077 6974 680a 7468 6973 ckages with.this │ │ │ │ │ -0000fc70: 2061 6e63 6573 7472 7920 6172 6520 736f ancestry are so │ │ │ │ │ -0000fc80: 6d65 7469 6d65 7320 7265 6665 7272 6564 metimes referred │ │ │ │ │ -0000fc90: 2074 6f20 6173 2022 4379 676e 7573 2220 to as "Cygnus" │ │ │ │ │ -0000fca0: 7472 6565 732e 0a0a 2020 2041 2043 7967 trees... A Cyg │ │ │ │ │ -0000fcb0: 6e75 7320 7472 6565 2068 6173 2073 6c69 nus tree has sli │ │ │ │ │ -0000fcc0: 6768 746c 7920 6469 6666 6572 656e 7420 ghtly different │ │ │ │ │ -0000fcd0: 7275 6c65 7320 666f 7220 686f 7720 6120 rules for how a │ │ │ │ │ -0000fce0: 274d 616b 6566 696c 652e 696e 2720 6973 'Makefile.in' is │ │ │ │ │ -0000fcf0: 0a74 6f20 6265 2063 6f6e 7374 7275 6374 .to be construct │ │ │ │ │ -0000fd00: 6564 2e20 2050 6173 7369 6e67 2027 2d2d ed. Passing '-- │ │ │ │ │ -0000fd10: 6379 676e 7573 2720 746f 2027 6175 746f cygnus' to 'auto │ │ │ │ │ -0000fd20: 6d61 6b65 2720 7769 6c6c 2063 6175 7365 make' will cause │ │ │ │ │ -0000fd30: 2061 6e79 0a67 656e 6572 6174 6564 2027 any.generated ' │ │ │ │ │ -0000fd40: 4d61 6b65 6669 6c65 2e69 6e27 2074 6f20 Makefile.in' to │ │ │ │ │ -0000fd50: 636f 6d70 6c79 2077 6974 6820 4379 676e comply with Cygn │ │ │ │ │ -0000fd60: 7573 2072 756c 6573 2e0a 0a20 2020 4865 us rules... He │ │ │ │ │ -0000fd70: 7265 2061 7265 2074 6865 2070 7265 6369 re are the preci │ │ │ │ │ -0000fd80: 7365 2065 6666 6563 7473 206f 6620 272d se effects of '- │ │ │ │ │ -0000fd90: 2d63 7967 6e75 7327 3a0a 0a20 2020 2a20 -cygnus':.. * │ │ │ │ │ -0000fda0: 5468 6520 2766 6f72 6569 676e 2720 7374 The 'foreign' st │ │ │ │ │ -0000fdb0: 7269 6374 6e65 7373 2069 7320 696d 706c rictness is impl │ │ │ │ │ -0000fdc0: 6965 642e 0a0a 2020 202a 2054 6865 206f ied... * The o │ │ │ │ │ -0000fdd0: 7074 696f 6e73 2027 6e6f 2d69 6e73 7461 ptions 'no-insta │ │ │ │ │ -0000fde0: 6c6c 696e 666f 272c 2027 6e6f 2d64 6570 llinfo', 'no-dep │ │ │ │ │ -0000fdf0: 656e 6465 6e63 6965 7327 2061 6e64 2027 endencies' and ' │ │ │ │ │ -0000fe00: 6e6f 2d64 6973 7427 2061 7265 0a20 2020 no-dist' are. │ │ │ │ │ -0000fe10: 2020 696d 706c 6965 6420 282a 6e6f 7465 implied (*note │ │ │ │ │ -0000fe20: 204f 7074 696f 6e73 3a3a 292e 0a0a 2020 Options::)... │ │ │ │ │ -0000fe30: 202a 2054 6865 206d 6163 726f 2027 414d * The macro 'AM │ │ │ │ │ -0000fe40: 5f4d 4149 4e54 4149 4e45 525f 4d4f 4445 _MAINTAINER_MODE │ │ │ │ │ -0000fe50: 2720 6973 2072 6571 7569 7265 642e 0a0a ' is required... │ │ │ │ │ -0000fe60: 2020 202a 2049 6e66 6f20 6669 6c65 7320 * Info files │ │ │ │ │ -0000fe70: 6172 6520 616c 7761 7973 2063 7265 6174 are always creat │ │ │ │ │ -0000fe80: 6564 2069 6e20 7468 6520 6275 696c 6420 ed in the build │ │ │ │ │ -0000fe90: 6469 7265 6374 6f72 792c 2061 6e64 206e directory, and n │ │ │ │ │ -0000fea0: 6f74 2069 6e0a 2020 2020 2074 6865 2073 ot in. the s │ │ │ │ │ -0000feb0: 6f75 7263 6520 6469 7265 6374 6f72 792e ource directory. │ │ │ │ │ -0000fec0: 2020 5061 636b 6167 6573 2074 6861 7420 Packages that │ │ │ │ │ -0000fed0: 646f 6e27 7420 7573 6520 7468 6520 2763 don't use the 'c │ │ │ │ │ -0000fee0: 7967 6e75 7327 206f 7074 696f 6e0a 2020 ygnus' option. │ │ │ │ │ -0000fef0: 2020 2063 616e 2065 6d75 6c61 7465 2074 can emulate t │ │ │ │ │ -0000ff00: 6869 7320 6566 6665 6374 2062 7920 7573 his effect by us │ │ │ │ │ -0000ff10: 696e 6720 7468 6520 276e 6f2d 696e 7374 ing the 'no-inst │ │ │ │ │ -0000ff20: 616c 6c69 6e66 6f27 206f 7074 696f 6e20 allinfo' option │ │ │ │ │ -0000ff30: 616e 640a 2020 2020 206c 6973 7469 6e67 and. listing │ │ │ │ │ -0000ff40: 2074 6865 2067 656e 6572 6174 6564 2069 the generated i │ │ │ │ │ -0000ff50: 6e66 6f20 6669 6c65 7320 696e 2074 6865 nfo files in the │ │ │ │ │ -0000ff60: 2027 434c 4541 4e46 494c 4553 2720 7661 'CLEANFILES' va │ │ │ │ │ -0000ff70: 7269 6162 6c65 2e0a 0a20 2020 2a20 2774 riable... * 't │ │ │ │ │ -0000ff80: 6578 696e 666f 2e74 6578 2720 6973 206e exinfo.tex' is n │ │ │ │ │ -0000ff90: 6f74 2072 6571 7569 7265 6420 6966 2061 ot required if a │ │ │ │ │ -0000ffa0: 2054 6578 696e 666f 2073 6f75 7263 6520 Texinfo source │ │ │ │ │ -0000ffb0: 6669 6c65 2069 730a 2020 2020 2073 7065 file is. spe │ │ │ │ │ -0000ffc0: 6369 6669 6564 2e20 2054 6865 2061 7373 cified. The ass │ │ │ │ │ -0000ffd0: 756d 7074 696f 6e20 6973 2074 6861 7420 umption is that │ │ │ │ │ -0000ffe0: 7468 6520 6669 6c65 2077 696c 6c20 6265 the file will be │ │ │ │ │ -0000fff0: 2073 7570 706c 6965 642c 2062 7574 0a20 supplied, but. │ │ │ │ │ -00010000: 2020 2020 696e 2061 2070 6c61 6365 2074 in a place t │ │ │ │ │ -00010010: 6861 7420 4175 746f 6d61 6b65 2063 616e hat Automake can │ │ │ │ │ -00010020: 6e6f 7420 6669 6e64 202d 2069 7420 6973 not find - it is │ │ │ │ │ -00010030: 2061 6e20 6172 7469 6661 6374 206f 6620 an artifact of │ │ │ │ │ -00010040: 686f 770a 2020 2020 2043 7967 6e75 7320 how. Cygnus │ │ │ │ │ -00010050: 7061 636b 6167 6573 2061 7265 2074 7970 packages are typ │ │ │ │ │ -00010060: 6963 616c 6c79 2062 756e 646c 6564 2e20 ically bundled. │ │ │ │ │ -00010070: 2054 6869 7320 6566 6665 6374 2063 616e This effect can │ │ │ │ │ -00010080: 2062 6520 656d 756c 6174 6564 0a20 2020 be emulated. │ │ │ │ │ -00010090: 2020 696e 2070 6163 6b61 6765 7320 6e6f in packages no │ │ │ │ │ -000100a0: 7420 7573 696e 6720 7468 6520 2763 7967 t using the 'cyg │ │ │ │ │ -000100b0: 6e75 7327 206f 7074 696f 6e20 7769 7468 nus' option with │ │ │ │ │ -000100c0: 2061 2070 726f 7065 7220 6465 6669 6e69 a proper defini │ │ │ │ │ -000100d0: 7469 6f6e 0a20 2020 2020 6f66 2074 6865 tion. of the │ │ │ │ │ -000100e0: 2027 5445 5849 4e46 4f5f 5445 5827 2076 'TEXINFO_TEX' v │ │ │ │ │ -000100f0: 6172 6961 626c 6520 282a 6e6f 7465 2054 ariable (*note T │ │ │ │ │ -00010100: 6578 696e 666f 3a3a 292e 0a0a 2020 202a exinfo::)... * │ │ │ │ │ -00010110: 2043 6572 7461 696e 2074 6f6f 6c73 2077 Certain tools w │ │ │ │ │ -00010120: 696c 6c20 6265 2073 6561 7263 6865 6420 ill be searched │ │ │ │ │ -00010130: 666f 7220 696e 2074 6865 2062 7569 6c64 for in the build │ │ │ │ │ -00010140: 2074 7265 6520 6173 2077 656c 6c20 6173 tree as well as │ │ │ │ │ -00010150: 2069 6e0a 2020 2020 2074 6865 2075 7365 in. the use │ │ │ │ │ -00010160: 7227 7320 2750 4154 4827 2e20 2054 6865 r's 'PATH'. The │ │ │ │ │ -00010170: 7365 2074 6f6f 6c73 2061 7265 2027 7275 se tools are 'ru │ │ │ │ │ -00010180: 6e74 6573 7427 2c20 2765 7870 6563 7427 ntest', 'expect' │ │ │ │ │ -00010190: 2c20 276d 616b 6569 6e66 6f27 0a20 2020 , 'makeinfo'. │ │ │ │ │ -000101a0: 2020 616e 6420 2774 6578 6932 6476 6927 and 'texi2dvi' │ │ │ │ │ -000101b0: 2e0a 0a20 2020 2a20 5468 6520 2763 6865 ... * The 'che │ │ │ │ │ -000101c0: 636b 2720 7461 7267 6574 2064 6f65 736e ck' target doesn │ │ │ │ │ -000101d0: 2774 2064 6570 656e 6420 6f6e 2027 616c 't depend on 'al │ │ │ │ │ -000101e0: 6c27 2e0a 0a1f 0a46 696c 653a 2061 7574 l'.....File: aut │ │ │ │ │ -000101f0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -00010200: 2020 4e6f 6465 3a20 4e6f 7420 456e 6f75 Node: Not Enou │ │ │ │ │ -00010210: 6768 2c20 204e 6578 743a 2044 6973 7472 gh, Next: Distr │ │ │ │ │ -00010220: 6962 7574 696e 672c 2020 5072 6576 3a20 ibuting, Prev: │ │ │ │ │ -00010230: 4379 676e 7573 2c20 2055 703a 2054 6f70 Cygnus, Up: Top │ │ │ │ │ -00010240: 0a0a 3234 2057 6865 6e20 4175 746f 6d61 ..24 When Automa │ │ │ │ │ -00010250: 6b65 2049 736e 2774 2045 6e6f 7567 680a ke Isn't Enough. │ │ │ │ │ -00010260: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00010270: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a49 *************..I │ │ │ │ │ -00010280: 6e20 736f 6d65 2073 6974 7561 7469 6f6e n some situation │ │ │ │ │ -00010290: 732c 2077 6865 7265 2041 7574 6f6d 616b s, where Automak │ │ │ │ │ -000102a0: 6520 6973 206e 6f74 2075 7020 746f 206f e is not up to o │ │ │ │ │ -000102b0: 6e65 2074 6173 6b2c 206f 6e65 2068 6173 ne task, one has │ │ │ │ │ -000102c0: 2074 6f0a 7265 736f 7274 2074 6f20 6861 to.resort to ha │ │ │ │ │ -000102d0: 6e64 7772 6974 7465 6e20 7275 6c65 7320 ndwritten rules │ │ │ │ │ -000102e0: 6f72 2065 7665 6e20 6861 6e64 7772 6974 or even handwrit │ │ │ │ │ -000102f0: 7465 6e20 274d 616b 6566 696c 6527 732e ten 'Makefile's. │ │ │ │ │ -00010300: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2045 7874 ..* Menu:..* Ext │ │ │ │ │ -00010310: 656e 6469 6e67 3a3a 2020 2020 2020 2020 ending:: │ │ │ │ │ -00010320: 2020 2020 2020 2020 2020 2041 6464 696e Addin │ │ │ │ │ -00010330: 6720 6e65 7720 7275 6c65 7320 6f72 206f g new rules or o │ │ │ │ │ -00010340: 7665 7272 6964 696e 6720 6578 6973 7469 verriding existi │ │ │ │ │ -00010350: 6e67 206f 6e65 732e 0a2a 2054 6869 7264 ng ones..* Third │ │ │ │ │ -00010360: 2d50 6172 7479 204d 616b 6566 696c 6573 -Party Makefiles │ │ │ │ │ -00010370: 3a3a 2020 2020 2020 2049 6e74 6567 7261 :: Integra │ │ │ │ │ -00010380: 7469 6e67 204e 6f6e 2d41 7574 6f6d 616b ting Non-Automak │ │ │ │ │ -00010390: 6520 274d 616b 6566 696c 6527 732e 0a0a e 'Makefile's... │ │ │ │ │ -000103a0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -000103b0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -000103c0: 653a 2045 7874 656e 6469 6e67 2c20 204e e: Extending, N │ │ │ │ │ -000103d0: 6578 743a 2054 6869 7264 2d50 6172 7479 ext: Third-Party │ │ │ │ │ -000103e0: 204d 616b 6566 696c 6573 2c20 2055 703a Makefiles, Up: │ │ │ │ │ -000103f0: 204e 6f74 2045 6e6f 7567 680a 0a32 342e Not Enough..24. │ │ │ │ │ -00010400: 3120 4578 7465 6e64 696e 6720 4175 746f 1 Extending Auto │ │ │ │ │ -00010410: 6d61 6b65 2052 756c 6573 0a3d 3d3d 3d3d make Rules.===== │ │ │ │ │ +0000f1d0: 2a2a 0a0a 5468 6520 272d 2d67 6e75 2720 **..The '--gnu' │ │ │ │ │ +0000f1e0: 6f70 7469 6f6e 2028 6f72 2027 676e 7527 option (or 'gnu' │ │ │ │ │ +0000f1f0: 2069 6e20 7468 6520 2741 5554 4f4d 414b in the 'AUTOMAK │ │ │ │ │ +0000f200: 455f 4f50 5449 4f4e 5327 2076 6172 6961 E_OPTIONS' varia │ │ │ │ │ +0000f210: 626c 6529 2063 6175 7365 730a 2761 7574 ble) causes.'aut │ │ │ │ │ +0000f220: 6f6d 616b 6527 2074 6f20 6368 6563 6b20 omake' to check │ │ │ │ │ +0000f230: 7468 6520 666f 6c6c 6f77 696e 673a 0a0a the following:.. │ │ │ │ │ +0000f240: 2020 202a 2054 6865 2066 696c 6573 2027 * The files ' │ │ │ │ │ +0000f250: 494e 5354 414c 4c27 2c20 274e 4557 5327 INSTALL', 'NEWS' │ │ │ │ │ +0000f260: 2c20 2752 4541 444d 4527 2c20 2741 5554 , 'README', 'AUT │ │ │ │ │ +0000f270: 484f 5253 272c 2061 6e64 2027 4368 616e HORS', and 'Chan │ │ │ │ │ +0000f280: 6765 4c6f 6727 2c0a 2020 2020 2070 6c75 geLog',. plu │ │ │ │ │ +0000f290: 7320 6f6e 6520 6f66 2027 434f 5059 494e s one of 'COPYIN │ │ │ │ │ +0000f2a0: 472e 4c49 4227 2c20 2743 4f50 5949 4e47 G.LIB', 'COPYING │ │ │ │ │ +0000f2b0: 2e4c 4553 5345 5227 206f 7220 2743 4f50 .LESSER' or 'COP │ │ │ │ │ +0000f2c0: 5949 4e47 272c 2061 7265 0a20 2020 2020 YING', are. │ │ │ │ │ +0000f2d0: 7265 7175 6972 6564 2061 7420 7468 6520 required at the │ │ │ │ │ +0000f2e0: 746f 706d 6f73 7420 6469 7265 6374 6f72 topmost director │ │ │ │ │ +0000f2f0: 7920 6f66 2074 6865 2070 6163 6b61 6765 y of the package │ │ │ │ │ +0000f300: 2e0a 0a20 2020 2020 4966 2074 6865 2027 ... If the ' │ │ │ │ │ +0000f310: 2d2d 6164 642d 6d69 7373 696e 6727 206f --add-missing' o │ │ │ │ │ +0000f320: 7074 696f 6e20 6973 2067 6976 656e 2c20 ption is given, │ │ │ │ │ +0000f330: 2761 7574 6f6d 616b 6527 2077 696c 6c20 'automake' will │ │ │ │ │ +0000f340: 6164 6420 610a 2020 2020 2067 656e 6572 add a. gener │ │ │ │ │ +0000f350: 6963 2076 6572 7369 6f6e 206f 6620 7468 ic version of th │ │ │ │ │ +0000f360: 6520 2749 4e53 5441 4c4c 2720 6669 6c65 e 'INSTALL' file │ │ │ │ │ +0000f370: 2061 7320 7765 6c6c 2061 7320 7468 6520 as well as the │ │ │ │ │ +0000f380: 2743 4f50 5949 4e47 2720 6669 6c65 0a20 'COPYING' file. │ │ │ │ │ +0000f390: 2020 2020 636f 6e74 6169 6e69 6e67 2074 containing t │ │ │ │ │ +0000f3a0: 6865 2074 6578 7420 6f66 2074 6865 2063 he text of the c │ │ │ │ │ +0000f3b0: 7572 7265 6e74 2076 6572 7369 6f6e 206f urrent version o │ │ │ │ │ +0000f3c0: 6620 7468 6520 474e 5520 4765 6e65 7261 f the GNU Genera │ │ │ │ │ +0000f3d0: 6c0a 2020 2020 2050 7562 6c69 6320 4c69 l. Public Li │ │ │ │ │ +0000f3e0: 6365 6e73 6520 6578 6973 7469 6e67 2061 cense existing a │ │ │ │ │ +0000f3f0: 7420 7468 6520 7469 6d65 206f 6620 7468 t the time of th │ │ │ │ │ +0000f400: 6973 2041 7574 6f6d 616b 6520 7265 6c65 is Automake rele │ │ │ │ │ +0000f410: 6173 650a 2020 2020 2028 7665 7273 696f ase. (versio │ │ │ │ │ +0000f420: 6e20 3320 6173 2074 6869 7320 6973 2077 n 3 as this is w │ │ │ │ │ +0000f430: 7269 7474 656e 2c0a 2020 2020 203c 6874 ritten,. ). However, │ │ │ │ │ +0000f470: 616e 2065 7869 7374 696e 670a 2020 2020 an existing. │ │ │ │ │ +0000f480: 2027 434f 5059 494e 4727 2066 696c 6520 'COPYING' file │ │ │ │ │ +0000f490: 7769 6c6c 206e 6576 6572 2062 6520 6f76 will never be ov │ │ │ │ │ +0000f4a0: 6572 7772 6974 7465 6e20 6279 2027 6175 erwritten by 'au │ │ │ │ │ +0000f4b0: 746f 6d61 6b65 272e 0a0a 2020 202a 2054 tomake'... * T │ │ │ │ │ +0000f4c0: 6865 206f 7074 696f 6e73 2027 6e6f 2d69 he options 'no-i │ │ │ │ │ +0000f4d0: 6e73 7461 6c6c 6d61 6e27 2061 6e64 2027 nstallman' and ' │ │ │ │ │ +0000f4e0: 6e6f 2d69 6e73 7461 6c6c 696e 666f 2720 no-installinfo' │ │ │ │ │ +0000f4f0: 6172 6520 7072 6f68 6962 6974 6564 2e0a are prohibited.. │ │ │ │ │ +0000f500: 0a20 2020 4e6f 7465 2074 6861 7420 7468 . Note that th │ │ │ │ │ +0000f510: 6973 206f 7074 696f 6e20 7769 6c6c 2062 is option will b │ │ │ │ │ +0000f520: 6520 6578 7465 6e64 6564 2069 6e20 7468 e extended in th │ │ │ │ │ +0000f530: 6520 6675 7475 7265 2074 6f20 646f 2065 e future to do e │ │ │ │ │ +0000f540: 7665 6e20 6d6f 7265 0a63 6865 636b 696e ven more.checkin │ │ │ │ │ +0000f550: 673b 2069 7420 6973 2061 6476 6973 6162 g; it is advisab │ │ │ │ │ +0000f560: 6c65 2074 6f20 6265 2066 616d 696c 6961 le to be familia │ │ │ │ │ +0000f570: 7220 7769 7468 2074 6865 2070 7265 6369 r with the preci │ │ │ │ │ +0000f580: 7365 2072 6571 7569 7265 6d65 6e74 730a se requirements. │ │ │ │ │ +0000f590: 6f66 2074 6865 2047 4e55 2073 7461 6e64 of the GNU stand │ │ │ │ │ +0000f5a0: 6172 6473 2e20 2041 6c73 6f2c 2027 2d2d ards. Also, '-- │ │ │ │ │ +0000f5b0: 676e 7527 2063 616e 2072 6571 7569 7265 gnu' can require │ │ │ │ │ +0000f5c0: 2063 6572 7461 696e 206e 6f6e 2d73 7461 certain non-sta │ │ │ │ │ +0000f5d0: 6e64 6172 640a 474e 5520 7072 6f67 7261 ndard.GNU progra │ │ │ │ │ +0000f5e0: 6d73 2074 6f20 6578 6973 7420 666f 7220 ms to exist for │ │ │ │ │ +0000f5f0: 7573 6520 6279 2076 6172 696f 7573 206d use by various m │ │ │ │ │ +0000f600: 6169 6e74 6169 6e65 722d 6f6e 6c79 2072 aintainer-only r │ │ │ │ │ +0000f610: 756c 6573 3b20 666f 720a 696e 7374 616e ules; for.instan │ │ │ │ │ +0000f620: 6365 2c20 696e 2074 6865 2066 7574 7572 ce, in the futur │ │ │ │ │ +0000f630: 6520 2770 6174 6863 686b 2720 6d69 6768 e 'pathchk' migh │ │ │ │ │ +0000f640: 7420 6265 2072 6571 7569 7265 6420 666f t be required fo │ │ │ │ │ +0000f650: 7220 276d 616b 6520 6469 7374 272e 0a0a r 'make dist'... │ │ │ │ │ +0000f660: 2020 2054 6865 2027 2d2d 676e 6974 7327 The '--gnits' │ │ │ │ │ +0000f670: 206f 7074 696f 6e20 646f 6573 2065 7665 option does eve │ │ │ │ │ +0000f680: 7279 7468 696e 6720 7468 6174 2027 2d2d rything that '-- │ │ │ │ │ +0000f690: 676e 7527 2064 6f65 732c 2061 6e64 2063 gnu' does, and c │ │ │ │ │ +0000f6a0: 6865 636b 730a 7468 6520 666f 6c6c 6f77 hecks.the follow │ │ │ │ │ +0000f6b0: 696e 6720 6173 2077 656c 6c3a 0a0a 2020 ing as well:.. │ │ │ │ │ +0000f6c0: 202a 2027 6d61 6b65 2069 6e73 7461 6c6c * 'make install │ │ │ │ │ +0000f6d0: 6368 6563 6b27 2077 696c 6c20 6368 6563 check' will chec │ │ │ │ │ +0000f6e0: 6b20 746f 206d 616b 6520 7375 7265 2074 k to make sure t │ │ │ │ │ +0000f6f0: 6861 7420 7468 6520 272d 2d68 656c 7027 hat the '--help' │ │ │ │ │ +0000f700: 2061 6e64 0a20 2020 2020 272d 2d76 6572 and. '--ver │ │ │ │ │ +0000f710: 7369 6f6e 2720 7265 616c 6c79 2070 7269 sion' really pri │ │ │ │ │ +0000f720: 6e74 2061 2075 7361 6765 206d 6573 7361 nt a usage messa │ │ │ │ │ +0000f730: 6765 2061 6e64 2061 2076 6572 7369 6f6e ge and a version │ │ │ │ │ +0000f740: 2073 7472 696e 672c 0a20 2020 2020 7265 string,. re │ │ │ │ │ +0000f750: 7370 6563 7469 7665 6c79 2e20 2054 6869 spectively. Thi │ │ │ │ │ +0000f760: 7320 6973 2074 6865 2027 7374 642d 6f70 s is the 'std-op │ │ │ │ │ +0000f770: 7469 6f6e 7327 206f 7074 696f 6e20 282a tions' option (* │ │ │ │ │ +0000f780: 6e6f 7465 204f 7074 696f 6e73 3a3a 292e note Options::). │ │ │ │ │ +0000f790: 0a0a 2020 202a 2027 6d61 6b65 2064 6973 .. * 'make dis │ │ │ │ │ +0000f7a0: 7427 2077 696c 6c20 6368 6563 6b20 746f t' will check to │ │ │ │ │ +0000f7b0: 206d 616b 6520 7375 7265 2074 6865 2027 make sure the ' │ │ │ │ │ +0000f7c0: 4e45 5753 2720 6669 6c65 2068 6173 2062 NEWS' file has b │ │ │ │ │ +0000f7d0: 6565 6e0a 2020 2020 2075 7064 6174 6564 een. updated │ │ │ │ │ +0000f7e0: 2074 6f20 7468 6520 6375 7272 656e 7420 to the current │ │ │ │ │ +0000f7f0: 7665 7273 696f 6e2e 0a0a 2020 202a 2027 version... * ' │ │ │ │ │ +0000f800: 5645 5253 494f 4e27 2069 7320 6368 6563 VERSION' is chec │ │ │ │ │ +0000f810: 6b65 6420 746f 206d 616b 6520 7375 7265 ked to make sure │ │ │ │ │ +0000f820: 2069 7473 2066 6f72 6d61 7420 636f 6d70 its format comp │ │ │ │ │ +0000f830: 6c69 6573 2077 6974 6820 476e 6974 730a lies with Gnits. │ │ │ │ │ +0000f840: 2020 2020 2073 7461 6e64 6172 6473 2e0a standards.. │ │ │ │ │ +0000f850: 0a20 2020 2a20 4966 2027 5645 5253 494f . * If 'VERSIO │ │ │ │ │ +0000f860: 4e27 2069 6e64 6963 6174 6573 2074 6861 N' indicates tha │ │ │ │ │ +0000f870: 7420 7468 6973 2069 7320 616e 2061 6c70 t this is an alp │ │ │ │ │ +0000f880: 6861 2072 656c 6561 7365 2c20 616e 6420 ha release, and │ │ │ │ │ +0000f890: 7468 6520 6669 6c65 0a20 2020 2020 2752 the file. 'R │ │ │ │ │ +0000f8a0: 4541 444d 452d 616c 7068 6127 2061 7070 EADME-alpha' app │ │ │ │ │ +0000f8b0: 6561 7273 2069 6e20 7468 6520 746f 706d ears in the topm │ │ │ │ │ +0000f8c0: 6f73 7420 6469 7265 6374 6f72 7920 6f66 ost directory of │ │ │ │ │ +0000f8d0: 2061 2070 6163 6b61 6765 2c20 7468 656e a package, then │ │ │ │ │ +0000f8e0: 0a20 2020 2020 6974 2069 7320 696e 636c . it is incl │ │ │ │ │ +0000f8f0: 7564 6564 2069 6e20 7468 6520 6469 7374 uded in the dist │ │ │ │ │ +0000f900: 7269 6275 7469 6f6e 2e20 2054 6869 7320 ribution. This │ │ │ │ │ +0000f910: 6973 2064 6f6e 6520 696e 2027 2d2d 676e is done in '--gn │ │ │ │ │ +0000f920: 6974 7327 0a20 2020 2020 6d6f 6465 2c20 its'. mode, │ │ │ │ │ +0000f930: 616e 6420 6e6f 206f 7468 6572 2c20 6265 and no other, be │ │ │ │ │ +0000f940: 6361 7573 6520 7468 6973 206d 6f64 6520 cause this mode │ │ │ │ │ +0000f950: 6973 2074 6865 206f 6e6c 7920 6f6e 6520 is the only one │ │ │ │ │ +0000f960: 7768 6572 6520 7665 7273 696f 6e0a 2020 where version. │ │ │ │ │ +0000f970: 2020 206e 756d 6265 7220 666f 726d 6174 number format │ │ │ │ │ +0000f980: 7320 6172 6520 636f 6e73 7472 6169 6e65 s are constraine │ │ │ │ │ +0000f990: 642c 2061 6e64 2068 656e 6365 2074 6865 d, and hence the │ │ │ │ │ +0000f9a0: 206f 6e6c 7920 6d6f 6465 2077 6865 7265 only mode where │ │ │ │ │ +0000f9b0: 0a20 2020 2020 4175 746f 6d61 6b65 2063 . Automake c │ │ │ │ │ +0000f9c0: 616e 2061 7574 6f6d 6174 6963 616c 6c79 an automatically │ │ │ │ │ +0000f9d0: 2064 6574 6572 6d69 6e65 2077 6865 7468 determine wheth │ │ │ │ │ +0000f9e0: 6572 2027 5245 4144 4d45 2d61 6c70 6861 er 'README-alpha │ │ │ │ │ +0000f9f0: 2720 7368 6f75 6c64 0a20 2020 2020 6265 ' should. be │ │ │ │ │ +0000fa00: 2069 6e63 6c75 6465 642e 0a0a 2020 202a included... * │ │ │ │ │ +0000fa10: 2054 6865 2066 696c 6520 2754 4841 4e4b The file 'THANK │ │ │ │ │ +0000fa20: 5327 2069 7320 7265 7175 6972 6564 2e0a S' is required.. │ │ │ │ │ +0000fa30: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +0000fa40: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +0000fa50: 6465 3a20 4379 676e 7573 2c20 204e 6578 de: Cygnus, Nex │ │ │ │ │ +0000fa60: 743a 204e 6f74 2045 6e6f 7567 682c 2020 t: Not Enough, │ │ │ │ │ +0000fa70: 5072 6576 3a20 476e 6974 732c 2020 5570 Prev: Gnits, Up │ │ │ │ │ +0000fa80: 3a20 546f 700a 0a32 3320 5468 6520 6566 : Top..23 The ef │ │ │ │ │ +0000fa90: 6665 6374 206f 6620 272d 2d63 7967 6e75 fect of '--cygnu │ │ │ │ │ +0000faa0: 7327 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a s'.************* │ │ │ │ │ +0000fab0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +0000fac0: 5f54 6865 2066 6561 7475 7265 7320 6465 _The features de │ │ │ │ │ +0000fad0: 7363 7269 6265 6420 696e 2074 6869 7320 scribed in this │ │ │ │ │ +0000fae0: 7365 6374 696f 6e20 6172 6520 6465 7072 section are depr │ │ │ │ │ +0000faf0: 6563 6174 6564 3b20 796f 7520 6d75 7374 ecated; you must │ │ │ │ │ +0000fb00: 206e 6f74 2075 7365 0a61 6e79 206f 6620 not use.any of │ │ │ │ │ +0000fb10: 7468 656d 2069 6e20 6e65 7720 636f 6465 them in new code │ │ │ │ │ +0000fb20: 2c20 616e 6420 7368 6f75 6c64 2072 656d , and should rem │ │ │ │ │ +0000fb30: 6f76 6520 7468 6569 7220 7573 6520 6672 ove their use fr │ │ │ │ │ +0000fb40: 6f6d 206f 6c64 6572 2062 7574 0a73 7469 om older but.sti │ │ │ │ │ +0000fb50: 6c6c 206d 6169 6e74 6169 6e65 6420 636f ll maintained co │ │ │ │ │ +0000fb60: 6465 3a20 7468 6579 2077 696c 6c20 6265 de: they will be │ │ │ │ │ +0000fb70: 2077 6974 6864 7261 776e 2069 6e20 6120 withdrawn in a │ │ │ │ │ +0000fb80: 6675 7475 7265 2041 7574 6f6d 616b 650a future Automake. │ │ │ │ │ +0000fb90: 7265 6c65 6173 652e 5f0a 0a20 2020 536f release._.. So │ │ │ │ │ +0000fba0: 6d65 2070 6163 6b61 6765 732c 206e 6f74 me packages, not │ │ │ │ │ +0000fbb0: 6162 6c79 2047 4e55 2047 4343 2061 6e64 ably GNU GCC and │ │ │ │ │ +0000fbc0: 2047 4e55 2067 6462 2c20 7573 6564 2074 GNU gdb, used t │ │ │ │ │ +0000fbd0: 6f20 6861 7665 2061 2062 7569 6c64 0a65 o have a build.e │ │ │ │ │ +0000fbe0: 6e76 6972 6f6e 6d65 6e74 206f 7269 6769 nvironment origi │ │ │ │ │ +0000fbf0: 6e61 6c6c 7920 7772 6974 7465 6e20 6174 nally written at │ │ │ │ │ +0000fc00: 2043 7967 6e75 7320 5375 7070 6f72 7420 Cygnus Support │ │ │ │ │ +0000fc10: 2873 7562 7365 7175 656e 746c 7920 7265 (subsequently re │ │ │ │ │ +0000fc20: 6e61 6d65 640a 4379 676e 7573 2053 6f6c named.Cygnus Sol │ │ │ │ │ +0000fc30: 7574 696f 6e73 2c20 616e 6420 7468 656e utions, and then │ │ │ │ │ +0000fc40: 206c 6174 6572 2070 7572 6368 6173 6564 later purchased │ │ │ │ │ +0000fc50: 2062 7920 5265 6420 4861 7429 2e20 2050 by Red Hat). P │ │ │ │ │ +0000fc60: 6163 6b61 6765 7320 7769 7468 0a74 6869 ackages with.thi │ │ │ │ │ +0000fc70: 7320 616e 6365 7374 7279 2061 7265 2073 s ancestry are s │ │ │ │ │ +0000fc80: 6f6d 6574 696d 6573 2072 6566 6572 7265 ometimes referre │ │ │ │ │ +0000fc90: 6420 746f 2061 7320 2243 7967 6e75 7322 d to as "Cygnus" │ │ │ │ │ +0000fca0: 2074 7265 6573 2e0a 0a20 2020 4120 4379 trees... A Cy │ │ │ │ │ +0000fcb0: 676e 7573 2074 7265 6520 6861 7320 736c gnus tree has sl │ │ │ │ │ +0000fcc0: 6967 6874 6c79 2064 6966 6665 7265 6e74 ightly different │ │ │ │ │ +0000fcd0: 2072 756c 6573 2066 6f72 2068 6f77 2061 rules for how a │ │ │ │ │ +0000fce0: 2027 4d61 6b65 6669 6c65 2e69 6e27 2069 'Makefile.in' i │ │ │ │ │ +0000fcf0: 730a 746f 2062 6520 636f 6e73 7472 7563 s.to be construc │ │ │ │ │ +0000fd00: 7465 642e 2020 5061 7373 696e 6720 272d ted. Passing '- │ │ │ │ │ +0000fd10: 2d63 7967 6e75 7327 2074 6f20 2761 7574 -cygnus' to 'aut │ │ │ │ │ +0000fd20: 6f6d 616b 6527 2077 696c 6c20 6361 7573 omake' will caus │ │ │ │ │ +0000fd30: 6520 616e 790a 6765 6e65 7261 7465 6420 e any.generated │ │ │ │ │ +0000fd40: 274d 616b 6566 696c 652e 696e 2720 746f 'Makefile.in' to │ │ │ │ │ +0000fd50: 2063 6f6d 706c 7920 7769 7468 2043 7967 comply with Cyg │ │ │ │ │ +0000fd60: 6e75 7320 7275 6c65 732e 0a0a 2020 2048 nus rules... H │ │ │ │ │ +0000fd70: 6572 6520 6172 6520 7468 6520 7072 6563 ere are the prec │ │ │ │ │ +0000fd80: 6973 6520 6566 6665 6374 7320 6f66 2027 ise effects of ' │ │ │ │ │ +0000fd90: 2d2d 6379 676e 7573 273a 0a0a 2020 202a --cygnus':.. * │ │ │ │ │ +0000fda0: 2054 6865 2027 666f 7265 6967 6e27 2073 The 'foreign' s │ │ │ │ │ +0000fdb0: 7472 6963 746e 6573 7320 6973 2069 6d70 trictness is imp │ │ │ │ │ +0000fdc0: 6c69 6564 2e0a 0a20 2020 2a20 5468 6520 lied... * The │ │ │ │ │ +0000fdd0: 6f70 7469 6f6e 7320 276e 6f2d 696e 7374 options 'no-inst │ │ │ │ │ +0000fde0: 616c 6c69 6e66 6f27 2c20 276e 6f2d 6465 allinfo', 'no-de │ │ │ │ │ +0000fdf0: 7065 6e64 656e 6369 6573 2720 616e 6420 pendencies' and │ │ │ │ │ +0000fe00: 276e 6f2d 6469 7374 2720 6172 650a 2020 'no-dist' are. │ │ │ │ │ +0000fe10: 2020 2069 6d70 6c69 6564 2028 2a6e 6f74 implied (*not │ │ │ │ │ +0000fe20: 6520 4f70 7469 6f6e 733a 3a29 2e0a 0a20 e Options::)... │ │ │ │ │ +0000fe30: 2020 2a20 5468 6520 6d61 6372 6f20 2741 * The macro 'A │ │ │ │ │ +0000fe40: 4d5f 4d41 494e 5441 494e 4552 5f4d 4f44 M_MAINTAINER_MOD │ │ │ │ │ +0000fe50: 4527 2069 7320 7265 7175 6972 6564 2e0a E' is required.. │ │ │ │ │ +0000fe60: 0a20 2020 2a20 496e 666f 2066 696c 6573 . * Info files │ │ │ │ │ +0000fe70: 2061 7265 2061 6c77 6179 7320 6372 6561 are always crea │ │ │ │ │ +0000fe80: 7465 6420 696e 2074 6865 2062 7569 6c64 ted in the build │ │ │ │ │ +0000fe90: 2064 6972 6563 746f 7279 2c20 616e 6420 directory, and │ │ │ │ │ +0000fea0: 6e6f 7420 696e 0a20 2020 2020 7468 6520 not in. the │ │ │ │ │ +0000feb0: 736f 7572 6365 2064 6972 6563 746f 7279 source directory │ │ │ │ │ +0000fec0: 2e20 2050 6163 6b61 6765 7320 7468 6174 . Packages that │ │ │ │ │ +0000fed0: 2064 6f6e 2774 2075 7365 2074 6865 2027 don't use the ' │ │ │ │ │ +0000fee0: 6379 676e 7573 2720 6f70 7469 6f6e 0a20 cygnus' option. │ │ │ │ │ +0000fef0: 2020 2020 6361 6e20 656d 756c 6174 6520 can emulate │ │ │ │ │ +0000ff00: 7468 6973 2065 6666 6563 7420 6279 2075 this effect by u │ │ │ │ │ +0000ff10: 7369 6e67 2074 6865 2027 6e6f 2d69 6e73 sing the 'no-ins │ │ │ │ │ +0000ff20: 7461 6c6c 696e 666f 2720 6f70 7469 6f6e tallinfo' option │ │ │ │ │ +0000ff30: 2061 6e64 0a20 2020 2020 6c69 7374 696e and. listin │ │ │ │ │ +0000ff40: 6720 7468 6520 6765 6e65 7261 7465 6420 g the generated │ │ │ │ │ +0000ff50: 696e 666f 2066 696c 6573 2069 6e20 7468 info files in th │ │ │ │ │ +0000ff60: 6520 2743 4c45 414e 4649 4c45 5327 2076 e 'CLEANFILES' v │ │ │ │ │ +0000ff70: 6172 6961 626c 652e 0a0a 2020 202a 2027 ariable... * ' │ │ │ │ │ +0000ff80: 7465 7869 6e66 6f2e 7465 7827 2069 7320 texinfo.tex' is │ │ │ │ │ +0000ff90: 6e6f 7420 7265 7175 6972 6564 2069 6620 not required if │ │ │ │ │ +0000ffa0: 6120 5465 7869 6e66 6f20 736f 7572 6365 a Texinfo source │ │ │ │ │ +0000ffb0: 2066 696c 6520 6973 0a20 2020 2020 7370 file is. sp │ │ │ │ │ +0000ffc0: 6563 6966 6965 642e 2020 5468 6520 6173 ecified. The as │ │ │ │ │ +0000ffd0: 7375 6d70 7469 6f6e 2069 7320 7468 6174 sumption is that │ │ │ │ │ +0000ffe0: 2074 6865 2066 696c 6520 7769 6c6c 2062 the file will b │ │ │ │ │ +0000fff0: 6520 7375 7070 6c69 6564 2c20 6275 740a e supplied, but. │ │ │ │ │ +00010000: 2020 2020 2069 6e20 6120 706c 6163 6520 in a place │ │ │ │ │ +00010010: 7468 6174 2041 7574 6f6d 616b 6520 6361 that Automake ca │ │ │ │ │ +00010020: 6e6e 6f74 2066 696e 6420 2d20 6974 2069 nnot find - it i │ │ │ │ │ +00010030: 7320 616e 2061 7274 6966 6163 7420 6f66 s an artifact of │ │ │ │ │ +00010040: 2068 6f77 0a20 2020 2020 4379 676e 7573 how. Cygnus │ │ │ │ │ +00010050: 2070 6163 6b61 6765 7320 6172 6520 7479 packages are ty │ │ │ │ │ +00010060: 7069 6361 6c6c 7920 6275 6e64 6c65 642e pically bundled. │ │ │ │ │ +00010070: 2020 5468 6973 2065 6666 6563 7420 6361 This effect ca │ │ │ │ │ +00010080: 6e20 6265 2065 6d75 6c61 7465 640a 2020 n be emulated. │ │ │ │ │ +00010090: 2020 2069 6e20 7061 636b 6167 6573 206e in packages n │ │ │ │ │ +000100a0: 6f74 2075 7369 6e67 2074 6865 2027 6379 ot using the 'cy │ │ │ │ │ +000100b0: 676e 7573 2720 6f70 7469 6f6e 2077 6974 gnus' option wit │ │ │ │ │ +000100c0: 6820 6120 7072 6f70 6572 2064 6566 696e h a proper defin │ │ │ │ │ +000100d0: 6974 696f 6e0a 2020 2020 206f 6620 7468 ition. of th │ │ │ │ │ +000100e0: 6520 2754 4558 494e 464f 5f54 4558 2720 e 'TEXINFO_TEX' │ │ │ │ │ +000100f0: 7661 7269 6162 6c65 2028 2a6e 6f74 6520 variable (*note │ │ │ │ │ +00010100: 5465 7869 6e66 6f3a 3a29 2e0a 0a20 2020 Texinfo::)... │ │ │ │ │ +00010110: 2a20 4365 7274 6169 6e20 746f 6f6c 7320 * Certain tools │ │ │ │ │ +00010120: 7769 6c6c 2062 6520 7365 6172 6368 6564 will be searched │ │ │ │ │ +00010130: 2066 6f72 2069 6e20 7468 6520 6275 696c for in the buil │ │ │ │ │ +00010140: 6420 7472 6565 2061 7320 7765 6c6c 2061 d tree as well a │ │ │ │ │ +00010150: 7320 696e 0a20 2020 2020 7468 6520 7573 s in. the us │ │ │ │ │ +00010160: 6572 2773 2027 5041 5448 272e 2020 5468 er's 'PATH'. Th │ │ │ │ │ +00010170: 6573 6520 746f 6f6c 7320 6172 6520 2772 ese tools are 'r │ │ │ │ │ +00010180: 756e 7465 7374 272c 2027 6578 7065 6374 untest', 'expect │ │ │ │ │ +00010190: 272c 2027 6d61 6b65 696e 666f 270a 2020 ', 'makeinfo'. │ │ │ │ │ +000101a0: 2020 2061 6e64 2027 7465 7869 3264 7669 and 'texi2dvi │ │ │ │ │ +000101b0: 272e 0a0a 2020 202a 2054 6865 2027 6368 '... * The 'ch │ │ │ │ │ +000101c0: 6563 6b27 2074 6172 6765 7420 646f 6573 eck' target does │ │ │ │ │ +000101d0: 6e27 7420 6465 7065 6e64 206f 6e20 2761 n't depend on 'a │ │ │ │ │ +000101e0: 6c6c 272e 0a0a 1f0a 4669 6c65 3a20 6175 ll'.....File: au │ │ │ │ │ +000101f0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +00010200: 2c20 204e 6f64 653a 204e 6f74 2045 6e6f , Node: Not Eno │ │ │ │ │ +00010210: 7567 682c 2020 4e65 7874 3a20 4469 7374 ugh, Next: Dist │ │ │ │ │ +00010220: 7269 6275 7469 6e67 2c20 2050 7265 763a ributing, Prev: │ │ │ │ │ +00010230: 2043 7967 6e75 732c 2020 5570 3a20 546f Cygnus, Up: To │ │ │ │ │ +00010240: 700a 0a32 3420 5768 656e 2041 7574 6f6d p..24 When Autom │ │ │ │ │ +00010250: 616b 6520 4973 6e27 7420 456e 6f75 6768 ake Isn't Enough │ │ │ │ │ +00010260: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ +00010270: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +00010280: 496e 2073 6f6d 6520 7369 7475 6174 696f In some situatio │ │ │ │ │ +00010290: 6e73 2c20 7768 6572 6520 4175 746f 6d61 ns, where Automa │ │ │ │ │ +000102a0: 6b65 2069 7320 6e6f 7420 7570 2074 6f20 ke is not up to │ │ │ │ │ +000102b0: 6f6e 6520 7461 736b 2c20 6f6e 6520 6861 one task, one ha │ │ │ │ │ +000102c0: 7320 746f 0a72 6573 6f72 7420 746f 2068 s to.resort to h │ │ │ │ │ +000102d0: 616e 6477 7269 7474 656e 2072 756c 6573 andwritten rules │ │ │ │ │ +000102e0: 206f 7220 6576 656e 2068 616e 6477 7269 or even handwri │ │ │ │ │ +000102f0: 7474 656e 2027 4d61 6b65 6669 6c65 2773 tten 'Makefile's │ │ │ │ │ +00010300: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 4578 ...* Menu:..* Ex │ │ │ │ │ +00010310: 7465 6e64 696e 673a 3a20 2020 2020 2020 tending:: │ │ │ │ │ +00010320: 2020 2020 2020 2020 2020 2020 4164 6469 Addi │ │ │ │ │ +00010330: 6e67 206e 6577 2072 756c 6573 206f 7220 ng new rules or │ │ │ │ │ +00010340: 6f76 6572 7269 6469 6e67 2065 7869 7374 overriding exist │ │ │ │ │ +00010350: 696e 6720 6f6e 6573 2e0a 2a20 5468 6972 ing ones..* Thir │ │ │ │ │ +00010360: 642d 5061 7274 7920 4d61 6b65 6669 6c65 d-Party Makefile │ │ │ │ │ +00010370: 733a 3a20 2020 2020 2020 496e 7465 6772 s:: Integr │ │ │ │ │ +00010380: 6174 696e 6720 4e6f 6e2d 4175 746f 6d61 ating Non-Automa │ │ │ │ │ +00010390: 6b65 2027 4d61 6b65 6669 6c65 2773 2e0a ke 'Makefile's.. │ │ │ │ │ +000103a0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +000103b0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +000103c0: 6465 3a20 4578 7465 6e64 696e 672c 2020 de: Extending, │ │ │ │ │ +000103d0: 4e65 7874 3a20 5468 6972 642d 5061 7274 Next: Third-Part │ │ │ │ │ +000103e0: 7920 4d61 6b65 6669 6c65 732c 2020 5570 y Makefiles, Up │ │ │ │ │ +000103f0: 3a20 4e6f 7420 456e 6f75 6768 0a0a 3234 : Not Enough..24 │ │ │ │ │ +00010400: 2e31 2045 7874 656e 6469 6e67 2041 7574 .1 Extending Aut │ │ │ │ │ +00010410: 6f6d 616b 6520 5275 6c65 730a 3d3d 3d3d omake Rules.==== │ │ │ │ │ 00010420: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00010430: 3d3d 3d3d 3d3d 3d3d 0a0a 5769 7468 2073 ========..With s │ │ │ │ │ -00010440: 6f6d 6520 6d69 6e6f 7220 6578 6365 7074 ome minor except │ │ │ │ │ -00010450: 696f 6e73 2028 666f 7220 6578 616d 706c ions (for exampl │ │ │ │ │ -00010460: 6520 275f 5052 4f47 5241 4d53 2720 7661 e '_PROGRAMS' va │ │ │ │ │ -00010470: 7269 6162 6c65 732c 2027 5445 5354 5327 riables, 'TESTS' │ │ │ │ │ -00010480: 2c0a 6f72 2027 5846 4149 4c5f 5445 5354 ,.or 'XFAIL_TEST │ │ │ │ │ -00010490: 5327 2920 6265 696e 6720 7265 7772 6974 S') being rewrit │ │ │ │ │ -000104a0: 7465 6e20 746f 2061 7070 656e 6420 2724 ten to append '$ │ │ │ │ │ -000104b0: 2845 5845 4558 5429 2729 2c20 7468 6520 (EXEEXT)'), the │ │ │ │ │ -000104c0: 636f 6e74 656e 7473 0a6f 6620 6120 274d contents.of a 'M │ │ │ │ │ -000104d0: 616b 6566 696c 652e 616d 2720 6973 2063 akefile.am' is c │ │ │ │ │ -000104e0: 6f70 6965 6420 746f 2027 4d61 6b65 6669 opied to 'Makefi │ │ │ │ │ -000104f0: 6c65 2e69 6e27 2076 6572 6261 7469 6d2e le.in' verbatim. │ │ │ │ │ -00010500: 0a0a 2020 2054 6865 7365 2063 6f70 7969 .. These copyi │ │ │ │ │ -00010510: 6e67 2073 656d 616e 7469 6373 206d 6561 ng semantics mea │ │ │ │ │ -00010520: 6e20 7468 6174 206d 616e 7920 7072 6f62 n that many prob │ │ │ │ │ -00010530: 6c65 6d73 2063 616e 2062 6520 776f 726b lems can be work │ │ │ │ │ -00010540: 6564 2061 726f 756e 640a 6279 2073 696d ed around.by sim │ │ │ │ │ -00010550: 706c 7920 6164 6469 6e67 2073 6f6d 6520 ply adding some │ │ │ │ │ -00010560: 276d 616b 6527 2076 6172 6961 626c 6573 'make' variables │ │ │ │ │ -00010570: 2061 6e64 2072 756c 6573 2074 6f20 274d and rules to 'M │ │ │ │ │ -00010580: 616b 6566 696c 652e 616d 272e 0a41 7574 akefile.am'..Aut │ │ │ │ │ -00010590: 6f6d 616b 6520 7769 6c6c 2069 676e 6f72 omake will ignor │ │ │ │ │ -000105a0: 6520 7468 6573 6520 6164 6469 7469 6f6e e these addition │ │ │ │ │ -000105b0: 732e 0a0a 2020 2053 696e 6365 2061 2027 s... Since a ' │ │ │ │ │ -000105c0: 4d61 6b65 6669 6c65 2e69 6e27 2069 7320 Makefile.in' is │ │ │ │ │ -000105d0: 6275 696c 7420 6672 6f6d 2064 6174 6120 built from data │ │ │ │ │ -000105e0: 6761 7468 6572 6564 2066 726f 6d20 7468 gathered from th │ │ │ │ │ -000105f0: 7265 650a 6469 6666 6572 656e 7420 706c ree.different pl │ │ │ │ │ -00010600: 6163 6573 2028 274d 616b 6566 696c 652e aces ('Makefile. │ │ │ │ │ -00010610: 616d 272c 2027 636f 6e66 6967 7572 652e am', 'configure. │ │ │ │ │ -00010620: 6163 272c 2061 6e64 2027 6175 746f 6d61 ac', and 'automa │ │ │ │ │ -00010630: 6b65 2720 6974 7365 6c66 292c 0a69 7420 ke' itself),.it │ │ │ │ │ -00010640: 6973 2070 6f73 7369 626c 6520 746f 2068 is possible to h │ │ │ │ │ -00010650: 6176 6520 636f 6e66 6c69 6374 696e 6720 ave conflicting │ │ │ │ │ -00010660: 6465 6669 6e69 7469 6f6e 7320 6f66 2072 definitions of r │ │ │ │ │ -00010670: 756c 6573 206f 7220 7661 7269 6162 6c65 ules or variable │ │ │ │ │ -00010680: 732e 0a57 6865 6e20 6275 696c 6469 6e67 s..When building │ │ │ │ │ -00010690: 2027 4d61 6b65 6669 6c65 2e69 6e27 2074 'Makefile.in' t │ │ │ │ │ -000106a0: 6865 2066 6f6c 6c6f 7769 6e67 2070 7269 he following pri │ │ │ │ │ -000106b0: 6f72 6974 6965 7320 6172 6520 7265 7370 orities are resp │ │ │ │ │ -000106c0: 6563 7465 6420 6279 0a27 6175 746f 6d61 ected by.'automa │ │ │ │ │ -000106d0: 6b65 2720 746f 2065 6e73 7572 6520 7468 ke' to ensure th │ │ │ │ │ -000106e0: 6520 7573 6572 2061 6c77 6179 7320 6861 e user always ha │ │ │ │ │ -000106f0: 7320 7468 6520 6c61 7374 2077 6f72 643a s the last word: │ │ │ │ │ -00010700: 0a0a 2020 202a 2055 7365 7220 6465 6669 .. * User defi │ │ │ │ │ -00010710: 6e65 6420 7661 7269 6162 6c65 7320 696e ned variables in │ │ │ │ │ -00010720: 2027 4d61 6b65 6669 6c65 2e61 6d27 2068 'Makefile.am' h │ │ │ │ │ -00010730: 6176 6520 7072 696f 7269 7479 206f 7665 ave priority ove │ │ │ │ │ -00010740: 720a 2020 2020 2076 6172 6961 626c 6573 r. variables │ │ │ │ │ -00010750: 2027 4143 5f53 5542 5354 2765 6420 6672 'AC_SUBST'ed fr │ │ │ │ │ -00010760: 6f6d 2027 636f 6e66 6967 7572 652e 6163 om 'configure.ac │ │ │ │ │ -00010770: 272c 2061 6e64 2027 4143 5f53 5542 5354 ', and 'AC_SUBST │ │ │ │ │ -00010780: 2765 640a 2020 2020 2076 6172 6961 626c 'ed. variabl │ │ │ │ │ -00010790: 6573 2068 6176 6520 7072 696f 7269 7479 es have priority │ │ │ │ │ -000107a0: 206f 7665 7220 2761 7574 6f6d 616b 6527 over 'automake' │ │ │ │ │ -000107b0: 2d64 6566 696e 6564 2076 6172 6961 626c -defined variabl │ │ │ │ │ -000107c0: 6573 2e0a 2020 202a 2041 7320 6661 7220 es.. * As far │ │ │ │ │ -000107d0: 6173 2072 756c 6573 2061 7265 2063 6f6e as rules are con │ │ │ │ │ -000107e0: 6365 726e 6564 2c20 6120 7573 6572 2d64 cerned, a user-d │ │ │ │ │ -000107f0: 6566 696e 6564 2072 756c 6520 6f76 6572 efined rule over │ │ │ │ │ -00010800: 7269 6465 7320 616e 790a 2020 2020 2027 rides any. ' │ │ │ │ │ -00010810: 6175 746f 6d61 6b65 272d 6465 6669 6e65 automake'-define │ │ │ │ │ -00010820: 6420 7275 6c65 2066 6f72 2074 6865 2073 d rule for the s │ │ │ │ │ -00010830: 616d 6520 7461 7267 6574 2e0a 0a20 2020 ame target... │ │ │ │ │ -00010840: 5468 6573 6520 6f76 6572 7269 6469 6e67 These overriding │ │ │ │ │ -00010850: 2073 656d 616e 7469 6373 206d 616b 6520 semantics make │ │ │ │ │ -00010860: 6974 2070 6f73 7369 626c 6520 746f 2066 it possible to f │ │ │ │ │ -00010870: 696e 6520 7475 6e65 2073 6f6d 6520 6465 ine tune some de │ │ │ │ │ -00010880: 6661 756c 740a 7365 7474 696e 6773 206f fault.settings o │ │ │ │ │ -00010890: 6620 4175 746f 6d61 6b65 2c20 6f72 2072 f Automake, or r │ │ │ │ │ -000108a0: 6570 6c61 6365 2073 6f6d 6520 6f66 2069 eplace some of i │ │ │ │ │ -000108b0: 7473 2072 756c 6573 2e20 204f 7665 7272 ts rules. Overr │ │ │ │ │ -000108c0: 6964 696e 6720 4175 746f 6d61 6b65 0a72 iding Automake.r │ │ │ │ │ -000108d0: 756c 6573 2069 7320 6f66 7465 6e20 696e ules is often in │ │ │ │ │ -000108e0: 6164 7669 7361 626c 652c 2070 6172 7469 advisable, parti │ │ │ │ │ -000108f0: 6375 6c61 726c 7920 696e 2074 6865 2074 cularly in the t │ │ │ │ │ -00010900: 6f70 6d6f 7374 2064 6972 6563 746f 7279 opmost directory │ │ │ │ │ -00010910: 206f 6620 610a 7061 636b 6167 6520 7769 of a.package wi │ │ │ │ │ -00010920: 7468 2073 7562 6469 7265 6374 6f72 6965 th subdirectorie │ │ │ │ │ -00010930: 732e 2020 5468 6520 272d 576f 7665 7272 s. The '-Woverr │ │ │ │ │ -00010940: 6964 6527 206f 7074 696f 6e20 282a 6e6f ide' option (*no │ │ │ │ │ -00010950: 7465 2061 7574 6f6d 616b 650a 496e 766f te automake.Invo │ │ │ │ │ -00010960: 6361 7469 6f6e 3a3a 2920 636f 6d65 7320 cation::) comes │ │ │ │ │ -00010970: 696e 2068 616e 6479 2074 6f20 6361 7463 in handy to catc │ │ │ │ │ -00010980: 6820 6f76 6572 7269 6464 656e 2064 6566 h overridden def │ │ │ │ │ -00010990: 696e 6974 696f 6e73 2e0a 0a20 2020 4e6f initions... No │ │ │ │ │ -000109a0: 7465 2074 6861 7420 4175 746f 6d61 6b65 te that Automake │ │ │ │ │ -000109b0: 2064 6f65 7320 6e6f 7420 6d61 6b65 2061 does not make a │ │ │ │ │ -000109c0: 6e79 2064 6973 7469 6e63 7469 6f6e 2062 ny distinction b │ │ │ │ │ -000109d0: 6574 7765 656e 2072 756c 6573 2077 6974 etween rules wit │ │ │ │ │ -000109e0: 680a 636f 6d6d 616e 6473 2061 6e64 2072 h.commands and r │ │ │ │ │ -000109f0: 756c 6573 2074 6861 7420 6f6e 6c79 2073 ules that only s │ │ │ │ │ -00010a00: 7065 6369 6679 2064 6570 656e 6465 6e63 pecify dependenc │ │ │ │ │ -00010a10: 6965 732e 2020 536f 2069 7420 6973 206e ies. So it is n │ │ │ │ │ -00010a20: 6f74 0a70 6f73 7369 626c 6520 746f 2061 ot.possible to a │ │ │ │ │ -00010a30: 7070 656e 6420 6e65 7720 6465 7065 6e64 ppend new depend │ │ │ │ │ -00010a40: 656e 6369 6573 2074 6f20 616e 2027 6175 encies to an 'au │ │ │ │ │ -00010a50: 746f 6d61 6b65 272d 6465 6669 6e65 6420 tomake'-defined │ │ │ │ │ -00010a60: 7461 7267 6574 0a77 6974 686f 7574 2072 target.without r │ │ │ │ │ -00010a70: 6564 6566 696e 696e 6720 7468 6520 656e edefining the en │ │ │ │ │ -00010a80: 7469 7265 2072 756c 652e 0a0a 2020 2048 tire rule... H │ │ │ │ │ -00010a90: 6f77 6576 6572 2c20 7661 7269 6f75 7320 owever, various │ │ │ │ │ -00010aa0: 7573 6566 756c 2074 6172 6765 7473 2068 useful targets h │ │ │ │ │ -00010ab0: 6176 6520 6120 272d 6c6f 6361 6c27 2076 ave a '-local' v │ │ │ │ │ -00010ac0: 6572 7369 6f6e 2079 6f75 2063 616e 0a73 ersion you can.s │ │ │ │ │ -00010ad0: 7065 6369 6679 2069 6e20 796f 7572 2027 pecify in your ' │ │ │ │ │ -00010ae0: 4d61 6b65 6669 6c65 2e61 6d27 2e20 2041 Makefile.am'. A │ │ │ │ │ -00010af0: 7574 6f6d 616b 6520 7769 6c6c 2073 7570 utomake will sup │ │ │ │ │ -00010b00: 706c 656d 656e 7420 7468 6520 7374 616e plement the stan │ │ │ │ │ -00010b10: 6461 7264 0a74 6172 6765 7420 7769 7468 dard.target with │ │ │ │ │ -00010b20: 2074 6865 7365 2075 7365 722d 7375 7070 these user-supp │ │ │ │ │ -00010b30: 6c69 6564 2074 6172 6765 7473 2e0a 0a20 lied targets... │ │ │ │ │ -00010b40: 2020 5468 6520 7461 7267 6574 7320 7468 The targets th │ │ │ │ │ -00010b50: 6174 2073 7570 706f 7274 2061 206c 6f63 at support a loc │ │ │ │ │ -00010b60: 616c 2076 6572 7369 6f6e 2061 7265 2027 al version are ' │ │ │ │ │ -00010b70: 616c 6c27 2c20 2769 6e66 6f27 2c20 2764 all', 'info', 'd │ │ │ │ │ -00010b80: 7669 272c 0a27 7073 272c 2027 7064 6627 vi',.'ps', 'pdf' │ │ │ │ │ -00010b90: 2c20 2768 746d 6c27 2c20 2763 6865 636b , 'html', 'check │ │ │ │ │ -00010ba0: 272c 2027 696e 7374 616c 6c2d 6461 7461 ', 'install-data │ │ │ │ │ -00010bb0: 272c 2027 696e 7374 616c 6c2d 6476 6927 ', 'install-dvi' │ │ │ │ │ -00010bc0: 2c0a 2769 6e73 7461 6c6c 2d65 7865 6327 ,.'install-exec' │ │ │ │ │ -00010bd0: 2c20 2769 6e73 7461 6c6c 2d68 746d 6c27 , 'install-html' │ │ │ │ │ -00010be0: 2c20 2769 6e73 7461 6c6c 2d69 6e66 6f27 , 'install-info' │ │ │ │ │ -00010bf0: 2c20 2769 6e73 7461 6c6c 2d70 6466 272c , 'install-pdf', │ │ │ │ │ -00010c00: 0a27 696e 7374 616c 6c2d 7073 272c 2027 .'install-ps', ' │ │ │ │ │ -00010c10: 756e 696e 7374 616c 6c27 2c20 2769 6e73 uninstall', 'ins │ │ │ │ │ -00010c20: 7461 6c6c 6469 7273 272c 2027 696e 7374 talldirs', 'inst │ │ │ │ │ -00010c30: 616c 6c63 6865 636b 2720 616e 6420 7468 allcheck' and th │ │ │ │ │ -00010c40: 6520 7661 7269 6f75 730a 2763 6c65 616e e various.'clean │ │ │ │ │ -00010c50: 2720 7461 7267 6574 7320 2827 6d6f 7374 ' targets ('most │ │ │ │ │ -00010c60: 6c79 636c 6561 6e27 2c20 2763 6c65 616e lyclean', 'clean │ │ │ │ │ -00010c70: 272c 2027 6469 7374 636c 6561 6e27 2c20 ', 'distclean', │ │ │ │ │ -00010c80: 616e 640a 276d 6169 6e74 6169 6e65 722d and.'maintainer- │ │ │ │ │ -00010c90: 636c 6561 6e27 292e 0a0a 2020 204e 6f74 clean')... Not │ │ │ │ │ -00010ca0: 6520 7468 6174 2074 6865 7265 2061 7265 e that there are │ │ │ │ │ -00010cb0: 206e 6f20 2775 6e69 6e73 7461 6c6c 2d65 no 'uninstall-e │ │ │ │ │ -00010cc0: 7865 632d 6c6f 6361 6c27 206f 720a 2775 xec-local' or.'u │ │ │ │ │ -00010cd0: 6e69 6e73 7461 6c6c 2d64 6174 612d 6c6f ninstall-data-lo │ │ │ │ │ -00010ce0: 6361 6c27 2074 6172 6765 7473 3b20 6a75 cal' targets; ju │ │ │ │ │ -00010cf0: 7374 2075 7365 2027 756e 696e 7374 616c st use 'uninstal │ │ │ │ │ -00010d00: 6c2d 6c6f 6361 6c27 2e20 2049 7420 646f l-local'. It do │ │ │ │ │ -00010d10: 6573 6e27 740a 6d61 6b65 2073 656e 7365 esn't.make sense │ │ │ │ │ -00010d20: 2074 6f20 756e 696e 7374 616c 6c20 6a75 to uninstall ju │ │ │ │ │ -00010d30: 7374 2064 6174 6120 6f72 206a 7573 7420 st data or just │ │ │ │ │ -00010d40: 6578 6563 7574 6162 6c65 732e 0a0a 2020 executables... │ │ │ │ │ -00010d50: 2046 6f72 2069 6e73 7461 6e63 652c 2068 For instance, h │ │ │ │ │ -00010d60: 6572 6520 6973 206f 6e65 2077 6179 2074 ere is one way t │ │ │ │ │ -00010d70: 6f20 6572 6173 6520 6120 7375 6264 6972 o erase a subdir │ │ │ │ │ -00010d80: 6563 746f 7279 2064 7572 696e 6720 276d ectory during 'm │ │ │ │ │ -00010d90: 616b 650a 636c 6561 6e27 2028 2a6e 6f74 ake.clean' (*not │ │ │ │ │ -00010da0: 6520 436c 6561 6e3a 3a29 2e0a 0a20 2020 e Clean::)... │ │ │ │ │ -00010db0: 2020 636c 6561 6e2d 6c6f 6361 6c3a 0a20 clean-local:. │ │ │ │ │ -00010dc0: 2020 2020 2020 2020 2020 2020 2d72 6d20 -rm │ │ │ │ │ -00010dd0: 2d72 6620 7465 7374 5375 6244 6972 0a0a -rf testSubDir.. │ │ │ │ │ -00010de0: 2020 2059 6f75 206d 6179 2062 6520 7465 You may be te │ │ │ │ │ -00010df0: 6d70 7465 6420 746f 2075 7365 2027 696e mpted to use 'in │ │ │ │ │ -00010e00: 7374 616c 6c2d 6461 7461 2d6c 6f63 616c stall-data-local │ │ │ │ │ -00010e10: 2720 746f 2069 6e73 7461 6c6c 2061 2066 ' to install a f │ │ │ │ │ -00010e20: 696c 6520 746f 0a73 6f6d 6520 6861 7264 ile to.some hard │ │ │ │ │ -00010e30: 2d63 6f64 6564 206c 6f63 6174 696f 6e2c -coded location, │ │ │ │ │ -00010e40: 2062 7574 2079 6f75 2073 686f 756c 6420 but you should │ │ │ │ │ -00010e50: 6176 6f69 6420 7468 6973 2028 2a6e 6f74 avoid this (*not │ │ │ │ │ -00010e60: 6520 4861 7264 2d43 6f64 6564 0a49 6e73 e Hard-Coded.Ins │ │ │ │ │ -00010e70: 7461 6c6c 2050 6174 6873 3a3a 292e 0a0a tall Paths::)... │ │ │ │ │ -00010e80: 2020 2057 6974 6820 7468 6520 272d 6c6f With the '-lo │ │ │ │ │ -00010e90: 6361 6c27 2074 6172 6765 7473 2c20 7468 cal' targets, th │ │ │ │ │ -00010ea0: 6572 6520 6973 206e 6f20 7061 7274 6963 ere is no partic │ │ │ │ │ -00010eb0: 756c 6172 2067 7561 7261 6e74 6565 206f ular guarantee o │ │ │ │ │ -00010ec0: 660a 6578 6563 7574 696f 6e20 6f72 6465 f.execution orde │ │ │ │ │ -00010ed0: 723b 2074 7970 6963 616c 6c79 2c20 7468 r; typically, th │ │ │ │ │ -00010ee0: 6579 2061 7265 2072 756e 2065 6172 6c79 ey are run early │ │ │ │ │ -00010ef0: 2c20 6275 7420 7769 7468 2070 6172 616c , but with paral │ │ │ │ │ -00010f00: 6c65 6c20 6d61 6b65 2c0a 7468 6572 6520 lel make,.there │ │ │ │ │ -00010f10: 6973 206e 6f20 7761 7920 746f 2062 6520 is no way to be │ │ │ │ │ -00010f20: 7375 7265 206f 6620 7468 6174 2e0a 0a20 sure of that... │ │ │ │ │ -00010f30: 2020 496e 2063 6f6e 7472 6173 742c 2073 In contrast, s │ │ │ │ │ -00010f40: 6f6d 6520 7275 6c65 7320 616c 736f 2068 ome rules also h │ │ │ │ │ -00010f50: 6176 6520 6120 7761 7920 746f 2072 756e ave a way to run │ │ │ │ │ -00010f60: 2061 6e6f 7468 6572 2072 756c 652c 2063 another rule, c │ │ │ │ │ -00010f70: 616c 6c65 6420 610a 2268 6f6f 6b22 3b20 alled a."hook"; │ │ │ │ │ -00010f80: 686f 6f6b 7320 6172 6520 616c 7761 7973 hooks are always │ │ │ │ │ -00010f90: 2065 7865 6375 7465 6420 6166 7465 7220 executed after │ │ │ │ │ -00010fa0: 7468 6520 6d61 696e 2072 756c 6527 7320 the main rule's │ │ │ │ │ -00010fb0: 776f 726b 2069 7320 646f 6e65 2e0a 5468 work is done..Th │ │ │ │ │ -00010fc0: 6520 686f 6f6b 2069 7320 6e61 6d65 6420 e hook is named │ │ │ │ │ -00010fd0: 6166 7465 7220 7468 6520 7072 696e 6369 after the princi │ │ │ │ │ -00010fe0: 7061 6c20 7461 7267 6574 2c20 7769 7468 pal target, with │ │ │ │ │ -00010ff0: 2027 2d68 6f6f 6b27 2061 7070 656e 6465 '-hook' appende │ │ │ │ │ -00011000: 642e 0a54 6865 2074 6172 6765 7473 2061 d..The targets a │ │ │ │ │ -00011010: 6c6c 6f77 696e 6720 686f 6f6b 7320 6172 llowing hooks ar │ │ │ │ │ -00011020: 6520 2769 6e73 7461 6c6c 2d64 6174 6127 e 'install-data' │ │ │ │ │ -00011030: 2c20 2769 6e73 7461 6c6c 2d65 7865 6327 , 'install-exec' │ │ │ │ │ -00011040: 2c0a 2775 6e69 6e73 7461 6c6c 272c 2027 ,.'uninstall', ' │ │ │ │ │ -00011050: 6469 7374 272c 2061 6e64 2027 6469 7374 dist', and 'dist │ │ │ │ │ -00011060: 6368 6563 6b27 2e0a 0a20 2020 466f 7220 check'... For │ │ │ │ │ -00011070: 696e 7374 616e 6365 2c20 6865 7265 2069 instance, here i │ │ │ │ │ -00011080: 7320 686f 7720 746f 2063 7265 6174 6520 s how to create │ │ │ │ │ -00011090: 6120 6861 7264 206c 696e 6b20 746f 2061 a hard link to a │ │ │ │ │ -000110a0: 6e20 696e 7374 616c 6c65 640a 7072 6f67 n installed.prog │ │ │ │ │ -000110b0: 7261 6d3a 0a0a 2020 2020 2069 6e73 7461 ram:.. insta │ │ │ │ │ -000110c0: 6c6c 2d65 7865 632d 686f 6f6b 3a0a 2020 ll-exec-hook:. │ │ │ │ │ -000110d0: 2020 2020 2020 2020 2020 206c 6e20 2428 ln $( │ │ │ │ │ -000110e0: 4445 5354 4449 5229 2428 6269 6e64 6972 DESTDIR)$(bindir │ │ │ │ │ -000110f0: 292f 7072 6f67 7261 6d24 2845 5845 4558 )/program$(EXEEX │ │ │ │ │ -00011100: 5429 205c 0a20 2020 2020 2020 2020 2020 T) \. │ │ │ │ │ -00011110: 2020 2020 2024 2844 4553 5444 4952 2924 $(DESTDIR)$ │ │ │ │ │ -00011120: 2862 696e 6469 7229 2f70 726f 676c 696e (bindir)/proglin │ │ │ │ │ -00011130: 6b24 2845 5845 4558 5429 0a0a 2020 2041 k$(EXEEXT).. A │ │ │ │ │ -00011140: 6c74 686f 7567 6820 6368 6561 7065 7220 lthough cheaper │ │ │ │ │ -00011150: 616e 6420 6d6f 7265 2070 6f72 7461 626c and more portabl │ │ │ │ │ -00011160: 6520 7468 616e 2073 796d 626f 6c69 6320 e than symbolic │ │ │ │ │ -00011170: 6c69 6e6b 732c 2068 6172 6420 6c69 6e6b links, hard link │ │ │ │ │ -00011180: 730a 7769 6c6c 206e 6f74 2077 6f72 6b20 s.will not work │ │ │ │ │ -00011190: 6576 6572 7977 6865 7265 2028 666f 7220 everywhere (for │ │ │ │ │ -000111a0: 696e 7374 616e 6365 2c20 4f53 2f32 2064 instance, OS/2 d │ │ │ │ │ -000111b0: 6f65 7320 6e6f 7420 6861 7665 2027 6c6e oes not have 'ln │ │ │ │ │ -000111c0: 2729 2e0a 4964 6561 6c6c 7920 796f 7520 ')..Ideally you │ │ │ │ │ -000111d0: 7368 6f75 6c64 2066 616c 6c20 6261 636b should fall back │ │ │ │ │ -000111e0: 2074 6f20 2763 7020 2d70 2720 7768 656e to 'cp -p' when │ │ │ │ │ -000111f0: 2027 6c6e 2720 646f 6573 206e 6f74 2077 'ln' does not w │ │ │ │ │ -00011200: 6f72 6b2e 2020 416e 0a65 6173 7920 7761 ork. An.easy wa │ │ │ │ │ -00011210: 792c 2069 6620 7379 6d62 6f6c 6963 206c y, if symbolic l │ │ │ │ │ -00011220: 696e 6b73 2061 7265 2061 6363 6570 7461 inks are accepta │ │ │ │ │ -00011230: 626c 6520 746f 2079 6f75 2c20 6973 2074 ble to you, is t │ │ │ │ │ -00011240: 6f20 6164 640a 2741 435f 5052 4f47 5f4c o add.'AC_PROG_L │ │ │ │ │ -00011250: 4e5f 5327 2074 6f20 2763 6f6e 6669 6775 N_S' to 'configu │ │ │ │ │ -00011260: 7265 2e61 6327 2028 2a6e 6f74 6520 5061 re.ac' (*note Pa │ │ │ │ │ -00011270: 7274 6963 756c 6172 2050 726f 6772 616d rticular Program │ │ │ │ │ -00011280: 2043 6865 636b 733a 0a28 6175 746f 636f Checks:.(autoco │ │ │ │ │ -00011290: 6e66 2950 6172 7469 6375 6c61 7220 5072 nf)Particular Pr │ │ │ │ │ -000112a0: 6f67 7261 6d73 2e29 2061 6e64 2075 7365 ograms.) and use │ │ │ │ │ -000112b0: 2027 2428 4c4e 5f53 2927 2069 6e20 274d '$(LN_S)' in 'M │ │ │ │ │ -000112c0: 616b 6566 696c 652e 616d 272e 0a0a 2020 akefile.am'... │ │ │ │ │ -000112d0: 2046 6f72 2069 6e73 7461 6e63 652c 2068 For instance, h │ │ │ │ │ -000112e0: 6572 6520 6973 2068 6f77 2079 6f75 2063 ere is how you c │ │ │ │ │ -000112f0: 6f75 6c64 2069 6e73 7461 6c6c 2061 2076 ould install a v │ │ │ │ │ -00011300: 6572 7369 6f6e 6564 2063 6f70 7920 6f66 ersioned copy of │ │ │ │ │ -00011310: 2061 0a70 726f 6772 616d 2075 7369 6e67 a.program using │ │ │ │ │ -00011320: 2027 2428 4c4e 5f53 2927 3a0a 0a20 2020 '$(LN_S)':.. │ │ │ │ │ -00011330: 2020 696e 7374 616c 6c2d 6578 6563 2d68 install-exec-h │ │ │ │ │ -00011340: 6f6f 6b3a 0a20 2020 2020 2020 2020 2020 ook:. │ │ │ │ │ -00011350: 2020 6364 2024 2844 4553 5444 4952 2924 cd $(DESTDIR)$ │ │ │ │ │ -00011360: 2862 696e 6469 7229 2026 2620 5c0a 2020 (bindir) && \. │ │ │ │ │ -00011370: 2020 2020 2020 2020 2020 2020 206d 7620 mv │ │ │ │ │ -00011380: 2d66 2070 726f 6724 2845 5845 4558 5429 -f prog$(EXEEXT) │ │ │ │ │ -00011390: 2070 726f 672d 2428 5645 5253 494f 4e29 prog-$(VERSION) │ │ │ │ │ -000113a0: 2428 4558 4545 5854 2920 2626 205c 0a20 $(EXEEXT) && \. │ │ │ │ │ -000113b0: 2020 2020 2020 2020 2020 2020 2020 2428 $( │ │ │ │ │ -000113c0: 4c4e 5f53 2920 7072 6f67 2d24 2856 4552 LN_S) prog-$(VER │ │ │ │ │ -000113d0: 5349 4f4e 2924 2845 5845 4558 5429 2070 SION)$(EXEEXT) p │ │ │ │ │ -000113e0: 726f 6724 2845 5845 4558 5429 0a0a 2020 rog$(EXEEXT).. │ │ │ │ │ -000113f0: 204e 6f74 6520 7468 6174 2077 6520 7265 Note that we re │ │ │ │ │ -00011400: 6e61 6d65 2074 6865 2070 726f 6772 616d name the program │ │ │ │ │ -00011410: 2073 6f20 7468 6174 2061 206e 6577 2076 so that a new v │ │ │ │ │ -00011420: 6572 7369 6f6e 2077 696c 6c20 6572 6173 ersion will eras │ │ │ │ │ -00011430: 6520 7468 650a 7379 6d62 6f6c 6963 206c e the.symbolic l │ │ │ │ │ -00011440: 696e 6b2c 206e 6f74 2074 6865 2072 6561 ink, not the rea │ │ │ │ │ -00011450: 6c20 6269 6e61 7279 2e20 2041 6c73 6f20 l binary. Also │ │ │ │ │ -00011460: 7765 2027 6364 2720 696e 746f 2074 6865 we 'cd' into the │ │ │ │ │ -00011470: 2064 6573 7469 6e61 7469 6f6e 0a64 6972 destination.dir │ │ │ │ │ -00011480: 6563 746f 7279 2069 6e20 6f72 6465 7220 ectory in order │ │ │ │ │ -00011490: 746f 2063 7265 6174 6520 7265 6c61 7469 to create relati │ │ │ │ │ -000114a0: 7665 206c 696e 6b73 2e0a 0a20 2020 5768 ve links... Wh │ │ │ │ │ -000114b0: 656e 2077 7269 7469 6e67 2027 696e 7374 en writing 'inst │ │ │ │ │ -000114c0: 616c 6c2d 6578 6563 2d68 6f6f 6b27 206f all-exec-hook' o │ │ │ │ │ -000114d0: 7220 2769 6e73 7461 6c6c 2d64 6174 612d r 'install-data- │ │ │ │ │ -000114e0: 686f 6f6b 272c 2070 6c65 6173 6520 6265 hook', please be │ │ │ │ │ -000114f0: 6172 0a69 6e20 6d69 6e64 2074 6861 7420 ar.in mind that │ │ │ │ │ -00011500: 7468 6520 6578 6563 2f64 6174 6120 6469 the exec/data di │ │ │ │ │ -00011510: 7374 696e 6374 696f 6e20 6973 2062 6173 stinction is bas │ │ │ │ │ -00011520: 6564 206f 6e20 7468 6520 696e 7374 616c ed on the instal │ │ │ │ │ -00011530: 6c61 7469 6f6e 0a64 6972 6563 746f 7279 lation.directory │ │ │ │ │ -00011540: 2c20 6e6f 7420 6f6e 2074 6865 2070 7269 , not on the pri │ │ │ │ │ -00011550: 6d61 7279 2075 7365 6420 282a 6e6f 7465 mary used (*note │ │ │ │ │ -00011560: 2054 6865 2054 776f 2050 6172 7473 206f The Two Parts o │ │ │ │ │ -00011570: 6620 496e 7374 616c 6c3a 3a29 2e0a 536f f Install::)..So │ │ │ │ │ -00011580: 2061 2027 666f 6f5f 5343 5249 5054 5327 a 'foo_SCRIPTS' │ │ │ │ │ -00011590: 2077 696c 6c20 6265 2069 6e73 7461 6c6c will be install │ │ │ │ │ -000115a0: 6564 2062 7920 2769 6e73 7461 6c6c 2d64 ed by 'install-d │ │ │ │ │ -000115b0: 6174 6127 2c20 616e 6420 610a 2762 6172 ata', and a.'bar │ │ │ │ │ -000115c0: 6578 6563 5f53 4352 4950 5453 2720 7769 exec_SCRIPTS' wi │ │ │ │ │ -000115d0: 6c6c 2062 6520 696e 7374 616c 6c65 6420 ll be installed │ │ │ │ │ -000115e0: 6279 2027 696e 7374 616c 6c2d 6578 6563 by 'install-exec │ │ │ │ │ -000115f0: 272e 2020 596f 7520 7368 6f75 6c64 0a64 '. You should.d │ │ │ │ │ -00011600: 6566 696e 6520 796f 7572 2068 6f6f 6b73 efine your hooks │ │ │ │ │ -00011610: 2063 6f6e 7365 7175 656e 746c 792e 0a0a consequently... │ │ │ │ │ -00011620: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -00011630: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -00011640: 653a 2054 6869 7264 2d50 6172 7479 204d e: Third-Party M │ │ │ │ │ -00011650: 616b 6566 696c 6573 2c20 2050 7265 763a akefiles, Prev: │ │ │ │ │ -00011660: 2045 7874 656e 6469 6e67 2c20 2055 703a Extending, Up: │ │ │ │ │ -00011670: 204e 6f74 2045 6e6f 7567 680a 0a32 342e Not Enough..24. │ │ │ │ │ -00011680: 3220 5468 6972 642d 5061 7274 7920 274d 2 Third-Party 'M │ │ │ │ │ -00011690: 616b 6566 696c 6527 730a 3d3d 3d3d 3d3d akefile's.====== │ │ │ │ │ +00010430: 3d3d 3d3d 3d3d 3d3d 3d0a 0a57 6974 6820 =========..With │ │ │ │ │ +00010440: 736f 6d65 206d 696e 6f72 2065 7863 6570 some minor excep │ │ │ │ │ +00010450: 7469 6f6e 7320 2866 6f72 2065 7861 6d70 tions (for examp │ │ │ │ │ +00010460: 6c65 2027 5f50 524f 4752 414d 5327 2076 le '_PROGRAMS' v │ │ │ │ │ +00010470: 6172 6961 626c 6573 2c20 2754 4553 5453 ariables, 'TESTS │ │ │ │ │ +00010480: 272c 0a6f 7220 2758 4641 494c 5f54 4553 ',.or 'XFAIL_TES │ │ │ │ │ +00010490: 5453 2729 2062 6569 6e67 2072 6577 7269 TS') being rewri │ │ │ │ │ +000104a0: 7474 656e 2074 6f20 6170 7065 6e64 2027 tten to append ' │ │ │ │ │ +000104b0: 2428 4558 4545 5854 2927 292c 2074 6865 $(EXEEXT)'), the │ │ │ │ │ +000104c0: 2063 6f6e 7465 6e74 730a 6f66 2061 2027 contents.of a ' │ │ │ │ │ +000104d0: 4d61 6b65 6669 6c65 2e61 6d27 2069 7320 Makefile.am' is │ │ │ │ │ +000104e0: 636f 7069 6564 2074 6f20 274d 616b 6566 copied to 'Makef │ │ │ │ │ +000104f0: 696c 652e 696e 2720 7665 7262 6174 696d ile.in' verbatim │ │ │ │ │ +00010500: 2e0a 0a20 2020 5468 6573 6520 636f 7079 ... These copy │ │ │ │ │ +00010510: 696e 6720 7365 6d61 6e74 6963 7320 6d65 ing semantics me │ │ │ │ │ +00010520: 616e 2074 6861 7420 6d61 6e79 2070 726f an that many pro │ │ │ │ │ +00010530: 626c 656d 7320 6361 6e20 6265 2077 6f72 blems can be wor │ │ │ │ │ +00010540: 6b65 6420 6172 6f75 6e64 0a62 7920 7369 ked around.by si │ │ │ │ │ +00010550: 6d70 6c79 2061 6464 696e 6720 736f 6d65 mply adding some │ │ │ │ │ +00010560: 2027 6d61 6b65 2720 7661 7269 6162 6c65 'make' variable │ │ │ │ │ +00010570: 7320 616e 6420 7275 6c65 7320 746f 2027 s and rules to ' │ │ │ │ │ +00010580: 4d61 6b65 6669 6c65 2e61 6d27 2e0a 4175 Makefile.am'..Au │ │ │ │ │ +00010590: 746f 6d61 6b65 2077 696c 6c20 6967 6e6f tomake will igno │ │ │ │ │ +000105a0: 7265 2074 6865 7365 2061 6464 6974 696f re these additio │ │ │ │ │ +000105b0: 6e73 2e0a 0a20 2020 5369 6e63 6520 6120 ns... Since a │ │ │ │ │ +000105c0: 274d 616b 6566 696c 652e 696e 2720 6973 'Makefile.in' is │ │ │ │ │ +000105d0: 2062 7569 6c74 2066 726f 6d20 6461 7461 built from data │ │ │ │ │ +000105e0: 2067 6174 6865 7265 6420 6672 6f6d 2074 gathered from t │ │ │ │ │ +000105f0: 6872 6565 0a64 6966 6665 7265 6e74 2070 hree.different p │ │ │ │ │ +00010600: 6c61 6365 7320 2827 4d61 6b65 6669 6c65 laces ('Makefile │ │ │ │ │ +00010610: 2e61 6d27 2c20 2763 6f6e 6669 6775 7265 .am', 'configure │ │ │ │ │ +00010620: 2e61 6327 2c20 616e 6420 2761 7574 6f6d .ac', and 'autom │ │ │ │ │ +00010630: 616b 6527 2069 7473 656c 6629 2c0a 6974 ake' itself),.it │ │ │ │ │ +00010640: 2069 7320 706f 7373 6962 6c65 2074 6f20 is possible to │ │ │ │ │ +00010650: 6861 7665 2063 6f6e 666c 6963 7469 6e67 have conflicting │ │ │ │ │ +00010660: 2064 6566 696e 6974 696f 6e73 206f 6620 definitions of │ │ │ │ │ +00010670: 7275 6c65 7320 6f72 2076 6172 6961 626c rules or variabl │ │ │ │ │ +00010680: 6573 2e0a 5768 656e 2062 7569 6c64 696e es..When buildin │ │ │ │ │ +00010690: 6720 274d 616b 6566 696c 652e 696e 2720 g 'Makefile.in' │ │ │ │ │ +000106a0: 7468 6520 666f 6c6c 6f77 696e 6720 7072 the following pr │ │ │ │ │ +000106b0: 696f 7269 7469 6573 2061 7265 2072 6573 iorities are res │ │ │ │ │ +000106c0: 7065 6374 6564 2062 790a 2761 7574 6f6d pected by.'autom │ │ │ │ │ +000106d0: 616b 6527 2074 6f20 656e 7375 7265 2074 ake' to ensure t │ │ │ │ │ +000106e0: 6865 2075 7365 7220 616c 7761 7973 2068 he user always h │ │ │ │ │ +000106f0: 6173 2074 6865 206c 6173 7420 776f 7264 as the last word │ │ │ │ │ +00010700: 3a0a 0a20 2020 2a20 5573 6572 2064 6566 :.. * User def │ │ │ │ │ +00010710: 696e 6564 2076 6172 6961 626c 6573 2069 ined variables i │ │ │ │ │ +00010720: 6e20 274d 616b 6566 696c 652e 616d 2720 n 'Makefile.am' │ │ │ │ │ +00010730: 6861 7665 2070 7269 6f72 6974 7920 6f76 have priority ov │ │ │ │ │ +00010740: 6572 0a20 2020 2020 7661 7269 6162 6c65 er. variable │ │ │ │ │ +00010750: 7320 2741 435f 5355 4253 5427 6564 2066 s 'AC_SUBST'ed f │ │ │ │ │ +00010760: 726f 6d20 2763 6f6e 6669 6775 7265 2e61 rom 'configure.a │ │ │ │ │ +00010770: 6327 2c20 616e 6420 2741 435f 5355 4253 c', and 'AC_SUBS │ │ │ │ │ +00010780: 5427 6564 0a20 2020 2020 7661 7269 6162 T'ed. variab │ │ │ │ │ +00010790: 6c65 7320 6861 7665 2070 7269 6f72 6974 les have priorit │ │ │ │ │ +000107a0: 7920 6f76 6572 2027 6175 746f 6d61 6b65 y over 'automake │ │ │ │ │ +000107b0: 272d 6465 6669 6e65 6420 7661 7269 6162 '-defined variab │ │ │ │ │ +000107c0: 6c65 732e 0a20 2020 2a20 4173 2066 6172 les.. * As far │ │ │ │ │ +000107d0: 2061 7320 7275 6c65 7320 6172 6520 636f as rules are co │ │ │ │ │ +000107e0: 6e63 6572 6e65 642c 2061 2075 7365 722d ncerned, a user- │ │ │ │ │ +000107f0: 6465 6669 6e65 6420 7275 6c65 206f 7665 defined rule ove │ │ │ │ │ +00010800: 7272 6964 6573 2061 6e79 0a20 2020 2020 rrides any. │ │ │ │ │ +00010810: 2761 7574 6f6d 616b 6527 2d64 6566 696e 'automake'-defin │ │ │ │ │ +00010820: 6564 2072 756c 6520 666f 7220 7468 6520 ed rule for the │ │ │ │ │ +00010830: 7361 6d65 2074 6172 6765 742e 0a0a 2020 same target... │ │ │ │ │ +00010840: 2054 6865 7365 206f 7665 7272 6964 696e These overridin │ │ │ │ │ +00010850: 6720 7365 6d61 6e74 6963 7320 6d61 6b65 g semantics make │ │ │ │ │ +00010860: 2069 7420 706f 7373 6962 6c65 2074 6f20 it possible to │ │ │ │ │ +00010870: 6669 6e65 2074 756e 6520 736f 6d65 2064 fine tune some d │ │ │ │ │ +00010880: 6566 6175 6c74 0a73 6574 7469 6e67 7320 efault.settings │ │ │ │ │ +00010890: 6f66 2041 7574 6f6d 616b 652c 206f 7220 of Automake, or │ │ │ │ │ +000108a0: 7265 706c 6163 6520 736f 6d65 206f 6620 replace some of │ │ │ │ │ +000108b0: 6974 7320 7275 6c65 732e 2020 4f76 6572 its rules. Over │ │ │ │ │ +000108c0: 7269 6469 6e67 2041 7574 6f6d 616b 650a riding Automake. │ │ │ │ │ +000108d0: 7275 6c65 7320 6973 206f 6674 656e 2069 rules is often i │ │ │ │ │ +000108e0: 6e61 6476 6973 6162 6c65 2c20 7061 7274 nadvisable, part │ │ │ │ │ +000108f0: 6963 756c 6172 6c79 2069 6e20 7468 6520 icularly in the │ │ │ │ │ +00010900: 746f 706d 6f73 7420 6469 7265 6374 6f72 topmost director │ │ │ │ │ +00010910: 7920 6f66 2061 0a70 6163 6b61 6765 2077 y of a.package w │ │ │ │ │ +00010920: 6974 6820 7375 6264 6972 6563 746f 7269 ith subdirectori │ │ │ │ │ +00010930: 6573 2e20 2054 6865 2027 2d57 6f76 6572 es. The '-Wover │ │ │ │ │ +00010940: 7269 6465 2720 6f70 7469 6f6e 2028 2a6e ride' option (*n │ │ │ │ │ +00010950: 6f74 6520 6175 746f 6d61 6b65 0a49 6e76 ote automake.Inv │ │ │ │ │ +00010960: 6f63 6174 696f 6e3a 3a29 2063 6f6d 6573 ocation::) comes │ │ │ │ │ +00010970: 2069 6e20 6861 6e64 7920 746f 2063 6174 in handy to cat │ │ │ │ │ +00010980: 6368 206f 7665 7272 6964 6465 6e20 6465 ch overridden de │ │ │ │ │ +00010990: 6669 6e69 7469 6f6e 732e 0a0a 2020 204e finitions... N │ │ │ │ │ +000109a0: 6f74 6520 7468 6174 2041 7574 6f6d 616b ote that Automak │ │ │ │ │ +000109b0: 6520 646f 6573 206e 6f74 206d 616b 6520 e does not make │ │ │ │ │ +000109c0: 616e 7920 6469 7374 696e 6374 696f 6e20 any distinction │ │ │ │ │ +000109d0: 6265 7477 6565 6e20 7275 6c65 7320 7769 between rules wi │ │ │ │ │ +000109e0: 7468 0a63 6f6d 6d61 6e64 7320 616e 6420 th.commands and │ │ │ │ │ +000109f0: 7275 6c65 7320 7468 6174 206f 6e6c 7920 rules that only │ │ │ │ │ +00010a00: 7370 6563 6966 7920 6465 7065 6e64 656e specify dependen │ │ │ │ │ +00010a10: 6369 6573 2e20 2053 6f20 6974 2069 7320 cies. So it is │ │ │ │ │ +00010a20: 6e6f 740a 706f 7373 6962 6c65 2074 6f20 not.possible to │ │ │ │ │ +00010a30: 6170 7065 6e64 206e 6577 2064 6570 656e append new depen │ │ │ │ │ +00010a40: 6465 6e63 6965 7320 746f 2061 6e20 2761 dencies to an 'a │ │ │ │ │ +00010a50: 7574 6f6d 616b 6527 2d64 6566 696e 6564 utomake'-defined │ │ │ │ │ +00010a60: 2074 6172 6765 740a 7769 7468 6f75 7420 target.without │ │ │ │ │ +00010a70: 7265 6465 6669 6e69 6e67 2074 6865 2065 redefining the e │ │ │ │ │ +00010a80: 6e74 6972 6520 7275 6c65 2e0a 0a20 2020 ntire rule... │ │ │ │ │ +00010a90: 486f 7765 7665 722c 2076 6172 696f 7573 However, various │ │ │ │ │ +00010aa0: 2075 7365 6675 6c20 7461 7267 6574 7320 useful targets │ │ │ │ │ +00010ab0: 6861 7665 2061 2027 2d6c 6f63 616c 2720 have a '-local' │ │ │ │ │ +00010ac0: 7665 7273 696f 6e20 796f 7520 6361 6e0a version you can. │ │ │ │ │ +00010ad0: 7370 6563 6966 7920 696e 2079 6f75 7220 specify in your │ │ │ │ │ +00010ae0: 274d 616b 6566 696c 652e 616d 272e 2020 'Makefile.am'. │ │ │ │ │ +00010af0: 4175 746f 6d61 6b65 2077 696c 6c20 7375 Automake will su │ │ │ │ │ +00010b00: 7070 6c65 6d65 6e74 2074 6865 2073 7461 pplement the sta │ │ │ │ │ +00010b10: 6e64 6172 640a 7461 7267 6574 2077 6974 ndard.target wit │ │ │ │ │ +00010b20: 6820 7468 6573 6520 7573 6572 2d73 7570 h these user-sup │ │ │ │ │ +00010b30: 706c 6965 6420 7461 7267 6574 732e 0a0a plied targets... │ │ │ │ │ +00010b40: 2020 2054 6865 2074 6172 6765 7473 2074 The targets t │ │ │ │ │ +00010b50: 6861 7420 7375 7070 6f72 7420 6120 6c6f hat support a lo │ │ │ │ │ +00010b60: 6361 6c20 7665 7273 696f 6e20 6172 6520 cal version are │ │ │ │ │ +00010b70: 2761 6c6c 272c 2027 696e 666f 272c 2027 'all', 'info', ' │ │ │ │ │ +00010b80: 6476 6927 2c0a 2770 7327 2c20 2770 6466 dvi',.'ps', 'pdf │ │ │ │ │ +00010b90: 272c 2027 6874 6d6c 272c 2027 6368 6563 ', 'html', 'chec │ │ │ │ │ +00010ba0: 6b27 2c20 2769 6e73 7461 6c6c 2d64 6174 k', 'install-dat │ │ │ │ │ +00010bb0: 6127 2c20 2769 6e73 7461 6c6c 2d64 7669 a', 'install-dvi │ │ │ │ │ +00010bc0: 272c 0a27 696e 7374 616c 6c2d 6578 6563 ',.'install-exec │ │ │ │ │ +00010bd0: 272c 2027 696e 7374 616c 6c2d 6874 6d6c ', 'install-html │ │ │ │ │ +00010be0: 272c 2027 696e 7374 616c 6c2d 696e 666f ', 'install-info │ │ │ │ │ +00010bf0: 272c 2027 696e 7374 616c 6c2d 7064 6627 ', 'install-pdf' │ │ │ │ │ +00010c00: 2c0a 2769 6e73 7461 6c6c 2d70 7327 2c20 ,.'install-ps', │ │ │ │ │ +00010c10: 2775 6e69 6e73 7461 6c6c 272c 2027 696e 'uninstall', 'in │ │ │ │ │ +00010c20: 7374 616c 6c64 6972 7327 2c20 2769 6e73 stalldirs', 'ins │ │ │ │ │ +00010c30: 7461 6c6c 6368 6563 6b27 2061 6e64 2074 tallcheck' and t │ │ │ │ │ +00010c40: 6865 2076 6172 696f 7573 0a27 636c 6561 he various.'clea │ │ │ │ │ +00010c50: 6e27 2074 6172 6765 7473 2028 276d 6f73 n' targets ('mos │ │ │ │ │ +00010c60: 746c 7963 6c65 616e 272c 2027 636c 6561 tlyclean', 'clea │ │ │ │ │ +00010c70: 6e27 2c20 2764 6973 7463 6c65 616e 272c n', 'distclean', │ │ │ │ │ +00010c80: 2061 6e64 0a27 6d61 696e 7461 696e 6572 and.'maintainer │ │ │ │ │ +00010c90: 2d63 6c65 616e 2729 2e0a 0a20 2020 4e6f -clean')... No │ │ │ │ │ +00010ca0: 7465 2074 6861 7420 7468 6572 6520 6172 te that there ar │ │ │ │ │ +00010cb0: 6520 6e6f 2027 756e 696e 7374 616c 6c2d e no 'uninstall- │ │ │ │ │ +00010cc0: 6578 6563 2d6c 6f63 616c 2720 6f72 0a27 exec-local' or.' │ │ │ │ │ +00010cd0: 756e 696e 7374 616c 6c2d 6461 7461 2d6c uninstall-data-l │ │ │ │ │ +00010ce0: 6f63 616c 2720 7461 7267 6574 733b 206a ocal' targets; j │ │ │ │ │ +00010cf0: 7573 7420 7573 6520 2775 6e69 6e73 7461 ust use 'uninsta │ │ │ │ │ +00010d00: 6c6c 2d6c 6f63 616c 272e 2020 4974 2064 ll-local'. It d │ │ │ │ │ +00010d10: 6f65 736e 2774 0a6d 616b 6520 7365 6e73 oesn't.make sens │ │ │ │ │ +00010d20: 6520 746f 2075 6e69 6e73 7461 6c6c 206a e to uninstall j │ │ │ │ │ +00010d30: 7573 7420 6461 7461 206f 7220 6a75 7374 ust data or just │ │ │ │ │ +00010d40: 2065 7865 6375 7461 626c 6573 2e0a 0a20 executables... │ │ │ │ │ +00010d50: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ +00010d60: 6865 7265 2069 7320 6f6e 6520 7761 7920 here is one way │ │ │ │ │ +00010d70: 746f 2065 7261 7365 2061 2073 7562 6469 to erase a subdi │ │ │ │ │ +00010d80: 7265 6374 6f72 7920 6475 7269 6e67 2027 rectory during ' │ │ │ │ │ +00010d90: 6d61 6b65 0a63 6c65 616e 2720 282a 6e6f make.clean' (*no │ │ │ │ │ +00010da0: 7465 2043 6c65 616e 3a3a 292e 0a0a 2020 te Clean::)... │ │ │ │ │ +00010db0: 2020 2063 6c65 616e 2d6c 6f63 616c 3a0a clean-local:. │ │ │ │ │ +00010dc0: 2020 2020 2020 2020 2020 2020 202d 726d -rm │ │ │ │ │ +00010dd0: 202d 7266 2074 6573 7453 7562 4469 720a -rf testSubDir. │ │ │ │ │ +00010de0: 0a20 2020 596f 7520 6d61 7920 6265 2074 . You may be t │ │ │ │ │ +00010df0: 656d 7074 6564 2074 6f20 7573 6520 2769 empted to use 'i │ │ │ │ │ +00010e00: 6e73 7461 6c6c 2d64 6174 612d 6c6f 6361 nstall-data-loca │ │ │ │ │ +00010e10: 6c27 2074 6f20 696e 7374 616c 6c20 6120 l' to install a │ │ │ │ │ +00010e20: 6669 6c65 2074 6f0a 736f 6d65 2068 6172 file to.some har │ │ │ │ │ +00010e30: 642d 636f 6465 6420 6c6f 6361 7469 6f6e d-coded location │ │ │ │ │ +00010e40: 2c20 6275 7420 796f 7520 7368 6f75 6c64 , but you should │ │ │ │ │ +00010e50: 2061 766f 6964 2074 6869 7320 282a 6e6f avoid this (*no │ │ │ │ │ +00010e60: 7465 2048 6172 642d 436f 6465 640a 496e te Hard-Coded.In │ │ │ │ │ +00010e70: 7374 616c 6c20 5061 7468 733a 3a29 2e0a stall Paths::).. │ │ │ │ │ +00010e80: 0a20 2020 5769 7468 2074 6865 2027 2d6c . With the '-l │ │ │ │ │ +00010e90: 6f63 616c 2720 7461 7267 6574 732c 2074 ocal' targets, t │ │ │ │ │ +00010ea0: 6865 7265 2069 7320 6e6f 2070 6172 7469 here is no parti │ │ │ │ │ +00010eb0: 6375 6c61 7220 6775 6172 616e 7465 6520 cular guarantee │ │ │ │ │ +00010ec0: 6f66 0a65 7865 6375 7469 6f6e 206f 7264 of.execution ord │ │ │ │ │ +00010ed0: 6572 3b20 7479 7069 6361 6c6c 792c 2074 er; typically, t │ │ │ │ │ +00010ee0: 6865 7920 6172 6520 7275 6e20 6561 726c hey are run earl │ │ │ │ │ +00010ef0: 792c 2062 7574 2077 6974 6820 7061 7261 y, but with para │ │ │ │ │ +00010f00: 6c6c 656c 206d 616b 652c 0a74 6865 7265 llel make,.there │ │ │ │ │ +00010f10: 2069 7320 6e6f 2077 6179 2074 6f20 6265 is no way to be │ │ │ │ │ +00010f20: 2073 7572 6520 6f66 2074 6861 742e 0a0a sure of that... │ │ │ │ │ +00010f30: 2020 2049 6e20 636f 6e74 7261 7374 2c20 In contrast, │ │ │ │ │ +00010f40: 736f 6d65 2072 756c 6573 2061 6c73 6f20 some rules also │ │ │ │ │ +00010f50: 6861 7665 2061 2077 6179 2074 6f20 7275 have a way to ru │ │ │ │ │ +00010f60: 6e20 616e 6f74 6865 7220 7275 6c65 2c20 n another rule, │ │ │ │ │ +00010f70: 6361 6c6c 6564 2061 0a22 686f 6f6b 223b called a."hook"; │ │ │ │ │ +00010f80: 2068 6f6f 6b73 2061 7265 2061 6c77 6179 hooks are alway │ │ │ │ │ +00010f90: 7320 6578 6563 7574 6564 2061 6674 6572 s executed after │ │ │ │ │ +00010fa0: 2074 6865 206d 6169 6e20 7275 6c65 2773 the main rule's │ │ │ │ │ +00010fb0: 2077 6f72 6b20 6973 2064 6f6e 652e 0a54 work is done..T │ │ │ │ │ +00010fc0: 6865 2068 6f6f 6b20 6973 206e 616d 6564 he hook is named │ │ │ │ │ +00010fd0: 2061 6674 6572 2074 6865 2070 7269 6e63 after the princ │ │ │ │ │ +00010fe0: 6970 616c 2074 6172 6765 742c 2077 6974 ipal target, wit │ │ │ │ │ +00010ff0: 6820 272d 686f 6f6b 2720 6170 7065 6e64 h '-hook' append │ │ │ │ │ +00011000: 6564 2e0a 5468 6520 7461 7267 6574 7320 ed..The targets │ │ │ │ │ +00011010: 616c 6c6f 7769 6e67 2068 6f6f 6b73 2061 allowing hooks a │ │ │ │ │ +00011020: 7265 2027 696e 7374 616c 6c2d 6461 7461 re 'install-data │ │ │ │ │ +00011030: 272c 2027 696e 7374 616c 6c2d 6578 6563 ', 'install-exec │ │ │ │ │ +00011040: 272c 0a27 756e 696e 7374 616c 6c27 2c20 ',.'uninstall', │ │ │ │ │ +00011050: 2764 6973 7427 2c20 616e 6420 2764 6973 'dist', and 'dis │ │ │ │ │ +00011060: 7463 6865 636b 272e 0a0a 2020 2046 6f72 tcheck'... For │ │ │ │ │ +00011070: 2069 6e73 7461 6e63 652c 2068 6572 6520 instance, here │ │ │ │ │ +00011080: 6973 2068 6f77 2074 6f20 6372 6561 7465 is how to create │ │ │ │ │ +00011090: 2061 2068 6172 6420 6c69 6e6b 2074 6f20 a hard link to │ │ │ │ │ +000110a0: 616e 2069 6e73 7461 6c6c 6564 0a70 726f an installed.pro │ │ │ │ │ +000110b0: 6772 616d 3a0a 0a20 2020 2020 696e 7374 gram:.. inst │ │ │ │ │ +000110c0: 616c 6c2d 6578 6563 2d68 6f6f 6b3a 0a20 all-exec-hook:. │ │ │ │ │ +000110d0: 2020 2020 2020 2020 2020 2020 6c6e 2024 ln $ │ │ │ │ │ +000110e0: 2844 4553 5444 4952 2924 2862 696e 6469 (DESTDIR)$(bindi │ │ │ │ │ +000110f0: 7229 2f70 726f 6772 616d 2428 4558 4545 r)/program$(EXEE │ │ │ │ │ +00011100: 5854 2920 5c0a 2020 2020 2020 2020 2020 XT) \. │ │ │ │ │ +00011110: 2020 2020 2020 2428 4445 5354 4449 5229 $(DESTDIR) │ │ │ │ │ +00011120: 2428 6269 6e64 6972 292f 7072 6f67 6c69 $(bindir)/progli │ │ │ │ │ +00011130: 6e6b 2428 4558 4545 5854 290a 0a20 2020 nk$(EXEEXT).. │ │ │ │ │ +00011140: 416c 7468 6f75 6768 2063 6865 6170 6572 Although cheaper │ │ │ │ │ +00011150: 2061 6e64 206d 6f72 6520 706f 7274 6162 and more portab │ │ │ │ │ +00011160: 6c65 2074 6861 6e20 7379 6d62 6f6c 6963 le than symbolic │ │ │ │ │ +00011170: 206c 696e 6b73 2c20 6861 7264 206c 696e links, hard lin │ │ │ │ │ +00011180: 6b73 0a77 696c 6c20 6e6f 7420 776f 726b ks.will not work │ │ │ │ │ +00011190: 2065 7665 7279 7768 6572 6520 2866 6f72 everywhere (for │ │ │ │ │ +000111a0: 2069 6e73 7461 6e63 652c 204f 532f 3220 instance, OS/2 │ │ │ │ │ +000111b0: 646f 6573 206e 6f74 2068 6176 6520 276c does not have 'l │ │ │ │ │ +000111c0: 6e27 292e 0a49 6465 616c 6c79 2079 6f75 n')..Ideally you │ │ │ │ │ +000111d0: 2073 686f 756c 6420 6661 6c6c 2062 6163 should fall bac │ │ │ │ │ +000111e0: 6b20 746f 2027 6370 202d 7027 2077 6865 k to 'cp -p' whe │ │ │ │ │ +000111f0: 6e20 276c 6e27 2064 6f65 7320 6e6f 7420 n 'ln' does not │ │ │ │ │ +00011200: 776f 726b 2e20 2041 6e0a 6561 7379 2077 work. An.easy w │ │ │ │ │ +00011210: 6179 2c20 6966 2073 796d 626f 6c69 6320 ay, if symbolic │ │ │ │ │ +00011220: 6c69 6e6b 7320 6172 6520 6163 6365 7074 links are accept │ │ │ │ │ +00011230: 6162 6c65 2074 6f20 796f 752c 2069 7320 able to you, is │ │ │ │ │ +00011240: 746f 2061 6464 0a27 4143 5f50 524f 475f to add.'AC_PROG_ │ │ │ │ │ +00011250: 4c4e 5f53 2720 746f 2027 636f 6e66 6967 LN_S' to 'config │ │ │ │ │ +00011260: 7572 652e 6163 2720 282a 6e6f 7465 2050 ure.ac' (*note P │ │ │ │ │ +00011270: 6172 7469 6375 6c61 7220 5072 6f67 7261 articular Progra │ │ │ │ │ +00011280: 6d20 4368 6563 6b73 3a0a 2861 7574 6f63 m Checks:.(autoc │ │ │ │ │ +00011290: 6f6e 6629 5061 7274 6963 756c 6172 2050 onf)Particular P │ │ │ │ │ +000112a0: 726f 6772 616d 732e 2920 616e 6420 7573 rograms.) and us │ │ │ │ │ +000112b0: 6520 2724 284c 4e5f 5329 2720 696e 2027 e '$(LN_S)' in ' │ │ │ │ │ +000112c0: 4d61 6b65 6669 6c65 2e61 6d27 2e0a 0a20 Makefile.am'... │ │ │ │ │ +000112d0: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ +000112e0: 6865 7265 2069 7320 686f 7720 796f 7520 here is how you │ │ │ │ │ +000112f0: 636f 756c 6420 696e 7374 616c 6c20 6120 could install a │ │ │ │ │ +00011300: 7665 7273 696f 6e65 6420 636f 7079 206f versioned copy o │ │ │ │ │ +00011310: 6620 610a 7072 6f67 7261 6d20 7573 696e f a.program usin │ │ │ │ │ +00011320: 6720 2724 284c 4e5f 5329 273a 0a0a 2020 g '$(LN_S)':.. │ │ │ │ │ +00011330: 2020 2069 6e73 7461 6c6c 2d65 7865 632d install-exec- │ │ │ │ │ +00011340: 686f 6f6b 3a0a 2020 2020 2020 2020 2020 hook:. │ │ │ │ │ +00011350: 2020 2063 6420 2428 4445 5354 4449 5229 cd $(DESTDIR) │ │ │ │ │ +00011360: 2428 6269 6e64 6972 2920 2626 205c 0a20 $(bindir) && \. │ │ │ │ │ +00011370: 2020 2020 2020 2020 2020 2020 2020 6d76 mv │ │ │ │ │ +00011380: 202d 6620 7072 6f67 2428 4558 4545 5854 -f prog$(EXEEXT │ │ │ │ │ +00011390: 2920 7072 6f67 2d24 2856 4552 5349 4f4e ) prog-$(VERSION │ │ │ │ │ +000113a0: 2924 2845 5845 4558 5429 2026 2620 5c0a )$(EXEEXT) && \. │ │ │ │ │ +000113b0: 2020 2020 2020 2020 2020 2020 2020 2024 $ │ │ │ │ │ +000113c0: 284c 4e5f 5329 2070 726f 672d 2428 5645 (LN_S) prog-$(VE │ │ │ │ │ +000113d0: 5253 494f 4e29 2428 4558 4545 5854 2920 RSION)$(EXEEXT) │ │ │ │ │ +000113e0: 7072 6f67 2428 4558 4545 5854 290a 0a20 prog$(EXEEXT).. │ │ │ │ │ +000113f0: 2020 4e6f 7465 2074 6861 7420 7765 2072 Note that we r │ │ │ │ │ +00011400: 656e 616d 6520 7468 6520 7072 6f67 7261 ename the progra │ │ │ │ │ +00011410: 6d20 736f 2074 6861 7420 6120 6e65 7720 m so that a new │ │ │ │ │ +00011420: 7665 7273 696f 6e20 7769 6c6c 2065 7261 version will era │ │ │ │ │ +00011430: 7365 2074 6865 0a73 796d 626f 6c69 6320 se the.symbolic │ │ │ │ │ +00011440: 6c69 6e6b 2c20 6e6f 7420 7468 6520 7265 link, not the re │ │ │ │ │ +00011450: 616c 2062 696e 6172 792e 2020 416c 736f al binary. Also │ │ │ │ │ +00011460: 2077 6520 2763 6427 2069 6e74 6f20 7468 we 'cd' into th │ │ │ │ │ +00011470: 6520 6465 7374 696e 6174 696f 6e0a 6469 e destination.di │ │ │ │ │ +00011480: 7265 6374 6f72 7920 696e 206f 7264 6572 rectory in order │ │ │ │ │ +00011490: 2074 6f20 6372 6561 7465 2072 656c 6174 to create relat │ │ │ │ │ +000114a0: 6976 6520 6c69 6e6b 732e 0a0a 2020 2057 ive links... W │ │ │ │ │ +000114b0: 6865 6e20 7772 6974 696e 6720 2769 6e73 hen writing 'ins │ │ │ │ │ +000114c0: 7461 6c6c 2d65 7865 632d 686f 6f6b 2720 tall-exec-hook' │ │ │ │ │ +000114d0: 6f72 2027 696e 7374 616c 6c2d 6461 7461 or 'install-data │ │ │ │ │ +000114e0: 2d68 6f6f 6b27 2c20 706c 6561 7365 2062 -hook', please b │ │ │ │ │ +000114f0: 6561 720a 696e 206d 696e 6420 7468 6174 ear.in mind that │ │ │ │ │ +00011500: 2074 6865 2065 7865 632f 6461 7461 2064 the exec/data d │ │ │ │ │ +00011510: 6973 7469 6e63 7469 6f6e 2069 7320 6261 istinction is ba │ │ │ │ │ +00011520: 7365 6420 6f6e 2074 6865 2069 6e73 7461 sed on the insta │ │ │ │ │ +00011530: 6c6c 6174 696f 6e0a 6469 7265 6374 6f72 llation.director │ │ │ │ │ +00011540: 792c 206e 6f74 206f 6e20 7468 6520 7072 y, not on the pr │ │ │ │ │ +00011550: 696d 6172 7920 7573 6564 2028 2a6e 6f74 imary used (*not │ │ │ │ │ +00011560: 6520 5468 6520 5477 6f20 5061 7274 7320 e The Two Parts │ │ │ │ │ +00011570: 6f66 2049 6e73 7461 6c6c 3a3a 292e 0a53 of Install::)..S │ │ │ │ │ +00011580: 6f20 6120 2766 6f6f 5f53 4352 4950 5453 o a 'foo_SCRIPTS │ │ │ │ │ +00011590: 2720 7769 6c6c 2062 6520 696e 7374 616c ' will be instal │ │ │ │ │ +000115a0: 6c65 6420 6279 2027 696e 7374 616c 6c2d led by 'install- │ │ │ │ │ +000115b0: 6461 7461 272c 2061 6e64 2061 0a27 6261 data', and a.'ba │ │ │ │ │ +000115c0: 7265 7865 635f 5343 5249 5054 5327 2077 rexec_SCRIPTS' w │ │ │ │ │ +000115d0: 696c 6c20 6265 2069 6e73 7461 6c6c 6564 ill be installed │ │ │ │ │ +000115e0: 2062 7920 2769 6e73 7461 6c6c 2d65 7865 by 'install-exe │ │ │ │ │ +000115f0: 6327 2e20 2059 6f75 2073 686f 756c 640a c'. You should. │ │ │ │ │ +00011600: 6465 6669 6e65 2079 6f75 7220 686f 6f6b define your hook │ │ │ │ │ +00011610: 7320 636f 6e73 6571 7565 6e74 6c79 2e0a s consequently.. │ │ │ │ │ +00011620: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +00011630: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +00011640: 6465 3a20 5468 6972 642d 5061 7274 7920 de: Third-Party │ │ │ │ │ +00011650: 4d61 6b65 6669 6c65 732c 2020 5072 6576 Makefiles, Prev │ │ │ │ │ +00011660: 3a20 4578 7465 6e64 696e 672c 2020 5570 : Extending, Up │ │ │ │ │ +00011670: 3a20 4e6f 7420 456e 6f75 6768 0a0a 3234 : Not Enough..24 │ │ │ │ │ +00011680: 2e32 2054 6869 7264 2d50 6172 7479 2027 .2 Third-Party ' │ │ │ │ │ +00011690: 4d61 6b65 6669 6c65 2773 0a3d 3d3d 3d3d Makefile's.===== │ │ │ │ │ 000116a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000116b0: 3d3d 3d3d 3d3d 0a0a 496e 206d 6f73 7420 ======..In most │ │ │ │ │ -000116c0: 7072 6f6a 6563 7473 2061 6c6c 2027 4d61 projects all 'Ma │ │ │ │ │ -000116d0: 6b65 6669 6c65 2773 2061 7265 2067 656e kefile's are gen │ │ │ │ │ -000116e0: 6572 6174 6564 2062 7920 4175 746f 6d61 erated by Automa │ │ │ │ │ -000116f0: 6b65 2e20 2049 6e20 736f 6d65 0a63 6173 ke. In some.cas │ │ │ │ │ -00011700: 6573 2c20 686f 7765 7665 722c 2070 726f es, however, pro │ │ │ │ │ -00011710: 6a65 6374 7320 6e65 6564 2074 6f20 656d jects need to em │ │ │ │ │ -00011720: 6265 6420 7375 6264 6972 6563 746f 7269 bed subdirectori │ │ │ │ │ -00011730: 6573 2077 6974 6820 6861 6e64 7772 6974 es with handwrit │ │ │ │ │ -00011740: 7465 6e0a 274d 616b 6566 696c 6527 732e ten.'Makefile's. │ │ │ │ │ -00011750: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ -00011760: 6f6e 6520 7375 6264 6972 6563 746f 7279 one subdirectory │ │ │ │ │ -00011770: 2063 6f75 6c64 2062 6520 6120 7468 6972 could be a thir │ │ │ │ │ -00011780: 642d 7061 7274 790a 7072 6f6a 6563 7420 d-party.project │ │ │ │ │ -00011790: 7769 7468 2069 7473 206f 776e 2062 7569 with its own bui │ │ │ │ │ -000117a0: 6c64 2073 7973 7465 6d2c 206e 6f74 2075 ld system, not u │ │ │ │ │ -000117b0: 7369 6e67 2041 7574 6f6d 616b 652e 0a0a sing Automake... │ │ │ │ │ -000117c0: 2020 2049 7420 6973 2070 6f73 7369 626c It is possibl │ │ │ │ │ -000117d0: 6520 746f 206c 6973 7420 6172 6269 7472 e to list arbitr │ │ │ │ │ -000117e0: 6172 7920 6469 7265 6374 6f72 6965 7320 ary directories │ │ │ │ │ -000117f0: 696e 2027 5355 4244 4952 5327 206f 720a in 'SUBDIRS' or. │ │ │ │ │ -00011800: 2744 4953 545f 5355 4244 4952 5327 2070 'DIST_SUBDIRS' p │ │ │ │ │ -00011810: 726f 7669 6465 6420 6561 6368 206f 6620 rovided each of │ │ │ │ │ -00011820: 7468 6573 6520 6469 7265 6374 6f72 6965 these directorie │ │ │ │ │ -00011830: 7320 6861 7320 6120 274d 616b 6566 696c s has a 'Makefil │ │ │ │ │ -00011840: 6527 2074 6861 740a 7265 636f 676e 697a e' that.recogniz │ │ │ │ │ -00011850: 6573 2061 6c6c 2074 6865 2066 6f6c 6c6f es all the follo │ │ │ │ │ -00011860: 7769 6e67 2072 6563 7572 7369 7665 2074 wing recursive t │ │ │ │ │ -00011870: 6172 6765 7473 2e0a 0a20 2020 5768 656e argets... When │ │ │ │ │ -00011880: 2061 2075 7365 7220 7275 6e73 206f 6e65 a user runs one │ │ │ │ │ -00011890: 206f 6620 7468 6573 6520 7461 7267 6574 of these target │ │ │ │ │ -000118a0: 732c 2074 6861 7420 7461 7267 6574 2069 s, that target i │ │ │ │ │ -000118b0: 7320 7275 6e20 7265 6375 7273 6976 656c s run recursivel │ │ │ │ │ -000118c0: 790a 696e 2061 6c6c 2073 7562 6469 7265 y.in all subdire │ │ │ │ │ -000118d0: 6374 6f72 6965 732e 2020 5468 6973 2069 ctories. This i │ │ │ │ │ -000118e0: 7320 7768 7920 6974 2069 7320 696d 706f s why it is impo │ │ │ │ │ -000118f0: 7274 616e 7420 7468 6174 2065 7665 6e0a rtant that even. │ │ │ │ │ -00011900: 7468 6972 642d 7061 7274 7920 274d 616b third-party 'Mak │ │ │ │ │ -00011910: 6566 696c 6527 7320 7375 7070 6f72 7420 efile's support │ │ │ │ │ -00011920: 7468 656d 2e0a 0a27 616c 6c27 0a20 2020 them...'all'. │ │ │ │ │ -00011930: 2020 436f 6d70 696c 6520 7468 6520 656e Compile the en │ │ │ │ │ -00011940: 7469 7265 2070 6163 6b61 6765 2e20 2054 tire package. T │ │ │ │ │ -00011950: 6869 7320 6973 2074 6865 2064 6566 6175 his is the defau │ │ │ │ │ -00011960: 6c74 2074 6172 6765 7420 696e 0a20 2020 lt target in. │ │ │ │ │ -00011970: 2020 4175 746f 6d61 6b65 2d67 656e 6572 Automake-gener │ │ │ │ │ -00011980: 6174 6564 2027 4d61 6b65 6669 6c65 2773 ated 'Makefile's │ │ │ │ │ -00011990: 2c20 6275 7420 6974 2064 6f65 7320 6e6f , but it does no │ │ │ │ │ -000119a0: 7420 6e65 6564 2074 6f20 6265 2074 6865 t need to be the │ │ │ │ │ -000119b0: 0a20 2020 2020 6465 6661 756c 7420 696e . default in │ │ │ │ │ -000119c0: 2074 6869 7264 2d70 6172 7479 2027 4d61 third-party 'Ma │ │ │ │ │ -000119d0: 6b65 6669 6c65 2773 2e0a 0a27 6469 7374 kefile's...'dist │ │ │ │ │ -000119e0: 6469 7227 0a20 2020 2020 436f 7079 2066 dir'. Copy f │ │ │ │ │ -000119f0: 696c 6573 2074 6f20 6469 7374 7269 6275 iles to distribu │ │ │ │ │ -00011a00: 7465 2069 6e74 6f20 2724 2864 6973 7464 te into '$(distd │ │ │ │ │ -00011a10: 6972 2927 2c20 6265 666f 7265 2061 2074 ir)', before a t │ │ │ │ │ -00011a20: 6172 6261 6c6c 2069 730a 2020 2020 2063 arball is. c │ │ │ │ │ -00011a30: 6f6e 7374 7275 6374 6564 2e20 204f 6620 onstructed. Of │ │ │ │ │ -00011a40: 636f 7572 7365 2074 6869 7320 7461 7267 course this targ │ │ │ │ │ -00011a50: 6574 2069 7320 6e6f 7420 7265 7175 6972 et is not requir │ │ │ │ │ -00011a60: 6564 2069 6620 7468 650a 2020 2020 2027 ed if the. ' │ │ │ │ │ -00011a70: 6e6f 2d64 6973 7427 206f 7074 696f 6e20 no-dist' option │ │ │ │ │ -00011a80: 282a 6e6f 7465 204f 7074 696f 6e73 3a3a (*note Options:: │ │ │ │ │ -00011a90: 2920 6973 2075 7365 642e 0a0a 2020 2020 ) is used... │ │ │ │ │ -00011aa0: 2054 6865 2076 6172 6961 626c 6573 2027 The variables ' │ │ │ │ │ -00011ab0: 2428 746f 705f 6469 7374 6469 7229 2720 $(top_distdir)' │ │ │ │ │ -00011ac0: 616e 6420 2724 2864 6973 7464 6972 2927 and '$(distdir)' │ │ │ │ │ -00011ad0: 2028 2a6e 6f74 6520 5468 6520 6469 7374 (*note The dist │ │ │ │ │ -00011ae0: 0a20 2020 2020 486f 6f6b 3a3a 2920 7769 . Hook::) wi │ │ │ │ │ -00011af0: 6c6c 2062 6520 7061 7373 6564 2066 726f ll be passed fro │ │ │ │ │ -00011b00: 6d20 7468 6520 6f75 7465 7220 7061 636b m the outer pack │ │ │ │ │ -00011b10: 6167 6520 746f 2074 6865 2073 7562 7061 age to the subpa │ │ │ │ │ -00011b20: 636b 6167 650a 2020 2020 2077 6865 6e20 ckage. when │ │ │ │ │ -00011b30: 7468 6520 2764 6973 7464 6972 2720 7461 the 'distdir' ta │ │ │ │ │ -00011b40: 7267 6574 2069 7320 696e 766f 6b65 642e rget is invoked. │ │ │ │ │ -00011b50: 2020 5468 6573 6520 7477 6f20 7661 7269 These two vari │ │ │ │ │ -00011b60: 6162 6c65 7320 6861 7665 0a20 2020 2020 ables have. │ │ │ │ │ -00011b70: 6265 656e 2061 646a 7573 7465 6420 666f been adjusted fo │ │ │ │ │ -00011b80: 7220 7468 6520 6469 7265 6374 6f72 7920 r the directory │ │ │ │ │ -00011b90: 7468 6174 2069 7320 6265 696e 6720 7265 that is being re │ │ │ │ │ -00011ba0: 6375 7273 6564 2069 6e74 6f2c 2073 6f0a cursed into, so. │ │ │ │ │ -00011bb0: 2020 2020 2074 6865 7920 6172 6520 7265 they are re │ │ │ │ │ -00011bc0: 6164 7920 746f 2075 7365 2e0a 0a27 696e ady to use...'in │ │ │ │ │ -00011bd0: 7374 616c 6c27 0a27 696e 7374 616c 6c2d stall'.'install- │ │ │ │ │ -00011be0: 6461 7461 270a 2769 6e73 7461 6c6c 2d65 data'.'install-e │ │ │ │ │ -00011bf0: 7865 6327 0a27 756e 696e 7374 616c 6c27 xec'.'uninstall' │ │ │ │ │ -00011c00: 0a20 2020 2020 496e 7374 616c 6c20 6f72 . Install or │ │ │ │ │ -00011c10: 2075 6e69 6e73 7461 6c6c 2066 696c 6573 uninstall files │ │ │ │ │ -00011c20: 2028 2a6e 6f74 6520 496e 7374 616c 6c3a (*note Install: │ │ │ │ │ -00011c30: 3a29 2e0a 0a27 696e 7374 616c 6c2d 6476 :)...'install-dv │ │ │ │ │ -00011c40: 6927 0a27 696e 7374 616c 6c2d 6874 6d6c i'.'install-html │ │ │ │ │ -00011c50: 270a 2769 6e73 7461 6c6c 2d69 6e66 6f27 '.'install-info' │ │ │ │ │ -00011c60: 0a27 696e 7374 616c 6c2d 7073 270a 2769 .'install-ps'.'i │ │ │ │ │ -00011c70: 6e73 7461 6c6c 2d70 6466 270a 2020 2020 nstall-pdf'. │ │ │ │ │ -00011c80: 2049 6e73 7461 6c6c 206f 6e6c 7920 736f Install only so │ │ │ │ │ -00011c90: 6d65 2073 7065 6369 6669 6320 646f 6375 me specific docu │ │ │ │ │ -00011ca0: 6d65 6e74 6174 696f 6e20 666f 726d 6174 mentation format │ │ │ │ │ -00011cb0: 2028 2a6e 6f74 6520 5465 7869 6e66 6f3a (*note Texinfo: │ │ │ │ │ -00011cc0: 3a29 2e0a 0a27 696e 7374 616c 6c64 6972 :)...'installdir │ │ │ │ │ -00011cd0: 7327 0a20 2020 2020 4372 6561 7465 2069 s'. Create i │ │ │ │ │ -00011ce0: 6e73 7461 6c6c 2064 6972 6563 746f 7269 nstall directori │ │ │ │ │ -00011cf0: 6573 2c20 6275 7420 646f 206e 6f74 2069 es, but do not i │ │ │ │ │ -00011d00: 6e73 7461 6c6c 2061 6e79 2066 696c 6573 nstall any files │ │ │ │ │ -00011d10: 2e0a 0a27 6368 6563 6b27 0a27 696e 7374 ...'check'.'inst │ │ │ │ │ -00011d20: 616c 6c63 6865 636b 270a 2020 2020 2043 allcheck'. C │ │ │ │ │ -00011d30: 6865 636b 2074 6865 2070 6163 6b61 6765 heck the package │ │ │ │ │ -00011d40: 2028 2a6e 6f74 6520 5465 7374 733a 3a29 (*note Tests::) │ │ │ │ │ -00011d50: 2e0a 0a27 6d6f 7374 6c79 636c 6561 6e27 ...'mostlyclean' │ │ │ │ │ -00011d60: 0a27 636c 6561 6e27 0a27 6469 7374 636c .'clean'.'distcl │ │ │ │ │ -00011d70: 6561 6e27 0a27 6d61 696e 7461 696e 6572 ean'.'maintainer │ │ │ │ │ -00011d80: 2d63 6c65 616e 270a 2020 2020 2043 6c65 -clean'. Cle │ │ │ │ │ -00011d90: 616e 696e 6720 7275 6c65 7320 282a 6e6f aning rules (*no │ │ │ │ │ -00011da0: 7465 2043 6c65 616e 3a3a 292e 0a0a 2764 te Clean::)...'d │ │ │ │ │ -00011db0: 7669 270a 2770 6466 270a 2770 7327 0a27 vi'.'pdf'.'ps'.' │ │ │ │ │ -00011dc0: 696e 666f 270a 2768 746d 6c27 0a20 2020 info'.'html'. │ │ │ │ │ -00011dd0: 2020 4275 696c 6420 7468 6520 646f 6375 Build the docu │ │ │ │ │ -00011de0: 6d65 6e74 6174 696f 6e20 696e 2076 6172 mentation in var │ │ │ │ │ -00011df0: 696f 7573 2066 6f72 6d61 7473 2028 2a6e ious formats (*n │ │ │ │ │ -00011e00: 6f74 6520 5465 7869 6e66 6f3a 3a29 2e0a ote Texinfo::).. │ │ │ │ │ -00011e10: 0a27 7461 6773 270a 2763 7461 6773 270a .'tags'.'ctags'. │ │ │ │ │ -00011e20: 2020 2020 2042 7569 6c64 2027 5441 4753 Build 'TAGS │ │ │ │ │ -00011e30: 2720 616e 6420 2743 5441 4753 2720 282a ' and 'CTAGS' (* │ │ │ │ │ -00011e40: 6e6f 7465 2054 6167 733a 3a29 2e0a 0a20 note Tags::)... │ │ │ │ │ -00011e50: 2020 4966 2079 6f75 2068 6176 6520 6576 If you have ev │ │ │ │ │ -00011e60: 6572 2075 7365 6420 4765 7474 6578 7420 er used Gettext │ │ │ │ │ -00011e70: 696e 2061 2070 726f 6a65 6374 2c20 7468 in a project, th │ │ │ │ │ -00011e80: 6973 2069 7320 6120 676f 6f64 2065 7861 is is a good exa │ │ │ │ │ -00011e90: 6d70 6c65 206f 660a 686f 7720 7468 6972 mple of.how thir │ │ │ │ │ -00011ea0: 642d 7061 7274 7920 274d 616b 6566 696c d-party 'Makefil │ │ │ │ │ -00011eb0: 6527 7320 6361 6e20 6265 2075 7365 6420 e's can be used │ │ │ │ │ -00011ec0: 7769 7468 2041 7574 6f6d 616b 652e 2020 with Automake. │ │ │ │ │ -00011ed0: 5468 6520 274d 616b 6566 696c 6527 730a The 'Makefile's. │ │ │ │ │ -00011ee0: 2767 6574 7465 7874 697a 6527 2070 7574 'gettextize' put │ │ │ │ │ -00011ef0: 7320 696e 2074 6865 2027 706f 2f27 2061 s in the 'po/' a │ │ │ │ │ -00011f00: 6e64 2027 696e 746c 2f27 2064 6972 6563 nd 'intl/' direc │ │ │ │ │ -00011f10: 746f 7269 6573 2061 7265 2068 616e 6477 tories are handw │ │ │ │ │ -00011f20: 7269 7474 656e 0a27 4d61 6b65 6669 6c65 ritten.'Makefile │ │ │ │ │ -00011f30: 2773 2074 6861 7420 696d 706c 656d 656e 's that implemen │ │ │ │ │ -00011f40: 7420 616c 6c20 7468 6573 6520 7461 7267 t all these targ │ │ │ │ │ -00011f50: 6574 732e 2020 5468 6174 2077 6179 2074 ets. That way t │ │ │ │ │ -00011f60: 6865 7920 6361 6e20 6265 0a61 6464 6564 hey can be.added │ │ │ │ │ -00011f70: 2074 6f20 2753 5542 4449 5253 2720 696e to 'SUBDIRS' in │ │ │ │ │ -00011f80: 2041 7574 6f6d 616b 6520 7061 636b 6167 Automake packag │ │ │ │ │ -00011f90: 6573 2e0a 0a20 2020 4469 7265 6374 6f72 es... Director │ │ │ │ │ -00011fa0: 6965 7320 7468 6174 2061 7265 206f 6e6c ies that are onl │ │ │ │ │ -00011fb0: 7920 6c69 7374 6564 2069 6e20 2744 4953 y listed in 'DIS │ │ │ │ │ -00011fc0: 545f 5355 4244 4952 5327 2062 7574 206e T_SUBDIRS' but n │ │ │ │ │ -00011fd0: 6f74 2069 6e0a 2753 5542 4449 5253 2720 ot in.'SUBDIRS' │ │ │ │ │ -00011fe0: 6e65 6564 206f 6e6c 7920 7468 6520 2764 need only the 'd │ │ │ │ │ -00011ff0: 6973 7463 6c65 616e 272c 2027 6d61 696e istclean', 'main │ │ │ │ │ -00012000: 7461 696e 6572 2d63 6c65 616e 272c 2061 tainer-clean', a │ │ │ │ │ -00012010: 6e64 2027 6469 7374 6469 7227 0a72 756c nd 'distdir'.rul │ │ │ │ │ -00012020: 6573 2028 2a6e 6f74 6520 436f 6e64 6974 es (*note Condit │ │ │ │ │ -00012030: 696f 6e61 6c20 5375 6264 6972 6563 746f ional Subdirecto │ │ │ │ │ -00012040: 7269 6573 3a3a 292e 0a0a 2020 2055 7375 ries::)... Usu │ │ │ │ │ -00012050: 616c 6c79 2c20 6d61 6e79 206f 6620 7468 ally, many of th │ │ │ │ │ -00012060: 6573 6520 7275 6c65 7320 6172 6520 6972 ese rules are ir │ │ │ │ │ -00012070: 7265 6c65 7661 6e74 2074 6f20 7468 6520 relevant to the │ │ │ │ │ -00012080: 7468 6972 642d 7061 7274 790a 7375 6270 third-party.subp │ │ │ │ │ -00012090: 726f 6a65 6374 2c20 6275 7420 7468 6579 roject, but they │ │ │ │ │ -000120a0: 2061 7265 2072 6571 7569 7265 6420 666f are required fo │ │ │ │ │ -000120b0: 7220 7468 6520 7768 6f6c 6520 7061 636b r the whole pack │ │ │ │ │ -000120c0: 6167 6520 746f 2077 6f72 6b2e 2020 4974 age to work. It │ │ │ │ │ -000120d0: 2773 0a4f 4b20 746f 2068 6176 6520 6120 's.OK to have a │ │ │ │ │ -000120e0: 7275 6c65 2074 6861 7420 646f 6573 206e rule that does n │ │ │ │ │ -000120f0: 6f74 6869 6e67 2c20 736f 2069 6620 796f othing, so if yo │ │ │ │ │ -00012100: 7520 6172 6520 696e 7465 6772 6174 696e u are integratin │ │ │ │ │ -00012110: 6720 610a 7468 6972 642d 7061 7274 7920 g a.third-party │ │ │ │ │ -00012120: 7072 6f6a 6563 7420 7769 7468 206e 6f20 project with no │ │ │ │ │ -00012130: 646f 6375 6d65 6e74 6174 696f 6e20 6f72 documentation or │ │ │ │ │ -00012140: 2074 6167 2073 7570 706f 7274 2c20 796f tag support, yo │ │ │ │ │ -00012150: 7520 636f 756c 640a 7369 6d70 6c79 2061 u could.simply a │ │ │ │ │ -00012160: 7567 6d65 6e74 2069 7473 2027 4d61 6b65 ugment its 'Make │ │ │ │ │ -00012170: 6669 6c65 2720 6173 2066 6f6c 6c6f 7773 file' as follows │ │ │ │ │ -00012180: 3a0a 0a20 2020 2020 454d 5054 595f 4155 :.. EMPTY_AU │ │ │ │ │ -00012190: 544f 4d41 4b45 5f54 4152 4745 5453 203d TOMAKE_TARGETS = │ │ │ │ │ -000121a0: 2064 7669 2070 6466 2070 7320 696e 666f dvi pdf ps info │ │ │ │ │ -000121b0: 2068 746d 6c20 7461 6773 2063 7461 6773 html tags ctags │ │ │ │ │ -000121c0: 0a20 2020 2020 2e50 484f 4e59 3a20 2428 . .PHONY: $( │ │ │ │ │ -000121d0: 454d 5054 595f 4155 544f 4d41 4b45 5f54 EMPTY_AUTOMAKE_T │ │ │ │ │ -000121e0: 4152 4745 5453 290a 2020 2020 2024 2845 ARGETS). $(E │ │ │ │ │ -000121f0: 4d50 5459 5f41 5554 4f4d 414b 455f 5441 MPTY_AUTOMAKE_TA │ │ │ │ │ -00012200: 5247 4554 5329 3a0a 0a20 2020 416e 6f74 RGETS):.. Anot │ │ │ │ │ -00012210: 6865 7220 6173 7065 6374 206f 6620 696e her aspect of in │ │ │ │ │ -00012220: 7465 6772 6174 696e 6720 7468 6972 642d tegrating third- │ │ │ │ │ -00012230: 7061 7274 7920 6275 696c 6420 7379 7374 party build syst │ │ │ │ │ -00012240: 656d 7320 6973 2077 6865 7468 6572 0a74 ems is whether.t │ │ │ │ │ -00012250: 6865 7920 7375 7070 6f72 7420 5650 4154 hey support VPAT │ │ │ │ │ -00012260: 4820 6275 696c 6473 2028 2a6e 6f74 6520 H builds (*note │ │ │ │ │ -00012270: 5650 4154 4820 4275 696c 6473 3a3a 292e VPATH Builds::). │ │ │ │ │ -00012280: 2020 4f62 7669 6f75 736c 7920 6966 2074 Obviously if t │ │ │ │ │ -00012290: 6865 0a73 7562 7061 636b 6167 6520 646f he.subpackage do │ │ │ │ │ -000122a0: 6573 206e 6f74 2073 7570 706f 7274 2056 es not support V │ │ │ │ │ -000122b0: 5041 5448 2062 7569 6c64 7320 7468 6520 PATH builds the │ │ │ │ │ -000122c0: 7768 6f6c 6520 7061 636b 6167 6520 7769 whole package wi │ │ │ │ │ -000122d0: 6c6c 206e 6f74 0a73 7570 706f 7274 2056 ll not.support V │ │ │ │ │ -000122e0: 5041 5448 2062 7569 6c64 732e 2020 5468 PATH builds. Th │ │ │ │ │ -000122f0: 6973 2069 6e20 7475 726e 7320 6d65 616e is in turns mean │ │ │ │ │ -00012300: 7320 7468 6174 2027 6d61 6b65 2064 6973 s that 'make dis │ │ │ │ │ -00012310: 7463 6865 636b 2720 7769 6c6c 0a6e 6f74 tcheck' will.not │ │ │ │ │ -00012320: 2077 6f72 6b2c 2062 6563 6175 7365 2069 work, because i │ │ │ │ │ -00012330: 7420 7265 6c69 6573 206f 6e20 5650 4154 t relies on VPAT │ │ │ │ │ -00012340: 4820 6275 696c 6473 2e20 2053 6f6d 6520 H builds. Some │ │ │ │ │ -00012350: 7065 6f70 6c65 2063 616e 206c 6976 650a people can live. │ │ │ │ │ -00012360: 7769 7468 6f75 7420 7468 6973 2028 6163 without this (ac │ │ │ │ │ -00012370: 7475 616c 6c79 2c20 6d61 6e79 2041 7574 tually, many Aut │ │ │ │ │ -00012380: 6f6d 616b 6520 7573 6572 7320 6861 7665 omake users have │ │ │ │ │ -00012390: 206e 6576 6572 2068 6561 7264 206f 6620 never heard of │ │ │ │ │ -000123a0: 276d 616b 650a 6469 7374 6368 6563 6b27 'make.distcheck' │ │ │ │ │ -000123b0: 292e 2020 4f74 6865 7220 7065 6f70 6c65 ). Other people │ │ │ │ │ -000123c0: 206d 6179 2070 7265 6665 7220 746f 2072 may prefer to r │ │ │ │ │ -000123d0: 6576 616d 7020 7468 6520 6578 6973 7469 evamp the existi │ │ │ │ │ -000123e0: 6e67 2027 4d61 6b65 6669 6c65 2773 0a74 ng 'Makefile's.t │ │ │ │ │ -000123f0: 6f20 7375 7070 6f72 7420 5650 4154 482e o support VPATH. │ │ │ │ │ -00012400: 2020 446f 696e 6720 736f 2064 6f65 7320 Doing so does │ │ │ │ │ -00012410: 6e6f 7420 6e65 6365 7373 6172 696c 7920 not necessarily │ │ │ │ │ -00012420: 7265 7175 6972 6520 4175 746f 6d61 6b65 require Automake │ │ │ │ │ -00012430: 2c20 6f6e 6c79 0a41 7574 6f63 6f6e 6620 , only.Autoconf │ │ │ │ │ -00012440: 6973 206e 6565 6465 6420 282a 6e6f 7465 is needed (*note │ │ │ │ │ -00012450: 2042 7569 6c64 2044 6972 6563 746f 7269 Build Directori │ │ │ │ │ -00012460: 6573 3a20 2861 7574 6f63 6f6e 6629 4275 es: (autoconf)Bu │ │ │ │ │ -00012470: 696c 640a 4469 7265 6374 6f72 6965 732e ild.Directories. │ │ │ │ │ -00012480: 292e 2020 5468 6520 6e65 6365 7373 6172 ). The necessar │ │ │ │ │ -00012490: 7920 7375 6273 7469 7475 7469 6f6e 733a y substitutions: │ │ │ │ │ -000124a0: 2027 4073 7263 6469 7240 272c 2027 4074 '@srcdir@', '@t │ │ │ │ │ -000124b0: 6f70 5f73 7263 6469 7240 272c 0a61 6e64 op_srcdir@',.and │ │ │ │ │ -000124c0: 2027 4074 6f70 5f62 7569 6c64 6469 7240 '@top_builddir@ │ │ │ │ │ -000124d0: 2720 6172 6520 6465 6669 6e65 6420 6279 ' are defined by │ │ │ │ │ -000124e0: 2027 636f 6e66 6967 7572 6527 2077 6865 'configure' whe │ │ │ │ │ -000124f0: 6e20 6974 2070 726f 6365 7373 6573 2061 n it processes a │ │ │ │ │ -00012500: 0a27 4d61 6b65 6669 6c65 2720 282a 6e6f .'Makefile' (*no │ │ │ │ │ -00012510: 7465 2050 7265 7365 7420 4f75 7470 7574 te Preset Output │ │ │ │ │ -00012520: 2056 6172 6961 626c 6573 3a20 2861 7574 Variables: (aut │ │ │ │ │ -00012530: 6f63 6f6e 6629 5072 6573 6574 204f 7574 oconf)Preset Out │ │ │ │ │ -00012540: 7075 740a 5661 7269 6162 6c65 732e 292c put.Variables.), │ │ │ │ │ -00012550: 2074 6865 7920 6172 6520 6e6f 7420 636f they are not co │ │ │ │ │ -00012560: 6d70 7574 6564 2062 7920 7468 6520 4d61 mputed by the Ma │ │ │ │ │ -00012570: 6b65 6669 6c65 206c 696b 6520 7468 650a kefile like the. │ │ │ │ │ -00012580: 6166 6f72 656d 656e 7469 6f6e 6564 2027 aforementioned ' │ │ │ │ │ -00012590: 2428 6469 7374 6469 7229 2720 616e 6420 $(distdir)' and │ │ │ │ │ -000125a0: 2724 2874 6f70 5f64 6973 7464 6972 2927 '$(top_distdir)' │ │ │ │ │ -000125b0: 2076 6172 6961 626c 6573 2e0a 0a20 2020 variables... │ │ │ │ │ -000125c0: 4974 2069 7320 736f 6d65 7469 6d65 7320 It is sometimes │ │ │ │ │ -000125d0: 696e 636f 6e76 656e 6965 6e74 2074 6f20 inconvenient to │ │ │ │ │ -000125e0: 6d6f 6469 6679 2061 2074 6869 7264 2d70 modify a third-p │ │ │ │ │ -000125f0: 6172 7479 2027 4d61 6b65 6669 6c65 2720 arty 'Makefile' │ │ │ │ │ -00012600: 746f 0a69 6e74 726f 6475 6365 2074 6865 to.introduce the │ │ │ │ │ -00012610: 2061 626f 7665 2072 6571 7569 7265 6420 above required │ │ │ │ │ -00012620: 7461 7267 6574 732e 2020 466f 7220 696e targets. For in │ │ │ │ │ -00012630: 7374 616e 6365 2c20 6f6e 6520 6d61 7920 stance, one may │ │ │ │ │ -00012640: 7761 6e74 2074 6f0a 6b65 6570 2074 6865 want to.keep the │ │ │ │ │ -00012650: 2074 6869 7264 2d70 6172 7479 2073 6f75 third-party sou │ │ │ │ │ -00012660: 7263 6573 2075 6e74 6f75 6368 6564 2074 rces untouched t │ │ │ │ │ -00012670: 6f20 6561 7365 2075 7067 7261 6465 7320 o ease upgrades │ │ │ │ │ -00012680: 746f 206e 6577 2076 6572 7369 6f6e 732e to new versions. │ │ │ │ │ -00012690: 0a0a 2020 2048 6572 6520 6172 6520 7477 .. Here are tw │ │ │ │ │ -000126a0: 6f20 6f74 6865 7220 6964 6561 732e 2020 o other ideas. │ │ │ │ │ -000126b0: 4966 2047 4e55 206d 616b 6520 6973 2061 If GNU make is a │ │ │ │ │ -000126c0: 7373 756d 6564 2c20 6f6e 6520 706f 7373 ssumed, one poss │ │ │ │ │ -000126d0: 6962 696c 6974 7920 6973 0a74 6f20 6164 ibility is.to ad │ │ │ │ │ -000126e0: 6420 746f 2074 6861 7420 7375 6264 6972 d to that subdir │ │ │ │ │ -000126f0: 6563 746f 7279 2061 2027 474e 556d 616b ectory a 'GNUmak │ │ │ │ │ -00012700: 6566 696c 6527 2074 6861 7420 6465 6669 efile' that defi │ │ │ │ │ -00012710: 6e65 7320 7468 6520 7265 7175 6972 6564 nes the required │ │ │ │ │ -00012720: 0a74 6172 6765 7473 2061 6e64 2069 6e63 .targets and inc │ │ │ │ │ -00012730: 6c75 6465 7320 7468 6520 7468 6972 642d ludes the third- │ │ │ │ │ -00012740: 7061 7274 7920 274d 616b 6566 696c 6527 party 'Makefile' │ │ │ │ │ -00012750: 2e20 2046 6f72 2074 6869 7320 746f 2077 . For this to w │ │ │ │ │ -00012760: 6f72 6b20 696e 0a56 5041 5448 2062 7569 ork in.VPATH bui │ │ │ │ │ -00012770: 6c64 732c 2027 474e 556d 616b 6566 696c lds, 'GNUmakefil │ │ │ │ │ -00012780: 6527 206d 7573 7420 6c69 6520 696e 2074 e' must lie in t │ │ │ │ │ -00012790: 6865 2062 7569 6c64 2064 6972 6563 746f he build directo │ │ │ │ │ -000127a0: 7279 3b20 7468 6520 6561 7369 6573 740a ry; the easiest. │ │ │ │ │ -000127b0: 7761 7920 746f 2064 6f20 7468 6973 2069 way to do this i │ │ │ │ │ -000127c0: 7320 746f 2077 7269 7465 2061 2027 474e s to write a 'GN │ │ │ │ │ -000127d0: 556d 616b 6566 696c 652e 696e 2720 696e Umakefile.in' in │ │ │ │ │ -000127e0: 7374 6561 642c 2061 6e64 2068 6176 6520 stead, and have │ │ │ │ │ -000127f0: 6974 0a70 726f 6365 7373 6564 2077 6974 it.processed wit │ │ │ │ │ -00012800: 6820 2741 435f 434f 4e46 4947 5f46 494c h 'AC_CONFIG_FIL │ │ │ │ │ -00012810: 4553 2720 6672 6f6d 2074 6865 206f 7574 ES' from the out │ │ │ │ │ -00012820: 6572 2070 6163 6b61 6765 2e20 2046 6f72 er package. For │ │ │ │ │ -00012830: 2065 7861 6d70 6c65 2069 660a 7765 2061 example if.we a │ │ │ │ │ -00012840: 7373 756d 6520 274d 616b 6566 696c 6527 ssume 'Makefile' │ │ │ │ │ -00012850: 2064 6566 696e 6573 2061 6c6c 2074 6172 defines all tar │ │ │ │ │ -00012860: 6765 7473 2065 7863 6570 7420 7468 6520 gets except the │ │ │ │ │ -00012870: 646f 6375 6d65 6e74 6174 696f 6e0a 7461 documentation.ta │ │ │ │ │ -00012880: 7267 6574 732c 2061 6e64 2074 6861 7420 rgets, and that │ │ │ │ │ -00012890: 7468 6520 2763 6865 636b 2720 7461 7267 the 'check' targ │ │ │ │ │ -000128a0: 6574 2069 7320 6163 7475 616c 6c79 2063 et is actually c │ │ │ │ │ -000128b0: 616c 6c65 6420 2774 6573 7427 2c20 7765 alled 'test', we │ │ │ │ │ -000128c0: 2063 6f75 6c64 0a77 7269 7465 2027 474e could.write 'GN │ │ │ │ │ -000128d0: 556d 616b 6566 696c 6527 2028 6f72 2027 Umakefile' (or ' │ │ │ │ │ -000128e0: 474e 556d 616b 6566 696c 652e 696e 2729 GNUmakefile.in') │ │ │ │ │ -000128f0: 206c 696b 6520 7468 6973 3a0a 0a20 2020 like this:.. │ │ │ │ │ -00012900: 2020 2320 4669 7273 742c 2069 6e63 6c75 # First, inclu │ │ │ │ │ -00012910: 6465 2074 6865 2072 6561 6c20 4d61 6b65 de the real Make │ │ │ │ │ -00012920: 6669 6c65 0a20 2020 2020 696e 636c 7564 file. includ │ │ │ │ │ -00012930: 6520 4d61 6b65 6669 6c65 0a20 2020 2020 e Makefile. │ │ │ │ │ -00012940: 2320 5468 656e 2c20 6465 6669 6e65 2074 # Then, define t │ │ │ │ │ -00012950: 6865 206f 7468 6572 2074 6172 6765 7473 he other targets │ │ │ │ │ -00012960: 206e 6565 6465 6420 6279 2041 7574 6f6d needed by Autom │ │ │ │ │ -00012970: 616b 6520 4d61 6b65 6669 6c65 732e 0a20 ake Makefiles.. │ │ │ │ │ -00012980: 2020 2020 2e50 484f 4e59 3a20 6476 6920 .PHONY: dvi │ │ │ │ │ -00012990: 7064 6620 7073 2069 6e66 6f20 6874 6d6c pdf ps info html │ │ │ │ │ -000129a0: 2063 6865 636b 0a20 2020 2020 6476 6920 check. dvi │ │ │ │ │ -000129b0: 7064 6620 7073 2069 6e66 6f20 6874 6d6c pdf ps info html │ │ │ │ │ -000129c0: 3a0a 2020 2020 2063 6865 636b 3a20 7465 :. check: te │ │ │ │ │ -000129d0: 7374 0a0a 2020 2041 2073 696d 696c 6172 st.. A similar │ │ │ │ │ -000129e0: 2069 6465 6120 7468 6174 2064 6f65 7320 idea that does │ │ │ │ │ -000129f0: 6e6f 7420 7573 6520 2769 6e63 6c75 6465 not use 'include │ │ │ │ │ -00012a00: 2720 6973 2074 6f20 7772 6974 6520 6120 ' is to write a │ │ │ │ │ -00012a10: 7072 6f78 790a 274d 616b 6566 696c 6527 proxy.'Makefile' │ │ │ │ │ -00012a20: 2074 6861 7420 6469 7370 6174 6368 6573 that dispatches │ │ │ │ │ -00012a30: 2072 756c 6573 2074 6f20 7468 6520 7265 rules to the re │ │ │ │ │ -00012a40: 616c 2027 4d61 6b65 6669 6c65 272c 2065 al 'Makefile', e │ │ │ │ │ -00012a50: 6974 6865 7220 7769 7468 0a27 2428 4d41 ither with.'$(MA │ │ │ │ │ -00012a60: 4b45 2920 2d66 204d 616b 6566 696c 652e KE) -f Makefile. │ │ │ │ │ -00012a70: 7265 616c 2024 2841 4d5f 4d41 4b45 464c real $(AM_MAKEFL │ │ │ │ │ -00012a80: 4147 5329 2074 6172 6765 7427 2028 6966 AGS) target' (if │ │ │ │ │ -00012a90: 2069 7427 7320 4f4b 2074 6f20 7265 6e61 it's OK to rena │ │ │ │ │ -00012aa0: 6d65 0a74 6865 206f 7269 6769 6e61 6c20 me.the original │ │ │ │ │ -00012ab0: 274d 616b 6566 696c 6527 2920 6f72 2077 'Makefile') or w │ │ │ │ │ -00012ac0: 6974 6820 2763 6420 7375 6264 6972 2026 ith 'cd subdir & │ │ │ │ │ -00012ad0: 2620 2428 4d41 4b45 2920 2428 414d 5f4d & $(MAKE) $(AM_M │ │ │ │ │ -00012ae0: 414b 4546 4c41 4753 290a 7461 7267 6574 AKEFLAGS).target │ │ │ │ │ -00012af0: 2720 2869 6620 6974 2773 204f 4b20 746f ' (if it's OK to │ │ │ │ │ -00012b00: 2073 746f 7265 2074 6865 2073 7562 6469 store the subdi │ │ │ │ │ -00012b10: 7265 6374 6f72 7920 7072 6f6a 6563 7420 rectory project │ │ │ │ │ -00012b20: 6f6e 6520 6469 7265 6374 6f72 790a 6465 one directory.de │ │ │ │ │ -00012b30: 6570 6572 292e 2020 5468 6520 676f 6f64 eper). The good │ │ │ │ │ -00012b40: 206e 6577 7320 6973 2074 6861 7420 7468 news is that th │ │ │ │ │ -00012b50: 6973 2070 726f 7879 2027 4d61 6b65 6669 is proxy 'Makefi │ │ │ │ │ -00012b60: 6c65 2720 6361 6e20 6265 2067 656e 6572 le' can be gener │ │ │ │ │ -00012b70: 6174 6564 0a77 6974 6820 4175 746f 6d61 ated.with Automa │ │ │ │ │ -00012b80: 6b65 2e20 2041 6c6c 2077 6520 6e65 6564 ke. All we need │ │ │ │ │ -00012b90: 2061 7265 2027 2d6c 6f63 616c 2720 7461 are '-local' ta │ │ │ │ │ -00012ba0: 7267 6574 7320 282a 6e6f 7465 2045 7874 rgets (*note Ext │ │ │ │ │ -00012bb0: 656e 6469 6e67 3a3a 290a 7468 6174 2070 ending::).that p │ │ │ │ │ -00012bc0: 6572 666f 726d 2074 6865 2064 6973 7061 erform the dispa │ │ │ │ │ -00012bd0: 7463 682e 2020 4f66 2063 6f75 7273 6520 tch. Of course │ │ │ │ │ -00012be0: 7468 6520 6f74 6865 7220 4175 746f 6d61 the other Automa │ │ │ │ │ -00012bf0: 6b65 2066 6561 7475 7265 7320 6172 650a ke features are. │ │ │ │ │ -00012c00: 6176 6169 6c61 626c 652c 2073 6f20 796f available, so yo │ │ │ │ │ -00012c10: 7520 636f 756c 6420 6465 6369 6465 2074 u could decide t │ │ │ │ │ -00012c20: 6f20 6c65 7420 4175 746f 6d61 6b65 2070 o let Automake p │ │ │ │ │ -00012c30: 6572 666f 726d 2064 6973 7472 6962 7574 erform distribut │ │ │ │ │ -00012c40: 696f 6e20 6f72 0a69 6e73 7461 6c6c 6174 ion or.installat │ │ │ │ │ -00012c50: 696f 6e2e 2020 4865 7265 2069 7320 6120 ion. Here is a │ │ │ │ │ -00012c60: 706f 7373 6962 6c65 2027 4d61 6b65 6669 possible 'Makefi │ │ │ │ │ -00012c70: 6c65 2e61 6d27 3a0a 0a20 2020 2020 616c le.am':.. al │ │ │ │ │ -00012c80: 6c2d 6c6f 6361 6c3a 0a20 2020 2020 2020 l-local:. │ │ │ │ │ -00012c90: 2020 2020 2020 6364 2073 7562 6469 7220 cd subdir │ │ │ │ │ -00012ca0: 2626 2024 284d 414b 4529 2024 2841 4d5f && $(MAKE) $(AM_ │ │ │ │ │ -00012cb0: 4d41 4b45 464c 4147 5329 2061 6c6c 0a20 MAKEFLAGS) all. │ │ │ │ │ -00012cc0: 2020 2020 6368 6563 6b2d 6c6f 6361 6c3a check-local: │ │ │ │ │ -00012cd0: 0a20 2020 2020 2020 2020 2020 2020 6364 . cd │ │ │ │ │ -00012ce0: 2073 7562 6469 7220 2626 2024 284d 414b subdir && $(MAK │ │ │ │ │ -00012cf0: 4529 2024 2841 4d5f 4d41 4b45 464c 4147 E) $(AM_MAKEFLAG │ │ │ │ │ -00012d00: 5329 2074 6573 740a 2020 2020 2063 6c65 S) test. cle │ │ │ │ │ -00012d10: 616e 2d6c 6f63 616c 3a0a 2020 2020 2020 an-local:. │ │ │ │ │ -00012d20: 2020 2020 2020 2063 6420 7375 6264 6972 cd subdir │ │ │ │ │ -00012d30: 2026 2620 2428 4d41 4b45 2920 2428 414d && $(MAKE) $(AM │ │ │ │ │ -00012d40: 5f4d 414b 4546 4c41 4753 2920 636c 6561 _MAKEFLAGS) clea │ │ │ │ │ -00012d50: 6e0a 0a20 2020 2020 2320 4173 7375 6d69 n.. # Assumi │ │ │ │ │ -00012d60: 6e67 2074 6865 2070 6163 6b61 6765 206b ng the package k │ │ │ │ │ -00012d70: 6e6f 7773 2068 6f77 2074 6f20 696e 7374 nows how to inst │ │ │ │ │ -00012d80: 616c 6c20 6974 7365 6c66 0a20 2020 2020 all itself. │ │ │ │ │ -00012d90: 696e 7374 616c 6c2d 6461 7461 2d6c 6f63 install-data-loc │ │ │ │ │ -00012da0: 616c 3a0a 2020 2020 2020 2020 2020 2020 al:. │ │ │ │ │ -00012db0: 2063 6420 7375 6264 6972 2026 2620 2428 cd subdir && $( │ │ │ │ │ -00012dc0: 4d41 4b45 2920 2428 414d 5f4d 414b 4546 MAKE) $(AM_MAKEF │ │ │ │ │ -00012dd0: 4c41 4753 2920 696e 7374 616c 6c2d 6461 LAGS) install-da │ │ │ │ │ -00012de0: 7461 0a20 2020 2020 696e 7374 616c 6c2d ta. install- │ │ │ │ │ -00012df0: 6578 6563 2d6c 6f63 616c 3a0a 2020 2020 exec-local:. │ │ │ │ │ -00012e00: 2020 2020 2020 2020 2063 6420 7375 6264 cd subd │ │ │ │ │ -00012e10: 6972 2026 2620 2428 4d41 4b45 2920 2428 ir && $(MAKE) $( │ │ │ │ │ -00012e20: 414d 5f4d 414b 4546 4c41 4753 2920 696e AM_MAKEFLAGS) in │ │ │ │ │ -00012e30: 7374 616c 6c2d 6578 6563 0a20 2020 2020 stall-exec. │ │ │ │ │ -00012e40: 756e 696e 7374 616c 6c2d 6c6f 6361 6c3a uninstall-local: │ │ │ │ │ -00012e50: 0a20 2020 2020 2020 2020 2020 2020 6364 . cd │ │ │ │ │ -00012e60: 2073 7562 6469 7220 2626 2024 284d 414b subdir && $(MAK │ │ │ │ │ -00012e70: 4529 2024 2841 4d5f 4d41 4b45 464c 4147 E) $(AM_MAKEFLAG │ │ │ │ │ -00012e80: 5329 2075 6e69 6e73 7461 6c6c 0a0a 2020 S) uninstall.. │ │ │ │ │ -00012e90: 2020 2023 2044 6973 7472 6962 7574 6520 # Distribute │ │ │ │ │ -00012ea0: 6669 6c65 7320 6672 6f6d 2068 6572 652e files from here. │ │ │ │ │ -00012eb0: 0a20 2020 2020 4558 5452 415f 4449 5354 . EXTRA_DIST │ │ │ │ │ -00012ec0: 203d 2073 7562 6469 722f 4d61 6b65 6669 = subdir/Makefi │ │ │ │ │ -00012ed0: 6c65 2073 7562 6469 722f 7072 6f67 7261 le subdir/progra │ │ │ │ │ -00012ee0: 6d2e 6320 2e2e 2e0a 0a20 2020 5075 7368 m.c ..... Push │ │ │ │ │ -00012ef0: 696e 6720 7468 6973 2069 6465 6120 746f ing this idea to │ │ │ │ │ -00012f00: 2074 6865 2065 7874 7265 6d65 2c20 6974 the extreme, it │ │ │ │ │ -00012f10: 2069 7320 616c 736f 2070 6f73 7369 626c is also possibl │ │ │ │ │ -00012f20: 6520 746f 2069 676e 6f72 6520 7468 650a e to ignore the. │ │ │ │ │ -00012f30: 7375 6270 726f 6a65 6374 2062 7569 6c64 subproject build │ │ │ │ │ -00012f40: 2073 7973 7465 6d20 616e 6420 6275 696c system and buil │ │ │ │ │ -00012f50: 6420 6576 6572 7974 6869 6e67 2066 726f d everything fro │ │ │ │ │ -00012f60: 6d20 7468 6973 2070 726f 7879 0a27 4d61 m this proxy.'Ma │ │ │ │ │ -00012f70: 6b65 6669 6c65 2e61 6d27 2e20 2054 6869 kefile.am'. Thi │ │ │ │ │ -00012f80: 7320 6d69 6768 7420 736f 756e 6420 7665 s might sound ve │ │ │ │ │ -00012f90: 7279 2073 656e 7369 626c 6520 6966 2079 ry sensible if y │ │ │ │ │ -00012fa0: 6f75 206e 6565 6420 5650 4154 4820 6275 ou need VPATH bu │ │ │ │ │ -00012fb0: 696c 6473 0a62 7574 2074 6865 2073 7562 ilds.but the sub │ │ │ │ │ -00012fc0: 7072 6f6a 6563 7420 646f 6573 206e 6f74 project does not │ │ │ │ │ -00012fd0: 2073 7570 706f 7274 2074 6865 6d2e 0a0a support them... │ │ │ │ │ -00012fe0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -00012ff0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -00013000: 653a 2044 6973 7472 6962 7574 696e 672c e: Distributing, │ │ │ │ │ -00013010: 2020 4e65 7874 3a20 4150 4920 5665 7273 Next: API Vers │ │ │ │ │ -00013020: 696f 6e69 6e67 2c20 2050 7265 763a 204e ioning, Prev: N │ │ │ │ │ -00013030: 6f74 2045 6e6f 7567 682c 2020 5570 3a20 ot Enough, Up: │ │ │ │ │ -00013040: 546f 700a 0a32 3520 4469 7374 7269 6275 Top..25 Distribu │ │ │ │ │ -00013050: 7469 6e67 2027 4d61 6b65 6669 6c65 2e69 ting 'Makefile.i │ │ │ │ │ -00013060: 6e27 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a n's.************ │ │ │ │ │ +000116b0: 3d3d 3d3d 3d3d 3d0a 0a49 6e20 6d6f 7374 =======..In most │ │ │ │ │ +000116c0: 2070 726f 6a65 6374 7320 616c 6c20 274d projects all 'M │ │ │ │ │ +000116d0: 616b 6566 696c 6527 7320 6172 6520 6765 akefile's are ge │ │ │ │ │ +000116e0: 6e65 7261 7465 6420 6279 2041 7574 6f6d nerated by Autom │ │ │ │ │ +000116f0: 616b 652e 2020 496e 2073 6f6d 650a 6361 ake. In some.ca │ │ │ │ │ +00011700: 7365 732c 2068 6f77 6576 6572 2c20 7072 ses, however, pr │ │ │ │ │ +00011710: 6f6a 6563 7473 206e 6565 6420 746f 2065 ojects need to e │ │ │ │ │ +00011720: 6d62 6564 2073 7562 6469 7265 6374 6f72 mbed subdirector │ │ │ │ │ +00011730: 6965 7320 7769 7468 2068 616e 6477 7269 ies with handwri │ │ │ │ │ +00011740: 7474 656e 0a27 4d61 6b65 6669 6c65 2773 tten.'Makefile's │ │ │ │ │ +00011750: 2e20 2046 6f72 2069 6e73 7461 6e63 652c . For instance, │ │ │ │ │ +00011760: 206f 6e65 2073 7562 6469 7265 6374 6f72 one subdirector │ │ │ │ │ +00011770: 7920 636f 756c 6420 6265 2061 2074 6869 y could be a thi │ │ │ │ │ +00011780: 7264 2d70 6172 7479 0a70 726f 6a65 6374 rd-party.project │ │ │ │ │ +00011790: 2077 6974 6820 6974 7320 6f77 6e20 6275 with its own bu │ │ │ │ │ +000117a0: 696c 6420 7379 7374 656d 2c20 6e6f 7420 ild system, not │ │ │ │ │ +000117b0: 7573 696e 6720 4175 746f 6d61 6b65 2e0a using Automake.. │ │ │ │ │ +000117c0: 0a20 2020 4974 2069 7320 706f 7373 6962 . It is possib │ │ │ │ │ +000117d0: 6c65 2074 6f20 6c69 7374 2061 7262 6974 le to list arbit │ │ │ │ │ +000117e0: 7261 7279 2064 6972 6563 746f 7269 6573 rary directories │ │ │ │ │ +000117f0: 2069 6e20 2753 5542 4449 5253 2720 6f72 in 'SUBDIRS' or │ │ │ │ │ +00011800: 0a27 4449 5354 5f53 5542 4449 5253 2720 .'DIST_SUBDIRS' │ │ │ │ │ +00011810: 7072 6f76 6964 6564 2065 6163 6820 6f66 provided each of │ │ │ │ │ +00011820: 2074 6865 7365 2064 6972 6563 746f 7269 these directori │ │ │ │ │ +00011830: 6573 2068 6173 2061 2027 4d61 6b65 6669 es has a 'Makefi │ │ │ │ │ +00011840: 6c65 2720 7468 6174 0a72 6563 6f67 6e69 le' that.recogni │ │ │ │ │ +00011850: 7a65 7320 616c 6c20 7468 6520 666f 6c6c zes all the foll │ │ │ │ │ +00011860: 6f77 696e 6720 7265 6375 7273 6976 6520 owing recursive │ │ │ │ │ +00011870: 7461 7267 6574 732e 0a0a 2020 2057 6865 targets... Whe │ │ │ │ │ +00011880: 6e20 6120 7573 6572 2072 756e 7320 6f6e n a user runs on │ │ │ │ │ +00011890: 6520 6f66 2074 6865 7365 2074 6172 6765 e of these targe │ │ │ │ │ +000118a0: 7473 2c20 7468 6174 2074 6172 6765 7420 ts, that target │ │ │ │ │ +000118b0: 6973 2072 756e 2072 6563 7572 7369 7665 is run recursive │ │ │ │ │ +000118c0: 6c79 0a69 6e20 616c 6c20 7375 6264 6972 ly.in all subdir │ │ │ │ │ +000118d0: 6563 746f 7269 6573 2e20 2054 6869 7320 ectories. This │ │ │ │ │ +000118e0: 6973 2077 6879 2069 7420 6973 2069 6d70 is why it is imp │ │ │ │ │ +000118f0: 6f72 7461 6e74 2074 6861 7420 6576 656e ortant that even │ │ │ │ │ +00011900: 0a74 6869 7264 2d70 6172 7479 2027 4d61 .third-party 'Ma │ │ │ │ │ +00011910: 6b65 6669 6c65 2773 2073 7570 706f 7274 kefile's support │ │ │ │ │ +00011920: 2074 6865 6d2e 0a0a 2761 6c6c 270a 2020 them...'all'. │ │ │ │ │ +00011930: 2020 2043 6f6d 7069 6c65 2074 6865 2065 Compile the e │ │ │ │ │ +00011940: 6e74 6972 6520 7061 636b 6167 652e 2020 ntire package. │ │ │ │ │ +00011950: 5468 6973 2069 7320 7468 6520 6465 6661 This is the defa │ │ │ │ │ +00011960: 756c 7420 7461 7267 6574 2069 6e0a 2020 ult target in. │ │ │ │ │ +00011970: 2020 2041 7574 6f6d 616b 652d 6765 6e65 Automake-gene │ │ │ │ │ +00011980: 7261 7465 6420 274d 616b 6566 696c 6527 rated 'Makefile' │ │ │ │ │ +00011990: 732c 2062 7574 2069 7420 646f 6573 206e s, but it does n │ │ │ │ │ +000119a0: 6f74 206e 6565 6420 746f 2062 6520 7468 ot need to be th │ │ │ │ │ +000119b0: 650a 2020 2020 2064 6566 6175 6c74 2069 e. default i │ │ │ │ │ +000119c0: 6e20 7468 6972 642d 7061 7274 7920 274d n third-party 'M │ │ │ │ │ +000119d0: 616b 6566 696c 6527 732e 0a0a 2764 6973 akefile's...'dis │ │ │ │ │ +000119e0: 7464 6972 270a 2020 2020 2043 6f70 7920 tdir'. Copy │ │ │ │ │ +000119f0: 6669 6c65 7320 746f 2064 6973 7472 6962 files to distrib │ │ │ │ │ +00011a00: 7574 6520 696e 746f 2027 2428 6469 7374 ute into '$(dist │ │ │ │ │ +00011a10: 6469 7229 272c 2062 6566 6f72 6520 6120 dir)', before a │ │ │ │ │ +00011a20: 7461 7262 616c 6c20 6973 0a20 2020 2020 tarball is. │ │ │ │ │ +00011a30: 636f 6e73 7472 7563 7465 642e 2020 4f66 constructed. Of │ │ │ │ │ +00011a40: 2063 6f75 7273 6520 7468 6973 2074 6172 course this tar │ │ │ │ │ +00011a50: 6765 7420 6973 206e 6f74 2072 6571 7569 get is not requi │ │ │ │ │ +00011a60: 7265 6420 6966 2074 6865 0a20 2020 2020 red if the. │ │ │ │ │ +00011a70: 276e 6f2d 6469 7374 2720 6f70 7469 6f6e 'no-dist' option │ │ │ │ │ +00011a80: 2028 2a6e 6f74 6520 4f70 7469 6f6e 733a (*note Options: │ │ │ │ │ +00011a90: 3a29 2069 7320 7573 6564 2e0a 0a20 2020 :) is used... │ │ │ │ │ +00011aa0: 2020 5468 6520 7661 7269 6162 6c65 7320 The variables │ │ │ │ │ +00011ab0: 2724 2874 6f70 5f64 6973 7464 6972 2927 '$(top_distdir)' │ │ │ │ │ +00011ac0: 2061 6e64 2027 2428 6469 7374 6469 7229 and '$(distdir) │ │ │ │ │ +00011ad0: 2720 282a 6e6f 7465 2054 6865 2064 6973 ' (*note The dis │ │ │ │ │ +00011ae0: 740a 2020 2020 2048 6f6f 6b3a 3a29 2077 t. Hook::) w │ │ │ │ │ +00011af0: 696c 6c20 6265 2070 6173 7365 6420 6672 ill be passed fr │ │ │ │ │ +00011b00: 6f6d 2074 6865 206f 7574 6572 2070 6163 om the outer pac │ │ │ │ │ +00011b10: 6b61 6765 2074 6f20 7468 6520 7375 6270 kage to the subp │ │ │ │ │ +00011b20: 6163 6b61 6765 0a20 2020 2020 7768 656e ackage. when │ │ │ │ │ +00011b30: 2074 6865 2027 6469 7374 6469 7227 2074 the 'distdir' t │ │ │ │ │ +00011b40: 6172 6765 7420 6973 2069 6e76 6f6b 6564 arget is invoked │ │ │ │ │ +00011b50: 2e20 2054 6865 7365 2074 776f 2076 6172 . These two var │ │ │ │ │ +00011b60: 6961 626c 6573 2068 6176 650a 2020 2020 iables have. │ │ │ │ │ +00011b70: 2062 6565 6e20 6164 6a75 7374 6564 2066 been adjusted f │ │ │ │ │ +00011b80: 6f72 2074 6865 2064 6972 6563 746f 7279 or the directory │ │ │ │ │ +00011b90: 2074 6861 7420 6973 2062 6569 6e67 2072 that is being r │ │ │ │ │ +00011ba0: 6563 7572 7365 6420 696e 746f 2c20 736f ecursed into, so │ │ │ │ │ +00011bb0: 0a20 2020 2020 7468 6579 2061 7265 2072 . they are r │ │ │ │ │ +00011bc0: 6561 6479 2074 6f20 7573 652e 0a0a 2769 eady to use...'i │ │ │ │ │ +00011bd0: 6e73 7461 6c6c 270a 2769 6e73 7461 6c6c nstall'.'install │ │ │ │ │ +00011be0: 2d64 6174 6127 0a27 696e 7374 616c 6c2d -data'.'install- │ │ │ │ │ +00011bf0: 6578 6563 270a 2775 6e69 6e73 7461 6c6c exec'.'uninstall │ │ │ │ │ +00011c00: 270a 2020 2020 2049 6e73 7461 6c6c 206f '. Install o │ │ │ │ │ +00011c10: 7220 756e 696e 7374 616c 6c20 6669 6c65 r uninstall file │ │ │ │ │ +00011c20: 7320 282a 6e6f 7465 2049 6e73 7461 6c6c s (*note Install │ │ │ │ │ +00011c30: 3a3a 292e 0a0a 2769 6e73 7461 6c6c 2d64 ::)...'install-d │ │ │ │ │ +00011c40: 7669 270a 2769 6e73 7461 6c6c 2d68 746d vi'.'install-htm │ │ │ │ │ +00011c50: 6c27 0a27 696e 7374 616c 6c2d 696e 666f l'.'install-info │ │ │ │ │ +00011c60: 270a 2769 6e73 7461 6c6c 2d70 7327 0a27 '.'install-ps'.' │ │ │ │ │ +00011c70: 696e 7374 616c 6c2d 7064 6627 0a20 2020 install-pdf'. │ │ │ │ │ +00011c80: 2020 496e 7374 616c 6c20 6f6e 6c79 2073 Install only s │ │ │ │ │ +00011c90: 6f6d 6520 7370 6563 6966 6963 2064 6f63 ome specific doc │ │ │ │ │ +00011ca0: 756d 656e 7461 7469 6f6e 2066 6f72 6d61 umentation forma │ │ │ │ │ +00011cb0: 7420 282a 6e6f 7465 2054 6578 696e 666f t (*note Texinfo │ │ │ │ │ +00011cc0: 3a3a 292e 0a0a 2769 6e73 7461 6c6c 6469 ::)...'installdi │ │ │ │ │ +00011cd0: 7273 270a 2020 2020 2043 7265 6174 6520 rs'. Create │ │ │ │ │ +00011ce0: 696e 7374 616c 6c20 6469 7265 6374 6f72 install director │ │ │ │ │ +00011cf0: 6965 732c 2062 7574 2064 6f20 6e6f 7420 ies, but do not │ │ │ │ │ +00011d00: 696e 7374 616c 6c20 616e 7920 6669 6c65 install any file │ │ │ │ │ +00011d10: 732e 0a0a 2763 6865 636b 270a 2769 6e73 s...'check'.'ins │ │ │ │ │ +00011d20: 7461 6c6c 6368 6563 6b27 0a20 2020 2020 tallcheck'. │ │ │ │ │ +00011d30: 4368 6563 6b20 7468 6520 7061 636b 6167 Check the packag │ │ │ │ │ +00011d40: 6520 282a 6e6f 7465 2054 6573 7473 3a3a e (*note Tests:: │ │ │ │ │ +00011d50: 292e 0a0a 276d 6f73 746c 7963 6c65 616e )...'mostlyclean │ │ │ │ │ +00011d60: 270a 2763 6c65 616e 270a 2764 6973 7463 '.'clean'.'distc │ │ │ │ │ +00011d70: 6c65 616e 270a 276d 6169 6e74 6169 6e65 lean'.'maintaine │ │ │ │ │ +00011d80: 722d 636c 6561 6e27 0a20 2020 2020 436c r-clean'. Cl │ │ │ │ │ +00011d90: 6561 6e69 6e67 2072 756c 6573 2028 2a6e eaning rules (*n │ │ │ │ │ +00011da0: 6f74 6520 436c 6561 6e3a 3a29 2e0a 0a27 ote Clean::)...' │ │ │ │ │ +00011db0: 6476 6927 0a27 7064 6627 0a27 7073 270a dvi'.'pdf'.'ps'. │ │ │ │ │ +00011dc0: 2769 6e66 6f27 0a27 6874 6d6c 270a 2020 'info'.'html'. │ │ │ │ │ +00011dd0: 2020 2042 7569 6c64 2074 6865 2064 6f63 Build the doc │ │ │ │ │ +00011de0: 756d 656e 7461 7469 6f6e 2069 6e20 7661 umentation in va │ │ │ │ │ +00011df0: 7269 6f75 7320 666f 726d 6174 7320 282a rious formats (* │ │ │ │ │ +00011e00: 6e6f 7465 2054 6578 696e 666f 3a3a 292e note Texinfo::). │ │ │ │ │ +00011e10: 0a0a 2774 6167 7327 0a27 6374 6167 7327 ..'tags'.'ctags' │ │ │ │ │ +00011e20: 0a20 2020 2020 4275 696c 6420 2754 4147 . Build 'TAG │ │ │ │ │ +00011e30: 5327 2061 6e64 2027 4354 4147 5327 2028 S' and 'CTAGS' ( │ │ │ │ │ +00011e40: 2a6e 6f74 6520 5461 6773 3a3a 292e 0a0a *note Tags::)... │ │ │ │ │ +00011e50: 2020 2049 6620 796f 7520 6861 7665 2065 If you have e │ │ │ │ │ +00011e60: 7665 7220 7573 6564 2047 6574 7465 7874 ver used Gettext │ │ │ │ │ +00011e70: 2069 6e20 6120 7072 6f6a 6563 742c 2074 in a project, t │ │ │ │ │ +00011e80: 6869 7320 6973 2061 2067 6f6f 6420 6578 his is a good ex │ │ │ │ │ +00011e90: 616d 706c 6520 6f66 0a68 6f77 2074 6869 ample of.how thi │ │ │ │ │ +00011ea0: 7264 2d70 6172 7479 2027 4d61 6b65 6669 rd-party 'Makefi │ │ │ │ │ +00011eb0: 6c65 2773 2063 616e 2062 6520 7573 6564 le's can be used │ │ │ │ │ +00011ec0: 2077 6974 6820 4175 746f 6d61 6b65 2e20 with Automake. │ │ │ │ │ +00011ed0: 2054 6865 2027 4d61 6b65 6669 6c65 2773 The 'Makefile's │ │ │ │ │ +00011ee0: 0a27 6765 7474 6578 7469 7a65 2720 7075 .'gettextize' pu │ │ │ │ │ +00011ef0: 7473 2069 6e20 7468 6520 2770 6f2f 2720 ts in the 'po/' │ │ │ │ │ +00011f00: 616e 6420 2769 6e74 6c2f 2720 6469 7265 and 'intl/' dire │ │ │ │ │ +00011f10: 6374 6f72 6965 7320 6172 6520 6861 6e64 ctories are hand │ │ │ │ │ +00011f20: 7772 6974 7465 6e0a 274d 616b 6566 696c written.'Makefil │ │ │ │ │ +00011f30: 6527 7320 7468 6174 2069 6d70 6c65 6d65 e's that impleme │ │ │ │ │ +00011f40: 6e74 2061 6c6c 2074 6865 7365 2074 6172 nt all these tar │ │ │ │ │ +00011f50: 6765 7473 2e20 2054 6861 7420 7761 7920 gets. That way │ │ │ │ │ +00011f60: 7468 6579 2063 616e 2062 650a 6164 6465 they can be.adde │ │ │ │ │ +00011f70: 6420 746f 2027 5355 4244 4952 5327 2069 d to 'SUBDIRS' i │ │ │ │ │ +00011f80: 6e20 4175 746f 6d61 6b65 2070 6163 6b61 n Automake packa │ │ │ │ │ +00011f90: 6765 732e 0a0a 2020 2044 6972 6563 746f ges... Directo │ │ │ │ │ +00011fa0: 7269 6573 2074 6861 7420 6172 6520 6f6e ries that are on │ │ │ │ │ +00011fb0: 6c79 206c 6973 7465 6420 696e 2027 4449 ly listed in 'DI │ │ │ │ │ +00011fc0: 5354 5f53 5542 4449 5253 2720 6275 7420 ST_SUBDIRS' but │ │ │ │ │ +00011fd0: 6e6f 7420 696e 0a27 5355 4244 4952 5327 not in.'SUBDIRS' │ │ │ │ │ +00011fe0: 206e 6565 6420 6f6e 6c79 2074 6865 2027 need only the ' │ │ │ │ │ +00011ff0: 6469 7374 636c 6561 6e27 2c20 276d 6169 distclean', 'mai │ │ │ │ │ +00012000: 6e74 6169 6e65 722d 636c 6561 6e27 2c20 ntainer-clean', │ │ │ │ │ +00012010: 616e 6420 2764 6973 7464 6972 270a 7275 and 'distdir'.ru │ │ │ │ │ +00012020: 6c65 7320 282a 6e6f 7465 2043 6f6e 6469 les (*note Condi │ │ │ │ │ +00012030: 7469 6f6e 616c 2053 7562 6469 7265 6374 tional Subdirect │ │ │ │ │ +00012040: 6f72 6965 733a 3a29 2e0a 0a20 2020 5573 ories::)... Us │ │ │ │ │ +00012050: 7561 6c6c 792c 206d 616e 7920 6f66 2074 ually, many of t │ │ │ │ │ +00012060: 6865 7365 2072 756c 6573 2061 7265 2069 hese rules are i │ │ │ │ │ +00012070: 7272 656c 6576 616e 7420 746f 2074 6865 rrelevant to the │ │ │ │ │ +00012080: 2074 6869 7264 2d70 6172 7479 0a73 7562 third-party.sub │ │ │ │ │ +00012090: 7072 6f6a 6563 742c 2062 7574 2074 6865 project, but the │ │ │ │ │ +000120a0: 7920 6172 6520 7265 7175 6972 6564 2066 y are required f │ │ │ │ │ +000120b0: 6f72 2074 6865 2077 686f 6c65 2070 6163 or the whole pac │ │ │ │ │ +000120c0: 6b61 6765 2074 6f20 776f 726b 2e20 2049 kage to work. I │ │ │ │ │ +000120d0: 7427 730a 4f4b 2074 6f20 6861 7665 2061 t's.OK to have a │ │ │ │ │ +000120e0: 2072 756c 6520 7468 6174 2064 6f65 7320 rule that does │ │ │ │ │ +000120f0: 6e6f 7468 696e 672c 2073 6f20 6966 2079 nothing, so if y │ │ │ │ │ +00012100: 6f75 2061 7265 2069 6e74 6567 7261 7469 ou are integrati │ │ │ │ │ +00012110: 6e67 2061 0a74 6869 7264 2d70 6172 7479 ng a.third-party │ │ │ │ │ +00012120: 2070 726f 6a65 6374 2077 6974 6820 6e6f project with no │ │ │ │ │ +00012130: 2064 6f63 756d 656e 7461 7469 6f6e 206f documentation o │ │ │ │ │ +00012140: 7220 7461 6720 7375 7070 6f72 742c 2079 r tag support, y │ │ │ │ │ +00012150: 6f75 2063 6f75 6c64 0a73 696d 706c 7920 ou could.simply │ │ │ │ │ +00012160: 6175 676d 656e 7420 6974 7320 274d 616b augment its 'Mak │ │ │ │ │ +00012170: 6566 696c 6527 2061 7320 666f 6c6c 6f77 efile' as follow │ │ │ │ │ +00012180: 733a 0a0a 2020 2020 2045 4d50 5459 5f41 s:.. EMPTY_A │ │ │ │ │ +00012190: 5554 4f4d 414b 455f 5441 5247 4554 5320 UTOMAKE_TARGETS │ │ │ │ │ +000121a0: 3d20 6476 6920 7064 6620 7073 2069 6e66 = dvi pdf ps inf │ │ │ │ │ +000121b0: 6f20 6874 6d6c 2074 6167 7320 6374 6167 o html tags ctag │ │ │ │ │ +000121c0: 730a 2020 2020 202e 5048 4f4e 593a 2024 s. .PHONY: $ │ │ │ │ │ +000121d0: 2845 4d50 5459 5f41 5554 4f4d 414b 455f (EMPTY_AUTOMAKE_ │ │ │ │ │ +000121e0: 5441 5247 4554 5329 0a20 2020 2020 2428 TARGETS). $( │ │ │ │ │ +000121f0: 454d 5054 595f 4155 544f 4d41 4b45 5f54 EMPTY_AUTOMAKE_T │ │ │ │ │ +00012200: 4152 4745 5453 293a 0a0a 2020 2041 6e6f ARGETS):.. Ano │ │ │ │ │ +00012210: 7468 6572 2061 7370 6563 7420 6f66 2069 ther aspect of i │ │ │ │ │ +00012220: 6e74 6567 7261 7469 6e67 2074 6869 7264 ntegrating third │ │ │ │ │ +00012230: 2d70 6172 7479 2062 7569 6c64 2073 7973 -party build sys │ │ │ │ │ +00012240: 7465 6d73 2069 7320 7768 6574 6865 720a tems is whether. │ │ │ │ │ +00012250: 7468 6579 2073 7570 706f 7274 2056 5041 they support VPA │ │ │ │ │ +00012260: 5448 2062 7569 6c64 7320 282a 6e6f 7465 TH builds (*note │ │ │ │ │ +00012270: 2056 5041 5448 2042 7569 6c64 733a 3a29 VPATH Builds::) │ │ │ │ │ +00012280: 2e20 204f 6276 696f 7573 6c79 2069 6620 . Obviously if │ │ │ │ │ +00012290: 7468 650a 7375 6270 6163 6b61 6765 2064 the.subpackage d │ │ │ │ │ +000122a0: 6f65 7320 6e6f 7420 7375 7070 6f72 7420 oes not support │ │ │ │ │ +000122b0: 5650 4154 4820 6275 696c 6473 2074 6865 VPATH builds the │ │ │ │ │ +000122c0: 2077 686f 6c65 2070 6163 6b61 6765 2077 whole package w │ │ │ │ │ +000122d0: 696c 6c20 6e6f 740a 7375 7070 6f72 7420 ill not.support │ │ │ │ │ +000122e0: 5650 4154 4820 6275 696c 6473 2e20 2054 VPATH builds. T │ │ │ │ │ +000122f0: 6869 7320 696e 2074 7572 6e73 206d 6561 his in turns mea │ │ │ │ │ +00012300: 6e73 2074 6861 7420 276d 616b 6520 6469 ns that 'make di │ │ │ │ │ +00012310: 7374 6368 6563 6b27 2077 696c 6c0a 6e6f stcheck' will.no │ │ │ │ │ +00012320: 7420 776f 726b 2c20 6265 6361 7573 6520 t work, because │ │ │ │ │ +00012330: 6974 2072 656c 6965 7320 6f6e 2056 5041 it relies on VPA │ │ │ │ │ +00012340: 5448 2062 7569 6c64 732e 2020 536f 6d65 TH builds. Some │ │ │ │ │ +00012350: 2070 656f 706c 6520 6361 6e20 6c69 7665 people can live │ │ │ │ │ +00012360: 0a77 6974 686f 7574 2074 6869 7320 2861 .without this (a │ │ │ │ │ +00012370: 6374 7561 6c6c 792c 206d 616e 7920 4175 ctually, many Au │ │ │ │ │ +00012380: 746f 6d61 6b65 2075 7365 7273 2068 6176 tomake users hav │ │ │ │ │ +00012390: 6520 6e65 7665 7220 6865 6172 6420 6f66 e never heard of │ │ │ │ │ +000123a0: 2027 6d61 6b65 0a64 6973 7463 6865 636b 'make.distcheck │ │ │ │ │ +000123b0: 2729 2e20 204f 7468 6572 2070 656f 706c '). Other peopl │ │ │ │ │ +000123c0: 6520 6d61 7920 7072 6566 6572 2074 6f20 e may prefer to │ │ │ │ │ +000123d0: 7265 7661 6d70 2074 6865 2065 7869 7374 revamp the exist │ │ │ │ │ +000123e0: 696e 6720 274d 616b 6566 696c 6527 730a ing 'Makefile's. │ │ │ │ │ +000123f0: 746f 2073 7570 706f 7274 2056 5041 5448 to support VPATH │ │ │ │ │ +00012400: 2e20 2044 6f69 6e67 2073 6f20 646f 6573 . Doing so does │ │ │ │ │ +00012410: 206e 6f74 206e 6563 6573 7361 7269 6c79 not necessarily │ │ │ │ │ +00012420: 2072 6571 7569 7265 2041 7574 6f6d 616b require Automak │ │ │ │ │ +00012430: 652c 206f 6e6c 790a 4175 746f 636f 6e66 e, only.Autoconf │ │ │ │ │ +00012440: 2069 7320 6e65 6564 6564 2028 2a6e 6f74 is needed (*not │ │ │ │ │ +00012450: 6520 4275 696c 6420 4469 7265 6374 6f72 e Build Director │ │ │ │ │ +00012460: 6965 733a 2028 6175 746f 636f 6e66 2942 ies: (autoconf)B │ │ │ │ │ +00012470: 7569 6c64 0a44 6972 6563 746f 7269 6573 uild.Directories │ │ │ │ │ +00012480: 2e29 2e20 2054 6865 206e 6563 6573 7361 .). The necessa │ │ │ │ │ +00012490: 7279 2073 7562 7374 6974 7574 696f 6e73 ry substitutions │ │ │ │ │ +000124a0: 3a20 2740 7372 6364 6972 4027 2c20 2740 : '@srcdir@', '@ │ │ │ │ │ +000124b0: 746f 705f 7372 6364 6972 4027 2c0a 616e top_srcdir@',.an │ │ │ │ │ +000124c0: 6420 2740 746f 705f 6275 696c 6464 6972 d '@top_builddir │ │ │ │ │ +000124d0: 4027 2061 7265 2064 6566 696e 6564 2062 @' are defined b │ │ │ │ │ +000124e0: 7920 2763 6f6e 6669 6775 7265 2720 7768 y 'configure' wh │ │ │ │ │ +000124f0: 656e 2069 7420 7072 6f63 6573 7365 7320 en it processes │ │ │ │ │ +00012500: 610a 274d 616b 6566 696c 6527 2028 2a6e a.'Makefile' (*n │ │ │ │ │ +00012510: 6f74 6520 5072 6573 6574 204f 7574 7075 ote Preset Outpu │ │ │ │ │ +00012520: 7420 5661 7269 6162 6c65 733a 2028 6175 t Variables: (au │ │ │ │ │ +00012530: 746f 636f 6e66 2950 7265 7365 7420 4f75 toconf)Preset Ou │ │ │ │ │ +00012540: 7470 7574 0a56 6172 6961 626c 6573 2e29 tput.Variables.) │ │ │ │ │ +00012550: 2c20 7468 6579 2061 7265 206e 6f74 2063 , they are not c │ │ │ │ │ +00012560: 6f6d 7075 7465 6420 6279 2074 6865 204d omputed by the M │ │ │ │ │ +00012570: 616b 6566 696c 6520 6c69 6b65 2074 6865 akefile like the │ │ │ │ │ +00012580: 0a61 666f 7265 6d65 6e74 696f 6e65 6420 .aforementioned │ │ │ │ │ +00012590: 2724 2864 6973 7464 6972 2927 2061 6e64 '$(distdir)' and │ │ │ │ │ +000125a0: 2027 2428 746f 705f 6469 7374 6469 7229 '$(top_distdir) │ │ │ │ │ +000125b0: 2720 7661 7269 6162 6c65 732e 0a0a 2020 ' variables... │ │ │ │ │ +000125c0: 2049 7420 6973 2073 6f6d 6574 696d 6573 It is sometimes │ │ │ │ │ +000125d0: 2069 6e63 6f6e 7665 6e69 656e 7420 746f inconvenient to │ │ │ │ │ +000125e0: 206d 6f64 6966 7920 6120 7468 6972 642d modify a third- │ │ │ │ │ +000125f0: 7061 7274 7920 274d 616b 6566 696c 6527 party 'Makefile' │ │ │ │ │ +00012600: 2074 6f0a 696e 7472 6f64 7563 6520 7468 to.introduce th │ │ │ │ │ +00012610: 6520 6162 6f76 6520 7265 7175 6972 6564 e above required │ │ │ │ │ +00012620: 2074 6172 6765 7473 2e20 2046 6f72 2069 targets. For i │ │ │ │ │ +00012630: 6e73 7461 6e63 652c 206f 6e65 206d 6179 nstance, one may │ │ │ │ │ +00012640: 2077 616e 7420 746f 0a6b 6565 7020 7468 want to.keep th │ │ │ │ │ +00012650: 6520 7468 6972 642d 7061 7274 7920 736f e third-party so │ │ │ │ │ +00012660: 7572 6365 7320 756e 746f 7563 6865 6420 urces untouched │ │ │ │ │ +00012670: 746f 2065 6173 6520 7570 6772 6164 6573 to ease upgrades │ │ │ │ │ +00012680: 2074 6f20 6e65 7720 7665 7273 696f 6e73 to new versions │ │ │ │ │ +00012690: 2e0a 0a20 2020 4865 7265 2061 7265 2074 ... Here are t │ │ │ │ │ +000126a0: 776f 206f 7468 6572 2069 6465 6173 2e20 wo other ideas. │ │ │ │ │ +000126b0: 2049 6620 474e 5520 6d61 6b65 2069 7320 If GNU make is │ │ │ │ │ +000126c0: 6173 7375 6d65 642c 206f 6e65 2070 6f73 assumed, one pos │ │ │ │ │ +000126d0: 7369 6269 6c69 7479 2069 730a 746f 2061 sibility is.to a │ │ │ │ │ +000126e0: 6464 2074 6f20 7468 6174 2073 7562 6469 dd to that subdi │ │ │ │ │ +000126f0: 7265 6374 6f72 7920 6120 2747 4e55 6d61 rectory a 'GNUma │ │ │ │ │ +00012700: 6b65 6669 6c65 2720 7468 6174 2064 6566 kefile' that def │ │ │ │ │ +00012710: 696e 6573 2074 6865 2072 6571 7569 7265 ines the require │ │ │ │ │ +00012720: 640a 7461 7267 6574 7320 616e 6420 696e d.targets and in │ │ │ │ │ +00012730: 636c 7564 6573 2074 6865 2074 6869 7264 cludes the third │ │ │ │ │ +00012740: 2d70 6172 7479 2027 4d61 6b65 6669 6c65 -party 'Makefile │ │ │ │ │ +00012750: 272e 2020 466f 7220 7468 6973 2074 6f20 '. For this to │ │ │ │ │ +00012760: 776f 726b 2069 6e0a 5650 4154 4820 6275 work in.VPATH bu │ │ │ │ │ +00012770: 696c 6473 2c20 2747 4e55 6d61 6b65 6669 ilds, 'GNUmakefi │ │ │ │ │ +00012780: 6c65 2720 6d75 7374 206c 6965 2069 6e20 le' must lie in │ │ │ │ │ +00012790: 7468 6520 6275 696c 6420 6469 7265 6374 the build direct │ │ │ │ │ +000127a0: 6f72 793b 2074 6865 2065 6173 6965 7374 ory; the easiest │ │ │ │ │ +000127b0: 0a77 6179 2074 6f20 646f 2074 6869 7320 .way to do this │ │ │ │ │ +000127c0: 6973 2074 6f20 7772 6974 6520 6120 2747 is to write a 'G │ │ │ │ │ +000127d0: 4e55 6d61 6b65 6669 6c65 2e69 6e27 2069 NUmakefile.in' i │ │ │ │ │ +000127e0: 6e73 7465 6164 2c20 616e 6420 6861 7665 nstead, and have │ │ │ │ │ +000127f0: 2069 740a 7072 6f63 6573 7365 6420 7769 it.processed wi │ │ │ │ │ +00012800: 7468 2027 4143 5f43 4f4e 4649 475f 4649 th 'AC_CONFIG_FI │ │ │ │ │ +00012810: 4c45 5327 2066 726f 6d20 7468 6520 6f75 LES' from the ou │ │ │ │ │ +00012820: 7465 7220 7061 636b 6167 652e 2020 466f ter package. Fo │ │ │ │ │ +00012830: 7220 6578 616d 706c 6520 6966 0a77 6520 r example if.we │ │ │ │ │ +00012840: 6173 7375 6d65 2027 4d61 6b65 6669 6c65 assume 'Makefile │ │ │ │ │ +00012850: 2720 6465 6669 6e65 7320 616c 6c20 7461 ' defines all ta │ │ │ │ │ +00012860: 7267 6574 7320 6578 6365 7074 2074 6865 rgets except the │ │ │ │ │ +00012870: 2064 6f63 756d 656e 7461 7469 6f6e 0a74 documentation.t │ │ │ │ │ +00012880: 6172 6765 7473 2c20 616e 6420 7468 6174 argets, and that │ │ │ │ │ +00012890: 2074 6865 2027 6368 6563 6b27 2074 6172 the 'check' tar │ │ │ │ │ +000128a0: 6765 7420 6973 2061 6374 7561 6c6c 7920 get is actually │ │ │ │ │ +000128b0: 6361 6c6c 6564 2027 7465 7374 272c 2077 called 'test', w │ │ │ │ │ +000128c0: 6520 636f 756c 640a 7772 6974 6520 2747 e could.write 'G │ │ │ │ │ +000128d0: 4e55 6d61 6b65 6669 6c65 2720 286f 7220 NUmakefile' (or │ │ │ │ │ +000128e0: 2747 4e55 6d61 6b65 6669 6c65 2e69 6e27 'GNUmakefile.in' │ │ │ │ │ +000128f0: 2920 6c69 6b65 2074 6869 733a 0a0a 2020 ) like this:.. │ │ │ │ │ +00012900: 2020 2023 2046 6972 7374 2c20 696e 636c # First, incl │ │ │ │ │ +00012910: 7564 6520 7468 6520 7265 616c 204d 616b ude the real Mak │ │ │ │ │ +00012920: 6566 696c 650a 2020 2020 2069 6e63 6c75 efile. inclu │ │ │ │ │ +00012930: 6465 204d 616b 6566 696c 650a 2020 2020 de Makefile. │ │ │ │ │ +00012940: 2023 2054 6865 6e2c 2064 6566 696e 6520 # Then, define │ │ │ │ │ +00012950: 7468 6520 6f74 6865 7220 7461 7267 6574 the other target │ │ │ │ │ +00012960: 7320 6e65 6564 6564 2062 7920 4175 746f s needed by Auto │ │ │ │ │ +00012970: 6d61 6b65 204d 616b 6566 696c 6573 2e0a make Makefiles.. │ │ │ │ │ +00012980: 2020 2020 202e 5048 4f4e 593a 2064 7669 .PHONY: dvi │ │ │ │ │ +00012990: 2070 6466 2070 7320 696e 666f 2068 746d pdf ps info htm │ │ │ │ │ +000129a0: 6c20 6368 6563 6b0a 2020 2020 2064 7669 l check. dvi │ │ │ │ │ +000129b0: 2070 6466 2070 7320 696e 666f 2068 746d pdf ps info htm │ │ │ │ │ +000129c0: 6c3a 0a20 2020 2020 6368 6563 6b3a 2074 l:. check: t │ │ │ │ │ +000129d0: 6573 740a 0a20 2020 4120 7369 6d69 6c61 est.. A simila │ │ │ │ │ +000129e0: 7220 6964 6561 2074 6861 7420 646f 6573 r idea that does │ │ │ │ │ +000129f0: 206e 6f74 2075 7365 2027 696e 636c 7564 not use 'includ │ │ │ │ │ +00012a00: 6527 2069 7320 746f 2077 7269 7465 2061 e' is to write a │ │ │ │ │ +00012a10: 2070 726f 7879 0a27 4d61 6b65 6669 6c65 proxy.'Makefile │ │ │ │ │ +00012a20: 2720 7468 6174 2064 6973 7061 7463 6865 ' that dispatche │ │ │ │ │ +00012a30: 7320 7275 6c65 7320 746f 2074 6865 2072 s rules to the r │ │ │ │ │ +00012a40: 6561 6c20 274d 616b 6566 696c 6527 2c20 eal 'Makefile', │ │ │ │ │ +00012a50: 6569 7468 6572 2077 6974 680a 2724 284d either with.'$(M │ │ │ │ │ +00012a60: 414b 4529 202d 6620 4d61 6b65 6669 6c65 AKE) -f Makefile │ │ │ │ │ +00012a70: 2e72 6561 6c20 2428 414d 5f4d 414b 4546 .real $(AM_MAKEF │ │ │ │ │ +00012a80: 4c41 4753 2920 7461 7267 6574 2720 2869 LAGS) target' (i │ │ │ │ │ +00012a90: 6620 6974 2773 204f 4b20 746f 2072 656e f it's OK to ren │ │ │ │ │ +00012aa0: 616d 650a 7468 6520 6f72 6967 696e 616c ame.the original │ │ │ │ │ +00012ab0: 2027 4d61 6b65 6669 6c65 2729 206f 7220 'Makefile') or │ │ │ │ │ +00012ac0: 7769 7468 2027 6364 2073 7562 6469 7220 with 'cd subdir │ │ │ │ │ +00012ad0: 2626 2024 284d 414b 4529 2024 2841 4d5f && $(MAKE) $(AM_ │ │ │ │ │ +00012ae0: 4d41 4b45 464c 4147 5329 0a74 6172 6765 MAKEFLAGS).targe │ │ │ │ │ +00012af0: 7427 2028 6966 2069 7427 7320 4f4b 2074 t' (if it's OK t │ │ │ │ │ +00012b00: 6f20 7374 6f72 6520 7468 6520 7375 6264 o store the subd │ │ │ │ │ +00012b10: 6972 6563 746f 7279 2070 726f 6a65 6374 irectory project │ │ │ │ │ +00012b20: 206f 6e65 2064 6972 6563 746f 7279 0a64 one directory.d │ │ │ │ │ +00012b30: 6565 7065 7229 2e20 2054 6865 2067 6f6f eeper). The goo │ │ │ │ │ +00012b40: 6420 6e65 7773 2069 7320 7468 6174 2074 d news is that t │ │ │ │ │ +00012b50: 6869 7320 7072 6f78 7920 274d 616b 6566 his proxy 'Makef │ │ │ │ │ +00012b60: 696c 6527 2063 616e 2062 6520 6765 6e65 ile' can be gene │ │ │ │ │ +00012b70: 7261 7465 640a 7769 7468 2041 7574 6f6d rated.with Autom │ │ │ │ │ +00012b80: 616b 652e 2020 416c 6c20 7765 206e 6565 ake. All we nee │ │ │ │ │ +00012b90: 6420 6172 6520 272d 6c6f 6361 6c27 2074 d are '-local' t │ │ │ │ │ +00012ba0: 6172 6765 7473 2028 2a6e 6f74 6520 4578 argets (*note Ex │ │ │ │ │ +00012bb0: 7465 6e64 696e 673a 3a29 0a74 6861 7420 tending::).that │ │ │ │ │ +00012bc0: 7065 7266 6f72 6d20 7468 6520 6469 7370 perform the disp │ │ │ │ │ +00012bd0: 6174 6368 2e20 204f 6620 636f 7572 7365 atch. Of course │ │ │ │ │ +00012be0: 2074 6865 206f 7468 6572 2041 7574 6f6d the other Autom │ │ │ │ │ +00012bf0: 616b 6520 6665 6174 7572 6573 2061 7265 ake features are │ │ │ │ │ +00012c00: 0a61 7661 696c 6162 6c65 2c20 736f 2079 .available, so y │ │ │ │ │ +00012c10: 6f75 2063 6f75 6c64 2064 6563 6964 6520 ou could decide │ │ │ │ │ +00012c20: 746f 206c 6574 2041 7574 6f6d 616b 6520 to let Automake │ │ │ │ │ +00012c30: 7065 7266 6f72 6d20 6469 7374 7269 6275 perform distribu │ │ │ │ │ +00012c40: 7469 6f6e 206f 720a 696e 7374 616c 6c61 tion or.installa │ │ │ │ │ +00012c50: 7469 6f6e 2e20 2048 6572 6520 6973 2061 tion. Here is a │ │ │ │ │ +00012c60: 2070 6f73 7369 626c 6520 274d 616b 6566 possible 'Makef │ │ │ │ │ +00012c70: 696c 652e 616d 273a 0a0a 2020 2020 2061 ile.am':.. a │ │ │ │ │ +00012c80: 6c6c 2d6c 6f63 616c 3a0a 2020 2020 2020 ll-local:. │ │ │ │ │ +00012c90: 2020 2020 2020 2063 6420 7375 6264 6972 cd subdir │ │ │ │ │ +00012ca0: 2026 2620 2428 4d41 4b45 2920 2428 414d && $(MAKE) $(AM │ │ │ │ │ +00012cb0: 5f4d 414b 4546 4c41 4753 2920 616c 6c0a _MAKEFLAGS) all. │ │ │ │ │ +00012cc0: 2020 2020 2063 6865 636b 2d6c 6f63 616c check-local │ │ │ │ │ +00012cd0: 3a0a 2020 2020 2020 2020 2020 2020 2063 :. c │ │ │ │ │ +00012ce0: 6420 7375 6264 6972 2026 2620 2428 4d41 d subdir && $(MA │ │ │ │ │ +00012cf0: 4b45 2920 2428 414d 5f4d 414b 4546 4c41 KE) $(AM_MAKEFLA │ │ │ │ │ +00012d00: 4753 2920 7465 7374 0a20 2020 2020 636c GS) test. cl │ │ │ │ │ +00012d10: 6561 6e2d 6c6f 6361 6c3a 0a20 2020 2020 ean-local:. │ │ │ │ │ +00012d20: 2020 2020 2020 2020 6364 2073 7562 6469 cd subdi │ │ │ │ │ +00012d30: 7220 2626 2024 284d 414b 4529 2024 2841 r && $(MAKE) $(A │ │ │ │ │ +00012d40: 4d5f 4d41 4b45 464c 4147 5329 2063 6c65 M_MAKEFLAGS) cle │ │ │ │ │ +00012d50: 616e 0a0a 2020 2020 2023 2041 7373 756d an.. # Assum │ │ │ │ │ +00012d60: 696e 6720 7468 6520 7061 636b 6167 6520 ing the package │ │ │ │ │ +00012d70: 6b6e 6f77 7320 686f 7720 746f 2069 6e73 knows how to ins │ │ │ │ │ +00012d80: 7461 6c6c 2069 7473 656c 660a 2020 2020 tall itself. │ │ │ │ │ +00012d90: 2069 6e73 7461 6c6c 2d64 6174 612d 6c6f install-data-lo │ │ │ │ │ +00012da0: 6361 6c3a 0a20 2020 2020 2020 2020 2020 cal:. │ │ │ │ │ +00012db0: 2020 6364 2073 7562 6469 7220 2626 2024 cd subdir && $ │ │ │ │ │ +00012dc0: 284d 414b 4529 2024 2841 4d5f 4d41 4b45 (MAKE) $(AM_MAKE │ │ │ │ │ +00012dd0: 464c 4147 5329 2069 6e73 7461 6c6c 2d64 FLAGS) install-d │ │ │ │ │ +00012de0: 6174 610a 2020 2020 2069 6e73 7461 6c6c ata. install │ │ │ │ │ +00012df0: 2d65 7865 632d 6c6f 6361 6c3a 0a20 2020 -exec-local:. │ │ │ │ │ +00012e00: 2020 2020 2020 2020 2020 6364 2073 7562 cd sub │ │ │ │ │ +00012e10: 6469 7220 2626 2024 284d 414b 4529 2024 dir && $(MAKE) $ │ │ │ │ │ +00012e20: 2841 4d5f 4d41 4b45 464c 4147 5329 2069 (AM_MAKEFLAGS) i │ │ │ │ │ +00012e30: 6e73 7461 6c6c 2d65 7865 630a 2020 2020 nstall-exec. │ │ │ │ │ +00012e40: 2075 6e69 6e73 7461 6c6c 2d6c 6f63 616c uninstall-local │ │ │ │ │ +00012e50: 3a0a 2020 2020 2020 2020 2020 2020 2063 :. c │ │ │ │ │ +00012e60: 6420 7375 6264 6972 2026 2620 2428 4d41 d subdir && $(MA │ │ │ │ │ +00012e70: 4b45 2920 2428 414d 5f4d 414b 4546 4c41 KE) $(AM_MAKEFLA │ │ │ │ │ +00012e80: 4753 2920 756e 696e 7374 616c 6c0a 0a20 GS) uninstall.. │ │ │ │ │ +00012e90: 2020 2020 2320 4469 7374 7269 6275 7465 # Distribute │ │ │ │ │ +00012ea0: 2066 696c 6573 2066 726f 6d20 6865 7265 files from here │ │ │ │ │ +00012eb0: 2e0a 2020 2020 2045 5854 5241 5f44 4953 .. EXTRA_DIS │ │ │ │ │ +00012ec0: 5420 3d20 7375 6264 6972 2f4d 616b 6566 T = subdir/Makef │ │ │ │ │ +00012ed0: 696c 6520 7375 6264 6972 2f70 726f 6772 ile subdir/progr │ │ │ │ │ +00012ee0: 616d 2e63 202e 2e2e 0a0a 2020 2050 7573 am.c ..... Pus │ │ │ │ │ +00012ef0: 6869 6e67 2074 6869 7320 6964 6561 2074 hing this idea t │ │ │ │ │ +00012f00: 6f20 7468 6520 6578 7472 656d 652c 2069 o the extreme, i │ │ │ │ │ +00012f10: 7420 6973 2061 6c73 6f20 706f 7373 6962 t is also possib │ │ │ │ │ +00012f20: 6c65 2074 6f20 6967 6e6f 7265 2074 6865 le to ignore the │ │ │ │ │ +00012f30: 0a73 7562 7072 6f6a 6563 7420 6275 696c .subproject buil │ │ │ │ │ +00012f40: 6420 7379 7374 656d 2061 6e64 2062 7569 d system and bui │ │ │ │ │ +00012f50: 6c64 2065 7665 7279 7468 696e 6720 6672 ld everything fr │ │ │ │ │ +00012f60: 6f6d 2074 6869 7320 7072 6f78 790a 274d om this proxy.'M │ │ │ │ │ +00012f70: 616b 6566 696c 652e 616d 272e 2020 5468 akefile.am'. Th │ │ │ │ │ +00012f80: 6973 206d 6967 6874 2073 6f75 6e64 2076 is might sound v │ │ │ │ │ +00012f90: 6572 7920 7365 6e73 6962 6c65 2069 6620 ery sensible if │ │ │ │ │ +00012fa0: 796f 7520 6e65 6564 2056 5041 5448 2062 you need VPATH b │ │ │ │ │ +00012fb0: 7569 6c64 730a 6275 7420 7468 6520 7375 uilds.but the su │ │ │ │ │ +00012fc0: 6270 726f 6a65 6374 2064 6f65 7320 6e6f bproject does no │ │ │ │ │ +00012fd0: 7420 7375 7070 6f72 7420 7468 656d 2e0a t support them.. │ │ │ │ │ +00012fe0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +00012ff0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +00013000: 6465 3a20 4469 7374 7269 6275 7469 6e67 de: Distributing │ │ │ │ │ +00013010: 2c20 204e 6578 743a 2041 5049 2056 6572 , Next: API Ver │ │ │ │ │ +00013020: 7369 6f6e 696e 672c 2020 5072 6576 3a20 sioning, Prev: │ │ │ │ │ +00013030: 4e6f 7420 456e 6f75 6768 2c20 2055 703a Not Enough, Up: │ │ │ │ │ +00013040: 2054 6f70 0a0a 3235 2044 6973 7472 6962 Top..25 Distrib │ │ │ │ │ +00013050: 7574 696e 6720 274d 616b 6566 696c 652e uting 'Makefile. │ │ │ │ │ +00013060: 696e 2773 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a in's.*********** │ │ │ │ │ 00013070: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00013080: 2a2a 0a0a 4175 746f 6d61 6b65 2070 6c61 **..Automake pla │ │ │ │ │ -00013090: 6365 7320 6e6f 2072 6573 7472 6963 7469 ces no restricti │ │ │ │ │ -000130a0: 6f6e 7320 6f6e 2074 6865 2064 6973 7472 ons on the distr │ │ │ │ │ -000130b0: 6962 7574 696f 6e20 6f66 2074 6865 2072 ibution of the r │ │ │ │ │ -000130c0: 6573 756c 7469 6e67 0a27 4d61 6b65 6669 esulting.'Makefi │ │ │ │ │ -000130d0: 6c65 2e69 6e27 732e 2020 5765 2073 7469 le.in's. We sti │ │ │ │ │ -000130e0: 6c6c 2065 6e63 6f75 7261 6765 2073 6f66 ll encourage sof │ │ │ │ │ -000130f0: 7477 6172 6520 6175 7468 6f72 7320 746f tware authors to │ │ │ │ │ -00013100: 2064 6973 7472 6962 7574 6520 7468 6569 distribute thei │ │ │ │ │ -00013110: 720a 776f 726b 2075 6e64 6572 2074 6572 r.work under ter │ │ │ │ │ -00013120: 6d73 206c 696b 6520 7468 6f73 6520 6f66 ms like those of │ │ │ │ │ -00013130: 2074 6865 2047 504c 2c20 6275 7420 646f the GPL, but do │ │ │ │ │ -00013140: 696e 6720 736f 2069 7320 6e6f 7420 7265 ing so is not re │ │ │ │ │ -00013150: 7175 6972 6564 2074 6f0a 7573 6520 4175 quired to.use Au │ │ │ │ │ -00013160: 746f 6d61 6b65 2e0a 0a20 2020 536f 6d65 tomake... Some │ │ │ │ │ -00013170: 206f 6620 7468 6520 6669 6c65 7320 7468 of the files th │ │ │ │ │ -00013180: 6174 2063 616e 2062 6520 6175 746f 6d61 at can be automa │ │ │ │ │ -00013190: 7469 6361 6c6c 7920 696e 7374 616c 6c65 tically installe │ │ │ │ │ -000131a0: 6420 7669 6120 7468 650a 272d 2d61 6464 d via the.'--add │ │ │ │ │ -000131b0: 2d6d 6973 7369 6e67 2720 7377 6974 6368 -missing' switch │ │ │ │ │ -000131c0: 2064 6f20 6661 6c6c 2075 6e64 6572 2074 do fall under t │ │ │ │ │ -000131d0: 6865 2047 504c 2e20 2048 6f77 6576 6572 he GPL. However │ │ │ │ │ -000131e0: 2c20 7468 6573 6520 616c 736f 2068 6176 , these also hav │ │ │ │ │ -000131f0: 650a 6120 7370 6563 6961 6c20 6578 6365 e.a special exce │ │ │ │ │ -00013200: 7074 696f 6e20 616c 6c6f 7769 6e67 2079 ption allowing y │ │ │ │ │ -00013210: 6f75 2074 6f20 6469 7374 7269 6275 7465 ou to distribute │ │ │ │ │ -00013220: 2074 6865 6d20 7769 7468 2079 6f75 7220 them with your │ │ │ │ │ -00013230: 7061 636b 6167 652c 0a72 6567 6172 646c package,.regardl │ │ │ │ │ -00013240: 6573 7320 6f66 2074 6865 206c 6963 656e ess of the licen │ │ │ │ │ -00013250: 7369 6e67 2079 6f75 2063 686f 6f73 652e sing you choose. │ │ │ │ │ -00013260: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00013270: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00013280: 6f64 653a 2041 5049 2056 6572 7369 6f6e ode: API Version │ │ │ │ │ -00013290: 696e 672c 2020 4e65 7874 3a20 5570 6772 ing, Next: Upgr │ │ │ │ │ -000132a0: 6164 696e 672c 2020 5072 6576 3a20 4469 ading, Prev: Di │ │ │ │ │ -000132b0: 7374 7269 6275 7469 6e67 2c20 2055 703a stributing, Up: │ │ │ │ │ -000132c0: 2054 6f70 0a0a 3236 2041 7574 6f6d 616b Top..26 Automak │ │ │ │ │ -000132d0: 6520 4150 4920 5665 7273 696f 6e69 6e67 e API Versioning │ │ │ │ │ -000132e0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -000132f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a4e 6577 ***********..New │ │ │ │ │ -00013300: 2041 7574 6f6d 616b 6520 7265 6c65 6173 Automake releas │ │ │ │ │ -00013310: 6573 2075 7375 616c 6c79 2069 6e63 6c75 es usually inclu │ │ │ │ │ -00013320: 6465 2062 7567 2066 6978 6573 2061 6e64 de bug fixes and │ │ │ │ │ -00013330: 206e 6577 2066 6561 7475 7265 732e 0a55 new features..U │ │ │ │ │ -00013340: 6e66 6f72 7475 6e61 7465 6c79 2074 6865 nfortunately the │ │ │ │ │ -00013350: 7920 6d61 7920 616c 736f 2069 6e74 726f y may also intro │ │ │ │ │ -00013360: 6475 6365 206e 6577 2062 7567 7320 616e duce new bugs an │ │ │ │ │ -00013370: 6420 696e 636f 6d70 6174 6962 696c 6974 d incompatibilit │ │ │ │ │ -00013380: 6965 732e 0a54 6869 7320 6d61 6b65 7320 ies..This makes │ │ │ │ │ -00013390: 666f 7572 2072 6561 736f 6e73 2077 6879 four reasons why │ │ │ │ │ -000133a0: 2061 2070 6163 6b61 6765 206d 6179 2072 a package may r │ │ │ │ │ -000133b0: 6571 7569 7265 2061 2070 6172 7469 6375 equire a particu │ │ │ │ │ -000133c0: 6c61 7220 4175 746f 6d61 6b65 0a76 6572 lar Automake.ver │ │ │ │ │ -000133d0: 7369 6f6e 2e0a 0a20 2020 5468 696e 6773 sion... Things │ │ │ │ │ -000133e0: 2067 6574 2077 6f72 7365 2077 6865 6e20 get worse when │ │ │ │ │ -000133f0: 6d61 696e 7461 696e 696e 6720 6120 6c61 maintaining a la │ │ │ │ │ -00013400: 7267 6520 7472 6565 206f 6620 7061 636b rge tree of pack │ │ │ │ │ -00013410: 6167 6573 2c20 6561 6368 206f 6e65 0a72 ages, each one.r │ │ │ │ │ -00013420: 6571 7569 7269 6e67 2061 2064 6966 6665 equiring a diffe │ │ │ │ │ -00013430: 7265 6e74 2076 6572 7369 6f6e 206f 6620 rent version of │ │ │ │ │ -00013440: 4175 746f 6d61 6b65 2e20 2049 6e20 7468 Automake. In th │ │ │ │ │ -00013450: 6520 7061 7374 2c20 7468 6973 206d 6561 e past, this mea │ │ │ │ │ -00013460: 6e74 2074 6861 740a 616e 7920 6465 7665 nt that.any deve │ │ │ │ │ -00013470: 6c6f 7065 7220 2861 6e64 2073 6f6d 6574 loper (and somet │ │ │ │ │ -00013480: 696d 6573 2075 7365 7273 2920 6861 6420 imes users) had │ │ │ │ │ -00013490: 746f 2069 6e73 7461 6c6c 2073 6576 6572 to install sever │ │ │ │ │ -000134a0: 616c 2076 6572 7369 6f6e 7320 6f66 0a41 al versions of.A │ │ │ │ │ -000134b0: 7574 6f6d 616b 6520 696e 2064 6966 6665 utomake in diffe │ │ │ │ │ -000134c0: 7265 6e74 2070 6c61 6365 732c 2061 6e64 rent places, and │ │ │ │ │ -000134d0: 2073 7769 7463 6820 2724 5041 5448 2720 switch '$PATH' │ │ │ │ │ -000134e0: 6170 7072 6f70 7269 6174 656c 7920 666f appropriately fo │ │ │ │ │ -000134f0: 7220 6561 6368 0a70 6163 6b61 6765 2e0a r each.package.. │ │ │ │ │ -00013500: 0a20 2020 5374 6172 7469 6e67 2077 6974 . Starting wit │ │ │ │ │ -00013510: 6820 7665 7273 696f 6e20 312e 362c 2041 h version 1.6, A │ │ │ │ │ -00013520: 7574 6f6d 616b 6520 696e 7374 616c 6c73 utomake installs │ │ │ │ │ -00013530: 2076 6572 7369 6f6e 6564 2062 696e 6172 versioned binar │ │ │ │ │ -00013540: 6965 732e 0a54 6869 7320 6d65 616e 7320 ies..This means │ │ │ │ │ -00013550: 796f 7520 6361 6e20 696e 7374 616c 6c20 you can install │ │ │ │ │ -00013560: 7365 7665 7261 6c20 7665 7273 696f 6e73 several versions │ │ │ │ │ -00013570: 206f 6620 4175 746f 6d61 6b65 2069 6e20 of Automake in │ │ │ │ │ -00013580: 7468 6520 7361 6d65 0a27 2470 7265 6669 the same.'$prefi │ │ │ │ │ -00013590: 7827 2c20 616e 6420 6361 6e20 7365 6c65 x', and can sele │ │ │ │ │ -000135a0: 6374 2061 6e20 6172 6269 7472 6172 7920 ct an arbitrary │ │ │ │ │ -000135b0: 4175 746f 6d61 6b65 2076 6572 7369 6f6e Automake version │ │ │ │ │ -000135c0: 2062 7920 7275 6e6e 696e 670a 2761 7574 by running.'aut │ │ │ │ │ -000135d0: 6f6d 616b 652d 312e 3627 206f 7220 2761 omake-1.6' or 'a │ │ │ │ │ -000135e0: 7574 6f6d 616b 652d 312e 3727 2077 6974 utomake-1.7' wit │ │ │ │ │ -000135f0: 686f 7574 206a 7567 676c 696e 6720 7769 hout juggling wi │ │ │ │ │ -00013600: 7468 2027 2450 4154 4827 2e0a 4675 7274 th '$PATH'..Furt │ │ │ │ │ -00013610: 6865 726d 6f72 652c 2027 4d61 6b65 6669 hermore, 'Makefi │ │ │ │ │ -00013620: 6c65 2727 7320 6765 6e65 7261 7465 6420 le''s generated │ │ │ │ │ -00013630: 6279 2041 7574 6f6d 616b 6520 312e 3620 by Automake 1.6 │ │ │ │ │ -00013640: 7769 6c6c 2075 7365 0a27 6175 746f 6d61 will use.'automa │ │ │ │ │ -00013650: 6b65 2d31 2e36 2720 6578 706c 6963 6974 ke-1.6' explicit │ │ │ │ │ -00013660: 6c79 2069 6e20 7468 6569 7220 7265 6275 ly in their rebu │ │ │ │ │ -00013670: 696c 6420 7275 6c65 732e 0a0a 2020 2054 ild rules... T │ │ │ │ │ -00013680: 6865 206e 756d 6265 7220 2731 2e36 2720 he number '1.6' │ │ │ │ │ -00013690: 696e 2027 6175 746f 6d61 6b65 2d31 2e36 in 'automake-1.6 │ │ │ │ │ -000136a0: 2720 6973 2041 7574 6f6d 616b 6527 7320 ' is Automake's │ │ │ │ │ -000136b0: 4150 4920 7665 7273 696f 6e2c 206e 6f74 API version, not │ │ │ │ │ -000136c0: 0a41 7574 6f6d 616b 6527 7320 7665 7273 .Automake's vers │ │ │ │ │ -000136d0: 696f 6e2e 2020 4966 2061 2062 7567 2066 ion. If a bug f │ │ │ │ │ -000136e0: 6978 2072 656c 6561 7365 2069 7320 6d61 ix release is ma │ │ │ │ │ -000136f0: 6465 2c20 666f 7220 696e 7374 616e 6365 de, for instance │ │ │ │ │ -00013700: 2041 7574 6f6d 616b 650a 312e 362e 312c Automake.1.6.1, │ │ │ │ │ -00013710: 2074 6865 2041 5049 2076 6572 7369 6f6e the API version │ │ │ │ │ -00013720: 2077 696c 6c20 7265 6d61 696e 2031 2e36 will remain 1.6 │ │ │ │ │ -00013730: 2e20 2054 6869 7320 6d65 616e 7320 7468 . This means th │ │ │ │ │ -00013740: 6174 2061 2070 6163 6b61 6765 2074 6861 at a package tha │ │ │ │ │ -00013750: 740a 776f 726b 7320 7769 7468 2041 7574 t.works with Aut │ │ │ │ │ -00013760: 6f6d 616b 6520 312e 3620 7368 6f75 6c64 omake 1.6 should │ │ │ │ │ -00013770: 2061 6c73 6f20 776f 726b 2077 6974 6820 also work with │ │ │ │ │ -00013780: 312e 362e 313b 2061 6674 6572 2061 6c6c 1.6.1; after all │ │ │ │ │ -00013790: 2c20 7468 6973 2069 730a 7768 6174 2070 , this is.what p │ │ │ │ │ -000137a0: 656f 706c 6520 6578 7065 6374 2066 726f eople expect fro │ │ │ │ │ -000137b0: 6d20 6275 6720 6669 7820 7265 6c65 6173 m bug fix releas │ │ │ │ │ -000137c0: 6573 2e0a 0a20 2020 4966 2079 6f75 7220 es... If your │ │ │ │ │ -000137d0: 7061 636b 6167 6520 7265 6c69 6573 206f package relies o │ │ │ │ │ -000137e0: 6e20 6120 6665 6174 7572 6520 6f72 2061 n a feature or a │ │ │ │ │ -000137f0: 2062 7567 2066 6978 2069 6e74 726f 6475 bug fix introdu │ │ │ │ │ -00013800: 6365 6420 696e 2061 0a72 656c 6561 7365 ced in a.release │ │ │ │ │ -00013810: 2c20 796f 7520 6361 6e20 7061 7373 2074 , you can pass t │ │ │ │ │ -00013820: 6869 7320 7665 7273 696f 6e20 6173 2061 his version as a │ │ │ │ │ -00013830: 6e20 6f70 7469 6f6e 2074 6f20 4175 746f n option to Auto │ │ │ │ │ -00013840: 6d61 6b65 2074 6f20 656e 7375 7265 0a6f make to ensure.o │ │ │ │ │ -00013850: 6c64 6572 2072 656c 6561 7365 7320 7769 lder releases wi │ │ │ │ │ -00013860: 6c6c 206e 6f74 2062 6520 7573 6564 2e20 ll not be used. │ │ │ │ │ -00013870: 2046 6f72 2069 6e73 7461 6e63 652c 2075 For instance, u │ │ │ │ │ -00013880: 7365 2074 6869 7320 696e 2079 6f75 720a se this in your. │ │ │ │ │ -00013890: 2763 6f6e 6669 6775 7265 2e61 6327 3a0a 'configure.ac':. │ │ │ │ │ -000138a0: 0a20 2020 2020 2020 414d 5f49 4e49 545f . AM_INIT_ │ │ │ │ │ -000138b0: 4155 544f 4d41 4b45 285b 312e 362e 315d AUTOMAKE([1.6.1] │ │ │ │ │ -000138c0: 2920 2020 2064 6e6c 2052 6571 7569 7265 ) dnl Require │ │ │ │ │ -000138d0: 2041 7574 6f6d 616b 6520 312e 362e 3120 Automake 1.6.1 │ │ │ │ │ -000138e0: 6f72 2062 6574 7465 722e 0a0a 6f72 2c20 or better...or, │ │ │ │ │ -000138f0: 696e 2061 2070 6172 7469 6375 6c61 7220 in a particular │ │ │ │ │ -00013900: 274d 616b 6566 696c 652e 616d 273a 0a0a 'Makefile.am':.. │ │ │ │ │ -00013910: 2020 2020 2020 2041 5554 4f4d 414b 455f AUTOMAKE_ │ │ │ │ │ -00013920: 4f50 5449 4f4e 5320 3d20 312e 362e 3120 OPTIONS = 1.6.1 │ │ │ │ │ -00013930: 2020 2320 5265 7175 6972 6520 4175 746f # Require Auto │ │ │ │ │ -00013940: 6d61 6b65 2031 2e36 2e31 206f 7220 6265 make 1.6.1 or be │ │ │ │ │ -00013950: 7474 6572 2e0a 0a41 7574 6f6d 616b 6520 tter...Automake │ │ │ │ │ -00013960: 7769 6c6c 2070 7269 6e74 2061 6e20 6572 will print an er │ │ │ │ │ -00013970: 726f 7220 6d65 7373 6167 6520 6966 2069 ror message if i │ │ │ │ │ -00013980: 7473 2076 6572 7369 6f6e 2069 7320 6f6c ts version is ol │ │ │ │ │ -00013990: 6465 7220 7468 616e 2074 6865 0a72 6571 der than the.req │ │ │ │ │ -000139a0: 7565 7374 6564 2076 6572 7369 6f6e 2e0a uested version.. │ │ │ │ │ -000139b0: 0a57 6861 7420 6973 2069 6e20 7468 6520 .What is in the │ │ │ │ │ -000139c0: 4150 490a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d API.============ │ │ │ │ │ -000139d0: 3d3d 3d3d 3d3d 0a0a 4175 746f 6d61 6b65 ======..Automake │ │ │ │ │ -000139e0: 2773 2070 726f 6772 616d 6d69 6e67 2069 's programming i │ │ │ │ │ -000139f0: 6e74 6572 6661 6365 2069 7320 6e6f 7420 nterface is not │ │ │ │ │ -00013a00: 6561 7379 2074 6f20 6465 6669 6e65 2e20 easy to define. │ │ │ │ │ -00013a10: 2042 6173 6963 616c 6c79 2069 740a 7368 Basically it.sh │ │ │ │ │ -00013a20: 6f75 6c64 2069 6e63 6c75 6465 2061 7420 ould include at │ │ │ │ │ -00013a30: 6c65 6173 7420 616c 6c20 2a64 6f63 756d least all *docum │ │ │ │ │ -00013a40: 656e 7465 642a 2076 6172 6961 626c 6573 ented* variables │ │ │ │ │ -00013a50: 2061 6e64 2074 6172 6765 7473 2074 6861 and targets tha │ │ │ │ │ -00013a60: 7420 610a 274d 616b 6566 696c 652e 616d t a.'Makefile.am │ │ │ │ │ -00013a70: 2720 6175 7468 6f72 2063 616e 2075 7365 ' author can use │ │ │ │ │ -00013a80: 2c20 616e 7920 6265 6861 7669 6f72 2061 , any behavior a │ │ │ │ │ -00013a90: 7373 6f63 6961 7465 6420 7769 7468 2074 ssociated with t │ │ │ │ │ -00013aa0: 6865 6d20 2865 2e67 2e2c 0a74 6865 2070 hem (e.g.,.the p │ │ │ │ │ -00013ab0: 6c61 6365 7320 7768 6572 6520 272d 686f laces where '-ho │ │ │ │ │ -00013ac0: 6f6b 2727 7320 6172 6520 7275 6e29 2c20 ok''s are run), │ │ │ │ │ -00013ad0: 7468 6520 636f 6d6d 616e 6420 6c69 6e65 the command line │ │ │ │ │ -00013ae0: 2069 6e74 6572 6661 6365 206f 660a 2761 interface of.'a │ │ │ │ │ -00013af0: 7574 6f6d 616b 6527 2061 6e64 2027 6163 utomake' and 'ac │ │ │ │ │ -00013b00: 6c6f 6361 6c27 2c20 2e2e 2e0a 0a57 6861 local', .....Wha │ │ │ │ │ -00013b10: 7420 6973 206e 6f74 2069 6e20 7468 6520 t is not in the │ │ │ │ │ -00013b20: 4150 490a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d API.============ │ │ │ │ │ -00013b30: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4576 6572 ==========..Ever │ │ │ │ │ -00013b40: 7920 756e 646f 6375 6d65 6e74 6564 2076 y undocumented v │ │ │ │ │ -00013b50: 6172 6961 626c 652c 2074 6172 6765 742c ariable, target, │ │ │ │ │ -00013b60: 206f 7220 636f 6d6d 616e 6420 6c69 6e65 or command line │ │ │ │ │ -00013b70: 206f 7074 696f 6e2c 2069 7320 6e6f 7420 option, is not │ │ │ │ │ -00013b80: 7061 7274 0a6f 6620 7468 6520 4150 492e part.of the API. │ │ │ │ │ -00013b90: 2020 596f 7520 7368 6f75 6c64 2061 766f You should avo │ │ │ │ │ -00013ba0: 6964 2075 7369 6e67 2074 6865 6d2c 2061 id using them, a │ │ │ │ │ -00013bb0: 7320 7468 6579 2063 6f75 6c64 2063 6861 s they could cha │ │ │ │ │ -00013bc0: 6e67 6520 6672 6f6d 206f 6e65 0a76 6572 nge from one.ver │ │ │ │ │ -00013bd0: 7369 6f6e 2074 6f20 7468 6520 6f74 6865 sion to the othe │ │ │ │ │ -00013be0: 7220 2865 7665 6e20 696e 2062 7567 2066 r (even in bug f │ │ │ │ │ -00013bf0: 6978 2072 656c 6561 7365 732c 2069 6620 ix releases, if │ │ │ │ │ -00013c00: 7468 6973 2068 656c 7073 2074 6f20 6669 this helps to fi │ │ │ │ │ -00013c10: 7820 610a 6275 6729 2e0a 0a20 2020 4966 x a.bug)... If │ │ │ │ │ -00013c20: 2069 7420 7475 726e 7320 6f75 7420 796f it turns out yo │ │ │ │ │ -00013c30: 7520 6e65 6564 2074 6f20 7573 6520 7375 u need to use su │ │ │ │ │ -00013c40: 6368 2061 6e20 756e 646f 6375 6d65 6e74 ch an undocument │ │ │ │ │ -00013c50: 6564 2066 6561 7475 7265 2c20 636f 6e74 ed feature, cont │ │ │ │ │ -00013c60: 6163 740a 3c61 7574 6f6d 616b 6540 676e act. and try t │ │ │ │ │ -00013c80: 6f20 6765 7420 6974 2064 6f63 756d 656e o get it documen │ │ │ │ │ -00013c90: 7465 6420 616e 6420 6578 6572 6369 7365 ted and exercise │ │ │ │ │ -00013ca0: 6420 6279 2074 6865 0a74 6573 742d 7375 d by the.test-su │ │ │ │ │ -00013cb0: 6974 652e 0a0a 1f0a 4669 6c65 3a20 6175 ite.....File: au │ │ │ │ │ -00013cc0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -00013cd0: 2c20 204e 6f64 653a 2055 7067 7261 6469 , Node: Upgradi │ │ │ │ │ -00013ce0: 6e67 2c20 204e 6578 743a 2046 4151 2c20 ng, Next: FAQ, │ │ │ │ │ -00013cf0: 2050 7265 763a 2041 5049 2056 6572 7369 Prev: API Versi │ │ │ │ │ -00013d00: 6f6e 696e 672c 2020 5570 3a20 546f 700a oning, Up: Top. │ │ │ │ │ -00013d10: 0a32 3720 5570 6772 6164 696e 6720 6120 .27 Upgrading a │ │ │ │ │ -00013d20: 5061 636b 6167 6520 746f 2061 204e 6577 Package to a New │ │ │ │ │ -00013d30: 6572 2041 7574 6f6d 616b 6520 5665 7273 er Automake Vers │ │ │ │ │ -00013d40: 696f 6e0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ion.************ │ │ │ │ │ +00013080: 2a2a 2a0a 0a41 7574 6f6d 616b 6520 706c ***..Automake pl │ │ │ │ │ +00013090: 6163 6573 206e 6f20 7265 7374 7269 6374 aces no restrict │ │ │ │ │ +000130a0: 696f 6e73 206f 6e20 7468 6520 6469 7374 ions on the dist │ │ │ │ │ +000130b0: 7269 6275 7469 6f6e 206f 6620 7468 6520 ribution of the │ │ │ │ │ +000130c0: 7265 7375 6c74 696e 670a 274d 616b 6566 resulting.'Makef │ │ │ │ │ +000130d0: 696c 652e 696e 2773 2e20 2057 6520 7374 ile.in's. We st │ │ │ │ │ +000130e0: 696c 6c20 656e 636f 7572 6167 6520 736f ill encourage so │ │ │ │ │ +000130f0: 6674 7761 7265 2061 7574 686f 7273 2074 ftware authors t │ │ │ │ │ +00013100: 6f20 6469 7374 7269 6275 7465 2074 6865 o distribute the │ │ │ │ │ +00013110: 6972 0a77 6f72 6b20 756e 6465 7220 7465 ir.work under te │ │ │ │ │ +00013120: 726d 7320 6c69 6b65 2074 686f 7365 206f rms like those o │ │ │ │ │ +00013130: 6620 7468 6520 4750 4c2c 2062 7574 2064 f the GPL, but d │ │ │ │ │ +00013140: 6f69 6e67 2073 6f20 6973 206e 6f74 2072 oing so is not r │ │ │ │ │ +00013150: 6571 7569 7265 6420 746f 0a75 7365 2041 equired to.use A │ │ │ │ │ +00013160: 7574 6f6d 616b 652e 0a0a 2020 2053 6f6d utomake... Som │ │ │ │ │ +00013170: 6520 6f66 2074 6865 2066 696c 6573 2074 e of the files t │ │ │ │ │ +00013180: 6861 7420 6361 6e20 6265 2061 7574 6f6d hat can be autom │ │ │ │ │ +00013190: 6174 6963 616c 6c79 2069 6e73 7461 6c6c atically install │ │ │ │ │ +000131a0: 6564 2076 6961 2074 6865 0a27 2d2d 6164 ed via the.'--ad │ │ │ │ │ +000131b0: 642d 6d69 7373 696e 6727 2073 7769 7463 d-missing' switc │ │ │ │ │ +000131c0: 6820 646f 2066 616c 6c20 756e 6465 7220 h do fall under │ │ │ │ │ +000131d0: 7468 6520 4750 4c2e 2020 486f 7765 7665 the GPL. Howeve │ │ │ │ │ +000131e0: 722c 2074 6865 7365 2061 6c73 6f20 6861 r, these also ha │ │ │ │ │ +000131f0: 7665 0a61 2073 7065 6369 616c 2065 7863 ve.a special exc │ │ │ │ │ +00013200: 6570 7469 6f6e 2061 6c6c 6f77 696e 6720 eption allowing │ │ │ │ │ +00013210: 796f 7520 746f 2064 6973 7472 6962 7574 you to distribut │ │ │ │ │ +00013220: 6520 7468 656d 2077 6974 6820 796f 7572 e them with your │ │ │ │ │ +00013230: 2070 6163 6b61 6765 2c0a 7265 6761 7264 package,.regard │ │ │ │ │ +00013240: 6c65 7373 206f 6620 7468 6520 6c69 6365 less of the lice │ │ │ │ │ +00013250: 6e73 696e 6720 796f 7520 6368 6f6f 7365 nsing you choose │ │ │ │ │ +00013260: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +00013270: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +00013280: 4e6f 6465 3a20 4150 4920 5665 7273 696f Node: API Versio │ │ │ │ │ +00013290: 6e69 6e67 2c20 204e 6578 743a 2055 7067 ning, Next: Upg │ │ │ │ │ +000132a0: 7261 6469 6e67 2c20 2050 7265 763a 2044 rading, Prev: D │ │ │ │ │ +000132b0: 6973 7472 6962 7574 696e 672c 2020 5570 istributing, Up │ │ │ │ │ +000132c0: 3a20 546f 700a 0a32 3620 4175 746f 6d61 : Top..26 Automa │ │ │ │ │ +000132d0: 6b65 2041 5049 2056 6572 7369 6f6e 696e ke API Versionin │ │ │ │ │ +000132e0: 670a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a g.************** │ │ │ │ │ +000132f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4e65 ************..Ne │ │ │ │ │ +00013300: 7720 4175 746f 6d61 6b65 2072 656c 6561 w Automake relea │ │ │ │ │ +00013310: 7365 7320 7573 7561 6c6c 7920 696e 636c ses usually incl │ │ │ │ │ +00013320: 7564 6520 6275 6720 6669 7865 7320 616e ude bug fixes an │ │ │ │ │ +00013330: 6420 6e65 7720 6665 6174 7572 6573 2e0a d new features.. │ │ │ │ │ +00013340: 556e 666f 7274 756e 6174 656c 7920 7468 Unfortunately th │ │ │ │ │ +00013350: 6579 206d 6179 2061 6c73 6f20 696e 7472 ey may also intr │ │ │ │ │ +00013360: 6f64 7563 6520 6e65 7720 6275 6773 2061 oduce new bugs a │ │ │ │ │ +00013370: 6e64 2069 6e63 6f6d 7061 7469 6269 6c69 nd incompatibili │ │ │ │ │ +00013380: 7469 6573 2e0a 5468 6973 206d 616b 6573 ties..This makes │ │ │ │ │ +00013390: 2066 6f75 7220 7265 6173 6f6e 7320 7768 four reasons wh │ │ │ │ │ +000133a0: 7920 6120 7061 636b 6167 6520 6d61 7920 y a package may │ │ │ │ │ +000133b0: 7265 7175 6972 6520 6120 7061 7274 6963 require a partic │ │ │ │ │ +000133c0: 756c 6172 2041 7574 6f6d 616b 650a 7665 ular Automake.ve │ │ │ │ │ +000133d0: 7273 696f 6e2e 0a0a 2020 2054 6869 6e67 rsion... Thing │ │ │ │ │ +000133e0: 7320 6765 7420 776f 7273 6520 7768 656e s get worse when │ │ │ │ │ +000133f0: 206d 6169 6e74 6169 6e69 6e67 2061 206c maintaining a l │ │ │ │ │ +00013400: 6172 6765 2074 7265 6520 6f66 2070 6163 arge tree of pac │ │ │ │ │ +00013410: 6b61 6765 732c 2065 6163 6820 6f6e 650a kages, each one. │ │ │ │ │ +00013420: 7265 7175 6972 696e 6720 6120 6469 6666 requiring a diff │ │ │ │ │ +00013430: 6572 656e 7420 7665 7273 696f 6e20 6f66 erent version of │ │ │ │ │ +00013440: 2041 7574 6f6d 616b 652e 2020 496e 2074 Automake. In t │ │ │ │ │ +00013450: 6865 2070 6173 742c 2074 6869 7320 6d65 he past, this me │ │ │ │ │ +00013460: 616e 7420 7468 6174 0a61 6e79 2064 6576 ant that.any dev │ │ │ │ │ +00013470: 656c 6f70 6572 2028 616e 6420 736f 6d65 eloper (and some │ │ │ │ │ +00013480: 7469 6d65 7320 7573 6572 7329 2068 6164 times users) had │ │ │ │ │ +00013490: 2074 6f20 696e 7374 616c 6c20 7365 7665 to install seve │ │ │ │ │ +000134a0: 7261 6c20 7665 7273 696f 6e73 206f 660a ral versions of. │ │ │ │ │ +000134b0: 4175 746f 6d61 6b65 2069 6e20 6469 6666 Automake in diff │ │ │ │ │ +000134c0: 6572 656e 7420 706c 6163 6573 2c20 616e erent places, an │ │ │ │ │ +000134d0: 6420 7377 6974 6368 2027 2450 4154 4827 d switch '$PATH' │ │ │ │ │ +000134e0: 2061 7070 726f 7072 6961 7465 6c79 2066 appropriately f │ │ │ │ │ +000134f0: 6f72 2065 6163 680a 7061 636b 6167 652e or each.package. │ │ │ │ │ +00013500: 0a0a 2020 2053 7461 7274 696e 6720 7769 .. Starting wi │ │ │ │ │ +00013510: 7468 2076 6572 7369 6f6e 2031 2e36 2c20 th version 1.6, │ │ │ │ │ +00013520: 4175 746f 6d61 6b65 2069 6e73 7461 6c6c Automake install │ │ │ │ │ +00013530: 7320 7665 7273 696f 6e65 6420 6269 6e61 s versioned bina │ │ │ │ │ +00013540: 7269 6573 2e0a 5468 6973 206d 6561 6e73 ries..This means │ │ │ │ │ +00013550: 2079 6f75 2063 616e 2069 6e73 7461 6c6c you can install │ │ │ │ │ +00013560: 2073 6576 6572 616c 2076 6572 7369 6f6e several version │ │ │ │ │ +00013570: 7320 6f66 2041 7574 6f6d 616b 6520 696e s of Automake in │ │ │ │ │ +00013580: 2074 6865 2073 616d 650a 2724 7072 6566 the same.'$pref │ │ │ │ │ +00013590: 6978 272c 2061 6e64 2063 616e 2073 656c ix', and can sel │ │ │ │ │ +000135a0: 6563 7420 616e 2061 7262 6974 7261 7279 ect an arbitrary │ │ │ │ │ +000135b0: 2041 7574 6f6d 616b 6520 7665 7273 696f Automake versio │ │ │ │ │ +000135c0: 6e20 6279 2072 756e 6e69 6e67 0a27 6175 n by running.'au │ │ │ │ │ +000135d0: 746f 6d61 6b65 2d31 2e36 2720 6f72 2027 tomake-1.6' or ' │ │ │ │ │ +000135e0: 6175 746f 6d61 6b65 2d31 2e37 2720 7769 automake-1.7' wi │ │ │ │ │ +000135f0: 7468 6f75 7420 6a75 6767 6c69 6e67 2077 thout juggling w │ │ │ │ │ +00013600: 6974 6820 2724 5041 5448 272e 0a46 7572 ith '$PATH'..Fur │ │ │ │ │ +00013610: 7468 6572 6d6f 7265 2c20 274d 616b 6566 thermore, 'Makef │ │ │ │ │ +00013620: 696c 6527 2773 2067 656e 6572 6174 6564 ile''s generated │ │ │ │ │ +00013630: 2062 7920 4175 746f 6d61 6b65 2031 2e36 by Automake 1.6 │ │ │ │ │ +00013640: 2077 696c 6c20 7573 650a 2761 7574 6f6d will use.'autom │ │ │ │ │ +00013650: 616b 652d 312e 3627 2065 7870 6c69 6369 ake-1.6' explici │ │ │ │ │ +00013660: 746c 7920 696e 2074 6865 6972 2072 6562 tly in their reb │ │ │ │ │ +00013670: 7569 6c64 2072 756c 6573 2e0a 0a20 2020 uild rules... │ │ │ │ │ +00013680: 5468 6520 6e75 6d62 6572 2027 312e 3627 The number '1.6' │ │ │ │ │ +00013690: 2069 6e20 2761 7574 6f6d 616b 652d 312e in 'automake-1. │ │ │ │ │ +000136a0: 3627 2069 7320 4175 746f 6d61 6b65 2773 6' is Automake's │ │ │ │ │ +000136b0: 2041 5049 2076 6572 7369 6f6e 2c20 6e6f API version, no │ │ │ │ │ +000136c0: 740a 4175 746f 6d61 6b65 2773 2076 6572 t.Automake's ver │ │ │ │ │ +000136d0: 7369 6f6e 2e20 2049 6620 6120 6275 6720 sion. If a bug │ │ │ │ │ +000136e0: 6669 7820 7265 6c65 6173 6520 6973 206d fix release is m │ │ │ │ │ +000136f0: 6164 652c 2066 6f72 2069 6e73 7461 6e63 ade, for instanc │ │ │ │ │ +00013700: 6520 4175 746f 6d61 6b65 0a31 2e36 2e31 e Automake.1.6.1 │ │ │ │ │ +00013710: 2c20 7468 6520 4150 4920 7665 7273 696f , the API versio │ │ │ │ │ +00013720: 6e20 7769 6c6c 2072 656d 6169 6e20 312e n will remain 1. │ │ │ │ │ +00013730: 362e 2020 5468 6973 206d 6561 6e73 2074 6. This means t │ │ │ │ │ +00013740: 6861 7420 6120 7061 636b 6167 6520 7468 hat a package th │ │ │ │ │ +00013750: 6174 0a77 6f72 6b73 2077 6974 6820 4175 at.works with Au │ │ │ │ │ +00013760: 746f 6d61 6b65 2031 2e36 2073 686f 756c tomake 1.6 shoul │ │ │ │ │ +00013770: 6420 616c 736f 2077 6f72 6b20 7769 7468 d also work with │ │ │ │ │ +00013780: 2031 2e36 2e31 3b20 6166 7465 7220 616c 1.6.1; after al │ │ │ │ │ +00013790: 6c2c 2074 6869 7320 6973 0a77 6861 7420 l, this is.what │ │ │ │ │ +000137a0: 7065 6f70 6c65 2065 7870 6563 7420 6672 people expect fr │ │ │ │ │ +000137b0: 6f6d 2062 7567 2066 6978 2072 656c 6561 om bug fix relea │ │ │ │ │ +000137c0: 7365 732e 0a0a 2020 2049 6620 796f 7572 ses... If your │ │ │ │ │ +000137d0: 2070 6163 6b61 6765 2072 656c 6965 7320 package relies │ │ │ │ │ +000137e0: 6f6e 2061 2066 6561 7475 7265 206f 7220 on a feature or │ │ │ │ │ +000137f0: 6120 6275 6720 6669 7820 696e 7472 6f64 a bug fix introd │ │ │ │ │ +00013800: 7563 6564 2069 6e20 610a 7265 6c65 6173 uced in a.releas │ │ │ │ │ +00013810: 652c 2079 6f75 2063 616e 2070 6173 7320 e, you can pass │ │ │ │ │ +00013820: 7468 6973 2076 6572 7369 6f6e 2061 7320 this version as │ │ │ │ │ +00013830: 616e 206f 7074 696f 6e20 746f 2041 7574 an option to Aut │ │ │ │ │ +00013840: 6f6d 616b 6520 746f 2065 6e73 7572 650a omake to ensure. │ │ │ │ │ +00013850: 6f6c 6465 7220 7265 6c65 6173 6573 2077 older releases w │ │ │ │ │ +00013860: 696c 6c20 6e6f 7420 6265 2075 7365 642e ill not be used. │ │ │ │ │ +00013870: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ +00013880: 7573 6520 7468 6973 2069 6e20 796f 7572 use this in your │ │ │ │ │ +00013890: 0a27 636f 6e66 6967 7572 652e 6163 273a .'configure.ac': │ │ │ │ │ +000138a0: 0a0a 2020 2020 2020 2041 4d5f 494e 4954 .. AM_INIT │ │ │ │ │ +000138b0: 5f41 5554 4f4d 414b 4528 5b31 2e36 2e31 _AUTOMAKE([1.6.1 │ │ │ │ │ +000138c0: 5d29 2020 2020 646e 6c20 5265 7175 6972 ]) dnl Requir │ │ │ │ │ +000138d0: 6520 4175 746f 6d61 6b65 2031 2e36 2e31 e Automake 1.6.1 │ │ │ │ │ +000138e0: 206f 7220 6265 7474 6572 2e0a 0a6f 722c or better...or, │ │ │ │ │ +000138f0: 2069 6e20 6120 7061 7274 6963 756c 6172 in a particular │ │ │ │ │ +00013900: 2027 4d61 6b65 6669 6c65 2e61 6d27 3a0a 'Makefile.am':. │ │ │ │ │ +00013910: 0a20 2020 2020 2020 4155 544f 4d41 4b45 . AUTOMAKE │ │ │ │ │ +00013920: 5f4f 5054 494f 4e53 203d 2031 2e36 2e31 _OPTIONS = 1.6.1 │ │ │ │ │ +00013930: 2020 2023 2052 6571 7569 7265 2041 7574 # Require Aut │ │ │ │ │ +00013940: 6f6d 616b 6520 312e 362e 3120 6f72 2062 omake 1.6.1 or b │ │ │ │ │ +00013950: 6574 7465 722e 0a0a 4175 746f 6d61 6b65 etter...Automake │ │ │ │ │ +00013960: 2077 696c 6c20 7072 696e 7420 616e 2065 will print an e │ │ │ │ │ +00013970: 7272 6f72 206d 6573 7361 6765 2069 6620 rror message if │ │ │ │ │ +00013980: 6974 7320 7665 7273 696f 6e20 6973 206f its version is o │ │ │ │ │ +00013990: 6c64 6572 2074 6861 6e20 7468 650a 7265 lder than the.re │ │ │ │ │ +000139a0: 7175 6573 7465 6420 7665 7273 696f 6e2e quested version. │ │ │ │ │ +000139b0: 0a0a 5768 6174 2069 7320 696e 2074 6865 ..What is in the │ │ │ │ │ +000139c0: 2041 5049 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d API.=========== │ │ │ │ │ +000139d0: 3d3d 3d3d 3d3d 3d0a 0a41 7574 6f6d 616b =======..Automak │ │ │ │ │ +000139e0: 6527 7320 7072 6f67 7261 6d6d 696e 6720 e's programming │ │ │ │ │ +000139f0: 696e 7465 7266 6163 6520 6973 206e 6f74 interface is not │ │ │ │ │ +00013a00: 2065 6173 7920 746f 2064 6566 696e 652e easy to define. │ │ │ │ │ +00013a10: 2020 4261 7369 6361 6c6c 7920 6974 0a73 Basically it.s │ │ │ │ │ +00013a20: 686f 756c 6420 696e 636c 7564 6520 6174 hould include at │ │ │ │ │ +00013a30: 206c 6561 7374 2061 6c6c 202a 646f 6375 least all *docu │ │ │ │ │ +00013a40: 6d65 6e74 6564 2a20 7661 7269 6162 6c65 mented* variable │ │ │ │ │ +00013a50: 7320 616e 6420 7461 7267 6574 7320 7468 s and targets th │ │ │ │ │ +00013a60: 6174 2061 0a27 4d61 6b65 6669 6c65 2e61 at a.'Makefile.a │ │ │ │ │ +00013a70: 6d27 2061 7574 686f 7220 6361 6e20 7573 m' author can us │ │ │ │ │ +00013a80: 652c 2061 6e79 2062 6568 6176 696f 7220 e, any behavior │ │ │ │ │ +00013a90: 6173 736f 6369 6174 6564 2077 6974 6820 associated with │ │ │ │ │ +00013aa0: 7468 656d 2028 652e 672e 2c0a 7468 6520 them (e.g.,.the │ │ │ │ │ +00013ab0: 706c 6163 6573 2077 6865 7265 2027 2d68 places where '-h │ │ │ │ │ +00013ac0: 6f6f 6b27 2773 2061 7265 2072 756e 292c ook''s are run), │ │ │ │ │ +00013ad0: 2074 6865 2063 6f6d 6d61 6e64 206c 696e the command lin │ │ │ │ │ +00013ae0: 6520 696e 7465 7266 6163 6520 6f66 0a27 e interface of.' │ │ │ │ │ +00013af0: 6175 746f 6d61 6b65 2720 616e 6420 2761 automake' and 'a │ │ │ │ │ +00013b00: 636c 6f63 616c 272c 202e 2e2e 0a0a 5768 clocal', .....Wh │ │ │ │ │ +00013b10: 6174 2069 7320 6e6f 7420 696e 2074 6865 at is not in the │ │ │ │ │ +00013b20: 2041 5049 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d API.=========== │ │ │ │ │ +00013b30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a45 7665 ===========..Eve │ │ │ │ │ +00013b40: 7279 2075 6e64 6f63 756d 656e 7465 6420 ry undocumented │ │ │ │ │ +00013b50: 7661 7269 6162 6c65 2c20 7461 7267 6574 variable, target │ │ │ │ │ +00013b60: 2c20 6f72 2063 6f6d 6d61 6e64 206c 696e , or command lin │ │ │ │ │ +00013b70: 6520 6f70 7469 6f6e 2c20 6973 206e 6f74 e option, is not │ │ │ │ │ +00013b80: 2070 6172 740a 6f66 2074 6865 2041 5049 part.of the API │ │ │ │ │ +00013b90: 2e20 2059 6f75 2073 686f 756c 6420 6176 . You should av │ │ │ │ │ +00013ba0: 6f69 6420 7573 696e 6720 7468 656d 2c20 oid using them, │ │ │ │ │ +00013bb0: 6173 2074 6865 7920 636f 756c 6420 6368 as they could ch │ │ │ │ │ +00013bc0: 616e 6765 2066 726f 6d20 6f6e 650a 7665 ange from one.ve │ │ │ │ │ +00013bd0: 7273 696f 6e20 746f 2074 6865 206f 7468 rsion to the oth │ │ │ │ │ +00013be0: 6572 2028 6576 656e 2069 6e20 6275 6720 er (even in bug │ │ │ │ │ +00013bf0: 6669 7820 7265 6c65 6173 6573 2c20 6966 fix releases, if │ │ │ │ │ +00013c00: 2074 6869 7320 6865 6c70 7320 746f 2066 this helps to f │ │ │ │ │ +00013c10: 6978 2061 0a62 7567 292e 0a0a 2020 2049 ix a.bug)... I │ │ │ │ │ +00013c20: 6620 6974 2074 7572 6e73 206f 7574 2079 f it turns out y │ │ │ │ │ +00013c30: 6f75 206e 6565 6420 746f 2075 7365 2073 ou need to use s │ │ │ │ │ +00013c40: 7563 6820 616e 2075 6e64 6f63 756d 656e uch an undocumen │ │ │ │ │ +00013c50: 7465 6420 6665 6174 7572 652c 2063 6f6e ted feature, con │ │ │ │ │ +00013c60: 7461 6374 0a3c 6175 746f 6d61 6b65 4067 tact. and try │ │ │ │ │ +00013c80: 746f 2067 6574 2069 7420 646f 6375 6d65 to get it docume │ │ │ │ │ +00013c90: 6e74 6564 2061 6e64 2065 7865 7263 6973 nted and exercis │ │ │ │ │ +00013ca0: 6564 2062 7920 7468 650a 7465 7374 2d73 ed by the.test-s │ │ │ │ │ +00013cb0: 7569 7465 2e0a 0a1f 0a46 696c 653a 2061 uite.....File: a │ │ │ │ │ +00013cc0: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +00013cd0: 6f2c 2020 4e6f 6465 3a20 5570 6772 6164 o, Node: Upgrad │ │ │ │ │ +00013ce0: 696e 672c 2020 4e65 7874 3a20 4641 512c ing, Next: FAQ, │ │ │ │ │ +00013cf0: 2020 5072 6576 3a20 4150 4920 5665 7273 Prev: API Vers │ │ │ │ │ +00013d00: 696f 6e69 6e67 2c20 2055 703a 2054 6f70 ioning, Up: Top │ │ │ │ │ +00013d10: 0a0a 3237 2055 7067 7261 6469 6e67 2061 ..27 Upgrading a │ │ │ │ │ +00013d20: 2050 6163 6b61 6765 2074 6f20 6120 4e65 Package to a Ne │ │ │ │ │ +00013d30: 7765 7220 4175 746f 6d61 6b65 2056 6572 wer Automake Ver │ │ │ │ │ +00013d40: 7369 6f6e 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a sion.*********** │ │ │ │ │ 00013d50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 00013d60: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00013d70: 2a2a 2a2a 2a2a 0a0a 4175 746f 6d61 6b65 ******..Automake │ │ │ │ │ -00013d80: 206d 6169 6e74 6169 6e73 2074 6872 6565 maintains three │ │ │ │ │ -00013d90: 206b 696e 6420 6f66 2066 696c 6573 2069 kind of files i │ │ │ │ │ -00013da0: 6e20 6120 7061 636b 6167 652e 0a0a 2020 n a package... │ │ │ │ │ -00013db0: 202a 2027 6163 6c6f 6361 6c2e 6d34 270a * 'aclocal.m4'. │ │ │ │ │ -00013dc0: 2020 202a 2027 4d61 6b65 6669 6c65 2e69 * 'Makefile.i │ │ │ │ │ -00013dd0: 6e27 730a 2020 202a 2061 7578 696c 6961 n's. * auxilia │ │ │ │ │ -00013de0: 7279 2074 6f6f 6c73 206c 696b 6520 2769 ry tools like 'i │ │ │ │ │ -00013df0: 6e73 7461 6c6c 2d73 6827 206f 7220 2770 nstall-sh' or 'p │ │ │ │ │ -00013e00: 792d 636f 6d70 696c 6527 0a0a 2020 2027 y-compile'.. ' │ │ │ │ │ -00013e10: 6163 6c6f 6361 6c2e 6d34 2720 6973 2067 aclocal.m4' is g │ │ │ │ │ -00013e20: 656e 6572 6174 6564 2062 7920 2761 636c enerated by 'acl │ │ │ │ │ -00013e30: 6f63 616c 2720 616e 6420 636f 6e74 6169 ocal' and contai │ │ │ │ │ -00013e40: 6e73 2073 6f6d 650a 4175 746f 6d61 6b65 ns some.Automake │ │ │ │ │ -00013e50: 2d73 7570 706c 6965 6420 4d34 206d 6163 -supplied M4 mac │ │ │ │ │ -00013e60: 726f 732e 2020 4175 7869 6c69 6172 7920 ros. Auxiliary │ │ │ │ │ -00013e70: 746f 6f6c 7320 6172 6520 696e 7374 616c tools are instal │ │ │ │ │ -00013e80: 6c65 6420 6279 2027 6175 746f 6d61 6b65 led by 'automake │ │ │ │ │ -00013e90: 0a2d 2d61 6464 2d6d 6973 7369 6e67 2720 .--add-missing' │ │ │ │ │ -00013ea0: 7768 656e 206e 6565 6465 642e 2020 274d when needed. 'M │ │ │ │ │ -00013eb0: 616b 6566 696c 652e 696e 2773 2061 7265 akefile.in's are │ │ │ │ │ -00013ec0: 2062 7569 6c74 2066 726f 6d20 274d 616b built from 'Mak │ │ │ │ │ -00013ed0: 6566 696c 652e 616d 270a 6279 2027 6175 efile.am'.by 'au │ │ │ │ │ -00013ee0: 746f 6d61 6b65 272c 2061 6e64 2072 656c tomake', and rel │ │ │ │ │ -00013ef0: 7920 6f6e 2074 6865 2064 6566 696e 6974 y on the definit │ │ │ │ │ -00013f00: 696f 6e73 206f 6620 7468 6520 4d34 206d ions of the M4 m │ │ │ │ │ -00013f10: 6163 726f 7320 7075 7420 696e 0a27 6163 acros put in.'ac │ │ │ │ │ -00013f20: 6c6f 6361 6c2e 6d34 2720 6173 2077 656c local.m4' as wel │ │ │ │ │ -00013f30: 6c20 6173 2074 6865 2062 6568 6176 696f l as the behavio │ │ │ │ │ -00013f40: 7220 6f66 2074 6865 2061 7578 696c 6961 r of the auxilia │ │ │ │ │ -00013f50: 7279 2074 6f6f 6c73 2069 6e73 7461 6c6c ry tools install │ │ │ │ │ -00013f60: 6564 2e0a 0a20 2020 4265 6361 7573 6520 ed... Because │ │ │ │ │ -00013f70: 616c 6c20 7468 6573 6520 6669 6c65 7320 all these files │ │ │ │ │ -00013f80: 6172 6520 636c 6f73 656c 7920 7265 6c61 are closely rela │ │ │ │ │ -00013f90: 7465 642c 2069 7420 6973 2069 6d70 6f72 ted, it is impor │ │ │ │ │ -00013fa0: 7461 6e74 2074 6f0a 7265 6765 6e65 7261 tant to.regenera │ │ │ │ │ -00013fb0: 7465 2061 6c6c 206f 6620 7468 656d 2077 te all of them w │ │ │ │ │ -00013fc0: 6865 6e20 7570 6772 6164 696e 6720 746f hen upgrading to │ │ │ │ │ -00013fd0: 2061 206e 6577 6572 2041 7574 6f6d 616b a newer Automak │ │ │ │ │ -00013fe0: 6520 7265 6c65 6173 652e 2020 5468 650a e release. The. │ │ │ │ │ -00013ff0: 7573 7561 6c20 7761 7920 746f 2064 6f20 usual way to do │ │ │ │ │ -00014000: 7468 6174 2069 730a 0a20 2020 2020 6163 that is.. ac │ │ │ │ │ -00014010: 6c6f 6361 6c20 2320 7769 7468 2061 6e79 local # with any │ │ │ │ │ -00014020: 206f 7074 696f 6e20 6e65 6564 6564 2028 option needed ( │ │ │ │ │ -00014030: 7375 6368 2061 202d 4920 6d34 290a 2020 such a -I m4). │ │ │ │ │ -00014040: 2020 2061 7574 6f63 6f6e 660a 2020 2020 autoconf. │ │ │ │ │ -00014050: 2061 7574 6f6d 616b 6520 2d2d 6164 642d automake --add- │ │ │ │ │ -00014060: 6d69 7373 696e 6720 2d2d 666f 7263 652d missing --force- │ │ │ │ │ -00014070: 6d69 7373 696e 670a 0a6f 7220 6d6f 7265 missing..or more │ │ │ │ │ -00014080: 2063 6f6e 7665 6e69 656e 746c 793a 0a0a conveniently:.. │ │ │ │ │ -00014090: 2020 2020 2061 7574 6f72 6563 6f6e 6620 autoreconf │ │ │ │ │ -000140a0: 2d76 6669 0a0a 2020 2054 6865 2075 7365 -vfi.. The use │ │ │ │ │ -000140b0: 206f 6620 272d 2d66 6f72 6365 2d6d 6973 of '--force-mis │ │ │ │ │ -000140c0: 7369 6e67 2720 656e 7375 7265 7320 7468 sing' ensures th │ │ │ │ │ -000140d0: 6174 2061 7578 696c 6961 7279 2074 6f6f at auxiliary too │ │ │ │ │ -000140e0: 6c73 2077 696c 6c20 6265 0a6f 7665 7272 ls will be.overr │ │ │ │ │ -000140f0: 6964 6465 6e20 6279 206e 6577 2076 6572 idden by new ver │ │ │ │ │ -00014100: 7369 6f6e 7320 282a 6e6f 7465 2061 7574 sions (*note aut │ │ │ │ │ -00014110: 6f6d 616b 6520 496e 766f 6361 7469 6f6e omake Invocation │ │ │ │ │ -00014120: 3a3a 292e 0a0a 2020 2049 7420 6973 2069 ::)... It is i │ │ │ │ │ -00014130: 6d70 6f72 7461 6e74 2074 6f20 7265 6765 mportant to rege │ │ │ │ │ -00014140: 6e65 7261 7465 2061 6c6c 2074 6865 7365 nerate all these │ │ │ │ │ -00014150: 2066 696c 6573 2065 6163 6820 7469 6d65 files each time │ │ │ │ │ -00014160: 2041 7574 6f6d 616b 6520 6973 0a75 7067 Automake is.upg │ │ │ │ │ -00014170: 7261 6465 642c 2065 7665 6e20 6265 7477 raded, even betw │ │ │ │ │ -00014180: 6565 6e20 6275 6720 6669 7865 7320 7265 een bug fixes re │ │ │ │ │ -00014190: 6c65 6173 6573 2e20 2046 6f72 2069 6e73 leases. For ins │ │ │ │ │ -000141a0: 7461 6e63 652c 2069 7420 6973 206e 6f74 tance, it is not │ │ │ │ │ -000141b0: 0a75 6e75 7375 616c 2066 6f72 2061 2062 .unusual for a b │ │ │ │ │ -000141c0: 7567 2066 6978 2074 6f20 696e 766f 6c76 ug fix to involv │ │ │ │ │ -000141d0: 6520 6368 616e 6765 7320 746f 2062 6f74 e changes to bot │ │ │ │ │ -000141e0: 6820 7468 6520 7275 6c65 7320 6765 6e65 h the rules gene │ │ │ │ │ -000141f0: 7261 7465 6420 696e 0a27 4d61 6b65 6669 rated in.'Makefi │ │ │ │ │ -00014200: 6c65 2e69 6e27 2061 6e64 2074 6865 2073 le.in' and the s │ │ │ │ │ -00014210: 7570 706f 7274 696e 6720 4d34 206d 6163 upporting M4 mac │ │ │ │ │ -00014220: 726f 7320 636f 7069 6564 2074 6f20 2761 ros copied to 'a │ │ │ │ │ -00014230: 636c 6f63 616c 2e6d 3427 2e0a 0a20 2020 clocal.m4'... │ │ │ │ │ -00014240: 5072 6573 656e 746c 7920 2761 7574 6f6d Presently 'autom │ │ │ │ │ -00014250: 616b 6527 2069 7320 6162 6c65 2074 6f20 ake' is able to │ │ │ │ │ -00014260: 6469 6167 6e6f 7365 2073 6974 7561 7469 diagnose situati │ │ │ │ │ -00014270: 6f6e 7320 7768 6572 650a 2761 636c 6f63 ons where.'acloc │ │ │ │ │ -00014280: 616c 2e6d 3427 2068 6173 2062 6565 6e20 al.m4' has been │ │ │ │ │ -00014290: 6765 6e65 7261 7465 6420 7769 7468 2061 generated with a │ │ │ │ │ -000142a0: 6e6f 7468 6572 2076 6572 7369 6f6e 206f nother version o │ │ │ │ │ -000142b0: 6620 2761 636c 6f63 616c 272e 0a48 6f77 f 'aclocal'..How │ │ │ │ │ -000142c0: 6576 6572 2069 7420 6e65 7665 7220 6368 ever it never ch │ │ │ │ │ -000142d0: 6563 6b73 2077 6865 7468 6572 2061 7578 ecks whether aux │ │ │ │ │ -000142e0: 696c 6961 7279 2073 6372 6970 7473 2061 iliary scripts a │ │ │ │ │ -000142f0: 7265 2075 702d 746f 2d64 6174 652e 2020 re up-to-date. │ │ │ │ │ -00014300: 496e 0a6f 7468 6572 2077 6f72 6473 2c20 In.other words, │ │ │ │ │ -00014310: 2761 7574 6f6d 616b 6527 2077 696c 6c20 'automake' will │ │ │ │ │ -00014320: 7465 6c6c 2079 6f75 2077 6865 6e20 2761 tell you when 'a │ │ │ │ │ -00014330: 636c 6f63 616c 2720 6e65 6564 7320 746f clocal' needs to │ │ │ │ │ -00014340: 2062 6520 7265 7275 6e2c 0a62 7574 2069 be rerun,.but i │ │ │ │ │ -00014350: 7420 7769 6c6c 206e 6576 6572 2064 6961 t will never dia │ │ │ │ │ -00014360: 676e 6f73 6520 6120 6d69 7373 696e 6720 gnose a missing │ │ │ │ │ -00014370: 272d 2d66 6f72 6365 2d6d 6973 7369 6e67 '--force-missing │ │ │ │ │ -00014380: 272e 0a0a 2020 2042 6566 6f72 6520 7570 '... Before up │ │ │ │ │ -00014390: 6772 6164 696e 6720 746f 2061 206e 6577 grading to a new │ │ │ │ │ -000143a0: 206d 616a 6f72 2072 656c 6561 7365 2c20 major release, │ │ │ │ │ -000143b0: 6974 2069 7320 6120 676f 6f64 2069 6465 it is a good ide │ │ │ │ │ -000143c0: 6120 746f 2072 6561 640a 7468 6520 6669 a to read.the fi │ │ │ │ │ -000143d0: 6c65 2027 4e45 5753 272e 2020 5468 6973 le 'NEWS'. This │ │ │ │ │ -000143e0: 2066 696c 6520 6c69 7374 7320 616c 6c20 file lists all │ │ │ │ │ -000143f0: 6368 616e 6765 7320 6265 7477 6565 6e20 changes between │ │ │ │ │ -00014400: 7265 6c65 6173 6573 3a20 6e65 770a 6665 releases: new.fe │ │ │ │ │ -00014410: 6174 7572 6573 2c20 6f62 736f 6c65 7465 atures, obsolete │ │ │ │ │ -00014420: 2063 6f6e 7374 7275 6374 732c 206b 6e6f constructs, kno │ │ │ │ │ -00014430: 776e 2069 6e63 6f6d 7061 7469 6269 6c69 wn incompatibili │ │ │ │ │ -00014440: 7469 6573 2c20 616e 6420 776f 726b 6172 ties, and workar │ │ │ │ │ -00014450: 6f75 6e64 732e 0a0a 1f0a 4669 6c65 3a20 ounds.....File: │ │ │ │ │ -00014460: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -00014470: 666f 2c20 204e 6f64 653a 2046 4151 2c20 fo, Node: FAQ, │ │ │ │ │ -00014480: 204e 6578 743a 2048 6973 746f 7279 2c20 Next: History, │ │ │ │ │ -00014490: 2050 7265 763a 2055 7067 7261 6469 6e67 Prev: Upgrading │ │ │ │ │ -000144a0: 2c20 2055 703a 2054 6f70 0a0a 3238 2046 , Up: Top..28 F │ │ │ │ │ -000144b0: 7265 7175 656e 746c 7920 4173 6b65 6420 requently Asked │ │ │ │ │ -000144c0: 5175 6573 7469 6f6e 7320 6162 6f75 7420 Questions about │ │ │ │ │ -000144d0: 4175 746f 6d61 6b65 0a2a 2a2a 2a2a 2a2a Automake.******* │ │ │ │ │ +00013d70: 2a2a 2a2a 2a2a 2a0a 0a41 7574 6f6d 616b *******..Automak │ │ │ │ │ +00013d80: 6520 6d61 696e 7461 696e 7320 7468 7265 e maintains thre │ │ │ │ │ +00013d90: 6520 6b69 6e64 206f 6620 6669 6c65 7320 e kind of files │ │ │ │ │ +00013da0: 696e 2061 2070 6163 6b61 6765 2e0a 0a20 in a package... │ │ │ │ │ +00013db0: 2020 2a20 2761 636c 6f63 616c 2e6d 3427 * 'aclocal.m4' │ │ │ │ │ +00013dc0: 0a20 2020 2a20 274d 616b 6566 696c 652e . * 'Makefile. │ │ │ │ │ +00013dd0: 696e 2773 0a20 2020 2a20 6175 7869 6c69 in's. * auxili │ │ │ │ │ +00013de0: 6172 7920 746f 6f6c 7320 6c69 6b65 2027 ary tools like ' │ │ │ │ │ +00013df0: 696e 7374 616c 6c2d 7368 2720 6f72 2027 install-sh' or ' │ │ │ │ │ +00013e00: 7079 2d63 6f6d 7069 6c65 270a 0a20 2020 py-compile'.. │ │ │ │ │ +00013e10: 2761 636c 6f63 616c 2e6d 3427 2069 7320 'aclocal.m4' is │ │ │ │ │ +00013e20: 6765 6e65 7261 7465 6420 6279 2027 6163 generated by 'ac │ │ │ │ │ +00013e30: 6c6f 6361 6c27 2061 6e64 2063 6f6e 7461 local' and conta │ │ │ │ │ +00013e40: 696e 7320 736f 6d65 0a41 7574 6f6d 616b ins some.Automak │ │ │ │ │ +00013e50: 652d 7375 7070 6c69 6564 204d 3420 6d61 e-supplied M4 ma │ │ │ │ │ +00013e60: 6372 6f73 2e20 2041 7578 696c 6961 7279 cros. Auxiliary │ │ │ │ │ +00013e70: 2074 6f6f 6c73 2061 7265 2069 6e73 7461 tools are insta │ │ │ │ │ +00013e80: 6c6c 6564 2062 7920 2761 7574 6f6d 616b lled by 'automak │ │ │ │ │ +00013e90: 650a 2d2d 6164 642d 6d69 7373 696e 6727 e.--add-missing' │ │ │ │ │ +00013ea0: 2077 6865 6e20 6e65 6564 6564 2e20 2027 when needed. ' │ │ │ │ │ +00013eb0: 4d61 6b65 6669 6c65 2e69 6e27 7320 6172 Makefile.in's ar │ │ │ │ │ +00013ec0: 6520 6275 696c 7420 6672 6f6d 2027 4d61 e built from 'Ma │ │ │ │ │ +00013ed0: 6b65 6669 6c65 2e61 6d27 0a62 7920 2761 kefile.am'.by 'a │ │ │ │ │ +00013ee0: 7574 6f6d 616b 6527 2c20 616e 6420 7265 utomake', and re │ │ │ │ │ +00013ef0: 6c79 206f 6e20 7468 6520 6465 6669 6e69 ly on the defini │ │ │ │ │ +00013f00: 7469 6f6e 7320 6f66 2074 6865 204d 3420 tions of the M4 │ │ │ │ │ +00013f10: 6d61 6372 6f73 2070 7574 2069 6e0a 2761 macros put in.'a │ │ │ │ │ +00013f20: 636c 6f63 616c 2e6d 3427 2061 7320 7765 clocal.m4' as we │ │ │ │ │ +00013f30: 6c6c 2061 7320 7468 6520 6265 6861 7669 ll as the behavi │ │ │ │ │ +00013f40: 6f72 206f 6620 7468 6520 6175 7869 6c69 or of the auxili │ │ │ │ │ +00013f50: 6172 7920 746f 6f6c 7320 696e 7374 616c ary tools instal │ │ │ │ │ +00013f60: 6c65 642e 0a0a 2020 2042 6563 6175 7365 led... Because │ │ │ │ │ +00013f70: 2061 6c6c 2074 6865 7365 2066 696c 6573 all these files │ │ │ │ │ +00013f80: 2061 7265 2063 6c6f 7365 6c79 2072 656c are closely rel │ │ │ │ │ +00013f90: 6174 6564 2c20 6974 2069 7320 696d 706f ated, it is impo │ │ │ │ │ +00013fa0: 7274 616e 7420 746f 0a72 6567 656e 6572 rtant to.regener │ │ │ │ │ +00013fb0: 6174 6520 616c 6c20 6f66 2074 6865 6d20 ate all of them │ │ │ │ │ +00013fc0: 7768 656e 2075 7067 7261 6469 6e67 2074 when upgrading t │ │ │ │ │ +00013fd0: 6f20 6120 6e65 7765 7220 4175 746f 6d61 o a newer Automa │ │ │ │ │ +00013fe0: 6b65 2072 656c 6561 7365 2e20 2054 6865 ke release. The │ │ │ │ │ +00013ff0: 0a75 7375 616c 2077 6179 2074 6f20 646f .usual way to do │ │ │ │ │ +00014000: 2074 6861 7420 6973 0a0a 2020 2020 2061 that is.. a │ │ │ │ │ +00014010: 636c 6f63 616c 2023 2077 6974 6820 616e clocal # with an │ │ │ │ │ +00014020: 7920 6f70 7469 6f6e 206e 6565 6465 6420 y option needed │ │ │ │ │ +00014030: 2873 7563 6820 6120 2d49 206d 3429 0a20 (such a -I m4). │ │ │ │ │ +00014040: 2020 2020 6175 746f 636f 6e66 0a20 2020 autoconf. │ │ │ │ │ +00014050: 2020 6175 746f 6d61 6b65 202d 2d61 6464 automake --add │ │ │ │ │ +00014060: 2d6d 6973 7369 6e67 202d 2d66 6f72 6365 -missing --force │ │ │ │ │ +00014070: 2d6d 6973 7369 6e67 0a0a 6f72 206d 6f72 -missing..or mor │ │ │ │ │ +00014080: 6520 636f 6e76 656e 6965 6e74 6c79 3a0a e conveniently:. │ │ │ │ │ +00014090: 0a20 2020 2020 6175 746f 7265 636f 6e66 . autoreconf │ │ │ │ │ +000140a0: 202d 7666 690a 0a20 2020 5468 6520 7573 -vfi.. The us │ │ │ │ │ +000140b0: 6520 6f66 2027 2d2d 666f 7263 652d 6d69 e of '--force-mi │ │ │ │ │ +000140c0: 7373 696e 6727 2065 6e73 7572 6573 2074 ssing' ensures t │ │ │ │ │ +000140d0: 6861 7420 6175 7869 6c69 6172 7920 746f hat auxiliary to │ │ │ │ │ +000140e0: 6f6c 7320 7769 6c6c 2062 650a 6f76 6572 ols will be.over │ │ │ │ │ +000140f0: 7269 6464 656e 2062 7920 6e65 7720 7665 ridden by new ve │ │ │ │ │ +00014100: 7273 696f 6e73 2028 2a6e 6f74 6520 6175 rsions (*note au │ │ │ │ │ +00014110: 746f 6d61 6b65 2049 6e76 6f63 6174 696f tomake Invocatio │ │ │ │ │ +00014120: 6e3a 3a29 2e0a 0a20 2020 4974 2069 7320 n::)... It is │ │ │ │ │ +00014130: 696d 706f 7274 616e 7420 746f 2072 6567 important to reg │ │ │ │ │ +00014140: 656e 6572 6174 6520 616c 6c20 7468 6573 enerate all thes │ │ │ │ │ +00014150: 6520 6669 6c65 7320 6561 6368 2074 696d e files each tim │ │ │ │ │ +00014160: 6520 4175 746f 6d61 6b65 2069 730a 7570 e Automake is.up │ │ │ │ │ +00014170: 6772 6164 6564 2c20 6576 656e 2062 6574 graded, even bet │ │ │ │ │ +00014180: 7765 656e 2062 7567 2066 6978 6573 2072 ween bug fixes r │ │ │ │ │ +00014190: 656c 6561 7365 732e 2020 466f 7220 696e eleases. For in │ │ │ │ │ +000141a0: 7374 616e 6365 2c20 6974 2069 7320 6e6f stance, it is no │ │ │ │ │ +000141b0: 740a 756e 7573 7561 6c20 666f 7220 6120 t.unusual for a │ │ │ │ │ +000141c0: 6275 6720 6669 7820 746f 2069 6e76 6f6c bug fix to invol │ │ │ │ │ +000141d0: 7665 2063 6861 6e67 6573 2074 6f20 626f ve changes to bo │ │ │ │ │ +000141e0: 7468 2074 6865 2072 756c 6573 2067 656e th the rules gen │ │ │ │ │ +000141f0: 6572 6174 6564 2069 6e0a 274d 616b 6566 erated in.'Makef │ │ │ │ │ +00014200: 696c 652e 696e 2720 616e 6420 7468 6520 ile.in' and the │ │ │ │ │ +00014210: 7375 7070 6f72 7469 6e67 204d 3420 6d61 supporting M4 ma │ │ │ │ │ +00014220: 6372 6f73 2063 6f70 6965 6420 746f 2027 cros copied to ' │ │ │ │ │ +00014230: 6163 6c6f 6361 6c2e 6d34 272e 0a0a 2020 aclocal.m4'... │ │ │ │ │ +00014240: 2050 7265 7365 6e74 6c79 2027 6175 746f Presently 'auto │ │ │ │ │ +00014250: 6d61 6b65 2720 6973 2061 626c 6520 746f make' is able to │ │ │ │ │ +00014260: 2064 6961 676e 6f73 6520 7369 7475 6174 diagnose situat │ │ │ │ │ +00014270: 696f 6e73 2077 6865 7265 0a27 6163 6c6f ions where.'aclo │ │ │ │ │ +00014280: 6361 6c2e 6d34 2720 6861 7320 6265 656e cal.m4' has been │ │ │ │ │ +00014290: 2067 656e 6572 6174 6564 2077 6974 6820 generated with │ │ │ │ │ +000142a0: 616e 6f74 6865 7220 7665 7273 696f 6e20 another version │ │ │ │ │ +000142b0: 6f66 2027 6163 6c6f 6361 6c27 2e0a 486f of 'aclocal'..Ho │ │ │ │ │ +000142c0: 7765 7665 7220 6974 206e 6576 6572 2063 wever it never c │ │ │ │ │ +000142d0: 6865 636b 7320 7768 6574 6865 7220 6175 hecks whether au │ │ │ │ │ +000142e0: 7869 6c69 6172 7920 7363 7269 7074 7320 xiliary scripts │ │ │ │ │ +000142f0: 6172 6520 7570 2d74 6f2d 6461 7465 2e20 are up-to-date. │ │ │ │ │ +00014300: 2049 6e0a 6f74 6865 7220 776f 7264 732c In.other words, │ │ │ │ │ +00014310: 2027 6175 746f 6d61 6b65 2720 7769 6c6c 'automake' will │ │ │ │ │ +00014320: 2074 656c 6c20 796f 7520 7768 656e 2027 tell you when ' │ │ │ │ │ +00014330: 6163 6c6f 6361 6c27 206e 6565 6473 2074 aclocal' needs t │ │ │ │ │ +00014340: 6f20 6265 2072 6572 756e 2c0a 6275 7420 o be rerun,.but │ │ │ │ │ +00014350: 6974 2077 696c 6c20 6e65 7665 7220 6469 it will never di │ │ │ │ │ +00014360: 6167 6e6f 7365 2061 206d 6973 7369 6e67 agnose a missing │ │ │ │ │ +00014370: 2027 2d2d 666f 7263 652d 6d69 7373 696e '--force-missin │ │ │ │ │ +00014380: 6727 2e0a 0a20 2020 4265 666f 7265 2075 g'... Before u │ │ │ │ │ +00014390: 7067 7261 6469 6e67 2074 6f20 6120 6e65 pgrading to a ne │ │ │ │ │ +000143a0: 7720 6d61 6a6f 7220 7265 6c65 6173 652c w major release, │ │ │ │ │ +000143b0: 2069 7420 6973 2061 2067 6f6f 6420 6964 it is a good id │ │ │ │ │ +000143c0: 6561 2074 6f20 7265 6164 0a74 6865 2066 ea to read.the f │ │ │ │ │ +000143d0: 696c 6520 274e 4557 5327 2e20 2054 6869 ile 'NEWS'. Thi │ │ │ │ │ +000143e0: 7320 6669 6c65 206c 6973 7473 2061 6c6c s file lists all │ │ │ │ │ +000143f0: 2063 6861 6e67 6573 2062 6574 7765 656e changes between │ │ │ │ │ +00014400: 2072 656c 6561 7365 733a 206e 6577 0a66 releases: new.f │ │ │ │ │ +00014410: 6561 7475 7265 732c 206f 6273 6f6c 6574 eatures, obsolet │ │ │ │ │ +00014420: 6520 636f 6e73 7472 7563 7473 2c20 6b6e e constructs, kn │ │ │ │ │ +00014430: 6f77 6e20 696e 636f 6d70 6174 6962 696c own incompatibil │ │ │ │ │ +00014440: 6974 6965 732c 2061 6e64 2077 6f72 6b61 ities, and worka │ │ │ │ │ +00014450: 726f 756e 6473 2e0a 0a1f 0a46 696c 653a rounds.....File: │ │ │ │ │ +00014460: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +00014470: 6e66 6f2c 2020 4e6f 6465 3a20 4641 512c nfo, Node: FAQ, │ │ │ │ │ +00014480: 2020 4e65 7874 3a20 4869 7374 6f72 792c Next: History, │ │ │ │ │ +00014490: 2020 5072 6576 3a20 5570 6772 6164 696e Prev: Upgradin │ │ │ │ │ +000144a0: 672c 2020 5570 3a20 546f 700a 0a32 3820 g, Up: Top..28 │ │ │ │ │ +000144b0: 4672 6571 7565 6e74 6c79 2041 736b 6564 Frequently Asked │ │ │ │ │ +000144c0: 2051 7565 7374 696f 6e73 2061 626f 7574 Questions about │ │ │ │ │ +000144d0: 2041 7574 6f6d 616b 650a 2a2a 2a2a 2a2a Automake.****** │ │ │ │ │ 000144e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 000144f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00014500: 2a2a 2a2a 2a0a 0a54 6869 7320 6368 6170 *****..This chap │ │ │ │ │ -00014510: 7465 7220 636f 7665 7273 2073 6f6d 6520 ter covers some │ │ │ │ │ -00014520: 7175 6573 7469 6f6e 7320 7468 6174 206f questions that o │ │ │ │ │ -00014530: 6674 656e 2063 6f6d 6520 7570 206f 6e20 ften come up on │ │ │ │ │ -00014540: 7468 6520 6d61 696c 696e 670a 6c69 7374 the mailing.list │ │ │ │ │ -00014550: 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2043 s...* Menu:..* C │ │ │ │ │ -00014560: 5653 3a3a 2020 2020 2020 2020 2020 2020 VS:: │ │ │ │ │ -00014570: 2020 2020 2020 2020 2020 2020 2043 5653 CVS │ │ │ │ │ -00014580: 2061 6e64 2067 656e 6572 6174 6564 2066 and generated f │ │ │ │ │ -00014590: 696c 6573 0a2a 206d 6169 6e74 6169 6e65 iles.* maintaine │ │ │ │ │ -000145a0: 722d 6d6f 6465 3a3a 2020 2020 2020 2020 r-mode:: │ │ │ │ │ -000145b0: 2020 2020 206d 6973 7369 6e67 2061 6e64 missing and │ │ │ │ │ -000145c0: 2041 4d5f 4d41 494e 5441 494e 4552 5f4d AM_MAINTAINER_M │ │ │ │ │ -000145d0: 4f44 450a 2a20 5769 6c64 6361 7264 733a ODE.* Wildcards: │ │ │ │ │ -000145e0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000145f0: 2020 2020 5768 7920 646f 6573 6e27 7420 Why doesn't │ │ │ │ │ -00014600: 4175 746f 6d61 6b65 2073 7570 706f 7274 Automake support │ │ │ │ │ -00014610: 2077 696c 6463 6172 6473 3f0a 2a20 4c69 wildcards?.* Li │ │ │ │ │ -00014620: 6d69 7461 7469 6f6e 7320 6f6e 2046 696c mitations on Fil │ │ │ │ │ -00014630: 6520 4e61 6d65 733a 3a20 2020 4c69 6d69 e Names:: Limi │ │ │ │ │ -00014640: 7461 7469 6f6e 7320 6f6e 2073 6f75 7263 tations on sourc │ │ │ │ │ -00014650: 6520 616e 6420 696e 7374 616c 6c65 6420 e and installed │ │ │ │ │ -00014660: 6669 6c65 206e 616d 6573 0a2a 2064 6973 file names.* dis │ │ │ │ │ -00014670: 7463 6c65 616e 6368 6563 6b3a 3a20 2020 tcleancheck:: │ │ │ │ │ -00014680: 2020 2020 2020 2020 2020 2046 696c 6573 Files │ │ │ │ │ -00014690: 206c 6566 7420 696e 2062 7569 6c64 2064 left in build d │ │ │ │ │ -000146a0: 6972 6563 746f 7279 2061 6674 6572 2064 irectory after d │ │ │ │ │ -000146b0: 6973 7463 6c65 616e 0a2a 2046 6c61 6720 istclean.* Flag │ │ │ │ │ -000146c0: 5661 7269 6162 6c65 7320 4f72 6465 7269 Variables Orderi │ │ │ │ │ -000146d0: 6e67 3a3a 2020 2020 2043 464c 4147 5320 ng:: CFLAGS │ │ │ │ │ -000146e0: 7673 2e20 414d 5f43 464c 4147 5320 7673 vs. AM_CFLAGS vs │ │ │ │ │ -000146f0: 2e20 6d75 6d62 6c65 5f43 464c 4147 530a . mumble_CFLAGS. │ │ │ │ │ -00014700: 2a20 5265 6e61 6d65 6420 4f62 6a65 6374 * Renamed Object │ │ │ │ │ -00014710: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ -00014720: 5768 7920 6172 6520 6f62 6a65 6374 2066 Why are object f │ │ │ │ │ -00014730: 696c 6573 2073 6f6d 6574 696d 6573 2072 iles sometimes r │ │ │ │ │ -00014740: 656e 616d 6564 3f0a 2a20 5065 722d 4f62 enamed?.* Per-Ob │ │ │ │ │ -00014750: 6a65 6374 2046 6c61 6773 3a3a 2020 2020 ject Flags:: │ │ │ │ │ -00014760: 2020 2020 2020 2020 486f 7720 746f 2073 How to s │ │ │ │ │ -00014770: 696d 756c 6174 6520 7065 722d 6f62 6a65 imulate per-obje │ │ │ │ │ -00014780: 6374 2066 6c61 6773 3f0a 2a20 4d75 6c74 ct flags?.* Mult │ │ │ │ │ -00014790: 6970 6c65 204f 7574 7075 7473 3a3a 2020 iple Outputs:: │ │ │ │ │ -000147a0: 2020 2020 2020 2020 2020 5772 6974 696e Writin │ │ │ │ │ -000147b0: 6720 7275 6c65 7320 666f 7220 746f 6f6c g rules for tool │ │ │ │ │ -000147c0: 7320 7769 7468 206d 616e 7920 6f75 7470 s with many outp │ │ │ │ │ -000147d0: 7574 2066 696c 6573 0a2a 2048 6172 642d ut files.* Hard- │ │ │ │ │ -000147e0: 436f 6465 6420 496e 7374 616c 6c20 5061 Coded Install Pa │ │ │ │ │ -000147f0: 7468 733a 3a20 2020 2049 6e73 7461 6c6c ths:: Install │ │ │ │ │ -00014800: 696e 6720 746f 2068 6172 642d 636f 6465 ing to hard-code │ │ │ │ │ -00014810: 6420 6c6f 6361 7469 6f6e 730a 2a20 4465 d locations.* De │ │ │ │ │ -00014820: 6275 6767 696e 6720 4d61 6b65 2052 756c bugging Make Rul │ │ │ │ │ -00014830: 6573 3a3a 2020 2020 2020 2020 5374 7261 es:: Stra │ │ │ │ │ -00014840: 7465 6769 6573 2077 6865 6e20 7468 696e tegies when thin │ │ │ │ │ -00014850: 6773 2064 6f6e 2774 2077 6f72 6b20 6173 gs don't work as │ │ │ │ │ -00014860: 2065 7870 6563 7465 640a 2a20 5265 706f expected.* Repo │ │ │ │ │ -00014870: 7274 696e 6720 4275 6773 3a3a 2020 2020 rting Bugs:: │ │ │ │ │ -00014880: 2020 2020 2020 2020 2020 4665 6564 6261 Feedba │ │ │ │ │ -00014890: 636b 206f 6e20 6275 6773 2061 6e64 2066 ck on bugs and f │ │ │ │ │ -000148a0: 6561 7475 7265 2072 6571 7565 7374 730a eature requests. │ │ │ │ │ -000148b0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -000148c0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -000148d0: 6465 3a20 4356 532c 2020 4e65 7874 3a20 de: CVS, Next: │ │ │ │ │ -000148e0: 6d61 696e 7461 696e 6572 2d6d 6f64 652c maintainer-mode, │ │ │ │ │ -000148f0: 2020 5570 3a20 4641 510a 0a32 382e 3120 Up: FAQ..28.1 │ │ │ │ │ -00014900: 4356 5320 616e 6420 6765 6e65 7261 7465 CVS and generate │ │ │ │ │ -00014910: 6420 6669 6c65 730a 3d3d 3d3d 3d3d 3d3d d files.======== │ │ │ │ │ +00014500: 2a2a 2a2a 2a2a 0a0a 5468 6973 2063 6861 ******..This cha │ │ │ │ │ +00014510: 7074 6572 2063 6f76 6572 7320 736f 6d65 pter covers some │ │ │ │ │ +00014520: 2071 7565 7374 696f 6e73 2074 6861 7420 questions that │ │ │ │ │ +00014530: 6f66 7465 6e20 636f 6d65 2075 7020 6f6e often come up on │ │ │ │ │ +00014540: 2074 6865 206d 6169 6c69 6e67 0a6c 6973 the mailing.lis │ │ │ │ │ +00014550: 7473 2e0a 0a2a 204d 656e 753a 0a0a 2a20 ts...* Menu:..* │ │ │ │ │ +00014560: 4356 533a 3a20 2020 2020 2020 2020 2020 CVS:: │ │ │ │ │ +00014570: 2020 2020 2020 2020 2020 2020 2020 4356 CV │ │ │ │ │ +00014580: 5320 616e 6420 6765 6e65 7261 7465 6420 S and generated │ │ │ │ │ +00014590: 6669 6c65 730a 2a20 6d61 696e 7461 696e files.* maintain │ │ │ │ │ +000145a0: 6572 2d6d 6f64 653a 3a20 2020 2020 2020 er-mode:: │ │ │ │ │ +000145b0: 2020 2020 2020 6d69 7373 696e 6720 616e missing an │ │ │ │ │ +000145c0: 6420 414d 5f4d 4149 4e54 4149 4e45 525f d AM_MAINTAINER_ │ │ │ │ │ +000145d0: 4d4f 4445 0a2a 2057 696c 6463 6172 6473 MODE.* Wildcards │ │ │ │ │ +000145e0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000145f0: 2020 2020 2057 6879 2064 6f65 736e 2774 Why doesn't │ │ │ │ │ +00014600: 2041 7574 6f6d 616b 6520 7375 7070 6f72 Automake suppor │ │ │ │ │ +00014610: 7420 7769 6c64 6361 7264 733f 0a2a 204c t wildcards?.* L │ │ │ │ │ +00014620: 696d 6974 6174 696f 6e73 206f 6e20 4669 imitations on Fi │ │ │ │ │ +00014630: 6c65 204e 616d 6573 3a3a 2020 204c 696d le Names:: Lim │ │ │ │ │ +00014640: 6974 6174 696f 6e73 206f 6e20 736f 7572 itations on sour │ │ │ │ │ +00014650: 6365 2061 6e64 2069 6e73 7461 6c6c 6564 ce and installed │ │ │ │ │ +00014660: 2066 696c 6520 6e61 6d65 730a 2a20 6469 file names.* di │ │ │ │ │ +00014670: 7374 636c 6561 6e63 6865 636b 3a3a 2020 stcleancheck:: │ │ │ │ │ +00014680: 2020 2020 2020 2020 2020 2020 4669 6c65 File │ │ │ │ │ +00014690: 7320 6c65 6674 2069 6e20 6275 696c 6420 s left in build │ │ │ │ │ +000146a0: 6469 7265 6374 6f72 7920 6166 7465 7220 directory after │ │ │ │ │ +000146b0: 6469 7374 636c 6561 6e0a 2a20 466c 6167 distclean.* Flag │ │ │ │ │ +000146c0: 2056 6172 6961 626c 6573 204f 7264 6572 Variables Order │ │ │ │ │ +000146d0: 696e 673a 3a20 2020 2020 4346 4c41 4753 ing:: CFLAGS │ │ │ │ │ +000146e0: 2076 732e 2041 4d5f 4346 4c41 4753 2076 vs. AM_CFLAGS v │ │ │ │ │ +000146f0: 732e 206d 756d 626c 655f 4346 4c41 4753 s. mumble_CFLAGS │ │ │ │ │ +00014700: 0a2a 2052 656e 616d 6564 204f 626a 6563 .* Renamed Objec │ │ │ │ │ +00014710: 7473 3a3a 2020 2020 2020 2020 2020 2020 ts:: │ │ │ │ │ +00014720: 2057 6879 2061 7265 206f 626a 6563 7420 Why are object │ │ │ │ │ +00014730: 6669 6c65 7320 736f 6d65 7469 6d65 7320 files sometimes │ │ │ │ │ +00014740: 7265 6e61 6d65 643f 0a2a 2050 6572 2d4f renamed?.* Per-O │ │ │ │ │ +00014750: 626a 6563 7420 466c 6167 733a 3a20 2020 bject Flags:: │ │ │ │ │ +00014760: 2020 2020 2020 2020 2048 6f77 2074 6f20 How to │ │ │ │ │ +00014770: 7369 6d75 6c61 7465 2070 6572 2d6f 626a simulate per-obj │ │ │ │ │ +00014780: 6563 7420 666c 6167 733f 0a2a 204d 756c ect flags?.* Mul │ │ │ │ │ +00014790: 7469 706c 6520 4f75 7470 7574 733a 3a20 tiple Outputs:: │ │ │ │ │ +000147a0: 2020 2020 2020 2020 2020 2057 7269 7469 Writi │ │ │ │ │ +000147b0: 6e67 2072 756c 6573 2066 6f72 2074 6f6f ng rules for too │ │ │ │ │ +000147c0: 6c73 2077 6974 6820 6d61 6e79 206f 7574 ls with many out │ │ │ │ │ +000147d0: 7075 7420 6669 6c65 730a 2a20 4861 7264 put files.* Hard │ │ │ │ │ +000147e0: 2d43 6f64 6564 2049 6e73 7461 6c6c 2050 -Coded Install P │ │ │ │ │ +000147f0: 6174 6873 3a3a 2020 2020 496e 7374 616c aths:: Instal │ │ │ │ │ +00014800: 6c69 6e67 2074 6f20 6861 7264 2d63 6f64 ling to hard-cod │ │ │ │ │ +00014810: 6564 206c 6f63 6174 696f 6e73 0a2a 2044 ed locations.* D │ │ │ │ │ +00014820: 6562 7567 6769 6e67 204d 616b 6520 5275 ebugging Make Ru │ │ │ │ │ +00014830: 6c65 733a 3a20 2020 2020 2020 2053 7472 les:: Str │ │ │ │ │ +00014840: 6174 6567 6965 7320 7768 656e 2074 6869 ategies when thi │ │ │ │ │ +00014850: 6e67 7320 646f 6e27 7420 776f 726b 2061 ngs don't work a │ │ │ │ │ +00014860: 7320 6578 7065 6374 6564 0a2a 2052 6570 s expected.* Rep │ │ │ │ │ +00014870: 6f72 7469 6e67 2042 7567 733a 3a20 2020 orting Bugs:: │ │ │ │ │ +00014880: 2020 2020 2020 2020 2020 2046 6565 6462 Feedb │ │ │ │ │ +00014890: 6163 6b20 6f6e 2062 7567 7320 616e 6420 ack on bugs and │ │ │ │ │ +000148a0: 6665 6174 7572 6520 7265 7175 6573 7473 feature requests │ │ │ │ │ +000148b0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +000148c0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +000148d0: 6f64 653a 2043 5653 2c20 204e 6578 743a ode: CVS, Next: │ │ │ │ │ +000148e0: 206d 6169 6e74 6169 6e65 722d 6d6f 6465 maintainer-mode │ │ │ │ │ +000148f0: 2c20 2055 703a 2046 4151 0a0a 3238 2e31 , Up: FAQ..28.1 │ │ │ │ │ +00014900: 2043 5653 2061 6e64 2067 656e 6572 6174 CVS and generat │ │ │ │ │ +00014910: 6564 2066 696c 6573 0a3d 3d3d 3d3d 3d3d ed files.======= │ │ │ │ │ 00014920: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00014930: 3d3d 3d3d 0a0a 4261 636b 6772 6f75 6e64 ====..Background │ │ │ │ │ -00014940: 3a20 6469 7374 7269 6275 7465 6420 6765 : distributed ge │ │ │ │ │ -00014950: 6e65 7261 7465 6420 4669 6c65 730a 2d2d nerated Files.-- │ │ │ │ │ +00014930: 3d3d 3d3d 3d0a 0a42 6163 6b67 726f 756e =====..Backgroun │ │ │ │ │ +00014940: 643a 2064 6973 7472 6962 7574 6564 2067 d: distributed g │ │ │ │ │ +00014950: 656e 6572 6174 6564 2046 696c 6573 0a2d enerated Files.- │ │ │ │ │ 00014960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00014970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00014980: 2d2d 2d2d 2d0a 0a50 6163 6b61 6765 7320 -----..Packages │ │ │ │ │ -00014990: 6d61 6465 2077 6974 6820 4175 746f 636f made with Autoco │ │ │ │ │ -000149a0: 6e66 2061 6e64 2041 7574 6f6d 616b 6520 nf and Automake │ │ │ │ │ -000149b0: 7368 6970 2077 6974 6820 736f 6d65 2067 ship with some g │ │ │ │ │ -000149c0: 656e 6572 6174 6564 2066 696c 6573 0a6c enerated files.l │ │ │ │ │ -000149d0: 696b 6520 2763 6f6e 6669 6775 7265 2720 ike 'configure' │ │ │ │ │ -000149e0: 6f72 2027 4d61 6b65 6669 6c65 2e69 6e27 or 'Makefile.in' │ │ │ │ │ -000149f0: 2e20 2054 6865 7365 2066 696c 6573 2077 . These files w │ │ │ │ │ -00014a00: 6572 6520 6765 6e65 7261 7465 6420 6f6e ere generated on │ │ │ │ │ -00014a10: 2074 6865 0a64 6576 656c 6f70 6572 2773 the.developer's │ │ │ │ │ -00014a20: 2068 6f73 7420 616e 6420 6172 6520 6469 host and are di │ │ │ │ │ -00014a30: 7374 7269 6275 7465 6420 736f 2074 6861 stributed so tha │ │ │ │ │ -00014a40: 7420 656e 642d 7573 6572 7320 646f 206e t end-users do n │ │ │ │ │ -00014a50: 6f74 2068 6176 6520 746f 0a69 6e73 7461 ot have to.insta │ │ │ │ │ -00014a60: 6c6c 2074 6865 206d 6169 6e74 6169 6e65 ll the maintaine │ │ │ │ │ -00014a70: 7220 746f 6f6c 7320 7265 7175 6972 6564 r tools required │ │ │ │ │ -00014a80: 2074 6f20 7265 6275 696c 6420 7468 656d to rebuild them │ │ │ │ │ -00014a90: 2e20 204f 7468 6572 2067 656e 6572 6174 . Other generat │ │ │ │ │ -00014aa0: 6564 0a66 696c 6573 206c 696b 6520 4c65 ed.files like Le │ │ │ │ │ -00014ab0: 7820 7363 616e 6e65 7273 2c20 5961 6363 x scanners, Yacc │ │ │ │ │ -00014ac0: 2070 6172 7365 7273 2c20 6f72 2049 6e66 parsers, or Inf │ │ │ │ │ -00014ad0: 6f20 646f 6375 6d65 6e74 6174 696f 6e2c o documentation, │ │ │ │ │ -00014ae0: 2061 7265 0a75 7375 616c 6c79 2064 6973 are.usually dis │ │ │ │ │ -00014af0: 7472 6962 7574 6564 206f 6e20 7369 6d69 tributed on simi │ │ │ │ │ -00014b00: 6c61 7220 6772 6f75 6e64 732e 0a0a 2020 lar grounds... │ │ │ │ │ -00014b10: 2041 7574 6f6d 616b 6520 6f75 7470 7574 Automake output │ │ │ │ │ -00014b20: 7320 7275 6c65 7320 696e 2027 4d61 6b65 s rules in 'Make │ │ │ │ │ -00014b30: 6669 6c65 2773 2074 6f20 7265 6275 696c file's to rebuil │ │ │ │ │ -00014b40: 6420 7468 6573 6520 6669 6c65 732e 2020 d these files. │ │ │ │ │ -00014b50: 466f 720a 696e 7374 616e 6365 2c20 276d For.instance, 'm │ │ │ │ │ -00014b60: 616b 6527 2077 696c 6c20 7275 6e20 2761 ake' will run 'a │ │ │ │ │ -00014b70: 7574 6f63 6f6e 6627 2074 6f20 7265 6275 utoconf' to rebu │ │ │ │ │ -00014b80: 696c 6420 2763 6f6e 6669 6775 7265 2720 ild 'configure' │ │ │ │ │ -00014b90: 7768 656e 6576 6572 0a27 636f 6e66 6967 whenever.'config │ │ │ │ │ -00014ba0: 7572 652e 6163 2720 6973 2063 6861 6e67 ure.ac' is chang │ │ │ │ │ -00014bb0: 6564 2e20 2054 6869 7320 6d61 6b65 7320 ed. This makes │ │ │ │ │ -00014bc0: 6465 7665 6c6f 706d 656e 7420 7361 6665 development safe │ │ │ │ │ -00014bd0: 7220 6279 2065 6e73 7572 696e 6720 610a r by ensuring a. │ │ │ │ │ -00014be0: 2763 6f6e 6669 6775 7265 2720 6973 206e 'configure' is n │ │ │ │ │ -00014bf0: 6576 6572 206f 7574 2d6f 662d 6461 7465 ever out-of-date │ │ │ │ │ -00014c00: 2077 6974 6820 7265 7370 6563 7420 746f with respect to │ │ │ │ │ -00014c10: 2027 636f 6e66 6967 7572 652e 6163 272e 'configure.ac'. │ │ │ │ │ -00014c20: 0a0a 2020 2041 7320 6765 6e65 7261 7465 .. As generate │ │ │ │ │ -00014c30: 6420 6669 6c65 7320 7368 6970 7065 6420 d files shipped │ │ │ │ │ -00014c40: 696e 2070 6163 6b61 6765 7320 6172 6520 in packages are │ │ │ │ │ -00014c50: 7570 2d74 6f2d 6461 7465 2c20 616e 6420 up-to-date, and │ │ │ │ │ -00014c60: 6265 6361 7573 650a 2774 6172 2720 7072 because.'tar' pr │ │ │ │ │ -00014c70: 6573 6572 7665 7320 7469 6d65 732d 7461 eserves times-ta │ │ │ │ │ -00014c80: 6d70 732c 2074 6865 7365 2072 6562 7569 mps, these rebui │ │ │ │ │ -00014c90: 6c64 2072 756c 6573 2061 7265 206e 6f74 ld rules are not │ │ │ │ │ -00014ca0: 2074 7269 6767 6572 6564 2077 6865 6e0a triggered when. │ │ │ │ │ -00014cb0: 6120 7573 6572 2075 6e70 6163 6b73 2061 a user unpacks a │ │ │ │ │ -00014cc0: 6e64 2062 7569 6c64 7320 6120 7061 636b nd builds a pack │ │ │ │ │ -00014cd0: 6167 652e 0a0a 4261 636b 6772 6f75 6e64 age...Background │ │ │ │ │ -00014ce0: 3a20 4356 5320 616e 6420 5469 6d65 7374 : CVS and Timest │ │ │ │ │ -00014cf0: 616d 7073 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d amps.----------- │ │ │ │ │ +00014980: 2d2d 2d2d 2d2d 0a0a 5061 636b 6167 6573 ------..Packages │ │ │ │ │ +00014990: 206d 6164 6520 7769 7468 2041 7574 6f63 made with Autoc │ │ │ │ │ +000149a0: 6f6e 6620 616e 6420 4175 746f 6d61 6b65 onf and Automake │ │ │ │ │ +000149b0: 2073 6869 7020 7769 7468 2073 6f6d 6520 ship with some │ │ │ │ │ +000149c0: 6765 6e65 7261 7465 6420 6669 6c65 730a generated files. │ │ │ │ │ +000149d0: 6c69 6b65 2027 636f 6e66 6967 7572 6527 like 'configure' │ │ │ │ │ +000149e0: 206f 7220 274d 616b 6566 696c 652e 696e or 'Makefile.in │ │ │ │ │ +000149f0: 272e 2020 5468 6573 6520 6669 6c65 7320 '. These files │ │ │ │ │ +00014a00: 7765 7265 2067 656e 6572 6174 6564 206f were generated o │ │ │ │ │ +00014a10: 6e20 7468 650a 6465 7665 6c6f 7065 7227 n the.developer' │ │ │ │ │ +00014a20: 7320 686f 7374 2061 6e64 2061 7265 2064 s host and are d │ │ │ │ │ +00014a30: 6973 7472 6962 7574 6564 2073 6f20 7468 istributed so th │ │ │ │ │ +00014a40: 6174 2065 6e64 2d75 7365 7273 2064 6f20 at end-users do │ │ │ │ │ +00014a50: 6e6f 7420 6861 7665 2074 6f0a 696e 7374 not have to.inst │ │ │ │ │ +00014a60: 616c 6c20 7468 6520 6d61 696e 7461 696e all the maintain │ │ │ │ │ +00014a70: 6572 2074 6f6f 6c73 2072 6571 7569 7265 er tools require │ │ │ │ │ +00014a80: 6420 746f 2072 6562 7569 6c64 2074 6865 d to rebuild the │ │ │ │ │ +00014a90: 6d2e 2020 4f74 6865 7220 6765 6e65 7261 m. Other genera │ │ │ │ │ +00014aa0: 7465 640a 6669 6c65 7320 6c69 6b65 204c ted.files like L │ │ │ │ │ +00014ab0: 6578 2073 6361 6e6e 6572 732c 2059 6163 ex scanners, Yac │ │ │ │ │ +00014ac0: 6320 7061 7273 6572 732c 206f 7220 496e c parsers, or In │ │ │ │ │ +00014ad0: 666f 2064 6f63 756d 656e 7461 7469 6f6e fo documentation │ │ │ │ │ +00014ae0: 2c20 6172 650a 7573 7561 6c6c 7920 6469 , are.usually di │ │ │ │ │ +00014af0: 7374 7269 6275 7465 6420 6f6e 2073 696d stributed on sim │ │ │ │ │ +00014b00: 696c 6172 2067 726f 756e 6473 2e0a 0a20 ilar grounds... │ │ │ │ │ +00014b10: 2020 4175 746f 6d61 6b65 206f 7574 7075 Automake outpu │ │ │ │ │ +00014b20: 7473 2072 756c 6573 2069 6e20 274d 616b ts rules in 'Mak │ │ │ │ │ +00014b30: 6566 696c 6527 7320 746f 2072 6562 7569 efile's to rebui │ │ │ │ │ +00014b40: 6c64 2074 6865 7365 2066 696c 6573 2e20 ld these files. │ │ │ │ │ +00014b50: 2046 6f72 0a69 6e73 7461 6e63 652c 2027 For.instance, ' │ │ │ │ │ +00014b60: 6d61 6b65 2720 7769 6c6c 2072 756e 2027 make' will run ' │ │ │ │ │ +00014b70: 6175 746f 636f 6e66 2720 746f 2072 6562 autoconf' to reb │ │ │ │ │ +00014b80: 7569 6c64 2027 636f 6e66 6967 7572 6527 uild 'configure' │ │ │ │ │ +00014b90: 2077 6865 6e65 7665 720a 2763 6f6e 6669 whenever.'confi │ │ │ │ │ +00014ba0: 6775 7265 2e61 6327 2069 7320 6368 616e gure.ac' is chan │ │ │ │ │ +00014bb0: 6765 642e 2020 5468 6973 206d 616b 6573 ged. This makes │ │ │ │ │ +00014bc0: 2064 6576 656c 6f70 6d65 6e74 2073 6166 development saf │ │ │ │ │ +00014bd0: 6572 2062 7920 656e 7375 7269 6e67 2061 er by ensuring a │ │ │ │ │ +00014be0: 0a27 636f 6e66 6967 7572 6527 2069 7320 .'configure' is │ │ │ │ │ +00014bf0: 6e65 7665 7220 6f75 742d 6f66 2d64 6174 never out-of-dat │ │ │ │ │ +00014c00: 6520 7769 7468 2072 6573 7065 6374 2074 e with respect t │ │ │ │ │ +00014c10: 6f20 2763 6f6e 6669 6775 7265 2e61 6327 o 'configure.ac' │ │ │ │ │ +00014c20: 2e0a 0a20 2020 4173 2067 656e 6572 6174 ... As generat │ │ │ │ │ +00014c30: 6564 2066 696c 6573 2073 6869 7070 6564 ed files shipped │ │ │ │ │ +00014c40: 2069 6e20 7061 636b 6167 6573 2061 7265 in packages are │ │ │ │ │ +00014c50: 2075 702d 746f 2d64 6174 652c 2061 6e64 up-to-date, and │ │ │ │ │ +00014c60: 2062 6563 6175 7365 0a27 7461 7227 2070 because.'tar' p │ │ │ │ │ +00014c70: 7265 7365 7276 6573 2074 696d 6573 2d74 reserves times-t │ │ │ │ │ +00014c80: 616d 7073 2c20 7468 6573 6520 7265 6275 amps, these rebu │ │ │ │ │ +00014c90: 696c 6420 7275 6c65 7320 6172 6520 6e6f ild rules are no │ │ │ │ │ +00014ca0: 7420 7472 6967 6765 7265 6420 7768 656e t triggered when │ │ │ │ │ +00014cb0: 0a61 2075 7365 7220 756e 7061 636b 7320 .a user unpacks │ │ │ │ │ +00014cc0: 616e 6420 6275 696c 6473 2061 2070 6163 and builds a pac │ │ │ │ │ +00014cd0: 6b61 6765 2e0a 0a42 6163 6b67 726f 756e kage...Backgroun │ │ │ │ │ +00014ce0: 643a 2043 5653 2061 6e64 2054 696d 6573 d: CVS and Times │ │ │ │ │ +00014cf0: 7461 6d70 730a 2d2d 2d2d 2d2d 2d2d 2d2d tamps.---------- │ │ │ │ │ 00014d00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00014d10: 2d2d 2d0a 0a55 6e6c 6573 7320 796f 7520 ---..Unless you │ │ │ │ │ -00014d20: 7573 6520 4356 5320 6b65 7977 6f72 6473 use CVS keywords │ │ │ │ │ -00014d30: 2028 696e 2077 6869 6368 2063 6173 6520 (in which case │ │ │ │ │ -00014d40: 6669 6c65 7320 6d75 7374 2062 6520 7570 files must be up │ │ │ │ │ -00014d50: 6461 7465 6420 6174 0a63 6f6d 6d69 7420 dated at.commit │ │ │ │ │ -00014d60: 7469 6d65 292c 2043 5653 2070 7265 7365 time), CVS prese │ │ │ │ │ -00014d70: 7276 6573 2074 696d 6573 7461 6d70 2064 rves timestamp d │ │ │ │ │ -00014d80: 7572 696e 6720 2763 7673 2063 6f6d 6d69 uring 'cvs commi │ │ │ │ │ -00014d90: 7427 2061 6e64 2027 6376 730a 696d 706f t' and 'cvs.impo │ │ │ │ │ -00014da0: 7274 202d 6427 206f 7065 7261 7469 6f6e rt -d' operation │ │ │ │ │ -00014db0: 732e 0a0a 2020 2057 6865 6e20 796f 7520 s... When you │ │ │ │ │ -00014dc0: 6368 6563 6b20 6f75 7420 6120 6669 6c65 check out a file │ │ │ │ │ -00014dd0: 2075 7369 6e67 2027 6376 7320 6368 6563 using 'cvs chec │ │ │ │ │ -00014de0: 6b6f 7574 2720 6974 7320 7469 6d65 7374 kout' its timest │ │ │ │ │ -00014df0: 616d 7020 6973 2073 6574 0a74 6f20 7468 amp is set.to th │ │ │ │ │ -00014e00: 6174 206f 6620 7468 6520 7265 7669 7369 at of the revisi │ │ │ │ │ -00014e10: 6f6e 2074 6861 7420 6973 2062 6569 6e67 on that is being │ │ │ │ │ -00014e20: 2063 6865 636b 6564 206f 7574 2e0a 0a20 checked out... │ │ │ │ │ -00014e30: 2020 486f 7765 7665 722c 2064 7572 696e However, durin │ │ │ │ │ -00014e40: 6720 2763 7673 2075 7064 6174 6527 2c20 g 'cvs update', │ │ │ │ │ -00014e50: 6669 6c65 7320 7769 6c6c 2068 6176 6520 files will have │ │ │ │ │ -00014e60: 7468 6520 6461 7465 206f 6620 7468 6520 the date of the │ │ │ │ │ -00014e70: 7570 6461 7465 2c0a 6e6f 7420 7468 6520 update,.not the │ │ │ │ │ -00014e80: 6f72 6967 696e 616c 2074 696d 6573 7461 original timesta │ │ │ │ │ -00014e90: 6d70 206f 6620 7468 6973 2072 6576 6973 mp of this revis │ │ │ │ │ -00014ea0: 696f 6e2e 2020 5468 6973 2069 7320 6d65 ion. This is me │ │ │ │ │ -00014eb0: 616e 7420 746f 206d 616b 6520 7375 7265 ant to make sure │ │ │ │ │ -00014ec0: 0a74 6861 7420 276d 616b 6527 206e 6f74 .that 'make' not │ │ │ │ │ -00014ed0: 6963 6573 2073 6f75 7263 6573 2066 696c ices sources fil │ │ │ │ │ -00014ee0: 6573 2068 6176 6520 6265 656e 2075 7064 es have been upd │ │ │ │ │ -00014ef0: 6174 6564 2e0a 0a20 2020 5468 6973 2074 ated... This t │ │ │ │ │ -00014f00: 696d 6573 7461 6d70 2073 6869 6674 2069 imestamp shift i │ │ │ │ │ -00014f10: 7320 7472 6f75 626c 6573 6f6d 6520 7768 s troublesome wh │ │ │ │ │ -00014f20: 656e 2062 6f74 6820 736f 7572 6365 7320 en both sources │ │ │ │ │ -00014f30: 616e 6420 6765 6e65 7261 7465 640a 6669 and generated.fi │ │ │ │ │ -00014f40: 6c65 7320 6172 6520 6b65 7074 2075 6e64 les are kept und │ │ │ │ │ -00014f50: 6572 2043 5653 2e20 2042 6563 6175 7365 er CVS. Because │ │ │ │ │ -00014f60: 2043 5653 2070 726f 6365 7373 6573 2066 CVS processes f │ │ │ │ │ -00014f70: 696c 6573 2069 6e20 6c65 7869 6361 6c20 iles in lexical │ │ │ │ │ -00014f80: 6f72 6465 722c 0a27 636f 6e66 6967 7572 order,.'configur │ │ │ │ │ -00014f90: 652e 6163 2720 7769 6c6c 2061 7070 6561 e.ac' will appea │ │ │ │ │ -00014fa0: 7220 6e65 7765 7220 7468 616e 2027 636f r newer than 'co │ │ │ │ │ -00014fb0: 6e66 6967 7572 6527 2061 6674 6572 2061 nfigure' after a │ │ │ │ │ -00014fc0: 2027 6376 7320 7570 6461 7465 270a 7468 'cvs update'.th │ │ │ │ │ -00014fd0: 6174 2075 7064 6174 6573 2062 6f74 6820 at updates both │ │ │ │ │ -00014fe0: 6669 6c65 732c 2065 7665 6e20 6966 2027 files, even if ' │ │ │ │ │ -00014ff0: 636f 6e66 6967 7572 6527 2077 6173 206e configure' was n │ │ │ │ │ -00015000: 6577 6572 2074 6861 6e0a 2763 6f6e 6669 ewer than.'confi │ │ │ │ │ -00015010: 6775 7265 2e61 6327 2077 6865 6e20 6974 gure.ac' when it │ │ │ │ │ -00015020: 2077 6173 2063 6865 636b 6564 2069 6e2e was checked in. │ │ │ │ │ -00015030: 2020 4361 6c6c 696e 6720 276d 616b 6527 Calling 'make' │ │ │ │ │ -00015040: 2077 696c 6c20 7468 656e 2074 7269 6767 will then trigg │ │ │ │ │ -00015050: 6572 0a61 2073 7075 7269 6f75 7320 7265 er.a spurious re │ │ │ │ │ -00015060: 6275 696c 6420 6f66 2027 636f 6e66 6967 build of 'config │ │ │ │ │ -00015070: 7572 6527 2e0a 0a4c 6976 696e 6720 7769 ure'...Living wi │ │ │ │ │ -00015080: 7468 2043 5653 2069 6e20 4175 746f 636f th CVS in Autoco │ │ │ │ │ -00015090: 6e66 6973 6361 7465 6420 5072 6f6a 6563 nfiscated Projec │ │ │ │ │ -000150a0: 7473 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ts.------------- │ │ │ │ │ +00014d10: 2d2d 2d2d 0a0a 556e 6c65 7373 2079 6f75 ----..Unless you │ │ │ │ │ +00014d20: 2075 7365 2043 5653 206b 6579 776f 7264 use CVS keyword │ │ │ │ │ +00014d30: 7320 2869 6e20 7768 6963 6820 6361 7365 s (in which case │ │ │ │ │ +00014d40: 2066 696c 6573 206d 7573 7420 6265 2075 files must be u │ │ │ │ │ +00014d50: 7064 6174 6564 2061 740a 636f 6d6d 6974 pdated at.commit │ │ │ │ │ +00014d60: 2074 696d 6529 2c20 4356 5320 7072 6573 time), CVS pres │ │ │ │ │ +00014d70: 6572 7665 7320 7469 6d65 7374 616d 7020 erves timestamp │ │ │ │ │ +00014d80: 6475 7269 6e67 2027 6376 7320 636f 6d6d during 'cvs comm │ │ │ │ │ +00014d90: 6974 2720 616e 6420 2763 7673 0a69 6d70 it' and 'cvs.imp │ │ │ │ │ +00014da0: 6f72 7420 2d64 2720 6f70 6572 6174 696f ort -d' operatio │ │ │ │ │ +00014db0: 6e73 2e0a 0a20 2020 5768 656e 2079 6f75 ns... When you │ │ │ │ │ +00014dc0: 2063 6865 636b 206f 7574 2061 2066 696c check out a fil │ │ │ │ │ +00014dd0: 6520 7573 696e 6720 2763 7673 2063 6865 e using 'cvs che │ │ │ │ │ +00014de0: 636b 6f75 7427 2069 7473 2074 696d 6573 ckout' its times │ │ │ │ │ +00014df0: 7461 6d70 2069 7320 7365 740a 746f 2074 tamp is set.to t │ │ │ │ │ +00014e00: 6861 7420 6f66 2074 6865 2072 6576 6973 hat of the revis │ │ │ │ │ +00014e10: 696f 6e20 7468 6174 2069 7320 6265 696e ion that is bein │ │ │ │ │ +00014e20: 6720 6368 6563 6b65 6420 6f75 742e 0a0a g checked out... │ │ │ │ │ +00014e30: 2020 2048 6f77 6576 6572 2c20 6475 7269 However, duri │ │ │ │ │ +00014e40: 6e67 2027 6376 7320 7570 6461 7465 272c ng 'cvs update', │ │ │ │ │ +00014e50: 2066 696c 6573 2077 696c 6c20 6861 7665 files will have │ │ │ │ │ +00014e60: 2074 6865 2064 6174 6520 6f66 2074 6865 the date of the │ │ │ │ │ +00014e70: 2075 7064 6174 652c 0a6e 6f74 2074 6865 update,.not the │ │ │ │ │ +00014e80: 206f 7269 6769 6e61 6c20 7469 6d65 7374 original timest │ │ │ │ │ +00014e90: 616d 7020 6f66 2074 6869 7320 7265 7669 amp of this revi │ │ │ │ │ +00014ea0: 7369 6f6e 2e20 2054 6869 7320 6973 206d sion. This is m │ │ │ │ │ +00014eb0: 6561 6e74 2074 6f20 6d61 6b65 2073 7572 eant to make sur │ │ │ │ │ +00014ec0: 650a 7468 6174 2027 6d61 6b65 2720 6e6f e.that 'make' no │ │ │ │ │ +00014ed0: 7469 6365 7320 736f 7572 6365 7320 6669 tices sources fi │ │ │ │ │ +00014ee0: 6c65 7320 6861 7665 2062 6565 6e20 7570 les have been up │ │ │ │ │ +00014ef0: 6461 7465 642e 0a0a 2020 2054 6869 7320 dated... This │ │ │ │ │ +00014f00: 7469 6d65 7374 616d 7020 7368 6966 7420 timestamp shift │ │ │ │ │ +00014f10: 6973 2074 726f 7562 6c65 736f 6d65 2077 is troublesome w │ │ │ │ │ +00014f20: 6865 6e20 626f 7468 2073 6f75 7263 6573 hen both sources │ │ │ │ │ +00014f30: 2061 6e64 2067 656e 6572 6174 6564 0a66 and generated.f │ │ │ │ │ +00014f40: 696c 6573 2061 7265 206b 6570 7420 756e iles are kept un │ │ │ │ │ +00014f50: 6465 7220 4356 532e 2020 4265 6361 7573 der CVS. Becaus │ │ │ │ │ +00014f60: 6520 4356 5320 7072 6f63 6573 7365 7320 e CVS processes │ │ │ │ │ +00014f70: 6669 6c65 7320 696e 206c 6578 6963 616c files in lexical │ │ │ │ │ +00014f80: 206f 7264 6572 2c0a 2763 6f6e 6669 6775 order,.'configu │ │ │ │ │ +00014f90: 7265 2e61 6327 2077 696c 6c20 6170 7065 re.ac' will appe │ │ │ │ │ +00014fa0: 6172 206e 6577 6572 2074 6861 6e20 2763 ar newer than 'c │ │ │ │ │ +00014fb0: 6f6e 6669 6775 7265 2720 6166 7465 7220 onfigure' after │ │ │ │ │ +00014fc0: 6120 2763 7673 2075 7064 6174 6527 0a74 a 'cvs update'.t │ │ │ │ │ +00014fd0: 6861 7420 7570 6461 7465 7320 626f 7468 hat updates both │ │ │ │ │ +00014fe0: 2066 696c 6573 2c20 6576 656e 2069 6620 files, even if │ │ │ │ │ +00014ff0: 2763 6f6e 6669 6775 7265 2720 7761 7320 'configure' was │ │ │ │ │ +00015000: 6e65 7765 7220 7468 616e 0a27 636f 6e66 newer than.'conf │ │ │ │ │ +00015010: 6967 7572 652e 6163 2720 7768 656e 2069 igure.ac' when i │ │ │ │ │ +00015020: 7420 7761 7320 6368 6563 6b65 6420 696e t was checked in │ │ │ │ │ +00015030: 2e20 2043 616c 6c69 6e67 2027 6d61 6b65 . Calling 'make │ │ │ │ │ +00015040: 2720 7769 6c6c 2074 6865 6e20 7472 6967 ' will then trig │ │ │ │ │ +00015050: 6765 720a 6120 7370 7572 696f 7573 2072 ger.a spurious r │ │ │ │ │ +00015060: 6562 7569 6c64 206f 6620 2763 6f6e 6669 ebuild of 'confi │ │ │ │ │ +00015070: 6775 7265 272e 0a0a 4c69 7669 6e67 2077 gure'...Living w │ │ │ │ │ +00015080: 6974 6820 4356 5320 696e 2041 7574 6f63 ith CVS in Autoc │ │ │ │ │ +00015090: 6f6e 6669 7363 6174 6564 2050 726f 6a65 onfiscated Proje │ │ │ │ │ +000150a0: 6374 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d cts.------------ │ │ │ │ │ 000150b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000150c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -000150d0: 5468 6572 6520 6172 6520 6261 7369 6361 There are basica │ │ │ │ │ -000150e0: 6c6c 7920 7477 6f20 636c 616e 7320 616d lly two clans am │ │ │ │ │ -000150f0: 6f6e 6773 7420 6d61 696e 7461 696e 6572 ongst maintainer │ │ │ │ │ -00015100: 733a 2074 686f 7365 2077 686f 206b 6565 s: those who kee │ │ │ │ │ -00015110: 7020 616c 6c0a 6469 7374 7269 6275 7465 p all.distribute │ │ │ │ │ -00015120: 6420 6669 6c65 7320 756e 6465 7220 4356 d files under CV │ │ │ │ │ -00015130: 532c 2069 6e63 6c75 6469 6e67 2067 656e S, including gen │ │ │ │ │ -00015140: 6572 6174 6564 2066 696c 6573 2c20 616e erated files, an │ │ │ │ │ -00015150: 6420 7468 6f73 6520 7768 6f0a 6b65 6570 d those who.keep │ │ │ │ │ -00015160: 2067 656e 6572 6174 6564 2066 696c 6573 generated files │ │ │ │ │ -00015170: 205f 6f75 745f 206f 6620 4356 532e 0a0a _out_ of CVS... │ │ │ │ │ -00015180: 416c 6c20 4669 6c65 7320 696e 2043 5653 All Files in CVS │ │ │ │ │ -00015190: 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -000151a0: 2e0a 0a20 2020 2a20 5468 6520 4356 5320 ... * The CVS │ │ │ │ │ -000151b0: 7265 706f 7369 746f 7279 2063 6f6e 7461 repository conta │ │ │ │ │ -000151c0: 696e 7320 616c 6c20 6469 7374 7269 6275 ins all distribu │ │ │ │ │ -000151d0: 7465 6420 6669 6c65 7320 736f 2079 6f75 ted files so you │ │ │ │ │ -000151e0: 206b 6e6f 770a 2020 2020 2065 7861 6374 know. exact │ │ │ │ │ -000151f0: 6c79 2077 6861 7420 6973 2064 6973 7472 ly what is distr │ │ │ │ │ -00015200: 6962 7574 6564 2c20 616e 6420 796f 7520 ibuted, and you │ │ │ │ │ -00015210: 6361 6e20 6368 6563 6b6f 7574 2061 6e79 can checkout any │ │ │ │ │ -00015220: 2070 7269 6f72 2076 6572 7369 6f6e 0a20 prior version. │ │ │ │ │ -00015230: 2020 2020 656e 7469 7265 6c79 2e0a 0a20 entirely... │ │ │ │ │ -00015240: 2020 2a20 4d61 696e 7461 696e 6572 7320 * Maintainers │ │ │ │ │ -00015250: 6361 6e20 7365 6520 686f 7720 6765 6e65 can see how gene │ │ │ │ │ -00015260: 7261 7465 6420 6669 6c65 7320 6576 6f6c rated files evol │ │ │ │ │ -00015270: 7665 2028 666f 7220 696e 7374 616e 6365 ve (for instance │ │ │ │ │ -00015280: 2c20 796f 750a 2020 2020 2063 616e 2073 , you. can s │ │ │ │ │ -00015290: 6565 2077 6861 7420 6861 7070 656e 7320 ee what happens │ │ │ │ │ -000152a0: 746f 2079 6f75 7220 274d 616b 6566 696c to your 'Makefil │ │ │ │ │ -000152b0: 652e 696e 2773 2077 6865 6e20 796f 7520 e.in's when you │ │ │ │ │ -000152c0: 7570 6772 6164 650a 2020 2020 2041 7574 upgrade. Aut │ │ │ │ │ -000152d0: 6f6d 616b 6520 616e 6420 6d61 6b65 2073 omake and make s │ │ │ │ │ -000152e0: 7572 6520 7468 6579 206c 6f6f 6b20 4f4b ure they look OK │ │ │ │ │ -000152f0: 292e 0a0a 2020 202a 2055 7365 7273 2064 )... * Users d │ │ │ │ │ -00015300: 6f20 6e6f 7420 6e65 6564 2074 6865 2061 o not need the a │ │ │ │ │ -00015310: 7574 6f74 6f6f 6c73 2074 6f20 6275 696c utotools to buil │ │ │ │ │ -00015320: 6420 6120 6368 6563 6b6f 7574 206f 6620 d a checkout of │ │ │ │ │ -00015330: 7468 6520 7072 6f6a 6563 742c 0a20 2020 the project,. │ │ │ │ │ -00015340: 2020 6974 2077 6f72 6b73 206a 7573 7420 it works just │ │ │ │ │ -00015350: 6c69 6b65 2061 2072 656c 6561 7365 6420 like a released │ │ │ │ │ -00015360: 7461 7262 616c 6c2e 0a0a 2020 202a 2049 tarball... * I │ │ │ │ │ -00015370: 6620 7573 6572 7320 7573 6520 2763 7673 f users use 'cvs │ │ │ │ │ -00015380: 2075 7064 6174 6527 2074 6f20 7570 6461 update' to upda │ │ │ │ │ -00015390: 7465 2074 6865 6972 2063 6f70 792c 2069 te their copy, i │ │ │ │ │ -000153a0: 6e73 7465 6164 206f 6620 2763 7673 0a20 nstead of 'cvs. │ │ │ │ │ -000153b0: 2020 2020 6368 6563 6b6f 7574 2720 746f checkout' to │ │ │ │ │ -000153c0: 2066 6574 6368 2061 2066 7265 7368 206f fetch a fresh o │ │ │ │ │ -000153d0: 6e65 2c20 7469 6d65 7374 616d 7073 2077 ne, timestamps w │ │ │ │ │ -000153e0: 696c 6c20 6265 2069 6e61 6363 7572 6174 ill be inaccurat │ │ │ │ │ -000153f0: 652e 0a20 2020 2020 536f 6d65 2072 6562 e.. Some reb │ │ │ │ │ -00015400: 7569 6c64 2072 756c 6573 2077 696c 6c20 uild rules will │ │ │ │ │ -00015410: 6265 2074 7269 6767 6572 6564 2061 6e64 be triggered and │ │ │ │ │ -00015420: 2061 7474 656d 7074 2074 6f20 7275 6e20 attempt to run │ │ │ │ │ -00015430: 6465 7665 6c6f 7065 720a 2020 2020 2074 developer. t │ │ │ │ │ -00015440: 6f6f 6c73 2073 7563 6820 6173 2027 6175 ools such as 'au │ │ │ │ │ -00015450: 746f 636f 6e66 2720 6f72 2027 6175 746f toconf' or 'auto │ │ │ │ │ -00015460: 6d61 6b65 272e 0a0a 2020 2020 2041 6374 make'... Act │ │ │ │ │ -00015470: 7561 6c6c 792c 2063 616c 6c73 2074 6f20 ually, calls to │ │ │ │ │ -00015480: 7375 6368 2074 6f6f 6c73 2061 7265 2061 such tools are a │ │ │ │ │ -00015490: 6c6c 2077 7261 7070 6564 2069 6e74 6f20 ll wrapped into │ │ │ │ │ -000154a0: 6120 6361 6c6c 2074 6f20 7468 650a 2020 a call to the. │ │ │ │ │ -000154b0: 2020 2027 6d69 7373 696e 6727 2073 6372 'missing' scr │ │ │ │ │ -000154c0: 6970 7420 6469 7363 7573 7365 6420 6c61 ipt discussed la │ │ │ │ │ -000154d0: 7465 7220 282a 6e6f 7465 206d 6169 6e74 ter (*note maint │ │ │ │ │ -000154e0: 6169 6e65 722d 6d6f 6465 3a3a 292e 0a20 ainer-mode::).. │ │ │ │ │ -000154f0: 2020 2020 276d 6973 7369 6e67 2720 7769 'missing' wi │ │ │ │ │ -00015500: 6c6c 2074 616b 6520 6361 7265 206f 6620 ll take care of │ │ │ │ │ -00015510: 6669 7869 6e67 2074 6865 2074 696d 6573 fixing the times │ │ │ │ │ -00015520: 7461 6d70 7320 7768 656e 2074 6865 7365 tamps when these │ │ │ │ │ -00015530: 2074 6f6f 6c73 0a20 2020 2020 6172 6520 tools. are │ │ │ │ │ -00015540: 6e6f 7420 696e 7374 616c 6c65 642c 2073 not installed, s │ │ │ │ │ -00015550: 6f20 7468 6174 2074 6865 2062 7569 6c64 o that the build │ │ │ │ │ -00015560: 2063 616e 2063 6f6e 7469 6e75 652e 0a0a can continue... │ │ │ │ │ -00015570: 2020 202a 2049 6e20 6469 7374 7269 6275 * In distribu │ │ │ │ │ -00015580: 7465 6420 6465 7665 6c6f 706d 656e 742c ted development, │ │ │ │ │ -00015590: 2064 6576 656c 6f70 6572 7320 6172 6520 developers are │ │ │ │ │ -000155a0: 6c69 6b65 6c79 2074 6f20 6861 7665 2064 likely to have d │ │ │ │ │ -000155b0: 6966 6665 7265 6e74 0a20 2020 2020 7665 ifferent. ve │ │ │ │ │ -000155c0: 7273 696f 6e20 6f66 2074 6865 206d 6169 rsion of the mai │ │ │ │ │ -000155d0: 6e74 6169 6e65 7220 746f 6f6c 7320 696e ntainer tools in │ │ │ │ │ -000155e0: 7374 616c 6c65 642e 2020 496e 2074 6869 stalled. In thi │ │ │ │ │ -000155f0: 7320 6361 7365 2072 6562 7569 6c64 730a s case rebuilds. │ │ │ │ │ -00015600: 2020 2020 2074 7269 6767 6572 6564 2062 triggered b │ │ │ │ │ -00015610: 7920 7469 6d65 7374 616d 7020 6c6f 7373 y timestamp loss │ │ │ │ │ -00015620: 6167 6520 7769 6c6c 206c 6561 6420 746f age will lead to │ │ │ │ │ -00015630: 2073 7075 7269 6f75 7320 6368 616e 6765 spurious change │ │ │ │ │ -00015640: 7320 746f 0a20 2020 2020 6765 6e65 7261 s to. genera │ │ │ │ │ -00015650: 7465 6420 6669 6c65 732e 2020 5468 6572 ted files. Ther │ │ │ │ │ -00015660: 6520 6172 6520 7365 7665 7261 6c20 736f e are several so │ │ │ │ │ -00015670: 6c75 7469 6f6e 7320 746f 2074 6869 733a lutions to this: │ │ │ │ │ -00015680: 0a0a 2020 2020 2020 2020 2a20 416c 6c20 .. * All │ │ │ │ │ -00015690: 6465 7665 6c6f 7065 7273 2073 686f 756c developers shoul │ │ │ │ │ -000156a0: 6420 7573 6520 7468 6520 7361 6d65 2076 d use the same v │ │ │ │ │ -000156b0: 6572 7369 6f6e 732c 2073 6f20 7468 6174 ersions, so that │ │ │ │ │ -000156c0: 2074 6865 0a20 2020 2020 2020 2020 2072 the. r │ │ │ │ │ -000156d0: 6562 7569 6c74 2066 696c 6573 2061 7265 ebuilt files are │ │ │ │ │ -000156e0: 2069 6465 6e74 6963 616c 2074 6f20 6669 identical to fi │ │ │ │ │ -000156f0: 6c65 7320 696e 2043 5653 2e20 2028 5468 les in CVS. (Th │ │ │ │ │ -00015700: 6973 2073 7461 7274 7320 746f 0a20 2020 is starts to. │ │ │ │ │ -00015710: 2020 2020 2020 2062 6520 6469 6666 6963 be diffic │ │ │ │ │ -00015720: 756c 7420 7768 656e 2065 6163 6820 7072 ult when each pr │ │ │ │ │ -00015730: 6f6a 6563 7420 796f 7520 776f 726b 206f oject you work o │ │ │ │ │ -00015740: 6e20 7573 6573 2064 6966 6665 7265 6e74 n uses different │ │ │ │ │ -00015750: 0a20 2020 2020 2020 2020 2076 6572 7369 . versi │ │ │ │ │ -00015760: 6f6e 732e 290a 2020 2020 2020 2020 2a20 ons.). * │ │ │ │ │ -00015770: 4f72 2070 656f 706c 6520 7573 6520 6120 Or people use a │ │ │ │ │ -00015780: 7363 7269 7074 2074 6f20 6669 7820 7468 script to fix th │ │ │ │ │ -00015790: 6520 7469 6d65 7374 616d 7020 6166 7465 e timestamp afte │ │ │ │ │ -000157a0: 7220 6120 6368 6563 6b6f 7574 0a20 2020 r a checkout. │ │ │ │ │ -000157b0: 2020 2020 2020 2028 7468 6520 4743 4320 (the GCC │ │ │ │ │ -000157c0: 666f 6c6b 7320 6861 7665 2073 7563 6820 folks have such │ │ │ │ │ -000157d0: 6120 7363 7269 7074 292e 0a20 2020 2020 a script).. │ │ │ │ │ -000157e0: 2020 202a 204f 7220 2763 6f6e 6669 6775 * Or 'configu │ │ │ │ │ -000157f0: 7265 2e61 6327 2075 7365 7320 2741 4d5f re.ac' uses 'AM_ │ │ │ │ │ -00015800: 4d41 494e 5441 494e 4552 5f4d 4f44 4527 MAINTAINER_MODE' │ │ │ │ │ -00015810: 2c20 7768 6963 6820 7769 6c6c 0a20 2020 , which will. │ │ │ │ │ -00015820: 2020 2020 2020 2064 6973 6162 6c65 2061 disable a │ │ │ │ │ -00015830: 6c6c 2074 6865 7365 2072 6562 7569 6c64 ll these rebuild │ │ │ │ │ -00015840: 2072 756c 6573 2062 7920 6465 6661 756c rules by defaul │ │ │ │ │ -00015850: 742e 2020 5468 6973 2069 7320 6675 7274 t. This is furt │ │ │ │ │ -00015860: 6865 720a 2020 2020 2020 2020 2020 6469 her. di │ │ │ │ │ -00015870: 7363 7573 7365 6420 696e 202a 6e6f 7465 scussed in *note │ │ │ │ │ -00015880: 206d 6169 6e74 6169 6e65 722d 6d6f 6465 maintainer-mode │ │ │ │ │ -00015890: 3a3a 2e0a 0a20 2020 2a20 416c 7468 6f75 ::... * Althou │ │ │ │ │ -000158a0: 6768 2077 6520 666f 6375 7365 6420 6f6e gh we focused on │ │ │ │ │ -000158b0: 2073 7075 7269 6f75 7320 7265 6275 696c spurious rebuil │ │ │ │ │ -000158c0: 6473 2c20 7468 6520 636f 6e76 6572 7365 ds, the converse │ │ │ │ │ -000158d0: 2063 616e 2061 6c73 6f0a 2020 2020 2068 can also. h │ │ │ │ │ -000158e0: 6170 7065 6e2e 2020 4356 5327 7320 7469 appen. CVS's ti │ │ │ │ │ -000158f0: 6d65 7374 616d 7020 6861 6e64 6c69 6e67 mestamp handling │ │ │ │ │ -00015900: 2063 616e 2061 6c73 6f20 6c65 7420 796f can also let yo │ │ │ │ │ -00015910: 7520 7468 696e 6b20 616e 0a20 2020 2020 u think an. │ │ │ │ │ -00015920: 6f75 742d 6f66 2d64 6174 6520 6669 6c65 out-of-date file │ │ │ │ │ -00015930: 2069 7320 7570 2d74 6f2d 6461 7465 2e0a is up-to-date.. │ │ │ │ │ -00015940: 0a20 2020 2020 466f 7220 696e 7374 616e . For instan │ │ │ │ │ -00015950: 6365 2c20 7375 7070 6f73 6520 6120 6465 ce, suppose a de │ │ │ │ │ -00015960: 7665 6c6f 7065 7220 6861 7320 6d6f 6469 veloper has modi │ │ │ │ │ -00015970: 6669 6564 2027 4d61 6b65 6669 6c65 2e61 fied 'Makefile.a │ │ │ │ │ -00015980: 6d27 2061 6e64 0a20 2020 2020 6861 7320 m' and. has │ │ │ │ │ -00015990: 7265 6275 696c 7420 274d 616b 6566 696c rebuilt 'Makefil │ │ │ │ │ -000159a0: 652e 696e 272c 2061 6e64 2074 6865 6e20 e.in', and then │ │ │ │ │ -000159b0: 6465 6369 6465 7320 746f 2064 6f20 6120 decides to do a │ │ │ │ │ -000159c0: 6c61 7374 2d6d 696e 7574 650a 2020 2020 last-minute. │ │ │ │ │ -000159d0: 2063 6861 6e67 6520 746f 2027 4d61 6b65 change to 'Make │ │ │ │ │ -000159e0: 6669 6c65 2e61 6d27 2072 6967 6874 2062 file.am' right b │ │ │ │ │ -000159f0: 6566 6f72 6520 6368 6563 6b69 6e67 2069 efore checking i │ │ │ │ │ -00015a00: 6e20 626f 7468 2066 696c 6573 0a20 2020 n both files. │ │ │ │ │ -00015a10: 2020 2877 6974 686f 7574 2072 6562 7569 (without rebui │ │ │ │ │ -00015a20: 6c64 696e 6720 274d 616b 6566 696c 652e lding 'Makefile. │ │ │ │ │ -00015a30: 696e 2720 746f 2061 6363 6f75 6e74 2066 in' to account f │ │ │ │ │ -00015a40: 6f72 2074 6865 2063 6861 6e67 6529 2e0a or the change).. │ │ │ │ │ -00015a50: 0a20 2020 2020 5468 6973 206c 6173 7420 . This last │ │ │ │ │ -00015a60: 6368 616e 6765 2074 6f20 274d 616b 6566 change to 'Makef │ │ │ │ │ -00015a70: 696c 652e 616d 2720 6d61 6b65 7320 7468 ile.am' makes th │ │ │ │ │ -00015a80: 6520 636f 7079 206f 6620 274d 616b 6566 e copy of 'Makef │ │ │ │ │ -00015a90: 696c 652e 696e 270a 2020 2020 206f 7574 ile.in'. out │ │ │ │ │ -00015aa0: 2d6f 662d 6461 7465 2e20 2053 696e 6365 -of-date. Since │ │ │ │ │ -00015ab0: 2043 5653 2070 726f 6365 7373 6573 2066 CVS processes f │ │ │ │ │ -00015ac0: 696c 6573 2061 6c70 6861 6265 7469 6361 iles alphabetica │ │ │ │ │ -00015ad0: 6c6c 792c 2077 6865 6e0a 2020 2020 2061 lly, when. a │ │ │ │ │ -00015ae0: 6e6f 7468 6572 2064 6576 656c 6f70 6572 nother developer │ │ │ │ │ -00015af0: 2027 6376 7320 7570 6461 7465 2773 2068 'cvs update's h │ │ │ │ │ -00015b00: 6973 206f 7220 6865 7220 7472 6565 2c20 is or her tree, │ │ │ │ │ -00015b10: 274d 616b 6566 696c 652e 696e 2720 7769 'Makefile.in' wi │ │ │ │ │ -00015b20: 6c6c 0a20 2020 2020 6861 7070 656e 2074 ll. happen t │ │ │ │ │ -00015b30: 6f20 6265 206e 6577 6572 2074 6861 6e20 o be newer than │ │ │ │ │ -00015b40: 274d 616b 6566 696c 652e 616d 272e 2020 'Makefile.am'. │ │ │ │ │ -00015b50: 5468 6973 206f 7468 6572 2064 6576 656c This other devel │ │ │ │ │ -00015b60: 6f70 6572 2077 696c 6c0a 2020 2020 206e oper will. n │ │ │ │ │ -00015b70: 6f74 2073 6565 2074 6861 7420 274d 616b ot see that 'Mak │ │ │ │ │ -00015b80: 6566 696c 652e 696e 2720 6973 206f 7574 efile.in' is out │ │ │ │ │ -00015b90: 2d6f 662d 6461 7465 2e0a 0a47 656e 6572 -of-date...Gener │ │ │ │ │ -00015ba0: 6174 6564 2046 696c 6573 206f 7574 206f ated Files out o │ │ │ │ │ -00015bb0: 6620 4356 530a 2e2e 2e2e 2e2e 2e2e 2e2e f CVS........... │ │ │ │ │ +000150c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000150d0: 0a54 6865 7265 2061 7265 2062 6173 6963 .There are basic │ │ │ │ │ +000150e0: 616c 6c79 2074 776f 2063 6c61 6e73 2061 ally two clans a │ │ │ │ │ +000150f0: 6d6f 6e67 7374 206d 6169 6e74 6169 6e65 mongst maintaine │ │ │ │ │ +00015100: 7273 3a20 7468 6f73 6520 7768 6f20 6b65 rs: those who ke │ │ │ │ │ +00015110: 6570 2061 6c6c 0a64 6973 7472 6962 7574 ep all.distribut │ │ │ │ │ +00015120: 6564 2066 696c 6573 2075 6e64 6572 2043 ed files under C │ │ │ │ │ +00015130: 5653 2c20 696e 636c 7564 696e 6720 6765 VS, including ge │ │ │ │ │ +00015140: 6e65 7261 7465 6420 6669 6c65 732c 2061 nerated files, a │ │ │ │ │ +00015150: 6e64 2074 686f 7365 2077 686f 0a6b 6565 nd those who.kee │ │ │ │ │ +00015160: 7020 6765 6e65 7261 7465 6420 6669 6c65 p generated file │ │ │ │ │ +00015170: 7320 5f6f 7574 5f20 6f66 2043 5653 2e0a s _out_ of CVS.. │ │ │ │ │ +00015180: 0a41 6c6c 2046 696c 6573 2069 6e20 4356 .All Files in CV │ │ │ │ │ +00015190: 530a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e S............... │ │ │ │ │ +000151a0: 2e2e 0a0a 2020 202a 2054 6865 2043 5653 .... * The CVS │ │ │ │ │ +000151b0: 2072 6570 6f73 6974 6f72 7920 636f 6e74 repository cont │ │ │ │ │ +000151c0: 6169 6e73 2061 6c6c 2064 6973 7472 6962 ains all distrib │ │ │ │ │ +000151d0: 7574 6564 2066 696c 6573 2073 6f20 796f uted files so yo │ │ │ │ │ +000151e0: 7520 6b6e 6f77 0a20 2020 2020 6578 6163 u know. exac │ │ │ │ │ +000151f0: 746c 7920 7768 6174 2069 7320 6469 7374 tly what is dist │ │ │ │ │ +00015200: 7269 6275 7465 642c 2061 6e64 2079 6f75 ributed, and you │ │ │ │ │ +00015210: 2063 616e 2063 6865 636b 6f75 7420 616e can checkout an │ │ │ │ │ +00015220: 7920 7072 696f 7220 7665 7273 696f 6e0a y prior version. │ │ │ │ │ +00015230: 2020 2020 2065 6e74 6972 656c 792e 0a0a entirely... │ │ │ │ │ +00015240: 2020 202a 204d 6169 6e74 6169 6e65 7273 * Maintainers │ │ │ │ │ +00015250: 2063 616e 2073 6565 2068 6f77 2067 656e can see how gen │ │ │ │ │ +00015260: 6572 6174 6564 2066 696c 6573 2065 766f erated files evo │ │ │ │ │ +00015270: 6c76 6520 2866 6f72 2069 6e73 7461 6e63 lve (for instanc │ │ │ │ │ +00015280: 652c 2079 6f75 0a20 2020 2020 6361 6e20 e, you. can │ │ │ │ │ +00015290: 7365 6520 7768 6174 2068 6170 7065 6e73 see what happens │ │ │ │ │ +000152a0: 2074 6f20 796f 7572 2027 4d61 6b65 6669 to your 'Makefi │ │ │ │ │ +000152b0: 6c65 2e69 6e27 7320 7768 656e 2079 6f75 le.in's when you │ │ │ │ │ +000152c0: 2075 7067 7261 6465 0a20 2020 2020 4175 upgrade. Au │ │ │ │ │ +000152d0: 746f 6d61 6b65 2061 6e64 206d 616b 6520 tomake and make │ │ │ │ │ +000152e0: 7375 7265 2074 6865 7920 6c6f 6f6b 204f sure they look O │ │ │ │ │ +000152f0: 4b29 2e0a 0a20 2020 2a20 5573 6572 7320 K)... * Users │ │ │ │ │ +00015300: 646f 206e 6f74 206e 6565 6420 7468 6520 do not need the │ │ │ │ │ +00015310: 6175 746f 746f 6f6c 7320 746f 2062 7569 autotools to bui │ │ │ │ │ +00015320: 6c64 2061 2063 6865 636b 6f75 7420 6f66 ld a checkout of │ │ │ │ │ +00015330: 2074 6865 2070 726f 6a65 6374 2c0a 2020 the project,. │ │ │ │ │ +00015340: 2020 2069 7420 776f 726b 7320 6a75 7374 it works just │ │ │ │ │ +00015350: 206c 696b 6520 6120 7265 6c65 6173 6564 like a released │ │ │ │ │ +00015360: 2074 6172 6261 6c6c 2e0a 0a20 2020 2a20 tarball... * │ │ │ │ │ +00015370: 4966 2075 7365 7273 2075 7365 2027 6376 If users use 'cv │ │ │ │ │ +00015380: 7320 7570 6461 7465 2720 746f 2075 7064 s update' to upd │ │ │ │ │ +00015390: 6174 6520 7468 6569 7220 636f 7079 2c20 ate their copy, │ │ │ │ │ +000153a0: 696e 7374 6561 6420 6f66 2027 6376 730a instead of 'cvs. │ │ │ │ │ +000153b0: 2020 2020 2063 6865 636b 6f75 7427 2074 checkout' t │ │ │ │ │ +000153c0: 6f20 6665 7463 6820 6120 6672 6573 6820 o fetch a fresh │ │ │ │ │ +000153d0: 6f6e 652c 2074 696d 6573 7461 6d70 7320 one, timestamps │ │ │ │ │ +000153e0: 7769 6c6c 2062 6520 696e 6163 6375 7261 will be inaccura │ │ │ │ │ +000153f0: 7465 2e0a 2020 2020 2053 6f6d 6520 7265 te.. Some re │ │ │ │ │ +00015400: 6275 696c 6420 7275 6c65 7320 7769 6c6c build rules will │ │ │ │ │ +00015410: 2062 6520 7472 6967 6765 7265 6420 616e be triggered an │ │ │ │ │ +00015420: 6420 6174 7465 6d70 7420 746f 2072 756e d attempt to run │ │ │ │ │ +00015430: 2064 6576 656c 6f70 6572 0a20 2020 2020 developer. │ │ │ │ │ +00015440: 746f 6f6c 7320 7375 6368 2061 7320 2761 tools such as 'a │ │ │ │ │ +00015450: 7574 6f63 6f6e 6627 206f 7220 2761 7574 utoconf' or 'aut │ │ │ │ │ +00015460: 6f6d 616b 6527 2e0a 0a20 2020 2020 4163 omake'... Ac │ │ │ │ │ +00015470: 7475 616c 6c79 2c20 6361 6c6c 7320 746f tually, calls to │ │ │ │ │ +00015480: 2073 7563 6820 746f 6f6c 7320 6172 6520 such tools are │ │ │ │ │ +00015490: 616c 6c20 7772 6170 7065 6420 696e 746f all wrapped into │ │ │ │ │ +000154a0: 2061 2063 616c 6c20 746f 2074 6865 0a20 a call to the. │ │ │ │ │ +000154b0: 2020 2020 276d 6973 7369 6e67 2720 7363 'missing' sc │ │ │ │ │ +000154c0: 7269 7074 2064 6973 6375 7373 6564 206c ript discussed l │ │ │ │ │ +000154d0: 6174 6572 2028 2a6e 6f74 6520 6d61 696e ater (*note main │ │ │ │ │ +000154e0: 7461 696e 6572 2d6d 6f64 653a 3a29 2e0a tainer-mode::).. │ │ │ │ │ +000154f0: 2020 2020 2027 6d69 7373 696e 6727 2077 'missing' w │ │ │ │ │ +00015500: 696c 6c20 7461 6b65 2063 6172 6520 6f66 ill take care of │ │ │ │ │ +00015510: 2066 6978 696e 6720 7468 6520 7469 6d65 fixing the time │ │ │ │ │ +00015520: 7374 616d 7073 2077 6865 6e20 7468 6573 stamps when thes │ │ │ │ │ +00015530: 6520 746f 6f6c 730a 2020 2020 2061 7265 e tools. are │ │ │ │ │ +00015540: 206e 6f74 2069 6e73 7461 6c6c 6564 2c20 not installed, │ │ │ │ │ +00015550: 736f 2074 6861 7420 7468 6520 6275 696c so that the buil │ │ │ │ │ +00015560: 6420 6361 6e20 636f 6e74 696e 7565 2e0a d can continue.. │ │ │ │ │ +00015570: 0a20 2020 2a20 496e 2064 6973 7472 6962 . * In distrib │ │ │ │ │ +00015580: 7574 6564 2064 6576 656c 6f70 6d65 6e74 uted development │ │ │ │ │ +00015590: 2c20 6465 7665 6c6f 7065 7273 2061 7265 , developers are │ │ │ │ │ +000155a0: 206c 696b 656c 7920 746f 2068 6176 6520 likely to have │ │ │ │ │ +000155b0: 6469 6666 6572 656e 740a 2020 2020 2076 different. v │ │ │ │ │ +000155c0: 6572 7369 6f6e 206f 6620 7468 6520 6d61 ersion of the ma │ │ │ │ │ +000155d0: 696e 7461 696e 6572 2074 6f6f 6c73 2069 intainer tools i │ │ │ │ │ +000155e0: 6e73 7461 6c6c 6564 2e20 2049 6e20 7468 nstalled. In th │ │ │ │ │ +000155f0: 6973 2063 6173 6520 7265 6275 696c 6473 is case rebuilds │ │ │ │ │ +00015600: 0a20 2020 2020 7472 6967 6765 7265 6420 . triggered │ │ │ │ │ +00015610: 6279 2074 696d 6573 7461 6d70 206c 6f73 by timestamp los │ │ │ │ │ +00015620: 7361 6765 2077 696c 6c20 6c65 6164 2074 sage will lead t │ │ │ │ │ +00015630: 6f20 7370 7572 696f 7573 2063 6861 6e67 o spurious chang │ │ │ │ │ +00015640: 6573 2074 6f0a 2020 2020 2067 656e 6572 es to. gener │ │ │ │ │ +00015650: 6174 6564 2066 696c 6573 2e20 2054 6865 ated files. The │ │ │ │ │ +00015660: 7265 2061 7265 2073 6576 6572 616c 2073 re are several s │ │ │ │ │ +00015670: 6f6c 7574 696f 6e73 2074 6f20 7468 6973 olutions to this │ │ │ │ │ +00015680: 3a0a 0a20 2020 2020 2020 202a 2041 6c6c :.. * All │ │ │ │ │ +00015690: 2064 6576 656c 6f70 6572 7320 7368 6f75 developers shou │ │ │ │ │ +000156a0: 6c64 2075 7365 2074 6865 2073 616d 6520 ld use the same │ │ │ │ │ +000156b0: 7665 7273 696f 6e73 2c20 736f 2074 6861 versions, so tha │ │ │ │ │ +000156c0: 7420 7468 650a 2020 2020 2020 2020 2020 t the. │ │ │ │ │ +000156d0: 7265 6275 696c 7420 6669 6c65 7320 6172 rebuilt files ar │ │ │ │ │ +000156e0: 6520 6964 656e 7469 6361 6c20 746f 2066 e identical to f │ │ │ │ │ +000156f0: 696c 6573 2069 6e20 4356 532e 2020 2854 iles in CVS. (T │ │ │ │ │ +00015700: 6869 7320 7374 6172 7473 2074 6f0a 2020 his starts to. │ │ │ │ │ +00015710: 2020 2020 2020 2020 6265 2064 6966 6669 be diffi │ │ │ │ │ +00015720: 6375 6c74 2077 6865 6e20 6561 6368 2070 cult when each p │ │ │ │ │ +00015730: 726f 6a65 6374 2079 6f75 2077 6f72 6b20 roject you work │ │ │ │ │ +00015740: 6f6e 2075 7365 7320 6469 6666 6572 656e on uses differen │ │ │ │ │ +00015750: 740a 2020 2020 2020 2020 2020 7665 7273 t. vers │ │ │ │ │ +00015760: 696f 6e73 2e29 0a20 2020 2020 2020 202a ions.). * │ │ │ │ │ +00015770: 204f 7220 7065 6f70 6c65 2075 7365 2061 Or people use a │ │ │ │ │ +00015780: 2073 6372 6970 7420 746f 2066 6978 2074 script to fix t │ │ │ │ │ +00015790: 6865 2074 696d 6573 7461 6d70 2061 6674 he timestamp aft │ │ │ │ │ +000157a0: 6572 2061 2063 6865 636b 6f75 740a 2020 er a checkout. │ │ │ │ │ +000157b0: 2020 2020 2020 2020 2874 6865 2047 4343 (the GCC │ │ │ │ │ +000157c0: 2066 6f6c 6b73 2068 6176 6520 7375 6368 folks have such │ │ │ │ │ +000157d0: 2061 2073 6372 6970 7429 2e0a 2020 2020 a script).. │ │ │ │ │ +000157e0: 2020 2020 2a20 4f72 2027 636f 6e66 6967 * Or 'config │ │ │ │ │ +000157f0: 7572 652e 6163 2720 7573 6573 2027 414d ure.ac' uses 'AM │ │ │ │ │ +00015800: 5f4d 4149 4e54 4149 4e45 525f 4d4f 4445 _MAINTAINER_MODE │ │ │ │ │ +00015810: 272c 2077 6869 6368 2077 696c 6c0a 2020 ', which will. │ │ │ │ │ +00015820: 2020 2020 2020 2020 6469 7361 626c 6520 disable │ │ │ │ │ +00015830: 616c 6c20 7468 6573 6520 7265 6275 696c all these rebuil │ │ │ │ │ +00015840: 6420 7275 6c65 7320 6279 2064 6566 6175 d rules by defau │ │ │ │ │ +00015850: 6c74 2e20 2054 6869 7320 6973 2066 7572 lt. This is fur │ │ │ │ │ +00015860: 7468 6572 0a20 2020 2020 2020 2020 2064 ther. d │ │ │ │ │ +00015870: 6973 6375 7373 6564 2069 6e20 2a6e 6f74 iscussed in *not │ │ │ │ │ +00015880: 6520 6d61 696e 7461 696e 6572 2d6d 6f64 e maintainer-mod │ │ │ │ │ +00015890: 653a 3a2e 0a0a 2020 202a 2041 6c74 686f e::... * Altho │ │ │ │ │ +000158a0: 7567 6820 7765 2066 6f63 7573 6564 206f ugh we focused o │ │ │ │ │ +000158b0: 6e20 7370 7572 696f 7573 2072 6562 7569 n spurious rebui │ │ │ │ │ +000158c0: 6c64 732c 2074 6865 2063 6f6e 7665 7273 lds, the convers │ │ │ │ │ +000158d0: 6520 6361 6e20 616c 736f 0a20 2020 2020 e can also. │ │ │ │ │ +000158e0: 6861 7070 656e 2e20 2043 5653 2773 2074 happen. CVS's t │ │ │ │ │ +000158f0: 696d 6573 7461 6d70 2068 616e 646c 696e imestamp handlin │ │ │ │ │ +00015900: 6720 6361 6e20 616c 736f 206c 6574 2079 g can also let y │ │ │ │ │ +00015910: 6f75 2074 6869 6e6b 2061 6e0a 2020 2020 ou think an. │ │ │ │ │ +00015920: 206f 7574 2d6f 662d 6461 7465 2066 696c out-of-date fil │ │ │ │ │ +00015930: 6520 6973 2075 702d 746f 2d64 6174 652e e is up-to-date. │ │ │ │ │ +00015940: 0a0a 2020 2020 2046 6f72 2069 6e73 7461 .. For insta │ │ │ │ │ +00015950: 6e63 652c 2073 7570 706f 7365 2061 2064 nce, suppose a d │ │ │ │ │ +00015960: 6576 656c 6f70 6572 2068 6173 206d 6f64 eveloper has mod │ │ │ │ │ +00015970: 6966 6965 6420 274d 616b 6566 696c 652e ified 'Makefile. │ │ │ │ │ +00015980: 616d 2720 616e 640a 2020 2020 2068 6173 am' and. has │ │ │ │ │ +00015990: 2072 6562 7569 6c74 2027 4d61 6b65 6669 rebuilt 'Makefi │ │ │ │ │ +000159a0: 6c65 2e69 6e27 2c20 616e 6420 7468 656e le.in', and then │ │ │ │ │ +000159b0: 2064 6563 6964 6573 2074 6f20 646f 2061 decides to do a │ │ │ │ │ +000159c0: 206c 6173 742d 6d69 6e75 7465 0a20 2020 last-minute. │ │ │ │ │ +000159d0: 2020 6368 616e 6765 2074 6f20 274d 616b change to 'Mak │ │ │ │ │ +000159e0: 6566 696c 652e 616d 2720 7269 6768 7420 efile.am' right │ │ │ │ │ +000159f0: 6265 666f 7265 2063 6865 636b 696e 6720 before checking │ │ │ │ │ +00015a00: 696e 2062 6f74 6820 6669 6c65 730a 2020 in both files. │ │ │ │ │ +00015a10: 2020 2028 7769 7468 6f75 7420 7265 6275 (without rebu │ │ │ │ │ +00015a20: 696c 6469 6e67 2027 4d61 6b65 6669 6c65 ilding 'Makefile │ │ │ │ │ +00015a30: 2e69 6e27 2074 6f20 6163 636f 756e 7420 .in' to account │ │ │ │ │ +00015a40: 666f 7220 7468 6520 6368 616e 6765 292e for the change). │ │ │ │ │ +00015a50: 0a0a 2020 2020 2054 6869 7320 6c61 7374 .. This last │ │ │ │ │ +00015a60: 2063 6861 6e67 6520 746f 2027 4d61 6b65 change to 'Make │ │ │ │ │ +00015a70: 6669 6c65 2e61 6d27 206d 616b 6573 2074 file.am' makes t │ │ │ │ │ +00015a80: 6865 2063 6f70 7920 6f66 2027 4d61 6b65 he copy of 'Make │ │ │ │ │ +00015a90: 6669 6c65 2e69 6e27 0a20 2020 2020 6f75 file.in'. ou │ │ │ │ │ +00015aa0: 742d 6f66 2d64 6174 652e 2020 5369 6e63 t-of-date. Sinc │ │ │ │ │ +00015ab0: 6520 4356 5320 7072 6f63 6573 7365 7320 e CVS processes │ │ │ │ │ +00015ac0: 6669 6c65 7320 616c 7068 6162 6574 6963 files alphabetic │ │ │ │ │ +00015ad0: 616c 6c79 2c20 7768 656e 0a20 2020 2020 ally, when. │ │ │ │ │ +00015ae0: 616e 6f74 6865 7220 6465 7665 6c6f 7065 another develope │ │ │ │ │ +00015af0: 7220 2763 7673 2075 7064 6174 6527 7320 r 'cvs update's │ │ │ │ │ +00015b00: 6869 7320 6f72 2068 6572 2074 7265 652c his or her tree, │ │ │ │ │ +00015b10: 2027 4d61 6b65 6669 6c65 2e69 6e27 2077 'Makefile.in' w │ │ │ │ │ +00015b20: 696c 6c0a 2020 2020 2068 6170 7065 6e20 ill. happen │ │ │ │ │ +00015b30: 746f 2062 6520 6e65 7765 7220 7468 616e to be newer than │ │ │ │ │ +00015b40: 2027 4d61 6b65 6669 6c65 2e61 6d27 2e20 'Makefile.am'. │ │ │ │ │ +00015b50: 2054 6869 7320 6f74 6865 7220 6465 7665 This other deve │ │ │ │ │ +00015b60: 6c6f 7065 7220 7769 6c6c 0a20 2020 2020 loper will. │ │ │ │ │ +00015b70: 6e6f 7420 7365 6520 7468 6174 2027 4d61 not see that 'Ma │ │ │ │ │ +00015b80: 6b65 6669 6c65 2e69 6e27 2069 7320 6f75 kefile.in' is ou │ │ │ │ │ +00015b90: 742d 6f66 2d64 6174 652e 0a0a 4765 6e65 t-of-date...Gene │ │ │ │ │ +00015ba0: 7261 7465 6420 4669 6c65 7320 6f75 7420 rated Files out │ │ │ │ │ +00015bb0: 6f66 2043 5653 0a2e 2e2e 2e2e 2e2e 2e2e of CVS.......... │ │ │ │ │ 00015bc0: 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ................ │ │ │ │ │ -00015bd0: 0a0a 4f6e 6520 7761 7920 746f 2067 6574 ..One way to get │ │ │ │ │ -00015be0: 2043 5653 2061 6e64 2027 6d61 6b65 2720 CVS and 'make' │ │ │ │ │ -00015bf0: 776f 726b 696e 6720 7065 6163 6566 756c working peaceful │ │ │ │ │ -00015c00: 6c79 2069 7320 746f 206e 6576 6572 2073 ly is to never s │ │ │ │ │ -00015c10: 746f 7265 0a67 656e 6572 6174 6564 2066 tore.generated f │ │ │ │ │ -00015c20: 696c 6573 2069 6e20 4356 532c 2069 2e65 iles in CVS, i.e │ │ │ │ │ -00015c30: 2e2c 2064 6f20 6e6f 7420 4356 532d 636f ., do not CVS-co │ │ │ │ │ -00015c40: 6e74 726f 6c20 6669 6c65 7320 7468 6174 ntrol files that │ │ │ │ │ -00015c50: 2061 7265 0a27 4d61 6b65 6669 6c65 2720 are.'Makefile' │ │ │ │ │ -00015c60: 7461 7267 6574 7320 2861 6c73 6f20 6361 targets (also ca │ │ │ │ │ -00015c70: 6c6c 6564 205f 6465 7269 7665 645f 2066 lled _derived_ f │ │ │ │ │ -00015c80: 696c 6573 292e 0a0a 2020 2054 6869 7320 iles)... This │ │ │ │ │ -00015c90: 7761 7920 6465 7665 6c6f 7065 7273 2061 way developers a │ │ │ │ │ -00015ca0: 7265 206e 6f74 2061 6e6e 6f79 6564 2062 re not annoyed b │ │ │ │ │ -00015cb0: 7920 6368 616e 6765 7320 746f 2067 656e y changes to gen │ │ │ │ │ -00015cc0: 6572 6174 6564 2066 696c 6573 2e0a 4974 erated files..It │ │ │ │ │ -00015cd0: 2064 6f65 7320 6e6f 7420 6d61 7474 6572 does not matter │ │ │ │ │ -00015ce0: 2069 6620 7468 6579 2061 6c6c 2068 6176 if they all hav │ │ │ │ │ -00015cf0: 6520 6469 6666 6572 656e 7420 7665 7273 e different vers │ │ │ │ │ -00015d00: 696f 6e73 2028 6173 7375 6d69 6e67 2074 ions (assuming t │ │ │ │ │ -00015d10: 6865 790a 6172 6520 636f 6d70 6174 6962 hey.are compatib │ │ │ │ │ -00015d20: 6c65 2c20 6f66 2063 6f75 7273 6529 2e20 le, of course). │ │ │ │ │ -00015d30: 2041 6e64 2066 696e 616c 6c79 2c20 7469 And finally, ti │ │ │ │ │ -00015d40: 6d65 7374 616d 7073 2061 7265 206e 6f74 mestamps are not │ │ │ │ │ -00015d50: 206c 6f73 742c 0a63 6861 6e67 6573 2074 lost,.changes t │ │ │ │ │ -00015d60: 6f20 736f 7572 6365 7320 6669 6c65 7320 o sources files │ │ │ │ │ -00015d70: 6361 6e27 7420 6265 206d 6973 7365 6420 can't be missed │ │ │ │ │ -00015d80: 6173 2069 6e20 7468 650a 274d 616b 6566 as in the.'Makef │ │ │ │ │ -00015d90: 696c 652e 616d 272f 274d 616b 6566 696c ile.am'/'Makefil │ │ │ │ │ -00015da0: 652e 696e 2720 6578 616d 706c 6520 6469 e.in' example di │ │ │ │ │ -00015db0: 7363 7573 7365 6420 6561 726c 6965 722e scussed earlier. │ │ │ │ │ -00015dc0: 0a0a 2020 2054 6865 2064 7261 7762 6163 .. The drawbac │ │ │ │ │ -00015dd0: 6b20 6973 2074 6861 7420 7468 6520 4356 k is that the CV │ │ │ │ │ -00015de0: 5320 7265 706f 7369 746f 7279 2069 7320 S repository is │ │ │ │ │ -00015df0: 6e6f 7420 616e 2065 7861 6374 2063 6f70 not an exact cop │ │ │ │ │ -00015e00: 7920 6f66 2077 6861 740a 6973 2064 6973 y of what.is dis │ │ │ │ │ -00015e10: 7472 6962 7574 6564 2061 6e64 2074 6861 tributed and tha │ │ │ │ │ -00015e20: 7420 7573 6572 7320 6e6f 7720 6e65 6564 t users now need │ │ │ │ │ -00015e30: 2074 6f20 696e 7374 616c 6c20 7661 7269 to install vari │ │ │ │ │ -00015e40: 6f75 7320 6465 7665 6c6f 706d 656e 740a ous development. │ │ │ │ │ -00015e50: 746f 6f6c 7320 286d 6179 6265 2065 7665 tools (maybe eve │ │ │ │ │ -00015e60: 6e20 7370 6563 6966 6963 2076 6572 7369 n specific versi │ │ │ │ │ -00015e70: 6f6e 7329 2062 6566 6f72 6520 7468 6579 ons) before they │ │ │ │ │ -00015e80: 2063 616e 2062 7569 6c64 2061 2063 6865 can build a che │ │ │ │ │ -00015e90: 636b 6f75 742e 0a42 7574 2c20 6166 7465 ckout..But, afte │ │ │ │ │ -00015ea0: 7220 616c 6c2c 2043 5653 2773 206a 6f62 r all, CVS's job │ │ │ │ │ -00015eb0: 2069 7320 7665 7273 696f 6e69 6e67 2c20 is versioning, │ │ │ │ │ -00015ec0: 6e6f 7420 6469 7374 7269 6275 7469 6f6e not distribution │ │ │ │ │ -00015ed0: 2e0a 0a20 2020 416c 6c6f 7769 6e67 2064 ... Allowing d │ │ │ │ │ -00015ee0: 6576 656c 6f70 6572 7320 746f 2075 7365 evelopers to use │ │ │ │ │ -00015ef0: 2064 6966 6665 7265 6e74 2076 6572 7369 different versi │ │ │ │ │ -00015f00: 6f6e 7320 6f66 2074 6865 6972 2074 6f6f ons of their too │ │ │ │ │ -00015f10: 6c73 2063 616e 2061 6c73 6f0a 6869 6465 ls can also.hide │ │ │ │ │ -00015f20: 2062 7567 7320 6475 7269 6e67 2064 6973 bugs during dis │ │ │ │ │ -00015f30: 7472 6962 7574 6564 2064 6576 656c 6f70 tributed develop │ │ │ │ │ -00015f40: 6d65 6e74 2e20 2049 6e64 6565 642c 2064 ment. Indeed, d │ │ │ │ │ -00015f50: 6576 656c 6f70 6572 7320 7769 6c6c 2062 evelopers will b │ │ │ │ │ -00015f60: 650a 7573 696e 6720 2868 656e 6365 2074 e.using (hence t │ │ │ │ │ -00015f70: 6573 7469 6e67 2920 7468 6569 7220 6f77 esting) their ow │ │ │ │ │ -00015f80: 6e20 6765 6e65 7261 7465 6420 6669 6c65 n generated file │ │ │ │ │ -00015f90: 732c 2069 6e73 7465 6164 206f 6620 7468 s, instead of th │ │ │ │ │ -00015fa0: 650a 6765 6e65 7261 7465 6420 6669 6c65 e.generated file │ │ │ │ │ -00015fb0: 7320 7468 6174 2077 696c 6c20 6265 2072 s that will be r │ │ │ │ │ -00015fc0: 656c 6561 7365 6420 6163 7475 616c 6c79 eleased actually │ │ │ │ │ -00015fd0: 2e20 2054 6865 2064 6576 656c 6f70 6572 . The developer │ │ │ │ │ -00015fe0: 2077 686f 0a70 7265 7061 7265 7320 7468 who.prepares th │ │ │ │ │ -00015ff0: 6520 7461 7262 616c 6c20 6d69 6768 7420 e tarball might │ │ │ │ │ -00016000: 6265 2075 7369 6e67 2061 2076 6572 7369 be using a versi │ │ │ │ │ -00016010: 6f6e 206f 6620 7468 6520 746f 6f6c 2074 on of the tool t │ │ │ │ │ -00016020: 6861 7420 7072 6f64 7563 6573 0a62 6f67 hat produces.bog │ │ │ │ │ -00016030: 7573 206f 7574 7075 7420 2866 6f72 2069 us output (for i │ │ │ │ │ -00016040: 6e73 7461 6e63 6520 6120 6e6f 6e2d 706f nstance a non-po │ │ │ │ │ -00016050: 7274 6162 6c65 2043 2066 696c 6529 2c20 rtable C file), │ │ │ │ │ -00016060: 736f 6d65 7468 696e 6720 6f74 6865 720a something other. │ │ │ │ │ -00016070: 6465 7665 6c6f 7065 7273 2063 6f75 6c64 developers could │ │ │ │ │ -00016080: 2068 6176 6520 6e6f 7469 6365 6420 6966 have noticed if │ │ │ │ │ -00016090: 2074 6865 7920 7765 7265 6e27 7420 7573 they weren't us │ │ │ │ │ -000160a0: 696e 6720 7468 6569 7220 6f77 6e20 7665 ing their own ve │ │ │ │ │ -000160b0: 7273 696f 6e73 0a6f 6620 7468 6973 2074 rsions.of this t │ │ │ │ │ -000160c0: 6f6f 6c2e 0a0a 5468 6972 642d 7061 7274 ool...Third-part │ │ │ │ │ -000160d0: 7920 4669 6c65 730a 2d2d 2d2d 2d2d 2d2d y Files.-------- │ │ │ │ │ -000160e0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a41 6e6f 7468 ---------..Anoth │ │ │ │ │ -000160f0: 6572 2063 6c61 7373 206f 6620 6669 6c65 er class of file │ │ │ │ │ -00016100: 7320 6e6f 7420 6469 7363 7573 7365 6420 s not discussed │ │ │ │ │ -00016110: 6865 7265 2028 6265 6361 7573 6520 7468 here (because th │ │ │ │ │ -00016120: 6579 2064 6f20 6e6f 7420 6361 7573 650a ey do not cause. │ │ │ │ │ -00016130: 7469 6d65 7374 616d 7020 6973 7375 6573 timestamp issues │ │ │ │ │ -00016140: 2920 6172 6520 6669 6c65 7320 7468 6174 ) are files that │ │ │ │ │ -00016150: 2061 7265 2073 6869 7070 6564 2077 6974 are shipped wit │ │ │ │ │ -00016160: 6820 6120 7061 636b 6167 652c 2062 7574 h a package, but │ │ │ │ │ -00016170: 0a6d 6169 6e74 6169 6e65 6420 656c 7365 .maintained else │ │ │ │ │ -00016180: 7768 6572 652e 2020 466f 7220 696e 7374 where. For inst │ │ │ │ │ -00016190: 616e 6365 2c20 746f 6f6c 7320 6c69 6b65 ance, tools like │ │ │ │ │ -000161a0: 2027 6765 7474 6578 7469 7a65 2720 616e 'gettextize' an │ │ │ │ │ -000161b0: 640a 2761 7574 6f70 6f69 6e74 2720 2866 d.'autopoint' (f │ │ │ │ │ -000161c0: 726f 6d20 4765 7474 6578 7429 206f 7220 rom Gettext) or │ │ │ │ │ -000161d0: 276c 6962 746f 6f6c 697a 6527 2028 6672 'libtoolize' (fr │ │ │ │ │ -000161e0: 6f6d 204c 6962 746f 6f6c 292c 2077 696c om Libtool), wil │ │ │ │ │ -000161f0: 6c20 696e 7374 616c 6c0a 6f72 2075 7064 l install.or upd │ │ │ │ │ -00016200: 6174 6520 6669 6c65 7320 696e 2079 6f75 ate files in you │ │ │ │ │ -00016210: 7220 7061 636b 6167 652e 0a0a 2020 2054 r package... T │ │ │ │ │ -00016220: 6865 7365 2066 696c 6573 2c20 7768 6574 hese files, whet │ │ │ │ │ -00016230: 6865 7220 7468 6579 2061 7265 206b 6570 her they are kep │ │ │ │ │ -00016240: 7420 756e 6465 7220 4356 5320 6f72 206e t under CVS or n │ │ │ │ │ -00016250: 6f74 2c20 7261 6973 6520 7369 6d69 6c61 ot, raise simila │ │ │ │ │ -00016260: 720a 636f 6e63 6572 6e73 2061 626f 7574 r.concerns about │ │ │ │ │ -00016270: 2076 6572 7369 6f6e 206d 6973 6d61 7463 version mismatc │ │ │ │ │ -00016280: 6820 6265 7477 6565 6e20 6465 7665 6c6f h between develo │ │ │ │ │ -00016290: 7065 7273 2720 746f 6f6c 732e 2020 5468 pers' tools. Th │ │ │ │ │ -000162a0: 6520 4765 7474 6578 740a 6d61 6e75 616c e Gettext.manual │ │ │ │ │ -000162b0: 2068 6173 2061 2073 6563 7469 6f6e 2061 has a section a │ │ │ │ │ -000162c0: 626f 7574 2074 6869 732c 2073 6565 202a bout this, see * │ │ │ │ │ -000162d0: 6e6f 7465 2043 5653 2049 7373 7565 733a note CVS Issues: │ │ │ │ │ -000162e0: 2028 6765 7474 6578 7429 4356 530a 4973 (gettext)CVS.Is │ │ │ │ │ -000162f0: 7375 6573 2e0a 0a1f 0a46 696c 653a 2061 sues.....File: a │ │ │ │ │ -00016300: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -00016310: 6f2c 2020 4e6f 6465 3a20 6d61 696e 7461 o, Node: mainta │ │ │ │ │ -00016320: 696e 6572 2d6d 6f64 652c 2020 4e65 7874 iner-mode, Next │ │ │ │ │ -00016330: 3a20 5769 6c64 6361 7264 732c 2020 5072 : Wildcards, Pr │ │ │ │ │ -00016340: 6576 3a20 4356 532c 2020 5570 3a20 4641 ev: CVS, Up: FA │ │ │ │ │ -00016350: 510a 0a32 382e 3220 276d 6973 7369 6e67 Q..28.2 'missing │ │ │ │ │ -00016360: 2720 616e 6420 2741 4d5f 4d41 494e 5441 ' and 'AM_MAINTA │ │ │ │ │ -00016370: 494e 4552 5f4d 4f44 4527 0a3d 3d3d 3d3d INER_MODE'.===== │ │ │ │ │ +00015bd0: 2e0a 0a4f 6e65 2077 6179 2074 6f20 6765 ...One way to ge │ │ │ │ │ +00015be0: 7420 4356 5320 616e 6420 276d 616b 6527 t CVS and 'make' │ │ │ │ │ +00015bf0: 2077 6f72 6b69 6e67 2070 6561 6365 6675 working peacefu │ │ │ │ │ +00015c00: 6c6c 7920 6973 2074 6f20 6e65 7665 7220 lly is to never │ │ │ │ │ +00015c10: 7374 6f72 650a 6765 6e65 7261 7465 6420 store.generated │ │ │ │ │ +00015c20: 6669 6c65 7320 696e 2043 5653 2c20 692e files in CVS, i. │ │ │ │ │ +00015c30: 652e 2c20 646f 206e 6f74 2043 5653 2d63 e., do not CVS-c │ │ │ │ │ +00015c40: 6f6e 7472 6f6c 2066 696c 6573 2074 6861 ontrol files tha │ │ │ │ │ +00015c50: 7420 6172 650a 274d 616b 6566 696c 6527 t are.'Makefile' │ │ │ │ │ +00015c60: 2074 6172 6765 7473 2028 616c 736f 2063 targets (also c │ │ │ │ │ +00015c70: 616c 6c65 6420 5f64 6572 6976 6564 5f20 alled _derived_ │ │ │ │ │ +00015c80: 6669 6c65 7329 2e0a 0a20 2020 5468 6973 files)... This │ │ │ │ │ +00015c90: 2077 6179 2064 6576 656c 6f70 6572 7320 way developers │ │ │ │ │ +00015ca0: 6172 6520 6e6f 7420 616e 6e6f 7965 6420 are not annoyed │ │ │ │ │ +00015cb0: 6279 2063 6861 6e67 6573 2074 6f20 6765 by changes to ge │ │ │ │ │ +00015cc0: 6e65 7261 7465 6420 6669 6c65 732e 0a49 nerated files..I │ │ │ │ │ +00015cd0: 7420 646f 6573 206e 6f74 206d 6174 7465 t does not matte │ │ │ │ │ +00015ce0: 7220 6966 2074 6865 7920 616c 6c20 6861 r if they all ha │ │ │ │ │ +00015cf0: 7665 2064 6966 6665 7265 6e74 2076 6572 ve different ver │ │ │ │ │ +00015d00: 7369 6f6e 7320 2861 7373 756d 696e 6720 sions (assuming │ │ │ │ │ +00015d10: 7468 6579 0a61 7265 2063 6f6d 7061 7469 they.are compati │ │ │ │ │ +00015d20: 626c 652c 206f 6620 636f 7572 7365 292e ble, of course). │ │ │ │ │ +00015d30: 2020 416e 6420 6669 6e61 6c6c 792c 2074 And finally, t │ │ │ │ │ +00015d40: 696d 6573 7461 6d70 7320 6172 6520 6e6f imestamps are no │ │ │ │ │ +00015d50: 7420 6c6f 7374 2c0a 6368 616e 6765 7320 t lost,.changes │ │ │ │ │ +00015d60: 746f 2073 6f75 7263 6573 2066 696c 6573 to sources files │ │ │ │ │ +00015d70: 2063 616e 2774 2062 6520 6d69 7373 6564 can't be missed │ │ │ │ │ +00015d80: 2061 7320 696e 2074 6865 0a27 4d61 6b65 as in the.'Make │ │ │ │ │ +00015d90: 6669 6c65 2e61 6d27 2f27 4d61 6b65 6669 file.am'/'Makefi │ │ │ │ │ +00015da0: 6c65 2e69 6e27 2065 7861 6d70 6c65 2064 le.in' example d │ │ │ │ │ +00015db0: 6973 6375 7373 6564 2065 6172 6c69 6572 iscussed earlier │ │ │ │ │ +00015dc0: 2e0a 0a20 2020 5468 6520 6472 6177 6261 ... The drawba │ │ │ │ │ +00015dd0: 636b 2069 7320 7468 6174 2074 6865 2043 ck is that the C │ │ │ │ │ +00015de0: 5653 2072 6570 6f73 6974 6f72 7920 6973 VS repository is │ │ │ │ │ +00015df0: 206e 6f74 2061 6e20 6578 6163 7420 636f not an exact co │ │ │ │ │ +00015e00: 7079 206f 6620 7768 6174 0a69 7320 6469 py of what.is di │ │ │ │ │ +00015e10: 7374 7269 6275 7465 6420 616e 6420 7468 stributed and th │ │ │ │ │ +00015e20: 6174 2075 7365 7273 206e 6f77 206e 6565 at users now nee │ │ │ │ │ +00015e30: 6420 746f 2069 6e73 7461 6c6c 2076 6172 d to install var │ │ │ │ │ +00015e40: 696f 7573 2064 6576 656c 6f70 6d65 6e74 ious development │ │ │ │ │ +00015e50: 0a74 6f6f 6c73 2028 6d61 7962 6520 6576 .tools (maybe ev │ │ │ │ │ +00015e60: 656e 2073 7065 6369 6669 6320 7665 7273 en specific vers │ │ │ │ │ +00015e70: 696f 6e73 2920 6265 666f 7265 2074 6865 ions) before the │ │ │ │ │ +00015e80: 7920 6361 6e20 6275 696c 6420 6120 6368 y can build a ch │ │ │ │ │ +00015e90: 6563 6b6f 7574 2e0a 4275 742c 2061 6674 eckout..But, aft │ │ │ │ │ +00015ea0: 6572 2061 6c6c 2c20 4356 5327 7320 6a6f er all, CVS's jo │ │ │ │ │ +00015eb0: 6220 6973 2076 6572 7369 6f6e 696e 672c b is versioning, │ │ │ │ │ +00015ec0: 206e 6f74 2064 6973 7472 6962 7574 696f not distributio │ │ │ │ │ +00015ed0: 6e2e 0a0a 2020 2041 6c6c 6f77 696e 6720 n... Allowing │ │ │ │ │ +00015ee0: 6465 7665 6c6f 7065 7273 2074 6f20 7573 developers to us │ │ │ │ │ +00015ef0: 6520 6469 6666 6572 656e 7420 7665 7273 e different vers │ │ │ │ │ +00015f00: 696f 6e73 206f 6620 7468 6569 7220 746f ions of their to │ │ │ │ │ +00015f10: 6f6c 7320 6361 6e20 616c 736f 0a68 6964 ols can also.hid │ │ │ │ │ +00015f20: 6520 6275 6773 2064 7572 696e 6720 6469 e bugs during di │ │ │ │ │ +00015f30: 7374 7269 6275 7465 6420 6465 7665 6c6f stributed develo │ │ │ │ │ +00015f40: 706d 656e 742e 2020 496e 6465 6564 2c20 pment. Indeed, │ │ │ │ │ +00015f50: 6465 7665 6c6f 7065 7273 2077 696c 6c20 developers will │ │ │ │ │ +00015f60: 6265 0a75 7369 6e67 2028 6865 6e63 6520 be.using (hence │ │ │ │ │ +00015f70: 7465 7374 696e 6729 2074 6865 6972 206f testing) their o │ │ │ │ │ +00015f80: 776e 2067 656e 6572 6174 6564 2066 696c wn generated fil │ │ │ │ │ +00015f90: 6573 2c20 696e 7374 6561 6420 6f66 2074 es, instead of t │ │ │ │ │ +00015fa0: 6865 0a67 656e 6572 6174 6564 2066 696c he.generated fil │ │ │ │ │ +00015fb0: 6573 2074 6861 7420 7769 6c6c 2062 6520 es that will be │ │ │ │ │ +00015fc0: 7265 6c65 6173 6564 2061 6374 7561 6c6c released actuall │ │ │ │ │ +00015fd0: 792e 2020 5468 6520 6465 7665 6c6f 7065 y. The develope │ │ │ │ │ +00015fe0: 7220 7768 6f0a 7072 6570 6172 6573 2074 r who.prepares t │ │ │ │ │ +00015ff0: 6865 2074 6172 6261 6c6c 206d 6967 6874 he tarball might │ │ │ │ │ +00016000: 2062 6520 7573 696e 6720 6120 7665 7273 be using a vers │ │ │ │ │ +00016010: 696f 6e20 6f66 2074 6865 2074 6f6f 6c20 ion of the tool │ │ │ │ │ +00016020: 7468 6174 2070 726f 6475 6365 730a 626f that produces.bo │ │ │ │ │ +00016030: 6775 7320 6f75 7470 7574 2028 666f 7220 gus output (for │ │ │ │ │ +00016040: 696e 7374 616e 6365 2061 206e 6f6e 2d70 instance a non-p │ │ │ │ │ +00016050: 6f72 7461 626c 6520 4320 6669 6c65 292c ortable C file), │ │ │ │ │ +00016060: 2073 6f6d 6574 6869 6e67 206f 7468 6572 something other │ │ │ │ │ +00016070: 0a64 6576 656c 6f70 6572 7320 636f 756c .developers coul │ │ │ │ │ +00016080: 6420 6861 7665 206e 6f74 6963 6564 2069 d have noticed i │ │ │ │ │ +00016090: 6620 7468 6579 2077 6572 656e 2774 2075 f they weren't u │ │ │ │ │ +000160a0: 7369 6e67 2074 6865 6972 206f 776e 2076 sing their own v │ │ │ │ │ +000160b0: 6572 7369 6f6e 730a 6f66 2074 6869 7320 ersions.of this │ │ │ │ │ +000160c0: 746f 6f6c 2e0a 0a54 6869 7264 2d70 6172 tool...Third-par │ │ │ │ │ +000160d0: 7479 2046 696c 6573 0a2d 2d2d 2d2d 2d2d ty Files.------- │ │ │ │ │ +000160e0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 416e 6f74 ----------..Anot │ │ │ │ │ +000160f0: 6865 7220 636c 6173 7320 6f66 2066 696c her class of fil │ │ │ │ │ +00016100: 6573 206e 6f74 2064 6973 6375 7373 6564 es not discussed │ │ │ │ │ +00016110: 2068 6572 6520 2862 6563 6175 7365 2074 here (because t │ │ │ │ │ +00016120: 6865 7920 646f 206e 6f74 2063 6175 7365 hey do not cause │ │ │ │ │ +00016130: 0a74 696d 6573 7461 6d70 2069 7373 7565 .timestamp issue │ │ │ │ │ +00016140: 7329 2061 7265 2066 696c 6573 2074 6861 s) are files tha │ │ │ │ │ +00016150: 7420 6172 6520 7368 6970 7065 6420 7769 t are shipped wi │ │ │ │ │ +00016160: 7468 2061 2070 6163 6b61 6765 2c20 6275 th a package, bu │ │ │ │ │ +00016170: 740a 6d61 696e 7461 696e 6564 2065 6c73 t.maintained els │ │ │ │ │ +00016180: 6577 6865 7265 2e20 2046 6f72 2069 6e73 ewhere. For ins │ │ │ │ │ +00016190: 7461 6e63 652c 2074 6f6f 6c73 206c 696b tance, tools lik │ │ │ │ │ +000161a0: 6520 2767 6574 7465 7874 697a 6527 2061 e 'gettextize' a │ │ │ │ │ +000161b0: 6e64 0a27 6175 746f 706f 696e 7427 2028 nd.'autopoint' ( │ │ │ │ │ +000161c0: 6672 6f6d 2047 6574 7465 7874 2920 6f72 from Gettext) or │ │ │ │ │ +000161d0: 2027 6c69 6274 6f6f 6c69 7a65 2720 2866 'libtoolize' (f │ │ │ │ │ +000161e0: 726f 6d20 4c69 6274 6f6f 6c29 2c20 7769 rom Libtool), wi │ │ │ │ │ +000161f0: 6c6c 2069 6e73 7461 6c6c 0a6f 7220 7570 ll install.or up │ │ │ │ │ +00016200: 6461 7465 2066 696c 6573 2069 6e20 796f date files in yo │ │ │ │ │ +00016210: 7572 2070 6163 6b61 6765 2e0a 0a20 2020 ur package... │ │ │ │ │ +00016220: 5468 6573 6520 6669 6c65 732c 2077 6865 These files, whe │ │ │ │ │ +00016230: 7468 6572 2074 6865 7920 6172 6520 6b65 ther they are ke │ │ │ │ │ +00016240: 7074 2075 6e64 6572 2043 5653 206f 7220 pt under CVS or │ │ │ │ │ +00016250: 6e6f 742c 2072 6169 7365 2073 696d 696c not, raise simil │ │ │ │ │ +00016260: 6172 0a63 6f6e 6365 726e 7320 6162 6f75 ar.concerns abou │ │ │ │ │ +00016270: 7420 7665 7273 696f 6e20 6d69 736d 6174 t version mismat │ │ │ │ │ +00016280: 6368 2062 6574 7765 656e 2064 6576 656c ch between devel │ │ │ │ │ +00016290: 6f70 6572 7327 2074 6f6f 6c73 2e20 2054 opers' tools. T │ │ │ │ │ +000162a0: 6865 2047 6574 7465 7874 0a6d 616e 7561 he Gettext.manua │ │ │ │ │ +000162b0: 6c20 6861 7320 6120 7365 6374 696f 6e20 l has a section │ │ │ │ │ +000162c0: 6162 6f75 7420 7468 6973 2c20 7365 6520 about this, see │ │ │ │ │ +000162d0: 2a6e 6f74 6520 4356 5320 4973 7375 6573 *note CVS Issues │ │ │ │ │ +000162e0: 3a20 2867 6574 7465 7874 2943 5653 0a49 : (gettext)CVS.I │ │ │ │ │ +000162f0: 7373 7565 732e 0a0a 1f0a 4669 6c65 3a20 ssues.....File: │ │ │ │ │ +00016300: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +00016310: 666f 2c20 204e 6f64 653a 206d 6169 6e74 fo, Node: maint │ │ │ │ │ +00016320: 6169 6e65 722d 6d6f 6465 2c20 204e 6578 ainer-mode, Nex │ │ │ │ │ +00016330: 743a 2057 696c 6463 6172 6473 2c20 2050 t: Wildcards, P │ │ │ │ │ +00016340: 7265 763a 2043 5653 2c20 2055 703a 2046 rev: CVS, Up: F │ │ │ │ │ +00016350: 4151 0a0a 3238 2e32 2027 6d69 7373 696e AQ..28.2 'missin │ │ │ │ │ +00016360: 6727 2061 6e64 2027 414d 5f4d 4149 4e54 g' and 'AM_MAINT │ │ │ │ │ +00016370: 4149 4e45 525f 4d4f 4445 270a 3d3d 3d3d AINER_MODE'.==== │ │ │ │ │ 00016380: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00016390: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000163a0: 3d3d 0a0a 276d 6973 7369 6e67 270a 2d2d ==..'missing'.-- │ │ │ │ │ -000163b0: 2d2d 2d2d 2d2d 2d0a 0a54 6865 2027 6d69 -------..The 'mi │ │ │ │ │ -000163c0: 7373 696e 6727 2073 6372 6970 7420 6973 ssing' script is │ │ │ │ │ -000163d0: 2061 2077 7261 7070 6572 2061 726f 756e a wrapper aroun │ │ │ │ │ -000163e0: 6420 7365 7665 7261 6c20 6d61 696e 7461 d several mainta │ │ │ │ │ -000163f0: 696e 6572 2074 6f6f 6c73 2c0a 6465 7369 iner tools,.desi │ │ │ │ │ -00016400: 676e 6564 2074 6f20 7761 726e 2075 7365 gned to warn use │ │ │ │ │ -00016410: 7273 2069 6620 6120 6d61 696e 7461 696e rs if a maintain │ │ │ │ │ -00016420: 6572 2074 6f6f 6c20 6973 2072 6571 7569 er tool is requi │ │ │ │ │ -00016430: 7265 6420 6275 7420 6d69 7373 696e 672e red but missing. │ │ │ │ │ -00016440: 0a54 7970 6963 616c 206d 6169 6e74 6169 .Typical maintai │ │ │ │ │ -00016450: 6e65 7220 746f 6f6c 7320 6172 6520 2761 ner tools are 'a │ │ │ │ │ -00016460: 7574 6f63 6f6e 6627 2c20 2761 7574 6f6d utoconf', 'autom │ │ │ │ │ -00016470: 616b 6527 2c20 2762 6973 6f6e 272c 2065 ake', 'bison', e │ │ │ │ │ -00016480: 7463 2e0a 4265 6361 7573 6520 6669 6c65 tc..Because file │ │ │ │ │ -00016490: 2067 656e 6572 6174 6564 2062 7920 7468 generated by th │ │ │ │ │ -000164a0: 6573 6520 746f 6f6c 7320 6172 6520 7368 ese tools are sh │ │ │ │ │ -000164b0: 6970 7065 6420 7769 7468 2074 6865 206f ipped with the o │ │ │ │ │ -000164c0: 7468 6572 2073 6f75 7263 6573 0a6f 6620 ther sources.of │ │ │ │ │ -000164d0: 6120 7061 636b 6167 652c 2074 6865 7365 a package, these │ │ │ │ │ -000164e0: 2074 6f6f 6c73 2073 686f 756c 646e 2774 tools shouldn't │ │ │ │ │ -000164f0: 2062 6520 7265 7175 6972 6564 2064 7572 be required dur │ │ │ │ │ -00016500: 696e 6720 6120 7573 6572 2062 7569 6c64 ing a user build │ │ │ │ │ -00016510: 2061 6e64 0a74 6865 7920 6172 6520 6e6f and.they are no │ │ │ │ │ -00016520: 7420 6368 6563 6b65 6420 666f 7220 696e t checked for in │ │ │ │ │ -00016530: 2027 636f 6e66 6967 7572 6527 2e0a 0a20 'configure'... │ │ │ │ │ -00016540: 2020 486f 7765 7665 722c 2069 6620 666f However, if fo │ │ │ │ │ -00016550: 7220 736f 6d65 2072 6561 736f 6e20 6120 r some reason a │ │ │ │ │ -00016560: 7265 6275 696c 6420 7275 6c65 2069 7320 rebuild rule is │ │ │ │ │ -00016570: 7472 6967 6765 7265 6420 616e 6420 696e triggered and in │ │ │ │ │ -00016580: 766f 6c76 6573 0a61 206d 6973 7369 6e67 volves.a missing │ │ │ │ │ -00016590: 2074 6f6f 6c2c 2027 6d69 7373 696e 6727 tool, 'missing' │ │ │ │ │ -000165a0: 2077 696c 6c20 6e6f 7469 6365 2069 7420 will notice it │ │ │ │ │ -000165b0: 616e 6420 7761 726e 2074 6865 2075 7365 and warn the use │ │ │ │ │ -000165c0: 722e 2020 4265 7369 6465 7320 7468 650a r. Besides the. │ │ │ │ │ -000165d0: 7761 726e 696e 672c 2077 6865 6e20 6120 warning, when a │ │ │ │ │ -000165e0: 746f 6f6c 2069 7320 6d69 7373 696e 672c tool is missing, │ │ │ │ │ -000165f0: 2027 6d69 7373 696e 6727 2077 696c 6c20 'missing' will │ │ │ │ │ -00016600: 6174 7465 6d70 7420 746f 2066 6978 0a74 attempt to fix.t │ │ │ │ │ -00016610: 696d 6573 7461 6d70 7320 696e 2061 2077 imestamps in a w │ │ │ │ │ -00016620: 6179 2074 6861 7420 616c 6c6f 7773 2074 ay that allows t │ │ │ │ │ -00016630: 6865 2062 7569 6c64 2074 6f20 636f 6e74 he build to cont │ │ │ │ │ -00016640: 696e 7565 2e20 2046 6f72 2069 6e73 7461 inue. For insta │ │ │ │ │ -00016650: 6e63 652c 0a27 6d69 7373 696e 6727 2077 nce,.'missing' w │ │ │ │ │ -00016660: 696c 6c20 746f 7563 6820 2763 6f6e 6669 ill touch 'confi │ │ │ │ │ -00016670: 6775 7265 2720 6966 2027 6175 746f 636f gure' if 'autoco │ │ │ │ │ -00016680: 6e66 2720 6973 206e 6f74 2069 6e73 7461 nf' is not insta │ │ │ │ │ -00016690: 6c6c 6564 2e20 2057 6865 6e0a 616c 6c20 lled. When.all │ │ │ │ │ -000166a0: 6469 7374 7269 6275 7465 6420 6669 6c65 distributed file │ │ │ │ │ -000166b0: 7320 6172 6520 6b65 7074 2075 6e64 6572 s are kept under │ │ │ │ │ -000166c0: 2076 6572 7369 6f6e 2063 6f6e 7472 6f6c version control │ │ │ │ │ -000166d0: 2c20 7468 6973 2066 6561 7475 7265 206f , this feature o │ │ │ │ │ -000166e0: 660a 276d 6973 7369 6e67 2720 616c 6c6f f.'missing' allo │ │ │ │ │ -000166f0: 7773 2061 2075 7365 7220 5f77 6974 6820 ws a user _with │ │ │ │ │ -00016700: 6e6f 206d 6169 6e74 6169 6e65 7220 746f no maintainer to │ │ │ │ │ -00016710: 6f6c 735f 2074 6f20 6275 696c 6420 6120 ols_ to build a │ │ │ │ │ -00016720: 7061 636b 6167 650a 6f66 6620 6974 7320 package.off its │ │ │ │ │ -00016730: 7665 7273 696f 6e20 636f 6e74 726f 6c20 version control │ │ │ │ │ -00016740: 7265 706f 7369 746f 7279 2c20 6279 7061 repository, bypa │ │ │ │ │ -00016750: 7373 696e 6720 616e 7920 7469 6d65 7374 ssing any timest │ │ │ │ │ -00016760: 616d 700a 696e 636f 6e73 6973 7465 6e63 amp.inconsistenc │ │ │ │ │ -00016770: 7920 2869 6d70 6c69 6564 2062 7920 652e y (implied by e. │ │ │ │ │ -00016780: 672e 2027 6376 7320 7570 6461 7465 2720 g. 'cvs update' │ │ │ │ │ -00016790: 6f72 2027 6769 7420 636c 6f6e 6527 292e or 'git clone'). │ │ │ │ │ -000167a0: 0a0a 2020 2049 6620 7468 6520 7265 7175 .. If the requ │ │ │ │ │ -000167b0: 6972 6564 2074 6f6f 6c20 6973 2069 6e73 ired tool is ins │ │ │ │ │ -000167c0: 7461 6c6c 6564 2c20 276d 6973 7369 6e67 talled, 'missing │ │ │ │ │ -000167d0: 2720 7769 6c6c 2072 756e 2069 7420 616e ' will run it an │ │ │ │ │ -000167e0: 6420 776f 6e27 740a 6174 7465 6d70 7420 d won't.attempt │ │ │ │ │ -000167f0: 746f 2063 6f6e 7469 6e75 6520 6166 7465 to continue afte │ │ │ │ │ -00016800: 7220 6661 696c 7572 6573 2e20 2054 6869 r failures. Thi │ │ │ │ │ -00016810: 7320 6973 2063 6f72 7265 6374 2064 7572 s is correct dur │ │ │ │ │ -00016820: 696e 6720 6465 7665 6c6f 706d 656e 743a ing development: │ │ │ │ │ -00016830: 0a64 6576 656c 6f70 6572 7320 6c6f 7665 .developers love │ │ │ │ │ -00016840: 2066 6978 696e 6720 6661 696c 7572 6573 fixing failures │ │ │ │ │ -00016850: 2e20 2048 6f77 6576 6572 2c20 7573 6572 . However, user │ │ │ │ │ -00016860: 7320 7769 7468 2077 726f 6e67 2076 6572 s with wrong ver │ │ │ │ │ -00016870: 7369 6f6e 7320 6f66 0a6d 6169 6e74 6169 sions of.maintai │ │ │ │ │ -00016880: 6e65 7220 746f 6f6c 7320 6d61 7920 6765 ner tools may ge │ │ │ │ │ -00016890: 7420 616e 2065 7272 6f72 2077 6865 6e20 t an error when │ │ │ │ │ -000168a0: 7468 6520 7265 6275 696c 6420 7275 6c65 the rebuild rule │ │ │ │ │ -000168b0: 2069 7320 7370 7572 696f 7573 6c79 0a74 is spuriously.t │ │ │ │ │ -000168c0: 7269 6767 6572 6564 2c20 6861 6c74 696e riggered, haltin │ │ │ │ │ -000168d0: 6720 7468 6520 6275 696c 642e 2020 5468 g the build. Th │ │ │ │ │ -000168e0: 6973 2066 6169 6c75 7265 2074 6f20 6c65 is failure to le │ │ │ │ │ -000168f0: 7420 7468 6520 6275 696c 6420 636f 6e74 t the build cont │ │ │ │ │ -00016900: 696e 7565 2069 730a 6f6e 6520 6f66 2074 inue is.one of t │ │ │ │ │ -00016910: 6865 2061 7267 756d 656e 7473 206f 6620 he arguments of │ │ │ │ │ -00016920: 7468 6520 2741 4d5f 4d41 494e 5441 494e the 'AM_MAINTAIN │ │ │ │ │ -00016930: 4552 5f4d 4f44 4527 2061 6476 6f63 6174 ER_MODE' advocat │ │ │ │ │ -00016940: 6573 2e0a 0a27 414d 5f4d 4149 4e54 4149 es...'AM_MAINTAI │ │ │ │ │ -00016950: 4e45 525f 4d4f 4445 270a 2d2d 2d2d 2d2d NER_MODE'.------ │ │ │ │ │ -00016960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00016970: 2741 4d5f 4d41 494e 5441 494e 4552 5f4d 'AM_MAINTAINER_M │ │ │ │ │ -00016980: 4f44 4527 2061 6c6c 6f77 7320 796f 7520 ODE' allows you │ │ │ │ │ -00016990: 746f 2063 686f 6f73 6520 7768 6574 6865 to choose whethe │ │ │ │ │ -000169a0: 7220 7468 6520 736f 2063 616c 6c65 6420 r the so called │ │ │ │ │ -000169b0: 2272 6562 7569 6c64 0a72 756c 6573 2220 "rebuild.rules" │ │ │ │ │ -000169c0: 7368 6f75 6c64 2062 6520 656e 6162 6c65 should be enable │ │ │ │ │ -000169d0: 6420 6f72 2064 6973 6162 6c65 642e 2020 d or disabled. │ │ │ │ │ -000169e0: 5769 7468 0a27 414d 5f4d 4149 4e54 4149 With.'AM_MAINTAI │ │ │ │ │ -000169f0: 4e45 525f 4d4f 4445 285b 656e 6162 6c65 NER_MODE([enable │ │ │ │ │ -00016a00: 5d29 272c 2074 6865 7920 6172 6520 656e ])', they are en │ │ │ │ │ -00016a10: 6162 6c65 6420 6279 2064 6566 6175 6c74 abled by default │ │ │ │ │ -00016a20: 2c20 6f74 6865 7277 6973 650a 7468 6579 , otherwise.they │ │ │ │ │ -00016a30: 2061 7265 2064 6973 6162 6c65 6420 6279 are disabled by │ │ │ │ │ -00016a40: 2064 6566 6175 6c74 2e20 2049 6e20 7468 default. In th │ │ │ │ │ -00016a50: 6520 6c61 7474 6572 2063 6173 652c 2069 e latter case, i │ │ │ │ │ -00016a60: 6620 796f 7520 6861 7665 0a27 414d 5f4d f you have.'AM_M │ │ │ │ │ -00016a70: 4149 4e54 4149 4e45 525f 4d4f 4445 2720 AINTAINER_MODE' │ │ │ │ │ -00016a80: 696e 2027 636f 6e66 6967 7572 652e 6163 in 'configure.ac │ │ │ │ │ -00016a90: 272c 2061 6e64 2072 756e 2027 2e2f 636f ', and run './co │ │ │ │ │ -00016aa0: 6e66 6967 7572 6520 2626 206d 616b 6527 nfigure && make' │ │ │ │ │ -00016ab0: 2c0a 7468 656e 2027 6d61 6b65 2720 7769 ,.then 'make' wi │ │ │ │ │ -00016ac0: 6c6c 202a 6e65 7665 722a 2061 7474 656d ll *never* attem │ │ │ │ │ -00016ad0: 7074 2074 6f20 7265 6275 696c 6420 2763 pt to rebuild 'c │ │ │ │ │ -00016ae0: 6f6e 6669 6775 7265 272c 2027 4d61 6b65 onfigure', 'Make │ │ │ │ │ -00016af0: 6669 6c65 2e69 6e27 732c 0a4c 6578 206f file.in's,.Lex o │ │ │ │ │ -00016b00: 7220 5961 6363 206f 7574 7075 7473 2c20 r Yacc outputs, │ │ │ │ │ -00016b10: 6574 632e 2020 492e 652e 2c20 7468 6973 etc. I.e., this │ │ │ │ │ -00016b20: 2064 6973 6162 6c65 7320 6275 696c 6420 disables build │ │ │ │ │ -00016b30: 7275 6c65 7320 666f 7220 6669 6c65 730a rules for files. │ │ │ │ │ -00016b40: 7468 6174 2061 7265 2075 7375 616c 6c79 that are usually │ │ │ │ │ -00016b50: 2064 6973 7472 6962 7574 6564 2061 6e64 distributed and │ │ │ │ │ -00016b60: 2074 6861 7420 7573 6572 7320 7368 6f75 that users shou │ │ │ │ │ -00016b70: 6c64 206e 6f72 6d61 6c6c 7920 6e6f 7420 ld normally not │ │ │ │ │ -00016b80: 6861 7665 2074 6f0a 7570 6461 7465 2e0a have to.update.. │ │ │ │ │ -00016b90: 0a20 2020 5468 6520 7573 6572 2063 616e . The user can │ │ │ │ │ -00016ba0: 206f 7665 7272 6964 6520 7468 6520 6465 override the de │ │ │ │ │ -00016bb0: 6661 756c 7420 7365 7474 696e 6720 6279 fault setting by │ │ │ │ │ -00016bc0: 2070 6173 7369 6e67 2065 6974 6865 720a passing either. │ │ │ │ │ -00016bd0: 272d 2d65 6e61 626c 652d 6d61 696e 7461 '--enable-mainta │ │ │ │ │ -00016be0: 696e 6572 2d6d 6f64 6527 206f 7220 272d iner-mode' or '- │ │ │ │ │ -00016bf0: 2d64 6973 6162 6c65 2d6d 6169 6e74 6169 -disable-maintai │ │ │ │ │ -00016c00: 6e65 722d 6d6f 6465 2720 746f 0a27 636f ner-mode' to.'co │ │ │ │ │ -00016c10: 6e66 6967 7572 6527 2e0a 0a20 2020 5065 nfigure'... Pe │ │ │ │ │ -00016c20: 6f70 6c65 2075 7365 2027 414d 5f4d 4149 ople use 'AM_MAI │ │ │ │ │ -00016c30: 4e54 4149 4e45 525f 4d4f 4445 2720 6569 NTAINER_MODE' ei │ │ │ │ │ -00016c40: 7468 6572 2062 6563 6175 7365 2074 6865 ther because the │ │ │ │ │ -00016c50: 7920 646f 206e 6f74 2077 616e 7420 7468 y do not want th │ │ │ │ │ -00016c60: 6569 720a 7573 6572 7320 286f 7220 7468 eir.users (or th │ │ │ │ │ -00016c70: 656d 7365 6c76 6573 2920 616e 6e6f 7965 emselves) annoye │ │ │ │ │ -00016c80: 6420 6279 2074 696d 6573 7461 6d70 7320 d by timestamps │ │ │ │ │ -00016c90: 6c6f 7373 6167 6520 282a 6e6f 7465 2043 lossage (*note C │ │ │ │ │ -00016ca0: 5653 3a3a 292c 206f 720a 6265 6361 7573 VS::), or.becaus │ │ │ │ │ -00016cb0: 6520 7468 6579 2073 696d 706c 7920 6361 e they simply ca │ │ │ │ │ -00016cc0: 6e27 7420 7374 616e 6420 7468 6520 7265 n't stand the re │ │ │ │ │ -00016cd0: 6275 696c 6420 7275 6c65 7320 616e 6420 build rules and │ │ │ │ │ -00016ce0: 7072 6566 6572 2072 756e 6e69 6e67 0a6d prefer running.m │ │ │ │ │ -00016cf0: 6169 6e74 6169 6e65 7220 746f 6f6c 7320 aintainer tools │ │ │ │ │ -00016d00: 6578 706c 6963 6974 6c79 2e0a 0a20 2020 explicitly... │ │ │ │ │ -00016d10: 2741 4d5f 4d41 494e 5441 494e 4552 5f4d 'AM_MAINTAINER_M │ │ │ │ │ -00016d20: 4f44 4527 2061 6c73 6f20 616c 6c6f 7773 ODE' also allows │ │ │ │ │ -00016d30: 2079 6f75 2074 6f20 6469 7361 626c 6520 you to disable │ │ │ │ │ -00016d40: 736f 6d65 2063 7573 746f 6d20 6275 696c some custom buil │ │ │ │ │ -00016d50: 640a 7275 6c65 7320 636f 6e64 6974 696f d.rules conditio │ │ │ │ │ -00016d60: 6e61 6c6c 792e 2020 536f 6d65 2064 6576 nally. Some dev │ │ │ │ │ -00016d70: 656c 6f70 6572 7320 7573 6520 7468 6973 elopers use this │ │ │ │ │ -00016d80: 2066 6561 7475 7265 2074 6f20 6469 7361 feature to disa │ │ │ │ │ -00016d90: 626c 6520 7275 6c65 730a 7468 6174 206e ble rules.that n │ │ │ │ │ -00016da0: 6565 6420 6578 6f74 6963 2074 6f6f 6c73 eed exotic tools │ │ │ │ │ -00016db0: 2074 6861 7420 7573 6572 7320 6d61 7920 that users may │ │ │ │ │ -00016dc0: 6e6f 7420 6861 7665 2061 7661 696c 6162 not have availab │ │ │ │ │ -00016dd0: 6c65 2e0a 0a20 2020 5365 7665 7261 6c20 le... Several │ │ │ │ │ -00016de0: 7965 6172 7320 6167 6f20 4672 616e c3a7 years ago Fran.. │ │ │ │ │ -00016df0: 6f69 7320 5069 6e61 7264 2070 6f69 6e74 ois Pinard point │ │ │ │ │ -00016e00: 6564 206f 7574 2073 6576 6572 616c 2061 ed out several a │ │ │ │ │ -00016e10: 7267 756d 656e 7473 0a61 6761 696e 7374 rguments.against │ │ │ │ │ -00016e20: 2074 6869 7320 2741 4d5f 4d41 494e 5441 this 'AM_MAINTA │ │ │ │ │ -00016e30: 494e 4552 5f4d 4f44 4527 206d 6163 726f INER_MODE' macro │ │ │ │ │ -00016e40: 2e20 204d 6f73 7420 6f66 2074 6865 6d20 . Most of them │ │ │ │ │ -00016e50: 7265 6c61 7465 2074 6f0a 696e 7365 6375 relate to.insecu │ │ │ │ │ -00016e60: 7269 7479 2e20 2042 7920 7265 6d6f 7669 rity. By removi │ │ │ │ │ -00016e70: 6e67 2064 6570 656e 6465 6e63 6965 7320 ng dependencies │ │ │ │ │ -00016e80: 796f 7520 6765 7420 6e6f 6e2d 6465 7065 you get non-depe │ │ │ │ │ -00016e90: 6e64 6162 6c65 2062 7569 6c64 733a 0a63 ndable builds:.c │ │ │ │ │ -00016ea0: 6861 6e67 6573 2074 6f20 736f 7572 6365 hanges to source │ │ │ │ │ -00016eb0: 7320 6669 6c65 7320 6361 6e20 6861 7665 s files can have │ │ │ │ │ -00016ec0: 206e 6f20 6566 6665 6374 206f 6e20 6765 no effect on ge │ │ │ │ │ -00016ed0: 6e65 7261 7465 6420 6669 6c65 7320 616e nerated files an │ │ │ │ │ -00016ee0: 6420 7468 6973 0a63 616e 2062 6520 7665 d this.can be ve │ │ │ │ │ -00016ef0: 7279 2063 6f6e 6675 7369 6e67 2077 6865 ry confusing whe │ │ │ │ │ -00016f00: 6e20 756e 6e6f 7469 6365 642e 2020 4865 n unnoticed. He │ │ │ │ │ -00016f10: 2061 6464 7320 7468 6174 2073 6563 7572 adds that secur │ │ │ │ │ -00016f20: 6974 7920 7368 6f75 6c64 6e27 740a 6265 ity shouldn't.be │ │ │ │ │ -00016f30: 2072 6573 6572 7665 6420 746f 206d 6169 reserved to mai │ │ │ │ │ -00016f40: 6e74 6169 6e65 7273 2028 7768 6174 2027 ntainers (what ' │ │ │ │ │ -00016f50: 2d2d 656e 6162 6c65 2d6d 6169 6e74 6169 --enable-maintai │ │ │ │ │ -00016f60: 6e65 722d 6d6f 6465 2720 7375 6767 6573 ner-mode' sugges │ │ │ │ │ -00016f70: 7473 292c 0a6f 6e20 7468 6520 636f 6e74 ts),.on the cont │ │ │ │ │ -00016f80: 7261 7279 2e20 2049 6620 6f6e 6520 7573 rary. If one us │ │ │ │ │ -00016f90: 6572 2068 6173 2074 6f20 6d6f 6469 6679 er has to modify │ │ │ │ │ -00016fa0: 2061 2027 4d61 6b65 6669 6c65 2e61 6d27 a 'Makefile.am' │ │ │ │ │ -00016fb0: 2c20 7468 656e 2065 6974 6865 720a 274d , then either.'M │ │ │ │ │ -00016fc0: 616b 6566 696c 652e 696e 2720 7368 6f75 akefile.in' shou │ │ │ │ │ -00016fd0: 6c64 2062 6520 7570 6461 7465 6420 6f72 ld be updated or │ │ │ │ │ -00016fe0: 2061 2077 6172 6e69 6e67 2073 686f 756c a warning shoul │ │ │ │ │ -00016ff0: 6420 6265 206f 7574 7075 7420 2874 6869 d be output (thi │ │ │ │ │ -00017000: 7320 6973 0a77 6861 7420 4175 746f 6d61 s is.what Automa │ │ │ │ │ -00017010: 6b65 2075 7365 7320 276d 6973 7369 6e67 ke uses 'missing │ │ │ │ │ -00017020: 2720 666f 7229 2062 7574 2074 6865 206c ' for) but the l │ │ │ │ │ -00017030: 6173 7420 7468 696e 6720 796f 7520 7761 ast thing you wa │ │ │ │ │ -00017040: 6e74 2069 7320 7468 6174 0a6e 6f74 6869 nt is that.nothi │ │ │ │ │ -00017050: 6e67 2068 6170 7065 6e73 2061 6e64 2074 ng happens and t │ │ │ │ │ -00017060: 6865 2075 7365 7220 646f 6573 6e27 7420 he user doesn't │ │ │ │ │ -00017070: 6e6f 7469 6365 2069 7420 2874 6869 7320 notice it (this │ │ │ │ │ -00017080: 6973 2077 6861 7420 6861 7070 656e 730a is what happens. │ │ │ │ │ -00017090: 7768 656e 2072 6562 7569 6c64 2072 756c when rebuild rul │ │ │ │ │ -000170a0: 6573 2061 7265 2064 6973 6162 6c65 6420 es are disabled │ │ │ │ │ -000170b0: 6279 2027 414d 5f4d 4149 4e54 4149 4e45 by 'AM_MAINTAINE │ │ │ │ │ -000170c0: 525f 4d4f 4445 2729 2e0a 0a20 2020 4a69 R_MODE')... Ji │ │ │ │ │ -000170d0: 6d20 4d65 7965 7269 6e67 2c20 7468 6520 m Meyering, the │ │ │ │ │ -000170e0: 696e 7665 6e74 6f72 206f 6620 7468 6520 inventor of the │ │ │ │ │ -000170f0: 2741 4d5f 4d41 494e 5441 494e 4552 5f4d 'AM_MAINTAINER_M │ │ │ │ │ -00017100: 4f44 4527 206d 6163 726f 2077 6173 0a73 ODE' macro was.s │ │ │ │ │ -00017110: 7761 7965 6420 6279 2046 7261 6ec3 a76f wayed by Fran..o │ │ │ │ │ -00017120: 6973 2773 2061 7267 756d 656e 7473 2c20 is's arguments, │ │ │ │ │ -00017130: 616e 6420 676f 7420 7269 6420 6f66 2027 and got rid of ' │ │ │ │ │ -00017140: 414d 5f4d 4149 4e54 4149 4e45 525f 4d4f AM_MAINTAINER_MO │ │ │ │ │ -00017150: 4445 2720 696e 0a61 6c6c 206f 6620 6869 DE' in.all of hi │ │ │ │ │ -00017160: 7320 7061 636b 6167 6573 2e0a 0a20 2020 s packages... │ │ │ │ │ -00017170: 5374 696c 6c20 6d61 6e79 2070 656f 706c Still many peopl │ │ │ │ │ -00017180: 6520 636f 6e74 696e 7565 2074 6f20 7573 e continue to us │ │ │ │ │ -00017190: 6520 2741 4d5f 4d41 494e 5441 494e 4552 e 'AM_MAINTAINER │ │ │ │ │ -000171a0: 5f4d 4f44 4527 2c20 6265 6361 7573 6520 _MODE', because │ │ │ │ │ -000171b0: 6974 0a68 656c 7073 2074 6865 6d20 776f it.helps them wo │ │ │ │ │ -000171c0: 726b 696e 6720 6f6e 2070 726f 6a65 6374 rking on project │ │ │ │ │ -000171d0: 7320 7768 6572 6520 616c 6c20 6669 6c65 s where all file │ │ │ │ │ -000171e0: 7320 6172 6520 6b65 7074 2075 6e64 6572 s are kept under │ │ │ │ │ -000171f0: 2076 6572 7369 6f6e 0a63 6f6e 7472 6f6c version.control │ │ │ │ │ -00017200: 2c20 616e 6420 6265 6361 7573 6520 276d , and because 'm │ │ │ │ │ -00017210: 6973 7369 6e67 2720 6973 6e27 7420 656e issing' isn't en │ │ │ │ │ -00017220: 6f75 6768 2069 6620 796f 7520 6861 7665 ough if you have │ │ │ │ │ -00017230: 2074 6865 2077 726f 6e67 0a76 6572 7369 the wrong.versi │ │ │ │ │ -00017240: 6f6e 206f 6620 7468 6520 746f 6f6c 732e on of the tools. │ │ │ │ │ -00017250: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00017260: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00017270: 6f64 653a 2057 696c 6463 6172 6473 2c20 ode: Wildcards, │ │ │ │ │ -00017280: 204e 6578 743a 204c 696d 6974 6174 696f Next: Limitatio │ │ │ │ │ -00017290: 6e73 206f 6e20 4669 6c65 204e 616d 6573 ns on File Names │ │ │ │ │ -000172a0: 2c20 2050 7265 763a 206d 6169 6e74 6169 , Prev: maintai │ │ │ │ │ -000172b0: 6e65 722d 6d6f 6465 2c20 2055 703a 2046 ner-mode, Up: F │ │ │ │ │ -000172c0: 4151 0a0a 3238 2e33 2057 6879 2064 6f65 AQ..28.3 Why doe │ │ │ │ │ -000172d0: 736e 2774 2041 7574 6f6d 616b 6520 7375 sn't Automake su │ │ │ │ │ -000172e0: 7070 6f72 7420 7769 6c64 6361 7264 733f pport wildcards? │ │ │ │ │ -000172f0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +000163a0: 3d3d 3d0a 0a27 6d69 7373 696e 6727 0a2d ===..'missing'.- │ │ │ │ │ +000163b0: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 276d --------..The 'm │ │ │ │ │ +000163c0: 6973 7369 6e67 2720 7363 7269 7074 2069 issing' script i │ │ │ │ │ +000163d0: 7320 6120 7772 6170 7065 7220 6172 6f75 s a wrapper arou │ │ │ │ │ +000163e0: 6e64 2073 6576 6572 616c 206d 6169 6e74 nd several maint │ │ │ │ │ +000163f0: 6169 6e65 7220 746f 6f6c 732c 0a64 6573 ainer tools,.des │ │ │ │ │ +00016400: 6967 6e65 6420 746f 2077 6172 6e20 7573 igned to warn us │ │ │ │ │ +00016410: 6572 7320 6966 2061 206d 6169 6e74 6169 ers if a maintai │ │ │ │ │ +00016420: 6e65 7220 746f 6f6c 2069 7320 7265 7175 ner tool is requ │ │ │ │ │ +00016430: 6972 6564 2062 7574 206d 6973 7369 6e67 ired but missing │ │ │ │ │ +00016440: 2e0a 5479 7069 6361 6c20 6d61 696e 7461 ..Typical mainta │ │ │ │ │ +00016450: 696e 6572 2074 6f6f 6c73 2061 7265 2027 iner tools are ' │ │ │ │ │ +00016460: 6175 746f 636f 6e66 272c 2027 6175 746f autoconf', 'auto │ │ │ │ │ +00016470: 6d61 6b65 272c 2027 6269 736f 6e27 2c20 make', 'bison', │ │ │ │ │ +00016480: 6574 632e 0a42 6563 6175 7365 2066 696c etc..Because fil │ │ │ │ │ +00016490: 6520 6765 6e65 7261 7465 6420 6279 2074 e generated by t │ │ │ │ │ +000164a0: 6865 7365 2074 6f6f 6c73 2061 7265 2073 hese tools are s │ │ │ │ │ +000164b0: 6869 7070 6564 2077 6974 6820 7468 6520 hipped with the │ │ │ │ │ +000164c0: 6f74 6865 7220 736f 7572 6365 730a 6f66 other sources.of │ │ │ │ │ +000164d0: 2061 2070 6163 6b61 6765 2c20 7468 6573 a package, thes │ │ │ │ │ +000164e0: 6520 746f 6f6c 7320 7368 6f75 6c64 6e27 e tools shouldn' │ │ │ │ │ +000164f0: 7420 6265 2072 6571 7569 7265 6420 6475 t be required du │ │ │ │ │ +00016500: 7269 6e67 2061 2075 7365 7220 6275 696c ring a user buil │ │ │ │ │ +00016510: 6420 616e 640a 7468 6579 2061 7265 206e d and.they are n │ │ │ │ │ +00016520: 6f74 2063 6865 636b 6564 2066 6f72 2069 ot checked for i │ │ │ │ │ +00016530: 6e20 2763 6f6e 6669 6775 7265 272e 0a0a n 'configure'... │ │ │ │ │ +00016540: 2020 2048 6f77 6576 6572 2c20 6966 2066 However, if f │ │ │ │ │ +00016550: 6f72 2073 6f6d 6520 7265 6173 6f6e 2061 or some reason a │ │ │ │ │ +00016560: 2072 6562 7569 6c64 2072 756c 6520 6973 rebuild rule is │ │ │ │ │ +00016570: 2074 7269 6767 6572 6564 2061 6e64 2069 triggered and i │ │ │ │ │ +00016580: 6e76 6f6c 7665 730a 6120 6d69 7373 696e nvolves.a missin │ │ │ │ │ +00016590: 6720 746f 6f6c 2c20 276d 6973 7369 6e67 g tool, 'missing │ │ │ │ │ +000165a0: 2720 7769 6c6c 206e 6f74 6963 6520 6974 ' will notice it │ │ │ │ │ +000165b0: 2061 6e64 2077 6172 6e20 7468 6520 7573 and warn the us │ │ │ │ │ +000165c0: 6572 2e20 2042 6573 6964 6573 2074 6865 er. Besides the │ │ │ │ │ +000165d0: 0a77 6172 6e69 6e67 2c20 7768 656e 2061 .warning, when a │ │ │ │ │ +000165e0: 2074 6f6f 6c20 6973 206d 6973 7369 6e67 tool is missing │ │ │ │ │ +000165f0: 2c20 276d 6973 7369 6e67 2720 7769 6c6c , 'missing' will │ │ │ │ │ +00016600: 2061 7474 656d 7074 2074 6f20 6669 780a attempt to fix. │ │ │ │ │ +00016610: 7469 6d65 7374 616d 7073 2069 6e20 6120 timestamps in a │ │ │ │ │ +00016620: 7761 7920 7468 6174 2061 6c6c 6f77 7320 way that allows │ │ │ │ │ +00016630: 7468 6520 6275 696c 6420 746f 2063 6f6e the build to con │ │ │ │ │ +00016640: 7469 6e75 652e 2020 466f 7220 696e 7374 tinue. For inst │ │ │ │ │ +00016650: 616e 6365 2c0a 276d 6973 7369 6e67 2720 ance,.'missing' │ │ │ │ │ +00016660: 7769 6c6c 2074 6f75 6368 2027 636f 6e66 will touch 'conf │ │ │ │ │ +00016670: 6967 7572 6527 2069 6620 2761 7574 6f63 igure' if 'autoc │ │ │ │ │ +00016680: 6f6e 6627 2069 7320 6e6f 7420 696e 7374 onf' is not inst │ │ │ │ │ +00016690: 616c 6c65 642e 2020 5768 656e 0a61 6c6c alled. When.all │ │ │ │ │ +000166a0: 2064 6973 7472 6962 7574 6564 2066 696c distributed fil │ │ │ │ │ +000166b0: 6573 2061 7265 206b 6570 7420 756e 6465 es are kept unde │ │ │ │ │ +000166c0: 7220 7665 7273 696f 6e20 636f 6e74 726f r version contro │ │ │ │ │ +000166d0: 6c2c 2074 6869 7320 6665 6174 7572 6520 l, this feature │ │ │ │ │ +000166e0: 6f66 0a27 6d69 7373 696e 6727 2061 6c6c of.'missing' all │ │ │ │ │ +000166f0: 6f77 7320 6120 7573 6572 205f 7769 7468 ows a user _with │ │ │ │ │ +00016700: 206e 6f20 6d61 696e 7461 696e 6572 2074 no maintainer t │ │ │ │ │ +00016710: 6f6f 6c73 5f20 746f 2062 7569 6c64 2061 ools_ to build a │ │ │ │ │ +00016720: 2070 6163 6b61 6765 0a6f 6666 2069 7473 package.off its │ │ │ │ │ +00016730: 2076 6572 7369 6f6e 2063 6f6e 7472 6f6c version control │ │ │ │ │ +00016740: 2072 6570 6f73 6974 6f72 792c 2062 7970 repository, byp │ │ │ │ │ +00016750: 6173 7369 6e67 2061 6e79 2074 696d 6573 assing any times │ │ │ │ │ +00016760: 7461 6d70 0a69 6e63 6f6e 7369 7374 656e tamp.inconsisten │ │ │ │ │ +00016770: 6379 2028 696d 706c 6965 6420 6279 2065 cy (implied by e │ │ │ │ │ +00016780: 2e67 2e20 2763 7673 2075 7064 6174 6527 .g. 'cvs update' │ │ │ │ │ +00016790: 206f 7220 2767 6974 2063 6c6f 6e65 2729 or 'git clone') │ │ │ │ │ +000167a0: 2e0a 0a20 2020 4966 2074 6865 2072 6571 ... If the req │ │ │ │ │ +000167b0: 7569 7265 6420 746f 6f6c 2069 7320 696e uired tool is in │ │ │ │ │ +000167c0: 7374 616c 6c65 642c 2027 6d69 7373 696e stalled, 'missin │ │ │ │ │ +000167d0: 6727 2077 696c 6c20 7275 6e20 6974 2061 g' will run it a │ │ │ │ │ +000167e0: 6e64 2077 6f6e 2774 0a61 7474 656d 7074 nd won't.attempt │ │ │ │ │ +000167f0: 2074 6f20 636f 6e74 696e 7565 2061 6674 to continue aft │ │ │ │ │ +00016800: 6572 2066 6169 6c75 7265 732e 2020 5468 er failures. Th │ │ │ │ │ +00016810: 6973 2069 7320 636f 7272 6563 7420 6475 is is correct du │ │ │ │ │ +00016820: 7269 6e67 2064 6576 656c 6f70 6d65 6e74 ring development │ │ │ │ │ +00016830: 3a0a 6465 7665 6c6f 7065 7273 206c 6f76 :.developers lov │ │ │ │ │ +00016840: 6520 6669 7869 6e67 2066 6169 6c75 7265 e fixing failure │ │ │ │ │ +00016850: 732e 2020 486f 7765 7665 722c 2075 7365 s. However, use │ │ │ │ │ +00016860: 7273 2077 6974 6820 7772 6f6e 6720 7665 rs with wrong ve │ │ │ │ │ +00016870: 7273 696f 6e73 206f 660a 6d61 696e 7461 rsions of.mainta │ │ │ │ │ +00016880: 696e 6572 2074 6f6f 6c73 206d 6179 2067 iner tools may g │ │ │ │ │ +00016890: 6574 2061 6e20 6572 726f 7220 7768 656e et an error when │ │ │ │ │ +000168a0: 2074 6865 2072 6562 7569 6c64 2072 756c the rebuild rul │ │ │ │ │ +000168b0: 6520 6973 2073 7075 7269 6f75 736c 790a e is spuriously. │ │ │ │ │ +000168c0: 7472 6967 6765 7265 642c 2068 616c 7469 triggered, halti │ │ │ │ │ +000168d0: 6e67 2074 6865 2062 7569 6c64 2e20 2054 ng the build. T │ │ │ │ │ +000168e0: 6869 7320 6661 696c 7572 6520 746f 206c his failure to l │ │ │ │ │ +000168f0: 6574 2074 6865 2062 7569 6c64 2063 6f6e et the build con │ │ │ │ │ +00016900: 7469 6e75 6520 6973 0a6f 6e65 206f 6620 tinue is.one of │ │ │ │ │ +00016910: 7468 6520 6172 6775 6d65 6e74 7320 6f66 the arguments of │ │ │ │ │ +00016920: 2074 6865 2027 414d 5f4d 4149 4e54 4149 the 'AM_MAINTAI │ │ │ │ │ +00016930: 4e45 525f 4d4f 4445 2720 6164 766f 6361 NER_MODE' advoca │ │ │ │ │ +00016940: 7465 732e 0a0a 2741 4d5f 4d41 494e 5441 tes...'AM_MAINTA │ │ │ │ │ +00016950: 494e 4552 5f4d 4f44 4527 0a2d 2d2d 2d2d INER_MODE'.----- │ │ │ │ │ +00016960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00016970: 0a27 414d 5f4d 4149 4e54 4149 4e45 525f .'AM_MAINTAINER_ │ │ │ │ │ +00016980: 4d4f 4445 2720 616c 6c6f 7773 2079 6f75 MODE' allows you │ │ │ │ │ +00016990: 2074 6f20 6368 6f6f 7365 2077 6865 7468 to choose wheth │ │ │ │ │ +000169a0: 6572 2074 6865 2073 6f20 6361 6c6c 6564 er the so called │ │ │ │ │ +000169b0: 2022 7265 6275 696c 640a 7275 6c65 7322 "rebuild.rules" │ │ │ │ │ +000169c0: 2073 686f 756c 6420 6265 2065 6e61 626c should be enabl │ │ │ │ │ +000169d0: 6564 206f 7220 6469 7361 626c 6564 2e20 ed or disabled. │ │ │ │ │ +000169e0: 2057 6974 680a 2741 4d5f 4d41 494e 5441 With.'AM_MAINTA │ │ │ │ │ +000169f0: 494e 4552 5f4d 4f44 4528 5b65 6e61 626c INER_MODE([enabl │ │ │ │ │ +00016a00: 655d 2927 2c20 7468 6579 2061 7265 2065 e])', they are e │ │ │ │ │ +00016a10: 6e61 626c 6564 2062 7920 6465 6661 756c nabled by defaul │ │ │ │ │ +00016a20: 742c 206f 7468 6572 7769 7365 0a74 6865 t, otherwise.the │ │ │ │ │ +00016a30: 7920 6172 6520 6469 7361 626c 6564 2062 y are disabled b │ │ │ │ │ +00016a40: 7920 6465 6661 756c 742e 2020 496e 2074 y default. In t │ │ │ │ │ +00016a50: 6865 206c 6174 7465 7220 6361 7365 2c20 he latter case, │ │ │ │ │ +00016a60: 6966 2079 6f75 2068 6176 650a 2741 4d5f if you have.'AM_ │ │ │ │ │ +00016a70: 4d41 494e 5441 494e 4552 5f4d 4f44 4527 MAINTAINER_MODE' │ │ │ │ │ +00016a80: 2069 6e20 2763 6f6e 6669 6775 7265 2e61 in 'configure.a │ │ │ │ │ +00016a90: 6327 2c20 616e 6420 7275 6e20 272e 2f63 c', and run './c │ │ │ │ │ +00016aa0: 6f6e 6669 6775 7265 2026 2620 6d61 6b65 onfigure && make │ │ │ │ │ +00016ab0: 272c 0a74 6865 6e20 276d 616b 6527 2077 ',.then 'make' w │ │ │ │ │ +00016ac0: 696c 6c20 2a6e 6576 6572 2a20 6174 7465 ill *never* atte │ │ │ │ │ +00016ad0: 6d70 7420 746f 2072 6562 7569 6c64 2027 mpt to rebuild ' │ │ │ │ │ +00016ae0: 636f 6e66 6967 7572 6527 2c20 274d 616b configure', 'Mak │ │ │ │ │ +00016af0: 6566 696c 652e 696e 2773 2c0a 4c65 7820 efile.in's,.Lex │ │ │ │ │ +00016b00: 6f72 2059 6163 6320 6f75 7470 7574 732c or Yacc outputs, │ │ │ │ │ +00016b10: 2065 7463 2e20 2049 2e65 2e2c 2074 6869 etc. I.e., thi │ │ │ │ │ +00016b20: 7320 6469 7361 626c 6573 2062 7569 6c64 s disables build │ │ │ │ │ +00016b30: 2072 756c 6573 2066 6f72 2066 696c 6573 rules for files │ │ │ │ │ +00016b40: 0a74 6861 7420 6172 6520 7573 7561 6c6c .that are usuall │ │ │ │ │ +00016b50: 7920 6469 7374 7269 6275 7465 6420 616e y distributed an │ │ │ │ │ +00016b60: 6420 7468 6174 2075 7365 7273 2073 686f d that users sho │ │ │ │ │ +00016b70: 756c 6420 6e6f 726d 616c 6c79 206e 6f74 uld normally not │ │ │ │ │ +00016b80: 2068 6176 6520 746f 0a75 7064 6174 652e have to.update. │ │ │ │ │ +00016b90: 0a0a 2020 2054 6865 2075 7365 7220 6361 .. The user ca │ │ │ │ │ +00016ba0: 6e20 6f76 6572 7269 6465 2074 6865 2064 n override the d │ │ │ │ │ +00016bb0: 6566 6175 6c74 2073 6574 7469 6e67 2062 efault setting b │ │ │ │ │ +00016bc0: 7920 7061 7373 696e 6720 6569 7468 6572 y passing either │ │ │ │ │ +00016bd0: 0a27 2d2d 656e 6162 6c65 2d6d 6169 6e74 .'--enable-maint │ │ │ │ │ +00016be0: 6169 6e65 722d 6d6f 6465 2720 6f72 2027 ainer-mode' or ' │ │ │ │ │ +00016bf0: 2d2d 6469 7361 626c 652d 6d61 696e 7461 --disable-mainta │ │ │ │ │ +00016c00: 696e 6572 2d6d 6f64 6527 2074 6f0a 2763 iner-mode' to.'c │ │ │ │ │ +00016c10: 6f6e 6669 6775 7265 272e 0a0a 2020 2050 onfigure'... P │ │ │ │ │ +00016c20: 656f 706c 6520 7573 6520 2741 4d5f 4d41 eople use 'AM_MA │ │ │ │ │ +00016c30: 494e 5441 494e 4552 5f4d 4f44 4527 2065 INTAINER_MODE' e │ │ │ │ │ +00016c40: 6974 6865 7220 6265 6361 7573 6520 7468 ither because th │ │ │ │ │ +00016c50: 6579 2064 6f20 6e6f 7420 7761 6e74 2074 ey do not want t │ │ │ │ │ +00016c60: 6865 6972 0a75 7365 7273 2028 6f72 2074 heir.users (or t │ │ │ │ │ +00016c70: 6865 6d73 656c 7665 7329 2061 6e6e 6f79 hemselves) annoy │ │ │ │ │ +00016c80: 6564 2062 7920 7469 6d65 7374 616d 7073 ed by timestamps │ │ │ │ │ +00016c90: 206c 6f73 7361 6765 2028 2a6e 6f74 6520 lossage (*note │ │ │ │ │ +00016ca0: 4356 533a 3a29 2c20 6f72 0a62 6563 6175 CVS::), or.becau │ │ │ │ │ +00016cb0: 7365 2074 6865 7920 7369 6d70 6c79 2063 se they simply c │ │ │ │ │ +00016cc0: 616e 2774 2073 7461 6e64 2074 6865 2072 an't stand the r │ │ │ │ │ +00016cd0: 6562 7569 6c64 2072 756c 6573 2061 6e64 ebuild rules and │ │ │ │ │ +00016ce0: 2070 7265 6665 7220 7275 6e6e 696e 670a prefer running. │ │ │ │ │ +00016cf0: 6d61 696e 7461 696e 6572 2074 6f6f 6c73 maintainer tools │ │ │ │ │ +00016d00: 2065 7870 6c69 6369 746c 792e 0a0a 2020 explicitly... │ │ │ │ │ +00016d10: 2027 414d 5f4d 4149 4e54 4149 4e45 525f 'AM_MAINTAINER_ │ │ │ │ │ +00016d20: 4d4f 4445 2720 616c 736f 2061 6c6c 6f77 MODE' also allow │ │ │ │ │ +00016d30: 7320 796f 7520 746f 2064 6973 6162 6c65 s you to disable │ │ │ │ │ +00016d40: 2073 6f6d 6520 6375 7374 6f6d 2062 7569 some custom bui │ │ │ │ │ +00016d50: 6c64 0a72 756c 6573 2063 6f6e 6469 7469 ld.rules conditi │ │ │ │ │ +00016d60: 6f6e 616c 6c79 2e20 2053 6f6d 6520 6465 onally. Some de │ │ │ │ │ +00016d70: 7665 6c6f 7065 7273 2075 7365 2074 6869 velopers use thi │ │ │ │ │ +00016d80: 7320 6665 6174 7572 6520 746f 2064 6973 s feature to dis │ │ │ │ │ +00016d90: 6162 6c65 2072 756c 6573 0a74 6861 7420 able rules.that │ │ │ │ │ +00016da0: 6e65 6564 2065 786f 7469 6320 746f 6f6c need exotic tool │ │ │ │ │ +00016db0: 7320 7468 6174 2075 7365 7273 206d 6179 s that users may │ │ │ │ │ +00016dc0: 206e 6f74 2068 6176 6520 6176 6169 6c61 not have availa │ │ │ │ │ +00016dd0: 626c 652e 0a0a 2020 2053 6576 6572 616c ble... Several │ │ │ │ │ +00016de0: 2079 6561 7273 2061 676f 2046 7261 6ec3 years ago Fran. │ │ │ │ │ +00016df0: a76f 6973 2050 696e 6172 6420 706f 696e .ois Pinard poin │ │ │ │ │ +00016e00: 7465 6420 6f75 7420 7365 7665 7261 6c20 ted out several │ │ │ │ │ +00016e10: 6172 6775 6d65 6e74 730a 6167 6169 6e73 arguments.agains │ │ │ │ │ +00016e20: 7420 7468 6973 2027 414d 5f4d 4149 4e54 t this 'AM_MAINT │ │ │ │ │ +00016e30: 4149 4e45 525f 4d4f 4445 2720 6d61 6372 AINER_MODE' macr │ │ │ │ │ +00016e40: 6f2e 2020 4d6f 7374 206f 6620 7468 656d o. Most of them │ │ │ │ │ +00016e50: 2072 656c 6174 6520 746f 0a69 6e73 6563 relate to.insec │ │ │ │ │ +00016e60: 7572 6974 792e 2020 4279 2072 656d 6f76 urity. By remov │ │ │ │ │ +00016e70: 696e 6720 6465 7065 6e64 656e 6369 6573 ing dependencies │ │ │ │ │ +00016e80: 2079 6f75 2067 6574 206e 6f6e 2d64 6570 you get non-dep │ │ │ │ │ +00016e90: 656e 6461 626c 6520 6275 696c 6473 3a0a endable builds:. │ │ │ │ │ +00016ea0: 6368 616e 6765 7320 746f 2073 6f75 7263 changes to sourc │ │ │ │ │ +00016eb0: 6573 2066 696c 6573 2063 616e 2068 6176 es files can hav │ │ │ │ │ +00016ec0: 6520 6e6f 2065 6666 6563 7420 6f6e 2067 e no effect on g │ │ │ │ │ +00016ed0: 656e 6572 6174 6564 2066 696c 6573 2061 enerated files a │ │ │ │ │ +00016ee0: 6e64 2074 6869 730a 6361 6e20 6265 2076 nd this.can be v │ │ │ │ │ +00016ef0: 6572 7920 636f 6e66 7573 696e 6720 7768 ery confusing wh │ │ │ │ │ +00016f00: 656e 2075 6e6e 6f74 6963 6564 2e20 2048 en unnoticed. H │ │ │ │ │ +00016f10: 6520 6164 6473 2074 6861 7420 7365 6375 e adds that secu │ │ │ │ │ +00016f20: 7269 7479 2073 686f 756c 646e 2774 0a62 rity shouldn't.b │ │ │ │ │ +00016f30: 6520 7265 7365 7276 6564 2074 6f20 6d61 e reserved to ma │ │ │ │ │ +00016f40: 696e 7461 696e 6572 7320 2877 6861 7420 intainers (what │ │ │ │ │ +00016f50: 272d 2d65 6e61 626c 652d 6d61 696e 7461 '--enable-mainta │ │ │ │ │ +00016f60: 696e 6572 2d6d 6f64 6527 2073 7567 6765 iner-mode' sugge │ │ │ │ │ +00016f70: 7374 7329 2c0a 6f6e 2074 6865 2063 6f6e sts),.on the con │ │ │ │ │ +00016f80: 7472 6172 792e 2020 4966 206f 6e65 2075 trary. If one u │ │ │ │ │ +00016f90: 7365 7220 6861 7320 746f 206d 6f64 6966 ser has to modif │ │ │ │ │ +00016fa0: 7920 6120 274d 616b 6566 696c 652e 616d y a 'Makefile.am │ │ │ │ │ +00016fb0: 272c 2074 6865 6e20 6569 7468 6572 0a27 ', then either.' │ │ │ │ │ +00016fc0: 4d61 6b65 6669 6c65 2e69 6e27 2073 686f Makefile.in' sho │ │ │ │ │ +00016fd0: 756c 6420 6265 2075 7064 6174 6564 206f uld be updated o │ │ │ │ │ +00016fe0: 7220 6120 7761 726e 696e 6720 7368 6f75 r a warning shou │ │ │ │ │ +00016ff0: 6c64 2062 6520 6f75 7470 7574 2028 7468 ld be output (th │ │ │ │ │ +00017000: 6973 2069 730a 7768 6174 2041 7574 6f6d is is.what Autom │ │ │ │ │ +00017010: 616b 6520 7573 6573 2027 6d69 7373 696e ake uses 'missin │ │ │ │ │ +00017020: 6727 2066 6f72 2920 6275 7420 7468 6520 g' for) but the │ │ │ │ │ +00017030: 6c61 7374 2074 6869 6e67 2079 6f75 2077 last thing you w │ │ │ │ │ +00017040: 616e 7420 6973 2074 6861 740a 6e6f 7468 ant is that.noth │ │ │ │ │ +00017050: 696e 6720 6861 7070 656e 7320 616e 6420 ing happens and │ │ │ │ │ +00017060: 7468 6520 7573 6572 2064 6f65 736e 2774 the user doesn't │ │ │ │ │ +00017070: 206e 6f74 6963 6520 6974 2028 7468 6973 notice it (this │ │ │ │ │ +00017080: 2069 7320 7768 6174 2068 6170 7065 6e73 is what happens │ │ │ │ │ +00017090: 0a77 6865 6e20 7265 6275 696c 6420 7275 .when rebuild ru │ │ │ │ │ +000170a0: 6c65 7320 6172 6520 6469 7361 626c 6564 les are disabled │ │ │ │ │ +000170b0: 2062 7920 2741 4d5f 4d41 494e 5441 494e by 'AM_MAINTAIN │ │ │ │ │ +000170c0: 4552 5f4d 4f44 4527 292e 0a0a 2020 204a ER_MODE')... J │ │ │ │ │ +000170d0: 696d 204d 6579 6572 696e 672c 2074 6865 im Meyering, the │ │ │ │ │ +000170e0: 2069 6e76 656e 746f 7220 6f66 2074 6865 inventor of the │ │ │ │ │ +000170f0: 2027 414d 5f4d 4149 4e54 4149 4e45 525f 'AM_MAINTAINER_ │ │ │ │ │ +00017100: 4d4f 4445 2720 6d61 6372 6f20 7761 730a MODE' macro was. │ │ │ │ │ +00017110: 7377 6179 6564 2062 7920 4672 616e c3a7 swayed by Fran.. │ │ │ │ │ +00017120: 6f69 7327 7320 6172 6775 6d65 6e74 732c ois's arguments, │ │ │ │ │ +00017130: 2061 6e64 2067 6f74 2072 6964 206f 6620 and got rid of │ │ │ │ │ +00017140: 2741 4d5f 4d41 494e 5441 494e 4552 5f4d 'AM_MAINTAINER_M │ │ │ │ │ +00017150: 4f44 4527 2069 6e0a 616c 6c20 6f66 2068 ODE' in.all of h │ │ │ │ │ +00017160: 6973 2070 6163 6b61 6765 732e 0a0a 2020 is packages... │ │ │ │ │ +00017170: 2053 7469 6c6c 206d 616e 7920 7065 6f70 Still many peop │ │ │ │ │ +00017180: 6c65 2063 6f6e 7469 6e75 6520 746f 2075 le continue to u │ │ │ │ │ +00017190: 7365 2027 414d 5f4d 4149 4e54 4149 4e45 se 'AM_MAINTAINE │ │ │ │ │ +000171a0: 525f 4d4f 4445 272c 2062 6563 6175 7365 R_MODE', because │ │ │ │ │ +000171b0: 2069 740a 6865 6c70 7320 7468 656d 2077 it.helps them w │ │ │ │ │ +000171c0: 6f72 6b69 6e67 206f 6e20 7072 6f6a 6563 orking on projec │ │ │ │ │ +000171d0: 7473 2077 6865 7265 2061 6c6c 2066 696c ts where all fil │ │ │ │ │ +000171e0: 6573 2061 7265 206b 6570 7420 756e 6465 es are kept unde │ │ │ │ │ +000171f0: 7220 7665 7273 696f 6e0a 636f 6e74 726f r version.contro │ │ │ │ │ +00017200: 6c2c 2061 6e64 2062 6563 6175 7365 2027 l, and because ' │ │ │ │ │ +00017210: 6d69 7373 696e 6727 2069 736e 2774 2065 missing' isn't e │ │ │ │ │ +00017220: 6e6f 7567 6820 6966 2079 6f75 2068 6176 nough if you hav │ │ │ │ │ +00017230: 6520 7468 6520 7772 6f6e 670a 7665 7273 e the wrong.vers │ │ │ │ │ +00017240: 696f 6e20 6f66 2074 6865 2074 6f6f 6c73 ion of the tools │ │ │ │ │ +00017250: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +00017260: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +00017270: 4e6f 6465 3a20 5769 6c64 6361 7264 732c Node: Wildcards, │ │ │ │ │ +00017280: 2020 4e65 7874 3a20 4c69 6d69 7461 7469 Next: Limitati │ │ │ │ │ +00017290: 6f6e 7320 6f6e 2046 696c 6520 4e61 6d65 ons on File Name │ │ │ │ │ +000172a0: 732c 2020 5072 6576 3a20 6d61 696e 7461 s, Prev: mainta │ │ │ │ │ +000172b0: 696e 6572 2d6d 6f64 652c 2020 5570 3a20 iner-mode, Up: │ │ │ │ │ +000172c0: 4641 510a 0a32 382e 3320 5768 7920 646f FAQ..28.3 Why do │ │ │ │ │ +000172d0: 6573 6e27 7420 4175 746f 6d61 6b65 2073 esn't Automake s │ │ │ │ │ +000172e0: 7570 706f 7274 2077 696c 6463 6172 6473 upport wildcards │ │ │ │ │ +000172f0: 3f0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ?.============== │ │ │ │ │ 00017300: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00017310: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a44 =============..D │ │ │ │ │ -00017320: 6576 656c 6f70 6572 7320 6172 6520 6c61 evelopers are la │ │ │ │ │ -00017330: 7a79 2e20 2054 6865 7920 776f 756c 6420 zy. They would │ │ │ │ │ -00017340: 6f66 7465 6e20 6c69 6b65 2074 6f20 7573 often like to us │ │ │ │ │ -00017350: 6520 7769 6c64 6361 7264 7320 696e 0a27 e wildcards in.' │ │ │ │ │ -00017360: 4d61 6b65 6669 6c65 2e61 6d27 732c 2073 Makefile.am's, s │ │ │ │ │ -00017370: 6f20 7468 6174 2074 6865 7920 776f 756c o that they woul │ │ │ │ │ -00017380: 6420 6e6f 7420 6e65 6564 2074 6f20 7265 d not need to re │ │ │ │ │ -00017390: 6d65 6d62 6572 2074 6f20 7570 6461 7465 member to update │ │ │ │ │ -000173a0: 0a27 4d61 6b65 6669 6c65 2e61 6d27 7320 .'Makefile.am's │ │ │ │ │ -000173b0: 6576 6572 7920 7469 6d65 2074 6865 7920 every time they │ │ │ │ │ -000173c0: 6164 642c 2064 656c 6574 652c 206f 7220 add, delete, or │ │ │ │ │ -000173d0: 7265 6e61 6d65 2061 2066 696c 652e 0a0a rename a file... │ │ │ │ │ -000173e0: 2020 2054 6865 7265 2061 7265 2073 6576 There are sev │ │ │ │ │ -000173f0: 6572 616c 206f 626a 6563 7469 6f6e 7320 eral objections │ │ │ │ │ -00017400: 746f 2074 6869 733a 0a20 2020 2a20 5768 to this:. * Wh │ │ │ │ │ -00017410: 656e 2075 7369 6e67 2043 5653 2028 6f72 en using CVS (or │ │ │ │ │ -00017420: 2073 696d 696c 6172 2920 6465 7665 6c6f similar) develo │ │ │ │ │ -00017430: 7065 7273 206e 6565 6420 746f 2072 656d pers need to rem │ │ │ │ │ -00017440: 656d 6265 7220 7468 6579 2068 6176 650a ember they have. │ │ │ │ │ -00017450: 2020 2020 2074 6f20 7275 6e20 2763 7673 to run 'cvs │ │ │ │ │ -00017460: 2061 6464 2720 6f72 2027 6376 7320 726d add' or 'cvs rm │ │ │ │ │ -00017470: 2720 616e 7977 6179 2e20 2055 7064 6174 ' anyway. Updat │ │ │ │ │ -00017480: 696e 6720 274d 616b 6566 696c 652e 616d ing 'Makefile.am │ │ │ │ │ -00017490: 270a 2020 2020 2061 6363 6f72 6469 6e67 '. according │ │ │ │ │ -000174a0: 6c79 2071 7569 636b 6c79 2062 6563 6f6d ly quickly becom │ │ │ │ │ -000174b0: 6573 2061 2072 6566 6c65 782e 0a0a 2020 es a reflex... │ │ │ │ │ -000174c0: 2020 2043 6f6e 7665 7273 656c 792c 2069 Conversely, i │ │ │ │ │ -000174d0: 6620 796f 7572 2061 7070 6c69 6361 7469 f your applicati │ │ │ │ │ -000174e0: 6f6e 2064 6f65 736e 2774 2063 6f6d 7069 on doesn't compi │ │ │ │ │ -000174f0: 6c65 2062 6563 6175 7365 2079 6f75 2066 le because you f │ │ │ │ │ -00017500: 6f72 676f 740a 2020 2020 2074 6f20 6164 orgot. to ad │ │ │ │ │ -00017510: 6420 6120 6669 6c65 2069 6e20 274d 616b d a file in 'Mak │ │ │ │ │ -00017520: 6566 696c 652e 616d 272c 2069 7420 7769 efile.am', it wi │ │ │ │ │ -00017530: 6c6c 2068 656c 7020 796f 7520 7265 6d65 ll help you reme │ │ │ │ │ -00017540: 6d62 6572 2074 6f20 2763 7673 0a20 2020 mber to 'cvs. │ │ │ │ │ -00017550: 2020 6164 6427 2069 742e 0a0a 2020 202a add' it... * │ │ │ │ │ -00017560: 2055 7369 6e67 2077 696c 6463 6172 6473 Using wildcards │ │ │ │ │ -00017570: 206d 616b 6573 2069 7420 6561 7379 2074 makes it easy t │ │ │ │ │ -00017580: 6f20 6469 7374 7269 6275 7465 2066 696c o distribute fil │ │ │ │ │ -00017590: 6573 2062 7920 6d69 7374 616b 652e 2020 es by mistake. │ │ │ │ │ -000175a0: 466f 720a 2020 2020 2069 6e73 7461 6e63 For. instanc │ │ │ │ │ -000175b0: 652c 2073 6f6d 6520 636f 6465 2061 2064 e, some code a d │ │ │ │ │ -000175c0: 6576 656c 6f70 6572 2069 7320 6578 7065 eveloper is expe │ │ │ │ │ -000175d0: 7269 6d65 6e74 696e 6720 7769 7468 2028 rimenting with ( │ │ │ │ │ -000175e0: 6120 7465 7374 2063 6173 652c 0a20 2020 a test case,. │ │ │ │ │ -000175f0: 2020 7361 7929 2074 6861 7420 7368 6f75 say) that shou │ │ │ │ │ -00017600: 6c64 206e 6f74 2062 6520 7061 7274 206f ld not be part o │ │ │ │ │ -00017610: 6620 7468 6520 6469 7374 7269 6275 7469 f the distributi │ │ │ │ │ -00017620: 6f6e 2e0a 0a20 2020 2a20 5573 696e 6720 on... * Using │ │ │ │ │ -00017630: 7769 6c64 6361 7264 7320 6974 2773 2065 wildcards it's e │ │ │ │ │ -00017640: 6173 7920 746f 206f 6d69 7420 736f 6d65 asy to omit some │ │ │ │ │ -00017650: 2066 696c 6573 2062 7920 6d69 7374 616b files by mistak │ │ │ │ │ -00017660: 652e 2020 466f 720a 2020 2020 2069 6e73 e. For. ins │ │ │ │ │ -00017670: 7461 6e63 652c 206f 6e65 2064 6576 656c tance, one devel │ │ │ │ │ -00017680: 6f70 6572 2063 7265 6174 6573 2061 206e oper creates a n │ │ │ │ │ -00017690: 6577 2066 696c 652c 2075 7365 7320 6974 ew file, uses it │ │ │ │ │ -000176a0: 2069 6e20 6d61 6e79 2070 6c61 6365 732c in many places, │ │ │ │ │ -000176b0: 0a20 2020 2020 6275 7420 666f 7267 6574 . but forget │ │ │ │ │ -000176c0: 7320 746f 2063 6f6d 6d69 7420 6974 2e20 s to commit it. │ │ │ │ │ -000176d0: 2041 6e6f 7468 6572 2064 6576 656c 6f70 Another develop │ │ │ │ │ -000176e0: 6572 2074 6865 6e20 6368 6563 6b73 206f er then checks o │ │ │ │ │ -000176f0: 7574 2074 6865 0a20 2020 2020 696e 636f ut the. inco │ │ │ │ │ -00017700: 6d70 6c65 7465 2070 726f 6a65 6374 2061 mplete project a │ │ │ │ │ -00017710: 6e64 2069 7320 6162 6c65 2074 6f20 7275 nd is able to ru │ │ │ │ │ -00017720: 6e20 276d 616b 6520 6469 7374 2720 7375 n 'make dist' su │ │ │ │ │ -00017730: 6363 6573 7366 756c 6c79 2c0a 2020 2020 ccessfully,. │ │ │ │ │ -00017740: 2065 7665 6e20 7468 6f75 6768 2061 2066 even though a f │ │ │ │ │ -00017750: 696c 6520 6973 206d 6973 7369 6e67 2e20 ile is missing. │ │ │ │ │ -00017760: 2042 7920 6c69 7374 696e 6720 6669 6c65 By listing file │ │ │ │ │ -00017770: 732c 2027 6d61 6b65 2064 6973 7427 0a20 s, 'make dist'. │ │ │ │ │ -00017780: 2020 2020 5f77 696c 6c5f 2063 6f6d 706c _will_ compl │ │ │ │ │ -00017790: 6169 6e2e 0a0a 2020 202a 2057 696c 6463 ain... * Wildc │ │ │ │ │ -000177a0: 6172 6473 2061 7265 206e 6f74 2070 6f72 ards are not por │ │ │ │ │ -000177b0: 7461 626c 6520 746f 2073 6f6d 6520 6e6f table to some no │ │ │ │ │ -000177c0: 6e2d 474e 5520 276d 616b 6527 2069 6d70 n-GNU 'make' imp │ │ │ │ │ -000177d0: 6c65 6d65 6e74 6174 696f 6e73 2c0a 2020 lementations,. │ │ │ │ │ -000177e0: 2020 2065 2e67 2e2c 204e 6574 4253 4420 e.g., NetBSD │ │ │ │ │ -000177f0: 276d 616b 6527 2077 696c 6c20 6e6f 7420 'make' will not │ │ │ │ │ -00017800: 6578 7061 6e64 2067 6c6f 6273 2073 7563 expand globs suc │ │ │ │ │ -00017810: 6820 6173 2027 2a27 2069 6e0a 2020 2020 h as '*' in. │ │ │ │ │ -00017820: 2070 7265 7265 7175 6973 6974 6573 206f prerequisites o │ │ │ │ │ -00017830: 6620 6120 7461 7267 6574 2e0a 0a20 2020 f a target... │ │ │ │ │ -00017840: 2a20 4669 6e61 6c6c 792c 2069 7427 7320 * Finally, it's │ │ │ │ │ -00017850: 7265 616c 6c79 2068 6172 6420 746f 205f really hard to _ │ │ │ │ │ -00017860: 666f 7267 6574 5f20 746f 2061 6464 2061 forget_ to add a │ │ │ │ │ -00017870: 2066 696c 6520 746f 0a20 2020 2020 274d file to. 'M │ │ │ │ │ -00017880: 616b 6566 696c 652e 616d 273a 2066 696c akefile.am': fil │ │ │ │ │ -00017890: 6573 2074 6861 7420 6172 6520 6e6f 7420 es that are not │ │ │ │ │ -000178a0: 6c69 7374 6564 2069 6e20 274d 616b 6566 listed in 'Makef │ │ │ │ │ -000178b0: 696c 652e 616d 2720 6172 6520 6e6f 740a ile.am' are not. │ │ │ │ │ -000178c0: 2020 2020 2063 6f6d 7069 6c65 6420 6f72 compiled or │ │ │ │ │ -000178d0: 2069 6e73 7461 6c6c 6564 2c20 736f 2079 installed, so y │ │ │ │ │ -000178e0: 6f75 2063 616e 2774 2065 7665 6e20 7465 ou can't even te │ │ │ │ │ -000178f0: 7374 2074 6865 6d2e 0a0a 2020 2053 7469 st them... Sti │ │ │ │ │ -00017900: 6c6c 2c20 7468 6573 6520 6172 6520 7068 ll, these are ph │ │ │ │ │ -00017910: 696c 6f73 6f70 6869 6361 6c20 6f62 6a65 ilosophical obje │ │ │ │ │ -00017920: 6374 696f 6e73 2c20 616e 6420 6173 2073 ctions, and as s │ │ │ │ │ -00017930: 7563 6820 796f 7520 6d61 790a 6469 7361 uch you may.disa │ │ │ │ │ -00017940: 6772 6565 2c20 6f72 2066 696e 6420 656e gree, or find en │ │ │ │ │ -00017950: 6f75 6768 2076 616c 7565 2069 6e20 7769 ough value in wi │ │ │ │ │ -00017960: 6c64 6361 7264 7320 746f 2064 6973 6d69 ldcards to dismi │ │ │ │ │ -00017970: 7373 2061 6c6c 206f 6620 7468 656d 2e0a ss all of them.. │ │ │ │ │ -00017980: 4265 666f 7265 2079 6f75 2073 7461 7274 Before you start │ │ │ │ │ -00017990: 2077 7269 7469 6e67 2061 2070 6174 6368 writing a patch │ │ │ │ │ -000179a0: 2061 6761 696e 7374 2041 7574 6f6d 616b against Automak │ │ │ │ │ -000179b0: 6520 746f 2074 6561 6368 2069 7420 6162 e to teach it ab │ │ │ │ │ -000179c0: 6f75 740a 7769 6c64 6361 7264 732c 206c out.wildcards, l │ │ │ │ │ -000179d0: 6574 2773 2073 6565 2074 6865 206d 6169 et's see the mai │ │ │ │ │ -000179e0: 6e20 7465 6368 6e69 6361 6c20 6973 7375 n technical issu │ │ │ │ │ -000179f0: 653a 2070 6f72 7461 6269 6c69 7479 2e0a e: portability.. │ │ │ │ │ -00017a00: 0a20 2020 416c 7468 6f75 6768 2027 2428 . Although '$( │ │ │ │ │ -00017a10: 7769 6c64 6361 7264 202e 2e2e 2927 2077 wildcard ...)' w │ │ │ │ │ -00017a20: 6f72 6b73 2077 6974 6820 474e 5520 276d orks with GNU 'm │ │ │ │ │ -00017a30: 616b 6527 2c20 6974 2069 7320 6e6f 7420 ake', it is not │ │ │ │ │ -00017a40: 706f 7274 6162 6c65 0a74 6f20 6f74 6865 portable.to othe │ │ │ │ │ -00017a50: 7220 276d 616b 6527 2069 6d70 6c65 6d65 r 'make' impleme │ │ │ │ │ -00017a60: 6e74 6174 696f 6e73 2e0a 0a20 2020 5468 ntations... Th │ │ │ │ │ -00017a70: 6520 6f6e 6c79 2077 6179 2041 7574 6f6d e only way Autom │ │ │ │ │ -00017a80: 616b 6520 636f 756c 6420 7375 7070 6f72 ake could suppor │ │ │ │ │ -00017a90: 7420 2724 2877 696c 6463 6172 6420 2e2e t '$(wildcard .. │ │ │ │ │ -00017aa0: 2e29 2720 6973 2062 7920 6578 7065 6e64 .)' is by expend │ │ │ │ │ -00017ab0: 696e 670a 2724 2877 696c 6463 6172 6420 ing.'$(wildcard │ │ │ │ │ -00017ac0: 2e2e 2e29 2720 7768 656e 2027 6175 746f ...)' when 'auto │ │ │ │ │ -00017ad0: 6d61 6b65 2720 6973 2072 756e 2e20 2054 make' is run. T │ │ │ │ │ -00017ae0: 6865 2072 6573 756c 7469 6e67 2027 4d61 he resulting 'Ma │ │ │ │ │ -00017af0: 6b65 6669 6c65 2e69 6e27 730a 776f 756c kefile.in's.woul │ │ │ │ │ -00017b00: 6420 6265 2070 6f72 7461 626c 6520 7369 d be portable si │ │ │ │ │ -00017b10: 6e63 6520 7468 6579 2077 6f75 6c64 206c nce they would l │ │ │ │ │ -00017b20: 6973 7420 616c 6c20 6669 6c65 7320 616e ist all files an │ │ │ │ │ -00017b30: 6420 6e6f 7420 7573 650a 2724 2877 696c d not use.'$(wil │ │ │ │ │ -00017b40: 6463 6172 6420 2e2e 2e29 272e 2020 486f dcard ...)'. Ho │ │ │ │ │ -00017b50: 7765 7665 7220 7468 6174 206d 6561 6e73 wever that means │ │ │ │ │ -00017b60: 2064 6576 656c 6f70 6572 7320 776f 756c developers woul │ │ │ │ │ -00017b70: 6420 6e65 6564 2074 6f20 7265 6d65 6d62 d need to rememb │ │ │ │ │ -00017b80: 6572 0a74 6f20 7275 6e20 2761 7574 6f6d er.to run 'autom │ │ │ │ │ -00017b90: 616b 6527 2065 6163 6820 7469 6d65 2074 ake' each time t │ │ │ │ │ -00017ba0: 6865 7920 6164 642c 2064 656c 6574 652c hey add, delete, │ │ │ │ │ -00017bb0: 206f 7220 7265 6e61 6d65 2066 696c 6573 or rename files │ │ │ │ │ -00017bc0: 2e0a 0a20 2020 436f 6d70 6172 6564 2074 ... Compared t │ │ │ │ │ -00017bd0: 6f20 6564 6974 696e 6720 274d 616b 6566 o editing 'Makef │ │ │ │ │ -00017be0: 696c 652e 616d 272c 2074 6869 7320 6973 ile.am', this is │ │ │ │ │ -00017bf0: 2061 2076 6572 7920 736d 616c 6c20 6761 a very small ga │ │ │ │ │ -00017c00: 696e 2e20 2053 7572 652c 0a69 7427 7320 in. Sure,.it's │ │ │ │ │ -00017c10: 6561 7369 6572 2061 6e64 2066 6173 7465 easier and faste │ │ │ │ │ -00017c20: 7220 746f 2074 7970 6520 2761 7574 6f6d r to type 'autom │ │ │ │ │ -00017c30: 616b 653b 206d 616b 6527 2074 6861 6e20 ake; make' than │ │ │ │ │ -00017c40: 746f 2074 7970 6520 2765 6d61 6373 0a4d to type 'emacs.M │ │ │ │ │ -00017c50: 616b 6566 696c 652e 616d 3b20 6d61 6b65 akefile.am; make │ │ │ │ │ -00017c60: 272e 2020 4275 7420 6e6f 626f 6479 2062 '. But nobody b │ │ │ │ │ -00017c70: 6f74 6865 7265 6420 656e 6f75 6768 2074 othered enough t │ │ │ │ │ -00017c80: 6f20 7772 6974 6520 6120 7061 7463 6820 o write a patch │ │ │ │ │ -00017c90: 746f 2061 6464 0a73 7570 706f 7274 2066 to add.support f │ │ │ │ │ -00017ca0: 6f72 2074 6869 7320 7379 6e74 6178 2e20 or this syntax. │ │ │ │ │ -00017cb0: 2053 6f6d 6520 7065 6f70 6c65 2075 7365 Some people use │ │ │ │ │ -00017cc0: 2073 6372 6970 7473 2074 6f20 6765 6e65 scripts to gene │ │ │ │ │ -00017cd0: 7261 7465 2066 696c 6520 6c69 7374 730a rate file lists. │ │ │ │ │ -00017ce0: 696e 2027 4d61 6b65 6669 6c65 2e61 6d27 in 'Makefile.am' │ │ │ │ │ -00017cf0: 206f 7220 696e 2073 6570 6172 6174 6520 or in separate │ │ │ │ │ -00017d00: 274d 616b 6566 696c 6527 2066 7261 676d 'Makefile' fragm │ │ │ │ │ -00017d10: 656e 7473 2e0a 0a20 2020 4576 656e 2069 ents... Even i │ │ │ │ │ -00017d20: 6620 796f 7520 646f 6e27 7420 6361 7265 f you don't care │ │ │ │ │ -00017d30: 2061 626f 7574 2070 6f72 7461 6269 6c69 about portabili │ │ │ │ │ -00017d40: 7479 2c20 616e 6420 6172 6520 7465 6d70 ty, and are temp │ │ │ │ │ -00017d50: 7465 6420 746f 2075 7365 0a27 2428 7769 ted to use.'$(wi │ │ │ │ │ -00017d60: 6c64 6361 7264 202e 2e2e 2927 2061 6e79 ldcard ...)' any │ │ │ │ │ -00017d70: 7761 7920 6265 6361 7573 6520 796f 7520 way because you │ │ │ │ │ -00017d80: 7461 7267 6574 206f 6e6c 7920 474e 5520 target only GNU │ │ │ │ │ -00017d90: 4d61 6b65 2c20 796f 7520 7368 6f75 6c64 Make, you should │ │ │ │ │ -00017da0: 0a6b 6e6f 7720 7468 6572 6520 6172 6520 .know there are │ │ │ │ │ -00017db0: 6d61 6e79 2070 6c61 6365 7320 7768 6572 many places wher │ │ │ │ │ -00017dc0: 6520 4175 746f 6d61 6b65 206e 6565 6473 e Automake needs │ │ │ │ │ -00017dd0: 2074 6f20 6b6e 6f77 2065 7861 6374 6c79 to know exactly │ │ │ │ │ -00017de0: 2077 6869 6368 0a66 696c 6573 2073 686f which.files sho │ │ │ │ │ -00017df0: 756c 6420 6265 2070 726f 6365 7373 6564 uld be processed │ │ │ │ │ -00017e00: 2e20 2041 7320 4175 746f 6d61 6b65 2064 . As Automake d │ │ │ │ │ -00017e10: 6f65 736e 2774 206b 6e6f 7720 686f 7720 oesn't know how │ │ │ │ │ -00017e20: 746f 2065 7870 616e 640a 2724 2877 696c to expand.'$(wil │ │ │ │ │ -00017e30: 6463 6172 6420 2e2e 2e29 272c 2079 6f75 dcard ...)', you │ │ │ │ │ -00017e40: 2063 616e 6e6f 7420 7573 6520 6974 2069 cannot use it i │ │ │ │ │ -00017e50: 6e20 7468 6573 6520 706c 6163 6573 2e20 n these places. │ │ │ │ │ -00017e60: 2027 2428 7769 6c64 6361 7264 202e 2e2e '$(wildcard ... │ │ │ │ │ -00017e70: 2927 0a69 7320 6120 626c 6163 6b20 626f )'.is a black bo │ │ │ │ │ -00017e80: 7820 636f 6d70 6172 6162 6c65 2074 6f20 x comparable to │ │ │ │ │ -00017e90: 2741 435f 5355 4253 5427 6564 2076 6172 'AC_SUBST'ed var │ │ │ │ │ -00017ea0: 6961 626c 6573 2061 7320 6661 7220 4175 iables as far Au │ │ │ │ │ -00017eb0: 746f 6d61 6b65 2069 730a 636f 6e63 6572 tomake is.concer │ │ │ │ │ -00017ec0: 6e65 642e 0a0a 2020 2059 6f75 2063 616e ned... You can │ │ │ │ │ -00017ed0: 2067 6574 2077 6172 6e69 6e67 7320 6162 get warnings ab │ │ │ │ │ -00017ee0: 6f75 7420 2724 2877 696c 6463 6172 6420 out '$(wildcard │ │ │ │ │ -00017ef0: 2e2e 2e27 2920 636f 6e73 7472 7563 7473 ...') constructs │ │ │ │ │ -00017f00: 2075 7369 6e67 2074 6865 0a27 2d57 706f using the.'-Wpo │ │ │ │ │ -00017f10: 7274 6162 696c 6974 7927 2066 6c61 672e rtability' flag. │ │ │ │ │ -00017f20: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -00017f30: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -00017f40: 6f64 653a 204c 696d 6974 6174 696f 6e73 ode: Limitations │ │ │ │ │ -00017f50: 206f 6e20 4669 6c65 204e 616d 6573 2c20 on File Names, │ │ │ │ │ -00017f60: 204e 6578 743a 2064 6973 7463 6c65 616e Next: distclean │ │ │ │ │ -00017f70: 6368 6563 6b2c 2020 5072 6576 3a20 5769 check, Prev: Wi │ │ │ │ │ -00017f80: 6c64 6361 7264 732c 2020 5570 3a20 4641 ldcards, Up: FA │ │ │ │ │ -00017f90: 510a 0a32 382e 3420 4c69 6d69 7461 7469 Q..28.4 Limitati │ │ │ │ │ -00017fa0: 6f6e 7320 6f6e 2046 696c 6520 4e61 6d65 ons on File Name │ │ │ │ │ -00017fb0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ +00017310: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +00017320: 4465 7665 6c6f 7065 7273 2061 7265 206c Developers are l │ │ │ │ │ +00017330: 617a 792e 2020 5468 6579 2077 6f75 6c64 azy. They would │ │ │ │ │ +00017340: 206f 6674 656e 206c 696b 6520 746f 2075 often like to u │ │ │ │ │ +00017350: 7365 2077 696c 6463 6172 6473 2069 6e0a se wildcards in. │ │ │ │ │ +00017360: 274d 616b 6566 696c 652e 616d 2773 2c20 'Makefile.am's, │ │ │ │ │ +00017370: 736f 2074 6861 7420 7468 6579 2077 6f75 so that they wou │ │ │ │ │ +00017380: 6c64 206e 6f74 206e 6565 6420 746f 2072 ld not need to r │ │ │ │ │ +00017390: 656d 656d 6265 7220 746f 2075 7064 6174 emember to updat │ │ │ │ │ +000173a0: 650a 274d 616b 6566 696c 652e 616d 2773 e.'Makefile.am's │ │ │ │ │ +000173b0: 2065 7665 7279 2074 696d 6520 7468 6579 every time they │ │ │ │ │ +000173c0: 2061 6464 2c20 6465 6c65 7465 2c20 6f72 add, delete, or │ │ │ │ │ +000173d0: 2072 656e 616d 6520 6120 6669 6c65 2e0a rename a file.. │ │ │ │ │ +000173e0: 0a20 2020 5468 6572 6520 6172 6520 7365 . There are se │ │ │ │ │ +000173f0: 7665 7261 6c20 6f62 6a65 6374 696f 6e73 veral objections │ │ │ │ │ +00017400: 2074 6f20 7468 6973 3a0a 2020 202a 2057 to this:. * W │ │ │ │ │ +00017410: 6865 6e20 7573 696e 6720 4356 5320 286f hen using CVS (o │ │ │ │ │ +00017420: 7220 7369 6d69 6c61 7229 2064 6576 656c r similar) devel │ │ │ │ │ +00017430: 6f70 6572 7320 6e65 6564 2074 6f20 7265 opers need to re │ │ │ │ │ +00017440: 6d65 6d62 6572 2074 6865 7920 6861 7665 member they have │ │ │ │ │ +00017450: 0a20 2020 2020 746f 2072 756e 2027 6376 . to run 'cv │ │ │ │ │ +00017460: 7320 6164 6427 206f 7220 2763 7673 2072 s add' or 'cvs r │ │ │ │ │ +00017470: 6d27 2061 6e79 7761 792e 2020 5570 6461 m' anyway. Upda │ │ │ │ │ +00017480: 7469 6e67 2027 4d61 6b65 6669 6c65 2e61 ting 'Makefile.a │ │ │ │ │ +00017490: 6d27 0a20 2020 2020 6163 636f 7264 696e m'. accordin │ │ │ │ │ +000174a0: 676c 7920 7175 6963 6b6c 7920 6265 636f gly quickly beco │ │ │ │ │ +000174b0: 6d65 7320 6120 7265 666c 6578 2e0a 0a20 mes a reflex... │ │ │ │ │ +000174c0: 2020 2020 436f 6e76 6572 7365 6c79 2c20 Conversely, │ │ │ │ │ +000174d0: 6966 2079 6f75 7220 6170 706c 6963 6174 if your applicat │ │ │ │ │ +000174e0: 696f 6e20 646f 6573 6e27 7420 636f 6d70 ion doesn't comp │ │ │ │ │ +000174f0: 696c 6520 6265 6361 7573 6520 796f 7520 ile because you │ │ │ │ │ +00017500: 666f 7267 6f74 0a20 2020 2020 746f 2061 forgot. to a │ │ │ │ │ +00017510: 6464 2061 2066 696c 6520 696e 2027 4d61 dd a file in 'Ma │ │ │ │ │ +00017520: 6b65 6669 6c65 2e61 6d27 2c20 6974 2077 kefile.am', it w │ │ │ │ │ +00017530: 696c 6c20 6865 6c70 2079 6f75 2072 656d ill help you rem │ │ │ │ │ +00017540: 656d 6265 7220 746f 2027 6376 730a 2020 ember to 'cvs. │ │ │ │ │ +00017550: 2020 2061 6464 2720 6974 2e0a 0a20 2020 add' it... │ │ │ │ │ +00017560: 2a20 5573 696e 6720 7769 6c64 6361 7264 * Using wildcard │ │ │ │ │ +00017570: 7320 6d61 6b65 7320 6974 2065 6173 7920 s makes it easy │ │ │ │ │ +00017580: 746f 2064 6973 7472 6962 7574 6520 6669 to distribute fi │ │ │ │ │ +00017590: 6c65 7320 6279 206d 6973 7461 6b65 2e20 les by mistake. │ │ │ │ │ +000175a0: 2046 6f72 0a20 2020 2020 696e 7374 616e For. instan │ │ │ │ │ +000175b0: 6365 2c20 736f 6d65 2063 6f64 6520 6120 ce, some code a │ │ │ │ │ +000175c0: 6465 7665 6c6f 7065 7220 6973 2065 7870 developer is exp │ │ │ │ │ +000175d0: 6572 696d 656e 7469 6e67 2077 6974 6820 erimenting with │ │ │ │ │ +000175e0: 2861 2074 6573 7420 6361 7365 2c0a 2020 (a test case,. │ │ │ │ │ +000175f0: 2020 2073 6179 2920 7468 6174 2073 686f say) that sho │ │ │ │ │ +00017600: 756c 6420 6e6f 7420 6265 2070 6172 7420 uld not be part │ │ │ │ │ +00017610: 6f66 2074 6865 2064 6973 7472 6962 7574 of the distribut │ │ │ │ │ +00017620: 696f 6e2e 0a0a 2020 202a 2055 7369 6e67 ion... * Using │ │ │ │ │ +00017630: 2077 696c 6463 6172 6473 2069 7427 7320 wildcards it's │ │ │ │ │ +00017640: 6561 7379 2074 6f20 6f6d 6974 2073 6f6d easy to omit som │ │ │ │ │ +00017650: 6520 6669 6c65 7320 6279 206d 6973 7461 e files by mista │ │ │ │ │ +00017660: 6b65 2e20 2046 6f72 0a20 2020 2020 696e ke. For. in │ │ │ │ │ +00017670: 7374 616e 6365 2c20 6f6e 6520 6465 7665 stance, one deve │ │ │ │ │ +00017680: 6c6f 7065 7220 6372 6561 7465 7320 6120 loper creates a │ │ │ │ │ +00017690: 6e65 7720 6669 6c65 2c20 7573 6573 2069 new file, uses i │ │ │ │ │ +000176a0: 7420 696e 206d 616e 7920 706c 6163 6573 t in many places │ │ │ │ │ +000176b0: 2c0a 2020 2020 2062 7574 2066 6f72 6765 ,. but forge │ │ │ │ │ +000176c0: 7473 2074 6f20 636f 6d6d 6974 2069 742e ts to commit it. │ │ │ │ │ +000176d0: 2020 416e 6f74 6865 7220 6465 7665 6c6f Another develo │ │ │ │ │ +000176e0: 7065 7220 7468 656e 2063 6865 636b 7320 per then checks │ │ │ │ │ +000176f0: 6f75 7420 7468 650a 2020 2020 2069 6e63 out the. inc │ │ │ │ │ +00017700: 6f6d 706c 6574 6520 7072 6f6a 6563 7420 omplete project │ │ │ │ │ +00017710: 616e 6420 6973 2061 626c 6520 746f 2072 and is able to r │ │ │ │ │ +00017720: 756e 2027 6d61 6b65 2064 6973 7427 2073 un 'make dist' s │ │ │ │ │ +00017730: 7563 6365 7373 6675 6c6c 792c 0a20 2020 uccessfully,. │ │ │ │ │ +00017740: 2020 6576 656e 2074 686f 7567 6820 6120 even though a │ │ │ │ │ +00017750: 6669 6c65 2069 7320 6d69 7373 696e 672e file is missing. │ │ │ │ │ +00017760: 2020 4279 206c 6973 7469 6e67 2066 696c By listing fil │ │ │ │ │ +00017770: 6573 2c20 276d 616b 6520 6469 7374 270a es, 'make dist'. │ │ │ │ │ +00017780: 2020 2020 205f 7769 6c6c 5f20 636f 6d70 _will_ comp │ │ │ │ │ +00017790: 6c61 696e 2e0a 0a20 2020 2a20 5769 6c64 lain... * Wild │ │ │ │ │ +000177a0: 6361 7264 7320 6172 6520 6e6f 7420 706f cards are not po │ │ │ │ │ +000177b0: 7274 6162 6c65 2074 6f20 736f 6d65 206e rtable to some n │ │ │ │ │ +000177c0: 6f6e 2d47 4e55 2027 6d61 6b65 2720 696d on-GNU 'make' im │ │ │ │ │ +000177d0: 706c 656d 656e 7461 7469 6f6e 732c 0a20 plementations,. │ │ │ │ │ +000177e0: 2020 2020 652e 672e 2c20 4e65 7442 5344 e.g., NetBSD │ │ │ │ │ +000177f0: 2027 6d61 6b65 2720 7769 6c6c 206e 6f74 'make' will not │ │ │ │ │ +00017800: 2065 7870 616e 6420 676c 6f62 7320 7375 expand globs su │ │ │ │ │ +00017810: 6368 2061 7320 272a 2720 696e 0a20 2020 ch as '*' in. │ │ │ │ │ +00017820: 2020 7072 6572 6571 7569 7369 7465 7320 prerequisites │ │ │ │ │ +00017830: 6f66 2061 2074 6172 6765 742e 0a0a 2020 of a target... │ │ │ │ │ +00017840: 202a 2046 696e 616c 6c79 2c20 6974 2773 * Finally, it's │ │ │ │ │ +00017850: 2072 6561 6c6c 7920 6861 7264 2074 6f20 really hard to │ │ │ │ │ +00017860: 5f66 6f72 6765 745f 2074 6f20 6164 6420 _forget_ to add │ │ │ │ │ +00017870: 6120 6669 6c65 2074 6f0a 2020 2020 2027 a file to. ' │ │ │ │ │ +00017880: 4d61 6b65 6669 6c65 2e61 6d27 3a20 6669 Makefile.am': fi │ │ │ │ │ +00017890: 6c65 7320 7468 6174 2061 7265 206e 6f74 les that are not │ │ │ │ │ +000178a0: 206c 6973 7465 6420 696e 2027 4d61 6b65 listed in 'Make │ │ │ │ │ +000178b0: 6669 6c65 2e61 6d27 2061 7265 206e 6f74 file.am' are not │ │ │ │ │ +000178c0: 0a20 2020 2020 636f 6d70 696c 6564 206f . compiled o │ │ │ │ │ +000178d0: 7220 696e 7374 616c 6c65 642c 2073 6f20 r installed, so │ │ │ │ │ +000178e0: 796f 7520 6361 6e27 7420 6576 656e 2074 you can't even t │ │ │ │ │ +000178f0: 6573 7420 7468 656d 2e0a 0a20 2020 5374 est them... St │ │ │ │ │ +00017900: 696c 6c2c 2074 6865 7365 2061 7265 2070 ill, these are p │ │ │ │ │ +00017910: 6869 6c6f 736f 7068 6963 616c 206f 626a hilosophical obj │ │ │ │ │ +00017920: 6563 7469 6f6e 732c 2061 6e64 2061 7320 ections, and as │ │ │ │ │ +00017930: 7375 6368 2079 6f75 206d 6179 0a64 6973 such you may.dis │ │ │ │ │ +00017940: 6167 7265 652c 206f 7220 6669 6e64 2065 agree, or find e │ │ │ │ │ +00017950: 6e6f 7567 6820 7661 6c75 6520 696e 2077 nough value in w │ │ │ │ │ +00017960: 696c 6463 6172 6473 2074 6f20 6469 736d ildcards to dism │ │ │ │ │ +00017970: 6973 7320 616c 6c20 6f66 2074 6865 6d2e iss all of them. │ │ │ │ │ +00017980: 0a42 6566 6f72 6520 796f 7520 7374 6172 .Before you star │ │ │ │ │ +00017990: 7420 7772 6974 696e 6720 6120 7061 7463 t writing a patc │ │ │ │ │ +000179a0: 6820 6167 6169 6e73 7420 4175 746f 6d61 h against Automa │ │ │ │ │ +000179b0: 6b65 2074 6f20 7465 6163 6820 6974 2061 ke to teach it a │ │ │ │ │ +000179c0: 626f 7574 0a77 696c 6463 6172 6473 2c20 bout.wildcards, │ │ │ │ │ +000179d0: 6c65 7427 7320 7365 6520 7468 6520 6d61 let's see the ma │ │ │ │ │ +000179e0: 696e 2074 6563 686e 6963 616c 2069 7373 in technical iss │ │ │ │ │ +000179f0: 7565 3a20 706f 7274 6162 696c 6974 792e ue: portability. │ │ │ │ │ +00017a00: 0a0a 2020 2041 6c74 686f 7567 6820 2724 .. Although '$ │ │ │ │ │ +00017a10: 2877 696c 6463 6172 6420 2e2e 2e29 2720 (wildcard ...)' │ │ │ │ │ +00017a20: 776f 726b 7320 7769 7468 2047 4e55 2027 works with GNU ' │ │ │ │ │ +00017a30: 6d61 6b65 272c 2069 7420 6973 206e 6f74 make', it is not │ │ │ │ │ +00017a40: 2070 6f72 7461 626c 650a 746f 206f 7468 portable.to oth │ │ │ │ │ +00017a50: 6572 2027 6d61 6b65 2720 696d 706c 656d er 'make' implem │ │ │ │ │ +00017a60: 656e 7461 7469 6f6e 732e 0a0a 2020 2054 entations... T │ │ │ │ │ +00017a70: 6865 206f 6e6c 7920 7761 7920 4175 746f he only way Auto │ │ │ │ │ +00017a80: 6d61 6b65 2063 6f75 6c64 2073 7570 706f make could suppo │ │ │ │ │ +00017a90: 7274 2027 2428 7769 6c64 6361 7264 202e rt '$(wildcard . │ │ │ │ │ +00017aa0: 2e2e 2927 2069 7320 6279 2065 7870 656e ..)' is by expen │ │ │ │ │ +00017ab0: 6469 6e67 0a27 2428 7769 6c64 6361 7264 ding.'$(wildcard │ │ │ │ │ +00017ac0: 202e 2e2e 2927 2077 6865 6e20 2761 7574 ...)' when 'aut │ │ │ │ │ +00017ad0: 6f6d 616b 6527 2069 7320 7275 6e2e 2020 omake' is run. │ │ │ │ │ +00017ae0: 5468 6520 7265 7375 6c74 696e 6720 274d The resulting 'M │ │ │ │ │ +00017af0: 616b 6566 696c 652e 696e 2773 0a77 6f75 akefile.in's.wou │ │ │ │ │ +00017b00: 6c64 2062 6520 706f 7274 6162 6c65 2073 ld be portable s │ │ │ │ │ +00017b10: 696e 6365 2074 6865 7920 776f 756c 6420 ince they would │ │ │ │ │ +00017b20: 6c69 7374 2061 6c6c 2066 696c 6573 2061 list all files a │ │ │ │ │ +00017b30: 6e64 206e 6f74 2075 7365 0a27 2428 7769 nd not use.'$(wi │ │ │ │ │ +00017b40: 6c64 6361 7264 202e 2e2e 2927 2e20 2048 ldcard ...)'. H │ │ │ │ │ +00017b50: 6f77 6576 6572 2074 6861 7420 6d65 616e owever that mean │ │ │ │ │ +00017b60: 7320 6465 7665 6c6f 7065 7273 2077 6f75 s developers wou │ │ │ │ │ +00017b70: 6c64 206e 6565 6420 746f 2072 656d 656d ld need to remem │ │ │ │ │ +00017b80: 6265 720a 746f 2072 756e 2027 6175 746f ber.to run 'auto │ │ │ │ │ +00017b90: 6d61 6b65 2720 6561 6368 2074 696d 6520 make' each time │ │ │ │ │ +00017ba0: 7468 6579 2061 6464 2c20 6465 6c65 7465 they add, delete │ │ │ │ │ +00017bb0: 2c20 6f72 2072 656e 616d 6520 6669 6c65 , or rename file │ │ │ │ │ +00017bc0: 732e 0a0a 2020 2043 6f6d 7061 7265 6420 s... Compared │ │ │ │ │ +00017bd0: 746f 2065 6469 7469 6e67 2027 4d61 6b65 to editing 'Make │ │ │ │ │ +00017be0: 6669 6c65 2e61 6d27 2c20 7468 6973 2069 file.am', this i │ │ │ │ │ +00017bf0: 7320 6120 7665 7279 2073 6d61 6c6c 2067 s a very small g │ │ │ │ │ +00017c00: 6169 6e2e 2020 5375 7265 2c0a 6974 2773 ain. Sure,.it's │ │ │ │ │ +00017c10: 2065 6173 6965 7220 616e 6420 6661 7374 easier and fast │ │ │ │ │ +00017c20: 6572 2074 6f20 7479 7065 2027 6175 746f er to type 'auto │ │ │ │ │ +00017c30: 6d61 6b65 3b20 6d61 6b65 2720 7468 616e make; make' than │ │ │ │ │ +00017c40: 2074 6f20 7479 7065 2027 656d 6163 730a to type 'emacs. │ │ │ │ │ +00017c50: 4d61 6b65 6669 6c65 2e61 6d3b 206d 616b Makefile.am; mak │ │ │ │ │ +00017c60: 6527 2e20 2042 7574 206e 6f62 6f64 7920 e'. But nobody │ │ │ │ │ +00017c70: 626f 7468 6572 6564 2065 6e6f 7567 6820 bothered enough │ │ │ │ │ +00017c80: 746f 2077 7269 7465 2061 2070 6174 6368 to write a patch │ │ │ │ │ +00017c90: 2074 6f20 6164 640a 7375 7070 6f72 7420 to add.support │ │ │ │ │ +00017ca0: 666f 7220 7468 6973 2073 796e 7461 782e for this syntax. │ │ │ │ │ +00017cb0: 2020 536f 6d65 2070 656f 706c 6520 7573 Some people us │ │ │ │ │ +00017cc0: 6520 7363 7269 7074 7320 746f 2067 656e e scripts to gen │ │ │ │ │ +00017cd0: 6572 6174 6520 6669 6c65 206c 6973 7473 erate file lists │ │ │ │ │ +00017ce0: 0a69 6e20 274d 616b 6566 696c 652e 616d .in 'Makefile.am │ │ │ │ │ +00017cf0: 2720 6f72 2069 6e20 7365 7061 7261 7465 ' or in separate │ │ │ │ │ +00017d00: 2027 4d61 6b65 6669 6c65 2720 6672 6167 'Makefile' frag │ │ │ │ │ +00017d10: 6d65 6e74 732e 0a0a 2020 2045 7665 6e20 ments... Even │ │ │ │ │ +00017d20: 6966 2079 6f75 2064 6f6e 2774 2063 6172 if you don't car │ │ │ │ │ +00017d30: 6520 6162 6f75 7420 706f 7274 6162 696c e about portabil │ │ │ │ │ +00017d40: 6974 792c 2061 6e64 2061 7265 2074 656d ity, and are tem │ │ │ │ │ +00017d50: 7074 6564 2074 6f20 7573 650a 2724 2877 pted to use.'$(w │ │ │ │ │ +00017d60: 696c 6463 6172 6420 2e2e 2e29 2720 616e ildcard ...)' an │ │ │ │ │ +00017d70: 7977 6179 2062 6563 6175 7365 2079 6f75 yway because you │ │ │ │ │ +00017d80: 2074 6172 6765 7420 6f6e 6c79 2047 4e55 target only GNU │ │ │ │ │ +00017d90: 204d 616b 652c 2079 6f75 2073 686f 756c Make, you shoul │ │ │ │ │ +00017da0: 640a 6b6e 6f77 2074 6865 7265 2061 7265 d.know there are │ │ │ │ │ +00017db0: 206d 616e 7920 706c 6163 6573 2077 6865 many places whe │ │ │ │ │ +00017dc0: 7265 2041 7574 6f6d 616b 6520 6e65 6564 re Automake need │ │ │ │ │ +00017dd0: 7320 746f 206b 6e6f 7720 6578 6163 746c s to know exactl │ │ │ │ │ +00017de0: 7920 7768 6963 680a 6669 6c65 7320 7368 y which.files sh │ │ │ │ │ +00017df0: 6f75 6c64 2062 6520 7072 6f63 6573 7365 ould be processe │ │ │ │ │ +00017e00: 642e 2020 4173 2041 7574 6f6d 616b 6520 d. As Automake │ │ │ │ │ +00017e10: 646f 6573 6e27 7420 6b6e 6f77 2068 6f77 doesn't know how │ │ │ │ │ +00017e20: 2074 6f20 6578 7061 6e64 0a27 2428 7769 to expand.'$(wi │ │ │ │ │ +00017e30: 6c64 6361 7264 202e 2e2e 2927 2c20 796f ldcard ...)', yo │ │ │ │ │ +00017e40: 7520 6361 6e6e 6f74 2075 7365 2069 7420 u cannot use it │ │ │ │ │ +00017e50: 696e 2074 6865 7365 2070 6c61 6365 732e in these places. │ │ │ │ │ +00017e60: 2020 2724 2877 696c 6463 6172 6420 2e2e '$(wildcard .. │ │ │ │ │ +00017e70: 2e29 270a 6973 2061 2062 6c61 636b 2062 .)'.is a black b │ │ │ │ │ +00017e80: 6f78 2063 6f6d 7061 7261 626c 6520 746f ox comparable to │ │ │ │ │ +00017e90: 2027 4143 5f53 5542 5354 2765 6420 7661 'AC_SUBST'ed va │ │ │ │ │ +00017ea0: 7269 6162 6c65 7320 6173 2066 6172 2041 riables as far A │ │ │ │ │ +00017eb0: 7574 6f6d 616b 6520 6973 0a63 6f6e 6365 utomake is.conce │ │ │ │ │ +00017ec0: 726e 6564 2e0a 0a20 2020 596f 7520 6361 rned... You ca │ │ │ │ │ +00017ed0: 6e20 6765 7420 7761 726e 696e 6773 2061 n get warnings a │ │ │ │ │ +00017ee0: 626f 7574 2027 2428 7769 6c64 6361 7264 bout '$(wildcard │ │ │ │ │ +00017ef0: 202e 2e2e 2729 2063 6f6e 7374 7275 6374 ...') construct │ │ │ │ │ +00017f00: 7320 7573 696e 6720 7468 650a 272d 5770 s using the.'-Wp │ │ │ │ │ +00017f10: 6f72 7461 6269 6c69 7479 2720 666c 6167 ortability' flag │ │ │ │ │ +00017f20: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +00017f30: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +00017f40: 4e6f 6465 3a20 4c69 6d69 7461 7469 6f6e Node: Limitation │ │ │ │ │ +00017f50: 7320 6f6e 2046 696c 6520 4e61 6d65 732c s on File Names, │ │ │ │ │ +00017f60: 2020 4e65 7874 3a20 6469 7374 636c 6561 Next: distclea │ │ │ │ │ +00017f70: 6e63 6865 636b 2c20 2050 7265 763a 2057 ncheck, Prev: W │ │ │ │ │ +00017f80: 696c 6463 6172 6473 2c20 2055 703a 2046 ildcards, Up: F │ │ │ │ │ +00017f90: 4151 0a0a 3238 2e34 204c 696d 6974 6174 AQ..28.4 Limitat │ │ │ │ │ +00017fa0: 696f 6e73 206f 6e20 4669 6c65 204e 616d ions on File Nam │ │ │ │ │ +00017fb0: 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d es.============= │ │ │ │ │ 00017fc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00017fd0: 0a0a 4175 746f 6d61 6b65 2061 7474 656d ..Automake attem │ │ │ │ │ -00017fe0: 7074 7320 746f 2073 7570 706f 7274 2061 pts to support a │ │ │ │ │ -00017ff0: 6c6c 206b 696e 6473 206f 6620 6669 6c65 ll kinds of file │ │ │ │ │ -00018000: 206e 616d 6573 2c20 6576 656e 2074 686f names, even tho │ │ │ │ │ -00018010: 7365 2074 6861 740a 636f 6e74 6169 6e20 se that.contain │ │ │ │ │ -00018020: 756e 7573 7561 6c20 6368 6172 6163 7465 unusual characte │ │ │ │ │ -00018030: 7273 206f 7220 6172 6520 756e 7573 7561 rs or are unusua │ │ │ │ │ -00018040: 6c6c 7920 6c6f 6e67 2e20 2048 6f77 6576 lly long. Howev │ │ │ │ │ -00018050: 6572 2c20 736f 6d65 0a6c 696d 6974 6174 er, some.limitat │ │ │ │ │ -00018060: 696f 6e73 2061 7265 2069 6d70 6f73 6564 ions are imposed │ │ │ │ │ -00018070: 2062 7920 7468 6520 756e 6465 726c 7969 by the underlyi │ │ │ │ │ -00018080: 6e67 206f 7065 7261 7469 6e67 2073 7973 ng operating sys │ │ │ │ │ -00018090: 7465 6d20 616e 6420 746f 6f6c 732e 0a0a tem and tools... │ │ │ │ │ -000180a0: 2020 204d 6f73 7420 6f70 6572 6174 696e Most operatin │ │ │ │ │ -000180b0: 6720 7379 7374 656d 7320 7072 6f68 6962 g systems prohib │ │ │ │ │ -000180c0: 6974 2074 6865 2075 7365 206f 6620 7468 it the use of th │ │ │ │ │ -000180d0: 6520 6e75 6c6c 2062 7974 6520 696e 2066 e null byte in f │ │ │ │ │ -000180e0: 696c 650a 6e61 6d65 732c 2061 6e64 2072 ile.names, and r │ │ │ │ │ -000180f0: 6573 6572 7665 2027 2f27 2061 7320 6120 eserve '/' as a │ │ │ │ │ -00018100: 6469 7265 6374 6f72 7920 7365 7061 7261 directory separa │ │ │ │ │ -00018110: 746f 722e 2020 416c 736f 2c20 7468 6579 tor. Also, they │ │ │ │ │ -00018120: 2072 6571 7569 7265 0a74 6861 7420 6669 require.that fi │ │ │ │ │ -00018130: 6c65 206e 616d 6573 2061 7265 2070 726f le names are pro │ │ │ │ │ -00018140: 7065 726c 7920 656e 636f 6465 6420 666f perly encoded fo │ │ │ │ │ -00018150: 7220 7468 6520 7573 6572 2773 206c 6f63 r the user's loc │ │ │ │ │ -00018160: 616c 652e 2020 4175 746f 6d61 6b65 2069 ale. Automake i │ │ │ │ │ -00018170: 730a 7375 626a 6563 7420 746f 2074 6865 s.subject to the │ │ │ │ │ -00018180: 7365 206c 696d 6974 732e 0a0a 2020 2050 se limits... P │ │ │ │ │ -00018190: 6f72 7461 626c 6520 7061 636b 6167 6573 ortable packages │ │ │ │ │ -000181a0: 2073 686f 756c 6420 6c69 6d69 7420 7468 should limit th │ │ │ │ │ -000181b0: 656d 7365 6c76 6573 2074 6f20 504f 5349 emselves to POSI │ │ │ │ │ -000181c0: 5820 6669 6c65 206e 616d 6573 2e20 2054 X file names. T │ │ │ │ │ -000181d0: 6865 7365 0a63 616e 2063 6f6e 7461 696e hese.can contain │ │ │ │ │ -000181e0: 2041 5343 4949 206c 6574 7465 7273 2061 ASCII letters a │ │ │ │ │ -000181f0: 6e64 2064 6967 6974 732c 2027 5f27 2c20 nd digits, '_', │ │ │ │ │ -00018200: 272e 272c 2061 6e64 2027 2d27 2e20 2046 '.', and '-'. F │ │ │ │ │ -00018210: 696c 6520 6e61 6d65 730a 636f 6e73 6973 ile names.consis │ │ │ │ │ -00018220: 7420 6f66 2063 6f6d 706f 6e65 6e74 7320 t of components │ │ │ │ │ -00018230: 7365 7061 7261 7465 6420 6279 2027 2f27 separated by '/' │ │ │ │ │ -00018240: 2e20 2046 696c 6520 6e61 6d65 2063 6f6d . File name com │ │ │ │ │ -00018250: 706f 6e65 6e74 7320 6361 6e6e 6f74 0a62 ponents cannot.b │ │ │ │ │ -00018260: 6567 696e 2077 6974 6820 272d 272e 0a0a egin with '-'... │ │ │ │ │ -00018270: 2020 2050 6f72 7461 626c 6520 504f 5349 Portable POSI │ │ │ │ │ -00018280: 5820 6669 6c65 206e 616d 6573 2063 616e X file names can │ │ │ │ │ -00018290: 6e6f 7420 636f 6e74 6169 6e20 636f 6d70 not contain comp │ │ │ │ │ -000182a0: 6f6e 656e 7473 2074 6861 7420 6578 6365 onents that exce │ │ │ │ │ -000182b0: 6564 2061 0a31 342d 6279 7465 206c 696d ed a.14-byte lim │ │ │ │ │ -000182c0: 6974 2c20 6275 7420 6e6f 7761 6461 7973 it, but nowadays │ │ │ │ │ -000182d0: 2069 7427 7320 6e6f 726d 616c 6c79 2073 it's normally s │ │ │ │ │ -000182e0: 6166 6520 746f 2061 7373 756d 6520 7468 afe to assume th │ │ │ │ │ -000182f0: 650a 6d6f 7265 2d67 656e 6572 6f75 7320 e.more-generous │ │ │ │ │ -00018300: 584f 5045 4e20 6c69 6d69 7420 6f66 2032 XOPEN limit of 2 │ │ │ │ │ -00018310: 3535 2062 7974 6573 2e20 2050 4f53 4958 55 bytes. POSIX │ │ │ │ │ -00018320: 206c 696d 6974 7320 6669 6c65 206e 616d limits file nam │ │ │ │ │ -00018330: 6573 2074 6f20 3235 350a 6279 7465 7320 es to 255.bytes │ │ │ │ │ -00018340: 2858 4f50 454e 2061 6c6c 6f77 7320 3130 (XOPEN allows 10 │ │ │ │ │ -00018350: 3233 2062 7974 6573 292c 2062 7574 2079 23 bytes), but y │ │ │ │ │ -00018360: 6f75 206d 6179 2077 616e 7420 746f 206c ou may want to l │ │ │ │ │ -00018370: 696d 6974 2061 2073 6f75 7263 650a 7461 imit a source.ta │ │ │ │ │ -00018380: 7262 616c 6c20 746f 2066 696c 6520 6e61 rball to file na │ │ │ │ │ -00018390: 6d65 7320 6f66 2039 3920 6279 7465 7320 mes of 99 bytes │ │ │ │ │ -000183a0: 746f 2061 766f 6964 2069 6e74 6572 6f70 to avoid interop │ │ │ │ │ -000183b0: 6572 6162 696c 6974 7920 7072 6f62 6c65 erability proble │ │ │ │ │ -000183c0: 6d73 0a77 6974 6820 6f6c 6420 7665 7273 ms.with old vers │ │ │ │ │ -000183d0: 696f 6e73 206f 6620 2774 6172 272e 0a0a ions of 'tar'... │ │ │ │ │ -000183e0: 2020 2049 6620 796f 7520 6465 7061 7274 If you depart │ │ │ │ │ -000183f0: 2066 726f 6d20 7468 6573 6520 7275 6c65 from these rule │ │ │ │ │ -00018400: 7320 2865 2e67 2e2c 2062 7920 7573 696e s (e.g., by usin │ │ │ │ │ -00018410: 6720 6e6f 6e2d 4153 4349 4920 6368 6172 g non-ASCII char │ │ │ │ │ -00018420: 6163 7465 7273 0a69 6e20 6669 6c65 206e acters.in file n │ │ │ │ │ -00018430: 616d 6573 2c20 6f72 2062 7920 7573 696e ames, or by usin │ │ │ │ │ -00018440: 6720 6c65 6e67 7468 7920 6669 6c65 206e g lengthy file n │ │ │ │ │ -00018450: 616d 6573 292c 2079 6f75 7220 696e 7374 ames), your inst │ │ │ │ │ -00018460: 616c 6c65 7273 206d 6179 2068 6176 650a allers may have. │ │ │ │ │ -00018470: 7072 6f62 6c65 6d73 2066 6f72 2072 6561 problems for rea │ │ │ │ │ -00018480: 736f 6e73 2075 6e72 656c 6174 6564 2074 sons unrelated t │ │ │ │ │ -00018490: 6f20 4175 746f 6d61 6b65 2e20 2048 6f77 o Automake. How │ │ │ │ │ -000184a0: 6576 6572 2c20 6966 2074 6869 7320 646f ever, if this do │ │ │ │ │ -000184b0: 6573 206e 6f74 0a63 6f6e 6365 726e 2079 es not.concern y │ │ │ │ │ -000184c0: 6f75 2c20 796f 7520 7368 6f75 6c64 206b ou, you should k │ │ │ │ │ -000184d0: 6e6f 7720 6162 6f75 7420 7468 6520 6c69 now about the li │ │ │ │ │ -000184e0: 6d69 7461 7469 6f6e 7320 696d 706f 7365 mitations impose │ │ │ │ │ -000184f0: 6420 6279 2041 7574 6f6d 616b 650a 6974 d by Automake.it │ │ │ │ │ -00018500: 7365 6c66 2e20 2054 6865 7365 206c 696d self. These lim │ │ │ │ │ -00018510: 6974 6174 696f 6e73 2061 7265 2075 6e64 itations are und │ │ │ │ │ -00018520: 6573 6972 6162 6c65 2c20 6275 7420 736f esirable, but so │ │ │ │ │ -00018530: 6d65 206f 6620 7468 656d 2073 6565 6d20 me of them seem │ │ │ │ │ -00018540: 746f 2062 650a 696e 6865 7265 6e74 2074 to be.inherent t │ │ │ │ │ -00018550: 6f20 756e 6465 726c 7969 6e67 2074 6f6f o underlying too │ │ │ │ │ -00018560: 6c73 206c 696b 6520 4175 746f 636f 6e66 ls like Autoconf │ │ │ │ │ -00018570: 2c20 4d61 6b65 2c20 4d34 2c20 616e 6420 , Make, M4, and │ │ │ │ │ -00018580: 7468 6520 7368 656c 6c2e 0a54 6865 7920 the shell..They │ │ │ │ │ -00018590: 6661 6c6c 2069 6e74 6f20 7468 7265 6520 fall into three │ │ │ │ │ -000185a0: 6361 7465 676f 7269 6573 3a20 696e 7374 categories: inst │ │ │ │ │ -000185b0: 616c 6c20 6469 7265 6374 6f72 6965 732c all directories, │ │ │ │ │ -000185c0: 2062 7569 6c64 2064 6972 6563 746f 7269 build directori │ │ │ │ │ -000185d0: 6573 2c0a 616e 6420 6669 6c65 206e 616d es,.and file nam │ │ │ │ │ -000185e0: 6573 2e0a 0a20 2020 5468 6520 666f 6c6c es... The foll │ │ │ │ │ -000185f0: 6f77 696e 6720 6368 6172 6163 7465 7273 owing characters │ │ │ │ │ -00018600: 3a0a 0a20 2020 2020 6e65 776c 696e 6520 :.. newline │ │ │ │ │ -00018610: 2220 2320 2420 2720 600a 0a20 2020 7368 " # $ ' `.. sh │ │ │ │ │ -00018620: 6f75 6c64 206e 6f74 2061 7070 6561 7220 ould not appear │ │ │ │ │ -00018630: 696e 2074 6865 206e 616d 6573 206f 6620 in the names of │ │ │ │ │ -00018640: 696e 7374 616c 6c20 6469 7265 6374 6f72 install director │ │ │ │ │ -00018650: 6965 732e 2020 466f 7220 6578 616d 706c ies. For exampl │ │ │ │ │ -00018660: 652c 0a74 6865 206f 7065 7261 6e64 206f e,.the operand o │ │ │ │ │ -00018670: 6620 2763 6f6e 6669 6775 7265 2727 7320 f 'configure''s │ │ │ │ │ -00018680: 272d 2d70 7265 6669 7827 206f 7074 696f '--prefix' optio │ │ │ │ │ -00018690: 6e20 7368 6f75 6c64 206e 6f74 2063 6f6e n should not con │ │ │ │ │ -000186a0: 7461 696e 2074 6865 7365 0a63 6861 7261 tain these.chara │ │ │ │ │ -000186b0: 6374 6572 732e 0a0a 2020 2042 7569 6c64 cters... Build │ │ │ │ │ -000186c0: 2064 6972 6563 746f 7269 6573 2073 7566 directories suf │ │ │ │ │ -000186d0: 6665 7220 7468 6520 7361 6d65 206c 696d fer the same lim │ │ │ │ │ -000186e0: 6974 6174 696f 6e73 2061 7320 696e 7374 itations as inst │ │ │ │ │ -000186f0: 616c 6c20 6469 7265 6374 6f72 6965 732c all directories, │ │ │ │ │ -00018700: 0a61 6e64 2069 6e20 6164 6469 7469 6f6e .and in addition │ │ │ │ │ -00018710: 2073 686f 756c 6420 6e6f 7420 636f 6e74 should not cont │ │ │ │ │ -00018720: 6169 6e20 7468 6520 666f 6c6c 6f77 696e ain the followin │ │ │ │ │ -00018730: 6720 6368 6172 6163 7465 7273 3a0a 0a20 g characters:.. │ │ │ │ │ -00018740: 2020 2020 2620 4020 5c0a 0a20 2020 466f & @ \.. Fo │ │ │ │ │ -00018750: 7220 6578 616d 706c 652c 2074 6865 2066 r example, the f │ │ │ │ │ -00018760: 756c 6c20 6e61 6d65 206f 6620 7468 6520 ull name of the │ │ │ │ │ -00018770: 6469 7265 6374 6f72 7920 636f 6e74 6169 directory contai │ │ │ │ │ -00018780: 6e69 6e67 2074 6865 2073 6f75 7263 650a ning the source. │ │ │ │ │ -00018790: 6669 6c65 7320 7368 6f75 6c64 206e 6f74 files should not │ │ │ │ │ -000187a0: 2063 6f6e 7461 696e 2074 6865 7365 2063 contain these c │ │ │ │ │ -000187b0: 6861 7261 6374 6572 732e 0a0a 2020 2053 haracters... S │ │ │ │ │ -000187c0: 6f75 7263 6520 616e 6420 696e 7374 616c ource and instal │ │ │ │ │ -000187d0: 6c61 7469 6f6e 2066 696c 6520 6e61 6d65 lation file name │ │ │ │ │ -000187e0: 7320 6c69 6b65 2027 6d61 696e 2e63 2720 s like 'main.c' │ │ │ │ │ -000187f0: 6172 6520 6c69 6d69 7465 6420 6576 656e are limited even │ │ │ │ │ -00018800: 0a66 7572 7468 6572 3a20 7468 6579 2073 .further: they s │ │ │ │ │ -00018810: 686f 756c 6420 636f 6e66 6f72 6d20 746f hould conform to │ │ │ │ │ -00018820: 2074 6865 2050 4f53 4958 2f58 4f50 454e the POSIX/XOPEN │ │ │ │ │ -00018830: 2072 756c 6573 2064 6573 6372 6962 6564 rules described │ │ │ │ │ -00018840: 2061 626f 7665 2e0a 496e 2061 6464 6974 above..In addit │ │ │ │ │ -00018850: 696f 6e2c 2069 6620 796f 7520 706c 616e ion, if you plan │ │ │ │ │ -00018860: 2074 6f20 706f 7274 2074 6f20 6e6f 6e2d to port to non- │ │ │ │ │ -00018870: 504f 5349 5820 656e 7669 726f 6e6d 656e POSIX environmen │ │ │ │ │ -00018880: 7473 2c20 796f 7520 7368 6f75 6c64 0a61 ts, you should.a │ │ │ │ │ -00018890: 766f 6964 2066 696c 6520 6e61 6d65 7320 void file names │ │ │ │ │ -000188a0: 7468 6174 2064 6966 6665 7220 6f6e 6c79 that differ only │ │ │ │ │ -000188b0: 2069 6e20 6361 7365 2028 652e 672e 2c20 in case (e.g., │ │ │ │ │ -000188c0: 276d 616b 6566 696c 6527 2061 6e64 0a27 'makefile' and.' │ │ │ │ │ -000188d0: 4d61 6b65 6669 6c65 2729 2e20 204e 6f77 Makefile'). Now │ │ │ │ │ -000188e0: 6164 6179 7320 6974 2069 7320 6e6f 206c adays it is no l │ │ │ │ │ -000188f0: 6f6e 6765 7220 776f 7274 6820 776f 7272 onger worth worr │ │ │ │ │ -00018900: 7969 6e67 2061 626f 7574 2074 6865 2038 ying about the 8 │ │ │ │ │ -00018910: 2e33 0a6c 696d 6974 7320 6f66 2044 4f53 .3.limits of DOS │ │ │ │ │ -00018920: 2066 696c 6520 7379 7374 656d 732e 0a0a file systems... │ │ │ │ │ -00018930: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -00018940: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -00018950: 653a 2064 6973 7463 6c65 616e 6368 6563 e: distcleanchec │ │ │ │ │ -00018960: 6b2c 2020 4e65 7874 3a20 466c 6167 2056 k, Next: Flag V │ │ │ │ │ -00018970: 6172 6961 626c 6573 204f 7264 6572 696e ariables Orderin │ │ │ │ │ -00018980: 672c 2020 5072 6576 3a20 4c69 6d69 7461 g, Prev: Limita │ │ │ │ │ -00018990: 7469 6f6e 7320 6f6e 2046 696c 6520 4e61 tions on File Na │ │ │ │ │ -000189a0: 6d65 732c 2020 5570 3a20 4641 510a 0a32 mes, Up: FAQ..2 │ │ │ │ │ -000189b0: 382e 3520 4669 6c65 7320 6c65 6674 2069 8.5 Files left i │ │ │ │ │ -000189c0: 6e20 6275 696c 6420 6469 7265 6374 6f72 n build director │ │ │ │ │ -000189d0: 7920 6166 7465 7220 6469 7374 636c 6561 y after distclea │ │ │ │ │ -000189e0: 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d n.============== │ │ │ │ │ +00017fd0: 3d0a 0a41 7574 6f6d 616b 6520 6174 7465 =..Automake atte │ │ │ │ │ +00017fe0: 6d70 7473 2074 6f20 7375 7070 6f72 7420 mpts to support │ │ │ │ │ +00017ff0: 616c 6c20 6b69 6e64 7320 6f66 2066 696c all kinds of fil │ │ │ │ │ +00018000: 6520 6e61 6d65 732c 2065 7665 6e20 7468 e names, even th │ │ │ │ │ +00018010: 6f73 6520 7468 6174 0a63 6f6e 7461 696e ose that.contain │ │ │ │ │ +00018020: 2075 6e75 7375 616c 2063 6861 7261 6374 unusual charact │ │ │ │ │ +00018030: 6572 7320 6f72 2061 7265 2075 6e75 7375 ers or are unusu │ │ │ │ │ +00018040: 616c 6c79 206c 6f6e 672e 2020 486f 7765 ally long. Howe │ │ │ │ │ +00018050: 7665 722c 2073 6f6d 650a 6c69 6d69 7461 ver, some.limita │ │ │ │ │ +00018060: 7469 6f6e 7320 6172 6520 696d 706f 7365 tions are impose │ │ │ │ │ +00018070: 6420 6279 2074 6865 2075 6e64 6572 6c79 d by the underly │ │ │ │ │ +00018080: 696e 6720 6f70 6572 6174 696e 6720 7379 ing operating sy │ │ │ │ │ +00018090: 7374 656d 2061 6e64 2074 6f6f 6c73 2e0a stem and tools.. │ │ │ │ │ +000180a0: 0a20 2020 4d6f 7374 206f 7065 7261 7469 . Most operati │ │ │ │ │ +000180b0: 6e67 2073 7973 7465 6d73 2070 726f 6869 ng systems prohi │ │ │ │ │ +000180c0: 6269 7420 7468 6520 7573 6520 6f66 2074 bit the use of t │ │ │ │ │ +000180d0: 6865 206e 756c 6c20 6279 7465 2069 6e20 he null byte in │ │ │ │ │ +000180e0: 6669 6c65 0a6e 616d 6573 2c20 616e 6420 file.names, and │ │ │ │ │ +000180f0: 7265 7365 7276 6520 272f 2720 6173 2061 reserve '/' as a │ │ │ │ │ +00018100: 2064 6972 6563 746f 7279 2073 6570 6172 directory separ │ │ │ │ │ +00018110: 6174 6f72 2e20 2041 6c73 6f2c 2074 6865 ator. Also, the │ │ │ │ │ +00018120: 7920 7265 7175 6972 650a 7468 6174 2066 y require.that f │ │ │ │ │ +00018130: 696c 6520 6e61 6d65 7320 6172 6520 7072 ile names are pr │ │ │ │ │ +00018140: 6f70 6572 6c79 2065 6e63 6f64 6564 2066 operly encoded f │ │ │ │ │ +00018150: 6f72 2074 6865 2075 7365 7227 7320 6c6f or the user's lo │ │ │ │ │ +00018160: 6361 6c65 2e20 2041 7574 6f6d 616b 6520 cale. Automake │ │ │ │ │ +00018170: 6973 0a73 7562 6a65 6374 2074 6f20 7468 is.subject to th │ │ │ │ │ +00018180: 6573 6520 6c69 6d69 7473 2e0a 0a20 2020 ese limits... │ │ │ │ │ +00018190: 506f 7274 6162 6c65 2070 6163 6b61 6765 Portable package │ │ │ │ │ +000181a0: 7320 7368 6f75 6c64 206c 696d 6974 2074 s should limit t │ │ │ │ │ +000181b0: 6865 6d73 656c 7665 7320 746f 2050 4f53 hemselves to POS │ │ │ │ │ +000181c0: 4958 2066 696c 6520 6e61 6d65 732e 2020 IX file names. │ │ │ │ │ +000181d0: 5468 6573 650a 6361 6e20 636f 6e74 6169 These.can contai │ │ │ │ │ +000181e0: 6e20 4153 4349 4920 6c65 7474 6572 7320 n ASCII letters │ │ │ │ │ +000181f0: 616e 6420 6469 6769 7473 2c20 275f 272c and digits, '_', │ │ │ │ │ +00018200: 2027 2e27 2c20 616e 6420 272d 272e 2020 '.', and '-'. │ │ │ │ │ +00018210: 4669 6c65 206e 616d 6573 0a63 6f6e 7369 File names.consi │ │ │ │ │ +00018220: 7374 206f 6620 636f 6d70 6f6e 656e 7473 st of components │ │ │ │ │ +00018230: 2073 6570 6172 6174 6564 2062 7920 272f separated by '/ │ │ │ │ │ +00018240: 272e 2020 4669 6c65 206e 616d 6520 636f '. File name co │ │ │ │ │ +00018250: 6d70 6f6e 656e 7473 2063 616e 6e6f 740a mponents cannot. │ │ │ │ │ +00018260: 6265 6769 6e20 7769 7468 2027 2d27 2e0a begin with '-'.. │ │ │ │ │ +00018270: 0a20 2020 506f 7274 6162 6c65 2050 4f53 . Portable POS │ │ │ │ │ +00018280: 4958 2066 696c 6520 6e61 6d65 7320 6361 IX file names ca │ │ │ │ │ +00018290: 6e6e 6f74 2063 6f6e 7461 696e 2063 6f6d nnot contain com │ │ │ │ │ +000182a0: 706f 6e65 6e74 7320 7468 6174 2065 7863 ponents that exc │ │ │ │ │ +000182b0: 6565 6420 610a 3134 2d62 7974 6520 6c69 eed a.14-byte li │ │ │ │ │ +000182c0: 6d69 742c 2062 7574 206e 6f77 6164 6179 mit, but nowaday │ │ │ │ │ +000182d0: 7320 6974 2773 206e 6f72 6d61 6c6c 7920 s it's normally │ │ │ │ │ +000182e0: 7361 6665 2074 6f20 6173 7375 6d65 2074 safe to assume t │ │ │ │ │ +000182f0: 6865 0a6d 6f72 652d 6765 6e65 726f 7573 he.more-generous │ │ │ │ │ +00018300: 2058 4f50 454e 206c 696d 6974 206f 6620 XOPEN limit of │ │ │ │ │ +00018310: 3235 3520 6279 7465 732e 2020 504f 5349 255 bytes. POSI │ │ │ │ │ +00018320: 5820 6c69 6d69 7473 2066 696c 6520 6e61 X limits file na │ │ │ │ │ +00018330: 6d65 7320 746f 2032 3535 0a62 7974 6573 mes to 255.bytes │ │ │ │ │ +00018340: 2028 584f 5045 4e20 616c 6c6f 7773 2031 (XOPEN allows 1 │ │ │ │ │ +00018350: 3032 3320 6279 7465 7329 2c20 6275 7420 023 bytes), but │ │ │ │ │ +00018360: 796f 7520 6d61 7920 7761 6e74 2074 6f20 you may want to │ │ │ │ │ +00018370: 6c69 6d69 7420 6120 736f 7572 6365 0a74 limit a source.t │ │ │ │ │ +00018380: 6172 6261 6c6c 2074 6f20 6669 6c65 206e arball to file n │ │ │ │ │ +00018390: 616d 6573 206f 6620 3939 2062 7974 6573 ames of 99 bytes │ │ │ │ │ +000183a0: 2074 6f20 6176 6f69 6420 696e 7465 726f to avoid intero │ │ │ │ │ +000183b0: 7065 7261 6269 6c69 7479 2070 726f 626c perability probl │ │ │ │ │ +000183c0: 656d 730a 7769 7468 206f 6c64 2076 6572 ems.with old ver │ │ │ │ │ +000183d0: 7369 6f6e 7320 6f66 2027 7461 7227 2e0a sions of 'tar'.. │ │ │ │ │ +000183e0: 0a20 2020 4966 2079 6f75 2064 6570 6172 . If you depar │ │ │ │ │ +000183f0: 7420 6672 6f6d 2074 6865 7365 2072 756c t from these rul │ │ │ │ │ +00018400: 6573 2028 652e 672e 2c20 6279 2075 7369 es (e.g., by usi │ │ │ │ │ +00018410: 6e67 206e 6f6e 2d41 5343 4949 2063 6861 ng non-ASCII cha │ │ │ │ │ +00018420: 7261 6374 6572 730a 696e 2066 696c 6520 racters.in file │ │ │ │ │ +00018430: 6e61 6d65 732c 206f 7220 6279 2075 7369 names, or by usi │ │ │ │ │ +00018440: 6e67 206c 656e 6774 6879 2066 696c 6520 ng lengthy file │ │ │ │ │ +00018450: 6e61 6d65 7329 2c20 796f 7572 2069 6e73 names), your ins │ │ │ │ │ +00018460: 7461 6c6c 6572 7320 6d61 7920 6861 7665 tallers may have │ │ │ │ │ +00018470: 0a70 726f 626c 656d 7320 666f 7220 7265 .problems for re │ │ │ │ │ +00018480: 6173 6f6e 7320 756e 7265 6c61 7465 6420 asons unrelated │ │ │ │ │ +00018490: 746f 2041 7574 6f6d 616b 652e 2020 486f to Automake. Ho │ │ │ │ │ +000184a0: 7765 7665 722c 2069 6620 7468 6973 2064 wever, if this d │ │ │ │ │ +000184b0: 6f65 7320 6e6f 740a 636f 6e63 6572 6e20 oes not.concern │ │ │ │ │ +000184c0: 796f 752c 2079 6f75 2073 686f 756c 6420 you, you should │ │ │ │ │ +000184d0: 6b6e 6f77 2061 626f 7574 2074 6865 206c know about the l │ │ │ │ │ +000184e0: 696d 6974 6174 696f 6e73 2069 6d70 6f73 imitations impos │ │ │ │ │ +000184f0: 6564 2062 7920 4175 746f 6d61 6b65 0a69 ed by Automake.i │ │ │ │ │ +00018500: 7473 656c 662e 2020 5468 6573 6520 6c69 tself. These li │ │ │ │ │ +00018510: 6d69 7461 7469 6f6e 7320 6172 6520 756e mitations are un │ │ │ │ │ +00018520: 6465 7369 7261 626c 652c 2062 7574 2073 desirable, but s │ │ │ │ │ +00018530: 6f6d 6520 6f66 2074 6865 6d20 7365 656d ome of them seem │ │ │ │ │ +00018540: 2074 6f20 6265 0a69 6e68 6572 656e 7420 to be.inherent │ │ │ │ │ +00018550: 746f 2075 6e64 6572 6c79 696e 6720 746f to underlying to │ │ │ │ │ +00018560: 6f6c 7320 6c69 6b65 2041 7574 6f63 6f6e ols like Autocon │ │ │ │ │ +00018570: 662c 204d 616b 652c 204d 342c 2061 6e64 f, Make, M4, and │ │ │ │ │ +00018580: 2074 6865 2073 6865 6c6c 2e0a 5468 6579 the shell..They │ │ │ │ │ +00018590: 2066 616c 6c20 696e 746f 2074 6872 6565 fall into three │ │ │ │ │ +000185a0: 2063 6174 6567 6f72 6965 733a 2069 6e73 categories: ins │ │ │ │ │ +000185b0: 7461 6c6c 2064 6972 6563 746f 7269 6573 tall directories │ │ │ │ │ +000185c0: 2c20 6275 696c 6420 6469 7265 6374 6f72 , build director │ │ │ │ │ +000185d0: 6965 732c 0a61 6e64 2066 696c 6520 6e61 ies,.and file na │ │ │ │ │ +000185e0: 6d65 732e 0a0a 2020 2054 6865 2066 6f6c mes... The fol │ │ │ │ │ +000185f0: 6c6f 7769 6e67 2063 6861 7261 6374 6572 lowing character │ │ │ │ │ +00018600: 733a 0a0a 2020 2020 206e 6577 6c69 6e65 s:.. newline │ │ │ │ │ +00018610: 2022 2023 2024 2027 2060 0a0a 2020 2073 " # $ ' `.. s │ │ │ │ │ +00018620: 686f 756c 6420 6e6f 7420 6170 7065 6172 hould not appear │ │ │ │ │ +00018630: 2069 6e20 7468 6520 6e61 6d65 7320 6f66 in the names of │ │ │ │ │ +00018640: 2069 6e73 7461 6c6c 2064 6972 6563 746f install directo │ │ │ │ │ +00018650: 7269 6573 2e20 2046 6f72 2065 7861 6d70 ries. For examp │ │ │ │ │ +00018660: 6c65 2c0a 7468 6520 6f70 6572 616e 6420 le,.the operand │ │ │ │ │ +00018670: 6f66 2027 636f 6e66 6967 7572 6527 2773 of 'configure''s │ │ │ │ │ +00018680: 2027 2d2d 7072 6566 6978 2720 6f70 7469 '--prefix' opti │ │ │ │ │ +00018690: 6f6e 2073 686f 756c 6420 6e6f 7420 636f on should not co │ │ │ │ │ +000186a0: 6e74 6169 6e20 7468 6573 650a 6368 6172 ntain these.char │ │ │ │ │ +000186b0: 6163 7465 7273 2e0a 0a20 2020 4275 696c acters... Buil │ │ │ │ │ +000186c0: 6420 6469 7265 6374 6f72 6965 7320 7375 d directories su │ │ │ │ │ +000186d0: 6666 6572 2074 6865 2073 616d 6520 6c69 ffer the same li │ │ │ │ │ +000186e0: 6d69 7461 7469 6f6e 7320 6173 2069 6e73 mitations as ins │ │ │ │ │ +000186f0: 7461 6c6c 2064 6972 6563 746f 7269 6573 tall directories │ │ │ │ │ +00018700: 2c0a 616e 6420 696e 2061 6464 6974 696f ,.and in additio │ │ │ │ │ +00018710: 6e20 7368 6f75 6c64 206e 6f74 2063 6f6e n should not con │ │ │ │ │ +00018720: 7461 696e 2074 6865 2066 6f6c 6c6f 7769 tain the followi │ │ │ │ │ +00018730: 6e67 2063 6861 7261 6374 6572 733a 0a0a ng characters:.. │ │ │ │ │ +00018740: 2020 2020 2026 2040 205c 0a0a 2020 2046 & @ \.. F │ │ │ │ │ +00018750: 6f72 2065 7861 6d70 6c65 2c20 7468 6520 or example, the │ │ │ │ │ +00018760: 6675 6c6c 206e 616d 6520 6f66 2074 6865 full name of the │ │ │ │ │ +00018770: 2064 6972 6563 746f 7279 2063 6f6e 7461 directory conta │ │ │ │ │ +00018780: 696e 696e 6720 7468 6520 736f 7572 6365 ining the source │ │ │ │ │ +00018790: 0a66 696c 6573 2073 686f 756c 6420 6e6f .files should no │ │ │ │ │ +000187a0: 7420 636f 6e74 6169 6e20 7468 6573 6520 t contain these │ │ │ │ │ +000187b0: 6368 6172 6163 7465 7273 2e0a 0a20 2020 characters... │ │ │ │ │ +000187c0: 536f 7572 6365 2061 6e64 2069 6e73 7461 Source and insta │ │ │ │ │ +000187d0: 6c6c 6174 696f 6e20 6669 6c65 206e 616d llation file nam │ │ │ │ │ +000187e0: 6573 206c 696b 6520 276d 6169 6e2e 6327 es like 'main.c' │ │ │ │ │ +000187f0: 2061 7265 206c 696d 6974 6564 2065 7665 are limited eve │ │ │ │ │ +00018800: 6e0a 6675 7274 6865 723a 2074 6865 7920 n.further: they │ │ │ │ │ +00018810: 7368 6f75 6c64 2063 6f6e 666f 726d 2074 should conform t │ │ │ │ │ +00018820: 6f20 7468 6520 504f 5349 582f 584f 5045 o the POSIX/XOPE │ │ │ │ │ +00018830: 4e20 7275 6c65 7320 6465 7363 7269 6265 N rules describe │ │ │ │ │ +00018840: 6420 6162 6f76 652e 0a49 6e20 6164 6469 d above..In addi │ │ │ │ │ +00018850: 7469 6f6e 2c20 6966 2079 6f75 2070 6c61 tion, if you pla │ │ │ │ │ +00018860: 6e20 746f 2070 6f72 7420 746f 206e 6f6e n to port to non │ │ │ │ │ +00018870: 2d50 4f53 4958 2065 6e76 6972 6f6e 6d65 -POSIX environme │ │ │ │ │ +00018880: 6e74 732c 2079 6f75 2073 686f 756c 640a nts, you should. │ │ │ │ │ +00018890: 6176 6f69 6420 6669 6c65 206e 616d 6573 avoid file names │ │ │ │ │ +000188a0: 2074 6861 7420 6469 6666 6572 206f 6e6c that differ onl │ │ │ │ │ +000188b0: 7920 696e 2063 6173 6520 2865 2e67 2e2c y in case (e.g., │ │ │ │ │ +000188c0: 2027 6d61 6b65 6669 6c65 2720 616e 640a 'makefile' and. │ │ │ │ │ +000188d0: 274d 616b 6566 696c 6527 292e 2020 4e6f 'Makefile'). No │ │ │ │ │ +000188e0: 7761 6461 7973 2069 7420 6973 206e 6f20 wadays it is no │ │ │ │ │ +000188f0: 6c6f 6e67 6572 2077 6f72 7468 2077 6f72 longer worth wor │ │ │ │ │ +00018900: 7279 696e 6720 6162 6f75 7420 7468 6520 rying about the │ │ │ │ │ +00018910: 382e 330a 6c69 6d69 7473 206f 6620 444f 8.3.limits of DO │ │ │ │ │ +00018920: 5320 6669 6c65 2073 7973 7465 6d73 2e0a S file systems.. │ │ │ │ │ +00018930: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +00018940: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +00018950: 6465 3a20 6469 7374 636c 6561 6e63 6865 de: distcleanche │ │ │ │ │ +00018960: 636b 2c20 204e 6578 743a 2046 6c61 6720 ck, Next: Flag │ │ │ │ │ +00018970: 5661 7269 6162 6c65 7320 4f72 6465 7269 Variables Orderi │ │ │ │ │ +00018980: 6e67 2c20 2050 7265 763a 204c 696d 6974 ng, Prev: Limit │ │ │ │ │ +00018990: 6174 696f 6e73 206f 6e20 4669 6c65 204e ations on File N │ │ │ │ │ +000189a0: 616d 6573 2c20 2055 703a 2046 4151 0a0a ames, Up: FAQ.. │ │ │ │ │ +000189b0: 3238 2e35 2046 696c 6573 206c 6566 7420 28.5 Files left │ │ │ │ │ +000189c0: 696e 2062 7569 6c64 2064 6972 6563 746f in build directo │ │ │ │ │ +000189d0: 7279 2061 6674 6572 2064 6973 7463 6c65 ry after distcle │ │ │ │ │ +000189e0: 616e 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d an.============= │ │ │ │ │ 000189f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00018a00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00018a10: 3d3d 3d3d 0a0a 5468 6973 2069 7320 6120 ====..This is a │ │ │ │ │ -00018a20: 6469 6167 6e6f 7374 6963 2079 6f75 206d diagnostic you m │ │ │ │ │ -00018a30: 6967 6874 2065 6e63 6f75 6e74 6572 2077 ight encounter w │ │ │ │ │ -00018a40: 6869 6c65 2072 756e 6e69 6e67 2027 6d61 hile running 'ma │ │ │ │ │ -00018a50: 6b65 2064 6973 7463 6865 636b 272e 0a0a ke distcheck'... │ │ │ │ │ -00018a60: 2020 2041 7320 6578 706c 6169 6e65 6420 As explained │ │ │ │ │ -00018a70: 696e 202a 6e6f 7465 2043 6865 636b 696e in *note Checkin │ │ │ │ │ -00018a80: 6720 7468 6520 4469 7374 7269 6275 7469 g the Distributi │ │ │ │ │ -00018a90: 6f6e 3a3a 2c20 276d 616b 6520 6469 7374 on::, 'make dist │ │ │ │ │ -00018aa0: 6368 6563 6b27 0a61 7474 656d 7074 7320 check'.attempts │ │ │ │ │ -00018ab0: 746f 2062 7569 6c64 2061 6e64 2063 6865 to build and che │ │ │ │ │ -00018ac0: 636b 2079 6f75 7220 7061 636b 6167 6520 ck your package │ │ │ │ │ -00018ad0: 666f 7220 6572 726f 7273 206c 696b 6520 for errors like │ │ │ │ │ -00018ae0: 7468 6973 206f 6e65 2e0a 0a20 2020 276d this one... 'm │ │ │ │ │ -00018af0: 616b 6520 6469 7374 6368 6563 6b27 2077 ake distcheck' w │ │ │ │ │ -00018b00: 696c 6c20 7065 7266 6f72 6d20 6120 2756 ill perform a 'V │ │ │ │ │ -00018b10: 5041 5448 2720 6275 696c 6420 6f66 2079 PATH' build of y │ │ │ │ │ -00018b20: 6f75 7220 7061 636b 6167 6520 282a 6e6f our package (*no │ │ │ │ │ -00018b30: 7465 0a56 5041 5448 2042 7569 6c64 733a te.VPATH Builds: │ │ │ │ │ -00018b40: 3a29 2c20 616e 6420 7468 656e 2063 616c :), and then cal │ │ │ │ │ -00018b50: 6c20 276d 616b 6520 6469 7374 636c 6561 l 'make distclea │ │ │ │ │ -00018b60: 6e27 2e20 2046 696c 6573 206c 6566 7420 n'. Files left │ │ │ │ │ -00018b70: 696e 2074 6865 0a62 7569 6c64 2064 6972 in the.build dir │ │ │ │ │ -00018b80: 6563 746f 7279 2061 6674 6572 2027 6d61 ectory after 'ma │ │ │ │ │ -00018b90: 6b65 2064 6973 7463 6c65 616e 2720 6861 ke distclean' ha │ │ │ │ │ -00018ba0: 7320 7275 6e20 6172 6520 6c69 7374 6564 s run are listed │ │ │ │ │ -00018bb0: 2061 6674 6572 2074 6869 730a 6572 726f after this.erro │ │ │ │ │ -00018bc0: 722e 0a0a 2020 2054 6869 7320 6469 6167 r... This diag │ │ │ │ │ -00018bd0: 6e6f 7374 6963 2072 6561 6c6c 7920 636f nostic really co │ │ │ │ │ -00018be0: 7665 7273 2074 776f 206b 696e 6473 206f vers two kinds o │ │ │ │ │ -00018bf0: 6620 6572 726f 7273 3a0a 0a20 2020 2a20 f errors:.. * │ │ │ │ │ -00018c00: 6669 6c65 7320 7468 6174 2061 7265 2066 files that are f │ │ │ │ │ -00018c10: 6f72 676f 7474 656e 2062 7920 6469 7374 orgotten by dist │ │ │ │ │ -00018c20: 636c 6561 6e3b 0a20 2020 2a20 6469 7374 clean;. * dist │ │ │ │ │ -00018c30: 7269 6275 7465 6420 6669 6c65 7320 7468 ributed files th │ │ │ │ │ -00018c40: 6174 2061 7265 2065 7272 6f6e 656f 7573 at are erroneous │ │ │ │ │ -00018c50: 6c79 2072 6562 7569 6c74 2e0a 0a20 2020 ly rebuilt... │ │ │ │ │ -00018c60: 5468 6520 666f 726d 6572 206c 6566 742d The former left- │ │ │ │ │ -00018c70: 6f76 6572 2066 696c 6573 2061 7265 206e over files are n │ │ │ │ │ -00018c80: 6f74 2064 6973 7472 6962 7574 6564 2c20 ot distributed, │ │ │ │ │ -00018c90: 736f 2074 6865 2066 6978 2069 7320 746f so the fix is to │ │ │ │ │ -00018ca0: 206d 6172 6b0a 7468 656d 2066 6f72 2063 mark.them for c │ │ │ │ │ -00018cb0: 6c65 616e 696e 6720 282a 6e6f 7465 2043 leaning (*note C │ │ │ │ │ -00018cc0: 6c65 616e 3a3a 292c 2074 6869 7320 6973 lean::), this is │ │ │ │ │ -00018cd0: 206f 6276 696f 7573 2061 6e64 2064 6f65 obvious and doe │ │ │ │ │ -00018ce0: 736e 2774 2064 6573 6572 7665 0a6d 6f72 sn't deserve.mor │ │ │ │ │ -00018cf0: 6520 6578 706c 616e 6174 696f 6e73 2e0a e explanations.. │ │ │ │ │ -00018d00: 0a20 2020 5468 6520 6c61 7474 6572 2062 . The latter b │ │ │ │ │ -00018d10: 7567 2069 7320 6e6f 7420 616c 7761 7973 ug is not always │ │ │ │ │ -00018d20: 2065 6173 7920 746f 2075 6e64 6572 7374 easy to underst │ │ │ │ │ -00018d30: 616e 6420 616e 6420 6669 782c 2073 6f20 and and fix, so │ │ │ │ │ -00018d40: 6c65 7427 730a 7072 6f63 6565 6420 7769 let's.proceed wi │ │ │ │ │ -00018d50: 7468 2061 6e20 6578 616d 706c 652e 2020 th an example. │ │ │ │ │ -00018d60: 5375 7070 6f73 6520 6f75 7220 7061 636b Suppose our pack │ │ │ │ │ -00018d70: 6167 6520 636f 6e74 6169 6e73 2061 2070 age contains a p │ │ │ │ │ -00018d80: 726f 6772 616d 2066 6f72 0a77 6869 6368 rogram for.which │ │ │ │ │ -00018d90: 2077 6520 7761 6e74 2074 6f20 6275 696c we want to buil │ │ │ │ │ -00018da0: 6420 6120 6d61 6e20 7061 6765 2075 7369 d a man page usi │ │ │ │ │ -00018db0: 6e67 2027 6865 6c70 326d 616e 272e 2020 ng 'help2man'. │ │ │ │ │ -00018dc0: 474e 5520 2768 656c 7032 6d61 6e27 0a70 GNU 'help2man'.p │ │ │ │ │ -00018dd0: 726f 6475 6365 7320 7369 6d70 6c65 206d roduces simple m │ │ │ │ │ -00018de0: 616e 7561 6c20 7061 6765 7320 6672 6f6d anual pages from │ │ │ │ │ -00018df0: 2074 6865 2027 2d2d 6865 6c70 2720 616e the '--help' an │ │ │ │ │ -00018e00: 6420 272d 2d76 6572 7369 6f6e 2720 6f75 d '--version' ou │ │ │ │ │ -00018e10: 7470 7574 206f 660a 6f74 6865 7220 636f tput of.other co │ │ │ │ │ -00018e20: 6d6d 616e 6473 2028 2a6e 6f74 6520 4f76 mmands (*note Ov │ │ │ │ │ -00018e30: 6572 7669 6577 3a20 2868 656c 7032 6d61 erview: (help2ma │ │ │ │ │ -00018e40: 6e29 546f 702e 292e 2020 4265 6361 7573 n)Top.). Becaus │ │ │ │ │ -00018e50: 6520 7765 2064 6f6e 2774 2077 616e 740a e we don't want. │ │ │ │ │ -00018e60: 746f 2066 6f72 6365 206f 7572 2075 7365 to force our use │ │ │ │ │ -00018e70: 7273 2074 6f20 696e 7374 616c 6c20 2768 rs to install 'h │ │ │ │ │ -00018e80: 656c 7032 6d61 6e27 2c20 7765 2064 6563 elp2man', we dec │ │ │ │ │ -00018e90: 6964 6520 746f 2064 6973 7472 6962 7574 ide to distribut │ │ │ │ │ -00018ea0: 6520 7468 650a 6765 6e65 7261 7465 6420 e the.generated │ │ │ │ │ -00018eb0: 6d61 6e20 7061 6765 2075 7369 6e67 2074 man page using t │ │ │ │ │ -00018ec0: 6865 2066 6f6c 6c6f 7769 6e67 2073 6574 he following set │ │ │ │ │ -00018ed0: 7570 2e0a 0a20 2020 2020 2320 5468 6973 up... # This │ │ │ │ │ -00018ee0: 204d 616b 6566 696c 652e 616d 2069 7320 Makefile.am is │ │ │ │ │ -00018ef0: 626f 6775 732e 0a20 2020 2020 6269 6e5f bogus.. bin_ │ │ │ │ │ -00018f00: 5052 4f47 5241 4d53 203d 2066 6f6f 0a20 PROGRAMS = foo. │ │ │ │ │ -00018f10: 2020 2020 666f 6f5f 534f 5552 4345 5320 foo_SOURCES │ │ │ │ │ -00018f20: 3d20 666f 6f2e 630a 2020 2020 2064 6973 = foo.c. dis │ │ │ │ │ -00018f30: 745f 6d61 6e5f 4d41 4e53 203d 2066 6f6f t_man_MANS = foo │ │ │ │ │ -00018f40: 2e31 0a0a 2020 2020 2066 6f6f 2e31 3a20 .1.. foo.1: │ │ │ │ │ -00018f50: 666f 6f24 2845 5845 4558 5429 0a20 2020 foo$(EXEEXT). │ │ │ │ │ -00018f60: 2020 2020 2020 2020 2020 6865 6c70 326d help2m │ │ │ │ │ -00018f70: 616e 202d 2d6f 7574 7075 743d 666f 6f2e an --output=foo. │ │ │ │ │ -00018f80: 3120 2e2f 666f 6f24 2845 5845 4558 5429 1 ./foo$(EXEEXT) │ │ │ │ │ -00018f90: 0a0a 2020 2054 6869 7320 7769 6c6c 2065 .. This will e │ │ │ │ │ -00018fa0: 6666 6563 7469 7665 6c79 2064 6973 7472 ffectively distr │ │ │ │ │ -00018fb0: 6962 7574 6520 7468 6520 6d61 6e20 7061 ibute the man pa │ │ │ │ │ -00018fc0: 6765 2e20 2048 6f77 6576 6572 2c20 276d ge. However, 'm │ │ │ │ │ -00018fd0: 616b 650a 6469 7374 6368 6563 6b27 2077 ake.distcheck' w │ │ │ │ │ -00018fe0: 696c 6c20 6661 696c 2077 6974 683a 0a0a ill fail with:.. │ │ │ │ │ -00018ff0: 2020 2020 2045 5252 4f52 3a20 6669 6c65 ERROR: file │ │ │ │ │ -00019000: 7320 6c65 6674 2069 6e20 6275 696c 6420 s left in build │ │ │ │ │ -00019010: 6469 7265 6374 6f72 7920 6166 7465 7220 directory after │ │ │ │ │ -00019020: 6469 7374 636c 6561 6e3a 0a20 2020 2020 distclean:. │ │ │ │ │ -00019030: 2e2f 666f 6f2e 310a 0a20 2020 5768 7920 ./foo.1.. Why │ │ │ │ │ -00019040: 7761 7320 2766 6f6f 2e31 2720 7265 6275 was 'foo.1' rebu │ │ │ │ │ -00019050: 696c 743f 2020 4265 6361 7573 6520 616c ilt? Because al │ │ │ │ │ -00019060: 7468 6f75 6768 2064 6973 7472 6962 7574 though distribut │ │ │ │ │ -00019070: 6564 2c20 2766 6f6f 2e31 270a 6465 7065 ed, 'foo.1'.depe │ │ │ │ │ -00019080: 6e64 7320 6f6e 2061 206e 6f6e 2d64 6973 nds on a non-dis │ │ │ │ │ -00019090: 7472 6962 7574 6564 2062 7569 6c74 2066 tributed built f │ │ │ │ │ -000190a0: 696c 653a 2027 666f 6f24 2845 5845 4558 ile: 'foo$(EXEEX │ │ │ │ │ -000190b0: 5429 272e 2020 2766 6f6f 2428 4558 4545 T)'. 'foo$(EXEE │ │ │ │ │ -000190c0: 5854 2927 0a69 7320 6275 696c 7420 6279 XT)'.is built by │ │ │ │ │ -000190d0: 2074 6865 2075 7365 722c 2073 6f20 6974 the user, so it │ │ │ │ │ -000190e0: 2077 696c 6c20 616c 7761 7973 2061 7070 will always app │ │ │ │ │ -000190f0: 6561 7220 746f 2062 6520 6e65 7765 7220 ear to be newer │ │ │ │ │ -00019100: 7468 616e 2074 6865 0a64 6973 7472 6962 than the.distrib │ │ │ │ │ -00019110: 7574 6564 2027 666f 6f2e 3127 2e0a 0a20 uted 'foo.1'... │ │ │ │ │ -00019120: 2020 276d 616b 6520 6469 7374 6368 6563 'make distchec │ │ │ │ │ -00019130: 6b27 2063 6175 6768 7420 616e 2069 6e63 k' caught an inc │ │ │ │ │ -00019140: 6f6e 7369 7374 656e 6379 2069 6e20 6f75 onsistency in ou │ │ │ │ │ -00019150: 7220 7061 636b 6167 652e 2020 4f75 7220 r package. Our │ │ │ │ │ -00019160: 696e 7465 6e74 0a77 6173 2074 6f20 6469 intent.was to di │ │ │ │ │ -00019170: 7374 7269 6275 7465 2027 666f 6f2e 3127 stribute 'foo.1' │ │ │ │ │ -00019180: 2073 6f20 7573 6572 7320 646f 206e 6f74 so users do not │ │ │ │ │ -00019190: 206e 6565 6420 746f 2069 6e73 7461 6c6c need to install │ │ │ │ │ -000191a0: 2027 6865 6c70 326d 616e 272c 0a68 6f77 'help2man',.how │ │ │ │ │ -000191b0: 6576 6572 2073 696e 6365 2074 6869 7320 ever since this │ │ │ │ │ -000191c0: 7275 6c65 2063 6175 7365 7320 7468 6973 rule causes this │ │ │ │ │ -000191d0: 2066 696c 6520 746f 2062 6520 616c 7761 file to be alwa │ │ │ │ │ -000191e0: 7973 2072 6562 7569 6c74 2c20 7573 6572 ys rebuilt, user │ │ │ │ │ -000191f0: 730a 5f64 6f5f 206e 6565 6420 2768 656c s._do_ need 'hel │ │ │ │ │ -00019200: 7032 6d61 6e27 2e20 2045 6974 6865 7220 p2man'. Either │ │ │ │ │ -00019210: 7765 2073 686f 756c 6420 656e 7375 7265 we should ensure │ │ │ │ │ -00019220: 2074 6861 7420 2766 6f6f 2e31 2720 6973 that 'foo.1' is │ │ │ │ │ -00019230: 206e 6f74 0a72 6562 7569 6c74 2062 7920 not.rebuilt by │ │ │ │ │ -00019240: 7573 6572 732c 206f 7220 7468 6572 6520 users, or there │ │ │ │ │ -00019250: 6973 206e 6f20 706f 696e 7420 696e 2064 is no point in d │ │ │ │ │ -00019260: 6973 7472 6962 7574 696e 6720 2766 6f6f istributing 'foo │ │ │ │ │ -00019270: 2e31 272e 0a0a 2020 204d 6f72 6520 6765 .1'... More ge │ │ │ │ │ -00019280: 6e65 7261 6c6c 792c 2074 6865 2072 756c nerally, the rul │ │ │ │ │ -00019290: 6520 6973 2074 6861 7420 6469 7374 7269 e is that distri │ │ │ │ │ -000192a0: 6275 7465 6420 6669 6c65 7320 7368 6f75 buted files shou │ │ │ │ │ -000192b0: 6c64 206e 6576 6572 0a64 6570 656e 6420 ld never.depend │ │ │ │ │ -000192c0: 6f6e 206e 6f6e 2d64 6973 7472 6962 7574 on non-distribut │ │ │ │ │ -000192d0: 6564 2062 7569 6c74 2066 696c 6573 2e20 ed built files. │ │ │ │ │ -000192e0: 2049 6620 796f 7520 6469 7374 7269 6275 If you distribu │ │ │ │ │ -000192f0: 7465 2073 6f6d 6574 6869 6e67 0a67 656e te something.gen │ │ │ │ │ -00019300: 6572 6174 6564 2c20 6469 7374 7269 6275 erated, distribu │ │ │ │ │ -00019310: 7465 2069 7473 2073 6f75 7263 6573 2e0a te its sources.. │ │ │ │ │ -00019320: 0a20 2020 4f6e 6520 7761 7920 746f 2066 . One way to f │ │ │ │ │ -00019330: 6978 2074 6865 2061 626f 7665 2065 7861 ix the above exa │ │ │ │ │ -00019340: 6d70 6c65 2c20 7768 696c 6520 7374 696c mple, while stil │ │ │ │ │ -00019350: 6c20 6469 7374 7269 6275 7469 6e67 2027 l distributing ' │ │ │ │ │ -00019360: 666f 6f2e 3127 2069 730a 746f 206e 6f74 foo.1' is.to not │ │ │ │ │ -00019370: 2064 6570 656e 6420 6f6e 2027 666f 6f24 depend on 'foo$ │ │ │ │ │ -00019380: 2845 5845 4558 5429 272e 2020 466f 7220 (EXEEXT)'. For │ │ │ │ │ -00019390: 696e 7374 616e 6365 2c20 6173 7375 6d69 instance, assumi │ │ │ │ │ -000193a0: 6e67 2027 666f 6f20 2d2d 7665 7273 696f ng 'foo --versio │ │ │ │ │ -000193b0: 6e27 0a61 6e64 2027 666f 6f20 2d2d 6865 n'.and 'foo --he │ │ │ │ │ -000193c0: 6c70 2720 646f 206e 6f74 2063 6861 6e67 lp' do not chang │ │ │ │ │ -000193d0: 6520 756e 6c65 7373 2027 666f 6f2e 6327 e unless 'foo.c' │ │ │ │ │ -000193e0: 206f 7220 2763 6f6e 6669 6775 7265 2e61 or 'configure.a │ │ │ │ │ -000193f0: 6327 2063 6861 6e67 652c 0a77 6520 636f c' change,.we co │ │ │ │ │ -00019400: 756c 6420 7772 6974 6520 7468 6520 666f uld write the fo │ │ │ │ │ -00019410: 6c6c 6f77 696e 6720 274d 616b 6566 696c llowing 'Makefil │ │ │ │ │ -00019420: 652e 616d 273a 0a0a 2020 2020 2062 696e e.am':.. bin │ │ │ │ │ -00019430: 5f50 524f 4752 414d 5320 3d20 666f 6f0a _PROGRAMS = foo. │ │ │ │ │ -00019440: 2020 2020 2066 6f6f 5f53 4f55 5243 4553 foo_SOURCES │ │ │ │ │ -00019450: 203d 2066 6f6f 2e63 0a20 2020 2020 6469 = foo.c. di │ │ │ │ │ -00019460: 7374 5f6d 616e 5f4d 414e 5320 3d20 666f st_man_MANS = fo │ │ │ │ │ -00019470: 6f2e 310a 0a20 2020 2020 666f 6f2e 313a o.1.. foo.1: │ │ │ │ │ -00019480: 2066 6f6f 2e63 2024 2874 6f70 5f73 7263 foo.c $(top_src │ │ │ │ │ -00019490: 6469 7229 2f63 6f6e 6669 6775 7265 2e61 dir)/configure.a │ │ │ │ │ -000194a0: 630a 2020 2020 2020 2020 2020 2020 2024 c. $ │ │ │ │ │ -000194b0: 284d 414b 4529 2024 2841 4d5f 4d41 4b45 (MAKE) $(AM_MAKE │ │ │ │ │ -000194c0: 464c 4147 5329 2066 6f6f 2428 4558 4545 FLAGS) foo$(EXEE │ │ │ │ │ -000194d0: 5854 290a 2020 2020 2020 2020 2020 2020 XT). │ │ │ │ │ -000194e0: 2068 656c 7032 6d61 6e20 2d2d 6f75 7470 help2man --outp │ │ │ │ │ -000194f0: 7574 3d66 6f6f 2e31 202e 2f66 6f6f 2428 ut=foo.1 ./foo$( │ │ │ │ │ -00019500: 4558 4545 5854 290a 0a20 2020 5468 6973 EXEEXT).. This │ │ │ │ │ -00019510: 2077 6179 2c20 2766 6f6f 2e31 2720 7769 way, 'foo.1' wi │ │ │ │ │ -00019520: 6c6c 206e 6f74 2067 6574 2072 6562 7569 ll not get rebui │ │ │ │ │ -00019530: 6c74 2065 7665 7279 2074 696d 6520 2766 lt every time 'f │ │ │ │ │ -00019540: 6f6f 2428 4558 4545 5854 2927 0a63 6861 oo$(EXEEXT)'.cha │ │ │ │ │ -00019550: 6e67 6573 2e20 2054 6865 2027 6d61 6b65 nges. The 'make │ │ │ │ │ -00019560: 2720 6361 6c6c 206d 616b 6573 2073 7572 ' call makes sur │ │ │ │ │ -00019570: 6520 2766 6f6f 2428 4558 4545 5854 2927 e 'foo$(EXEEXT)' │ │ │ │ │ -00019580: 2069 7320 7570 2d74 6f2d 6461 7465 2062 is up-to-date b │ │ │ │ │ -00019590: 6566 6f72 650a 2768 656c 7032 6d61 6e27 efore.'help2man' │ │ │ │ │ -000195a0: 2e20 2041 6e6f 7468 6572 2077 6179 2074 . Another way t │ │ │ │ │ -000195b0: 6f20 656e 7375 7265 2074 6869 7320 776f o ensure this wo │ │ │ │ │ -000195c0: 756c 6420 6265 2074 6f20 7573 6520 7365 uld be to use se │ │ │ │ │ -000195d0: 7061 7261 7465 0a64 6972 6563 746f 7269 parate.directori │ │ │ │ │ -000195e0: 6573 2066 6f72 2062 696e 6172 6965 7320 es for binaries │ │ │ │ │ -000195f0: 616e 6420 6d61 6e20 7061 6765 732c 2061 and man pages, a │ │ │ │ │ -00019600: 6e64 2073 6574 2027 5355 4244 4952 5327 nd set 'SUBDIRS' │ │ │ │ │ -00019610: 2073 6f20 7468 6174 0a62 696e 6172 6965 so that.binarie │ │ │ │ │ -00019620: 7320 6172 6520 6275 696c 7420 6265 666f s are built befo │ │ │ │ │ -00019630: 7265 206d 616e 2070 6167 6573 2e0a 0a20 re man pages... │ │ │ │ │ -00019640: 2020 5765 2063 6f75 6c64 2061 6c73 6f20 We could also │ │ │ │ │ -00019650: 6465 6369 6465 206e 6f74 2074 6f20 6469 decide not to di │ │ │ │ │ -00019660: 7374 7269 6275 7465 2027 666f 6f2e 3127 stribute 'foo.1' │ │ │ │ │ -00019670: 2e20 2049 6e20 7468 6973 2063 6173 6520 . In this case │ │ │ │ │ -00019680: 6974 2773 0a66 696e 6520 746f 2068 6176 it's.fine to hav │ │ │ │ │ -00019690: 6520 2766 6f6f 2e31 2720 6465 7065 6e64 e 'foo.1' depend │ │ │ │ │ -000196a0: 656e 7420 7570 6f6e 2027 666f 6f24 2845 ent upon 'foo$(E │ │ │ │ │ -000196b0: 5845 4558 5429 272c 2073 696e 6365 2062 XEEXT)', since b │ │ │ │ │ -000196c0: 6f74 6820 7769 6c6c 2068 6176 650a 746f oth will have.to │ │ │ │ │ -000196d0: 2062 6520 7265 6275 696c 742e 2020 486f be rebuilt. Ho │ │ │ │ │ -000196e0: 7765 7665 7220 6974 2077 6f75 6c64 2062 wever it would b │ │ │ │ │ -000196f0: 6520 696d 706f 7373 6962 6c65 2074 6f20 e impossible to │ │ │ │ │ -00019700: 6275 696c 6420 7468 6520 7061 636b 6167 build the packag │ │ │ │ │ -00019710: 6520 696e 2061 0a63 726f 7373 2d63 6f6d e in a.cross-com │ │ │ │ │ -00019720: 7069 6c61 7469 6f6e 2c20 6265 6361 7573 pilation, becaus │ │ │ │ │ -00019730: 6520 6275 696c 6469 6e67 2027 666f 6f2e e building 'foo. │ │ │ │ │ -00019740: 3127 2069 6e76 6f6c 7665 7320 616e 205f 1' involves an _ │ │ │ │ │ -00019750: 6578 6563 7574 696f 6e5f 206f 660a 2766 execution_ of.'f │ │ │ │ │ -00019760: 6f6f 2428 4558 4545 5854 2927 2e0a 0a20 oo$(EXEEXT)'... │ │ │ │ │ -00019770: 2020 416e 6f74 6865 7220 636f 6e74 6578 Another contex │ │ │ │ │ -00019780: 7420 7768 6572 6520 7375 6368 2065 7272 t where such err │ │ │ │ │ -00019790: 6f72 7320 6172 6520 636f 6d6d 6f6e 2069 ors are common i │ │ │ │ │ -000197a0: 7320 7768 656e 2064 6973 7472 6962 7574 s when distribut │ │ │ │ │ -000197b0: 6564 0a66 696c 6573 2061 7265 2062 7569 ed.files are bui │ │ │ │ │ -000197c0: 6c74 2062 7920 746f 6f6c 7320 7468 6174 lt by tools that │ │ │ │ │ -000197d0: 2061 7265 2062 7569 6c74 2062 7920 7468 are built by th │ │ │ │ │ -000197e0: 6520 7061 636b 6167 652e 2020 5468 6520 e package. The │ │ │ │ │ -000197f0: 7061 7474 6572 6e20 6973 0a73 696d 696c pattern is.simil │ │ │ │ │ -00019800: 6172 3a0a 0a20 2020 2020 6469 7374 7269 ar:.. distri │ │ │ │ │ -00019810: 6275 7465 642d 6669 6c65 3a20 6275 696c buted-file: buil │ │ │ │ │ -00019820: 742d 746f 6f6c 7320 6469 7374 7269 6275 t-tools distribu │ │ │ │ │ -00019830: 7465 642d 736f 7572 6365 730a 2020 2020 ted-sources. │ │ │ │ │ -00019840: 2020 2020 2020 2020 2062 7569 6c64 2d63 build-c │ │ │ │ │ -00019850: 6f6d 6d61 6e64 0a0a 7368 6f75 6c64 2062 ommand..should b │ │ │ │ │ -00019860: 6520 6368 616e 6765 6420 746f 0a0a 2020 e changed to.. │ │ │ │ │ -00019870: 2020 2064 6973 7472 6962 7574 6564 2d66 distributed-f │ │ │ │ │ -00019880: 696c 653a 2064 6973 7472 6962 7574 6564 ile: distributed │ │ │ │ │ -00019890: 2d73 6f75 7263 6573 0a20 2020 2020 2020 -sources. │ │ │ │ │ -000198a0: 2020 2020 2020 2428 4d41 4b45 2920 2428 $(MAKE) $( │ │ │ │ │ -000198b0: 414d 5f4d 414b 4546 4c41 4753 2920 6275 AM_MAKEFLAGS) bu │ │ │ │ │ -000198c0: 696c 742d 746f 6f6c 730a 2020 2020 2020 ilt-tools. │ │ │ │ │ -000198d0: 2020 2020 2020 2062 7569 6c64 2d63 6f6d build-com │ │ │ │ │ -000198e0: 6d61 6e64 0a0a 6f72 2079 6f75 2063 6f75 mand..or you cou │ │ │ │ │ -000198f0: 6c64 2063 686f 6f73 6520 6e6f 7420 746f ld choose not to │ │ │ │ │ -00019900: 2064 6973 7472 6962 7574 6520 2764 6973 distribute 'dis │ │ │ │ │ -00019910: 7472 6962 7574 6564 2d66 696c 6527 2c20 tributed-file', │ │ │ │ │ -00019920: 6966 0a63 726f 7373 2d63 6f6d 7069 6c61 if.cross-compila │ │ │ │ │ -00019930: 7469 6f6e 2064 6f65 7320 6e6f 7420 6d61 tion does not ma │ │ │ │ │ -00019940: 7474 6572 2e0a 0a20 2020 5468 6520 706f tter... The po │ │ │ │ │ -00019950: 696e 7473 206d 6164 6520 7468 726f 7567 ints made throug │ │ │ │ │ -00019960: 6820 7468 6573 6520 6578 616d 706c 6573 h these examples │ │ │ │ │ -00019970: 2061 7265 2077 6f72 7468 2061 2073 756d are worth a sum │ │ │ │ │ -00019980: 6d61 7279 3a0a 0a20 2020 2a20 4469 7374 mary:.. * Dist │ │ │ │ │ -00019990: 7269 6275 7465 6420 6669 6c65 7320 7368 ributed files sh │ │ │ │ │ -000199a0: 6f75 6c64 206e 6576 6572 2064 6570 656e ould never depen │ │ │ │ │ -000199b0: 6420 7570 6f6e 206e 6f6e 2d64 6973 7472 d upon non-distr │ │ │ │ │ -000199c0: 6962 7574 6564 2062 7569 6c74 0a20 2020 ibuted built. │ │ │ │ │ -000199d0: 2020 6669 6c65 732e 0a20 2020 2a20 4469 files.. * Di │ │ │ │ │ -000199e0: 7374 7269 6275 7465 6420 6669 6c65 7320 stributed files │ │ │ │ │ -000199f0: 7368 6f75 6c64 2062 6520 6469 7374 7269 should be distri │ │ │ │ │ -00019a00: 6275 7465 6420 7769 7468 2061 6c6c 2074 buted with all t │ │ │ │ │ -00019a10: 6865 6972 0a20 2020 2020 6465 7065 6e64 heir. depend │ │ │ │ │ -00019a20: 656e 6369 6573 2e0a 2020 202a 2049 6620 encies.. * If │ │ │ │ │ -00019a30: 6120 6669 6c65 2069 7320 5f69 6e74 656e a file is _inten │ │ │ │ │ -00019a40: 6465 645f 2074 6f20 6265 2072 6562 7569 ded_ to be rebui │ │ │ │ │ -00019a50: 6c74 2062 7920 7573 6572 732c 2074 6865 lt by users, the │ │ │ │ │ -00019a60: 6e20 7468 6572 6520 6973 206e 6f0a 2020 n there is no. │ │ │ │ │ -00019a70: 2020 2070 6f69 6e74 2069 6e20 6469 7374 point in dist │ │ │ │ │ -00019a80: 7269 6275 7469 6e67 2069 742e 0a0a 2020 ributing it... │ │ │ │ │ -00019a90: 2046 6f72 2064 6573 7065 7261 7465 2063 For desperate c │ │ │ │ │ -00019aa0: 6173 6573 2c20 6974 2773 2061 6c77 6179 ases, it's alway │ │ │ │ │ -00019ab0: 7320 706f 7373 6962 6c65 2074 6f20 6469 s possible to di │ │ │ │ │ -00019ac0: 7361 626c 6520 7468 6973 2063 6865 636b sable this check │ │ │ │ │ -00019ad0: 2062 790a 7365 7474 696e 6720 2764 6973 by.setting 'dis │ │ │ │ │ -00019ae0: 7463 6c65 616e 6368 6563 6b5f 6c69 7374 tcleancheck_list │ │ │ │ │ -00019af0: 6669 6c65 7327 2061 7320 646f 6375 6d65 files' as docume │ │ │ │ │ -00019b00: 6e74 6564 2069 6e20 2a6e 6f74 6520 4368 nted in *note Ch │ │ │ │ │ -00019b10: 6563 6b69 6e67 2074 6865 0a44 6973 7472 ecking the.Distr │ │ │ │ │ -00019b20: 6962 7574 696f 6e3a 3a2e 2020 4d61 6b65 ibution::. Make │ │ │ │ │ -00019b30: 2073 7572 6520 796f 7520 646f 2075 6e64 sure you do und │ │ │ │ │ -00019b40: 6572 7374 616e 6420 7468 6520 7265 6173 erstand the reas │ │ │ │ │ -00019b50: 6f6e 2077 6879 2027 6d61 6b65 0a64 6973 on why 'make.dis │ │ │ │ │ -00019b60: 7463 6865 636b 2720 636f 6d70 6c61 696e tcheck' complain │ │ │ │ │ -00019b70: 7320 6265 666f 7265 2079 6f75 2064 6f20 s before you do │ │ │ │ │ -00019b80: 7468 6973 2e20 2027 6469 7374 636c 6561 this. 'distclea │ │ │ │ │ -00019b90: 6e63 6865 636b 5f6c 6973 7466 696c 6573 ncheck_listfiles │ │ │ │ │ -00019ba0: 2720 6973 0a61 2077 6179 2074 6f20 5f68 ' is.a way to _h │ │ │ │ │ -00019bb0: 6964 655f 2065 7272 6f72 732c 206e 6f74 ide_ errors, not │ │ │ │ │ -00019bc0: 2074 6f20 6669 7820 7468 656d 2e20 2059 to fix them. Y │ │ │ │ │ -00019bd0: 6f75 2063 616e 2061 6c77 6179 7320 646f ou can always do │ │ │ │ │ -00019be0: 2062 6574 7465 722e 0a0a 1f0a 4669 6c65 better.....File │ │ │ │ │ -00019bf0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -00019c00: 696e 666f 2c20 204e 6f64 653a 2046 6c61 info, Node: Fla │ │ │ │ │ -00019c10: 6720 5661 7269 6162 6c65 7320 4f72 6465 g Variables Orde │ │ │ │ │ -00019c20: 7269 6e67 2c20 204e 6578 743a 2052 656e ring, Next: Ren │ │ │ │ │ -00019c30: 616d 6564 204f 626a 6563 7473 2c20 2050 amed Objects, P │ │ │ │ │ -00019c40: 7265 763a 2064 6973 7463 6c65 616e 6368 rev: distcleanch │ │ │ │ │ -00019c50: 6563 6b2c 2020 5570 3a20 4641 510a 0a32 eck, Up: FAQ..2 │ │ │ │ │ -00019c60: 382e 3620 466c 6167 2056 6172 6961 626c 8.6 Flag Variabl │ │ │ │ │ -00019c70: 6573 204f 7264 6572 696e 670a 3d3d 3d3d es Ordering.==== │ │ │ │ │ +00018a10: 3d3d 3d3d 3d0a 0a54 6869 7320 6973 2061 =====..This is a │ │ │ │ │ +00018a20: 2064 6961 676e 6f73 7469 6320 796f 7520 diagnostic you │ │ │ │ │ +00018a30: 6d69 6768 7420 656e 636f 756e 7465 7220 might encounter │ │ │ │ │ +00018a40: 7768 696c 6520 7275 6e6e 696e 6720 276d while running 'm │ │ │ │ │ +00018a50: 616b 6520 6469 7374 6368 6563 6b27 2e0a ake distcheck'.. │ │ │ │ │ +00018a60: 0a20 2020 4173 2065 7870 6c61 696e 6564 . As explained │ │ │ │ │ +00018a70: 2069 6e20 2a6e 6f74 6520 4368 6563 6b69 in *note Checki │ │ │ │ │ +00018a80: 6e67 2074 6865 2044 6973 7472 6962 7574 ng the Distribut │ │ │ │ │ +00018a90: 696f 6e3a 3a2c 2027 6d61 6b65 2064 6973 ion::, 'make dis │ │ │ │ │ +00018aa0: 7463 6865 636b 270a 6174 7465 6d70 7473 tcheck'.attempts │ │ │ │ │ +00018ab0: 2074 6f20 6275 696c 6420 616e 6420 6368 to build and ch │ │ │ │ │ +00018ac0: 6563 6b20 796f 7572 2070 6163 6b61 6765 eck your package │ │ │ │ │ +00018ad0: 2066 6f72 2065 7272 6f72 7320 6c69 6b65 for errors like │ │ │ │ │ +00018ae0: 2074 6869 7320 6f6e 652e 0a0a 2020 2027 this one... ' │ │ │ │ │ +00018af0: 6d61 6b65 2064 6973 7463 6865 636b 2720 make distcheck' │ │ │ │ │ +00018b00: 7769 6c6c 2070 6572 666f 726d 2061 2027 will perform a ' │ │ │ │ │ +00018b10: 5650 4154 4827 2062 7569 6c64 206f 6620 VPATH' build of │ │ │ │ │ +00018b20: 796f 7572 2070 6163 6b61 6765 2028 2a6e your package (*n │ │ │ │ │ +00018b30: 6f74 650a 5650 4154 4820 4275 696c 6473 ote.VPATH Builds │ │ │ │ │ +00018b40: 3a3a 292c 2061 6e64 2074 6865 6e20 6361 ::), and then ca │ │ │ │ │ +00018b50: 6c6c 2027 6d61 6b65 2064 6973 7463 6c65 ll 'make distcle │ │ │ │ │ +00018b60: 616e 272e 2020 4669 6c65 7320 6c65 6674 an'. Files left │ │ │ │ │ +00018b70: 2069 6e20 7468 650a 6275 696c 6420 6469 in the.build di │ │ │ │ │ +00018b80: 7265 6374 6f72 7920 6166 7465 7220 276d rectory after 'm │ │ │ │ │ +00018b90: 616b 6520 6469 7374 636c 6561 6e27 2068 ake distclean' h │ │ │ │ │ +00018ba0: 6173 2072 756e 2061 7265 206c 6973 7465 as run are liste │ │ │ │ │ +00018bb0: 6420 6166 7465 7220 7468 6973 0a65 7272 d after this.err │ │ │ │ │ +00018bc0: 6f72 2e0a 0a20 2020 5468 6973 2064 6961 or... This dia │ │ │ │ │ +00018bd0: 676e 6f73 7469 6320 7265 616c 6c79 2063 gnostic really c │ │ │ │ │ +00018be0: 6f76 6572 7320 7477 6f20 6b69 6e64 7320 overs two kinds │ │ │ │ │ +00018bf0: 6f66 2065 7272 6f72 733a 0a0a 2020 202a of errors:.. * │ │ │ │ │ +00018c00: 2066 696c 6573 2074 6861 7420 6172 6520 files that are │ │ │ │ │ +00018c10: 666f 7267 6f74 7465 6e20 6279 2064 6973 forgotten by dis │ │ │ │ │ +00018c20: 7463 6c65 616e 3b0a 2020 202a 2064 6973 tclean;. * dis │ │ │ │ │ +00018c30: 7472 6962 7574 6564 2066 696c 6573 2074 tributed files t │ │ │ │ │ +00018c40: 6861 7420 6172 6520 6572 726f 6e65 6f75 hat are erroneou │ │ │ │ │ +00018c50: 736c 7920 7265 6275 696c 742e 0a0a 2020 sly rebuilt... │ │ │ │ │ +00018c60: 2054 6865 2066 6f72 6d65 7220 6c65 6674 The former left │ │ │ │ │ +00018c70: 2d6f 7665 7220 6669 6c65 7320 6172 6520 -over files are │ │ │ │ │ +00018c80: 6e6f 7420 6469 7374 7269 6275 7465 642c not distributed, │ │ │ │ │ +00018c90: 2073 6f20 7468 6520 6669 7820 6973 2074 so the fix is t │ │ │ │ │ +00018ca0: 6f20 6d61 726b 0a74 6865 6d20 666f 7220 o mark.them for │ │ │ │ │ +00018cb0: 636c 6561 6e69 6e67 2028 2a6e 6f74 6520 cleaning (*note │ │ │ │ │ +00018cc0: 436c 6561 6e3a 3a29 2c20 7468 6973 2069 Clean::), this i │ │ │ │ │ +00018cd0: 7320 6f62 7669 6f75 7320 616e 6420 646f s obvious and do │ │ │ │ │ +00018ce0: 6573 6e27 7420 6465 7365 7276 650a 6d6f esn't deserve.mo │ │ │ │ │ +00018cf0: 7265 2065 7870 6c61 6e61 7469 6f6e 732e re explanations. │ │ │ │ │ +00018d00: 0a0a 2020 2054 6865 206c 6174 7465 7220 .. The latter │ │ │ │ │ +00018d10: 6275 6720 6973 206e 6f74 2061 6c77 6179 bug is not alway │ │ │ │ │ +00018d20: 7320 6561 7379 2074 6f20 756e 6465 7273 s easy to unders │ │ │ │ │ +00018d30: 7461 6e64 2061 6e64 2066 6978 2c20 736f tand and fix, so │ │ │ │ │ +00018d40: 206c 6574 2773 0a70 726f 6365 6564 2077 let's.proceed w │ │ │ │ │ +00018d50: 6974 6820 616e 2065 7861 6d70 6c65 2e20 ith an example. │ │ │ │ │ +00018d60: 2053 7570 706f 7365 206f 7572 2070 6163 Suppose our pac │ │ │ │ │ +00018d70: 6b61 6765 2063 6f6e 7461 696e 7320 6120 kage contains a │ │ │ │ │ +00018d80: 7072 6f67 7261 6d20 666f 720a 7768 6963 program for.whic │ │ │ │ │ +00018d90: 6820 7765 2077 616e 7420 746f 2062 7569 h we want to bui │ │ │ │ │ +00018da0: 6c64 2061 206d 616e 2070 6167 6520 7573 ld a man page us │ │ │ │ │ +00018db0: 696e 6720 2768 656c 7032 6d61 6e27 2e20 ing 'help2man'. │ │ │ │ │ +00018dc0: 2047 4e55 2027 6865 6c70 326d 616e 270a GNU 'help2man'. │ │ │ │ │ +00018dd0: 7072 6f64 7563 6573 2073 696d 706c 6520 produces simple │ │ │ │ │ +00018de0: 6d61 6e75 616c 2070 6167 6573 2066 726f manual pages fro │ │ │ │ │ +00018df0: 6d20 7468 6520 272d 2d68 656c 7027 2061 m the '--help' a │ │ │ │ │ +00018e00: 6e64 2027 2d2d 7665 7273 696f 6e27 206f nd '--version' o │ │ │ │ │ +00018e10: 7574 7075 7420 6f66 0a6f 7468 6572 2063 utput of.other c │ │ │ │ │ +00018e20: 6f6d 6d61 6e64 7320 282a 6e6f 7465 204f ommands (*note O │ │ │ │ │ +00018e30: 7665 7276 6965 773a 2028 6865 6c70 326d verview: (help2m │ │ │ │ │ +00018e40: 616e 2954 6f70 2e29 2e20 2042 6563 6175 an)Top.). Becau │ │ │ │ │ +00018e50: 7365 2077 6520 646f 6e27 7420 7761 6e74 se we don't want │ │ │ │ │ +00018e60: 0a74 6f20 666f 7263 6520 6f75 7220 7573 .to force our us │ │ │ │ │ +00018e70: 6572 7320 746f 2069 6e73 7461 6c6c 2027 ers to install ' │ │ │ │ │ +00018e80: 6865 6c70 326d 616e 272c 2077 6520 6465 help2man', we de │ │ │ │ │ +00018e90: 6369 6465 2074 6f20 6469 7374 7269 6275 cide to distribu │ │ │ │ │ +00018ea0: 7465 2074 6865 0a67 656e 6572 6174 6564 te the.generated │ │ │ │ │ +00018eb0: 206d 616e 2070 6167 6520 7573 696e 6720 man page using │ │ │ │ │ +00018ec0: 7468 6520 666f 6c6c 6f77 696e 6720 7365 the following se │ │ │ │ │ +00018ed0: 7475 702e 0a0a 2020 2020 2023 2054 6869 tup... # Thi │ │ │ │ │ +00018ee0: 7320 4d61 6b65 6669 6c65 2e61 6d20 6973 s Makefile.am is │ │ │ │ │ +00018ef0: 2062 6f67 7573 2e0a 2020 2020 2062 696e bogus.. bin │ │ │ │ │ +00018f00: 5f50 524f 4752 414d 5320 3d20 666f 6f0a _PROGRAMS = foo. │ │ │ │ │ +00018f10: 2020 2020 2066 6f6f 5f53 4f55 5243 4553 foo_SOURCES │ │ │ │ │ +00018f20: 203d 2066 6f6f 2e63 0a20 2020 2020 6469 = foo.c. di │ │ │ │ │ +00018f30: 7374 5f6d 616e 5f4d 414e 5320 3d20 666f st_man_MANS = fo │ │ │ │ │ +00018f40: 6f2e 310a 0a20 2020 2020 666f 6f2e 313a o.1.. foo.1: │ │ │ │ │ +00018f50: 2066 6f6f 2428 4558 4545 5854 290a 2020 foo$(EXEEXT). │ │ │ │ │ +00018f60: 2020 2020 2020 2020 2020 2068 656c 7032 help2 │ │ │ │ │ +00018f70: 6d61 6e20 2d2d 6f75 7470 7574 3d66 6f6f man --output=foo │ │ │ │ │ +00018f80: 2e31 202e 2f66 6f6f 2428 4558 4545 5854 .1 ./foo$(EXEEXT │ │ │ │ │ +00018f90: 290a 0a20 2020 5468 6973 2077 696c 6c20 ).. This will │ │ │ │ │ +00018fa0: 6566 6665 6374 6976 656c 7920 6469 7374 effectively dist │ │ │ │ │ +00018fb0: 7269 6275 7465 2074 6865 206d 616e 2070 ribute the man p │ │ │ │ │ +00018fc0: 6167 652e 2020 486f 7765 7665 722c 2027 age. However, ' │ │ │ │ │ +00018fd0: 6d61 6b65 0a64 6973 7463 6865 636b 2720 make.distcheck' │ │ │ │ │ +00018fe0: 7769 6c6c 2066 6169 6c20 7769 7468 3a0a will fail with:. │ │ │ │ │ +00018ff0: 0a20 2020 2020 4552 524f 523a 2066 696c . ERROR: fil │ │ │ │ │ +00019000: 6573 206c 6566 7420 696e 2062 7569 6c64 es left in build │ │ │ │ │ +00019010: 2064 6972 6563 746f 7279 2061 6674 6572 directory after │ │ │ │ │ +00019020: 2064 6973 7463 6c65 616e 3a0a 2020 2020 distclean:. │ │ │ │ │ +00019030: 202e 2f66 6f6f 2e31 0a0a 2020 2057 6879 ./foo.1.. Why │ │ │ │ │ +00019040: 2077 6173 2027 666f 6f2e 3127 2072 6562 was 'foo.1' reb │ │ │ │ │ +00019050: 7569 6c74 3f20 2042 6563 6175 7365 2061 uilt? Because a │ │ │ │ │ +00019060: 6c74 686f 7567 6820 6469 7374 7269 6275 lthough distribu │ │ │ │ │ +00019070: 7465 642c 2027 666f 6f2e 3127 0a64 6570 ted, 'foo.1'.dep │ │ │ │ │ +00019080: 656e 6473 206f 6e20 6120 6e6f 6e2d 6469 ends on a non-di │ │ │ │ │ +00019090: 7374 7269 6275 7465 6420 6275 696c 7420 stributed built │ │ │ │ │ +000190a0: 6669 6c65 3a20 2766 6f6f 2428 4558 4545 file: 'foo$(EXEE │ │ │ │ │ +000190b0: 5854 2927 2e20 2027 666f 6f24 2845 5845 XT)'. 'foo$(EXE │ │ │ │ │ +000190c0: 4558 5429 270a 6973 2062 7569 6c74 2062 EXT)'.is built b │ │ │ │ │ +000190d0: 7920 7468 6520 7573 6572 2c20 736f 2069 y the user, so i │ │ │ │ │ +000190e0: 7420 7769 6c6c 2061 6c77 6179 7320 6170 t will always ap │ │ │ │ │ +000190f0: 7065 6172 2074 6f20 6265 206e 6577 6572 pear to be newer │ │ │ │ │ +00019100: 2074 6861 6e20 7468 650a 6469 7374 7269 than the.distri │ │ │ │ │ +00019110: 6275 7465 6420 2766 6f6f 2e31 272e 0a0a buted 'foo.1'... │ │ │ │ │ +00019120: 2020 2027 6d61 6b65 2064 6973 7463 6865 'make distche │ │ │ │ │ +00019130: 636b 2720 6361 7567 6874 2061 6e20 696e ck' caught an in │ │ │ │ │ +00019140: 636f 6e73 6973 7465 6e63 7920 696e 206f consistency in o │ │ │ │ │ +00019150: 7572 2070 6163 6b61 6765 2e20 204f 7572 ur package. Our │ │ │ │ │ +00019160: 2069 6e74 656e 740a 7761 7320 746f 2064 intent.was to d │ │ │ │ │ +00019170: 6973 7472 6962 7574 6520 2766 6f6f 2e31 istribute 'foo.1 │ │ │ │ │ +00019180: 2720 736f 2075 7365 7273 2064 6f20 6e6f ' so users do no │ │ │ │ │ +00019190: 7420 6e65 6564 2074 6f20 696e 7374 616c t need to instal │ │ │ │ │ +000191a0: 6c20 2768 656c 7032 6d61 6e27 2c0a 686f l 'help2man',.ho │ │ │ │ │ +000191b0: 7765 7665 7220 7369 6e63 6520 7468 6973 wever since this │ │ │ │ │ +000191c0: 2072 756c 6520 6361 7573 6573 2074 6869 rule causes thi │ │ │ │ │ +000191d0: 7320 6669 6c65 2074 6f20 6265 2061 6c77 s file to be alw │ │ │ │ │ +000191e0: 6179 7320 7265 6275 696c 742c 2075 7365 ays rebuilt, use │ │ │ │ │ +000191f0: 7273 0a5f 646f 5f20 6e65 6564 2027 6865 rs._do_ need 'he │ │ │ │ │ +00019200: 6c70 326d 616e 272e 2020 4569 7468 6572 lp2man'. Either │ │ │ │ │ +00019210: 2077 6520 7368 6f75 6c64 2065 6e73 7572 we should ensur │ │ │ │ │ +00019220: 6520 7468 6174 2027 666f 6f2e 3127 2069 e that 'foo.1' i │ │ │ │ │ +00019230: 7320 6e6f 740a 7265 6275 696c 7420 6279 s not.rebuilt by │ │ │ │ │ +00019240: 2075 7365 7273 2c20 6f72 2074 6865 7265 users, or there │ │ │ │ │ +00019250: 2069 7320 6e6f 2070 6f69 6e74 2069 6e20 is no point in │ │ │ │ │ +00019260: 6469 7374 7269 6275 7469 6e67 2027 666f distributing 'fo │ │ │ │ │ +00019270: 6f2e 3127 2e0a 0a20 2020 4d6f 7265 2067 o.1'... More g │ │ │ │ │ +00019280: 656e 6572 616c 6c79 2c20 7468 6520 7275 enerally, the ru │ │ │ │ │ +00019290: 6c65 2069 7320 7468 6174 2064 6973 7472 le is that distr │ │ │ │ │ +000192a0: 6962 7574 6564 2066 696c 6573 2073 686f ibuted files sho │ │ │ │ │ +000192b0: 756c 6420 6e65 7665 720a 6465 7065 6e64 uld never.depend │ │ │ │ │ +000192c0: 206f 6e20 6e6f 6e2d 6469 7374 7269 6275 on non-distribu │ │ │ │ │ +000192d0: 7465 6420 6275 696c 7420 6669 6c65 732e ted built files. │ │ │ │ │ +000192e0: 2020 4966 2079 6f75 2064 6973 7472 6962 If you distrib │ │ │ │ │ +000192f0: 7574 6520 736f 6d65 7468 696e 670a 6765 ute something.ge │ │ │ │ │ +00019300: 6e65 7261 7465 642c 2064 6973 7472 6962 nerated, distrib │ │ │ │ │ +00019310: 7574 6520 6974 7320 736f 7572 6365 732e ute its sources. │ │ │ │ │ +00019320: 0a0a 2020 204f 6e65 2077 6179 2074 6f20 .. One way to │ │ │ │ │ +00019330: 6669 7820 7468 6520 6162 6f76 6520 6578 fix the above ex │ │ │ │ │ +00019340: 616d 706c 652c 2077 6869 6c65 2073 7469 ample, while sti │ │ │ │ │ +00019350: 6c6c 2064 6973 7472 6962 7574 696e 6720 ll distributing │ │ │ │ │ +00019360: 2766 6f6f 2e31 2720 6973 0a74 6f20 6e6f 'foo.1' is.to no │ │ │ │ │ +00019370: 7420 6465 7065 6e64 206f 6e20 2766 6f6f t depend on 'foo │ │ │ │ │ +00019380: 2428 4558 4545 5854 2927 2e20 2046 6f72 $(EXEEXT)'. For │ │ │ │ │ +00019390: 2069 6e73 7461 6e63 652c 2061 7373 756d instance, assum │ │ │ │ │ +000193a0: 696e 6720 2766 6f6f 202d 2d76 6572 7369 ing 'foo --versi │ │ │ │ │ +000193b0: 6f6e 270a 616e 6420 2766 6f6f 202d 2d68 on'.and 'foo --h │ │ │ │ │ +000193c0: 656c 7027 2064 6f20 6e6f 7420 6368 616e elp' do not chan │ │ │ │ │ +000193d0: 6765 2075 6e6c 6573 7320 2766 6f6f 2e63 ge unless 'foo.c │ │ │ │ │ +000193e0: 2720 6f72 2027 636f 6e66 6967 7572 652e ' or 'configure. │ │ │ │ │ +000193f0: 6163 2720 6368 616e 6765 2c0a 7765 2063 ac' change,.we c │ │ │ │ │ +00019400: 6f75 6c64 2077 7269 7465 2074 6865 2066 ould write the f │ │ │ │ │ +00019410: 6f6c 6c6f 7769 6e67 2027 4d61 6b65 6669 ollowing 'Makefi │ │ │ │ │ +00019420: 6c65 2e61 6d27 3a0a 0a20 2020 2020 6269 le.am':.. bi │ │ │ │ │ +00019430: 6e5f 5052 4f47 5241 4d53 203d 2066 6f6f n_PROGRAMS = foo │ │ │ │ │ +00019440: 0a20 2020 2020 666f 6f5f 534f 5552 4345 . foo_SOURCE │ │ │ │ │ +00019450: 5320 3d20 666f 6f2e 630a 2020 2020 2064 S = foo.c. d │ │ │ │ │ +00019460: 6973 745f 6d61 6e5f 4d41 4e53 203d 2066 ist_man_MANS = f │ │ │ │ │ +00019470: 6f6f 2e31 0a0a 2020 2020 2066 6f6f 2e31 oo.1.. foo.1 │ │ │ │ │ +00019480: 3a20 666f 6f2e 6320 2428 746f 705f 7372 : foo.c $(top_sr │ │ │ │ │ +00019490: 6364 6972 292f 636f 6e66 6967 7572 652e cdir)/configure. │ │ │ │ │ +000194a0: 6163 0a20 2020 2020 2020 2020 2020 2020 ac. │ │ │ │ │ +000194b0: 2428 4d41 4b45 2920 2428 414d 5f4d 414b $(MAKE) $(AM_MAK │ │ │ │ │ +000194c0: 4546 4c41 4753 2920 666f 6f24 2845 5845 EFLAGS) foo$(EXE │ │ │ │ │ +000194d0: 4558 5429 0a20 2020 2020 2020 2020 2020 EXT). │ │ │ │ │ +000194e0: 2020 6865 6c70 326d 616e 202d 2d6f 7574 help2man --out │ │ │ │ │ +000194f0: 7075 743d 666f 6f2e 3120 2e2f 666f 6f24 put=foo.1 ./foo$ │ │ │ │ │ +00019500: 2845 5845 4558 5429 0a0a 2020 2054 6869 (EXEEXT).. Thi │ │ │ │ │ +00019510: 7320 7761 792c 2027 666f 6f2e 3127 2077 s way, 'foo.1' w │ │ │ │ │ +00019520: 696c 6c20 6e6f 7420 6765 7420 7265 6275 ill not get rebu │ │ │ │ │ +00019530: 696c 7420 6576 6572 7920 7469 6d65 2027 ilt every time ' │ │ │ │ │ +00019540: 666f 6f24 2845 5845 4558 5429 270a 6368 foo$(EXEEXT)'.ch │ │ │ │ │ +00019550: 616e 6765 732e 2020 5468 6520 276d 616b anges. The 'mak │ │ │ │ │ +00019560: 6527 2063 616c 6c20 6d61 6b65 7320 7375 e' call makes su │ │ │ │ │ +00019570: 7265 2027 666f 6f24 2845 5845 4558 5429 re 'foo$(EXEEXT) │ │ │ │ │ +00019580: 2720 6973 2075 702d 746f 2d64 6174 6520 ' is up-to-date │ │ │ │ │ +00019590: 6265 666f 7265 0a27 6865 6c70 326d 616e before.'help2man │ │ │ │ │ +000195a0: 272e 2020 416e 6f74 6865 7220 7761 7920 '. Another way │ │ │ │ │ +000195b0: 746f 2065 6e73 7572 6520 7468 6973 2077 to ensure this w │ │ │ │ │ +000195c0: 6f75 6c64 2062 6520 746f 2075 7365 2073 ould be to use s │ │ │ │ │ +000195d0: 6570 6172 6174 650a 6469 7265 6374 6f72 eparate.director │ │ │ │ │ +000195e0: 6965 7320 666f 7220 6269 6e61 7269 6573 ies for binaries │ │ │ │ │ +000195f0: 2061 6e64 206d 616e 2070 6167 6573 2c20 and man pages, │ │ │ │ │ +00019600: 616e 6420 7365 7420 2753 5542 4449 5253 and set 'SUBDIRS │ │ │ │ │ +00019610: 2720 736f 2074 6861 740a 6269 6e61 7269 ' so that.binari │ │ │ │ │ +00019620: 6573 2061 7265 2062 7569 6c74 2062 6566 es are built bef │ │ │ │ │ +00019630: 6f72 6520 6d61 6e20 7061 6765 732e 0a0a ore man pages... │ │ │ │ │ +00019640: 2020 2057 6520 636f 756c 6420 616c 736f We could also │ │ │ │ │ +00019650: 2064 6563 6964 6520 6e6f 7420 746f 2064 decide not to d │ │ │ │ │ +00019660: 6973 7472 6962 7574 6520 2766 6f6f 2e31 istribute 'foo.1 │ │ │ │ │ +00019670: 272e 2020 496e 2074 6869 7320 6361 7365 '. In this case │ │ │ │ │ +00019680: 2069 7427 730a 6669 6e65 2074 6f20 6861 it's.fine to ha │ │ │ │ │ +00019690: 7665 2027 666f 6f2e 3127 2064 6570 656e ve 'foo.1' depen │ │ │ │ │ +000196a0: 6465 6e74 2075 706f 6e20 2766 6f6f 2428 dent upon 'foo$( │ │ │ │ │ +000196b0: 4558 4545 5854 2927 2c20 7369 6e63 6520 EXEEXT)', since │ │ │ │ │ +000196c0: 626f 7468 2077 696c 6c20 6861 7665 0a74 both will have.t │ │ │ │ │ +000196d0: 6f20 6265 2072 6562 7569 6c74 2e20 2048 o be rebuilt. H │ │ │ │ │ +000196e0: 6f77 6576 6572 2069 7420 776f 756c 6420 owever it would │ │ │ │ │ +000196f0: 6265 2069 6d70 6f73 7369 626c 6520 746f be impossible to │ │ │ │ │ +00019700: 2062 7569 6c64 2074 6865 2070 6163 6b61 build the packa │ │ │ │ │ +00019710: 6765 2069 6e20 610a 6372 6f73 732d 636f ge in a.cross-co │ │ │ │ │ +00019720: 6d70 696c 6174 696f 6e2c 2062 6563 6175 mpilation, becau │ │ │ │ │ +00019730: 7365 2062 7569 6c64 696e 6720 2766 6f6f se building 'foo │ │ │ │ │ +00019740: 2e31 2720 696e 766f 6c76 6573 2061 6e20 .1' involves an │ │ │ │ │ +00019750: 5f65 7865 6375 7469 6f6e 5f20 6f66 0a27 _execution_ of.' │ │ │ │ │ +00019760: 666f 6f24 2845 5845 4558 5429 272e 0a0a foo$(EXEEXT)'... │ │ │ │ │ +00019770: 2020 2041 6e6f 7468 6572 2063 6f6e 7465 Another conte │ │ │ │ │ +00019780: 7874 2077 6865 7265 2073 7563 6820 6572 xt where such er │ │ │ │ │ +00019790: 726f 7273 2061 7265 2063 6f6d 6d6f 6e20 rors are common │ │ │ │ │ +000197a0: 6973 2077 6865 6e20 6469 7374 7269 6275 is when distribu │ │ │ │ │ +000197b0: 7465 640a 6669 6c65 7320 6172 6520 6275 ted.files are bu │ │ │ │ │ +000197c0: 696c 7420 6279 2074 6f6f 6c73 2074 6861 ilt by tools tha │ │ │ │ │ +000197d0: 7420 6172 6520 6275 696c 7420 6279 2074 t are built by t │ │ │ │ │ +000197e0: 6865 2070 6163 6b61 6765 2e20 2054 6865 he package. The │ │ │ │ │ +000197f0: 2070 6174 7465 726e 2069 730a 7369 6d69 pattern is.simi │ │ │ │ │ +00019800: 6c61 723a 0a0a 2020 2020 2064 6973 7472 lar:.. distr │ │ │ │ │ +00019810: 6962 7574 6564 2d66 696c 653a 2062 7569 ibuted-file: bui │ │ │ │ │ +00019820: 6c74 2d74 6f6f 6c73 2064 6973 7472 6962 lt-tools distrib │ │ │ │ │ +00019830: 7574 6564 2d73 6f75 7263 6573 0a20 2020 uted-sources. │ │ │ │ │ +00019840: 2020 2020 2020 2020 2020 6275 696c 642d build- │ │ │ │ │ +00019850: 636f 6d6d 616e 640a 0a73 686f 756c 6420 command..should │ │ │ │ │ +00019860: 6265 2063 6861 6e67 6564 2074 6f0a 0a20 be changed to.. │ │ │ │ │ +00019870: 2020 2020 6469 7374 7269 6275 7465 642d distributed- │ │ │ │ │ +00019880: 6669 6c65 3a20 6469 7374 7269 6275 7465 file: distribute │ │ │ │ │ +00019890: 642d 736f 7572 6365 730a 2020 2020 2020 d-sources. │ │ │ │ │ +000198a0: 2020 2020 2020 2024 284d 414b 4529 2024 $(MAKE) $ │ │ │ │ │ +000198b0: 2841 4d5f 4d41 4b45 464c 4147 5329 2062 (AM_MAKEFLAGS) b │ │ │ │ │ +000198c0: 7569 6c74 2d74 6f6f 6c73 0a20 2020 2020 uilt-tools. │ │ │ │ │ +000198d0: 2020 2020 2020 2020 6275 696c 642d 636f build-co │ │ │ │ │ +000198e0: 6d6d 616e 640a 0a6f 7220 796f 7520 636f mmand..or you co │ │ │ │ │ +000198f0: 756c 6420 6368 6f6f 7365 206e 6f74 2074 uld choose not t │ │ │ │ │ +00019900: 6f20 6469 7374 7269 6275 7465 2027 6469 o distribute 'di │ │ │ │ │ +00019910: 7374 7269 6275 7465 642d 6669 6c65 272c stributed-file', │ │ │ │ │ +00019920: 2069 660a 6372 6f73 732d 636f 6d70 696c if.cross-compil │ │ │ │ │ +00019930: 6174 696f 6e20 646f 6573 206e 6f74 206d ation does not m │ │ │ │ │ +00019940: 6174 7465 722e 0a0a 2020 2054 6865 2070 atter... The p │ │ │ │ │ +00019950: 6f69 6e74 7320 6d61 6465 2074 6872 6f75 oints made throu │ │ │ │ │ +00019960: 6768 2074 6865 7365 2065 7861 6d70 6c65 gh these example │ │ │ │ │ +00019970: 7320 6172 6520 776f 7274 6820 6120 7375 s are worth a su │ │ │ │ │ +00019980: 6d6d 6172 793a 0a0a 2020 202a 2044 6973 mmary:.. * Dis │ │ │ │ │ +00019990: 7472 6962 7574 6564 2066 696c 6573 2073 tributed files s │ │ │ │ │ +000199a0: 686f 756c 6420 6e65 7665 7220 6465 7065 hould never depe │ │ │ │ │ +000199b0: 6e64 2075 706f 6e20 6e6f 6e2d 6469 7374 nd upon non-dist │ │ │ │ │ +000199c0: 7269 6275 7465 6420 6275 696c 740a 2020 ributed built. │ │ │ │ │ +000199d0: 2020 2066 696c 6573 2e0a 2020 202a 2044 files.. * D │ │ │ │ │ +000199e0: 6973 7472 6962 7574 6564 2066 696c 6573 istributed files │ │ │ │ │ +000199f0: 2073 686f 756c 6420 6265 2064 6973 7472 should be distr │ │ │ │ │ +00019a00: 6962 7574 6564 2077 6974 6820 616c 6c20 ibuted with all │ │ │ │ │ +00019a10: 7468 6569 720a 2020 2020 2064 6570 656e their. depen │ │ │ │ │ +00019a20: 6465 6e63 6965 732e 0a20 2020 2a20 4966 dencies.. * If │ │ │ │ │ +00019a30: 2061 2066 696c 6520 6973 205f 696e 7465 a file is _inte │ │ │ │ │ +00019a40: 6e64 6564 5f20 746f 2062 6520 7265 6275 nded_ to be rebu │ │ │ │ │ +00019a50: 696c 7420 6279 2075 7365 7273 2c20 7468 ilt by users, th │ │ │ │ │ +00019a60: 656e 2074 6865 7265 2069 7320 6e6f 0a20 en there is no. │ │ │ │ │ +00019a70: 2020 2020 706f 696e 7420 696e 2064 6973 point in dis │ │ │ │ │ +00019a80: 7472 6962 7574 696e 6720 6974 2e0a 0a20 tributing it... │ │ │ │ │ +00019a90: 2020 466f 7220 6465 7370 6572 6174 6520 For desperate │ │ │ │ │ +00019aa0: 6361 7365 732c 2069 7427 7320 616c 7761 cases, it's alwa │ │ │ │ │ +00019ab0: 7973 2070 6f73 7369 626c 6520 746f 2064 ys possible to d │ │ │ │ │ +00019ac0: 6973 6162 6c65 2074 6869 7320 6368 6563 isable this chec │ │ │ │ │ +00019ad0: 6b20 6279 0a73 6574 7469 6e67 2027 6469 k by.setting 'di │ │ │ │ │ +00019ae0: 7374 636c 6561 6e63 6865 636b 5f6c 6973 stcleancheck_lis │ │ │ │ │ +00019af0: 7466 696c 6573 2720 6173 2064 6f63 756d tfiles' as docum │ │ │ │ │ +00019b00: 656e 7465 6420 696e 202a 6e6f 7465 2043 ented in *note C │ │ │ │ │ +00019b10: 6865 636b 696e 6720 7468 650a 4469 7374 hecking the.Dist │ │ │ │ │ +00019b20: 7269 6275 7469 6f6e 3a3a 2e20 204d 616b ribution::. Mak │ │ │ │ │ +00019b30: 6520 7375 7265 2079 6f75 2064 6f20 756e e sure you do un │ │ │ │ │ +00019b40: 6465 7273 7461 6e64 2074 6865 2072 6561 derstand the rea │ │ │ │ │ +00019b50: 736f 6e20 7768 7920 276d 616b 650a 6469 son why 'make.di │ │ │ │ │ +00019b60: 7374 6368 6563 6b27 2063 6f6d 706c 6169 stcheck' complai │ │ │ │ │ +00019b70: 6e73 2062 6566 6f72 6520 796f 7520 646f ns before you do │ │ │ │ │ +00019b80: 2074 6869 732e 2020 2764 6973 7463 6c65 this. 'distcle │ │ │ │ │ +00019b90: 616e 6368 6563 6b5f 6c69 7374 6669 6c65 ancheck_listfile │ │ │ │ │ +00019ba0: 7327 2069 730a 6120 7761 7920 746f 205f s' is.a way to _ │ │ │ │ │ +00019bb0: 6869 6465 5f20 6572 726f 7273 2c20 6e6f hide_ errors, no │ │ │ │ │ +00019bc0: 7420 746f 2066 6978 2074 6865 6d2e 2020 t to fix them. │ │ │ │ │ +00019bd0: 596f 7520 6361 6e20 616c 7761 7973 2064 You can always d │ │ │ │ │ +00019be0: 6f20 6265 7474 6572 2e0a 0a1f 0a46 696c o better.....Fil │ │ │ │ │ +00019bf0: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ +00019c00: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 466c .info, Node: Fl │ │ │ │ │ +00019c10: 6167 2056 6172 6961 626c 6573 204f 7264 ag Variables Ord │ │ │ │ │ +00019c20: 6572 696e 672c 2020 4e65 7874 3a20 5265 ering, Next: Re │ │ │ │ │ +00019c30: 6e61 6d65 6420 4f62 6a65 6374 732c 2020 named Objects, │ │ │ │ │ +00019c40: 5072 6576 3a20 6469 7374 636c 6561 6e63 Prev: distcleanc │ │ │ │ │ +00019c50: 6865 636b 2c20 2055 703a 2046 4151 0a0a heck, Up: FAQ.. │ │ │ │ │ +00019c60: 3238 2e36 2046 6c61 6720 5661 7269 6162 28.6 Flag Variab │ │ │ │ │ +00019c70: 6c65 7320 4f72 6465 7269 6e67 0a3d 3d3d les Ordering.=== │ │ │ │ │ 00019c80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00019c90: 3d3d 3d3d 3d3d 3d3d 0a0a 2020 2020 2057 ========.. W │ │ │ │ │ -00019ca0: 6861 7420 6973 2074 6865 2064 6966 6665 hat is the diffe │ │ │ │ │ -00019cb0: 7265 6e63 6520 6265 7477 6565 6e20 2741 rence between 'A │ │ │ │ │ -00019cc0: 4d5f 4346 4c41 4753 272c 2027 4346 4c41 M_CFLAGS', 'CFLA │ │ │ │ │ -00019cd0: 4753 272c 2061 6e64 0a20 2020 2020 276d GS', and. 'm │ │ │ │ │ -00019ce0: 756d 626c 655f 4346 4c41 4753 273f 0a0a umble_CFLAGS'?.. │ │ │ │ │ -00019cf0: 2020 2020 2057 6879 2064 6f65 7320 2761 Why does 'a │ │ │ │ │ -00019d00: 7574 6f6d 616b 6527 206f 7574 7075 7420 utomake' output │ │ │ │ │ -00019d10: 2743 5050 464c 4147 5327 2061 6674 6572 'CPPFLAGS' after │ │ │ │ │ -00019d20: 0a20 2020 2020 2741 4d5f 4350 5046 4c41 . 'AM_CPPFLA │ │ │ │ │ -00019d30: 4753 2720 6f6e 2063 6f6d 7069 6c65 206c GS' on compile l │ │ │ │ │ -00019d40: 696e 6573 3f20 2053 686f 756c 646e 2774 ines? Shouldn't │ │ │ │ │ -00019d50: 2069 7420 6265 2074 6865 2063 6f6e 7665 it be the conve │ │ │ │ │ -00019d60: 7273 653f 0a0a 2020 2020 204d 7920 2763 rse?.. My 'c │ │ │ │ │ -00019d70: 6f6e 6669 6775 7265 2720 6164 6473 2073 onfigure' adds s │ │ │ │ │ -00019d80: 6f6d 6520 7761 726e 696e 6720 666c 6167 ome warning flag │ │ │ │ │ -00019d90: 7320 696e 746f 2027 4358 5846 4c41 4753 s into 'CXXFLAGS │ │ │ │ │ -00019da0: 272e 2020 496e 0a20 2020 2020 6f6e 6520 '. In. one │ │ │ │ │ -00019db0: 274d 616b 6566 696c 652e 616d 2720 4920 'Makefile.am' I │ │ │ │ │ -00019dc0: 776f 756c 6420 6c69 6b65 2074 6f20 6170 would like to ap │ │ │ │ │ -00019dd0: 7065 6e64 2061 206e 6577 2066 6c61 672c pend a new flag, │ │ │ │ │ -00019de0: 2068 6f77 6576 6572 2069 6620 490a 2020 however if I. │ │ │ │ │ -00019df0: 2020 2070 7574 2074 6865 2066 6c61 6720 put the flag │ │ │ │ │ -00019e00: 696e 746f 2027 414d 5f43 5858 464c 4147 into 'AM_CXXFLAG │ │ │ │ │ -00019e10: 5327 2069 7420 6973 2070 7265 7065 6e64 S' it is prepend │ │ │ │ │ -00019e20: 6564 2074 6f20 7468 6520 6f74 6865 720a ed to the other. │ │ │ │ │ -00019e30: 2020 2020 2066 6c61 6773 2c20 6e6f 7420 flags, not │ │ │ │ │ -00019e40: 6170 7065 6e64 6564 2e0a 0a43 6f6d 7069 appended...Compi │ │ │ │ │ -00019e50: 6c65 2046 6c61 6720 5661 7269 6162 6c65 le Flag Variable │ │ │ │ │ -00019e60: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d s.-------------- │ │ │ │ │ -00019e70: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973 2073 --------..This s │ │ │ │ │ -00019e80: 6563 7469 6f6e 2061 7474 656d 7074 7320 ection attempts │ │ │ │ │ -00019e90: 746f 2061 6e73 7765 7220 616c 6c20 7468 to answer all th │ │ │ │ │ -00019ea0: 6520 6162 6f76 6520 7175 6573 7469 6f6e e above question │ │ │ │ │ -00019eb0: 732e 2020 5765 2077 696c 6c20 6d6f 7374 s. We will most │ │ │ │ │ -00019ec0: 6c79 0a64 6973 6375 7373 2027 4350 5046 ly.discuss 'CPPF │ │ │ │ │ -00019ed0: 4c41 4753 2720 696e 206f 7572 2065 7861 LAGS' in our exa │ │ │ │ │ -00019ee0: 6d70 6c65 732c 2062 7574 2061 6374 7561 mples, but actua │ │ │ │ │ -00019ef0: 6c6c 7920 7468 6520 616e 7377 6572 2068 lly the answer h │ │ │ │ │ -00019f00: 6f6c 6473 2066 6f72 0a61 6c6c 2074 6865 olds for.all the │ │ │ │ │ -00019f10: 2063 6f6d 7069 6c65 2066 6c61 6773 2075 compile flags u │ │ │ │ │ -00019f20: 7365 6420 696e 2041 7574 6f6d 616b 653a sed in Automake: │ │ │ │ │ -00019f30: 2027 4343 4153 464c 4147 5327 2c20 2743 'CCASFLAGS', 'C │ │ │ │ │ -00019f40: 464c 4147 5327 2c0a 2743 5050 464c 4147 FLAGS',.'CPPFLAG │ │ │ │ │ -00019f50: 5327 2c20 2743 5858 464c 4147 5327 2c20 S', 'CXXFLAGS', │ │ │ │ │ -00019f60: 2746 4346 4c41 4753 272c 2027 4646 4c41 'FCFLAGS', 'FFLA │ │ │ │ │ -00019f70: 4753 272c 2027 4743 4a46 4c41 4753 272c GS', 'GCJFLAGS', │ │ │ │ │ -00019f80: 2027 4c44 464c 4147 5327 2c0a 274c 464c 'LDFLAGS',.'LFL │ │ │ │ │ -00019f90: 4147 5327 2c20 274c 4942 544f 4f4c 464c AGS', 'LIBTOOLFL │ │ │ │ │ -00019fa0: 4147 5327 2c20 274f 424a 4346 4c41 4753 AGS', 'OBJCFLAGS │ │ │ │ │ -00019fb0: 272c 2027 5246 4c41 4753 272c 2027 5550 ', 'RFLAGS', 'UP │ │ │ │ │ -00019fc0: 4346 4c41 4753 272c 2061 6e64 0a27 5946 CFLAGS', and.'YF │ │ │ │ │ -00019fd0: 4c41 4753 272e 0a0a 2020 2027 4350 5046 LAGS'... 'CPPF │ │ │ │ │ -00019fe0: 4c41 4753 272c 2027 414d 5f43 5050 464c LAGS', 'AM_CPPFL │ │ │ │ │ -00019ff0: 4147 5327 2c20 616e 6420 276d 756d 626c AGS', and 'mumbl │ │ │ │ │ -0001a000: 655f 4350 5046 4c41 4753 2720 6172 6520 e_CPPFLAGS' are │ │ │ │ │ -0001a010: 7468 7265 6520 7661 7269 6162 6c65 730a three variables. │ │ │ │ │ -0001a020: 7468 6174 2063 616e 2062 6520 7573 6564 that can be used │ │ │ │ │ -0001a030: 2074 6f20 7061 7373 2066 6c61 6773 2074 to pass flags t │ │ │ │ │ -0001a040: 6f20 7468 6520 4320 7072 6570 726f 6365 o the C preproce │ │ │ │ │ -0001a050: 7373 6f72 2028 6163 7475 616c 6c79 2074 ssor (actually t │ │ │ │ │ -0001a060: 6865 7365 0a76 6172 6961 626c 6573 2061 hese.variables a │ │ │ │ │ -0001a070: 7265 2061 6c73 6f20 7573 6564 2066 6f72 re also used for │ │ │ │ │ -0001a080: 206f 7468 6572 206c 616e 6775 6167 6573 other languages │ │ │ │ │ -0001a090: 206c 696b 6520 432b 2b20 6f72 2070 7265 like C++ or pre │ │ │ │ │ -0001a0a0: 7072 6f63 6573 7365 640a 466f 7274 7261 processed.Fortra │ │ │ │ │ -0001a0b0: 6e29 2e20 2027 4350 5046 4c41 4753 2720 n). 'CPPFLAGS' │ │ │ │ │ -0001a0c0: 6973 2074 6865 2075 7365 7220 7661 7269 is the user vari │ │ │ │ │ -0001a0d0: 6162 6c65 2028 2a6e 6f74 6520 5573 6572 able (*note User │ │ │ │ │ -0001a0e0: 2056 6172 6961 626c 6573 3a3a 292c 0a27 Variables::),.' │ │ │ │ │ -0001a0f0: 414d 5f43 5050 464c 4147 5327 2069 7320 AM_CPPFLAGS' is │ │ │ │ │ -0001a100: 7468 6520 4175 746f 6d61 6b65 2076 6172 the Automake var │ │ │ │ │ -0001a110: 6961 626c 652c 2061 6e64 2027 6d75 6d62 iable, and 'mumb │ │ │ │ │ -0001a120: 6c65 5f43 5050 464c 4147 5327 2069 7320 le_CPPFLAGS' is │ │ │ │ │ -0001a130: 7468 650a 7661 7269 6162 6c65 2073 7065 the.variable spe │ │ │ │ │ -0001a140: 6369 6669 6320 746f 2074 6865 2027 6d75 cific to the 'mu │ │ │ │ │ -0001a150: 6d62 6c65 2720 7461 7267 6574 2028 7765 mble' target (we │ │ │ │ │ -0001a160: 2063 616c 6c20 7468 6973 2061 2070 6572 call this a per │ │ │ │ │ -0001a170: 2d74 6172 6765 740a 7661 7269 6162 6c65 -target.variable │ │ │ │ │ -0001a180: 2c20 2a6e 6f74 6520 5072 6f67 7261 6d20 , *note Program │ │ │ │ │ -0001a190: 616e 6420 4c69 6272 6172 7920 5661 7269 and Library Vari │ │ │ │ │ -0001a1a0: 6162 6c65 733a 3a29 2e0a 0a20 2020 4175 ables::)... Au │ │ │ │ │ -0001a1b0: 746f 6d61 6b65 2061 6c77 6179 7320 7573 tomake always us │ │ │ │ │ -0001a1c0: 6573 2074 776f 206f 6620 7468 6573 6520 es two of these │ │ │ │ │ -0001a1d0: 7661 7269 6162 6c65 7320 7768 656e 2063 variables when c │ │ │ │ │ -0001a1e0: 6f6d 7069 6c69 6e67 2043 2073 6f75 7263 ompiling C sourc │ │ │ │ │ -0001a1f0: 6573 0a66 696c 6573 2e20 2057 6865 6e20 es.files. When │ │ │ │ │ -0001a200: 636f 6d70 696c 696e 6720 616e 206f 626a compiling an obj │ │ │ │ │ -0001a210: 6563 7420 6669 6c65 2066 6f72 2074 6865 ect file for the │ │ │ │ │ -0001a220: 2027 6d75 6d62 6c65 2720 7461 7267 6574 'mumble' target │ │ │ │ │ -0001a230: 2c20 7468 6520 6669 7273 740a 7661 7269 , the first.vari │ │ │ │ │ -0001a240: 6162 6c65 2077 696c 6c20 6265 2027 6d75 able will be 'mu │ │ │ │ │ -0001a250: 6d62 6c65 5f43 5050 464c 4147 5327 2069 mble_CPPFLAGS' i │ │ │ │ │ -0001a260: 6620 6974 2069 7320 6465 6669 6e65 642c f it is defined, │ │ │ │ │ -0001a270: 206f 7220 2741 4d5f 4350 5046 4c41 4753 or 'AM_CPPFLAGS │ │ │ │ │ -0001a280: 270a 6f74 6865 7277 6973 652e 2020 5468 '.otherwise. Th │ │ │ │ │ -0001a290: 6520 7365 636f 6e64 2076 6172 6961 626c e second variabl │ │ │ │ │ -0001a2a0: 6520 6973 2061 6c77 6179 7320 2743 5050 e is always 'CPP │ │ │ │ │ -0001a2b0: 464c 4147 5327 2e0a 0a20 2020 496e 2074 FLAGS'... In t │ │ │ │ │ -0001a2c0: 6865 2066 6f6c 6c6f 7769 6e67 2065 7861 he following exa │ │ │ │ │ -0001a2d0: 6d70 6c65 2c0a 0a20 2020 2020 6269 6e5f mple,.. bin_ │ │ │ │ │ -0001a2e0: 5052 4f47 5241 4d53 203d 2066 6f6f 2062 PROGRAMS = foo b │ │ │ │ │ -0001a2f0: 6172 0a20 2020 2020 666f 6f5f 534f 5552 ar. foo_SOUR │ │ │ │ │ -0001a300: 4345 5320 3d20 7879 7a2e 630a 2020 2020 CES = xyz.c. │ │ │ │ │ -0001a310: 2062 6172 5f53 4f55 5243 4553 203d 206d bar_SOURCES = m │ │ │ │ │ -0001a320: 6169 6e2e 630a 2020 2020 2066 6f6f 5f43 ain.c. foo_C │ │ │ │ │ -0001a330: 5050 464c 4147 5320 3d20 2d44 464f 4f0a PPFLAGS = -DFOO. │ │ │ │ │ -0001a340: 2020 2020 2041 4d5f 4350 5046 4c41 4753 AM_CPPFLAGS │ │ │ │ │ -0001a350: 203d 202d 4442 415a 0a0a 2778 797a 2e6f = -DBAZ..'xyz.o │ │ │ │ │ -0001a360: 2720 7769 6c6c 2062 6520 636f 6d70 696c ' will be compil │ │ │ │ │ -0001a370: 6564 2077 6974 6820 2724 2866 6f6f 5f43 ed with '$(foo_C │ │ │ │ │ -0001a380: 5050 464c 4147 5329 2024 2843 5050 464c PPFLAGS) $(CPPFL │ │ │ │ │ -0001a390: 4147 5329 272c 2028 6265 6361 7573 650a AGS)', (because. │ │ │ │ │ -0001a3a0: 2778 797a 2e6f 2720 6973 2070 6172 7420 'xyz.o' is part │ │ │ │ │ -0001a3b0: 6f66 2074 6865 2027 666f 6f27 2074 6172 of the 'foo' tar │ │ │ │ │ -0001a3c0: 6765 7429 2c20 7768 696c 6520 276d 6169 get), while 'mai │ │ │ │ │ -0001a3d0: 6e2e 6f27 2077 696c 6c20 6265 2063 6f6d n.o' will be com │ │ │ │ │ -0001a3e0: 7069 6c65 640a 7769 7468 2027 2428 414d piled.with '$(AM │ │ │ │ │ -0001a3f0: 5f43 5050 464c 4147 5329 2024 2843 5050 _CPPFLAGS) $(CPP │ │ │ │ │ -0001a400: 464c 4147 5329 2720 2862 6563 6175 7365 FLAGS)' (because │ │ │ │ │ -0001a410: 2074 6865 7265 2069 7320 6e6f 2070 6572 there is no per │ │ │ │ │ -0001a420: 2d74 6172 6765 740a 7661 7269 6162 6c65 -target.variable │ │ │ │ │ -0001a430: 2066 6f72 2074 6172 6765 7420 2762 6172 for target 'bar │ │ │ │ │ -0001a440: 2729 2e0a 0a20 2020 5468 6520 6469 6666 ')... The diff │ │ │ │ │ -0001a450: 6572 656e 6365 2062 6574 7765 656e 2027 erence between ' │ │ │ │ │ -0001a460: 6d75 6d62 6c65 5f43 5050 464c 4147 5327 mumble_CPPFLAGS' │ │ │ │ │ -0001a470: 2061 6e64 2027 414d 5f43 5050 464c 4147 and 'AM_CPPFLAG │ │ │ │ │ -0001a480: 5327 2062 6569 6e67 0a63 6c65 6172 2065 S' being.clear e │ │ │ │ │ -0001a490: 6e6f 7567 682c 206c 6574 2773 2066 6f63 nough, let's foc │ │ │ │ │ -0001a4a0: 7573 206f 6e20 2743 5050 464c 4147 5327 us on 'CPPFLAGS' │ │ │ │ │ -0001a4b0: 2e20 2027 4350 5046 4c41 4753 2720 6973 . 'CPPFLAGS' is │ │ │ │ │ -0001a4c0: 2061 2075 7365 7220 7661 7269 6162 6c65 a user variable │ │ │ │ │ -0001a4d0: 2c0a 692e 652e 2c20 6120 7661 7269 6162 ,.i.e., a variab │ │ │ │ │ -0001a4e0: 6c65 2074 6861 7420 7573 6572 7320 6172 le that users ar │ │ │ │ │ -0001a4f0: 6520 656e 7469 746c 6564 2074 6f20 6d6f e entitled to mo │ │ │ │ │ -0001a500: 6469 6679 2069 6e20 6f72 6465 7220 746f dify in order to │ │ │ │ │ -0001a510: 2063 6f6d 7069 6c65 0a74 6865 2070 6163 compile.the pac │ │ │ │ │ -0001a520: 6b61 6765 2e20 2054 6869 7320 7661 7269 kage. This vari │ │ │ │ │ -0001a530: 6162 6c65 2c20 6c69 6b65 206d 616e 7920 able, like many │ │ │ │ │ -0001a540: 6f74 6865 7273 2c20 6973 2064 6f63 756d others, is docum │ │ │ │ │ -0001a550: 656e 7465 6420 6174 2074 6865 2065 6e64 ented at the end │ │ │ │ │ -0001a560: 0a6f 6620 7468 6520 6f75 7470 7574 206f .of the output o │ │ │ │ │ -0001a570: 6620 2763 6f6e 6669 6775 7265 202d 2d68 f 'configure --h │ │ │ │ │ -0001a580: 656c 7027 2e0a 0a20 2020 466f 7220 696e elp'... For in │ │ │ │ │ -0001a590: 7374 616e 6365 2c20 736f 6d65 6f6e 6520 stance, someone │ │ │ │ │ -0001a5a0: 7768 6f20 6e65 6564 7320 746f 2061 6464 who needs to add │ │ │ │ │ -0001a5b0: 2027 2f68 6f6d 652f 6d79 2f75 7372 2f69 '/home/my/usr/i │ │ │ │ │ -0001a5c0: 6e63 6c75 6465 2720 746f 2074 6865 0a43 nclude' to the.C │ │ │ │ │ -0001a5d0: 2063 6f6d 7069 6c65 7227 7320 7365 6172 compiler's sear │ │ │ │ │ -0001a5e0: 6368 2070 6174 6820 776f 756c 6420 636f ch path would co │ │ │ │ │ -0001a5f0: 6e66 6967 7572 6520 6120 7061 636b 6167 nfigure a packag │ │ │ │ │ -0001a600: 6520 7769 7468 0a0a 2020 2020 202e 2f63 e with.. ./c │ │ │ │ │ -0001a610: 6f6e 6669 6775 7265 2043 5050 464c 4147 onfigure CPPFLAG │ │ │ │ │ -0001a620: 533d 272d 4920 2f68 6f6d 652f 6d79 2f75 S='-I /home/my/u │ │ │ │ │ -0001a630: 7372 2f69 6e63 6c75 6465 270a 0a61 6e64 sr/include'..and │ │ │ │ │ -0001a640: 2074 6869 7320 666c 6167 2077 6f75 6c64 this flag would │ │ │ │ │ -0001a650: 2062 6520 7072 6f70 6167 6174 6564 2074 be propagated t │ │ │ │ │ -0001a660: 6f20 7468 6520 636f 6d70 696c 6520 7275 o the compile ru │ │ │ │ │ -0001a670: 6c65 7320 6f66 2061 6c6c 0a27 4d61 6b65 les of all.'Make │ │ │ │ │ -0001a680: 6669 6c65 2773 2e0a 0a20 2020 4974 2069 file's... It i │ │ │ │ │ -0001a690: 7320 616c 736f 206e 6f74 2075 6e63 6f6d s also not uncom │ │ │ │ │ -0001a6a0: 6d6f 6e20 746f 206f 7665 7272 6964 6520 mon to override │ │ │ │ │ -0001a6b0: 6120 7573 6572 2076 6172 6961 626c 6520 a user variable │ │ │ │ │ -0001a6c0: 6174 2027 6d61 6b65 272d 7469 6d65 2e0a at 'make'-time.. │ │ │ │ │ -0001a6d0: 4d61 6e79 2069 6e73 7461 6c6c 6572 7320 Many installers │ │ │ │ │ -0001a6e0: 646f 2074 6869 7320 7769 7468 2027 7072 do this with 'pr │ │ │ │ │ -0001a6f0: 6566 6978 272c 2062 7574 2074 6869 7320 efix', but this │ │ │ │ │ -0001a700: 6361 6e20 6265 2075 7365 6675 6c20 7769 can be useful wi │ │ │ │ │ -0001a710: 7468 0a63 6f6d 7069 6c65 7220 666c 6167 th.compiler flag │ │ │ │ │ -0001a720: 7320 746f 6f2e 2020 466f 7220 696e 7374 s too. For inst │ │ │ │ │ -0001a730: 616e 6365 2c20 6966 2c20 7768 696c 6520 ance, if, while │ │ │ │ │ -0001a740: 6465 6275 6767 696e 6720 6120 432b 2b20 debugging a C++ │ │ │ │ │ -0001a750: 7072 6f6a 6563 742c 0a79 6f75 206e 6565 project,.you nee │ │ │ │ │ -0001a760: 6420 746f 2064 6973 6162 6c65 206f 7074 d to disable opt │ │ │ │ │ -0001a770: 696d 697a 6174 696f 6e20 696e 206f 6e65 imization in one │ │ │ │ │ -0001a780: 2073 7065 6369 6669 6320 6f62 6a65 6374 specific object │ │ │ │ │ -0001a790: 2066 696c 652c 2079 6f75 2063 616e 0a72 file, you can.r │ │ │ │ │ -0001a7a0: 756e 2073 6f6d 6574 6869 6e67 206c 696b un something lik │ │ │ │ │ -0001a7b0: 650a 0a20 2020 2020 726d 2066 696c 652e e.. rm file. │ │ │ │ │ -0001a7c0: 6f0a 2020 2020 206d 616b 6520 4358 5846 o. make CXXF │ │ │ │ │ -0001a7d0: 4c41 4753 3d2d 4f30 2066 696c 652e 6f0a LAGS=-O0 file.o. │ │ │ │ │ -0001a7e0: 2020 2020 206d 616b 650a 0a20 2020 5468 make.. Th │ │ │ │ │ -0001a7f0: 6520 7265 6173 6f6e 2027 2428 4350 5046 e reason '$(CPPF │ │ │ │ │ -0001a800: 4c41 4753 2927 2061 7070 6561 7273 2061 LAGS)' appears a │ │ │ │ │ -0001a810: 6674 6572 2027 2428 414d 5f43 5050 464c fter '$(AM_CPPFL │ │ │ │ │ -0001a820: 4147 5329 2720 6f72 0a27 2428 6d75 6d62 AGS)' or.'$(mumb │ │ │ │ │ -0001a830: 6c65 5f43 5050 464c 4147 5329 2720 696e le_CPPFLAGS)' in │ │ │ │ │ -0001a840: 2074 6865 2063 6f6d 7069 6c65 2063 6f6d the compile com │ │ │ │ │ -0001a850: 6d61 6e64 2069 7320 7468 6174 2075 7365 mand is that use │ │ │ │ │ -0001a860: 7273 2073 686f 756c 6420 616c 7761 7973 rs should always │ │ │ │ │ -0001a870: 0a68 6176 6520 7468 6520 6c61 7374 2073 .have the last s │ │ │ │ │ -0001a880: 6179 2e20 2049 7420 7072 6f62 6162 6c79 ay. It probably │ │ │ │ │ -0001a890: 206d 616b 6573 206d 6f72 6520 7365 6e73 makes more sens │ │ │ │ │ -0001a8a0: 6520 6966 2079 6f75 2074 6869 6e6b 2061 e if you think a │ │ │ │ │ -0001a8b0: 626f 7574 2069 740a 7768 696c 6520 6c6f bout it.while lo │ │ │ │ │ -0001a8c0: 6f6b 696e 6720 6174 2074 6865 2027 4358 oking at the 'CX │ │ │ │ │ -0001a8d0: 5846 4c41 4753 3d2d 4f30 2720 6162 6f76 XFLAGS=-O0' abov │ │ │ │ │ -0001a8e0: 652c 2077 6869 6368 2073 686f 756c 6420 e, which should │ │ │ │ │ -0001a8f0: 7375 7065 7273 6564 6520 616e 790a 6f74 supersede any.ot │ │ │ │ │ -0001a900: 6865 7220 7377 6974 6368 2066 726f 6d20 her switch from │ │ │ │ │ -0001a910: 2741 4d5f 4358 5846 4c41 4753 2720 6f72 'AM_CXXFLAGS' or │ │ │ │ │ -0001a920: 2027 6d75 6d62 6c65 5f43 5858 464c 4147 'mumble_CXXFLAG │ │ │ │ │ -0001a930: 5327 2028 616e 6420 7468 6973 206f 6620 S' (and this of │ │ │ │ │ -0001a940: 636f 7572 7365 0a72 6570 6c61 6365 7320 course.replaces │ │ │ │ │ -0001a950: 7468 6520 7072 6576 696f 7573 2076 616c the previous val │ │ │ │ │ -0001a960: 7565 206f 6620 2743 5858 464c 4147 5327 ue of 'CXXFLAGS' │ │ │ │ │ -0001a970: 292e 0a0a 2020 2059 6f75 2073 686f 756c )... You shoul │ │ │ │ │ -0001a980: 6420 6e65 7665 7220 7265 6465 6669 6e65 d never redefine │ │ │ │ │ -0001a990: 2061 2075 7365 7220 7661 7269 6162 6c65 a user variable │ │ │ │ │ -0001a9a0: 2073 7563 6820 6173 2027 4350 5046 4c41 such as 'CPPFLA │ │ │ │ │ -0001a9b0: 4753 2720 696e 0a27 4d61 6b65 6669 6c65 GS' in.'Makefile │ │ │ │ │ -0001a9c0: 2e61 6d27 2e20 2055 7365 2027 6175 746f .am'. Use 'auto │ │ │ │ │ -0001a9d0: 6d61 6b65 202d 576f 7665 7272 6964 6527 make -Woverride' │ │ │ │ │ -0001a9e0: 2074 6f20 6469 6167 6e6f 7365 2073 7563 to diagnose suc │ │ │ │ │ -0001a9f0: 6820 6d69 7374 616b 6573 2e0a 4576 656e h mistakes..Even │ │ │ │ │ -0001aa00: 2073 6f6d 6574 6869 6e67 206c 696b 650a something like. │ │ │ │ │ -0001aa10: 0a20 2020 2020 4350 5046 4c41 4753 203d . CPPFLAGS = │ │ │ │ │ -0001aa20: 202d 4444 4154 4144 4952 3d5c 2224 2864 -DDATADIR=\"$(d │ │ │ │ │ -0001aa30: 6174 6164 6972 295c 2220 4043 5050 464c atadir)\" @CPPFL │ │ │ │ │ -0001aa40: 4147 5340 0a0a 6973 2065 7272 6f6e 656f AGS@..is erroneo │ │ │ │ │ -0001aa50: 7573 2e20 2041 6c74 686f 7567 6820 7468 us. Although th │ │ │ │ │ -0001aa60: 6973 2070 7265 7365 7276 6573 2027 636f is preserves 'co │ │ │ │ │ -0001aa70: 6e66 6967 7572 6527 2773 2076 616c 7565 nfigure''s value │ │ │ │ │ -0001aa80: 206f 660a 2743 5050 464c 4147 5327 2c20 of.'CPPFLAGS', │ │ │ │ │ -0001aa90: 7468 6520 6465 6669 6e69 7469 6f6e 206f the definition o │ │ │ │ │ -0001aaa0: 6620 2744 4154 4144 4952 2720 7769 6c6c f 'DATADIR' will │ │ │ │ │ -0001aab0: 2064 6973 6170 7065 6172 2069 6620 6120 disappear if a │ │ │ │ │ -0001aac0: 7573 6572 0a61 7474 656d 7074 7320 746f user.attempts to │ │ │ │ │ -0001aad0: 206f 7665 7272 6964 6520 2743 5050 464c override 'CPPFL │ │ │ │ │ -0001aae0: 4147 5327 2066 726f 6d20 7468 6520 276d AGS' from the 'm │ │ │ │ │ -0001aaf0: 616b 6527 2063 6f6d 6d61 6e64 206c 696e ake' command lin │ │ │ │ │ -0001ab00: 652e 0a0a 2020 2020 2041 4d5f 4350 5046 e... AM_CPPF │ │ │ │ │ -0001ab10: 4c41 4753 203d 202d 4444 4154 4144 4952 LAGS = -DDATADIR │ │ │ │ │ -0001ab20: 3d5c 2224 2864 6174 6164 6972 295c 220a =\"$(datadir)\". │ │ │ │ │ -0001ab30: 0a69 7320 616c 6c20 7468 6174 2069 7320 .is all that is │ │ │ │ │ -0001ab40: 6e65 6564 6564 2068 6572 6520 6966 206e needed here if n │ │ │ │ │ -0001ab50: 6f20 7065 722d 7461 7267 6574 2066 6c61 o per-target fla │ │ │ │ │ -0001ab60: 6773 2061 7265 2075 7365 642e 0a0a 2020 gs are used... │ │ │ │ │ -0001ab70: 2059 6f75 2073 686f 756c 6420 6e6f 7420 You should not │ │ │ │ │ -0001ab80: 6164 6420 6f70 7469 6f6e 7320 746f 2074 add options to t │ │ │ │ │ -0001ab90: 6865 7365 2075 7365 7220 7661 7269 6162 hese user variab │ │ │ │ │ -0001aba0: 6c65 7320 7769 7468 696e 2027 636f 6e66 les within 'conf │ │ │ │ │ -0001abb0: 6967 7572 6527 0a65 6974 6865 722c 2066 igure'.either, f │ │ │ │ │ -0001abc0: 6f72 2074 6865 2073 616d 6520 7265 6173 or the same reas │ │ │ │ │ -0001abd0: 6f6e 2e20 204f 6363 6173 696f 6e61 6c6c on. Occasionall │ │ │ │ │ -0001abe0: 7920 796f 7520 6e65 6564 2074 6f20 6d6f y you need to mo │ │ │ │ │ -0001abf0: 6469 6679 2074 6865 7365 0a76 6172 6961 dify these.varia │ │ │ │ │ -0001ac00: 626c 6573 2074 6f20 7065 7266 6f72 6d20 bles to perform │ │ │ │ │ -0001ac10: 6120 7465 7374 2c20 6275 7420 796f 7520 a test, but you │ │ │ │ │ -0001ac20: 7368 6f75 6c64 2072 6573 6574 2074 6865 should reset the │ │ │ │ │ -0001ac30: 6972 2076 616c 7565 730a 6166 7465 7277 ir values.afterw │ │ │ │ │ -0001ac40: 6172 6473 2e20 2049 6e20 636f 6e74 7261 ards. In contra │ │ │ │ │ -0001ac50: 7374 2c20 6974 2069 7320 4f4b 2074 6f20 st, it is OK to │ │ │ │ │ -0001ac60: 6d6f 6469 6679 2074 6865 2027 414d 5f27 modify the 'AM_' │ │ │ │ │ -0001ac70: 2076 6172 6961 626c 6573 2077 6974 6869 variables withi │ │ │ │ │ -0001ac80: 6e0a 2763 6f6e 6669 6775 7265 2720 6966 n.'configure' if │ │ │ │ │ -0001ac90: 2079 6f75 2027 4143 5f53 5542 5354 2720 you 'AC_SUBST' │ │ │ │ │ -0001aca0: 7468 656d 2c20 6275 7420 6974 2069 7320 them, but it is │ │ │ │ │ -0001acb0: 7261 7468 6572 2072 6172 6520 7468 6174 rather rare that │ │ │ │ │ -0001acc0: 2079 6f75 206e 6565 640a 746f 2064 6f20 you need.to do │ │ │ │ │ -0001acd0: 7468 6973 2c20 756e 6c65 7373 2079 6f75 this, unless you │ │ │ │ │ -0001ace0: 2072 6561 6c6c 7920 7761 6e74 2074 6f20 really want to │ │ │ │ │ -0001acf0: 6368 616e 6765 2074 6865 2064 6566 6175 change the defau │ │ │ │ │ -0001ad00: 6c74 2064 6566 696e 6974 696f 6e73 206f lt definitions o │ │ │ │ │ -0001ad10: 660a 7468 6520 2741 4d5f 2720 7661 7269 f.the 'AM_' vari │ │ │ │ │ -0001ad20: 6162 6c65 7320 696e 2061 6c6c 2027 4d61 ables in all 'Ma │ │ │ │ │ -0001ad30: 6b65 6669 6c65 2773 2e0a 0a20 2020 5768 kefile's... Wh │ │ │ │ │ -0001ad40: 6174 2077 6520 7265 636f 6d6d 656e 6420 at we recommend │ │ │ │ │ -0001ad50: 6973 2074 6861 7420 796f 7520 6465 6669 is that you defi │ │ │ │ │ -0001ad60: 6e65 2065 7874 7261 2066 6c61 6773 2069 ne extra flags i │ │ │ │ │ -0001ad70: 6e20 7365 7061 7261 7465 0a76 6172 6961 n separate.varia │ │ │ │ │ -0001ad80: 626c 6573 2e20 2046 6f72 2069 6e73 7461 bles. For insta │ │ │ │ │ -0001ad90: 6e63 652c 2079 6f75 206d 6179 2077 7269 nce, you may wri │ │ │ │ │ -0001ada0: 7465 2061 6e20 4175 746f 636f 6e66 206d te an Autoconf m │ │ │ │ │ -0001adb0: 6163 726f 2074 6861 7420 636f 6d70 7574 acro that comput │ │ │ │ │ -0001adc0: 6573 0a61 2073 6574 206f 6620 7761 726e es.a set of warn │ │ │ │ │ -0001add0: 696e 6720 6f70 7469 6f6e 7320 666f 7220 ing options for │ │ │ │ │ -0001ade0: 7468 6520 4320 636f 6d70 696c 6572 2c20 the C compiler, │ │ │ │ │ -0001adf0: 616e 6420 2741 435f 5355 4253 5427 2074 and 'AC_SUBST' t │ │ │ │ │ -0001ae00: 6865 6d20 696e 0a27 5741 524e 494e 4743 hem in.'WARNINGC │ │ │ │ │ -0001ae10: 464c 4147 5327 3b20 796f 7520 6d61 7920 FLAGS'; you may │ │ │ │ │ -0001ae20: 616c 736f 2068 6176 6520 616e 2041 7574 also have an Aut │ │ │ │ │ -0001ae30: 6f63 6f6e 6620 6d61 6372 6f20 7468 6174 oconf macro that │ │ │ │ │ -0001ae40: 2064 6574 6572 6d69 6e65 730a 7768 6963 determines.whic │ │ │ │ │ -0001ae50: 6820 636f 6d70 696c 6572 2061 6e64 2077 h compiler and w │ │ │ │ │ -0001ae60: 6869 6368 206c 696e 6b65 7220 666c 6167 hich linker flag │ │ │ │ │ -0001ae70: 7320 7368 6f75 6c64 2062 6520 7573 6564 s should be used │ │ │ │ │ -0001ae80: 2074 6f20 6c69 6e6b 2077 6974 680a 6c69 to link with.li │ │ │ │ │ -0001ae90: 6272 6172 7920 276c 6962 666f 6f27 2c20 brary 'libfoo', │ │ │ │ │ -0001aea0: 616e 6420 2741 435f 5355 4253 5427 2074 and 'AC_SUBST' t │ │ │ │ │ -0001aeb0: 6865 7365 2069 6e20 274c 4942 464f 4f43 hese in 'LIBFOOC │ │ │ │ │ -0001aec0: 464c 4147 5327 2061 6e64 0a27 4c49 4246 FLAGS' and.'LIBF │ │ │ │ │ -0001aed0: 4f4f 4c44 464c 4147 5327 2e20 2054 6865 OOLDFLAGS'. The │ │ │ │ │ -0001aee0: 6e2c 2061 2027 4d61 6b65 6669 6c65 2e61 n, a 'Makefile.a │ │ │ │ │ -0001aef0: 6d27 2063 6f75 6c64 2075 7365 2074 6865 m' could use the │ │ │ │ │ -0001af00: 7365 2076 6172 6961 626c 6573 2061 730a se variables as. │ │ │ │ │ -0001af10: 666f 6c6c 6f77 733a 0a0a 2020 2020 2041 follows:.. A │ │ │ │ │ -0001af20: 4d5f 4346 4c41 4753 203d 2024 2857 4152 M_CFLAGS = $(WAR │ │ │ │ │ -0001af30: 4e49 4e47 4346 4c41 4753 290a 2020 2020 NINGCFLAGS). │ │ │ │ │ -0001af40: 2062 696e 5f50 524f 4752 414d 5320 3d20 bin_PROGRAMS = │ │ │ │ │ -0001af50: 7072 6f67 3120 7072 6f67 320a 2020 2020 prog1 prog2. │ │ │ │ │ -0001af60: 2070 726f 6731 5f53 4f55 5243 4553 203d prog1_SOURCES = │ │ │ │ │ -0001af70: 202e 2e2e 0a20 2020 2020 7072 6f67 325f .... prog2_ │ │ │ │ │ -0001af80: 534f 5552 4345 5320 3d20 2e2e 2e0a 2020 SOURCES = .... │ │ │ │ │ -0001af90: 2020 2070 726f 6732 5f43 464c 4147 5320 prog2_CFLAGS │ │ │ │ │ -0001afa0: 3d20 2428 4c49 4246 4f4f 4346 4c41 4753 = $(LIBFOOCFLAGS │ │ │ │ │ -0001afb0: 2920 2428 414d 5f43 464c 4147 5329 0a20 ) $(AM_CFLAGS). │ │ │ │ │ -0001afc0: 2020 2020 7072 6f67 325f 4c44 464c 4147 prog2_LDFLAG │ │ │ │ │ -0001afd0: 5320 3d20 2428 4c49 4246 4f4f 4c44 464c S = $(LIBFOOLDFL │ │ │ │ │ -0001afe0: 4147 5329 0a0a 2020 2049 6e20 7468 6973 AGS).. In this │ │ │ │ │ -0001aff0: 2065 7861 6d70 6c65 2062 6f74 6820 7072 example both pr │ │ │ │ │ -0001b000: 6f67 7261 6d73 2077 696c 6c20 6265 2063 ograms will be c │ │ │ │ │ -0001b010: 6f6d 7069 6c65 6420 7769 7468 2074 6865 ompiled with the │ │ │ │ │ -0001b020: 2066 6c61 6773 0a73 7562 7374 6974 7574 flags.substitut │ │ │ │ │ -0001b030: 6564 2069 6e74 6f20 2724 2857 4152 4e49 ed into '$(WARNI │ │ │ │ │ -0001b040: 4e47 4346 4c41 4753 2927 2c20 616e 6420 NGCFLAGS)', and │ │ │ │ │ -0001b050: 2770 726f 6732 2720 7769 6c6c 2061 6464 'prog2' will add │ │ │ │ │ -0001b060: 6974 696f 6e61 6c6c 7920 6265 0a63 6f6d itionally be.com │ │ │ │ │ -0001b070: 7069 6c65 6420 7769 7468 2074 6865 2066 piled with the f │ │ │ │ │ -0001b080: 6c61 6773 2072 6571 7569 7265 6420 746f lags required to │ │ │ │ │ -0001b090: 206c 696e 6b20 7769 7468 2027 6c69 6266 link with 'libf │ │ │ │ │ -0001b0a0: 6f6f 272e 0a0a 2020 204e 6f74 6520 7468 oo'... Note th │ │ │ │ │ -0001b0b0: 6174 206c 6973 7469 6e67 2027 414d 5f43 at listing 'AM_C │ │ │ │ │ -0001b0c0: 464c 4147 5327 2069 6e20 6120 7065 722d FLAGS' in a per- │ │ │ │ │ -0001b0d0: 7461 7267 6574 2027 4346 4c41 4753 2720 target 'CFLAGS' │ │ │ │ │ -0001b0e0: 7661 7269 6162 6c65 2069 7320 610a 636f variable is a.co │ │ │ │ │ -0001b0f0: 6d6d 6f6e 2069 6469 6f6d 2074 6f20 656e mmon idiom to en │ │ │ │ │ -0001b100: 7375 7265 2074 6861 7420 2741 4d5f 4346 sure that 'AM_CF │ │ │ │ │ -0001b110: 4c41 4753 2720 6170 706c 6965 7320 746f LAGS' applies to │ │ │ │ │ -0001b120: 2065 7665 7279 2074 6172 6765 7420 696e every target in │ │ │ │ │ -0001b130: 2061 0a27 4d61 6b65 6669 6c65 2e69 6e27 a.'Makefile.in' │ │ │ │ │ -0001b140: 2e0a 0a20 2020 5573 696e 6720 7661 7269 ... Using vari │ │ │ │ │ -0001b150: 6162 6c65 7320 6c69 6b65 2074 6869 7320 ables like this │ │ │ │ │ -0001b160: 6769 7665 7320 796f 7520 6675 6c6c 2063 gives you full c │ │ │ │ │ -0001b170: 6f6e 7472 6f6c 206f 7665 7220 7468 6520 ontrol over the │ │ │ │ │ -0001b180: 6f72 6465 7269 6e67 206f 660a 7468 6520 ordering of.the │ │ │ │ │ -0001b190: 666c 6167 732e 2020 466f 7220 696e 7374 flags. For inst │ │ │ │ │ -0001b1a0: 616e 6365 2c20 6966 2074 6865 7265 2069 ance, if there i │ │ │ │ │ -0001b1b0: 7320 6120 666c 6167 2069 6e20 2428 5741 s a flag in $(WA │ │ │ │ │ -0001b1c0: 524e 494e 4743 464c 4147 5329 2074 6861 RNINGCFLAGS) tha │ │ │ │ │ -0001b1d0: 740a 796f 7520 7761 6e74 2074 6f20 6e65 t.you want to ne │ │ │ │ │ -0001b1e0: 6761 7465 2066 6f72 2061 2070 6172 7469 gate for a parti │ │ │ │ │ -0001b1f0: 6375 6c61 7220 7461 7267 6574 2c20 796f cular target, yo │ │ │ │ │ -0001b200: 7520 6361 6e20 7573 6520 736f 6d65 7468 u can use someth │ │ │ │ │ -0001b210: 696e 6720 6c69 6b65 0a27 7072 6f67 315f ing like.'prog1_ │ │ │ │ │ -0001b220: 4346 4c41 4753 203d 2024 2841 4d5f 4346 CFLAGS = $(AM_CF │ │ │ │ │ -0001b230: 4c41 4753 2920 2d6e 6f2d 666c 6167 272e LAGS) -no-flag'. │ │ │ │ │ -0001b240: 2020 4966 2061 6c6c 2074 6865 7365 2066 If all these f │ │ │ │ │ -0001b250: 6c61 6773 2068 6164 2062 6565 6e0a 666f lags had been.fo │ │ │ │ │ -0001b260: 7263 6566 756c 6c79 2061 7070 656e 6465 rcefully appende │ │ │ │ │ -0001b270: 6420 746f 2027 4346 4c41 4753 272c 2074 d to 'CFLAGS', t │ │ │ │ │ -0001b280: 6865 7265 2077 6f75 6c64 2062 6520 6e6f here would be no │ │ │ │ │ -0001b290: 2077 6179 2074 6f20 6469 7361 626c 6520 way to disable │ │ │ │ │ -0001b2a0: 6f6e 650a 666c 6167 2e20 2059 6574 2061 one.flag. Yet a │ │ │ │ │ -0001b2b0: 6e6f 7468 6572 2072 6561 736f 6e20 746f nother reason to │ │ │ │ │ -0001b2c0: 206c 6561 7665 2075 7365 7220 7661 7269 leave user vari │ │ │ │ │ -0001b2d0: 6162 6c65 7320 746f 2075 7365 7273 2e0a ables to users.. │ │ │ │ │ -0001b2e0: 0a20 2020 4669 6e61 6c6c 792c 2077 6520 . Finally, we │ │ │ │ │ -0001b2f0: 6861 7665 2061 766f 6964 6564 206e 616d have avoided nam │ │ │ │ │ -0001b300: 696e 6720 7468 6520 7661 7269 6162 6c65 ing the variable │ │ │ │ │ -0001b310: 206f 6620 7468 6520 6578 616d 706c 650a of the example. │ │ │ │ │ -0001b320: 274c 4942 464f 4f5f 4c44 464c 4147 5327 'LIBFOO_LDFLAGS' │ │ │ │ │ -0001b330: 2028 7769 7468 2061 6e20 756e 6465 7273 (with an unders │ │ │ │ │ -0001b340: 636f 7265 2920 6265 6361 7573 6520 7468 core) because th │ │ │ │ │ -0001b350: 6174 2077 6f75 6c64 2063 6175 7365 2041 at would cause A │ │ │ │ │ -0001b360: 7574 6f6d 616b 650a 746f 2074 6869 6e6b utomake.to think │ │ │ │ │ -0001b370: 2074 6861 7420 7468 6973 2069 7320 6163 that this is ac │ │ │ │ │ -0001b380: 7475 616c 6c79 2061 2070 6572 2d74 6172 tually a per-tar │ │ │ │ │ -0001b390: 6765 7420 7661 7269 6162 6c65 2028 6c69 get variable (li │ │ │ │ │ -0001b3a0: 6b65 0a27 6d75 6d62 6c65 5f4c 4446 4c41 ke.'mumble_LDFLA │ │ │ │ │ -0001b3b0: 4753 2729 2066 6f72 2073 6f6d 6520 6e6f GS') for some no │ │ │ │ │ -0001b3c0: 6e2d 6465 636c 6172 6564 2027 4c49 4246 n-declared 'LIBF │ │ │ │ │ -0001b3d0: 4f4f 2720 7461 7267 6574 2e0a 0a4f 7468 OO' target...Oth │ │ │ │ │ -0001b3e0: 6572 2056 6172 6961 626c 6573 0a2d 2d2d er Variables.--- │ │ │ │ │ -0001b3f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ │ -0001b400: 6572 6520 6172 6520 6f74 6865 7220 7661 ere are other va │ │ │ │ │ -0001b410: 7269 6162 6c65 7320 696e 2041 7574 6f6d riables in Autom │ │ │ │ │ -0001b420: 616b 6520 7468 6174 2066 6f6c 6c6f 7720 ake that follow │ │ │ │ │ -0001b430: 7369 6d69 6c61 7220 7072 696e 6369 706c similar principl │ │ │ │ │ -0001b440: 6573 2074 6f0a 616c 6c6f 7720 7573 6572 es to.allow user │ │ │ │ │ -0001b450: 206f 7074 696f 6e73 2e20 2046 6f72 2069 options. For i │ │ │ │ │ -0001b460: 6e73 7461 6e63 652c 2054 6578 696e 666f nstance, Texinfo │ │ │ │ │ -0001b470: 2072 756c 6573 2028 2a6e 6f74 6520 5465 rules (*note Te │ │ │ │ │ -0001b480: 7869 6e66 6f3a 3a29 2075 7365 0a27 4d41 xinfo::) use.'MA │ │ │ │ │ -0001b490: 4b45 494e 464f 464c 4147 5327 2061 6e64 KEINFOFLAGS' and │ │ │ │ │ -0001b4a0: 2027 414d 5f4d 414b 4549 4e46 4f46 4c41 'AM_MAKEINFOFLA │ │ │ │ │ -0001b4b0: 4753 272e 2020 5369 6d69 6c61 726c 792c GS'. Similarly, │ │ │ │ │ -0001b4c0: 2044 656a 6147 6e75 2074 6573 7473 2028 DejaGnu tests ( │ │ │ │ │ -0001b4d0: 2a6e 6f74 650a 4465 6a61 476e 7520 5465 *note.DejaGnu Te │ │ │ │ │ -0001b4e0: 7374 733a 3a29 2075 7365 2027 5255 4e54 sts::) use 'RUNT │ │ │ │ │ -0001b4f0: 4553 5444 4546 4155 4c54 464c 4147 5327 ESTDEFAULTFLAGS' │ │ │ │ │ -0001b500: 2061 6e64 2027 414d 5f52 554e 5445 5354 and 'AM_RUNTEST │ │ │ │ │ -0001b510: 4445 4641 554c 5446 4c41 4753 272e 0a54 DEFAULTFLAGS'..T │ │ │ │ │ -0001b520: 6865 2074 6167 7320 616e 6420 6374 6167 he tags and ctag │ │ │ │ │ -0001b530: 7320 7275 6c65 7320 282a 6e6f 7465 2054 s rules (*note T │ │ │ │ │ -0001b540: 6167 733a 3a29 2075 7365 2027 4554 4147 ags::) use 'ETAG │ │ │ │ │ -0001b550: 5346 4c41 4753 272c 0a27 414d 5f45 5441 SFLAGS',.'AM_ETA │ │ │ │ │ -0001b560: 4753 464c 4147 5327 2c20 2743 5441 4753 GSFLAGS', 'CTAGS │ │ │ │ │ -0001b570: 464c 4147 5327 2c20 616e 6420 2741 4d5f FLAGS', and 'AM_ │ │ │ │ │ -0001b580: 4354 4147 5346 4c41 4753 272e 2020 4a61 CTAGSFLAGS'. Ja │ │ │ │ │ -0001b590: 7661 2072 756c 6573 2028 2a6e 6f74 650a va rules (*note. │ │ │ │ │ -0001b5a0: 4a61 7661 3a3a 2920 7573 6520 274a 4156 Java::) use 'JAV │ │ │ │ │ -0001b5b0: 4143 464c 4147 5327 2061 6e64 2027 414d ACFLAGS' and 'AM │ │ │ │ │ -0001b5c0: 5f4a 4156 4143 464c 4147 5327 2e20 204e _JAVACFLAGS'. N │ │ │ │ │ -0001b5d0: 6f6e 6520 6f66 2074 6865 7365 2072 756c one of these rul │ │ │ │ │ -0001b5e0: 6573 0a73 7570 706f 7274 2070 6572 2d74 es.support per-t │ │ │ │ │ -0001b5f0: 6172 6765 7420 666c 6167 7320 2879 6574 arget flags (yet │ │ │ │ │ -0001b600: 292e 0a0a 2020 2054 6f20 736f 6d65 2065 )... To some e │ │ │ │ │ -0001b610: 7874 656e 742c 2065 7665 6e20 2741 4d5f xtent, even 'AM_ │ │ │ │ │ -0001b620: 4d41 4b45 464c 4147 5327 2028 2a6e 6f74 MAKEFLAGS' (*not │ │ │ │ │ -0001b630: 6520 5375 6264 6972 6563 746f 7269 6573 e Subdirectories │ │ │ │ │ -0001b640: 3a3a 2920 6f62 6579 730a 7468 6973 206e ::) obeys.this n │ │ │ │ │ -0001b650: 616d 696e 6720 7363 6865 6d65 2e20 2054 aming scheme. T │ │ │ │ │ -0001b660: 6865 2073 6c69 6768 7420 6469 6666 6572 he slight differ │ │ │ │ │ -0001b670: 656e 6365 2069 7320 7468 6174 2027 4d41 ence is that 'MA │ │ │ │ │ -0001b680: 4b45 464c 4147 5327 2069 7320 7061 7373 KEFLAGS' is pass │ │ │ │ │ -0001b690: 6564 0a74 6f20 7375 622d 276d 616b 6527 ed.to sub-'make' │ │ │ │ │ -0001b6a0: 7320 696d 706c 6963 6974 6c79 2062 7920 s implicitly by │ │ │ │ │ -0001b6b0: 276d 616b 6527 2069 7473 656c 662e 0a0a 'make' itself... │ │ │ │ │ -0001b6c0: 2020 2048 6f77 6576 6572 2079 6f75 2073 However you s │ │ │ │ │ -0001b6d0: 686f 756c 6420 6e6f 7420 7468 696e 6b20 hould not think │ │ │ │ │ -0001b6e0: 7468 6174 2061 6c6c 2076 6172 6961 626c that all variabl │ │ │ │ │ -0001b6f0: 6573 2065 6e64 696e 6720 7769 7468 2027 es ending with ' │ │ │ │ │ -0001b700: 464c 4147 5327 0a66 6f6c 6c6f 7720 7468 FLAGS'.follow th │ │ │ │ │ -0001b710: 6973 2063 6f6e 7665 6e74 696f 6e2e 2020 is convention. │ │ │ │ │ -0001b720: 466f 7220 696e 7374 616e 6365 2c20 2744 For instance, 'D │ │ │ │ │ -0001b730: 4953 5443 4845 434b 5f43 4f4e 4649 4755 ISTCHECK_CONFIGU │ │ │ │ │ -0001b740: 5245 5f46 4c41 4753 270a 282a 6e6f 7465 RE_FLAGS'.(*note │ │ │ │ │ -0001b750: 2043 6865 636b 696e 6720 7468 6520 4469 Checking the Di │ │ │ │ │ -0001b760: 7374 7269 6275 7469 6f6e 3a3a 2920 616e stribution::) an │ │ │ │ │ -0001b770: 6420 2741 434c 4f43 414c 5f41 4d46 4c41 d 'ACLOCAL_AMFLA │ │ │ │ │ -0001b780: 4753 2720 2873 6565 202a 6e6f 7465 0a52 GS' (see *note.R │ │ │ │ │ -0001b790: 6562 7569 6c64 696e 673a 3a20 616e 6420 ebuilding:: and │ │ │ │ │ -0001b7a0: 2a6e 6f74 6520 4c6f 6361 6c20 4d61 6372 *note Local Macr │ │ │ │ │ -0001b7b0: 6f73 3a3a 292c 2061 7265 2074 776f 2076 os::), are two v │ │ │ │ │ -0001b7c0: 6172 6961 626c 6573 2074 6861 7420 6172 ariables that ar │ │ │ │ │ -0001b7d0: 6520 6f6e 6c79 0a75 7365 6675 6c20 746f e only.useful to │ │ │ │ │ -0001b7e0: 2074 6865 206d 6169 6e74 6169 6e65 7220 the maintainer │ │ │ │ │ -0001b7f0: 616e 6420 6861 7665 206e 6f20 7573 6572 and have no user │ │ │ │ │ -0001b800: 2063 6f75 6e74 6572 7061 7274 2e0a 0a20 counterpart... │ │ │ │ │ -0001b810: 2020 2741 5246 4c41 4753 2720 282a 6e6f 'ARFLAGS' (*no │ │ │ │ │ -0001b820: 7465 2041 204c 6962 7261 7279 3a3a 2920 te A Library::) │ │ │ │ │ -0001b830: 6973 2075 7375 616c 6c79 2064 6566 696e is usually defin │ │ │ │ │ -0001b840: 6564 2062 7920 4175 746f 6d61 6b65 2061 ed by Automake a │ │ │ │ │ -0001b850: 6e64 2068 6173 0a6e 6569 7468 6572 2027 nd has.neither ' │ │ │ │ │ -0001b860: 414d 5f27 206e 6f72 2070 6572 2d74 6172 AM_' nor per-tar │ │ │ │ │ -0001b870: 6765 7420 636f 7573 696e 2e0a 0a20 2020 get cousin... │ │ │ │ │ -0001b880: 4669 6e61 6c6c 7920 796f 7520 7368 6f75 Finally you shou │ │ │ │ │ -0001b890: 6c64 206e 6f74 2074 6869 6e6b 2074 6861 ld not think tha │ │ │ │ │ -0001b8a0: 7420 7468 6520 6578 6973 7465 6e63 6520 t the existence │ │ │ │ │ -0001b8b0: 6f66 2061 2070 6572 2d74 6172 6765 740a of a per-target. │ │ │ │ │ -0001b8c0: 7661 7269 6162 6c65 2069 6d70 6c69 6573 variable implies │ │ │ │ │ -0001b8d0: 2074 6865 2065 7869 7374 616e 6365 206f the existance o │ │ │ │ │ -0001b8e0: 6620 616e 2027 414d 5f27 2076 6172 6961 f an 'AM_' varia │ │ │ │ │ -0001b8f0: 626c 6520 6f72 206f 6620 6120 7573 6572 ble or of a user │ │ │ │ │ -0001b900: 0a76 6172 6961 626c 652e 2020 466f 7220 .variable. For │ │ │ │ │ -0001b910: 696e 7374 616e 6365 2c20 7468 6520 276d instance, the 'm │ │ │ │ │ -0001b920: 756d 626c 655f 4c44 4144 4427 2070 6572 umble_LDADD' per │ │ │ │ │ -0001b930: 2d74 6172 6765 7420 7661 7269 6162 6c65 -target variable │ │ │ │ │ -0001b940: 0a6f 7665 7272 6964 6573 2074 6865 206d .overrides the m │ │ │ │ │ -0001b950: 616b 6566 696c 652d 7769 6465 2027 4c44 akefile-wide 'LD │ │ │ │ │ -0001b960: 4144 4427 2076 6172 6961 626c 6520 2877 ADD' variable (w │ │ │ │ │ -0001b970: 6869 6368 2069 7320 6e6f 7420 6120 7573 hich is not a us │ │ │ │ │ -0001b980: 6572 0a76 6172 6961 626c 6529 2c20 616e er.variable), an │ │ │ │ │ -0001b990: 6420 276d 756d 626c 655f 4c49 4241 4444 d 'mumble_LIBADD │ │ │ │ │ -0001b9a0: 2720 6578 6973 7473 206f 6e6c 7920 6173 ' exists only as │ │ │ │ │ -0001b9b0: 2061 2070 6572 2d74 6172 6765 7420 7661 a per-target va │ │ │ │ │ -0001b9c0: 7269 6162 6c65 2e0a 2a4e 6f74 6520 5072 riable..*Note Pr │ │ │ │ │ -0001b9d0: 6f67 7261 6d20 616e 6420 4c69 6272 6172 ogram and Librar │ │ │ │ │ -0001b9e0: 7920 5661 7269 6162 6c65 733a 3a2e 0a0a y Variables::... │ │ │ │ │ -0001b9f0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -0001ba00: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -0001ba10: 653a 2052 656e 616d 6564 204f 626a 6563 e: Renamed Objec │ │ │ │ │ -0001ba20: 7473 2c20 204e 6578 743a 2050 6572 2d4f ts, Next: Per-O │ │ │ │ │ -0001ba30: 626a 6563 7420 466c 6167 732c 2020 5072 bject Flags, Pr │ │ │ │ │ -0001ba40: 6576 3a20 466c 6167 2056 6172 6961 626c ev: Flag Variabl │ │ │ │ │ -0001ba50: 6573 204f 7264 6572 696e 672c 2020 5570 es Ordering, Up │ │ │ │ │ -0001ba60: 3a20 4641 510a 0a32 382e 3720 5768 7920 : FAQ..28.7 Why │ │ │ │ │ -0001ba70: 6172 6520 6f62 6a65 6374 2066 696c 6573 are object files │ │ │ │ │ -0001ba80: 2073 6f6d 6574 696d 6573 2072 656e 616d sometimes renam │ │ │ │ │ -0001ba90: 6564 3f0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ed?.============ │ │ │ │ │ +00019c90: 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 2020 2020 =========.. │ │ │ │ │ +00019ca0: 5768 6174 2069 7320 7468 6520 6469 6666 What is the diff │ │ │ │ │ +00019cb0: 6572 656e 6365 2062 6574 7765 656e 2027 erence between ' │ │ │ │ │ +00019cc0: 414d 5f43 464c 4147 5327 2c20 2743 464c AM_CFLAGS', 'CFL │ │ │ │ │ +00019cd0: 4147 5327 2c20 616e 640a 2020 2020 2027 AGS', and. ' │ │ │ │ │ +00019ce0: 6d75 6d62 6c65 5f43 464c 4147 5327 3f0a mumble_CFLAGS'?. │ │ │ │ │ +00019cf0: 0a20 2020 2020 5768 7920 646f 6573 2027 . Why does ' │ │ │ │ │ +00019d00: 6175 746f 6d61 6b65 2720 6f75 7470 7574 automake' output │ │ │ │ │ +00019d10: 2027 4350 5046 4c41 4753 2720 6166 7465 'CPPFLAGS' afte │ │ │ │ │ +00019d20: 720a 2020 2020 2027 414d 5f43 5050 464c r. 'AM_CPPFL │ │ │ │ │ +00019d30: 4147 5327 206f 6e20 636f 6d70 696c 6520 AGS' on compile │ │ │ │ │ +00019d40: 6c69 6e65 733f 2020 5368 6f75 6c64 6e27 lines? Shouldn' │ │ │ │ │ +00019d50: 7420 6974 2062 6520 7468 6520 636f 6e76 t it be the conv │ │ │ │ │ +00019d60: 6572 7365 3f0a 0a20 2020 2020 4d79 2027 erse?.. My ' │ │ │ │ │ +00019d70: 636f 6e66 6967 7572 6527 2061 6464 7320 configure' adds │ │ │ │ │ +00019d80: 736f 6d65 2077 6172 6e69 6e67 2066 6c61 some warning fla │ │ │ │ │ +00019d90: 6773 2069 6e74 6f20 2743 5858 464c 4147 gs into 'CXXFLAG │ │ │ │ │ +00019da0: 5327 2e20 2049 6e0a 2020 2020 206f 6e65 S'. In. one │ │ │ │ │ +00019db0: 2027 4d61 6b65 6669 6c65 2e61 6d27 2049 'Makefile.am' I │ │ │ │ │ +00019dc0: 2077 6f75 6c64 206c 696b 6520 746f 2061 would like to a │ │ │ │ │ +00019dd0: 7070 656e 6420 6120 6e65 7720 666c 6167 ppend a new flag │ │ │ │ │ +00019de0: 2c20 686f 7765 7665 7220 6966 2049 0a20 , however if I. │ │ │ │ │ +00019df0: 2020 2020 7075 7420 7468 6520 666c 6167 put the flag │ │ │ │ │ +00019e00: 2069 6e74 6f20 2741 4d5f 4358 5846 4c41 into 'AM_CXXFLA │ │ │ │ │ +00019e10: 4753 2720 6974 2069 7320 7072 6570 656e GS' it is prepen │ │ │ │ │ +00019e20: 6465 6420 746f 2074 6865 206f 7468 6572 ded to the other │ │ │ │ │ +00019e30: 0a20 2020 2020 666c 6167 732c 206e 6f74 . flags, not │ │ │ │ │ +00019e40: 2061 7070 656e 6465 642e 0a0a 436f 6d70 appended...Comp │ │ │ │ │ +00019e50: 696c 6520 466c 6167 2056 6172 6961 626c ile Flag Variabl │ │ │ │ │ +00019e60: 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d es.------------- │ │ │ │ │ +00019e70: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 ---------..This │ │ │ │ │ +00019e80: 7365 6374 696f 6e20 6174 7465 6d70 7473 section attempts │ │ │ │ │ +00019e90: 2074 6f20 616e 7377 6572 2061 6c6c 2074 to answer all t │ │ │ │ │ +00019ea0: 6865 2061 626f 7665 2071 7565 7374 696f he above questio │ │ │ │ │ +00019eb0: 6e73 2e20 2057 6520 7769 6c6c 206d 6f73 ns. We will mos │ │ │ │ │ +00019ec0: 746c 790a 6469 7363 7573 7320 2743 5050 tly.discuss 'CPP │ │ │ │ │ +00019ed0: 464c 4147 5327 2069 6e20 6f75 7220 6578 FLAGS' in our ex │ │ │ │ │ +00019ee0: 616d 706c 6573 2c20 6275 7420 6163 7475 amples, but actu │ │ │ │ │ +00019ef0: 616c 6c79 2074 6865 2061 6e73 7765 7220 ally the answer │ │ │ │ │ +00019f00: 686f 6c64 7320 666f 720a 616c 6c20 7468 holds for.all th │ │ │ │ │ +00019f10: 6520 636f 6d70 696c 6520 666c 6167 7320 e compile flags │ │ │ │ │ +00019f20: 7573 6564 2069 6e20 4175 746f 6d61 6b65 used in Automake │ │ │ │ │ +00019f30: 3a20 2743 4341 5346 4c41 4753 272c 2027 : 'CCASFLAGS', ' │ │ │ │ │ +00019f40: 4346 4c41 4753 272c 0a27 4350 5046 4c41 CFLAGS',.'CPPFLA │ │ │ │ │ +00019f50: 4753 272c 2027 4358 5846 4c41 4753 272c GS', 'CXXFLAGS', │ │ │ │ │ +00019f60: 2027 4643 464c 4147 5327 2c20 2746 464c 'FCFLAGS', 'FFL │ │ │ │ │ +00019f70: 4147 5327 2c20 2747 434a 464c 4147 5327 AGS', 'GCJFLAGS' │ │ │ │ │ +00019f80: 2c20 274c 4446 4c41 4753 272c 0a27 4c46 , 'LDFLAGS',.'LF │ │ │ │ │ +00019f90: 4c41 4753 272c 2027 4c49 4254 4f4f 4c46 LAGS', 'LIBTOOLF │ │ │ │ │ +00019fa0: 4c41 4753 272c 2027 4f42 4a43 464c 4147 LAGS', 'OBJCFLAG │ │ │ │ │ +00019fb0: 5327 2c20 2752 464c 4147 5327 2c20 2755 S', 'RFLAGS', 'U │ │ │ │ │ +00019fc0: 5043 464c 4147 5327 2c20 616e 640a 2759 PCFLAGS', and.'Y │ │ │ │ │ +00019fd0: 464c 4147 5327 2e0a 0a20 2020 2743 5050 FLAGS'... 'CPP │ │ │ │ │ +00019fe0: 464c 4147 5327 2c20 2741 4d5f 4350 5046 FLAGS', 'AM_CPPF │ │ │ │ │ +00019ff0: 4c41 4753 272c 2061 6e64 2027 6d75 6d62 LAGS', and 'mumb │ │ │ │ │ +0001a000: 6c65 5f43 5050 464c 4147 5327 2061 7265 le_CPPFLAGS' are │ │ │ │ │ +0001a010: 2074 6872 6565 2076 6172 6961 626c 6573 three variables │ │ │ │ │ +0001a020: 0a74 6861 7420 6361 6e20 6265 2075 7365 .that can be use │ │ │ │ │ +0001a030: 6420 746f 2070 6173 7320 666c 6167 7320 d to pass flags │ │ │ │ │ +0001a040: 746f 2074 6865 2043 2070 7265 7072 6f63 to the C preproc │ │ │ │ │ +0001a050: 6573 736f 7220 2861 6374 7561 6c6c 7920 essor (actually │ │ │ │ │ +0001a060: 7468 6573 650a 7661 7269 6162 6c65 7320 these.variables │ │ │ │ │ +0001a070: 6172 6520 616c 736f 2075 7365 6420 666f are also used fo │ │ │ │ │ +0001a080: 7220 6f74 6865 7220 6c61 6e67 7561 6765 r other language │ │ │ │ │ +0001a090: 7320 6c69 6b65 2043 2b2b 206f 7220 7072 s like C++ or pr │ │ │ │ │ +0001a0a0: 6570 726f 6365 7373 6564 0a46 6f72 7472 eprocessed.Fortr │ │ │ │ │ +0001a0b0: 616e 292e 2020 2743 5050 464c 4147 5327 an). 'CPPFLAGS' │ │ │ │ │ +0001a0c0: 2069 7320 7468 6520 7573 6572 2076 6172 is the user var │ │ │ │ │ +0001a0d0: 6961 626c 6520 282a 6e6f 7465 2055 7365 iable (*note Use │ │ │ │ │ +0001a0e0: 7220 5661 7269 6162 6c65 733a 3a29 2c0a r Variables::),. │ │ │ │ │ +0001a0f0: 2741 4d5f 4350 5046 4c41 4753 2720 6973 'AM_CPPFLAGS' is │ │ │ │ │ +0001a100: 2074 6865 2041 7574 6f6d 616b 6520 7661 the Automake va │ │ │ │ │ +0001a110: 7269 6162 6c65 2c20 616e 6420 276d 756d riable, and 'mum │ │ │ │ │ +0001a120: 626c 655f 4350 5046 4c41 4753 2720 6973 ble_CPPFLAGS' is │ │ │ │ │ +0001a130: 2074 6865 0a76 6172 6961 626c 6520 7370 the.variable sp │ │ │ │ │ +0001a140: 6563 6966 6963 2074 6f20 7468 6520 276d ecific to the 'm │ │ │ │ │ +0001a150: 756d 626c 6527 2074 6172 6765 7420 2877 umble' target (w │ │ │ │ │ +0001a160: 6520 6361 6c6c 2074 6869 7320 6120 7065 e call this a pe │ │ │ │ │ +0001a170: 722d 7461 7267 6574 0a76 6172 6961 626c r-target.variabl │ │ │ │ │ +0001a180: 652c 202a 6e6f 7465 2050 726f 6772 616d e, *note Program │ │ │ │ │ +0001a190: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ +0001a1a0: 6961 626c 6573 3a3a 292e 0a0a 2020 2041 iables::)... A │ │ │ │ │ +0001a1b0: 7574 6f6d 616b 6520 616c 7761 7973 2075 utomake always u │ │ │ │ │ +0001a1c0: 7365 7320 7477 6f20 6f66 2074 6865 7365 ses two of these │ │ │ │ │ +0001a1d0: 2076 6172 6961 626c 6573 2077 6865 6e20 variables when │ │ │ │ │ +0001a1e0: 636f 6d70 696c 696e 6720 4320 736f 7572 compiling C sour │ │ │ │ │ +0001a1f0: 6365 730a 6669 6c65 732e 2020 5768 656e ces.files. When │ │ │ │ │ +0001a200: 2063 6f6d 7069 6c69 6e67 2061 6e20 6f62 compiling an ob │ │ │ │ │ +0001a210: 6a65 6374 2066 696c 6520 666f 7220 7468 ject file for th │ │ │ │ │ +0001a220: 6520 276d 756d 626c 6527 2074 6172 6765 e 'mumble' targe │ │ │ │ │ +0001a230: 742c 2074 6865 2066 6972 7374 0a76 6172 t, the first.var │ │ │ │ │ +0001a240: 6961 626c 6520 7769 6c6c 2062 6520 276d iable will be 'm │ │ │ │ │ +0001a250: 756d 626c 655f 4350 5046 4c41 4753 2720 umble_CPPFLAGS' │ │ │ │ │ +0001a260: 6966 2069 7420 6973 2064 6566 696e 6564 if it is defined │ │ │ │ │ +0001a270: 2c20 6f72 2027 414d 5f43 5050 464c 4147 , or 'AM_CPPFLAG │ │ │ │ │ +0001a280: 5327 0a6f 7468 6572 7769 7365 2e20 2054 S'.otherwise. T │ │ │ │ │ +0001a290: 6865 2073 6563 6f6e 6420 7661 7269 6162 he second variab │ │ │ │ │ +0001a2a0: 6c65 2069 7320 616c 7761 7973 2027 4350 le is always 'CP │ │ │ │ │ +0001a2b0: 5046 4c41 4753 272e 0a0a 2020 2049 6e20 PFLAGS'... In │ │ │ │ │ +0001a2c0: 7468 6520 666f 6c6c 6f77 696e 6720 6578 the following ex │ │ │ │ │ +0001a2d0: 616d 706c 652c 0a0a 2020 2020 2062 696e ample,.. bin │ │ │ │ │ +0001a2e0: 5f50 524f 4752 414d 5320 3d20 666f 6f20 _PROGRAMS = foo │ │ │ │ │ +0001a2f0: 6261 720a 2020 2020 2066 6f6f 5f53 4f55 bar. foo_SOU │ │ │ │ │ +0001a300: 5243 4553 203d 2078 797a 2e63 0a20 2020 RCES = xyz.c. │ │ │ │ │ +0001a310: 2020 6261 725f 534f 5552 4345 5320 3d20 bar_SOURCES = │ │ │ │ │ +0001a320: 6d61 696e 2e63 0a20 2020 2020 666f 6f5f main.c. foo_ │ │ │ │ │ +0001a330: 4350 5046 4c41 4753 203d 202d 4446 4f4f CPPFLAGS = -DFOO │ │ │ │ │ +0001a340: 0a20 2020 2020 414d 5f43 5050 464c 4147 . AM_CPPFLAG │ │ │ │ │ +0001a350: 5320 3d20 2d44 4241 5a0a 0a27 7879 7a2e S = -DBAZ..'xyz. │ │ │ │ │ +0001a360: 6f27 2077 696c 6c20 6265 2063 6f6d 7069 o' will be compi │ │ │ │ │ +0001a370: 6c65 6420 7769 7468 2027 2428 666f 6f5f led with '$(foo_ │ │ │ │ │ +0001a380: 4350 5046 4c41 4753 2920 2428 4350 5046 CPPFLAGS) $(CPPF │ │ │ │ │ +0001a390: 4c41 4753 2927 2c20 2862 6563 6175 7365 LAGS)', (because │ │ │ │ │ +0001a3a0: 0a27 7879 7a2e 6f27 2069 7320 7061 7274 .'xyz.o' is part │ │ │ │ │ +0001a3b0: 206f 6620 7468 6520 2766 6f6f 2720 7461 of the 'foo' ta │ │ │ │ │ +0001a3c0: 7267 6574 292c 2077 6869 6c65 2027 6d61 rget), while 'ma │ │ │ │ │ +0001a3d0: 696e 2e6f 2720 7769 6c6c 2062 6520 636f in.o' will be co │ │ │ │ │ +0001a3e0: 6d70 696c 6564 0a77 6974 6820 2724 2841 mpiled.with '$(A │ │ │ │ │ +0001a3f0: 4d5f 4350 5046 4c41 4753 2920 2428 4350 M_CPPFLAGS) $(CP │ │ │ │ │ +0001a400: 5046 4c41 4753 2927 2028 6265 6361 7573 PFLAGS)' (becaus │ │ │ │ │ +0001a410: 6520 7468 6572 6520 6973 206e 6f20 7065 e there is no pe │ │ │ │ │ +0001a420: 722d 7461 7267 6574 0a76 6172 6961 626c r-target.variabl │ │ │ │ │ +0001a430: 6520 666f 7220 7461 7267 6574 2027 6261 e for target 'ba │ │ │ │ │ +0001a440: 7227 292e 0a0a 2020 2054 6865 2064 6966 r')... The dif │ │ │ │ │ +0001a450: 6665 7265 6e63 6520 6265 7477 6565 6e20 ference between │ │ │ │ │ +0001a460: 276d 756d 626c 655f 4350 5046 4c41 4753 'mumble_CPPFLAGS │ │ │ │ │ +0001a470: 2720 616e 6420 2741 4d5f 4350 5046 4c41 ' and 'AM_CPPFLA │ │ │ │ │ +0001a480: 4753 2720 6265 696e 670a 636c 6561 7220 GS' being.clear │ │ │ │ │ +0001a490: 656e 6f75 6768 2c20 6c65 7427 7320 666f enough, let's fo │ │ │ │ │ +0001a4a0: 6375 7320 6f6e 2027 4350 5046 4c41 4753 cus on 'CPPFLAGS │ │ │ │ │ +0001a4b0: 272e 2020 2743 5050 464c 4147 5327 2069 '. 'CPPFLAGS' i │ │ │ │ │ +0001a4c0: 7320 6120 7573 6572 2076 6172 6961 626c s a user variabl │ │ │ │ │ +0001a4d0: 652c 0a69 2e65 2e2c 2061 2076 6172 6961 e,.i.e., a varia │ │ │ │ │ +0001a4e0: 626c 6520 7468 6174 2075 7365 7273 2061 ble that users a │ │ │ │ │ +0001a4f0: 7265 2065 6e74 6974 6c65 6420 746f 206d re entitled to m │ │ │ │ │ +0001a500: 6f64 6966 7920 696e 206f 7264 6572 2074 odify in order t │ │ │ │ │ +0001a510: 6f20 636f 6d70 696c 650a 7468 6520 7061 o compile.the pa │ │ │ │ │ +0001a520: 636b 6167 652e 2020 5468 6973 2076 6172 ckage. This var │ │ │ │ │ +0001a530: 6961 626c 652c 206c 696b 6520 6d61 6e79 iable, like many │ │ │ │ │ +0001a540: 206f 7468 6572 732c 2069 7320 646f 6375 others, is docu │ │ │ │ │ +0001a550: 6d65 6e74 6564 2061 7420 7468 6520 656e mented at the en │ │ │ │ │ +0001a560: 640a 6f66 2074 6865 206f 7574 7075 7420 d.of the output │ │ │ │ │ +0001a570: 6f66 2027 636f 6e66 6967 7572 6520 2d2d of 'configure -- │ │ │ │ │ +0001a580: 6865 6c70 272e 0a0a 2020 2046 6f72 2069 help'... For i │ │ │ │ │ +0001a590: 6e73 7461 6e63 652c 2073 6f6d 656f 6e65 nstance, someone │ │ │ │ │ +0001a5a0: 2077 686f 206e 6565 6473 2074 6f20 6164 who needs to ad │ │ │ │ │ +0001a5b0: 6420 272f 686f 6d65 2f6d 792f 7573 722f d '/home/my/usr/ │ │ │ │ │ +0001a5c0: 696e 636c 7564 6527 2074 6f20 7468 650a include' to the. │ │ │ │ │ +0001a5d0: 4320 636f 6d70 696c 6572 2773 2073 6561 C compiler's sea │ │ │ │ │ +0001a5e0: 7263 6820 7061 7468 2077 6f75 6c64 2063 rch path would c │ │ │ │ │ +0001a5f0: 6f6e 6669 6775 7265 2061 2070 6163 6b61 onfigure a packa │ │ │ │ │ +0001a600: 6765 2077 6974 680a 0a20 2020 2020 2e2f ge with.. ./ │ │ │ │ │ +0001a610: 636f 6e66 6967 7572 6520 4350 5046 4c41 configure CPPFLA │ │ │ │ │ +0001a620: 4753 3d27 2d49 202f 686f 6d65 2f6d 792f GS='-I /home/my/ │ │ │ │ │ +0001a630: 7573 722f 696e 636c 7564 6527 0a0a 616e usr/include'..an │ │ │ │ │ +0001a640: 6420 7468 6973 2066 6c61 6720 776f 756c d this flag woul │ │ │ │ │ +0001a650: 6420 6265 2070 726f 7061 6761 7465 6420 d be propagated │ │ │ │ │ +0001a660: 746f 2074 6865 2063 6f6d 7069 6c65 2072 to the compile r │ │ │ │ │ +0001a670: 756c 6573 206f 6620 616c 6c0a 274d 616b ules of all.'Mak │ │ │ │ │ +0001a680: 6566 696c 6527 732e 0a0a 2020 2049 7420 efile's... It │ │ │ │ │ +0001a690: 6973 2061 6c73 6f20 6e6f 7420 756e 636f is also not unco │ │ │ │ │ +0001a6a0: 6d6d 6f6e 2074 6f20 6f76 6572 7269 6465 mmon to override │ │ │ │ │ +0001a6b0: 2061 2075 7365 7220 7661 7269 6162 6c65 a user variable │ │ │ │ │ +0001a6c0: 2061 7420 276d 616b 6527 2d74 696d 652e at 'make'-time. │ │ │ │ │ +0001a6d0: 0a4d 616e 7920 696e 7374 616c 6c65 7273 .Many installers │ │ │ │ │ +0001a6e0: 2064 6f20 7468 6973 2077 6974 6820 2770 do this with 'p │ │ │ │ │ +0001a6f0: 7265 6669 7827 2c20 6275 7420 7468 6973 refix', but this │ │ │ │ │ +0001a700: 2063 616e 2062 6520 7573 6566 756c 2077 can be useful w │ │ │ │ │ +0001a710: 6974 680a 636f 6d70 696c 6572 2066 6c61 ith.compiler fla │ │ │ │ │ +0001a720: 6773 2074 6f6f 2e20 2046 6f72 2069 6e73 gs too. For ins │ │ │ │ │ +0001a730: 7461 6e63 652c 2069 662c 2077 6869 6c65 tance, if, while │ │ │ │ │ +0001a740: 2064 6562 7567 6769 6e67 2061 2043 2b2b debugging a C++ │ │ │ │ │ +0001a750: 2070 726f 6a65 6374 2c0a 796f 7520 6e65 project,.you ne │ │ │ │ │ +0001a760: 6564 2074 6f20 6469 7361 626c 6520 6f70 ed to disable op │ │ │ │ │ +0001a770: 7469 6d69 7a61 7469 6f6e 2069 6e20 6f6e timization in on │ │ │ │ │ +0001a780: 6520 7370 6563 6966 6963 206f 626a 6563 e specific objec │ │ │ │ │ +0001a790: 7420 6669 6c65 2c20 796f 7520 6361 6e0a t file, you can. │ │ │ │ │ +0001a7a0: 7275 6e20 736f 6d65 7468 696e 6720 6c69 run something li │ │ │ │ │ +0001a7b0: 6b65 0a0a 2020 2020 2072 6d20 6669 6c65 ke.. rm file │ │ │ │ │ +0001a7c0: 2e6f 0a20 2020 2020 6d61 6b65 2043 5858 .o. make CXX │ │ │ │ │ +0001a7d0: 464c 4147 533d 2d4f 3020 6669 6c65 2e6f FLAGS=-O0 file.o │ │ │ │ │ +0001a7e0: 0a20 2020 2020 6d61 6b65 0a0a 2020 2054 . make.. T │ │ │ │ │ +0001a7f0: 6865 2072 6561 736f 6e20 2724 2843 5050 he reason '$(CPP │ │ │ │ │ +0001a800: 464c 4147 5329 2720 6170 7065 6172 7320 FLAGS)' appears │ │ │ │ │ +0001a810: 6166 7465 7220 2724 2841 4d5f 4350 5046 after '$(AM_CPPF │ │ │ │ │ +0001a820: 4c41 4753 2927 206f 720a 2724 286d 756d LAGS)' or.'$(mum │ │ │ │ │ +0001a830: 626c 655f 4350 5046 4c41 4753 2927 2069 ble_CPPFLAGS)' i │ │ │ │ │ +0001a840: 6e20 7468 6520 636f 6d70 696c 6520 636f n the compile co │ │ │ │ │ +0001a850: 6d6d 616e 6420 6973 2074 6861 7420 7573 mmand is that us │ │ │ │ │ +0001a860: 6572 7320 7368 6f75 6c64 2061 6c77 6179 ers should alway │ │ │ │ │ +0001a870: 730a 6861 7665 2074 6865 206c 6173 7420 s.have the last │ │ │ │ │ +0001a880: 7361 792e 2020 4974 2070 726f 6261 626c say. It probabl │ │ │ │ │ +0001a890: 7920 6d61 6b65 7320 6d6f 7265 2073 656e y makes more sen │ │ │ │ │ +0001a8a0: 7365 2069 6620 796f 7520 7468 696e 6b20 se if you think │ │ │ │ │ +0001a8b0: 6162 6f75 7420 6974 0a77 6869 6c65 206c about it.while l │ │ │ │ │ +0001a8c0: 6f6f 6b69 6e67 2061 7420 7468 6520 2743 ooking at the 'C │ │ │ │ │ +0001a8d0: 5858 464c 4147 533d 2d4f 3027 2061 626f XXFLAGS=-O0' abo │ │ │ │ │ +0001a8e0: 7665 2c20 7768 6963 6820 7368 6f75 6c64 ve, which should │ │ │ │ │ +0001a8f0: 2073 7570 6572 7365 6465 2061 6e79 0a6f supersede any.o │ │ │ │ │ +0001a900: 7468 6572 2073 7769 7463 6820 6672 6f6d ther switch from │ │ │ │ │ +0001a910: 2027 414d 5f43 5858 464c 4147 5327 206f 'AM_CXXFLAGS' o │ │ │ │ │ +0001a920: 7220 276d 756d 626c 655f 4358 5846 4c41 r 'mumble_CXXFLA │ │ │ │ │ +0001a930: 4753 2720 2861 6e64 2074 6869 7320 6f66 GS' (and this of │ │ │ │ │ +0001a940: 2063 6f75 7273 650a 7265 706c 6163 6573 course.replaces │ │ │ │ │ +0001a950: 2074 6865 2070 7265 7669 6f75 7320 7661 the previous va │ │ │ │ │ +0001a960: 6c75 6520 6f66 2027 4358 5846 4c41 4753 lue of 'CXXFLAGS │ │ │ │ │ +0001a970: 2729 2e0a 0a20 2020 596f 7520 7368 6f75 ')... You shou │ │ │ │ │ +0001a980: 6c64 206e 6576 6572 2072 6564 6566 696e ld never redefin │ │ │ │ │ +0001a990: 6520 6120 7573 6572 2076 6172 6961 626c e a user variabl │ │ │ │ │ +0001a9a0: 6520 7375 6368 2061 7320 2743 5050 464c e such as 'CPPFL │ │ │ │ │ +0001a9b0: 4147 5327 2069 6e0a 274d 616b 6566 696c AGS' in.'Makefil │ │ │ │ │ +0001a9c0: 652e 616d 272e 2020 5573 6520 2761 7574 e.am'. Use 'aut │ │ │ │ │ +0001a9d0: 6f6d 616b 6520 2d57 6f76 6572 7269 6465 omake -Woverride │ │ │ │ │ +0001a9e0: 2720 746f 2064 6961 676e 6f73 6520 7375 ' to diagnose su │ │ │ │ │ +0001a9f0: 6368 206d 6973 7461 6b65 732e 0a45 7665 ch mistakes..Eve │ │ │ │ │ +0001aa00: 6e20 736f 6d65 7468 696e 6720 6c69 6b65 n something like │ │ │ │ │ +0001aa10: 0a0a 2020 2020 2043 5050 464c 4147 5320 .. CPPFLAGS │ │ │ │ │ +0001aa20: 3d20 2d44 4441 5441 4449 523d 5c22 2428 = -DDATADIR=\"$( │ │ │ │ │ +0001aa30: 6461 7461 6469 7229 5c22 2040 4350 5046 datadir)\" @CPPF │ │ │ │ │ +0001aa40: 4c41 4753 400a 0a69 7320 6572 726f 6e65 LAGS@..is errone │ │ │ │ │ +0001aa50: 6f75 732e 2020 416c 7468 6f75 6768 2074 ous. Although t │ │ │ │ │ +0001aa60: 6869 7320 7072 6573 6572 7665 7320 2763 his preserves 'c │ │ │ │ │ +0001aa70: 6f6e 6669 6775 7265 2727 7320 7661 6c75 onfigure''s valu │ │ │ │ │ +0001aa80: 6520 6f66 0a27 4350 5046 4c41 4753 272c e of.'CPPFLAGS', │ │ │ │ │ +0001aa90: 2074 6865 2064 6566 696e 6974 696f 6e20 the definition │ │ │ │ │ +0001aaa0: 6f66 2027 4441 5441 4449 5227 2077 696c of 'DATADIR' wil │ │ │ │ │ +0001aab0: 6c20 6469 7361 7070 6561 7220 6966 2061 l disappear if a │ │ │ │ │ +0001aac0: 2075 7365 720a 6174 7465 6d70 7473 2074 user.attempts t │ │ │ │ │ +0001aad0: 6f20 6f76 6572 7269 6465 2027 4350 5046 o override 'CPPF │ │ │ │ │ +0001aae0: 4c41 4753 2720 6672 6f6d 2074 6865 2027 LAGS' from the ' │ │ │ │ │ +0001aaf0: 6d61 6b65 2720 636f 6d6d 616e 6420 6c69 make' command li │ │ │ │ │ +0001ab00: 6e65 2e0a 0a20 2020 2020 414d 5f43 5050 ne... AM_CPP │ │ │ │ │ +0001ab10: 464c 4147 5320 3d20 2d44 4441 5441 4449 FLAGS = -DDATADI │ │ │ │ │ +0001ab20: 523d 5c22 2428 6461 7461 6469 7229 5c22 R=\"$(datadir)\" │ │ │ │ │ +0001ab30: 0a0a 6973 2061 6c6c 2074 6861 7420 6973 ..is all that is │ │ │ │ │ +0001ab40: 206e 6565 6465 6420 6865 7265 2069 6620 needed here if │ │ │ │ │ +0001ab50: 6e6f 2070 6572 2d74 6172 6765 7420 666c no per-target fl │ │ │ │ │ +0001ab60: 6167 7320 6172 6520 7573 6564 2e0a 0a20 ags are used... │ │ │ │ │ +0001ab70: 2020 596f 7520 7368 6f75 6c64 206e 6f74 You should not │ │ │ │ │ +0001ab80: 2061 6464 206f 7074 696f 6e73 2074 6f20 add options to │ │ │ │ │ +0001ab90: 7468 6573 6520 7573 6572 2076 6172 6961 these user varia │ │ │ │ │ +0001aba0: 626c 6573 2077 6974 6869 6e20 2763 6f6e bles within 'con │ │ │ │ │ +0001abb0: 6669 6775 7265 270a 6569 7468 6572 2c20 figure'.either, │ │ │ │ │ +0001abc0: 666f 7220 7468 6520 7361 6d65 2072 6561 for the same rea │ │ │ │ │ +0001abd0: 736f 6e2e 2020 4f63 6361 7369 6f6e 616c son. Occasional │ │ │ │ │ +0001abe0: 6c79 2079 6f75 206e 6565 6420 746f 206d ly you need to m │ │ │ │ │ +0001abf0: 6f64 6966 7920 7468 6573 650a 7661 7269 odify these.vari │ │ │ │ │ +0001ac00: 6162 6c65 7320 746f 2070 6572 666f 726d ables to perform │ │ │ │ │ +0001ac10: 2061 2074 6573 742c 2062 7574 2079 6f75 a test, but you │ │ │ │ │ +0001ac20: 2073 686f 756c 6420 7265 7365 7420 7468 should reset th │ │ │ │ │ +0001ac30: 6569 7220 7661 6c75 6573 0a61 6674 6572 eir values.after │ │ │ │ │ +0001ac40: 7761 7264 732e 2020 496e 2063 6f6e 7472 wards. In contr │ │ │ │ │ +0001ac50: 6173 742c 2069 7420 6973 204f 4b20 746f ast, it is OK to │ │ │ │ │ +0001ac60: 206d 6f64 6966 7920 7468 6520 2741 4d5f modify the 'AM_ │ │ │ │ │ +0001ac70: 2720 7661 7269 6162 6c65 7320 7769 7468 ' variables with │ │ │ │ │ +0001ac80: 696e 0a27 636f 6e66 6967 7572 6527 2069 in.'configure' i │ │ │ │ │ +0001ac90: 6620 796f 7520 2741 435f 5355 4253 5427 f you 'AC_SUBST' │ │ │ │ │ +0001aca0: 2074 6865 6d2c 2062 7574 2069 7420 6973 them, but it is │ │ │ │ │ +0001acb0: 2072 6174 6865 7220 7261 7265 2074 6861 rather rare tha │ │ │ │ │ +0001acc0: 7420 796f 7520 6e65 6564 0a74 6f20 646f t you need.to do │ │ │ │ │ +0001acd0: 2074 6869 732c 2075 6e6c 6573 7320 796f this, unless yo │ │ │ │ │ +0001ace0: 7520 7265 616c 6c79 2077 616e 7420 746f u really want to │ │ │ │ │ +0001acf0: 2063 6861 6e67 6520 7468 6520 6465 6661 change the defa │ │ │ │ │ +0001ad00: 756c 7420 6465 6669 6e69 7469 6f6e 7320 ult definitions │ │ │ │ │ +0001ad10: 6f66 0a74 6865 2027 414d 5f27 2076 6172 of.the 'AM_' var │ │ │ │ │ +0001ad20: 6961 626c 6573 2069 6e20 616c 6c20 274d iables in all 'M │ │ │ │ │ +0001ad30: 616b 6566 696c 6527 732e 0a0a 2020 2057 akefile's... W │ │ │ │ │ +0001ad40: 6861 7420 7765 2072 6563 6f6d 6d65 6e64 hat we recommend │ │ │ │ │ +0001ad50: 2069 7320 7468 6174 2079 6f75 2064 6566 is that you def │ │ │ │ │ +0001ad60: 696e 6520 6578 7472 6120 666c 6167 7320 ine extra flags │ │ │ │ │ +0001ad70: 696e 2073 6570 6172 6174 650a 7661 7269 in separate.vari │ │ │ │ │ +0001ad80: 6162 6c65 732e 2020 466f 7220 696e 7374 ables. For inst │ │ │ │ │ +0001ad90: 616e 6365 2c20 796f 7520 6d61 7920 7772 ance, you may wr │ │ │ │ │ +0001ada0: 6974 6520 616e 2041 7574 6f63 6f6e 6620 ite an Autoconf │ │ │ │ │ +0001adb0: 6d61 6372 6f20 7468 6174 2063 6f6d 7075 macro that compu │ │ │ │ │ +0001adc0: 7465 730a 6120 7365 7420 6f66 2077 6172 tes.a set of war │ │ │ │ │ +0001add0: 6e69 6e67 206f 7074 696f 6e73 2066 6f72 ning options for │ │ │ │ │ +0001ade0: 2074 6865 2043 2063 6f6d 7069 6c65 722c the C compiler, │ │ │ │ │ +0001adf0: 2061 6e64 2027 4143 5f53 5542 5354 2720 and 'AC_SUBST' │ │ │ │ │ +0001ae00: 7468 656d 2069 6e0a 2757 4152 4e49 4e47 them in.'WARNING │ │ │ │ │ +0001ae10: 4346 4c41 4753 273b 2079 6f75 206d 6179 CFLAGS'; you may │ │ │ │ │ +0001ae20: 2061 6c73 6f20 6861 7665 2061 6e20 4175 also have an Au │ │ │ │ │ +0001ae30: 746f 636f 6e66 206d 6163 726f 2074 6861 toconf macro tha │ │ │ │ │ +0001ae40: 7420 6465 7465 726d 696e 6573 0a77 6869 t determines.whi │ │ │ │ │ +0001ae50: 6368 2063 6f6d 7069 6c65 7220 616e 6420 ch compiler and │ │ │ │ │ +0001ae60: 7768 6963 6820 6c69 6e6b 6572 2066 6c61 which linker fla │ │ │ │ │ +0001ae70: 6773 2073 686f 756c 6420 6265 2075 7365 gs should be use │ │ │ │ │ +0001ae80: 6420 746f 206c 696e 6b20 7769 7468 0a6c d to link with.l │ │ │ │ │ +0001ae90: 6962 7261 7279 2027 6c69 6266 6f6f 272c ibrary 'libfoo', │ │ │ │ │ +0001aea0: 2061 6e64 2027 4143 5f53 5542 5354 2720 and 'AC_SUBST' │ │ │ │ │ +0001aeb0: 7468 6573 6520 696e 2027 4c49 4246 4f4f these in 'LIBFOO │ │ │ │ │ +0001aec0: 4346 4c41 4753 2720 616e 640a 274c 4942 CFLAGS' and.'LIB │ │ │ │ │ +0001aed0: 464f 4f4c 4446 4c41 4753 272e 2020 5468 FOOLDFLAGS'. Th │ │ │ │ │ +0001aee0: 656e 2c20 6120 274d 616b 6566 696c 652e en, a 'Makefile. │ │ │ │ │ +0001aef0: 616d 2720 636f 756c 6420 7573 6520 7468 am' could use th │ │ │ │ │ +0001af00: 6573 6520 7661 7269 6162 6c65 7320 6173 ese variables as │ │ │ │ │ +0001af10: 0a66 6f6c 6c6f 7773 3a0a 0a20 2020 2020 .follows:.. │ │ │ │ │ +0001af20: 414d 5f43 464c 4147 5320 3d20 2428 5741 AM_CFLAGS = $(WA │ │ │ │ │ +0001af30: 524e 494e 4743 464c 4147 5329 0a20 2020 RNINGCFLAGS). │ │ │ │ │ +0001af40: 2020 6269 6e5f 5052 4f47 5241 4d53 203d bin_PROGRAMS = │ │ │ │ │ +0001af50: 2070 726f 6731 2070 726f 6732 0a20 2020 prog1 prog2. │ │ │ │ │ +0001af60: 2020 7072 6f67 315f 534f 5552 4345 5320 prog1_SOURCES │ │ │ │ │ +0001af70: 3d20 2e2e 2e0a 2020 2020 2070 726f 6732 = .... prog2 │ │ │ │ │ +0001af80: 5f53 4f55 5243 4553 203d 202e 2e2e 0a20 _SOURCES = .... │ │ │ │ │ +0001af90: 2020 2020 7072 6f67 325f 4346 4c41 4753 prog2_CFLAGS │ │ │ │ │ +0001afa0: 203d 2024 284c 4942 464f 4f43 464c 4147 = $(LIBFOOCFLAG │ │ │ │ │ +0001afb0: 5329 2024 2841 4d5f 4346 4c41 4753 290a S) $(AM_CFLAGS). │ │ │ │ │ +0001afc0: 2020 2020 2070 726f 6732 5f4c 4446 4c41 prog2_LDFLA │ │ │ │ │ +0001afd0: 4753 203d 2024 284c 4942 464f 4f4c 4446 GS = $(LIBFOOLDF │ │ │ │ │ +0001afe0: 4c41 4753 290a 0a20 2020 496e 2074 6869 LAGS).. In thi │ │ │ │ │ +0001aff0: 7320 6578 616d 706c 6520 626f 7468 2070 s example both p │ │ │ │ │ +0001b000: 726f 6772 616d 7320 7769 6c6c 2062 6520 rograms will be │ │ │ │ │ +0001b010: 636f 6d70 696c 6564 2077 6974 6820 7468 compiled with th │ │ │ │ │ +0001b020: 6520 666c 6167 730a 7375 6273 7469 7475 e flags.substitu │ │ │ │ │ +0001b030: 7465 6420 696e 746f 2027 2428 5741 524e ted into '$(WARN │ │ │ │ │ +0001b040: 494e 4743 464c 4147 5329 272c 2061 6e64 INGCFLAGS)', and │ │ │ │ │ +0001b050: 2027 7072 6f67 3227 2077 696c 6c20 6164 'prog2' will ad │ │ │ │ │ +0001b060: 6469 7469 6f6e 616c 6c79 2062 650a 636f ditionally be.co │ │ │ │ │ +0001b070: 6d70 696c 6564 2077 6974 6820 7468 6520 mpiled with the │ │ │ │ │ +0001b080: 666c 6167 7320 7265 7175 6972 6564 2074 flags required t │ │ │ │ │ +0001b090: 6f20 6c69 6e6b 2077 6974 6820 276c 6962 o link with 'lib │ │ │ │ │ +0001b0a0: 666f 6f27 2e0a 0a20 2020 4e6f 7465 2074 foo'... Note t │ │ │ │ │ +0001b0b0: 6861 7420 6c69 7374 696e 6720 2741 4d5f hat listing 'AM_ │ │ │ │ │ +0001b0c0: 4346 4c41 4753 2720 696e 2061 2070 6572 CFLAGS' in a per │ │ │ │ │ +0001b0d0: 2d74 6172 6765 7420 2743 464c 4147 5327 -target 'CFLAGS' │ │ │ │ │ +0001b0e0: 2076 6172 6961 626c 6520 6973 2061 0a63 variable is a.c │ │ │ │ │ +0001b0f0: 6f6d 6d6f 6e20 6964 696f 6d20 746f 2065 ommon idiom to e │ │ │ │ │ +0001b100: 6e73 7572 6520 7468 6174 2027 414d 5f43 nsure that 'AM_C │ │ │ │ │ +0001b110: 464c 4147 5327 2061 7070 6c69 6573 2074 FLAGS' applies t │ │ │ │ │ +0001b120: 6f20 6576 6572 7920 7461 7267 6574 2069 o every target i │ │ │ │ │ +0001b130: 6e20 610a 274d 616b 6566 696c 652e 696e n a.'Makefile.in │ │ │ │ │ +0001b140: 272e 0a0a 2020 2055 7369 6e67 2076 6172 '... Using var │ │ │ │ │ +0001b150: 6961 626c 6573 206c 696b 6520 7468 6973 iables like this │ │ │ │ │ +0001b160: 2067 6976 6573 2079 6f75 2066 756c 6c20 gives you full │ │ │ │ │ +0001b170: 636f 6e74 726f 6c20 6f76 6572 2074 6865 control over the │ │ │ │ │ +0001b180: 206f 7264 6572 696e 6720 6f66 0a74 6865 ordering of.the │ │ │ │ │ +0001b190: 2066 6c61 6773 2e20 2046 6f72 2069 6e73 flags. For ins │ │ │ │ │ +0001b1a0: 7461 6e63 652c 2069 6620 7468 6572 6520 tance, if there │ │ │ │ │ +0001b1b0: 6973 2061 2066 6c61 6720 696e 2024 2857 is a flag in $(W │ │ │ │ │ +0001b1c0: 4152 4e49 4e47 4346 4c41 4753 2920 7468 ARNINGCFLAGS) th │ │ │ │ │ +0001b1d0: 6174 0a79 6f75 2077 616e 7420 746f 206e at.you want to n │ │ │ │ │ +0001b1e0: 6567 6174 6520 666f 7220 6120 7061 7274 egate for a part │ │ │ │ │ +0001b1f0: 6963 756c 6172 2074 6172 6765 742c 2079 icular target, y │ │ │ │ │ +0001b200: 6f75 2063 616e 2075 7365 2073 6f6d 6574 ou can use somet │ │ │ │ │ +0001b210: 6869 6e67 206c 696b 650a 2770 726f 6731 hing like.'prog1 │ │ │ │ │ +0001b220: 5f43 464c 4147 5320 3d20 2428 414d 5f43 _CFLAGS = $(AM_C │ │ │ │ │ +0001b230: 464c 4147 5329 202d 6e6f 2d66 6c61 6727 FLAGS) -no-flag' │ │ │ │ │ +0001b240: 2e20 2049 6620 616c 6c20 7468 6573 6520 . If all these │ │ │ │ │ +0001b250: 666c 6167 7320 6861 6420 6265 656e 0a66 flags had been.f │ │ │ │ │ +0001b260: 6f72 6365 6675 6c6c 7920 6170 7065 6e64 orcefully append │ │ │ │ │ +0001b270: 6564 2074 6f20 2743 464c 4147 5327 2c20 ed to 'CFLAGS', │ │ │ │ │ +0001b280: 7468 6572 6520 776f 756c 6420 6265 206e there would be n │ │ │ │ │ +0001b290: 6f20 7761 7920 746f 2064 6973 6162 6c65 o way to disable │ │ │ │ │ +0001b2a0: 206f 6e65 0a66 6c61 672e 2020 5965 7420 one.flag. Yet │ │ │ │ │ +0001b2b0: 616e 6f74 6865 7220 7265 6173 6f6e 2074 another reason t │ │ │ │ │ +0001b2c0: 6f20 6c65 6176 6520 7573 6572 2076 6172 o leave user var │ │ │ │ │ +0001b2d0: 6961 626c 6573 2074 6f20 7573 6572 732e iables to users. │ │ │ │ │ +0001b2e0: 0a0a 2020 2046 696e 616c 6c79 2c20 7765 .. Finally, we │ │ │ │ │ +0001b2f0: 2068 6176 6520 6176 6f69 6465 6420 6e61 have avoided na │ │ │ │ │ +0001b300: 6d69 6e67 2074 6865 2076 6172 6961 626c ming the variabl │ │ │ │ │ +0001b310: 6520 6f66 2074 6865 2065 7861 6d70 6c65 e of the example │ │ │ │ │ +0001b320: 0a27 4c49 4246 4f4f 5f4c 4446 4c41 4753 .'LIBFOO_LDFLAGS │ │ │ │ │ +0001b330: 2720 2877 6974 6820 616e 2075 6e64 6572 ' (with an under │ │ │ │ │ +0001b340: 7363 6f72 6529 2062 6563 6175 7365 2074 score) because t │ │ │ │ │ +0001b350: 6861 7420 776f 756c 6420 6361 7573 6520 hat would cause │ │ │ │ │ +0001b360: 4175 746f 6d61 6b65 0a74 6f20 7468 696e Automake.to thin │ │ │ │ │ +0001b370: 6b20 7468 6174 2074 6869 7320 6973 2061 k that this is a │ │ │ │ │ +0001b380: 6374 7561 6c6c 7920 6120 7065 722d 7461 ctually a per-ta │ │ │ │ │ +0001b390: 7267 6574 2076 6172 6961 626c 6520 286c rget variable (l │ │ │ │ │ +0001b3a0: 696b 650a 276d 756d 626c 655f 4c44 464c ike.'mumble_LDFL │ │ │ │ │ +0001b3b0: 4147 5327 2920 666f 7220 736f 6d65 206e AGS') for some n │ │ │ │ │ +0001b3c0: 6f6e 2d64 6563 6c61 7265 6420 274c 4942 on-declared 'LIB │ │ │ │ │ +0001b3d0: 464f 4f27 2074 6172 6765 742e 0a0a 4f74 FOO' target...Ot │ │ │ │ │ +0001b3e0: 6865 7220 5661 7269 6162 6c65 730a 2d2d her Variables.-- │ │ │ │ │ +0001b3f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 -------------..T │ │ │ │ │ +0001b400: 6865 7265 2061 7265 206f 7468 6572 2076 here are other v │ │ │ │ │ +0001b410: 6172 6961 626c 6573 2069 6e20 4175 746f ariables in Auto │ │ │ │ │ +0001b420: 6d61 6b65 2074 6861 7420 666f 6c6c 6f77 make that follow │ │ │ │ │ +0001b430: 2073 696d 696c 6172 2070 7269 6e63 6970 similar princip │ │ │ │ │ +0001b440: 6c65 7320 746f 0a61 6c6c 6f77 2075 7365 les to.allow use │ │ │ │ │ +0001b450: 7220 6f70 7469 6f6e 732e 2020 466f 7220 r options. For │ │ │ │ │ +0001b460: 696e 7374 616e 6365 2c20 5465 7869 6e66 instance, Texinf │ │ │ │ │ +0001b470: 6f20 7275 6c65 7320 282a 6e6f 7465 2054 o rules (*note T │ │ │ │ │ +0001b480: 6578 696e 666f 3a3a 2920 7573 650a 274d exinfo::) use.'M │ │ │ │ │ +0001b490: 414b 4549 4e46 4f46 4c41 4753 2720 616e AKEINFOFLAGS' an │ │ │ │ │ +0001b4a0: 6420 2741 4d5f 4d41 4b45 494e 464f 464c d 'AM_MAKEINFOFL │ │ │ │ │ +0001b4b0: 4147 5327 2e20 2053 696d 696c 6172 6c79 AGS'. Similarly │ │ │ │ │ +0001b4c0: 2c20 4465 6a61 476e 7520 7465 7374 7320 , DejaGnu tests │ │ │ │ │ +0001b4d0: 282a 6e6f 7465 0a44 656a 6147 6e75 2054 (*note.DejaGnu T │ │ │ │ │ +0001b4e0: 6573 7473 3a3a 2920 7573 6520 2752 554e ests::) use 'RUN │ │ │ │ │ +0001b4f0: 5445 5354 4445 4641 554c 5446 4c41 4753 TESTDEFAULTFLAGS │ │ │ │ │ +0001b500: 2720 616e 6420 2741 4d5f 5255 4e54 4553 ' and 'AM_RUNTES │ │ │ │ │ +0001b510: 5444 4546 4155 4c54 464c 4147 5327 2e0a TDEFAULTFLAGS'.. │ │ │ │ │ +0001b520: 5468 6520 7461 6773 2061 6e64 2063 7461 The tags and cta │ │ │ │ │ +0001b530: 6773 2072 756c 6573 2028 2a6e 6f74 6520 gs rules (*note │ │ │ │ │ +0001b540: 5461 6773 3a3a 2920 7573 6520 2745 5441 Tags::) use 'ETA │ │ │ │ │ +0001b550: 4753 464c 4147 5327 2c0a 2741 4d5f 4554 GSFLAGS',.'AM_ET │ │ │ │ │ +0001b560: 4147 5346 4c41 4753 272c 2027 4354 4147 AGSFLAGS', 'CTAG │ │ │ │ │ +0001b570: 5346 4c41 4753 272c 2061 6e64 2027 414d SFLAGS', and 'AM │ │ │ │ │ +0001b580: 5f43 5441 4753 464c 4147 5327 2e20 204a _CTAGSFLAGS'. J │ │ │ │ │ +0001b590: 6176 6120 7275 6c65 7320 282a 6e6f 7465 ava rules (*note │ │ │ │ │ +0001b5a0: 0a4a 6176 613a 3a29 2075 7365 2027 4a41 .Java::) use 'JA │ │ │ │ │ +0001b5b0: 5641 4346 4c41 4753 2720 616e 6420 2741 VACFLAGS' and 'A │ │ │ │ │ +0001b5c0: 4d5f 4a41 5641 4346 4c41 4753 272e 2020 M_JAVACFLAGS'. │ │ │ │ │ +0001b5d0: 4e6f 6e65 206f 6620 7468 6573 6520 7275 None of these ru │ │ │ │ │ +0001b5e0: 6c65 730a 7375 7070 6f72 7420 7065 722d les.support per- │ │ │ │ │ +0001b5f0: 7461 7267 6574 2066 6c61 6773 2028 7965 target flags (ye │ │ │ │ │ +0001b600: 7429 2e0a 0a20 2020 546f 2073 6f6d 6520 t)... To some │ │ │ │ │ +0001b610: 6578 7465 6e74 2c20 6576 656e 2027 414d extent, even 'AM │ │ │ │ │ +0001b620: 5f4d 414b 4546 4c41 4753 2720 282a 6e6f _MAKEFLAGS' (*no │ │ │ │ │ +0001b630: 7465 2053 7562 6469 7265 6374 6f72 6965 te Subdirectorie │ │ │ │ │ +0001b640: 733a 3a29 206f 6265 7973 0a74 6869 7320 s::) obeys.this │ │ │ │ │ +0001b650: 6e61 6d69 6e67 2073 6368 656d 652e 2020 naming scheme. │ │ │ │ │ +0001b660: 5468 6520 736c 6967 6874 2064 6966 6665 The slight diffe │ │ │ │ │ +0001b670: 7265 6e63 6520 6973 2074 6861 7420 274d rence is that 'M │ │ │ │ │ +0001b680: 414b 4546 4c41 4753 2720 6973 2070 6173 AKEFLAGS' is pas │ │ │ │ │ +0001b690: 7365 640a 746f 2073 7562 2d27 6d61 6b65 sed.to sub-'make │ │ │ │ │ +0001b6a0: 2773 2069 6d70 6c69 6369 746c 7920 6279 's implicitly by │ │ │ │ │ +0001b6b0: 2027 6d61 6b65 2720 6974 7365 6c66 2e0a 'make' itself.. │ │ │ │ │ +0001b6c0: 0a20 2020 486f 7765 7665 7220 796f 7520 . However you │ │ │ │ │ +0001b6d0: 7368 6f75 6c64 206e 6f74 2074 6869 6e6b should not think │ │ │ │ │ +0001b6e0: 2074 6861 7420 616c 6c20 7661 7269 6162 that all variab │ │ │ │ │ +0001b6f0: 6c65 7320 656e 6469 6e67 2077 6974 6820 les ending with │ │ │ │ │ +0001b700: 2746 4c41 4753 270a 666f 6c6c 6f77 2074 'FLAGS'.follow t │ │ │ │ │ +0001b710: 6869 7320 636f 6e76 656e 7469 6f6e 2e20 his convention. │ │ │ │ │ +0001b720: 2046 6f72 2069 6e73 7461 6e63 652c 2027 For instance, ' │ │ │ │ │ +0001b730: 4449 5354 4348 4543 4b5f 434f 4e46 4947 DISTCHECK_CONFIG │ │ │ │ │ +0001b740: 5552 455f 464c 4147 5327 0a28 2a6e 6f74 URE_FLAGS'.(*not │ │ │ │ │ +0001b750: 6520 4368 6563 6b69 6e67 2074 6865 2044 e Checking the D │ │ │ │ │ +0001b760: 6973 7472 6962 7574 696f 6e3a 3a29 2061 istribution::) a │ │ │ │ │ +0001b770: 6e64 2027 4143 4c4f 4341 4c5f 414d 464c nd 'ACLOCAL_AMFL │ │ │ │ │ +0001b780: 4147 5327 2028 7365 6520 2a6e 6f74 650a AGS' (see *note. │ │ │ │ │ +0001b790: 5265 6275 696c 6469 6e67 3a3a 2061 6e64 Rebuilding:: and │ │ │ │ │ +0001b7a0: 202a 6e6f 7465 204c 6f63 616c 204d 6163 *note Local Mac │ │ │ │ │ +0001b7b0: 726f 733a 3a29 2c20 6172 6520 7477 6f20 ros::), are two │ │ │ │ │ +0001b7c0: 7661 7269 6162 6c65 7320 7468 6174 2061 variables that a │ │ │ │ │ +0001b7d0: 7265 206f 6e6c 790a 7573 6566 756c 2074 re only.useful t │ │ │ │ │ +0001b7e0: 6f20 7468 6520 6d61 696e 7461 696e 6572 o the maintainer │ │ │ │ │ +0001b7f0: 2061 6e64 2068 6176 6520 6e6f 2075 7365 and have no use │ │ │ │ │ +0001b800: 7220 636f 756e 7465 7270 6172 742e 0a0a r counterpart... │ │ │ │ │ +0001b810: 2020 2027 4152 464c 4147 5327 2028 2a6e 'ARFLAGS' (*n │ │ │ │ │ +0001b820: 6f74 6520 4120 4c69 6272 6172 793a 3a29 ote A Library::) │ │ │ │ │ +0001b830: 2069 7320 7573 7561 6c6c 7920 6465 6669 is usually defi │ │ │ │ │ +0001b840: 6e65 6420 6279 2041 7574 6f6d 616b 6520 ned by Automake │ │ │ │ │ +0001b850: 616e 6420 6861 730a 6e65 6974 6865 7220 and has.neither │ │ │ │ │ +0001b860: 2741 4d5f 2720 6e6f 7220 7065 722d 7461 'AM_' nor per-ta │ │ │ │ │ +0001b870: 7267 6574 2063 6f75 7369 6e2e 0a0a 2020 rget cousin... │ │ │ │ │ +0001b880: 2046 696e 616c 6c79 2079 6f75 2073 686f Finally you sho │ │ │ │ │ +0001b890: 756c 6420 6e6f 7420 7468 696e 6b20 7468 uld not think th │ │ │ │ │ +0001b8a0: 6174 2074 6865 2065 7869 7374 656e 6365 at the existence │ │ │ │ │ +0001b8b0: 206f 6620 6120 7065 722d 7461 7267 6574 of a per-target │ │ │ │ │ +0001b8c0: 0a76 6172 6961 626c 6520 696d 706c 6965 .variable implie │ │ │ │ │ +0001b8d0: 7320 7468 6520 6578 6973 7461 6e63 6520 s the existance │ │ │ │ │ +0001b8e0: 6f66 2061 6e20 2741 4d5f 2720 7661 7269 of an 'AM_' vari │ │ │ │ │ +0001b8f0: 6162 6c65 206f 7220 6f66 2061 2075 7365 able or of a use │ │ │ │ │ +0001b900: 720a 7661 7269 6162 6c65 2e20 2046 6f72 r.variable. For │ │ │ │ │ +0001b910: 2069 6e73 7461 6e63 652c 2074 6865 2027 instance, the ' │ │ │ │ │ +0001b920: 6d75 6d62 6c65 5f4c 4441 4444 2720 7065 mumble_LDADD' pe │ │ │ │ │ +0001b930: 722d 7461 7267 6574 2076 6172 6961 626c r-target variabl │ │ │ │ │ +0001b940: 650a 6f76 6572 7269 6465 7320 7468 6520 e.overrides the │ │ │ │ │ +0001b950: 6d61 6b65 6669 6c65 2d77 6964 6520 274c makefile-wide 'L │ │ │ │ │ +0001b960: 4441 4444 2720 7661 7269 6162 6c65 2028 DADD' variable ( │ │ │ │ │ +0001b970: 7768 6963 6820 6973 206e 6f74 2061 2075 which is not a u │ │ │ │ │ +0001b980: 7365 720a 7661 7269 6162 6c65 292c 2061 ser.variable), a │ │ │ │ │ +0001b990: 6e64 2027 6d75 6d62 6c65 5f4c 4942 4144 nd 'mumble_LIBAD │ │ │ │ │ +0001b9a0: 4427 2065 7869 7374 7320 6f6e 6c79 2061 D' exists only a │ │ │ │ │ +0001b9b0: 7320 6120 7065 722d 7461 7267 6574 2076 s a per-target v │ │ │ │ │ +0001b9c0: 6172 6961 626c 652e 0a2a 4e6f 7465 2050 ariable..*Note P │ │ │ │ │ +0001b9d0: 726f 6772 616d 2061 6e64 204c 6962 7261 rogram and Libra │ │ │ │ │ +0001b9e0: 7279 2056 6172 6961 626c 6573 3a3a 2e0a ry Variables::.. │ │ │ │ │ +0001b9f0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +0001ba00: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +0001ba10: 6465 3a20 5265 6e61 6d65 6420 4f62 6a65 de: Renamed Obje │ │ │ │ │ +0001ba20: 6374 732c 2020 4e65 7874 3a20 5065 722d cts, Next: Per- │ │ │ │ │ +0001ba30: 4f62 6a65 6374 2046 6c61 6773 2c20 2050 Object Flags, P │ │ │ │ │ +0001ba40: 7265 763a 2046 6c61 6720 5661 7269 6162 rev: Flag Variab │ │ │ │ │ +0001ba50: 6c65 7320 4f72 6465 7269 6e67 2c20 2055 les Ordering, U │ │ │ │ │ +0001ba60: 703a 2046 4151 0a0a 3238 2e37 2057 6879 p: FAQ..28.7 Why │ │ │ │ │ +0001ba70: 2061 7265 206f 626a 6563 7420 6669 6c65 are object file │ │ │ │ │ +0001ba80: 7320 736f 6d65 7469 6d65 7320 7265 6e61 s sometimes rena │ │ │ │ │ +0001ba90: 6d65 643f 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d med?.=========== │ │ │ │ │ 0001baa0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0001bab0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001bac0: 0a0a 5468 6973 2068 6170 7065 6e73 2077 ..This happens w │ │ │ │ │ -0001bad0: 6865 6e20 7065 722d 7461 7267 6574 2063 hen per-target c │ │ │ │ │ -0001bae0: 6f6d 7069 6c61 7469 6f6e 2066 6c61 6773 ompilation flags │ │ │ │ │ -0001baf0: 2061 7265 2075 7365 642e 2020 4f62 6a65 are used. Obje │ │ │ │ │ -0001bb00: 6374 2066 696c 6573 0a6e 6565 6420 746f ct files.need to │ │ │ │ │ -0001bb10: 2062 6520 7265 6e61 6d65 6420 6a75 7374 be renamed just │ │ │ │ │ -0001bb20: 2069 6e20 6361 7365 2074 6865 7920 776f in case they wo │ │ │ │ │ -0001bb30: 756c 6420 636c 6173 6820 7769 7468 206f uld clash with o │ │ │ │ │ -0001bb40: 626a 6563 7420 6669 6c65 730a 636f 6d70 bject files.comp │ │ │ │ │ -0001bb50: 696c 6564 2066 726f 6d20 7468 6520 7361 iled from the sa │ │ │ │ │ -0001bb60: 6d65 2073 6f75 7263 6573 2c20 6275 7420 me sources, but │ │ │ │ │ -0001bb70: 7769 7468 2064 6966 6665 7265 6e74 2066 with different f │ │ │ │ │ -0001bb80: 6c61 6773 2e20 2043 6f6e 7369 6465 7220 lags. Consider │ │ │ │ │ -0001bb90: 7468 650a 666f 6c6c 6f77 696e 6720 6578 the.following ex │ │ │ │ │ -0001bba0: 616d 706c 652e 0a0a 2020 2020 2062 696e ample... bin │ │ │ │ │ -0001bbb0: 5f50 524f 4752 414d 5320 3d20 7472 7565 _PROGRAMS = true │ │ │ │ │ -0001bbc0: 2066 616c 7365 0a20 2020 2020 7472 7565 false. true │ │ │ │ │ -0001bbd0: 5f53 4f55 5243 4553 203d 2067 656e 6572 _SOURCES = gener │ │ │ │ │ -0001bbe0: 6963 2e63 0a20 2020 2020 7472 7565 5f43 ic.c. true_C │ │ │ │ │ -0001bbf0: 5050 464c 4147 5320 3d20 2d44 4558 4954 PPFLAGS = -DEXIT │ │ │ │ │ -0001bc00: 5f43 4f44 453d 300a 2020 2020 2066 616c _CODE=0. fal │ │ │ │ │ -0001bc10: 7365 5f53 4f55 5243 4553 203d 2067 656e se_SOURCES = gen │ │ │ │ │ -0001bc20: 6572 6963 2e63 0a20 2020 2020 6661 6c73 eric.c. fals │ │ │ │ │ -0001bc30: 655f 4350 5046 4c41 4753 203d 202d 4445 e_CPPFLAGS = -DE │ │ │ │ │ -0001bc40: 5849 545f 434f 4445 3d31 0a0a 4f62 7669 XIT_CODE=1..Obvi │ │ │ │ │ -0001bc50: 6f75 736c 7920 7468 6520 7477 6f20 7072 ously the two pr │ │ │ │ │ -0001bc60: 6f67 7261 6d73 2061 7265 2062 7569 6c74 ograms are built │ │ │ │ │ -0001bc70: 2066 726f 6d20 7468 6520 7361 6d65 2073 from the same s │ │ │ │ │ -0001bc80: 6f75 7263 652c 2062 7574 2069 7420 776f ource, but it wo │ │ │ │ │ -0001bc90: 756c 640a 6265 2062 6164 2069 6620 7468 uld.be bad if th │ │ │ │ │ -0001bca0: 6579 2073 6861 7265 6420 7468 6520 7361 ey shared the sa │ │ │ │ │ -0001bcb0: 6d65 206f 626a 6563 742c 2062 6563 6175 me object, becau │ │ │ │ │ -0001bcc0: 7365 2027 6765 6e65 7269 632e 6f27 2063 se 'generic.o' c │ │ │ │ │ -0001bcd0: 616e 6e6f 7420 6265 0a62 7569 6c74 2077 annot be.built w │ │ │ │ │ -0001bce0: 6974 6820 626f 7468 2027 2d44 4558 4954 ith both '-DEXIT │ │ │ │ │ -0001bcf0: 5f43 4f44 453d 3027 205f 616e 645f 2027 _CODE=0' _and_ ' │ │ │ │ │ -0001bd00: 2d44 4558 4954 5f43 4f44 453d 3127 2e20 -DEXIT_CODE=1'. │ │ │ │ │ -0001bd10: 2054 6865 7265 666f 7265 0a27 6175 746f Therefore.'auto │ │ │ │ │ -0001bd20: 6d61 6b65 2720 6f75 7470 7574 7320 7275 make' outputs ru │ │ │ │ │ -0001bd30: 6c65 7320 746f 2062 7569 6c64 2074 776f les to build two │ │ │ │ │ -0001bd40: 2064 6966 6665 7265 6e74 206f 626a 6563 different objec │ │ │ │ │ -0001bd50: 7473 3a0a 2774 7275 652d 6765 6e65 7269 ts:.'true-generi │ │ │ │ │ -0001bd60: 632e 6f27 2061 6e64 2027 6661 6c73 652d c.o' and 'false- │ │ │ │ │ -0001bd70: 6765 6e65 7269 632e 6f27 2e0a 0a20 2020 generic.o'... │ │ │ │ │ -0001bd80: 2761 7574 6f6d 616b 6527 2064 6f65 736e 'automake' doesn │ │ │ │ │ -0001bd90: 2774 2061 6374 7561 6c6c 7920 6c6f 6f6b 't actually look │ │ │ │ │ -0001bda0: 2077 6865 7468 6572 2073 6f75 7263 6520 whether source │ │ │ │ │ -0001bdb0: 6669 6c65 7320 6172 6520 7368 6172 6564 files are shared │ │ │ │ │ -0001bdc0: 2074 6f0a 6465 6369 6465 2069 6620 6974 to.decide if it │ │ │ │ │ -0001bdd0: 206d 7573 7420 7265 6e61 6d65 206f 626a must rename obj │ │ │ │ │ -0001bde0: 6563 7473 2e20 2049 7420 7769 6c6c 206a ects. It will j │ │ │ │ │ -0001bdf0: 7573 7420 7265 6e61 6d65 2061 6c6c 206f ust rename all o │ │ │ │ │ -0001be00: 626a 6563 7473 206f 6620 610a 7461 7267 bjects of a.targ │ │ │ │ │ -0001be10: 6574 2061 7320 736f 6f6e 2061 7320 6974 et as soon as it │ │ │ │ │ -0001be20: 2073 6565 7320 7065 722d 7461 7267 6574 sees per-target │ │ │ │ │ -0001be30: 2063 6f6d 7069 6c61 7469 6f6e 2066 6c61 compilation fla │ │ │ │ │ -0001be40: 6773 2075 7365 642e 0a0a 2020 2049 7427 gs used... It' │ │ │ │ │ -0001be50: 7320 4f4b 2074 6f20 7368 6172 6520 6f62 s OK to share ob │ │ │ │ │ -0001be60: 6a65 6374 2066 696c 6573 2077 6865 6e20 ject files when │ │ │ │ │ -0001be70: 7065 722d 7461 7267 6574 2063 6f6d 7069 per-target compi │ │ │ │ │ -0001be80: 6c61 7469 6f6e 2066 6c61 6773 2061 7265 lation flags are │ │ │ │ │ -0001be90: 0a6e 6f74 2075 7365 642e 2020 466f 7220 .not used. For │ │ │ │ │ -0001bea0: 696e 7374 616e 6365 2c20 2774 7275 6527 instance, 'true' │ │ │ │ │ -0001beb0: 2061 6e64 2027 6661 6c73 6527 2077 696c and 'false' wil │ │ │ │ │ -0001bec0: 6c20 626f 7468 2075 7365 2027 7665 7273 l both use 'vers │ │ │ │ │ -0001bed0: 696f 6e2e 6f27 2069 6e0a 7468 6520 666f ion.o' in.the fo │ │ │ │ │ -0001bee0: 6c6c 6f77 696e 6720 6578 616d 706c 652e llowing example. │ │ │ │ │ -0001bef0: 0a0a 2020 2020 2041 4d5f 4350 5046 4c41 .. AM_CPPFLA │ │ │ │ │ -0001bf00: 4753 203d 202d 4456 4552 5349 4f4e 3d31 GS = -DVERSION=1 │ │ │ │ │ -0001bf10: 2e30 0a20 2020 2020 6269 6e5f 5052 4f47 .0. bin_PROG │ │ │ │ │ -0001bf20: 5241 4d53 203d 2074 7275 6520 6661 6c73 RAMS = true fals │ │ │ │ │ -0001bf30: 650a 2020 2020 2074 7275 655f 534f 5552 e. true_SOUR │ │ │ │ │ -0001bf40: 4345 5320 3d20 7472 7565 2e63 2076 6572 CES = true.c ver │ │ │ │ │ -0001bf50: 7369 6f6e 2e63 0a20 2020 2020 6661 6c73 sion.c. fals │ │ │ │ │ -0001bf60: 655f 534f 5552 4345 5320 3d20 6661 6c73 e_SOURCES = fals │ │ │ │ │ -0001bf70: 652e 6320 7665 7273 696f 6e2e 630a 0a20 e.c version.c.. │ │ │ │ │ -0001bf80: 2020 4e6f 7465 2074 6861 7420 7468 6520 Note that the │ │ │ │ │ -0001bf90: 7265 6e61 6d69 6e67 206f 6620 6f62 6a65 renaming of obje │ │ │ │ │ -0001bfa0: 6374 7320 6973 2061 6c73 6f20 6166 6665 cts is also affe │ │ │ │ │ -0001bfb0: 6374 6564 2062 7920 7468 650a 275f 5348 cted by the.'_SH │ │ │ │ │ -0001bfc0: 4f52 544e 414d 4527 2076 6172 6961 626c ORTNAME' variabl │ │ │ │ │ -0001bfd0: 6520 282a 6e6f 7465 2050 726f 6772 616d e (*note Program │ │ │ │ │ -0001bfe0: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ -0001bff0: 6961 626c 6573 3a3a 292e 0a0a 1f0a 4669 iables::).....Fi │ │ │ │ │ -0001c000: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ -0001c010: 312e 696e 666f 2c20 204e 6f64 653a 2050 1.info, Node: P │ │ │ │ │ -0001c020: 6572 2d4f 626a 6563 7420 466c 6167 732c er-Object Flags, │ │ │ │ │ -0001c030: 2020 4e65 7874 3a20 4d75 6c74 6970 6c65 Next: Multiple │ │ │ │ │ -0001c040: 204f 7574 7075 7473 2c20 2050 7265 763a Outputs, Prev: │ │ │ │ │ -0001c050: 2052 656e 616d 6564 204f 626a 6563 7473 Renamed Objects │ │ │ │ │ -0001c060: 2c20 2055 703a 2046 4151 0a0a 3238 2e38 , Up: FAQ..28.8 │ │ │ │ │ -0001c070: 2050 6572 2d4f 626a 6563 7420 466c 6167 Per-Object Flag │ │ │ │ │ -0001c080: 7320 456d 756c 6174 696f 6e0a 3d3d 3d3d s Emulation.==== │ │ │ │ │ +0001bac0: 3d0a 0a54 6869 7320 6861 7070 656e 7320 =..This happens │ │ │ │ │ +0001bad0: 7768 656e 2070 6572 2d74 6172 6765 7420 when per-target │ │ │ │ │ +0001bae0: 636f 6d70 696c 6174 696f 6e20 666c 6167 compilation flag │ │ │ │ │ +0001baf0: 7320 6172 6520 7573 6564 2e20 204f 626a s are used. Obj │ │ │ │ │ +0001bb00: 6563 7420 6669 6c65 730a 6e65 6564 2074 ect files.need t │ │ │ │ │ +0001bb10: 6f20 6265 2072 656e 616d 6564 206a 7573 o be renamed jus │ │ │ │ │ +0001bb20: 7420 696e 2063 6173 6520 7468 6579 2077 t in case they w │ │ │ │ │ +0001bb30: 6f75 6c64 2063 6c61 7368 2077 6974 6820 ould clash with │ │ │ │ │ +0001bb40: 6f62 6a65 6374 2066 696c 6573 0a63 6f6d object files.com │ │ │ │ │ +0001bb50: 7069 6c65 6420 6672 6f6d 2074 6865 2073 piled from the s │ │ │ │ │ +0001bb60: 616d 6520 736f 7572 6365 732c 2062 7574 ame sources, but │ │ │ │ │ +0001bb70: 2077 6974 6820 6469 6666 6572 656e 7420 with different │ │ │ │ │ +0001bb80: 666c 6167 732e 2020 436f 6e73 6964 6572 flags. Consider │ │ │ │ │ +0001bb90: 2074 6865 0a66 6f6c 6c6f 7769 6e67 2065 the.following e │ │ │ │ │ +0001bba0: 7861 6d70 6c65 2e0a 0a20 2020 2020 6269 xample... bi │ │ │ │ │ +0001bbb0: 6e5f 5052 4f47 5241 4d53 203d 2074 7275 n_PROGRAMS = tru │ │ │ │ │ +0001bbc0: 6520 6661 6c73 650a 2020 2020 2074 7275 e false. tru │ │ │ │ │ +0001bbd0: 655f 534f 5552 4345 5320 3d20 6765 6e65 e_SOURCES = gene │ │ │ │ │ +0001bbe0: 7269 632e 630a 2020 2020 2074 7275 655f ric.c. true_ │ │ │ │ │ +0001bbf0: 4350 5046 4c41 4753 203d 202d 4445 5849 CPPFLAGS = -DEXI │ │ │ │ │ +0001bc00: 545f 434f 4445 3d30 0a20 2020 2020 6661 T_CODE=0. fa │ │ │ │ │ +0001bc10: 6c73 655f 534f 5552 4345 5320 3d20 6765 lse_SOURCES = ge │ │ │ │ │ +0001bc20: 6e65 7269 632e 630a 2020 2020 2066 616c neric.c. fal │ │ │ │ │ +0001bc30: 7365 5f43 5050 464c 4147 5320 3d20 2d44 se_CPPFLAGS = -D │ │ │ │ │ +0001bc40: 4558 4954 5f43 4f44 453d 310a 0a4f 6276 EXIT_CODE=1..Obv │ │ │ │ │ +0001bc50: 696f 7573 6c79 2074 6865 2074 776f 2070 iously the two p │ │ │ │ │ +0001bc60: 726f 6772 616d 7320 6172 6520 6275 696c rograms are buil │ │ │ │ │ +0001bc70: 7420 6672 6f6d 2074 6865 2073 616d 6520 t from the same │ │ │ │ │ +0001bc80: 736f 7572 6365 2c20 6275 7420 6974 2077 source, but it w │ │ │ │ │ +0001bc90: 6f75 6c64 0a62 6520 6261 6420 6966 2074 ould.be bad if t │ │ │ │ │ +0001bca0: 6865 7920 7368 6172 6564 2074 6865 2073 hey shared the s │ │ │ │ │ +0001bcb0: 616d 6520 6f62 6a65 6374 2c20 6265 6361 ame object, beca │ │ │ │ │ +0001bcc0: 7573 6520 2767 656e 6572 6963 2e6f 2720 use 'generic.o' │ │ │ │ │ +0001bcd0: 6361 6e6e 6f74 2062 650a 6275 696c 7420 cannot be.built │ │ │ │ │ +0001bce0: 7769 7468 2062 6f74 6820 272d 4445 5849 with both '-DEXI │ │ │ │ │ +0001bcf0: 545f 434f 4445 3d30 2720 5f61 6e64 5f20 T_CODE=0' _and_ │ │ │ │ │ +0001bd00: 272d 4445 5849 545f 434f 4445 3d31 272e '-DEXIT_CODE=1'. │ │ │ │ │ +0001bd10: 2020 5468 6572 6566 6f72 650a 2761 7574 Therefore.'aut │ │ │ │ │ +0001bd20: 6f6d 616b 6527 206f 7574 7075 7473 2072 omake' outputs r │ │ │ │ │ +0001bd30: 756c 6573 2074 6f20 6275 696c 6420 7477 ules to build tw │ │ │ │ │ +0001bd40: 6f20 6469 6666 6572 656e 7420 6f62 6a65 o different obje │ │ │ │ │ +0001bd50: 6374 733a 0a27 7472 7565 2d67 656e 6572 cts:.'true-gener │ │ │ │ │ +0001bd60: 6963 2e6f 2720 616e 6420 2766 616c 7365 ic.o' and 'false │ │ │ │ │ +0001bd70: 2d67 656e 6572 6963 2e6f 272e 0a0a 2020 -generic.o'... │ │ │ │ │ +0001bd80: 2027 6175 746f 6d61 6b65 2720 646f 6573 'automake' does │ │ │ │ │ +0001bd90: 6e27 7420 6163 7475 616c 6c79 206c 6f6f n't actually loo │ │ │ │ │ +0001bda0: 6b20 7768 6574 6865 7220 736f 7572 6365 k whether source │ │ │ │ │ +0001bdb0: 2066 696c 6573 2061 7265 2073 6861 7265 files are share │ │ │ │ │ +0001bdc0: 6420 746f 0a64 6563 6964 6520 6966 2069 d to.decide if i │ │ │ │ │ +0001bdd0: 7420 6d75 7374 2072 656e 616d 6520 6f62 t must rename ob │ │ │ │ │ +0001bde0: 6a65 6374 732e 2020 4974 2077 696c 6c20 jects. It will │ │ │ │ │ +0001bdf0: 6a75 7374 2072 656e 616d 6520 616c 6c20 just rename all │ │ │ │ │ +0001be00: 6f62 6a65 6374 7320 6f66 2061 0a74 6172 objects of a.tar │ │ │ │ │ +0001be10: 6765 7420 6173 2073 6f6f 6e20 6173 2069 get as soon as i │ │ │ │ │ +0001be20: 7420 7365 6573 2070 6572 2d74 6172 6765 t sees per-targe │ │ │ │ │ +0001be30: 7420 636f 6d70 696c 6174 696f 6e20 666c t compilation fl │ │ │ │ │ +0001be40: 6167 7320 7573 6564 2e0a 0a20 2020 4974 ags used... It │ │ │ │ │ +0001be50: 2773 204f 4b20 746f 2073 6861 7265 206f 's OK to share o │ │ │ │ │ +0001be60: 626a 6563 7420 6669 6c65 7320 7768 656e bject files when │ │ │ │ │ +0001be70: 2070 6572 2d74 6172 6765 7420 636f 6d70 per-target comp │ │ │ │ │ +0001be80: 696c 6174 696f 6e20 666c 6167 7320 6172 ilation flags ar │ │ │ │ │ +0001be90: 650a 6e6f 7420 7573 6564 2e20 2046 6f72 e.not used. For │ │ │ │ │ +0001bea0: 2069 6e73 7461 6e63 652c 2027 7472 7565 instance, 'true │ │ │ │ │ +0001beb0: 2720 616e 6420 2766 616c 7365 2720 7769 ' and 'false' wi │ │ │ │ │ +0001bec0: 6c6c 2062 6f74 6820 7573 6520 2776 6572 ll both use 'ver │ │ │ │ │ +0001bed0: 7369 6f6e 2e6f 2720 696e 0a74 6865 2066 sion.o' in.the f │ │ │ │ │ +0001bee0: 6f6c 6c6f 7769 6e67 2065 7861 6d70 6c65 ollowing example │ │ │ │ │ +0001bef0: 2e0a 0a20 2020 2020 414d 5f43 5050 464c ... AM_CPPFL │ │ │ │ │ +0001bf00: 4147 5320 3d20 2d44 5645 5253 494f 4e3d AGS = -DVERSION= │ │ │ │ │ +0001bf10: 312e 300a 2020 2020 2062 696e 5f50 524f 1.0. bin_PRO │ │ │ │ │ +0001bf20: 4752 414d 5320 3d20 7472 7565 2066 616c GRAMS = true fal │ │ │ │ │ +0001bf30: 7365 0a20 2020 2020 7472 7565 5f53 4f55 se. true_SOU │ │ │ │ │ +0001bf40: 5243 4553 203d 2074 7275 652e 6320 7665 RCES = true.c ve │ │ │ │ │ +0001bf50: 7273 696f 6e2e 630a 2020 2020 2066 616c rsion.c. fal │ │ │ │ │ +0001bf60: 7365 5f53 4f55 5243 4553 203d 2066 616c se_SOURCES = fal │ │ │ │ │ +0001bf70: 7365 2e63 2076 6572 7369 6f6e 2e63 0a0a se.c version.c.. │ │ │ │ │ +0001bf80: 2020 204e 6f74 6520 7468 6174 2074 6865 Note that the │ │ │ │ │ +0001bf90: 2072 656e 616d 696e 6720 6f66 206f 626a renaming of obj │ │ │ │ │ +0001bfa0: 6563 7473 2069 7320 616c 736f 2061 6666 ects is also aff │ │ │ │ │ +0001bfb0: 6563 7465 6420 6279 2074 6865 0a27 5f53 ected by the.'_S │ │ │ │ │ +0001bfc0: 484f 5254 4e41 4d45 2720 7661 7269 6162 HORTNAME' variab │ │ │ │ │ +0001bfd0: 6c65 2028 2a6e 6f74 6520 5072 6f67 7261 le (*note Progra │ │ │ │ │ +0001bfe0: 6d20 616e 6420 4c69 6272 6172 7920 5661 m and Library Va │ │ │ │ │ +0001bff0: 7269 6162 6c65 733a 3a29 2e0a 0a1f 0a46 riables::).....F │ │ │ │ │ +0001c000: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ +0001c010: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ +0001c020: 5065 722d 4f62 6a65 6374 2046 6c61 6773 Per-Object Flags │ │ │ │ │ +0001c030: 2c20 204e 6578 743a 204d 756c 7469 706c , Next: Multipl │ │ │ │ │ +0001c040: 6520 4f75 7470 7574 732c 2020 5072 6576 e Outputs, Prev │ │ │ │ │ +0001c050: 3a20 5265 6e61 6d65 6420 4f62 6a65 6374 : Renamed Object │ │ │ │ │ +0001c060: 732c 2020 5570 3a20 4641 510a 0a32 382e s, Up: FAQ..28. │ │ │ │ │ +0001c070: 3820 5065 722d 4f62 6a65 6374 2046 6c61 8 Per-Object Fla │ │ │ │ │ +0001c080: 6773 2045 6d75 6c61 7469 6f6e 0a3d 3d3d gs Emulation.=== │ │ │ │ │ 0001c090: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001c0a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 2020 ===========.. │ │ │ │ │ -0001c0b0: 2020 4f6e 6520 6f66 206d 7920 736f 7572 One of my sour │ │ │ │ │ -0001c0c0: 6365 2066 696c 6573 206e 6565 6473 2074 ce files needs t │ │ │ │ │ -0001c0d0: 6f20 6265 2063 6f6d 7069 6c65 6420 7769 o be compiled wi │ │ │ │ │ -0001c0e0: 7468 2064 6966 6665 7265 6e74 2066 6c61 th different fla │ │ │ │ │ -0001c0f0: 6773 2e20 2048 6f77 0a20 2020 2020 646f gs. How. do │ │ │ │ │ -0001c100: 2049 2064 6f3f 0a0a 2020 2041 7574 6f6d I do?.. Autom │ │ │ │ │ -0001c110: 616b 6520 7375 7070 6f72 7473 2070 6572 ake supports per │ │ │ │ │ -0001c120: 2d70 726f 6772 616d 2061 6e64 2070 6572 -program and per │ │ │ │ │ -0001c130: 2d6c 6962 7261 7279 2063 6f6d 7069 6c61 -library compila │ │ │ │ │ -0001c140: 7469 6f6e 2066 6c61 6773 2028 7365 650a tion flags (see. │ │ │ │ │ -0001c150: 2a6e 6f74 6520 5072 6f67 7261 6d20 616e *note Program an │ │ │ │ │ -0001c160: 6420 4c69 6272 6172 7920 5661 7269 6162 d Library Variab │ │ │ │ │ -0001c170: 6c65 733a 3a20 616e 6420 2a6e 6f74 6520 les:: and *note │ │ │ │ │ -0001c180: 466c 6167 2056 6172 6961 626c 6573 0a4f Flag Variables.O │ │ │ │ │ -0001c190: 7264 6572 696e 673a 3a29 2e20 2057 6974 rdering::). Wit │ │ │ │ │ -0001c1a0: 6820 7468 6973 2079 6f75 2063 616e 2064 h this you can d │ │ │ │ │ -0001c1b0: 6566 696e 6520 636f 6d70 696c 6174 696f efine compilatio │ │ │ │ │ -0001c1c0: 6e20 666c 6167 7320 7468 6174 2061 7070 n flags that app │ │ │ │ │ -0001c1d0: 6c79 2074 6f0a 616c 6c20 6669 6c65 7320 ly to.all files │ │ │ │ │ -0001c1e0: 636f 6d70 696c 6564 2066 6f72 2061 2074 compiled for a t │ │ │ │ │ -0001c1f0: 6172 6765 742e 2020 466f 7220 696e 7374 arget. For inst │ │ │ │ │ -0001c200: 616e 6365 2c20 696e 0a0a 2020 2020 2062 ance, in.. b │ │ │ │ │ -0001c210: 696e 5f50 524f 4752 414d 5320 3d20 666f in_PROGRAMS = fo │ │ │ │ │ -0001c220: 6f0a 2020 2020 2066 6f6f 5f53 4f55 5243 o. foo_SOURC │ │ │ │ │ -0001c230: 4553 203d 2066 6f6f 2e63 2066 6f6f 2e68 ES = foo.c foo.h │ │ │ │ │ -0001c240: 2062 6172 2e63 2062 6172 2e68 206d 6169 bar.c bar.h mai │ │ │ │ │ -0001c250: 6e2e 630a 2020 2020 2066 6f6f 5f43 464c n.c. foo_CFL │ │ │ │ │ -0001c260: 4147 5320 3d20 2d73 6f6d 6520 2d66 6c61 AGS = -some -fla │ │ │ │ │ -0001c270: 6773 0a0a 2766 6f6f 2d66 6f6f 2e6f 272c gs..'foo-foo.o', │ │ │ │ │ -0001c280: 2027 666f 6f2d 6261 722e 6f27 2c20 616e 'foo-bar.o', an │ │ │ │ │ -0001c290: 6420 2766 6f6f 2d6d 6169 6e2e 6f27 2077 d 'foo-main.o' w │ │ │ │ │ -0001c2a0: 696c 6c20 616c 6c20 6265 2063 6f6d 7069 ill all be compi │ │ │ │ │ -0001c2b0: 6c65 6420 7769 7468 0a27 2d73 6f6d 6520 led with.'-some │ │ │ │ │ -0001c2c0: 2d66 6c61 6773 272e 2020 2849 6620 796f -flags'. (If yo │ │ │ │ │ -0001c2d0: 7520 776f 6e64 6572 2061 626f 7574 2074 u wonder about t │ │ │ │ │ -0001c2e0: 6865 206e 616d 6573 206f 6620 7468 6573 he names of thes │ │ │ │ │ -0001c2f0: 6520 6f62 6a65 6374 2066 696c 6573 2c0a e object files,. │ │ │ │ │ -0001c300: 7365 6520 2a6e 6f74 6520 5265 6e61 6d65 see *note Rename │ │ │ │ │ -0001c310: 6420 4f62 6a65 6374 733a 3a2e 2920 204e d Objects::.) N │ │ │ │ │ -0001c320: 6f74 6520 7468 6174 2027 666f 6f5f 4346 ote that 'foo_CF │ │ │ │ │ -0001c330: 4c41 4753 2720 6769 7665 7320 7468 6520 LAGS' gives the │ │ │ │ │ -0001c340: 666c 6167 7320 746f 0a75 7365 2077 6865 flags to.use whe │ │ │ │ │ -0001c350: 6e20 636f 6d70 696c 696e 6720 616c 6c20 n compiling all │ │ │ │ │ -0001c360: 7468 6520 4320 736f 7572 6365 7320 6f66 the C sources of │ │ │ │ │ -0001c370: 2074 6865 205f 7072 6f67 7261 6d5f 2027 the _program_ ' │ │ │ │ │ -0001c380: 666f 6f27 2c20 6974 2068 6173 0a6e 6f74 foo', it has.not │ │ │ │ │ -0001c390: 6869 6e67 2074 6f20 646f 2077 6974 6820 hing to do with │ │ │ │ │ -0001c3a0: 2766 6f6f 2e63 2720 6f72 2027 666f 6f2d 'foo.c' or 'foo- │ │ │ │ │ -0001c3b0: 666f 6f2e 6f27 2073 7065 6369 6669 6361 foo.o' specifica │ │ │ │ │ -0001c3c0: 6c6c 792e 0a0a 2020 2057 6861 7420 6966 lly... What if │ │ │ │ │ -0001c3d0: 2027 666f 6f2e 6327 206e 6565 6473 2074 'foo.c' needs t │ │ │ │ │ -0001c3e0: 6f20 6265 2063 6f6d 7069 6c65 6420 696e o be compiled in │ │ │ │ │ -0001c3f0: 746f 2027 666f 6f2e 6f27 2075 7369 6e67 to 'foo.o' using │ │ │ │ │ -0001c400: 2073 6f6d 6520 7370 6563 6966 6963 0a66 some specific.f │ │ │ │ │ -0001c410: 6c61 6773 2c20 7468 6174 206e 6f6e 6520 lags, that none │ │ │ │ │ -0001c420: 6f66 2074 6865 206f 7468 6572 2066 696c of the other fil │ │ │ │ │ -0001c430: 6573 2072 6571 7569 7265 733f 2020 4f62 es requires? Ob │ │ │ │ │ -0001c440: 7669 6f75 736c 7920 7065 722d 7072 6f67 viously per-prog │ │ │ │ │ -0001c450: 7261 6d0a 666c 6167 7320 6172 6520 6e6f ram.flags are no │ │ │ │ │ -0001c460: 7420 6469 7265 6374 6c79 2061 7070 6c69 t directly appli │ │ │ │ │ -0001c470: 6361 626c 6520 6865 7265 2e20 2053 6f6d cable here. Som │ │ │ │ │ -0001c480: 6574 6869 6e67 206c 696b 6520 7065 722d ething like per- │ │ │ │ │ -0001c490: 6f62 6a65 6374 2066 6c61 6773 0a61 7265 object flags.are │ │ │ │ │ -0001c4a0: 2065 7870 6563 7465 642c 2069 2e65 2e2c expected, i.e., │ │ │ │ │ -0001c4b0: 2066 6c61 6773 2074 6861 7420 776f 756c flags that woul │ │ │ │ │ -0001c4c0: 6420 6265 2075 7365 6420 6f6e 6c79 2077 d be used only w │ │ │ │ │ -0001c4d0: 6865 6e20 6372 6561 7469 6e67 0a27 666f hen creating.'fo │ │ │ │ │ -0001c4e0: 6f2d 666f 6f2e 6f27 2e20 2041 7574 6f6d o-foo.o'. Autom │ │ │ │ │ -0001c4f0: 616b 6520 646f 6573 206e 6f74 2073 7570 ake does not sup │ │ │ │ │ -0001c500: 706f 7274 2074 6861 742c 2068 6f77 6576 port that, howev │ │ │ │ │ -0001c510: 6572 2074 6869 7320 6973 2065 6173 7920 er this is easy │ │ │ │ │ -0001c520: 746f 0a73 696d 756c 6174 6520 7573 696e to.simulate usin │ │ │ │ │ -0001c530: 6720 6120 6c69 6272 6172 7920 7468 6174 g a library that │ │ │ │ │ -0001c540: 2063 6f6e 7461 696e 7320 6f6e 6c79 2074 contains only t │ │ │ │ │ -0001c550: 6861 7420 6f62 6a65 6374 2c20 616e 6420 hat object, and │ │ │ │ │ -0001c560: 636f 6d70 696c 696e 670a 7468 6973 206c compiling.this l │ │ │ │ │ -0001c570: 6962 7261 7279 2077 6974 6820 7065 722d ibrary with per- │ │ │ │ │ -0001c580: 6c69 6272 6172 7920 666c 6167 732e 0a0a library flags... │ │ │ │ │ -0001c590: 2020 2020 2062 696e 5f50 524f 4752 414d bin_PROGRAM │ │ │ │ │ -0001c5a0: 5320 3d20 666f 6f0a 2020 2020 2066 6f6f S = foo. foo │ │ │ │ │ -0001c5b0: 5f53 4f55 5243 4553 203d 2062 6172 2e63 _SOURCES = bar.c │ │ │ │ │ -0001c5c0: 2062 6172 2e68 206d 6169 6e2e 630a 2020 bar.h main.c. │ │ │ │ │ -0001c5d0: 2020 2066 6f6f 5f43 464c 4147 5320 3d20 foo_CFLAGS = │ │ │ │ │ -0001c5e0: 2d73 6f6d 6520 2d66 6c61 6773 0a20 2020 -some -flags. │ │ │ │ │ -0001c5f0: 2020 666f 6f5f 4c44 4144 4420 3d20 6c69 foo_LDADD = li │ │ │ │ │ -0001c600: 6266 6f6f 2e61 0a20 2020 2020 6e6f 696e bfoo.a. noin │ │ │ │ │ -0001c610: 7374 5f4c 4942 5241 5249 4553 203d 206c st_LIBRARIES = l │ │ │ │ │ -0001c620: 6962 666f 6f2e 610a 2020 2020 206c 6962 ibfoo.a. lib │ │ │ │ │ -0001c630: 666f 6f5f 615f 534f 5552 4345 5320 3d20 foo_a_SOURCES = │ │ │ │ │ -0001c640: 666f 6f2e 6320 666f 6f2e 680a 2020 2020 foo.c foo.h. │ │ │ │ │ -0001c650: 206c 6962 666f 6f5f 615f 4346 4c41 4753 libfoo_a_CFLAGS │ │ │ │ │ -0001c660: 203d 202d 736f 6d65 202d 6f74 6865 7220 = -some -other │ │ │ │ │ -0001c670: 2d66 6c61 6773 0a0a 2020 2048 6572 6520 -flags.. Here │ │ │ │ │ -0001c680: 2766 6f6f 2d62 6172 2e6f 2720 616e 6420 'foo-bar.o' and │ │ │ │ │ -0001c690: 2766 6f6f 2d6d 6169 6e2e 6f27 2077 696c 'foo-main.o' wil │ │ │ │ │ -0001c6a0: 6c20 616c 6c20 6265 2063 6f6d 7069 6c65 l all be compile │ │ │ │ │ -0001c6b0: 6420 7769 7468 2027 2d73 6f6d 650a 2d66 d with '-some.-f │ │ │ │ │ -0001c6c0: 6c61 6773 272c 2077 6869 6c65 2027 6c69 lags', while 'li │ │ │ │ │ -0001c6d0: 6266 6f6f 5f61 2d66 6f6f 2e6f 2720 7769 bfoo_a-foo.o' wi │ │ │ │ │ -0001c6e0: 6c6c 2062 6520 636f 6d70 696c 6564 2075 ll be compiled u │ │ │ │ │ -0001c6f0: 7369 6e67 2027 2d73 6f6d 6520 2d6f 7468 sing '-some -oth │ │ │ │ │ -0001c700: 6572 0a2d 666c 6167 7327 2e20 2045 7665 er.-flags'. Eve │ │ │ │ │ -0001c710: 6e74 7561 6c6c 792c 2061 6c6c 2074 6872 ntually, all thr │ │ │ │ │ -0001c720: 6565 206f 626a 6563 7473 2077 696c 6c20 ee objects will │ │ │ │ │ -0001c730: 6265 206c 696e 6b65 6420 746f 2066 6f72 be linked to for │ │ │ │ │ -0001c740: 6d20 2766 6f6f 272e 0a0a 2020 2054 6869 m 'foo'... Thi │ │ │ │ │ -0001c750: 7320 7472 6963 6b20 6361 6e20 616c 736f s trick can also │ │ │ │ │ -0001c760: 2062 6520 6163 6869 6576 6564 2075 7369 be achieved usi │ │ │ │ │ -0001c770: 6e67 204c 6962 746f 6f6c 2063 6f6e 7665 ng Libtool conve │ │ │ │ │ -0001c780: 6e69 656e 6365 206c 6962 7261 7269 6573 nience libraries │ │ │ │ │ -0001c790: 2c0a 666f 7220 696e 7374 616e 6365 2027 ,.for instance ' │ │ │ │ │ -0001c7a0: 6e6f 696e 7374 5f4c 544c 4942 5241 5249 noinst_LTLIBRARI │ │ │ │ │ -0001c7b0: 4553 203d 206c 6962 666f 6f2e 6c61 2720 ES = libfoo.la' │ │ │ │ │ -0001c7c0: 282a 6e6f 7465 204c 6962 746f 6f6c 2043 (*note Libtool C │ │ │ │ │ -0001c7d0: 6f6e 7665 6e69 656e 6365 0a4c 6962 7261 onvenience.Libra │ │ │ │ │ -0001c7e0: 7269 6573 3a3a 292e 0a0a 2020 2041 6e6f ries::)... Ano │ │ │ │ │ -0001c7f0: 7468 6572 2074 656d 7074 696e 6720 6964 ther tempting id │ │ │ │ │ -0001c800: 6561 2074 6f20 696d 706c 656d 656e 7420 ea to implement │ │ │ │ │ -0001c810: 7065 722d 6f62 6a65 6374 2066 6c61 6773 per-object flags │ │ │ │ │ -0001c820: 2069 7320 746f 206f 7665 7272 6964 650a is to override. │ │ │ │ │ -0001c830: 7468 6520 636f 6d70 696c 6520 7275 6c65 the compile rule │ │ │ │ │ -0001c840: 7320 2761 7574 6f6d 616b 6527 2077 6f75 s 'automake' wou │ │ │ │ │ -0001c850: 6c64 206f 7574 7075 7420 666f 7220 7468 ld output for th │ │ │ │ │ -0001c860: 6573 6520 6669 6c65 732e 2020 4175 746f ese files. Auto │ │ │ │ │ -0001c870: 6d61 6b65 0a77 696c 6c20 6e6f 7420 6465 make.will not de │ │ │ │ │ -0001c880: 6669 6e65 2061 2072 756c 6520 666f 7220 fine a rule for │ │ │ │ │ -0001c890: 6120 7461 7267 6574 2079 6f75 2068 6176 a target you hav │ │ │ │ │ -0001c8a0: 6520 6465 6669 6e65 642c 2073 6f20 796f e defined, so yo │ │ │ │ │ -0001c8b0: 7520 636f 756c 6420 7468 696e 6b0a 6162 u could think.ab │ │ │ │ │ -0001c8c0: 6f75 7420 6465 6669 6e69 6e67 2074 6865 out defining the │ │ │ │ │ -0001c8d0: 2027 666f 6f2d 666f 6f2e 6f3a 2066 6f6f 'foo-foo.o: foo │ │ │ │ │ -0001c8e0: 2e63 2720 7275 6c65 2079 6f75 7273 656c .c' rule yoursel │ │ │ │ │ -0001c8f0: 662e 2020 5765 2072 6563 6f6d 6d65 6e64 f. We recommend │ │ │ │ │ -0001c900: 0a61 6761 696e 7374 2074 6869 732c 2062 .against this, b │ │ │ │ │ -0001c910: 6563 6175 7365 2074 6869 7320 6973 2065 ecause this is e │ │ │ │ │ -0001c920: 7272 6f72 2070 726f 6e65 2e20 2046 6f72 rror prone. For │ │ │ │ │ -0001c930: 2069 6e73 7461 6e63 652c 2069 6620 796f instance, if yo │ │ │ │ │ -0001c940: 7520 6164 640a 7375 6368 2061 2072 756c u add.such a rul │ │ │ │ │ -0001c950: 6520 746f 2074 6865 2066 6972 7374 2065 e to the first e │ │ │ │ │ -0001c960: 7861 6d70 6c65 2c20 6974 2077 696c 6c20 xample, it will │ │ │ │ │ -0001c970: 6272 6561 6b20 7468 6520 6461 7920 796f break the day yo │ │ │ │ │ -0001c980: 7520 6465 6369 6465 2074 6f0a 7265 6d6f u decide to.remo │ │ │ │ │ -0001c990: 7665 2027 666f 6f5f 4346 4c41 4753 2720 ve 'foo_CFLAGS' │ │ │ │ │ -0001c9a0: 2862 6563 6175 7365 2027 666f 6f2e 6327 (because 'foo.c' │ │ │ │ │ -0001c9b0: 2077 696c 6c20 7468 656e 2062 6520 636f will then be co │ │ │ │ │ -0001c9c0: 6d70 696c 6564 2061 7320 2766 6f6f 2e6f mpiled as 'foo.o │ │ │ │ │ -0001c9d0: 270a 696e 7374 6561 6420 6f66 2027 666f '.instead of 'fo │ │ │ │ │ -0001c9e0: 6f2d 666f 6f2e 6f27 2c20 2a6e 6f74 6520 o-foo.o', *note │ │ │ │ │ -0001c9f0: 5265 6e61 6d65 6420 4f62 6a65 6374 733a Renamed Objects: │ │ │ │ │ -0001ca00: 3a29 2e20 2041 6c73 6f20 696e 206f 7264 :). Also in ord │ │ │ │ │ -0001ca10: 6572 2074 6f0a 7375 7070 6f72 7420 6465 er to.support de │ │ │ │ │ -0001ca20: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ -0001ca30: 672c 2074 6865 2074 776f 2027 2e6f 272f g, the two '.o'/ │ │ │ │ │ -0001ca40: 272e 6f62 6a27 2065 7874 656e 7369 6f6e '.obj' extension │ │ │ │ │ -0001ca50: 732c 2061 6e64 2061 6c6c 2074 6865 0a6f s, and all the.o │ │ │ │ │ -0001ca60: 7468 6572 2066 6c61 6773 2076 6172 6961 ther flags varia │ │ │ │ │ -0001ca70: 626c 6573 2069 6e76 6f6c 7665 6420 696e bles involved in │ │ │ │ │ -0001ca80: 2061 2063 6f6d 7069 6c61 7469 6f6e 2c20 a compilation, │ │ │ │ │ -0001ca90: 796f 7520 7769 6c6c 2065 6e64 2075 700a you will end up. │ │ │ │ │ -0001caa0: 6d6f 6469 6679 696e 6720 6120 636f 7079 modifying a copy │ │ │ │ │ -0001cab0: 206f 6620 7468 6520 7275 6c65 2070 7265 of the rule pre │ │ │ │ │ -0001cac0: 7669 6f75 736c 7920 6f75 7470 7574 2062 viously output b │ │ │ │ │ -0001cad0: 7920 2761 7574 6f6d 616b 6527 2066 6f72 y 'automake' for │ │ │ │ │ -0001cae0: 2074 6869 730a 6669 6c65 2e20 2049 6620 this.file. If │ │ │ │ │ -0001caf0: 6120 6e65 7720 7265 6c65 6173 6520 6f66 a new release of │ │ │ │ │ -0001cb00: 2041 7574 6f6d 616b 6520 6765 6e65 7261 Automake genera │ │ │ │ │ -0001cb10: 7465 7320 6120 6469 6666 6572 656e 7420 tes a different │ │ │ │ │ -0001cb20: 7275 6c65 2c20 796f 7572 0a63 6f70 7920 rule, your.copy │ │ │ │ │ -0001cb30: 7769 6c6c 206e 6565 6420 746f 2062 6520 will need to be │ │ │ │ │ -0001cb40: 7570 6461 7465 6420 6279 2068 616e 642e updated by hand. │ │ │ │ │ -0001cb50: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ -0001cb60: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ -0001cb70: 6f64 653a 204d 756c 7469 706c 6520 4f75 ode: Multiple Ou │ │ │ │ │ -0001cb80: 7470 7574 732c 2020 4e65 7874 3a20 4861 tputs, Next: Ha │ │ │ │ │ -0001cb90: 7264 2d43 6f64 6564 2049 6e73 7461 6c6c rd-Coded Install │ │ │ │ │ -0001cba0: 2050 6174 6873 2c20 2050 7265 763a 2050 Paths, Prev: P │ │ │ │ │ -0001cbb0: 6572 2d4f 626a 6563 7420 466c 6167 732c er-Object Flags, │ │ │ │ │ -0001cbc0: 2020 5570 3a20 4641 510a 0a32 382e 3920 Up: FAQ..28.9 │ │ │ │ │ -0001cbd0: 4861 6e64 6c69 6e67 2054 6f6f 6c73 2074 Handling Tools t │ │ │ │ │ -0001cbe0: 6861 7420 5072 6f64 7563 6520 4d61 6e79 hat Produce Many │ │ │ │ │ -0001cbf0: 204f 7574 7075 7473 0a3d 3d3d 3d3d 3d3d Outputs.======= │ │ │ │ │ +0001c0a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2020 ============.. │ │ │ │ │ +0001c0b0: 2020 204f 6e65 206f 6620 6d79 2073 6f75 One of my sou │ │ │ │ │ +0001c0c0: 7263 6520 6669 6c65 7320 6e65 6564 7320 rce files needs │ │ │ │ │ +0001c0d0: 746f 2062 6520 636f 6d70 696c 6564 2077 to be compiled w │ │ │ │ │ +0001c0e0: 6974 6820 6469 6666 6572 656e 7420 666c ith different fl │ │ │ │ │ +0001c0f0: 6167 732e 2020 486f 770a 2020 2020 2064 ags. How. d │ │ │ │ │ +0001c100: 6f20 4920 646f 3f0a 0a20 2020 4175 746f o I do?.. Auto │ │ │ │ │ +0001c110: 6d61 6b65 2073 7570 706f 7274 7320 7065 make supports pe │ │ │ │ │ +0001c120: 722d 7072 6f67 7261 6d20 616e 6420 7065 r-program and pe │ │ │ │ │ +0001c130: 722d 6c69 6272 6172 7920 636f 6d70 696c r-library compil │ │ │ │ │ +0001c140: 6174 696f 6e20 666c 6167 7320 2873 6565 ation flags (see │ │ │ │ │ +0001c150: 0a2a 6e6f 7465 2050 726f 6772 616d 2061 .*note Program a │ │ │ │ │ +0001c160: 6e64 204c 6962 7261 7279 2056 6172 6961 nd Library Varia │ │ │ │ │ +0001c170: 626c 6573 3a3a 2061 6e64 202a 6e6f 7465 bles:: and *note │ │ │ │ │ +0001c180: 2046 6c61 6720 5661 7269 6162 6c65 730a Flag Variables. │ │ │ │ │ +0001c190: 4f72 6465 7269 6e67 3a3a 292e 2020 5769 Ordering::). Wi │ │ │ │ │ +0001c1a0: 7468 2074 6869 7320 796f 7520 6361 6e20 th this you can │ │ │ │ │ +0001c1b0: 6465 6669 6e65 2063 6f6d 7069 6c61 7469 define compilati │ │ │ │ │ +0001c1c0: 6f6e 2066 6c61 6773 2074 6861 7420 6170 on flags that ap │ │ │ │ │ +0001c1d0: 706c 7920 746f 0a61 6c6c 2066 696c 6573 ply to.all files │ │ │ │ │ +0001c1e0: 2063 6f6d 7069 6c65 6420 666f 7220 6120 compiled for a │ │ │ │ │ +0001c1f0: 7461 7267 6574 2e20 2046 6f72 2069 6e73 target. For ins │ │ │ │ │ +0001c200: 7461 6e63 652c 2069 6e0a 0a20 2020 2020 tance, in.. │ │ │ │ │ +0001c210: 6269 6e5f 5052 4f47 5241 4d53 203d 2066 bin_PROGRAMS = f │ │ │ │ │ +0001c220: 6f6f 0a20 2020 2020 666f 6f5f 534f 5552 oo. foo_SOUR │ │ │ │ │ +0001c230: 4345 5320 3d20 666f 6f2e 6320 666f 6f2e CES = foo.c foo. │ │ │ │ │ +0001c240: 6820 6261 722e 6320 6261 722e 6820 6d61 h bar.c bar.h ma │ │ │ │ │ +0001c250: 696e 2e63 0a20 2020 2020 666f 6f5f 4346 in.c. foo_CF │ │ │ │ │ +0001c260: 4c41 4753 203d 202d 736f 6d65 202d 666c LAGS = -some -fl │ │ │ │ │ +0001c270: 6167 730a 0a27 666f 6f2d 666f 6f2e 6f27 ags..'foo-foo.o' │ │ │ │ │ +0001c280: 2c20 2766 6f6f 2d62 6172 2e6f 272c 2061 , 'foo-bar.o', a │ │ │ │ │ +0001c290: 6e64 2027 666f 6f2d 6d61 696e 2e6f 2720 nd 'foo-main.o' │ │ │ │ │ +0001c2a0: 7769 6c6c 2061 6c6c 2062 6520 636f 6d70 will all be comp │ │ │ │ │ +0001c2b0: 696c 6564 2077 6974 680a 272d 736f 6d65 iled with.'-some │ │ │ │ │ +0001c2c0: 202d 666c 6167 7327 2e20 2028 4966 2079 -flags'. (If y │ │ │ │ │ +0001c2d0: 6f75 2077 6f6e 6465 7220 6162 6f75 7420 ou wonder about │ │ │ │ │ +0001c2e0: 7468 6520 6e61 6d65 7320 6f66 2074 6865 the names of the │ │ │ │ │ +0001c2f0: 7365 206f 626a 6563 7420 6669 6c65 732c se object files, │ │ │ │ │ +0001c300: 0a73 6565 202a 6e6f 7465 2052 656e 616d .see *note Renam │ │ │ │ │ +0001c310: 6564 204f 626a 6563 7473 3a3a 2e29 2020 ed Objects::.) │ │ │ │ │ +0001c320: 4e6f 7465 2074 6861 7420 2766 6f6f 5f43 Note that 'foo_C │ │ │ │ │ +0001c330: 464c 4147 5327 2067 6976 6573 2074 6865 FLAGS' gives the │ │ │ │ │ +0001c340: 2066 6c61 6773 2074 6f0a 7573 6520 7768 flags to.use wh │ │ │ │ │ +0001c350: 656e 2063 6f6d 7069 6c69 6e67 2061 6c6c en compiling all │ │ │ │ │ +0001c360: 2074 6865 2043 2073 6f75 7263 6573 206f the C sources o │ │ │ │ │ +0001c370: 6620 7468 6520 5f70 726f 6772 616d 5f20 f the _program_ │ │ │ │ │ +0001c380: 2766 6f6f 272c 2069 7420 6861 730a 6e6f 'foo', it has.no │ │ │ │ │ +0001c390: 7468 696e 6720 746f 2064 6f20 7769 7468 thing to do with │ │ │ │ │ +0001c3a0: 2027 666f 6f2e 6327 206f 7220 2766 6f6f 'foo.c' or 'foo │ │ │ │ │ +0001c3b0: 2d66 6f6f 2e6f 2720 7370 6563 6966 6963 -foo.o' specific │ │ │ │ │ +0001c3c0: 616c 6c79 2e0a 0a20 2020 5768 6174 2069 ally... What i │ │ │ │ │ +0001c3d0: 6620 2766 6f6f 2e63 2720 6e65 6564 7320 f 'foo.c' needs │ │ │ │ │ +0001c3e0: 746f 2062 6520 636f 6d70 696c 6564 2069 to be compiled i │ │ │ │ │ +0001c3f0: 6e74 6f20 2766 6f6f 2e6f 2720 7573 696e nto 'foo.o' usin │ │ │ │ │ +0001c400: 6720 736f 6d65 2073 7065 6369 6669 630a g some specific. │ │ │ │ │ +0001c410: 666c 6167 732c 2074 6861 7420 6e6f 6e65 flags, that none │ │ │ │ │ +0001c420: 206f 6620 7468 6520 6f74 6865 7220 6669 of the other fi │ │ │ │ │ +0001c430: 6c65 7320 7265 7175 6972 6573 3f20 204f les requires? O │ │ │ │ │ +0001c440: 6276 696f 7573 6c79 2070 6572 2d70 726f bviously per-pro │ │ │ │ │ +0001c450: 6772 616d 0a66 6c61 6773 2061 7265 206e gram.flags are n │ │ │ │ │ +0001c460: 6f74 2064 6972 6563 746c 7920 6170 706c ot directly appl │ │ │ │ │ +0001c470: 6963 6162 6c65 2068 6572 652e 2020 536f icable here. So │ │ │ │ │ +0001c480: 6d65 7468 696e 6720 6c69 6b65 2070 6572 mething like per │ │ │ │ │ +0001c490: 2d6f 626a 6563 7420 666c 6167 730a 6172 -object flags.ar │ │ │ │ │ +0001c4a0: 6520 6578 7065 6374 6564 2c20 692e 652e e expected, i.e. │ │ │ │ │ +0001c4b0: 2c20 666c 6167 7320 7468 6174 2077 6f75 , flags that wou │ │ │ │ │ +0001c4c0: 6c64 2062 6520 7573 6564 206f 6e6c 7920 ld be used only │ │ │ │ │ +0001c4d0: 7768 656e 2063 7265 6174 696e 670a 2766 when creating.'f │ │ │ │ │ +0001c4e0: 6f6f 2d66 6f6f 2e6f 272e 2020 4175 746f oo-foo.o'. Auto │ │ │ │ │ +0001c4f0: 6d61 6b65 2064 6f65 7320 6e6f 7420 7375 make does not su │ │ │ │ │ +0001c500: 7070 6f72 7420 7468 6174 2c20 686f 7765 pport that, howe │ │ │ │ │ +0001c510: 7665 7220 7468 6973 2069 7320 6561 7379 ver this is easy │ │ │ │ │ +0001c520: 2074 6f0a 7369 6d75 6c61 7465 2075 7369 to.simulate usi │ │ │ │ │ +0001c530: 6e67 2061 206c 6962 7261 7279 2074 6861 ng a library tha │ │ │ │ │ +0001c540: 7420 636f 6e74 6169 6e73 206f 6e6c 7920 t contains only │ │ │ │ │ +0001c550: 7468 6174 206f 626a 6563 742c 2061 6e64 that object, and │ │ │ │ │ +0001c560: 2063 6f6d 7069 6c69 6e67 0a74 6869 7320 compiling.this │ │ │ │ │ +0001c570: 6c69 6272 6172 7920 7769 7468 2070 6572 library with per │ │ │ │ │ +0001c580: 2d6c 6962 7261 7279 2066 6c61 6773 2e0a -library flags.. │ │ │ │ │ +0001c590: 0a20 2020 2020 6269 6e5f 5052 4f47 5241 . bin_PROGRA │ │ │ │ │ +0001c5a0: 4d53 203d 2066 6f6f 0a20 2020 2020 666f MS = foo. fo │ │ │ │ │ +0001c5b0: 6f5f 534f 5552 4345 5320 3d20 6261 722e o_SOURCES = bar. │ │ │ │ │ +0001c5c0: 6320 6261 722e 6820 6d61 696e 2e63 0a20 c bar.h main.c. │ │ │ │ │ +0001c5d0: 2020 2020 666f 6f5f 4346 4c41 4753 203d foo_CFLAGS = │ │ │ │ │ +0001c5e0: 202d 736f 6d65 202d 666c 6167 730a 2020 -some -flags. │ │ │ │ │ +0001c5f0: 2020 2066 6f6f 5f4c 4441 4444 203d 206c foo_LDADD = l │ │ │ │ │ +0001c600: 6962 666f 6f2e 610a 2020 2020 206e 6f69 ibfoo.a. noi │ │ │ │ │ +0001c610: 6e73 745f 4c49 4252 4152 4945 5320 3d20 nst_LIBRARIES = │ │ │ │ │ +0001c620: 6c69 6266 6f6f 2e61 0a20 2020 2020 6c69 libfoo.a. li │ │ │ │ │ +0001c630: 6266 6f6f 5f61 5f53 4f55 5243 4553 203d bfoo_a_SOURCES = │ │ │ │ │ +0001c640: 2066 6f6f 2e63 2066 6f6f 2e68 0a20 2020 foo.c foo.h. │ │ │ │ │ +0001c650: 2020 6c69 6266 6f6f 5f61 5f43 464c 4147 libfoo_a_CFLAG │ │ │ │ │ +0001c660: 5320 3d20 2d73 6f6d 6520 2d6f 7468 6572 S = -some -other │ │ │ │ │ +0001c670: 202d 666c 6167 730a 0a20 2020 4865 7265 -flags.. Here │ │ │ │ │ +0001c680: 2027 666f 6f2d 6261 722e 6f27 2061 6e64 'foo-bar.o' and │ │ │ │ │ +0001c690: 2027 666f 6f2d 6d61 696e 2e6f 2720 7769 'foo-main.o' wi │ │ │ │ │ +0001c6a0: 6c6c 2061 6c6c 2062 6520 636f 6d70 696c ll all be compil │ │ │ │ │ +0001c6b0: 6564 2077 6974 6820 272d 736f 6d65 0a2d ed with '-some.- │ │ │ │ │ +0001c6c0: 666c 6167 7327 2c20 7768 696c 6520 276c flags', while 'l │ │ │ │ │ +0001c6d0: 6962 666f 6f5f 612d 666f 6f2e 6f27 2077 ibfoo_a-foo.o' w │ │ │ │ │ +0001c6e0: 696c 6c20 6265 2063 6f6d 7069 6c65 6420 ill be compiled │ │ │ │ │ +0001c6f0: 7573 696e 6720 272d 736f 6d65 202d 6f74 using '-some -ot │ │ │ │ │ +0001c700: 6865 720a 2d66 6c61 6773 272e 2020 4576 her.-flags'. Ev │ │ │ │ │ +0001c710: 656e 7475 616c 6c79 2c20 616c 6c20 7468 entually, all th │ │ │ │ │ +0001c720: 7265 6520 6f62 6a65 6374 7320 7769 6c6c ree objects will │ │ │ │ │ +0001c730: 2062 6520 6c69 6e6b 6564 2074 6f20 666f be linked to fo │ │ │ │ │ +0001c740: 726d 2027 666f 6f27 2e0a 0a20 2020 5468 rm 'foo'... Th │ │ │ │ │ +0001c750: 6973 2074 7269 636b 2063 616e 2061 6c73 is trick can als │ │ │ │ │ +0001c760: 6f20 6265 2061 6368 6965 7665 6420 7573 o be achieved us │ │ │ │ │ +0001c770: 696e 6720 4c69 6274 6f6f 6c20 636f 6e76 ing Libtool conv │ │ │ │ │ +0001c780: 656e 6965 6e63 6520 6c69 6272 6172 6965 enience librarie │ │ │ │ │ +0001c790: 732c 0a66 6f72 2069 6e73 7461 6e63 6520 s,.for instance │ │ │ │ │ +0001c7a0: 276e 6f69 6e73 745f 4c54 4c49 4252 4152 'noinst_LTLIBRAR │ │ │ │ │ +0001c7b0: 4945 5320 3d20 6c69 6266 6f6f 2e6c 6127 IES = libfoo.la' │ │ │ │ │ +0001c7c0: 2028 2a6e 6f74 6520 4c69 6274 6f6f 6c20 (*note Libtool │ │ │ │ │ +0001c7d0: 436f 6e76 656e 6965 6e63 650a 4c69 6272 Convenience.Libr │ │ │ │ │ +0001c7e0: 6172 6965 733a 3a29 2e0a 0a20 2020 416e aries::)... An │ │ │ │ │ +0001c7f0: 6f74 6865 7220 7465 6d70 7469 6e67 2069 other tempting i │ │ │ │ │ +0001c800: 6465 6120 746f 2069 6d70 6c65 6d65 6e74 dea to implement │ │ │ │ │ +0001c810: 2070 6572 2d6f 626a 6563 7420 666c 6167 per-object flag │ │ │ │ │ +0001c820: 7320 6973 2074 6f20 6f76 6572 7269 6465 s is to override │ │ │ │ │ +0001c830: 0a74 6865 2063 6f6d 7069 6c65 2072 756c .the compile rul │ │ │ │ │ +0001c840: 6573 2027 6175 746f 6d61 6b65 2720 776f es 'automake' wo │ │ │ │ │ +0001c850: 756c 6420 6f75 7470 7574 2066 6f72 2074 uld output for t │ │ │ │ │ +0001c860: 6865 7365 2066 696c 6573 2e20 2041 7574 hese files. Aut │ │ │ │ │ +0001c870: 6f6d 616b 650a 7769 6c6c 206e 6f74 2064 omake.will not d │ │ │ │ │ +0001c880: 6566 696e 6520 6120 7275 6c65 2066 6f72 efine a rule for │ │ │ │ │ +0001c890: 2061 2074 6172 6765 7420 796f 7520 6861 a target you ha │ │ │ │ │ +0001c8a0: 7665 2064 6566 696e 6564 2c20 736f 2079 ve defined, so y │ │ │ │ │ +0001c8b0: 6f75 2063 6f75 6c64 2074 6869 6e6b 0a61 ou could think.a │ │ │ │ │ +0001c8c0: 626f 7574 2064 6566 696e 696e 6720 7468 bout defining th │ │ │ │ │ +0001c8d0: 6520 2766 6f6f 2d66 6f6f 2e6f 3a20 666f e 'foo-foo.o: fo │ │ │ │ │ +0001c8e0: 6f2e 6327 2072 756c 6520 796f 7572 7365 o.c' rule yourse │ │ │ │ │ +0001c8f0: 6c66 2e20 2057 6520 7265 636f 6d6d 656e lf. We recommen │ │ │ │ │ +0001c900: 640a 6167 6169 6e73 7420 7468 6973 2c20 d.against this, │ │ │ │ │ +0001c910: 6265 6361 7573 6520 7468 6973 2069 7320 because this is │ │ │ │ │ +0001c920: 6572 726f 7220 7072 6f6e 652e 2020 466f error prone. Fo │ │ │ │ │ +0001c930: 7220 696e 7374 616e 6365 2c20 6966 2079 r instance, if y │ │ │ │ │ +0001c940: 6f75 2061 6464 0a73 7563 6820 6120 7275 ou add.such a ru │ │ │ │ │ +0001c950: 6c65 2074 6f20 7468 6520 6669 7273 7420 le to the first │ │ │ │ │ +0001c960: 6578 616d 706c 652c 2069 7420 7769 6c6c example, it will │ │ │ │ │ +0001c970: 2062 7265 616b 2074 6865 2064 6179 2079 break the day y │ │ │ │ │ +0001c980: 6f75 2064 6563 6964 6520 746f 0a72 656d ou decide to.rem │ │ │ │ │ +0001c990: 6f76 6520 2766 6f6f 5f43 464c 4147 5327 ove 'foo_CFLAGS' │ │ │ │ │ +0001c9a0: 2028 6265 6361 7573 6520 2766 6f6f 2e63 (because 'foo.c │ │ │ │ │ +0001c9b0: 2720 7769 6c6c 2074 6865 6e20 6265 2063 ' will then be c │ │ │ │ │ +0001c9c0: 6f6d 7069 6c65 6420 6173 2027 666f 6f2e ompiled as 'foo. │ │ │ │ │ +0001c9d0: 6f27 0a69 6e73 7465 6164 206f 6620 2766 o'.instead of 'f │ │ │ │ │ +0001c9e0: 6f6f 2d66 6f6f 2e6f 272c 202a 6e6f 7465 oo-foo.o', *note │ │ │ │ │ +0001c9f0: 2052 656e 616d 6564 204f 626a 6563 7473 Renamed Objects │ │ │ │ │ +0001ca00: 3a3a 292e 2020 416c 736f 2069 6e20 6f72 ::). Also in or │ │ │ │ │ +0001ca10: 6465 7220 746f 0a73 7570 706f 7274 2064 der to.support d │ │ │ │ │ +0001ca20: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ +0001ca30: 6e67 2c20 7468 6520 7477 6f20 272e 6f27 ng, the two '.o' │ │ │ │ │ +0001ca40: 2f27 2e6f 626a 2720 6578 7465 6e73 696f /'.obj' extensio │ │ │ │ │ +0001ca50: 6e73 2c20 616e 6420 616c 6c20 7468 650a ns, and all the. │ │ │ │ │ +0001ca60: 6f74 6865 7220 666c 6167 7320 7661 7269 other flags vari │ │ │ │ │ +0001ca70: 6162 6c65 7320 696e 766f 6c76 6564 2069 ables involved i │ │ │ │ │ +0001ca80: 6e20 6120 636f 6d70 696c 6174 696f 6e2c n a compilation, │ │ │ │ │ +0001ca90: 2079 6f75 2077 696c 6c20 656e 6420 7570 you will end up │ │ │ │ │ +0001caa0: 0a6d 6f64 6966 7969 6e67 2061 2063 6f70 .modifying a cop │ │ │ │ │ +0001cab0: 7920 6f66 2074 6865 2072 756c 6520 7072 y of the rule pr │ │ │ │ │ +0001cac0: 6576 696f 7573 6c79 206f 7574 7075 7420 eviously output │ │ │ │ │ +0001cad0: 6279 2027 6175 746f 6d61 6b65 2720 666f by 'automake' fo │ │ │ │ │ +0001cae0: 7220 7468 6973 0a66 696c 652e 2020 4966 r this.file. If │ │ │ │ │ +0001caf0: 2061 206e 6577 2072 656c 6561 7365 206f a new release o │ │ │ │ │ +0001cb00: 6620 4175 746f 6d61 6b65 2067 656e 6572 f Automake gener │ │ │ │ │ +0001cb10: 6174 6573 2061 2064 6966 6665 7265 6e74 ates a different │ │ │ │ │ +0001cb20: 2072 756c 652c 2079 6f75 720a 636f 7079 rule, your.copy │ │ │ │ │ +0001cb30: 2077 696c 6c20 6e65 6564 2074 6f20 6265 will need to be │ │ │ │ │ +0001cb40: 2075 7064 6174 6564 2062 7920 6861 6e64 updated by hand │ │ │ │ │ +0001cb50: 2e0a 0a1f 0a46 696c 653a 2061 7574 6f6d .....File: autom │ │ │ │ │ +0001cb60: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ +0001cb70: 4e6f 6465 3a20 4d75 6c74 6970 6c65 204f Node: Multiple O │ │ │ │ │ +0001cb80: 7574 7075 7473 2c20 204e 6578 743a 2048 utputs, Next: H │ │ │ │ │ +0001cb90: 6172 642d 436f 6465 6420 496e 7374 616c ard-Coded Instal │ │ │ │ │ +0001cba0: 6c20 5061 7468 732c 2020 5072 6576 3a20 l Paths, Prev: │ │ │ │ │ +0001cbb0: 5065 722d 4f62 6a65 6374 2046 6c61 6773 Per-Object Flags │ │ │ │ │ +0001cbc0: 2c20 2055 703a 2046 4151 0a0a 3238 2e39 , Up: FAQ..28.9 │ │ │ │ │ +0001cbd0: 2048 616e 646c 696e 6720 546f 6f6c 7320 Handling Tools │ │ │ │ │ +0001cbe0: 7468 6174 2050 726f 6475 6365 204d 616e that Produce Man │ │ │ │ │ +0001cbf0: 7920 4f75 7470 7574 730a 3d3d 3d3d 3d3d y Outputs.====== │ │ │ │ │ 0001cc00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0001cc10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001cc20: 3d3d 3d3d 3d3d 0a0a 5468 6973 2073 6563 ======..This sec │ │ │ │ │ -0001cc30: 7469 6f6e 2064 6573 6372 6962 6573 2061 tion describes a │ │ │ │ │ -0001cc40: 2027 6d61 6b65 2720 6964 696f 6d20 7468 'make' idiom th │ │ │ │ │ -0001cc50: 6174 2063 616e 2062 6520 7573 6564 2077 at can be used w │ │ │ │ │ -0001cc60: 6865 6e20 6120 746f 6f6c 0a70 726f 6475 hen a tool.produ │ │ │ │ │ -0001cc70: 6365 7320 6d75 6c74 6970 6c65 206f 7574 ces multiple out │ │ │ │ │ -0001cc80: 7075 7420 6669 6c65 732e 2020 4974 2069 put files. It i │ │ │ │ │ -0001cc90: 7320 6e6f 7420 7370 6563 6966 6963 2074 s not specific t │ │ │ │ │ -0001cca0: 6f20 4175 746f 6d61 6b65 2061 6e64 2063 o Automake and c │ │ │ │ │ -0001ccb0: 616e 0a62 6520 7573 6564 2069 6e20 6f72 an.be used in or │ │ │ │ │ -0001ccc0: 6469 6e61 7279 2027 4d61 6b65 6669 6c65 dinary 'Makefile │ │ │ │ │ -0001ccd0: 2773 2e0a 0a20 2020 5375 7070 6f73 6520 's... Suppose │ │ │ │ │ -0001cce0: 7765 2068 6176 6520 6120 7072 6f67 7261 we have a progra │ │ │ │ │ -0001ccf0: 6d20 6361 6c6c 6564 2027 666f 6f27 2074 m called 'foo' t │ │ │ │ │ -0001cd00: 6861 7420 7769 6c6c 2072 6561 6420 6f6e hat will read on │ │ │ │ │ -0001cd10: 6520 6669 6c65 2063 616c 6c65 640a 2764 e file called.'d │ │ │ │ │ -0001cd20: 6174 612e 666f 6f27 2061 6e64 2070 726f ata.foo' and pro │ │ │ │ │ -0001cd30: 6475 6365 2074 776f 2066 696c 6573 206e duce two files n │ │ │ │ │ -0001cd40: 616d 6564 2027 6461 7461 2e63 2720 616e amed 'data.c' an │ │ │ │ │ -0001cd50: 6420 2764 6174 612e 6827 2e20 2057 6520 d 'data.h'. We │ │ │ │ │ -0001cd60: 7761 6e74 0a74 6f20 7772 6974 6520 6120 want.to write a │ │ │ │ │ -0001cd70: 274d 616b 6566 696c 6527 2072 756c 6520 'Makefile' rule │ │ │ │ │ -0001cd80: 7468 6174 2063 6170 7475 7265 7320 7468 that captures th │ │ │ │ │ -0001cd90: 6973 206f 6e65 2d74 6f2d 7477 6f20 6465 is one-to-two de │ │ │ │ │ -0001cda0: 7065 6e64 656e 6379 2e0a 0a20 2020 5468 pendency... Th │ │ │ │ │ -0001cdb0: 6520 6e61 6976 6520 7275 6c65 2069 7320 e naive rule is │ │ │ │ │ -0001cdc0: 696e 636f 7272 6563 743a 0a0a 2020 2020 incorrect:.. │ │ │ │ │ -0001cdd0: 2023 2054 6869 7320 6973 2069 6e63 6f72 # This is incor │ │ │ │ │ -0001cde0: 7265 6374 2e0a 2020 2020 2064 6174 612e rect.. data. │ │ │ │ │ -0001cdf0: 6320 6461 7461 2e68 3a20 6461 7461 2e66 c data.h: data.f │ │ │ │ │ -0001ce00: 6f6f 0a20 2020 2020 2020 2020 2020 2020 oo. │ │ │ │ │ -0001ce10: 666f 6f20 6461 7461 2e66 6f6f 0a0a 5768 foo data.foo..Wh │ │ │ │ │ -0001ce20: 6174 2074 6865 2061 626f 7665 2072 756c at the above rul │ │ │ │ │ -0001ce30: 6520 7265 616c 6c79 2073 6179 7320 6973 e really says is │ │ │ │ │ -0001ce40: 2074 6861 7420 2764 6174 612e 6327 2061 that 'data.c' a │ │ │ │ │ -0001ce50: 6e64 2027 6461 7461 2e68 2720 6561 6368 nd 'data.h' each │ │ │ │ │ -0001ce60: 0a64 6570 656e 6420 6f6e 2027 6461 7461 .depend on 'data │ │ │ │ │ -0001ce70: 2e66 6f6f 272c 2061 6e64 2063 616e 2065 .foo', and can e │ │ │ │ │ -0001ce80: 6163 6820 6265 2062 7569 6c74 2062 7920 ach be built by │ │ │ │ │ -0001ce90: 7275 6e6e 696e 6720 2766 6f6f 2064 6174 running 'foo dat │ │ │ │ │ -0001cea0: 612e 666f 6f27 2e0a 496e 206f 7468 6572 a.foo'..In other │ │ │ │ │ -0001ceb0: 2077 6f72 6473 2069 7420 6973 2065 7175 words it is equ │ │ │ │ │ -0001cec0: 6976 616c 656e 7420 746f 3a0a 0a20 2020 ivalent to:.. │ │ │ │ │ -0001ced0: 2020 2320 5765 2064 6f20 6e6f 7420 7761 # We do not wa │ │ │ │ │ -0001cee0: 6e74 2074 6869 732e 0a20 2020 2020 6461 nt this.. da │ │ │ │ │ -0001cef0: 7461 2e63 3a20 6461 7461 2e66 6f6f 0a20 ta.c: data.foo. │ │ │ │ │ -0001cf00: 2020 2020 2020 2020 2020 2020 666f 6f20 foo │ │ │ │ │ -0001cf10: 6461 7461 2e66 6f6f 0a20 2020 2020 6461 data.foo. da │ │ │ │ │ -0001cf20: 7461 2e68 3a20 6461 7461 2e66 6f6f 0a20 ta.h: data.foo. │ │ │ │ │ -0001cf30: 2020 2020 2020 2020 2020 2020 666f 6f20 foo │ │ │ │ │ -0001cf40: 6461 7461 2e66 6f6f 0a0a 7768 6963 6820 data.foo..which │ │ │ │ │ -0001cf50: 6d65 616e 7320 7468 6174 2027 666f 6f27 means that 'foo' │ │ │ │ │ -0001cf60: 2063 616e 2062 6520 7275 6e20 7477 6963 can be run twic │ │ │ │ │ -0001cf70: 652e 2020 5573 7561 6c6c 7920 6974 2077 e. Usually it w │ │ │ │ │ -0001cf80: 696c 6c20 6e6f 7420 6265 2072 756e 0a74 ill not be run.t │ │ │ │ │ -0001cf90: 7769 6365 2c20 6265 6361 7573 6520 276d wice, because 'm │ │ │ │ │ -0001cfa0: 616b 6527 2069 6d70 6c65 6d65 6e74 6174 ake' implementat │ │ │ │ │ -0001cfb0: 696f 6e73 2061 7265 2073 6d61 7274 2065 ions are smart e │ │ │ │ │ -0001cfc0: 6e6f 7567 6820 746f 2063 6865 636b 2066 nough to check f │ │ │ │ │ -0001cfd0: 6f72 2074 6865 0a65 7869 7374 656e 6365 or the.existence │ │ │ │ │ -0001cfe0: 206f 6620 7468 6520 7365 636f 6e64 2066 of the second f │ │ │ │ │ -0001cff0: 696c 6520 6166 7465 7220 7468 6520 6669 ile after the fi │ │ │ │ │ -0001d000: 7273 7420 6f6e 6520 6861 7320 6265 656e rst one has been │ │ │ │ │ -0001d010: 2062 7569 6c74 3b20 7468 6579 0a77 696c built; they.wil │ │ │ │ │ -0001d020: 6c20 7468 6572 6566 6f72 6520 6465 7465 l therefore dete │ │ │ │ │ -0001d030: 6374 2074 6861 7420 6974 2061 6c72 6561 ct that it alrea │ │ │ │ │ -0001d040: 6479 2065 7869 7374 732e 2020 486f 7765 dy exists. Howe │ │ │ │ │ -0001d050: 7665 7220 7468 6572 6520 6172 6520 6120 ver there are a │ │ │ │ │ -0001d060: 6665 770a 7369 7475 6174 696f 6e73 2077 few.situations w │ │ │ │ │ -0001d070: 6865 7265 2069 7420 6361 6e20 7275 6e20 here it can run │ │ │ │ │ -0001d080: 7477 6963 6520 616e 7977 6179 3a0a 0a20 twice anyway:.. │ │ │ │ │ -0001d090: 2020 2a20 5468 6520 6d6f 7374 2077 6f72 * The most wor │ │ │ │ │ -0001d0a0: 7279 696e 6720 6361 7365 2069 7320 7768 rying case is wh │ │ │ │ │ -0001d0b0: 656e 2072 756e 6e69 6e67 2061 2070 6172 en running a par │ │ │ │ │ -0001d0c0: 616c 6c65 6c20 276d 616b 6527 2e20 2049 allel 'make'. I │ │ │ │ │ -0001d0d0: 660a 2020 2020 2027 6461 7461 2e63 2720 f. 'data.c' │ │ │ │ │ -0001d0e0: 616e 6420 2764 6174 612e 6827 2061 7265 and 'data.h' are │ │ │ │ │ -0001d0f0: 2062 7569 6c74 2069 6e20 7061 7261 6c6c built in parall │ │ │ │ │ -0001d100: 656c 2c20 7477 6f20 2766 6f6f 2064 6174 el, two 'foo dat │ │ │ │ │ -0001d110: 612e 666f 6f27 0a20 2020 2020 636f 6d6d a.foo'. comm │ │ │ │ │ -0001d120: 616e 6473 2077 696c 6c20 7275 6e20 636f ands will run co │ │ │ │ │ -0001d130: 6e63 7572 7265 6e74 6c79 2e20 2054 6869 ncurrently. Thi │ │ │ │ │ -0001d140: 7320 6973 2068 6172 6d66 756c 2e0a 2020 s is harmful.. │ │ │ │ │ -0001d150: 202a 2041 6e6f 7468 6572 2063 6173 6520 * Another case │ │ │ │ │ -0001d160: 6973 2077 6865 6e20 7468 6520 6465 7065 is when the depe │ │ │ │ │ -0001d170: 6e64 656e 6379 2028 6865 7265 2027 6461 ndency (here 'da │ │ │ │ │ -0001d180: 7461 2e66 6f6f 2729 2069 7320 286f 720a ta.foo') is (or. │ │ │ │ │ -0001d190: 2020 2020 2064 6570 656e 6473 2075 706f depends upo │ │ │ │ │ -0001d1a0: 6e29 2061 2070 686f 6e79 2074 6172 6765 n) a phony targe │ │ │ │ │ -0001d1b0: 742e 0a0a 2020 2041 2073 6f6c 7574 696f t... A solutio │ │ │ │ │ -0001d1c0: 6e20 7468 6174 2077 6f72 6b73 2077 6974 n that works wit │ │ │ │ │ -0001d1d0: 6820 7061 7261 6c6c 656c 2027 6d61 6b65 h parallel 'make │ │ │ │ │ -0001d1e0: 2720 6275 7420 6e6f 7420 7769 7468 2070 ' but not with p │ │ │ │ │ -0001d1f0: 686f 6e79 0a64 6570 656e 6465 6e63 6965 hony.dependencie │ │ │ │ │ -0001d200: 7320 6973 2074 6865 2066 6f6c 6c6f 7769 s is the followi │ │ │ │ │ -0001d210: 6e67 3a0a 0a20 2020 2020 6461 7461 2e63 ng:.. data.c │ │ │ │ │ -0001d220: 2064 6174 612e 683a 2064 6174 612e 666f data.h: data.fo │ │ │ │ │ -0001d230: 6f0a 2020 2020 2020 2020 2020 2020 2066 o. f │ │ │ │ │ -0001d240: 6f6f 2064 6174 612e 666f 6f0a 2020 2020 oo data.foo. │ │ │ │ │ -0001d250: 2064 6174 612e 683a 2064 6174 612e 630a data.h: data.c. │ │ │ │ │ -0001d260: 0a54 6865 2061 626f 7665 2072 756c 6573 .The above rules │ │ │ │ │ -0001d270: 2061 7265 2065 7175 6976 616c 656e 7420 are equivalent │ │ │ │ │ -0001d280: 746f 0a0a 2020 2020 2064 6174 612e 633a to.. data.c: │ │ │ │ │ -0001d290: 2064 6174 612e 666f 6f0a 2020 2020 2020 data.foo. │ │ │ │ │ -0001d2a0: 2020 2020 2020 2066 6f6f 2064 6174 612e foo data. │ │ │ │ │ -0001d2b0: 666f 6f0a 2020 2020 2064 6174 612e 683a foo. data.h: │ │ │ │ │ -0001d2c0: 2064 6174 612e 666f 6f20 6461 7461 2e63 data.foo data.c │ │ │ │ │ -0001d2d0: 0a20 2020 2020 2020 2020 2020 2020 666f . fo │ │ │ │ │ -0001d2e0: 6f20 6461 7461 2e66 6f6f 0a0a 7468 6572 o data.foo..ther │ │ │ │ │ -0001d2f0: 6566 6f72 6520 6120 7061 7261 6c6c 656c efore a parallel │ │ │ │ │ -0001d300: 2027 6d61 6b65 2720 7769 6c6c 2068 6176 'make' will hav │ │ │ │ │ -0001d310: 6520 746f 2073 6572 6961 6c69 7a65 2074 e to serialize t │ │ │ │ │ -0001d320: 6865 2062 7569 6c64 7320 6f66 0a27 6461 he builds of.'da │ │ │ │ │ -0001d330: 7461 2e63 2720 616e 6420 2764 6174 612e ta.c' and 'data. │ │ │ │ │ -0001d340: 6827 2c20 616e 6420 7769 6c6c 2064 6574 h', and will det │ │ │ │ │ -0001d350: 6563 7420 7468 6174 2074 6865 2073 6563 ect that the sec │ │ │ │ │ -0001d360: 6f6e 6420 6973 206e 6f20 6c6f 6e67 6572 ond is no longer │ │ │ │ │ -0001d370: 0a6e 6565 6465 6420 6f6e 6365 2074 6865 .needed once the │ │ │ │ │ -0001d380: 2066 6972 7374 2069 7320 6f76 6572 2e0a first is over.. │ │ │ │ │ -0001d390: 0a20 2020 5573 696e 6720 7468 6973 2070 . Using this p │ │ │ │ │ -0001d3a0: 6174 7465 726e 2069 7320 7072 6f62 6162 attern is probab │ │ │ │ │ -0001d3b0: 6c79 2065 6e6f 7567 6820 666f 7220 6d6f ly enough for mo │ │ │ │ │ -0001d3c0: 7374 2063 6173 6573 2e20 2048 6f77 6576 st cases. Howev │ │ │ │ │ -0001d3d0: 6572 2069 740a 646f 6573 206e 6f74 2073 er it.does not s │ │ │ │ │ -0001d3e0: 6361 6c65 2065 6173 696c 7920 746f 206d cale easily to m │ │ │ │ │ -0001d3f0: 6f72 6520 6f75 7470 7574 2066 696c 6573 ore output files │ │ │ │ │ -0001d400: 2028 696e 2074 6869 7320 7363 6865 6d65 (in this scheme │ │ │ │ │ -0001d410: 2061 6c6c 206f 7574 7075 740a 6669 6c65 all output.file │ │ │ │ │ -0001d420: 7320 6d75 7374 2062 6520 746f 7461 6c6c s must be totall │ │ │ │ │ -0001d430: 7920 6f72 6465 7265 6420 6279 2074 6865 y ordered by the │ │ │ │ │ -0001d440: 2064 6570 656e 6465 6e63 7920 7265 6c61 dependency rela │ │ │ │ │ -0001d450: 7469 6f6e 292c 2073 6f20 7765 2077 696c tion), so we wil │ │ │ │ │ -0001d460: 6c0a 6578 706c 6f72 6520 6120 6d6f 7265 l.explore a more │ │ │ │ │ -0001d470: 2063 6f6d 706c 6963 6174 6564 2073 6f6c complicated sol │ │ │ │ │ -0001d480: 7574 696f 6e2e 0a0a 2020 2041 6e6f 7468 ution... Anoth │ │ │ │ │ -0001d490: 6572 2069 6465 6120 6973 2074 6f20 7772 er idea is to wr │ │ │ │ │ -0001d4a0: 6974 6520 7468 6520 666f 6c6c 6f77 696e ite the followin │ │ │ │ │ -0001d4b0: 673a 0a0a 2020 2020 2023 2054 6865 7265 g:.. # There │ │ │ │ │ -0001d4c0: 2069 7320 7374 696c 6c20 6120 7072 6f62 is still a prob │ │ │ │ │ -0001d4d0: 6c65 6d20 7769 7468 2074 6869 7320 6f6e lem with this on │ │ │ │ │ -0001d4e0: 652e 0a20 2020 2020 6461 7461 2e63 3a20 e.. data.c: │ │ │ │ │ -0001d4f0: 6461 7461 2e66 6f6f 0a20 2020 2020 2020 data.foo. │ │ │ │ │ -0001d500: 2020 2020 2020 666f 6f20 6461 7461 2e66 foo data.f │ │ │ │ │ -0001d510: 6f6f 0a20 2020 2020 6461 7461 2e68 3a20 oo. data.h: │ │ │ │ │ -0001d520: 6461 7461 2e63 0a0a 5468 6520 6964 6561 data.c..The idea │ │ │ │ │ -0001d530: 2069 7320 7468 6174 2027 666f 6f20 6461 is that 'foo da │ │ │ │ │ -0001d540: 7461 2e66 6f6f 2720 6973 2072 756e 206f ta.foo' is run o │ │ │ │ │ -0001d550: 6e6c 7920 7768 656e 2027 6461 7461 2e63 nly when 'data.c │ │ │ │ │ -0001d560: 2720 6e65 6564 7320 746f 2062 650a 7570 ' needs to be.up │ │ │ │ │ -0001d570: 6461 7465 642c 2062 7574 2077 6520 6675 dated, but we fu │ │ │ │ │ -0001d580: 7274 6865 7220 7374 6174 6520 7468 6174 rther state that │ │ │ │ │ -0001d590: 2027 6461 7461 2e68 2720 6465 7065 6e64 'data.h' depend │ │ │ │ │ -0001d5a0: 7320 7570 6f6e 2027 6461 7461 2e63 272e s upon 'data.c'. │ │ │ │ │ -0001d5b0: 2020 5468 6174 0a77 6179 2c20 6966 2027 That.way, if ' │ │ │ │ │ -0001d5c0: 6461 7461 2e68 2720 6973 2072 6571 7569 data.h' is requi │ │ │ │ │ -0001d5d0: 7265 6420 616e 6420 2764 6174 612e 666f red and 'data.fo │ │ │ │ │ -0001d5e0: 6f27 2069 7320 6f75 7420 6f66 2064 6174 o' is out of dat │ │ │ │ │ -0001d5f0: 652c 2074 6865 0a64 6570 656e 6465 6e63 e, the.dependenc │ │ │ │ │ -0001d600: 7920 6f6e 2027 6461 7461 2e63 2720 7769 y on 'data.c' wi │ │ │ │ │ -0001d610: 6c6c 2074 7269 6767 6572 2074 6865 2062 ll trigger the b │ │ │ │ │ -0001d620: 7569 6c64 2e0a 0a20 2020 5468 6973 2069 uild... This i │ │ │ │ │ -0001d630: 7320 616c 6d6f 7374 2070 6572 6665 6374 s almost perfect │ │ │ │ │ -0001d640: 2c20 6275 7420 7375 7070 6f73 6520 7765 , but suppose we │ │ │ │ │ -0001d650: 2068 6176 6520 6275 696c 7420 2764 6174 have built 'dat │ │ │ │ │ -0001d660: 612e 6827 2061 6e64 0a27 6461 7461 2e63 a.h' and.'data.c │ │ │ │ │ -0001d670: 272c 2061 6e64 2074 6865 6e20 7765 2065 ', and then we e │ │ │ │ │ -0001d680: 7261 7365 2027 6461 7461 2e68 272e 2020 rase 'data.h'. │ │ │ │ │ -0001d690: 5468 656e 2c20 7275 6e6e 696e 6720 276d Then, running 'm │ │ │ │ │ -0001d6a0: 616b 6520 6461 7461 2e68 2720 7769 6c6c ake data.h' will │ │ │ │ │ -0001d6b0: 0a6e 6f74 2072 6562 7569 6c64 2027 6461 .not rebuild 'da │ │ │ │ │ -0001d6c0: 7461 2e68 272e 2020 5468 6520 6162 6f76 ta.h'. The abov │ │ │ │ │ -0001d6d0: 6520 7275 6c65 7320 6a75 7374 2073 7461 e rules just sta │ │ │ │ │ -0001d6e0: 7465 2074 6861 7420 2764 6174 612e 6327 te that 'data.c' │ │ │ │ │ -0001d6f0: 206d 7573 7420 6265 0a75 702d 746f 2d64 must be.up-to-d │ │ │ │ │ -0001d700: 6174 6520 7769 7468 2072 6573 7065 6374 ate with respect │ │ │ │ │ -0001d710: 2074 6f20 2764 6174 612e 666f 6f27 2c20 to 'data.foo', │ │ │ │ │ -0001d720: 616e 6420 7468 6973 2069 7320 616c 7265 and this is alre │ │ │ │ │ -0001d730: 6164 7920 7468 6520 6361 7365 2e0a 0a20 ady the case... │ │ │ │ │ -0001d740: 2020 5768 6174 2077 6520 6e65 6564 2069 What we need i │ │ │ │ │ -0001d750: 7320 6120 7275 6c65 2074 6861 7420 666f s a rule that fo │ │ │ │ │ -0001d760: 7263 6573 2061 2072 6562 7569 6c64 2077 rces a rebuild w │ │ │ │ │ -0001d770: 6865 6e20 2764 6174 612e 6827 2069 730a hen 'data.h' is. │ │ │ │ │ -0001d780: 6d69 7373 696e 672e 2020 4865 7265 2069 missing. Here i │ │ │ │ │ -0001d790: 7420 6973 3a0a 0a20 2020 2020 6461 7461 t is:.. data │ │ │ │ │ -0001d7a0: 2e63 3a20 6461 7461 2e66 6f6f 0a20 2020 .c: data.foo. │ │ │ │ │ -0001d7b0: 2020 2020 2020 2020 2020 666f 6f20 6461 foo da │ │ │ │ │ -0001d7c0: 7461 2e66 6f6f 0a20 2020 2020 6461 7461 ta.foo. data │ │ │ │ │ -0001d7d0: 2e68 3a20 6461 7461 2e63 0a20 2020 2020 .h: data.c. │ │ │ │ │ -0001d7e0: 2323 2052 6563 6f76 6572 2066 726f 6d20 ## Recover from │ │ │ │ │ -0001d7f0: 7468 6520 7265 6d6f 7661 6c20 6f66 2024 the removal of $ │ │ │ │ │ -0001d800: 400a 2020 2020 2020 2020 2020 2020 2040 @. @ │ │ │ │ │ -0001d810: 6966 2074 6573 7420 2d66 2024 403b 2074 if test -f $@; t │ │ │ │ │ -0001d820: 6865 6e20 3a3b 2065 6c73 6520 5c0a 2020 hen :; else \. │ │ │ │ │ -0001d830: 2020 2020 2020 2020 2020 2020 2072 6d20 rm │ │ │ │ │ -0001d840: 2d66 2064 6174 612e 633b 205c 0a20 2020 -f data.c; \. │ │ │ │ │ -0001d850: 2020 2020 2020 2020 2020 2020 2428 4d41 $(MA │ │ │ │ │ -0001d860: 4b45 2920 2428 414d 5f4d 414b 4546 4c41 KE) $(AM_MAKEFLA │ │ │ │ │ -0001d870: 4753 2920 6461 7461 2e63 3b20 5c0a 2020 GS) data.c; \. │ │ │ │ │ -0001d880: 2020 2020 2020 2020 2020 2066 690a 0a20 fi.. │ │ │ │ │ -0001d890: 2020 5468 6520 6162 6f76 6520 7363 6865 The above sche │ │ │ │ │ -0001d8a0: 6d65 2063 616e 2062 6520 6578 7465 6e64 me can be extend │ │ │ │ │ -0001d8b0: 6564 2074 6f20 6861 6e64 6c65 206d 6f72 ed to handle mor │ │ │ │ │ -0001d8c0: 6520 6f75 7470 7574 7320 616e 6420 6d6f e outputs and mo │ │ │ │ │ -0001d8d0: 7265 0a69 6e70 7574 732e 2020 4f6e 6520 re.inputs. One │ │ │ │ │ -0001d8e0: 6f66 2074 6865 206f 7574 7075 7473 2069 of the outputs i │ │ │ │ │ -0001d8f0: 7320 7365 6c65 6374 6564 2074 6f20 7365 s selected to se │ │ │ │ │ -0001d900: 7276 6520 6173 2061 2077 6974 6e65 7373 rve as a witness │ │ │ │ │ -0001d910: 2074 6f20 7468 650a 7375 6363 6573 7366 to the.successf │ │ │ │ │ -0001d920: 756c 2063 6f6d 706c 6574 696f 6e20 6f66 ul completion of │ │ │ │ │ -0001d930: 2074 6865 2063 6f6d 6d61 6e64 2c20 6974 the command, it │ │ │ │ │ -0001d940: 2064 6570 656e 6473 2075 706f 6e20 616c depends upon al │ │ │ │ │ -0001d950: 6c20 696e 7075 7473 2c20 616e 640a 616c l inputs, and.al │ │ │ │ │ -0001d960: 6c20 6f74 6865 7220 6f75 7470 7574 7320 l other outputs │ │ │ │ │ -0001d970: 6465 7065 6e64 2075 706f 6e20 6974 2e20 depend upon it. │ │ │ │ │ -0001d980: 2046 6f72 2069 6e73 7461 6e63 652c 2069 For instance, i │ │ │ │ │ -0001d990: 6620 2766 6f6f 2720 7368 6f75 6c64 0a61 f 'foo' should.a │ │ │ │ │ -0001d9a0: 6464 6974 696f 6e61 6c6c 7920 7265 6164 dditionally read │ │ │ │ │ -0001d9b0: 2027 6461 7461 2e62 6172 2720 616e 6420 'data.bar' and │ │ │ │ │ -0001d9c0: 616c 736f 2070 726f 6475 6365 2027 6461 also produce 'da │ │ │ │ │ -0001d9d0: 7461 2e77 2720 616e 6420 2764 6174 612e ta.w' and 'data. │ │ │ │ │ -0001d9e0: 7827 2c20 7765 0a77 6f75 6c64 2077 7269 x', we.would wri │ │ │ │ │ -0001d9f0: 7465 3a0a 0a20 2020 2020 6461 7461 2e63 te:.. data.c │ │ │ │ │ -0001da00: 3a20 6461 7461 2e66 6f6f 2064 6174 612e : data.foo data. │ │ │ │ │ -0001da10: 6261 720a 2020 2020 2020 2020 2020 2020 bar. │ │ │ │ │ -0001da20: 2066 6f6f 2064 6174 612e 666f 6f20 6461 foo data.foo da │ │ │ │ │ -0001da30: 7461 2e62 6172 0a20 2020 2020 6461 7461 ta.bar. data │ │ │ │ │ -0001da40: 2e68 2064 6174 612e 7720 6461 7461 2e78 .h data.w data.x │ │ │ │ │ -0001da50: 3a20 6461 7461 2e63 0a20 2020 2020 2323 : data.c. ## │ │ │ │ │ -0001da60: 2052 6563 6f76 6572 2066 726f 6d20 7468 Recover from th │ │ │ │ │ -0001da70: 6520 7265 6d6f 7661 6c20 6f66 2024 400a e removal of $@. │ │ │ │ │ -0001da80: 2020 2020 2020 2020 2020 2020 2040 6966 @if │ │ │ │ │ -0001da90: 2074 6573 7420 2d66 2024 403b 2074 6865 test -f $@; the │ │ │ │ │ -0001daa0: 6e20 3a3b 2065 6c73 6520 5c0a 2020 2020 n :; else \. │ │ │ │ │ -0001dab0: 2020 2020 2020 2020 2020 2072 6d20 2d66 rm -f │ │ │ │ │ -0001dac0: 2064 6174 612e 633b 205c 0a20 2020 2020 data.c; \. │ │ │ │ │ -0001dad0: 2020 2020 2020 2020 2020 2428 4d41 4b45 $(MAKE │ │ │ │ │ -0001dae0: 2920 2428 414d 5f4d 414b 4546 4c41 4753 ) $(AM_MAKEFLAGS │ │ │ │ │ -0001daf0: 2920 6461 7461 2e63 3b20 5c0a 2020 2020 ) data.c; \. │ │ │ │ │ -0001db00: 2020 2020 2020 2020 2066 690a 0a20 2020 fi.. │ │ │ │ │ -0001db10: 486f 7765 7665 7220 7468 6572 6520 6172 However there ar │ │ │ │ │ -0001db20: 6520 6e6f 7720 7468 7265 6520 6d69 6e6f e now three mino │ │ │ │ │ -0001db30: 7220 7072 6f62 6c65 6d73 2069 6e20 7468 r problems in th │ │ │ │ │ -0001db40: 6973 2073 6574 7570 2e20 204f 6e65 2069 is setup. One i │ │ │ │ │ -0001db50: 730a 7265 6c61 7465 6420 746f 2074 6865 s.related to the │ │ │ │ │ -0001db60: 2074 696d 6573 7461 6d70 206f 7264 6572 timestamp order │ │ │ │ │ -0001db70: 696e 6720 6f66 2027 6461 7461 2e68 272c ing of 'data.h', │ │ │ │ │ -0001db80: 2027 6461 7461 2e77 272c 2027 6461 7461 'data.w', 'data │ │ │ │ │ -0001db90: 2e78 272c 2061 6e64 0a27 6461 7461 2e63 .x', and.'data.c │ │ │ │ │ -0001dba0: 272e 2020 416e 6f74 6865 7220 6f6e 6520 '. Another one │ │ │ │ │ -0001dbb0: 6973 2061 2072 6163 6520 636f 6e64 6974 is a race condit │ │ │ │ │ -0001dbc0: 696f 6e20 6966 2061 2070 6172 616c 6c65 ion if a paralle │ │ │ │ │ -0001dbd0: 6c20 276d 616b 6527 2061 7474 656d 7074 l 'make' attempt │ │ │ │ │ -0001dbe0: 730a 746f 2072 756e 206d 756c 7469 706c s.to run multipl │ │ │ │ │ -0001dbf0: 6520 696e 7374 616e 6365 7320 6f66 2074 e instances of t │ │ │ │ │ -0001dc00: 6865 2072 6563 6f76 6572 2062 6c6f 636b he recover block │ │ │ │ │ -0001dc10: 2061 7420 6f6e 6365 2e20 2046 696e 616c at once. Final │ │ │ │ │ -0001dc20: 6c79 2c20 7468 650a 7265 6375 7273 6976 ly, the.recursiv │ │ │ │ │ -0001dc30: 6520 7275 6c65 2062 7265 616b 7320 276d e rule breaks 'm │ │ │ │ │ -0001dc40: 616b 6520 2d6e 2720 7768 656e 2072 756e ake -n' when run │ │ │ │ │ -0001dc50: 2077 6974 6820 474e 5520 276d 616b 6527 with GNU 'make' │ │ │ │ │ -0001dc60: 2028 6173 2077 656c 6c20 6173 0a73 6f6d (as well as.som │ │ │ │ │ -0001dc70: 6520 6f74 6865 7220 276d 616b 6527 2069 e other 'make' i │ │ │ │ │ -0001dc80: 6d70 6c65 6d65 6e74 6174 696f 6e73 292c mplementations), │ │ │ │ │ -0001dc90: 2061 7320 6974 206d 6179 2072 656d 6f76 as it may remov │ │ │ │ │ -0001dca0: 6520 2764 6174 612e 6827 2065 7665 6e20 e 'data.h' even │ │ │ │ │ -0001dcb0: 7768 656e 0a69 7420 7368 6f75 6c64 206e when.it should n │ │ │ │ │ -0001dcc0: 6f74 2028 2a6e 6f74 6520 486f 7720 7468 ot (*note How th │ │ │ │ │ -0001dcd0: 6520 274d 414b 4527 2056 6172 6961 626c e 'MAKE' Variabl │ │ │ │ │ -0001dce0: 6520 576f 726b 733a 2028 6d61 6b65 294d e Works: (make)M │ │ │ │ │ -0001dcf0: 414b 450a 5661 7269 6162 6c65 2e29 2e0a AKE.Variable.).. │ │ │ │ │ -0001dd00: 0a20 2020 4c65 7420 7573 2064 6561 6c20 . Let us deal │ │ │ │ │ -0001dd10: 7769 7468 2074 6865 2066 6972 7374 2070 with the first p │ │ │ │ │ -0001dd20: 726f 626c 656d 2e20 2027 666f 6f27 206f roblem. 'foo' o │ │ │ │ │ -0001dd30: 7574 7075 7473 2066 6f75 7220 6669 6c65 utputs four file │ │ │ │ │ -0001dd40: 732c 2062 7574 2077 650a 646f 206e 6f74 s, but we.do not │ │ │ │ │ -0001dd50: 206b 6e6f 7720 696e 2077 6869 6368 206f know in which o │ │ │ │ │ -0001dd60: 7264 6572 2074 6865 7365 2066 696c 6573 rder these files │ │ │ │ │ -0001dd70: 2061 7265 2063 7265 6174 6564 2e20 2053 are created. S │ │ │ │ │ -0001dd80: 7570 706f 7365 2074 6861 740a 2764 6174 uppose that.'dat │ │ │ │ │ -0001dd90: 612e 6827 2069 7320 6372 6561 7465 6420 a.h' is created │ │ │ │ │ -0001dda0: 6265 666f 7265 2027 6461 7461 2e63 272e before 'data.c'. │ │ │ │ │ -0001ddb0: 2020 5468 656e 2077 6520 6861 7665 2061 Then we have a │ │ │ │ │ -0001ddc0: 2077 6569 7264 2073 6974 7561 7469 6f6e weird situation │ │ │ │ │ -0001ddd0: 2e0a 5468 6520 6e65 7874 2074 696d 6520 ..The next time │ │ │ │ │ -0001dde0: 276d 616b 6527 2069 7320 7275 6e2c 2027 'make' is run, ' │ │ │ │ │ -0001ddf0: 6461 7461 2e68 2720 7769 6c6c 2061 7070 data.h' will app │ │ │ │ │ -0001de00: 6561 7220 6f6c 6465 7220 7468 616e 2027 ear older than ' │ │ │ │ │ -0001de10: 6461 7461 2e63 272c 0a74 6865 2073 6563 data.c',.the sec │ │ │ │ │ -0001de20: 6f6e 6420 7275 6c65 2077 696c 6c20 6265 ond rule will be │ │ │ │ │ -0001de30: 2074 7269 6767 6572 6564 2c20 6120 7368 triggered, a sh │ │ │ │ │ -0001de40: 656c 6c20 7769 6c6c 2062 6520 7374 6172 ell will be star │ │ │ │ │ -0001de50: 7465 6420 746f 2065 7865 6375 7465 0a74 ted to execute.t │ │ │ │ │ -0001de60: 6865 2027 6966 2e2e 2e66 6927 2063 6f6d he 'if...fi' com │ │ │ │ │ -0001de70: 6d61 6e64 2c20 6275 7420 6163 7475 616c mand, but actual │ │ │ │ │ -0001de80: 6c79 2069 7420 7769 6c6c 206a 7573 7420 ly it will just │ │ │ │ │ -0001de90: 6578 6563 7574 6520 7468 6520 2774 6865 execute the 'the │ │ │ │ │ -0001dea0: 6e27 0a62 7261 6e63 682c 2074 6861 7420 n'.branch, that │ │ │ │ │ -0001deb0: 6973 3a20 6e6f 7468 696e 672e 2020 496e is: nothing. In │ │ │ │ │ -0001dec0: 206f 7468 6572 2077 6f72 6473 2c20 6265 other words, be │ │ │ │ │ -0001ded0: 6361 7573 6520 7468 6520 7769 746e 6573 cause the witnes │ │ │ │ │ -0001dee0: 7320 7765 0a73 656c 6563 7465 6420 6973 s we.selected is │ │ │ │ │ -0001def0: 206e 6f74 2074 6865 2066 6972 7374 2066 not the first f │ │ │ │ │ -0001df00: 696c 6520 6372 6561 7465 6420 6279 2027 ile created by ' │ │ │ │ │ -0001df10: 666f 6f27 2c20 276d 616b 6527 2077 696c foo', 'make' wil │ │ │ │ │ -0001df20: 6c20 7374 6172 7420 610a 7368 656c 6c20 l start a.shell │ │ │ │ │ -0001df30: 746f 2064 6f20 6e6f 7468 696e 6720 6561 to do nothing ea │ │ │ │ │ -0001df40: 6368 2074 696d 6520 6974 2069 7320 7275 ch time it is ru │ │ │ │ │ -0001df50: 6e2e 0a0a 2020 2041 2073 696d 706c 6520 n... A simple │ │ │ │ │ -0001df60: 7269 706f 7374 6520 6973 2074 6f20 6669 riposte is to fi │ │ │ │ │ -0001df70: 7820 7468 6520 7469 6d65 7374 616d 7073 x the timestamps │ │ │ │ │ -0001df80: 2077 6865 6e20 7468 6973 2068 6170 7065 when this happe │ │ │ │ │ -0001df90: 6e73 2e0a 0a20 2020 2020 6461 7461 2e63 ns... data.c │ │ │ │ │ -0001dfa0: 3a20 6461 7461 2e66 6f6f 2064 6174 612e : data.foo data. │ │ │ │ │ -0001dfb0: 6261 720a 2020 2020 2020 2020 2020 2020 bar. │ │ │ │ │ -0001dfc0: 2066 6f6f 2064 6174 612e 666f 6f20 6461 foo data.foo da │ │ │ │ │ -0001dfd0: 7461 2e62 6172 0a20 2020 2020 6461 7461 ta.bar. data │ │ │ │ │ -0001dfe0: 2e68 2064 6174 612e 7720 6461 7461 2e78 .h data.w data.x │ │ │ │ │ -0001dff0: 3a20 6461 7461 2e63 0a20 2020 2020 2020 : data.c. │ │ │ │ │ -0001e000: 2020 2020 2020 4069 6620 7465 7374 202d @if test - │ │ │ │ │ -0001e010: 6620 2440 3b20 7468 656e 205c 0a20 2020 f $@; then \. │ │ │ │ │ -0001e020: 2020 2020 2020 2020 2020 2020 746f 7563 touc │ │ │ │ │ -0001e030: 6820 2440 3b20 5c0a 2020 2020 2020 2020 h $@; \. │ │ │ │ │ -0001e040: 2020 2020 2065 6c73 6520 5c0a 2020 2020 else \. │ │ │ │ │ -0001e050: 2023 2320 5265 636f 7665 7220 6672 6f6d ## Recover from │ │ │ │ │ -0001e060: 2074 6865 2072 656d 6f76 616c 206f 6620 the removal of │ │ │ │ │ -0001e070: 2440 0a20 2020 2020 2020 2020 2020 2020 $@. │ │ │ │ │ -0001e080: 2020 726d 202d 6620 6461 7461 2e63 3b20 rm -f data.c; │ │ │ │ │ -0001e090: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001e0a0: 2024 284d 414b 4529 2024 2841 4d5f 4d41 $(MAKE) $(AM_MA │ │ │ │ │ -0001e0b0: 4b45 464c 4147 5329 2064 6174 612e 633b KEFLAGS) data.c; │ │ │ │ │ -0001e0c0: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001e0d0: 6669 0a0a 2020 2041 6e6f 7468 6572 2073 fi.. Another s │ │ │ │ │ -0001e0e0: 6f6c 7574 696f 6e20 6973 2074 6f20 7573 olution is to us │ │ │ │ │ -0001e0f0: 6520 6120 6469 6666 6572 656e 7420 616e e a different an │ │ │ │ │ -0001e100: 6420 6465 6469 6361 7465 6420 6669 6c65 d dedicated file │ │ │ │ │ -0001e110: 2061 7320 7769 746e 6573 732c 0a72 6174 as witness,.rat │ │ │ │ │ -0001e120: 6865 7220 7468 616e 2075 7369 6e67 2061 her than using a │ │ │ │ │ -0001e130: 6e79 206f 6620 2766 6f6f 2727 7320 6f75 ny of 'foo''s ou │ │ │ │ │ -0001e140: 7470 7574 732e 0a0a 2020 2020 2064 6174 tputs... dat │ │ │ │ │ -0001e150: 612e 7374 616d 703a 2064 6174 612e 666f a.stamp: data.fo │ │ │ │ │ -0001e160: 6f20 6461 7461 2e62 6172 0a20 2020 2020 o data.bar. │ │ │ │ │ -0001e170: 2020 2020 2020 2020 4072 6d20 2d66 2064 @rm -f d │ │ │ │ │ -0001e180: 6174 612e 746d 700a 2020 2020 2020 2020 ata.tmp. │ │ │ │ │ -0001e190: 2020 2020 2040 746f 7563 6820 6461 7461 @touch data │ │ │ │ │ -0001e1a0: 2e74 6d70 0a20 2020 2020 2020 2020 2020 .tmp. │ │ │ │ │ -0001e1b0: 2020 666f 6f20 6461 7461 2e66 6f6f 2064 foo data.foo d │ │ │ │ │ -0001e1c0: 6174 612e 6261 720a 2020 2020 2020 2020 ata.bar. │ │ │ │ │ -0001e1d0: 2020 2020 2040 6d76 202d 6620 6461 7461 @mv -f data │ │ │ │ │ -0001e1e0: 2e74 6d70 2024 400a 2020 2020 2064 6174 .tmp $@. dat │ │ │ │ │ -0001e1f0: 612e 6320 6461 7461 2e68 2064 6174 612e a.c data.h data. │ │ │ │ │ -0001e200: 7720 6461 7461 2e78 3a20 6461 7461 2e73 w data.x: data.s │ │ │ │ │ -0001e210: 7461 6d70 0a20 2020 2020 2323 2052 6563 tamp. ## Rec │ │ │ │ │ -0001e220: 6f76 6572 2066 726f 6d20 7468 6520 7265 over from the re │ │ │ │ │ -0001e230: 6d6f 7661 6c20 6f66 2024 400a 2020 2020 moval of $@. │ │ │ │ │ -0001e240: 2020 2020 2020 2020 2040 6966 2074 6573 @if tes │ │ │ │ │ -0001e250: 7420 2d66 2024 403b 2074 6865 6e20 3a3b t -f $@; then :; │ │ │ │ │ -0001e260: 2065 6c73 6520 5c0a 2020 2020 2020 2020 else \. │ │ │ │ │ -0001e270: 2020 2020 2020 2072 6d20 2d66 2064 6174 rm -f dat │ │ │ │ │ -0001e280: 612e 7374 616d 703b 205c 0a20 2020 2020 a.stamp; \. │ │ │ │ │ -0001e290: 2020 2020 2020 2020 2020 2428 4d41 4b45 $(MAKE │ │ │ │ │ -0001e2a0: 2920 2428 414d 5f4d 414b 4546 4c41 4753 ) $(AM_MAKEFLAGS │ │ │ │ │ -0001e2b0: 2920 6461 7461 2e73 7461 6d70 3b20 5c0a ) data.stamp; \. │ │ │ │ │ -0001e2c0: 2020 2020 2020 2020 2020 2020 2066 690a fi. │ │ │ │ │ -0001e2d0: 0a20 2020 2764 6174 612e 746d 7027 2069 . 'data.tmp' i │ │ │ │ │ -0001e2e0: 7320 6372 6561 7465 6420 6265 666f 7265 s created before │ │ │ │ │ -0001e2f0: 2027 666f 6f27 2069 7320 7275 6e2c 2073 'foo' is run, s │ │ │ │ │ -0001e300: 6f20 6974 2068 6173 2061 2074 696d 6573 o it has a times │ │ │ │ │ -0001e310: 7461 6d70 0a6f 6c64 6572 2074 6861 6e20 tamp.older than │ │ │ │ │ -0001e320: 6f75 7470 7574 2066 696c 6573 206f 7574 output files out │ │ │ │ │ -0001e330: 7075 7420 6279 2027 666f 6f27 2e20 2049 put by 'foo'. I │ │ │ │ │ -0001e340: 7420 6973 2074 6865 6e20 7265 6e61 6d65 t is then rename │ │ │ │ │ -0001e350: 6420 746f 0a27 6461 7461 2e73 7461 6d70 d to.'data.stamp │ │ │ │ │ -0001e360: 2720 6166 7465 7220 2766 6f6f 2720 6861 ' after 'foo' ha │ │ │ │ │ -0001e370: 7320 7275 6e2c 2062 6563 6175 7365 2077 s run, because w │ │ │ │ │ -0001e380: 6520 646f 206e 6f74 2077 616e 7420 746f e do not want to │ │ │ │ │ -0001e390: 2075 7064 6174 650a 2764 6174 612e 7374 update.'data.st │ │ │ │ │ -0001e3a0: 616d 7027 2069 6620 2766 6f6f 2720 6661 amp' if 'foo' fa │ │ │ │ │ -0001e3b0: 696c 732e 0a0a 2020 2054 6869 7320 736f ils... This so │ │ │ │ │ -0001e3c0: 6c75 7469 6f6e 2073 7469 6c6c 2073 7566 lution still suf │ │ │ │ │ -0001e3d0: 6665 7273 2066 726f 6d20 7468 6520 7365 fers from the se │ │ │ │ │ -0001e3e0: 636f 6e64 2070 726f 626c 656d 3a20 7468 cond problem: th │ │ │ │ │ -0001e3f0: 6520 7261 6365 0a63 6f6e 6469 7469 6f6e e race.condition │ │ │ │ │ -0001e400: 2069 6e20 7468 6520 7265 636f 7665 7220 in the recover │ │ │ │ │ -0001e410: 7275 6c65 2e20 2049 662c 2061 6674 6572 rule. If, after │ │ │ │ │ -0001e420: 2061 2073 7563 6365 7373 6675 6c20 6275 a successful bu │ │ │ │ │ -0001e430: 696c 642c 2061 2075 7365 720a 6572 6173 ild, a user.eras │ │ │ │ │ -0001e440: 6573 2027 6461 7461 2e63 2720 616e 6420 es 'data.c' and │ │ │ │ │ -0001e450: 2764 6174 612e 6827 2c20 616e 6420 7275 'data.h', and ru │ │ │ │ │ -0001e460: 6e73 2027 6d61 6b65 202d 6a27 2c20 7468 ns 'make -j', th │ │ │ │ │ -0001e470: 656e 2027 6d61 6b65 2720 6d61 7920 7374 en 'make' may st │ │ │ │ │ -0001e480: 6172 740a 626f 7468 2072 6563 6f76 6572 art.both recover │ │ │ │ │ -0001e490: 2072 756c 6573 2069 6e20 7061 7261 6c6c rules in parall │ │ │ │ │ -0001e4a0: 656c 2e20 2049 6620 7468 6520 7477 6f20 el. If the two │ │ │ │ │ -0001e4b0: 696e 7374 616e 6365 7320 6f66 2074 6865 instances of the │ │ │ │ │ -0001e4c0: 2072 756c 650a 6578 6563 7574 6520 2724 rule.execute '$ │ │ │ │ │ -0001e4d0: 284d 414b 4529 2024 2841 4d5f 4d41 4b45 (MAKE) $(AM_MAKE │ │ │ │ │ -0001e4e0: 464c 4147 5329 2064 6174 612e 7374 616d FLAGS) data.stam │ │ │ │ │ -0001e4f0: 7027 2063 6f6e 6375 7272 656e 746c 7920 p' concurrently │ │ │ │ │ -0001e500: 7468 6520 6275 696c 6420 6973 0a6c 696b the build is.lik │ │ │ │ │ -0001e510: 656c 7920 746f 2066 6169 6c20 2866 6f72 ely to fail (for │ │ │ │ │ -0001e520: 2069 6e73 7461 6e63 652c 2074 6865 2074 instance, the t │ │ │ │ │ -0001e530: 776f 2072 756c 6573 2077 696c 6c20 6372 wo rules will cr │ │ │ │ │ -0001e540: 6561 7465 2027 6461 7461 2e74 6d70 272c eate 'data.tmp', │ │ │ │ │ -0001e550: 2062 7574 0a6f 6e6c 7920 6f6e 6520 6361 but.only one ca │ │ │ │ │ -0001e560: 6e20 7265 6e61 6d65 2069 7429 2e0a 0a20 n rename it)... │ │ │ │ │ -0001e570: 2020 4164 6d69 7474 6564 6c79 2c20 7375 Admittedly, su │ │ │ │ │ -0001e580: 6368 2061 2077 6569 7264 2073 6974 7561 ch a weird situa │ │ │ │ │ -0001e590: 7469 6f6e 2064 6f65 7320 6e6f 7420 6172 tion does not ar │ │ │ │ │ -0001e5a0: 6973 6520 6475 7269 6e67 206f 7264 696e ise during ordin │ │ │ │ │ -0001e5b0: 6172 790a 6275 696c 6473 2e20 2049 7420 ary.builds. It │ │ │ │ │ -0001e5c0: 6f63 6375 7273 206f 6e6c 7920 7768 656e occurs only when │ │ │ │ │ -0001e5d0: 2074 6865 2062 7569 6c64 2074 7265 6520 the build tree │ │ │ │ │ -0001e5e0: 6973 206d 7574 696c 6174 6564 2e20 2048 is mutilated. H │ │ │ │ │ -0001e5f0: 6572 6520 2764 6174 612e 6327 0a61 6e64 ere 'data.c'.and │ │ │ │ │ -0001e600: 2027 6461 7461 2e68 2720 6861 7665 2062 'data.h' have b │ │ │ │ │ -0001e610: 6565 6e20 6578 706c 6963 6974 6c79 2072 een explicitly r │ │ │ │ │ -0001e620: 656d 6f76 6564 2077 6974 686f 7574 2061 emoved without a │ │ │ │ │ -0001e630: 6c73 6f20 7265 6d6f 7669 6e67 0a27 6461 lso removing.'da │ │ │ │ │ -0001e640: 7461 2e73 7461 6d70 2720 616e 6420 7468 ta.stamp' and th │ │ │ │ │ -0001e650: 6520 6f74 6865 7220 6f75 7470 7574 2066 e other output f │ │ │ │ │ -0001e660: 696c 6573 2e20 2027 6d61 6b65 2063 6c65 iles. 'make cle │ │ │ │ │ -0001e670: 616e 3b20 6d61 6b65 2720 7769 6c6c 2061 an; make' will a │ │ │ │ │ -0001e680: 6c77 6179 730a 7265 636f 7665 7220 6672 lways.recover fr │ │ │ │ │ -0001e690: 6f6d 2074 6865 7365 2073 6974 7561 7469 om these situati │ │ │ │ │ -0001e6a0: 6f6e 7320 6576 656e 2077 6974 6820 7061 ons even with pa │ │ │ │ │ -0001e6b0: 7261 6c6c 656c 206d 616b 6573 2c20 736f rallel makes, so │ │ │ │ │ -0001e6c0: 2079 6f75 206d 6179 0a64 6563 6964 6520 you may.decide │ │ │ │ │ -0001e6d0: 7468 6174 2074 6865 2072 6563 6f76 6572 that the recover │ │ │ │ │ -0001e6e0: 2072 756c 6520 6973 2073 6f6c 656c 7920 rule is solely │ │ │ │ │ -0001e6f0: 746f 2068 656c 7020 6e6f 6e2d 7061 7261 to help non-para │ │ │ │ │ -0001e700: 6c6c 656c 206d 616b 6520 7573 6572 730a llel make users. │ │ │ │ │ -0001e710: 616e 6420 6c65 6176 6520 7468 696e 6773 and leave things │ │ │ │ │ -0001e720: 2061 732d 6973 2e20 2046 6978 696e 6720 as-is. Fixing │ │ │ │ │ -0001e730: 7468 6973 2072 6571 7569 7265 7320 736f this requires so │ │ │ │ │ -0001e740: 6d65 206c 6f63 6b69 6e67 206d 6563 6861 me locking mecha │ │ │ │ │ -0001e750: 6e69 736d 2074 6f0a 656e 7375 7265 206f nism to.ensure o │ │ │ │ │ -0001e760: 6e6c 7920 6f6e 6520 696e 7374 616e 6365 nly one instance │ │ │ │ │ -0001e770: 206f 6620 7468 6520 7265 636f 7665 7220 of the recover │ │ │ │ │ -0001e780: 7275 6c65 2072 6562 7569 6c64 7320 2764 rule rebuilds 'd │ │ │ │ │ -0001e790: 6174 612e 7374 616d 7027 2e20 204f 6e65 ata.stamp'. One │ │ │ │ │ -0001e7a0: 0a63 6f75 6c64 2069 6d61 6769 6e65 2073 .could imagine s │ │ │ │ │ -0001e7b0: 6f6d 6574 6869 6e67 2061 6c6f 6e67 2074 omething along t │ │ │ │ │ -0001e7c0: 6865 2066 6f6c 6c6f 7769 6e67 206c 696e he following lin │ │ │ │ │ -0001e7d0: 6573 2e0a 0a20 2020 2020 6461 7461 2e63 es... data.c │ │ │ │ │ -0001e7e0: 2064 6174 612e 6820 6461 7461 2e77 2064 data.h data.w d │ │ │ │ │ -0001e7f0: 6174 612e 783a 2064 6174 612e 7374 616d ata.x: data.stam │ │ │ │ │ -0001e800: 700a 2020 2020 2023 2320 5265 636f 7665 p. ## Recove │ │ │ │ │ -0001e810: 7220 6672 6f6d 2074 6865 2072 656d 6f76 r from the remov │ │ │ │ │ -0001e820: 616c 206f 6620 2440 0a20 2020 2020 2020 al of $@. │ │ │ │ │ -0001e830: 2020 2020 2020 4069 6620 7465 7374 202d @if test - │ │ │ │ │ -0001e840: 6620 2440 3b20 7468 656e 203a 3b20 656c f $@; then :; el │ │ │ │ │ -0001e850: 7365 205c 0a20 2020 2020 2020 2020 2020 se \. │ │ │ │ │ -0001e860: 2020 2020 7472 6170 2027 726d 202d 7266 trap 'rm -rf │ │ │ │ │ -0001e870: 2064 6174 612e 6c6f 636b 2064 6174 612e data.lock data. │ │ │ │ │ -0001e880: 7374 616d 7027 2031 2032 2031 3320 3135 stamp' 1 2 13 15 │ │ │ │ │ -0001e890: 3b20 5c0a 2020 2020 2023 2320 6d6b 6469 ; \. ## mkdi │ │ │ │ │ -0001e8a0: 7220 6973 2061 2070 6f72 7461 626c 6520 r is a portable │ │ │ │ │ -0001e8b0: 7465 7374 2d61 6e64 2d73 6574 0a20 2020 test-and-set. │ │ │ │ │ -0001e8c0: 2020 2020 2020 2020 2020 2020 6966 206d if m │ │ │ │ │ -0001e8d0: 6b64 6972 2064 6174 612e 6c6f 636b 2032 kdir data.lock 2 │ │ │ │ │ -0001e8e0: 3e2f 6465 762f 6e75 6c6c 3b20 7468 656e >/dev/null; then │ │ │ │ │ -0001e8f0: 205c 0a20 2020 2020 2323 2054 6869 7320 \. ## This │ │ │ │ │ -0001e900: 636f 6465 2069 7320 6265 696e 6720 6578 code is being ex │ │ │ │ │ -0001e910: 6563 7574 6564 2062 7920 7468 6520 6669 ecuted by the fi │ │ │ │ │ -0001e920: 7273 7420 7072 6f63 6573 732e 0a20 2020 rst process.. │ │ │ │ │ -0001e930: 2020 2020 2020 2020 2020 2020 2020 726d rm │ │ │ │ │ -0001e940: 202d 6620 6461 7461 2e73 7461 6d70 3b20 -f data.stamp; │ │ │ │ │ -0001e950: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001e960: 2020 2024 284d 414b 4529 2024 2841 4d5f $(MAKE) $(AM_ │ │ │ │ │ -0001e970: 4d41 4b45 464c 4147 5329 2064 6174 612e MAKEFLAGS) data. │ │ │ │ │ -0001e980: 7374 616d 703b 205c 0a20 2020 2020 2020 stamp; \. │ │ │ │ │ -0001e990: 2020 2020 2020 2020 2020 7265 7375 6c74 result │ │ │ │ │ -0001e9a0: 3d24 243f 3b20 726d 202d 7266 2064 6174 =$$?; rm -rf dat │ │ │ │ │ -0001e9b0: 612e 6c6f 636b 3b20 6578 6974 2024 2472 a.lock; exit $$r │ │ │ │ │ -0001e9c0: 6573 756c 743b 205c 0a20 2020 2020 2020 esult; \. │ │ │ │ │ -0001e9d0: 2020 2020 2020 2020 656c 7365 205c 0a20 else \. │ │ │ │ │ -0001e9e0: 2020 2020 2323 2054 6869 7320 636f 6465 ## This code │ │ │ │ │ -0001e9f0: 2069 7320 6265 696e 6720 6578 6563 7574 is being execut │ │ │ │ │ -0001ea00: 6564 2062 7920 7468 6520 666f 6c6c 6f77 ed by the follow │ │ │ │ │ -0001ea10: 6572 2070 726f 6365 7373 6573 2e0a 2020 er processes.. │ │ │ │ │ -0001ea20: 2020 2023 2320 5761 6974 2075 6e74 696c ## Wait until │ │ │ │ │ -0001ea30: 2074 6865 2066 6972 7374 2070 726f 6365 the first proce │ │ │ │ │ -0001ea40: 7373 2069 7320 646f 6e65 2e0a 2020 2020 ss is done.. │ │ │ │ │ -0001ea50: 2020 2020 2020 2020 2020 2020 2077 6869 whi │ │ │ │ │ -0001ea60: 6c65 2074 6573 7420 2d64 2064 6174 612e le test -d data. │ │ │ │ │ -0001ea70: 6c6f 636b 3b20 646f 2073 6c65 6570 2031 lock; do sleep 1 │ │ │ │ │ -0001ea80: 3b20 646f 6e65 3b20 5c0a 2020 2020 2023 ; done; \. # │ │ │ │ │ -0001ea90: 2320 5375 6363 6565 6420 6966 2061 6e64 # Succeed if and │ │ │ │ │ -0001eaa0: 206f 6e6c 7920 6966 2074 6865 2066 6972 only if the fir │ │ │ │ │ -0001eab0: 7374 2070 726f 6365 7373 2073 7563 6365 st process succe │ │ │ │ │ -0001eac0: 6564 6564 2e0a 2020 2020 2020 2020 2020 eded.. │ │ │ │ │ -0001ead0: 2020 2020 2020 2074 6573 7420 2d66 2064 test -f d │ │ │ │ │ -0001eae0: 6174 612e 7374 616d 703b 205c 0a20 2020 ata.stamp; \. │ │ │ │ │ -0001eaf0: 2020 2020 2020 2020 2020 2020 6669 3b20 fi; │ │ │ │ │ -0001eb00: 5c0a 2020 2020 2020 2020 2020 2020 2066 \. f │ │ │ │ │ -0001eb10: 690a 0a20 2020 5573 696e 6720 6120 6465 i.. Using a de │ │ │ │ │ -0001eb20: 6469 6361 7465 6420 7769 746e 6573 732c dicated witness, │ │ │ │ │ -0001eb30: 206c 696b 6520 2764 6174 612e 7374 616d like 'data.stam │ │ │ │ │ -0001eb40: 7027 2c20 6973 2076 6572 7920 6861 6e64 p', is very hand │ │ │ │ │ -0001eb50: 7920 7768 656e 2074 6865 0a6c 6973 7420 y when the.list │ │ │ │ │ -0001eb60: 6f66 206f 7574 7075 7420 6669 6c65 7320 of output files │ │ │ │ │ -0001eb70: 6973 206e 6f74 206b 6e6f 776e 2062 6566 is not known bef │ │ │ │ │ -0001eb80: 6f72 6568 616e 642e 2020 4173 2061 6e20 orehand. As an │ │ │ │ │ -0001eb90: 696c 6c75 7374 7261 7469 6f6e 2c0a 636f illustration,.co │ │ │ │ │ -0001eba0: 6e73 6964 6572 2074 6865 2066 6f6c 6c6f nsider the follo │ │ │ │ │ -0001ebb0: 7769 6e67 2072 756c 6573 2074 6f20 636f wing rules to co │ │ │ │ │ -0001ebc0: 6d70 696c 6520 6d61 6e79 2027 2a2e 656c mpile many '*.el │ │ │ │ │ -0001ebd0: 2720 6669 6c65 7320 696e 746f 2027 2a2e ' files into '*. │ │ │ │ │ -0001ebe0: 656c 6327 0a66 696c 6573 2069 6e20 6120 elc'.files in a │ │ │ │ │ -0001ebf0: 7369 6e67 6c65 2063 6f6d 6d61 6e64 2e20 single command. │ │ │ │ │ -0001ec00: 2049 7420 646f 6573 206e 6f74 206d 6174 It does not mat │ │ │ │ │ -0001ec10: 7465 7220 686f 7720 2745 4c46 494c 4553 ter how 'ELFILES │ │ │ │ │ -0001ec20: 2720 6973 2064 6566 696e 6564 0a28 6173 ' is defined.(as │ │ │ │ │ -0001ec30: 206c 6f6e 6720 6173 2069 7420 6973 206e long as it is n │ │ │ │ │ -0001ec40: 6f74 2065 6d70 7479 3a20 656d 7074 7920 ot empty: empty │ │ │ │ │ -0001ec50: 7461 7267 6574 7320 6172 6520 6e6f 7420 targets are not │ │ │ │ │ -0001ec60: 6163 6365 7074 6564 2062 7920 504f 5349 accepted by POSI │ │ │ │ │ -0001ec70: 5829 2e0a 0a20 2020 2020 454c 4649 4c45 X)... ELFILE │ │ │ │ │ -0001ec80: 5320 3d20 6f6e 652e 656c 2074 776f 2e65 S = one.el two.e │ │ │ │ │ -0001ec90: 6c20 7468 7265 652e 656c 202e 2e2e 0a20 l three.el .... │ │ │ │ │ -0001eca0: 2020 2020 454c 4346 494c 4553 203d 2024 ELCFILES = $ │ │ │ │ │ -0001ecb0: 2845 4c46 494c 4553 3a3d 6329 0a0a 2020 (ELFILES:=c).. │ │ │ │ │ -0001ecc0: 2020 2065 6c63 2d73 7461 6d70 3a20 2428 elc-stamp: $( │ │ │ │ │ -0001ecd0: 454c 4649 4c45 5329 0a20 2020 2020 2020 ELFILES). │ │ │ │ │ -0001ece0: 2020 2020 2020 4072 6d20 2d66 2065 6c63 @rm -f elc │ │ │ │ │ -0001ecf0: 2d74 656d 700a 2020 2020 2020 2020 2020 -temp. │ │ │ │ │ -0001ed00: 2020 2040 746f 7563 6820 656c 632d 7465 @touch elc-te │ │ │ │ │ -0001ed10: 6d70 0a20 2020 2020 2020 2020 2020 2020 mp. │ │ │ │ │ -0001ed20: 2428 656c 6973 705f 636f 6d70 2920 2428 $(elisp_comp) $( │ │ │ │ │ -0001ed30: 454c 4649 4c45 5329 0a20 2020 2020 2020 ELFILES). │ │ │ │ │ -0001ed40: 2020 2020 2020 406d 7620 2d66 2065 6c63 @mv -f elc │ │ │ │ │ -0001ed50: 2d74 656d 7020 2440 0a0a 2020 2020 2024 -temp $@.. $ │ │ │ │ │ -0001ed60: 2845 4c43 4649 4c45 5329 3a20 656c 632d (ELCFILES): elc- │ │ │ │ │ -0001ed70: 7374 616d 700a 2020 2020 2020 2020 2020 stamp. │ │ │ │ │ -0001ed80: 2020 2040 6966 2074 6573 7420 2d66 2024 @if test -f $ │ │ │ │ │ -0001ed90: 403b 2074 6865 6e20 3a3b 2065 6c73 6520 @; then :; else │ │ │ │ │ -0001eda0: 5c0a 2020 2020 2023 2320 5265 636f 7665 \. ## Recove │ │ │ │ │ -0001edb0: 7220 6672 6f6d 2074 6865 2072 656d 6f76 r from the remov │ │ │ │ │ -0001edc0: 616c 206f 6620 2440 0a20 2020 2020 2020 al of $@. │ │ │ │ │ -0001edd0: 2020 2020 2020 2020 7472 6170 2027 726d trap 'rm │ │ │ │ │ -0001ede0: 202d 7266 2065 6c63 2d6c 6f63 6b20 656c -rf elc-lock el │ │ │ │ │ -0001edf0: 632d 7374 616d 7027 2031 2032 2031 3320 c-stamp' 1 2 13 │ │ │ │ │ -0001ee00: 3135 3b20 5c0a 2020 2020 2020 2020 2020 15; \. │ │ │ │ │ -0001ee10: 2020 2020 2069 6620 6d6b 6469 7220 656c if mkdir el │ │ │ │ │ -0001ee20: 632d 6c6f 636b 2032 3e2f 6465 762f 6e75 c-lock 2>/dev/nu │ │ │ │ │ -0001ee30: 6c6c 3b20 7468 656e 205c 0a20 2020 2020 ll; then \. │ │ │ │ │ -0001ee40: 2323 2054 6869 7320 636f 6465 2069 7320 ## This code is │ │ │ │ │ -0001ee50: 6265 696e 6720 6578 6563 7574 6564 2062 being executed b │ │ │ │ │ -0001ee60: 7920 7468 6520 6669 7273 7420 7072 6f63 y the first proc │ │ │ │ │ -0001ee70: 6573 732e 0a20 2020 2020 2020 2020 2020 ess.. │ │ │ │ │ -0001ee80: 2020 2020 2020 726d 202d 6620 656c 632d rm -f elc- │ │ │ │ │ -0001ee90: 7374 616d 703b 205c 0a20 2020 2020 2020 stamp; \. │ │ │ │ │ -0001eea0: 2020 2020 2020 2020 2020 2428 4d41 4b45 $(MAKE │ │ │ │ │ -0001eeb0: 2920 2428 414d 5f4d 414b 4546 4c41 4753 ) $(AM_MAKEFLAGS │ │ │ │ │ -0001eec0: 2920 656c 632d 7374 616d 703b 205c 0a20 ) elc-stamp; \. │ │ │ │ │ +0001cc20: 3d3d 3d3d 3d3d 3d0a 0a54 6869 7320 7365 =======..This se │ │ │ │ │ +0001cc30: 6374 696f 6e20 6465 7363 7269 6265 7320 ction describes │ │ │ │ │ +0001cc40: 6120 276d 616b 6527 2069 6469 6f6d 2074 a 'make' idiom t │ │ │ │ │ +0001cc50: 6861 7420 6361 6e20 6265 2075 7365 6420 hat can be used │ │ │ │ │ +0001cc60: 7768 656e 2061 2074 6f6f 6c0a 7072 6f64 when a tool.prod │ │ │ │ │ +0001cc70: 7563 6573 206d 756c 7469 706c 6520 6f75 uces multiple ou │ │ │ │ │ +0001cc80: 7470 7574 2066 696c 6573 2e20 2049 7420 tput files. It │ │ │ │ │ +0001cc90: 6973 206e 6f74 2073 7065 6369 6669 6320 is not specific │ │ │ │ │ +0001cca0: 746f 2041 7574 6f6d 616b 6520 616e 6420 to Automake and │ │ │ │ │ +0001ccb0: 6361 6e0a 6265 2075 7365 6420 696e 206f can.be used in o │ │ │ │ │ +0001ccc0: 7264 696e 6172 7920 274d 616b 6566 696c rdinary 'Makefil │ │ │ │ │ +0001ccd0: 6527 732e 0a0a 2020 2053 7570 706f 7365 e's... Suppose │ │ │ │ │ +0001cce0: 2077 6520 6861 7665 2061 2070 726f 6772 we have a progr │ │ │ │ │ +0001ccf0: 616d 2063 616c 6c65 6420 2766 6f6f 2720 am called 'foo' │ │ │ │ │ +0001cd00: 7468 6174 2077 696c 6c20 7265 6164 206f that will read o │ │ │ │ │ +0001cd10: 6e65 2066 696c 6520 6361 6c6c 6564 0a27 ne file called.' │ │ │ │ │ +0001cd20: 6461 7461 2e66 6f6f 2720 616e 6420 7072 data.foo' and pr │ │ │ │ │ +0001cd30: 6f64 7563 6520 7477 6f20 6669 6c65 7320 oduce two files │ │ │ │ │ +0001cd40: 6e61 6d65 6420 2764 6174 612e 6327 2061 named 'data.c' a │ │ │ │ │ +0001cd50: 6e64 2027 6461 7461 2e68 272e 2020 5765 nd 'data.h'. We │ │ │ │ │ +0001cd60: 2077 616e 740a 746f 2077 7269 7465 2061 want.to write a │ │ │ │ │ +0001cd70: 2027 4d61 6b65 6669 6c65 2720 7275 6c65 'Makefile' rule │ │ │ │ │ +0001cd80: 2074 6861 7420 6361 7074 7572 6573 2074 that captures t │ │ │ │ │ +0001cd90: 6869 7320 6f6e 652d 746f 2d74 776f 2064 his one-to-two d │ │ │ │ │ +0001cda0: 6570 656e 6465 6e63 792e 0a0a 2020 2054 ependency... T │ │ │ │ │ +0001cdb0: 6865 206e 6169 7665 2072 756c 6520 6973 he naive rule is │ │ │ │ │ +0001cdc0: 2069 6e63 6f72 7265 6374 3a0a 0a20 2020 incorrect:.. │ │ │ │ │ +0001cdd0: 2020 2320 5468 6973 2069 7320 696e 636f # This is inco │ │ │ │ │ +0001cde0: 7272 6563 742e 0a20 2020 2020 6461 7461 rrect.. data │ │ │ │ │ +0001cdf0: 2e63 2064 6174 612e 683a 2064 6174 612e .c data.h: data. │ │ │ │ │ +0001ce00: 666f 6f0a 2020 2020 2020 2020 2020 2020 foo. │ │ │ │ │ +0001ce10: 2066 6f6f 2064 6174 612e 666f 6f0a 0a57 foo data.foo..W │ │ │ │ │ +0001ce20: 6861 7420 7468 6520 6162 6f76 6520 7275 hat the above ru │ │ │ │ │ +0001ce30: 6c65 2072 6561 6c6c 7920 7361 7973 2069 le really says i │ │ │ │ │ +0001ce40: 7320 7468 6174 2027 6461 7461 2e63 2720 s that 'data.c' │ │ │ │ │ +0001ce50: 616e 6420 2764 6174 612e 6827 2065 6163 and 'data.h' eac │ │ │ │ │ +0001ce60: 680a 6465 7065 6e64 206f 6e20 2764 6174 h.depend on 'dat │ │ │ │ │ +0001ce70: 612e 666f 6f27 2c20 616e 6420 6361 6e20 a.foo', and can │ │ │ │ │ +0001ce80: 6561 6368 2062 6520 6275 696c 7420 6279 each be built by │ │ │ │ │ +0001ce90: 2072 756e 6e69 6e67 2027 666f 6f20 6461 running 'foo da │ │ │ │ │ +0001cea0: 7461 2e66 6f6f 272e 0a49 6e20 6f74 6865 ta.foo'..In othe │ │ │ │ │ +0001ceb0: 7220 776f 7264 7320 6974 2069 7320 6571 r words it is eq │ │ │ │ │ +0001cec0: 7569 7661 6c65 6e74 2074 6f3a 0a0a 2020 uivalent to:.. │ │ │ │ │ +0001ced0: 2020 2023 2057 6520 646f 206e 6f74 2077 # We do not w │ │ │ │ │ +0001cee0: 616e 7420 7468 6973 2e0a 2020 2020 2064 ant this.. d │ │ │ │ │ +0001cef0: 6174 612e 633a 2064 6174 612e 666f 6f0a ata.c: data.foo. │ │ │ │ │ +0001cf00: 2020 2020 2020 2020 2020 2020 2066 6f6f foo │ │ │ │ │ +0001cf10: 2064 6174 612e 666f 6f0a 2020 2020 2064 data.foo. d │ │ │ │ │ +0001cf20: 6174 612e 683a 2064 6174 612e 666f 6f0a ata.h: data.foo. │ │ │ │ │ +0001cf30: 2020 2020 2020 2020 2020 2020 2066 6f6f foo │ │ │ │ │ +0001cf40: 2064 6174 612e 666f 6f0a 0a77 6869 6368 data.foo..which │ │ │ │ │ +0001cf50: 206d 6561 6e73 2074 6861 7420 2766 6f6f means that 'foo │ │ │ │ │ +0001cf60: 2720 6361 6e20 6265 2072 756e 2074 7769 ' can be run twi │ │ │ │ │ +0001cf70: 6365 2e20 2055 7375 616c 6c79 2069 7420 ce. Usually it │ │ │ │ │ +0001cf80: 7769 6c6c 206e 6f74 2062 6520 7275 6e0a will not be run. │ │ │ │ │ +0001cf90: 7477 6963 652c 2062 6563 6175 7365 2027 twice, because ' │ │ │ │ │ +0001cfa0: 6d61 6b65 2720 696d 706c 656d 656e 7461 make' implementa │ │ │ │ │ +0001cfb0: 7469 6f6e 7320 6172 6520 736d 6172 7420 tions are smart │ │ │ │ │ +0001cfc0: 656e 6f75 6768 2074 6f20 6368 6563 6b20 enough to check │ │ │ │ │ +0001cfd0: 666f 7220 7468 650a 6578 6973 7465 6e63 for the.existenc │ │ │ │ │ +0001cfe0: 6520 6f66 2074 6865 2073 6563 6f6e 6420 e of the second │ │ │ │ │ +0001cff0: 6669 6c65 2061 6674 6572 2074 6865 2066 file after the f │ │ │ │ │ +0001d000: 6972 7374 206f 6e65 2068 6173 2062 6565 irst one has bee │ │ │ │ │ +0001d010: 6e20 6275 696c 743b 2074 6865 790a 7769 n built; they.wi │ │ │ │ │ +0001d020: 6c6c 2074 6865 7265 666f 7265 2064 6574 ll therefore det │ │ │ │ │ +0001d030: 6563 7420 7468 6174 2069 7420 616c 7265 ect that it alre │ │ │ │ │ +0001d040: 6164 7920 6578 6973 7473 2e20 2048 6f77 ady exists. How │ │ │ │ │ +0001d050: 6576 6572 2074 6865 7265 2061 7265 2061 ever there are a │ │ │ │ │ +0001d060: 2066 6577 0a73 6974 7561 7469 6f6e 7320 few.situations │ │ │ │ │ +0001d070: 7768 6572 6520 6974 2063 616e 2072 756e where it can run │ │ │ │ │ +0001d080: 2074 7769 6365 2061 6e79 7761 793a 0a0a twice anyway:.. │ │ │ │ │ +0001d090: 2020 202a 2054 6865 206d 6f73 7420 776f * The most wo │ │ │ │ │ +0001d0a0: 7272 7969 6e67 2063 6173 6520 6973 2077 rrying case is w │ │ │ │ │ +0001d0b0: 6865 6e20 7275 6e6e 696e 6720 6120 7061 hen running a pa │ │ │ │ │ +0001d0c0: 7261 6c6c 656c 2027 6d61 6b65 272e 2020 rallel 'make'. │ │ │ │ │ +0001d0d0: 4966 0a20 2020 2020 2764 6174 612e 6327 If. 'data.c' │ │ │ │ │ +0001d0e0: 2061 6e64 2027 6461 7461 2e68 2720 6172 and 'data.h' ar │ │ │ │ │ +0001d0f0: 6520 6275 696c 7420 696e 2070 6172 616c e built in paral │ │ │ │ │ +0001d100: 6c65 6c2c 2074 776f 2027 666f 6f20 6461 lel, two 'foo da │ │ │ │ │ +0001d110: 7461 2e66 6f6f 270a 2020 2020 2063 6f6d ta.foo'. com │ │ │ │ │ +0001d120: 6d61 6e64 7320 7769 6c6c 2072 756e 2063 mands will run c │ │ │ │ │ +0001d130: 6f6e 6375 7272 656e 746c 792e 2020 5468 oncurrently. Th │ │ │ │ │ +0001d140: 6973 2069 7320 6861 726d 6675 6c2e 0a20 is is harmful.. │ │ │ │ │ +0001d150: 2020 2a20 416e 6f74 6865 7220 6361 7365 * Another case │ │ │ │ │ +0001d160: 2069 7320 7768 656e 2074 6865 2064 6570 is when the dep │ │ │ │ │ +0001d170: 656e 6465 6e63 7920 2868 6572 6520 2764 endency (here 'd │ │ │ │ │ +0001d180: 6174 612e 666f 6f27 2920 6973 2028 6f72 ata.foo') is (or │ │ │ │ │ +0001d190: 0a20 2020 2020 6465 7065 6e64 7320 7570 . depends up │ │ │ │ │ +0001d1a0: 6f6e 2920 6120 7068 6f6e 7920 7461 7267 on) a phony targ │ │ │ │ │ +0001d1b0: 6574 2e0a 0a20 2020 4120 736f 6c75 7469 et... A soluti │ │ │ │ │ +0001d1c0: 6f6e 2074 6861 7420 776f 726b 7320 7769 on that works wi │ │ │ │ │ +0001d1d0: 7468 2070 6172 616c 6c65 6c20 276d 616b th parallel 'mak │ │ │ │ │ +0001d1e0: 6527 2062 7574 206e 6f74 2077 6974 6820 e' but not with │ │ │ │ │ +0001d1f0: 7068 6f6e 790a 6465 7065 6e64 656e 6369 phony.dependenci │ │ │ │ │ +0001d200: 6573 2069 7320 7468 6520 666f 6c6c 6f77 es is the follow │ │ │ │ │ +0001d210: 696e 673a 0a0a 2020 2020 2064 6174 612e ing:.. data. │ │ │ │ │ +0001d220: 6320 6461 7461 2e68 3a20 6461 7461 2e66 c data.h: data.f │ │ │ │ │ +0001d230: 6f6f 0a20 2020 2020 2020 2020 2020 2020 oo. │ │ │ │ │ +0001d240: 666f 6f20 6461 7461 2e66 6f6f 0a20 2020 foo data.foo. │ │ │ │ │ +0001d250: 2020 6461 7461 2e68 3a20 6461 7461 2e63 data.h: data.c │ │ │ │ │ +0001d260: 0a0a 5468 6520 6162 6f76 6520 7275 6c65 ..The above rule │ │ │ │ │ +0001d270: 7320 6172 6520 6571 7569 7661 6c65 6e74 s are equivalent │ │ │ │ │ +0001d280: 2074 6f0a 0a20 2020 2020 6461 7461 2e63 to.. data.c │ │ │ │ │ +0001d290: 3a20 6461 7461 2e66 6f6f 0a20 2020 2020 : data.foo. │ │ │ │ │ +0001d2a0: 2020 2020 2020 2020 666f 6f20 6461 7461 foo data │ │ │ │ │ +0001d2b0: 2e66 6f6f 0a20 2020 2020 6461 7461 2e68 .foo. data.h │ │ │ │ │ +0001d2c0: 3a20 6461 7461 2e66 6f6f 2064 6174 612e : data.foo data. │ │ │ │ │ +0001d2d0: 630a 2020 2020 2020 2020 2020 2020 2066 c. f │ │ │ │ │ +0001d2e0: 6f6f 2064 6174 612e 666f 6f0a 0a74 6865 oo data.foo..the │ │ │ │ │ +0001d2f0: 7265 666f 7265 2061 2070 6172 616c 6c65 refore a paralle │ │ │ │ │ +0001d300: 6c20 276d 616b 6527 2077 696c 6c20 6861 l 'make' will ha │ │ │ │ │ +0001d310: 7665 2074 6f20 7365 7269 616c 697a 6520 ve to serialize │ │ │ │ │ +0001d320: 7468 6520 6275 696c 6473 206f 660a 2764 the builds of.'d │ │ │ │ │ +0001d330: 6174 612e 6327 2061 6e64 2027 6461 7461 ata.c' and 'data │ │ │ │ │ +0001d340: 2e68 272c 2061 6e64 2077 696c 6c20 6465 .h', and will de │ │ │ │ │ +0001d350: 7465 6374 2074 6861 7420 7468 6520 7365 tect that the se │ │ │ │ │ +0001d360: 636f 6e64 2069 7320 6e6f 206c 6f6e 6765 cond is no longe │ │ │ │ │ +0001d370: 720a 6e65 6564 6564 206f 6e63 6520 7468 r.needed once th │ │ │ │ │ +0001d380: 6520 6669 7273 7420 6973 206f 7665 722e e first is over. │ │ │ │ │ +0001d390: 0a0a 2020 2055 7369 6e67 2074 6869 7320 .. Using this │ │ │ │ │ +0001d3a0: 7061 7474 6572 6e20 6973 2070 726f 6261 pattern is proba │ │ │ │ │ +0001d3b0: 626c 7920 656e 6f75 6768 2066 6f72 206d bly enough for m │ │ │ │ │ +0001d3c0: 6f73 7420 6361 7365 732e 2020 486f 7765 ost cases. Howe │ │ │ │ │ +0001d3d0: 7665 7220 6974 0a64 6f65 7320 6e6f 7420 ver it.does not │ │ │ │ │ +0001d3e0: 7363 616c 6520 6561 7369 6c79 2074 6f20 scale easily to │ │ │ │ │ +0001d3f0: 6d6f 7265 206f 7574 7075 7420 6669 6c65 more output file │ │ │ │ │ +0001d400: 7320 2869 6e20 7468 6973 2073 6368 656d s (in this schem │ │ │ │ │ +0001d410: 6520 616c 6c20 6f75 7470 7574 0a66 696c e all output.fil │ │ │ │ │ +0001d420: 6573 206d 7573 7420 6265 2074 6f74 616c es must be total │ │ │ │ │ +0001d430: 6c79 206f 7264 6572 6564 2062 7920 7468 ly ordered by th │ │ │ │ │ +0001d440: 6520 6465 7065 6e64 656e 6379 2072 656c e dependency rel │ │ │ │ │ +0001d450: 6174 696f 6e29 2c20 736f 2077 6520 7769 ation), so we wi │ │ │ │ │ +0001d460: 6c6c 0a65 7870 6c6f 7265 2061 206d 6f72 ll.explore a mor │ │ │ │ │ +0001d470: 6520 636f 6d70 6c69 6361 7465 6420 736f e complicated so │ │ │ │ │ +0001d480: 6c75 7469 6f6e 2e0a 0a20 2020 416e 6f74 lution... Anot │ │ │ │ │ +0001d490: 6865 7220 6964 6561 2069 7320 746f 2077 her idea is to w │ │ │ │ │ +0001d4a0: 7269 7465 2074 6865 2066 6f6c 6c6f 7769 rite the followi │ │ │ │ │ +0001d4b0: 6e67 3a0a 0a20 2020 2020 2320 5468 6572 ng:.. # Ther │ │ │ │ │ +0001d4c0: 6520 6973 2073 7469 6c6c 2061 2070 726f e is still a pro │ │ │ │ │ +0001d4d0: 626c 656d 2077 6974 6820 7468 6973 206f blem with this o │ │ │ │ │ +0001d4e0: 6e65 2e0a 2020 2020 2064 6174 612e 633a ne.. data.c: │ │ │ │ │ +0001d4f0: 2064 6174 612e 666f 6f0a 2020 2020 2020 data.foo. │ │ │ │ │ +0001d500: 2020 2020 2020 2066 6f6f 2064 6174 612e foo data. │ │ │ │ │ +0001d510: 666f 6f0a 2020 2020 2064 6174 612e 683a foo. data.h: │ │ │ │ │ +0001d520: 2064 6174 612e 630a 0a54 6865 2069 6465 data.c..The ide │ │ │ │ │ +0001d530: 6120 6973 2074 6861 7420 2766 6f6f 2064 a is that 'foo d │ │ │ │ │ +0001d540: 6174 612e 666f 6f27 2069 7320 7275 6e20 ata.foo' is run │ │ │ │ │ +0001d550: 6f6e 6c79 2077 6865 6e20 2764 6174 612e only when 'data. │ │ │ │ │ +0001d560: 6327 206e 6565 6473 2074 6f20 6265 0a75 c' needs to be.u │ │ │ │ │ +0001d570: 7064 6174 6564 2c20 6275 7420 7765 2066 pdated, but we f │ │ │ │ │ +0001d580: 7572 7468 6572 2073 7461 7465 2074 6861 urther state tha │ │ │ │ │ +0001d590: 7420 2764 6174 612e 6827 2064 6570 656e t 'data.h' depen │ │ │ │ │ +0001d5a0: 6473 2075 706f 6e20 2764 6174 612e 6327 ds upon 'data.c' │ │ │ │ │ +0001d5b0: 2e20 2054 6861 740a 7761 792c 2069 6620 . That.way, if │ │ │ │ │ +0001d5c0: 2764 6174 612e 6827 2069 7320 7265 7175 'data.h' is requ │ │ │ │ │ +0001d5d0: 6972 6564 2061 6e64 2027 6461 7461 2e66 ired and 'data.f │ │ │ │ │ +0001d5e0: 6f6f 2720 6973 206f 7574 206f 6620 6461 oo' is out of da │ │ │ │ │ +0001d5f0: 7465 2c20 7468 650a 6465 7065 6e64 656e te, the.dependen │ │ │ │ │ +0001d600: 6379 206f 6e20 2764 6174 612e 6327 2077 cy on 'data.c' w │ │ │ │ │ +0001d610: 696c 6c20 7472 6967 6765 7220 7468 6520 ill trigger the │ │ │ │ │ +0001d620: 6275 696c 642e 0a0a 2020 2054 6869 7320 build... This │ │ │ │ │ +0001d630: 6973 2061 6c6d 6f73 7420 7065 7266 6563 is almost perfec │ │ │ │ │ +0001d640: 742c 2062 7574 2073 7570 706f 7365 2077 t, but suppose w │ │ │ │ │ +0001d650: 6520 6861 7665 2062 7569 6c74 2027 6461 e have built 'da │ │ │ │ │ +0001d660: 7461 2e68 2720 616e 640a 2764 6174 612e ta.h' and.'data. │ │ │ │ │ +0001d670: 6327 2c20 616e 6420 7468 656e 2077 6520 c', and then we │ │ │ │ │ +0001d680: 6572 6173 6520 2764 6174 612e 6827 2e20 erase 'data.h'. │ │ │ │ │ +0001d690: 2054 6865 6e2c 2072 756e 6e69 6e67 2027 Then, running ' │ │ │ │ │ +0001d6a0: 6d61 6b65 2064 6174 612e 6827 2077 696c make data.h' wil │ │ │ │ │ +0001d6b0: 6c0a 6e6f 7420 7265 6275 696c 6420 2764 l.not rebuild 'd │ │ │ │ │ +0001d6c0: 6174 612e 6827 2e20 2054 6865 2061 626f ata.h'. The abo │ │ │ │ │ +0001d6d0: 7665 2072 756c 6573 206a 7573 7420 7374 ve rules just st │ │ │ │ │ +0001d6e0: 6174 6520 7468 6174 2027 6461 7461 2e63 ate that 'data.c │ │ │ │ │ +0001d6f0: 2720 6d75 7374 2062 650a 7570 2d74 6f2d ' must be.up-to- │ │ │ │ │ +0001d700: 6461 7465 2077 6974 6820 7265 7370 6563 date with respec │ │ │ │ │ +0001d710: 7420 746f 2027 6461 7461 2e66 6f6f 272c t to 'data.foo', │ │ │ │ │ +0001d720: 2061 6e64 2074 6869 7320 6973 2061 6c72 and this is alr │ │ │ │ │ +0001d730: 6561 6479 2074 6865 2063 6173 652e 0a0a eady the case... │ │ │ │ │ +0001d740: 2020 2057 6861 7420 7765 206e 6565 6420 What we need │ │ │ │ │ +0001d750: 6973 2061 2072 756c 6520 7468 6174 2066 is a rule that f │ │ │ │ │ +0001d760: 6f72 6365 7320 6120 7265 6275 696c 6420 orces a rebuild │ │ │ │ │ +0001d770: 7768 656e 2027 6461 7461 2e68 2720 6973 when 'data.h' is │ │ │ │ │ +0001d780: 0a6d 6973 7369 6e67 2e20 2048 6572 6520 .missing. Here │ │ │ │ │ +0001d790: 6974 2069 733a 0a0a 2020 2020 2064 6174 it is:.. dat │ │ │ │ │ +0001d7a0: 612e 633a 2064 6174 612e 666f 6f0a 2020 a.c: data.foo. │ │ │ │ │ +0001d7b0: 2020 2020 2020 2020 2020 2066 6f6f 2064 foo d │ │ │ │ │ +0001d7c0: 6174 612e 666f 6f0a 2020 2020 2064 6174 ata.foo. dat │ │ │ │ │ +0001d7d0: 612e 683a 2064 6174 612e 630a 2020 2020 a.h: data.c. │ │ │ │ │ +0001d7e0: 2023 2320 5265 636f 7665 7220 6672 6f6d ## Recover from │ │ │ │ │ +0001d7f0: 2074 6865 2072 656d 6f76 616c 206f 6620 the removal of │ │ │ │ │ +0001d800: 2440 0a20 2020 2020 2020 2020 2020 2020 $@. │ │ │ │ │ +0001d810: 4069 6620 7465 7374 202d 6620 2440 3b20 @if test -f $@; │ │ │ │ │ +0001d820: 7468 656e 203a 3b20 656c 7365 205c 0a20 then :; else \. │ │ │ │ │ +0001d830: 2020 2020 2020 2020 2020 2020 2020 726d rm │ │ │ │ │ +0001d840: 202d 6620 6461 7461 2e63 3b20 5c0a 2020 -f data.c; \. │ │ │ │ │ +0001d850: 2020 2020 2020 2020 2020 2020 2024 284d $(M │ │ │ │ │ +0001d860: 414b 4529 2024 2841 4d5f 4d41 4b45 464c AKE) $(AM_MAKEFL │ │ │ │ │ +0001d870: 4147 5329 2064 6174 612e 633b 205c 0a20 AGS) data.c; \. │ │ │ │ │ +0001d880: 2020 2020 2020 2020 2020 2020 6669 0a0a fi.. │ │ │ │ │ +0001d890: 2020 2054 6865 2061 626f 7665 2073 6368 The above sch │ │ │ │ │ +0001d8a0: 656d 6520 6361 6e20 6265 2065 7874 656e eme can be exten │ │ │ │ │ +0001d8b0: 6465 6420 746f 2068 616e 646c 6520 6d6f ded to handle mo │ │ │ │ │ +0001d8c0: 7265 206f 7574 7075 7473 2061 6e64 206d re outputs and m │ │ │ │ │ +0001d8d0: 6f72 650a 696e 7075 7473 2e20 204f 6e65 ore.inputs. One │ │ │ │ │ +0001d8e0: 206f 6620 7468 6520 6f75 7470 7574 7320 of the outputs │ │ │ │ │ +0001d8f0: 6973 2073 656c 6563 7465 6420 746f 2073 is selected to s │ │ │ │ │ +0001d900: 6572 7665 2061 7320 6120 7769 746e 6573 erve as a witnes │ │ │ │ │ +0001d910: 7320 746f 2074 6865 0a73 7563 6365 7373 s to the.success │ │ │ │ │ +0001d920: 6675 6c20 636f 6d70 6c65 7469 6f6e 206f ful completion o │ │ │ │ │ +0001d930: 6620 7468 6520 636f 6d6d 616e 642c 2069 f the command, i │ │ │ │ │ +0001d940: 7420 6465 7065 6e64 7320 7570 6f6e 2061 t depends upon a │ │ │ │ │ +0001d950: 6c6c 2069 6e70 7574 732c 2061 6e64 0a61 ll inputs, and.a │ │ │ │ │ +0001d960: 6c6c 206f 7468 6572 206f 7574 7075 7473 ll other outputs │ │ │ │ │ +0001d970: 2064 6570 656e 6420 7570 6f6e 2069 742e depend upon it. │ │ │ │ │ +0001d980: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ +0001d990: 6966 2027 666f 6f27 2073 686f 756c 640a if 'foo' should. │ │ │ │ │ +0001d9a0: 6164 6469 7469 6f6e 616c 6c79 2072 6561 additionally rea │ │ │ │ │ +0001d9b0: 6420 2764 6174 612e 6261 7227 2061 6e64 d 'data.bar' and │ │ │ │ │ +0001d9c0: 2061 6c73 6f20 7072 6f64 7563 6520 2764 also produce 'd │ │ │ │ │ +0001d9d0: 6174 612e 7727 2061 6e64 2027 6461 7461 ata.w' and 'data │ │ │ │ │ +0001d9e0: 2e78 272c 2077 650a 776f 756c 6420 7772 .x', we.would wr │ │ │ │ │ +0001d9f0: 6974 653a 0a0a 2020 2020 2064 6174 612e ite:.. data. │ │ │ │ │ +0001da00: 633a 2064 6174 612e 666f 6f20 6461 7461 c: data.foo data │ │ │ │ │ +0001da10: 2e62 6172 0a20 2020 2020 2020 2020 2020 .bar. │ │ │ │ │ +0001da20: 2020 666f 6f20 6461 7461 2e66 6f6f 2064 foo data.foo d │ │ │ │ │ +0001da30: 6174 612e 6261 720a 2020 2020 2064 6174 ata.bar. dat │ │ │ │ │ +0001da40: 612e 6820 6461 7461 2e77 2064 6174 612e a.h data.w data. │ │ │ │ │ +0001da50: 783a 2064 6174 612e 630a 2020 2020 2023 x: data.c. # │ │ │ │ │ +0001da60: 2320 5265 636f 7665 7220 6672 6f6d 2074 # Recover from t │ │ │ │ │ +0001da70: 6865 2072 656d 6f76 616c 206f 6620 2440 he removal of $@ │ │ │ │ │ +0001da80: 0a20 2020 2020 2020 2020 2020 2020 4069 . @i │ │ │ │ │ +0001da90: 6620 7465 7374 202d 6620 2440 3b20 7468 f test -f $@; th │ │ │ │ │ +0001daa0: 656e 203a 3b20 656c 7365 205c 0a20 2020 en :; else \. │ │ │ │ │ +0001dab0: 2020 2020 2020 2020 2020 2020 726d 202d rm - │ │ │ │ │ +0001dac0: 6620 6461 7461 2e63 3b20 5c0a 2020 2020 f data.c; \. │ │ │ │ │ +0001dad0: 2020 2020 2020 2020 2020 2024 284d 414b $(MAK │ │ │ │ │ +0001dae0: 4529 2024 2841 4d5f 4d41 4b45 464c 4147 E) $(AM_MAKEFLAG │ │ │ │ │ +0001daf0: 5329 2064 6174 612e 633b 205c 0a20 2020 S) data.c; \. │ │ │ │ │ +0001db00: 2020 2020 2020 2020 2020 6669 0a0a 2020 fi.. │ │ │ │ │ +0001db10: 2048 6f77 6576 6572 2074 6865 7265 2061 However there a │ │ │ │ │ +0001db20: 7265 206e 6f77 2074 6872 6565 206d 696e re now three min │ │ │ │ │ +0001db30: 6f72 2070 726f 626c 656d 7320 696e 2074 or problems in t │ │ │ │ │ +0001db40: 6869 7320 7365 7475 702e 2020 4f6e 6520 his setup. One │ │ │ │ │ +0001db50: 6973 0a72 656c 6174 6564 2074 6f20 7468 is.related to th │ │ │ │ │ +0001db60: 6520 7469 6d65 7374 616d 7020 6f72 6465 e timestamp orde │ │ │ │ │ +0001db70: 7269 6e67 206f 6620 2764 6174 612e 6827 ring of 'data.h' │ │ │ │ │ +0001db80: 2c20 2764 6174 612e 7727 2c20 2764 6174 , 'data.w', 'dat │ │ │ │ │ +0001db90: 612e 7827 2c20 616e 640a 2764 6174 612e a.x', and.'data. │ │ │ │ │ +0001dba0: 6327 2e20 2041 6e6f 7468 6572 206f 6e65 c'. Another one │ │ │ │ │ +0001dbb0: 2069 7320 6120 7261 6365 2063 6f6e 6469 is a race condi │ │ │ │ │ +0001dbc0: 7469 6f6e 2069 6620 6120 7061 7261 6c6c tion if a parall │ │ │ │ │ +0001dbd0: 656c 2027 6d61 6b65 2720 6174 7465 6d70 el 'make' attemp │ │ │ │ │ +0001dbe0: 7473 0a74 6f20 7275 6e20 6d75 6c74 6970 ts.to run multip │ │ │ │ │ +0001dbf0: 6c65 2069 6e73 7461 6e63 6573 206f 6620 le instances of │ │ │ │ │ +0001dc00: 7468 6520 7265 636f 7665 7220 626c 6f63 the recover bloc │ │ │ │ │ +0001dc10: 6b20 6174 206f 6e63 652e 2020 4669 6e61 k at once. Fina │ │ │ │ │ +0001dc20: 6c6c 792c 2074 6865 0a72 6563 7572 7369 lly, the.recursi │ │ │ │ │ +0001dc30: 7665 2072 756c 6520 6272 6561 6b73 2027 ve rule breaks ' │ │ │ │ │ +0001dc40: 6d61 6b65 202d 6e27 2077 6865 6e20 7275 make -n' when ru │ │ │ │ │ +0001dc50: 6e20 7769 7468 2047 4e55 2027 6d61 6b65 n with GNU 'make │ │ │ │ │ +0001dc60: 2720 2861 7320 7765 6c6c 2061 730a 736f ' (as well as.so │ │ │ │ │ +0001dc70: 6d65 206f 7468 6572 2027 6d61 6b65 2720 me other 'make' │ │ │ │ │ +0001dc80: 696d 706c 656d 656e 7461 7469 6f6e 7329 implementations) │ │ │ │ │ +0001dc90: 2c20 6173 2069 7420 6d61 7920 7265 6d6f , as it may remo │ │ │ │ │ +0001dca0: 7665 2027 6461 7461 2e68 2720 6576 656e ve 'data.h' even │ │ │ │ │ +0001dcb0: 2077 6865 6e0a 6974 2073 686f 756c 6420 when.it should │ │ │ │ │ +0001dcc0: 6e6f 7420 282a 6e6f 7465 2048 6f77 2074 not (*note How t │ │ │ │ │ +0001dcd0: 6865 2027 4d41 4b45 2720 5661 7269 6162 he 'MAKE' Variab │ │ │ │ │ +0001dce0: 6c65 2057 6f72 6b73 3a20 286d 616b 6529 le Works: (make) │ │ │ │ │ +0001dcf0: 4d41 4b45 0a56 6172 6961 626c 652e 292e MAKE.Variable.). │ │ │ │ │ +0001dd00: 0a0a 2020 204c 6574 2075 7320 6465 616c .. Let us deal │ │ │ │ │ +0001dd10: 2077 6974 6820 7468 6520 6669 7273 7420 with the first │ │ │ │ │ +0001dd20: 7072 6f62 6c65 6d2e 2020 2766 6f6f 2720 problem. 'foo' │ │ │ │ │ +0001dd30: 6f75 7470 7574 7320 666f 7572 2066 696c outputs four fil │ │ │ │ │ +0001dd40: 6573 2c20 6275 7420 7765 0a64 6f20 6e6f es, but we.do no │ │ │ │ │ +0001dd50: 7420 6b6e 6f77 2069 6e20 7768 6963 6820 t know in which │ │ │ │ │ +0001dd60: 6f72 6465 7220 7468 6573 6520 6669 6c65 order these file │ │ │ │ │ +0001dd70: 7320 6172 6520 6372 6561 7465 642e 2020 s are created. │ │ │ │ │ +0001dd80: 5375 7070 6f73 6520 7468 6174 0a27 6461 Suppose that.'da │ │ │ │ │ +0001dd90: 7461 2e68 2720 6973 2063 7265 6174 6564 ta.h' is created │ │ │ │ │ +0001dda0: 2062 6566 6f72 6520 2764 6174 612e 6327 before 'data.c' │ │ │ │ │ +0001ddb0: 2e20 2054 6865 6e20 7765 2068 6176 6520 . Then we have │ │ │ │ │ +0001ddc0: 6120 7765 6972 6420 7369 7475 6174 696f a weird situatio │ │ │ │ │ +0001ddd0: 6e2e 0a54 6865 206e 6578 7420 7469 6d65 n..The next time │ │ │ │ │ +0001dde0: 2027 6d61 6b65 2720 6973 2072 756e 2c20 'make' is run, │ │ │ │ │ +0001ddf0: 2764 6174 612e 6827 2077 696c 6c20 6170 'data.h' will ap │ │ │ │ │ +0001de00: 7065 6172 206f 6c64 6572 2074 6861 6e20 pear older than │ │ │ │ │ +0001de10: 2764 6174 612e 6327 2c0a 7468 6520 7365 'data.c',.the se │ │ │ │ │ +0001de20: 636f 6e64 2072 756c 6520 7769 6c6c 2062 cond rule will b │ │ │ │ │ +0001de30: 6520 7472 6967 6765 7265 642c 2061 2073 e triggered, a s │ │ │ │ │ +0001de40: 6865 6c6c 2077 696c 6c20 6265 2073 7461 hell will be sta │ │ │ │ │ +0001de50: 7274 6564 2074 6f20 6578 6563 7574 650a rted to execute. │ │ │ │ │ +0001de60: 7468 6520 2769 662e 2e2e 6669 2720 636f the 'if...fi' co │ │ │ │ │ +0001de70: 6d6d 616e 642c 2062 7574 2061 6374 7561 mmand, but actua │ │ │ │ │ +0001de80: 6c6c 7920 6974 2077 696c 6c20 6a75 7374 lly it will just │ │ │ │ │ +0001de90: 2065 7865 6375 7465 2074 6865 2027 7468 execute the 'th │ │ │ │ │ +0001dea0: 656e 270a 6272 616e 6368 2c20 7468 6174 en'.branch, that │ │ │ │ │ +0001deb0: 2069 733a 206e 6f74 6869 6e67 2e20 2049 is: nothing. I │ │ │ │ │ +0001dec0: 6e20 6f74 6865 7220 776f 7264 732c 2062 n other words, b │ │ │ │ │ +0001ded0: 6563 6175 7365 2074 6865 2077 6974 6e65 ecause the witne │ │ │ │ │ +0001dee0: 7373 2077 650a 7365 6c65 6374 6564 2069 ss we.selected i │ │ │ │ │ +0001def0: 7320 6e6f 7420 7468 6520 6669 7273 7420 s not the first │ │ │ │ │ +0001df00: 6669 6c65 2063 7265 6174 6564 2062 7920 file created by │ │ │ │ │ +0001df10: 2766 6f6f 272c 2027 6d61 6b65 2720 7769 'foo', 'make' wi │ │ │ │ │ +0001df20: 6c6c 2073 7461 7274 2061 0a73 6865 6c6c ll start a.shell │ │ │ │ │ +0001df30: 2074 6f20 646f 206e 6f74 6869 6e67 2065 to do nothing e │ │ │ │ │ +0001df40: 6163 6820 7469 6d65 2069 7420 6973 2072 ach time it is r │ │ │ │ │ +0001df50: 756e 2e0a 0a20 2020 4120 7369 6d70 6c65 un... A simple │ │ │ │ │ +0001df60: 2072 6970 6f73 7465 2069 7320 746f 2066 riposte is to f │ │ │ │ │ +0001df70: 6978 2074 6865 2074 696d 6573 7461 6d70 ix the timestamp │ │ │ │ │ +0001df80: 7320 7768 656e 2074 6869 7320 6861 7070 s when this happ │ │ │ │ │ +0001df90: 656e 732e 0a0a 2020 2020 2064 6174 612e ens... data. │ │ │ │ │ +0001dfa0: 633a 2064 6174 612e 666f 6f20 6461 7461 c: data.foo data │ │ │ │ │ +0001dfb0: 2e62 6172 0a20 2020 2020 2020 2020 2020 .bar. │ │ │ │ │ +0001dfc0: 2020 666f 6f20 6461 7461 2e66 6f6f 2064 foo data.foo d │ │ │ │ │ +0001dfd0: 6174 612e 6261 720a 2020 2020 2064 6174 ata.bar. dat │ │ │ │ │ +0001dfe0: 612e 6820 6461 7461 2e77 2064 6174 612e a.h data.w data. │ │ │ │ │ +0001dff0: 783a 2064 6174 612e 630a 2020 2020 2020 x: data.c. │ │ │ │ │ +0001e000: 2020 2020 2020 2040 6966 2074 6573 7420 @if test │ │ │ │ │ +0001e010: 2d66 2024 403b 2074 6865 6e20 5c0a 2020 -f $@; then \. │ │ │ │ │ +0001e020: 2020 2020 2020 2020 2020 2020 2074 6f75 tou │ │ │ │ │ +0001e030: 6368 2024 403b 205c 0a20 2020 2020 2020 ch $@; \. │ │ │ │ │ +0001e040: 2020 2020 2020 656c 7365 205c 0a20 2020 else \. │ │ │ │ │ +0001e050: 2020 2323 2052 6563 6f76 6572 2066 726f ## Recover fro │ │ │ │ │ +0001e060: 6d20 7468 6520 7265 6d6f 7661 6c20 6f66 m the removal of │ │ │ │ │ +0001e070: 2024 400a 2020 2020 2020 2020 2020 2020 $@. │ │ │ │ │ +0001e080: 2020 2072 6d20 2d66 2064 6174 612e 633b rm -f data.c; │ │ │ │ │ +0001e090: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0001e0a0: 2020 2428 4d41 4b45 2920 2428 414d 5f4d $(MAKE) $(AM_M │ │ │ │ │ +0001e0b0: 414b 4546 4c41 4753 2920 6461 7461 2e63 AKEFLAGS) data.c │ │ │ │ │ +0001e0c0: 3b20 5c0a 2020 2020 2020 2020 2020 2020 ; \. │ │ │ │ │ +0001e0d0: 2066 690a 0a20 2020 416e 6f74 6865 7220 fi.. Another │ │ │ │ │ +0001e0e0: 736f 6c75 7469 6f6e 2069 7320 746f 2075 solution is to u │ │ │ │ │ +0001e0f0: 7365 2061 2064 6966 6665 7265 6e74 2061 se a different a │ │ │ │ │ +0001e100: 6e64 2064 6564 6963 6174 6564 2066 696c nd dedicated fil │ │ │ │ │ +0001e110: 6520 6173 2077 6974 6e65 7373 2c0a 7261 e as witness,.ra │ │ │ │ │ +0001e120: 7468 6572 2074 6861 6e20 7573 696e 6720 ther than using │ │ │ │ │ +0001e130: 616e 7920 6f66 2027 666f 6f27 2773 206f any of 'foo''s o │ │ │ │ │ +0001e140: 7574 7075 7473 2e0a 0a20 2020 2020 6461 utputs... da │ │ │ │ │ +0001e150: 7461 2e73 7461 6d70 3a20 6461 7461 2e66 ta.stamp: data.f │ │ │ │ │ +0001e160: 6f6f 2064 6174 612e 6261 720a 2020 2020 oo data.bar. │ │ │ │ │ +0001e170: 2020 2020 2020 2020 2040 726d 202d 6620 @rm -f │ │ │ │ │ +0001e180: 6461 7461 2e74 6d70 0a20 2020 2020 2020 data.tmp. │ │ │ │ │ +0001e190: 2020 2020 2020 4074 6f75 6368 2064 6174 @touch dat │ │ │ │ │ +0001e1a0: 612e 746d 700a 2020 2020 2020 2020 2020 a.tmp. │ │ │ │ │ +0001e1b0: 2020 2066 6f6f 2064 6174 612e 666f 6f20 foo data.foo │ │ │ │ │ +0001e1c0: 6461 7461 2e62 6172 0a20 2020 2020 2020 data.bar. │ │ │ │ │ +0001e1d0: 2020 2020 2020 406d 7620 2d66 2064 6174 @mv -f dat │ │ │ │ │ +0001e1e0: 612e 746d 7020 2440 0a20 2020 2020 6461 a.tmp $@. da │ │ │ │ │ +0001e1f0: 7461 2e63 2064 6174 612e 6820 6461 7461 ta.c data.h data │ │ │ │ │ +0001e200: 2e77 2064 6174 612e 783a 2064 6174 612e .w data.x: data. │ │ │ │ │ +0001e210: 7374 616d 700a 2020 2020 2023 2320 5265 stamp. ## Re │ │ │ │ │ +0001e220: 636f 7665 7220 6672 6f6d 2074 6865 2072 cover from the r │ │ │ │ │ +0001e230: 656d 6f76 616c 206f 6620 2440 0a20 2020 emoval of $@. │ │ │ │ │ +0001e240: 2020 2020 2020 2020 2020 4069 6620 7465 @if te │ │ │ │ │ +0001e250: 7374 202d 6620 2440 3b20 7468 656e 203a st -f $@; then : │ │ │ │ │ +0001e260: 3b20 656c 7365 205c 0a20 2020 2020 2020 ; else \. │ │ │ │ │ +0001e270: 2020 2020 2020 2020 726d 202d 6620 6461 rm -f da │ │ │ │ │ +0001e280: 7461 2e73 7461 6d70 3b20 5c0a 2020 2020 ta.stamp; \. │ │ │ │ │ +0001e290: 2020 2020 2020 2020 2020 2024 284d 414b $(MAK │ │ │ │ │ +0001e2a0: 4529 2024 2841 4d5f 4d41 4b45 464c 4147 E) $(AM_MAKEFLAG │ │ │ │ │ +0001e2b0: 5329 2064 6174 612e 7374 616d 703b 205c S) data.stamp; \ │ │ │ │ │ +0001e2c0: 0a20 2020 2020 2020 2020 2020 2020 6669 . fi │ │ │ │ │ +0001e2d0: 0a0a 2020 2027 6461 7461 2e74 6d70 2720 .. 'data.tmp' │ │ │ │ │ +0001e2e0: 6973 2063 7265 6174 6564 2062 6566 6f72 is created befor │ │ │ │ │ +0001e2f0: 6520 2766 6f6f 2720 6973 2072 756e 2c20 e 'foo' is run, │ │ │ │ │ +0001e300: 736f 2069 7420 6861 7320 6120 7469 6d65 so it has a time │ │ │ │ │ +0001e310: 7374 616d 700a 6f6c 6465 7220 7468 616e stamp.older than │ │ │ │ │ +0001e320: 206f 7574 7075 7420 6669 6c65 7320 6f75 output files ou │ │ │ │ │ +0001e330: 7470 7574 2062 7920 2766 6f6f 272e 2020 tput by 'foo'. │ │ │ │ │ +0001e340: 4974 2069 7320 7468 656e 2072 656e 616d It is then renam │ │ │ │ │ +0001e350: 6564 2074 6f0a 2764 6174 612e 7374 616d ed to.'data.stam │ │ │ │ │ +0001e360: 7027 2061 6674 6572 2027 666f 6f27 2068 p' after 'foo' h │ │ │ │ │ +0001e370: 6173 2072 756e 2c20 6265 6361 7573 6520 as run, because │ │ │ │ │ +0001e380: 7765 2064 6f20 6e6f 7420 7761 6e74 2074 we do not want t │ │ │ │ │ +0001e390: 6f20 7570 6461 7465 0a27 6461 7461 2e73 o update.'data.s │ │ │ │ │ +0001e3a0: 7461 6d70 2720 6966 2027 666f 6f27 2066 tamp' if 'foo' f │ │ │ │ │ +0001e3b0: 6169 6c73 2e0a 0a20 2020 5468 6973 2073 ails... This s │ │ │ │ │ +0001e3c0: 6f6c 7574 696f 6e20 7374 696c 6c20 7375 olution still su │ │ │ │ │ +0001e3d0: 6666 6572 7320 6672 6f6d 2074 6865 2073 ffers from the s │ │ │ │ │ +0001e3e0: 6563 6f6e 6420 7072 6f62 6c65 6d3a 2074 econd problem: t │ │ │ │ │ +0001e3f0: 6865 2072 6163 650a 636f 6e64 6974 696f he race.conditio │ │ │ │ │ +0001e400: 6e20 696e 2074 6865 2072 6563 6f76 6572 n in the recover │ │ │ │ │ +0001e410: 2072 756c 652e 2020 4966 2c20 6166 7465 rule. If, afte │ │ │ │ │ +0001e420: 7220 6120 7375 6363 6573 7366 756c 2062 r a successful b │ │ │ │ │ +0001e430: 7569 6c64 2c20 6120 7573 6572 0a65 7261 uild, a user.era │ │ │ │ │ +0001e440: 7365 7320 2764 6174 612e 6327 2061 6e64 ses 'data.c' and │ │ │ │ │ +0001e450: 2027 6461 7461 2e68 272c 2061 6e64 2072 'data.h', and r │ │ │ │ │ +0001e460: 756e 7320 276d 616b 6520 2d6a 272c 2074 uns 'make -j', t │ │ │ │ │ +0001e470: 6865 6e20 276d 616b 6527 206d 6179 2073 hen 'make' may s │ │ │ │ │ +0001e480: 7461 7274 0a62 6f74 6820 7265 636f 7665 tart.both recove │ │ │ │ │ +0001e490: 7220 7275 6c65 7320 696e 2070 6172 616c r rules in paral │ │ │ │ │ +0001e4a0: 6c65 6c2e 2020 4966 2074 6865 2074 776f lel. If the two │ │ │ │ │ +0001e4b0: 2069 6e73 7461 6e63 6573 206f 6620 7468 instances of th │ │ │ │ │ +0001e4c0: 6520 7275 6c65 0a65 7865 6375 7465 2027 e rule.execute ' │ │ │ │ │ +0001e4d0: 2428 4d41 4b45 2920 2428 414d 5f4d 414b $(MAKE) $(AM_MAK │ │ │ │ │ +0001e4e0: 4546 4c41 4753 2920 6461 7461 2e73 7461 EFLAGS) data.sta │ │ │ │ │ +0001e4f0: 6d70 2720 636f 6e63 7572 7265 6e74 6c79 mp' concurrently │ │ │ │ │ +0001e500: 2074 6865 2062 7569 6c64 2069 730a 6c69 the build is.li │ │ │ │ │ +0001e510: 6b65 6c79 2074 6f20 6661 696c 2028 666f kely to fail (fo │ │ │ │ │ +0001e520: 7220 696e 7374 616e 6365 2c20 7468 6520 r instance, the │ │ │ │ │ +0001e530: 7477 6f20 7275 6c65 7320 7769 6c6c 2063 two rules will c │ │ │ │ │ +0001e540: 7265 6174 6520 2764 6174 612e 746d 7027 reate 'data.tmp' │ │ │ │ │ +0001e550: 2c20 6275 740a 6f6e 6c79 206f 6e65 2063 , but.only one c │ │ │ │ │ +0001e560: 616e 2072 656e 616d 6520 6974 292e 0a0a an rename it)... │ │ │ │ │ +0001e570: 2020 2041 646d 6974 7465 646c 792c 2073 Admittedly, s │ │ │ │ │ +0001e580: 7563 6820 6120 7765 6972 6420 7369 7475 uch a weird situ │ │ │ │ │ +0001e590: 6174 696f 6e20 646f 6573 206e 6f74 2061 ation does not a │ │ │ │ │ +0001e5a0: 7269 7365 2064 7572 696e 6720 6f72 6469 rise during ordi │ │ │ │ │ +0001e5b0: 6e61 7279 0a62 7569 6c64 732e 2020 4974 nary.builds. It │ │ │ │ │ +0001e5c0: 206f 6363 7572 7320 6f6e 6c79 2077 6865 occurs only whe │ │ │ │ │ +0001e5d0: 6e20 7468 6520 6275 696c 6420 7472 6565 n the build tree │ │ │ │ │ +0001e5e0: 2069 7320 6d75 7469 6c61 7465 642e 2020 is mutilated. │ │ │ │ │ +0001e5f0: 4865 7265 2027 6461 7461 2e63 270a 616e Here 'data.c'.an │ │ │ │ │ +0001e600: 6420 2764 6174 612e 6827 2068 6176 6520 d 'data.h' have │ │ │ │ │ +0001e610: 6265 656e 2065 7870 6c69 6369 746c 7920 been explicitly │ │ │ │ │ +0001e620: 7265 6d6f 7665 6420 7769 7468 6f75 7420 removed without │ │ │ │ │ +0001e630: 616c 736f 2072 656d 6f76 696e 670a 2764 also removing.'d │ │ │ │ │ +0001e640: 6174 612e 7374 616d 7027 2061 6e64 2074 ata.stamp' and t │ │ │ │ │ +0001e650: 6865 206f 7468 6572 206f 7574 7075 7420 he other output │ │ │ │ │ +0001e660: 6669 6c65 732e 2020 276d 616b 6520 636c files. 'make cl │ │ │ │ │ +0001e670: 6561 6e3b 206d 616b 6527 2077 696c 6c20 ean; make' will │ │ │ │ │ +0001e680: 616c 7761 7973 0a72 6563 6f76 6572 2066 always.recover f │ │ │ │ │ +0001e690: 726f 6d20 7468 6573 6520 7369 7475 6174 rom these situat │ │ │ │ │ +0001e6a0: 696f 6e73 2065 7665 6e20 7769 7468 2070 ions even with p │ │ │ │ │ +0001e6b0: 6172 616c 6c65 6c20 6d61 6b65 732c 2073 arallel makes, s │ │ │ │ │ +0001e6c0: 6f20 796f 7520 6d61 790a 6465 6369 6465 o you may.decide │ │ │ │ │ +0001e6d0: 2074 6861 7420 7468 6520 7265 636f 7665 that the recove │ │ │ │ │ +0001e6e0: 7220 7275 6c65 2069 7320 736f 6c65 6c79 r rule is solely │ │ │ │ │ +0001e6f0: 2074 6f20 6865 6c70 206e 6f6e 2d70 6172 to help non-par │ │ │ │ │ +0001e700: 616c 6c65 6c20 6d61 6b65 2075 7365 7273 allel make users │ │ │ │ │ +0001e710: 0a61 6e64 206c 6561 7665 2074 6869 6e67 .and leave thing │ │ │ │ │ +0001e720: 7320 6173 2d69 732e 2020 4669 7869 6e67 s as-is. Fixing │ │ │ │ │ +0001e730: 2074 6869 7320 7265 7175 6972 6573 2073 this requires s │ │ │ │ │ +0001e740: 6f6d 6520 6c6f 636b 696e 6720 6d65 6368 ome locking mech │ │ │ │ │ +0001e750: 616e 6973 6d20 746f 0a65 6e73 7572 6520 anism to.ensure │ │ │ │ │ +0001e760: 6f6e 6c79 206f 6e65 2069 6e73 7461 6e63 only one instanc │ │ │ │ │ +0001e770: 6520 6f66 2074 6865 2072 6563 6f76 6572 e of the recover │ │ │ │ │ +0001e780: 2072 756c 6520 7265 6275 696c 6473 2027 rule rebuilds ' │ │ │ │ │ +0001e790: 6461 7461 2e73 7461 6d70 272e 2020 4f6e data.stamp'. On │ │ │ │ │ +0001e7a0: 650a 636f 756c 6420 696d 6167 696e 6520 e.could imagine │ │ │ │ │ +0001e7b0: 736f 6d65 7468 696e 6720 616c 6f6e 6720 something along │ │ │ │ │ +0001e7c0: 7468 6520 666f 6c6c 6f77 696e 6720 6c69 the following li │ │ │ │ │ +0001e7d0: 6e65 732e 0a0a 2020 2020 2064 6174 612e nes... data. │ │ │ │ │ +0001e7e0: 6320 6461 7461 2e68 2064 6174 612e 7720 c data.h data.w │ │ │ │ │ +0001e7f0: 6461 7461 2e78 3a20 6461 7461 2e73 7461 data.x: data.sta │ │ │ │ │ +0001e800: 6d70 0a20 2020 2020 2323 2052 6563 6f76 mp. ## Recov │ │ │ │ │ +0001e810: 6572 2066 726f 6d20 7468 6520 7265 6d6f er from the remo │ │ │ │ │ +0001e820: 7661 6c20 6f66 2024 400a 2020 2020 2020 val of $@. │ │ │ │ │ +0001e830: 2020 2020 2020 2040 6966 2074 6573 7420 @if test │ │ │ │ │ +0001e840: 2d66 2024 403b 2074 6865 6e20 3a3b 2065 -f $@; then :; e │ │ │ │ │ +0001e850: 6c73 6520 5c0a 2020 2020 2020 2020 2020 lse \. │ │ │ │ │ +0001e860: 2020 2020 2074 7261 7020 2772 6d20 2d72 trap 'rm -r │ │ │ │ │ +0001e870: 6620 6461 7461 2e6c 6f63 6b20 6461 7461 f data.lock data │ │ │ │ │ +0001e880: 2e73 7461 6d70 2720 3120 3220 3133 2031 .stamp' 1 2 13 1 │ │ │ │ │ +0001e890: 353b 205c 0a20 2020 2020 2323 206d 6b64 5; \. ## mkd │ │ │ │ │ +0001e8a0: 6972 2069 7320 6120 706f 7274 6162 6c65 ir is a portable │ │ │ │ │ +0001e8b0: 2074 6573 742d 616e 642d 7365 740a 2020 test-and-set. │ │ │ │ │ +0001e8c0: 2020 2020 2020 2020 2020 2020 2069 6620 if │ │ │ │ │ +0001e8d0: 6d6b 6469 7220 6461 7461 2e6c 6f63 6b20 mkdir data.lock │ │ │ │ │ +0001e8e0: 323e 2f64 6576 2f6e 756c 6c3b 2074 6865 2>/dev/null; the │ │ │ │ │ +0001e8f0: 6e20 5c0a 2020 2020 2023 2320 5468 6973 n \. ## This │ │ │ │ │ +0001e900: 2063 6f64 6520 6973 2062 6569 6e67 2065 code is being e │ │ │ │ │ +0001e910: 7865 6375 7465 6420 6279 2074 6865 2066 xecuted by the f │ │ │ │ │ +0001e920: 6972 7374 2070 726f 6365 7373 2e0a 2020 irst process.. │ │ │ │ │ +0001e930: 2020 2020 2020 2020 2020 2020 2020 2072 r │ │ │ │ │ +0001e940: 6d20 2d66 2064 6174 612e 7374 616d 703b m -f data.stamp; │ │ │ │ │ +0001e950: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0001e960: 2020 2020 2428 4d41 4b45 2920 2428 414d $(MAKE) $(AM │ │ │ │ │ +0001e970: 5f4d 414b 4546 4c41 4753 2920 6461 7461 _MAKEFLAGS) data │ │ │ │ │ +0001e980: 2e73 7461 6d70 3b20 5c0a 2020 2020 2020 .stamp; \. │ │ │ │ │ +0001e990: 2020 2020 2020 2020 2020 2072 6573 756c resul │ │ │ │ │ +0001e9a0: 743d 2424 3f3b 2072 6d20 2d72 6620 6461 t=$$?; rm -rf da │ │ │ │ │ +0001e9b0: 7461 2e6c 6f63 6b3b 2065 7869 7420 2424 ta.lock; exit $$ │ │ │ │ │ +0001e9c0: 7265 7375 6c74 3b20 5c0a 2020 2020 2020 result; \. │ │ │ │ │ +0001e9d0: 2020 2020 2020 2020 2065 6c73 6520 5c0a else \. │ │ │ │ │ +0001e9e0: 2020 2020 2023 2320 5468 6973 2063 6f64 ## This cod │ │ │ │ │ +0001e9f0: 6520 6973 2062 6569 6e67 2065 7865 6375 e is being execu │ │ │ │ │ +0001ea00: 7465 6420 6279 2074 6865 2066 6f6c 6c6f ted by the follo │ │ │ │ │ +0001ea10: 7765 7220 7072 6f63 6573 7365 732e 0a20 wer processes.. │ │ │ │ │ +0001ea20: 2020 2020 2323 2057 6169 7420 756e 7469 ## Wait unti │ │ │ │ │ +0001ea30: 6c20 7468 6520 6669 7273 7420 7072 6f63 l the first proc │ │ │ │ │ +0001ea40: 6573 7320 6973 2064 6f6e 652e 0a20 2020 ess is done.. │ │ │ │ │ +0001ea50: 2020 2020 2020 2020 2020 2020 2020 7768 wh │ │ │ │ │ +0001ea60: 696c 6520 7465 7374 202d 6420 6461 7461 ile test -d data │ │ │ │ │ +0001ea70: 2e6c 6f63 6b3b 2064 6f20 736c 6565 7020 .lock; do sleep │ │ │ │ │ +0001ea80: 313b 2064 6f6e 653b 205c 0a20 2020 2020 1; done; \. │ │ │ │ │ +0001ea90: 2323 2053 7563 6365 6564 2069 6620 616e ## Succeed if an │ │ │ │ │ +0001eaa0: 6420 6f6e 6c79 2069 6620 7468 6520 6669 d only if the fi │ │ │ │ │ +0001eab0: 7273 7420 7072 6f63 6573 7320 7375 6363 rst process succ │ │ │ │ │ +0001eac0: 6565 6465 642e 0a20 2020 2020 2020 2020 eeded.. │ │ │ │ │ +0001ead0: 2020 2020 2020 2020 7465 7374 202d 6620 test -f │ │ │ │ │ +0001eae0: 6461 7461 2e73 7461 6d70 3b20 5c0a 2020 data.stamp; \. │ │ │ │ │ +0001eaf0: 2020 2020 2020 2020 2020 2020 2066 693b fi; │ │ │ │ │ +0001eb00: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0001eb10: 6669 0a0a 2020 2055 7369 6e67 2061 2064 fi.. Using a d │ │ │ │ │ +0001eb20: 6564 6963 6174 6564 2077 6974 6e65 7373 edicated witness │ │ │ │ │ +0001eb30: 2c20 6c69 6b65 2027 6461 7461 2e73 7461 , like 'data.sta │ │ │ │ │ +0001eb40: 6d70 272c 2069 7320 7665 7279 2068 616e mp', is very han │ │ │ │ │ +0001eb50: 6479 2077 6865 6e20 7468 650a 6c69 7374 dy when the.list │ │ │ │ │ +0001eb60: 206f 6620 6f75 7470 7574 2066 696c 6573 of output files │ │ │ │ │ +0001eb70: 2069 7320 6e6f 7420 6b6e 6f77 6e20 6265 is not known be │ │ │ │ │ +0001eb80: 666f 7265 6861 6e64 2e20 2041 7320 616e forehand. As an │ │ │ │ │ +0001eb90: 2069 6c6c 7573 7472 6174 696f 6e2c 0a63 illustration,.c │ │ │ │ │ +0001eba0: 6f6e 7369 6465 7220 7468 6520 666f 6c6c onsider the foll │ │ │ │ │ +0001ebb0: 6f77 696e 6720 7275 6c65 7320 746f 2063 owing rules to c │ │ │ │ │ +0001ebc0: 6f6d 7069 6c65 206d 616e 7920 272a 2e65 ompile many '*.e │ │ │ │ │ +0001ebd0: 6c27 2066 696c 6573 2069 6e74 6f20 272a l' files into '* │ │ │ │ │ +0001ebe0: 2e65 6c63 270a 6669 6c65 7320 696e 2061 .elc'.files in a │ │ │ │ │ +0001ebf0: 2073 696e 676c 6520 636f 6d6d 616e 642e single command. │ │ │ │ │ +0001ec00: 2020 4974 2064 6f65 7320 6e6f 7420 6d61 It does not ma │ │ │ │ │ +0001ec10: 7474 6572 2068 6f77 2027 454c 4649 4c45 tter how 'ELFILE │ │ │ │ │ +0001ec20: 5327 2069 7320 6465 6669 6e65 640a 2861 S' is defined.(a │ │ │ │ │ +0001ec30: 7320 6c6f 6e67 2061 7320 6974 2069 7320 s long as it is │ │ │ │ │ +0001ec40: 6e6f 7420 656d 7074 793a 2065 6d70 7479 not empty: empty │ │ │ │ │ +0001ec50: 2074 6172 6765 7473 2061 7265 206e 6f74 targets are not │ │ │ │ │ +0001ec60: 2061 6363 6570 7465 6420 6279 2050 4f53 accepted by POS │ │ │ │ │ +0001ec70: 4958 292e 0a0a 2020 2020 2045 4c46 494c IX)... ELFIL │ │ │ │ │ +0001ec80: 4553 203d 206f 6e65 2e65 6c20 7477 6f2e ES = one.el two. │ │ │ │ │ +0001ec90: 656c 2074 6872 6565 2e65 6c20 2e2e 2e0a el three.el .... │ │ │ │ │ +0001eca0: 2020 2020 2045 4c43 4649 4c45 5320 3d20 ELCFILES = │ │ │ │ │ +0001ecb0: 2428 454c 4649 4c45 533a 3d63 290a 0a20 $(ELFILES:=c).. │ │ │ │ │ +0001ecc0: 2020 2020 656c 632d 7374 616d 703a 2024 elc-stamp: $ │ │ │ │ │ +0001ecd0: 2845 4c46 494c 4553 290a 2020 2020 2020 (ELFILES). │ │ │ │ │ +0001ece0: 2020 2020 2020 2040 726d 202d 6620 656c @rm -f el │ │ │ │ │ +0001ecf0: 632d 7465 6d70 0a20 2020 2020 2020 2020 c-temp. │ │ │ │ │ +0001ed00: 2020 2020 4074 6f75 6368 2065 6c63 2d74 @touch elc-t │ │ │ │ │ +0001ed10: 656d 700a 2020 2020 2020 2020 2020 2020 emp. │ │ │ │ │ +0001ed20: 2024 2865 6c69 7370 5f63 6f6d 7029 2024 $(elisp_comp) $ │ │ │ │ │ +0001ed30: 2845 4c46 494c 4553 290a 2020 2020 2020 (ELFILES). │ │ │ │ │ +0001ed40: 2020 2020 2020 2040 6d76 202d 6620 656c @mv -f el │ │ │ │ │ +0001ed50: 632d 7465 6d70 2024 400a 0a20 2020 2020 c-temp $@.. │ │ │ │ │ +0001ed60: 2428 454c 4346 494c 4553 293a 2065 6c63 $(ELCFILES): elc │ │ │ │ │ +0001ed70: 2d73 7461 6d70 0a20 2020 2020 2020 2020 -stamp. │ │ │ │ │ +0001ed80: 2020 2020 4069 6620 7465 7374 202d 6620 @if test -f │ │ │ │ │ +0001ed90: 2440 3b20 7468 656e 203a 3b20 656c 7365 $@; then :; else │ │ │ │ │ +0001eda0: 205c 0a20 2020 2020 2323 2052 6563 6f76 \. ## Recov │ │ │ │ │ +0001edb0: 6572 2066 726f 6d20 7468 6520 7265 6d6f er from the remo │ │ │ │ │ +0001edc0: 7661 6c20 6f66 2024 400a 2020 2020 2020 val of $@. │ │ │ │ │ +0001edd0: 2020 2020 2020 2020 2074 7261 7020 2772 trap 'r │ │ │ │ │ +0001ede0: 6d20 2d72 6620 656c 632d 6c6f 636b 2065 m -rf elc-lock e │ │ │ │ │ +0001edf0: 6c63 2d73 7461 6d70 2720 3120 3220 3133 lc-stamp' 1 2 13 │ │ │ │ │ +0001ee00: 2031 353b 205c 0a20 2020 2020 2020 2020 15; \. │ │ │ │ │ +0001ee10: 2020 2020 2020 6966 206d 6b64 6972 2065 if mkdir e │ │ │ │ │ +0001ee20: 6c63 2d6c 6f63 6b20 323e 2f64 6576 2f6e lc-lock 2>/dev/n │ │ │ │ │ +0001ee30: 756c 6c3b 2074 6865 6e20 5c0a 2020 2020 ull; then \. │ │ │ │ │ +0001ee40: 2023 2320 5468 6973 2063 6f64 6520 6973 ## This code is │ │ │ │ │ +0001ee50: 2062 6569 6e67 2065 7865 6375 7465 6420 being executed │ │ │ │ │ +0001ee60: 6279 2074 6865 2066 6972 7374 2070 726f by the first pro │ │ │ │ │ +0001ee70: 6365 7373 2e0a 2020 2020 2020 2020 2020 cess.. │ │ │ │ │ +0001ee80: 2020 2020 2020 2072 6d20 2d66 2065 6c63 rm -f elc │ │ │ │ │ +0001ee90: 2d73 7461 6d70 3b20 5c0a 2020 2020 2020 -stamp; \. │ │ │ │ │ +0001eea0: 2020 2020 2020 2020 2020 2024 284d 414b $(MAK │ │ │ │ │ +0001eeb0: 4529 2024 2841 4d5f 4d41 4b45 464c 4147 E) $(AM_MAKEFLAG │ │ │ │ │ +0001eec0: 5329 2065 6c63 2d73 7461 6d70 3b20 5c0a S) elc-stamp; \. │ │ │ │ │ 0001eed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001eee0: 726d 6469 7220 656c 632d 6c6f 636b 3b20 rmdir elc-lock; │ │ │ │ │ -0001eef0: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001ef00: 2065 6c73 6520 5c0a 2020 2020 2023 2320 else \. ## │ │ │ │ │ -0001ef10: 5468 6973 2063 6f64 6520 6973 2062 6569 This code is bei │ │ │ │ │ -0001ef20: 6e67 2065 7865 6375 7465 6420 6279 2074 ng executed by t │ │ │ │ │ -0001ef30: 6865 2066 6f6c 6c6f 7765 7220 7072 6f63 he follower proc │ │ │ │ │ -0001ef40: 6573 7365 732e 0a20 2020 2020 2323 2057 esses.. ## W │ │ │ │ │ -0001ef50: 6169 7420 756e 7469 6c20 7468 6520 6669 ait until the fi │ │ │ │ │ -0001ef60: 7273 7420 7072 6f63 6573 7320 6973 2064 rst process is d │ │ │ │ │ -0001ef70: 6f6e 652e 0a20 2020 2020 2020 2020 2020 one.. │ │ │ │ │ -0001ef80: 2020 2020 2020 7768 696c 6520 7465 7374 while test │ │ │ │ │ -0001ef90: 202d 6420 656c 632d 6c6f 636b 3b20 646f -d elc-lock; do │ │ │ │ │ -0001efa0: 2073 6c65 6570 2031 3b20 646f 6e65 3b20 sleep 1; done; │ │ │ │ │ -0001efb0: 5c0a 2020 2020 2023 2320 5375 6363 6565 \. ## Succee │ │ │ │ │ -0001efc0: 6420 6966 2061 6e64 206f 6e6c 7920 6966 d if and only if │ │ │ │ │ -0001efd0: 2074 6865 2066 6972 7374 2070 726f 6365 the first proce │ │ │ │ │ -0001efe0: 7373 2073 7563 6365 6564 6564 2e0a 2020 ss succeeded.. │ │ │ │ │ -0001eff0: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ -0001f000: 6573 7420 2d66 2065 6c63 2d73 7461 6d70 est -f elc-stamp │ │ │ │ │ -0001f010: 3b20 6578 6974 2024 243f 3b20 5c0a 2020 ; exit $$?; \. │ │ │ │ │ -0001f020: 2020 2020 2020 2020 2020 2020 2066 693b fi; │ │ │ │ │ -0001f030: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001f040: 6669 0a0a 2020 2054 6865 7365 2073 6f6c fi.. These sol │ │ │ │ │ -0001f050: 7574 696f 6e73 2061 6c6c 2073 7469 6c6c utions all still │ │ │ │ │ -0001f060: 2073 7566 6665 7220 6672 6f6d 2074 6865 suffer from the │ │ │ │ │ -0001f070: 2074 6869 7264 2070 726f 626c 656d 2c20 third problem, │ │ │ │ │ -0001f080: 6e61 6d65 6c79 2074 6861 740a 7468 6579 namely that.they │ │ │ │ │ -0001f090: 2062 7265 616b 2074 6865 2070 726f 6d69 break the promi │ │ │ │ │ -0001f0a0: 7365 2074 6861 7420 276d 616b 6520 2d6e se that 'make -n │ │ │ │ │ -0001f0b0: 2720 7368 6f75 6c64 206e 6f74 2063 6175 ' should not cau │ │ │ │ │ -0001f0c0: 7365 2061 6e79 2061 6374 7561 6c0a 6368 se any actual.ch │ │ │ │ │ -0001f0d0: 616e 6765 7320 746f 2074 6865 2074 7265 anges to the tre │ │ │ │ │ -0001f0e0: 652e 2020 466f 7220 7468 6f73 6520 736f e. For those so │ │ │ │ │ -0001f0f0: 6c75 7469 6f6e 7320 7468 6174 2064 6f20 lutions that do │ │ │ │ │ -0001f100: 6e6f 7420 6372 6561 7465 206c 6f63 6b20 not create lock │ │ │ │ │ -0001f110: 6669 6c65 732c 0a69 7420 6973 2070 6f73 files,.it is pos │ │ │ │ │ -0001f120: 7369 626c 6520 746f 2073 706c 6974 2074 sible to split t │ │ │ │ │ -0001f130: 6865 2072 6563 6f76 6572 2072 756c 6573 he recover rules │ │ │ │ │ -0001f140: 2069 6e74 6f20 7477 6f20 7365 7061 7261 into two separa │ │ │ │ │ -0001f150: 7465 2072 6563 6970 650a 636f 6d6d 616e te recipe.comman │ │ │ │ │ -0001f160: 6473 2c20 6f6e 6520 6f66 2077 6869 6368 ds, one of which │ │ │ │ │ -0001f170: 2064 6f65 7320 616c 6c20 776f 726b 2062 does all work b │ │ │ │ │ -0001f180: 7574 2074 6865 2072 6563 7572 7369 6f6e ut the recursion │ │ │ │ │ -0001f190: 2c20 616e 6420 7468 6520 6f74 6865 720a , and the other. │ │ │ │ │ -0001f1a0: 696e 766f 6b65 7320 7468 6520 7265 6375 invokes the recu │ │ │ │ │ -0001f1b0: 7273 6976 6520 2724 284d 414b 4529 272e rsive '$(MAKE)'. │ │ │ │ │ -0001f1c0: 2020 5468 6520 736f 6c75 7469 6f6e 7320 The solutions │ │ │ │ │ -0001f1d0: 696e 766f 6c76 696e 6720 6c6f 636b 696e involving lockin │ │ │ │ │ -0001f1e0: 6720 636f 756c 640a 6163 7420 7570 6f6e g could.act upon │ │ │ │ │ -0001f1f0: 2074 6865 2063 6f6e 7465 6e74 7320 6f66 the contents of │ │ │ │ │ -0001f200: 2074 6865 2027 4d41 4b45 464c 4147 5327 the 'MAKEFLAGS' │ │ │ │ │ -0001f210: 2076 6172 6961 626c 652c 2062 7574 2070 variable, but p │ │ │ │ │ -0001f220: 6172 7369 6e67 2074 6861 740a 706f 7274 arsing that.port │ │ │ │ │ -0001f230: 6162 6c79 2069 7320 6e6f 7420 6561 7379 ably is not easy │ │ │ │ │ -0001f240: 2028 2a6e 6f74 6520 2861 7574 6f63 6f6e (*note (autocon │ │ │ │ │ -0001f250: 6629 5468 6520 4d61 6b65 204d 6163 726f f)The Make Macro │ │ │ │ │ -0001f260: 204d 414b 4546 4c41 4753 3a3a 292e 2020 MAKEFLAGS::). │ │ │ │ │ -0001f270: 4865 7265 0a69 7320 616e 2065 7861 6d70 Here.is an examp │ │ │ │ │ -0001f280: 6c65 3a0a 0a20 2020 2020 454c 4649 4c45 le:.. ELFILE │ │ │ │ │ -0001f290: 5320 3d20 6f6e 652e 656c 2074 776f 2e65 S = one.el two.e │ │ │ │ │ -0001f2a0: 6c20 7468 7265 652e 656c 202e 2e2e 0a20 l three.el .... │ │ │ │ │ -0001f2b0: 2020 2020 454c 4346 494c 4553 203d 2024 ELCFILES = $ │ │ │ │ │ -0001f2c0: 2845 4c46 494c 4553 3a3d 6329 0a0a 2020 (ELFILES:=c).. │ │ │ │ │ -0001f2d0: 2020 2065 6c63 2d73 7461 6d70 3a20 2428 elc-stamp: $( │ │ │ │ │ -0001f2e0: 454c 4649 4c45 5329 0a20 2020 2020 2020 ELFILES). │ │ │ │ │ -0001f2f0: 2020 2020 2020 4072 6d20 2d66 2065 6c63 @rm -f elc │ │ │ │ │ -0001f300: 2d74 656d 700a 2020 2020 2020 2020 2020 -temp. │ │ │ │ │ -0001f310: 2020 2040 746f 7563 6820 656c 632d 7465 @touch elc-te │ │ │ │ │ -0001f320: 6d70 0a20 2020 2020 2020 2020 2020 2020 mp. │ │ │ │ │ -0001f330: 2428 656c 6973 705f 636f 6d70 2920 2428 $(elisp_comp) $( │ │ │ │ │ -0001f340: 454c 4649 4c45 5329 0a20 2020 2020 2020 ELFILES). │ │ │ │ │ -0001f350: 2020 2020 2020 406d 7620 2d66 2065 6c63 @mv -f elc │ │ │ │ │ -0001f360: 2d74 656d 7020 2440 0a0a 2020 2020 2024 -temp $@.. $ │ │ │ │ │ -0001f370: 2845 4c43 4649 4c45 5329 3a20 656c 632d (ELCFILES): elc- │ │ │ │ │ -0001f380: 7374 616d 700a 2020 2020 2023 2320 5265 stamp. ## Re │ │ │ │ │ -0001f390: 636f 7665 7220 6672 6f6d 2074 6865 2072 cover from the r │ │ │ │ │ -0001f3a0: 656d 6f76 616c 206f 6620 2440 0a20 2020 emoval of $@. │ │ │ │ │ -0001f3b0: 2020 2020 2020 2020 2020 4064 7279 3d3b @dry=; │ │ │ │ │ -0001f3c0: 2066 6f72 2066 2069 6e20 7820 2424 4d41 for f in x $$MA │ │ │ │ │ -0001f3d0: 4b45 464c 4147 533b 2064 6f20 5c0a 2020 KEFLAGS; do \. │ │ │ │ │ -0001f3e0: 2020 2020 2020 2020 2020 2020 2063 6173 cas │ │ │ │ │ -0001f3f0: 6520 2424 6620 696e 205c 0a20 2020 2020 e $$f in \. │ │ │ │ │ -0001f400: 2020 2020 2020 2020 2020 2020 2a3d 2a7c *=*| │ │ │ │ │ -0001f410: 2d2d 2a29 3b3b 205c 0a20 2020 2020 2020 --*);; \. │ │ │ │ │ -0001f420: 2020 2020 2020 2020 2020 2a6e 2a29 2064 *n*) d │ │ │ │ │ -0001f430: 7279 3d3a 3b3b 205c 0a20 2020 2020 2020 ry=:;; \. │ │ │ │ │ -0001f440: 2020 2020 2020 2020 6573 6163 3b20 5c0a esac; \. │ │ │ │ │ -0001f450: 2020 2020 2020 2020 2020 2020 2064 6f6e don │ │ │ │ │ -0001f460: 653b 205c 0a20 2020 2020 2020 2020 2020 e; \. │ │ │ │ │ -0001f470: 2020 6966 2074 6573 7420 2d66 2024 403b if test -f $@; │ │ │ │ │ -0001f480: 2074 6865 6e20 3a3b 2065 6c73 6520 5c0a then :; else \. │ │ │ │ │ -0001f490: 2020 2020 2020 2020 2020 2020 2020 2024 $ │ │ │ │ │ -0001f4a0: 2464 7279 2074 7261 7020 2772 6d20 2d72 $dry trap 'rm -r │ │ │ │ │ -0001f4b0: 6620 656c 632d 6c6f 636b 2065 6c63 2d73 f elc-lock elc-s │ │ │ │ │ -0001f4c0: 7461 6d70 2720 3120 3220 3133 2031 353b tamp' 1 2 13 15; │ │ │ │ │ -0001f4d0: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001f4e0: 2020 6966 2024 2464 7279 206d 6b64 6972 if $$dry mkdir │ │ │ │ │ -0001f4f0: 2065 6c63 2d6c 6f63 6b20 323e 2f64 6576 elc-lock 2>/dev │ │ │ │ │ -0001f500: 2f6e 756c 6c3b 2074 6865 6e20 5c0a 2020 /null; then \. │ │ │ │ │ -0001f510: 2020 2023 2320 5468 6973 2063 6f64 6520 ## This code │ │ │ │ │ -0001f520: 6973 2062 6569 6e67 2065 7865 6375 7465 is being execute │ │ │ │ │ -0001f530: 6420 6279 2074 6865 2066 6972 7374 2070 d by the first p │ │ │ │ │ -0001f540: 726f 6365 7373 2e0a 2020 2020 2020 2020 rocess.. │ │ │ │ │ -0001f550: 2020 2020 2020 2020 2024 2464 7279 2072 $$dry r │ │ │ │ │ -0001f560: 6d20 2d66 2065 6c63 2d73 7461 6d70 3b20 m -f elc-stamp; │ │ │ │ │ -0001f570: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001f580: 2020 2024 284d 414b 4529 2024 2841 4d5f $(MAKE) $(AM_ │ │ │ │ │ -0001f590: 4d41 4b45 464c 4147 5329 2065 6c63 2d73 MAKEFLAGS) elc-s │ │ │ │ │ -0001f5a0: 7461 6d70 3b20 5c0a 2020 2020 2020 2020 tamp; \. │ │ │ │ │ -0001f5b0: 2020 2020 2020 2020 2024 2464 7279 2072 $$dry r │ │ │ │ │ -0001f5c0: 6d64 6972 2065 6c63 2d6c 6f63 6b3b 205c mdir elc-lock; \ │ │ │ │ │ -0001f5d0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -0001f5e0: 656c 7365 205c 0a20 2020 2020 2323 2054 else \. ## T │ │ │ │ │ -0001f5f0: 6869 7320 636f 6465 2069 7320 6265 696e his code is bein │ │ │ │ │ -0001f600: 6720 6578 6563 7574 6564 2062 7920 7468 g executed by th │ │ │ │ │ -0001f610: 6520 666f 6c6c 6f77 6572 2070 726f 6365 e follower proce │ │ │ │ │ -0001f620: 7373 6573 2e0a 2020 2020 2023 2320 5761 sses.. ## Wa │ │ │ │ │ -0001f630: 6974 2075 6e74 696c 2074 6865 2066 6972 it until the fir │ │ │ │ │ -0001f640: 7374 2070 726f 6365 7373 2069 7320 646f st process is do │ │ │ │ │ -0001f650: 6e65 2e0a 2020 2020 2020 2020 2020 2020 ne.. │ │ │ │ │ -0001f660: 2020 2020 2077 6869 6c65 2074 6573 7420 while test │ │ │ │ │ -0001f670: 2d64 2065 6c63 2d6c 6f63 6b20 2626 2074 -d elc-lock && t │ │ │ │ │ -0001f680: 6573 7420 2d7a 2022 2424 6472 7922 3b20 est -z "$$dry"; │ │ │ │ │ -0001f690: 646f 205c 0a20 2020 2020 2020 2020 2020 do \. │ │ │ │ │ -0001f6a0: 2020 2020 2020 2020 736c 6565 7020 313b sleep 1; │ │ │ │ │ -0001f6b0: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001f6c0: 2020 2020 646f 6e65 3b20 5c0a 2020 2020 done; \. │ │ │ │ │ -0001f6d0: 2023 2320 5375 6363 6565 6420 6966 2061 ## Succeed if a │ │ │ │ │ -0001f6e0: 6e64 206f 6e6c 7920 6966 2074 6865 2066 nd only if the f │ │ │ │ │ -0001f6f0: 6972 7374 2070 726f 6365 7373 2073 7563 irst process suc │ │ │ │ │ -0001f700: 6365 6564 6564 2e0a 2020 2020 2020 2020 ceeded.. │ │ │ │ │ -0001f710: 2020 2020 2020 2020 2024 2464 7279 2074 $$dry t │ │ │ │ │ -0001f720: 6573 7420 2d66 2065 6c63 2d73 7461 6d70 est -f elc-stamp │ │ │ │ │ -0001f730: 3b20 6578 6974 2024 243f 3b20 5c0a 2020 ; exit $$?; \. │ │ │ │ │ -0001f740: 2020 2020 2020 2020 2020 2020 2066 693b fi; │ │ │ │ │ -0001f750: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ -0001f760: 6669 0a0a 2020 2046 6f72 2063 6f6d 706c fi.. For compl │ │ │ │ │ -0001f770: 6574 656e 6573 7320 6974 2073 686f 756c eteness it shoul │ │ │ │ │ -0001f780: 6420 6265 206e 6f74 6564 2074 6861 7420 d be noted that │ │ │ │ │ -0001f790: 474e 5520 276d 616b 6527 2069 7320 6162 GNU 'make' is ab │ │ │ │ │ -0001f7a0: 6c65 2074 6f0a 6578 7072 6573 7320 7275 le to.express ru │ │ │ │ │ -0001f7b0: 6c65 7320 7769 7468 206d 756c 7469 706c les with multipl │ │ │ │ │ -0001f7c0: 6520 6f75 7470 7574 2066 696c 6573 2075 e output files u │ │ │ │ │ -0001f7d0: 7369 6e67 2070 6174 7465 726e 2072 756c sing pattern rul │ │ │ │ │ -0001f7e0: 6573 2028 2a6e 6f74 650a 5061 7474 6572 es (*note.Patter │ │ │ │ │ -0001f7f0: 6e20 5275 6c65 2045 7861 6d70 6c65 733a n Rule Examples: │ │ │ │ │ -0001f800: 2028 6d61 6b65 2950 6174 7465 726e 2045 (make)Pattern E │ │ │ │ │ -0001f810: 7861 6d70 6c65 732e 292e 2020 5765 2064 xamples.). We d │ │ │ │ │ -0001f820: 6f20 6e6f 7420 6469 7363 7573 730a 7061 o not discuss.pa │ │ │ │ │ -0001f830: 7474 6572 6e20 7275 6c65 7320 6865 7265 ttern rules here │ │ │ │ │ -0001f840: 2062 6563 6175 7365 2074 6865 7920 6172 because they ar │ │ │ │ │ -0001f850: 6520 6e6f 7420 706f 7274 6162 6c65 2c20 e not portable, │ │ │ │ │ -0001f860: 6275 7420 7468 6579 2063 616e 2062 650a but they can be. │ │ │ │ │ -0001f870: 636f 6e76 656e 6965 6e74 2069 6e20 7061 convenient in pa │ │ │ │ │ -0001f880: 636b 6167 6573 2074 6861 7420 6173 7375 ckages that assu │ │ │ │ │ -0001f890: 6d65 2047 4e55 2027 6d61 6b65 272e 0a0a me GNU 'make'... │ │ │ │ │ -0001f8a0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -0001f8b0: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -0001f8c0: 653a 2048 6172 642d 436f 6465 6420 496e e: Hard-Coded In │ │ │ │ │ -0001f8d0: 7374 616c 6c20 5061 7468 732c 2020 4e65 stall Paths, Ne │ │ │ │ │ -0001f8e0: 7874 3a20 4465 6275 6767 696e 6720 4d61 xt: Debugging Ma │ │ │ │ │ -0001f8f0: 6b65 2052 756c 6573 2c20 2050 7265 763a ke Rules, Prev: │ │ │ │ │ -0001f900: 204d 756c 7469 706c 6520 4f75 7470 7574 Multiple Output │ │ │ │ │ -0001f910: 732c 2020 5570 3a20 4641 510a 0a32 382e s, Up: FAQ..28. │ │ │ │ │ -0001f920: 3130 2049 6e73 7461 6c6c 696e 6720 746f 10 Installing to │ │ │ │ │ -0001f930: 2048 6172 642d 436f 6465 6420 4c6f 6361 Hard-Coded Loca │ │ │ │ │ -0001f940: 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d tions.========== │ │ │ │ │ +0001eee0: 2072 6d64 6972 2065 6c63 2d6c 6f63 6b3b rmdir elc-lock; │ │ │ │ │ +0001eef0: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0001ef00: 2020 656c 7365 205c 0a20 2020 2020 2323 else \. ## │ │ │ │ │ +0001ef10: 2054 6869 7320 636f 6465 2069 7320 6265 This code is be │ │ │ │ │ +0001ef20: 696e 6720 6578 6563 7574 6564 2062 7920 ing executed by │ │ │ │ │ +0001ef30: 7468 6520 666f 6c6c 6f77 6572 2070 726f the follower pro │ │ │ │ │ +0001ef40: 6365 7373 6573 2e0a 2020 2020 2023 2320 cesses.. ## │ │ │ │ │ +0001ef50: 5761 6974 2075 6e74 696c 2074 6865 2066 Wait until the f │ │ │ │ │ +0001ef60: 6972 7374 2070 726f 6365 7373 2069 7320 irst process is │ │ │ │ │ +0001ef70: 646f 6e65 2e0a 2020 2020 2020 2020 2020 done.. │ │ │ │ │ +0001ef80: 2020 2020 2020 2077 6869 6c65 2074 6573 while tes │ │ │ │ │ +0001ef90: 7420 2d64 2065 6c63 2d6c 6f63 6b3b 2064 t -d elc-lock; d │ │ │ │ │ +0001efa0: 6f20 736c 6565 7020 313b 2064 6f6e 653b o sleep 1; done; │ │ │ │ │ +0001efb0: 205c 0a20 2020 2020 2323 2053 7563 6365 \. ## Succe │ │ │ │ │ +0001efc0: 6564 2069 6620 616e 6420 6f6e 6c79 2069 ed if and only i │ │ │ │ │ +0001efd0: 6620 7468 6520 6669 7273 7420 7072 6f63 f the first proc │ │ │ │ │ +0001efe0: 6573 7320 7375 6363 6565 6465 642e 0a20 ess succeeded.. │ │ │ │ │ +0001eff0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0001f000: 7465 7374 202d 6620 656c 632d 7374 616d test -f elc-stam │ │ │ │ │ +0001f010: 703b 2065 7869 7420 2424 3f3b 205c 0a20 p; exit $$?; \. │ │ │ │ │ +0001f020: 2020 2020 2020 2020 2020 2020 2020 6669 fi │ │ │ │ │ +0001f030: 3b20 5c0a 2020 2020 2020 2020 2020 2020 ; \. │ │ │ │ │ +0001f040: 2066 690a 0a20 2020 5468 6573 6520 736f fi.. These so │ │ │ │ │ +0001f050: 6c75 7469 6f6e 7320 616c 6c20 7374 696c lutions all stil │ │ │ │ │ +0001f060: 6c20 7375 6666 6572 2066 726f 6d20 7468 l suffer from th │ │ │ │ │ +0001f070: 6520 7468 6972 6420 7072 6f62 6c65 6d2c e third problem, │ │ │ │ │ +0001f080: 206e 616d 656c 7920 7468 6174 0a74 6865 namely that.the │ │ │ │ │ +0001f090: 7920 6272 6561 6b20 7468 6520 7072 6f6d y break the prom │ │ │ │ │ +0001f0a0: 6973 6520 7468 6174 2027 6d61 6b65 202d ise that 'make - │ │ │ │ │ +0001f0b0: 6e27 2073 686f 756c 6420 6e6f 7420 6361 n' should not ca │ │ │ │ │ +0001f0c0: 7573 6520 616e 7920 6163 7475 616c 0a63 use any actual.c │ │ │ │ │ +0001f0d0: 6861 6e67 6573 2074 6f20 7468 6520 7472 hanges to the tr │ │ │ │ │ +0001f0e0: 6565 2e20 2046 6f72 2074 686f 7365 2073 ee. For those s │ │ │ │ │ +0001f0f0: 6f6c 7574 696f 6e73 2074 6861 7420 646f olutions that do │ │ │ │ │ +0001f100: 206e 6f74 2063 7265 6174 6520 6c6f 636b not create lock │ │ │ │ │ +0001f110: 2066 696c 6573 2c0a 6974 2069 7320 706f files,.it is po │ │ │ │ │ +0001f120: 7373 6962 6c65 2074 6f20 7370 6c69 7420 ssible to split │ │ │ │ │ +0001f130: 7468 6520 7265 636f 7665 7220 7275 6c65 the recover rule │ │ │ │ │ +0001f140: 7320 696e 746f 2074 776f 2073 6570 6172 s into two separ │ │ │ │ │ +0001f150: 6174 6520 7265 6369 7065 0a63 6f6d 6d61 ate recipe.comma │ │ │ │ │ +0001f160: 6e64 732c 206f 6e65 206f 6620 7768 6963 nds, one of whic │ │ │ │ │ +0001f170: 6820 646f 6573 2061 6c6c 2077 6f72 6b20 h does all work │ │ │ │ │ +0001f180: 6275 7420 7468 6520 7265 6375 7273 696f but the recursio │ │ │ │ │ +0001f190: 6e2c 2061 6e64 2074 6865 206f 7468 6572 n, and the other │ │ │ │ │ +0001f1a0: 0a69 6e76 6f6b 6573 2074 6865 2072 6563 .invokes the rec │ │ │ │ │ +0001f1b0: 7572 7369 7665 2027 2428 4d41 4b45 2927 ursive '$(MAKE)' │ │ │ │ │ +0001f1c0: 2e20 2054 6865 2073 6f6c 7574 696f 6e73 . The solutions │ │ │ │ │ +0001f1d0: 2069 6e76 6f6c 7669 6e67 206c 6f63 6b69 involving locki │ │ │ │ │ +0001f1e0: 6e67 2063 6f75 6c64 0a61 6374 2075 706f ng could.act upo │ │ │ │ │ +0001f1f0: 6e20 7468 6520 636f 6e74 656e 7473 206f n the contents o │ │ │ │ │ +0001f200: 6620 7468 6520 274d 414b 4546 4c41 4753 f the 'MAKEFLAGS │ │ │ │ │ +0001f210: 2720 7661 7269 6162 6c65 2c20 6275 7420 ' variable, but │ │ │ │ │ +0001f220: 7061 7273 696e 6720 7468 6174 0a70 6f72 parsing that.por │ │ │ │ │ +0001f230: 7461 626c 7920 6973 206e 6f74 2065 6173 tably is not eas │ │ │ │ │ +0001f240: 7920 282a 6e6f 7465 2028 6175 746f 636f y (*note (autoco │ │ │ │ │ +0001f250: 6e66 2954 6865 204d 616b 6520 4d61 6372 nf)The Make Macr │ │ │ │ │ +0001f260: 6f20 4d41 4b45 464c 4147 533a 3a29 2e20 o MAKEFLAGS::). │ │ │ │ │ +0001f270: 2048 6572 650a 6973 2061 6e20 6578 616d Here.is an exam │ │ │ │ │ +0001f280: 706c 653a 0a0a 2020 2020 2045 4c46 494c ple:.. ELFIL │ │ │ │ │ +0001f290: 4553 203d 206f 6e65 2e65 6c20 7477 6f2e ES = one.el two. │ │ │ │ │ +0001f2a0: 656c 2074 6872 6565 2e65 6c20 2e2e 2e0a el three.el .... │ │ │ │ │ +0001f2b0: 2020 2020 2045 4c43 4649 4c45 5320 3d20 ELCFILES = │ │ │ │ │ +0001f2c0: 2428 454c 4649 4c45 533a 3d63 290a 0a20 $(ELFILES:=c).. │ │ │ │ │ +0001f2d0: 2020 2020 656c 632d 7374 616d 703a 2024 elc-stamp: $ │ │ │ │ │ +0001f2e0: 2845 4c46 494c 4553 290a 2020 2020 2020 (ELFILES). │ │ │ │ │ +0001f2f0: 2020 2020 2020 2040 726d 202d 6620 656c @rm -f el │ │ │ │ │ +0001f300: 632d 7465 6d70 0a20 2020 2020 2020 2020 c-temp. │ │ │ │ │ +0001f310: 2020 2020 4074 6f75 6368 2065 6c63 2d74 @touch elc-t │ │ │ │ │ +0001f320: 656d 700a 2020 2020 2020 2020 2020 2020 emp. │ │ │ │ │ +0001f330: 2024 2865 6c69 7370 5f63 6f6d 7029 2024 $(elisp_comp) $ │ │ │ │ │ +0001f340: 2845 4c46 494c 4553 290a 2020 2020 2020 (ELFILES). │ │ │ │ │ +0001f350: 2020 2020 2020 2040 6d76 202d 6620 656c @mv -f el │ │ │ │ │ +0001f360: 632d 7465 6d70 2024 400a 0a20 2020 2020 c-temp $@.. │ │ │ │ │ +0001f370: 2428 454c 4346 494c 4553 293a 2065 6c63 $(ELCFILES): elc │ │ │ │ │ +0001f380: 2d73 7461 6d70 0a20 2020 2020 2323 2052 -stamp. ## R │ │ │ │ │ +0001f390: 6563 6f76 6572 2066 726f 6d20 7468 6520 ecover from the │ │ │ │ │ +0001f3a0: 7265 6d6f 7661 6c20 6f66 2024 400a 2020 removal of $@. │ │ │ │ │ +0001f3b0: 2020 2020 2020 2020 2020 2040 6472 793d @dry= │ │ │ │ │ +0001f3c0: 3b20 666f 7220 6620 696e 2078 2024 244d ; for f in x $$M │ │ │ │ │ +0001f3d0: 414b 4546 4c41 4753 3b20 646f 205c 0a20 AKEFLAGS; do \. │ │ │ │ │ +0001f3e0: 2020 2020 2020 2020 2020 2020 2020 6361 ca │ │ │ │ │ +0001f3f0: 7365 2024 2466 2069 6e20 5c0a 2020 2020 se $$f in \. │ │ │ │ │ +0001f400: 2020 2020 2020 2020 2020 2020 202a 3d2a *=* │ │ │ │ │ +0001f410: 7c2d 2d2a 293b 3b20 5c0a 2020 2020 2020 |--*);; \. │ │ │ │ │ +0001f420: 2020 2020 2020 2020 2020 202a 6e2a 2920 *n*) │ │ │ │ │ +0001f430: 6472 793d 3a3b 3b20 5c0a 2020 2020 2020 dry=:;; \. │ │ │ │ │ +0001f440: 2020 2020 2020 2020 2065 7361 633b 205c esac; \ │ │ │ │ │ +0001f450: 0a20 2020 2020 2020 2020 2020 2020 646f . do │ │ │ │ │ +0001f460: 6e65 3b20 5c0a 2020 2020 2020 2020 2020 ne; \. │ │ │ │ │ +0001f470: 2020 2069 6620 7465 7374 202d 6620 2440 if test -f $@ │ │ │ │ │ +0001f480: 3b20 7468 656e 203a 3b20 656c 7365 205c ; then :; else \ │ │ │ │ │ +0001f490: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0001f4a0: 2424 6472 7920 7472 6170 2027 726d 202d $$dry trap 'rm - │ │ │ │ │ +0001f4b0: 7266 2065 6c63 2d6c 6f63 6b20 656c 632d rf elc-lock elc- │ │ │ │ │ +0001f4c0: 7374 616d 7027 2031 2032 2031 3320 3135 stamp' 1 2 13 15 │ │ │ │ │ +0001f4d0: 3b20 5c0a 2020 2020 2020 2020 2020 2020 ; \. │ │ │ │ │ +0001f4e0: 2020 2069 6620 2424 6472 7920 6d6b 6469 if $$dry mkdi │ │ │ │ │ +0001f4f0: 7220 656c 632d 6c6f 636b 2032 3e2f 6465 r elc-lock 2>/de │ │ │ │ │ +0001f500: 762f 6e75 6c6c 3b20 7468 656e 205c 0a20 v/null; then \. │ │ │ │ │ +0001f510: 2020 2020 2323 2054 6869 7320 636f 6465 ## This code │ │ │ │ │ +0001f520: 2069 7320 6265 696e 6720 6578 6563 7574 is being execut │ │ │ │ │ +0001f530: 6564 2062 7920 7468 6520 6669 7273 7420 ed by the first │ │ │ │ │ +0001f540: 7072 6f63 6573 732e 0a20 2020 2020 2020 process.. │ │ │ │ │ +0001f550: 2020 2020 2020 2020 2020 2424 6472 7920 $$dry │ │ │ │ │ +0001f560: 726d 202d 6620 656c 632d 7374 616d 703b rm -f elc-stamp; │ │ │ │ │ +0001f570: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0001f580: 2020 2020 2428 4d41 4b45 2920 2428 414d $(MAKE) $(AM │ │ │ │ │ +0001f590: 5f4d 414b 4546 4c41 4753 2920 656c 632d _MAKEFLAGS) elc- │ │ │ │ │ +0001f5a0: 7374 616d 703b 205c 0a20 2020 2020 2020 stamp; \. │ │ │ │ │ +0001f5b0: 2020 2020 2020 2020 2020 2424 6472 7920 $$dry │ │ │ │ │ +0001f5c0: 726d 6469 7220 656c 632d 6c6f 636b 3b20 rmdir elc-lock; │ │ │ │ │ +0001f5d0: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0001f5e0: 2065 6c73 6520 5c0a 2020 2020 2023 2320 else \. ## │ │ │ │ │ +0001f5f0: 5468 6973 2063 6f64 6520 6973 2062 6569 This code is bei │ │ │ │ │ +0001f600: 6e67 2065 7865 6375 7465 6420 6279 2074 ng executed by t │ │ │ │ │ +0001f610: 6865 2066 6f6c 6c6f 7765 7220 7072 6f63 he follower proc │ │ │ │ │ +0001f620: 6573 7365 732e 0a20 2020 2020 2323 2057 esses.. ## W │ │ │ │ │ +0001f630: 6169 7420 756e 7469 6c20 7468 6520 6669 ait until the fi │ │ │ │ │ +0001f640: 7273 7420 7072 6f63 6573 7320 6973 2064 rst process is d │ │ │ │ │ +0001f650: 6f6e 652e 0a20 2020 2020 2020 2020 2020 one.. │ │ │ │ │ +0001f660: 2020 2020 2020 7768 696c 6520 7465 7374 while test │ │ │ │ │ +0001f670: 202d 6420 656c 632d 6c6f 636b 2026 2620 -d elc-lock && │ │ │ │ │ +0001f680: 7465 7374 202d 7a20 2224 2464 7279 223b test -z "$$dry"; │ │ │ │ │ +0001f690: 2064 6f20 5c0a 2020 2020 2020 2020 2020 do \. │ │ │ │ │ +0001f6a0: 2020 2020 2020 2020 2073 6c65 6570 2031 sleep 1 │ │ │ │ │ +0001f6b0: 3b20 5c0a 2020 2020 2020 2020 2020 2020 ; \. │ │ │ │ │ +0001f6c0: 2020 2020 2064 6f6e 653b 205c 0a20 2020 done; \. │ │ │ │ │ +0001f6d0: 2020 2323 2053 7563 6365 6564 2069 6620 ## Succeed if │ │ │ │ │ +0001f6e0: 616e 6420 6f6e 6c79 2069 6620 7468 6520 and only if the │ │ │ │ │ +0001f6f0: 6669 7273 7420 7072 6f63 6573 7320 7375 first process su │ │ │ │ │ +0001f700: 6363 6565 6465 642e 0a20 2020 2020 2020 cceeded.. │ │ │ │ │ +0001f710: 2020 2020 2020 2020 2020 2424 6472 7920 $$dry │ │ │ │ │ +0001f720: 7465 7374 202d 6620 656c 632d 7374 616d test -f elc-stam │ │ │ │ │ +0001f730: 703b 2065 7869 7420 2424 3f3b 205c 0a20 p; exit $$?; \. │ │ │ │ │ +0001f740: 2020 2020 2020 2020 2020 2020 2020 6669 fi │ │ │ │ │ +0001f750: 3b20 5c0a 2020 2020 2020 2020 2020 2020 ; \. │ │ │ │ │ +0001f760: 2066 690a 0a20 2020 466f 7220 636f 6d70 fi.. For comp │ │ │ │ │ +0001f770: 6c65 7465 6e65 7373 2069 7420 7368 6f75 leteness it shou │ │ │ │ │ +0001f780: 6c64 2062 6520 6e6f 7465 6420 7468 6174 ld be noted that │ │ │ │ │ +0001f790: 2047 4e55 2027 6d61 6b65 2720 6973 2061 GNU 'make' is a │ │ │ │ │ +0001f7a0: 626c 6520 746f 0a65 7870 7265 7373 2072 ble to.express r │ │ │ │ │ +0001f7b0: 756c 6573 2077 6974 6820 6d75 6c74 6970 ules with multip │ │ │ │ │ +0001f7c0: 6c65 206f 7574 7075 7420 6669 6c65 7320 le output files │ │ │ │ │ +0001f7d0: 7573 696e 6720 7061 7474 6572 6e20 7275 using pattern ru │ │ │ │ │ +0001f7e0: 6c65 7320 282a 6e6f 7465 0a50 6174 7465 les (*note.Patte │ │ │ │ │ +0001f7f0: 726e 2052 756c 6520 4578 616d 706c 6573 rn Rule Examples │ │ │ │ │ +0001f800: 3a20 286d 616b 6529 5061 7474 6572 6e20 : (make)Pattern │ │ │ │ │ +0001f810: 4578 616d 706c 6573 2e29 2e20 2057 6520 Examples.). We │ │ │ │ │ +0001f820: 646f 206e 6f74 2064 6973 6375 7373 0a70 do not discuss.p │ │ │ │ │ +0001f830: 6174 7465 726e 2072 756c 6573 2068 6572 attern rules her │ │ │ │ │ +0001f840: 6520 6265 6361 7573 6520 7468 6579 2061 e because they a │ │ │ │ │ +0001f850: 7265 206e 6f74 2070 6f72 7461 626c 652c re not portable, │ │ │ │ │ +0001f860: 2062 7574 2074 6865 7920 6361 6e20 6265 but they can be │ │ │ │ │ +0001f870: 0a63 6f6e 7665 6e69 656e 7420 696e 2070 .convenient in p │ │ │ │ │ +0001f880: 6163 6b61 6765 7320 7468 6174 2061 7373 ackages that ass │ │ │ │ │ +0001f890: 756d 6520 474e 5520 276d 616b 6527 2e0a ume GNU 'make'.. │ │ │ │ │ +0001f8a0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +0001f8b0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +0001f8c0: 6465 3a20 4861 7264 2d43 6f64 6564 2049 de: Hard-Coded I │ │ │ │ │ +0001f8d0: 6e73 7461 6c6c 2050 6174 6873 2c20 204e nstall Paths, N │ │ │ │ │ +0001f8e0: 6578 743a 2044 6562 7567 6769 6e67 204d ext: Debugging M │ │ │ │ │ +0001f8f0: 616b 6520 5275 6c65 732c 2020 5072 6576 ake Rules, Prev │ │ │ │ │ +0001f900: 3a20 4d75 6c74 6970 6c65 204f 7574 7075 : Multiple Outpu │ │ │ │ │ +0001f910: 7473 2c20 2055 703a 2046 4151 0a0a 3238 ts, Up: FAQ..28 │ │ │ │ │ +0001f920: 2e31 3020 496e 7374 616c 6c69 6e67 2074 .10 Installing t │ │ │ │ │ +0001f930: 6f20 4861 7264 2d43 6f64 6564 204c 6f63 o Hard-Coded Loc │ │ │ │ │ +0001f940: 6174 696f 6e73 0a3d 3d3d 3d3d 3d3d 3d3d ations.========= │ │ │ │ │ 0001f950: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001f960: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -0001f970: 2020 2020 204d 7920 7061 636b 6167 6520 My package │ │ │ │ │ -0001f980: 6e65 6564 7320 746f 2069 6e73 7461 6c6c needs to install │ │ │ │ │ -0001f990: 2073 6f6d 6520 636f 6e66 6967 7572 6174 some configurat │ │ │ │ │ -0001f9a0: 696f 6e20 6669 6c65 2e20 2049 2074 7269 ion file. I tri │ │ │ │ │ -0001f9b0: 6564 2074 6f20 7573 650a 2020 2020 2074 ed to use. t │ │ │ │ │ -0001f9c0: 6865 2066 6f6c 6c6f 7769 6e67 2072 756c he following rul │ │ │ │ │ -0001f9d0: 652c 2062 7574 2027 6d61 6b65 2064 6973 e, but 'make dis │ │ │ │ │ -0001f9e0: 7463 6865 636b 2720 6661 696c 732e 2020 tcheck' fails. │ │ │ │ │ -0001f9f0: 5768 793f 0a0a 2020 2020 2020 2020 2020 Why?.. │ │ │ │ │ -0001fa00: 2320 446f 206e 6f74 2064 6f20 7468 6973 # Do not do this │ │ │ │ │ -0001fa10: 2e0a 2020 2020 2020 2020 2020 696e 7374 .. inst │ │ │ │ │ -0001fa20: 616c 6c2d 6461 7461 2d6c 6f63 616c 3a0a all-data-local:. │ │ │ │ │ -0001fa30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001fa40: 2020 2428 494e 5354 414c 4c5f 4441 5441 $(INSTALL_DATA │ │ │ │ │ -0001fa50: 2920 2428 7372 6364 6972 292f 6166 696c ) $(srcdir)/afil │ │ │ │ │ -0001fa60: 6520 2428 4445 5354 4449 5229 2f65 7463 e $(DESTDIR)/etc │ │ │ │ │ -0001fa70: 2f61 6669 6c65 0a0a 2020 2020 204d 7920 /afile.. My │ │ │ │ │ -0001fa80: 7061 636b 6167 6520 6e65 6564 7320 746f package needs to │ │ │ │ │ -0001fa90: 2070 6f70 756c 6174 6520 7468 6520 696e populate the in │ │ │ │ │ -0001faa0: 7374 616c 6c61 7469 6f6e 2064 6972 6563 stallation direc │ │ │ │ │ -0001fab0: 746f 7279 206f 6620 616e 6f74 6865 720a tory of another. │ │ │ │ │ -0001fac0: 2020 2020 2070 6163 6b61 6765 2061 7420 package at │ │ │ │ │ -0001fad0: 696e 7374 616c 6c2d 7469 6d65 2e20 2049 install-time. I │ │ │ │ │ -0001fae0: 2063 616e 2065 6173 696c 7920 636f 6d70 can easily comp │ │ │ │ │ -0001faf0: 7574 6520 7468 6174 2069 6e73 7461 6c6c ute that install │ │ │ │ │ -0001fb00: 6174 696f 6e0a 2020 2020 2064 6972 6563 ation. direc │ │ │ │ │ -0001fb10: 746f 7279 2069 6e20 2763 6f6e 6669 6775 tory in 'configu │ │ │ │ │ -0001fb20: 7265 272c 2062 7574 2069 6620 4920 696e re', but if I in │ │ │ │ │ -0001fb30: 7374 616c 6c20 6669 6c65 7320 7468 6572 stall files ther │ │ │ │ │ -0001fb40: 6569 6e2c 0a20 2020 2020 276d 616b 6520 ein,. 'make │ │ │ │ │ -0001fb50: 6469 7374 6368 6563 6b27 2066 6169 6c73 distcheck' fails │ │ │ │ │ -0001fb60: 2e20 2048 6f77 2065 6c73 6520 7368 6f75 . How else shou │ │ │ │ │ -0001fb70: 6c64 2049 2064 6f3f 0a0a 2020 2054 6865 ld I do?.. The │ │ │ │ │ -0001fb80: 7365 2074 776f 2073 6574 7570 7320 7368 se two setups sh │ │ │ │ │ -0001fb90: 6172 6520 7468 6569 7220 7379 6d70 746f are their sympto │ │ │ │ │ -0001fba0: 6d73 3a20 276d 616b 6520 6469 7374 6368 ms: 'make distch │ │ │ │ │ -0001fbb0: 6563 6b27 2066 6169 6c73 2062 6563 6175 eck' fails becau │ │ │ │ │ -0001fbc0: 7365 0a74 6865 7920 6172 6520 696e 7374 se.they are inst │ │ │ │ │ -0001fbd0: 616c 6c69 6e67 2066 696c 6573 2074 6f20 alling files to │ │ │ │ │ -0001fbe0: 6861 7264 2d63 6f64 6564 2070 6174 6873 hard-coded paths │ │ │ │ │ -0001fbf0: 2e20 2049 6e20 7468 6520 6c61 7465 7220 . In the later │ │ │ │ │ -0001fc00: 6361 7365 2074 6865 0a70 6174 6820 6973 case the.path is │ │ │ │ │ -0001fc10: 206e 6f74 2072 6561 6c6c 7920 6861 7264 not really hard │ │ │ │ │ -0001fc20: 2d63 6f64 6564 2069 6e20 7468 6520 7061 -coded in the pa │ │ │ │ │ -0001fc30: 636b 6167 652c 2062 7574 2077 6520 6361 ckage, but we ca │ │ │ │ │ -0001fc40: 6e20 636f 6e73 6964 6572 2069 7420 746f n consider it to │ │ │ │ │ -0001fc50: 0a62 6520 6861 7264 2d63 6f64 6564 2069 .be hard-coded i │ │ │ │ │ -0001fc60: 6e20 7468 6520 7379 7374 656d 2028 6f72 n the system (or │ │ │ │ │ -0001fc70: 2069 6e20 7768 6963 6865 7665 7220 746f in whichever to │ │ │ │ │ -0001fc80: 6f6c 2074 6861 7420 7375 7070 6c69 6573 ol that supplies │ │ │ │ │ -0001fc90: 2074 6865 0a70 6174 6829 2e20 2041 7320 the.path). As │ │ │ │ │ -0001fca0: 6c6f 6e67 2061 7320 7468 6520 7061 7468 long as the path │ │ │ │ │ -0001fcb0: 2064 6f65 7320 6e6f 7420 7573 6520 616e does not use an │ │ │ │ │ -0001fcc0: 7920 6f66 2074 6865 2073 7461 6e64 6172 y of the standar │ │ │ │ │ -0001fcd0: 6420 6469 7265 6374 6f72 790a 7661 7269 d directory.vari │ │ │ │ │ -0001fce0: 6162 6c65 7320 2827 2428 7072 6566 6978 ables ('$(prefix │ │ │ │ │ -0001fcf0: 2927 2c20 2724 2862 696e 6469 7229 272c )', '$(bindir)', │ │ │ │ │ -0001fd00: 2027 2428 6461 7461 6469 7229 272c 2065 '$(datadir)', e │ │ │ │ │ -0001fd10: 7463 2e29 2c20 7468 6520 6566 6665 6374 tc.), the effect │ │ │ │ │ -0001fd20: 0a77 696c 6c20 6265 2074 6865 2073 616d .will be the sam │ │ │ │ │ -0001fd30: 653a 2075 7365 722d 696e 7374 616c 6c61 e: user-installa │ │ │ │ │ -0001fd40: 7469 6f6e 7320 6172 6520 696d 706f 7373 tions are imposs │ │ │ │ │ -0001fd50: 6962 6c65 2e0a 0a20 2020 4173 2061 2028 ible... As a ( │ │ │ │ │ -0001fd60: 6e6f 6e2d 726f 6f74 2920 7573 6572 2077 non-root) user w │ │ │ │ │ -0001fd70: 686f 2077 616e 7473 2074 6f20 696e 7374 ho wants to inst │ │ │ │ │ -0001fd80: 616c 6c20 6120 7061 636b 6167 652c 2079 all a package, y │ │ │ │ │ -0001fd90: 6f75 2075 7375 616c 6c79 2068 6176 650a ou usually have. │ │ │ │ │ -0001fda0: 6e6f 2072 6967 6874 2074 6f20 696e 7374 no right to inst │ │ │ │ │ -0001fdb0: 616c 6c20 616e 7974 6869 6e67 2069 6e20 all anything in │ │ │ │ │ -0001fdc0: 272f 7573 7227 206f 7220 272f 7573 722f '/usr' or '/usr/ │ │ │ │ │ -0001fdd0: 6c6f 6361 6c27 2e20 2053 6f20 796f 7520 local'. So you │ │ │ │ │ -0001fde0: 646f 0a73 6f6d 6574 6869 6e67 206c 696b do.something lik │ │ │ │ │ -0001fdf0: 6520 272e 2f63 6f6e 6669 6775 7265 202d e './configure - │ │ │ │ │ -0001fe00: 2d70 7265 6669 7820 7e2f 7573 7227 2074 -prefix ~/usr' t │ │ │ │ │ -0001fe10: 6f20 696e 7374 616c 6c20 6120 7061 636b o install a pack │ │ │ │ │ -0001fe20: 6167 6520 696e 2079 6f75 720a 6f77 6e20 age in your.own │ │ │ │ │ -0001fe30: 277e 2f75 7372 2720 7472 6565 2e0a 0a20 '~/usr' tree... │ │ │ │ │ -0001fe40: 2020 4966 2061 2070 6163 6b61 6765 2061 If a package a │ │ │ │ │ -0001fe50: 7474 656d 7074 7320 746f 2069 6e73 7461 ttempts to insta │ │ │ │ │ -0001fe60: 6c6c 2073 6f6d 6574 6869 6e67 2074 6f20 ll something to │ │ │ │ │ -0001fe70: 736f 6d65 2068 6172 642d 636f 6465 6420 some hard-coded │ │ │ │ │ -0001fe80: 7061 7468 0a28 652e 672e 2c20 272f 6574 path.(e.g., '/et │ │ │ │ │ -0001fe90: 632f 6166 696c 6527 292c 2072 6567 6172 c/afile'), regar │ │ │ │ │ -0001fea0: 646c 6573 7320 6f66 2074 6869 7320 272d dless of this '- │ │ │ │ │ -0001feb0: 2d70 7265 6669 7827 2073 6574 7469 6e67 -prefix' setting │ │ │ │ │ -0001fec0: 2c20 7468 656e 2074 6865 0a69 6e73 7461 , then the.insta │ │ │ │ │ -0001fed0: 6c6c 6174 696f 6e20 7769 6c6c 2066 6169 llation will fai │ │ │ │ │ -0001fee0: 6c2e 2020 276d 616b 6520 6469 7374 6368 l. 'make distch │ │ │ │ │ -0001fef0: 6563 6b27 2070 6572 666f 726d 7320 7375 eck' performs su │ │ │ │ │ -0001ff00: 6368 2061 2027 2d2d 7072 6566 6978 270a ch a '--prefix'. │ │ │ │ │ -0001ff10: 696e 7374 616c 6c61 7469 6f6e 2c20 6865 installation, he │ │ │ │ │ -0001ff20: 6e63 6520 6974 2077 696c 6c20 6661 696c nce it will fail │ │ │ │ │ -0001ff30: 2074 6f6f 2e0a 0a20 2020 4e6f 772c 2074 too... Now, t │ │ │ │ │ -0001ff40: 6865 7265 2061 7265 2073 6f6d 6520 6561 here are some ea │ │ │ │ │ -0001ff50: 7379 2073 6f6c 7574 696f 6e73 2e0a 0a20 sy solutions... │ │ │ │ │ -0001ff60: 2020 5468 6520 6162 6f76 6520 2769 6e73 The above 'ins │ │ │ │ │ -0001ff70: 7461 6c6c 2d64 6174 612d 6c6f 6361 6c27 tall-data-local' │ │ │ │ │ -0001ff80: 2065 7861 6d70 6c65 2066 6f72 2069 6e73 example for ins │ │ │ │ │ -0001ff90: 7461 6c6c 696e 6720 272f 6574 632f 6166 talling '/etc/af │ │ │ │ │ -0001ffa0: 696c 6527 0a77 6f75 6c64 2062 6520 6265 ile'.would be be │ │ │ │ │ -0001ffb0: 7474 6572 2072 6570 6c61 6365 6420 6279 tter replaced by │ │ │ │ │ -0001ffc0: 0a0a 2020 2020 2073 7973 636f 6e66 5f44 .. sysconf_D │ │ │ │ │ -0001ffd0: 4154 4120 3d20 6166 696c 650a 0a62 7920 ATA = afile..by │ │ │ │ │ -0001ffe0: 6465 6661 756c 7420 2773 7973 636f 6e66 default 'sysconf │ │ │ │ │ -0001fff0: 6469 7227 2077 696c 6c20 6265 2027 2428 dir' will be '$( │ │ │ │ │ -00020000: 7072 6566 6978 292f 6574 6327 2c20 6265 prefix)/etc', be │ │ │ │ │ -00020010: 6361 7573 6520 7468 6973 2069 7320 7768 cause this is wh │ │ │ │ │ -00020020: 6174 0a74 6865 2047 4e55 2053 7461 6e64 at.the GNU Stand │ │ │ │ │ -00020030: 6172 6473 2072 6571 7569 7265 2e20 2057 ards require. W │ │ │ │ │ -00020040: 6865 6e20 7375 6368 2061 2070 6163 6b61 hen such a packa │ │ │ │ │ -00020050: 6765 2069 7320 696e 7374 616c 6c65 6420 ge is installed │ │ │ │ │ -00020060: 6f6e 2061 6e20 4648 530a 636f 6d70 6c69 on an FHS.compli │ │ │ │ │ -00020070: 616e 7420 7379 7374 656d 2c20 7468 6520 ant system, the │ │ │ │ │ -00020080: 696e 7374 616c 6c65 7220 7769 6c6c 2068 installer will h │ │ │ │ │ -00020090: 6176 6520 746f 2073 6574 2027 2d2d 7379 ave to set '--sy │ │ │ │ │ -000200a0: 7363 6f6e 6664 6972 3d2f 6574 6327 2e0a sconfdir=/etc'.. │ │ │ │ │ -000200b0: 4173 2074 6865 206d 6169 6e74 6169 6e65 As the maintaine │ │ │ │ │ -000200c0: 7220 6f66 2074 6865 2070 6163 6b61 6765 r of the package │ │ │ │ │ -000200d0: 2079 6f75 2073 686f 756c 6420 6e6f 7420 you should not │ │ │ │ │ -000200e0: 6265 2063 6f6e 6365 726e 6564 2062 7920 be concerned by │ │ │ │ │ -000200f0: 7375 6368 0a73 6974 6520 706f 6c69 6369 such.site polici │ │ │ │ │ -00020100: 6573 3a20 7573 6520 7468 6520 6170 7072 es: use the appr │ │ │ │ │ -00020110: 6f70 7269 6174 6520 7374 616e 6461 7264 opriate standard │ │ │ │ │ -00020120: 2064 6972 6563 746f 7279 2076 6172 6961 directory varia │ │ │ │ │ -00020130: 626c 6520 746f 0a69 6e73 7461 6c6c 2079 ble to.install y │ │ │ │ │ -00020140: 6f75 7220 6669 6c65 7320 736f 2074 6861 our files so tha │ │ │ │ │ -00020150: 7420 7468 6520 696e 7374 616c 6c65 7220 t the installer │ │ │ │ │ -00020160: 6361 6e20 6561 7369 6c79 2072 6564 6566 can easily redef │ │ │ │ │ -00020170: 696e 6520 7468 6573 650a 7661 7269 6162 ine these.variab │ │ │ │ │ -00020180: 6c65 7320 746f 206d 6174 6368 2074 6865 les to match the │ │ │ │ │ -00020190: 6972 2073 6974 6520 636f 6e76 656e 7469 ir site conventi │ │ │ │ │ -000201a0: 6f6e 732e 0a0a 2020 2049 6e73 7461 6c6c ons... Install │ │ │ │ │ -000201b0: 696e 6720 6669 6c65 7320 7468 6174 2073 ing files that s │ │ │ │ │ -000201c0: 686f 756c 6420 6265 2075 7365 6420 6279 hould be used by │ │ │ │ │ -000201d0: 2061 6e6f 7468 6572 2070 6163 6b61 6765 another package │ │ │ │ │ -000201e0: 2069 7320 736c 6967 6874 6c79 0a6d 6f72 is slightly.mor │ │ │ │ │ -000201f0: 6520 696e 766f 6c76 6564 2e20 204c 6574 e involved. Let │ │ │ │ │ -00020200: 2773 2074 616b 6520 616e 2065 7861 6d70 's take an examp │ │ │ │ │ -00020210: 6c65 2061 6e64 2061 7373 756d 6520 796f le and assume yo │ │ │ │ │ -00020220: 7520 7761 6e74 2074 6f20 696e 7374 616c u want to instal │ │ │ │ │ -00020230: 6c20 610a 7368 6172 6564 206c 6962 7261 l a.shared libra │ │ │ │ │ -00020240: 7279 2074 6861 7420 6973 2061 2050 7974 ry that is a Pyt │ │ │ │ │ -00020250: 686f 6e20 6578 7465 6e73 696f 6e20 6d6f hon extension mo │ │ │ │ │ -00020260: 6475 6c65 2e20 2049 6620 796f 7520 6173 dule. If you as │ │ │ │ │ -00020270: 6b20 5079 7468 6f6e 0a77 6865 7265 2074 k Python.where t │ │ │ │ │ -00020280: 6f20 696e 7374 616c 6c20 7468 6520 6c69 o install the li │ │ │ │ │ -00020290: 6272 6172 792c 2069 7420 7769 6c6c 2061 brary, it will a │ │ │ │ │ -000202a0: 6e73 7765 7220 736f 6d65 7468 696e 6720 nswer something │ │ │ │ │ -000202b0: 6c69 6b65 2074 6869 733a 0a0a 2020 2020 like this:.. │ │ │ │ │ -000202c0: 2025 2070 7974 686f 6e20 2d63 2027 6672 % python -c 'fr │ │ │ │ │ -000202d0: 6f6d 2064 6973 7475 7469 6c73 2069 6d70 om distutils imp │ │ │ │ │ -000202e0: 6f72 7420 7379 7363 6f6e 6669 673b 0a20 ort sysconfig;. │ │ │ │ │ +0001f960: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +0001f970: 0a20 2020 2020 4d79 2070 6163 6b61 6765 . My package │ │ │ │ │ +0001f980: 206e 6565 6473 2074 6f20 696e 7374 616c needs to instal │ │ │ │ │ +0001f990: 6c20 736f 6d65 2063 6f6e 6669 6775 7261 l some configura │ │ │ │ │ +0001f9a0: 7469 6f6e 2066 696c 652e 2020 4920 7472 tion file. I tr │ │ │ │ │ +0001f9b0: 6965 6420 746f 2075 7365 0a20 2020 2020 ied to use. │ │ │ │ │ +0001f9c0: 7468 6520 666f 6c6c 6f77 696e 6720 7275 the following ru │ │ │ │ │ +0001f9d0: 6c65 2c20 6275 7420 276d 616b 6520 6469 le, but 'make di │ │ │ │ │ +0001f9e0: 7374 6368 6563 6b27 2066 6169 6c73 2e20 stcheck' fails. │ │ │ │ │ +0001f9f0: 2057 6879 3f0a 0a20 2020 2020 2020 2020 Why?.. │ │ │ │ │ +0001fa00: 2023 2044 6f20 6e6f 7420 646f 2074 6869 # Do not do thi │ │ │ │ │ +0001fa10: 732e 0a20 2020 2020 2020 2020 2069 6e73 s.. ins │ │ │ │ │ +0001fa20: 7461 6c6c 2d64 6174 612d 6c6f 6361 6c3a tall-data-local: │ │ │ │ │ +0001fa30: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0001fa40: 2020 2024 2849 4e53 5441 4c4c 5f44 4154 $(INSTALL_DAT │ │ │ │ │ +0001fa50: 4129 2024 2873 7263 6469 7229 2f61 6669 A) $(srcdir)/afi │ │ │ │ │ +0001fa60: 6c65 2024 2844 4553 5444 4952 292f 6574 le $(DESTDIR)/et │ │ │ │ │ +0001fa70: 632f 6166 696c 650a 0a20 2020 2020 4d79 c/afile.. My │ │ │ │ │ +0001fa80: 2070 6163 6b61 6765 206e 6565 6473 2074 package needs t │ │ │ │ │ +0001fa90: 6f20 706f 7075 6c61 7465 2074 6865 2069 o populate the i │ │ │ │ │ +0001faa0: 6e73 7461 6c6c 6174 696f 6e20 6469 7265 nstallation dire │ │ │ │ │ +0001fab0: 6374 6f72 7920 6f66 2061 6e6f 7468 6572 ctory of another │ │ │ │ │ +0001fac0: 0a20 2020 2020 7061 636b 6167 6520 6174 . package at │ │ │ │ │ +0001fad0: 2069 6e73 7461 6c6c 2d74 696d 652e 2020 install-time. │ │ │ │ │ +0001fae0: 4920 6361 6e20 6561 7369 6c79 2063 6f6d I can easily com │ │ │ │ │ +0001faf0: 7075 7465 2074 6861 7420 696e 7374 616c pute that instal │ │ │ │ │ +0001fb00: 6c61 7469 6f6e 0a20 2020 2020 6469 7265 lation. dire │ │ │ │ │ +0001fb10: 6374 6f72 7920 696e 2027 636f 6e66 6967 ctory in 'config │ │ │ │ │ +0001fb20: 7572 6527 2c20 6275 7420 6966 2049 2069 ure', but if I i │ │ │ │ │ +0001fb30: 6e73 7461 6c6c 2066 696c 6573 2074 6865 nstall files the │ │ │ │ │ +0001fb40: 7265 696e 2c0a 2020 2020 2027 6d61 6b65 rein,. 'make │ │ │ │ │ +0001fb50: 2064 6973 7463 6865 636b 2720 6661 696c distcheck' fail │ │ │ │ │ +0001fb60: 732e 2020 486f 7720 656c 7365 2073 686f s. How else sho │ │ │ │ │ +0001fb70: 756c 6420 4920 646f 3f0a 0a20 2020 5468 uld I do?.. Th │ │ │ │ │ +0001fb80: 6573 6520 7477 6f20 7365 7475 7073 2073 ese two setups s │ │ │ │ │ +0001fb90: 6861 7265 2074 6865 6972 2073 796d 7074 hare their sympt │ │ │ │ │ +0001fba0: 6f6d 733a 2027 6d61 6b65 2064 6973 7463 oms: 'make distc │ │ │ │ │ +0001fbb0: 6865 636b 2720 6661 696c 7320 6265 6361 heck' fails beca │ │ │ │ │ +0001fbc0: 7573 650a 7468 6579 2061 7265 2069 6e73 use.they are ins │ │ │ │ │ +0001fbd0: 7461 6c6c 696e 6720 6669 6c65 7320 746f talling files to │ │ │ │ │ +0001fbe0: 2068 6172 642d 636f 6465 6420 7061 7468 hard-coded path │ │ │ │ │ +0001fbf0: 732e 2020 496e 2074 6865 206c 6174 6572 s. In the later │ │ │ │ │ +0001fc00: 2063 6173 6520 7468 650a 7061 7468 2069 case the.path i │ │ │ │ │ +0001fc10: 7320 6e6f 7420 7265 616c 6c79 2068 6172 s not really har │ │ │ │ │ +0001fc20: 642d 636f 6465 6420 696e 2074 6865 2070 d-coded in the p │ │ │ │ │ +0001fc30: 6163 6b61 6765 2c20 6275 7420 7765 2063 ackage, but we c │ │ │ │ │ +0001fc40: 616e 2063 6f6e 7369 6465 7220 6974 2074 an consider it t │ │ │ │ │ +0001fc50: 6f0a 6265 2068 6172 642d 636f 6465 6420 o.be hard-coded │ │ │ │ │ +0001fc60: 696e 2074 6865 2073 7973 7465 6d20 286f in the system (o │ │ │ │ │ +0001fc70: 7220 696e 2077 6869 6368 6576 6572 2074 r in whichever t │ │ │ │ │ +0001fc80: 6f6f 6c20 7468 6174 2073 7570 706c 6965 ool that supplie │ │ │ │ │ +0001fc90: 7320 7468 650a 7061 7468 292e 2020 4173 s the.path). As │ │ │ │ │ +0001fca0: 206c 6f6e 6720 6173 2074 6865 2070 6174 long as the pat │ │ │ │ │ +0001fcb0: 6820 646f 6573 206e 6f74 2075 7365 2061 h does not use a │ │ │ │ │ +0001fcc0: 6e79 206f 6620 7468 6520 7374 616e 6461 ny of the standa │ │ │ │ │ +0001fcd0: 7264 2064 6972 6563 746f 7279 0a76 6172 rd directory.var │ │ │ │ │ +0001fce0: 6961 626c 6573 2028 2724 2870 7265 6669 iables ('$(prefi │ │ │ │ │ +0001fcf0: 7829 272c 2027 2428 6269 6e64 6972 2927 x)', '$(bindir)' │ │ │ │ │ +0001fd00: 2c20 2724 2864 6174 6164 6972 2927 2c20 , '$(datadir)', │ │ │ │ │ +0001fd10: 6574 632e 292c 2074 6865 2065 6666 6563 etc.), the effec │ │ │ │ │ +0001fd20: 740a 7769 6c6c 2062 6520 7468 6520 7361 t.will be the sa │ │ │ │ │ +0001fd30: 6d65 3a20 7573 6572 2d69 6e73 7461 6c6c me: user-install │ │ │ │ │ +0001fd40: 6174 696f 6e73 2061 7265 2069 6d70 6f73 ations are impos │ │ │ │ │ +0001fd50: 7369 626c 652e 0a0a 2020 2041 7320 6120 sible... As a │ │ │ │ │ +0001fd60: 286e 6f6e 2d72 6f6f 7429 2075 7365 7220 (non-root) user │ │ │ │ │ +0001fd70: 7768 6f20 7761 6e74 7320 746f 2069 6e73 who wants to ins │ │ │ │ │ +0001fd80: 7461 6c6c 2061 2070 6163 6b61 6765 2c20 tall a package, │ │ │ │ │ +0001fd90: 796f 7520 7573 7561 6c6c 7920 6861 7665 you usually have │ │ │ │ │ +0001fda0: 0a6e 6f20 7269 6768 7420 746f 2069 6e73 .no right to ins │ │ │ │ │ +0001fdb0: 7461 6c6c 2061 6e79 7468 696e 6720 696e tall anything in │ │ │ │ │ +0001fdc0: 2027 2f75 7372 2720 6f72 2027 2f75 7372 '/usr' or '/usr │ │ │ │ │ +0001fdd0: 2f6c 6f63 616c 272e 2020 536f 2079 6f75 /local'. So you │ │ │ │ │ +0001fde0: 2064 6f0a 736f 6d65 7468 696e 6720 6c69 do.something li │ │ │ │ │ +0001fdf0: 6b65 2027 2e2f 636f 6e66 6967 7572 6520 ke './configure │ │ │ │ │ +0001fe00: 2d2d 7072 6566 6978 207e 2f75 7372 2720 --prefix ~/usr' │ │ │ │ │ +0001fe10: 746f 2069 6e73 7461 6c6c 2061 2070 6163 to install a pac │ │ │ │ │ +0001fe20: 6b61 6765 2069 6e20 796f 7572 0a6f 776e kage in your.own │ │ │ │ │ +0001fe30: 2027 7e2f 7573 7227 2074 7265 652e 0a0a '~/usr' tree... │ │ │ │ │ +0001fe40: 2020 2049 6620 6120 7061 636b 6167 6520 If a package │ │ │ │ │ +0001fe50: 6174 7465 6d70 7473 2074 6f20 696e 7374 attempts to inst │ │ │ │ │ +0001fe60: 616c 6c20 736f 6d65 7468 696e 6720 746f all something to │ │ │ │ │ +0001fe70: 2073 6f6d 6520 6861 7264 2d63 6f64 6564 some hard-coded │ │ │ │ │ +0001fe80: 2070 6174 680a 2865 2e67 2e2c 2027 2f65 path.(e.g., '/e │ │ │ │ │ +0001fe90: 7463 2f61 6669 6c65 2729 2c20 7265 6761 tc/afile'), rega │ │ │ │ │ +0001fea0: 7264 6c65 7373 206f 6620 7468 6973 2027 rdless of this ' │ │ │ │ │ +0001feb0: 2d2d 7072 6566 6978 2720 7365 7474 696e --prefix' settin │ │ │ │ │ +0001fec0: 672c 2074 6865 6e20 7468 650a 696e 7374 g, then the.inst │ │ │ │ │ +0001fed0: 616c 6c61 7469 6f6e 2077 696c 6c20 6661 allation will fa │ │ │ │ │ +0001fee0: 696c 2e20 2027 6d61 6b65 2064 6973 7463 il. 'make distc │ │ │ │ │ +0001fef0: 6865 636b 2720 7065 7266 6f72 6d73 2073 heck' performs s │ │ │ │ │ +0001ff00: 7563 6820 6120 272d 2d70 7265 6669 7827 uch a '--prefix' │ │ │ │ │ +0001ff10: 0a69 6e73 7461 6c6c 6174 696f 6e2c 2068 .installation, h │ │ │ │ │ +0001ff20: 656e 6365 2069 7420 7769 6c6c 2066 6169 ence it will fai │ │ │ │ │ +0001ff30: 6c20 746f 6f2e 0a0a 2020 204e 6f77 2c20 l too... Now, │ │ │ │ │ +0001ff40: 7468 6572 6520 6172 6520 736f 6d65 2065 there are some e │ │ │ │ │ +0001ff50: 6173 7920 736f 6c75 7469 6f6e 732e 0a0a asy solutions... │ │ │ │ │ +0001ff60: 2020 2054 6865 2061 626f 7665 2027 696e The above 'in │ │ │ │ │ +0001ff70: 7374 616c 6c2d 6461 7461 2d6c 6f63 616c stall-data-local │ │ │ │ │ +0001ff80: 2720 6578 616d 706c 6520 666f 7220 696e ' example for in │ │ │ │ │ +0001ff90: 7374 616c 6c69 6e67 2027 2f65 7463 2f61 stalling '/etc/a │ │ │ │ │ +0001ffa0: 6669 6c65 270a 776f 756c 6420 6265 2062 file'.would be b │ │ │ │ │ +0001ffb0: 6574 7465 7220 7265 706c 6163 6564 2062 etter replaced b │ │ │ │ │ +0001ffc0: 790a 0a20 2020 2020 7379 7363 6f6e 665f y.. sysconf_ │ │ │ │ │ +0001ffd0: 4441 5441 203d 2061 6669 6c65 0a0a 6279 DATA = afile..by │ │ │ │ │ +0001ffe0: 2064 6566 6175 6c74 2027 7379 7363 6f6e default 'syscon │ │ │ │ │ +0001fff0: 6664 6972 2720 7769 6c6c 2062 6520 2724 fdir' will be '$ │ │ │ │ │ +00020000: 2870 7265 6669 7829 2f65 7463 272c 2062 (prefix)/etc', b │ │ │ │ │ +00020010: 6563 6175 7365 2074 6869 7320 6973 2077 ecause this is w │ │ │ │ │ +00020020: 6861 740a 7468 6520 474e 5520 5374 616e hat.the GNU Stan │ │ │ │ │ +00020030: 6461 7264 7320 7265 7175 6972 652e 2020 dards require. │ │ │ │ │ +00020040: 5768 656e 2073 7563 6820 6120 7061 636b When such a pack │ │ │ │ │ +00020050: 6167 6520 6973 2069 6e73 7461 6c6c 6564 age is installed │ │ │ │ │ +00020060: 206f 6e20 616e 2046 4853 0a63 6f6d 706c on an FHS.compl │ │ │ │ │ +00020070: 6961 6e74 2073 7973 7465 6d2c 2074 6865 iant system, the │ │ │ │ │ +00020080: 2069 6e73 7461 6c6c 6572 2077 696c 6c20 installer will │ │ │ │ │ +00020090: 6861 7665 2074 6f20 7365 7420 272d 2d73 have to set '--s │ │ │ │ │ +000200a0: 7973 636f 6e66 6469 723d 2f65 7463 272e ysconfdir=/etc'. │ │ │ │ │ +000200b0: 0a41 7320 7468 6520 6d61 696e 7461 696e .As the maintain │ │ │ │ │ +000200c0: 6572 206f 6620 7468 6520 7061 636b 6167 er of the packag │ │ │ │ │ +000200d0: 6520 796f 7520 7368 6f75 6c64 206e 6f74 e you should not │ │ │ │ │ +000200e0: 2062 6520 636f 6e63 6572 6e65 6420 6279 be concerned by │ │ │ │ │ +000200f0: 2073 7563 680a 7369 7465 2070 6f6c 6963 such.site polic │ │ │ │ │ +00020100: 6965 733a 2075 7365 2074 6865 2061 7070 ies: use the app │ │ │ │ │ +00020110: 726f 7072 6961 7465 2073 7461 6e64 6172 ropriate standar │ │ │ │ │ +00020120: 6420 6469 7265 6374 6f72 7920 7661 7269 d directory vari │ │ │ │ │ +00020130: 6162 6c65 2074 6f0a 696e 7374 616c 6c20 able to.install │ │ │ │ │ +00020140: 796f 7572 2066 696c 6573 2073 6f20 7468 your files so th │ │ │ │ │ +00020150: 6174 2074 6865 2069 6e73 7461 6c6c 6572 at the installer │ │ │ │ │ +00020160: 2063 616e 2065 6173 696c 7920 7265 6465 can easily rede │ │ │ │ │ +00020170: 6669 6e65 2074 6865 7365 0a76 6172 6961 fine these.varia │ │ │ │ │ +00020180: 626c 6573 2074 6f20 6d61 7463 6820 7468 bles to match th │ │ │ │ │ +00020190: 6569 7220 7369 7465 2063 6f6e 7665 6e74 eir site convent │ │ │ │ │ +000201a0: 696f 6e73 2e0a 0a20 2020 496e 7374 616c ions... Instal │ │ │ │ │ +000201b0: 6c69 6e67 2066 696c 6573 2074 6861 7420 ling files that │ │ │ │ │ +000201c0: 7368 6f75 6c64 2062 6520 7573 6564 2062 should be used b │ │ │ │ │ +000201d0: 7920 616e 6f74 6865 7220 7061 636b 6167 y another packag │ │ │ │ │ +000201e0: 6520 6973 2073 6c69 6768 746c 790a 6d6f e is slightly.mo │ │ │ │ │ +000201f0: 7265 2069 6e76 6f6c 7665 642e 2020 4c65 re involved. Le │ │ │ │ │ +00020200: 7427 7320 7461 6b65 2061 6e20 6578 616d t's take an exam │ │ │ │ │ +00020210: 706c 6520 616e 6420 6173 7375 6d65 2079 ple and assume y │ │ │ │ │ +00020220: 6f75 2077 616e 7420 746f 2069 6e73 7461 ou want to insta │ │ │ │ │ +00020230: 6c6c 2061 0a73 6861 7265 6420 6c69 6272 ll a.shared libr │ │ │ │ │ +00020240: 6172 7920 7468 6174 2069 7320 6120 5079 ary that is a Py │ │ │ │ │ +00020250: 7468 6f6e 2065 7874 656e 7369 6f6e 206d thon extension m │ │ │ │ │ +00020260: 6f64 756c 652e 2020 4966 2079 6f75 2061 odule. If you a │ │ │ │ │ +00020270: 736b 2050 7974 686f 6e0a 7768 6572 6520 sk Python.where │ │ │ │ │ +00020280: 746f 2069 6e73 7461 6c6c 2074 6865 206c to install the l │ │ │ │ │ +00020290: 6962 7261 7279 2c20 6974 2077 696c 6c20 ibrary, it will │ │ │ │ │ +000202a0: 616e 7377 6572 2073 6f6d 6574 6869 6e67 answer something │ │ │ │ │ +000202b0: 206c 696b 6520 7468 6973 3a0a 0a20 2020 like this:.. │ │ │ │ │ +000202c0: 2020 2520 7079 7468 6f6e 202d 6320 2766 % python -c 'f │ │ │ │ │ +000202d0: 726f 6d20 6469 7374 7574 696c 7320 696d rom distutils im │ │ │ │ │ +000202e0: 706f 7274 2073 7973 636f 6e66 6967 3b0a port sysconfig;. │ │ │ │ │ 000202f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00020300: 2070 7269 6e74 2073 7973 636f 6e66 6967 print sysconfig │ │ │ │ │ -00020310: 2e67 6574 5f70 7974 686f 6e5f 6c69 6228 .get_python_lib( │ │ │ │ │ -00020320: 312c 3029 270a 2020 2020 202f 7573 722f 1,0)'. /usr/ │ │ │ │ │ -00020330: 6c69 622f 7079 7468 6f6e 322e 352f 7369 lib/python2.5/si │ │ │ │ │ -00020340: 7465 2d70 6163 6b61 6765 730a 0a20 2020 te-packages.. │ │ │ │ │ -00020350: 4966 2079 6f75 2069 6e64 6565 6420 7573 If you indeed us │ │ │ │ │ -00020360: 6520 7468 6973 2061 6273 6f6c 7574 6520 e this absolute │ │ │ │ │ -00020370: 7061 7468 2074 6f20 696e 7374 616c 6c20 path to install │ │ │ │ │ -00020380: 796f 7572 2073 6861 7265 6420 6c69 6272 your shared libr │ │ │ │ │ -00020390: 6172 792c 0a6e 6f6e 2d72 6f6f 7420 7573 ary,.non-root us │ │ │ │ │ -000203a0: 6572 7320 7769 6c6c 206e 6f74 2062 6520 ers will not be │ │ │ │ │ -000203b0: 6162 6c65 2074 6f20 696e 7374 616c 6c20 able to install │ │ │ │ │ -000203c0: 7468 6520 7061 636b 6167 652c 2068 656e the package, hen │ │ │ │ │ -000203d0: 6365 2064 6973 7463 6865 636b 0a66 6169 ce distcheck.fai │ │ │ │ │ -000203e0: 6c73 2e0a 0a20 2020 4c65 7427 7320 646f ls... Let's do │ │ │ │ │ -000203f0: 2062 6574 7465 722e 2020 5468 6520 2773 better. The 's │ │ │ │ │ -00020400: 7973 636f 6e66 6967 2e67 6574 5f70 7974 ysconfig.get_pyt │ │ │ │ │ -00020410: 686f 6e5f 6c69 6228 2927 2066 756e 6374 hon_lib()' funct │ │ │ │ │ -00020420: 696f 6e20 6163 7475 616c 6c79 0a61 6363 ion actually.acc │ │ │ │ │ -00020430: 6570 7473 2061 2074 6869 7264 2061 7267 epts a third arg │ │ │ │ │ -00020440: 756d 656e 7420 7468 6174 2077 696c 6c20 ument that will │ │ │ │ │ -00020450: 7265 706c 6163 6520 5079 7468 6f6e 2773 replace Python's │ │ │ │ │ -00020460: 2069 6e73 7461 6c6c 6174 696f 6e20 7072 installation pr │ │ │ │ │ -00020470: 6566 6978 2e0a 0a20 2020 2020 2520 7079 efix... % py │ │ │ │ │ -00020480: 7468 6f6e 202d 6320 2766 726f 6d20 6469 thon -c 'from di │ │ │ │ │ -00020490: 7374 7574 696c 7320 696d 706f 7274 2073 stutils import s │ │ │ │ │ -000204a0: 7973 636f 6e66 6967 3b0a 2020 2020 2020 ysconfig;. │ │ │ │ │ -000204b0: 2020 2020 2020 2020 2020 2020 7072 696e prin │ │ │ │ │ -000204c0: 7420 7379 7363 6f6e 6669 672e 6765 745f t sysconfig.get_ │ │ │ │ │ -000204d0: 7079 7468 6f6e 5f6c 6962 2831 2c30 2c22 python_lib(1,0," │ │ │ │ │ -000204e0: 247b 6578 6563 5f70 7265 6669 787d 2229 ${exec_prefix}") │ │ │ │ │ -000204f0: 270a 2020 2020 2024 7b65 7865 635f 7072 '. ${exec_pr │ │ │ │ │ -00020500: 6566 6978 7d2f 6c69 622f 7079 7468 6f6e efix}/lib/python │ │ │ │ │ -00020510: 322e 352f 7369 7465 2d70 6163 6b61 6765 2.5/site-package │ │ │ │ │ -00020520: 730a 0a20 2020 596f 7520 6361 6e20 616c s.. You can al │ │ │ │ │ -00020530: 736f 2075 7365 2074 6869 7320 6e65 7720 so use this new │ │ │ │ │ -00020540: 7061 7468 2e20 2049 6620 796f 7520 646f path. If you do │ │ │ │ │ -00020550: 0a20 2020 2a20 726f 6f74 2075 7365 7273 . * root users │ │ │ │ │ -00020560: 2063 616e 2069 6e73 7461 6c6c 2079 6f75 can install you │ │ │ │ │ -00020570: 7220 7061 636b 6167 6520 7769 7468 2074 r package with t │ │ │ │ │ -00020580: 6865 2073 616d 6520 272d 2d70 7265 6669 he same '--prefi │ │ │ │ │ -00020590: 7827 2061 730a 2020 2020 2050 7974 686f x' as. Pytho │ │ │ │ │ -000205a0: 6e20 2879 6f75 2067 6574 2074 6865 2062 n (you get the b │ │ │ │ │ -000205b0: 6568 6176 696f 7220 6f66 2074 6865 2070 ehavior of the p │ │ │ │ │ -000205c0: 7265 7669 6f75 7320 6174 7465 6d70 7429 revious attempt) │ │ │ │ │ -000205d0: 0a0a 2020 202a 206e 6f6e 2d72 6f6f 7420 .. * non-root │ │ │ │ │ -000205e0: 7573 6572 7320 6361 6e20 696e 7374 616c users can instal │ │ │ │ │ -000205f0: 6c20 796f 7572 2070 6163 6b61 6765 2074 l your package t │ │ │ │ │ -00020600: 6f6f 2c20 7468 6579 2077 696c 6c20 6861 oo, they will ha │ │ │ │ │ -00020610: 7665 2074 6865 0a20 2020 2020 6578 7465 ve the. exte │ │ │ │ │ -00020620: 6e73 696f 6e20 6d6f 6475 6c65 2069 6e20 nsion module in │ │ │ │ │ -00020630: 6120 706c 6163 6520 7468 6174 2069 7320 a place that is │ │ │ │ │ -00020640: 6e6f 7420 7365 6172 6368 6564 2062 7920 not searched by │ │ │ │ │ -00020650: 5079 7468 6f6e 2062 7574 2074 6865 790a Python but they. │ │ │ │ │ -00020660: 2020 2020 2063 616e 2077 6f72 6b20 6172 can work ar │ │ │ │ │ -00020670: 6f75 6e64 2074 6869 7320 7573 696e 6720 ound this using │ │ │ │ │ -00020680: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00020690: 6162 6c65 7320 2861 6e64 2069 6620 796f ables (and if yo │ │ │ │ │ -000206a0: 750a 2020 2020 2069 6e73 7461 6c6c 6564 u. installed │ │ │ │ │ -000206b0: 2073 6372 6970 7473 2074 6861 7420 7573 scripts that us │ │ │ │ │ -000206c0: 6520 7468 6973 2073 6861 7265 6420 6c69 e this shared li │ │ │ │ │ -000206d0: 6272 6172 792c 2069 7427 7320 6561 7379 brary, it's easy │ │ │ │ │ -000206e0: 2074 6f20 7465 6c6c 0a20 2020 2020 5079 to tell. Py │ │ │ │ │ -000206f0: 7468 6f6e 2077 6572 6520 746f 206c 6f6f thon were to loo │ │ │ │ │ -00020700: 6b20 696e 2074 6865 2062 6567 696e 6e69 k in the beginni │ │ │ │ │ -00020710: 6e67 206f 6620 796f 7572 2073 6372 6970 ng of your scrip │ │ │ │ │ -00020720: 742c 2073 6f20 7468 6520 7363 7269 7074 t, so the script │ │ │ │ │ -00020730: 0a20 2020 2020 776f 726b 7320 696e 2062 . works in b │ │ │ │ │ -00020740: 6f74 6820 6361 7365 7329 2e0a 0a20 2020 oth cases)... │ │ │ │ │ -00020750: 5468 6520 2741 4d5f 5041 5448 5f50 5954 The 'AM_PATH_PYT │ │ │ │ │ -00020760: 484f 4e27 206d 6163 726f 2075 7365 7320 HON' macro uses │ │ │ │ │ -00020770: 7369 6d69 6c61 7220 636f 6d6d 616e 6473 similar commands │ │ │ │ │ -00020780: 2074 6f20 6465 6669 6e65 0a27 2428 7079 to define.'$(py │ │ │ │ │ -00020790: 7468 6f6e 6469 7229 2720 616e 6420 2724 thondir)' and '$ │ │ │ │ │ -000207a0: 2870 7965 7865 6364 6972 2927 2028 2a6e (pyexecdir)' (*n │ │ │ │ │ -000207b0: 6f74 6520 5079 7468 6f6e 3a3a 292e 0a0a ote Python::)... │ │ │ │ │ -000207c0: 2020 204f 6620 636f 7572 7365 206e 6f74 Of course not │ │ │ │ │ -000207d0: 2061 6c6c 2074 6f6f 6c73 2061 7265 2061 all tools are a │ │ │ │ │ -000207e0: 7320 6164 7661 6e63 6564 2061 7320 5079 s advanced as Py │ │ │ │ │ -000207f0: 7468 6f6e 2072 6567 6172 6469 6e67 2074 thon regarding t │ │ │ │ │ -00020800: 6861 740a 7375 6273 7469 7475 7469 6f6e hat.substitution │ │ │ │ │ -00020810: 206f 6620 5052 4546 4958 2e20 2053 6f20 of PREFIX. So │ │ │ │ │ -00020820: 616e 6f74 6865 7220 7374 7261 7465 6779 another strategy │ │ │ │ │ -00020830: 2069 7320 746f 2066 6967 7572 6520 7468 is to figure th │ │ │ │ │ -00020840: 6520 7061 7274 206f 660a 7468 6520 696e e part of.the in │ │ │ │ │ -00020850: 7374 616c 6c61 7469 6f6e 2064 6972 6563 stallation direc │ │ │ │ │ -00020860: 746f 7279 2074 6861 7420 6d75 7374 2062 tory that must b │ │ │ │ │ -00020870: 6520 7072 6573 6572 7665 642e 2020 466f e preserved. Fo │ │ │ │ │ -00020880: 7220 696e 7374 616e 6365 2c20 6865 7265 r instance, here │ │ │ │ │ -00020890: 0a69 7320 686f 7720 2741 4d5f 5041 5448 .is how 'AM_PATH │ │ │ │ │ -000208a0: 5f4c 4953 5044 4952 2720 282a 6e6f 7465 _LISPDIR' (*note │ │ │ │ │ -000208b0: 2045 6d61 6373 204c 6973 703a 3a29 2063 Emacs Lisp::) c │ │ │ │ │ -000208c0: 6f6d 7075 7465 7320 2724 286c 6973 7064 omputes '$(lispd │ │ │ │ │ -000208d0: 6972 2927 3a0a 0a20 2020 2020 2445 4d41 ir)':.. $EMA │ │ │ │ │ -000208e0: 4353 202d 6261 7463 6820 2d71 202d 6576 CS -batch -q -ev │ │ │ │ │ -000208f0: 616c 2027 2877 6869 6c65 206c 6f61 642d al '(while load- │ │ │ │ │ -00020900: 7061 7468 0a20 2020 2020 2020 2870 7269 path. (pri │ │ │ │ │ -00020910: 6e63 2028 636f 6e63 6174 2028 6361 7220 nc (concat (car │ │ │ │ │ -00020920: 6c6f 6164 2d70 6174 6829 2022 5c6e 2229 load-path) "\n") │ │ │ │ │ -00020930: 290a 2020 2020 2020 2028 7365 7471 206c ). (setq l │ │ │ │ │ -00020940: 6f61 642d 7061 7468 2028 6364 7220 6c6f oad-path (cdr lo │ │ │ │ │ -00020950: 6164 2d70 6174 6829 2929 2720 3e63 6f6e ad-path)))' >con │ │ │ │ │ -00020960: 6674 6573 742e 6f75 740a 2020 2020 206c ftest.out. l │ │ │ │ │ -00020970: 6973 7064 6972 3d60 7365 6420 2d6e 0a20 ispdir=`sed -n. │ │ │ │ │ -00020980: 2020 2020 2020 2d65 2027 732c 2f24 2c2c -e 's,/$,, │ │ │ │ │ -00020990: 270a 2020 2020 2020 202d 6520 272f 2e2a '. -e '/.* │ │ │ │ │ -000209a0: 5c2f 6c69 625c 2f78 2a65 6d61 6373 5c2f \/lib\/x*emacs\/ │ │ │ │ │ -000209b0: 7369 7465 2d6c 6973 7024 2f7b 0a20 2020 site-lisp$/{. │ │ │ │ │ -000209c0: 2020 2020 2020 2020 2020 732c 2e2a 2f6c s,.*/l │ │ │ │ │ -000209d0: 6962 2f5c 2878 2a65 6d61 6373 2f73 6974 ib/\(x*emacs/sit │ │ │ │ │ -000209e0: 652d 6c69 7370 5c29 242c 247b 6c69 6264 e-lisp\)$,${libd │ │ │ │ │ -000209f0: 6972 7d2f 5c31 2c3b 703b 713b 0a20 2020 ir}/\1,;p;q;. │ │ │ │ │ -00020a00: 2020 2020 2020 2020 7d27 0a20 2020 2020 }'. │ │ │ │ │ -00020a10: 2020 2d65 2027 2f2e 2a5c 2f73 6861 7265 -e '/.*\/share │ │ │ │ │ -00020a20: 5c2f 782a 656d 6163 735c 2f73 6974 652d \/x*emacs\/site- │ │ │ │ │ -00020a30: 6c69 7370 242f 7b0a 2020 2020 2020 2020 lisp$/{. │ │ │ │ │ -00020a40: 2020 2020 2073 2c2e 2a2f 7368 6172 652f s,.*/share/ │ │ │ │ │ -00020a50: 5c28 782a 656d 6163 732f 7369 7465 2d6c \(x*emacs/site-l │ │ │ │ │ -00020a60: 6973 705c 292c 247b 6461 7461 726f 6f74 isp\),${dataroot │ │ │ │ │ -00020a70: 6469 727d 2f5c 312c 3b70 3b71 3b0a 2020 dir}/\1,;p;q;. │ │ │ │ │ -00020a80: 2020 2020 2020 2020 207d 270a 2020 2020 }'. │ │ │ │ │ -00020a90: 2020 2063 6f6e 6674 6573 742e 6f75 7460 conftest.out` │ │ │ │ │ -00020aa0: 0a0a 2020 2049 2e65 2e2c 2069 7420 6a75 .. I.e., it ju │ │ │ │ │ -00020ab0: 7374 2070 6963 6b73 2074 6865 2066 6972 st picks the fir │ │ │ │ │ -00020ac0: 7374 2064 6972 6563 746f 7279 2074 6861 st directory tha │ │ │ │ │ -00020ad0: 7420 6c6f 6f6b 7320 6c69 6b65 0a27 2a2f t looks like.'*/ │ │ │ │ │ -00020ae0: 6c69 622f 2a65 6d61 6373 2f73 6974 652d lib/*emacs/site- │ │ │ │ │ -00020af0: 6c69 7370 2720 6f72 2027 2a2f 7368 6172 lisp' or '*/shar │ │ │ │ │ -00020b00: 652f 2a65 6d61 6373 2f73 6974 652d 6c69 e/*emacs/site-li │ │ │ │ │ -00020b10: 7370 2720 696e 2074 6865 2073 6561 7263 sp' in the searc │ │ │ │ │ -00020b20: 680a 7061 7468 206f 6620 656d 6163 732c h.path of emacs, │ │ │ │ │ -00020b30: 2061 6e64 2074 6865 6e20 7375 6273 7469 and then substi │ │ │ │ │ -00020b40: 7475 7465 7320 2724 7b6c 6962 6469 727d tutes '${libdir} │ │ │ │ │ -00020b50: 2720 6f72 2027 247b 6461 7461 6469 727d ' or '${datadir} │ │ │ │ │ -00020b60: 270a 6170 7072 6f70 7269 6174 656c 792e '.appropriately. │ │ │ │ │ -00020b70: 0a0a 2020 2054 6865 2065 6d61 6373 2063 .. The emacs c │ │ │ │ │ -00020b80: 6173 6520 6c6f 6f6b 7320 636f 6d70 6c69 ase looks compli │ │ │ │ │ -00020b90: 6361 7465 6420 6265 6361 7573 6520 6974 cated because it │ │ │ │ │ -00020ba0: 2070 726f 6365 7373 6573 2061 206c 6973 processes a lis │ │ │ │ │ -00020bb0: 7420 616e 640a 6578 7065 6374 7320 7477 t and.expects tw │ │ │ │ │ -00020bc0: 6f20 706f 7373 6962 6c65 206c 6179 6f75 o possible layou │ │ │ │ │ -00020bd0: 7473 2c20 6f74 6865 7277 6973 6520 6974 ts, otherwise it │ │ │ │ │ -00020be0: 2773 2065 6173 792c 2061 6e64 2074 6865 's easy, and the │ │ │ │ │ -00020bf0: 2062 656e 6566 6974 7320 666f 720a 6e6f benefits for.no │ │ │ │ │ -00020c00: 6e2d 726f 6f74 2075 7365 7273 2061 7265 n-root users are │ │ │ │ │ -00020c10: 2072 6561 6c6c 7920 776f 7274 6820 7468 really worth th │ │ │ │ │ -00020c20: 6520 6578 7472 6120 2773 6564 2720 696e e extra 'sed' in │ │ │ │ │ -00020c30: 766f 6361 7469 6f6e 2e0a 0a1f 0a46 696c vocation.....Fil │ │ │ │ │ -00020c40: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -00020c50: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4465 .info, Node: De │ │ │ │ │ -00020c60: 6275 6767 696e 6720 4d61 6b65 2052 756c bugging Make Rul │ │ │ │ │ -00020c70: 6573 2c20 204e 6578 743a 2052 6570 6f72 es, Next: Repor │ │ │ │ │ -00020c80: 7469 6e67 2042 7567 732c 2020 5072 6576 ting Bugs, Prev │ │ │ │ │ -00020c90: 3a20 4861 7264 2d43 6f64 6564 2049 6e73 : Hard-Coded Ins │ │ │ │ │ -00020ca0: 7461 6c6c 2050 6174 6873 2c20 2055 703a tall Paths, Up: │ │ │ │ │ -00020cb0: 2046 4151 0a0a 3238 2e31 3120 4465 6275 FAQ..28.11 Debu │ │ │ │ │ -00020cc0: 6767 696e 6720 4d61 6b65 2052 756c 6573 gging Make Rules │ │ │ │ │ -00020cd0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ -00020ce0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ │ -00020cf0: 2072 756c 6573 2061 6e64 2064 6570 656e rules and depen │ │ │ │ │ -00020d00: 6465 6e63 7920 7472 6565 7320 6765 6e65 dency trees gene │ │ │ │ │ -00020d10: 7261 7465 6420 6279 2027 6175 746f 6d61 rated by 'automa │ │ │ │ │ -00020d20: 6b65 2720 6361 6e20 6765 7420 7261 7468 ke' can get rath │ │ │ │ │ -00020d30: 6572 0a63 6f6d 706c 6578 2c20 616e 6420 er.complex, and │ │ │ │ │ -00020d40: 6c65 6176 6520 7468 6520 6465 7665 6c6f leave the develo │ │ │ │ │ -00020d50: 7065 7220 6865 6164 2d73 6372 6174 6368 per head-scratch │ │ │ │ │ -00020d60: 696e 6720 7768 656e 2074 6869 6e67 7320 ing when things │ │ │ │ │ -00020d70: 646f 6e27 7420 776f 726b 0a61 7320 6578 don't work.as ex │ │ │ │ │ -00020d80: 7065 6374 6564 2e20 2042 6573 6964 6573 pected. Besides │ │ │ │ │ -00020d90: 2074 6865 2064 6562 7567 206f 7074 696f the debug optio │ │ │ │ │ -00020da0: 6e73 2070 726f 7669 6465 6420 6279 2074 ns provided by t │ │ │ │ │ -00020db0: 6865 2027 6d61 6b65 2720 636f 6d6d 616e he 'make' comman │ │ │ │ │ -00020dc0: 640a 282a 6e6f 7465 2028 6d61 6b65 294f d.(*note (make)O │ │ │ │ │ -00020dd0: 7074 696f 6e73 2053 756d 6d61 7279 3a3a ptions Summary:: │ │ │ │ │ -00020de0: 292c 2068 6572 6527 7320 6120 636f 7570 ), here's a coup │ │ │ │ │ -00020df0: 6c65 206f 6620 6675 7274 6865 7220 6869 le of further hi │ │ │ │ │ -00020e00: 6e74 7320 666f 720a 6465 6275 6767 696e nts for.debuggin │ │ │ │ │ -00020e10: 6720 6d61 6b65 6669 6c65 7320 6765 6e65 g makefiles gene │ │ │ │ │ -00020e20: 7261 7465 6420 6279 2027 6175 746f 6d61 rated by 'automa │ │ │ │ │ -00020e30: 6b65 2720 6566 6665 6374 6976 656c 793a ke' effectively: │ │ │ │ │ -00020e40: 0a0a 2020 202a 2049 6620 6c65 7373 2076 .. * If less v │ │ │ │ │ -00020e50: 6572 626f 7365 206f 7574 7075 7420 6861 erbose output ha │ │ │ │ │ -00020e60: 7320 6265 656e 2065 6e61 626c 6564 2069 s been enabled i │ │ │ │ │ -00020e70: 6e20 7468 6520 7061 636b 6167 6520 7769 n the package wi │ │ │ │ │ -00020e80: 7468 2074 6865 0a20 2020 2020 2773 696c th the. 'sil │ │ │ │ │ -00020e90: 656e 742d 7275 6c65 7327 206f 7074 696f ent-rules' optio │ │ │ │ │ -00020ea0: 6e20 282a 6e6f 7465 204f 7074 696f 6e73 n (*note Options │ │ │ │ │ -00020eb0: 3a3a 292c 2079 6f75 2063 616e 2075 7365 ::), you can use │ │ │ │ │ -00020ec0: 2027 6d61 6b65 2056 3d31 2720 746f 0a20 'make V=1' to. │ │ │ │ │ -00020ed0: 2020 2020 7365 6520 7468 6520 636f 6d6d see the comm │ │ │ │ │ -00020ee0: 616e 6473 2062 6569 6e67 2065 7865 6375 ands being execu │ │ │ │ │ -00020ef0: 7465 642e 0a20 2020 2a20 276d 616b 6520 ted.. * 'make │ │ │ │ │ -00020f00: 2d6e 2720 6361 6e20 6865 6c70 2073 686f -n' can help sho │ │ │ │ │ -00020f10: 7720 7768 6174 2077 6f75 6c64 2062 6520 w what would be │ │ │ │ │ -00020f20: 646f 6e65 2077 6974 686f 7574 2061 6374 done without act │ │ │ │ │ -00020f30: 7561 6c6c 7920 646f 696e 670a 2020 2020 ually doing. │ │ │ │ │ -00020f40: 2069 742e 2020 4e6f 7465 2068 6f77 6576 it. Note howev │ │ │ │ │ -00020f50: 6572 2c20 7468 6174 2074 6869 7320 7769 er, that this wi │ │ │ │ │ -00020f60: 6c6c 205f 7374 696c 6c20 6578 6563 7574 ll _still execut │ │ │ │ │ -00020f70: 655f 2063 6f6d 6d61 6e64 7320 7072 6566 e_ commands pref │ │ │ │ │ -00020f80: 6978 6564 0a20 2020 2020 7769 7468 2027 ixed. with ' │ │ │ │ │ -00020f90: 2b27 2c20 616e 642c 2077 6865 6e20 7573 +', and, when us │ │ │ │ │ -00020fa0: 696e 6720 474e 5520 276d 616b 6527 2c20 ing GNU 'make', │ │ │ │ │ -00020fb0: 636f 6d6d 616e 6473 2074 6861 7420 636f commands that co │ │ │ │ │ -00020fc0: 6e74 6169 6e20 7468 650a 2020 2020 2073 ntain the. s │ │ │ │ │ -00020fd0: 7472 696e 6773 2027 2428 4d41 4b45 2927 trings '$(MAKE)' │ │ │ │ │ -00020fe0: 206f 7220 2724 7b4d 414b 457d 2720 282a or '${MAKE}' (* │ │ │ │ │ -00020ff0: 6e6f 7465 2028 6d61 6b65 2949 6e73 7465 note (make)Inste │ │ │ │ │ -00021000: 6164 206f 660a 2020 2020 2045 7865 6375 ad of. Execu │ │ │ │ │ -00021010: 7469 6f6e 3a3a 292e 2020 5479 7069 6361 tion::). Typica │ │ │ │ │ -00021020: 6c6c 792c 2074 6869 7320 6973 2068 656c lly, this is hel │ │ │ │ │ -00021030: 7066 756c 2074 6f20 7368 6f77 2077 6861 pful to show wha │ │ │ │ │ -00021040: 7420 7265 6375 7273 6976 650a 2020 2020 t recursive. │ │ │ │ │ -00021050: 2072 756c 6573 2077 6f75 6c64 2064 6f2c rules would do, │ │ │ │ │ -00021060: 2062 7574 2069 7420 6d65 616e 7320 7468 but it means th │ │ │ │ │ -00021070: 6174 2c20 696e 2079 6f75 7220 6f77 6e20 at, in your own │ │ │ │ │ -00021080: 7275 6c65 732c 2079 6f75 2073 686f 756c rules, you shoul │ │ │ │ │ -00021090: 640a 2020 2020 206e 6f74 206d 6978 2073 d. not mix s │ │ │ │ │ -000210a0: 7563 6820 7265 6375 7273 696f 6e20 7769 uch recursion wi │ │ │ │ │ -000210b0: 7468 2061 6374 696f 6e73 2074 6861 7420 th actions that │ │ │ │ │ -000210c0: 6368 616e 6765 2061 6e79 2066 696c 6573 change any files │ │ │ │ │ -000210d0: 2e28 3129 0a20 2020 2020 4675 7274 6865 .(1). Furthe │ │ │ │ │ -000210e0: 726d 6f72 652c 206e 6f74 6520 7468 6174 rmore, note that │ │ │ │ │ -000210f0: 2047 4e55 2027 6d61 6b65 2720 7769 6c6c GNU 'make' will │ │ │ │ │ -00021100: 2075 7064 6174 6520 7072 6572 6571 7569 update prerequi │ │ │ │ │ -00021110: 7369 7465 7320 666f 7220 7468 650a 2020 sites for the. │ │ │ │ │ -00021120: 2020 2027 4d61 6b65 6669 6c65 2720 6669 'Makefile' fi │ │ │ │ │ -00021130: 6c65 2069 7473 656c 6620 6576 656e 2077 le itself even w │ │ │ │ │ -00021140: 6974 6820 272d 6e27 2028 2a6e 6f74 6520 ith '-n' (*note │ │ │ │ │ -00021150: 286d 616b 6529 5265 6d61 6b69 6e67 0a20 (make)Remaking. │ │ │ │ │ -00021160: 2020 2020 4d61 6b65 6669 6c65 733a 3a29 Makefiles::) │ │ │ │ │ -00021170: 2e0a 2020 202a 2027 6d61 6b65 2053 4845 .. * 'make SHE │ │ │ │ │ -00021180: 4c4c 3d22 2f62 696e 2f62 6173 6820 2d76 LL="/bin/bash -v │ │ │ │ │ -00021190: 7822 2720 6361 6e20 6865 6c70 2064 6562 x"' can help deb │ │ │ │ │ -000211a0: 7567 2063 6f6d 706c 6578 2072 756c 6573 ug complex rules │ │ │ │ │ -000211b0: 2e20 202a 4e6f 7465 0a20 2020 2020 2861 . *Note. (a │ │ │ │ │ -000211c0: 7574 6f63 6f6e 6629 5468 6520 4d61 6b65 utoconf)The Make │ │ │ │ │ -000211d0: 204d 6163 726f 2053 4845 4c4c 3a3a 2c20 Macro SHELL::, │ │ │ │ │ -000211e0: 666f 7220 736f 6d65 2070 6f72 7461 6269 for some portabi │ │ │ │ │ -000211f0: 6c69 7479 2071 7569 726b 730a 2020 2020 lity quirks. │ │ │ │ │ -00021200: 2061 7373 6f63 6961 7465 6420 7769 7468 associated with │ │ │ │ │ -00021210: 2074 6869 7320 636f 6e73 7472 7563 742e this construct. │ │ │ │ │ -00021220: 0a20 2020 2a20 2765 6368 6f20 2770 7269 . * 'echo 'pri │ │ │ │ │ -00021230: 6e74 3a20 3b20 4065 6368 6f20 2224 2856 nt: ; @echo "$(V │ │ │ │ │ -00021240: 4152 2922 2720 7c20 6d61 6b65 202d 6620 AR)"' | make -f │ │ │ │ │ -00021250: 4d61 6b65 6669 6c65 202d 6620 2d20 7072 Makefile -f - pr │ │ │ │ │ -00021260: 696e 7427 2063 616e 0a20 2020 2020 6265 int' can. be │ │ │ │ │ -00021270: 2068 616e 6479 2074 6f20 6578 616d 696e handy to examin │ │ │ │ │ -00021280: 6520 7468 6520 6578 7061 6e64 6564 2076 e the expanded v │ │ │ │ │ -00021290: 616c 7565 206f 6620 7661 7269 6162 6c65 alue of variable │ │ │ │ │ -000212a0: 732e 2020 596f 7520 6d61 7920 6e65 6564 s. You may need │ │ │ │ │ -000212b0: 0a20 2020 2020 746f 2075 7365 2061 2074 . to use a t │ │ │ │ │ -000212c0: 6172 6765 7420 6f74 6865 7220 7468 616e arget other than │ │ │ │ │ -000212d0: 2027 7072 696e 7427 2069 6620 7468 6174 'print' if that │ │ │ │ │ -000212e0: 2069 7320 616c 7265 6164 7920 7573 6564 is already used │ │ │ │ │ -000212f0: 206f 7220 610a 2020 2020 2066 696c 6520 or a. file │ │ │ │ │ -00021300: 7769 7468 2074 6861 7420 6e61 6d65 2065 with that name e │ │ │ │ │ -00021310: 7869 7374 732e 0a20 2020 2a20 3c68 7474 xists.. * provides a m │ │ │ │ │ -00021350: 6f64 6966 6965 6420 474e 550a 2020 2020 odified GNU. │ │ │ │ │ -00021360: 2027 6d61 6b65 2720 636f 6d6d 616e 6420 'make' command │ │ │ │ │ -00021370: 6361 6c6c 6564 2027 7265 6d61 6b65 2720 called 'remake' │ │ │ │ │ -00021380: 7468 6174 2063 6f70 6573 2077 6974 6820 that copes with │ │ │ │ │ -00021390: 636f 6d70 6c65 7820 474e 550a 2020 2020 complex GNU. │ │ │ │ │ -000213a0: 2027 6d61 6b65 272d 7370 6563 6966 6963 'make'-specific │ │ │ │ │ -000213b0: 204d 616b 6566 696c 6573 2061 6e64 2061 Makefiles and a │ │ │ │ │ -000213c0: 6c6c 6f77 7320 746f 2074 7261 6365 2065 llows to trace e │ │ │ │ │ -000213d0: 7865 6375 7469 6f6e 2c20 6578 616d 696e xecution, examin │ │ │ │ │ -000213e0: 650a 2020 2020 2076 6172 6961 626c 6573 e. variables │ │ │ │ │ -000213f0: 2c20 616e 6420 6361 6c6c 2072 756c 6573 , and call rules │ │ │ │ │ -00021400: 2069 6e74 6572 6163 7469 7665 6c79 2c20 interactively, │ │ │ │ │ -00021410: 6d75 6368 206c 696b 6520 6120 6465 6275 much like a debu │ │ │ │ │ -00021420: 6767 6572 2e0a 0a20 2020 2d2d 2d2d 2d2d gger... ------ │ │ │ │ │ -00021430: 2d2d 2d2d 2046 6f6f 746e 6f74 6573 202d ---- Footnotes - │ │ │ │ │ -00021440: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2831 ---------.. (1 │ │ │ │ │ -00021450: 2920 4175 746f 6d61 6b65 2773 2027 6469 ) Automake's 'di │ │ │ │ │ -00021460: 7374 2720 616e 6420 2764 6973 7463 6865 st' and 'distche │ │ │ │ │ -00021470: 636b 2720 7275 6c65 7320 6861 6420 6120 ck' rules had a │ │ │ │ │ -00021480: 6275 6720 696e 2074 6869 7320 7265 6761 bug in this rega │ │ │ │ │ -00021490: 7264 0a69 6e20 7468 6174 2074 6865 7920 rd.in that they │ │ │ │ │ -000214a0: 6372 6561 7465 6420 6469 7265 6374 6f72 created director │ │ │ │ │ -000214b0: 6965 7320 6576 656e 2077 6974 6820 272d ies even with '- │ │ │ │ │ -000214c0: 6e27 2c20 6275 7420 7468 6973 2068 6173 n', but this has │ │ │ │ │ -000214d0: 2062 6565 6e20 6669 7865 640a 696e 2041 been fixed.in A │ │ │ │ │ -000214e0: 7574 6f6d 616b 6520 312e 3131 2e0a 0a1f utomake 1.11.... │ │ │ │ │ -000214f0: 0a46 696c 653a 2061 7574 6f6d 616b 652d .File: automake- │ │ │ │ │ -00021500: 312e 3131 2e69 6e66 6f2c 2020 4e6f 6465 1.11.info, Node │ │ │ │ │ -00021510: 3a20 5265 706f 7274 696e 6720 4275 6773 : Reporting Bugs │ │ │ │ │ -00021520: 2c20 2050 7265 763a 2044 6562 7567 6769 , Prev: Debuggi │ │ │ │ │ -00021530: 6e67 204d 616b 6520 5275 6c65 732c 2020 ng Make Rules, │ │ │ │ │ -00021540: 5570 3a20 4641 510a 0a32 382e 3132 2052 Up: FAQ..28.12 R │ │ │ │ │ -00021550: 6570 6f72 7469 6e67 2042 7567 730a 3d3d eporting Bugs.== │ │ │ │ │ +00020300: 2020 7072 696e 7420 7379 7363 6f6e 6669 print sysconfi │ │ │ │ │ +00020310: 672e 6765 745f 7079 7468 6f6e 5f6c 6962 g.get_python_lib │ │ │ │ │ +00020320: 2831 2c30 2927 0a20 2020 2020 2f75 7372 (1,0)'. /usr │ │ │ │ │ +00020330: 2f6c 6962 2f70 7974 686f 6e32 2e35 2f73 /lib/python2.5/s │ │ │ │ │ +00020340: 6974 652d 7061 636b 6167 6573 0a0a 2020 ite-packages.. │ │ │ │ │ +00020350: 2049 6620 796f 7520 696e 6465 6564 2075 If you indeed u │ │ │ │ │ +00020360: 7365 2074 6869 7320 6162 736f 6c75 7465 se this absolute │ │ │ │ │ +00020370: 2070 6174 6820 746f 2069 6e73 7461 6c6c path to install │ │ │ │ │ +00020380: 2079 6f75 7220 7368 6172 6564 206c 6962 your shared lib │ │ │ │ │ +00020390: 7261 7279 2c0a 6e6f 6e2d 726f 6f74 2075 rary,.non-root u │ │ │ │ │ +000203a0: 7365 7273 2077 696c 6c20 6e6f 7420 6265 sers will not be │ │ │ │ │ +000203b0: 2061 626c 6520 746f 2069 6e73 7461 6c6c able to install │ │ │ │ │ +000203c0: 2074 6865 2070 6163 6b61 6765 2c20 6865 the package, he │ │ │ │ │ +000203d0: 6e63 6520 6469 7374 6368 6563 6b0a 6661 nce distcheck.fa │ │ │ │ │ +000203e0: 696c 732e 0a0a 2020 204c 6574 2773 2064 ils... Let's d │ │ │ │ │ +000203f0: 6f20 6265 7474 6572 2e20 2054 6865 2027 o better. The ' │ │ │ │ │ +00020400: 7379 7363 6f6e 6669 672e 6765 745f 7079 sysconfig.get_py │ │ │ │ │ +00020410: 7468 6f6e 5f6c 6962 2829 2720 6675 6e63 thon_lib()' func │ │ │ │ │ +00020420: 7469 6f6e 2061 6374 7561 6c6c 790a 6163 tion actually.ac │ │ │ │ │ +00020430: 6365 7074 7320 6120 7468 6972 6420 6172 cepts a third ar │ │ │ │ │ +00020440: 6775 6d65 6e74 2074 6861 7420 7769 6c6c gument that will │ │ │ │ │ +00020450: 2072 6570 6c61 6365 2050 7974 686f 6e27 replace Python' │ │ │ │ │ +00020460: 7320 696e 7374 616c 6c61 7469 6f6e 2070 s installation p │ │ │ │ │ +00020470: 7265 6669 782e 0a0a 2020 2020 2025 2070 refix... % p │ │ │ │ │ +00020480: 7974 686f 6e20 2d63 2027 6672 6f6d 2064 ython -c 'from d │ │ │ │ │ +00020490: 6973 7475 7469 6c73 2069 6d70 6f72 7420 istutils import │ │ │ │ │ +000204a0: 7379 7363 6f6e 6669 673b 0a20 2020 2020 sysconfig;. │ │ │ │ │ +000204b0: 2020 2020 2020 2020 2020 2020 2070 7269 pri │ │ │ │ │ +000204c0: 6e74 2073 7973 636f 6e66 6967 2e67 6574 nt sysconfig.get │ │ │ │ │ +000204d0: 5f70 7974 686f 6e5f 6c69 6228 312c 302c _python_lib(1,0, │ │ │ │ │ +000204e0: 2224 7b65 7865 635f 7072 6566 6978 7d22 "${exec_prefix}" │ │ │ │ │ +000204f0: 2927 0a20 2020 2020 247b 6578 6563 5f70 )'. ${exec_p │ │ │ │ │ +00020500: 7265 6669 787d 2f6c 6962 2f70 7974 686f refix}/lib/pytho │ │ │ │ │ +00020510: 6e32 2e35 2f73 6974 652d 7061 636b 6167 n2.5/site-packag │ │ │ │ │ +00020520: 6573 0a0a 2020 2059 6f75 2063 616e 2061 es.. You can a │ │ │ │ │ +00020530: 6c73 6f20 7573 6520 7468 6973 206e 6577 lso use this new │ │ │ │ │ +00020540: 2070 6174 682e 2020 4966 2079 6f75 2064 path. If you d │ │ │ │ │ +00020550: 6f0a 2020 202a 2072 6f6f 7420 7573 6572 o. * root user │ │ │ │ │ +00020560: 7320 6361 6e20 696e 7374 616c 6c20 796f s can install yo │ │ │ │ │ +00020570: 7572 2070 6163 6b61 6765 2077 6974 6820 ur package with │ │ │ │ │ +00020580: 7468 6520 7361 6d65 2027 2d2d 7072 6566 the same '--pref │ │ │ │ │ +00020590: 6978 2720 6173 0a20 2020 2020 5079 7468 ix' as. Pyth │ │ │ │ │ +000205a0: 6f6e 2028 796f 7520 6765 7420 7468 6520 on (you get the │ │ │ │ │ +000205b0: 6265 6861 7669 6f72 206f 6620 7468 6520 behavior of the │ │ │ │ │ +000205c0: 7072 6576 696f 7573 2061 7474 656d 7074 previous attempt │ │ │ │ │ +000205d0: 290a 0a20 2020 2a20 6e6f 6e2d 726f 6f74 ).. * non-root │ │ │ │ │ +000205e0: 2075 7365 7273 2063 616e 2069 6e73 7461 users can insta │ │ │ │ │ +000205f0: 6c6c 2079 6f75 7220 7061 636b 6167 6520 ll your package │ │ │ │ │ +00020600: 746f 6f2c 2074 6865 7920 7769 6c6c 2068 too, they will h │ │ │ │ │ +00020610: 6176 6520 7468 650a 2020 2020 2065 7874 ave the. ext │ │ │ │ │ +00020620: 656e 7369 6f6e 206d 6f64 756c 6520 696e ension module in │ │ │ │ │ +00020630: 2061 2070 6c61 6365 2074 6861 7420 6973 a place that is │ │ │ │ │ +00020640: 206e 6f74 2073 6561 7263 6865 6420 6279 not searched by │ │ │ │ │ +00020650: 2050 7974 686f 6e20 6275 7420 7468 6579 Python but they │ │ │ │ │ +00020660: 0a20 2020 2020 6361 6e20 776f 726b 2061 . can work a │ │ │ │ │ +00020670: 726f 756e 6420 7468 6973 2075 7369 6e67 round this using │ │ │ │ │ +00020680: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +00020690: 6961 626c 6573 2028 616e 6420 6966 2079 iables (and if y │ │ │ │ │ +000206a0: 6f75 0a20 2020 2020 696e 7374 616c 6c65 ou. installe │ │ │ │ │ +000206b0: 6420 7363 7269 7074 7320 7468 6174 2075 d scripts that u │ │ │ │ │ +000206c0: 7365 2074 6869 7320 7368 6172 6564 206c se this shared l │ │ │ │ │ +000206d0: 6962 7261 7279 2c20 6974 2773 2065 6173 ibrary, it's eas │ │ │ │ │ +000206e0: 7920 746f 2074 656c 6c0a 2020 2020 2050 y to tell. P │ │ │ │ │ +000206f0: 7974 686f 6e20 7765 7265 2074 6f20 6c6f ython were to lo │ │ │ │ │ +00020700: 6f6b 2069 6e20 7468 6520 6265 6769 6e6e ok in the beginn │ │ │ │ │ +00020710: 696e 6720 6f66 2079 6f75 7220 7363 7269 ing of your scri │ │ │ │ │ +00020720: 7074 2c20 736f 2074 6865 2073 6372 6970 pt, so the scrip │ │ │ │ │ +00020730: 740a 2020 2020 2077 6f72 6b73 2069 6e20 t. works in │ │ │ │ │ +00020740: 626f 7468 2063 6173 6573 292e 0a0a 2020 both cases)... │ │ │ │ │ +00020750: 2054 6865 2027 414d 5f50 4154 485f 5059 The 'AM_PATH_PY │ │ │ │ │ +00020760: 5448 4f4e 2720 6d61 6372 6f20 7573 6573 THON' macro uses │ │ │ │ │ +00020770: 2073 696d 696c 6172 2063 6f6d 6d61 6e64 similar command │ │ │ │ │ +00020780: 7320 746f 2064 6566 696e 650a 2724 2870 s to define.'$(p │ │ │ │ │ +00020790: 7974 686f 6e64 6972 2927 2061 6e64 2027 ythondir)' and ' │ │ │ │ │ +000207a0: 2428 7079 6578 6563 6469 7229 2720 282a $(pyexecdir)' (* │ │ │ │ │ +000207b0: 6e6f 7465 2050 7974 686f 6e3a 3a29 2e0a note Python::).. │ │ │ │ │ +000207c0: 0a20 2020 4f66 2063 6f75 7273 6520 6e6f . Of course no │ │ │ │ │ +000207d0: 7420 616c 6c20 746f 6f6c 7320 6172 6520 t all tools are │ │ │ │ │ +000207e0: 6173 2061 6476 616e 6365 6420 6173 2050 as advanced as P │ │ │ │ │ +000207f0: 7974 686f 6e20 7265 6761 7264 696e 6720 ython regarding │ │ │ │ │ +00020800: 7468 6174 0a73 7562 7374 6974 7574 696f that.substitutio │ │ │ │ │ +00020810: 6e20 6f66 2050 5245 4649 582e 2020 536f n of PREFIX. So │ │ │ │ │ +00020820: 2061 6e6f 7468 6572 2073 7472 6174 6567 another strateg │ │ │ │ │ +00020830: 7920 6973 2074 6f20 6669 6775 7265 2074 y is to figure t │ │ │ │ │ +00020840: 6865 2070 6172 7420 6f66 0a74 6865 2069 he part of.the i │ │ │ │ │ +00020850: 6e73 7461 6c6c 6174 696f 6e20 6469 7265 nstallation dire │ │ │ │ │ +00020860: 6374 6f72 7920 7468 6174 206d 7573 7420 ctory that must │ │ │ │ │ +00020870: 6265 2070 7265 7365 7276 6564 2e20 2046 be preserved. F │ │ │ │ │ +00020880: 6f72 2069 6e73 7461 6e63 652c 2068 6572 or instance, her │ │ │ │ │ +00020890: 650a 6973 2068 6f77 2027 414d 5f50 4154 e.is how 'AM_PAT │ │ │ │ │ +000208a0: 485f 4c49 5350 4449 5227 2028 2a6e 6f74 H_LISPDIR' (*not │ │ │ │ │ +000208b0: 6520 456d 6163 7320 4c69 7370 3a3a 2920 e Emacs Lisp::) │ │ │ │ │ +000208c0: 636f 6d70 7574 6573 2027 2428 6c69 7370 computes '$(lisp │ │ │ │ │ +000208d0: 6469 7229 273a 0a0a 2020 2020 2024 454d dir)':.. $EM │ │ │ │ │ +000208e0: 4143 5320 2d62 6174 6368 202d 7120 2d65 ACS -batch -q -e │ │ │ │ │ +000208f0: 7661 6c20 2728 7768 696c 6520 6c6f 6164 val '(while load │ │ │ │ │ +00020900: 2d70 6174 680a 2020 2020 2020 2028 7072 -path. (pr │ │ │ │ │ +00020910: 696e 6320 2863 6f6e 6361 7420 2863 6172 inc (concat (car │ │ │ │ │ +00020920: 206c 6f61 642d 7061 7468 2920 225c 6e22 load-path) "\n" │ │ │ │ │ +00020930: 2929 0a20 2020 2020 2020 2873 6574 7120 )). (setq │ │ │ │ │ +00020940: 6c6f 6164 2d70 6174 6820 2863 6472 206c load-path (cdr l │ │ │ │ │ +00020950: 6f61 642d 7061 7468 2929 2927 203e 636f oad-path)))' >co │ │ │ │ │ +00020960: 6e66 7465 7374 2e6f 7574 0a20 2020 2020 nftest.out. │ │ │ │ │ +00020970: 6c69 7370 6469 723d 6073 6564 202d 6e0a lispdir=`sed -n. │ │ │ │ │ +00020980: 2020 2020 2020 202d 6520 2773 2c2f 242c -e 's,/$, │ │ │ │ │ +00020990: 2c27 0a20 2020 2020 2020 2d65 2027 2f2e ,'. -e '/. │ │ │ │ │ +000209a0: 2a5c 2f6c 6962 5c2f 782a 656d 6163 735c *\/lib\/x*emacs\ │ │ │ │ │ +000209b0: 2f73 6974 652d 6c69 7370 242f 7b0a 2020 /site-lisp$/{. │ │ │ │ │ +000209c0: 2020 2020 2020 2020 2020 2073 2c2e 2a2f s,.*/ │ │ │ │ │ +000209d0: 6c69 622f 5c28 782a 656d 6163 732f 7369 lib/\(x*emacs/si │ │ │ │ │ +000209e0: 7465 2d6c 6973 705c 2924 2c24 7b6c 6962 te-lisp\)$,${lib │ │ │ │ │ +000209f0: 6469 727d 2f5c 312c 3b70 3b71 3b0a 2020 dir}/\1,;p;q;. │ │ │ │ │ +00020a00: 2020 2020 2020 2020 207d 270a 2020 2020 }'. │ │ │ │ │ +00020a10: 2020 202d 6520 272f 2e2a 5c2f 7368 6172 -e '/.*\/shar │ │ │ │ │ +00020a20: 655c 2f78 2a65 6d61 6373 5c2f 7369 7465 e\/x*emacs\/site │ │ │ │ │ +00020a30: 2d6c 6973 7024 2f7b 0a20 2020 2020 2020 -lisp$/{. │ │ │ │ │ +00020a40: 2020 2020 2020 732c 2e2a 2f73 6861 7265 s,.*/share │ │ │ │ │ +00020a50: 2f5c 2878 2a65 6d61 6373 2f73 6974 652d /\(x*emacs/site- │ │ │ │ │ +00020a60: 6c69 7370 5c29 2c24 7b64 6174 6172 6f6f lisp\),${dataroo │ │ │ │ │ +00020a70: 7464 6972 7d2f 5c31 2c3b 703b 713b 0a20 tdir}/\1,;p;q;. │ │ │ │ │ +00020a80: 2020 2020 2020 2020 2020 7d27 0a20 2020 }'. │ │ │ │ │ +00020a90: 2020 2020 636f 6e66 7465 7374 2e6f 7574 conftest.out │ │ │ │ │ +00020aa0: 600a 0a20 2020 492e 652e 2c20 6974 206a `.. I.e., it j │ │ │ │ │ +00020ab0: 7573 7420 7069 636b 7320 7468 6520 6669 ust picks the fi │ │ │ │ │ +00020ac0: 7273 7420 6469 7265 6374 6f72 7920 7468 rst directory th │ │ │ │ │ +00020ad0: 6174 206c 6f6f 6b73 206c 696b 650a 272a at looks like.'* │ │ │ │ │ +00020ae0: 2f6c 6962 2f2a 656d 6163 732f 7369 7465 /lib/*emacs/site │ │ │ │ │ +00020af0: 2d6c 6973 7027 206f 7220 272a 2f73 6861 -lisp' or '*/sha │ │ │ │ │ +00020b00: 7265 2f2a 656d 6163 732f 7369 7465 2d6c re/*emacs/site-l │ │ │ │ │ +00020b10: 6973 7027 2069 6e20 7468 6520 7365 6172 isp' in the sear │ │ │ │ │ +00020b20: 6368 0a70 6174 6820 6f66 2065 6d61 6373 ch.path of emacs │ │ │ │ │ +00020b30: 2c20 616e 6420 7468 656e 2073 7562 7374 , and then subst │ │ │ │ │ +00020b40: 6974 7574 6573 2027 247b 6c69 6264 6972 itutes '${libdir │ │ │ │ │ +00020b50: 7d27 206f 7220 2724 7b64 6174 6164 6972 }' or '${datadir │ │ │ │ │ +00020b60: 7d27 0a61 7070 726f 7072 6961 7465 6c79 }'.appropriately │ │ │ │ │ +00020b70: 2e0a 0a20 2020 5468 6520 656d 6163 7320 ... The emacs │ │ │ │ │ +00020b80: 6361 7365 206c 6f6f 6b73 2063 6f6d 706c case looks compl │ │ │ │ │ +00020b90: 6963 6174 6564 2062 6563 6175 7365 2069 icated because i │ │ │ │ │ +00020ba0: 7420 7072 6f63 6573 7365 7320 6120 6c69 t processes a li │ │ │ │ │ +00020bb0: 7374 2061 6e64 0a65 7870 6563 7473 2074 st and.expects t │ │ │ │ │ +00020bc0: 776f 2070 6f73 7369 626c 6520 6c61 796f wo possible layo │ │ │ │ │ +00020bd0: 7574 732c 206f 7468 6572 7769 7365 2069 uts, otherwise i │ │ │ │ │ +00020be0: 7427 7320 6561 7379 2c20 616e 6420 7468 t's easy, and th │ │ │ │ │ +00020bf0: 6520 6265 6e65 6669 7473 2066 6f72 0a6e e benefits for.n │ │ │ │ │ +00020c00: 6f6e 2d72 6f6f 7420 7573 6572 7320 6172 on-root users ar │ │ │ │ │ +00020c10: 6520 7265 616c 6c79 2077 6f72 7468 2074 e really worth t │ │ │ │ │ +00020c20: 6865 2065 7874 7261 2027 7365 6427 2069 he extra 'sed' i │ │ │ │ │ +00020c30: 6e76 6f63 6174 696f 6e2e 0a0a 1f0a 4669 nvocation.....Fi │ │ │ │ │ +00020c40: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +00020c50: 312e 696e 666f 2c20 204e 6f64 653a 2044 1.info, Node: D │ │ │ │ │ +00020c60: 6562 7567 6769 6e67 204d 616b 6520 5275 ebugging Make Ru │ │ │ │ │ +00020c70: 6c65 732c 2020 4e65 7874 3a20 5265 706f les, Next: Repo │ │ │ │ │ +00020c80: 7274 696e 6720 4275 6773 2c20 2050 7265 rting Bugs, Pre │ │ │ │ │ +00020c90: 763a 2048 6172 642d 436f 6465 6420 496e v: Hard-Coded In │ │ │ │ │ +00020ca0: 7374 616c 6c20 5061 7468 732c 2020 5570 stall Paths, Up │ │ │ │ │ +00020cb0: 3a20 4641 510a 0a32 382e 3131 2044 6562 : FAQ..28.11 Deb │ │ │ │ │ +00020cc0: 7567 6769 6e67 204d 616b 6520 5275 6c65 ugging Make Rule │ │ │ │ │ +00020cd0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ +00020ce0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ +00020cf0: 6520 7275 6c65 7320 616e 6420 6465 7065 e rules and depe │ │ │ │ │ +00020d00: 6e64 656e 6379 2074 7265 6573 2067 656e ndency trees gen │ │ │ │ │ +00020d10: 6572 6174 6564 2062 7920 2761 7574 6f6d erated by 'autom │ │ │ │ │ +00020d20: 616b 6527 2063 616e 2067 6574 2072 6174 ake' can get rat │ │ │ │ │ +00020d30: 6865 720a 636f 6d70 6c65 782c 2061 6e64 her.complex, and │ │ │ │ │ +00020d40: 206c 6561 7665 2074 6865 2064 6576 656c leave the devel │ │ │ │ │ +00020d50: 6f70 6572 2068 6561 642d 7363 7261 7463 oper head-scratc │ │ │ │ │ +00020d60: 6869 6e67 2077 6865 6e20 7468 696e 6773 hing when things │ │ │ │ │ +00020d70: 2064 6f6e 2774 2077 6f72 6b0a 6173 2065 don't work.as e │ │ │ │ │ +00020d80: 7870 6563 7465 642e 2020 4265 7369 6465 xpected. Beside │ │ │ │ │ +00020d90: 7320 7468 6520 6465 6275 6720 6f70 7469 s the debug opti │ │ │ │ │ +00020da0: 6f6e 7320 7072 6f76 6964 6564 2062 7920 ons provided by │ │ │ │ │ +00020db0: 7468 6520 276d 616b 6527 2063 6f6d 6d61 the 'make' comma │ │ │ │ │ +00020dc0: 6e64 0a28 2a6e 6f74 6520 286d 616b 6529 nd.(*note (make) │ │ │ │ │ +00020dd0: 4f70 7469 6f6e 7320 5375 6d6d 6172 793a Options Summary: │ │ │ │ │ +00020de0: 3a29 2c20 6865 7265 2773 2061 2063 6f75 :), here's a cou │ │ │ │ │ +00020df0: 706c 6520 6f66 2066 7572 7468 6572 2068 ple of further h │ │ │ │ │ +00020e00: 696e 7473 2066 6f72 0a64 6562 7567 6769 ints for.debuggi │ │ │ │ │ +00020e10: 6e67 206d 616b 6566 696c 6573 2067 656e ng makefiles gen │ │ │ │ │ +00020e20: 6572 6174 6564 2062 7920 2761 7574 6f6d erated by 'autom │ │ │ │ │ +00020e30: 616b 6527 2065 6666 6563 7469 7665 6c79 ake' effectively │ │ │ │ │ +00020e40: 3a0a 0a20 2020 2a20 4966 206c 6573 7320 :.. * If less │ │ │ │ │ +00020e50: 7665 7262 6f73 6520 6f75 7470 7574 2068 verbose output h │ │ │ │ │ +00020e60: 6173 2062 6565 6e20 656e 6162 6c65 6420 as been enabled │ │ │ │ │ +00020e70: 696e 2074 6865 2070 6163 6b61 6765 2077 in the package w │ │ │ │ │ +00020e80: 6974 6820 7468 650a 2020 2020 2027 7369 ith the. 'si │ │ │ │ │ +00020e90: 6c65 6e74 2d72 756c 6573 2720 6f70 7469 lent-rules' opti │ │ │ │ │ +00020ea0: 6f6e 2028 2a6e 6f74 6520 4f70 7469 6f6e on (*note Option │ │ │ │ │ +00020eb0: 733a 3a29 2c20 796f 7520 6361 6e20 7573 s::), you can us │ │ │ │ │ +00020ec0: 6520 276d 616b 6520 563d 3127 2074 6f0a e 'make V=1' to. │ │ │ │ │ +00020ed0: 2020 2020 2073 6565 2074 6865 2063 6f6d see the com │ │ │ │ │ +00020ee0: 6d61 6e64 7320 6265 696e 6720 6578 6563 mands being exec │ │ │ │ │ +00020ef0: 7574 6564 2e0a 2020 202a 2027 6d61 6b65 uted.. * 'make │ │ │ │ │ +00020f00: 202d 6e27 2063 616e 2068 656c 7020 7368 -n' can help sh │ │ │ │ │ +00020f10: 6f77 2077 6861 7420 776f 756c 6420 6265 ow what would be │ │ │ │ │ +00020f20: 2064 6f6e 6520 7769 7468 6f75 7420 6163 done without ac │ │ │ │ │ +00020f30: 7475 616c 6c79 2064 6f69 6e67 0a20 2020 tually doing. │ │ │ │ │ +00020f40: 2020 6974 2e20 204e 6f74 6520 686f 7765 it. Note howe │ │ │ │ │ +00020f50: 7665 722c 2074 6861 7420 7468 6973 2077 ver, that this w │ │ │ │ │ +00020f60: 696c 6c20 5f73 7469 6c6c 2065 7865 6375 ill _still execu │ │ │ │ │ +00020f70: 7465 5f20 636f 6d6d 616e 6473 2070 7265 te_ commands pre │ │ │ │ │ +00020f80: 6669 7865 640a 2020 2020 2077 6974 6820 fixed. with │ │ │ │ │ +00020f90: 272b 272c 2061 6e64 2c20 7768 656e 2075 '+', and, when u │ │ │ │ │ +00020fa0: 7369 6e67 2047 4e55 2027 6d61 6b65 272c sing GNU 'make', │ │ │ │ │ +00020fb0: 2063 6f6d 6d61 6e64 7320 7468 6174 2063 commands that c │ │ │ │ │ +00020fc0: 6f6e 7461 696e 2074 6865 0a20 2020 2020 ontain the. │ │ │ │ │ +00020fd0: 7374 7269 6e67 7320 2724 284d 414b 4529 strings '$(MAKE) │ │ │ │ │ +00020fe0: 2720 6f72 2027 247b 4d41 4b45 7d27 2028 ' or '${MAKE}' ( │ │ │ │ │ +00020ff0: 2a6e 6f74 6520 286d 616b 6529 496e 7374 *note (make)Inst │ │ │ │ │ +00021000: 6561 6420 6f66 0a20 2020 2020 4578 6563 ead of. Exec │ │ │ │ │ +00021010: 7574 696f 6e3a 3a29 2e20 2054 7970 6963 ution::). Typic │ │ │ │ │ +00021020: 616c 6c79 2c20 7468 6973 2069 7320 6865 ally, this is he │ │ │ │ │ +00021030: 6c70 6675 6c20 746f 2073 686f 7720 7768 lpful to show wh │ │ │ │ │ +00021040: 6174 2072 6563 7572 7369 7665 0a20 2020 at recursive. │ │ │ │ │ +00021050: 2020 7275 6c65 7320 776f 756c 6420 646f rules would do │ │ │ │ │ +00021060: 2c20 6275 7420 6974 206d 6561 6e73 2074 , but it means t │ │ │ │ │ +00021070: 6861 742c 2069 6e20 796f 7572 206f 776e hat, in your own │ │ │ │ │ +00021080: 2072 756c 6573 2c20 796f 7520 7368 6f75 rules, you shou │ │ │ │ │ +00021090: 6c64 0a20 2020 2020 6e6f 7420 6d69 7820 ld. not mix │ │ │ │ │ +000210a0: 7375 6368 2072 6563 7572 7369 6f6e 2077 such recursion w │ │ │ │ │ +000210b0: 6974 6820 6163 7469 6f6e 7320 7468 6174 ith actions that │ │ │ │ │ +000210c0: 2063 6861 6e67 6520 616e 7920 6669 6c65 change any file │ │ │ │ │ +000210d0: 732e 2831 290a 2020 2020 2046 7572 7468 s.(1). Furth │ │ │ │ │ +000210e0: 6572 6d6f 7265 2c20 6e6f 7465 2074 6861 ermore, note tha │ │ │ │ │ +000210f0: 7420 474e 5520 276d 616b 6527 2077 696c t GNU 'make' wil │ │ │ │ │ +00021100: 6c20 7570 6461 7465 2070 7265 7265 7175 l update prerequ │ │ │ │ │ +00021110: 6973 6974 6573 2066 6f72 2074 6865 0a20 isites for the. │ │ │ │ │ +00021120: 2020 2020 274d 616b 6566 696c 6527 2066 'Makefile' f │ │ │ │ │ +00021130: 696c 6520 6974 7365 6c66 2065 7665 6e20 ile itself even │ │ │ │ │ +00021140: 7769 7468 2027 2d6e 2720 282a 6e6f 7465 with '-n' (*note │ │ │ │ │ +00021150: 2028 6d61 6b65 2952 656d 616b 696e 670a (make)Remaking. │ │ │ │ │ +00021160: 2020 2020 204d 616b 6566 696c 6573 3a3a Makefiles:: │ │ │ │ │ +00021170: 292e 0a20 2020 2a20 276d 616b 6520 5348 ).. * 'make SH │ │ │ │ │ +00021180: 454c 4c3d 222f 6269 6e2f 6261 7368 202d ELL="/bin/bash - │ │ │ │ │ +00021190: 7678 2227 2063 616e 2068 656c 7020 6465 vx"' can help de │ │ │ │ │ +000211a0: 6275 6720 636f 6d70 6c65 7820 7275 6c65 bug complex rule │ │ │ │ │ +000211b0: 732e 2020 2a4e 6f74 650a 2020 2020 2028 s. *Note. ( │ │ │ │ │ +000211c0: 6175 746f 636f 6e66 2954 6865 204d 616b autoconf)The Mak │ │ │ │ │ +000211d0: 6520 4d61 6372 6f20 5348 454c 4c3a 3a2c e Macro SHELL::, │ │ │ │ │ +000211e0: 2066 6f72 2073 6f6d 6520 706f 7274 6162 for some portab │ │ │ │ │ +000211f0: 696c 6974 7920 7175 6972 6b73 0a20 2020 ility quirks. │ │ │ │ │ +00021200: 2020 6173 736f 6369 6174 6564 2077 6974 associated wit │ │ │ │ │ +00021210: 6820 7468 6973 2063 6f6e 7374 7275 6374 h this construct │ │ │ │ │ +00021220: 2e0a 2020 202a 2027 6563 686f 2027 7072 .. * 'echo 'pr │ │ │ │ │ +00021230: 696e 743a 203b 2040 6563 686f 2022 2428 int: ; @echo "$( │ │ │ │ │ +00021240: 5641 5229 2227 207c 206d 616b 6520 2d66 VAR)"' | make -f │ │ │ │ │ +00021250: 204d 616b 6566 696c 6520 2d66 202d 2070 Makefile -f - p │ │ │ │ │ +00021260: 7269 6e74 2720 6361 6e0a 2020 2020 2062 rint' can. b │ │ │ │ │ +00021270: 6520 6861 6e64 7920 746f 2065 7861 6d69 e handy to exami │ │ │ │ │ +00021280: 6e65 2074 6865 2065 7870 616e 6465 6420 ne the expanded │ │ │ │ │ +00021290: 7661 6c75 6520 6f66 2076 6172 6961 626c value of variabl │ │ │ │ │ +000212a0: 6573 2e20 2059 6f75 206d 6179 206e 6565 es. You may nee │ │ │ │ │ +000212b0: 640a 2020 2020 2074 6f20 7573 6520 6120 d. to use a │ │ │ │ │ +000212c0: 7461 7267 6574 206f 7468 6572 2074 6861 target other tha │ │ │ │ │ +000212d0: 6e20 2770 7269 6e74 2720 6966 2074 6861 n 'print' if tha │ │ │ │ │ +000212e0: 7420 6973 2061 6c72 6561 6479 2075 7365 t is already use │ │ │ │ │ +000212f0: 6420 6f72 2061 0a20 2020 2020 6669 6c65 d or a. file │ │ │ │ │ +00021300: 2077 6974 6820 7468 6174 206e 616d 6520 with that name │ │ │ │ │ +00021310: 6578 6973 7473 2e0a 2020 202a 203c 6874 exists.. * provides a │ │ │ │ │ +00021350: 6d6f 6469 6669 6564 2047 4e55 0a20 2020 modified GNU. │ │ │ │ │ +00021360: 2020 276d 616b 6527 2063 6f6d 6d61 6e64 'make' command │ │ │ │ │ +00021370: 2063 616c 6c65 6420 2772 656d 616b 6527 called 'remake' │ │ │ │ │ +00021380: 2074 6861 7420 636f 7065 7320 7769 7468 that copes with │ │ │ │ │ +00021390: 2063 6f6d 706c 6578 2047 4e55 0a20 2020 complex GNU. │ │ │ │ │ +000213a0: 2020 276d 616b 6527 2d73 7065 6369 6669 'make'-specifi │ │ │ │ │ +000213b0: 6320 4d61 6b65 6669 6c65 7320 616e 6420 c Makefiles and │ │ │ │ │ +000213c0: 616c 6c6f 7773 2074 6f20 7472 6163 6520 allows to trace │ │ │ │ │ +000213d0: 6578 6563 7574 696f 6e2c 2065 7861 6d69 execution, exami │ │ │ │ │ +000213e0: 6e65 0a20 2020 2020 7661 7269 6162 6c65 ne. variable │ │ │ │ │ +000213f0: 732c 2061 6e64 2063 616c 6c20 7275 6c65 s, and call rule │ │ │ │ │ +00021400: 7320 696e 7465 7261 6374 6976 656c 792c s interactively, │ │ │ │ │ +00021410: 206d 7563 6820 6c69 6b65 2061 2064 6562 much like a deb │ │ │ │ │ +00021420: 7567 6765 722e 0a0a 2020 202d 2d2d 2d2d ugger... ----- │ │ │ │ │ +00021430: 2d2d 2d2d 2d20 466f 6f74 6e6f 7465 7320 ----- Footnotes │ │ │ │ │ +00021440: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 2028 ----------.. ( │ │ │ │ │ +00021450: 3129 2041 7574 6f6d 616b 6527 7320 2764 1) Automake's 'd │ │ │ │ │ +00021460: 6973 7427 2061 6e64 2027 6469 7374 6368 ist' and 'distch │ │ │ │ │ +00021470: 6563 6b27 2072 756c 6573 2068 6164 2061 eck' rules had a │ │ │ │ │ +00021480: 2062 7567 2069 6e20 7468 6973 2072 6567 bug in this reg │ │ │ │ │ +00021490: 6172 640a 696e 2074 6861 7420 7468 6579 ard.in that they │ │ │ │ │ +000214a0: 2063 7265 6174 6564 2064 6972 6563 746f created directo │ │ │ │ │ +000214b0: 7269 6573 2065 7665 6e20 7769 7468 2027 ries even with ' │ │ │ │ │ +000214c0: 2d6e 272c 2062 7574 2074 6869 7320 6861 -n', but this ha │ │ │ │ │ +000214d0: 7320 6265 656e 2066 6978 6564 0a69 6e20 s been fixed.in │ │ │ │ │ +000214e0: 4175 746f 6d61 6b65 2031 2e31 312e 0a0a Automake 1.11... │ │ │ │ │ +000214f0: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ +00021500: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ +00021510: 653a 2052 6570 6f72 7469 6e67 2042 7567 e: Reporting Bug │ │ │ │ │ +00021520: 732c 2020 5072 6576 3a20 4465 6275 6767 s, Prev: Debugg │ │ │ │ │ +00021530: 696e 6720 4d61 6b65 2052 756c 6573 2c20 ing Make Rules, │ │ │ │ │ +00021540: 2055 703a 2046 4151 0a0a 3238 2e31 3220 Up: FAQ..28.12 │ │ │ │ │ +00021550: 5265 706f 7274 696e 6720 4275 6773 0a3d Reporting Bugs.= │ │ │ │ │ 00021560: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00021570: 3d3d 0a0a 4d6f 7374 206e 6f6e 7472 6976 ==..Most nontriv │ │ │ │ │ -00021580: 6961 6c20 736f 6674 7761 7265 2068 6173 ial software has │ │ │ │ │ -00021590: 2062 7567 732e 2020 4175 746f 6d61 6b65 bugs. Automake │ │ │ │ │ -000215a0: 2069 7320 6e6f 2065 7863 6570 7469 6f6e is no exception │ │ │ │ │ -000215b0: 2e20 2041 6c74 686f 7567 680a 7765 2063 . Although.we c │ │ │ │ │ -000215c0: 616e 6e6f 7420 7072 6f6d 6973 6520 7765 annot promise we │ │ │ │ │ -000215d0: 2063 616e 206f 7220 7769 6c6c 2066 6978 can or will fix │ │ │ │ │ -000215e0: 2061 2062 7567 2c20 616e 6420 7765 206d a bug, and we m │ │ │ │ │ -000215f0: 6967 6874 206e 6f74 2065 7665 6e20 6167 ight not even ag │ │ │ │ │ -00021600: 7265 650a 7468 6174 2069 7420 6973 2061 ree.that it is a │ │ │ │ │ -00021610: 2062 7567 2c20 7765 2077 616e 7420 746f bug, we want to │ │ │ │ │ -00021620: 2068 6561 7220 6162 6f75 7420 7072 6f62 hear about prob │ │ │ │ │ -00021630: 6c65 6d73 2079 6f75 2065 6e63 6f75 6e74 lems you encount │ │ │ │ │ -00021640: 6572 2e20 204f 6674 656e 0a77 6520 6167 er. Often.we ag │ │ │ │ │ -00021650: 7265 6520 7468 6579 2061 7265 2062 7567 ree they are bug │ │ │ │ │ -00021660: 7320 616e 6420 7761 6e74 2074 6f20 6669 s and want to fi │ │ │ │ │ -00021670: 7820 7468 656d 2e0a 0a20 2020 546f 206d x them... To m │ │ │ │ │ -00021680: 616b 6520 6974 2070 6f73 7369 626c 6520 ake it possible │ │ │ │ │ -00021690: 666f 7220 7573 2074 6f20 6669 7820 6120 for us to fix a │ │ │ │ │ -000216a0: 6275 672c 2070 6c65 6173 6520 7265 706f bug, please repo │ │ │ │ │ -000216b0: 7274 2069 742e 2020 496e 206f 7264 6572 rt it. In order │ │ │ │ │ -000216c0: 0a74 6f20 646f 2073 6f20 6566 6665 6374 .to do so effect │ │ │ │ │ -000216d0: 6976 656c 792c 2069 7420 6865 6c70 7320 ively, it helps │ │ │ │ │ -000216e0: 746f 206b 6e6f 7720 7768 656e 2061 6e64 to know when and │ │ │ │ │ -000216f0: 2068 6f77 2074 6f20 646f 2069 742e 0a0a how to do it... │ │ │ │ │ -00021700: 2020 2042 6566 6f72 6520 7265 706f 7274 Before report │ │ │ │ │ -00021710: 696e 6720 6120 6275 672c 2069 7420 6973 ing a bug, it is │ │ │ │ │ -00021720: 2061 2067 6f6f 6420 6964 6561 2074 6f20 a good idea to │ │ │ │ │ -00021730: 7365 6520 6966 2069 7420 6973 2061 6c72 see if it is alr │ │ │ │ │ -00021740: 6561 6479 0a6b 6e6f 776e 2e20 2059 6f75 eady.known. You │ │ │ │ │ -00021750: 2063 616e 206c 6f6f 6b20 6174 2074 6865 can look at the │ │ │ │ │ -00021760: 2047 4e55 2042 7567 2054 7261 636b 6572 GNU Bug Tracker │ │ │ │ │ -00021770: 2028 6874 7470 3a2f 2f64 6562 6275 6773 (http://debbugs │ │ │ │ │ -00021780: 2e67 6e75 2e6f 7267 2f29 0a61 6e64 2074 .gnu.org/).and t │ │ │ │ │ -00021790: 6865 2062 7567 2d61 7574 6f6d 616b 6520 he bug-automake │ │ │ │ │ -000217a0: 6d61 696c 696e 6720 6c69 7374 2061 7263 mailing list arc │ │ │ │ │ -000217b0: 6869 7665 730a 2868 7474 703a 2f2f 6c69 hives.(http://li │ │ │ │ │ -000217c0: 7374 732e 676e 752e 6f72 672f 6172 6368 sts.gnu.org/arch │ │ │ │ │ -000217d0: 6976 652f 6874 6d6c 2f62 7567 2d61 7574 ive/html/bug-aut │ │ │ │ │ -000217e0: 6f6d 616b 652f 2920 666f 7220 7072 6576 omake/) for prev │ │ │ │ │ -000217f0: 696f 7573 2062 7567 0a72 6570 6f72 7473 ious bug.reports │ │ │ │ │ -00021800: 2e20 2057 6520 7072 6576 696f 7573 6c79 . We previously │ │ │ │ │ -00021810: 2075 7365 6420 6120 476e 6174 7320 6461 used a Gnats da │ │ │ │ │ -00021820: 7461 6261 7365 0a28 6874 7470 3a2f 2f73 tabase.(http://s │ │ │ │ │ -00021830: 6f75 7263 6577 6172 652e 6f72 672f 6367 ourceware.org/cg │ │ │ │ │ -00021840: 692d 6269 6e2f 676e 6174 7377 6562 2e70 i-bin/gnatsweb.p │ │ │ │ │ -00021850: 6c3f 6461 7461 6261 7365 3d61 7574 6f6d l?database=autom │ │ │ │ │ -00021860: 616b 6529 2066 6f72 2062 7567 0a74 7261 ake) for bug.tra │ │ │ │ │ -00021870: 636b 696e 672c 2073 6f20 736f 6d65 2062 cking, so some b │ │ │ │ │ -00021880: 7567 7320 6d69 6768 7420 6861 7665 2062 ugs might have b │ │ │ │ │ -00021890: 6565 6e20 7265 706f 7274 6564 2074 6865 een reported the │ │ │ │ │ -000218a0: 7265 2061 6c72 6561 6479 2e20 2050 6c65 re already. Ple │ │ │ │ │ -000218b0: 6173 650a 646f 206e 6f74 2075 7365 2069 ase.do not use i │ │ │ │ │ -000218c0: 7420 666f 7220 6e65 7720 6275 6720 7265 t for new bug re │ │ │ │ │ -000218d0: 706f 7274 732c 2068 6f77 6576 6572 2e0a ports, however.. │ │ │ │ │ -000218e0: 0a20 2020 4966 2074 6865 2062 7567 2069 . If the bug i │ │ │ │ │ -000218f0: 7320 6e6f 7420 616c 7265 6164 7920 6b6e s not already kn │ │ │ │ │ -00021900: 6f77 6e2c 2069 7420 7368 6f75 6c64 2062 own, it should b │ │ │ │ │ -00021910: 6520 7265 706f 7274 6564 2e20 2049 7420 e reported. It │ │ │ │ │ -00021920: 6973 2076 6572 790a 696d 706f 7274 616e is very.importan │ │ │ │ │ -00021930: 7420 746f 2072 6570 6f72 7420 6275 6773 t to report bugs │ │ │ │ │ -00021940: 2069 6e20 6120 7761 7920 7468 6174 2069 in a way that i │ │ │ │ │ -00021950: 7320 7573 6566 756c 2061 6e64 2065 6666 s useful and eff │ │ │ │ │ -00021960: 6963 6965 6e74 2e20 2046 6f72 0a74 6869 icient. For.thi │ │ │ │ │ -00021970: 732c 2070 6c65 6173 6520 6661 6d69 6c69 s, please famili │ │ │ │ │ -00021980: 6172 697a 6520 796f 7572 7365 6c66 2077 arize yourself w │ │ │ │ │ -00021990: 6974 6820 486f 7720 746f 2052 6570 6f72 ith How to Repor │ │ │ │ │ -000219a0: 7420 4275 6773 2045 6666 6563 7469 7665 t Bugs Effective │ │ │ │ │ -000219b0: 6c79 0a28 6874 7470 3a2f 2f77 7777 2e63 ly.(http://www.c │ │ │ │ │ -000219c0: 6869 6172 6b2e 6772 6565 6e65 6e64 2e6f hiark.greenend.o │ │ │ │ │ -000219d0: 7267 2e75 6b2f 7e73 6774 6174 6861 6d2f rg.uk/~sgtatham/ │ │ │ │ │ -000219e0: 6275 6773 2e68 746d 6c29 2061 6e64 2048 bugs.html) and H │ │ │ │ │ -000219f0: 6f77 2074 6f20 4173 6b0a 5175 6573 7469 ow to Ask.Questi │ │ │ │ │ -00021a00: 6f6e 7320 7468 6520 536d 6172 7420 5761 ons the Smart Wa │ │ │ │ │ -00021a10: 790a 2868 7474 703a 2f2f 6361 7462 2e6f y.(http://catb.o │ │ │ │ │ -00021a20: 7267 2f7e 6573 722f 6661 7173 2f73 6d61 rg/~esr/faqs/sma │ │ │ │ │ -00021a30: 7274 2d71 7565 7374 696f 6e73 2e68 746d rt-questions.htm │ │ │ │ │ -00021a40: 6c29 2e20 2054 6869 7320 6865 6c70 7320 l). This helps │ │ │ │ │ -00021a50: 796f 7520 616e 640a 6465 7665 6c6f 7065 you and.develope │ │ │ │ │ -00021a60: 7273 2074 6f20 7361 7665 2074 696d 6520 rs to save time │ │ │ │ │ -00021a70: 7768 6963 6820 6361 6e20 7468 656e 2062 which can then b │ │ │ │ │ -00021a80: 6520 7370 656e 7420 6f6e 2066 6978 696e e spent on fixin │ │ │ │ │ -00021a90: 6720 6d6f 7265 2062 7567 7320 616e 640a g more bugs and. │ │ │ │ │ -00021aa0: 696d 706c 656d 656e 7469 6e67 206d 6f72 implementing mor │ │ │ │ │ -00021ab0: 6520 6665 6174 7572 6573 2e0a 0a20 2020 e features... │ │ │ │ │ -00021ac0: 466f 7220 6120 6275 6720 7265 706f 7274 For a bug report │ │ │ │ │ -00021ad0: 2c20 6120 6665 6174 7572 6520 7265 7175 , a feature requ │ │ │ │ │ -00021ae0: 6573 7420 6f72 206f 7468 6572 2073 7567 est or other sug │ │ │ │ │ -00021af0: 6765 7374 696f 6e73 2c20 706c 6561 7365 gestions, please │ │ │ │ │ -00021b00: 2073 656e 640a 656d 6169 6c20 746f 203c send.email to < │ │ │ │ │ -00021b10: 6275 672d 6175 746f 6d61 6b65 4067 6e75 bug-automake@gnu │ │ │ │ │ -00021b20: 2e6f 7267 3e2e 2020 5468 6973 2077 696c .org>. This wil │ │ │ │ │ -00021b30: 6c20 7468 656e 206f 7065 6e20 6120 6e65 l then open a ne │ │ │ │ │ -00021b40: 7720 6275 6720 696e 2074 6865 0a62 7567 w bug in the.bug │ │ │ │ │ -00021b50: 2074 7261 636b 6572 2028 6874 7470 3a2f tracker (http:/ │ │ │ │ │ -00021b60: 2f64 6562 6275 6773 2e67 6e75 2e6f 7267 /debbugs.gnu.org │ │ │ │ │ -00021b70: 2f61 7574 6f6d 616b 6529 2e20 2042 6520 /automake). Be │ │ │ │ │ -00021b80: 7375 7265 2074 6f20 696e 636c 7564 6520 sure to include │ │ │ │ │ -00021b90: 7468 650a 7665 7273 696f 6e73 206f 6620 the.versions of │ │ │ │ │ -00021ba0: 4175 746f 636f 6e66 2061 6e64 2041 7574 Autoconf and Aut │ │ │ │ │ -00021bb0: 6f6d 616b 6520 7468 6174 2079 6f75 2075 omake that you u │ │ │ │ │ -00021bc0: 7365 2e20 2049 6465 616c 6c79 2c20 706f se. Ideally, po │ │ │ │ │ -00021bd0: 7374 2061 206d 696e 696d 616c 0a27 4d61 st a minimal.'Ma │ │ │ │ │ -00021be0: 6b65 6669 6c65 2e61 6d27 2061 6e64 2027 kefile.am' and ' │ │ │ │ │ -00021bf0: 636f 6e66 6967 7572 652e 6163 2720 7468 configure.ac' th │ │ │ │ │ -00021c00: 6174 2072 6570 726f 6475 6365 7320 7468 at reproduces th │ │ │ │ │ -00021c10: 6520 7072 6f62 6c65 6d20 796f 750a 656e e problem you.en │ │ │ │ │ -00021c20: 636f 756e 7465 722e 2020 4966 2079 6f75 counter. If you │ │ │ │ │ -00021c30: 2068 6176 6520 656e 636f 756e 7465 7265 have encountere │ │ │ │ │ -00021c40: 6420 7465 7374 2073 7569 7465 2066 6169 d test suite fai │ │ │ │ │ -00021c50: 6c75 7265 732c 2070 6c65 6173 6520 6174 lures, please at │ │ │ │ │ -00021c60: 7461 6368 0a74 6865 2027 7465 7374 732f tach.the 'tests/ │ │ │ │ │ -00021c70: 7465 7374 2d73 7569 7465 2e6c 6f67 2720 test-suite.log' │ │ │ │ │ -00021c80: 6669 6c65 2e0a 0a1f 0a46 696c 653a 2061 file.....File: a │ │ │ │ │ -00021c90: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ -00021ca0: 6f2c 2020 4e6f 6465 3a20 4869 7374 6f72 o, Node: Histor │ │ │ │ │ -00021cb0: 792c 2020 4e65 7874 3a20 436f 7079 696e y, Next: Copyin │ │ │ │ │ -00021cc0: 6720 5468 6973 204d 616e 7561 6c2c 2020 g This Manual, │ │ │ │ │ -00021cd0: 5072 6576 3a20 4641 512c 2020 5570 3a20 Prev: FAQ, Up: │ │ │ │ │ -00021ce0: 546f 700a 0a32 3920 4869 7374 6f72 7920 Top..29 History │ │ │ │ │ -00021cf0: 6f66 2041 7574 6f6d 616b 650a 2a2a 2a2a of Automake.**** │ │ │ │ │ +00021570: 3d3d 3d0a 0a4d 6f73 7420 6e6f 6e74 7269 ===..Most nontri │ │ │ │ │ +00021580: 7669 616c 2073 6f66 7477 6172 6520 6861 vial software ha │ │ │ │ │ +00021590: 7320 6275 6773 2e20 2041 7574 6f6d 616b s bugs. Automak │ │ │ │ │ +000215a0: 6520 6973 206e 6f20 6578 6365 7074 696f e is no exceptio │ │ │ │ │ +000215b0: 6e2e 2020 416c 7468 6f75 6768 0a77 6520 n. Although.we │ │ │ │ │ +000215c0: 6361 6e6e 6f74 2070 726f 6d69 7365 2077 cannot promise w │ │ │ │ │ +000215d0: 6520 6361 6e20 6f72 2077 696c 6c20 6669 e can or will fi │ │ │ │ │ +000215e0: 7820 6120 6275 672c 2061 6e64 2077 6520 x a bug, and we │ │ │ │ │ +000215f0: 6d69 6768 7420 6e6f 7420 6576 656e 2061 might not even a │ │ │ │ │ +00021600: 6772 6565 0a74 6861 7420 6974 2069 7320 gree.that it is │ │ │ │ │ +00021610: 6120 6275 672c 2077 6520 7761 6e74 2074 a bug, we want t │ │ │ │ │ +00021620: 6f20 6865 6172 2061 626f 7574 2070 726f o hear about pro │ │ │ │ │ +00021630: 626c 656d 7320 796f 7520 656e 636f 756e blems you encoun │ │ │ │ │ +00021640: 7465 722e 2020 4f66 7465 6e0a 7765 2061 ter. Often.we a │ │ │ │ │ +00021650: 6772 6565 2074 6865 7920 6172 6520 6275 gree they are bu │ │ │ │ │ +00021660: 6773 2061 6e64 2077 616e 7420 746f 2066 gs and want to f │ │ │ │ │ +00021670: 6978 2074 6865 6d2e 0a0a 2020 2054 6f20 ix them... To │ │ │ │ │ +00021680: 6d61 6b65 2069 7420 706f 7373 6962 6c65 make it possible │ │ │ │ │ +00021690: 2066 6f72 2075 7320 746f 2066 6978 2061 for us to fix a │ │ │ │ │ +000216a0: 2062 7567 2c20 706c 6561 7365 2072 6570 bug, please rep │ │ │ │ │ +000216b0: 6f72 7420 6974 2e20 2049 6e20 6f72 6465 ort it. In orde │ │ │ │ │ +000216c0: 720a 746f 2064 6f20 736f 2065 6666 6563 r.to do so effec │ │ │ │ │ +000216d0: 7469 7665 6c79 2c20 6974 2068 656c 7073 tively, it helps │ │ │ │ │ +000216e0: 2074 6f20 6b6e 6f77 2077 6865 6e20 616e to know when an │ │ │ │ │ +000216f0: 6420 686f 7720 746f 2064 6f20 6974 2e0a d how to do it.. │ │ │ │ │ +00021700: 0a20 2020 4265 666f 7265 2072 6570 6f72 . Before repor │ │ │ │ │ +00021710: 7469 6e67 2061 2062 7567 2c20 6974 2069 ting a bug, it i │ │ │ │ │ +00021720: 7320 6120 676f 6f64 2069 6465 6120 746f s a good idea to │ │ │ │ │ +00021730: 2073 6565 2069 6620 6974 2069 7320 616c see if it is al │ │ │ │ │ +00021740: 7265 6164 790a 6b6e 6f77 6e2e 2020 596f ready.known. Yo │ │ │ │ │ +00021750: 7520 6361 6e20 6c6f 6f6b 2061 7420 7468 u can look at th │ │ │ │ │ +00021760: 6520 474e 5520 4275 6720 5472 6163 6b65 e GNU Bug Tracke │ │ │ │ │ +00021770: 7220 2868 7474 703a 2f2f 6465 6262 7567 r (http://debbug │ │ │ │ │ +00021780: 732e 676e 752e 6f72 672f 290a 616e 6420 s.gnu.org/).and │ │ │ │ │ +00021790: 7468 6520 6275 672d 6175 746f 6d61 6b65 the bug-automake │ │ │ │ │ +000217a0: 206d 6169 6c69 6e67 206c 6973 7420 6172 mailing list ar │ │ │ │ │ +000217b0: 6368 6976 6573 0a28 6874 7470 3a2f 2f6c chives.(http://l │ │ │ │ │ +000217c0: 6973 7473 2e67 6e75 2e6f 7267 2f61 7263 ists.gnu.org/arc │ │ │ │ │ +000217d0: 6869 7665 2f68 746d 6c2f 6275 672d 6175 hive/html/bug-au │ │ │ │ │ +000217e0: 746f 6d61 6b65 2f29 2066 6f72 2070 7265 tomake/) for pre │ │ │ │ │ +000217f0: 7669 6f75 7320 6275 670a 7265 706f 7274 vious bug.report │ │ │ │ │ +00021800: 732e 2020 5765 2070 7265 7669 6f75 736c s. We previousl │ │ │ │ │ +00021810: 7920 7573 6564 2061 2047 6e61 7473 2064 y used a Gnats d │ │ │ │ │ +00021820: 6174 6162 6173 650a 2868 7474 703a 2f2f atabase.(http:// │ │ │ │ │ +00021830: 736f 7572 6365 7761 7265 2e6f 7267 2f63 sourceware.org/c │ │ │ │ │ +00021840: 6769 2d62 696e 2f67 6e61 7473 7765 622e gi-bin/gnatsweb. │ │ │ │ │ +00021850: 706c 3f64 6174 6162 6173 653d 6175 746f pl?database=auto │ │ │ │ │ +00021860: 6d61 6b65 2920 666f 7220 6275 670a 7472 make) for bug.tr │ │ │ │ │ +00021870: 6163 6b69 6e67 2c20 736f 2073 6f6d 6520 acking, so some │ │ │ │ │ +00021880: 6275 6773 206d 6967 6874 2068 6176 6520 bugs might have │ │ │ │ │ +00021890: 6265 656e 2072 6570 6f72 7465 6420 7468 been reported th │ │ │ │ │ +000218a0: 6572 6520 616c 7265 6164 792e 2020 506c ere already. Pl │ │ │ │ │ +000218b0: 6561 7365 0a64 6f20 6e6f 7420 7573 6520 ease.do not use │ │ │ │ │ +000218c0: 6974 2066 6f72 206e 6577 2062 7567 2072 it for new bug r │ │ │ │ │ +000218d0: 6570 6f72 7473 2c20 686f 7765 7665 722e eports, however. │ │ │ │ │ +000218e0: 0a0a 2020 2049 6620 7468 6520 6275 6720 .. If the bug │ │ │ │ │ +000218f0: 6973 206e 6f74 2061 6c72 6561 6479 206b is not already k │ │ │ │ │ +00021900: 6e6f 776e 2c20 6974 2073 686f 756c 6420 nown, it should │ │ │ │ │ +00021910: 6265 2072 6570 6f72 7465 642e 2020 4974 be reported. It │ │ │ │ │ +00021920: 2069 7320 7665 7279 0a69 6d70 6f72 7461 is very.importa │ │ │ │ │ +00021930: 6e74 2074 6f20 7265 706f 7274 2062 7567 nt to report bug │ │ │ │ │ +00021940: 7320 696e 2061 2077 6179 2074 6861 7420 s in a way that │ │ │ │ │ +00021950: 6973 2075 7365 6675 6c20 616e 6420 6566 is useful and ef │ │ │ │ │ +00021960: 6669 6369 656e 742e 2020 466f 720a 7468 ficient. For.th │ │ │ │ │ +00021970: 6973 2c20 706c 6561 7365 2066 616d 696c is, please famil │ │ │ │ │ +00021980: 6961 7269 7a65 2079 6f75 7273 656c 6620 iarize yourself │ │ │ │ │ +00021990: 7769 7468 2048 6f77 2074 6f20 5265 706f with How to Repo │ │ │ │ │ +000219a0: 7274 2042 7567 7320 4566 6665 6374 6976 rt Bugs Effectiv │ │ │ │ │ +000219b0: 656c 790a 2868 7474 703a 2f2f 7777 772e ely.(http://www. │ │ │ │ │ +000219c0: 6368 6961 726b 2e67 7265 656e 656e 642e chiark.greenend. │ │ │ │ │ +000219d0: 6f72 672e 756b 2f7e 7367 7461 7468 616d org.uk/~sgtatham │ │ │ │ │ +000219e0: 2f62 7567 732e 6874 6d6c 2920 616e 6420 /bugs.html) and │ │ │ │ │ +000219f0: 486f 7720 746f 2041 736b 0a51 7565 7374 How to Ask.Quest │ │ │ │ │ +00021a00: 696f 6e73 2074 6865 2053 6d61 7274 2057 ions the Smart W │ │ │ │ │ +00021a10: 6179 0a28 6874 7470 3a2f 2f63 6174 622e ay.(http://catb. │ │ │ │ │ +00021a20: 6f72 672f 7e65 7372 2f66 6171 732f 736d org/~esr/faqs/sm │ │ │ │ │ +00021a30: 6172 742d 7175 6573 7469 6f6e 732e 6874 art-questions.ht │ │ │ │ │ +00021a40: 6d6c 292e 2020 5468 6973 2068 656c 7073 ml). This helps │ │ │ │ │ +00021a50: 2079 6f75 2061 6e64 0a64 6576 656c 6f70 you and.develop │ │ │ │ │ +00021a60: 6572 7320 746f 2073 6176 6520 7469 6d65 ers to save time │ │ │ │ │ +00021a70: 2077 6869 6368 2063 616e 2074 6865 6e20 which can then │ │ │ │ │ +00021a80: 6265 2073 7065 6e74 206f 6e20 6669 7869 be spent on fixi │ │ │ │ │ +00021a90: 6e67 206d 6f72 6520 6275 6773 2061 6e64 ng more bugs and │ │ │ │ │ +00021aa0: 0a69 6d70 6c65 6d65 6e74 696e 6720 6d6f .implementing mo │ │ │ │ │ +00021ab0: 7265 2066 6561 7475 7265 732e 0a0a 2020 re features... │ │ │ │ │ +00021ac0: 2046 6f72 2061 2062 7567 2072 6570 6f72 For a bug repor │ │ │ │ │ +00021ad0: 742c 2061 2066 6561 7475 7265 2072 6571 t, a feature req │ │ │ │ │ +00021ae0: 7565 7374 206f 7220 6f74 6865 7220 7375 uest or other su │ │ │ │ │ +00021af0: 6767 6573 7469 6f6e 732c 2070 6c65 6173 ggestions, pleas │ │ │ │ │ +00021b00: 6520 7365 6e64 0a65 6d61 696c 2074 6f20 e send.email to │ │ │ │ │ +00021b10: 3c62 7567 2d61 7574 6f6d 616b 6540 676e . This wi │ │ │ │ │ +00021b30: 6c6c 2074 6865 6e20 6f70 656e 2061 206e ll then open a n │ │ │ │ │ +00021b40: 6577 2062 7567 2069 6e20 7468 650a 6275 ew bug in the.bu │ │ │ │ │ +00021b50: 6720 7472 6163 6b65 7220 2868 7474 703a g tracker (http: │ │ │ │ │ +00021b60: 2f2f 6465 6262 7567 732e 676e 752e 6f72 //debbugs.gnu.or │ │ │ │ │ +00021b70: 672f 6175 746f 6d61 6b65 292e 2020 4265 g/automake). Be │ │ │ │ │ +00021b80: 2073 7572 6520 746f 2069 6e63 6c75 6465 sure to include │ │ │ │ │ +00021b90: 2074 6865 0a76 6572 7369 6f6e 7320 6f66 the.versions of │ │ │ │ │ +00021ba0: 2041 7574 6f63 6f6e 6620 616e 6420 4175 Autoconf and Au │ │ │ │ │ +00021bb0: 746f 6d61 6b65 2074 6861 7420 796f 7520 tomake that you │ │ │ │ │ +00021bc0: 7573 652e 2020 4964 6561 6c6c 792c 2070 use. Ideally, p │ │ │ │ │ +00021bd0: 6f73 7420 6120 6d69 6e69 6d61 6c0a 274d ost a minimal.'M │ │ │ │ │ +00021be0: 616b 6566 696c 652e 616d 2720 616e 6420 akefile.am' and │ │ │ │ │ +00021bf0: 2763 6f6e 6669 6775 7265 2e61 6327 2074 'configure.ac' t │ │ │ │ │ +00021c00: 6861 7420 7265 7072 6f64 7563 6573 2074 hat reproduces t │ │ │ │ │ +00021c10: 6865 2070 726f 626c 656d 2079 6f75 0a65 he problem you.e │ │ │ │ │ +00021c20: 6e63 6f75 6e74 6572 2e20 2049 6620 796f ncounter. If yo │ │ │ │ │ +00021c30: 7520 6861 7665 2065 6e63 6f75 6e74 6572 u have encounter │ │ │ │ │ +00021c40: 6564 2074 6573 7420 7375 6974 6520 6661 ed test suite fa │ │ │ │ │ +00021c50: 696c 7572 6573 2c20 706c 6561 7365 2061 ilures, please a │ │ │ │ │ +00021c60: 7474 6163 680a 7468 6520 2774 6573 7473 ttach.the 'tests │ │ │ │ │ +00021c70: 2f74 6573 742d 7375 6974 652e 6c6f 6727 /test-suite.log' │ │ │ │ │ +00021c80: 2066 696c 652e 0a0a 1f0a 4669 6c65 3a20 file.....File: │ │ │ │ │ +00021c90: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ +00021ca0: 666f 2c20 204e 6f64 653a 2048 6973 746f fo, Node: Histo │ │ │ │ │ +00021cb0: 7279 2c20 204e 6578 743a 2043 6f70 7969 ry, Next: Copyi │ │ │ │ │ +00021cc0: 6e67 2054 6869 7320 4d61 6e75 616c 2c20 ng This Manual, │ │ │ │ │ +00021cd0: 2050 7265 763a 2046 4151 2c20 2055 703a Prev: FAQ, Up: │ │ │ │ │ +00021ce0: 2054 6f70 0a0a 3239 2048 6973 746f 7279 Top..29 History │ │ │ │ │ +00021cf0: 206f 6620 4175 746f 6d61 6b65 0a2a 2a2a of Automake.*** │ │ │ │ │ 00021d00: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00021d10: 2a2a 0a0a 5468 6973 2063 6861 7074 6572 **..This chapter │ │ │ │ │ -00021d20: 2070 7265 7365 6e74 7320 7661 7269 6f75 presents variou │ │ │ │ │ -00021d30: 7320 6173 7065 6374 7320 6f66 2074 6865 s aspects of the │ │ │ │ │ -00021d40: 2068 6973 746f 7279 206f 6620 4175 746f history of Auto │ │ │ │ │ -00021d50: 6d61 6b65 2e20 2054 6865 0a65 7868 6175 make. The.exhau │ │ │ │ │ -00021d60: 7374 6564 2072 6561 6465 7220 6361 6e20 sted reader can │ │ │ │ │ -00021d70: 7361 6665 6c79 2073 6b69 7020 6974 3b20 safely skip it; │ │ │ │ │ -00021d80: 7468 6973 2077 696c 6c20 6265 206d 6f72 this will be mor │ │ │ │ │ -00021d90: 6520 6f66 2069 6e74 6572 6573 7420 746f e of interest to │ │ │ │ │ -00021da0: 0a6e 6f73 7461 6c67 6963 2070 656f 706c .nostalgic peopl │ │ │ │ │ -00021db0: 652c 206f 7220 746f 2074 686f 7365 2063 e, or to those c │ │ │ │ │ -00021dc0: 7572 696f 7573 2074 6f20 6c65 6172 6e20 urious to learn │ │ │ │ │ -00021dd0: 6162 6f75 7420 7468 6520 6576 6f6c 7574 about the evolut │ │ │ │ │ -00021de0: 696f 6e20 6f66 0a41 7574 6f6d 616b 652e ion of.Automake. │ │ │ │ │ -00021df0: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2054 696d ..* Menu:..* Tim │ │ │ │ │ -00021e00: 656c 696e 653a 3a20 2020 2020 2020 2020 eline:: │ │ │ │ │ -00021e10: 2020 2020 2020 2020 2020 2054 6865 2041 The A │ │ │ │ │ -00021e20: 7574 6f6d 616b 6520 7374 6f72 792e 0a2a utomake story..* │ │ │ │ │ -00021e30: 2044 6570 656e 6465 6e63 7920 5472 6163 Dependency Trac │ │ │ │ │ -00021e40: 6b69 6e67 2045 766f 6c75 7469 6f6e 3a3a king Evolution:: │ │ │ │ │ -00021e50: 2020 4576 6f6c 7574 696f 6e20 6f66 2041 Evolution of A │ │ │ │ │ -00021e60: 7574 6f6d 6174 6963 2044 6570 656e 6465 utomatic Depende │ │ │ │ │ -00021e70: 6e63 7920 5472 6163 6b69 6e67 0a2a 2052 ncy Tracking.* R │ │ │ │ │ -00021e80: 656c 6561 7365 733a 3a20 2020 2020 2020 eleases:: │ │ │ │ │ -00021e90: 2020 2020 2020 2020 2020 2020 2053 7461 Sta │ │ │ │ │ -00021ea0: 7469 7374 6963 7320 6162 6f75 7420 4175 tistics about Au │ │ │ │ │ -00021eb0: 746f 6d61 6b65 2052 656c 6561 7365 730a tomake Releases. │ │ │ │ │ -00021ec0: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ -00021ed0: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ -00021ee0: 6465 3a20 5469 6d65 6c69 6e65 2c20 204e de: Timeline, N │ │ │ │ │ -00021ef0: 6578 743a 2044 6570 656e 6465 6e63 7920 ext: Dependency │ │ │ │ │ -00021f00: 5472 6163 6b69 6e67 2045 766f 6c75 7469 Tracking Evoluti │ │ │ │ │ -00021f10: 6f6e 2c20 2055 703a 2048 6973 746f 7279 on, Up: History │ │ │ │ │ -00021f20: 0a0a 3239 2e31 2054 696d 656c 696e 650a ..29.1 Timeline. │ │ │ │ │ -00021f30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a31 =============..1 │ │ │ │ │ -00021f40: 3939 342d 3039 2d31 3920 4669 7273 7420 994-09-19 First │ │ │ │ │ -00021f50: 4356 5320 636f 6d6d 6974 2e0a 0a20 2020 CVS commit... │ │ │ │ │ -00021f60: 2020 4966 2077 6520 6361 6e20 7472 7573 If we can trus │ │ │ │ │ -00021f70: 7420 7468 6520 4356 5320 7265 706f 7369 t the CVS reposi │ │ │ │ │ -00021f80: 746f 7279 2c20 4461 7669 6420 4a2e 204d tory, David J. M │ │ │ │ │ -00021f90: 6163 4b65 6e7a 6965 2028 646a 6d29 0a20 acKenzie (djm). │ │ │ │ │ -00021fa0: 2020 2020 7374 6172 7465 6420 776f 726b started work │ │ │ │ │ -00021fb0: 696e 6720 6f6e 2041 7574 6f6d 616b 6520 ing on Automake │ │ │ │ │ -00021fc0: 286f 7220 4175 746f 4d61 6b65 2c20 6173 (or AutoMake, as │ │ │ │ │ -00021fd0: 2069 7420 7761 7320 7370 656c 7420 7468 it was spelt th │ │ │ │ │ -00021fe0: 656e 290a 2020 2020 2074 6869 7320 4d6f en). this Mo │ │ │ │ │ -00021ff0: 6e64 6179 2e0a 0a20 2020 2020 5468 6520 nday... The │ │ │ │ │ -00022000: 6669 7273 7420 7665 7273 696f 6e20 6f66 first version of │ │ │ │ │ -00022010: 2074 6865 2027 6175 746f 6d61 6b65 2720 the 'automake' │ │ │ │ │ -00022020: 7363 7269 7074 206c 6f6f 6b73 2061 7320 script looks as │ │ │ │ │ -00022030: 666f 6c6c 6f77 732e 0a0a 2020 2020 2020 follows... │ │ │ │ │ -00022040: 2020 2020 2321 2f62 696e 2f73 680a 0a20 #!/bin/sh.. │ │ │ │ │ -00022050: 2020 2020 2020 2020 2073 7461 7475 733d status= │ │ │ │ │ -00022060: 300a 0a20 2020 2020 2020 2020 2066 6f72 0.. for │ │ │ │ │ -00022070: 206d 616b 6566 696c 650a 2020 2020 2020 makefile. │ │ │ │ │ -00022080: 2020 2020 646f 0a20 2020 2020 2020 2020 do. │ │ │ │ │ -00022090: 2020 2069 6620 7465 7374 2021 202d 6620 if test ! -f │ │ │ │ │ -000220a0: 247b 6d61 6b65 6669 6c65 7d2e 616d 3b20 ${makefile}.am; │ │ │ │ │ -000220b0: 7468 656e 0a20 2020 2020 2020 2020 2020 then. │ │ │ │ │ -000220c0: 2020 2065 6368 6f20 2261 7574 6f6d 616b echo "automak │ │ │ │ │ -000220d0: 653a 2024 7b6d 616b 6566 696c 657d 2e61 e: ${makefile}.a │ │ │ │ │ -000220e0: 6d3a 204e 6f20 7375 6368 2068 6f6e 6b69 m: No such honki │ │ │ │ │ -000220f0: 6e27 2066 696c 6522 0a20 2020 2020 2020 n' file". │ │ │ │ │ -00022100: 2020 2020 2020 2073 7461 7475 733d 310a status=1. │ │ │ │ │ -00022110: 2020 2020 2020 2020 2020 2020 2020 636f co │ │ │ │ │ -00022120: 6e74 696e 7565 0a20 2020 2020 2020 2020 ntinue. │ │ │ │ │ -00022130: 2020 2066 690a 0a20 2020 2020 2020 2020 fi.. │ │ │ │ │ -00022140: 2020 2065 7865 6320 343e 2024 7b6d 616b exec 4> ${mak │ │ │ │ │ -00022150: 6566 696c 657d 2e69 6e0a 0a20 2020 2020 efile}.in.. │ │ │ │ │ -00022160: 2020 2020 2064 6f6e 650a 0a20 2020 2020 done.. │ │ │ │ │ -00022170: 4672 6f6d 2074 6869 7320 796f 7520 6361 From this you ca │ │ │ │ │ -00022180: 6e20 616c 7265 6164 7920 7365 6520 7468 n already see th │ │ │ │ │ -00022190: 6174 2041 7574 6f6d 616b 6520 7769 6c6c at Automake will │ │ │ │ │ -000221a0: 2062 6520 6162 6f75 7420 7265 6164 696e be about readin │ │ │ │ │ -000221b0: 670a 2020 2020 2027 2a2e 616d 2720 6669 g. '*.am' fi │ │ │ │ │ -000221c0: 6c65 2061 6e64 2070 726f 6475 6369 6e67 le and producing │ │ │ │ │ -000221d0: 2027 2a2e 696e 2720 6669 6c65 732e 2020 '*.in' files. │ │ │ │ │ -000221e0: 596f 7520 6361 6e6e 6f74 2073 6565 2061 You cannot see a │ │ │ │ │ -000221f0: 6e79 7468 696e 670a 2020 2020 2065 6c73 nything. els │ │ │ │ │ -00022200: 652c 2062 7574 2069 6620 796f 7520 616c e, but if you al │ │ │ │ │ -00022210: 736f 206b 6e6f 7720 7468 6174 2044 6176 so know that Dav │ │ │ │ │ -00022220: 6964 2069 7320 7468 6520 6f6e 6520 7768 id is the one wh │ │ │ │ │ -00022230: 6f20 6372 6561 7465 640a 2020 2020 2041 o created. A │ │ │ │ │ -00022240: 7574 6f63 6f6e 6620 7477 6f20 7965 6172 utoconf two year │ │ │ │ │ -00022250: 7320 6265 666f 7265 2079 6f75 2063 616e s before you can │ │ │ │ │ -00022260: 2067 7565 7373 2074 6865 2072 6573 742e guess the rest. │ │ │ │ │ -00022270: 0a0a 2020 2020 2053 6576 6572 616c 2063 .. Several c │ │ │ │ │ -00022280: 6f6d 6d69 7473 2066 6f6c 6c6f 772c 2061 ommits follow, a │ │ │ │ │ -00022290: 6e64 2062 7920 7468 6520 656e 6420 6f66 nd by the end of │ │ │ │ │ -000222a0: 2074 6865 2064 6179 2041 7574 6f6d 616b the day Automak │ │ │ │ │ -000222b0: 6520 6973 0a20 2020 2020 7265 706f 7274 e is. report │ │ │ │ │ -000222c0: 6564 2074 6f20 776f 726b 2066 6f72 2047 ed to work for G │ │ │ │ │ -000222d0: 4e55 2066 696c 6575 7469 6c73 2061 6e64 NU fileutils and │ │ │ │ │ -000222e0: 2047 4e55 206d 342e 0a0a 2020 2020 2054 GNU m4... T │ │ │ │ │ -000222f0: 6865 206d 6f64 7573 206f 7065 7261 6e64 he modus operand │ │ │ │ │ -00022300: 6920 6973 2074 6865 206f 6e65 2074 6861 i is the one tha │ │ │ │ │ -00022310: 7420 6973 2073 7469 6c6c 2075 7365 6420 t is still used │ │ │ │ │ -00022320: 746f 6461 793a 2076 6172 6961 626c 650a today: variable. │ │ │ │ │ -00022330: 2020 2020 2061 7373 6967 6e6d 656e 7473 assignments │ │ │ │ │ -00022340: 2069 6e20 274d 616b 6566 696c 652e 616d in 'Makefile.am │ │ │ │ │ -00022350: 2720 6669 6c65 7320 7472 6967 6765 7220 ' files trigger │ │ │ │ │ -00022360: 696e 6a65 6374 696f 6e73 206f 6620 7072 injections of pr │ │ │ │ │ -00022370: 6563 616e 6e65 640a 2020 2020 2027 4d61 ecanned. 'Ma │ │ │ │ │ -00022380: 6b65 6669 6c65 2720 6672 6167 6d65 6e74 kefile' fragment │ │ │ │ │ -00022390: 7320 696e 746f 2074 6865 2067 656e 6572 s into the gener │ │ │ │ │ -000223a0: 6174 6564 2027 4d61 6b65 6669 6c65 2e69 ated 'Makefile.i │ │ │ │ │ -000223b0: 6e27 2e20 2054 6865 2075 7365 206f 660a n'. The use of. │ │ │ │ │ -000223c0: 2020 2020 2027 4d61 6b65 6669 6c65 2720 'Makefile' │ │ │ │ │ -000223d0: 6672 6167 6d65 6e74 7320 7761 7320 696e fragments was in │ │ │ │ │ -000223e0: 7370 6972 6564 2062 7920 7468 6520 342e spired by the 4. │ │ │ │ │ -000223f0: 3442 5344 2027 6d61 6b65 2720 616e 6420 4BSD 'make' and │ │ │ │ │ -00022400: 696e 636c 7564 650a 2020 2020 2066 696c include. fil │ │ │ │ │ -00022410: 6573 2c20 686f 7765 7665 7220 4175 746f es, however Auto │ │ │ │ │ -00022420: 6d61 6b65 2061 696d 7320 746f 2062 6520 make aims to be │ │ │ │ │ -00022430: 706f 7274 6162 6c65 2061 6e64 2074 6f20 portable and to │ │ │ │ │ -00022440: 636f 6e66 6f72 6d20 746f 2074 6865 0a20 conform to the. │ │ │ │ │ -00022450: 2020 2020 474e 5520 7374 616e 6461 7264 GNU standard │ │ │ │ │ -00022460: 7320 666f 7220 274d 616b 6566 696c 6527 s for 'Makefile' │ │ │ │ │ -00022470: 2076 6172 6961 626c 6573 2061 6e64 2074 variables and t │ │ │ │ │ -00022480: 6172 6765 7473 2e0a 0a20 2020 2020 4174 argets... At │ │ │ │ │ -00022490: 2074 6869 7320 706f 696e 742c 2074 6865 this point, the │ │ │ │ │ -000224a0: 206d 6f73 7420 7265 6365 6e74 2072 656c most recent rel │ │ │ │ │ -000224b0: 6561 7365 206f 6620 4175 746f 636f 6e66 ease of Autoconf │ │ │ │ │ -000224c0: 2069 7320 7665 7273 696f 6e20 312e 3131 is version 1.11 │ │ │ │ │ -000224d0: 2c0a 2020 2020 2061 6e64 2044 6176 6964 ,. and David │ │ │ │ │ -000224e0: 2069 7320 7072 6570 6172 696e 6720 746f is preparing to │ │ │ │ │ -000224f0: 2072 656c 6561 7365 2041 7574 6f63 6f6e release Autocon │ │ │ │ │ -00022500: 6620 322e 3020 696e 206c 6174 6520 4f63 f 2.0 in late Oc │ │ │ │ │ -00022510: 746f 6265 722e 2020 4173 0a20 2020 2020 tober. As. │ │ │ │ │ -00022520: 6120 6d61 7474 6572 206f 6620 6661 6374 a matter of fact │ │ │ │ │ -00022530: 2c20 6865 2077 696c 6c20 6261 7265 6c79 , he will barely │ │ │ │ │ -00022540: 2074 6f75 6368 2041 7574 6f6d 616b 6520 touch Automake │ │ │ │ │ -00022550: 6166 7465 7220 5365 7074 656d 6265 722e after September. │ │ │ │ │ -00022560: 0a0a 3139 3934 2d31 312d 3035 2044 6176 ..1994-11-05 Dav │ │ │ │ │ -00022570: 6964 204d 6163 4b65 6e7a 6965 2773 206c id MacKenzie's l │ │ │ │ │ -00022580: 6173 7420 636f 6d6d 6974 2e0a 0a20 2020 ast commit... │ │ │ │ │ -00022590: 2020 4174 2074 6869 7320 706f 696e 7420 At this point │ │ │ │ │ -000225a0: 4175 746f 6d61 6b65 2069 7320 6120 3230 Automake is a 20 │ │ │ │ │ -000225b0: 3020 6c69 6e65 2070 6f72 7461 626c 6520 0 line portable │ │ │ │ │ -000225c0: 7368 656c 6c20 7363 7269 7074 2c20 706c shell script, pl │ │ │ │ │ -000225d0: 7573 0a20 2020 2020 3333 3220 6c69 6e65 us. 332 line │ │ │ │ │ -000225e0: 7320 6f66 2027 4d61 6b65 6669 6c65 2720 s of 'Makefile' │ │ │ │ │ -000225f0: 6672 6167 6d65 6e74 732e 2020 496e 2074 fragments. In t │ │ │ │ │ -00022600: 6865 2027 5245 4144 4d45 272c 2044 6176 he 'README', Dav │ │ │ │ │ -00022610: 6964 2073 7461 7465 730a 2020 2020 2068 id states. h │ │ │ │ │ -00022620: 6973 2061 6d62 6976 616c 656e 6365 2062 is ambivalence b │ │ │ │ │ -00022630: 6574 7765 656e 2022 706f 7274 6162 6c65 etween "portable │ │ │ │ │ -00022640: 2073 6865 6c6c 2220 616e 6420 226d 6f72 shell" and "mor │ │ │ │ │ -00022650: 6520 6170 7072 6f70 7269 6174 650a 2020 e appropriate. │ │ │ │ │ -00022660: 2020 206c 616e 6775 6167 6522 3a0a 0a20 language":.. │ │ │ │ │ -00022670: 2020 2020 2020 2020 2049 2077 726f 7465 I wrote │ │ │ │ │ -00022680: 2069 7420 6b65 6570 696e 6720 696e 206d it keeping in m │ │ │ │ │ -00022690: 696e 6420 7468 6520 706f 7373 6962 696c ind the possibil │ │ │ │ │ -000226a0: 6974 7920 6f66 2069 7420 6265 636f 6d69 ity of it becomi │ │ │ │ │ -000226b0: 6e67 2061 6e0a 2020 2020 2020 2020 2020 ng an. │ │ │ │ │ -000226c0: 4175 746f 636f 6e66 206d 6163 726f 2c20 Autoconf macro, │ │ │ │ │ -000226d0: 736f 2069 7420 776f 756c 6420 7275 6e20 so it would run │ │ │ │ │ -000226e0: 6174 2063 6f6e 6669 6775 7265 2d74 696d at configure-tim │ │ │ │ │ -000226f0: 652e 2020 5468 6174 2077 6f75 6c64 0a20 e. That would. │ │ │ │ │ -00022700: 2020 2020 2020 2020 2073 6c6f 7720 636f slow co │ │ │ │ │ -00022710: 6e66 6967 7572 6174 696f 6e20 646f 776e nfiguration down │ │ │ │ │ -00022720: 2061 2062 6974 2c20 6275 7420 616c 6c6f a bit, but allo │ │ │ │ │ -00022730: 7720 7573 6572 7320 746f 206d 6f64 6966 w users to modif │ │ │ │ │ -00022740: 7920 7468 650a 2020 2020 2020 2020 2020 y the. │ │ │ │ │ -00022750: 4d61 6b65 6669 6c65 2e61 6d20 7769 7468 Makefile.am with │ │ │ │ │ -00022760: 6f75 7420 6e65 6564 696e 6720 746f 2066 out needing to f │ │ │ │ │ -00022770: 6574 6368 2074 6865 2041 7574 6f4d 616b etch the AutoMak │ │ │ │ │ -00022780: 6520 7061 636b 6167 652e 0a20 2020 2020 e package.. │ │ │ │ │ -00022790: 2020 2020 2041 6e64 2c20 7468 6520 4d61 And, the Ma │ │ │ │ │ -000227a0: 6b65 6669 6c65 2e69 6e20 6669 6c65 7320 kefile.in files │ │ │ │ │ -000227b0: 776f 756c 646e 2774 206e 6565 6420 746f wouldn't need to │ │ │ │ │ -000227c0: 2062 6520 6469 7374 7269 6275 7465 642e be distributed. │ │ │ │ │ -000227d0: 0a20 2020 2020 2020 2020 2042 7574 2061 . But a │ │ │ │ │ -000227e0: 6c6c 206f 6620 4175 746f 4d61 6b65 2077 ll of AutoMake w │ │ │ │ │ -000227f0: 6f75 6c64 2e20 2053 6f20 4920 6d69 6768 ould. So I migh │ │ │ │ │ -00022800: 7420 7265 696d 706c 656d 656e 7420 4175 t reimplement Au │ │ │ │ │ -00022810: 746f 4d61 6b65 2069 6e0a 2020 2020 2020 toMake in. │ │ │ │ │ -00022820: 2020 2020 5065 726c 2c20 6d34 2c20 6f72 Perl, m4, or │ │ │ │ │ -00022830: 2073 6f6d 6520 6f74 6865 7220 6d6f 7265 some other more │ │ │ │ │ -00022840: 2061 7070 726f 7072 6961 7465 206c 616e appropriate lan │ │ │ │ │ -00022850: 6775 6167 652e 0a0a 2020 2020 2041 7574 guage... Aut │ │ │ │ │ -00022860: 6f6d 616b 6520 6973 2064 6573 6372 6962 omake is describ │ │ │ │ │ -00022870: 6564 2061 7320 2261 6e20 6578 7065 7269 ed as "an experi │ │ │ │ │ -00022880: 6d65 6e74 616c 204d 616b 6566 696c 6520 mental Makefile │ │ │ │ │ -00022890: 6765 6e65 7261 746f 7222 2e0a 2020 2020 generator".. │ │ │ │ │ -000228a0: 2054 6865 7265 2069 7320 6e6f 2064 6f63 There is no doc │ │ │ │ │ -000228b0: 756d 656e 7461 7469 6f6e 2e20 2041 6476 umentation. Adv │ │ │ │ │ -000228c0: 656e 7475 726f 7573 2075 7365 7273 2061 enturous users a │ │ │ │ │ -000228d0: 7265 2072 6566 6572 7265 6420 746f 2074 re referred to t │ │ │ │ │ -000228e0: 6865 0a20 2020 2020 6578 616d 706c 6573 he. examples │ │ │ │ │ -000228f0: 2061 6e64 2070 6174 6368 6573 206e 6565 and patches nee │ │ │ │ │ -00022900: 6465 6420 746f 2075 7365 2041 7574 6f6d ded to use Autom │ │ │ │ │ -00022910: 616b 6520 7769 7468 2047 4e55 206d 3420 ake with GNU m4 │ │ │ │ │ -00022920: 312e 332c 0a20 2020 2020 6669 6c65 7574 1.3,. fileut │ │ │ │ │ -00022930: 696c 7320 332e 392c 2074 696d 6520 312e ils 3.9, time 1. │ │ │ │ │ -00022940: 362c 2061 6e64 2064 6576 656c 6f70 6d65 6, and developme │ │ │ │ │ -00022950: 6e74 2076 6572 7369 6f6e 7320 6f66 2066 nt versions of f │ │ │ │ │ -00022960: 696e 6420 616e 640a 2020 2020 2069 6e64 ind and. ind │ │ │ │ │ -00022970: 656e 742e 0a0a 2020 2020 2054 6865 7365 ent... These │ │ │ │ │ -00022980: 2065 7861 6d70 6c65 7320 7365 656d 2074 examples seem t │ │ │ │ │ -00022990: 6f20 6861 7665 2062 6565 6e20 6c6f 7374 o have been lost │ │ │ │ │ -000229a0: 2e20 2048 6f77 6576 6572 2061 7420 7468 . However at th │ │ │ │ │ -000229b0: 6520 7469 6d65 206f 660a 2020 2020 2077 e time of. w │ │ │ │ │ -000229c0: 7269 7469 6e67 2028 3130 2079 6561 7273 riting (10 years │ │ │ │ │ -000229d0: 206c 6174 6572 2069 6e20 5365 7074 656d later in Septem │ │ │ │ │ -000229e0: 6265 722c 2032 3030 3429 2074 6865 2046 ber, 2004) the F │ │ │ │ │ -000229f0: 5346 2073 7469 6c6c 0a20 2020 2020 6469 SF still. di │ │ │ │ │ -00022a00: 7374 7269 6275 7465 7320 6120 7061 636b stributes a pack │ │ │ │ │ -00022a10: 6167 6520 7468 6174 2075 7365 7320 7468 age that uses th │ │ │ │ │ -00022a20: 6973 2076 6572 7369 6f6e 206f 6620 4175 is version of Au │ │ │ │ │ -00022a30: 746f 6d61 6b65 3a20 6368 6563 6b20 6f75 tomake: check ou │ │ │ │ │ -00022a40: 740a 2020 2020 2047 4e55 2074 6572 6d75 t. GNU termu │ │ │ │ │ -00022a50: 7469 6c73 2032 2e30 2e0a 0a31 3939 352d tils 2.0...1995- │ │ │ │ │ -00022a60: 3131 2d31 3220 546f 6d20 5472 6f6d 6579 11-12 Tom Tromey │ │ │ │ │ -00022a70: 2773 2066 6972 7374 2063 6f6d 6d69 742e 's first commit. │ │ │ │ │ -00022a80: 0a0a 2020 2020 2041 6674 6572 206f 6e65 .. After one │ │ │ │ │ -00022a90: 2079 6561 7220 6f66 2069 6e61 6374 6976 year of inactiv │ │ │ │ │ -00022aa0: 6974 792c 2054 6f6d 2054 726f 6d65 7920 ity, Tom Tromey │ │ │ │ │ -00022ab0: 7461 6b65 7320 6f76 6572 2074 6865 2070 takes over the p │ │ │ │ │ -00022ac0: 6163 6b61 6765 2e0a 2020 2020 2054 6f6d ackage.. Tom │ │ │ │ │ -00022ad0: 2077 6173 2077 6f72 6b69 6e67 206f 6e20 was working on │ │ │ │ │ -00022ae0: 474e 5520 6370 696f 2062 6163 6b20 7468 GNU cpio back th │ │ │ │ │ -00022af0: 656e 2c20 616e 6420 646f 696e 6720 7468 en, and doing th │ │ │ │ │ -00022b00: 6973 206a 7573 7420 666f 7220 6675 6e2c is just for fun, │ │ │ │ │ -00022b10: 0a20 2020 2020 6861 7669 6e67 2074 726f . having tro │ │ │ │ │ -00022b20: 7562 6c65 2066 696e 6469 6e67 2061 2070 uble finding a p │ │ │ │ │ -00022b30: 726f 6a65 6374 2074 6f20 636f 6e74 7269 roject to contri │ │ │ │ │ -00022b40: 6275 7465 2074 6f2e 2020 536f 2077 6869 bute to. So whi │ │ │ │ │ -00022b50: 6c65 0a20 2020 2020 6861 636b 696e 6720 le. hacking │ │ │ │ │ -00022b60: 6865 2077 616e 7465 6420 746f 2062 7269 he wanted to bri │ │ │ │ │ -00022b70: 6e67 2074 6865 2027 4d61 6b65 6669 6c65 ng the 'Makefile │ │ │ │ │ -00022b80: 2e69 6e27 2075 7020 746f 2047 4e55 2073 .in' up to GNU s │ │ │ │ │ -00022b90: 7461 6e64 6172 6473 2e0a 2020 2020 2054 tandards.. T │ │ │ │ │ -00022ba0: 6869 7320 7761 7320 6861 7264 2c20 616e his was hard, an │ │ │ │ │ -00022bb0: 6420 6f6e 6520 6461 7920 6865 2073 6177 d one day he saw │ │ │ │ │ -00022bc0: 2041 7574 6f6d 616b 6520 6f6e 0a20 2020 Automake on. │ │ │ │ │ -00022bd0: 2020 3c66 7470 3a2f 2f61 6c70 6861 2e67 , grabbe │ │ │ │ │ -00022bf0: 6420 6974 2061 6e64 2074 7269 6564 2069 d it and tried i │ │ │ │ │ -00022c00: 7420 6f75 742e 0a0a 2020 2020 2054 6f6d t out... Tom │ │ │ │ │ -00022c10: 2064 6964 6e27 7420 7461 6c6b 2074 6f20 didn't talk to │ │ │ │ │ -00022c20: 646a 6d20 6162 6f75 7420 6974 2075 6e74 djm about it unt │ │ │ │ │ -00022c30: 696c 206c 6174 6572 2c20 6a75 7374 2074 il later, just t │ │ │ │ │ -00022c40: 6f20 6d61 6b65 2073 7572 6520 6865 0a20 o make sure he. │ │ │ │ │ -00022c50: 2020 2020 6469 646e 2774 206d 696e 6420 didn't mind │ │ │ │ │ -00022c60: 6966 2068 6520 6d61 6465 2061 2072 656c if he made a rel │ │ │ │ │ -00022c70: 6561 7365 2e20 2048 6520 6469 6420 6120 ease. He did a │ │ │ │ │ -00022c80: 6275 6e63 6820 6f66 2065 6172 6c79 2072 bunch of early r │ │ │ │ │ -00022c90: 656c 6561 7365 730a 2020 2020 2074 6f20 eleases. to │ │ │ │ │ -00022ca0: 7468 6520 476e 6974 7320 666f 6c6b 732e the Gnits folks. │ │ │ │ │ -00022cb0: 0a0a 2020 2020 2047 6e69 7473 2077 6173 .. Gnits was │ │ │ │ │ -00022cc0: 2028 616e 6420 7374 696c 6c20 6973 2920 (and still is) │ │ │ │ │ -00022cd0: 746f 7461 6c6c 7920 696e 666f 726d 616c totally informal │ │ │ │ │ -00022ce0: 2c20 6a75 7374 2061 2066 6577 2047 4e55 , just a few GNU │ │ │ │ │ -00022cf0: 2066 7269 656e 6473 0a20 2020 2020 7768 friends. wh │ │ │ │ │ -00022d00: 6f20 4672 616e c3a7 6f69 7320 5069 6e61 o Fran..ois Pina │ │ │ │ │ -00022d10: 7264 206b 6e65 772c 2077 686f 2077 6572 rd knew, who wer │ │ │ │ │ -00022d20: 6520 616c 6c20 696e 7465 7265 7374 6564 e all interested │ │ │ │ │ -00022d30: 2069 6e20 6d61 6b69 6e67 2061 0a20 2020 in making a. │ │ │ │ │ -00022d40: 2020 636f 6d6d 6f6e 2069 6e66 7261 7374 common infrast │ │ │ │ │ -00022d50: 7275 6374 7572 6520 666f 7220 474e 5520 ructure for GNU │ │ │ │ │ -00022d60: 7072 6f6a 6563 7473 2c20 616e 6420 7368 projects, and sh │ │ │ │ │ -00022d70: 6172 6564 2061 2073 696d 696c 6172 0a20 ared a similar. │ │ │ │ │ -00022d80: 2020 2020 6f75 746c 6f6f 6b20 6f6e 2068 outlook on h │ │ │ │ │ -00022d90: 6f77 2074 6f20 646f 2069 742e 2020 536f ow to do it. So │ │ │ │ │ -00022da0: 2074 6865 7920 7765 7265 2061 626c 6520 they were able │ │ │ │ │ -00022db0: 746f 206d 616b 6520 736f 6d65 2070 726f to make some pro │ │ │ │ │ -00022dc0: 6772 6573 732e 0a20 2020 2020 4974 2063 gress.. It c │ │ │ │ │ -00022dd0: 616d 6520 616c 6f6e 6720 7769 7468 2041 ame along with A │ │ │ │ │ -00022de0: 7574 6f63 6f6e 6620 616e 6420 6578 7465 utoconf and exte │ │ │ │ │ -00022df0: 6e73 696f 6e73 2074 6865 7265 6f66 2c20 nsions thereof, │ │ │ │ │ -00022e00: 616e 6420 7468 656e 0a20 2020 2020 4175 and then. Au │ │ │ │ │ -00022e10: 746f 6d61 6b65 2066 726f 6d20 4461 7669 tomake from Davi │ │ │ │ │ -00022e20: 6420 616e 6420 546f 6d20 2877 686f 2077 d and Tom (who w │ │ │ │ │ -00022e30: 6572 6520 626f 7468 2067 6e69 7473 6961 ere both gnitsia │ │ │ │ │ -00022e40: 6e73 292e 2020 4f6e 6520 6f66 0a20 2020 ns). One of. │ │ │ │ │ -00022e50: 2020 7468 6569 7220 6964 6561 7320 7761 their ideas wa │ │ │ │ │ -00022e60: 7320 746f 2077 7269 7465 2061 2064 6f63 s to write a doc │ │ │ │ │ -00022e70: 756d 656e 7420 7061 7261 6c6c 656c 696e ument parallelin │ │ │ │ │ -00022e80: 6720 7468 6520 474e 5520 7374 616e 6461 g the GNU standa │ │ │ │ │ -00022e90: 7264 732c 0a20 2020 2020 7468 6174 2077 rds,. that w │ │ │ │ │ -00022ea0: 6173 206d 6f72 6520 7374 7269 6374 2069 as more strict i │ │ │ │ │ -00022eb0: 6e20 736f 6d65 2077 6179 7320 616e 6420 n some ways and │ │ │ │ │ -00022ec0: 6d6f 7265 2064 6574 6169 6c65 642e 2020 more detailed. │ │ │ │ │ -00022ed0: 5468 6579 206e 6576 6572 0a20 2020 2020 They never. │ │ │ │ │ -00022ee0: 6669 6e69 7368 6564 2074 6865 2047 4e49 finished the GNI │ │ │ │ │ -00022ef0: 5453 2073 7461 6e64 6172 6473 2c20 6275 TS standards, bu │ │ │ │ │ -00022f00: 7420 7468 6520 6964 6561 7320 6d6f 7374 t the ideas most │ │ │ │ │ -00022f10: 6c79 206d 6164 6520 7468 6569 7220 7761 ly made their wa │ │ │ │ │ -00022f20: 790a 2020 2020 2069 6e74 6f20 4175 746f y. into Auto │ │ │ │ │ -00022f30: 6d61 6b65 2e0a 0a31 3939 352d 3131 2d32 make...1995-11-2 │ │ │ │ │ -00022f40: 3320 4175 746f 6d61 6b65 2030 2e32 300a 3 Automake 0.20. │ │ │ │ │ -00022f50: 0a20 2020 2020 4265 7369 6465 7320 696e . Besides in │ │ │ │ │ -00022f60: 7472 6f64 7563 696e 6720 6175 746f 6d61 troducing automa │ │ │ │ │ -00022f70: 7469 6320 6465 7065 6e64 656e 6379 2074 tic dependency t │ │ │ │ │ -00022f80: 7261 636b 696e 6720 282a 6e6f 7465 2044 racking (*note D │ │ │ │ │ -00022f90: 6570 656e 6465 6e63 790a 2020 2020 2054 ependency. T │ │ │ │ │ -00022fa0: 7261 636b 696e 6720 4576 6f6c 7574 696f racking Evolutio │ │ │ │ │ -00022fb0: 6e3a 3a29 2c20 7468 6973 2076 6572 7369 n::), this versi │ │ │ │ │ -00022fc0: 6f6e 2061 6c73 6f20 7375 7070 6c69 6573 on also supplies │ │ │ │ │ -00022fd0: 2061 2039 2d70 6167 6520 6d61 6e75 616c a 9-page manual │ │ │ │ │ -00022fe0: 2e0a 0a20 2020 2020 4174 2074 6869 7320 ... At this │ │ │ │ │ -00022ff0: 7469 6d65 2027 6163 6c6f 6361 6c27 2061 time 'aclocal' a │ │ │ │ │ -00023000: 6e64 2027 414d 5f49 4e49 545f 4155 544f nd 'AM_INIT_AUTO │ │ │ │ │ -00023010: 4d41 4b45 2720 6469 6420 6e6f 7420 6578 MAKE' did not ex │ │ │ │ │ -00023020: 6973 742c 2073 6f0a 2020 2020 206d 616e ist, so. man │ │ │ │ │ -00023030: 7920 7468 696e 6773 2068 6164 2074 6f20 y things had to │ │ │ │ │ -00023040: 6265 2064 6f6e 6520 6279 2068 616e 642e be done by hand. │ │ │ │ │ -00023050: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ -00023060: 6865 7265 2069 7320 7768 6174 2061 0a20 here is what a. │ │ │ │ │ -00023070: 2020 2020 636f 6e66 6967 7572 652e 696e configure.in │ │ │ │ │ -00023080: 2028 7468 6973 2069 7320 7468 6520 666f (this is the fo │ │ │ │ │ -00023090: 726d 6572 206e 616d 6520 6f66 2074 6865 rmer name of the │ │ │ │ │ -000230a0: 2027 636f 6e66 6967 7572 652e 6163 2720 'configure.ac' │ │ │ │ │ -000230b0: 7765 2075 7365 0a20 2020 2020 746f 6461 we use. toda │ │ │ │ │ -000230c0: 7929 206d 7573 7420 636f 6e74 6169 6e20 y) must contain │ │ │ │ │ -000230d0: 696e 206f 7264 6572 2074 6f20 7573 6520 in order to use │ │ │ │ │ -000230e0: 4175 746f 6d61 6b65 2030 2e32 303a 0a0a Automake 0.20:.. │ │ │ │ │ -000230f0: 2020 2020 2020 2020 2020 5041 434b 4147 PACKAG │ │ │ │ │ -00023100: 453d 6370 696f 0a20 2020 2020 2020 2020 E=cpio. │ │ │ │ │ -00023110: 2056 4552 5349 4f4e 3d32 2e33 2e39 3131 VERSION=2.3.911 │ │ │ │ │ -00023120: 0a20 2020 2020 2020 2020 2041 435f 4445 . AC_DE │ │ │ │ │ -00023130: 4649 4e45 5f55 4e51 554f 5445 4428 5041 FINE_UNQUOTED(PA │ │ │ │ │ -00023140: 434b 4147 452c 2022 2450 4143 4b41 4745 CKAGE, "$PACKAGE │ │ │ │ │ -00023150: 2229 0a20 2020 2020 2020 2020 2041 435f "). AC_ │ │ │ │ │ -00023160: 4445 4649 4e45 5f55 4e51 554f 5445 4428 DEFINE_UNQUOTED( │ │ │ │ │ -00023170: 5645 5253 494f 4e2c 2022 2456 4552 5349 VERSION, "$VERSI │ │ │ │ │ -00023180: 4f4e 2229 0a20 2020 2020 2020 2020 2041 ON"). A │ │ │ │ │ -00023190: 435f 5355 4253 5428 5041 434b 4147 4529 C_SUBST(PACKAGE) │ │ │ │ │ -000231a0: 0a20 2020 2020 2020 2020 2041 435f 5355 . AC_SU │ │ │ │ │ -000231b0: 4253 5428 5645 5253 494f 4e29 0a20 2020 BST(VERSION). │ │ │ │ │ -000231c0: 2020 2020 2020 2041 435f 4152 475f 5052 AC_ARG_PR │ │ │ │ │ -000231d0: 4f47 5241 4d0a 2020 2020 2020 2020 2020 OGRAM. │ │ │ │ │ -000231e0: 4143 5f50 524f 475f 494e 5354 414c 4c0a AC_PROG_INSTALL. │ │ │ │ │ -000231f0: 0a20 2020 2020 2854 6f64 6179 2061 6c6c . (Today all │ │ │ │ │ -00023200: 206f 6620 7468 6520 6162 6f76 6520 6973 of the above is │ │ │ │ │ -00023210: 2061 6368 6965 7665 6420 6279 2027 4143 achieved by 'AC │ │ │ │ │ -00023220: 5f49 4e49 5427 2061 6e64 0a20 2020 2020 _INIT' and. │ │ │ │ │ -00023230: 2741 4d5f 494e 4954 5f41 5554 4f4d 414b 'AM_INIT_AUTOMAK │ │ │ │ │ -00023240: 4527 2e29 0a0a 2020 2020 2048 6572 6520 E'.).. Here │ │ │ │ │ -00023250: 6973 2068 6f77 2070 726f 6772 616d 7320 is how programs │ │ │ │ │ -00023260: 6172 6520 7370 6563 6966 6965 6420 696e are specified in │ │ │ │ │ -00023270: 2027 4d61 6b65 6669 6c65 2e61 6d27 3a0a 'Makefile.am':. │ │ │ │ │ -00023280: 0a20 2020 2020 2020 2020 2050 524f 4752 . PROGR │ │ │ │ │ -00023290: 414d 5320 3d20 6865 6c6c 6f0a 2020 2020 AMS = hello. │ │ │ │ │ -000232a0: 2020 2020 2020 6865 6c6c 6f5f 534f 5552 hello_SOUR │ │ │ │ │ -000232b0: 4345 5320 3d20 6865 6c6c 6f2e 630a 0a20 CES = hello.c.. │ │ │ │ │ -000232c0: 2020 2020 5468 6973 206c 6f6f 6b73 2070 This looks p │ │ │ │ │ -000232d0: 7265 7474 7920 6d75 6368 206c 696b 6520 retty much like │ │ │ │ │ -000232e0: 7768 6174 2077 6520 646f 2074 6f64 6179 what we do today │ │ │ │ │ -000232f0: 2c20 6578 6365 7074 2074 6865 2027 5052 , except the 'PR │ │ │ │ │ -00023300: 4f47 5241 4d53 270a 2020 2020 2076 6172 OGRAMS'. var │ │ │ │ │ -00023310: 6961 626c 6520 6861 7320 6e6f 2064 6972 iable has no dir │ │ │ │ │ -00023320: 6563 746f 7279 2070 7265 6669 7820 7370 ectory prefix sp │ │ │ │ │ -00023330: 6563 6966 7969 6e67 2077 6865 7265 2027 ecifying where ' │ │ │ │ │ -00023340: 6865 6c6c 6f27 2073 686f 756c 6420 6265 hello' should be │ │ │ │ │ -00023350: 0a20 2020 2020 696e 7374 616c 6c65 643a . installed: │ │ │ │ │ -00023360: 2061 6c6c 2070 726f 6772 616d 7320 6172 all programs ar │ │ │ │ │ -00023370: 6520 696e 7374 616c 6c65 6420 696e 2027 e installed in ' │ │ │ │ │ -00023380: 2428 6269 6e64 6972 2927 2e0a 2020 2020 $(bindir)'.. │ │ │ │ │ -00023390: 2027 4c49 4250 524f 4752 414d 5327 2063 'LIBPROGRAMS' c │ │ │ │ │ -000233a0: 616e 2062 6520 7573 6564 2074 6f20 7370 an be used to sp │ │ │ │ │ -000233b0: 6563 6966 7920 7072 6f67 7261 6d73 2074 ecify programs t │ │ │ │ │ -000233c0: 6861 7420 6d75 7374 2062 6520 6275 696c hat must be buil │ │ │ │ │ -000233d0: 740a 2020 2020 2062 7574 206e 6f74 2069 t. but not i │ │ │ │ │ -000233e0: 6e73 7461 6c6c 6564 2028 6974 2069 7320 nstalled (it is │ │ │ │ │ -000233f0: 6361 6c6c 6564 2027 6e6f 696e 7374 5f50 called 'noinst_P │ │ │ │ │ -00023400: 524f 4752 414d 5327 206e 6f77 6164 6179 ROGRAMS' nowaday │ │ │ │ │ -00023410: 7329 2e0a 0a20 2020 2020 5072 6f67 7261 s)... Progra │ │ │ │ │ -00023420: 6d73 2063 616e 2062 6520 6275 696c 7420 ms can be built │ │ │ │ │ -00023430: 636f 6e64 6974 696f 6e61 6c6c 7920 7573 conditionally us │ │ │ │ │ -00023440: 696e 6720 2741 435f 5355 4253 5427 6974 ing 'AC_SUBST'it │ │ │ │ │ -00023450: 7574 696f 6e73 3a0a 0a20 2020 2020 2020 utions:.. │ │ │ │ │ -00023460: 2020 2050 524f 4752 414d 5320 3d20 4070 PROGRAMS = @p │ │ │ │ │ -00023470: 726f 6773 400a 2020 2020 2020 2020 2020 rogs@. │ │ │ │ │ -00023480: 414d 5f50 524f 4752 414d 5320 3d20 666f AM_PROGRAMS = fo │ │ │ │ │ -00023490: 6f20 6261 7220 6261 7a0a 0a20 2020 2020 o bar baz.. │ │ │ │ │ -000234a0: 2827 414d 5f50 524f 4752 414d 5327 2068 ('AM_PROGRAMS' h │ │ │ │ │ -000234b0: 6173 2073 696e 6365 2074 6865 6e20 6265 as since then be │ │ │ │ │ -000234c0: 656e 2072 656e 616d 6564 2074 6f20 2745 en renamed to 'E │ │ │ │ │ -000234d0: 5854 5241 5f50 524f 4752 414d 5327 2e29 XTRA_PROGRAMS'.) │ │ │ │ │ -000234e0: 0a0a 2020 2020 2053 696d 696c 6172 6c79 .. Similarly │ │ │ │ │ -000234f0: 2073 6372 6970 7473 2c20 7374 6174 6963 scripts, static │ │ │ │ │ -00023500: 206c 6962 7261 7269 6573 2c20 616e 6420 libraries, and │ │ │ │ │ -00023510: 6461 7461 2063 616e 2062 6520 6275 696c data can be buil │ │ │ │ │ -00023520: 7420 616e 640a 2020 2020 2069 6e73 7461 t and. insta │ │ │ │ │ -00023530: 6c6c 6564 2075 7369 6e67 2074 6865 2027 lled using the ' │ │ │ │ │ -00023540: 4c49 4252 4152 4945 5327 2c20 2753 4352 LIBRARIES', 'SCR │ │ │ │ │ -00023550: 4950 5453 272c 2061 6e64 2027 4441 5441 IPTS', and 'DATA │ │ │ │ │ -00023560: 2720 7661 7269 6162 6c65 732e 0a20 2020 ' variables.. │ │ │ │ │ -00023570: 2020 486f 7765 7665 7220 274c 4942 5241 However 'LIBRA │ │ │ │ │ -00023580: 5249 4553 2720 7765 7265 2074 7265 6174 RIES' were treat │ │ │ │ │ -00023590: 6564 2061 2062 6974 2073 7065 6369 616c ed a bit special │ │ │ │ │ -000235a0: 6c79 2069 6e20 7468 6174 2041 7574 6f6d ly in that Autom │ │ │ │ │ -000235b0: 616b 650a 2020 2020 2064 6964 2061 7574 ake. did aut │ │ │ │ │ -000235c0: 6f6d 6174 6963 616c 6c79 2073 7570 706c omatically suppl │ │ │ │ │ -000235d0: 7920 7468 6520 276c 6962 2720 616e 6420 y the 'lib' and │ │ │ │ │ -000235e0: 272e 6127 2070 7265 6669 7865 732e 2020 '.a' prefixes. │ │ │ │ │ -000235f0: 5468 6572 6566 6f72 6520 746f 0a20 2020 Therefore to. │ │ │ │ │ -00023600: 2020 6275 696c 6420 276c 6962 6370 696f build 'libcpio │ │ │ │ │ -00023610: 2e61 272c 206f 6e65 2068 6164 2074 6f20 .a', one had to │ │ │ │ │ -00023620: 7772 6974 650a 0a20 2020 2020 2020 2020 write.. │ │ │ │ │ -00023630: 204c 4942 5241 5249 4553 203d 2063 7069 LIBRARIES = cpi │ │ │ │ │ -00023640: 6f0a 2020 2020 2020 2020 2020 6370 696f o. cpio │ │ │ │ │ -00023650: 5f53 4f55 5243 4553 203d 202e 2e2e 0a0a _SOURCES = ..... │ │ │ │ │ -00023660: 2020 2020 2045 7874 7261 2066 696c 6573 Extra files │ │ │ │ │ -00023670: 2074 6f20 6469 7374 7269 6275 7465 206d to distribute m │ │ │ │ │ -00023680: 7573 7420 6265 206c 6973 7465 6420 696e ust be listed in │ │ │ │ │ -00023690: 2027 4449 5354 5f4f 5448 4552 2720 2874 'DIST_OTHER' (t │ │ │ │ │ -000236a0: 6865 0a20 2020 2020 616e 6365 7374 6f72 he. ancestor │ │ │ │ │ -000236b0: 206f 6620 2745 5854 5241 5f44 4953 5427 of 'EXTRA_DIST' │ │ │ │ │ -000236c0: 292e 2020 416c 736f 2065 7874 7261 2064 ). Also extra d │ │ │ │ │ -000236d0: 6972 6563 746f 7269 6573 2074 6861 7420 irectories that │ │ │ │ │ -000236e0: 6172 6520 746f 2062 650a 2020 2020 2064 are to be. d │ │ │ │ │ -000236f0: 6973 7472 6962 7574 6564 2073 686f 756c istributed shoul │ │ │ │ │ -00023700: 6420 6170 7065 6172 2069 6e20 2744 4953 d appear in 'DIS │ │ │ │ │ -00023710: 545f 5355 4244 4952 5327 2c20 6275 7420 T_SUBDIRS', but │ │ │ │ │ -00023720: 7468 6520 6d61 6e75 616c 0a20 2020 2020 the manual. │ │ │ │ │ -00023730: 6465 7363 7269 6265 7320 7468 6973 2061 describes this a │ │ │ │ │ -00023740: 7320 6120 7465 6d70 6f72 6172 7920 7567 s a temporary ug │ │ │ │ │ -00023750: 6c79 2068 6163 6b20 2874 6f64 6179 2065 ly hack (today e │ │ │ │ │ -00023760: 7874 7261 2064 6972 6563 746f 7269 6573 xtra directories │ │ │ │ │ -00023770: 0a20 2020 2020 7368 6f75 6c64 2061 6c73 . should als │ │ │ │ │ -00023780: 6f20 6265 206c 6973 7465 6420 696e 2027 o be listed in ' │ │ │ │ │ -00023790: 4558 5452 415f 4449 5354 272c 2061 6e64 EXTRA_DIST', and │ │ │ │ │ -000237a0: 2027 4449 5354 5f53 5542 4449 5253 2720 'DIST_SUBDIRS' │ │ │ │ │ -000237b0: 6973 2075 7365 640a 2020 2020 2066 6f72 is used. for │ │ │ │ │ -000237c0: 2061 6e6f 7468 6572 2070 7572 706f 7365 another purpose │ │ │ │ │ -000237d0: 2c20 2a6e 6f74 6520 436f 6e64 6974 696f , *note Conditio │ │ │ │ │ -000237e0: 6e61 6c20 5375 6264 6972 6563 746f 7269 nal Subdirectori │ │ │ │ │ -000237f0: 6573 3a3a 292e 0a0a 3139 3935 2d31 312d es::)...1995-11- │ │ │ │ │ -00023800: 3236 2041 7574 6f6d 616b 6520 302e 3231 26 Automake 0.21 │ │ │ │ │ -00023810: 0a0a 2020 2020 2049 6e20 6c65 7373 2074 .. In less t │ │ │ │ │ -00023820: 696d 6520 7468 616e 2069 7420 7461 6b65 ime than it take │ │ │ │ │ -00023830: 7320 746f 2063 6f6f 6b20 6120 6672 6f7a s to cook a froz │ │ │ │ │ -00023840: 656e 2070 697a 7a61 2c20 546f 6d20 7265 en pizza, Tom re │ │ │ │ │ -00023850: 7772 6974 6573 0a20 2020 2020 4175 746f writes. Auto │ │ │ │ │ -00023860: 6d61 6b65 2075 7369 6e67 2050 6572 6c2e make using Perl. │ │ │ │ │ -00023870: 2020 4174 2074 6869 7320 7469 6d65 2050 At this time P │ │ │ │ │ -00023880: 6572 6c20 3520 6973 206f 6e6c 7920 6f6e erl 5 is only on │ │ │ │ │ -00023890: 6520 7965 6172 206f 6c64 2c20 616e 640a e year old, and. │ │ │ │ │ -000238a0: 2020 2020 2050 6572 6c20 342e 3033 3620 Perl 4.036 │ │ │ │ │ -000238b0: 6973 2069 6e20 7573 6520 6174 206d 616e is in use at man │ │ │ │ │ -000238c0: 7920 7369 7465 732e 2020 5375 7070 6f72 y sites. Suppor │ │ │ │ │ -000238d0: 7469 6e67 2073 6576 6572 616c 2050 6572 ting several Per │ │ │ │ │ -000238e0: 6c0a 2020 2020 2076 6572 7369 6f6e 7320 l. versions │ │ │ │ │ -000238f0: 6861 7320 6265 656e 2061 2073 6f75 7263 has been a sourc │ │ │ │ │ -00023900: 6520 6f66 2070 726f 626c 656d 7320 7468 e of problems th │ │ │ │ │ -00023910: 726f 7567 6820 7468 6520 7768 6f6c 6520 rough the whole │ │ │ │ │ -00023920: 6869 7374 6f72 7920 6f66 0a20 2020 2020 history of. │ │ │ │ │ -00023930: 4175 746f 6d61 6b65 2e0a 0a20 2020 2020 Automake... │ │ │ │ │ -00023940: 4966 2079 6f75 206e 6576 6572 2075 7365 If you never use │ │ │ │ │ -00023950: 6420 5065 726c 2034 2c20 696d 6167 696e d Perl 4, imagin │ │ │ │ │ -00023960: 6520 5065 726c 2035 2077 6974 686f 7574 e Perl 5 without │ │ │ │ │ -00023970: 206f 626a 6563 7473 2c20 7769 7468 6f75 objects, withou │ │ │ │ │ -00023980: 740a 2020 2020 2027 6d79 2720 7661 7269 t. 'my' vari │ │ │ │ │ -00023990: 6162 6c65 7320 286f 6e6c 7920 6479 6e61 ables (only dyna │ │ │ │ │ -000239a0: 6d69 6361 6c6c 7920 7363 6f70 6564 2027 mically scoped ' │ │ │ │ │ -000239b0: 6c6f 6361 6c27 2076 6172 6961 626c 6573 local' variables │ │ │ │ │ -000239c0: 292c 2077 6974 686f 7574 0a20 2020 2020 ), without. │ │ │ │ │ -000239d0: 6675 6e63 7469 6f6e 2070 726f 746f 7479 function prototy │ │ │ │ │ -000239e0: 7065 732c 2077 6974 6820 6675 6e63 7469 pes, with functi │ │ │ │ │ -000239f0: 6f6e 2063 616c 6c73 2074 6861 7420 6e65 on calls that ne │ │ │ │ │ -00023a00: 6564 7320 746f 2062 6520 7072 6566 6978 eds to be prefix │ │ │ │ │ -00023a10: 6564 0a20 2020 2020 7769 7468 2027 2627 ed. with '&' │ │ │ │ │ -00023a20: 2c20 6574 632e 2020 5472 6163 6573 206f , etc. Traces o │ │ │ │ │ -00023a30: 6620 7468 6973 206f 6c64 2073 7479 6c65 f this old style │ │ │ │ │ -00023a40: 2063 616e 2073 7469 6c6c 2062 6520 666f can still be fo │ │ │ │ │ -00023a50: 756e 6420 696e 0a20 2020 2020 746f 6461 und in. toda │ │ │ │ │ -00023a60: 7927 7320 2761 7574 6f6d 616b 6527 2e0a y's 'automake'.. │ │ │ │ │ -00023a70: 0a31 3939 352d 3131 2d32 3820 4175 746f .1995-11-28 Auto │ │ │ │ │ -00023a80: 6d61 6b65 2030 2e32 320a 3139 3935 2d31 make 0.22.1995-1 │ │ │ │ │ -00023a90: 312d 3239 2041 7574 6f6d 616b 6520 302e 1-29 Automake 0. │ │ │ │ │ -00023aa0: 3233 0a0a 2020 2020 2042 7567 2066 6978 23.. Bug fix │ │ │ │ │ -00023ab0: 6573 2e0a 0a31 3939 352d 3132 2d30 3820 es...1995-12-08 │ │ │ │ │ -00023ac0: 4175 746f 6d61 6b65 2030 2e32 340a 3139 Automake 0.24.19 │ │ │ │ │ -00023ad0: 3935 2d31 322d 3130 2041 7574 6f6d 616b 95-12-10 Automak │ │ │ │ │ -00023ae0: 6520 302e 3235 0a0a 2020 2020 2052 656c e 0.25.. Rel │ │ │ │ │ -00023af0: 6561 7365 7320 6172 6520 7261 696e 696e eases are rainin │ │ │ │ │ -00023b00: 672e 2020 302e 3234 2069 6e74 726f 6475 g. 0.24 introdu │ │ │ │ │ -00023b10: 6365 7320 7468 6520 756e 6966 6f72 6d20 ces the uniform │ │ │ │ │ -00023b20: 6e61 6d69 6e67 2073 6368 656d 6520 7765 naming scheme we │ │ │ │ │ -00023b30: 0a20 2020 2020 7573 6520 746f 6461 792c . use today, │ │ │ │ │ -00023b40: 2069 2e65 2e2c 2027 6269 6e5f 5052 4f47 i.e., 'bin_PROG │ │ │ │ │ -00023b50: 5241 4d53 2720 696e 7374 6561 6420 6f66 RAMS' instead of │ │ │ │ │ -00023b60: 2027 5052 4f47 5241 4d53 272c 0a20 2020 'PROGRAMS',. │ │ │ │ │ -00023b70: 2020 276e 6f69 6e73 745f 4c49 4252 4152 'noinst_LIBRAR │ │ │ │ │ -00023b80: 4945 5327 2069 6e73 7465 6164 206f 6620 IES' instead of │ │ │ │ │ -00023b90: 274c 4942 4c49 4252 4152 4945 5327 2c20 'LIBLIBRARIES', │ │ │ │ │ -00023ba0: 6574 632e 2020 2848 6f77 6576 6572 0a20 etc. (However. │ │ │ │ │ -00023bb0: 2020 2020 2745 5854 5241 5f50 524f 4752 'EXTRA_PROGR │ │ │ │ │ -00023bc0: 414d 5327 2064 6f65 7320 6e6f 7420 6578 AMS' does not ex │ │ │ │ │ -00023bd0: 6973 7420 7965 742c 2027 414d 5f50 524f ist yet, 'AM_PRO │ │ │ │ │ -00023be0: 4752 414d 5327 2069 7320 7374 696c 6c20 GRAMS' is still │ │ │ │ │ -00023bf0: 696e 2075 7365 3b0a 2020 2020 2061 6e64 in use;. and │ │ │ │ │ -00023c00: 2027 5445 5849 4e46 4f53 2720 616e 6420 'TEXINFOS' and │ │ │ │ │ -00023c10: 274d 414e 5327 2073 7469 6c6c 2068 6176 'MANS' still hav │ │ │ │ │ -00023c20: 6520 6e6f 2064 6972 6563 746f 7279 2070 e no directory p │ │ │ │ │ -00023c30: 7265 6669 7865 732e 290a 2020 2020 2041 refixes.). A │ │ │ │ │ -00023c40: 6464 696e 6720 7375 7070 6f72 7420 666f dding support fo │ │ │ │ │ -00023c50: 7220 7072 6566 6978 6573 206c 696b 6520 r prefixes like │ │ │ │ │ -00023c60: 7468 6174 2077 6173 206f 6e65 206f 6620 that was one of │ │ │ │ │ -00023c70: 7468 6520 6d61 6a6f 7220 6964 6561 7320 the major ideas │ │ │ │ │ -00023c80: 696e 0a20 2020 2020 2761 7574 6f6d 616b in. 'automak │ │ │ │ │ -00023c90: 6527 3b20 6974 2068 6173 206c 6173 7465 e'; it has laste │ │ │ │ │ -00023ca0: 6420 7072 6574 7479 2077 656c 6c2e 0a0a d pretty well... │ │ │ │ │ -00023cb0: 2020 2020 2041 7574 6f4d 616b 6520 6973 AutoMake is │ │ │ │ │ -00023cc0: 2072 656e 616d 6564 2074 6f20 4175 746f renamed to Auto │ │ │ │ │ -00023cd0: 6d61 6b65 2028 546f 6d20 7365 656d 7320 make (Tom seems │ │ │ │ │ -00023ce0: 746f 2072 6563 616c 6c20 6974 2077 6173 to recall it was │ │ │ │ │ -00023cf0: 0a20 2020 2020 4672 616e c3a7 6f69 7320 . Fran..ois │ │ │ │ │ -00023d00: 5069 6e61 7264 2773 2064 6f69 6e67 292e Pinard's doing). │ │ │ │ │ -00023d10: 0a0a 2020 2020 2030 2e32 3520 6669 7865 .. 0.25 fixe │ │ │ │ │ -00023d20: 7320 6120 5065 726c 2034 2070 6f72 7461 s a Perl 4 porta │ │ │ │ │ -00023d30: 6269 6c69 7479 2062 7567 2e0a 0a31 3939 bility bug...199 │ │ │ │ │ -00023d40: 352d 3132 2d31 3820 4a69 6d20 4d65 7965 5-12-18 Jim Meye │ │ │ │ │ -00023d50: 7269 6e67 2073 7461 7274 7320 7573 696e ring starts usin │ │ │ │ │ -00023d60: 6720 4175 746f 6d61 6b65 2069 6e20 474e g Automake in GN │ │ │ │ │ -00023d70: 5520 5465 7874 7574 696c 732e 0a31 3939 U Textutils..199 │ │ │ │ │ -00023d80: 352d 3132 2d33 3120 4672 616e c3a7 6f69 5-12-31 Fran..oi │ │ │ │ │ -00023d90: 7320 5069 6e61 7264 2073 7461 7274 7320 s Pinard starts │ │ │ │ │ -00023da0: 7573 696e 6720 4175 746f 6d61 6b65 2069 using Automake i │ │ │ │ │ -00023db0: 6e20 474e 5520 7461 722e 0a0a 3139 3936 n GNU tar...1996 │ │ │ │ │ -00023dc0: 2d30 312d 3033 2041 7574 6f6d 616b 6520 -01-03 Automake │ │ │ │ │ -00023dd0: 302e 3236 0a31 3939 362d 3031 2d30 3320 0.26.1996-01-03 │ │ │ │ │ -00023de0: 4175 746f 6d61 6b65 2030 2e32 370a 0a20 Automake 0.27.. │ │ │ │ │ -00023df0: 2020 2020 4f66 2074 6865 206d 616e 7920 Of the many │ │ │ │ │ -00023e00: 6368 616e 6765 7320 616e 6420 7375 6767 changes and sugg │ │ │ │ │ -00023e10: 6573 7469 6f6e 7320 7365 6e74 2062 7920 estions sent by │ │ │ │ │ -00023e20: 4672 616e c3a7 6f69 7320 5069 6e61 7264 Fran..ois Pinard │ │ │ │ │ -00023e30: 2061 6e64 0a20 2020 2020 696e 636c 7564 and. includ │ │ │ │ │ -00023e40: 6564 2069 6e20 302e 3236 2c20 7065 7268 ed in 0.26, perh │ │ │ │ │ -00023e50: 6170 7320 7468 6520 6d6f 7374 2069 6d70 aps the most imp │ │ │ │ │ -00023e60: 6f72 7461 6e74 2069 7320 7468 6520 6164 ortant is the ad │ │ │ │ │ -00023e70: 7669 6365 2074 6861 7420 746f 0a20 2020 vice that to. │ │ │ │ │ -00023e80: 2020 6561 7365 2063 7573 746f 6d69 7a61 ease customiza │ │ │ │ │ -00023e90: 7469 6f6e 2061 2075 7365 7220 7275 6c65 tion a user rule │ │ │ │ │ -00023ea0: 206f 7220 7661 7269 6162 6c65 2064 6566 or variable def │ │ │ │ │ -00023eb0: 696e 6974 696f 6e20 7368 6f75 6c64 2061 inition should a │ │ │ │ │ -00023ec0: 6c77 6179 730a 2020 2020 206f 7665 7272 lways. overr │ │ │ │ │ -00023ed0: 6964 6520 616e 2041 7574 6f6d 616b 6520 ide an Automake │ │ │ │ │ -00023ee0: 7275 6c65 206f 7220 6465 6669 6e69 7469 rule or definiti │ │ │ │ │ -00023ef0: 6f6e 2e0a 0a20 2020 2020 476f 7264 6f6e on... Gordon │ │ │ │ │ -00023f00: 204d 6174 7a69 676b 6569 7420 616e 6420 Matzigkeit and │ │ │ │ │ -00023f10: 4a69 6d20 4d65 7965 7269 6e67 2061 7265 Jim Meyering are │ │ │ │ │ -00023f20: 2074 776f 206f 7468 6572 2065 6172 6c79 two other early │ │ │ │ │ -00023f30: 2063 6f6e 7472 6962 7574 6f72 730a 2020 contributors. │ │ │ │ │ -00023f40: 2020 2074 6861 7420 6861 7665 2062 6565 that have bee │ │ │ │ │ -00023f50: 6e20 7365 6e64 696e 6720 6669 7865 732e n sending fixes. │ │ │ │ │ -00023f60: 0a0a 2020 2020 2030 2e32 3720 6669 7865 .. 0.27 fixe │ │ │ │ │ -00023f70: 7320 7965 7420 616e 6f74 6865 7220 5065 s yet another Pe │ │ │ │ │ -00023f80: 726c 2034 2070 6f72 7461 6269 6c69 7479 rl 4 portability │ │ │ │ │ -00023f90: 2062 7567 2e0a 0a31 3939 362d 3031 2d31 bug...1996-01-1 │ │ │ │ │ -00023fa0: 3320 4175 746f 6d61 6b65 2030 2e32 380a 3 Automake 0.28. │ │ │ │ │ -00023fb0: 0a20 2020 2020 4175 746f 6d61 6b65 2073 . Automake s │ │ │ │ │ -00023fc0: 7461 7274 7320 7363 616e 6e69 6e67 2027 tarts scanning ' │ │ │ │ │ -00023fd0: 636f 6e66 6967 7572 652e 696e 2720 666f configure.in' fo │ │ │ │ │ -00023fe0: 7220 274c 4942 4f42 4a53 2720 7375 7070 r 'LIBOBJS' supp │ │ │ │ │ -00023ff0: 6f72 742e 0a20 2020 2020 5468 6973 2069 ort.. This i │ │ │ │ │ -00024000: 7320 616e 2069 6d70 6f72 7461 6e74 2073 s an important s │ │ │ │ │ -00024010: 7465 7020 6265 6361 7573 6520 756e 7469 tep because unti │ │ │ │ │ -00024020: 6c20 7468 6973 2076 6572 7369 6f6e 2041 l this version A │ │ │ │ │ -00024030: 7574 6f6d 616b 6520 6f6e 6c79 0a20 2020 utomake only. │ │ │ │ │ -00024040: 2020 6b6e 6577 2061 626f 7574 2074 6865 knew about the │ │ │ │ │ -00024050: 2027 4d61 6b65 6669 6c65 2e61 6d27 7320 'Makefile.am's │ │ │ │ │ -00024060: 6974 2070 726f 6365 7373 6564 2e20 2027 it processed. ' │ │ │ │ │ -00024070: 636f 6e66 6967 7572 652e 696e 2720 7761 configure.in' wa │ │ │ │ │ -00024080: 730a 2020 2020 2041 7574 6f63 6f6e 6627 s. Autoconf' │ │ │ │ │ -00024090: 7320 776f 726c 6420 616e 6420 7468 6520 s world and the │ │ │ │ │ -000240a0: 6c69 6e6b 2062 6574 7765 656e 2041 7574 link between Aut │ │ │ │ │ -000240b0: 6f63 6f6e 6620 616e 6420 4175 746f 6d61 oconf and Automa │ │ │ │ │ -000240c0: 6b65 2068 6164 2074 6f0a 2020 2020 2062 ke had to. b │ │ │ │ │ -000240d0: 6520 646f 6e65 2062 7920 7468 6520 274d e done by the 'M │ │ │ │ │ -000240e0: 616b 6566 696c 652e 616d 2720 6175 7468 akefile.am' auth │ │ │ │ │ -000240f0: 6f72 2e20 2046 6f72 2069 6e73 7461 6e63 or. For instanc │ │ │ │ │ -00024100: 652c 2069 6620 2763 6f6e 6669 672e 6827 e, if 'config.h' │ │ │ │ │ -00024110: 0a20 2020 2020 7761 7320 6765 6e65 7261 . was genera │ │ │ │ │ -00024120: 7465 6420 6279 2027 636f 6e66 6967 7572 ted by 'configur │ │ │ │ │ -00024130: 6527 2c20 6974 2077 6173 2074 6865 2070 e', it was the p │ │ │ │ │ -00024140: 6163 6b61 6765 206d 6169 6e74 6169 6e65 ackage maintaine │ │ │ │ │ -00024150: 7227 730a 2020 2020 2072 6573 706f 6e73 r's. respons │ │ │ │ │ -00024160: 6962 696c 6974 7920 746f 2064 6566 696e ibility to defin │ │ │ │ │ -00024170: 6520 7468 6520 2743 4f4e 4649 475f 4845 e the 'CONFIG_HE │ │ │ │ │ -00024180: 4144 4552 2720 7661 7269 6162 6c65 2069 ADER' variable i │ │ │ │ │ -00024190: 6e20 6561 6368 0a20 2020 2020 274d 616b n each. 'Mak │ │ │ │ │ -000241a0: 6566 696c 652e 616d 272e 0a0a 2020 2020 efile.am'... │ │ │ │ │ -000241b0: 2053 7563 6365 6564 696e 6720 7265 6c65 Succeeding rele │ │ │ │ │ -000241c0: 6173 6573 2077 696c 6c20 7265 6c79 206d ases will rely m │ │ │ │ │ -000241d0: 6f72 6520 616e 6420 6d6f 7265 206f 6e20 ore and more on │ │ │ │ │ -000241e0: 7363 616e 6e69 6e67 0a20 2020 2020 2763 scanning. 'c │ │ │ │ │ -000241f0: 6f6e 6669 6775 7265 2e69 6e27 2074 6f20 onfigure.in' to │ │ │ │ │ -00024200: 6265 7474 6572 2061 7574 6f6d 6174 6520 better automate │ │ │ │ │ -00024210: 7468 6520 4175 746f 636f 6e66 2069 6e74 the Autoconf int │ │ │ │ │ -00024220: 6567 7261 7469 6f6e 2e0a 0a20 2020 2020 egration... │ │ │ │ │ -00024230: 302e 3238 2061 6c73 6f20 696e 7472 6f64 0.28 also introd │ │ │ │ │ -00024240: 7563 6573 2074 6865 2027 4155 544f 4d41 uces the 'AUTOMA │ │ │ │ │ -00024250: 4b45 5f4f 5054 494f 4e53 2720 7661 7269 KE_OPTIONS' vari │ │ │ │ │ -00024260: 6162 6c65 2061 6e64 2074 6865 0a20 2020 able and the. │ │ │ │ │ -00024270: 2020 272d 2d67 6e75 2720 616e 6420 272d '--gnu' and '- │ │ │ │ │ -00024280: 2d67 6e69 7473 2720 6f70 7469 6f6e 732c -gnits' options, │ │ │ │ │ -00024290: 2074 6865 206c 6174 7465 7220 6265 696e the latter bein │ │ │ │ │ -000242a0: 6720 7374 7269 6374 6572 2e0a 0a31 3939 g stricter...199 │ │ │ │ │ -000242b0: 362d 3032 2d30 3720 4175 746f 6d61 6b65 6-02-07 Automake │ │ │ │ │ -000242c0: 2030 2e32 390a 0a20 2020 2020 5468 616e 0.29.. Than │ │ │ │ │ -000242d0: 6b73 2074 6f20 2763 6f6e 6669 6775 7265 ks to 'configure │ │ │ │ │ -000242e0: 2e69 6e27 2073 6361 6e6e 696e 672c 2027 .in' scanning, ' │ │ │ │ │ -000242f0: 434f 4e46 4947 5f48 4541 4445 5227 2069 CONFIG_HEADER' i │ │ │ │ │ -00024300: 7320 676f 6e65 2c20 616e 640a 2020 2020 s gone, and. │ │ │ │ │ -00024310: 2072 6562 7569 6c64 2072 756c 6573 2066 rebuild rules f │ │ │ │ │ -00024320: 6f72 2027 636f 6e66 6967 7572 6527 2d67 or 'configure'-g │ │ │ │ │ -00024330: 656e 6572 6174 6564 2066 696c 6520 6172 enerated file ar │ │ │ │ │ -00024340: 6520 6175 746f 6d61 7469 6361 6c6c 790a e automatically. │ │ │ │ │ -00024350: 2020 2020 206f 7574 7075 742e 0a0a 2020 output... │ │ │ │ │ -00024360: 2020 2027 5445 5849 4e46 4f53 2720 616e 'TEXINFOS' an │ │ │ │ │ -00024370: 6420 274d 414e 5327 2063 6f6e 7665 7274 d 'MANS' convert │ │ │ │ │ -00024380: 6564 2074 6f20 7468 6520 756e 6966 6f72 ed to the unifor │ │ │ │ │ -00024390: 6d20 6e61 6d69 6e67 2073 6368 656d 652e m naming scheme. │ │ │ │ │ -000243a0: 0a0a 3139 3936 2d30 322d 3234 2041 7574 ..1996-02-24 Aut │ │ │ │ │ -000243b0: 6f6d 616b 6520 302e 3330 0a0a 2020 2020 omake 0.30.. │ │ │ │ │ -000243c0: 2054 6865 2074 6573 7420 7375 6974 6520 The test suite │ │ │ │ │ -000243d0: 6973 2062 6f72 6e2e 2020 4974 2063 6f6e is born. It con │ │ │ │ │ -000243e0: 7461 696e 7320 3920 7465 7374 732e 2020 tains 9 tests. │ │ │ │ │ -000243f0: 4672 6f6d 206e 6f77 206f 6e20 7465 7374 From now on test │ │ │ │ │ -00024400: 0a20 2020 2020 6361 7365 7320 7769 6c6c . cases will │ │ │ │ │ -00024410: 2062 6520 6164 6465 6420 7072 6574 7479 be added pretty │ │ │ │ │ -00024420: 2072 6567 756c 6172 6c79 2028 2a6e 6f74 regularly (*not │ │ │ │ │ -00024430: 6520 5265 6c65 6173 6573 3a3a 292c 2061 e Releases::), a │ │ │ │ │ -00024440: 6e64 2074 6869 730a 2020 2020 2070 726f nd this. pro │ │ │ │ │ -00024450: 7665 6420 746f 2062 6520 7265 616c 6c79 ved to be really │ │ │ │ │ -00024460: 2068 656c 7066 756c 206c 6174 6572 206f helpful later o │ │ │ │ │ -00024470: 6e2e 0a0a 2020 2020 2027 4558 5452 415f n... 'EXTRA_ │ │ │ │ │ -00024480: 5052 4f47 5241 4d53 2720 6669 6e61 6c6c PROGRAMS' finall │ │ │ │ │ -00024490: 7920 7265 706c 6163 6573 2027 414d 5f50 y replaces 'AM_P │ │ │ │ │ -000244a0: 524f 4752 414d 5327 2e0a 0a20 2020 2020 ROGRAMS'... │ │ │ │ │ -000244b0: 416c 6c20 7468 6520 7468 6972 642d 7061 All the third-pa │ │ │ │ │ -000244c0: 7274 7920 4175 746f 636f 6e66 206d 6163 rty Autoconf mac │ │ │ │ │ -000244d0: 726f 732c 2077 7269 7474 656e 206d 6f73 ros, written mos │ │ │ │ │ -000244e0: 746c 7920 6279 2046 7261 6ec3 a76f 6973 tly by Fran..ois │ │ │ │ │ -000244f0: 0a20 2020 2020 5069 6e61 7264 2028 616e . Pinard (an │ │ │ │ │ -00024500: 6420 6c61 7465 7220 4a69 6d20 4d65 7965 d later Jim Meye │ │ │ │ │ -00024510: 7269 6e67 292c 2061 7265 2064 6973 7472 ring), are distr │ │ │ │ │ -00024520: 6962 7574 6564 2069 6e20 4175 746f 6d61 ibuted in Automa │ │ │ │ │ -00024530: 6b65 2773 0a20 2020 2020 6861 6e64 2d77 ke's. hand-w │ │ │ │ │ -00024540: 7269 7474 656e 2027 6163 6c6f 6361 6c2e ritten 'aclocal. │ │ │ │ │ -00024550: 6d34 2720 6669 6c65 2e20 2050 6163 6b61 m4' file. Packa │ │ │ │ │ -00024560: 6765 206d 6169 6e74 6169 6e65 7273 2061 ge maintainers a │ │ │ │ │ -00024570: 7265 2065 7870 6563 7465 640a 2020 2020 re expected. │ │ │ │ │ -00024580: 2074 6f20 6578 7472 6163 7420 7468 6520 to extract the │ │ │ │ │ -00024590: 6e65 6365 7373 6172 7920 6d61 6372 6f73 necessary macros │ │ │ │ │ -000245a0: 2066 726f 6d20 7468 6973 2066 696c 652e from this file. │ │ │ │ │ -000245b0: 2020 2849 6e20 7072 6576 696f 7573 0a20 (In previous. │ │ │ │ │ -000245c0: 2020 2020 7665 7273 696f 6e73 2079 6f75 versions you │ │ │ │ │ -000245d0: 2068 6164 2074 6f20 636f 7079 2061 6e64 had to copy and │ │ │ │ │ -000245e0: 2070 6173 7465 2074 6865 6d20 6672 6f6d paste them from │ │ │ │ │ -000245f0: 2074 6865 206d 616e 7561 6c2e 2e2e 290a the manual...). │ │ │ │ │ -00024600: 0a31 3939 362d 3033 2d31 3120 4175 746f .1996-03-11 Auto │ │ │ │ │ -00024610: 6d61 6b65 2030 2e33 310a 0a20 2020 2020 make 0.31.. │ │ │ │ │ -00024620: 5468 6520 7465 7374 2073 7569 7465 2069 The test suite i │ │ │ │ │ -00024630: 6e20 302e 3330 2077 6173 2072 756e 2076 n 0.30 was run v │ │ │ │ │ -00024640: 6961 2061 206c 6f6e 6720 2763 6865 636b ia a long 'check │ │ │ │ │ -00024650: 2d6c 6f63 616c 2720 7275 6c65 2e20 2055 -local' rule. U │ │ │ │ │ -00024660: 706f 6e0a 2020 2020 2055 6c72 6963 6820 pon. Ulrich │ │ │ │ │ -00024670: 4472 6570 7065 7227 7320 7375 6767 6573 Drepper's sugges │ │ │ │ │ -00024680: 7469 6f6e 2c20 302e 3331 206d 616b 6573 tion, 0.31 makes │ │ │ │ │ -00024690: 2069 7420 616e 2041 7574 6f6d 616b 6520 it an Automake │ │ │ │ │ -000246a0: 7275 6c65 206f 7574 7075 740a 2020 2020 rule output. │ │ │ │ │ -000246b0: 2077 6865 6e65 7665 7220 7468 6520 2754 whenever the 'T │ │ │ │ │ -000246c0: 4553 5453 2720 7661 7269 6162 6c65 2069 ESTS' variable i │ │ │ │ │ -000246d0: 7320 6465 6669 6e65 642e 0a0a 2020 2020 s defined... │ │ │ │ │ -000246e0: 2027 4449 5354 5f4f 5448 4552 2720 6973 'DIST_OTHER' is │ │ │ │ │ -000246f0: 2072 656e 616d 6564 2074 6f20 2745 5854 renamed to 'EXT │ │ │ │ │ -00024700: 5241 5f44 4953 5427 2c20 616e 6420 7468 RA_DIST', and th │ │ │ │ │ -00024710: 6520 2763 6865 636b 5f27 2070 7265 6669 e 'check_' prefi │ │ │ │ │ -00024720: 7820 6973 0a20 2020 2020 696e 7472 6f64 x is. introd │ │ │ │ │ -00024730: 7563 6564 2e20 2054 6865 2073 796e 7461 uced. The synta │ │ │ │ │ -00024740: 7820 6973 206e 6f77 2074 6865 2073 616d x is now the sam │ │ │ │ │ -00024750: 6520 6173 2074 6f64 6179 2e0a 0a31 3939 e as today...199 │ │ │ │ │ -00024760: 362d 3033 2d31 3520 476f 7264 6f6e 204d 6-03-15 Gordon M │ │ │ │ │ -00024770: 6174 7a69 676b 6569 7420 7374 6172 7473 atzigkeit starts │ │ │ │ │ -00024780: 2077 7269 7469 6e67 206c 6962 746f 6f6c writing libtool │ │ │ │ │ -00024790: 2e0a 0a31 3939 362d 3034 2d32 3720 4175 ...1996-04-27 Au │ │ │ │ │ -000247a0: 746f 6d61 6b65 2030 2e33 320a 0a20 2020 tomake 0.32.. │ │ │ │ │ -000247b0: 2020 272d 686f 6f6b 2720 7461 7267 6574 '-hook' target │ │ │ │ │ -000247c0: 7320 6172 6520 696e 7472 6f64 7563 6564 s are introduced │ │ │ │ │ -000247d0: 3b20 616e 2069 6465 6120 6672 6f6d 2044 ; an idea from D │ │ │ │ │ -000247e0: 6965 7465 7220 4261 726f 6e2e 0a0a 2020 ieter Baron... │ │ │ │ │ -000247f0: 2020 2027 2a2e 696e 666f 2720 6669 6c65 '*.info' file │ │ │ │ │ -00024800: 732c 2077 6869 6368 2077 6572 6520 6f75 s, which were ou │ │ │ │ │ -00024810: 7470 7574 2069 6e20 7468 6520 6275 696c tput in the buil │ │ │ │ │ -00024820: 6420 6469 7265 6374 6f72 7920 6172 6520 d directory are │ │ │ │ │ -00024830: 6e6f 770a 2020 2020 2062 7569 6c74 2069 now. built i │ │ │ │ │ -00024840: 6e20 7468 6520 736f 7572 6365 2064 6972 n the source dir │ │ │ │ │ -00024850: 6563 746f 7279 2c20 6265 6361 7573 6520 ectory, because │ │ │ │ │ -00024860: 7468 6579 2061 7265 2064 6973 7472 6962 they are distrib │ │ │ │ │ -00024870: 7574 6564 2e20 2049 740a 2020 2020 2073 uted. It. s │ │ │ │ │ -00024880: 6565 6d73 2074 6865 7365 2066 696c 6573 eems these files │ │ │ │ │ -00024890: 206c 696b 6520 746f 206d 6f76 6520 6261 like to move ba │ │ │ │ │ -000248a0: 636b 2061 6e64 2066 6f72 7468 2061 7320 ck and forth as │ │ │ │ │ -000248b0: 7468 6174 2077 696c 6c20 6861 7070 656e that will happen │ │ │ │ │ -000248c0: 0a20 2020 2020 6167 6169 6e20 696e 2066 . again in f │ │ │ │ │ -000248d0: 7574 7572 6520 7665 7273 696f 6e73 2e0a uture versions.. │ │ │ │ │ -000248e0: 0a31 3939 362d 3035 2d31 3820 4175 746f .1996-05-18 Auto │ │ │ │ │ -000248f0: 6d61 6b65 2030 2e33 330a 0a20 2020 2020 make 0.33.. │ │ │ │ │ -00024900: 476f 7264 204d 6174 7a69 676b 6569 7427 Gord Matzigkeit' │ │ │ │ │ -00024910: 7320 6d61 696e 2074 776f 2063 6f6e 7472 s main two contr │ │ │ │ │ -00024920: 6962 7574 696f 6e73 3a0a 0a20 2020 2020 ibutions:.. │ │ │ │ │ -00024930: 2020 202a 2076 6572 7920 7072 656c 696d * very prelim │ │ │ │ │ -00024940: 696e 6172 7920 6c69 6274 6f6f 6c20 7375 inary libtool su │ │ │ │ │ -00024950: 7070 6f72 740a 2020 2020 2020 2020 2a20 pport. * │ │ │ │ │ -00024960: 7468 6520 6469 7374 6368 6563 6b20 7275 the distcheck ru │ │ │ │ │ -00024970: 6c65 0a0a 2020 2020 2041 6c74 686f 7567 le.. Althoug │ │ │ │ │ -00024980: 6820 7468 6579 2077 6572 6520 7665 7279 h they were very │ │ │ │ │ -00024990: 2062 6173 6963 2061 7420 7468 6973 2070 basic at this p │ │ │ │ │ -000249a0: 6f69 6e74 2c20 7468 6573 6520 6172 6520 oint, these are │ │ │ │ │ -000249b0: 7072 6f62 6162 6c79 0a20 2020 2020 616d probably. am │ │ │ │ │ -000249c0: 6f6e 6720 7468 6520 746f 7020 6665 6174 ong the top feat │ │ │ │ │ -000249d0: 7572 6573 2066 6f72 2041 7574 6f6d 616b ures for Automak │ │ │ │ │ -000249e0: 6520 746f 6461 792e 0a0a 2020 2020 204a e today... J │ │ │ │ │ -000249f0: 696d 204d 6579 6572 696e 6720 616c 736f im Meyering also │ │ │ │ │ -00024a00: 2070 726f 7669 6465 7320 7468 6520 696e provides the in │ │ │ │ │ -00024a10: 6661 6d6f 7573 2027 6a6d 5f4d 4149 4e54 famous 'jm_MAINT │ │ │ │ │ -00024a20: 4149 4e45 525f 4d4f 4445 272c 2073 696e AINER_MODE', sin │ │ │ │ │ -00024a30: 6365 0a20 2020 2020 7468 656e 2072 656e ce. then ren │ │ │ │ │ -00024a40: 616d 6564 2074 6f20 2741 4d5f 4d41 494e amed to 'AM_MAIN │ │ │ │ │ -00024a50: 5441 494e 4552 5f4d 4f44 4527 2061 6e64 TAINER_MODE' and │ │ │ │ │ -00024a60: 2061 6261 6e64 6f6e 6564 2062 7920 6974 abandoned by it │ │ │ │ │ -00024a70: 7320 6175 7468 6f72 0a20 2020 2020 282a s author. (* │ │ │ │ │ -00024a80: 6e6f 7465 206d 6169 6e74 6169 6e65 722d note maintainer- │ │ │ │ │ -00024a90: 6d6f 6465 3a3a 292e 0a0a 3139 3936 2d30 mode::)...1996-0 │ │ │ │ │ -00024aa0: 352d 3238 2041 7574 6f6d 616b 6520 312e 5-28 Automake 1. │ │ │ │ │ -00024ab0: 300a 0a20 2020 2020 4166 7465 7220 6f6e 0.. After on │ │ │ │ │ -00024ac0: 6c79 2073 6978 206d 6f6e 7468 7320 6f66 ly six months of │ │ │ │ │ -00024ad0: 2068 6561 7679 2064 6576 656c 6f70 6d65 heavy developme │ │ │ │ │ -00024ae0: 6e74 2c20 7468 6520 2761 7574 6f6d 616b nt, the 'automak │ │ │ │ │ -00024af0: 6527 2073 6372 6970 740a 2020 2020 2069 e' script. i │ │ │ │ │ -00024b00: 7320 3331 3334 206c 696e 6573 206c 6f6e s 3134 lines lon │ │ │ │ │ -00024b10: 672c 2070 6c75 7320 3937 3320 6c69 6e65 g, plus 973 line │ │ │ │ │ -00024b20: 7320 6f66 2027 4d61 6b65 6669 6c65 2720 s of 'Makefile' │ │ │ │ │ -00024b30: 6672 6167 6d65 6e74 732e 2020 5468 650a fragments. The. │ │ │ │ │ -00024b40: 2020 2020 2070 6163 6b61 6765 2068 6173 package has │ │ │ │ │ -00024b50: 2033 3020 7061 6765 7320 6f66 2064 6f63 30 pages of doc │ │ │ │ │ -00024b60: 756d 656e 7461 7469 6f6e 2c20 616e 6420 umentation, and │ │ │ │ │ -00024b70: 3338 2074 6573 7420 6361 7365 732e 0a20 38 test cases.. │ │ │ │ │ -00024b80: 2020 2020 2761 636c 6f63 616c 2e6d 3427 'aclocal.m4' │ │ │ │ │ -00024b90: 2063 6f6e 7461 696e 7320 3420 6d61 6372 contains 4 macr │ │ │ │ │ -00024ba0: 6f73 2e0a 0a20 2020 2020 4672 6f6d 206e os... From n │ │ │ │ │ -00024bb0: 6f77 206f 6e20 616e 6420 756e 7469 6c20 ow on and until │ │ │ │ │ -00024bc0: 7665 7273 696f 6e20 312e 342c 206e 6577 version 1.4, new │ │ │ │ │ -00024bd0: 2072 656c 6561 7365 7320 7769 6c6c 206f releases will o │ │ │ │ │ -00024be0: 6363 7572 2061 7420 610a 2020 2020 2072 ccur at a. r │ │ │ │ │ -00024bf0: 6174 6520 6f66 2061 626f 7574 206f 6e65 ate of about one │ │ │ │ │ -00024c00: 2061 2079 6561 722e 2020 312e 3120 6469 a year. 1.1 di │ │ │ │ │ -00024c10: 6420 6e6f 7420 6578 6973 742c 2061 6374 d not exist, act │ │ │ │ │ -00024c20: 7561 6c6c 7920 312e 3162 2074 6f20 312e ually 1.1b to 1. │ │ │ │ │ -00024c30: 3170 0a20 2020 2020 6861 7665 2062 6565 1p. have bee │ │ │ │ │ -00024c40: 6e20 7468 6520 6e61 6d65 206f 6620 6265 n the name of be │ │ │ │ │ -00024c50: 7461 2072 656c 6561 7365 7320 666f 7220 ta releases for │ │ │ │ │ -00024c60: 312e 322e 2020 5468 6973 2069 7320 7468 1.2. This is th │ │ │ │ │ -00024c70: 6520 6669 7273 740a 2020 2020 2074 696d e first. tim │ │ │ │ │ -00024c80: 6520 4175 746f 6d61 6b65 2075 7365 7320 e Automake uses │ │ │ │ │ -00024c90: 7375 6666 6978 206c 6574 7465 7273 2074 suffix letters t │ │ │ │ │ -00024ca0: 6f20 6465 7369 676e 6174 6520 6265 7461 o designate beta │ │ │ │ │ -00024cb0: 2072 656c 6561 7365 732c 2061 0a20 2020 releases, a. │ │ │ │ │ -00024cc0: 2020 6861 6269 7420 7468 6174 206c 6173 habit that las │ │ │ │ │ -00024cd0: 7473 2e0a 0a31 3939 362d 3130 2d31 3020 ts...1996-10-10 │ │ │ │ │ -00024ce0: 4b65 7669 6e20 4461 6c6c 6579 2070 6163 Kevin Dalley pac │ │ │ │ │ -00024cf0: 6b61 6765 7320 4175 746f 6d61 6b65 2031 kages Automake 1 │ │ │ │ │ -00024d00: 2e30 2066 6f72 2044 6562 6961 6e20 474e .0 for Debian GN │ │ │ │ │ -00024d10: 552f 4c69 6e75 782e 0a0a 3139 3936 2d31 U/Linux...1996-1 │ │ │ │ │ -00024d20: 312d 3236 2044 6176 6964 204a 2e20 4d61 1-26 David J. Ma │ │ │ │ │ -00024d30: 634b 656e 7a69 6520 7265 6c65 6173 6573 cKenzie releases │ │ │ │ │ -00024d40: 2041 7574 6f63 6f6e 6620 322e 3132 2e0a Autoconf 2.12.. │ │ │ │ │ -00024d50: 0a20 2020 2020 4265 7477 6565 6e20 4a75 . Between Ju │ │ │ │ │ -00024d60: 6e65 2061 6e64 204f 6374 6f62 6572 2c20 ne and October, │ │ │ │ │ -00024d70: 7468 6520 4175 746f 636f 6e66 2064 6576 the Autoconf dev │ │ │ │ │ -00024d80: 656c 6f70 6d65 6e74 2069 7320 616c 6d6f elopment is almo │ │ │ │ │ -00024d90: 7374 0a20 2020 2020 7374 616c 6c65 642e st. stalled. │ │ │ │ │ -00024da0: 2020 526f 6c61 6e64 204d 6347 7261 7468 Roland McGrath │ │ │ │ │ -00024db0: 2068 6173 2062 6565 6e20 776f 726b 696e has been workin │ │ │ │ │ -00024dc0: 6720 6174 2074 6865 2062 6567 696e 6e69 g at the beginni │ │ │ │ │ -00024dd0: 6e67 206f 6620 7468 650a 2020 2020 2079 ng of the. y │ │ │ │ │ -00024de0: 6561 722e 2020 4461 7669 6420 636f 6d65 ear. David come │ │ │ │ │ -00024df0: 7320 6261 636b 2069 6e20 4e6f 7665 6d62 s back in Novemb │ │ │ │ │ -00024e00: 6572 2074 6f20 7265 6c65 6173 6520 322e er to release 2. │ │ │ │ │ -00024e10: 3132 2c20 6275 7420 6865 2077 6f6e 2774 12, but he won't │ │ │ │ │ -00024e20: 0a20 2020 2020 746f 7563 6820 4175 746f . touch Auto │ │ │ │ │ -00024e30: 636f 6e66 2061 6e79 6d6f 7265 2061 6674 conf anymore aft │ │ │ │ │ -00024e40: 6572 2074 6869 7320 7965 6172 2c20 616e er this year, an │ │ │ │ │ -00024e50: 6420 4175 746f 636f 6e66 2074 6865 6e20 d Autoconf then │ │ │ │ │ -00024e60: 7265 616c 6c79 0a20 2020 2020 7374 6167 really. stag │ │ │ │ │ -00024e70: 6e61 7465 732e 2020 5468 6520 6465 736f nates. The deso │ │ │ │ │ -00024e80: 6c61 7465 2041 7574 6f63 6f6e 6620 2743 late Autoconf 'C │ │ │ │ │ -00024e90: 6861 6e67 654c 6f67 2720 666f 7220 3139 hangeLog' for 19 │ │ │ │ │ -00024ea0: 3937 206c 6973 7473 206f 6e6c 7920 370a 97 lists only 7. │ │ │ │ │ -00024eb0: 2020 2020 2063 6f6d 6d69 7473 2e0a 0a31 commits...1 │ │ │ │ │ -00024ec0: 3939 372d 3032 2d32 3820 3c61 7574 6f6d 997-02-28 list alive.. │ │ │ │ │ -00024ef0: 2020 2020 2054 6865 206d 6169 6c69 6e67 The mailing │ │ │ │ │ -00024f00: 206c 6973 7420 6973 2061 6e6e 6f75 6e63 list is announc │ │ │ │ │ -00024f10: 6564 2061 7320 666f 6c6c 6f77 733a 0a20 ed as follows:. │ │ │ │ │ -00024f20: 2020 2020 2020 2020 2049 2776 6520 6372 I've cr │ │ │ │ │ -00024f30: 6561 7465 6420 7468 6520 2261 7574 6f6d eated the "autom │ │ │ │ │ -00024f40: 616b 6522 206d 6169 6c69 6e67 206c 6973 ake" mailing lis │ │ │ │ │ -00024f50: 742e 2020 4974 2069 730a 2020 2020 2020 t. It is. │ │ │ │ │ -00024f60: 2020 2020 2261 7574 6f6d 616b 6540 676e "automake@gn │ │ │ │ │ -00024f70: 752e 6169 2e6d 6974 2e65 6475 222e 2020 u.ai.mit.edu". │ │ │ │ │ -00024f80: 4164 6d69 6e69 7374 7269 7669 612c 2061 Administrivia, a │ │ │ │ │ -00024f90: 7320 616c 7761 7973 2c20 746f 0a20 2020 s always, to. │ │ │ │ │ -00024fa0: 2020 2020 2020 2061 7574 6f6d 616b 652d automake- │ │ │ │ │ -00024fb0: 7265 7175 6573 7440 676e 752e 6169 2e6d request@gnu.ai.m │ │ │ │ │ -00024fc0: 6974 2e65 6475 2e0a 0a20 2020 2020 2020 it.edu... │ │ │ │ │ -00024fd0: 2020 2054 6865 2063 6861 7274 6572 206f The charter o │ │ │ │ │ -00024fe0: 6620 7468 6973 206c 6973 7420 6973 2064 f this list is d │ │ │ │ │ -00024ff0: 6973 6375 7373 696f 6e20 6f66 2061 7574 iscussion of aut │ │ │ │ │ -00025000: 6f6d 616b 652c 2061 7574 6f63 6f6e 662c omake, autoconf, │ │ │ │ │ -00025010: 2061 6e64 0a20 2020 2020 2020 2020 206f and. o │ │ │ │ │ -00025020: 7468 6572 2063 6f6e 6669 6775 7261 7469 ther configurati │ │ │ │ │ -00025030: 6f6e 2f70 6f72 7461 6269 6c69 7479 2074 on/portability t │ │ │ │ │ -00025040: 6f6f 6c73 2028 652e 672e 2c20 6c69 6274 ools (e.g., libt │ │ │ │ │ -00025050: 6f6f 6c29 2e20 2049 7420 6973 2065 7870 ool). It is exp │ │ │ │ │ -00025060: 6563 7465 640a 2020 2020 2020 2020 2020 ected. │ │ │ │ │ -00025070: 7468 6174 2064 6973 6375 7373 696f 6e20 that discussion │ │ │ │ │ -00025080: 7769 6c6c 2072 616e 6765 2066 726f 6d20 will range from │ │ │ │ │ -00025090: 706c 6561 7320 666f 7220 6865 6c70 2061 pleas for help a │ │ │ │ │ -000250a0: 6c6c 2074 6865 2077 6179 2075 7020 746f ll the way up to │ │ │ │ │ -000250b0: 0a20 2020 2020 2020 2020 2070 6174 6368 . patch │ │ │ │ │ -000250c0: 6573 2e0a 0a20 2020 2020 2020 2020 2054 es... T │ │ │ │ │ -000250d0: 6869 7320 6c69 7374 2069 7320 6172 6368 his list is arch │ │ │ │ │ -000250e0: 6976 6564 206f 6e20 7468 6520 4653 4620 ived on the FSF │ │ │ │ │ -000250f0: 6d61 6368 696e 6573 2e20 204f 6666 6861 machines. Offha │ │ │ │ │ -00025100: 6e64 2049 2064 6f6e 2774 206b 6e6f 7720 nd I don't know │ │ │ │ │ -00025110: 6966 0a20 2020 2020 2020 2020 2079 6f75 if. you │ │ │ │ │ -00025120: 2063 616e 2067 6574 2074 6865 2061 7263 can get the arc │ │ │ │ │ -00025130: 6869 7665 2077 6974 686f 7574 2061 6e20 hive without an │ │ │ │ │ -00025140: 6163 636f 756e 7420 7468 6572 652e 0a0a account there... │ │ │ │ │ -00025150: 2020 2020 2020 2020 2020 5468 6973 206c This l │ │ │ │ │ -00025160: 6973 7420 6973 206f 7065 6e20 746f 2061 ist is open to a │ │ │ │ │ -00025170: 6e79 626f 6479 2077 686f 2077 616e 7473 nybody who wants │ │ │ │ │ -00025180: 2074 6f20 6a6f 696e 2e20 2054 656c 6c20 to join. Tell │ │ │ │ │ -00025190: 616c 6c20 796f 7572 0a20 2020 2020 2020 all your. │ │ │ │ │ -000251a0: 2020 2066 7269 656e 6473 210a 2020 2020 friends!. │ │ │ │ │ -000251b0: 2020 2020 2020 2d2d 2054 6f6d 2054 726f -- Tom Tro │ │ │ │ │ -000251c0: 6d65 790a 0a20 2020 2020 4265 666f 7265 mey.. Before │ │ │ │ │ -000251d0: 2074 6861 7420 7065 6f70 6c65 2077 6572 that people wer │ │ │ │ │ -000251e0: 6520 6469 7363 7573 7369 6e67 2041 7574 e discussing Aut │ │ │ │ │ -000251f0: 6f6d 616b 6520 7072 6976 6174 656c 792c omake privately, │ │ │ │ │ -00025200: 206f 6e20 7468 6520 476e 6974 730a 2020 on the Gnits. │ │ │ │ │ -00025210: 2020 206d 6169 6c69 6e67 206c 6973 7420 mailing list │ │ │ │ │ -00025220: 2877 6869 6368 2069 7320 6e6f 7420 7075 (which is not pu │ │ │ │ │ -00025230: 626c 6963 2065 6974 6865 7229 2c20 616e blic either), an │ │ │ │ │ -00025240: 6420 6c65 7373 2066 7265 7175 656e 746c d less frequentl │ │ │ │ │ -00025250: 7920 6f6e 0a20 2020 2020 2767 6e75 2e6d y on. 'gnu.m │ │ │ │ │ -00025260: 6973 632e 6469 7363 7573 7327 2e0a 0a20 isc.discuss'... │ │ │ │ │ -00025270: 2020 2020 2767 6e75 2e61 692e 6d69 742e 'gnu.ai.mit. │ │ │ │ │ -00025280: 6564 7527 2069 7320 6e6f 7720 2767 6e75 edu' is now 'gnu │ │ │ │ │ -00025290: 2e6f 7267 272c 2069 6e20 6361 7365 2079 .org', in case y │ │ │ │ │ -000252a0: 6f75 206e 6576 6572 206e 6f74 6963 6564 ou never noticed │ │ │ │ │ -000252b0: 2e20 2054 6865 0a20 2020 2020 6172 6368 . The. arch │ │ │ │ │ -000252c0: 6976 6573 206f 6620 7468 6520 6561 726c ives of the earl │ │ │ │ │ -000252d0: 7920 7965 6172 7320 6f66 2074 6865 2027 y years of the ' │ │ │ │ │ -000252e0: 6175 746f 6d61 6b65 4067 6e75 2e6f 7267 automake@gnu.org │ │ │ │ │ -000252f0: 2720 6c69 7374 2068 6176 650a 2020 2020 ' list have. │ │ │ │ │ -00025300: 2062 6565 6e20 6c6f 7374 2c20 736f 2074 been lost, so t │ │ │ │ │ -00025310: 6f64 6179 2069 7420 6973 2061 6c6d 6f73 oday it is almos │ │ │ │ │ -00025320: 7420 696d 706f 7373 6962 6c65 2074 6f20 t impossible to │ │ │ │ │ -00025330: 6669 6e64 2074 7261 6365 7320 6f66 0a20 find traces of. │ │ │ │ │ -00025340: 2020 2020 6469 7363 7573 7369 6f6e 7320 discussions │ │ │ │ │ -00025350: 7468 6174 206f 6363 7572 7265 6420 6265 that occurred be │ │ │ │ │ -00025360: 666f 7265 2031 3939 392e 2020 5468 6973 fore 1999. This │ │ │ │ │ -00025370: 2068 6173 2062 6565 6e20 616e 6e6f 7969 has been annoyi │ │ │ │ │ -00025380: 6e67 206d 6f72 650a 2020 2020 2074 6861 ng more. tha │ │ │ │ │ -00025390: 6e20 6f6e 6365 2c20 6173 2073 7563 6820 n once, as such │ │ │ │ │ -000253a0: 6469 7363 7573 7369 6f6e 7320 6361 6e20 discussions can │ │ │ │ │ -000253b0: 6265 2075 7365 6675 6c20 746f 2075 6e64 be useful to und │ │ │ │ │ -000253c0: 6572 7374 616e 6420 7468 650a 2020 2020 erstand the. │ │ │ │ │ -000253d0: 2072 6174 696f 6e61 6c65 2062 6568 696e rationale behin │ │ │ │ │ -000253e0: 6420 6120 7069 6563 6520 6f66 2075 6e63 d a piece of unc │ │ │ │ │ -000253f0: 6f6d 6d65 6e74 6564 2063 6f64 6520 7468 ommented code th │ │ │ │ │ -00025400: 6174 2077 6173 2069 6e74 726f 6475 6365 at was introduce │ │ │ │ │ -00025410: 640a 2020 2020 2062 6163 6b20 7468 656e d. back then │ │ │ │ │ -00025420: 2e0a 0a31 3939 372d 3036 2d32 3220 4175 ...1997-06-22 Au │ │ │ │ │ -00025430: 746f 6d61 6b65 2031 2e32 0a0a 2020 2020 tomake 1.2.. │ │ │ │ │ -00025440: 2041 7574 6f6d 616b 6520 6465 7665 6c6f Automake develo │ │ │ │ │ -00025450: 706d 656e 7473 2063 6f6e 7469 6e75 6573 pments continues │ │ │ │ │ -00025460: 2c20 616e 6420 6d6f 7265 2061 6e64 206d , and more and m │ │ │ │ │ -00025470: 6f72 6520 6e65 7720 4175 746f 636f 6e66 ore new Autoconf │ │ │ │ │ -00025480: 0a20 2020 2020 6d61 6372 6f73 2061 7265 . macros are │ │ │ │ │ -00025490: 2072 6571 7569 7265 642e 2020 4469 7374 required. Dist │ │ │ │ │ -000254a0: 7269 6275 7469 6e67 2074 6865 6d20 696e ributing them in │ │ │ │ │ -000254b0: 2027 6163 6c6f 6361 6c2e 6d34 2720 616e 'aclocal.m4' an │ │ │ │ │ -000254c0: 640a 2020 2020 2072 6571 7569 7269 6e67 d. requiring │ │ │ │ │ -000254d0: 2070 656f 706c 6520 746f 2062 726f 7773 people to brows │ │ │ │ │ -000254e0: 6520 7468 6973 2066 696c 6520 746f 2065 e this file to e │ │ │ │ │ -000254f0: 7874 7261 6374 2074 6865 2072 656c 6576 xtract the relev │ │ │ │ │ -00025500: 616e 7420 6d61 6372 6f73 0a20 2020 2020 ant macros. │ │ │ │ │ -00025510: 6265 636f 6d65 7320 756e 636f 6d66 6f72 becomes uncomfor │ │ │ │ │ -00025520: 7461 626c 652e 2020 4964 6561 6c6c 792c table. Ideally, │ │ │ │ │ -00025530: 2073 6f6d 6520 6f66 2074 6865 6d20 7368 some of them sh │ │ │ │ │ -00025540: 6f75 6c64 2062 6520 636f 6e74 7269 6275 ould be contribu │ │ │ │ │ -00025550: 7465 640a 2020 2020 2074 6f20 4175 746f ted. to Auto │ │ │ │ │ -00025560: 636f 6e66 2073 6f20 7468 6174 2074 6865 conf so that the │ │ │ │ │ -00025570: 7920 6361 6e20 6265 2075 7365 6420 6469 y can be used di │ │ │ │ │ -00025580: 7265 6374 6c79 2c20 686f 7765 7665 7220 rectly, however │ │ │ │ │ -00025590: 4175 746f 636f 6e66 2069 730a 2020 2020 Autoconf is. │ │ │ │ │ -000255a0: 2063 7572 7265 6e74 6c79 2069 6e61 6374 currently inact │ │ │ │ │ -000255b0: 6976 652e 2020 4175 746f 6d61 6b65 2031 ive. Automake 1 │ │ │ │ │ -000255c0: 2e32 2063 6f6e 7365 7175 656e 746c 7920 .2 consequently │ │ │ │ │ -000255d0: 696e 7472 6f64 7563 6573 2027 6163 6c6f introduces 'aclo │ │ │ │ │ -000255e0: 6361 6c27 0a20 2020 2020 2827 6163 6c6f cal'. ('aclo │ │ │ │ │ -000255f0: 6361 6c27 2077 6173 2061 6374 7561 6c6c cal' was actuall │ │ │ │ │ -00025600: 7920 7374 6172 7465 6420 6f6e 2031 3939 y started on 199 │ │ │ │ │ -00025610: 362d 3037 2d32 3829 2c20 6120 746f 6f6c 6-07-28), a tool │ │ │ │ │ -00025620: 2074 6861 740a 2020 2020 2061 7574 6f6d that. autom │ │ │ │ │ -00025630: 6174 6963 616c 6c79 2063 6f6e 7374 7275 atically constru │ │ │ │ │ -00025640: 6374 7320 616e 2027 6163 6c6f 6361 6c2e cts an 'aclocal. │ │ │ │ │ -00025650: 6d34 2720 6669 6c65 2066 726f 6d20 6120 m4' file from a │ │ │ │ │ -00025660: 7265 706f 7369 746f 7279 206f 660a 2020 repository of. │ │ │ │ │ -00025670: 2020 2074 6869 7264 2d70 6172 7479 206d third-party m │ │ │ │ │ -00025680: 6163 726f 732e 2020 4265 6361 7573 6520 acros. Because │ │ │ │ │ -00025690: 4175 746f 636f 6e66 2068 6173 2073 7461 Autoconf has sta │ │ │ │ │ -000256a0: 6c6c 6564 2c20 4175 746f 6d61 6b65 2061 lled, Automake a │ │ │ │ │ -000256b0: 6c73 6f0a 2020 2020 2062 6563 6f6d 6573 lso. becomes │ │ │ │ │ -000256c0: 2061 206b 696e 6420 6f66 2072 6570 6f73 a kind of repos │ │ │ │ │ -000256d0: 6974 6f72 7920 666f 7220 7375 6368 2074 itory for such t │ │ │ │ │ -000256e0: 6869 7264 2d70 6172 7479 206d 6163 726f hird-party macro │ │ │ │ │ -000256f0: 732c 2065 7665 6e0a 2020 2020 206d 6163 s, even. mac │ │ │ │ │ -00025700: 726f 7320 636f 6d70 6c65 7465 6c79 2075 ros completely u │ │ │ │ │ -00025710: 6e72 656c 6174 6564 2074 6f20 4175 746f nrelated to Auto │ │ │ │ │ -00025720: 6d61 6b65 2028 666f 7220 696e 7374 616e make (for instan │ │ │ │ │ -00025730: 6365 206d 6163 726f 7320 7468 6174 0a20 ce macros that. │ │ │ │ │ -00025740: 2020 2020 6669 7820 6272 6f6b 656e 2041 fix broken A │ │ │ │ │ -00025750: 7574 6f63 6f6e 6620 6d61 6372 6f73 292e utoconf macros). │ │ │ │ │ -00025760: 0a0a 2020 2020 2054 6865 2031 2e32 2072 .. The 1.2 r │ │ │ │ │ -00025770: 656c 6561 7365 2063 6f6e 7461 696e 7320 elease contains │ │ │ │ │ -00025780: 3230 206d 6163 726f 732c 2069 6e63 6c75 20 macros, inclu │ │ │ │ │ -00025790: 6469 6e67 2074 6865 0a20 2020 2020 2741 ding the. 'A │ │ │ │ │ -000257a0: 4d5f 494e 4954 5f41 5554 4f4d 414b 4527 M_INIT_AUTOMAKE' │ │ │ │ │ -000257b0: 206d 6163 726f 2074 6861 7420 7369 6d70 macro that simp │ │ │ │ │ -000257c0: 6c69 6669 6573 2074 6865 2063 7265 6174 lifies the creat │ │ │ │ │ -000257d0: 696f 6e20 6f66 0a20 2020 2020 2763 6f6e ion of. 'con │ │ │ │ │ -000257e0: 6669 6775 7265 2e69 6e27 2e0a 0a20 2020 figure.in'... │ │ │ │ │ -000257f0: 2020 4c69 6274 6f6f 6c20 6973 2066 756c Libtool is ful │ │ │ │ │ -00025800: 6c79 2073 7570 706f 7274 6564 2075 7369 ly supported usi │ │ │ │ │ -00025810: 6e67 2027 2a5f 4c54 4c49 4252 4152 4945 ng '*_LTLIBRARIE │ │ │ │ │ -00025820: 5327 2e0a 0a20 2020 2020 5468 6520 6d69 S'... The mi │ │ │ │ │ -00025830: 7373 696e 6720 7363 7269 7074 2069 7320 ssing script is │ │ │ │ │ -00025840: 696e 7472 6f64 7563 6564 2062 7920 4672 introduced by Fr │ │ │ │ │ -00025850: 616e c3a7 6f69 7320 5069 6e61 7264 3b20 an..ois Pinard; │ │ │ │ │ -00025860: 6974 2069 7320 6d65 616e 7420 746f 0a20 it is meant to. │ │ │ │ │ -00025870: 2020 2020 6265 2061 2062 6574 7465 7220 be a better │ │ │ │ │ -00025880: 736f 6c75 7469 6f6e 2074 6861 6e20 2741 solution than 'A │ │ │ │ │ -00025890: 4d5f 4d41 494e 5441 494e 4552 5f4d 4f44 M_MAINTAINER_MOD │ │ │ │ │ -000258a0: 4527 2028 2a6e 6f74 650a 2020 2020 206d E' (*note. m │ │ │ │ │ -000258b0: 6169 6e74 6169 6e65 722d 6d6f 6465 3a3a aintainer-mode:: │ │ │ │ │ -000258c0: 292e 0a0a 2020 2020 2043 6f6e 6469 7469 )... Conditi │ │ │ │ │ -000258d0: 6f6e 616c 7320 7375 7070 6f72 7420 7761 onals support wa │ │ │ │ │ -000258e0: 7320 696d 706c 656d 656e 7465 6420 6279 s implemented by │ │ │ │ │ -000258f0: 2049 616e 204c 616e 6365 2054 6179 6c6f Ian Lance Taylo │ │ │ │ │ -00025900: 722e 2020 4174 2074 6865 0a20 2020 2020 r. At the. │ │ │ │ │ -00025910: 7469 6d65 2c20 546f 6d20 616e 6420 4961 time, Tom and Ia │ │ │ │ │ -00025920: 6e20 7765 7265 2077 6f72 6b69 6e67 206f n were working o │ │ │ │ │ -00025930: 6e20 616e 2069 6e74 6572 6e61 6c20 7072 n an internal pr │ │ │ │ │ -00025940: 6f6a 6563 7420 6174 2043 7967 6e75 732e oject at Cygnus. │ │ │ │ │ -00025950: 0a20 2020 2020 5468 6579 2077 6572 6520 . They were │ │ │ │ │ -00025960: 7573 696e 6720 494c 552c 2077 6869 6368 using ILU, which │ │ │ │ │ -00025970: 2069 7320 7072 6574 7479 2073 696d 696c is pretty simil │ │ │ │ │ -00025980: 6172 2074 6f20 434f 5242 412e 2020 5468 ar to CORBA. Th │ │ │ │ │ -00025990: 6579 2077 616e 7465 640a 2020 2020 2074 ey wanted. t │ │ │ │ │ -000259a0: 6f20 696e 7465 6772 6174 6520 494c 5520 o integrate ILU │ │ │ │ │ -000259b0: 696e 746f 2074 6865 6972 2062 7569 6c64 into their build │ │ │ │ │ -000259c0: 2c20 7768 6963 6820 7761 7320 616c 6c20 , which was all │ │ │ │ │ -000259d0: 2763 6f6e 6669 6775 7265 272d 6261 7365 'configure'-base │ │ │ │ │ -000259e0: 642c 0a20 2020 2020 616e 6420 4961 6e20 d,. and Ian │ │ │ │ │ -000259f0: 7468 6f75 6768 7420 7468 6174 2061 6464 thought that add │ │ │ │ │ -00025a00: 696e 6720 636f 6e64 6974 696f 6e61 6c73 ing conditionals │ │ │ │ │ -00025a10: 2074 6f20 2761 7574 6f6d 616b 6527 2077 to 'automake' w │ │ │ │ │ -00025a20: 6173 2073 696d 706c 6572 0a20 2020 2020 as simpler. │ │ │ │ │ -00025a30: 7468 616e 2064 6f69 6e67 2061 6c6c 2074 than doing all t │ │ │ │ │ -00025a40: 6865 2077 6f72 6b20 696e 2027 636f 6e66 he work in 'conf │ │ │ │ │ -00025a50: 6967 7572 6527 2028 7768 6963 6820 7761 igure' (which wa │ │ │ │ │ -00025a60: 7320 7468 6520 7374 616e 6461 7264 2061 s the standard a │ │ │ │ │ -00025a70: 740a 2020 2020 2074 6865 2074 696d 6529 t. the time) │ │ │ │ │ -00025a80: 2e20 2053 6f20 7468 6973 2077 6173 2061 . So this was a │ │ │ │ │ -00025a90: 6374 7561 6c6c 7920 6675 6e64 6564 2062 ctually funded b │ │ │ │ │ -00025aa0: 7920 4379 676e 7573 2e0a 0a20 2020 2020 y Cygnus... │ │ │ │ │ -00025ab0: 5468 6973 2076 6572 7920 7573 6566 756c This very useful │ │ │ │ │ -00025ac0: 2062 7574 2074 7269 636b 7920 6665 6174 but tricky feat │ │ │ │ │ -00025ad0: 7572 6520 7769 6c6c 2074 616b 6520 6120 ure will take a │ │ │ │ │ -00025ae0: 6c6f 7420 6f66 2074 696d 6520 746f 0a20 lot of time to. │ │ │ │ │ -00025af0: 2020 2020 7374 6162 696c 697a 652e 2020 stabilize. │ │ │ │ │ -00025b00: 2841 7420 7468 6520 7469 6d65 2074 6869 (At the time thi │ │ │ │ │ -00025b10: 7320 7465 7874 2069 7320 7772 6974 7465 s text is writte │ │ │ │ │ -00025b20: 6e2c 2074 6865 7265 2061 7265 2073 7469 n, there are sti │ │ │ │ │ -00025b30: 6c6c 0a20 2020 2020 7072 696d 6172 6965 ll. primarie │ │ │ │ │ -00025b40: 7320 7468 6174 2068 6176 6520 6e6f 7420 s that have not │ │ │ │ │ -00025b50: 6265 656e 2075 7064 6174 6564 2074 6f20 been updated to │ │ │ │ │ -00025b60: 7375 7070 6f72 7420 636f 6e64 6974 696f support conditio │ │ │ │ │ -00025b70: 6e61 6c0a 2020 2020 2064 6566 696e 6974 nal. definit │ │ │ │ │ -00025b80: 696f 6e73 2069 6e20 4175 746f 6d61 6b65 ions in Automake │ │ │ │ │ -00025b90: 2031 2e39 2e29 0a0a 2020 2020 2054 6865 1.9.).. The │ │ │ │ │ -00025ba0: 2027 6175 746f 6d61 6b65 2720 7363 7269 'automake' scri │ │ │ │ │ -00025bb0: 7074 2068 6173 2061 6c6d 6f73 7420 646f pt has almost do │ │ │ │ │ -00025bc0: 7562 6c65 643a 2036 3038 3920 6c69 6e65 ubled: 6089 line │ │ │ │ │ -00025bd0: 7320 6f66 2050 6572 6c2c 2070 6c75 730a s of Perl, plus. │ │ │ │ │ -00025be0: 2020 2020 2031 3239 3420 6c69 6e65 7320 1294 lines │ │ │ │ │ -00025bf0: 6f66 2027 4d61 6b65 6669 6c65 2720 6672 of 'Makefile' fr │ │ │ │ │ -00025c00: 6167 6d65 6e74 732e 0a0a 3139 3937 2d30 agments...1997-0 │ │ │ │ │ -00025c10: 372d 3038 2047 6f72 646f 6e20 4d61 747a 7-08 Gordon Matz │ │ │ │ │ -00025c20: 6967 6b65 6974 2072 656c 6561 7365 7320 igkeit releases │ │ │ │ │ -00025c30: 4c69 6274 6f6f 6c20 312e 302e 0a0a 3139 Libtool 1.0...19 │ │ │ │ │ -00025c40: 3938 2d30 342d 3035 2041 7574 6f6d 616b 98-04-05 Automak │ │ │ │ │ -00025c50: 6520 312e 330a 0a20 2020 2020 5468 6973 e 1.3.. This │ │ │ │ │ -00025c60: 2069 7320 6120 736d 616c 6c20 6164 7661 is a small adva │ │ │ │ │ -00025c70: 6e63 6520 636f 6d70 6172 6564 2074 6f20 nce compared to │ │ │ │ │ -00025c80: 312e 322e 2020 4974 2061 6464 7320 7375 1.2. It adds su │ │ │ │ │ -00025c90: 7070 6f72 7420 666f 720a 2020 2020 2061 pport for. a │ │ │ │ │ -00025ca0: 7373 656d 626c 792c 2061 6e64 2070 7265 ssembly, and pre │ │ │ │ │ -00025cb0: 6c69 6d69 6e61 7279 2073 7570 706f 7274 liminary support │ │ │ │ │ -00025cc0: 2066 6f72 204a 6176 612e 0a0a 2020 2020 for Java... │ │ │ │ │ -00025cd0: 2050 6572 6c20 352e 3030 345f 3034 2069 Perl 5.004_04 i │ │ │ │ │ -00025ce0: 7320 6f75 742c 2062 7574 2066 6978 6573 s out, but fixes │ │ │ │ │ -00025cf0: 2074 6f20 7375 7070 6f72 7420 5065 726c to support Perl │ │ │ │ │ -00025d00: 2034 2061 7265 2073 7469 6c6c 0a20 2020 4 are still. │ │ │ │ │ -00025d10: 2020 7265 6775 6c61 726c 7920 7375 626d regularly subm │ │ │ │ │ -00025d20: 6974 7465 6420 7768 656e 6576 6572 2041 itted whenever A │ │ │ │ │ -00025d30: 7574 6f6d 616b 6520 6272 6561 6b73 2069 utomake breaks i │ │ │ │ │ -00025d40: 742e 0a0a 3139 3938 2d30 392d 3036 2027 t...1998-09-06 ' │ │ │ │ │ -00025d50: 736f 7572 6365 7761 7265 2e63 7967 6e75 sourceware.cygnu │ │ │ │ │ -00025d60: 732e 636f 6d27 2069 7320 6f6e 2d6c 696e s.com' is on-lin │ │ │ │ │ -00025d70: 652e 0a0a 2020 2020 2053 6f75 7263 6577 e... Sourcew │ │ │ │ │ -00025d80: 6172 6520 7761 7320 7365 7475 7020 6279 are was setup by │ │ │ │ │ -00025d90: 204a 6173 6f6e 204d 6f6c 656e 6461 2074 Jason Molenda t │ │ │ │ │ -00025da0: 6f20 686f 7374 206f 7065 6e20 736f 7572 o host open sour │ │ │ │ │ -00025db0: 6365 2070 726f 6a65 6374 732e 0a0a 3139 ce projects...19 │ │ │ │ │ -00025dc0: 3938 2d30 392d 3139 2041 7574 6f6d 616b 98-09-19 Automak │ │ │ │ │ -00025dd0: 6520 4356 5320 7265 706f 7369 746f 7279 e CVS repository │ │ │ │ │ -00025de0: 206d 6f76 6564 2074 6f20 2773 6f75 7263 moved to 'sourc │ │ │ │ │ -00025df0: 6577 6172 652e 6379 676e 7573 2e63 6f6d eware.cygnus.com │ │ │ │ │ -00025e00: 270a 3139 3938 2d31 302d 3236 2027 736f '.1998-10-26 'so │ │ │ │ │ -00025e10: 7572 6365 7761 7265 2e63 7967 6e75 732e urceware.cygnus. │ │ │ │ │ -00025e20: 636f 6d27 2061 6e6e 6f75 6e63 6573 2069 com' announces i │ │ │ │ │ -00025e30: 7420 686f 7374 7320 4175 746f 6d61 6b65 t hosts Automake │ │ │ │ │ -00025e40: 3a0a 2020 2020 2041 7574 6f6d 616b 6520 :. Automake │ │ │ │ │ -00025e50: 6973 206e 6f77 2068 6f73 7465 6420 6f6e is now hosted on │ │ │ │ │ -00025e60: 2027 736f 7572 6365 7761 7265 2e63 7967 'sourceware.cyg │ │ │ │ │ -00025e70: 6e75 732e 636f 6d27 2e20 2049 7420 6861 nus.com'. It ha │ │ │ │ │ -00025e80: 7320 610a 2020 2020 2070 7562 6c69 636c s a. publicl │ │ │ │ │ -00025e90: 7920 6163 6365 7373 6962 6c65 2043 5653 y accessible CVS │ │ │ │ │ -00025ea0: 2072 6570 6f73 6974 6f72 792e 2020 5468 repository. Th │ │ │ │ │ -00025eb0: 6973 2043 5653 2072 6570 6f73 6974 6f72 is CVS repositor │ │ │ │ │ -00025ec0: 7920 6973 2061 2063 6f70 790a 2020 2020 y is a copy. │ │ │ │ │ -00025ed0: 206f 6620 7468 6520 6f6e 6520 546f 6d20 of the one Tom │ │ │ │ │ -00025ee0: 7761 7320 7573 696e 6720 6f6e 2068 6973 was using on his │ │ │ │ │ -00025ef0: 206d 6163 6869 6e65 2c20 7768 6963 6820 machine, which │ │ │ │ │ -00025f00: 696e 2074 7572 6e20 6973 2062 6173 6564 in turn is based │ │ │ │ │ -00025f10: 206f 6e0a 2020 2020 2061 2063 6f70 7920 on. a copy │ │ │ │ │ -00025f20: 6f66 2074 6865 2043 5653 2072 6570 6f73 of the CVS repos │ │ │ │ │ -00025f30: 6974 6f72 7920 6f66 2044 6176 6964 204d itory of David M │ │ │ │ │ -00025f40: 6163 4b65 6e7a 6965 2e20 2054 6869 7320 acKenzie. This │ │ │ │ │ -00025f50: 6973 2077 6879 2077 650a 2020 2020 2073 is why we. s │ │ │ │ │ -00025f60: 7469 6c6c 2068 6176 6520 746f 2066 756c till have to ful │ │ │ │ │ -00025f70: 6c20 736f 7572 6365 2068 6973 746f 7279 l source history │ │ │ │ │ -00025f80: 2e20 2028 4175 746f 6d61 6b65 2077 6173 . (Automake was │ │ │ │ │ -00025f90: 206f 6e20 536f 7572 6365 7761 7265 0a20 on Sourceware. │ │ │ │ │ -00025fa0: 2020 2020 756e 7469 6c20 3230 3037 2d31 until 2007-1 │ │ │ │ │ -00025fb0: 302d 3239 2c20 7768 656e 2069 7420 6d6f 0-29, when it mo │ │ │ │ │ -00025fc0: 7665 6420 746f 2061 2067 6974 2072 6570 ved to a git rep │ │ │ │ │ -00025fd0: 6f73 6974 6f72 7920 6f6e 0a20 2020 2020 ository on. │ │ │ │ │ -00025fe0: 2773 6176 616e 6e61 682e 676e 752e 6f72 'savannah.gnu.or │ │ │ │ │ -00025ff0: 6727 2c20 6275 7420 7468 6520 536f 7572 g', but the Sour │ │ │ │ │ -00026000: 6365 7761 7265 2068 6f73 7420 6861 6420 ceware host had │ │ │ │ │ -00026010: 6265 656e 2072 656e 616d 6564 2074 6f0a been renamed to. │ │ │ │ │ -00026020: 2020 2020 2027 736f 7572 6365 732e 7265 'sources.re │ │ │ │ │ -00026030: 6468 6174 2e63 6f6d 272e 290a 0a20 2020 dhat.com'.).. │ │ │ │ │ -00026040: 2020 5468 6520 6f6c 6465 7374 2066 696c The oldest fil │ │ │ │ │ -00026050: 6520 696e 2074 6865 2061 646d 696e 6973 e in the adminis │ │ │ │ │ -00026060: 7472 6174 6976 6520 6469 7265 6374 6f72 trative director │ │ │ │ │ -00026070: 7920 6f66 2074 6865 2043 5653 0a20 2020 y of the CVS. │ │ │ │ │ -00026080: 2020 7265 706f 7369 746f 7279 2074 6861 repository tha │ │ │ │ │ -00026090: 7420 7761 7320 6372 6561 7465 6420 6f6e t was created on │ │ │ │ │ -000260a0: 2053 6f75 7263 6577 6172 6520 6973 2064 Sourceware is d │ │ │ │ │ -000260b0: 6174 6564 2031 3939 382d 3039 2d31 392c ated 1998-09-19, │ │ │ │ │ -000260c0: 0a20 2020 2020 7768 696c 6520 7468 6520 . while the │ │ │ │ │ -000260d0: 616e 6e6f 756e 6365 6d65 6e74 2074 6861 announcement tha │ │ │ │ │ -000260e0: 7420 2761 7574 6f6d 616b 6527 2061 6e64 t 'automake' and │ │ │ │ │ -000260f0: 2027 6175 746f 636f 6e66 2720 6861 6420 'autoconf' had │ │ │ │ │ -00026100: 6a6f 696e 6564 0a20 2020 2020 2773 6f75 joined. 'sou │ │ │ │ │ -00026110: 7263 6577 6172 6527 2077 6173 206d 6164 rceware' was mad │ │ │ │ │ -00026120: 6520 6f6e 2031 3939 382d 3130 2d32 362e e on 1998-10-26. │ │ │ │ │ -00026130: 2020 5468 6579 2077 6572 6520 616d 6f6e They were amon │ │ │ │ │ -00026140: 6720 7468 6520 6669 7273 740a 2020 2020 g the first. │ │ │ │ │ -00026150: 2070 726f 6a65 6374 7320 746f 2062 6520 projects to be │ │ │ │ │ -00026160: 686f 7374 6564 2074 6865 7265 2e0a 0a20 hosted there... │ │ │ │ │ -00026170: 2020 2020 5468 6520 6865 6564 6675 6c20 The heedful │ │ │ │ │ -00026180: 7265 6164 6572 2077 696c 6c20 6861 7665 reader will have │ │ │ │ │ -00026190: 206e 6f74 6963 6564 2041 7574 6f6d 616b noticed Automak │ │ │ │ │ -000261a0: 6520 7761 7320 6578 6163 746c 7920 3420 e was exactly 4 │ │ │ │ │ -000261b0: 7965 6172 730a 2020 2020 206f 6c64 206f years. old o │ │ │ │ │ -000261c0: 6e20 3139 3938 2d30 392d 3139 2e0a 0a31 n 1998-09-19...1 │ │ │ │ │ -000261d0: 3939 392d 3031 2d30 3520 4265 6e20 456c 999-01-05 Ben El │ │ │ │ │ -000261e0: 6c69 7374 6f6e 2072 656c 6561 7365 7320 liston releases │ │ │ │ │ -000261f0: 4175 746f 636f 6e66 2032 2e31 332e 0a0a Autoconf 2.13... │ │ │ │ │ -00026200: 3139 3939 2d30 312d 3134 2041 7574 6f6d 1999-01-14 Autom │ │ │ │ │ -00026210: 616b 6520 312e 340a 0a20 2020 2020 5468 ake 1.4.. Th │ │ │ │ │ -00026220: 6973 2072 656c 6561 7365 2061 6464 7320 is release adds │ │ │ │ │ -00026230: 7375 7070 6f72 7420 666f 7220 466f 7274 support for Fort │ │ │ │ │ -00026240: 7261 6e20 3737 2061 6e64 2066 6f72 2074 ran 77 and for t │ │ │ │ │ -00026250: 6865 2027 696e 636c 7564 6527 0a20 2020 he 'include'. │ │ │ │ │ -00026260: 2020 7374 6174 656d 656e 742e 2020 416c statement. Al │ │ │ │ │ -00026270: 736f 2c20 272b 3d27 2061 7373 6967 6e6d so, '+=' assignm │ │ │ │ │ -00026280: 656e 7473 2061 7265 2069 6e74 726f 6475 ents are introdu │ │ │ │ │ -00026290: 6365 642c 2062 7574 2069 7420 6973 2073 ced, but it is s │ │ │ │ │ -000262a0: 7469 6c6c 0a20 2020 2020 7175 6974 6520 till. quite │ │ │ │ │ -000262b0: 6561 7379 2074 6f20 666f 6f6c 2041 7574 easy to fool Aut │ │ │ │ │ -000262c0: 6f6d 616b 6520 7768 656e 206d 6978 696e omake when mixin │ │ │ │ │ -000262d0: 6720 7468 6973 2077 6974 6820 636f 6e64 g this with cond │ │ │ │ │ -000262e0: 6974 696f 6e61 6c73 2e0a 0a20 2020 2020 itionals... │ │ │ │ │ -000262f0: 5468 6573 6520 7477 6f20 7265 6c65 6173 These two releas │ │ │ │ │ -00026300: 6573 2c20 4175 746f 6d61 6b65 2031 2e34 es, Automake 1.4 │ │ │ │ │ -00026310: 2061 6e64 2041 7574 6f63 6f6e 6620 322e and Autoconf 2. │ │ │ │ │ -00026320: 3133 206d 616b 6520 6120 6475 6f20 7468 13 make a duo th │ │ │ │ │ -00026330: 6174 0a20 2020 2020 7769 6c6c 2062 6520 at. will be │ │ │ │ │ -00026340: 7573 6564 2074 6f67 6574 6865 7220 666f used together fo │ │ │ │ │ -00026350: 7220 7965 6172 732e 0a0a 2020 2020 2027 r years... ' │ │ │ │ │ -00026360: 6175 746f 6d61 6b65 2720 6973 2037 3232 automake' is 722 │ │ │ │ │ -00026370: 3820 6c69 6e65 732c 2070 6c75 7320 3135 8 lines, plus 15 │ │ │ │ │ -00026380: 3931 206c 696e 6573 206f 6620 4d61 6b65 91 lines of Make │ │ │ │ │ -00026390: 6669 6c65 2066 7261 676d 656e 742c 2032 file fragment, 2 │ │ │ │ │ -000263a0: 300a 2020 2020 206d 6163 726f 7320 2873 0. macros (s │ │ │ │ │ -000263b0: 6f6d 6520 312e 3320 6d61 6372 6f73 2077 ome 1.3 macros w │ │ │ │ │ -000263c0: 6572 6520 6669 6e61 6c6c 7920 636f 6e74 ere finally cont │ │ │ │ │ -000263d0: 7269 6275 7465 6420 6261 636b 2074 6f20 ributed back to │ │ │ │ │ -000263e0: 4175 746f 636f 6e66 292c 0a20 2020 2020 Autoconf),. │ │ │ │ │ -000263f0: 3139 3720 7465 7374 2063 6173 6573 2c20 197 test cases, │ │ │ │ │ -00026400: 616e 6420 3531 2070 6167 6573 206f 6620 and 51 pages of │ │ │ │ │ -00026410: 646f 6375 6d65 6e74 6174 696f 6e2e 0a0a documentation... │ │ │ │ │ -00026420: 3139 3939 2d30 332d 3237 2054 6865 2027 1999-03-27 The ' │ │ │ │ │ -00026430: 7573 6572 2d64 6570 2d62 7261 6e63 6827 user-dep-branch' │ │ │ │ │ -00026440: 2069 7320 6372 6561 7465 6420 6f6e 2074 is created on t │ │ │ │ │ -00026450: 6865 2043 5653 2072 6570 6f73 6974 6f72 he CVS repositor │ │ │ │ │ -00026460: 792e 0a0a 2020 2020 2054 6869 7320 696d y... This im │ │ │ │ │ -00026470: 706c 656d 656e 7473 2061 206e 6577 2064 plements a new d │ │ │ │ │ -00026480: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ -00026490: 6e67 2073 6368 656d 6564 2074 6861 7420 ng schemed that │ │ │ │ │ -000264a0: 7368 6f75 6c64 2062 650a 2020 2020 2061 should be. a │ │ │ │ │ -000264b0: 626c 6520 746f 2068 616e 646c 6520 6175 ble to handle au │ │ │ │ │ -000264c0: 746f 6d61 7469 6320 6465 7065 6e64 656e tomatic dependen │ │ │ │ │ -000264d0: 6379 2074 7261 636b 696e 6720 7573 696e cy tracking usin │ │ │ │ │ -000264e0: 6720 616e 7920 636f 6d70 696c 6572 0a20 g any compiler. │ │ │ │ │ -000264f0: 2020 2020 286e 6f74 206a 7573 7420 6763 (not just gc │ │ │ │ │ -00026500: 6329 2061 6e64 2061 6e79 206d 616b 6520 c) and any make │ │ │ │ │ -00026510: 286e 6f74 206a 7573 7420 474e 5520 276d (not just GNU 'm │ │ │ │ │ -00026520: 616b 6527 292e 2020 496e 2061 6464 6974 ake'). In addit │ │ │ │ │ -00026530: 696f 6e2c 0a20 2020 2020 7468 6520 6e65 ion,. the ne │ │ │ │ │ -00026540: 7720 7363 6865 6d65 2073 686f 756c 6420 w scheme should │ │ │ │ │ -00026550: 6265 206d 6f72 6520 7265 6c69 6162 6c65 be more reliable │ │ │ │ │ -00026560: 2074 6861 6e20 7468 6520 6f6c 6420 6f6e than the old on │ │ │ │ │ -00026570: 652c 2061 730a 2020 2020 2064 6570 656e e, as. depen │ │ │ │ │ -00026580: 6465 6e63 6965 7320 6172 6520 6765 6e65 dencies are gene │ │ │ │ │ -00026590: 7261 7465 6420 6f6e 2074 6865 2065 6e64 rated on the end │ │ │ │ │ -000265a0: 2075 7365 7227 7320 6d61 6368 696e 652e user's machine. │ │ │ │ │ -000265b0: 2020 416c 6578 616e 6472 650a 2020 2020 Alexandre. │ │ │ │ │ -000265c0: 204f 6c69 7661 2063 7265 6174 6573 2064 Oliva creates d │ │ │ │ │ -000265d0: 6570 636f 6d70 2066 6f72 2074 6869 7320 epcomp for this │ │ │ │ │ -000265e0: 7075 7270 6f73 652e 0a0a 2020 2020 202a purpose... * │ │ │ │ │ -000265f0: 4e6f 7465 2044 6570 656e 6465 6e63 7920 Note Dependency │ │ │ │ │ -00026600: 5472 6163 6b69 6e67 2045 766f 6c75 7469 Tracking Evoluti │ │ │ │ │ -00026610: 6f6e 3a3a 2c20 666f 7220 6d6f 7265 2064 on::, for more d │ │ │ │ │ -00026620: 6574 6169 6c73 2061 626f 7574 2074 6865 etails about the │ │ │ │ │ -00026630: 0a20 2020 2020 6576 6f6c 7574 696f 6e20 . evolution │ │ │ │ │ -00026640: 6f66 2061 7574 6f6d 6174 6963 2064 6570 of automatic dep │ │ │ │ │ -00026650: 656e 6465 6e63 7920 7472 6163 6b69 6e67 endency tracking │ │ │ │ │ -00026660: 2069 6e20 4175 746f 6d61 6b65 2e0a 0a31 in Automake...1 │ │ │ │ │ -00026670: 3939 392d 3131 2d32 3120 5468 6520 2775 999-11-21 The 'u │ │ │ │ │ -00026680: 7365 722d 6465 702d 6272 616e 6368 2720 ser-dep-branch' │ │ │ │ │ -00026690: 6973 206d 6572 6765 6420 696e 746f 2074 is merged into t │ │ │ │ │ -000266a0: 6865 206d 6169 6e20 7472 756e 6b2e 0a0a he main trunk... │ │ │ │ │ -000266b0: 2020 2020 2054 6869 7320 7761 7320 6120 This was a │ │ │ │ │ -000266c0: 6875 6765 2070 726f 626c 656d 2073 696e huge problem sin │ │ │ │ │ -000266d0: 6365 2077 6520 616c 736f 2068 6164 2070 ce we also had p │ │ │ │ │ -000266e0: 6174 6368 6573 2067 6f69 6e67 2069 6e20 atches going in │ │ │ │ │ -000266f0: 6f6e 2074 6865 0a20 2020 2020 7472 756e on the. trun │ │ │ │ │ -00026700: 6b2e 2020 5468 6520 6d65 7267 6520 746f k. The merge to │ │ │ │ │ -00026710: 6f6b 2061 206c 6f6e 6720 7469 6d65 2061 ok a long time a │ │ │ │ │ -00026720: 6e64 2077 6173 2076 6572 7920 7061 696e nd was very pain │ │ │ │ │ -00026730: 6675 6c2e 0a0a 3230 3030 2d30 352d 3130 ful...2000-05-10 │ │ │ │ │ -00026740: 0a0a 2020 2020 2053 696e 6365 2053 6570 .. Since Sep │ │ │ │ │ -00026750: 7465 6d62 6572 2031 3939 3920 616e 6420 tember 1999 and │ │ │ │ │ -00026760: 756e 7469 6c20 3230 3033 2c20 416b 696d until 2003, Akim │ │ │ │ │ -00026770: 2044 656d 6169 6c6c 6520 7769 6c6c 2062 Demaille will b │ │ │ │ │ -00026780: 650a 2020 2020 207a 6561 6c6f 7573 6c79 e. zealously │ │ │ │ │ -00026790: 2072 6576 616d 7069 6e67 2041 7574 6f63 revamping Autoc │ │ │ │ │ -000267a0: 6f6e 662e 0a0a 2020 2020 2020 2020 2020 onf... │ │ │ │ │ -000267b0: 4920 7468 696e 6b20 7468 6520 6e65 7874 I think the next │ │ │ │ │ -000267c0: 2072 656c 6561 7365 2073 686f 756c 6420 release should │ │ │ │ │ -000267d0: 6265 2063 616c 6c65 6420 2233 2e30 222e be called "3.0". │ │ │ │ │ -000267e0: 0a20 2020 2020 2020 2020 204c 6574 2773 . Let's │ │ │ │ │ -000267f0: 2066 6163 6520 6974 3a20 796f 7527 7665 face it: you've │ │ │ │ │ -00026800: 2062 6173 6963 616c 6c79 2072 6577 7269 basically rewri │ │ │ │ │ -00026810: 7474 656e 2061 7574 6f63 6f6e 662e 0a20 tten autoconf.. │ │ │ │ │ -00026820: 2020 2020 2020 2020 2045 7665 7279 2077 Every w │ │ │ │ │ -00026830: 6565 6b65 6e64 2074 6865 7265 2061 7265 eekend there are │ │ │ │ │ -00026840: 2033 3020 6e65 7720 7061 7463 6865 732e 30 new patches. │ │ │ │ │ -00026850: 0a20 2020 2020 2020 2020 2049 2064 6f6e . I don │ │ │ │ │ -00026860: 2774 2073 6565 2068 6f77 2077 6520 636f 't see how we co │ │ │ │ │ -00026870: 756c 6420 6361 6c6c 2074 6869 7320 2232 uld call this "2 │ │ │ │ │ -00026880: 2e31 3522 2077 6974 6820 6120 7374 7261 .15" with a stra │ │ │ │ │ -00026890: 6967 6874 0a20 2020 2020 2020 2020 2066 ight. f │ │ │ │ │ -000268a0: 6163 652e 0a20 2020 2020 2020 2020 202d ace.. - │ │ │ │ │ -000268b0: 2054 6f6d 2054 726f 6d65 7920 6f6e 203c Tom Tromey on < │ │ │ │ │ -000268c0: 6175 746f 636f 6e66 4067 6e75 2e6f 7267 autoconf@gnu.org │ │ │ │ │ -000268d0: 3e0a 0a20 2020 2020 4163 7475 616c 6c79 >.. Actually │ │ │ │ │ -000268e0: 2041 6b69 6d20 776f 726b 7320 6c69 6b65 Akim works like │ │ │ │ │ -000268f0: 2061 2073 7562 6d61 7269 6e65 3a20 6865 a submarine: he │ │ │ │ │ -00026900: 2077 696c 6c20 7069 6c65 2075 7020 7061 will pile up pa │ │ │ │ │ -00026910: 7463 6865 7320 7768 696c 650a 2020 2020 tches while. │ │ │ │ │ -00026920: 2068 6520 776f 726b 7320 6f66 662d 6c69 he works off-li │ │ │ │ │ -00026930: 6e65 2064 7572 696e 6720 7468 6520 7765 ne during the we │ │ │ │ │ -00026940: 656b 656e 642c 2061 6e64 2066 6c75 7368 ekend, and flush │ │ │ │ │ -00026950: 2074 6865 6d20 696e 2062 6174 6368 2077 them in batch w │ │ │ │ │ -00026960: 6865 6e0a 2020 2020 2068 6520 7265 7375 hen. he resu │ │ │ │ │ -00026970: 7266 6163 6573 206f 6e20 4d6f 6e64 6179 rfaces on Monday │ │ │ │ │ -00026980: 2e0a 0a32 3030 312d 3031 2d32 340a 0a20 ...2001-01-24.. │ │ │ │ │ -00026990: 2020 2020 4f6e 2074 6869 7320 5765 646e On this Wedn │ │ │ │ │ -000269a0: 6573 6461 792c 2041 7574 6f63 6f6e 6620 esday, Autoconf │ │ │ │ │ -000269b0: 322e 3439 632c 2074 6865 206c 6173 7420 2.49c, the last │ │ │ │ │ -000269c0: 6265 7461 2062 6566 6f72 6520 4175 746f beta before Auto │ │ │ │ │ -000269d0: 636f 6e66 0a20 2020 2020 322e 3530 2069 conf. 2.50 i │ │ │ │ │ -000269e0: 7320 6f75 742c 2061 6e64 2041 6b69 6d20 s out, and Akim │ │ │ │ │ -000269f0: 6861 7320 746f 2066 696e 6420 736f 6d65 has to find some │ │ │ │ │ -00026a00: 7468 696e 6720 746f 2064 6f20 6475 7269 thing to do duri │ │ │ │ │ -00026a10: 6e67 2068 6973 0a20 2020 2020 7765 656b ng his. week │ │ │ │ │ -00026a20: 2d65 6e64 203a 290a 0a32 3030 312d 3031 -end :)..2001-01 │ │ │ │ │ -00026a30: 2d32 380a 0a20 2020 2020 416b 696d 2073 -28.. Akim s │ │ │ │ │ -00026a40: 656e 6473 2061 2062 6174 6368 206f 6620 ends a batch of │ │ │ │ │ -00026a50: 3134 2070 6174 6368 6573 2074 6f20 3c61 14 patches to │ │ │ │ │ -00026a70: 2e0a 0a20 2020 2020 2020 2020 2041 6969 ... Aii │ │ │ │ │ -00026a80: 6565 6565 2120 2049 2077 6173 2064 7265 eeee! I was dre │ │ │ │ │ -00026a90: 6164 696e 6720 7468 6520 6461 7920 7468 ading the day th │ │ │ │ │ -00026aa0: 6174 2074 6865 2044 656d 6169 6c6c 6174 at the Demaillat │ │ │ │ │ -00026ab0: 6f72 2074 7572 6e65 640a 2020 2020 2020 or turned. │ │ │ │ │ -00026ac0: 2020 2020 6869 7320 7369 6768 7473 206f his sights o │ │ │ │ │ -00026ad0: 6e20 6175 746f 6d61 6b65 2e2e 2e20 616e n automake... an │ │ │ │ │ -00026ae0: 6420 6e6f 7720 6974 2068 6173 2061 7272 d now it has arr │ │ │ │ │ -00026af0: 6976 6564 2120 202d 2054 6f6d 0a20 2020 ived! - Tom. │ │ │ │ │ -00026b00: 2020 2020 2020 2054 726f 6d65 790a 0a20 Tromey.. │ │ │ │ │ -00026b10: 2020 2020 4974 2773 206f 6e6c 7920 7468 It's only th │ │ │ │ │ -00026b20: 6520 6265 6769 6e6e 696e 673a 2069 6e20 e beginning: in │ │ │ │ │ -00026b30: 7477 6f20 6d6f 6e74 6873 2068 6520 7769 two months he wi │ │ │ │ │ -00026b40: 6c6c 2073 656e 6420 3139 3220 7061 7463 ll send 192 patc │ │ │ │ │ -00026b50: 6865 732e 0a20 2020 2020 5468 656e 2068 hes.. Then h │ │ │ │ │ -00026b60: 6520 776f 756c 6420 736c 6f77 2064 6f77 e would slow dow │ │ │ │ │ -00026b70: 6e20 736f 2054 6f6d 2063 616e 2063 6174 n so Tom can cat │ │ │ │ │ -00026b80: 6368 2075 7020 616e 6420 7265 7669 6577 ch up and review │ │ │ │ │ -00026b90: 2061 6c6c 2074 6869 732e 0a20 2020 2020 all this.. │ │ │ │ │ -00026ba0: 496e 6974 6961 6c6c 7920 546f 6d20 6163 Initially Tom ac │ │ │ │ │ -00026bb0: 7475 616c 6c79 2072 6561 6420 616c 6c20 tually read all │ │ │ │ │ -00026bc0: 7468 6573 6520 7061 7463 6865 732c 2074 these patches, t │ │ │ │ │ -00026bd0: 6865 6e20 6865 2070 726f 6261 626c 790a hen he probably. │ │ │ │ │ -00026be0: 2020 2020 2074 7275 7374 696e 676c 7920 trustingly │ │ │ │ │ -00026bf0: 616e 7377 6572 6564 204f 4b20 746f 206d answered OK to m │ │ │ │ │ -00026c00: 6f73 7420 6f66 2074 6865 6d2c 2061 6e64 ost of them, and │ │ │ │ │ -00026c10: 2066 696e 616c 6c79 2067 6176 6520 7570 finally gave up │ │ │ │ │ -00026c20: 2061 6e64 206c 6574 0a20 2020 2020 416b and let. Ak │ │ │ │ │ -00026c30: 696d 2061 7070 6c79 2077 6861 7465 7665 im apply whateve │ │ │ │ │ -00026c40: 7220 6865 2077 616e 7465 642e 2020 5468 r he wanted. Th │ │ │ │ │ -00026c50: 6572 6520 7761 7320 6e6f 2077 6179 2074 ere was no way t │ │ │ │ │ -00026c60: 6f20 6b65 6570 2075 7020 7769 7468 0a20 o keep up with. │ │ │ │ │ -00026c70: 2020 2020 7468 6174 2070 6174 6368 2072 that patch r │ │ │ │ │ -00026c80: 6174 652e 0a0a 2020 2020 2020 2020 2020 ate... │ │ │ │ │ -00026c90: 416e 7977 6179 2074 6865 2070 6174 6368 Anyway the patch │ │ │ │ │ -00026ca0: 2062 656c 6f77 2077 6f6e 2774 2061 7070 below won't app │ │ │ │ │ -00026cb0: 6c79 2073 696e 6365 2069 7420 7072 6564 ly since it pred │ │ │ │ │ -00026cc0: 6174 6573 2041 6b69 6d27 730a 2020 2020 ates Akim's. │ │ │ │ │ -00026cd0: 2020 2020 2020 736f 7572 6365 7175 616b sourcequak │ │ │ │ │ -00026ce0: 653b 2049 2068 6176 6520 7965 7420 746f e; I have yet to │ │ │ │ │ -00026cf0: 2066 6967 7572 6520 7768 6572 6520 7468 figure where th │ │ │ │ │ -00026d00: 6520 7265 6c65 7661 6e74 2070 6173 7361 e relevant passa │ │ │ │ │ -00026d10: 6765 0a20 2020 2020 2020 2020 2068 6173 ge. has │ │ │ │ │ -00026d20: 2062 6565 6e20 6d6f 7665 6420 3a29 202d been moved :) - │ │ │ │ │ -00026d30: 2041 6c65 7861 6e64 7265 2044 7572 6574 Alexandre Duret │ │ │ │ │ -00026d40: 2d4c 7574 7a0a 0a20 2020 2020 416c 6c20 -Lutz.. All │ │ │ │ │ -00026d50: 7468 6573 6520 7061 7463 6865 7320 7765 these patches we │ │ │ │ │ -00026d60: 7265 2073 656e 7420 746f 2061 6e64 2064 re sent to and d │ │ │ │ │ -00026d70: 6973 6375 7373 6564 206f 6e20 3c61 7574 iscussed on ,. │ │ │ │ │ -00026d90: 2020 2020 2073 6f20 7375 6273 6372 6962 so subscrib │ │ │ │ │ -00026da0: 6564 2075 7365 7273 2077 6572 6520 6c69 ed users were li │ │ │ │ │ -00026db0: 7465 7261 6c6c 7920 6472 6f77 6e69 6e67 terally drowning │ │ │ │ │ -00026dc0: 2069 6e20 7465 6368 6e69 6361 6c20 6d61 in technical ma │ │ │ │ │ -00026dd0: 696c 732e 0a20 2020 2020 4576 656e 7475 ils.. Eventu │ │ │ │ │ -00026de0: 616c 6c79 2c20 7468 6520 3c61 7574 6f6d ally, the mailing lis │ │ │ │ │ -00026e10: 7420 7761 7320 6372 6561 7465 640a 2020 t was created. │ │ │ │ │ -00026e20: 2020 2069 6e20 4d61 792e 0a0a 2020 2020 in May... │ │ │ │ │ -00026e30: 2059 6561 7220 6166 7465 7220 7965 6172 Year after year │ │ │ │ │ -00026e40: 2c20 4175 746f 6d61 6b65 2068 6164 2064 , Automake had d │ │ │ │ │ -00026e50: 7269 6674 6564 2061 7761 7920 6672 6f6d rifted away from │ │ │ │ │ -00026e60: 2069 7473 2069 6e69 7469 616c 2064 6573 its initial des │ │ │ │ │ -00026e70: 6967 6e3a 0a20 2020 2020 636f 6e73 7472 ign:. constr │ │ │ │ │ -00026e80: 7563 7420 274d 616b 6566 696c 652e 696e uct 'Makefile.in │ │ │ │ │ -00026e90: 2720 6279 2061 7373 656d 626c 696e 6720 ' by assembling │ │ │ │ │ -00026ea0: 7661 7269 6f75 7320 274d 616b 6566 696c various 'Makefil │ │ │ │ │ -00026eb0: 6527 2066 7261 676d 656e 7473 2e0a 2020 e' fragments.. │ │ │ │ │ -00026ec0: 2020 2049 6e20 312e 342c 206c 6f74 7320 In 1.4, lots │ │ │ │ │ -00026ed0: 6f66 2027 4d61 6b65 6669 6c65 2720 7275 of 'Makefile' ru │ │ │ │ │ -00026ee0: 6c65 7320 6172 6520 6265 696e 6720 656d les are being em │ │ │ │ │ -00026ef0: 6974 7465 6420 6174 2076 6172 696f 7573 itted at various │ │ │ │ │ -00026f00: 0a20 2020 2020 706c 6163 6573 2069 6e20 . places in │ │ │ │ │ -00026f10: 7468 6520 2761 7574 6f6d 616b 6527 2073 the 'automake' s │ │ │ │ │ -00026f20: 6372 6970 7420 6974 7365 6c66 3b20 7468 cript itself; th │ │ │ │ │ -00026f30: 6973 2064 6f65 7320 6e6f 7420 6865 6c70 is does not help │ │ │ │ │ -00026f40: 2065 6e73 7572 696e 670a 2020 2020 2061 ensuring. a │ │ │ │ │ -00026f50: 2063 6f6e 7369 7374 656e 7420 7472 6561 consistent trea │ │ │ │ │ -00026f60: 746d 656e 7420 6f66 2074 6865 7365 2072 tment of these r │ │ │ │ │ -00026f70: 756c 6573 2028 666f 7220 696e 7374 616e ules (for instan │ │ │ │ │ -00026f80: 6365 206d 616b 696e 6720 7375 7265 0a20 ce making sure. │ │ │ │ │ -00026f90: 2020 2020 7468 6174 2075 7365 722d 6465 that user-de │ │ │ │ │ -00026fa0: 6669 6e65 6420 7275 6c65 7320 6f76 6572 fined rules over │ │ │ │ │ -00026fb0: 7269 6465 2041 7574 6f6d 616b 6527 7320 ride Automake's │ │ │ │ │ -00026fc0: 6f77 6e20 7275 6c65 7329 2e20 204f 6e65 own rules). One │ │ │ │ │ -00026fd0: 206f 660a 2020 2020 2041 6b69 6d27 7320 of. Akim's │ │ │ │ │ -00026fe0: 676f 616c 2077 6173 206d 6f76 696e 6720 goal was moving │ │ │ │ │ -00026ff0: 616c 6c20 7468 6573 6520 6861 7264 2d63 all these hard-c │ │ │ │ │ -00027000: 6f64 6564 2072 756c 6573 2074 6f20 7365 oded rules to se │ │ │ │ │ -00027010: 7061 7261 7465 0a20 2020 2020 274d 616b parate. 'Mak │ │ │ │ │ -00027020: 6566 696c 6527 2066 7261 676d 656e 7473 efile' fragments │ │ │ │ │ -00027030: 2c20 736f 2074 6865 206c 6f67 6963 2063 , so the logic c │ │ │ │ │ -00027040: 6f75 6c64 2062 6520 6365 6e74 7261 6c69 ould be centrali │ │ │ │ │ -00027050: 7a65 6420 696e 2061 0a20 2020 2020 274d zed in a. 'M │ │ │ │ │ -00027060: 616b 6566 696c 6527 2066 7261 676d 656e akefile' fragmen │ │ │ │ │ -00027070: 7420 7072 6f63 6573 736f 722e 0a0a 2020 t processor... │ │ │ │ │ -00027080: 2020 2041 6e6f 7468 6572 2073 6967 6e69 Another signi │ │ │ │ │ -00027090: 6669 6361 6e74 2063 6f6e 7472 6962 7574 ficant contribut │ │ │ │ │ -000270a0: 696f 6e20 6f66 2041 6b69 6d20 6973 2074 ion of Akim is t │ │ │ │ │ -000270b0: 6865 2069 6e74 6572 6661 6365 2077 6974 he interface wit │ │ │ │ │ -000270c0: 6820 7468 650a 2020 2020 2022 7472 6163 h the. "trac │ │ │ │ │ -000270d0: 6522 2066 6561 7475 7265 206f 6620 4175 e" feature of Au │ │ │ │ │ -000270e0: 746f 636f 6e66 2e20 2054 6865 2077 6179 toconf. The way │ │ │ │ │ -000270f0: 2074 6f20 7363 616e 2027 636f 6e66 6967 to scan 'config │ │ │ │ │ -00027100: 7572 652e 696e 2720 6174 0a20 2020 2020 ure.in' at. │ │ │ │ │ -00027110: 7468 6973 2074 696d 6520 7761 7320 746f this time was to │ │ │ │ │ -00027120: 2072 6561 6420 7468 6520 6669 6c65 2061 read the file a │ │ │ │ │ -00027130: 6e64 2067 7265 7020 7468 6520 7661 7269 nd grep the vari │ │ │ │ │ -00027140: 6f75 7320 6d61 6372 6f20 6f66 0a20 2020 ous macro of. │ │ │ │ │ -00027150: 2020 696e 7465 7265 7374 2074 6f20 4175 interest to Au │ │ │ │ │ -00027160: 746f 6d61 6b65 2e20 2044 6f69 6e67 2073 tomake. Doing s │ │ │ │ │ -00027170: 6f20 636f 756c 6420 6272 6561 6b20 696e o could break in │ │ │ │ │ -00027180: 206d 616e 7920 756e 6578 7065 6374 6564 many unexpected │ │ │ │ │ -00027190: 0a20 2020 2020 7761 7973 3b20 2761 7574 . ways; 'aut │ │ │ │ │ -000271a0: 6f6d 616b 6527 2063 6f75 6c64 206d 6973 omake' could mis │ │ │ │ │ -000271b0: 7320 736f 6d65 2064 6566 696e 6974 696f s some definitio │ │ │ │ │ -000271c0: 6e20 2866 6f72 2069 6e73 7461 6e63 650a n (for instance. │ │ │ │ │ -000271d0: 2020 2020 2027 4143 5f53 5542 5354 285b 'AC_SUBST([ │ │ │ │ │ -000271e0: 2431 5d2c 205b 2432 5d29 2720 7768 6572 $1], [$2])' wher │ │ │ │ │ -000271f0: 6520 7468 6520 6172 6775 6d65 6e74 7320 e the arguments │ │ │ │ │ -00027200: 6172 6520 6b6e 6f77 6e20 6f6e 6c79 2077 are known only w │ │ │ │ │ -00027210: 6865 6e20 4d34 0a20 2020 2020 6973 2072 hen M4. is r │ │ │ │ │ -00027220: 756e 292c 206f 7220 636f 6e76 6572 7365 un), or converse │ │ │ │ │ -00027230: 6c79 2069 7420 636f 756c 6420 6465 7465 ly it could dete │ │ │ │ │ -00027240: 6374 2073 6f6d 6520 6d61 6372 6f20 7468 ct some macro th │ │ │ │ │ -00027250: 6174 2077 6173 206e 6f74 0a20 2020 2020 at was not. │ │ │ │ │ -00027260: 6578 7061 6e64 6564 2028 6265 6361 7573 expanded (becaus │ │ │ │ │ -00027270: 6520 6974 2069 7320 6361 6c6c 6564 2063 e it is called c │ │ │ │ │ -00027280: 6f6e 6469 7469 6f6e 616c 6c79 292e 2020 onditionally). │ │ │ │ │ -00027290: 496e 2074 6865 2043 5653 2076 6572 7369 In the CVS versi │ │ │ │ │ -000272a0: 6f6e 0a20 2020 2020 6f66 2041 7574 6f63 on. of Autoc │ │ │ │ │ -000272b0: 6f6e 662c 2041 6b69 6d20 6861 6420 696d onf, Akim had im │ │ │ │ │ -000272c0: 706c 656d 656e 7465 6420 7468 6520 272d plemented the '- │ │ │ │ │ -000272d0: 2d74 7261 6365 2720 6f70 7469 6f6e 2c20 -trace' option, │ │ │ │ │ -000272e0: 7768 6963 680a 2020 2020 2070 726f 7669 which. provi │ │ │ │ │ -000272f0: 6465 7320 6163 6375 7261 7465 2069 6e66 des accurate inf │ │ │ │ │ -00027300: 6f72 6d61 7469 6f6e 2061 626f 7574 2077 ormation about w │ │ │ │ │ -00027310: 6865 7265 206d 6163 726f 7320 6172 6520 here macros are │ │ │ │ │ -00027320: 6163 7475 616c 6c79 0a20 2020 2020 6361 actually. ca │ │ │ │ │ -00027330: 6c6c 6564 2061 6e64 2077 6974 6820 7768 lled and with wh │ │ │ │ │ -00027340: 6174 2061 7267 756d 656e 7473 2e20 2041 at arguments. A │ │ │ │ │ -00027350: 6b69 6d20 7769 6c6c 2065 7175 6970 2041 kim will equip A │ │ │ │ │ -00027360: 7574 6f6d 616b 6520 7769 7468 2061 0a20 utomake with a. │ │ │ │ │ -00027370: 2020 2020 7365 636f 6e64 2027 636f 6e66 second 'conf │ │ │ │ │ -00027380: 6967 7572 652e 696e 2720 7363 616e 6e65 igure.in' scanne │ │ │ │ │ -00027390: 7220 7468 6174 2075 7365 7320 7468 6973 r that uses this │ │ │ │ │ -000273a0: 2027 2d2d 7472 6163 6527 2069 6e74 6572 '--trace' inter │ │ │ │ │ -000273b0: 6661 6365 2e0a 2020 2020 2053 696e 6365 face.. Since │ │ │ │ │ -000273c0: 2069 7420 7761 7320 6e6f 7420 7365 6e73 it was not sens │ │ │ │ │ -000273d0: 6962 6c65 2074 6f20 6472 6f70 2074 6865 ible to drop the │ │ │ │ │ -000273e0: 2041 7574 6f63 6f6e 6620 322e 3133 2063 Autoconf 2.13 c │ │ │ │ │ -000273f0: 6f6d 7061 7469 6269 6c69 7479 0a20 2020 ompatibility. │ │ │ │ │ -00027400: 2020 7965 742c 2074 6869 7320 6578 7065 yet, this expe │ │ │ │ │ -00027410: 7269 6d65 6e74 616c 2073 6361 6e6e 6572 rimental scanner │ │ │ │ │ -00027420: 2077 6173 206f 6e6c 7920 7573 6564 2077 was only used w │ │ │ │ │ -00027430: 6865 6e20 616e 2065 6e76 6972 6f6e 6d65 hen an environme │ │ │ │ │ -00027440: 6e74 0a20 2020 2020 7661 7269 6162 6c65 nt. variable │ │ │ │ │ -00027450: 2077 6173 2073 6574 2c20 7468 6520 7472 was set, the tr │ │ │ │ │ -00027460: 6164 6974 696f 6e61 6c20 6772 6570 2d73 aditional grep-s │ │ │ │ │ -00027470: 6361 6e6e 6572 2062 6569 6e67 2073 7469 canner being sti │ │ │ │ │ -00027480: 6c6c 2074 6865 0a20 2020 2020 6465 6661 ll the. defa │ │ │ │ │ -00027490: 756c 742e 0a0a 3230 3031 2d30 342d 3235 ult...2001-04-25 │ │ │ │ │ -000274a0: 2047 6172 7920 562e 2056 6175 6768 616e Gary V. Vaughan │ │ │ │ │ -000274b0: 2072 656c 6561 7365 7320 4c69 6274 6f6f releases Libtoo │ │ │ │ │ -000274c0: 6c20 312e 340a 0a20 2020 2020 4974 2068 l 1.4.. It h │ │ │ │ │ -000274d0: 6173 2062 6565 6e20 6d6f 7265 2074 6861 as been more tha │ │ │ │ │ -000274e0: 6e20 7477 6f20 7965 6172 7320 7369 6e63 n two years sinc │ │ │ │ │ -000274f0: 6520 4175 746f 6d61 6b65 2031 2e34 2c20 e Automake 1.4, │ │ │ │ │ -00027500: 4356 5320 4175 746f 6d61 6b65 0a20 2020 CVS Automake. │ │ │ │ │ -00027510: 2020 6861 7320 7375 6666 6572 6564 206c has suffered l │ │ │ │ │ -00027520: 6f74 2773 206f 6620 6865 6176 7920 6368 ot's of heavy ch │ │ │ │ │ -00027530: 616e 6765 7320 616e 6420 7374 696c 6c20 anges and still │ │ │ │ │ -00027540: 6973 206e 6f74 2072 6561 6479 2066 6f72 is not ready for │ │ │ │ │ -00027550: 0a20 2020 2020 7265 6c65 6173 652e 2020 . release. │ │ │ │ │ -00027560: 4c69 6274 6f6f 6c20 312e 3420 6861 6420 Libtool 1.4 had │ │ │ │ │ -00027570: 746f 2062 6520 6469 7374 7269 6275 7465 to be distribute │ │ │ │ │ -00027580: 6420 7769 7468 2061 2070 6174 6368 2061 d with a patch a │ │ │ │ │ -00027590: 6761 696e 7374 0a20 2020 2020 4175 746f gainst. Auto │ │ │ │ │ -000275a0: 6d61 6b65 2031 2e34 2e0a 0a32 3030 312d make 1.4...2001- │ │ │ │ │ -000275b0: 3035 2d30 3820 4175 746f 6d61 6b65 2031 05-08 Automake 1 │ │ │ │ │ -000275c0: 2e34 2d70 310a 3230 3031 2d30 352d 3234 .4-p1.2001-05-24 │ │ │ │ │ -000275d0: 2041 7574 6f6d 616b 6520 312e 342d 7032 Automake 1.4-p2 │ │ │ │ │ -000275e0: 0a0a 2020 2020 2047 6172 7920 562e 2056 .. Gary V. V │ │ │ │ │ -000275f0: 6175 6768 616e 2c20 7468 6520 7072 696e aughan, the prin │ │ │ │ │ -00027600: 6369 7061 6c20 4c69 6274 6f6f 6c20 6d61 cipal Libtool ma │ │ │ │ │ -00027610: 696e 7461 696e 6572 2c20 6d61 6b65 7320 intainer, makes │ │ │ │ │ -00027620: 6120 2270 6174 6368 0a20 2020 2020 7265 a "patch. re │ │ │ │ │ -00027630: 6c65 6173 6522 206f 6620 4175 746f 6d61 lease" of Automa │ │ │ │ │ -00027640: 6b65 3a0a 0a20 2020 2020 2020 2020 2054 ke:.. T │ │ │ │ │ -00027650: 6865 206d 6169 6e20 7075 7270 6f73 6520 he main purpose │ │ │ │ │ -00027660: 6f66 2074 6869 7320 7265 6c65 6173 6520 of this release │ │ │ │ │ -00027670: 6973 2074 6f20 6861 7665 2061 2073 7461 is to have a sta │ │ │ │ │ -00027680: 626c 6520 6175 746f 6d61 6b65 0a20 2020 ble automake. │ │ │ │ │ -00027690: 2020 2020 2020 2077 6869 6368 2069 7320 which is │ │ │ │ │ -000276a0: 636f 6d70 6174 6962 6c65 2077 6974 6820 compatible with │ │ │ │ │ -000276b0: 7468 6520 6c61 7465 7374 2073 7461 626c the latest stabl │ │ │ │ │ -000276c0: 6520 6c69 6274 6f6f 6c2e 0a0a 2020 2020 e libtool... │ │ │ │ │ -000276d0: 2054 6865 2072 656c 6561 7365 2061 6c73 The release als │ │ │ │ │ -000276e0: 6f20 636f 6e74 6169 6e73 206f 6276 696f o contains obvio │ │ │ │ │ -000276f0: 7573 2066 6978 6573 2066 6f72 2062 7567 us fixes for bug │ │ │ │ │ -00027700: 7320 696e 2041 7574 6f6d 616b 6520 312e s in Automake 1. │ │ │ │ │ -00027710: 342c 0a20 2020 2020 736f 6d65 206f 6620 4,. some of │ │ │ │ │ -00027720: 7768 6963 6820 7765 7265 2072 6570 6f72 which were repor │ │ │ │ │ -00027730: 7465 6420 616c 6d6f 7374 206d 6f6e 7468 ted almost month │ │ │ │ │ -00027740: 6c79 2e0a 0a32 3030 312d 3035 2d32 3120 ly...2001-05-21 │ │ │ │ │ -00027750: 416b 696d 2044 656d 6169 6c6c 6520 7265 Akim Demaille re │ │ │ │ │ -00027760: 6c65 6173 6573 2041 7574 6f63 6f6e 6620 leases Autoconf │ │ │ │ │ -00027770: 322e 3530 0a0a 3230 3031 2d30 362d 3037 2.50..2001-06-07 │ │ │ │ │ -00027780: 2041 7574 6f6d 616b 6520 312e 342d 7033 Automake 1.4-p3 │ │ │ │ │ -00027790: 0a32 3030 312d 3036 2d31 3020 4175 746f .2001-06-10 Auto │ │ │ │ │ -000277a0: 6d61 6b65 2031 2e34 2d70 340a 3230 3031 make 1.4-p4.2001 │ │ │ │ │ -000277b0: 2d30 372d 3135 2041 7574 6f6d 616b 6520 -07-15 Automake │ │ │ │ │ -000277c0: 312e 342d 7035 0a0a 2020 2020 2047 6172 1.4-p5.. Gar │ │ │ │ │ -000277d0: 7920 636f 6e74 696e 7565 7320 6869 7320 y continues his │ │ │ │ │ -000277e0: 7061 7463 682d 7265 6c65 6173 6520 7365 patch-release se │ │ │ │ │ -000277f0: 7269 6573 2e20 2054 6865 7365 2061 6c73 ries. These als │ │ │ │ │ -00027800: 6f20 6164 6420 7375 7070 6f72 740a 2020 o add support. │ │ │ │ │ -00027810: 2020 2066 6f72 2073 6f6d 6520 6e65 7720 for some new │ │ │ │ │ -00027820: 4175 746f 636f 6e66 2032 2e35 3020 6964 Autoconf 2.50 id │ │ │ │ │ -00027830: 696f 6d73 2e20 2045 7373 656e 7469 616c ioms. Essential │ │ │ │ │ -00027840: 6c79 2c20 4175 746f 636f 6e66 206e 6f77 ly, Autoconf now │ │ │ │ │ -00027850: 0a20 2020 2020 6164 766f 6361 7465 7320 . advocates │ │ │ │ │ -00027860: 2763 6f6e 6669 6775 7265 2e61 6327 206f 'configure.ac' o │ │ │ │ │ -00027870: 7665 7220 2763 6f6e 6669 6775 7265 2e69 ver 'configure.i │ │ │ │ │ -00027880: 6e27 2c20 616e 6420 6974 2069 6e74 726f n', and it intro │ │ │ │ │ -00027890: 6475 6365 7320 610a 2020 2020 206e 6577 duces a. new │ │ │ │ │ -000278a0: 2073 796e 7461 7820 666f 7220 2741 435f syntax for 'AC_ │ │ │ │ │ -000278b0: 4f55 5450 5554 2769 6e67 2066 696c 6573 OUTPUT'ing files │ │ │ │ │ -000278c0: 2e0a 0a32 3030 312d 3038 2d32 3320 4175 ...2001-08-23 Au │ │ │ │ │ -000278d0: 746f 6d61 6b65 2031 2e35 0a0a 2020 2020 tomake 1.5.. │ │ │ │ │ -000278e0: 2041 206d 616a 6f72 2061 6e64 206c 6f6e A major and lon │ │ │ │ │ -000278f0: 672d 6177 6169 7465 6420 7265 6c65 6173 g-awaited releas │ │ │ │ │ -00027900: 652c 2074 6861 7420 636f 6d65 7320 6d6f e, that comes mo │ │ │ │ │ -00027910: 7265 2074 6861 6e20 7477 6f20 7965 6172 re than two year │ │ │ │ │ -00027920: 730a 2020 2020 2061 6674 6572 2031 2e34 s. after 1.4 │ │ │ │ │ -00027930: 2e20 2049 7420 6272 696e 6773 206d 616e . It brings man │ │ │ │ │ -00027940: 7920 6368 616e 6765 732c 2061 6d6f 6e67 y changes, among │ │ │ │ │ -00027950: 2077 6869 6368 3a0a 2020 2020 2020 2020 which:. │ │ │ │ │ -00027960: 2a20 5468 6520 6e65 7720 6465 7065 6e64 * The new depend │ │ │ │ │ -00027970: 656e 6379 2074 7261 636b 696e 6720 7363 ency tracking sc │ │ │ │ │ -00027980: 6865 6d65 2074 6861 7420 7573 6573 2027 heme that uses ' │ │ │ │ │ -00027990: 6465 7063 6f6d 7027 2e20 2041 7369 6465 depcomp'. Aside │ │ │ │ │ -000279a0: 0a20 2020 2020 2020 2020 2066 726f 6d20 . from │ │ │ │ │ -000279b0: 7468 6520 696d 7072 6f76 656d 656e 7420 the improvement │ │ │ │ │ -000279c0: 6f6e 2074 6865 2064 6570 656e 6465 6e63 on the dependenc │ │ │ │ │ -000279d0: 7920 7472 6163 6b69 6e67 2069 7473 656c y tracking itsel │ │ │ │ │ -000279e0: 6620 282a 6e6f 7465 0a20 2020 2020 2020 f (*note. │ │ │ │ │ -000279f0: 2020 2044 6570 656e 6465 6e63 7920 5472 Dependency Tr │ │ │ │ │ -00027a00: 6163 6b69 6e67 2045 766f 6c75 7469 6f6e acking Evolution │ │ │ │ │ -00027a10: 3a3a 292c 2074 6869 7320 616c 736f 2073 ::), this also s │ │ │ │ │ -00027a20: 7472 6561 6d6c 696e 6573 2074 6865 0a20 treamlines the. │ │ │ │ │ -00027a30: 2020 2020 2020 2020 2075 7365 206f 6620 use of │ │ │ │ │ -00027a40: 2761 7574 6f6d 616b 6527 2d67 656e 6572 'automake'-gener │ │ │ │ │ -00027a50: 6174 6564 2027 4d61 6b65 6669 6c65 2e69 ated 'Makefile.i │ │ │ │ │ -00027a60: 6e27 7320 6173 2074 6865 0a20 2020 2020 n's as the. │ │ │ │ │ -00027a70: 2020 2020 2027 4d61 6b65 6669 6c65 2e69 'Makefile.i │ │ │ │ │ -00027a80: 6e27 7320 7573 6564 2064 7572 696e 6720 n's used during │ │ │ │ │ -00027a90: 6465 7665 6c6f 706d 656e 7420 6172 6520 development are │ │ │ │ │ -00027aa0: 6e6f 7720 7468 6520 7361 6d65 2061 730a now the same as. │ │ │ │ │ -00027ab0: 2020 2020 2020 2020 2020 7468 6f73 6520 those │ │ │ │ │ -00027ac0: 7573 6564 2069 6e20 6469 7374 7269 6275 used in distribu │ │ │ │ │ -00027ad0: 7469 6f6e 732e 2020 4265 666f 7265 2074 tions. Before t │ │ │ │ │ -00027ae0: 6861 7420 7468 6520 274d 616b 6566 696c hat the 'Makefil │ │ │ │ │ -00027af0: 652e 696e 2773 0a20 2020 2020 2020 2020 e.in's. │ │ │ │ │ -00027b00: 2067 656e 6572 6174 6564 2066 6f72 206d generated for m │ │ │ │ │ -00027b10: 6169 6e74 6169 6e65 7273 2072 6571 7569 aintainers requi │ │ │ │ │ -00027b20: 7265 6420 474e 5520 276d 616b 6527 2061 red GNU 'make' a │ │ │ │ │ -00027b30: 6e64 2047 4343 2c20 7468 6579 0a20 2020 nd GCC, they. │ │ │ │ │ -00027b40: 2020 2020 2020 2077 6572 6520 6469 6666 were diff │ │ │ │ │ -00027b50: 6572 656e 7420 6672 6f6d 2074 6865 2070 erent from the p │ │ │ │ │ -00027b60: 6f72 7461 626c 6520 274d 616b 6566 696c ortable 'Makefil │ │ │ │ │ -00027b70: 6527 2067 656e 6572 6174 6564 2066 6f72 e' generated for │ │ │ │ │ -00027b80: 0a20 2020 2020 2020 2020 2064 6973 7472 . distr │ │ │ │ │ -00027b90: 6962 7574 696f 6e3b 2074 6869 7320 7761 ibution; this wa │ │ │ │ │ -00027ba0: 7320 6361 7573 696e 6720 736f 6d65 2063 s causing some c │ │ │ │ │ -00027bb0: 6f6e 6675 7369 6f6e 2e0a 0a20 2020 2020 onfusion... │ │ │ │ │ -00027bc0: 2020 202a 2053 7570 706f 7274 2066 6f72 * Support for │ │ │ │ │ -00027bd0: 2070 6572 2d74 6172 6765 7420 636f 6d70 per-target comp │ │ │ │ │ -00027be0: 696c 6174 696f 6e20 666c 6167 732e 0a0a ilation flags... │ │ │ │ │ -00027bf0: 2020 2020 2020 2020 2a20 5375 7070 6f72 * Suppor │ │ │ │ │ -00027c00: 7420 666f 7220 7265 6665 7265 6e63 6520 t for reference │ │ │ │ │ -00027c10: 746f 2066 696c 6573 2069 6e20 7375 6264 to files in subd │ │ │ │ │ -00027c20: 6972 6563 746f 7269 6573 2069 6e20 6d6f irectories in mo │ │ │ │ │ -00027c30: 7374 0a20 2020 2020 2020 2020 2027 4d61 st. 'Ma │ │ │ │ │ -00027c40: 6b65 6669 6c65 2e61 6d27 2076 6172 6961 kefile.am' varia │ │ │ │ │ -00027c50: 626c 6573 2e0a 0a20 2020 2020 2020 202a bles... * │ │ │ │ │ -00027c60: 2049 6e74 726f 6475 6374 696f 6e20 6f66 Introduction of │ │ │ │ │ -00027c70: 2074 6865 2027 6469 7374 5f27 2c20 276e the 'dist_', 'n │ │ │ │ │ -00027c80: 6f64 6973 745f 272c 2061 6e64 2027 6e6f odist_', and 'no │ │ │ │ │ -00027c90: 6261 7365 5f27 0a20 2020 2020 2020 2020 base_'. │ │ │ │ │ -00027ca0: 2070 7265 6669 7865 732e 0a20 2020 2020 prefixes.. │ │ │ │ │ -00027cb0: 2020 202a 2050 6572 6c20 3420 7375 7070 * Perl 4 supp │ │ │ │ │ -00027cc0: 6f72 7420 6973 2066 696e 616c 6c79 2064 ort is finally d │ │ │ │ │ -00027cd0: 726f 7070 6564 2e0a 0a20 2020 2020 312e ropped... 1. │ │ │ │ │ -00027ce0: 3520 6469 6420 6272 6561 6b20 7365 7665 5 did break seve │ │ │ │ │ -00027cf0: 7261 6c20 7061 636b 6167 6573 2074 6861 ral packages tha │ │ │ │ │ -00027d00: 7420 776f 726b 6564 2077 6974 6820 312e t worked with 1. │ │ │ │ │ -00027d10: 342e 2020 456e 6f75 6768 2073 6f0a 2020 4. Enough so. │ │ │ │ │ -00027d20: 2020 2074 6861 7420 4c69 6e75 7820 6469 that Linux di │ │ │ │ │ -00027d30: 7374 7269 6275 7469 6f6e 7320 636f 756c stributions coul │ │ │ │ │ -00027d40: 6420 6e6f 7420 6561 7369 6c79 2069 6e73 d not easily ins │ │ │ │ │ -00027d50: 7461 6c6c 2074 6865 206e 6577 2041 7574 tall the new Aut │ │ │ │ │ -00027d60: 6f6d 616b 650a 2020 2020 2076 6572 7369 omake. versi │ │ │ │ │ -00027d70: 6f6e 2077 6974 686f 7574 2062 7265 616b on without break │ │ │ │ │ -00027d80: 696e 6720 6d61 6e79 206f 6620 7468 6520 ing many of the │ │ │ │ │ -00027d90: 7061 636b 6167 6573 2066 6f72 2077 6869 packages for whi │ │ │ │ │ -00027da0: 6368 2074 6865 7920 6861 6420 746f 0a20 ch they had to. │ │ │ │ │ -00027db0: 2020 2020 7275 6e20 2761 7574 6f6d 616b run 'automak │ │ │ │ │ -00027dc0: 6527 2e0a 0a20 2020 2020 536f 6d65 206f e'... Some o │ │ │ │ │ -00027dd0: 6620 7468 6573 6520 6272 6561 6b61 6765 f these breakage │ │ │ │ │ -00027de0: 7320 7765 7265 2065 6666 6563 7469 7665 s were effective │ │ │ │ │ -00027df0: 6c79 2062 7567 7320 7468 6174 2077 6f75 ly bugs that wou │ │ │ │ │ -00027e00: 6c64 2065 7665 6e74 7561 6c6c 790a 2020 ld eventually. │ │ │ │ │ -00027e10: 2020 2062 6520 6669 7865 6420 696e 2074 be fixed in t │ │ │ │ │ -00027e20: 6865 206e 6578 7420 7265 6c65 6173 652e he next release. │ │ │ │ │ -00027e30: 2020 486f 7765 7665 722c 2061 206c 6f74 However, a lot │ │ │ │ │ -00027e40: 206f 6620 6461 6d61 6765 2077 6173 2063 of damage was c │ │ │ │ │ -00027e50: 6175 7365 640a 2020 2020 2062 7920 736f aused. by so │ │ │ │ │ -00027e60: 6d65 2063 6861 6e67 6573 206d 6164 6520 me changes made │ │ │ │ │ -00027e70: 6465 6c69 6265 7261 7465 6c79 2074 6f20 deliberately to │ │ │ │ │ -00027e80: 7265 6e64 6572 2041 7574 6f6d 616b 6520 render Automake │ │ │ │ │ -00027e90: 7374 7269 6374 6572 206f 6e0a 2020 2020 stricter on. │ │ │ │ │ -00027ea0: 2073 6f6d 6520 7365 7475 7020 7765 2064 some setup we d │ │ │ │ │ -00027eb0: 6964 2063 6f6e 7369 6465 7220 626f 6775 id consider bogu │ │ │ │ │ -00027ec0: 732e 2020 466f 7220 696e 7374 616e 6365 s. For instance │ │ │ │ │ -00027ed0: 2c20 276d 616b 6520 6469 7374 6368 6563 , 'make distchec │ │ │ │ │ -00027ee0: 6b27 0a20 2020 2020 7761 7320 696d 7072 k'. was impr │ │ │ │ │ -00027ef0: 6f76 6564 2074 6f20 6368 6563 6b20 7468 oved to check th │ │ │ │ │ -00027f00: 6174 2027 6d61 6b65 2075 6e69 6e73 7461 at 'make uninsta │ │ │ │ │ -00027f10: 6c6c 2720 6469 6420 7265 6d6f 7665 2061 ll' did remove a │ │ │ │ │ -00027f20: 6c6c 2074 6865 0a20 2020 2020 6669 6c65 ll the. file │ │ │ │ │ -00027f30: 7320 276d 616b 6520 696e 7374 616c 6c27 s 'make install' │ │ │ │ │ -00027f40: 2069 6e73 7461 6c6c 6564 2c20 7468 6174 installed, that │ │ │ │ │ -00027f50: 2027 6d61 6b65 2064 6973 7463 6c65 616e 'make distclean │ │ │ │ │ -00027f60: 2720 6469 6420 6e6f 7420 6f6d 6974 0a20 ' did not omit. │ │ │ │ │ -00027f70: 2020 2020 736f 6d65 2066 696c 652c 2061 some file, a │ │ │ │ │ -00027f80: 6e64 2074 6861 7420 6120 5650 4154 4820 nd that a VPATH │ │ │ │ │ -00027f90: 6275 696c 6420 776f 756c 6420 776f 726b build would work │ │ │ │ │ -00027fa0: 2065 7665 6e20 6966 2074 6865 2073 6f75 even if the sou │ │ │ │ │ -00027fb0: 7263 650a 2020 2020 2064 6972 6563 746f rce. directo │ │ │ │ │ -00027fc0: 7279 2077 6173 2072 6561 642d 6f6e 6c79 ry was read-only │ │ │ │ │ -00027fd0: 2e20 2053 696d 696c 6172 6c79 2c20 4175 . Similarly, Au │ │ │ │ │ -00027fe0: 746f 6d61 6b65 206e 6f77 2072 656a 6563 tomake now rejec │ │ │ │ │ -00027ff0: 7473 206d 756c 7469 706c 650a 2020 2020 ts multiple. │ │ │ │ │ -00028000: 2064 6566 696e 6974 696f 6e73 206f 6620 definitions of │ │ │ │ │ -00028010: 7468 6520 7361 6d65 2076 6172 6961 626c the same variabl │ │ │ │ │ -00028020: 6520 2862 6563 6175 7365 2074 6861 7420 e (because that │ │ │ │ │ -00028030: 776f 756c 6420 6d69 7820 7665 7279 2062 would mix very b │ │ │ │ │ -00028040: 6164 6c79 0a20 2020 2020 7769 7468 2063 adly. with c │ │ │ │ │ -00028050: 6f6e 6469 7469 6f6e 616c 7329 2c20 616e onditionals), an │ │ │ │ │ -00028060: 6420 272b 3d27 2061 7373 6967 6e6d 656e d '+=' assignmen │ │ │ │ │ -00028070: 7473 2077 6974 6820 6e6f 2070 7265 7669 ts with no previ │ │ │ │ │ -00028080: 6f75 730a 2020 2020 2064 6566 696e 6974 ous. definit │ │ │ │ │ -00028090: 696f 6e2e 2020 4265 6361 7573 6520 7468 ion. Because th │ │ │ │ │ -000280a0: 6573 6520 6368 616e 6765 7320 616c 6c20 ese changes all │ │ │ │ │ -000280b0: 6f63 6375 7272 6564 2073 7564 6465 6e6c occurred suddenl │ │ │ │ │ -000280c0: 7920 6166 7465 7220 312e 340a 2020 2020 y after 1.4. │ │ │ │ │ -000280d0: 2068 6164 2062 6565 6e20 6573 7461 626c had been establ │ │ │ │ │ -000280e0: 6973 6865 6420 666f 7220 6d6f 7265 2074 ished for more t │ │ │ │ │ -000280f0: 6861 6e20 7477 6f20 7965 6172 732c 2069 han two years, i │ │ │ │ │ -00028100: 7420 6875 7274 2075 7365 7273 2e0a 0a20 t hurt users... │ │ │ │ │ -00028110: 2020 2020 546f 206d 616b 6520 6d61 7474 To make matt │ │ │ │ │ -00028120: 6572 2077 6f72 7365 2c20 6d65 616e 7768 er worse, meanwh │ │ │ │ │ -00028130: 696c 6520 4175 746f 636f 6e66 2028 6e6f ile Autoconf (no │ │ │ │ │ -00028140: 7720 6174 2076 6572 7369 6f6e 2032 2e35 w at version 2.5 │ │ │ │ │ -00028150: 3229 2077 6173 0a20 2020 2020 6661 6369 2) was. faci │ │ │ │ │ -00028160: 6e67 2073 696d 696c 6172 2074 726f 7562 ng similar troub │ │ │ │ │ -00028170: 6c65 732c 2066 6f72 2073 696d 696c 6172 les, for similar │ │ │ │ │ -00028180: 2072 6561 736f 6e73 2e0a 0a32 3030 322d reasons...2002- │ │ │ │ │ -00028190: 3033 2d30 3520 4175 746f 6d61 6b65 2031 03-05 Automake 1 │ │ │ │ │ -000281a0: 2e36 0a0a 2020 2020 2054 6869 7320 7265 .6.. This re │ │ │ │ │ -000281b0: 6c65 6173 6520 696e 7472 6f64 7563 6564 lease introduced │ │ │ │ │ -000281c0: 2076 6572 7369 6f6e 6564 2069 6e73 7461 versioned insta │ │ │ │ │ -000281d0: 6c6c 6174 696f 6e20 282a 6e6f 7465 2041 llation (*note A │ │ │ │ │ -000281e0: 5049 0a20 2020 2020 5665 7273 696f 6e69 PI. Versioni │ │ │ │ │ -000281f0: 6e67 3a3a 292e 2020 5468 6973 2077 6173 ng::). This was │ │ │ │ │ -00028200: 206d 6169 6e6c 7920 7075 7368 6564 2062 mainly pushed b │ │ │ │ │ -00028210: 7920 4861 766f 6320 5065 6e6e 696e 6774 y Havoc Penningt │ │ │ │ │ -00028220: 6f6e 2c20 7461 6b69 6e67 0a20 2020 2020 on, taking. │ │ │ │ │ -00028230: 7468 6520 474e 4f4d 4520 736f 7572 6365 the GNOME source │ │ │ │ │ -00028240: 2074 7265 6520 6173 206d 6f74 6976 653a tree as motive: │ │ │ │ │ -00028250: 2064 7565 2074 6f20 696e 636f 6d70 6174 due to incompat │ │ │ │ │ -00028260: 6962 696c 6974 6965 7320 6265 7477 6565 ibilities betwee │ │ │ │ │ -00028270: 6e0a 2020 2020 2074 6865 2061 7574 6f74 n. the autot │ │ │ │ │ -00028280: 6f6f 6c73 2069 7427 7320 696d 706f 7373 ools it's imposs │ │ │ │ │ -00028290: 6962 6c65 2066 6f72 2074 6865 2047 4e4f ible for the GNO │ │ │ │ │ -000282a0: 4d45 2070 6163 6b61 6765 7320 746f 2073 ME packages to s │ │ │ │ │ -000282b0: 7769 7463 6820 746f 0a20 2020 2020 4175 witch to. Au │ │ │ │ │ -000282c0: 746f 636f 6e66 2032 2e35 3320 616e 6420 toconf 2.53 and │ │ │ │ │ -000282d0: 4175 746f 6d61 6b65 2031 2e35 2061 6c6c Automake 1.5 all │ │ │ │ │ -000282e0: 2061 7420 6f6e 6365 2c20 736f 2074 6865 at once, so the │ │ │ │ │ -000282f0: 7920 6172 6520 6375 7272 656e 746c 790a y are currently. │ │ │ │ │ -00028300: 2020 2020 2073 7475 636b 2077 6974 6820 stuck with │ │ │ │ │ -00028310: 4175 746f 636f 6e66 2032 2e31 3320 616e Autoconf 2.13 an │ │ │ │ │ -00028320: 6420 4175 746f 6d61 6b65 2031 2e34 2e0a d Automake 1.4.. │ │ │ │ │ -00028330: 0a20 2020 2020 5468 6520 6964 6561 2077 . The idea w │ │ │ │ │ -00028340: 6173 2074 6f20 6361 6c6c 2074 6869 7320 as to call this │ │ │ │ │ -00028350: 7665 7273 696f 6e20 2761 7574 6f6d 616b version 'automak │ │ │ │ │ -00028360: 652d 312e 3627 2c20 6361 6c6c 2061 6c6c e-1.6', call all │ │ │ │ │ -00028370: 2069 7473 0a20 2020 2020 6275 672d 6669 its. bug-fi │ │ │ │ │ -00028380: 7820 7665 7273 696f 6e73 2069 6465 6e74 x versions ident │ │ │ │ │ -00028390: 6963 616c 6c79 2c20 616e 6420 7377 6974 ically, and swit │ │ │ │ │ -000283a0: 6368 2074 6f20 2761 7574 6f6d 616b 652d ch to 'automake- │ │ │ │ │ -000283b0: 312e 3727 2066 6f72 2074 6865 0a20 2020 1.7' for the. │ │ │ │ │ -000283c0: 2020 6e65 7874 2072 656c 6561 7365 2074 next release t │ │ │ │ │ -000283d0: 6861 7420 6164 6473 206e 6577 2066 6561 hat adds new fea │ │ │ │ │ -000283e0: 7475 7265 7320 6f72 2063 6861 6e67 6573 tures or changes │ │ │ │ │ -000283f0: 2073 6f6d 6520 7275 6c65 732e 2020 5468 some rules. Th │ │ │ │ │ -00028400: 6973 0a20 2020 2020 7363 6865 6d65 2069 is. scheme i │ │ │ │ │ -00028410: 6d70 6c69 6573 206d 6169 6e74 6169 6e69 mplies maintaini │ │ │ │ │ -00028420: 6e67 2061 2062 7567 2d66 6978 2062 7261 ng a bug-fix bra │ │ │ │ │ -00028430: 6e63 6820 696e 2061 6464 6974 696f 6e20 nch in addition │ │ │ │ │ -00028440: 746f 2074 6865 0a20 2020 2020 6465 7665 to the. deve │ │ │ │ │ -00028450: 6c6f 706d 656e 7420 7472 756e 6b2c 2077 lopment trunk, w │ │ │ │ │ -00028460: 6869 6368 206d 6561 6e73 206d 6f72 6520 hich means more │ │ │ │ │ -00028470: 776f 726b 2066 726f 6d20 7468 6520 6d61 work from the ma │ │ │ │ │ -00028480: 696e 7461 696e 6572 2c20 6275 740a 2020 intainer, but. │ │ │ │ │ -00028490: 2020 2070 726f 7669 6469 6e67 2072 6567 providing reg │ │ │ │ │ -000284a0: 756c 6172 2062 7567 2d66 6978 2072 656c ular bug-fix rel │ │ │ │ │ -000284b0: 6561 7365 7320 7072 6f76 6564 2074 6f20 eases proved to │ │ │ │ │ -000284c0: 6265 2072 6561 6c6c 7920 776f 7274 6877 be really worthw │ │ │ │ │ -000284d0: 6869 6c65 2e0a 0a20 2020 2020 4c69 6b65 hile... Like │ │ │ │ │ -000284e0: 2031 2e35 2c20 312e 3620 616c 736f 2069 1.5, 1.6 also i │ │ │ │ │ -000284f0: 6e74 726f 6475 6365 6420 6120 6275 6e63 ntroduced a bunc │ │ │ │ │ -00028500: 6820 6f66 2069 6e63 6f6d 7061 7469 6269 h of incompatibi │ │ │ │ │ -00028510: 6c69 7469 6573 2c0a 2020 2020 2069 6e74 lities,. int │ │ │ │ │ -00028520: 656e 7469 6f6e 616c 206f 7220 6e6f 742e entional or not. │ │ │ │ │ -00028530: 2020 5065 7268 6170 7320 7468 6520 6d6f Perhaps the mo │ │ │ │ │ -00028540: 7265 2061 6e6e 6f79 696e 6720 7761 7320 re annoying was │ │ │ │ │ -00028550: 7468 6520 6465 7065 6e64 656e 6365 0a20 the dependence. │ │ │ │ │ -00028560: 2020 2020 6f6e 2074 6865 206e 6577 6c79 on the newly │ │ │ │ │ -00028570: 2072 656c 6561 7365 6420 4175 746f 636f released Autoco │ │ │ │ │ -00028580: 6e66 2032 2e35 332e 2020 4175 746f 636f nf 2.53. Autoco │ │ │ │ │ -00028590: 6e66 2073 6565 6d65 6420 746f 2068 6176 nf seemed to hav │ │ │ │ │ -000285a0: 650a 2020 2020 2073 7461 6269 6c69 7a65 e. stabilize │ │ │ │ │ -000285b0: 6420 656e 6f75 6768 2073 696e 6365 2069 d enough since i │ │ │ │ │ -000285c0: 7473 2065 7870 6c6f 7369 7665 2032 2e35 ts explosive 2.5 │ │ │ │ │ -000285d0: 3020 7265 6c65 6173 6520 616e 6420 696e 0 release and in │ │ │ │ │ -000285e0: 636c 7564 6564 0a20 2020 2020 6368 616e cluded. chan │ │ │ │ │ -000285f0: 6765 7320 7265 7175 6972 6564 2074 6f20 ges required to │ │ │ │ │ -00028600: 6669 7820 736f 6d65 2062 7567 7320 696e fix some bugs in │ │ │ │ │ -00028610: 2041 7574 6f6d 616b 652e 2020 496e 206f Automake. In o │ │ │ │ │ -00028620: 7264 6572 2074 6f20 7570 6772 6164 650a rder to upgrade. │ │ │ │ │ -00028630: 2020 2020 2074 6f20 4175 746f 6d61 6b65 to Automake │ │ │ │ │ -00028640: 2031 2e36 2c20 7065 6f70 6c65 206e 6f77 1.6, people now │ │ │ │ │ -00028650: 2068 6164 2074 6f20 7570 6772 6164 6520 had to upgrade │ │ │ │ │ -00028660: 4175 746f 636f 6e66 2074 6f6f 3b20 666f Autoconf too; fo │ │ │ │ │ -00028670: 7220 736f 6d65 0a20 2020 2020 7061 636b r some. pack │ │ │ │ │ -00028680: 6167 6573 2069 7420 7761 7320 6e6f 2070 ages it was no p │ │ │ │ │ -00028690: 6963 6e69 632e 0a0a 2020 2020 2057 6869 icnic... Whi │ │ │ │ │ -000286a0: 6c65 2076 6572 7369 6f6e 6564 2069 6e73 le versioned ins │ │ │ │ │ -000286b0: 7461 6c6c 6174 696f 6e20 6865 6c70 6564 tallation helped │ │ │ │ │ -000286c0: 2070 656f 706c 6520 746f 2075 7067 7261 people to upgra │ │ │ │ │ -000286d0: 6465 2c20 6974 2061 6c73 6f0a 2020 2020 de, it also. │ │ │ │ │ -000286e0: 2075 6e66 6f72 7475 6e61 7465 6c79 2061 unfortunately a │ │ │ │ │ -000286f0: 6c6c 6f77 6564 2070 656f 706c 6520 6e6f llowed people no │ │ │ │ │ -00028700: 7420 746f 2075 7067 7261 6465 2e20 2041 t to upgrade. A │ │ │ │ │ -00028710: 7420 7468 6520 7469 6d65 206f 660a 2020 t the time of. │ │ │ │ │ -00028720: 2020 2077 7269 7469 6e67 2c20 736f 6d65 writing, some │ │ │ │ │ -00028730: 204c 696e 7578 2064 6973 7472 6962 7574 Linux distribut │ │ │ │ │ -00028740: 696f 6e73 2061 7265 2073 6869 7070 696e ions are shippin │ │ │ │ │ -00028750: 6720 7061 636b 6167 6573 2066 6f72 0a20 g packages for. │ │ │ │ │ -00028760: 2020 2020 4175 746f 6d61 6b65 2031 2e34 Automake 1.4 │ │ │ │ │ -00028770: 2c20 312e 352c 2031 2e36 2c20 312e 372c , 1.5, 1.6, 1.7, │ │ │ │ │ -00028780: 2031 2e38 2c20 616e 6420 312e 392e 2020 1.8, and 1.9. │ │ │ │ │ -00028790: 4d6f 7374 206f 6620 7468 6573 6520 7374 Most of these st │ │ │ │ │ -000287a0: 696c 6c0a 2020 2020 2069 6e73 7461 6c6c ill. install │ │ │ │ │ -000287b0: 2031 2e34 2062 7920 6465 6661 756c 742e 1.4 by default. │ │ │ │ │ -000287c0: 2020 536f 6d65 2064 6973 7472 6962 7574 Some distribut │ │ │ │ │ -000287d0: 696f 6e20 616c 736f 2063 616c 6c20 312e ion also call 1. │ │ │ │ │ -000287e0: 3420 7468 650a 2020 2020 2022 7374 6162 4 the. "stab │ │ │ │ │ -000287f0: 6c65 2220 7665 7273 696f 6e2c 2061 6e64 le" version, and │ │ │ │ │ -00028800: 2070 7265 7365 6e74 2022 312e 3922 2061 present "1.9" a │ │ │ │ │ -00028810: 7320 7468 6520 6465 7665 6c6f 706d 656e s the developmen │ │ │ │ │ -00028820: 7420 7665 7273 696f 6e3b 0a20 2020 2020 t version;. │ │ │ │ │ -00028830: 7468 6973 2064 6f65 7320 6e6f 7420 7265 this does not re │ │ │ │ │ -00028840: 616c 6c79 206d 616b 6573 2073 656e 7365 ally makes sense │ │ │ │ │ -00028850: 2073 696e 6365 2031 2e39 2069 7320 7761 since 1.9 is wa │ │ │ │ │ -00028860: 7920 6d6f 7265 2073 6f6c 6964 2074 6861 y more solid tha │ │ │ │ │ -00028870: 6e0a 2020 2020 2031 2e34 2e20 2041 6c6c n. 1.4. All │ │ │ │ │ -00028880: 2074 6869 7320 646f 6573 206e 6f74 2068 this does not h │ │ │ │ │ -00028890: 656c 7020 7468 6520 6e65 7763 6f6d 6572 elp the newcomer │ │ │ │ │ -000288a0: 2e0a 0a32 3030 322d 3034 2d31 3120 4175 ...2002-04-11 Au │ │ │ │ │ -000288b0: 746f 6d61 6b65 2031 2e36 2e31 0a0a 2020 tomake 1.6.1.. │ │ │ │ │ -000288c0: 2020 2031 2e36 2c20 616e 6420 7468 6520 1.6, and the │ │ │ │ │ -000288d0: 7570 636f 6d69 6e67 2031 2e34 2d70 3620 upcoming 1.4-p6 │ │ │ │ │ -000288e0: 7265 6c65 6173 6520 7765 7265 2074 6865 release were the │ │ │ │ │ -000288f0: 206c 6173 7420 7265 6c65 6173 6520 6279 last release by │ │ │ │ │ -00028900: 2054 6f6d 2e0a 2020 2020 2054 6869 7320 Tom.. This │ │ │ │ │ -00028910: 6f6e 6520 616e 6420 7468 6f73 6520 666f one and those fo │ │ │ │ │ -00028920: 6c6c 6f77 696e 6720 7769 6c6c 2062 6520 llowing will be │ │ │ │ │ -00028930: 6861 6e64 6c65 6420 6279 2041 6c65 7861 handled by Alexa │ │ │ │ │ -00028940: 6e64 7265 0a20 2020 2020 4475 7265 742d ndre. Duret- │ │ │ │ │ -00028950: 4c75 747a 2e20 2054 6f6d 2069 7320 7374 Lutz. Tom is st │ │ │ │ │ -00028960: 696c 6c20 6172 6f75 6e64 2c20 616e 6420 ill around, and │ │ │ │ │ -00028970: 7769 6c6c 2062 6520 7468 6572 6520 756e will be there un │ │ │ │ │ -00028980: 7469 6c20 6162 6f75 740a 2020 2020 2031 til about. 1 │ │ │ │ │ -00028990: 2e37 2c20 6275 7420 6869 7320 696e 7465 .7, but his inte │ │ │ │ │ -000289a0: 7265 7374 2069 6e74 6f20 4175 746f 6d61 rest into Automa │ │ │ │ │ -000289b0: 6b65 2069 7320 6472 6966 7469 6e67 2061 ke is drifting a │ │ │ │ │ -000289c0: 7761 7920 746f 7761 7264 730a 2020 2020 way towards. │ │ │ │ │ -000289d0: 2070 726f 6a65 6374 7320 6c69 6b65 2027 projects like ' │ │ │ │ │ -000289e0: 6763 6a27 2e0a 0a20 2020 2020 416c 6578 gcj'... Alex │ │ │ │ │ -000289f0: 616e 6472 6520 6861 7320 6265 656e 2075 andre has been u │ │ │ │ │ -00028a00: 7369 6e67 2041 7574 6f6d 616b 6520 7369 sing Automake si │ │ │ │ │ -00028a10: 6e63 6520 3230 3030 2c20 616e 6420 7374 nce 2000, and st │ │ │ │ │ -00028a20: 6172 7465 6420 746f 0a20 2020 2020 636f arted to. co │ │ │ │ │ -00028a30: 6e74 7269 6275 7465 206d 6f73 746c 7920 ntribute mostly │ │ │ │ │ -00028a40: 6f6e 2041 6b69 6d27 7320 696e 6369 7465 on Akim's incite │ │ │ │ │ -00028a50: 6d65 6e74 2028 416b 696d 2061 6e64 2041 ment (Akim and A │ │ │ │ │ -00028a60: 6c65 7861 6e64 7265 2068 6176 650a 2020 lexandre have. │ │ │ │ │ -00028a70: 2020 2062 6565 6e20 776f 726b 696e 6720 been working │ │ │ │ │ -00028a80: 696e 2074 6865 2073 616d 6520 726f 6f6d in the same room │ │ │ │ │ -00028a90: 2066 726f 6d20 3139 3939 2074 6f20 3230 from 1999 to 20 │ │ │ │ │ -00028aa0: 3032 292e 2020 496e 2032 3030 3120 616e 02). In 2001 an │ │ │ │ │ -00028ab0: 6420 3230 3032 0a20 2020 2020 6865 2068 d 2002. he h │ │ │ │ │ -00028ac0: 6164 2061 206c 6f74 206f 6620 6672 6565 ad a lot of free │ │ │ │ │ -00028ad0: 2074 696d 6520 746f 2065 6e6a 6f79 2068 time to enjoy h │ │ │ │ │ -00028ae0: 6163 6b69 6e67 2041 7574 6f6d 616b 652e acking Automake. │ │ │ │ │ -00028af0: 0a0a 3230 3032 2d30 362d 3134 2041 7574 ..2002-06-14 Aut │ │ │ │ │ -00028b00: 6f6d 616b 6520 312e 362e 320a 0a32 3030 omake 1.6.2..200 │ │ │ │ │ -00028b10: 322d 3037 2d32 3820 4175 746f 6d61 6b65 2-07-28 Automake │ │ │ │ │ -00028b20: 2031 2e36 2e33 0a32 3030 322d 3037 2d32 1.6.3.2002-07-2 │ │ │ │ │ -00028b30: 3820 4175 746f 6d61 6b65 2031 2e34 2d70 8 Automake 1.4-p │ │ │ │ │ -00028b40: 360a 0a20 2020 2020 5477 6f20 7265 6c65 6.. Two rele │ │ │ │ │ -00028b50: 6173 6573 206f 6e20 7468 6520 7361 6d65 ases on the same │ │ │ │ │ -00028b60: 2064 6179 2e20 2031 2e36 2e33 2069 7320 day. 1.6.3 is │ │ │ │ │ -00028b70: 6120 6275 672d 6669 7820 7265 6c65 6173 a bug-fix releas │ │ │ │ │ -00028b80: 652e 0a0a 2020 2020 2054 6f6d 2054 726f e... Tom Tro │ │ │ │ │ -00028b90: 6d65 7920 6261 636b 706f 7274 6564 2074 mey backported t │ │ │ │ │ -00028ba0: 6865 2076 6572 7369 6f6e 6564 2069 6e73 he versioned ins │ │ │ │ │ -00028bb0: 7461 6c6c 6174 696f 6e20 6d65 6368 616e tallation mechan │ │ │ │ │ -00028bc0: 6973 6d20 6f6e 2074 6865 0a20 2020 2020 ism on the. │ │ │ │ │ -00028bd0: 312e 3420 6272 616e 6368 2c20 736f 2074 1.4 branch, so t │ │ │ │ │ -00028be0: 6861 7420 4175 746f 6d61 6b65 2031 2e36 hat Automake 1.6 │ │ │ │ │ -00028bf0: 2e78 2061 6e64 2041 7574 6f6d 616b 6520 .x and Automake │ │ │ │ │ -00028c00: 312e 342d 7036 2063 6f75 6c64 2062 650a 1.4-p6 could be. │ │ │ │ │ -00028c10: 2020 2020 2069 6e73 7461 6c6c 6564 2073 installed s │ │ │ │ │ -00028c20: 6964 6520 6279 2073 6964 652e 2020 416e ide by side. An │ │ │ │ │ -00028c30: 6f74 6865 7220 7265 7175 6573 7420 6672 other request fr │ │ │ │ │ -00028c40: 6f6d 2074 6865 2047 4e4f 4d45 2066 6f6c om the GNOME fol │ │ │ │ │ -00028c50: 6b73 2e0a 0a32 3030 322d 3039 2d32 3520 ks...2002-09-25 │ │ │ │ │ -00028c60: 4175 746f 6d61 6b65 2031 2e37 0a0a 2020 Automake 1.7.. │ │ │ │ │ -00028c70: 2020 2054 6869 7320 7265 6c65 6173 6520 This release │ │ │ │ │ -00028c80: 7377 6974 6368 6573 2074 6f20 7468 6520 switches to the │ │ │ │ │ -00028c90: 6e65 7720 2763 6f6e 6669 6775 7265 2e61 new 'configure.a │ │ │ │ │ -00028ca0: 6327 2073 6361 6e6e 6572 2041 6b69 6d20 c' scanner Akim │ │ │ │ │ -00028cb0: 7761 730a 2020 2020 2065 7870 6572 696d was. experim │ │ │ │ │ -00028cc0: 656e 7469 6e67 2069 6e20 312e 352e 0a0a enting in 1.5... │ │ │ │ │ -00028cd0: 3230 3032 2d31 302d 3136 2041 7574 6f6d 2002-10-16 Autom │ │ │ │ │ -00028ce0: 616b 6520 312e 372e 310a 3230 3032 2d31 ake 1.7.1.2002-1 │ │ │ │ │ -00028cf0: 322d 3036 2041 7574 6f6d 616b 6520 312e 2-06 Automake 1. │ │ │ │ │ -00028d00: 372e 320a 3230 3033 2d30 322d 3230 2041 7.2.2003-02-20 A │ │ │ │ │ -00028d10: 7574 6f6d 616b 6520 312e 372e 330a 3230 utomake 1.7.3.20 │ │ │ │ │ -00028d20: 3033 2d30 342d 3233 2041 7574 6f6d 616b 03-04-23 Automak │ │ │ │ │ -00028d30: 6520 312e 372e 340a 3230 3033 2d30 352d e 1.7.4.2003-05- │ │ │ │ │ -00028d40: 3138 2041 7574 6f6d 616b 6520 312e 372e 18 Automake 1.7. │ │ │ │ │ -00028d50: 350a 3230 3033 2d30 372d 3130 2041 7574 5.2003-07-10 Aut │ │ │ │ │ -00028d60: 6f6d 616b 6520 312e 372e 360a 3230 3033 omake 1.7.6.2003 │ │ │ │ │ -00028d70: 2d30 392d 3037 2041 7574 6f6d 616b 6520 -09-07 Automake │ │ │ │ │ -00028d80: 312e 372e 370a 3230 3033 2d31 302d 3037 1.7.7.2003-10-07 │ │ │ │ │ -00028d90: 2041 7574 6f6d 616b 6520 312e 372e 380a Automake 1.7.8. │ │ │ │ │ -00028da0: 0a20 2020 2020 4d61 6e79 2062 7567 2d66 . Many bug-f │ │ │ │ │ -00028db0: 6978 2072 656c 6561 7365 732e 2020 312e ix releases. 1. │ │ │ │ │ -00028dc0: 3720 6c61 7374 6564 2062 6563 6175 7365 7 lasted because │ │ │ │ │ -00028dd0: 2074 6865 2064 6576 656c 6f70 6d65 6e74 the development │ │ │ │ │ -00028de0: 2076 6572 7369 6f6e 0a20 2020 2020 2875 version. (u │ │ │ │ │ -00028df0: 7063 6f6d 696e 6720 312e 3829 2077 6173 pcoming 1.8) was │ │ │ │ │ -00028e00: 2073 7566 6665 7269 6e67 2073 6f6d 6520 suffering some │ │ │ │ │ -00028e10: 6d61 6a6f 7220 696e 7465 726e 616c 2072 major internal r │ │ │ │ │ -00028e20: 6576 616d 7069 6e67 2e0a 0a32 3030 332d evamping...2003- │ │ │ │ │ -00028e30: 3130 2d32 3620 4175 746f 6d61 6b65 206f 10-26 Automake o │ │ │ │ │ -00028e40: 6e20 7363 7265 656e 0a0a 2020 2020 2045 n screen.. E │ │ │ │ │ -00028e50: 7069 736f 6465 2034 392c 2027 5265 7065 pisode 49, 'Repe │ │ │ │ │ -00028e60: 7263 7573 7369 6f6e 7327 2c20 696e 2074 rcussions', in t │ │ │ │ │ -00028e70: 6865 2074 6869 7264 2073 6561 736f 6e20 he third season │ │ │ │ │ -00028e80: 6f66 2074 6865 2027 416c 6961 7327 2054 of the 'Alias' T │ │ │ │ │ -00028e90: 560a 2020 2020 2073 686f 7720 6973 2066 V. show is f │ │ │ │ │ -00028ea0: 6972 7374 2061 6972 6564 2e0a 0a20 2020 irst aired... │ │ │ │ │ -00028eb0: 2020 4d61 7273 6861 6c6c 2c20 6f6e 6520 Marshall, one │ │ │ │ │ -00028ec0: 6f66 2074 6865 2063 6861 7261 6374 6572 of the character │ │ │ │ │ -00028ed0: 732c 2069 7320 776f 726b 696e 6720 6f6e s, is working on │ │ │ │ │ -00028ee0: 2061 2063 6f6d 7075 7465 7220 7669 7275 a computer viru │ │ │ │ │ -00028ef0: 730a 2020 2020 2074 6861 7420 6865 2068 s. that he h │ │ │ │ │ -00028f00: 6173 2074 6f20 6d6f 6469 6679 2062 6566 as to modify bef │ │ │ │ │ -00028f10: 6f72 6520 6974 2067 6574 7320 696e 746f ore it gets into │ │ │ │ │ -00028f20: 2074 6865 2077 726f 6e67 2068 616e 6473 the wrong hands │ │ │ │ │ -00028f30: 206f 720a 2020 2020 2073 6f6d 6574 6869 or. somethi │ │ │ │ │ -00028f40: 6e67 206c 696b 6520 7468 6174 2e20 2054 ng like that. T │ │ │ │ │ -00028f50: 6865 2073 6372 6565 6e73 686f 7473 2079 he screenshots y │ │ │ │ │ -00028f60: 6f75 2073 6565 2064 6f20 6e6f 7420 7368 ou see do not sh │ │ │ │ │ -00028f70: 6f77 2061 6e79 0a20 2020 2020 7072 6f67 ow any. prog │ │ │ │ │ -00028f80: 7261 6d20 636f 6465 2c20 7468 6579 2073 ram code, they s │ │ │ │ │ -00028f90: 686f 7720 6120 274d 616b 6566 696c 652e how a 'Makefile. │ │ │ │ │ -00028fa0: 696e 2720 2767 656e 6572 6174 6564 2062 in' 'generated b │ │ │ │ │ -00028fb0: 7920 6175 746f 6d61 6b65 272e 2e2e 0a0a y automake'..... │ │ │ │ │ -00028fc0: 3230 3033 2d31 312d 3039 2041 7574 6f6d 2003-11-09 Autom │ │ │ │ │ -00028fd0: 616b 6520 312e 372e 390a 0a32 3030 332d ake 1.7.9..2003- │ │ │ │ │ -00028fe0: 3132 2d31 3020 4175 746f 6d61 6b65 2031 12-10 Automake 1 │ │ │ │ │ -00028ff0: 2e38 0a0a 2020 2020 2054 6865 206d 6f73 .8.. The mos │ │ │ │ │ -00029000: 7420 7374 7269 6b69 6e67 2075 7064 6174 t striking updat │ │ │ │ │ -00029010: 6520 6973 2070 726f 6261 626c 7920 7468 e is probably th │ │ │ │ │ -00029020: 6174 206f 6620 2761 636c 6f63 616c 272e at of 'aclocal'. │ │ │ │ │ -00029030: 0a0a 2020 2020 2027 6163 6c6f 6361 6c27 .. 'aclocal' │ │ │ │ │ -00029040: 206e 6f77 2075 7365 7320 276d 345f 696e now uses 'm4_in │ │ │ │ │ -00029050: 636c 7564 6527 2069 6e20 7468 6520 7072 clude' in the pr │ │ │ │ │ -00029060: 6f64 7563 6564 2027 6163 6c6f 6361 6c2e oduced 'aclocal. │ │ │ │ │ -00029070: 6d34 2720 7768 656e 0a20 2020 2020 7468 m4' when. th │ │ │ │ │ -00029080: 6520 696e 636c 7564 6564 206d 6163 726f e included macro │ │ │ │ │ -00029090: 7320 6172 6520 616c 7265 6164 7920 6469 s are already di │ │ │ │ │ -000290a0: 7374 7269 6275 7465 6420 7769 7468 2074 stributed with t │ │ │ │ │ -000290b0: 6865 2070 6163 6b61 6765 2028 616e 0a20 he package (an. │ │ │ │ │ -000290c0: 2020 2020 6964 696f 6d20 7573 6564 2069 idiom used i │ │ │ │ │ -000290d0: 6e20 6d61 6e79 2070 6163 6b61 6765 7329 n many packages) │ │ │ │ │ -000290e0: 2c20 7768 6963 6820 7265 6475 6365 7320 , which reduces │ │ │ │ │ -000290f0: 636f 6465 2064 7570 6c69 6361 7469 6f6e code duplication │ │ │ │ │ -00029100: 2e20 204d 616e 790a 2020 2020 2070 656f . Many. peo │ │ │ │ │ -00029110: 706c 6520 6c69 6b65 6420 7468 6174 2c20 ple liked that, │ │ │ │ │ -00029120: 6275 7420 696e 2066 6163 7420 7468 6973 but in fact this │ │ │ │ │ -00029130: 2063 6861 6e67 6520 7761 7320 7265 616c change was real │ │ │ │ │ -00029140: 6c79 2069 6e74 726f 6475 6365 6420 746f ly introduced to │ │ │ │ │ -00029150: 0a20 2020 2020 6669 7820 6120 6275 6720 . fix a bug │ │ │ │ │ -00029160: 696e 2072 6562 7569 6c64 2072 756c 6573 in rebuild rules │ │ │ │ │ -00029170: 3a20 274d 616b 6566 696c 652e 696e 2720 : 'Makefile.in' │ │ │ │ │ -00029180: 6d75 7374 2062 6520 7265 6275 696c 7420 must be rebuilt │ │ │ │ │ -00029190: 7768 656e 6576 6572 0a20 2020 2020 6120 whenever. a │ │ │ │ │ -000291a0: 6465 7065 6e64 656e 6379 206f 6620 2763 dependency of 'c │ │ │ │ │ -000291b0: 6f6e 6669 6775 7265 2720 6368 616e 6765 onfigure' change │ │ │ │ │ -000291c0: 732c 2062 7574 2061 6c6c 2074 6865 2027 s, but all the ' │ │ │ │ │ -000291d0: 6d34 2720 6669 6c65 730a 2020 2020 2069 m4' files. i │ │ │ │ │ -000291e0: 6e63 6c75 6465 6420 696e 2027 6163 6c6f ncluded in 'aclo │ │ │ │ │ -000291f0: 6361 6c2e 6d34 2720 7768 6572 6520 756e cal.m4' where un │ │ │ │ │ -00029200: 6b6e 6f77 6e20 6672 6f6d 2027 6175 746f known from 'auto │ │ │ │ │ -00029210: 6d61 6b65 272e 2020 4e6f 770a 2020 2020 make'. Now. │ │ │ │ │ -00029220: 2027 6175 746f 6d61 6b65 2720 6361 6e20 'automake' can │ │ │ │ │ -00029230: 6a75 7374 2074 7261 6365 2074 6865 2027 just trace the ' │ │ │ │ │ -00029240: 6d34 5f69 6e63 6c75 6465 2773 2074 6f20 m4_include's to │ │ │ │ │ -00029250: 6469 7363 6f76 6572 2074 6865 0a20 2020 discover the. │ │ │ │ │ -00029260: 2020 6465 7065 6e64 656e 6369 6573 2e0a dependencies.. │ │ │ │ │ -00029270: 0a20 2020 2020 2761 636c 6f63 616c 2720 . 'aclocal' │ │ │ │ │ -00029280: 616c 736f 2073 7461 7274 7320 7573 696e also starts usin │ │ │ │ │ -00029290: 6720 7468 6520 272d 2d74 7261 6365 2720 g the '--trace' │ │ │ │ │ -000292a0: 4175 746f 636f 6e66 206f 7074 696f 6e20 Autoconf option │ │ │ │ │ -000292b0: 696e 206f 7264 6572 0a20 2020 2020 746f in order. to │ │ │ │ │ -000292c0: 2064 6973 636f 7665 7220 7573 6564 206d discover used m │ │ │ │ │ -000292d0: 6163 726f 7320 6d6f 7265 2061 6363 7572 acros more accur │ │ │ │ │ -000292e0: 6174 656c 792e 2020 5468 6973 2077 696c ately. This wil │ │ │ │ │ -000292f0: 6c20 7475 726e 206f 7574 2074 6f20 6265 l turn out to be │ │ │ │ │ -00029300: 0a20 2020 2020 7665 7279 2074 7269 636b . very trick │ │ │ │ │ -00029310: 7920 286c 6174 6572 2072 656c 6561 7365 y (later release │ │ │ │ │ -00029320: 7320 7769 6c6c 2069 6d70 726f 7665 2074 s will improve t │ │ │ │ │ -00029330: 6869 7329 2061 7320 7065 6f70 6c65 2068 his) as people h │ │ │ │ │ -00029340: 6164 0a20 2020 2020 6465 7669 7365 6420 ad. devised │ │ │ │ │ -00029350: 6d61 6e79 2077 6179 7320 746f 2063 6f70 many ways to cop │ │ │ │ │ -00029360: 6520 7769 7468 2074 6865 206c 696d 6974 e with the limit │ │ │ │ │ -00029370: 6174 696f 6e20 6f66 2070 7265 7669 6f75 ation of previou │ │ │ │ │ -00029380: 7320 2761 636c 6f63 616c 270a 2020 2020 s 'aclocal'. │ │ │ │ │ -00029390: 2076 6572 7369 6f6e 732c 206e 6f74 6162 versions, notab │ │ │ │ │ -000293a0: 6c79 2075 7369 6e67 2068 616e 6477 7269 ly using handwri │ │ │ │ │ -000293b0: 7474 656e 2027 6d34 5f69 6e63 6c75 6465 tten 'm4_include │ │ │ │ │ -000293c0: 2773 3a20 2761 636c 6f63 616c 2720 6d75 's: 'aclocal' mu │ │ │ │ │ -000293d0: 7374 0a20 2020 2020 6d61 6b65 2073 7572 st. make sur │ │ │ │ │ -000293e0: 6520 6e6f 7420 746f 2072 6564 6566 696e e not to redefin │ │ │ │ │ -000293f0: 6520 6120 7275 6c65 2074 6861 7420 6973 e a rule that is │ │ │ │ │ -00029400: 2061 6c72 6561 6479 2069 6e63 6c75 6465 already include │ │ │ │ │ -00029410: 6420 6279 2073 7563 680a 2020 2020 2073 d by such. s │ │ │ │ │ -00029420: 7461 7465 6d65 6e74 2e0a 0a20 2020 2020 tatement... │ │ │ │ │ -00029430: 4175 746f 6d61 6b65 2061 6c73 6f20 6861 Automake also ha │ │ │ │ │ -00029440: 7320 7365 656e 2069 7473 2067 7574 7320 s seen its guts │ │ │ │ │ -00029450: 7265 7772 6974 7465 6e2e 2020 416c 7468 rewritten. Alth │ │ │ │ │ -00029460: 6f75 6768 2074 6869 7320 7265 7772 6974 ough this rewrit │ │ │ │ │ -00029470: 696e 670a 2020 2020 2074 6f6f 6b20 6120 ing. took a │ │ │ │ │ -00029480: 6c6f 7420 6f66 2065 6666 6f72 7473 2c20 lot of efforts, │ │ │ │ │ -00029490: 6974 2069 7320 6f6e 6c79 2061 7070 6172 it is only appar │ │ │ │ │ -000294a0: 656e 7420 746f 2074 6865 2075 7365 7273 ent to the users │ │ │ │ │ -000294b0: 2069 6e20 7468 6174 0a20 2020 2020 736f in that. so │ │ │ │ │ -000294c0: 6d65 2063 6f6e 7374 7275 6374 696f 6e73 me constructions │ │ │ │ │ -000294d0: 2070 7265 7669 6f75 736c 7920 6469 7361 previously disa │ │ │ │ │ -000294e0: 6c6c 6f77 6564 2062 7920 7468 6520 696d llowed by the im │ │ │ │ │ -000294f0: 706c 656d 656e 7461 7469 6f6e 206e 6f77 plementation now │ │ │ │ │ -00029500: 0a20 2020 2020 776f 726b 206e 6963 656c . work nicel │ │ │ │ │ -00029510: 792e 2020 436f 6e64 6974 696f 6e61 6c73 y. Conditionals │ │ │ │ │ -00029520: 2c20 4c6f 6361 7469 6f6e 732c 2056 6172 , Locations, Var │ │ │ │ │ -00029530: 6961 626c 6520 616e 6420 5275 6c65 0a20 iable and Rule. │ │ │ │ │ -00029540: 2020 2020 6465 6669 6e69 7469 6f6e 732c definitions, │ │ │ │ │ -00029550: 204f 7074 696f 6e73 3a20 7468 6573 6520 Options: these │ │ │ │ │ -00029560: 6974 656d 7320 6f6e 2077 6869 6368 2041 items on which A │ │ │ │ │ -00029570: 7574 6f6d 616b 6520 776f 726b 7320 6861 utomake works ha │ │ │ │ │ -00029580: 7665 2062 6565 6e0a 2020 2020 2072 6577 ve been. rew │ │ │ │ │ -00029590: 7269 7474 656e 2061 7320 7365 7061 7261 ritten as separa │ │ │ │ │ -000295a0: 7465 2050 6572 6c20 6d6f 6475 6c65 732c te Perl modules, │ │ │ │ │ -000295b0: 2061 6e64 2064 6f63 756d 656e 7465 642e and documented. │ │ │ │ │ -000295c0: 0a0a 3230 3034 2d30 312d 3131 2041 7574 ..2004-01-11 Aut │ │ │ │ │ -000295d0: 6f6d 616b 6520 312e 382e 310a 3230 3034 omake 1.8.1.2004 │ │ │ │ │ -000295e0: 2d30 312d 3132 2041 7574 6f6d 616b 6520 -01-12 Automake │ │ │ │ │ -000295f0: 312e 382e 320a 3230 3034 2d30 332d 3037 1.8.2.2004-03-07 │ │ │ │ │ -00029600: 2041 7574 6f6d 616b 6520 312e 382e 330a Automake 1.8.3. │ │ │ │ │ -00029610: 3230 3034 2d30 342d 3235 2041 7574 6f6d 2004-04-25 Autom │ │ │ │ │ -00029620: 616b 6520 312e 382e 340a 3230 3034 2d30 ake 1.8.4.2004-0 │ │ │ │ │ -00029630: 352d 3136 2041 7574 6f6d 616b 6520 312e 5-16 Automake 1. │ │ │ │ │ -00029640: 382e 350a 0a32 3030 342d 3037 2d32 3820 8.5..2004-07-28 │ │ │ │ │ -00029650: 4175 746f 6d61 6b65 2031 2e39 0a0a 2020 Automake 1.9.. │ │ │ │ │ -00029660: 2020 2054 6869 7320 7265 6c65 6173 6520 This release │ │ │ │ │ -00029670: 7472 6965 7320 746f 2073 696d 706c 6966 tries to simplif │ │ │ │ │ -00029680: 7920 7468 6520 636f 6d70 696c 6174 696f y the compilatio │ │ │ │ │ -00029690: 6e20 7275 6c65 7320 6974 206f 7574 7075 n rules it outpu │ │ │ │ │ -000296a0: 7473 2074 6f0a 2020 2020 2072 6564 7563 ts to. reduc │ │ │ │ │ -000296b0: 6520 7468 6520 7369 7a65 206f 6620 7468 e the size of th │ │ │ │ │ -000296c0: 6520 4d61 6b65 6669 6c65 2e20 2054 6865 e Makefile. The │ │ │ │ │ -000296d0: 2063 6f6d 706c 6169 6e74 2069 6e69 7469 complaint initi │ │ │ │ │ -000296e0: 616c 6c79 2063 6f6d 6520 6672 6f6d 0a20 ally come from. │ │ │ │ │ -000296f0: 2020 2020 7468 6520 6c69 6267 636a 2064 the libgcj d │ │ │ │ │ -00029700: 6576 656c 6f70 6572 732e 2020 5468 6569 evelopers. Thei │ │ │ │ │ -00029710: 7220 274d 616b 6566 696c 652e 696e 2720 r 'Makefile.in' │ │ │ │ │ -00029720: 6765 6e65 7261 7465 6420 7769 7468 2041 generated with A │ │ │ │ │ -00029730: 7574 6f6d 616b 650a 2020 2020 2031 2e34 utomake. 1.4 │ │ │ │ │ -00029740: 2061 6e64 2063 7573 746f 6d20 6275 696c and custom buil │ │ │ │ │ -00029750: 6420 7275 6c65 7320 2831 2e34 2064 6964 d rules (1.4 did │ │ │ │ │ -00029760: 206e 6f74 2073 7570 706f 7274 2063 6f6d not support com │ │ │ │ │ -00029770: 7069 6c65 6420 4a61 7661 2920 6973 0a20 piled Java) is. │ │ │ │ │ -00029780: 2020 2020 3235 304b 422e 2020 5468 6520 250KB. The │ │ │ │ │ -00029790: 6f6e 6520 6765 6e65 7261 7465 6420 6279 one generated by │ │ │ │ │ -000297a0: 2031 2e38 2077 6173 206f 7665 7220 394d 1.8 was over 9M │ │ │ │ │ -000297b0: 4221 2020 312e 3920 6765 7473 2069 7420 B! 1.9 gets it │ │ │ │ │ -000297c0: 646f 776e 2074 6f0a 2020 2020 2031 2e32 down to. 1.2 │ │ │ │ │ -000297d0: 4d42 2e0a 0a20 2020 2020 4173 6964 6520 MB... Aside │ │ │ │ │ -000297e0: 6672 6f6d 2074 6869 7320 6974 2063 6f6e from this it con │ │ │ │ │ -000297f0: 7461 696e 7320 6d61 696e 6c79 206d 696e tains mainly min │ │ │ │ │ -00029800: 6f72 2063 6861 6e67 6573 2061 6e64 2062 or changes and b │ │ │ │ │ -00029810: 7567 2d66 6978 6573 2e0a 0a32 3030 342d ug-fixes...2004- │ │ │ │ │ -00029820: 3038 2d31 3120 4175 746f 6d61 6b65 2031 08-11 Automake 1 │ │ │ │ │ -00029830: 2e39 2e31 0a32 3030 342d 3039 2d31 3920 .9.1.2004-09-19 │ │ │ │ │ -00029840: 4175 746f 6d61 6b65 2031 2e39 2e32 0a0a Automake 1.9.2.. │ │ │ │ │ -00029850: 2020 2020 2041 7574 6f6d 616b 6520 6861 Automake ha │ │ │ │ │ -00029860: 7320 7465 6e20 7965 6172 732e 2020 5468 s ten years. Th │ │ │ │ │ -00029870: 6973 2063 6861 7074 6572 206f 6620 7468 is chapter of th │ │ │ │ │ -00029880: 6520 6d61 6e75 616c 2077 6173 2069 6e69 e manual was ini │ │ │ │ │ -00029890: 7469 616c 6c79 0a20 2020 2020 7772 6974 tially. writ │ │ │ │ │ -000298a0: 7465 6e20 666f 7220 7468 6973 206f 6363 ten for this occ │ │ │ │ │ -000298b0: 6173 696f 6e2e 0a0a 3230 3037 2d31 302d asion...2007-10- │ │ │ │ │ -000298c0: 3239 2041 7574 6f6d 616b 6520 7265 706f 29 Automake repo │ │ │ │ │ -000298d0: 7369 746f 7279 206d 6f76 6573 2074 6f20 sitory moves to │ │ │ │ │ -000298e0: 2773 6176 616e 6e61 682e 676e 752e 6f72 'savannah.gnu.or │ │ │ │ │ -000298f0: 6727 2061 6e64 2075 7365 730a 2020 2020 g' and uses. │ │ │ │ │ -00029900: 2067 6974 2061 7320 7072 696d 6172 7920 git as primary │ │ │ │ │ -00029910: 7265 706f 7369 746f 7279 2e0a 0a1f 0a46 repository.....F │ │ │ │ │ -00029920: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -00029930: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -00029940: 4465 7065 6e64 656e 6379 2054 7261 636b Dependency Track │ │ │ │ │ -00029950: 696e 6720 4576 6f6c 7574 696f 6e2c 2020 ing Evolution, │ │ │ │ │ -00029960: 4e65 7874 3a20 5265 6c65 6173 6573 2c20 Next: Releases, │ │ │ │ │ -00029970: 2050 7265 763a 2054 696d 656c 696e 652c Prev: Timeline, │ │ │ │ │ -00029980: 2020 5570 3a20 4869 7374 6f72 790a 0a32 Up: History..2 │ │ │ │ │ -00029990: 392e 3220 4465 7065 6e64 656e 6379 2054 9.2 Dependency T │ │ │ │ │ -000299a0: 7261 636b 696e 6720 696e 2041 7574 6f6d racking in Autom │ │ │ │ │ -000299b0: 616b 650a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ake.============ │ │ │ │ │ +00021d10: 2a2a 2a0a 0a54 6869 7320 6368 6170 7465 ***..This chapte │ │ │ │ │ +00021d20: 7220 7072 6573 656e 7473 2076 6172 696f r presents vario │ │ │ │ │ +00021d30: 7573 2061 7370 6563 7473 206f 6620 7468 us aspects of th │ │ │ │ │ +00021d40: 6520 6869 7374 6f72 7920 6f66 2041 7574 e history of Aut │ │ │ │ │ +00021d50: 6f6d 616b 652e 2020 5468 650a 6578 6861 omake. The.exha │ │ │ │ │ +00021d60: 7573 7465 6420 7265 6164 6572 2063 616e usted reader can │ │ │ │ │ +00021d70: 2073 6166 656c 7920 736b 6970 2069 743b safely skip it; │ │ │ │ │ +00021d80: 2074 6869 7320 7769 6c6c 2062 6520 6d6f this will be mo │ │ │ │ │ +00021d90: 7265 206f 6620 696e 7465 7265 7374 2074 re of interest t │ │ │ │ │ +00021da0: 6f0a 6e6f 7374 616c 6769 6320 7065 6f70 o.nostalgic peop │ │ │ │ │ +00021db0: 6c65 2c20 6f72 2074 6f20 7468 6f73 6520 le, or to those │ │ │ │ │ +00021dc0: 6375 7269 6f75 7320 746f 206c 6561 726e curious to learn │ │ │ │ │ +00021dd0: 2061 626f 7574 2074 6865 2065 766f 6c75 about the evolu │ │ │ │ │ +00021de0: 7469 6f6e 206f 660a 4175 746f 6d61 6b65 tion of.Automake │ │ │ │ │ +00021df0: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 5469 ...* Menu:..* Ti │ │ │ │ │ +00021e00: 6d65 6c69 6e65 3a3a 2020 2020 2020 2020 meline:: │ │ │ │ │ +00021e10: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ +00021e20: 4175 746f 6d61 6b65 2073 746f 7279 2e0a Automake story.. │ │ │ │ │ +00021e30: 2a20 4465 7065 6e64 656e 6379 2054 7261 * Dependency Tra │ │ │ │ │ +00021e40: 636b 696e 6720 4576 6f6c 7574 696f 6e3a cking Evolution: │ │ │ │ │ +00021e50: 3a20 2045 766f 6c75 7469 6f6e 206f 6620 : Evolution of │ │ │ │ │ +00021e60: 4175 746f 6d61 7469 6320 4465 7065 6e64 Automatic Depend │ │ │ │ │ +00021e70: 656e 6379 2054 7261 636b 696e 670a 2a20 ency Tracking.* │ │ │ │ │ +00021e80: 5265 6c65 6173 6573 3a3a 2020 2020 2020 Releases:: │ │ │ │ │ +00021e90: 2020 2020 2020 2020 2020 2020 2020 5374 St │ │ │ │ │ +00021ea0: 6174 6973 7469 6373 2061 626f 7574 2041 atistics about A │ │ │ │ │ +00021eb0: 7574 6f6d 616b 6520 5265 6c65 6173 6573 utomake Releases │ │ │ │ │ +00021ec0: 0a0a 1f0a 4669 6c65 3a20 6175 746f 6d61 ....File: automa │ │ │ │ │ +00021ed0: 6b65 2d31 2e31 312e 696e 666f 2c20 204e ke-1.11.info, N │ │ │ │ │ +00021ee0: 6f64 653a 2054 696d 656c 696e 652c 2020 ode: Timeline, │ │ │ │ │ +00021ef0: 4e65 7874 3a20 4465 7065 6e64 656e 6379 Next: Dependency │ │ │ │ │ +00021f00: 2054 7261 636b 696e 6720 4576 6f6c 7574 Tracking Evolut │ │ │ │ │ +00021f10: 696f 6e2c 2020 5570 3a20 4869 7374 6f72 ion, Up: Histor │ │ │ │ │ +00021f20: 790a 0a32 392e 3120 5469 6d65 6c69 6e65 y..29.1 Timeline │ │ │ │ │ +00021f30: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a .=============.. │ │ │ │ │ +00021f40: 3139 3934 2d30 392d 3139 2046 6972 7374 1994-09-19 First │ │ │ │ │ +00021f50: 2043 5653 2063 6f6d 6d69 742e 0a0a 2020 CVS commit... │ │ │ │ │ +00021f60: 2020 2049 6620 7765 2063 616e 2074 7275 If we can tru │ │ │ │ │ +00021f70: 7374 2074 6865 2043 5653 2072 6570 6f73 st the CVS repos │ │ │ │ │ +00021f80: 6974 6f72 792c 2044 6176 6964 204a 2e20 itory, David J. │ │ │ │ │ +00021f90: 4d61 634b 656e 7a69 6520 2864 6a6d 290a MacKenzie (djm). │ │ │ │ │ +00021fa0: 2020 2020 2073 7461 7274 6564 2077 6f72 started wor │ │ │ │ │ +00021fb0: 6b69 6e67 206f 6e20 4175 746f 6d61 6b65 king on Automake │ │ │ │ │ +00021fc0: 2028 6f72 2041 7574 6f4d 616b 652c 2061 (or AutoMake, a │ │ │ │ │ +00021fd0: 7320 6974 2077 6173 2073 7065 6c74 2074 s it was spelt t │ │ │ │ │ +00021fe0: 6865 6e29 0a20 2020 2020 7468 6973 204d hen). this M │ │ │ │ │ +00021ff0: 6f6e 6461 792e 0a0a 2020 2020 2054 6865 onday... The │ │ │ │ │ +00022000: 2066 6972 7374 2076 6572 7369 6f6e 206f first version o │ │ │ │ │ +00022010: 6620 7468 6520 2761 7574 6f6d 616b 6527 f the 'automake' │ │ │ │ │ +00022020: 2073 6372 6970 7420 6c6f 6f6b 7320 6173 script looks as │ │ │ │ │ +00022030: 2066 6f6c 6c6f 7773 2e0a 0a20 2020 2020 follows... │ │ │ │ │ +00022040: 2020 2020 2023 212f 6269 6e2f 7368 0a0a #!/bin/sh.. │ │ │ │ │ +00022050: 2020 2020 2020 2020 2020 7374 6174 7573 status │ │ │ │ │ +00022060: 3d30 0a0a 2020 2020 2020 2020 2020 666f =0.. fo │ │ │ │ │ +00022070: 7220 6d61 6b65 6669 6c65 0a20 2020 2020 r makefile. │ │ │ │ │ +00022080: 2020 2020 2064 6f0a 2020 2020 2020 2020 do. │ │ │ │ │ +00022090: 2020 2020 6966 2074 6573 7420 2120 2d66 if test ! -f │ │ │ │ │ +000220a0: 2024 7b6d 616b 6566 696c 657d 2e61 6d3b ${makefile}.am; │ │ │ │ │ +000220b0: 2074 6865 6e0a 2020 2020 2020 2020 2020 then. │ │ │ │ │ +000220c0: 2020 2020 6563 686f 2022 6175 746f 6d61 echo "automa │ │ │ │ │ +000220d0: 6b65 3a20 247b 6d61 6b65 6669 6c65 7d2e ke: ${makefile}. │ │ │ │ │ +000220e0: 616d 3a20 4e6f 2073 7563 6820 686f 6e6b am: No such honk │ │ │ │ │ +000220f0: 696e 2720 6669 6c65 220a 2020 2020 2020 in' file". │ │ │ │ │ +00022100: 2020 2020 2020 2020 7374 6174 7573 3d31 status=1 │ │ │ │ │ +00022110: 0a20 2020 2020 2020 2020 2020 2020 2063 . c │ │ │ │ │ +00022120: 6f6e 7469 6e75 650a 2020 2020 2020 2020 ontinue. │ │ │ │ │ +00022130: 2020 2020 6669 0a0a 2020 2020 2020 2020 fi.. │ │ │ │ │ +00022140: 2020 2020 6578 6563 2034 3e20 247b 6d61 exec 4> ${ma │ │ │ │ │ +00022150: 6b65 6669 6c65 7d2e 696e 0a0a 2020 2020 kefile}.in.. │ │ │ │ │ +00022160: 2020 2020 2020 646f 6e65 0a0a 2020 2020 done.. │ │ │ │ │ +00022170: 2046 726f 6d20 7468 6973 2079 6f75 2063 From this you c │ │ │ │ │ +00022180: 616e 2061 6c72 6561 6479 2073 6565 2074 an already see t │ │ │ │ │ +00022190: 6861 7420 4175 746f 6d61 6b65 2077 696c hat Automake wil │ │ │ │ │ +000221a0: 6c20 6265 2061 626f 7574 2072 6561 6469 l be about readi │ │ │ │ │ +000221b0: 6e67 0a20 2020 2020 272a 2e61 6d27 2066 ng. '*.am' f │ │ │ │ │ +000221c0: 696c 6520 616e 6420 7072 6f64 7563 696e ile and producin │ │ │ │ │ +000221d0: 6720 272a 2e69 6e27 2066 696c 6573 2e20 g '*.in' files. │ │ │ │ │ +000221e0: 2059 6f75 2063 616e 6e6f 7420 7365 6520 You cannot see │ │ │ │ │ +000221f0: 616e 7974 6869 6e67 0a20 2020 2020 656c anything. el │ │ │ │ │ +00022200: 7365 2c20 6275 7420 6966 2079 6f75 2061 se, but if you a │ │ │ │ │ +00022210: 6c73 6f20 6b6e 6f77 2074 6861 7420 4461 lso know that Da │ │ │ │ │ +00022220: 7669 6420 6973 2074 6865 206f 6e65 2077 vid is the one w │ │ │ │ │ +00022230: 686f 2063 7265 6174 6564 0a20 2020 2020 ho created. │ │ │ │ │ +00022240: 4175 746f 636f 6e66 2074 776f 2079 6561 Autoconf two yea │ │ │ │ │ +00022250: 7273 2062 6566 6f72 6520 796f 7520 6361 rs before you ca │ │ │ │ │ +00022260: 6e20 6775 6573 7320 7468 6520 7265 7374 n guess the rest │ │ │ │ │ +00022270: 2e0a 0a20 2020 2020 5365 7665 7261 6c20 ... Several │ │ │ │ │ +00022280: 636f 6d6d 6974 7320 666f 6c6c 6f77 2c20 commits follow, │ │ │ │ │ +00022290: 616e 6420 6279 2074 6865 2065 6e64 206f and by the end o │ │ │ │ │ +000222a0: 6620 7468 6520 6461 7920 4175 746f 6d61 f the day Automa │ │ │ │ │ +000222b0: 6b65 2069 730a 2020 2020 2072 6570 6f72 ke is. repor │ │ │ │ │ +000222c0: 7465 6420 746f 2077 6f72 6b20 666f 7220 ted to work for │ │ │ │ │ +000222d0: 474e 5520 6669 6c65 7574 696c 7320 616e GNU fileutils an │ │ │ │ │ +000222e0: 6420 474e 5520 6d34 2e0a 0a20 2020 2020 d GNU m4... │ │ │ │ │ +000222f0: 5468 6520 6d6f 6475 7320 6f70 6572 616e The modus operan │ │ │ │ │ +00022300: 6469 2069 7320 7468 6520 6f6e 6520 7468 di is the one th │ │ │ │ │ +00022310: 6174 2069 7320 7374 696c 6c20 7573 6564 at is still used │ │ │ │ │ +00022320: 2074 6f64 6179 3a20 7661 7269 6162 6c65 today: variable │ │ │ │ │ +00022330: 0a20 2020 2020 6173 7369 676e 6d65 6e74 . assignment │ │ │ │ │ +00022340: 7320 696e 2027 4d61 6b65 6669 6c65 2e61 s in 'Makefile.a │ │ │ │ │ +00022350: 6d27 2066 696c 6573 2074 7269 6767 6572 m' files trigger │ │ │ │ │ +00022360: 2069 6e6a 6563 7469 6f6e 7320 6f66 2070 injections of p │ │ │ │ │ +00022370: 7265 6361 6e6e 6564 0a20 2020 2020 274d recanned. 'M │ │ │ │ │ +00022380: 616b 6566 696c 6527 2066 7261 676d 656e akefile' fragmen │ │ │ │ │ +00022390: 7473 2069 6e74 6f20 7468 6520 6765 6e65 ts into the gene │ │ │ │ │ +000223a0: 7261 7465 6420 274d 616b 6566 696c 652e rated 'Makefile. │ │ │ │ │ +000223b0: 696e 272e 2020 5468 6520 7573 6520 6f66 in'. The use of │ │ │ │ │ +000223c0: 0a20 2020 2020 274d 616b 6566 696c 6527 . 'Makefile' │ │ │ │ │ +000223d0: 2066 7261 676d 656e 7473 2077 6173 2069 fragments was i │ │ │ │ │ +000223e0: 6e73 7069 7265 6420 6279 2074 6865 2034 nspired by the 4 │ │ │ │ │ +000223f0: 2e34 4253 4420 276d 616b 6527 2061 6e64 .4BSD 'make' and │ │ │ │ │ +00022400: 2069 6e63 6c75 6465 0a20 2020 2020 6669 include. fi │ │ │ │ │ +00022410: 6c65 732c 2068 6f77 6576 6572 2041 7574 les, however Aut │ │ │ │ │ +00022420: 6f6d 616b 6520 6169 6d73 2074 6f20 6265 omake aims to be │ │ │ │ │ +00022430: 2070 6f72 7461 626c 6520 616e 6420 746f portable and to │ │ │ │ │ +00022440: 2063 6f6e 666f 726d 2074 6f20 7468 650a conform to the. │ │ │ │ │ +00022450: 2020 2020 2047 4e55 2073 7461 6e64 6172 GNU standar │ │ │ │ │ +00022460: 6473 2066 6f72 2027 4d61 6b65 6669 6c65 ds for 'Makefile │ │ │ │ │ +00022470: 2720 7661 7269 6162 6c65 7320 616e 6420 ' variables and │ │ │ │ │ +00022480: 7461 7267 6574 732e 0a0a 2020 2020 2041 targets... A │ │ │ │ │ +00022490: 7420 7468 6973 2070 6f69 6e74 2c20 7468 t this point, th │ │ │ │ │ +000224a0: 6520 6d6f 7374 2072 6563 656e 7420 7265 e most recent re │ │ │ │ │ +000224b0: 6c65 6173 6520 6f66 2041 7574 6f63 6f6e lease of Autocon │ │ │ │ │ +000224c0: 6620 6973 2076 6572 7369 6f6e 2031 2e31 f is version 1.1 │ │ │ │ │ +000224d0: 312c 0a20 2020 2020 616e 6420 4461 7669 1,. and Davi │ │ │ │ │ +000224e0: 6420 6973 2070 7265 7061 7269 6e67 2074 d is preparing t │ │ │ │ │ +000224f0: 6f20 7265 6c65 6173 6520 4175 746f 636f o release Autoco │ │ │ │ │ +00022500: 6e66 2032 2e30 2069 6e20 6c61 7465 204f nf 2.0 in late O │ │ │ │ │ +00022510: 6374 6f62 6572 2e20 2041 730a 2020 2020 ctober. As. │ │ │ │ │ +00022520: 2061 206d 6174 7465 7220 6f66 2066 6163 a matter of fac │ │ │ │ │ +00022530: 742c 2068 6520 7769 6c6c 2062 6172 656c t, he will barel │ │ │ │ │ +00022540: 7920 746f 7563 6820 4175 746f 6d61 6b65 y touch Automake │ │ │ │ │ +00022550: 2061 6674 6572 2053 6570 7465 6d62 6572 after September │ │ │ │ │ +00022560: 2e0a 0a31 3939 342d 3131 2d30 3520 4461 ...1994-11-05 Da │ │ │ │ │ +00022570: 7669 6420 4d61 634b 656e 7a69 6527 7320 vid MacKenzie's │ │ │ │ │ +00022580: 6c61 7374 2063 6f6d 6d69 742e 0a0a 2020 last commit... │ │ │ │ │ +00022590: 2020 2041 7420 7468 6973 2070 6f69 6e74 At this point │ │ │ │ │ +000225a0: 2041 7574 6f6d 616b 6520 6973 2061 2032 Automake is a 2 │ │ │ │ │ +000225b0: 3030 206c 696e 6520 706f 7274 6162 6c65 00 line portable │ │ │ │ │ +000225c0: 2073 6865 6c6c 2073 6372 6970 742c 2070 shell script, p │ │ │ │ │ +000225d0: 6c75 730a 2020 2020 2033 3332 206c 696e lus. 332 lin │ │ │ │ │ +000225e0: 6573 206f 6620 274d 616b 6566 696c 6527 es of 'Makefile' │ │ │ │ │ +000225f0: 2066 7261 676d 656e 7473 2e20 2049 6e20 fragments. In │ │ │ │ │ +00022600: 7468 6520 2752 4541 444d 4527 2c20 4461 the 'README', Da │ │ │ │ │ +00022610: 7669 6420 7374 6174 6573 0a20 2020 2020 vid states. │ │ │ │ │ +00022620: 6869 7320 616d 6269 7661 6c65 6e63 6520 his ambivalence │ │ │ │ │ +00022630: 6265 7477 6565 6e20 2270 6f72 7461 626c between "portabl │ │ │ │ │ +00022640: 6520 7368 656c 6c22 2061 6e64 2022 6d6f e shell" and "mo │ │ │ │ │ +00022650: 7265 2061 7070 726f 7072 6961 7465 0a20 re appropriate. │ │ │ │ │ +00022660: 2020 2020 6c61 6e67 7561 6765 223a 0a0a language":.. │ │ │ │ │ +00022670: 2020 2020 2020 2020 2020 4920 7772 6f74 I wrot │ │ │ │ │ +00022680: 6520 6974 206b 6565 7069 6e67 2069 6e20 e it keeping in │ │ │ │ │ +00022690: 6d69 6e64 2074 6865 2070 6f73 7369 6269 mind the possibi │ │ │ │ │ +000226a0: 6c69 7479 206f 6620 6974 2062 6563 6f6d lity of it becom │ │ │ │ │ +000226b0: 696e 6720 616e 0a20 2020 2020 2020 2020 ing an. │ │ │ │ │ +000226c0: 2041 7574 6f63 6f6e 6620 6d61 6372 6f2c Autoconf macro, │ │ │ │ │ +000226d0: 2073 6f20 6974 2077 6f75 6c64 2072 756e so it would run │ │ │ │ │ +000226e0: 2061 7420 636f 6e66 6967 7572 652d 7469 at configure-ti │ │ │ │ │ +000226f0: 6d65 2e20 2054 6861 7420 776f 756c 640a me. That would. │ │ │ │ │ +00022700: 2020 2020 2020 2020 2020 736c 6f77 2063 slow c │ │ │ │ │ +00022710: 6f6e 6669 6775 7261 7469 6f6e 2064 6f77 onfiguration dow │ │ │ │ │ +00022720: 6e20 6120 6269 742c 2062 7574 2061 6c6c n a bit, but all │ │ │ │ │ +00022730: 6f77 2075 7365 7273 2074 6f20 6d6f 6469 ow users to modi │ │ │ │ │ +00022740: 6679 2074 6865 0a20 2020 2020 2020 2020 fy the. │ │ │ │ │ +00022750: 204d 616b 6566 696c 652e 616d 2077 6974 Makefile.am wit │ │ │ │ │ +00022760: 686f 7574 206e 6565 6469 6e67 2074 6f20 hout needing to │ │ │ │ │ +00022770: 6665 7463 6820 7468 6520 4175 746f 4d61 fetch the AutoMa │ │ │ │ │ +00022780: 6b65 2070 6163 6b61 6765 2e0a 2020 2020 ke package.. │ │ │ │ │ +00022790: 2020 2020 2020 416e 642c 2074 6865 204d And, the M │ │ │ │ │ +000227a0: 616b 6566 696c 652e 696e 2066 696c 6573 akefile.in files │ │ │ │ │ +000227b0: 2077 6f75 6c64 6e27 7420 6e65 6564 2074 wouldn't need t │ │ │ │ │ +000227c0: 6f20 6265 2064 6973 7472 6962 7574 6564 o be distributed │ │ │ │ │ +000227d0: 2e0a 2020 2020 2020 2020 2020 4275 7420 .. But │ │ │ │ │ +000227e0: 616c 6c20 6f66 2041 7574 6f4d 616b 6520 all of AutoMake │ │ │ │ │ +000227f0: 776f 756c 642e 2020 536f 2049 206d 6967 would. So I mig │ │ │ │ │ +00022800: 6874 2072 6569 6d70 6c65 6d65 6e74 2041 ht reimplement A │ │ │ │ │ +00022810: 7574 6f4d 616b 6520 696e 0a20 2020 2020 utoMake in. │ │ │ │ │ +00022820: 2020 2020 2050 6572 6c2c 206d 342c 206f Perl, m4, o │ │ │ │ │ +00022830: 7220 736f 6d65 206f 7468 6572 206d 6f72 r some other mor │ │ │ │ │ +00022840: 6520 6170 7072 6f70 7269 6174 6520 6c61 e appropriate la │ │ │ │ │ +00022850: 6e67 7561 6765 2e0a 0a20 2020 2020 4175 nguage... Au │ │ │ │ │ +00022860: 746f 6d61 6b65 2069 7320 6465 7363 7269 tomake is descri │ │ │ │ │ +00022870: 6265 6420 6173 2022 616e 2065 7870 6572 bed as "an exper │ │ │ │ │ +00022880: 696d 656e 7461 6c20 4d61 6b65 6669 6c65 imental Makefile │ │ │ │ │ +00022890: 2067 656e 6572 6174 6f72 222e 0a20 2020 generator".. │ │ │ │ │ +000228a0: 2020 5468 6572 6520 6973 206e 6f20 646f There is no do │ │ │ │ │ +000228b0: 6375 6d65 6e74 6174 696f 6e2e 2020 4164 cumentation. Ad │ │ │ │ │ +000228c0: 7665 6e74 7572 6f75 7320 7573 6572 7320 venturous users │ │ │ │ │ +000228d0: 6172 6520 7265 6665 7272 6564 2074 6f20 are referred to │ │ │ │ │ +000228e0: 7468 650a 2020 2020 2065 7861 6d70 6c65 the. example │ │ │ │ │ +000228f0: 7320 616e 6420 7061 7463 6865 7320 6e65 s and patches ne │ │ │ │ │ +00022900: 6564 6564 2074 6f20 7573 6520 4175 746f eded to use Auto │ │ │ │ │ +00022910: 6d61 6b65 2077 6974 6820 474e 5520 6d34 make with GNU m4 │ │ │ │ │ +00022920: 2031 2e33 2c0a 2020 2020 2066 696c 6575 1.3,. fileu │ │ │ │ │ +00022930: 7469 6c73 2033 2e39 2c20 7469 6d65 2031 tils 3.9, time 1 │ │ │ │ │ +00022940: 2e36 2c20 616e 6420 6465 7665 6c6f 706d .6, and developm │ │ │ │ │ +00022950: 656e 7420 7665 7273 696f 6e73 206f 6620 ent versions of │ │ │ │ │ +00022960: 6669 6e64 2061 6e64 0a20 2020 2020 696e find and. in │ │ │ │ │ +00022970: 6465 6e74 2e0a 0a20 2020 2020 5468 6573 dent... Thes │ │ │ │ │ +00022980: 6520 6578 616d 706c 6573 2073 6565 6d20 e examples seem │ │ │ │ │ +00022990: 746f 2068 6176 6520 6265 656e 206c 6f73 to have been los │ │ │ │ │ +000229a0: 742e 2020 486f 7765 7665 7220 6174 2074 t. However at t │ │ │ │ │ +000229b0: 6865 2074 696d 6520 6f66 0a20 2020 2020 he time of. │ │ │ │ │ +000229c0: 7772 6974 696e 6720 2831 3020 7965 6172 writing (10 year │ │ │ │ │ +000229d0: 7320 6c61 7465 7220 696e 2053 6570 7465 s later in Septe │ │ │ │ │ +000229e0: 6d62 6572 2c20 3230 3034 2920 7468 6520 mber, 2004) the │ │ │ │ │ +000229f0: 4653 4620 7374 696c 6c0a 2020 2020 2064 FSF still. d │ │ │ │ │ +00022a00: 6973 7472 6962 7574 6573 2061 2070 6163 istributes a pac │ │ │ │ │ +00022a10: 6b61 6765 2074 6861 7420 7573 6573 2074 kage that uses t │ │ │ │ │ +00022a20: 6869 7320 7665 7273 696f 6e20 6f66 2041 his version of A │ │ │ │ │ +00022a30: 7574 6f6d 616b 653a 2063 6865 636b 206f utomake: check o │ │ │ │ │ +00022a40: 7574 0a20 2020 2020 474e 5520 7465 726d ut. GNU term │ │ │ │ │ +00022a50: 7574 696c 7320 322e 302e 0a0a 3139 3935 utils 2.0...1995 │ │ │ │ │ +00022a60: 2d31 312d 3132 2054 6f6d 2054 726f 6d65 -11-12 Tom Trome │ │ │ │ │ +00022a70: 7927 7320 6669 7273 7420 636f 6d6d 6974 y's first commit │ │ │ │ │ +00022a80: 2e0a 0a20 2020 2020 4166 7465 7220 6f6e ... After on │ │ │ │ │ +00022a90: 6520 7965 6172 206f 6620 696e 6163 7469 e year of inacti │ │ │ │ │ +00022aa0: 7669 7479 2c20 546f 6d20 5472 6f6d 6579 vity, Tom Tromey │ │ │ │ │ +00022ab0: 2074 616b 6573 206f 7665 7220 7468 6520 takes over the │ │ │ │ │ +00022ac0: 7061 636b 6167 652e 0a20 2020 2020 546f package.. To │ │ │ │ │ +00022ad0: 6d20 7761 7320 776f 726b 696e 6720 6f6e m was working on │ │ │ │ │ +00022ae0: 2047 4e55 2063 7069 6f20 6261 636b 2074 GNU cpio back t │ │ │ │ │ +00022af0: 6865 6e2c 2061 6e64 2064 6f69 6e67 2074 hen, and doing t │ │ │ │ │ +00022b00: 6869 7320 6a75 7374 2066 6f72 2066 756e his just for fun │ │ │ │ │ +00022b10: 2c0a 2020 2020 2068 6176 696e 6720 7472 ,. having tr │ │ │ │ │ +00022b20: 6f75 626c 6520 6669 6e64 696e 6720 6120 ouble finding a │ │ │ │ │ +00022b30: 7072 6f6a 6563 7420 746f 2063 6f6e 7472 project to contr │ │ │ │ │ +00022b40: 6962 7574 6520 746f 2e20 2053 6f20 7768 ibute to. So wh │ │ │ │ │ +00022b50: 696c 650a 2020 2020 2068 6163 6b69 6e67 ile. hacking │ │ │ │ │ +00022b60: 2068 6520 7761 6e74 6564 2074 6f20 6272 he wanted to br │ │ │ │ │ +00022b70: 696e 6720 7468 6520 274d 616b 6566 696c ing the 'Makefil │ │ │ │ │ +00022b80: 652e 696e 2720 7570 2074 6f20 474e 5520 e.in' up to GNU │ │ │ │ │ +00022b90: 7374 616e 6461 7264 732e 0a20 2020 2020 standards.. │ │ │ │ │ +00022ba0: 5468 6973 2077 6173 2068 6172 642c 2061 This was hard, a │ │ │ │ │ +00022bb0: 6e64 206f 6e65 2064 6179 2068 6520 7361 nd one day he sa │ │ │ │ │ +00022bc0: 7720 4175 746f 6d61 6b65 206f 6e0a 2020 w Automake on. │ │ │ │ │ +00022bd0: 2020 203c 6674 703a 2f2f 616c 7068 612e , grabb │ │ │ │ │ +00022bf0: 6564 2069 7420 616e 6420 7472 6965 6420 ed it and tried │ │ │ │ │ +00022c00: 6974 206f 7574 2e0a 0a20 2020 2020 546f it out... To │ │ │ │ │ +00022c10: 6d20 6469 646e 2774 2074 616c 6b20 746f m didn't talk to │ │ │ │ │ +00022c20: 2064 6a6d 2061 626f 7574 2069 7420 756e djm about it un │ │ │ │ │ +00022c30: 7469 6c20 6c61 7465 722c 206a 7573 7420 til later, just │ │ │ │ │ +00022c40: 746f 206d 616b 6520 7375 7265 2068 650a to make sure he. │ │ │ │ │ +00022c50: 2020 2020 2064 6964 6e27 7420 6d69 6e64 didn't mind │ │ │ │ │ +00022c60: 2069 6620 6865 206d 6164 6520 6120 7265 if he made a re │ │ │ │ │ +00022c70: 6c65 6173 652e 2020 4865 2064 6964 2061 lease. He did a │ │ │ │ │ +00022c80: 2062 756e 6368 206f 6620 6561 726c 7920 bunch of early │ │ │ │ │ +00022c90: 7265 6c65 6173 6573 0a20 2020 2020 746f releases. to │ │ │ │ │ +00022ca0: 2074 6865 2047 6e69 7473 2066 6f6c 6b73 the Gnits folks │ │ │ │ │ +00022cb0: 2e0a 0a20 2020 2020 476e 6974 7320 7761 ... Gnits wa │ │ │ │ │ +00022cc0: 7320 2861 6e64 2073 7469 6c6c 2069 7329 s (and still is) │ │ │ │ │ +00022cd0: 2074 6f74 616c 6c79 2069 6e66 6f72 6d61 totally informa │ │ │ │ │ +00022ce0: 6c2c 206a 7573 7420 6120 6665 7720 474e l, just a few GN │ │ │ │ │ +00022cf0: 5520 6672 6965 6e64 730a 2020 2020 2077 U friends. w │ │ │ │ │ +00022d00: 686f 2046 7261 6ec3 a76f 6973 2050 696e ho Fran..ois Pin │ │ │ │ │ +00022d10: 6172 6420 6b6e 6577 2c20 7768 6f20 7765 ard knew, who we │ │ │ │ │ +00022d20: 7265 2061 6c6c 2069 6e74 6572 6573 7465 re all intereste │ │ │ │ │ +00022d30: 6420 696e 206d 616b 696e 6720 610a 2020 d in making a. │ │ │ │ │ +00022d40: 2020 2063 6f6d 6d6f 6e20 696e 6672 6173 common infras │ │ │ │ │ +00022d50: 7472 7563 7475 7265 2066 6f72 2047 4e55 tructure for GNU │ │ │ │ │ +00022d60: 2070 726f 6a65 6374 732c 2061 6e64 2073 projects, and s │ │ │ │ │ +00022d70: 6861 7265 6420 6120 7369 6d69 6c61 720a hared a similar. │ │ │ │ │ +00022d80: 2020 2020 206f 7574 6c6f 6f6b 206f 6e20 outlook on │ │ │ │ │ +00022d90: 686f 7720 746f 2064 6f20 6974 2e20 2053 how to do it. S │ │ │ │ │ +00022da0: 6f20 7468 6579 2077 6572 6520 6162 6c65 o they were able │ │ │ │ │ +00022db0: 2074 6f20 6d61 6b65 2073 6f6d 6520 7072 to make some pr │ │ │ │ │ +00022dc0: 6f67 7265 7373 2e0a 2020 2020 2049 7420 ogress.. It │ │ │ │ │ +00022dd0: 6361 6d65 2061 6c6f 6e67 2077 6974 6820 came along with │ │ │ │ │ +00022de0: 4175 746f 636f 6e66 2061 6e64 2065 7874 Autoconf and ext │ │ │ │ │ +00022df0: 656e 7369 6f6e 7320 7468 6572 656f 662c ensions thereof, │ │ │ │ │ +00022e00: 2061 6e64 2074 6865 6e0a 2020 2020 2041 and then. A │ │ │ │ │ +00022e10: 7574 6f6d 616b 6520 6672 6f6d 2044 6176 utomake from Dav │ │ │ │ │ +00022e20: 6964 2061 6e64 2054 6f6d 2028 7768 6f20 id and Tom (who │ │ │ │ │ +00022e30: 7765 7265 2062 6f74 6820 676e 6974 7369 were both gnitsi │ │ │ │ │ +00022e40: 616e 7329 2e20 204f 6e65 206f 660a 2020 ans). One of. │ │ │ │ │ +00022e50: 2020 2074 6865 6972 2069 6465 6173 2077 their ideas w │ │ │ │ │ +00022e60: 6173 2074 6f20 7772 6974 6520 6120 646f as to write a do │ │ │ │ │ +00022e70: 6375 6d65 6e74 2070 6172 616c 6c65 6c69 cument paralleli │ │ │ │ │ +00022e80: 6e67 2074 6865 2047 4e55 2073 7461 6e64 ng the GNU stand │ │ │ │ │ +00022e90: 6172 6473 2c0a 2020 2020 2074 6861 7420 ards,. that │ │ │ │ │ +00022ea0: 7761 7320 6d6f 7265 2073 7472 6963 7420 was more strict │ │ │ │ │ +00022eb0: 696e 2073 6f6d 6520 7761 7973 2061 6e64 in some ways and │ │ │ │ │ +00022ec0: 206d 6f72 6520 6465 7461 696c 6564 2e20 more detailed. │ │ │ │ │ +00022ed0: 2054 6865 7920 6e65 7665 720a 2020 2020 They never. │ │ │ │ │ +00022ee0: 2066 696e 6973 6865 6420 7468 6520 474e finished the GN │ │ │ │ │ +00022ef0: 4954 5320 7374 616e 6461 7264 732c 2062 ITS standards, b │ │ │ │ │ +00022f00: 7574 2074 6865 2069 6465 6173 206d 6f73 ut the ideas mos │ │ │ │ │ +00022f10: 746c 7920 6d61 6465 2074 6865 6972 2077 tly made their w │ │ │ │ │ +00022f20: 6179 0a20 2020 2020 696e 746f 2041 7574 ay. into Aut │ │ │ │ │ +00022f30: 6f6d 616b 652e 0a0a 3139 3935 2d31 312d omake...1995-11- │ │ │ │ │ +00022f40: 3233 2041 7574 6f6d 616b 6520 302e 3230 23 Automake 0.20 │ │ │ │ │ +00022f50: 0a0a 2020 2020 2042 6573 6964 6573 2069 .. Besides i │ │ │ │ │ +00022f60: 6e74 726f 6475 6369 6e67 2061 7574 6f6d ntroducing autom │ │ │ │ │ +00022f70: 6174 6963 2064 6570 656e 6465 6e63 7920 atic dependency │ │ │ │ │ +00022f80: 7472 6163 6b69 6e67 2028 2a6e 6f74 6520 tracking (*note │ │ │ │ │ +00022f90: 4465 7065 6e64 656e 6379 0a20 2020 2020 Dependency. │ │ │ │ │ +00022fa0: 5472 6163 6b69 6e67 2045 766f 6c75 7469 Tracking Evoluti │ │ │ │ │ +00022fb0: 6f6e 3a3a 292c 2074 6869 7320 7665 7273 on::), this vers │ │ │ │ │ +00022fc0: 696f 6e20 616c 736f 2073 7570 706c 6965 ion also supplie │ │ │ │ │ +00022fd0: 7320 6120 392d 7061 6765 206d 616e 7561 s a 9-page manua │ │ │ │ │ +00022fe0: 6c2e 0a0a 2020 2020 2041 7420 7468 6973 l... At this │ │ │ │ │ +00022ff0: 2074 696d 6520 2761 636c 6f63 616c 2720 time 'aclocal' │ │ │ │ │ +00023000: 616e 6420 2741 4d5f 494e 4954 5f41 5554 and 'AM_INIT_AUT │ │ │ │ │ +00023010: 4f4d 414b 4527 2064 6964 206e 6f74 2065 OMAKE' did not e │ │ │ │ │ +00023020: 7869 7374 2c20 736f 0a20 2020 2020 6d61 xist, so. ma │ │ │ │ │ +00023030: 6e79 2074 6869 6e67 7320 6861 6420 746f ny things had to │ │ │ │ │ +00023040: 2062 6520 646f 6e65 2062 7920 6861 6e64 be done by hand │ │ │ │ │ +00023050: 2e20 2046 6f72 2069 6e73 7461 6e63 652c . For instance, │ │ │ │ │ +00023060: 2068 6572 6520 6973 2077 6861 7420 610a here is what a. │ │ │ │ │ +00023070: 2020 2020 2063 6f6e 6669 6775 7265 2e69 configure.i │ │ │ │ │ +00023080: 6e20 2874 6869 7320 6973 2074 6865 2066 n (this is the f │ │ │ │ │ +00023090: 6f72 6d65 7220 6e61 6d65 206f 6620 7468 ormer name of th │ │ │ │ │ +000230a0: 6520 2763 6f6e 6669 6775 7265 2e61 6327 e 'configure.ac' │ │ │ │ │ +000230b0: 2077 6520 7573 650a 2020 2020 2074 6f64 we use. tod │ │ │ │ │ +000230c0: 6179 2920 6d75 7374 2063 6f6e 7461 696e ay) must contain │ │ │ │ │ +000230d0: 2069 6e20 6f72 6465 7220 746f 2075 7365 in order to use │ │ │ │ │ +000230e0: 2041 7574 6f6d 616b 6520 302e 3230 3a0a Automake 0.20:. │ │ │ │ │ +000230f0: 0a20 2020 2020 2020 2020 2050 4143 4b41 . PACKA │ │ │ │ │ +00023100: 4745 3d63 7069 6f0a 2020 2020 2020 2020 GE=cpio. │ │ │ │ │ +00023110: 2020 5645 5253 494f 4e3d 322e 332e 3931 VERSION=2.3.91 │ │ │ │ │ +00023120: 310a 2020 2020 2020 2020 2020 4143 5f44 1. AC_D │ │ │ │ │ +00023130: 4546 494e 455f 554e 5155 4f54 4544 2850 EFINE_UNQUOTED(P │ │ │ │ │ +00023140: 4143 4b41 4745 2c20 2224 5041 434b 4147 ACKAGE, "$PACKAG │ │ │ │ │ +00023150: 4522 290a 2020 2020 2020 2020 2020 4143 E"). AC │ │ │ │ │ +00023160: 5f44 4546 494e 455f 554e 5155 4f54 4544 _DEFINE_UNQUOTED │ │ │ │ │ +00023170: 2856 4552 5349 4f4e 2c20 2224 5645 5253 (VERSION, "$VERS │ │ │ │ │ +00023180: 494f 4e22 290a 2020 2020 2020 2020 2020 ION"). │ │ │ │ │ +00023190: 4143 5f53 5542 5354 2850 4143 4b41 4745 AC_SUBST(PACKAGE │ │ │ │ │ +000231a0: 290a 2020 2020 2020 2020 2020 4143 5f53 ). AC_S │ │ │ │ │ +000231b0: 5542 5354 2856 4552 5349 4f4e 290a 2020 UBST(VERSION). │ │ │ │ │ +000231c0: 2020 2020 2020 2020 4143 5f41 5247 5f50 AC_ARG_P │ │ │ │ │ +000231d0: 524f 4752 414d 0a20 2020 2020 2020 2020 ROGRAM. │ │ │ │ │ +000231e0: 2041 435f 5052 4f47 5f49 4e53 5441 4c4c AC_PROG_INSTALL │ │ │ │ │ +000231f0: 0a0a 2020 2020 2028 546f 6461 7920 616c .. (Today al │ │ │ │ │ +00023200: 6c20 6f66 2074 6865 2061 626f 7665 2069 l of the above i │ │ │ │ │ +00023210: 7320 6163 6869 6576 6564 2062 7920 2741 s achieved by 'A │ │ │ │ │ +00023220: 435f 494e 4954 2720 616e 640a 2020 2020 C_INIT' and. │ │ │ │ │ +00023230: 2027 414d 5f49 4e49 545f 4155 544f 4d41 'AM_INIT_AUTOMA │ │ │ │ │ +00023240: 4b45 272e 290a 0a20 2020 2020 4865 7265 KE'.).. Here │ │ │ │ │ +00023250: 2069 7320 686f 7720 7072 6f67 7261 6d73 is how programs │ │ │ │ │ +00023260: 2061 7265 2073 7065 6369 6669 6564 2069 are specified i │ │ │ │ │ +00023270: 6e20 274d 616b 6566 696c 652e 616d 273a n 'Makefile.am': │ │ │ │ │ +00023280: 0a0a 2020 2020 2020 2020 2020 5052 4f47 .. PROG │ │ │ │ │ +00023290: 5241 4d53 203d 2068 656c 6c6f 0a20 2020 RAMS = hello. │ │ │ │ │ +000232a0: 2020 2020 2020 2068 656c 6c6f 5f53 4f55 hello_SOU │ │ │ │ │ +000232b0: 5243 4553 203d 2068 656c 6c6f 2e63 0a0a RCES = hello.c.. │ │ │ │ │ +000232c0: 2020 2020 2054 6869 7320 6c6f 6f6b 7320 This looks │ │ │ │ │ +000232d0: 7072 6574 7479 206d 7563 6820 6c69 6b65 pretty much like │ │ │ │ │ +000232e0: 2077 6861 7420 7765 2064 6f20 746f 6461 what we do toda │ │ │ │ │ +000232f0: 792c 2065 7863 6570 7420 7468 6520 2750 y, except the 'P │ │ │ │ │ +00023300: 524f 4752 414d 5327 0a20 2020 2020 7661 ROGRAMS'. va │ │ │ │ │ +00023310: 7269 6162 6c65 2068 6173 206e 6f20 6469 riable has no di │ │ │ │ │ +00023320: 7265 6374 6f72 7920 7072 6566 6978 2073 rectory prefix s │ │ │ │ │ +00023330: 7065 6369 6679 696e 6720 7768 6572 6520 pecifying where │ │ │ │ │ +00023340: 2768 656c 6c6f 2720 7368 6f75 6c64 2062 'hello' should b │ │ │ │ │ +00023350: 650a 2020 2020 2069 6e73 7461 6c6c 6564 e. installed │ │ │ │ │ +00023360: 3a20 616c 6c20 7072 6f67 7261 6d73 2061 : all programs a │ │ │ │ │ +00023370: 7265 2069 6e73 7461 6c6c 6564 2069 6e20 re installed in │ │ │ │ │ +00023380: 2724 2862 696e 6469 7229 272e 0a20 2020 '$(bindir)'.. │ │ │ │ │ +00023390: 2020 274c 4942 5052 4f47 5241 4d53 2720 'LIBPROGRAMS' │ │ │ │ │ +000233a0: 6361 6e20 6265 2075 7365 6420 746f 2073 can be used to s │ │ │ │ │ +000233b0: 7065 6369 6679 2070 726f 6772 616d 7320 pecify programs │ │ │ │ │ +000233c0: 7468 6174 206d 7573 7420 6265 2062 7569 that must be bui │ │ │ │ │ +000233d0: 6c74 0a20 2020 2020 6275 7420 6e6f 7420 lt. but not │ │ │ │ │ +000233e0: 696e 7374 616c 6c65 6420 2869 7420 6973 installed (it is │ │ │ │ │ +000233f0: 2063 616c 6c65 6420 276e 6f69 6e73 745f called 'noinst_ │ │ │ │ │ +00023400: 5052 4f47 5241 4d53 2720 6e6f 7761 6461 PROGRAMS' nowada │ │ │ │ │ +00023410: 7973 292e 0a0a 2020 2020 2050 726f 6772 ys)... Progr │ │ │ │ │ +00023420: 616d 7320 6361 6e20 6265 2062 7569 6c74 ams can be built │ │ │ │ │ +00023430: 2063 6f6e 6469 7469 6f6e 616c 6c79 2075 conditionally u │ │ │ │ │ +00023440: 7369 6e67 2027 4143 5f53 5542 5354 2769 sing 'AC_SUBST'i │ │ │ │ │ +00023450: 7475 7469 6f6e 733a 0a0a 2020 2020 2020 tutions:.. │ │ │ │ │ +00023460: 2020 2020 5052 4f47 5241 4d53 203d 2040 PROGRAMS = @ │ │ │ │ │ +00023470: 7072 6f67 7340 0a20 2020 2020 2020 2020 progs@. │ │ │ │ │ +00023480: 2041 4d5f 5052 4f47 5241 4d53 203d 2066 AM_PROGRAMS = f │ │ │ │ │ +00023490: 6f6f 2062 6172 2062 617a 0a0a 2020 2020 oo bar baz.. │ │ │ │ │ +000234a0: 2028 2741 4d5f 5052 4f47 5241 4d53 2720 ('AM_PROGRAMS' │ │ │ │ │ +000234b0: 6861 7320 7369 6e63 6520 7468 656e 2062 has since then b │ │ │ │ │ +000234c0: 6565 6e20 7265 6e61 6d65 6420 746f 2027 een renamed to ' │ │ │ │ │ +000234d0: 4558 5452 415f 5052 4f47 5241 4d53 272e EXTRA_PROGRAMS'. │ │ │ │ │ +000234e0: 290a 0a20 2020 2020 5369 6d69 6c61 726c ).. Similarl │ │ │ │ │ +000234f0: 7920 7363 7269 7074 732c 2073 7461 7469 y scripts, stati │ │ │ │ │ +00023500: 6320 6c69 6272 6172 6965 732c 2061 6e64 c libraries, and │ │ │ │ │ +00023510: 2064 6174 6120 6361 6e20 6265 2062 7569 data can be bui │ │ │ │ │ +00023520: 6c74 2061 6e64 0a20 2020 2020 696e 7374 lt and. inst │ │ │ │ │ +00023530: 616c 6c65 6420 7573 696e 6720 7468 6520 alled using the │ │ │ │ │ +00023540: 274c 4942 5241 5249 4553 272c 2027 5343 'LIBRARIES', 'SC │ │ │ │ │ +00023550: 5249 5054 5327 2c20 616e 6420 2744 4154 RIPTS', and 'DAT │ │ │ │ │ +00023560: 4127 2076 6172 6961 626c 6573 2e0a 2020 A' variables.. │ │ │ │ │ +00023570: 2020 2048 6f77 6576 6572 2027 4c49 4252 However 'LIBR │ │ │ │ │ +00023580: 4152 4945 5327 2077 6572 6520 7472 6561 ARIES' were trea │ │ │ │ │ +00023590: 7465 6420 6120 6269 7420 7370 6563 6961 ted a bit specia │ │ │ │ │ +000235a0: 6c6c 7920 696e 2074 6861 7420 4175 746f lly in that Auto │ │ │ │ │ +000235b0: 6d61 6b65 0a20 2020 2020 6469 6420 6175 make. did au │ │ │ │ │ +000235c0: 746f 6d61 7469 6361 6c6c 7920 7375 7070 tomatically supp │ │ │ │ │ +000235d0: 6c79 2074 6865 2027 6c69 6227 2061 6e64 ly the 'lib' and │ │ │ │ │ +000235e0: 2027 2e61 2720 7072 6566 6978 6573 2e20 '.a' prefixes. │ │ │ │ │ +000235f0: 2054 6865 7265 666f 7265 2074 6f0a 2020 Therefore to. │ │ │ │ │ +00023600: 2020 2062 7569 6c64 2027 6c69 6263 7069 build 'libcpi │ │ │ │ │ +00023610: 6f2e 6127 2c20 6f6e 6520 6861 6420 746f o.a', one had to │ │ │ │ │ +00023620: 2077 7269 7465 0a0a 2020 2020 2020 2020 write.. │ │ │ │ │ +00023630: 2020 4c49 4252 4152 4945 5320 3d20 6370 LIBRARIES = cp │ │ │ │ │ +00023640: 696f 0a20 2020 2020 2020 2020 2063 7069 io. cpi │ │ │ │ │ +00023650: 6f5f 534f 5552 4345 5320 3d20 2e2e 2e0a o_SOURCES = .... │ │ │ │ │ +00023660: 0a20 2020 2020 4578 7472 6120 6669 6c65 . Extra file │ │ │ │ │ +00023670: 7320 746f 2064 6973 7472 6962 7574 6520 s to distribute │ │ │ │ │ +00023680: 6d75 7374 2062 6520 6c69 7374 6564 2069 must be listed i │ │ │ │ │ +00023690: 6e20 2744 4953 545f 4f54 4845 5227 2028 n 'DIST_OTHER' ( │ │ │ │ │ +000236a0: 7468 650a 2020 2020 2061 6e63 6573 746f the. ancesto │ │ │ │ │ +000236b0: 7220 6f66 2027 4558 5452 415f 4449 5354 r of 'EXTRA_DIST │ │ │ │ │ +000236c0: 2729 2e20 2041 6c73 6f20 6578 7472 6120 '). Also extra │ │ │ │ │ +000236d0: 6469 7265 6374 6f72 6965 7320 7468 6174 directories that │ │ │ │ │ +000236e0: 2061 7265 2074 6f20 6265 0a20 2020 2020 are to be. │ │ │ │ │ +000236f0: 6469 7374 7269 6275 7465 6420 7368 6f75 distributed shou │ │ │ │ │ +00023700: 6c64 2061 7070 6561 7220 696e 2027 4449 ld appear in 'DI │ │ │ │ │ +00023710: 5354 5f53 5542 4449 5253 272c 2062 7574 ST_SUBDIRS', but │ │ │ │ │ +00023720: 2074 6865 206d 616e 7561 6c0a 2020 2020 the manual. │ │ │ │ │ +00023730: 2064 6573 6372 6962 6573 2074 6869 7320 describes this │ │ │ │ │ +00023740: 6173 2061 2074 656d 706f 7261 7279 2075 as a temporary u │ │ │ │ │ +00023750: 676c 7920 6861 636b 2028 746f 6461 7920 gly hack (today │ │ │ │ │ +00023760: 6578 7472 6120 6469 7265 6374 6f72 6965 extra directorie │ │ │ │ │ +00023770: 730a 2020 2020 2073 686f 756c 6420 616c s. should al │ │ │ │ │ +00023780: 736f 2062 6520 6c69 7374 6564 2069 6e20 so be listed in │ │ │ │ │ +00023790: 2745 5854 5241 5f44 4953 5427 2c20 616e 'EXTRA_DIST', an │ │ │ │ │ +000237a0: 6420 2744 4953 545f 5355 4244 4952 5327 d 'DIST_SUBDIRS' │ │ │ │ │ +000237b0: 2069 7320 7573 6564 0a20 2020 2020 666f is used. fo │ │ │ │ │ +000237c0: 7220 616e 6f74 6865 7220 7075 7270 6f73 r another purpos │ │ │ │ │ +000237d0: 652c 202a 6e6f 7465 2043 6f6e 6469 7469 e, *note Conditi │ │ │ │ │ +000237e0: 6f6e 616c 2053 7562 6469 7265 6374 6f72 onal Subdirector │ │ │ │ │ +000237f0: 6965 733a 3a29 2e0a 0a31 3939 352d 3131 ies::)...1995-11 │ │ │ │ │ +00023800: 2d32 3620 4175 746f 6d61 6b65 2030 2e32 -26 Automake 0.2 │ │ │ │ │ +00023810: 310a 0a20 2020 2020 496e 206c 6573 7320 1.. In less │ │ │ │ │ +00023820: 7469 6d65 2074 6861 6e20 6974 2074 616b time than it tak │ │ │ │ │ +00023830: 6573 2074 6f20 636f 6f6b 2061 2066 726f es to cook a fro │ │ │ │ │ +00023840: 7a65 6e20 7069 7a7a 612c 2054 6f6d 2072 zen pizza, Tom r │ │ │ │ │ +00023850: 6577 7269 7465 730a 2020 2020 2041 7574 ewrites. Aut │ │ │ │ │ +00023860: 6f6d 616b 6520 7573 696e 6720 5065 726c omake using Perl │ │ │ │ │ +00023870: 2e20 2041 7420 7468 6973 2074 696d 6520 . At this time │ │ │ │ │ +00023880: 5065 726c 2035 2069 7320 6f6e 6c79 206f Perl 5 is only o │ │ │ │ │ +00023890: 6e65 2079 6561 7220 6f6c 642c 2061 6e64 ne year old, and │ │ │ │ │ +000238a0: 0a20 2020 2020 5065 726c 2034 2e30 3336 . Perl 4.036 │ │ │ │ │ +000238b0: 2069 7320 696e 2075 7365 2061 7420 6d61 is in use at ma │ │ │ │ │ +000238c0: 6e79 2073 6974 6573 2e20 2053 7570 706f ny sites. Suppo │ │ │ │ │ +000238d0: 7274 696e 6720 7365 7665 7261 6c20 5065 rting several Pe │ │ │ │ │ +000238e0: 726c 0a20 2020 2020 7665 7273 696f 6e73 rl. versions │ │ │ │ │ +000238f0: 2068 6173 2062 6565 6e20 6120 736f 7572 has been a sour │ │ │ │ │ +00023900: 6365 206f 6620 7072 6f62 6c65 6d73 2074 ce of problems t │ │ │ │ │ +00023910: 6872 6f75 6768 2074 6865 2077 686f 6c65 hrough the whole │ │ │ │ │ +00023920: 2068 6973 746f 7279 206f 660a 2020 2020 history of. │ │ │ │ │ +00023930: 2041 7574 6f6d 616b 652e 0a0a 2020 2020 Automake... │ │ │ │ │ +00023940: 2049 6620 796f 7520 6e65 7665 7220 7573 If you never us │ │ │ │ │ +00023950: 6564 2050 6572 6c20 342c 2069 6d61 6769 ed Perl 4, imagi │ │ │ │ │ +00023960: 6e65 2050 6572 6c20 3520 7769 7468 6f75 ne Perl 5 withou │ │ │ │ │ +00023970: 7420 6f62 6a65 6374 732c 2077 6974 686f t objects, witho │ │ │ │ │ +00023980: 7574 0a20 2020 2020 276d 7927 2076 6172 ut. 'my' var │ │ │ │ │ +00023990: 6961 626c 6573 2028 6f6e 6c79 2064 796e iables (only dyn │ │ │ │ │ +000239a0: 616d 6963 616c 6c79 2073 636f 7065 6420 amically scoped │ │ │ │ │ +000239b0: 276c 6f63 616c 2720 7661 7269 6162 6c65 'local' variable │ │ │ │ │ +000239c0: 7329 2c20 7769 7468 6f75 740a 2020 2020 s), without. │ │ │ │ │ +000239d0: 2066 756e 6374 696f 6e20 7072 6f74 6f74 function protot │ │ │ │ │ +000239e0: 7970 6573 2c20 7769 7468 2066 756e 6374 ypes, with funct │ │ │ │ │ +000239f0: 696f 6e20 6361 6c6c 7320 7468 6174 206e ion calls that n │ │ │ │ │ +00023a00: 6565 6473 2074 6f20 6265 2070 7265 6669 eeds to be prefi │ │ │ │ │ +00023a10: 7865 640a 2020 2020 2077 6974 6820 2726 xed. with '& │ │ │ │ │ +00023a20: 272c 2065 7463 2e20 2054 7261 6365 7320 ', etc. Traces │ │ │ │ │ +00023a30: 6f66 2074 6869 7320 6f6c 6420 7374 796c of this old styl │ │ │ │ │ +00023a40: 6520 6361 6e20 7374 696c 6c20 6265 2066 e can still be f │ │ │ │ │ +00023a50: 6f75 6e64 2069 6e0a 2020 2020 2074 6f64 ound in. tod │ │ │ │ │ +00023a60: 6179 2773 2027 6175 746f 6d61 6b65 272e ay's 'automake'. │ │ │ │ │ +00023a70: 0a0a 3139 3935 2d31 312d 3238 2041 7574 ..1995-11-28 Aut │ │ │ │ │ +00023a80: 6f6d 616b 6520 302e 3232 0a31 3939 352d omake 0.22.1995- │ │ │ │ │ +00023a90: 3131 2d32 3920 4175 746f 6d61 6b65 2030 11-29 Automake 0 │ │ │ │ │ +00023aa0: 2e32 330a 0a20 2020 2020 4275 6720 6669 .23.. Bug fi │ │ │ │ │ +00023ab0: 7865 732e 0a0a 3139 3935 2d31 322d 3038 xes...1995-12-08 │ │ │ │ │ +00023ac0: 2041 7574 6f6d 616b 6520 302e 3234 0a31 Automake 0.24.1 │ │ │ │ │ +00023ad0: 3939 352d 3132 2d31 3020 4175 746f 6d61 995-12-10 Automa │ │ │ │ │ +00023ae0: 6b65 2030 2e32 350a 0a20 2020 2020 5265 ke 0.25.. Re │ │ │ │ │ +00023af0: 6c65 6173 6573 2061 7265 2072 6169 6e69 leases are raini │ │ │ │ │ +00023b00: 6e67 2e20 2030 2e32 3420 696e 7472 6f64 ng. 0.24 introd │ │ │ │ │ +00023b10: 7563 6573 2074 6865 2075 6e69 666f 726d uces the uniform │ │ │ │ │ +00023b20: 206e 616d 696e 6720 7363 6865 6d65 2077 naming scheme w │ │ │ │ │ +00023b30: 650a 2020 2020 2075 7365 2074 6f64 6179 e. use today │ │ │ │ │ +00023b40: 2c20 692e 652e 2c20 2762 696e 5f50 524f , i.e., 'bin_PRO │ │ │ │ │ +00023b50: 4752 414d 5327 2069 6e73 7465 6164 206f GRAMS' instead o │ │ │ │ │ +00023b60: 6620 2750 524f 4752 414d 5327 2c0a 2020 f 'PROGRAMS',. │ │ │ │ │ +00023b70: 2020 2027 6e6f 696e 7374 5f4c 4942 5241 'noinst_LIBRA │ │ │ │ │ +00023b80: 5249 4553 2720 696e 7374 6561 6420 6f66 RIES' instead of │ │ │ │ │ +00023b90: 2027 4c49 424c 4942 5241 5249 4553 272c 'LIBLIBRARIES', │ │ │ │ │ +00023ba0: 2065 7463 2e20 2028 486f 7765 7665 720a etc. (However. │ │ │ │ │ +00023bb0: 2020 2020 2027 4558 5452 415f 5052 4f47 'EXTRA_PROG │ │ │ │ │ +00023bc0: 5241 4d53 2720 646f 6573 206e 6f74 2065 RAMS' does not e │ │ │ │ │ +00023bd0: 7869 7374 2079 6574 2c20 2741 4d5f 5052 xist yet, 'AM_PR │ │ │ │ │ +00023be0: 4f47 5241 4d53 2720 6973 2073 7469 6c6c OGRAMS' is still │ │ │ │ │ +00023bf0: 2069 6e20 7573 653b 0a20 2020 2020 616e in use;. an │ │ │ │ │ +00023c00: 6420 2754 4558 494e 464f 5327 2061 6e64 d 'TEXINFOS' and │ │ │ │ │ +00023c10: 2027 4d41 4e53 2720 7374 696c 6c20 6861 'MANS' still ha │ │ │ │ │ +00023c20: 7665 206e 6f20 6469 7265 6374 6f72 7920 ve no directory │ │ │ │ │ +00023c30: 7072 6566 6978 6573 2e29 0a20 2020 2020 prefixes.). │ │ │ │ │ +00023c40: 4164 6469 6e67 2073 7570 706f 7274 2066 Adding support f │ │ │ │ │ +00023c50: 6f72 2070 7265 6669 7865 7320 6c69 6b65 or prefixes like │ │ │ │ │ +00023c60: 2074 6861 7420 7761 7320 6f6e 6520 6f66 that was one of │ │ │ │ │ +00023c70: 2074 6865 206d 616a 6f72 2069 6465 6173 the major ideas │ │ │ │ │ +00023c80: 2069 6e0a 2020 2020 2027 6175 746f 6d61 in. 'automa │ │ │ │ │ +00023c90: 6b65 273b 2069 7420 6861 7320 6c61 7374 ke'; it has last │ │ │ │ │ +00023ca0: 6564 2070 7265 7474 7920 7765 6c6c 2e0a ed pretty well.. │ │ │ │ │ +00023cb0: 0a20 2020 2020 4175 746f 4d61 6b65 2069 . AutoMake i │ │ │ │ │ +00023cc0: 7320 7265 6e61 6d65 6420 746f 2041 7574 s renamed to Aut │ │ │ │ │ +00023cd0: 6f6d 616b 6520 2854 6f6d 2073 6565 6d73 omake (Tom seems │ │ │ │ │ +00023ce0: 2074 6f20 7265 6361 6c6c 2069 7420 7761 to recall it wa │ │ │ │ │ +00023cf0: 730a 2020 2020 2046 7261 6ec3 a76f 6973 s. Fran..ois │ │ │ │ │ +00023d00: 2050 696e 6172 6427 7320 646f 696e 6729 Pinard's doing) │ │ │ │ │ +00023d10: 2e0a 0a20 2020 2020 302e 3235 2066 6978 ... 0.25 fix │ │ │ │ │ +00023d20: 6573 2061 2050 6572 6c20 3420 706f 7274 es a Perl 4 port │ │ │ │ │ +00023d30: 6162 696c 6974 7920 6275 672e 0a0a 3139 ability bug...19 │ │ │ │ │ +00023d40: 3935 2d31 322d 3138 204a 696d 204d 6579 95-12-18 Jim Mey │ │ │ │ │ +00023d50: 6572 696e 6720 7374 6172 7473 2075 7369 ering starts usi │ │ │ │ │ +00023d60: 6e67 2041 7574 6f6d 616b 6520 696e 2047 ng Automake in G │ │ │ │ │ +00023d70: 4e55 2054 6578 7475 7469 6c73 2e0a 3139 NU Textutils..19 │ │ │ │ │ +00023d80: 3935 2d31 322d 3331 2046 7261 6ec3 a76f 95-12-31 Fran..o │ │ │ │ │ +00023d90: 6973 2050 696e 6172 6420 7374 6172 7473 is Pinard starts │ │ │ │ │ +00023da0: 2075 7369 6e67 2041 7574 6f6d 616b 6520 using Automake │ │ │ │ │ +00023db0: 696e 2047 4e55 2074 6172 2e0a 0a31 3939 in GNU tar...199 │ │ │ │ │ +00023dc0: 362d 3031 2d30 3320 4175 746f 6d61 6b65 6-01-03 Automake │ │ │ │ │ +00023dd0: 2030 2e32 360a 3139 3936 2d30 312d 3033 0.26.1996-01-03 │ │ │ │ │ +00023de0: 2041 7574 6f6d 616b 6520 302e 3237 0a0a Automake 0.27.. │ │ │ │ │ +00023df0: 2020 2020 204f 6620 7468 6520 6d61 6e79 Of the many │ │ │ │ │ +00023e00: 2063 6861 6e67 6573 2061 6e64 2073 7567 changes and sug │ │ │ │ │ +00023e10: 6765 7374 696f 6e73 2073 656e 7420 6279 gestions sent by │ │ │ │ │ +00023e20: 2046 7261 6ec3 a76f 6973 2050 696e 6172 Fran..ois Pinar │ │ │ │ │ +00023e30: 6420 616e 640a 2020 2020 2069 6e63 6c75 d and. inclu │ │ │ │ │ +00023e40: 6465 6420 696e 2030 2e32 362c 2070 6572 ded in 0.26, per │ │ │ │ │ +00023e50: 6861 7073 2074 6865 206d 6f73 7420 696d haps the most im │ │ │ │ │ +00023e60: 706f 7274 616e 7420 6973 2074 6865 2061 portant is the a │ │ │ │ │ +00023e70: 6476 6963 6520 7468 6174 2074 6f0a 2020 dvice that to. │ │ │ │ │ +00023e80: 2020 2065 6173 6520 6375 7374 6f6d 697a ease customiz │ │ │ │ │ +00023e90: 6174 696f 6e20 6120 7573 6572 2072 756c ation a user rul │ │ │ │ │ +00023ea0: 6520 6f72 2076 6172 6961 626c 6520 6465 e or variable de │ │ │ │ │ +00023eb0: 6669 6e69 7469 6f6e 2073 686f 756c 6420 finition should │ │ │ │ │ +00023ec0: 616c 7761 7973 0a20 2020 2020 6f76 6572 always. over │ │ │ │ │ +00023ed0: 7269 6465 2061 6e20 4175 746f 6d61 6b65 ride an Automake │ │ │ │ │ +00023ee0: 2072 756c 6520 6f72 2064 6566 696e 6974 rule or definit │ │ │ │ │ +00023ef0: 696f 6e2e 0a0a 2020 2020 2047 6f72 646f ion... Gordo │ │ │ │ │ +00023f00: 6e20 4d61 747a 6967 6b65 6974 2061 6e64 n Matzigkeit and │ │ │ │ │ +00023f10: 204a 696d 204d 6579 6572 696e 6720 6172 Jim Meyering ar │ │ │ │ │ +00023f20: 6520 7477 6f20 6f74 6865 7220 6561 726c e two other earl │ │ │ │ │ +00023f30: 7920 636f 6e74 7269 6275 746f 7273 0a20 y contributors. │ │ │ │ │ +00023f40: 2020 2020 7468 6174 2068 6176 6520 6265 that have be │ │ │ │ │ +00023f50: 656e 2073 656e 6469 6e67 2066 6978 6573 en sending fixes │ │ │ │ │ +00023f60: 2e0a 0a20 2020 2020 302e 3237 2066 6978 ... 0.27 fix │ │ │ │ │ +00023f70: 6573 2079 6574 2061 6e6f 7468 6572 2050 es yet another P │ │ │ │ │ +00023f80: 6572 6c20 3420 706f 7274 6162 696c 6974 erl 4 portabilit │ │ │ │ │ +00023f90: 7920 6275 672e 0a0a 3139 3936 2d30 312d y bug...1996-01- │ │ │ │ │ +00023fa0: 3133 2041 7574 6f6d 616b 6520 302e 3238 13 Automake 0.28 │ │ │ │ │ +00023fb0: 0a0a 2020 2020 2041 7574 6f6d 616b 6520 .. Automake │ │ │ │ │ +00023fc0: 7374 6172 7473 2073 6361 6e6e 696e 6720 starts scanning │ │ │ │ │ +00023fd0: 2763 6f6e 6669 6775 7265 2e69 6e27 2066 'configure.in' f │ │ │ │ │ +00023fe0: 6f72 2027 4c49 424f 424a 5327 2073 7570 or 'LIBOBJS' sup │ │ │ │ │ +00023ff0: 706f 7274 2e0a 2020 2020 2054 6869 7320 port.. This │ │ │ │ │ +00024000: 6973 2061 6e20 696d 706f 7274 616e 7420 is an important │ │ │ │ │ +00024010: 7374 6570 2062 6563 6175 7365 2075 6e74 step because unt │ │ │ │ │ +00024020: 696c 2074 6869 7320 7665 7273 696f 6e20 il this version │ │ │ │ │ +00024030: 4175 746f 6d61 6b65 206f 6e6c 790a 2020 Automake only. │ │ │ │ │ +00024040: 2020 206b 6e65 7720 6162 6f75 7420 7468 knew about th │ │ │ │ │ +00024050: 6520 274d 616b 6566 696c 652e 616d 2773 e 'Makefile.am's │ │ │ │ │ +00024060: 2069 7420 7072 6f63 6573 7365 642e 2020 it processed. │ │ │ │ │ +00024070: 2763 6f6e 6669 6775 7265 2e69 6e27 2077 'configure.in' w │ │ │ │ │ +00024080: 6173 0a20 2020 2020 4175 746f 636f 6e66 as. Autoconf │ │ │ │ │ +00024090: 2773 2077 6f72 6c64 2061 6e64 2074 6865 's world and the │ │ │ │ │ +000240a0: 206c 696e 6b20 6265 7477 6565 6e20 4175 link between Au │ │ │ │ │ +000240b0: 746f 636f 6e66 2061 6e64 2041 7574 6f6d toconf and Autom │ │ │ │ │ +000240c0: 616b 6520 6861 6420 746f 0a20 2020 2020 ake had to. │ │ │ │ │ +000240d0: 6265 2064 6f6e 6520 6279 2074 6865 2027 be done by the ' │ │ │ │ │ +000240e0: 4d61 6b65 6669 6c65 2e61 6d27 2061 7574 Makefile.am' aut │ │ │ │ │ +000240f0: 686f 722e 2020 466f 7220 696e 7374 616e hor. For instan │ │ │ │ │ +00024100: 6365 2c20 6966 2027 636f 6e66 6967 2e68 ce, if 'config.h │ │ │ │ │ +00024110: 270a 2020 2020 2077 6173 2067 656e 6572 '. was gener │ │ │ │ │ +00024120: 6174 6564 2062 7920 2763 6f6e 6669 6775 ated by 'configu │ │ │ │ │ +00024130: 7265 272c 2069 7420 7761 7320 7468 6520 re', it was the │ │ │ │ │ +00024140: 7061 636b 6167 6520 6d61 696e 7461 696e package maintain │ │ │ │ │ +00024150: 6572 2773 0a20 2020 2020 7265 7370 6f6e er's. respon │ │ │ │ │ +00024160: 7369 6269 6c69 7479 2074 6f20 6465 6669 sibility to defi │ │ │ │ │ +00024170: 6e65 2074 6865 2027 434f 4e46 4947 5f48 ne the 'CONFIG_H │ │ │ │ │ +00024180: 4541 4445 5227 2076 6172 6961 626c 6520 EADER' variable │ │ │ │ │ +00024190: 696e 2065 6163 680a 2020 2020 2027 4d61 in each. 'Ma │ │ │ │ │ +000241a0: 6b65 6669 6c65 2e61 6d27 2e0a 0a20 2020 kefile.am'... │ │ │ │ │ +000241b0: 2020 5375 6363 6565 6469 6e67 2072 656c Succeeding rel │ │ │ │ │ +000241c0: 6561 7365 7320 7769 6c6c 2072 656c 7920 eases will rely │ │ │ │ │ +000241d0: 6d6f 7265 2061 6e64 206d 6f72 6520 6f6e more and more on │ │ │ │ │ +000241e0: 2073 6361 6e6e 696e 670a 2020 2020 2027 scanning. ' │ │ │ │ │ +000241f0: 636f 6e66 6967 7572 652e 696e 2720 746f configure.in' to │ │ │ │ │ +00024200: 2062 6574 7465 7220 6175 746f 6d61 7465 better automate │ │ │ │ │ +00024210: 2074 6865 2041 7574 6f63 6f6e 6620 696e the Autoconf in │ │ │ │ │ +00024220: 7465 6772 6174 696f 6e2e 0a0a 2020 2020 tegration... │ │ │ │ │ +00024230: 2030 2e32 3820 616c 736f 2069 6e74 726f 0.28 also intro │ │ │ │ │ +00024240: 6475 6365 7320 7468 6520 2741 5554 4f4d duces the 'AUTOM │ │ │ │ │ +00024250: 414b 455f 4f50 5449 4f4e 5327 2076 6172 AKE_OPTIONS' var │ │ │ │ │ +00024260: 6961 626c 6520 616e 6420 7468 650a 2020 iable and the. │ │ │ │ │ +00024270: 2020 2027 2d2d 676e 7527 2061 6e64 2027 '--gnu' and ' │ │ │ │ │ +00024280: 2d2d 676e 6974 7327 206f 7074 696f 6e73 --gnits' options │ │ │ │ │ +00024290: 2c20 7468 6520 6c61 7474 6572 2062 6569 , the latter bei │ │ │ │ │ +000242a0: 6e67 2073 7472 6963 7465 722e 0a0a 3139 ng stricter...19 │ │ │ │ │ +000242b0: 3936 2d30 322d 3037 2041 7574 6f6d 616b 96-02-07 Automak │ │ │ │ │ +000242c0: 6520 302e 3239 0a0a 2020 2020 2054 6861 e 0.29.. Tha │ │ │ │ │ +000242d0: 6e6b 7320 746f 2027 636f 6e66 6967 7572 nks to 'configur │ │ │ │ │ +000242e0: 652e 696e 2720 7363 616e 6e69 6e67 2c20 e.in' scanning, │ │ │ │ │ +000242f0: 2743 4f4e 4649 475f 4845 4144 4552 2720 'CONFIG_HEADER' │ │ │ │ │ +00024300: 6973 2067 6f6e 652c 2061 6e64 0a20 2020 is gone, and. │ │ │ │ │ +00024310: 2020 7265 6275 696c 6420 7275 6c65 7320 rebuild rules │ │ │ │ │ +00024320: 666f 7220 2763 6f6e 6669 6775 7265 272d for 'configure'- │ │ │ │ │ +00024330: 6765 6e65 7261 7465 6420 6669 6c65 2061 generated file a │ │ │ │ │ +00024340: 7265 2061 7574 6f6d 6174 6963 616c 6c79 re automatically │ │ │ │ │ +00024350: 0a20 2020 2020 6f75 7470 7574 2e0a 0a20 . output... │ │ │ │ │ +00024360: 2020 2020 2754 4558 494e 464f 5327 2061 'TEXINFOS' a │ │ │ │ │ +00024370: 6e64 2027 4d41 4e53 2720 636f 6e76 6572 nd 'MANS' conver │ │ │ │ │ +00024380: 7465 6420 746f 2074 6865 2075 6e69 666f ted to the unifo │ │ │ │ │ +00024390: 726d 206e 616d 696e 6720 7363 6865 6d65 rm naming scheme │ │ │ │ │ +000243a0: 2e0a 0a31 3939 362d 3032 2d32 3420 4175 ...1996-02-24 Au │ │ │ │ │ +000243b0: 746f 6d61 6b65 2030 2e33 300a 0a20 2020 tomake 0.30.. │ │ │ │ │ +000243c0: 2020 5468 6520 7465 7374 2073 7569 7465 The test suite │ │ │ │ │ +000243d0: 2069 7320 626f 726e 2e20 2049 7420 636f is born. It co │ │ │ │ │ +000243e0: 6e74 6169 6e73 2039 2074 6573 7473 2e20 ntains 9 tests. │ │ │ │ │ +000243f0: 2046 726f 6d20 6e6f 7720 6f6e 2074 6573 From now on tes │ │ │ │ │ +00024400: 740a 2020 2020 2063 6173 6573 2077 696c t. cases wil │ │ │ │ │ +00024410: 6c20 6265 2061 6464 6564 2070 7265 7474 l be added prett │ │ │ │ │ +00024420: 7920 7265 6775 6c61 726c 7920 282a 6e6f y regularly (*no │ │ │ │ │ +00024430: 7465 2052 656c 6561 7365 733a 3a29 2c20 te Releases::), │ │ │ │ │ +00024440: 616e 6420 7468 6973 0a20 2020 2020 7072 and this. pr │ │ │ │ │ +00024450: 6f76 6564 2074 6f20 6265 2072 6561 6c6c oved to be reall │ │ │ │ │ +00024460: 7920 6865 6c70 6675 6c20 6c61 7465 7220 y helpful later │ │ │ │ │ +00024470: 6f6e 2e0a 0a20 2020 2020 2745 5854 5241 on... 'EXTRA │ │ │ │ │ +00024480: 5f50 524f 4752 414d 5327 2066 696e 616c _PROGRAMS' final │ │ │ │ │ +00024490: 6c79 2072 6570 6c61 6365 7320 2741 4d5f ly replaces 'AM_ │ │ │ │ │ +000244a0: 5052 4f47 5241 4d53 272e 0a0a 2020 2020 PROGRAMS'... │ │ │ │ │ +000244b0: 2041 6c6c 2074 6865 2074 6869 7264 2d70 All the third-p │ │ │ │ │ +000244c0: 6172 7479 2041 7574 6f63 6f6e 6620 6d61 arty Autoconf ma │ │ │ │ │ +000244d0: 6372 6f73 2c20 7772 6974 7465 6e20 6d6f cros, written mo │ │ │ │ │ +000244e0: 7374 6c79 2062 7920 4672 616e c3a7 6f69 stly by Fran..oi │ │ │ │ │ +000244f0: 730a 2020 2020 2050 696e 6172 6420 2861 s. Pinard (a │ │ │ │ │ +00024500: 6e64 206c 6174 6572 204a 696d 204d 6579 nd later Jim Mey │ │ │ │ │ +00024510: 6572 696e 6729 2c20 6172 6520 6469 7374 ering), are dist │ │ │ │ │ +00024520: 7269 6275 7465 6420 696e 2041 7574 6f6d ributed in Autom │ │ │ │ │ +00024530: 616b 6527 730a 2020 2020 2068 616e 642d ake's. hand- │ │ │ │ │ +00024540: 7772 6974 7465 6e20 2761 636c 6f63 616c written 'aclocal │ │ │ │ │ +00024550: 2e6d 3427 2066 696c 652e 2020 5061 636b .m4' file. Pack │ │ │ │ │ +00024560: 6167 6520 6d61 696e 7461 696e 6572 7320 age maintainers │ │ │ │ │ +00024570: 6172 6520 6578 7065 6374 6564 0a20 2020 are expected. │ │ │ │ │ +00024580: 2020 746f 2065 7874 7261 6374 2074 6865 to extract the │ │ │ │ │ +00024590: 206e 6563 6573 7361 7279 206d 6163 726f necessary macro │ │ │ │ │ +000245a0: 7320 6672 6f6d 2074 6869 7320 6669 6c65 s from this file │ │ │ │ │ +000245b0: 2e20 2028 496e 2070 7265 7669 6f75 730a . (In previous. │ │ │ │ │ +000245c0: 2020 2020 2076 6572 7369 6f6e 7320 796f versions yo │ │ │ │ │ +000245d0: 7520 6861 6420 746f 2063 6f70 7920 616e u had to copy an │ │ │ │ │ +000245e0: 6420 7061 7374 6520 7468 656d 2066 726f d paste them fro │ │ │ │ │ +000245f0: 6d20 7468 6520 6d61 6e75 616c 2e2e 2e29 m the manual...) │ │ │ │ │ +00024600: 0a0a 3139 3936 2d30 332d 3131 2041 7574 ..1996-03-11 Aut │ │ │ │ │ +00024610: 6f6d 616b 6520 302e 3331 0a0a 2020 2020 omake 0.31.. │ │ │ │ │ +00024620: 2054 6865 2074 6573 7420 7375 6974 6520 The test suite │ │ │ │ │ +00024630: 696e 2030 2e33 3020 7761 7320 7275 6e20 in 0.30 was run │ │ │ │ │ +00024640: 7669 6120 6120 6c6f 6e67 2027 6368 6563 via a long 'chec │ │ │ │ │ +00024650: 6b2d 6c6f 6361 6c27 2072 756c 652e 2020 k-local' rule. │ │ │ │ │ +00024660: 5570 6f6e 0a20 2020 2020 556c 7269 6368 Upon. Ulrich │ │ │ │ │ +00024670: 2044 7265 7070 6572 2773 2073 7567 6765 Drepper's sugge │ │ │ │ │ +00024680: 7374 696f 6e2c 2030 2e33 3120 6d61 6b65 stion, 0.31 make │ │ │ │ │ +00024690: 7320 6974 2061 6e20 4175 746f 6d61 6b65 s it an Automake │ │ │ │ │ +000246a0: 2072 756c 6520 6f75 7470 7574 0a20 2020 rule output. │ │ │ │ │ +000246b0: 2020 7768 656e 6576 6572 2074 6865 2027 whenever the ' │ │ │ │ │ +000246c0: 5445 5354 5327 2076 6172 6961 626c 6520 TESTS' variable │ │ │ │ │ +000246d0: 6973 2064 6566 696e 6564 2e0a 0a20 2020 is defined... │ │ │ │ │ +000246e0: 2020 2744 4953 545f 4f54 4845 5227 2069 'DIST_OTHER' i │ │ │ │ │ +000246f0: 7320 7265 6e61 6d65 6420 746f 2027 4558 s renamed to 'EX │ │ │ │ │ +00024700: 5452 415f 4449 5354 272c 2061 6e64 2074 TRA_DIST', and t │ │ │ │ │ +00024710: 6865 2027 6368 6563 6b5f 2720 7072 6566 he 'check_' pref │ │ │ │ │ +00024720: 6978 2069 730a 2020 2020 2069 6e74 726f ix is. intro │ │ │ │ │ +00024730: 6475 6365 642e 2020 5468 6520 7379 6e74 duced. The synt │ │ │ │ │ +00024740: 6178 2069 7320 6e6f 7720 7468 6520 7361 ax is now the sa │ │ │ │ │ +00024750: 6d65 2061 7320 746f 6461 792e 0a0a 3139 me as today...19 │ │ │ │ │ +00024760: 3936 2d30 332d 3135 2047 6f72 646f 6e20 96-03-15 Gordon │ │ │ │ │ +00024770: 4d61 747a 6967 6b65 6974 2073 7461 7274 Matzigkeit start │ │ │ │ │ +00024780: 7320 7772 6974 696e 6720 6c69 6274 6f6f s writing libtoo │ │ │ │ │ +00024790: 6c2e 0a0a 3139 3936 2d30 342d 3237 2041 l...1996-04-27 A │ │ │ │ │ +000247a0: 7574 6f6d 616b 6520 302e 3332 0a0a 2020 utomake 0.32.. │ │ │ │ │ +000247b0: 2020 2027 2d68 6f6f 6b27 2074 6172 6765 '-hook' targe │ │ │ │ │ +000247c0: 7473 2061 7265 2069 6e74 726f 6475 6365 ts are introduce │ │ │ │ │ +000247d0: 643b 2061 6e20 6964 6561 2066 726f 6d20 d; an idea from │ │ │ │ │ +000247e0: 4469 6574 6572 2042 6172 6f6e 2e0a 0a20 Dieter Baron... │ │ │ │ │ +000247f0: 2020 2020 272a 2e69 6e66 6f27 2066 696c '*.info' fil │ │ │ │ │ +00024800: 6573 2c20 7768 6963 6820 7765 7265 206f es, which were o │ │ │ │ │ +00024810: 7574 7075 7420 696e 2074 6865 2062 7569 utput in the bui │ │ │ │ │ +00024820: 6c64 2064 6972 6563 746f 7279 2061 7265 ld directory are │ │ │ │ │ +00024830: 206e 6f77 0a20 2020 2020 6275 696c 7420 now. built │ │ │ │ │ +00024840: 696e 2074 6865 2073 6f75 7263 6520 6469 in the source di │ │ │ │ │ +00024850: 7265 6374 6f72 792c 2062 6563 6175 7365 rectory, because │ │ │ │ │ +00024860: 2074 6865 7920 6172 6520 6469 7374 7269 they are distri │ │ │ │ │ +00024870: 6275 7465 642e 2020 4974 0a20 2020 2020 buted. It. │ │ │ │ │ +00024880: 7365 656d 7320 7468 6573 6520 6669 6c65 seems these file │ │ │ │ │ +00024890: 7320 6c69 6b65 2074 6f20 6d6f 7665 2062 s like to move b │ │ │ │ │ +000248a0: 6163 6b20 616e 6420 666f 7274 6820 6173 ack and forth as │ │ │ │ │ +000248b0: 2074 6861 7420 7769 6c6c 2068 6170 7065 that will happe │ │ │ │ │ +000248c0: 6e0a 2020 2020 2061 6761 696e 2069 6e20 n. again in │ │ │ │ │ +000248d0: 6675 7475 7265 2076 6572 7369 6f6e 732e future versions. │ │ │ │ │ +000248e0: 0a0a 3139 3936 2d30 352d 3138 2041 7574 ..1996-05-18 Aut │ │ │ │ │ +000248f0: 6f6d 616b 6520 302e 3333 0a0a 2020 2020 omake 0.33.. │ │ │ │ │ +00024900: 2047 6f72 6420 4d61 747a 6967 6b65 6974 Gord Matzigkeit │ │ │ │ │ +00024910: 2773 206d 6169 6e20 7477 6f20 636f 6e74 's main two cont │ │ │ │ │ +00024920: 7269 6275 7469 6f6e 733a 0a0a 2020 2020 ributions:.. │ │ │ │ │ +00024930: 2020 2020 2a20 7665 7279 2070 7265 6c69 * very preli │ │ │ │ │ +00024940: 6d69 6e61 7279 206c 6962 746f 6f6c 2073 minary libtool s │ │ │ │ │ +00024950: 7570 706f 7274 0a20 2020 2020 2020 202a upport. * │ │ │ │ │ +00024960: 2074 6865 2064 6973 7463 6865 636b 2072 the distcheck r │ │ │ │ │ +00024970: 756c 650a 0a20 2020 2020 416c 7468 6f75 ule.. Althou │ │ │ │ │ +00024980: 6768 2074 6865 7920 7765 7265 2076 6572 gh they were ver │ │ │ │ │ +00024990: 7920 6261 7369 6320 6174 2074 6869 7320 y basic at this │ │ │ │ │ +000249a0: 706f 696e 742c 2074 6865 7365 2061 7265 point, these are │ │ │ │ │ +000249b0: 2070 726f 6261 626c 790a 2020 2020 2061 probably. a │ │ │ │ │ +000249c0: 6d6f 6e67 2074 6865 2074 6f70 2066 6561 mong the top fea │ │ │ │ │ +000249d0: 7475 7265 7320 666f 7220 4175 746f 6d61 tures for Automa │ │ │ │ │ +000249e0: 6b65 2074 6f64 6179 2e0a 0a20 2020 2020 ke today... │ │ │ │ │ +000249f0: 4a69 6d20 4d65 7965 7269 6e67 2061 6c73 Jim Meyering als │ │ │ │ │ +00024a00: 6f20 7072 6f76 6964 6573 2074 6865 2069 o provides the i │ │ │ │ │ +00024a10: 6e66 616d 6f75 7320 276a 6d5f 4d41 494e nfamous 'jm_MAIN │ │ │ │ │ +00024a20: 5441 494e 4552 5f4d 4f44 4527 2c20 7369 TAINER_MODE', si │ │ │ │ │ +00024a30: 6e63 650a 2020 2020 2074 6865 6e20 7265 nce. then re │ │ │ │ │ +00024a40: 6e61 6d65 6420 746f 2027 414d 5f4d 4149 named to 'AM_MAI │ │ │ │ │ +00024a50: 4e54 4149 4e45 525f 4d4f 4445 2720 616e NTAINER_MODE' an │ │ │ │ │ +00024a60: 6420 6162 616e 646f 6e65 6420 6279 2069 d abandoned by i │ │ │ │ │ +00024a70: 7473 2061 7574 686f 720a 2020 2020 2028 ts author. ( │ │ │ │ │ +00024a80: 2a6e 6f74 6520 6d61 696e 7461 696e 6572 *note maintainer │ │ │ │ │ +00024a90: 2d6d 6f64 653a 3a29 2e0a 0a31 3939 362d -mode::)...1996- │ │ │ │ │ +00024aa0: 3035 2d32 3820 4175 746f 6d61 6b65 2031 05-28 Automake 1 │ │ │ │ │ +00024ab0: 2e30 0a0a 2020 2020 2041 6674 6572 206f .0.. After o │ │ │ │ │ +00024ac0: 6e6c 7920 7369 7820 6d6f 6e74 6873 206f nly six months o │ │ │ │ │ +00024ad0: 6620 6865 6176 7920 6465 7665 6c6f 706d f heavy developm │ │ │ │ │ +00024ae0: 656e 742c 2074 6865 2027 6175 746f 6d61 ent, the 'automa │ │ │ │ │ +00024af0: 6b65 2720 7363 7269 7074 0a20 2020 2020 ke' script. │ │ │ │ │ +00024b00: 6973 2033 3133 3420 6c69 6e65 7320 6c6f is 3134 lines lo │ │ │ │ │ +00024b10: 6e67 2c20 706c 7573 2039 3733 206c 696e ng, plus 973 lin │ │ │ │ │ +00024b20: 6573 206f 6620 274d 616b 6566 696c 6527 es of 'Makefile' │ │ │ │ │ +00024b30: 2066 7261 676d 656e 7473 2e20 2054 6865 fragments. The │ │ │ │ │ +00024b40: 0a20 2020 2020 7061 636b 6167 6520 6861 . package ha │ │ │ │ │ +00024b50: 7320 3330 2070 6167 6573 206f 6620 646f s 30 pages of do │ │ │ │ │ +00024b60: 6375 6d65 6e74 6174 696f 6e2c 2061 6e64 cumentation, and │ │ │ │ │ +00024b70: 2033 3820 7465 7374 2063 6173 6573 2e0a 38 test cases.. │ │ │ │ │ +00024b80: 2020 2020 2027 6163 6c6f 6361 6c2e 6d34 'aclocal.m4 │ │ │ │ │ +00024b90: 2720 636f 6e74 6169 6e73 2034 206d 6163 ' contains 4 mac │ │ │ │ │ +00024ba0: 726f 732e 0a0a 2020 2020 2046 726f 6d20 ros... From │ │ │ │ │ +00024bb0: 6e6f 7720 6f6e 2061 6e64 2075 6e74 696c now on and until │ │ │ │ │ +00024bc0: 2076 6572 7369 6f6e 2031 2e34 2c20 6e65 version 1.4, ne │ │ │ │ │ +00024bd0: 7720 7265 6c65 6173 6573 2077 696c 6c20 w releases will │ │ │ │ │ +00024be0: 6f63 6375 7220 6174 2061 0a20 2020 2020 occur at a. │ │ │ │ │ +00024bf0: 7261 7465 206f 6620 6162 6f75 7420 6f6e rate of about on │ │ │ │ │ +00024c00: 6520 6120 7965 6172 2e20 2031 2e31 2064 e a year. 1.1 d │ │ │ │ │ +00024c10: 6964 206e 6f74 2065 7869 7374 2c20 6163 id not exist, ac │ │ │ │ │ +00024c20: 7475 616c 6c79 2031 2e31 6220 746f 2031 tually 1.1b to 1 │ │ │ │ │ +00024c30: 2e31 700a 2020 2020 2068 6176 6520 6265 .1p. have be │ │ │ │ │ +00024c40: 656e 2074 6865 206e 616d 6520 6f66 2062 en the name of b │ │ │ │ │ +00024c50: 6574 6120 7265 6c65 6173 6573 2066 6f72 eta releases for │ │ │ │ │ +00024c60: 2031 2e32 2e20 2054 6869 7320 6973 2074 1.2. This is t │ │ │ │ │ +00024c70: 6865 2066 6972 7374 0a20 2020 2020 7469 he first. ti │ │ │ │ │ +00024c80: 6d65 2041 7574 6f6d 616b 6520 7573 6573 me Automake uses │ │ │ │ │ +00024c90: 2073 7566 6669 7820 6c65 7474 6572 7320 suffix letters │ │ │ │ │ +00024ca0: 746f 2064 6573 6967 6e61 7465 2062 6574 to designate bet │ │ │ │ │ +00024cb0: 6120 7265 6c65 6173 6573 2c20 610a 2020 a releases, a. │ │ │ │ │ +00024cc0: 2020 2068 6162 6974 2074 6861 7420 6c61 habit that la │ │ │ │ │ +00024cd0: 7374 732e 0a0a 3139 3936 2d31 302d 3130 sts...1996-10-10 │ │ │ │ │ +00024ce0: 204b 6576 696e 2044 616c 6c65 7920 7061 Kevin Dalley pa │ │ │ │ │ +00024cf0: 636b 6167 6573 2041 7574 6f6d 616b 6520 ckages Automake │ │ │ │ │ +00024d00: 312e 3020 666f 7220 4465 6269 616e 2047 1.0 for Debian G │ │ │ │ │ +00024d10: 4e55 2f4c 696e 7578 2e0a 0a31 3939 362d NU/Linux...1996- │ │ │ │ │ +00024d20: 3131 2d32 3620 4461 7669 6420 4a2e 204d 11-26 David J. M │ │ │ │ │ +00024d30: 6163 4b65 6e7a 6965 2072 656c 6561 7365 acKenzie release │ │ │ │ │ +00024d40: 7320 4175 746f 636f 6e66 2032 2e31 322e s Autoconf 2.12. │ │ │ │ │ +00024d50: 0a0a 2020 2020 2042 6574 7765 656e 204a .. Between J │ │ │ │ │ +00024d60: 756e 6520 616e 6420 4f63 746f 6265 722c une and October, │ │ │ │ │ +00024d70: 2074 6865 2041 7574 6f63 6f6e 6620 6465 the Autoconf de │ │ │ │ │ +00024d80: 7665 6c6f 706d 656e 7420 6973 2061 6c6d velopment is alm │ │ │ │ │ +00024d90: 6f73 740a 2020 2020 2073 7461 6c6c 6564 ost. stalled │ │ │ │ │ +00024da0: 2e20 2052 6f6c 616e 6420 4d63 4772 6174 . Roland McGrat │ │ │ │ │ +00024db0: 6820 6861 7320 6265 656e 2077 6f72 6b69 h has been worki │ │ │ │ │ +00024dc0: 6e67 2061 7420 7468 6520 6265 6769 6e6e ng at the beginn │ │ │ │ │ +00024dd0: 696e 6720 6f66 2074 6865 0a20 2020 2020 ing of the. │ │ │ │ │ +00024de0: 7965 6172 2e20 2044 6176 6964 2063 6f6d year. David com │ │ │ │ │ +00024df0: 6573 2062 6163 6b20 696e 204e 6f76 656d es back in Novem │ │ │ │ │ +00024e00: 6265 7220 746f 2072 656c 6561 7365 2032 ber to release 2 │ │ │ │ │ +00024e10: 2e31 322c 2062 7574 2068 6520 776f 6e27 .12, but he won' │ │ │ │ │ +00024e20: 740a 2020 2020 2074 6f75 6368 2041 7574 t. touch Aut │ │ │ │ │ +00024e30: 6f63 6f6e 6620 616e 796d 6f72 6520 6166 oconf anymore af │ │ │ │ │ +00024e40: 7465 7220 7468 6973 2079 6561 722c 2061 ter this year, a │ │ │ │ │ +00024e50: 6e64 2041 7574 6f63 6f6e 6620 7468 656e nd Autoconf then │ │ │ │ │ +00024e60: 2072 6561 6c6c 790a 2020 2020 2073 7461 really. sta │ │ │ │ │ +00024e70: 676e 6174 6573 2e20 2054 6865 2064 6573 gnates. The des │ │ │ │ │ +00024e80: 6f6c 6174 6520 4175 746f 636f 6e66 2027 olate Autoconf ' │ │ │ │ │ +00024e90: 4368 616e 6765 4c6f 6727 2066 6f72 2031 ChangeLog' for 1 │ │ │ │ │ +00024ea0: 3939 3720 6c69 7374 7320 6f6e 6c79 2037 997 lists only 7 │ │ │ │ │ +00024eb0: 0a20 2020 2020 636f 6d6d 6974 732e 0a0a . commits... │ │ │ │ │ +00024ec0: 3139 3937 2d30 322d 3238 203c 6175 746f 1997-02-28 list alive. │ │ │ │ │ +00024ef0: 0a20 2020 2020 5468 6520 6d61 696c 696e . The mailin │ │ │ │ │ +00024f00: 6720 6c69 7374 2069 7320 616e 6e6f 756e g list is announ │ │ │ │ │ +00024f10: 6365 6420 6173 2066 6f6c 6c6f 7773 3a0a ced as follows:. │ │ │ │ │ +00024f20: 2020 2020 2020 2020 2020 4927 7665 2063 I've c │ │ │ │ │ +00024f30: 7265 6174 6564 2074 6865 2022 6175 746f reated the "auto │ │ │ │ │ +00024f40: 6d61 6b65 2220 6d61 696c 696e 6720 6c69 make" mailing li │ │ │ │ │ +00024f50: 7374 2e20 2049 7420 6973 0a20 2020 2020 st. It is. │ │ │ │ │ +00024f60: 2020 2020 2022 6175 746f 6d61 6b65 4067 "automake@g │ │ │ │ │ +00024f70: 6e75 2e61 692e 6d69 742e 6564 7522 2e20 nu.ai.mit.edu". │ │ │ │ │ +00024f80: 2041 646d 696e 6973 7472 6976 6961 2c20 Administrivia, │ │ │ │ │ +00024f90: 6173 2061 6c77 6179 732c 2074 6f0a 2020 as always, to. │ │ │ │ │ +00024fa0: 2020 2020 2020 2020 6175 746f 6d61 6b65 automake │ │ │ │ │ +00024fb0: 2d72 6571 7565 7374 4067 6e75 2e61 692e -request@gnu.ai. │ │ │ │ │ +00024fc0: 6d69 742e 6564 752e 0a0a 2020 2020 2020 mit.edu... │ │ │ │ │ +00024fd0: 2020 2020 5468 6520 6368 6172 7465 7220 The charter │ │ │ │ │ +00024fe0: 6f66 2074 6869 7320 6c69 7374 2069 7320 of this list is │ │ │ │ │ +00024ff0: 6469 7363 7573 7369 6f6e 206f 6620 6175 discussion of au │ │ │ │ │ +00025000: 746f 6d61 6b65 2c20 6175 746f 636f 6e66 tomake, autoconf │ │ │ │ │ +00025010: 2c20 616e 640a 2020 2020 2020 2020 2020 , and. │ │ │ │ │ +00025020: 6f74 6865 7220 636f 6e66 6967 7572 6174 other configurat │ │ │ │ │ +00025030: 696f 6e2f 706f 7274 6162 696c 6974 7920 ion/portability │ │ │ │ │ +00025040: 746f 6f6c 7320 2865 2e67 2e2c 206c 6962 tools (e.g., lib │ │ │ │ │ +00025050: 746f 6f6c 292e 2020 4974 2069 7320 6578 tool). It is ex │ │ │ │ │ +00025060: 7065 6374 6564 0a20 2020 2020 2020 2020 pected. │ │ │ │ │ +00025070: 2074 6861 7420 6469 7363 7573 7369 6f6e that discussion │ │ │ │ │ +00025080: 2077 696c 6c20 7261 6e67 6520 6672 6f6d will range from │ │ │ │ │ +00025090: 2070 6c65 6173 2066 6f72 2068 656c 7020 pleas for help │ │ │ │ │ +000250a0: 616c 6c20 7468 6520 7761 7920 7570 2074 all the way up t │ │ │ │ │ +000250b0: 6f0a 2020 2020 2020 2020 2020 7061 7463 o. patc │ │ │ │ │ +000250c0: 6865 732e 0a0a 2020 2020 2020 2020 2020 hes... │ │ │ │ │ +000250d0: 5468 6973 206c 6973 7420 6973 2061 7263 This list is arc │ │ │ │ │ +000250e0: 6869 7665 6420 6f6e 2074 6865 2046 5346 hived on the FSF │ │ │ │ │ +000250f0: 206d 6163 6869 6e65 732e 2020 4f66 6668 machines. Offh │ │ │ │ │ +00025100: 616e 6420 4920 646f 6e27 7420 6b6e 6f77 and I don't know │ │ │ │ │ +00025110: 2069 660a 2020 2020 2020 2020 2020 796f if. yo │ │ │ │ │ +00025120: 7520 6361 6e20 6765 7420 7468 6520 6172 u can get the ar │ │ │ │ │ +00025130: 6368 6976 6520 7769 7468 6f75 7420 616e chive without an │ │ │ │ │ +00025140: 2061 6363 6f75 6e74 2074 6865 7265 2e0a account there.. │ │ │ │ │ +00025150: 0a20 2020 2020 2020 2020 2054 6869 7320 . This │ │ │ │ │ +00025160: 6c69 7374 2069 7320 6f70 656e 2074 6f20 list is open to │ │ │ │ │ +00025170: 616e 7962 6f64 7920 7768 6f20 7761 6e74 anybody who want │ │ │ │ │ +00025180: 7320 746f 206a 6f69 6e2e 2020 5465 6c6c s to join. Tell │ │ │ │ │ +00025190: 2061 6c6c 2079 6f75 720a 2020 2020 2020 all your. │ │ │ │ │ +000251a0: 2020 2020 6672 6965 6e64 7321 0a20 2020 friends!. │ │ │ │ │ +000251b0: 2020 2020 2020 202d 2d20 546f 6d20 5472 -- Tom Tr │ │ │ │ │ +000251c0: 6f6d 6579 0a0a 2020 2020 2042 6566 6f72 omey.. Befor │ │ │ │ │ +000251d0: 6520 7468 6174 2070 656f 706c 6520 7765 e that people we │ │ │ │ │ +000251e0: 7265 2064 6973 6375 7373 696e 6720 4175 re discussing Au │ │ │ │ │ +000251f0: 746f 6d61 6b65 2070 7269 7661 7465 6c79 tomake privately │ │ │ │ │ +00025200: 2c20 6f6e 2074 6865 2047 6e69 7473 0a20 , on the Gnits. │ │ │ │ │ +00025210: 2020 2020 6d61 696c 696e 6720 6c69 7374 mailing list │ │ │ │ │ +00025220: 2028 7768 6963 6820 6973 206e 6f74 2070 (which is not p │ │ │ │ │ +00025230: 7562 6c69 6320 6569 7468 6572 292c 2061 ublic either), a │ │ │ │ │ +00025240: 6e64 206c 6573 7320 6672 6571 7565 6e74 nd less frequent │ │ │ │ │ +00025250: 6c79 206f 6e0a 2020 2020 2027 676e 752e ly on. 'gnu. │ │ │ │ │ +00025260: 6d69 7363 2e64 6973 6375 7373 272e 0a0a misc.discuss'... │ │ │ │ │ +00025270: 2020 2020 2027 676e 752e 6169 2e6d 6974 'gnu.ai.mit │ │ │ │ │ +00025280: 2e65 6475 2720 6973 206e 6f77 2027 676e .edu' is now 'gn │ │ │ │ │ +00025290: 752e 6f72 6727 2c20 696e 2063 6173 6520 u.org', in case │ │ │ │ │ +000252a0: 796f 7520 6e65 7665 7220 6e6f 7469 6365 you never notice │ │ │ │ │ +000252b0: 642e 2020 5468 650a 2020 2020 2061 7263 d. The. arc │ │ │ │ │ +000252c0: 6869 7665 7320 6f66 2074 6865 2065 6172 hives of the ear │ │ │ │ │ +000252d0: 6c79 2079 6561 7273 206f 6620 7468 6520 ly years of the │ │ │ │ │ +000252e0: 2761 7574 6f6d 616b 6540 676e 752e 6f72 'automake@gnu.or │ │ │ │ │ +000252f0: 6727 206c 6973 7420 6861 7665 0a20 2020 g' list have. │ │ │ │ │ +00025300: 2020 6265 656e 206c 6f73 742c 2073 6f20 been lost, so │ │ │ │ │ +00025310: 746f 6461 7920 6974 2069 7320 616c 6d6f today it is almo │ │ │ │ │ +00025320: 7374 2069 6d70 6f73 7369 626c 6520 746f st impossible to │ │ │ │ │ +00025330: 2066 696e 6420 7472 6163 6573 206f 660a find traces of. │ │ │ │ │ +00025340: 2020 2020 2064 6973 6375 7373 696f 6e73 discussions │ │ │ │ │ +00025350: 2074 6861 7420 6f63 6375 7272 6564 2062 that occurred b │ │ │ │ │ +00025360: 6566 6f72 6520 3139 3939 2e20 2054 6869 efore 1999. Thi │ │ │ │ │ +00025370: 7320 6861 7320 6265 656e 2061 6e6e 6f79 s has been annoy │ │ │ │ │ +00025380: 696e 6720 6d6f 7265 0a20 2020 2020 7468 ing more. th │ │ │ │ │ +00025390: 616e 206f 6e63 652c 2061 7320 7375 6368 an once, as such │ │ │ │ │ +000253a0: 2064 6973 6375 7373 696f 6e73 2063 616e discussions can │ │ │ │ │ +000253b0: 2062 6520 7573 6566 756c 2074 6f20 756e be useful to un │ │ │ │ │ +000253c0: 6465 7273 7461 6e64 2074 6865 0a20 2020 derstand the. │ │ │ │ │ +000253d0: 2020 7261 7469 6f6e 616c 6520 6265 6869 rationale behi │ │ │ │ │ +000253e0: 6e64 2061 2070 6965 6365 206f 6620 756e nd a piece of un │ │ │ │ │ +000253f0: 636f 6d6d 656e 7465 6420 636f 6465 2074 commented code t │ │ │ │ │ +00025400: 6861 7420 7761 7320 696e 7472 6f64 7563 hat was introduc │ │ │ │ │ +00025410: 6564 0a20 2020 2020 6261 636b 2074 6865 ed. back the │ │ │ │ │ +00025420: 6e2e 0a0a 3139 3937 2d30 362d 3232 2041 n...1997-06-22 A │ │ │ │ │ +00025430: 7574 6f6d 616b 6520 312e 320a 0a20 2020 utomake 1.2.. │ │ │ │ │ +00025440: 2020 4175 746f 6d61 6b65 2064 6576 656c Automake devel │ │ │ │ │ +00025450: 6f70 6d65 6e74 7320 636f 6e74 696e 7565 opments continue │ │ │ │ │ +00025460: 732c 2061 6e64 206d 6f72 6520 616e 6420 s, and more and │ │ │ │ │ +00025470: 6d6f 7265 206e 6577 2041 7574 6f63 6f6e more new Autocon │ │ │ │ │ +00025480: 660a 2020 2020 206d 6163 726f 7320 6172 f. macros ar │ │ │ │ │ +00025490: 6520 7265 7175 6972 6564 2e20 2044 6973 e required. Dis │ │ │ │ │ +000254a0: 7472 6962 7574 696e 6720 7468 656d 2069 tributing them i │ │ │ │ │ +000254b0: 6e20 2761 636c 6f63 616c 2e6d 3427 2061 n 'aclocal.m4' a │ │ │ │ │ +000254c0: 6e64 0a20 2020 2020 7265 7175 6972 696e nd. requirin │ │ │ │ │ +000254d0: 6720 7065 6f70 6c65 2074 6f20 6272 6f77 g people to brow │ │ │ │ │ +000254e0: 7365 2074 6869 7320 6669 6c65 2074 6f20 se this file to │ │ │ │ │ +000254f0: 6578 7472 6163 7420 7468 6520 7265 6c65 extract the rele │ │ │ │ │ +00025500: 7661 6e74 206d 6163 726f 730a 2020 2020 vant macros. │ │ │ │ │ +00025510: 2062 6563 6f6d 6573 2075 6e63 6f6d 666f becomes uncomfo │ │ │ │ │ +00025520: 7274 6162 6c65 2e20 2049 6465 616c 6c79 rtable. Ideally │ │ │ │ │ +00025530: 2c20 736f 6d65 206f 6620 7468 656d 2073 , some of them s │ │ │ │ │ +00025540: 686f 756c 6420 6265 2063 6f6e 7472 6962 hould be contrib │ │ │ │ │ +00025550: 7574 6564 0a20 2020 2020 746f 2041 7574 uted. to Aut │ │ │ │ │ +00025560: 6f63 6f6e 6620 736f 2074 6861 7420 7468 oconf so that th │ │ │ │ │ +00025570: 6579 2063 616e 2062 6520 7573 6564 2064 ey can be used d │ │ │ │ │ +00025580: 6972 6563 746c 792c 2068 6f77 6576 6572 irectly, however │ │ │ │ │ +00025590: 2041 7574 6f63 6f6e 6620 6973 0a20 2020 Autoconf is. │ │ │ │ │ +000255a0: 2020 6375 7272 656e 746c 7920 696e 6163 currently inac │ │ │ │ │ +000255b0: 7469 7665 2e20 2041 7574 6f6d 616b 6520 tive. Automake │ │ │ │ │ +000255c0: 312e 3220 636f 6e73 6571 7565 6e74 6c79 1.2 consequently │ │ │ │ │ +000255d0: 2069 6e74 726f 6475 6365 7320 2761 636c introduces 'acl │ │ │ │ │ +000255e0: 6f63 616c 270a 2020 2020 2028 2761 636c ocal'. ('acl │ │ │ │ │ +000255f0: 6f63 616c 2720 7761 7320 6163 7475 616c ocal' was actual │ │ │ │ │ +00025600: 6c79 2073 7461 7274 6564 206f 6e20 3139 ly started on 19 │ │ │ │ │ +00025610: 3936 2d30 372d 3238 292c 2061 2074 6f6f 96-07-28), a too │ │ │ │ │ +00025620: 6c20 7468 6174 0a20 2020 2020 6175 746f l that. auto │ │ │ │ │ +00025630: 6d61 7469 6361 6c6c 7920 636f 6e73 7472 matically constr │ │ │ │ │ +00025640: 7563 7473 2061 6e20 2761 636c 6f63 616c ucts an 'aclocal │ │ │ │ │ +00025650: 2e6d 3427 2066 696c 6520 6672 6f6d 2061 .m4' file from a │ │ │ │ │ +00025660: 2072 6570 6f73 6974 6f72 7920 6f66 0a20 repository of. │ │ │ │ │ +00025670: 2020 2020 7468 6972 642d 7061 7274 7920 third-party │ │ │ │ │ +00025680: 6d61 6372 6f73 2e20 2042 6563 6175 7365 macros. Because │ │ │ │ │ +00025690: 2041 7574 6f63 6f6e 6620 6861 7320 7374 Autoconf has st │ │ │ │ │ +000256a0: 616c 6c65 642c 2041 7574 6f6d 616b 6520 alled, Automake │ │ │ │ │ +000256b0: 616c 736f 0a20 2020 2020 6265 636f 6d65 also. become │ │ │ │ │ +000256c0: 7320 6120 6b69 6e64 206f 6620 7265 706f s a kind of repo │ │ │ │ │ +000256d0: 7369 746f 7279 2066 6f72 2073 7563 6820 sitory for such │ │ │ │ │ +000256e0: 7468 6972 642d 7061 7274 7920 6d61 6372 third-party macr │ │ │ │ │ +000256f0: 6f73 2c20 6576 656e 0a20 2020 2020 6d61 os, even. ma │ │ │ │ │ +00025700: 6372 6f73 2063 6f6d 706c 6574 656c 7920 cros completely │ │ │ │ │ +00025710: 756e 7265 6c61 7465 6420 746f 2041 7574 unrelated to Aut │ │ │ │ │ +00025720: 6f6d 616b 6520 2866 6f72 2069 6e73 7461 omake (for insta │ │ │ │ │ +00025730: 6e63 6520 6d61 6372 6f73 2074 6861 740a nce macros that. │ │ │ │ │ +00025740: 2020 2020 2066 6978 2062 726f 6b65 6e20 fix broken │ │ │ │ │ +00025750: 4175 746f 636f 6e66 206d 6163 726f 7329 Autoconf macros) │ │ │ │ │ +00025760: 2e0a 0a20 2020 2020 5468 6520 312e 3220 ... The 1.2 │ │ │ │ │ +00025770: 7265 6c65 6173 6520 636f 6e74 6169 6e73 release contains │ │ │ │ │ +00025780: 2032 3020 6d61 6372 6f73 2c20 696e 636c 20 macros, incl │ │ │ │ │ +00025790: 7564 696e 6720 7468 650a 2020 2020 2027 uding the. ' │ │ │ │ │ +000257a0: 414d 5f49 4e49 545f 4155 544f 4d41 4b45 AM_INIT_AUTOMAKE │ │ │ │ │ +000257b0: 2720 6d61 6372 6f20 7468 6174 2073 696d ' macro that sim │ │ │ │ │ +000257c0: 706c 6966 6965 7320 7468 6520 6372 6561 plifies the crea │ │ │ │ │ +000257d0: 7469 6f6e 206f 660a 2020 2020 2027 636f tion of. 'co │ │ │ │ │ +000257e0: 6e66 6967 7572 652e 696e 272e 0a0a 2020 nfigure.in'... │ │ │ │ │ +000257f0: 2020 204c 6962 746f 6f6c 2069 7320 6675 Libtool is fu │ │ │ │ │ +00025800: 6c6c 7920 7375 7070 6f72 7465 6420 7573 lly supported us │ │ │ │ │ +00025810: 696e 6720 272a 5f4c 544c 4942 5241 5249 ing '*_LTLIBRARI │ │ │ │ │ +00025820: 4553 272e 0a0a 2020 2020 2054 6865 206d ES'... The m │ │ │ │ │ +00025830: 6973 7369 6e67 2073 6372 6970 7420 6973 issing script is │ │ │ │ │ +00025840: 2069 6e74 726f 6475 6365 6420 6279 2046 introduced by F │ │ │ │ │ +00025850: 7261 6ec3 a76f 6973 2050 696e 6172 643b ran..ois Pinard; │ │ │ │ │ +00025860: 2069 7420 6973 206d 6561 6e74 2074 6f0a it is meant to. │ │ │ │ │ +00025870: 2020 2020 2062 6520 6120 6265 7474 6572 be a better │ │ │ │ │ +00025880: 2073 6f6c 7574 696f 6e20 7468 616e 2027 solution than ' │ │ │ │ │ +00025890: 414d 5f4d 4149 4e54 4149 4e45 525f 4d4f AM_MAINTAINER_MO │ │ │ │ │ +000258a0: 4445 2720 282a 6e6f 7465 0a20 2020 2020 DE' (*note. │ │ │ │ │ +000258b0: 6d61 696e 7461 696e 6572 2d6d 6f64 653a maintainer-mode: │ │ │ │ │ +000258c0: 3a29 2e0a 0a20 2020 2020 436f 6e64 6974 :)... Condit │ │ │ │ │ +000258d0: 696f 6e61 6c73 2073 7570 706f 7274 2077 ionals support w │ │ │ │ │ +000258e0: 6173 2069 6d70 6c65 6d65 6e74 6564 2062 as implemented b │ │ │ │ │ +000258f0: 7920 4961 6e20 4c61 6e63 6520 5461 796c y Ian Lance Tayl │ │ │ │ │ +00025900: 6f72 2e20 2041 7420 7468 650a 2020 2020 or. At the. │ │ │ │ │ +00025910: 2074 696d 652c 2054 6f6d 2061 6e64 2049 time, Tom and I │ │ │ │ │ +00025920: 616e 2077 6572 6520 776f 726b 696e 6720 an were working │ │ │ │ │ +00025930: 6f6e 2061 6e20 696e 7465 726e 616c 2070 on an internal p │ │ │ │ │ +00025940: 726f 6a65 6374 2061 7420 4379 676e 7573 roject at Cygnus │ │ │ │ │ +00025950: 2e0a 2020 2020 2054 6865 7920 7765 7265 .. They were │ │ │ │ │ +00025960: 2075 7369 6e67 2049 4c55 2c20 7768 6963 using ILU, whic │ │ │ │ │ +00025970: 6820 6973 2070 7265 7474 7920 7369 6d69 h is pretty simi │ │ │ │ │ +00025980: 6c61 7220 746f 2043 4f52 4241 2e20 2054 lar to CORBA. T │ │ │ │ │ +00025990: 6865 7920 7761 6e74 6564 0a20 2020 2020 hey wanted. │ │ │ │ │ +000259a0: 746f 2069 6e74 6567 7261 7465 2049 4c55 to integrate ILU │ │ │ │ │ +000259b0: 2069 6e74 6f20 7468 6569 7220 6275 696c into their buil │ │ │ │ │ +000259c0: 642c 2077 6869 6368 2077 6173 2061 6c6c d, which was all │ │ │ │ │ +000259d0: 2027 636f 6e66 6967 7572 6527 2d62 6173 'configure'-bas │ │ │ │ │ +000259e0: 6564 2c0a 2020 2020 2061 6e64 2049 616e ed,. and Ian │ │ │ │ │ +000259f0: 2074 686f 7567 6874 2074 6861 7420 6164 thought that ad │ │ │ │ │ +00025a00: 6469 6e67 2063 6f6e 6469 7469 6f6e 616c ding conditional │ │ │ │ │ +00025a10: 7320 746f 2027 6175 746f 6d61 6b65 2720 s to 'automake' │ │ │ │ │ +00025a20: 7761 7320 7369 6d70 6c65 720a 2020 2020 was simpler. │ │ │ │ │ +00025a30: 2074 6861 6e20 646f 696e 6720 616c 6c20 than doing all │ │ │ │ │ +00025a40: 7468 6520 776f 726b 2069 6e20 2763 6f6e the work in 'con │ │ │ │ │ +00025a50: 6669 6775 7265 2720 2877 6869 6368 2077 figure' (which w │ │ │ │ │ +00025a60: 6173 2074 6865 2073 7461 6e64 6172 6420 as the standard │ │ │ │ │ +00025a70: 6174 0a20 2020 2020 7468 6520 7469 6d65 at. the time │ │ │ │ │ +00025a80: 292e 2020 536f 2074 6869 7320 7761 7320 ). So this was │ │ │ │ │ +00025a90: 6163 7475 616c 6c79 2066 756e 6465 6420 actually funded │ │ │ │ │ +00025aa0: 6279 2043 7967 6e75 732e 0a0a 2020 2020 by Cygnus... │ │ │ │ │ +00025ab0: 2054 6869 7320 7665 7279 2075 7365 6675 This very usefu │ │ │ │ │ +00025ac0: 6c20 6275 7420 7472 6963 6b79 2066 6561 l but tricky fea │ │ │ │ │ +00025ad0: 7475 7265 2077 696c 6c20 7461 6b65 2061 ture will take a │ │ │ │ │ +00025ae0: 206c 6f74 206f 6620 7469 6d65 2074 6f0a lot of time to. │ │ │ │ │ +00025af0: 2020 2020 2073 7461 6269 6c69 7a65 2e20 stabilize. │ │ │ │ │ +00025b00: 2028 4174 2074 6865 2074 696d 6520 7468 (At the time th │ │ │ │ │ +00025b10: 6973 2074 6578 7420 6973 2077 7269 7474 is text is writt │ │ │ │ │ +00025b20: 656e 2c20 7468 6572 6520 6172 6520 7374 en, there are st │ │ │ │ │ +00025b30: 696c 6c0a 2020 2020 2070 7269 6d61 7269 ill. primari │ │ │ │ │ +00025b40: 6573 2074 6861 7420 6861 7665 206e 6f74 es that have not │ │ │ │ │ +00025b50: 2062 6565 6e20 7570 6461 7465 6420 746f been updated to │ │ │ │ │ +00025b60: 2073 7570 706f 7274 2063 6f6e 6469 7469 support conditi │ │ │ │ │ +00025b70: 6f6e 616c 0a20 2020 2020 6465 6669 6e69 onal. defini │ │ │ │ │ +00025b80: 7469 6f6e 7320 696e 2041 7574 6f6d 616b tions in Automak │ │ │ │ │ +00025b90: 6520 312e 392e 290a 0a20 2020 2020 5468 e 1.9.).. Th │ │ │ │ │ +00025ba0: 6520 2761 7574 6f6d 616b 6527 2073 6372 e 'automake' scr │ │ │ │ │ +00025bb0: 6970 7420 6861 7320 616c 6d6f 7374 2064 ipt has almost d │ │ │ │ │ +00025bc0: 6f75 626c 6564 3a20 3630 3839 206c 696e oubled: 6089 lin │ │ │ │ │ +00025bd0: 6573 206f 6620 5065 726c 2c20 706c 7573 es of Perl, plus │ │ │ │ │ +00025be0: 0a20 2020 2020 3132 3934 206c 696e 6573 . 1294 lines │ │ │ │ │ +00025bf0: 206f 6620 274d 616b 6566 696c 6527 2066 of 'Makefile' f │ │ │ │ │ +00025c00: 7261 676d 656e 7473 2e0a 0a31 3939 372d ragments...1997- │ │ │ │ │ +00025c10: 3037 2d30 3820 476f 7264 6f6e 204d 6174 07-08 Gordon Mat │ │ │ │ │ +00025c20: 7a69 676b 6569 7420 7265 6c65 6173 6573 zigkeit releases │ │ │ │ │ +00025c30: 204c 6962 746f 6f6c 2031 2e30 2e0a 0a31 Libtool 1.0...1 │ │ │ │ │ +00025c40: 3939 382d 3034 2d30 3520 4175 746f 6d61 998-04-05 Automa │ │ │ │ │ +00025c50: 6b65 2031 2e33 0a0a 2020 2020 2054 6869 ke 1.3.. Thi │ │ │ │ │ +00025c60: 7320 6973 2061 2073 6d61 6c6c 2061 6476 s is a small adv │ │ │ │ │ +00025c70: 616e 6365 2063 6f6d 7061 7265 6420 746f ance compared to │ │ │ │ │ +00025c80: 2031 2e32 2e20 2049 7420 6164 6473 2073 1.2. It adds s │ │ │ │ │ +00025c90: 7570 706f 7274 2066 6f72 0a20 2020 2020 upport for. │ │ │ │ │ +00025ca0: 6173 7365 6d62 6c79 2c20 616e 6420 7072 assembly, and pr │ │ │ │ │ +00025cb0: 656c 696d 696e 6172 7920 7375 7070 6f72 eliminary suppor │ │ │ │ │ +00025cc0: 7420 666f 7220 4a61 7661 2e0a 0a20 2020 t for Java... │ │ │ │ │ +00025cd0: 2020 5065 726c 2035 2e30 3034 5f30 3420 Perl 5.004_04 │ │ │ │ │ +00025ce0: 6973 206f 7574 2c20 6275 7420 6669 7865 is out, but fixe │ │ │ │ │ +00025cf0: 7320 746f 2073 7570 706f 7274 2050 6572 s to support Per │ │ │ │ │ +00025d00: 6c20 3420 6172 6520 7374 696c 6c0a 2020 l 4 are still. │ │ │ │ │ +00025d10: 2020 2072 6567 756c 6172 6c79 2073 7562 regularly sub │ │ │ │ │ +00025d20: 6d69 7474 6564 2077 6865 6e65 7665 7220 mitted whenever │ │ │ │ │ +00025d30: 4175 746f 6d61 6b65 2062 7265 616b 7320 Automake breaks │ │ │ │ │ +00025d40: 6974 2e0a 0a31 3939 382d 3039 2d30 3620 it...1998-09-06 │ │ │ │ │ +00025d50: 2773 6f75 7263 6577 6172 652e 6379 676e 'sourceware.cygn │ │ │ │ │ +00025d60: 7573 2e63 6f6d 2720 6973 206f 6e2d 6c69 us.com' is on-li │ │ │ │ │ +00025d70: 6e65 2e0a 0a20 2020 2020 536f 7572 6365 ne... Source │ │ │ │ │ +00025d80: 7761 7265 2077 6173 2073 6574 7570 2062 ware was setup b │ │ │ │ │ +00025d90: 7920 4a61 736f 6e20 4d6f 6c65 6e64 6120 y Jason Molenda │ │ │ │ │ +00025da0: 746f 2068 6f73 7420 6f70 656e 2073 6f75 to host open sou │ │ │ │ │ +00025db0: 7263 6520 7072 6f6a 6563 7473 2e0a 0a31 rce projects...1 │ │ │ │ │ +00025dc0: 3939 382d 3039 2d31 3920 4175 746f 6d61 998-09-19 Automa │ │ │ │ │ +00025dd0: 6b65 2043 5653 2072 6570 6f73 6974 6f72 ke CVS repositor │ │ │ │ │ +00025de0: 7920 6d6f 7665 6420 746f 2027 736f 7572 y moved to 'sour │ │ │ │ │ +00025df0: 6365 7761 7265 2e63 7967 6e75 732e 636f ceware.cygnus.co │ │ │ │ │ +00025e00: 6d27 0a31 3939 382d 3130 2d32 3620 2773 m'.1998-10-26 's │ │ │ │ │ +00025e10: 6f75 7263 6577 6172 652e 6379 676e 7573 ourceware.cygnus │ │ │ │ │ +00025e20: 2e63 6f6d 2720 616e 6e6f 756e 6365 7320 .com' announces │ │ │ │ │ +00025e30: 6974 2068 6f73 7473 2041 7574 6f6d 616b it hosts Automak │ │ │ │ │ +00025e40: 653a 0a20 2020 2020 4175 746f 6d61 6b65 e:. Automake │ │ │ │ │ +00025e50: 2069 7320 6e6f 7720 686f 7374 6564 206f is now hosted o │ │ │ │ │ +00025e60: 6e20 2773 6f75 7263 6577 6172 652e 6379 n 'sourceware.cy │ │ │ │ │ +00025e70: 676e 7573 2e63 6f6d 272e 2020 4974 2068 gnus.com'. It h │ │ │ │ │ +00025e80: 6173 2061 0a20 2020 2020 7075 626c 6963 as a. public │ │ │ │ │ +00025e90: 6c79 2061 6363 6573 7369 626c 6520 4356 ly accessible CV │ │ │ │ │ +00025ea0: 5320 7265 706f 7369 746f 7279 2e20 2054 S repository. T │ │ │ │ │ +00025eb0: 6869 7320 4356 5320 7265 706f 7369 746f his CVS reposito │ │ │ │ │ +00025ec0: 7279 2069 7320 6120 636f 7079 0a20 2020 ry is a copy. │ │ │ │ │ +00025ed0: 2020 6f66 2074 6865 206f 6e65 2054 6f6d of the one Tom │ │ │ │ │ +00025ee0: 2077 6173 2075 7369 6e67 206f 6e20 6869 was using on hi │ │ │ │ │ +00025ef0: 7320 6d61 6368 696e 652c 2077 6869 6368 s machine, which │ │ │ │ │ +00025f00: 2069 6e20 7475 726e 2069 7320 6261 7365 in turn is base │ │ │ │ │ +00025f10: 6420 6f6e 0a20 2020 2020 6120 636f 7079 d on. a copy │ │ │ │ │ +00025f20: 206f 6620 7468 6520 4356 5320 7265 706f of the CVS repo │ │ │ │ │ +00025f30: 7369 746f 7279 206f 6620 4461 7669 6420 sitory of David │ │ │ │ │ +00025f40: 4d61 634b 656e 7a69 652e 2020 5468 6973 MacKenzie. This │ │ │ │ │ +00025f50: 2069 7320 7768 7920 7765 0a20 2020 2020 is why we. │ │ │ │ │ +00025f60: 7374 696c 6c20 6861 7665 2074 6f20 6675 still have to fu │ │ │ │ │ +00025f70: 6c6c 2073 6f75 7263 6520 6869 7374 6f72 ll source histor │ │ │ │ │ +00025f80: 792e 2020 2841 7574 6f6d 616b 6520 7761 y. (Automake wa │ │ │ │ │ +00025f90: 7320 6f6e 2053 6f75 7263 6577 6172 650a s on Sourceware. │ │ │ │ │ +00025fa0: 2020 2020 2075 6e74 696c 2032 3030 372d until 2007- │ │ │ │ │ +00025fb0: 3130 2d32 392c 2077 6865 6e20 6974 206d 10-29, when it m │ │ │ │ │ +00025fc0: 6f76 6564 2074 6f20 6120 6769 7420 7265 oved to a git re │ │ │ │ │ +00025fd0: 706f 7369 746f 7279 206f 6e0a 2020 2020 pository on. │ │ │ │ │ +00025fe0: 2027 7361 7661 6e6e 6168 2e67 6e75 2e6f 'savannah.gnu.o │ │ │ │ │ +00025ff0: 7267 272c 2062 7574 2074 6865 2053 6f75 rg', but the Sou │ │ │ │ │ +00026000: 7263 6577 6172 6520 686f 7374 2068 6164 rceware host had │ │ │ │ │ +00026010: 2062 6565 6e20 7265 6e61 6d65 6420 746f been renamed to │ │ │ │ │ +00026020: 0a20 2020 2020 2773 6f75 7263 6573 2e72 . 'sources.r │ │ │ │ │ +00026030: 6564 6861 742e 636f 6d27 2e29 0a0a 2020 edhat.com'.).. │ │ │ │ │ +00026040: 2020 2054 6865 206f 6c64 6573 7420 6669 The oldest fi │ │ │ │ │ +00026050: 6c65 2069 6e20 7468 6520 6164 6d69 6e69 le in the admini │ │ │ │ │ +00026060: 7374 7261 7469 7665 2064 6972 6563 746f strative directo │ │ │ │ │ +00026070: 7279 206f 6620 7468 6520 4356 530a 2020 ry of the CVS. │ │ │ │ │ +00026080: 2020 2072 6570 6f73 6974 6f72 7920 7468 repository th │ │ │ │ │ +00026090: 6174 2077 6173 2063 7265 6174 6564 206f at was created o │ │ │ │ │ +000260a0: 6e20 536f 7572 6365 7761 7265 2069 7320 n Sourceware is │ │ │ │ │ +000260b0: 6461 7465 6420 3139 3938 2d30 392d 3139 dated 1998-09-19 │ │ │ │ │ +000260c0: 2c0a 2020 2020 2077 6869 6c65 2074 6865 ,. while the │ │ │ │ │ +000260d0: 2061 6e6e 6f75 6e63 656d 656e 7420 7468 announcement th │ │ │ │ │ +000260e0: 6174 2027 6175 746f 6d61 6b65 2720 616e at 'automake' an │ │ │ │ │ +000260f0: 6420 2761 7574 6f63 6f6e 6627 2068 6164 d 'autoconf' had │ │ │ │ │ +00026100: 206a 6f69 6e65 640a 2020 2020 2027 736f joined. 'so │ │ │ │ │ +00026110: 7572 6365 7761 7265 2720 7761 7320 6d61 urceware' was ma │ │ │ │ │ +00026120: 6465 206f 6e20 3139 3938 2d31 302d 3236 de on 1998-10-26 │ │ │ │ │ +00026130: 2e20 2054 6865 7920 7765 7265 2061 6d6f . They were amo │ │ │ │ │ +00026140: 6e67 2074 6865 2066 6972 7374 0a20 2020 ng the first. │ │ │ │ │ +00026150: 2020 7072 6f6a 6563 7473 2074 6f20 6265 projects to be │ │ │ │ │ +00026160: 2068 6f73 7465 6420 7468 6572 652e 0a0a hosted there... │ │ │ │ │ +00026170: 2020 2020 2054 6865 2068 6565 6466 756c The heedful │ │ │ │ │ +00026180: 2072 6561 6465 7220 7769 6c6c 2068 6176 reader will hav │ │ │ │ │ +00026190: 6520 6e6f 7469 6365 6420 4175 746f 6d61 e noticed Automa │ │ │ │ │ +000261a0: 6b65 2077 6173 2065 7861 6374 6c79 2034 ke was exactly 4 │ │ │ │ │ +000261b0: 2079 6561 7273 0a20 2020 2020 6f6c 6420 years. old │ │ │ │ │ +000261c0: 6f6e 2031 3939 382d 3039 2d31 392e 0a0a on 1998-09-19... │ │ │ │ │ +000261d0: 3139 3939 2d30 312d 3035 2042 656e 2045 1999-01-05 Ben E │ │ │ │ │ +000261e0: 6c6c 6973 746f 6e20 7265 6c65 6173 6573 lliston releases │ │ │ │ │ +000261f0: 2041 7574 6f63 6f6e 6620 322e 3133 2e0a Autoconf 2.13.. │ │ │ │ │ +00026200: 0a31 3939 392d 3031 2d31 3420 4175 746f .1999-01-14 Auto │ │ │ │ │ +00026210: 6d61 6b65 2031 2e34 0a0a 2020 2020 2054 make 1.4.. T │ │ │ │ │ +00026220: 6869 7320 7265 6c65 6173 6520 6164 6473 his release adds │ │ │ │ │ +00026230: 2073 7570 706f 7274 2066 6f72 2046 6f72 support for For │ │ │ │ │ +00026240: 7472 616e 2037 3720 616e 6420 666f 7220 tran 77 and for │ │ │ │ │ +00026250: 7468 6520 2769 6e63 6c75 6465 270a 2020 the 'include'. │ │ │ │ │ +00026260: 2020 2073 7461 7465 6d65 6e74 2e20 2041 statement. A │ │ │ │ │ +00026270: 6c73 6f2c 2027 2b3d 2720 6173 7369 676e lso, '+=' assign │ │ │ │ │ +00026280: 6d65 6e74 7320 6172 6520 696e 7472 6f64 ments are introd │ │ │ │ │ +00026290: 7563 6564 2c20 6275 7420 6974 2069 7320 uced, but it is │ │ │ │ │ +000262a0: 7374 696c 6c0a 2020 2020 2071 7569 7465 still. quite │ │ │ │ │ +000262b0: 2065 6173 7920 746f 2066 6f6f 6c20 4175 easy to fool Au │ │ │ │ │ +000262c0: 746f 6d61 6b65 2077 6865 6e20 6d69 7869 tomake when mixi │ │ │ │ │ +000262d0: 6e67 2074 6869 7320 7769 7468 2063 6f6e ng this with con │ │ │ │ │ +000262e0: 6469 7469 6f6e 616c 732e 0a0a 2020 2020 ditionals... │ │ │ │ │ +000262f0: 2054 6865 7365 2074 776f 2072 656c 6561 These two relea │ │ │ │ │ +00026300: 7365 732c 2041 7574 6f6d 616b 6520 312e ses, Automake 1. │ │ │ │ │ +00026310: 3420 616e 6420 4175 746f 636f 6e66 2032 4 and Autoconf 2 │ │ │ │ │ +00026320: 2e31 3320 6d61 6b65 2061 2064 756f 2074 .13 make a duo t │ │ │ │ │ +00026330: 6861 740a 2020 2020 2077 696c 6c20 6265 hat. will be │ │ │ │ │ +00026340: 2075 7365 6420 746f 6765 7468 6572 2066 used together f │ │ │ │ │ +00026350: 6f72 2079 6561 7273 2e0a 0a20 2020 2020 or years... │ │ │ │ │ +00026360: 2761 7574 6f6d 616b 6527 2069 7320 3732 'automake' is 72 │ │ │ │ │ +00026370: 3238 206c 696e 6573 2c20 706c 7573 2031 28 lines, plus 1 │ │ │ │ │ +00026380: 3539 3120 6c69 6e65 7320 6f66 204d 616b 591 lines of Mak │ │ │ │ │ +00026390: 6566 696c 6520 6672 6167 6d65 6e74 2c20 efile fragment, │ │ │ │ │ +000263a0: 3230 0a20 2020 2020 6d61 6372 6f73 2028 20. macros ( │ │ │ │ │ +000263b0: 736f 6d65 2031 2e33 206d 6163 726f 7320 some 1.3 macros │ │ │ │ │ +000263c0: 7765 7265 2066 696e 616c 6c79 2063 6f6e were finally con │ │ │ │ │ +000263d0: 7472 6962 7574 6564 2062 6163 6b20 746f tributed back to │ │ │ │ │ +000263e0: 2041 7574 6f63 6f6e 6629 2c0a 2020 2020 Autoconf),. │ │ │ │ │ +000263f0: 2031 3937 2074 6573 7420 6361 7365 732c 197 test cases, │ │ │ │ │ +00026400: 2061 6e64 2035 3120 7061 6765 7320 6f66 and 51 pages of │ │ │ │ │ +00026410: 2064 6f63 756d 656e 7461 7469 6f6e 2e0a documentation.. │ │ │ │ │ +00026420: 0a31 3939 392d 3033 2d32 3720 5468 6520 .1999-03-27 The │ │ │ │ │ +00026430: 2775 7365 722d 6465 702d 6272 616e 6368 'user-dep-branch │ │ │ │ │ +00026440: 2720 6973 2063 7265 6174 6564 206f 6e20 ' is created on │ │ │ │ │ +00026450: 7468 6520 4356 5320 7265 706f 7369 746f the CVS reposito │ │ │ │ │ +00026460: 7279 2e0a 0a20 2020 2020 5468 6973 2069 ry... This i │ │ │ │ │ +00026470: 6d70 6c65 6d65 6e74 7320 6120 6e65 7720 mplements a new │ │ │ │ │ +00026480: 6465 7065 6e64 656e 6379 2074 7261 636b dependency track │ │ │ │ │ +00026490: 696e 6720 7363 6865 6d65 6420 7468 6174 ing schemed that │ │ │ │ │ +000264a0: 2073 686f 756c 6420 6265 0a20 2020 2020 should be. │ │ │ │ │ +000264b0: 6162 6c65 2074 6f20 6861 6e64 6c65 2061 able to handle a │ │ │ │ │ +000264c0: 7574 6f6d 6174 6963 2064 6570 656e 6465 utomatic depende │ │ │ │ │ +000264d0: 6e63 7920 7472 6163 6b69 6e67 2075 7369 ncy tracking usi │ │ │ │ │ +000264e0: 6e67 2061 6e79 2063 6f6d 7069 6c65 720a ng any compiler. │ │ │ │ │ +000264f0: 2020 2020 2028 6e6f 7420 6a75 7374 2067 (not just g │ │ │ │ │ +00026500: 6363 2920 616e 6420 616e 7920 6d61 6b65 cc) and any make │ │ │ │ │ +00026510: 2028 6e6f 7420 6a75 7374 2047 4e55 2027 (not just GNU ' │ │ │ │ │ +00026520: 6d61 6b65 2729 2e20 2049 6e20 6164 6469 make'). In addi │ │ │ │ │ +00026530: 7469 6f6e 2c0a 2020 2020 2074 6865 206e tion,. the n │ │ │ │ │ +00026540: 6577 2073 6368 656d 6520 7368 6f75 6c64 ew scheme should │ │ │ │ │ +00026550: 2062 6520 6d6f 7265 2072 656c 6961 626c be more reliabl │ │ │ │ │ +00026560: 6520 7468 616e 2074 6865 206f 6c64 206f e than the old o │ │ │ │ │ +00026570: 6e65 2c20 6173 0a20 2020 2020 6465 7065 ne, as. depe │ │ │ │ │ +00026580: 6e64 656e 6369 6573 2061 7265 2067 656e ndencies are gen │ │ │ │ │ +00026590: 6572 6174 6564 206f 6e20 7468 6520 656e erated on the en │ │ │ │ │ +000265a0: 6420 7573 6572 2773 206d 6163 6869 6e65 d user's machine │ │ │ │ │ +000265b0: 2e20 2041 6c65 7861 6e64 7265 0a20 2020 . Alexandre. │ │ │ │ │ +000265c0: 2020 4f6c 6976 6120 6372 6561 7465 7320 Oliva creates │ │ │ │ │ +000265d0: 6465 7063 6f6d 7020 666f 7220 7468 6973 depcomp for this │ │ │ │ │ +000265e0: 2070 7572 706f 7365 2e0a 0a20 2020 2020 purpose... │ │ │ │ │ +000265f0: 2a4e 6f74 6520 4465 7065 6e64 656e 6379 *Note Dependency │ │ │ │ │ +00026600: 2054 7261 636b 696e 6720 4576 6f6c 7574 Tracking Evolut │ │ │ │ │ +00026610: 696f 6e3a 3a2c 2066 6f72 206d 6f72 6520 ion::, for more │ │ │ │ │ +00026620: 6465 7461 696c 7320 6162 6f75 7420 7468 details about th │ │ │ │ │ +00026630: 650a 2020 2020 2065 766f 6c75 7469 6f6e e. evolution │ │ │ │ │ +00026640: 206f 6620 6175 746f 6d61 7469 6320 6465 of automatic de │ │ │ │ │ +00026650: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ +00026660: 6720 696e 2041 7574 6f6d 616b 652e 0a0a g in Automake... │ │ │ │ │ +00026670: 3139 3939 2d31 312d 3231 2054 6865 2027 1999-11-21 The ' │ │ │ │ │ +00026680: 7573 6572 2d64 6570 2d62 7261 6e63 6827 user-dep-branch' │ │ │ │ │ +00026690: 2069 7320 6d65 7267 6564 2069 6e74 6f20 is merged into │ │ │ │ │ +000266a0: 7468 6520 6d61 696e 2074 7275 6e6b 2e0a the main trunk.. │ │ │ │ │ +000266b0: 0a20 2020 2020 5468 6973 2077 6173 2061 . This was a │ │ │ │ │ +000266c0: 2068 7567 6520 7072 6f62 6c65 6d20 7369 huge problem si │ │ │ │ │ +000266d0: 6e63 6520 7765 2061 6c73 6f20 6861 6420 nce we also had │ │ │ │ │ +000266e0: 7061 7463 6865 7320 676f 696e 6720 696e patches going in │ │ │ │ │ +000266f0: 206f 6e20 7468 650a 2020 2020 2074 7275 on the. tru │ │ │ │ │ +00026700: 6e6b 2e20 2054 6865 206d 6572 6765 2074 nk. The merge t │ │ │ │ │ +00026710: 6f6f 6b20 6120 6c6f 6e67 2074 696d 6520 ook a long time │ │ │ │ │ +00026720: 616e 6420 7761 7320 7665 7279 2070 6169 and was very pai │ │ │ │ │ +00026730: 6e66 756c 2e0a 0a32 3030 302d 3035 2d31 nful...2000-05-1 │ │ │ │ │ +00026740: 300a 0a20 2020 2020 5369 6e63 6520 5365 0.. Since Se │ │ │ │ │ +00026750: 7074 656d 6265 7220 3139 3939 2061 6e64 ptember 1999 and │ │ │ │ │ +00026760: 2075 6e74 696c 2032 3030 332c 2041 6b69 until 2003, Aki │ │ │ │ │ +00026770: 6d20 4465 6d61 696c 6c65 2077 696c 6c20 m Demaille will │ │ │ │ │ +00026780: 6265 0a20 2020 2020 7a65 616c 6f75 736c be. zealousl │ │ │ │ │ +00026790: 7920 7265 7661 6d70 696e 6720 4175 746f y revamping Auto │ │ │ │ │ +000267a0: 636f 6e66 2e0a 0a20 2020 2020 2020 2020 conf... │ │ │ │ │ +000267b0: 2049 2074 6869 6e6b 2074 6865 206e 6578 I think the nex │ │ │ │ │ +000267c0: 7420 7265 6c65 6173 6520 7368 6f75 6c64 t release should │ │ │ │ │ +000267d0: 2062 6520 6361 6c6c 6564 2022 332e 3022 be called "3.0" │ │ │ │ │ +000267e0: 2e0a 2020 2020 2020 2020 2020 4c65 7427 .. Let' │ │ │ │ │ +000267f0: 7320 6661 6365 2069 743a 2079 6f75 2776 s face it: you'v │ │ │ │ │ +00026800: 6520 6261 7369 6361 6c6c 7920 7265 7772 e basically rewr │ │ │ │ │ +00026810: 6974 7465 6e20 6175 746f 636f 6e66 2e0a itten autoconf.. │ │ │ │ │ +00026820: 2020 2020 2020 2020 2020 4576 6572 7920 Every │ │ │ │ │ +00026830: 7765 656b 656e 6420 7468 6572 6520 6172 weekend there ar │ │ │ │ │ +00026840: 6520 3330 206e 6577 2070 6174 6368 6573 e 30 new patches │ │ │ │ │ +00026850: 2e0a 2020 2020 2020 2020 2020 4920 646f .. I do │ │ │ │ │ +00026860: 6e27 7420 7365 6520 686f 7720 7765 2063 n't see how we c │ │ │ │ │ +00026870: 6f75 6c64 2063 616c 6c20 7468 6973 2022 ould call this " │ │ │ │ │ +00026880: 322e 3135 2220 7769 7468 2061 2073 7472 2.15" with a str │ │ │ │ │ +00026890: 6169 6768 740a 2020 2020 2020 2020 2020 aight. │ │ │ │ │ +000268a0: 6661 6365 2e0a 2020 2020 2020 2020 2020 face.. │ │ │ │ │ +000268b0: 2d20 546f 6d20 5472 6f6d 6579 206f 6e20 - Tom Tromey on │ │ │ │ │ +000268c0: 3c61 7574 6f63 6f6e 6640 676e 752e 6f72 .. Actuall │ │ │ │ │ +000268e0: 7920 416b 696d 2077 6f72 6b73 206c 696b y Akim works lik │ │ │ │ │ +000268f0: 6520 6120 7375 626d 6172 696e 653a 2068 e a submarine: h │ │ │ │ │ +00026900: 6520 7769 6c6c 2070 696c 6520 7570 2070 e will pile up p │ │ │ │ │ +00026910: 6174 6368 6573 2077 6869 6c65 0a20 2020 atches while. │ │ │ │ │ +00026920: 2020 6865 2077 6f72 6b73 206f 6666 2d6c he works off-l │ │ │ │ │ +00026930: 696e 6520 6475 7269 6e67 2074 6865 2077 ine during the w │ │ │ │ │ +00026940: 6565 6b65 6e64 2c20 616e 6420 666c 7573 eekend, and flus │ │ │ │ │ +00026950: 6820 7468 656d 2069 6e20 6261 7463 6820 h them in batch │ │ │ │ │ +00026960: 7768 656e 0a20 2020 2020 6865 2072 6573 when. he res │ │ │ │ │ +00026970: 7572 6661 6365 7320 6f6e 204d 6f6e 6461 urfaces on Monda │ │ │ │ │ +00026980: 792e 0a0a 3230 3031 2d30 312d 3234 0a0a y...2001-01-24.. │ │ │ │ │ +00026990: 2020 2020 204f 6e20 7468 6973 2057 6564 On this Wed │ │ │ │ │ +000269a0: 6e65 7364 6179 2c20 4175 746f 636f 6e66 nesday, Autoconf │ │ │ │ │ +000269b0: 2032 2e34 3963 2c20 7468 6520 6c61 7374 2.49c, the last │ │ │ │ │ +000269c0: 2062 6574 6120 6265 666f 7265 2041 7574 beta before Aut │ │ │ │ │ +000269d0: 6f63 6f6e 660a 2020 2020 2032 2e35 3020 oconf. 2.50 │ │ │ │ │ +000269e0: 6973 206f 7574 2c20 616e 6420 416b 696d is out, and Akim │ │ │ │ │ +000269f0: 2068 6173 2074 6f20 6669 6e64 2073 6f6d has to find som │ │ │ │ │ +00026a00: 6574 6869 6e67 2074 6f20 646f 2064 7572 ething to do dur │ │ │ │ │ +00026a10: 696e 6720 6869 730a 2020 2020 2077 6565 ing his. wee │ │ │ │ │ +00026a20: 6b2d 656e 6420 3a29 0a0a 3230 3031 2d30 k-end :)..2001-0 │ │ │ │ │ +00026a30: 312d 3238 0a0a 2020 2020 2041 6b69 6d20 1-28.. Akim │ │ │ │ │ +00026a40: 7365 6e64 7320 6120 6261 7463 6820 6f66 sends a batch of │ │ │ │ │ +00026a50: 2031 3420 7061 7463 6865 7320 746f 203c 14 patches to < │ │ │ │ │ +00026a60: 6175 746f 6d61 6b65 4067 6e75 2e6f 7267 automake@gnu.org │ │ │ │ │ +00026a70: 3e2e 0a0a 2020 2020 2020 2020 2020 4169 >... Ai │ │ │ │ │ +00026a80: 6965 6565 6521 2020 4920 7761 7320 6472 ieeee! I was dr │ │ │ │ │ +00026a90: 6561 6469 6e67 2074 6865 2064 6179 2074 eading the day t │ │ │ │ │ +00026aa0: 6861 7420 7468 6520 4465 6d61 696c 6c61 hat the Demailla │ │ │ │ │ +00026ab0: 746f 7220 7475 726e 6564 0a20 2020 2020 tor turned. │ │ │ │ │ +00026ac0: 2020 2020 2068 6973 2073 6967 6874 7320 his sights │ │ │ │ │ +00026ad0: 6f6e 2061 7574 6f6d 616b 652e 2e2e 2061 on automake... a │ │ │ │ │ +00026ae0: 6e64 206e 6f77 2069 7420 6861 7320 6172 nd now it has ar │ │ │ │ │ +00026af0: 7269 7665 6421 2020 2d20 546f 6d0a 2020 rived! - Tom. │ │ │ │ │ +00026b00: 2020 2020 2020 2020 5472 6f6d 6579 0a0a Tromey.. │ │ │ │ │ +00026b10: 2020 2020 2049 7427 7320 6f6e 6c79 2074 It's only t │ │ │ │ │ +00026b20: 6865 2062 6567 696e 6e69 6e67 3a20 696e he beginning: in │ │ │ │ │ +00026b30: 2074 776f 206d 6f6e 7468 7320 6865 2077 two months he w │ │ │ │ │ +00026b40: 696c 6c20 7365 6e64 2031 3932 2070 6174 ill send 192 pat │ │ │ │ │ +00026b50: 6368 6573 2e0a 2020 2020 2054 6865 6e20 ches.. Then │ │ │ │ │ +00026b60: 6865 2077 6f75 6c64 2073 6c6f 7720 646f he would slow do │ │ │ │ │ +00026b70: 776e 2073 6f20 546f 6d20 6361 6e20 6361 wn so Tom can ca │ │ │ │ │ +00026b80: 7463 6820 7570 2061 6e64 2072 6576 6965 tch up and revie │ │ │ │ │ +00026b90: 7720 616c 6c20 7468 6973 2e0a 2020 2020 w all this.. │ │ │ │ │ +00026ba0: 2049 6e69 7469 616c 6c79 2054 6f6d 2061 Initially Tom a │ │ │ │ │ +00026bb0: 6374 7561 6c6c 7920 7265 6164 2061 6c6c ctually read all │ │ │ │ │ +00026bc0: 2074 6865 7365 2070 6174 6368 6573 2c20 these patches, │ │ │ │ │ +00026bd0: 7468 656e 2068 6520 7072 6f62 6162 6c79 then he probably │ │ │ │ │ +00026be0: 0a20 2020 2020 7472 7573 7469 6e67 6c79 . trustingly │ │ │ │ │ +00026bf0: 2061 6e73 7765 7265 6420 4f4b 2074 6f20 answered OK to │ │ │ │ │ +00026c00: 6d6f 7374 206f 6620 7468 656d 2c20 616e most of them, an │ │ │ │ │ +00026c10: 6420 6669 6e61 6c6c 7920 6761 7665 2075 d finally gave u │ │ │ │ │ +00026c20: 7020 616e 6420 6c65 740a 2020 2020 2041 p and let. A │ │ │ │ │ +00026c30: 6b69 6d20 6170 706c 7920 7768 6174 6576 kim apply whatev │ │ │ │ │ +00026c40: 6572 2068 6520 7761 6e74 6564 2e20 2054 er he wanted. T │ │ │ │ │ +00026c50: 6865 7265 2077 6173 206e 6f20 7761 7920 here was no way │ │ │ │ │ +00026c60: 746f 206b 6565 7020 7570 2077 6974 680a to keep up with. │ │ │ │ │ +00026c70: 2020 2020 2074 6861 7420 7061 7463 6820 that patch │ │ │ │ │ +00026c80: 7261 7465 2e0a 0a20 2020 2020 2020 2020 rate... │ │ │ │ │ +00026c90: 2041 6e79 7761 7920 7468 6520 7061 7463 Anyway the patc │ │ │ │ │ +00026ca0: 6820 6265 6c6f 7720 776f 6e27 7420 6170 h below won't ap │ │ │ │ │ +00026cb0: 706c 7920 7369 6e63 6520 6974 2070 7265 ply since it pre │ │ │ │ │ +00026cc0: 6461 7465 7320 416b 696d 2773 0a20 2020 dates Akim's. │ │ │ │ │ +00026cd0: 2020 2020 2020 2073 6f75 7263 6571 7561 sourcequa │ │ │ │ │ +00026ce0: 6b65 3b20 4920 6861 7665 2079 6574 2074 ke; I have yet t │ │ │ │ │ +00026cf0: 6f20 6669 6775 7265 2077 6865 7265 2074 o figure where t │ │ │ │ │ +00026d00: 6865 2072 656c 6576 616e 7420 7061 7373 he relevant pass │ │ │ │ │ +00026d10: 6167 650a 2020 2020 2020 2020 2020 6861 age. ha │ │ │ │ │ +00026d20: 7320 6265 656e 206d 6f76 6564 203a 2920 s been moved :) │ │ │ │ │ +00026d30: 2d20 416c 6578 616e 6472 6520 4475 7265 - Alexandre Dure │ │ │ │ │ +00026d40: 742d 4c75 747a 0a0a 2020 2020 2041 6c6c t-Lutz.. All │ │ │ │ │ +00026d50: 2074 6865 7365 2070 6174 6368 6573 2077 these patches w │ │ │ │ │ +00026d60: 6572 6520 7365 6e74 2074 6f20 616e 6420 ere sent to and │ │ │ │ │ +00026d70: 6469 7363 7573 7365 6420 6f6e 203c 6175 discussed on , │ │ │ │ │ +00026d90: 0a20 2020 2020 736f 2073 7562 7363 7269 . so subscri │ │ │ │ │ +00026da0: 6265 6420 7573 6572 7320 7765 7265 206c bed users were l │ │ │ │ │ +00026db0: 6974 6572 616c 6c79 2064 726f 776e 696e iterally drownin │ │ │ │ │ +00026dc0: 6720 696e 2074 6563 686e 6963 616c 206d g in technical m │ │ │ │ │ +00026dd0: 6169 6c73 2e0a 2020 2020 2045 7665 6e74 ails.. Event │ │ │ │ │ +00026de0: 7561 6c6c 792c 2074 6865 203c 6175 746f ually, the mailing li │ │ │ │ │ +00026e10: 7374 2077 6173 2063 7265 6174 6564 0a20 st was created. │ │ │ │ │ +00026e20: 2020 2020 696e 204d 6179 2e0a 0a20 2020 in May... │ │ │ │ │ +00026e30: 2020 5965 6172 2061 6674 6572 2079 6561 Year after yea │ │ │ │ │ +00026e40: 722c 2041 7574 6f6d 616b 6520 6861 6420 r, Automake had │ │ │ │ │ +00026e50: 6472 6966 7465 6420 6177 6179 2066 726f drifted away fro │ │ │ │ │ +00026e60: 6d20 6974 7320 696e 6974 6961 6c20 6465 m its initial de │ │ │ │ │ +00026e70: 7369 676e 3a0a 2020 2020 2063 6f6e 7374 sign:. const │ │ │ │ │ +00026e80: 7275 6374 2027 4d61 6b65 6669 6c65 2e69 ruct 'Makefile.i │ │ │ │ │ +00026e90: 6e27 2062 7920 6173 7365 6d62 6c69 6e67 n' by assembling │ │ │ │ │ +00026ea0: 2076 6172 696f 7573 2027 4d61 6b65 6669 various 'Makefi │ │ │ │ │ +00026eb0: 6c65 2720 6672 6167 6d65 6e74 732e 0a20 le' fragments.. │ │ │ │ │ +00026ec0: 2020 2020 496e 2031 2e34 2c20 6c6f 7473 In 1.4, lots │ │ │ │ │ +00026ed0: 206f 6620 274d 616b 6566 696c 6527 2072 of 'Makefile' r │ │ │ │ │ +00026ee0: 756c 6573 2061 7265 2062 6569 6e67 2065 ules are being e │ │ │ │ │ +00026ef0: 6d69 7474 6564 2061 7420 7661 7269 6f75 mitted at variou │ │ │ │ │ +00026f00: 730a 2020 2020 2070 6c61 6365 7320 696e s. places in │ │ │ │ │ +00026f10: 2074 6865 2027 6175 746f 6d61 6b65 2720 the 'automake' │ │ │ │ │ +00026f20: 7363 7269 7074 2069 7473 656c 663b 2074 script itself; t │ │ │ │ │ +00026f30: 6869 7320 646f 6573 206e 6f74 2068 656c his does not hel │ │ │ │ │ +00026f40: 7020 656e 7375 7269 6e67 0a20 2020 2020 p ensuring. │ │ │ │ │ +00026f50: 6120 636f 6e73 6973 7465 6e74 2074 7265 a consistent tre │ │ │ │ │ +00026f60: 6174 6d65 6e74 206f 6620 7468 6573 6520 atment of these │ │ │ │ │ +00026f70: 7275 6c65 7320 2866 6f72 2069 6e73 7461 rules (for insta │ │ │ │ │ +00026f80: 6e63 6520 6d61 6b69 6e67 2073 7572 650a nce making sure. │ │ │ │ │ +00026f90: 2020 2020 2074 6861 7420 7573 6572 2d64 that user-d │ │ │ │ │ +00026fa0: 6566 696e 6564 2072 756c 6573 206f 7665 efined rules ove │ │ │ │ │ +00026fb0: 7272 6964 6520 4175 746f 6d61 6b65 2773 rride Automake's │ │ │ │ │ +00026fc0: 206f 776e 2072 756c 6573 292e 2020 4f6e own rules). On │ │ │ │ │ +00026fd0: 6520 6f66 0a20 2020 2020 416b 696d 2773 e of. Akim's │ │ │ │ │ +00026fe0: 2067 6f61 6c20 7761 7320 6d6f 7669 6e67 goal was moving │ │ │ │ │ +00026ff0: 2061 6c6c 2074 6865 7365 2068 6172 642d all these hard- │ │ │ │ │ +00027000: 636f 6465 6420 7275 6c65 7320 746f 2073 coded rules to s │ │ │ │ │ +00027010: 6570 6172 6174 650a 2020 2020 2027 4d61 eparate. 'Ma │ │ │ │ │ +00027020: 6b65 6669 6c65 2720 6672 6167 6d65 6e74 kefile' fragment │ │ │ │ │ +00027030: 732c 2073 6f20 7468 6520 6c6f 6769 6320 s, so the logic │ │ │ │ │ +00027040: 636f 756c 6420 6265 2063 656e 7472 616c could be central │ │ │ │ │ +00027050: 697a 6564 2069 6e20 610a 2020 2020 2027 ized in a. ' │ │ │ │ │ +00027060: 4d61 6b65 6669 6c65 2720 6672 6167 6d65 Makefile' fragme │ │ │ │ │ +00027070: 6e74 2070 726f 6365 7373 6f72 2e0a 0a20 nt processor... │ │ │ │ │ +00027080: 2020 2020 416e 6f74 6865 7220 7369 676e Another sign │ │ │ │ │ +00027090: 6966 6963 616e 7420 636f 6e74 7269 6275 ificant contribu │ │ │ │ │ +000270a0: 7469 6f6e 206f 6620 416b 696d 2069 7320 tion of Akim is │ │ │ │ │ +000270b0: 7468 6520 696e 7465 7266 6163 6520 7769 the interface wi │ │ │ │ │ +000270c0: 7468 2074 6865 0a20 2020 2020 2274 7261 th the. "tra │ │ │ │ │ +000270d0: 6365 2220 6665 6174 7572 6520 6f66 2041 ce" feature of A │ │ │ │ │ +000270e0: 7574 6f63 6f6e 662e 2020 5468 6520 7761 utoconf. The wa │ │ │ │ │ +000270f0: 7920 746f 2073 6361 6e20 2763 6f6e 6669 y to scan 'confi │ │ │ │ │ +00027100: 6775 7265 2e69 6e27 2061 740a 2020 2020 gure.in' at. │ │ │ │ │ +00027110: 2074 6869 7320 7469 6d65 2077 6173 2074 this time was t │ │ │ │ │ +00027120: 6f20 7265 6164 2074 6865 2066 696c 6520 o read the file │ │ │ │ │ +00027130: 616e 6420 6772 6570 2074 6865 2076 6172 and grep the var │ │ │ │ │ +00027140: 696f 7573 206d 6163 726f 206f 660a 2020 ious macro of. │ │ │ │ │ +00027150: 2020 2069 6e74 6572 6573 7420 746f 2041 interest to A │ │ │ │ │ +00027160: 7574 6f6d 616b 652e 2020 446f 696e 6720 utomake. Doing │ │ │ │ │ +00027170: 736f 2063 6f75 6c64 2062 7265 616b 2069 so could break i │ │ │ │ │ +00027180: 6e20 6d61 6e79 2075 6e65 7870 6563 7465 n many unexpecte │ │ │ │ │ +00027190: 640a 2020 2020 2077 6179 733b 2027 6175 d. ways; 'au │ │ │ │ │ +000271a0: 746f 6d61 6b65 2720 636f 756c 6420 6d69 tomake' could mi │ │ │ │ │ +000271b0: 7373 2073 6f6d 6520 6465 6669 6e69 7469 ss some definiti │ │ │ │ │ +000271c0: 6f6e 2028 666f 7220 696e 7374 616e 6365 on (for instance │ │ │ │ │ +000271d0: 0a20 2020 2020 2741 435f 5355 4253 5428 . 'AC_SUBST( │ │ │ │ │ +000271e0: 5b24 315d 2c20 5b24 325d 2927 2077 6865 [$1], [$2])' whe │ │ │ │ │ +000271f0: 7265 2074 6865 2061 7267 756d 656e 7473 re the arguments │ │ │ │ │ +00027200: 2061 7265 206b 6e6f 776e 206f 6e6c 7920 are known only │ │ │ │ │ +00027210: 7768 656e 204d 340a 2020 2020 2069 7320 when M4. is │ │ │ │ │ +00027220: 7275 6e29 2c20 6f72 2063 6f6e 7665 7273 run), or convers │ │ │ │ │ +00027230: 656c 7920 6974 2063 6f75 6c64 2064 6574 ely it could det │ │ │ │ │ +00027240: 6563 7420 736f 6d65 206d 6163 726f 2074 ect some macro t │ │ │ │ │ +00027250: 6861 7420 7761 7320 6e6f 740a 2020 2020 hat was not. │ │ │ │ │ +00027260: 2065 7870 616e 6465 6420 2862 6563 6175 expanded (becau │ │ │ │ │ +00027270: 7365 2069 7420 6973 2063 616c 6c65 6420 se it is called │ │ │ │ │ +00027280: 636f 6e64 6974 696f 6e61 6c6c 7929 2e20 conditionally). │ │ │ │ │ +00027290: 2049 6e20 7468 6520 4356 5320 7665 7273 In the CVS vers │ │ │ │ │ +000272a0: 696f 6e0a 2020 2020 206f 6620 4175 746f ion. of Auto │ │ │ │ │ +000272b0: 636f 6e66 2c20 416b 696d 2068 6164 2069 conf, Akim had i │ │ │ │ │ +000272c0: 6d70 6c65 6d65 6e74 6564 2074 6865 2027 mplemented the ' │ │ │ │ │ +000272d0: 2d2d 7472 6163 6527 206f 7074 696f 6e2c --trace' option, │ │ │ │ │ +000272e0: 2077 6869 6368 0a20 2020 2020 7072 6f76 which. prov │ │ │ │ │ +000272f0: 6964 6573 2061 6363 7572 6174 6520 696e ides accurate in │ │ │ │ │ +00027300: 666f 726d 6174 696f 6e20 6162 6f75 7420 formation about │ │ │ │ │ +00027310: 7768 6572 6520 6d61 6372 6f73 2061 7265 where macros are │ │ │ │ │ +00027320: 2061 6374 7561 6c6c 790a 2020 2020 2063 actually. c │ │ │ │ │ +00027330: 616c 6c65 6420 616e 6420 7769 7468 2077 alled and with w │ │ │ │ │ +00027340: 6861 7420 6172 6775 6d65 6e74 732e 2020 hat arguments. │ │ │ │ │ +00027350: 416b 696d 2077 696c 6c20 6571 7569 7020 Akim will equip │ │ │ │ │ +00027360: 4175 746f 6d61 6b65 2077 6974 6820 610a Automake with a. │ │ │ │ │ +00027370: 2020 2020 2073 6563 6f6e 6420 2763 6f6e second 'con │ │ │ │ │ +00027380: 6669 6775 7265 2e69 6e27 2073 6361 6e6e figure.in' scann │ │ │ │ │ +00027390: 6572 2074 6861 7420 7573 6573 2074 6869 er that uses thi │ │ │ │ │ +000273a0: 7320 272d 2d74 7261 6365 2720 696e 7465 s '--trace' inte │ │ │ │ │ +000273b0: 7266 6163 652e 0a20 2020 2020 5369 6e63 rface.. Sinc │ │ │ │ │ +000273c0: 6520 6974 2077 6173 206e 6f74 2073 656e e it was not sen │ │ │ │ │ +000273d0: 7369 626c 6520 746f 2064 726f 7020 7468 sible to drop th │ │ │ │ │ +000273e0: 6520 4175 746f 636f 6e66 2032 2e31 3320 e Autoconf 2.13 │ │ │ │ │ +000273f0: 636f 6d70 6174 6962 696c 6974 790a 2020 compatibility. │ │ │ │ │ +00027400: 2020 2079 6574 2c20 7468 6973 2065 7870 yet, this exp │ │ │ │ │ +00027410: 6572 696d 656e 7461 6c20 7363 616e 6e65 erimental scanne │ │ │ │ │ +00027420: 7220 7761 7320 6f6e 6c79 2075 7365 6420 r was only used │ │ │ │ │ +00027430: 7768 656e 2061 6e20 656e 7669 726f 6e6d when an environm │ │ │ │ │ +00027440: 656e 740a 2020 2020 2076 6172 6961 626c ent. variabl │ │ │ │ │ +00027450: 6520 7761 7320 7365 742c 2074 6865 2074 e was set, the t │ │ │ │ │ +00027460: 7261 6469 7469 6f6e 616c 2067 7265 702d raditional grep- │ │ │ │ │ +00027470: 7363 616e 6e65 7220 6265 696e 6720 7374 scanner being st │ │ │ │ │ +00027480: 696c 6c20 7468 650a 2020 2020 2064 6566 ill the. def │ │ │ │ │ +00027490: 6175 6c74 2e0a 0a32 3030 312d 3034 2d32 ault...2001-04-2 │ │ │ │ │ +000274a0: 3520 4761 7279 2056 2e20 5661 7567 6861 5 Gary V. Vaugha │ │ │ │ │ +000274b0: 6e20 7265 6c65 6173 6573 204c 6962 746f n releases Libto │ │ │ │ │ +000274c0: 6f6c 2031 2e34 0a0a 2020 2020 2049 7420 ol 1.4.. It │ │ │ │ │ +000274d0: 6861 7320 6265 656e 206d 6f72 6520 7468 has been more th │ │ │ │ │ +000274e0: 616e 2074 776f 2079 6561 7273 2073 696e an two years sin │ │ │ │ │ +000274f0: 6365 2041 7574 6f6d 616b 6520 312e 342c ce Automake 1.4, │ │ │ │ │ +00027500: 2043 5653 2041 7574 6f6d 616b 650a 2020 CVS Automake. │ │ │ │ │ +00027510: 2020 2068 6173 2073 7566 6665 7265 6420 has suffered │ │ │ │ │ +00027520: 6c6f 7427 7320 6f66 2068 6561 7679 2063 lot's of heavy c │ │ │ │ │ +00027530: 6861 6e67 6573 2061 6e64 2073 7469 6c6c hanges and still │ │ │ │ │ +00027540: 2069 7320 6e6f 7420 7265 6164 7920 666f is not ready fo │ │ │ │ │ +00027550: 720a 2020 2020 2072 656c 6561 7365 2e20 r. release. │ │ │ │ │ +00027560: 204c 6962 746f 6f6c 2031 2e34 2068 6164 Libtool 1.4 had │ │ │ │ │ +00027570: 2074 6f20 6265 2064 6973 7472 6962 7574 to be distribut │ │ │ │ │ +00027580: 6564 2077 6974 6820 6120 7061 7463 6820 ed with a patch │ │ │ │ │ +00027590: 6167 6169 6e73 740a 2020 2020 2041 7574 against. Aut │ │ │ │ │ +000275a0: 6f6d 616b 6520 312e 342e 0a0a 3230 3031 omake 1.4...2001 │ │ │ │ │ +000275b0: 2d30 352d 3038 2041 7574 6f6d 616b 6520 -05-08 Automake │ │ │ │ │ +000275c0: 312e 342d 7031 0a32 3030 312d 3035 2d32 1.4-p1.2001-05-2 │ │ │ │ │ +000275d0: 3420 4175 746f 6d61 6b65 2031 2e34 2d70 4 Automake 1.4-p │ │ │ │ │ +000275e0: 320a 0a20 2020 2020 4761 7279 2056 2e20 2.. Gary V. │ │ │ │ │ +000275f0: 5661 7567 6861 6e2c 2074 6865 2070 7269 Vaughan, the pri │ │ │ │ │ +00027600: 6e63 6970 616c 204c 6962 746f 6f6c 206d ncipal Libtool m │ │ │ │ │ +00027610: 6169 6e74 6169 6e65 722c 206d 616b 6573 aintainer, makes │ │ │ │ │ +00027620: 2061 2022 7061 7463 680a 2020 2020 2072 a "patch. r │ │ │ │ │ +00027630: 656c 6561 7365 2220 6f66 2041 7574 6f6d elease" of Autom │ │ │ │ │ +00027640: 616b 653a 0a0a 2020 2020 2020 2020 2020 ake:.. │ │ │ │ │ +00027650: 5468 6520 6d61 696e 2070 7572 706f 7365 The main purpose │ │ │ │ │ +00027660: 206f 6620 7468 6973 2072 656c 6561 7365 of this release │ │ │ │ │ +00027670: 2069 7320 746f 2068 6176 6520 6120 7374 is to have a st │ │ │ │ │ +00027680: 6162 6c65 2061 7574 6f6d 616b 650a 2020 able automake. │ │ │ │ │ +00027690: 2020 2020 2020 2020 7768 6963 6820 6973 which is │ │ │ │ │ +000276a0: 2063 6f6d 7061 7469 626c 6520 7769 7468 compatible with │ │ │ │ │ +000276b0: 2074 6865 206c 6174 6573 7420 7374 6162 the latest stab │ │ │ │ │ +000276c0: 6c65 206c 6962 746f 6f6c 2e0a 0a20 2020 le libtool... │ │ │ │ │ +000276d0: 2020 5468 6520 7265 6c65 6173 6520 616c The release al │ │ │ │ │ +000276e0: 736f 2063 6f6e 7461 696e 7320 6f62 7669 so contains obvi │ │ │ │ │ +000276f0: 6f75 7320 6669 7865 7320 666f 7220 6275 ous fixes for bu │ │ │ │ │ +00027700: 6773 2069 6e20 4175 746f 6d61 6b65 2031 gs in Automake 1 │ │ │ │ │ +00027710: 2e34 2c0a 2020 2020 2073 6f6d 6520 6f66 .4,. some of │ │ │ │ │ +00027720: 2077 6869 6368 2077 6572 6520 7265 706f which were repo │ │ │ │ │ +00027730: 7274 6564 2061 6c6d 6f73 7420 6d6f 6e74 rted almost mont │ │ │ │ │ +00027740: 686c 792e 0a0a 3230 3031 2d30 352d 3231 hly...2001-05-21 │ │ │ │ │ +00027750: 2041 6b69 6d20 4465 6d61 696c 6c65 2072 Akim Demaille r │ │ │ │ │ +00027760: 656c 6561 7365 7320 4175 746f 636f 6e66 eleases Autoconf │ │ │ │ │ +00027770: 2032 2e35 300a 0a32 3030 312d 3036 2d30 2.50..2001-06-0 │ │ │ │ │ +00027780: 3720 4175 746f 6d61 6b65 2031 2e34 2d70 7 Automake 1.4-p │ │ │ │ │ +00027790: 330a 3230 3031 2d30 362d 3130 2041 7574 3.2001-06-10 Aut │ │ │ │ │ +000277a0: 6f6d 616b 6520 312e 342d 7034 0a32 3030 omake 1.4-p4.200 │ │ │ │ │ +000277b0: 312d 3037 2d31 3520 4175 746f 6d61 6b65 1-07-15 Automake │ │ │ │ │ +000277c0: 2031 2e34 2d70 350a 0a20 2020 2020 4761 1.4-p5.. Ga │ │ │ │ │ +000277d0: 7279 2063 6f6e 7469 6e75 6573 2068 6973 ry continues his │ │ │ │ │ +000277e0: 2070 6174 6368 2d72 656c 6561 7365 2073 patch-release s │ │ │ │ │ +000277f0: 6572 6965 732e 2020 5468 6573 6520 616c eries. These al │ │ │ │ │ +00027800: 736f 2061 6464 2073 7570 706f 7274 0a20 so add support. │ │ │ │ │ +00027810: 2020 2020 666f 7220 736f 6d65 206e 6577 for some new │ │ │ │ │ +00027820: 2041 7574 6f63 6f6e 6620 322e 3530 2069 Autoconf 2.50 i │ │ │ │ │ +00027830: 6469 6f6d 732e 2020 4573 7365 6e74 6961 dioms. Essentia │ │ │ │ │ +00027840: 6c6c 792c 2041 7574 6f63 6f6e 6620 6e6f lly, Autoconf no │ │ │ │ │ +00027850: 770a 2020 2020 2061 6476 6f63 6174 6573 w. advocates │ │ │ │ │ +00027860: 2027 636f 6e66 6967 7572 652e 6163 2720 'configure.ac' │ │ │ │ │ +00027870: 6f76 6572 2027 636f 6e66 6967 7572 652e over 'configure. │ │ │ │ │ +00027880: 696e 272c 2061 6e64 2069 7420 696e 7472 in', and it intr │ │ │ │ │ +00027890: 6f64 7563 6573 2061 0a20 2020 2020 6e65 oduces a. ne │ │ │ │ │ +000278a0: 7720 7379 6e74 6178 2066 6f72 2027 4143 w syntax for 'AC │ │ │ │ │ +000278b0: 5f4f 5554 5055 5427 696e 6720 6669 6c65 _OUTPUT'ing file │ │ │ │ │ +000278c0: 732e 0a0a 3230 3031 2d30 382d 3233 2041 s...2001-08-23 A │ │ │ │ │ +000278d0: 7574 6f6d 616b 6520 312e 350a 0a20 2020 utomake 1.5.. │ │ │ │ │ +000278e0: 2020 4120 6d61 6a6f 7220 616e 6420 6c6f A major and lo │ │ │ │ │ +000278f0: 6e67 2d61 7761 6974 6564 2072 656c 6561 ng-awaited relea │ │ │ │ │ +00027900: 7365 2c20 7468 6174 2063 6f6d 6573 206d se, that comes m │ │ │ │ │ +00027910: 6f72 6520 7468 616e 2074 776f 2079 6561 ore than two yea │ │ │ │ │ +00027920: 7273 0a20 2020 2020 6166 7465 7220 312e rs. after 1. │ │ │ │ │ +00027930: 342e 2020 4974 2062 7269 6e67 7320 6d61 4. It brings ma │ │ │ │ │ +00027940: 6e79 2063 6861 6e67 6573 2c20 616d 6f6e ny changes, amon │ │ │ │ │ +00027950: 6720 7768 6963 683a 0a20 2020 2020 2020 g which:. │ │ │ │ │ +00027960: 202a 2054 6865 206e 6577 2064 6570 656e * The new depen │ │ │ │ │ +00027970: 6465 6e63 7920 7472 6163 6b69 6e67 2073 dency tracking s │ │ │ │ │ +00027980: 6368 656d 6520 7468 6174 2075 7365 7320 cheme that uses │ │ │ │ │ +00027990: 2764 6570 636f 6d70 272e 2020 4173 6964 'depcomp'. Asid │ │ │ │ │ +000279a0: 650a 2020 2020 2020 2020 2020 6672 6f6d e. from │ │ │ │ │ +000279b0: 2074 6865 2069 6d70 726f 7665 6d65 6e74 the improvement │ │ │ │ │ +000279c0: 206f 6e20 7468 6520 6465 7065 6e64 656e on the dependen │ │ │ │ │ +000279d0: 6379 2074 7261 636b 696e 6720 6974 7365 cy tracking itse │ │ │ │ │ +000279e0: 6c66 2028 2a6e 6f74 650a 2020 2020 2020 lf (*note. │ │ │ │ │ +000279f0: 2020 2020 4465 7065 6e64 656e 6379 2054 Dependency T │ │ │ │ │ +00027a00: 7261 636b 696e 6720 4576 6f6c 7574 696f racking Evolutio │ │ │ │ │ +00027a10: 6e3a 3a29 2c20 7468 6973 2061 6c73 6f20 n::), this also │ │ │ │ │ +00027a20: 7374 7265 616d 6c69 6e65 7320 7468 650a streamlines the. │ │ │ │ │ +00027a30: 2020 2020 2020 2020 2020 7573 6520 6f66 use of │ │ │ │ │ +00027a40: 2027 6175 746f 6d61 6b65 272d 6765 6e65 'automake'-gene │ │ │ │ │ +00027a50: 7261 7465 6420 274d 616b 6566 696c 652e rated 'Makefile. │ │ │ │ │ +00027a60: 696e 2773 2061 7320 7468 650a 2020 2020 in's as the. │ │ │ │ │ +00027a70: 2020 2020 2020 274d 616b 6566 696c 652e 'Makefile. │ │ │ │ │ +00027a80: 696e 2773 2075 7365 6420 6475 7269 6e67 in's used during │ │ │ │ │ +00027a90: 2064 6576 656c 6f70 6d65 6e74 2061 7265 development are │ │ │ │ │ +00027aa0: 206e 6f77 2074 6865 2073 616d 6520 6173 now the same as │ │ │ │ │ +00027ab0: 0a20 2020 2020 2020 2020 2074 686f 7365 . those │ │ │ │ │ +00027ac0: 2075 7365 6420 696e 2064 6973 7472 6962 used in distrib │ │ │ │ │ +00027ad0: 7574 696f 6e73 2e20 2042 6566 6f72 6520 utions. Before │ │ │ │ │ +00027ae0: 7468 6174 2074 6865 2027 4d61 6b65 6669 that the 'Makefi │ │ │ │ │ +00027af0: 6c65 2e69 6e27 730a 2020 2020 2020 2020 le.in's. │ │ │ │ │ +00027b00: 2020 6765 6e65 7261 7465 6420 666f 7220 generated for │ │ │ │ │ +00027b10: 6d61 696e 7461 696e 6572 7320 7265 7175 maintainers requ │ │ │ │ │ +00027b20: 6972 6564 2047 4e55 2027 6d61 6b65 2720 ired GNU 'make' │ │ │ │ │ +00027b30: 616e 6420 4743 432c 2074 6865 790a 2020 and GCC, they. │ │ │ │ │ +00027b40: 2020 2020 2020 2020 7765 7265 2064 6966 were dif │ │ │ │ │ +00027b50: 6665 7265 6e74 2066 726f 6d20 7468 6520 ferent from the │ │ │ │ │ +00027b60: 706f 7274 6162 6c65 2027 4d61 6b65 6669 portable 'Makefi │ │ │ │ │ +00027b70: 6c65 2720 6765 6e65 7261 7465 6420 666f le' generated fo │ │ │ │ │ +00027b80: 720a 2020 2020 2020 2020 2020 6469 7374 r. dist │ │ │ │ │ +00027b90: 7269 6275 7469 6f6e 3b20 7468 6973 2077 ribution; this w │ │ │ │ │ +00027ba0: 6173 2063 6175 7369 6e67 2073 6f6d 6520 as causing some │ │ │ │ │ +00027bb0: 636f 6e66 7573 696f 6e2e 0a0a 2020 2020 confusion... │ │ │ │ │ +00027bc0: 2020 2020 2a20 5375 7070 6f72 7420 666f * Support fo │ │ │ │ │ +00027bd0: 7220 7065 722d 7461 7267 6574 2063 6f6d r per-target com │ │ │ │ │ +00027be0: 7069 6c61 7469 6f6e 2066 6c61 6773 2e0a pilation flags.. │ │ │ │ │ +00027bf0: 0a20 2020 2020 2020 202a 2053 7570 706f . * Suppo │ │ │ │ │ +00027c00: 7274 2066 6f72 2072 6566 6572 656e 6365 rt for reference │ │ │ │ │ +00027c10: 2074 6f20 6669 6c65 7320 696e 2073 7562 to files in sub │ │ │ │ │ +00027c20: 6469 7265 6374 6f72 6965 7320 696e 206d directories in m │ │ │ │ │ +00027c30: 6f73 740a 2020 2020 2020 2020 2020 274d ost. 'M │ │ │ │ │ +00027c40: 616b 6566 696c 652e 616d 2720 7661 7269 akefile.am' vari │ │ │ │ │ +00027c50: 6162 6c65 732e 0a0a 2020 2020 2020 2020 ables... │ │ │ │ │ +00027c60: 2a20 496e 7472 6f64 7563 7469 6f6e 206f * Introduction o │ │ │ │ │ +00027c70: 6620 7468 6520 2764 6973 745f 272c 2027 f the 'dist_', ' │ │ │ │ │ +00027c80: 6e6f 6469 7374 5f27 2c20 616e 6420 276e nodist_', and 'n │ │ │ │ │ +00027c90: 6f62 6173 655f 270a 2020 2020 2020 2020 obase_'. │ │ │ │ │ +00027ca0: 2020 7072 6566 6978 6573 2e0a 2020 2020 prefixes.. │ │ │ │ │ +00027cb0: 2020 2020 2a20 5065 726c 2034 2073 7570 * Perl 4 sup │ │ │ │ │ +00027cc0: 706f 7274 2069 7320 6669 6e61 6c6c 7920 port is finally │ │ │ │ │ +00027cd0: 6472 6f70 7065 642e 0a0a 2020 2020 2031 dropped... 1 │ │ │ │ │ +00027ce0: 2e35 2064 6964 2062 7265 616b 2073 6576 .5 did break sev │ │ │ │ │ +00027cf0: 6572 616c 2070 6163 6b61 6765 7320 7468 eral packages th │ │ │ │ │ +00027d00: 6174 2077 6f72 6b65 6420 7769 7468 2031 at worked with 1 │ │ │ │ │ +00027d10: 2e34 2e20 2045 6e6f 7567 6820 736f 0a20 .4. Enough so. │ │ │ │ │ +00027d20: 2020 2020 7468 6174 204c 696e 7578 2064 that Linux d │ │ │ │ │ +00027d30: 6973 7472 6962 7574 696f 6e73 2063 6f75 istributions cou │ │ │ │ │ +00027d40: 6c64 206e 6f74 2065 6173 696c 7920 696e ld not easily in │ │ │ │ │ +00027d50: 7374 616c 6c20 7468 6520 6e65 7720 4175 stall the new Au │ │ │ │ │ +00027d60: 746f 6d61 6b65 0a20 2020 2020 7665 7273 tomake. vers │ │ │ │ │ +00027d70: 696f 6e20 7769 7468 6f75 7420 6272 6561 ion without brea │ │ │ │ │ +00027d80: 6b69 6e67 206d 616e 7920 6f66 2074 6865 king many of the │ │ │ │ │ +00027d90: 2070 6163 6b61 6765 7320 666f 7220 7768 packages for wh │ │ │ │ │ +00027da0: 6963 6820 7468 6579 2068 6164 2074 6f0a ich they had to. │ │ │ │ │ +00027db0: 2020 2020 2072 756e 2027 6175 746f 6d61 run 'automa │ │ │ │ │ +00027dc0: 6b65 272e 0a0a 2020 2020 2053 6f6d 6520 ke'... Some │ │ │ │ │ +00027dd0: 6f66 2074 6865 7365 2062 7265 616b 6167 of these breakag │ │ │ │ │ +00027de0: 6573 2077 6572 6520 6566 6665 6374 6976 es were effectiv │ │ │ │ │ +00027df0: 656c 7920 6275 6773 2074 6861 7420 776f ely bugs that wo │ │ │ │ │ +00027e00: 756c 6420 6576 656e 7475 616c 6c79 0a20 uld eventually. │ │ │ │ │ +00027e10: 2020 2020 6265 2066 6978 6564 2069 6e20 be fixed in │ │ │ │ │ +00027e20: 7468 6520 6e65 7874 2072 656c 6561 7365 the next release │ │ │ │ │ +00027e30: 2e20 2048 6f77 6576 6572 2c20 6120 6c6f . However, a lo │ │ │ │ │ +00027e40: 7420 6f66 2064 616d 6167 6520 7761 7320 t of damage was │ │ │ │ │ +00027e50: 6361 7573 6564 0a20 2020 2020 6279 2073 caused. by s │ │ │ │ │ +00027e60: 6f6d 6520 6368 616e 6765 7320 6d61 6465 ome changes made │ │ │ │ │ +00027e70: 2064 656c 6962 6572 6174 656c 7920 746f deliberately to │ │ │ │ │ +00027e80: 2072 656e 6465 7220 4175 746f 6d61 6b65 render Automake │ │ │ │ │ +00027e90: 2073 7472 6963 7465 7220 6f6e 0a20 2020 stricter on. │ │ │ │ │ +00027ea0: 2020 736f 6d65 2073 6574 7570 2077 6520 some setup we │ │ │ │ │ +00027eb0: 6469 6420 636f 6e73 6964 6572 2062 6f67 did consider bog │ │ │ │ │ +00027ec0: 7573 2e20 2046 6f72 2069 6e73 7461 6e63 us. For instanc │ │ │ │ │ +00027ed0: 652c 2027 6d61 6b65 2064 6973 7463 6865 e, 'make distche │ │ │ │ │ +00027ee0: 636b 270a 2020 2020 2077 6173 2069 6d70 ck'. was imp │ │ │ │ │ +00027ef0: 726f 7665 6420 746f 2063 6865 636b 2074 roved to check t │ │ │ │ │ +00027f00: 6861 7420 276d 616b 6520 756e 696e 7374 hat 'make uninst │ │ │ │ │ +00027f10: 616c 6c27 2064 6964 2072 656d 6f76 6520 all' did remove │ │ │ │ │ +00027f20: 616c 6c20 7468 650a 2020 2020 2066 696c all the. fil │ │ │ │ │ +00027f30: 6573 2027 6d61 6b65 2069 6e73 7461 6c6c es 'make install │ │ │ │ │ +00027f40: 2720 696e 7374 616c 6c65 642c 2074 6861 ' installed, tha │ │ │ │ │ +00027f50: 7420 276d 616b 6520 6469 7374 636c 6561 t 'make distclea │ │ │ │ │ +00027f60: 6e27 2064 6964 206e 6f74 206f 6d69 740a n' did not omit. │ │ │ │ │ +00027f70: 2020 2020 2073 6f6d 6520 6669 6c65 2c20 some file, │ │ │ │ │ +00027f80: 616e 6420 7468 6174 2061 2056 5041 5448 and that a VPATH │ │ │ │ │ +00027f90: 2062 7569 6c64 2077 6f75 6c64 2077 6f72 build would wor │ │ │ │ │ +00027fa0: 6b20 6576 656e 2069 6620 7468 6520 736f k even if the so │ │ │ │ │ +00027fb0: 7572 6365 0a20 2020 2020 6469 7265 6374 urce. direct │ │ │ │ │ +00027fc0: 6f72 7920 7761 7320 7265 6164 2d6f 6e6c ory was read-onl │ │ │ │ │ +00027fd0: 792e 2020 5369 6d69 6c61 726c 792c 2041 y. Similarly, A │ │ │ │ │ +00027fe0: 7574 6f6d 616b 6520 6e6f 7720 7265 6a65 utomake now reje │ │ │ │ │ +00027ff0: 6374 7320 6d75 6c74 6970 6c65 0a20 2020 cts multiple. │ │ │ │ │ +00028000: 2020 6465 6669 6e69 7469 6f6e 7320 6f66 definitions of │ │ │ │ │ +00028010: 2074 6865 2073 616d 6520 7661 7269 6162 the same variab │ │ │ │ │ +00028020: 6c65 2028 6265 6361 7573 6520 7468 6174 le (because that │ │ │ │ │ +00028030: 2077 6f75 6c64 206d 6978 2076 6572 7920 would mix very │ │ │ │ │ +00028040: 6261 646c 790a 2020 2020 2077 6974 6820 badly. with │ │ │ │ │ +00028050: 636f 6e64 6974 696f 6e61 6c73 292c 2061 conditionals), a │ │ │ │ │ +00028060: 6e64 2027 2b3d 2720 6173 7369 676e 6d65 nd '+=' assignme │ │ │ │ │ +00028070: 6e74 7320 7769 7468 206e 6f20 7072 6576 nts with no prev │ │ │ │ │ +00028080: 696f 7573 0a20 2020 2020 6465 6669 6e69 ious. defini │ │ │ │ │ +00028090: 7469 6f6e 2e20 2042 6563 6175 7365 2074 tion. Because t │ │ │ │ │ +000280a0: 6865 7365 2063 6861 6e67 6573 2061 6c6c hese changes all │ │ │ │ │ +000280b0: 206f 6363 7572 7265 6420 7375 6464 656e occurred sudden │ │ │ │ │ +000280c0: 6c79 2061 6674 6572 2031 2e34 0a20 2020 ly after 1.4. │ │ │ │ │ +000280d0: 2020 6861 6420 6265 656e 2065 7374 6162 had been estab │ │ │ │ │ +000280e0: 6c69 7368 6564 2066 6f72 206d 6f72 6520 lished for more │ │ │ │ │ +000280f0: 7468 616e 2074 776f 2079 6561 7273 2c20 than two years, │ │ │ │ │ +00028100: 6974 2068 7572 7420 7573 6572 732e 0a0a it hurt users... │ │ │ │ │ +00028110: 2020 2020 2054 6f20 6d61 6b65 206d 6174 To make mat │ │ │ │ │ +00028120: 7465 7220 776f 7273 652c 206d 6561 6e77 ter worse, meanw │ │ │ │ │ +00028130: 6869 6c65 2041 7574 6f63 6f6e 6620 286e hile Autoconf (n │ │ │ │ │ +00028140: 6f77 2061 7420 7665 7273 696f 6e20 322e ow at version 2. │ │ │ │ │ +00028150: 3532 2920 7761 730a 2020 2020 2066 6163 52) was. fac │ │ │ │ │ +00028160: 696e 6720 7369 6d69 6c61 7220 7472 6f75 ing similar trou │ │ │ │ │ +00028170: 626c 6573 2c20 666f 7220 7369 6d69 6c61 bles, for simila │ │ │ │ │ +00028180: 7220 7265 6173 6f6e 732e 0a0a 3230 3032 r reasons...2002 │ │ │ │ │ +00028190: 2d30 332d 3035 2041 7574 6f6d 616b 6520 -03-05 Automake │ │ │ │ │ +000281a0: 312e 360a 0a20 2020 2020 5468 6973 2072 1.6.. This r │ │ │ │ │ +000281b0: 656c 6561 7365 2069 6e74 726f 6475 6365 elease introduce │ │ │ │ │ +000281c0: 6420 7665 7273 696f 6e65 6420 696e 7374 d versioned inst │ │ │ │ │ +000281d0: 616c 6c61 7469 6f6e 2028 2a6e 6f74 6520 allation (*note │ │ │ │ │ +000281e0: 4150 490a 2020 2020 2056 6572 7369 6f6e API. Version │ │ │ │ │ +000281f0: 696e 673a 3a29 2e20 2054 6869 7320 7761 ing::). This wa │ │ │ │ │ +00028200: 7320 6d61 696e 6c79 2070 7573 6865 6420 s mainly pushed │ │ │ │ │ +00028210: 6279 2048 6176 6f63 2050 656e 6e69 6e67 by Havoc Penning │ │ │ │ │ +00028220: 746f 6e2c 2074 616b 696e 670a 2020 2020 ton, taking. │ │ │ │ │ +00028230: 2074 6865 2047 4e4f 4d45 2073 6f75 7263 the GNOME sourc │ │ │ │ │ +00028240: 6520 7472 6565 2061 7320 6d6f 7469 7665 e tree as motive │ │ │ │ │ +00028250: 3a20 6475 6520 746f 2069 6e63 6f6d 7061 : due to incompa │ │ │ │ │ +00028260: 7469 6269 6c69 7469 6573 2062 6574 7765 tibilities betwe │ │ │ │ │ +00028270: 656e 0a20 2020 2020 7468 6520 6175 746f en. the auto │ │ │ │ │ +00028280: 746f 6f6c 7320 6974 2773 2069 6d70 6f73 tools it's impos │ │ │ │ │ +00028290: 7369 626c 6520 666f 7220 7468 6520 474e sible for the GN │ │ │ │ │ +000282a0: 4f4d 4520 7061 636b 6167 6573 2074 6f20 OME packages to │ │ │ │ │ +000282b0: 7377 6974 6368 2074 6f0a 2020 2020 2041 switch to. A │ │ │ │ │ +000282c0: 7574 6f63 6f6e 6620 322e 3533 2061 6e64 utoconf 2.53 and │ │ │ │ │ +000282d0: 2041 7574 6f6d 616b 6520 312e 3520 616c Automake 1.5 al │ │ │ │ │ +000282e0: 6c20 6174 206f 6e63 652c 2073 6f20 7468 l at once, so th │ │ │ │ │ +000282f0: 6579 2061 7265 2063 7572 7265 6e74 6c79 ey are currently │ │ │ │ │ +00028300: 0a20 2020 2020 7374 7563 6b20 7769 7468 . stuck with │ │ │ │ │ +00028310: 2041 7574 6f63 6f6e 6620 322e 3133 2061 Autoconf 2.13 a │ │ │ │ │ +00028320: 6e64 2041 7574 6f6d 616b 6520 312e 342e nd Automake 1.4. │ │ │ │ │ +00028330: 0a0a 2020 2020 2054 6865 2069 6465 6120 .. The idea │ │ │ │ │ +00028340: 7761 7320 746f 2063 616c 6c20 7468 6973 was to call this │ │ │ │ │ +00028350: 2076 6572 7369 6f6e 2027 6175 746f 6d61 version 'automa │ │ │ │ │ +00028360: 6b65 2d31 2e36 272c 2063 616c 6c20 616c ke-1.6', call al │ │ │ │ │ +00028370: 6c20 6974 730a 2020 2020 2062 7567 2d66 l its. bug-f │ │ │ │ │ +00028380: 6978 2076 6572 7369 6f6e 7320 6964 656e ix versions iden │ │ │ │ │ +00028390: 7469 6361 6c6c 792c 2061 6e64 2073 7769 tically, and swi │ │ │ │ │ +000283a0: 7463 6820 746f 2027 6175 746f 6d61 6b65 tch to 'automake │ │ │ │ │ +000283b0: 2d31 2e37 2720 666f 7220 7468 650a 2020 -1.7' for the. │ │ │ │ │ +000283c0: 2020 206e 6578 7420 7265 6c65 6173 6520 next release │ │ │ │ │ +000283d0: 7468 6174 2061 6464 7320 6e65 7720 6665 that adds new fe │ │ │ │ │ +000283e0: 6174 7572 6573 206f 7220 6368 616e 6765 atures or change │ │ │ │ │ +000283f0: 7320 736f 6d65 2072 756c 6573 2e20 2054 s some rules. T │ │ │ │ │ +00028400: 6869 730a 2020 2020 2073 6368 656d 6520 his. scheme │ │ │ │ │ +00028410: 696d 706c 6965 7320 6d61 696e 7461 696e implies maintain │ │ │ │ │ +00028420: 696e 6720 6120 6275 672d 6669 7820 6272 ing a bug-fix br │ │ │ │ │ +00028430: 616e 6368 2069 6e20 6164 6469 7469 6f6e anch in addition │ │ │ │ │ +00028440: 2074 6f20 7468 650a 2020 2020 2064 6576 to the. dev │ │ │ │ │ +00028450: 656c 6f70 6d65 6e74 2074 7275 6e6b 2c20 elopment trunk, │ │ │ │ │ +00028460: 7768 6963 6820 6d65 616e 7320 6d6f 7265 which means more │ │ │ │ │ +00028470: 2077 6f72 6b20 6672 6f6d 2074 6865 206d work from the m │ │ │ │ │ +00028480: 6169 6e74 6169 6e65 722c 2062 7574 0a20 aintainer, but. │ │ │ │ │ +00028490: 2020 2020 7072 6f76 6964 696e 6720 7265 providing re │ │ │ │ │ +000284a0: 6775 6c61 7220 6275 672d 6669 7820 7265 gular bug-fix re │ │ │ │ │ +000284b0: 6c65 6173 6573 2070 726f 7665 6420 746f leases proved to │ │ │ │ │ +000284c0: 2062 6520 7265 616c 6c79 2077 6f72 7468 be really worth │ │ │ │ │ +000284d0: 7768 696c 652e 0a0a 2020 2020 204c 696b while... Lik │ │ │ │ │ +000284e0: 6520 312e 352c 2031 2e36 2061 6c73 6f20 e 1.5, 1.6 also │ │ │ │ │ +000284f0: 696e 7472 6f64 7563 6564 2061 2062 756e introduced a bun │ │ │ │ │ +00028500: 6368 206f 6620 696e 636f 6d70 6174 6962 ch of incompatib │ │ │ │ │ +00028510: 696c 6974 6965 732c 0a20 2020 2020 696e ilities,. in │ │ │ │ │ +00028520: 7465 6e74 696f 6e61 6c20 6f72 206e 6f74 tentional or not │ │ │ │ │ +00028530: 2e20 2050 6572 6861 7073 2074 6865 206d . Perhaps the m │ │ │ │ │ +00028540: 6f72 6520 616e 6e6f 7969 6e67 2077 6173 ore annoying was │ │ │ │ │ +00028550: 2074 6865 2064 6570 656e 6465 6e63 650a the dependence. │ │ │ │ │ +00028560: 2020 2020 206f 6e20 7468 6520 6e65 776c on the newl │ │ │ │ │ +00028570: 7920 7265 6c65 6173 6564 2041 7574 6f63 y released Autoc │ │ │ │ │ +00028580: 6f6e 6620 322e 3533 2e20 2041 7574 6f63 onf 2.53. Autoc │ │ │ │ │ +00028590: 6f6e 6620 7365 656d 6564 2074 6f20 6861 onf seemed to ha │ │ │ │ │ +000285a0: 7665 0a20 2020 2020 7374 6162 696c 697a ve. stabiliz │ │ │ │ │ +000285b0: 6564 2065 6e6f 7567 6820 7369 6e63 6520 ed enough since │ │ │ │ │ +000285c0: 6974 7320 6578 706c 6f73 6976 6520 322e its explosive 2. │ │ │ │ │ +000285d0: 3530 2072 656c 6561 7365 2061 6e64 2069 50 release and i │ │ │ │ │ +000285e0: 6e63 6c75 6465 640a 2020 2020 2063 6861 ncluded. cha │ │ │ │ │ +000285f0: 6e67 6573 2072 6571 7569 7265 6420 746f nges required to │ │ │ │ │ +00028600: 2066 6978 2073 6f6d 6520 6275 6773 2069 fix some bugs i │ │ │ │ │ +00028610: 6e20 4175 746f 6d61 6b65 2e20 2049 6e20 n Automake. In │ │ │ │ │ +00028620: 6f72 6465 7220 746f 2075 7067 7261 6465 order to upgrade │ │ │ │ │ +00028630: 0a20 2020 2020 746f 2041 7574 6f6d 616b . to Automak │ │ │ │ │ +00028640: 6520 312e 362c 2070 656f 706c 6520 6e6f e 1.6, people no │ │ │ │ │ +00028650: 7720 6861 6420 746f 2075 7067 7261 6465 w had to upgrade │ │ │ │ │ +00028660: 2041 7574 6f63 6f6e 6620 746f 6f3b 2066 Autoconf too; f │ │ │ │ │ +00028670: 6f72 2073 6f6d 650a 2020 2020 2070 6163 or some. pac │ │ │ │ │ +00028680: 6b61 6765 7320 6974 2077 6173 206e 6f20 kages it was no │ │ │ │ │ +00028690: 7069 636e 6963 2e0a 0a20 2020 2020 5768 picnic... Wh │ │ │ │ │ +000286a0: 696c 6520 7665 7273 696f 6e65 6420 696e ile versioned in │ │ │ │ │ +000286b0: 7374 616c 6c61 7469 6f6e 2068 656c 7065 stallation helpe │ │ │ │ │ +000286c0: 6420 7065 6f70 6c65 2074 6f20 7570 6772 d people to upgr │ │ │ │ │ +000286d0: 6164 652c 2069 7420 616c 736f 0a20 2020 ade, it also. │ │ │ │ │ +000286e0: 2020 756e 666f 7274 756e 6174 656c 7920 unfortunately │ │ │ │ │ +000286f0: 616c 6c6f 7765 6420 7065 6f70 6c65 206e allowed people n │ │ │ │ │ +00028700: 6f74 2074 6f20 7570 6772 6164 652e 2020 ot to upgrade. │ │ │ │ │ +00028710: 4174 2074 6865 2074 696d 6520 6f66 0a20 At the time of. │ │ │ │ │ +00028720: 2020 2020 7772 6974 696e 672c 2073 6f6d writing, som │ │ │ │ │ +00028730: 6520 4c69 6e75 7820 6469 7374 7269 6275 e Linux distribu │ │ │ │ │ +00028740: 7469 6f6e 7320 6172 6520 7368 6970 7069 tions are shippi │ │ │ │ │ +00028750: 6e67 2070 6163 6b61 6765 7320 666f 720a ng packages for. │ │ │ │ │ +00028760: 2020 2020 2041 7574 6f6d 616b 6520 312e Automake 1. │ │ │ │ │ +00028770: 342c 2031 2e35 2c20 312e 362c 2031 2e37 4, 1.5, 1.6, 1.7 │ │ │ │ │ +00028780: 2c20 312e 382c 2061 6e64 2031 2e39 2e20 , 1.8, and 1.9. │ │ │ │ │ +00028790: 204d 6f73 7420 6f66 2074 6865 7365 2073 Most of these s │ │ │ │ │ +000287a0: 7469 6c6c 0a20 2020 2020 696e 7374 616c till. instal │ │ │ │ │ +000287b0: 6c20 312e 3420 6279 2064 6566 6175 6c74 l 1.4 by default │ │ │ │ │ +000287c0: 2e20 2053 6f6d 6520 6469 7374 7269 6275 . Some distribu │ │ │ │ │ +000287d0: 7469 6f6e 2061 6c73 6f20 6361 6c6c 2031 tion also call 1 │ │ │ │ │ +000287e0: 2e34 2074 6865 0a20 2020 2020 2273 7461 .4 the. "sta │ │ │ │ │ +000287f0: 626c 6522 2076 6572 7369 6f6e 2c20 616e ble" version, an │ │ │ │ │ +00028800: 6420 7072 6573 656e 7420 2231 2e39 2220 d present "1.9" │ │ │ │ │ +00028810: 6173 2074 6865 2064 6576 656c 6f70 6d65 as the developme │ │ │ │ │ +00028820: 6e74 2076 6572 7369 6f6e 3b0a 2020 2020 nt version;. │ │ │ │ │ +00028830: 2074 6869 7320 646f 6573 206e 6f74 2072 this does not r │ │ │ │ │ +00028840: 6561 6c6c 7920 6d61 6b65 7320 7365 6e73 eally makes sens │ │ │ │ │ +00028850: 6520 7369 6e63 6520 312e 3920 6973 2077 e since 1.9 is w │ │ │ │ │ +00028860: 6179 206d 6f72 6520 736f 6c69 6420 7468 ay more solid th │ │ │ │ │ +00028870: 616e 0a20 2020 2020 312e 342e 2020 416c an. 1.4. Al │ │ │ │ │ +00028880: 6c20 7468 6973 2064 6f65 7320 6e6f 7420 l this does not │ │ │ │ │ +00028890: 6865 6c70 2074 6865 206e 6577 636f 6d65 help the newcome │ │ │ │ │ +000288a0: 722e 0a0a 3230 3032 2d30 342d 3131 2041 r...2002-04-11 A │ │ │ │ │ +000288b0: 7574 6f6d 616b 6520 312e 362e 310a 0a20 utomake 1.6.1.. │ │ │ │ │ +000288c0: 2020 2020 312e 362c 2061 6e64 2074 6865 1.6, and the │ │ │ │ │ +000288d0: 2075 7063 6f6d 696e 6720 312e 342d 7036 upcoming 1.4-p6 │ │ │ │ │ +000288e0: 2072 656c 6561 7365 2077 6572 6520 7468 release were th │ │ │ │ │ +000288f0: 6520 6c61 7374 2072 656c 6561 7365 2062 e last release b │ │ │ │ │ +00028900: 7920 546f 6d2e 0a20 2020 2020 5468 6973 y Tom.. This │ │ │ │ │ +00028910: 206f 6e65 2061 6e64 2074 686f 7365 2066 one and those f │ │ │ │ │ +00028920: 6f6c 6c6f 7769 6e67 2077 696c 6c20 6265 ollowing will be │ │ │ │ │ +00028930: 2068 616e 646c 6564 2062 7920 416c 6578 handled by Alex │ │ │ │ │ +00028940: 616e 6472 650a 2020 2020 2044 7572 6574 andre. Duret │ │ │ │ │ +00028950: 2d4c 7574 7a2e 2020 546f 6d20 6973 2073 -Lutz. Tom is s │ │ │ │ │ +00028960: 7469 6c6c 2061 726f 756e 642c 2061 6e64 till around, and │ │ │ │ │ +00028970: 2077 696c 6c20 6265 2074 6865 7265 2075 will be there u │ │ │ │ │ +00028980: 6e74 696c 2061 626f 7574 0a20 2020 2020 ntil about. │ │ │ │ │ +00028990: 312e 372c 2062 7574 2068 6973 2069 6e74 1.7, but his int │ │ │ │ │ +000289a0: 6572 6573 7420 696e 746f 2041 7574 6f6d erest into Autom │ │ │ │ │ +000289b0: 616b 6520 6973 2064 7269 6674 696e 6720 ake is drifting │ │ │ │ │ +000289c0: 6177 6179 2074 6f77 6172 6473 0a20 2020 away towards. │ │ │ │ │ +000289d0: 2020 7072 6f6a 6563 7473 206c 696b 6520 projects like │ │ │ │ │ +000289e0: 2767 636a 272e 0a0a 2020 2020 2041 6c65 'gcj'... Ale │ │ │ │ │ +000289f0: 7861 6e64 7265 2068 6173 2062 6565 6e20 xandre has been │ │ │ │ │ +00028a00: 7573 696e 6720 4175 746f 6d61 6b65 2073 using Automake s │ │ │ │ │ +00028a10: 696e 6365 2032 3030 302c 2061 6e64 2073 ince 2000, and s │ │ │ │ │ +00028a20: 7461 7274 6564 2074 6f0a 2020 2020 2063 tarted to. c │ │ │ │ │ +00028a30: 6f6e 7472 6962 7574 6520 6d6f 7374 6c79 ontribute mostly │ │ │ │ │ +00028a40: 206f 6e20 416b 696d 2773 2069 6e63 6974 on Akim's incit │ │ │ │ │ +00028a50: 656d 656e 7420 2841 6b69 6d20 616e 6420 ement (Akim and │ │ │ │ │ +00028a60: 416c 6578 616e 6472 6520 6861 7665 0a20 Alexandre have. │ │ │ │ │ +00028a70: 2020 2020 6265 656e 2077 6f72 6b69 6e67 been working │ │ │ │ │ +00028a80: 2069 6e20 7468 6520 7361 6d65 2072 6f6f in the same roo │ │ │ │ │ +00028a90: 6d20 6672 6f6d 2031 3939 3920 746f 2032 m from 1999 to 2 │ │ │ │ │ +00028aa0: 3030 3229 2e20 2049 6e20 3230 3031 2061 002). In 2001 a │ │ │ │ │ +00028ab0: 6e64 2032 3030 320a 2020 2020 2068 6520 nd 2002. he │ │ │ │ │ +00028ac0: 6861 6420 6120 6c6f 7420 6f66 2066 7265 had a lot of fre │ │ │ │ │ +00028ad0: 6520 7469 6d65 2074 6f20 656e 6a6f 7920 e time to enjoy │ │ │ │ │ +00028ae0: 6861 636b 696e 6720 4175 746f 6d61 6b65 hacking Automake │ │ │ │ │ +00028af0: 2e0a 0a32 3030 322d 3036 2d31 3420 4175 ...2002-06-14 Au │ │ │ │ │ +00028b00: 746f 6d61 6b65 2031 2e36 2e32 0a0a 3230 tomake 1.6.2..20 │ │ │ │ │ +00028b10: 3032 2d30 372d 3238 2041 7574 6f6d 616b 02-07-28 Automak │ │ │ │ │ +00028b20: 6520 312e 362e 330a 3230 3032 2d30 372d e 1.6.3.2002-07- │ │ │ │ │ +00028b30: 3238 2041 7574 6f6d 616b 6520 312e 342d 28 Automake 1.4- │ │ │ │ │ +00028b40: 7036 0a0a 2020 2020 2054 776f 2072 656c p6.. Two rel │ │ │ │ │ +00028b50: 6561 7365 7320 6f6e 2074 6865 2073 616d eases on the sam │ │ │ │ │ +00028b60: 6520 6461 792e 2020 312e 362e 3320 6973 e day. 1.6.3 is │ │ │ │ │ +00028b70: 2061 2062 7567 2d66 6978 2072 656c 6561 a bug-fix relea │ │ │ │ │ +00028b80: 7365 2e0a 0a20 2020 2020 546f 6d20 5472 se... Tom Tr │ │ │ │ │ +00028b90: 6f6d 6579 2062 6163 6b70 6f72 7465 6420 omey backported │ │ │ │ │ +00028ba0: 7468 6520 7665 7273 696f 6e65 6420 696e the versioned in │ │ │ │ │ +00028bb0: 7374 616c 6c61 7469 6f6e 206d 6563 6861 stallation mecha │ │ │ │ │ +00028bc0: 6e69 736d 206f 6e20 7468 650a 2020 2020 nism on the. │ │ │ │ │ +00028bd0: 2031 2e34 2062 7261 6e63 682c 2073 6f20 1.4 branch, so │ │ │ │ │ +00028be0: 7468 6174 2041 7574 6f6d 616b 6520 312e that Automake 1. │ │ │ │ │ +00028bf0: 362e 7820 616e 6420 4175 746f 6d61 6b65 6.x and Automake │ │ │ │ │ +00028c00: 2031 2e34 2d70 3620 636f 756c 6420 6265 1.4-p6 could be │ │ │ │ │ +00028c10: 0a20 2020 2020 696e 7374 616c 6c65 6420 . installed │ │ │ │ │ +00028c20: 7369 6465 2062 7920 7369 6465 2e20 2041 side by side. A │ │ │ │ │ +00028c30: 6e6f 7468 6572 2072 6571 7565 7374 2066 nother request f │ │ │ │ │ +00028c40: 726f 6d20 7468 6520 474e 4f4d 4520 666f rom the GNOME fo │ │ │ │ │ +00028c50: 6c6b 732e 0a0a 3230 3032 2d30 392d 3235 lks...2002-09-25 │ │ │ │ │ +00028c60: 2041 7574 6f6d 616b 6520 312e 370a 0a20 Automake 1.7.. │ │ │ │ │ +00028c70: 2020 2020 5468 6973 2072 656c 6561 7365 This release │ │ │ │ │ +00028c80: 2073 7769 7463 6865 7320 746f 2074 6865 switches to the │ │ │ │ │ +00028c90: 206e 6577 2027 636f 6e66 6967 7572 652e new 'configure. │ │ │ │ │ +00028ca0: 6163 2720 7363 616e 6e65 7220 416b 696d ac' scanner Akim │ │ │ │ │ +00028cb0: 2077 6173 0a20 2020 2020 6578 7065 7269 was. experi │ │ │ │ │ +00028cc0: 6d65 6e74 696e 6720 696e 2031 2e35 2e0a menting in 1.5.. │ │ │ │ │ +00028cd0: 0a32 3030 322d 3130 2d31 3620 4175 746f .2002-10-16 Auto │ │ │ │ │ +00028ce0: 6d61 6b65 2031 2e37 2e31 0a32 3030 322d make 1.7.1.2002- │ │ │ │ │ +00028cf0: 3132 2d30 3620 4175 746f 6d61 6b65 2031 12-06 Automake 1 │ │ │ │ │ +00028d00: 2e37 2e32 0a32 3030 332d 3032 2d32 3020 .7.2.2003-02-20 │ │ │ │ │ +00028d10: 4175 746f 6d61 6b65 2031 2e37 2e33 0a32 Automake 1.7.3.2 │ │ │ │ │ +00028d20: 3030 332d 3034 2d32 3320 4175 746f 6d61 003-04-23 Automa │ │ │ │ │ +00028d30: 6b65 2031 2e37 2e34 0a32 3030 332d 3035 ke 1.7.4.2003-05 │ │ │ │ │ +00028d40: 2d31 3820 4175 746f 6d61 6b65 2031 2e37 -18 Automake 1.7 │ │ │ │ │ +00028d50: 2e35 0a32 3030 332d 3037 2d31 3020 4175 .5.2003-07-10 Au │ │ │ │ │ +00028d60: 746f 6d61 6b65 2031 2e37 2e36 0a32 3030 tomake 1.7.6.200 │ │ │ │ │ +00028d70: 332d 3039 2d30 3720 4175 746f 6d61 6b65 3-09-07 Automake │ │ │ │ │ +00028d80: 2031 2e37 2e37 0a32 3030 332d 3130 2d30 1.7.7.2003-10-0 │ │ │ │ │ +00028d90: 3720 4175 746f 6d61 6b65 2031 2e37 2e38 7 Automake 1.7.8 │ │ │ │ │ +00028da0: 0a0a 2020 2020 204d 616e 7920 6275 672d .. Many bug- │ │ │ │ │ +00028db0: 6669 7820 7265 6c65 6173 6573 2e20 2031 fix releases. 1 │ │ │ │ │ +00028dc0: 2e37 206c 6173 7465 6420 6265 6361 7573 .7 lasted becaus │ │ │ │ │ +00028dd0: 6520 7468 6520 6465 7665 6c6f 706d 656e e the developmen │ │ │ │ │ +00028de0: 7420 7665 7273 696f 6e0a 2020 2020 2028 t version. ( │ │ │ │ │ +00028df0: 7570 636f 6d69 6e67 2031 2e38 2920 7761 upcoming 1.8) wa │ │ │ │ │ +00028e00: 7320 7375 6666 6572 696e 6720 736f 6d65 s suffering some │ │ │ │ │ +00028e10: 206d 616a 6f72 2069 6e74 6572 6e61 6c20 major internal │ │ │ │ │ +00028e20: 7265 7661 6d70 696e 672e 0a0a 3230 3033 revamping...2003 │ │ │ │ │ +00028e30: 2d31 302d 3236 2041 7574 6f6d 616b 6520 -10-26 Automake │ │ │ │ │ +00028e40: 6f6e 2073 6372 6565 6e0a 0a20 2020 2020 on screen.. │ │ │ │ │ +00028e50: 4570 6973 6f64 6520 3439 2c20 2752 6570 Episode 49, 'Rep │ │ │ │ │ +00028e60: 6572 6375 7373 696f 6e73 272c 2069 6e20 ercussions', in │ │ │ │ │ +00028e70: 7468 6520 7468 6972 6420 7365 6173 6f6e the third season │ │ │ │ │ +00028e80: 206f 6620 7468 6520 2741 6c69 6173 2720 of the 'Alias' │ │ │ │ │ +00028e90: 5456 0a20 2020 2020 7368 6f77 2069 7320 TV. show is │ │ │ │ │ +00028ea0: 6669 7273 7420 6169 7265 642e 0a0a 2020 first aired... │ │ │ │ │ +00028eb0: 2020 204d 6172 7368 616c 6c2c 206f 6e65 Marshall, one │ │ │ │ │ +00028ec0: 206f 6620 7468 6520 6368 6172 6163 7465 of the characte │ │ │ │ │ +00028ed0: 7273 2c20 6973 2077 6f72 6b69 6e67 206f rs, is working o │ │ │ │ │ +00028ee0: 6e20 6120 636f 6d70 7574 6572 2076 6972 n a computer vir │ │ │ │ │ +00028ef0: 7573 0a20 2020 2020 7468 6174 2068 6520 us. that he │ │ │ │ │ +00028f00: 6861 7320 746f 206d 6f64 6966 7920 6265 has to modify be │ │ │ │ │ +00028f10: 666f 7265 2069 7420 6765 7473 2069 6e74 fore it gets int │ │ │ │ │ +00028f20: 6f20 7468 6520 7772 6f6e 6720 6861 6e64 o the wrong hand │ │ │ │ │ +00028f30: 7320 6f72 0a20 2020 2020 736f 6d65 7468 s or. someth │ │ │ │ │ +00028f40: 696e 6720 6c69 6b65 2074 6861 742e 2020 ing like that. │ │ │ │ │ +00028f50: 5468 6520 7363 7265 656e 7368 6f74 7320 The screenshots │ │ │ │ │ +00028f60: 796f 7520 7365 6520 646f 206e 6f74 2073 you see do not s │ │ │ │ │ +00028f70: 686f 7720 616e 790a 2020 2020 2070 726f how any. pro │ │ │ │ │ +00028f80: 6772 616d 2063 6f64 652c 2074 6865 7920 gram code, they │ │ │ │ │ +00028f90: 7368 6f77 2061 2027 4d61 6b65 6669 6c65 show a 'Makefile │ │ │ │ │ +00028fa0: 2e69 6e27 2027 6765 6e65 7261 7465 6420 .in' 'generated │ │ │ │ │ +00028fb0: 6279 2061 7574 6f6d 616b 6527 2e2e 2e0a by automake'.... │ │ │ │ │ +00028fc0: 0a32 3030 332d 3131 2d30 3920 4175 746f .2003-11-09 Auto │ │ │ │ │ +00028fd0: 6d61 6b65 2031 2e37 2e39 0a0a 3230 3033 make 1.7.9..2003 │ │ │ │ │ +00028fe0: 2d31 322d 3130 2041 7574 6f6d 616b 6520 -12-10 Automake │ │ │ │ │ +00028ff0: 312e 380a 0a20 2020 2020 5468 6520 6d6f 1.8.. The mo │ │ │ │ │ +00029000: 7374 2073 7472 696b 696e 6720 7570 6461 st striking upda │ │ │ │ │ +00029010: 7465 2069 7320 7072 6f62 6162 6c79 2074 te is probably t │ │ │ │ │ +00029020: 6861 7420 6f66 2027 6163 6c6f 6361 6c27 hat of 'aclocal' │ │ │ │ │ +00029030: 2e0a 0a20 2020 2020 2761 636c 6f63 616c ... 'aclocal │ │ │ │ │ +00029040: 2720 6e6f 7720 7573 6573 2027 6d34 5f69 ' now uses 'm4_i │ │ │ │ │ +00029050: 6e63 6c75 6465 2720 696e 2074 6865 2070 nclude' in the p │ │ │ │ │ +00029060: 726f 6475 6365 6420 2761 636c 6f63 616c roduced 'aclocal │ │ │ │ │ +00029070: 2e6d 3427 2077 6865 6e0a 2020 2020 2074 .m4' when. t │ │ │ │ │ +00029080: 6865 2069 6e63 6c75 6465 6420 6d61 6372 he included macr │ │ │ │ │ +00029090: 6f73 2061 7265 2061 6c72 6561 6479 2064 os are already d │ │ │ │ │ +000290a0: 6973 7472 6962 7574 6564 2077 6974 6820 istributed with │ │ │ │ │ +000290b0: 7468 6520 7061 636b 6167 6520 2861 6e0a the package (an. │ │ │ │ │ +000290c0: 2020 2020 2069 6469 6f6d 2075 7365 6420 idiom used │ │ │ │ │ +000290d0: 696e 206d 616e 7920 7061 636b 6167 6573 in many packages │ │ │ │ │ +000290e0: 292c 2077 6869 6368 2072 6564 7563 6573 ), which reduces │ │ │ │ │ +000290f0: 2063 6f64 6520 6475 706c 6963 6174 696f code duplicatio │ │ │ │ │ +00029100: 6e2e 2020 4d61 6e79 0a20 2020 2020 7065 n. Many. pe │ │ │ │ │ +00029110: 6f70 6c65 206c 696b 6564 2074 6861 742c ople liked that, │ │ │ │ │ +00029120: 2062 7574 2069 6e20 6661 6374 2074 6869 but in fact thi │ │ │ │ │ +00029130: 7320 6368 616e 6765 2077 6173 2072 6561 s change was rea │ │ │ │ │ +00029140: 6c6c 7920 696e 7472 6f64 7563 6564 2074 lly introduced t │ │ │ │ │ +00029150: 6f0a 2020 2020 2066 6978 2061 2062 7567 o. fix a bug │ │ │ │ │ +00029160: 2069 6e20 7265 6275 696c 6420 7275 6c65 in rebuild rule │ │ │ │ │ +00029170: 733a 2027 4d61 6b65 6669 6c65 2e69 6e27 s: 'Makefile.in' │ │ │ │ │ +00029180: 206d 7573 7420 6265 2072 6562 7569 6c74 must be rebuilt │ │ │ │ │ +00029190: 2077 6865 6e65 7665 720a 2020 2020 2061 whenever. a │ │ │ │ │ +000291a0: 2064 6570 656e 6465 6e63 7920 6f66 2027 dependency of ' │ │ │ │ │ +000291b0: 636f 6e66 6967 7572 6527 2063 6861 6e67 configure' chang │ │ │ │ │ +000291c0: 6573 2c20 6275 7420 616c 6c20 7468 6520 es, but all the │ │ │ │ │ +000291d0: 276d 3427 2066 696c 6573 0a20 2020 2020 'm4' files. │ │ │ │ │ +000291e0: 696e 636c 7564 6564 2069 6e20 2761 636c included in 'acl │ │ │ │ │ +000291f0: 6f63 616c 2e6d 3427 2077 6865 7265 2075 ocal.m4' where u │ │ │ │ │ +00029200: 6e6b 6e6f 776e 2066 726f 6d20 2761 7574 nknown from 'aut │ │ │ │ │ +00029210: 6f6d 616b 6527 2e20 204e 6f77 0a20 2020 omake'. Now. │ │ │ │ │ +00029220: 2020 2761 7574 6f6d 616b 6527 2063 616e 'automake' can │ │ │ │ │ +00029230: 206a 7573 7420 7472 6163 6520 7468 6520 just trace the │ │ │ │ │ +00029240: 276d 345f 696e 636c 7564 6527 7320 746f 'm4_include's to │ │ │ │ │ +00029250: 2064 6973 636f 7665 7220 7468 650a 2020 discover the. │ │ │ │ │ +00029260: 2020 2064 6570 656e 6465 6e63 6965 732e dependencies. │ │ │ │ │ +00029270: 0a0a 2020 2020 2027 6163 6c6f 6361 6c27 .. 'aclocal' │ │ │ │ │ +00029280: 2061 6c73 6f20 7374 6172 7473 2075 7369 also starts usi │ │ │ │ │ +00029290: 6e67 2074 6865 2027 2d2d 7472 6163 6527 ng the '--trace' │ │ │ │ │ +000292a0: 2041 7574 6f63 6f6e 6620 6f70 7469 6f6e Autoconf option │ │ │ │ │ +000292b0: 2069 6e20 6f72 6465 720a 2020 2020 2074 in order. t │ │ │ │ │ +000292c0: 6f20 6469 7363 6f76 6572 2075 7365 6420 o discover used │ │ │ │ │ +000292d0: 6d61 6372 6f73 206d 6f72 6520 6163 6375 macros more accu │ │ │ │ │ +000292e0: 7261 7465 6c79 2e20 2054 6869 7320 7769 rately. This wi │ │ │ │ │ +000292f0: 6c6c 2074 7572 6e20 6f75 7420 746f 2062 ll turn out to b │ │ │ │ │ +00029300: 650a 2020 2020 2076 6572 7920 7472 6963 e. very tric │ │ │ │ │ +00029310: 6b79 2028 6c61 7465 7220 7265 6c65 6173 ky (later releas │ │ │ │ │ +00029320: 6573 2077 696c 6c20 696d 7072 6f76 6520 es will improve │ │ │ │ │ +00029330: 7468 6973 2920 6173 2070 656f 706c 6520 this) as people │ │ │ │ │ +00029340: 6861 640a 2020 2020 2064 6576 6973 6564 had. devised │ │ │ │ │ +00029350: 206d 616e 7920 7761 7973 2074 6f20 636f many ways to co │ │ │ │ │ +00029360: 7065 2077 6974 6820 7468 6520 6c69 6d69 pe with the limi │ │ │ │ │ +00029370: 7461 7469 6f6e 206f 6620 7072 6576 696f tation of previo │ │ │ │ │ +00029380: 7573 2027 6163 6c6f 6361 6c27 0a20 2020 us 'aclocal'. │ │ │ │ │ +00029390: 2020 7665 7273 696f 6e73 2c20 6e6f 7461 versions, nota │ │ │ │ │ +000293a0: 626c 7920 7573 696e 6720 6861 6e64 7772 bly using handwr │ │ │ │ │ +000293b0: 6974 7465 6e20 276d 345f 696e 636c 7564 itten 'm4_includ │ │ │ │ │ +000293c0: 6527 733a 2027 6163 6c6f 6361 6c27 206d e's: 'aclocal' m │ │ │ │ │ +000293d0: 7573 740a 2020 2020 206d 616b 6520 7375 ust. make su │ │ │ │ │ +000293e0: 7265 206e 6f74 2074 6f20 7265 6465 6669 re not to redefi │ │ │ │ │ +000293f0: 6e65 2061 2072 756c 6520 7468 6174 2069 ne a rule that i │ │ │ │ │ +00029400: 7320 616c 7265 6164 7920 696e 636c 7564 s already includ │ │ │ │ │ +00029410: 6564 2062 7920 7375 6368 0a20 2020 2020 ed by such. │ │ │ │ │ +00029420: 7374 6174 656d 656e 742e 0a0a 2020 2020 statement... │ │ │ │ │ +00029430: 2041 7574 6f6d 616b 6520 616c 736f 2068 Automake also h │ │ │ │ │ +00029440: 6173 2073 6565 6e20 6974 7320 6775 7473 as seen its guts │ │ │ │ │ +00029450: 2072 6577 7269 7474 656e 2e20 2041 6c74 rewritten. Alt │ │ │ │ │ +00029460: 686f 7567 6820 7468 6973 2072 6577 7269 hough this rewri │ │ │ │ │ +00029470: 7469 6e67 0a20 2020 2020 746f 6f6b 2061 ting. took a │ │ │ │ │ +00029480: 206c 6f74 206f 6620 6566 666f 7274 732c lot of efforts, │ │ │ │ │ +00029490: 2069 7420 6973 206f 6e6c 7920 6170 7061 it is only appa │ │ │ │ │ +000294a0: 7265 6e74 2074 6f20 7468 6520 7573 6572 rent to the user │ │ │ │ │ +000294b0: 7320 696e 2074 6861 740a 2020 2020 2073 s in that. s │ │ │ │ │ +000294c0: 6f6d 6520 636f 6e73 7472 7563 7469 6f6e ome construction │ │ │ │ │ +000294d0: 7320 7072 6576 696f 7573 6c79 2064 6973 s previously dis │ │ │ │ │ +000294e0: 616c 6c6f 7765 6420 6279 2074 6865 2069 allowed by the i │ │ │ │ │ +000294f0: 6d70 6c65 6d65 6e74 6174 696f 6e20 6e6f mplementation no │ │ │ │ │ +00029500: 770a 2020 2020 2077 6f72 6b20 6e69 6365 w. work nice │ │ │ │ │ +00029510: 6c79 2e20 2043 6f6e 6469 7469 6f6e 616c ly. Conditional │ │ │ │ │ +00029520: 732c 204c 6f63 6174 696f 6e73 2c20 5661 s, Locations, Va │ │ │ │ │ +00029530: 7269 6162 6c65 2061 6e64 2052 756c 650a riable and Rule. │ │ │ │ │ +00029540: 2020 2020 2064 6566 696e 6974 696f 6e73 definitions │ │ │ │ │ +00029550: 2c20 4f70 7469 6f6e 733a 2074 6865 7365 , Options: these │ │ │ │ │ +00029560: 2069 7465 6d73 206f 6e20 7768 6963 6820 items on which │ │ │ │ │ +00029570: 4175 746f 6d61 6b65 2077 6f72 6b73 2068 Automake works h │ │ │ │ │ +00029580: 6176 6520 6265 656e 0a20 2020 2020 7265 ave been. re │ │ │ │ │ +00029590: 7772 6974 7465 6e20 6173 2073 6570 6172 written as separ │ │ │ │ │ +000295a0: 6174 6520 5065 726c 206d 6f64 756c 6573 ate Perl modules │ │ │ │ │ +000295b0: 2c20 616e 6420 646f 6375 6d65 6e74 6564 , and documented │ │ │ │ │ +000295c0: 2e0a 0a32 3030 342d 3031 2d31 3120 4175 ...2004-01-11 Au │ │ │ │ │ +000295d0: 746f 6d61 6b65 2031 2e38 2e31 0a32 3030 tomake 1.8.1.200 │ │ │ │ │ +000295e0: 342d 3031 2d31 3220 4175 746f 6d61 6b65 4-01-12 Automake │ │ │ │ │ +000295f0: 2031 2e38 2e32 0a32 3030 342d 3033 2d30 1.8.2.2004-03-0 │ │ │ │ │ +00029600: 3720 4175 746f 6d61 6b65 2031 2e38 2e33 7 Automake 1.8.3 │ │ │ │ │ +00029610: 0a32 3030 342d 3034 2d32 3520 4175 746f .2004-04-25 Auto │ │ │ │ │ +00029620: 6d61 6b65 2031 2e38 2e34 0a32 3030 342d make 1.8.4.2004- │ │ │ │ │ +00029630: 3035 2d31 3620 4175 746f 6d61 6b65 2031 05-16 Automake 1 │ │ │ │ │ +00029640: 2e38 2e35 0a0a 3230 3034 2d30 372d 3238 .8.5..2004-07-28 │ │ │ │ │ +00029650: 2041 7574 6f6d 616b 6520 312e 390a 0a20 Automake 1.9.. │ │ │ │ │ +00029660: 2020 2020 5468 6973 2072 656c 6561 7365 This release │ │ │ │ │ +00029670: 2074 7269 6573 2074 6f20 7369 6d70 6c69 tries to simpli │ │ │ │ │ +00029680: 6679 2074 6865 2063 6f6d 7069 6c61 7469 fy the compilati │ │ │ │ │ +00029690: 6f6e 2072 756c 6573 2069 7420 6f75 7470 on rules it outp │ │ │ │ │ +000296a0: 7574 7320 746f 0a20 2020 2020 7265 6475 uts to. redu │ │ │ │ │ +000296b0: 6365 2074 6865 2073 697a 6520 6f66 2074 ce the size of t │ │ │ │ │ +000296c0: 6865 204d 616b 6566 696c 652e 2020 5468 he Makefile. Th │ │ │ │ │ +000296d0: 6520 636f 6d70 6c61 696e 7420 696e 6974 e complaint init │ │ │ │ │ +000296e0: 6961 6c6c 7920 636f 6d65 2066 726f 6d0a ially come from. │ │ │ │ │ +000296f0: 2020 2020 2074 6865 206c 6962 6763 6a20 the libgcj │ │ │ │ │ +00029700: 6465 7665 6c6f 7065 7273 2e20 2054 6865 developers. The │ │ │ │ │ +00029710: 6972 2027 4d61 6b65 6669 6c65 2e69 6e27 ir 'Makefile.in' │ │ │ │ │ +00029720: 2067 656e 6572 6174 6564 2077 6974 6820 generated with │ │ │ │ │ +00029730: 4175 746f 6d61 6b65 0a20 2020 2020 312e Automake. 1. │ │ │ │ │ +00029740: 3420 616e 6420 6375 7374 6f6d 2062 7569 4 and custom bui │ │ │ │ │ +00029750: 6c64 2072 756c 6573 2028 312e 3420 6469 ld rules (1.4 di │ │ │ │ │ +00029760: 6420 6e6f 7420 7375 7070 6f72 7420 636f d not support co │ │ │ │ │ +00029770: 6d70 696c 6564 204a 6176 6129 2069 730a mpiled Java) is. │ │ │ │ │ +00029780: 2020 2020 2032 3530 4b42 2e20 2054 6865 250KB. The │ │ │ │ │ +00029790: 206f 6e65 2067 656e 6572 6174 6564 2062 one generated b │ │ │ │ │ +000297a0: 7920 312e 3820 7761 7320 6f76 6572 2039 y 1.8 was over 9 │ │ │ │ │ +000297b0: 4d42 2120 2031 2e39 2067 6574 7320 6974 MB! 1.9 gets it │ │ │ │ │ +000297c0: 2064 6f77 6e20 746f 0a20 2020 2020 312e down to. 1. │ │ │ │ │ +000297d0: 324d 422e 0a0a 2020 2020 2041 7369 6465 2MB... Aside │ │ │ │ │ +000297e0: 2066 726f 6d20 7468 6973 2069 7420 636f from this it co │ │ │ │ │ +000297f0: 6e74 6169 6e73 206d 6169 6e6c 7920 6d69 ntains mainly mi │ │ │ │ │ +00029800: 6e6f 7220 6368 616e 6765 7320 616e 6420 nor changes and │ │ │ │ │ +00029810: 6275 672d 6669 7865 732e 0a0a 3230 3034 bug-fixes...2004 │ │ │ │ │ +00029820: 2d30 382d 3131 2041 7574 6f6d 616b 6520 -08-11 Automake │ │ │ │ │ +00029830: 312e 392e 310a 3230 3034 2d30 392d 3139 1.9.1.2004-09-19 │ │ │ │ │ +00029840: 2041 7574 6f6d 616b 6520 312e 392e 320a Automake 1.9.2. │ │ │ │ │ +00029850: 0a20 2020 2020 4175 746f 6d61 6b65 2068 . Automake h │ │ │ │ │ +00029860: 6173 2074 656e 2079 6561 7273 2e20 2054 as ten years. T │ │ │ │ │ +00029870: 6869 7320 6368 6170 7465 7220 6f66 2074 his chapter of t │ │ │ │ │ +00029880: 6865 206d 616e 7561 6c20 7761 7320 696e he manual was in │ │ │ │ │ +00029890: 6974 6961 6c6c 790a 2020 2020 2077 7269 itially. wri │ │ │ │ │ +000298a0: 7474 656e 2066 6f72 2074 6869 7320 6f63 tten for this oc │ │ │ │ │ +000298b0: 6361 7369 6f6e 2e0a 0a32 3030 372d 3130 casion...2007-10 │ │ │ │ │ +000298c0: 2d32 3920 4175 746f 6d61 6b65 2072 6570 -29 Automake rep │ │ │ │ │ +000298d0: 6f73 6974 6f72 7920 6d6f 7665 7320 746f ository moves to │ │ │ │ │ +000298e0: 2027 7361 7661 6e6e 6168 2e67 6e75 2e6f 'savannah.gnu.o │ │ │ │ │ +000298f0: 7267 2720 616e 6420 7573 6573 0a20 2020 rg' and uses. │ │ │ │ │ +00029900: 2020 6769 7420 6173 2070 7269 6d61 7279 git as primary │ │ │ │ │ +00029910: 2072 6570 6f73 6974 6f72 792e 0a0a 1f0a repository..... │ │ │ │ │ +00029920: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +00029930: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +00029940: 2044 6570 656e 6465 6e63 7920 5472 6163 Dependency Trac │ │ │ │ │ +00029950: 6b69 6e67 2045 766f 6c75 7469 6f6e 2c20 king Evolution, │ │ │ │ │ +00029960: 204e 6578 743a 2052 656c 6561 7365 732c Next: Releases, │ │ │ │ │ +00029970: 2020 5072 6576 3a20 5469 6d65 6c69 6e65 Prev: Timeline │ │ │ │ │ +00029980: 2c20 2055 703a 2048 6973 746f 7279 0a0a , Up: History.. │ │ │ │ │ +00029990: 3239 2e32 2044 6570 656e 6465 6e63 7920 29.2 Dependency │ │ │ │ │ +000299a0: 5472 6163 6b69 6e67 2069 6e20 4175 746f Tracking in Auto │ │ │ │ │ +000299b0: 6d61 6b65 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d make.=========== │ │ │ │ │ 000299c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000299d0: 3d3d 3d3d 3d3d 3d3d 0a0a 4f76 6572 2074 ========..Over t │ │ │ │ │ -000299e0: 6865 2079 6561 7273 2041 7574 6f6d 616b he years Automak │ │ │ │ │ -000299f0: 6520 6861 7320 6465 706c 6f79 6564 2074 e has deployed t │ │ │ │ │ -00029a00: 6872 6565 2064 6966 6665 7265 6e74 2064 hree different d │ │ │ │ │ -00029a10: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ -00029a20: 6e67 0a6d 6574 686f 6473 2e20 2045 6163 ng.methods. Eac │ │ │ │ │ -00029a30: 6820 6d65 7468 6f64 2c20 696e 636c 7564 h method, includ │ │ │ │ │ -00029a40: 696e 6720 7468 6520 6375 7272 656e 7420 ing the current │ │ │ │ │ -00029a50: 6f6e 652c 2068 6173 2068 6164 2066 6c61 one, has had fla │ │ │ │ │ -00029a60: 7773 206f 660a 7661 7269 6f75 7320 736f ws of.various so │ │ │ │ │ -00029a70: 7274 732e 2020 4865 7265 2077 6520 6c61 rts. Here we la │ │ │ │ │ -00029a80: 7920 6f75 7420 7468 6520 6469 6666 6572 y out the differ │ │ │ │ │ -00029a90: 656e 7420 6465 7065 6e64 656e 6379 2074 ent dependency t │ │ │ │ │ -00029aa0: 7261 636b 696e 670a 6d65 7468 6f64 732c racking.methods, │ │ │ │ │ -00029ab0: 2074 6865 6972 2066 6c61 7773 2c20 616e their flaws, an │ │ │ │ │ -00029ac0: 6420 7468 6569 7220 6669 7865 732e 2020 d their fixes. │ │ │ │ │ -00029ad0: 5765 2063 6f6e 636c 7564 6520 7769 7468 We conclude with │ │ │ │ │ -00029ae0: 2072 6563 6f6d 6d65 6e64 6174 696f 6e73 recommendations │ │ │ │ │ -00029af0: 0a66 6f72 2074 6f6f 6c20 7772 6974 6572 .for tool writer │ │ │ │ │ -00029b00: 732c 2061 6e64 2062 7920 696e 6469 6361 s, and by indica │ │ │ │ │ -00029b10: 7469 6e67 2066 7574 7572 6520 6469 7265 ting future dire │ │ │ │ │ -00029b20: 6374 696f 6e73 2066 6f72 2064 6570 656e ctions for depen │ │ │ │ │ -00029b30: 6465 6e63 790a 7472 6163 6b69 6e67 2077 dency.tracking w │ │ │ │ │ -00029b40: 6f72 6b20 696e 2041 7574 6f6d 616b 652e ork in Automake. │ │ │ │ │ -00029b50: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2046 6972 ..* Menu:..* Fir │ │ │ │ │ -00029b60: 7374 2054 616b 6520 6f6e 2044 6570 656e st Take on Depen │ │ │ │ │ -00029b70: 6465 6e63 6965 733a 3a20 2050 7265 636f dencies:: Preco │ │ │ │ │ -00029b80: 6d70 7574 6564 2064 6570 656e 6465 6e63 mputed dependenc │ │ │ │ │ -00029b90: 7920 7472 6163 6b69 6e67 0a2a 2044 6570 y tracking.* Dep │ │ │ │ │ -00029ba0: 656e 6465 6e63 6965 7320 4173 2053 6964 endencies As Sid │ │ │ │ │ -00029bb0: 6520 4566 6665 6374 733a 3a20 2055 7064 e Effects:: Upd │ │ │ │ │ -00029bc0: 6174 6520 6174 2064 6576 656c 6f70 6572 ate at developer │ │ │ │ │ -00029bd0: 2063 6f6d 7069 6c65 2074 696d 650a 2a20 compile time.* │ │ │ │ │ -00029be0: 4465 7065 6e64 656e 6369 6573 2066 6f72 Dependencies for │ │ │ │ │ -00029bf0: 2074 6865 2055 7365 723a 3a20 2020 5570 the User:: Up │ │ │ │ │ -00029c00: 6461 7465 2061 7420 7573 6572 2063 6f6d date at user com │ │ │ │ │ -00029c10: 7069 6c65 2074 696d 650a 2a20 5465 6368 pile time.* Tech │ │ │ │ │ -00029c20: 6e69 7175 6573 2066 6f72 2044 6570 656e niques for Depen │ │ │ │ │ -00029c30: 6465 6e63 6965 733a 3a20 2041 6c74 6572 dencies:: Alter │ │ │ │ │ -00029c40: 6e61 7469 7665 2061 7070 726f 6163 6865 native approache │ │ │ │ │ -00029c50: 730a 2a20 5265 636f 6d6d 656e 6461 7469 s.* Recommendati │ │ │ │ │ -00029c60: 6f6e 7320 666f 7220 546f 6f6c 2057 7269 ons for Tool Wri │ │ │ │ │ -00029c70: 7465 7273 3a3a 2020 5768 6174 2074 6f6f ters:: What too │ │ │ │ │ -00029c80: 6c20 7772 6974 6572 7320 6361 6e20 646f l writers can do │ │ │ │ │ -00029c90: 2074 6f20 6865 6c70 0a2a 2046 7574 7572 to help.* Futur │ │ │ │ │ -00029ca0: 6520 4469 7265 6374 696f 6e73 2066 6f72 e Directions for │ │ │ │ │ -00029cb0: 2044 6570 656e 6465 6e63 6965 733a 3a20 Dependencies:: │ │ │ │ │ -00029cc0: 204c 616e 6775 6167 6573 2041 7574 6f6d Languages Autom │ │ │ │ │ -00029cd0: 616b 6520 646f 6573 206e 6f74 206b 6e6f ake does not kno │ │ │ │ │ -00029ce0: 770a 0a1f 0a46 696c 653a 2061 7574 6f6d w....File: autom │ │ │ │ │ -00029cf0: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -00029d00: 4e6f 6465 3a20 4669 7273 7420 5461 6b65 Node: First Take │ │ │ │ │ -00029d10: 206f 6e20 4465 7065 6e64 656e 6369 6573 on Dependencies │ │ │ │ │ -00029d20: 2c20 204e 6578 743a 2044 6570 656e 6465 , Next: Depende │ │ │ │ │ -00029d30: 6e63 6965 7320 4173 2053 6964 6520 4566 ncies As Side Ef │ │ │ │ │ -00029d40: 6665 6374 732c 2020 5570 3a20 4465 7065 fects, Up: Depe │ │ │ │ │ -00029d50: 6e64 656e 6379 2054 7261 636b 696e 6720 ndency Tracking │ │ │ │ │ -00029d60: 4576 6f6c 7574 696f 6e0a 0a32 392e 322e Evolution..29.2. │ │ │ │ │ -00029d70: 3120 4669 7273 7420 5461 6b65 206f 6e20 1 First Take on │ │ │ │ │ -00029d80: 4465 7065 6e64 656e 6379 2054 7261 636b Dependency Track │ │ │ │ │ -00029d90: 696e 670a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ing.------------ │ │ │ │ │ +000299d0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a4f 7665 7220 =========..Over │ │ │ │ │ +000299e0: 7468 6520 7965 6172 7320 4175 746f 6d61 the years Automa │ │ │ │ │ +000299f0: 6b65 2068 6173 2064 6570 6c6f 7965 6420 ke has deployed │ │ │ │ │ +00029a00: 7468 7265 6520 6469 6666 6572 656e 7420 three different │ │ │ │ │ +00029a10: 6465 7065 6e64 656e 6379 2074 7261 636b dependency track │ │ │ │ │ +00029a20: 696e 670a 6d65 7468 6f64 732e 2020 4561 ing.methods. Ea │ │ │ │ │ +00029a30: 6368 206d 6574 686f 642c 2069 6e63 6c75 ch method, inclu │ │ │ │ │ +00029a40: 6469 6e67 2074 6865 2063 7572 7265 6e74 ding the current │ │ │ │ │ +00029a50: 206f 6e65 2c20 6861 7320 6861 6420 666c one, has had fl │ │ │ │ │ +00029a60: 6177 7320 6f66 0a76 6172 696f 7573 2073 aws of.various s │ │ │ │ │ +00029a70: 6f72 7473 2e20 2048 6572 6520 7765 206c orts. Here we l │ │ │ │ │ +00029a80: 6179 206f 7574 2074 6865 2064 6966 6665 ay out the diffe │ │ │ │ │ +00029a90: 7265 6e74 2064 6570 656e 6465 6e63 7920 rent dependency │ │ │ │ │ +00029aa0: 7472 6163 6b69 6e67 0a6d 6574 686f 6473 tracking.methods │ │ │ │ │ +00029ab0: 2c20 7468 6569 7220 666c 6177 732c 2061 , their flaws, a │ │ │ │ │ +00029ac0: 6e64 2074 6865 6972 2066 6978 6573 2e20 nd their fixes. │ │ │ │ │ +00029ad0: 2057 6520 636f 6e63 6c75 6465 2077 6974 We conclude wit │ │ │ │ │ +00029ae0: 6820 7265 636f 6d6d 656e 6461 7469 6f6e h recommendation │ │ │ │ │ +00029af0: 730a 666f 7220 746f 6f6c 2077 7269 7465 s.for tool write │ │ │ │ │ +00029b00: 7273 2c20 616e 6420 6279 2069 6e64 6963 rs, and by indic │ │ │ │ │ +00029b10: 6174 696e 6720 6675 7475 7265 2064 6972 ating future dir │ │ │ │ │ +00029b20: 6563 7469 6f6e 7320 666f 7220 6465 7065 ections for depe │ │ │ │ │ +00029b30: 6e64 656e 6379 0a74 7261 636b 696e 6720 ndency.tracking │ │ │ │ │ +00029b40: 776f 726b 2069 6e20 4175 746f 6d61 6b65 work in Automake │ │ │ │ │ +00029b50: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 4669 ...* Menu:..* Fi │ │ │ │ │ +00029b60: 7273 7420 5461 6b65 206f 6e20 4465 7065 rst Take on Depe │ │ │ │ │ +00029b70: 6e64 656e 6369 6573 3a3a 2020 5072 6563 ndencies:: Prec │ │ │ │ │ +00029b80: 6f6d 7075 7465 6420 6465 7065 6e64 656e omputed dependen │ │ │ │ │ +00029b90: 6379 2074 7261 636b 696e 670a 2a20 4465 cy tracking.* De │ │ │ │ │ +00029ba0: 7065 6e64 656e 6369 6573 2041 7320 5369 pendencies As Si │ │ │ │ │ +00029bb0: 6465 2045 6666 6563 7473 3a3a 2020 5570 de Effects:: Up │ │ │ │ │ +00029bc0: 6461 7465 2061 7420 6465 7665 6c6f 7065 date at develope │ │ │ │ │ +00029bd0: 7220 636f 6d70 696c 6520 7469 6d65 0a2a r compile time.* │ │ │ │ │ +00029be0: 2044 6570 656e 6465 6e63 6965 7320 666f Dependencies fo │ │ │ │ │ +00029bf0: 7220 7468 6520 5573 6572 3a3a 2020 2055 r the User:: U │ │ │ │ │ +00029c00: 7064 6174 6520 6174 2075 7365 7220 636f pdate at user co │ │ │ │ │ +00029c10: 6d70 696c 6520 7469 6d65 0a2a 2054 6563 mpile time.* Tec │ │ │ │ │ +00029c20: 686e 6971 7565 7320 666f 7220 4465 7065 hniques for Depe │ │ │ │ │ +00029c30: 6e64 656e 6369 6573 3a3a 2020 416c 7465 ndencies:: Alte │ │ │ │ │ +00029c40: 726e 6174 6976 6520 6170 7072 6f61 6368 rnative approach │ │ │ │ │ +00029c50: 6573 0a2a 2052 6563 6f6d 6d65 6e64 6174 es.* Recommendat │ │ │ │ │ +00029c60: 696f 6e73 2066 6f72 2054 6f6f 6c20 5772 ions for Tool Wr │ │ │ │ │ +00029c70: 6974 6572 733a 3a20 2057 6861 7420 746f iters:: What to │ │ │ │ │ +00029c80: 6f6c 2077 7269 7465 7273 2063 616e 2064 ol writers can d │ │ │ │ │ +00029c90: 6f20 746f 2068 656c 700a 2a20 4675 7475 o to help.* Futu │ │ │ │ │ +00029ca0: 7265 2044 6972 6563 7469 6f6e 7320 666f re Directions fo │ │ │ │ │ +00029cb0: 7220 4465 7065 6e64 656e 6369 6573 3a3a r Dependencies:: │ │ │ │ │ +00029cc0: 2020 4c61 6e67 7561 6765 7320 4175 746f Languages Auto │ │ │ │ │ +00029cd0: 6d61 6b65 2064 6f65 7320 6e6f 7420 6b6e make does not kn │ │ │ │ │ +00029ce0: 6f77 0a0a 1f0a 4669 6c65 3a20 6175 746f ow....File: auto │ │ │ │ │ +00029cf0: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +00029d00: 204e 6f64 653a 2046 6972 7374 2054 616b Node: First Tak │ │ │ │ │ +00029d10: 6520 6f6e 2044 6570 656e 6465 6e63 6965 e on Dependencie │ │ │ │ │ +00029d20: 732c 2020 4e65 7874 3a20 4465 7065 6e64 s, Next: Depend │ │ │ │ │ +00029d30: 656e 6369 6573 2041 7320 5369 6465 2045 encies As Side E │ │ │ │ │ +00029d40: 6666 6563 7473 2c20 2055 703a 2044 6570 ffects, Up: Dep │ │ │ │ │ +00029d50: 656e 6465 6e63 7920 5472 6163 6b69 6e67 endency Tracking │ │ │ │ │ +00029d60: 2045 766f 6c75 7469 6f6e 0a0a 3239 2e32 Evolution..29.2 │ │ │ │ │ +00029d70: 2e31 2046 6972 7374 2054 616b 6520 6f6e .1 First Take on │ │ │ │ │ +00029d80: 2044 6570 656e 6465 6e63 7920 5472 6163 Dependency Trac │ │ │ │ │ +00029d90: 6b69 6e67 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d king.----------- │ │ │ │ │ 00029da0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00029db0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4465 ------------..De │ │ │ │ │ -00029dc0: 7363 7269 7074 696f 6e0a 2e2e 2e2e 2e2e scription....... │ │ │ │ │ -00029dd0: 2e2e 2e2e 2e0a 0a4f 7572 2066 6972 7374 .......Our first │ │ │ │ │ -00029de0: 2061 7474 656d 7074 2061 7420 6175 746f attempt at auto │ │ │ │ │ -00029df0: 6d61 7469 6320 6465 7065 6e64 656e 6379 matic dependency │ │ │ │ │ -00029e00: 2074 7261 636b 696e 6720 7761 7320 6261 tracking was ba │ │ │ │ │ -00029e10: 7365 6420 6f6e 2074 6865 0a6d 6574 686f sed on the.metho │ │ │ │ │ -00029e20: 6420 7265 636f 6d6d 656e 6465 6420 6279 d recommended by │ │ │ │ │ -00029e30: 2047 4e55 2027 6d61 6b65 272e 2020 282a GNU 'make'. (* │ │ │ │ │ -00029e40: 6e6f 7465 2047 656e 6572 6174 696e 6720 note Generating │ │ │ │ │ -00029e50: 5072 6572 6571 7569 7369 7465 730a 4175 Prerequisites.Au │ │ │ │ │ -00029e60: 746f 6d61 7469 6361 6c6c 793a 2028 6d61 tomatically: (ma │ │ │ │ │ -00029e70: 6b65 2941 7574 6f6d 6174 6963 2050 7265 ke)Automatic Pre │ │ │ │ │ -00029e80: 7265 7175 6973 6974 6573 2e29 0a0a 2020 requisites.).. │ │ │ │ │ -00029e90: 2054 6869 7320 7665 7273 696f 6e20 776f This version wo │ │ │ │ │ -00029ea0: 726b 6564 2062 7920 7072 6563 6f6d 7075 rked by precompu │ │ │ │ │ -00029eb0: 7469 6e67 2064 6570 656e 6465 6e63 6965 ting dependencie │ │ │ │ │ -00029ec0: 7320 6168 6561 6420 6f66 2074 696d 652e s ahead of time. │ │ │ │ │ -00029ed0: 2020 466f 720a 6561 6368 2073 6f75 7263 For.each sourc │ │ │ │ │ -00029ee0: 6520 6669 6c65 2c20 6974 2068 6164 2061 e file, it had a │ │ │ │ │ -00029ef0: 2073 7065 6369 616c 2027 2e50 2720 6669 special '.P' fi │ │ │ │ │ -00029f00: 6c65 2074 6861 7420 6865 6c64 2074 6865 le that held the │ │ │ │ │ -00029f10: 2064 6570 656e 6465 6e63 6965 732e 0a54 dependencies..T │ │ │ │ │ -00029f20: 6865 7265 2077 6173 2061 2072 756c 6520 here was a rule │ │ │ │ │ -00029f30: 746f 2067 656e 6572 6174 6520 6120 272e to generate a '. │ │ │ │ │ -00029f40: 5027 2066 696c 6520 6279 2069 6e76 6f6b P' file by invok │ │ │ │ │ -00029f50: 696e 6720 7468 6520 636f 6d70 696c 6572 ing the compiler │ │ │ │ │ -00029f60: 0a61 7070 726f 7072 6961 7465 6c79 2e20 .appropriately. │ │ │ │ │ -00029f70: 2041 6c6c 2073 7563 6820 272e 5027 2066 All such '.P' f │ │ │ │ │ -00029f80: 696c 6573 2077 6572 6520 696e 636c 7564 iles were includ │ │ │ │ │ -00029f90: 6564 2062 7920 7468 6520 274d 616b 6566 ed by the 'Makef │ │ │ │ │ -00029fa0: 696c 6527 2c0a 7468 7573 2069 6d70 6c69 ile',.thus impli │ │ │ │ │ -00029fb0: 6369 746c 7920 6265 636f 6d69 6e67 2064 citly becoming d │ │ │ │ │ -00029fc0: 6570 656e 6465 6e63 6965 7320 6f66 2027 ependencies of ' │ │ │ │ │ -00029fd0: 4d61 6b65 6669 6c65 272e 0a0a 4275 6773 Makefile'...Bugs │ │ │ │ │ -00029fe0: 0a2e 2e2e 2e0a 0a54 6869 7320 6170 7072 .......This appr │ │ │ │ │ -00029ff0: 6f61 6368 2068 6164 2073 6576 6572 616c oach had several │ │ │ │ │ -0002a000: 2063 7269 7469 6361 6c20 6275 6773 2e0a critical bugs.. │ │ │ │ │ -0002a010: 0a20 2020 2a20 5468 6520 636f 6465 2074 . * The code t │ │ │ │ │ -0002a020: 6f20 6765 6e65 7261 7465 2074 6865 2027 o generate the ' │ │ │ │ │ -0002a030: 2e50 2720 6669 6c65 2072 656c 6965 6420 .P' file relied │ │ │ │ │ -0002a040: 6f6e 2027 6763 6327 2e20 2028 4120 6c69 on 'gcc'. (A li │ │ │ │ │ -0002a050: 6d69 7461 7469 6f6e 2c0a 2020 2020 206e mitation,. n │ │ │ │ │ -0002a060: 6f74 2074 6563 686e 6963 616c 6c79 2061 ot technically a │ │ │ │ │ -0002a070: 2062 7567 2e29 0a20 2020 2a20 5468 6520 bug.). * The │ │ │ │ │ -0002a080: 6465 7065 6e64 656e 6379 2074 7261 636b dependency track │ │ │ │ │ -0002a090: 696e 6720 6d65 6368 616e 6973 6d20 6974 ing mechanism it │ │ │ │ │ -0002a0a0: 7365 6c66 2072 656c 6965 6420 6f6e 2047 self relied on G │ │ │ │ │ -0002a0b0: 4e55 2027 6d61 6b65 272e 2020 2841 0a20 NU 'make'. (A. │ │ │ │ │ -0002a0c0: 2020 2020 6c69 6d69 7461 7469 6f6e 2c20 limitation, │ │ │ │ │ -0002a0d0: 6e6f 7420 7465 6368 6e69 6361 6c6c 7920 not technically │ │ │ │ │ -0002a0e0: 6120 6275 672e 290a 2020 202a 2042 6563 a bug.). * Bec │ │ │ │ │ -0002a0f0: 6175 7365 2065 6163 6820 272e 5027 2066 ause each '.P' f │ │ │ │ │ -0002a100: 696c 6520 7761 7320 6120 6465 7065 6e64 ile was a depend │ │ │ │ │ -0002a110: 656e 6379 206f 6620 274d 616b 6566 696c ency of 'Makefil │ │ │ │ │ -0002a120: 6527 2c20 7468 6973 206d 6561 6e74 0a20 e', this meant. │ │ │ │ │ -0002a130: 2020 2020 7468 6174 2064 6570 656e 6465 that depende │ │ │ │ │ -0002a140: 6e63 7920 7472 6163 6b69 6e67 2077 6173 ncy tracking was │ │ │ │ │ -0002a150: 2064 6f6e 6520 6561 6765 726c 7920 6279 done eagerly by │ │ │ │ │ -0002a160: 2027 6d61 6b65 272e 2020 466f 7220 696e 'make'. For in │ │ │ │ │ -0002a170: 7374 616e 6365 2c0a 2020 2020 2027 6d61 stance,. 'ma │ │ │ │ │ -0002a180: 6b65 2063 6c65 616e 2720 776f 756c 6420 ke clean' would │ │ │ │ │ -0002a190: 6361 7573 6520 616c 6c20 7468 6520 6465 cause all the de │ │ │ │ │ -0002a1a0: 7065 6e64 656e 6379 2066 696c 6573 2074 pendency files t │ │ │ │ │ -0002a1b0: 6f20 6265 2075 7064 6174 6564 2c0a 2020 o be updated,. │ │ │ │ │ -0002a1c0: 2020 2061 6e64 2074 6865 6e20 696d 6d65 and then imme │ │ │ │ │ -0002a1d0: 6469 6174 656c 7920 7265 6d6f 7665 642e diately removed. │ │ │ │ │ -0002a1e0: 2020 5468 6973 2065 6167 6572 6e65 7373 This eagerness │ │ │ │ │ -0002a1f0: 2061 6c73 6f20 6361 7573 6564 2070 726f also caused pro │ │ │ │ │ -0002a200: 626c 656d 730a 2020 2020 2077 6974 6820 blems. with │ │ │ │ │ -0002a210: 736f 6d65 2063 6f6e 6669 6775 7261 7469 some configurati │ │ │ │ │ -0002a220: 6f6e 733b 2069 6620 6120 6365 7274 6169 ons; if a certai │ │ │ │ │ -0002a230: 6e20 736f 7572 6365 2066 696c 6520 636f n source file co │ │ │ │ │ -0002a240: 756c 6420 6e6f 7420 6265 0a20 2020 2020 uld not be. │ │ │ │ │ -0002a250: 636f 6d70 696c 6564 206f 6e20 6120 6769 compiled on a gi │ │ │ │ │ -0002a260: 7665 6e20 6172 6368 6974 6563 7475 7265 ven architecture │ │ │ │ │ -0002a270: 2066 6f72 2073 6f6d 6520 7265 6173 6f6e for some reason │ │ │ │ │ -0002a280: 2c20 6465 7065 6e64 656e 6379 0a20 2020 , dependency. │ │ │ │ │ -0002a290: 2020 7472 6163 6b69 6e67 2077 6f75 6c64 tracking would │ │ │ │ │ -0002a2a0: 2066 6169 6c2c 2061 626f 7274 696e 6720 fail, aborting │ │ │ │ │ -0002a2b0: 7468 6520 656e 7469 7265 2062 7569 6c64 the entire build │ │ │ │ │ -0002a2c0: 2e0a 2020 202a 2041 7320 6465 7065 6e64 .. * As depend │ │ │ │ │ -0002a2d0: 656e 6379 2074 7261 636b 696e 6720 7761 ency tracking wa │ │ │ │ │ -0002a2e0: 7320 646f 6e65 2061 7320 6120 7072 652d s done as a pre- │ │ │ │ │ -0002a2f0: 7061 7373 2c20 636f 6d70 696c 6520 7469 pass, compile ti │ │ │ │ │ -0002a300: 6d65 7320 7765 7265 0a20 2020 2020 646f mes were. do │ │ │ │ │ -0002a310: 7562 6c65 642d 7468 6520 636f 6d70 696c ubled-the compil │ │ │ │ │ -0002a320: 6572 2068 6164 2074 6f20 6265 2072 756e er had to be run │ │ │ │ │ -0002a330: 2074 7769 6365 2070 6572 2073 6f75 7263 twice per sourc │ │ │ │ │ -0002a340: 6520 6669 6c65 2e0a 2020 202a 2027 6d61 e file.. * 'ma │ │ │ │ │ -0002a350: 6b65 2064 6973 7427 2072 652d 7261 6e20 ke dist' re-ran │ │ │ │ │ -0002a360: 2761 7574 6f6d 616b 6527 2074 6f20 6765 'automake' to ge │ │ │ │ │ -0002a370: 6e65 7261 7465 2061 2027 4d61 6b65 6669 nerate a 'Makefi │ │ │ │ │ -0002a380: 6c65 2720 7468 6174 2064 6964 206e 6f74 le' that did not │ │ │ │ │ -0002a390: 0a20 2020 2020 6861 7665 2061 7574 6f6d . have autom │ │ │ │ │ -0002a3a0: 6174 6963 2064 6570 656e 6465 6e63 7920 atic dependency │ │ │ │ │ -0002a3b0: 7472 6163 6b69 6e67 2028 616e 6420 7468 tracking (and th │ │ │ │ │ -0002a3c0: 6174 2077 6173 2074 6875 7320 706f 7274 at was thus port │ │ │ │ │ -0002a3d0: 6162 6c65 2074 6f0a 2020 2020 2061 6e79 able to. any │ │ │ │ │ -0002a3e0: 2076 6572 7369 6f6e 206f 6620 276d 616b version of 'mak │ │ │ │ │ -0002a3f0: 6527 292e 2020 496e 206f 7264 6572 2074 e'). In order t │ │ │ │ │ -0002a400: 6f20 646f 2074 6869 7320 706f 7274 6162 o do this portab │ │ │ │ │ -0002a410: 6c79 2c20 4175 746f 6d61 6b65 2068 6164 ly, Automake had │ │ │ │ │ -0002a420: 0a20 2020 2020 746f 2073 6361 6e20 7468 . to scan th │ │ │ │ │ -0002a430: 6520 6465 7065 6e64 656e 6379 2066 696c e dependency fil │ │ │ │ │ -0002a440: 6573 2061 6e64 2072 656d 6f76 6520 616e es and remove an │ │ │ │ │ -0002a450: 7920 7265 6665 7265 6e63 6520 7468 6174 y reference that │ │ │ │ │ -0002a460: 2077 6173 2074 6f20 610a 2020 2020 2073 was to a. s │ │ │ │ │ -0002a470: 6f75 7263 6520 6669 6c65 206e 6f74 2069 ource file not i │ │ │ │ │ -0002a480: 6e20 7468 6520 6469 7374 7269 6275 7469 n the distributi │ │ │ │ │ -0002a490: 6f6e 2e20 2054 6869 7320 7072 6f63 6573 on. This proces │ │ │ │ │ -0002a4a0: 7320 7761 7320 6572 726f 722d 7072 6f6e s was error-pron │ │ │ │ │ -0002a4b0: 652e 0a20 2020 2020 416c 736f 2c20 6966 e.. Also, if │ │ │ │ │ -0002a4c0: 2027 6d61 6b65 2064 6973 7427 2077 6173 'make dist' was │ │ │ │ │ -0002a4d0: 2072 756e 2069 6e20 616e 2065 6e76 6972 run in an envir │ │ │ │ │ -0002a4e0: 6f6e 6d65 6e74 2077 6865 7265 2073 6f6d onment where som │ │ │ │ │ -0002a4f0: 6520 6f62 6a65 6374 0a20 2020 2020 6669 e object. fi │ │ │ │ │ -0002a500: 6c65 2068 6164 2061 2064 6570 656e 6465 le had a depende │ │ │ │ │ -0002a510: 6e63 7920 6f6e 2061 2073 6f75 7263 6520 ncy on a source │ │ │ │ │ -0002a520: 6669 6c65 2074 6861 7420 7761 7320 6f6e file that was on │ │ │ │ │ -0002a530: 6c79 2063 6f6e 6469 7469 6f6e 616c 6c79 ly conditionally │ │ │ │ │ -0002a540: 0a20 2020 2020 6372 6561 7465 642c 2041 . created, A │ │ │ │ │ -0002a550: 7574 6f6d 616b 6520 776f 756c 6420 6765 utomake would ge │ │ │ │ │ -0002a560: 6e65 7261 7465 2061 2027 4d61 6b65 6669 nerate a 'Makefi │ │ │ │ │ -0002a570: 6c65 2720 7468 6174 2072 6566 6572 7265 le' that referre │ │ │ │ │ -0002a580: 6420 746f 2061 0a20 2020 2020 6669 6c65 d to a. file │ │ │ │ │ -0002a590: 2074 6861 7420 6d69 6768 7420 6e6f 7420 that might not │ │ │ │ │ -0002a5a0: 6170 7065 6172 2069 6e20 7468 6520 656e appear in the en │ │ │ │ │ -0002a5b0: 6420 7573 6572 2773 2062 7569 6c64 2e20 d user's build. │ │ │ │ │ -0002a5c0: 2041 2073 7065 6369 616c 2c0a 2020 2020 A special,. │ │ │ │ │ -0002a5d0: 2068 6163 6b79 206d 6563 6861 6e69 736d hacky mechanism │ │ │ │ │ -0002a5e0: 2077 6173 2072 6571 7569 7265 6420 746f was required to │ │ │ │ │ -0002a5f0: 2077 6f72 6b20 6172 6f75 6e64 2074 6869 work around thi │ │ │ │ │ -0002a600: 732e 0a0a 4869 7374 6f72 6963 616c 204e s...Historical N │ │ │ │ │ -0002a610: 6f74 650a 2e2e 2e2e 2e2e 2e2e 2e2e 2e2e ote............. │ │ │ │ │ -0002a620: 2e2e 2e0a 0a54 6865 2063 6f64 6520 6765 .....The code ge │ │ │ │ │ -0002a630: 6e65 7261 7465 6420 6279 2041 7574 6f6d nerated by Autom │ │ │ │ │ -0002a640: 616b 6520 6973 206f 6674 656e 2069 6e73 ake is often ins │ │ │ │ │ -0002a650: 7069 7265 6420 6279 2074 6865 2027 4d61 pired by the 'Ma │ │ │ │ │ -0002a660: 6b65 6669 6c65 2720 7374 796c 650a 6f66 kefile' style.of │ │ │ │ │ -0002a670: 2061 2070 6172 7469 6375 6c61 7220 6175 a particular au │ │ │ │ │ -0002a680: 7468 6f72 2e20 2049 6e20 7468 6520 6361 thor. In the ca │ │ │ │ │ -0002a690: 7365 206f 6620 7468 6520 6669 7273 7420 se of the first │ │ │ │ │ -0002a6a0: 696d 706c 656d 656e 7461 7469 6f6e 206f implementation o │ │ │ │ │ -0002a6b0: 660a 6465 7065 6e64 656e 6379 2074 7261 f.dependency tra │ │ │ │ │ -0002a6c0: 636b 696e 672c 2049 2062 656c 6965 7665 cking, I believe │ │ │ │ │ -0002a6d0: 2074 6865 2069 6d70 6574 7573 2061 6e64 the impetus and │ │ │ │ │ -0002a6e0: 2069 6e73 7069 7261 7469 6f6e 2077 6173 inspiration was │ │ │ │ │ -0002a6f0: 204a 696d 0a4d 6579 6572 696e 672e 2020 Jim.Meyering. │ │ │ │ │ -0002a700: 2849 2063 6f75 6c64 2062 6520 6d69 7374 (I could be mist │ │ │ │ │ -0002a710: 616b 656e 2e20 2049 6620 796f 7520 6b6e aken. If you kn │ │ │ │ │ -0002a720: 6f77 206f 7468 6572 7769 7365 2066 6565 ow otherwise fee │ │ │ │ │ -0002a730: 6c20 6672 6565 2074 6f0a 636f 7272 6563 l free to.correc │ │ │ │ │ -0002a740: 7420 6d65 2e29 0a0a 1f0a 4669 6c65 3a20 t me.)....File: │ │ │ │ │ -0002a750: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -0002a760: 666f 2c20 204e 6f64 653a 2044 6570 656e fo, Node: Depen │ │ │ │ │ -0002a770: 6465 6e63 6965 7320 4173 2053 6964 6520 dencies As Side │ │ │ │ │ -0002a780: 4566 6665 6374 732c 2020 4e65 7874 3a20 Effects, Next: │ │ │ │ │ -0002a790: 4465 7065 6e64 656e 6369 6573 2066 6f72 Dependencies for │ │ │ │ │ -0002a7a0: 2074 6865 2055 7365 722c 2020 5072 6576 the User, Prev │ │ │ │ │ -0002a7b0: 3a20 4669 7273 7420 5461 6b65 206f 6e20 : First Take on │ │ │ │ │ -0002a7c0: 4465 7065 6e64 656e 6369 6573 2c20 2055 Dependencies, U │ │ │ │ │ -0002a7d0: 703a 2044 6570 656e 6465 6e63 7920 5472 p: Dependency Tr │ │ │ │ │ -0002a7e0: 6163 6b69 6e67 2045 766f 6c75 7469 6f6e acking Evolution │ │ │ │ │ -0002a7f0: 0a0a 3239 2e32 2e32 2044 6570 656e 6465 ..29.2.2 Depende │ │ │ │ │ -0002a800: 6e63 6965 7320 4173 2053 6964 6520 4566 ncies As Side Ef │ │ │ │ │ -0002a810: 6665 6374 730a 2d2d 2d2d 2d2d 2d2d 2d2d fects.---------- │ │ │ │ │ +00029db0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a44 -------------..D │ │ │ │ │ +00029dc0: 6573 6372 6970 7469 6f6e 0a2e 2e2e 2e2e escription...... │ │ │ │ │ +00029dd0: 2e2e 2e2e 2e2e 0a0a 4f75 7220 6669 7273 ........Our firs │ │ │ │ │ +00029de0: 7420 6174 7465 6d70 7420 6174 2061 7574 t attempt at aut │ │ │ │ │ +00029df0: 6f6d 6174 6963 2064 6570 656e 6465 6e63 omatic dependenc │ │ │ │ │ +00029e00: 7920 7472 6163 6b69 6e67 2077 6173 2062 y tracking was b │ │ │ │ │ +00029e10: 6173 6564 206f 6e20 7468 650a 6d65 7468 ased on the.meth │ │ │ │ │ +00029e20: 6f64 2072 6563 6f6d 6d65 6e64 6564 2062 od recommended b │ │ │ │ │ +00029e30: 7920 474e 5520 276d 616b 6527 2e20 2028 y GNU 'make'. ( │ │ │ │ │ +00029e40: 2a6e 6f74 6520 4765 6e65 7261 7469 6e67 *note Generating │ │ │ │ │ +00029e50: 2050 7265 7265 7175 6973 6974 6573 0a41 Prerequisites.A │ │ │ │ │ +00029e60: 7574 6f6d 6174 6963 616c 6c79 3a20 286d utomatically: (m │ │ │ │ │ +00029e70: 616b 6529 4175 746f 6d61 7469 6320 5072 ake)Automatic Pr │ │ │ │ │ +00029e80: 6572 6571 7569 7369 7465 732e 290a 0a20 erequisites.).. │ │ │ │ │ +00029e90: 2020 5468 6973 2076 6572 7369 6f6e 2077 This version w │ │ │ │ │ +00029ea0: 6f72 6b65 6420 6279 2070 7265 636f 6d70 orked by precomp │ │ │ │ │ +00029eb0: 7574 696e 6720 6465 7065 6e64 656e 6369 uting dependenci │ │ │ │ │ +00029ec0: 6573 2061 6865 6164 206f 6620 7469 6d65 es ahead of time │ │ │ │ │ +00029ed0: 2e20 2046 6f72 0a65 6163 6820 736f 7572 . For.each sour │ │ │ │ │ +00029ee0: 6365 2066 696c 652c 2069 7420 6861 6420 ce file, it had │ │ │ │ │ +00029ef0: 6120 7370 6563 6961 6c20 272e 5027 2066 a special '.P' f │ │ │ │ │ +00029f00: 696c 6520 7468 6174 2068 656c 6420 7468 ile that held th │ │ │ │ │ +00029f10: 6520 6465 7065 6e64 656e 6369 6573 2e0a e dependencies.. │ │ │ │ │ +00029f20: 5468 6572 6520 7761 7320 6120 7275 6c65 There was a rule │ │ │ │ │ +00029f30: 2074 6f20 6765 6e65 7261 7465 2061 2027 to generate a ' │ │ │ │ │ +00029f40: 2e50 2720 6669 6c65 2062 7920 696e 766f .P' file by invo │ │ │ │ │ +00029f50: 6b69 6e67 2074 6865 2063 6f6d 7069 6c65 king the compile │ │ │ │ │ +00029f60: 720a 6170 7072 6f70 7269 6174 656c 792e r.appropriately. │ │ │ │ │ +00029f70: 2020 416c 6c20 7375 6368 2027 2e50 2720 All such '.P' │ │ │ │ │ +00029f80: 6669 6c65 7320 7765 7265 2069 6e63 6c75 files were inclu │ │ │ │ │ +00029f90: 6465 6420 6279 2074 6865 2027 4d61 6b65 ded by the 'Make │ │ │ │ │ +00029fa0: 6669 6c65 272c 0a74 6875 7320 696d 706c file',.thus impl │ │ │ │ │ +00029fb0: 6963 6974 6c79 2062 6563 6f6d 696e 6720 icitly becoming │ │ │ │ │ +00029fc0: 6465 7065 6e64 656e 6369 6573 206f 6620 dependencies of │ │ │ │ │ +00029fd0: 274d 616b 6566 696c 6527 2e0a 0a42 7567 'Makefile'...Bug │ │ │ │ │ +00029fe0: 730a 2e2e 2e2e 0a0a 5468 6973 2061 7070 s.......This app │ │ │ │ │ +00029ff0: 726f 6163 6820 6861 6420 7365 7665 7261 roach had severa │ │ │ │ │ +0002a000: 6c20 6372 6974 6963 616c 2062 7567 732e l critical bugs. │ │ │ │ │ +0002a010: 0a0a 2020 202a 2054 6865 2063 6f64 6520 .. * The code │ │ │ │ │ +0002a020: 746f 2067 656e 6572 6174 6520 7468 6520 to generate the │ │ │ │ │ +0002a030: 272e 5027 2066 696c 6520 7265 6c69 6564 '.P' file relied │ │ │ │ │ +0002a040: 206f 6e20 2767 6363 272e 2020 2841 206c on 'gcc'. (A l │ │ │ │ │ +0002a050: 696d 6974 6174 696f 6e2c 0a20 2020 2020 imitation,. │ │ │ │ │ +0002a060: 6e6f 7420 7465 6368 6e69 6361 6c6c 7920 not technically │ │ │ │ │ +0002a070: 6120 6275 672e 290a 2020 202a 2054 6865 a bug.). * The │ │ │ │ │ +0002a080: 2064 6570 656e 6465 6e63 7920 7472 6163 dependency trac │ │ │ │ │ +0002a090: 6b69 6e67 206d 6563 6861 6e69 736d 2069 king mechanism i │ │ │ │ │ +0002a0a0: 7473 656c 6620 7265 6c69 6564 206f 6e20 tself relied on │ │ │ │ │ +0002a0b0: 474e 5520 276d 616b 6527 2e20 2028 410a GNU 'make'. (A. │ │ │ │ │ +0002a0c0: 2020 2020 206c 696d 6974 6174 696f 6e2c limitation, │ │ │ │ │ +0002a0d0: 206e 6f74 2074 6563 686e 6963 616c 6c79 not technically │ │ │ │ │ +0002a0e0: 2061 2062 7567 2e29 0a20 2020 2a20 4265 a bug.). * Be │ │ │ │ │ +0002a0f0: 6361 7573 6520 6561 6368 2027 2e50 2720 cause each '.P' │ │ │ │ │ +0002a100: 6669 6c65 2077 6173 2061 2064 6570 656e file was a depen │ │ │ │ │ +0002a110: 6465 6e63 7920 6f66 2027 4d61 6b65 6669 dency of 'Makefi │ │ │ │ │ +0002a120: 6c65 272c 2074 6869 7320 6d65 616e 740a le', this meant. │ │ │ │ │ +0002a130: 2020 2020 2074 6861 7420 6465 7065 6e64 that depend │ │ │ │ │ +0002a140: 656e 6379 2074 7261 636b 696e 6720 7761 ency tracking wa │ │ │ │ │ +0002a150: 7320 646f 6e65 2065 6167 6572 6c79 2062 s done eagerly b │ │ │ │ │ +0002a160: 7920 276d 616b 6527 2e20 2046 6f72 2069 y 'make'. For i │ │ │ │ │ +0002a170: 6e73 7461 6e63 652c 0a20 2020 2020 276d nstance,. 'm │ │ │ │ │ +0002a180: 616b 6520 636c 6561 6e27 2077 6f75 6c64 ake clean' would │ │ │ │ │ +0002a190: 2063 6175 7365 2061 6c6c 2074 6865 2064 cause all the d │ │ │ │ │ +0002a1a0: 6570 656e 6465 6e63 7920 6669 6c65 7320 ependency files │ │ │ │ │ +0002a1b0: 746f 2062 6520 7570 6461 7465 642c 0a20 to be updated,. │ │ │ │ │ +0002a1c0: 2020 2020 616e 6420 7468 656e 2069 6d6d and then imm │ │ │ │ │ +0002a1d0: 6564 6961 7465 6c79 2072 656d 6f76 6564 ediately removed │ │ │ │ │ +0002a1e0: 2e20 2054 6869 7320 6561 6765 726e 6573 . This eagernes │ │ │ │ │ +0002a1f0: 7320 616c 736f 2063 6175 7365 6420 7072 s also caused pr │ │ │ │ │ +0002a200: 6f62 6c65 6d73 0a20 2020 2020 7769 7468 oblems. with │ │ │ │ │ +0002a210: 2073 6f6d 6520 636f 6e66 6967 7572 6174 some configurat │ │ │ │ │ +0002a220: 696f 6e73 3b20 6966 2061 2063 6572 7461 ions; if a certa │ │ │ │ │ +0002a230: 696e 2073 6f75 7263 6520 6669 6c65 2063 in source file c │ │ │ │ │ +0002a240: 6f75 6c64 206e 6f74 2062 650a 2020 2020 ould not be. │ │ │ │ │ +0002a250: 2063 6f6d 7069 6c65 6420 6f6e 2061 2067 compiled on a g │ │ │ │ │ +0002a260: 6976 656e 2061 7263 6869 7465 6374 7572 iven architectur │ │ │ │ │ +0002a270: 6520 666f 7220 736f 6d65 2072 6561 736f e for some reaso │ │ │ │ │ +0002a280: 6e2c 2064 6570 656e 6465 6e63 790a 2020 n, dependency. │ │ │ │ │ +0002a290: 2020 2074 7261 636b 696e 6720 776f 756c tracking woul │ │ │ │ │ +0002a2a0: 6420 6661 696c 2c20 6162 6f72 7469 6e67 d fail, aborting │ │ │ │ │ +0002a2b0: 2074 6865 2065 6e74 6972 6520 6275 696c the entire buil │ │ │ │ │ +0002a2c0: 642e 0a20 2020 2a20 4173 2064 6570 656e d.. * As depen │ │ │ │ │ +0002a2d0: 6465 6e63 7920 7472 6163 6b69 6e67 2077 dency tracking w │ │ │ │ │ +0002a2e0: 6173 2064 6f6e 6520 6173 2061 2070 7265 as done as a pre │ │ │ │ │ +0002a2f0: 2d70 6173 732c 2063 6f6d 7069 6c65 2074 -pass, compile t │ │ │ │ │ +0002a300: 696d 6573 2077 6572 650a 2020 2020 2064 imes were. d │ │ │ │ │ +0002a310: 6f75 626c 6564 2d74 6865 2063 6f6d 7069 oubled-the compi │ │ │ │ │ +0002a320: 6c65 7220 6861 6420 746f 2062 6520 7275 ler had to be ru │ │ │ │ │ +0002a330: 6e20 7477 6963 6520 7065 7220 736f 7572 n twice per sour │ │ │ │ │ +0002a340: 6365 2066 696c 652e 0a20 2020 2a20 276d ce file.. * 'm │ │ │ │ │ +0002a350: 616b 6520 6469 7374 2720 7265 2d72 616e ake dist' re-ran │ │ │ │ │ +0002a360: 2027 6175 746f 6d61 6b65 2720 746f 2067 'automake' to g │ │ │ │ │ +0002a370: 656e 6572 6174 6520 6120 274d 616b 6566 enerate a 'Makef │ │ │ │ │ +0002a380: 696c 6527 2074 6861 7420 6469 6420 6e6f ile' that did no │ │ │ │ │ +0002a390: 740a 2020 2020 2068 6176 6520 6175 746f t. have auto │ │ │ │ │ +0002a3a0: 6d61 7469 6320 6465 7065 6e64 656e 6379 matic dependency │ │ │ │ │ +0002a3b0: 2074 7261 636b 696e 6720 2861 6e64 2074 tracking (and t │ │ │ │ │ +0002a3c0: 6861 7420 7761 7320 7468 7573 2070 6f72 hat was thus por │ │ │ │ │ +0002a3d0: 7461 626c 6520 746f 0a20 2020 2020 616e table to. an │ │ │ │ │ +0002a3e0: 7920 7665 7273 696f 6e20 6f66 2027 6d61 y version of 'ma │ │ │ │ │ +0002a3f0: 6b65 2729 2e20 2049 6e20 6f72 6465 7220 ke'). In order │ │ │ │ │ +0002a400: 746f 2064 6f20 7468 6973 2070 6f72 7461 to do this porta │ │ │ │ │ +0002a410: 626c 792c 2041 7574 6f6d 616b 6520 6861 bly, Automake ha │ │ │ │ │ +0002a420: 640a 2020 2020 2074 6f20 7363 616e 2074 d. to scan t │ │ │ │ │ +0002a430: 6865 2064 6570 656e 6465 6e63 7920 6669 he dependency fi │ │ │ │ │ +0002a440: 6c65 7320 616e 6420 7265 6d6f 7665 2061 les and remove a │ │ │ │ │ +0002a450: 6e79 2072 6566 6572 656e 6365 2074 6861 ny reference tha │ │ │ │ │ +0002a460: 7420 7761 7320 746f 2061 0a20 2020 2020 t was to a. │ │ │ │ │ +0002a470: 736f 7572 6365 2066 696c 6520 6e6f 7420 source file not │ │ │ │ │ +0002a480: 696e 2074 6865 2064 6973 7472 6962 7574 in the distribut │ │ │ │ │ +0002a490: 696f 6e2e 2020 5468 6973 2070 726f 6365 ion. This proce │ │ │ │ │ +0002a4a0: 7373 2077 6173 2065 7272 6f72 2d70 726f ss was error-pro │ │ │ │ │ +0002a4b0: 6e65 2e0a 2020 2020 2041 6c73 6f2c 2069 ne.. Also, i │ │ │ │ │ +0002a4c0: 6620 276d 616b 6520 6469 7374 2720 7761 f 'make dist' wa │ │ │ │ │ +0002a4d0: 7320 7275 6e20 696e 2061 6e20 656e 7669 s run in an envi │ │ │ │ │ +0002a4e0: 726f 6e6d 656e 7420 7768 6572 6520 736f ronment where so │ │ │ │ │ +0002a4f0: 6d65 206f 626a 6563 740a 2020 2020 2066 me object. f │ │ │ │ │ +0002a500: 696c 6520 6861 6420 6120 6465 7065 6e64 ile had a depend │ │ │ │ │ +0002a510: 656e 6379 206f 6e20 6120 736f 7572 6365 ency on a source │ │ │ │ │ +0002a520: 2066 696c 6520 7468 6174 2077 6173 206f file that was o │ │ │ │ │ +0002a530: 6e6c 7920 636f 6e64 6974 696f 6e61 6c6c nly conditionall │ │ │ │ │ +0002a540: 790a 2020 2020 2063 7265 6174 6564 2c20 y. created, │ │ │ │ │ +0002a550: 4175 746f 6d61 6b65 2077 6f75 6c64 2067 Automake would g │ │ │ │ │ +0002a560: 656e 6572 6174 6520 6120 274d 616b 6566 enerate a 'Makef │ │ │ │ │ +0002a570: 696c 6527 2074 6861 7420 7265 6665 7272 ile' that referr │ │ │ │ │ +0002a580: 6564 2074 6f20 610a 2020 2020 2066 696c ed to a. fil │ │ │ │ │ +0002a590: 6520 7468 6174 206d 6967 6874 206e 6f74 e that might not │ │ │ │ │ +0002a5a0: 2061 7070 6561 7220 696e 2074 6865 2065 appear in the e │ │ │ │ │ +0002a5b0: 6e64 2075 7365 7227 7320 6275 696c 642e nd user's build. │ │ │ │ │ +0002a5c0: 2020 4120 7370 6563 6961 6c2c 0a20 2020 A special,. │ │ │ │ │ +0002a5d0: 2020 6861 636b 7920 6d65 6368 616e 6973 hacky mechanis │ │ │ │ │ +0002a5e0: 6d20 7761 7320 7265 7175 6972 6564 2074 m was required t │ │ │ │ │ +0002a5f0: 6f20 776f 726b 2061 726f 756e 6420 7468 o work around th │ │ │ │ │ +0002a600: 6973 2e0a 0a48 6973 746f 7269 6361 6c20 is...Historical │ │ │ │ │ +0002a610: 4e6f 7465 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e Note............ │ │ │ │ │ +0002a620: 2e2e 2e2e 0a0a 5468 6520 636f 6465 2067 ......The code g │ │ │ │ │ +0002a630: 656e 6572 6174 6564 2062 7920 4175 746f enerated by Auto │ │ │ │ │ +0002a640: 6d61 6b65 2069 7320 6f66 7465 6e20 696e make is often in │ │ │ │ │ +0002a650: 7370 6972 6564 2062 7920 7468 6520 274d spired by the 'M │ │ │ │ │ +0002a660: 616b 6566 696c 6527 2073 7479 6c65 0a6f akefile' style.o │ │ │ │ │ +0002a670: 6620 6120 7061 7274 6963 756c 6172 2061 f a particular a │ │ │ │ │ +0002a680: 7574 686f 722e 2020 496e 2074 6865 2063 uthor. In the c │ │ │ │ │ +0002a690: 6173 6520 6f66 2074 6865 2066 6972 7374 ase of the first │ │ │ │ │ +0002a6a0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e20 implementation │ │ │ │ │ +0002a6b0: 6f66 0a64 6570 656e 6465 6e63 7920 7472 of.dependency tr │ │ │ │ │ +0002a6c0: 6163 6b69 6e67 2c20 4920 6265 6c69 6576 acking, I believ │ │ │ │ │ +0002a6d0: 6520 7468 6520 696d 7065 7475 7320 616e e the impetus an │ │ │ │ │ +0002a6e0: 6420 696e 7370 6972 6174 696f 6e20 7761 d inspiration wa │ │ │ │ │ +0002a6f0: 7320 4a69 6d0a 4d65 7965 7269 6e67 2e20 s Jim.Meyering. │ │ │ │ │ +0002a700: 2028 4920 636f 756c 6420 6265 206d 6973 (I could be mis │ │ │ │ │ +0002a710: 7461 6b65 6e2e 2020 4966 2079 6f75 206b taken. If you k │ │ │ │ │ +0002a720: 6e6f 7720 6f74 6865 7277 6973 6520 6665 now otherwise fe │ │ │ │ │ +0002a730: 656c 2066 7265 6520 746f 0a63 6f72 7265 el free to.corre │ │ │ │ │ +0002a740: 6374 206d 652e 290a 0a1f 0a46 696c 653a ct me.)....File: │ │ │ │ │ +0002a750: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +0002a760: 6e66 6f2c 2020 4e6f 6465 3a20 4465 7065 nfo, Node: Depe │ │ │ │ │ +0002a770: 6e64 656e 6369 6573 2041 7320 5369 6465 ndencies As Side │ │ │ │ │ +0002a780: 2045 6666 6563 7473 2c20 204e 6578 743a Effects, Next: │ │ │ │ │ +0002a790: 2044 6570 656e 6465 6e63 6965 7320 666f Dependencies fo │ │ │ │ │ +0002a7a0: 7220 7468 6520 5573 6572 2c20 2050 7265 r the User, Pre │ │ │ │ │ +0002a7b0: 763a 2046 6972 7374 2054 616b 6520 6f6e v: First Take on │ │ │ │ │ +0002a7c0: 2044 6570 656e 6465 6e63 6965 732c 2020 Dependencies, │ │ │ │ │ +0002a7d0: 5570 3a20 4465 7065 6e64 656e 6379 2054 Up: Dependency T │ │ │ │ │ +0002a7e0: 7261 636b 696e 6720 4576 6f6c 7574 696f racking Evolutio │ │ │ │ │ +0002a7f0: 6e0a 0a32 392e 322e 3220 4465 7065 6e64 n..29.2.2 Depend │ │ │ │ │ +0002a800: 656e 6369 6573 2041 7320 5369 6465 2045 encies As Side E │ │ │ │ │ +0002a810: 6666 6563 7473 0a2d 2d2d 2d2d 2d2d 2d2d ffects.--------- │ │ │ │ │ 0002a820: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002a830: 2d2d 2d2d 2d2d 2d2d 2d0a 0a44 6573 6372 ---------..Descr │ │ │ │ │ -0002a840: 6970 7469 6f6e 0a2e 2e2e 2e2e 2e2e 2e2e iption.......... │ │ │ │ │ -0002a850: 2e2e 0a0a 5468 6520 6e65 7874 2072 6566 ....The next ref │ │ │ │ │ -0002a860: 696e 656d 656e 7420 6f66 2041 7574 6f6d inement of Autom │ │ │ │ │ -0002a870: 616b 6527 7320 6175 746f 6d61 7469 6320 ake's automatic │ │ │ │ │ -0002a880: 6465 7065 6e64 656e 6379 2074 7261 636b dependency track │ │ │ │ │ -0002a890: 696e 6720 7363 6865 6d65 0a77 6173 2074 ing scheme.was t │ │ │ │ │ -0002a8a0: 6f20 696d 706c 656d 656e 7420 6465 7065 o implement depe │ │ │ │ │ -0002a8b0: 6e64 656e 6369 6573 2061 7320 7369 6465 ndencies as side │ │ │ │ │ -0002a8c0: 2065 6666 6563 7473 206f 6620 7468 6520 effects of the │ │ │ │ │ -0002a8d0: 636f 6d70 696c 6174 696f 6e2e 2020 5468 compilation. Th │ │ │ │ │ -0002a8e0: 6973 0a77 6173 2061 696d 6564 2061 7420 is.was aimed at │ │ │ │ │ -0002a8f0: 736f 6c76 696e 6720 7468 6520 6d6f 7374 solving the most │ │ │ │ │ -0002a900: 2063 6f6d 6d6f 6e6c 7920 7265 706f 7274 commonly report │ │ │ │ │ -0002a910: 6564 2070 726f 626c 656d 7320 7769 7468 ed problems with │ │ │ │ │ -0002a920: 2074 6865 2066 6972 7374 0a61 7070 726f the first.appro │ │ │ │ │ -0002a930: 6163 682e 2020 496e 2070 6172 7469 6375 ach. In particu │ │ │ │ │ -0002a940: 6c61 7220 7765 2077 6572 6520 6d6f 7374 lar we were most │ │ │ │ │ -0002a950: 2063 6f6e 6365 726e 6564 2077 6974 6820 concerned with │ │ │ │ │ -0002a960: 656c 696d 696e 6174 696e 6720 7468 650a eliminating the. │ │ │ │ │ -0002a970: 7765 6972 6420 7265 6275 696c 6469 6e67 weird rebuilding │ │ │ │ │ -0002a980: 2065 6666 6563 7420 6173 736f 6369 6174 effect associat │ │ │ │ │ -0002a990: 6564 2077 6974 6820 6d61 6b65 2063 6c65 ed with make cle │ │ │ │ │ -0002a9a0: 616e 2e0a 0a20 2020 496e 2074 6869 7320 an... In this │ │ │ │ │ -0002a9b0: 6170 7072 6f61 6368 2c20 7468 6520 272e approach, the '. │ │ │ │ │ -0002a9c0: 5027 2066 696c 6573 2077 6572 6520 696e P' files were in │ │ │ │ │ -0002a9d0: 636c 7564 6564 2075 7369 6e67 2074 6865 cluded using the │ │ │ │ │ -0002a9e0: 2027 2d69 6e63 6c75 6465 270a 636f 6d6d '-include'.comm │ │ │ │ │ -0002a9f0: 616e 642c 2077 6869 6368 206c 6574 2075 and, which let u │ │ │ │ │ -0002aa00: 7320 6372 6561 7465 2074 6865 7365 2066 s create these f │ │ │ │ │ -0002aa10: 696c 6573 206c 617a 696c 792e 2020 5468 iles lazily. Th │ │ │ │ │ -0002aa20: 6973 2061 766f 6964 6564 2074 6865 2027 is avoided the ' │ │ │ │ │ -0002aa30: 6d61 6b65 0a63 6c65 616e 2720 7072 6f62 make.clean' prob │ │ │ │ │ -0002aa40: 6c65 6d2e 0a0a 2020 2057 6520 6f6e 6c79 lem... We only │ │ │ │ │ -0002aa50: 2063 6f6d 7075 7465 6420 6465 7065 6e64 computed depend │ │ │ │ │ -0002aa60: 656e 6369 6573 2077 6865 6e20 6120 6669 encies when a fi │ │ │ │ │ -0002aa70: 6c65 2077 6173 2061 6374 7561 6c6c 7920 le was actually │ │ │ │ │ -0002aa80: 636f 6d70 696c 6564 2e0a 5468 6973 2061 compiled..This a │ │ │ │ │ -0002aa90: 766f 6964 6564 2074 6865 2070 6572 666f voided the perfo │ │ │ │ │ -0002aaa0: 726d 616e 6365 2070 656e 616c 7479 2061 rmance penalty a │ │ │ │ │ -0002aab0: 7373 6f63 6961 7465 6420 7769 7468 2073 ssociated with s │ │ │ │ │ -0002aac0: 6361 6e6e 696e 6720 6561 6368 2066 696c canning each fil │ │ │ │ │ -0002aad0: 650a 7477 6963 652e 2020 4974 2061 6c73 e.twice. It als │ │ │ │ │ -0002aae0: 6f20 6c65 7420 7573 2061 766f 6964 2074 o let us avoid t │ │ │ │ │ -0002aaf0: 6865 206f 7468 6572 2070 726f 626c 656d he other problem │ │ │ │ │ -0002ab00: 7320 6173 736f 6369 6174 6564 2077 6974 s associated wit │ │ │ │ │ -0002ab10: 6820 7468 650a 6669 7273 742c 2065 6167 h the.first, eag │ │ │ │ │ -0002ab20: 6572 2c20 696d 706c 656d 656e 7461 7469 er, implementati │ │ │ │ │ -0002ab30: 6f6e 2e20 2046 6f72 2069 6e73 7461 6e63 on. For instanc │ │ │ │ │ -0002ab40: 652c 2064 6570 656e 6465 6e63 6965 7320 e, dependencies │ │ │ │ │ -0002ab50: 776f 756c 6420 6e65 7665 7220 6265 0a67 would never be.g │ │ │ │ │ -0002ab60: 656e 6572 6174 6564 2066 6f72 2061 2073 enerated for a s │ │ │ │ │ -0002ab70: 6f75 7263 6520 6669 6c65 2074 6861 7420 ource file that │ │ │ │ │ -0002ab80: 7761 7320 6e6f 7420 636f 6d70 696c 6162 was not compilab │ │ │ │ │ -0002ab90: 6c65 206f 6e20 6120 6769 7665 6e0a 6172 le on a given.ar │ │ │ │ │ -0002aba0: 6368 6974 6563 7475 7265 2028 6265 6361 chitecture (beca │ │ │ │ │ -0002abb0: 7573 6520 6974 2069 6e20 6661 6374 2077 use it in fact w │ │ │ │ │ -0002abc0: 6f75 6c64 206e 6576 6572 2062 6520 636f ould never be co │ │ │ │ │ -0002abd0: 6d70 696c 6564 292e 0a0a 4275 6773 0a2e mpiled)...Bugs.. │ │ │ │ │ -0002abe0: 2e2e 2e0a 0a20 2020 2a20 5468 6973 2061 ..... * This a │ │ │ │ │ -0002abf0: 7070 726f 6163 6820 616c 736f 2072 656c pproach also rel │ │ │ │ │ -0002ac00: 6965 6420 6f6e 2074 6865 2065 7869 7374 ied on the exist │ │ │ │ │ -0002ac10: 656e 6365 206f 6620 2767 6363 2720 616e ence of 'gcc' an │ │ │ │ │ -0002ac20: 6420 474e 5520 276d 616b 6527 2e0a 2020 d GNU 'make'.. │ │ │ │ │ -0002ac30: 2020 2028 4120 6c69 6d69 7461 7469 6f6e (A limitation │ │ │ │ │ -0002ac40: 2c20 6e6f 7420 7465 6368 6e69 6361 6c6c , not technicall │ │ │ │ │ -0002ac50: 7920 6120 6275 672e 290a 2020 202a 2044 y a bug.). * D │ │ │ │ │ -0002ac60: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ -0002ac70: 6e67 2077 6173 2073 7469 6c6c 2064 6f6e ng was still don │ │ │ │ │ -0002ac80: 6520 6279 2074 6865 2064 6576 656c 6f70 e by the develop │ │ │ │ │ -0002ac90: 6572 2c20 736f 2074 6865 0a20 2020 2020 er, so the. │ │ │ │ │ -0002aca0: 7072 6f62 6c65 6d73 2066 726f 6d20 7468 problems from th │ │ │ │ │ -0002acb0: 6520 6669 7273 7420 696d 706c 656d 656e e first implemen │ │ │ │ │ -0002acc0: 7461 7469 6f6e 2072 656c 6174 696e 6720 tation relating │ │ │ │ │ -0002acd0: 746f 206d 6173 7361 6769 6e67 206f 660a to massaging of. │ │ │ │ │ -0002ace0: 2020 2020 2064 6570 656e 6465 6e63 6965 dependencie │ │ │ │ │ -0002acf0: 7320 6279 2027 6d61 6b65 2064 6973 7427 s by 'make dist' │ │ │ │ │ -0002ad00: 2077 6572 6520 7374 696c 6c20 696e 2065 were still in e │ │ │ │ │ -0002ad10: 6666 6563 742e 0a20 2020 2a20 5468 6973 ffect.. * This │ │ │ │ │ -0002ad20: 2069 6d70 6c65 6d65 6e74 6174 696f 6e20 implementation │ │ │ │ │ -0002ad30: 7375 6666 6572 6564 2066 726f 6d20 7468 suffered from th │ │ │ │ │ -0002ad40: 6520 2264 656c 6574 6564 2068 6561 6465 e "deleted heade │ │ │ │ │ -0002ad50: 7220 6669 6c65 220a 2020 2020 2070 726f r file". pro │ │ │ │ │ -0002ad60: 626c 656d 2e20 2053 7570 706f 7365 2061 blem. Suppose a │ │ │ │ │ -0002ad70: 206c 617a 696c 792d 6372 6561 7465 6420 lazily-created │ │ │ │ │ -0002ad80: 272e 5027 2066 696c 6520 696e 636c 7564 '.P' file includ │ │ │ │ │ -0002ad90: 6573 2061 2064 6570 656e 6465 6e63 790a es a dependency. │ │ │ │ │ -0002ada0: 2020 2020 206f 6e20 6120 6769 7665 6e20 on a given │ │ │ │ │ -0002adb0: 6865 6164 6572 2066 696c 652c 206c 696b header file, lik │ │ │ │ │ -0002adc0: 6520 7468 6973 3a0a 0a20 2020 2020 2020 e this:.. │ │ │ │ │ -0002add0: 2020 206d 6175 6465 2e6f 3a20 6d61 7564 maude.o: maud │ │ │ │ │ -0002ade0: 652e 6320 736f 6d65 7468 696e 672e 680a e.c something.h. │ │ │ │ │ -0002adf0: 0a20 2020 2020 4e6f 7720 7375 7070 6f73 . Now suppos │ │ │ │ │ -0002ae00: 6520 7468 6174 2079 6f75 2072 656d 6f76 e that you remov │ │ │ │ │ -0002ae10: 6520 2773 6f6d 6574 6869 6e67 2e68 2720 e 'something.h' │ │ │ │ │ -0002ae20: 616e 6420 7570 6461 7465 2027 6d61 7564 and update 'maud │ │ │ │ │ -0002ae30: 652e 6327 2073 6f0a 2020 2020 2074 6861 e.c' so. tha │ │ │ │ │ -0002ae40: 7420 7468 6973 2069 6e63 6c75 6465 2069 t this include i │ │ │ │ │ -0002ae50: 7320 6e6f 206c 6f6e 6765 7220 6e65 6564 s no longer need │ │ │ │ │ -0002ae60: 6564 2e20 2049 6620 796f 7520 7275 6e20 ed. If you run │ │ │ │ │ -0002ae70: 276d 616b 6527 2c20 796f 7520 7769 6c6c 'make', you will │ │ │ │ │ -0002ae80: 0a20 2020 2020 6765 7420 616e 2065 7272 . get an err │ │ │ │ │ -0002ae90: 6f72 2062 6563 6175 7365 2074 6865 7265 or because there │ │ │ │ │ -0002aea0: 2069 7320 6e6f 2077 6179 2074 6f20 6372 is no way to cr │ │ │ │ │ -0002aeb0: 6561 7465 2027 736f 6d65 7468 696e 672e eate 'something. │ │ │ │ │ -0002aec0: 6827 2e0a 0a20 2020 2020 5765 2066 6978 h'... We fix │ │ │ │ │ -0002aed0: 6564 2074 6869 7320 7072 6f62 6c65 6d20 ed this problem │ │ │ │ │ -0002aee0: 696e 2061 206c 6174 6572 2072 656c 6561 in a later relea │ │ │ │ │ -0002aef0: 7365 2062 7920 6675 7274 6865 7220 6d61 se by further ma │ │ │ │ │ -0002af00: 7373 6167 696e 6720 7468 650a 2020 2020 ssaging the. │ │ │ │ │ -0002af10: 206f 7574 7075 7420 6f66 2027 6763 6327 output of 'gcc' │ │ │ │ │ -0002af20: 2074 6f20 696e 636c 7564 6520 6120 6475 to include a du │ │ │ │ │ -0002af30: 6d6d 7920 6465 7065 6e64 656e 6379 2066 mmy dependency f │ │ │ │ │ -0002af40: 6f72 2065 6163 6820 6865 6164 6572 2066 or each header f │ │ │ │ │ -0002af50: 696c 652e 0a0a 1f0a 4669 6c65 3a20 6175 ile.....File: au │ │ │ │ │ -0002af60: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ -0002af70: 2c20 204e 6f64 653a 2044 6570 656e 6465 , Node: Depende │ │ │ │ │ -0002af80: 6e63 6965 7320 666f 7220 7468 6520 5573 ncies for the Us │ │ │ │ │ -0002af90: 6572 2c20 204e 6578 743a 2054 6563 686e er, Next: Techn │ │ │ │ │ -0002afa0: 6971 7565 7320 666f 7220 4465 7065 6e64 iques for Depend │ │ │ │ │ -0002afb0: 656e 6369 6573 2c20 2050 7265 763a 2044 encies, Prev: D │ │ │ │ │ -0002afc0: 6570 656e 6465 6e63 6965 7320 4173 2053 ependencies As S │ │ │ │ │ -0002afd0: 6964 6520 4566 6665 6374 732c 2020 5570 ide Effects, Up │ │ │ │ │ -0002afe0: 3a20 4465 7065 6e64 656e 6379 2054 7261 : Dependency Tra │ │ │ │ │ -0002aff0: 636b 696e 6720 4576 6f6c 7574 696f 6e0a cking Evolution. │ │ │ │ │ -0002b000: 0a32 392e 322e 3320 4465 7065 6e64 656e .29.2.3 Dependen │ │ │ │ │ -0002b010: 6369 6573 2066 6f72 2074 6865 2055 7365 cies for the Use │ │ │ │ │ -0002b020: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d r.-------------- │ │ │ │ │ +0002a830: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4465 7363 ----------..Desc │ │ │ │ │ +0002a840: 7269 7074 696f 6e0a 2e2e 2e2e 2e2e 2e2e ription......... │ │ │ │ │ +0002a850: 2e2e 2e0a 0a54 6865 206e 6578 7420 7265 .....The next re │ │ │ │ │ +0002a860: 6669 6e65 6d65 6e74 206f 6620 4175 746f finement of Auto │ │ │ │ │ +0002a870: 6d61 6b65 2773 2061 7574 6f6d 6174 6963 make's automatic │ │ │ │ │ +0002a880: 2064 6570 656e 6465 6e63 7920 7472 6163 dependency trac │ │ │ │ │ +0002a890: 6b69 6e67 2073 6368 656d 650a 7761 7320 king scheme.was │ │ │ │ │ +0002a8a0: 746f 2069 6d70 6c65 6d65 6e74 2064 6570 to implement dep │ │ │ │ │ +0002a8b0: 656e 6465 6e63 6965 7320 6173 2073 6964 endencies as sid │ │ │ │ │ +0002a8c0: 6520 6566 6665 6374 7320 6f66 2074 6865 e effects of the │ │ │ │ │ +0002a8d0: 2063 6f6d 7069 6c61 7469 6f6e 2e20 2054 compilation. T │ │ │ │ │ +0002a8e0: 6869 730a 7761 7320 6169 6d65 6420 6174 his.was aimed at │ │ │ │ │ +0002a8f0: 2073 6f6c 7669 6e67 2074 6865 206d 6f73 solving the mos │ │ │ │ │ +0002a900: 7420 636f 6d6d 6f6e 6c79 2072 6570 6f72 t commonly repor │ │ │ │ │ +0002a910: 7465 6420 7072 6f62 6c65 6d73 2077 6974 ted problems wit │ │ │ │ │ +0002a920: 6820 7468 6520 6669 7273 740a 6170 7072 h the first.appr │ │ │ │ │ +0002a930: 6f61 6368 2e20 2049 6e20 7061 7274 6963 oach. In partic │ │ │ │ │ +0002a940: 756c 6172 2077 6520 7765 7265 206d 6f73 ular we were mos │ │ │ │ │ +0002a950: 7420 636f 6e63 6572 6e65 6420 7769 7468 t concerned with │ │ │ │ │ +0002a960: 2065 6c69 6d69 6e61 7469 6e67 2074 6865 eliminating the │ │ │ │ │ +0002a970: 0a77 6569 7264 2072 6562 7569 6c64 696e .weird rebuildin │ │ │ │ │ +0002a980: 6720 6566 6665 6374 2061 7373 6f63 6961 g effect associa │ │ │ │ │ +0002a990: 7465 6420 7769 7468 206d 616b 6520 636c ted with make cl │ │ │ │ │ +0002a9a0: 6561 6e2e 0a0a 2020 2049 6e20 7468 6973 ean... In this │ │ │ │ │ +0002a9b0: 2061 7070 726f 6163 682c 2074 6865 2027 approach, the ' │ │ │ │ │ +0002a9c0: 2e50 2720 6669 6c65 7320 7765 7265 2069 .P' files were i │ │ │ │ │ +0002a9d0: 6e63 6c75 6465 6420 7573 696e 6720 7468 ncluded using th │ │ │ │ │ +0002a9e0: 6520 272d 696e 636c 7564 6527 0a63 6f6d e '-include'.com │ │ │ │ │ +0002a9f0: 6d61 6e64 2c20 7768 6963 6820 6c65 7420 mand, which let │ │ │ │ │ +0002aa00: 7573 2063 7265 6174 6520 7468 6573 6520 us create these │ │ │ │ │ +0002aa10: 6669 6c65 7320 6c61 7a69 6c79 2e20 2054 files lazily. T │ │ │ │ │ +0002aa20: 6869 7320 6176 6f69 6465 6420 7468 6520 his avoided the │ │ │ │ │ +0002aa30: 276d 616b 650a 636c 6561 6e27 2070 726f 'make.clean' pro │ │ │ │ │ +0002aa40: 626c 656d 2e0a 0a20 2020 5765 206f 6e6c blem... We onl │ │ │ │ │ +0002aa50: 7920 636f 6d70 7574 6564 2064 6570 656e y computed depen │ │ │ │ │ +0002aa60: 6465 6e63 6965 7320 7768 656e 2061 2066 dencies when a f │ │ │ │ │ +0002aa70: 696c 6520 7761 7320 6163 7475 616c 6c79 ile was actually │ │ │ │ │ +0002aa80: 2063 6f6d 7069 6c65 642e 0a54 6869 7320 compiled..This │ │ │ │ │ +0002aa90: 6176 6f69 6465 6420 7468 6520 7065 7266 avoided the perf │ │ │ │ │ +0002aaa0: 6f72 6d61 6e63 6520 7065 6e61 6c74 7920 ormance penalty │ │ │ │ │ +0002aab0: 6173 736f 6369 6174 6564 2077 6974 6820 associated with │ │ │ │ │ +0002aac0: 7363 616e 6e69 6e67 2065 6163 6820 6669 scanning each fi │ │ │ │ │ +0002aad0: 6c65 0a74 7769 6365 2e20 2049 7420 616c le.twice. It al │ │ │ │ │ +0002aae0: 736f 206c 6574 2075 7320 6176 6f69 6420 so let us avoid │ │ │ │ │ +0002aaf0: 7468 6520 6f74 6865 7220 7072 6f62 6c65 the other proble │ │ │ │ │ +0002ab00: 6d73 2061 7373 6f63 6961 7465 6420 7769 ms associated wi │ │ │ │ │ +0002ab10: 7468 2074 6865 0a66 6972 7374 2c20 6561 th the.first, ea │ │ │ │ │ +0002ab20: 6765 722c 2069 6d70 6c65 6d65 6e74 6174 ger, implementat │ │ │ │ │ +0002ab30: 696f 6e2e 2020 466f 7220 696e 7374 616e ion. For instan │ │ │ │ │ +0002ab40: 6365 2c20 6465 7065 6e64 656e 6369 6573 ce, dependencies │ │ │ │ │ +0002ab50: 2077 6f75 6c64 206e 6576 6572 2062 650a would never be. │ │ │ │ │ +0002ab60: 6765 6e65 7261 7465 6420 666f 7220 6120 generated for a │ │ │ │ │ +0002ab70: 736f 7572 6365 2066 696c 6520 7468 6174 source file that │ │ │ │ │ +0002ab80: 2077 6173 206e 6f74 2063 6f6d 7069 6c61 was not compila │ │ │ │ │ +0002ab90: 626c 6520 6f6e 2061 2067 6976 656e 0a61 ble on a given.a │ │ │ │ │ +0002aba0: 7263 6869 7465 6374 7572 6520 2862 6563 rchitecture (bec │ │ │ │ │ +0002abb0: 6175 7365 2069 7420 696e 2066 6163 7420 ause it in fact │ │ │ │ │ +0002abc0: 776f 756c 6420 6e65 7665 7220 6265 2063 would never be c │ │ │ │ │ +0002abd0: 6f6d 7069 6c65 6429 2e0a 0a42 7567 730a ompiled)...Bugs. │ │ │ │ │ +0002abe0: 2e2e 2e2e 0a0a 2020 202a 2054 6869 7320 ...... * This │ │ │ │ │ +0002abf0: 6170 7072 6f61 6368 2061 6c73 6f20 7265 approach also re │ │ │ │ │ +0002ac00: 6c69 6564 206f 6e20 7468 6520 6578 6973 lied on the exis │ │ │ │ │ +0002ac10: 7465 6e63 6520 6f66 2027 6763 6327 2061 tence of 'gcc' a │ │ │ │ │ +0002ac20: 6e64 2047 4e55 2027 6d61 6b65 272e 0a20 nd GNU 'make'.. │ │ │ │ │ +0002ac30: 2020 2020 2841 206c 696d 6974 6174 696f (A limitatio │ │ │ │ │ +0002ac40: 6e2c 206e 6f74 2074 6563 686e 6963 616c n, not technical │ │ │ │ │ +0002ac50: 6c79 2061 2062 7567 2e29 0a20 2020 2a20 ly a bug.). * │ │ │ │ │ +0002ac60: 4465 7065 6e64 656e 6379 2074 7261 636b Dependency track │ │ │ │ │ +0002ac70: 696e 6720 7761 7320 7374 696c 6c20 646f ing was still do │ │ │ │ │ +0002ac80: 6e65 2062 7920 7468 6520 6465 7665 6c6f ne by the develo │ │ │ │ │ +0002ac90: 7065 722c 2073 6f20 7468 650a 2020 2020 per, so the. │ │ │ │ │ +0002aca0: 2070 726f 626c 656d 7320 6672 6f6d 2074 problems from t │ │ │ │ │ +0002acb0: 6865 2066 6972 7374 2069 6d70 6c65 6d65 he first impleme │ │ │ │ │ +0002acc0: 6e74 6174 696f 6e20 7265 6c61 7469 6e67 ntation relating │ │ │ │ │ +0002acd0: 2074 6f20 6d61 7373 6167 696e 6720 6f66 to massaging of │ │ │ │ │ +0002ace0: 0a20 2020 2020 6465 7065 6e64 656e 6369 . dependenci │ │ │ │ │ +0002acf0: 6573 2062 7920 276d 616b 6520 6469 7374 es by 'make dist │ │ │ │ │ +0002ad00: 2720 7765 7265 2073 7469 6c6c 2069 6e20 ' were still in │ │ │ │ │ +0002ad10: 6566 6665 6374 2e0a 2020 202a 2054 6869 effect.. * Thi │ │ │ │ │ +0002ad20: 7320 696d 706c 656d 656e 7461 7469 6f6e s implementation │ │ │ │ │ +0002ad30: 2073 7566 6665 7265 6420 6672 6f6d 2074 suffered from t │ │ │ │ │ +0002ad40: 6865 2022 6465 6c65 7465 6420 6865 6164 he "deleted head │ │ │ │ │ +0002ad50: 6572 2066 696c 6522 0a20 2020 2020 7072 er file". pr │ │ │ │ │ +0002ad60: 6f62 6c65 6d2e 2020 5375 7070 6f73 6520 oblem. Suppose │ │ │ │ │ +0002ad70: 6120 6c61 7a69 6c79 2d63 7265 6174 6564 a lazily-created │ │ │ │ │ +0002ad80: 2027 2e50 2720 6669 6c65 2069 6e63 6c75 '.P' file inclu │ │ │ │ │ +0002ad90: 6465 7320 6120 6465 7065 6e64 656e 6379 des a dependency │ │ │ │ │ +0002ada0: 0a20 2020 2020 6f6e 2061 2067 6976 656e . on a given │ │ │ │ │ +0002adb0: 2068 6561 6465 7220 6669 6c65 2c20 6c69 header file, li │ │ │ │ │ +0002adc0: 6b65 2074 6869 733a 0a0a 2020 2020 2020 ke this:.. │ │ │ │ │ +0002add0: 2020 2020 6d61 7564 652e 6f3a 206d 6175 maude.o: mau │ │ │ │ │ +0002ade0: 6465 2e63 2073 6f6d 6574 6869 6e67 2e68 de.c something.h │ │ │ │ │ +0002adf0: 0a0a 2020 2020 204e 6f77 2073 7570 706f .. Now suppo │ │ │ │ │ +0002ae00: 7365 2074 6861 7420 796f 7520 7265 6d6f se that you remo │ │ │ │ │ +0002ae10: 7665 2027 736f 6d65 7468 696e 672e 6827 ve 'something.h' │ │ │ │ │ +0002ae20: 2061 6e64 2075 7064 6174 6520 276d 6175 and update 'mau │ │ │ │ │ +0002ae30: 6465 2e63 2720 736f 0a20 2020 2020 7468 de.c' so. th │ │ │ │ │ +0002ae40: 6174 2074 6869 7320 696e 636c 7564 6520 at this include │ │ │ │ │ +0002ae50: 6973 206e 6f20 6c6f 6e67 6572 206e 6565 is no longer nee │ │ │ │ │ +0002ae60: 6465 642e 2020 4966 2079 6f75 2072 756e ded. If you run │ │ │ │ │ +0002ae70: 2027 6d61 6b65 272c 2079 6f75 2077 696c 'make', you wil │ │ │ │ │ +0002ae80: 6c0a 2020 2020 2067 6574 2061 6e20 6572 l. get an er │ │ │ │ │ +0002ae90: 726f 7220 6265 6361 7573 6520 7468 6572 ror because ther │ │ │ │ │ +0002aea0: 6520 6973 206e 6f20 7761 7920 746f 2063 e is no way to c │ │ │ │ │ +0002aeb0: 7265 6174 6520 2773 6f6d 6574 6869 6e67 reate 'something │ │ │ │ │ +0002aec0: 2e68 272e 0a0a 2020 2020 2057 6520 6669 .h'... We fi │ │ │ │ │ +0002aed0: 7865 6420 7468 6973 2070 726f 626c 656d xed this problem │ │ │ │ │ +0002aee0: 2069 6e20 6120 6c61 7465 7220 7265 6c65 in a later rele │ │ │ │ │ +0002aef0: 6173 6520 6279 2066 7572 7468 6572 206d ase by further m │ │ │ │ │ +0002af00: 6173 7361 6769 6e67 2074 6865 0a20 2020 assaging the. │ │ │ │ │ +0002af10: 2020 6f75 7470 7574 206f 6620 2767 6363 output of 'gcc │ │ │ │ │ +0002af20: 2720 746f 2069 6e63 6c75 6465 2061 2064 ' to include a d │ │ │ │ │ +0002af30: 756d 6d79 2064 6570 656e 6465 6e63 7920 ummy dependency │ │ │ │ │ +0002af40: 666f 7220 6561 6368 2068 6561 6465 7220 for each header │ │ │ │ │ +0002af50: 6669 6c65 2e0a 0a1f 0a46 696c 653a 2061 file.....File: a │ │ │ │ │ +0002af60: 7574 6f6d 616b 652d 312e 3131 2e69 6e66 utomake-1.11.inf │ │ │ │ │ +0002af70: 6f2c 2020 4e6f 6465 3a20 4465 7065 6e64 o, Node: Depend │ │ │ │ │ +0002af80: 656e 6369 6573 2066 6f72 2074 6865 2055 encies for the U │ │ │ │ │ +0002af90: 7365 722c 2020 4e65 7874 3a20 5465 6368 ser, Next: Tech │ │ │ │ │ +0002afa0: 6e69 7175 6573 2066 6f72 2044 6570 656e niques for Depen │ │ │ │ │ +0002afb0: 6465 6e63 6965 732c 2020 5072 6576 3a20 dencies, Prev: │ │ │ │ │ +0002afc0: 4465 7065 6e64 656e 6369 6573 2041 7320 Dependencies As │ │ │ │ │ +0002afd0: 5369 6465 2045 6666 6563 7473 2c20 2055 Side Effects, U │ │ │ │ │ +0002afe0: 703a 2044 6570 656e 6465 6e63 7920 5472 p: Dependency Tr │ │ │ │ │ +0002aff0: 6163 6b69 6e67 2045 766f 6c75 7469 6f6e acking Evolution │ │ │ │ │ +0002b000: 0a0a 3239 2e32 2e33 2044 6570 656e 6465 ..29.2.3 Depende │ │ │ │ │ +0002b010: 6e63 6965 7320 666f 7220 7468 6520 5573 ncies for the Us │ │ │ │ │ +0002b020: 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d er.------------- │ │ │ │ │ 0002b030: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002b040: 2d2d 0a0a 4465 7363 7269 7074 696f 6e0a --..Description. │ │ │ │ │ -0002b050: 2e2e 2e2e 2e2e 2e2e 2e2e 2e0a 0a54 6865 .............The │ │ │ │ │ -0002b060: 2062 7567 7320 6173 736f 6369 6174 6564 bugs associated │ │ │ │ │ -0002b070: 2077 6974 6820 276d 616b 6520 6469 7374 with 'make dist │ │ │ │ │ -0002b080: 272c 206f 7665 7220 7469 6d65 2c20 6265 ', over time, be │ │ │ │ │ -0002b090: 6361 6d65 2061 2072 6561 6c20 7072 6f62 came a real prob │ │ │ │ │ -0002b0a0: 6c65 6d2e 0a50 6163 6b61 6765 7320 7573 lem..Packages us │ │ │ │ │ -0002b0b0: 696e 6720 4175 746f 6d61 6b65 2077 6572 ing Automake wer │ │ │ │ │ -0002b0c0: 6520 6265 696e 6720 6275 696c 7420 6f6e e being built on │ │ │ │ │ -0002b0d0: 2061 206c 6172 6765 206e 756d 6265 7220 a large number │ │ │ │ │ -0002b0e0: 6f66 2070 6c61 7466 6f72 6d73 2c0a 616e of platforms,.an │ │ │ │ │ -0002b0f0: 6420 7765 7265 2062 6563 6f6d 696e 6720 d were becoming │ │ │ │ │ -0002b100: 696e 6372 6561 7369 6e67 6c79 2063 6f6d increasingly com │ │ │ │ │ -0002b110: 706c 6578 2e20 2042 726f 6b65 6e20 6465 plex. Broken de │ │ │ │ │ -0002b120: 7065 6e64 656e 6369 6573 2077 6572 650a pendencies were. │ │ │ │ │ -0002b130: 6469 7374 7269 6275 7465 6420 696e 2022 distributed in " │ │ │ │ │ -0002b140: 706f 7274 6162 6c65 2220 274d 616b 6566 portable" 'Makef │ │ │ │ │ -0002b150: 696c 652e 696e 2773 2c20 6c65 6164 696e ile.in's, leadin │ │ │ │ │ -0002b160: 6720 746f 2075 7365 7220 636f 6d70 6c61 g to user compla │ │ │ │ │ -0002b170: 696e 7473 2e0a 416c 736f 2c20 7468 6520 ints..Also, the │ │ │ │ │ -0002b180: 7265 7175 6972 656d 656e 7420 666f 7220 requirement for │ │ │ │ │ -0002b190: 2767 6363 2720 616e 6420 474e 5520 276d 'gcc' and GNU 'm │ │ │ │ │ -0002b1a0: 616b 6527 2077 6173 2061 2063 6f6e 7374 ake' was a const │ │ │ │ │ -0002b1b0: 616e 7420 736f 7572 6365 206f 660a 6275 ant source of.bu │ │ │ │ │ -0002b1c0: 6720 7265 706f 7274 732e 2020 5468 6520 g reports. The │ │ │ │ │ -0002b1d0: 6e65 7874 2069 6d70 6c65 6d65 6e74 6174 next implementat │ │ │ │ │ -0002b1e0: 696f 6e20 6f66 2064 6570 656e 6465 6e63 ion of dependenc │ │ │ │ │ -0002b1f0: 7920 7472 6163 6b69 6e67 2061 696d 6564 y tracking aimed │ │ │ │ │ -0002b200: 2074 6f0a 7265 6d6f 7665 2074 6865 7365 to.remove these │ │ │ │ │ -0002b210: 2070 726f 626c 656d 732e 0a0a 2020 2057 problems... W │ │ │ │ │ -0002b220: 6520 7265 616c 697a 6564 2074 6861 7420 e realized that │ │ │ │ │ -0002b230: 7468 6520 6f6e 6c79 2074 7275 6c79 2072 the only truly r │ │ │ │ │ -0002b240: 656c 6961 626c 6520 7761 7920 746f 2061 eliable way to a │ │ │ │ │ -0002b250: 7574 6f6d 6174 6963 616c 6c79 2074 7261 utomatically tra │ │ │ │ │ -0002b260: 636b 0a64 6570 656e 6465 6e63 6965 7320 ck.dependencies │ │ │ │ │ -0002b270: 7761 7320 746f 2064 6f20 6974 2077 6865 was to do it whe │ │ │ │ │ -0002b280: 6e20 7468 6520 7061 636b 6167 6520 6974 n the package it │ │ │ │ │ -0002b290: 7365 6c66 2077 6173 2062 7569 6c74 2e20 self was built. │ │ │ │ │ -0002b2a0: 2054 6869 7320 6d65 616e 740a 6469 7363 This meant.disc │ │ │ │ │ -0002b2b0: 6f76 6572 696e 6720 6120 6d65 7468 6f64 overing a method │ │ │ │ │ -0002b2c0: 2070 6f72 7461 626c 6520 746f 2061 6e79 portable to any │ │ │ │ │ -0002b2d0: 2076 6572 7369 6f6e 206f 6620 6d61 6b65 version of make │ │ │ │ │ -0002b2e0: 2061 6e64 2061 6e79 2063 6f6d 7069 6c65 and any compile │ │ │ │ │ -0002b2f0: 722e 0a41 6c73 6f2c 2077 6520 7761 6e74 r..Also, we want │ │ │ │ │ -0002b300: 6564 2074 6f20 7072 6573 6572 7665 2077 ed to preserve w │ │ │ │ │ -0002b310: 6861 7420 7765 2073 6177 2061 7320 7468 hat we saw as th │ │ │ │ │ -0002b320: 6520 6265 7374 2070 6f69 6e74 206f 6620 e best point of │ │ │ │ │ -0002b330: 7468 6520 7365 636f 6e64 0a69 6d70 6c65 the second.imple │ │ │ │ │ -0002b340: 6d65 6e74 6174 696f 6e3a 2064 6570 656e mentation: depen │ │ │ │ │ -0002b350: 6465 6e63 7920 636f 6d70 7574 6174 696f dency computatio │ │ │ │ │ -0002b360: 6e20 6173 2061 2073 6964 6520 6566 6665 n as a side effe │ │ │ │ │ -0002b370: 6374 206f 6620 636f 6d70 696c 6174 696f ct of compilatio │ │ │ │ │ -0002b380: 6e2e 0a0a 2020 2049 6e20 7468 6520 656e n... In the en │ │ │ │ │ -0002b390: 6420 7765 2066 6f75 6e64 2074 6861 7420 d we found that │ │ │ │ │ -0002b3a0: 6d6f 7374 206d 6f64 6572 6e20 6d61 6b65 most modern make │ │ │ │ │ -0002b3b0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e73 implementations │ │ │ │ │ -0002b3c0: 2073 7570 706f 7274 0a73 6f6d 6520 666f support.some fo │ │ │ │ │ -0002b3d0: 726d 206f 6620 696e 636c 7564 6520 6469 rm of include di │ │ │ │ │ -0002b3e0: 7265 6374 6976 652e 2020 416c 736f 2c20 rective. Also, │ │ │ │ │ -0002b3f0: 7765 2077 726f 7465 2061 2077 7261 7070 we wrote a wrapp │ │ │ │ │ -0002b400: 6572 2073 6372 6970 7420 7468 6174 0a6c er script that.l │ │ │ │ │ -0002b410: 6574 2075 7320 6162 7374 7261 6374 2061 et us abstract a │ │ │ │ │ -0002b420: 7761 7920 6469 6666 6572 656e 6365 7320 way differences │ │ │ │ │ -0002b430: 6265 7477 6565 6e20 6465 7065 6e64 656e between dependen │ │ │ │ │ -0002b440: 6379 2074 7261 636b 696e 6720 6d65 7468 cy tracking meth │ │ │ │ │ -0002b450: 6f64 7320 666f 720a 636f 6d70 696c 6572 ods for.compiler │ │ │ │ │ -0002b460: 732e 2020 466f 7220 696e 7374 616e 6365 s. For instance │ │ │ │ │ -0002b470: 2c20 736f 6d65 2063 6f6d 7069 6c65 7273 , some compilers │ │ │ │ │ -0002b480: 2063 616e 6e6f 7420 6765 6e65 7261 7465 cannot generate │ │ │ │ │ -0002b490: 2064 6570 656e 6465 6e63 6965 7320 6173 dependencies as │ │ │ │ │ -0002b4a0: 0a61 2073 6964 6520 6566 6665 6374 206f .a side effect o │ │ │ │ │ -0002b4b0: 6620 636f 6d70 696c 6174 696f 6e2e 2020 f compilation. │ │ │ │ │ -0002b4c0: 496e 2074 6869 7320 6361 7365 2077 6520 In this case we │ │ │ │ │ -0002b4d0: 7369 6d70 6c79 2068 6176 6520 7468 6520 simply have the │ │ │ │ │ -0002b4e0: 7363 7269 7074 0a72 756e 2074 6865 2063 script.run the c │ │ │ │ │ -0002b4f0: 6f6d 7069 6c65 7220 7477 6963 652e 2020 ompiler twice. │ │ │ │ │ -0002b500: 4375 7272 656e 746c 7920 6f75 7220 7772 Currently our wr │ │ │ │ │ -0002b510: 6170 7065 7220 7363 7269 7074 2028 2764 apper script ('d │ │ │ │ │ -0002b520: 6570 636f 6d70 2729 206b 6e6f 7773 0a61 epcomp') knows.a │ │ │ │ │ -0002b530: 626f 7574 2074 7765 6c76 6520 6469 6666 bout twelve diff │ │ │ │ │ -0002b540: 6572 656e 7420 636f 6d70 696c 6572 7320 erent compilers │ │ │ │ │ -0002b550: 2869 6e63 6c75 6469 6e67 2061 2022 636f (including a "co │ │ │ │ │ -0002b560: 6d70 696c 6572 2220 7468 6174 2073 696d mpiler" that sim │ │ │ │ │ -0002b570: 706c 790a 696e 766f 6b65 7320 276d 616b ply.invokes 'mak │ │ │ │ │ -0002b580: 6564 6570 656e 6427 2061 6e64 2074 6865 edepend' and the │ │ │ │ │ -0002b590: 6e20 7468 6520 7265 616c 2063 6f6d 7069 n the real compi │ │ │ │ │ -0002b5a0: 6c65 722c 2077 6869 6368 2069 7320 6173 ler, which is as │ │ │ │ │ -0002b5b0: 7375 6d65 6420 746f 2062 650a 6120 7374 sumed to be.a st │ │ │ │ │ -0002b5c0: 616e 6461 7264 2055 6e69 782d 6c69 6b65 andard Unix-like │ │ │ │ │ -0002b5d0: 2043 2063 6f6d 7069 6c65 7220 7769 7468 C compiler with │ │ │ │ │ -0002b5e0: 206e 6f20 7761 7920 746f 2064 6f20 6465 no way to do de │ │ │ │ │ -0002b5f0: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ -0002b600: 6729 2e0a 0a42 7567 730a 2e2e 2e2e 0a0a g)...Bugs....... │ │ │ │ │ -0002b610: 2020 202a 2052 756e 6e69 6e67 2061 2077 * Running a w │ │ │ │ │ -0002b620: 7261 7070 6572 2073 6372 6970 7420 666f rapper script fo │ │ │ │ │ -0002b630: 7220 6561 6368 2063 6f6d 7069 6c61 7469 r each compilati │ │ │ │ │ -0002b640: 6f6e 2073 6c6f 7773 2064 6f77 6e20 7468 on slows down th │ │ │ │ │ -0002b650: 6520 6275 696c 642e 0a20 2020 2a20 4d61 e build.. * Ma │ │ │ │ │ -0002b660: 6e79 2075 7365 7273 2064 6f6e 2774 2072 ny users don't r │ │ │ │ │ -0002b670: 6561 6c6c 7920 6361 7265 2061 626f 7574 eally care about │ │ │ │ │ -0002b680: 2070 7265 6369 7365 2064 6570 656e 6465 precise depende │ │ │ │ │ -0002b690: 6e63 6965 732e 0a20 2020 2a20 5468 6973 ncies.. * This │ │ │ │ │ -0002b6a0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e2c implementation, │ │ │ │ │ -0002b6b0: 206c 696b 6520 6576 6572 7920 6f74 6865 like every othe │ │ │ │ │ -0002b6c0: 7220 6175 746f 6d61 7469 6320 6465 7065 r automatic depe │ │ │ │ │ -0002b6d0: 6e64 656e 6379 2074 7261 636b 696e 670a ndency tracking. │ │ │ │ │ -0002b6e0: 2020 2020 2073 6368 656d 6520 696e 2063 scheme in c │ │ │ │ │ -0002b6f0: 6f6d 6d6f 6e20 7573 6520 746f 6461 7920 ommon use today │ │ │ │ │ -0002b700: 2869 6e64 6565 642c 2065 7665 7279 206f (indeed, every o │ │ │ │ │ -0002b710: 6e65 2077 6527 7665 2065 7665 7220 6865 ne we've ever he │ │ │ │ │ -0002b720: 6172 6420 6f66 292c 0a20 2020 2020 7375 ard of),. su │ │ │ │ │ -0002b730: 6666 6572 7320 6672 6f6d 2074 6865 2022 ffers from the " │ │ │ │ │ -0002b740: 6475 706c 6963 6174 6564 206e 6577 2068 duplicated new h │ │ │ │ │ -0002b750: 6561 6465 7222 2062 7567 2e0a 0a20 2020 eader" bug... │ │ │ │ │ -0002b760: 2020 5468 6973 2062 7567 206f 6363 7572 This bug occur │ │ │ │ │ -0002b770: 7320 6265 6361 7573 6520 6465 7065 6e64 s because depend │ │ │ │ │ -0002b780: 656e 6379 2074 7261 636b 696e 6720 746f ency tracking to │ │ │ │ │ -0002b790: 6f6c 732c 2073 7563 6820 6173 2074 6865 ols, such as the │ │ │ │ │ -0002b7a0: 0a20 2020 2020 636f 6d70 696c 6572 2c20 . compiler, │ │ │ │ │ -0002b7b0: 6f6e 6c79 2067 656e 6572 6174 6520 6465 only generate de │ │ │ │ │ -0002b7c0: 7065 6e64 656e 6369 6573 206f 6e20 7468 pendencies on th │ │ │ │ │ -0002b7d0: 6520 7375 6363 6573 7366 756c 206f 7065 e successful ope │ │ │ │ │ -0002b7e0: 6e69 6e67 206f 6620 610a 2020 2020 2066 ning of a. f │ │ │ │ │ -0002b7f0: 696c 652c 2061 6e64 206e 6f74 206f 6e20 ile, and not on │ │ │ │ │ -0002b800: 6576 6572 7920 7072 6f62 652e 0a0a 2020 every probe... │ │ │ │ │ -0002b810: 2020 2053 7570 706f 7365 2066 6f72 2069 Suppose for i │ │ │ │ │ -0002b820: 6e73 7461 6e63 6520 7468 6174 2074 6865 nstance that the │ │ │ │ │ -0002b830: 2063 6f6d 7069 6c65 7220 7365 6172 6368 compiler search │ │ │ │ │ -0002b840: 6573 2074 6872 6565 2064 6972 6563 746f es three directo │ │ │ │ │ -0002b850: 7269 6573 0a20 2020 2020 666f 7220 6120 ries. for a │ │ │ │ │ -0002b860: 6769 7665 6e20 6865 6164 6572 2c20 616e given header, an │ │ │ │ │ -0002b870: 6420 7468 6174 2074 6865 2068 6561 6465 d that the heade │ │ │ │ │ -0002b880: 7220 6973 2066 6f75 6e64 2069 6e20 7468 r is found in th │ │ │ │ │ -0002b890: 6520 7468 6972 640a 2020 2020 2064 6972 e third. dir │ │ │ │ │ -0002b8a0: 6563 746f 7279 2e20 2049 6620 7468 6520 ectory. If the │ │ │ │ │ -0002b8b0: 7072 6f67 7261 6d6d 6572 2065 7272 6f6e programmer erron │ │ │ │ │ -0002b8c0: 656f 7573 6c79 2061 6464 7320 6120 6865 eously adds a he │ │ │ │ │ -0002b8d0: 6164 6572 2066 696c 6520 7769 7468 0a20 ader file with. │ │ │ │ │ -0002b8e0: 2020 2020 7468 6520 7361 6d65 206e 616d the same nam │ │ │ │ │ -0002b8f0: 6520 746f 2074 6865 2066 6972 7374 2064 e to the first d │ │ │ │ │ -0002b900: 6972 6563 746f 7279 2c20 7468 656e 2061 irectory, then a │ │ │ │ │ -0002b910: 2063 6c65 616e 2072 6562 7569 6c64 2066 clean rebuild f │ │ │ │ │ -0002b920: 726f 6d0a 2020 2020 2073 6372 6174 6368 rom. scratch │ │ │ │ │ -0002b930: 2063 6f75 6c64 2066 6169 6c20 2873 7570 could fail (sup │ │ │ │ │ -0002b940: 706f 7365 2074 6865 206e 6577 2068 6561 pose the new hea │ │ │ │ │ -0002b950: 6465 7220 6669 6c65 2069 7320 6275 6767 der file is bugg │ │ │ │ │ -0002b960: 7929 2c20 7768 6572 6561 730a 2020 2020 y), whereas. │ │ │ │ │ -0002b970: 2061 6e20 696e 6372 656d 656e 7461 6c20 an incremental │ │ │ │ │ -0002b980: 7265 6275 696c 6420 7769 6c6c 2073 7563 rebuild will suc │ │ │ │ │ -0002b990: 6365 6564 2e0a 0a20 2020 2020 5768 6174 ceed... What │ │ │ │ │ -0002b9a0: 2068 6173 2068 6170 7065 6e65 6420 6865 has happened he │ │ │ │ │ -0002b9b0: 7265 2069 7320 7468 6174 2070 656f 706c re is that peopl │ │ │ │ │ -0002b9c0: 6520 6861 7665 2061 206d 6973 756e 6465 e have a misunde │ │ │ │ │ -0002b9d0: 7273 7461 6e64 696e 6720 6f66 0a20 2020 rstanding of. │ │ │ │ │ -0002b9e0: 2020 7768 6174 2061 2064 6570 656e 6465 what a depende │ │ │ │ │ -0002b9f0: 6e63 7920 6973 2e20 2054 6f6f 6c20 7772 ncy is. Tool wr │ │ │ │ │ -0002ba00: 6974 6572 7320 7468 696e 6b20 6120 6465 iters think a de │ │ │ │ │ -0002ba10: 7065 6e64 656e 6379 2065 6e63 6f64 6573 pendency encodes │ │ │ │ │ -0002ba20: 0a20 2020 2020 696e 666f 726d 6174 696f . informatio │ │ │ │ │ -0002ba30: 6e20 6162 6f75 7420 7768 6963 6820 6669 n about which fi │ │ │ │ │ -0002ba40: 6c65 7320 7765 7265 2072 6561 6420 6279 les were read by │ │ │ │ │ -0002ba50: 2074 6865 2063 6f6d 7069 6c65 722e 2020 the compiler. │ │ │ │ │ -0002ba60: 486f 7765 7665 722c 0a20 2020 2020 6120 However,. a │ │ │ │ │ -0002ba70: 6465 7065 6e64 656e 6379 206d 7573 7420 dependency must │ │ │ │ │ -0002ba80: 6163 7475 616c 6c79 2065 6e63 6f64 6520 actually encode │ │ │ │ │ -0002ba90: 696e 666f 726d 6174 696f 6e20 6162 6f75 information abou │ │ │ │ │ -0002baa0: 7420 7768 6174 2074 6865 0a20 2020 2020 t what the. │ │ │ │ │ -0002bab0: 636f 6d70 696c 6572 2074 7269 6564 2074 compiler tried t │ │ │ │ │ -0002bac0: 6f20 646f 2e0a 0a20 2020 2020 5468 6973 o do... This │ │ │ │ │ -0002bad0: 2070 726f 626c 656d 2069 7320 6e6f 7420 problem is not │ │ │ │ │ -0002bae0: 7365 7269 6f75 7320 696e 2070 7261 6374 serious in pract │ │ │ │ │ -0002baf0: 6963 652e 2020 5072 6f67 7261 6d6d 6572 ice. Programmer │ │ │ │ │ -0002bb00: 7320 7479 7069 6361 6c6c 7920 646f 0a20 s typically do. │ │ │ │ │ -0002bb10: 2020 2020 6e6f 7420 7573 6520 7468 6520 not use the │ │ │ │ │ -0002bb20: 7361 6d65 206e 616d 6520 666f 7220 6120 same name for a │ │ │ │ │ -0002bb30: 6865 6164 6572 2066 696c 6520 7477 6963 header file twic │ │ │ │ │ -0002bb40: 6520 696e 2061 2067 6976 656e 2070 726f e in a given pro │ │ │ │ │ -0002bb50: 6a65 6374 2e0a 2020 2020 2028 4174 206c ject.. (At l │ │ │ │ │ -0002bb60: 6561 7374 2c20 6e6f 7420 696e 2043 206f east, not in C o │ │ │ │ │ -0002bb70: 7220 432b 2b2e 2020 5468 6973 2070 726f r C++. This pro │ │ │ │ │ -0002bb80: 626c 656d 206d 6179 2062 6520 6d6f 7265 blem may be more │ │ │ │ │ -0002bb90: 2074 726f 7562 6c65 736f 6d65 0a20 2020 troublesome. │ │ │ │ │ -0002bba0: 2020 696e 204a 6176 612e 2920 2054 6869 in Java.) Thi │ │ │ │ │ -0002bbb0: 7320 7072 6f62 6c65 6d20 6973 2065 6173 s problem is eas │ │ │ │ │ -0002bbc0: 7920 746f 2066 6978 2c20 6279 206d 6f64 y to fix, by mod │ │ │ │ │ -0002bbd0: 6966 7969 6e67 2064 6570 656e 6465 6e63 ifying dependenc │ │ │ │ │ -0002bbe0: 790a 2020 2020 2067 656e 6572 6174 6f72 y. generator │ │ │ │ │ -0002bbf0: 7320 746f 2072 6563 6f72 6420 6576 6572 s to record ever │ │ │ │ │ -0002bc00: 7920 7072 6f62 652c 2069 6e73 7465 6164 y probe, instead │ │ │ │ │ -0002bc10: 206f 6620 6576 6572 7920 7375 6363 6573 of every succes │ │ │ │ │ -0002bc20: 7366 756c 206f 7065 6e2e 0a0a 2020 202a sful open... * │ │ │ │ │ -0002bc30: 2053 696e 6365 2041 7574 6f6d 616b 6520 Since Automake │ │ │ │ │ -0002bc40: 6765 6e65 7261 7465 7320 6465 7065 6e64 generates depend │ │ │ │ │ -0002bc50: 656e 6369 6573 2061 7320 6120 7369 6465 encies as a side │ │ │ │ │ -0002bc60: 2065 6666 6563 7420 6f66 0a20 2020 2020 effect of. │ │ │ │ │ -0002bc70: 636f 6d70 696c 6174 696f 6e2c 2074 6865 compilation, the │ │ │ │ │ -0002bc80: 7265 2069 7320 6120 626f 6f74 7374 7261 re is a bootstra │ │ │ │ │ -0002bc90: 7070 696e 6720 7072 6f62 6c65 6d20 7768 pping problem wh │ │ │ │ │ -0002bca0: 656e 2068 6561 6465 7220 6669 6c65 7320 en header files │ │ │ │ │ -0002bcb0: 6172 650a 2020 2020 2067 656e 6572 6174 are. generat │ │ │ │ │ -0002bcc0: 6564 2062 7920 7275 6e6e 696e 6720 6120 ed by running a │ │ │ │ │ -0002bcd0: 7072 6f67 7261 6d2e 2020 5468 6520 7072 program. The pr │ │ │ │ │ -0002bce0: 6f62 6c65 6d20 6973 2074 6861 742c 2074 oblem is that, t │ │ │ │ │ -0002bcf0: 6865 2066 6972 7374 0a20 2020 2020 7469 he first. ti │ │ │ │ │ -0002bd00: 6d65 2074 6865 2062 7569 6c64 2069 7320 me the build is │ │ │ │ │ -0002bd10: 646f 6e65 2c20 7468 6572 6520 6973 206e done, there is n │ │ │ │ │ -0002bd20: 6f20 7761 7920 6279 2064 6566 6175 6c74 o way by default │ │ │ │ │ -0002bd30: 2074 6f20 6b6e 6f77 2074 6861 7420 7468 to know that th │ │ │ │ │ -0002bd40: 650a 2020 2020 2068 6561 6465 7273 2061 e. headers a │ │ │ │ │ -0002bd50: 7265 2072 6571 7569 7265 642c 2073 6f20 re required, so │ │ │ │ │ -0002bd60: 6d61 6b65 206d 6967 6874 2074 7279 2074 make might try t │ │ │ │ │ -0002bd70: 6f20 7275 6e20 6120 636f 6d70 696c 6174 o run a compilat │ │ │ │ │ -0002bd80: 696f 6e20 666f 720a 2020 2020 2077 6869 ion for. whi │ │ │ │ │ -0002bd90: 6368 2074 6865 2068 6561 6465 7273 2068 ch the headers h │ │ │ │ │ -0002bda0: 6176 6520 6e6f 7420 7965 7420 6265 656e ave not yet been │ │ │ │ │ -0002bdb0: 2062 7569 6c74 2e0a 0a20 2020 2020 5468 built... Th │ │ │ │ │ -0002bdc0: 6973 2077 6173 2061 6c73 6f20 6120 7072 is was also a pr │ │ │ │ │ -0002bdd0: 6f62 6c65 6d20 696e 2074 6865 2070 7265 oblem in the pre │ │ │ │ │ -0002bde0: 7669 6f75 7320 6465 7065 6e64 656e 6379 vious dependency │ │ │ │ │ -0002bdf0: 2074 7261 636b 696e 670a 2020 2020 2069 tracking. i │ │ │ │ │ -0002be00: 6d70 6c65 6d65 6e74 6174 696f 6e2e 0a0a mplementation... │ │ │ │ │ -0002be10: 2020 2020 2054 6865 2063 7572 7265 6e74 The current │ │ │ │ │ -0002be20: 2066 6978 2069 7320 746f 2075 7365 2027 fix is to use ' │ │ │ │ │ -0002be30: 4255 494c 545f 534f 5552 4345 5327 2074 BUILT_SOURCES' t │ │ │ │ │ -0002be40: 6f20 6c69 7374 2062 7569 6c74 2068 6561 o list built hea │ │ │ │ │ -0002be50: 6465 7273 0a20 2020 2020 282a 6e6f 7465 ders. (*note │ │ │ │ │ -0002be60: 2053 6f75 7263 6573 3a3a 292e 2020 5468 Sources::). Th │ │ │ │ │ -0002be70: 6973 2063 6175 7365 7320 7468 656d 2074 is causes them t │ │ │ │ │ -0002be80: 6f20 6265 2062 7569 6c74 2062 6566 6f72 o be built befor │ │ │ │ │ -0002be90: 6520 616e 7920 6f74 6865 720a 2020 2020 e any other. │ │ │ │ │ -0002bea0: 2062 7569 6c64 2072 756c 6573 2061 7265 build rules are │ │ │ │ │ -0002beb0: 2072 756e 2e20 2054 6869 7320 6973 2075 run. This is u │ │ │ │ │ -0002bec0: 6e73 6174 6973 6661 6374 6f72 7920 6173 nsatisfactory as │ │ │ │ │ -0002bed0: 2061 2067 656e 6572 616c 2073 6f6c 7574 a general solut │ │ │ │ │ -0002bee0: 696f 6e2c 0a20 2020 2020 686f 7765 7665 ion,. howeve │ │ │ │ │ -0002bef0: 7220 696e 2070 7261 6374 6963 6520 6974 r in practice it │ │ │ │ │ -0002bf00: 2073 6565 6d73 2073 7566 6669 6369 656e seems sufficien │ │ │ │ │ -0002bf10: 7420 666f 7220 6d6f 7374 2061 6374 7561 t for most actua │ │ │ │ │ -0002bf20: 6c20 7072 6f67 7261 6d73 2e0a 0a20 2020 l programs... │ │ │ │ │ -0002bf30: 5468 6973 2063 6f64 6520 6973 2075 7365 This code is use │ │ │ │ │ -0002bf40: 6420 7369 6e63 6520 4175 746f 6d61 6b65 d since Automake │ │ │ │ │ -0002bf50: 2031 2e35 2e0a 0a20 2020 496e 2047 4343 1.5... In GCC │ │ │ │ │ -0002bf60: 2033 2e30 2c20 7765 206d 616e 6167 6564 3.0, we managed │ │ │ │ │ -0002bf70: 2074 6f20 636f 6e76 696e 6365 2074 6865 to convince the │ │ │ │ │ -0002bf80: 206d 6169 6e74 6169 6e65 7273 2074 6f20 maintainers to │ │ │ │ │ -0002bf90: 6164 6420 7370 6563 6961 6c0a 636f 6d6d add special.comm │ │ │ │ │ -0002bfa0: 616e 642d 6c69 6e65 206f 7074 696f 6e73 and-line options │ │ │ │ │ -0002bfb0: 2074 6f20 6865 6c70 2041 7574 6f6d 616b to help Automak │ │ │ │ │ -0002bfc0: 6520 6d6f 7265 2065 6666 6963 6965 6e74 e more efficient │ │ │ │ │ -0002bfd0: 6c79 2064 6f20 6974 7320 6a6f 622e 2020 ly do its job. │ │ │ │ │ -0002bfe0: 5765 0a68 6f70 6564 2074 6869 7320 776f We.hoped this wo │ │ │ │ │ -0002bff0: 756c 6420 6c65 7420 7573 2061 766f 6964 uld let us avoid │ │ │ │ │ -0002c000: 2074 6865 2075 7365 206f 6620 6120 7772 the use of a wr │ │ │ │ │ -0002c010: 6170 7065 7220 7363 7269 7074 2077 6865 apper script whe │ │ │ │ │ -0002c020: 6e0a 4175 746f 6d61 6b65 2773 2061 7574 n.Automake's aut │ │ │ │ │ -0002c030: 6f6d 6174 6963 2064 6570 656e 6465 6e63 omatic dependenc │ │ │ │ │ -0002c040: 7920 7472 6163 6b69 6e67 2077 6173 2075 y tracking was u │ │ │ │ │ -0002c050: 7365 6420 7769 7468 2027 6763 6327 2e0a sed with 'gcc'.. │ │ │ │ │ -0002c060: 0a20 2020 556e 666f 7274 756e 6174 656c . Unfortunatel │ │ │ │ │ -0002c070: 792c 2074 6869 7320 636f 6465 2064 6f65 y, this code doe │ │ │ │ │ -0002c080: 736e 2774 2071 7569 7465 2064 6f20 7768 sn't quite do wh │ │ │ │ │ -0002c090: 6174 2077 6520 7761 6e74 2e20 2049 6e0a at we want. In. │ │ │ │ │ -0002c0a0: 7061 7274 6963 756c 6172 2c20 6974 2072 particular, it r │ │ │ │ │ -0002c0b0: 656d 6f76 6573 2074 6865 2064 6570 656e emoves the depen │ │ │ │ │ -0002c0c0: 6465 6e63 7920 6669 6c65 2069 6620 7468 dency file if th │ │ │ │ │ -0002c0d0: 6520 636f 6d70 696c 6174 696f 6e20 6661 e compilation fa │ │ │ │ │ -0002c0e0: 696c 733b 0a77 6527 6420 7072 6566 6572 ils;.we'd prefer │ │ │ │ │ -0002c0f0: 2074 6861 7420 6974 2069 6e73 7465 6164 that it instead │ │ │ │ │ -0002c100: 206f 6e6c 7920 746f 7563 6820 7468 6520 only touch the │ │ │ │ │ -0002c110: 6669 6c65 2069 6e20 616e 7920 7761 7920 file in any way │ │ │ │ │ -0002c120: 6966 2074 6865 0a63 6f6d 7069 6c61 7469 if the.compilati │ │ │ │ │ -0002c130: 6f6e 2073 7563 6365 6564 732e 0a0a 2020 on succeeds... │ │ │ │ │ -0002c140: 204e 6576 6572 7468 656c 6573 732c 2073 Nevertheless, s │ │ │ │ │ -0002c150: 696e 6365 2041 7574 6f6d 616b 6520 312e ince Automake 1. │ │ │ │ │ -0002c160: 372c 2077 6865 6e20 6120 7265 6365 6e74 7, when a recent │ │ │ │ │ -0002c170: 2027 6763 6327 2069 7320 6465 7465 6374 'gcc' is detect │ │ │ │ │ -0002c180: 6564 2061 740a 2763 6f6e 6669 6775 7265 ed at.'configure │ │ │ │ │ -0002c190: 2720 7469 6d65 2c20 7765 2069 6e6c 696e ' time, we inlin │ │ │ │ │ -0002c1a0: 6520 7468 6520 6465 7065 6e64 656e 6379 e the dependency │ │ │ │ │ -0002c1b0: 2d67 656e 6572 6174 696f 6e20 636f 6465 -generation code │ │ │ │ │ -0002c1c0: 2061 6e64 2064 6f20 6e6f 740a 7573 6520 and do not.use │ │ │ │ │ -0002c1d0: 7468 6520 2764 6570 636f 6d70 2720 7772 the 'depcomp' wr │ │ │ │ │ -0002c1e0: 6170 7065 7220 7363 7269 7074 2e20 2054 apper script. T │ │ │ │ │ -0002c1f0: 6869 7320 6d61 6b65 7320 636f 6d70 696c his makes compil │ │ │ │ │ -0002c200: 6174 696f 6e73 2066 6173 7465 7220 666f ations faster fo │ │ │ │ │ -0002c210: 720a 7468 6f73 6520 7573 696e 6720 7468 r.those using th │ │ │ │ │ -0002c220: 6973 2063 6f6d 7069 6c65 7220 2870 726f is compiler (pro │ │ │ │ │ -0002c230: 6261 626c 7920 6f75 7220 7072 696d 6172 bably our primar │ │ │ │ │ -0002c240: 7920 7573 6572 2062 6173 6529 2e20 2054 y user base). T │ │ │ │ │ -0002c250: 6865 0a63 6f75 6e74 6572 7061 7274 2069 he.counterpart i │ │ │ │ │ -0002c260: 7320 7468 6174 2062 6563 6175 7365 2077 s that because w │ │ │ │ │ -0002c270: 6520 6861 7665 2074 6f20 656e 636f 6465 e have to encode │ │ │ │ │ -0002c280: 2074 776f 2063 6f6d 7069 6c61 7469 6f6e two compilation │ │ │ │ │ -0002c290: 2072 756c 6573 2069 6e0a 274d 616b 6566 rules in.'Makef │ │ │ │ │ -0002c2a0: 696c 6527 2028 7769 7468 206f 7220 7769 ile' (with or wi │ │ │ │ │ -0002c2b0: 7468 6f75 7420 2764 6570 636f 6d70 2729 thout 'depcomp') │ │ │ │ │ -0002c2c0: 2c20 7468 6520 7072 6f64 7563 6564 2027 , the produced ' │ │ │ │ │ -0002c2d0: 4d61 6b65 6669 6c65 2773 2061 7265 0a6c Makefile's are.l │ │ │ │ │ -0002c2e0: 6172 6765 722e 0a0a 1f0a 4669 6c65 3a20 arger.....File: │ │ │ │ │ -0002c2f0: 6175 746f 6d61 6b65 2d31 2e31 312e 696e automake-1.11.in │ │ │ │ │ -0002c300: 666f 2c20 204e 6f64 653a 2054 6563 686e fo, Node: Techn │ │ │ │ │ -0002c310: 6971 7565 7320 666f 7220 4465 7065 6e64 iques for Depend │ │ │ │ │ -0002c320: 656e 6369 6573 2c20 204e 6578 743a 2052 encies, Next: R │ │ │ │ │ -0002c330: 6563 6f6d 6d65 6e64 6174 696f 6e73 2066 ecommendations f │ │ │ │ │ -0002c340: 6f72 2054 6f6f 6c20 5772 6974 6572 732c or Tool Writers, │ │ │ │ │ -0002c350: 2020 5072 6576 3a20 4465 7065 6e64 656e Prev: Dependen │ │ │ │ │ -0002c360: 6369 6573 2066 6f72 2074 6865 2055 7365 cies for the Use │ │ │ │ │ -0002c370: 722c 2020 5570 3a20 4465 7065 6e64 656e r, Up: Dependen │ │ │ │ │ -0002c380: 6379 2054 7261 636b 696e 6720 4576 6f6c cy Tracking Evol │ │ │ │ │ -0002c390: 7574 696f 6e0a 0a32 392e 322e 3420 5465 ution..29.2.4 Te │ │ │ │ │ -0002c3a0: 6368 6e69 7175 6573 2066 6f72 2043 6f6d chniques for Com │ │ │ │ │ -0002c3b0: 7075 7469 6e67 2044 6570 656e 6465 6e63 puting Dependenc │ │ │ │ │ -0002c3c0: 6965 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ies.------------ │ │ │ │ │ +0002b040: 2d2d 2d0a 0a44 6573 6372 6970 7469 6f6e ---..Description │ │ │ │ │ +0002b050: 0a2e 2e2e 2e2e 2e2e 2e2e 2e2e 0a0a 5468 ..............Th │ │ │ │ │ +0002b060: 6520 6275 6773 2061 7373 6f63 6961 7465 e bugs associate │ │ │ │ │ +0002b070: 6420 7769 7468 2027 6d61 6b65 2064 6973 d with 'make dis │ │ │ │ │ +0002b080: 7427 2c20 6f76 6572 2074 696d 652c 2062 t', over time, b │ │ │ │ │ +0002b090: 6563 616d 6520 6120 7265 616c 2070 726f ecame a real pro │ │ │ │ │ +0002b0a0: 626c 656d 2e0a 5061 636b 6167 6573 2075 blem..Packages u │ │ │ │ │ +0002b0b0: 7369 6e67 2041 7574 6f6d 616b 6520 7765 sing Automake we │ │ │ │ │ +0002b0c0: 7265 2062 6569 6e67 2062 7569 6c74 206f re being built o │ │ │ │ │ +0002b0d0: 6e20 6120 6c61 7267 6520 6e75 6d62 6572 n a large number │ │ │ │ │ +0002b0e0: 206f 6620 706c 6174 666f 726d 732c 0a61 of platforms,.a │ │ │ │ │ +0002b0f0: 6e64 2077 6572 6520 6265 636f 6d69 6e67 nd were becoming │ │ │ │ │ +0002b100: 2069 6e63 7265 6173 696e 676c 7920 636f increasingly co │ │ │ │ │ +0002b110: 6d70 6c65 782e 2020 4272 6f6b 656e 2064 mplex. Broken d │ │ │ │ │ +0002b120: 6570 656e 6465 6e63 6965 7320 7765 7265 ependencies were │ │ │ │ │ +0002b130: 0a64 6973 7472 6962 7574 6564 2069 6e20 .distributed in │ │ │ │ │ +0002b140: 2270 6f72 7461 626c 6522 2027 4d61 6b65 "portable" 'Make │ │ │ │ │ +0002b150: 6669 6c65 2e69 6e27 732c 206c 6561 6469 file.in's, leadi │ │ │ │ │ +0002b160: 6e67 2074 6f20 7573 6572 2063 6f6d 706c ng to user compl │ │ │ │ │ +0002b170: 6169 6e74 732e 0a41 6c73 6f2c 2074 6865 aints..Also, the │ │ │ │ │ +0002b180: 2072 6571 7569 7265 6d65 6e74 2066 6f72 requirement for │ │ │ │ │ +0002b190: 2027 6763 6327 2061 6e64 2047 4e55 2027 'gcc' and GNU ' │ │ │ │ │ +0002b1a0: 6d61 6b65 2720 7761 7320 6120 636f 6e73 make' was a cons │ │ │ │ │ +0002b1b0: 7461 6e74 2073 6f75 7263 6520 6f66 0a62 tant source of.b │ │ │ │ │ +0002b1c0: 7567 2072 6570 6f72 7473 2e20 2054 6865 ug reports. The │ │ │ │ │ +0002b1d0: 206e 6578 7420 696d 706c 656d 656e 7461 next implementa │ │ │ │ │ +0002b1e0: 7469 6f6e 206f 6620 6465 7065 6e64 656e tion of dependen │ │ │ │ │ +0002b1f0: 6379 2074 7261 636b 696e 6720 6169 6d65 cy tracking aime │ │ │ │ │ +0002b200: 6420 746f 0a72 656d 6f76 6520 7468 6573 d to.remove thes │ │ │ │ │ +0002b210: 6520 7072 6f62 6c65 6d73 2e0a 0a20 2020 e problems... │ │ │ │ │ +0002b220: 5765 2072 6561 6c69 7a65 6420 7468 6174 We realized that │ │ │ │ │ +0002b230: 2074 6865 206f 6e6c 7920 7472 756c 7920 the only truly │ │ │ │ │ +0002b240: 7265 6c69 6162 6c65 2077 6179 2074 6f20 reliable way to │ │ │ │ │ +0002b250: 6175 746f 6d61 7469 6361 6c6c 7920 7472 automatically tr │ │ │ │ │ +0002b260: 6163 6b0a 6465 7065 6e64 656e 6369 6573 ack.dependencies │ │ │ │ │ +0002b270: 2077 6173 2074 6f20 646f 2069 7420 7768 was to do it wh │ │ │ │ │ +0002b280: 656e 2074 6865 2070 6163 6b61 6765 2069 en the package i │ │ │ │ │ +0002b290: 7473 656c 6620 7761 7320 6275 696c 742e tself was built. │ │ │ │ │ +0002b2a0: 2020 5468 6973 206d 6561 6e74 0a64 6973 This meant.dis │ │ │ │ │ +0002b2b0: 636f 7665 7269 6e67 2061 206d 6574 686f covering a metho │ │ │ │ │ +0002b2c0: 6420 706f 7274 6162 6c65 2074 6f20 616e d portable to an │ │ │ │ │ +0002b2d0: 7920 7665 7273 696f 6e20 6f66 206d 616b y version of mak │ │ │ │ │ +0002b2e0: 6520 616e 6420 616e 7920 636f 6d70 696c e and any compil │ │ │ │ │ +0002b2f0: 6572 2e0a 416c 736f 2c20 7765 2077 616e er..Also, we wan │ │ │ │ │ +0002b300: 7465 6420 746f 2070 7265 7365 7276 6520 ted to preserve │ │ │ │ │ +0002b310: 7768 6174 2077 6520 7361 7720 6173 2074 what we saw as t │ │ │ │ │ +0002b320: 6865 2062 6573 7420 706f 696e 7420 6f66 he best point of │ │ │ │ │ +0002b330: 2074 6865 2073 6563 6f6e 640a 696d 706c the second.impl │ │ │ │ │ +0002b340: 656d 656e 7461 7469 6f6e 3a20 6465 7065 ementation: depe │ │ │ │ │ +0002b350: 6e64 656e 6379 2063 6f6d 7075 7461 7469 ndency computati │ │ │ │ │ +0002b360: 6f6e 2061 7320 6120 7369 6465 2065 6666 on as a side eff │ │ │ │ │ +0002b370: 6563 7420 6f66 2063 6f6d 7069 6c61 7469 ect of compilati │ │ │ │ │ +0002b380: 6f6e 2e0a 0a20 2020 496e 2074 6865 2065 on... In the e │ │ │ │ │ +0002b390: 6e64 2077 6520 666f 756e 6420 7468 6174 nd we found that │ │ │ │ │ +0002b3a0: 206d 6f73 7420 6d6f 6465 726e 206d 616b most modern mak │ │ │ │ │ +0002b3b0: 6520 696d 706c 656d 656e 7461 7469 6f6e e implementation │ │ │ │ │ +0002b3c0: 7320 7375 7070 6f72 740a 736f 6d65 2066 s support.some f │ │ │ │ │ +0002b3d0: 6f72 6d20 6f66 2069 6e63 6c75 6465 2064 orm of include d │ │ │ │ │ +0002b3e0: 6972 6563 7469 7665 2e20 2041 6c73 6f2c irective. Also, │ │ │ │ │ +0002b3f0: 2077 6520 7772 6f74 6520 6120 7772 6170 we wrote a wrap │ │ │ │ │ +0002b400: 7065 7220 7363 7269 7074 2074 6861 740a per script that. │ │ │ │ │ +0002b410: 6c65 7420 7573 2061 6273 7472 6163 7420 let us abstract │ │ │ │ │ +0002b420: 6177 6179 2064 6966 6665 7265 6e63 6573 away differences │ │ │ │ │ +0002b430: 2062 6574 7765 656e 2064 6570 656e 6465 between depende │ │ │ │ │ +0002b440: 6e63 7920 7472 6163 6b69 6e67 206d 6574 ncy tracking met │ │ │ │ │ +0002b450: 686f 6473 2066 6f72 0a63 6f6d 7069 6c65 hods for.compile │ │ │ │ │ +0002b460: 7273 2e20 2046 6f72 2069 6e73 7461 6e63 rs. For instanc │ │ │ │ │ +0002b470: 652c 2073 6f6d 6520 636f 6d70 696c 6572 e, some compiler │ │ │ │ │ +0002b480: 7320 6361 6e6e 6f74 2067 656e 6572 6174 s cannot generat │ │ │ │ │ +0002b490: 6520 6465 7065 6e64 656e 6369 6573 2061 e dependencies a │ │ │ │ │ +0002b4a0: 730a 6120 7369 6465 2065 6666 6563 7420 s.a side effect │ │ │ │ │ +0002b4b0: 6f66 2063 6f6d 7069 6c61 7469 6f6e 2e20 of compilation. │ │ │ │ │ +0002b4c0: 2049 6e20 7468 6973 2063 6173 6520 7765 In this case we │ │ │ │ │ +0002b4d0: 2073 696d 706c 7920 6861 7665 2074 6865 simply have the │ │ │ │ │ +0002b4e0: 2073 6372 6970 740a 7275 6e20 7468 6520 script.run the │ │ │ │ │ +0002b4f0: 636f 6d70 696c 6572 2074 7769 6365 2e20 compiler twice. │ │ │ │ │ +0002b500: 2043 7572 7265 6e74 6c79 206f 7572 2077 Currently our w │ │ │ │ │ +0002b510: 7261 7070 6572 2073 6372 6970 7420 2827 rapper script (' │ │ │ │ │ +0002b520: 6465 7063 6f6d 7027 2920 6b6e 6f77 730a depcomp') knows. │ │ │ │ │ +0002b530: 6162 6f75 7420 7477 656c 7665 2064 6966 about twelve dif │ │ │ │ │ +0002b540: 6665 7265 6e74 2063 6f6d 7069 6c65 7273 ferent compilers │ │ │ │ │ +0002b550: 2028 696e 636c 7564 696e 6720 6120 2263 (including a "c │ │ │ │ │ +0002b560: 6f6d 7069 6c65 7222 2074 6861 7420 7369 ompiler" that si │ │ │ │ │ +0002b570: 6d70 6c79 0a69 6e76 6f6b 6573 2027 6d61 mply.invokes 'ma │ │ │ │ │ +0002b580: 6b65 6465 7065 6e64 2720 616e 6420 7468 kedepend' and th │ │ │ │ │ +0002b590: 656e 2074 6865 2072 6561 6c20 636f 6d70 en the real comp │ │ │ │ │ +0002b5a0: 696c 6572 2c20 7768 6963 6820 6973 2061 iler, which is a │ │ │ │ │ +0002b5b0: 7373 756d 6564 2074 6f20 6265 0a61 2073 ssumed to be.a s │ │ │ │ │ +0002b5c0: 7461 6e64 6172 6420 556e 6978 2d6c 696b tandard Unix-lik │ │ │ │ │ +0002b5d0: 6520 4320 636f 6d70 696c 6572 2077 6974 e C compiler wit │ │ │ │ │ +0002b5e0: 6820 6e6f 2077 6179 2074 6f20 646f 2064 h no way to do d │ │ │ │ │ +0002b5f0: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ +0002b600: 6e67 292e 0a0a 4275 6773 0a2e 2e2e 2e0a ng)...Bugs...... │ │ │ │ │ +0002b610: 0a20 2020 2a20 5275 6e6e 696e 6720 6120 . * Running a │ │ │ │ │ +0002b620: 7772 6170 7065 7220 7363 7269 7074 2066 wrapper script f │ │ │ │ │ +0002b630: 6f72 2065 6163 6820 636f 6d70 696c 6174 or each compilat │ │ │ │ │ +0002b640: 696f 6e20 736c 6f77 7320 646f 776e 2074 ion slows down t │ │ │ │ │ +0002b650: 6865 2062 7569 6c64 2e0a 2020 202a 204d he build.. * M │ │ │ │ │ +0002b660: 616e 7920 7573 6572 7320 646f 6e27 7420 any users don't │ │ │ │ │ +0002b670: 7265 616c 6c79 2063 6172 6520 6162 6f75 really care abou │ │ │ │ │ +0002b680: 7420 7072 6563 6973 6520 6465 7065 6e64 t precise depend │ │ │ │ │ +0002b690: 656e 6369 6573 2e0a 2020 202a 2054 6869 encies.. * Thi │ │ │ │ │ +0002b6a0: 7320 696d 706c 656d 656e 7461 7469 6f6e s implementation │ │ │ │ │ +0002b6b0: 2c20 6c69 6b65 2065 7665 7279 206f 7468 , like every oth │ │ │ │ │ +0002b6c0: 6572 2061 7574 6f6d 6174 6963 2064 6570 er automatic dep │ │ │ │ │ +0002b6d0: 656e 6465 6e63 7920 7472 6163 6b69 6e67 endency tracking │ │ │ │ │ +0002b6e0: 0a20 2020 2020 7363 6865 6d65 2069 6e20 . scheme in │ │ │ │ │ +0002b6f0: 636f 6d6d 6f6e 2075 7365 2074 6f64 6179 common use today │ │ │ │ │ +0002b700: 2028 696e 6465 6564 2c20 6576 6572 7920 (indeed, every │ │ │ │ │ +0002b710: 6f6e 6520 7765 2776 6520 6576 6572 2068 one we've ever h │ │ │ │ │ +0002b720: 6561 7264 206f 6629 2c0a 2020 2020 2073 eard of),. s │ │ │ │ │ +0002b730: 7566 6665 7273 2066 726f 6d20 7468 6520 uffers from the │ │ │ │ │ +0002b740: 2264 7570 6c69 6361 7465 6420 6e65 7720 "duplicated new │ │ │ │ │ +0002b750: 6865 6164 6572 2220 6275 672e 0a0a 2020 header" bug... │ │ │ │ │ +0002b760: 2020 2054 6869 7320 6275 6720 6f63 6375 This bug occu │ │ │ │ │ +0002b770: 7273 2062 6563 6175 7365 2064 6570 656e rs because depen │ │ │ │ │ +0002b780: 6465 6e63 7920 7472 6163 6b69 6e67 2074 dency tracking t │ │ │ │ │ +0002b790: 6f6f 6c73 2c20 7375 6368 2061 7320 7468 ools, such as th │ │ │ │ │ +0002b7a0: 650a 2020 2020 2063 6f6d 7069 6c65 722c e. compiler, │ │ │ │ │ +0002b7b0: 206f 6e6c 7920 6765 6e65 7261 7465 2064 only generate d │ │ │ │ │ +0002b7c0: 6570 656e 6465 6e63 6965 7320 6f6e 2074 ependencies on t │ │ │ │ │ +0002b7d0: 6865 2073 7563 6365 7373 6675 6c20 6f70 he successful op │ │ │ │ │ +0002b7e0: 656e 696e 6720 6f66 2061 0a20 2020 2020 ening of a. │ │ │ │ │ +0002b7f0: 6669 6c65 2c20 616e 6420 6e6f 7420 6f6e file, and not on │ │ │ │ │ +0002b800: 2065 7665 7279 2070 726f 6265 2e0a 0a20 every probe... │ │ │ │ │ +0002b810: 2020 2020 5375 7070 6f73 6520 666f 7220 Suppose for │ │ │ │ │ +0002b820: 696e 7374 616e 6365 2074 6861 7420 7468 instance that th │ │ │ │ │ +0002b830: 6520 636f 6d70 696c 6572 2073 6561 7263 e compiler searc │ │ │ │ │ +0002b840: 6865 7320 7468 7265 6520 6469 7265 6374 hes three direct │ │ │ │ │ +0002b850: 6f72 6965 730a 2020 2020 2066 6f72 2061 ories. for a │ │ │ │ │ +0002b860: 2067 6976 656e 2068 6561 6465 722c 2061 given header, a │ │ │ │ │ +0002b870: 6e64 2074 6861 7420 7468 6520 6865 6164 nd that the head │ │ │ │ │ +0002b880: 6572 2069 7320 666f 756e 6420 696e 2074 er is found in t │ │ │ │ │ +0002b890: 6865 2074 6869 7264 0a20 2020 2020 6469 he third. di │ │ │ │ │ +0002b8a0: 7265 6374 6f72 792e 2020 4966 2074 6865 rectory. If the │ │ │ │ │ +0002b8b0: 2070 726f 6772 616d 6d65 7220 6572 726f programmer erro │ │ │ │ │ +0002b8c0: 6e65 6f75 736c 7920 6164 6473 2061 2068 neously adds a h │ │ │ │ │ +0002b8d0: 6561 6465 7220 6669 6c65 2077 6974 680a eader file with. │ │ │ │ │ +0002b8e0: 2020 2020 2074 6865 2073 616d 6520 6e61 the same na │ │ │ │ │ +0002b8f0: 6d65 2074 6f20 7468 6520 6669 7273 7420 me to the first │ │ │ │ │ +0002b900: 6469 7265 6374 6f72 792c 2074 6865 6e20 directory, then │ │ │ │ │ +0002b910: 6120 636c 6561 6e20 7265 6275 696c 6420 a clean rebuild │ │ │ │ │ +0002b920: 6672 6f6d 0a20 2020 2020 7363 7261 7463 from. scratc │ │ │ │ │ +0002b930: 6820 636f 756c 6420 6661 696c 2028 7375 h could fail (su │ │ │ │ │ +0002b940: 7070 6f73 6520 7468 6520 6e65 7720 6865 ppose the new he │ │ │ │ │ +0002b950: 6164 6572 2066 696c 6520 6973 2062 7567 ader file is bug │ │ │ │ │ +0002b960: 6779 292c 2077 6865 7265 6173 0a20 2020 gy), whereas. │ │ │ │ │ +0002b970: 2020 616e 2069 6e63 7265 6d65 6e74 616c an incremental │ │ │ │ │ +0002b980: 2072 6562 7569 6c64 2077 696c 6c20 7375 rebuild will su │ │ │ │ │ +0002b990: 6363 6565 642e 0a0a 2020 2020 2057 6861 cceed... Wha │ │ │ │ │ +0002b9a0: 7420 6861 7320 6861 7070 656e 6564 2068 t has happened h │ │ │ │ │ +0002b9b0: 6572 6520 6973 2074 6861 7420 7065 6f70 ere is that peop │ │ │ │ │ +0002b9c0: 6c65 2068 6176 6520 6120 6d69 7375 6e64 le have a misund │ │ │ │ │ +0002b9d0: 6572 7374 616e 6469 6e67 206f 660a 2020 erstanding of. │ │ │ │ │ +0002b9e0: 2020 2077 6861 7420 6120 6465 7065 6e64 what a depend │ │ │ │ │ +0002b9f0: 656e 6379 2069 732e 2020 546f 6f6c 2077 ency is. Tool w │ │ │ │ │ +0002ba00: 7269 7465 7273 2074 6869 6e6b 2061 2064 riters think a d │ │ │ │ │ +0002ba10: 6570 656e 6465 6e63 7920 656e 636f 6465 ependency encode │ │ │ │ │ +0002ba20: 730a 2020 2020 2069 6e66 6f72 6d61 7469 s. informati │ │ │ │ │ +0002ba30: 6f6e 2061 626f 7574 2077 6869 6368 2066 on about which f │ │ │ │ │ +0002ba40: 696c 6573 2077 6572 6520 7265 6164 2062 iles were read b │ │ │ │ │ +0002ba50: 7920 7468 6520 636f 6d70 696c 6572 2e20 y the compiler. │ │ │ │ │ +0002ba60: 2048 6f77 6576 6572 2c0a 2020 2020 2061 However,. a │ │ │ │ │ +0002ba70: 2064 6570 656e 6465 6e63 7920 6d75 7374 dependency must │ │ │ │ │ +0002ba80: 2061 6374 7561 6c6c 7920 656e 636f 6465 actually encode │ │ │ │ │ +0002ba90: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f information abo │ │ │ │ │ +0002baa0: 7574 2077 6861 7420 7468 650a 2020 2020 ut what the. │ │ │ │ │ +0002bab0: 2063 6f6d 7069 6c65 7220 7472 6965 6420 compiler tried │ │ │ │ │ +0002bac0: 746f 2064 6f2e 0a0a 2020 2020 2054 6869 to do... Thi │ │ │ │ │ +0002bad0: 7320 7072 6f62 6c65 6d20 6973 206e 6f74 s problem is not │ │ │ │ │ +0002bae0: 2073 6572 696f 7573 2069 6e20 7072 6163 serious in prac │ │ │ │ │ +0002baf0: 7469 6365 2e20 2050 726f 6772 616d 6d65 tice. Programme │ │ │ │ │ +0002bb00: 7273 2074 7970 6963 616c 6c79 2064 6f0a rs typically do. │ │ │ │ │ +0002bb10: 2020 2020 206e 6f74 2075 7365 2074 6865 not use the │ │ │ │ │ +0002bb20: 2073 616d 6520 6e61 6d65 2066 6f72 2061 same name for a │ │ │ │ │ +0002bb30: 2068 6561 6465 7220 6669 6c65 2074 7769 header file twi │ │ │ │ │ +0002bb40: 6365 2069 6e20 6120 6769 7665 6e20 7072 ce in a given pr │ │ │ │ │ +0002bb50: 6f6a 6563 742e 0a20 2020 2020 2841 7420 oject.. (At │ │ │ │ │ +0002bb60: 6c65 6173 742c 206e 6f74 2069 6e20 4320 least, not in C │ │ │ │ │ +0002bb70: 6f72 2043 2b2b 2e20 2054 6869 7320 7072 or C++. This pr │ │ │ │ │ +0002bb80: 6f62 6c65 6d20 6d61 7920 6265 206d 6f72 oblem may be mor │ │ │ │ │ +0002bb90: 6520 7472 6f75 626c 6573 6f6d 650a 2020 e troublesome. │ │ │ │ │ +0002bba0: 2020 2069 6e20 4a61 7661 2e29 2020 5468 in Java.) Th │ │ │ │ │ +0002bbb0: 6973 2070 726f 626c 656d 2069 7320 6561 is problem is ea │ │ │ │ │ +0002bbc0: 7379 2074 6f20 6669 782c 2062 7920 6d6f sy to fix, by mo │ │ │ │ │ +0002bbd0: 6469 6679 696e 6720 6465 7065 6e64 656e difying dependen │ │ │ │ │ +0002bbe0: 6379 0a20 2020 2020 6765 6e65 7261 746f cy. generato │ │ │ │ │ +0002bbf0: 7273 2074 6f20 7265 636f 7264 2065 7665 rs to record eve │ │ │ │ │ +0002bc00: 7279 2070 726f 6265 2c20 696e 7374 6561 ry probe, instea │ │ │ │ │ +0002bc10: 6420 6f66 2065 7665 7279 2073 7563 6365 d of every succe │ │ │ │ │ +0002bc20: 7373 6675 6c20 6f70 656e 2e0a 0a20 2020 ssful open... │ │ │ │ │ +0002bc30: 2a20 5369 6e63 6520 4175 746f 6d61 6b65 * Since Automake │ │ │ │ │ +0002bc40: 2067 656e 6572 6174 6573 2064 6570 656e generates depen │ │ │ │ │ +0002bc50: 6465 6e63 6965 7320 6173 2061 2073 6964 dencies as a sid │ │ │ │ │ +0002bc60: 6520 6566 6665 6374 206f 660a 2020 2020 e effect of. │ │ │ │ │ +0002bc70: 2063 6f6d 7069 6c61 7469 6f6e 2c20 7468 compilation, th │ │ │ │ │ +0002bc80: 6572 6520 6973 2061 2062 6f6f 7473 7472 ere is a bootstr │ │ │ │ │ +0002bc90: 6170 7069 6e67 2070 726f 626c 656d 2077 apping problem w │ │ │ │ │ +0002bca0: 6865 6e20 6865 6164 6572 2066 696c 6573 hen header files │ │ │ │ │ +0002bcb0: 2061 7265 0a20 2020 2020 6765 6e65 7261 are. genera │ │ │ │ │ +0002bcc0: 7465 6420 6279 2072 756e 6e69 6e67 2061 ted by running a │ │ │ │ │ +0002bcd0: 2070 726f 6772 616d 2e20 2054 6865 2070 program. The p │ │ │ │ │ +0002bce0: 726f 626c 656d 2069 7320 7468 6174 2c20 roblem is that, │ │ │ │ │ +0002bcf0: 7468 6520 6669 7273 740a 2020 2020 2074 the first. t │ │ │ │ │ +0002bd00: 696d 6520 7468 6520 6275 696c 6420 6973 ime the build is │ │ │ │ │ +0002bd10: 2064 6f6e 652c 2074 6865 7265 2069 7320 done, there is │ │ │ │ │ +0002bd20: 6e6f 2077 6179 2062 7920 6465 6661 756c no way by defaul │ │ │ │ │ +0002bd30: 7420 746f 206b 6e6f 7720 7468 6174 2074 t to know that t │ │ │ │ │ +0002bd40: 6865 0a20 2020 2020 6865 6164 6572 7320 he. headers │ │ │ │ │ +0002bd50: 6172 6520 7265 7175 6972 6564 2c20 736f are required, so │ │ │ │ │ +0002bd60: 206d 616b 6520 6d69 6768 7420 7472 7920 make might try │ │ │ │ │ +0002bd70: 746f 2072 756e 2061 2063 6f6d 7069 6c61 to run a compila │ │ │ │ │ +0002bd80: 7469 6f6e 2066 6f72 0a20 2020 2020 7768 tion for. wh │ │ │ │ │ +0002bd90: 6963 6820 7468 6520 6865 6164 6572 7320 ich the headers │ │ │ │ │ +0002bda0: 6861 7665 206e 6f74 2079 6574 2062 6565 have not yet bee │ │ │ │ │ +0002bdb0: 6e20 6275 696c 742e 0a0a 2020 2020 2054 n built... T │ │ │ │ │ +0002bdc0: 6869 7320 7761 7320 616c 736f 2061 2070 his was also a p │ │ │ │ │ +0002bdd0: 726f 626c 656d 2069 6e20 7468 6520 7072 roblem in the pr │ │ │ │ │ +0002bde0: 6576 696f 7573 2064 6570 656e 6465 6e63 evious dependenc │ │ │ │ │ +0002bdf0: 7920 7472 6163 6b69 6e67 0a20 2020 2020 y tracking. │ │ │ │ │ +0002be00: 696d 706c 656d 656e 7461 7469 6f6e 2e0a implementation.. │ │ │ │ │ +0002be10: 0a20 2020 2020 5468 6520 6375 7272 656e . The curren │ │ │ │ │ +0002be20: 7420 6669 7820 6973 2074 6f20 7573 6520 t fix is to use │ │ │ │ │ +0002be30: 2742 5549 4c54 5f53 4f55 5243 4553 2720 'BUILT_SOURCES' │ │ │ │ │ +0002be40: 746f 206c 6973 7420 6275 696c 7420 6865 to list built he │ │ │ │ │ +0002be50: 6164 6572 730a 2020 2020 2028 2a6e 6f74 aders. (*not │ │ │ │ │ +0002be60: 6520 536f 7572 6365 733a 3a29 2e20 2054 e Sources::). T │ │ │ │ │ +0002be70: 6869 7320 6361 7573 6573 2074 6865 6d20 his causes them │ │ │ │ │ +0002be80: 746f 2062 6520 6275 696c 7420 6265 666f to be built befo │ │ │ │ │ +0002be90: 7265 2061 6e79 206f 7468 6572 0a20 2020 re any other. │ │ │ │ │ +0002bea0: 2020 6275 696c 6420 7275 6c65 7320 6172 build rules ar │ │ │ │ │ +0002beb0: 6520 7275 6e2e 2020 5468 6973 2069 7320 e run. This is │ │ │ │ │ +0002bec0: 756e 7361 7469 7366 6163 746f 7279 2061 unsatisfactory a │ │ │ │ │ +0002bed0: 7320 6120 6765 6e65 7261 6c20 736f 6c75 s a general solu │ │ │ │ │ +0002bee0: 7469 6f6e 2c0a 2020 2020 2068 6f77 6576 tion,. howev │ │ │ │ │ +0002bef0: 6572 2069 6e20 7072 6163 7469 6365 2069 er in practice i │ │ │ │ │ +0002bf00: 7420 7365 656d 7320 7375 6666 6963 6965 t seems sufficie │ │ │ │ │ +0002bf10: 6e74 2066 6f72 206d 6f73 7420 6163 7475 nt for most actu │ │ │ │ │ +0002bf20: 616c 2070 726f 6772 616d 732e 0a0a 2020 al programs... │ │ │ │ │ +0002bf30: 2054 6869 7320 636f 6465 2069 7320 7573 This code is us │ │ │ │ │ +0002bf40: 6564 2073 696e 6365 2041 7574 6f6d 616b ed since Automak │ │ │ │ │ +0002bf50: 6520 312e 352e 0a0a 2020 2049 6e20 4743 e 1.5... In GC │ │ │ │ │ +0002bf60: 4320 332e 302c 2077 6520 6d61 6e61 6765 C 3.0, we manage │ │ │ │ │ +0002bf70: 6420 746f 2063 6f6e 7669 6e63 6520 7468 d to convince th │ │ │ │ │ +0002bf80: 6520 6d61 696e 7461 696e 6572 7320 746f e maintainers to │ │ │ │ │ +0002bf90: 2061 6464 2073 7065 6369 616c 0a63 6f6d add special.com │ │ │ │ │ +0002bfa0: 6d61 6e64 2d6c 696e 6520 6f70 7469 6f6e mand-line option │ │ │ │ │ +0002bfb0: 7320 746f 2068 656c 7020 4175 746f 6d61 s to help Automa │ │ │ │ │ +0002bfc0: 6b65 206d 6f72 6520 6566 6669 6369 656e ke more efficien │ │ │ │ │ +0002bfd0: 746c 7920 646f 2069 7473 206a 6f62 2e20 tly do its job. │ │ │ │ │ +0002bfe0: 2057 650a 686f 7065 6420 7468 6973 2077 We.hoped this w │ │ │ │ │ +0002bff0: 6f75 6c64 206c 6574 2075 7320 6176 6f69 ould let us avoi │ │ │ │ │ +0002c000: 6420 7468 6520 7573 6520 6f66 2061 2077 d the use of a w │ │ │ │ │ +0002c010: 7261 7070 6572 2073 6372 6970 7420 7768 rapper script wh │ │ │ │ │ +0002c020: 656e 0a41 7574 6f6d 616b 6527 7320 6175 en.Automake's au │ │ │ │ │ +0002c030: 746f 6d61 7469 6320 6465 7065 6e64 656e tomatic dependen │ │ │ │ │ +0002c040: 6379 2074 7261 636b 696e 6720 7761 7320 cy tracking was │ │ │ │ │ +0002c050: 7573 6564 2077 6974 6820 2767 6363 272e used with 'gcc'. │ │ │ │ │ +0002c060: 0a0a 2020 2055 6e66 6f72 7475 6e61 7465 .. Unfortunate │ │ │ │ │ +0002c070: 6c79 2c20 7468 6973 2063 6f64 6520 646f ly, this code do │ │ │ │ │ +0002c080: 6573 6e27 7420 7175 6974 6520 646f 2077 esn't quite do w │ │ │ │ │ +0002c090: 6861 7420 7765 2077 616e 742e 2020 496e hat we want. In │ │ │ │ │ +0002c0a0: 0a70 6172 7469 6375 6c61 722c 2069 7420 .particular, it │ │ │ │ │ +0002c0b0: 7265 6d6f 7665 7320 7468 6520 6465 7065 removes the depe │ │ │ │ │ +0002c0c0: 6e64 656e 6379 2066 696c 6520 6966 2074 ndency file if t │ │ │ │ │ +0002c0d0: 6865 2063 6f6d 7069 6c61 7469 6f6e 2066 he compilation f │ │ │ │ │ +0002c0e0: 6169 6c73 3b0a 7765 2764 2070 7265 6665 ails;.we'd prefe │ │ │ │ │ +0002c0f0: 7220 7468 6174 2069 7420 696e 7374 6561 r that it instea │ │ │ │ │ +0002c100: 6420 6f6e 6c79 2074 6f75 6368 2074 6865 d only touch the │ │ │ │ │ +0002c110: 2066 696c 6520 696e 2061 6e79 2077 6179 file in any way │ │ │ │ │ +0002c120: 2069 6620 7468 650a 636f 6d70 696c 6174 if the.compilat │ │ │ │ │ +0002c130: 696f 6e20 7375 6363 6565 6473 2e0a 0a20 ion succeeds... │ │ │ │ │ +0002c140: 2020 4e65 7665 7274 6865 6c65 7373 2c20 Nevertheless, │ │ │ │ │ +0002c150: 7369 6e63 6520 4175 746f 6d61 6b65 2031 since Automake 1 │ │ │ │ │ +0002c160: 2e37 2c20 7768 656e 2061 2072 6563 656e .7, when a recen │ │ │ │ │ +0002c170: 7420 2767 6363 2720 6973 2064 6574 6563 t 'gcc' is detec │ │ │ │ │ +0002c180: 7465 6420 6174 0a27 636f 6e66 6967 7572 ted at.'configur │ │ │ │ │ +0002c190: 6527 2074 696d 652c 2077 6520 696e 6c69 e' time, we inli │ │ │ │ │ +0002c1a0: 6e65 2074 6865 2064 6570 656e 6465 6e63 ne the dependenc │ │ │ │ │ +0002c1b0: 792d 6765 6e65 7261 7469 6f6e 2063 6f64 y-generation cod │ │ │ │ │ +0002c1c0: 6520 616e 6420 646f 206e 6f74 0a75 7365 e and do not.use │ │ │ │ │ +0002c1d0: 2074 6865 2027 6465 7063 6f6d 7027 2077 the 'depcomp' w │ │ │ │ │ +0002c1e0: 7261 7070 6572 2073 6372 6970 742e 2020 rapper script. │ │ │ │ │ +0002c1f0: 5468 6973 206d 616b 6573 2063 6f6d 7069 This makes compi │ │ │ │ │ +0002c200: 6c61 7469 6f6e 7320 6661 7374 6572 2066 lations faster f │ │ │ │ │ +0002c210: 6f72 0a74 686f 7365 2075 7369 6e67 2074 or.those using t │ │ │ │ │ +0002c220: 6869 7320 636f 6d70 696c 6572 2028 7072 his compiler (pr │ │ │ │ │ +0002c230: 6f62 6162 6c79 206f 7572 2070 7269 6d61 obably our prima │ │ │ │ │ +0002c240: 7279 2075 7365 7220 6261 7365 292e 2020 ry user base). │ │ │ │ │ +0002c250: 5468 650a 636f 756e 7465 7270 6172 7420 The.counterpart │ │ │ │ │ +0002c260: 6973 2074 6861 7420 6265 6361 7573 6520 is that because │ │ │ │ │ +0002c270: 7765 2068 6176 6520 746f 2065 6e63 6f64 we have to encod │ │ │ │ │ +0002c280: 6520 7477 6f20 636f 6d70 696c 6174 696f e two compilatio │ │ │ │ │ +0002c290: 6e20 7275 6c65 7320 696e 0a27 4d61 6b65 n rules in.'Make │ │ │ │ │ +0002c2a0: 6669 6c65 2720 2877 6974 6820 6f72 2077 file' (with or w │ │ │ │ │ +0002c2b0: 6974 686f 7574 2027 6465 7063 6f6d 7027 ithout 'depcomp' │ │ │ │ │ +0002c2c0: 292c 2074 6865 2070 726f 6475 6365 6420 ), the produced │ │ │ │ │ +0002c2d0: 274d 616b 6566 696c 6527 7320 6172 650a 'Makefile's are. │ │ │ │ │ +0002c2e0: 6c61 7267 6572 2e0a 0a1f 0a46 696c 653a larger.....File: │ │ │ │ │ +0002c2f0: 2061 7574 6f6d 616b 652d 312e 3131 2e69 automake-1.11.i │ │ │ │ │ +0002c300: 6e66 6f2c 2020 4e6f 6465 3a20 5465 6368 nfo, Node: Tech │ │ │ │ │ +0002c310: 6e69 7175 6573 2066 6f72 2044 6570 656e niques for Depen │ │ │ │ │ +0002c320: 6465 6e63 6965 732c 2020 4e65 7874 3a20 dencies, Next: │ │ │ │ │ +0002c330: 5265 636f 6d6d 656e 6461 7469 6f6e 7320 Recommendations │ │ │ │ │ +0002c340: 666f 7220 546f 6f6c 2057 7269 7465 7273 for Tool Writers │ │ │ │ │ +0002c350: 2c20 2050 7265 763a 2044 6570 656e 6465 , Prev: Depende │ │ │ │ │ +0002c360: 6e63 6965 7320 666f 7220 7468 6520 5573 ncies for the Us │ │ │ │ │ +0002c370: 6572 2c20 2055 703a 2044 6570 656e 6465 er, Up: Depende │ │ │ │ │ +0002c380: 6e63 7920 5472 6163 6b69 6e67 2045 766f ncy Tracking Evo │ │ │ │ │ +0002c390: 6c75 7469 6f6e 0a0a 3239 2e32 2e34 2054 lution..29.2.4 T │ │ │ │ │ +0002c3a0: 6563 686e 6971 7565 7320 666f 7220 436f echniques for Co │ │ │ │ │ +0002c3b0: 6d70 7574 696e 6720 4465 7065 6e64 656e mputing Dependen │ │ │ │ │ +0002c3c0: 6369 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d cies.----------- │ │ │ │ │ 0002c3d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0002c3e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002c3f0: 0a0a 5468 6572 6520 6172 6520 6163 7475 ..There are actu │ │ │ │ │ -0002c400: 616c 6c79 2073 6576 6572 616c 2077 6179 ally several way │ │ │ │ │ -0002c410: 7320 666f 7220 6120 6275 696c 6420 746f s for a build to │ │ │ │ │ -0002c420: 6f6c 206c 696b 6520 4175 746f 6d61 6b65 ol like Automake │ │ │ │ │ -0002c430: 2074 6f20 6361 7573 650a 746f 6f6c 7320 to cause.tools │ │ │ │ │ -0002c440: 746f 2067 656e 6572 6174 6520 6465 7065 to generate depe │ │ │ │ │ -0002c450: 6e64 656e 6369 6573 2e0a 0a27 6d61 6b65 ndencies...'make │ │ │ │ │ -0002c460: 6465 7065 6e64 270a 2020 2020 2054 6869 depend'. Thi │ │ │ │ │ -0002c470: 7320 7761 7320 6120 636f 6d6d 6f6e 6c79 s was a commonly │ │ │ │ │ -0002c480: 2d75 7365 6420 6d65 7468 6f64 2069 6e20 -used method in │ │ │ │ │ -0002c490: 7468 6520 7061 7374 2e20 2054 6865 2069 the past. The i │ │ │ │ │ -0002c4a0: 6465 6120 6973 2074 6f20 7275 6e20 610a dea is to run a. │ │ │ │ │ -0002c4b0: 2020 2020 2073 7065 6369 616c 2070 726f special pro │ │ │ │ │ -0002c4c0: 6772 616d 206f 7665 7220 7468 6520 736f gram over the so │ │ │ │ │ -0002c4d0: 7572 6365 2061 6e64 2068 6176 6520 6974 urce and have it │ │ │ │ │ -0002c4e0: 2067 656e 6572 6174 6520 6465 7065 6e64 generate depend │ │ │ │ │ -0002c4f0: 656e 6379 0a20 2020 2020 696e 666f 726d ency. inform │ │ │ │ │ -0002c500: 6174 696f 6e2e 2020 5472 6164 6974 696f ation. Traditio │ │ │ │ │ -0002c510: 6e61 6c20 696d 706c 656d 656e 7461 7469 nal implementati │ │ │ │ │ -0002c520: 6f6e 7320 6f66 2027 6d61 6b65 6465 7065 ons of 'makedepe │ │ │ │ │ -0002c530: 6e64 2720 6172 6520 6e6f 740a 2020 2020 nd' are not. │ │ │ │ │ -0002c540: 2063 6f6d 706c 6574 656c 7920 7072 6563 completely prec │ │ │ │ │ -0002c550: 6973 653b 206f 7264 696e 6172 696c 7920 ise; ordinarily │ │ │ │ │ -0002c560: 7468 6579 2077 6572 6520 636f 6e73 6572 they were conser │ │ │ │ │ -0002c570: 7661 7469 7665 2061 6e64 0a20 2020 2020 vative and. │ │ │ │ │ -0002c580: 6469 7363 6f76 6572 6564 2074 6f6f 206d discovered too m │ │ │ │ │ -0002c590: 616e 7920 6465 7065 6e64 656e 6369 6573 any dependencies │ │ │ │ │ -0002c5a0: 2e0a 5468 6520 746f 6f6c 0a20 2020 2020 ..The tool. │ │ │ │ │ -0002c5b0: 416e 206f 6276 696f 7573 2077 6179 2074 An obvious way t │ │ │ │ │ -0002c5c0: 6f20 6765 6e65 7261 7465 2064 6570 656e o generate depen │ │ │ │ │ -0002c5d0: 6465 6e63 6965 7320 6973 2074 6f20 7369 dencies is to si │ │ │ │ │ -0002c5e0: 6d70 6c79 2077 7269 7465 2074 6865 2074 mply write the t │ │ │ │ │ -0002c5f0: 6f6f 6c0a 2020 2020 2073 6f20 7468 6174 ool. so that │ │ │ │ │ -0002c600: 2069 7420 6361 6e20 6765 6e65 7261 7465 it can generate │ │ │ │ │ -0002c610: 2074 6865 2069 6e66 6f72 6d61 7469 6f6e the information │ │ │ │ │ -0002c620: 206e 6565 6465 6420 6279 2074 6865 2062 needed by the b │ │ │ │ │ -0002c630: 7569 6c64 2074 6f6f 6c2e 0a20 2020 2020 uild tool.. │ │ │ │ │ -0002c640: 5468 6973 2069 7320 616c 736f 2074 6865 This is also the │ │ │ │ │ -0002c650: 206d 6f73 7420 706f 7274 6162 6c65 206d most portable m │ │ │ │ │ -0002c660: 6574 686f 642e 2020 4d61 6e79 2063 6f6d ethod. Many com │ │ │ │ │ -0002c670: 7069 6c65 7273 2068 6176 6520 616e 0a20 pilers have an. │ │ │ │ │ -0002c680: 2020 2020 6f70 7469 6f6e 2074 6f20 6765 option to ge │ │ │ │ │ -0002c690: 6e65 7261 7465 2064 6570 656e 6465 6e63 nerate dependenc │ │ │ │ │ -0002c6a0: 6965 732e 2020 556e 666f 7274 756e 6174 ies. Unfortunat │ │ │ │ │ -0002c6b0: 656c 792c 206e 6f74 2061 6c6c 2074 6f6f ely, not all too │ │ │ │ │ -0002c6c0: 6c73 0a20 2020 2020 7072 6f76 6964 6520 ls. provide │ │ │ │ │ -0002c6d0: 7375 6368 2061 6e20 6f70 7469 6f6e 2e0a such an option.. │ │ │ │ │ -0002c6e0: 5468 6520 6669 6c65 2073 7973 7465 6d0a The file system. │ │ │ │ │ -0002c6f0: 2020 2020 2049 7420 6973 2070 6f73 7369 It is possi │ │ │ │ │ -0002c700: 626c 6520 746f 2077 7269 7465 2061 2073 ble to write a s │ │ │ │ │ -0002c710: 7065 6369 616c 2066 696c 6520 7379 7374 pecial file syst │ │ │ │ │ -0002c720: 656d 2074 6861 7420 7472 6163 6b73 206f em that tracks o │ │ │ │ │ -0002c730: 7065 6e73 2c0a 2020 2020 2072 6561 6473 pens,. reads │ │ │ │ │ -0002c740: 2c20 7772 6974 6573 2c20 6574 632c 2061 , writes, etc, a │ │ │ │ │ -0002c750: 6e64 2074 6865 6e20 6665 6564 2074 6869 nd then feed thi │ │ │ │ │ -0002c760: 7320 696e 666f 726d 6174 696f 6e20 6261 s information ba │ │ │ │ │ -0002c770: 636b 2074 6f20 7468 650a 2020 2020 2062 ck to the. b │ │ │ │ │ -0002c780: 7569 6c64 2074 6f6f 6c2e 2020 2763 6c65 uild tool. 'cle │ │ │ │ │ -0002c790: 6172 6d61 6b65 2720 646f 6573 2074 6869 armake' does thi │ │ │ │ │ -0002c7a0: 732e 2020 5468 6973 2069 7320 6120 7665 s. This is a ve │ │ │ │ │ -0002c7b0: 7279 2070 6f77 6572 6675 6c0a 2020 2020 ry powerful. │ │ │ │ │ -0002c7c0: 2074 6563 686e 6971 7565 2c20 6173 2069 technique, as i │ │ │ │ │ -0002c7d0: 7420 646f 6573 6e27 7420 7265 7175 6972 t doesn't requir │ │ │ │ │ -0002c7e0: 6520 636f 6f70 6572 6174 696f 6e20 6672 e cooperation fr │ │ │ │ │ -0002c7f0: 6f6d 2074 6865 2074 6f6f 6c2e 0a20 2020 om the tool.. │ │ │ │ │ -0002c800: 2020 556e 666f 7274 756e 6174 656c 7920 Unfortunately │ │ │ │ │ -0002c810: 6974 2069 7320 616c 736f 2076 6572 7920 it is also very │ │ │ │ │ -0002c820: 6469 6666 6963 756c 7420 746f 2069 6d70 difficult to imp │ │ │ │ │ -0002c830: 6c65 6d65 6e74 2061 6e64 2061 6c73 6f20 lement and also │ │ │ │ │ -0002c840: 6e6f 740a 2020 2020 2070 7261 6374 6963 not. practic │ │ │ │ │ -0002c850: 616c 2069 6e20 7468 6520 6765 6e65 7261 al in the genera │ │ │ │ │ -0002c860: 6c20 6361 7365 2e0a 274c 445f 5052 454c l case..'LD_PREL │ │ │ │ │ -0002c870: 4f41 4427 0a20 2020 2020 5261 7468 6572 OAD'. Rather │ │ │ │ │ -0002c880: 2074 6861 6e20 7573 6520 7468 6520 6669 than use the fi │ │ │ │ │ -0002c890: 6c65 2073 7973 7465 6d2c 206f 6e65 2063 le system, one c │ │ │ │ │ -0002c8a0: 6f75 6c64 2077 7269 7465 2061 2073 7065 ould write a spe │ │ │ │ │ -0002c8b0: 6369 616c 206c 6962 7261 7279 0a20 2020 cial library. │ │ │ │ │ -0002c8c0: 2020 746f 2069 6e74 6572 6365 7074 2027 to intercept ' │ │ │ │ │ -0002c8d0: 6f70 656e 2720 616e 6420 6f74 6865 7220 open' and other │ │ │ │ │ -0002c8e0: 7379 7363 616c 6c73 2e20 2054 6869 7320 syscalls. This │ │ │ │ │ -0002c8f0: 7465 6368 6e69 7175 6520 6973 2061 6c73 technique is als │ │ │ │ │ -0002c900: 6f0a 2020 2020 2071 7569 7465 2070 6f77 o. quite pow │ │ │ │ │ -0002c910: 6572 6675 6c2c 2062 7574 2075 6e66 6f72 erful, but unfor │ │ │ │ │ -0002c920: 7475 6e61 7465 6c79 2069 7420 6973 206e tunately it is n │ │ │ │ │ -0002c930: 6f74 2070 6f72 7461 626c 6520 656e 6f75 ot portable enou │ │ │ │ │ -0002c940: 6768 2066 6f72 2075 7365 0a20 2020 2020 gh for use. │ │ │ │ │ -0002c950: 696e 2027 6175 746f 6d61 6b65 272e 0a0a in 'automake'... │ │ │ │ │ -0002c960: 1f0a 4669 6c65 3a20 6175 746f 6d61 6b65 ..File: automake │ │ │ │ │ -0002c970: 2d31 2e31 312e 696e 666f 2c20 204e 6f64 -1.11.info, Nod │ │ │ │ │ -0002c980: 653a 2052 6563 6f6d 6d65 6e64 6174 696f e: Recommendatio │ │ │ │ │ -0002c990: 6e73 2066 6f72 2054 6f6f 6c20 5772 6974 ns for Tool Writ │ │ │ │ │ -0002c9a0: 6572 732c 2020 4e65 7874 3a20 4675 7475 ers, Next: Futu │ │ │ │ │ -0002c9b0: 7265 2044 6972 6563 7469 6f6e 7320 666f re Directions fo │ │ │ │ │ -0002c9c0: 7220 4465 7065 6e64 656e 6369 6573 2c20 r Dependencies, │ │ │ │ │ -0002c9d0: 2050 7265 763a 2054 6563 686e 6971 7565 Prev: Technique │ │ │ │ │ -0002c9e0: 7320 666f 7220 4465 7065 6e64 656e 6369 s for Dependenci │ │ │ │ │ -0002c9f0: 6573 2c20 2055 703a 2044 6570 656e 6465 es, Up: Depende │ │ │ │ │ -0002ca00: 6e63 7920 5472 6163 6b69 6e67 2045 766f ncy Tracking Evo │ │ │ │ │ -0002ca10: 6c75 7469 6f6e 0a0a 3239 2e32 2e35 2052 lution..29.2.5 R │ │ │ │ │ -0002ca20: 6563 6f6d 6d65 6e64 6174 696f 6e73 2066 ecommendations f │ │ │ │ │ -0002ca30: 6f72 2054 6f6f 6c20 5772 6974 6572 730a or Tool Writers. │ │ │ │ │ -0002ca40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0002c3f0: 2d0a 0a54 6865 7265 2061 7265 2061 6374 -..There are act │ │ │ │ │ +0002c400: 7561 6c6c 7920 7365 7665 7261 6c20 7761 ually several wa │ │ │ │ │ +0002c410: 7973 2066 6f72 2061 2062 7569 6c64 2074 ys for a build t │ │ │ │ │ +0002c420: 6f6f 6c20 6c69 6b65 2041 7574 6f6d 616b ool like Automak │ │ │ │ │ +0002c430: 6520 746f 2063 6175 7365 0a74 6f6f 6c73 e to cause.tools │ │ │ │ │ +0002c440: 2074 6f20 6765 6e65 7261 7465 2064 6570 to generate dep │ │ │ │ │ +0002c450: 656e 6465 6e63 6965 732e 0a0a 276d 616b endencies...'mak │ │ │ │ │ +0002c460: 6564 6570 656e 6427 0a20 2020 2020 5468 edepend'. Th │ │ │ │ │ +0002c470: 6973 2077 6173 2061 2063 6f6d 6d6f 6e6c is was a commonl │ │ │ │ │ +0002c480: 792d 7573 6564 206d 6574 686f 6420 696e y-used method in │ │ │ │ │ +0002c490: 2074 6865 2070 6173 742e 2020 5468 6520 the past. The │ │ │ │ │ +0002c4a0: 6964 6561 2069 7320 746f 2072 756e 2061 idea is to run a │ │ │ │ │ +0002c4b0: 0a20 2020 2020 7370 6563 6961 6c20 7072 . special pr │ │ │ │ │ +0002c4c0: 6f67 7261 6d20 6f76 6572 2074 6865 2073 ogram over the s │ │ │ │ │ +0002c4d0: 6f75 7263 6520 616e 6420 6861 7665 2069 ource and have i │ │ │ │ │ +0002c4e0: 7420 6765 6e65 7261 7465 2064 6570 656e t generate depen │ │ │ │ │ +0002c4f0: 6465 6e63 790a 2020 2020 2069 6e66 6f72 dency. infor │ │ │ │ │ +0002c500: 6d61 7469 6f6e 2e20 2054 7261 6469 7469 mation. Traditi │ │ │ │ │ +0002c510: 6f6e 616c 2069 6d70 6c65 6d65 6e74 6174 onal implementat │ │ │ │ │ +0002c520: 696f 6e73 206f 6620 276d 616b 6564 6570 ions of 'makedep │ │ │ │ │ +0002c530: 656e 6427 2061 7265 206e 6f74 0a20 2020 end' are not. │ │ │ │ │ +0002c540: 2020 636f 6d70 6c65 7465 6c79 2070 7265 completely pre │ │ │ │ │ +0002c550: 6369 7365 3b20 6f72 6469 6e61 7269 6c79 cise; ordinarily │ │ │ │ │ +0002c560: 2074 6865 7920 7765 7265 2063 6f6e 7365 they were conse │ │ │ │ │ +0002c570: 7276 6174 6976 6520 616e 640a 2020 2020 rvative and. │ │ │ │ │ +0002c580: 2064 6973 636f 7665 7265 6420 746f 6f20 discovered too │ │ │ │ │ +0002c590: 6d61 6e79 2064 6570 656e 6465 6e63 6965 many dependencie │ │ │ │ │ +0002c5a0: 732e 0a54 6865 2074 6f6f 6c0a 2020 2020 s..The tool. │ │ │ │ │ +0002c5b0: 2041 6e20 6f62 7669 6f75 7320 7761 7920 An obvious way │ │ │ │ │ +0002c5c0: 746f 2067 656e 6572 6174 6520 6465 7065 to generate depe │ │ │ │ │ +0002c5d0: 6e64 656e 6369 6573 2069 7320 746f 2073 ndencies is to s │ │ │ │ │ +0002c5e0: 696d 706c 7920 7772 6974 6520 7468 6520 imply write the │ │ │ │ │ +0002c5f0: 746f 6f6c 0a20 2020 2020 736f 2074 6861 tool. so tha │ │ │ │ │ +0002c600: 7420 6974 2063 616e 2067 656e 6572 6174 t it can generat │ │ │ │ │ +0002c610: 6520 7468 6520 696e 666f 726d 6174 696f e the informatio │ │ │ │ │ +0002c620: 6e20 6e65 6564 6564 2062 7920 7468 6520 n needed by the │ │ │ │ │ +0002c630: 6275 696c 6420 746f 6f6c 2e0a 2020 2020 build tool.. │ │ │ │ │ +0002c640: 2054 6869 7320 6973 2061 6c73 6f20 7468 This is also th │ │ │ │ │ +0002c650: 6520 6d6f 7374 2070 6f72 7461 626c 6520 e most portable │ │ │ │ │ +0002c660: 6d65 7468 6f64 2e20 204d 616e 7920 636f method. Many co │ │ │ │ │ +0002c670: 6d70 696c 6572 7320 6861 7665 2061 6e0a mpilers have an. │ │ │ │ │ +0002c680: 2020 2020 206f 7074 696f 6e20 746f 2067 option to g │ │ │ │ │ +0002c690: 656e 6572 6174 6520 6465 7065 6e64 656e enerate dependen │ │ │ │ │ +0002c6a0: 6369 6573 2e20 2055 6e66 6f72 7475 6e61 cies. Unfortuna │ │ │ │ │ +0002c6b0: 7465 6c79 2c20 6e6f 7420 616c 6c20 746f tely, not all to │ │ │ │ │ +0002c6c0: 6f6c 730a 2020 2020 2070 726f 7669 6465 ols. provide │ │ │ │ │ +0002c6d0: 2073 7563 6820 616e 206f 7074 696f 6e2e such an option. │ │ │ │ │ +0002c6e0: 0a54 6865 2066 696c 6520 7379 7374 656d .The file system │ │ │ │ │ +0002c6f0: 0a20 2020 2020 4974 2069 7320 706f 7373 . It is poss │ │ │ │ │ +0002c700: 6962 6c65 2074 6f20 7772 6974 6520 6120 ible to write a │ │ │ │ │ +0002c710: 7370 6563 6961 6c20 6669 6c65 2073 7973 special file sys │ │ │ │ │ +0002c720: 7465 6d20 7468 6174 2074 7261 636b 7320 tem that tracks │ │ │ │ │ +0002c730: 6f70 656e 732c 0a20 2020 2020 7265 6164 opens,. read │ │ │ │ │ +0002c740: 732c 2077 7269 7465 732c 2065 7463 2c20 s, writes, etc, │ │ │ │ │ +0002c750: 616e 6420 7468 656e 2066 6565 6420 7468 and then feed th │ │ │ │ │ +0002c760: 6973 2069 6e66 6f72 6d61 7469 6f6e 2062 is information b │ │ │ │ │ +0002c770: 6163 6b20 746f 2074 6865 0a20 2020 2020 ack to the. │ │ │ │ │ +0002c780: 6275 696c 6420 746f 6f6c 2e20 2027 636c build tool. 'cl │ │ │ │ │ +0002c790: 6561 726d 616b 6527 2064 6f65 7320 7468 earmake' does th │ │ │ │ │ +0002c7a0: 6973 2e20 2054 6869 7320 6973 2061 2076 is. This is a v │ │ │ │ │ +0002c7b0: 6572 7920 706f 7765 7266 756c 0a20 2020 ery powerful. │ │ │ │ │ +0002c7c0: 2020 7465 6368 6e69 7175 652c 2061 7320 technique, as │ │ │ │ │ +0002c7d0: 6974 2064 6f65 736e 2774 2072 6571 7569 it doesn't requi │ │ │ │ │ +0002c7e0: 7265 2063 6f6f 7065 7261 7469 6f6e 2066 re cooperation f │ │ │ │ │ +0002c7f0: 726f 6d20 7468 6520 746f 6f6c 2e0a 2020 rom the tool.. │ │ │ │ │ +0002c800: 2020 2055 6e66 6f72 7475 6e61 7465 6c79 Unfortunately │ │ │ │ │ +0002c810: 2069 7420 6973 2061 6c73 6f20 7665 7279 it is also very │ │ │ │ │ +0002c820: 2064 6966 6669 6375 6c74 2074 6f20 696d difficult to im │ │ │ │ │ +0002c830: 706c 656d 656e 7420 616e 6420 616c 736f plement and also │ │ │ │ │ +0002c840: 206e 6f74 0a20 2020 2020 7072 6163 7469 not. practi │ │ │ │ │ +0002c850: 6361 6c20 696e 2074 6865 2067 656e 6572 cal in the gener │ │ │ │ │ +0002c860: 616c 2063 6173 652e 0a27 4c44 5f50 5245 al case..'LD_PRE │ │ │ │ │ +0002c870: 4c4f 4144 270a 2020 2020 2052 6174 6865 LOAD'. Rathe │ │ │ │ │ +0002c880: 7220 7468 616e 2075 7365 2074 6865 2066 r than use the f │ │ │ │ │ +0002c890: 696c 6520 7379 7374 656d 2c20 6f6e 6520 ile system, one │ │ │ │ │ +0002c8a0: 636f 756c 6420 7772 6974 6520 6120 7370 could write a sp │ │ │ │ │ +0002c8b0: 6563 6961 6c20 6c69 6272 6172 790a 2020 ecial library. │ │ │ │ │ +0002c8c0: 2020 2074 6f20 696e 7465 7263 6570 7420 to intercept │ │ │ │ │ +0002c8d0: 276f 7065 6e27 2061 6e64 206f 7468 6572 'open' and other │ │ │ │ │ +0002c8e0: 2073 7973 6361 6c6c 732e 2020 5468 6973 syscalls. This │ │ │ │ │ +0002c8f0: 2074 6563 686e 6971 7565 2069 7320 616c technique is al │ │ │ │ │ +0002c900: 736f 0a20 2020 2020 7175 6974 6520 706f so. quite po │ │ │ │ │ +0002c910: 7765 7266 756c 2c20 6275 7420 756e 666f werful, but unfo │ │ │ │ │ +0002c920: 7274 756e 6174 656c 7920 6974 2069 7320 rtunately it is │ │ │ │ │ +0002c930: 6e6f 7420 706f 7274 6162 6c65 2065 6e6f not portable eno │ │ │ │ │ +0002c940: 7567 6820 666f 7220 7573 650a 2020 2020 ugh for use. │ │ │ │ │ +0002c950: 2069 6e20 2761 7574 6f6d 616b 6527 2e0a in 'automake'.. │ │ │ │ │ +0002c960: 0a1f 0a46 696c 653a 2061 7574 6f6d 616b ...File: automak │ │ │ │ │ +0002c970: 652d 312e 3131 2e69 6e66 6f2c 2020 4e6f e-1.11.info, No │ │ │ │ │ +0002c980: 6465 3a20 5265 636f 6d6d 656e 6461 7469 de: Recommendati │ │ │ │ │ +0002c990: 6f6e 7320 666f 7220 546f 6f6c 2057 7269 ons for Tool Wri │ │ │ │ │ +0002c9a0: 7465 7273 2c20 204e 6578 743a 2046 7574 ters, Next: Fut │ │ │ │ │ +0002c9b0: 7572 6520 4469 7265 6374 696f 6e73 2066 ure Directions f │ │ │ │ │ +0002c9c0: 6f72 2044 6570 656e 6465 6e63 6965 732c or Dependencies, │ │ │ │ │ +0002c9d0: 2020 5072 6576 3a20 5465 6368 6e69 7175 Prev: Techniqu │ │ │ │ │ +0002c9e0: 6573 2066 6f72 2044 6570 656e 6465 6e63 es for Dependenc │ │ │ │ │ +0002c9f0: 6965 732c 2020 5570 3a20 4465 7065 6e64 ies, Up: Depend │ │ │ │ │ +0002ca00: 656e 6379 2054 7261 636b 696e 6720 4576 ency Tracking Ev │ │ │ │ │ +0002ca10: 6f6c 7574 696f 6e0a 0a32 392e 322e 3520 olution..29.2.5 │ │ │ │ │ +0002ca20: 5265 636f 6d6d 656e 6461 7469 6f6e 7320 Recommendations │ │ │ │ │ +0002ca30: 666f 7220 546f 6f6c 2057 7269 7465 7273 for Tool Writers │ │ │ │ │ +0002ca40: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ 0002ca50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002ca60: 2d2d 2d2d 2d2d 2d0a 0a57 6520 7468 696e -------..We thin │ │ │ │ │ -0002ca70: 6b20 7468 6174 2065 7665 7279 2063 6f6d k that every com │ │ │ │ │ -0002ca80: 7069 6c61 7469 6f6e 2074 6f6f 6c20 6f75 pilation tool ou │ │ │ │ │ -0002ca90: 6768 7420 746f 2062 6520 6162 6c65 2074 ght to be able t │ │ │ │ │ -0002caa0: 6f20 6765 6e65 7261 7465 0a64 6570 656e o generate.depen │ │ │ │ │ -0002cab0: 6465 6e63 6965 7320 6173 2061 2073 6964 dencies as a sid │ │ │ │ │ -0002cac0: 6520 6566 6665 6374 206f 6620 636f 6d70 e effect of comp │ │ │ │ │ -0002cad0: 696c 6174 696f 6e2e 2020 4675 7274 6865 ilation. Furthe │ │ │ │ │ -0002cae0: 726d 6f72 652c 2061 7420 6c65 6173 740a rmore, at least. │ │ │ │ │ -0002caf0: 7768 696c 6520 276d 616b 6527 2d62 6173 while 'make'-bas │ │ │ │ │ -0002cb00: 6564 2074 6f6f 6c73 2061 7265 206e 6561 ed tools are nea │ │ │ │ │ -0002cb10: 726c 7920 756e 6976 6572 7361 6c6c 7920 rly universally │ │ │ │ │ -0002cb20: 696e 2075 7365 2028 6174 206c 6561 7374 in use (at least │ │ │ │ │ -0002cb30: 2069 6e20 7468 650a 6672 6565 2073 6f66 in the.free sof │ │ │ │ │ -0002cb40: 7477 6172 6520 636f 6d6d 756e 6974 7929 tware community) │ │ │ │ │ -0002cb50: 2c20 7468 6520 746f 6f6c 2069 7473 656c , the tool itsel │ │ │ │ │ -0002cb60: 6620 7368 6f75 6c64 2067 656e 6572 6174 f should generat │ │ │ │ │ -0002cb70: 6520 6475 6d6d 790a 6465 7065 6e64 656e e dummy.dependen │ │ │ │ │ -0002cb80: 6369 6573 2066 6f72 2068 6561 6465 7220 cies for header │ │ │ │ │ -0002cb90: 6669 6c65 732c 2074 6f20 6176 6f69 6420 files, to avoid │ │ │ │ │ -0002cba0: 7468 6520 6465 6c65 7465 6420 6865 6164 the deleted head │ │ │ │ │ -0002cbb0: 6572 2066 696c 6520 6275 672e 0a46 696e er file bug..Fin │ │ │ │ │ -0002cbc0: 616c 6c79 2c20 7468 6520 746f 6f6c 2073 ally, the tool s │ │ │ │ │ -0002cbd0: 686f 756c 6420 6765 6e65 7261 7465 2061 hould generate a │ │ │ │ │ -0002cbe0: 2064 6570 656e 6465 6e63 7920 666f 7220 dependency for │ │ │ │ │ -0002cbf0: 6561 6368 2070 726f 6265 2c20 696e 7374 each probe, inst │ │ │ │ │ -0002cc00: 6561 640a 6f66 2065 6163 6820 7375 6363 ead.of each succ │ │ │ │ │ -0002cc10: 6573 7366 756c 2066 696c 6520 6f70 656e essful file open │ │ │ │ │ -0002cc20: 2c20 696e 206f 7264 6572 2074 6f20 6176 , in order to av │ │ │ │ │ -0002cc30: 6f69 6420 7468 6520 6475 706c 6963 6174 oid the duplicat │ │ │ │ │ -0002cc40: 6564 206e 6577 0a68 6561 6465 7220 6275 ed new.header bu │ │ │ │ │ -0002cc50: 672e 0a0a 1f0a 4669 6c65 3a20 6175 746f g.....File: auto │ │ │ │ │ -0002cc60: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -0002cc70: 204e 6f64 653a 2046 7574 7572 6520 4469 Node: Future Di │ │ │ │ │ -0002cc80: 7265 6374 696f 6e73 2066 6f72 2044 6570 rections for Dep │ │ │ │ │ -0002cc90: 656e 6465 6e63 6965 732c 2020 5072 6576 endencies, Prev │ │ │ │ │ -0002cca0: 3a20 5265 636f 6d6d 656e 6461 7469 6f6e : Recommendation │ │ │ │ │ -0002ccb0: 7320 666f 7220 546f 6f6c 2057 7269 7465 s for Tool Write │ │ │ │ │ -0002ccc0: 7273 2c20 2055 703a 2044 6570 656e 6465 rs, Up: Depende │ │ │ │ │ -0002ccd0: 6e63 7920 5472 6163 6b69 6e67 2045 766f ncy Tracking Evo │ │ │ │ │ -0002cce0: 6c75 7469 6f6e 0a0a 3239 2e32 2e36 2046 lution..29.2.6 F │ │ │ │ │ -0002ccf0: 7574 7572 6520 4469 7265 6374 696f 6e73 uture Directions │ │ │ │ │ -0002cd00: 2066 6f72 2044 6570 656e 6465 6e63 6965 for Dependencie │ │ │ │ │ -0002cd10: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d s.-------------- │ │ │ │ │ +0002ca60: 2d2d 2d2d 2d2d 2d2d 0a0a 5765 2074 6869 --------..We thi │ │ │ │ │ +0002ca70: 6e6b 2074 6861 7420 6576 6572 7920 636f nk that every co │ │ │ │ │ +0002ca80: 6d70 696c 6174 696f 6e20 746f 6f6c 206f mpilation tool o │ │ │ │ │ +0002ca90: 7567 6874 2074 6f20 6265 2061 626c 6520 ught to be able │ │ │ │ │ +0002caa0: 746f 2067 656e 6572 6174 650a 6465 7065 to generate.depe │ │ │ │ │ +0002cab0: 6e64 656e 6369 6573 2061 7320 6120 7369 ndencies as a si │ │ │ │ │ +0002cac0: 6465 2065 6666 6563 7420 6f66 2063 6f6d de effect of com │ │ │ │ │ +0002cad0: 7069 6c61 7469 6f6e 2e20 2046 7572 7468 pilation. Furth │ │ │ │ │ +0002cae0: 6572 6d6f 7265 2c20 6174 206c 6561 7374 ermore, at least │ │ │ │ │ +0002caf0: 0a77 6869 6c65 2027 6d61 6b65 272d 6261 .while 'make'-ba │ │ │ │ │ +0002cb00: 7365 6420 746f 6f6c 7320 6172 6520 6e65 sed tools are ne │ │ │ │ │ +0002cb10: 6172 6c79 2075 6e69 7665 7273 616c 6c79 arly universally │ │ │ │ │ +0002cb20: 2069 6e20 7573 6520 2861 7420 6c65 6173 in use (at leas │ │ │ │ │ +0002cb30: 7420 696e 2074 6865 0a66 7265 6520 736f t in the.free so │ │ │ │ │ +0002cb40: 6674 7761 7265 2063 6f6d 6d75 6e69 7479 ftware community │ │ │ │ │ +0002cb50: 292c 2074 6865 2074 6f6f 6c20 6974 7365 ), the tool itse │ │ │ │ │ +0002cb60: 6c66 2073 686f 756c 6420 6765 6e65 7261 lf should genera │ │ │ │ │ +0002cb70: 7465 2064 756d 6d79 0a64 6570 656e 6465 te dummy.depende │ │ │ │ │ +0002cb80: 6e63 6965 7320 666f 7220 6865 6164 6572 ncies for header │ │ │ │ │ +0002cb90: 2066 696c 6573 2c20 746f 2061 766f 6964 files, to avoid │ │ │ │ │ +0002cba0: 2074 6865 2064 656c 6574 6564 2068 6561 the deleted hea │ │ │ │ │ +0002cbb0: 6465 7220 6669 6c65 2062 7567 2e0a 4669 der file bug..Fi │ │ │ │ │ +0002cbc0: 6e61 6c6c 792c 2074 6865 2074 6f6f 6c20 nally, the tool │ │ │ │ │ +0002cbd0: 7368 6f75 6c64 2067 656e 6572 6174 6520 should generate │ │ │ │ │ +0002cbe0: 6120 6465 7065 6e64 656e 6379 2066 6f72 a dependency for │ │ │ │ │ +0002cbf0: 2065 6163 6820 7072 6f62 652c 2069 6e73 each probe, ins │ │ │ │ │ +0002cc00: 7465 6164 0a6f 6620 6561 6368 2073 7563 tead.of each suc │ │ │ │ │ +0002cc10: 6365 7373 6675 6c20 6669 6c65 206f 7065 cessful file ope │ │ │ │ │ +0002cc20: 6e2c 2069 6e20 6f72 6465 7220 746f 2061 n, in order to a │ │ │ │ │ +0002cc30: 766f 6964 2074 6865 2064 7570 6c69 6361 void the duplica │ │ │ │ │ +0002cc40: 7465 6420 6e65 770a 6865 6164 6572 2062 ted new.header b │ │ │ │ │ +0002cc50: 7567 2e0a 0a1f 0a46 696c 653a 2061 7574 ug.....File: aut │ │ │ │ │ +0002cc60: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +0002cc70: 2020 4e6f 6465 3a20 4675 7475 7265 2044 Node: Future D │ │ │ │ │ +0002cc80: 6972 6563 7469 6f6e 7320 666f 7220 4465 irections for De │ │ │ │ │ +0002cc90: 7065 6e64 656e 6369 6573 2c20 2050 7265 pendencies, Pre │ │ │ │ │ +0002cca0: 763a 2052 6563 6f6d 6d65 6e64 6174 696f v: Recommendatio │ │ │ │ │ +0002ccb0: 6e73 2066 6f72 2054 6f6f 6c20 5772 6974 ns for Tool Writ │ │ │ │ │ +0002ccc0: 6572 732c 2020 5570 3a20 4465 7065 6e64 ers, Up: Depend │ │ │ │ │ +0002ccd0: 656e 6379 2054 7261 636b 696e 6720 4576 ency Tracking Ev │ │ │ │ │ +0002cce0: 6f6c 7574 696f 6e0a 0a32 392e 322e 3620 olution..29.2.6 │ │ │ │ │ +0002ccf0: 4675 7475 7265 2044 6972 6563 7469 6f6e Future Direction │ │ │ │ │ +0002cd00: 7320 666f 7220 4465 7065 6e64 656e 6369 s for Dependenci │ │ │ │ │ +0002cd10: 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d es.------------- │ │ │ │ │ 0002cd20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002cd30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a43 7572 -----------..Cur │ │ │ │ │ -0002cd40: 7265 6e74 6c79 2c20 6f6e 6c79 206c 616e rently, only lan │ │ │ │ │ -0002cd50: 6775 6167 6573 2061 6e64 2063 6f6d 7069 guages and compi │ │ │ │ │ -0002cd60: 6c65 7273 2075 6e64 6572 7374 6f6f 6420 lers understood │ │ │ │ │ -0002cd70: 6279 2041 7574 6f6d 616b 6520 6361 6e20 by Automake can │ │ │ │ │ -0002cd80: 6861 7665 0a64 6570 656e 6465 6e63 7920 have.dependency │ │ │ │ │ -0002cd90: 7472 6163 6b69 6e67 2065 6e61 626c 6564 tracking enabled │ │ │ │ │ -0002cda0: 2e20 2057 6520 776f 756c 6420 6c69 6b65 . We would like │ │ │ │ │ -0002cdb0: 2074 6f20 7365 6520 6966 2069 7420 6973 to see if it is │ │ │ │ │ -0002cdc0: 2070 7261 6374 6963 616c 0a28 616e 6420 practical.(and │ │ │ │ │ -0002cdd0: 776f 7274 6877 6869 6c65 2920 746f 206c worthwhile) to l │ │ │ │ │ -0002cde0: 6574 2074 6869 7320 7375 7070 6f72 7420 et this support │ │ │ │ │ -0002cdf0: 6265 2065 7874 656e 6465 6420 6279 2074 be extended by t │ │ │ │ │ -0002ce00: 6865 2075 7365 7220 746f 0a6c 616e 6775 he user to.langu │ │ │ │ │ -0002ce10: 6167 6573 2075 6e6b 6e6f 776e 2074 6f20 ages unknown to │ │ │ │ │ -0002ce20: 4175 746f 6d61 6b65 2e0a 0a1f 0a46 696c Automake.....Fil │ │ │ │ │ -0002ce30: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ -0002ce40: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5265 .info, Node: Re │ │ │ │ │ -0002ce50: 6c65 6173 6573 2c20 2050 7265 763a 2044 leases, Prev: D │ │ │ │ │ -0002ce60: 6570 656e 6465 6e63 7920 5472 6163 6b69 ependency Tracki │ │ │ │ │ -0002ce70: 6e67 2045 766f 6c75 7469 6f6e 2c20 2055 ng Evolution, U │ │ │ │ │ -0002ce80: 703a 2048 6973 746f 7279 0a0a 3239 2e33 p: History..29.3 │ │ │ │ │ -0002ce90: 2052 656c 6561 7365 2053 7461 7469 7374 Release Statist │ │ │ │ │ -0002cea0: 6963 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ics.============ │ │ │ │ │ -0002ceb0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ │ -0002cec0: 2066 6f6c 6c6f 7769 6e67 2074 6162 6c65 following table │ │ │ │ │ -0002ced0: 2028 696e 7370 6972 6564 2062 7920 2770 (inspired by 'p │ │ │ │ │ -0002cee0: 6572 6c68 6973 7428 3129 2729 2071 7561 erlhist(1)') qua │ │ │ │ │ -0002cef0: 6e74 6966 6965 7320 7468 6520 6576 6f6c ntifies the evol │ │ │ │ │ -0002cf00: 7574 696f 6e0a 6f66 2041 7574 6f6d 616b ution.of Automak │ │ │ │ │ -0002cf10: 6520 7573 696e 6720 7468 6573 6520 6d65 e using these me │ │ │ │ │ -0002cf20: 7472 6963 733a 0a0a 4461 7465 2c20 5265 trics:..Date, Re │ │ │ │ │ -0002cf30: 6c0a 2020 2020 2054 6865 2064 6174 6520 l. The date │ │ │ │ │ -0002cf40: 616e 6420 7665 7273 696f 6e20 6f66 2074 and version of t │ │ │ │ │ -0002cf50: 6865 2072 656c 6561 7365 2e0a 616d 0a20 he release..am. │ │ │ │ │ -0002cf60: 2020 2020 5468 6520 6e75 6d62 6572 206f The number o │ │ │ │ │ -0002cf70: 6620 6c69 6e65 7320 6f66 2074 6865 2027 f lines of the ' │ │ │ │ │ -0002cf80: 6175 746f 6d61 6b65 2720 7363 7269 7074 automake' script │ │ │ │ │ -0002cf90: 2e0a 6163 6c0a 2020 2020 2054 6865 206e ..acl. The n │ │ │ │ │ -0002cfa0: 756d 6265 7220 6f66 206c 696e 6573 206f umber of lines o │ │ │ │ │ -0002cfb0: 6620 7468 6520 2761 636c 6f63 616c 2720 f the 'aclocal' │ │ │ │ │ -0002cfc0: 7363 7269 7074 2e0a 706d 0a20 2020 2020 script..pm. │ │ │ │ │ -0002cfd0: 5468 6520 6e75 6d62 6572 206f 6620 6c69 The number of li │ │ │ │ │ -0002cfe0: 6e65 7320 6f66 2074 6865 2027 5065 726c nes of the 'Perl │ │ │ │ │ -0002cff0: 2720 7375 7070 6f72 7469 6e67 206d 6f64 ' supporting mod │ │ │ │ │ -0002d000: 756c 6573 2e0a 272a 2e61 6d27 0a20 2020 ules..'*.am'. │ │ │ │ │ -0002d010: 2020 5468 6520 6e75 6d62 6572 206f 6620 The number of │ │ │ │ │ -0002d020: 6c69 6e65 7320 6f66 2074 6865 2027 4d61 lines of the 'Ma │ │ │ │ │ -0002d030: 6b65 6669 6c65 2720 6672 6167 6d65 6e74 kefile' fragment │ │ │ │ │ -0002d040: 732e 2020 5468 6520 6e75 6d62 6572 2069 s. The number i │ │ │ │ │ -0002d050: 6e0a 2020 2020 2070 6172 656e 7468 6573 n. parenthes │ │ │ │ │ -0002d060: 6573 2069 7320 7468 6520 6e75 6d62 6572 es is the number │ │ │ │ │ -0002d070: 206f 6620 6669 6c65 732e 0a6d 340a 2020 of files..m4. │ │ │ │ │ -0002d080: 2020 2054 6865 206e 756d 6265 7220 6f66 The number of │ │ │ │ │ -0002d090: 206c 696e 6573 2028 616e 6420 6669 6c65 lines (and file │ │ │ │ │ -0002d0a0: 7329 206f 6620 4175 746f 636f 6e66 206d s) of Autoconf m │ │ │ │ │ -0002d0b0: 6163 726f 732e 0a64 6f63 0a20 2020 2020 acros..doc. │ │ │ │ │ -0002d0c0: 5468 6520 6e75 6d62 6572 206f 6620 7061 The number of pa │ │ │ │ │ -0002d0d0: 6765 7320 6f66 2074 6865 2064 6f63 756d ges of the docum │ │ │ │ │ -0002d0e0: 656e 7461 7469 6f6e 2028 7468 6520 506f entation (the Po │ │ │ │ │ -0002d0f0: 7374 7363 7269 7074 2076 6572 7369 6f6e stscript version │ │ │ │ │ -0002d100: 292e 0a74 0a20 2020 2020 5468 6520 6e75 )..t. The nu │ │ │ │ │ -0002d110: 6d62 6572 206f 6620 7465 7374 2063 6173 mber of test cas │ │ │ │ │ -0002d120: 6573 2069 6e20 7468 6520 7465 7374 2073 es in the test s │ │ │ │ │ -0002d130: 7569 7465 2e20 204f 6620 7468 6f73 652c uite. Of those, │ │ │ │ │ -0002d140: 2074 6865 206e 756d 6265 720a 2020 2020 the number. │ │ │ │ │ -0002d150: 2069 6e20 7061 7265 6e74 6865 7365 7320 in parentheses │ │ │ │ │ -0002d160: 6973 2074 6865 206e 756d 6265 7220 6f66 is the number of │ │ │ │ │ -0002d170: 2067 656e 6572 6174 6564 2074 6573 7420 generated test │ │ │ │ │ -0002d180: 6361 7365 732e 0a0a 4461 7465 2020 2020 cases...Date │ │ │ │ │ -0002d190: 2020 2020 2052 656c 2020 2020 2020 616d Rel am │ │ │ │ │ -0002d1a0: 2020 2020 2061 636c 2020 2020 706d 2020 acl pm │ │ │ │ │ -0002d1b0: 2020 2027 2a2e 616d 2720 2020 2020 206d '*.am' m │ │ │ │ │ -0002d1c0: 3420 2020 2020 2020 2020 2064 6f63 2020 4 doc │ │ │ │ │ -0002d1d0: 2074 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.------------- │ │ │ │ │ +0002cd30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4375 ------------..Cu │ │ │ │ │ +0002cd40: 7272 656e 746c 792c 206f 6e6c 7920 6c61 rrently, only la │ │ │ │ │ +0002cd50: 6e67 7561 6765 7320 616e 6420 636f 6d70 nguages and comp │ │ │ │ │ +0002cd60: 696c 6572 7320 756e 6465 7273 746f 6f64 ilers understood │ │ │ │ │ +0002cd70: 2062 7920 4175 746f 6d61 6b65 2063 616e by Automake can │ │ │ │ │ +0002cd80: 2068 6176 650a 6465 7065 6e64 656e 6379 have.dependency │ │ │ │ │ +0002cd90: 2074 7261 636b 696e 6720 656e 6162 6c65 tracking enable │ │ │ │ │ +0002cda0: 642e 2020 5765 2077 6f75 6c64 206c 696b d. We would lik │ │ │ │ │ +0002cdb0: 6520 746f 2073 6565 2069 6620 6974 2069 e to see if it i │ │ │ │ │ +0002cdc0: 7320 7072 6163 7469 6361 6c0a 2861 6e64 s practical.(and │ │ │ │ │ +0002cdd0: 2077 6f72 7468 7768 696c 6529 2074 6f20 worthwhile) to │ │ │ │ │ +0002cde0: 6c65 7420 7468 6973 2073 7570 706f 7274 let this support │ │ │ │ │ +0002cdf0: 2062 6520 6578 7465 6e64 6564 2062 7920 be extended by │ │ │ │ │ +0002ce00: 7468 6520 7573 6572 2074 6f0a 6c61 6e67 the user to.lang │ │ │ │ │ +0002ce10: 7561 6765 7320 756e 6b6e 6f77 6e20 746f uages unknown to │ │ │ │ │ +0002ce20: 2041 7574 6f6d 616b 652e 0a0a 1f0a 4669 Automake.....Fi │ │ │ │ │ +0002ce30: 6c65 3a20 6175 746f 6d61 6b65 2d31 2e31 le: automake-1.1 │ │ │ │ │ +0002ce40: 312e 696e 666f 2c20 204e 6f64 653a 2052 1.info, Node: R │ │ │ │ │ +0002ce50: 656c 6561 7365 732c 2020 5072 6576 3a20 eleases, Prev: │ │ │ │ │ +0002ce60: 4465 7065 6e64 656e 6379 2054 7261 636b Dependency Track │ │ │ │ │ +0002ce70: 696e 6720 4576 6f6c 7574 696f 6e2c 2020 ing Evolution, │ │ │ │ │ +0002ce80: 5570 3a20 4869 7374 6f72 790a 0a32 392e Up: History..29. │ │ │ │ │ +0002ce90: 3320 5265 6c65 6173 6520 5374 6174 6973 3 Release Statis │ │ │ │ │ +0002cea0: 7469 6373 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d tics.=========== │ │ │ │ │ +0002ceb0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ +0002cec0: 6520 666f 6c6c 6f77 696e 6720 7461 626c e following tabl │ │ │ │ │ +0002ced0: 6520 2869 6e73 7069 7265 6420 6279 2027 e (inspired by ' │ │ │ │ │ +0002cee0: 7065 726c 6869 7374 2831 2927 2920 7175 perlhist(1)') qu │ │ │ │ │ +0002cef0: 616e 7469 6669 6573 2074 6865 2065 766f antifies the evo │ │ │ │ │ +0002cf00: 6c75 7469 6f6e 0a6f 6620 4175 746f 6d61 lution.of Automa │ │ │ │ │ +0002cf10: 6b65 2075 7369 6e67 2074 6865 7365 206d ke using these m │ │ │ │ │ +0002cf20: 6574 7269 6373 3a0a 0a44 6174 652c 2052 etrics:..Date, R │ │ │ │ │ +0002cf30: 656c 0a20 2020 2020 5468 6520 6461 7465 el. The date │ │ │ │ │ +0002cf40: 2061 6e64 2076 6572 7369 6f6e 206f 6620 and version of │ │ │ │ │ +0002cf50: 7468 6520 7265 6c65 6173 652e 0a61 6d0a the release..am. │ │ │ │ │ +0002cf60: 2020 2020 2054 6865 206e 756d 6265 7220 The number │ │ │ │ │ +0002cf70: 6f66 206c 696e 6573 206f 6620 7468 6520 of lines of the │ │ │ │ │ +0002cf80: 2761 7574 6f6d 616b 6527 2073 6372 6970 'automake' scrip │ │ │ │ │ +0002cf90: 742e 0a61 636c 0a20 2020 2020 5468 6520 t..acl. The │ │ │ │ │ +0002cfa0: 6e75 6d62 6572 206f 6620 6c69 6e65 7320 number of lines │ │ │ │ │ +0002cfb0: 6f66 2074 6865 2027 6163 6c6f 6361 6c27 of the 'aclocal' │ │ │ │ │ +0002cfc0: 2073 6372 6970 742e 0a70 6d0a 2020 2020 script..pm. │ │ │ │ │ +0002cfd0: 2054 6865 206e 756d 6265 7220 6f66 206c The number of l │ │ │ │ │ +0002cfe0: 696e 6573 206f 6620 7468 6520 2750 6572 ines of the 'Per │ │ │ │ │ +0002cff0: 6c27 2073 7570 706f 7274 696e 6720 6d6f l' supporting mo │ │ │ │ │ +0002d000: 6475 6c65 732e 0a27 2a2e 616d 270a 2020 dules..'*.am'. │ │ │ │ │ +0002d010: 2020 2054 6865 206e 756d 6265 7220 6f66 The number of │ │ │ │ │ +0002d020: 206c 696e 6573 206f 6620 7468 6520 274d lines of the 'M │ │ │ │ │ +0002d030: 616b 6566 696c 6527 2066 7261 676d 656e akefile' fragmen │ │ │ │ │ +0002d040: 7473 2e20 2054 6865 206e 756d 6265 7220 ts. The number │ │ │ │ │ +0002d050: 696e 0a20 2020 2020 7061 7265 6e74 6865 in. parenthe │ │ │ │ │ +0002d060: 7365 7320 6973 2074 6865 206e 756d 6265 ses is the numbe │ │ │ │ │ +0002d070: 7220 6f66 2066 696c 6573 2e0a 6d34 0a20 r of files..m4. │ │ │ │ │ +0002d080: 2020 2020 5468 6520 6e75 6d62 6572 206f The number o │ │ │ │ │ +0002d090: 6620 6c69 6e65 7320 2861 6e64 2066 696c f lines (and fil │ │ │ │ │ +0002d0a0: 6573 2920 6f66 2041 7574 6f63 6f6e 6620 es) of Autoconf │ │ │ │ │ +0002d0b0: 6d61 6372 6f73 2e0a 646f 630a 2020 2020 macros..doc. │ │ │ │ │ +0002d0c0: 2054 6865 206e 756d 6265 7220 6f66 2070 The number of p │ │ │ │ │ +0002d0d0: 6167 6573 206f 6620 7468 6520 646f 6375 ages of the docu │ │ │ │ │ +0002d0e0: 6d65 6e74 6174 696f 6e20 2874 6865 2050 mentation (the P │ │ │ │ │ +0002d0f0: 6f73 7473 6372 6970 7420 7665 7273 696f ostscript versio │ │ │ │ │ +0002d100: 6e29 2e0a 740a 2020 2020 2054 6865 206e n)..t. The n │ │ │ │ │ +0002d110: 756d 6265 7220 6f66 2074 6573 7420 6361 umber of test ca │ │ │ │ │ +0002d120: 7365 7320 696e 2074 6865 2074 6573 7420 ses in the test │ │ │ │ │ +0002d130: 7375 6974 652e 2020 4f66 2074 686f 7365 suite. Of those │ │ │ │ │ +0002d140: 2c20 7468 6520 6e75 6d62 6572 0a20 2020 , the number. │ │ │ │ │ +0002d150: 2020 696e 2070 6172 656e 7468 6573 6573 in parentheses │ │ │ │ │ +0002d160: 2069 7320 7468 6520 6e75 6d62 6572 206f is the number o │ │ │ │ │ +0002d170: 6620 6765 6e65 7261 7465 6420 7465 7374 f generated test │ │ │ │ │ +0002d180: 2063 6173 6573 2e0a 0a44 6174 6520 2020 cases...Date │ │ │ │ │ +0002d190: 2020 2020 2020 5265 6c20 2020 2020 2061 Rel a │ │ │ │ │ +0002d1a0: 6d20 2020 2020 6163 6c20 2020 2070 6d20 m acl pm │ │ │ │ │ +0002d1b0: 2020 2020 272a 2e61 6d27 2020 2020 2020 '*.am' │ │ │ │ │ +0002d1c0: 6d34 2020 2020 2020 2020 2020 646f 6320 m4 doc │ │ │ │ │ +0002d1d0: 2020 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.------------ │ │ │ │ │ 0002d1e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0002d1f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0002d200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0002d210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002d220: 2d2d 2d2d 2d2d 2d0a 3139 3934 2d30 392d -------.1994-09- │ │ │ │ │ -0002d230: 3139 2020 2043 5653 2020 2020 2020 3134 19 CVS 14 │ │ │ │ │ -0002d240: 3120 2020 2020 2020 2020 2020 2020 2020 1 │ │ │ │ │ -0002d250: 2020 2032 3939 2028 3234 290a 3139 3934 299 (24).1994 │ │ │ │ │ -0002d260: 2d31 312d 3035 2020 2043 5653 2020 2020 -11-05 CVS │ │ │ │ │ -0002d270: 2020 3230 3820 2020 2020 2020 2020 2020 208 │ │ │ │ │ -0002d280: 2020 2020 2020 2033 3332 2028 3238 290a 332 (28). │ │ │ │ │ -0002d290: 3139 3935 2d31 312d 3233 2020 2030 2e32 1995-11-23 0.2 │ │ │ │ │ -0002d2a0: 3020 2020 2020 3533 3320 2020 2020 2020 0 533 │ │ │ │ │ -0002d2b0: 2020 2020 2020 2020 2020 2034 3538 2028 458 ( │ │ │ │ │ -0002d2c0: 3335 2920 2020 2020 2020 2020 2020 2020 35) │ │ │ │ │ -0002d2d0: 2020 2039 0a31 3939 352d 3131 2d32 3620 9.1995-11-26 │ │ │ │ │ -0002d2e0: 2020 302e 3231 2020 2020 2036 3133 2020 0.21 613 │ │ │ │ │ +0002d220: 2d2d 2d2d 2d2d 2d2d 0a31 3939 342d 3039 --------.1994-09 │ │ │ │ │ +0002d230: 2d31 3920 2020 4356 5320 2020 2020 2031 -19 CVS 1 │ │ │ │ │ +0002d240: 3431 2020 2020 2020 2020 2020 2020 2020 41 │ │ │ │ │ +0002d250: 2020 2020 3239 3920 2832 3429 0a31 3939 299 (24).199 │ │ │ │ │ +0002d260: 342d 3131 2d30 3520 2020 4356 5320 2020 4-11-05 CVS │ │ │ │ │ +0002d270: 2020 2032 3038 2020 2020 2020 2020 2020 208 │ │ │ │ │ +0002d280: 2020 2020 2020 2020 3333 3220 2832 3829 332 (28) │ │ │ │ │ +0002d290: 0a31 3939 352d 3131 2d32 3320 2020 302e .1995-11-23 0. │ │ │ │ │ +0002d2a0: 3230 2020 2020 2035 3333 2020 2020 2020 20 533 │ │ │ │ │ +0002d2b0: 2020 2020 2020 2020 2020 2020 3435 3820 458 │ │ │ │ │ +0002d2c0: 2833 3529 2020 2020 2020 2020 2020 2020 (35) │ │ │ │ │ +0002d2d0: 2020 2020 390a 3139 3935 2d31 312d 3236 9.1995-11-26 │ │ │ │ │ +0002d2e0: 2020 2030 2e32 3120 2020 2020 3631 3320 0.21 613 │ │ │ │ │ 0002d2f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0002d300: 3438 3020 2833 3629 2020 2020 2020 2020 480 (36) │ │ │ │ │ -0002d310: 2020 2020 2020 2020 3131 0a31 3939 352d 11.1995- │ │ │ │ │ -0002d320: 3131 2d32 3820 2020 302e 3232 2020 2020 11-28 0.22 │ │ │ │ │ -0002d330: 2031 3131 3620 2020 2020 2020 2020 2020 1116 │ │ │ │ │ -0002d340: 2020 2020 2020 3533 3920 2833 3829 2020 539 (38) │ │ │ │ │ -0002d350: 2020 2020 2020 2020 2020 2020 2020 3132 12 │ │ │ │ │ -0002d360: 0a31 3939 352d 3131 2d32 3920 2020 302e .1995-11-29 0. │ │ │ │ │ -0002d370: 3233 2020 2020 2031 3234 3020 2020 2020 23 1240 │ │ │ │ │ -0002d380: 2020 2020 2020 2020 2020 2020 3534 3120 541 │ │ │ │ │ -0002d390: 2833 3829 2020 2020 2020 2020 2020 2020 (38) │ │ │ │ │ -0002d3a0: 2020 2020 3132 0a31 3939 352d 3132 2d30 12.1995-12-0 │ │ │ │ │ -0002d3b0: 3820 2020 302e 3234 2020 2020 2031 3436 8 0.24 146 │ │ │ │ │ -0002d3c0: 3220 2020 2020 2020 2020 2020 2020 2020 2 │ │ │ │ │ -0002d3d0: 2020 3530 3420 2833 3329 2020 2020 2020 504 (33) │ │ │ │ │ -0002d3e0: 2020 2020 2020 2020 2020 3134 0a31 3939 14.199 │ │ │ │ │ -0002d3f0: 352d 3132 2d31 3020 2020 302e 3235 2020 5-12-10 0.25 │ │ │ │ │ -0002d400: 2020 2031 3531 3320 2020 2020 2020 2020 1513 │ │ │ │ │ -0002d410: 2020 2020 2020 2020 3531 3120 2833 3729 511 (37) │ │ │ │ │ -0002d420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0002d430: 3135 0a31 3939 362d 3031 2d30 3320 2020 15.1996-01-03 │ │ │ │ │ -0002d440: 302e 3236 2020 2020 2031 3730 3620 2020 0.26 1706 │ │ │ │ │ -0002d450: 2020 2020 2020 2020 2020 2020 2020 3433 43 │ │ │ │ │ -0002d460: 3820 2833 3629 2020 2020 2020 2020 2020 8 (36) │ │ │ │ │ -0002d470: 2020 2020 2020 3136 0a31 3939 362d 3031 16.1996-01 │ │ │ │ │ -0002d480: 2d30 3320 2020 302e 3237 2020 2020 2031 -03 0.27 1 │ │ │ │ │ -0002d490: 3730 3620 2020 2020 2020 2020 2020 2020 706 │ │ │ │ │ -0002d4a0: 2020 2020 3433 3820 2833 3629 2020 2020 438 (36) │ │ │ │ │ -0002d4b0: 2020 2020 2020 2020 2020 2020 3136 0a31 16.1 │ │ │ │ │ -0002d4c0: 3939 362d 3031 2d31 3320 2020 302e 3238 996-01-13 0.28 │ │ │ │ │ -0002d4d0: 2020 2020 2031 3936 3420 2020 2020 2020 1964 │ │ │ │ │ -0002d4e0: 2020 2020 2020 2020 2020 3933 3420 2833 934 (3 │ │ │ │ │ -0002d4f0: 3329 2020 2020 2020 2020 2020 2020 2020 3) │ │ │ │ │ -0002d500: 2020 3136 0a31 3939 362d 3032 2d30 3720 16.1996-02-07 │ │ │ │ │ -0002d510: 2020 302e 3239 2020 2020 2032 3239 3920 0.29 2299 │ │ │ │ │ +0002d300: 2034 3830 2028 3336 2920 2020 2020 2020 480 (36) │ │ │ │ │ +0002d310: 2020 2020 2020 2020 2031 310a 3139 3935 11.1995 │ │ │ │ │ +0002d320: 2d31 312d 3238 2020 2030 2e32 3220 2020 -11-28 0.22 │ │ │ │ │ +0002d330: 2020 3131 3136 2020 2020 2020 2020 2020 1116 │ │ │ │ │ +0002d340: 2020 2020 2020 2035 3339 2028 3338 2920 539 (38) │ │ │ │ │ +0002d350: 2020 2020 2020 2020 2020 2020 2020 2031 1 │ │ │ │ │ +0002d360: 320a 3139 3935 2d31 312d 3239 2020 2030 2.1995-11-29 0 │ │ │ │ │ +0002d370: 2e32 3320 2020 2020 3132 3430 2020 2020 .23 1240 │ │ │ │ │ +0002d380: 2020 2020 2020 2020 2020 2020 2035 3431 541 │ │ │ │ │ +0002d390: 2028 3338 2920 2020 2020 2020 2020 2020 (38) │ │ │ │ │ +0002d3a0: 2020 2020 2031 320a 3139 3935 2d31 322d 12.1995-12- │ │ │ │ │ +0002d3b0: 3038 2020 2030 2e32 3420 2020 2020 3134 08 0.24 14 │ │ │ │ │ +0002d3c0: 3632 2020 2020 2020 2020 2020 2020 2020 62 │ │ │ │ │ +0002d3d0: 2020 2035 3034 2028 3333 2920 2020 2020 504 (33) │ │ │ │ │ +0002d3e0: 2020 2020 2020 2020 2020 2031 340a 3139 14.19 │ │ │ │ │ +0002d3f0: 3935 2d31 322d 3130 2020 2030 2e32 3520 95-12-10 0.25 │ │ │ │ │ +0002d400: 2020 2020 3135 3133 2020 2020 2020 2020 1513 │ │ │ │ │ +0002d410: 2020 2020 2020 2020 2035 3131 2028 3337 511 (37 │ │ │ │ │ +0002d420: 2920 2020 2020 2020 2020 2020 2020 2020 ) │ │ │ │ │ +0002d430: 2031 350a 3139 3936 2d30 312d 3033 2020 15.1996-01-03 │ │ │ │ │ +0002d440: 2030 2e32 3620 2020 2020 3137 3036 2020 0.26 1706 │ │ │ │ │ +0002d450: 2020 2020 2020 2020 2020 2020 2020 2034 4 │ │ │ │ │ +0002d460: 3338 2028 3336 2920 2020 2020 2020 2020 38 (36) │ │ │ │ │ +0002d470: 2020 2020 2020 2031 360a 3139 3936 2d30 16.1996-0 │ │ │ │ │ +0002d480: 312d 3033 2020 2030 2e32 3720 2020 2020 1-03 0.27 │ │ │ │ │ +0002d490: 3137 3036 2020 2020 2020 2020 2020 2020 1706 │ │ │ │ │ +0002d4a0: 2020 2020 2034 3338 2028 3336 2920 2020 438 (36) │ │ │ │ │ +0002d4b0: 2020 2020 2020 2020 2020 2020 2031 360a 16. │ │ │ │ │ +0002d4c0: 3139 3936 2d30 312d 3133 2020 2030 2e32 1996-01-13 0.2 │ │ │ │ │ +0002d4d0: 3820 2020 2020 3139 3634 2020 2020 2020 8 1964 │ │ │ │ │ +0002d4e0: 2020 2020 2020 2020 2020 2039 3334 2028 934 ( │ │ │ │ │ +0002d4f0: 3333 2920 2020 2020 2020 2020 2020 2020 33) │ │ │ │ │ +0002d500: 2020 2031 360a 3139 3936 2d30 322d 3037 16.1996-02-07 │ │ │ │ │ +0002d510: 2020 2030 2e32 3920 2020 2020 3232 3939 0.29 2299 │ │ │ │ │ 0002d520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0002d530: 3933 3620 2833 3329 2020 2020 2020 2020 936 (33) │ │ │ │ │ -0002d540: 2020 2020 2020 2020 3137 0a31 3939 362d 17.1996- │ │ │ │ │ -0002d550: 3032 2d32 3420 2020 302e 3330 2020 2020 02-24 0.30 │ │ │ │ │ -0002d560: 2032 3534 3420 2020 2020 2020 2020 2020 2544 │ │ │ │ │ -0002d570: 2020 2020 2020 3931 3920 2833 3229 2020 919 (32) │ │ │ │ │ -0002d580: 2020 3835 2028 3129 2020 2020 2020 3230 85 (1) 20 │ │ │ │ │ -0002d590: 2020 2020 390a 3139 3936 2d30 332d 3131 9.1996-03-11 │ │ │ │ │ -0002d5a0: 2020 2030 2e33 3120 2020 2020 3238 3737 0.31 2877 │ │ │ │ │ -0002d5b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0002d5c0: 2039 3139 2028 3332 2920 2020 2038 3520 919 (32) 85 │ │ │ │ │ -0002d5d0: 2831 2920 2020 2020 2032 3920 2020 2031 (1) 29 1 │ │ │ │ │ -0002d5e0: 370a 3139 3936 2d30 342d 3237 2020 2030 7.1996-04-27 0 │ │ │ │ │ -0002d5f0: 2e33 3220 2020 2020 3330 3538 2020 2020 .32 3058 │ │ │ │ │ -0002d600: 2020 2020 2020 2020 2020 2020 2039 3231 921 │ │ │ │ │ -0002d610: 2028 3331 2920 2020 2038 3520 2831 2920 (31) 85 (1) │ │ │ │ │ -0002d620: 2020 2020 2033 3020 2020 2032 360a 3139 30 26.19 │ │ │ │ │ -0002d630: 3936 2d30 352d 3138 2020 2030 2e33 3320 96-05-18 0.33 │ │ │ │ │ -0002d640: 2020 2020 3331 3130 2020 2020 2020 2020 3110 │ │ │ │ │ -0002d650: 2020 2020 2020 2020 2039 3236 2028 3331 926 (31 │ │ │ │ │ -0002d660: 2920 2020 2031 3035 2028 3129 2020 2020 ) 105 (1) │ │ │ │ │ -0002d670: 2033 3020 2020 2033 350a 3139 3936 2d30 30 35.1996-0 │ │ │ │ │ -0002d680: 352d 3238 2020 2031 2e30 2020 2020 2020 5-28 1.0 │ │ │ │ │ -0002d690: 3331 3334 2020 2020 2020 2020 2020 2020 3134 │ │ │ │ │ -0002d6a0: 2020 2020 2039 3733 2028 3332 2920 2020 973 (32) │ │ │ │ │ -0002d6b0: 2031 3035 2028 3129 2020 2020 2033 3020 105 (1) 30 │ │ │ │ │ -0002d6c0: 2020 2033 380a 3139 3937 2d30 362d 3232 38.1997-06-22 │ │ │ │ │ -0002d6d0: 2020 2031 2e32 2020 2020 2020 3630 3839 1.2 6089 │ │ │ │ │ -0002d6e0: 2020 2033 3835 2020 2020 2020 2020 2020 385 │ │ │ │ │ -0002d6f0: 2031 3239 3420 2833 3629 2020 2035 3932 1294 (36) 592 │ │ │ │ │ -0002d700: 2028 3230 2920 2020 2033 3720 2020 2031 (20) 37 1 │ │ │ │ │ -0002d710: 3236 0a31 3939 382d 3034 2d30 3520 2020 26.1998-04-05 │ │ │ │ │ -0002d720: 312e 3320 2020 2020 2036 3431 3520 2020 1.3 6415 │ │ │ │ │ -0002d730: 3432 3220 2020 2020 2020 2020 2020 3134 422 14 │ │ │ │ │ -0002d740: 3730 2028 3339 2920 2020 3734 3120 2832 70 (39) 741 (2 │ │ │ │ │ -0002d750: 3329 2020 2020 3339 2020 2020 3135 360a 3) 39 156. │ │ │ │ │ -0002d760: 3139 3939 2d30 312d 3134 2020 2031 2e34 1999-01-14 1.4 │ │ │ │ │ -0002d770: 2020 2020 2020 3732 3430 2020 2034 3236 7240 426 │ │ │ │ │ -0002d780: 2020 2020 2020 2020 2020 2031 3539 3120 1591 │ │ │ │ │ -0002d790: 2834 3029 2020 2037 3334 2028 3230 2920 (40) 734 (20) │ │ │ │ │ -0002d7a0: 2020 2035 3120 2020 2031 3937 0a32 3030 51 197.200 │ │ │ │ │ -0002d7b0: 312d 3035 2d30 3820 2020 312e 342d 7031 1-05-08 1.4-p1 │ │ │ │ │ -0002d7c0: 2020 2037 3235 3120 2020 3432 3620 2020 7251 426 │ │ │ │ │ -0002d7d0: 2020 2020 2020 2020 3135 3931 2028 3430 1591 (40 │ │ │ │ │ -0002d7e0: 2920 2020 3733 3420 2832 3029 2020 2020 ) 734 (20) │ │ │ │ │ -0002d7f0: 3531 2020 2020 3139 370a 3230 3031 2d30 51 197.2001-0 │ │ │ │ │ -0002d800: 352d 3234 2020 2031 2e34 2d70 3220 2020 5-24 1.4-p2 │ │ │ │ │ -0002d810: 3732 3638 2020 2034 3339 2020 2020 2020 7268 439 │ │ │ │ │ -0002d820: 2020 2020 2031 3539 3120 2834 3029 2020 1591 (40) │ │ │ │ │ -0002d830: 2037 3334 2028 3230 2920 2020 2034 3920 734 (20) 49 │ │ │ │ │ -0002d840: 2020 2031 3937 0a32 3030 312d 3036 2d30 197.2001-06-0 │ │ │ │ │ -0002d850: 3720 2020 312e 342d 7033 2020 2037 3331 7 1.4-p3 731 │ │ │ │ │ -0002d860: 3220 2020 3433 3920 2020 2020 2020 2020 2 439 │ │ │ │ │ -0002d870: 2020 3135 3931 2028 3430 2920 2020 3733 1591 (40) 73 │ │ │ │ │ -0002d880: 3420 2832 3029 2020 2020 3439 2020 2020 4 (20) 49 │ │ │ │ │ -0002d890: 3139 370a 3230 3031 2d30 362d 3130 2020 197.2001-06-10 │ │ │ │ │ -0002d8a0: 2031 2e34 2d70 3420 2020 3733 3231 2020 1.4-p4 7321 │ │ │ │ │ -0002d8b0: 2034 3339 2020 2020 2020 2020 2020 2031 439 1 │ │ │ │ │ -0002d8c0: 3539 3120 2834 3029 2020 2037 3334 2028 591 (40) 734 ( │ │ │ │ │ -0002d8d0: 3230 2920 2020 2034 3920 2020 2031 3938 20) 49 198 │ │ │ │ │ -0002d8e0: 0a32 3030 312d 3037 2d31 3520 2020 312e .2001-07-15 1. │ │ │ │ │ -0002d8f0: 342d 7035 2020 2037 3232 3820 2020 3432 4-p5 7228 42 │ │ │ │ │ -0002d900: 3620 2020 2020 2020 2020 2020 3135 3936 6 1596 │ │ │ │ │ -0002d910: 2028 3430 2920 2020 3733 3420 2832 3029 (40) 734 (20) │ │ │ │ │ -0002d920: 2020 2020 3531 2020 2020 3139 380a 3230 51 198.20 │ │ │ │ │ -0002d930: 3031 2d30 382d 3233 2020 2031 2e35 2020 01-08-23 1.5 │ │ │ │ │ -0002d940: 2020 2020 3830 3136 2020 2034 3735 2020 8016 475 │ │ │ │ │ -0002d950: 2020 3630 3020 2020 2032 3635 3420 2833 600 2654 (3 │ │ │ │ │ -0002d960: 3929 2020 2031 3136 3620 2832 3929 2020 9) 1166 (29) │ │ │ │ │ -0002d970: 2036 3320 2020 2033 3237 0a32 3030 322d 63 327.2002- │ │ │ │ │ -0002d980: 3033 2d30 3520 2020 312e 3620 2020 2020 03-05 1.6 │ │ │ │ │ -0002d990: 2038 3436 3520 2020 3437 3520 2020 2031 8465 475 1 │ │ │ │ │ -0002d9a0: 3133 3620 2020 3237 3332 2028 3339 2920 136 2732 (39) │ │ │ │ │ -0002d9b0: 2020 3136 3033 2028 3237 2920 2020 3636 1603 (27) 66 │ │ │ │ │ -0002d9c0: 2020 2020 3336 350a 3230 3032 2d30 342d 365.2002-04- │ │ │ │ │ -0002d9d0: 3131 2020 2031 2e36 2e31 2020 2020 3835 11 1.6.1 85 │ │ │ │ │ -0002d9e0: 3434 2020 2034 3735 2020 2020 3131 3336 44 475 1136 │ │ │ │ │ -0002d9f0: 2020 2032 3734 3120 2833 3929 2020 2031 2741 (39) 1 │ │ │ │ │ -0002da00: 3630 3320 2832 3729 2020 2036 3620 2020 603 (27) 66 │ │ │ │ │ -0002da10: 2033 3732 0a32 3030 322d 3036 2d31 3420 372.2002-06-14 │ │ │ │ │ -0002da20: 2020 312e 362e 3220 2020 2038 3537 3520 1.6.2 8575 │ │ │ │ │ -0002da30: 2020 3437 3520 2020 2031 3133 3620 2020 475 1136 │ │ │ │ │ -0002da40: 3238 3030 2028 3339 2920 2020 3136 3039 2800 (39) 1609 │ │ │ │ │ -0002da50: 2028 3237 2920 2020 3637 2020 2020 3338 (27) 67 38 │ │ │ │ │ -0002da60: 360a 3230 3032 2d30 372d 3238 2020 2031 6.2002-07-28 1 │ │ │ │ │ -0002da70: 2e36 2e33 2020 2020 3836 3030 2020 2034 .6.3 8600 4 │ │ │ │ │ -0002da80: 3735 2020 2020 3131 3533 2020 2032 3830 75 1153 280 │ │ │ │ │ -0002da90: 3920 2833 3929 2020 2031 3630 3920 2832 9 (39) 1609 (2 │ │ │ │ │ -0002daa0: 3729 2020 2036 3720 2020 2033 3931 0a32 7) 67 391.2 │ │ │ │ │ -0002dab0: 3030 322d 3037 2d32 3820 2020 312e 342d 002-07-28 1.4- │ │ │ │ │ -0002dac0: 7036 2020 2037 3333 3220 2020 3435 3520 p6 7332 455 │ │ │ │ │ -0002dad0: 2020 2020 2020 2020 2020 3135 3936 2028 1596 ( │ │ │ │ │ -0002dae0: 3430 2920 2020 3733 3520 2832 3029 2020 40) 735 (20) │ │ │ │ │ -0002daf0: 2020 3439 2020 2020 3139 370a 3230 3032 49 197.2002 │ │ │ │ │ -0002db00: 2d30 392d 3235 2020 2031 2e37 2020 2020 -09-25 1.7 │ │ │ │ │ -0002db10: 2020 3931 3839 2020 2034 3731 2020 2020 9189 471 │ │ │ │ │ -0002db20: 3137 3930 2020 2032 3936 3520 2833 3929 1790 2965 (39) │ │ │ │ │ -0002db30: 2020 2031 3630 3620 2832 3829 2020 2037 1606 (28) 7 │ │ │ │ │ -0002db40: 3320 2020 2034 3330 0a32 3030 322d 3130 3 430.2002-10 │ │ │ │ │ -0002db50: 2d31 3620 2020 312e 372e 3120 2020 2039 -16 1.7.1 9 │ │ │ │ │ -0002db60: 3232 3920 2020 3437 3520 2020 2031 3739 229 475 179 │ │ │ │ │ -0002db70: 3020 2020 3239 3737 2028 3339 2920 2020 0 2977 (39) │ │ │ │ │ -0002db80: 3136 3036 2028 3238 2920 2020 3733 2020 1606 (28) 73 │ │ │ │ │ -0002db90: 2020 3433 370a 3230 3032 2d31 322d 3036 437.2002-12-06 │ │ │ │ │ -0002dba0: 2020 2031 2e37 2e32 2020 2020 3933 3334 1.7.2 9334 │ │ │ │ │ -0002dbb0: 2020 2034 3735 2020 2020 3137 3930 2020 475 1790 │ │ │ │ │ -0002dbc0: 2032 3938 3820 2833 3929 2020 2031 3630 2988 (39) 160 │ │ │ │ │ -0002dbd0: 3620 2832 3829 2020 2037 3720 2020 2034 6 (28) 77 4 │ │ │ │ │ -0002dbe0: 3435 0a32 3030 332d 3032 2d32 3020 2020 45.2003-02-20 │ │ │ │ │ -0002dbf0: 312e 372e 3320 2020 2039 3338 3920 2020 1.7.3 9389 │ │ │ │ │ -0002dc00: 3437 3520 2020 2031 3739 3020 2020 3330 475 1790 30 │ │ │ │ │ -0002dc10: 3233 2028 3339 2920 2020 3136 3531 2028 23 (39) 1651 ( │ │ │ │ │ -0002dc20: 3239 2920 2020 3834 2020 2020 3434 380a 29) 84 448. │ │ │ │ │ -0002dc30: 3230 3033 2d30 342d 3233 2020 2031 2e37 2003-04-23 1.7 │ │ │ │ │ -0002dc40: 2e34 2020 2020 3934 3239 2020 2034 3735 .4 9429 475 │ │ │ │ │ -0002dc50: 2020 2020 3137 3930 2020 2033 3033 3120 1790 3031 │ │ │ │ │ -0002dc60: 2833 3929 2020 2031 3634 3420 2832 3929 (39) 1644 (29) │ │ │ │ │ -0002dc70: 2020 2038 3520 2020 2034 3538 0a32 3030 85 458.200 │ │ │ │ │ -0002dc80: 332d 3035 2d31 3820 2020 312e 372e 3520 3-05-18 1.7.5 │ │ │ │ │ -0002dc90: 2020 2039 3432 3920 2020 3437 3520 2020 9429 475 │ │ │ │ │ -0002dca0: 2031 3739 3020 2020 3330 3333 2028 3339 1790 3033 (39 │ │ │ │ │ -0002dcb0: 2920 2020 3136 3435 2028 3239 2920 2020 ) 1645 (29) │ │ │ │ │ -0002dcc0: 3835 2020 2020 3435 390a 3230 3033 2d30 85 459.2003-0 │ │ │ │ │ -0002dcd0: 372d 3130 2020 2031 2e37 2e36 2020 2020 7-10 1.7.6 │ │ │ │ │ -0002dce0: 3934 3432 2020 2034 3735 2020 2020 3137 9442 475 17 │ │ │ │ │ -0002dcf0: 3930 2020 2033 3033 3320 2833 3929 2020 90 3033 (39) │ │ │ │ │ -0002dd00: 2031 3636 3020 2832 3929 2020 2038 3520 1660 (29) 85 │ │ │ │ │ -0002dd10: 2020 2034 3631 0a32 3030 332d 3039 2d30 461.2003-09-0 │ │ │ │ │ -0002dd20: 3720 2020 312e 372e 3720 2020 2039 3434 7 1.7.7 944 │ │ │ │ │ -0002dd30: 3320 2020 3437 3520 2020 2031 3739 3020 3 475 1790 │ │ │ │ │ -0002dd40: 2020 3330 3431 2028 3339 2920 2020 3136 3041 (39) 16 │ │ │ │ │ -0002dd50: 3630 2028 3239 2920 2020 3930 2020 2020 60 (29) 90 │ │ │ │ │ -0002dd60: 3436 370a 3230 3033 2d31 302d 3037 2020 467.2003-10-07 │ │ │ │ │ -0002dd70: 2031 2e37 2e38 2020 2020 3934 3434 2020 1.7.8 9444 │ │ │ │ │ -0002dd80: 2034 3735 2020 2020 3137 3930 2020 2033 475 1790 3 │ │ │ │ │ -0002dd90: 3034 3120 2833 3929 2020 2031 3636 3020 041 (39) 1660 │ │ │ │ │ -0002dda0: 2832 3929 2020 2039 3020 2020 2034 3638 (29) 90 468 │ │ │ │ │ -0002ddb0: 0a32 3030 332d 3131 2d30 3920 2020 312e .2003-11-09 1. │ │ │ │ │ -0002ddc0: 372e 3920 2020 2039 3434 3420 2020 3437 7.9 9444 47 │ │ │ │ │ -0002ddd0: 3520 2020 2031 3739 3020 2020 3330 3438 5 1790 3048 │ │ │ │ │ -0002dde0: 2028 3339 2920 2020 3136 3630 2028 3239 (39) 1660 (29 │ │ │ │ │ -0002ddf0: 2920 2020 3930 2020 2020 3436 380a 3230 ) 90 468.20 │ │ │ │ │ -0002de00: 3033 2d31 322d 3130 2020 2031 2e38 2020 03-12-10 1.8 │ │ │ │ │ -0002de10: 2020 2020 3731 3731 2020 2035 3835 2020 7171 585 │ │ │ │ │ -0002de20: 2020 3737 3330 2020 2033 3233 3620 2833 7730 3236 (3 │ │ │ │ │ -0002de30: 3929 2020 2031 3636 3620 2833 3129 2020 9) 1666 (31) │ │ │ │ │ -0002de40: 2031 3034 2020 2035 3231 0a32 3030 342d 104 521.2004- │ │ │ │ │ -0002de50: 3031 2d31 3120 2020 312e 382e 3120 2020 01-11 1.8.1 │ │ │ │ │ -0002de60: 2037 3231 3720 2020 3636 3320 2020 2037 7217 663 7 │ │ │ │ │ -0002de70: 3732 3620 2020 3332 3837 2028 3339 2920 726 3287 (39) │ │ │ │ │ -0002de80: 2020 3136 3836 2028 3331 2920 2020 3130 1686 (31) 10 │ │ │ │ │ -0002de90: 3420 2020 3532 350a 3230 3034 2d30 312d 4 525.2004-01- │ │ │ │ │ -0002dea0: 3132 2020 2031 2e38 2e32 2020 2020 3732 12 1.8.2 72 │ │ │ │ │ -0002deb0: 3137 2020 2036 3633 2020 2020 3737 3236 17 663 7726 │ │ │ │ │ -0002dec0: 2020 2033 3238 3820 2833 3929 2020 2031 3288 (39) 1 │ │ │ │ │ -0002ded0: 3638 3620 2833 3129 2020 2031 3034 2020 686 (31) 104 │ │ │ │ │ -0002dee0: 2035 3236 0a32 3030 342d 3033 2d30 3720 526.2004-03-07 │ │ │ │ │ -0002def0: 2020 312e 382e 3320 2020 2037 3231 3420 1.8.3 7214 │ │ │ │ │ -0002df00: 2020 3638 3620 2020 2037 3733 3520 2020 686 7735 │ │ │ │ │ -0002df10: 3333 3033 2028 3339 2920 2020 3136 3935 3303 (39) 1695 │ │ │ │ │ -0002df20: 2028 3331 2920 2020 3131 3120 2020 3533 (31) 111 53 │ │ │ │ │ -0002df30: 300a 3230 3034 2d30 342d 3235 2020 2031 0.2004-04-25 1 │ │ │ │ │ -0002df40: 2e38 2e34 2020 2020 3732 3134 2020 2036 .8.4 7214 6 │ │ │ │ │ -0002df50: 3836 2020 2020 3737 3336 2020 2033 3331 86 7736 331 │ │ │ │ │ -0002df60: 3020 2833 3929 2020 2031 3730 3120 2833 0 (39) 1701 (3 │ │ │ │ │ -0002df70: 3129 2020 2031 3132 2020 2035 3331 0a32 1) 112 531.2 │ │ │ │ │ -0002df80: 3030 342d 3035 2d31 3620 2020 312e 382e 004-05-16 1.8. │ │ │ │ │ -0002df90: 3520 2020 2037 3234 3020 2020 3638 3620 5 7240 686 │ │ │ │ │ -0002dfa0: 2020 2037 3733 3620 2020 3332 3939 2028 7736 3299 ( │ │ │ │ │ -0002dfb0: 3339 2920 2020 3137 3031 2028 3331 2920 39) 1701 (31) │ │ │ │ │ -0002dfc0: 2020 3131 3220 2020 3533 330a 3230 3034 112 533.2004 │ │ │ │ │ -0002dfd0: 2d30 372d 3238 2020 2031 2e39 2020 2020 -07-28 1.9 │ │ │ │ │ -0002dfe0: 2020 3735 3038 2020 2037 3135 2020 2020 7508 715 │ │ │ │ │ -0002dff0: 3737 3934 2020 2033 3335 3220 2834 3029 7794 3352 (40) │ │ │ │ │ -0002e000: 2020 2031 3831 3220 2833 3229 2020 2031 1812 (32) 1 │ │ │ │ │ -0002e010: 3135 2020 2035 3531 0a32 3030 342d 3038 15 551.2004-08 │ │ │ │ │ -0002e020: 2d31 3120 2020 312e 392e 3120 2020 2037 -11 1.9.1 7 │ │ │ │ │ -0002e030: 3531 3220 2020 3731 3520 2020 2037 3739 512 715 779 │ │ │ │ │ -0002e040: 3420 2020 3333 3534 2028 3430 2920 2020 4 3354 (40) │ │ │ │ │ -0002e050: 3138 3132 2028 3332 2920 2020 3131 3520 1812 (32) 115 │ │ │ │ │ -0002e060: 2020 3535 320a 3230 3034 2d30 392d 3139 552.2004-09-19 │ │ │ │ │ -0002e070: 2020 2031 2e39 2e32 2020 2020 3735 3132 1.9.2 7512 │ │ │ │ │ -0002e080: 2020 2037 3135 2020 2020 3737 3934 2020 715 7794 │ │ │ │ │ -0002e090: 2033 3335 3420 2834 3029 2020 2031 3831 3354 (40) 181 │ │ │ │ │ -0002e0a0: 3220 2833 3229 2020 2031 3332 2020 2035 2 (32) 132 5 │ │ │ │ │ -0002e0b0: 3534 0a32 3030 342d 3131 2d30 3120 2020 54.2004-11-01 │ │ │ │ │ -0002e0c0: 312e 392e 3320 2020 2037 3530 3720 2020 1.9.3 7507 │ │ │ │ │ -0002e0d0: 3731 3820 2020 2037 3830 3420 2020 3333 718 7804 33 │ │ │ │ │ -0002e0e0: 3534 2028 3430 2920 2020 3138 3132 2028 54 (40) 1812 ( │ │ │ │ │ -0002e0f0: 3332 2920 2020 3133 3420 2020 3535 360a 32) 134 556. │ │ │ │ │ -0002e100: 3230 3034 2d31 322d 3138 2020 2031 2e39 2004-12-18 1.9 │ │ │ │ │ -0002e110: 2e34 2020 2020 3735 3038 2020 2037 3138 .4 7508 718 │ │ │ │ │ -0002e120: 2020 2020 3738 3536 2020 2033 3336 3120 7856 3361 │ │ │ │ │ -0002e130: 2834 3029 2020 2031 3831 3120 2833 3229 (40) 1811 (32) │ │ │ │ │ -0002e140: 2020 2031 3430 2020 2035 3630 0a32 3030 140 560.200 │ │ │ │ │ -0002e150: 352d 3032 2d31 3320 2020 312e 392e 3520 5-02-13 1.9.5 │ │ │ │ │ -0002e160: 2020 2037 3532 3320 2020 3731 3920 2020 7523 719 │ │ │ │ │ -0002e170: 2037 3835 3920 2020 3333 3733 2028 3430 7859 3373 (40 │ │ │ │ │ -0002e180: 2920 2020 3134 3533 2028 3332 2920 2020 ) 1453 (32) │ │ │ │ │ -0002e190: 3134 3220 2020 3536 320a 3230 3035 2d30 142 562.2005-0 │ │ │ │ │ -0002e1a0: 372d 3130 2020 2031 2e39 2e36 2020 2020 7-10 1.9.6 │ │ │ │ │ -0002e1b0: 3735 3339 2020 2036 3939 2020 2020 3738 7539 699 78 │ │ │ │ │ -0002e1c0: 3637 2020 2033 3430 3020 2834 3029 2020 67 3400 (40) │ │ │ │ │ -0002e1d0: 2031 3435 3320 2833 3229 2020 2031 3434 1453 (32) 144 │ │ │ │ │ -0002e1e0: 2020 2035 3730 0a32 3030 362d 3130 2d31 570.2006-10-1 │ │ │ │ │ -0002e1f0: 3520 2020 312e 3130 2020 2020 2037 3835 5 1.10 785 │ │ │ │ │ -0002e200: 3920 2020 3130 3732 2020 2038 3032 3420 9 1072 8024 │ │ │ │ │ -0002e210: 2020 3335 3132 2028 3430 2920 2020 3134 3512 (40) 14 │ │ │ │ │ -0002e220: 3936 2028 3334 2920 2020 3137 3220 2020 96 (34) 172 │ │ │ │ │ -0002e230: 3630 340a 3230 3038 2d30 312d 3139 2020 604.2008-01-19 │ │ │ │ │ -0002e240: 2031 2e31 302e 3120 2020 3738 3730 2020 1.10.1 7870 │ │ │ │ │ -0002e250: 2031 3038 3920 2020 3830 3235 2020 2033 1089 8025 3 │ │ │ │ │ -0002e260: 3532 3020 2834 3029 2020 2031 3439 3920 520 (40) 1499 │ │ │ │ │ -0002e270: 2833 3429 2020 2031 3733 2020 2036 3137 (34) 173 617 │ │ │ │ │ -0002e280: 0a32 3030 382d 3131 2d32 3320 2020 312e .2008-11-23 1. │ │ │ │ │ -0002e290: 3130 2e32 2020 2037 3838 3220 2020 3130 10.2 7882 10 │ │ │ │ │ -0002e2a0: 3839 2020 2038 3032 3720 2020 3335 3430 89 8027 3540 │ │ │ │ │ -0002e2b0: 2028 3430 2920 2020 3135 3039 2028 3334 (40) 1509 (34 │ │ │ │ │ -0002e2c0: 2920 2020 3137 3620 2020 3632 380a 3230 ) 176 628.20 │ │ │ │ │ -0002e2d0: 3039 2d30 352d 3137 2020 2031 2e31 3120 09-05-17 1.11 │ │ │ │ │ -0002e2e0: 2020 2020 3837 3231 2020 2031 3039 3220 8721 1092 │ │ │ │ │ -0002e2f0: 2020 3832 3839 2020 2034 3136 3420 2834 8289 4164 (4 │ │ │ │ │ -0002e300: 3229 2020 2031 3731 3420 2833 3729 2020 2) 1714 (37) │ │ │ │ │ -0002e310: 2031 3831 2020 2037 3332 2028 3230 290a 181 732 (20). │ │ │ │ │ -0002e320: 3230 3039 2d31 322d 3037 2020 2031 2e31 2009-12-07 1.1 │ │ │ │ │ -0002e330: 302e 3320 2020 3738 3932 2020 2031 3038 0.3 7892 108 │ │ │ │ │ -0002e340: 3920 2020 3830 3237 2020 2033 3536 3620 9 8027 3566 │ │ │ │ │ -0002e350: 2834 3029 2020 2031 3533 3520 2833 3429 (40) 1535 (34) │ │ │ │ │ -0002e360: 2020 2031 3734 2020 2036 3336 0a32 3030 174 636.200 │ │ │ │ │ -0002e370: 392d 3132 2d30 3720 2020 312e 3131 2e31 9-12-07 1.11.1 │ │ │ │ │ -0002e380: 2020 2038 3732 3220 2020 3130 3932 2020 8722 1092 │ │ │ │ │ -0002e390: 2038 3239 3220 2020 3431 3632 2028 3432 8292 4162 (42 │ │ │ │ │ -0002e3a0: 2920 2020 3137 3330 2028 3337 2920 2020 ) 1730 (37) │ │ │ │ │ -0002e3b0: 3138 3120 2020 3733 3920 2832 3029 0a32 181 739 (20).2 │ │ │ │ │ -0002e3c0: 3031 312d 3132 2d32 3120 2020 312e 3131 011-12-21 1.11 │ │ │ │ │ -0002e3d0: 2e32 2020 2038 3832 3220 2020 3131 3132 .2 8822 1112 │ │ │ │ │ -0002e3e0: 2020 2038 3333 3020 2020 3432 3233 2028 8330 4223 ( │ │ │ │ │ -0002e3f0: 3432 2920 2020 3138 3231 2028 3338 2920 42) 1821 (38) │ │ │ │ │ -0002e400: 2020 3138 3920 2020 3931 3520 2832 3229 189 915 (22) │ │ │ │ │ -0002e410: 0a32 3031 322d 3032 2d30 3120 2020 312e .2012-02-01 1. │ │ │ │ │ -0002e420: 3131 2e33 2020 2038 3739 3020 2020 3130 11.3 8790 10 │ │ │ │ │ -0002e430: 3638 2020 2038 3435 3320 2020 3432 3830 68 8453 4280 │ │ │ │ │ -0002e440: 2028 3432 2920 2020 3138 3532 2028 3338 (42) 1852 (38 │ │ │ │ │ -0002e450: 2920 2020 3139 3020 2020 3933 3220 2832 ) 190 932 (2 │ │ │ │ │ -0002e460: 3229 0a0a 1f0a 4669 6c65 3a20 6175 746f 2)....File: auto │ │ │ │ │ -0002e470: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -0002e480: 204e 6f64 653a 2043 6f70 7969 6e67 2054 Node: Copying T │ │ │ │ │ -0002e490: 6869 7320 4d61 6e75 616c 2c20 204e 6578 his Manual, Nex │ │ │ │ │ -0002e4a0: 743a 2049 6e64 6963 6573 2c20 2050 7265 t: Indices, Pre │ │ │ │ │ -0002e4b0: 763a 2048 6973 746f 7279 2c20 2055 703a v: History, Up: │ │ │ │ │ -0002e4c0: 2054 6f70 0a0a 4170 7065 6e64 6978 2041 Top..Appendix A │ │ │ │ │ -0002e4d0: 2043 6f70 7969 6e67 2054 6869 7320 4d61 Copying This Ma │ │ │ │ │ -0002e4e0: 6e75 616c 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a nual.*********** │ │ │ │ │ +0002d530: 2039 3336 2028 3333 2920 2020 2020 2020 936 (33) │ │ │ │ │ +0002d540: 2020 2020 2020 2020 2031 370a 3139 3936 17.1996 │ │ │ │ │ +0002d550: 2d30 322d 3234 2020 2030 2e33 3020 2020 -02-24 0.30 │ │ │ │ │ +0002d560: 2020 3235 3434 2020 2020 2020 2020 2020 2544 │ │ │ │ │ +0002d570: 2020 2020 2020 2039 3139 2028 3332 2920 919 (32) │ │ │ │ │ +0002d580: 2020 2038 3520 2831 2920 2020 2020 2032 85 (1) 2 │ │ │ │ │ +0002d590: 3020 2020 2039 0a31 3939 362d 3033 2d31 0 9.1996-03-1 │ │ │ │ │ +0002d5a0: 3120 2020 302e 3331 2020 2020 2032 3837 1 0.31 287 │ │ │ │ │ +0002d5b0: 3720 2020 2020 2020 2020 2020 2020 2020 7 │ │ │ │ │ +0002d5c0: 2020 3931 3920 2833 3229 2020 2020 3835 919 (32) 85 │ │ │ │ │ +0002d5d0: 2028 3129 2020 2020 2020 3239 2020 2020 (1) 29 │ │ │ │ │ +0002d5e0: 3137 0a31 3939 362d 3034 2d32 3720 2020 17.1996-04-27 │ │ │ │ │ +0002d5f0: 302e 3332 2020 2020 2033 3035 3820 2020 0.32 3058 │ │ │ │ │ +0002d600: 2020 2020 2020 2020 2020 2020 2020 3932 92 │ │ │ │ │ +0002d610: 3120 2833 3129 2020 2020 3835 2028 3129 1 (31) 85 (1) │ │ │ │ │ +0002d620: 2020 2020 2020 3330 2020 2020 3236 0a31 30 26.1 │ │ │ │ │ +0002d630: 3939 362d 3035 2d31 3820 2020 302e 3333 996-05-18 0.33 │ │ │ │ │ +0002d640: 2020 2020 2033 3131 3020 2020 2020 2020 3110 │ │ │ │ │ +0002d650: 2020 2020 2020 2020 2020 3932 3620 2833 926 (3 │ │ │ │ │ +0002d660: 3129 2020 2020 3130 3520 2831 2920 2020 1) 105 (1) │ │ │ │ │ +0002d670: 2020 3330 2020 2020 3335 0a31 3939 362d 30 35.1996- │ │ │ │ │ +0002d680: 3035 2d32 3820 2020 312e 3020 2020 2020 05-28 1.0 │ │ │ │ │ +0002d690: 2033 3133 3420 2020 2020 2020 2020 2020 3134 │ │ │ │ │ +0002d6a0: 2020 2020 2020 3937 3320 2833 3229 2020 973 (32) │ │ │ │ │ +0002d6b0: 2020 3130 3520 2831 2920 2020 2020 3330 105 (1) 30 │ │ │ │ │ +0002d6c0: 2020 2020 3338 0a31 3939 372d 3036 2d32 38.1997-06-2 │ │ │ │ │ +0002d6d0: 3220 2020 312e 3220 2020 2020 2036 3038 2 1.2 608 │ │ │ │ │ +0002d6e0: 3920 2020 3338 3520 2020 2020 2020 2020 9 385 │ │ │ │ │ +0002d6f0: 2020 3132 3934 2028 3336 2920 2020 3539 1294 (36) 59 │ │ │ │ │ +0002d700: 3220 2832 3029 2020 2020 3337 2020 2020 2 (20) 37 │ │ │ │ │ +0002d710: 3132 360a 3139 3938 2d30 342d 3035 2020 126.1998-04-05 │ │ │ │ │ +0002d720: 2031 2e33 2020 2020 2020 3634 3135 2020 1.3 6415 │ │ │ │ │ +0002d730: 2034 3232 2020 2020 2020 2020 2020 2031 422 1 │ │ │ │ │ +0002d740: 3437 3020 2833 3929 2020 2037 3431 2028 470 (39) 741 ( │ │ │ │ │ +0002d750: 3233 2920 2020 2033 3920 2020 2031 3536 23) 39 156 │ │ │ │ │ +0002d760: 0a31 3939 392d 3031 2d31 3420 2020 312e .1999-01-14 1. │ │ │ │ │ +0002d770: 3420 2020 2020 2037 3234 3020 2020 3432 4 7240 42 │ │ │ │ │ +0002d780: 3620 2020 2020 2020 2020 2020 3135 3931 6 1591 │ │ │ │ │ +0002d790: 2028 3430 2920 2020 3733 3420 2832 3029 (40) 734 (20) │ │ │ │ │ +0002d7a0: 2020 2020 3531 2020 2020 3139 370a 3230 51 197.20 │ │ │ │ │ +0002d7b0: 3031 2d30 352d 3038 2020 2031 2e34 2d70 01-05-08 1.4-p │ │ │ │ │ +0002d7c0: 3120 2020 3732 3531 2020 2034 3236 2020 1 7251 426 │ │ │ │ │ +0002d7d0: 2020 2020 2020 2020 2031 3539 3120 2834 1591 (4 │ │ │ │ │ +0002d7e0: 3029 2020 2037 3334 2028 3230 2920 2020 0) 734 (20) │ │ │ │ │ +0002d7f0: 2035 3120 2020 2031 3937 0a32 3030 312d 51 197.2001- │ │ │ │ │ +0002d800: 3035 2d32 3420 2020 312e 342d 7032 2020 05-24 1.4-p2 │ │ │ │ │ +0002d810: 2037 3236 3820 2020 3433 3920 2020 2020 7268 439 │ │ │ │ │ +0002d820: 2020 2020 2020 3135 3931 2028 3430 2920 1591 (40) │ │ │ │ │ +0002d830: 2020 3733 3420 2832 3029 2020 2020 3439 734 (20) 49 │ │ │ │ │ +0002d840: 2020 2020 3139 370a 3230 3031 2d30 362d 197.2001-06- │ │ │ │ │ +0002d850: 3037 2020 2031 2e34 2d70 3320 2020 3733 07 1.4-p3 73 │ │ │ │ │ +0002d860: 3132 2020 2034 3339 2020 2020 2020 2020 12 439 │ │ │ │ │ +0002d870: 2020 2031 3539 3120 2834 3029 2020 2037 1591 (40) 7 │ │ │ │ │ +0002d880: 3334 2028 3230 2920 2020 2034 3920 2020 34 (20) 49 │ │ │ │ │ +0002d890: 2031 3937 0a32 3030 312d 3036 2d31 3020 197.2001-06-10 │ │ │ │ │ +0002d8a0: 2020 312e 342d 7034 2020 2037 3332 3120 1.4-p4 7321 │ │ │ │ │ +0002d8b0: 2020 3433 3920 2020 2020 2020 2020 2020 439 │ │ │ │ │ +0002d8c0: 3135 3931 2028 3430 2920 2020 3733 3420 1591 (40) 734 │ │ │ │ │ +0002d8d0: 2832 3029 2020 2020 3439 2020 2020 3139 (20) 49 19 │ │ │ │ │ +0002d8e0: 380a 3230 3031 2d30 372d 3135 2020 2031 8.2001-07-15 1 │ │ │ │ │ +0002d8f0: 2e34 2d70 3520 2020 3732 3238 2020 2034 .4-p5 7228 4 │ │ │ │ │ +0002d900: 3236 2020 2020 2020 2020 2020 2031 3539 26 159 │ │ │ │ │ +0002d910: 3620 2834 3029 2020 2037 3334 2028 3230 6 (40) 734 (20 │ │ │ │ │ +0002d920: 2920 2020 2035 3120 2020 2031 3938 0a32 ) 51 198.2 │ │ │ │ │ +0002d930: 3030 312d 3038 2d32 3320 2020 312e 3520 001-08-23 1.5 │ │ │ │ │ +0002d940: 2020 2020 2038 3031 3620 2020 3437 3520 8016 475 │ │ │ │ │ +0002d950: 2020 2036 3030 2020 2020 3236 3534 2028 600 2654 ( │ │ │ │ │ +0002d960: 3339 2920 2020 3131 3636 2028 3239 2920 39) 1166 (29) │ │ │ │ │ +0002d970: 2020 3633 2020 2020 3332 370a 3230 3032 63 327.2002 │ │ │ │ │ +0002d980: 2d30 332d 3035 2020 2031 2e36 2020 2020 -03-05 1.6 │ │ │ │ │ +0002d990: 2020 3834 3635 2020 2034 3735 2020 2020 8465 475 │ │ │ │ │ +0002d9a0: 3131 3336 2020 2032 3733 3220 2833 3929 1136 2732 (39) │ │ │ │ │ +0002d9b0: 2020 2031 3630 3320 2832 3729 2020 2036 1603 (27) 6 │ │ │ │ │ +0002d9c0: 3620 2020 2033 3635 0a32 3030 322d 3034 6 365.2002-04 │ │ │ │ │ +0002d9d0: 2d31 3120 2020 312e 362e 3120 2020 2038 -11 1.6.1 8 │ │ │ │ │ +0002d9e0: 3534 3420 2020 3437 3520 2020 2031 3133 544 475 113 │ │ │ │ │ +0002d9f0: 3620 2020 3237 3431 2028 3339 2920 2020 6 2741 (39) │ │ │ │ │ +0002da00: 3136 3033 2028 3237 2920 2020 3636 2020 1603 (27) 66 │ │ │ │ │ +0002da10: 2020 3337 320a 3230 3032 2d30 362d 3134 372.2002-06-14 │ │ │ │ │ +0002da20: 2020 2031 2e36 2e32 2020 2020 3835 3735 1.6.2 8575 │ │ │ │ │ +0002da30: 2020 2034 3735 2020 2020 3131 3336 2020 475 1136 │ │ │ │ │ +0002da40: 2032 3830 3020 2833 3929 2020 2031 3630 2800 (39) 160 │ │ │ │ │ +0002da50: 3920 2832 3729 2020 2036 3720 2020 2033 9 (27) 67 3 │ │ │ │ │ +0002da60: 3836 0a32 3030 322d 3037 2d32 3820 2020 86.2002-07-28 │ │ │ │ │ +0002da70: 312e 362e 3320 2020 2038 3630 3020 2020 1.6.3 8600 │ │ │ │ │ +0002da80: 3437 3520 2020 2031 3135 3320 2020 3238 475 1153 28 │ │ │ │ │ +0002da90: 3039 2028 3339 2920 2020 3136 3039 2028 09 (39) 1609 ( │ │ │ │ │ +0002daa0: 3237 2920 2020 3637 2020 2020 3339 310a 27) 67 391. │ │ │ │ │ +0002dab0: 3230 3032 2d30 372d 3238 2020 2031 2e34 2002-07-28 1.4 │ │ │ │ │ +0002dac0: 2d70 3620 2020 3733 3332 2020 2034 3535 -p6 7332 455 │ │ │ │ │ +0002dad0: 2020 2020 2020 2020 2020 2031 3539 3620 1596 │ │ │ │ │ +0002dae0: 2834 3029 2020 2037 3335 2028 3230 2920 (40) 735 (20) │ │ │ │ │ +0002daf0: 2020 2034 3920 2020 2031 3937 0a32 3030 49 197.200 │ │ │ │ │ +0002db00: 322d 3039 2d32 3520 2020 312e 3720 2020 2-09-25 1.7 │ │ │ │ │ +0002db10: 2020 2039 3138 3920 2020 3437 3120 2020 9189 471 │ │ │ │ │ +0002db20: 2031 3739 3020 2020 3239 3635 2028 3339 1790 2965 (39 │ │ │ │ │ +0002db30: 2920 2020 3136 3036 2028 3238 2920 2020 ) 1606 (28) │ │ │ │ │ +0002db40: 3733 2020 2020 3433 300a 3230 3032 2d31 73 430.2002-1 │ │ │ │ │ +0002db50: 302d 3136 2020 2031 2e37 2e31 2020 2020 0-16 1.7.1 │ │ │ │ │ +0002db60: 3932 3239 2020 2034 3735 2020 2020 3137 9229 475 17 │ │ │ │ │ +0002db70: 3930 2020 2032 3937 3720 2833 3929 2020 90 2977 (39) │ │ │ │ │ +0002db80: 2031 3630 3620 2832 3829 2020 2037 3320 1606 (28) 73 │ │ │ │ │ +0002db90: 2020 2034 3337 0a32 3030 322d 3132 2d30 437.2002-12-0 │ │ │ │ │ +0002dba0: 3620 2020 312e 372e 3220 2020 2039 3333 6 1.7.2 933 │ │ │ │ │ +0002dbb0: 3420 2020 3437 3520 2020 2031 3739 3020 4 475 1790 │ │ │ │ │ +0002dbc0: 2020 3239 3838 2028 3339 2920 2020 3136 2988 (39) 16 │ │ │ │ │ +0002dbd0: 3036 2028 3238 2920 2020 3737 2020 2020 06 (28) 77 │ │ │ │ │ +0002dbe0: 3434 350a 3230 3033 2d30 322d 3230 2020 445.2003-02-20 │ │ │ │ │ +0002dbf0: 2031 2e37 2e33 2020 2020 3933 3839 2020 1.7.3 9389 │ │ │ │ │ +0002dc00: 2034 3735 2020 2020 3137 3930 2020 2033 475 1790 3 │ │ │ │ │ +0002dc10: 3032 3320 2833 3929 2020 2031 3635 3120 023 (39) 1651 │ │ │ │ │ +0002dc20: 2832 3929 2020 2038 3420 2020 2034 3438 (29) 84 448 │ │ │ │ │ +0002dc30: 0a32 3030 332d 3034 2d32 3320 2020 312e .2003-04-23 1. │ │ │ │ │ +0002dc40: 372e 3420 2020 2039 3432 3920 2020 3437 7.4 9429 47 │ │ │ │ │ +0002dc50: 3520 2020 2031 3739 3020 2020 3330 3331 5 1790 3031 │ │ │ │ │ +0002dc60: 2028 3339 2920 2020 3136 3434 2028 3239 (39) 1644 (29 │ │ │ │ │ +0002dc70: 2920 2020 3835 2020 2020 3435 380a 3230 ) 85 458.20 │ │ │ │ │ +0002dc80: 3033 2d30 352d 3138 2020 2031 2e37 2e35 03-05-18 1.7.5 │ │ │ │ │ +0002dc90: 2020 2020 3934 3239 2020 2034 3735 2020 9429 475 │ │ │ │ │ +0002dca0: 2020 3137 3930 2020 2033 3033 3320 2833 1790 3033 (3 │ │ │ │ │ +0002dcb0: 3929 2020 2031 3634 3520 2832 3929 2020 9) 1645 (29) │ │ │ │ │ +0002dcc0: 2038 3520 2020 2034 3539 0a32 3030 332d 85 459.2003- │ │ │ │ │ +0002dcd0: 3037 2d31 3020 2020 312e 372e 3620 2020 07-10 1.7.6 │ │ │ │ │ +0002dce0: 2039 3434 3220 2020 3437 3520 2020 2031 9442 475 1 │ │ │ │ │ +0002dcf0: 3739 3020 2020 3330 3333 2028 3339 2920 790 3033 (39) │ │ │ │ │ +0002dd00: 2020 3136 3630 2028 3239 2920 2020 3835 1660 (29) 85 │ │ │ │ │ +0002dd10: 2020 2020 3436 310a 3230 3033 2d30 392d 461.2003-09- │ │ │ │ │ +0002dd20: 3037 2020 2031 2e37 2e37 2020 2020 3934 07 1.7.7 94 │ │ │ │ │ +0002dd30: 3433 2020 2034 3735 2020 2020 3137 3930 43 475 1790 │ │ │ │ │ +0002dd40: 2020 2033 3034 3120 2833 3929 2020 2031 3041 (39) 1 │ │ │ │ │ +0002dd50: 3636 3020 2832 3929 2020 2039 3020 2020 660 (29) 90 │ │ │ │ │ +0002dd60: 2034 3637 0a32 3030 332d 3130 2d30 3720 467.2003-10-07 │ │ │ │ │ +0002dd70: 2020 312e 372e 3820 2020 2039 3434 3420 1.7.8 9444 │ │ │ │ │ +0002dd80: 2020 3437 3520 2020 2031 3739 3020 2020 475 1790 │ │ │ │ │ +0002dd90: 3330 3431 2028 3339 2920 2020 3136 3630 3041 (39) 1660 │ │ │ │ │ +0002dda0: 2028 3239 2920 2020 3930 2020 2020 3436 (29) 90 46 │ │ │ │ │ +0002ddb0: 380a 3230 3033 2d31 312d 3039 2020 2031 8.2003-11-09 1 │ │ │ │ │ +0002ddc0: 2e37 2e39 2020 2020 3934 3434 2020 2034 .7.9 9444 4 │ │ │ │ │ +0002ddd0: 3735 2020 2020 3137 3930 2020 2033 3034 75 1790 304 │ │ │ │ │ +0002dde0: 3820 2833 3929 2020 2031 3636 3020 2832 8 (39) 1660 (2 │ │ │ │ │ +0002ddf0: 3929 2020 2039 3020 2020 2034 3638 0a32 9) 90 468.2 │ │ │ │ │ +0002de00: 3030 332d 3132 2d31 3020 2020 312e 3820 003-12-10 1.8 │ │ │ │ │ +0002de10: 2020 2020 2037 3137 3120 2020 3538 3520 7171 585 │ │ │ │ │ +0002de20: 2020 2037 3733 3020 2020 3332 3336 2028 7730 3236 ( │ │ │ │ │ +0002de30: 3339 2920 2020 3136 3636 2028 3331 2920 39) 1666 (31) │ │ │ │ │ +0002de40: 2020 3130 3420 2020 3532 310a 3230 3034 104 521.2004 │ │ │ │ │ +0002de50: 2d30 312d 3131 2020 2031 2e38 2e31 2020 -01-11 1.8.1 │ │ │ │ │ +0002de60: 2020 3732 3137 2020 2036 3633 2020 2020 7217 663 │ │ │ │ │ +0002de70: 3737 3236 2020 2033 3238 3720 2833 3929 7726 3287 (39) │ │ │ │ │ +0002de80: 2020 2031 3638 3620 2833 3129 2020 2031 1686 (31) 1 │ │ │ │ │ +0002de90: 3034 2020 2035 3235 0a32 3030 342d 3031 04 525.2004-01 │ │ │ │ │ +0002dea0: 2d31 3220 2020 312e 382e 3220 2020 2037 -12 1.8.2 7 │ │ │ │ │ +0002deb0: 3231 3720 2020 3636 3320 2020 2037 3732 217 663 772 │ │ │ │ │ +0002dec0: 3620 2020 3332 3838 2028 3339 2920 2020 6 3288 (39) │ │ │ │ │ +0002ded0: 3136 3836 2028 3331 2920 2020 3130 3420 1686 (31) 104 │ │ │ │ │ +0002dee0: 2020 3532 360a 3230 3034 2d30 332d 3037 526.2004-03-07 │ │ │ │ │ +0002def0: 2020 2031 2e38 2e33 2020 2020 3732 3134 1.8.3 7214 │ │ │ │ │ +0002df00: 2020 2036 3836 2020 2020 3737 3335 2020 686 7735 │ │ │ │ │ +0002df10: 2033 3330 3320 2833 3929 2020 2031 3639 3303 (39) 169 │ │ │ │ │ +0002df20: 3520 2833 3129 2020 2031 3131 2020 2035 5 (31) 111 5 │ │ │ │ │ +0002df30: 3330 0a32 3030 342d 3034 2d32 3520 2020 30.2004-04-25 │ │ │ │ │ +0002df40: 312e 382e 3420 2020 2037 3231 3420 2020 1.8.4 7214 │ │ │ │ │ +0002df50: 3638 3620 2020 2037 3733 3620 2020 3333 686 7736 33 │ │ │ │ │ +0002df60: 3130 2028 3339 2920 2020 3137 3031 2028 10 (39) 1701 ( │ │ │ │ │ +0002df70: 3331 2920 2020 3131 3220 2020 3533 310a 31) 112 531. │ │ │ │ │ +0002df80: 3230 3034 2d30 352d 3136 2020 2031 2e38 2004-05-16 1.8 │ │ │ │ │ +0002df90: 2e35 2020 2020 3732 3430 2020 2036 3836 .5 7240 686 │ │ │ │ │ +0002dfa0: 2020 2020 3737 3336 2020 2033 3239 3920 7736 3299 │ │ │ │ │ +0002dfb0: 2833 3929 2020 2031 3730 3120 2833 3129 (39) 1701 (31) │ │ │ │ │ +0002dfc0: 2020 2031 3132 2020 2035 3333 0a32 3030 112 533.200 │ │ │ │ │ +0002dfd0: 342d 3037 2d32 3820 2020 312e 3920 2020 4-07-28 1.9 │ │ │ │ │ +0002dfe0: 2020 2037 3530 3820 2020 3731 3520 2020 7508 715 │ │ │ │ │ +0002dff0: 2037 3739 3420 2020 3333 3532 2028 3430 7794 3352 (40 │ │ │ │ │ +0002e000: 2920 2020 3138 3132 2028 3332 2920 2020 ) 1812 (32) │ │ │ │ │ +0002e010: 3131 3520 2020 3535 310a 3230 3034 2d30 115 551.2004-0 │ │ │ │ │ +0002e020: 382d 3131 2020 2031 2e39 2e31 2020 2020 8-11 1.9.1 │ │ │ │ │ +0002e030: 3735 3132 2020 2037 3135 2020 2020 3737 7512 715 77 │ │ │ │ │ +0002e040: 3934 2020 2033 3335 3420 2834 3029 2020 94 3354 (40) │ │ │ │ │ +0002e050: 2031 3831 3220 2833 3229 2020 2031 3135 1812 (32) 115 │ │ │ │ │ +0002e060: 2020 2035 3532 0a32 3030 342d 3039 2d31 552.2004-09-1 │ │ │ │ │ +0002e070: 3920 2020 312e 392e 3220 2020 2037 3531 9 1.9.2 751 │ │ │ │ │ +0002e080: 3220 2020 3731 3520 2020 2037 3739 3420 2 715 7794 │ │ │ │ │ +0002e090: 2020 3333 3534 2028 3430 2920 2020 3138 3354 (40) 18 │ │ │ │ │ +0002e0a0: 3132 2028 3332 2920 2020 3133 3220 2020 12 (32) 132 │ │ │ │ │ +0002e0b0: 3535 340a 3230 3034 2d31 312d 3031 2020 554.2004-11-01 │ │ │ │ │ +0002e0c0: 2031 2e39 2e33 2020 2020 3735 3037 2020 1.9.3 7507 │ │ │ │ │ +0002e0d0: 2037 3138 2020 2020 3738 3034 2020 2033 718 7804 3 │ │ │ │ │ +0002e0e0: 3335 3420 2834 3029 2020 2031 3831 3220 354 (40) 1812 │ │ │ │ │ +0002e0f0: 2833 3229 2020 2031 3334 2020 2035 3536 (32) 134 556 │ │ │ │ │ +0002e100: 0a32 3030 342d 3132 2d31 3820 2020 312e .2004-12-18 1. │ │ │ │ │ +0002e110: 392e 3420 2020 2037 3530 3820 2020 3731 9.4 7508 71 │ │ │ │ │ +0002e120: 3820 2020 2037 3835 3620 2020 3333 3631 8 7856 3361 │ │ │ │ │ +0002e130: 2028 3430 2920 2020 3138 3131 2028 3332 (40) 1811 (32 │ │ │ │ │ +0002e140: 2920 2020 3134 3020 2020 3536 300a 3230 ) 140 560.20 │ │ │ │ │ +0002e150: 3035 2d30 322d 3133 2020 2031 2e39 2e35 05-02-13 1.9.5 │ │ │ │ │ +0002e160: 2020 2020 3735 3233 2020 2037 3139 2020 7523 719 │ │ │ │ │ +0002e170: 2020 3738 3539 2020 2033 3337 3320 2834 7859 3373 (4 │ │ │ │ │ +0002e180: 3029 2020 2031 3435 3320 2833 3229 2020 0) 1453 (32) │ │ │ │ │ +0002e190: 2031 3432 2020 2035 3632 0a32 3030 352d 142 562.2005- │ │ │ │ │ +0002e1a0: 3037 2d31 3020 2020 312e 392e 3620 2020 07-10 1.9.6 │ │ │ │ │ +0002e1b0: 2037 3533 3920 2020 3639 3920 2020 2037 7539 699 7 │ │ │ │ │ +0002e1c0: 3836 3720 2020 3334 3030 2028 3430 2920 867 3400 (40) │ │ │ │ │ +0002e1d0: 2020 3134 3533 2028 3332 2920 2020 3134 1453 (32) 14 │ │ │ │ │ +0002e1e0: 3420 2020 3537 300a 3230 3036 2d31 302d 4 570.2006-10- │ │ │ │ │ +0002e1f0: 3135 2020 2031 2e31 3020 2020 2020 3738 15 1.10 78 │ │ │ │ │ +0002e200: 3539 2020 2031 3037 3220 2020 3830 3234 59 1072 8024 │ │ │ │ │ +0002e210: 2020 2033 3531 3220 2834 3029 2020 2031 3512 (40) 1 │ │ │ │ │ +0002e220: 3439 3620 2833 3429 2020 2031 3732 2020 496 (34) 172 │ │ │ │ │ +0002e230: 2036 3034 0a32 3030 382d 3031 2d31 3920 604.2008-01-19 │ │ │ │ │ +0002e240: 2020 312e 3130 2e31 2020 2037 3837 3020 1.10.1 7870 │ │ │ │ │ +0002e250: 2020 3130 3839 2020 2038 3032 3520 2020 1089 8025 │ │ │ │ │ +0002e260: 3335 3230 2028 3430 2920 2020 3134 3939 3520 (40) 1499 │ │ │ │ │ +0002e270: 2028 3334 2920 2020 3137 3320 2020 3631 (34) 173 61 │ │ │ │ │ +0002e280: 370a 3230 3038 2d31 312d 3233 2020 2031 7.2008-11-23 1 │ │ │ │ │ +0002e290: 2e31 302e 3220 2020 3738 3832 2020 2031 .10.2 7882 1 │ │ │ │ │ +0002e2a0: 3038 3920 2020 3830 3237 2020 2033 3534 089 8027 354 │ │ │ │ │ +0002e2b0: 3020 2834 3029 2020 2031 3530 3920 2833 0 (40) 1509 (3 │ │ │ │ │ +0002e2c0: 3429 2020 2031 3736 2020 2036 3238 0a32 4) 176 628.2 │ │ │ │ │ +0002e2d0: 3030 392d 3035 2d31 3720 2020 312e 3131 009-05-17 1.11 │ │ │ │ │ +0002e2e0: 2020 2020 2038 3732 3120 2020 3130 3932 8721 1092 │ │ │ │ │ +0002e2f0: 2020 2038 3238 3920 2020 3431 3634 2028 8289 4164 ( │ │ │ │ │ +0002e300: 3432 2920 2020 3137 3134 2028 3337 2920 42) 1714 (37) │ │ │ │ │ +0002e310: 2020 3138 3120 2020 3733 3220 2832 3029 181 732 (20) │ │ │ │ │ +0002e320: 0a32 3030 392d 3132 2d30 3720 2020 312e .2009-12-07 1. │ │ │ │ │ +0002e330: 3130 2e33 2020 2037 3839 3220 2020 3130 10.3 7892 10 │ │ │ │ │ +0002e340: 3839 2020 2038 3032 3720 2020 3335 3636 89 8027 3566 │ │ │ │ │ +0002e350: 2028 3430 2920 2020 3135 3335 2028 3334 (40) 1535 (34 │ │ │ │ │ +0002e360: 2920 2020 3137 3420 2020 3633 360a 3230 ) 174 636.20 │ │ │ │ │ +0002e370: 3039 2d31 322d 3037 2020 2031 2e31 312e 09-12-07 1.11. │ │ │ │ │ +0002e380: 3120 2020 3837 3232 2020 2031 3039 3220 1 8722 1092 │ │ │ │ │ +0002e390: 2020 3832 3932 2020 2034 3136 3220 2834 8292 4162 (4 │ │ │ │ │ +0002e3a0: 3229 2020 2031 3733 3020 2833 3729 2020 2) 1730 (37) │ │ │ │ │ +0002e3b0: 2031 3831 2020 2037 3339 2028 3230 290a 181 739 (20). │ │ │ │ │ +0002e3c0: 3230 3131 2d31 322d 3231 2020 2031 2e31 2011-12-21 1.1 │ │ │ │ │ +0002e3d0: 312e 3220 2020 3838 3232 2020 2031 3131 1.2 8822 111 │ │ │ │ │ +0002e3e0: 3220 2020 3833 3330 2020 2034 3232 3320 2 8330 4223 │ │ │ │ │ +0002e3f0: 2834 3229 2020 2031 3832 3120 2833 3829 (42) 1821 (38) │ │ │ │ │ +0002e400: 2020 2031 3839 2020 2039 3135 2028 3232 189 915 (22 │ │ │ │ │ +0002e410: 290a 3230 3132 2d30 322d 3031 2020 2031 ).2012-02-01 1 │ │ │ │ │ +0002e420: 2e31 312e 3320 2020 3837 3930 2020 2031 .11.3 8790 1 │ │ │ │ │ +0002e430: 3036 3820 2020 3834 3533 2020 2034 3238 068 8453 428 │ │ │ │ │ +0002e440: 3020 2834 3229 2020 2031 3835 3220 2833 0 (42) 1852 (3 │ │ │ │ │ +0002e450: 3829 2020 2031 3930 2020 2039 3332 2028 8) 190 932 ( │ │ │ │ │ +0002e460: 3232 290a 0a1f 0a46 696c 653a 2061 7574 22)....File: aut │ │ │ │ │ +0002e470: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +0002e480: 2020 4e6f 6465 3a20 436f 7079 696e 6720 Node: Copying │ │ │ │ │ +0002e490: 5468 6973 204d 616e 7561 6c2c 2020 4e65 This Manual, Ne │ │ │ │ │ +0002e4a0: 7874 3a20 496e 6469 6365 732c 2020 5072 xt: Indices, Pr │ │ │ │ │ +0002e4b0: 6576 3a20 4869 7374 6f72 792c 2020 5570 ev: History, Up │ │ │ │ │ +0002e4c0: 3a20 546f 700a 0a41 7070 656e 6469 7820 : Top..Appendix │ │ │ │ │ +0002e4d0: 4120 436f 7079 696e 6720 5468 6973 204d A Copying This M │ │ │ │ │ +0002e4e0: 616e 7561 6c0a 2a2a 2a2a 2a2a 2a2a 2a2a anual.********** │ │ │ │ │ 0002e4f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0002e500: 2a2a 2a0a 0a2a 204d 656e 753a 0a0a 2a20 ***..* Menu:..* │ │ │ │ │ -0002e510: 474e 5520 4672 6565 2044 6f63 756d 656e GNU Free Documen │ │ │ │ │ -0002e520: 7461 7469 6f6e 204c 6963 656e 7365 3a3a tation License:: │ │ │ │ │ -0002e530: 2020 4c69 6365 6e73 6520 666f 7220 636f License for co │ │ │ │ │ -0002e540: 7079 696e 6720 7468 6973 206d 616e 7561 pying this manua │ │ │ │ │ -0002e550: 6c0a 0a1f 0a46 696c 653a 2061 7574 6f6d l....File: autom │ │ │ │ │ -0002e560: 616b 652d 312e 3131 2e69 6e66 6f2c 2020 ake-1.11.info, │ │ │ │ │ -0002e570: 4e6f 6465 3a20 474e 5520 4672 6565 2044 Node: GNU Free D │ │ │ │ │ -0002e580: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ -0002e590: 656e 7365 2c20 2055 703a 2043 6f70 7969 ense, Up: Copyi │ │ │ │ │ -0002e5a0: 6e67 2054 6869 7320 4d61 6e75 616c 0a0a ng This Manual.. │ │ │ │ │ -0002e5b0: 412e 3120 474e 5520 4672 6565 2044 6f63 A.1 GNU Free Doc │ │ │ │ │ -0002e5c0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ -0002e5d0: 7365 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d se.============= │ │ │ │ │ +0002e500: 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a 0a2a ****..* Menu:..* │ │ │ │ │ +0002e510: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ │ +0002e520: 6e74 6174 696f 6e20 4c69 6365 6e73 653a ntation License: │ │ │ │ │ +0002e530: 3a20 204c 6963 656e 7365 2066 6f72 2063 : License for c │ │ │ │ │ +0002e540: 6f70 7969 6e67 2074 6869 7320 6d61 6e75 opying this manu │ │ │ │ │ +0002e550: 616c 0a0a 1f0a 4669 6c65 3a20 6175 746f al....File: auto │ │ │ │ │ +0002e560: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ +0002e570: 204e 6f64 653a 2047 4e55 2046 7265 6520 Node: GNU Free │ │ │ │ │ +0002e580: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ +0002e590: 6365 6e73 652c 2020 5570 3a20 436f 7079 cense, Up: Copy │ │ │ │ │ +0002e5a0: 696e 6720 5468 6973 204d 616e 7561 6c0a ing This Manual. │ │ │ │ │ +0002e5b0: 0a41 2e31 2047 4e55 2046 7265 6520 446f .A.1 GNU Free Do │ │ │ │ │ +0002e5c0: 6375 6d65 6e74 6174 696f 6e20 4c69 6365 cumentation Lice │ │ │ │ │ +0002e5d0: 6e73 650a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d nse.============ │ │ │ │ │ 0002e5e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0002e5f0: 3d3d 3d3d 3d0a 0a20 2020 2020 2020 2020 =====.. │ │ │ │ │ -0002e600: 2020 2020 2020 2020 2020 2020 5665 7273 Vers │ │ │ │ │ -0002e610: 696f 6e20 312e 332c 2033 204e 6f76 656d ion 1.3, 3 Novem │ │ │ │ │ -0002e620: 6265 7220 3230 3038 0a0a 2020 2020 2043 ber 2008.. C │ │ │ │ │ -0002e630: 6f70 7972 6967 6874 2028 4329 2032 3030 opyright (C) 200 │ │ │ │ │ -0002e640: 302c 2032 3030 312c 2032 3030 322c 2032 0, 2001, 2002, 2 │ │ │ │ │ -0002e650: 3030 372c 2032 3030 3820 4672 6565 2053 007, 2008 Free S │ │ │ │ │ -0002e660: 6f66 7477 6172 6520 466f 756e 6461 7469 oftware Foundati │ │ │ │ │ -0002e670: 6f6e 2c20 496e 632e 0a20 2020 2020 3c68 on, Inc.. . │ │ │ │ │ -0002e690: 0a20 2020 2020 4576 6572 796f 6e65 2069 . Everyone i │ │ │ │ │ -0002e6a0: 7320 7065 726d 6974 7465 6420 746f 2063 s permitted to c │ │ │ │ │ -0002e6b0: 6f70 7920 616e 6420 6469 7374 7269 6275 opy and distribu │ │ │ │ │ -0002e6c0: 7465 2076 6572 6261 7469 6d20 636f 7069 te verbatim copi │ │ │ │ │ -0002e6d0: 6573 0a20 2020 2020 6f66 2074 6869 7320 es. of this │ │ │ │ │ -0002e6e0: 6c69 6365 6e73 6520 646f 6375 6d65 6e74 license document │ │ │ │ │ -0002e6f0: 2c20 6275 7420 6368 616e 6769 6e67 2069 , but changing i │ │ │ │ │ -0002e700: 7420 6973 206e 6f74 2061 6c6c 6f77 6564 t is not allowed │ │ │ │ │ -0002e710: 2e0a 0a20 2030 2e20 5052 4541 4d42 4c45 ... 0. PREAMBLE │ │ │ │ │ -0002e720: 0a0a 2020 2020 2054 6865 2070 7572 706f .. The purpo │ │ │ │ │ -0002e730: 7365 206f 6620 7468 6973 204c 6963 656e se of this Licen │ │ │ │ │ -0002e740: 7365 2069 7320 746f 206d 616b 6520 6120 se is to make a │ │ │ │ │ -0002e750: 6d61 6e75 616c 2c20 7465 7874 626f 6f6b manual, textbook │ │ │ │ │ -0002e760: 2c20 6f72 206f 7468 6572 0a20 2020 2020 , or other. │ │ │ │ │ -0002e770: 6675 6e63 7469 6f6e 616c 2061 6e64 2075 functional and u │ │ │ │ │ -0002e780: 7365 6675 6c20 646f 6375 6d65 6e74 2022 seful document " │ │ │ │ │ -0002e790: 6672 6565 2220 696e 2074 6865 2073 656e free" in the sen │ │ │ │ │ -0002e7a0: 7365 206f 6620 6672 6565 646f 6d3a 2074 se of freedom: t │ │ │ │ │ -0002e7b0: 6f0a 2020 2020 2061 7373 7572 6520 6576 o. assure ev │ │ │ │ │ -0002e7c0: 6572 796f 6e65 2074 6865 2065 6666 6563 eryone the effec │ │ │ │ │ -0002e7d0: 7469 7665 2066 7265 6564 6f6d 2074 6f20 tive freedom to │ │ │ │ │ -0002e7e0: 636f 7079 2061 6e64 2072 6564 6973 7472 copy and redistr │ │ │ │ │ -0002e7f0: 6962 7574 6520 6974 2c0a 2020 2020 2077 ibute it,. w │ │ │ │ │ -0002e800: 6974 6820 6f72 2077 6974 686f 7574 206d ith or without m │ │ │ │ │ -0002e810: 6f64 6966 7969 6e67 2069 742c 2065 6974 odifying it, eit │ │ │ │ │ -0002e820: 6865 7220 636f 6d6d 6572 6369 616c 6c79 her commercially │ │ │ │ │ -0002e830: 206f 720a 2020 2020 206e 6f6e 636f 6d6d or. noncomm │ │ │ │ │ -0002e840: 6572 6369 616c 6c79 2e20 2053 6563 6f6e ercially. Secon │ │ │ │ │ -0002e850: 6461 7269 6c79 2c20 7468 6973 204c 6963 darily, this Lic │ │ │ │ │ -0002e860: 656e 7365 2070 7265 7365 7276 6573 2066 ense preserves f │ │ │ │ │ -0002e870: 6f72 2074 6865 0a20 2020 2020 6175 7468 or the. auth │ │ │ │ │ -0002e880: 6f72 2061 6e64 2070 7562 6c69 7368 6572 or and publisher │ │ │ │ │ -0002e890: 2061 2077 6179 2074 6f20 6765 7420 6372 a way to get cr │ │ │ │ │ -0002e8a0: 6564 6974 2066 6f72 2074 6865 6972 2077 edit for their w │ │ │ │ │ -0002e8b0: 6f72 6b2c 2077 6869 6c65 206e 6f74 0a20 ork, while not. │ │ │ │ │ -0002e8c0: 2020 2020 6265 696e 6720 636f 6e73 6964 being consid │ │ │ │ │ -0002e8d0: 6572 6564 2072 6573 706f 6e73 6962 6c65 ered responsible │ │ │ │ │ -0002e8e0: 2066 6f72 206d 6f64 6966 6963 6174 696f for modificatio │ │ │ │ │ -0002e8f0: 6e73 206d 6164 6520 6279 206f 7468 6572 ns made by other │ │ │ │ │ -0002e900: 732e 0a0a 2020 2020 2054 6869 7320 4c69 s... This Li │ │ │ │ │ -0002e910: 6365 6e73 6520 6973 2061 206b 696e 6420 cense is a kind │ │ │ │ │ -0002e920: 6f66 2022 636f 7079 6c65 6674 222c 2077 of "copyleft", w │ │ │ │ │ -0002e930: 6869 6368 206d 6561 6e73 2074 6861 7420 hich means that │ │ │ │ │ -0002e940: 6465 7269 7661 7469 7665 0a20 2020 2020 derivative. │ │ │ │ │ -0002e950: 776f 726b 7320 6f66 2074 6865 2064 6f63 works of the doc │ │ │ │ │ -0002e960: 756d 656e 7420 6d75 7374 2074 6865 6d73 ument must thems │ │ │ │ │ -0002e970: 656c 7665 7320 6265 2066 7265 6520 696e elves be free in │ │ │ │ │ -0002e980: 2074 6865 2073 616d 6520 7365 6e73 652e the same sense. │ │ │ │ │ -0002e990: 0a20 2020 2020 4974 2063 6f6d 706c 656d . It complem │ │ │ │ │ -0002e9a0: 656e 7473 2074 6865 2047 4e55 2047 656e ents the GNU Gen │ │ │ │ │ -0002e9b0: 6572 616c 2050 7562 6c69 6320 4c69 6365 eral Public Lice │ │ │ │ │ -0002e9c0: 6e73 652c 2077 6869 6368 2069 7320 6120 nse, which is a │ │ │ │ │ -0002e9d0: 636f 7079 6c65 6674 0a20 2020 2020 6c69 copyleft. li │ │ │ │ │ -0002e9e0: 6365 6e73 6520 6465 7369 676e 6564 2066 cense designed f │ │ │ │ │ -0002e9f0: 6f72 2066 7265 6520 736f 6674 7761 7265 or free software │ │ │ │ │ -0002ea00: 2e0a 0a20 2020 2020 5765 2068 6176 6520 ... We have │ │ │ │ │ -0002ea10: 6465 7369 676e 6564 2074 6869 7320 4c69 designed this Li │ │ │ │ │ -0002ea20: 6365 6e73 6520 696e 206f 7264 6572 2074 cense in order t │ │ │ │ │ -0002ea30: 6f20 7573 6520 6974 2066 6f72 206d 616e o use it for man │ │ │ │ │ -0002ea40: 7561 6c73 2066 6f72 0a20 2020 2020 6672 uals for. fr │ │ │ │ │ -0002ea50: 6565 2073 6f66 7477 6172 652c 2062 6563 ee software, bec │ │ │ │ │ -0002ea60: 6175 7365 2066 7265 6520 736f 6674 7761 ause free softwa │ │ │ │ │ -0002ea70: 7265 206e 6565 6473 2066 7265 6520 646f re needs free do │ │ │ │ │ -0002ea80: 6375 6d65 6e74 6174 696f 6e3a 2061 0a20 cumentation: a. │ │ │ │ │ -0002ea90: 2020 2020 6672 6565 2070 726f 6772 616d free program │ │ │ │ │ -0002eaa0: 2073 686f 756c 6420 636f 6d65 2077 6974 should come wit │ │ │ │ │ -0002eab0: 6820 6d61 6e75 616c 7320 7072 6f76 6964 h manuals provid │ │ │ │ │ -0002eac0: 696e 6720 7468 6520 7361 6d65 2066 7265 ing the same fre │ │ │ │ │ -0002ead0: 6564 6f6d 730a 2020 2020 2074 6861 7420 edoms. that │ │ │ │ │ -0002eae0: 7468 6520 736f 6674 7761 7265 2064 6f65 the software doe │ │ │ │ │ -0002eaf0: 732e 2020 4275 7420 7468 6973 204c 6963 s. But this Lic │ │ │ │ │ -0002eb00: 656e 7365 2069 7320 6e6f 7420 6c69 6d69 ense is not limi │ │ │ │ │ -0002eb10: 7465 6420 746f 0a20 2020 2020 736f 6674 ted to. soft │ │ │ │ │ -0002eb20: 7761 7265 206d 616e 7561 6c73 3b20 6974 ware manuals; it │ │ │ │ │ -0002eb30: 2063 616e 2062 6520 7573 6564 2066 6f72 can be used for │ │ │ │ │ -0002eb40: 2061 6e79 2074 6578 7475 616c 2077 6f72 any textual wor │ │ │ │ │ -0002eb50: 6b2c 2072 6567 6172 646c 6573 730a 2020 k, regardless. │ │ │ │ │ -0002eb60: 2020 206f 6620 7375 626a 6563 7420 6d61 of subject ma │ │ │ │ │ -0002eb70: 7474 6572 206f 7220 7768 6574 6865 7220 tter or whether │ │ │ │ │ -0002eb80: 6974 2069 7320 7075 626c 6973 6865 6420 it is published │ │ │ │ │ -0002eb90: 6173 2061 2070 7269 6e74 6564 2062 6f6f as a printed boo │ │ │ │ │ -0002eba0: 6b2e 2020 5765 0a20 2020 2020 7265 636f k. We. reco │ │ │ │ │ -0002ebb0: 6d6d 656e 6420 7468 6973 204c 6963 656e mmend this Licen │ │ │ │ │ -0002ebc0: 7365 2070 7269 6e63 6970 616c 6c79 2066 se principally f │ │ │ │ │ -0002ebd0: 6f72 2077 6f72 6b73 2077 686f 7365 2070 or works whose p │ │ │ │ │ -0002ebe0: 7572 706f 7365 2069 730a 2020 2020 2069 urpose is. i │ │ │ │ │ -0002ebf0: 6e73 7472 7563 7469 6f6e 206f 7220 7265 nstruction or re │ │ │ │ │ -0002ec00: 6665 7265 6e63 652e 0a0a 2020 312e 2041 ference... 1. A │ │ │ │ │ -0002ec10: 5050 4c49 4341 4249 4c49 5459 2041 4e44 PPLICABILITY AND │ │ │ │ │ -0002ec20: 2044 4546 494e 4954 494f 4e53 0a0a 2020 DEFINITIONS.. │ │ │ │ │ -0002ec30: 2020 2054 6869 7320 4c69 6365 6e73 6520 This License │ │ │ │ │ -0002ec40: 6170 706c 6965 7320 746f 2061 6e79 206d applies to any m │ │ │ │ │ -0002ec50: 616e 7561 6c20 6f72 206f 7468 6572 2077 anual or other w │ │ │ │ │ -0002ec60: 6f72 6b2c 2069 6e20 616e 7920 6d65 6469 ork, in any medi │ │ │ │ │ -0002ec70: 756d 2c0a 2020 2020 2074 6861 7420 636f um,. that co │ │ │ │ │ -0002ec80: 6e74 6169 6e73 2061 206e 6f74 6963 6520 ntains a notice │ │ │ │ │ -0002ec90: 706c 6163 6564 2062 7920 7468 6520 636f placed by the co │ │ │ │ │ -0002eca0: 7079 7269 6768 7420 686f 6c64 6572 2073 pyright holder s │ │ │ │ │ -0002ecb0: 6179 696e 6720 6974 2063 616e 0a20 2020 aying it can. │ │ │ │ │ -0002ecc0: 2020 6265 2064 6973 7472 6962 7574 6564 be distributed │ │ │ │ │ -0002ecd0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ -0002ece0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ -0002ecf0: 2e20 2053 7563 6820 6120 6e6f 7469 6365 . Such a notice │ │ │ │ │ -0002ed00: 0a20 2020 2020 6772 616e 7473 2061 2077 . grants a w │ │ │ │ │ -0002ed10: 6f72 6c64 2d77 6964 652c 2072 6f79 616c orld-wide, royal │ │ │ │ │ -0002ed20: 7479 2d66 7265 6520 6c69 6365 6e73 652c ty-free license, │ │ │ │ │ -0002ed30: 2075 6e6c 696d 6974 6564 2069 6e20 6475 unlimited in du │ │ │ │ │ -0002ed40: 7261 7469 6f6e 2c0a 2020 2020 2074 6f20 ration,. to │ │ │ │ │ -0002ed50: 7573 6520 7468 6174 2077 6f72 6b20 756e use that work un │ │ │ │ │ -0002ed60: 6465 7220 7468 6520 636f 6e64 6974 696f der the conditio │ │ │ │ │ -0002ed70: 6e73 2073 7461 7465 6420 6865 7265 696e ns stated herein │ │ │ │ │ -0002ed80: 2e20 2054 6865 0a20 2020 2020 2244 6f63 . The. "Doc │ │ │ │ │ -0002ed90: 756d 656e 7422 2c20 6265 6c6f 772c 2072 ument", below, r │ │ │ │ │ -0002eda0: 6566 6572 7320 746f 2061 6e79 2073 7563 efers to any suc │ │ │ │ │ -0002edb0: 6820 6d61 6e75 616c 206f 7220 776f 726b h manual or work │ │ │ │ │ -0002edc0: 2e20 2041 6e79 206d 656d 6265 720a 2020 . Any member. │ │ │ │ │ -0002edd0: 2020 206f 6620 7468 6520 7075 626c 6963 of the public │ │ │ │ │ -0002ede0: 2069 7320 6120 6c69 6365 6e73 6565 2c20 is a licensee, │ │ │ │ │ -0002edf0: 616e 6420 6973 2061 6464 7265 7373 6564 and is addressed │ │ │ │ │ -0002ee00: 2061 7320 2279 6f75 222e 2020 596f 7520 as "you". You │ │ │ │ │ -0002ee10: 6163 6365 7074 0a20 2020 2020 7468 6520 accept. the │ │ │ │ │ -0002ee20: 6c69 6365 6e73 6520 6966 2079 6f75 2063 license if you c │ │ │ │ │ -0002ee30: 6f70 792c 206d 6f64 6966 7920 6f72 2064 opy, modify or d │ │ │ │ │ -0002ee40: 6973 7472 6962 7574 6520 7468 6520 776f istribute the wo │ │ │ │ │ -0002ee50: 726b 2069 6e20 6120 7761 790a 2020 2020 rk in a way. │ │ │ │ │ -0002ee60: 2072 6571 7569 7269 6e67 2070 6572 6d69 requiring permi │ │ │ │ │ -0002ee70: 7373 696f 6e20 756e 6465 7220 636f 7079 ssion under copy │ │ │ │ │ -0002ee80: 7269 6768 7420 6c61 772e 0a0a 2020 2020 right law... │ │ │ │ │ -0002ee90: 2041 2022 4d6f 6469 6669 6564 2056 6572 A "Modified Ver │ │ │ │ │ -0002eea0: 7369 6f6e 2220 6f66 2074 6865 2044 6f63 sion" of the Doc │ │ │ │ │ -0002eeb0: 756d 656e 7420 6d65 616e 7320 616e 7920 ument means any │ │ │ │ │ -0002eec0: 776f 726b 2063 6f6e 7461 696e 696e 6720 work containing │ │ │ │ │ -0002eed0: 7468 650a 2020 2020 2044 6f63 756d 656e the. Documen │ │ │ │ │ -0002eee0: 7420 6f72 2061 2070 6f72 7469 6f6e 206f t or a portion o │ │ │ │ │ -0002eef0: 6620 6974 2c20 6569 7468 6572 2063 6f70 f it, either cop │ │ │ │ │ -0002ef00: 6965 6420 7665 7262 6174 696d 2c20 6f72 ied verbatim, or │ │ │ │ │ -0002ef10: 2077 6974 680a 2020 2020 206d 6f64 6966 with. modif │ │ │ │ │ -0002ef20: 6963 6174 696f 6e73 2061 6e64 2f6f 7220 ications and/or │ │ │ │ │ -0002ef30: 7472 616e 736c 6174 6564 2069 6e74 6f20 translated into │ │ │ │ │ -0002ef40: 616e 6f74 6865 7220 6c61 6e67 7561 6765 another language │ │ │ │ │ -0002ef50: 2e0a 0a20 2020 2020 4120 2253 6563 6f6e ... A "Secon │ │ │ │ │ -0002ef60: 6461 7279 2053 6563 7469 6f6e 2220 6973 dary Section" is │ │ │ │ │ -0002ef70: 2061 206e 616d 6564 2061 7070 656e 6469 a named appendi │ │ │ │ │ -0002ef80: 7820 6f72 2061 2066 726f 6e74 2d6d 6174 x or a front-mat │ │ │ │ │ -0002ef90: 7465 7220 7365 6374 696f 6e0a 2020 2020 ter section. │ │ │ │ │ -0002efa0: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -0002efb0: 2074 6861 7420 6465 616c 7320 6578 636c that deals excl │ │ │ │ │ -0002efc0: 7573 6976 656c 7920 7769 7468 2074 6865 usively with the │ │ │ │ │ -0002efd0: 2072 656c 6174 696f 6e73 6869 7020 6f66 relationship of │ │ │ │ │ -0002efe0: 2074 6865 0a20 2020 2020 7075 626c 6973 the. publis │ │ │ │ │ -0002eff0: 6865 7273 206f 7220 6175 7468 6f72 7320 hers or authors │ │ │ │ │ -0002f000: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ │ -0002f010: 746f 2074 6865 2044 6f63 756d 656e 7427 to the Document' │ │ │ │ │ -0002f020: 7320 6f76 6572 616c 6c0a 2020 2020 2073 s overall. s │ │ │ │ │ -0002f030: 7562 6a65 6374 2028 6f72 2074 6f20 7265 ubject (or to re │ │ │ │ │ -0002f040: 6c61 7465 6420 6d61 7474 6572 7329 2061 lated matters) a │ │ │ │ │ -0002f050: 6e64 2063 6f6e 7461 696e 7320 6e6f 7468 nd contains noth │ │ │ │ │ -0002f060: 696e 6720 7468 6174 2063 6f75 6c64 0a20 ing that could. │ │ │ │ │ -0002f070: 2020 2020 6661 6c6c 2064 6972 6563 746c fall directl │ │ │ │ │ -0002f080: 7920 7769 7468 696e 2074 6861 7420 6f76 y within that ov │ │ │ │ │ -0002f090: 6572 616c 6c20 7375 626a 6563 742e 2020 erall subject. │ │ │ │ │ -0002f0a0: 2854 6875 732c 2069 6620 7468 6520 446f (Thus, if the Do │ │ │ │ │ -0002f0b0: 6375 6d65 6e74 0a20 2020 2020 6973 2069 cument. is i │ │ │ │ │ -0002f0c0: 6e20 7061 7274 2061 2074 6578 7462 6f6f n part a textboo │ │ │ │ │ -0002f0d0: 6b20 6f66 206d 6174 6865 6d61 7469 6373 k of mathematics │ │ │ │ │ -0002f0e0: 2c20 6120 5365 636f 6e64 6172 7920 5365 , a Secondary Se │ │ │ │ │ -0002f0f0: 6374 696f 6e20 6d61 7920 6e6f 740a 2020 ction may not. │ │ │ │ │ -0002f100: 2020 2065 7870 6c61 696e 2061 6e79 206d explain any m │ │ │ │ │ -0002f110: 6174 6865 6d61 7469 6373 2e29 2020 5468 athematics.) Th │ │ │ │ │ -0002f120: 6520 7265 6c61 7469 6f6e 7368 6970 2063 e relationship c │ │ │ │ │ -0002f130: 6f75 6c64 2062 6520 6120 6d61 7474 6572 ould be a matter │ │ │ │ │ -0002f140: 206f 660a 2020 2020 2068 6973 746f 7269 of. histori │ │ │ │ │ -0002f150: 6361 6c20 636f 6e6e 6563 7469 6f6e 2077 cal connection w │ │ │ │ │ -0002f160: 6974 6820 7468 6520 7375 626a 6563 7420 ith the subject │ │ │ │ │ -0002f170: 6f72 2077 6974 6820 7265 6c61 7465 6420 or with related │ │ │ │ │ -0002f180: 6d61 7474 6572 732c 206f 720a 2020 2020 matters, or. │ │ │ │ │ -0002f190: 206f 6620 6c65 6761 6c2c 2063 6f6d 6d65 of legal, comme │ │ │ │ │ -0002f1a0: 7263 6961 6c2c 2070 6869 6c6f 736f 7068 rcial, philosoph │ │ │ │ │ -0002f1b0: 6963 616c 2c20 6574 6869 6361 6c20 6f72 ical, ethical or │ │ │ │ │ -0002f1c0: 2070 6f6c 6974 6963 616c 2070 6f73 6974 political posit │ │ │ │ │ -0002f1d0: 696f 6e0a 2020 2020 2072 6567 6172 6469 ion. regardi │ │ │ │ │ -0002f1e0: 6e67 2074 6865 6d2e 0a0a 2020 2020 2054 ng them... T │ │ │ │ │ -0002f1f0: 6865 2022 496e 7661 7269 616e 7420 5365 he "Invariant Se │ │ │ │ │ -0002f200: 6374 696f 6e73 2220 6172 6520 6365 7274 ctions" are cert │ │ │ │ │ -0002f210: 6169 6e20 5365 636f 6e64 6172 7920 5365 ain Secondary Se │ │ │ │ │ -0002f220: 6374 696f 6e73 2077 686f 7365 0a20 2020 ctions whose. │ │ │ │ │ -0002f230: 2020 7469 746c 6573 2061 7265 2064 6573 titles are des │ │ │ │ │ -0002f240: 6967 6e61 7465 642c 2061 7320 6265 696e ignated, as bein │ │ │ │ │ -0002f250: 6720 7468 6f73 6520 6f66 2049 6e76 6172 g those of Invar │ │ │ │ │ -0002f260: 6961 6e74 2053 6563 7469 6f6e 732c 2069 iant Sections, i │ │ │ │ │ -0002f270: 6e20 7468 650a 2020 2020 206e 6f74 6963 n the. notic │ │ │ │ │ -0002f280: 6520 7468 6174 2073 6179 7320 7468 6174 e that says that │ │ │ │ │ -0002f290: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ │ -0002f2a0: 2072 656c 6561 7365 6420 756e 6465 7220 released under │ │ │ │ │ -0002f2b0: 7468 6973 204c 6963 656e 7365 2e0a 2020 this License.. │ │ │ │ │ -0002f2c0: 2020 2049 6620 6120 7365 6374 696f 6e20 If a section │ │ │ │ │ -0002f2d0: 646f 6573 206e 6f74 2066 6974 2074 6865 does not fit the │ │ │ │ │ -0002f2e0: 2061 626f 7665 2064 6566 696e 6974 696f above definitio │ │ │ │ │ -0002f2f0: 6e20 6f66 2053 6563 6f6e 6461 7279 2074 n of Secondary t │ │ │ │ │ -0002f300: 6865 6e20 6974 0a20 2020 2020 6973 206e hen it. is n │ │ │ │ │ -0002f310: 6f74 2061 6c6c 6f77 6564 2074 6f20 6265 ot allowed to be │ │ │ │ │ -0002f320: 2064 6573 6967 6e61 7465 6420 6173 2049 designated as I │ │ │ │ │ -0002f330: 6e76 6172 6961 6e74 2e20 2054 6865 2044 nvariant. The D │ │ │ │ │ -0002f340: 6f63 756d 656e 7420 6d61 790a 2020 2020 ocument may. │ │ │ │ │ -0002f350: 2063 6f6e 7461 696e 207a 6572 6f20 496e contain zero In │ │ │ │ │ -0002f360: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -0002f370: 2e20 2049 6620 7468 6520 446f 6375 6d65 . If the Docume │ │ │ │ │ -0002f380: 6e74 2064 6f65 7320 6e6f 7420 6964 656e nt does not iden │ │ │ │ │ -0002f390: 7469 6679 0a20 2020 2020 616e 7920 496e tify. any In │ │ │ │ │ -0002f3a0: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -0002f3b0: 2074 6865 6e20 7468 6572 6520 6172 6520 then there are │ │ │ │ │ -0002f3c0: 6e6f 6e65 2e0a 0a20 2020 2020 5468 6520 none... The │ │ │ │ │ -0002f3d0: 2243 6f76 6572 2054 6578 7473 2220 6172 "Cover Texts" ar │ │ │ │ │ -0002f3e0: 6520 6365 7274 6169 6e20 7368 6f72 7420 e certain short │ │ │ │ │ -0002f3f0: 7061 7373 6167 6573 206f 6620 7465 7874 passages of text │ │ │ │ │ -0002f400: 2074 6861 7420 6172 650a 2020 2020 206c that are. l │ │ │ │ │ -0002f410: 6973 7465 642c 2061 7320 4672 6f6e 742d isted, as Front- │ │ │ │ │ -0002f420: 436f 7665 7220 5465 7874 7320 6f72 2042 Cover Texts or B │ │ │ │ │ -0002f430: 6163 6b2d 436f 7665 7220 5465 7874 732c ack-Cover Texts, │ │ │ │ │ -0002f440: 2069 6e20 7468 6520 6e6f 7469 6365 0a20 in the notice. │ │ │ │ │ -0002f450: 2020 2020 7468 6174 2073 6179 7320 7468 that says th │ │ │ │ │ -0002f460: 6174 2074 6865 2044 6f63 756d 656e 7420 at the Document │ │ │ │ │ -0002f470: 6973 2072 656c 6561 7365 6420 756e 6465 is released unde │ │ │ │ │ -0002f480: 7220 7468 6973 204c 6963 656e 7365 2e20 r this License. │ │ │ │ │ -0002f490: 2041 0a20 2020 2020 4672 6f6e 742d 436f A. Front-Co │ │ │ │ │ -0002f4a0: 7665 7220 5465 7874 206d 6179 2062 6520 ver Text may be │ │ │ │ │ -0002f4b0: 6174 206d 6f73 7420 3520 776f 7264 732c at most 5 words, │ │ │ │ │ -0002f4c0: 2061 6e64 2061 2042 6163 6b2d 436f 7665 and a Back-Cove │ │ │ │ │ -0002f4d0: 7220 5465 7874 206d 6179 0a20 2020 2020 r Text may. │ │ │ │ │ -0002f4e0: 6265 2061 7420 6d6f 7374 2032 3520 776f be at most 25 wo │ │ │ │ │ -0002f4f0: 7264 732e 0a0a 2020 2020 2041 2022 5472 rds... A "Tr │ │ │ │ │ -0002f500: 616e 7370 6172 656e 7422 2063 6f70 7920 ansparent" copy │ │ │ │ │ -0002f510: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ │ -0002f520: 6d65 616e 7320 6120 6d61 6368 696e 652d means a machine- │ │ │ │ │ -0002f530: 7265 6164 6162 6c65 2063 6f70 792c 0a20 readable copy,. │ │ │ │ │ -0002f540: 2020 2020 7265 7072 6573 656e 7465 6420 represented │ │ │ │ │ -0002f550: 696e 2061 2066 6f72 6d61 7420 7768 6f73 in a format whos │ │ │ │ │ -0002f560: 6520 7370 6563 6966 6963 6174 696f 6e20 e specification │ │ │ │ │ -0002f570: 6973 2061 7661 696c 6162 6c65 2074 6f20 is available to │ │ │ │ │ -0002f580: 7468 650a 2020 2020 2067 656e 6572 616c the. general │ │ │ │ │ -0002f590: 2070 7562 6c69 632c 2074 6861 7420 6973 public, that is │ │ │ │ │ -0002f5a0: 2073 7569 7461 626c 6520 666f 7220 7265 suitable for re │ │ │ │ │ -0002f5b0: 7669 7369 6e67 2074 6865 2064 6f63 756d vising the docum │ │ │ │ │ -0002f5c0: 656e 740a 2020 2020 2073 7472 6169 6768 ent. straigh │ │ │ │ │ -0002f5d0: 7466 6f72 7761 7264 6c79 2077 6974 6820 tforwardly with │ │ │ │ │ -0002f5e0: 6765 6e65 7269 6320 7465 7874 2065 6469 generic text edi │ │ │ │ │ -0002f5f0: 746f 7273 206f 7220 2866 6f72 2069 6d61 tors or (for ima │ │ │ │ │ -0002f600: 6765 7320 636f 6d70 6f73 6564 0a20 2020 ges composed. │ │ │ │ │ -0002f610: 2020 6f66 2070 6978 656c 7329 2067 656e of pixels) gen │ │ │ │ │ -0002f620: 6572 6963 2070 6169 6e74 2070 726f 6772 eric paint progr │ │ │ │ │ -0002f630: 616d 7320 6f72 2028 666f 7220 6472 6177 ams or (for draw │ │ │ │ │ -0002f640: 696e 6773 2920 736f 6d65 2077 6964 656c ings) some widel │ │ │ │ │ -0002f650: 790a 2020 2020 2061 7661 696c 6162 6c65 y. available │ │ │ │ │ -0002f660: 2064 7261 7769 6e67 2065 6469 746f 722c drawing editor, │ │ │ │ │ -0002f670: 2061 6e64 2074 6861 7420 6973 2073 7569 and that is sui │ │ │ │ │ -0002f680: 7461 626c 6520 666f 7220 696e 7075 7420 table for input │ │ │ │ │ -0002f690: 746f 2074 6578 740a 2020 2020 2066 6f72 to text. for │ │ │ │ │ -0002f6a0: 6d61 7474 6572 7320 6f72 2066 6f72 2061 matters or for a │ │ │ │ │ -0002f6b0: 7574 6f6d 6174 6963 2074 7261 6e73 6c61 utomatic transla │ │ │ │ │ -0002f6c0: 7469 6f6e 2074 6f20 6120 7661 7269 6574 tion to a variet │ │ │ │ │ -0002f6d0: 7920 6f66 2066 6f72 6d61 7473 0a20 2020 y of formats. │ │ │ │ │ -0002f6e0: 2020 7375 6974 6162 6c65 2066 6f72 2069 suitable for i │ │ │ │ │ -0002f6f0: 6e70 7574 2074 6f20 7465 7874 2066 6f72 nput to text for │ │ │ │ │ -0002f700: 6d61 7474 6572 732e 2020 4120 636f 7079 matters. A copy │ │ │ │ │ -0002f710: 206d 6164 6520 696e 2061 6e20 6f74 6865 made in an othe │ │ │ │ │ -0002f720: 7277 6973 650a 2020 2020 2054 7261 6e73 rwise. Trans │ │ │ │ │ -0002f730: 7061 7265 6e74 2066 696c 6520 666f 726d parent file form │ │ │ │ │ -0002f740: 6174 2077 686f 7365 206d 6172 6b75 702c at whose markup, │ │ │ │ │ -0002f750: 206f 7220 6162 7365 6e63 6520 6f66 206d or absence of m │ │ │ │ │ -0002f760: 6172 6b75 702c 2068 6173 0a20 2020 2020 arkup, has. │ │ │ │ │ -0002f770: 6265 656e 2061 7272 616e 6765 6420 746f been arranged to │ │ │ │ │ -0002f780: 2074 6877 6172 7420 6f72 2064 6973 636f thwart or disco │ │ │ │ │ -0002f790: 7572 6167 6520 7375 6273 6571 7565 6e74 urage subsequent │ │ │ │ │ -0002f7a0: 206d 6f64 6966 6963 6174 696f 6e20 6279 modification by │ │ │ │ │ -0002f7b0: 0a20 2020 2020 7265 6164 6572 7320 6973 . readers is │ │ │ │ │ -0002f7c0: 206e 6f74 2054 7261 6e73 7061 7265 6e74 not Transparent │ │ │ │ │ -0002f7d0: 2e20 2041 6e20 696d 6167 6520 666f 726d . An image form │ │ │ │ │ -0002f7e0: 6174 2069 7320 6e6f 7420 5472 616e 7370 at is not Transp │ │ │ │ │ -0002f7f0: 6172 656e 7420 6966 0a20 2020 2020 7573 arent if. us │ │ │ │ │ -0002f800: 6564 2066 6f72 2061 6e79 2073 7562 7374 ed for any subst │ │ │ │ │ -0002f810: 616e 7469 616c 2061 6d6f 756e 7420 6f66 antial amount of │ │ │ │ │ -0002f820: 2074 6578 742e 2020 4120 636f 7079 2074 text. A copy t │ │ │ │ │ -0002f830: 6861 7420 6973 206e 6f74 0a20 2020 2020 hat is not. │ │ │ │ │ -0002f840: 2254 7261 6e73 7061 7265 6e74 2220 6973 "Transparent" is │ │ │ │ │ -0002f850: 2063 616c 6c65 6420 224f 7061 7175 6522 called "Opaque" │ │ │ │ │ -0002f860: 2e0a 0a20 2020 2020 4578 616d 706c 6573 ... Examples │ │ │ │ │ -0002f870: 206f 6620 7375 6974 6162 6c65 2066 6f72 of suitable for │ │ │ │ │ -0002f880: 6d61 7473 2066 6f72 2054 7261 6e73 7061 mats for Transpa │ │ │ │ │ -0002f890: 7265 6e74 2063 6f70 6965 7320 696e 636c rent copies incl │ │ │ │ │ -0002f8a0: 7564 6520 706c 6169 6e0a 2020 2020 2041 ude plain. A │ │ │ │ │ -0002f8b0: 5343 4949 2077 6974 686f 7574 206d 6172 SCII without mar │ │ │ │ │ -0002f8c0: 6b75 702c 2054 6578 696e 666f 2069 6e70 kup, Texinfo inp │ │ │ │ │ -0002f8d0: 7574 2066 6f72 6d61 742c 204c 6154 6558 ut format, LaTeX │ │ │ │ │ -0002f8e0: 2069 6e70 7574 2066 6f72 6d61 742c 0a20 input format,. │ │ │ │ │ -0002f8f0: 2020 2020 5347 4d4c 206f 7220 584d 4c20 SGML or XML │ │ │ │ │ -0002f900: 7573 696e 6720 6120 7075 626c 6963 6c79 using a publicly │ │ │ │ │ -0002f910: 2061 7661 696c 6162 6c65 2044 5444 2c20 available DTD, │ │ │ │ │ -0002f920: 616e 6420 7374 616e 6461 7264 2d63 6f6e and standard-con │ │ │ │ │ -0002f930: 666f 726d 696e 670a 2020 2020 2073 696d forming. sim │ │ │ │ │ -0002f940: 706c 6520 4854 4d4c 2c20 506f 7374 5363 ple HTML, PostSc │ │ │ │ │ -0002f950: 7269 7074 206f 7220 5044 4620 6465 7369 ript or PDF desi │ │ │ │ │ -0002f960: 676e 6564 2066 6f72 2068 756d 616e 206d gned for human m │ │ │ │ │ -0002f970: 6f64 6966 6963 6174 696f 6e2e 0a20 2020 odification.. │ │ │ │ │ -0002f980: 2020 4578 616d 706c 6573 206f 6620 7472 Examples of tr │ │ │ │ │ -0002f990: 616e 7370 6172 656e 7420 696d 6167 6520 ansparent image │ │ │ │ │ -0002f9a0: 666f 726d 6174 7320 696e 636c 7564 6520 formats include │ │ │ │ │ -0002f9b0: 504e 472c 2058 4346 2061 6e64 204a 5047 PNG, XCF and JPG │ │ │ │ │ -0002f9c0: 2e0a 2020 2020 204f 7061 7175 6520 666f .. Opaque fo │ │ │ │ │ -0002f9d0: 726d 6174 7320 696e 636c 7564 6520 7072 rmats include pr │ │ │ │ │ -0002f9e0: 6f70 7269 6574 6172 7920 666f 726d 6174 oprietary format │ │ │ │ │ -0002f9f0: 7320 7468 6174 2063 616e 2062 6520 7265 s that can be re │ │ │ │ │ -0002fa00: 6164 2061 6e64 0a20 2020 2020 6564 6974 ad and. edit │ │ │ │ │ -0002fa10: 6564 206f 6e6c 7920 6279 2070 726f 7072 ed only by propr │ │ │ │ │ -0002fa20: 6965 7461 7279 2077 6f72 6420 7072 6f63 ietary word proc │ │ │ │ │ -0002fa30: 6573 736f 7273 2c20 5347 4d4c 206f 7220 essors, SGML or │ │ │ │ │ -0002fa40: 584d 4c20 666f 7220 7768 6963 680a 2020 XML for which. │ │ │ │ │ -0002fa50: 2020 2074 6865 2044 5444 2061 6e64 2f6f the DTD and/o │ │ │ │ │ -0002fa60: 7220 7072 6f63 6573 7369 6e67 2074 6f6f r processing too │ │ │ │ │ -0002fa70: 6c73 2061 7265 206e 6f74 2067 656e 6572 ls are not gener │ │ │ │ │ -0002fa80: 616c 6c79 2061 7661 696c 6162 6c65 2c20 ally available, │ │ │ │ │ -0002fa90: 616e 640a 2020 2020 2074 6865 206d 6163 and. the mac │ │ │ │ │ -0002faa0: 6869 6e65 2d67 656e 6572 6174 6564 2048 hine-generated H │ │ │ │ │ -0002fab0: 544d 4c2c 2050 6f73 7453 6372 6970 7420 TML, PostScript │ │ │ │ │ -0002fac0: 6f72 2050 4446 2070 726f 6475 6365 6420 or PDF produced │ │ │ │ │ -0002fad0: 6279 2073 6f6d 6520 776f 7264 0a20 2020 by some word. │ │ │ │ │ -0002fae0: 2020 7072 6f63 6573 736f 7273 2066 6f72 processors for │ │ │ │ │ -0002faf0: 206f 7574 7075 7420 7075 7270 6f73 6573 output purposes │ │ │ │ │ -0002fb00: 206f 6e6c 792e 0a0a 2020 2020 2054 6865 only... The │ │ │ │ │ -0002fb10: 2022 5469 746c 6520 5061 6765 2220 6d65 "Title Page" me │ │ │ │ │ -0002fb20: 616e 732c 2066 6f72 2061 2070 7269 6e74 ans, for a print │ │ │ │ │ -0002fb30: 6564 2062 6f6f 6b2c 2074 6865 2074 6974 ed book, the tit │ │ │ │ │ -0002fb40: 6c65 2070 6167 6520 6974 7365 6c66 2c0a le page itself,. │ │ │ │ │ -0002fb50: 2020 2020 2070 6c75 7320 7375 6368 2066 plus such f │ │ │ │ │ -0002fb60: 6f6c 6c6f 7769 6e67 2070 6167 6573 2061 ollowing pages a │ │ │ │ │ -0002fb70: 7320 6172 6520 6e65 6564 6564 2074 6f20 s are needed to │ │ │ │ │ -0002fb80: 686f 6c64 2c20 6c65 6769 626c 792c 2074 hold, legibly, t │ │ │ │ │ -0002fb90: 6865 0a20 2020 2020 6d61 7465 7269 616c he. material │ │ │ │ │ -0002fba0: 2074 6869 7320 4c69 6365 6e73 6520 7265 this License re │ │ │ │ │ -0002fbb0: 7175 6972 6573 2074 6f20 6170 7065 6172 quires to appear │ │ │ │ │ -0002fbc0: 2069 6e20 7468 6520 7469 746c 6520 7061 in the title pa │ │ │ │ │ -0002fbd0: 6765 2e20 2046 6f72 0a20 2020 2020 776f ge. For. wo │ │ │ │ │ -0002fbe0: 726b 7320 696e 2066 6f72 6d61 7473 2077 rks in formats w │ │ │ │ │ -0002fbf0: 6869 6368 2064 6f20 6e6f 7420 6861 7665 hich do not have │ │ │ │ │ -0002fc00: 2061 6e79 2074 6974 6c65 2070 6167 6520 any title page │ │ │ │ │ -0002fc10: 6173 2073 7563 682c 2022 5469 746c 650a as such, "Title. │ │ │ │ │ -0002fc20: 2020 2020 2050 6167 6522 206d 6561 6e73 Page" means │ │ │ │ │ -0002fc30: 2074 6865 2074 6578 7420 6e65 6172 2074 the text near t │ │ │ │ │ -0002fc40: 6865 206d 6f73 7420 7072 6f6d 696e 656e he most prominen │ │ │ │ │ -0002fc50: 7420 6170 7065 6172 616e 6365 206f 6620 t appearance of │ │ │ │ │ -0002fc60: 7468 650a 2020 2020 2077 6f72 6b27 7320 the. work's │ │ │ │ │ -0002fc70: 7469 746c 652c 2070 7265 6365 6469 6e67 title, preceding │ │ │ │ │ -0002fc80: 2074 6865 2062 6567 696e 6e69 6e67 206f the beginning o │ │ │ │ │ -0002fc90: 6620 7468 6520 626f 6479 206f 6620 7468 f the body of th │ │ │ │ │ -0002fca0: 6520 7465 7874 2e0a 0a20 2020 2020 5468 e text... Th │ │ │ │ │ -0002fcb0: 6520 2270 7562 6c69 7368 6572 2220 6d65 e "publisher" me │ │ │ │ │ -0002fcc0: 616e 7320 616e 7920 7065 7273 6f6e 206f ans any person o │ │ │ │ │ -0002fcd0: 7220 656e 7469 7479 2074 6861 7420 6469 r entity that di │ │ │ │ │ -0002fce0: 7374 7269 6275 7465 7320 636f 7069 6573 stributes copies │ │ │ │ │ -0002fcf0: 0a20 2020 2020 6f66 2074 6865 2044 6f63 . of the Doc │ │ │ │ │ -0002fd00: 756d 656e 7420 746f 2074 6865 2070 7562 ument to the pub │ │ │ │ │ -0002fd10: 6c69 632e 0a0a 2020 2020 2041 2073 6563 lic... A sec │ │ │ │ │ -0002fd20: 7469 6f6e 2022 456e 7469 746c 6564 2058 tion "Entitled X │ │ │ │ │ -0002fd30: 595a 2220 6d65 616e 7320 6120 6e61 6d65 YZ" means a name │ │ │ │ │ -0002fd40: 6420 7375 6275 6e69 7420 6f66 2074 6865 d subunit of the │ │ │ │ │ -0002fd50: 2044 6f63 756d 656e 740a 2020 2020 2077 Document. w │ │ │ │ │ -0002fd60: 686f 7365 2074 6974 6c65 2065 6974 6865 hose title eithe │ │ │ │ │ -0002fd70: 7220 6973 2070 7265 6369 7365 6c79 2058 r is precisely X │ │ │ │ │ -0002fd80: 595a 206f 7220 636f 6e74 6169 6e73 2058 YZ or contains X │ │ │ │ │ -0002fd90: 595a 2069 6e20 7061 7265 6e74 6865 7365 YZ in parenthese │ │ │ │ │ -0002fda0: 730a 2020 2020 2066 6f6c 6c6f 7769 6e67 s. following │ │ │ │ │ -0002fdb0: 2074 6578 7420 7468 6174 2074 7261 6e73 text that trans │ │ │ │ │ -0002fdc0: 6c61 7465 7320 5859 5a20 696e 2061 6e6f lates XYZ in ano │ │ │ │ │ -0002fdd0: 7468 6572 206c 616e 6775 6167 652e 2020 ther language. │ │ │ │ │ -0002fde0: 2848 6572 6520 5859 5a0a 2020 2020 2073 (Here XYZ. s │ │ │ │ │ -0002fdf0: 7461 6e64 7320 666f 7220 6120 7370 6563 tands for a spec │ │ │ │ │ -0002fe00: 6966 6963 2073 6563 7469 6f6e 206e 616d ific section nam │ │ │ │ │ -0002fe10: 6520 6d65 6e74 696f 6e65 6420 6265 6c6f e mentioned belo │ │ │ │ │ -0002fe20: 772c 2073 7563 6820 6173 0a20 2020 2020 w, such as. │ │ │ │ │ -0002fe30: 2241 636b 6e6f 776c 6564 6765 6d65 6e74 "Acknowledgement │ │ │ │ │ -0002fe40: 7322 2c20 2244 6564 6963 6174 696f 6e73 s", "Dedications │ │ │ │ │ -0002fe50: 222c 2022 456e 646f 7273 656d 656e 7473 ", "Endorsements │ │ │ │ │ -0002fe60: 222c 206f 7220 2248 6973 746f 7279 222e ", or "History". │ │ │ │ │ -0002fe70: 290a 2020 2020 2054 6f20 2250 7265 7365 ). To "Prese │ │ │ │ │ -0002fe80: 7276 6520 7468 6520 5469 746c 6522 206f rve the Title" o │ │ │ │ │ -0002fe90: 6620 7375 6368 2061 2073 6563 7469 6f6e f such a section │ │ │ │ │ -0002fea0: 2077 6865 6e20 796f 7520 6d6f 6469 6679 when you modify │ │ │ │ │ -0002feb0: 2074 6865 0a20 2020 2020 446f 6375 6d65 the. Docume │ │ │ │ │ -0002fec0: 6e74 206d 6561 6e73 2074 6861 7420 6974 nt means that it │ │ │ │ │ -0002fed0: 2072 656d 6169 6e73 2061 2073 6563 7469 remains a secti │ │ │ │ │ -0002fee0: 6f6e 2022 456e 7469 746c 6564 2058 595a on "Entitled XYZ │ │ │ │ │ -0002fef0: 2220 6163 636f 7264 696e 670a 2020 2020 " according. │ │ │ │ │ -0002ff00: 2074 6f20 7468 6973 2064 6566 696e 6974 to this definit │ │ │ │ │ -0002ff10: 696f 6e2e 0a0a 2020 2020 2054 6865 2044 ion... The D │ │ │ │ │ -0002ff20: 6f63 756d 656e 7420 6d61 7920 696e 636c ocument may incl │ │ │ │ │ -0002ff30: 7564 6520 5761 7272 616e 7479 2044 6973 ude Warranty Dis │ │ │ │ │ -0002ff40: 636c 6169 6d65 7273 206e 6578 7420 746f claimers next to │ │ │ │ │ -0002ff50: 2074 6865 206e 6f74 6963 650a 2020 2020 the notice. │ │ │ │ │ -0002ff60: 2077 6869 6368 2073 7461 7465 7320 7468 which states th │ │ │ │ │ -0002ff70: 6174 2074 6869 7320 4c69 6365 6e73 6520 at this License │ │ │ │ │ -0002ff80: 6170 706c 6965 7320 746f 2074 6865 2044 applies to the D │ │ │ │ │ -0002ff90: 6f63 756d 656e 742e 2020 5468 6573 650a ocument. These. │ │ │ │ │ -0002ffa0: 2020 2020 2057 6172 7261 6e74 7920 4469 Warranty Di │ │ │ │ │ -0002ffb0: 7363 6c61 696d 6572 7320 6172 6520 636f sclaimers are co │ │ │ │ │ -0002ffc0: 6e73 6964 6572 6564 2074 6f20 6265 2069 nsidered to be i │ │ │ │ │ -0002ffd0: 6e63 6c75 6465 6420 6279 2072 6566 6572 ncluded by refer │ │ │ │ │ -0002ffe0: 656e 6365 2069 6e0a 2020 2020 2074 6869 ence in. thi │ │ │ │ │ -0002fff0: 7320 4c69 6365 6e73 652c 2062 7574 206f s License, but o │ │ │ │ │ -00030000: 6e6c 7920 6173 2072 6567 6172 6473 2064 nly as regards d │ │ │ │ │ -00030010: 6973 636c 6169 6d69 6e67 2077 6172 7261 isclaiming warra │ │ │ │ │ -00030020: 6e74 6965 733a 2061 6e79 206f 7468 6572 nties: any other │ │ │ │ │ -00030030: 0a20 2020 2020 696d 706c 6963 6174 696f . implicatio │ │ │ │ │ -00030040: 6e20 7468 6174 2074 6865 7365 2057 6172 n that these War │ │ │ │ │ -00030050: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ │ -00030060: 7320 6d61 7920 6861 7665 2069 7320 766f s may have is vo │ │ │ │ │ -00030070: 6964 2061 6e64 0a20 2020 2020 6861 7320 id and. has │ │ │ │ │ -00030080: 6e6f 2065 6666 6563 7420 6f6e 2074 6865 no effect on the │ │ │ │ │ -00030090: 206d 6561 6e69 6e67 206f 6620 7468 6973 meaning of this │ │ │ │ │ -000300a0: 204c 6963 656e 7365 2e0a 0a20 2032 2e20 License... 2. │ │ │ │ │ -000300b0: 5645 5242 4154 494d 2043 4f50 5949 4e47 VERBATIM COPYING │ │ │ │ │ -000300c0: 0a0a 2020 2020 2059 6f75 206d 6179 2063 .. You may c │ │ │ │ │ -000300d0: 6f70 7920 616e 6420 6469 7374 7269 6275 opy and distribu │ │ │ │ │ -000300e0: 7465 2074 6865 2044 6f63 756d 656e 7420 te the Document │ │ │ │ │ -000300f0: 696e 2061 6e79 206d 6564 6975 6d2c 2065 in any medium, e │ │ │ │ │ -00030100: 6974 6865 720a 2020 2020 2063 6f6d 6d65 ither. comme │ │ │ │ │ -00030110: 7263 6961 6c6c 7920 6f72 206e 6f6e 636f rcially or nonco │ │ │ │ │ -00030120: 6d6d 6572 6369 616c 6c79 2c20 7072 6f76 mmercially, prov │ │ │ │ │ -00030130: 6964 6564 2074 6861 7420 7468 6973 204c ided that this L │ │ │ │ │ -00030140: 6963 656e 7365 2c20 7468 650a 2020 2020 icense, the. │ │ │ │ │ -00030150: 2063 6f70 7972 6967 6874 206e 6f74 6963 copyright notic │ │ │ │ │ -00030160: 6573 2c20 616e 6420 7468 6520 6c69 6365 es, and the lice │ │ │ │ │ -00030170: 6e73 6520 6e6f 7469 6365 2073 6179 696e nse notice sayin │ │ │ │ │ -00030180: 6720 7468 6973 204c 6963 656e 7365 0a20 g this License. │ │ │ │ │ -00030190: 2020 2020 6170 706c 6965 7320 746f 2074 applies to t │ │ │ │ │ -000301a0: 6865 2044 6f63 756d 656e 7420 6172 6520 he Document are │ │ │ │ │ -000301b0: 7265 7072 6f64 7563 6564 2069 6e20 616c reproduced in al │ │ │ │ │ -000301c0: 6c20 636f 7069 6573 2c20 616e 6420 7468 l copies, and th │ │ │ │ │ -000301d0: 6174 2079 6f75 0a20 2020 2020 6164 6420 at you. add │ │ │ │ │ -000301e0: 6e6f 206f 7468 6572 2063 6f6e 6469 7469 no other conditi │ │ │ │ │ -000301f0: 6f6e 7320 7768 6174 736f 6576 6572 2074 ons whatsoever t │ │ │ │ │ -00030200: 6f20 7468 6f73 6520 6f66 2074 6869 7320 o those of this │ │ │ │ │ -00030210: 4c69 6365 6e73 652e 2020 596f 750a 2020 License. You. │ │ │ │ │ -00030220: 2020 206d 6179 206e 6f74 2075 7365 2074 may not use t │ │ │ │ │ -00030230: 6563 686e 6963 616c 206d 6561 7375 7265 echnical measure │ │ │ │ │ -00030240: 7320 746f 206f 6273 7472 7563 7420 6f72 s to obstruct or │ │ │ │ │ -00030250: 2063 6f6e 7472 6f6c 2074 6865 2072 6561 control the rea │ │ │ │ │ -00030260: 6469 6e67 0a20 2020 2020 6f72 2066 7572 ding. or fur │ │ │ │ │ -00030270: 7468 6572 2063 6f70 7969 6e67 206f 6620 ther copying of │ │ │ │ │ -00030280: 7468 6520 636f 7069 6573 2079 6f75 206d the copies you m │ │ │ │ │ -00030290: 616b 6520 6f72 2064 6973 7472 6962 7574 ake or distribut │ │ │ │ │ -000302a0: 652e 2020 486f 7765 7665 722c 0a20 2020 e. However,. │ │ │ │ │ -000302b0: 2020 796f 7520 6d61 7920 6163 6365 7074 you may accept │ │ │ │ │ -000302c0: 2063 6f6d 7065 6e73 6174 696f 6e20 696e compensation in │ │ │ │ │ -000302d0: 2065 7863 6861 6e67 6520 666f 7220 636f exchange for co │ │ │ │ │ -000302e0: 7069 6573 2e20 2049 6620 796f 750a 2020 pies. If you. │ │ │ │ │ -000302f0: 2020 2064 6973 7472 6962 7574 6520 6120 distribute a │ │ │ │ │ -00030300: 6c61 7267 6520 656e 6f75 6768 206e 756d large enough num │ │ │ │ │ -00030310: 6265 7220 6f66 2063 6f70 6965 7320 796f ber of copies yo │ │ │ │ │ -00030320: 7520 6d75 7374 2061 6c73 6f20 666f 6c6c u must also foll │ │ │ │ │ -00030330: 6f77 2074 6865 0a20 2020 2020 636f 6e64 ow the. cond │ │ │ │ │ -00030340: 6974 696f 6e73 2069 6e20 7365 6374 696f itions in sectio │ │ │ │ │ -00030350: 6e20 332e 0a0a 2020 2020 2059 6f75 206d n 3... You m │ │ │ │ │ -00030360: 6179 2061 6c73 6f20 6c65 6e64 2063 6f70 ay also lend cop │ │ │ │ │ -00030370: 6965 732c 2075 6e64 6572 2074 6865 2073 ies, under the s │ │ │ │ │ -00030380: 616d 6520 636f 6e64 6974 696f 6e73 2073 ame conditions s │ │ │ │ │ -00030390: 7461 7465 6420 6162 6f76 652c 0a20 2020 tated above,. │ │ │ │ │ -000303a0: 2020 616e 6420 796f 7520 6d61 7920 7075 and you may pu │ │ │ │ │ -000303b0: 626c 6963 6c79 2064 6973 706c 6179 2063 blicly display c │ │ │ │ │ -000303c0: 6f70 6965 732e 0a0a 2020 332e 2043 4f50 opies... 3. COP │ │ │ │ │ -000303d0: 5949 4e47 2049 4e20 5155 414e 5449 5459 YING IN QUANTITY │ │ │ │ │ -000303e0: 0a0a 2020 2020 2049 6620 796f 7520 7075 .. If you pu │ │ │ │ │ -000303f0: 626c 6973 6820 7072 696e 7465 6420 636f blish printed co │ │ │ │ │ -00030400: 7069 6573 2028 6f72 2063 6f70 6965 7320 pies (or copies │ │ │ │ │ -00030410: 696e 206d 6564 6961 2074 6861 7420 636f in media that co │ │ │ │ │ -00030420: 6d6d 6f6e 6c79 0a20 2020 2020 6861 7665 mmonly. have │ │ │ │ │ -00030430: 2070 7269 6e74 6564 2063 6f76 6572 7329 printed covers) │ │ │ │ │ -00030440: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -00030450: 2c20 6e75 6d62 6572 696e 6720 6d6f 7265 , numbering more │ │ │ │ │ -00030460: 2074 6861 6e20 3130 302c 2061 6e64 0a20 than 100, and. │ │ │ │ │ -00030470: 2020 2020 7468 6520 446f 6375 6d65 6e74 the Document │ │ │ │ │ -00030480: 2773 206c 6963 656e 7365 206e 6f74 6963 's license notic │ │ │ │ │ -00030490: 6520 7265 7175 6972 6573 2043 6f76 6572 e requires Cover │ │ │ │ │ -000304a0: 2054 6578 7473 2c20 796f 7520 6d75 7374 Texts, you must │ │ │ │ │ -000304b0: 0a20 2020 2020 656e 636c 6f73 6520 7468 . enclose th │ │ │ │ │ -000304c0: 6520 636f 7069 6573 2069 6e20 636f 7665 e copies in cove │ │ │ │ │ -000304d0: 7273 2074 6861 7420 6361 7272 792c 2063 rs that carry, c │ │ │ │ │ -000304e0: 6c65 6172 6c79 2061 6e64 206c 6567 6962 learly and legib │ │ │ │ │ -000304f0: 6c79 2c20 616c 6c0a 2020 2020 2074 6865 ly, all. the │ │ │ │ │ -00030500: 7365 2043 6f76 6572 2054 6578 7473 3a20 se Cover Texts: │ │ │ │ │ -00030510: 4672 6f6e 742d 436f 7665 7220 5465 7874 Front-Cover Text │ │ │ │ │ -00030520: 7320 6f6e 2074 6865 2066 726f 6e74 2063 s on the front c │ │ │ │ │ -00030530: 6f76 6572 2c20 616e 640a 2020 2020 2042 over, and. B │ │ │ │ │ -00030540: 6163 6b2d 436f 7665 7220 5465 7874 7320 ack-Cover Texts │ │ │ │ │ -00030550: 6f6e 2074 6865 2062 6163 6b20 636f 7665 on the back cove │ │ │ │ │ -00030560: 722e 2020 426f 7468 2063 6f76 6572 7320 r. Both covers │ │ │ │ │ -00030570: 6d75 7374 2061 6c73 6f20 636c 6561 726c must also clearl │ │ │ │ │ -00030580: 790a 2020 2020 2061 6e64 206c 6567 6962 y. and legib │ │ │ │ │ -00030590: 6c79 2069 6465 6e74 6966 7920 796f 7520 ly identify you │ │ │ │ │ -000305a0: 6173 2074 6865 2070 7562 6c69 7368 6572 as the publisher │ │ │ │ │ -000305b0: 206f 6620 7468 6573 6520 636f 7069 6573 of these copies │ │ │ │ │ -000305c0: 2e20 2054 6865 0a20 2020 2020 6672 6f6e . The. fron │ │ │ │ │ -000305d0: 7420 636f 7665 7220 6d75 7374 2070 7265 t cover must pre │ │ │ │ │ -000305e0: 7365 6e74 2074 6865 2066 756c 6c20 7469 sent the full ti │ │ │ │ │ -000305f0: 746c 6520 7769 7468 2061 6c6c 2077 6f72 tle with all wor │ │ │ │ │ -00030600: 6473 206f 6620 7468 6520 7469 746c 650a ds of the title. │ │ │ │ │ -00030610: 2020 2020 2065 7175 616c 6c79 2070 726f equally pro │ │ │ │ │ -00030620: 6d69 6e65 6e74 2061 6e64 2076 6973 6962 minent and visib │ │ │ │ │ -00030630: 6c65 2e20 2059 6f75 206d 6179 2061 6464 le. You may add │ │ │ │ │ -00030640: 206f 7468 6572 206d 6174 6572 6961 6c20 other material │ │ │ │ │ -00030650: 6f6e 2074 6865 0a20 2020 2020 636f 7665 on the. cove │ │ │ │ │ -00030660: 7273 2069 6e20 6164 6469 7469 6f6e 2e20 rs in addition. │ │ │ │ │ -00030670: 2043 6f70 7969 6e67 2077 6974 6820 6368 Copying with ch │ │ │ │ │ -00030680: 616e 6765 7320 6c69 6d69 7465 6420 746f anges limited to │ │ │ │ │ -00030690: 2074 6865 2063 6f76 6572 732c 2061 730a the covers, as. │ │ │ │ │ -000306a0: 2020 2020 206c 6f6e 6720 6173 2074 6865 long as the │ │ │ │ │ -000306b0: 7920 7072 6573 6572 7665 2074 6865 2074 y preserve the t │ │ │ │ │ -000306c0: 6974 6c65 206f 6620 7468 6520 446f 6375 itle of the Docu │ │ │ │ │ -000306d0: 6d65 6e74 2061 6e64 2073 6174 6973 6679 ment and satisfy │ │ │ │ │ -000306e0: 2074 6865 7365 0a20 2020 2020 636f 6e64 these. cond │ │ │ │ │ -000306f0: 6974 696f 6e73 2c20 6361 6e20 6265 2074 itions, can be t │ │ │ │ │ -00030700: 7265 6174 6564 2061 7320 7665 7262 6174 reated as verbat │ │ │ │ │ -00030710: 696d 2063 6f70 7969 6e67 2069 6e20 6f74 im copying in ot │ │ │ │ │ -00030720: 6865 7220 7265 7370 6563 7473 2e0a 0a20 her respects... │ │ │ │ │ -00030730: 2020 2020 4966 2074 6865 2072 6571 7569 If the requi │ │ │ │ │ -00030740: 7265 6420 7465 7874 7320 666f 7220 6569 red texts for ei │ │ │ │ │ -00030750: 7468 6572 2063 6f76 6572 2061 7265 2074 ther cover are t │ │ │ │ │ -00030760: 6f6f 2076 6f6c 756d 696e 6f75 7320 746f oo voluminous to │ │ │ │ │ -00030770: 2066 6974 0a20 2020 2020 6c65 6769 626c fit. legibl │ │ │ │ │ -00030780: 792c 2079 6f75 2073 686f 756c 6420 7075 y, you should pu │ │ │ │ │ -00030790: 7420 7468 6520 6669 7273 7420 6f6e 6573 t the first ones │ │ │ │ │ -000307a0: 206c 6973 7465 6420 2861 7320 6d61 6e79 listed (as many │ │ │ │ │ -000307b0: 2061 7320 6669 740a 2020 2020 2072 6561 as fit. rea │ │ │ │ │ -000307c0: 736f 6e61 626c 7929 206f 6e20 7468 6520 sonably) on the │ │ │ │ │ -000307d0: 6163 7475 616c 2063 6f76 6572 2c20 616e actual cover, an │ │ │ │ │ -000307e0: 6420 636f 6e74 696e 7565 2074 6865 2072 d continue the r │ │ │ │ │ -000307f0: 6573 7420 6f6e 746f 0a20 2020 2020 6164 est onto. ad │ │ │ │ │ -00030800: 6a61 6365 6e74 2070 6167 6573 2e0a 0a20 jacent pages... │ │ │ │ │ -00030810: 2020 2020 4966 2079 6f75 2070 7562 6c69 If you publi │ │ │ │ │ -00030820: 7368 206f 7220 6469 7374 7269 6275 7465 sh or distribute │ │ │ │ │ -00030830: 204f 7061 7175 6520 636f 7069 6573 206f Opaque copies o │ │ │ │ │ -00030840: 6620 7468 6520 446f 6375 6d65 6e74 0a20 f the Document. │ │ │ │ │ -00030850: 2020 2020 6e75 6d62 6572 696e 6720 6d6f numbering mo │ │ │ │ │ -00030860: 7265 2074 6861 6e20 3130 302c 2079 6f75 re than 100, you │ │ │ │ │ -00030870: 206d 7573 7420 6569 7468 6572 2069 6e63 must either inc │ │ │ │ │ -00030880: 6c75 6465 2061 206d 6163 6869 6e65 2d72 lude a machine-r │ │ │ │ │ -00030890: 6561 6461 626c 650a 2020 2020 2054 7261 eadable. Tra │ │ │ │ │ -000308a0: 6e73 7061 7265 6e74 2063 6f70 7920 616c nsparent copy al │ │ │ │ │ -000308b0: 6f6e 6720 7769 7468 2065 6163 6820 4f70 ong with each Op │ │ │ │ │ -000308c0: 6171 7565 2063 6f70 792c 206f 7220 7374 aque copy, or st │ │ │ │ │ -000308d0: 6174 6520 696e 206f 7220 7769 7468 0a20 ate in or with. │ │ │ │ │ -000308e0: 2020 2020 6561 6368 204f 7061 7175 6520 each Opaque │ │ │ │ │ -000308f0: 636f 7079 2061 2063 6f6d 7075 7465 722d copy a computer- │ │ │ │ │ -00030900: 6e65 7477 6f72 6b20 6c6f 6361 7469 6f6e network location │ │ │ │ │ -00030910: 2066 726f 6d20 7768 6963 6820 7468 6520 from which the │ │ │ │ │ -00030920: 6765 6e65 7261 6c0a 2020 2020 206e 6574 general. net │ │ │ │ │ -00030930: 776f 726b 2d75 7369 6e67 2070 7562 6c69 work-using publi │ │ │ │ │ -00030940: 6320 6861 7320 6163 6365 7373 2074 6f20 c has access to │ │ │ │ │ -00030950: 646f 776e 6c6f 6164 2075 7369 6e67 2070 download using p │ │ │ │ │ -00030960: 7562 6c69 632d 7374 616e 6461 7264 0a20 ublic-standard. │ │ │ │ │ -00030970: 2020 2020 6e65 7477 6f72 6b20 7072 6f74 network prot │ │ │ │ │ -00030980: 6f63 6f6c 7320 6120 636f 6d70 6c65 7465 ocols a complete │ │ │ │ │ -00030990: 2054 7261 6e73 7061 7265 6e74 2063 6f70 Transparent cop │ │ │ │ │ -000309a0: 7920 6f66 2074 6865 2044 6f63 756d 656e y of the Documen │ │ │ │ │ -000309b0: 742c 2066 7265 650a 2020 2020 206f 6620 t, free. of │ │ │ │ │ -000309c0: 6164 6465 6420 6d61 7465 7269 616c 2e20 added material. │ │ │ │ │ -000309d0: 2049 6620 796f 7520 7573 6520 7468 6520 If you use the │ │ │ │ │ -000309e0: 6c61 7474 6572 206f 7074 696f 6e2c 2079 latter option, y │ │ │ │ │ -000309f0: 6f75 206d 7573 7420 7461 6b65 0a20 2020 ou must take. │ │ │ │ │ -00030a00: 2020 7265 6173 6f6e 6162 6c79 2070 7275 reasonably pru │ │ │ │ │ -00030a10: 6465 6e74 2073 7465 7073 2c20 7768 656e dent steps, when │ │ │ │ │ -00030a20: 2079 6f75 2062 6567 696e 2064 6973 7472 you begin distr │ │ │ │ │ -00030a30: 6962 7574 696f 6e20 6f66 204f 7061 7175 ibution of Opaqu │ │ │ │ │ -00030a40: 650a 2020 2020 2063 6f70 6965 7320 696e e. copies in │ │ │ │ │ -00030a50: 2071 7561 6e74 6974 792c 2074 6f20 656e quantity, to en │ │ │ │ │ -00030a60: 7375 7265 2074 6861 7420 7468 6973 2054 sure that this T │ │ │ │ │ -00030a70: 7261 6e73 7061 7265 6e74 2063 6f70 7920 ransparent copy │ │ │ │ │ -00030a80: 7769 6c6c 0a20 2020 2020 7265 6d61 696e will. remain │ │ │ │ │ -00030a90: 2074 6875 7320 6163 6365 7373 6962 6c65 thus accessible │ │ │ │ │ -00030aa0: 2061 7420 7468 6520 7374 6174 6564 206c at the stated l │ │ │ │ │ -00030ab0: 6f63 6174 696f 6e20 756e 7469 6c20 6174 ocation until at │ │ │ │ │ -00030ac0: 206c 6561 7374 206f 6e65 0a20 2020 2020 least one. │ │ │ │ │ -00030ad0: 7965 6172 2061 6674 6572 2074 6865 206c year after the l │ │ │ │ │ -00030ae0: 6173 7420 7469 6d65 2079 6f75 2064 6973 ast time you dis │ │ │ │ │ -00030af0: 7472 6962 7574 6520 616e 204f 7061 7175 tribute an Opaqu │ │ │ │ │ -00030b00: 6520 636f 7079 2028 6469 7265 6374 6c79 e copy (directly │ │ │ │ │ -00030b10: 206f 720a 2020 2020 2074 6872 6f75 6768 or. through │ │ │ │ │ -00030b20: 2079 6f75 7220 6167 656e 7473 206f 7220 your agents or │ │ │ │ │ -00030b30: 7265 7461 696c 6572 7329 206f 6620 7468 retailers) of th │ │ │ │ │ -00030b40: 6174 2065 6469 7469 6f6e 2074 6f20 7468 at edition to th │ │ │ │ │ -00030b50: 6520 7075 626c 6963 2e0a 0a20 2020 2020 e public... │ │ │ │ │ -00030b60: 4974 2069 7320 7265 7175 6573 7465 642c It is requested, │ │ │ │ │ -00030b70: 2062 7574 206e 6f74 2072 6571 7569 7265 but not require │ │ │ │ │ -00030b80: 642c 2074 6861 7420 796f 7520 636f 6e74 d, that you cont │ │ │ │ │ -00030b90: 6163 7420 7468 6520 6175 7468 6f72 7320 act the authors │ │ │ │ │ -00030ba0: 6f66 0a20 2020 2020 7468 6520 446f 6375 of. the Docu │ │ │ │ │ -00030bb0: 6d65 6e74 2077 656c 6c20 6265 666f 7265 ment well before │ │ │ │ │ -00030bc0: 2072 6564 6973 7472 6962 7574 696e 6720 redistributing │ │ │ │ │ -00030bd0: 616e 7920 6c61 7267 6520 6e75 6d62 6572 any large number │ │ │ │ │ -00030be0: 206f 6620 636f 7069 6573 2c0a 2020 2020 of copies,. │ │ │ │ │ -00030bf0: 2074 6f20 6769 7665 2074 6865 6d20 6120 to give them a │ │ │ │ │ -00030c00: 6368 616e 6365 2074 6f20 7072 6f76 6964 chance to provid │ │ │ │ │ -00030c10: 6520 796f 7520 7769 7468 2061 6e20 7570 e you with an up │ │ │ │ │ -00030c20: 6461 7465 6420 7665 7273 696f 6e20 6f66 dated version of │ │ │ │ │ -00030c30: 2074 6865 0a20 2020 2020 446f 6375 6d65 the. Docume │ │ │ │ │ -00030c40: 6e74 2e0a 0a20 2034 2e20 4d4f 4449 4649 nt... 4. MODIFI │ │ │ │ │ -00030c50: 4341 5449 4f4e 530a 0a20 2020 2020 596f CATIONS.. Yo │ │ │ │ │ -00030c60: 7520 6d61 7920 636f 7079 2061 6e64 2064 u may copy and d │ │ │ │ │ -00030c70: 6973 7472 6962 7574 6520 6120 4d6f 6469 istribute a Modi │ │ │ │ │ -00030c80: 6669 6564 2056 6572 7369 6f6e 206f 6620 fied Version of │ │ │ │ │ -00030c90: 7468 6520 446f 6375 6d65 6e74 0a20 2020 the Document. │ │ │ │ │ -00030ca0: 2020 756e 6465 7220 7468 6520 636f 6e64 under the cond │ │ │ │ │ -00030cb0: 6974 696f 6e73 206f 6620 7365 6374 696f itions of sectio │ │ │ │ │ -00030cc0: 6e73 2032 2061 6e64 2033 2061 626f 7665 ns 2 and 3 above │ │ │ │ │ -00030cd0: 2c20 7072 6f76 6964 6564 2074 6861 7420 , provided that │ │ │ │ │ -00030ce0: 796f 750a 2020 2020 2072 656c 6561 7365 you. release │ │ │ │ │ -00030cf0: 2074 6865 204d 6f64 6966 6965 6420 5665 the Modified Ve │ │ │ │ │ -00030d00: 7273 696f 6e20 756e 6465 7220 7072 6563 rsion under prec │ │ │ │ │ -00030d10: 6973 656c 7920 7468 6973 204c 6963 656e isely this Licen │ │ │ │ │ -00030d20: 7365 2c20 7769 7468 2074 6865 0a20 2020 se, with the. │ │ │ │ │ -00030d30: 2020 4d6f 6469 6669 6564 2056 6572 7369 Modified Versi │ │ │ │ │ -00030d40: 6f6e 2066 696c 6c69 6e67 2074 6865 2072 on filling the r │ │ │ │ │ -00030d50: 6f6c 6520 6f66 2074 6865 2044 6f63 756d ole of the Docum │ │ │ │ │ -00030d60: 656e 742c 2074 6875 7320 6c69 6365 6e73 ent, thus licens │ │ │ │ │ -00030d70: 696e 670a 2020 2020 2064 6973 7472 6962 ing. distrib │ │ │ │ │ -00030d80: 7574 696f 6e20 616e 6420 6d6f 6469 6669 ution and modifi │ │ │ │ │ -00030d90: 6361 7469 6f6e 206f 6620 7468 6520 4d6f cation of the Mo │ │ │ │ │ -00030da0: 6469 6669 6564 2056 6572 7369 6f6e 2074 dified Version t │ │ │ │ │ -00030db0: 6f20 7768 6f65 7665 720a 2020 2020 2070 o whoever. p │ │ │ │ │ -00030dc0: 6f73 7365 7373 6573 2061 2063 6f70 7920 ossesses a copy │ │ │ │ │ -00030dd0: 6f66 2069 742e 2020 496e 2061 6464 6974 of it. In addit │ │ │ │ │ -00030de0: 696f 6e2c 2079 6f75 206d 7573 7420 646f ion, you must do │ │ │ │ │ -00030df0: 2074 6865 7365 2074 6869 6e67 7320 696e these things in │ │ │ │ │ -00030e00: 0a20 2020 2020 7468 6520 4d6f 6469 6669 . the Modifi │ │ │ │ │ -00030e10: 6564 2056 6572 7369 6f6e 3a0a 0a20 2020 ed Version:.. │ │ │ │ │ -00030e20: 2020 2020 412e 2055 7365 2069 6e20 7468 A. Use in th │ │ │ │ │ -00030e30: 6520 5469 746c 6520 5061 6765 2028 616e e Title Page (an │ │ │ │ │ -00030e40: 6420 6f6e 2074 6865 2063 6f76 6572 732c d on the covers, │ │ │ │ │ -00030e50: 2069 6620 616e 7929 2061 2074 6974 6c65 if any) a title │ │ │ │ │ -00030e60: 0a20 2020 2020 2020 2020 2064 6973 7469 . disti │ │ │ │ │ -00030e70: 6e63 7420 6672 6f6d 2074 6861 7420 6f66 nct from that of │ │ │ │ │ -00030e80: 2074 6865 2044 6f63 756d 656e 742c 2061 the Document, a │ │ │ │ │ -00030e90: 6e64 2066 726f 6d20 7468 6f73 6520 6f66 nd from those of │ │ │ │ │ -00030ea0: 2070 7265 7669 6f75 730a 2020 2020 2020 previous. │ │ │ │ │ -00030eb0: 2020 2020 7665 7273 696f 6e73 2028 7768 versions (wh │ │ │ │ │ -00030ec0: 6963 6820 7368 6f75 6c64 2c20 6966 2074 ich should, if t │ │ │ │ │ -00030ed0: 6865 7265 2077 6572 6520 616e 792c 2062 here were any, b │ │ │ │ │ -00030ee0: 6520 6c69 7374 6564 2069 6e20 7468 650a e listed in the. │ │ │ │ │ -00030ef0: 2020 2020 2020 2020 2020 4869 7374 6f72 Histor │ │ │ │ │ -00030f00: 7920 7365 6374 696f 6e20 6f66 2074 6865 y section of the │ │ │ │ │ -00030f10: 2044 6f63 756d 656e 7429 2e20 2059 6f75 Document). You │ │ │ │ │ -00030f20: 206d 6179 2075 7365 2074 6865 2073 616d may use the sam │ │ │ │ │ -00030f30: 6520 7469 746c 650a 2020 2020 2020 2020 e title. │ │ │ │ │ -00030f40: 2020 6173 2061 2070 7265 7669 6f75 7320 as a previous │ │ │ │ │ -00030f50: 7665 7273 696f 6e20 6966 2074 6865 206f version if the o │ │ │ │ │ -00030f60: 7269 6769 6e61 6c20 7075 626c 6973 6865 riginal publishe │ │ │ │ │ -00030f70: 7220 6f66 2074 6861 740a 2020 2020 2020 r of that. │ │ │ │ │ -00030f80: 2020 2020 7665 7273 696f 6e20 6769 7665 version give │ │ │ │ │ -00030f90: 7320 7065 726d 6973 7369 6f6e 2e0a 0a20 s permission... │ │ │ │ │ -00030fa0: 2020 2020 2020 422e 204c 6973 7420 6f6e B. List on │ │ │ │ │ -00030fb0: 2074 6865 2054 6974 6c65 2050 6167 652c the Title Page, │ │ │ │ │ -00030fc0: 2061 7320 6175 7468 6f72 732c 206f 6e65 as authors, one │ │ │ │ │ -00030fd0: 206f 7220 6d6f 7265 2070 6572 736f 6e73 or more persons │ │ │ │ │ -00030fe0: 206f 720a 2020 2020 2020 2020 2020 656e or. en │ │ │ │ │ -00030ff0: 7469 7469 6573 2072 6573 706f 6e73 6962 tities responsib │ │ │ │ │ -00031000: 6c65 2066 6f72 2061 7574 686f 7273 6869 le for authorshi │ │ │ │ │ -00031010: 7020 6f66 2074 6865 206d 6f64 6966 6963 p of the modific │ │ │ │ │ -00031020: 6174 696f 6e73 2069 6e0a 2020 2020 2020 ations in. │ │ │ │ │ -00031030: 2020 2020 7468 6520 4d6f 6469 6669 6564 the Modified │ │ │ │ │ -00031040: 2056 6572 7369 6f6e 2c20 746f 6765 7468 Version, togeth │ │ │ │ │ -00031050: 6572 2077 6974 6820 6174 206c 6561 7374 er with at least │ │ │ │ │ -00031060: 2066 6976 6520 6f66 2074 6865 0a20 2020 five of the. │ │ │ │ │ -00031070: 2020 2020 2020 2070 7269 6e63 6970 616c principal │ │ │ │ │ -00031080: 2061 7574 686f 7273 206f 6620 7468 6520 authors of the │ │ │ │ │ -00031090: 446f 6375 6d65 6e74 2028 616c 6c20 6f66 Document (all of │ │ │ │ │ -000310a0: 2069 7473 2070 7269 6e63 6970 616c 0a20 its principal. │ │ │ │ │ -000310b0: 2020 2020 2020 2020 2061 7574 686f 7273 authors │ │ │ │ │ -000310c0: 2c20 6966 2069 7420 6861 7320 6665 7765 , if it has fewe │ │ │ │ │ -000310d0: 7220 7468 616e 2066 6976 6529 2c20 756e r than five), un │ │ │ │ │ -000310e0: 6c65 7373 2074 6865 7920 7265 6c65 6173 less they releas │ │ │ │ │ -000310f0: 6520 796f 750a 2020 2020 2020 2020 2020 e you. │ │ │ │ │ -00031100: 6672 6f6d 2074 6869 7320 7265 7175 6972 from this requir │ │ │ │ │ -00031110: 656d 656e 742e 0a0a 2020 2020 2020 2043 ement... C │ │ │ │ │ -00031120: 2e20 5374 6174 6520 6f6e 2074 6865 2054 . State on the T │ │ │ │ │ -00031130: 6974 6c65 2070 6167 6520 7468 6520 6e61 itle page the na │ │ │ │ │ -00031140: 6d65 206f 6620 7468 6520 7075 626c 6973 me of the publis │ │ │ │ │ -00031150: 6865 7220 6f66 2074 6865 0a20 2020 2020 her of the. │ │ │ │ │ -00031160: 2020 2020 204d 6f64 6966 6965 6420 5665 Modified Ve │ │ │ │ │ -00031170: 7273 696f 6e2c 2061 7320 7468 6520 7075 rsion, as the pu │ │ │ │ │ -00031180: 626c 6973 6865 722e 0a0a 2020 2020 2020 blisher... │ │ │ │ │ -00031190: 2044 2e20 5072 6573 6572 7665 2061 6c6c D. Preserve all │ │ │ │ │ -000311a0: 2074 6865 2063 6f70 7972 6967 6874 206e the copyright n │ │ │ │ │ -000311b0: 6f74 6963 6573 206f 6620 7468 6520 446f otices of the Do │ │ │ │ │ -000311c0: 6375 6d65 6e74 2e0a 0a20 2020 2020 2020 cument... │ │ │ │ │ -000311d0: 452e 2041 6464 2061 6e20 6170 7072 6f70 E. Add an approp │ │ │ │ │ -000311e0: 7269 6174 6520 636f 7079 7269 6768 7420 riate copyright │ │ │ │ │ -000311f0: 6e6f 7469 6365 2066 6f72 2079 6f75 7220 notice for your │ │ │ │ │ -00031200: 6d6f 6469 6669 6361 7469 6f6e 730a 2020 modifications. │ │ │ │ │ -00031210: 2020 2020 2020 2020 6164 6a61 6365 6e74 adjacent │ │ │ │ │ -00031220: 2074 6f20 7468 6520 6f74 6865 7220 636f to the other co │ │ │ │ │ -00031230: 7079 7269 6768 7420 6e6f 7469 6365 732e pyright notices. │ │ │ │ │ -00031240: 0a0a 2020 2020 2020 2046 2e20 496e 636c .. F. Incl │ │ │ │ │ -00031250: 7564 652c 2069 6d6d 6564 6961 7465 6c79 ude, immediately │ │ │ │ │ -00031260: 2061 6674 6572 2074 6865 2063 6f70 7972 after the copyr │ │ │ │ │ -00031270: 6967 6874 206e 6f74 6963 6573 2c20 6120 ight notices, a │ │ │ │ │ -00031280: 6c69 6365 6e73 650a 2020 2020 2020 2020 license. │ │ │ │ │ -00031290: 2020 6e6f 7469 6365 2067 6976 696e 6720 notice giving │ │ │ │ │ -000312a0: 7468 6520 7075 626c 6963 2070 6572 6d69 the public permi │ │ │ │ │ -000312b0: 7373 696f 6e20 746f 2075 7365 2074 6865 ssion to use the │ │ │ │ │ -000312c0: 204d 6f64 6966 6965 640a 2020 2020 2020 Modified. │ │ │ │ │ -000312d0: 2020 2020 5665 7273 696f 6e20 756e 6465 Version unde │ │ │ │ │ -000312e0: 7220 7468 6520 7465 726d 7320 6f66 2074 r the terms of t │ │ │ │ │ -000312f0: 6869 7320 4c69 6365 6e73 652c 2069 6e20 his License, in │ │ │ │ │ -00031300: 7468 6520 666f 726d 2073 686f 776e 2069 the form shown i │ │ │ │ │ -00031310: 6e0a 2020 2020 2020 2020 2020 7468 6520 n. the │ │ │ │ │ -00031320: 4164 6465 6e64 756d 2062 656c 6f77 2e0a Addendum below.. │ │ │ │ │ -00031330: 0a20 2020 2020 2020 472e 2050 7265 7365 . G. Prese │ │ │ │ │ -00031340: 7276 6520 696e 2074 6861 7420 6c69 6365 rve in that lice │ │ │ │ │ -00031350: 6e73 6520 6e6f 7469 6365 2074 6865 2066 nse notice the f │ │ │ │ │ -00031360: 756c 6c20 6c69 7374 7320 6f66 2049 6e76 ull lists of Inv │ │ │ │ │ -00031370: 6172 6961 6e74 0a20 2020 2020 2020 2020 ariant. │ │ │ │ │ -00031380: 2053 6563 7469 6f6e 7320 616e 6420 7265 Sections and re │ │ │ │ │ -00031390: 7175 6972 6564 2043 6f76 6572 2054 6578 quired Cover Tex │ │ │ │ │ -000313a0: 7473 2067 6976 656e 2069 6e20 7468 6520 ts given in the │ │ │ │ │ -000313b0: 446f 6375 6d65 6e74 2773 0a20 2020 2020 Document's. │ │ │ │ │ -000313c0: 2020 2020 206c 6963 656e 7365 206e 6f74 license not │ │ │ │ │ -000313d0: 6963 652e 0a0a 2020 2020 2020 2048 2e20 ice... H. │ │ │ │ │ -000313e0: 496e 636c 7564 6520 616e 2075 6e61 6c74 Include an unalt │ │ │ │ │ -000313f0: 6572 6564 2063 6f70 7920 6f66 2074 6869 ered copy of thi │ │ │ │ │ -00031400: 7320 4c69 6365 6e73 652e 0a0a 2020 2020 s License... │ │ │ │ │ -00031410: 2020 2049 2e20 5072 6573 6572 7665 2074 I. Preserve t │ │ │ │ │ -00031420: 6865 2073 6563 7469 6f6e 2045 6e74 6974 he section Entit │ │ │ │ │ -00031430: 6c65 6420 2248 6973 746f 7279 222c 2050 led "History", P │ │ │ │ │ -00031440: 7265 7365 7276 6520 6974 7320 5469 746c reserve its Titl │ │ │ │ │ -00031450: 652c 0a20 2020 2020 2020 2020 2061 6e64 e,. and │ │ │ │ │ -00031460: 2061 6464 2074 6f20 6974 2061 6e20 6974 add to it an it │ │ │ │ │ -00031470: 656d 2073 7461 7469 6e67 2061 7420 6c65 em stating at le │ │ │ │ │ -00031480: 6173 7420 7468 6520 7469 746c 652c 2079 ast the title, y │ │ │ │ │ -00031490: 6561 722c 206e 6577 0a20 2020 2020 2020 ear, new. │ │ │ │ │ -000314a0: 2020 2061 7574 686f 7273 2c20 616e 6420 authors, and │ │ │ │ │ -000314b0: 7075 626c 6973 6865 7220 6f66 2074 6865 publisher of the │ │ │ │ │ -000314c0: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ -000314d0: 6e20 6173 2067 6976 656e 206f 6e20 7468 n as given on th │ │ │ │ │ -000314e0: 650a 2020 2020 2020 2020 2020 5469 746c e. Titl │ │ │ │ │ -000314f0: 6520 5061 6765 2e20 2049 6620 7468 6572 e Page. If ther │ │ │ │ │ -00031500: 6520 6973 206e 6f20 7365 6374 696f 6e20 e is no section │ │ │ │ │ -00031510: 456e 7469 746c 6564 2022 4869 7374 6f72 Entitled "Histor │ │ │ │ │ -00031520: 7922 2069 6e20 7468 650a 2020 2020 2020 y" in the. │ │ │ │ │ -00031530: 2020 2020 446f 6375 6d65 6e74 2c20 6372 Document, cr │ │ │ │ │ -00031540: 6561 7465 206f 6e65 2073 7461 7469 6e67 eate one stating │ │ │ │ │ -00031550: 2074 6865 2074 6974 6c65 2c20 7965 6172 the title, year │ │ │ │ │ -00031560: 2c20 6175 7468 6f72 732c 2061 6e64 0a20 , authors, and. │ │ │ │ │ -00031570: 2020 2020 2020 2020 2070 7562 6c69 7368 publish │ │ │ │ │ -00031580: 6572 206f 6620 7468 6520 446f 6375 6d65 er of the Docume │ │ │ │ │ -00031590: 6e74 2061 7320 6769 7665 6e20 6f6e 2069 nt as given on i │ │ │ │ │ -000315a0: 7473 2054 6974 6c65 2050 6167 652c 2074 ts Title Page, t │ │ │ │ │ -000315b0: 6865 6e20 6164 640a 2020 2020 2020 2020 hen add. │ │ │ │ │ -000315c0: 2020 616e 2069 7465 6d20 6465 7363 7269 an item descri │ │ │ │ │ -000315d0: 6269 6e67 2074 6865 204d 6f64 6966 6965 bing the Modifie │ │ │ │ │ -000315e0: 6420 5665 7273 696f 6e20 6173 2073 7461 d Version as sta │ │ │ │ │ -000315f0: 7465 6420 696e 2074 6865 0a20 2020 2020 ted in the. │ │ │ │ │ -00031600: 2020 2020 2070 7265 7669 6f75 7320 7365 previous se │ │ │ │ │ -00031610: 6e74 656e 6365 2e0a 0a20 2020 2020 2020 ntence... │ │ │ │ │ -00031620: 4a2e 2050 7265 7365 7276 6520 7468 6520 J. Preserve the │ │ │ │ │ -00031630: 6e65 7477 6f72 6b20 6c6f 6361 7469 6f6e network location │ │ │ │ │ -00031640: 2c20 6966 2061 6e79 2c20 6769 7665 6e20 , if any, given │ │ │ │ │ -00031650: 696e 2074 6865 2044 6f63 756d 656e 740a in the Document. │ │ │ │ │ -00031660: 2020 2020 2020 2020 2020 666f 7220 7075 for pu │ │ │ │ │ -00031670: 626c 6963 2061 6363 6573 7320 746f 2061 blic access to a │ │ │ │ │ -00031680: 2054 7261 6e73 7061 7265 6e74 2063 6f70 Transparent cop │ │ │ │ │ -00031690: 7920 6f66 2074 6865 2044 6f63 756d 656e y of the Documen │ │ │ │ │ -000316a0: 742c 2061 6e64 0a20 2020 2020 2020 2020 t, and. │ │ │ │ │ -000316b0: 206c 696b 6577 6973 6520 7468 6520 6e65 likewise the ne │ │ │ │ │ -000316c0: 7477 6f72 6b20 6c6f 6361 7469 6f6e 7320 twork locations │ │ │ │ │ -000316d0: 6769 7665 6e20 696e 2074 6865 2044 6f63 given in the Doc │ │ │ │ │ -000316e0: 756d 656e 7420 666f 720a 2020 2020 2020 ument for. │ │ │ │ │ -000316f0: 2020 2020 7072 6576 696f 7573 2076 6572 previous ver │ │ │ │ │ -00031700: 7369 6f6e 7320 6974 2077 6173 2062 6173 sions it was bas │ │ │ │ │ -00031710: 6564 206f 6e2e 2020 5468 6573 6520 6d61 ed on. These ma │ │ │ │ │ -00031720: 7920 6265 2070 6c61 6365 6420 696e 2074 y be placed in t │ │ │ │ │ -00031730: 6865 0a20 2020 2020 2020 2020 2022 4869 he. "Hi │ │ │ │ │ -00031740: 7374 6f72 7922 2073 6563 7469 6f6e 2e20 story" section. │ │ │ │ │ -00031750: 2059 6f75 206d 6179 206f 6d69 7420 6120 You may omit a │ │ │ │ │ -00031760: 6e65 7477 6f72 6b20 6c6f 6361 7469 6f6e network location │ │ │ │ │ -00031770: 2066 6f72 2061 2077 6f72 6b0a 2020 2020 for a work. │ │ │ │ │ -00031780: 2020 2020 2020 7468 6174 2077 6173 2070 that was p │ │ │ │ │ -00031790: 7562 6c69 7368 6564 2061 7420 6c65 6173 ublished at leas │ │ │ │ │ -000317a0: 7420 666f 7572 2079 6561 7273 2062 6566 t four years bef │ │ │ │ │ -000317b0: 6f72 6520 7468 6520 446f 6375 6d65 6e74 ore the Document │ │ │ │ │ -000317c0: 0a20 2020 2020 2020 2020 2069 7473 656c . itsel │ │ │ │ │ -000317d0: 662c 206f 7220 6966 2074 6865 206f 7269 f, or if the ori │ │ │ │ │ -000317e0: 6769 6e61 6c20 7075 626c 6973 6865 7220 ginal publisher │ │ │ │ │ -000317f0: 6f66 2074 6865 2076 6572 7369 6f6e 2069 of the version i │ │ │ │ │ -00031800: 7420 7265 6665 7273 0a20 2020 2020 2020 t refers. │ │ │ │ │ -00031810: 2020 2074 6f20 6769 7665 7320 7065 726d to gives perm │ │ │ │ │ -00031820: 6973 7369 6f6e 2e0a 0a20 2020 2020 2020 ission... │ │ │ │ │ -00031830: 4b2e 2046 6f72 2061 6e79 2073 6563 7469 K. For any secti │ │ │ │ │ -00031840: 6f6e 2045 6e74 6974 6c65 6420 2241 636b on Entitled "Ack │ │ │ │ │ -00031850: 6e6f 776c 6564 6765 6d65 6e74 7322 206f nowledgements" o │ │ │ │ │ -00031860: 7220 2244 6564 6963 6174 696f 6e73 222c r "Dedications", │ │ │ │ │ -00031870: 0a20 2020 2020 2020 2020 2050 7265 7365 . Prese │ │ │ │ │ -00031880: 7276 6520 7468 6520 5469 746c 6520 6f66 rve the Title of │ │ │ │ │ -00031890: 2074 6865 2073 6563 7469 6f6e 2c20 616e the section, an │ │ │ │ │ -000318a0: 6420 7072 6573 6572 7665 2069 6e20 7468 d preserve in th │ │ │ │ │ -000318b0: 6520 7365 6374 696f 6e0a 2020 2020 2020 e section. │ │ │ │ │ -000318c0: 2020 2020 616c 6c20 7468 6520 7375 6273 all the subs │ │ │ │ │ -000318d0: 7461 6e63 6520 616e 6420 746f 6e65 206f tance and tone o │ │ │ │ │ -000318e0: 6620 6561 6368 206f 6620 7468 6520 636f f each of the co │ │ │ │ │ -000318f0: 6e74 7269 6275 746f 720a 2020 2020 2020 ntributor. │ │ │ │ │ -00031900: 2020 2020 6163 6b6e 6f77 6c65 6467 656d acknowledgem │ │ │ │ │ -00031910: 656e 7473 2061 6e64 2f6f 7220 6465 6469 ents and/or dedi │ │ │ │ │ -00031920: 6361 7469 6f6e 7320 6769 7665 6e20 7468 cations given th │ │ │ │ │ -00031930: 6572 6569 6e2e 0a0a 2020 2020 2020 204c erein... L │ │ │ │ │ -00031940: 2e20 5072 6573 6572 7665 2061 6c6c 2074 . Preserve all t │ │ │ │ │ -00031950: 6865 2049 6e76 6172 6961 6e74 2053 6563 he Invariant Sec │ │ │ │ │ -00031960: 7469 6f6e 7320 6f66 2074 6865 2044 6f63 tions of the Doc │ │ │ │ │ -00031970: 756d 656e 742c 2075 6e61 6c74 6572 6564 ument, unaltered │ │ │ │ │ -00031980: 0a20 2020 2020 2020 2020 2069 6e20 7468 . in th │ │ │ │ │ -00031990: 6569 7220 7465 7874 2061 6e64 2069 6e20 eir text and in │ │ │ │ │ -000319a0: 7468 6569 7220 7469 746c 6573 2e20 2053 their titles. S │ │ │ │ │ -000319b0: 6563 7469 6f6e 206e 756d 6265 7273 206f ection numbers o │ │ │ │ │ -000319c0: 7220 7468 650a 2020 2020 2020 2020 2020 r the. │ │ │ │ │ -000319d0: 6571 7569 7661 6c65 6e74 2061 7265 206e equivalent are n │ │ │ │ │ -000319e0: 6f74 2063 6f6e 7369 6465 7265 6420 7061 ot considered pa │ │ │ │ │ -000319f0: 7274 206f 6620 7468 6520 7365 6374 696f rt of the sectio │ │ │ │ │ -00031a00: 6e20 7469 746c 6573 2e0a 0a20 2020 2020 n titles... │ │ │ │ │ -00031a10: 2020 4d2e 2044 656c 6574 6520 616e 7920 M. Delete any │ │ │ │ │ -00031a20: 7365 6374 696f 6e20 456e 7469 746c 6564 section Entitled │ │ │ │ │ -00031a30: 2022 456e 646f 7273 656d 656e 7473 222e "Endorsements". │ │ │ │ │ -00031a40: 2020 5375 6368 2061 2073 6563 7469 6f6e Such a section │ │ │ │ │ -00031a50: 0a20 2020 2020 2020 2020 206d 6179 206e . may n │ │ │ │ │ -00031a60: 6f74 2062 6520 696e 636c 7564 6564 2069 ot be included i │ │ │ │ │ -00031a70: 6e20 7468 6520 4d6f 6469 6669 6564 2056 n the Modified V │ │ │ │ │ -00031a80: 6572 7369 6f6e 2e0a 0a20 2020 2020 2020 ersion... │ │ │ │ │ -00031a90: 4e2e 2044 6f20 6e6f 7420 7265 7469 746c N. Do not retitl │ │ │ │ │ -00031aa0: 6520 616e 7920 6578 6973 7469 6e67 2073 e any existing s │ │ │ │ │ -00031ab0: 6563 7469 6f6e 2074 6f20 6265 2045 6e74 ection to be Ent │ │ │ │ │ -00031ac0: 6974 6c65 640a 2020 2020 2020 2020 2020 itled. │ │ │ │ │ -00031ad0: 2245 6e64 6f72 7365 6d65 6e74 7322 206f "Endorsements" o │ │ │ │ │ -00031ae0: 7220 746f 2063 6f6e 666c 6963 7420 696e r to conflict in │ │ │ │ │ -00031af0: 2074 6974 6c65 2077 6974 6820 616e 7920 title with any │ │ │ │ │ -00031b00: 496e 7661 7269 616e 740a 2020 2020 2020 Invariant. │ │ │ │ │ -00031b10: 2020 2020 5365 6374 696f 6e2e 0a0a 2020 Section... │ │ │ │ │ -00031b20: 2020 2020 204f 2e20 5072 6573 6572 7665 O. Preserve │ │ │ │ │ -00031b30: 2061 6e79 2057 6172 7261 6e74 7920 4469 any Warranty Di │ │ │ │ │ -00031b40: 7363 6c61 696d 6572 732e 0a0a 2020 2020 sclaimers... │ │ │ │ │ -00031b50: 2049 6620 7468 6520 4d6f 6469 6669 6564 If the Modified │ │ │ │ │ -00031b60: 2056 6572 7369 6f6e 2069 6e63 6c75 6465 Version include │ │ │ │ │ -00031b70: 7320 6e65 7720 6672 6f6e 742d 6d61 7474 s new front-matt │ │ │ │ │ -00031b80: 6572 2073 6563 7469 6f6e 7320 6f72 0a20 er sections or. │ │ │ │ │ -00031b90: 2020 2020 6170 7065 6e64 6963 6573 2074 appendices t │ │ │ │ │ -00031ba0: 6861 7420 7175 616c 6966 7920 6173 2053 hat qualify as S │ │ │ │ │ -00031bb0: 6563 6f6e 6461 7279 2053 6563 7469 6f6e econdary Section │ │ │ │ │ -00031bc0: 7320 616e 6420 636f 6e74 6169 6e20 6e6f s and contain no │ │ │ │ │ -00031bd0: 0a20 2020 2020 6d61 7465 7269 616c 2063 . material c │ │ │ │ │ -00031be0: 6f70 6965 6420 6672 6f6d 2074 6865 2044 opied from the D │ │ │ │ │ -00031bf0: 6f63 756d 656e 742c 2079 6f75 206d 6179 ocument, you may │ │ │ │ │ -00031c00: 2061 7420 796f 7572 206f 7074 696f 6e20 at your option │ │ │ │ │ -00031c10: 6465 7369 676e 6174 650a 2020 2020 2073 designate. s │ │ │ │ │ -00031c20: 6f6d 6520 6f72 2061 6c6c 206f 6620 7468 ome or all of th │ │ │ │ │ -00031c30: 6573 6520 7365 6374 696f 6e73 2061 7320 ese sections as │ │ │ │ │ -00031c40: 696e 7661 7269 616e 742e 2020 546f 2064 invariant. To d │ │ │ │ │ -00031c50: 6f20 7468 6973 2c20 6164 6420 7468 6569 o this, add thei │ │ │ │ │ -00031c60: 720a 2020 2020 2074 6974 6c65 7320 746f r. titles to │ │ │ │ │ -00031c70: 2074 6865 206c 6973 7420 6f66 2049 6e76 the list of Inv │ │ │ │ │ -00031c80: 6172 6961 6e74 2053 6563 7469 6f6e 7320 ariant Sections │ │ │ │ │ -00031c90: 696e 2074 6865 204d 6f64 6966 6965 6420 in the Modified │ │ │ │ │ -00031ca0: 5665 7273 696f 6e27 730a 2020 2020 206c Version's. l │ │ │ │ │ -00031cb0: 6963 656e 7365 206e 6f74 6963 652e 2020 icense notice. │ │ │ │ │ -00031cc0: 5468 6573 6520 7469 746c 6573 206d 7573 These titles mus │ │ │ │ │ -00031cd0: 7420 6265 2064 6973 7469 6e63 7420 6672 t be distinct fr │ │ │ │ │ -00031ce0: 6f6d 2061 6e79 206f 7468 6572 0a20 2020 om any other. │ │ │ │ │ -00031cf0: 2020 7365 6374 696f 6e20 7469 746c 6573 section titles │ │ │ │ │ -00031d00: 2e0a 0a20 2020 2020 596f 7520 6d61 7920 ... You may │ │ │ │ │ -00031d10: 6164 6420 6120 7365 6374 696f 6e20 456e add a section En │ │ │ │ │ -00031d20: 7469 746c 6564 2022 456e 646f 7273 656d titled "Endorsem │ │ │ │ │ -00031d30: 656e 7473 222c 2070 726f 7669 6465 6420 ents", provided │ │ │ │ │ -00031d40: 6974 2063 6f6e 7461 696e 730a 2020 2020 it contains. │ │ │ │ │ -00031d50: 206e 6f74 6869 6e67 2062 7574 2065 6e64 nothing but end │ │ │ │ │ -00031d60: 6f72 7365 6d65 6e74 7320 6f66 2079 6f75 orsements of you │ │ │ │ │ -00031d70: 7220 4d6f 6469 6669 6564 2056 6572 7369 r Modified Versi │ │ │ │ │ -00031d80: 6f6e 2062 7920 7661 7269 6f75 730a 2020 on by various. │ │ │ │ │ -00031d90: 2020 2070 6172 7469 6573 2d2d 666f 7220 parties--for │ │ │ │ │ -00031da0: 6578 616d 706c 652c 2073 7461 7465 6d65 example, stateme │ │ │ │ │ -00031db0: 6e74 7320 6f66 2070 6565 7220 7265 7669 nts of peer revi │ │ │ │ │ -00031dc0: 6577 206f 7220 7468 6174 2074 6865 2074 ew or that the t │ │ │ │ │ -00031dd0: 6578 740a 2020 2020 2068 6173 2062 6565 ext. has bee │ │ │ │ │ -00031de0: 6e20 6170 7072 6f76 6564 2062 7920 616e n approved by an │ │ │ │ │ -00031df0: 206f 7267 616e 697a 6174 696f 6e20 6173 organization as │ │ │ │ │ -00031e00: 2074 6865 2061 7574 686f 7269 7461 7469 the authoritati │ │ │ │ │ -00031e10: 7665 0a20 2020 2020 6465 6669 6e69 7469 ve. definiti │ │ │ │ │ -00031e20: 6f6e 206f 6620 6120 7374 616e 6461 7264 on of a standard │ │ │ │ │ -00031e30: 2e0a 0a20 2020 2020 596f 7520 6d61 7920 ... You may │ │ │ │ │ -00031e40: 6164 6420 6120 7061 7373 6167 6520 6f66 add a passage of │ │ │ │ │ -00031e50: 2075 7020 746f 2066 6976 6520 776f 7264 up to five word │ │ │ │ │ -00031e60: 7320 6173 2061 2046 726f 6e74 2d43 6f76 s as a Front-Cov │ │ │ │ │ -00031e70: 6572 2054 6578 742c 0a20 2020 2020 616e er Text,. an │ │ │ │ │ -00031e80: 6420 6120 7061 7373 6167 6520 6f66 2075 d a passage of u │ │ │ │ │ -00031e90: 7020 746f 2032 3520 776f 7264 7320 6173 p to 25 words as │ │ │ │ │ -00031ea0: 2061 2042 6163 6b2d 436f 7665 7220 5465 a Back-Cover Te │ │ │ │ │ -00031eb0: 7874 2c20 746f 2074 6865 2065 6e64 206f xt, to the end o │ │ │ │ │ -00031ec0: 660a 2020 2020 2074 6865 206c 6973 7420 f. the list │ │ │ │ │ -00031ed0: 6f66 2043 6f76 6572 2054 6578 7473 2069 of Cover Texts i │ │ │ │ │ -00031ee0: 6e20 7468 6520 4d6f 6469 6669 6564 2056 n the Modified V │ │ │ │ │ -00031ef0: 6572 7369 6f6e 2e20 204f 6e6c 7920 6f6e ersion. Only on │ │ │ │ │ -00031f00: 6520 7061 7373 6167 650a 2020 2020 206f e passage. o │ │ │ │ │ -00031f10: 6620 4672 6f6e 742d 436f 7665 7220 5465 f Front-Cover Te │ │ │ │ │ -00031f20: 7874 2061 6e64 206f 6e65 206f 6620 4261 xt and one of Ba │ │ │ │ │ -00031f30: 636b 2d43 6f76 6572 2054 6578 7420 6d61 ck-Cover Text ma │ │ │ │ │ -00031f40: 7920 6265 2061 6464 6564 2062 7920 286f y be added by (o │ │ │ │ │ -00031f50: 720a 2020 2020 2074 6872 6f75 6768 2061 r. through a │ │ │ │ │ -00031f60: 7272 616e 6765 6d65 6e74 7320 6d61 6465 rrangements made │ │ │ │ │ -00031f70: 2062 7929 2061 6e79 206f 6e65 2065 6e74 by) any one ent │ │ │ │ │ -00031f80: 6974 792e 2020 4966 2074 6865 2044 6f63 ity. If the Doc │ │ │ │ │ -00031f90: 756d 656e 740a 2020 2020 2061 6c72 6561 ument. alrea │ │ │ │ │ -00031fa0: 6479 2069 6e63 6c75 6465 7320 6120 636f dy includes a co │ │ │ │ │ -00031fb0: 7665 7220 7465 7874 2066 6f72 2074 6865 ver text for the │ │ │ │ │ -00031fc0: 2073 616d 6520 636f 7665 722c 2070 7265 same cover, pre │ │ │ │ │ -00031fd0: 7669 6f75 736c 7920 6164 6465 640a 2020 viously added. │ │ │ │ │ -00031fe0: 2020 2062 7920 796f 7520 6f72 2062 7920 by you or by │ │ │ │ │ -00031ff0: 6172 7261 6e67 656d 656e 7420 6d61 6465 arrangement made │ │ │ │ │ -00032000: 2062 7920 7468 6520 7361 6d65 2065 6e74 by the same ent │ │ │ │ │ -00032010: 6974 7920 796f 7520 6172 6520 6163 7469 ity you are acti │ │ │ │ │ -00032020: 6e67 206f 6e0a 2020 2020 2062 6568 616c ng on. behal │ │ │ │ │ -00032030: 6620 6f66 2c20 796f 7520 6d61 7920 6e6f f of, you may no │ │ │ │ │ -00032040: 7420 6164 6420 616e 6f74 6865 723b 2062 t add another; b │ │ │ │ │ -00032050: 7574 2079 6f75 206d 6179 2072 6570 6c61 ut you may repla │ │ │ │ │ -00032060: 6365 2074 6865 206f 6c64 0a20 2020 2020 ce the old. │ │ │ │ │ -00032070: 6f6e 652c 206f 6e20 6578 706c 6963 6974 one, on explicit │ │ │ │ │ -00032080: 2070 6572 6d69 7373 696f 6e20 6672 6f6d permission from │ │ │ │ │ -00032090: 2074 6865 2070 7265 7669 6f75 7320 7075 the previous pu │ │ │ │ │ -000320a0: 626c 6973 6865 7220 7468 6174 2061 6464 blisher that add │ │ │ │ │ -000320b0: 6564 0a20 2020 2020 7468 6520 6f6c 6420 ed. the old │ │ │ │ │ -000320c0: 6f6e 652e 0a0a 2020 2020 2054 6865 2061 one... The a │ │ │ │ │ -000320d0: 7574 686f 7228 7329 2061 6e64 2070 7562 uthor(s) and pub │ │ │ │ │ -000320e0: 6c69 7368 6572 2873 2920 6f66 2074 6865 lisher(s) of the │ │ │ │ │ -000320f0: 2044 6f63 756d 656e 7420 646f 206e 6f74 Document do not │ │ │ │ │ -00032100: 2062 7920 7468 6973 0a20 2020 2020 4c69 by this. Li │ │ │ │ │ -00032110: 6365 6e73 6520 6769 7665 2070 6572 6d69 cense give permi │ │ │ │ │ -00032120: 7373 696f 6e20 746f 2075 7365 2074 6865 ssion to use the │ │ │ │ │ -00032130: 6972 206e 616d 6573 2066 6f72 2070 7562 ir names for pub │ │ │ │ │ -00032140: 6c69 6369 7479 2066 6f72 206f 7220 746f licity for or to │ │ │ │ │ -00032150: 0a20 2020 2020 6173 7365 7274 206f 7220 . assert or │ │ │ │ │ -00032160: 696d 706c 7920 656e 646f 7273 656d 656e imply endorsemen │ │ │ │ │ -00032170: 7420 6f66 2061 6e79 204d 6f64 6966 6965 t of any Modifie │ │ │ │ │ -00032180: 6420 5665 7273 696f 6e2e 0a0a 2020 352e d Version... 5. │ │ │ │ │ -00032190: 2043 4f4d 4249 4e49 4e47 2044 4f43 554d COMBINING DOCUM │ │ │ │ │ -000321a0: 454e 5453 0a0a 2020 2020 2059 6f75 206d ENTS.. You m │ │ │ │ │ -000321b0: 6179 2063 6f6d 6269 6e65 2074 6865 2044 ay combine the D │ │ │ │ │ -000321c0: 6f63 756d 656e 7420 7769 7468 206f 7468 ocument with oth │ │ │ │ │ -000321d0: 6572 2064 6f63 756d 656e 7473 2072 656c er documents rel │ │ │ │ │ -000321e0: 6561 7365 6420 756e 6465 720a 2020 2020 eased under. │ │ │ │ │ -000321f0: 2074 6869 7320 4c69 6365 6e73 652c 2075 this License, u │ │ │ │ │ -00032200: 6e64 6572 2074 6865 2074 6572 6d73 2064 nder the terms d │ │ │ │ │ -00032210: 6566 696e 6564 2069 6e20 7365 6374 696f efined in sectio │ │ │ │ │ -00032220: 6e20 3420 6162 6f76 6520 666f 720a 2020 n 4 above for. │ │ │ │ │ -00032230: 2020 206d 6f64 6966 6965 6420 7665 7273 modified vers │ │ │ │ │ -00032240: 696f 6e73 2c20 7072 6f76 6964 6564 2074 ions, provided t │ │ │ │ │ -00032250: 6861 7420 796f 7520 696e 636c 7564 6520 hat you include │ │ │ │ │ -00032260: 696e 2074 6865 2063 6f6d 6269 6e61 7469 in the combinati │ │ │ │ │ -00032270: 6f6e 2061 6c6c 0a20 2020 2020 6f66 2074 on all. of t │ │ │ │ │ -00032280: 6865 2049 6e76 6172 6961 6e74 2053 6563 he Invariant Sec │ │ │ │ │ -00032290: 7469 6f6e 7320 6f66 2061 6c6c 206f 6620 tions of all of │ │ │ │ │ -000322a0: 7468 6520 6f72 6967 696e 616c 2064 6f63 the original doc │ │ │ │ │ -000322b0: 756d 656e 7473 2c0a 2020 2020 2075 6e6d uments,. unm │ │ │ │ │ -000322c0: 6f64 6966 6965 642c 2061 6e64 206c 6973 odified, and lis │ │ │ │ │ -000322d0: 7420 7468 656d 2061 6c6c 2061 7320 496e t them all as In │ │ │ │ │ -000322e0: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -000322f0: 206f 6620 796f 7572 0a20 2020 2020 636f of your. co │ │ │ │ │ -00032300: 6d62 696e 6564 2077 6f72 6b20 696e 2069 mbined work in i │ │ │ │ │ -00032310: 7473 206c 6963 656e 7365 206e 6f74 6963 ts license notic │ │ │ │ │ -00032320: 652c 2061 6e64 2074 6861 7420 796f 7520 e, and that you │ │ │ │ │ -00032330: 7072 6573 6572 7665 2061 6c6c 0a20 2020 preserve all. │ │ │ │ │ -00032340: 2020 7468 6569 7220 5761 7272 616e 7479 their Warranty │ │ │ │ │ -00032350: 2044 6973 636c 6169 6d65 7273 2e0a 0a20 Disclaimers... │ │ │ │ │ -00032360: 2020 2020 5468 6520 636f 6d62 696e 6564 The combined │ │ │ │ │ -00032370: 2077 6f72 6b20 6e65 6564 206f 6e6c 7920 work need only │ │ │ │ │ -00032380: 636f 6e74 6169 6e20 6f6e 6520 636f 7079 contain one copy │ │ │ │ │ -00032390: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ -000323a0: 2c20 616e 640a 2020 2020 206d 756c 7469 , and. multi │ │ │ │ │ -000323b0: 706c 6520 6964 656e 7469 6361 6c20 496e ple identical In │ │ │ │ │ -000323c0: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -000323d0: 206d 6179 2062 6520 7265 706c 6163 6564 may be replaced │ │ │ │ │ -000323e0: 2077 6974 6820 6120 7369 6e67 6c65 0a20 with a single. │ │ │ │ │ -000323f0: 2020 2020 636f 7079 2e20 2049 6620 7468 copy. If th │ │ │ │ │ -00032400: 6572 6520 6172 6520 6d75 6c74 6970 6c65 ere are multiple │ │ │ │ │ -00032410: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -00032420: 6f6e 7320 7769 7468 2074 6865 2073 616d ons with the sam │ │ │ │ │ -00032430: 6520 6e61 6d65 0a20 2020 2020 6275 7420 e name. but │ │ │ │ │ -00032440: 6469 6666 6572 656e 7420 636f 6e74 656e different conten │ │ │ │ │ -00032450: 7473 2c20 6d61 6b65 2074 6865 2074 6974 ts, make the tit │ │ │ │ │ -00032460: 6c65 206f 6620 6561 6368 2073 7563 6820 le of each such │ │ │ │ │ -00032470: 7365 6374 696f 6e20 756e 6971 7565 0a20 section unique. │ │ │ │ │ -00032480: 2020 2020 6279 2061 6464 696e 6720 6174 by adding at │ │ │ │ │ -00032490: 2074 6865 2065 6e64 206f 6620 6974 2c20 the end of it, │ │ │ │ │ -000324a0: 696e 2070 6172 656e 7468 6573 6573 2c20 in parentheses, │ │ │ │ │ -000324b0: 7468 6520 6e61 6d65 206f 6620 7468 650a the name of the. │ │ │ │ │ -000324c0: 2020 2020 206f 7269 6769 6e61 6c20 6175 original au │ │ │ │ │ -000324d0: 7468 6f72 206f 7220 7075 626c 6973 6865 thor or publishe │ │ │ │ │ -000324e0: 7220 6f66 2074 6861 7420 7365 6374 696f r of that sectio │ │ │ │ │ -000324f0: 6e20 6966 206b 6e6f 776e 2c20 6f72 2065 n if known, or e │ │ │ │ │ -00032500: 6c73 6520 610a 2020 2020 2075 6e69 7175 lse a. uniqu │ │ │ │ │ -00032510: 6520 6e75 6d62 6572 2e20 204d 616b 6520 e number. Make │ │ │ │ │ -00032520: 7468 6520 7361 6d65 2061 646a 7573 746d the same adjustm │ │ │ │ │ -00032530: 656e 7420 746f 2074 6865 2073 6563 7469 ent to the secti │ │ │ │ │ -00032540: 6f6e 2074 6974 6c65 7320 696e 0a20 2020 on titles in. │ │ │ │ │ -00032550: 2020 7468 6520 6c69 7374 206f 6620 496e the list of In │ │ │ │ │ -00032560: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -00032570: 2069 6e20 7468 6520 6c69 6365 6e73 6520 in the license │ │ │ │ │ -00032580: 6e6f 7469 6365 206f 6620 7468 650a 2020 notice of the. │ │ │ │ │ -00032590: 2020 2063 6f6d 6269 6e65 6420 776f 726b combined work │ │ │ │ │ -000325a0: 2e0a 0a20 2020 2020 496e 2074 6865 2063 ... In the c │ │ │ │ │ -000325b0: 6f6d 6269 6e61 7469 6f6e 2c20 796f 7520 ombination, you │ │ │ │ │ -000325c0: 6d75 7374 2063 6f6d 6269 6e65 2061 6e79 must combine any │ │ │ │ │ -000325d0: 2073 6563 7469 6f6e 7320 456e 7469 746c sections Entitl │ │ │ │ │ -000325e0: 6564 0a20 2020 2020 2248 6973 746f 7279 ed. "History │ │ │ │ │ -000325f0: 2220 696e 2074 6865 2076 6172 696f 7573 " in the various │ │ │ │ │ -00032600: 206f 7269 6769 6e61 6c20 646f 6375 6d65 original docume │ │ │ │ │ -00032610: 6e74 732c 2066 6f72 6d69 6e67 206f 6e65 nts, forming one │ │ │ │ │ -00032620: 2073 6563 7469 6f6e 0a20 2020 2020 456e section. En │ │ │ │ │ -00032630: 7469 746c 6564 2022 4869 7374 6f72 7922 titled "History" │ │ │ │ │ -00032640: 3b20 6c69 6b65 7769 7365 2063 6f6d 6269 ; likewise combi │ │ │ │ │ -00032650: 6e65 2061 6e79 2073 6563 7469 6f6e 7320 ne any sections │ │ │ │ │ -00032660: 456e 7469 746c 6564 0a20 2020 2020 2241 Entitled. "A │ │ │ │ │ -00032670: 636b 6e6f 776c 6564 6765 6d65 6e74 7322 cknowledgements" │ │ │ │ │ -00032680: 2c20 616e 6420 616e 7920 7365 6374 696f , and any sectio │ │ │ │ │ -00032690: 6e73 2045 6e74 6974 6c65 6420 2244 6564 ns Entitled "Ded │ │ │ │ │ -000326a0: 6963 6174 696f 6e73 222e 2020 596f 750a ications". You. │ │ │ │ │ -000326b0: 2020 2020 206d 7573 7420 6465 6c65 7465 must delete │ │ │ │ │ -000326c0: 2061 6c6c 2073 6563 7469 6f6e 7320 456e all sections En │ │ │ │ │ -000326d0: 7469 746c 6564 2022 456e 646f 7273 656d titled "Endorsem │ │ │ │ │ -000326e0: 656e 7473 2e22 0a0a 2020 362e 2043 4f4c ents.".. 6. COL │ │ │ │ │ -000326f0: 4c45 4354 494f 4e53 204f 4620 444f 4355 LECTIONS OF DOCU │ │ │ │ │ -00032700: 4d45 4e54 530a 0a20 2020 2020 596f 7520 MENTS.. You │ │ │ │ │ -00032710: 6d61 7920 6d61 6b65 2061 2063 6f6c 6c65 may make a colle │ │ │ │ │ -00032720: 6374 696f 6e20 636f 6e73 6973 7469 6e67 ction consisting │ │ │ │ │ -00032730: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -00032740: 2061 6e64 206f 7468 6572 0a20 2020 2020 and other. │ │ │ │ │ -00032750: 646f 6375 6d65 6e74 7320 7265 6c65 6173 documents releas │ │ │ │ │ -00032760: 6564 2075 6e64 6572 2074 6869 7320 4c69 ed under this Li │ │ │ │ │ -00032770: 6365 6e73 652c 2061 6e64 2072 6570 6c61 cense, and repla │ │ │ │ │ -00032780: 6365 2074 6865 2069 6e64 6976 6964 7561 ce the individua │ │ │ │ │ -00032790: 6c0a 2020 2020 2063 6f70 6965 7320 6f66 l. copies of │ │ │ │ │ -000327a0: 2074 6869 7320 4c69 6365 6e73 6520 696e this License in │ │ │ │ │ -000327b0: 2074 6865 2076 6172 696f 7573 2064 6f63 the various doc │ │ │ │ │ -000327c0: 756d 656e 7473 2077 6974 6820 6120 7369 uments with a si │ │ │ │ │ -000327d0: 6e67 6c65 2063 6f70 790a 2020 2020 2074 ngle copy. t │ │ │ │ │ -000327e0: 6861 7420 6973 2069 6e63 6c75 6465 6420 hat is included │ │ │ │ │ -000327f0: 696e 2074 6865 2063 6f6c 6c65 6374 696f in the collectio │ │ │ │ │ -00032800: 6e2c 2070 726f 7669 6465 6420 7468 6174 n, provided that │ │ │ │ │ -00032810: 2079 6f75 2066 6f6c 6c6f 7720 7468 650a you follow the. │ │ │ │ │ -00032820: 2020 2020 2072 756c 6573 206f 6620 7468 rules of th │ │ │ │ │ -00032830: 6973 204c 6963 656e 7365 2066 6f72 2076 is License for v │ │ │ │ │ -00032840: 6572 6261 7469 6d20 636f 7079 696e 6720 erbatim copying │ │ │ │ │ -00032850: 6f66 2065 6163 6820 6f66 2074 6865 2064 of each of the d │ │ │ │ │ -00032860: 6f63 756d 656e 7473 0a20 2020 2020 696e ocuments. in │ │ │ │ │ -00032870: 2061 6c6c 206f 7468 6572 2072 6573 7065 all other respe │ │ │ │ │ -00032880: 6374 732e 0a0a 2020 2020 2059 6f75 206d cts... You m │ │ │ │ │ -00032890: 6179 2065 7874 7261 6374 2061 2073 696e ay extract a sin │ │ │ │ │ -000328a0: 676c 6520 646f 6375 6d65 6e74 2066 726f gle document fro │ │ │ │ │ -000328b0: 6d20 7375 6368 2061 2063 6f6c 6c65 6374 m such a collect │ │ │ │ │ -000328c0: 696f 6e2c 2061 6e64 0a20 2020 2020 6469 ion, and. di │ │ │ │ │ -000328d0: 7374 7269 6275 7465 2069 7420 696e 6469 stribute it indi │ │ │ │ │ -000328e0: 7669 6475 616c 6c79 2075 6e64 6572 2074 vidually under t │ │ │ │ │ -000328f0: 6869 7320 4c69 6365 6e73 652c 2070 726f his License, pro │ │ │ │ │ -00032900: 7669 6465 6420 796f 7520 696e 7365 7274 vided you insert │ │ │ │ │ -00032910: 0a20 2020 2020 6120 636f 7079 206f 6620 . a copy of │ │ │ │ │ -00032920: 7468 6973 204c 6963 656e 7365 2069 6e74 this License int │ │ │ │ │ -00032930: 6f20 7468 6520 6578 7472 6163 7465 6420 o the extracted │ │ │ │ │ -00032940: 646f 6375 6d65 6e74 2c20 616e 6420 666f document, and fo │ │ │ │ │ -00032950: 6c6c 6f77 2074 6869 730a 2020 2020 204c llow this. L │ │ │ │ │ -00032960: 6963 656e 7365 2069 6e20 616c 6c20 6f74 icense in all ot │ │ │ │ │ -00032970: 6865 7220 7265 7370 6563 7473 2072 6567 her respects reg │ │ │ │ │ -00032980: 6172 6469 6e67 2076 6572 6261 7469 6d20 arding verbatim │ │ │ │ │ -00032990: 636f 7079 696e 6720 6f66 2074 6861 740a copying of that. │ │ │ │ │ -000329a0: 2020 2020 2064 6f63 756d 656e 742e 0a0a document... │ │ │ │ │ -000329b0: 2020 372e 2041 4747 5245 4741 5449 4f4e 7. AGGREGATION │ │ │ │ │ -000329c0: 2057 4954 4820 494e 4445 5045 4e44 454e WITH INDEPENDEN │ │ │ │ │ -000329d0: 5420 574f 524b 530a 0a20 2020 2020 4120 T WORKS.. A │ │ │ │ │ -000329e0: 636f 6d70 696c 6174 696f 6e20 6f66 2074 compilation of t │ │ │ │ │ -000329f0: 6865 2044 6f63 756d 656e 7420 6f72 2069 he Document or i │ │ │ │ │ -00032a00: 7473 2064 6572 6976 6174 6976 6573 2077 ts derivatives w │ │ │ │ │ -00032a10: 6974 6820 6f74 6865 720a 2020 2020 2073 ith other. s │ │ │ │ │ -00032a20: 6570 6172 6174 6520 616e 6420 696e 6465 eparate and inde │ │ │ │ │ -00032a30: 7065 6e64 656e 7420 646f 6375 6d65 6e74 pendent document │ │ │ │ │ -00032a40: 7320 6f72 2077 6f72 6b73 2c20 696e 206f s or works, in o │ │ │ │ │ -00032a50: 7220 6f6e 2061 2076 6f6c 756d 6520 6f66 r on a volume of │ │ │ │ │ -00032a60: 2061 0a20 2020 2020 7374 6f72 6167 6520 a. storage │ │ │ │ │ -00032a70: 6f72 2064 6973 7472 6962 7574 696f 6e20 or distribution │ │ │ │ │ -00032a80: 6d65 6469 756d 2c20 6973 2063 616c 6c65 medium, is calle │ │ │ │ │ -00032a90: 6420 616e 2022 6167 6772 6567 6174 6522 d an "aggregate" │ │ │ │ │ -00032aa0: 2069 6620 7468 650a 2020 2020 2063 6f70 if the. cop │ │ │ │ │ -00032ab0: 7972 6967 6874 2072 6573 756c 7469 6e67 yright resulting │ │ │ │ │ -00032ac0: 2066 726f 6d20 7468 6520 636f 6d70 696c from the compil │ │ │ │ │ -00032ad0: 6174 696f 6e20 6973 206e 6f74 2075 7365 ation is not use │ │ │ │ │ -00032ae0: 6420 746f 206c 696d 6974 2074 6865 0a20 d to limit the. │ │ │ │ │ -00032af0: 2020 2020 6c65 6761 6c20 7269 6768 7473 legal rights │ │ │ │ │ -00032b00: 206f 6620 7468 6520 636f 6d70 696c 6174 of the compilat │ │ │ │ │ -00032b10: 696f 6e27 7320 7573 6572 7320 6265 796f ion's users beyo │ │ │ │ │ -00032b20: 6e64 2077 6861 7420 7468 6520 696e 6469 nd what the indi │ │ │ │ │ -00032b30: 7669 6475 616c 0a20 2020 2020 776f 726b vidual. work │ │ │ │ │ -00032b40: 7320 7065 726d 6974 2e20 2057 6865 6e20 s permit. When │ │ │ │ │ -00032b50: 7468 6520 446f 6375 6d65 6e74 2069 7320 the Document is │ │ │ │ │ -00032b60: 696e 636c 7564 6564 2069 6e20 616e 2061 included in an a │ │ │ │ │ -00032b70: 6767 7265 6761 7465 2c20 7468 6973 0a20 ggregate, this. │ │ │ │ │ -00032b80: 2020 2020 4c69 6365 6e73 6520 646f 6573 License does │ │ │ │ │ -00032b90: 206e 6f74 2061 7070 6c79 2074 6f20 7468 not apply to th │ │ │ │ │ -00032ba0: 6520 6f74 6865 7220 776f 726b 7320 696e e other works in │ │ │ │ │ -00032bb0: 2074 6865 2061 6767 7265 6761 7465 2077 the aggregate w │ │ │ │ │ -00032bc0: 6869 6368 0a20 2020 2020 6172 6520 6e6f hich. are no │ │ │ │ │ -00032bd0: 7420 7468 656d 7365 6c76 6573 2064 6572 t themselves der │ │ │ │ │ -00032be0: 6976 6174 6976 6520 776f 726b 7320 6f66 ivative works of │ │ │ │ │ -00032bf0: 2074 6865 2044 6f63 756d 656e 742e 0a0a the Document... │ │ │ │ │ -00032c00: 2020 2020 2049 6620 7468 6520 436f 7665 If the Cove │ │ │ │ │ -00032c10: 7220 5465 7874 2072 6571 7569 7265 6d65 r Text requireme │ │ │ │ │ -00032c20: 6e74 206f 6620 7365 6374 696f 6e20 3320 nt of section 3 │ │ │ │ │ -00032c30: 6973 2061 7070 6c69 6361 626c 6520 746f is applicable to │ │ │ │ │ -00032c40: 2074 6865 7365 0a20 2020 2020 636f 7069 these. copi │ │ │ │ │ -00032c50: 6573 206f 6620 7468 6520 446f 6375 6d65 es of the Docume │ │ │ │ │ -00032c60: 6e74 2c20 7468 656e 2069 6620 7468 6520 nt, then if the │ │ │ │ │ -00032c70: 446f 6375 6d65 6e74 2069 7320 6c65 7373 Document is less │ │ │ │ │ -00032c80: 2074 6861 6e20 6f6e 6520 6861 6c66 0a20 than one half. │ │ │ │ │ -00032c90: 2020 2020 6f66 2074 6865 2065 6e74 6972 of the entir │ │ │ │ │ -00032ca0: 6520 6167 6772 6567 6174 652c 2074 6865 e aggregate, the │ │ │ │ │ -00032cb0: 2044 6f63 756d 656e 7427 7320 436f 7665 Document's Cove │ │ │ │ │ -00032cc0: 7220 5465 7874 7320 6d61 7920 6265 2070 r Texts may be p │ │ │ │ │ -00032cd0: 6c61 6365 640a 2020 2020 206f 6e20 636f laced. on co │ │ │ │ │ -00032ce0: 7665 7273 2074 6861 7420 6272 6163 6b65 vers that bracke │ │ │ │ │ -00032cf0: 7420 7468 6520 446f 6375 6d65 6e74 2077 t the Document w │ │ │ │ │ -00032d00: 6974 6869 6e20 7468 6520 6167 6772 6567 ithin the aggreg │ │ │ │ │ -00032d10: 6174 652c 206f 7220 7468 650a 2020 2020 ate, or the. │ │ │ │ │ -00032d20: 2065 6c65 6374 726f 6e69 6320 6571 7569 electronic equi │ │ │ │ │ -00032d30: 7661 6c65 6e74 206f 6620 636f 7665 7273 valent of covers │ │ │ │ │ -00032d40: 2069 6620 7468 6520 446f 6375 6d65 6e74 if the Document │ │ │ │ │ -00032d50: 2069 7320 696e 2065 6c65 6374 726f 6e69 is in electroni │ │ │ │ │ -00032d60: 630a 2020 2020 2066 6f72 6d2e 2020 4f74 c. form. Ot │ │ │ │ │ -00032d70: 6865 7277 6973 6520 7468 6579 206d 7573 herwise they mus │ │ │ │ │ -00032d80: 7420 6170 7065 6172 206f 6e20 7072 696e t appear on prin │ │ │ │ │ -00032d90: 7465 6420 636f 7665 7273 2074 6861 7420 ted covers that │ │ │ │ │ -00032da0: 6272 6163 6b65 740a 2020 2020 2074 6865 bracket. the │ │ │ │ │ -00032db0: 2077 686f 6c65 2061 6767 7265 6761 7465 whole aggregate │ │ │ │ │ -00032dc0: 2e0a 0a20 2038 2e20 5452 414e 534c 4154 ... 8. TRANSLAT │ │ │ │ │ -00032dd0: 494f 4e0a 0a20 2020 2020 5472 616e 736c ION.. Transl │ │ │ │ │ -00032de0: 6174 696f 6e20 6973 2063 6f6e 7369 6465 ation is conside │ │ │ │ │ -00032df0: 7265 6420 6120 6b69 6e64 206f 6620 6d6f red a kind of mo │ │ │ │ │ -00032e00: 6469 6669 6361 7469 6f6e 2c20 736f 2079 dification, so y │ │ │ │ │ -00032e10: 6f75 206d 6179 0a20 2020 2020 6469 7374 ou may. dist │ │ │ │ │ -00032e20: 7269 6275 7465 2074 7261 6e73 6c61 7469 ribute translati │ │ │ │ │ -00032e30: 6f6e 7320 6f66 2074 6865 2044 6f63 756d ons of the Docum │ │ │ │ │ -00032e40: 656e 7420 756e 6465 7220 7468 6520 7465 ent under the te │ │ │ │ │ -00032e50: 726d 7320 6f66 2073 6563 7469 6f6e 0a20 rms of section. │ │ │ │ │ -00032e60: 2020 2020 342e 2020 5265 706c 6163 696e 4. Replacin │ │ │ │ │ -00032e70: 6720 496e 7661 7269 616e 7420 5365 6374 g Invariant Sect │ │ │ │ │ -00032e80: 696f 6e73 2077 6974 6820 7472 616e 736c ions with transl │ │ │ │ │ -00032e90: 6174 696f 6e73 2072 6571 7569 7265 7320 ations requires │ │ │ │ │ -00032ea0: 7370 6563 6961 6c0a 2020 2020 2070 6572 special. per │ │ │ │ │ -00032eb0: 6d69 7373 696f 6e20 6672 6f6d 2074 6865 mission from the │ │ │ │ │ -00032ec0: 6972 2063 6f70 7972 6967 6874 2068 6f6c ir copyright hol │ │ │ │ │ -00032ed0: 6465 7273 2c20 6275 7420 796f 7520 6d61 ders, but you ma │ │ │ │ │ -00032ee0: 7920 696e 636c 7564 650a 2020 2020 2074 y include. t │ │ │ │ │ -00032ef0: 7261 6e73 6c61 7469 6f6e 7320 6f66 2073 ranslations of s │ │ │ │ │ -00032f00: 6f6d 6520 6f72 2061 6c6c 2049 6e76 6172 ome or all Invar │ │ │ │ │ -00032f10: 6961 6e74 2053 6563 7469 6f6e 7320 696e iant Sections in │ │ │ │ │ -00032f20: 2061 6464 6974 696f 6e20 746f 2074 6865 addition to the │ │ │ │ │ -00032f30: 0a20 2020 2020 6f72 6967 696e 616c 2076 . original v │ │ │ │ │ -00032f40: 6572 7369 6f6e 7320 6f66 2074 6865 7365 ersions of these │ │ │ │ │ -00032f50: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -00032f60: 6f6e 732e 2020 596f 7520 6d61 7920 696e ons. You may in │ │ │ │ │ -00032f70: 636c 7564 6520 610a 2020 2020 2074 7261 clude a. tra │ │ │ │ │ -00032f80: 6e73 6c61 7469 6f6e 206f 6620 7468 6973 nslation of this │ │ │ │ │ -00032f90: 204c 6963 656e 7365 2c20 616e 6420 616c License, and al │ │ │ │ │ -00032fa0: 6c20 7468 6520 6c69 6365 6e73 6520 6e6f l the license no │ │ │ │ │ -00032fb0: 7469 6365 7320 696e 2074 6865 0a20 2020 tices in the. │ │ │ │ │ -00032fc0: 2020 446f 6375 6d65 6e74 2c20 616e 6420 Document, and │ │ │ │ │ -00032fd0: 616e 7920 5761 7272 616e 7479 2044 6973 any Warranty Dis │ │ │ │ │ -00032fe0: 636c 6169 6d65 7273 2c20 7072 6f76 6964 claimers, provid │ │ │ │ │ -00032ff0: 6564 2074 6861 7420 796f 7520 616c 736f ed that you also │ │ │ │ │ -00033000: 0a20 2020 2020 696e 636c 7564 6520 7468 . include th │ │ │ │ │ -00033010: 6520 6f72 6967 696e 616c 2045 6e67 6c69 e original Engli │ │ │ │ │ -00033020: 7368 2076 6572 7369 6f6e 206f 6620 7468 sh version of th │ │ │ │ │ -00033030: 6973 204c 6963 656e 7365 2061 6e64 2074 is License and t │ │ │ │ │ -00033040: 6865 0a20 2020 2020 6f72 6967 696e 616c he. original │ │ │ │ │ -00033050: 2076 6572 7369 6f6e 7320 6f66 2074 686f versions of tho │ │ │ │ │ -00033060: 7365 206e 6f74 6963 6573 2061 6e64 2064 se notices and d │ │ │ │ │ -00033070: 6973 636c 6169 6d65 7273 2e20 2049 6e20 isclaimers. In │ │ │ │ │ -00033080: 6361 7365 206f 6620 610a 2020 2020 2064 case of a. d │ │ │ │ │ -00033090: 6973 6167 7265 656d 656e 7420 6265 7477 isagreement betw │ │ │ │ │ -000330a0: 6565 6e20 7468 6520 7472 616e 736c 6174 een the translat │ │ │ │ │ -000330b0: 696f 6e20 616e 6420 7468 6520 6f72 6967 ion and the orig │ │ │ │ │ -000330c0: 696e 616c 2076 6572 7369 6f6e 206f 660a inal version of. │ │ │ │ │ -000330d0: 2020 2020 2074 6869 7320 4c69 6365 6e73 this Licens │ │ │ │ │ -000330e0: 6520 6f72 2061 206e 6f74 6963 6520 6f72 e or a notice or │ │ │ │ │ -000330f0: 2064 6973 636c 6169 6d65 722c 2074 6865 disclaimer, the │ │ │ │ │ -00033100: 206f 7269 6769 6e61 6c20 7665 7273 696f original versio │ │ │ │ │ -00033110: 6e20 7769 6c6c 0a20 2020 2020 7072 6576 n will. prev │ │ │ │ │ -00033120: 6169 6c2e 0a0a 2020 2020 2049 6620 6120 ail... If a │ │ │ │ │ -00033130: 7365 6374 696f 6e20 696e 2074 6865 2044 section in the D │ │ │ │ │ -00033140: 6f63 756d 656e 7420 6973 2045 6e74 6974 ocument is Entit │ │ │ │ │ -00033150: 6c65 6420 2241 636b 6e6f 776c 6564 6765 led "Acknowledge │ │ │ │ │ -00033160: 6d65 6e74 7322 2c0a 2020 2020 2022 4465 ments",. "De │ │ │ │ │ -00033170: 6469 6361 7469 6f6e 7322 2c20 6f72 2022 dications", or " │ │ │ │ │ -00033180: 4869 7374 6f72 7922 2c20 7468 6520 7265 History", the re │ │ │ │ │ -00033190: 7175 6972 656d 656e 7420 2873 6563 7469 quirement (secti │ │ │ │ │ -000331a0: 6f6e 2034 2920 746f 0a20 2020 2020 5072 on 4) to. Pr │ │ │ │ │ -000331b0: 6573 6572 7665 2069 7473 2054 6974 6c65 eserve its Title │ │ │ │ │ -000331c0: 2028 7365 6374 696f 6e20 3129 2077 696c (section 1) wil │ │ │ │ │ -000331d0: 6c20 7479 7069 6361 6c6c 7920 7265 7175 l typically requ │ │ │ │ │ -000331e0: 6972 6520 6368 616e 6769 6e67 2074 6865 ire changing the │ │ │ │ │ -000331f0: 0a20 2020 2020 6163 7475 616c 2074 6974 . actual tit │ │ │ │ │ -00033200: 6c65 2e0a 0a20 2039 2e20 5445 524d 494e le... 9. TERMIN │ │ │ │ │ -00033210: 4154 494f 4e0a 0a20 2020 2020 596f 7520 ATION.. You │ │ │ │ │ -00033220: 6d61 7920 6e6f 7420 636f 7079 2c20 6d6f may not copy, mo │ │ │ │ │ -00033230: 6469 6679 2c20 7375 626c 6963 656e 7365 dify, sublicense │ │ │ │ │ -00033240: 2c20 6f72 2064 6973 7472 6962 7574 6520 , or distribute │ │ │ │ │ -00033250: 7468 6520 446f 6375 6d65 6e74 0a20 2020 the Document. │ │ │ │ │ -00033260: 2020 6578 6365 7074 2061 7320 6578 7072 except as expr │ │ │ │ │ -00033270: 6573 736c 7920 7072 6f76 6964 6564 2075 essly provided u │ │ │ │ │ -00033280: 6e64 6572 2074 6869 7320 4c69 6365 6e73 nder this Licens │ │ │ │ │ -00033290: 652e 2020 416e 7920 6174 7465 6d70 740a e. Any attempt. │ │ │ │ │ -000332a0: 2020 2020 206f 7468 6572 7769 7365 2074 otherwise t │ │ │ │ │ -000332b0: 6f20 636f 7079 2c20 6d6f 6469 6679 2c20 o copy, modify, │ │ │ │ │ -000332c0: 7375 626c 6963 656e 7365 2c20 6f72 2064 sublicense, or d │ │ │ │ │ -000332d0: 6973 7472 6962 7574 6520 6974 2069 7320 istribute it is │ │ │ │ │ -000332e0: 766f 6964 2c0a 2020 2020 2061 6e64 2077 void,. and w │ │ │ │ │ -000332f0: 696c 6c20 6175 746f 6d61 7469 6361 6c6c ill automaticall │ │ │ │ │ -00033300: 7920 7465 726d 696e 6174 6520 796f 7572 y terminate your │ │ │ │ │ -00033310: 2072 6967 6874 7320 756e 6465 7220 7468 rights under th │ │ │ │ │ -00033320: 6973 204c 6963 656e 7365 2e0a 0a20 2020 is License... │ │ │ │ │ -00033330: 2020 486f 7765 7665 722c 2069 6620 796f However, if yo │ │ │ │ │ -00033340: 7520 6365 6173 6520 616c 6c20 7669 6f6c u cease all viol │ │ │ │ │ -00033350: 6174 696f 6e20 6f66 2074 6869 7320 4c69 ation of this Li │ │ │ │ │ -00033360: 6365 6e73 652c 2074 6865 6e20 796f 7572 cense, then your │ │ │ │ │ -00033370: 0a20 2020 2020 6c69 6365 6e73 6520 6672 . license fr │ │ │ │ │ -00033380: 6f6d 2061 2070 6172 7469 6375 6c61 7220 om a particular │ │ │ │ │ -00033390: 636f 7079 7269 6768 7420 686f 6c64 6572 copyright holder │ │ │ │ │ -000333a0: 2069 7320 7265 696e 7374 6174 6564 2028 is reinstated ( │ │ │ │ │ -000333b0: 6129 0a20 2020 2020 7072 6f76 6973 696f a). provisio │ │ │ │ │ -000333c0: 6e61 6c6c 792c 2075 6e6c 6573 7320 616e nally, unless an │ │ │ │ │ -000333d0: 6420 756e 7469 6c20 7468 6520 636f 7079 d until the copy │ │ │ │ │ -000333e0: 7269 6768 7420 686f 6c64 6572 2065 7870 right holder exp │ │ │ │ │ -000333f0: 6c69 6369 746c 7920 616e 640a 2020 2020 licitly and. │ │ │ │ │ -00033400: 2066 696e 616c 6c79 2074 6572 6d69 6e61 finally termina │ │ │ │ │ -00033410: 7465 7320 796f 7572 206c 6963 656e 7365 tes your license │ │ │ │ │ -00033420: 2c20 616e 6420 2862 2920 7065 726d 616e , and (b) perman │ │ │ │ │ -00033430: 656e 746c 792c 2069 6620 7468 650a 2020 ently, if the. │ │ │ │ │ -00033440: 2020 2063 6f70 7972 6967 6874 2068 6f6c copyright hol │ │ │ │ │ -00033450: 6465 7220 6661 696c 7320 746f 206e 6f74 der fails to not │ │ │ │ │ -00033460: 6966 7920 796f 7520 6f66 2074 6865 2076 ify you of the v │ │ │ │ │ -00033470: 696f 6c61 7469 6f6e 2062 7920 736f 6d65 iolation by some │ │ │ │ │ -00033480: 0a20 2020 2020 7265 6173 6f6e 6162 6c65 . reasonable │ │ │ │ │ -00033490: 206d 6561 6e73 2070 7269 6f72 2074 6f20 means prior to │ │ │ │ │ -000334a0: 3630 2064 6179 7320 6166 7465 7220 7468 60 days after th │ │ │ │ │ -000334b0: 6520 6365 7373 6174 696f 6e2e 0a0a 2020 e cessation... │ │ │ │ │ -000334c0: 2020 204d 6f72 656f 7665 722c 2079 6f75 Moreover, you │ │ │ │ │ -000334d0: 7220 6c69 6365 6e73 6520 6672 6f6d 2061 r license from a │ │ │ │ │ -000334e0: 2070 6172 7469 6375 6c61 7220 636f 7079 particular copy │ │ │ │ │ -000334f0: 7269 6768 7420 686f 6c64 6572 2069 730a right holder is. │ │ │ │ │ -00033500: 2020 2020 2072 6569 6e73 7461 7465 6420 reinstated │ │ │ │ │ -00033510: 7065 726d 616e 656e 746c 7920 6966 2074 permanently if t │ │ │ │ │ -00033520: 6865 2063 6f70 7972 6967 6874 2068 6f6c he copyright hol │ │ │ │ │ -00033530: 6465 7220 6e6f 7469 6669 6573 2079 6f75 der notifies you │ │ │ │ │ -00033540: 206f 6620 7468 650a 2020 2020 2076 696f of the. vio │ │ │ │ │ -00033550: 6c61 7469 6f6e 2062 7920 736f 6d65 2072 lation by some r │ │ │ │ │ -00033560: 6561 736f 6e61 626c 6520 6d65 616e 732c easonable means, │ │ │ │ │ -00033570: 2074 6869 7320 6973 2074 6865 2066 6972 this is the fir │ │ │ │ │ -00033580: 7374 2074 696d 6520 796f 7520 6861 7665 st time you have │ │ │ │ │ -00033590: 0a20 2020 2020 7265 6365 6976 6564 206e . received n │ │ │ │ │ -000335a0: 6f74 6963 6520 6f66 2076 696f 6c61 7469 otice of violati │ │ │ │ │ -000335b0: 6f6e 206f 6620 7468 6973 204c 6963 656e on of this Licen │ │ │ │ │ -000335c0: 7365 2028 666f 7220 616e 7920 776f 726b se (for any work │ │ │ │ │ -000335d0: 2920 6672 6f6d 0a20 2020 2020 7468 6174 ) from. that │ │ │ │ │ -000335e0: 2063 6f70 7972 6967 6874 2068 6f6c 6465 copyright holde │ │ │ │ │ -000335f0: 722c 2061 6e64 2079 6f75 2063 7572 6520 r, and you cure │ │ │ │ │ -00033600: 7468 6520 7669 6f6c 6174 696f 6e20 7072 the violation pr │ │ │ │ │ -00033610: 696f 7220 746f 2033 3020 6461 7973 0a20 ior to 30 days. │ │ │ │ │ -00033620: 2020 2020 6166 7465 7220 796f 7572 2072 after your r │ │ │ │ │ -00033630: 6563 6569 7074 206f 6620 7468 6520 6e6f eceipt of the no │ │ │ │ │ -00033640: 7469 6365 2e0a 0a20 2020 2020 5465 726d tice... Term │ │ │ │ │ -00033650: 696e 6174 696f 6e20 6f66 2079 6f75 7220 ination of your │ │ │ │ │ -00033660: 7269 6768 7473 2075 6e64 6572 2074 6869 rights under thi │ │ │ │ │ -00033670: 7320 7365 6374 696f 6e20 646f 6573 206e s section does n │ │ │ │ │ -00033680: 6f74 2074 6572 6d69 6e61 7465 0a20 2020 ot terminate. │ │ │ │ │ -00033690: 2020 7468 6520 6c69 6365 6e73 6573 206f the licenses o │ │ │ │ │ -000336a0: 6620 7061 7274 6965 7320 7768 6f20 6861 f parties who ha │ │ │ │ │ -000336b0: 7665 2072 6563 6569 7665 6420 636f 7069 ve received copi │ │ │ │ │ -000336c0: 6573 206f 7220 7269 6768 7473 2066 726f es or rights fro │ │ │ │ │ -000336d0: 6d20 796f 750a 2020 2020 2075 6e64 6572 m you. under │ │ │ │ │ -000336e0: 2074 6869 7320 4c69 6365 6e73 652e 2020 this License. │ │ │ │ │ -000336f0: 4966 2079 6f75 7220 7269 6768 7473 2068 If your rights h │ │ │ │ │ -00033700: 6176 6520 6265 656e 2074 6572 6d69 6e61 ave been termina │ │ │ │ │ -00033710: 7465 6420 616e 6420 6e6f 740a 2020 2020 ted and not. │ │ │ │ │ -00033720: 2070 6572 6d61 6e65 6e74 6c79 2072 6569 permanently rei │ │ │ │ │ -00033730: 6e73 7461 7465 642c 2072 6563 6569 7074 nstated, receipt │ │ │ │ │ -00033740: 206f 6620 6120 636f 7079 206f 6620 736f of a copy of so │ │ │ │ │ -00033750: 6d65 206f 7220 616c 6c20 6f66 2074 6865 me or all of the │ │ │ │ │ -00033760: 0a20 2020 2020 7361 6d65 206d 6174 6572 . same mater │ │ │ │ │ -00033770: 6961 6c20 646f 6573 206e 6f74 2067 6976 ial does not giv │ │ │ │ │ -00033780: 6520 796f 7520 616e 7920 7269 6768 7473 e you any rights │ │ │ │ │ -00033790: 2074 6f20 7573 6520 6974 2e0a 0a20 2031 to use it... 1 │ │ │ │ │ -000337a0: 302e 2046 5554 5552 4520 5245 5649 5349 0. FUTURE REVISI │ │ │ │ │ -000337b0: 4f4e 5320 4f46 2054 4849 5320 4c49 4345 ONS OF THIS LICE │ │ │ │ │ -000337c0: 4e53 450a 0a20 2020 2020 5468 6520 4672 NSE.. The Fr │ │ │ │ │ -000337d0: 6565 2053 6f66 7477 6172 6520 466f 756e ee Software Foun │ │ │ │ │ -000337e0: 6461 7469 6f6e 206d 6179 2070 7562 6c69 dation may publi │ │ │ │ │ -000337f0: 7368 206e 6577 2c20 7265 7669 7365 6420 sh new, revised │ │ │ │ │ -00033800: 7665 7273 696f 6e73 206f 660a 2020 2020 versions of. │ │ │ │ │ -00033810: 2074 6865 2047 4e55 2046 7265 6520 446f the GNU Free Do │ │ │ │ │ -00033820: 6375 6d65 6e74 6174 696f 6e20 4c69 6365 cumentation Lice │ │ │ │ │ -00033830: 6e73 6520 6672 6f6d 2074 696d 6520 746f nse from time to │ │ │ │ │ -00033840: 2074 696d 652e 2020 5375 6368 206e 6577 time. Such new │ │ │ │ │ -00033850: 0a20 2020 2020 7665 7273 696f 6e73 2077 . versions w │ │ │ │ │ -00033860: 696c 6c20 6265 2073 696d 696c 6172 2069 ill be similar i │ │ │ │ │ -00033870: 6e20 7370 6972 6974 2074 6f20 7468 6520 n spirit to the │ │ │ │ │ -00033880: 7072 6573 656e 7420 7665 7273 696f 6e2c present version, │ │ │ │ │ -00033890: 2062 7574 206d 6179 0a20 2020 2020 6469 but may. di │ │ │ │ │ -000338a0: 6666 6572 2069 6e20 6465 7461 696c 2074 ffer in detail t │ │ │ │ │ -000338b0: 6f20 6164 6472 6573 7320 6e65 7720 7072 o address new pr │ │ │ │ │ -000338c0: 6f62 6c65 6d73 206f 7220 636f 6e63 6572 oblems or concer │ │ │ │ │ -000338d0: 6e73 2e20 2053 6565 0a20 2020 2020 3c68 ns. See. ... │ │ │ │ │ -00033900: 2020 2020 4561 6368 2076 6572 7369 6f6e Each version │ │ │ │ │ -00033910: 206f 6620 7468 6520 4c69 6365 6e73 6520 of the License │ │ │ │ │ -00033920: 6973 2067 6976 656e 2061 2064 6973 7469 is given a disti │ │ │ │ │ -00033930: 6e67 7569 7368 696e 6720 7665 7273 696f nguishing versio │ │ │ │ │ -00033940: 6e0a 2020 2020 206e 756d 6265 722e 2020 n. number. │ │ │ │ │ -00033950: 4966 2074 6865 2044 6f63 756d 656e 7420 If the Document │ │ │ │ │ -00033960: 7370 6563 6966 6965 7320 7468 6174 2061 specifies that a │ │ │ │ │ -00033970: 2070 6172 7469 6375 6c61 7220 6e75 6d62 particular numb │ │ │ │ │ -00033980: 6572 6564 0a20 2020 2020 7665 7273 696f ered. versio │ │ │ │ │ -00033990: 6e20 6f66 2074 6869 7320 4c69 6365 6e73 n of this Licens │ │ │ │ │ -000339a0: 6520 226f 7220 616e 7920 6c61 7465 7220 e "or any later │ │ │ │ │ -000339b0: 7665 7273 696f 6e22 2061 7070 6c69 6573 version" applies │ │ │ │ │ -000339c0: 2074 6f20 6974 2c20 796f 750a 2020 2020 to it, you. │ │ │ │ │ -000339d0: 2068 6176 6520 7468 6520 6f70 7469 6f6e have the option │ │ │ │ │ -000339e0: 206f 6620 666f 6c6c 6f77 696e 6720 7468 of following th │ │ │ │ │ -000339f0: 6520 7465 726d 7320 616e 6420 636f 6e64 e terms and cond │ │ │ │ │ -00033a00: 6974 696f 6e73 2065 6974 6865 7220 6f66 itions either of │ │ │ │ │ -00033a10: 0a20 2020 2020 7468 6174 2073 7065 6369 . that speci │ │ │ │ │ -00033a20: 6669 6564 2076 6572 7369 6f6e 206f 7220 fied version or │ │ │ │ │ -00033a30: 6f66 2061 6e79 206c 6174 6572 2076 6572 of any later ver │ │ │ │ │ -00033a40: 7369 6f6e 2074 6861 7420 6861 7320 6265 sion that has be │ │ │ │ │ -00033a50: 656e 0a20 2020 2020 7075 626c 6973 6865 en. publishe │ │ │ │ │ -00033a60: 6420 286e 6f74 2061 7320 6120 6472 6166 d (not as a draf │ │ │ │ │ -00033a70: 7429 2062 7920 7468 6520 4672 6565 2053 t) by the Free S │ │ │ │ │ -00033a80: 6f66 7477 6172 6520 466f 756e 6461 7469 oftware Foundati │ │ │ │ │ -00033a90: 6f6e 2e20 2049 6620 7468 650a 2020 2020 on. If the. │ │ │ │ │ -00033aa0: 2044 6f63 756d 656e 7420 646f 6573 206e Document does n │ │ │ │ │ -00033ab0: 6f74 2073 7065 6369 6679 2061 2076 6572 ot specify a ver │ │ │ │ │ -00033ac0: 7369 6f6e 206e 756d 6265 7220 6f66 2074 sion number of t │ │ │ │ │ -00033ad0: 6869 7320 4c69 6365 6e73 652c 2079 6f75 his License, you │ │ │ │ │ -00033ae0: 206d 6179 0a20 2020 2020 6368 6f6f 7365 may. choose │ │ │ │ │ -00033af0: 2061 6e79 2076 6572 7369 6f6e 2065 7665 any version eve │ │ │ │ │ -00033b00: 7220 7075 626c 6973 6865 6420 286e 6f74 r published (not │ │ │ │ │ -00033b10: 2061 7320 6120 6472 6166 7429 2062 7920 as a draft) by │ │ │ │ │ -00033b20: 7468 6520 4672 6565 0a20 2020 2020 536f the Free. So │ │ │ │ │ -00033b30: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ │ │ -00033b40: 6e2e 2020 4966 2074 6865 2044 6f63 756d n. If the Docum │ │ │ │ │ -00033b50: 656e 7420 7370 6563 6966 6965 7320 7468 ent specifies th │ │ │ │ │ -00033b60: 6174 2061 2070 726f 7879 2063 616e 0a20 at a proxy can. │ │ │ │ │ -00033b70: 2020 2020 6465 6369 6465 2077 6869 6368 decide which │ │ │ │ │ -00033b80: 2066 7574 7572 6520 7665 7273 696f 6e73 future versions │ │ │ │ │ -00033b90: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ -00033ba0: 2063 616e 2062 6520 7573 6564 2c20 7468 can be used, th │ │ │ │ │ -00033bb0: 6174 0a20 2020 2020 7072 6f78 7927 7320 at. proxy's │ │ │ │ │ -00033bc0: 7075 626c 6963 2073 7461 7465 6d65 6e74 public statement │ │ │ │ │ -00033bd0: 206f 6620 6163 6365 7074 616e 6365 206f of acceptance o │ │ │ │ │ -00033be0: 6620 6120 7665 7273 696f 6e20 7065 726d f a version perm │ │ │ │ │ -00033bf0: 616e 656e 746c 790a 2020 2020 2061 7574 anently. aut │ │ │ │ │ -00033c00: 686f 7269 7a65 7320 796f 7520 746f 2063 horizes you to c │ │ │ │ │ -00033c10: 686f 6f73 6520 7468 6174 2076 6572 7369 hoose that versi │ │ │ │ │ -00033c20: 6f6e 2066 6f72 2074 6865 2044 6f63 756d on for the Docum │ │ │ │ │ -00033c30: 656e 742e 0a0a 2020 3131 2e20 5245 4c49 ent... 11. RELI │ │ │ │ │ -00033c40: 4345 4e53 494e 470a 0a20 2020 2020 224d CENSING.. "M │ │ │ │ │ -00033c50: 6173 7369 7665 204d 756c 7469 6175 7468 assive Multiauth │ │ │ │ │ -00033c60: 6f72 2043 6f6c 6c61 626f 7261 7469 6f6e or Collaboration │ │ │ │ │ -00033c70: 2053 6974 6522 2028 6f72 2022 4d4d 4320 Site" (or "MMC │ │ │ │ │ -00033c80: 5369 7465 2229 206d 6561 6e73 2061 6e79 Site") means any │ │ │ │ │ -00033c90: 0a20 2020 2020 576f 726c 6420 5769 6465 . World Wide │ │ │ │ │ -00033ca0: 2057 6562 2073 6572 7665 7220 7468 6174 Web server that │ │ │ │ │ -00033cb0: 2070 7562 6c69 7368 6573 2063 6f70 7972 publishes copyr │ │ │ │ │ -00033cc0: 6967 6874 6162 6c65 2077 6f72 6b73 2061 ightable works a │ │ │ │ │ -00033cd0: 6e64 2061 6c73 6f0a 2020 2020 2070 726f nd also. pro │ │ │ │ │ -00033ce0: 7669 6465 7320 7072 6f6d 696e 656e 7420 vides prominent │ │ │ │ │ -00033cf0: 6661 6369 6c69 7469 6573 2066 6f72 2061 facilities for a │ │ │ │ │ -00033d00: 6e79 626f 6479 2074 6f20 6564 6974 2074 nybody to edit t │ │ │ │ │ -00033d10: 686f 7365 2077 6f72 6b73 2e20 2041 0a20 hose works. A. │ │ │ │ │ -00033d20: 2020 2020 7075 626c 6963 2077 696b 6920 public wiki │ │ │ │ │ -00033d30: 7468 6174 2061 6e79 626f 6479 2063 616e that anybody can │ │ │ │ │ -00033d40: 2065 6469 7420 6973 2061 6e20 6578 616d edit is an exam │ │ │ │ │ -00033d50: 706c 6520 6f66 2073 7563 6820 6120 7365 ple of such a se │ │ │ │ │ -00033d60: 7276 6572 2e0a 2020 2020 2041 2022 4d61 rver.. A "Ma │ │ │ │ │ -00033d70: 7373 6976 6520 4d75 6c74 6961 7574 686f ssive Multiautho │ │ │ │ │ -00033d80: 7220 436f 6c6c 6162 6f72 6174 696f 6e22 r Collaboration" │ │ │ │ │ -00033d90: 2028 6f72 2022 4d4d 4322 2920 636f 6e74 (or "MMC") cont │ │ │ │ │ -00033da0: 6169 6e65 6420 696e 2074 6865 0a20 2020 ained in the. │ │ │ │ │ -00033db0: 2020 7369 7465 206d 6561 6e73 2061 6e79 site means any │ │ │ │ │ -00033dc0: 2073 6574 206f 6620 636f 7079 7269 6768 set of copyrigh │ │ │ │ │ -00033dd0: 7461 626c 6520 776f 726b 7320 7468 7573 table works thus │ │ │ │ │ -00033de0: 2070 7562 6c69 7368 6564 206f 6e20 7468 published on th │ │ │ │ │ -00033df0: 6520 4d4d 430a 2020 2020 2073 6974 652e e MMC. site. │ │ │ │ │ -00033e00: 0a0a 2020 2020 2022 4343 2d42 592d 5341 .. "CC-BY-SA │ │ │ │ │ -00033e10: 2220 6d65 616e 7320 7468 6520 4372 6561 " means the Crea │ │ │ │ │ -00033e20: 7469 7665 2043 6f6d 6d6f 6e73 2041 7474 tive Commons Att │ │ │ │ │ -00033e30: 7269 6275 7469 6f6e 2d53 6861 7265 2041 ribution-Share A │ │ │ │ │ -00033e40: 6c69 6b65 2033 2e30 0a20 2020 2020 6c69 like 3.0. li │ │ │ │ │ -00033e50: 6365 6e73 6520 7075 626c 6973 6865 6420 cense published │ │ │ │ │ -00033e60: 6279 2043 7265 6174 6976 6520 436f 6d6d by Creative Comm │ │ │ │ │ -00033e70: 6f6e 7320 436f 7270 6f72 6174 696f 6e2c ons Corporation, │ │ │ │ │ -00033e80: 2061 206e 6f74 2d66 6f72 2d70 726f 6669 a not-for-profi │ │ │ │ │ -00033e90: 740a 2020 2020 2063 6f72 706f 7261 7469 t. corporati │ │ │ │ │ -00033ea0: 6f6e 2077 6974 6820 6120 7072 696e 6369 on with a princi │ │ │ │ │ -00033eb0: 7061 6c20 706c 6163 6520 6f66 2062 7573 pal place of bus │ │ │ │ │ -00033ec0: 696e 6573 7320 696e 2053 616e 2046 7261 iness in San Fra │ │ │ │ │ -00033ed0: 6e63 6973 636f 2c0a 2020 2020 2043 616c ncisco,. Cal │ │ │ │ │ -00033ee0: 6966 6f72 6e69 612c 2061 7320 7765 6c6c ifornia, as well │ │ │ │ │ -00033ef0: 2061 7320 6675 7475 7265 2063 6f70 796c as future copyl │ │ │ │ │ -00033f00: 6566 7420 7665 7273 696f 6e73 206f 6620 eft versions of │ │ │ │ │ -00033f10: 7468 6174 206c 6963 656e 7365 0a20 2020 that license. │ │ │ │ │ -00033f20: 2020 7075 626c 6973 6865 6420 6279 2074 published by t │ │ │ │ │ -00033f30: 6861 7420 7361 6d65 206f 7267 616e 697a hat same organiz │ │ │ │ │ -00033f40: 6174 696f 6e2e 0a0a 2020 2020 2022 496e ation... "In │ │ │ │ │ -00033f50: 636f 7270 6f72 6174 6522 206d 6561 6e73 corporate" means │ │ │ │ │ -00033f60: 2074 6f20 7075 626c 6973 6820 6f72 2072 to publish or r │ │ │ │ │ -00033f70: 6570 7562 6c69 7368 2061 2044 6f63 756d epublish a Docum │ │ │ │ │ -00033f80: 656e 742c 2069 6e20 7768 6f6c 6520 6f72 ent, in whole or │ │ │ │ │ -00033f90: 0a20 2020 2020 696e 2070 6172 742c 2061 . in part, a │ │ │ │ │ -00033fa0: 7320 7061 7274 206f 6620 616e 6f74 6865 s part of anothe │ │ │ │ │ -00033fb0: 7220 446f 6375 6d65 6e74 2e0a 0a20 2020 r Document... │ │ │ │ │ -00033fc0: 2020 416e 204d 4d43 2069 7320 2265 6c69 An MMC is "eli │ │ │ │ │ -00033fd0: 6769 626c 6520 666f 7220 7265 6c69 6365 gible for relice │ │ │ │ │ -00033fe0: 6e73 696e 6722 2069 6620 6974 2069 7320 nsing" if it is │ │ │ │ │ -00033ff0: 6c69 6365 6e73 6564 2075 6e64 6572 2074 licensed under t │ │ │ │ │ -00034000: 6869 730a 2020 2020 204c 6963 656e 7365 his. License │ │ │ │ │ -00034010: 2c20 616e 6420 6966 2061 6c6c 2077 6f72 , and if all wor │ │ │ │ │ -00034020: 6b73 2074 6861 7420 7765 7265 2066 6972 ks that were fir │ │ │ │ │ -00034030: 7374 2070 7562 6c69 7368 6564 2075 6e64 st published und │ │ │ │ │ -00034040: 6572 2074 6869 730a 2020 2020 204c 6963 er this. Lic │ │ │ │ │ -00034050: 656e 7365 2073 6f6d 6577 6865 7265 206f ense somewhere o │ │ │ │ │ -00034060: 7468 6572 2074 6861 6e20 7468 6973 204d ther than this M │ │ │ │ │ -00034070: 4d43 2c20 616e 6420 7375 6273 6571 7565 MC, and subseque │ │ │ │ │ -00034080: 6e74 6c79 0a20 2020 2020 696e 636f 7270 ntly. incorp │ │ │ │ │ -00034090: 6f72 6174 6564 2069 6e20 7768 6f6c 6520 orated in whole │ │ │ │ │ -000340a0: 6f72 2069 6e20 7061 7274 2069 6e74 6f20 or in part into │ │ │ │ │ -000340b0: 7468 6520 4d4d 432c 2028 3129 2068 6164 the MMC, (1) had │ │ │ │ │ -000340c0: 206e 6f20 636f 7665 720a 2020 2020 2074 no cover. t │ │ │ │ │ -000340d0: 6578 7473 206f 7220 696e 7661 7269 616e exts or invarian │ │ │ │ │ -000340e0: 7420 7365 6374 696f 6e73 2c20 616e 6420 t sections, and │ │ │ │ │ -000340f0: 2832 2920 7765 7265 2074 6875 7320 696e (2) were thus in │ │ │ │ │ -00034100: 636f 7270 6f72 6174 6564 2070 7269 6f72 corporated prior │ │ │ │ │ -00034110: 0a20 2020 2020 746f 204e 6f76 656d 6265 . to Novembe │ │ │ │ │ -00034120: 7220 312c 2032 3030 382e 0a0a 2020 2020 r 1, 2008... │ │ │ │ │ -00034130: 2054 6865 206f 7065 7261 746f 7220 6f66 The operator of │ │ │ │ │ -00034140: 2061 6e20 4d4d 4320 5369 7465 206d 6179 an MMC Site may │ │ │ │ │ -00034150: 2072 6570 7562 6c69 7368 2061 6e20 4d4d republish an MM │ │ │ │ │ -00034160: 4320 636f 6e74 6169 6e65 6420 696e 2074 C contained in t │ │ │ │ │ -00034170: 6865 0a20 2020 2020 7369 7465 2075 6e64 he. site und │ │ │ │ │ -00034180: 6572 2043 432d 4259 2d53 4120 6f6e 2074 er CC-BY-SA on t │ │ │ │ │ -00034190: 6865 2073 616d 6520 7369 7465 2061 7420 he same site at │ │ │ │ │ -000341a0: 616e 7920 7469 6d65 2062 6566 6f72 6520 any time before │ │ │ │ │ -000341b0: 4175 6775 7374 2031 2c0a 2020 2020 2032 August 1,. 2 │ │ │ │ │ -000341c0: 3030 392c 2070 726f 7669 6465 6420 7468 009, provided th │ │ │ │ │ -000341d0: 6520 4d4d 4320 6973 2065 6c69 6769 626c e MMC is eligibl │ │ │ │ │ -000341e0: 6520 666f 7220 7265 6c69 6365 6e73 696e e for relicensin │ │ │ │ │ -000341f0: 672e 0a0a 4144 4445 4e44 554d 3a20 486f g...ADDENDUM: Ho │ │ │ │ │ -00034200: 7720 746f 2075 7365 2074 6869 7320 4c69 w to use this Li │ │ │ │ │ -00034210: 6365 6e73 6520 666f 7220 796f 7572 2064 cense for your d │ │ │ │ │ -00034220: 6f63 756d 656e 7473 0a3d 3d3d 3d3d 3d3d ocuments.======= │ │ │ │ │ +0002e5f0: 3d3d 3d3d 3d3d 0a0a 2020 2020 2020 2020 ======.. │ │ │ │ │ +0002e600: 2020 2020 2020 2020 2020 2020 2056 6572 Ver │ │ │ │ │ +0002e610: 7369 6f6e 2031 2e33 2c20 3320 4e6f 7665 sion 1.3, 3 Nove │ │ │ │ │ +0002e620: 6d62 6572 2032 3030 380a 0a20 2020 2020 mber 2008.. │ │ │ │ │ +0002e630: 436f 7079 7269 6768 7420 2843 2920 3230 Copyright (C) 20 │ │ │ │ │ +0002e640: 3030 2c20 3230 3031 2c20 3230 3032 2c20 00, 2001, 2002, │ │ │ │ │ +0002e650: 3230 3037 2c20 3230 3038 2046 7265 6520 2007, 2008 Free │ │ │ │ │ +0002e660: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ │ │ +0002e670: 696f 6e2c 2049 6e63 2e0a 2020 2020 203c ion, Inc.. < │ │ │ │ │ +0002e680: 6874 7470 3a2f 2f66 7366 2e6f 7267 2f3e http://fsf.org/> │ │ │ │ │ +0002e690: 0a0a 2020 2020 2045 7665 7279 6f6e 6520 .. Everyone │ │ │ │ │ +0002e6a0: 6973 2070 6572 6d69 7474 6564 2074 6f20 is permitted to │ │ │ │ │ +0002e6b0: 636f 7079 2061 6e64 2064 6973 7472 6962 copy and distrib │ │ │ │ │ +0002e6c0: 7574 6520 7665 7262 6174 696d 2063 6f70 ute verbatim cop │ │ │ │ │ +0002e6d0: 6965 730a 2020 2020 206f 6620 7468 6973 ies. of this │ │ │ │ │ +0002e6e0: 206c 6963 656e 7365 2064 6f63 756d 656e license documen │ │ │ │ │ +0002e6f0: 742c 2062 7574 2063 6861 6e67 696e 6720 t, but changing │ │ │ │ │ +0002e700: 6974 2069 7320 6e6f 7420 616c 6c6f 7765 it is not allowe │ │ │ │ │ +0002e710: 642e 0a0a 2020 302e 2050 5245 414d 424c d... 0. PREAMBL │ │ │ │ │ +0002e720: 450a 0a20 2020 2020 5468 6520 7075 7270 E.. The purp │ │ │ │ │ +0002e730: 6f73 6520 6f66 2074 6869 7320 4c69 6365 ose of this Lice │ │ │ │ │ +0002e740: 6e73 6520 6973 2074 6f20 6d61 6b65 2061 nse is to make a │ │ │ │ │ +0002e750: 206d 616e 7561 6c2c 2074 6578 7462 6f6f manual, textboo │ │ │ │ │ +0002e760: 6b2c 206f 7220 6f74 6865 720a 2020 2020 k, or other. │ │ │ │ │ +0002e770: 2066 756e 6374 696f 6e61 6c20 616e 6420 functional and │ │ │ │ │ +0002e780: 7573 6566 756c 2064 6f63 756d 656e 7420 useful document │ │ │ │ │ +0002e790: 2266 7265 6522 2069 6e20 7468 6520 7365 "free" in the se │ │ │ │ │ +0002e7a0: 6e73 6520 6f66 2066 7265 6564 6f6d 3a20 nse of freedom: │ │ │ │ │ +0002e7b0: 746f 0a20 2020 2020 6173 7375 7265 2065 to. assure e │ │ │ │ │ +0002e7c0: 7665 7279 6f6e 6520 7468 6520 6566 6665 veryone the effe │ │ │ │ │ +0002e7d0: 6374 6976 6520 6672 6565 646f 6d20 746f ctive freedom to │ │ │ │ │ +0002e7e0: 2063 6f70 7920 616e 6420 7265 6469 7374 copy and redist │ │ │ │ │ +0002e7f0: 7269 6275 7465 2069 742c 0a20 2020 2020 ribute it,. │ │ │ │ │ +0002e800: 7769 7468 206f 7220 7769 7468 6f75 7420 with or without │ │ │ │ │ +0002e810: 6d6f 6469 6679 696e 6720 6974 2c20 6569 modifying it, ei │ │ │ │ │ +0002e820: 7468 6572 2063 6f6d 6d65 7263 6961 6c6c ther commerciall │ │ │ │ │ +0002e830: 7920 6f72 0a20 2020 2020 6e6f 6e63 6f6d y or. noncom │ │ │ │ │ +0002e840: 6d65 7263 6961 6c6c 792e 2020 5365 636f mercially. Seco │ │ │ │ │ +0002e850: 6e64 6172 696c 792c 2074 6869 7320 4c69 ndarily, this Li │ │ │ │ │ +0002e860: 6365 6e73 6520 7072 6573 6572 7665 7320 cense preserves │ │ │ │ │ +0002e870: 666f 7220 7468 650a 2020 2020 2061 7574 for the. aut │ │ │ │ │ +0002e880: 686f 7220 616e 6420 7075 626c 6973 6865 hor and publishe │ │ │ │ │ +0002e890: 7220 6120 7761 7920 746f 2067 6574 2063 r a way to get c │ │ │ │ │ +0002e8a0: 7265 6469 7420 666f 7220 7468 6569 7220 redit for their │ │ │ │ │ +0002e8b0: 776f 726b 2c20 7768 696c 6520 6e6f 740a work, while not. │ │ │ │ │ +0002e8c0: 2020 2020 2062 6569 6e67 2063 6f6e 7369 being consi │ │ │ │ │ +0002e8d0: 6465 7265 6420 7265 7370 6f6e 7369 626c dered responsibl │ │ │ │ │ +0002e8e0: 6520 666f 7220 6d6f 6469 6669 6361 7469 e for modificati │ │ │ │ │ +0002e8f0: 6f6e 7320 6d61 6465 2062 7920 6f74 6865 ons made by othe │ │ │ │ │ +0002e900: 7273 2e0a 0a20 2020 2020 5468 6973 204c rs... This L │ │ │ │ │ +0002e910: 6963 656e 7365 2069 7320 6120 6b69 6e64 icense is a kind │ │ │ │ │ +0002e920: 206f 6620 2263 6f70 796c 6566 7422 2c20 of "copyleft", │ │ │ │ │ +0002e930: 7768 6963 6820 6d65 616e 7320 7468 6174 which means that │ │ │ │ │ +0002e940: 2064 6572 6976 6174 6976 650a 2020 2020 derivative. │ │ │ │ │ +0002e950: 2077 6f72 6b73 206f 6620 7468 6520 646f works of the do │ │ │ │ │ +0002e960: 6375 6d65 6e74 206d 7573 7420 7468 656d cument must them │ │ │ │ │ +0002e970: 7365 6c76 6573 2062 6520 6672 6565 2069 selves be free i │ │ │ │ │ +0002e980: 6e20 7468 6520 7361 6d65 2073 656e 7365 n the same sense │ │ │ │ │ +0002e990: 2e0a 2020 2020 2049 7420 636f 6d70 6c65 .. It comple │ │ │ │ │ +0002e9a0: 6d65 6e74 7320 7468 6520 474e 5520 4765 ments the GNU Ge │ │ │ │ │ +0002e9b0: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ │ │ +0002e9c0: 656e 7365 2c20 7768 6963 6820 6973 2061 ense, which is a │ │ │ │ │ +0002e9d0: 2063 6f70 796c 6566 740a 2020 2020 206c copyleft. l │ │ │ │ │ +0002e9e0: 6963 656e 7365 2064 6573 6967 6e65 6420 icense designed │ │ │ │ │ +0002e9f0: 666f 7220 6672 6565 2073 6f66 7477 6172 for free softwar │ │ │ │ │ +0002ea00: 652e 0a0a 2020 2020 2057 6520 6861 7665 e... We have │ │ │ │ │ +0002ea10: 2064 6573 6967 6e65 6420 7468 6973 204c designed this L │ │ │ │ │ +0002ea20: 6963 656e 7365 2069 6e20 6f72 6465 7220 icense in order │ │ │ │ │ +0002ea30: 746f 2075 7365 2069 7420 666f 7220 6d61 to use it for ma │ │ │ │ │ +0002ea40: 6e75 616c 7320 666f 720a 2020 2020 2066 nuals for. f │ │ │ │ │ +0002ea50: 7265 6520 736f 6674 7761 7265 2c20 6265 ree software, be │ │ │ │ │ +0002ea60: 6361 7573 6520 6672 6565 2073 6f66 7477 cause free softw │ │ │ │ │ +0002ea70: 6172 6520 6e65 6564 7320 6672 6565 2064 are needs free d │ │ │ │ │ +0002ea80: 6f63 756d 656e 7461 7469 6f6e 3a20 610a ocumentation: a. │ │ │ │ │ +0002ea90: 2020 2020 2066 7265 6520 7072 6f67 7261 free progra │ │ │ │ │ +0002eaa0: 6d20 7368 6f75 6c64 2063 6f6d 6520 7769 m should come wi │ │ │ │ │ +0002eab0: 7468 206d 616e 7561 6c73 2070 726f 7669 th manuals provi │ │ │ │ │ +0002eac0: 6469 6e67 2074 6865 2073 616d 6520 6672 ding the same fr │ │ │ │ │ +0002ead0: 6565 646f 6d73 0a20 2020 2020 7468 6174 eedoms. that │ │ │ │ │ +0002eae0: 2074 6865 2073 6f66 7477 6172 6520 646f the software do │ │ │ │ │ +0002eaf0: 6573 2e20 2042 7574 2074 6869 7320 4c69 es. But this Li │ │ │ │ │ +0002eb00: 6365 6e73 6520 6973 206e 6f74 206c 696d cense is not lim │ │ │ │ │ +0002eb10: 6974 6564 2074 6f0a 2020 2020 2073 6f66 ited to. sof │ │ │ │ │ +0002eb20: 7477 6172 6520 6d61 6e75 616c 733b 2069 tware manuals; i │ │ │ │ │ +0002eb30: 7420 6361 6e20 6265 2075 7365 6420 666f t can be used fo │ │ │ │ │ +0002eb40: 7220 616e 7920 7465 7874 7561 6c20 776f r any textual wo │ │ │ │ │ +0002eb50: 726b 2c20 7265 6761 7264 6c65 7373 0a20 rk, regardless. │ │ │ │ │ +0002eb60: 2020 2020 6f66 2073 7562 6a65 6374 206d of subject m │ │ │ │ │ +0002eb70: 6174 7465 7220 6f72 2077 6865 7468 6572 atter or whether │ │ │ │ │ +0002eb80: 2069 7420 6973 2070 7562 6c69 7368 6564 it is published │ │ │ │ │ +0002eb90: 2061 7320 6120 7072 696e 7465 6420 626f as a printed bo │ │ │ │ │ +0002eba0: 6f6b 2e20 2057 650a 2020 2020 2072 6563 ok. We. rec │ │ │ │ │ +0002ebb0: 6f6d 6d65 6e64 2074 6869 7320 4c69 6365 ommend this Lice │ │ │ │ │ +0002ebc0: 6e73 6520 7072 696e 6369 7061 6c6c 7920 nse principally │ │ │ │ │ +0002ebd0: 666f 7220 776f 726b 7320 7768 6f73 6520 for works whose │ │ │ │ │ +0002ebe0: 7075 7270 6f73 6520 6973 0a20 2020 2020 purpose is. │ │ │ │ │ +0002ebf0: 696e 7374 7275 6374 696f 6e20 6f72 2072 instruction or r │ │ │ │ │ +0002ec00: 6566 6572 656e 6365 2e0a 0a20 2031 2e20 eference... 1. │ │ │ │ │ +0002ec10: 4150 504c 4943 4142 494c 4954 5920 414e APPLICABILITY AN │ │ │ │ │ +0002ec20: 4420 4445 4649 4e49 5449 4f4e 530a 0a20 D DEFINITIONS.. │ │ │ │ │ +0002ec30: 2020 2020 5468 6973 204c 6963 656e 7365 This License │ │ │ │ │ +0002ec40: 2061 7070 6c69 6573 2074 6f20 616e 7920 applies to any │ │ │ │ │ +0002ec50: 6d61 6e75 616c 206f 7220 6f74 6865 7220 manual or other │ │ │ │ │ +0002ec60: 776f 726b 2c20 696e 2061 6e79 206d 6564 work, in any med │ │ │ │ │ +0002ec70: 6975 6d2c 0a20 2020 2020 7468 6174 2063 ium,. that c │ │ │ │ │ +0002ec80: 6f6e 7461 696e 7320 6120 6e6f 7469 6365 ontains a notice │ │ │ │ │ +0002ec90: 2070 6c61 6365 6420 6279 2074 6865 2063 placed by the c │ │ │ │ │ +0002eca0: 6f70 7972 6967 6874 2068 6f6c 6465 7220 opyright holder │ │ │ │ │ +0002ecb0: 7361 7969 6e67 2069 7420 6361 6e0a 2020 saying it can. │ │ │ │ │ +0002ecc0: 2020 2062 6520 6469 7374 7269 6275 7465 be distribute │ │ │ │ │ +0002ecd0: 6420 756e 6465 7220 7468 6520 7465 726d d under the term │ │ │ │ │ +0002ece0: 7320 6f66 2074 6869 7320 4c69 6365 6e73 s of this Licens │ │ │ │ │ +0002ecf0: 652e 2020 5375 6368 2061 206e 6f74 6963 e. Such a notic │ │ │ │ │ +0002ed00: 650a 2020 2020 2067 7261 6e74 7320 6120 e. grants a │ │ │ │ │ +0002ed10: 776f 726c 642d 7769 6465 2c20 726f 7961 world-wide, roya │ │ │ │ │ +0002ed20: 6c74 792d 6672 6565 206c 6963 656e 7365 lty-free license │ │ │ │ │ +0002ed30: 2c20 756e 6c69 6d69 7465 6420 696e 2064 , unlimited in d │ │ │ │ │ +0002ed40: 7572 6174 696f 6e2c 0a20 2020 2020 746f uration,. to │ │ │ │ │ +0002ed50: 2075 7365 2074 6861 7420 776f 726b 2075 use that work u │ │ │ │ │ +0002ed60: 6e64 6572 2074 6865 2063 6f6e 6469 7469 nder the conditi │ │ │ │ │ +0002ed70: 6f6e 7320 7374 6174 6564 2068 6572 6569 ons stated herei │ │ │ │ │ +0002ed80: 6e2e 2020 5468 650a 2020 2020 2022 446f n. The. "Do │ │ │ │ │ +0002ed90: 6375 6d65 6e74 222c 2062 656c 6f77 2c20 cument", below, │ │ │ │ │ +0002eda0: 7265 6665 7273 2074 6f20 616e 7920 7375 refers to any su │ │ │ │ │ +0002edb0: 6368 206d 616e 7561 6c20 6f72 2077 6f72 ch manual or wor │ │ │ │ │ +0002edc0: 6b2e 2020 416e 7920 6d65 6d62 6572 0a20 k. Any member. │ │ │ │ │ +0002edd0: 2020 2020 6f66 2074 6865 2070 7562 6c69 of the publi │ │ │ │ │ +0002ede0: 6320 6973 2061 206c 6963 656e 7365 652c c is a licensee, │ │ │ │ │ +0002edf0: 2061 6e64 2069 7320 6164 6472 6573 7365 and is addresse │ │ │ │ │ +0002ee00: 6420 6173 2022 796f 7522 2e20 2059 6f75 d as "you". You │ │ │ │ │ +0002ee10: 2061 6363 6570 740a 2020 2020 2074 6865 accept. the │ │ │ │ │ +0002ee20: 206c 6963 656e 7365 2069 6620 796f 7520 license if you │ │ │ │ │ +0002ee30: 636f 7079 2c20 6d6f 6469 6679 206f 7220 copy, modify or │ │ │ │ │ +0002ee40: 6469 7374 7269 6275 7465 2074 6865 2077 distribute the w │ │ │ │ │ +0002ee50: 6f72 6b20 696e 2061 2077 6179 0a20 2020 ork in a way. │ │ │ │ │ +0002ee60: 2020 7265 7175 6972 696e 6720 7065 726d requiring perm │ │ │ │ │ +0002ee70: 6973 7369 6f6e 2075 6e64 6572 2063 6f70 ission under cop │ │ │ │ │ +0002ee80: 7972 6967 6874 206c 6177 2e0a 0a20 2020 yright law... │ │ │ │ │ +0002ee90: 2020 4120 224d 6f64 6966 6965 6420 5665 A "Modified Ve │ │ │ │ │ +0002eea0: 7273 696f 6e22 206f 6620 7468 6520 446f rsion" of the Do │ │ │ │ │ +0002eeb0: 6375 6d65 6e74 206d 6561 6e73 2061 6e79 cument means any │ │ │ │ │ +0002eec0: 2077 6f72 6b20 636f 6e74 6169 6e69 6e67 work containing │ │ │ │ │ +0002eed0: 2074 6865 0a20 2020 2020 446f 6375 6d65 the. Docume │ │ │ │ │ +0002eee0: 6e74 206f 7220 6120 706f 7274 696f 6e20 nt or a portion │ │ │ │ │ +0002eef0: 6f66 2069 742c 2065 6974 6865 7220 636f of it, either co │ │ │ │ │ +0002ef00: 7069 6564 2076 6572 6261 7469 6d2c 206f pied verbatim, o │ │ │ │ │ +0002ef10: 7220 7769 7468 0a20 2020 2020 6d6f 6469 r with. modi │ │ │ │ │ +0002ef20: 6669 6361 7469 6f6e 7320 616e 642f 6f72 fications and/or │ │ │ │ │ +0002ef30: 2074 7261 6e73 6c61 7465 6420 696e 746f translated into │ │ │ │ │ +0002ef40: 2061 6e6f 7468 6572 206c 616e 6775 6167 another languag │ │ │ │ │ +0002ef50: 652e 0a0a 2020 2020 2041 2022 5365 636f e... A "Seco │ │ │ │ │ +0002ef60: 6e64 6172 7920 5365 6374 696f 6e22 2069 ndary Section" i │ │ │ │ │ +0002ef70: 7320 6120 6e61 6d65 6420 6170 7065 6e64 s a named append │ │ │ │ │ +0002ef80: 6978 206f 7220 6120 6672 6f6e 742d 6d61 ix or a front-ma │ │ │ │ │ +0002ef90: 7474 6572 2073 6563 7469 6f6e 0a20 2020 tter section. │ │ │ │ │ +0002efa0: 2020 6f66 2074 6865 2044 6f63 756d 656e of the Documen │ │ │ │ │ +0002efb0: 7420 7468 6174 2064 6561 6c73 2065 7863 t that deals exc │ │ │ │ │ +0002efc0: 6c75 7369 7665 6c79 2077 6974 6820 7468 lusively with th │ │ │ │ │ +0002efd0: 6520 7265 6c61 7469 6f6e 7368 6970 206f e relationship o │ │ │ │ │ +0002efe0: 6620 7468 650a 2020 2020 2070 7562 6c69 f the. publi │ │ │ │ │ +0002eff0: 7368 6572 7320 6f72 2061 7574 686f 7273 shers or authors │ │ │ │ │ +0002f000: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ +0002f010: 2074 6f20 7468 6520 446f 6375 6d65 6e74 to the Document │ │ │ │ │ +0002f020: 2773 206f 7665 7261 6c6c 0a20 2020 2020 's overall. │ │ │ │ │ +0002f030: 7375 626a 6563 7420 286f 7220 746f 2072 subject (or to r │ │ │ │ │ +0002f040: 656c 6174 6564 206d 6174 7465 7273 2920 elated matters) │ │ │ │ │ +0002f050: 616e 6420 636f 6e74 6169 6e73 206e 6f74 and contains not │ │ │ │ │ +0002f060: 6869 6e67 2074 6861 7420 636f 756c 640a hing that could. │ │ │ │ │ +0002f070: 2020 2020 2066 616c 6c20 6469 7265 6374 fall direct │ │ │ │ │ +0002f080: 6c79 2077 6974 6869 6e20 7468 6174 206f ly within that o │ │ │ │ │ +0002f090: 7665 7261 6c6c 2073 7562 6a65 6374 2e20 verall subject. │ │ │ │ │ +0002f0a0: 2028 5468 7573 2c20 6966 2074 6865 2044 (Thus, if the D │ │ │ │ │ +0002f0b0: 6f63 756d 656e 740a 2020 2020 2069 7320 ocument. is │ │ │ │ │ +0002f0c0: 696e 2070 6172 7420 6120 7465 7874 626f in part a textbo │ │ │ │ │ +0002f0d0: 6f6b 206f 6620 6d61 7468 656d 6174 6963 ok of mathematic │ │ │ │ │ +0002f0e0: 732c 2061 2053 6563 6f6e 6461 7279 2053 s, a Secondary S │ │ │ │ │ +0002f0f0: 6563 7469 6f6e 206d 6179 206e 6f74 0a20 ection may not. │ │ │ │ │ +0002f100: 2020 2020 6578 706c 6169 6e20 616e 7920 explain any │ │ │ │ │ +0002f110: 6d61 7468 656d 6174 6963 732e 2920 2054 mathematics.) T │ │ │ │ │ +0002f120: 6865 2072 656c 6174 696f 6e73 6869 7020 he relationship │ │ │ │ │ +0002f130: 636f 756c 6420 6265 2061 206d 6174 7465 could be a matte │ │ │ │ │ +0002f140: 7220 6f66 0a20 2020 2020 6869 7374 6f72 r of. histor │ │ │ │ │ +0002f150: 6963 616c 2063 6f6e 6e65 6374 696f 6e20 ical connection │ │ │ │ │ +0002f160: 7769 7468 2074 6865 2073 7562 6a65 6374 with the subject │ │ │ │ │ +0002f170: 206f 7220 7769 7468 2072 656c 6174 6564 or with related │ │ │ │ │ +0002f180: 206d 6174 7465 7273 2c20 6f72 0a20 2020 matters, or. │ │ │ │ │ +0002f190: 2020 6f66 206c 6567 616c 2c20 636f 6d6d of legal, comm │ │ │ │ │ +0002f1a0: 6572 6369 616c 2c20 7068 696c 6f73 6f70 ercial, philosop │ │ │ │ │ +0002f1b0: 6869 6361 6c2c 2065 7468 6963 616c 206f hical, ethical o │ │ │ │ │ +0002f1c0: 7220 706f 6c69 7469 6361 6c20 706f 7369 r political posi │ │ │ │ │ +0002f1d0: 7469 6f6e 0a20 2020 2020 7265 6761 7264 tion. regard │ │ │ │ │ +0002f1e0: 696e 6720 7468 656d 2e0a 0a20 2020 2020 ing them... │ │ │ │ │ +0002f1f0: 5468 6520 2249 6e76 6172 6961 6e74 2053 The "Invariant S │ │ │ │ │ +0002f200: 6563 7469 6f6e 7322 2061 7265 2063 6572 ections" are cer │ │ │ │ │ +0002f210: 7461 696e 2053 6563 6f6e 6461 7279 2053 tain Secondary S │ │ │ │ │ +0002f220: 6563 7469 6f6e 7320 7768 6f73 650a 2020 ections whose. │ │ │ │ │ +0002f230: 2020 2074 6974 6c65 7320 6172 6520 6465 titles are de │ │ │ │ │ +0002f240: 7369 676e 6174 6564 2c20 6173 2062 6569 signated, as bei │ │ │ │ │ +0002f250: 6e67 2074 686f 7365 206f 6620 496e 7661 ng those of Inva │ │ │ │ │ +0002f260: 7269 616e 7420 5365 6374 696f 6e73 2c20 riant Sections, │ │ │ │ │ +0002f270: 696e 2074 6865 0a20 2020 2020 6e6f 7469 in the. noti │ │ │ │ │ +0002f280: 6365 2074 6861 7420 7361 7973 2074 6861 ce that says tha │ │ │ │ │ +0002f290: 7420 7468 6520 446f 6375 6d65 6e74 2069 t the Document i │ │ │ │ │ +0002f2a0: 7320 7265 6c65 6173 6564 2075 6e64 6572 s released under │ │ │ │ │ +0002f2b0: 2074 6869 7320 4c69 6365 6e73 652e 0a20 this License.. │ │ │ │ │ +0002f2c0: 2020 2020 4966 2061 2073 6563 7469 6f6e If a section │ │ │ │ │ +0002f2d0: 2064 6f65 7320 6e6f 7420 6669 7420 7468 does not fit th │ │ │ │ │ +0002f2e0: 6520 6162 6f76 6520 6465 6669 6e69 7469 e above definiti │ │ │ │ │ +0002f2f0: 6f6e 206f 6620 5365 636f 6e64 6172 7920 on of Secondary │ │ │ │ │ +0002f300: 7468 656e 2069 740a 2020 2020 2069 7320 then it. is │ │ │ │ │ +0002f310: 6e6f 7420 616c 6c6f 7765 6420 746f 2062 not allowed to b │ │ │ │ │ +0002f320: 6520 6465 7369 676e 6174 6564 2061 7320 e designated as │ │ │ │ │ +0002f330: 496e 7661 7269 616e 742e 2020 5468 6520 Invariant. The │ │ │ │ │ +0002f340: 446f 6375 6d65 6e74 206d 6179 0a20 2020 Document may. │ │ │ │ │ +0002f350: 2020 636f 6e74 6169 6e20 7a65 726f 2049 contain zero I │ │ │ │ │ +0002f360: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +0002f370: 732e 2020 4966 2074 6865 2044 6f63 756d s. If the Docum │ │ │ │ │ +0002f380: 656e 7420 646f 6573 206e 6f74 2069 6465 ent does not ide │ │ │ │ │ +0002f390: 6e74 6966 790a 2020 2020 2061 6e79 2049 ntify. any I │ │ │ │ │ +0002f3a0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +0002f3b0: 7320 7468 656e 2074 6865 7265 2061 7265 s then there are │ │ │ │ │ +0002f3c0: 206e 6f6e 652e 0a0a 2020 2020 2054 6865 none... The │ │ │ │ │ +0002f3d0: 2022 436f 7665 7220 5465 7874 7322 2061 "Cover Texts" a │ │ │ │ │ +0002f3e0: 7265 2063 6572 7461 696e 2073 686f 7274 re certain short │ │ │ │ │ +0002f3f0: 2070 6173 7361 6765 7320 6f66 2074 6578 passages of tex │ │ │ │ │ +0002f400: 7420 7468 6174 2061 7265 0a20 2020 2020 t that are. │ │ │ │ │ +0002f410: 6c69 7374 6564 2c20 6173 2046 726f 6e74 listed, as Front │ │ │ │ │ +0002f420: 2d43 6f76 6572 2054 6578 7473 206f 7220 -Cover Texts or │ │ │ │ │ +0002f430: 4261 636b 2d43 6f76 6572 2054 6578 7473 Back-Cover Texts │ │ │ │ │ +0002f440: 2c20 696e 2074 6865 206e 6f74 6963 650a , in the notice. │ │ │ │ │ +0002f450: 2020 2020 2074 6861 7420 7361 7973 2074 that says t │ │ │ │ │ +0002f460: 6861 7420 7468 6520 446f 6375 6d65 6e74 hat the Document │ │ │ │ │ +0002f470: 2069 7320 7265 6c65 6173 6564 2075 6e64 is released und │ │ │ │ │ +0002f480: 6572 2074 6869 7320 4c69 6365 6e73 652e er this License. │ │ │ │ │ +0002f490: 2020 410a 2020 2020 2046 726f 6e74 2d43 A. Front-C │ │ │ │ │ +0002f4a0: 6f76 6572 2054 6578 7420 6d61 7920 6265 over Text may be │ │ │ │ │ +0002f4b0: 2061 7420 6d6f 7374 2035 2077 6f72 6473 at most 5 words │ │ │ │ │ +0002f4c0: 2c20 616e 6420 6120 4261 636b 2d43 6f76 , and a Back-Cov │ │ │ │ │ +0002f4d0: 6572 2054 6578 7420 6d61 790a 2020 2020 er Text may. │ │ │ │ │ +0002f4e0: 2062 6520 6174 206d 6f73 7420 3235 2077 be at most 25 w │ │ │ │ │ +0002f4f0: 6f72 6473 2e0a 0a20 2020 2020 4120 2254 ords... A "T │ │ │ │ │ +0002f500: 7261 6e73 7061 7265 6e74 2220 636f 7079 ransparent" copy │ │ │ │ │ +0002f510: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ +0002f520: 206d 6561 6e73 2061 206d 6163 6869 6e65 means a machine │ │ │ │ │ +0002f530: 2d72 6561 6461 626c 6520 636f 7079 2c0a -readable copy,. │ │ │ │ │ +0002f540: 2020 2020 2072 6570 7265 7365 6e74 6564 represented │ │ │ │ │ +0002f550: 2069 6e20 6120 666f 726d 6174 2077 686f in a format who │ │ │ │ │ +0002f560: 7365 2073 7065 6369 6669 6361 7469 6f6e se specification │ │ │ │ │ +0002f570: 2069 7320 6176 6169 6c61 626c 6520 746f is available to │ │ │ │ │ +0002f580: 2074 6865 0a20 2020 2020 6765 6e65 7261 the. genera │ │ │ │ │ +0002f590: 6c20 7075 626c 6963 2c20 7468 6174 2069 l public, that i │ │ │ │ │ +0002f5a0: 7320 7375 6974 6162 6c65 2066 6f72 2072 s suitable for r │ │ │ │ │ +0002f5b0: 6576 6973 696e 6720 7468 6520 646f 6375 evising the docu │ │ │ │ │ +0002f5c0: 6d65 6e74 0a20 2020 2020 7374 7261 6967 ment. straig │ │ │ │ │ +0002f5d0: 6874 666f 7277 6172 646c 7920 7769 7468 htforwardly with │ │ │ │ │ +0002f5e0: 2067 656e 6572 6963 2074 6578 7420 6564 generic text ed │ │ │ │ │ +0002f5f0: 6974 6f72 7320 6f72 2028 666f 7220 696d itors or (for im │ │ │ │ │ +0002f600: 6167 6573 2063 6f6d 706f 7365 640a 2020 ages composed. │ │ │ │ │ +0002f610: 2020 206f 6620 7069 7865 6c73 2920 6765 of pixels) ge │ │ │ │ │ +0002f620: 6e65 7269 6320 7061 696e 7420 7072 6f67 neric paint prog │ │ │ │ │ +0002f630: 7261 6d73 206f 7220 2866 6f72 2064 7261 rams or (for dra │ │ │ │ │ +0002f640: 7769 6e67 7329 2073 6f6d 6520 7769 6465 wings) some wide │ │ │ │ │ +0002f650: 6c79 0a20 2020 2020 6176 6169 6c61 626c ly. availabl │ │ │ │ │ +0002f660: 6520 6472 6177 696e 6720 6564 6974 6f72 e drawing editor │ │ │ │ │ +0002f670: 2c20 616e 6420 7468 6174 2069 7320 7375 , and that is su │ │ │ │ │ +0002f680: 6974 6162 6c65 2066 6f72 2069 6e70 7574 itable for input │ │ │ │ │ +0002f690: 2074 6f20 7465 7874 0a20 2020 2020 666f to text. fo │ │ │ │ │ +0002f6a0: 726d 6174 7465 7273 206f 7220 666f 7220 rmatters or for │ │ │ │ │ +0002f6b0: 6175 746f 6d61 7469 6320 7472 616e 736c automatic transl │ │ │ │ │ +0002f6c0: 6174 696f 6e20 746f 2061 2076 6172 6965 ation to a varie │ │ │ │ │ +0002f6d0: 7479 206f 6620 666f 726d 6174 730a 2020 ty of formats. │ │ │ │ │ +0002f6e0: 2020 2073 7569 7461 626c 6520 666f 7220 suitable for │ │ │ │ │ +0002f6f0: 696e 7075 7420 746f 2074 6578 7420 666f input to text fo │ │ │ │ │ +0002f700: 726d 6174 7465 7273 2e20 2041 2063 6f70 rmatters. A cop │ │ │ │ │ +0002f710: 7920 6d61 6465 2069 6e20 616e 206f 7468 y made in an oth │ │ │ │ │ +0002f720: 6572 7769 7365 0a20 2020 2020 5472 616e erwise. Tran │ │ │ │ │ +0002f730: 7370 6172 656e 7420 6669 6c65 2066 6f72 sparent file for │ │ │ │ │ +0002f740: 6d61 7420 7768 6f73 6520 6d61 726b 7570 mat whose markup │ │ │ │ │ +0002f750: 2c20 6f72 2061 6273 656e 6365 206f 6620 , or absence of │ │ │ │ │ +0002f760: 6d61 726b 7570 2c20 6861 730a 2020 2020 markup, has. │ │ │ │ │ +0002f770: 2062 6565 6e20 6172 7261 6e67 6564 2074 been arranged t │ │ │ │ │ +0002f780: 6f20 7468 7761 7274 206f 7220 6469 7363 o thwart or disc │ │ │ │ │ +0002f790: 6f75 7261 6765 2073 7562 7365 7175 656e ourage subsequen │ │ │ │ │ +0002f7a0: 7420 6d6f 6469 6669 6361 7469 6f6e 2062 t modification b │ │ │ │ │ +0002f7b0: 790a 2020 2020 2072 6561 6465 7273 2069 y. readers i │ │ │ │ │ +0002f7c0: 7320 6e6f 7420 5472 616e 7370 6172 656e s not Transparen │ │ │ │ │ +0002f7d0: 742e 2020 416e 2069 6d61 6765 2066 6f72 t. An image for │ │ │ │ │ +0002f7e0: 6d61 7420 6973 206e 6f74 2054 7261 6e73 mat is not Trans │ │ │ │ │ +0002f7f0: 7061 7265 6e74 2069 660a 2020 2020 2075 parent if. u │ │ │ │ │ +0002f800: 7365 6420 666f 7220 616e 7920 7375 6273 sed for any subs │ │ │ │ │ +0002f810: 7461 6e74 6961 6c20 616d 6f75 6e74 206f tantial amount o │ │ │ │ │ +0002f820: 6620 7465 7874 2e20 2041 2063 6f70 7920 f text. A copy │ │ │ │ │ +0002f830: 7468 6174 2069 7320 6e6f 740a 2020 2020 that is not. │ │ │ │ │ +0002f840: 2022 5472 616e 7370 6172 656e 7422 2069 "Transparent" i │ │ │ │ │ +0002f850: 7320 6361 6c6c 6564 2022 4f70 6171 7565 s called "Opaque │ │ │ │ │ +0002f860: 222e 0a0a 2020 2020 2045 7861 6d70 6c65 "... Example │ │ │ │ │ +0002f870: 7320 6f66 2073 7569 7461 626c 6520 666f s of suitable fo │ │ │ │ │ +0002f880: 726d 6174 7320 666f 7220 5472 616e 7370 rmats for Transp │ │ │ │ │ +0002f890: 6172 656e 7420 636f 7069 6573 2069 6e63 arent copies inc │ │ │ │ │ +0002f8a0: 6c75 6465 2070 6c61 696e 0a20 2020 2020 lude plain. │ │ │ │ │ +0002f8b0: 4153 4349 4920 7769 7468 6f75 7420 6d61 ASCII without ma │ │ │ │ │ +0002f8c0: 726b 7570 2c20 5465 7869 6e66 6f20 696e rkup, Texinfo in │ │ │ │ │ +0002f8d0: 7075 7420 666f 726d 6174 2c20 4c61 5465 put format, LaTe │ │ │ │ │ +0002f8e0: 5820 696e 7075 7420 666f 726d 6174 2c0a X input format,. │ │ │ │ │ +0002f8f0: 2020 2020 2053 474d 4c20 6f72 2058 4d4c SGML or XML │ │ │ │ │ +0002f900: 2075 7369 6e67 2061 2070 7562 6c69 636c using a publicl │ │ │ │ │ +0002f910: 7920 6176 6169 6c61 626c 6520 4454 442c y available DTD, │ │ │ │ │ +0002f920: 2061 6e64 2073 7461 6e64 6172 642d 636f and standard-co │ │ │ │ │ +0002f930: 6e66 6f72 6d69 6e67 0a20 2020 2020 7369 nforming. si │ │ │ │ │ +0002f940: 6d70 6c65 2048 544d 4c2c 2050 6f73 7453 mple HTML, PostS │ │ │ │ │ +0002f950: 6372 6970 7420 6f72 2050 4446 2064 6573 cript or PDF des │ │ │ │ │ +0002f960: 6967 6e65 6420 666f 7220 6875 6d61 6e20 igned for human │ │ │ │ │ +0002f970: 6d6f 6469 6669 6361 7469 6f6e 2e0a 2020 modification.. │ │ │ │ │ +0002f980: 2020 2045 7861 6d70 6c65 7320 6f66 2074 Examples of t │ │ │ │ │ +0002f990: 7261 6e73 7061 7265 6e74 2069 6d61 6765 ransparent image │ │ │ │ │ +0002f9a0: 2066 6f72 6d61 7473 2069 6e63 6c75 6465 formats include │ │ │ │ │ +0002f9b0: 2050 4e47 2c20 5843 4620 616e 6420 4a50 PNG, XCF and JP │ │ │ │ │ +0002f9c0: 472e 0a20 2020 2020 4f70 6171 7565 2066 G.. Opaque f │ │ │ │ │ +0002f9d0: 6f72 6d61 7473 2069 6e63 6c75 6465 2070 ormats include p │ │ │ │ │ +0002f9e0: 726f 7072 6965 7461 7279 2066 6f72 6d61 roprietary forma │ │ │ │ │ +0002f9f0: 7473 2074 6861 7420 6361 6e20 6265 2072 ts that can be r │ │ │ │ │ +0002fa00: 6561 6420 616e 640a 2020 2020 2065 6469 ead and. edi │ │ │ │ │ +0002fa10: 7465 6420 6f6e 6c79 2062 7920 7072 6f70 ted only by prop │ │ │ │ │ +0002fa20: 7269 6574 6172 7920 776f 7264 2070 726f rietary word pro │ │ │ │ │ +0002fa30: 6365 7373 6f72 732c 2053 474d 4c20 6f72 cessors, SGML or │ │ │ │ │ +0002fa40: 2058 4d4c 2066 6f72 2077 6869 6368 0a20 XML for which. │ │ │ │ │ +0002fa50: 2020 2020 7468 6520 4454 4420 616e 642f the DTD and/ │ │ │ │ │ +0002fa60: 6f72 2070 726f 6365 7373 696e 6720 746f or processing to │ │ │ │ │ +0002fa70: 6f6c 7320 6172 6520 6e6f 7420 6765 6e65 ols are not gene │ │ │ │ │ +0002fa80: 7261 6c6c 7920 6176 6169 6c61 626c 652c rally available, │ │ │ │ │ +0002fa90: 2061 6e64 0a20 2020 2020 7468 6520 6d61 and. the ma │ │ │ │ │ +0002faa0: 6368 696e 652d 6765 6e65 7261 7465 6420 chine-generated │ │ │ │ │ +0002fab0: 4854 4d4c 2c20 506f 7374 5363 7269 7074 HTML, PostScript │ │ │ │ │ +0002fac0: 206f 7220 5044 4620 7072 6f64 7563 6564 or PDF produced │ │ │ │ │ +0002fad0: 2062 7920 736f 6d65 2077 6f72 640a 2020 by some word. │ │ │ │ │ +0002fae0: 2020 2070 726f 6365 7373 6f72 7320 666f processors fo │ │ │ │ │ +0002faf0: 7220 6f75 7470 7574 2070 7572 706f 7365 r output purpose │ │ │ │ │ +0002fb00: 7320 6f6e 6c79 2e0a 0a20 2020 2020 5468 s only... Th │ │ │ │ │ +0002fb10: 6520 2254 6974 6c65 2050 6167 6522 206d e "Title Page" m │ │ │ │ │ +0002fb20: 6561 6e73 2c20 666f 7220 6120 7072 696e eans, for a prin │ │ │ │ │ +0002fb30: 7465 6420 626f 6f6b 2c20 7468 6520 7469 ted book, the ti │ │ │ │ │ +0002fb40: 746c 6520 7061 6765 2069 7473 656c 662c tle page itself, │ │ │ │ │ +0002fb50: 0a20 2020 2020 706c 7573 2073 7563 6820 . plus such │ │ │ │ │ +0002fb60: 666f 6c6c 6f77 696e 6720 7061 6765 7320 following pages │ │ │ │ │ +0002fb70: 6173 2061 7265 206e 6565 6465 6420 746f as are needed to │ │ │ │ │ +0002fb80: 2068 6f6c 642c 206c 6567 6962 6c79 2c20 hold, legibly, │ │ │ │ │ +0002fb90: 7468 650a 2020 2020 206d 6174 6572 6961 the. materia │ │ │ │ │ +0002fba0: 6c20 7468 6973 204c 6963 656e 7365 2072 l this License r │ │ │ │ │ +0002fbb0: 6571 7569 7265 7320 746f 2061 7070 6561 equires to appea │ │ │ │ │ +0002fbc0: 7220 696e 2074 6865 2074 6974 6c65 2070 r in the title p │ │ │ │ │ +0002fbd0: 6167 652e 2020 466f 720a 2020 2020 2077 age. For. w │ │ │ │ │ +0002fbe0: 6f72 6b73 2069 6e20 666f 726d 6174 7320 orks in formats │ │ │ │ │ +0002fbf0: 7768 6963 6820 646f 206e 6f74 2068 6176 which do not hav │ │ │ │ │ +0002fc00: 6520 616e 7920 7469 746c 6520 7061 6765 e any title page │ │ │ │ │ +0002fc10: 2061 7320 7375 6368 2c20 2254 6974 6c65 as such, "Title │ │ │ │ │ +0002fc20: 0a20 2020 2020 5061 6765 2220 6d65 616e . Page" mean │ │ │ │ │ +0002fc30: 7320 7468 6520 7465 7874 206e 6561 7220 s the text near │ │ │ │ │ +0002fc40: 7468 6520 6d6f 7374 2070 726f 6d69 6e65 the most promine │ │ │ │ │ +0002fc50: 6e74 2061 7070 6561 7261 6e63 6520 6f66 nt appearance of │ │ │ │ │ +0002fc60: 2074 6865 0a20 2020 2020 776f 726b 2773 the. work's │ │ │ │ │ +0002fc70: 2074 6974 6c65 2c20 7072 6563 6564 696e title, precedin │ │ │ │ │ +0002fc80: 6720 7468 6520 6265 6769 6e6e 696e 6720 g the beginning │ │ │ │ │ +0002fc90: 6f66 2074 6865 2062 6f64 7920 6f66 2074 of the body of t │ │ │ │ │ +0002fca0: 6865 2074 6578 742e 0a0a 2020 2020 2054 he text... T │ │ │ │ │ +0002fcb0: 6865 2022 7075 626c 6973 6865 7222 206d he "publisher" m │ │ │ │ │ +0002fcc0: 6561 6e73 2061 6e79 2070 6572 736f 6e20 eans any person │ │ │ │ │ +0002fcd0: 6f72 2065 6e74 6974 7920 7468 6174 2064 or entity that d │ │ │ │ │ +0002fce0: 6973 7472 6962 7574 6573 2063 6f70 6965 istributes copie │ │ │ │ │ +0002fcf0: 730a 2020 2020 206f 6620 7468 6520 446f s. of the Do │ │ │ │ │ +0002fd00: 6375 6d65 6e74 2074 6f20 7468 6520 7075 cument to the pu │ │ │ │ │ +0002fd10: 626c 6963 2e0a 0a20 2020 2020 4120 7365 blic... A se │ │ │ │ │ +0002fd20: 6374 696f 6e20 2245 6e74 6974 6c65 6420 ction "Entitled │ │ │ │ │ +0002fd30: 5859 5a22 206d 6561 6e73 2061 206e 616d XYZ" means a nam │ │ │ │ │ +0002fd40: 6564 2073 7562 756e 6974 206f 6620 7468 ed subunit of th │ │ │ │ │ +0002fd50: 6520 446f 6375 6d65 6e74 0a20 2020 2020 e Document. │ │ │ │ │ +0002fd60: 7768 6f73 6520 7469 746c 6520 6569 7468 whose title eith │ │ │ │ │ +0002fd70: 6572 2069 7320 7072 6563 6973 656c 7920 er is precisely │ │ │ │ │ +0002fd80: 5859 5a20 6f72 2063 6f6e 7461 696e 7320 XYZ or contains │ │ │ │ │ +0002fd90: 5859 5a20 696e 2070 6172 656e 7468 6573 XYZ in parenthes │ │ │ │ │ +0002fda0: 6573 0a20 2020 2020 666f 6c6c 6f77 696e es. followin │ │ │ │ │ +0002fdb0: 6720 7465 7874 2074 6861 7420 7472 616e g text that tran │ │ │ │ │ +0002fdc0: 736c 6174 6573 2058 595a 2069 6e20 616e slates XYZ in an │ │ │ │ │ +0002fdd0: 6f74 6865 7220 6c61 6e67 7561 6765 2e20 other language. │ │ │ │ │ +0002fde0: 2028 4865 7265 2058 595a 0a20 2020 2020 (Here XYZ. │ │ │ │ │ +0002fdf0: 7374 616e 6473 2066 6f72 2061 2073 7065 stands for a spe │ │ │ │ │ +0002fe00: 6369 6669 6320 7365 6374 696f 6e20 6e61 cific section na │ │ │ │ │ +0002fe10: 6d65 206d 656e 7469 6f6e 6564 2062 656c me mentioned bel │ │ │ │ │ +0002fe20: 6f77 2c20 7375 6368 2061 730a 2020 2020 ow, such as. │ │ │ │ │ +0002fe30: 2022 4163 6b6e 6f77 6c65 6467 656d 656e "Acknowledgemen │ │ │ │ │ +0002fe40: 7473 222c 2022 4465 6469 6361 7469 6f6e ts", "Dedication │ │ │ │ │ +0002fe50: 7322 2c20 2245 6e64 6f72 7365 6d65 6e74 s", "Endorsement │ │ │ │ │ +0002fe60: 7322 2c20 6f72 2022 4869 7374 6f72 7922 s", or "History" │ │ │ │ │ +0002fe70: 2e29 0a20 2020 2020 546f 2022 5072 6573 .). To "Pres │ │ │ │ │ +0002fe80: 6572 7665 2074 6865 2054 6974 6c65 2220 erve the Title" │ │ │ │ │ +0002fe90: 6f66 2073 7563 6820 6120 7365 6374 696f of such a sectio │ │ │ │ │ +0002fea0: 6e20 7768 656e 2079 6f75 206d 6f64 6966 n when you modif │ │ │ │ │ +0002feb0: 7920 7468 650a 2020 2020 2044 6f63 756d y the. Docum │ │ │ │ │ +0002fec0: 656e 7420 6d65 616e 7320 7468 6174 2069 ent means that i │ │ │ │ │ +0002fed0: 7420 7265 6d61 696e 7320 6120 7365 6374 t remains a sect │ │ │ │ │ +0002fee0: 696f 6e20 2245 6e74 6974 6c65 6420 5859 ion "Entitled XY │ │ │ │ │ +0002fef0: 5a22 2061 6363 6f72 6469 6e67 0a20 2020 Z" according. │ │ │ │ │ +0002ff00: 2020 746f 2074 6869 7320 6465 6669 6e69 to this defini │ │ │ │ │ +0002ff10: 7469 6f6e 2e0a 0a20 2020 2020 5468 6520 tion... The │ │ │ │ │ +0002ff20: 446f 6375 6d65 6e74 206d 6179 2069 6e63 Document may inc │ │ │ │ │ +0002ff30: 6c75 6465 2057 6172 7261 6e74 7920 4469 lude Warranty Di │ │ │ │ │ +0002ff40: 7363 6c61 696d 6572 7320 6e65 7874 2074 sclaimers next t │ │ │ │ │ +0002ff50: 6f20 7468 6520 6e6f 7469 6365 0a20 2020 o the notice. │ │ │ │ │ +0002ff60: 2020 7768 6963 6820 7374 6174 6573 2074 which states t │ │ │ │ │ +0002ff70: 6861 7420 7468 6973 204c 6963 656e 7365 hat this License │ │ │ │ │ +0002ff80: 2061 7070 6c69 6573 2074 6f20 7468 6520 applies to the │ │ │ │ │ +0002ff90: 446f 6375 6d65 6e74 2e20 2054 6865 7365 Document. These │ │ │ │ │ +0002ffa0: 0a20 2020 2020 5761 7272 616e 7479 2044 . Warranty D │ │ │ │ │ +0002ffb0: 6973 636c 6169 6d65 7273 2061 7265 2063 isclaimers are c │ │ │ │ │ +0002ffc0: 6f6e 7369 6465 7265 6420 746f 2062 6520 onsidered to be │ │ │ │ │ +0002ffd0: 696e 636c 7564 6564 2062 7920 7265 6665 included by refe │ │ │ │ │ +0002ffe0: 7265 6e63 6520 696e 0a20 2020 2020 7468 rence in. th │ │ │ │ │ +0002fff0: 6973 204c 6963 656e 7365 2c20 6275 7420 is License, but │ │ │ │ │ +00030000: 6f6e 6c79 2061 7320 7265 6761 7264 7320 only as regards │ │ │ │ │ +00030010: 6469 7363 6c61 696d 696e 6720 7761 7272 disclaiming warr │ │ │ │ │ +00030020: 616e 7469 6573 3a20 616e 7920 6f74 6865 anties: any othe │ │ │ │ │ +00030030: 720a 2020 2020 2069 6d70 6c69 6361 7469 r. implicati │ │ │ │ │ +00030040: 6f6e 2074 6861 7420 7468 6573 6520 5761 on that these Wa │ │ │ │ │ +00030050: 7272 616e 7479 2044 6973 636c 6169 6d65 rranty Disclaime │ │ │ │ │ +00030060: 7273 206d 6179 2068 6176 6520 6973 2076 rs may have is v │ │ │ │ │ +00030070: 6f69 6420 616e 640a 2020 2020 2068 6173 oid and. has │ │ │ │ │ +00030080: 206e 6f20 6566 6665 6374 206f 6e20 7468 no effect on th │ │ │ │ │ +00030090: 6520 6d65 616e 696e 6720 6f66 2074 6869 e meaning of thi │ │ │ │ │ +000300a0: 7320 4c69 6365 6e73 652e 0a0a 2020 322e s License... 2. │ │ │ │ │ +000300b0: 2056 4552 4241 5449 4d20 434f 5059 494e VERBATIM COPYIN │ │ │ │ │ +000300c0: 470a 0a20 2020 2020 596f 7520 6d61 7920 G.. You may │ │ │ │ │ +000300d0: 636f 7079 2061 6e64 2064 6973 7472 6962 copy and distrib │ │ │ │ │ +000300e0: 7574 6520 7468 6520 446f 6375 6d65 6e74 ute the Document │ │ │ │ │ +000300f0: 2069 6e20 616e 7920 6d65 6469 756d 2c20 in any medium, │ │ │ │ │ +00030100: 6569 7468 6572 0a20 2020 2020 636f 6d6d either. comm │ │ │ │ │ +00030110: 6572 6369 616c 6c79 206f 7220 6e6f 6e63 ercially or nonc │ │ │ │ │ +00030120: 6f6d 6d65 7263 6961 6c6c 792c 2070 726f ommercially, pro │ │ │ │ │ +00030130: 7669 6465 6420 7468 6174 2074 6869 7320 vided that this │ │ │ │ │ +00030140: 4c69 6365 6e73 652c 2074 6865 0a20 2020 License, the. │ │ │ │ │ +00030150: 2020 636f 7079 7269 6768 7420 6e6f 7469 copyright noti │ │ │ │ │ +00030160: 6365 732c 2061 6e64 2074 6865 206c 6963 ces, and the lic │ │ │ │ │ +00030170: 656e 7365 206e 6f74 6963 6520 7361 7969 ense notice sayi │ │ │ │ │ +00030180: 6e67 2074 6869 7320 4c69 6365 6e73 650a ng this License. │ │ │ │ │ +00030190: 2020 2020 2061 7070 6c69 6573 2074 6f20 applies to │ │ │ │ │ +000301a0: 7468 6520 446f 6375 6d65 6e74 2061 7265 the Document are │ │ │ │ │ +000301b0: 2072 6570 726f 6475 6365 6420 696e 2061 reproduced in a │ │ │ │ │ +000301c0: 6c6c 2063 6f70 6965 732c 2061 6e64 2074 ll copies, and t │ │ │ │ │ +000301d0: 6861 7420 796f 750a 2020 2020 2061 6464 hat you. add │ │ │ │ │ +000301e0: 206e 6f20 6f74 6865 7220 636f 6e64 6974 no other condit │ │ │ │ │ +000301f0: 696f 6e73 2077 6861 7473 6f65 7665 7220 ions whatsoever │ │ │ │ │ +00030200: 746f 2074 686f 7365 206f 6620 7468 6973 to those of this │ │ │ │ │ +00030210: 204c 6963 656e 7365 2e20 2059 6f75 0a20 License. You. │ │ │ │ │ +00030220: 2020 2020 6d61 7920 6e6f 7420 7573 6520 may not use │ │ │ │ │ +00030230: 7465 6368 6e69 6361 6c20 6d65 6173 7572 technical measur │ │ │ │ │ +00030240: 6573 2074 6f20 6f62 7374 7275 6374 206f es to obstruct o │ │ │ │ │ +00030250: 7220 636f 6e74 726f 6c20 7468 6520 7265 r control the re │ │ │ │ │ +00030260: 6164 696e 670a 2020 2020 206f 7220 6675 ading. or fu │ │ │ │ │ +00030270: 7274 6865 7220 636f 7079 696e 6720 6f66 rther copying of │ │ │ │ │ +00030280: 2074 6865 2063 6f70 6965 7320 796f 7520 the copies you │ │ │ │ │ +00030290: 6d61 6b65 206f 7220 6469 7374 7269 6275 make or distribu │ │ │ │ │ +000302a0: 7465 2e20 2048 6f77 6576 6572 2c0a 2020 te. However,. │ │ │ │ │ +000302b0: 2020 2079 6f75 206d 6179 2061 6363 6570 you may accep │ │ │ │ │ +000302c0: 7420 636f 6d70 656e 7361 7469 6f6e 2069 t compensation i │ │ │ │ │ +000302d0: 6e20 6578 6368 616e 6765 2066 6f72 2063 n exchange for c │ │ │ │ │ +000302e0: 6f70 6965 732e 2020 4966 2079 6f75 0a20 opies. If you. │ │ │ │ │ +000302f0: 2020 2020 6469 7374 7269 6275 7465 2061 distribute a │ │ │ │ │ +00030300: 206c 6172 6765 2065 6e6f 7567 6820 6e75 large enough nu │ │ │ │ │ +00030310: 6d62 6572 206f 6620 636f 7069 6573 2079 mber of copies y │ │ │ │ │ +00030320: 6f75 206d 7573 7420 616c 736f 2066 6f6c ou must also fol │ │ │ │ │ +00030330: 6c6f 7720 7468 650a 2020 2020 2063 6f6e low the. con │ │ │ │ │ +00030340: 6469 7469 6f6e 7320 696e 2073 6563 7469 ditions in secti │ │ │ │ │ +00030350: 6f6e 2033 2e0a 0a20 2020 2020 596f 7520 on 3... You │ │ │ │ │ +00030360: 6d61 7920 616c 736f 206c 656e 6420 636f may also lend co │ │ │ │ │ +00030370: 7069 6573 2c20 756e 6465 7220 7468 6520 pies, under the │ │ │ │ │ +00030380: 7361 6d65 2063 6f6e 6469 7469 6f6e 7320 same conditions │ │ │ │ │ +00030390: 7374 6174 6564 2061 626f 7665 2c0a 2020 stated above,. │ │ │ │ │ +000303a0: 2020 2061 6e64 2079 6f75 206d 6179 2070 and you may p │ │ │ │ │ +000303b0: 7562 6c69 636c 7920 6469 7370 6c61 7920 ublicly display │ │ │ │ │ +000303c0: 636f 7069 6573 2e0a 0a20 2033 2e20 434f copies... 3. CO │ │ │ │ │ +000303d0: 5059 494e 4720 494e 2051 5541 4e54 4954 PYING IN QUANTIT │ │ │ │ │ +000303e0: 590a 0a20 2020 2020 4966 2079 6f75 2070 Y.. If you p │ │ │ │ │ +000303f0: 7562 6c69 7368 2070 7269 6e74 6564 2063 ublish printed c │ │ │ │ │ +00030400: 6f70 6965 7320 286f 7220 636f 7069 6573 opies (or copies │ │ │ │ │ +00030410: 2069 6e20 6d65 6469 6120 7468 6174 2063 in media that c │ │ │ │ │ +00030420: 6f6d 6d6f 6e6c 790a 2020 2020 2068 6176 ommonly. hav │ │ │ │ │ +00030430: 6520 7072 696e 7465 6420 636f 7665 7273 e printed covers │ │ │ │ │ +00030440: 2920 6f66 2074 6865 2044 6f63 756d 656e ) of the Documen │ │ │ │ │ +00030450: 742c 206e 756d 6265 7269 6e67 206d 6f72 t, numbering mor │ │ │ │ │ +00030460: 6520 7468 616e 2031 3030 2c20 616e 640a e than 100, and. │ │ │ │ │ +00030470: 2020 2020 2074 6865 2044 6f63 756d 656e the Documen │ │ │ │ │ +00030480: 7427 7320 6c69 6365 6e73 6520 6e6f 7469 t's license noti │ │ │ │ │ +00030490: 6365 2072 6571 7569 7265 7320 436f 7665 ce requires Cove │ │ │ │ │ +000304a0: 7220 5465 7874 732c 2079 6f75 206d 7573 r Texts, you mus │ │ │ │ │ +000304b0: 740a 2020 2020 2065 6e63 6c6f 7365 2074 t. enclose t │ │ │ │ │ +000304c0: 6865 2063 6f70 6965 7320 696e 2063 6f76 he copies in cov │ │ │ │ │ +000304d0: 6572 7320 7468 6174 2063 6172 7279 2c20 ers that carry, │ │ │ │ │ +000304e0: 636c 6561 726c 7920 616e 6420 6c65 6769 clearly and legi │ │ │ │ │ +000304f0: 626c 792c 2061 6c6c 0a20 2020 2020 7468 bly, all. th │ │ │ │ │ +00030500: 6573 6520 436f 7665 7220 5465 7874 733a ese Cover Texts: │ │ │ │ │ +00030510: 2046 726f 6e74 2d43 6f76 6572 2054 6578 Front-Cover Tex │ │ │ │ │ +00030520: 7473 206f 6e20 7468 6520 6672 6f6e 7420 ts on the front │ │ │ │ │ +00030530: 636f 7665 722c 2061 6e64 0a20 2020 2020 cover, and. │ │ │ │ │ +00030540: 4261 636b 2d43 6f76 6572 2054 6578 7473 Back-Cover Texts │ │ │ │ │ +00030550: 206f 6e20 7468 6520 6261 636b 2063 6f76 on the back cov │ │ │ │ │ +00030560: 6572 2e20 2042 6f74 6820 636f 7665 7273 er. Both covers │ │ │ │ │ +00030570: 206d 7573 7420 616c 736f 2063 6c65 6172 must also clear │ │ │ │ │ +00030580: 6c79 0a20 2020 2020 616e 6420 6c65 6769 ly. and legi │ │ │ │ │ +00030590: 626c 7920 6964 656e 7469 6679 2079 6f75 bly identify you │ │ │ │ │ +000305a0: 2061 7320 7468 6520 7075 626c 6973 6865 as the publishe │ │ │ │ │ +000305b0: 7220 6f66 2074 6865 7365 2063 6f70 6965 r of these copie │ │ │ │ │ +000305c0: 732e 2020 5468 650a 2020 2020 2066 726f s. The. fro │ │ │ │ │ +000305d0: 6e74 2063 6f76 6572 206d 7573 7420 7072 nt cover must pr │ │ │ │ │ +000305e0: 6573 656e 7420 7468 6520 6675 6c6c 2074 esent the full t │ │ │ │ │ +000305f0: 6974 6c65 2077 6974 6820 616c 6c20 776f itle with all wo │ │ │ │ │ +00030600: 7264 7320 6f66 2074 6865 2074 6974 6c65 rds of the title │ │ │ │ │ +00030610: 0a20 2020 2020 6571 7561 6c6c 7920 7072 . equally pr │ │ │ │ │ +00030620: 6f6d 696e 656e 7420 616e 6420 7669 7369 ominent and visi │ │ │ │ │ +00030630: 626c 652e 2020 596f 7520 6d61 7920 6164 ble. You may ad │ │ │ │ │ +00030640: 6420 6f74 6865 7220 6d61 7465 7269 616c d other material │ │ │ │ │ +00030650: 206f 6e20 7468 650a 2020 2020 2063 6f76 on the. cov │ │ │ │ │ +00030660: 6572 7320 696e 2061 6464 6974 696f 6e2e ers in addition. │ │ │ │ │ +00030670: 2020 436f 7079 696e 6720 7769 7468 2063 Copying with c │ │ │ │ │ +00030680: 6861 6e67 6573 206c 696d 6974 6564 2074 hanges limited t │ │ │ │ │ +00030690: 6f20 7468 6520 636f 7665 7273 2c20 6173 o the covers, as │ │ │ │ │ +000306a0: 0a20 2020 2020 6c6f 6e67 2061 7320 7468 . long as th │ │ │ │ │ +000306b0: 6579 2070 7265 7365 7276 6520 7468 6520 ey preserve the │ │ │ │ │ +000306c0: 7469 746c 6520 6f66 2074 6865 2044 6f63 title of the Doc │ │ │ │ │ +000306d0: 756d 656e 7420 616e 6420 7361 7469 7366 ument and satisf │ │ │ │ │ +000306e0: 7920 7468 6573 650a 2020 2020 2063 6f6e y these. con │ │ │ │ │ +000306f0: 6469 7469 6f6e 732c 2063 616e 2062 6520 ditions, can be │ │ │ │ │ +00030700: 7472 6561 7465 6420 6173 2076 6572 6261 treated as verba │ │ │ │ │ +00030710: 7469 6d20 636f 7079 696e 6720 696e 206f tim copying in o │ │ │ │ │ +00030720: 7468 6572 2072 6573 7065 6374 732e 0a0a ther respects... │ │ │ │ │ +00030730: 2020 2020 2049 6620 7468 6520 7265 7175 If the requ │ │ │ │ │ +00030740: 6972 6564 2074 6578 7473 2066 6f72 2065 ired texts for e │ │ │ │ │ +00030750: 6974 6865 7220 636f 7665 7220 6172 6520 ither cover are │ │ │ │ │ +00030760: 746f 6f20 766f 6c75 6d69 6e6f 7573 2074 too voluminous t │ │ │ │ │ +00030770: 6f20 6669 740a 2020 2020 206c 6567 6962 o fit. legib │ │ │ │ │ +00030780: 6c79 2c20 796f 7520 7368 6f75 6c64 2070 ly, you should p │ │ │ │ │ +00030790: 7574 2074 6865 2066 6972 7374 206f 6e65 ut the first one │ │ │ │ │ +000307a0: 7320 6c69 7374 6564 2028 6173 206d 616e s listed (as man │ │ │ │ │ +000307b0: 7920 6173 2066 6974 0a20 2020 2020 7265 y as fit. re │ │ │ │ │ +000307c0: 6173 6f6e 6162 6c79 2920 6f6e 2074 6865 asonably) on the │ │ │ │ │ +000307d0: 2061 6374 7561 6c20 636f 7665 722c 2061 actual cover, a │ │ │ │ │ +000307e0: 6e64 2063 6f6e 7469 6e75 6520 7468 6520 nd continue the │ │ │ │ │ +000307f0: 7265 7374 206f 6e74 6f0a 2020 2020 2061 rest onto. a │ │ │ │ │ +00030800: 646a 6163 656e 7420 7061 6765 732e 0a0a djacent pages... │ │ │ │ │ +00030810: 2020 2020 2049 6620 796f 7520 7075 626c If you publ │ │ │ │ │ +00030820: 6973 6820 6f72 2064 6973 7472 6962 7574 ish or distribut │ │ │ │ │ +00030830: 6520 4f70 6171 7565 2063 6f70 6965 7320 e Opaque copies │ │ │ │ │ +00030840: 6f66 2074 6865 2044 6f63 756d 656e 740a of the Document. │ │ │ │ │ +00030850: 2020 2020 206e 756d 6265 7269 6e67 206d numbering m │ │ │ │ │ +00030860: 6f72 6520 7468 616e 2031 3030 2c20 796f ore than 100, yo │ │ │ │ │ +00030870: 7520 6d75 7374 2065 6974 6865 7220 696e u must either in │ │ │ │ │ +00030880: 636c 7564 6520 6120 6d61 6368 696e 652d clude a machine- │ │ │ │ │ +00030890: 7265 6164 6162 6c65 0a20 2020 2020 5472 readable. Tr │ │ │ │ │ +000308a0: 616e 7370 6172 656e 7420 636f 7079 2061 ansparent copy a │ │ │ │ │ +000308b0: 6c6f 6e67 2077 6974 6820 6561 6368 204f long with each O │ │ │ │ │ +000308c0: 7061 7175 6520 636f 7079 2c20 6f72 2073 paque copy, or s │ │ │ │ │ +000308d0: 7461 7465 2069 6e20 6f72 2077 6974 680a tate in or with. │ │ │ │ │ +000308e0: 2020 2020 2065 6163 6820 4f70 6171 7565 each Opaque │ │ │ │ │ +000308f0: 2063 6f70 7920 6120 636f 6d70 7574 6572 copy a computer │ │ │ │ │ +00030900: 2d6e 6574 776f 726b 206c 6f63 6174 696f -network locatio │ │ │ │ │ +00030910: 6e20 6672 6f6d 2077 6869 6368 2074 6865 n from which the │ │ │ │ │ +00030920: 2067 656e 6572 616c 0a20 2020 2020 6e65 general. ne │ │ │ │ │ +00030930: 7477 6f72 6b2d 7573 696e 6720 7075 626c twork-using publ │ │ │ │ │ +00030940: 6963 2068 6173 2061 6363 6573 7320 746f ic has access to │ │ │ │ │ +00030950: 2064 6f77 6e6c 6f61 6420 7573 696e 6720 download using │ │ │ │ │ +00030960: 7075 626c 6963 2d73 7461 6e64 6172 640a public-standard. │ │ │ │ │ +00030970: 2020 2020 206e 6574 776f 726b 2070 726f network pro │ │ │ │ │ +00030980: 746f 636f 6c73 2061 2063 6f6d 706c 6574 tocols a complet │ │ │ │ │ +00030990: 6520 5472 616e 7370 6172 656e 7420 636f e Transparent co │ │ │ │ │ +000309a0: 7079 206f 6620 7468 6520 446f 6375 6d65 py of the Docume │ │ │ │ │ +000309b0: 6e74 2c20 6672 6565 0a20 2020 2020 6f66 nt, free. of │ │ │ │ │ +000309c0: 2061 6464 6564 206d 6174 6572 6961 6c2e added material. │ │ │ │ │ +000309d0: 2020 4966 2079 6f75 2075 7365 2074 6865 If you use the │ │ │ │ │ +000309e0: 206c 6174 7465 7220 6f70 7469 6f6e 2c20 latter option, │ │ │ │ │ +000309f0: 796f 7520 6d75 7374 2074 616b 650a 2020 you must take. │ │ │ │ │ +00030a00: 2020 2072 6561 736f 6e61 626c 7920 7072 reasonably pr │ │ │ │ │ +00030a10: 7564 656e 7420 7374 6570 732c 2077 6865 udent steps, whe │ │ │ │ │ +00030a20: 6e20 796f 7520 6265 6769 6e20 6469 7374 n you begin dist │ │ │ │ │ +00030a30: 7269 6275 7469 6f6e 206f 6620 4f70 6171 ribution of Opaq │ │ │ │ │ +00030a40: 7565 0a20 2020 2020 636f 7069 6573 2069 ue. copies i │ │ │ │ │ +00030a50: 6e20 7175 616e 7469 7479 2c20 746f 2065 n quantity, to e │ │ │ │ │ +00030a60: 6e73 7572 6520 7468 6174 2074 6869 7320 nsure that this │ │ │ │ │ +00030a70: 5472 616e 7370 6172 656e 7420 636f 7079 Transparent copy │ │ │ │ │ +00030a80: 2077 696c 6c0a 2020 2020 2072 656d 6169 will. remai │ │ │ │ │ +00030a90: 6e20 7468 7573 2061 6363 6573 7369 626c n thus accessibl │ │ │ │ │ +00030aa0: 6520 6174 2074 6865 2073 7461 7465 6420 e at the stated │ │ │ │ │ +00030ab0: 6c6f 6361 7469 6f6e 2075 6e74 696c 2061 location until a │ │ │ │ │ +00030ac0: 7420 6c65 6173 7420 6f6e 650a 2020 2020 t least one. │ │ │ │ │ +00030ad0: 2079 6561 7220 6166 7465 7220 7468 6520 year after the │ │ │ │ │ +00030ae0: 6c61 7374 2074 696d 6520 796f 7520 6469 last time you di │ │ │ │ │ +00030af0: 7374 7269 6275 7465 2061 6e20 4f70 6171 stribute an Opaq │ │ │ │ │ +00030b00: 7565 2063 6f70 7920 2864 6972 6563 746c ue copy (directl │ │ │ │ │ +00030b10: 7920 6f72 0a20 2020 2020 7468 726f 7567 y or. throug │ │ │ │ │ +00030b20: 6820 796f 7572 2061 6765 6e74 7320 6f72 h your agents or │ │ │ │ │ +00030b30: 2072 6574 6169 6c65 7273 2920 6f66 2074 retailers) of t │ │ │ │ │ +00030b40: 6861 7420 6564 6974 696f 6e20 746f 2074 hat edition to t │ │ │ │ │ +00030b50: 6865 2070 7562 6c69 632e 0a0a 2020 2020 he public... │ │ │ │ │ +00030b60: 2049 7420 6973 2072 6571 7565 7374 6564 It is requested │ │ │ │ │ +00030b70: 2c20 6275 7420 6e6f 7420 7265 7175 6972 , but not requir │ │ │ │ │ +00030b80: 6564 2c20 7468 6174 2079 6f75 2063 6f6e ed, that you con │ │ │ │ │ +00030b90: 7461 6374 2074 6865 2061 7574 686f 7273 tact the authors │ │ │ │ │ +00030ba0: 206f 660a 2020 2020 2074 6865 2044 6f63 of. the Doc │ │ │ │ │ +00030bb0: 756d 656e 7420 7765 6c6c 2062 6566 6f72 ument well befor │ │ │ │ │ +00030bc0: 6520 7265 6469 7374 7269 6275 7469 6e67 e redistributing │ │ │ │ │ +00030bd0: 2061 6e79 206c 6172 6765 206e 756d 6265 any large numbe │ │ │ │ │ +00030be0: 7220 6f66 2063 6f70 6965 732c 0a20 2020 r of copies,. │ │ │ │ │ +00030bf0: 2020 746f 2067 6976 6520 7468 656d 2061 to give them a │ │ │ │ │ +00030c00: 2063 6861 6e63 6520 746f 2070 726f 7669 chance to provi │ │ │ │ │ +00030c10: 6465 2079 6f75 2077 6974 6820 616e 2075 de you with an u │ │ │ │ │ +00030c20: 7064 6174 6564 2076 6572 7369 6f6e 206f pdated version o │ │ │ │ │ +00030c30: 6620 7468 650a 2020 2020 2044 6f63 756d f the. Docum │ │ │ │ │ +00030c40: 656e 742e 0a0a 2020 342e 204d 4f44 4946 ent... 4. MODIF │ │ │ │ │ +00030c50: 4943 4154 494f 4e53 0a0a 2020 2020 2059 ICATIONS.. Y │ │ │ │ │ +00030c60: 6f75 206d 6179 2063 6f70 7920 616e 6420 ou may copy and │ │ │ │ │ +00030c70: 6469 7374 7269 6275 7465 2061 204d 6f64 distribute a Mod │ │ │ │ │ +00030c80: 6966 6965 6420 5665 7273 696f 6e20 6f66 ified Version of │ │ │ │ │ +00030c90: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ │ +00030ca0: 2020 2075 6e64 6572 2074 6865 2063 6f6e under the con │ │ │ │ │ +00030cb0: 6469 7469 6f6e 7320 6f66 2073 6563 7469 ditions of secti │ │ │ │ │ +00030cc0: 6f6e 7320 3220 616e 6420 3320 6162 6f76 ons 2 and 3 abov │ │ │ │ │ +00030cd0: 652c 2070 726f 7669 6465 6420 7468 6174 e, provided that │ │ │ │ │ +00030ce0: 2079 6f75 0a20 2020 2020 7265 6c65 6173 you. releas │ │ │ │ │ +00030cf0: 6520 7468 6520 4d6f 6469 6669 6564 2056 e the Modified V │ │ │ │ │ +00030d00: 6572 7369 6f6e 2075 6e64 6572 2070 7265 ersion under pre │ │ │ │ │ +00030d10: 6369 7365 6c79 2074 6869 7320 4c69 6365 cisely this Lice │ │ │ │ │ +00030d20: 6e73 652c 2077 6974 6820 7468 650a 2020 nse, with the. │ │ │ │ │ +00030d30: 2020 204d 6f64 6966 6965 6420 5665 7273 Modified Vers │ │ │ │ │ +00030d40: 696f 6e20 6669 6c6c 696e 6720 7468 6520 ion filling the │ │ │ │ │ +00030d50: 726f 6c65 206f 6620 7468 6520 446f 6375 role of the Docu │ │ │ │ │ +00030d60: 6d65 6e74 2c20 7468 7573 206c 6963 656e ment, thus licen │ │ │ │ │ +00030d70: 7369 6e67 0a20 2020 2020 6469 7374 7269 sing. distri │ │ │ │ │ +00030d80: 6275 7469 6f6e 2061 6e64 206d 6f64 6966 bution and modif │ │ │ │ │ +00030d90: 6963 6174 696f 6e20 6f66 2074 6865 204d ication of the M │ │ │ │ │ +00030da0: 6f64 6966 6965 6420 5665 7273 696f 6e20 odified Version │ │ │ │ │ +00030db0: 746f 2077 686f 6576 6572 0a20 2020 2020 to whoever. │ │ │ │ │ +00030dc0: 706f 7373 6573 7365 7320 6120 636f 7079 possesses a copy │ │ │ │ │ +00030dd0: 206f 6620 6974 2e20 2049 6e20 6164 6469 of it. In addi │ │ │ │ │ +00030de0: 7469 6f6e 2c20 796f 7520 6d75 7374 2064 tion, you must d │ │ │ │ │ +00030df0: 6f20 7468 6573 6520 7468 696e 6773 2069 o these things i │ │ │ │ │ +00030e00: 6e0a 2020 2020 2074 6865 204d 6f64 6966 n. the Modif │ │ │ │ │ +00030e10: 6965 6420 5665 7273 696f 6e3a 0a0a 2020 ied Version:.. │ │ │ │ │ +00030e20: 2020 2020 2041 2e20 5573 6520 696e 2074 A. Use in t │ │ │ │ │ +00030e30: 6865 2054 6974 6c65 2050 6167 6520 2861 he Title Page (a │ │ │ │ │ +00030e40: 6e64 206f 6e20 7468 6520 636f 7665 7273 nd on the covers │ │ │ │ │ +00030e50: 2c20 6966 2061 6e79 2920 6120 7469 746c , if any) a titl │ │ │ │ │ +00030e60: 650a 2020 2020 2020 2020 2020 6469 7374 e. dist │ │ │ │ │ +00030e70: 696e 6374 2066 726f 6d20 7468 6174 206f inct from that o │ │ │ │ │ +00030e80: 6620 7468 6520 446f 6375 6d65 6e74 2c20 f the Document, │ │ │ │ │ +00030e90: 616e 6420 6672 6f6d 2074 686f 7365 206f and from those o │ │ │ │ │ +00030ea0: 6620 7072 6576 696f 7573 0a20 2020 2020 f previous. │ │ │ │ │ +00030eb0: 2020 2020 2076 6572 7369 6f6e 7320 2877 versions (w │ │ │ │ │ +00030ec0: 6869 6368 2073 686f 756c 642c 2069 6620 hich should, if │ │ │ │ │ +00030ed0: 7468 6572 6520 7765 7265 2061 6e79 2c20 there were any, │ │ │ │ │ +00030ee0: 6265 206c 6973 7465 6420 696e 2074 6865 be listed in the │ │ │ │ │ +00030ef0: 0a20 2020 2020 2020 2020 2048 6973 746f . Histo │ │ │ │ │ +00030f00: 7279 2073 6563 7469 6f6e 206f 6620 7468 ry section of th │ │ │ │ │ +00030f10: 6520 446f 6375 6d65 6e74 292e 2020 596f e Document). Yo │ │ │ │ │ +00030f20: 7520 6d61 7920 7573 6520 7468 6520 7361 u may use the sa │ │ │ │ │ +00030f30: 6d65 2074 6974 6c65 0a20 2020 2020 2020 me title. │ │ │ │ │ +00030f40: 2020 2061 7320 6120 7072 6576 696f 7573 as a previous │ │ │ │ │ +00030f50: 2076 6572 7369 6f6e 2069 6620 7468 6520 version if the │ │ │ │ │ +00030f60: 6f72 6967 696e 616c 2070 7562 6c69 7368 original publish │ │ │ │ │ +00030f70: 6572 206f 6620 7468 6174 0a20 2020 2020 er of that. │ │ │ │ │ +00030f80: 2020 2020 2076 6572 7369 6f6e 2067 6976 version giv │ │ │ │ │ +00030f90: 6573 2070 6572 6d69 7373 696f 6e2e 0a0a es permission... │ │ │ │ │ +00030fa0: 2020 2020 2020 2042 2e20 4c69 7374 206f B. List o │ │ │ │ │ +00030fb0: 6e20 7468 6520 5469 746c 6520 5061 6765 n the Title Page │ │ │ │ │ +00030fc0: 2c20 6173 2061 7574 686f 7273 2c20 6f6e , as authors, on │ │ │ │ │ +00030fd0: 6520 6f72 206d 6f72 6520 7065 7273 6f6e e or more person │ │ │ │ │ +00030fe0: 7320 6f72 0a20 2020 2020 2020 2020 2065 s or. e │ │ │ │ │ +00030ff0: 6e74 6974 6965 7320 7265 7370 6f6e 7369 ntities responsi │ │ │ │ │ +00031000: 626c 6520 666f 7220 6175 7468 6f72 7368 ble for authorsh │ │ │ │ │ +00031010: 6970 206f 6620 7468 6520 6d6f 6469 6669 ip of the modifi │ │ │ │ │ +00031020: 6361 7469 6f6e 7320 696e 0a20 2020 2020 cations in. │ │ │ │ │ +00031030: 2020 2020 2074 6865 204d 6f64 6966 6965 the Modifie │ │ │ │ │ +00031040: 6420 5665 7273 696f 6e2c 2074 6f67 6574 d Version, toget │ │ │ │ │ +00031050: 6865 7220 7769 7468 2061 7420 6c65 6173 her with at leas │ │ │ │ │ +00031060: 7420 6669 7665 206f 6620 7468 650a 2020 t five of the. │ │ │ │ │ +00031070: 2020 2020 2020 2020 7072 696e 6369 7061 principa │ │ │ │ │ +00031080: 6c20 6175 7468 6f72 7320 6f66 2074 6865 l authors of the │ │ │ │ │ +00031090: 2044 6f63 756d 656e 7420 2861 6c6c 206f Document (all o │ │ │ │ │ +000310a0: 6620 6974 7320 7072 696e 6369 7061 6c0a f its principal. │ │ │ │ │ +000310b0: 2020 2020 2020 2020 2020 6175 7468 6f72 author │ │ │ │ │ +000310c0: 732c 2069 6620 6974 2068 6173 2066 6577 s, if it has few │ │ │ │ │ +000310d0: 6572 2074 6861 6e20 6669 7665 292c 2075 er than five), u │ │ │ │ │ +000310e0: 6e6c 6573 7320 7468 6579 2072 656c 6561 nless they relea │ │ │ │ │ +000310f0: 7365 2079 6f75 0a20 2020 2020 2020 2020 se you. │ │ │ │ │ +00031100: 2066 726f 6d20 7468 6973 2072 6571 7569 from this requi │ │ │ │ │ +00031110: 7265 6d65 6e74 2e0a 0a20 2020 2020 2020 rement... │ │ │ │ │ +00031120: 432e 2053 7461 7465 206f 6e20 7468 6520 C. State on the │ │ │ │ │ +00031130: 5469 746c 6520 7061 6765 2074 6865 206e Title page the n │ │ │ │ │ +00031140: 616d 6520 6f66 2074 6865 2070 7562 6c69 ame of the publi │ │ │ │ │ +00031150: 7368 6572 206f 6620 7468 650a 2020 2020 sher of the. │ │ │ │ │ +00031160: 2020 2020 2020 4d6f 6469 6669 6564 2056 Modified V │ │ │ │ │ +00031170: 6572 7369 6f6e 2c20 6173 2074 6865 2070 ersion, as the p │ │ │ │ │ +00031180: 7562 6c69 7368 6572 2e0a 0a20 2020 2020 ublisher... │ │ │ │ │ +00031190: 2020 442e 2050 7265 7365 7276 6520 616c D. Preserve al │ │ │ │ │ +000311a0: 6c20 7468 6520 636f 7079 7269 6768 7420 l the copyright │ │ │ │ │ +000311b0: 6e6f 7469 6365 7320 6f66 2074 6865 2044 notices of the D │ │ │ │ │ +000311c0: 6f63 756d 656e 742e 0a0a 2020 2020 2020 ocument... │ │ │ │ │ +000311d0: 2045 2e20 4164 6420 616e 2061 7070 726f E. Add an appro │ │ │ │ │ +000311e0: 7072 6961 7465 2063 6f70 7972 6967 6874 priate copyright │ │ │ │ │ +000311f0: 206e 6f74 6963 6520 666f 7220 796f 7572 notice for your │ │ │ │ │ +00031200: 206d 6f64 6966 6963 6174 696f 6e73 0a20 modifications. │ │ │ │ │ +00031210: 2020 2020 2020 2020 2061 646a 6163 656e adjacen │ │ │ │ │ +00031220: 7420 746f 2074 6865 206f 7468 6572 2063 t to the other c │ │ │ │ │ +00031230: 6f70 7972 6967 6874 206e 6f74 6963 6573 opyright notices │ │ │ │ │ +00031240: 2e0a 0a20 2020 2020 2020 462e 2049 6e63 ... F. Inc │ │ │ │ │ +00031250: 6c75 6465 2c20 696d 6d65 6469 6174 656c lude, immediatel │ │ │ │ │ +00031260: 7920 6166 7465 7220 7468 6520 636f 7079 y after the copy │ │ │ │ │ +00031270: 7269 6768 7420 6e6f 7469 6365 732c 2061 right notices, a │ │ │ │ │ +00031280: 206c 6963 656e 7365 0a20 2020 2020 2020 license. │ │ │ │ │ +00031290: 2020 206e 6f74 6963 6520 6769 7669 6e67 notice giving │ │ │ │ │ +000312a0: 2074 6865 2070 7562 6c69 6320 7065 726d the public perm │ │ │ │ │ +000312b0: 6973 7369 6f6e 2074 6f20 7573 6520 7468 ission to use th │ │ │ │ │ +000312c0: 6520 4d6f 6469 6669 6564 0a20 2020 2020 e Modified. │ │ │ │ │ +000312d0: 2020 2020 2056 6572 7369 6f6e 2075 6e64 Version und │ │ │ │ │ +000312e0: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ +000312f0: 7468 6973 204c 6963 656e 7365 2c20 696e this License, in │ │ │ │ │ +00031300: 2074 6865 2066 6f72 6d20 7368 6f77 6e20 the form shown │ │ │ │ │ +00031310: 696e 0a20 2020 2020 2020 2020 2074 6865 in. the │ │ │ │ │ +00031320: 2041 6464 656e 6475 6d20 6265 6c6f 772e Addendum below. │ │ │ │ │ +00031330: 0a0a 2020 2020 2020 2047 2e20 5072 6573 .. G. Pres │ │ │ │ │ +00031340: 6572 7665 2069 6e20 7468 6174 206c 6963 erve in that lic │ │ │ │ │ +00031350: 656e 7365 206e 6f74 6963 6520 7468 6520 ense notice the │ │ │ │ │ +00031360: 6675 6c6c 206c 6973 7473 206f 6620 496e full lists of In │ │ │ │ │ +00031370: 7661 7269 616e 740a 2020 2020 2020 2020 variant. │ │ │ │ │ +00031380: 2020 5365 6374 696f 6e73 2061 6e64 2072 Sections and r │ │ │ │ │ +00031390: 6571 7569 7265 6420 436f 7665 7220 5465 equired Cover Te │ │ │ │ │ +000313a0: 7874 7320 6769 7665 6e20 696e 2074 6865 xts given in the │ │ │ │ │ +000313b0: 2044 6f63 756d 656e 7427 730a 2020 2020 Document's. │ │ │ │ │ +000313c0: 2020 2020 2020 6c69 6365 6e73 6520 6e6f license no │ │ │ │ │ +000313d0: 7469 6365 2e0a 0a20 2020 2020 2020 482e tice... H. │ │ │ │ │ +000313e0: 2049 6e63 6c75 6465 2061 6e20 756e 616c Include an unal │ │ │ │ │ +000313f0: 7465 7265 6420 636f 7079 206f 6620 7468 tered copy of th │ │ │ │ │ +00031400: 6973 204c 6963 656e 7365 2e0a 0a20 2020 is License... │ │ │ │ │ +00031410: 2020 2020 492e 2050 7265 7365 7276 6520 I. Preserve │ │ │ │ │ +00031420: 7468 6520 7365 6374 696f 6e20 456e 7469 the section Enti │ │ │ │ │ +00031430: 746c 6564 2022 4869 7374 6f72 7922 2c20 tled "History", │ │ │ │ │ +00031440: 5072 6573 6572 7665 2069 7473 2054 6974 Preserve its Tit │ │ │ │ │ +00031450: 6c65 2c0a 2020 2020 2020 2020 2020 616e le,. an │ │ │ │ │ +00031460: 6420 6164 6420 746f 2069 7420 616e 2069 d add to it an i │ │ │ │ │ +00031470: 7465 6d20 7374 6174 696e 6720 6174 206c tem stating at l │ │ │ │ │ +00031480: 6561 7374 2074 6865 2074 6974 6c65 2c20 east the title, │ │ │ │ │ +00031490: 7965 6172 2c20 6e65 770a 2020 2020 2020 year, new. │ │ │ │ │ +000314a0: 2020 2020 6175 7468 6f72 732c 2061 6e64 authors, and │ │ │ │ │ +000314b0: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ +000314c0: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ │ +000314d0: 6f6e 2061 7320 6769 7665 6e20 6f6e 2074 on as given on t │ │ │ │ │ +000314e0: 6865 0a20 2020 2020 2020 2020 2054 6974 he. Tit │ │ │ │ │ +000314f0: 6c65 2050 6167 652e 2020 4966 2074 6865 le Page. If the │ │ │ │ │ +00031500: 7265 2069 7320 6e6f 2073 6563 7469 6f6e re is no section │ │ │ │ │ +00031510: 2045 6e74 6974 6c65 6420 2248 6973 746f Entitled "Histo │ │ │ │ │ +00031520: 7279 2220 696e 2074 6865 0a20 2020 2020 ry" in the. │ │ │ │ │ +00031530: 2020 2020 2044 6f63 756d 656e 742c 2063 Document, c │ │ │ │ │ +00031540: 7265 6174 6520 6f6e 6520 7374 6174 696e reate one statin │ │ │ │ │ +00031550: 6720 7468 6520 7469 746c 652c 2079 6561 g the title, yea │ │ │ │ │ +00031560: 722c 2061 7574 686f 7273 2c20 616e 640a r, authors, and. │ │ │ │ │ +00031570: 2020 2020 2020 2020 2020 7075 626c 6973 publis │ │ │ │ │ +00031580: 6865 7220 6f66 2074 6865 2044 6f63 756d her of the Docum │ │ │ │ │ +00031590: 656e 7420 6173 2067 6976 656e 206f 6e20 ent as given on │ │ │ │ │ +000315a0: 6974 7320 5469 746c 6520 5061 6765 2c20 its Title Page, │ │ │ │ │ +000315b0: 7468 656e 2061 6464 0a20 2020 2020 2020 then add. │ │ │ │ │ +000315c0: 2020 2061 6e20 6974 656d 2064 6573 6372 an item descr │ │ │ │ │ +000315d0: 6962 696e 6720 7468 6520 4d6f 6469 6669 ibing the Modifi │ │ │ │ │ +000315e0: 6564 2056 6572 7369 6f6e 2061 7320 7374 ed Version as st │ │ │ │ │ +000315f0: 6174 6564 2069 6e20 7468 650a 2020 2020 ated in the. │ │ │ │ │ +00031600: 2020 2020 2020 7072 6576 696f 7573 2073 previous s │ │ │ │ │ +00031610: 656e 7465 6e63 652e 0a0a 2020 2020 2020 entence... │ │ │ │ │ +00031620: 204a 2e20 5072 6573 6572 7665 2074 6865 J. Preserve the │ │ │ │ │ +00031630: 206e 6574 776f 726b 206c 6f63 6174 696f network locatio │ │ │ │ │ +00031640: 6e2c 2069 6620 616e 792c 2067 6976 656e n, if any, given │ │ │ │ │ +00031650: 2069 6e20 7468 6520 446f 6375 6d65 6e74 in the Document │ │ │ │ │ +00031660: 0a20 2020 2020 2020 2020 2066 6f72 2070 . for p │ │ │ │ │ +00031670: 7562 6c69 6320 6163 6365 7373 2074 6f20 ublic access to │ │ │ │ │ +00031680: 6120 5472 616e 7370 6172 656e 7420 636f a Transparent co │ │ │ │ │ +00031690: 7079 206f 6620 7468 6520 446f 6375 6d65 py of the Docume │ │ │ │ │ +000316a0: 6e74 2c20 616e 640a 2020 2020 2020 2020 nt, and. │ │ │ │ │ +000316b0: 2020 6c69 6b65 7769 7365 2074 6865 206e likewise the n │ │ │ │ │ +000316c0: 6574 776f 726b 206c 6f63 6174 696f 6e73 etwork locations │ │ │ │ │ +000316d0: 2067 6976 656e 2069 6e20 7468 6520 446f given in the Do │ │ │ │ │ +000316e0: 6375 6d65 6e74 2066 6f72 0a20 2020 2020 cument for. │ │ │ │ │ +000316f0: 2020 2020 2070 7265 7669 6f75 7320 7665 previous ve │ │ │ │ │ +00031700: 7273 696f 6e73 2069 7420 7761 7320 6261 rsions it was ba │ │ │ │ │ +00031710: 7365 6420 6f6e 2e20 2054 6865 7365 206d sed on. These m │ │ │ │ │ +00031720: 6179 2062 6520 706c 6163 6564 2069 6e20 ay be placed in │ │ │ │ │ +00031730: 7468 650a 2020 2020 2020 2020 2020 2248 the. "H │ │ │ │ │ +00031740: 6973 746f 7279 2220 7365 6374 696f 6e2e istory" section. │ │ │ │ │ +00031750: 2020 596f 7520 6d61 7920 6f6d 6974 2061 You may omit a │ │ │ │ │ +00031760: 206e 6574 776f 726b 206c 6f63 6174 696f network locatio │ │ │ │ │ +00031770: 6e20 666f 7220 6120 776f 726b 0a20 2020 n for a work. │ │ │ │ │ +00031780: 2020 2020 2020 2074 6861 7420 7761 7320 that was │ │ │ │ │ +00031790: 7075 626c 6973 6865 6420 6174 206c 6561 published at lea │ │ │ │ │ +000317a0: 7374 2066 6f75 7220 7965 6172 7320 6265 st four years be │ │ │ │ │ +000317b0: 666f 7265 2074 6865 2044 6f63 756d 656e fore the Documen │ │ │ │ │ +000317c0: 740a 2020 2020 2020 2020 2020 6974 7365 t. itse │ │ │ │ │ +000317d0: 6c66 2c20 6f72 2069 6620 7468 6520 6f72 lf, or if the or │ │ │ │ │ +000317e0: 6967 696e 616c 2070 7562 6c69 7368 6572 iginal publisher │ │ │ │ │ +000317f0: 206f 6620 7468 6520 7665 7273 696f 6e20 of the version │ │ │ │ │ +00031800: 6974 2072 6566 6572 730a 2020 2020 2020 it refers. │ │ │ │ │ +00031810: 2020 2020 746f 2067 6976 6573 2070 6572 to gives per │ │ │ │ │ +00031820: 6d69 7373 696f 6e2e 0a0a 2020 2020 2020 mission... │ │ │ │ │ +00031830: 204b 2e20 466f 7220 616e 7920 7365 6374 K. For any sect │ │ │ │ │ +00031840: 696f 6e20 456e 7469 746c 6564 2022 4163 ion Entitled "Ac │ │ │ │ │ +00031850: 6b6e 6f77 6c65 6467 656d 656e 7473 2220 knowledgements" │ │ │ │ │ +00031860: 6f72 2022 4465 6469 6361 7469 6f6e 7322 or "Dedications" │ │ │ │ │ +00031870: 2c0a 2020 2020 2020 2020 2020 5072 6573 ,. Pres │ │ │ │ │ +00031880: 6572 7665 2074 6865 2054 6974 6c65 206f erve the Title o │ │ │ │ │ +00031890: 6620 7468 6520 7365 6374 696f 6e2c 2061 f the section, a │ │ │ │ │ +000318a0: 6e64 2070 7265 7365 7276 6520 696e 2074 nd preserve in t │ │ │ │ │ +000318b0: 6865 2073 6563 7469 6f6e 0a20 2020 2020 he section. │ │ │ │ │ +000318c0: 2020 2020 2061 6c6c 2074 6865 2073 7562 all the sub │ │ │ │ │ +000318d0: 7374 616e 6365 2061 6e64 2074 6f6e 6520 stance and tone │ │ │ │ │ +000318e0: 6f66 2065 6163 6820 6f66 2074 6865 2063 of each of the c │ │ │ │ │ +000318f0: 6f6e 7472 6962 7574 6f72 0a20 2020 2020 ontributor. │ │ │ │ │ +00031900: 2020 2020 2061 636b 6e6f 776c 6564 6765 acknowledge │ │ │ │ │ +00031910: 6d65 6e74 7320 616e 642f 6f72 2064 6564 ments and/or ded │ │ │ │ │ +00031920: 6963 6174 696f 6e73 2067 6976 656e 2074 ications given t │ │ │ │ │ +00031930: 6865 7265 696e 2e0a 0a20 2020 2020 2020 herein... │ │ │ │ │ +00031940: 4c2e 2050 7265 7365 7276 6520 616c 6c20 L. Preserve all │ │ │ │ │ +00031950: 7468 6520 496e 7661 7269 616e 7420 5365 the Invariant Se │ │ │ │ │ +00031960: 6374 696f 6e73 206f 6620 7468 6520 446f ctions of the Do │ │ │ │ │ +00031970: 6375 6d65 6e74 2c20 756e 616c 7465 7265 cument, unaltere │ │ │ │ │ +00031980: 640a 2020 2020 2020 2020 2020 696e 2074 d. in t │ │ │ │ │ +00031990: 6865 6972 2074 6578 7420 616e 6420 696e heir text and in │ │ │ │ │ +000319a0: 2074 6865 6972 2074 6974 6c65 732e 2020 their titles. │ │ │ │ │ +000319b0: 5365 6374 696f 6e20 6e75 6d62 6572 7320 Section numbers │ │ │ │ │ +000319c0: 6f72 2074 6865 0a20 2020 2020 2020 2020 or the. │ │ │ │ │ +000319d0: 2065 7175 6976 616c 656e 7420 6172 6520 equivalent are │ │ │ │ │ +000319e0: 6e6f 7420 636f 6e73 6964 6572 6564 2070 not considered p │ │ │ │ │ +000319f0: 6172 7420 6f66 2074 6865 2073 6563 7469 art of the secti │ │ │ │ │ +00031a00: 6f6e 2074 6974 6c65 732e 0a0a 2020 2020 on titles... │ │ │ │ │ +00031a10: 2020 204d 2e20 4465 6c65 7465 2061 6e79 M. Delete any │ │ │ │ │ +00031a20: 2073 6563 7469 6f6e 2045 6e74 6974 6c65 section Entitle │ │ │ │ │ +00031a30: 6420 2245 6e64 6f72 7365 6d65 6e74 7322 d "Endorsements" │ │ │ │ │ +00031a40: 2e20 2053 7563 6820 6120 7365 6374 696f . Such a sectio │ │ │ │ │ +00031a50: 6e0a 2020 2020 2020 2020 2020 6d61 7920 n. may │ │ │ │ │ +00031a60: 6e6f 7420 6265 2069 6e63 6c75 6465 6420 not be included │ │ │ │ │ +00031a70: 696e 2074 6865 204d 6f64 6966 6965 6420 in the Modified │ │ │ │ │ +00031a80: 5665 7273 696f 6e2e 0a0a 2020 2020 2020 Version... │ │ │ │ │ +00031a90: 204e 2e20 446f 206e 6f74 2072 6574 6974 N. Do not retit │ │ │ │ │ +00031aa0: 6c65 2061 6e79 2065 7869 7374 696e 6720 le any existing │ │ │ │ │ +00031ab0: 7365 6374 696f 6e20 746f 2062 6520 456e section to be En │ │ │ │ │ +00031ac0: 7469 746c 6564 0a20 2020 2020 2020 2020 titled. │ │ │ │ │ +00031ad0: 2022 456e 646f 7273 656d 656e 7473 2220 "Endorsements" │ │ │ │ │ +00031ae0: 6f72 2074 6f20 636f 6e66 6c69 6374 2069 or to conflict i │ │ │ │ │ +00031af0: 6e20 7469 746c 6520 7769 7468 2061 6e79 n title with any │ │ │ │ │ +00031b00: 2049 6e76 6172 6961 6e74 0a20 2020 2020 Invariant. │ │ │ │ │ +00031b10: 2020 2020 2053 6563 7469 6f6e 2e0a 0a20 Section... │ │ │ │ │ +00031b20: 2020 2020 2020 4f2e 2050 7265 7365 7276 O. Preserv │ │ │ │ │ +00031b30: 6520 616e 7920 5761 7272 616e 7479 2044 e any Warranty D │ │ │ │ │ +00031b40: 6973 636c 6169 6d65 7273 2e0a 0a20 2020 isclaimers... │ │ │ │ │ +00031b50: 2020 4966 2074 6865 204d 6f64 6966 6965 If the Modifie │ │ │ │ │ +00031b60: 6420 5665 7273 696f 6e20 696e 636c 7564 d Version includ │ │ │ │ │ +00031b70: 6573 206e 6577 2066 726f 6e74 2d6d 6174 es new front-mat │ │ │ │ │ +00031b80: 7465 7220 7365 6374 696f 6e73 206f 720a ter sections or. │ │ │ │ │ +00031b90: 2020 2020 2061 7070 656e 6469 6365 7320 appendices │ │ │ │ │ +00031ba0: 7468 6174 2071 7561 6c69 6679 2061 7320 that qualify as │ │ │ │ │ +00031bb0: 5365 636f 6e64 6172 7920 5365 6374 696f Secondary Sectio │ │ │ │ │ +00031bc0: 6e73 2061 6e64 2063 6f6e 7461 696e 206e ns and contain n │ │ │ │ │ +00031bd0: 6f0a 2020 2020 206d 6174 6572 6961 6c20 o. material │ │ │ │ │ +00031be0: 636f 7069 6564 2066 726f 6d20 7468 6520 copied from the │ │ │ │ │ +00031bf0: 446f 6375 6d65 6e74 2c20 796f 7520 6d61 Document, you ma │ │ │ │ │ +00031c00: 7920 6174 2079 6f75 7220 6f70 7469 6f6e y at your option │ │ │ │ │ +00031c10: 2064 6573 6967 6e61 7465 0a20 2020 2020 designate. │ │ │ │ │ +00031c20: 736f 6d65 206f 7220 616c 6c20 6f66 2074 some or all of t │ │ │ │ │ +00031c30: 6865 7365 2073 6563 7469 6f6e 7320 6173 hese sections as │ │ │ │ │ +00031c40: 2069 6e76 6172 6961 6e74 2e20 2054 6f20 invariant. To │ │ │ │ │ +00031c50: 646f 2074 6869 732c 2061 6464 2074 6865 do this, add the │ │ │ │ │ +00031c60: 6972 0a20 2020 2020 7469 746c 6573 2074 ir. titles t │ │ │ │ │ +00031c70: 6f20 7468 6520 6c69 7374 206f 6620 496e o the list of In │ │ │ │ │ +00031c80: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ +00031c90: 2069 6e20 7468 6520 4d6f 6469 6669 6564 in the Modified │ │ │ │ │ +00031ca0: 2056 6572 7369 6f6e 2773 0a20 2020 2020 Version's. │ │ │ │ │ +00031cb0: 6c69 6365 6e73 6520 6e6f 7469 6365 2e20 license notice. │ │ │ │ │ +00031cc0: 2054 6865 7365 2074 6974 6c65 7320 6d75 These titles mu │ │ │ │ │ +00031cd0: 7374 2062 6520 6469 7374 696e 6374 2066 st be distinct f │ │ │ │ │ +00031ce0: 726f 6d20 616e 7920 6f74 6865 720a 2020 rom any other. │ │ │ │ │ +00031cf0: 2020 2073 6563 7469 6f6e 2074 6974 6c65 section title │ │ │ │ │ +00031d00: 732e 0a0a 2020 2020 2059 6f75 206d 6179 s... You may │ │ │ │ │ +00031d10: 2061 6464 2061 2073 6563 7469 6f6e 2045 add a section E │ │ │ │ │ +00031d20: 6e74 6974 6c65 6420 2245 6e64 6f72 7365 ntitled "Endorse │ │ │ │ │ +00031d30: 6d65 6e74 7322 2c20 7072 6f76 6964 6564 ments", provided │ │ │ │ │ +00031d40: 2069 7420 636f 6e74 6169 6e73 0a20 2020 it contains. │ │ │ │ │ +00031d50: 2020 6e6f 7468 696e 6720 6275 7420 656e nothing but en │ │ │ │ │ +00031d60: 646f 7273 656d 656e 7473 206f 6620 796f dorsements of yo │ │ │ │ │ +00031d70: 7572 204d 6f64 6966 6965 6420 5665 7273 ur Modified Vers │ │ │ │ │ +00031d80: 696f 6e20 6279 2076 6172 696f 7573 0a20 ion by various. │ │ │ │ │ +00031d90: 2020 2020 7061 7274 6965 732d 2d66 6f72 parties--for │ │ │ │ │ +00031da0: 2065 7861 6d70 6c65 2c20 7374 6174 656d example, statem │ │ │ │ │ +00031db0: 656e 7473 206f 6620 7065 6572 2072 6576 ents of peer rev │ │ │ │ │ +00031dc0: 6965 7720 6f72 2074 6861 7420 7468 6520 iew or that the │ │ │ │ │ +00031dd0: 7465 7874 0a20 2020 2020 6861 7320 6265 text. has be │ │ │ │ │ +00031de0: 656e 2061 7070 726f 7665 6420 6279 2061 en approved by a │ │ │ │ │ +00031df0: 6e20 6f72 6761 6e69 7a61 7469 6f6e 2061 n organization a │ │ │ │ │ +00031e00: 7320 7468 6520 6175 7468 6f72 6974 6174 s the authoritat │ │ │ │ │ +00031e10: 6976 650a 2020 2020 2064 6566 696e 6974 ive. definit │ │ │ │ │ +00031e20: 696f 6e20 6f66 2061 2073 7461 6e64 6172 ion of a standar │ │ │ │ │ +00031e30: 642e 0a0a 2020 2020 2059 6f75 206d 6179 d... You may │ │ │ │ │ +00031e40: 2061 6464 2061 2070 6173 7361 6765 206f add a passage o │ │ │ │ │ +00031e50: 6620 7570 2074 6f20 6669 7665 2077 6f72 f up to five wor │ │ │ │ │ +00031e60: 6473 2061 7320 6120 4672 6f6e 742d 436f ds as a Front-Co │ │ │ │ │ +00031e70: 7665 7220 5465 7874 2c0a 2020 2020 2061 ver Text,. a │ │ │ │ │ +00031e80: 6e64 2061 2070 6173 7361 6765 206f 6620 nd a passage of │ │ │ │ │ +00031e90: 7570 2074 6f20 3235 2077 6f72 6473 2061 up to 25 words a │ │ │ │ │ +00031ea0: 7320 6120 4261 636b 2d43 6f76 6572 2054 s a Back-Cover T │ │ │ │ │ +00031eb0: 6578 742c 2074 6f20 7468 6520 656e 6420 ext, to the end │ │ │ │ │ +00031ec0: 6f66 0a20 2020 2020 7468 6520 6c69 7374 of. the list │ │ │ │ │ +00031ed0: 206f 6620 436f 7665 7220 5465 7874 7320 of Cover Texts │ │ │ │ │ +00031ee0: 696e 2074 6865 204d 6f64 6966 6965 6420 in the Modified │ │ │ │ │ +00031ef0: 5665 7273 696f 6e2e 2020 4f6e 6c79 206f Version. Only o │ │ │ │ │ +00031f00: 6e65 2070 6173 7361 6765 0a20 2020 2020 ne passage. │ │ │ │ │ +00031f10: 6f66 2046 726f 6e74 2d43 6f76 6572 2054 of Front-Cover T │ │ │ │ │ +00031f20: 6578 7420 616e 6420 6f6e 6520 6f66 2042 ext and one of B │ │ │ │ │ +00031f30: 6163 6b2d 436f 7665 7220 5465 7874 206d ack-Cover Text m │ │ │ │ │ +00031f40: 6179 2062 6520 6164 6465 6420 6279 2028 ay be added by ( │ │ │ │ │ +00031f50: 6f72 0a20 2020 2020 7468 726f 7567 6820 or. through │ │ │ │ │ +00031f60: 6172 7261 6e67 656d 656e 7473 206d 6164 arrangements mad │ │ │ │ │ +00031f70: 6520 6279 2920 616e 7920 6f6e 6520 656e e by) any one en │ │ │ │ │ +00031f80: 7469 7479 2e20 2049 6620 7468 6520 446f tity. If the Do │ │ │ │ │ +00031f90: 6375 6d65 6e74 0a20 2020 2020 616c 7265 cument. alre │ │ │ │ │ +00031fa0: 6164 7920 696e 636c 7564 6573 2061 2063 ady includes a c │ │ │ │ │ +00031fb0: 6f76 6572 2074 6578 7420 666f 7220 7468 over text for th │ │ │ │ │ +00031fc0: 6520 7361 6d65 2063 6f76 6572 2c20 7072 e same cover, pr │ │ │ │ │ +00031fd0: 6576 696f 7573 6c79 2061 6464 6564 0a20 eviously added. │ │ │ │ │ +00031fe0: 2020 2020 6279 2079 6f75 206f 7220 6279 by you or by │ │ │ │ │ +00031ff0: 2061 7272 616e 6765 6d65 6e74 206d 6164 arrangement mad │ │ │ │ │ +00032000: 6520 6279 2074 6865 2073 616d 6520 656e e by the same en │ │ │ │ │ +00032010: 7469 7479 2079 6f75 2061 7265 2061 6374 tity you are act │ │ │ │ │ +00032020: 696e 6720 6f6e 0a20 2020 2020 6265 6861 ing on. beha │ │ │ │ │ +00032030: 6c66 206f 662c 2079 6f75 206d 6179 206e lf of, you may n │ │ │ │ │ +00032040: 6f74 2061 6464 2061 6e6f 7468 6572 3b20 ot add another; │ │ │ │ │ +00032050: 6275 7420 796f 7520 6d61 7920 7265 706c but you may repl │ │ │ │ │ +00032060: 6163 6520 7468 6520 6f6c 640a 2020 2020 ace the old. │ │ │ │ │ +00032070: 206f 6e65 2c20 6f6e 2065 7870 6c69 6369 one, on explici │ │ │ │ │ +00032080: 7420 7065 726d 6973 7369 6f6e 2066 726f t permission fro │ │ │ │ │ +00032090: 6d20 7468 6520 7072 6576 696f 7573 2070 m the previous p │ │ │ │ │ +000320a0: 7562 6c69 7368 6572 2074 6861 7420 6164 ublisher that ad │ │ │ │ │ +000320b0: 6465 640a 2020 2020 2074 6865 206f 6c64 ded. the old │ │ │ │ │ +000320c0: 206f 6e65 2e0a 0a20 2020 2020 5468 6520 one... The │ │ │ │ │ +000320d0: 6175 7468 6f72 2873 2920 616e 6420 7075 author(s) and pu │ │ │ │ │ +000320e0: 626c 6973 6865 7228 7329 206f 6620 7468 blisher(s) of th │ │ │ │ │ +000320f0: 6520 446f 6375 6d65 6e74 2064 6f20 6e6f e Document do no │ │ │ │ │ +00032100: 7420 6279 2074 6869 730a 2020 2020 204c t by this. L │ │ │ │ │ +00032110: 6963 656e 7365 2067 6976 6520 7065 726d icense give perm │ │ │ │ │ +00032120: 6973 7369 6f6e 2074 6f20 7573 6520 7468 ission to use th │ │ │ │ │ +00032130: 6569 7220 6e61 6d65 7320 666f 7220 7075 eir names for pu │ │ │ │ │ +00032140: 626c 6963 6974 7920 666f 7220 6f72 2074 blicity for or t │ │ │ │ │ +00032150: 6f0a 2020 2020 2061 7373 6572 7420 6f72 o. assert or │ │ │ │ │ +00032160: 2069 6d70 6c79 2065 6e64 6f72 7365 6d65 imply endorseme │ │ │ │ │ +00032170: 6e74 206f 6620 616e 7920 4d6f 6469 6669 nt of any Modifi │ │ │ │ │ +00032180: 6564 2056 6572 7369 6f6e 2e0a 0a20 2035 ed Version... 5 │ │ │ │ │ +00032190: 2e20 434f 4d42 494e 494e 4720 444f 4355 . COMBINING DOCU │ │ │ │ │ +000321a0: 4d45 4e54 530a 0a20 2020 2020 596f 7520 MENTS.. You │ │ │ │ │ +000321b0: 6d61 7920 636f 6d62 696e 6520 7468 6520 may combine the │ │ │ │ │ +000321c0: 446f 6375 6d65 6e74 2077 6974 6820 6f74 Document with ot │ │ │ │ │ +000321d0: 6865 7220 646f 6375 6d65 6e74 7320 7265 her documents re │ │ │ │ │ +000321e0: 6c65 6173 6564 2075 6e64 6572 0a20 2020 leased under. │ │ │ │ │ +000321f0: 2020 7468 6973 204c 6963 656e 7365 2c20 this License, │ │ │ │ │ +00032200: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00032210: 6465 6669 6e65 6420 696e 2073 6563 7469 defined in secti │ │ │ │ │ +00032220: 6f6e 2034 2061 626f 7665 2066 6f72 0a20 on 4 above for. │ │ │ │ │ +00032230: 2020 2020 6d6f 6469 6669 6564 2076 6572 modified ver │ │ │ │ │ +00032240: 7369 6f6e 732c 2070 726f 7669 6465 6420 sions, provided │ │ │ │ │ +00032250: 7468 6174 2079 6f75 2069 6e63 6c75 6465 that you include │ │ │ │ │ +00032260: 2069 6e20 7468 6520 636f 6d62 696e 6174 in the combinat │ │ │ │ │ +00032270: 696f 6e20 616c 6c0a 2020 2020 206f 6620 ion all. of │ │ │ │ │ +00032280: 7468 6520 496e 7661 7269 616e 7420 5365 the Invariant Se │ │ │ │ │ +00032290: 6374 696f 6e73 206f 6620 616c 6c20 6f66 ctions of all of │ │ │ │ │ +000322a0: 2074 6865 206f 7269 6769 6e61 6c20 646f the original do │ │ │ │ │ +000322b0: 6375 6d65 6e74 732c 0a20 2020 2020 756e cuments,. un │ │ │ │ │ +000322c0: 6d6f 6469 6669 6564 2c20 616e 6420 6c69 modified, and li │ │ │ │ │ +000322d0: 7374 2074 6865 6d20 616c 6c20 6173 2049 st them all as I │ │ │ │ │ +000322e0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +000322f0: 7320 6f66 2079 6f75 720a 2020 2020 2063 s of your. c │ │ │ │ │ +00032300: 6f6d 6269 6e65 6420 776f 726b 2069 6e20 ombined work in │ │ │ │ │ +00032310: 6974 7320 6c69 6365 6e73 6520 6e6f 7469 its license noti │ │ │ │ │ +00032320: 6365 2c20 616e 6420 7468 6174 2079 6f75 ce, and that you │ │ │ │ │ +00032330: 2070 7265 7365 7276 6520 616c 6c0a 2020 preserve all. │ │ │ │ │ +00032340: 2020 2074 6865 6972 2057 6172 7261 6e74 their Warrant │ │ │ │ │ +00032350: 7920 4469 7363 6c61 696d 6572 732e 0a0a y Disclaimers... │ │ │ │ │ +00032360: 2020 2020 2054 6865 2063 6f6d 6269 6e65 The combine │ │ │ │ │ +00032370: 6420 776f 726b 206e 6565 6420 6f6e 6c79 d work need only │ │ │ │ │ +00032380: 2063 6f6e 7461 696e 206f 6e65 2063 6f70 contain one cop │ │ │ │ │ +00032390: 7920 6f66 2074 6869 7320 4c69 6365 6e73 y of this Licens │ │ │ │ │ +000323a0: 652c 2061 6e64 0a20 2020 2020 6d75 6c74 e, and. mult │ │ │ │ │ +000323b0: 6970 6c65 2069 6465 6e74 6963 616c 2049 iple identical I │ │ │ │ │ +000323c0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +000323d0: 7320 6d61 7920 6265 2072 6570 6c61 6365 s may be replace │ │ │ │ │ +000323e0: 6420 7769 7468 2061 2073 696e 676c 650a d with a single. │ │ │ │ │ +000323f0: 2020 2020 2063 6f70 792e 2020 4966 2074 copy. If t │ │ │ │ │ +00032400: 6865 7265 2061 7265 206d 756c 7469 706c here are multipl │ │ │ │ │ +00032410: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ +00032420: 696f 6e73 2077 6974 6820 7468 6520 7361 ions with the sa │ │ │ │ │ +00032430: 6d65 206e 616d 650a 2020 2020 2062 7574 me name. but │ │ │ │ │ +00032440: 2064 6966 6665 7265 6e74 2063 6f6e 7465 different conte │ │ │ │ │ +00032450: 6e74 732c 206d 616b 6520 7468 6520 7469 nts, make the ti │ │ │ │ │ +00032460: 746c 6520 6f66 2065 6163 6820 7375 6368 tle of each such │ │ │ │ │ +00032470: 2073 6563 7469 6f6e 2075 6e69 7175 650a section unique. │ │ │ │ │ +00032480: 2020 2020 2062 7920 6164 6469 6e67 2061 by adding a │ │ │ │ │ +00032490: 7420 7468 6520 656e 6420 6f66 2069 742c t the end of it, │ │ │ │ │ +000324a0: 2069 6e20 7061 7265 6e74 6865 7365 732c in parentheses, │ │ │ │ │ +000324b0: 2074 6865 206e 616d 6520 6f66 2074 6865 the name of the │ │ │ │ │ +000324c0: 0a20 2020 2020 6f72 6967 696e 616c 2061 . original a │ │ │ │ │ +000324d0: 7574 686f 7220 6f72 2070 7562 6c69 7368 uthor or publish │ │ │ │ │ +000324e0: 6572 206f 6620 7468 6174 2073 6563 7469 er of that secti │ │ │ │ │ +000324f0: 6f6e 2069 6620 6b6e 6f77 6e2c 206f 7220 on if known, or │ │ │ │ │ +00032500: 656c 7365 2061 0a20 2020 2020 756e 6971 else a. uniq │ │ │ │ │ +00032510: 7565 206e 756d 6265 722e 2020 4d61 6b65 ue number. Make │ │ │ │ │ +00032520: 2074 6865 2073 616d 6520 6164 6a75 7374 the same adjust │ │ │ │ │ +00032530: 6d65 6e74 2074 6f20 7468 6520 7365 6374 ment to the sect │ │ │ │ │ +00032540: 696f 6e20 7469 746c 6573 2069 6e0a 2020 ion titles in. │ │ │ │ │ +00032550: 2020 2074 6865 206c 6973 7420 6f66 2049 the list of I │ │ │ │ │ +00032560: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +00032570: 7320 696e 2074 6865 206c 6963 656e 7365 s in the license │ │ │ │ │ +00032580: 206e 6f74 6963 6520 6f66 2074 6865 0a20 notice of the. │ │ │ │ │ +00032590: 2020 2020 636f 6d62 696e 6564 2077 6f72 combined wor │ │ │ │ │ +000325a0: 6b2e 0a0a 2020 2020 2049 6e20 7468 6520 k... In the │ │ │ │ │ +000325b0: 636f 6d62 696e 6174 696f 6e2c 2079 6f75 combination, you │ │ │ │ │ +000325c0: 206d 7573 7420 636f 6d62 696e 6520 616e must combine an │ │ │ │ │ +000325d0: 7920 7365 6374 696f 6e73 2045 6e74 6974 y sections Entit │ │ │ │ │ +000325e0: 6c65 640a 2020 2020 2022 4869 7374 6f72 led. "Histor │ │ │ │ │ +000325f0: 7922 2069 6e20 7468 6520 7661 7269 6f75 y" in the variou │ │ │ │ │ +00032600: 7320 6f72 6967 696e 616c 2064 6f63 756d s original docum │ │ │ │ │ +00032610: 656e 7473 2c20 666f 726d 696e 6720 6f6e ents, forming on │ │ │ │ │ +00032620: 6520 7365 6374 696f 6e0a 2020 2020 2045 e section. E │ │ │ │ │ +00032630: 6e74 6974 6c65 6420 2248 6973 746f 7279 ntitled "History │ │ │ │ │ +00032640: 223b 206c 696b 6577 6973 6520 636f 6d62 "; likewise comb │ │ │ │ │ +00032650: 696e 6520 616e 7920 7365 6374 696f 6e73 ine any sections │ │ │ │ │ +00032660: 2045 6e74 6974 6c65 640a 2020 2020 2022 Entitled. " │ │ │ │ │ +00032670: 4163 6b6e 6f77 6c65 6467 656d 656e 7473 Acknowledgements │ │ │ │ │ +00032680: 222c 2061 6e64 2061 6e79 2073 6563 7469 ", and any secti │ │ │ │ │ +00032690: 6f6e 7320 456e 7469 746c 6564 2022 4465 ons Entitled "De │ │ │ │ │ +000326a0: 6469 6361 7469 6f6e 7322 2e20 2059 6f75 dications". You │ │ │ │ │ +000326b0: 0a20 2020 2020 6d75 7374 2064 656c 6574 . must delet │ │ │ │ │ +000326c0: 6520 616c 6c20 7365 6374 696f 6e73 2045 e all sections E │ │ │ │ │ +000326d0: 6e74 6974 6c65 6420 2245 6e64 6f72 7365 ntitled "Endorse │ │ │ │ │ +000326e0: 6d65 6e74 732e 220a 0a20 2036 2e20 434f ments.".. 6. CO │ │ │ │ │ +000326f0: 4c4c 4543 5449 4f4e 5320 4f46 2044 4f43 LLECTIONS OF DOC │ │ │ │ │ +00032700: 554d 454e 5453 0a0a 2020 2020 2059 6f75 UMENTS.. You │ │ │ │ │ +00032710: 206d 6179 206d 616b 6520 6120 636f 6c6c may make a coll │ │ │ │ │ +00032720: 6563 7469 6f6e 2063 6f6e 7369 7374 696e ection consistin │ │ │ │ │ +00032730: 6720 6f66 2074 6865 2044 6f63 756d 656e g of the Documen │ │ │ │ │ +00032740: 7420 616e 6420 6f74 6865 720a 2020 2020 t and other. │ │ │ │ │ +00032750: 2064 6f63 756d 656e 7473 2072 656c 6561 documents relea │ │ │ │ │ +00032760: 7365 6420 756e 6465 7220 7468 6973 204c sed under this L │ │ │ │ │ +00032770: 6963 656e 7365 2c20 616e 6420 7265 706c icense, and repl │ │ │ │ │ +00032780: 6163 6520 7468 6520 696e 6469 7669 6475 ace the individu │ │ │ │ │ +00032790: 616c 0a20 2020 2020 636f 7069 6573 206f al. copies o │ │ │ │ │ +000327a0: 6620 7468 6973 204c 6963 656e 7365 2069 f this License i │ │ │ │ │ +000327b0: 6e20 7468 6520 7661 7269 6f75 7320 646f n the various do │ │ │ │ │ +000327c0: 6375 6d65 6e74 7320 7769 7468 2061 2073 cuments with a s │ │ │ │ │ +000327d0: 696e 676c 6520 636f 7079 0a20 2020 2020 ingle copy. │ │ │ │ │ +000327e0: 7468 6174 2069 7320 696e 636c 7564 6564 that is included │ │ │ │ │ +000327f0: 2069 6e20 7468 6520 636f 6c6c 6563 7469 in the collecti │ │ │ │ │ +00032800: 6f6e 2c20 7072 6f76 6964 6564 2074 6861 on, provided tha │ │ │ │ │ +00032810: 7420 796f 7520 666f 6c6c 6f77 2074 6865 t you follow the │ │ │ │ │ +00032820: 0a20 2020 2020 7275 6c65 7320 6f66 2074 . rules of t │ │ │ │ │ +00032830: 6869 7320 4c69 6365 6e73 6520 666f 7220 his License for │ │ │ │ │ +00032840: 7665 7262 6174 696d 2063 6f70 7969 6e67 verbatim copying │ │ │ │ │ +00032850: 206f 6620 6561 6368 206f 6620 7468 6520 of each of the │ │ │ │ │ +00032860: 646f 6375 6d65 6e74 730a 2020 2020 2069 documents. i │ │ │ │ │ +00032870: 6e20 616c 6c20 6f74 6865 7220 7265 7370 n all other resp │ │ │ │ │ +00032880: 6563 7473 2e0a 0a20 2020 2020 596f 7520 ects... You │ │ │ │ │ +00032890: 6d61 7920 6578 7472 6163 7420 6120 7369 may extract a si │ │ │ │ │ +000328a0: 6e67 6c65 2064 6f63 756d 656e 7420 6672 ngle document fr │ │ │ │ │ +000328b0: 6f6d 2073 7563 6820 6120 636f 6c6c 6563 om such a collec │ │ │ │ │ +000328c0: 7469 6f6e 2c20 616e 640a 2020 2020 2064 tion, and. d │ │ │ │ │ +000328d0: 6973 7472 6962 7574 6520 6974 2069 6e64 istribute it ind │ │ │ │ │ +000328e0: 6976 6964 7561 6c6c 7920 756e 6465 7220 ividually under │ │ │ │ │ +000328f0: 7468 6973 204c 6963 656e 7365 2c20 7072 this License, pr │ │ │ │ │ +00032900: 6f76 6964 6564 2079 6f75 2069 6e73 6572 ovided you inser │ │ │ │ │ +00032910: 740a 2020 2020 2061 2063 6f70 7920 6f66 t. a copy of │ │ │ │ │ +00032920: 2074 6869 7320 4c69 6365 6e73 6520 696e this License in │ │ │ │ │ +00032930: 746f 2074 6865 2065 7874 7261 6374 6564 to the extracted │ │ │ │ │ +00032940: 2064 6f63 756d 656e 742c 2061 6e64 2066 document, and f │ │ │ │ │ +00032950: 6f6c 6c6f 7720 7468 6973 0a20 2020 2020 ollow this. │ │ │ │ │ +00032960: 4c69 6365 6e73 6520 696e 2061 6c6c 206f License in all o │ │ │ │ │ +00032970: 7468 6572 2072 6573 7065 6374 7320 7265 ther respects re │ │ │ │ │ +00032980: 6761 7264 696e 6720 7665 7262 6174 696d garding verbatim │ │ │ │ │ +00032990: 2063 6f70 7969 6e67 206f 6620 7468 6174 copying of that │ │ │ │ │ +000329a0: 0a20 2020 2020 646f 6375 6d65 6e74 2e0a . document.. │ │ │ │ │ +000329b0: 0a20 2037 2e20 4147 4752 4547 4154 494f . 7. AGGREGATIO │ │ │ │ │ +000329c0: 4e20 5749 5448 2049 4e44 4550 454e 4445 N WITH INDEPENDE │ │ │ │ │ +000329d0: 4e54 2057 4f52 4b53 0a0a 2020 2020 2041 NT WORKS.. A │ │ │ │ │ +000329e0: 2063 6f6d 7069 6c61 7469 6f6e 206f 6620 compilation of │ │ │ │ │ +000329f0: 7468 6520 446f 6375 6d65 6e74 206f 7220 the Document or │ │ │ │ │ +00032a00: 6974 7320 6465 7269 7661 7469 7665 7320 its derivatives │ │ │ │ │ +00032a10: 7769 7468 206f 7468 6572 0a20 2020 2020 with other. │ │ │ │ │ +00032a20: 7365 7061 7261 7465 2061 6e64 2069 6e64 separate and ind │ │ │ │ │ +00032a30: 6570 656e 6465 6e74 2064 6f63 756d 656e ependent documen │ │ │ │ │ +00032a40: 7473 206f 7220 776f 726b 732c 2069 6e20 ts or works, in │ │ │ │ │ +00032a50: 6f72 206f 6e20 6120 766f 6c75 6d65 206f or on a volume o │ │ │ │ │ +00032a60: 6620 610a 2020 2020 2073 746f 7261 6765 f a. storage │ │ │ │ │ +00032a70: 206f 7220 6469 7374 7269 6275 7469 6f6e or distribution │ │ │ │ │ +00032a80: 206d 6564 6975 6d2c 2069 7320 6361 6c6c medium, is call │ │ │ │ │ +00032a90: 6564 2061 6e20 2261 6767 7265 6761 7465 ed an "aggregate │ │ │ │ │ +00032aa0: 2220 6966 2074 6865 0a20 2020 2020 636f " if the. co │ │ │ │ │ +00032ab0: 7079 7269 6768 7420 7265 7375 6c74 696e pyright resultin │ │ │ │ │ +00032ac0: 6720 6672 6f6d 2074 6865 2063 6f6d 7069 g from the compi │ │ │ │ │ +00032ad0: 6c61 7469 6f6e 2069 7320 6e6f 7420 7573 lation is not us │ │ │ │ │ +00032ae0: 6564 2074 6f20 6c69 6d69 7420 7468 650a ed to limit the. │ │ │ │ │ +00032af0: 2020 2020 206c 6567 616c 2072 6967 6874 legal right │ │ │ │ │ +00032b00: 7320 6f66 2074 6865 2063 6f6d 7069 6c61 s of the compila │ │ │ │ │ +00032b10: 7469 6f6e 2773 2075 7365 7273 2062 6579 tion's users bey │ │ │ │ │ +00032b20: 6f6e 6420 7768 6174 2074 6865 2069 6e64 ond what the ind │ │ │ │ │ +00032b30: 6976 6964 7561 6c0a 2020 2020 2077 6f72 ividual. wor │ │ │ │ │ +00032b40: 6b73 2070 6572 6d69 742e 2020 5768 656e ks permit. When │ │ │ │ │ +00032b50: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ │ +00032b60: 2069 6e63 6c75 6465 6420 696e 2061 6e20 included in an │ │ │ │ │ +00032b70: 6167 6772 6567 6174 652c 2074 6869 730a aggregate, this. │ │ │ │ │ +00032b80: 2020 2020 204c 6963 656e 7365 2064 6f65 License doe │ │ │ │ │ +00032b90: 7320 6e6f 7420 6170 706c 7920 746f 2074 s not apply to t │ │ │ │ │ +00032ba0: 6865 206f 7468 6572 2077 6f72 6b73 2069 he other works i │ │ │ │ │ +00032bb0: 6e20 7468 6520 6167 6772 6567 6174 6520 n the aggregate │ │ │ │ │ +00032bc0: 7768 6963 680a 2020 2020 2061 7265 206e which. are n │ │ │ │ │ +00032bd0: 6f74 2074 6865 6d73 656c 7665 7320 6465 ot themselves de │ │ │ │ │ +00032be0: 7269 7661 7469 7665 2077 6f72 6b73 206f rivative works o │ │ │ │ │ +00032bf0: 6620 7468 6520 446f 6375 6d65 6e74 2e0a f the Document.. │ │ │ │ │ +00032c00: 0a20 2020 2020 4966 2074 6865 2043 6f76 . If the Cov │ │ │ │ │ +00032c10: 6572 2054 6578 7420 7265 7175 6972 656d er Text requirem │ │ │ │ │ +00032c20: 656e 7420 6f66 2073 6563 7469 6f6e 2033 ent of section 3 │ │ │ │ │ +00032c30: 2069 7320 6170 706c 6963 6162 6c65 2074 is applicable t │ │ │ │ │ +00032c40: 6f20 7468 6573 650a 2020 2020 2063 6f70 o these. cop │ │ │ │ │ +00032c50: 6965 7320 6f66 2074 6865 2044 6f63 756d ies of the Docum │ │ │ │ │ +00032c60: 656e 742c 2074 6865 6e20 6966 2074 6865 ent, then if the │ │ │ │ │ +00032c70: 2044 6f63 756d 656e 7420 6973 206c 6573 Document is les │ │ │ │ │ +00032c80: 7320 7468 616e 206f 6e65 2068 616c 660a s than one half. │ │ │ │ │ +00032c90: 2020 2020 206f 6620 7468 6520 656e 7469 of the enti │ │ │ │ │ +00032ca0: 7265 2061 6767 7265 6761 7465 2c20 7468 re aggregate, th │ │ │ │ │ +00032cb0: 6520 446f 6375 6d65 6e74 2773 2043 6f76 e Document's Cov │ │ │ │ │ +00032cc0: 6572 2054 6578 7473 206d 6179 2062 6520 er Texts may be │ │ │ │ │ +00032cd0: 706c 6163 6564 0a20 2020 2020 6f6e 2063 placed. on c │ │ │ │ │ +00032ce0: 6f76 6572 7320 7468 6174 2062 7261 636b overs that brack │ │ │ │ │ +00032cf0: 6574 2074 6865 2044 6f63 756d 656e 7420 et the Document │ │ │ │ │ +00032d00: 7769 7468 696e 2074 6865 2061 6767 7265 within the aggre │ │ │ │ │ +00032d10: 6761 7465 2c20 6f72 2074 6865 0a20 2020 gate, or the. │ │ │ │ │ +00032d20: 2020 656c 6563 7472 6f6e 6963 2065 7175 electronic equ │ │ │ │ │ +00032d30: 6976 616c 656e 7420 6f66 2063 6f76 6572 ivalent of cover │ │ │ │ │ +00032d40: 7320 6966 2074 6865 2044 6f63 756d 656e s if the Documen │ │ │ │ │ +00032d50: 7420 6973 2069 6e20 656c 6563 7472 6f6e t is in electron │ │ │ │ │ +00032d60: 6963 0a20 2020 2020 666f 726d 2e20 204f ic. form. O │ │ │ │ │ +00032d70: 7468 6572 7769 7365 2074 6865 7920 6d75 therwise they mu │ │ │ │ │ +00032d80: 7374 2061 7070 6561 7220 6f6e 2070 7269 st appear on pri │ │ │ │ │ +00032d90: 6e74 6564 2063 6f76 6572 7320 7468 6174 nted covers that │ │ │ │ │ +00032da0: 2062 7261 636b 6574 0a20 2020 2020 7468 bracket. th │ │ │ │ │ +00032db0: 6520 7768 6f6c 6520 6167 6772 6567 6174 e whole aggregat │ │ │ │ │ +00032dc0: 652e 0a0a 2020 382e 2054 5241 4e53 4c41 e... 8. TRANSLA │ │ │ │ │ +00032dd0: 5449 4f4e 0a0a 2020 2020 2054 7261 6e73 TION.. Trans │ │ │ │ │ +00032de0: 6c61 7469 6f6e 2069 7320 636f 6e73 6964 lation is consid │ │ │ │ │ +00032df0: 6572 6564 2061 206b 696e 6420 6f66 206d ered a kind of m │ │ │ │ │ +00032e00: 6f64 6966 6963 6174 696f 6e2c 2073 6f20 odification, so │ │ │ │ │ +00032e10: 796f 7520 6d61 790a 2020 2020 2064 6973 you may. dis │ │ │ │ │ +00032e20: 7472 6962 7574 6520 7472 616e 736c 6174 tribute translat │ │ │ │ │ +00032e30: 696f 6e73 206f 6620 7468 6520 446f 6375 ions of the Docu │ │ │ │ │ +00032e40: 6d65 6e74 2075 6e64 6572 2074 6865 2074 ment under the t │ │ │ │ │ +00032e50: 6572 6d73 206f 6620 7365 6374 696f 6e0a erms of section. │ │ │ │ │ +00032e60: 2020 2020 2034 2e20 2052 6570 6c61 6369 4. Replaci │ │ │ │ │ +00032e70: 6e67 2049 6e76 6172 6961 6e74 2053 6563 ng Invariant Sec │ │ │ │ │ +00032e80: 7469 6f6e 7320 7769 7468 2074 7261 6e73 tions with trans │ │ │ │ │ +00032e90: 6c61 7469 6f6e 7320 7265 7175 6972 6573 lations requires │ │ │ │ │ +00032ea0: 2073 7065 6369 616c 0a20 2020 2020 7065 special. pe │ │ │ │ │ +00032eb0: 726d 6973 7369 6f6e 2066 726f 6d20 7468 rmission from th │ │ │ │ │ +00032ec0: 6569 7220 636f 7079 7269 6768 7420 686f eir copyright ho │ │ │ │ │ +00032ed0: 6c64 6572 732c 2062 7574 2079 6f75 206d lders, but you m │ │ │ │ │ +00032ee0: 6179 2069 6e63 6c75 6465 0a20 2020 2020 ay include. │ │ │ │ │ +00032ef0: 7472 616e 736c 6174 696f 6e73 206f 6620 translations of │ │ │ │ │ +00032f00: 736f 6d65 206f 7220 616c 6c20 496e 7661 some or all Inva │ │ │ │ │ +00032f10: 7269 616e 7420 5365 6374 696f 6e73 2069 riant Sections i │ │ │ │ │ +00032f20: 6e20 6164 6469 7469 6f6e 2074 6f20 7468 n addition to th │ │ │ │ │ +00032f30: 650a 2020 2020 206f 7269 6769 6e61 6c20 e. original │ │ │ │ │ +00032f40: 7665 7273 696f 6e73 206f 6620 7468 6573 versions of thes │ │ │ │ │ +00032f50: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ +00032f60: 696f 6e73 2e20 2059 6f75 206d 6179 2069 ions. You may i │ │ │ │ │ +00032f70: 6e63 6c75 6465 2061 0a20 2020 2020 7472 nclude a. tr │ │ │ │ │ +00032f80: 616e 736c 6174 696f 6e20 6f66 2074 6869 anslation of thi │ │ │ │ │ +00032f90: 7320 4c69 6365 6e73 652c 2061 6e64 2061 s License, and a │ │ │ │ │ +00032fa0: 6c6c 2074 6865 206c 6963 656e 7365 206e ll the license n │ │ │ │ │ +00032fb0: 6f74 6963 6573 2069 6e20 7468 650a 2020 otices in the. │ │ │ │ │ +00032fc0: 2020 2044 6f63 756d 656e 742c 2061 6e64 Document, and │ │ │ │ │ +00032fd0: 2061 6e79 2057 6172 7261 6e74 7920 4469 any Warranty Di │ │ │ │ │ +00032fe0: 7363 6c61 696d 6572 732c 2070 726f 7669 sclaimers, provi │ │ │ │ │ +00032ff0: 6465 6420 7468 6174 2079 6f75 2061 6c73 ded that you als │ │ │ │ │ +00033000: 6f0a 2020 2020 2069 6e63 6c75 6465 2074 o. include t │ │ │ │ │ +00033010: 6865 206f 7269 6769 6e61 6c20 456e 676c he original Engl │ │ │ │ │ +00033020: 6973 6820 7665 7273 696f 6e20 6f66 2074 ish version of t │ │ │ │ │ +00033030: 6869 7320 4c69 6365 6e73 6520 616e 6420 his License and │ │ │ │ │ +00033040: 7468 650a 2020 2020 206f 7269 6769 6e61 the. origina │ │ │ │ │ +00033050: 6c20 7665 7273 696f 6e73 206f 6620 7468 l versions of th │ │ │ │ │ +00033060: 6f73 6520 6e6f 7469 6365 7320 616e 6420 ose notices and │ │ │ │ │ +00033070: 6469 7363 6c61 696d 6572 732e 2020 496e disclaimers. In │ │ │ │ │ +00033080: 2063 6173 6520 6f66 2061 0a20 2020 2020 case of a. │ │ │ │ │ +00033090: 6469 7361 6772 6565 6d65 6e74 2062 6574 disagreement bet │ │ │ │ │ +000330a0: 7765 656e 2074 6865 2074 7261 6e73 6c61 ween the transla │ │ │ │ │ +000330b0: 7469 6f6e 2061 6e64 2074 6865 206f 7269 tion and the ori │ │ │ │ │ +000330c0: 6769 6e61 6c20 7665 7273 696f 6e20 6f66 ginal version of │ │ │ │ │ +000330d0: 0a20 2020 2020 7468 6973 204c 6963 656e . this Licen │ │ │ │ │ +000330e0: 7365 206f 7220 6120 6e6f 7469 6365 206f se or a notice o │ │ │ │ │ +000330f0: 7220 6469 7363 6c61 696d 6572 2c20 7468 r disclaimer, th │ │ │ │ │ +00033100: 6520 6f72 6967 696e 616c 2076 6572 7369 e original versi │ │ │ │ │ +00033110: 6f6e 2077 696c 6c0a 2020 2020 2070 7265 on will. pre │ │ │ │ │ +00033120: 7661 696c 2e0a 0a20 2020 2020 4966 2061 vail... If a │ │ │ │ │ +00033130: 2073 6563 7469 6f6e 2069 6e20 7468 6520 section in the │ │ │ │ │ +00033140: 446f 6375 6d65 6e74 2069 7320 456e 7469 Document is Enti │ │ │ │ │ +00033150: 746c 6564 2022 4163 6b6e 6f77 6c65 6467 tled "Acknowledg │ │ │ │ │ +00033160: 656d 656e 7473 222c 0a20 2020 2020 2244 ements",. "D │ │ │ │ │ +00033170: 6564 6963 6174 696f 6e73 222c 206f 7220 edications", or │ │ │ │ │ +00033180: 2248 6973 746f 7279 222c 2074 6865 2072 "History", the r │ │ │ │ │ +00033190: 6571 7569 7265 6d65 6e74 2028 7365 6374 equirement (sect │ │ │ │ │ +000331a0: 696f 6e20 3429 2074 6f0a 2020 2020 2050 ion 4) to. P │ │ │ │ │ +000331b0: 7265 7365 7276 6520 6974 7320 5469 746c reserve its Titl │ │ │ │ │ +000331c0: 6520 2873 6563 7469 6f6e 2031 2920 7769 e (section 1) wi │ │ │ │ │ +000331d0: 6c6c 2074 7970 6963 616c 6c79 2072 6571 ll typically req │ │ │ │ │ +000331e0: 7569 7265 2063 6861 6e67 696e 6720 7468 uire changing th │ │ │ │ │ +000331f0: 650a 2020 2020 2061 6374 7561 6c20 7469 e. actual ti │ │ │ │ │ +00033200: 746c 652e 0a0a 2020 392e 2054 4552 4d49 tle... 9. TERMI │ │ │ │ │ +00033210: 4e41 5449 4f4e 0a0a 2020 2020 2059 6f75 NATION.. You │ │ │ │ │ +00033220: 206d 6179 206e 6f74 2063 6f70 792c 206d may not copy, m │ │ │ │ │ +00033230: 6f64 6966 792c 2073 7562 6c69 6365 6e73 odify, sublicens │ │ │ │ │ +00033240: 652c 206f 7220 6469 7374 7269 6275 7465 e, or distribute │ │ │ │ │ +00033250: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ │ +00033260: 2020 2065 7863 6570 7420 6173 2065 7870 except as exp │ │ │ │ │ +00033270: 7265 7373 6c79 2070 726f 7669 6465 6420 ressly provided │ │ │ │ │ +00033280: 756e 6465 7220 7468 6973 204c 6963 656e under this Licen │ │ │ │ │ +00033290: 7365 2e20 2041 6e79 2061 7474 656d 7074 se. Any attempt │ │ │ │ │ +000332a0: 0a20 2020 2020 6f74 6865 7277 6973 6520 . otherwise │ │ │ │ │ +000332b0: 746f 2063 6f70 792c 206d 6f64 6966 792c to copy, modify, │ │ │ │ │ +000332c0: 2073 7562 6c69 6365 6e73 652c 206f 7220 sublicense, or │ │ │ │ │ +000332d0: 6469 7374 7269 6275 7465 2069 7420 6973 distribute it is │ │ │ │ │ +000332e0: 2076 6f69 642c 0a20 2020 2020 616e 6420 void,. and │ │ │ │ │ +000332f0: 7769 6c6c 2061 7574 6f6d 6174 6963 616c will automatical │ │ │ │ │ +00033300: 6c79 2074 6572 6d69 6e61 7465 2079 6f75 ly terminate you │ │ │ │ │ +00033310: 7220 7269 6768 7473 2075 6e64 6572 2074 r rights under t │ │ │ │ │ +00033320: 6869 7320 4c69 6365 6e73 652e 0a0a 2020 his License... │ │ │ │ │ +00033330: 2020 2048 6f77 6576 6572 2c20 6966 2079 However, if y │ │ │ │ │ +00033340: 6f75 2063 6561 7365 2061 6c6c 2076 696f ou cease all vio │ │ │ │ │ +00033350: 6c61 7469 6f6e 206f 6620 7468 6973 204c lation of this L │ │ │ │ │ +00033360: 6963 656e 7365 2c20 7468 656e 2079 6f75 icense, then you │ │ │ │ │ +00033370: 720a 2020 2020 206c 6963 656e 7365 2066 r. license f │ │ │ │ │ +00033380: 726f 6d20 6120 7061 7274 6963 756c 6172 rom a particular │ │ │ │ │ +00033390: 2063 6f70 7972 6967 6874 2068 6f6c 6465 copyright holde │ │ │ │ │ +000333a0: 7220 6973 2072 6569 6e73 7461 7465 6420 r is reinstated │ │ │ │ │ +000333b0: 2861 290a 2020 2020 2070 726f 7669 7369 (a). provisi │ │ │ │ │ +000333c0: 6f6e 616c 6c79 2c20 756e 6c65 7373 2061 onally, unless a │ │ │ │ │ +000333d0: 6e64 2075 6e74 696c 2074 6865 2063 6f70 nd until the cop │ │ │ │ │ +000333e0: 7972 6967 6874 2068 6f6c 6465 7220 6578 yright holder ex │ │ │ │ │ +000333f0: 706c 6963 6974 6c79 2061 6e64 0a20 2020 plicitly and. │ │ │ │ │ +00033400: 2020 6669 6e61 6c6c 7920 7465 726d 696e finally termin │ │ │ │ │ +00033410: 6174 6573 2079 6f75 7220 6c69 6365 6e73 ates your licens │ │ │ │ │ +00033420: 652c 2061 6e64 2028 6229 2070 6572 6d61 e, and (b) perma │ │ │ │ │ +00033430: 6e65 6e74 6c79 2c20 6966 2074 6865 0a20 nently, if the. │ │ │ │ │ +00033440: 2020 2020 636f 7079 7269 6768 7420 686f copyright ho │ │ │ │ │ +00033450: 6c64 6572 2066 6169 6c73 2074 6f20 6e6f lder fails to no │ │ │ │ │ +00033460: 7469 6679 2079 6f75 206f 6620 7468 6520 tify you of the │ │ │ │ │ +00033470: 7669 6f6c 6174 696f 6e20 6279 2073 6f6d violation by som │ │ │ │ │ +00033480: 650a 2020 2020 2072 6561 736f 6e61 626c e. reasonabl │ │ │ │ │ +00033490: 6520 6d65 616e 7320 7072 696f 7220 746f e means prior to │ │ │ │ │ +000334a0: 2036 3020 6461 7973 2061 6674 6572 2074 60 days after t │ │ │ │ │ +000334b0: 6865 2063 6573 7361 7469 6f6e 2e0a 0a20 he cessation... │ │ │ │ │ +000334c0: 2020 2020 4d6f 7265 6f76 6572 2c20 796f Moreover, yo │ │ │ │ │ +000334d0: 7572 206c 6963 656e 7365 2066 726f 6d20 ur license from │ │ │ │ │ +000334e0: 6120 7061 7274 6963 756c 6172 2063 6f70 a particular cop │ │ │ │ │ +000334f0: 7972 6967 6874 2068 6f6c 6465 7220 6973 yright holder is │ │ │ │ │ +00033500: 0a20 2020 2020 7265 696e 7374 6174 6564 . reinstated │ │ │ │ │ +00033510: 2070 6572 6d61 6e65 6e74 6c79 2069 6620 permanently if │ │ │ │ │ +00033520: 7468 6520 636f 7079 7269 6768 7420 686f the copyright ho │ │ │ │ │ +00033530: 6c64 6572 206e 6f74 6966 6965 7320 796f lder notifies yo │ │ │ │ │ +00033540: 7520 6f66 2074 6865 0a20 2020 2020 7669 u of the. vi │ │ │ │ │ +00033550: 6f6c 6174 696f 6e20 6279 2073 6f6d 6520 olation by some │ │ │ │ │ +00033560: 7265 6173 6f6e 6162 6c65 206d 6561 6e73 reasonable means │ │ │ │ │ +00033570: 2c20 7468 6973 2069 7320 7468 6520 6669 , this is the fi │ │ │ │ │ +00033580: 7273 7420 7469 6d65 2079 6f75 2068 6176 rst time you hav │ │ │ │ │ +00033590: 650a 2020 2020 2072 6563 6569 7665 6420 e. received │ │ │ │ │ +000335a0: 6e6f 7469 6365 206f 6620 7669 6f6c 6174 notice of violat │ │ │ │ │ +000335b0: 696f 6e20 6f66 2074 6869 7320 4c69 6365 ion of this Lice │ │ │ │ │ +000335c0: 6e73 6520 2866 6f72 2061 6e79 2077 6f72 nse (for any wor │ │ │ │ │ +000335d0: 6b29 2066 726f 6d0a 2020 2020 2074 6861 k) from. tha │ │ │ │ │ +000335e0: 7420 636f 7079 7269 6768 7420 686f 6c64 t copyright hold │ │ │ │ │ +000335f0: 6572 2c20 616e 6420 796f 7520 6375 7265 er, and you cure │ │ │ │ │ +00033600: 2074 6865 2076 696f 6c61 7469 6f6e 2070 the violation p │ │ │ │ │ +00033610: 7269 6f72 2074 6f20 3330 2064 6179 730a rior to 30 days. │ │ │ │ │ +00033620: 2020 2020 2061 6674 6572 2079 6f75 7220 after your │ │ │ │ │ +00033630: 7265 6365 6970 7420 6f66 2074 6865 206e receipt of the n │ │ │ │ │ +00033640: 6f74 6963 652e 0a0a 2020 2020 2054 6572 otice... Ter │ │ │ │ │ +00033650: 6d69 6e61 7469 6f6e 206f 6620 796f 7572 mination of your │ │ │ │ │ +00033660: 2072 6967 6874 7320 756e 6465 7220 7468 rights under th │ │ │ │ │ +00033670: 6973 2073 6563 7469 6f6e 2064 6f65 7320 is section does │ │ │ │ │ +00033680: 6e6f 7420 7465 726d 696e 6174 650a 2020 not terminate. │ │ │ │ │ +00033690: 2020 2074 6865 206c 6963 656e 7365 7320 the licenses │ │ │ │ │ +000336a0: 6f66 2070 6172 7469 6573 2077 686f 2068 of parties who h │ │ │ │ │ +000336b0: 6176 6520 7265 6365 6976 6564 2063 6f70 ave received cop │ │ │ │ │ +000336c0: 6965 7320 6f72 2072 6967 6874 7320 6672 ies or rights fr │ │ │ │ │ +000336d0: 6f6d 2079 6f75 0a20 2020 2020 756e 6465 om you. unde │ │ │ │ │ +000336e0: 7220 7468 6973 204c 6963 656e 7365 2e20 r this License. │ │ │ │ │ +000336f0: 2049 6620 796f 7572 2072 6967 6874 7320 If your rights │ │ │ │ │ +00033700: 6861 7665 2062 6565 6e20 7465 726d 696e have been termin │ │ │ │ │ +00033710: 6174 6564 2061 6e64 206e 6f74 0a20 2020 ated and not. │ │ │ │ │ +00033720: 2020 7065 726d 616e 656e 746c 7920 7265 permanently re │ │ │ │ │ +00033730: 696e 7374 6174 6564 2c20 7265 6365 6970 instated, receip │ │ │ │ │ +00033740: 7420 6f66 2061 2063 6f70 7920 6f66 2073 t of a copy of s │ │ │ │ │ +00033750: 6f6d 6520 6f72 2061 6c6c 206f 6620 7468 ome or all of th │ │ │ │ │ +00033760: 650a 2020 2020 2073 616d 6520 6d61 7465 e. same mate │ │ │ │ │ +00033770: 7269 616c 2064 6f65 7320 6e6f 7420 6769 rial does not gi │ │ │ │ │ +00033780: 7665 2079 6f75 2061 6e79 2072 6967 6874 ve you any right │ │ │ │ │ +00033790: 7320 746f 2075 7365 2069 742e 0a0a 2020 s to use it... │ │ │ │ │ +000337a0: 3130 2e20 4655 5455 5245 2052 4556 4953 10. FUTURE REVIS │ │ │ │ │ +000337b0: 494f 4e53 204f 4620 5448 4953 204c 4943 IONS OF THIS LIC │ │ │ │ │ +000337c0: 454e 5345 0a0a 2020 2020 2054 6865 2046 ENSE.. The F │ │ │ │ │ +000337d0: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ │ │ +000337e0: 6e64 6174 696f 6e20 6d61 7920 7075 626c ndation may publ │ │ │ │ │ +000337f0: 6973 6820 6e65 772c 2072 6576 6973 6564 ish new, revised │ │ │ │ │ +00033800: 2076 6572 7369 6f6e 7320 6f66 0a20 2020 versions of. │ │ │ │ │ +00033810: 2020 7468 6520 474e 5520 4672 6565 2044 the GNU Free D │ │ │ │ │ +00033820: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00033830: 656e 7365 2066 726f 6d20 7469 6d65 2074 ense from time t │ │ │ │ │ +00033840: 6f20 7469 6d65 2e20 2053 7563 6820 6e65 o time. Such ne │ │ │ │ │ +00033850: 770a 2020 2020 2076 6572 7369 6f6e 7320 w. versions │ │ │ │ │ +00033860: 7769 6c6c 2062 6520 7369 6d69 6c61 7220 will be similar │ │ │ │ │ +00033870: 696e 2073 7069 7269 7420 746f 2074 6865 in spirit to the │ │ │ │ │ +00033880: 2070 7265 7365 6e74 2076 6572 7369 6f6e present version │ │ │ │ │ +00033890: 2c20 6275 7420 6d61 790a 2020 2020 2064 , but may. d │ │ │ │ │ +000338a0: 6966 6665 7220 696e 2064 6574 6169 6c20 iffer in detail │ │ │ │ │ +000338b0: 746f 2061 6464 7265 7373 206e 6577 2070 to address new p │ │ │ │ │ +000338c0: 726f 626c 656d 7320 6f72 2063 6f6e 6365 roblems or conce │ │ │ │ │ +000338d0: 726e 732e 2020 5365 650a 2020 2020 203c rns. See. < │ │ │ │ │ +000338e0: 6874 7470 3a2f 2f77 7777 2e67 6e75 2e6f http://www.gnu.o │ │ │ │ │ +000338f0: 7267 2f63 6f70 796c 6566 742f 3e2e 0a0a rg/copyleft/>... │ │ │ │ │ +00033900: 2020 2020 2045 6163 6820 7665 7273 696f Each versio │ │ │ │ │ +00033910: 6e20 6f66 2074 6865 204c 6963 656e 7365 n of the License │ │ │ │ │ +00033920: 2069 7320 6769 7665 6e20 6120 6469 7374 is given a dist │ │ │ │ │ +00033930: 696e 6775 6973 6869 6e67 2076 6572 7369 inguishing versi │ │ │ │ │ +00033940: 6f6e 0a20 2020 2020 6e75 6d62 6572 2e20 on. number. │ │ │ │ │ +00033950: 2049 6620 7468 6520 446f 6375 6d65 6e74 If the Document │ │ │ │ │ +00033960: 2073 7065 6369 6669 6573 2074 6861 7420 specifies that │ │ │ │ │ +00033970: 6120 7061 7274 6963 756c 6172 206e 756d a particular num │ │ │ │ │ +00033980: 6265 7265 640a 2020 2020 2076 6572 7369 bered. versi │ │ │ │ │ +00033990: 6f6e 206f 6620 7468 6973 204c 6963 656e on of this Licen │ │ │ │ │ +000339a0: 7365 2022 6f72 2061 6e79 206c 6174 6572 se "or any later │ │ │ │ │ +000339b0: 2076 6572 7369 6f6e 2220 6170 706c 6965 version" applie │ │ │ │ │ +000339c0: 7320 746f 2069 742c 2079 6f75 0a20 2020 s to it, you. │ │ │ │ │ +000339d0: 2020 6861 7665 2074 6865 206f 7074 696f have the optio │ │ │ │ │ +000339e0: 6e20 6f66 2066 6f6c 6c6f 7769 6e67 2074 n of following t │ │ │ │ │ +000339f0: 6865 2074 6572 6d73 2061 6e64 2063 6f6e he terms and con │ │ │ │ │ +00033a00: 6469 7469 6f6e 7320 6569 7468 6572 206f ditions either o │ │ │ │ │ +00033a10: 660a 2020 2020 2074 6861 7420 7370 6563 f. that spec │ │ │ │ │ +00033a20: 6966 6965 6420 7665 7273 696f 6e20 6f72 ified version or │ │ │ │ │ +00033a30: 206f 6620 616e 7920 6c61 7465 7220 7665 of any later ve │ │ │ │ │ +00033a40: 7273 696f 6e20 7468 6174 2068 6173 2062 rsion that has b │ │ │ │ │ +00033a50: 6565 6e0a 2020 2020 2070 7562 6c69 7368 een. publish │ │ │ │ │ +00033a60: 6564 2028 6e6f 7420 6173 2061 2064 7261 ed (not as a dra │ │ │ │ │ +00033a70: 6674 2920 6279 2074 6865 2046 7265 6520 ft) by the Free │ │ │ │ │ +00033a80: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ │ │ +00033a90: 696f 6e2e 2020 4966 2074 6865 0a20 2020 ion. If the. │ │ │ │ │ +00033aa0: 2020 446f 6375 6d65 6e74 2064 6f65 7320 Document does │ │ │ │ │ +00033ab0: 6e6f 7420 7370 6563 6966 7920 6120 7665 not specify a ve │ │ │ │ │ +00033ac0: 7273 696f 6e20 6e75 6d62 6572 206f 6620 rsion number of │ │ │ │ │ +00033ad0: 7468 6973 204c 6963 656e 7365 2c20 796f this License, yo │ │ │ │ │ +00033ae0: 7520 6d61 790a 2020 2020 2063 686f 6f73 u may. choos │ │ │ │ │ +00033af0: 6520 616e 7920 7665 7273 696f 6e20 6576 e any version ev │ │ │ │ │ +00033b00: 6572 2070 7562 6c69 7368 6564 2028 6e6f er published (no │ │ │ │ │ +00033b10: 7420 6173 2061 2064 7261 6674 2920 6279 t as a draft) by │ │ │ │ │ +00033b20: 2074 6865 2046 7265 650a 2020 2020 2053 the Free. S │ │ │ │ │ +00033b30: 6f66 7477 6172 6520 466f 756e 6461 7469 oftware Foundati │ │ │ │ │ +00033b40: 6f6e 2e20 2049 6620 7468 6520 446f 6375 on. If the Docu │ │ │ │ │ +00033b50: 6d65 6e74 2073 7065 6369 6669 6573 2074 ment specifies t │ │ │ │ │ +00033b60: 6861 7420 6120 7072 6f78 7920 6361 6e0a hat a proxy can. │ │ │ │ │ +00033b70: 2020 2020 2064 6563 6964 6520 7768 6963 decide whic │ │ │ │ │ +00033b80: 6820 6675 7475 7265 2076 6572 7369 6f6e h future version │ │ │ │ │ +00033b90: 7320 6f66 2074 6869 7320 4c69 6365 6e73 s of this Licens │ │ │ │ │ +00033ba0: 6520 6361 6e20 6265 2075 7365 642c 2074 e can be used, t │ │ │ │ │ +00033bb0: 6861 740a 2020 2020 2070 726f 7879 2773 hat. proxy's │ │ │ │ │ +00033bc0: 2070 7562 6c69 6320 7374 6174 656d 656e public statemen │ │ │ │ │ +00033bd0: 7420 6f66 2061 6363 6570 7461 6e63 6520 t of acceptance │ │ │ │ │ +00033be0: 6f66 2061 2076 6572 7369 6f6e 2070 6572 of a version per │ │ │ │ │ +00033bf0: 6d61 6e65 6e74 6c79 0a20 2020 2020 6175 manently. au │ │ │ │ │ +00033c00: 7468 6f72 697a 6573 2079 6f75 2074 6f20 thorizes you to │ │ │ │ │ +00033c10: 6368 6f6f 7365 2074 6861 7420 7665 7273 choose that vers │ │ │ │ │ +00033c20: 696f 6e20 666f 7220 7468 6520 446f 6375 ion for the Docu │ │ │ │ │ +00033c30: 6d65 6e74 2e0a 0a20 2031 312e 2052 454c ment... 11. REL │ │ │ │ │ +00033c40: 4943 454e 5349 4e47 0a0a 2020 2020 2022 ICENSING.. " │ │ │ │ │ +00033c50: 4d61 7373 6976 6520 4d75 6c74 6961 7574 Massive Multiaut │ │ │ │ │ +00033c60: 686f 7220 436f 6c6c 6162 6f72 6174 696f hor Collaboratio │ │ │ │ │ +00033c70: 6e20 5369 7465 2220 286f 7220 224d 4d43 n Site" (or "MMC │ │ │ │ │ +00033c80: 2053 6974 6522 2920 6d65 616e 7320 616e Site") means an │ │ │ │ │ +00033c90: 790a 2020 2020 2057 6f72 6c64 2057 6964 y. World Wid │ │ │ │ │ +00033ca0: 6520 5765 6220 7365 7276 6572 2074 6861 e Web server tha │ │ │ │ │ +00033cb0: 7420 7075 626c 6973 6865 7320 636f 7079 t publishes copy │ │ │ │ │ +00033cc0: 7269 6768 7461 626c 6520 776f 726b 7320 rightable works │ │ │ │ │ +00033cd0: 616e 6420 616c 736f 0a20 2020 2020 7072 and also. pr │ │ │ │ │ +00033ce0: 6f76 6964 6573 2070 726f 6d69 6e65 6e74 ovides prominent │ │ │ │ │ +00033cf0: 2066 6163 696c 6974 6965 7320 666f 7220 facilities for │ │ │ │ │ +00033d00: 616e 7962 6f64 7920 746f 2065 6469 7420 anybody to edit │ │ │ │ │ +00033d10: 7468 6f73 6520 776f 726b 732e 2020 410a those works. A. │ │ │ │ │ +00033d20: 2020 2020 2070 7562 6c69 6320 7769 6b69 public wiki │ │ │ │ │ +00033d30: 2074 6861 7420 616e 7962 6f64 7920 6361 that anybody ca │ │ │ │ │ +00033d40: 6e20 6564 6974 2069 7320 616e 2065 7861 n edit is an exa │ │ │ │ │ +00033d50: 6d70 6c65 206f 6620 7375 6368 2061 2073 mple of such a s │ │ │ │ │ +00033d60: 6572 7665 722e 0a20 2020 2020 4120 224d erver.. A "M │ │ │ │ │ +00033d70: 6173 7369 7665 204d 756c 7469 6175 7468 assive Multiauth │ │ │ │ │ +00033d80: 6f72 2043 6f6c 6c61 626f 7261 7469 6f6e or Collaboration │ │ │ │ │ +00033d90: 2220 286f 7220 224d 4d43 2229 2063 6f6e " (or "MMC") con │ │ │ │ │ +00033da0: 7461 696e 6564 2069 6e20 7468 650a 2020 tained in the. │ │ │ │ │ +00033db0: 2020 2073 6974 6520 6d65 616e 7320 616e site means an │ │ │ │ │ +00033dc0: 7920 7365 7420 6f66 2063 6f70 7972 6967 y set of copyrig │ │ │ │ │ +00033dd0: 6874 6162 6c65 2077 6f72 6b73 2074 6875 htable works thu │ │ │ │ │ +00033de0: 7320 7075 626c 6973 6865 6420 6f6e 2074 s published on t │ │ │ │ │ +00033df0: 6865 204d 4d43 0a20 2020 2020 7369 7465 he MMC. site │ │ │ │ │ +00033e00: 2e0a 0a20 2020 2020 2243 432d 4259 2d53 ... "CC-BY-S │ │ │ │ │ +00033e10: 4122 206d 6561 6e73 2074 6865 2043 7265 A" means the Cre │ │ │ │ │ +00033e20: 6174 6976 6520 436f 6d6d 6f6e 7320 4174 ative Commons At │ │ │ │ │ +00033e30: 7472 6962 7574 696f 6e2d 5368 6172 6520 tribution-Share │ │ │ │ │ +00033e40: 416c 696b 6520 332e 300a 2020 2020 206c Alike 3.0. l │ │ │ │ │ +00033e50: 6963 656e 7365 2070 7562 6c69 7368 6564 icense published │ │ │ │ │ +00033e60: 2062 7920 4372 6561 7469 7665 2043 6f6d by Creative Com │ │ │ │ │ +00033e70: 6d6f 6e73 2043 6f72 706f 7261 7469 6f6e mons Corporation │ │ │ │ │ +00033e80: 2c20 6120 6e6f 742d 666f 722d 7072 6f66 , a not-for-prof │ │ │ │ │ +00033e90: 6974 0a20 2020 2020 636f 7270 6f72 6174 it. corporat │ │ │ │ │ +00033ea0: 696f 6e20 7769 7468 2061 2070 7269 6e63 ion with a princ │ │ │ │ │ +00033eb0: 6970 616c 2070 6c61 6365 206f 6620 6275 ipal place of bu │ │ │ │ │ +00033ec0: 7369 6e65 7373 2069 6e20 5361 6e20 4672 siness in San Fr │ │ │ │ │ +00033ed0: 616e 6369 7363 6f2c 0a20 2020 2020 4361 ancisco,. Ca │ │ │ │ │ +00033ee0: 6c69 666f 726e 6961 2c20 6173 2077 656c lifornia, as wel │ │ │ │ │ +00033ef0: 6c20 6173 2066 7574 7572 6520 636f 7079 l as future copy │ │ │ │ │ +00033f00: 6c65 6674 2076 6572 7369 6f6e 7320 6f66 left versions of │ │ │ │ │ +00033f10: 2074 6861 7420 6c69 6365 6e73 650a 2020 that license. │ │ │ │ │ +00033f20: 2020 2070 7562 6c69 7368 6564 2062 7920 published by │ │ │ │ │ +00033f30: 7468 6174 2073 616d 6520 6f72 6761 6e69 that same organi │ │ │ │ │ +00033f40: 7a61 7469 6f6e 2e0a 0a20 2020 2020 2249 zation... "I │ │ │ │ │ +00033f50: 6e63 6f72 706f 7261 7465 2220 6d65 616e ncorporate" mean │ │ │ │ │ +00033f60: 7320 746f 2070 7562 6c69 7368 206f 7220 s to publish or │ │ │ │ │ +00033f70: 7265 7075 626c 6973 6820 6120 446f 6375 republish a Docu │ │ │ │ │ +00033f80: 6d65 6e74 2c20 696e 2077 686f 6c65 206f ment, in whole o │ │ │ │ │ +00033f90: 720a 2020 2020 2069 6e20 7061 7274 2c20 r. in part, │ │ │ │ │ +00033fa0: 6173 2070 6172 7420 6f66 2061 6e6f 7468 as part of anoth │ │ │ │ │ +00033fb0: 6572 2044 6f63 756d 656e 742e 0a0a 2020 er Document... │ │ │ │ │ +00033fc0: 2020 2041 6e20 4d4d 4320 6973 2022 656c An MMC is "el │ │ │ │ │ +00033fd0: 6967 6962 6c65 2066 6f72 2072 656c 6963 igible for relic │ │ │ │ │ +00033fe0: 656e 7369 6e67 2220 6966 2069 7420 6973 ensing" if it is │ │ │ │ │ +00033ff0: 206c 6963 656e 7365 6420 756e 6465 7220 licensed under │ │ │ │ │ +00034000: 7468 6973 0a20 2020 2020 4c69 6365 6e73 this. Licens │ │ │ │ │ +00034010: 652c 2061 6e64 2069 6620 616c 6c20 776f e, and if all wo │ │ │ │ │ +00034020: 726b 7320 7468 6174 2077 6572 6520 6669 rks that were fi │ │ │ │ │ +00034030: 7273 7420 7075 626c 6973 6865 6420 756e rst published un │ │ │ │ │ +00034040: 6465 7220 7468 6973 0a20 2020 2020 4c69 der this. Li │ │ │ │ │ +00034050: 6365 6e73 6520 736f 6d65 7768 6572 6520 cense somewhere │ │ │ │ │ +00034060: 6f74 6865 7220 7468 616e 2074 6869 7320 other than this │ │ │ │ │ +00034070: 4d4d 432c 2061 6e64 2073 7562 7365 7175 MMC, and subsequ │ │ │ │ │ +00034080: 656e 746c 790a 2020 2020 2069 6e63 6f72 ently. incor │ │ │ │ │ +00034090: 706f 7261 7465 6420 696e 2077 686f 6c65 porated in whole │ │ │ │ │ +000340a0: 206f 7220 696e 2070 6172 7420 696e 746f or in part into │ │ │ │ │ +000340b0: 2074 6865 204d 4d43 2c20 2831 2920 6861 the MMC, (1) ha │ │ │ │ │ +000340c0: 6420 6e6f 2063 6f76 6572 0a20 2020 2020 d no cover. │ │ │ │ │ +000340d0: 7465 7874 7320 6f72 2069 6e76 6172 6961 texts or invaria │ │ │ │ │ +000340e0: 6e74 2073 6563 7469 6f6e 732c 2061 6e64 nt sections, and │ │ │ │ │ +000340f0: 2028 3229 2077 6572 6520 7468 7573 2069 (2) were thus i │ │ │ │ │ +00034100: 6e63 6f72 706f 7261 7465 6420 7072 696f ncorporated prio │ │ │ │ │ +00034110: 720a 2020 2020 2074 6f20 4e6f 7665 6d62 r. to Novemb │ │ │ │ │ +00034120: 6572 2031 2c20 3230 3038 2e0a 0a20 2020 er 1, 2008... │ │ │ │ │ +00034130: 2020 5468 6520 6f70 6572 6174 6f72 206f The operator o │ │ │ │ │ +00034140: 6620 616e 204d 4d43 2053 6974 6520 6d61 f an MMC Site ma │ │ │ │ │ +00034150: 7920 7265 7075 626c 6973 6820 616e 204d y republish an M │ │ │ │ │ +00034160: 4d43 2063 6f6e 7461 696e 6564 2069 6e20 MC contained in │ │ │ │ │ +00034170: 7468 650a 2020 2020 2073 6974 6520 756e the. site un │ │ │ │ │ +00034180: 6465 7220 4343 2d42 592d 5341 206f 6e20 der CC-BY-SA on │ │ │ │ │ +00034190: 7468 6520 7361 6d65 2073 6974 6520 6174 the same site at │ │ │ │ │ +000341a0: 2061 6e79 2074 696d 6520 6265 666f 7265 any time before │ │ │ │ │ +000341b0: 2041 7567 7573 7420 312c 0a20 2020 2020 August 1,. │ │ │ │ │ +000341c0: 3230 3039 2c20 7072 6f76 6964 6564 2074 2009, provided t │ │ │ │ │ +000341d0: 6865 204d 4d43 2069 7320 656c 6967 6962 he MMC is eligib │ │ │ │ │ +000341e0: 6c65 2066 6f72 2072 656c 6963 656e 7369 le for relicensi │ │ │ │ │ +000341f0: 6e67 2e0a 0a41 4444 454e 4455 4d3a 2048 ng...ADDENDUM: H │ │ │ │ │ +00034200: 6f77 2074 6f20 7573 6520 7468 6973 204c ow to use this L │ │ │ │ │ +00034210: 6963 656e 7365 2066 6f72 2079 6f75 7220 icense for your │ │ │ │ │ +00034220: 646f 6375 6d65 6e74 730a 3d3d 3d3d 3d3d documents.====== │ │ │ │ │ 00034230: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00034240: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00034250: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 =============..T │ │ │ │ │ -00034260: 6f20 7573 6520 7468 6973 204c 6963 656e o use this Licen │ │ │ │ │ -00034270: 7365 2069 6e20 6120 646f 6375 6d65 6e74 se in a document │ │ │ │ │ -00034280: 2079 6f75 2068 6176 6520 7772 6974 7465 you have writte │ │ │ │ │ -00034290: 6e2c 2069 6e63 6c75 6465 2061 2063 6f70 n, include a cop │ │ │ │ │ -000342a0: 7920 6f66 0a74 6865 204c 6963 656e 7365 y of.the License │ │ │ │ │ -000342b0: 2069 6e20 7468 6520 646f 6375 6d65 6e74 in the document │ │ │ │ │ -000342c0: 2061 6e64 2070 7574 2074 6865 2066 6f6c and put the fol │ │ │ │ │ -000342d0: 6c6f 7769 6e67 2063 6f70 7972 6967 6874 lowing copyright │ │ │ │ │ -000342e0: 2061 6e64 206c 6963 656e 7365 0a6e 6f74 and license.not │ │ │ │ │ -000342f0: 6963 6573 206a 7573 7420 6166 7465 7220 ices just after │ │ │ │ │ -00034300: 7468 6520 7469 746c 6520 7061 6765 3a0a the title page:. │ │ │ │ │ -00034310: 0a20 2020 2020 2020 436f 7079 7269 6768 . Copyrigh │ │ │ │ │ -00034320: 7420 2843 2920 2059 4541 5220 2059 4f55 t (C) YEAR YOU │ │ │ │ │ -00034330: 5220 4e41 4d45 2e0a 2020 2020 2020 2050 R NAME.. P │ │ │ │ │ -00034340: 6572 6d69 7373 696f 6e20 6973 2067 7261 ermission is gra │ │ │ │ │ -00034350: 6e74 6564 2074 6f20 636f 7079 2c20 6469 nted to copy, di │ │ │ │ │ -00034360: 7374 7269 6275 7465 2061 6e64 2f6f 7220 stribute and/or │ │ │ │ │ -00034370: 6d6f 6469 6679 2074 6869 7320 646f 6375 modify this docu │ │ │ │ │ -00034380: 6d65 6e74 0a20 2020 2020 2020 756e 6465 ment. unde │ │ │ │ │ -00034390: 7220 7468 6520 7465 726d 7320 6f66 2074 r the terms of t │ │ │ │ │ -000343a0: 6865 2047 4e55 2046 7265 6520 446f 6375 he GNU Free Docu │ │ │ │ │ -000343b0: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ │ -000343c0: 652c 2056 6572 7369 6f6e 2031 2e33 0a20 e, Version 1.3. │ │ │ │ │ -000343d0: 2020 2020 2020 6f72 2061 6e79 206c 6174 or any lat │ │ │ │ │ -000343e0: 6572 2076 6572 7369 6f6e 2070 7562 6c69 er version publi │ │ │ │ │ -000343f0: 7368 6564 2062 7920 7468 6520 4672 6565 shed by the Free │ │ │ │ │ -00034400: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ │ │ -00034410: 7469 6f6e 3b0a 2020 2020 2020 2077 6974 tion;. wit │ │ │ │ │ -00034420: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ -00034430: 6563 7469 6f6e 732c 206e 6f20 4672 6f6e ections, no Fron │ │ │ │ │ -00034440: 742d 436f 7665 7220 5465 7874 732c 2061 t-Cover Texts, a │ │ │ │ │ -00034450: 6e64 206e 6f20 4261 636b 2d43 6f76 6572 nd no Back-Cover │ │ │ │ │ -00034460: 0a20 2020 2020 2020 5465 7874 732e 2020 . Texts. │ │ │ │ │ -00034470: 4120 636f 7079 206f 6620 7468 6520 6c69 A copy of the li │ │ │ │ │ -00034480: 6365 6e73 6520 6973 2069 6e63 6c75 6465 cense is include │ │ │ │ │ -00034490: 6420 696e 2074 6865 2073 6563 7469 6f6e d in the section │ │ │ │ │ -000344a0: 2065 6e74 6974 6c65 6420 6060 474e 550a entitled ``GNU. │ │ │ │ │ -000344b0: 2020 2020 2020 2046 7265 6520 446f 6375 Free Docu │ │ │ │ │ -000344c0: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ │ -000344d0: 6527 272e 0a0a 2020 2049 6620 796f 7520 e''... If you │ │ │ │ │ -000344e0: 6861 7665 2049 6e76 6172 6961 6e74 2053 have Invariant S │ │ │ │ │ -000344f0: 6563 7469 6f6e 732c 2046 726f 6e74 2d43 ections, Front-C │ │ │ │ │ -00034500: 6f76 6572 2054 6578 7473 2061 6e64 2042 over Texts and B │ │ │ │ │ -00034510: 6163 6b2d 436f 7665 720a 5465 7874 732c ack-Cover.Texts, │ │ │ │ │ -00034520: 2072 6570 6c61 6365 2074 6865 2022 7769 replace the "wi │ │ │ │ │ -00034530: 7468 2e2e 2e54 6578 7473 2e22 2020 6c69 th...Texts." li │ │ │ │ │ -00034540: 6e65 2077 6974 6820 7468 6973 3a0a 0a20 ne with this:.. │ │ │ │ │ -00034550: 2020 2020 2020 2020 7769 7468 2074 6865 with the │ │ │ │ │ -00034560: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -00034570: 6f6e 7320 6265 696e 6720 4c49 5354 2054 ons being LIST T │ │ │ │ │ -00034580: 4845 4952 2054 4954 4c45 532c 2077 6974 HEIR TITLES, wit │ │ │ │ │ -00034590: 680a 2020 2020 2020 2020 2074 6865 2046 h. the F │ │ │ │ │ -000345a0: 726f 6e74 2d43 6f76 6572 2054 6578 7473 ront-Cover Texts │ │ │ │ │ -000345b0: 2062 6569 6e67 204c 4953 542c 2061 6e64 being LIST, and │ │ │ │ │ -000345c0: 2077 6974 6820 7468 6520 4261 636b 2d43 with the Back-C │ │ │ │ │ -000345d0: 6f76 6572 2054 6578 7473 0a20 2020 2020 over Texts. │ │ │ │ │ -000345e0: 2020 2020 6265 696e 6720 4c49 5354 2e0a being LIST.. │ │ │ │ │ -000345f0: 0a20 2020 4966 2079 6f75 2068 6176 6520 . If you have │ │ │ │ │ -00034600: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ -00034610: 6e73 2077 6974 686f 7574 2043 6f76 6572 ns without Cover │ │ │ │ │ -00034620: 2054 6578 7473 2c20 6f72 2073 6f6d 6520 Texts, or some │ │ │ │ │ -00034630: 6f74 6865 720a 636f 6d62 696e 6174 696f other.combinatio │ │ │ │ │ -00034640: 6e20 6f66 2074 6865 2074 6872 6565 2c20 n of the three, │ │ │ │ │ -00034650: 6d65 7267 6520 7468 6f73 6520 7477 6f20 merge those two │ │ │ │ │ -00034660: 616c 7465 726e 6174 6976 6573 2074 6f20 alternatives to │ │ │ │ │ -00034670: 7375 6974 2074 6865 0a73 6974 7561 7469 suit the.situati │ │ │ │ │ -00034680: 6f6e 2e0a 0a20 2020 4966 2079 6f75 7220 on... If your │ │ │ │ │ -00034690: 646f 6375 6d65 6e74 2063 6f6e 7461 696e document contain │ │ │ │ │ -000346a0: 7320 6e6f 6e74 7269 7669 616c 2065 7861 s nontrivial exa │ │ │ │ │ -000346b0: 6d70 6c65 7320 6f66 2070 726f 6772 616d mples of program │ │ │ │ │ -000346c0: 2063 6f64 652c 2077 650a 7265 636f 6d6d code, we.recomm │ │ │ │ │ -000346d0: 656e 6420 7265 6c65 6173 696e 6720 7468 end releasing th │ │ │ │ │ -000346e0: 6573 6520 6578 616d 706c 6573 2069 6e20 ese examples in │ │ │ │ │ -000346f0: 7061 7261 6c6c 656c 2075 6e64 6572 2079 parallel under y │ │ │ │ │ -00034700: 6f75 7220 6368 6f69 6365 206f 6620 6672 our choice of fr │ │ │ │ │ -00034710: 6565 0a73 6f66 7477 6172 6520 6c69 6365 ee.software lice │ │ │ │ │ -00034720: 6e73 652c 2073 7563 6820 6173 2074 6865 nse, such as the │ │ │ │ │ -00034730: 2047 4e55 2047 656e 6572 616c 2050 7562 GNU General Pub │ │ │ │ │ -00034740: 6c69 6320 4c69 6365 6e73 652c 2074 6f20 lic License, to │ │ │ │ │ -00034750: 7065 726d 6974 0a74 6865 6972 2075 7365 permit.their use │ │ │ │ │ -00034760: 2069 6e20 6672 6565 2073 6f66 7477 6172 in free softwar │ │ │ │ │ -00034770: 652e 0a0a 1f0a 4669 6c65 3a20 6175 746f e.....File: auto │ │ │ │ │ -00034780: 6d61 6b65 2d31 2e31 312e 696e 666f 2c20 make-1.11.info, │ │ │ │ │ -00034790: 204e 6f64 653a 2049 6e64 6963 6573 2c20 Node: Indices, │ │ │ │ │ -000347a0: 2050 7265 763a 2043 6f70 7969 6e67 2054 Prev: Copying T │ │ │ │ │ -000347b0: 6869 7320 4d61 6e75 616c 2c20 2055 703a his Manual, Up: │ │ │ │ │ -000347c0: 2054 6f70 0a0a 4170 7065 6e64 6978 2042 Top..Appendix B │ │ │ │ │ -000347d0: 2049 6e64 6963 6573 0a2a 2a2a 2a2a 2a2a Indices.******* │ │ │ │ │ -000347e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a 204d ***********..* M │ │ │ │ │ -000347f0: 656e 753a 0a0a 2a20 4d61 6372 6f20 496e enu:..* Macro In │ │ │ │ │ -00034800: 6465 783a 3a20 2020 2020 2020 2020 2020 dex:: │ │ │ │ │ -00034810: 2020 2020 2020 496e 6465 7820 6f66 2041 Index of A │ │ │ │ │ -00034820: 7574 6f63 6f6e 6620 6d61 6372 6f73 0a2a utoconf macros.* │ │ │ │ │ -00034830: 2056 6172 6961 626c 6520 496e 6465 783a Variable Index: │ │ │ │ │ -00034840: 3a20 2020 2020 2020 2020 2020 2020 2049 : I │ │ │ │ │ -00034850: 6e64 6578 206f 6620 4d61 6b65 6669 6c65 ndex of Makefile │ │ │ │ │ -00034860: 2076 6172 6961 626c 6573 0a2a 2047 656e variables.* Gen │ │ │ │ │ -00034870: 6572 616c 2049 6e64 6578 3a3a 2020 2020 eral Index:: │ │ │ │ │ -00034880: 2020 2020 2020 2020 2020 2047 656e 6572 Gener │ │ │ │ │ -00034890: 616c 2069 6e64 6578 0a0a 1f0a 4669 6c65 al index....File │ │ │ │ │ -000348a0: 3a20 6175 746f 6d61 6b65 2d31 2e31 312e : automake-1.11. │ │ │ │ │ -000348b0: 696e 666f 2c20 204e 6f64 653a 204d 6163 info, Node: Mac │ │ │ │ │ -000348c0: 726f 2049 6e64 6578 2c20 204e 6578 743a ro Index, Next: │ │ │ │ │ -000348d0: 2056 6172 6961 626c 6520 496e 6465 782c Variable Index, │ │ │ │ │ -000348e0: 2020 5570 3a20 496e 6469 6365 730a 0a42 Up: Indices..B │ │ │ │ │ -000348f0: 2e31 204d 6163 726f 2049 6e64 6578 0a3d .1 Macro Index.= │ │ │ │ │ -00034900: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00034910: 0008 5b69 6e64 6578 0008 5d0a 2a20 4d65 ..[index..].* Me │ │ │ │ │ -00034920: 6e75 3a0a 0a2a 205f 414d 5f44 4550 454e nu:..* _AM_DEPEN │ │ │ │ │ -00034930: 4445 4e43 4945 533a 2020 2020 2020 2020 DENCIES: │ │ │ │ │ -00034940: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ -00034950: 6976 6174 6520 4d61 6372 6f73 2e20 2020 ivate Macros. │ │ │ │ │ -00034960: 2020 2028 6c69 6e65 2020 3132 290a 2a20 (line 12).* │ │ │ │ │ -00034970: 4143 5f43 414e 4f4e 4943 414c 5f42 5549 AC_CANONICAL_BUI │ │ │ │ │ -00034980: 4c44 3a20 2020 2020 2020 2020 2020 2020 LD: │ │ │ │ │ -00034990: 2020 2020 2020 204f 7074 696f 6e61 6c2e Optional. │ │ │ │ │ -000349a0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -000349b0: 6520 2031 3129 0a2a 2041 435f 4341 4e4f e 11).* AC_CANO │ │ │ │ │ -000349c0: 4e49 4341 4c5f 484f 5354 3a20 2020 2020 NICAL_HOST: │ │ │ │ │ +00034250: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +00034260: 546f 2075 7365 2074 6869 7320 4c69 6365 To use this Lice │ │ │ │ │ +00034270: 6e73 6520 696e 2061 2064 6f63 756d 656e nse in a documen │ │ │ │ │ +00034280: 7420 796f 7520 6861 7665 2077 7269 7474 t you have writt │ │ │ │ │ +00034290: 656e 2c20 696e 636c 7564 6520 6120 636f en, include a co │ │ │ │ │ +000342a0: 7079 206f 660a 7468 6520 4c69 6365 6e73 py of.the Licens │ │ │ │ │ +000342b0: 6520 696e 2074 6865 2064 6f63 756d 656e e in the documen │ │ │ │ │ +000342c0: 7420 616e 6420 7075 7420 7468 6520 666f t and put the fo │ │ │ │ │ +000342d0: 6c6c 6f77 696e 6720 636f 7079 7269 6768 llowing copyrigh │ │ │ │ │ +000342e0: 7420 616e 6420 6c69 6365 6e73 650a 6e6f t and license.no │ │ │ │ │ +000342f0: 7469 6365 7320 6a75 7374 2061 6674 6572 tices just after │ │ │ │ │ +00034300: 2074 6865 2074 6974 6c65 2070 6167 653a the title page: │ │ │ │ │ +00034310: 0a0a 2020 2020 2020 2043 6f70 7972 6967 .. Copyrig │ │ │ │ │ +00034320: 6874 2028 4329 2020 5945 4152 2020 594f ht (C) YEAR YO │ │ │ │ │ +00034330: 5552 204e 414d 452e 0a20 2020 2020 2020 UR NAME.. │ │ │ │ │ +00034340: 5065 726d 6973 7369 6f6e 2069 7320 6772 Permission is gr │ │ │ │ │ +00034350: 616e 7465 6420 746f 2063 6f70 792c 2064 anted to copy, d │ │ │ │ │ +00034360: 6973 7472 6962 7574 6520 616e 642f 6f72 istribute and/or │ │ │ │ │ +00034370: 206d 6f64 6966 7920 7468 6973 2064 6f63 modify this doc │ │ │ │ │ +00034380: 756d 656e 740a 2020 2020 2020 2075 6e64 ument. und │ │ │ │ │ +00034390: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ +000343a0: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ │ +000343b0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +000343c0: 7365 2c20 5665 7273 696f 6e20 312e 330a se, Version 1.3. │ │ │ │ │ +000343d0: 2020 2020 2020 206f 7220 616e 7920 6c61 or any la │ │ │ │ │ +000343e0: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ +000343f0: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ +00034400: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ │ │ +00034410: 6174 696f 6e3b 0a20 2020 2020 2020 7769 ation;. wi │ │ │ │ │ +00034420: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ +00034430: 5365 6374 696f 6e73 2c20 6e6f 2046 726f Sections, no Fro │ │ │ │ │ +00034440: 6e74 2d43 6f76 6572 2054 6578 7473 2c20 nt-Cover Texts, │ │ │ │ │ +00034450: 616e 6420 6e6f 2042 6163 6b2d 436f 7665 and no Back-Cove │ │ │ │ │ +00034460: 720a 2020 2020 2020 2054 6578 7473 2e20 r. Texts. │ │ │ │ │ +00034470: 2041 2063 6f70 7920 6f66 2074 6865 206c A copy of the l │ │ │ │ │ +00034480: 6963 656e 7365 2069 7320 696e 636c 7564 icense is includ │ │ │ │ │ +00034490: 6564 2069 6e20 7468 6520 7365 6374 696f ed in the sectio │ │ │ │ │ +000344a0: 6e20 656e 7469 746c 6564 2060 6047 4e55 n entitled ``GNU │ │ │ │ │ +000344b0: 0a20 2020 2020 2020 4672 6565 2044 6f63 . Free Doc │ │ │ │ │ +000344c0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +000344d0: 7365 2727 2e0a 0a20 2020 4966 2079 6f75 se''... If you │ │ │ │ │ +000344e0: 2068 6176 6520 496e 7661 7269 616e 7420 have Invariant │ │ │ │ │ +000344f0: 5365 6374 696f 6e73 2c20 4672 6f6e 742d Sections, Front- │ │ │ │ │ +00034500: 436f 7665 7220 5465 7874 7320 616e 6420 Cover Texts and │ │ │ │ │ +00034510: 4261 636b 2d43 6f76 6572 0a54 6578 7473 Back-Cover.Texts │ │ │ │ │ +00034520: 2c20 7265 706c 6163 6520 7468 6520 2277 , replace the "w │ │ │ │ │ +00034530: 6974 682e 2e2e 5465 7874 732e 2220 206c ith...Texts." l │ │ │ │ │ +00034540: 696e 6520 7769 7468 2074 6869 733a 0a0a ine with this:.. │ │ │ │ │ +00034550: 2020 2020 2020 2020 2077 6974 6820 7468 with th │ │ │ │ │ +00034560: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ +00034570: 696f 6e73 2062 6569 6e67 204c 4953 5420 ions being LIST │ │ │ │ │ +00034580: 5448 4549 5220 5449 544c 4553 2c20 7769 THEIR TITLES, wi │ │ │ │ │ +00034590: 7468 0a20 2020 2020 2020 2020 7468 6520 th. the │ │ │ │ │ +000345a0: 4672 6f6e 742d 436f 7665 7220 5465 7874 Front-Cover Text │ │ │ │ │ +000345b0: 7320 6265 696e 6720 4c49 5354 2c20 616e s being LIST, an │ │ │ │ │ +000345c0: 6420 7769 7468 2074 6865 2042 6163 6b2d d with the Back- │ │ │ │ │ +000345d0: 436f 7665 7220 5465 7874 730a 2020 2020 Cover Texts. │ │ │ │ │ +000345e0: 2020 2020 2062 6569 6e67 204c 4953 542e being LIST. │ │ │ │ │ +000345f0: 0a0a 2020 2049 6620 796f 7520 6861 7665 .. If you have │ │ │ │ │ +00034600: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ +00034610: 6f6e 7320 7769 7468 6f75 7420 436f 7665 ons without Cove │ │ │ │ │ +00034620: 7220 5465 7874 732c 206f 7220 736f 6d65 r Texts, or some │ │ │ │ │ +00034630: 206f 7468 6572 0a63 6f6d 6269 6e61 7469 other.combinati │ │ │ │ │ +00034640: 6f6e 206f 6620 7468 6520 7468 7265 652c on of the three, │ │ │ │ │ +00034650: 206d 6572 6765 2074 686f 7365 2074 776f merge those two │ │ │ │ │ +00034660: 2061 6c74 6572 6e61 7469 7665 7320 746f alternatives to │ │ │ │ │ +00034670: 2073 7569 7420 7468 650a 7369 7475 6174 suit the.situat │ │ │ │ │ +00034680: 696f 6e2e 0a0a 2020 2049 6620 796f 7572 ion... If your │ │ │ │ │ +00034690: 2064 6f63 756d 656e 7420 636f 6e74 6169 document contai │ │ │ │ │ +000346a0: 6e73 206e 6f6e 7472 6976 6961 6c20 6578 ns nontrivial ex │ │ │ │ │ +000346b0: 616d 706c 6573 206f 6620 7072 6f67 7261 amples of progra │ │ │ │ │ +000346c0: 6d20 636f 6465 2c20 7765 0a72 6563 6f6d m code, we.recom │ │ │ │ │ +000346d0: 6d65 6e64 2072 656c 6561 7369 6e67 2074 mend releasing t │ │ │ │ │ +000346e0: 6865 7365 2065 7861 6d70 6c65 7320 696e hese examples in │ │ │ │ │ +000346f0: 2070 6172 616c 6c65 6c20 756e 6465 7220 parallel under │ │ │ │ │ +00034700: 796f 7572 2063 686f 6963 6520 6f66 2066 your choice of f │ │ │ │ │ +00034710: 7265 650a 736f 6674 7761 7265 206c 6963 ree.software lic │ │ │ │ │ +00034720: 656e 7365 2c20 7375 6368 2061 7320 7468 ense, such as th │ │ │ │ │ +00034730: 6520 474e 5520 4765 6e65 7261 6c20 5075 e GNU General Pu │ │ │ │ │ +00034740: 626c 6963 204c 6963 656e 7365 2c20 746f blic License, to │ │ │ │ │ +00034750: 2070 6572 6d69 740a 7468 6569 7220 7573 permit.their us │ │ │ │ │ +00034760: 6520 696e 2066 7265 6520 736f 6674 7761 e in free softwa │ │ │ │ │ +00034770: 7265 2e0a 0a1f 0a46 696c 653a 2061 7574 re.....File: aut │ │ │ │ │ +00034780: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ +00034790: 2020 4e6f 6465 3a20 496e 6469 6365 732c Node: Indices, │ │ │ │ │ +000347a0: 2020 5072 6576 3a20 436f 7079 696e 6720 Prev: Copying │ │ │ │ │ +000347b0: 5468 6973 204d 616e 7561 6c2c 2020 5570 This Manual, Up │ │ │ │ │ +000347c0: 3a20 546f 700a 0a41 7070 656e 6469 7820 : Top..Appendix │ │ │ │ │ +000347d0: 4220 496e 6469 6365 730a 2a2a 2a2a 2a2a B Indices.****** │ │ │ │ │ +000347e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 ************..* │ │ │ │ │ +000347f0: 4d65 6e75 3a0a 0a2a 204d 6163 726f 2049 Menu:..* Macro I │ │ │ │ │ +00034800: 6e64 6578 3a3a 2020 2020 2020 2020 2020 ndex:: │ │ │ │ │ +00034810: 2020 2020 2020 2049 6e64 6578 206f 6620 Index of │ │ │ │ │ +00034820: 4175 746f 636f 6e66 206d 6163 726f 730a Autoconf macros. │ │ │ │ │ +00034830: 2a20 5661 7269 6162 6c65 2049 6e64 6578 * Variable Index │ │ │ │ │ +00034840: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00034850: 496e 6465 7820 6f66 204d 616b 6566 696c Index of Makefil │ │ │ │ │ +00034860: 6520 7661 7269 6162 6c65 730a 2a20 4765 e variables.* Ge │ │ │ │ │ +00034870: 6e65 7261 6c20 496e 6465 783a 3a20 2020 neral Index:: │ │ │ │ │ +00034880: 2020 2020 2020 2020 2020 2020 4765 6e65 Gene │ │ │ │ │ +00034890: 7261 6c20 696e 6465 780a 0a1f 0a46 696c ral index....Fil │ │ │ │ │ +000348a0: 653a 2061 7574 6f6d 616b 652d 312e 3131 e: automake-1.11 │ │ │ │ │ +000348b0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4d61 .info, Node: Ma │ │ │ │ │ +000348c0: 6372 6f20 496e 6465 782c 2020 4e65 7874 cro Index, Next │ │ │ │ │ +000348d0: 3a20 5661 7269 6162 6c65 2049 6e64 6578 : Variable Index │ │ │ │ │ +000348e0: 2c20 2055 703a 2049 6e64 6963 6573 0a0a , Up: Indices.. │ │ │ │ │ +000348f0: 422e 3120 4d61 6372 6f20 496e 6465 780a B.1 Macro Index. │ │ │ │ │ +00034900: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00034910: 0a00 085b 696e 6465 7800 085d 0a2a 204d ...[index..].* M │ │ │ │ │ +00034920: 656e 753a 0a0a 2a20 5f41 4d5f 4445 5045 enu:..* _AM_DEPE │ │ │ │ │ +00034930: 4e44 454e 4349 4553 3a20 2020 2020 2020 NDENCIES: │ │ │ │ │ +00034940: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +00034950: 7269 7661 7465 204d 6163 726f 732e 2020 rivate Macros. │ │ │ │ │ +00034960: 2020 2020 286c 696e 6520 2031 3229 0a2a (line 12).* │ │ │ │ │ +00034970: 2041 435f 4341 4e4f 4e49 4341 4c5f 4255 AC_CANONICAL_BU │ │ │ │ │ +00034980: 494c 443a 2020 2020 2020 2020 2020 2020 ILD: │ │ │ │ │ +00034990: 2020 2020 2020 2020 4f70 7469 6f6e 616c Optional │ │ │ │ │ +000349a0: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ │ +000349b0: 6e65 2020 3131 290a 2a20 4143 5f43 414e ne 11).* AC_CAN │ │ │ │ │ +000349c0: 4f4e 4943 414c 5f48 4f53 543a 2020 2020 ONICAL_HOST: │ │ │ │ │ 000349d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000349e0: 4f70 7469 6f6e 616c 2e20 2020 2020 2020 Optional. │ │ │ │ │ -000349f0: 2020 2020 2028 6c69 6e65 2020 3132 290a (line 12). │ │ │ │ │ -00034a00: 2a20 4143 5f43 414e 4f4e 4943 414c 5f54 * AC_CANONICAL_T │ │ │ │ │ -00034a10: 4152 4745 543a 2020 2020 2020 2020 2020 ARGET: │ │ │ │ │ -00034a20: 2020 2020 2020 2020 204f 7074 696f 6e61 Optiona │ │ │ │ │ -00034a30: 6c2e 2020 2020 2020 2020 2020 2020 286c l. (l │ │ │ │ │ -00034a40: 696e 6520 2031 3329 0a2a 2041 435f 434f ine 13).* AC_CO │ │ │ │ │ -00034a50: 4e46 4947 5f41 5558 5f44 4952 3a20 2020 NFIG_AUX_DIR: │ │ │ │ │ +000349e0: 204f 7074 696f 6e61 6c2e 2020 2020 2020 Optional. │ │ │ │ │ +000349f0: 2020 2020 2020 286c 696e 6520 2031 3229 (line 12) │ │ │ │ │ +00034a00: 0a2a 2041 435f 4341 4e4f 4e49 4341 4c5f .* AC_CANONICAL_ │ │ │ │ │ +00034a10: 5441 5247 4554 3a20 2020 2020 2020 2020 TARGET: │ │ │ │ │ +00034a20: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +00034a30: 616c 2e20 2020 2020 2020 2020 2020 2028 al. ( │ │ │ │ │ +00034a40: 6c69 6e65 2020 3133 290a 2a20 4143 5f43 line 13).* AC_C │ │ │ │ │ +00034a50: 4f4e 4649 475f 4155 585f 4449 523a 2020 ONFIG_AUX_DIR: │ │ │ │ │ 00034a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034a70: 2020 4f70 7469 6f6e 616c 2e20 2020 2020 Optional. │ │ │ │ │ -00034a80: 2020 2020 2020 2028 6c69 6e65 2020 3139 (line 19 │ │ │ │ │ -00034a90: 290a 2a20 4143 5f43 4f4e 4649 475f 4155 ).* AC_CONFIG_AU │ │ │ │ │ -00034aa0: 585f 4449 5220 3c31 3e3a 2020 2020 2020 X_DIR <1>: │ │ │ │ │ -00034ab0: 2020 2020 2020 2020 2020 2053 7562 7061 Subpa │ │ │ │ │ -00034ac0: 636b 6167 6573 2e20 2020 2020 2020 2020 ckages. │ │ │ │ │ -00034ad0: 286c 696e 6520 2020 3629 0a2a 2041 435f (line 6).* AC_ │ │ │ │ │ -00034ae0: 434f 4e46 4947 5f46 494c 4553 3a20 2020 CONFIG_FILES: │ │ │ │ │ +00034a70: 2020 204f 7074 696f 6e61 6c2e 2020 2020 Optional. │ │ │ │ │ +00034a80: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +00034a90: 3929 0a2a 2041 435f 434f 4e46 4947 5f41 9).* AC_CONFIG_A │ │ │ │ │ +00034aa0: 5558 5f44 4952 203c 313e 3a20 2020 2020 UX_DIR <1>: │ │ │ │ │ +00034ab0: 2020 2020 2020 2020 2020 2020 5375 6270 Subp │ │ │ │ │ +00034ac0: 6163 6b61 6765 732e 2020 2020 2020 2020 ackages. │ │ │ │ │ +00034ad0: 2028 6c69 6e65 2020 2036 290a 2a20 4143 (line 6).* AC │ │ │ │ │ +00034ae0: 5f43 4f4e 4649 475f 4649 4c45 533a 2020 _CONFIG_FILES: │ │ │ │ │ 00034af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034b00: 2020 2020 5265 7175 6972 656d 656e 7473 Requirements │ │ │ │ │ -00034b10: 2e20 2020 2020 2020 2028 6c69 6e65 2020 . (line │ │ │ │ │ -00034b20: 3135 290a 2a20 4143 5f43 4f4e 4649 475f 15).* AC_CONFIG_ │ │ │ │ │ -00034b30: 4845 4144 4552 533a 2020 2020 2020 2020 HEADERS: │ │ │ │ │ -00034b40: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ -00034b50: 696f 6e61 6c2e 2020 2020 2020 2020 2020 ional. │ │ │ │ │ -00034b60: 2020 286c 696e 6520 2034 3429 0a2a 2041 (line 44).* A │ │ │ │ │ -00034b70: 435f 434f 4e46 4947 5f4c 4942 4f42 4a5f C_CONFIG_LIBOBJ_ │ │ │ │ │ -00034b80: 4449 523a 2020 2020 2020 2020 2020 2020 DIR: │ │ │ │ │ -00034b90: 2020 2020 2020 4f70 7469 6f6e 616c 2e20 Optional. │ │ │ │ │ -00034ba0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00034bb0: 2020 3430 290a 2a20 4143 5f43 4f4e 4649 40).* AC_CONFI │ │ │ │ │ -00034bc0: 475f 4c49 424f 424a 5f44 4952 203c 313e G_LIBOBJ_DIR <1> │ │ │ │ │ -00034bd0: 3a20 2020 2020 2020 2020 2020 2020 204c : L │ │ │ │ │ -00034be0: 4942 4f42 4a53 2e20 2020 2020 2020 2020 IBOBJS. │ │ │ │ │ -00034bf0: 2020 2020 286c 696e 6520 2035 3129 0a2a (line 51).* │ │ │ │ │ -00034c00: 2041 435f 434f 4e46 4947 5f4c 494e 4b53 AC_CONFIG_LINKS │ │ │ │ │ -00034c10: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00034c20: 2020 2020 2020 2020 4f70 7469 6f6e 616c Optional │ │ │ │ │ -00034c30: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ │ -00034c40: 6e65 2020 3533 290a 2a20 4143 5f43 4f4e ne 53).* AC_CON │ │ │ │ │ -00034c50: 4649 475f 5355 4244 4952 533a 2020 2020 FIG_SUBDIRS: │ │ │ │ │ +00034b00: 2020 2020 2052 6571 7569 7265 6d65 6e74 Requirement │ │ │ │ │ +00034b10: 732e 2020 2020 2020 2020 286c 696e 6520 s. (line │ │ │ │ │ +00034b20: 2031 3529 0a2a 2041 435f 434f 4e46 4947 15).* AC_CONFIG │ │ │ │ │ +00034b30: 5f48 4541 4445 5253 3a20 2020 2020 2020 _HEADERS: │ │ │ │ │ +00034b40: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ +00034b50: 7469 6f6e 616c 2e20 2020 2020 2020 2020 tional. │ │ │ │ │ +00034b60: 2020 2028 6c69 6e65 2020 3434 290a 2a20 (line 44).* │ │ │ │ │ +00034b70: 4143 5f43 4f4e 4649 475f 4c49 424f 424a AC_CONFIG_LIBOBJ │ │ │ │ │ +00034b80: 5f44 4952 3a20 2020 2020 2020 2020 2020 _DIR: │ │ │ │ │ +00034b90: 2020 2020 2020 204f 7074 696f 6e61 6c2e Optional. │ │ │ │ │ +00034ba0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00034bb0: 6520 2034 3029 0a2a 2041 435f 434f 4e46 e 40).* AC_CONF │ │ │ │ │ +00034bc0: 4947 5f4c 4942 4f42 4a5f 4449 5220 3c31 IG_LIBOBJ_DIR <1 │ │ │ │ │ +00034bd0: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +00034be0: 4c49 424f 424a 532e 2020 2020 2020 2020 LIBOBJS. │ │ │ │ │ +00034bf0: 2020 2020 2028 6c69 6e65 2020 3531 290a (line 51). │ │ │ │ │ +00034c00: 2a20 4143 5f43 4f4e 4649 475f 4c49 4e4b * AC_CONFIG_LINK │ │ │ │ │ +00034c10: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +00034c20: 2020 2020 2020 2020 204f 7074 696f 6e61 Optiona │ │ │ │ │ +00034c30: 6c2e 2020 2020 2020 2020 2020 2020 286c l. (l │ │ │ │ │ +00034c40: 696e 6520 2035 3329 0a2a 2041 435f 434f ine 53).* AC_CO │ │ │ │ │ +00034c50: 4e46 4947 5f53 5542 4449 5253 3a20 2020 NFIG_SUBDIRS: │ │ │ │ │ 00034c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034c70: 2053 7562 7061 636b 6167 6573 2e20 2020 Subpackages. │ │ │ │ │ -00034c80: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00034c90: 0a2a 2041 435f 4445 4655 4e3a 2020 2020 .* AC_DEFUN: │ │ │ │ │ +00034c70: 2020 5375 6270 6163 6b61 6765 732e 2020 Subpackages. │ │ │ │ │ +00034c80: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00034c90: 290a 2a20 4143 5f44 4546 554e 3a20 2020 ).* AC_DEFUN: │ │ │ │ │ 00034ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034cb0: 2020 2020 2020 2020 2020 4578 7465 6e64 Extend │ │ │ │ │ -00034cc0: 696e 6720 6163 6c6f 6361 6c2e 2020 2028 ing aclocal. ( │ │ │ │ │ -00034cd0: 6c69 6e65 2020 3336 290a 2a20 4143 5f46 line 36).* AC_F │ │ │ │ │ -00034ce0: 3737 5f4c 4942 5241 5259 5f4c 4446 4c41 77_LIBRARY_LDFLA │ │ │ │ │ -00034cf0: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ -00034d00: 2020 204f 7074 696f 6e61 6c2e 2020 2020 Optional. │ │ │ │ │ -00034d10: 2020 2020 2020 2020 286c 696e 6520 2039 (line 9 │ │ │ │ │ -00034d20: 3629 0a2a 2041 435f 4643 5f53 5243 4558 6).* AC_FC_SRCEX │ │ │ │ │ -00034d30: 543a 2020 2020 2020 2020 2020 2020 2020 T: │ │ │ │ │ -00034d40: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ -00034d50: 6f6e 616c 2e20 2020 2020 2020 2020 2020 onal. │ │ │ │ │ -00034d60: 2028 6c69 6e65 2031 3032 290a 2a20 4143 (line 102).* AC │ │ │ │ │ -00034d70: 5f49 4e49 543a 2020 2020 2020 2020 2020 _INIT: │ │ │ │ │ +00034cb0: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ +00034cc0: 6469 6e67 2061 636c 6f63 616c 2e20 2020 ding aclocal. │ │ │ │ │ +00034cd0: 286c 696e 6520 2033 3629 0a2a 2041 435f (line 36).* AC_ │ │ │ │ │ +00034ce0: 4637 375f 4c49 4252 4152 595f 4c44 464c F77_LIBRARY_LDFL │ │ │ │ │ +00034cf0: 4147 533a 2020 2020 2020 2020 2020 2020 AGS: │ │ │ │ │ +00034d00: 2020 2020 4f70 7469 6f6e 616c 2e20 2020 Optional. │ │ │ │ │ +00034d10: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00034d20: 3936 290a 2a20 4143 5f46 435f 5352 4345 96).* AC_FC_SRCE │ │ │ │ │ +00034d30: 5854 3a20 2020 2020 2020 2020 2020 2020 XT: │ │ │ │ │ +00034d40: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ +00034d50: 696f 6e61 6c2e 2020 2020 2020 2020 2020 ional. │ │ │ │ │ +00034d60: 2020 286c 696e 6520 3130 3229 0a2a 2041 (line 102).* A │ │ │ │ │ +00034d70: 435f 494e 4954 3a20 2020 2020 2020 2020 C_INIT: │ │ │ │ │ 00034d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034d90: 2020 2020 2050 7562 6c69 6320 4d61 6372 Public Macr │ │ │ │ │ -00034da0: 6f73 2e20 2020 2020 2020 286c 696e 6520 os. (line │ │ │ │ │ -00034db0: 2033 3129 0a2a 2041 435f 4c49 424f 424a 31).* AC_LIBOBJ │ │ │ │ │ -00034dc0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00034dd0: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ -00034de0: 7469 6f6e 616c 2e20 2020 2020 2020 2020 tional. │ │ │ │ │ -00034df0: 2020 2028 6c69 6e65 2020 3633 290a 2a20 (line 63).* │ │ │ │ │ -00034e00: 4143 5f4c 4942 4f42 4a20 3c31 3e3a 2020 AC_LIBOBJ <1>: │ │ │ │ │ +00034d90: 2020 2020 2020 5075 626c 6963 204d 6163 Public Mac │ │ │ │ │ +00034da0: 726f 732e 2020 2020 2020 2028 6c69 6e65 ros. (line │ │ │ │ │ +00034db0: 2020 3331 290a 2a20 4143 5f4c 4942 4f42 31).* AC_LIBOB │ │ │ │ │ +00034dc0: 4a3a 2020 2020 2020 2020 2020 2020 2020 J: │ │ │ │ │ +00034dd0: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +00034de0: 7074 696f 6e61 6c2e 2020 2020 2020 2020 ptional. │ │ │ │ │ +00034df0: 2020 2020 286c 696e 6520 2036 3329 0a2a (line 63).* │ │ │ │ │ +00034e00: 2041 435f 4c49 424f 424a 203c 313e 3a20 AC_LIBOBJ <1>: │ │ │ │ │ 00034e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034e20: 2020 2020 2020 204c 544c 4942 4f42 4a53 LTLIBOBJS │ │ │ │ │ -00034e30: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -00034e40: 6520 2020 3629 0a2a 2041 435f 4c49 424f e 6).* AC_LIBO │ │ │ │ │ -00034e50: 424a 203c 323e 3a20 2020 2020 2020 2020 BJ <2>: │ │ │ │ │ +00034e20: 2020 2020 2020 2020 4c54 4c49 424f 424a LTLIBOBJ │ │ │ │ │ +00034e30: 532e 2020 2020 2020 2020 2020 2028 6c69 S. (li │ │ │ │ │ +00034e40: 6e65 2020 2036 290a 2a20 4143 5f4c 4942 ne 6).* AC_LIB │ │ │ │ │ +00034e50: 4f42 4a20 3c32 3e3a 2020 2020 2020 2020 OBJ <2>: │ │ │ │ │ 00034e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034e70: 4c49 424f 424a 532e 2020 2020 2020 2020 LIBOBJS. │ │ │ │ │ -00034e80: 2020 2020 2028 6c69 6e65 2020 3131 290a (line 11). │ │ │ │ │ -00034e90: 2a20 4143 5f4c 4942 534f 5552 4345 3a20 * AC_LIBSOURCE: │ │ │ │ │ +00034e70: 204c 4942 4f42 4a53 2e20 2020 2020 2020 LIBOBJS. │ │ │ │ │ +00034e80: 2020 2020 2020 286c 696e 6520 2031 3129 (line 11) │ │ │ │ │ +00034e90: 0a2a 2041 435f 4c49 4253 4f55 5243 453a .* AC_LIBSOURCE: │ │ │ │ │ 00034ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034eb0: 2020 2020 2020 2020 204f 7074 696f 6e61 Optiona │ │ │ │ │ -00034ec0: 6c2e 2020 2020 2020 2020 2020 2020 286c l. (l │ │ │ │ │ -00034ed0: 696e 6520 2036 3429 0a2a 2041 435f 4c49 ine 64).* AC_LI │ │ │ │ │ -00034ee0: 4253 4f55 5243 4520 3c31 3e3a 2020 2020 BSOURCE <1>: │ │ │ │ │ +00034eb0: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +00034ec0: 616c 2e20 2020 2020 2020 2020 2020 2028 al. ( │ │ │ │ │ +00034ed0: 6c69 6e65 2020 3634 290a 2a20 4143 5f4c line 64).* AC_L │ │ │ │ │ +00034ee0: 4942 534f 5552 4345 203c 313e 3a20 2020 IBSOURCE <1>: │ │ │ │ │ 00034ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034f00: 2020 4c49 424f 424a 532e 2020 2020 2020 LIBOBJS. │ │ │ │ │ -00034f10: 2020 2020 2020 2028 6c69 6e65 2020 3137 (line 17 │ │ │ │ │ -00034f20: 290a 2a20 4143 5f4c 4942 534f 5552 4345 ).* AC_LIBSOURCE │ │ │ │ │ -00034f30: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -00034f40: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00034f50: 6e61 6c2e 2020 2020 2020 2020 2020 2020 nal. │ │ │ │ │ -00034f60: 286c 696e 6520 2036 3529 0a2a 2041 435f (line 65).* AC_ │ │ │ │ │ -00034f70: 4f55 5450 5554 3a20 2020 2020 2020 2020 OUTPUT: │ │ │ │ │ +00034f00: 2020 204c 4942 4f42 4a53 2e20 2020 2020 LIBOBJS. │ │ │ │ │ +00034f10: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +00034f20: 3729 0a2a 2041 435f 4c49 4253 4f55 5243 7).* AC_LIBSOURC │ │ │ │ │ +00034f30: 4553 3a20 2020 2020 2020 2020 2020 2020 ES: │ │ │ │ │ +00034f40: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00034f50: 6f6e 616c 2e20 2020 2020 2020 2020 2020 onal. │ │ │ │ │ +00034f60: 2028 6c69 6e65 2020 3635 290a 2a20 4143 (line 65).* AC │ │ │ │ │ +00034f70: 5f4f 5554 5055 543a 2020 2020 2020 2020 _OUTPUT: │ │ │ │ │ 00034f80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034f90: 2020 2020 5265 7175 6972 656d 656e 7473 Requirements │ │ │ │ │ -00034fa0: 2e20 2020 2020 2020 2028 6c69 6e65 2020 . (line │ │ │ │ │ -00034fb0: 3135 290a 2a20 4143 5f50 5245 5245 513a 15).* AC_PREREQ: │ │ │ │ │ -00034fc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00034fd0: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -00034fe0: 656e 6469 6e67 2061 636c 6f63 616c 2e20 ending aclocal. │ │ │ │ │ -00034ff0: 2020 286c 696e 6520 2033 3629 0a2a 2041 (line 36).* A │ │ │ │ │ -00035000: 435f 5052 4f47 5f43 435f 435f 4f3a 2020 C_PROG_CC_C_O: │ │ │ │ │ +00034f90: 2020 2020 2052 6571 7569 7265 6d65 6e74 Requirement │ │ │ │ │ +00034fa0: 732e 2020 2020 2020 2020 286c 696e 6520 s. (line │ │ │ │ │ +00034fb0: 2031 3529 0a2a 2041 435f 5052 4552 4551 15).* AC_PREREQ │ │ │ │ │ +00034fc0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00034fd0: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +00034fe0: 7465 6e64 696e 6720 6163 6c6f 6361 6c2e tending aclocal. │ │ │ │ │ +00034ff0: 2020 2028 6c69 6e65 2020 3336 290a 2a20 (line 36).* │ │ │ │ │ +00035000: 4143 5f50 524f 475f 4343 5f43 5f4f 3a20 AC_PROG_CC_C_O: │ │ │ │ │ 00035010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035020: 2020 2020 2020 5075 626c 6963 204d 6163 Public Mac │ │ │ │ │ -00035030: 726f 732e 2020 2020 2020 2028 6c69 6e65 ros. (line │ │ │ │ │ -00035040: 2020 3933 290a 2a20 4143 5f50 524f 475f 93).* AC_PROG_ │ │ │ │ │ -00035050: 4358 583a 2020 2020 2020 2020 2020 2020 CXX: │ │ │ │ │ -00035060: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ -00035070: 7074 696f 6e61 6c2e 2020 2020 2020 2020 ptional. │ │ │ │ │ -00035080: 2020 2020 286c 696e 6520 2038 3329 0a2a (line 83).* │ │ │ │ │ -00035090: 2041 435f 5052 4f47 5f46 3737 3a20 2020 AC_PROG_F77: │ │ │ │ │ +00035020: 2020 2020 2020 2050 7562 6c69 6320 4d61 Public Ma │ │ │ │ │ +00035030: 6372 6f73 2e20 2020 2020 2020 286c 696e cros. (lin │ │ │ │ │ +00035040: 6520 2039 3329 0a2a 2041 435f 5052 4f47 e 93).* AC_PROG │ │ │ │ │ +00035050: 5f43 5858 3a20 2020 2020 2020 2020 2020 _CXX: │ │ │ │ │ +00035060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00035070: 4f70 7469 6f6e 616c 2e20 2020 2020 2020 Optional. │ │ │ │ │ +00035080: 2020 2020 2028 6c69 6e65 2020 3833 290a (line 83). │ │ │ │ │ +00035090: 2a20 4143 5f50 524f 475f 4637 373a 2020 * AC_PROG_F77: │ │ │ │ │ 000350a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000350b0: 2020 2020 2020 2020 4f70 7469 6f6e 616c Optional │ │ │ │ │ -000350c0: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ │ -000350d0: 6e65 2020 3931 290a 2a20 4143 5f50 524f ne 91).* AC_PRO │ │ │ │ │ -000350e0: 475f 4643 3a20 2020 2020 2020 2020 2020 G_FC: │ │ │ │ │ +000350b0: 2020 2020 2020 2020 204f 7074 696f 6e61 Optiona │ │ │ │ │ +000350c0: 6c2e 2020 2020 2020 2020 2020 2020 286c l. (l │ │ │ │ │ +000350d0: 696e 6520 2039 3129 0a2a 2041 435f 5052 ine 91).* AC_PR │ │ │ │ │ +000350e0: 4f47 5f46 433a 2020 2020 2020 2020 2020 OG_FC: │ │ │ │ │ 000350f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035100: 204f 7074 696f 6e61 6c2e 2020 2020 2020 Optional. │ │ │ │ │ -00035110: 2020 2020 2020 286c 696e 6520 3130 3729 (line 107) │ │ │ │ │ -00035120: 0a2a 2041 435f 5052 4f47 5f4c 4558 3a20 .* AC_PROG_LEX: │ │ │ │ │ +00035100: 2020 4f70 7469 6f6e 616c 2e20 2020 2020 Optional. │ │ │ │ │ +00035110: 2020 2020 2020 2028 6c69 6e65 2031 3037 (line 107 │ │ │ │ │ +00035120: 290a 2a20 4143 5f50 524f 475f 4c45 583a ).* AC_PROG_LEX: │ │ │ │ │ 00035130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035140: 2020 2020 2020 2020 2020 5075 626c 6963 Public │ │ │ │ │ -00035150: 204d 6163 726f 732e 2020 2020 2020 2028 Macros. ( │ │ │ │ │ -00035160: 6c69 6e65 2020 3939 290a 2a20 4143 5f50 line 99).* AC_P │ │ │ │ │ -00035170: 524f 475f 4c45 5820 3c31 3e3a 2020 2020 ROG_LEX <1>: │ │ │ │ │ +00035140: 2020 2020 2020 2020 2020 2050 7562 6c69 Publi │ │ │ │ │ +00035150: 6320 4d61 6372 6f73 2e20 2020 2020 2020 c Macros. │ │ │ │ │ +00035160: 286c 696e 6520 2039 3929 0a2a 2041 435f (line 99).* AC_ │ │ │ │ │ +00035170: 5052 4f47 5f4c 4558 203c 313e 3a20 2020 PROG_LEX <1>: │ │ │ │ │ 00035180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035190: 2020 204f 7074 696f 6e61 6c2e 2020 2020 Optional. │ │ │ │ │ -000351a0: 2020 2020 2020 2020 286c 696e 6520 3132 (line 12 │ │ │ │ │ -000351b0: 3229 0a2a 2041 435f 5052 4f47 5f4c 4942 2).* AC_PROG_LIB │ │ │ │ │ -000351c0: 544f 4f4c 3a20 2020 2020 2020 2020 2020 TOOL: │ │ │ │ │ -000351d0: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ -000351e0: 6f6e 616c 2e20 2020 2020 2020 2020 2020 onal. │ │ │ │ │ -000351f0: 2028 6c69 6e65 2031 3132 290a 2a20 4143 (line 112).* AC │ │ │ │ │ -00035200: 5f50 524f 475f 4f42 4a43 3a20 2020 2020 _PROG_OBJC: │ │ │ │ │ +00035190: 2020 2020 4f70 7469 6f6e 616c 2e20 2020 Optional. │ │ │ │ │ +000351a0: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +000351b0: 3232 290a 2a20 4143 5f50 524f 475f 4c49 22).* AC_PROG_LI │ │ │ │ │ +000351c0: 4254 4f4f 4c3a 2020 2020 2020 2020 2020 BTOOL: │ │ │ │ │ +000351d0: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ +000351e0: 696f 6e61 6c2e 2020 2020 2020 2020 2020 ional. │ │ │ │ │ +000351f0: 2020 286c 696e 6520 3131 3229 0a2a 2041 (line 112).* A │ │ │ │ │ +00035200: 435f 5052 4f47 5f4f 424a 433a 2020 2020 C_PROG_OBJC: │ │ │ │ │ 00035210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035220: 2020 2020 204f 7074 696f 6e61 6c2e 2020 Optional. │ │ │ │ │ -00035230: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00035240: 2038 3729 0a2a 2041 435f 5052 4f47 5f52 87).* AC_PROG_R │ │ │ │ │ -00035250: 414e 4c49 423a 2020 2020 2020 2020 2020 ANLIB: │ │ │ │ │ -00035260: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ -00035270: 7469 6f6e 616c 2e20 2020 2020 2020 2020 tional. │ │ │ │ │ -00035280: 2020 2028 6c69 6e65 2020 3739 290a 2a20 (line 79).* │ │ │ │ │ -00035290: 4143 5f50 524f 475f 5941 4343 3a20 2020 AC_PROG_YACC: │ │ │ │ │ +00035220: 2020 2020 2020 4f70 7469 6f6e 616c 2e20 Optional. │ │ │ │ │ +00035230: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00035240: 2020 3837 290a 2a20 4143 5f50 524f 475f 87).* AC_PROG_ │ │ │ │ │ +00035250: 5241 4e4c 4942 3a20 2020 2020 2020 2020 RANLIB: │ │ │ │ │ +00035260: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +00035270: 7074 696f 6e61 6c2e 2020 2020 2020 2020 ptional. │ │ │ │ │ +00035280: 2020 2020 286c 696e 6520 2037 3929 0a2a (line 79).* │ │ │ │ │ +00035290: 2041 435f 5052 4f47 5f59 4143 433a 2020 AC_PROG_YACC: │ │ │ │ │ 000352a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000352b0: 2020 2020 2020 204f 7074 696f 6e61 6c2e Optional. │ │ │ │ │ -000352c0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -000352d0: 6520 3131 3629 0a2a 2041 435f 5245 5155 e 116).* AC_REQU │ │ │ │ │ -000352e0: 4952 455f 4155 585f 4649 4c45 3a20 2020 IRE_AUX_FILE: │ │ │ │ │ +000352b0: 2020 2020 2020 2020 4f70 7469 6f6e 616c Optional │ │ │ │ │ +000352c0: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ │ +000352d0: 6e65 2031 3136 290a 2a20 4143 5f52 4551 ne 116).* AC_REQ │ │ │ │ │ +000352e0: 5549 5245 5f41 5558 5f46 494c 453a 2020 UIRE_AUX_FILE: │ │ │ │ │ 000352f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035300: 4f70 7469 6f6e 616c 2e20 2020 2020 2020 Optional. │ │ │ │ │ -00035310: 2020 2020 2028 6c69 6e65 2031 3236 290a (line 126). │ │ │ │ │ -00035320: 2a20 4143 5f53 5542 5354 3a20 2020 2020 * AC_SUBST: │ │ │ │ │ +00035300: 204f 7074 696f 6e61 6c2e 2020 2020 2020 Optional. │ │ │ │ │ +00035310: 2020 2020 2020 286c 696e 6520 3132 3629 (line 126) │ │ │ │ │ +00035320: 0a2a 2041 435f 5355 4253 543a 2020 2020 .* AC_SUBST: │ │ │ │ │ 00035330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035340: 2020 2020 2020 2020 204f 7074 696f 6e61 Optiona │ │ │ │ │ -00035350: 6c2e 2020 2020 2020 2020 2020 2020 286c l. (l │ │ │ │ │ -00035360: 696e 6520 3133 3429 0a2a 2041 4d5f 434f ine 134).* AM_CO │ │ │ │ │ -00035370: 4e44 4954 494f 4e41 4c3a 2020 2020 2020 NDITIONAL: │ │ │ │ │ +00035340: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +00035350: 616c 2e20 2020 2020 2020 2020 2020 2028 al. ( │ │ │ │ │ +00035360: 6c69 6e65 2031 3334 290a 2a20 414d 5f43 line 134).* AM_C │ │ │ │ │ +00035370: 4f4e 4449 5449 4f4e 414c 3a20 2020 2020 ONDITIONAL: │ │ │ │ │ 00035380: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035390: 2020 4f70 7469 6f6e 616c 2e20 2020 2020 Optional. │ │ │ │ │ -000353a0: 2020 2020 2020 2028 6c69 6e65 2031 3532 (line 152 │ │ │ │ │ -000353b0: 290a 2a20 414d 5f43 4f4e 4449 5449 4f4e ).* AM_CONDITION │ │ │ │ │ -000353c0: 414c 203c 313e 3a20 2020 2020 2020 2020 AL <1>: │ │ │ │ │ -000353d0: 2020 2020 2020 2020 2020 2055 7361 6765 Usage │ │ │ │ │ -000353e0: 206f 6620 436f 6e64 6974 696f 6e61 6c73 of Conditionals │ │ │ │ │ -000353f0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00035390: 2020 204f 7074 696f 6e61 6c2e 2020 2020 Optional. │ │ │ │ │ +000353a0: 2020 2020 2020 2020 286c 696e 6520 3135 (line 15 │ │ │ │ │ +000353b0: 3229 0a2a 2041 4d5f 434f 4e44 4954 494f 2).* AM_CONDITIO │ │ │ │ │ +000353c0: 4e41 4c20 3c31 3e3a 2020 2020 2020 2020 NAL <1>: │ │ │ │ │ +000353d0: 2020 2020 2020 2020 2020 2020 5573 6167 Usag │ │ │ │ │ +000353e0: 6520 6f66 2043 6f6e 6469 7469 6f6e 616c e of Conditional │ │ │ │ │ +000353f0: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ 00035400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00035410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00035420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035430: 286c 696e 6520 2020 3629 0a2a 2041 4d5f (line 6).* AM_ │ │ │ │ │ -00035440: 434f 4e44 4954 494f 4e41 4c20 3c32 3e3a CONDITIONAL <2>: │ │ │ │ │ -00035450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035460: 2020 2020 5573 6167 6520 6f66 2043 6f6e Usage of Con │ │ │ │ │ -00035470: 6469 7469 6f6e 616c 732e 0a20 2020 2020 ditionals.. │ │ │ │ │ +00035430: 2028 6c69 6e65 2020 2036 290a 2a20 414d (line 6).* AM │ │ │ │ │ +00035440: 5f43 4f4e 4449 5449 4f4e 414c 203c 323e _CONDITIONAL <2> │ │ │ │ │ +00035450: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00035460: 2020 2020 2055 7361 6765 206f 6620 436f Usage of Co │ │ │ │ │ +00035470: 6e64 6974 696f 6e61 6c73 2e0a 2020 2020 nditionals.. │ │ │ │ │ 00035480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00035490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000354a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000354b0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000354c0: 2039 290a 2a20 414d 5f43 4f4e 445f 4946 9).* AM_COND_IF │ │ │ │ │ -000354d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000354e0: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ -000354f0: 696f 6e61 6c2e 2020 2020 2020 2020 2020 ional. │ │ │ │ │ -00035500: 2020 286c 696e 6520 3135 3529 0a2a 2041 (line 155).* A │ │ │ │ │ -00035510: 4d5f 434f 4e44 5f49 4620 3c31 3e3a 2020 M_COND_IF <1>: │ │ │ │ │ +000354b0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000354c0: 2020 3929 0a2a 2041 4d5f 434f 4e44 5f49 9).* AM_COND_I │ │ │ │ │ +000354d0: 463a 2020 2020 2020 2020 2020 2020 2020 F: │ │ │ │ │ +000354e0: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ +000354f0: 7469 6f6e 616c 2e20 2020 2020 2020 2020 tional. │ │ │ │ │ +00035500: 2020 2028 6c69 6e65 2031 3535 290a 2a20 (line 155).* │ │ │ │ │ +00035510: 414d 5f43 4f4e 445f 4946 203c 313e 3a20 AM_COND_IF <1>: │ │ │ │ │ 00035520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035530: 2020 2020 2020 5573 6167 6520 6f66 2043 Usage of C │ │ │ │ │ -00035540: 6f6e 6469 7469 6f6e 616c 732e 0a20 2020 onditionals.. │ │ │ │ │ +00035530: 2020 2020 2020 2055 7361 6765 206f 6620 Usage of │ │ │ │ │ +00035540: 436f 6e64 6974 696f 6e61 6c73 2e0a 2020 Conditionals.. │ │ │ │ │ 00035550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00035560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00035570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035580: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00035590: 2020 3636 290a 2a20 414d 5f43 4f4e 445f 66).* AM_COND_ │ │ │ │ │ -000355a0: 4946 203c 323e 3a20 2020 2020 2020 2020 IF <2>: │ │ │ │ │ -000355b0: 2020 2020 2020 2020 2020 2020 2020 2055 U │ │ │ │ │ -000355c0: 7361 6765 206f 6620 436f 6e64 6974 696f sage of Conditio │ │ │ │ │ -000355d0: 6e61 6c73 2e0a 2020 2020 2020 2020 2020 nals.. │ │ │ │ │ +00035580: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00035590: 6520 2036 3629 0a2a 2041 4d5f 434f 4e44 e 66).* AM_COND │ │ │ │ │ +000355a0: 5f49 4620 3c32 3e3a 2020 2020 2020 2020 _IF <2>: │ │ │ │ │ +000355b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000355c0: 5573 6167 6520 6f66 2043 6f6e 6469 7469 Usage of Conditi │ │ │ │ │ +000355d0: 6f6e 616c 732e 0a20 2020 2020 2020 2020 onals.. │ │ │ │ │ 000355e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000355f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00035600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035610: 2020 2020 286c 696e 6520 2037 3029 0a2a (line 70).* │ │ │ │ │ -00035620: 2041 4d5f 434f 4e46 4947 5f48 4541 4445 AM_CONFIG_HEADE │ │ │ │ │ -00035630: 523a 2020 2020 2020 2020 2020 2020 2020 R: │ │ │ │ │ -00035640: 2020 2020 2020 2020 4f62 736f 6c65 7465 Obsolete │ │ │ │ │ -00035650: 204d 6163 726f 732e 2020 2020 2028 6c69 Macros. (li │ │ │ │ │ -00035660: 6e65 2020 3233 290a 2a20 414d 5f43 5f50 ne 23).* AM_C_P │ │ │ │ │ -00035670: 524f 544f 5459 5045 533a 2020 2020 2020 ROTOTYPES: │ │ │ │ │ +00035610: 2020 2020 2028 6c69 6e65 2020 3730 290a (line 70). │ │ │ │ │ +00035620: 2a20 414d 5f43 4f4e 4649 475f 4845 4144 * AM_CONFIG_HEAD │ │ │ │ │ +00035630: 4552 3a20 2020 2020 2020 2020 2020 2020 ER: │ │ │ │ │ +00035640: 2020 2020 2020 2020 204f 6273 6f6c 6574 Obsolet │ │ │ │ │ +00035650: 6520 4d61 6372 6f73 2e20 2020 2020 286c e Macros. (l │ │ │ │ │ +00035660: 696e 6520 2032 3329 0a2a 2041 4d5f 435f ine 23).* AM_C_ │ │ │ │ │ +00035670: 5052 4f54 4f54 5950 4553 3a20 2020 2020 PROTOTYPES: │ │ │ │ │ 00035680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035690: 204f 6273 6f6c 6574 6520 4d61 6372 6f73 Obsolete Macros │ │ │ │ │ -000356a0: 2e20 2020 2020 286c 696e 6520 2031 3329 . (line 13) │ │ │ │ │ -000356b0: 0a2a 2041 4d5f 435f 5052 4f54 4f54 5950 .* AM_C_PROTOTYP │ │ │ │ │ -000356c0: 4553 203c 313e 3a20 2020 2020 2020 2020 ES <1>: │ │ │ │ │ -000356d0: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ -000356e0: 616c 2e20 2020 2020 2020 2020 2020 2028 al. ( │ │ │ │ │ -000356f0: 6c69 6e65 2031 3437 290a 2a20 414d 5f43 line 147).* AM_C │ │ │ │ │ -00035700: 5f50 524f 544f 5459 5045 5320 3c32 3e3a _PROTOTYPES <2>: │ │ │ │ │ -00035710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035720: 2020 2041 4e53 492e 2020 2020 2020 2020 ANSI. │ │ │ │ │ -00035730: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ -00035740: 3529 0a2a 2041 4d5f 4445 505f 5452 4143 5).* AM_DEP_TRAC │ │ │ │ │ -00035750: 4b3a 2020 2020 2020 2020 2020 2020 2020 K: │ │ │ │ │ -00035760: 2020 2020 2020 2020 2020 2020 5072 6976 Priv │ │ │ │ │ -00035770: 6174 6520 4d61 6372 6f73 2e20 2020 2020 ate Macros. │ │ │ │ │ -00035780: 2028 6c69 6e65 2020 3134 290a 2a20 414d (line 14).* AM │ │ │ │ │ -00035790: 5f45 4e41 424c 455f 4d55 4c54 494c 4942 _ENABLE_MULTILIB │ │ │ │ │ -000357a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000357b0: 2020 2020 2050 7562 6c69 6320 4d61 6372 Public Macr │ │ │ │ │ -000357c0: 6f73 2e20 2020 2020 2020 286c 696e 6520 os. (line │ │ │ │ │ -000357d0: 2020 3729 0a2a 2041 4d5f 474e 555f 4745 7).* AM_GNU_GE │ │ │ │ │ -000357e0: 5454 4558 543a 2020 2020 2020 2020 2020 TTEXT: │ │ │ │ │ -000357f0: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ -00035800: 7469 6f6e 616c 2e20 2020 2020 2020 2020 tional. │ │ │ │ │ -00035810: 2020 2028 6c69 6e65 2031 3631 290a 2a20 (line 161).* │ │ │ │ │ -00035820: 414d 5f47 4e55 5f47 4554 5445 5854 5f49 AM_GNU_GETTEXT_I │ │ │ │ │ -00035830: 4e54 4c5f 5355 4244 4952 3a20 2020 2020 NTL_SUBDIR: │ │ │ │ │ -00035840: 2020 2020 2020 204f 7074 696f 6e61 6c2e Optional. │ │ │ │ │ -00035850: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00035860: 6520 3136 3729 0a2a 2041 4d5f 4845 4144 e 167).* AM_HEAD │ │ │ │ │ -00035870: 4552 5f54 494f 4347 5749 4e53 5a5f 4e45 ER_TIOCGWINSZ_NE │ │ │ │ │ -00035880: 4544 535f 5359 535f 494f 4354 4c3a 2020 EDS_SYS_IOCTL: │ │ │ │ │ -00035890: 4f62 736f 6c65 7465 204d 6163 726f 732e Obsolete Macros. │ │ │ │ │ -000358a0: 2020 2020 2028 6c69 6e65 2020 3238 290a (line 28). │ │ │ │ │ -000358b0: 2a20 414d 5f49 4e49 545f 4155 544f 4d41 * AM_INIT_AUTOMA │ │ │ │ │ -000358c0: 4b45 3a20 2020 2020 2020 2020 2020 2020 KE: │ │ │ │ │ -000358d0: 2020 2020 2020 2020 2052 6571 7569 7265 Require │ │ │ │ │ -000358e0: 6d65 6e74 732e 2020 2020 2020 2020 286c ments. (l │ │ │ │ │ -000358f0: 696e 6520 2020 3629 0a2a 2041 4d5f 494e ine 6).* AM_IN │ │ │ │ │ -00035900: 4954 5f41 5554 4f4d 414b 4520 3c31 3e3a IT_AUTOMAKE <1>: │ │ │ │ │ -00035910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035920: 2020 5075 626c 6963 204d 6163 726f 732e Public Macros. │ │ │ │ │ -00035930: 2020 2020 2020 2028 6c69 6e65 2020 3232 (line 22 │ │ │ │ │ -00035940: 290a 2a20 414d 5f4d 4149 4e54 4149 4e45 ).* AM_MAINTAINE │ │ │ │ │ -00035950: 525f 4d4f 4445 3a20 2020 2020 2020 2020 R_MODE: │ │ │ │ │ -00035960: 2020 2020 2020 2020 2020 2052 6562 7569 Rebui │ │ │ │ │ -00035970: 6c64 696e 672e 2020 2020 2020 2020 2020 lding. │ │ │ │ │ -00035980: 286c 696e 6520 2020 3929 0a2a 2041 4d5f (line 9).* AM_ │ │ │ │ │ -00035990: 4d41 494e 5441 494e 4552 5f4d 4f44 4520 MAINTAINER_MODE │ │ │ │ │ -000359a0: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ -000359b0: 2020 2020 6d61 696e 7461 696e 6572 2d6d maintainer-m │ │ │ │ │ -000359c0: 6f64 652e 2020 2020 2028 6c69 6e65 2020 ode. (line │ │ │ │ │ -000359d0: 3336 290a 2a20 414d 5f4d 4149 4e54 4149 36).* AM_MAINTAI │ │ │ │ │ -000359e0: 4e45 525f 4d4f 4445 285b 4445 4641 554c NER_MODE([DEFAUL │ │ │ │ │ -000359f0: 542d 4d4f 4445 5d29 3a20 2020 204f 7074 T-MODE]): Opt │ │ │ │ │ -00035a00: 696f 6e61 6c2e 2020 2020 2020 2020 2020 ional. │ │ │ │ │ -00035a10: 2020 286c 696e 6520 3137 3229 0a2a 2041 (line 172).* A │ │ │ │ │ -00035a20: 4d5f 4d41 4b45 5f49 4e43 4c55 4445 3a20 M_MAKE_INCLUDE: │ │ │ │ │ +00035690: 2020 4f62 736f 6c65 7465 204d 6163 726f Obsolete Macro │ │ │ │ │ +000356a0: 732e 2020 2020 2028 6c69 6e65 2020 3133 s. (line 13 │ │ │ │ │ +000356b0: 290a 2a20 414d 5f43 5f50 524f 544f 5459 ).* AM_C_PROTOTY │ │ │ │ │ +000356c0: 5045 5320 3c31 3e3a 2020 2020 2020 2020 PES <1>: │ │ │ │ │ +000356d0: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ +000356e0: 6e61 6c2e 2020 2020 2020 2020 2020 2020 nal. │ │ │ │ │ +000356f0: 286c 696e 6520 3134 3729 0a2a 2041 4d5f (line 147).* AM_ │ │ │ │ │ +00035700: 435f 5052 4f54 4f54 5950 4553 203c 323e C_PROTOTYPES <2> │ │ │ │ │ +00035710: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00035720: 2020 2020 414e 5349 2e20 2020 2020 2020 ANSI. │ │ │ │ │ +00035730: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00035740: 3335 290a 2a20 414d 5f44 4550 5f54 5241 35).* AM_DEP_TRA │ │ │ │ │ +00035750: 434b 3a20 2020 2020 2020 2020 2020 2020 CK: │ │ │ │ │ +00035760: 2020 2020 2020 2020 2020 2020 2050 7269 Pri │ │ │ │ │ +00035770: 7661 7465 204d 6163 726f 732e 2020 2020 vate Macros. │ │ │ │ │ +00035780: 2020 286c 696e 6520 2031 3429 0a2a 2041 (line 14).* A │ │ │ │ │ +00035790: 4d5f 454e 4142 4c45 5f4d 554c 5449 4c49 M_ENABLE_MULTILI │ │ │ │ │ +000357a0: 423a 2020 2020 2020 2020 2020 2020 2020 B: │ │ │ │ │ +000357b0: 2020 2020 2020 5075 626c 6963 204d 6163 Public Mac │ │ │ │ │ +000357c0: 726f 732e 2020 2020 2020 2028 6c69 6e65 ros. (line │ │ │ │ │ +000357d0: 2020 2037 290a 2a20 414d 5f47 4e55 5f47 7).* AM_GNU_G │ │ │ │ │ +000357e0: 4554 5445 5854 3a20 2020 2020 2020 2020 ETTEXT: │ │ │ │ │ +000357f0: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +00035800: 7074 696f 6e61 6c2e 2020 2020 2020 2020 ptional. │ │ │ │ │ +00035810: 2020 2020 286c 696e 6520 3136 3129 0a2a (line 161).* │ │ │ │ │ +00035820: 2041 4d5f 474e 555f 4745 5454 4558 545f AM_GNU_GETTEXT_ │ │ │ │ │ +00035830: 494e 544c 5f53 5542 4449 523a 2020 2020 INTL_SUBDIR: │ │ │ │ │ +00035840: 2020 2020 2020 2020 4f70 7469 6f6e 616c Optional │ │ │ │ │ +00035850: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ │ +00035860: 6e65 2031 3637 290a 2a20 414d 5f48 4541 ne 167).* AM_HEA │ │ │ │ │ +00035870: 4445 525f 5449 4f43 4757 494e 535a 5f4e DER_TIOCGWINSZ_N │ │ │ │ │ +00035880: 4545 4453 5f53 5953 5f49 4f43 544c 3a20 EEDS_SYS_IOCTL: │ │ │ │ │ +00035890: 204f 6273 6f6c 6574 6520 4d61 6372 6f73 Obsolete Macros │ │ │ │ │ +000358a0: 2e20 2020 2020 286c 696e 6520 2032 3829 . (line 28) │ │ │ │ │ +000358b0: 0a2a 2041 4d5f 494e 4954 5f41 5554 4f4d .* AM_INIT_AUTOM │ │ │ │ │ +000358c0: 414b 453a 2020 2020 2020 2020 2020 2020 AKE: │ │ │ │ │ +000358d0: 2020 2020 2020 2020 2020 5265 7175 6972 Requir │ │ │ │ │ +000358e0: 656d 656e 7473 2e20 2020 2020 2020 2028 ements. ( │ │ │ │ │ +000358f0: 6c69 6e65 2020 2036 290a 2a20 414d 5f49 line 6).* AM_I │ │ │ │ │ +00035900: 4e49 545f 4155 544f 4d41 4b45 203c 313e NIT_AUTOMAKE <1> │ │ │ │ │ +00035910: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00035920: 2020 2050 7562 6c69 6320 4d61 6372 6f73 Public Macros │ │ │ │ │ +00035930: 2e20 2020 2020 2020 286c 696e 6520 2032 . (line 2 │ │ │ │ │ +00035940: 3229 0a2a 2041 4d5f 4d41 494e 5441 494e 2).* AM_MAINTAIN │ │ │ │ │ +00035950: 4552 5f4d 4f44 453a 2020 2020 2020 2020 ER_MODE: │ │ │ │ │ +00035960: 2020 2020 2020 2020 2020 2020 5265 6275 Rebu │ │ │ │ │ +00035970: 696c 6469 6e67 2e20 2020 2020 2020 2020 ilding. │ │ │ │ │ +00035980: 2028 6c69 6e65 2020 2039 290a 2a20 414d (line 9).* AM │ │ │ │ │ +00035990: 5f4d 4149 4e54 4149 4e45 525f 4d4f 4445 _MAINTAINER_MODE │ │ │ │ │ +000359a0: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +000359b0: 2020 2020 206d 6169 6e74 6169 6e65 722d maintainer- │ │ │ │ │ +000359c0: 6d6f 6465 2e20 2020 2020 286c 696e 6520 mode. (line │ │ │ │ │ +000359d0: 2033 3629 0a2a 2041 4d5f 4d41 494e 5441 36).* AM_MAINTA │ │ │ │ │ +000359e0: 494e 4552 5f4d 4f44 4528 5b44 4546 4155 INER_MODE([DEFAU │ │ │ │ │ +000359f0: 4c54 2d4d 4f44 455d 293a 2020 2020 4f70 LT-MODE]): Op │ │ │ │ │ +00035a00: 7469 6f6e 616c 2e20 2020 2020 2020 2020 tional. │ │ │ │ │ +00035a10: 2020 2028 6c69 6e65 2031 3732 290a 2a20 (line 172).* │ │ │ │ │ +00035a20: 414d 5f4d 414b 455f 494e 434c 5544 453a AM_MAKE_INCLUDE: │ │ │ │ │ 00035a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035a40: 2020 2020 2020 5072 6976 6174 6520 4d61 Private Ma │ │ │ │ │ -00035a50: 6372 6f73 2e20 2020 2020 2028 6c69 6e65 cros. (line │ │ │ │ │ -00035a60: 2020 3230 290a 2a20 414d 5f4f 5554 5055 20).* AM_OUTPU │ │ │ │ │ -00035a70: 545f 4445 5045 4e44 454e 4359 5f43 4f4d T_DEPENDENCY_COM │ │ │ │ │ -00035a80: 4d41 4e44 533a 2020 2020 2020 2020 2050 MANDS: P │ │ │ │ │ -00035a90: 7269 7661 7465 204d 6163 726f 732e 2020 rivate Macros. │ │ │ │ │ -00035aa0: 2020 2020 286c 696e 6520 2031 3529 0a2a (line 15).* │ │ │ │ │ -00035ab0: 2041 4d5f 5041 5448 5f4c 4953 5044 4952 AM_PATH_LISPDIR │ │ │ │ │ -00035ac0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00035ad0: 2020 2020 2020 2020 5075 626c 6963 204d Public M │ │ │ │ │ -00035ae0: 6163 726f 732e 2020 2020 2020 2028 6c69 acros. (li │ │ │ │ │ -00035af0: 6e65 2020 3636 290a 2a20 414d 5f50 4154 ne 66).* AM_PAT │ │ │ │ │ -00035b00: 485f 5059 5448 4f4e 3a20 2020 2020 2020 H_PYTHON: │ │ │ │ │ +00035a40: 2020 2020 2020 2050 7269 7661 7465 204d Private M │ │ │ │ │ +00035a50: 6163 726f 732e 2020 2020 2020 286c 696e acros. (lin │ │ │ │ │ +00035a60: 6520 2032 3029 0a2a 2041 4d5f 4f55 5450 e 20).* AM_OUTP │ │ │ │ │ +00035a70: 5554 5f44 4550 454e 4445 4e43 595f 434f UT_DEPENDENCY_CO │ │ │ │ │ +00035a80: 4d4d 414e 4453 3a20 2020 2020 2020 2020 MMANDS: │ │ │ │ │ +00035a90: 5072 6976 6174 6520 4d61 6372 6f73 2e20 Private Macros. │ │ │ │ │ +00035aa0: 2020 2020 2028 6c69 6e65 2020 3135 290a (line 15). │ │ │ │ │ +00035ab0: 2a20 414d 5f50 4154 485f 4c49 5350 4449 * AM_PATH_LISPDI │ │ │ │ │ +00035ac0: 523a 2020 2020 2020 2020 2020 2020 2020 R: │ │ │ │ │ +00035ad0: 2020 2020 2020 2020 2050 7562 6c69 6320 Public │ │ │ │ │ +00035ae0: 4d61 6372 6f73 2e20 2020 2020 2020 286c Macros. (l │ │ │ │ │ +00035af0: 696e 6520 2036 3629 0a2a 2041 4d5f 5041 ine 66).* AM_PA │ │ │ │ │ +00035b00: 5448 5f50 5954 484f 4e3a 2020 2020 2020 TH_PYTHON: │ │ │ │ │ 00035b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035b20: 2050 7974 686f 6e2e 2020 2020 2020 2020 Python. │ │ │ │ │ -00035b30: 2020 2020 2020 286c 696e 6520 2032 3829 (line 28) │ │ │ │ │ -00035b40: 0a2a 2041 4d5f 5052 4f47 5f41 523a 2020 .* AM_PROG_AR: │ │ │ │ │ +00035b20: 2020 5079 7468 6f6e 2e20 2020 2020 2020 Python. │ │ │ │ │ +00035b30: 2020 2020 2020 2028 6c69 6e65 2020 3238 (line 28 │ │ │ │ │ +00035b40: 290a 2a20 414d 5f50 524f 475f 4152 3a20 ).* AM_PROG_AR: │ │ │ │ │ 00035b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035b60: 2020 2020 2020 2020 2020 5075 626c 6963 Public │ │ │ │ │ -00035b70: 204d 6163 726f 732e 2020 2020 2020 2028 Macros. ( │ │ │ │ │ -00035b80: 6c69 6e65 2020 3831 290a 2a20 414d 5f50 line 81).* AM_P │ │ │ │ │ -00035b90: 524f 475f 4153 3a20 2020 2020 2020 2020 ROG_AS: │ │ │ │ │ +00035b60: 2020 2020 2020 2020 2020 2050 7562 6c69 Publi │ │ │ │ │ +00035b70: 6320 4d61 6372 6f73 2e20 2020 2020 2020 c Macros. │ │ │ │ │ +00035b80: 286c 696e 6520 2038 3129 0a2a 2041 4d5f (line 81).* AM_ │ │ │ │ │ +00035b90: 5052 4f47 5f41 533a 2020 2020 2020 2020 PROG_AS: │ │ │ │ │ 00035ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035bb0: 2020 2050 7562 6c69 6320 4d61 6372 6f73 Public Macros │ │ │ │ │ -00035bc0: 2e20 2020 2020 2020 286c 696e 6520 2038 . (line 8 │ │ │ │ │ -00035bd0: 3829 0a2a 2041 4d5f 5052 4f47 5f43 435f 8).* AM_PROG_CC_ │ │ │ │ │ -00035be0: 435f 4f3a 2020 2020 2020 2020 2020 2020 C_O: │ │ │ │ │ -00035bf0: 2020 2020 2020 2020 2020 2020 5075 626c Publ │ │ │ │ │ -00035c00: 6963 204d 6163 726f 732e 2020 2020 2020 ic Macros. │ │ │ │ │ -00035c10: 2028 6c69 6e65 2020 3933 290a 2a20 414d (line 93).* AM │ │ │ │ │ -00035c20: 5f50 524f 475f 4743 4a3a 2020 2020 2020 _PROG_GCJ: │ │ │ │ │ +00035bb0: 2020 2020 5075 626c 6963 204d 6163 726f Public Macro │ │ │ │ │ +00035bc0: 732e 2020 2020 2020 2028 6c69 6e65 2020 s. (line │ │ │ │ │ +00035bd0: 3838 290a 2a20 414d 5f50 524f 475f 4343 88).* AM_PROG_CC │ │ │ │ │ +00035be0: 5f43 5f4f 3a20 2020 2020 2020 2020 2020 _C_O: │ │ │ │ │ +00035bf0: 2020 2020 2020 2020 2020 2020 2050 7562 Pub │ │ │ │ │ +00035c00: 6c69 6320 4d61 6372 6f73 2e20 2020 2020 lic Macros. │ │ │ │ │ +00035c10: 2020 286c 696e 6520 2039 3329 0a2a 2041 (line 93).* A │ │ │ │ │ +00035c20: 4d5f 5052 4f47 5f47 434a 3a20 2020 2020 M_PROG_GCJ: │ │ │ │ │ 00035c30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035c40: 2020 2020 2050 7562 6c69 6320 4d61 6372 Public Macr │ │ │ │ │ -00035c50: 6f73 2e20 2020 2020 2020 286c 696e 6520 os. (line │ │ │ │ │ -00035c60: 3130 3429 0a2a 2041 4d5f 5052 4f47 5f49 104).* AM_PROG_I │ │ │ │ │ -00035c70: 4e53 5441 4c4c 5f53 5452 4950 3a20 2020 NSTALL_STRIP: │ │ │ │ │ -00035c80: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ -00035c90: 6976 6174 6520 4d61 6372 6f73 2e20 2020 ivate Macros. │ │ │ │ │ -00035ca0: 2020 2028 6c69 6e65 2020 3235 290a 2a20 (line 25).* │ │ │ │ │ -00035cb0: 414d 5f50 524f 475f 4c45 583a 2020 2020 AM_PROG_LEX: │ │ │ │ │ +00035c40: 2020 2020 2020 5075 626c 6963 204d 6163 Public Mac │ │ │ │ │ +00035c50: 726f 732e 2020 2020 2020 2028 6c69 6e65 ros. (line │ │ │ │ │ +00035c60: 2031 3034 290a 2a20 414d 5f50 524f 475f 104).* AM_PROG_ │ │ │ │ │ +00035c70: 494e 5354 414c 4c5f 5354 5249 503a 2020 INSTALL_STRIP: │ │ │ │ │ +00035c80: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +00035c90: 7269 7661 7465 204d 6163 726f 732e 2020 rivate Macros. │ │ │ │ │ +00035ca0: 2020 2020 286c 696e 6520 2032 3529 0a2a (line 25).* │ │ │ │ │ +00035cb0: 2041 4d5f 5052 4f47 5f4c 4558 3a20 2020 AM_PROG_LEX: │ │ │ │ │ 00035cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035cd0: 2020 2020 2020 2050 7562 6c69 6320 4d61 Public Ma │ │ │ │ │ -00035ce0: 6372 6f73 2e20 2020 2020 2020 286c 696e cros. (lin │ │ │ │ │ -00035cf0: 6520 2039 3929 0a2a 2041 4d5f 5052 4f47 e 99).* AM_PROG │ │ │ │ │ -00035d00: 5f4d 4b44 4952 5f50 3a20 2020 2020 2020 _MKDIR_P: │ │ │ │ │ +00035cd0: 2020 2020 2020 2020 5075 626c 6963 204d Public M │ │ │ │ │ +00035ce0: 6163 726f 732e 2020 2020 2020 2028 6c69 acros. (li │ │ │ │ │ +00035cf0: 6e65 2020 3939 290a 2a20 414d 5f50 524f ne 99).* AM_PRO │ │ │ │ │ +00035d00: 475f 4d4b 4449 525f 503a 2020 2020 2020 G_MKDIR_P: │ │ │ │ │ 00035d10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035d20: 4f62 736f 6c65 7465 204d 6163 726f 732e Obsolete Macros. │ │ │ │ │ -00035d30: 2020 2020 2028 6c69 6e65 2020 3334 290a (line 34). │ │ │ │ │ -00035d40: 2a20 414d 5f50 524f 475f 5550 433a 2020 * AM_PROG_UPC: │ │ │ │ │ +00035d20: 204f 6273 6f6c 6574 6520 4d61 6372 6f73 Obsolete Macros │ │ │ │ │ +00035d30: 2e20 2020 2020 286c 696e 6520 2033 3429 . (line 34) │ │ │ │ │ +00035d40: 0a2a 2041 4d5f 5052 4f47 5f55 5043 3a20 .* AM_PROG_UPC: │ │ │ │ │ 00035d50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035d60: 2020 2020 2020 2020 2050 7562 6c69 6320 Public │ │ │ │ │ -00035d70: 4d61 6372 6f73 2e20 2020 2020 2020 286c Macros. (l │ │ │ │ │ -00035d80: 696e 6520 3130 3929 0a2a 2041 4d5f 5052 ine 109).* AM_PR │ │ │ │ │ -00035d90: 4f47 5f56 414c 4143 3a20 2020 2020 2020 OG_VALAC: │ │ │ │ │ +00035d60: 2020 2020 2020 2020 2020 5075 626c 6963 Public │ │ │ │ │ +00035d70: 204d 6163 726f 732e 2020 2020 2020 2028 Macros. ( │ │ │ │ │ +00035d80: 6c69 6e65 2031 3039 290a 2a20 414d 5f50 line 109).* AM_P │ │ │ │ │ +00035d90: 524f 475f 5641 4c41 433a 2020 2020 2020 ROG_VALAC: │ │ │ │ │ 00035da0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035db0: 2020 5661 6c61 2053 7570 706f 7274 2e20 Vala Support. │ │ │ │ │ -00035dc0: 2020 2020 2020 2028 6c69 6e65 2020 3230 (line 20 │ │ │ │ │ -00035dd0: 290a 2a20 414d 5f53 414e 4954 595f 4348 ).* AM_SANITY_CH │ │ │ │ │ -00035de0: 4543 4b3a 2020 2020 2020 2020 2020 2020 ECK: │ │ │ │ │ -00035df0: 2020 2020 2020 2020 2020 2050 7269 7661 Priva │ │ │ │ │ -00035e00: 7465 204d 6163 726f 732e 2020 2020 2020 te Macros. │ │ │ │ │ -00035e10: 286c 696e 6520 2033 3029 0a2a 2041 4d5f (line 30).* AM_ │ │ │ │ │ -00035e20: 5345 545f 4445 5044 4952 3a20 2020 2020 SET_DEPDIR: │ │ │ │ │ +00035db0: 2020 2056 616c 6120 5375 7070 6f72 742e Vala Support. │ │ │ │ │ +00035dc0: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +00035dd0: 3029 0a2a 2041 4d5f 5341 4e49 5459 5f43 0).* AM_SANITY_C │ │ │ │ │ +00035de0: 4845 434b 3a20 2020 2020 2020 2020 2020 HECK: │ │ │ │ │ +00035df0: 2020 2020 2020 2020 2020 2020 5072 6976 Priv │ │ │ │ │ +00035e00: 6174 6520 4d61 6372 6f73 2e20 2020 2020 ate Macros. │ │ │ │ │ +00035e10: 2028 6c69 6e65 2020 3330 290a 2a20 414d (line 30).* AM │ │ │ │ │ +00035e20: 5f53 4554 5f44 4550 4449 523a 2020 2020 _SET_DEPDIR: │ │ │ │ │ 00035e30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035e40: 2020 2020 5072 6976 6174 6520 4d61 6372 Private Macr │ │ │ │ │ -00035e50: 6f73 2e20 2020 2020 2028 6c69 6e65 2020 os. (line │ │ │ │ │ -00035e60: 3133 290a 2a20 414d 5f53 494c 454e 545f 13).* AM_SILENT_ │ │ │ │ │ -00035e70: 5255 4c45 533a 2020 2020 2020 2020 2020 RULES: │ │ │ │ │ -00035e80: 2020 2020 2020 2020 2020 2020 2050 7562 Pub │ │ │ │ │ -00035e90: 6c69 6320 4d61 6372 6f73 2e20 2020 2020 lic Macros. │ │ │ │ │ -00035ea0: 2020 286c 696e 6520 3131 3529 0a2a 2041 (line 115).* A │ │ │ │ │ -00035eb0: 4d5f 5355 4253 545f 4e4f 544d 414b 4528 M_SUBST_NOTMAKE( │ │ │ │ │ -00035ec0: 5641 5229 3a20 2020 2020 2020 2020 2020 VAR): │ │ │ │ │ -00035ed0: 2020 2020 2020 4f70 7469 6f6e 616c 2e20 Optional. │ │ │ │ │ -00035ee0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00035ef0: 2031 3830 290a 2a20 414d 5f53 5953 5f50 180).* AM_SYS_P │ │ │ │ │ -00035f00: 4f53 4958 5f54 4552 4d49 4f53 3a20 2020 OSIX_TERMIOS: │ │ │ │ │ -00035f10: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ -00035f20: 6273 6f6c 6574 6520 4d61 6372 6f73 2e20 bsolete Macros. │ │ │ │ │ -00035f30: 2020 2020 286c 696e 6520 2035 3729 0a2a (line 57).* │ │ │ │ │ -00035f40: 2041 4d5f 5749 5448 5f44 4d41 4c4c 4f43 AM_WITH_DMALLOC │ │ │ │ │ -00035f50: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00035f60: 2020 2020 2020 2020 5075 626c 6963 204d Public M │ │ │ │ │ -00035f70: 6163 726f 732e 2020 2020 2020 2028 6c69 acros. (li │ │ │ │ │ -00035f80: 6e65 2031 3139 290a 2a20 414d 5f57 4954 ne 119).* AM_WIT │ │ │ │ │ -00035f90: 485f 5245 4745 583a 2020 2020 2020 2020 H_REGEX: │ │ │ │ │ +00035e40: 2020 2020 2050 7269 7661 7465 204d 6163 Private Mac │ │ │ │ │ +00035e50: 726f 732e 2020 2020 2020 286c 696e 6520 ros. (line │ │ │ │ │ +00035e60: 2031 3329 0a2a 2041 4d5f 5349 4c45 4e54 13).* AM_SILENT │ │ │ │ │ +00035e70: 5f52 554c 4553 3a20 2020 2020 2020 2020 _RULES: │ │ │ │ │ +00035e80: 2020 2020 2020 2020 2020 2020 2020 5075 Pu │ │ │ │ │ +00035e90: 626c 6963 204d 6163 726f 732e 2020 2020 blic Macros. │ │ │ │ │ +00035ea0: 2020 2028 6c69 6e65 2031 3135 290a 2a20 (line 115).* │ │ │ │ │ +00035eb0: 414d 5f53 5542 5354 5f4e 4f54 4d41 4b45 AM_SUBST_NOTMAKE │ │ │ │ │ +00035ec0: 2856 4152 293a 2020 2020 2020 2020 2020 (VAR): │ │ │ │ │ +00035ed0: 2020 2020 2020 204f 7074 696f 6e61 6c2e Optional. │ │ │ │ │ +00035ee0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00035ef0: 6520 3138 3029 0a2a 2041 4d5f 5359 535f e 180).* AM_SYS_ │ │ │ │ │ +00035f00: 504f 5349 585f 5445 524d 494f 533a 2020 POSIX_TERMIOS: │ │ │ │ │ +00035f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00035f20: 4f62 736f 6c65 7465 204d 6163 726f 732e Obsolete Macros. │ │ │ │ │ +00035f30: 2020 2020 2028 6c69 6e65 2020 3537 290a (line 57). │ │ │ │ │ +00035f40: 2a20 414d 5f57 4954 485f 444d 414c 4c4f * AM_WITH_DMALLO │ │ │ │ │ +00035f50: 433a 2020 2020 2020 2020 2020 2020 2020 C: │ │ │ │ │ +00035f60: 2020 2020 2020 2020 2050 7562 6c69 6320 Public │ │ │ │ │ +00035f70: 4d61 6372 6f73 2e20 2020 2020 2020 286c Macros. (l │ │ │ │ │ +00035f80: 696e 6520 3131 3929 0a2a 2041 4d5f 5749 ine 119).* AM_WI │ │ │ │ │ +00035f90: 5448 5f52 4547 4558 3a20 2020 2020 2020 TH_REGEX: │ │ │ │ │ 00035fa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035fb0: 204f 6273 6f6c 6574 6520 4d61 6372 6f73 Obsolete Macros │ │ │ │ │ -00035fc0: 2e20 2020 2020 286c 696e 6520 2036 3429 . (line 64) │ │ │ │ │ -00035fd0: 0a2a 206d 345f 696e 636c 7564 653a 2020 .* m4_include: │ │ │ │ │ +00035fb0: 2020 4f62 736f 6c65 7465 204d 6163 726f Obsolete Macro │ │ │ │ │ +00035fc0: 732e 2020 2020 2028 6c69 6e65 2020 3634 s. (line 64 │ │ │ │ │ +00035fd0: 290a 2a20 6d34 5f69 6e63 6c75 6465 3a20 ).* m4_include: │ │ │ │ │ 00035fe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00035ff0: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ -00036000: 616c 2e20 2020 2020 2020 2020 2020 2028 al. ( │ │ │ │ │ -00036010: 6c69 6e65 2031 3930 290a 2a20 6d34 5f69 line 190).* m4_i │ │ │ │ │ -00036020: 6e63 6c75 6465 203c 313e 3a20 2020 2020 nclude <1>: │ │ │ │ │ +00035ff0: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ +00036000: 6e61 6c2e 2020 2020 2020 2020 2020 2020 nal. │ │ │ │ │ +00036010: 286c 696e 6520 3139 3029 0a2a 206d 345f (line 190).* m4_ │ │ │ │ │ +00036020: 696e 636c 7564 6520 3c31 3e3a 2020 2020 include <1>: │ │ │ │ │ 00036030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036040: 2020 2042 6173 6963 7320 6f66 2044 6973 Basics of Dis │ │ │ │ │ -00036050: 7472 6962 7574 696f 6e2e 0a20 2020 2020 tribution.. │ │ │ │ │ +00036040: 2020 2020 4261 7369 6373 206f 6620 4469 Basics of Di │ │ │ │ │ +00036050: 7374 7269 6275 7469 6f6e 2e0a 2020 2020 stribution.. │ │ │ │ │ 00036060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036090: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000360a0: 3133 290a 0a1f 0a46 696c 653a 2061 7574 13)....File: aut │ │ │ │ │ -000360b0: 6f6d 616b 652d 312e 3131 2e69 6e66 6f2c omake-1.11.info, │ │ │ │ │ -000360c0: 2020 4e6f 6465 3a20 5661 7269 6162 6c65 Node: Variable │ │ │ │ │ -000360d0: 2049 6e64 6578 2c20 204e 6578 743a 2047 Index, Next: G │ │ │ │ │ -000360e0: 656e 6572 616c 2049 6e64 6578 2c20 2050 eneral Index, P │ │ │ │ │ -000360f0: 7265 763a 204d 6163 726f 2049 6e64 6578 rev: Macro Index │ │ │ │ │ -00036100: 2c20 2055 703a 2049 6e64 6963 6573 0a0a , Up: Indices.. │ │ │ │ │ -00036110: 422e 3220 5661 7269 6162 6c65 2049 6e64 B.2 Variable Ind │ │ │ │ │ -00036120: 6578 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ex.============= │ │ │ │ │ -00036130: 3d3d 3d3d 3d0a 0a00 085b 696e 6465 7800 =====....[index. │ │ │ │ │ -00036140: 085d 0a2a 204d 656e 753a 0a0a 2a20 5f44 .].* Menu:..* _D │ │ │ │ │ -00036150: 4154 413a 2020 2020 2020 2020 2020 2020 ATA: │ │ │ │ │ +00036090: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000360a0: 2031 3329 0a0a 1f0a 4669 6c65 3a20 6175 13)....File: au │ │ │ │ │ +000360b0: 746f 6d61 6b65 2d31 2e31 312e 696e 666f tomake-1.11.info │ │ │ │ │ +000360c0: 2c20 204e 6f64 653a 2056 6172 6961 626c , Node: Variabl │ │ │ │ │ +000360d0: 6520 496e 6465 782c 2020 4e65 7874 3a20 e Index, Next: │ │ │ │ │ +000360e0: 4765 6e65 7261 6c20 496e 6465 782c 2020 General Index, │ │ │ │ │ +000360f0: 5072 6576 3a20 4d61 6372 6f20 496e 6465 Prev: Macro Inde │ │ │ │ │ +00036100: 782c 2020 5570 3a20 496e 6469 6365 730a x, Up: Indices. │ │ │ │ │ +00036110: 0a42 2e32 2056 6172 6961 626c 6520 496e .B.2 Variable In │ │ │ │ │ +00036120: 6465 780a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d dex.============ │ │ │ │ │ +00036130: 3d3d 3d3d 3d3d 0a0a 0008 5b69 6e64 6578 ======....[index │ │ │ │ │ +00036140: 0008 5d0a 2a20 4d65 6e75 3a0a 0a2a 205f ..].* Menu:..* _ │ │ │ │ │ +00036150: 4441 5441 3a20 2020 2020 2020 2020 2020 DATA: │ │ │ │ │ 00036160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036170: 2020 2020 2044 6174 612e 2020 2020 2020 Data. │ │ │ │ │ -00036180: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00036190: 2020 3629 0a2a 205f 4845 4144 4552 533a 6).* _HEADERS: │ │ │ │ │ -000361a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000361b0: 2020 2020 2020 2020 2020 2020 2020 4865 He │ │ │ │ │ -000361c0: 6164 6572 732e 2020 2020 2020 2020 2020 aders. │ │ │ │ │ -000361d0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -000361e0: 5f4c 4942 5241 5249 4553 3a20 2020 2020 _LIBRARIES: │ │ │ │ │ +00036170: 2020 2020 2020 4461 7461 2e20 2020 2020 Data. │ │ │ │ │ +00036180: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00036190: 2020 2036 290a 2a20 5f48 4541 4445 5253 6).* _HEADERS │ │ │ │ │ +000361a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000361b0: 2020 2020 2020 2020 2020 2020 2020 2048 H │ │ │ │ │ +000361c0: 6561 6465 7273 2e20 2020 2020 2020 2020 eaders. │ │ │ │ │ +000361d0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +000361e0: 205f 4c49 4252 4152 4945 533a 2020 2020 _LIBRARIES: │ │ │ │ │ 000361f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036200: 2020 2020 2020 2041 204c 6962 7261 7279 A Library │ │ │ │ │ -00036210: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -00036220: 6520 2020 3629 0a2a 205f 4c49 5350 3a20 e 6).* _LISP: │ │ │ │ │ +00036200: 2020 2020 2020 2020 4120 4c69 6272 6172 A Librar │ │ │ │ │ +00036210: 792e 2020 2020 2020 2020 2020 2028 6c69 y. (li │ │ │ │ │ +00036220: 6e65 2020 2036 290a 2a20 5f4c 4953 503a ne 6).* _LISP: │ │ │ │ │ 00036230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036240: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036250: 456d 6163 7320 4c69 7370 2e20 2020 2020 Emacs Lisp. │ │ │ │ │ -00036260: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -00036270: 2a20 5f4c 4f47 5f43 4f4d 5049 4c45 3a20 * _LOG_COMPILE: │ │ │ │ │ +00036250: 2045 6d61 6373 204c 6973 702e 2020 2020 Emacs Lisp. │ │ │ │ │ +00036260: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +00036270: 0a2a 205f 4c4f 475f 434f 4d50 494c 453a .* _LOG_COMPILE: │ │ │ │ │ 00036280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036290: 2020 2020 2020 2020 2053 696d 706c 6520 Simple │ │ │ │ │ -000362a0: 5465 7374 7320 7573 696e 6720 7061 7261 Tests using para │ │ │ │ │ -000362b0: 6c6c 656c 2d74 6573 7473 2e0a 2020 2020 llel-tests.. │ │ │ │ │ +00036290: 2020 2020 2020 2020 2020 5369 6d70 6c65 Simple │ │ │ │ │ +000362a0: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ +000362b0: 616c 6c65 6c2d 7465 7374 732e 0a20 2020 allel-tests.. │ │ │ │ │ 000362c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000362d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000362e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000362f0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00036300: 2033 3929 0a2a 205f 4c4f 475f 434f 4d50 39).* _LOG_COMP │ │ │ │ │ -00036310: 494c 4552 3a20 2020 2020 2020 2020 2020 ILER: │ │ │ │ │ -00036320: 2020 2020 2020 2020 2020 2020 2020 5369 Si │ │ │ │ │ -00036330: 6d70 6c65 2054 6573 7473 2075 7369 6e67 mple Tests using │ │ │ │ │ -00036340: 2070 6172 616c 6c65 6c2d 7465 7374 732e parallel-tests. │ │ │ │ │ -00036350: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000362f0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00036300: 2020 3339 290a 2a20 5f4c 4f47 5f43 4f4d 39).* _LOG_COM │ │ │ │ │ +00036310: 5049 4c45 523a 2020 2020 2020 2020 2020 PILER: │ │ │ │ │ +00036320: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ +00036330: 696d 706c 6520 5465 7374 7320 7573 696e imple Tests usin │ │ │ │ │ +00036340: 6720 7061 7261 6c6c 656c 2d74 6573 7473 g parallel-tests │ │ │ │ │ +00036350: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 00036360: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036380: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00036390: 6c69 6e65 2020 3339 290a 2a20 5f4c 4f47 line 39).* _LOG │ │ │ │ │ -000363a0: 5f46 4c41 4753 3a20 2020 2020 2020 2020 _FLAGS: │ │ │ │ │ +00036380: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00036390: 286c 696e 6520 2033 3929 0a2a 205f 4c4f (line 39).* _LO │ │ │ │ │ +000363a0: 475f 464c 4147 533a 2020 2020 2020 2020 G_FLAGS: │ │ │ │ │ 000363b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000363c0: 2020 2053 696d 706c 6520 5465 7374 7320 Simple Tests │ │ │ │ │ -000363d0: 7573 696e 6720 7061 7261 6c6c 656c 2d74 using parallel-t │ │ │ │ │ -000363e0: 6573 7473 2e0a 2020 2020 2020 2020 2020 ests.. │ │ │ │ │ +000363c0: 2020 2020 5369 6d70 6c65 2054 6573 7473 Simple Tests │ │ │ │ │ +000363d0: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ +000363e0: 7465 7374 732e 0a20 2020 2020 2020 2020 tests.. │ │ │ │ │ 000363f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036420: 2020 2020 286c 696e 6520 2033 3929 0a2a (line 39).* │ │ │ │ │ -00036430: 205f 4c54 4c49 4252 4152 4945 533a 2020 _LTLIBRARIES: │ │ │ │ │ +00036420: 2020 2020 2028 6c69 6e65 2020 3339 290a (line 39). │ │ │ │ │ +00036430: 2a20 5f4c 544c 4942 5241 5249 4553 3a20 * _LTLIBRARIES: │ │ │ │ │ 00036440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036450: 2020 2020 2020 2020 4c69 6274 6f6f 6c20 Libtool │ │ │ │ │ -00036460: 4c69 6272 6172 6965 732e 2020 2028 6c69 Libraries. (li │ │ │ │ │ -00036470: 6e65 2020 2036 290a 2a20 5f4d 414e 533a ne 6).* _MANS: │ │ │ │ │ -00036480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00036450: 2020 2020 2020 2020 204c 6962 746f 6f6c Libtool │ │ │ │ │ +00036460: 204c 6962 7261 7269 6573 2e20 2020 286c Libraries. (l │ │ │ │ │ +00036470: 696e 6520 2020 3629 0a2a 205f 4d41 4e53 ine 6).* _MANS │ │ │ │ │ +00036480: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00036490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000364a0: 204d 616e 2050 6167 6573 2e20 2020 2020 Man Pages. │ │ │ │ │ -000364b0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -000364c0: 0a2a 205f 5052 4f47 5241 4d53 3a20 2020 .* _PROGRAMS: │ │ │ │ │ +000364a0: 2020 4d61 6e20 5061 6765 732e 2020 2020 Man Pages. │ │ │ │ │ +000364b0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +000364c0: 290a 2a20 5f50 524f 4752 414d 533a 2020 ).* _PROGRAMS: │ │ │ │ │ 000364d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000364e0: 2020 2020 2020 2020 2020 556e 6966 6f72 Unifor │ │ │ │ │ -000364f0: 6d2e 2020 2020 2020 2020 2020 2020 2028 m. ( │ │ │ │ │ -00036500: 6c69 6e65 2020 3131 290a 2a20 5f50 524f line 11).* _PRO │ │ │ │ │ -00036510: 4752 414d 5320 3c31 3e3a 2020 2020 2020 GRAMS <1>: │ │ │ │ │ +000364e0: 2020 2020 2020 2020 2020 2055 6e69 666f Unifo │ │ │ │ │ +000364f0: 726d 2e20 2020 2020 2020 2020 2020 2020 rm. │ │ │ │ │ +00036500: 286c 696e 6520 2031 3129 0a2a 205f 5052 (line 11).* _PR │ │ │ │ │ +00036510: 4f47 5241 4d53 203c 313e 3a20 2020 2020 OGRAMS <1>: │ │ │ │ │ 00036520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036530: 2020 2050 726f 6772 616d 2053 6f75 7263 Program Sourc │ │ │ │ │ -00036540: 6573 2e20 2020 2020 286c 696e 6520 2020 es. (line │ │ │ │ │ -00036550: 3629 0a2a 205f 5059 5448 4f4e 3a20 2020 6).* _PYTHON: │ │ │ │ │ +00036530: 2020 2020 5072 6f67 7261 6d20 536f 7572 Program Sour │ │ │ │ │ +00036540: 6365 732e 2020 2020 2028 6c69 6e65 2020 ces. (line │ │ │ │ │ +00036550: 2036 290a 2a20 5f50 5954 484f 4e3a 2020 6).* _PYTHON: │ │ │ │ │ 00036560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036570: 2020 2020 2020 2020 2020 2020 5079 7468 Pyth │ │ │ │ │ -00036580: 6f6e 2e20 2020 2020 2020 2020 2020 2020 on. │ │ │ │ │ -00036590: 2028 6c69 6e65 2020 2036 290a 2a20 5f53 (line 6).* _S │ │ │ │ │ -000365a0: 4352 4950 5453 3a20 2020 2020 2020 2020 CRIPTS: │ │ │ │ │ +00036570: 2020 2020 2020 2020 2020 2020 2050 7974 Pyt │ │ │ │ │ +00036580: 686f 6e2e 2020 2020 2020 2020 2020 2020 hon. │ │ │ │ │ +00036590: 2020 286c 696e 6520 2020 3629 0a2a 205f (line 6).* _ │ │ │ │ │ +000365a0: 5343 5249 5054 533a 2020 2020 2020 2020 SCRIPTS: │ │ │ │ │ 000365b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000365c0: 2020 2020 2053 6372 6970 7473 2e20 2020 Scripts. │ │ │ │ │ -000365d0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -000365e0: 2020 3629 0a2a 205f 534f 5552 4345 533a 6).* _SOURCES: │ │ │ │ │ -000365f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036600: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ -00036610: 6f67 7261 6d20 536f 7572 6365 732e 2020 ogram Sources. │ │ │ │ │ -00036620: 2020 2028 6c69 6e65 2020 3332 290a 2a20 (line 32).* │ │ │ │ │ -00036630: 5f53 4f55 5243 4553 203c 313e 3a20 2020 _SOURCES <1>: │ │ │ │ │ +000365c0: 2020 2020 2020 5363 7269 7074 732e 2020 Scripts. │ │ │ │ │ +000365d0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +000365e0: 2020 2036 290a 2a20 5f53 4f55 5243 4553 6).* _SOURCES │ │ │ │ │ +000365f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00036600: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +00036610: 726f 6772 616d 2053 6f75 7263 6573 2e20 rogram Sources. │ │ │ │ │ +00036620: 2020 2020 286c 696e 6520 2033 3229 0a2a (line 32).* │ │ │ │ │ +00036630: 205f 534f 5552 4345 5320 3c31 3e3a 2020 _SOURCES <1>: │ │ │ │ │ 00036640: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036650: 2020 2020 2020 2050 726f 6772 616d 2053 Program S │ │ │ │ │ -00036660: 6f75 7263 6573 2e20 2020 2020 286c 696e ources. (lin │ │ │ │ │ -00036670: 6520 2033 3329 0a2a 205f 534f 5552 4345 e 33).* _SOURCE │ │ │ │ │ -00036680: 5320 3c32 3e3a 2020 2020 2020 2020 2020 S <2>: │ │ │ │ │ +00036650: 2020 2020 2020 2020 5072 6f67 7261 6d20 Program │ │ │ │ │ +00036660: 536f 7572 6365 732e 2020 2020 2028 6c69 Sources. (li │ │ │ │ │ +00036670: 6e65 2020 3333 290a 2a20 5f53 4f55 5243 ne 33).* _SOURC │ │ │ │ │ +00036680: 4553 203c 323e 3a20 2020 2020 2020 2020 ES <2>: │ │ │ │ │ 00036690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000366a0: 4465 6661 756c 7420 5f53 4f55 5243 4553 Default _SOURCES │ │ │ │ │ -000366b0: 2e20 2020 2028 6c69 6e65 2020 2036 290a . (line 6). │ │ │ │ │ -000366c0: 2a20 5f54 4558 494e 464f 533a 2020 2020 * _TEXINFOS: │ │ │ │ │ +000366a0: 2044 6566 6175 6c74 205f 534f 5552 4345 Default _SOURCE │ │ │ │ │ +000366b0: 532e 2020 2020 286c 696e 6520 2020 3629 S. (line 6) │ │ │ │ │ +000366c0: 0a2a 205f 5445 5849 4e46 4f53 3a20 2020 .* _TEXINFOS: │ │ │ │ │ 000366d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000366e0: 2020 2020 2020 2020 2054 6578 696e 666f Texinfo │ │ │ │ │ -000366f0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -00036700: 696e 6520 2020 3629 0a2a 205f 5445 5849 ine 6).* _TEXI │ │ │ │ │ -00036710: 4e46 4f53 203c 313e 3a20 2020 2020 2020 NFOS <1>: │ │ │ │ │ +000366e0: 2020 2020 2020 2020 2020 5465 7869 6e66 Texinf │ │ │ │ │ +000366f0: 6f2e 2020 2020 2020 2020 2020 2020 2028 o. ( │ │ │ │ │ +00036700: 6c69 6e65 2020 2036 290a 2a20 5f54 4558 line 6).* _TEX │ │ │ │ │ +00036710: 494e 464f 5320 3c31 3e3a 2020 2020 2020 INFOS <1>: │ │ │ │ │ 00036720: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036730: 2020 5465 7869 6e66 6f2e 2020 2020 2020 Texinfo. │ │ │ │ │ -00036740: 2020 2020 2020 2028 6c69 6e65 2020 3539 (line 59 │ │ │ │ │ -00036750: 290a 2a20 4143 4c4f 4341 4c5f 414d 464c ).* ACLOCAL_AMFL │ │ │ │ │ -00036760: 4147 533a 2020 2020 2020 2020 2020 2020 AGS: │ │ │ │ │ -00036770: 2020 2020 2020 2020 2020 204c 6f63 616c Local │ │ │ │ │ -00036780: 204d 6163 726f 732e 2020 2020 2020 2020 Macros. │ │ │ │ │ -00036790: 286c 696e 6520 2031 3929 0a2a 2041 434c (line 19).* ACL │ │ │ │ │ -000367a0: 4f43 414c 5f41 4d46 4c41 4753 203c 313e OCAL_AMFLAGS <1> │ │ │ │ │ -000367b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000367c0: 2020 2020 5265 6275 696c 6469 6e67 2e20 Rebuilding. │ │ │ │ │ -000367d0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000367e0: 3132 290a 2a20 414c 4c4f 4341 3a20 2020 12).* ALLOCA: │ │ │ │ │ +00036730: 2020 2054 6578 696e 666f 2e20 2020 2020 Texinfo. │ │ │ │ │ +00036740: 2020 2020 2020 2020 286c 696e 6520 2035 (line 5 │ │ │ │ │ +00036750: 3929 0a2a 2041 434c 4f43 414c 5f41 4d46 9).* ACLOCAL_AMF │ │ │ │ │ +00036760: 4c41 4753 3a20 2020 2020 2020 2020 2020 LAGS: │ │ │ │ │ +00036770: 2020 2020 2020 2020 2020 2020 4c6f 6361 Loca │ │ │ │ │ +00036780: 6c20 4d61 6372 6f73 2e20 2020 2020 2020 l Macros. │ │ │ │ │ +00036790: 2028 6c69 6e65 2020 3139 290a 2a20 4143 (line 19).* AC │ │ │ │ │ +000367a0: 4c4f 4341 4c5f 414d 464c 4147 5320 3c31 LOCAL_AMFLAGS <1 │ │ │ │ │ +000367b0: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +000367c0: 2020 2020 2052 6562 7569 6c64 696e 672e Rebuilding. │ │ │ │ │ +000367d0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000367e0: 2031 3229 0a2a 2041 4c4c 4f43 413a 2020 12).* ALLOCA: │ │ │ │ │ 000367f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036800: 2020 2020 2020 2020 2020 2020 204c 544c LTL │ │ │ │ │ -00036810: 4942 4f42 4a53 2e20 2020 2020 2020 2020 IBOBJS. │ │ │ │ │ -00036820: 2020 286c 696e 6520 2020 3629 0a2a 2041 (line 6).* A │ │ │ │ │ -00036830: 4c4c 4f43 4120 3c31 3e3a 2020 2020 2020 LLOCA <1>: │ │ │ │ │ +00036800: 2020 2020 2020 2020 2020 2020 2020 4c54 LT │ │ │ │ │ +00036810: 4c49 424f 424a 532e 2020 2020 2020 2020 LIBOBJS. │ │ │ │ │ +00036820: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +00036830: 414c 4c4f 4341 203c 313e 3a20 2020 2020 ALLOCA <1>: │ │ │ │ │ 00036840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036850: 2020 2020 2020 4c49 424f 424a 532e 2020 LIBOBJS. │ │ │ │ │ -00036860: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00036870: 2020 2036 290a 2a20 414d 5f43 4341 5346 6).* AM_CCASF │ │ │ │ │ -00036880: 4c41 4753 3a20 2020 2020 2020 2020 2020 LAGS: │ │ │ │ │ -00036890: 2020 2020 2020 2020 2020 2020 2020 2041 A │ │ │ │ │ -000368a0: 7373 656d 626c 7920 5375 7070 6f72 742e ssembly Support. │ │ │ │ │ -000368b0: 2020 2020 286c 696e 6520 2031 3029 0a2a (line 10).* │ │ │ │ │ -000368c0: 2041 4d5f 4346 4c41 4753 3a20 2020 2020 AM_CFLAGS: │ │ │ │ │ +00036850: 2020 2020 2020 204c 4942 4f42 4a53 2e20 LIBOBJS. │ │ │ │ │ +00036860: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00036870: 6520 2020 3629 0a2a 2041 4d5f 4343 4153 e 6).* AM_CCAS │ │ │ │ │ +00036880: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ +00036890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000368a0: 4173 7365 6d62 6c79 2053 7570 706f 7274 Assembly Support │ │ │ │ │ +000368b0: 2e20 2020 2028 6c69 6e65 2020 3130 290a . (line 10). │ │ │ │ │ +000368c0: 2a20 414d 5f43 464c 4147 533a 2020 2020 * AM_CFLAGS: │ │ │ │ │ 000368d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000368e0: 2020 2020 2020 2020 5072 6f67 7261 6d20 Program │ │ │ │ │ -000368f0: 5661 7269 6162 6c65 732e 2020 2028 6c69 Variables. (li │ │ │ │ │ -00036900: 6e65 2020 3531 290a 2a20 414d 5f43 4f4c ne 51).* AM_COL │ │ │ │ │ -00036910: 4f52 5f54 4553 5453 3a20 2020 2020 2020 OR_TESTS: │ │ │ │ │ +000368e0: 2020 2020 2020 2020 2050 726f 6772 616d Program │ │ │ │ │ +000368f0: 2056 6172 6961 626c 6573 2e20 2020 286c Variables. (l │ │ │ │ │ +00036900: 696e 6520 2035 3129 0a2a 2041 4d5f 434f ine 51).* AM_CO │ │ │ │ │ +00036910: 4c4f 525f 5445 5354 533a 2020 2020 2020 LOR_TESTS: │ │ │ │ │ 00036920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036930: 2053 696d 706c 6520 5465 7374 732e 2020 Simple Tests. │ │ │ │ │ -00036940: 2020 2020 2020 286c 696e 6520 2032 3529 (line 25) │ │ │ │ │ -00036950: 0a2a 2041 4d5f 4350 5046 4c41 4753 3a20 .* AM_CPPFLAGS: │ │ │ │ │ +00036930: 2020 5369 6d70 6c65 2054 6573 7473 2e20 Simple Tests. │ │ │ │ │ +00036940: 2020 2020 2020 2028 6c69 6e65 2020 3235 (line 25 │ │ │ │ │ +00036950: 290a 2a20 414d 5f43 5050 464c 4147 533a ).* AM_CPPFLAGS: │ │ │ │ │ 00036960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036970: 2020 2020 2020 2020 2020 5072 6f67 7261 Progra │ │ │ │ │ -00036980: 6d20 5661 7269 6162 6c65 732e 2020 2028 m Variables. ( │ │ │ │ │ -00036990: 6c69 6e65 2020 3136 290a 2a20 414d 5f43 line 16).* AM_C │ │ │ │ │ -000369a0: 5050 464c 4147 5320 3c31 3e3a 2020 2020 PPFLAGS <1>: │ │ │ │ │ +00036970: 2020 2020 2020 2020 2020 2050 726f 6772 Progr │ │ │ │ │ +00036980: 616d 2056 6172 6961 626c 6573 2e20 2020 am Variables. │ │ │ │ │ +00036990: 286c 696e 6520 2031 3629 0a2a 2041 4d5f (line 16).* AM_ │ │ │ │ │ +000369a0: 4350 5046 4c41 4753 203c 313e 3a20 2020 CPPFLAGS <1>: │ │ │ │ │ 000369b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000369c0: 2020 2041 7373 656d 626c 7920 5375 7070 Assembly Supp │ │ │ │ │ -000369d0: 6f72 742e 2020 2020 286c 696e 6520 2031 ort. (line 1 │ │ │ │ │ -000369e0: 3029 0a2a 2041 4d5f 4358 5846 4c41 4753 0).* AM_CXXFLAGS │ │ │ │ │ -000369f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00036a00: 2020 2020 2020 2020 2020 2020 432b 2b20 C++ │ │ │ │ │ -00036a10: 5375 7070 6f72 742e 2020 2020 2020 2020 Support. │ │ │ │ │ -00036a20: 2028 6c69 6e65 2020 3232 290a 2a20 414d (line 22).* AM │ │ │ │ │ -00036a30: 5f44 4546 4155 4c54 5f53 4f55 5243 455f _DEFAULT_SOURCE_ │ │ │ │ │ -00036a40: 4558 543a 2020 2020 2020 2020 2020 2020 EXT: │ │ │ │ │ -00036a50: 2020 2020 2044 6566 6175 6c74 205f 534f Default _SO │ │ │ │ │ -00036a60: 5552 4345 532e 2020 2020 286c 696e 6520 URCES. (line │ │ │ │ │ -00036a70: 2020 3629 0a2a 2041 4d5f 4445 4641 554c 6).* AM_DEFAUL │ │ │ │ │ -00036a80: 545f 563a 2020 2020 2020 2020 2020 2020 T_V: │ │ │ │ │ -00036a90: 2020 2020 2020 2020 2020 2020 2020 4175 Au │ │ │ │ │ -00036aa0: 746f 6d61 6b65 2073 696c 656e 742d 7275 tomake silent-ru │ │ │ │ │ -00036ab0: 6c65 7320 4f70 7469 6f6e 2e0a 2020 2020 les Option.. │ │ │ │ │ +000369c0: 2020 2020 4173 7365 6d62 6c79 2053 7570 Assembly Sup │ │ │ │ │ +000369d0: 706f 7274 2e20 2020 2028 6c69 6e65 2020 port. (line │ │ │ │ │ +000369e0: 3130 290a 2a20 414d 5f43 5858 464c 4147 10).* AM_CXXFLAG │ │ │ │ │ +000369f0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +00036a00: 2020 2020 2020 2020 2020 2020 2043 2b2b C++ │ │ │ │ │ +00036a10: 2053 7570 706f 7274 2e20 2020 2020 2020 Support. │ │ │ │ │ +00036a20: 2020 286c 696e 6520 2032 3229 0a2a 2041 (line 22).* A │ │ │ │ │ +00036a30: 4d5f 4445 4641 554c 545f 534f 5552 4345 M_DEFAULT_SOURCE │ │ │ │ │ +00036a40: 5f45 5854 3a20 2020 2020 2020 2020 2020 _EXT: │ │ │ │ │ +00036a50: 2020 2020 2020 4465 6661 756c 7420 5f53 Default _S │ │ │ │ │ +00036a60: 4f55 5243 4553 2e20 2020 2028 6c69 6e65 OURCES. (line │ │ │ │ │ +00036a70: 2020 2036 290a 2a20 414d 5f44 4546 4155 6).* AM_DEFAU │ │ │ │ │ +00036a80: 4c54 5f56 3a20 2020 2020 2020 2020 2020 LT_V: │ │ │ │ │ +00036a90: 2020 2020 2020 2020 2020 2020 2020 2041 A │ │ │ │ │ +00036aa0: 7574 6f6d 616b 6520 7369 6c65 6e74 2d72 utomake silent-r │ │ │ │ │ +00036ab0: 756c 6573 204f 7074 696f 6e2e 0a20 2020 ules Option.. │ │ │ │ │ 00036ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036ae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036af0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00036b00: 3133 3729 0a2a 2041 4d5f 4445 4641 554c 137).* AM_DEFAUL │ │ │ │ │ -00036b10: 545f 5645 5242 4f53 4954 593a 2020 2020 T_VERBOSITY: │ │ │ │ │ -00036b20: 2020 2020 2020 2020 2020 2020 2020 4175 Au │ │ │ │ │ -00036b30: 746f 6d61 6b65 2073 696c 656e 742d 7275 tomake silent-ru │ │ │ │ │ -00036b40: 6c65 7320 4f70 7469 6f6e 2e0a 2020 2020 les Option.. │ │ │ │ │ +00036af0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00036b00: 2031 3337 290a 2a20 414d 5f44 4546 4155 137).* AM_DEFAU │ │ │ │ │ +00036b10: 4c54 5f56 4552 424f 5349 5459 3a20 2020 LT_VERBOSITY: │ │ │ │ │ +00036b20: 2020 2020 2020 2020 2020 2020 2020 2041 A │ │ │ │ │ +00036b30: 7574 6f6d 616b 6520 7369 6c65 6e74 2d72 utomake silent-r │ │ │ │ │ +00036b40: 756c 6573 204f 7074 696f 6e2e 0a20 2020 ules Option.. │ │ │ │ │ 00036b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036b60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036b80: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00036b90: 3133 3729 0a2a 2041 4d5f 4449 5354 4348 137).* AM_DISTCH │ │ │ │ │ -00036ba0: 4543 4b5f 434f 4e46 4947 5552 455f 464c ECK_CONFIGURE_FL │ │ │ │ │ -00036bb0: 4147 533a 2020 2020 2020 2020 2020 4368 AGS: Ch │ │ │ │ │ -00036bc0: 6563 6b69 6e67 2074 6865 2044 6973 7472 ecking the Distr │ │ │ │ │ -00036bd0: 6962 7574 696f 6e2e 0a20 2020 2020 2020 ibution.. │ │ │ │ │ +00036b80: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00036b90: 2031 3337 290a 2a20 414d 5f44 4953 5443 137).* AM_DISTC │ │ │ │ │ +00036ba0: 4845 434b 5f43 4f4e 4649 4755 5245 5f46 HECK_CONFIGURE_F │ │ │ │ │ +00036bb0: 4c41 4753 3a20 2020 2020 2020 2020 2043 LAGS: C │ │ │ │ │ +00036bc0: 6865 636b 696e 6720 7468 6520 4469 7374 hecking the Dist │ │ │ │ │ +00036bd0: 7269 6275 7469 6f6e 2e0a 2020 2020 2020 ribution.. │ │ │ │ │ 00036be0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036c00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036c10: 2020 2020 2020 2028 6c69 6e65 2020 3132 (line 12 │ │ │ │ │ -00036c20: 290a 2a20 414d 5f45 5441 4753 464c 4147 ).* AM_ETAGSFLAG │ │ │ │ │ -00036c30: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -00036c40: 2020 2020 2020 2020 2020 2054 6167 732e Tags. │ │ │ │ │ -00036c50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036c60: 286c 696e 6520 2032 3529 0a2a 2041 4d5f (line 25).* AM_ │ │ │ │ │ -00036c70: 4558 545f 4c4f 475f 464c 4147 533a 2020 EXT_LOG_FLAGS: │ │ │ │ │ +00036c10: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +00036c20: 3229 0a2a 2041 4d5f 4554 4147 5346 4c41 2).* AM_ETAGSFLA │ │ │ │ │ +00036c30: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ +00036c40: 2020 2020 2020 2020 2020 2020 5461 6773 Tags │ │ │ │ │ +00036c50: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00036c60: 2028 6c69 6e65 2020 3235 290a 2a20 414d (line 25).* AM │ │ │ │ │ +00036c70: 5f45 5854 5f4c 4f47 5f46 4c41 4753 3a20 _EXT_LOG_FLAGS: │ │ │ │ │ 00036c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036c90: 2020 2020 5369 6d70 6c65 2054 6573 7473 Simple Tests │ │ │ │ │ -00036ca0: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ -00036cb0: 7465 7374 732e 0a20 2020 2020 2020 2020 tests.. │ │ │ │ │ +00036c90: 2020 2020 2053 696d 706c 6520 5465 7374 Simple Test │ │ │ │ │ +00036ca0: 7320 7573 696e 6720 7061 7261 6c6c 656c s using parallel │ │ │ │ │ +00036cb0: 2d74 6573 7473 2e0a 2020 2020 2020 2020 -tests.. │ │ │ │ │ 00036cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036cd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036ce0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036cf0: 2020 2020 2028 6c69 6e65 2020 3339 290a (line 39). │ │ │ │ │ -00036d00: 2a20 414d 5f46 4346 4c41 4753 3a20 2020 * AM_FCFLAGS: │ │ │ │ │ +00036cf0: 2020 2020 2020 286c 696e 6520 2033 3929 (line 39) │ │ │ │ │ +00036d00: 0a2a 2041 4d5f 4643 464c 4147 533a 2020 .* AM_FCFLAGS: │ │ │ │ │ 00036d10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036d20: 2020 2020 2020 2020 2046 6f72 7472 616e Fortran │ │ │ │ │ -00036d30: 2039 7820 5375 7070 6f72 742e 2020 286c 9x Support. (l │ │ │ │ │ -00036d40: 696e 6520 2032 3229 0a2a 2041 4d5f 4646 ine 22).* AM_FF │ │ │ │ │ -00036d50: 4c41 4753 3a20 2020 2020 2020 2020 2020 LAGS: │ │ │ │ │ +00036d20: 2020 2020 2020 2020 2020 466f 7274 7261 Fortra │ │ │ │ │ +00036d30: 6e20 3978 2053 7570 706f 7274 2e20 2028 n 9x Support. ( │ │ │ │ │ +00036d40: 6c69 6e65 2020 3232 290a 2a20 414d 5f46 line 22).* AM_F │ │ │ │ │ +00036d50: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ 00036d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036d70: 2020 466f 7274 7261 6e20 3737 2053 7570 Fortran 77 Sup │ │ │ │ │ -00036d80: 706f 7274 2e20 2028 6c69 6e65 2020 3232 port. (line 22 │ │ │ │ │ -00036d90: 290a 2a20 414d 5f47 434a 464c 4147 533a ).* AM_GCJFLAGS: │ │ │ │ │ -00036da0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036db0: 2020 2020 2020 2020 2020 204a 6176 6120 Java │ │ │ │ │ -00036dc0: 5375 7070 6f72 7420 7769 7468 2067 636a Support with gcj │ │ │ │ │ -00036dd0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00036d70: 2020 2046 6f72 7472 616e 2037 3720 5375 Fortran 77 Su │ │ │ │ │ +00036d80: 7070 6f72 742e 2020 286c 696e 6520 2032 pport. (line 2 │ │ │ │ │ +00036d90: 3229 0a2a 2041 4d5f 4743 4a46 4c41 4753 2).* AM_GCJFLAGS │ │ │ │ │ +00036da0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00036db0: 2020 2020 2020 2020 2020 2020 4a61 7661 Java │ │ │ │ │ +00036dc0: 2053 7570 706f 7274 2077 6974 6820 6763 Support with gc │ │ │ │ │ +00036dd0: 6a2e 0a20 2020 2020 2020 2020 2020 2020 j.. │ │ │ │ │ 00036de0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00036e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036e10: 286c 696e 6520 2032 3629 0a2a 2041 4d5f (line 26).* AM_ │ │ │ │ │ -00036e20: 494e 5354 414c 4c43 4845 434b 5f53 5444 INSTALLCHECK_STD │ │ │ │ │ -00036e30: 5f4f 5054 494f 4e53 5f45 5845 4d50 543a _OPTIONS_EXEMPT: │ │ │ │ │ -00036e40: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -00036e50: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ -00036e60: 3538 290a 2a20 414d 5f4a 4156 4143 464c 58).* AM_JAVACFL │ │ │ │ │ -00036e70: 4147 533a 2020 2020 2020 2020 2020 2020 AGS: │ │ │ │ │ -00036e80: 2020 2020 2020 2020 2020 2020 204a 6176 Jav │ │ │ │ │ -00036e90: 612e 2020 2020 2020 2020 2020 2020 2020 a. │ │ │ │ │ -00036ea0: 2020 286c 696e 6520 2034 3229 0a2a 2041 (line 42).* A │ │ │ │ │ -00036eb0: 4d5f 4c44 464c 4147 533a 2020 2020 2020 M_LDFLAGS: │ │ │ │ │ +00036e10: 2028 6c69 6e65 2020 3236 290a 2a20 414d (line 26).* AM │ │ │ │ │ +00036e20: 5f49 4e53 5441 4c4c 4348 4543 4b5f 5354 _INSTALLCHECK_ST │ │ │ │ │ +00036e30: 445f 4f50 5449 4f4e 535f 4558 454d 5054 D_OPTIONS_EXEMPT │ │ │ │ │ +00036e40: 3a20 2020 204f 7074 696f 6e73 2e20 2020 : Options. │ │ │ │ │ +00036e50: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00036e60: 3135 3829 0a2a 2041 4d5f 4a41 5641 4346 158).* AM_JAVACF │ │ │ │ │ +00036e70: 4c41 4753 3a20 2020 2020 2020 2020 2020 LAGS: │ │ │ │ │ +00036e80: 2020 2020 2020 2020 2020 2020 2020 4a61 Ja │ │ │ │ │ +00036e90: 7661 2e20 2020 2020 2020 2020 2020 2020 va. │ │ │ │ │ +00036ea0: 2020 2028 6c69 6e65 2020 3432 290a 2a20 (line 42).* │ │ │ │ │ +00036eb0: 414d 5f4c 4446 4c41 4753 3a20 2020 2020 AM_LDFLAGS: │ │ │ │ │ 00036ec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036ed0: 2020 2020 2020 4c69 6e6b 696e 672e 2020 Linking. │ │ │ │ │ -00036ee0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00036ef0: 2020 3130 290a 2a20 414d 5f4c 4446 4c41 10).* AM_LDFLA │ │ │ │ │ -00036f00: 4753 203c 313e 3a20 2020 2020 2020 2020 GS <1>: │ │ │ │ │ -00036f10: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -00036f20: 726f 6772 616d 2056 6172 6961 626c 6573 rogram Variables │ │ │ │ │ -00036f30: 2e20 2020 286c 696e 6520 2036 3129 0a2a . (line 61).* │ │ │ │ │ -00036f40: 2041 4d5f 4c46 4c41 4753 3a20 2020 2020 AM_LFLAGS: │ │ │ │ │ +00036ed0: 2020 2020 2020 204c 696e 6b69 6e67 2e20 Linking. │ │ │ │ │ +00036ee0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00036ef0: 6520 2031 3029 0a2a 2041 4d5f 4c44 464c e 10).* AM_LDFL │ │ │ │ │ +00036f00: 4147 5320 3c31 3e3a 2020 2020 2020 2020 AGS <1>: │ │ │ │ │ +00036f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00036f20: 5072 6f67 7261 6d20 5661 7269 6162 6c65 Program Variable │ │ │ │ │ +00036f30: 732e 2020 2028 6c69 6e65 2020 3631 290a s. (line 61). │ │ │ │ │ +00036f40: 2a20 414d 5f4c 464c 4147 533a 2020 2020 * AM_LFLAGS: │ │ │ │ │ 00036f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036f60: 2020 2020 2020 2020 5961 6363 2061 6e64 Yacc and │ │ │ │ │ -00036f70: 204c 6578 2e20 2020 2020 2020 2028 6c69 Lex. (li │ │ │ │ │ -00036f80: 6e65 2020 3536 290a 2a20 414d 5f4c 4942 ne 56).* AM_LIB │ │ │ │ │ -00036f90: 544f 4f4c 464c 4147 533a 2020 2020 2020 TOOLFLAGS: │ │ │ │ │ +00036f60: 2020 2020 2020 2020 2059 6163 6320 616e Yacc an │ │ │ │ │ +00036f70: 6420 4c65 782e 2020 2020 2020 2020 286c d Lex. (l │ │ │ │ │ +00036f80: 696e 6520 2035 3629 0a2a 2041 4d5f 4c49 ine 56).* AM_LI │ │ │ │ │ +00036f90: 4254 4f4f 4c46 4c41 4753 3a20 2020 2020 BTOOLFLAGS: │ │ │ │ │ 00036fa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036fb0: 204c 6962 746f 6f6c 2046 6c61 6773 2e20 Libtool Flags. │ │ │ │ │ -00036fc0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00036fd0: 0a2a 2041 4d5f 4c4f 475f 464c 4147 533a .* AM_LOG_FLAGS: │ │ │ │ │ -00036fe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00036ff0: 2020 2020 2020 2020 2020 5369 6d70 6c65 Simple │ │ │ │ │ -00037000: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ -00037010: 616c 6c65 6c2d 7465 7374 732e 0a20 2020 allel-tests.. │ │ │ │ │ +00036fb0: 2020 4c69 6274 6f6f 6c20 466c 6167 732e Libtool Flags. │ │ │ │ │ +00036fc0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00036fd0: 290a 2a20 414d 5f4c 4f47 5f46 4c41 4753 ).* AM_LOG_FLAGS │ │ │ │ │ +00036fe0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00036ff0: 2020 2020 2020 2020 2020 2053 696d 706c Simpl │ │ │ │ │ +00037000: 6520 5465 7374 7320 7573 696e 6720 7061 e Tests using pa │ │ │ │ │ +00037010: 7261 6c6c 656c 2d74 6573 7473 2e0a 2020 rallel-tests.. │ │ │ │ │ 00037020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037050: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00037060: 2020 3339 290a 2a20 414d 5f4d 414b 4546 39).* AM_MAKEF │ │ │ │ │ -00037070: 4c41 4753 3a20 2020 2020 2020 2020 2020 LAGS: │ │ │ │ │ -00037080: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -00037090: 7562 6469 7265 6374 6f72 6965 732e 2020 ubdirectories. │ │ │ │ │ -000370a0: 2020 2020 286c 696e 6520 2032 3929 0a2a (line 29).* │ │ │ │ │ -000370b0: 2041 4d5f 4d41 4b45 494e 464f 464c 4147 AM_MAKEINFOFLAG │ │ │ │ │ -000370c0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -000370d0: 2020 2020 2020 2020 5465 7869 6e66 6f2e Texinfo. │ │ │ │ │ -000370e0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000370f0: 6e65 2031 3039 290a 2a20 414d 5f4d 414b ne 109).* AM_MAK │ │ │ │ │ -00037100: 4549 4e46 4f48 544d 4c46 4c41 4753 3a20 EINFOHTMLFLAGS: │ │ │ │ │ +00037050: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00037060: 6520 2033 3929 0a2a 2041 4d5f 4d41 4b45 e 39).* AM_MAKE │ │ │ │ │ +00037070: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ +00037080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00037090: 5375 6264 6972 6563 746f 7269 6573 2e20 Subdirectories. │ │ │ │ │ +000370a0: 2020 2020 2028 6c69 6e65 2020 3239 290a (line 29). │ │ │ │ │ +000370b0: 2a20 414d 5f4d 414b 4549 4e46 4f46 4c41 * AM_MAKEINFOFLA │ │ │ │ │ +000370c0: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ +000370d0: 2020 2020 2020 2020 2054 6578 696e 666f Texinfo │ │ │ │ │ +000370e0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +000370f0: 696e 6520 3130 3929 0a2a 2041 4d5f 4d41 ine 109).* AM_MA │ │ │ │ │ +00037100: 4b45 494e 464f 4854 4d4c 464c 4147 533a KEINFOHTMLFLAGS: │ │ │ │ │ 00037110: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037120: 2054 6578 696e 666f 2e20 2020 2020 2020 Texinfo. │ │ │ │ │ -00037130: 2020 2020 2020 286c 696e 6520 3131 3029 (line 110) │ │ │ │ │ -00037140: 0a2a 2041 4d5f 4f42 4a43 464c 4147 533a .* AM_OBJCFLAGS: │ │ │ │ │ -00037150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037160: 2020 2020 2020 2020 2020 4f62 6a65 6374 Object │ │ │ │ │ -00037170: 6976 6520 4320 5375 7070 6f72 742e 2028 ive C Support. ( │ │ │ │ │ -00037180: 6c69 6e65 2020 3232 290a 2a20 414d 5f52 line 22).* AM_R │ │ │ │ │ -00037190: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ +00037120: 2020 5465 7869 6e66 6f2e 2020 2020 2020 Texinfo. │ │ │ │ │ +00037130: 2020 2020 2020 2028 6c69 6e65 2031 3130 (line 110 │ │ │ │ │ +00037140: 290a 2a20 414d 5f4f 424a 4346 4c41 4753 ).* AM_OBJCFLAGS │ │ │ │ │ +00037150: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00037160: 2020 2020 2020 2020 2020 204f 626a 6563 Objec │ │ │ │ │ +00037170: 7469 7665 2043 2053 7570 706f 7274 2e20 tive C Support. │ │ │ │ │ +00037180: 286c 696e 6520 2032 3229 0a2a 2041 4d5f (line 22).* AM_ │ │ │ │ │ +00037190: 5246 4c41 4753 3a20 2020 2020 2020 2020 RFLAGS: │ │ │ │ │ 000371a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000371b0: 2020 2046 6f72 7472 616e 2037 3720 5375 Fortran 77 Su │ │ │ │ │ -000371c0: 7070 6f72 742e 2020 286c 696e 6520 2032 pport. (line 2 │ │ │ │ │ -000371d0: 3829 0a2a 2041 4d5f 5255 4e54 4553 5446 8).* AM_RUNTESTF │ │ │ │ │ -000371e0: 4c41 4753 3a20 2020 2020 2020 2020 2020 LAGS: │ │ │ │ │ -000371f0: 2020 2020 2020 2020 2020 2020 4465 6a61 Deja │ │ │ │ │ -00037200: 476e 7520 5465 7374 732e 2020 2020 2020 Gnu Tests. │ │ │ │ │ -00037210: 2028 6c69 6e65 2020 3234 290a 2a20 414d (line 24).* AM │ │ │ │ │ -00037220: 5f55 5043 464c 4147 533a 2020 2020 2020 _UPCFLAGS: │ │ │ │ │ +000371b0: 2020 2020 466f 7274 7261 6e20 3737 2053 Fortran 77 S │ │ │ │ │ +000371c0: 7570 706f 7274 2e20 2028 6c69 6e65 2020 upport. (line │ │ │ │ │ +000371d0: 3238 290a 2a20 414d 5f52 554e 5445 5354 28).* AM_RUNTEST │ │ │ │ │ +000371e0: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ +000371f0: 2020 2020 2020 2020 2020 2020 2044 656a Dej │ │ │ │ │ +00037200: 6147 6e75 2054 6573 7473 2e20 2020 2020 aGnu Tests. │ │ │ │ │ +00037210: 2020 286c 696e 6520 2032 3429 0a2a 2041 (line 24).* A │ │ │ │ │ +00037220: 4d5f 5550 4346 4c41 4753 3a20 2020 2020 M_UPCFLAGS: │ │ │ │ │ 00037230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037240: 2020 2020 2055 6e69 6669 6564 2050 6172 Unified Par │ │ │ │ │ -00037250: 616c 6c65 6c20 4320 5375 7070 6f72 742e allel C Support. │ │ │ │ │ -00037260: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00037240: 2020 2020 2020 556e 6966 6965 6420 5061 Unified Pa │ │ │ │ │ +00037250: 7261 6c6c 656c 2043 2053 7570 706f 7274 rallel C Support │ │ │ │ │ +00037260: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 00037270: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037290: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -000372a0: 6c69 6e65 2020 3231 290a 2a20 414d 5f55 line 21).* AM_U │ │ │ │ │ -000372b0: 5044 4154 455f 494e 464f 5f44 4952 3a20 PDATE_INFO_DIR: │ │ │ │ │ +00037290: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000372a0: 286c 696e 6520 2032 3129 0a2a 2041 4d5f (line 21).* AM_ │ │ │ │ │ +000372b0: 5550 4441 5445 5f49 4e46 4f5f 4449 523a UPDATE_INFO_DIR: │ │ │ │ │ 000372c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000372d0: 2020 2054 6578 696e 666f 2e20 2020 2020 Texinfo. │ │ │ │ │ -000372e0: 2020 2020 2020 2020 286c 696e 6520 2038 (line 8 │ │ │ │ │ -000372f0: 3629 0a2a 2041 4d5f 563a 2020 2020 2020 6).* AM_V: │ │ │ │ │ +000372d0: 2020 2020 5465 7869 6e66 6f2e 2020 2020 Texinfo. │ │ │ │ │ +000372e0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +000372f0: 3836 290a 2a20 414d 5f56 3a20 2020 2020 86).* AM_V: │ │ │ │ │ 00037300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037310: 2020 2020 2020 2020 2020 2020 4175 746f Auto │ │ │ │ │ -00037320: 6d61 6b65 2073 696c 656e 742d 7275 6c65 make silent-rule │ │ │ │ │ -00037330: 7320 4f70 7469 6f6e 2e0a 2020 2020 2020 s Option.. │ │ │ │ │ +00037310: 2020 2020 2020 2020 2020 2020 2041 7574 Aut │ │ │ │ │ +00037320: 6f6d 616b 6520 7369 6c65 6e74 2d72 756c omake silent-rul │ │ │ │ │ +00037330: 6573 204f 7074 696f 6e2e 0a20 2020 2020 es Option.. │ │ │ │ │ 00037340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037360: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037370: 2020 2020 2020 2020 286c 696e 6520 3133 (line 13 │ │ │ │ │ -00037380: 3729 0a2a 2041 4d5f 5641 4c41 464c 4147 7).* AM_VALAFLAG │ │ │ │ │ -00037390: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -000373a0: 2020 2020 2020 2020 2020 2020 5661 6c61 Vala │ │ │ │ │ -000373b0: 2053 7570 706f 7274 2e20 2020 2020 2020 Support. │ │ │ │ │ -000373c0: 2028 6c69 6e65 2020 3335 290a 2a20 414d (line 35).* AM │ │ │ │ │ -000373d0: 5f56 5f61 743a 2020 2020 2020 2020 2020 _V_at: │ │ │ │ │ +00037370: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +00037380: 3337 290a 2a20 414d 5f56 414c 4146 4c41 37).* AM_VALAFLA │ │ │ │ │ +00037390: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ +000373a0: 2020 2020 2020 2020 2020 2020 2056 616c Val │ │ │ │ │ +000373b0: 6120 5375 7070 6f72 742e 2020 2020 2020 a Support. │ │ │ │ │ +000373c0: 2020 286c 696e 6520 2033 3529 0a2a 2041 (line 35).* A │ │ │ │ │ +000373d0: 4d5f 565f 6174 3a20 2020 2020 2020 2020 M_V_at: │ │ │ │ │ 000373e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000373f0: 2020 2020 2041 7574 6f6d 616b 6520 7369 Automake si │ │ │ │ │ -00037400: 6c65 6e74 2d72 756c 6573 204f 7074 696f lent-rules Optio │ │ │ │ │ -00037410: 6e2e 0a20 2020 2020 2020 2020 2020 2020 n.. │ │ │ │ │ +000373f0: 2020 2020 2020 4175 746f 6d61 6b65 2073 Automake s │ │ │ │ │ +00037400: 696c 656e 742d 7275 6c65 7320 4f70 7469 ilent-rules Opti │ │ │ │ │ +00037410: 6f6e 2e0a 2020 2020 2020 2020 2020 2020 on.. │ │ │ │ │ 00037420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037430: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037450: 2028 6c69 6e65 2031 3337 290a 2a20 414d (line 137).* AM │ │ │ │ │ -00037460: 5f56 5f47 454e 3a20 2020 2020 2020 2020 _V_GEN: │ │ │ │ │ +00037450: 2020 286c 696e 6520 3133 3729 0a2a 2041 (line 137).* A │ │ │ │ │ +00037460: 4d5f 565f 4745 4e3a 2020 2020 2020 2020 M_V_GEN: │ │ │ │ │ 00037470: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037480: 2020 2020 2041 7574 6f6d 616b 6520 7369 Automake si │ │ │ │ │ -00037490: 6c65 6e74 2d72 756c 6573 204f 7074 696f lent-rules Optio │ │ │ │ │ -000374a0: 6e2e 0a20 2020 2020 2020 2020 2020 2020 n.. │ │ │ │ │ +00037480: 2020 2020 2020 4175 746f 6d61 6b65 2073 Automake s │ │ │ │ │ +00037490: 696c 656e 742d 7275 6c65 7320 4f70 7469 ilent-rules Opti │ │ │ │ │ +000374a0: 6f6e 2e0a 2020 2020 2020 2020 2020 2020 on.. │ │ │ │ │ 000374b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000374c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000374d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000374e0: 2028 6c69 6e65 2031 3337 290a 2a20 414d (line 137).* AM │ │ │ │ │ -000374f0: 5f59 464c 4147 533a 2020 2020 2020 2020 _YFLAGS: │ │ │ │ │ +000374e0: 2020 286c 696e 6520 3133 3729 0a2a 2041 (line 137).* A │ │ │ │ │ +000374f0: 4d5f 5946 4c41 4753 3a20 2020 2020 2020 M_YFLAGS: │ │ │ │ │ 00037500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037510: 2020 2020 2059 6163 6320 616e 6420 4c65 Yacc and Le │ │ │ │ │ -00037520: 782e 2020 2020 2020 2020 286c 696e 6520 x. (line │ │ │ │ │ -00037530: 2033 3329 0a2a 2041 4e53 4932 4b4e 523a 33).* ANSI2KNR: │ │ │ │ │ -00037540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037550: 2020 2020 2020 2020 2020 2020 2020 4f62 Ob │ │ │ │ │ -00037560: 736f 6c65 7465 204d 6163 726f 732e 2020 solete Macros. │ │ │ │ │ -00037570: 2020 2028 6c69 6e65 2020 3133 290a 2a20 (line 13).* │ │ │ │ │ -00037580: 4152 3a20 2020 2020 2020 2020 2020 2020 AR: │ │ │ │ │ +00037510: 2020 2020 2020 5961 6363 2061 6e64 204c Yacc and L │ │ │ │ │ +00037520: 6578 2e20 2020 2020 2020 2028 6c69 6e65 ex. (line │ │ │ │ │ +00037530: 2020 3333 290a 2a20 414e 5349 324b 4e52 33).* ANSI2KNR │ │ │ │ │ +00037540: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00037550: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +00037560: 6273 6f6c 6574 6520 4d61 6372 6f73 2e20 bsolete Macros. │ │ │ │ │ +00037570: 2020 2020 286c 696e 6520 2031 3329 0a2a (line 13).* │ │ │ │ │ +00037580: 2041 523a 2020 2020 2020 2020 2020 2020 AR: │ │ │ │ │ 00037590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000375a0: 2020 2020 2020 2050 7562 6c69 6320 4d61 Public Ma │ │ │ │ │ -000375b0: 6372 6f73 2e20 2020 2020 2020 286c 696e cros. (lin │ │ │ │ │ -000375c0: 6520 2038 3129 0a2a 2041 5554 4f43 4f4e e 81).* AUTOCON │ │ │ │ │ -000375d0: 463a 2020 2020 2020 2020 2020 2020 2020 F: │ │ │ │ │ +000375a0: 2020 2020 2020 2020 5075 626c 6963 204d Public M │ │ │ │ │ +000375b0: 6163 726f 732e 2020 2020 2020 2028 6c69 acros. (li │ │ │ │ │ +000375c0: 6e65 2020 3831 290a 2a20 4155 544f 434f ne 81).* AUTOCO │ │ │ │ │ +000375d0: 4e46 3a20 2020 2020 2020 2020 2020 2020 NF: │ │ │ │ │ 000375e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000375f0: 6175 746f 6d61 6b65 2049 6e76 6f63 6174 automake Invocat │ │ │ │ │ -00037600: 696f 6e2e 2028 6c69 6e65 2020 3238 290a ion. (line 28). │ │ │ │ │ -00037610: 2a20 4155 544f 4d34 5445 3a20 2020 2020 * AUTOM4TE: │ │ │ │ │ +000375f0: 2061 7574 6f6d 616b 6520 496e 766f 6361 automake Invoca │ │ │ │ │ +00037600: 7469 6f6e 2e20 286c 696e 6520 2032 3829 tion. (line 28) │ │ │ │ │ +00037610: 0a2a 2041 5554 4f4d 3454 453a 2020 2020 .* AUTOM4TE: │ │ │ │ │ 00037620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037630: 2020 2020 2020 2020 2061 636c 6f63 616c aclocal │ │ │ │ │ -00037640: 2049 6e76 6f63 6174 696f 6e2e 2020 286c Invocation. (l │ │ │ │ │ -00037650: 696e 6520 2034 3429 0a2a 2041 5554 4f4d ine 44).* AUTOM │ │ │ │ │ -00037660: 414b 455f 4a4f 4253 3a20 2020 2020 2020 AKE_JOBS: │ │ │ │ │ +00037630: 2020 2020 2020 2020 2020 6163 6c6f 6361 acloca │ │ │ │ │ +00037640: 6c20 496e 766f 6361 7469 6f6e 2e20 2028 l Invocation. ( │ │ │ │ │ +00037650: 6c69 6e65 2020 3434 290a 2a20 4155 544f line 44).* AUTO │ │ │ │ │ +00037660: 4d41 4b45 5f4a 4f42 533a 2020 2020 2020 MAKE_JOBS: │ │ │ │ │ 00037670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037680: 2020 6175 746f 6d61 6b65 2049 6e76 6f63 automake Invoc │ │ │ │ │ -00037690: 6174 696f 6e2e 2028 6c69 6e65 2031 3737 ation. (line 177 │ │ │ │ │ -000376a0: 290a 2a20 4155 544f 4d41 4b45 5f4f 5054 ).* AUTOMAKE_OPT │ │ │ │ │ -000376b0: 494f 4e53 3a20 2020 2020 2020 2020 2020 IONS: │ │ │ │ │ -000376c0: 2020 2020 2020 2020 2020 2050 7562 6c69 Publi │ │ │ │ │ -000376d0: 6320 4d61 6372 6f73 2e20 2020 2020 2020 c Macros. │ │ │ │ │ -000376e0: 286c 696e 6520 2032 3529 0a2a 2041 5554 (line 25).* AUT │ │ │ │ │ -000376f0: 4f4d 414b 455f 4f50 5449 4f4e 5320 3c31 OMAKE_OPTIONS <1 │ │ │ │ │ -00037700: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ -00037710: 2020 2020 414e 5349 2e20 2020 2020 2020 ANSI. │ │ │ │ │ -00037720: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00037730: 3232 290a 2a20 4155 544f 4d41 4b45 5f4f 22).* AUTOMAKE_O │ │ │ │ │ -00037740: 5054 494f 4e53 203c 323e 3a20 2020 2020 PTIONS <2>: │ │ │ │ │ -00037750: 2020 2020 2020 2020 2020 2020 2044 6570 Dep │ │ │ │ │ -00037760: 656e 6465 6e63 6965 732e 2020 2020 2020 endencies. │ │ │ │ │ -00037770: 2020 286c 696e 6520 2033 3329 0a2a 2041 (line 33).* A │ │ │ │ │ -00037780: 5554 4f4d 414b 455f 4f50 5449 4f4e 5320 UTOMAKE_OPTIONS │ │ │ │ │ -00037790: 3c33 3e3a 2020 2020 2020 2020 2020 2020 <3>: │ │ │ │ │ -000377a0: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ -000377b0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -000377c0: 2020 3137 290a 2a20 6269 6e5f 5052 4f47 17).* bin_PROG │ │ │ │ │ -000377d0: 5241 4d53 3a20 2020 2020 2020 2020 2020 RAMS: │ │ │ │ │ -000377e0: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -000377f0: 726f 6772 616d 2053 6f75 7263 6573 2e20 rogram Sources. │ │ │ │ │ -00037800: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00037810: 2062 696e 5f53 4352 4950 5453 3a20 2020 bin_SCRIPTS: │ │ │ │ │ +00037680: 2020 2061 7574 6f6d 616b 6520 496e 766f automake Invo │ │ │ │ │ +00037690: 6361 7469 6f6e 2e20 286c 696e 6520 3137 cation. (line 17 │ │ │ │ │ +000376a0: 3729 0a2a 2041 5554 4f4d 414b 455f 4f50 7).* AUTOMAKE_OP │ │ │ │ │ +000376b0: 5449 4f4e 533a 2020 2020 2020 2020 2020 TIONS: │ │ │ │ │ +000376c0: 2020 2020 2020 2020 2020 2020 5075 626c Publ │ │ │ │ │ +000376d0: 6963 204d 6163 726f 732e 2020 2020 2020 ic Macros. │ │ │ │ │ +000376e0: 2028 6c69 6e65 2020 3235 290a 2a20 4155 (line 25).* AU │ │ │ │ │ +000376f0: 544f 4d41 4b45 5f4f 5054 494f 4e53 203c TOMAKE_OPTIONS < │ │ │ │ │ +00037700: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +00037710: 2020 2020 2041 4e53 492e 2020 2020 2020 ANSI. │ │ │ │ │ +00037720: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00037730: 2032 3229 0a2a 2041 5554 4f4d 414b 455f 22).* AUTOMAKE_ │ │ │ │ │ +00037740: 4f50 5449 4f4e 5320 3c32 3e3a 2020 2020 OPTIONS <2>: │ │ │ │ │ +00037750: 2020 2020 2020 2020 2020 2020 2020 4465 De │ │ │ │ │ +00037760: 7065 6e64 656e 6369 6573 2e20 2020 2020 pendencies. │ │ │ │ │ +00037770: 2020 2028 6c69 6e65 2020 3333 290a 2a20 (line 33).* │ │ │ │ │ +00037780: 4155 544f 4d41 4b45 5f4f 5054 494f 4e53 AUTOMAKE_OPTIONS │ │ │ │ │ +00037790: 203c 333e 3a20 2020 2020 2020 2020 2020 <3>: │ │ │ │ │ +000377a0: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ +000377b0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +000377c0: 6520 2031 3729 0a2a 2062 696e 5f50 524f e 17).* bin_PRO │ │ │ │ │ +000377d0: 4752 414d 533a 2020 2020 2020 2020 2020 GRAMS: │ │ │ │ │ +000377e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000377f0: 5072 6f67 7261 6d20 536f 7572 6365 732e Program Sources. │ │ │ │ │ +00037800: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00037810: 2a20 6269 6e5f 5343 5249 5054 533a 2020 * bin_SCRIPTS: │ │ │ │ │ 00037820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037830: 2020 2020 2020 2020 5363 7269 7074 732e Scripts. │ │ │ │ │ -00037840: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00037850: 6e65 2020 3138 290a 2a20 6275 696c 645f ne 18).* build_ │ │ │ │ │ -00037860: 7472 6970 6c65 743a 2020 2020 2020 2020 triplet: │ │ │ │ │ +00037830: 2020 2020 2020 2020 2053 6372 6970 7473 Scripts │ │ │ │ │ +00037840: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00037850: 696e 6520 2031 3829 0a2a 2062 7569 6c64 ine 18).* build │ │ │ │ │ +00037860: 5f74 7269 706c 6574 3a20 2020 2020 2020 _triplet: │ │ │ │ │ 00037870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037880: 204f 7074 696f 6e61 6c2e 2020 2020 2020 Optional. │ │ │ │ │ -00037890: 2020 2020 2020 286c 696e 6520 2031 3429 (line 14) │ │ │ │ │ -000378a0: 0a2a 2042 5549 4c54 5f53 4f55 5243 4553 .* BUILT_SOURCES │ │ │ │ │ -000378b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000378c0: 2020 2020 2020 2020 2020 536f 7572 6365 Source │ │ │ │ │ -000378d0: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -000378e0: 6c69 6e65 2020 3237 290a 2a20 425a 4950 line 27).* BZIP │ │ │ │ │ -000378f0: 323a 2020 2020 2020 2020 2020 2020 2020 2: │ │ │ │ │ +00037880: 2020 4f70 7469 6f6e 616c 2e20 2020 2020 Optional. │ │ │ │ │ +00037890: 2020 2020 2020 2028 6c69 6e65 2020 3134 (line 14 │ │ │ │ │ +000378a0: 290a 2a20 4255 494c 545f 534f 5552 4345 ).* BUILT_SOURCE │ │ │ │ │ +000378b0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +000378c0: 2020 2020 2020 2020 2020 2053 6f75 7263 Sourc │ │ │ │ │ +000378d0: 6573 2e20 2020 2020 2020 2020 2020 2020 es. │ │ │ │ │ +000378e0: 286c 696e 6520 2032 3729 0a2a 2042 5a49 (line 27).* BZI │ │ │ │ │ +000378f0: 5032 3a20 2020 2020 2020 2020 2020 2020 P2: │ │ │ │ │ 00037900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037910: 2020 2054 6865 2054 7970 6573 206f 6620 The Types of │ │ │ │ │ -00037920: 4469 7374 7269 6275 7469 6f6e 732e 0a20 Distributions.. │ │ │ │ │ +00037910: 2020 2020 5468 6520 5479 7065 7320 6f66 The Types of │ │ │ │ │ +00037920: 2044 6973 7472 6962 7574 696f 6e73 2e0a Distributions.. │ │ │ │ │ 00037930: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037950: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037960: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00037970: 6e65 2020 2039 290a 2a20 4343 3a20 2020 ne 9).* CC: │ │ │ │ │ +00037960: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00037970: 696e 6520 2020 3929 0a2a 2043 433a 2020 ine 9).* CC: │ │ │ │ │ 00037980: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000379a0: 2050 726f 6772 616d 2056 6172 6961 626c Program Variabl │ │ │ │ │ -000379b0: 6573 2e20 2020 286c 696e 6520 2031 3229 es. (line 12) │ │ │ │ │ -000379c0: 0a2a 2043 4341 533a 2020 2020 2020 2020 .* CCAS: │ │ │ │ │ +000379a0: 2020 5072 6f67 7261 6d20 5661 7269 6162 Program Variab │ │ │ │ │ +000379b0: 6c65 732e 2020 2028 6c69 6e65 2020 3132 les. (line 12 │ │ │ │ │ +000379c0: 290a 2a20 4343 4153 3a20 2020 2020 2020 ).* CCAS: │ │ │ │ │ 000379d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000379e0: 2020 2020 2020 2020 2020 5075 626c 6963 Public │ │ │ │ │ -000379f0: 204d 6163 726f 732e 2020 2020 2020 2028 Macros. ( │ │ │ │ │ -00037a00: 6c69 6e65 2020 3838 290a 2a20 4343 4153 line 88).* CCAS │ │ │ │ │ -00037a10: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +000379e0: 2020 2020 2020 2020 2020 2050 7562 6c69 Publi │ │ │ │ │ +000379f0: 6320 4d61 6372 6f73 2e20 2020 2020 2020 c Macros. │ │ │ │ │ +00037a00: 286c 696e 6520 2038 3829 0a2a 2043 4341 (line 88).* CCA │ │ │ │ │ +00037a10: 5320 3c31 3e3a 2020 2020 2020 2020 2020 S <1>: │ │ │ │ │ 00037a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037a30: 2020 2041 7373 656d 626c 7920 5375 7070 Assembly Supp │ │ │ │ │ -00037a40: 6f72 742e 2020 2020 286c 696e 6520 2031 ort. (line 1 │ │ │ │ │ -00037a50: 3029 0a2a 2043 4341 5346 4c41 4753 3a20 0).* CCASFLAGS: │ │ │ │ │ +00037a30: 2020 2020 4173 7365 6d62 6c79 2053 7570 Assembly Sup │ │ │ │ │ +00037a40: 706f 7274 2e20 2020 2028 6c69 6e65 2020 port. (line │ │ │ │ │ +00037a50: 3130 290a 2a20 4343 4153 464c 4147 533a 10).* CCASFLAGS: │ │ │ │ │ 00037a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037a70: 2020 2020 2020 2020 2020 2020 5075 626c Publ │ │ │ │ │ -00037a80: 6963 204d 6163 726f 732e 2020 2020 2020 ic Macros. │ │ │ │ │ -00037a90: 2028 6c69 6e65 2020 3838 290a 2a20 4343 (line 88).* CC │ │ │ │ │ -00037aa0: 4153 464c 4147 5320 3c31 3e3a 2020 2020 ASFLAGS <1>: │ │ │ │ │ +00037a70: 2020 2020 2020 2020 2020 2020 2050 7562 Pub │ │ │ │ │ +00037a80: 6c69 6320 4d61 6372 6f73 2e20 2020 2020 lic Macros. │ │ │ │ │ +00037a90: 2020 286c 696e 6520 2038 3829 0a2a 2043 (line 88).* C │ │ │ │ │ +00037aa0: 4341 5346 4c41 4753 203c 313e 3a20 2020 CASFLAGS <1>: │ │ │ │ │ 00037ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037ac0: 2020 2020 2041 7373 656d 626c 7920 5375 Assembly Su │ │ │ │ │ -00037ad0: 7070 6f72 742e 2020 2020 286c 696e 6520 pport. (line │ │ │ │ │ -00037ae0: 2031 3029 0a2a 2043 464c 4147 533a 2020 10).* CFLAGS: │ │ │ │ │ +00037ac0: 2020 2020 2020 4173 7365 6d62 6c79 2053 Assembly S │ │ │ │ │ +00037ad0: 7570 706f 7274 2e20 2020 2028 6c69 6e65 upport. (line │ │ │ │ │ +00037ae0: 2020 3130 290a 2a20 4346 4c41 4753 3a20 10).* CFLAGS: │ │ │ │ │ 00037af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037b00: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ -00037b10: 6f67 7261 6d20 5661 7269 6162 6c65 732e ogram Variables. │ │ │ │ │ -00037b20: 2020 2028 6c69 6e65 2020 3132 290a 2a20 (line 12).* │ │ │ │ │ -00037b30: 6368 6563 6b5f 3a20 2020 2020 2020 2020 check_: │ │ │ │ │ +00037b00: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +00037b10: 726f 6772 616d 2056 6172 6961 626c 6573 rogram Variables │ │ │ │ │ +00037b20: 2e20 2020 286c 696e 6520 2031 3229 0a2a . (line 12).* │ │ │ │ │ +00037b30: 2063 6865 636b 5f3a 2020 2020 2020 2020 check_: │ │ │ │ │ 00037b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037b50: 2020 2020 2020 2055 6e69 666f 726d 2e20 Uniform. │ │ │ │ │ -00037b60: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00037b70: 6520 2039 3629 0a2a 2063 6865 636b 5f4c e 96).* check_L │ │ │ │ │ -00037b80: 544c 4942 5241 5249 4553 3a20 2020 2020 TLIBRARIES: │ │ │ │ │ +00037b50: 2020 2020 2020 2020 556e 6966 6f72 6d2e Uniform. │ │ │ │ │ +00037b60: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00037b70: 6e65 2020 3936 290a 2a20 6368 6563 6b5f ne 96).* check_ │ │ │ │ │ +00037b80: 4c54 4c49 4252 4152 4945 533a 2020 2020 LTLIBRARIES: │ │ │ │ │ 00037b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037ba0: 4c69 6274 6f6f 6c20 436f 6e76 656e 6965 Libtool Convenie │ │ │ │ │ -00037bb0: 6e63 6520 4c69 6272 6172 6965 732e 0a20 nce Libraries.. │ │ │ │ │ +00037ba0: 204c 6962 746f 6f6c 2043 6f6e 7665 6e69 Libtool Conveni │ │ │ │ │ +00037bb0: 656e 6365 204c 6962 7261 7269 6573 2e0a ence Libraries.. │ │ │ │ │ 00037bc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00037be0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037bf0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00037c00: 6e65 2020 2036 290a 2a20 6368 6563 6b5f ne 6).* check_ │ │ │ │ │ -00037c10: 5052 4f47 5241 4d53 3a20 2020 2020 2020 PROGRAMS: │ │ │ │ │ +00037bf0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00037c00: 696e 6520 2020 3629 0a2a 2063 6865 636b ine 6).* check │ │ │ │ │ +00037c10: 5f50 524f 4752 414d 533a 2020 2020 2020 _PROGRAMS: │ │ │ │ │ 00037c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037c30: 2050 726f 6772 616d 2053 6f75 7263 6573 Program Sources │ │ │ │ │ -00037c40: 2e20 2020 2020 286c 696e 6520 2020 3629 . (line 6) │ │ │ │ │ -00037c50: 0a2a 2063 6865 636b 5f50 524f 4752 414d .* check_PROGRAM │ │ │ │ │ -00037c60: 5320 3c31 3e3a 2020 2020 2020 2020 2020 S <1>: │ │ │ │ │ -00037c70: 2020 2020 2020 2020 2020 4465 6661 756c Defaul │ │ │ │ │ -00037c80: 7420 5f53 4f55 5243 4553 2e20 2020 2028 t _SOURCES. ( │ │ │ │ │ -00037c90: 6c69 6e65 2020 3238 290a 2a20 6368 6563 line 28).* chec │ │ │ │ │ -00037ca0: 6b5f 5343 5249 5054 533a 2020 2020 2020 k_SCRIPTS: │ │ │ │ │ +00037c30: 2020 5072 6f67 7261 6d20 536f 7572 6365 Program Source │ │ │ │ │ +00037c40: 732e 2020 2020 2028 6c69 6e65 2020 2036 s. (line 6 │ │ │ │ │ +00037c50: 290a 2a20 6368 6563 6b5f 5052 4f47 5241 ).* check_PROGRA │ │ │ │ │ +00037c60: 4d53 203c 313e 3a20 2020 2020 2020 2020 MS <1>: │ │ │ │ │ +00037c70: 2020 2020 2020 2020 2020 2044 6566 6175 Defau │ │ │ │ │ +00037c80: 6c74 205f 534f 5552 4345 532e 2020 2020 lt _SOURCES. │ │ │ │ │ +00037c90: 286c 696e 6520 2032 3829 0a2a 2063 6865 (line 28).* che │ │ │ │ │ +00037ca0: 636b 5f53 4352 4950 5453 3a20 2020 2020 ck_SCRIPTS: │ │ │ │ │ 00037cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037cc0: 2020 2053 6372 6970 7473 2e20 2020 2020 Scripts. │ │ │ │ │ -00037cd0: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -00037ce0: 3829 0a2a 2043 4c41 5353 5041 5448 5f45 8).* CLASSPATH_E │ │ │ │ │ -00037cf0: 4e56 3a20 2020 2020 2020 2020 2020 2020 NV: │ │ │ │ │ -00037d00: 2020 2020 2020 2020 2020 2020 4a61 7661 Java │ │ │ │ │ -00037d10: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00037d20: 2028 6c69 6e65 2020 3531 290a 2a20 434c (line 51).* CL │ │ │ │ │ -00037d30: 4541 4e46 494c 4553 3a20 2020 2020 2020 EANFILES: │ │ │ │ │ +00037cc0: 2020 2020 5363 7269 7074 732e 2020 2020 Scripts. │ │ │ │ │ +00037cd0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00037ce0: 3138 290a 2a20 434c 4153 5350 4154 485f 18).* CLASSPATH_ │ │ │ │ │ +00037cf0: 454e 563a 2020 2020 2020 2020 2020 2020 ENV: │ │ │ │ │ +00037d00: 2020 2020 2020 2020 2020 2020 204a 6176 Jav │ │ │ │ │ +00037d10: 612e 2020 2020 2020 2020 2020 2020 2020 a. │ │ │ │ │ +00037d20: 2020 286c 696e 6520 2035 3129 0a2a 2043 (line 51).* C │ │ │ │ │ +00037d30: 4c45 414e 4649 4c45 533a 2020 2020 2020 LEANFILES: │ │ │ │ │ 00037d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037d50: 2020 2020 2043 6c65 616e 2e20 2020 2020 Clean. │ │ │ │ │ -00037d60: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00037d70: 2031 3329 0a2a 2043 4f4d 5049 4c45 3a20 13).* COMPILE: │ │ │ │ │ +00037d50: 2020 2020 2020 436c 6561 6e2e 2020 2020 Clean. │ │ │ │ │ +00037d60: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00037d70: 2020 3133 290a 2a20 434f 4d50 494c 453a 13).* COMPILE: │ │ │ │ │ 00037d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037d90: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ -00037da0: 6f67 7261 6d20 5661 7269 6162 6c65 732e ogram Variables. │ │ │ │ │ -00037db0: 2020 2028 6c69 6e65 2020 3537 290a 2a20 (line 57).* │ │ │ │ │ -00037dc0: 434f 4e46 4947 5552 455f 4445 5045 4e44 CONFIGURE_DEPEND │ │ │ │ │ -00037dd0: 454e 4349 4553 3a20 2020 2020 2020 2020 ENCIES: │ │ │ │ │ -00037de0: 2020 2020 2020 2052 6562 7569 6c64 696e Rebuildin │ │ │ │ │ -00037df0: 672e 2020 2020 2020 2020 2020 286c 696e g. (lin │ │ │ │ │ -00037e00: 6520 2031 3929 0a2a 2043 4f4e 4649 475f e 19).* CONFIG_ │ │ │ │ │ -00037e10: 5354 4154 5553 5f44 4550 454e 4445 4e43 STATUS_DEPENDENC │ │ │ │ │ -00037e20: 4945 533a 2020 2020 2020 2020 2020 2020 IES: │ │ │ │ │ -00037e30: 5265 6275 696c 6469 6e67 2e20 2020 2020 Rebuilding. │ │ │ │ │ -00037e40: 2020 2020 2028 6c69 6e65 2020 3139 290a (line 19). │ │ │ │ │ -00037e50: 2a20 4350 5046 4c41 4753 3a20 2020 2020 * CPPFLAGS: │ │ │ │ │ +00037d90: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +00037da0: 726f 6772 616d 2056 6172 6961 626c 6573 rogram Variables │ │ │ │ │ +00037db0: 2e20 2020 286c 696e 6520 2035 3729 0a2a . (line 57).* │ │ │ │ │ +00037dc0: 2043 4f4e 4649 4755 5245 5f44 4550 454e CONFIGURE_DEPEN │ │ │ │ │ +00037dd0: 4445 4e43 4945 533a 2020 2020 2020 2020 DENCIES: │ │ │ │ │ +00037de0: 2020 2020 2020 2020 5265 6275 696c 6469 Rebuildi │ │ │ │ │ +00037df0: 6e67 2e20 2020 2020 2020 2020 2028 6c69 ng. (li │ │ │ │ │ +00037e00: 6e65 2020 3139 290a 2a20 434f 4e46 4947 ne 19).* CONFIG │ │ │ │ │ +00037e10: 5f53 5441 5455 535f 4445 5045 4e44 454e _STATUS_DEPENDEN │ │ │ │ │ +00037e20: 4349 4553 3a20 2020 2020 2020 2020 2020 CIES: │ │ │ │ │ +00037e30: 2052 6562 7569 6c64 696e 672e 2020 2020 Rebuilding. │ │ │ │ │ +00037e40: 2020 2020 2020 286c 696e 6520 2031 3929 (line 19) │ │ │ │ │ +00037e50: 0a2a 2043 5050 464c 4147 533a 2020 2020 .* CPPFLAGS: │ │ │ │ │ 00037e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037e70: 2020 2020 2020 2020 2050 726f 6772 616d Program │ │ │ │ │ -00037e80: 2056 6172 6961 626c 6573 2e20 2020 286c Variables. (l │ │ │ │ │ -00037e90: 696e 6520 2031 3229 0a2a 2043 5050 464c ine 12).* CPPFL │ │ │ │ │ -00037ea0: 4147 5320 3c31 3e3a 2020 2020 2020 2020 AGS <1>: │ │ │ │ │ +00037e70: 2020 2020 2020 2020 2020 5072 6f67 7261 Progra │ │ │ │ │ +00037e80: 6d20 5661 7269 6162 6c65 732e 2020 2028 m Variables. ( │ │ │ │ │ +00037e90: 6c69 6e65 2020 3132 290a 2a20 4350 5046 line 12).* CPPF │ │ │ │ │ +00037ea0: 4c41 4753 203c 313e 3a20 2020 2020 2020 LAGS <1>: │ │ │ │ │ 00037eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037ec0: 2020 4173 7365 6d62 6c79 2053 7570 706f Assembly Suppo │ │ │ │ │ -00037ed0: 7274 2e20 2020 2028 6c69 6e65 2020 3130 rt. (line 10 │ │ │ │ │ -00037ee0: 290a 2a20 4358 583a 2020 2020 2020 2020 ).* CXX: │ │ │ │ │ +00037ec0: 2020 2041 7373 656d 626c 7920 5375 7070 Assembly Supp │ │ │ │ │ +00037ed0: 6f72 742e 2020 2020 286c 696e 6520 2031 ort. (line 1 │ │ │ │ │ +00037ee0: 3029 0a2a 2043 5858 3a20 2020 2020 2020 0).* CXX: │ │ │ │ │ 00037ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037f00: 2020 2020 2020 2020 2020 2043 2b2b 2053 C++ S │ │ │ │ │ -00037f10: 7570 706f 7274 2e20 2020 2020 2020 2020 upport. │ │ │ │ │ -00037f20: 286c 696e 6520 2031 3629 0a2a 2043 5858 (line 16).* CXX │ │ │ │ │ -00037f30: 434f 4d50 494c 453a 2020 2020 2020 2020 COMPILE: │ │ │ │ │ +00037f00: 2020 2020 2020 2020 2020 2020 432b 2b20 C++ │ │ │ │ │ +00037f10: 5375 7070 6f72 742e 2020 2020 2020 2020 Support. │ │ │ │ │ +00037f20: 2028 6c69 6e65 2020 3136 290a 2a20 4358 (line 16).* CX │ │ │ │ │ +00037f30: 5843 4f4d 5049 4c45 3a20 2020 2020 2020 XCOMPILE: │ │ │ │ │ 00037f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037f50: 2020 2020 432b 2b20 5375 7070 6f72 742e C++ Support. │ │ │ │ │ -00037f60: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00037f70: 3235 290a 2a20 4358 5846 4c41 4753 3a20 25).* CXXFLAGS: │ │ │ │ │ +00037f50: 2020 2020 2043 2b2b 2053 7570 706f 7274 C++ Support │ │ │ │ │ +00037f60: 2e20 2020 2020 2020 2020 286c 696e 6520 . (line │ │ │ │ │ +00037f70: 2032 3529 0a2a 2043 5858 464c 4147 533a 25).* CXXFLAGS: │ │ │ │ │ 00037f80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037f90: 2020 2020 2020 2020 2020 2020 2043 2b2b C++ │ │ │ │ │ -00037fa0: 2053 7570 706f 7274 2e20 2020 2020 2020 Support. │ │ │ │ │ -00037fb0: 2020 286c 696e 6520 2031 3929 0a2a 2043 (line 19).* C │ │ │ │ │ -00037fc0: 5858 4c49 4e4b 3a20 2020 2020 2020 2020 XXLINK: │ │ │ │ │ +00037f90: 2020 2020 2020 2020 2020 2020 2020 432b C+ │ │ │ │ │ +00037fa0: 2b20 5375 7070 6f72 742e 2020 2020 2020 + Support. │ │ │ │ │ +00037fb0: 2020 2028 6c69 6e65 2020 3139 290a 2a20 (line 19).* │ │ │ │ │ +00037fc0: 4358 584c 494e 4b3a 2020 2020 2020 2020 CXXLINK: │ │ │ │ │ 00037fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037fe0: 2020 2020 2020 432b 2b20 5375 7070 6f72 C++ Suppor │ │ │ │ │ -00037ff0: 742e 2020 2020 2020 2020 2028 6c69 6e65 t. (line │ │ │ │ │ -00038000: 2020 3239 290a 2a20 4358 584c 494e 4b20 29).* CXXLINK │ │ │ │ │ -00038010: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ -00038020: 2020 2020 2020 2020 2020 2020 2020 2048 H │ │ │ │ │ -00038030: 6f77 2074 6865 204c 696e 6b65 7220 6973 ow the Linker is │ │ │ │ │ -00038040: 2043 686f 7365 6e2e 0a20 2020 2020 2020 Chosen.. │ │ │ │ │ +00037fe0: 2020 2020 2020 2043 2b2b 2053 7570 706f C++ Suppo │ │ │ │ │ +00037ff0: 7274 2e20 2020 2020 2020 2020 286c 696e rt. (lin │ │ │ │ │ +00038000: 6520 2032 3929 0a2a 2043 5858 4c49 4e4b e 29).* CXXLINK │ │ │ │ │ +00038010: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +00038020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00038030: 486f 7720 7468 6520 4c69 6e6b 6572 2069 How the Linker i │ │ │ │ │ +00038040: 7320 4368 6f73 656e 2e0a 2020 2020 2020 s Chosen.. │ │ │ │ │ 00038050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038080: 2020 2020 2020 2028 6c69 6e65 2020 3131 (line 11 │ │ │ │ │ -00038090: 290a 2a20 4441 5441 3a20 2020 2020 2020 ).* DATA: │ │ │ │ │ +00038080: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +00038090: 3129 0a2a 2044 4154 413a 2020 2020 2020 1).* DATA: │ │ │ │ │ 000380a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000380b0: 2020 2020 2020 2020 2020 2055 6e69 666f Unifo │ │ │ │ │ -000380c0: 726d 2e20 2020 2020 2020 2020 2020 2020 rm. │ │ │ │ │ -000380d0: 286c 696e 6520 3130 3229 0a2a 2044 4154 (line 102).* DAT │ │ │ │ │ -000380e0: 4120 3c31 3e3a 2020 2020 2020 2020 2020 A <1>: │ │ │ │ │ +000380b0: 2020 2020 2020 2020 2020 2020 556e 6966 Unif │ │ │ │ │ +000380c0: 6f72 6d2e 2020 2020 2020 2020 2020 2020 orm. │ │ │ │ │ +000380d0: 2028 6c69 6e65 2031 3032 290a 2a20 4441 (line 102).* DA │ │ │ │ │ +000380e0: 5441 203c 313e 3a20 2020 2020 2020 2020 TA <1>: │ │ │ │ │ 000380f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038100: 2020 2020 4461 7461 2e20 2020 2020 2020 Data. │ │ │ │ │ -00038110: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00038120: 2037 290a 2a20 6461 7461 5f44 4154 413a 7).* data_DATA: │ │ │ │ │ -00038130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038140: 2020 2020 2020 2020 2020 2020 2044 6174 Dat │ │ │ │ │ -00038150: 612e 2020 2020 2020 2020 2020 2020 2020 a. │ │ │ │ │ -00038160: 2020 286c 696e 6520 2020 3929 0a2a 2044 (line 9).* D │ │ │ │ │ -00038170: 4546 533a 2020 2020 2020 2020 2020 2020 EFS: │ │ │ │ │ +00038100: 2020 2020 2044 6174 612e 2020 2020 2020 Data. │ │ │ │ │ +00038110: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00038120: 2020 3729 0a2a 2064 6174 615f 4441 5441 7).* data_DATA │ │ │ │ │ +00038130: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00038140: 2020 2020 2020 2020 2020 2020 2020 4461 Da │ │ │ │ │ +00038150: 7461 2e20 2020 2020 2020 2020 2020 2020 ta. │ │ │ │ │ +00038160: 2020 2028 6c69 6e65 2020 2039 290a 2a20 (line 9).* │ │ │ │ │ +00038170: 4445 4653 3a20 2020 2020 2020 2020 2020 DEFS: │ │ │ │ │ 00038180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038190: 2020 2020 2020 5072 6f67 7261 6d20 5661 Program Va │ │ │ │ │ -000381a0: 7269 6162 6c65 732e 2020 2028 6c69 6e65 riables. (line │ │ │ │ │ -000381b0: 2020 3132 290a 2a20 4445 4a41 544f 4f4c 12).* DEJATOOL │ │ │ │ │ -000381c0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000381d0: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ -000381e0: 656a 6147 6e75 2054 6573 7473 2e20 2020 ejaGnu Tests. │ │ │ │ │ -000381f0: 2020 2020 286c 696e 6520 2031 3929 0a2a (line 19).* │ │ │ │ │ -00038200: 2044 4553 5444 4952 3a20 2020 2020 2020 DESTDIR: │ │ │ │ │ +00038190: 2020 2020 2020 2050 726f 6772 616d 2056 Program V │ │ │ │ │ +000381a0: 6172 6961 626c 6573 2e20 2020 286c 696e ariables. (lin │ │ │ │ │ +000381b0: 6520 2031 3229 0a2a 2044 454a 4154 4f4f e 12).* DEJATOO │ │ │ │ │ +000381c0: 4c3a 2020 2020 2020 2020 2020 2020 2020 L: │ │ │ │ │ +000381d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000381e0: 4465 6a61 476e 7520 5465 7374 732e 2020 DejaGnu Tests. │ │ │ │ │ +000381f0: 2020 2020 2028 6c69 6e65 2020 3139 290a (line 19). │ │ │ │ │ +00038200: 2a20 4445 5354 4449 523a 2020 2020 2020 * DESTDIR: │ │ │ │ │ 00038210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038220: 2020 2020 2020 2020 4445 5354 4449 522e DESTDIR. │ │ │ │ │ -00038230: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00038240: 6e65 2020 2036 290a 2a20 4445 5354 4449 ne 6).* DESTDI │ │ │ │ │ -00038250: 5220 3c31 3e3a 2020 2020 2020 2020 2020 R <1>: │ │ │ │ │ +00038220: 2020 2020 2020 2020 2044 4553 5444 4952 DESTDIR │ │ │ │ │ +00038230: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00038240: 696e 6520 2020 3629 0a2a 2044 4553 5444 ine 6).* DESTD │ │ │ │ │ +00038250: 4952 203c 313e 3a20 2020 2020 2020 2020 IR <1>: │ │ │ │ │ 00038260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038270: 2053 7461 6765 6420 496e 7374 616c 6c73 Staged Installs │ │ │ │ │ -00038280: 2e20 2020 2020 286c 696e 6520 2020 3629 . (line 6) │ │ │ │ │ -00038290: 0a2a 2044 4953 4142 4c45 5f48 4152 445f .* DISABLE_HARD_ │ │ │ │ │ -000382a0: 4552 524f 5253 3a20 2020 2020 2020 2020 ERRORS: │ │ │ │ │ -000382b0: 2020 2020 2020 2020 2020 5369 6d70 6c65 Simple │ │ │ │ │ -000382c0: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ -000382d0: 616c 6c65 6c2d 7465 7374 732e 0a20 2020 allel-tests.. │ │ │ │ │ +00038270: 2020 5374 6167 6564 2049 6e73 7461 6c6c Staged Install │ │ │ │ │ +00038280: 732e 2020 2020 2028 6c69 6e65 2020 2036 s. (line 6 │ │ │ │ │ +00038290: 290a 2a20 4449 5341 424c 455f 4841 5244 ).* DISABLE_HARD │ │ │ │ │ +000382a0: 5f45 5252 4f52 533a 2020 2020 2020 2020 _ERRORS: │ │ │ │ │ +000382b0: 2020 2020 2020 2020 2020 2053 696d 706c Simpl │ │ │ │ │ +000382c0: 6520 5465 7374 7320 7573 696e 6720 7061 e Tests using pa │ │ │ │ │ +000382d0: 7261 6c6c 656c 2d74 6573 7473 2e0a 2020 rallel-tests.. │ │ │ │ │ 000382e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000382f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038310: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00038320: 2020 3735 290a 2a20 4449 5354 4348 4543 75).* DISTCHEC │ │ │ │ │ -00038330: 4b5f 434f 4e46 4947 5552 455f 464c 4147 K_CONFIGURE_FLAG │ │ │ │ │ -00038340: 533a 2020 2020 2020 2020 2020 2020 2043 S: C │ │ │ │ │ -00038350: 6865 636b 696e 6720 7468 6520 4469 7374 hecking the Dist │ │ │ │ │ -00038360: 7269 6275 7469 6f6e 2e0a 2020 2020 2020 ribution.. │ │ │ │ │ +00038310: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00038320: 6520 2037 3529 0a2a 2044 4953 5443 4845 e 75).* DISTCHE │ │ │ │ │ +00038330: 434b 5f43 4f4e 4649 4755 5245 5f46 4c41 CK_CONFIGURE_FLA │ │ │ │ │ +00038340: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ +00038350: 4368 6563 6b69 6e67 2074 6865 2044 6973 Checking the Dis │ │ │ │ │ +00038360: 7472 6962 7574 696f 6e2e 0a20 2020 2020 tribution.. │ │ │ │ │ 00038370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038380: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000383a0: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -000383b0: 3229 0a2a 2064 6973 7463 6c65 616e 6368 2).* distcleanch │ │ │ │ │ -000383c0: 6563 6b5f 6c69 7374 6669 6c65 733a 2020 eck_listfiles: │ │ │ │ │ -000383d0: 2020 2020 2020 2020 2020 2020 4368 6563 Chec │ │ │ │ │ -000383e0: 6b69 6e67 2074 6865 2044 6973 7472 6962 king the Distrib │ │ │ │ │ -000383f0: 7574 696f 6e2e 0a20 2020 2020 2020 2020 ution.. │ │ │ │ │ +000383a0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +000383b0: 3132 290a 2a20 6469 7374 636c 6561 6e63 12).* distcleanc │ │ │ │ │ +000383c0: 6865 636b 5f6c 6973 7466 696c 6573 3a20 heck_listfiles: │ │ │ │ │ +000383d0: 2020 2020 2020 2020 2020 2020 2043 6865 Che │ │ │ │ │ +000383e0: 636b 696e 6720 7468 6520 4469 7374 7269 cking the Distri │ │ │ │ │ +000383f0: 6275 7469 6f6e 2e0a 2020 2020 2020 2020 bution.. │ │ │ │ │ 00038400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038430: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -00038440: 2a20 6469 7374 636c 6561 6e63 6865 636b * distcleancheck │ │ │ │ │ -00038450: 5f6c 6973 7466 696c 6573 203c 313e 3a20 _listfiles <1>: │ │ │ │ │ -00038460: 2020 2020 2020 2020 2043 6865 636b 696e Checkin │ │ │ │ │ -00038470: 6720 7468 6520 4469 7374 7269 6275 7469 g the Distributi │ │ │ │ │ -00038480: 6f6e 2e0a 2020 2020 2020 2020 2020 2020 on.. │ │ │ │ │ +00038430: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +00038440: 0a2a 2064 6973 7463 6c65 616e 6368 6563 .* distcleanchec │ │ │ │ │ +00038450: 6b5f 6c69 7374 6669 6c65 7320 3c31 3e3a k_listfiles <1>: │ │ │ │ │ +00038460: 2020 2020 2020 2020 2020 4368 6563 6b69 Checki │ │ │ │ │ +00038470: 6e67 2074 6865 2044 6973 7472 6962 7574 ng the Distribut │ │ │ │ │ +00038480: 696f 6e2e 0a20 2020 2020 2020 2020 2020 ion.. │ │ │ │ │ 00038490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000384a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000384b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000384c0: 2020 286c 696e 6520 2034 3529 0a2a 2064 (line 45).* d │ │ │ │ │ -000384d0: 6973 7463 6c65 616e 6368 6563 6b5f 6c69 istcleancheck_li │ │ │ │ │ -000384e0: 7374 6669 6c65 7320 3c32 3e3a 2020 2020 stfiles <2>: │ │ │ │ │ -000384f0: 2020 2020 2020 6469 7374 636c 6561 6e63 distcleanc │ │ │ │ │ -00038500: 6865 636b 2e20 2020 2020 2028 6c69 6e65 heck. (line │ │ │ │ │ -00038510: 2031 3132 290a 2a20 4449 5354 434c 4541 112).* DISTCLEA │ │ │ │ │ -00038520: 4e46 494c 4553 3a20 2020 2020 2020 2020 NFILES: │ │ │ │ │ -00038530: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ -00038540: 6c65 616e 2e20 2020 2020 2020 2020 2020 lean. │ │ │ │ │ -00038550: 2020 2020 286c 696e 6520 2031 3329 0a2a (line 13).* │ │ │ │ │ -00038560: 2044 4953 5443 4c45 414e 4649 4c45 5320 DISTCLEANFILES │ │ │ │ │ -00038570: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ -00038580: 2020 2020 2020 2020 4368 6563 6b69 6e67 Checking │ │ │ │ │ -00038590: 2074 6865 2044 6973 7472 6962 7574 696f the Distributio │ │ │ │ │ -000385a0: 6e2e 0a20 2020 2020 2020 2020 2020 2020 n.. │ │ │ │ │ +000384c0: 2020 2028 6c69 6e65 2020 3435 290a 2a20 (line 45).* │ │ │ │ │ +000384d0: 6469 7374 636c 6561 6e63 6865 636b 5f6c distcleancheck_l │ │ │ │ │ +000384e0: 6973 7466 696c 6573 203c 323e 3a20 2020 istfiles <2>: │ │ │ │ │ +000384f0: 2020 2020 2020 2064 6973 7463 6c65 616e distclean │ │ │ │ │ +00038500: 6368 6563 6b2e 2020 2020 2020 286c 696e check. (lin │ │ │ │ │ +00038510: 6520 3131 3229 0a2a 2044 4953 5443 4c45 e 112).* DISTCLE │ │ │ │ │ +00038520: 414e 4649 4c45 533a 2020 2020 2020 2020 ANFILES: │ │ │ │ │ +00038530: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00038540: 436c 6561 6e2e 2020 2020 2020 2020 2020 Clean. │ │ │ │ │ +00038550: 2020 2020 2028 6c69 6e65 2020 3133 290a (line 13). │ │ │ │ │ +00038560: 2a20 4449 5354 434c 4541 4e46 494c 4553 * DISTCLEANFILES │ │ │ │ │ +00038570: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +00038580: 2020 2020 2020 2020 2043 6865 636b 696e Checkin │ │ │ │ │ +00038590: 6720 7468 6520 4469 7374 7269 6275 7469 g the Distributi │ │ │ │ │ +000385a0: 6f6e 2e0a 2020 2020 2020 2020 2020 2020 on.. │ │ │ │ │ 000385b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000385c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000385d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000385e0: 2028 6c69 6e65 2020 3435 290a 2a20 6469 (line 45).* di │ │ │ │ │ -000385f0: 7374 6469 723a 2020 2020 2020 2020 2020 stdir: │ │ │ │ │ +000385e0: 2020 286c 696e 6520 2034 3529 0a2a 2064 (line 45).* d │ │ │ │ │ +000385f0: 6973 7464 6972 3a20 2020 2020 2020 2020 istdir: │ │ │ │ │ 00038600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038610: 2020 2020 2054 6865 2064 6973 7420 486f The dist Ho │ │ │ │ │ -00038620: 6f6b 2e20 2020 2020 2020 286c 696e 6520 ok. (line │ │ │ │ │ -00038630: 2032 3429 0a2a 2064 6973 7464 6972 203c 24).* distdir < │ │ │ │ │ -00038640: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ -00038650: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ -00038660: 6972 642d 5061 7274 7920 4d61 6b65 6669 ird-Party Makefi │ │ │ │ │ -00038670: 6c65 732e 0a20 2020 2020 2020 2020 2020 les.. │ │ │ │ │ +00038610: 2020 2020 2020 5468 6520 6469 7374 2048 The dist H │ │ │ │ │ +00038620: 6f6f 6b2e 2020 2020 2020 2028 6c69 6e65 ook. (line │ │ │ │ │ +00038630: 2020 3234 290a 2a20 6469 7374 6469 7220 24).* distdir │ │ │ │ │ +00038640: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +00038650: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ +00038660: 6869 7264 2d50 6172 7479 204d 616b 6566 hird-Party Makef │ │ │ │ │ +00038670: 696c 6573 2e0a 2020 2020 2020 2020 2020 iles.. │ │ │ │ │ 00038680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000386a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000386b0: 2020 2028 6c69 6e65 2020 3235 290a 2a20 (line 25).* │ │ │ │ │ -000386c0: 6469 7374 756e 696e 7374 616c 6c63 6865 distuninstallche │ │ │ │ │ -000386d0: 636b 5f6c 6973 7466 696c 6573 3a20 2020 ck_listfiles: │ │ │ │ │ -000386e0: 2020 2020 2020 2043 6865 636b 696e 6720 Checking │ │ │ │ │ -000386f0: 7468 6520 4469 7374 7269 6275 7469 6f6e the Distribution │ │ │ │ │ -00038700: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +000386b0: 2020 2020 286c 696e 6520 2032 3529 0a2a (line 25).* │ │ │ │ │ +000386c0: 2064 6973 7475 6e69 6e73 7461 6c6c 6368 distuninstallch │ │ │ │ │ +000386d0: 6563 6b5f 6c69 7374 6669 6c65 733a 2020 eck_listfiles: │ │ │ │ │ +000386e0: 2020 2020 2020 2020 4368 6563 6b69 6e67 Checking │ │ │ │ │ +000386f0: 2074 6865 2044 6973 7472 6962 7574 696f the Distributio │ │ │ │ │ +00038700: 6e2e 0a20 2020 2020 2020 2020 2020 2020 n.. │ │ │ │ │ 00038710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038720: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038730: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038740: 286c 696e 6520 2020 3629 0a2a 2064 6973 (line 6).* dis │ │ │ │ │ -00038750: 745f 3a20 2020 2020 2020 2020 2020 2020 t_: │ │ │ │ │ +00038740: 2028 6c69 6e65 2020 2036 290a 2a20 6469 (line 6).* di │ │ │ │ │ +00038750: 7374 5f3a 2020 2020 2020 2020 2020 2020 st_: │ │ │ │ │ 00038760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038770: 2020 2020 416c 7465 726e 6174 6976 652e Alternative. │ │ │ │ │ -00038780: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00038790: 3239 290a 2a20 6469 7374 5f20 3c31 3e3a 29).* dist_ <1>: │ │ │ │ │ -000387a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000387b0: 2020 2020 2020 2020 2020 2020 2046 696e Fin │ │ │ │ │ -000387c0: 652d 6772 6169 6e65 6420 4469 7374 7269 e-grained Distri │ │ │ │ │ -000387d0: 6275 7469 6f6e 2043 6f6e 7472 6f6c 2e0a bution Control.. │ │ │ │ │ -000387e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00038770: 2020 2020 2041 6c74 6572 6e61 7469 7665 Alternative │ │ │ │ │ +00038780: 2e20 2020 2020 2020 2020 286c 696e 6520 . (line │ │ │ │ │ +00038790: 2032 3929 0a2a 2064 6973 745f 203c 313e 29).* dist_ <1> │ │ │ │ │ +000387a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000387b0: 2020 2020 2020 2020 2020 2020 2020 4669 Fi │ │ │ │ │ +000387c0: 6e65 2d67 7261 696e 6564 2044 6973 7472 ne-grained Distr │ │ │ │ │ +000387d0: 6962 7574 696f 6e20 436f 6e74 726f 6c2e ibution Control. │ │ │ │ │ +000387e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 000387f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038810: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00038820: 696e 6520 2020 3629 0a2a 2064 6973 745f ine 6).* dist_ │ │ │ │ │ -00038830: 6c69 7370 5f4c 4953 503a 2020 2020 2020 lisp_LISP: │ │ │ │ │ +00038810: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00038820: 6c69 6e65 2020 2036 290a 2a20 6469 7374 line 6).* dist │ │ │ │ │ +00038830: 5f6c 6973 705f 4c49 5350 3a20 2020 2020 _lisp_LISP: │ │ │ │ │ 00038840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038850: 2020 456d 6163 7320 4c69 7370 2e20 2020 Emacs Lisp. │ │ │ │ │ -00038860: 2020 2020 2020 2028 6c69 6e65 2020 3131 (line 11 │ │ │ │ │ -00038870: 290a 2a20 6469 7374 5f6e 6f69 6e73 745f ).* dist_noinst_ │ │ │ │ │ -00038880: 4c49 5350 3a20 2020 2020 2020 2020 2020 LISP: │ │ │ │ │ -00038890: 2020 2020 2020 2020 2020 2045 6d61 6373 Emacs │ │ │ │ │ -000388a0: 204c 6973 702e 2020 2020 2020 2020 2020 Lisp. │ │ │ │ │ -000388b0: 286c 696e 6520 2031 3129 0a2a 2044 4953 (line 11).* DIS │ │ │ │ │ -000388c0: 545f 5355 4244 4952 533a 2020 2020 2020 T_SUBDIRS: │ │ │ │ │ +00038850: 2020 2045 6d61 6373 204c 6973 702e 2020 Emacs Lisp. │ │ │ │ │ +00038860: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +00038870: 3129 0a2a 2064 6973 745f 6e6f 696e 7374 1).* dist_noinst │ │ │ │ │ +00038880: 5f4c 4953 503a 2020 2020 2020 2020 2020 _LISP: │ │ │ │ │ +00038890: 2020 2020 2020 2020 2020 2020 456d 6163 Emac │ │ │ │ │ +000388a0: 7320 4c69 7370 2e20 2020 2020 2020 2020 s Lisp. │ │ │ │ │ +000388b0: 2028 6c69 6e65 2020 3131 290a 2a20 4449 (line 11).* DI │ │ │ │ │ +000388c0: 5354 5f53 5542 4449 5253 3a20 2020 2020 ST_SUBDIRS: │ │ │ │ │ 000388d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000388e0: 2020 2020 5375 6264 6972 6563 746f 7269 Subdirectori │ │ │ │ │ -000388f0: 6573 2077 6974 6820 414d 5f43 4f4e 4449 es with AM_CONDI │ │ │ │ │ -00038900: 5449 4f4e 414c 2e0a 2020 2020 2020 2020 TIONAL.. │ │ │ │ │ +000388e0: 2020 2020 2053 7562 6469 7265 6374 6f72 Subdirector │ │ │ │ │ +000388f0: 6965 7320 7769 7468 2041 4d5f 434f 4e44 ies with AM_COND │ │ │ │ │ +00038900: 4954 494f 4e41 4c2e 0a20 2020 2020 2020 ITIONAL.. │ │ │ │ │ 00038910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038930: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038940: 2020 2020 2020 286c 696e 6520 2032 3529 (line 25) │ │ │ │ │ -00038950: 0a2a 2044 4953 545f 5355 4244 4952 5320 .* DIST_SUBDIRS │ │ │ │ │ -00038960: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ -00038970: 2020 2020 2020 2020 2020 4261 7369 6373 Basics │ │ │ │ │ -00038980: 206f 6620 4469 7374 7269 6275 7469 6f6e of Distribution │ │ │ │ │ -00038990: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00038940: 2020 2020 2020 2028 6c69 6e65 2020 3235 (line 25 │ │ │ │ │ +00038950: 290a 2a20 4449 5354 5f53 5542 4449 5253 ).* DIST_SUBDIRS │ │ │ │ │ +00038960: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +00038970: 2020 2020 2020 2020 2020 2042 6173 6963 Basic │ │ │ │ │ +00038980: 7320 6f66 2044 6973 7472 6962 7574 696f s of Distributio │ │ │ │ │ +00038990: 6e2e 0a20 2020 2020 2020 2020 2020 2020 n.. │ │ │ │ │ 000389a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000389b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000389c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000389d0: 286c 696e 6520 2034 3129 0a2a 2044 5649 (line 41).* DVI │ │ │ │ │ -000389e0: 5053 3a20 2020 2020 2020 2020 2020 2020 PS: │ │ │ │ │ +000389d0: 2028 6c69 6e65 2020 3431 290a 2a20 4456 (line 41).* DV │ │ │ │ │ +000389e0: 4950 533a 2020 2020 2020 2020 2020 2020 IPS: │ │ │ │ │ 000389f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038a00: 2020 2020 5465 7869 6e66 6f2e 2020 2020 Texinfo. │ │ │ │ │ -00038a10: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ -00038a20: 3335 290a 2a20 454d 4143 533a 2020 2020 35).* EMACS: │ │ │ │ │ +00038a00: 2020 2020 2054 6578 696e 666f 2e20 2020 Texinfo. │ │ │ │ │ +00038a10: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00038a20: 3133 3529 0a2a 2045 4d41 4353 3a20 2020 135).* EMACS: │ │ │ │ │ 00038a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038a40: 2020 2020 2020 2020 2020 2020 2050 7562 Pub │ │ │ │ │ -00038a50: 6c69 6320 4d61 6372 6f73 2e20 2020 2020 lic Macros. │ │ │ │ │ -00038a60: 2020 286c 696e 6520 2036 3629 0a2a 2045 (line 66).* E │ │ │ │ │ -00038a70: 5441 4753 464c 4147 533a 2020 2020 2020 TAGSFLAGS: │ │ │ │ │ +00038a40: 2020 2020 2020 2020 2020 2020 2020 5075 Pu │ │ │ │ │ +00038a50: 626c 6963 204d 6163 726f 732e 2020 2020 blic Macros. │ │ │ │ │ +00038a60: 2020 2028 6c69 6e65 2020 3636 290a 2a20 (line 66).* │ │ │ │ │ +00038a70: 4554 4147 5346 4c41 4753 3a20 2020 2020 ETAGSFLAGS: │ │ │ │ │ 00038a80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038a90: 2020 2020 2020 5461 6773 2e20 2020 2020 Tags. │ │ │ │ │ -00038aa0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00038ab0: 2020 3235 290a 2a20 4554 4147 535f 4152 25).* ETAGS_AR │ │ │ │ │ -00038ac0: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ -00038ad0: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -00038ae0: 6167 732e 2020 2020 2020 2020 2020 2020 ags. │ │ │ │ │ -00038af0: 2020 2020 286c 696e 6520 2032 3529 0a2a (line 25).* │ │ │ │ │ -00038b00: 2045 5850 4543 543a 2020 2020 2020 2020 EXPECT: │ │ │ │ │ +00038a90: 2020 2020 2020 2054 6167 732e 2020 2020 Tags. │ │ │ │ │ +00038aa0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00038ab0: 6520 2032 3529 0a2a 2045 5441 4753 5f41 e 25).* ETAGS_A │ │ │ │ │ +00038ac0: 5247 533a 2020 2020 2020 2020 2020 2020 RGS: │ │ │ │ │ +00038ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00038ae0: 5461 6773 2e20 2020 2020 2020 2020 2020 Tags. │ │ │ │ │ +00038af0: 2020 2020 2028 6c69 6e65 2020 3235 290a (line 25). │ │ │ │ │ +00038b00: 2a20 4558 5045 4354 3a20 2020 2020 2020 * EXPECT: │ │ │ │ │ 00038b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038b20: 2020 2020 2020 2020 4465 6a61 476e 7520 DejaGnu │ │ │ │ │ -00038b30: 5465 7374 732e 2020 2020 2020 2028 6c69 Tests. (li │ │ │ │ │ -00038b40: 6e65 2020 3139 290a 2a20 4558 5452 415f ne 19).* EXTRA_ │ │ │ │ │ -00038b50: 4449 5354 3a20 2020 2020 2020 2020 2020 DIST: │ │ │ │ │ +00038b20: 2020 2020 2020 2020 2044 656a 6147 6e75 DejaGnu │ │ │ │ │ +00038b30: 2054 6573 7473 2e20 2020 2020 2020 286c Tests. (l │ │ │ │ │ +00038b40: 696e 6520 2031 3929 0a2a 2045 5854 5241 ine 19).* EXTRA │ │ │ │ │ +00038b50: 5f44 4953 543a 2020 2020 2020 2020 2020 _DIST: │ │ │ │ │ 00038b60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038b70: 2042 6173 6963 7320 6f66 2044 6973 7472 Basics of Distr │ │ │ │ │ -00038b80: 6962 7574 696f 6e2e 0a20 2020 2020 2020 ibution.. │ │ │ │ │ +00038b70: 2020 4261 7369 6373 206f 6620 4469 7374 Basics of Dist │ │ │ │ │ +00038b80: 7269 6275 7469 6f6e 2e0a 2020 2020 2020 ribution.. │ │ │ │ │ 00038b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038bc0: 2020 2020 2020 2028 6c69 6e65 2020 3330 (line 30 │ │ │ │ │ -00038bd0: 290a 2a20 4558 5452 415f 6d61 7564 655f ).* EXTRA_maude_ │ │ │ │ │ -00038be0: 4445 5045 4e44 454e 4349 4553 3a20 2020 DEPENDENCIES: │ │ │ │ │ -00038bf0: 2020 2020 2020 2020 2020 204c 696e 6b69 Linki │ │ │ │ │ -00038c00: 6e67 2e20 2020 2020 2020 2020 2020 2020 ng. │ │ │ │ │ -00038c10: 286c 696e 6520 2034 3129 0a2a 2045 5854 (line 41).* EXT │ │ │ │ │ -00038c20: 5241 5f6d 6175 6465 5f44 4550 454e 4445 RA_maude_DEPENDE │ │ │ │ │ -00038c30: 4e43 4945 5320 3c31 3e3a 2020 2020 2020 NCIES <1>: │ │ │ │ │ -00038c40: 2020 2020 5072 6f67 7261 6d20 616e 6420 Program and │ │ │ │ │ -00038c50: 4c69 6272 6172 7920 5661 7269 6162 6c65 Library Variable │ │ │ │ │ -00038c60: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ +00038bc0: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ +00038bd0: 3029 0a2a 2045 5854 5241 5f6d 6175 6465 0).* EXTRA_maude │ │ │ │ │ +00038be0: 5f44 4550 454e 4445 4e43 4945 533a 2020 _DEPENDENCIES: │ │ │ │ │ +00038bf0: 2020 2020 2020 2020 2020 2020 4c69 6e6b Link │ │ │ │ │ +00038c00: 696e 672e 2020 2020 2020 2020 2020 2020 ing. │ │ │ │ │ +00038c10: 2028 6c69 6e65 2020 3431 290a 2a20 4558 (line 41).* EX │ │ │ │ │ +00038c20: 5452 415f 6d61 7564 655f 4445 5045 4e44 TRA_maude_DEPEND │ │ │ │ │ +00038c30: 454e 4349 4553 203c 313e 3a20 2020 2020 ENCIES <1>: │ │ │ │ │ +00038c40: 2020 2020 2050 726f 6772 616d 2061 6e64 Program and │ │ │ │ │ +00038c50: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ +00038c60: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ 00038c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038c90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038ca0: 2028 6c69 6e65 2031 3139 290a 2a20 4558 (line 119).* EX │ │ │ │ │ -00038cb0: 5452 415f 6d61 7564 655f 534f 5552 4345 TRA_maude_SOURCE │ │ │ │ │ -00038cc0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -00038cd0: 2020 2020 2050 726f 6772 616d 2061 6e64 Program and │ │ │ │ │ -00038ce0: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ -00038cf0: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ +00038ca0: 2020 286c 696e 6520 3131 3929 0a2a 2045 (line 119).* E │ │ │ │ │ +00038cb0: 5854 5241 5f6d 6175 6465 5f53 4f55 5243 XTRA_maude_SOURC │ │ │ │ │ +00038cc0: 4553 3a20 2020 2020 2020 2020 2020 2020 ES: │ │ │ │ │ +00038cd0: 2020 2020 2020 5072 6f67 7261 6d20 616e Program an │ │ │ │ │ +00038ce0: 6420 4c69 6272 6172 7920 5661 7269 6162 d Library Variab │ │ │ │ │ +00038cf0: 6c65 732e 0a20 2020 2020 2020 2020 2020 les.. │ │ │ │ │ 00038d00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038d10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038d20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038d30: 2020 286c 696e 6520 2035 3329 0a2a 2045 (line 53).* E │ │ │ │ │ -00038d40: 5854 5241 5f50 524f 4752 414d 533a 2020 XTRA_PROGRAMS: │ │ │ │ │ +00038d30: 2020 2028 6c69 6e65 2020 3533 290a 2a20 (line 53).* │ │ │ │ │ +00038d40: 4558 5452 415f 5052 4f47 5241 4d53 3a20 EXTRA_PROGRAMS: │ │ │ │ │ 00038d50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038d60: 2020 2020 2020 436f 6e64 6974 696f 6e61 Conditiona │ │ │ │ │ -00038d70: 6c20 5072 6f67 7261 6d73 2e0a 2020 2020 l Programs.. │ │ │ │ │ +00038d60: 2020 2020 2020 2043 6f6e 6469 7469 6f6e Condition │ │ │ │ │ +00038d70: 616c 2050 726f 6772 616d 732e 0a20 2020 al Programs.. │ │ │ │ │ 00038d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038d90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038da0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038db0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00038dc0: 2031 3529 0a2a 2045 5854 5f4c 4f47 5f43 15).* EXT_LOG_C │ │ │ │ │ -00038dd0: 4f4d 5049 4c45 3a20 2020 2020 2020 2020 OMPILE: │ │ │ │ │ -00038de0: 2020 2020 2020 2020 2020 2020 2020 5369 Si │ │ │ │ │ -00038df0: 6d70 6c65 2054 6573 7473 2075 7369 6e67 mple Tests using │ │ │ │ │ -00038e00: 2070 6172 616c 6c65 6c2d 7465 7374 732e parallel-tests. │ │ │ │ │ -00038e10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00038db0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00038dc0: 2020 3135 290a 2a20 4558 545f 4c4f 475f 15).* EXT_LOG_ │ │ │ │ │ +00038dd0: 434f 4d50 494c 453a 2020 2020 2020 2020 COMPILE: │ │ │ │ │ +00038de0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ +00038df0: 696d 706c 6520 5465 7374 7320 7573 696e imple Tests usin │ │ │ │ │ +00038e00: 6720 7061 7261 6c6c 656c 2d74 6573 7473 g parallel-tests │ │ │ │ │ +00038e10: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 00038e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038e30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038e40: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00038e50: 6c69 6e65 2020 3339 290a 2a20 4558 545f line 39).* EXT_ │ │ │ │ │ -00038e60: 4c4f 475f 434f 4d50 494c 4552 3a20 2020 LOG_COMPILER: │ │ │ │ │ +00038e40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00038e50: 286c 696e 6520 2033 3929 0a2a 2045 5854 (line 39).* EXT │ │ │ │ │ +00038e60: 5f4c 4f47 5f43 4f4d 5049 4c45 523a 2020 _LOG_COMPILER: │ │ │ │ │ 00038e70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038e80: 2020 2053 696d 706c 6520 5465 7374 7320 Simple Tests │ │ │ │ │ -00038e90: 7573 696e 6720 7061 7261 6c6c 656c 2d74 using parallel-t │ │ │ │ │ -00038ea0: 6573 7473 2e0a 2020 2020 2020 2020 2020 ests.. │ │ │ │ │ +00038e80: 2020 2020 5369 6d70 6c65 2054 6573 7473 Simple Tests │ │ │ │ │ +00038e90: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ +00038ea0: 7465 7374 732e 0a20 2020 2020 2020 2020 tests.. │ │ │ │ │ 00038eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038ec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038ee0: 2020 2020 286c 696e 6520 2033 3929 0a2a (line 39).* │ │ │ │ │ -00038ef0: 2045 5854 5f4c 4f47 5f46 4c41 4753 3a20 EXT_LOG_FLAGS: │ │ │ │ │ +00038ee0: 2020 2020 2028 6c69 6e65 2020 3339 290a (line 39). │ │ │ │ │ +00038ef0: 2a20 4558 545f 4c4f 475f 464c 4147 533a * EXT_LOG_FLAGS: │ │ │ │ │ 00038f00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038f10: 2020 2020 2020 2020 5369 6d70 6c65 2054 Simple T │ │ │ │ │ -00038f20: 6573 7473 2075 7369 6e67 2070 6172 616c ests using paral │ │ │ │ │ -00038f30: 6c65 6c2d 7465 7374 732e 0a20 2020 2020 lel-tests.. │ │ │ │ │ +00038f10: 2020 2020 2020 2020 2053 696d 706c 6520 Simple │ │ │ │ │ +00038f20: 5465 7374 7320 7573 696e 6720 7061 7261 Tests using para │ │ │ │ │ +00038f30: 6c6c 656c 2d74 6573 7473 2e0a 2020 2020 llel-tests.. │ │ │ │ │ 00038f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00038f60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038f70: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00038f80: 3339 290a 2a20 4637 373a 2020 2020 2020 39).* F77: │ │ │ │ │ +00038f70: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00038f80: 2033 3929 0a2a 2046 3737 3a20 2020 2020 39).* F77: │ │ │ │ │ 00038f90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038fa0: 2020 2020 2020 2020 2020 2020 2046 6f72 For │ │ │ │ │ -00038fb0: 7472 616e 2037 3720 5375 7070 6f72 742e tran 77 Support. │ │ │ │ │ -00038fc0: 2020 286c 696e 6520 2031 3629 0a2a 2046 (line 16).* F │ │ │ │ │ -00038fd0: 3737 434f 4d50 494c 453a 2020 2020 2020 77COMPILE: │ │ │ │ │ +00038fa0: 2020 2020 2020 2020 2020 2020 2020 466f Fo │ │ │ │ │ +00038fb0: 7274 7261 6e20 3737 2053 7570 706f 7274 rtran 77 Support │ │ │ │ │ +00038fc0: 2e20 2028 6c69 6e65 2020 3136 290a 2a20 . (line 16).* │ │ │ │ │ +00038fd0: 4637 3743 4f4d 5049 4c45 3a20 2020 2020 F77COMPILE: │ │ │ │ │ 00038fe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00038ff0: 2020 2020 2020 466f 7274 7261 6e20 3737 Fortran 77 │ │ │ │ │ -00039000: 2053 7570 706f 7274 2e20 2028 6c69 6e65 Support. (line │ │ │ │ │ -00039010: 2020 3331 290a 2a20 4637 374c 494e 4b3a 31).* F77LINK: │ │ │ │ │ -00039020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039030: 2020 2020 2020 2020 2020 2020 2020 2048 H │ │ │ │ │ -00039040: 6f77 2074 6865 204c 696e 6b65 7220 6973 ow the Linker is │ │ │ │ │ -00039050: 2043 686f 7365 6e2e 0a20 2020 2020 2020 Chosen.. │ │ │ │ │ +00038ff0: 2020 2020 2020 2046 6f72 7472 616e 2037 Fortran 7 │ │ │ │ │ +00039000: 3720 5375 7070 6f72 742e 2020 286c 696e 7 Support. (lin │ │ │ │ │ +00039010: 6520 2033 3129 0a2a 2046 3737 4c49 4e4b e 31).* F77LINK │ │ │ │ │ +00039020: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00039030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00039040: 486f 7720 7468 6520 4c69 6e6b 6572 2069 How the Linker i │ │ │ │ │ +00039050: 7320 4368 6f73 656e 2e0a 2020 2020 2020 s Chosen.. │ │ │ │ │ 00039060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039090: 2020 2020 2020 2028 6c69 6e65 2020 3132 (line 12 │ │ │ │ │ -000390a0: 290a 2a20 4643 3a20 2020 2020 2020 2020 ).* FC: │ │ │ │ │ +00039090: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +000390a0: 3229 0a2a 2046 433a 2020 2020 2020 2020 2).* FC: │ │ │ │ │ 000390b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000390c0: 2020 2020 2020 2020 2020 2046 6f72 7472 Fortr │ │ │ │ │ -000390d0: 616e 2039 7820 5375 7070 6f72 742e 2020 an 9x Support. │ │ │ │ │ -000390e0: 286c 696e 6520 2031 3629 0a2a 2046 4343 (line 16).* FCC │ │ │ │ │ -000390f0: 4f4d 5049 4c45 3a20 2020 2020 2020 2020 OMPILE: │ │ │ │ │ +000390c0: 2020 2020 2020 2020 2020 2020 466f 7274 Fort │ │ │ │ │ +000390d0: 7261 6e20 3978 2053 7570 706f 7274 2e20 ran 9x Support. │ │ │ │ │ +000390e0: 2028 6c69 6e65 2020 3136 290a 2a20 4643 (line 16).* FC │ │ │ │ │ +000390f0: 434f 4d50 494c 453a 2020 2020 2020 2020 COMPILE: │ │ │ │ │ 00039100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039110: 2020 2020 466f 7274 7261 6e20 3978 2053 Fortran 9x S │ │ │ │ │ -00039120: 7570 706f 7274 2e20 2028 6c69 6e65 2020 upport. (line │ │ │ │ │ -00039130: 3235 290a 2a20 4643 464c 4147 533a 2020 25).* FCFLAGS: │ │ │ │ │ +00039110: 2020 2020 2046 6f72 7472 616e 2039 7820 Fortran 9x │ │ │ │ │ +00039120: 5375 7070 6f72 742e 2020 286c 696e 6520 Support. (line │ │ │ │ │ +00039130: 2032 3529 0a2a 2046 4346 4c41 4753 3a20 25).* FCFLAGS: │ │ │ │ │ 00039140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039150: 2020 2020 2020 2020 2020 2020 2046 6f72 For │ │ │ │ │ -00039160: 7472 616e 2039 7820 5375 7070 6f72 742e tran 9x Support. │ │ │ │ │ -00039170: 2020 286c 696e 6520 2031 3929 0a2a 2046 (line 19).* F │ │ │ │ │ -00039180: 434c 494e 4b3a 2020 2020 2020 2020 2020 CLINK: │ │ │ │ │ +00039150: 2020 2020 2020 2020 2020 2020 2020 466f Fo │ │ │ │ │ +00039160: 7274 7261 6e20 3978 2053 7570 706f 7274 rtran 9x Support │ │ │ │ │ +00039170: 2e20 2028 6c69 6e65 2020 3139 290a 2a20 . (line 19).* │ │ │ │ │ +00039180: 4643 4c49 4e4b 3a20 2020 2020 2020 2020 FCLINK: │ │ │ │ │ 00039190: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000391a0: 2020 2020 2020 486f 7720 7468 6520 4c69 How the Li │ │ │ │ │ -000391b0: 6e6b 6572 2069 7320 4368 6f73 656e 2e0a nker is Chosen.. │ │ │ │ │ -000391c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000391a0: 2020 2020 2020 2048 6f77 2074 6865 204c How the L │ │ │ │ │ +000391b0: 696e 6b65 7220 6973 2043 686f 7365 6e2e inker is Chosen. │ │ │ │ │ +000391c0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 000391d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000391e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000391f0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00039200: 696e 6520 2031 3329 0a2a 2046 434c 494e ine 13).* FCLIN │ │ │ │ │ -00039210: 4b20 3c31 3e3a 2020 2020 2020 2020 2020 K <1>: │ │ │ │ │ +000391f0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00039200: 6c69 6e65 2020 3133 290a 2a20 4643 4c49 line 13).* FCLI │ │ │ │ │ +00039210: 4e4b 203c 313e 3a20 2020 2020 2020 2020 NK <1>: │ │ │ │ │ 00039220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039230: 2020 466f 7274 7261 6e20 3978 2053 7570 Fortran 9x Sup │ │ │ │ │ -00039240: 706f 7274 2e20 2028 6c69 6e65 2020 3239 port. (line 29 │ │ │ │ │ -00039250: 290a 2a20 4646 4c41 4753 3a20 2020 2020 ).* FFLAGS: │ │ │ │ │ +00039230: 2020 2046 6f72 7472 616e 2039 7820 5375 Fortran 9x Su │ │ │ │ │ +00039240: 7070 6f72 742e 2020 286c 696e 6520 2032 pport. (line 2 │ │ │ │ │ +00039250: 3929 0a2a 2046 464c 4147 533a 2020 2020 9).* FFLAGS: │ │ │ │ │ 00039260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039270: 2020 2020 2020 2020 2020 2046 6f72 7472 Fortr │ │ │ │ │ -00039280: 616e 2037 3720 5375 7070 6f72 742e 2020 an 77 Support. │ │ │ │ │ -00039290: 286c 696e 6520 2031 3929 0a2a 2046 4c49 (line 19).* FLI │ │ │ │ │ -000392a0: 4253 3a20 2020 2020 2020 2020 2020 2020 BS: │ │ │ │ │ +00039270: 2020 2020 2020 2020 2020 2020 466f 7274 Fort │ │ │ │ │ +00039280: 7261 6e20 3737 2053 7570 706f 7274 2e20 ran 77 Support. │ │ │ │ │ +00039290: 2028 6c69 6e65 2020 3139 290a 2a20 464c (line 19).* FL │ │ │ │ │ +000392a0: 4942 533a 2020 2020 2020 2020 2020 2020 IBS: │ │ │ │ │ 000392b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000392c0: 2020 2020 4d69 7869 6e67 2046 6f72 7472 Mixing Fortr │ │ │ │ │ -000392d0: 616e 2037 3720 5769 7468 2043 2061 6e64 an 77 With C and │ │ │ │ │ -000392e0: 2043 2b2b 2e0a 2020 2020 2020 2020 2020 C++.. │ │ │ │ │ +000392c0: 2020 2020 204d 6978 696e 6720 466f 7274 Mixing Fort │ │ │ │ │ +000392d0: 7261 6e20 3737 2057 6974 6820 4320 616e ran 77 With C an │ │ │ │ │ +000392e0: 6420 432b 2b2e 0a20 2020 2020 2020 2020 d C++.. │ │ │ │ │ 000392f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039310: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039320: 2020 2020 286c 696e 6520 2032 3129 0a2a (line 21).* │ │ │ │ │ -00039330: 2046 4c49 4e4b 3a20 2020 2020 2020 2020 FLINK: │ │ │ │ │ +00039320: 2020 2020 2028 6c69 6e65 2020 3231 290a (line 21). │ │ │ │ │ +00039330: 2a20 464c 494e 4b3a 2020 2020 2020 2020 * FLINK: │ │ │ │ │ 00039340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039350: 2020 2020 2020 2020 466f 7274 7261 6e20 Fortran │ │ │ │ │ -00039360: 3737 2053 7570 706f 7274 2e20 2028 6c69 77 Support. (li │ │ │ │ │ -00039370: 6e65 2020 3335 290a 2a20 4743 4a3a 2020 ne 35).* GCJ: │ │ │ │ │ +00039350: 2020 2020 2020 2020 2046 6f72 7472 616e Fortran │ │ │ │ │ +00039360: 2037 3720 5375 7070 6f72 742e 2020 286c 77 Support. (l │ │ │ │ │ +00039370: 696e 6520 2033 3529 0a2a 2047 434a 3a20 ine 35).* GCJ: │ │ │ │ │ 00039380: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000393a0: 2050 7562 6c69 6320 4d61 6372 6f73 2e20 Public Macros. │ │ │ │ │ -000393b0: 2020 2020 2020 286c 696e 6520 3130 3429 (line 104) │ │ │ │ │ -000393c0: 0a2a 2047 434a 464c 4147 533a 2020 2020 .* GCJFLAGS: │ │ │ │ │ +000393a0: 2020 5075 626c 6963 204d 6163 726f 732e Public Macros. │ │ │ │ │ +000393b0: 2020 2020 2020 2028 6c69 6e65 2031 3034 (line 104 │ │ │ │ │ +000393c0: 290a 2a20 4743 4a46 4c41 4753 3a20 2020 ).* GCJFLAGS: │ │ │ │ │ 000393d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000393e0: 2020 2020 2020 2020 2020 5075 626c 6963 Public │ │ │ │ │ -000393f0: 204d 6163 726f 732e 2020 2020 2020 2028 Macros. ( │ │ │ │ │ -00039400: 6c69 6e65 2031 3034 290a 2a20 4743 4a46 line 104).* GCJF │ │ │ │ │ -00039410: 4c41 4753 203c 313e 3a20 2020 2020 2020 LAGS <1>: │ │ │ │ │ +000393e0: 2020 2020 2020 2020 2020 2050 7562 6c69 Publi │ │ │ │ │ +000393f0: 6320 4d61 6372 6f73 2e20 2020 2020 2020 c Macros. │ │ │ │ │ +00039400: 286c 696e 6520 3130 3429 0a2a 2047 434a (line 104).* GCJ │ │ │ │ │ +00039410: 464c 4147 5320 3c31 3e3a 2020 2020 2020 FLAGS <1>: │ │ │ │ │ 00039420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039430: 2020 204a 6176 6120 5375 7070 6f72 7420 Java Support │ │ │ │ │ -00039440: 7769 7468 2067 636a 2e0a 2020 2020 2020 with gcj.. │ │ │ │ │ +00039430: 2020 2020 4a61 7661 2053 7570 706f 7274 Java Support │ │ │ │ │ +00039440: 2077 6974 6820 6763 6a2e 0a20 2020 2020 with gcj.. │ │ │ │ │ 00039450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039470: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039480: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -00039490: 3629 0a2a 2047 434a 4c49 4e4b 3a20 2020 6).* GCJLINK: │ │ │ │ │ +00039480: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00039490: 3136 290a 2a20 4743 4a4c 494e 4b3a 2020 16).* GCJLINK: │ │ │ │ │ 000394a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000394b0: 2020 2020 2020 2020 2020 2020 486f 7720 How │ │ │ │ │ -000394c0: 7468 6520 4c69 6e6b 6572 2069 7320 4368 the Linker is Ch │ │ │ │ │ -000394d0: 6f73 656e 2e0a 2020 2020 2020 2020 2020 osen.. │ │ │ │ │ +000394b0: 2020 2020 2020 2020 2020 2020 2048 6f77 How │ │ │ │ │ +000394c0: 2074 6865 204c 696e 6b65 7220 6973 2043 the Linker is C │ │ │ │ │ +000394d0: 686f 7365 6e2e 0a20 2020 2020 2020 2020 hosen.. │ │ │ │ │ 000394e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000394f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039510: 2020 2020 286c 696e 6520 2031 3029 0a2a (line 10).* │ │ │ │ │ -00039520: 2047 5441 4753 5f41 5247 533a 2020 2020 GTAGS_ARGS: │ │ │ │ │ +00039510: 2020 2020 2028 6c69 6e65 2020 3130 290a (line 10). │ │ │ │ │ +00039520: 2a20 4754 4147 535f 4152 4753 3a20 2020 * GTAGS_ARGS: │ │ │ │ │ 00039530: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039540: 2020 2020 2020 2020 5461 6773 2e20 2020 Tags. │ │ │ │ │ -00039550: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00039560: 6e65 2020 3439 290a 2a20 475a 4950 5f45 ne 49).* GZIP_E │ │ │ │ │ -00039570: 4e56 3a20 2020 2020 2020 2020 2020 2020 NV: │ │ │ │ │ +00039540: 2020 2020 2020 2020 2054 6167 732e 2020 Tags. │ │ │ │ │ +00039550: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00039560: 696e 6520 2034 3929 0a2a 2047 5a49 505f ine 49).* GZIP_ │ │ │ │ │ +00039570: 454e 563a 2020 2020 2020 2020 2020 2020 ENV: │ │ │ │ │ 00039580: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039590: 2042 6173 6963 7320 6f66 2044 6973 7472 Basics of Distr │ │ │ │ │ -000395a0: 6962 7574 696f 6e2e 0a20 2020 2020 2020 ibution.. │ │ │ │ │ +00039590: 2020 4261 7369 6373 206f 6620 4469 7374 Basics of Dist │ │ │ │ │ +000395a0: 7269 6275 7469 6f6e 2e0a 2020 2020 2020 ribution.. │ │ │ │ │ 000395b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000395c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000395d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000395e0: 2020 2020 2020 2028 6c69 6e65 2020 3130 (line 10 │ │ │ │ │ -000395f0: 290a 2a20 4845 4144 4552 533a 2020 2020 ).* HEADERS: │ │ │ │ │ +000395e0: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +000395f0: 3029 0a2a 2048 4541 4445 5253 3a20 2020 0).* HEADERS: │ │ │ │ │ 00039600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039610: 2020 2020 2020 2020 2020 2055 6e69 666f Unifo │ │ │ │ │ -00039620: 726d 2e20 2020 2020 2020 2020 2020 2020 rm. │ │ │ │ │ -00039630: 286c 696e 6520 3130 3229 0a2a 2068 6f73 (line 102).* hos │ │ │ │ │ -00039640: 745f 7472 6970 6c65 743a 2020 2020 2020 t_triplet: │ │ │ │ │ +00039610: 2020 2020 2020 2020 2020 2020 556e 6966 Unif │ │ │ │ │ +00039620: 6f72 6d2e 2020 2020 2020 2020 2020 2020 orm. │ │ │ │ │ +00039630: 2028 6c69 6e65 2031 3032 290a 2a20 686f (line 102).* ho │ │ │ │ │ +00039640: 7374 5f74 7269 706c 6574 3a20 2020 2020 st_triplet: │ │ │ │ │ 00039650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039660: 2020 2020 4f70 7469 6f6e 616c 2e20 2020 Optional. │ │ │ │ │ -00039670: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00039680: 3134 290a 2a20 494e 434c 5544 4553 3a20 14).* INCLUDES: │ │ │ │ │ +00039660: 2020 2020 204f 7074 696f 6e61 6c2e 2020 Optional. │ │ │ │ │ +00039670: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00039680: 2031 3429 0a2a 2049 4e43 4c55 4445 533a 14).* INCLUDES: │ │ │ │ │ 00039690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000396a0: 2020 2020 2020 2020 2020 2020 2050 726f Pro │ │ │ │ │ -000396b0: 6772 616d 2056 6172 6961 626c 6573 2e20 gram Variables. │ │ │ │ │ -000396c0: 2020 286c 696e 6520 2034 3529 0a2a 2069 (line 45).* i │ │ │ │ │ -000396d0: 6e63 6c75 6465 5f48 4541 4445 5253 3a20 nclude_HEADERS: │ │ │ │ │ +000396a0: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ +000396b0: 6f67 7261 6d20 5661 7269 6162 6c65 732e ogram Variables. │ │ │ │ │ +000396c0: 2020 2028 6c69 6e65 2020 3435 290a 2a20 (line 45).* │ │ │ │ │ +000396d0: 696e 636c 7564 655f 4845 4144 4552 533a include_HEADERS: │ │ │ │ │ 000396e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000396f0: 2020 2020 2020 4865 6164 6572 732e 2020 Headers. │ │ │ │ │ -00039700: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00039710: 2020 2036 290a 2a20 696e 666f 5f54 4558 6).* info_TEX │ │ │ │ │ -00039720: 494e 464f 533a 2020 2020 2020 2020 2020 INFOS: │ │ │ │ │ -00039730: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -00039740: 6578 696e 666f 2e20 2020 2020 2020 2020 exinfo. │ │ │ │ │ -00039750: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00039760: 204a 4156 413a 2020 2020 2020 2020 2020 JAVA: │ │ │ │ │ +000396f0: 2020 2020 2020 2048 6561 6465 7273 2e20 Headers. │ │ │ │ │ +00039700: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00039710: 6520 2020 3629 0a2a 2069 6e66 6f5f 5445 e 6).* info_TE │ │ │ │ │ +00039720: 5849 4e46 4f53 3a20 2020 2020 2020 2020 XINFOS: │ │ │ │ │ +00039730: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00039740: 5465 7869 6e66 6f2e 2020 2020 2020 2020 Texinfo. │ │ │ │ │ +00039750: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00039760: 2a20 4a41 5641 3a20 2020 2020 2020 2020 * JAVA: │ │ │ │ │ 00039770: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039780: 2020 2020 2020 2020 556e 6966 6f72 6d2e Uniform. │ │ │ │ │ -00039790: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000397a0: 6e65 2031 3032 290a 2a20 4a41 5641 433a ne 102).* JAVAC: │ │ │ │ │ -000397b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00039780: 2020 2020 2020 2020 2055 6e69 666f 726d Uniform │ │ │ │ │ +00039790: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +000397a0: 696e 6520 3130 3229 0a2a 204a 4156 4143 ine 102).* JAVAC │ │ │ │ │ +000397b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 000397c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000397d0: 204a 6176 612e 2020 2020 2020 2020 2020 Java. │ │ │ │ │ -000397e0: 2020 2020 2020 286c 696e 6520 2033 3529 (line 35) │ │ │ │ │ -000397f0: 0a2a 204a 4156 4143 464c 4147 533a 2020 .* JAVACFLAGS: │ │ │ │ │ +000397d0: 2020 4a61 7661 2e20 2020 2020 2020 2020 Java. │ │ │ │ │ +000397e0: 2020 2020 2020 2028 6c69 6e65 2020 3335 (line 35 │ │ │ │ │ +000397f0: 290a 2a20 4a41 5641 4346 4c41 4753 3a20 ).* JAVACFLAGS: │ │ │ │ │ 00039800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039810: 2020 2020 2020 2020 2020 4a61 7661 2e20 Java. │ │ │ │ │ -00039820: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00039830: 6c69 6e65 2020 3338 290a 2a20 4a41 5641 line 38).* JAVA │ │ │ │ │ -00039840: 524f 4f54 3a20 2020 2020 2020 2020 2020 ROOT: │ │ │ │ │ +00039810: 2020 2020 2020 2020 2020 204a 6176 612e Java. │ │ │ │ │ +00039820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00039830: 286c 696e 6520 2033 3829 0a2a 204a 4156 (line 38).* JAV │ │ │ │ │ +00039840: 4152 4f4f 543a 2020 2020 2020 2020 2020 AROOT: │ │ │ │ │ 00039850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039860: 2020 204a 6176 612e 2020 2020 2020 2020 Java. │ │ │ │ │ -00039870: 2020 2020 2020 2020 286c 696e 6520 2034 (line 4 │ │ │ │ │ -00039880: 3729 0a2a 204c 4441 4444 3a20 2020 2020 7).* LDADD: │ │ │ │ │ +00039860: 2020 2020 4a61 7661 2e20 2020 2020 2020 Java. │ │ │ │ │ +00039870: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00039880: 3437 290a 2a20 4c44 4144 443a 2020 2020 47).* LDADD: │ │ │ │ │ 00039890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000398a0: 2020 2020 2020 2020 2020 2020 4c69 6e6b Link │ │ │ │ │ -000398b0: 696e 672e 2020 2020 2020 2020 2020 2020 ing. │ │ │ │ │ -000398c0: 2028 6c69 6e65 2020 3130 290a 2a20 4c44 (line 10).* LD │ │ │ │ │ -000398d0: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ +000398a0: 2020 2020 2020 2020 2020 2020 204c 696e Lin │ │ │ │ │ +000398b0: 6b69 6e67 2e20 2020 2020 2020 2020 2020 king. │ │ │ │ │ +000398c0: 2020 286c 696e 6520 2031 3029 0a2a 204c (line 10).* L │ │ │ │ │ +000398d0: 4446 4c41 4753 3a20 2020 2020 2020 2020 DFLAGS: │ │ │ │ │ 000398e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000398f0: 2020 2020 2050 726f 6772 616d 2056 6172 Program Var │ │ │ │ │ -00039900: 6961 626c 6573 2e20 2020 286c 696e 6520 iables. (line │ │ │ │ │ -00039910: 2031 3229 0a2a 204c 464c 4147 533a 2020 12).* LFLAGS: │ │ │ │ │ +000398f0: 2020 2020 2020 5072 6f67 7261 6d20 5661 Program Va │ │ │ │ │ +00039900: 7269 6162 6c65 732e 2020 2028 6c69 6e65 riables. (line │ │ │ │ │ +00039910: 2020 3132 290a 2a20 4c46 4c41 4753 3a20 12).* LFLAGS: │ │ │ │ │ 00039920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039930: 2020 2020 2020 2020 2020 2020 2020 5961 Ya │ │ │ │ │ -00039940: 6363 2061 6e64 204c 6578 2e20 2020 2020 cc and Lex. │ │ │ │ │ -00039950: 2020 2028 6c69 6e65 2020 3536 290a 2a20 (line 56).* │ │ │ │ │ -00039960: 6c69 6265 7865 635f 5052 4f47 5241 4d53 libexec_PROGRAMS │ │ │ │ │ -00039970: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00039980: 2020 2020 2020 2050 726f 6772 616d 2053 Program S │ │ │ │ │ -00039990: 6f75 7263 6573 2e20 2020 2020 286c 696e ources. (lin │ │ │ │ │ -000399a0: 6520 2020 3629 0a2a 206c 6962 6578 6563 e 6).* libexec │ │ │ │ │ -000399b0: 5f53 4352 4950 5453 3a20 2020 2020 2020 _SCRIPTS: │ │ │ │ │ +00039930: 2020 2020 2020 2020 2020 2020 2020 2059 Y │ │ │ │ │ +00039940: 6163 6320 616e 6420 4c65 782e 2020 2020 acc and Lex. │ │ │ │ │ +00039950: 2020 2020 286c 696e 6520 2035 3629 0a2a (line 56).* │ │ │ │ │ +00039960: 206c 6962 6578 6563 5f50 524f 4752 414d libexec_PROGRAM │ │ │ │ │ +00039970: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +00039980: 2020 2020 2020 2020 5072 6f67 7261 6d20 Program │ │ │ │ │ +00039990: 536f 7572 6365 732e 2020 2020 2028 6c69 Sources. (li │ │ │ │ │ +000399a0: 6e65 2020 2036 290a 2a20 6c69 6265 7865 ne 6).* libexe │ │ │ │ │ +000399b0: 635f 5343 5249 5054 533a 2020 2020 2020 c_SCRIPTS: │ │ │ │ │ 000399c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000399d0: 5363 7269 7074 732e 2020 2020 2020 2020 Scripts. │ │ │ │ │ -000399e0: 2020 2020 2028 6c69 6e65 2020 3138 290a (line 18). │ │ │ │ │ -000399f0: 2a20 4c49 424f 424a 533a 2020 2020 2020 * LIBOBJS: │ │ │ │ │ +000399d0: 2053 6372 6970 7473 2e20 2020 2020 2020 Scripts. │ │ │ │ │ +000399e0: 2020 2020 2020 286c 696e 6520 2031 3829 (line 18) │ │ │ │ │ +000399f0: 0a2a 204c 4942 4f42 4a53 3a20 2020 2020 .* LIBOBJS: │ │ │ │ │ 00039a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039a10: 2020 2020 2020 2020 204f 7074 696f 6e61 Optiona │ │ │ │ │ -00039a20: 6c2e 2020 2020 2020 2020 2020 2020 286c l. (l │ │ │ │ │ -00039a30: 696e 6520 2036 3629 0a2a 204c 4942 4f42 ine 66).* LIBOB │ │ │ │ │ -00039a40: 4a53 203c 313e 3a20 2020 2020 2020 2020 JS <1>: │ │ │ │ │ +00039a10: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +00039a20: 616c 2e20 2020 2020 2020 2020 2020 2028 al. ( │ │ │ │ │ +00039a30: 6c69 6e65 2020 3636 290a 2a20 4c49 424f line 66).* LIBO │ │ │ │ │ +00039a40: 424a 5320 3c31 3e3a 2020 2020 2020 2020 BJS <1>: │ │ │ │ │ 00039a50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039a60: 2020 4c54 4c49 424f 424a 532e 2020 2020 LTLIBOBJS. │ │ │ │ │ -00039a70: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00039a80: 290a 2a20 4c49 424f 424a 5320 3c32 3e3a ).* LIBOBJS <2>: │ │ │ │ │ -00039a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039aa0: 2020 2020 2020 2020 2020 204c 4942 4f42 LIBOB │ │ │ │ │ -00039ab0: 4a53 2e20 2020 2020 2020 2020 2020 2020 JS. │ │ │ │ │ -00039ac0: 286c 696e 6520 2020 3629 0a2a 204c 4942 (line 6).* LIB │ │ │ │ │ -00039ad0: 5241 5249 4553 3a20 2020 2020 2020 2020 RARIES: │ │ │ │ │ +00039a60: 2020 204c 544c 4942 4f42 4a53 2e20 2020 LTLIBOBJS. │ │ │ │ │ +00039a70: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00039a80: 3629 0a2a 204c 4942 4f42 4a53 203c 323e 6).* LIBOBJS <2> │ │ │ │ │ +00039a90: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00039aa0: 2020 2020 2020 2020 2020 2020 4c49 424f LIBO │ │ │ │ │ +00039ab0: 424a 532e 2020 2020 2020 2020 2020 2020 BJS. │ │ │ │ │ +00039ac0: 2028 6c69 6e65 2020 2036 290a 2a20 4c49 (line 6).* LI │ │ │ │ │ +00039ad0: 4252 4152 4945 533a 2020 2020 2020 2020 BRARIES: │ │ │ │ │ 00039ae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039af0: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ -00039b00: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ -00039b10: 3032 290a 2a20 4c49 4253 3a20 2020 2020 02).* LIBS: │ │ │ │ │ +00039af0: 2020 2020 2055 6e69 666f 726d 2e20 2020 Uniform. │ │ │ │ │ +00039b00: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00039b10: 3130 3229 0a2a 204c 4942 533a 2020 2020 102).* LIBS: │ │ │ │ │ 00039b20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039b30: 2020 2020 2020 2020 2020 2020 2050 726f Pro │ │ │ │ │ -00039b40: 6772 616d 2056 6172 6961 626c 6573 2e20 gram Variables. │ │ │ │ │ -00039b50: 2020 286c 696e 6520 2031 3229 0a2a 204c (line 12).* L │ │ │ │ │ -00039b60: 4942 544f 4f4c 464c 4147 533a 2020 2020 IBTOOLFLAGS: │ │ │ │ │ +00039b30: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ +00039b40: 6f67 7261 6d20 5661 7269 6162 6c65 732e ogram Variables. │ │ │ │ │ +00039b50: 2020 2028 6c69 6e65 2020 3132 290a 2a20 (line 12).* │ │ │ │ │ +00039b60: 4c49 4254 4f4f 4c46 4c41 4753 3a20 2020 LIBTOOLFLAGS: │ │ │ │ │ 00039b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039b80: 2020 2020 2020 4c69 6274 6f6f 6c20 466c Libtool Fl │ │ │ │ │ -00039b90: 6167 732e 2020 2020 2020 2028 6c69 6e65 ags. (line │ │ │ │ │ -00039ba0: 2020 2036 290a 2a20 6c69 625f 4c49 4252 6).* lib_LIBR │ │ │ │ │ -00039bb0: 4152 4945 533a 2020 2020 2020 2020 2020 ARIES: │ │ │ │ │ -00039bc0: 2020 2020 2020 2020 2020 2020 2020 2041 A │ │ │ │ │ -00039bd0: 204c 6962 7261 7279 2e20 2020 2020 2020 Library. │ │ │ │ │ -00039be0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00039bf0: 206c 6962 5f4c 544c 4942 5241 5249 4553 lib_LTLIBRARIES │ │ │ │ │ -00039c00: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00039c10: 2020 2020 2020 2020 4c69 6274 6f6f 6c20 Libtool │ │ │ │ │ -00039c20: 4c69 6272 6172 6965 732e 2020 2028 6c69 Libraries. (li │ │ │ │ │ -00039c30: 6e65 2020 2036 290a 2a20 4c49 4e4b 3a20 ne 6).* LINK: │ │ │ │ │ +00039b80: 2020 2020 2020 204c 6962 746f 6f6c 2046 Libtool F │ │ │ │ │ +00039b90: 6c61 6773 2e20 2020 2020 2020 286c 696e lags. (lin │ │ │ │ │ +00039ba0: 6520 2020 3629 0a2a 206c 6962 5f4c 4942 e 6).* lib_LIB │ │ │ │ │ +00039bb0: 5241 5249 4553 3a20 2020 2020 2020 2020 RARIES: │ │ │ │ │ +00039bc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00039bd0: 4120 4c69 6272 6172 792e 2020 2020 2020 A Library. │ │ │ │ │ +00039be0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00039bf0: 2a20 6c69 625f 4c54 4c49 4252 4152 4945 * lib_LTLIBRARIE │ │ │ │ │ +00039c00: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +00039c10: 2020 2020 2020 2020 204c 6962 746f 6f6c Libtool │ │ │ │ │ +00039c20: 204c 6962 7261 7269 6573 2e20 2020 286c Libraries. (l │ │ │ │ │ +00039c30: 696e 6520 2020 3629 0a2a 204c 494e 4b3a ine 6).* LINK: │ │ │ │ │ 00039c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039c50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039c60: 2050 726f 6772 616d 2056 6172 6961 626c Program Variabl │ │ │ │ │ -00039c70: 6573 2e20 2020 286c 696e 6520 2036 3629 es. (line 66) │ │ │ │ │ -00039c80: 0a2a 204c 494e 4b20 3c31 3e3a 2020 2020 .* LINK <1>: │ │ │ │ │ +00039c60: 2020 5072 6f67 7261 6d20 5661 7269 6162 Program Variab │ │ │ │ │ +00039c70: 6c65 732e 2020 2028 6c69 6e65 2020 3636 les. (line 66 │ │ │ │ │ +00039c80: 290a 2a20 4c49 4e4b 203c 313e 3a20 2020 ).* LINK <1>: │ │ │ │ │ 00039c90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039ca0: 2020 2020 2020 2020 2020 486f 7720 7468 How th │ │ │ │ │ -00039cb0: 6520 4c69 6e6b 6572 2069 7320 4368 6f73 e Linker is Chos │ │ │ │ │ -00039cc0: 656e 2e0a 2020 2020 2020 2020 2020 2020 en.. │ │ │ │ │ +00039ca0: 2020 2020 2020 2020 2020 2048 6f77 2074 How t │ │ │ │ │ +00039cb0: 6865 204c 696e 6b65 7220 6973 2043 686f he Linker is Cho │ │ │ │ │ +00039cc0: 7365 6e2e 0a20 2020 2020 2020 2020 2020 sen.. │ │ │ │ │ 00039cd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039ce0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039d00: 2020 286c 696e 6520 2031 3629 0a2a 204c (line 16).* L │ │ │ │ │ -00039d10: 4953 503a 2020 2020 2020 2020 2020 2020 ISP: │ │ │ │ │ +00039d00: 2020 2028 6c69 6e65 2020 3136 290a 2a20 (line 16).* │ │ │ │ │ +00039d10: 4c49 5350 3a20 2020 2020 2020 2020 2020 LISP: │ │ │ │ │ 00039d20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039d30: 2020 2020 2020 556e 6966 6f72 6d2e 2020 Uniform. │ │ │ │ │ -00039d40: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00039d50: 2031 3032 290a 2a20 6c69 7370 6469 723a 102).* lispdir: │ │ │ │ │ -00039d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039d70: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -00039d80: 7562 6c69 6320 4d61 6372 6f73 2e20 2020 ublic Macros. │ │ │ │ │ -00039d90: 2020 2020 286c 696e 6520 2036 3629 0a2a (line 66).* │ │ │ │ │ -00039da0: 206c 6973 705f 4c49 5350 3a20 2020 2020 lisp_LISP: │ │ │ │ │ +00039d30: 2020 2020 2020 2055 6e69 666f 726d 2e20 Uniform. │ │ │ │ │ +00039d40: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00039d50: 6520 3130 3229 0a2a 206c 6973 7064 6972 e 102).* lispdir │ │ │ │ │ +00039d60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00039d70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00039d80: 5075 626c 6963 204d 6163 726f 732e 2020 Public Macros. │ │ │ │ │ +00039d90: 2020 2020 2028 6c69 6e65 2020 3636 290a (line 66). │ │ │ │ │ +00039da0: 2a20 6c69 7370 5f4c 4953 503a 2020 2020 * lisp_LISP: │ │ │ │ │ 00039db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039dc0: 2020 2020 2020 2020 456d 6163 7320 4c69 Emacs Li │ │ │ │ │ -00039dd0: 7370 2e20 2020 2020 2020 2020 2028 6c69 sp. (li │ │ │ │ │ -00039de0: 6e65 2020 2036 290a 2a20 6c6f 6361 6c73 ne 6).* locals │ │ │ │ │ -00039df0: 7461 7465 5f44 4154 413a 2020 2020 2020 tate_DATA: │ │ │ │ │ +00039dc0: 2020 2020 2020 2020 2045 6d61 6373 204c Emacs L │ │ │ │ │ +00039dd0: 6973 702e 2020 2020 2020 2020 2020 286c isp. (l │ │ │ │ │ +00039de0: 696e 6520 2020 3629 0a2a 206c 6f63 616c ine 6).* local │ │ │ │ │ +00039df0: 7374 6174 655f 4441 5441 3a20 2020 2020 state_DATA: │ │ │ │ │ 00039e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039e10: 2044 6174 612e 2020 2020 2020 2020 2020 Data. │ │ │ │ │ -00039e20: 2020 2020 2020 286c 696e 6520 2020 3929 (line 9) │ │ │ │ │ -00039e30: 0a2a 204c 4f47 5f43 4f4d 5049 4c45 3a20 .* LOG_COMPILE: │ │ │ │ │ +00039e10: 2020 4461 7461 2e20 2020 2020 2020 2020 Data. │ │ │ │ │ +00039e20: 2020 2020 2020 2028 6c69 6e65 2020 2039 (line 9 │ │ │ │ │ +00039e30: 290a 2a20 4c4f 475f 434f 4d50 494c 453a ).* LOG_COMPILE: │ │ │ │ │ 00039e40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039e50: 2020 2020 2020 2020 2020 5369 6d70 6c65 Simple │ │ │ │ │ -00039e60: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ -00039e70: 616c 6c65 6c2d 7465 7374 732e 0a20 2020 allel-tests.. │ │ │ │ │ +00039e50: 2020 2020 2020 2020 2020 2053 696d 706c Simpl │ │ │ │ │ +00039e60: 6520 5465 7374 7320 7573 696e 6720 7061 e Tests using pa │ │ │ │ │ +00039e70: 7261 6c6c 656c 2d74 6573 7473 2e0a 2020 rallel-tests.. │ │ │ │ │ 00039e80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039eb0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00039ec0: 2020 3339 290a 2a20 4c4f 475f 434f 4d50 39).* LOG_COMP │ │ │ │ │ -00039ed0: 494c 4552 3a20 2020 2020 2020 2020 2020 ILER: │ │ │ │ │ -00039ee0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -00039ef0: 696d 706c 6520 5465 7374 7320 7573 696e imple Tests usin │ │ │ │ │ -00039f00: 6720 7061 7261 6c6c 656c 2d74 6573 7473 g parallel-tests │ │ │ │ │ -00039f10: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00039eb0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00039ec0: 6520 2033 3929 0a2a 204c 4f47 5f43 4f4d e 39).* LOG_COM │ │ │ │ │ +00039ed0: 5049 4c45 523a 2020 2020 2020 2020 2020 PILER: │ │ │ │ │ +00039ee0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00039ef0: 5369 6d70 6c65 2054 6573 7473 2075 7369 Simple Tests usi │ │ │ │ │ +00039f00: 6e67 2070 6172 616c 6c65 6c2d 7465 7374 ng parallel-test │ │ │ │ │ +00039f10: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ 00039f20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039f30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039f50: 286c 696e 6520 2033 3929 0a2a 204c 4f47 (line 39).* LOG │ │ │ │ │ -00039f60: 5f46 4c41 4753 3a20 2020 2020 2020 2020 _FLAGS: │ │ │ │ │ +00039f50: 2028 6c69 6e65 2020 3339 290a 2a20 4c4f (line 39).* LO │ │ │ │ │ +00039f60: 475f 464c 4147 533a 2020 2020 2020 2020 G_FLAGS: │ │ │ │ │ 00039f70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039f80: 2020 2020 5369 6d70 6c65 2054 6573 7473 Simple Tests │ │ │ │ │ -00039f90: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ -00039fa0: 7465 7374 732e 0a20 2020 2020 2020 2020 tests.. │ │ │ │ │ +00039f80: 2020 2020 2053 696d 706c 6520 5465 7374 Simple Test │ │ │ │ │ +00039f90: 7320 7573 696e 6720 7061 7261 6c6c 656c s using parallel │ │ │ │ │ +00039fa0: 2d74 6573 7473 2e0a 2020 2020 2020 2020 -tests.. │ │ │ │ │ 00039fb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039fc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00039fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00039fe0: 2020 2020 2028 6c69 6e65 2020 3339 290a (line 39). │ │ │ │ │ -00039ff0: 2a20 4c54 414c 4c4f 4341 3a20 2020 2020 * LTALLOCA: │ │ │ │ │ +00039fe0: 2020 2020 2020 286c 696e 6520 2033 3929 (line 39) │ │ │ │ │ +00039ff0: 0a2a 204c 5441 4c4c 4f43 413a 2020 2020 .* LTALLOCA: │ │ │ │ │ 0003a000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a010: 2020 2020 2020 2020 204c 544c 4942 4f42 LTLIBOB │ │ │ │ │ -0003a020: 4a53 2e20 2020 2020 2020 2020 2020 286c JS. (l │ │ │ │ │ -0003a030: 696e 6520 2020 3629 0a2a 204c 5441 4c4c ine 6).* LTALL │ │ │ │ │ -0003a040: 4f43 4120 3c31 3e3a 2020 2020 2020 2020 OCA <1>: │ │ │ │ │ +0003a010: 2020 2020 2020 2020 2020 4c54 4c49 424f LTLIBO │ │ │ │ │ +0003a020: 424a 532e 2020 2020 2020 2020 2020 2028 BJS. ( │ │ │ │ │ +0003a030: 6c69 6e65 2020 2036 290a 2a20 4c54 414c line 6).* LTAL │ │ │ │ │ +0003a040: 4c4f 4341 203c 313e 3a20 2020 2020 2020 LOCA <1>: │ │ │ │ │ 0003a050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a060: 2020 4c49 424f 424a 532e 2020 2020 2020 LIBOBJS. │ │ │ │ │ -0003a070: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -0003a080: 290a 2a20 4c54 4c49 424f 424a 533a 2020 ).* LTLIBOBJS: │ │ │ │ │ +0003a060: 2020 204c 4942 4f42 4a53 2e20 2020 2020 LIBOBJS. │ │ │ │ │ +0003a070: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +0003a080: 3629 0a2a 204c 544c 4942 4f42 4a53 3a20 6).* LTLIBOBJS: │ │ │ │ │ 0003a090: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a0a0: 2020 2020 2020 2020 2020 204c 544c 4942 LTLIB │ │ │ │ │ -0003a0b0: 4f42 4a53 2e20 2020 2020 2020 2020 2020 OBJS. │ │ │ │ │ -0003a0c0: 286c 696e 6520 2020 3629 0a2a 204c 544c (line 6).* LTL │ │ │ │ │ -0003a0d0: 4942 4f42 4a53 203c 313e 3a20 2020 2020 IBOBJS <1>: │ │ │ │ │ +0003a0a0: 2020 2020 2020 2020 2020 2020 4c54 4c49 LTLI │ │ │ │ │ +0003a0b0: 424f 424a 532e 2020 2020 2020 2020 2020 BOBJS. │ │ │ │ │ +0003a0c0: 2028 6c69 6e65 2020 2036 290a 2a20 4c54 (line 6).* LT │ │ │ │ │ +0003a0d0: 4c49 424f 424a 5320 3c31 3e3a 2020 2020 LIBOBJS <1>: │ │ │ │ │ 0003a0e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a0f0: 2020 2020 4c49 424f 424a 532e 2020 2020 LIBOBJS. │ │ │ │ │ -0003a100: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003a110: 2036 290a 2a20 4c54 4c49 4252 4152 4945 6).* LTLIBRARIE │ │ │ │ │ -0003a120: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -0003a130: 2020 2020 2020 2020 2020 2020 2055 6e69 Uni │ │ │ │ │ -0003a140: 666f 726d 2e20 2020 2020 2020 2020 2020 form. │ │ │ │ │ -0003a150: 2020 286c 696e 6520 3130 3229 0a2a 204d (line 102).* M │ │ │ │ │ -0003a160: 4149 4e54 4149 4e45 5243 4c45 414e 4649 AINTAINERCLEANFI │ │ │ │ │ -0003a170: 4c45 533a 2020 2020 2020 2020 2020 2020 LES: │ │ │ │ │ -0003a180: 2020 2020 2020 436c 6561 6e2e 2020 2020 Clean. │ │ │ │ │ -0003a190: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003a1a0: 2020 3133 290a 2a20 4d41 4b45 3a20 2020 13).* MAKE: │ │ │ │ │ +0003a0f0: 2020 2020 204c 4942 4f42 4a53 2e20 2020 LIBOBJS. │ │ │ │ │ +0003a100: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003a110: 2020 3629 0a2a 204c 544c 4942 5241 5249 6).* LTLIBRARI │ │ │ │ │ +0003a120: 4553 3a20 2020 2020 2020 2020 2020 2020 ES: │ │ │ │ │ +0003a130: 2020 2020 2020 2020 2020 2020 2020 556e Un │ │ │ │ │ +0003a140: 6966 6f72 6d2e 2020 2020 2020 2020 2020 iform. │ │ │ │ │ +0003a150: 2020 2028 6c69 6e65 2031 3032 290a 2a20 (line 102).* │ │ │ │ │ +0003a160: 4d41 494e 5441 494e 4552 434c 4541 4e46 MAINTAINERCLEANF │ │ │ │ │ +0003a170: 494c 4553 3a20 2020 2020 2020 2020 2020 ILES: │ │ │ │ │ +0003a180: 2020 2020 2020 2043 6c65 616e 2e20 2020 Clean. │ │ │ │ │ +0003a190: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003a1a0: 6520 2031 3329 0a2a 204d 414b 453a 2020 e 13).* MAKE: │ │ │ │ │ 0003a1b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a1c0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -0003a1d0: 7562 6469 7265 6374 6f72 6965 732e 2020 ubdirectories. │ │ │ │ │ -0003a1e0: 2020 2020 286c 696e 6520 2032 3929 0a2a (line 29).* │ │ │ │ │ -0003a1f0: 204d 414b 4549 4e46 4f3a 2020 2020 2020 MAKEINFO: │ │ │ │ │ +0003a1c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003a1d0: 5375 6264 6972 6563 746f 7269 6573 2e20 Subdirectories. │ │ │ │ │ +0003a1e0: 2020 2020 2028 6c69 6e65 2020 3239 290a (line 29). │ │ │ │ │ +0003a1f0: 2a20 4d41 4b45 494e 464f 3a20 2020 2020 * MAKEINFO: │ │ │ │ │ 0003a200: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a210: 2020 2020 2020 2020 5465 7869 6e66 6f2e Texinfo. │ │ │ │ │ -0003a220: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003a230: 6e65 2020 3933 290a 2a20 4d41 4b45 494e ne 93).* MAKEIN │ │ │ │ │ -0003a240: 464f 464c 4147 533a 2020 2020 2020 2020 FOFLAGS: │ │ │ │ │ +0003a210: 2020 2020 2020 2020 2054 6578 696e 666f Texinfo │ │ │ │ │ +0003a220: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0003a230: 696e 6520 2039 3329 0a2a 204d 414b 4549 ine 93).* MAKEI │ │ │ │ │ +0003a240: 4e46 4f46 4c41 4753 3a20 2020 2020 2020 NFOFLAGS: │ │ │ │ │ 0003a250: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a260: 2054 6578 696e 666f 2e20 2020 2020 2020 Texinfo. │ │ │ │ │ -0003a270: 2020 2020 2020 286c 696e 6520 3130 3329 (line 103) │ │ │ │ │ -0003a280: 0a2a 204d 414b 4549 4e46 4f48 544d 4c3a .* MAKEINFOHTML: │ │ │ │ │ -0003a290: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a2a0: 2020 2020 2020 2020 2020 5465 7869 6e66 Texinf │ │ │ │ │ -0003a2b0: 6f2e 2020 2020 2020 2020 2020 2020 2028 o. ( │ │ │ │ │ -0003a2c0: 6c69 6e65 2020 3939 290a 2a20 4d41 4e53 line 99).* MANS │ │ │ │ │ -0003a2d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003a260: 2020 5465 7869 6e66 6f2e 2020 2020 2020 Texinfo. │ │ │ │ │ +0003a270: 2020 2020 2020 2028 6c69 6e65 2031 3033 (line 103 │ │ │ │ │ +0003a280: 290a 2a20 4d41 4b45 494e 464f 4854 4d4c ).* MAKEINFOHTML │ │ │ │ │ +0003a290: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003a2a0: 2020 2020 2020 2020 2020 2054 6578 696e Texin │ │ │ │ │ +0003a2b0: 666f 2e20 2020 2020 2020 2020 2020 2020 fo. │ │ │ │ │ +0003a2c0: 286c 696e 6520 2039 3929 0a2a 204d 414e (line 99).* MAN │ │ │ │ │ +0003a2d0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ 0003a2e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a2f0: 2020 2055 6e69 666f 726d 2e20 2020 2020 Uniform. │ │ │ │ │ -0003a300: 2020 2020 2020 2020 286c 696e 6520 3130 (line 10 │ │ │ │ │ -0003a310: 3229 0a2a 206d 616e 5f4d 414e 533a 2020 2).* man_MANS: │ │ │ │ │ +0003a2f0: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ +0003a300: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +0003a310: 3032 290a 2a20 6d61 6e5f 4d41 4e53 3a20 02).* man_MANS: │ │ │ │ │ 0003a320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a330: 2020 2020 2020 2020 2020 2020 4d61 6e20 Man │ │ │ │ │ -0003a340: 5061 6765 732e 2020 2020 2020 2020 2020 Pages. │ │ │ │ │ -0003a350: 2028 6c69 6e65 2020 2036 290a 2a20 6d61 (line 6).* ma │ │ │ │ │ -0003a360: 7564 655f 4152 3a20 2020 2020 2020 2020 ude_AR: │ │ │ │ │ +0003a330: 2020 2020 2020 2020 2020 2020 204d 616e Man │ │ │ │ │ +0003a340: 2050 6167 6573 2e20 2020 2020 2020 2020 Pages. │ │ │ │ │ +0003a350: 2020 286c 696e 6520 2020 3629 0a2a 206d (line 6).* m │ │ │ │ │ +0003a360: 6175 6465 5f41 523a 2020 2020 2020 2020 aude_AR: │ │ │ │ │ 0003a370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a380: 2020 2020 2050 726f 6772 616d 2061 6e64 Program and │ │ │ │ │ -0003a390: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ -0003a3a0: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ +0003a380: 2020 2020 2020 5072 6f67 7261 6d20 616e Program an │ │ │ │ │ +0003a390: 6420 4c69 6272 6172 7920 5661 7269 6162 d Library Variab │ │ │ │ │ +0003a3a0: 6c65 732e 0a20 2020 2020 2020 2020 2020 les.. │ │ │ │ │ 0003a3b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a3c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a3d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a3e0: 2020 286c 696e 6520 2036 3829 0a2a 206d (line 68).* m │ │ │ │ │ -0003a3f0: 6175 6465 5f43 4341 5346 4c41 4753 3a20 aude_CCASFLAGS: │ │ │ │ │ +0003a3e0: 2020 2028 6c69 6e65 2020 3638 290a 2a20 (line 68).* │ │ │ │ │ +0003a3f0: 6d61 7564 655f 4343 4153 464c 4147 533a maude_CCASFLAGS: │ │ │ │ │ 0003a400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a410: 2020 2020 2020 5072 6f67 7261 6d20 616e Program an │ │ │ │ │ -0003a420: 6420 4c69 6272 6172 7920 5661 7269 6162 d Library Variab │ │ │ │ │ -0003a430: 6c65 732e 0a20 2020 2020 2020 2020 2020 les.. │ │ │ │ │ +0003a410: 2020 2020 2020 2050 726f 6772 616d 2061 Program a │ │ │ │ │ +0003a420: 6e64 204c 6962 7261 7279 2056 6172 6961 nd Library Varia │ │ │ │ │ +0003a430: 626c 6573 2e0a 2020 2020 2020 2020 2020 bles.. │ │ │ │ │ 0003a440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a470: 2020 2028 6c69 6e65 2031 3730 290a 2a20 (line 170).* │ │ │ │ │ -0003a480: 6d61 7564 655f 4346 4c41 4753 3a20 2020 maude_CFLAGS: │ │ │ │ │ +0003a470: 2020 2020 286c 696e 6520 3137 3029 0a2a (line 170).* │ │ │ │ │ +0003a480: 206d 6175 6465 5f43 464c 4147 533a 2020 maude_CFLAGS: │ │ │ │ │ 0003a490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a4a0: 2020 2020 2020 2050 726f 6772 616d 2061 Program a │ │ │ │ │ -0003a4b0: 6e64 204c 6962 7261 7279 2056 6172 6961 nd Library Varia │ │ │ │ │ -0003a4c0: 626c 6573 2e0a 2020 2020 2020 2020 2020 bles.. │ │ │ │ │ +0003a4a0: 2020 2020 2020 2020 5072 6f67 7261 6d20 Program │ │ │ │ │ +0003a4b0: 616e 6420 4c69 6272 6172 7920 5661 7269 and Library Vari │ │ │ │ │ +0003a4c0: 6162 6c65 732e 0a20 2020 2020 2020 2020 ables.. │ │ │ │ │ 0003a4d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a4e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a4f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a500: 2020 2020 286c 696e 6520 3137 3129 0a2a (line 171).* │ │ │ │ │ -0003a510: 206d 6175 6465 5f43 5050 464c 4147 533a maude_CPPFLAGS: │ │ │ │ │ -0003a520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a530: 2020 2020 2020 2020 5072 6f67 7261 6d20 Program │ │ │ │ │ -0003a540: 616e 6420 4c69 6272 6172 7920 5661 7269 and Library Vari │ │ │ │ │ -0003a550: 6162 6c65 732e 0a20 2020 2020 2020 2020 ables.. │ │ │ │ │ +0003a500: 2020 2020 2028 6c69 6e65 2031 3731 290a (line 171). │ │ │ │ │ +0003a510: 2a20 6d61 7564 655f 4350 5046 4c41 4753 * maude_CPPFLAGS │ │ │ │ │ +0003a520: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003a530: 2020 2020 2020 2020 2050 726f 6772 616d Program │ │ │ │ │ +0003a540: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ +0003a550: 6961 626c 6573 2e0a 2020 2020 2020 2020 iables.. │ │ │ │ │ 0003a560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a580: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a590: 2020 2020 2028 6c69 6e65 2031 3732 290a (line 172). │ │ │ │ │ -0003a5a0: 2a20 6d61 7564 655f 4358 5846 4c41 4753 * maude_CXXFLAGS │ │ │ │ │ -0003a5b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003a5c0: 2020 2020 2020 2020 2050 726f 6772 616d Program │ │ │ │ │ -0003a5d0: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ -0003a5e0: 6961 626c 6573 2e0a 2020 2020 2020 2020 iables.. │ │ │ │ │ +0003a590: 2020 2020 2020 286c 696e 6520 3137 3229 (line 172) │ │ │ │ │ +0003a5a0: 0a2a 206d 6175 6465 5f43 5858 464c 4147 .* maude_CXXFLAG │ │ │ │ │ +0003a5b0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +0003a5c0: 2020 2020 2020 2020 2020 5072 6f67 7261 Progra │ │ │ │ │ +0003a5d0: 6d20 616e 6420 4c69 6272 6172 7920 5661 m and Library Va │ │ │ │ │ +0003a5e0: 7269 6162 6c65 732e 0a20 2020 2020 2020 riables.. │ │ │ │ │ 0003a5f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a620: 2020 2020 2020 286c 696e 6520 3137 3329 (line 173) │ │ │ │ │ -0003a630: 0a2a 206d 6175 6465 5f44 4550 454e 4445 .* maude_DEPENDE │ │ │ │ │ -0003a640: 4e43 4945 533a 2020 2020 2020 2020 2020 NCIES: │ │ │ │ │ -0003a650: 2020 2020 2020 2020 2020 4c69 6e6b 696e Linkin │ │ │ │ │ -0003a660: 672e 2020 2020 2020 2020 2020 2020 2028 g. ( │ │ │ │ │ -0003a670: 6c69 6e65 2020 3431 290a 2a20 6d61 7564 line 41).* maud │ │ │ │ │ -0003a680: 655f 4445 5045 4e44 454e 4349 4553 203c e_DEPENDENCIES < │ │ │ │ │ -0003a690: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ -0003a6a0: 2020 2050 726f 6772 616d 2061 6e64 204c Program and L │ │ │ │ │ -0003a6b0: 6962 7261 7279 2056 6172 6961 626c 6573 ibrary Variables │ │ │ │ │ -0003a6c0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +0003a620: 2020 2020 2020 2028 6c69 6e65 2031 3733 (line 173 │ │ │ │ │ +0003a630: 290a 2a20 6d61 7564 655f 4445 5045 4e44 ).* maude_DEPEND │ │ │ │ │ +0003a640: 454e 4349 4553 3a20 2020 2020 2020 2020 ENCIES: │ │ │ │ │ +0003a650: 2020 2020 2020 2020 2020 204c 696e 6b69 Linki │ │ │ │ │ +0003a660: 6e67 2e20 2020 2020 2020 2020 2020 2020 ng. │ │ │ │ │ +0003a670: 286c 696e 6520 2034 3129 0a2a 206d 6175 (line 41).* mau │ │ │ │ │ +0003a680: 6465 5f44 4550 454e 4445 4e43 4945 5320 de_DEPENDENCIES │ │ │ │ │ +0003a690: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +0003a6a0: 2020 2020 5072 6f67 7261 6d20 616e 6420 Program and │ │ │ │ │ +0003a6b0: 4c69 6272 6172 7920 5661 7269 6162 6c65 Library Variable │ │ │ │ │ +0003a6c0: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ 0003a6d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a6e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a6f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a700: 286c 696e 6520 3131 3829 0a2a 206d 6175 (line 118).* mau │ │ │ │ │ -0003a710: 6465 5f46 464c 4147 533a 2020 2020 2020 de_FFLAGS: │ │ │ │ │ +0003a700: 2028 6c69 6e65 2031 3138 290a 2a20 6d61 (line 118).* ma │ │ │ │ │ +0003a710: 7564 655f 4646 4c41 4753 3a20 2020 2020 ude_FFLAGS: │ │ │ │ │ 0003a720: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a730: 2020 2020 5072 6f67 7261 6d20 616e 6420 Program and │ │ │ │ │ -0003a740: 4c69 6272 6172 7920 5661 7269 6162 6c65 Library Variable │ │ │ │ │ -0003a750: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ +0003a730: 2020 2020 2050 726f 6772 616d 2061 6e64 Program and │ │ │ │ │ +0003a740: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ +0003a750: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ 0003a760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a770: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a790: 2028 6c69 6e65 2031 3734 290a 2a20 6d61 (line 174).* ma │ │ │ │ │ -0003a7a0: 7564 655f 4743 4a46 4c41 4753 3a20 2020 ude_GCJFLAGS: │ │ │ │ │ +0003a790: 2020 286c 696e 6520 3137 3429 0a2a 206d (line 174).* m │ │ │ │ │ +0003a7a0: 6175 6465 5f47 434a 464c 4147 533a 2020 aude_GCJFLAGS: │ │ │ │ │ 0003a7b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a7c0: 2020 2020 2050 726f 6772 616d 2061 6e64 Program and │ │ │ │ │ -0003a7d0: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ -0003a7e0: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ +0003a7c0: 2020 2020 2020 5072 6f67 7261 6d20 616e Program an │ │ │ │ │ +0003a7d0: 6420 4c69 6272 6172 7920 5661 7269 6162 d Library Variab │ │ │ │ │ +0003a7e0: 6c65 732e 0a20 2020 2020 2020 2020 2020 les.. │ │ │ │ │ 0003a7f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a820: 2020 286c 696e 6520 3137 3529 0a2a 206d (line 175).* m │ │ │ │ │ -0003a830: 6175 6465 5f4c 4441 4444 3a20 2020 2020 aude_LDADD: │ │ │ │ │ +0003a820: 2020 2028 6c69 6e65 2031 3735 290a 2a20 (line 175).* │ │ │ │ │ +0003a830: 6d61 7564 655f 4c44 4144 443a 2020 2020 maude_LDADD: │ │ │ │ │ 0003a840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a850: 2020 2020 2020 4c69 6e6b 696e 672e 2020 Linking. │ │ │ │ │ -0003a860: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003a870: 2020 3137 290a 2a20 6d61 7564 655f 4c44 17).* maude_LD │ │ │ │ │ -0003a880: 4144 4420 3c31 3e3a 2020 2020 2020 2020 ADD <1>: │ │ │ │ │ -0003a890: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -0003a8a0: 726f 6772 616d 2061 6e64 204c 6962 7261 rogram and Libra │ │ │ │ │ -0003a8b0: 7279 2056 6172 6961 626c 6573 2e0a 2020 ry Variables.. │ │ │ │ │ +0003a850: 2020 2020 2020 204c 696e 6b69 6e67 2e20 Linking. │ │ │ │ │ +0003a860: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003a870: 6520 2031 3729 0a2a 206d 6175 6465 5f4c e 17).* maude_L │ │ │ │ │ +0003a880: 4441 4444 203c 313e 3a20 2020 2020 2020 DADD <1>: │ │ │ │ │ +0003a890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003a8a0: 5072 6f67 7261 6d20 616e 6420 4c69 6272 Program and Libr │ │ │ │ │ +0003a8b0: 6172 7920 5661 7269 6162 6c65 732e 0a20 ary Variables.. │ │ │ │ │ 0003a8c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a8d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a8e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a8f0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0003a900: 6520 2038 3629 0a2a 206d 6175 6465 5f4c e 86).* maude_L │ │ │ │ │ -0003a910: 4446 4c41 4753 3a20 2020 2020 2020 2020 DFLAGS: │ │ │ │ │ +0003a8f0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0003a900: 6e65 2020 3836 290a 2a20 6d61 7564 655f ne 86).* maude_ │ │ │ │ │ +0003a910: 4c44 464c 4147 533a 2020 2020 2020 2020 LDFLAGS: │ │ │ │ │ 0003a920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a930: 4c69 6e6b 696e 672e 2020 2020 2020 2020 Linking. │ │ │ │ │ -0003a940: 2020 2020 2028 6c69 6e65 2020 3337 290a (line 37). │ │ │ │ │ -0003a950: 2a20 6d61 7564 655f 4c44 464c 4147 5320 * maude_LDFLAGS │ │ │ │ │ -0003a960: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ -0003a970: 2020 2020 2020 2020 2050 726f 6772 616d Program │ │ │ │ │ -0003a980: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ -0003a990: 6961 626c 6573 2e0a 2020 2020 2020 2020 iables.. │ │ │ │ │ +0003a930: 204c 696e 6b69 6e67 2e20 2020 2020 2020 Linking. │ │ │ │ │ +0003a940: 2020 2020 2020 286c 696e 6520 2033 3729 (line 37) │ │ │ │ │ +0003a950: 0a2a 206d 6175 6465 5f4c 4446 4c41 4753 .* maude_LDFLAGS │ │ │ │ │ +0003a960: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +0003a970: 2020 2020 2020 2020 2020 5072 6f67 7261 Progra │ │ │ │ │ +0003a980: 6d20 616e 6420 4c69 6272 6172 7920 5661 m and Library Va │ │ │ │ │ +0003a990: 7269 6162 6c65 732e 0a20 2020 2020 2020 riables.. │ │ │ │ │ 0003a9a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a9b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003a9c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003a9d0: 2020 2020 2020 286c 696e 6520 3130 3629 (line 106) │ │ │ │ │ -0003a9e0: 0a2a 206d 6175 6465 5f4c 464c 4147 533a .* maude_LFLAGS: │ │ │ │ │ -0003a9f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003aa00: 2020 2020 2020 2020 2020 5072 6f67 7261 Progra │ │ │ │ │ -0003aa10: 6d20 616e 6420 4c69 6272 6172 7920 5661 m and Library Va │ │ │ │ │ -0003aa20: 7269 6162 6c65 732e 0a20 2020 2020 2020 riables.. │ │ │ │ │ +0003a9d0: 2020 2020 2020 2028 6c69 6e65 2031 3036 (line 106 │ │ │ │ │ +0003a9e0: 290a 2a20 6d61 7564 655f 4c46 4c41 4753 ).* maude_LFLAGS │ │ │ │ │ +0003a9f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003aa00: 2020 2020 2020 2020 2020 2050 726f 6772 Progr │ │ │ │ │ +0003aa10: 616d 2061 6e64 204c 6962 7261 7279 2056 am and Library V │ │ │ │ │ +0003aa20: 6172 6961 626c 6573 2e0a 2020 2020 2020 ariables.. │ │ │ │ │ 0003aa30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003aa40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003aa50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003aa60: 2020 2020 2020 2028 6c69 6e65 2031 3736 (line 176 │ │ │ │ │ -0003aa70: 290a 2a20 6d61 7564 655f 4c49 4241 4444 ).* maude_LIBADD │ │ │ │ │ -0003aa80: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003aa90: 2020 2020 2020 2020 2020 2041 204c 6962 A Lib │ │ │ │ │ -0003aaa0: 7261 7279 2e20 2020 2020 2020 2020 2020 rary. │ │ │ │ │ -0003aab0: 286c 696e 6520 2032 3629 0a2a 206d 6175 (line 26).* mau │ │ │ │ │ -0003aac0: 6465 5f4c 4942 4144 4420 3c31 3e3a 2020 de_LIBADD <1>: │ │ │ │ │ +0003aa60: 2020 2020 2020 2020 286c 696e 6520 3137 (line 17 │ │ │ │ │ +0003aa70: 3629 0a2a 206d 6175 6465 5f4c 4942 4144 6).* maude_LIBAD │ │ │ │ │ +0003aa80: 443a 2020 2020 2020 2020 2020 2020 2020 D: │ │ │ │ │ +0003aa90: 2020 2020 2020 2020 2020 2020 4120 4c69 A Li │ │ │ │ │ +0003aaa0: 6272 6172 792e 2020 2020 2020 2020 2020 brary. │ │ │ │ │ +0003aab0: 2028 6c69 6e65 2020 3236 290a 2a20 6d61 (line 26).* ma │ │ │ │ │ +0003aac0: 7564 655f 4c49 4241 4444 203c 313e 3a20 ude_LIBADD <1>: │ │ │ │ │ 0003aad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003aae0: 2020 2020 5072 6f67 7261 6d20 616e 6420 Program and │ │ │ │ │ -0003aaf0: 4c69 6272 6172 7920 5661 7269 6162 6c65 Library Variable │ │ │ │ │ -0003ab00: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ +0003aae0: 2020 2020 2050 726f 6772 616d 2061 6e64 Program and │ │ │ │ │ +0003aaf0: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ +0003ab00: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ 0003ab10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ab20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ab30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ab40: 2028 6c69 6e65 2020 3738 290a 2a20 6d61 (line 78).* ma │ │ │ │ │ -0003ab50: 7564 655f 4c49 4254 4f4f 4c46 4c41 4753 ude_LIBTOOLFLAGS │ │ │ │ │ -0003ab60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003ab70: 2020 2020 204c 6962 746f 6f6c 2046 6c61 Libtool Fla │ │ │ │ │ -0003ab80: 6773 2e20 2020 2020 2020 286c 696e 6520 gs. (line │ │ │ │ │ -0003ab90: 2020 3629 0a2a 206d 6175 6465 5f4c 4942 6).* maude_LIB │ │ │ │ │ -0003aba0: 544f 4f4c 464c 4147 5320 3c31 3e3a 2020 TOOLFLAGS <1>: │ │ │ │ │ -0003abb0: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ -0003abc0: 6f67 7261 6d20 616e 6420 4c69 6272 6172 ogram and Librar │ │ │ │ │ -0003abd0: 7920 5661 7269 6162 6c65 732e 0a20 2020 y Variables.. │ │ │ │ │ +0003ab40: 2020 286c 696e 6520 2037 3829 0a2a 206d (line 78).* m │ │ │ │ │ +0003ab50: 6175 6465 5f4c 4942 544f 4f4c 464c 4147 aude_LIBTOOLFLAG │ │ │ │ │ +0003ab60: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +0003ab70: 2020 2020 2020 4c69 6274 6f6f 6c20 466c Libtool Fl │ │ │ │ │ +0003ab80: 6167 732e 2020 2020 2020 2028 6c69 6e65 ags. (line │ │ │ │ │ +0003ab90: 2020 2036 290a 2a20 6d61 7564 655f 4c49 6).* maude_LI │ │ │ │ │ +0003aba0: 4254 4f4f 4c46 4c41 4753 203c 313e 3a20 BTOOLFLAGS <1>: │ │ │ │ │ +0003abb0: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +0003abc0: 726f 6772 616d 2061 6e64 204c 6962 7261 rogram and Libra │ │ │ │ │ +0003abd0: 7279 2056 6172 6961 626c 6573 2e0a 2020 ry Variables.. │ │ │ │ │ 0003abe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003abf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ac00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ac10: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003ac20: 2031 3131 290a 2a20 6d61 7564 655f 4c49 111).* maude_LI │ │ │ │ │ -0003ac30: 4e4b 3a20 2020 2020 2020 2020 2020 2020 NK: │ │ │ │ │ -0003ac40: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -0003ac50: 726f 6772 616d 2061 6e64 204c 6962 7261 rogram and Libra │ │ │ │ │ -0003ac60: 7279 2056 6172 6961 626c 6573 2e0a 2020 ry Variables.. │ │ │ │ │ +0003ac10: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003ac20: 6520 3131 3129 0a2a 206d 6175 6465 5f4c e 111).* maude_L │ │ │ │ │ +0003ac30: 494e 4b3a 2020 2020 2020 2020 2020 2020 INK: │ │ │ │ │ +0003ac40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003ac50: 5072 6f67 7261 6d20 616e 6420 4c69 6272 Program and Libr │ │ │ │ │ +0003ac60: 6172 7920 5661 7269 6162 6c65 732e 0a20 ary Variables.. │ │ │ │ │ 0003ac70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ac80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ac90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003aca0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0003acb0: 6520 3135 3429 0a2a 206d 6175 6465 5f4f e 154).* maude_O │ │ │ │ │ -0003acc0: 424a 4346 4c41 4753 3a20 2020 2020 2020 BJCFLAGS: │ │ │ │ │ +0003aca0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0003acb0: 6e65 2031 3534 290a 2a20 6d61 7564 655f ne 154).* maude_ │ │ │ │ │ +0003acc0: 4f42 4a43 464c 4147 533a 2020 2020 2020 OBJCFLAGS: │ │ │ │ │ 0003acd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ace0: 5072 6f67 7261 6d20 616e 6420 4c69 6272 Program and Libr │ │ │ │ │ -0003acf0: 6172 7920 5661 7269 6162 6c65 732e 0a20 ary Variables.. │ │ │ │ │ +0003ace0: 2050 726f 6772 616d 2061 6e64 204c 6962 Program and Lib │ │ │ │ │ +0003acf0: 7261 7279 2056 6172 6961 626c 6573 2e0a rary Variables.. │ │ │ │ │ 0003ad00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ad10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ad20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ad30: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003ad40: 6e65 2031 3737 290a 2a20 6d61 7564 655f ne 177).* maude_ │ │ │ │ │ -0003ad50: 5246 4c41 4753 3a20 2020 2020 2020 2020 RFLAGS: │ │ │ │ │ +0003ad30: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0003ad40: 696e 6520 3137 3729 0a2a 206d 6175 6465 ine 177).* maude │ │ │ │ │ +0003ad50: 5f52 464c 4147 533a 2020 2020 2020 2020 _RFLAGS: │ │ │ │ │ 0003ad60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ad70: 2050 726f 6772 616d 2061 6e64 204c 6962 Program and Lib │ │ │ │ │ -0003ad80: 7261 7279 2056 6172 6961 626c 6573 2e0a rary Variables.. │ │ │ │ │ -0003ad90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003ad70: 2020 5072 6f67 7261 6d20 616e 6420 4c69 Program and Li │ │ │ │ │ +0003ad80: 6272 6172 7920 5661 7269 6162 6c65 732e brary Variables. │ │ │ │ │ +0003ad90: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 0003ada0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003adb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003adc0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -0003add0: 696e 6520 3137 3829 0a2a 206d 6175 6465 ine 178).* maude │ │ │ │ │ -0003ade0: 5f53 484f 5254 4e41 4d45 3a20 2020 2020 _SHORTNAME: │ │ │ │ │ +0003adc0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +0003add0: 6c69 6e65 2031 3738 290a 2a20 6d61 7564 line 178).* maud │ │ │ │ │ +0003ade0: 655f 5348 4f52 544e 414d 453a 2020 2020 e_SHORTNAME: │ │ │ │ │ 0003adf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ae00: 2020 5072 6f67 7261 6d20 616e 6420 4c69 Program and Li │ │ │ │ │ -0003ae10: 6272 6172 7920 5661 7269 6162 6c65 732e brary Variables. │ │ │ │ │ -0003ae20: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003ae00: 2020 2050 726f 6772 616d 2061 6e64 204c Program and L │ │ │ │ │ +0003ae10: 6962 7261 7279 2056 6172 6961 626c 6573 ibrary Variables │ │ │ │ │ +0003ae20: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 0003ae30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ae40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ae50: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0003ae60: 6c69 6e65 2032 3131 290a 2a20 6d61 7564 line 211).* maud │ │ │ │ │ -0003ae70: 655f 534f 5552 4345 533a 2020 2020 2020 e_SOURCES: │ │ │ │ │ +0003ae50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003ae60: 286c 696e 6520 3231 3129 0a2a 206d 6175 (line 211).* mau │ │ │ │ │ +0003ae70: 6465 5f53 4f55 5243 4553 3a20 2020 2020 de_SOURCES: │ │ │ │ │ 0003ae80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ae90: 2020 2050 726f 6772 616d 2061 6e64 204c Program and L │ │ │ │ │ -0003aea0: 6962 7261 7279 2056 6172 6961 626c 6573 ibrary Variables │ │ │ │ │ -0003aeb0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +0003ae90: 2020 2020 5072 6f67 7261 6d20 616e 6420 Program and │ │ │ │ │ +0003aea0: 4c69 6272 6172 7920 5661 7269 6162 6c65 Library Variable │ │ │ │ │ +0003aeb0: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ 0003aec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003aed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003aee0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003aef0: 286c 696e 6520 2031 3829 0a2a 206d 6175 (line 18).* mau │ │ │ │ │ -0003af00: 6465 5f55 5043 464c 4147 533a 2020 2020 de_UPCFLAGS: │ │ │ │ │ +0003aef0: 2028 6c69 6e65 2020 3138 290a 2a20 6d61 (line 18).* ma │ │ │ │ │ +0003af00: 7564 655f 5550 4346 4c41 4753 3a20 2020 ude_UPCFLAGS: │ │ │ │ │ 0003af10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003af20: 2020 2020 5072 6f67 7261 6d20 616e 6420 Program and │ │ │ │ │ -0003af30: 4c69 6272 6172 7920 5661 7269 6162 6c65 Library Variable │ │ │ │ │ -0003af40: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ +0003af20: 2020 2020 2050 726f 6772 616d 2061 6e64 Program and │ │ │ │ │ +0003af30: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ +0003af40: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ 0003af50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003af60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003af70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003af80: 2028 6c69 6e65 2031 3739 290a 2a20 6d61 (line 179).* ma │ │ │ │ │ -0003af90: 7564 655f 5946 4c41 4753 3a20 2020 2020 ude_YFLAGS: │ │ │ │ │ +0003af80: 2020 286c 696e 6520 3137 3929 0a2a 206d (line 179).* m │ │ │ │ │ +0003af90: 6175 6465 5f59 464c 4147 533a 2020 2020 aude_YFLAGS: │ │ │ │ │ 0003afa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003afb0: 2020 2020 2050 726f 6772 616d 2061 6e64 Program and │ │ │ │ │ -0003afc0: 204c 6962 7261 7279 2056 6172 6961 626c Library Variabl │ │ │ │ │ -0003afd0: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ +0003afb0: 2020 2020 2020 5072 6f67 7261 6d20 616e Program an │ │ │ │ │ +0003afc0: 6420 4c69 6272 6172 7920 5661 7269 6162 d Library Variab │ │ │ │ │ +0003afd0: 6c65 732e 0a20 2020 2020 2020 2020 2020 les.. │ │ │ │ │ 0003afe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003aff0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b010: 2020 286c 696e 6520 3138 3029 0a2a 204d (line 180).* M │ │ │ │ │ -0003b020: 4b44 4952 5f50 3a20 2020 2020 2020 2020 KDIR_P: │ │ │ │ │ +0003b010: 2020 2028 6c69 6e65 2031 3830 290a 2a20 (line 180).* │ │ │ │ │ +0003b020: 4d4b 4449 525f 503a 2020 2020 2020 2020 MKDIR_P: │ │ │ │ │ 0003b030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b040: 2020 2020 2020 4f62 736f 6c65 7465 204d Obsolete M │ │ │ │ │ -0003b050: 6163 726f 732e 2020 2020 2028 6c69 6e65 acros. (line │ │ │ │ │ -0003b060: 2020 3334 290a 2a20 6d6b 6469 725f 703a 34).* mkdir_p: │ │ │ │ │ -0003b070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b080: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ -0003b090: 6273 6f6c 6574 6520 4d61 6372 6f73 2e20 bsolete Macros. │ │ │ │ │ -0003b0a0: 2020 2020 286c 696e 6520 2033 3429 0a2a (line 34).* │ │ │ │ │ -0003b0b0: 204d 4f53 544c 5943 4c45 414e 4649 4c45 MOSTLYCLEANFILE │ │ │ │ │ -0003b0c0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -0003b0d0: 2020 2020 2020 2020 436c 6561 6e2e 2020 Clean. │ │ │ │ │ -0003b0e0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003b0f0: 6e65 2020 3133 290a 2a20 6e6f 6261 7365 ne 13).* nobase │ │ │ │ │ -0003b100: 5f3a 2020 2020 2020 2020 2020 2020 2020 _: │ │ │ │ │ +0003b040: 2020 2020 2020 204f 6273 6f6c 6574 6520 Obsolete │ │ │ │ │ +0003b050: 4d61 6372 6f73 2e20 2020 2020 286c 696e Macros. (lin │ │ │ │ │ +0003b060: 6520 2033 3429 0a2a 206d 6b64 6972 5f70 e 34).* mkdir_p │ │ │ │ │ +0003b070: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003b080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003b090: 4f62 736f 6c65 7465 204d 6163 726f 732e Obsolete Macros. │ │ │ │ │ +0003b0a0: 2020 2020 2028 6c69 6e65 2020 3334 290a (line 34). │ │ │ │ │ +0003b0b0: 2a20 4d4f 5354 4c59 434c 4541 4e46 494c * MOSTLYCLEANFIL │ │ │ │ │ +0003b0c0: 4553 3a20 2020 2020 2020 2020 2020 2020 ES: │ │ │ │ │ +0003b0d0: 2020 2020 2020 2020 2043 6c65 616e 2e20 Clean. │ │ │ │ │ +0003b0e0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0003b0f0: 696e 6520 2031 3329 0a2a 206e 6f62 6173 ine 13).* nobas │ │ │ │ │ +0003b100: 655f 3a20 2020 2020 2020 2020 2020 2020 e_: │ │ │ │ │ 0003b110: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b120: 2041 6c74 6572 6e61 7469 7665 2e20 2020 Alternative. │ │ │ │ │ -0003b130: 2020 2020 2020 286c 696e 6520 2032 3329 (line 23) │ │ │ │ │ -0003b140: 0a2a 206e 6f64 6973 745f 3a20 2020 2020 .* nodist_: │ │ │ │ │ +0003b120: 2020 416c 7465 726e 6174 6976 652e 2020 Alternative. │ │ │ │ │ +0003b130: 2020 2020 2020 2028 6c69 6e65 2020 3233 (line 23 │ │ │ │ │ +0003b140: 290a 2a20 6e6f 6469 7374 5f3a 2020 2020 ).* nodist_: │ │ │ │ │ 0003b150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b160: 2020 2020 2020 2020 2020 416c 7465 726e Altern │ │ │ │ │ -0003b170: 6174 6976 652e 2020 2020 2020 2020 2028 ative. ( │ │ │ │ │ -0003b180: 6c69 6e65 2020 3239 290a 2a20 6e6f 6469 line 29).* nodi │ │ │ │ │ -0003b190: 7374 5f20 3c31 3e3a 2020 2020 2020 2020 st_ <1>: │ │ │ │ │ +0003b160: 2020 2020 2020 2020 2020 2041 6c74 6572 Alter │ │ │ │ │ +0003b170: 6e61 7469 7665 2e20 2020 2020 2020 2020 native. │ │ │ │ │ +0003b180: 286c 696e 6520 2032 3929 0a2a 206e 6f64 (line 29).* nod │ │ │ │ │ +0003b190: 6973 745f 203c 313e 3a20 2020 2020 2020 ist_ <1>: │ │ │ │ │ 0003b1a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b1b0: 2020 2046 696e 652d 6772 6169 6e65 6420 Fine-grained │ │ │ │ │ -0003b1c0: 4469 7374 7269 6275 7469 6f6e 2043 6f6e Distribution Con │ │ │ │ │ -0003b1d0: 7472 6f6c 2e0a 2020 2020 2020 2020 2020 trol.. │ │ │ │ │ +0003b1b0: 2020 2020 4669 6e65 2d67 7261 696e 6564 Fine-grained │ │ │ │ │ +0003b1c0: 2044 6973 7472 6962 7574 696f 6e20 436f Distribution Co │ │ │ │ │ +0003b1d0: 6e74 726f 6c2e 0a20 2020 2020 2020 2020 ntrol.. │ │ │ │ │ 0003b1e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b1f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b200: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b210: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0003b220: 206e 6f69 6e73 745f 3a20 2020 2020 2020 noinst_: │ │ │ │ │ +0003b210: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0003b220: 2a20 6e6f 696e 7374 5f3a 2020 2020 2020 * noinst_: │ │ │ │ │ 0003b230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b240: 2020 2020 2020 2020 556e 6966 6f72 6d2e Uniform. │ │ │ │ │ -0003b250: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003b260: 6e65 2020 3931 290a 2a20 6e6f 696e 7374 ne 91).* noinst │ │ │ │ │ -0003b270: 5f48 4541 4445 5253 3a20 2020 2020 2020 _HEADERS: │ │ │ │ │ +0003b240: 2020 2020 2020 2020 2055 6e69 666f 726d Uniform │ │ │ │ │ +0003b250: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0003b260: 696e 6520 2039 3129 0a2a 206e 6f69 6e73 ine 91).* noins │ │ │ │ │ +0003b270: 745f 4845 4144 4552 533a 2020 2020 2020 t_HEADERS: │ │ │ │ │ 0003b280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b290: 2048 6561 6465 7273 2e20 2020 2020 2020 Headers. │ │ │ │ │ -0003b2a0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0003b2b0: 0a2a 206e 6f69 6e73 745f 4845 4144 4552 .* noinst_HEADER │ │ │ │ │ -0003b2c0: 5320 3c31 3e3a 2020 2020 2020 2020 2020 S <1>: │ │ │ │ │ -0003b2d0: 2020 2020 2020 2020 2020 4865 6164 6572 Header │ │ │ │ │ -0003b2e0: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -0003b2f0: 6c69 6e65 2020 3233 290a 2a20 6e6f 696e line 23).* noin │ │ │ │ │ -0003b300: 7374 5f4c 4942 5241 5249 4553 3a20 2020 st_LIBRARIES: │ │ │ │ │ +0003b290: 2020 4865 6164 6572 732e 2020 2020 2020 Headers. │ │ │ │ │ +0003b2a0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0003b2b0: 290a 2a20 6e6f 696e 7374 5f48 4541 4445 ).* noinst_HEADE │ │ │ │ │ +0003b2c0: 5253 203c 313e 3a20 2020 2020 2020 2020 RS <1>: │ │ │ │ │ +0003b2d0: 2020 2020 2020 2020 2020 2048 6561 6465 Heade │ │ │ │ │ +0003b2e0: 7273 2e20 2020 2020 2020 2020 2020 2020 rs. │ │ │ │ │ +0003b2f0: 286c 696e 6520 2032 3329 0a2a 206e 6f69 (line 23).* noi │ │ │ │ │ +0003b300: 6e73 745f 4c49 4252 4152 4945 533a 2020 nst_LIBRARIES: │ │ │ │ │ 0003b310: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b320: 2020 2041 204c 6962 7261 7279 2e20 2020 A Library. │ │ │ │ │ -0003b330: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ -0003b340: 3629 0a2a 206e 6f69 6e73 745f 4c49 5350 6).* noinst_LISP │ │ │ │ │ -0003b350: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003b360: 2020 2020 2020 2020 2020 2020 456d 6163 Emac │ │ │ │ │ -0003b370: 7320 4c69 7370 2e20 2020 2020 2020 2020 s Lisp. │ │ │ │ │ -0003b380: 2028 6c69 6e65 2020 2036 290a 2a20 6e6f (line 6).* no │ │ │ │ │ -0003b390: 696e 7374 5f4c 544c 4942 5241 5249 4553 inst_LTLIBRARIES │ │ │ │ │ -0003b3a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003b3b0: 2020 2020 204c 6962 746f 6f6c 2043 6f6e Libtool Con │ │ │ │ │ -0003b3c0: 7665 6e69 656e 6365 204c 6962 7261 7269 venience Librari │ │ │ │ │ -0003b3d0: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ +0003b320: 2020 2020 4120 4c69 6272 6172 792e 2020 A Library. │ │ │ │ │ +0003b330: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0003b340: 2036 290a 2a20 6e6f 696e 7374 5f4c 4953 6).* noinst_LIS │ │ │ │ │ +0003b350: 503a 2020 2020 2020 2020 2020 2020 2020 P: │ │ │ │ │ +0003b360: 2020 2020 2020 2020 2020 2020 2045 6d61 Ema │ │ │ │ │ +0003b370: 6373 204c 6973 702e 2020 2020 2020 2020 cs Lisp. │ │ │ │ │ +0003b380: 2020 286c 696e 6520 2020 3629 0a2a 206e (line 6).* n │ │ │ │ │ +0003b390: 6f69 6e73 745f 4c54 4c49 4252 4152 4945 oinst_LTLIBRARIE │ │ │ │ │ +0003b3a0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +0003b3b0: 2020 2020 2020 4c69 6274 6f6f 6c20 436f Libtool Co │ │ │ │ │ +0003b3c0: 6e76 656e 6965 6e63 6520 4c69 6272 6172 nvenience Librar │ │ │ │ │ +0003b3d0: 6965 732e 0a20 2020 2020 2020 2020 2020 ies.. │ │ │ │ │ 0003b3e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b3f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b410: 2020 286c 696e 6520 2020 3629 0a2a 206e (line 6).* n │ │ │ │ │ -0003b420: 6f69 6e73 745f 5052 4f47 5241 4d53 3a20 oinst_PROGRAMS: │ │ │ │ │ +0003b410: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +0003b420: 6e6f 696e 7374 5f50 524f 4752 414d 533a noinst_PROGRAMS: │ │ │ │ │ 0003b430: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b440: 2020 2020 2020 5072 6f67 7261 6d20 536f Program So │ │ │ │ │ -0003b450: 7572 6365 732e 2020 2020 2028 6c69 6e65 urces. (line │ │ │ │ │ -0003b460: 2020 2036 290a 2a20 6e6f 696e 7374 5f53 6).* noinst_S │ │ │ │ │ -0003b470: 4352 4950 5453 3a20 2020 2020 2020 2020 CRIPTS: │ │ │ │ │ -0003b480: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -0003b490: 6372 6970 7473 2e20 2020 2020 2020 2020 cripts. │ │ │ │ │ -0003b4a0: 2020 2020 286c 696e 6520 2031 3829 0a2a (line 18).* │ │ │ │ │ -0003b4b0: 206e 6f74 7261 6e73 5f3a 2020 2020 2020 notrans_: │ │ │ │ │ +0003b440: 2020 2020 2020 2050 726f 6772 616d 2053 Program S │ │ │ │ │ +0003b450: 6f75 7263 6573 2e20 2020 2020 286c 696e ources. (lin │ │ │ │ │ +0003b460: 6520 2020 3629 0a2a 206e 6f69 6e73 745f e 6).* noinst_ │ │ │ │ │ +0003b470: 5343 5249 5054 533a 2020 2020 2020 2020 SCRIPTS: │ │ │ │ │ +0003b480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003b490: 5363 7269 7074 732e 2020 2020 2020 2020 Scripts. │ │ │ │ │ +0003b4a0: 2020 2020 2028 6c69 6e65 2020 3138 290a (line 18). │ │ │ │ │ +0003b4b0: 2a20 6e6f 7472 616e 735f 3a20 2020 2020 * notrans_: │ │ │ │ │ 0003b4c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b4d0: 2020 2020 2020 2020 4d61 6e20 5061 6765 Man Page │ │ │ │ │ -0003b4e0: 732e 2020 2020 2020 2020 2020 2028 6c69 s. (li │ │ │ │ │ -0003b4f0: 6e65 2020 3534 290a 2a20 4f42 4a43 3a20 ne 54).* OBJC: │ │ │ │ │ +0003b4d0: 2020 2020 2020 2020 204d 616e 2050 6167 Man Pag │ │ │ │ │ +0003b4e0: 6573 2e20 2020 2020 2020 2020 2020 286c es. (l │ │ │ │ │ +0003b4f0: 696e 6520 2035 3429 0a2a 204f 424a 433a ine 54).* OBJC: │ │ │ │ │ 0003b500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b510: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b520: 204f 626a 6563 7469 7665 2043 2053 7570 Objective C Sup │ │ │ │ │ -0003b530: 706f 7274 2e20 286c 696e 6520 2031 3629 port. (line 16) │ │ │ │ │ -0003b540: 0a2a 204f 424a 4343 4f4d 5049 4c45 3a20 .* OBJCCOMPILE: │ │ │ │ │ +0003b520: 2020 4f62 6a65 6374 6976 6520 4320 5375 Objective C Su │ │ │ │ │ +0003b530: 7070 6f72 742e 2028 6c69 6e65 2020 3136 pport. (line 16 │ │ │ │ │ +0003b540: 290a 2a20 4f42 4a43 434f 4d50 494c 453a ).* OBJCCOMPILE: │ │ │ │ │ 0003b550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b560: 2020 2020 2020 2020 2020 4f62 6a65 6374 Object │ │ │ │ │ -0003b570: 6976 6520 4320 5375 7070 6f72 742e 2028 ive C Support. ( │ │ │ │ │ -0003b580: 6c69 6e65 2020 3235 290a 2a20 4f42 4a43 line 25).* OBJC │ │ │ │ │ -0003b590: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ +0003b560: 2020 2020 2020 2020 2020 204f 626a 6563 Objec │ │ │ │ │ +0003b570: 7469 7665 2043 2053 7570 706f 7274 2e20 tive C Support. │ │ │ │ │ +0003b580: 286c 696e 6520 2032 3529 0a2a 204f 424a (line 25).* OBJ │ │ │ │ │ +0003b590: 4346 4c41 4753 3a20 2020 2020 2020 2020 CFLAGS: │ │ │ │ │ 0003b5a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b5b0: 2020 204f 626a 6563 7469 7665 2043 2053 Objective C S │ │ │ │ │ -0003b5c0: 7570 706f 7274 2e20 286c 696e 6520 2031 upport. (line 1 │ │ │ │ │ -0003b5d0: 3929 0a2a 204f 424a 434c 494e 4b3a 2020 9).* OBJCLINK: │ │ │ │ │ +0003b5b0: 2020 2020 4f62 6a65 6374 6976 6520 4320 Objective C │ │ │ │ │ +0003b5c0: 5375 7070 6f72 742e 2028 6c69 6e65 2020 Support. (line │ │ │ │ │ +0003b5d0: 3139 290a 2a20 4f42 4a43 4c49 4e4b 3a20 19).* OBJCLINK: │ │ │ │ │ 0003b5e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b5f0: 2020 2020 2020 2020 2020 2020 4f62 6a65 Obje │ │ │ │ │ -0003b600: 6374 6976 6520 4320 5375 7070 6f72 742e ctive C Support. │ │ │ │ │ -0003b610: 2028 6c69 6e65 2020 3239 290a 2a20 4f42 (line 29).* OB │ │ │ │ │ -0003b620: 4a43 4c49 4e4b 203c 313e 3a20 2020 2020 JCLINK <1>: │ │ │ │ │ +0003b5f0: 2020 2020 2020 2020 2020 2020 204f 626a Obj │ │ │ │ │ +0003b600: 6563 7469 7665 2043 2053 7570 706f 7274 ective C Support │ │ │ │ │ +0003b610: 2e20 286c 696e 6520 2032 3929 0a2a 204f . (line 29).* O │ │ │ │ │ +0003b620: 424a 434c 494e 4b20 3c31 3e3a 2020 2020 BJCLINK <1>: │ │ │ │ │ 0003b630: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b640: 2020 2020 2048 6f77 2074 6865 204c 696e How the Lin │ │ │ │ │ -0003b650: 6b65 7220 6973 2043 686f 7365 6e2e 0a20 ker is Chosen.. │ │ │ │ │ +0003b640: 2020 2020 2020 486f 7720 7468 6520 4c69 How the Li │ │ │ │ │ +0003b650: 6e6b 6572 2069 7320 4368 6f73 656e 2e0a nker is Chosen.. │ │ │ │ │ 0003b660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b690: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003b6a0: 6e65 2020 3134 290a 2a20 6f6c 6469 6e63 ne 14).* oldinc │ │ │ │ │ -0003b6b0: 6c75 6465 5f48 4541 4445 5253 3a20 2020 lude_HEADERS: │ │ │ │ │ +0003b690: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0003b6a0: 696e 6520 2031 3429 0a2a 206f 6c64 696e ine 14).* oldin │ │ │ │ │ +0003b6b0: 636c 7564 655f 4845 4144 4552 533a 2020 clude_HEADERS: │ │ │ │ │ 0003b6c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b6d0: 2048 6561 6465 7273 2e20 2020 2020 2020 Headers. │ │ │ │ │ -0003b6e0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0003b6f0: 0a2a 2050 4143 4b41 4745 3a20 2020 2020 .* PACKAGE: │ │ │ │ │ +0003b6d0: 2020 4865 6164 6572 732e 2020 2020 2020 Headers. │ │ │ │ │ +0003b6e0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0003b6f0: 290a 2a20 5041 434b 4147 453a 2020 2020 ).* PACKAGE: │ │ │ │ │ 0003b700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b710: 2020 2020 2020 2020 2020 4261 7369 6373 Basics │ │ │ │ │ -0003b720: 206f 6620 4469 7374 7269 6275 7469 6f6e of Distribution │ │ │ │ │ -0003b730: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +0003b710: 2020 2020 2020 2020 2020 2042 6173 6963 Basic │ │ │ │ │ +0003b720: 7320 6f66 2044 6973 7472 6962 7574 696f s of Distributio │ │ │ │ │ +0003b730: 6e2e 0a20 2020 2020 2020 2020 2020 2020 n.. │ │ │ │ │ 0003b740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003b760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b770: 286c 696e 6520 2020 3629 0a2a 2070 6b67 (line 6).* pkg │ │ │ │ │ -0003b780: 6461 7461 6469 723a 2020 2020 2020 2020 datadir: │ │ │ │ │ +0003b770: 2028 6c69 6e65 2020 2036 290a 2a20 706b (line 6).* pk │ │ │ │ │ +0003b780: 6764 6174 6164 6972 3a20 2020 2020 2020 gdatadir: │ │ │ │ │ 0003b790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b7a0: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ -0003b7b0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003b7c0: 3139 290a 2a20 706b 6764 6174 615f 4441 19).* pkgdata_DA │ │ │ │ │ -0003b7d0: 5441 3a20 2020 2020 2020 2020 2020 2020 TA: │ │ │ │ │ -0003b7e0: 2020 2020 2020 2020 2020 2020 2044 6174 Dat │ │ │ │ │ -0003b7f0: 612e 2020 2020 2020 2020 2020 2020 2020 a. │ │ │ │ │ -0003b800: 2020 286c 696e 6520 2020 3929 0a2a 2070 (line 9).* p │ │ │ │ │ -0003b810: 6b67 6461 7461 5f53 4352 4950 5453 3a20 kgdata_SCRIPTS: │ │ │ │ │ +0003b7a0: 2020 2020 2055 6e69 666f 726d 2e20 2020 Uniform. │ │ │ │ │ +0003b7b0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003b7c0: 2031 3929 0a2a 2070 6b67 6461 7461 5f44 19).* pkgdata_D │ │ │ │ │ +0003b7d0: 4154 413a 2020 2020 2020 2020 2020 2020 ATA: │ │ │ │ │ +0003b7e0: 2020 2020 2020 2020 2020 2020 2020 4461 Da │ │ │ │ │ +0003b7f0: 7461 2e20 2020 2020 2020 2020 2020 2020 ta. │ │ │ │ │ +0003b800: 2020 2028 6c69 6e65 2020 2039 290a 2a20 (line 9).* │ │ │ │ │ +0003b810: 706b 6764 6174 615f 5343 5249 5054 533a pkgdata_SCRIPTS: │ │ │ │ │ 0003b820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b830: 2020 2020 2020 5363 7269 7074 732e 2020 Scripts. │ │ │ │ │ -0003b840: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003b850: 2020 3138 290a 2a20 706b 6769 6e63 6c75 18).* pkginclu │ │ │ │ │ -0003b860: 6465 6469 723a 2020 2020 2020 2020 2020 dedir: │ │ │ │ │ -0003b870: 2020 2020 2020 2020 2020 2020 2020 2055 U │ │ │ │ │ -0003b880: 6e69 666f 726d 2e20 2020 2020 2020 2020 niform. │ │ │ │ │ -0003b890: 2020 2020 286c 696e 6520 2031 3929 0a2a (line 19).* │ │ │ │ │ -0003b8a0: 2070 6b67 696e 636c 7564 655f 4845 4144 pkginclude_HEAD │ │ │ │ │ -0003b8b0: 4552 533a 2020 2020 2020 2020 2020 2020 ERS: │ │ │ │ │ -0003b8c0: 2020 2020 2020 2020 4865 6164 6572 732e Headers. │ │ │ │ │ -0003b8d0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003b8e0: 6e65 2020 2036 290a 2a20 706b 676c 6962 ne 6).* pkglib │ │ │ │ │ -0003b8f0: 6469 723a 2020 2020 2020 2020 2020 2020 dir: │ │ │ │ │ +0003b830: 2020 2020 2020 2053 6372 6970 7473 2e20 Scripts. │ │ │ │ │ +0003b840: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003b850: 6520 2031 3829 0a2a 2070 6b67 696e 636c e 18).* pkgincl │ │ │ │ │ +0003b860: 7564 6564 6972 3a20 2020 2020 2020 2020 udedir: │ │ │ │ │ +0003b870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003b880: 556e 6966 6f72 6d2e 2020 2020 2020 2020 Uniform. │ │ │ │ │ +0003b890: 2020 2020 2028 6c69 6e65 2020 3139 290a (line 19). │ │ │ │ │ +0003b8a0: 2a20 706b 6769 6e63 6c75 6465 5f48 4541 * pkginclude_HEA │ │ │ │ │ +0003b8b0: 4445 5253 3a20 2020 2020 2020 2020 2020 DERS: │ │ │ │ │ +0003b8c0: 2020 2020 2020 2020 2048 6561 6465 7273 Headers │ │ │ │ │ +0003b8d0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0003b8e0: 696e 6520 2020 3629 0a2a 2070 6b67 6c69 ine 6).* pkgli │ │ │ │ │ +0003b8f0: 6264 6972 3a20 2020 2020 2020 2020 2020 bdir: │ │ │ │ │ 0003b900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b910: 2055 6e69 666f 726d 2e20 2020 2020 2020 Uniform. │ │ │ │ │ -0003b920: 2020 2020 2020 286c 696e 6520 2031 3929 (line 19) │ │ │ │ │ -0003b930: 0a2a 2070 6b67 6c69 6265 7865 6364 6972 .* pkglibexecdir │ │ │ │ │ -0003b940: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003b950: 2020 2020 2020 2020 2020 556e 6966 6f72 Unifor │ │ │ │ │ -0003b960: 6d2e 2020 2020 2020 2020 2020 2020 2028 m. ( │ │ │ │ │ -0003b970: 6c69 6e65 2020 3139 290a 2a20 706b 676c line 19).* pkgl │ │ │ │ │ -0003b980: 6962 6578 6563 5f50 524f 4752 414d 533a ibexec_PROGRAMS: │ │ │ │ │ -0003b990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003b9a0: 2020 2050 726f 6772 616d 2053 6f75 7263 Program Sourc │ │ │ │ │ -0003b9b0: 6573 2e20 2020 2020 286c 696e 6520 2020 es. (line │ │ │ │ │ -0003b9c0: 3629 0a2a 2070 6b67 6c69 6265 7865 635f 6).* pkglibexec_ │ │ │ │ │ -0003b9d0: 5343 5249 5054 533a 2020 2020 2020 2020 SCRIPTS: │ │ │ │ │ -0003b9e0: 2020 2020 2020 2020 2020 2020 5363 7269 Scri │ │ │ │ │ -0003b9f0: 7074 732e 2020 2020 2020 2020 2020 2020 pts. │ │ │ │ │ -0003ba00: 2028 6c69 6e65 2020 3138 290a 2a20 706b (line 18).* pk │ │ │ │ │ -0003ba10: 676c 6962 5f4c 4942 5241 5249 4553 3a20 glib_LIBRARIES: │ │ │ │ │ +0003b910: 2020 556e 6966 6f72 6d2e 2020 2020 2020 Uniform. │ │ │ │ │ +0003b920: 2020 2020 2020 2028 6c69 6e65 2020 3139 (line 19 │ │ │ │ │ +0003b930: 290a 2a20 706b 676c 6962 6578 6563 6469 ).* pkglibexecdi │ │ │ │ │ +0003b940: 723a 2020 2020 2020 2020 2020 2020 2020 r: │ │ │ │ │ +0003b950: 2020 2020 2020 2020 2020 2055 6e69 666f Unifo │ │ │ │ │ +0003b960: 726d 2e20 2020 2020 2020 2020 2020 2020 rm. │ │ │ │ │ +0003b970: 286c 696e 6520 2031 3929 0a2a 2070 6b67 (line 19).* pkg │ │ │ │ │ +0003b980: 6c69 6265 7865 635f 5052 4f47 5241 4d53 libexec_PROGRAMS │ │ │ │ │ +0003b990: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003b9a0: 2020 2020 5072 6f67 7261 6d20 536f 7572 Program Sour │ │ │ │ │ +0003b9b0: 6365 732e 2020 2020 2028 6c69 6e65 2020 ces. (line │ │ │ │ │ +0003b9c0: 2036 290a 2a20 706b 676c 6962 6578 6563 6).* pkglibexec │ │ │ │ │ +0003b9d0: 5f53 4352 4950 5453 3a20 2020 2020 2020 _SCRIPTS: │ │ │ │ │ +0003b9e0: 2020 2020 2020 2020 2020 2020 2053 6372 Scr │ │ │ │ │ +0003b9f0: 6970 7473 2e20 2020 2020 2020 2020 2020 ipts. │ │ │ │ │ +0003ba00: 2020 286c 696e 6520 2031 3829 0a2a 2070 (line 18).* p │ │ │ │ │ +0003ba10: 6b67 6c69 625f 4c49 4252 4152 4945 533a kglib_LIBRARIES: │ │ │ │ │ 0003ba20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ba30: 2020 2020 2041 204c 6962 7261 7279 2e20 A Library. │ │ │ │ │ -0003ba40: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003ba50: 2020 3629 0a2a 2070 6b67 6c69 625f 4c54 6).* pkglib_LT │ │ │ │ │ -0003ba60: 4c49 4252 4152 4945 533a 2020 2020 2020 LIBRARIES: │ │ │ │ │ -0003ba70: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ │ -0003ba80: 6274 6f6f 6c20 4c69 6272 6172 6965 732e btool Libraries. │ │ │ │ │ -0003ba90: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -0003baa0: 706b 6770 7965 7865 6364 6972 3a20 2020 pkgpyexecdir: │ │ │ │ │ +0003ba30: 2020 2020 2020 4120 4c69 6272 6172 792e A Library. │ │ │ │ │ +0003ba40: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003ba50: 2020 2036 290a 2a20 706b 676c 6962 5f4c 6).* pkglib_L │ │ │ │ │ +0003ba60: 544c 4942 5241 5249 4553 3a20 2020 2020 TLIBRARIES: │ │ │ │ │ +0003ba70: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ │ +0003ba80: 6962 746f 6f6c 204c 6962 7261 7269 6573 ibtool Libraries │ │ │ │ │ +0003ba90: 2e20 2020 286c 696e 6520 2020 3629 0a2a . (line 6).* │ │ │ │ │ +0003baa0: 2070 6b67 7079 6578 6563 6469 723a 2020 pkgpyexecdir: │ │ │ │ │ 0003bab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bac0: 2020 2020 2020 2050 7974 686f 6e2e 2020 Python. │ │ │ │ │ -0003bad0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0003bae0: 6520 3130 3529 0a2a 2070 6b67 7079 7468 e 105).* pkgpyth │ │ │ │ │ -0003baf0: 6f6e 6469 723a 2020 2020 2020 2020 2020 ondir: │ │ │ │ │ +0003bac0: 2020 2020 2020 2020 5079 7468 6f6e 2e20 Python. │ │ │ │ │ +0003bad0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0003bae0: 6e65 2031 3035 290a 2a20 706b 6770 7974 ne 105).* pkgpyt │ │ │ │ │ +0003baf0: 686f 6e64 6972 3a20 2020 2020 2020 2020 hondir: │ │ │ │ │ 0003bb00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bb10: 5079 7468 6f6e 2e20 2020 2020 2020 2020 Python. │ │ │ │ │ -0003bb20: 2020 2020 2028 6c69 6e65 2020 3931 290a (line 91). │ │ │ │ │ -0003bb30: 2a20 5052 4f47 5241 4d53 3a20 2020 2020 * PROGRAMS: │ │ │ │ │ +0003bb10: 2050 7974 686f 6e2e 2020 2020 2020 2020 Python. │ │ │ │ │ +0003bb20: 2020 2020 2020 286c 696e 6520 2039 3129 (line 91) │ │ │ │ │ +0003bb30: 0a2a 2050 524f 4752 414d 533a 2020 2020 .* PROGRAMS: │ │ │ │ │ 0003bb40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bb50: 2020 2020 2020 2020 2055 6e69 666f 726d Uniform │ │ │ │ │ -0003bb60: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -0003bb70: 696e 6520 2031 3729 0a2a 2050 524f 4752 ine 17).* PROGR │ │ │ │ │ -0003bb80: 414d 5320 3c31 3e3a 2020 2020 2020 2020 AMS <1>: │ │ │ │ │ +0003bb50: 2020 2020 2020 2020 2020 556e 6966 6f72 Unifor │ │ │ │ │ +0003bb60: 6d2e 2020 2020 2020 2020 2020 2020 2028 m. ( │ │ │ │ │ +0003bb70: 6c69 6e65 2020 3137 290a 2a20 5052 4f47 line 17).* PROG │ │ │ │ │ +0003bb80: 5241 4d53 203c 313e 3a20 2020 2020 2020 RAMS <1>: │ │ │ │ │ 0003bb90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bba0: 2020 556e 6966 6f72 6d2e 2020 2020 2020 Uniform. │ │ │ │ │ -0003bbb0: 2020 2020 2020 2028 6c69 6e65 2031 3032 (line 102 │ │ │ │ │ -0003bbc0: 290a 2a20 7079 6578 6563 6469 723a 2020 ).* pyexecdir: │ │ │ │ │ +0003bba0: 2020 2055 6e69 666f 726d 2e20 2020 2020 Uniform. │ │ │ │ │ +0003bbb0: 2020 2020 2020 2020 286c 696e 6520 3130 (line 10 │ │ │ │ │ +0003bbc0: 3229 0a2a 2070 7965 7865 6364 6972 3a20 2).* pyexecdir: │ │ │ │ │ 0003bbd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bbe0: 2020 2020 2020 2020 2020 2050 7974 686f Pytho │ │ │ │ │ -0003bbf0: 6e2e 2020 2020 2020 2020 2020 2020 2020 n. │ │ │ │ │ -0003bc00: 286c 696e 6520 2039 3629 0a2a 2050 5954 (line 96).* PYT │ │ │ │ │ -0003bc10: 484f 4e3a 2020 2020 2020 2020 2020 2020 HON: │ │ │ │ │ +0003bbe0: 2020 2020 2020 2020 2020 2020 5079 7468 Pyth │ │ │ │ │ +0003bbf0: 6f6e 2e20 2020 2020 2020 2020 2020 2020 on. │ │ │ │ │ +0003bc00: 2028 6c69 6e65 2020 3936 290a 2a20 5059 (line 96).* PY │ │ │ │ │ +0003bc10: 5448 4f4e 3a20 2020 2020 2020 2020 2020 THON: │ │ │ │ │ 0003bc20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bc30: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ -0003bc40: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ -0003bc50: 3032 290a 2a20 5059 5448 4f4e 203c 313e 02).* PYTHON <1> │ │ │ │ │ -0003bc60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003bc70: 2020 2020 2020 2020 2020 2020 2050 7974 Pyt │ │ │ │ │ -0003bc80: 686f 6e2e 2020 2020 2020 2020 2020 2020 hon. │ │ │ │ │ -0003bc90: 2020 286c 696e 6520 2035 3629 0a2a 2070 (line 56).* p │ │ │ │ │ -0003bca0: 7974 686f 6e64 6972 3a20 2020 2020 2020 ythondir: │ │ │ │ │ +0003bc30: 2020 2020 2055 6e69 666f 726d 2e20 2020 Uniform. │ │ │ │ │ +0003bc40: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003bc50: 3130 3229 0a2a 2050 5954 484f 4e20 3c31 102).* PYTHON <1 │ │ │ │ │ +0003bc60: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +0003bc70: 2020 2020 2020 2020 2020 2020 2020 5079 Py │ │ │ │ │ +0003bc80: 7468 6f6e 2e20 2020 2020 2020 2020 2020 thon. │ │ │ │ │ +0003bc90: 2020 2028 6c69 6e65 2020 3536 290a 2a20 (line 56).* │ │ │ │ │ +0003bca0: 7079 7468 6f6e 6469 723a 2020 2020 2020 pythondir: │ │ │ │ │ 0003bcb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bcc0: 2020 2020 2020 5079 7468 6f6e 2e20 2020 Python. │ │ │ │ │ -0003bcd0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003bce0: 2020 3837 290a 2a20 5059 5448 4f4e 5f45 87).* PYTHON_E │ │ │ │ │ -0003bcf0: 5845 435f 5052 4546 4958 3a20 2020 2020 XEC_PREFIX: │ │ │ │ │ -0003bd00: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -0003bd10: 7974 686f 6e2e 2020 2020 2020 2020 2020 ython. │ │ │ │ │ -0003bd20: 2020 2020 286c 696e 6520 2037 3729 0a2a (line 77).* │ │ │ │ │ -0003bd30: 2050 5954 484f 4e5f 504c 4154 464f 524d PYTHON_PLATFORM │ │ │ │ │ -0003bd40: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003bd50: 2020 2020 2020 2020 5079 7468 6f6e 2e20 Python. │ │ │ │ │ -0003bd60: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003bd70: 6e65 2020 3832 290a 2a20 5059 5448 4f4e ne 82).* PYTHON │ │ │ │ │ -0003bd80: 5f50 5245 4649 583a 2020 2020 2020 2020 _PREFIX: │ │ │ │ │ +0003bcc0: 2020 2020 2020 2050 7974 686f 6e2e 2020 Python. │ │ │ │ │ +0003bcd0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003bce0: 6520 2038 3729 0a2a 2050 5954 484f 4e5f e 87).* PYTHON_ │ │ │ │ │ +0003bcf0: 4558 4543 5f50 5245 4649 583a 2020 2020 EXEC_PREFIX: │ │ │ │ │ +0003bd00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003bd10: 5079 7468 6f6e 2e20 2020 2020 2020 2020 Python. │ │ │ │ │ +0003bd20: 2020 2020 2028 6c69 6e65 2020 3737 290a (line 77). │ │ │ │ │ +0003bd30: 2a20 5059 5448 4f4e 5f50 4c41 5446 4f52 * PYTHON_PLATFOR │ │ │ │ │ +0003bd40: 4d3a 2020 2020 2020 2020 2020 2020 2020 M: │ │ │ │ │ +0003bd50: 2020 2020 2020 2020 2050 7974 686f 6e2e Python. │ │ │ │ │ +0003bd60: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0003bd70: 696e 6520 2038 3229 0a2a 2050 5954 484f ine 82).* PYTHO │ │ │ │ │ +0003bd80: 4e5f 5052 4546 4958 3a20 2020 2020 2020 N_PREFIX: │ │ │ │ │ 0003bd90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bda0: 2050 7974 686f 6e2e 2020 2020 2020 2020 Python. │ │ │ │ │ -0003bdb0: 2020 2020 2020 286c 696e 6520 2037 3229 (line 72) │ │ │ │ │ -0003bdc0: 0a2a 2050 5954 484f 4e5f 5645 5253 494f .* PYTHON_VERSIO │ │ │ │ │ -0003bdd0: 4e3a 2020 2020 2020 2020 2020 2020 2020 N: │ │ │ │ │ -0003bde0: 2020 2020 2020 2020 2020 5079 7468 6f6e Python │ │ │ │ │ -0003bdf0: 2e20 2020 2020 2020 2020 2020 2020 2028 . ( │ │ │ │ │ -0003be00: 6c69 6e65 2020 3638 290a 2a20 5245 4348 line 68).* RECH │ │ │ │ │ -0003be10: 4543 4b5f 4c4f 4753 3a20 2020 2020 2020 ECK_LOGS: │ │ │ │ │ +0003bda0: 2020 5079 7468 6f6e 2e20 2020 2020 2020 Python. │ │ │ │ │ +0003bdb0: 2020 2020 2020 2028 6c69 6e65 2020 3732 (line 72 │ │ │ │ │ +0003bdc0: 290a 2a20 5059 5448 4f4e 5f56 4552 5349 ).* PYTHON_VERSI │ │ │ │ │ +0003bdd0: 4f4e 3a20 2020 2020 2020 2020 2020 2020 ON: │ │ │ │ │ +0003bde0: 2020 2020 2020 2020 2020 2050 7974 686f Pytho │ │ │ │ │ +0003bdf0: 6e2e 2020 2020 2020 2020 2020 2020 2020 n. │ │ │ │ │ +0003be00: 286c 696e 6520 2036 3829 0a2a 2052 4543 (line 68).* REC │ │ │ │ │ +0003be10: 4845 434b 5f4c 4f47 533a 2020 2020 2020 HECK_LOGS: │ │ │ │ │ 0003be20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003be30: 2020 2053 696d 706c 6520 5465 7374 7320 Simple Tests │ │ │ │ │ -0003be40: 7573 696e 6720 7061 7261 6c6c 656c 2d74 using parallel-t │ │ │ │ │ -0003be50: 6573 7473 2e0a 2020 2020 2020 2020 2020 ests.. │ │ │ │ │ +0003be30: 2020 2020 5369 6d70 6c65 2054 6573 7473 Simple Tests │ │ │ │ │ +0003be40: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ +0003be50: 7465 7374 732e 0a20 2020 2020 2020 2020 tests.. │ │ │ │ │ 0003be60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003be70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003be80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003be90: 2020 2020 286c 696e 6520 3131 3729 0a2a (line 117).* │ │ │ │ │ -0003bea0: 2052 464c 4147 533a 2020 2020 2020 2020 RFLAGS: │ │ │ │ │ +0003be90: 2020 2020 2028 6c69 6e65 2031 3137 290a (line 117). │ │ │ │ │ +0003bea0: 2a20 5246 4c41 4753 3a20 2020 2020 2020 * RFLAGS: │ │ │ │ │ 0003beb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bec0: 2020 2020 2020 2020 466f 7274 7261 6e20 Fortran │ │ │ │ │ -0003bed0: 3737 2053 7570 706f 7274 2e20 2028 6c69 77 Support. (li │ │ │ │ │ -0003bee0: 6e65 2020 3235 290a 2a20 5253 5432 4854 ne 25).* RST2HT │ │ │ │ │ -0003bef0: 4d4c 3a20 2020 2020 2020 2020 2020 2020 ML: │ │ │ │ │ +0003bec0: 2020 2020 2020 2020 2046 6f72 7472 616e Fortran │ │ │ │ │ +0003bed0: 2037 3720 5375 7070 6f72 742e 2020 286c 77 Support. (l │ │ │ │ │ +0003bee0: 696e 6520 2032 3529 0a2a 2052 5354 3248 ine 25).* RST2H │ │ │ │ │ +0003bef0: 544d 4c3a 2020 2020 2020 2020 2020 2020 TML: │ │ │ │ │ 0003bf00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bf10: 2053 696d 706c 6520 5465 7374 7320 7573 Simple Tests us │ │ │ │ │ -0003bf20: 696e 6720 7061 7261 6c6c 656c 2d74 6573 ing parallel-tes │ │ │ │ │ -0003bf30: 7473 2e0a 2020 2020 2020 2020 2020 2020 ts.. │ │ │ │ │ +0003bf10: 2020 5369 6d70 6c65 2054 6573 7473 2075 Simple Tests u │ │ │ │ │ +0003bf20: 7369 6e67 2070 6172 616c 6c65 6c2d 7465 sing parallel-te │ │ │ │ │ +0003bf30: 7374 732e 0a20 2020 2020 2020 2020 2020 sts.. │ │ │ │ │ 0003bf40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003bf50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003bf60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bf70: 2020 286c 696e 6520 2037 3029 0a2a 2052 (line 70).* R │ │ │ │ │ -0003bf80: 554e 5445 5354 3a20 2020 2020 2020 2020 UNTEST: │ │ │ │ │ +0003bf70: 2020 2028 6c69 6e65 2020 3730 290a 2a20 (line 70).* │ │ │ │ │ +0003bf80: 5255 4e54 4553 543a 2020 2020 2020 2020 RUNTEST: │ │ │ │ │ 0003bf90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003bfa0: 2020 2020 2020 4465 6a61 476e 7520 5465 DejaGnu Te │ │ │ │ │ -0003bfb0: 7374 732e 2020 2020 2020 2028 6c69 6e65 sts. (line │ │ │ │ │ -0003bfc0: 2020 3139 290a 2a20 5255 4e54 4553 5444 19).* RUNTESTD │ │ │ │ │ -0003bfd0: 4546 4155 4c54 464c 4147 533a 2020 2020 EFAULTFLAGS: │ │ │ │ │ -0003bfe0: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ -0003bff0: 656a 6147 6e75 2054 6573 7473 2e20 2020 ejaGnu Tests. │ │ │ │ │ -0003c000: 2020 2020 286c 696e 6520 2031 3429 0a2a (line 14).* │ │ │ │ │ -0003c010: 2052 554e 5445 5354 464c 4147 533a 2020 RUNTESTFLAGS: │ │ │ │ │ +0003bfa0: 2020 2020 2020 2044 656a 6147 6e75 2054 DejaGnu T │ │ │ │ │ +0003bfb0: 6573 7473 2e20 2020 2020 2020 286c 696e ests. (lin │ │ │ │ │ +0003bfc0: 6520 2031 3929 0a2a 2052 554e 5445 5354 e 19).* RUNTEST │ │ │ │ │ +0003bfd0: 4445 4641 554c 5446 4c41 4753 3a20 2020 DEFAULTFLAGS: │ │ │ │ │ +0003bfe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003bff0: 4465 6a61 476e 7520 5465 7374 732e 2020 DejaGnu Tests. │ │ │ │ │ +0003c000: 2020 2020 2028 6c69 6e65 2020 3134 290a (line 14). │ │ │ │ │ +0003c010: 2a20 5255 4e54 4553 5446 4c41 4753 3a20 * RUNTESTFLAGS: │ │ │ │ │ 0003c020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c030: 2020 2020 2020 2020 4465 6a61 476e 7520 DejaGnu │ │ │ │ │ -0003c040: 5465 7374 732e 2020 2020 2020 2028 6c69 Tests. (li │ │ │ │ │ -0003c050: 6e65 2020 3234 290a 2a20 7362 696e 5f50 ne 24).* sbin_P │ │ │ │ │ -0003c060: 524f 4752 414d 533a 2020 2020 2020 2020 ROGRAMS: │ │ │ │ │ +0003c030: 2020 2020 2020 2020 2044 656a 6147 6e75 DejaGnu │ │ │ │ │ +0003c040: 2054 6573 7473 2e20 2020 2020 2020 286c Tests. (l │ │ │ │ │ +0003c050: 696e 6520 2032 3429 0a2a 2073 6269 6e5f ine 24).* sbin_ │ │ │ │ │ +0003c060: 5052 4f47 5241 4d53 3a20 2020 2020 2020 PROGRAMS: │ │ │ │ │ 0003c070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c080: 2050 726f 6772 616d 2053 6f75 7263 6573 Program Sources │ │ │ │ │ -0003c090: 2e20 2020 2020 286c 696e 6520 2020 3629 . (line 6) │ │ │ │ │ -0003c0a0: 0a2a 2073 6269 6e5f 5343 5249 5054 533a .* sbin_SCRIPTS: │ │ │ │ │ -0003c0b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c0c0: 2020 2020 2020 2020 2020 5363 7269 7074 Script │ │ │ │ │ -0003c0d0: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -0003c0e0: 6c69 6e65 2020 3138 290a 2a20 5343 5249 line 18).* SCRI │ │ │ │ │ -0003c0f0: 5054 533a 2020 2020 2020 2020 2020 2020 PTS: │ │ │ │ │ +0003c080: 2020 5072 6f67 7261 6d20 536f 7572 6365 Program Source │ │ │ │ │ +0003c090: 732e 2020 2020 2028 6c69 6e65 2020 2036 s. (line 6 │ │ │ │ │ +0003c0a0: 290a 2a20 7362 696e 5f53 4352 4950 5453 ).* sbin_SCRIPTS │ │ │ │ │ +0003c0b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003c0c0: 2020 2020 2020 2020 2020 2053 6372 6970 Scrip │ │ │ │ │ +0003c0d0: 7473 2e20 2020 2020 2020 2020 2020 2020 ts. │ │ │ │ │ +0003c0e0: 286c 696e 6520 2031 3829 0a2a 2053 4352 (line 18).* SCR │ │ │ │ │ +0003c0f0: 4950 5453 3a20 2020 2020 2020 2020 2020 IPTS: │ │ │ │ │ 0003c100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c110: 2020 2055 6e69 666f 726d 2e20 2020 2020 Uniform. │ │ │ │ │ -0003c120: 2020 2020 2020 2020 286c 696e 6520 3130 (line 10 │ │ │ │ │ -0003c130: 3229 0a2a 2053 4352 4950 5453 203c 313e 2).* SCRIPTS <1> │ │ │ │ │ -0003c140: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003c150: 2020 2020 2020 2020 2020 2020 5363 7269 Scri │ │ │ │ │ -0003c160: 7074 732e 2020 2020 2020 2020 2020 2020 pts. │ │ │ │ │ -0003c170: 2028 6c69 6e65 2020 2039 290a 2a20 7368 (line 9).* sh │ │ │ │ │ -0003c180: 6172 6564 7374 6174 655f 4441 5441 3a20 aredstate_DATA: │ │ │ │ │ +0003c110: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ +0003c120: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +0003c130: 3032 290a 2a20 5343 5249 5054 5320 3c31 02).* SCRIPTS <1 │ │ │ │ │ +0003c140: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +0003c150: 2020 2020 2020 2020 2020 2020 2053 6372 Scr │ │ │ │ │ +0003c160: 6970 7473 2e20 2020 2020 2020 2020 2020 ipts. │ │ │ │ │ +0003c170: 2020 286c 696e 6520 2020 3929 0a2a 2073 (line 9).* s │ │ │ │ │ +0003c180: 6861 7265 6473 7461 7465 5f44 4154 413a haredstate_DATA: │ │ │ │ │ 0003c190: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c1a0: 2020 2020 2044 6174 612e 2020 2020 2020 Data. │ │ │ │ │ -0003c1b0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003c1c0: 2020 3929 0a2a 2053 4f55 5243 4553 3a20 9).* SOURCES: │ │ │ │ │ +0003c1a0: 2020 2020 2020 4461 7461 2e20 2020 2020 Data. │ │ │ │ │ +0003c1b0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003c1c0: 2020 2039 290a 2a20 534f 5552 4345 533a 9).* SOURCES: │ │ │ │ │ 0003c1d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c1e0: 2020 2020 2020 2020 2020 2020 2020 5072 Pr │ │ │ │ │ -0003c1f0: 6f67 7261 6d20 536f 7572 6365 732e 2020 ogram Sources. │ │ │ │ │ -0003c200: 2020 2028 6c69 6e65 2020 3333 290a 2a20 (line 33).* │ │ │ │ │ -0003c210: 534f 5552 4345 5320 3c31 3e3a 2020 2020 SOURCES <1>: │ │ │ │ │ +0003c1e0: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +0003c1f0: 726f 6772 616d 2053 6f75 7263 6573 2e20 rogram Sources. │ │ │ │ │ +0003c200: 2020 2020 286c 696e 6520 2033 3329 0a2a (line 33).* │ │ │ │ │ +0003c210: 2053 4f55 5243 4553 203c 313e 3a20 2020 SOURCES <1>: │ │ │ │ │ 0003c220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c230: 2020 2020 2020 2044 6566 6175 6c74 205f Default _ │ │ │ │ │ -0003c240: 534f 5552 4345 532e 2020 2020 286c 696e SOURCES. (lin │ │ │ │ │ -0003c250: 6520 2020 3629 0a2a 2053 5542 4449 5253 e 6).* SUBDIRS │ │ │ │ │ -0003c260: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003c230: 2020 2020 2020 2020 4465 6661 756c 7420 Default │ │ │ │ │ +0003c240: 5f53 4f55 5243 4553 2e20 2020 2028 6c69 _SOURCES. (li │ │ │ │ │ +0003c250: 6e65 2020 2036 290a 2a20 5355 4244 4952 ne 6).* SUBDIR │ │ │ │ │ +0003c260: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ 0003c270: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c280: 5375 6264 6972 6563 746f 7269 6573 2e20 Subdirectories. │ │ │ │ │ -0003c290: 2020 2020 2028 6c69 6e65 2020 2038 290a (line 8). │ │ │ │ │ -0003c2a0: 2a20 5355 4244 4952 5320 3c31 3e3a 2020 * SUBDIRS <1>: │ │ │ │ │ +0003c280: 2053 7562 6469 7265 6374 6f72 6965 732e Subdirectories. │ │ │ │ │ +0003c290: 2020 2020 2020 286c 696e 6520 2020 3829 (line 8) │ │ │ │ │ +0003c2a0: 0a2a 2053 5542 4449 5253 203c 313e 3a20 .* SUBDIRS <1>: │ │ │ │ │ 0003c2b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c2c0: 2020 2020 2020 2020 2042 6173 6963 7320 Basics │ │ │ │ │ -0003c2d0: 6f66 2044 6973 7472 6962 7574 696f 6e2e of Distribution. │ │ │ │ │ -0003c2e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003c2c0: 2020 2020 2020 2020 2020 4261 7369 6373 Basics │ │ │ │ │ +0003c2d0: 206f 6620 4469 7374 7269 6275 7469 6f6e of Distribution │ │ │ │ │ +0003c2e0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 0003c2f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c310: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0003c320: 6c69 6e65 2020 3431 290a 2a20 5355 4646 line 41).* SUFF │ │ │ │ │ -0003c330: 4958 4553 3a20 2020 2020 2020 2020 2020 IXES: │ │ │ │ │ +0003c310: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003c320: 286c 696e 6520 2034 3129 0a2a 2053 5546 (line 41).* SUF │ │ │ │ │ +0003c330: 4649 5845 533a 2020 2020 2020 2020 2020 FIXES: │ │ │ │ │ 0003c340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c350: 2020 2053 7566 6669 7865 732e 2020 2020 Suffixes. │ │ │ │ │ -0003c360: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ -0003c370: 3629 0a2a 2073 7973 636f 6e66 5f44 4154 6).* sysconf_DAT │ │ │ │ │ -0003c380: 413a 2020 2020 2020 2020 2020 2020 2020 A: │ │ │ │ │ -0003c390: 2020 2020 2020 2020 2020 2020 4461 7461 Data │ │ │ │ │ -0003c3a0: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -0003c3b0: 2028 6c69 6e65 2020 2039 290a 2a20 5441 (line 9).* TA │ │ │ │ │ -0003c3c0: 4753 5f44 4550 454e 4445 4e43 4945 533a GS_DEPENDENCIES: │ │ │ │ │ -0003c3d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c3e0: 2020 2020 2054 6167 732e 2020 2020 2020 Tags. │ │ │ │ │ -0003c3f0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003c400: 2033 3529 0a2a 2074 6172 6765 745f 7472 35).* target_tr │ │ │ │ │ -0003c410: 6970 6c65 743a 2020 2020 2020 2020 2020 iplet: │ │ │ │ │ -0003c420: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ -0003c430: 7469 6f6e 616c 2e20 2020 2020 2020 2020 tional. │ │ │ │ │ -0003c440: 2020 2028 6c69 6e65 2020 3134 290a 2a20 (line 14).* │ │ │ │ │ -0003c450: 5445 5354 533a 2020 2020 2020 2020 2020 TESTS: │ │ │ │ │ +0003c350: 2020 2020 5375 6666 6978 6573 2e20 2020 Suffixes. │ │ │ │ │ +0003c360: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0003c370: 2036 290a 2a20 7379 7363 6f6e 665f 4441 6).* sysconf_DA │ │ │ │ │ +0003c380: 5441 3a20 2020 2020 2020 2020 2020 2020 TA: │ │ │ │ │ +0003c390: 2020 2020 2020 2020 2020 2020 2044 6174 Dat │ │ │ │ │ +0003c3a0: 612e 2020 2020 2020 2020 2020 2020 2020 a. │ │ │ │ │ +0003c3b0: 2020 286c 696e 6520 2020 3929 0a2a 2054 (line 9).* T │ │ │ │ │ +0003c3c0: 4147 535f 4445 5045 4e44 454e 4349 4553 AGS_DEPENDENCIES │ │ │ │ │ +0003c3d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003c3e0: 2020 2020 2020 5461 6773 2e20 2020 2020 Tags. │ │ │ │ │ +0003c3f0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003c400: 2020 3335 290a 2a20 7461 7267 6574 5f74 35).* target_t │ │ │ │ │ +0003c410: 7269 706c 6574 3a20 2020 2020 2020 2020 riplet: │ │ │ │ │ +0003c420: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +0003c430: 7074 696f 6e61 6c2e 2020 2020 2020 2020 ptional. │ │ │ │ │ +0003c440: 2020 2020 286c 696e 6520 2031 3429 0a2a (line 14).* │ │ │ │ │ +0003c450: 2054 4553 5453 3a20 2020 2020 2020 2020 TESTS: │ │ │ │ │ 0003c460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c470: 2020 2020 2020 2053 696d 706c 6520 5465 Simple Te │ │ │ │ │ -0003c480: 7374 732e 2020 2020 2020 2020 286c 696e sts. (lin │ │ │ │ │ -0003c490: 6520 2033 3729 0a2a 2054 4553 5453 203c e 37).* TESTS < │ │ │ │ │ -0003c4a0: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +0003c470: 2020 2020 2020 2020 5369 6d70 6c65 2054 Simple T │ │ │ │ │ +0003c480: 6573 7473 2e20 2020 2020 2020 2028 6c69 ests. (li │ │ │ │ │ +0003c490: 6e65 2020 3337 290a 2a20 5445 5354 5320 ne 37).* TESTS │ │ │ │ │ +0003c4a0: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ 0003c4b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c4c0: 5369 6d70 6c65 2054 6573 7473 2075 7369 Simple Tests usi │ │ │ │ │ -0003c4d0: 6e67 2070 6172 616c 6c65 6c2d 7465 7374 ng parallel-test │ │ │ │ │ -0003c4e0: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ +0003c4c0: 2053 696d 706c 6520 5465 7374 7320 7573 Simple Tests us │ │ │ │ │ +0003c4d0: 696e 6720 7061 7261 6c6c 656c 2d74 6573 ing parallel-tes │ │ │ │ │ +0003c4e0: 7473 2e0a 2020 2020 2020 2020 2020 2020 ts.. │ │ │ │ │ 0003c4f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c510: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c520: 2028 6c69 6e65 2020 3231 290a 2a20 5445 (line 21).* TE │ │ │ │ │ -0003c530: 5354 535f 454e 5649 524f 4e4d 454e 543a STS_ENVIRONMENT: │ │ │ │ │ -0003c540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c550: 2020 2020 2053 696d 706c 6520 5465 7374 Simple Test │ │ │ │ │ -0003c560: 732e 2020 2020 2020 2020 286c 696e 6520 s. (line │ │ │ │ │ -0003c570: 2033 3729 0a2a 2054 4553 545f 4558 5445 37).* TEST_EXTE │ │ │ │ │ -0003c580: 4e53 494f 4e53 3a20 2020 2020 2020 2020 NSIONS: │ │ │ │ │ -0003c590: 2020 2020 2020 2020 2020 2020 2020 5369 Si │ │ │ │ │ -0003c5a0: 6d70 6c65 2054 6573 7473 2075 7369 6e67 mple Tests using │ │ │ │ │ -0003c5b0: 2070 6172 616c 6c65 6c2d 7465 7374 732e parallel-tests. │ │ │ │ │ -0003c5c0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003c520: 2020 286c 696e 6520 2032 3129 0a2a 2054 (line 21).* T │ │ │ │ │ +0003c530: 4553 5453 5f45 4e56 4952 4f4e 4d45 4e54 ESTS_ENVIRONMENT │ │ │ │ │ +0003c540: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003c550: 2020 2020 2020 5369 6d70 6c65 2054 6573 Simple Tes │ │ │ │ │ +0003c560: 7473 2e20 2020 2020 2020 2028 6c69 6e65 ts. (line │ │ │ │ │ +0003c570: 2020 3337 290a 2a20 5445 5354 5f45 5854 37).* TEST_EXT │ │ │ │ │ +0003c580: 454e 5349 4f4e 533a 2020 2020 2020 2020 ENSIONS: │ │ │ │ │ +0003c590: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ +0003c5a0: 696d 706c 6520 5465 7374 7320 7573 696e imple Tests usin │ │ │ │ │ +0003c5b0: 6720 7061 7261 6c6c 656c 2d74 6573 7473 g parallel-tests │ │ │ │ │ +0003c5c0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 0003c5d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c5e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c5f0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0003c600: 6c69 6e65 2020 3237 290a 2a20 5445 5354 line 27).* TEST │ │ │ │ │ -0003c610: 5f4c 4f47 533a 2020 2020 2020 2020 2020 _LOGS: │ │ │ │ │ +0003c5f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003c600: 286c 696e 6520 2032 3729 0a2a 2054 4553 (line 27).* TES │ │ │ │ │ +0003c610: 545f 4c4f 4753 3a20 2020 2020 2020 2020 T_LOGS: │ │ │ │ │ 0003c620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c630: 2020 2053 696d 706c 6520 5465 7374 7320 Simple Tests │ │ │ │ │ -0003c640: 7573 696e 6720 7061 7261 6c6c 656c 2d74 using parallel-t │ │ │ │ │ -0003c650: 6573 7473 2e0a 2020 2020 2020 2020 2020 ests.. │ │ │ │ │ +0003c630: 2020 2020 5369 6d70 6c65 2054 6573 7473 Simple Tests │ │ │ │ │ +0003c640: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ +0003c650: 7465 7374 732e 0a20 2020 2020 2020 2020 tests.. │ │ │ │ │ 0003c660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c690: 2020 2020 286c 696e 6520 2032 3729 0a2a (line 27).* │ │ │ │ │ -0003c6a0: 2054 4553 545f 5355 4954 455f 4854 4d4c TEST_SUITE_HTML │ │ │ │ │ -0003c6b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003c6c0: 2020 2020 2020 2020 5369 6d70 6c65 2054 Simple T │ │ │ │ │ -0003c6d0: 6573 7473 2075 7369 6e67 2070 6172 616c ests using paral │ │ │ │ │ -0003c6e0: 6c65 6c2d 7465 7374 732e 0a20 2020 2020 lel-tests.. │ │ │ │ │ +0003c690: 2020 2020 2028 6c69 6e65 2020 3237 290a (line 27). │ │ │ │ │ +0003c6a0: 2a20 5445 5354 5f53 5549 5445 5f48 544d * TEST_SUITE_HTM │ │ │ │ │ +0003c6b0: 4c3a 2020 2020 2020 2020 2020 2020 2020 L: │ │ │ │ │ +0003c6c0: 2020 2020 2020 2020 2053 696d 706c 6520 Simple │ │ │ │ │ +0003c6d0: 5465 7374 7320 7573 696e 6720 7061 7261 Tests using para │ │ │ │ │ +0003c6e0: 6c6c 656c 2d74 6573 7473 2e0a 2020 2020 llel-tests.. │ │ │ │ │ 0003c6f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c720: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003c730: 3730 290a 2a20 5445 5354 5f53 5549 5445 70).* TEST_SUITE │ │ │ │ │ -0003c740: 5f4c 4f47 3a20 2020 2020 2020 2020 2020 _LOG: │ │ │ │ │ -0003c750: 2020 2020 2020 2020 2020 2020 2053 696d Sim │ │ │ │ │ -0003c760: 706c 6520 5465 7374 7320 7573 696e 6720 ple Tests using │ │ │ │ │ -0003c770: 7061 7261 6c6c 656c 2d74 6573 7473 2e0a parallel-tests.. │ │ │ │ │ -0003c780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003c720: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003c730: 2037 3029 0a2a 2054 4553 545f 5355 4954 70).* TEST_SUIT │ │ │ │ │ +0003c740: 455f 4c4f 473a 2020 2020 2020 2020 2020 E_LOG: │ │ │ │ │ +0003c750: 2020 2020 2020 2020 2020 2020 2020 5369 Si │ │ │ │ │ +0003c760: 6d70 6c65 2054 6573 7473 2075 7369 6e67 mple Tests using │ │ │ │ │ +0003c770: 2070 6172 616c 6c65 6c2d 7465 7374 732e parallel-tests. │ │ │ │ │ +0003c780: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 0003c790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c7a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c7b0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -0003c7c0: 696e 6520 2032 3129 0a2a 2054 4558 4932 ine 21).* TEXI2 │ │ │ │ │ -0003c7d0: 4456 493a 2020 2020 2020 2020 2020 2020 DVI: │ │ │ │ │ +0003c7b0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +0003c7c0: 6c69 6e65 2020 3231 290a 2a20 5445 5849 line 21).* TEXI │ │ │ │ │ +0003c7d0: 3244 5649 3a20 2020 2020 2020 2020 2020 2DVI: │ │ │ │ │ 0003c7e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c7f0: 2020 5465 7869 6e66 6f2e 2020 2020 2020 Texinfo. │ │ │ │ │ -0003c800: 2020 2020 2020 2028 6c69 6e65 2031 3236 (line 126 │ │ │ │ │ -0003c810: 290a 2a20 5445 5849 3250 4446 3a20 2020 ).* TEXI2PDF: │ │ │ │ │ +0003c7f0: 2020 2054 6578 696e 666f 2e20 2020 2020 Texinfo. │ │ │ │ │ +0003c800: 2020 2020 2020 2020 286c 696e 6520 3132 (line 12 │ │ │ │ │ +0003c810: 3629 0a2a 2054 4558 4932 5044 463a 2020 6).* TEXI2PDF: │ │ │ │ │ 0003c820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c830: 2020 2020 2020 2020 2020 2054 6578 696e Texin │ │ │ │ │ -0003c840: 666f 2e20 2020 2020 2020 2020 2020 2020 fo. │ │ │ │ │ -0003c850: 286c 696e 6520 3133 3129 0a2a 2054 4558 (line 131).* TEX │ │ │ │ │ -0003c860: 494e 464f 533a 2020 2020 2020 2020 2020 INFOS: │ │ │ │ │ +0003c830: 2020 2020 2020 2020 2020 2020 5465 7869 Texi │ │ │ │ │ +0003c840: 6e66 6f2e 2020 2020 2020 2020 2020 2020 nfo. │ │ │ │ │ +0003c850: 2028 6c69 6e65 2031 3331 290a 2a20 5445 (line 131).* TE │ │ │ │ │ +0003c860: 5849 4e46 4f53 3a20 2020 2020 2020 2020 XINFOS: │ │ │ │ │ 0003c870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c880: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ -0003c890: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ -0003c8a0: 3032 290a 2a20 5445 5849 4e46 4f53 203c 02).* TEXINFOS < │ │ │ │ │ -0003c8b0: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ -0003c8c0: 2020 2020 2020 2020 2020 2020 2054 6578 Tex │ │ │ │ │ -0003c8d0: 696e 666f 2e20 2020 2020 2020 2020 2020 info. │ │ │ │ │ -0003c8e0: 2020 286c 696e 6520 2035 3929 0a2a 2054 (line 59).* T │ │ │ │ │ -0003c8f0: 4558 494e 464f 5f54 4558 3a20 2020 2020 EXINFO_TEX: │ │ │ │ │ +0003c880: 2020 2020 2055 6e69 666f 726d 2e20 2020 Uniform. │ │ │ │ │ +0003c890: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003c8a0: 3130 3229 0a2a 2054 4558 494e 464f 5320 102).* TEXINFOS │ │ │ │ │ +0003c8b0: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +0003c8c0: 2020 2020 2020 2020 2020 2020 2020 5465 Te │ │ │ │ │ +0003c8d0: 7869 6e66 6f2e 2020 2020 2020 2020 2020 xinfo. │ │ │ │ │ +0003c8e0: 2020 2028 6c69 6e65 2020 3539 290a 2a20 (line 59).* │ │ │ │ │ +0003c8f0: 5445 5849 4e46 4f5f 5445 583a 2020 2020 TEXINFO_TEX: │ │ │ │ │ 0003c900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c910: 2020 2020 2020 5465 7869 6e66 6f2e 2020 Texinfo. │ │ │ │ │ -0003c920: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003c930: 2031 3339 290a 2a20 746f 705f 6469 7374 139).* top_dist │ │ │ │ │ -0003c940: 6469 723a 2020 2020 2020 2020 2020 2020 dir: │ │ │ │ │ -0003c950: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -0003c960: 6865 2064 6973 7420 486f 6f6b 2e20 2020 he dist Hook. │ │ │ │ │ -0003c970: 2020 2020 286c 696e 6520 2032 3429 0a2a (line 24).* │ │ │ │ │ -0003c980: 2074 6f70 5f64 6973 7464 6972 203c 313e top_distdir <1> │ │ │ │ │ -0003c990: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003c9a0: 2020 2020 2020 2020 5468 6972 642d 5061 Third-Pa │ │ │ │ │ -0003c9b0: 7274 7920 4d61 6b65 6669 6c65 732e 0a20 rty Makefiles.. │ │ │ │ │ +0003c910: 2020 2020 2020 2054 6578 696e 666f 2e20 Texinfo. │ │ │ │ │ +0003c920: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003c930: 6520 3133 3929 0a2a 2074 6f70 5f64 6973 e 139).* top_dis │ │ │ │ │ +0003c940: 7464 6972 3a20 2020 2020 2020 2020 2020 tdir: │ │ │ │ │ +0003c950: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003c960: 5468 6520 6469 7374 2048 6f6f 6b2e 2020 The dist Hook. │ │ │ │ │ +0003c970: 2020 2020 2028 6c69 6e65 2020 3234 290a (line 24). │ │ │ │ │ +0003c980: 2a20 746f 705f 6469 7374 6469 7220 3c31 * top_distdir <1 │ │ │ │ │ +0003c990: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +0003c9a0: 2020 2020 2020 2020 2054 6869 7264 2d50 Third-P │ │ │ │ │ +0003c9b0: 6172 7479 204d 616b 6566 696c 6573 2e0a arty Makefiles.. │ │ │ │ │ 0003c9c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c9d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003c9e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003c9f0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003ca00: 6e65 2020 3235 290a 2a20 553a 2020 2020 ne 25).* U: │ │ │ │ │ +0003c9f0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0003ca00: 696e 6520 2032 3529 0a2a 2055 3a20 2020 ine 25).* U: │ │ │ │ │ 0003ca10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ca20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ca30: 204f 6273 6f6c 6574 6520 4d61 6372 6f73 Obsolete Macros │ │ │ │ │ -0003ca40: 2e20 2020 2020 286c 696e 6520 2031 3329 . (line 13) │ │ │ │ │ -0003ca50: 0a2a 2055 5043 3a20 2020 2020 2020 2020 .* UPC: │ │ │ │ │ +0003ca30: 2020 4f62 736f 6c65 7465 204d 6163 726f Obsolete Macro │ │ │ │ │ +0003ca40: 732e 2020 2020 2028 6c69 6e65 2020 3133 s. (line 13 │ │ │ │ │ +0003ca50: 290a 2a20 5550 433a 2020 2020 2020 2020 ).* UPC: │ │ │ │ │ 0003ca60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ca70: 2020 2020 2020 2020 2020 5075 626c 6963 Public │ │ │ │ │ -0003ca80: 204d 6163 726f 732e 2020 2020 2020 2028 Macros. ( │ │ │ │ │ -0003ca90: 6c69 6e65 2031 3039 290a 2a20 5550 4320 line 109).* UPC │ │ │ │ │ -0003caa0: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +0003ca70: 2020 2020 2020 2020 2020 2050 7562 6c69 Publi │ │ │ │ │ +0003ca80: 6320 4d61 6372 6f73 2e20 2020 2020 2020 c Macros. │ │ │ │ │ +0003ca90: 286c 696e 6520 3130 3929 0a2a 2055 5043 (line 109).* UPC │ │ │ │ │ +0003caa0: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ 0003cab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cac0: 2020 2055 6e69 6669 6564 2050 6172 616c Unified Paral │ │ │ │ │ -0003cad0: 6c65 6c20 4320 5375 7070 6f72 742e 0a20 lel C Support.. │ │ │ │ │ +0003cac0: 2020 2020 556e 6966 6965 6420 5061 7261 Unified Para │ │ │ │ │ +0003cad0: 6c6c 656c 2043 2053 7570 706f 7274 2e0a llel C Support.. │ │ │ │ │ 0003cae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003caf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cb00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cb10: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003cb20: 6e65 2020 3135 290a 2a20 5550 4343 4f4d ne 15).* UPCCOM │ │ │ │ │ -0003cb30: 5049 4c45 3a20 2020 2020 2020 2020 2020 PILE: │ │ │ │ │ +0003cb10: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0003cb20: 696e 6520 2031 3529 0a2a 2055 5043 434f ine 15).* UPCCO │ │ │ │ │ +0003cb30: 4d50 494c 453a 2020 2020 2020 2020 2020 MPILE: │ │ │ │ │ 0003cb40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cb50: 2055 6e69 6669 6564 2050 6172 616c 6c65 Unified Paralle │ │ │ │ │ -0003cb60: 6c20 4320 5375 7070 6f72 742e 0a20 2020 l C Support.. │ │ │ │ │ +0003cb50: 2020 556e 6966 6965 6420 5061 7261 6c6c Unified Parall │ │ │ │ │ +0003cb60: 656c 2043 2053 7570 706f 7274 2e0a 2020 el C Support.. │ │ │ │ │ 0003cb70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cb80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cb90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cba0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003cbb0: 2020 3234 290a 2a20 5550 4346 4c41 4753 24).* UPCFLAGS │ │ │ │ │ -0003cbc0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003cbd0: 2020 2020 2020 2020 2020 2020 2020 2055 U │ │ │ │ │ -0003cbe0: 6e69 6669 6564 2050 6172 616c 6c65 6c20 nified Parallel │ │ │ │ │ -0003cbf0: 4320 5375 7070 6f72 742e 0a20 2020 2020 C Support.. │ │ │ │ │ +0003cba0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003cbb0: 6520 2032 3429 0a2a 2055 5043 464c 4147 e 24).* UPCFLAG │ │ │ │ │ +0003cbc0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +0003cbd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003cbe0: 556e 6966 6965 6420 5061 7261 6c6c 656c Unified Parallel │ │ │ │ │ +0003cbf0: 2043 2053 7570 706f 7274 2e0a 2020 2020 C Support.. │ │ │ │ │ 0003cc00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cc10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cc20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cc30: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003cc40: 3138 290a 2a20 5550 434c 494e 4b3a 2020 18).* UPCLINK: │ │ │ │ │ +0003cc30: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003cc40: 2031 3829 0a2a 2055 5043 4c49 4e4b 3a20 18).* UPCLINK: │ │ │ │ │ 0003cc50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cc60: 2020 2020 2020 2020 2020 2020 2055 6e69 Uni │ │ │ │ │ -0003cc70: 6669 6564 2050 6172 616c 6c65 6c20 4320 fied Parallel C │ │ │ │ │ -0003cc80: 5375 7070 6f72 742e 0a20 2020 2020 2020 Support.. │ │ │ │ │ +0003cc60: 2020 2020 2020 2020 2020 2020 2020 556e Un │ │ │ │ │ +0003cc70: 6966 6965 6420 5061 7261 6c6c 656c 2043 ified Parallel C │ │ │ │ │ +0003cc80: 2053 7570 706f 7274 2e0a 2020 2020 2020 Support.. │ │ │ │ │ 0003cc90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ccb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ccc0: 2020 2020 2020 2028 6c69 6e65 2020 3238 (line 28 │ │ │ │ │ -0003ccd0: 290a 2a20 5550 434c 494e 4b20 3c31 3e3a ).* UPCLINK <1>: │ │ │ │ │ -0003cce0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ccf0: 2020 2020 2020 2020 2020 2048 6f77 2074 How t │ │ │ │ │ -0003cd00: 6865 204c 696e 6b65 7220 6973 2043 686f he Linker is Cho │ │ │ │ │ -0003cd10: 7365 6e2e 0a20 2020 2020 2020 2020 2020 sen.. │ │ │ │ │ +0003ccc0: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +0003ccd0: 3829 0a2a 2055 5043 4c49 4e4b 203c 313e 8).* UPCLINK <1> │ │ │ │ │ +0003cce0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003ccf0: 2020 2020 2020 2020 2020 2020 486f 7720 How │ │ │ │ │ +0003cd00: 7468 6520 4c69 6e6b 6572 2069 7320 4368 the Linker is Ch │ │ │ │ │ +0003cd10: 6f73 656e 2e0a 2020 2020 2020 2020 2020 osen.. │ │ │ │ │ 0003cd20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cd30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cd40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cd50: 2020 2028 6c69 6e65 2020 3135 290a 2a20 (line 15).* │ │ │ │ │ -0003cd60: 563a 2020 2020 2020 2020 2020 2020 2020 V: │ │ │ │ │ +0003cd50: 2020 2020 286c 696e 6520 2031 3529 0a2a (line 15).* │ │ │ │ │ +0003cd60: 2056 3a20 2020 2020 2020 2020 2020 2020 V: │ │ │ │ │ 0003cd70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cd80: 2020 2020 2020 2041 7574 6f6d 616b 6520 Automake │ │ │ │ │ -0003cd90: 7369 6c65 6e74 2d72 756c 6573 204f 7074 silent-rules Opt │ │ │ │ │ -0003cda0: 696f 6e2e 0a20 2020 2020 2020 2020 2020 ion.. │ │ │ │ │ +0003cd80: 2020 2020 2020 2020 4175 746f 6d61 6b65 Automake │ │ │ │ │ +0003cd90: 2073 696c 656e 742d 7275 6c65 7320 4f70 silent-rules Op │ │ │ │ │ +0003cda0: 7469 6f6e 2e0a 2020 2020 2020 2020 2020 tion.. │ │ │ │ │ 0003cdb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cdc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cdd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cde0: 2020 2028 6c69 6e65 2031 3032 290a 2a20 (line 102).* │ │ │ │ │ -0003cdf0: 5641 4c41 433a 2020 2020 2020 2020 2020 VALAC: │ │ │ │ │ +0003cde0: 2020 2020 286c 696e 6520 3130 3229 0a2a (line 102).* │ │ │ │ │ +0003cdf0: 2056 414c 4143 3a20 2020 2020 2020 2020 VALAC: │ │ │ │ │ 0003ce00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ce10: 2020 2020 2020 2056 616c 6120 5375 7070 Vala Supp │ │ │ │ │ -0003ce20: 6f72 742e 2020 2020 2020 2020 286c 696e ort. (lin │ │ │ │ │ -0003ce30: 6520 2032 3929 0a2a 2056 414c 4146 4c41 e 29).* VALAFLA │ │ │ │ │ -0003ce40: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ +0003ce10: 2020 2020 2020 2020 5661 6c61 2053 7570 Vala Sup │ │ │ │ │ +0003ce20: 706f 7274 2e20 2020 2020 2020 2028 6c69 port. (li │ │ │ │ │ +0003ce30: 6e65 2020 3239 290a 2a20 5641 4c41 464c ne 29).* VALAFL │ │ │ │ │ +0003ce40: 4147 533a 2020 2020 2020 2020 2020 2020 AGS: │ │ │ │ │ 0003ce50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ce60: 5661 6c61 2053 7570 706f 7274 2e20 2020 Vala Support. │ │ │ │ │ -0003ce70: 2020 2020 2028 6c69 6e65 2020 3332 290a (line 32). │ │ │ │ │ -0003ce80: 2a20 5645 5242 4f53 453a 2020 2020 2020 * VERBOSE: │ │ │ │ │ +0003ce60: 2056 616c 6120 5375 7070 6f72 742e 2020 Vala Support. │ │ │ │ │ +0003ce70: 2020 2020 2020 286c 696e 6520 2033 3229 (line 32) │ │ │ │ │ +0003ce80: 0a2a 2056 4552 424f 5345 3a20 2020 2020 .* VERBOSE: │ │ │ │ │ 0003ce90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cea0: 2020 2020 2020 2020 2053 696d 706c 6520 Simple │ │ │ │ │ -0003ceb0: 5465 7374 7320 7573 696e 6720 7061 7261 Tests using para │ │ │ │ │ -0003cec0: 6c6c 656c 2d74 6573 7473 2e0a 2020 2020 llel-tests.. │ │ │ │ │ +0003cea0: 2020 2020 2020 2020 2020 5369 6d70 6c65 Simple │ │ │ │ │ +0003ceb0: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ +0003cec0: 616c 6c65 6c2d 7465 7374 732e 0a20 2020 allel-tests.. │ │ │ │ │ 0003ced0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cee0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cf00: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003cf10: 2036 3129 0a2a 2056 4552 5349 4f4e 3a20 61).* VERSION: │ │ │ │ │ +0003cf00: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003cf10: 2020 3631 290a 2a20 5645 5253 494f 4e3a 61).* VERSION: │ │ │ │ │ 0003cf20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cf30: 2020 2020 2020 2020 2020 2020 2020 4261 Ba │ │ │ │ │ -0003cf40: 7369 6373 206f 6620 4469 7374 7269 6275 sics of Distribu │ │ │ │ │ -0003cf50: 7469 6f6e 2e0a 2020 2020 2020 2020 2020 tion.. │ │ │ │ │ +0003cf30: 2020 2020 2020 2020 2020 2020 2020 2042 B │ │ │ │ │ +0003cf40: 6173 6963 7320 6f66 2044 6973 7472 6962 asics of Distrib │ │ │ │ │ +0003cf50: 7574 696f 6e2e 0a20 2020 2020 2020 2020 ution.. │ │ │ │ │ 0003cf60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cf70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003cf80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cf90: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0003cfa0: 2057 4152 4e49 4e47 533a 2020 2020 2020 WARNINGS: │ │ │ │ │ +0003cf90: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0003cfa0: 2a20 5741 524e 494e 4753 3a20 2020 2020 * WARNINGS: │ │ │ │ │ 0003cfb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cfc0: 2020 2020 2020 2020 6175 746f 6d61 6b65 automake │ │ │ │ │ -0003cfd0: 2049 6e76 6f63 6174 696f 6e2e 2028 6c69 Invocation. (li │ │ │ │ │ -0003cfe0: 6e65 2031 3730 290a 2a20 5741 524e 494e ne 170).* WARNIN │ │ │ │ │ -0003cff0: 4753 203c 313e 3a20 2020 2020 2020 2020 GS <1>: │ │ │ │ │ +0003cfc0: 2020 2020 2020 2020 2061 7574 6f6d 616b automak │ │ │ │ │ +0003cfd0: 6520 496e 766f 6361 7469 6f6e 2e20 286c e Invocation. (l │ │ │ │ │ +0003cfe0: 696e 6520 3137 3029 0a2a 2057 4152 4e49 ine 170).* WARNI │ │ │ │ │ +0003cff0: 4e47 5320 3c31 3e3a 2020 2020 2020 2020 NGS <1>: │ │ │ │ │ 0003d000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d010: 2061 636c 6f63 616c 204f 7074 696f 6e73 aclocal Options │ │ │ │ │ -0003d020: 2e20 2020 2020 286c 696e 6520 2039 3529 . (line 95) │ │ │ │ │ -0003d030: 0a2a 2057 4954 485f 444d 414c 4c4f 433a .* WITH_DMALLOC: │ │ │ │ │ -0003d040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d050: 2020 2020 2020 2020 2020 5075 626c 6963 Public │ │ │ │ │ -0003d060: 204d 6163 726f 732e 2020 2020 2020 2028 Macros. ( │ │ │ │ │ -0003d070: 6c69 6e65 2031 3139 290a 2a20 5749 5448 line 119).* WITH │ │ │ │ │ -0003d080: 5f52 4547 4558 3a20 2020 2020 2020 2020 _REGEX: │ │ │ │ │ +0003d010: 2020 6163 6c6f 6361 6c20 4f70 7469 6f6e aclocal Option │ │ │ │ │ +0003d020: 732e 2020 2020 2028 6c69 6e65 2020 3935 s. (line 95 │ │ │ │ │ +0003d030: 290a 2a20 5749 5448 5f44 4d41 4c4c 4f43 ).* WITH_DMALLOC │ │ │ │ │ +0003d040: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003d050: 2020 2020 2020 2020 2020 2050 7562 6c69 Publi │ │ │ │ │ +0003d060: 6320 4d61 6372 6f73 2e20 2020 2020 2020 c Macros. │ │ │ │ │ +0003d070: 286c 696e 6520 3131 3929 0a2a 2057 4954 (line 119).* WIT │ │ │ │ │ +0003d080: 485f 5245 4745 583a 2020 2020 2020 2020 H_REGEX: │ │ │ │ │ 0003d090: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d0a0: 2020 204f 6273 6f6c 6574 6520 4d61 6372 Obsolete Macr │ │ │ │ │ -0003d0b0: 6f73 2e20 2020 2020 286c 696e 6520 2036 os. (line 6 │ │ │ │ │ -0003d0c0: 3429 0a2a 2058 4641 494c 5f54 4553 5453 4).* XFAIL_TESTS │ │ │ │ │ -0003d0d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003d0e0: 2020 2020 2020 2020 2020 2020 5369 6d70 Simp │ │ │ │ │ -0003d0f0: 6c65 2054 6573 7473 2e20 2020 2020 2020 le Tests. │ │ │ │ │ -0003d100: 2028 6c69 6e65 2020 3531 290a 2a20 585a (line 51).* XZ │ │ │ │ │ -0003d110: 5f4f 5054 3a20 2020 2020 2020 2020 2020 _OPT: │ │ │ │ │ +0003d0a0: 2020 2020 4f62 736f 6c65 7465 204d 6163 Obsolete Mac │ │ │ │ │ +0003d0b0: 726f 732e 2020 2020 2028 6c69 6e65 2020 ros. (line │ │ │ │ │ +0003d0c0: 3634 290a 2a20 5846 4149 4c5f 5445 5354 64).* XFAIL_TEST │ │ │ │ │ +0003d0d0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +0003d0e0: 2020 2020 2020 2020 2020 2020 2053 696d Sim │ │ │ │ │ +0003d0f0: 706c 6520 5465 7374 732e 2020 2020 2020 ple Tests. │ │ │ │ │ +0003d100: 2020 286c 696e 6520 2035 3129 0a2a 2058 (line 51).* X │ │ │ │ │ +0003d110: 5a5f 4f50 543a 2020 2020 2020 2020 2020 Z_OPT: │ │ │ │ │ 0003d120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d130: 2020 2020 2054 6865 2054 7970 6573 206f The Types o │ │ │ │ │ -0003d140: 6620 4469 7374 7269 6275 7469 6f6e 732e f Distributions. │ │ │ │ │ -0003d150: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003d130: 2020 2020 2020 5468 6520 5479 7065 7320 The Types │ │ │ │ │ +0003d140: 6f66 2044 6973 7472 6962 7574 696f 6e73 of Distributions │ │ │ │ │ +0003d150: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 0003d160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003d170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d180: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0003d190: 6c69 6e65 2020 3332 290a 2a20 5941 4343 line 32).* YACC │ │ │ │ │ -0003d1a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003d180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003d190: 286c 696e 6520 2033 3229 0a2a 2059 4143 (line 32).* YAC │ │ │ │ │ +0003d1a0: 433a 2020 2020 2020 2020 2020 2020 2020 C: │ │ │ │ │ 0003d1b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d1c0: 2020 204f 7074 696f 6e61 6c2e 2020 2020 Optional. │ │ │ │ │ -0003d1d0: 2020 2020 2020 2020 286c 696e 6520 3131 (line 11 │ │ │ │ │ -0003d1e0: 3729 0a2a 2059 464c 4147 533a 2020 2020 7).* YFLAGS: │ │ │ │ │ +0003d1c0: 2020 2020 4f70 7469 6f6e 616c 2e20 2020 Optional. │ │ │ │ │ +0003d1d0: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +0003d1e0: 3137 290a 2a20 5946 4c41 4753 3a20 2020 17).* YFLAGS: │ │ │ │ │ 0003d1f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d200: 2020 2020 2020 2020 2020 2020 5961 6363 Yacc │ │ │ │ │ -0003d210: 2061 6e64 204c 6578 2e20 2020 2020 2020 and Lex. │ │ │ │ │ -0003d220: 2028 6c69 6e65 2020 3333 290a 0a1f 0a46 (line 33)....F │ │ │ │ │ -0003d230: 696c 653a 2061 7574 6f6d 616b 652d 312e ile: automake-1. │ │ │ │ │ -0003d240: 3131 2e69 6e66 6f2c 2020 4e6f 6465 3a20 11.info, Node: │ │ │ │ │ -0003d250: 4765 6e65 7261 6c20 496e 6465 782c 2020 General Index, │ │ │ │ │ -0003d260: 5072 6576 3a20 5661 7269 6162 6c65 2049 Prev: Variable I │ │ │ │ │ -0003d270: 6e64 6578 2c20 2055 703a 2049 6e64 6963 ndex, Up: Indic │ │ │ │ │ -0003d280: 6573 0a0a 422e 3320 4765 6e65 7261 6c20 es..B.3 General │ │ │ │ │ -0003d290: 496e 6465 780a 3d3d 3d3d 3d3d 3d3d 3d3d Index.========== │ │ │ │ │ -0003d2a0: 3d3d 3d3d 3d3d 3d0a 0a00 085b 696e 6465 =======....[inde │ │ │ │ │ -0003d2b0: 7800 085d 0a2a 204d 656e 753a 0a0a 2a20 x..].* Menu:..* │ │ │ │ │ -0003d2c0: 2323 2028 7370 6563 6961 6c20 4175 746f ## (special Auto │ │ │ │ │ -0003d2d0: 6d61 6b65 2063 6f6d 6d65 6e74 293a 2020 make comment): │ │ │ │ │ -0003d2e0: 2020 2020 2020 2047 656e 6572 616c 204f General O │ │ │ │ │ -0003d2f0: 7065 7261 7469 6f6e 2e20 2020 286c 696e peration. (lin │ │ │ │ │ -0003d300: 6520 2036 3829 0a2a 2023 7365 7269 616c e 68).* #serial │ │ │ │ │ -0003d310: 2073 796e 7461 783a 2020 2020 2020 2020 syntax: │ │ │ │ │ +0003d200: 2020 2020 2020 2020 2020 2020 2059 6163 Yac │ │ │ │ │ +0003d210: 6320 616e 6420 4c65 782e 2020 2020 2020 c and Lex. │ │ │ │ │ +0003d220: 2020 286c 696e 6520 2033 3329 0a0a 1f0a (line 33).... │ │ │ │ │ +0003d230: 4669 6c65 3a20 6175 746f 6d61 6b65 2d31 File: automake-1 │ │ │ │ │ +0003d240: 2e31 312e 696e 666f 2c20 204e 6f64 653a .11.info, Node: │ │ │ │ │ +0003d250: 2047 656e 6572 616c 2049 6e64 6578 2c20 General Index, │ │ │ │ │ +0003d260: 2050 7265 763a 2056 6172 6961 626c 6520 Prev: Variable │ │ │ │ │ +0003d270: 496e 6465 782c 2020 5570 3a20 496e 6469 Index, Up: Indi │ │ │ │ │ +0003d280: 6365 730a 0a42 2e33 2047 656e 6572 616c ces..B.3 General │ │ │ │ │ +0003d290: 2049 6e64 6578 0a3d 3d3d 3d3d 3d3d 3d3d Index.========= │ │ │ │ │ +0003d2a0: 3d3d 3d3d 3d3d 3d3d 0a0a 0008 5b69 6e64 ========....[ind │ │ │ │ │ +0003d2b0: 6578 0008 5d0a 2a20 4d65 6e75 3a0a 0a2a ex..].* Menu:..* │ │ │ │ │ +0003d2c0: 2023 2320 2873 7065 6369 616c 2041 7574 ## (special Aut │ │ │ │ │ +0003d2d0: 6f6d 616b 6520 636f 6d6d 656e 7429 3a20 omake comment): │ │ │ │ │ +0003d2e0: 2020 2020 2020 2020 4765 6e65 7261 6c20 General │ │ │ │ │ +0003d2f0: 4f70 6572 6174 696f 6e2e 2020 2028 6c69 Operation. (li │ │ │ │ │ +0003d300: 6e65 2020 3638 290a 2a20 2373 6572 6961 ne 68).* #seria │ │ │ │ │ +0003d310: 6c20 7379 6e74 6178 3a20 2020 2020 2020 l syntax: │ │ │ │ │ 0003d320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d330: 5365 7269 616c 732e 2020 2020 2020 2020 Serials. │ │ │ │ │ -0003d340: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -0003d350: 2a20 2428 4c49 424f 424a 5329 2061 6e64 * $(LIBOBJS) and │ │ │ │ │ -0003d360: 2065 6d70 7479 206c 6962 7261 7269 6573 empty libraries │ │ │ │ │ -0003d370: 3a20 2020 2020 2020 204c 4942 4f42 4a53 : LIBOBJS │ │ │ │ │ -0003d380: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -0003d390: 696e 6520 2037 3229 0a2a 202b 3d3a 2020 ine 72).* +=: │ │ │ │ │ +0003d330: 2053 6572 6961 6c73 2e20 2020 2020 2020 Serials. │ │ │ │ │ +0003d340: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +0003d350: 0a2a 2024 284c 4942 4f42 4a53 2920 616e .* $(LIBOBJS) an │ │ │ │ │ +0003d360: 6420 656d 7074 7920 6c69 6272 6172 6965 d empty librarie │ │ │ │ │ +0003d370: 733a 2020 2020 2020 2020 4c49 424f 424a s: LIBOBJ │ │ │ │ │ +0003d380: 532e 2020 2020 2020 2020 2020 2020 2028 S. ( │ │ │ │ │ +0003d390: 6c69 6e65 2020 3732 290a 2a20 2b3d 3a20 line 72).* +=: │ │ │ │ │ 0003d3a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003d3b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d3c0: 2020 4765 6e65 7261 6c20 4f70 6572 6174 General Operat │ │ │ │ │ -0003d3d0: 696f 6e2e 2020 2028 6c69 6e65 2020 3234 ion. (line 24 │ │ │ │ │ -0003d3e0: 290a 2a20 2d2d 6163 6469 723a 2020 2020 ).* --acdir: │ │ │ │ │ +0003d3c0: 2020 2047 656e 6572 616c 204f 7065 7261 General Opera │ │ │ │ │ +0003d3d0: 7469 6f6e 2e20 2020 286c 696e 6520 2032 tion. (line 2 │ │ │ │ │ +0003d3e0: 3429 0a2a 202d 2d61 6364 6972 3a20 2020 4).* --acdir: │ │ │ │ │ 0003d3f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d400: 2020 2020 2020 2020 2020 2061 636c 6f63 acloc │ │ │ │ │ -0003d410: 616c 204f 7074 696f 6e73 2e20 2020 2020 al Options. │ │ │ │ │ -0003d420: 286c 696e 6520 2031 3829 0a2a 202d 2d61 (line 18).* --a │ │ │ │ │ -0003d430: 6464 2d6d 6973 7369 6e67 3a20 2020 2020 dd-missing: │ │ │ │ │ +0003d400: 2020 2020 2020 2020 2020 2020 6163 6c6f aclo │ │ │ │ │ +0003d410: 6361 6c20 4f70 7469 6f6e 732e 2020 2020 cal Options. │ │ │ │ │ +0003d420: 2028 6c69 6e65 2020 3138 290a 2a20 2d2d (line 18).* -- │ │ │ │ │ +0003d430: 6164 642d 6d69 7373 696e 673a 2020 2020 add-missing: │ │ │ │ │ 0003d440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d450: 2020 2020 6175 746f 6d61 6b65 2049 6e76 automake Inv │ │ │ │ │ -0003d460: 6f63 6174 696f 6e2e 2028 6c69 6e65 2020 ocation. (line │ │ │ │ │ -0003d470: 3431 290a 2a20 2d2d 6175 746f 6d61 6b65 41).* --automake │ │ │ │ │ -0003d480: 2d61 6364 6972 3a20 2020 2020 2020 2020 -acdir: │ │ │ │ │ -0003d490: 2020 2020 2020 2020 2020 2020 2061 636c acl │ │ │ │ │ -0003d4a0: 6f63 616c 204f 7074 696f 6e73 2e20 2020 ocal Options. │ │ │ │ │ -0003d4b0: 2020 286c 696e 6520 2020 3929 0a2a 202d (line 9).* - │ │ │ │ │ -0003d4c0: 2d62 7569 6c64 3d42 5549 4c44 3a20 2020 -build=BUILD: │ │ │ │ │ +0003d450: 2020 2020 2061 7574 6f6d 616b 6520 496e automake In │ │ │ │ │ +0003d460: 766f 6361 7469 6f6e 2e20 286c 696e 6520 vocation. (line │ │ │ │ │ +0003d470: 2034 3129 0a2a 202d 2d61 7574 6f6d 616b 41).* --automak │ │ │ │ │ +0003d480: 652d 6163 6469 723a 2020 2020 2020 2020 e-acdir: │ │ │ │ │ +0003d490: 2020 2020 2020 2020 2020 2020 2020 6163 ac │ │ │ │ │ +0003d4a0: 6c6f 6361 6c20 4f70 7469 6f6e 732e 2020 local Options. │ │ │ │ │ +0003d4b0: 2020 2028 6c69 6e65 2020 2039 290a 2a20 (line 9).* │ │ │ │ │ +0003d4c0: 2d2d 6275 696c 643d 4255 494c 443a 2020 --build=BUILD: │ │ │ │ │ 0003d4d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d4e0: 2020 2020 2020 4372 6f73 732d 436f 6d70 Cross-Comp │ │ │ │ │ -0003d4f0: 696c 6174 696f 6e2e 2020 2028 6c69 6e65 ilation. (line │ │ │ │ │ -0003d500: 2020 3134 290a 2a20 2d2d 636f 7079 3a20 14).* --copy: │ │ │ │ │ +0003d4e0: 2020 2020 2020 2043 726f 7373 2d43 6f6d Cross-Com │ │ │ │ │ +0003d4f0: 7069 6c61 7469 6f6e 2e20 2020 286c 696e pilation. (lin │ │ │ │ │ +0003d500: 6520 2031 3429 0a2a 202d 2d63 6f70 793a e 14).* --copy: │ │ │ │ │ 0003d510: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d520: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ -0003d530: 7574 6f6d 616b 6520 496e 766f 6361 7469 utomake Invocati │ │ │ │ │ -0003d540: 6f6e 2e20 286c 696e 6520 2036 3629 0a2a on. (line 66).* │ │ │ │ │ -0003d550: 202d 2d63 7967 6e75 733a 2020 2020 2020 --cygnus: │ │ │ │ │ +0003d520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003d530: 6175 746f 6d61 6b65 2049 6e76 6f63 6174 automake Invocat │ │ │ │ │ +0003d540: 696f 6e2e 2028 6c69 6e65 2020 3636 290a ion. (line 66). │ │ │ │ │ +0003d550: 2a20 2d2d 6379 676e 7573 3a20 2020 2020 * --cygnus: │ │ │ │ │ 0003d560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d570: 2020 2020 2020 2020 6175 746f 6d61 6b65 automake │ │ │ │ │ -0003d580: 2049 6e76 6f63 6174 696f 6e2e 2028 6c69 Invocation. (li │ │ │ │ │ -0003d590: 6e65 2020 3730 290a 2a20 2d2d 6469 6666 ne 70).* --diff │ │ │ │ │ -0003d5a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003d570: 2020 2020 2020 2020 2061 7574 6f6d 616b automak │ │ │ │ │ +0003d580: 6520 496e 766f 6361 7469 6f6e 2e20 286c e Invocation. (l │ │ │ │ │ +0003d590: 696e 6520 2037 3029 0a2a 202d 2d64 6966 ine 70).* --dif │ │ │ │ │ +0003d5a0: 663a 2020 2020 2020 2020 2020 2020 2020 f: │ │ │ │ │ 0003d5b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d5c0: 2061 636c 6f63 616c 204f 7074 696f 6e73 aclocal Options │ │ │ │ │ -0003d5d0: 2e20 2020 2020 286c 696e 6520 2032 3229 . (line 22) │ │ │ │ │ -0003d5e0: 0a2a 202d 2d64 6973 6162 6c65 2d64 6570 .* --disable-dep │ │ │ │ │ -0003d5f0: 656e 6465 6e63 792d 7472 6163 6b69 6e67 endency-tracking │ │ │ │ │ -0003d600: 3a20 2020 2020 2020 2020 4465 7065 6e64 : Depend │ │ │ │ │ -0003d610: 656e 6379 2054 7261 636b 696e 672e 2028 ency Tracking. ( │ │ │ │ │ -0003d620: 6c69 6e65 2020 3333 290a 2a20 2d2d 6469 line 33).* --di │ │ │ │ │ -0003d630: 7361 626c 652d 6d61 696e 7461 696e 6572 sable-maintainer │ │ │ │ │ -0003d640: 2d6d 6f64 653a 2020 2020 2020 2020 2020 -mode: │ │ │ │ │ -0003d650: 2020 204f 7074 696f 6e61 6c2e 2020 2020 Optional. │ │ │ │ │ -0003d660: 2020 2020 2020 2020 286c 696e 6520 3137 (line 17 │ │ │ │ │ -0003d670: 3329 0a2a 202d 2d64 6973 6162 6c65 2d73 3).* --disable-s │ │ │ │ │ -0003d680: 696c 656e 742d 7275 6c65 733a 2020 2020 ilent-rules: │ │ │ │ │ -0003d690: 2020 2020 2020 2020 2020 2020 4175 746f Auto │ │ │ │ │ -0003d6a0: 6d61 6b65 2073 696c 656e 742d 7275 6c65 make silent-rule │ │ │ │ │ -0003d6b0: 7320 4f70 7469 6f6e 2e0a 2020 2020 2020 s Option.. │ │ │ │ │ +0003d5c0: 2020 6163 6c6f 6361 6c20 4f70 7469 6f6e aclocal Option │ │ │ │ │ +0003d5d0: 732e 2020 2020 2028 6c69 6e65 2020 3232 s. (line 22 │ │ │ │ │ +0003d5e0: 290a 2a20 2d2d 6469 7361 626c 652d 6465 ).* --disable-de │ │ │ │ │ +0003d5f0: 7065 6e64 656e 6379 2d74 7261 636b 696e pendency-trackin │ │ │ │ │ +0003d600: 673a 2020 2020 2020 2020 2044 6570 656e g: Depen │ │ │ │ │ +0003d610: 6465 6e63 7920 5472 6163 6b69 6e67 2e20 dency Tracking. │ │ │ │ │ +0003d620: 286c 696e 6520 2033 3329 0a2a 202d 2d64 (line 33).* --d │ │ │ │ │ +0003d630: 6973 6162 6c65 2d6d 6169 6e74 6169 6e65 isable-maintaine │ │ │ │ │ +0003d640: 722d 6d6f 6465 3a20 2020 2020 2020 2020 r-mode: │ │ │ │ │ +0003d650: 2020 2020 4f70 7469 6f6e 616c 2e20 2020 Optional. │ │ │ │ │ +0003d660: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +0003d670: 3733 290a 2a20 2d2d 6469 7361 626c 652d 73).* --disable- │ │ │ │ │ +0003d680: 7369 6c65 6e74 2d72 756c 6573 3a20 2020 silent-rules: │ │ │ │ │ +0003d690: 2020 2020 2020 2020 2020 2020 2041 7574 Aut │ │ │ │ │ +0003d6a0: 6f6d 616b 6520 7369 6c65 6e74 2d72 756c omake silent-rul │ │ │ │ │ +0003d6b0: 6573 204f 7074 696f 6e2e 0a20 2020 2020 es Option.. │ │ │ │ │ 0003d6c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003d6d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003d6e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d6f0: 2020 2020 2020 2020 286c 696e 6520 2039 (line 9 │ │ │ │ │ -0003d700: 3929 0a2a 202d 2d64 7279 2d72 756e 3a20 9).* --dry-run: │ │ │ │ │ +0003d6f0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0003d700: 3939 290a 2a20 2d2d 6472 792d 7275 6e3a 99).* --dry-run: │ │ │ │ │ 0003d710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d720: 2020 2020 2020 2020 2020 2020 6163 6c6f aclo │ │ │ │ │ -0003d730: 6361 6c20 4f70 7469 6f6e 732e 2020 2020 cal Options. │ │ │ │ │ -0003d740: 2028 6c69 6e65 2020 3237 290a 2a20 2d2d (line 27).* -- │ │ │ │ │ -0003d750: 656e 6162 6c65 2d64 6562 7567 2c20 6578 enable-debug, ex │ │ │ │ │ -0003d760: 616d 706c 653a 2020 2020 2020 2020 2020 ample: │ │ │ │ │ -0003d770: 2020 2020 2055 7361 6765 206f 6620 436f Usage of Co │ │ │ │ │ -0003d780: 6e64 6974 696f 6e61 6c73 2e0a 2020 2020 nditionals.. │ │ │ │ │ +0003d720: 2020 2020 2020 2020 2020 2020 2061 636c acl │ │ │ │ │ +0003d730: 6f63 616c 204f 7074 696f 6e73 2e20 2020 ocal Options. │ │ │ │ │ +0003d740: 2020 286c 696e 6520 2032 3729 0a2a 202d (line 27).* - │ │ │ │ │ +0003d750: 2d65 6e61 626c 652d 6465 6275 672c 2065 -enable-debug, e │ │ │ │ │ +0003d760: 7861 6d70 6c65 3a20 2020 2020 2020 2020 xample: │ │ │ │ │ +0003d770: 2020 2020 2020 5573 6167 6520 6f66 2043 Usage of C │ │ │ │ │ +0003d780: 6f6e 6469 7469 6f6e 616c 732e 0a20 2020 onditionals.. │ │ │ │ │ 0003d790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003d7a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003d7b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d7c0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003d7d0: 2032 3129 0a2a 202d 2d65 6e61 626c 652d 21).* --enable- │ │ │ │ │ -0003d7e0: 6465 7065 6e64 656e 6379 2d74 7261 636b dependency-track │ │ │ │ │ -0003d7f0: 696e 673a 2020 2020 2020 2020 2020 4465 ing: De │ │ │ │ │ -0003d800: 7065 6e64 656e 6379 2054 7261 636b 696e pendency Trackin │ │ │ │ │ -0003d810: 672e 2028 6c69 6e65 2020 3433 290a 2a20 g. (line 43).* │ │ │ │ │ -0003d820: 2d2d 656e 6162 6c65 2d6d 6169 6e74 6169 --enable-maintai │ │ │ │ │ -0003d830: 6e65 722d 6d6f 6465 3a20 2020 2020 2020 ner-mode: │ │ │ │ │ -0003d840: 2020 2020 2020 204f 7074 696f 6e61 6c2e Optional. │ │ │ │ │ -0003d850: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0003d860: 6520 3137 3329 0a2a 202d 2d65 6e61 626c e 173).* --enabl │ │ │ │ │ -0003d870: 652d 7369 6c65 6e74 2d72 756c 6573 3a20 e-silent-rules: │ │ │ │ │ +0003d7c0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003d7d0: 2020 3231 290a 2a20 2d2d 656e 6162 6c65 21).* --enable │ │ │ │ │ +0003d7e0: 2d64 6570 656e 6465 6e63 792d 7472 6163 -dependency-trac │ │ │ │ │ +0003d7f0: 6b69 6e67 3a20 2020 2020 2020 2020 2044 king: D │ │ │ │ │ +0003d800: 6570 656e 6465 6e63 7920 5472 6163 6b69 ependency Tracki │ │ │ │ │ +0003d810: 6e67 2e20 286c 696e 6520 2034 3329 0a2a ng. (line 43).* │ │ │ │ │ +0003d820: 202d 2d65 6e61 626c 652d 6d61 696e 7461 --enable-mainta │ │ │ │ │ +0003d830: 696e 6572 2d6d 6f64 653a 2020 2020 2020 iner-mode: │ │ │ │ │ +0003d840: 2020 2020 2020 2020 4f70 7469 6f6e 616c Optional │ │ │ │ │ +0003d850: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ │ +0003d860: 6e65 2031 3733 290a 2a20 2d2d 656e 6162 ne 173).* --enab │ │ │ │ │ +0003d870: 6c65 2d73 696c 656e 742d 7275 6c65 733a le-silent-rules: │ │ │ │ │ 0003d880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d890: 4175 746f 6d61 6b65 2073 696c 656e 742d Automake silent- │ │ │ │ │ -0003d8a0: 7275 6c65 7320 4f70 7469 6f6e 2e0a 2020 rules Option.. │ │ │ │ │ +0003d890: 2041 7574 6f6d 616b 6520 7369 6c65 6e74 Automake silent │ │ │ │ │ +0003d8a0: 2d72 756c 6573 204f 7074 696f 6e2e 0a20 -rules Option.. │ │ │ │ │ 0003d8b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003d8c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003d8d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d8e0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0003d8f0: 6520 2039 3929 0a2a 202d 2d66 6f72 6365 e 99).* --force │ │ │ │ │ -0003d900: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003d8e0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0003d8f0: 6e65 2020 3939 290a 2a20 2d2d 666f 7263 ne 99).* --forc │ │ │ │ │ +0003d900: 653a 2020 2020 2020 2020 2020 2020 2020 e: │ │ │ │ │ 0003d910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d920: 6163 6c6f 6361 6c20 4f70 7469 6f6e 732e aclocal Options. │ │ │ │ │ -0003d930: 2020 2020 2028 6c69 6e65 2020 3439 290a (line 49). │ │ │ │ │ -0003d940: 2a20 2d2d 666f 7263 652d 6d69 7373 696e * --force-missin │ │ │ │ │ -0003d950: 673a 2020 2020 2020 2020 2020 2020 2020 g: │ │ │ │ │ -0003d960: 2020 2020 2020 2020 2061 7574 6f6d 616b automak │ │ │ │ │ -0003d970: 6520 496e 766f 6361 7469 6f6e 2e20 286c e Invocation. (l │ │ │ │ │ -0003d980: 696e 6520 2037 3729 0a2a 202d 2d66 6f72 ine 77).* --for │ │ │ │ │ -0003d990: 6569 676e 3a20 2020 2020 2020 2020 2020 eign: │ │ │ │ │ +0003d920: 2061 636c 6f63 616c 204f 7074 696f 6e73 aclocal Options │ │ │ │ │ +0003d930: 2e20 2020 2020 286c 696e 6520 2034 3929 . (line 49) │ │ │ │ │ +0003d940: 0a2a 202d 2d66 6f72 6365 2d6d 6973 7369 .* --force-missi │ │ │ │ │ +0003d950: 6e67 3a20 2020 2020 2020 2020 2020 2020 ng: │ │ │ │ │ +0003d960: 2020 2020 2020 2020 2020 6175 746f 6d61 automa │ │ │ │ │ +0003d970: 6b65 2049 6e76 6f63 6174 696f 6e2e 2028 ke Invocation. ( │ │ │ │ │ +0003d980: 6c69 6e65 2020 3737 290a 2a20 2d2d 666f line 77).* --fo │ │ │ │ │ +0003d990: 7265 6967 6e3a 2020 2020 2020 2020 2020 reign: │ │ │ │ │ 0003d9a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d9b0: 2020 6175 746f 6d61 6b65 2049 6e76 6f63 automake Invoc │ │ │ │ │ -0003d9c0: 6174 696f 6e2e 2028 6c69 6e65 2020 3833 ation. (line 83 │ │ │ │ │ -0003d9d0: 290a 2a20 2d2d 676e 6974 733a 2020 2020 ).* --gnits: │ │ │ │ │ +0003d9b0: 2020 2061 7574 6f6d 616b 6520 496e 766f automake Invo │ │ │ │ │ +0003d9c0: 6361 7469 6f6e 2e20 286c 696e 6520 2038 cation. (line 8 │ │ │ │ │ +0003d9d0: 3329 0a2a 202d 2d67 6e69 7473 3a20 2020 3).* --gnits: │ │ │ │ │ 0003d9e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d9f0: 2020 2020 2020 2020 2020 2061 7574 6f6d autom │ │ │ │ │ -0003da00: 616b 6520 496e 766f 6361 7469 6f6e 2e20 ake Invocation. │ │ │ │ │ -0003da10: 286c 696e 6520 2038 3729 0a2a 202d 2d67 (line 87).* --g │ │ │ │ │ -0003da20: 6e69 7473 2c20 636f 6d70 6c65 7465 2064 nits, complete d │ │ │ │ │ -0003da30: 6573 6372 6970 7469 6f6e 3a20 2020 2020 escription: │ │ │ │ │ -0003da40: 2020 2020 476e 6974 732e 2020 2020 2020 Gnits. │ │ │ │ │ -0003da50: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003da60: 3239 290a 2a20 2d2d 676e 753a 2020 2020 29).* --gnu: │ │ │ │ │ +0003d9f0: 2020 2020 2020 2020 2020 2020 6175 746f auto │ │ │ │ │ +0003da00: 6d61 6b65 2049 6e76 6f63 6174 696f 6e2e make Invocation. │ │ │ │ │ +0003da10: 2028 6c69 6e65 2020 3837 290a 2a20 2d2d (line 87).* -- │ │ │ │ │ +0003da20: 676e 6974 732c 2063 6f6d 706c 6574 6520 gnits, complete │ │ │ │ │ +0003da30: 6465 7363 7269 7074 696f 6e3a 2020 2020 description: │ │ │ │ │ +0003da40: 2020 2020 2047 6e69 7473 2e20 2020 2020 Gnits. │ │ │ │ │ +0003da50: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003da60: 2032 3929 0a2a 202d 2d67 6e75 3a20 2020 29).* --gnu: │ │ │ │ │ 0003da70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003da80: 2020 2020 2020 2020 2020 2020 2061 7574 aut │ │ │ │ │ -0003da90: 6f6d 616b 6520 496e 766f 6361 7469 6f6e omake Invocation │ │ │ │ │ -0003daa0: 2e20 286c 696e 6520 2039 3129 0a2a 202d . (line 91).* - │ │ │ │ │ -0003dab0: 2d67 6e75 2c20 636f 6d70 6c65 7465 2064 -gnu, complete d │ │ │ │ │ -0003dac0: 6573 6372 6970 7469 6f6e 3a20 2020 2020 escription: │ │ │ │ │ -0003dad0: 2020 2020 2020 476e 6974 732e 2020 2020 Gnits. │ │ │ │ │ -0003dae0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003daf0: 2020 2036 290a 2a20 2d2d 676e 752c 2072 6).* --gnu, r │ │ │ │ │ -0003db00: 6571 7569 7265 6420 6669 6c65 733a 2020 equired files: │ │ │ │ │ -0003db10: 2020 2020 2020 2020 2020 2020 2020 2047 G │ │ │ │ │ -0003db20: 6e69 7473 2e20 2020 2020 2020 2020 2020 nits. │ │ │ │ │ -0003db30: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0003db40: 202d 2d68 656c 703a 2020 2020 2020 2020 --help: │ │ │ │ │ +0003da80: 2020 2020 2020 2020 2020 2020 2020 6175 au │ │ │ │ │ +0003da90: 746f 6d61 6b65 2049 6e76 6f63 6174 696f tomake Invocatio │ │ │ │ │ +0003daa0: 6e2e 2028 6c69 6e65 2020 3931 290a 2a20 n. (line 91).* │ │ │ │ │ +0003dab0: 2d2d 676e 752c 2063 6f6d 706c 6574 6520 --gnu, complete │ │ │ │ │ +0003dac0: 6465 7363 7269 7074 696f 6e3a 2020 2020 description: │ │ │ │ │ +0003dad0: 2020 2020 2020 2047 6e69 7473 2e20 2020 Gnits. │ │ │ │ │ +0003dae0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003daf0: 6520 2020 3629 0a2a 202d 2d67 6e75 2c20 e 6).* --gnu, │ │ │ │ │ +0003db00: 7265 7175 6972 6564 2066 696c 6573 3a20 required files: │ │ │ │ │ +0003db10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003db20: 476e 6974 732e 2020 2020 2020 2020 2020 Gnits. │ │ │ │ │ +0003db30: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0003db40: 2a20 2d2d 6865 6c70 3a20 2020 2020 2020 * --help: │ │ │ │ │ 0003db50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003db60: 2020 2020 2020 2020 6175 746f 6d61 6b65 automake │ │ │ │ │ -0003db70: 2049 6e76 6f63 6174 696f 6e2e 2028 6c69 Invocation. (li │ │ │ │ │ -0003db80: 6e65 2020 3935 290a 2a20 2d2d 6865 6c70 ne 95).* --help │ │ │ │ │ -0003db90: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +0003db60: 2020 2020 2020 2020 2061 7574 6f6d 616b automak │ │ │ │ │ +0003db70: 6520 496e 766f 6361 7469 6f6e 2e20 286c e Invocation. (l │ │ │ │ │ +0003db80: 696e 6520 2039 3529 0a2a 202d 2d68 656c ine 95).* --hel │ │ │ │ │ +0003db90: 7020 3c31 3e3a 2020 2020 2020 2020 2020 p <1>: │ │ │ │ │ 0003dba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003dbb0: 2061 636c 6f63 616c 204f 7074 696f 6e73 aclocal Options │ │ │ │ │ -0003dbc0: 2e20 2020 2020 286c 696e 6520 2033 3129 . (line 31) │ │ │ │ │ -0003dbd0: 0a2a 202d 2d68 656c 7020 6368 6563 6b3a .* --help check: │ │ │ │ │ -0003dbe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003dbf0: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ -0003dc00: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -0003dc10: 6c69 6e65 2031 3532 290a 2a20 2d2d 6865 line 152).* --he │ │ │ │ │ -0003dc20: 6c70 3d72 6563 7572 7369 7665 3a20 2020 lp=recursive: │ │ │ │ │ +0003dbb0: 2020 6163 6c6f 6361 6c20 4f70 7469 6f6e aclocal Option │ │ │ │ │ +0003dbc0: 732e 2020 2020 2028 6c69 6e65 2020 3331 s. (line 31 │ │ │ │ │ +0003dbd0: 290a 2a20 2d2d 6865 6c70 2063 6865 636b ).* --help check │ │ │ │ │ +0003dbe0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003dbf0: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ +0003dc00: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ +0003dc10: 286c 696e 6520 3135 3229 0a2a 202d 2d68 (line 152).* --h │ │ │ │ │ +0003dc20: 656c 703d 7265 6375 7273 6976 653a 2020 elp=recursive: │ │ │ │ │ 0003dc30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003dc40: 2020 204e 6573 7465 6420 5061 636b 6167 Nested Packag │ │ │ │ │ -0003dc50: 6573 2e20 2020 2020 286c 696e 6520 2033 es. (line 3 │ │ │ │ │ -0003dc60: 3029 0a2a 202d 2d68 6f73 743d 484f 5354 0).* --host=HOST │ │ │ │ │ -0003dc70: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003dc80: 2020 2020 2020 2020 2020 2020 4372 6f73 Cros │ │ │ │ │ -0003dc90: 732d 436f 6d70 696c 6174 696f 6e2e 2020 s-Compilation. │ │ │ │ │ -0003dca0: 2028 6c69 6e65 2020 3136 290a 2a20 2d2d (line 16).* -- │ │ │ │ │ -0003dcb0: 696e 636c 7564 652d 6465 7073 3a20 2020 include-deps: │ │ │ │ │ +0003dc40: 2020 2020 4e65 7374 6564 2050 6163 6b61 Nested Packa │ │ │ │ │ +0003dc50: 6765 732e 2020 2020 2028 6c69 6e65 2020 ges. (line │ │ │ │ │ +0003dc60: 3330 290a 2a20 2d2d 686f 7374 3d48 4f53 30).* --host=HOS │ │ │ │ │ +0003dc70: 543a 2020 2020 2020 2020 2020 2020 2020 T: │ │ │ │ │ +0003dc80: 2020 2020 2020 2020 2020 2020 2043 726f Cro │ │ │ │ │ +0003dc90: 7373 2d43 6f6d 7069 6c61 7469 6f6e 2e20 ss-Compilation. │ │ │ │ │ +0003dca0: 2020 286c 696e 6520 2031 3629 0a2a 202d (line 16).* - │ │ │ │ │ +0003dcb0: 2d69 6e63 6c75 6465 2d64 6570 733a 2020 -include-deps: │ │ │ │ │ 0003dcc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003dcd0: 2020 2020 2061 7574 6f6d 616b 6520 496e automake In │ │ │ │ │ -0003dce0: 766f 6361 7469 6f6e 2e20 286c 696e 6520 vocation. (line │ │ │ │ │ -0003dcf0: 3130 3329 0a2a 202d 2d69 6e73 7461 6c6c 103).* --install │ │ │ │ │ -0003dd00: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003dd10: 2020 2020 2020 2020 2020 2020 2020 6163 ac │ │ │ │ │ -0003dd20: 6c6f 6361 6c20 4f70 7469 6f6e 732e 2020 local Options. │ │ │ │ │ -0003dd30: 2020 2028 6c69 6e65 2020 3338 290a 2a20 (line 38).* │ │ │ │ │ -0003dd40: 2d2d 6c69 6264 6972 3a20 2020 2020 2020 --libdir: │ │ │ │ │ +0003dcd0: 2020 2020 2020 6175 746f 6d61 6b65 2049 automake I │ │ │ │ │ +0003dce0: 6e76 6f63 6174 696f 6e2e 2028 6c69 6e65 nvocation. (line │ │ │ │ │ +0003dcf0: 2031 3033 290a 2a20 2d2d 696e 7374 616c 103).* --instal │ │ │ │ │ +0003dd00: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ │ +0003dd10: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +0003dd20: 636c 6f63 616c 204f 7074 696f 6e73 2e20 clocal Options. │ │ │ │ │ +0003dd30: 2020 2020 286c 696e 6520 2033 3829 0a2a (line 38).* │ │ │ │ │ +0003dd40: 202d 2d6c 6962 6469 723a 2020 2020 2020 --libdir: │ │ │ │ │ 0003dd50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003dd60: 2020 2020 2020 2061 7574 6f6d 616b 6520 automake │ │ │ │ │ -0003dd70: 496e 766f 6361 7469 6f6e 2e20 286c 696e Invocation. (lin │ │ │ │ │ -0003dd80: 6520 2036 3129 0a2a 202d 2d6e 6f2d 666f e 61).* --no-fo │ │ │ │ │ -0003dd90: 7263 653a 2020 2020 2020 2020 2020 2020 rce: │ │ │ │ │ +0003dd60: 2020 2020 2020 2020 6175 746f 6d61 6b65 automake │ │ │ │ │ +0003dd70: 2049 6e76 6f63 6174 696f 6e2e 2028 6c69 Invocation. (li │ │ │ │ │ +0003dd80: 6e65 2020 3631 290a 2a20 2d2d 6e6f 2d66 ne 61).* --no-f │ │ │ │ │ +0003dd90: 6f72 6365 3a20 2020 2020 2020 2020 2020 orce: │ │ │ │ │ 0003dda0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ddb0: 6175 746f 6d61 6b65 2049 6e76 6f63 6174 automake Invocat │ │ │ │ │ -0003ddc0: 696f 6e2e 2028 6c69 6e65 2031 3038 290a ion. (line 108). │ │ │ │ │ -0003ddd0: 2a20 2d2d 6f75 7470 7574 3a20 2020 2020 * --output: │ │ │ │ │ +0003ddb0: 2061 7574 6f6d 616b 6520 496e 766f 6361 automake Invoca │ │ │ │ │ +0003ddc0: 7469 6f6e 2e20 286c 696e 6520 3130 3829 tion. (line 108) │ │ │ │ │ +0003ddd0: 0a2a 202d 2d6f 7574 7075 743a 2020 2020 .* --output: │ │ │ │ │ 0003dde0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ddf0: 2020 2020 2020 2020 2061 636c 6f63 616c aclocal │ │ │ │ │ -0003de00: 204f 7074 696f 6e73 2e20 2020 2020 286c Options. (l │ │ │ │ │ -0003de10: 696e 6520 2035 3929 0a2a 202d 2d6f 7574 ine 59).* --out │ │ │ │ │ -0003de20: 7075 742d 6469 723a 2020 2020 2020 2020 put-dir: │ │ │ │ │ +0003ddf0: 2020 2020 2020 2020 2020 6163 6c6f 6361 acloca │ │ │ │ │ +0003de00: 6c20 4f70 7469 6f6e 732e 2020 2020 2028 l Options. ( │ │ │ │ │ +0003de10: 6c69 6e65 2020 3539 290a 2a20 2d2d 6f75 line 59).* --ou │ │ │ │ │ +0003de20: 7470 7574 2d64 6972 3a20 2020 2020 2020 tput-dir: │ │ │ │ │ 0003de30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003de40: 2020 6175 746f 6d61 6b65 2049 6e76 6f63 automake Invoc │ │ │ │ │ -0003de50: 6174 696f 6e2e 2028 6c69 6e65 2031 3135 ation. (line 115 │ │ │ │ │ -0003de60: 290a 2a20 2d2d 7072 6566 6978 3a20 2020 ).* --prefix: │ │ │ │ │ +0003de40: 2020 2061 7574 6f6d 616b 6520 496e 766f automake Invo │ │ │ │ │ +0003de50: 6361 7469 6f6e 2e20 286c 696e 6520 3131 cation. (line 11 │ │ │ │ │ +0003de60: 3529 0a2a 202d 2d70 7265 6669 783a 2020 5).* --prefix: │ │ │ │ │ 0003de70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003de80: 2020 2020 2020 2020 2020 2053 7461 6e64 Stand │ │ │ │ │ -0003de90: 6172 6420 4469 7265 6374 6f72 7920 5661 ard Directory Va │ │ │ │ │ -0003dea0: 7269 6162 6c65 732e 0a20 2020 2020 2020 riables.. │ │ │ │ │ +0003de80: 2020 2020 2020 2020 2020 2020 5374 616e Stan │ │ │ │ │ +0003de90: 6461 7264 2044 6972 6563 746f 7279 2056 dard Directory V │ │ │ │ │ +0003dea0: 6172 6961 626c 6573 2e0a 2020 2020 2020 ariables.. │ │ │ │ │ 0003deb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003dec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ded0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003dee0: 2020 2020 2020 2028 6c69 6e65 2020 3333 (line 33 │ │ │ │ │ -0003def0: 290a 2a20 2d2d 7072 696e 742d 6163 2d64 ).* --print-ac-d │ │ │ │ │ -0003df00: 6972 3a20 2020 2020 2020 2020 2020 2020 ir: │ │ │ │ │ -0003df10: 2020 2020 2020 2020 2020 2061 636c 6f63 acloc │ │ │ │ │ -0003df20: 616c 204f 7074 696f 6e73 2e20 2020 2020 al Options. │ │ │ │ │ -0003df30: 286c 696e 6520 2036 3229 0a2a 202d 2d70 (line 62).* --p │ │ │ │ │ -0003df40: 726f 6772 616d 2d70 7265 6669 783d 5052 rogram-prefix=PR │ │ │ │ │ -0003df50: 4546 4958 3a20 2020 2020 2020 2020 2020 EFIX: │ │ │ │ │ -0003df60: 2020 2020 5265 6e61 6d69 6e67 2e20 2020 Renaming. │ │ │ │ │ -0003df70: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003df80: 3136 290a 2a20 2d2d 7072 6f67 7261 6d2d 16).* --program- │ │ │ │ │ -0003df90: 7375 6666 6978 3d53 5546 4649 583a 2020 suffix=SUFFIX: │ │ │ │ │ -0003dfa0: 2020 2020 2020 2020 2020 2020 2052 656e Ren │ │ │ │ │ -0003dfb0: 616d 696e 672e 2020 2020 2020 2020 2020 aming. │ │ │ │ │ -0003dfc0: 2020 286c 696e 6520 2031 3829 0a2a 202d (line 18).* - │ │ │ │ │ -0003dfd0: 2d70 726f 6772 616d 2d74 7261 6e73 666f -program-transfo │ │ │ │ │ -0003dfe0: 726d 2d6e 616d 653d 5052 4f47 5241 4d3a rm-name=PROGRAM: │ │ │ │ │ -0003dff0: 2020 2020 2020 5265 6e61 6d69 6e67 2e20 Renaming. │ │ │ │ │ -0003e000: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003e010: 2020 3230 290a 2a20 2d2d 7379 7374 656d 20).* --system │ │ │ │ │ -0003e020: 2d61 6364 6972 3a20 2020 2020 2020 2020 -acdir: │ │ │ │ │ -0003e030: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ -0003e040: 636c 6f63 616c 204f 7074 696f 6e73 2e20 clocal Options. │ │ │ │ │ -0003e050: 2020 2020 286c 696e 6520 2031 3329 0a2a (line 13).* │ │ │ │ │ -0003e060: 202d 2d74 6172 6765 743d 5441 5247 4554 --target=TARGET │ │ │ │ │ -0003e070: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003e080: 2020 2020 2020 2020 4372 6f73 732d 436f Cross-Co │ │ │ │ │ -0003e090: 6d70 696c 6174 696f 6e2e 2020 2028 6c69 mpilation. (li │ │ │ │ │ -0003e0a0: 6e65 2020 3535 290a 2a20 2d2d 7665 7262 ne 55).* --verb │ │ │ │ │ -0003e0b0: 6f73 653a 2020 2020 2020 2020 2020 2020 ose: │ │ │ │ │ +0003dee0: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ +0003def0: 3329 0a2a 202d 2d70 7269 6e74 2d61 632d 3).* --print-ac- │ │ │ │ │ +0003df00: 6469 723a 2020 2020 2020 2020 2020 2020 dir: │ │ │ │ │ +0003df10: 2020 2020 2020 2020 2020 2020 6163 6c6f aclo │ │ │ │ │ +0003df20: 6361 6c20 4f70 7469 6f6e 732e 2020 2020 cal Options. │ │ │ │ │ +0003df30: 2028 6c69 6e65 2020 3632 290a 2a20 2d2d (line 62).* -- │ │ │ │ │ +0003df40: 7072 6f67 7261 6d2d 7072 6566 6978 3d50 program-prefix=P │ │ │ │ │ +0003df50: 5245 4649 583a 2020 2020 2020 2020 2020 REFIX: │ │ │ │ │ +0003df60: 2020 2020 2052 656e 616d 696e 672e 2020 Renaming. │ │ │ │ │ +0003df70: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003df80: 2031 3629 0a2a 202d 2d70 726f 6772 616d 16).* --program │ │ │ │ │ +0003df90: 2d73 7566 6669 783d 5355 4646 4958 3a20 -suffix=SUFFIX: │ │ │ │ │ +0003dfa0: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ │ +0003dfb0: 6e61 6d69 6e67 2e20 2020 2020 2020 2020 naming. │ │ │ │ │ +0003dfc0: 2020 2028 6c69 6e65 2020 3138 290a 2a20 (line 18).* │ │ │ │ │ +0003dfd0: 2d2d 7072 6f67 7261 6d2d 7472 616e 7366 --program-transf │ │ │ │ │ +0003dfe0: 6f72 6d2d 6e61 6d65 3d50 524f 4752 414d orm-name=PROGRAM │ │ │ │ │ +0003dff0: 3a20 2020 2020 2052 656e 616d 696e 672e : Renaming. │ │ │ │ │ +0003e000: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003e010: 6520 2032 3029 0a2a 202d 2d73 7973 7465 e 20).* --syste │ │ │ │ │ +0003e020: 6d2d 6163 6469 723a 2020 2020 2020 2020 m-acdir: │ │ │ │ │ +0003e030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003e040: 6163 6c6f 6361 6c20 4f70 7469 6f6e 732e aclocal Options. │ │ │ │ │ +0003e050: 2020 2020 2028 6c69 6e65 2020 3133 290a (line 13). │ │ │ │ │ +0003e060: 2a20 2d2d 7461 7267 6574 3d54 4152 4745 * --target=TARGE │ │ │ │ │ +0003e070: 543a 2020 2020 2020 2020 2020 2020 2020 T: │ │ │ │ │ +0003e080: 2020 2020 2020 2020 2043 726f 7373 2d43 Cross-C │ │ │ │ │ +0003e090: 6f6d 7069 6c61 7469 6f6e 2e20 2020 286c ompilation. (l │ │ │ │ │ +0003e0a0: 696e 6520 2035 3529 0a2a 202d 2d76 6572 ine 55).* --ver │ │ │ │ │ +0003e0b0: 626f 7365 3a20 2020 2020 2020 2020 2020 bose: │ │ │ │ │ 0003e0c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e0d0: 2061 7574 6f6d 616b 6520 496e 766f 6361 automake Invoca │ │ │ │ │ -0003e0e0: 7469 6f6e 2e20 286c 696e 6520 3132 3229 tion. (line 122) │ │ │ │ │ -0003e0f0: 0a2a 202d 2d76 6572 626f 7365 203c 313e .* --verbose <1> │ │ │ │ │ -0003e100: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003e110: 2020 2020 2020 2020 2020 6163 6c6f 6361 acloca │ │ │ │ │ -0003e120: 6c20 4f70 7469 6f6e 732e 2020 2020 2028 l Options. ( │ │ │ │ │ -0003e130: 6c69 6e65 2020 3733 290a 2a20 2d2d 7665 line 73).* --ve │ │ │ │ │ -0003e140: 7273 696f 6e3a 2020 2020 2020 2020 2020 rsion: │ │ │ │ │ +0003e0d0: 2020 6175 746f 6d61 6b65 2049 6e76 6f63 automake Invoc │ │ │ │ │ +0003e0e0: 6174 696f 6e2e 2028 6c69 6e65 2031 3232 ation. (line 122 │ │ │ │ │ +0003e0f0: 290a 2a20 2d2d 7665 7262 6f73 6520 3c31 ).* --verbose <1 │ │ │ │ │ +0003e100: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +0003e110: 2020 2020 2020 2020 2020 2061 636c 6f63 acloc │ │ │ │ │ +0003e120: 616c 204f 7074 696f 6e73 2e20 2020 2020 al Options. │ │ │ │ │ +0003e130: 286c 696e 6520 2037 3329 0a2a 202d 2d76 (line 73).* --v │ │ │ │ │ +0003e140: 6572 7369 6f6e 3a20 2020 2020 2020 2020 ersion: │ │ │ │ │ 0003e150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e160: 2020 2061 7574 6f6d 616b 6520 496e 766f automake Invo │ │ │ │ │ -0003e170: 6361 7469 6f6e 2e20 286c 696e 6520 3132 cation. (line 12 │ │ │ │ │ -0003e180: 3629 0a2a 202d 2d76 6572 7369 6f6e 203c 6).* --version < │ │ │ │ │ -0003e190: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ -0003e1a0: 2020 2020 2020 2020 2020 2020 6163 6c6f aclo │ │ │ │ │ -0003e1b0: 6361 6c20 4f70 7469 6f6e 732e 2020 2020 cal Options. │ │ │ │ │ -0003e1c0: 2028 6c69 6e65 2020 3736 290a 2a20 2d2d (line 76).* -- │ │ │ │ │ -0003e1d0: 7665 7273 696f 6e20 6368 6563 6b3a 2020 version check: │ │ │ │ │ +0003e160: 2020 2020 6175 746f 6d61 6b65 2049 6e76 automake Inv │ │ │ │ │ +0003e170: 6f63 6174 696f 6e2e 2028 6c69 6e65 2031 ocation. (line 1 │ │ │ │ │ +0003e180: 3236 290a 2a20 2d2d 7665 7273 696f 6e20 26).* --version │ │ │ │ │ +0003e190: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +0003e1a0: 2020 2020 2020 2020 2020 2020 2061 636c acl │ │ │ │ │ +0003e1b0: 6f63 616c 204f 7074 696f 6e73 2e20 2020 ocal Options. │ │ │ │ │ +0003e1c0: 2020 286c 696e 6520 2037 3629 0a2a 202d (line 76).* - │ │ │ │ │ +0003e1d0: 2d76 6572 7369 6f6e 2063 6865 636b 3a20 -version check: │ │ │ │ │ 0003e1e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e1f0: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ -0003e200: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003e210: 3135 3229 0a2a 202d 2d77 6172 6e69 6e67 152).* --warning │ │ │ │ │ -0003e220: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ -0003e230: 2020 2020 2020 2020 2020 2020 2020 6175 au │ │ │ │ │ -0003e240: 746f 6d61 6b65 2049 6e76 6f63 6174 696f tomake Invocatio │ │ │ │ │ -0003e250: 6e2e 2028 6c69 6e65 2031 3330 290a 2a20 n. (line 130).* │ │ │ │ │ -0003e260: 2d2d 7761 726e 696e 6773 203c 313e 3a20 --warnings <1>: │ │ │ │ │ +0003e1f0: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ +0003e200: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003e210: 2031 3532 290a 2a20 2d2d 7761 726e 696e 152).* --warnin │ │ │ │ │ +0003e220: 6773 3a20 2020 2020 2020 2020 2020 2020 gs: │ │ │ │ │ +0003e230: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +0003e240: 7574 6f6d 616b 6520 496e 766f 6361 7469 utomake Invocati │ │ │ │ │ +0003e250: 6f6e 2e20 286c 696e 6520 3133 3029 0a2a on. (line 130).* │ │ │ │ │ +0003e260: 202d 2d77 6172 6e69 6e67 7320 3c31 3e3a --warnings <1>: │ │ │ │ │ 0003e270: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e280: 2020 2020 2020 2061 636c 6f63 616c 204f aclocal O │ │ │ │ │ -0003e290: 7074 696f 6e73 2e20 2020 2020 286c 696e ptions. (lin │ │ │ │ │ -0003e2a0: 6520 2038 3029 0a2a 202d 2d77 6974 682d e 80).* --with- │ │ │ │ │ -0003e2b0: 646d 616c 6c6f 633a 2020 2020 2020 2020 dmalloc: │ │ │ │ │ +0003e280: 2020 2020 2020 2020 6163 6c6f 6361 6c20 aclocal │ │ │ │ │ +0003e290: 4f70 7469 6f6e 732e 2020 2020 2028 6c69 Options. (li │ │ │ │ │ +0003e2a0: 6e65 2020 3830 290a 2a20 2d2d 7769 7468 ne 80).* --with │ │ │ │ │ +0003e2b0: 2d64 6d61 6c6c 6f63 3a20 2020 2020 2020 -dmalloc: │ │ │ │ │ 0003e2c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e2d0: 5075 626c 6963 204d 6163 726f 732e 2020 Public Macros. │ │ │ │ │ -0003e2e0: 2020 2020 2028 6c69 6e65 2031 3139 290a (line 119). │ │ │ │ │ -0003e2f0: 2a20 2d2d 7769 7468 2d72 6567 6578 3a20 * --with-regex: │ │ │ │ │ +0003e2d0: 2050 7562 6c69 6320 4d61 6372 6f73 2e20 Public Macros. │ │ │ │ │ +0003e2e0: 2020 2020 2020 286c 696e 6520 3131 3929 (line 119) │ │ │ │ │ +0003e2f0: 0a2a 202d 2d77 6974 682d 7265 6765 783a .* --with-regex: │ │ │ │ │ 0003e300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e310: 2020 2020 2020 2020 204f 6273 6f6c 6574 Obsolet │ │ │ │ │ -0003e320: 6520 4d61 6372 6f73 2e20 2020 2020 286c e Macros. (l │ │ │ │ │ -0003e330: 696e 6520 2036 3429 0a2a 202d 613a 2020 ine 64).* -a: │ │ │ │ │ +0003e310: 2020 2020 2020 2020 2020 4f62 736f 6c65 Obsole │ │ │ │ │ +0003e320: 7465 204d 6163 726f 732e 2020 2020 2028 te Macros. ( │ │ │ │ │ +0003e330: 6c69 6e65 2020 3634 290a 2a20 2d61 3a20 line 64).* -a: │ │ │ │ │ 0003e340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003e350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e360: 2020 6175 746f 6d61 6b65 2049 6e76 6f63 automake Invoc │ │ │ │ │ -0003e370: 6174 696f 6e2e 2028 6c69 6e65 2020 3431 ation. (line 41 │ │ │ │ │ -0003e380: 290a 2a20 2d63 3a20 2020 2020 2020 2020 ).* -c: │ │ │ │ │ +0003e360: 2020 2061 7574 6f6d 616b 6520 496e 766f automake Invo │ │ │ │ │ +0003e370: 6361 7469 6f6e 2e20 286c 696e 6520 2034 cation. (line 4 │ │ │ │ │ +0003e380: 3129 0a2a 202d 633a 2020 2020 2020 2020 1).* -c: │ │ │ │ │ 0003e390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e3a0: 2020 2020 2020 2020 2020 2061 7574 6f6d autom │ │ │ │ │ -0003e3b0: 616b 6520 496e 766f 6361 7469 6f6e 2e20 ake Invocation. │ │ │ │ │ -0003e3c0: 286c 696e 6520 2036 3529 0a2a 202d 663a (line 65).* -f: │ │ │ │ │ -0003e3d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003e3a0: 2020 2020 2020 2020 2020 2020 6175 746f auto │ │ │ │ │ +0003e3b0: 6d61 6b65 2049 6e76 6f63 6174 696f 6e2e make Invocation. │ │ │ │ │ +0003e3c0: 2028 6c69 6e65 2020 3635 290a 2a20 2d66 (line 65).* -f │ │ │ │ │ +0003e3d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 0003e3e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e3f0: 2020 2020 6175 746f 6d61 6b65 2049 6e76 automake Inv │ │ │ │ │ -0003e400: 6f63 6174 696f 6e2e 2028 6c69 6e65 2020 ocation. (line │ │ │ │ │ -0003e410: 3736 290a 2a20 2d68 6f6f 6b20 7461 7267 76).* -hook targ │ │ │ │ │ -0003e420: 6574 733a 2020 2020 2020 2020 2020 2020 ets: │ │ │ │ │ -0003e430: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -0003e440: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ -0003e450: 2020 286c 696e 6520 2036 3629 0a2a 202d (line 66).* - │ │ │ │ │ -0003e460: 693a 2020 2020 2020 2020 2020 2020 2020 i: │ │ │ │ │ +0003e3f0: 2020 2020 2061 7574 6f6d 616b 6520 496e automake In │ │ │ │ │ +0003e400: 766f 6361 7469 6f6e 2e20 286c 696e 6520 vocation. (line │ │ │ │ │ +0003e410: 2037 3629 0a2a 202d 686f 6f6b 2074 6172 76).* -hook tar │ │ │ │ │ +0003e420: 6765 7473 3a20 2020 2020 2020 2020 2020 gets: │ │ │ │ │ +0003e430: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +0003e440: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ +0003e450: 2020 2028 6c69 6e65 2020 3636 290a 2a20 (line 66).* │ │ │ │ │ +0003e460: 2d69 3a20 2020 2020 2020 2020 2020 2020 -i: │ │ │ │ │ 0003e470: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e480: 2020 2020 2020 6175 746f 6d61 6b65 2049 automake I │ │ │ │ │ -0003e490: 6e76 6f63 6174 696f 6e2e 2028 6c69 6e65 nvocation. (line │ │ │ │ │ -0003e4a0: 2020 3939 290a 2a20 2d49 3a20 2020 2020 99).* -I: │ │ │ │ │ +0003e480: 2020 2020 2020 2061 7574 6f6d 616b 6520 automake │ │ │ │ │ +0003e490: 496e 766f 6361 7469 6f6e 2e20 286c 696e Invocation. (lin │ │ │ │ │ +0003e4a0: 6520 2039 3929 0a2a 202d 493a 2020 2020 e 99).* -I: │ │ │ │ │ 0003e4b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e4c0: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ -0003e4d0: 636c 6f63 616c 204f 7074 696f 6e73 2e20 clocal Options. │ │ │ │ │ -0003e4e0: 2020 2020 286c 696e 6520 2033 3429 0a2a (line 34).* │ │ │ │ │ -0003e4f0: 202d 6c20 616e 6420 4c44 4144 443a 2020 -l and LDADD: │ │ │ │ │ +0003e4c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003e4d0: 6163 6c6f 6361 6c20 4f70 7469 6f6e 732e aclocal Options. │ │ │ │ │ +0003e4e0: 2020 2020 2028 6c69 6e65 2020 3334 290a (line 34). │ │ │ │ │ +0003e4f0: 2a20 2d6c 2061 6e64 204c 4441 4444 3a20 * -l and LDADD: │ │ │ │ │ 0003e500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e510: 2020 2020 2020 2020 4c69 6e6b 696e 672e Linking. │ │ │ │ │ -0003e520: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003e530: 6e65 2020 3730 290a 2a20 2d6c 6f63 616c ne 70).* -local │ │ │ │ │ -0003e540: 2074 6172 6765 7473 3a20 2020 2020 2020 targets: │ │ │ │ │ +0003e510: 2020 2020 2020 2020 204c 696e 6b69 6e67 Linking │ │ │ │ │ +0003e520: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0003e530: 696e 6520 2037 3029 0a2a 202d 6c6f 6361 ine 70).* -loca │ │ │ │ │ +0003e540: 6c20 7461 7267 6574 733a 2020 2020 2020 l targets: │ │ │ │ │ 0003e550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e560: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ -0003e570: 2020 2020 2020 286c 696e 6520 2033 3729 (line 37) │ │ │ │ │ -0003e580: 0a2a 202d 6d6f 6475 6c65 2c20 6c69 6274 .* -module, libt │ │ │ │ │ -0003e590: 6f6f 6c3a 2020 2020 2020 2020 2020 2020 ool: │ │ │ │ │ -0003e5a0: 2020 2020 2020 2020 2020 4c69 6274 6f6f Libtoo │ │ │ │ │ -0003e5b0: 6c20 4d6f 6475 6c65 732e 2020 2020 2028 l Modules. ( │ │ │ │ │ -0003e5c0: 6c69 6e65 2020 2036 290a 2a20 2d6f 3a20 line 6).* -o: │ │ │ │ │ +0003e560: 2020 4578 7465 6e64 696e 672e 2020 2020 Extending. │ │ │ │ │ +0003e570: 2020 2020 2020 2028 6c69 6e65 2020 3337 (line 37 │ │ │ │ │ +0003e580: 290a 2a20 2d6d 6f64 756c 652c 206c 6962 ).* -module, lib │ │ │ │ │ +0003e590: 746f 6f6c 3a20 2020 2020 2020 2020 2020 tool: │ │ │ │ │ +0003e5a0: 2020 2020 2020 2020 2020 204c 6962 746f Libto │ │ │ │ │ +0003e5b0: 6f6c 204d 6f64 756c 6573 2e20 2020 2020 ol Modules. │ │ │ │ │ +0003e5c0: 286c 696e 6520 2020 3629 0a2a 202d 6f3a (line 6).* -o: │ │ │ │ │ 0003e5d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003e5e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e5f0: 2020 2061 7574 6f6d 616b 6520 496e 766f automake Invo │ │ │ │ │ -0003e600: 6361 7469 6f6e 2e20 286c 696e 6520 3131 cation. (line 11 │ │ │ │ │ -0003e610: 3529 0a2a 202d 763a 2020 2020 2020 2020 5).* -v: │ │ │ │ │ +0003e5f0: 2020 2020 6175 746f 6d61 6b65 2049 6e76 automake Inv │ │ │ │ │ +0003e600: 6f63 6174 696f 6e2e 2028 6c69 6e65 2031 ocation. (line 1 │ │ │ │ │ +0003e610: 3135 290a 2a20 2d76 3a20 2020 2020 2020 15).* -v: │ │ │ │ │ 0003e620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e630: 2020 2020 2020 2020 2020 2020 6175 746f auto │ │ │ │ │ -0003e640: 6d61 6b65 2049 6e76 6f63 6174 696f 6e2e make Invocation. │ │ │ │ │ -0003e650: 2028 6c69 6e65 2031 3232 290a 2a20 2d57 (line 122).* -W │ │ │ │ │ -0003e660: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003e630: 2020 2020 2020 2020 2020 2020 2061 7574 aut │ │ │ │ │ +0003e640: 6f6d 616b 6520 496e 766f 6361 7469 6f6e omake Invocation │ │ │ │ │ +0003e650: 2e20 286c 696e 6520 3132 3229 0a2a 202d . (line 122).* - │ │ │ │ │ +0003e660: 573a 2020 2020 2020 2020 2020 2020 2020 W: │ │ │ │ │ 0003e670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e680: 2020 2020 2061 7574 6f6d 616b 6520 496e automake In │ │ │ │ │ -0003e690: 766f 6361 7469 6f6e 2e20 286c 696e 6520 vocation. (line │ │ │ │ │ -0003e6a0: 3133 3029 0a2a 202d 5720 3c31 3e3a 2020 130).* -W <1>: │ │ │ │ │ +0003e680: 2020 2020 2020 6175 746f 6d61 6b65 2049 automake I │ │ │ │ │ +0003e690: 6e76 6f63 6174 696f 6e2e 2028 6c69 6e65 nvocation. (line │ │ │ │ │ +0003e6a0: 2031 3330 290a 2a20 2d57 203c 313e 3a20 130).* -W <1>: │ │ │ │ │ 0003e6b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e6c0: 2020 2020 2020 2020 2020 2020 2020 6163 ac │ │ │ │ │ -0003e6d0: 6c6f 6361 6c20 4f70 7469 6f6e 732e 2020 local Options. │ │ │ │ │ -0003e6e0: 2020 2028 6c69 6e65 2020 3830 290a 2a20 (line 80).* │ │ │ │ │ -0003e6f0: 2d57 616c 6c3a 2020 2020 2020 2020 2020 -Wall: │ │ │ │ │ +0003e6c0: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +0003e6d0: 636c 6f63 616c 204f 7074 696f 6e73 2e20 clocal Options. │ │ │ │ │ +0003e6e0: 2020 2020 286c 696e 6520 2038 3029 0a2a (line 80).* │ │ │ │ │ +0003e6f0: 202d 5761 6c6c 3a20 2020 2020 2020 2020 -Wall: │ │ │ │ │ 0003e700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e710: 2020 2020 2020 2061 6d68 656c 6c6f 2773 amhello's │ │ │ │ │ -0003e720: 2063 6f6e 6669 6775 7265 2e61 6320 5365 configure.ac Se │ │ │ │ │ -0003e730: 7475 7020 4578 706c 6169 6e65 642e 0a20 tup Explained.. │ │ │ │ │ +0003e710: 2020 2020 2020 2020 616d 6865 6c6c 6f27 amhello' │ │ │ │ │ +0003e720: 7320 636f 6e66 6967 7572 652e 6163 2053 s configure.ac S │ │ │ │ │ +0003e730: 6574 7570 2045 7870 6c61 696e 6564 2e0a etup Explained.. │ │ │ │ │ 0003e740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003e750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003e760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e770: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003e780: 6e65 2020 3338 290a 2a20 2d57 6572 726f ne 38).* -Werro │ │ │ │ │ -0003e790: 723a 2020 2020 2020 2020 2020 2020 2020 r: │ │ │ │ │ +0003e770: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0003e780: 696e 6520 2033 3829 0a2a 202d 5765 7272 ine 38).* -Werr │ │ │ │ │ +0003e790: 6f72 3a20 2020 2020 2020 2020 2020 2020 or: │ │ │ │ │ 0003e7a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e7b0: 2061 6d68 656c 6c6f 2773 2063 6f6e 6669 amhello's confi │ │ │ │ │ -0003e7c0: 6775 7265 2e61 6320 5365 7475 7020 4578 gure.ac Setup Ex │ │ │ │ │ -0003e7d0: 706c 6169 6e65 642e 0a20 2020 2020 2020 plained.. │ │ │ │ │ +0003e7b0: 2020 616d 6865 6c6c 6f27 7320 636f 6e66 amhello's conf │ │ │ │ │ +0003e7c0: 6967 7572 652e 6163 2053 6574 7570 2045 igure.ac Setup E │ │ │ │ │ +0003e7d0: 7870 6c61 696e 6564 2e0a 2020 2020 2020 xplained.. │ │ │ │ │ 0003e7e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003e7f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003e800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e810: 2020 2020 2020 2028 6c69 6e65 2020 3338 (line 38 │ │ │ │ │ -0003e820: 290a 2a20 2e6c 6120 7375 6666 6978 2c20 ).* .la suffix, │ │ │ │ │ -0003e830: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ -0003e840: 2020 2020 2020 2020 2020 204c 6962 746f Libto │ │ │ │ │ -0003e850: 6f6c 2043 6f6e 6365 7074 2e20 2020 2020 ol Concept. │ │ │ │ │ -0003e860: 286c 696e 6520 2020 3629 0a2a 205f 4441 (line 6).* _DA │ │ │ │ │ -0003e870: 5441 2070 7269 6d61 7279 2c20 6465 6669 TA primary, defi │ │ │ │ │ -0003e880: 6e65 643a 2020 2020 2020 2020 2020 2020 ned: │ │ │ │ │ -0003e890: 2020 2020 4461 7461 2e20 2020 2020 2020 Data. │ │ │ │ │ -0003e8a0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003e8b0: 2036 290a 2a20 5f44 4550 454e 4445 4e43 6).* _DEPENDENC │ │ │ │ │ -0003e8c0: 4945 532c 2064 6566 696e 6564 3a20 2020 IES, defined: │ │ │ │ │ -0003e8d0: 2020 2020 2020 2020 2020 2020 204c 696e Lin │ │ │ │ │ -0003e8e0: 6b69 6e67 2e20 2020 2020 2020 2020 2020 king. │ │ │ │ │ -0003e8f0: 2020 286c 696e 6520 2034 3129 0a2a 205f (line 41).* _ │ │ │ │ │ -0003e900: 4845 4144 4552 5320 7072 696d 6172 792c HEADERS primary, │ │ │ │ │ -0003e910: 2064 6566 696e 6564 3a20 2020 2020 2020 defined: │ │ │ │ │ -0003e920: 2020 2020 2020 4865 6164 6572 732e 2020 Headers. │ │ │ │ │ -0003e930: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003e940: 2020 2036 290a 2a20 5f4a 4156 4120 7072 6).* _JAVA pr │ │ │ │ │ -0003e950: 696d 6172 792c 2064 6566 696e 6564 3a20 imary, defined: │ │ │ │ │ -0003e960: 2020 2020 2020 2020 2020 2020 2020 204a J │ │ │ │ │ -0003e970: 6176 612e 2020 2020 2020 2020 2020 2020 ava. │ │ │ │ │ -0003e980: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0003e990: 205f 4c44 464c 4147 532c 2064 6566 696e _LDFLAGS, defin │ │ │ │ │ -0003e9a0: 6564 3a20 2020 2020 2020 2020 2020 2020 ed: │ │ │ │ │ -0003e9b0: 2020 2020 2020 2020 4c69 6e6b 696e 672e Linking. │ │ │ │ │ -0003e9c0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0003e9d0: 6e65 2020 3337 290a 2a20 5f4c 4446 4c41 ne 37).* _LDFLA │ │ │ │ │ -0003e9e0: 4753 2c20 6c69 6274 6f6f 6c3a 2020 2020 GS, libtool: │ │ │ │ │ +0003e810: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ +0003e820: 3829 0a2a 202e 6c61 2073 7566 6669 782c 8).* .la suffix, │ │ │ │ │ +0003e830: 2064 6566 696e 6564 3a20 2020 2020 2020 defined: │ │ │ │ │ +0003e840: 2020 2020 2020 2020 2020 2020 4c69 6274 Libt │ │ │ │ │ +0003e850: 6f6f 6c20 436f 6e63 6570 742e 2020 2020 ool Concept. │ │ │ │ │ +0003e860: 2028 6c69 6e65 2020 2036 290a 2a20 5f44 (line 6).* _D │ │ │ │ │ +0003e870: 4154 4120 7072 696d 6172 792c 2064 6566 ATA primary, def │ │ │ │ │ +0003e880: 696e 6564 3a20 2020 2020 2020 2020 2020 ined: │ │ │ │ │ +0003e890: 2020 2020 2044 6174 612e 2020 2020 2020 Data. │ │ │ │ │ +0003e8a0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003e8b0: 2020 3629 0a2a 205f 4445 5045 4e44 454e 6).* _DEPENDEN │ │ │ │ │ +0003e8c0: 4349 4553 2c20 6465 6669 6e65 643a 2020 CIES, defined: │ │ │ │ │ +0003e8d0: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ │ +0003e8e0: 6e6b 696e 672e 2020 2020 2020 2020 2020 nking. │ │ │ │ │ +0003e8f0: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ +0003e900: 5f48 4541 4445 5253 2070 7269 6d61 7279 _HEADERS primary │ │ │ │ │ +0003e910: 2c20 6465 6669 6e65 643a 2020 2020 2020 , defined: │ │ │ │ │ +0003e920: 2020 2020 2020 2048 6561 6465 7273 2e20 Headers. │ │ │ │ │ +0003e930: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003e940: 6520 2020 3629 0a2a 205f 4a41 5641 2070 e 6).* _JAVA p │ │ │ │ │ +0003e950: 7269 6d61 7279 2c20 6465 6669 6e65 643a rimary, defined: │ │ │ │ │ +0003e960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003e970: 4a61 7661 2e20 2020 2020 2020 2020 2020 Java. │ │ │ │ │ +0003e980: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0003e990: 2a20 5f4c 4446 4c41 4753 2c20 6465 6669 * _LDFLAGS, defi │ │ │ │ │ +0003e9a0: 6e65 643a 2020 2020 2020 2020 2020 2020 ned: │ │ │ │ │ +0003e9b0: 2020 2020 2020 2020 204c 696e 6b69 6e67 Linking │ │ │ │ │ +0003e9c0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0003e9d0: 696e 6520 2033 3729 0a2a 205f 4c44 464c ine 37).* _LDFL │ │ │ │ │ +0003e9e0: 4147 532c 206c 6962 746f 6f6c 3a20 2020 AGS, libtool: │ │ │ │ │ 0003e9f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ea00: 204c 6962 746f 6f6c 2046 6c61 6773 2e20 Libtool Flags. │ │ │ │ │ -0003ea10: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0003ea20: 0a2a 205f 4c49 4241 4444 2c20 6c69 6274 .* _LIBADD, libt │ │ │ │ │ -0003ea30: 6f6f 6c3a 2020 2020 2020 2020 2020 2020 ool: │ │ │ │ │ -0003ea40: 2020 2020 2020 2020 2020 4c69 6274 6f6f Libtoo │ │ │ │ │ -0003ea50: 6c20 466c 6167 732e 2020 2020 2020 2028 l Flags. ( │ │ │ │ │ -0003ea60: 6c69 6e65 2020 2036 290a 2a20 5f4c 4942 line 6).* _LIB │ │ │ │ │ -0003ea70: 5241 5249 4553 2070 7269 6d61 7279 2c20 RARIES primary, │ │ │ │ │ -0003ea80: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ -0003ea90: 2020 2041 204c 6962 7261 7279 2e20 2020 A Library. │ │ │ │ │ -0003eaa0: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ -0003eab0: 3629 0a2a 205f 4c49 4254 4f4f 4c46 4c41 6).* _LIBTOOLFLA │ │ │ │ │ -0003eac0: 4753 2c20 6c69 6274 6f6f 6c3a 2020 2020 GS, libtool: │ │ │ │ │ -0003ead0: 2020 2020 2020 2020 2020 2020 4c69 6274 Libt │ │ │ │ │ -0003eae0: 6f6f 6c20 466c 6167 732e 2020 2020 2020 ool Flags. │ │ │ │ │ -0003eaf0: 2028 6c69 6e65 2020 2036 290a 2a20 5f4c (line 6).* _L │ │ │ │ │ -0003eb00: 4953 5020 7072 696d 6172 792c 2064 6566 ISP primary, def │ │ │ │ │ -0003eb10: 696e 6564 3a20 2020 2020 2020 2020 2020 ined: │ │ │ │ │ -0003eb20: 2020 2020 2045 6d61 6373 204c 6973 702e Emacs Lisp. │ │ │ │ │ -0003eb30: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003eb40: 2020 3629 0a2a 205f 4c54 4c49 4252 4152 6).* _LTLIBRAR │ │ │ │ │ -0003eb50: 4945 5320 7072 696d 6172 792c 2064 6566 IES primary, def │ │ │ │ │ -0003eb60: 696e 6564 3a20 2020 2020 2020 2020 4c69 ined: Li │ │ │ │ │ -0003eb70: 6274 6f6f 6c20 4c69 6272 6172 6965 732e btool Libraries. │ │ │ │ │ -0003eb80: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -0003eb90: 5f4d 414e 5320 7072 696d 6172 792c 2064 _MANS primary, d │ │ │ │ │ -0003eba0: 6566 696e 6564 3a20 2020 2020 2020 2020 efined: │ │ │ │ │ -0003ebb0: 2020 2020 2020 204d 616e 2050 6167 6573 Man Pages │ │ │ │ │ -0003ebc0: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -0003ebd0: 6520 2020 3629 0a2a 205f 5052 4f47 5241 e 6).* _PROGRA │ │ │ │ │ -0003ebe0: 4d53 2070 7269 6d61 7279 2076 6172 6961 MS primary varia │ │ │ │ │ -0003ebf0: 626c 653a 2020 2020 2020 2020 2020 2020 ble: │ │ │ │ │ -0003ec00: 556e 6966 6f72 6d2e 2020 2020 2020 2020 Uniform. │ │ │ │ │ -0003ec10: 2020 2020 2028 6c69 6e65 2020 3131 290a (line 11). │ │ │ │ │ -0003ec20: 2a20 5f50 5954 484f 4e20 7072 696d 6172 * _PYTHON primar │ │ │ │ │ -0003ec30: 792c 2064 6566 696e 6564 3a20 2020 2020 y, defined: │ │ │ │ │ -0003ec40: 2020 2020 2020 2020 2050 7974 686f 6e2e Python. │ │ │ │ │ -0003ec50: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -0003ec60: 696e 6520 2020 3629 0a2a 205f 5343 5249 ine 6).* _SCRI │ │ │ │ │ -0003ec70: 5054 5320 7072 696d 6172 792c 2064 6566 PTS primary, def │ │ │ │ │ -0003ec80: 696e 6564 3a20 2020 2020 2020 2020 2020 ined: │ │ │ │ │ -0003ec90: 2020 5363 7269 7074 732e 2020 2020 2020 Scripts. │ │ │ │ │ -0003eca0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -0003ecb0: 290a 2a20 5f53 4f55 5243 4553 2061 6e64 ).* _SOURCES and │ │ │ │ │ -0003ecc0: 2068 6561 6465 7220 6669 6c65 733a 2020 header files: │ │ │ │ │ -0003ecd0: 2020 2020 2020 2020 2020 2050 726f 6772 Progr │ │ │ │ │ -0003ece0: 616d 2053 6f75 7263 6573 2e20 2020 2020 am Sources. │ │ │ │ │ -0003ecf0: 286c 696e 6520 2033 3929 0a2a 205f 534f (line 39).* _SO │ │ │ │ │ -0003ed00: 5552 4345 5320 7072 696d 6172 792c 2064 URCES primary, d │ │ │ │ │ -0003ed10: 6566 696e 6564 3a20 2020 2020 2020 2020 efined: │ │ │ │ │ -0003ed20: 2020 2020 5072 6f67 7261 6d20 536f 7572 Program Sour │ │ │ │ │ -0003ed30: 6365 732e 2020 2020 2028 6c69 6e65 2020 ces. (line │ │ │ │ │ -0003ed40: 3332 290a 2a20 5f53 4f55 5243 4553 2c20 32).* _SOURCES, │ │ │ │ │ -0003ed50: 6465 6661 756c 743a 2020 2020 2020 2020 default: │ │ │ │ │ -0003ed60: 2020 2020 2020 2020 2020 2020 2044 6566 Def │ │ │ │ │ -0003ed70: 6175 6c74 205f 534f 5552 4345 532e 2020 ault _SOURCES. │ │ │ │ │ -0003ed80: 2020 286c 696e 6520 2020 3629 0a2a 205f (line 6).* _ │ │ │ │ │ -0003ed90: 534f 5552 4345 532c 2065 6d70 7479 3a20 SOURCES, empty: │ │ │ │ │ +0003ea00: 2020 4c69 6274 6f6f 6c20 466c 6167 732e Libtool Flags. │ │ │ │ │ +0003ea10: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0003ea20: 290a 2a20 5f4c 4942 4144 442c 206c 6962 ).* _LIBADD, lib │ │ │ │ │ +0003ea30: 746f 6f6c 3a20 2020 2020 2020 2020 2020 tool: │ │ │ │ │ +0003ea40: 2020 2020 2020 2020 2020 204c 6962 746f Libto │ │ │ │ │ +0003ea50: 6f6c 2046 6c61 6773 2e20 2020 2020 2020 ol Flags. │ │ │ │ │ +0003ea60: 286c 696e 6520 2020 3629 0a2a 205f 4c49 (line 6).* _LI │ │ │ │ │ +0003ea70: 4252 4152 4945 5320 7072 696d 6172 792c BRARIES primary, │ │ │ │ │ +0003ea80: 2064 6566 696e 6564 3a20 2020 2020 2020 defined: │ │ │ │ │ +0003ea90: 2020 2020 4120 4c69 6272 6172 792e 2020 A Library. │ │ │ │ │ +0003eaa0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0003eab0: 2036 290a 2a20 5f4c 4942 544f 4f4c 464c 6).* _LIBTOOLFL │ │ │ │ │ +0003eac0: 4147 532c 206c 6962 746f 6f6c 3a20 2020 AGS, libtool: │ │ │ │ │ +0003ead0: 2020 2020 2020 2020 2020 2020 204c 6962 Lib │ │ │ │ │ +0003eae0: 746f 6f6c 2046 6c61 6773 2e20 2020 2020 tool Flags. │ │ │ │ │ +0003eaf0: 2020 286c 696e 6520 2020 3629 0a2a 205f (line 6).* _ │ │ │ │ │ +0003eb00: 4c49 5350 2070 7269 6d61 7279 2c20 6465 LISP primary, de │ │ │ │ │ +0003eb10: 6669 6e65 643a 2020 2020 2020 2020 2020 fined: │ │ │ │ │ +0003eb20: 2020 2020 2020 456d 6163 7320 4c69 7370 Emacs Lisp │ │ │ │ │ +0003eb30: 2e20 2020 2020 2020 2020 2028 6c69 6e65 . (line │ │ │ │ │ +0003eb40: 2020 2036 290a 2a20 5f4c 544c 4942 5241 6).* _LTLIBRA │ │ │ │ │ +0003eb50: 5249 4553 2070 7269 6d61 7279 2c20 6465 RIES primary, de │ │ │ │ │ +0003eb60: 6669 6e65 643a 2020 2020 2020 2020 204c fined: L │ │ │ │ │ +0003eb70: 6962 746f 6f6c 204c 6962 7261 7269 6573 ibtool Libraries │ │ │ │ │ +0003eb80: 2e20 2020 286c 696e 6520 2020 3629 0a2a . (line 6).* │ │ │ │ │ +0003eb90: 205f 4d41 4e53 2070 7269 6d61 7279 2c20 _MANS primary, │ │ │ │ │ +0003eba0: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ +0003ebb0: 2020 2020 2020 2020 4d61 6e20 5061 6765 Man Page │ │ │ │ │ +0003ebc0: 732e 2020 2020 2020 2020 2020 2028 6c69 s. (li │ │ │ │ │ +0003ebd0: 6e65 2020 2036 290a 2a20 5f50 524f 4752 ne 6).* _PROGR │ │ │ │ │ +0003ebe0: 414d 5320 7072 696d 6172 7920 7661 7269 AMS primary vari │ │ │ │ │ +0003ebf0: 6162 6c65 3a20 2020 2020 2020 2020 2020 able: │ │ │ │ │ +0003ec00: 2055 6e69 666f 726d 2e20 2020 2020 2020 Uniform. │ │ │ │ │ +0003ec10: 2020 2020 2020 286c 696e 6520 2031 3129 (line 11) │ │ │ │ │ +0003ec20: 0a2a 205f 5059 5448 4f4e 2070 7269 6d61 .* _PYTHON prima │ │ │ │ │ +0003ec30: 7279 2c20 6465 6669 6e65 643a 2020 2020 ry, defined: │ │ │ │ │ +0003ec40: 2020 2020 2020 2020 2020 5079 7468 6f6e Python │ │ │ │ │ +0003ec50: 2e20 2020 2020 2020 2020 2020 2020 2028 . ( │ │ │ │ │ +0003ec60: 6c69 6e65 2020 2036 290a 2a20 5f53 4352 line 6).* _SCR │ │ │ │ │ +0003ec70: 4950 5453 2070 7269 6d61 7279 2c20 6465 IPTS primary, de │ │ │ │ │ +0003ec80: 6669 6e65 643a 2020 2020 2020 2020 2020 fined: │ │ │ │ │ +0003ec90: 2020 2053 6372 6970 7473 2e20 2020 2020 Scripts. │ │ │ │ │ +0003eca0: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +0003ecb0: 3629 0a2a 205f 534f 5552 4345 5320 616e 6).* _SOURCES an │ │ │ │ │ +0003ecc0: 6420 6865 6164 6572 2066 696c 6573 3a20 d header files: │ │ │ │ │ +0003ecd0: 2020 2020 2020 2020 2020 2020 5072 6f67 Prog │ │ │ │ │ +0003ece0: 7261 6d20 536f 7572 6365 732e 2020 2020 ram Sources. │ │ │ │ │ +0003ecf0: 2028 6c69 6e65 2020 3339 290a 2a20 5f53 (line 39).* _S │ │ │ │ │ +0003ed00: 4f55 5243 4553 2070 7269 6d61 7279 2c20 OURCES primary, │ │ │ │ │ +0003ed10: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ +0003ed20: 2020 2020 2050 726f 6772 616d 2053 6f75 Program Sou │ │ │ │ │ +0003ed30: 7263 6573 2e20 2020 2020 286c 696e 6520 rces. (line │ │ │ │ │ +0003ed40: 2033 3229 0a2a 205f 534f 5552 4345 532c 32).* _SOURCES, │ │ │ │ │ +0003ed50: 2064 6566 6175 6c74 3a20 2020 2020 2020 default: │ │ │ │ │ +0003ed60: 2020 2020 2020 2020 2020 2020 2020 4465 De │ │ │ │ │ +0003ed70: 6661 756c 7420 5f53 4f55 5243 4553 2e20 fault _SOURCES. │ │ │ │ │ +0003ed80: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +0003ed90: 5f53 4f55 5243 4553 2c20 656d 7074 793a _SOURCES, empty: │ │ │ │ │ 0003eda0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003edb0: 2020 2020 2020 4465 6661 756c 7420 5f53 Default _S │ │ │ │ │ -0003edc0: 4f55 5243 4553 2e20 2020 2028 6c69 6e65 OURCES. (line │ │ │ │ │ -0003edd0: 2020 3434 290a 2a20 5f54 4558 494e 464f 44).* _TEXINFO │ │ │ │ │ -0003ede0: 5320 7072 696d 6172 792c 2064 6566 696e S primary, defin │ │ │ │ │ -0003edf0: 6564 3a20 2020 2020 2020 2020 2020 2054 ed: T │ │ │ │ │ -0003ee00: 6578 696e 666f 2e20 2020 2020 2020 2020 exinfo. │ │ │ │ │ -0003ee10: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0003ee20: 2061 6369 6e63 6c75 6465 2e6d 342c 2064 acinclude.m4, d │ │ │ │ │ -0003ee30: 6566 696e 6564 3a20 2020 2020 2020 2020 efined: │ │ │ │ │ -0003ee40: 2020 2020 2020 2020 436f 6d70 6c65 7465 Complete │ │ │ │ │ -0003ee50: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ │ -0003ee60: 6e65 2020 3233 290a 2a20 6163 6c6f 6361 ne 23).* acloca │ │ │ │ │ -0003ee70: 6c20 616e 6420 7365 7269 616c 206e 756d l and serial num │ │ │ │ │ -0003ee80: 6265 7273 3a20 2020 2020 2020 2020 2020 bers: │ │ │ │ │ -0003ee90: 2053 6572 6961 6c73 2e20 2020 2020 2020 Serials. │ │ │ │ │ -0003eea0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0003eeb0: 0a2a 2061 636c 6f63 616c 2070 726f 6772 .* aclocal progr │ │ │ │ │ -0003eec0: 616d 2c20 696e 7472 6f64 7563 7469 6f6e am, introduction │ │ │ │ │ -0003eed0: 3a20 2020 2020 2020 2020 436f 6d70 6c65 : Comple │ │ │ │ │ -0003eee0: 7465 2e20 2020 2020 2020 2020 2020 2028 te. ( │ │ │ │ │ -0003eef0: 6c69 6e65 2020 3233 290a 2a20 6163 6c6f line 23).* aclo │ │ │ │ │ -0003ef00: 6361 6c20 7365 6172 6368 2070 6174 683a cal search path: │ │ │ │ │ -0003ef10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ef20: 2020 204d 6163 726f 2053 6561 7263 6820 Macro Search │ │ │ │ │ -0003ef30: 5061 7468 2e20 2020 286c 696e 6520 2020 Path. (line │ │ │ │ │ -0003ef40: 3629 0a2a 2061 636c 6f63 616c 2773 2073 6).* aclocal's s │ │ │ │ │ -0003ef50: 6368 6564 756c 6564 2064 6561 7468 3a20 cheduled death: │ │ │ │ │ -0003ef60: 2020 2020 2020 2020 2020 2020 4675 7475 Futu │ │ │ │ │ -0003ef70: 7265 206f 6620 6163 6c6f 6361 6c2e 2020 re of aclocal. │ │ │ │ │ -0003ef80: 2028 6c69 6e65 2020 2036 290a 2a20 6163 (line 6).* ac │ │ │ │ │ -0003ef90: 6c6f 6361 6c2c 2065 7874 656e 6469 6e67 local, extending │ │ │ │ │ -0003efa0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003efb0: 2020 2020 2045 7874 656e 6469 6e67 2061 Extending a │ │ │ │ │ -0003efc0: 636c 6f63 616c 2e20 2020 286c 696e 6520 clocal. (line │ │ │ │ │ -0003efd0: 2020 3629 0a2a 2061 636c 6f63 616c 2c20 6).* aclocal, │ │ │ │ │ -0003efe0: 496e 766f 6361 7469 6f6e 3a20 2020 2020 Invocation: │ │ │ │ │ -0003eff0: 2020 2020 2020 2020 2020 2020 2020 6163 ac │ │ │ │ │ -0003f000: 6c6f 6361 6c20 496e 766f 6361 7469 6f6e local Invocation │ │ │ │ │ -0003f010: 2e20 2028 6c69 6e65 2020 2036 290a 2a20 . (line 6).* │ │ │ │ │ -0003f020: 6163 6c6f 6361 6c2c 2049 6e76 6f6b 696e aclocal, Invokin │ │ │ │ │ -0003f030: 673a 2020 2020 2020 2020 2020 2020 2020 g: │ │ │ │ │ -0003f040: 2020 2020 2020 2061 636c 6f63 616c 2049 aclocal I │ │ │ │ │ -0003f050: 6e76 6f63 6174 696f 6e2e 2020 286c 696e nvocation. (lin │ │ │ │ │ -0003f060: 6520 2020 3629 0a2a 2061 636c 6f63 616c e 6).* aclocal │ │ │ │ │ -0003f070: 2c20 4f70 7469 6f6e 733a 2020 2020 2020 , Options: │ │ │ │ │ +0003edb0: 2020 2020 2020 2044 6566 6175 6c74 205f Default _ │ │ │ │ │ +0003edc0: 534f 5552 4345 532e 2020 2020 286c 696e SOURCES. (lin │ │ │ │ │ +0003edd0: 6520 2034 3429 0a2a 205f 5445 5849 4e46 e 44).* _TEXINF │ │ │ │ │ +0003ede0: 4f53 2070 7269 6d61 7279 2c20 6465 6669 OS primary, defi │ │ │ │ │ +0003edf0: 6e65 643a 2020 2020 2020 2020 2020 2020 ned: │ │ │ │ │ +0003ee00: 5465 7869 6e66 6f2e 2020 2020 2020 2020 Texinfo. │ │ │ │ │ +0003ee10: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0003ee20: 2a20 6163 696e 636c 7564 652e 6d34 2c20 * acinclude.m4, │ │ │ │ │ +0003ee30: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ +0003ee40: 2020 2020 2020 2020 2043 6f6d 706c 6574 Complet │ │ │ │ │ +0003ee50: 652e 2020 2020 2020 2020 2020 2020 286c e. (l │ │ │ │ │ +0003ee60: 696e 6520 2032 3329 0a2a 2061 636c 6f63 ine 23).* acloc │ │ │ │ │ +0003ee70: 616c 2061 6e64 2073 6572 6961 6c20 6e75 al and serial nu │ │ │ │ │ +0003ee80: 6d62 6572 733a 2020 2020 2020 2020 2020 mbers: │ │ │ │ │ +0003ee90: 2020 5365 7269 616c 732e 2020 2020 2020 Serials. │ │ │ │ │ +0003eea0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0003eeb0: 290a 2a20 6163 6c6f 6361 6c20 7072 6f67 ).* aclocal prog │ │ │ │ │ +0003eec0: 7261 6d2c 2069 6e74 726f 6475 6374 696f ram, introductio │ │ │ │ │ +0003eed0: 6e3a 2020 2020 2020 2020 2043 6f6d 706c n: Compl │ │ │ │ │ +0003eee0: 6574 652e 2020 2020 2020 2020 2020 2020 ete. │ │ │ │ │ +0003eef0: 286c 696e 6520 2032 3329 0a2a 2061 636c (line 23).* acl │ │ │ │ │ +0003ef00: 6f63 616c 2073 6561 7263 6820 7061 7468 ocal search path │ │ │ │ │ +0003ef10: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003ef20: 2020 2020 4d61 6372 6f20 5365 6172 6368 Macro Search │ │ │ │ │ +0003ef30: 2050 6174 682e 2020 2028 6c69 6e65 2020 Path. (line │ │ │ │ │ +0003ef40: 2036 290a 2a20 6163 6c6f 6361 6c27 7320 6).* aclocal's │ │ │ │ │ +0003ef50: 7363 6865 6475 6c65 6420 6465 6174 683a scheduled death: │ │ │ │ │ +0003ef60: 2020 2020 2020 2020 2020 2020 2046 7574 Fut │ │ │ │ │ +0003ef70: 7572 6520 6f66 2061 636c 6f63 616c 2e20 ure of aclocal. │ │ │ │ │ +0003ef80: 2020 286c 696e 6520 2020 3629 0a2a 2061 (line 6).* a │ │ │ │ │ +0003ef90: 636c 6f63 616c 2c20 6578 7465 6e64 696e clocal, extendin │ │ │ │ │ +0003efa0: 673a 2020 2020 2020 2020 2020 2020 2020 g: │ │ │ │ │ +0003efb0: 2020 2020 2020 4578 7465 6e64 696e 6720 Extending │ │ │ │ │ +0003efc0: 6163 6c6f 6361 6c2e 2020 2028 6c69 6e65 aclocal. (line │ │ │ │ │ +0003efd0: 2020 2036 290a 2a20 6163 6c6f 6361 6c2c 6).* aclocal, │ │ │ │ │ +0003efe0: 2049 6e76 6f63 6174 696f 6e3a 2020 2020 Invocation: │ │ │ │ │ +0003eff0: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +0003f000: 636c 6f63 616c 2049 6e76 6f63 6174 696f clocal Invocatio │ │ │ │ │ +0003f010: 6e2e 2020 286c 696e 6520 2020 3629 0a2a n. (line 6).* │ │ │ │ │ +0003f020: 2061 636c 6f63 616c 2c20 496e 766f 6b69 aclocal, Invoki │ │ │ │ │ +0003f030: 6e67 3a20 2020 2020 2020 2020 2020 2020 ng: │ │ │ │ │ +0003f040: 2020 2020 2020 2020 6163 6c6f 6361 6c20 aclocal │ │ │ │ │ +0003f050: 496e 766f 6361 7469 6f6e 2e20 2028 6c69 Invocation. (li │ │ │ │ │ +0003f060: 6e65 2020 2036 290a 2a20 6163 6c6f 6361 ne 6).* acloca │ │ │ │ │ +0003f070: 6c2c 204f 7074 696f 6e73 3a20 2020 2020 l, Options: │ │ │ │ │ 0003f080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f090: 6163 6c6f 6361 6c20 4f70 7469 6f6e 732e aclocal Options. │ │ │ │ │ -0003f0a0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -0003f0b0: 2a20 6163 6c6f 6361 6c2c 2075 7369 6e67 * aclocal, using │ │ │ │ │ -0003f0c0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003f0d0: 2020 2020 2020 2020 2063 6f6e 6669 6775 configu │ │ │ │ │ -0003f0e0: 7265 2e20 2020 2020 2020 2020 2020 286c re. (l │ │ │ │ │ -0003f0f0: 696e 6520 2020 3629 0a2a 2061 636c 6f63 ine 6).* acloc │ │ │ │ │ -0003f100: 616c 2e6d 342c 2070 7265 6578 6973 7469 al.m4, preexisti │ │ │ │ │ -0003f110: 6e67 3a20 2020 2020 2020 2020 2020 2020 ng: │ │ │ │ │ -0003f120: 2020 436f 6d70 6c65 7465 2e20 2020 2020 Complete. │ │ │ │ │ -0003f130: 2020 2020 2020 2028 6c69 6e65 2020 3233 (line 23 │ │ │ │ │ -0003f140: 290a 2a20 4143 4c4f 4341 4c5f 5041 5448 ).* ACLOCAL_PATH │ │ │ │ │ -0003f150: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0003f160: 2020 2020 2020 2020 2020 204d 6163 726f Macro │ │ │ │ │ -0003f170: 2053 6561 7263 6820 5061 7468 2e20 2020 Search Path. │ │ │ │ │ -0003f180: 286c 696e 6520 3131 3629 0a2a 2041 435f (line 116).* AC_ │ │ │ │ │ -0003f190: 434f 4e46 4947 5f46 494c 4553 2c20 636f CONFIG_FILES, co │ │ │ │ │ -0003f1a0: 6e64 6974 696f 6e61 6c3a 2020 2020 2020 nditional: │ │ │ │ │ -0003f1b0: 2020 2020 5573 6167 6520 6f66 2043 6f6e Usage of Con │ │ │ │ │ -0003f1c0: 6469 7469 6f6e 616c 732e 0a20 2020 2020 ditionals.. │ │ │ │ │ +0003f090: 2061 636c 6f63 616c 204f 7074 696f 6e73 aclocal Options │ │ │ │ │ +0003f0a0: 2e20 2020 2020 286c 696e 6520 2020 3629 . (line 6) │ │ │ │ │ +0003f0b0: 0a2a 2061 636c 6f63 616c 2c20 7573 696e .* aclocal, usin │ │ │ │ │ +0003f0c0: 673a 2020 2020 2020 2020 2020 2020 2020 g: │ │ │ │ │ +0003f0d0: 2020 2020 2020 2020 2020 636f 6e66 6967 config │ │ │ │ │ +0003f0e0: 7572 652e 2020 2020 2020 2020 2020 2028 ure. ( │ │ │ │ │ +0003f0f0: 6c69 6e65 2020 2036 290a 2a20 6163 6c6f line 6).* aclo │ │ │ │ │ +0003f100: 6361 6c2e 6d34 2c20 7072 6565 7869 7374 cal.m4, preexist │ │ │ │ │ +0003f110: 696e 673a 2020 2020 2020 2020 2020 2020 ing: │ │ │ │ │ +0003f120: 2020 2043 6f6d 706c 6574 652e 2020 2020 Complete. │ │ │ │ │ +0003f130: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +0003f140: 3329 0a2a 2041 434c 4f43 414c 5f50 4154 3).* ACLOCAL_PAT │ │ │ │ │ +0003f150: 483a 2020 2020 2020 2020 2020 2020 2020 H: │ │ │ │ │ +0003f160: 2020 2020 2020 2020 2020 2020 4d61 6372 Macr │ │ │ │ │ +0003f170: 6f20 5365 6172 6368 2050 6174 682e 2020 o Search Path. │ │ │ │ │ +0003f180: 2028 6c69 6e65 2031 3136 290a 2a20 4143 (line 116).* AC │ │ │ │ │ +0003f190: 5f43 4f4e 4649 475f 4649 4c45 532c 2063 _CONFIG_FILES, c │ │ │ │ │ +0003f1a0: 6f6e 6469 7469 6f6e 616c 3a20 2020 2020 onditional: │ │ │ │ │ +0003f1b0: 2020 2020 2055 7361 6765 206f 6620 436f Usage of Co │ │ │ │ │ +0003f1c0: 6e64 6974 696f 6e61 6c73 2e0a 2020 2020 nditionals.. │ │ │ │ │ 0003f1d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f1e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f1f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f200: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003f210: 3739 290a 2a20 4143 5f53 5542 5354 2061 79).* AC_SUBST a │ │ │ │ │ -0003f220: 6e64 2053 5542 4449 5253 3a20 2020 2020 nd SUBDIRS: │ │ │ │ │ -0003f230: 2020 2020 2020 2020 2020 2020 2053 7562 Sub │ │ │ │ │ -0003f240: 6469 7265 6374 6f72 6965 7320 7769 7468 directories with │ │ │ │ │ -0003f250: 2041 435f 5355 4253 542e 0a20 2020 2020 AC_SUBST.. │ │ │ │ │ +0003f200: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003f210: 2037 3929 0a2a 2041 435f 5355 4253 5420 79).* AC_SUBST │ │ │ │ │ +0003f220: 616e 6420 5355 4244 4952 533a 2020 2020 and SUBDIRS: │ │ │ │ │ +0003f230: 2020 2020 2020 2020 2020 2020 2020 5375 Su │ │ │ │ │ +0003f240: 6264 6972 6563 746f 7269 6573 2077 6974 bdirectories wit │ │ │ │ │ +0003f250: 6820 4143 5f53 5542 5354 2e0a 2020 2020 h AC_SUBST.. │ │ │ │ │ 0003f260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f270: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f290: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003f2a0: 2036 290a 2a20 4164 6469 6e67 206e 6577 6).* Adding new │ │ │ │ │ -0003f2b0: 2053 5546 4649 5845 533a 2020 2020 2020 SUFFIXES: │ │ │ │ │ -0003f2c0: 2020 2020 2020 2020 2020 2020 2053 7566 Suf │ │ │ │ │ -0003f2d0: 6669 7865 732e 2020 2020 2020 2020 2020 fixes. │ │ │ │ │ -0003f2e0: 2020 286c 696e 6520 2020 3629 0a2a 2061 (line 6).* a │ │ │ │ │ -0003f2f0: 6c6c 3a20 2020 2020 2020 2020 2020 2020 ll: │ │ │ │ │ +0003f290: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003f2a0: 2020 3629 0a2a 2041 6464 696e 6720 6e65 6).* Adding ne │ │ │ │ │ +0003f2b0: 7720 5355 4646 4958 4553 3a20 2020 2020 w SUFFIXES: │ │ │ │ │ +0003f2c0: 2020 2020 2020 2020 2020 2020 2020 5375 Su │ │ │ │ │ +0003f2d0: 6666 6978 6573 2e20 2020 2020 2020 2020 ffixes. │ │ │ │ │ +0003f2e0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +0003f2f0: 616c 6c3a 2020 2020 2020 2020 2020 2020 all: │ │ │ │ │ 0003f300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f310: 2020 2020 2020 5374 616e 6461 7264 2054 Standard T │ │ │ │ │ -0003f320: 6172 6765 7473 2e20 2020 2028 6c69 6e65 argets. (line │ │ │ │ │ -0003f330: 2020 3136 290a 2a20 616c 6c20 3c31 3e3a 16).* all <1>: │ │ │ │ │ -0003f340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f350: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ -0003f360: 7874 656e 6469 6e67 2e20 2020 2020 2020 xtending. │ │ │ │ │ -0003f370: 2020 2020 286c 696e 6520 2034 3129 0a2a (line 41).* │ │ │ │ │ -0003f380: 2061 6c6c 2d6c 6f63 616c 3a20 2020 2020 all-local: │ │ │ │ │ +0003f310: 2020 2020 2020 2053 7461 6e64 6172 6420 Standard │ │ │ │ │ +0003f320: 5461 7267 6574 732e 2020 2020 286c 696e Targets. (lin │ │ │ │ │ +0003f330: 6520 2031 3629 0a2a 2061 6c6c 203c 313e e 16).* all <1> │ │ │ │ │ +0003f340: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003f350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003f360: 4578 7465 6e64 696e 672e 2020 2020 2020 Extending. │ │ │ │ │ +0003f370: 2020 2020 2028 6c69 6e65 2020 3431 290a (line 41). │ │ │ │ │ +0003f380: 2a20 616c 6c2d 6c6f 6361 6c3a 2020 2020 * all-local: │ │ │ │ │ 0003f390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f3a0: 2020 2020 2020 2020 4578 7465 6e64 696e Extendin │ │ │ │ │ -0003f3b0: 672e 2020 2020 2020 2020 2020 2028 6c69 g. (li │ │ │ │ │ -0003f3c0: 6e65 2020 3431 290a 2a20 414c 4c4f 4341 ne 41).* ALLOCA │ │ │ │ │ -0003f3d0: 2c20 616e 6420 4c69 6274 6f6f 6c3a 2020 , and Libtool: │ │ │ │ │ +0003f3a0: 2020 2020 2020 2020 2045 7874 656e 6469 Extendi │ │ │ │ │ +0003f3b0: 6e67 2e20 2020 2020 2020 2020 2020 286c ng. (l │ │ │ │ │ +0003f3c0: 696e 6520 2034 3129 0a2a 2041 4c4c 4f43 ine 41).* ALLOC │ │ │ │ │ +0003f3d0: 412c 2061 6e64 204c 6962 746f 6f6c 3a20 A, and Libtool: │ │ │ │ │ 0003f3e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f3f0: 204c 544c 4942 4f42 4a53 2e20 2020 2020 LTLIBOBJS. │ │ │ │ │ -0003f400: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0003f410: 0a2a 2041 4c4c 4f43 412c 2065 7861 6d70 .* ALLOCA, examp │ │ │ │ │ -0003f420: 6c65 3a20 2020 2020 2020 2020 2020 2020 le: │ │ │ │ │ -0003f430: 2020 2020 2020 2020 2020 4c49 424f 424a LIBOBJ │ │ │ │ │ -0003f440: 532e 2020 2020 2020 2020 2020 2020 2028 S. ( │ │ │ │ │ -0003f450: 6c69 6e65 2020 2036 290a 2a20 414c 4c4f line 6).* ALLO │ │ │ │ │ -0003f460: 4341 2c20 7370 6563 6961 6c20 6861 6e64 CA, special hand │ │ │ │ │ -0003f470: 6c69 6e67 3a20 2020 2020 2020 2020 2020 ling: │ │ │ │ │ -0003f480: 2020 204c 4942 4f42 4a53 2e20 2020 2020 LIBOBJS. │ │ │ │ │ -0003f490: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ -0003f4a0: 3629 0a2a 2061 6d68 656c 6c6f 2d31 2e30 6).* amhello-1.0 │ │ │ │ │ -0003f4b0: 2e74 6172 2e67 7a2c 2063 7265 6174 696f .tar.gz, creatio │ │ │ │ │ -0003f4c0: 6e3a 2020 2020 2020 2020 2020 4865 6c6c n: Hell │ │ │ │ │ -0003f4d0: 6f20 576f 726c 642e 2020 2020 2020 2020 o World. │ │ │ │ │ -0003f4e0: 2028 6c69 6e65 2020 2036 290a 2a20 616d (line 6).* am │ │ │ │ │ -0003f4f0: 6865 6c6c 6f2d 312e 302e 7461 722e 677a hello-1.0.tar.gz │ │ │ │ │ -0003f500: 2c20 6c6f 6361 7469 6f6e 3a20 2020 2020 , location: │ │ │ │ │ -0003f510: 2020 2020 2055 7365 2043 6173 6573 2e20 Use Cases. │ │ │ │ │ -0003f520: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003f530: 2020 3629 0a2a 2061 6d68 656c 6c6f 2d31 6).* amhello-1 │ │ │ │ │ -0003f540: 2e30 2e74 6172 2e67 7a2c 2075 7365 2063 .0.tar.gz, use c │ │ │ │ │ -0003f550: 6173 6573 3a20 2020 2020 2020 2020 5573 ases: Us │ │ │ │ │ -0003f560: 6520 4361 7365 732e 2020 2020 2020 2020 e Cases. │ │ │ │ │ -0003f570: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -0003f580: 414d 5f43 4341 5346 4c41 4753 2061 6e64 AM_CCASFLAGS and │ │ │ │ │ -0003f590: 2043 4341 5346 4c41 4753 3a20 2020 2020 CCASFLAGS: │ │ │ │ │ -0003f5a0: 2020 2020 2020 2046 6c61 6720 5661 7269 Flag Vari │ │ │ │ │ -0003f5b0: 6162 6c65 7320 4f72 6465 7269 6e67 2e0a ables Ordering.. │ │ │ │ │ -0003f5c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003f3f0: 2020 4c54 4c49 424f 424a 532e 2020 2020 LTLIBOBJS. │ │ │ │ │ +0003f400: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0003f410: 290a 2a20 414c 4c4f 4341 2c20 6578 616d ).* ALLOCA, exam │ │ │ │ │ +0003f420: 706c 653a 2020 2020 2020 2020 2020 2020 ple: │ │ │ │ │ +0003f430: 2020 2020 2020 2020 2020 204c 4942 4f42 LIBOB │ │ │ │ │ +0003f440: 4a53 2e20 2020 2020 2020 2020 2020 2020 JS. │ │ │ │ │ +0003f450: 286c 696e 6520 2020 3629 0a2a 2041 4c4c (line 6).* ALL │ │ │ │ │ +0003f460: 4f43 412c 2073 7065 6369 616c 2068 616e OCA, special han │ │ │ │ │ +0003f470: 646c 696e 673a 2020 2020 2020 2020 2020 dling: │ │ │ │ │ +0003f480: 2020 2020 4c49 424f 424a 532e 2020 2020 LIBOBJS. │ │ │ │ │ +0003f490: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0003f4a0: 2036 290a 2a20 616d 6865 6c6c 6f2d 312e 6).* amhello-1. │ │ │ │ │ +0003f4b0: 302e 7461 722e 677a 2c20 6372 6561 7469 0.tar.gz, creati │ │ │ │ │ +0003f4c0: 6f6e 3a20 2020 2020 2020 2020 2048 656c on: Hel │ │ │ │ │ +0003f4d0: 6c6f 2057 6f72 6c64 2e20 2020 2020 2020 lo World. │ │ │ │ │ +0003f4e0: 2020 286c 696e 6520 2020 3629 0a2a 2061 (line 6).* a │ │ │ │ │ +0003f4f0: 6d68 656c 6c6f 2d31 2e30 2e74 6172 2e67 mhello-1.0.tar.g │ │ │ │ │ +0003f500: 7a2c 206c 6f63 6174 696f 6e3a 2020 2020 z, location: │ │ │ │ │ +0003f510: 2020 2020 2020 5573 6520 4361 7365 732e Use Cases. │ │ │ │ │ +0003f520: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003f530: 2020 2036 290a 2a20 616d 6865 6c6c 6f2d 6).* amhello- │ │ │ │ │ +0003f540: 312e 302e 7461 722e 677a 2c20 7573 6520 1.0.tar.gz, use │ │ │ │ │ +0003f550: 6361 7365 733a 2020 2020 2020 2020 2055 cases: U │ │ │ │ │ +0003f560: 7365 2043 6173 6573 2e20 2020 2020 2020 se Cases. │ │ │ │ │ +0003f570: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +0003f580: 2041 4d5f 4343 4153 464c 4147 5320 616e AM_CCASFLAGS an │ │ │ │ │ +0003f590: 6420 4343 4153 464c 4147 533a 2020 2020 d CCASFLAGS: │ │ │ │ │ +0003f5a0: 2020 2020 2020 2020 466c 6167 2056 6172 Flag Var │ │ │ │ │ +0003f5b0: 6961 626c 6573 204f 7264 6572 696e 672e iables Ordering. │ │ │ │ │ +0003f5c0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 0003f5d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f5e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f5f0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -0003f600: 696e 6520 2032 3029 0a2a 2041 4d5f 4346 ine 20).* AM_CF │ │ │ │ │ -0003f610: 4c41 4753 2061 6e64 2043 464c 4147 533a LAGS and CFLAGS: │ │ │ │ │ -0003f620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f630: 2020 466c 6167 2056 6172 6961 626c 6573 Flag Variables │ │ │ │ │ -0003f640: 204f 7264 6572 696e 672e 0a20 2020 2020 Ordering.. │ │ │ │ │ +0003f5f0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +0003f600: 6c69 6e65 2020 3230 290a 2a20 414d 5f43 line 20).* AM_C │ │ │ │ │ +0003f610: 464c 4147 5320 616e 6420 4346 4c41 4753 FLAGS and CFLAGS │ │ │ │ │ +0003f620: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0003f630: 2020 2046 6c61 6720 5661 7269 6162 6c65 Flag Variable │ │ │ │ │ +0003f640: 7320 4f72 6465 7269 6e67 2e0a 2020 2020 s Ordering.. │ │ │ │ │ 0003f650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f680: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003f690: 3230 290a 2a20 414d 5f43 4f4e 4449 5449 20).* AM_CONDITI │ │ │ │ │ -0003f6a0: 4f4e 414c 2061 6e64 2053 5542 4449 5253 ONAL and SUBDIRS │ │ │ │ │ -0003f6b0: 3a20 2020 2020 2020 2020 2020 2053 7562 : Sub │ │ │ │ │ -0003f6c0: 6469 7265 6374 6f72 6965 7320 7769 7468 directories with │ │ │ │ │ -0003f6d0: 2041 4d5f 434f 4e44 4954 494f 4e41 4c2e AM_CONDITIONAL. │ │ │ │ │ -0003f6e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003f680: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003f690: 2032 3029 0a2a 2041 4d5f 434f 4e44 4954 20).* AM_CONDIT │ │ │ │ │ +0003f6a0: 494f 4e41 4c20 616e 6420 5355 4244 4952 IONAL and SUBDIR │ │ │ │ │ +0003f6b0: 533a 2020 2020 2020 2020 2020 2020 5375 S: Su │ │ │ │ │ +0003f6c0: 6264 6972 6563 746f 7269 6573 2077 6974 bdirectories wit │ │ │ │ │ +0003f6d0: 6820 414d 5f43 4f4e 4449 5449 4f4e 414c h AM_CONDITIONAL │ │ │ │ │ +0003f6e0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 0003f6f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f710: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0003f720: 6c69 6e65 2020 2036 290a 2a20 414d 5f43 line 6).* AM_C │ │ │ │ │ -0003f730: 5050 464c 4147 5320 616e 6420 4350 5046 PPFLAGS and CPPF │ │ │ │ │ -0003f740: 4c41 4753 3a20 2020 2020 2020 2020 2020 LAGS: │ │ │ │ │ -0003f750: 2020 2046 6c61 6720 5661 7269 6162 6c65 Flag Variable │ │ │ │ │ -0003f760: 7320 4f72 6465 7269 6e67 2e0a 2020 2020 s Ordering.. │ │ │ │ │ +0003f710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003f720: 286c 696e 6520 2020 3629 0a2a 2041 4d5f (line 6).* AM_ │ │ │ │ │ +0003f730: 4350 5046 4c41 4753 2061 6e64 2043 5050 CPPFLAGS and CPP │ │ │ │ │ +0003f740: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ +0003f750: 2020 2020 466c 6167 2056 6172 6961 626c Flag Variabl │ │ │ │ │ +0003f760: 6573 204f 7264 6572 696e 672e 0a20 2020 es Ordering.. │ │ │ │ │ 0003f770: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f7a0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003f7b0: 2032 3029 0a2a 2041 4d5f 4358 5846 4c41 20).* AM_CXXFLA │ │ │ │ │ -0003f7c0: 4753 2061 6e64 2043 5858 464c 4147 533a GS and CXXFLAGS: │ │ │ │ │ -0003f7d0: 2020 2020 2020 2020 2020 2020 2020 466c Fl │ │ │ │ │ -0003f7e0: 6167 2056 6172 6961 626c 6573 204f 7264 ag Variables Ord │ │ │ │ │ -0003f7f0: 6572 696e 672e 0a20 2020 2020 2020 2020 ering.. │ │ │ │ │ +0003f7a0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003f7b0: 2020 3230 290a 2a20 414d 5f43 5858 464c 20).* AM_CXXFL │ │ │ │ │ +0003f7c0: 4147 5320 616e 6420 4358 5846 4c41 4753 AGS and CXXFLAGS │ │ │ │ │ +0003f7d0: 3a20 2020 2020 2020 2020 2020 2020 2046 : F │ │ │ │ │ +0003f7e0: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ +0003f7f0: 6465 7269 6e67 2e0a 2020 2020 2020 2020 dering.. │ │ │ │ │ 0003f800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f830: 2020 2020 2028 6c69 6e65 2020 3230 290a (line 20). │ │ │ │ │ -0003f840: 2a20 414d 5f46 4346 4c41 4753 2061 6e64 * AM_FCFLAGS and │ │ │ │ │ -0003f850: 2046 4346 4c41 4753 3a20 2020 2020 2020 FCFLAGS: │ │ │ │ │ -0003f860: 2020 2020 2020 2020 2046 6c61 6720 5661 Flag Va │ │ │ │ │ -0003f870: 7269 6162 6c65 7320 4f72 6465 7269 6e67 riables Ordering │ │ │ │ │ -0003f880: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +0003f830: 2020 2020 2020 286c 696e 6520 2032 3029 (line 20) │ │ │ │ │ +0003f840: 0a2a 2041 4d5f 4643 464c 4147 5320 616e .* AM_FCFLAGS an │ │ │ │ │ +0003f850: 6420 4643 464c 4147 533a 2020 2020 2020 d FCFLAGS: │ │ │ │ │ +0003f860: 2020 2020 2020 2020 2020 466c 6167 2056 Flag V │ │ │ │ │ +0003f870: 6172 6961 626c 6573 204f 7264 6572 696e ariables Orderin │ │ │ │ │ +0003f880: 672e 0a20 2020 2020 2020 2020 2020 2020 g.. │ │ │ │ │ 0003f890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f8a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f8b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f8c0: 286c 696e 6520 2032 3029 0a2a 2041 4d5f (line 20).* AM_ │ │ │ │ │ -0003f8d0: 4646 4c41 4753 2061 6e64 2046 464c 4147 FFLAGS and FFLAG │ │ │ │ │ -0003f8e0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -0003f8f0: 2020 2020 466c 6167 2056 6172 6961 626c Flag Variabl │ │ │ │ │ -0003f900: 6573 204f 7264 6572 696e 672e 0a20 2020 es Ordering.. │ │ │ │ │ +0003f8c0: 2028 6c69 6e65 2020 3230 290a 2a20 414d (line 20).* AM │ │ │ │ │ +0003f8d0: 5f46 464c 4147 5320 616e 6420 4646 4c41 _FFLAGS and FFLA │ │ │ │ │ +0003f8e0: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ +0003f8f0: 2020 2020 2046 6c61 6720 5661 7269 6162 Flag Variab │ │ │ │ │ +0003f900: 6c65 7320 4f72 6465 7269 6e67 2e0a 2020 les Ordering.. │ │ │ │ │ 0003f910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f930: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f940: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0003f950: 2020 3230 290a 2a20 414d 5f47 434a 464c 20).* AM_GCJFL │ │ │ │ │ -0003f960: 4147 5320 616e 6420 4743 4a46 4c41 4753 AGS and GCJFLAGS │ │ │ │ │ -0003f970: 3a20 2020 2020 2020 2020 2020 2020 2046 : F │ │ │ │ │ -0003f980: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ -0003f990: 6465 7269 6e67 2e0a 2020 2020 2020 2020 dering.. │ │ │ │ │ +0003f940: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0003f950: 6520 2032 3029 0a2a 2041 4d5f 4743 4a46 e 20).* AM_GCJF │ │ │ │ │ +0003f960: 4c41 4753 2061 6e64 2047 434a 464c 4147 LAGS and GCJFLAG │ │ │ │ │ +0003f970: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +0003f980: 466c 6167 2056 6172 6961 626c 6573 204f Flag Variables O │ │ │ │ │ +0003f990: 7264 6572 696e 672e 0a20 2020 2020 2020 rdering.. │ │ │ │ │ 0003f9a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f9b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003f9c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003f9d0: 2020 2020 2020 286c 696e 6520 2032 3029 (line 20) │ │ │ │ │ -0003f9e0: 0a2a 2041 4d5f 494e 4954 5f41 5554 4f4d .* AM_INIT_AUTOM │ │ │ │ │ -0003f9f0: 414b 452c 2065 7861 6d70 6c65 2075 7365 AKE, example use │ │ │ │ │ -0003fa00: 3a20 2020 2020 2020 2020 436f 6d70 6c65 : Comple │ │ │ │ │ -0003fa10: 7465 2e20 2020 2020 2020 2020 2020 2028 te. ( │ │ │ │ │ -0003fa20: 6c69 6e65 2020 3131 290a 2a20 414d 5f4c line 11).* AM_L │ │ │ │ │ -0003fa30: 4446 4c41 4753 2061 6e64 204c 4446 4c41 DFLAGS and LDFLA │ │ │ │ │ -0003fa40: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ -0003fa50: 2020 2046 6c61 6720 5661 7269 6162 6c65 Flag Variable │ │ │ │ │ -0003fa60: 7320 4f72 6465 7269 6e67 2e0a 2020 2020 s Ordering.. │ │ │ │ │ +0003f9d0: 2020 2020 2020 2028 6c69 6e65 2020 3230 (line 20 │ │ │ │ │ +0003f9e0: 290a 2a20 414d 5f49 4e49 545f 4155 544f ).* AM_INIT_AUTO │ │ │ │ │ +0003f9f0: 4d41 4b45 2c20 6578 616d 706c 6520 7573 MAKE, example us │ │ │ │ │ +0003fa00: 653a 2020 2020 2020 2020 2043 6f6d 706c e: Compl │ │ │ │ │ +0003fa10: 6574 652e 2020 2020 2020 2020 2020 2020 ete. │ │ │ │ │ +0003fa20: 286c 696e 6520 2031 3129 0a2a 2041 4d5f (line 11).* AM_ │ │ │ │ │ +0003fa30: 4c44 464c 4147 5320 616e 6420 4c44 464c LDFLAGS and LDFL │ │ │ │ │ +0003fa40: 4147 533a 2020 2020 2020 2020 2020 2020 AGS: │ │ │ │ │ +0003fa50: 2020 2020 466c 6167 2056 6172 6961 626c Flag Variabl │ │ │ │ │ +0003fa60: 6573 204f 7264 6572 696e 672e 0a20 2020 es Ordering.. │ │ │ │ │ 0003fa70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fa80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fa90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003faa0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003fab0: 2032 3029 0a2a 2041 4d5f 4c46 4c41 4753 20).* AM_LFLAGS │ │ │ │ │ -0003fac0: 2061 6e64 204c 464c 4147 533a 2020 2020 and LFLAGS: │ │ │ │ │ -0003fad0: 2020 2020 2020 2020 2020 2020 2020 466c Fl │ │ │ │ │ -0003fae0: 6167 2056 6172 6961 626c 6573 204f 7264 ag Variables Ord │ │ │ │ │ -0003faf0: 6572 696e 672e 0a20 2020 2020 2020 2020 ering.. │ │ │ │ │ +0003faa0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003fab0: 2020 3230 290a 2a20 414d 5f4c 464c 4147 20).* AM_LFLAG │ │ │ │ │ +0003fac0: 5320 616e 6420 4c46 4c41 4753 3a20 2020 S and LFLAGS: │ │ │ │ │ +0003fad0: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ +0003fae0: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ +0003faf0: 6465 7269 6e67 2e0a 2020 2020 2020 2020 dering.. │ │ │ │ │ 0003fb00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fb10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fb20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fb30: 2020 2020 2028 6c69 6e65 2020 3230 290a (line 20). │ │ │ │ │ -0003fb40: 2a20 414d 5f4c 4942 544f 4f4c 464c 4147 * AM_LIBTOOLFLAG │ │ │ │ │ -0003fb50: 5320 616e 6420 4c49 4254 4f4f 4c46 4c41 S and LIBTOOLFLA │ │ │ │ │ -0003fb60: 4753 3a20 2020 2020 2046 6c61 6720 5661 GS: Flag Va │ │ │ │ │ -0003fb70: 7269 6162 6c65 7320 4f72 6465 7269 6e67 riables Ordering │ │ │ │ │ -0003fb80: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +0003fb30: 2020 2020 2020 286c 696e 6520 2032 3029 (line 20) │ │ │ │ │ +0003fb40: 0a2a 2041 4d5f 4c49 4254 4f4f 4c46 4c41 .* AM_LIBTOOLFLA │ │ │ │ │ +0003fb50: 4753 2061 6e64 204c 4942 544f 4f4c 464c GS and LIBTOOLFL │ │ │ │ │ +0003fb60: 4147 533a 2020 2020 2020 466c 6167 2056 AGS: Flag V │ │ │ │ │ +0003fb70: 6172 6961 626c 6573 204f 7264 6572 696e ariables Orderin │ │ │ │ │ +0003fb80: 672e 0a20 2020 2020 2020 2020 2020 2020 g.. │ │ │ │ │ 0003fb90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fbb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fbc0: 286c 696e 6520 2032 3029 0a2a 2041 4d5f (line 20).* AM_ │ │ │ │ │ -0003fbd0: 4d41 494e 5441 494e 4552 5f4d 4f44 452c MAINTAINER_MODE, │ │ │ │ │ -0003fbe0: 2070 7572 706f 7365 3a20 2020 2020 2020 purpose: │ │ │ │ │ -0003fbf0: 2020 2020 6d61 696e 7461 696e 6572 2d6d maintainer-m │ │ │ │ │ -0003fc00: 6f64 652e 2020 2020 2028 6c69 6e65 2020 ode. (line │ │ │ │ │ -0003fc10: 3336 290a 2a20 414d 5f4f 424a 4346 4c41 36).* AM_OBJCFLA │ │ │ │ │ -0003fc20: 4753 2061 6e64 204f 424a 4346 4c41 4753 GS and OBJCFLAGS │ │ │ │ │ -0003fc30: 3a20 2020 2020 2020 2020 2020 2046 6c61 : Fla │ │ │ │ │ -0003fc40: 6720 5661 7269 6162 6c65 7320 4f72 6465 g Variables Orde │ │ │ │ │ -0003fc50: 7269 6e67 2e0a 2020 2020 2020 2020 2020 ring.. │ │ │ │ │ +0003fbc0: 2028 6c69 6e65 2020 3230 290a 2a20 414d (line 20).* AM │ │ │ │ │ +0003fbd0: 5f4d 4149 4e54 4149 4e45 525f 4d4f 4445 _MAINTAINER_MODE │ │ │ │ │ +0003fbe0: 2c20 7075 7270 6f73 653a 2020 2020 2020 , purpose: │ │ │ │ │ +0003fbf0: 2020 2020 206d 6169 6e74 6169 6e65 722d maintainer- │ │ │ │ │ +0003fc00: 6d6f 6465 2e20 2020 2020 286c 696e 6520 mode. (line │ │ │ │ │ +0003fc10: 2033 3629 0a2a 2041 4d5f 4f42 4a43 464c 36).* AM_OBJCFL │ │ │ │ │ +0003fc20: 4147 5320 616e 6420 4f42 4a43 464c 4147 AGS and OBJCFLAG │ │ │ │ │ +0003fc30: 533a 2020 2020 2020 2020 2020 2020 466c S: Fl │ │ │ │ │ +0003fc40: 6167 2056 6172 6961 626c 6573 204f 7264 ag Variables Ord │ │ │ │ │ +0003fc50: 6572 696e 672e 0a20 2020 2020 2020 2020 ering.. │ │ │ │ │ 0003fc60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fc70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fc80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fc90: 2020 2020 286c 696e 6520 2032 3029 0a2a (line 20).* │ │ │ │ │ -0003fca0: 2041 4d5f 5246 4c41 4753 2061 6e64 2052 AM_RFLAGS and R │ │ │ │ │ -0003fcb0: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ -0003fcc0: 2020 2020 2020 2020 466c 6167 2056 6172 Flag Var │ │ │ │ │ -0003fcd0: 6961 626c 6573 204f 7264 6572 696e 672e iables Ordering. │ │ │ │ │ -0003fce0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003fc90: 2020 2020 2028 6c69 6e65 2020 3230 290a (line 20). │ │ │ │ │ +0003fca0: 2a20 414d 5f52 464c 4147 5320 616e 6420 * AM_RFLAGS and │ │ │ │ │ +0003fcb0: 5246 4c41 4753 3a20 2020 2020 2020 2020 RFLAGS: │ │ │ │ │ +0003fcc0: 2020 2020 2020 2020 2046 6c61 6720 5661 Flag Va │ │ │ │ │ +0003fcd0: 7269 6162 6c65 7320 4f72 6465 7269 6e67 riables Ordering │ │ │ │ │ +0003fce0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 0003fcf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fd00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fd10: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0003fd20: 6c69 6e65 2020 3230 290a 2a20 414d 5f55 line 20).* AM_U │ │ │ │ │ -0003fd30: 5043 464c 4147 5320 616e 6420 5550 4346 PCFLAGS and UPCF │ │ │ │ │ -0003fd40: 4c41 4753 3a20 2020 2020 2020 2020 2020 LAGS: │ │ │ │ │ -0003fd50: 2020 2046 6c61 6720 5661 7269 6162 6c65 Flag Variable │ │ │ │ │ -0003fd60: 7320 4f72 6465 7269 6e67 2e0a 2020 2020 s Ordering.. │ │ │ │ │ +0003fd10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003fd20: 286c 696e 6520 2032 3029 0a2a 2041 4d5f (line 20).* AM_ │ │ │ │ │ +0003fd30: 5550 4346 4c41 4753 2061 6e64 2055 5043 UPCFLAGS and UPC │ │ │ │ │ +0003fd40: 464c 4147 533a 2020 2020 2020 2020 2020 FLAGS: │ │ │ │ │ +0003fd50: 2020 2020 466c 6167 2056 6172 6961 626c Flag Variabl │ │ │ │ │ +0003fd60: 6573 204f 7264 6572 696e 672e 0a20 2020 es Ordering.. │ │ │ │ │ 0003fd70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fd80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fd90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fda0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0003fdb0: 2032 3029 0a2a 2041 4d5f 5946 4c41 4753 20).* AM_YFLAGS │ │ │ │ │ -0003fdc0: 2061 6e64 2059 464c 4147 533a 2020 2020 and YFLAGS: │ │ │ │ │ -0003fdd0: 2020 2020 2020 2020 2020 2020 2020 466c Fl │ │ │ │ │ -0003fde0: 6167 2056 6172 6961 626c 6573 204f 7264 ag Variables Ord │ │ │ │ │ -0003fdf0: 6572 696e 672e 0a20 2020 2020 2020 2020 ering.. │ │ │ │ │ +0003fda0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0003fdb0: 2020 3230 290a 2a20 414d 5f59 464c 4147 20).* AM_YFLAG │ │ │ │ │ +0003fdc0: 5320 616e 6420 5946 4c41 4753 3a20 2020 S and YFLAGS: │ │ │ │ │ +0003fdd0: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ +0003fde0: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ +0003fdf0: 6465 7269 6e67 2e0a 2020 2020 2020 2020 dering.. │ │ │ │ │ 0003fe00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fe10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003fe20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fe30: 2020 2020 2028 6c69 6e65 2020 3230 290a (line 20). │ │ │ │ │ -0003fe40: 2a20 616e 7369 326b 6e72 3a20 2020 2020 * ansi2knr: │ │ │ │ │ +0003fe30: 2020 2020 2020 286c 696e 6520 2032 3029 (line 20) │ │ │ │ │ +0003fe40: 0a2a 2061 6e73 6932 6b6e 723a 2020 2020 .* ansi2knr: │ │ │ │ │ 0003fe50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fe60: 2020 2020 2020 2020 2041 4e53 492e 2020 ANSI. │ │ │ │ │ -0003fe70: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -0003fe80: 696e 6520 2032 3229 0a2a 2061 6e73 6932 ine 22).* ansi2 │ │ │ │ │ -0003fe90: 6b6e 7220 3c31 3e3a 2020 2020 2020 2020 knr <1>: │ │ │ │ │ +0003fe60: 2020 2020 2020 2020 2020 414e 5349 2e20 ANSI. │ │ │ │ │ +0003fe70: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +0003fe80: 6c69 6e65 2020 3232 290a 2a20 616e 7369 line 22).* ansi │ │ │ │ │ +0003fe90: 326b 6e72 203c 313e 3a20 2020 2020 2020 2knr <1>: │ │ │ │ │ 0003fea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003feb0: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ -0003fec0: 2020 2020 2020 2028 6c69 6e65 2020 3239 (line 29 │ │ │ │ │ -0003fed0: 290a 2a20 616e 7369 326b 6e72 2061 6e64 ).* ansi2knr and │ │ │ │ │ -0003fee0: 204c 4942 4f42 4a53 3a20 2020 2020 2020 LIBOBJS: │ │ │ │ │ -0003fef0: 2020 2020 2020 2020 2020 2041 4e53 492e ANSI. │ │ │ │ │ -0003ff00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ff10: 286c 696e 6520 2035 3829 0a2a 2061 6e73 (line 58).* ans │ │ │ │ │ -0003ff20: 6932 6b6e 7220 616e 6420 4c54 4c49 424f i2knr and LTLIBO │ │ │ │ │ -0003ff30: 424a 533a 2020 2020 2020 2020 2020 2020 BJS: │ │ │ │ │ -0003ff40: 2020 2020 414e 5349 2e20 2020 2020 2020 ANSI. │ │ │ │ │ -0003ff50: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0003ff60: 3538 290a 2a20 4170 7065 6e64 206f 7065 58).* Append ope │ │ │ │ │ -0003ff70: 7261 746f 723a 2020 2020 2020 2020 2020 rator: │ │ │ │ │ -0003ff80: 2020 2020 2020 2020 2020 2020 2047 656e Gen │ │ │ │ │ -0003ff90: 6572 616c 204f 7065 7261 7469 6f6e 2e20 eral Operation. │ │ │ │ │ -0003ffa0: 2020 286c 696e 6520 2032 3429 0a2a 2041 (line 24).* A │ │ │ │ │ -0003ffb0: 5247 5f4d 4158 3a20 2020 2020 2020 2020 RG_MAX: │ │ │ │ │ +0003feb0: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ +0003fec0: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +0003fed0: 3929 0a2a 2061 6e73 6932 6b6e 7220 616e 9).* ansi2knr an │ │ │ │ │ +0003fee0: 6420 4c49 424f 424a 533a 2020 2020 2020 d LIBOBJS: │ │ │ │ │ +0003fef0: 2020 2020 2020 2020 2020 2020 414e 5349 ANSI │ │ │ │ │ +0003ff00: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003ff10: 2028 6c69 6e65 2020 3538 290a 2a20 616e (line 58).* an │ │ │ │ │ +0003ff20: 7369 326b 6e72 2061 6e64 204c 544c 4942 si2knr and LTLIB │ │ │ │ │ +0003ff30: 4f42 4a53 3a20 2020 2020 2020 2020 2020 OBJS: │ │ │ │ │ +0003ff40: 2020 2020 2041 4e53 492e 2020 2020 2020 ANSI. │ │ │ │ │ +0003ff50: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0003ff60: 2035 3829 0a2a 2041 7070 656e 6420 6f70 58).* Append op │ │ │ │ │ +0003ff70: 6572 6174 6f72 3a20 2020 2020 2020 2020 erator: │ │ │ │ │ +0003ff80: 2020 2020 2020 2020 2020 2020 2020 4765 Ge │ │ │ │ │ +0003ff90: 6e65 7261 6c20 4f70 6572 6174 696f 6e2e neral Operation. │ │ │ │ │ +0003ffa0: 2020 2028 6c69 6e65 2020 3234 290a 2a20 (line 24).* │ │ │ │ │ +0003ffb0: 4152 475f 4d41 583a 2020 2020 2020 2020 ARG_MAX: │ │ │ │ │ 0003ffc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ffd0: 2020 2020 2020 4c65 6e67 7468 204c 696d Length Lim │ │ │ │ │ -0003ffe0: 6974 6174 696f 6e73 2e20 2028 6c69 6e65 itations. (line │ │ │ │ │ -0003fff0: 2020 2036 290a 2a20 6175 746f 6765 6e2e 6).* autogen. │ │ │ │ │ -00040000: 7368 2061 6e64 2061 7574 6f72 6563 6f6e sh and autorecon │ │ │ │ │ -00040010: 663a 2020 2020 2020 2020 2020 2020 2045 f: E │ │ │ │ │ -00040020: 7272 6f72 2072 6571 7569 7265 6420 6669 rror required fi │ │ │ │ │ -00040030: 6c65 206c 746d 6169 6e2e 7368 206e 6f74 le ltmain.sh not │ │ │ │ │ -00040040: 2066 6f75 6e64 2e0a 2020 2020 2020 2020 found.. │ │ │ │ │ +0003ffd0: 2020 2020 2020 204c 656e 6774 6820 4c69 Length Li │ │ │ │ │ +0003ffe0: 6d69 7461 7469 6f6e 732e 2020 286c 696e mitations. (lin │ │ │ │ │ +0003fff0: 6520 2020 3629 0a2a 2061 7574 6f67 656e e 6).* autogen │ │ │ │ │ +00040000: 2e73 6820 616e 6420 6175 746f 7265 636f .sh and autoreco │ │ │ │ │ +00040010: 6e66 3a20 2020 2020 2020 2020 2020 2020 nf: │ │ │ │ │ +00040020: 4572 726f 7220 7265 7175 6972 6564 2066 Error required f │ │ │ │ │ +00040030: 696c 6520 6c74 6d61 696e 2e73 6820 6e6f ile ltmain.sh no │ │ │ │ │ +00040040: 7420 666f 756e 642e 0a20 2020 2020 2020 t found.. │ │ │ │ │ 00040050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040080: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00040090: 0a2a 2061 7574 6f6d 3474 653a 2020 2020 .* autom4te: │ │ │ │ │ +00040080: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00040090: 290a 2a20 6175 746f 6d34 7465 3a20 2020 ).* autom4te: │ │ │ │ │ 000400a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000400b0: 2020 2020 2020 2020 2020 6163 6c6f 6361 acloca │ │ │ │ │ -000400c0: 6c20 496e 766f 6361 7469 6f6e 2e20 2028 l Invocation. ( │ │ │ │ │ -000400d0: 6c69 6e65 2020 3434 290a 2a20 4175 746f line 44).* Auto │ │ │ │ │ -000400e0: 6d61 6b65 2063 6f6e 7374 7261 696e 7473 make constraints │ │ │ │ │ -000400f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00040100: 2020 2049 6e74 726f 6475 6374 696f 6e2e Introduction. │ │ │ │ │ -00040110: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ -00040120: 3229 0a2a 2061 7574 6f6d 616b 6520 6f70 2).* automake op │ │ │ │ │ -00040130: 7469 6f6e 733a 2020 2020 2020 2020 2020 tions: │ │ │ │ │ -00040140: 2020 2020 2020 2020 2020 2020 6175 746f auto │ │ │ │ │ -00040150: 6d61 6b65 2049 6e76 6f63 6174 696f 6e2e make Invocation. │ │ │ │ │ -00040160: 2028 6c69 6e65 2020 3337 290a 2a20 4175 (line 37).* Au │ │ │ │ │ -00040170: 746f 6d61 6b65 2070 6172 7365 722c 206c tomake parser, l │ │ │ │ │ -00040180: 696d 6974 6174 696f 6e73 206f 663a 2020 imitations of: │ │ │ │ │ -00040190: 2020 2020 2047 656e 6572 616c 204f 7065 General Ope │ │ │ │ │ -000401a0: 7261 7469 6f6e 2e20 2020 286c 696e 6520 ration. (line │ │ │ │ │ -000401b0: 2033 3329 0a2a 2041 7574 6f6d 616b 6520 33).* Automake │ │ │ │ │ -000401c0: 7265 7175 6972 656d 656e 7473 3a20 2020 requirements: │ │ │ │ │ -000401d0: 2020 2020 2020 2020 2020 2020 2020 496e In │ │ │ │ │ -000401e0: 7472 6f64 7563 7469 6f6e 2e20 2020 2020 troduction. │ │ │ │ │ -000401f0: 2020 2028 6c69 6e65 2020 3237 290a 2a20 (line 27).* │ │ │ │ │ -00040200: 4175 746f 6d61 6b65 2072 6571 7569 7265 Automake require │ │ │ │ │ -00040210: 6d65 6e74 7320 3c31 3e3a 2020 2020 2020 ments <1>: │ │ │ │ │ -00040220: 2020 2020 2020 2052 6571 7569 7265 6d65 Requireme │ │ │ │ │ -00040230: 6e74 732e 2020 2020 2020 2020 286c 696e nts. (lin │ │ │ │ │ -00040240: 6520 2020 3629 0a2a 2061 7574 6f6d 616b e 6).* automak │ │ │ │ │ -00040250: 652c 2069 6e76 6f63 6174 696f 6e3a 2020 e, invocation: │ │ │ │ │ +000400b0: 2020 2020 2020 2020 2020 2061 636c 6f63 acloc │ │ │ │ │ +000400c0: 616c 2049 6e76 6f63 6174 696f 6e2e 2020 al Invocation. │ │ │ │ │ +000400d0: 286c 696e 6520 2034 3429 0a2a 2041 7574 (line 44).* Aut │ │ │ │ │ +000400e0: 6f6d 616b 6520 636f 6e73 7472 6169 6e74 omake constraint │ │ │ │ │ +000400f0: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ +00040100: 2020 2020 496e 7472 6f64 7563 7469 6f6e Introduction │ │ │ │ │ +00040110: 2e20 2020 2020 2020 2028 6c69 6e65 2020 . (line │ │ │ │ │ +00040120: 3232 290a 2a20 6175 746f 6d61 6b65 206f 22).* automake o │ │ │ │ │ +00040130: 7074 696f 6e73 3a20 2020 2020 2020 2020 ptions: │ │ │ │ │ +00040140: 2020 2020 2020 2020 2020 2020 2061 7574 aut │ │ │ │ │ +00040150: 6f6d 616b 6520 496e 766f 6361 7469 6f6e omake Invocation │ │ │ │ │ +00040160: 2e20 286c 696e 6520 2033 3729 0a2a 2041 . (line 37).* A │ │ │ │ │ +00040170: 7574 6f6d 616b 6520 7061 7273 6572 2c20 utomake parser, │ │ │ │ │ +00040180: 6c69 6d69 7461 7469 6f6e 7320 6f66 3a20 limitations of: │ │ │ │ │ +00040190: 2020 2020 2020 4765 6e65 7261 6c20 4f70 General Op │ │ │ │ │ +000401a0: 6572 6174 696f 6e2e 2020 2028 6c69 6e65 eration. (line │ │ │ │ │ +000401b0: 2020 3333 290a 2a20 4175 746f 6d61 6b65 33).* Automake │ │ │ │ │ +000401c0: 2072 6571 7569 7265 6d65 6e74 733a 2020 requirements: │ │ │ │ │ +000401d0: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ │ +000401e0: 6e74 726f 6475 6374 696f 6e2e 2020 2020 ntroduction. │ │ │ │ │ +000401f0: 2020 2020 286c 696e 6520 2032 3729 0a2a (line 27).* │ │ │ │ │ +00040200: 2041 7574 6f6d 616b 6520 7265 7175 6972 Automake requir │ │ │ │ │ +00040210: 656d 656e 7473 203c 313e 3a20 2020 2020 ements <1>: │ │ │ │ │ +00040220: 2020 2020 2020 2020 5265 7175 6972 656d Requirem │ │ │ │ │ +00040230: 656e 7473 2e20 2020 2020 2020 2028 6c69 ents. (li │ │ │ │ │ +00040240: 6e65 2020 2036 290a 2a20 6175 746f 6d61 ne 6).* automa │ │ │ │ │ +00040250: 6b65 2c20 696e 766f 6361 7469 6f6e 3a20 ke, invocation: │ │ │ │ │ 00040260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040270: 6175 746f 6d61 6b65 2049 6e76 6f63 6174 automake Invocat │ │ │ │ │ -00040280: 696f 6e2e 2028 6c69 6e65 2020 2036 290a ion. (line 6). │ │ │ │ │ -00040290: 2a20 6175 746f 6d61 6b65 2c20 696e 766f * automake, invo │ │ │ │ │ -000402a0: 6b69 6e67 3a20 2020 2020 2020 2020 2020 king: │ │ │ │ │ -000402b0: 2020 2020 2020 2020 2061 7574 6f6d 616b automak │ │ │ │ │ -000402c0: 6520 496e 766f 6361 7469 6f6e 2e20 286c e Invocation. (l │ │ │ │ │ -000402d0: 696e 6520 2020 3629 0a2a 2041 7574 6f6d ine 6).* Autom │ │ │ │ │ -000402e0: 616b 652c 2072 6563 7572 7369 7665 206f ake, recursive o │ │ │ │ │ -000402f0: 7065 7261 7469 6f6e 3a20 2020 2020 2020 peration: │ │ │ │ │ -00040300: 2020 4765 6e65 7261 6c20 4f70 6572 6174 General Operat │ │ │ │ │ -00040310: 696f 6e2e 2020 2028 6c69 6e65 2020 3538 ion. (line 58 │ │ │ │ │ -00040320: 290a 2a20 4175 746f 6d61 7469 6320 6465 ).* Automatic de │ │ │ │ │ -00040330: 7065 6e64 656e 6379 2074 7261 636b 696e pendency trackin │ │ │ │ │ -00040340: 673a 2020 2020 2020 2020 2044 6570 656e g: Depen │ │ │ │ │ -00040350: 6465 6e63 6965 732e 2020 2020 2020 2020 dencies. │ │ │ │ │ -00040360: 286c 696e 6520 2031 3129 0a2a 2041 7574 (line 11).* Aut │ │ │ │ │ -00040370: 6f6d 6174 6963 206c 696e 6b65 7220 7365 omatic linker se │ │ │ │ │ -00040380: 6c65 6374 696f 6e3a 2020 2020 2020 2020 lection: │ │ │ │ │ -00040390: 2020 2020 486f 7720 7468 6520 4c69 6e6b How the Link │ │ │ │ │ -000403a0: 6572 2069 7320 4368 6f73 656e 2e0a 2020 er is Chosen.. │ │ │ │ │ +00040270: 2061 7574 6f6d 616b 6520 496e 766f 6361 automake Invoca │ │ │ │ │ +00040280: 7469 6f6e 2e20 286c 696e 6520 2020 3629 tion. (line 6) │ │ │ │ │ +00040290: 0a2a 2061 7574 6f6d 616b 652c 2069 6e76 .* automake, inv │ │ │ │ │ +000402a0: 6f6b 696e 673a 2020 2020 2020 2020 2020 oking: │ │ │ │ │ +000402b0: 2020 2020 2020 2020 2020 6175 746f 6d61 automa │ │ │ │ │ +000402c0: 6b65 2049 6e76 6f63 6174 696f 6e2e 2028 ke Invocation. ( │ │ │ │ │ +000402d0: 6c69 6e65 2020 2036 290a 2a20 4175 746f line 6).* Auto │ │ │ │ │ +000402e0: 6d61 6b65 2c20 7265 6375 7273 6976 6520 make, recursive │ │ │ │ │ +000402f0: 6f70 6572 6174 696f 6e3a 2020 2020 2020 operation: │ │ │ │ │ +00040300: 2020 2047 656e 6572 616c 204f 7065 7261 General Opera │ │ │ │ │ +00040310: 7469 6f6e 2e20 2020 286c 696e 6520 2035 tion. (line 5 │ │ │ │ │ +00040320: 3829 0a2a 2041 7574 6f6d 6174 6963 2064 8).* Automatic d │ │ │ │ │ +00040330: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ +00040340: 6e67 3a20 2020 2020 2020 2020 4465 7065 ng: Depe │ │ │ │ │ +00040350: 6e64 656e 6369 6573 2e20 2020 2020 2020 ndencies. │ │ │ │ │ +00040360: 2028 6c69 6e65 2020 3131 290a 2a20 4175 (line 11).* Au │ │ │ │ │ +00040370: 746f 6d61 7469 6320 6c69 6e6b 6572 2073 tomatic linker s │ │ │ │ │ +00040380: 656c 6563 7469 6f6e 3a20 2020 2020 2020 election: │ │ │ │ │ +00040390: 2020 2020 2048 6f77 2074 6865 204c 696e How the Lin │ │ │ │ │ +000403a0: 6b65 7220 6973 2043 686f 7365 6e2e 0a20 ker is Chosen.. │ │ │ │ │ 000403b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000403c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000403d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000403e0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -000403f0: 6520 2020 3629 0a2a 2061 7574 6f72 6563 e 6).* autorec │ │ │ │ │ -00040400: 6f6e 6620 616e 6420 6c69 6274 6f6f 6c69 onf and libtooli │ │ │ │ │ -00040410: 7a65 3a20 2020 2020 2020 2020 2020 2020 ze: │ │ │ │ │ -00040420: 4572 726f 7220 7265 7175 6972 6564 2066 Error required f │ │ │ │ │ -00040430: 696c 6520 6c74 6d61 696e 2e73 6820 6e6f ile ltmain.sh no │ │ │ │ │ -00040440: 7420 666f 756e 642e 0a20 2020 2020 2020 t found.. │ │ │ │ │ +000403e0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +000403f0: 6e65 2020 2036 290a 2a20 6175 746f 7265 ne 6).* autore │ │ │ │ │ +00040400: 636f 6e66 2061 6e64 206c 6962 746f 6f6c conf and libtool │ │ │ │ │ +00040410: 697a 653a 2020 2020 2020 2020 2020 2020 ize: │ │ │ │ │ +00040420: 2045 7272 6f72 2072 6571 7569 7265 6420 Error required │ │ │ │ │ +00040430: 6669 6c65 206c 746d 6169 6e2e 7368 206e file ltmain.sh n │ │ │ │ │ +00040440: 6f74 2066 6f75 6e64 2e0a 2020 2020 2020 ot found.. │ │ │ │ │ 00040450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040470: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040480: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00040490: 290a 2a20 6175 746f 7265 636f 6e66 2c20 ).* autoreconf, │ │ │ │ │ -000404a0: 6578 616d 706c 653a 2020 2020 2020 2020 example: │ │ │ │ │ -000404b0: 2020 2020 2020 2020 2020 2043 7265 6174 Creat │ │ │ │ │ -000404c0: 696e 6720 616d 6865 6c6c 6f2e 2020 2020 ing amhello. │ │ │ │ │ -000404d0: 286c 696e 6520 2035 3929 0a2a 2061 7574 (line 59).* aut │ │ │ │ │ -000404e0: 6f73 6361 6e3a 2020 2020 2020 2020 2020 oscan: │ │ │ │ │ +00040480: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00040490: 3629 0a2a 2061 7574 6f72 6563 6f6e 662c 6).* autoreconf, │ │ │ │ │ +000404a0: 2065 7861 6d70 6c65 3a20 2020 2020 2020 example: │ │ │ │ │ +000404b0: 2020 2020 2020 2020 2020 2020 4372 6561 Crea │ │ │ │ │ +000404c0: 7469 6e67 2061 6d68 656c 6c6f 2e20 2020 ting amhello. │ │ │ │ │ +000404d0: 2028 6c69 6e65 2020 3539 290a 2a20 6175 (line 59).* au │ │ │ │ │ +000404e0: 746f 7363 616e 3a20 2020 2020 2020 2020 toscan: │ │ │ │ │ 000404f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040500: 2020 2020 616d 6865 6c6c 6f27 7320 636f amhello's co │ │ │ │ │ -00040510: 6e66 6967 7572 652e 6163 2053 6574 7570 nfigure.ac Setup │ │ │ │ │ -00040520: 2045 7870 6c61 696e 6564 2e0a 2020 2020 Explained.. │ │ │ │ │ +00040500: 2020 2020 2061 6d68 656c 6c6f 2773 2063 amhello's c │ │ │ │ │ +00040510: 6f6e 6669 6775 7265 2e61 6320 5365 7475 onfigure.ac Setu │ │ │ │ │ +00040520: 7020 4578 706c 6169 6e65 642e 0a20 2020 p Explained.. │ │ │ │ │ 00040530: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040560: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00040570: 2038 3929 0a2a 2041 7574 6f74 6f6f 6c73 89).* Autotools │ │ │ │ │ -00040580: 2c20 696e 7472 6f64 7563 7469 6f6e 3a20 , introduction: │ │ │ │ │ -00040590: 2020 2020 2020 2020 2020 2020 2020 474e GN │ │ │ │ │ -000405a0: 5520 4275 696c 6420 5379 7374 656d 2e20 U Build System. │ │ │ │ │ -000405b0: 2020 2028 6c69 6e65 2020 3433 290a 2a20 (line 43).* │ │ │ │ │ -000405c0: 4175 746f 746f 6f6c 732c 2070 7572 706f Autotools, purpo │ │ │ │ │ -000405d0: 7365 3a20 2020 2020 2020 2020 2020 2020 se: │ │ │ │ │ -000405e0: 2020 2020 2020 2057 6879 2041 7574 6f74 Why Autot │ │ │ │ │ -000405f0: 6f6f 6c73 2e20 2020 2020 2020 286c 696e ools. (lin │ │ │ │ │ -00040600: 6520 2020 3629 0a2a 2061 7574 6f75 7064 e 6).* autoupd │ │ │ │ │ -00040610: 6174 653a 2020 2020 2020 2020 2020 2020 ate: │ │ │ │ │ +00040560: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00040570: 2020 3839 290a 2a20 4175 746f 746f 6f6c 89).* Autotool │ │ │ │ │ +00040580: 732c 2069 6e74 726f 6475 6374 696f 6e3a s, introduction: │ │ │ │ │ +00040590: 2020 2020 2020 2020 2020 2020 2020 2047 G │ │ │ │ │ +000405a0: 4e55 2042 7569 6c64 2053 7973 7465 6d2e NU Build System. │ │ │ │ │ +000405b0: 2020 2020 286c 696e 6520 2034 3329 0a2a (line 43).* │ │ │ │ │ +000405c0: 2041 7574 6f74 6f6f 6c73 2c20 7075 7270 Autotools, purp │ │ │ │ │ +000405d0: 6f73 653a 2020 2020 2020 2020 2020 2020 ose: │ │ │ │ │ +000405e0: 2020 2020 2020 2020 5768 7920 4175 746f Why Auto │ │ │ │ │ +000405f0: 746f 6f6c 732e 2020 2020 2020 2028 6c69 tools. (li │ │ │ │ │ +00040600: 6e65 2020 2036 290a 2a20 6175 746f 7570 ne 6).* autoup │ │ │ │ │ +00040610: 6461 7465 3a20 2020 2020 2020 2020 2020 date: │ │ │ │ │ 00040620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040630: 4f62 736f 6c65 7465 204d 6163 726f 732e Obsolete Macros. │ │ │ │ │ -00040640: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -00040650: 2a20 4175 7869 6c69 6172 7920 7072 6f67 * Auxiliary prog │ │ │ │ │ -00040660: 7261 6d73 3a20 2020 2020 2020 2020 2020 rams: │ │ │ │ │ -00040670: 2020 2020 2020 2020 2041 7578 696c 6961 Auxilia │ │ │ │ │ -00040680: 7279 2050 726f 6772 616d 732e 2020 286c ry Programs. (l │ │ │ │ │ -00040690: 696e 6520 2020 3629 0a2a 2041 766f 6964 ine 6).* Avoid │ │ │ │ │ -000406a0: 696e 6720 6d61 6e20 7061 6765 2072 656e ing man page ren │ │ │ │ │ -000406b0: 616d 696e 673a 2020 2020 2020 2020 2020 aming: │ │ │ │ │ -000406c0: 2020 4d61 6e20 5061 6765 732e 2020 2020 Man Pages. │ │ │ │ │ -000406d0: 2020 2020 2020 2028 6c69 6e65 2020 3534 (line 54 │ │ │ │ │ -000406e0: 290a 2a20 4176 6f69 6469 6e67 2070 6174 ).* Avoiding pat │ │ │ │ │ -000406f0: 6820 7374 7269 7070 696e 673a 2020 2020 h stripping: │ │ │ │ │ -00040700: 2020 2020 2020 2020 2020 2041 6c74 6572 Alter │ │ │ │ │ -00040710: 6e61 7469 7665 2e20 2020 2020 2020 2020 native. │ │ │ │ │ -00040720: 286c 696e 6520 2032 3329 0a2a 2042 696e (line 23).* Bin │ │ │ │ │ -00040730: 6172 7920 7061 636b 6167 653a 2020 2020 ary package: │ │ │ │ │ +00040630: 204f 6273 6f6c 6574 6520 4d61 6372 6f73 Obsolete Macros │ │ │ │ │ +00040640: 2e20 2020 2020 286c 696e 6520 2020 3629 . (line 6) │ │ │ │ │ +00040650: 0a2a 2041 7578 696c 6961 7279 2070 726f .* Auxiliary pro │ │ │ │ │ +00040660: 6772 616d 733a 2020 2020 2020 2020 2020 grams: │ │ │ │ │ +00040670: 2020 2020 2020 2020 2020 4175 7869 6c69 Auxili │ │ │ │ │ +00040680: 6172 7920 5072 6f67 7261 6d73 2e20 2028 ary Programs. ( │ │ │ │ │ +00040690: 6c69 6e65 2020 2036 290a 2a20 4176 6f69 line 6).* Avoi │ │ │ │ │ +000406a0: 6469 6e67 206d 616e 2070 6167 6520 7265 ding man page re │ │ │ │ │ +000406b0: 6e61 6d69 6e67 3a20 2020 2020 2020 2020 naming: │ │ │ │ │ +000406c0: 2020 204d 616e 2050 6167 6573 2e20 2020 Man Pages. │ │ │ │ │ +000406d0: 2020 2020 2020 2020 286c 696e 6520 2035 (line 5 │ │ │ │ │ +000406e0: 3429 0a2a 2041 766f 6964 696e 6720 7061 4).* Avoiding pa │ │ │ │ │ +000406f0: 7468 2073 7472 6970 7069 6e67 3a20 2020 th stripping: │ │ │ │ │ +00040700: 2020 2020 2020 2020 2020 2020 416c 7465 Alte │ │ │ │ │ +00040710: 726e 6174 6976 652e 2020 2020 2020 2020 rnative. │ │ │ │ │ +00040720: 2028 6c69 6e65 2020 3233 290a 2a20 4269 (line 23).* Bi │ │ │ │ │ +00040730: 6e61 7279 2070 6163 6b61 6765 3a20 2020 nary package: │ │ │ │ │ 00040740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040750: 2020 2020 4445 5354 4449 522e 2020 2020 DESTDIR. │ │ │ │ │ -00040760: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00040770: 3232 290a 2a20 626f 6f74 7374 7261 702e 22).* bootstrap. │ │ │ │ │ -00040780: 7368 2061 6e64 2061 7574 6f72 6563 6f6e sh and autorecon │ │ │ │ │ -00040790: 663a 2020 2020 2020 2020 2020 2045 7272 f: Err │ │ │ │ │ -000407a0: 6f72 2072 6571 7569 7265 6420 6669 6c65 or required file │ │ │ │ │ -000407b0: 206c 746d 6169 6e2e 7368 206e 6f74 2066 ltmain.sh not f │ │ │ │ │ -000407c0: 6f75 6e64 2e0a 2020 2020 2020 2020 2020 ound.. │ │ │ │ │ +00040750: 2020 2020 2044 4553 5444 4952 2e20 2020 DESTDIR. │ │ │ │ │ +00040760: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00040770: 2032 3229 0a2a 2062 6f6f 7473 7472 6170 22).* bootstrap │ │ │ │ │ +00040780: 2e73 6820 616e 6420 6175 746f 7265 636f .sh and autoreco │ │ │ │ │ +00040790: 6e66 3a20 2020 2020 2020 2020 2020 4572 nf: Er │ │ │ │ │ +000407a0: 726f 7220 7265 7175 6972 6564 2066 696c ror required fil │ │ │ │ │ +000407b0: 6520 6c74 6d61 696e 2e73 6820 6e6f 7420 e ltmain.sh not │ │ │ │ │ +000407c0: 666f 756e 642e 0a20 2020 2020 2020 2020 found.. │ │ │ │ │ 000407d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000407e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000407f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040800: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00040810: 2042 7567 732c 2072 6570 6f72 7469 6e67 Bugs, reporting │ │ │ │ │ -00040820: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00040830: 2020 2020 2020 2020 496e 7472 6f64 7563 Introduc │ │ │ │ │ -00040840: 7469 6f6e 2e20 2020 2020 2020 2028 6c69 tion. (li │ │ │ │ │ -00040850: 6e65 2020 3331 290a 2a20 6275 696c 6420 ne 31).* build │ │ │ │ │ -00040860: 7472 6565 2061 6e64 2073 6f75 7263 6520 tree and source │ │ │ │ │ -00040870: 7472 6565 3a20 2020 2020 2020 2020 2020 tree: │ │ │ │ │ -00040880: 2056 5041 5448 2042 7569 6c64 732e 2020 VPATH Builds. │ │ │ │ │ -00040890: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -000408a0: 0a2a 2042 5549 4c54 5f53 4f55 5243 4553 .* BUILT_SOURCES │ │ │ │ │ -000408b0: 2c20 6465 6669 6e65 643a 2020 2020 2020 , defined: │ │ │ │ │ -000408c0: 2020 2020 2020 2020 2020 536f 7572 6365 Source │ │ │ │ │ -000408d0: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -000408e0: 6c69 6e65 2020 3237 290a 2a20 432b 2b20 line 27).* C++ │ │ │ │ │ -000408f0: 7375 7070 6f72 743a 2020 2020 2020 2020 support: │ │ │ │ │ +00040800: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00040810: 2a20 4275 6773 2c20 7265 706f 7274 696e * Bugs, reportin │ │ │ │ │ +00040820: 673a 2020 2020 2020 2020 2020 2020 2020 g: │ │ │ │ │ +00040830: 2020 2020 2020 2020 2049 6e74 726f 6475 Introdu │ │ │ │ │ +00040840: 6374 696f 6e2e 2020 2020 2020 2020 286c ction. (l │ │ │ │ │ +00040850: 696e 6520 2033 3129 0a2a 2062 7569 6c64 ine 31).* build │ │ │ │ │ +00040860: 2074 7265 6520 616e 6420 736f 7572 6365 tree and source │ │ │ │ │ +00040870: 2074 7265 653a 2020 2020 2020 2020 2020 tree: │ │ │ │ │ +00040880: 2020 5650 4154 4820 4275 696c 6473 2e20 VPATH Builds. │ │ │ │ │ +00040890: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +000408a0: 290a 2a20 4255 494c 545f 534f 5552 4345 ).* BUILT_SOURCE │ │ │ │ │ +000408b0: 532c 2064 6566 696e 6564 3a20 2020 2020 S, defined: │ │ │ │ │ +000408c0: 2020 2020 2020 2020 2020 2053 6f75 7263 Sourc │ │ │ │ │ +000408d0: 6573 2e20 2020 2020 2020 2020 2020 2020 es. │ │ │ │ │ +000408e0: 286c 696e 6520 2032 3729 0a2a 2043 2b2b (line 27).* C++ │ │ │ │ │ +000408f0: 2073 7570 706f 7274 3a20 2020 2020 2020 support: │ │ │ │ │ 00040900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040910: 2020 2043 2b2b 2053 7570 706f 7274 2e20 C++ Support. │ │ │ │ │ -00040920: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ -00040930: 3629 0a2a 2063 616e 6f6e 6963 616c 697a 6).* canonicaliz │ │ │ │ │ -00040940: 696e 6720 4175 746f 6d61 6b65 2076 6172 ing Automake var │ │ │ │ │ -00040950: 6961 626c 6573 3a20 2020 2020 4361 6e6f iables: Cano │ │ │ │ │ -00040960: 6e69 6361 6c69 7a61 7469 6f6e 2e20 2020 nicalization. │ │ │ │ │ -00040970: 2028 6c69 6e65 2020 2036 290a 2a20 4343 (line 6).* CC │ │ │ │ │ -00040980: 4153 464c 4147 5320 616e 6420 414d 5f43 ASFLAGS and AM_C │ │ │ │ │ -00040990: 4341 5346 4c41 4753 3a20 2020 2020 2020 CASFLAGS: │ │ │ │ │ -000409a0: 2020 2020 2046 6c61 6720 5661 7269 6162 Flag Variab │ │ │ │ │ -000409b0: 6c65 7320 4f72 6465 7269 6e67 2e0a 2020 les Ordering.. │ │ │ │ │ +00040910: 2020 2020 432b 2b20 5375 7070 6f72 742e C++ Support. │ │ │ │ │ +00040920: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00040930: 2036 290a 2a20 6361 6e6f 6e69 6361 6c69 6).* canonicali │ │ │ │ │ +00040940: 7a69 6e67 2041 7574 6f6d 616b 6520 7661 zing Automake va │ │ │ │ │ +00040950: 7269 6162 6c65 733a 2020 2020 2043 616e riables: Can │ │ │ │ │ +00040960: 6f6e 6963 616c 697a 6174 696f 6e2e 2020 onicalization. │ │ │ │ │ +00040970: 2020 286c 696e 6520 2020 3629 0a2a 2043 (line 6).* C │ │ │ │ │ +00040980: 4341 5346 4c41 4753 2061 6e64 2041 4d5f CASFLAGS and AM_ │ │ │ │ │ +00040990: 4343 4153 464c 4147 533a 2020 2020 2020 CCASFLAGS: │ │ │ │ │ +000409a0: 2020 2020 2020 466c 6167 2056 6172 6961 Flag Varia │ │ │ │ │ +000409b0: 626c 6573 204f 7264 6572 696e 672e 0a20 bles Ordering.. │ │ │ │ │ 000409c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000409d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000409e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000409f0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00040a00: 6520 2032 3029 0a2a 2043 464c 4147 5320 e 20).* CFLAGS │ │ │ │ │ -00040a10: 616e 6420 414d 5f43 464c 4147 533a 2020 and AM_CFLAGS: │ │ │ │ │ +000409f0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00040a00: 6e65 2020 3230 290a 2a20 4346 4c41 4753 ne 20).* CFLAGS │ │ │ │ │ +00040a10: 2061 6e64 2041 4d5f 4346 4c41 4753 3a20 and AM_CFLAGS: │ │ │ │ │ 00040a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040a30: 466c 6167 2056 6172 6961 626c 6573 204f Flag Variables O │ │ │ │ │ -00040a40: 7264 6572 696e 672e 0a20 2020 2020 2020 rdering.. │ │ │ │ │ +00040a30: 2046 6c61 6720 5661 7269 6162 6c65 7320 Flag Variables │ │ │ │ │ +00040a40: 4f72 6465 7269 6e67 2e0a 2020 2020 2020 Ordering.. │ │ │ │ │ 00040a50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040a80: 2020 2020 2020 2028 6c69 6e65 2020 3230 (line 20 │ │ │ │ │ -00040a90: 290a 2a20 6366 6f72 7472 616e 3a20 2020 ).* cfortran: │ │ │ │ │ +00040a80: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +00040a90: 3029 0a2a 2063 666f 7274 7261 6e3a 2020 0).* cfortran: │ │ │ │ │ 00040aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040ab0: 2020 2020 2020 2020 2020 204d 6978 696e Mixin │ │ │ │ │ -00040ac0: 6720 466f 7274 7261 6e20 3737 2057 6974 g Fortran 77 Wit │ │ │ │ │ -00040ad0: 6820 4320 616e 6420 432b 2b2e 0a20 2020 h C and C++.. │ │ │ │ │ +00040ab0: 2020 2020 2020 2020 2020 2020 4d69 7869 Mixi │ │ │ │ │ +00040ac0: 6e67 2046 6f72 7472 616e 2037 3720 5769 ng Fortran 77 Wi │ │ │ │ │ +00040ad0: 7468 2043 2061 6e64 2043 2b2b 2e0a 2020 th C and C++.. │ │ │ │ │ 00040ae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040b10: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00040b20: 2020 2036 290a 2a20 6368 6563 6b3a 2020 6).* check: │ │ │ │ │ +00040b10: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00040b20: 6520 2020 3629 0a2a 2063 6865 636b 3a20 e 6).* check: │ │ │ │ │ 00040b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040b40: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -00040b50: 7461 6e64 6172 6420 5461 7267 6574 732e tandard Targets. │ │ │ │ │ -00040b60: 2020 2020 286c 696e 6520 2033 3129 0a2a (line 31).* │ │ │ │ │ -00040b70: 2063 6865 636b 203c 313e 3a20 2020 2020 check <1>: │ │ │ │ │ +00040b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040b50: 5374 616e 6461 7264 2054 6172 6765 7473 Standard Targets │ │ │ │ │ +00040b60: 2e20 2020 2028 6c69 6e65 2020 3331 290a . (line 31). │ │ │ │ │ +00040b70: 2a20 6368 6563 6b20 3c31 3e3a 2020 2020 * check <1>: │ │ │ │ │ 00040b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040b90: 2020 2020 2020 2020 5465 7374 732e 2020 Tests. │ │ │ │ │ -00040ba0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00040bb0: 6e65 2020 2036 290a 2a20 6368 6563 6b20 ne 6).* check │ │ │ │ │ -00040bc0: 3c32 3e3a 2020 2020 2020 2020 2020 2020 <2>: │ │ │ │ │ +00040b90: 2020 2020 2020 2020 2054 6573 7473 2e20 Tests. │ │ │ │ │ +00040ba0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00040bb0: 696e 6520 2020 3629 0a2a 2063 6865 636b ine 6).* check │ │ │ │ │ +00040bc0: 203c 323e 3a20 2020 2020 2020 2020 2020 <2>: │ │ │ │ │ 00040bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040be0: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ -00040bf0: 2020 2020 2020 286c 696e 6520 2034 3129 (line 41) │ │ │ │ │ -00040c00: 0a2a 2063 6865 636b 2d68 746d 6c3a 2020 .* check-html: │ │ │ │ │ +00040be0: 2020 4578 7465 6e64 696e 672e 2020 2020 Extending. │ │ │ │ │ +00040bf0: 2020 2020 2020 2028 6c69 6e65 2020 3431 (line 41 │ │ │ │ │ +00040c00: 290a 2a20 6368 6563 6b2d 6874 6d6c 3a20 ).* check-html: │ │ │ │ │ 00040c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040c20: 2020 2020 2020 2020 2020 5369 6d70 6c65 Simple │ │ │ │ │ -00040c30: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ -00040c40: 616c 6c65 6c2d 7465 7374 732e 0a20 2020 allel-tests.. │ │ │ │ │ +00040c20: 2020 2020 2020 2020 2020 2053 696d 706c Simpl │ │ │ │ │ +00040c30: 6520 5465 7374 7320 7573 696e 6720 7061 e Tests using pa │ │ │ │ │ +00040c40: 7261 6c6c 656c 2d74 6573 7473 2e0a 2020 rallel-tests.. │ │ │ │ │ 00040c50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040c80: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00040c90: 2020 3730 290a 2a20 6368 6563 6b2d 6c6f 70).* check-lo │ │ │ │ │ -00040ca0: 6361 6c3a 2020 2020 2020 2020 2020 2020 cal: │ │ │ │ │ -00040cb0: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ -00040cc0: 7874 656e 6469 6e67 2e20 2020 2020 2020 xtending. │ │ │ │ │ -00040cd0: 2020 2020 286c 696e 6520 2034 3129 0a2a (line 41).* │ │ │ │ │ -00040ce0: 2063 6865 636b 2d6e 6577 733a 2020 2020 check-news: │ │ │ │ │ +00040c80: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00040c90: 6520 2037 3029 0a2a 2063 6865 636b 2d6c e 70).* check-l │ │ │ │ │ +00040ca0: 6f63 616c 3a20 2020 2020 2020 2020 2020 ocal: │ │ │ │ │ +00040cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040cc0: 4578 7465 6e64 696e 672e 2020 2020 2020 Extending. │ │ │ │ │ +00040cd0: 2020 2020 2028 6c69 6e65 2020 3431 290a (line 41). │ │ │ │ │ +00040ce0: 2a20 6368 6563 6b2d 6e65 7773 3a20 2020 * check-news: │ │ │ │ │ 00040cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040d00: 2020 2020 2020 2020 4f70 7469 6f6e 732e Options. │ │ │ │ │ -00040d10: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00040d20: 6e65 2020 3339 290a 2a20 6368 6563 6b5f ne 39).* check_ │ │ │ │ │ -00040d30: 2070 7269 6d61 7279 2070 7265 6669 782c primary prefix, │ │ │ │ │ -00040d40: 2064 6566 696e 6974 696f 6e3a 2020 2020 definition: │ │ │ │ │ -00040d50: 2055 6e69 666f 726d 2e20 2020 2020 2020 Uniform. │ │ │ │ │ -00040d60: 2020 2020 2020 286c 696e 6520 2039 3629 (line 96) │ │ │ │ │ -00040d70: 0a2a 2063 6865 636b 5f50 524f 4752 414d .* check_PROGRAM │ │ │ │ │ -00040d80: 5320 6578 616d 706c 653a 2020 2020 2020 S example: │ │ │ │ │ -00040d90: 2020 2020 2020 2020 2020 4465 6661 756c Defaul │ │ │ │ │ -00040da0: 7420 5f53 4f55 5243 4553 2e20 2020 2028 t _SOURCES. ( │ │ │ │ │ -00040db0: 6c69 6e65 2020 3238 290a 2a20 636c 6561 line 28).* clea │ │ │ │ │ -00040dc0: 6e3a 2020 2020 2020 2020 2020 2020 2020 n: │ │ │ │ │ +00040d00: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ +00040d10: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00040d20: 696e 6520 2033 3929 0a2a 2063 6865 636b ine 39).* check │ │ │ │ │ +00040d30: 5f20 7072 696d 6172 7920 7072 6566 6978 _ primary prefix │ │ │ │ │ +00040d40: 2c20 6465 6669 6e69 7469 6f6e 3a20 2020 , definition: │ │ │ │ │ +00040d50: 2020 556e 6966 6f72 6d2e 2020 2020 2020 Uniform. │ │ │ │ │ +00040d60: 2020 2020 2020 2028 6c69 6e65 2020 3936 (line 96 │ │ │ │ │ +00040d70: 290a 2a20 6368 6563 6b5f 5052 4f47 5241 ).* check_PROGRA │ │ │ │ │ +00040d80: 4d53 2065 7861 6d70 6c65 3a20 2020 2020 MS example: │ │ │ │ │ +00040d90: 2020 2020 2020 2020 2020 2044 6566 6175 Defau │ │ │ │ │ +00040da0: 6c74 205f 534f 5552 4345 532e 2020 2020 lt _SOURCES. │ │ │ │ │ +00040db0: 286c 696e 6520 2032 3829 0a2a 2063 6c65 (line 28).* cle │ │ │ │ │ +00040dc0: 616e 3a20 2020 2020 2020 2020 2020 2020 an: │ │ │ │ │ 00040dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040de0: 2020 2053 7461 6e64 6172 6420 5461 7267 Standard Targ │ │ │ │ │ -00040df0: 6574 732e 2020 2020 286c 696e 6520 2032 ets. (line 2 │ │ │ │ │ -00040e00: 3729 0a2a 2063 6c65 616e 203c 313e 3a20 7).* clean <1>: │ │ │ │ │ +00040de0: 2020 2020 5374 616e 6461 7264 2054 6172 Standard Tar │ │ │ │ │ +00040df0: 6765 7473 2e20 2020 2028 6c69 6e65 2020 gets. (line │ │ │ │ │ +00040e00: 3237 290a 2a20 636c 6561 6e20 3c31 3e3a 27).* clean <1>: │ │ │ │ │ 00040e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040e20: 2020 2020 2020 2020 2020 2020 4578 7465 Exte │ │ │ │ │ -00040e30: 6e64 696e 672e 2020 2020 2020 2020 2020 nding. │ │ │ │ │ -00040e40: 2028 6c69 6e65 2020 3431 290a 2a20 636c (line 41).* cl │ │ │ │ │ -00040e50: 6561 6e2d 6c6f 6361 6c3a 2020 2020 2020 ean-local: │ │ │ │ │ +00040e20: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ +00040e30: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ +00040e40: 2020 286c 696e 6520 2034 3129 0a2a 2063 (line 41).* c │ │ │ │ │ +00040e50: 6c65 616e 2d6c 6f63 616c 3a20 2020 2020 lean-local: │ │ │ │ │ 00040e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040e70: 2020 2020 2043 6c65 616e 2e20 2020 2020 Clean. │ │ │ │ │ -00040e80: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00040e90: 2031 3529 0a2a 2063 6c65 616e 2d6c 6f63 15).* clean-loc │ │ │ │ │ -00040ea0: 616c 203c 313e 3a20 2020 2020 2020 2020 al <1>: │ │ │ │ │ -00040eb0: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ -00040ec0: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ -00040ed0: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ -00040ee0: 636f 6c6f 722d 7465 7374 733a 2020 2020 color-tests: │ │ │ │ │ +00040e70: 2020 2020 2020 436c 6561 6e2e 2020 2020 Clean. │ │ │ │ │ +00040e80: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00040e90: 2020 3135 290a 2a20 636c 6561 6e2d 6c6f 15).* clean-lo │ │ │ │ │ +00040ea0: 6361 6c20 3c31 3e3a 2020 2020 2020 2020 cal <1>: │ │ │ │ │ +00040eb0: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +00040ec0: 7874 656e 6469 6e67 2e20 2020 2020 2020 xtending. │ │ │ │ │ +00040ed0: 2020 2020 286c 696e 6520 2034 3129 0a2a (line 41).* │ │ │ │ │ +00040ee0: 2063 6f6c 6f72 2d74 6573 7473 3a20 2020 color-tests: │ │ │ │ │ 00040ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040f00: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ -00040f10: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00040f20: 6520 2034 3329 0a2a 2063 6f6d 6d61 6e64 e 43).* command │ │ │ │ │ -00040f30: 206c 696e 6520 6c65 6e67 7468 206c 696d line length lim │ │ │ │ │ -00040f40: 6974 3a20 2020 2020 2020 2020 2020 2020 it: │ │ │ │ │ -00040f50: 4c65 6e67 7468 204c 696d 6974 6174 696f Length Limitatio │ │ │ │ │ -00040f60: 6e73 2e20 2028 6c69 6e65 2020 2036 290a ns. (line 6). │ │ │ │ │ -00040f70: 2a20 436f 6d6d 656e 742c 2073 7065 6369 * Comment, speci │ │ │ │ │ -00040f80: 616c 2074 6f20 4175 746f 6d61 6b65 3a20 al to Automake: │ │ │ │ │ -00040f90: 2020 2020 2020 2020 2047 656e 6572 616c General │ │ │ │ │ -00040fa0: 204f 7065 7261 7469 6f6e 2e20 2020 286c Operation. (l │ │ │ │ │ -00040fb0: 696e 6520 2036 3829 0a2a 2043 6f6d 7069 ine 68).* Compi │ │ │ │ │ -00040fc0: 6c61 7469 6f6e 206f 6620 4a61 7661 2074 lation of Java t │ │ │ │ │ -00040fd0: 6f20 6279 7465 636f 6465 3a20 2020 2020 o bytecode: │ │ │ │ │ -00040fe0: 2020 4a61 7661 2e20 2020 2020 2020 2020 Java. │ │ │ │ │ -00040ff0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00041000: 290a 2a20 436f 6d70 696c 6174 696f 6e20 ).* Compilation │ │ │ │ │ -00041010: 6f66 204a 6176 6120 746f 206e 6174 6976 of Java to nativ │ │ │ │ │ -00041020: 6520 636f 6465 3a20 2020 204a 6176 6120 e code: Java │ │ │ │ │ -00041030: 5375 7070 6f72 7420 7769 7468 2067 636a Support with gcj │ │ │ │ │ -00041040: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00040f00: 2020 2020 2020 2020 4f70 7469 6f6e 732e Options. │ │ │ │ │ +00040f10: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00040f20: 6e65 2020 3433 290a 2a20 636f 6d6d 616e ne 43).* comman │ │ │ │ │ +00040f30: 6420 6c69 6e65 206c 656e 6774 6820 6c69 d line length li │ │ │ │ │ +00040f40: 6d69 743a 2020 2020 2020 2020 2020 2020 mit: │ │ │ │ │ +00040f50: 204c 656e 6774 6820 4c69 6d69 7461 7469 Length Limitati │ │ │ │ │ +00040f60: 6f6e 732e 2020 286c 696e 6520 2020 3629 ons. (line 6) │ │ │ │ │ +00040f70: 0a2a 2043 6f6d 6d65 6e74 2c20 7370 6563 .* Comment, spec │ │ │ │ │ +00040f80: 6961 6c20 746f 2041 7574 6f6d 616b 653a ial to Automake: │ │ │ │ │ +00040f90: 2020 2020 2020 2020 2020 4765 6e65 7261 Genera │ │ │ │ │ +00040fa0: 6c20 4f70 6572 6174 696f 6e2e 2020 2028 l Operation. ( │ │ │ │ │ +00040fb0: 6c69 6e65 2020 3638 290a 2a20 436f 6d70 line 68).* Comp │ │ │ │ │ +00040fc0: 696c 6174 696f 6e20 6f66 204a 6176 6120 ilation of Java │ │ │ │ │ +00040fd0: 746f 2062 7974 6563 6f64 653a 2020 2020 to bytecode: │ │ │ │ │ +00040fe0: 2020 204a 6176 612e 2020 2020 2020 2020 Java. │ │ │ │ │ +00040ff0: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00041000: 3629 0a2a 2043 6f6d 7069 6c61 7469 6f6e 6).* Compilation │ │ │ │ │ +00041010: 206f 6620 4a61 7661 2074 6f20 6e61 7469 of Java to nati │ │ │ │ │ +00041020: 7665 2063 6f64 653a 2020 2020 4a61 7661 ve code: Java │ │ │ │ │ +00041030: 2053 7570 706f 7274 2077 6974 6820 6763 Support with gc │ │ │ │ │ +00041040: 6a2e 0a20 2020 2020 2020 2020 2020 2020 j.. │ │ │ │ │ 00041050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041080: 286c 696e 6520 2020 3629 0a2a 2043 6f6d (line 6).* Com │ │ │ │ │ -00041090: 7069 6c65 2046 6c61 6720 5661 7269 6162 pile Flag Variab │ │ │ │ │ -000410a0: 6c65 733a 2020 2020 2020 2020 2020 2020 les: │ │ │ │ │ -000410b0: 2020 2020 466c 6167 2056 6172 6961 626c Flag Variabl │ │ │ │ │ -000410c0: 6573 204f 7264 6572 696e 672e 0a20 2020 es Ordering.. │ │ │ │ │ +00041080: 2028 6c69 6e65 2020 2036 290a 2a20 436f (line 6).* Co │ │ │ │ │ +00041090: 6d70 696c 6520 466c 6167 2056 6172 6961 mpile Flag Varia │ │ │ │ │ +000410a0: 626c 6573 3a20 2020 2020 2020 2020 2020 bles: │ │ │ │ │ +000410b0: 2020 2020 2046 6c61 6720 5661 7269 6162 Flag Variab │ │ │ │ │ +000410c0: 6c65 7320 4f72 6465 7269 6e67 2e0a 2020 les Ordering.. │ │ │ │ │ 000410d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000410e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000410f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041100: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00041110: 2020 3230 290a 2a20 436f 6d70 6c65 7465 20).* Complete │ │ │ │ │ -00041120: 2065 7861 6d70 6c65 3a20 2020 2020 2020 example: │ │ │ │ │ -00041130: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ -00041140: 6f6d 706c 6574 652e 2020 2020 2020 2020 omplete. │ │ │ │ │ -00041150: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00041160: 2043 6f6e 6469 7469 6f6e 616c 2065 7861 Conditional exa │ │ │ │ │ -00041170: 6d70 6c65 2c20 2d2d 656e 6162 6c65 2d64 mple, --enable-d │ │ │ │ │ -00041180: 6562 7567 3a20 2020 5573 6167 6520 6f66 ebug: Usage of │ │ │ │ │ -00041190: 2043 6f6e 6469 7469 6f6e 616c 732e 0a20 Conditionals.. │ │ │ │ │ +00041100: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00041110: 6520 2032 3029 0a2a 2043 6f6d 706c 6574 e 20).* Complet │ │ │ │ │ +00041120: 6520 6578 616d 706c 653a 2020 2020 2020 e example: │ │ │ │ │ +00041130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00041140: 436f 6d70 6c65 7465 2e20 2020 2020 2020 Complete. │ │ │ │ │ +00041150: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00041160: 2a20 436f 6e64 6974 696f 6e61 6c20 6578 * Conditional ex │ │ │ │ │ +00041170: 616d 706c 652c 202d 2d65 6e61 626c 652d ample, --enable- │ │ │ │ │ +00041180: 6465 6275 673a 2020 2055 7361 6765 206f debug: Usage o │ │ │ │ │ +00041190: 6620 436f 6e64 6974 696f 6e61 6c73 2e0a f Conditionals.. │ │ │ │ │ 000411a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000411b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000411c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000411d0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000411e0: 6e65 2020 3231 290a 2a20 636f 6e64 6974 ne 21).* condit │ │ │ │ │ -000411f0: 696f 6e61 6c20 6c69 6274 6f6f 6c20 6c69 ional libtool li │ │ │ │ │ -00041200: 6272 6172 6965 733a 2020 2020 2020 2020 braries: │ │ │ │ │ -00041210: 2043 6f6e 6469 7469 6f6e 616c 204c 6962 Conditional Lib │ │ │ │ │ -00041220: 746f 6f6c 204c 6962 7261 7269 6573 2e0a tool Libraries.. │ │ │ │ │ -00041230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000411d0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +000411e0: 696e 6520 2032 3129 0a2a 2063 6f6e 6469 ine 21).* condi │ │ │ │ │ +000411f0: 7469 6f6e 616c 206c 6962 746f 6f6c 206c tional libtool l │ │ │ │ │ +00041200: 6962 7261 7269 6573 3a20 2020 2020 2020 ibraries: │ │ │ │ │ +00041210: 2020 436f 6e64 6974 696f 6e61 6c20 4c69 Conditional Li │ │ │ │ │ +00041220: 6274 6f6f 6c20 4c69 6272 6172 6965 732e btool Libraries. │ │ │ │ │ +00041230: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00041240: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041250: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041260: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00041270: 696e 6520 2020 3629 0a2a 2043 6f6e 6469 ine 6).* Condi │ │ │ │ │ -00041280: 7469 6f6e 616c 2070 726f 6772 616d 733a tional programs: │ │ │ │ │ -00041290: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000412a0: 2020 436f 6e64 6974 696f 6e61 6c20 5072 Conditional Pr │ │ │ │ │ -000412b0: 6f67 7261 6d73 2e0a 2020 2020 2020 2020 ograms.. │ │ │ │ │ +00041260: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00041270: 6c69 6e65 2020 2036 290a 2a20 436f 6e64 line 6).* Cond │ │ │ │ │ +00041280: 6974 696f 6e61 6c20 7072 6f67 7261 6d73 itional programs │ │ │ │ │ +00041290: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000412a0: 2020 2043 6f6e 6469 7469 6f6e 616c 2050 Conditional P │ │ │ │ │ +000412b0: 726f 6772 616d 732e 0a20 2020 2020 2020 rograms.. │ │ │ │ │ 000412c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000412d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000412e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000412f0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00041300: 0a2a 2043 6f6e 6469 7469 6f6e 616c 2073 .* Conditional s │ │ │ │ │ -00041310: 7562 6469 7265 6374 6f72 6965 733a 2020 ubdirectories: │ │ │ │ │ -00041320: 2020 2020 2020 2020 2020 436f 6e64 6974 Condit │ │ │ │ │ -00041330: 696f 6e61 6c20 5375 6264 6972 6563 746f ional Subdirecto │ │ │ │ │ -00041340: 7269 6573 2e0a 2020 2020 2020 2020 2020 ries.. │ │ │ │ │ +000412f0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00041300: 290a 2a20 436f 6e64 6974 696f 6e61 6c20 ).* Conditional │ │ │ │ │ +00041310: 7375 6264 6972 6563 746f 7269 6573 3a20 subdirectories: │ │ │ │ │ +00041320: 2020 2020 2020 2020 2020 2043 6f6e 6469 Condi │ │ │ │ │ +00041330: 7469 6f6e 616c 2053 7562 6469 7265 6374 tional Subdirect │ │ │ │ │ +00041340: 6f72 6965 732e 0a20 2020 2020 2020 2020 ories.. │ │ │ │ │ 00041350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041360: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041380: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00041390: 2043 6f6e 6469 7469 6f6e 616c 2053 5542 Conditional SUB │ │ │ │ │ -000413a0: 4449 5253 3a20 2020 2020 2020 2020 2020 DIRS: │ │ │ │ │ -000413b0: 2020 2020 2020 2020 436f 6e64 6974 696f Conditio │ │ │ │ │ -000413c0: 6e61 6c20 5375 6264 6972 6563 746f 7269 nal Subdirectori │ │ │ │ │ -000413d0: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ +00041380: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00041390: 2a20 436f 6e64 6974 696f 6e61 6c20 5355 * Conditional SU │ │ │ │ │ +000413a0: 4244 4952 533a 2020 2020 2020 2020 2020 BDIRS: │ │ │ │ │ +000413b0: 2020 2020 2020 2020 2043 6f6e 6469 7469 Conditi │ │ │ │ │ +000413c0: 6f6e 616c 2053 7562 6469 7265 6374 6f72 onal Subdirector │ │ │ │ │ +000413d0: 6965 732e 0a20 2020 2020 2020 2020 2020 ies.. │ │ │ │ │ 000413e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000413f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041410: 2020 286c 696e 6520 2020 3629 0a2a 2043 (line 6).* C │ │ │ │ │ -00041420: 6f6e 6469 7469 6f6e 616c 733a 2020 2020 onditionals: │ │ │ │ │ +00041410: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +00041420: 436f 6e64 6974 696f 6e61 6c73 3a20 2020 Conditionals: │ │ │ │ │ 00041430: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041440: 2020 2020 2020 436f 6e64 6974 696f 6e61 Conditiona │ │ │ │ │ -00041450: 6c73 2e20 2020 2020 2020 2028 6c69 6e65 ls. (line │ │ │ │ │ -00041460: 2020 2036 290a 2a20 636f 6e66 6967 2e67 6).* config.g │ │ │ │ │ -00041470: 7565 7373 3a20 2020 2020 2020 2020 2020 uess: │ │ │ │ │ -00041480: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ -00041490: 7574 6f6d 616b 6520 496e 766f 6361 7469 utomake Invocati │ │ │ │ │ -000414a0: 6f6e 2e20 286c 696e 6520 2033 3929 0a2a on. (line 39).* │ │ │ │ │ -000414b0: 2063 6f6e 6669 672e 7369 7465 2065 7861 config.site exa │ │ │ │ │ -000414c0: 6d70 6c65 3a20 2020 2020 2020 2020 2020 mple: │ │ │ │ │ -000414d0: 2020 2020 2020 2020 636f 6e66 6967 2e73 config.s │ │ │ │ │ -000414e0: 6974 652e 2020 2020 2020 2020 2028 6c69 ite. (li │ │ │ │ │ -000414f0: 6e65 2020 2036 290a 2a20 636f 6e66 6967 ne 6).* config │ │ │ │ │ -00041500: 7572 6174 696f 6e20 7661 7269 6162 6c65 uration variable │ │ │ │ │ -00041510: 732c 206f 7665 7272 6964 696e 673a 2020 s, overriding: │ │ │ │ │ -00041520: 2053 7461 6e64 6172 6420 436f 6e66 6967 Standard Config │ │ │ │ │ -00041530: 7572 6174 696f 6e20 5661 7269 6162 6c65 uration Variable │ │ │ │ │ -00041540: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ +00041440: 2020 2020 2020 2043 6f6e 6469 7469 6f6e Condition │ │ │ │ │ +00041450: 616c 732e 2020 2020 2020 2020 286c 696e als. (lin │ │ │ │ │ +00041460: 6520 2020 3629 0a2a 2063 6f6e 6669 672e e 6).* config. │ │ │ │ │ +00041470: 6775 6573 733a 2020 2020 2020 2020 2020 guess: │ │ │ │ │ +00041480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00041490: 6175 746f 6d61 6b65 2049 6e76 6f63 6174 automake Invocat │ │ │ │ │ +000414a0: 696f 6e2e 2028 6c69 6e65 2020 3339 290a ion. (line 39). │ │ │ │ │ +000414b0: 2a20 636f 6e66 6967 2e73 6974 6520 6578 * config.site ex │ │ │ │ │ +000414c0: 616d 706c 653a 2020 2020 2020 2020 2020 ample: │ │ │ │ │ +000414d0: 2020 2020 2020 2020 2063 6f6e 6669 672e config. │ │ │ │ │ +000414e0: 7369 7465 2e20 2020 2020 2020 2020 286c site. (l │ │ │ │ │ +000414f0: 696e 6520 2020 3629 0a2a 2063 6f6e 6669 ine 6).* confi │ │ │ │ │ +00041500: 6775 7261 7469 6f6e 2076 6172 6961 626c guration variabl │ │ │ │ │ +00041510: 6573 2c20 6f76 6572 7269 6469 6e67 3a20 es, overriding: │ │ │ │ │ +00041520: 2020 5374 616e 6461 7264 2043 6f6e 6669 Standard Confi │ │ │ │ │ +00041530: 6775 7261 7469 6f6e 2056 6172 6961 626c guration Variabl │ │ │ │ │ +00041540: 6573 2e0a 2020 2020 2020 2020 2020 2020 es.. │ │ │ │ │ 00041550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041580: 2028 6c69 6e65 2020 2036 290a 2a20 436f (line 6).* Co │ │ │ │ │ -00041590: 6e66 6967 7572 6174 696f 6e2c 2062 6173 nfiguration, bas │ │ │ │ │ -000415a0: 6963 733a 2020 2020 2020 2020 2020 2020 ics: │ │ │ │ │ -000415b0: 2020 2020 2042 6173 6963 2049 6e73 7461 Basic Insta │ │ │ │ │ -000415c0: 6c6c 6174 696f 6e2e 2020 286c 696e 6520 llation. (line │ │ │ │ │ -000415d0: 2020 3629 0a2a 2063 6f6e 6669 6775 7265 6).* configure │ │ │ │ │ -000415e0: 2e61 632c 2048 656c 6c6f 2057 6f72 6c64 .ac, Hello World │ │ │ │ │ -000415f0: 3a20 2020 2020 2020 2020 2020 2020 616d : am │ │ │ │ │ -00041600: 6865 6c6c 6f27 7320 636f 6e66 6967 7572 hello's configur │ │ │ │ │ -00041610: 652e 6163 2053 6574 7570 2045 7870 6c61 e.ac Setup Expla │ │ │ │ │ -00041620: 696e 6564 2e0a 2020 2020 2020 2020 2020 ined.. │ │ │ │ │ +00041580: 2020 286c 696e 6520 2020 3629 0a2a 2043 (line 6).* C │ │ │ │ │ +00041590: 6f6e 6669 6775 7261 7469 6f6e 2c20 6261 onfiguration, ba │ │ │ │ │ +000415a0: 7369 6373 3a20 2020 2020 2020 2020 2020 sics: │ │ │ │ │ +000415b0: 2020 2020 2020 4261 7369 6320 496e 7374 Basic Inst │ │ │ │ │ +000415c0: 616c 6c61 7469 6f6e 2e20 2028 6c69 6e65 allation. (line │ │ │ │ │ +000415d0: 2020 2036 290a 2a20 636f 6e66 6967 7572 6).* configur │ │ │ │ │ +000415e0: 652e 6163 2c20 4865 6c6c 6f20 576f 726c e.ac, Hello Worl │ │ │ │ │ +000415f0: 643a 2020 2020 2020 2020 2020 2020 2061 d: a │ │ │ │ │ +00041600: 6d68 656c 6c6f 2773 2063 6f6e 6669 6775 mhello's configu │ │ │ │ │ +00041610: 7265 2e61 6320 5365 7475 7020 4578 706c re.ac Setup Expl │ │ │ │ │ +00041620: 6169 6e65 642e 0a20 2020 2020 2020 2020 ained.. │ │ │ │ │ 00041630: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041640: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041660: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00041670: 2063 6f6e 6669 6775 7265 2e61 632c 2073 configure.ac, s │ │ │ │ │ -00041680: 6361 6e6e 696e 673a 2020 2020 2020 2020 canning: │ │ │ │ │ -00041690: 2020 2020 2020 2020 636f 6e66 6967 7572 configur │ │ │ │ │ -000416a0: 652e 2020 2020 2020 2020 2020 2028 6c69 e. (li │ │ │ │ │ -000416b0: 6e65 2020 2036 290a 2a20 636f 6e66 6c69 ne 6).* confli │ │ │ │ │ -000416c0: 6374 696e 6720 6465 6669 6e69 7469 6f6e cting definition │ │ │ │ │ -000416d0: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ -000416e0: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ -000416f0: 2020 2020 2020 286c 696e 6520 2031 3429 (line 14) │ │ │ │ │ -00041700: 0a2a 2043 6f6e 7374 7261 696e 7473 206f .* Constraints o │ │ │ │ │ -00041710: 6620 4175 746f 6d61 6b65 3a20 2020 2020 f Automake: │ │ │ │ │ -00041720: 2020 2020 2020 2020 2020 496e 7472 6f64 Introd │ │ │ │ │ -00041730: 7563 7469 6f6e 2e20 2020 2020 2020 2028 uction. ( │ │ │ │ │ -00041740: 6c69 6e65 2020 3232 290a 2a20 636f 6e76 line 22).* conv │ │ │ │ │ -00041750: 656e 6965 6e63 6520 6c69 6272 6172 6965 enience librarie │ │ │ │ │ -00041760: 732c 206c 6962 746f 6f6c 3a20 2020 2020 s, libtool: │ │ │ │ │ -00041770: 2020 204c 6962 746f 6f6c 2043 6f6e 7665 Libtool Conve │ │ │ │ │ -00041780: 6e69 656e 6365 204c 6962 7261 7269 6573 nience Libraries │ │ │ │ │ -00041790: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00041660: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00041670: 2a20 636f 6e66 6967 7572 652e 6163 2c20 * configure.ac, │ │ │ │ │ +00041680: 7363 616e 6e69 6e67 3a20 2020 2020 2020 scanning: │ │ │ │ │ +00041690: 2020 2020 2020 2020 2063 6f6e 6669 6775 configu │ │ │ │ │ +000416a0: 7265 2e20 2020 2020 2020 2020 2020 286c re. (l │ │ │ │ │ +000416b0: 696e 6520 2020 3629 0a2a 2063 6f6e 666c ine 6).* confl │ │ │ │ │ +000416c0: 6963 7469 6e67 2064 6566 696e 6974 696f icting definitio │ │ │ │ │ +000416d0: 6e73 3a20 2020 2020 2020 2020 2020 2020 ns: │ │ │ │ │ +000416e0: 2020 4578 7465 6e64 696e 672e 2020 2020 Extending. │ │ │ │ │ +000416f0: 2020 2020 2020 2028 6c69 6e65 2020 3134 (line 14 │ │ │ │ │ +00041700: 290a 2a20 436f 6e73 7472 6169 6e74 7320 ).* Constraints │ │ │ │ │ +00041710: 6f66 2041 7574 6f6d 616b 653a 2020 2020 of Automake: │ │ │ │ │ +00041720: 2020 2020 2020 2020 2020 2049 6e74 726f Intro │ │ │ │ │ +00041730: 6475 6374 696f 6e2e 2020 2020 2020 2020 duction. │ │ │ │ │ +00041740: 286c 696e 6520 2032 3229 0a2a 2063 6f6e (line 22).* con │ │ │ │ │ +00041750: 7665 6e69 656e 6365 206c 6962 7261 7269 venience librari │ │ │ │ │ +00041760: 6573 2c20 6c69 6274 6f6f 6c3a 2020 2020 es, libtool: │ │ │ │ │ +00041770: 2020 2020 4c69 6274 6f6f 6c20 436f 6e76 Libtool Conv │ │ │ │ │ +00041780: 656e 6965 6e63 6520 4c69 6272 6172 6965 enience Librarie │ │ │ │ │ +00041790: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ 000417a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000417b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000417c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000417d0: 286c 696e 6520 2020 3629 0a2a 2063 6f70 (line 6).* cop │ │ │ │ │ -000417e0: 7969 6e67 2073 656d 616e 7469 6373 3a20 ying semantics: │ │ │ │ │ +000417d0: 2028 6c69 6e65 2020 2036 290a 2a20 636f (line 6).* co │ │ │ │ │ +000417e0: 7079 696e 6720 7365 6d61 6e74 6963 733a pying semantics: │ │ │ │ │ 000417f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041800: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ -00041810: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00041820: 3130 290a 2a20 6370 696f 2065 7861 6d70 10).* cpio examp │ │ │ │ │ -00041830: 6c65 3a20 2020 2020 2020 2020 2020 2020 le: │ │ │ │ │ -00041840: 2020 2020 2020 2020 2020 2020 2055 6e69 Uni │ │ │ │ │ -00041850: 666f 726d 2e20 2020 2020 2020 2020 2020 form. │ │ │ │ │ -00041860: 2020 286c 696e 6520 2033 3629 0a2a 2043 (line 36).* C │ │ │ │ │ -00041870: 5050 464c 4147 5320 616e 6420 414d 5f43 PPFLAGS and AM_C │ │ │ │ │ -00041880: 5050 464c 4147 533a 2020 2020 2020 2020 PPFLAGS: │ │ │ │ │ -00041890: 2020 2020 2020 466c 6167 2056 6172 6961 Flag Varia │ │ │ │ │ -000418a0: 626c 6573 204f 7264 6572 696e 672e 0a20 bles Ordering.. │ │ │ │ │ +00041800: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ +00041810: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00041820: 2031 3029 0a2a 2063 7069 6f20 6578 616d 10).* cpio exam │ │ │ │ │ +00041830: 706c 653a 2020 2020 2020 2020 2020 2020 ple: │ │ │ │ │ +00041840: 2020 2020 2020 2020 2020 2020 2020 556e Un │ │ │ │ │ +00041850: 6966 6f72 6d2e 2020 2020 2020 2020 2020 iform. │ │ │ │ │ +00041860: 2020 2028 6c69 6e65 2020 3336 290a 2a20 (line 36).* │ │ │ │ │ +00041870: 4350 5046 4c41 4753 2061 6e64 2041 4d5f CPPFLAGS and AM_ │ │ │ │ │ +00041880: 4350 5046 4c41 4753 3a20 2020 2020 2020 CPPFLAGS: │ │ │ │ │ +00041890: 2020 2020 2020 2046 6c61 6720 5661 7269 Flag Vari │ │ │ │ │ +000418a0: 6162 6c65 7320 4f72 6465 7269 6e67 2e0a ables Ordering.. │ │ │ │ │ 000418b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000418c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000418d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000418e0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000418f0: 6e65 2020 3230 290a 2a20 6372 6f73 732d ne 20).* cross- │ │ │ │ │ -00041900: 636f 6d70 696c 6174 696f 6e3a 2020 2020 compilation: │ │ │ │ │ +000418e0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +000418f0: 696e 6520 2032 3029 0a2a 2063 726f 7373 ine 20).* cross │ │ │ │ │ +00041900: 2d63 6f6d 7069 6c61 7469 6f6e 3a20 2020 -compilation: │ │ │ │ │ 00041910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041920: 2043 726f 7373 2d43 6f6d 7069 6c61 7469 Cross-Compilati │ │ │ │ │ -00041930: 6f6e 2e20 2020 286c 696e 6520 2020 3629 on. (line 6) │ │ │ │ │ -00041940: 0a2a 2063 726f 7373 2d63 6f6d 7069 6c61 .* cross-compila │ │ │ │ │ -00041950: 7469 6f6e 2065 7861 6d70 6c65 3a20 2020 tion example: │ │ │ │ │ -00041960: 2020 2020 2020 2020 2020 4372 6f73 732d Cross- │ │ │ │ │ -00041970: 436f 6d70 696c 6174 696f 6e2e 2020 2028 Compilation. ( │ │ │ │ │ -00041980: 6c69 6e65 2020 3235 290a 2a20 4356 5320 line 25).* CVS │ │ │ │ │ -00041990: 616e 6420 6765 6e65 7261 7465 6420 6669 and generated fi │ │ │ │ │ -000419a0: 6c65 733a 2020 2020 2020 2020 2020 2020 les: │ │ │ │ │ -000419b0: 2020 2043 5653 2e20 2020 2020 2020 2020 CVS. │ │ │ │ │ -000419c0: 2020 2020 2020 2020 286c 696e 6520 2034 (line 4 │ │ │ │ │ -000419d0: 3929 0a2a 2043 5653 2061 6e64 2074 6869 9).* CVS and thi │ │ │ │ │ -000419e0: 7264 2d70 6172 7479 2066 696c 6573 3a20 rd-party files: │ │ │ │ │ -000419f0: 2020 2020 2020 2020 2020 2020 4356 532e CVS. │ │ │ │ │ -00041a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041a10: 2028 6c69 6e65 2031 3337 290a 2a20 4356 (line 137).* CV │ │ │ │ │ -00041a20: 5320 616e 6420 7469 6d65 7374 616d 7073 S and timestamps │ │ │ │ │ -00041a30: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00041a40: 2020 2020 2043 5653 2e20 2020 2020 2020 CVS. │ │ │ │ │ -00041a50: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00041a60: 2032 3829 0a2a 2043 5858 464c 4147 5320 28).* CXXFLAGS │ │ │ │ │ -00041a70: 616e 6420 414d 5f43 5858 464c 4147 533a and AM_CXXFLAGS: │ │ │ │ │ -00041a80: 2020 2020 2020 2020 2020 2020 2020 466c Fl │ │ │ │ │ -00041a90: 6167 2056 6172 6961 626c 6573 204f 7264 ag Variables Ord │ │ │ │ │ -00041aa0: 6572 696e 672e 0a20 2020 2020 2020 2020 ering.. │ │ │ │ │ +00041920: 2020 4372 6f73 732d 436f 6d70 696c 6174 Cross-Compilat │ │ │ │ │ +00041930: 696f 6e2e 2020 2028 6c69 6e65 2020 2036 ion. (line 6 │ │ │ │ │ +00041940: 290a 2a20 6372 6f73 732d 636f 6d70 696c ).* cross-compil │ │ │ │ │ +00041950: 6174 696f 6e20 6578 616d 706c 653a 2020 ation example: │ │ │ │ │ +00041960: 2020 2020 2020 2020 2020 2043 726f 7373 Cross │ │ │ │ │ +00041970: 2d43 6f6d 7069 6c61 7469 6f6e 2e20 2020 -Compilation. │ │ │ │ │ +00041980: 286c 696e 6520 2032 3529 0a2a 2043 5653 (line 25).* CVS │ │ │ │ │ +00041990: 2061 6e64 2067 656e 6572 6174 6564 2066 and generated f │ │ │ │ │ +000419a0: 696c 6573 3a20 2020 2020 2020 2020 2020 iles: │ │ │ │ │ +000419b0: 2020 2020 4356 532e 2020 2020 2020 2020 CVS. │ │ │ │ │ +000419c0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +000419d0: 3439 290a 2a20 4356 5320 616e 6420 7468 49).* CVS and th │ │ │ │ │ +000419e0: 6972 642d 7061 7274 7920 6669 6c65 733a ird-party files: │ │ │ │ │ +000419f0: 2020 2020 2020 2020 2020 2020 2043 5653 CVS │ │ │ │ │ +00041a00: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00041a10: 2020 286c 696e 6520 3133 3729 0a2a 2043 (line 137).* C │ │ │ │ │ +00041a20: 5653 2061 6e64 2074 696d 6573 7461 6d70 VS and timestamp │ │ │ │ │ +00041a30: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ +00041a40: 2020 2020 2020 4356 532e 2020 2020 2020 CVS. │ │ │ │ │ +00041a50: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00041a60: 2020 3238 290a 2a20 4358 5846 4c41 4753 28).* CXXFLAGS │ │ │ │ │ +00041a70: 2061 6e64 2041 4d5f 4358 5846 4c41 4753 and AM_CXXFLAGS │ │ │ │ │ +00041a80: 3a20 2020 2020 2020 2020 2020 2020 2046 : F │ │ │ │ │ +00041a90: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ +00041aa0: 6465 7269 6e67 2e0a 2020 2020 2020 2020 dering.. │ │ │ │ │ 00041ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041ae0: 2020 2020 2028 6c69 6e65 2020 3230 290a (line 20). │ │ │ │ │ -00041af0: 2a20 6379 676e 7573 3a20 2020 2020 2020 * cygnus: │ │ │ │ │ +00041ae0: 2020 2020 2020 286c 696e 6520 2032 3029 (line 20) │ │ │ │ │ +00041af0: 0a2a 2063 7967 6e75 733a 2020 2020 2020 .* cygnus: │ │ │ │ │ 00041b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041b10: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ -00041b20: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -00041b30: 696e 6520 2032 3329 0a2a 2063 7967 6e75 ine 23).* cygnu │ │ │ │ │ -00041b40: 7320 7374 7269 6374 6e65 7373 3a20 2020 s strictness: │ │ │ │ │ +00041b10: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +00041b20: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ +00041b30: 6c69 6e65 2020 3233 290a 2a20 6379 676e line 23).* cygn │ │ │ │ │ +00041b40: 7573 2073 7472 6963 746e 6573 733a 2020 us strictness: │ │ │ │ │ 00041b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041b60: 2020 4379 676e 7573 2e20 2020 2020 2020 Cygnus. │ │ │ │ │ -00041b70: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00041b80: 290a 2a20 4441 5441 2070 7269 6d61 7279 ).* DATA primary │ │ │ │ │ -00041b90: 2c20 6465 6669 6e65 643a 2020 2020 2020 , defined: │ │ │ │ │ -00041ba0: 2020 2020 2020 2020 2020 2044 6174 612e Data. │ │ │ │ │ -00041bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041bc0: 286c 696e 6520 2020 3629 0a2a 2064 652d (line 6).* de- │ │ │ │ │ -00041bd0: 414e 5349 2d66 6963 6174 696f 6e2c 2064 ANSI-fication, d │ │ │ │ │ -00041be0: 6566 696e 6564 3a20 2020 2020 2020 2020 efined: │ │ │ │ │ -00041bf0: 2020 2020 414e 5349 2e20 2020 2020 2020 ANSI. │ │ │ │ │ -00041c00: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00041c10: 2036 290a 2a20 6465 6275 6720 6275 696c 6).* debug buil │ │ │ │ │ -00041c20: 642c 2065 7861 6d70 6c65 3a20 2020 2020 d, example: │ │ │ │ │ -00041c30: 2020 2020 2020 2020 2020 2020 2056 5041 VPA │ │ │ │ │ -00041c40: 5448 2042 7569 6c64 732e 2020 2020 2020 TH Builds. │ │ │ │ │ -00041c50: 2020 286c 696e 6520 2034 3629 0a2a 2064 (line 46).* d │ │ │ │ │ -00041c60: 6562 7567 6769 6e67 2072 756c 6573 3a20 ebugging rules: │ │ │ │ │ +00041b60: 2020 2043 7967 6e75 732e 2020 2020 2020 Cygnus. │ │ │ │ │ +00041b70: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00041b80: 3629 0a2a 2044 4154 4120 7072 696d 6172 6).* DATA primar │ │ │ │ │ +00041b90: 792c 2064 6566 696e 6564 3a20 2020 2020 y, defined: │ │ │ │ │ +00041ba0: 2020 2020 2020 2020 2020 2020 4461 7461 Data │ │ │ │ │ +00041bb0: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00041bc0: 2028 6c69 6e65 2020 2036 290a 2a20 6465 (line 6).* de │ │ │ │ │ +00041bd0: 2d41 4e53 492d 6669 6361 7469 6f6e 2c20 -ANSI-fication, │ │ │ │ │ +00041be0: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ +00041bf0: 2020 2020 2041 4e53 492e 2020 2020 2020 ANSI. │ │ │ │ │ +00041c00: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00041c10: 2020 3629 0a2a 2064 6562 7567 2062 7569 6).* debug bui │ │ │ │ │ +00041c20: 6c64 2c20 6578 616d 706c 653a 2020 2020 ld, example: │ │ │ │ │ +00041c30: 2020 2020 2020 2020 2020 2020 2020 5650 VP │ │ │ │ │ +00041c40: 4154 4820 4275 696c 6473 2e20 2020 2020 ATH Builds. │ │ │ │ │ +00041c50: 2020 2028 6c69 6e65 2020 3436 290a 2a20 (line 46).* │ │ │ │ │ +00041c60: 6465 6275 6767 696e 6720 7275 6c65 733a debugging rules: │ │ │ │ │ 00041c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041c80: 2020 2020 2020 4465 6275 6767 696e 6720 Debugging │ │ │ │ │ -00041c90: 4d61 6b65 2052 756c 6573 2e0a 2020 2020 Make Rules.. │ │ │ │ │ +00041c80: 2020 2020 2020 2044 6562 7567 6769 6e67 Debugging │ │ │ │ │ +00041c90: 204d 616b 6520 5275 6c65 732e 0a20 2020 Make Rules.. │ │ │ │ │ 00041ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041cd0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00041ce0: 2020 3629 0a2a 2064 6566 6175 6c74 2073 6).* default s │ │ │ │ │ -00041cf0: 6f75 7263 652c 204c 6962 746f 6f6c 206d ource, Libtool m │ │ │ │ │ -00041d00: 6f64 756c 6573 2065 7861 6d70 6c65 3a20 odules example: │ │ │ │ │ -00041d10: 4465 6661 756c 7420 5f53 4f55 5243 4553 Default _SOURCES │ │ │ │ │ -00041d20: 2e20 2028 6c69 6e65 2020 3338 290a 2a20 . (line 38).* │ │ │ │ │ -00041d30: 6465 6661 756c 7420 7665 7262 6f73 6974 default verbosit │ │ │ │ │ -00041d40: 7920 666f 7220 7369 6c65 6e74 2d72 756c y for silent-rul │ │ │ │ │ -00041d50: 6573 3a20 2020 2041 7574 6f6d 616b 6520 es: Automake │ │ │ │ │ -00041d60: 7369 6c65 6e74 2d72 756c 6573 204f 7074 silent-rules Opt │ │ │ │ │ -00041d70: 696f 6e2e 0a20 2020 2020 2020 2020 2020 ion.. │ │ │ │ │ +00041cd0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00041ce0: 2020 2036 290a 2a20 6465 6661 756c 7420 6).* default │ │ │ │ │ +00041cf0: 736f 7572 6365 2c20 4c69 6274 6f6f 6c20 source, Libtool │ │ │ │ │ +00041d00: 6d6f 6475 6c65 7320 6578 616d 706c 653a modules example: │ │ │ │ │ +00041d10: 2044 6566 6175 6c74 205f 534f 5552 4345 Default _SOURCE │ │ │ │ │ +00041d20: 532e 2020 286c 696e 6520 2033 3829 0a2a S. (line 38).* │ │ │ │ │ +00041d30: 2064 6566 6175 6c74 2076 6572 626f 7369 default verbosi │ │ │ │ │ +00041d40: 7479 2066 6f72 2073 696c 656e 742d 7275 ty for silent-ru │ │ │ │ │ +00041d50: 6c65 733a 2020 2020 4175 746f 6d61 6b65 les: Automake │ │ │ │ │ +00041d60: 2073 696c 656e 742d 7275 6c65 7320 4f70 silent-rules Op │ │ │ │ │ +00041d70: 7469 6f6e 2e0a 2020 2020 2020 2020 2020 tion.. │ │ │ │ │ 00041d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041d90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00041da0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041db0: 2020 2028 6c69 6e65 2031 3036 290a 2a20 (line 106).* │ │ │ │ │ -00041dc0: 6465 6661 756c 7420 5f53 4f55 5243 4553 default _SOURCES │ │ │ │ │ -00041dd0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00041de0: 2020 2020 2020 2044 6566 6175 6c74 205f Default _ │ │ │ │ │ -00041df0: 534f 5552 4345 532e 2020 2020 286c 696e SOURCES. (lin │ │ │ │ │ -00041e00: 6520 2020 3629 0a2a 2064 6566 696e 6974 e 6).* definit │ │ │ │ │ -00041e10: 696f 6e73 2c20 636f 6e66 6c69 6374 733a ions, conflicts: │ │ │ │ │ -00041e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041e30: 4578 7465 6e64 696e 672e 2020 2020 2020 Extending. │ │ │ │ │ -00041e40: 2020 2020 2028 6c69 6e65 2020 3134 290a (line 14). │ │ │ │ │ -00041e50: 2a20 6465 6a61 676e 753a 2020 2020 2020 * dejagnu: │ │ │ │ │ +00041db0: 2020 2020 286c 696e 6520 3130 3629 0a2a (line 106).* │ │ │ │ │ +00041dc0: 2064 6566 6175 6c74 205f 534f 5552 4345 default _SOURCE │ │ │ │ │ +00041dd0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +00041de0: 2020 2020 2020 2020 4465 6661 756c 7420 Default │ │ │ │ │ +00041df0: 5f53 4f55 5243 4553 2e20 2020 2028 6c69 _SOURCES. (li │ │ │ │ │ +00041e00: 6e65 2020 2036 290a 2a20 6465 6669 6e69 ne 6).* defini │ │ │ │ │ +00041e10: 7469 6f6e 732c 2063 6f6e 666c 6963 7473 tions, conflicts │ │ │ │ │ +00041e20: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00041e30: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ +00041e40: 2020 2020 2020 286c 696e 6520 2031 3429 (line 14) │ │ │ │ │ +00041e50: 0a2a 2064 656a 6167 6e75 3a20 2020 2020 .* dejagnu: │ │ │ │ │ 00041e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041e70: 2020 2020 2020 2020 2044 656a 6147 6e75 DejaGnu │ │ │ │ │ -00041e80: 2054 6573 7473 2e20 2020 2020 2020 286c Tests. (l │ │ │ │ │ -00041e90: 696e 6520 2031 3929 0a2a 2064 656a 6167 ine 19).* dejag │ │ │ │ │ -00041ea0: 6e75 203c 313e 3a20 2020 2020 2020 2020 nu <1>: │ │ │ │ │ +00041e70: 2020 2020 2020 2020 2020 4465 6a61 476e DejaGn │ │ │ │ │ +00041e80: 7520 5465 7374 732e 2020 2020 2020 2028 u Tests. ( │ │ │ │ │ +00041e90: 6c69 6e65 2020 3139 290a 2a20 6465 6a61 line 19).* deja │ │ │ │ │ +00041ea0: 676e 7520 3c31 3e3a 2020 2020 2020 2020 gnu <1>: │ │ │ │ │ 00041eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041ec0: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ -00041ed0: 2020 2020 2020 2028 6c69 6e65 2020 3437 (line 47 │ │ │ │ │ -00041ee0: 290a 2a20 6465 7063 6f6d 703a 2020 2020 ).* depcomp: │ │ │ │ │ +00041ec0: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ +00041ed0: 2020 2020 2020 2020 286c 696e 6520 2034 (line 4 │ │ │ │ │ +00041ee0: 3729 0a2a 2064 6570 636f 6d70 3a20 2020 7).* depcomp: │ │ │ │ │ 00041ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041f00: 2020 2020 2020 2020 2020 2044 6570 656e Depen │ │ │ │ │ -00041f10: 6465 6e63 6965 732e 2020 2020 2020 2020 dencies. │ │ │ │ │ -00041f20: 286c 696e 6520 2032 3229 0a2a 2064 6570 (line 22).* dep │ │ │ │ │ -00041f30: 656e 6465 6e63 6965 7320 616e 6420 6469 endencies and di │ │ │ │ │ -00041f40: 7374 7269 6275 7465 6420 6669 6c65 733a stributed files: │ │ │ │ │ -00041f50: 2020 2020 6469 7374 636c 6561 6e63 6865 distcleanche │ │ │ │ │ -00041f60: 636b 2e20 2020 2020 2028 6c69 6e65 2020 ck. (line │ │ │ │ │ -00041f70: 2036 290a 2a20 4465 7065 6e64 656e 6379 6).* Dependency │ │ │ │ │ -00041f80: 2074 7261 636b 696e 673a 2020 2020 2020 tracking: │ │ │ │ │ -00041f90: 2020 2020 2020 2020 2020 2020 2044 6570 Dep │ │ │ │ │ -00041fa0: 656e 6465 6e63 7920 5472 6163 6b69 6e67 endency Tracking │ │ │ │ │ -00041fb0: 2e20 286c 696e 6520 2020 3629 0a2a 2044 . (line 6).* D │ │ │ │ │ -00041fc0: 6570 656e 6465 6e63 7920 7472 6163 6b69 ependency tracki │ │ │ │ │ -00041fd0: 6e67 203c 313e 3a20 2020 2020 2020 2020 ng <1>: │ │ │ │ │ -00041fe0: 2020 2020 2020 4465 7065 6e64 656e 6369 Dependenci │ │ │ │ │ -00041ff0: 6573 2e20 2020 2020 2020 2028 6c69 6e65 es. (line │ │ │ │ │ -00042000: 2020 3131 290a 2a20 4465 7065 6e64 656e 11).* Dependen │ │ │ │ │ -00042010: 6379 2074 7261 636b 696e 672c 2064 6973 cy tracking, dis │ │ │ │ │ -00042020: 6162 6c69 6e67 3a20 2020 2020 2020 2044 abling: D │ │ │ │ │ -00042030: 6570 656e 6465 6e63 6965 732e 2020 2020 ependencies. │ │ │ │ │ -00042040: 2020 2020 286c 696e 6520 2033 3529 0a2a (line 35).* │ │ │ │ │ -00042050: 2064 6972 6563 746f 7279 2076 6172 6961 directory varia │ │ │ │ │ -00042060: 626c 6573 3a20 2020 2020 2020 2020 2020 bles: │ │ │ │ │ -00042070: 2020 2020 2020 2020 5374 616e 6461 7264 Standard │ │ │ │ │ -00042080: 2044 6972 6563 746f 7279 2056 6172 6961 Directory Varia │ │ │ │ │ -00042090: 626c 6573 2e0a 2020 2020 2020 2020 2020 bles.. │ │ │ │ │ +00041f00: 2020 2020 2020 2020 2020 2020 4465 7065 Depe │ │ │ │ │ +00041f10: 6e64 656e 6369 6573 2e20 2020 2020 2020 ndencies. │ │ │ │ │ +00041f20: 2028 6c69 6e65 2020 3232 290a 2a20 6465 (line 22).* de │ │ │ │ │ +00041f30: 7065 6e64 656e 6369 6573 2061 6e64 2064 pendencies and d │ │ │ │ │ +00041f40: 6973 7472 6962 7574 6564 2066 696c 6573 istributed files │ │ │ │ │ +00041f50: 3a20 2020 2064 6973 7463 6c65 616e 6368 : distcleanch │ │ │ │ │ +00041f60: 6563 6b2e 2020 2020 2020 286c 696e 6520 eck. (line │ │ │ │ │ +00041f70: 2020 3629 0a2a 2044 6570 656e 6465 6e63 6).* Dependenc │ │ │ │ │ +00041f80: 7920 7472 6163 6b69 6e67 3a20 2020 2020 y tracking: │ │ │ │ │ +00041f90: 2020 2020 2020 2020 2020 2020 2020 4465 De │ │ │ │ │ +00041fa0: 7065 6e64 656e 6379 2054 7261 636b 696e pendency Trackin │ │ │ │ │ +00041fb0: 672e 2028 6c69 6e65 2020 2036 290a 2a20 g. (line 6).* │ │ │ │ │ +00041fc0: 4465 7065 6e64 656e 6379 2074 7261 636b Dependency track │ │ │ │ │ +00041fd0: 696e 6720 3c31 3e3a 2020 2020 2020 2020 ing <1>: │ │ │ │ │ +00041fe0: 2020 2020 2020 2044 6570 656e 6465 6e63 Dependenc │ │ │ │ │ +00041ff0: 6965 732e 2020 2020 2020 2020 286c 696e ies. (lin │ │ │ │ │ +00042000: 6520 2031 3129 0a2a 2044 6570 656e 6465 e 11).* Depende │ │ │ │ │ +00042010: 6e63 7920 7472 6163 6b69 6e67 2c20 6469 ncy tracking, di │ │ │ │ │ +00042020: 7361 626c 696e 673a 2020 2020 2020 2020 sabling: │ │ │ │ │ +00042030: 4465 7065 6e64 656e 6369 6573 2e20 2020 Dependencies. │ │ │ │ │ +00042040: 2020 2020 2028 6c69 6e65 2020 3335 290a (line 35). │ │ │ │ │ +00042050: 2a20 6469 7265 6374 6f72 7920 7661 7269 * directory vari │ │ │ │ │ +00042060: 6162 6c65 733a 2020 2020 2020 2020 2020 ables: │ │ │ │ │ +00042070: 2020 2020 2020 2020 2053 7461 6e64 6172 Standar │ │ │ │ │ +00042080: 6420 4469 7265 6374 6f72 7920 5661 7269 d Directory Vari │ │ │ │ │ +00042090: 6162 6c65 732e 0a20 2020 2020 2020 2020 ables.. │ │ │ │ │ 000420a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000420b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000420c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000420d0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -000420e0: 2064 6972 6c69 7374 3a20 2020 2020 2020 dirlist: │ │ │ │ │ +000420d0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +000420e0: 2a20 6469 726c 6973 743a 2020 2020 2020 * dirlist: │ │ │ │ │ 000420f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042100: 2020 2020 2020 2020 4d61 6372 6f20 5365 Macro Se │ │ │ │ │ -00042110: 6172 6368 2050 6174 682e 2020 2028 6c69 arch Path. (li │ │ │ │ │ -00042120: 6e65 2020 3532 290a 2a20 4469 7361 626c ne 52).* Disabl │ │ │ │ │ -00042130: 696e 6720 6465 7065 6e64 656e 6379 2074 ing dependency t │ │ │ │ │ -00042140: 7261 636b 696e 673a 2020 2020 2020 2020 racking: │ │ │ │ │ -00042150: 2044 6570 656e 6465 6e63 6965 732e 2020 Dependencies. │ │ │ │ │ -00042160: 2020 2020 2020 286c 696e 6520 2033 3629 (line 36) │ │ │ │ │ -00042170: 0a2a 2064 6973 743a 2020 2020 2020 2020 .* dist: │ │ │ │ │ +00042100: 2020 2020 2020 2020 204d 6163 726f 2053 Macro S │ │ │ │ │ +00042110: 6561 7263 6820 5061 7468 2e20 2020 286c earch Path. (l │ │ │ │ │ +00042120: 696e 6520 2035 3229 0a2a 2044 6973 6162 ine 52).* Disab │ │ │ │ │ +00042130: 6c69 6e67 2064 6570 656e 6465 6e63 7920 ling dependency │ │ │ │ │ +00042140: 7472 6163 6b69 6e67 3a20 2020 2020 2020 tracking: │ │ │ │ │ +00042150: 2020 4465 7065 6e64 656e 6369 6573 2e20 Dependencies. │ │ │ │ │ +00042160: 2020 2020 2020 2028 6c69 6e65 2020 3336 (line 36 │ │ │ │ │ +00042170: 290a 2a20 6469 7374 3a20 2020 2020 2020 ).* dist: │ │ │ │ │ 00042180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042190: 2020 2020 2020 2020 2020 5374 616e 6461 Standa │ │ │ │ │ -000421a0: 7264 2054 6172 6765 7473 2e20 2020 2028 rd Targets. ( │ │ │ │ │ -000421b0: 6c69 6e65 2020 3335 290a 2a20 6469 7374 line 35).* dist │ │ │ │ │ -000421c0: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +00042190: 2020 2020 2020 2020 2020 2053 7461 6e64 Stand │ │ │ │ │ +000421a0: 6172 6420 5461 7267 6574 732e 2020 2020 ard Targets. │ │ │ │ │ +000421b0: 286c 696e 6520 2033 3529 0a2a 2064 6973 (line 35).* dis │ │ │ │ │ +000421c0: 7420 3c31 3e3a 2020 2020 2020 2020 2020 t <1>: │ │ │ │ │ 000421d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000421e0: 2020 2042 6173 6963 7320 6f66 2044 6973 Basics of Dis │ │ │ │ │ -000421f0: 7472 6962 7574 696f 6e2e 0a20 2020 2020 tribution.. │ │ │ │ │ +000421e0: 2020 2020 4261 7369 6373 206f 6620 4469 Basics of Di │ │ │ │ │ +000421f0: 7374 7269 6275 7469 6f6e 2e0a 2020 2020 stribution.. │ │ │ │ │ 00042200: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042230: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00042240: 2036 290a 2a20 6469 7374 2d62 7a69 7032 6).* dist-bzip2 │ │ │ │ │ -00042250: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00042260: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -00042270: 2054 7970 6573 206f 6620 4469 7374 7269 Types of Distri │ │ │ │ │ -00042280: 6275 7469 6f6e 732e 0a20 2020 2020 2020 butions.. │ │ │ │ │ +00042230: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00042240: 2020 3629 0a2a 2064 6973 742d 627a 6970 6).* dist-bzip │ │ │ │ │ +00042250: 323a 2020 2020 2020 2020 2020 2020 2020 2: │ │ │ │ │ +00042260: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ +00042270: 6520 5479 7065 7320 6f66 2044 6973 7472 e Types of Distr │ │ │ │ │ +00042280: 6962 7574 696f 6e73 2e0a 2020 2020 2020 ibutions.. │ │ │ │ │ 00042290: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000422a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000422b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000422c0: 2020 2020 2020 2028 6c69 6e65 2020 3134 (line 14 │ │ │ │ │ -000422d0: 290a 2a20 6469 7374 2d62 7a69 7032 203c ).* dist-bzip2 < │ │ │ │ │ -000422e0: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ -000422f0: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00042300: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00042310: 286c 696e 6520 2035 3129 0a2a 2064 6973 (line 51).* dis │ │ │ │ │ -00042320: 742d 627a 6970 3220 3c32 3e3a 2020 2020 t-bzip2 <2>: │ │ │ │ │ +000422c0: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +000422d0: 3429 0a2a 2064 6973 742d 627a 6970 3220 4).* dist-bzip2 │ │ │ │ │ +000422e0: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +000422f0: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00042300: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00042310: 2028 6c69 6e65 2020 3531 290a 2a20 6469 (line 51).* di │ │ │ │ │ +00042320: 7374 2d62 7a69 7032 203c 323e 3a20 2020 st-bzip2 <2>: │ │ │ │ │ 00042330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042340: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -00042350: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00042360: 3531 290a 2a20 6469 7374 2d67 7a69 703a 51).* dist-gzip: │ │ │ │ │ -00042370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042380: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -00042390: 2054 7970 6573 206f 6620 4469 7374 7269 Types of Distri │ │ │ │ │ -000423a0: 6275 7469 6f6e 732e 0a20 2020 2020 2020 butions.. │ │ │ │ │ +00042340: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ +00042350: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00042360: 2035 3129 0a2a 2064 6973 742d 677a 6970 51).* dist-gzip │ │ │ │ │ +00042370: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00042380: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ +00042390: 6520 5479 7065 7320 6f66 2044 6973 7472 e Types of Distr │ │ │ │ │ +000423a0: 6962 7574 696f 6e73 2e0a 2020 2020 2020 ibutions.. │ │ │ │ │ 000423b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000423c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000423d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000423e0: 2020 2020 2020 2028 6c69 6e65 2020 3137 (line 17 │ │ │ │ │ -000423f0: 290a 2a20 6469 7374 2d68 6f6f 6b3a 2020 ).* dist-hook: │ │ │ │ │ +000423e0: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +000423f0: 3729 0a2a 2064 6973 742d 686f 6f6b 3a20 7).* dist-hook: │ │ │ │ │ 00042400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042410: 2020 2020 2020 2020 2020 2054 6865 2064 The d │ │ │ │ │ -00042420: 6973 7420 486f 6f6b 2e20 2020 2020 2020 ist Hook. │ │ │ │ │ -00042430: 286c 696e 6520 2020 3629 0a2a 2064 6973 (line 6).* dis │ │ │ │ │ -00042440: 742d 686f 6f6b 203c 313e 3a20 2020 2020 t-hook <1>: │ │ │ │ │ +00042410: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ +00042420: 6469 7374 2048 6f6f 6b2e 2020 2020 2020 dist Hook. │ │ │ │ │ +00042430: 2028 6c69 6e65 2020 2036 290a 2a20 6469 (line 6).* di │ │ │ │ │ +00042440: 7374 2d68 6f6f 6b20 3c31 3e3a 2020 2020 st-hook <1>: │ │ │ │ │ 00042450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042460: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ -00042470: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00042480: 3636 290a 2a20 6469 7374 2d6c 7a69 703a 66).* dist-lzip: │ │ │ │ │ -00042490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000424a0: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -000424b0: 2054 7970 6573 206f 6620 4469 7374 7269 Types of Distri │ │ │ │ │ -000424c0: 6275 7469 6f6e 732e 0a20 2020 2020 2020 butions.. │ │ │ │ │ +00042460: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ +00042470: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00042480: 2036 3629 0a2a 2064 6973 742d 6c7a 6970 66).* dist-lzip │ │ │ │ │ +00042490: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000424a0: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ +000424b0: 6520 5479 7065 7320 6f66 2044 6973 7472 e Types of Distr │ │ │ │ │ +000424c0: 6962 7574 696f 6e73 2e0a 2020 2020 2020 ibutions.. │ │ │ │ │ 000424d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000424e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000424f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042500: 2020 2020 2020 2028 6c69 6e65 2020 3231 (line 21 │ │ │ │ │ -00042510: 290a 2a20 6469 7374 2d6c 7a69 7020 3c31 ).* dist-lzip <1 │ │ │ │ │ -00042520: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ -00042530: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00042540: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00042550: 286c 696e 6520 2035 3429 0a2a 2064 6973 (line 54).* dis │ │ │ │ │ -00042560: 742d 6c7a 6970 203c 323e 3a20 2020 2020 t-lzip <2>: │ │ │ │ │ +00042500: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +00042510: 3129 0a2a 2064 6973 742d 6c7a 6970 203c 1).* dist-lzip < │ │ │ │ │ +00042520: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +00042530: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00042540: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00042550: 2028 6c69 6e65 2020 3534 290a 2a20 6469 (line 54).* di │ │ │ │ │ +00042560: 7374 2d6c 7a69 7020 3c32 3e3a 2020 2020 st-lzip <2>: │ │ │ │ │ 00042570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042580: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -00042590: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000425a0: 3534 290a 2a20 6469 7374 2d6c 7a6d 613a 54).* dist-lzma: │ │ │ │ │ -000425b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000425c0: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -000425d0: 2054 7970 6573 206f 6620 4469 7374 7269 Types of Distri │ │ │ │ │ -000425e0: 6275 7469 6f6e 732e 0a20 2020 2020 2020 butions.. │ │ │ │ │ +00042580: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ +00042590: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000425a0: 2035 3429 0a2a 2064 6973 742d 6c7a 6d61 54).* dist-lzma │ │ │ │ │ +000425b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000425c0: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ +000425d0: 6520 5479 7065 7320 6f66 2044 6973 7472 e Types of Distr │ │ │ │ │ +000425e0: 6962 7574 696f 6e73 2e0a 2020 2020 2020 ibutions.. │ │ │ │ │ 000425f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042620: 2020 2020 2020 2028 6c69 6e65 2020 3237 (line 27 │ │ │ │ │ -00042630: 290a 2a20 6469 7374 2d6c 7a6d 6120 3c31 ).* dist-lzma <1 │ │ │ │ │ -00042640: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ -00042650: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00042660: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00042670: 286c 696e 6520 2035 3729 0a2a 2064 6973 (line 57).* dis │ │ │ │ │ -00042680: 742d 6c7a 6d61 203c 323e 3a20 2020 2020 t-lzma <2>: │ │ │ │ │ +00042620: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +00042630: 3729 0a2a 2064 6973 742d 6c7a 6d61 203c 7).* dist-lzma < │ │ │ │ │ +00042640: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +00042650: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00042660: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00042670: 2028 6c69 6e65 2020 3537 290a 2a20 6469 (line 57).* di │ │ │ │ │ +00042680: 7374 2d6c 7a6d 6120 3c32 3e3a 2020 2020 st-lzma <2>: │ │ │ │ │ 00042690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000426a0: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -000426b0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000426c0: 3537 290a 2a20 6469 7374 2d73 6861 723a 57).* dist-shar: │ │ │ │ │ -000426d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000426e0: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -000426f0: 2054 7970 6573 206f 6620 4469 7374 7269 Types of Distri │ │ │ │ │ -00042700: 6275 7469 6f6e 732e 0a20 2020 2020 2020 butions.. │ │ │ │ │ +000426a0: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ +000426b0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000426c0: 2035 3729 0a2a 2064 6973 742d 7368 6172 57).* dist-shar │ │ │ │ │ +000426d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000426e0: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ +000426f0: 6520 5479 7065 7320 6f66 2044 6973 7472 e Types of Distr │ │ │ │ │ +00042700: 6962 7574 696f 6e73 2e0a 2020 2020 2020 ibutions.. │ │ │ │ │ 00042710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042720: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042730: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042740: 2020 2020 2020 2028 6c69 6e65 2020 3330 (line 30 │ │ │ │ │ -00042750: 290a 2a20 6469 7374 2d73 6861 7220 3c31 ).* dist-shar <1 │ │ │ │ │ -00042760: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ -00042770: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00042780: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00042790: 286c 696e 6520 2036 3029 0a2a 2064 6973 (line 60).* dis │ │ │ │ │ -000427a0: 742d 7368 6172 203c 323e 3a20 2020 2020 t-shar <2>: │ │ │ │ │ +00042740: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ +00042750: 3029 0a2a 2064 6973 742d 7368 6172 203c 0).* dist-shar < │ │ │ │ │ +00042760: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +00042770: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00042780: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00042790: 2028 6c69 6e65 2020 3630 290a 2a20 6469 (line 60).* di │ │ │ │ │ +000427a0: 7374 2d73 6861 7220 3c32 3e3a 2020 2020 st-shar <2>: │ │ │ │ │ 000427b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000427c0: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -000427d0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000427e0: 3630 290a 2a20 6469 7374 2d74 6172 5a3a 60).* dist-tarZ: │ │ │ │ │ -000427f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042800: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -00042810: 2054 7970 6573 206f 6620 4469 7374 7269 Types of Distri │ │ │ │ │ -00042820: 6275 7469 6f6e 732e 0a20 2020 2020 2020 butions.. │ │ │ │ │ +000427c0: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ +000427d0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000427e0: 2036 3029 0a2a 2064 6973 742d 7461 725a 60).* dist-tarZ │ │ │ │ │ +000427f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00042800: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ +00042810: 6520 5479 7065 7320 6f66 2044 6973 7472 e Types of Distr │ │ │ │ │ +00042820: 6962 7574 696f 6e73 2e0a 2020 2020 2020 ibutions.. │ │ │ │ │ 00042830: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042860: 2020 2020 2020 2028 6c69 6e65 2020 3435 (line 45 │ │ │ │ │ -00042870: 290a 2a20 6469 7374 2d74 6172 5a20 3c31 ).* dist-tarZ <1 │ │ │ │ │ -00042880: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ -00042890: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -000428a0: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -000428b0: 286c 696e 6520 2036 3629 0a2a 2064 6973 (line 66).* dis │ │ │ │ │ -000428c0: 742d 7461 725a 203c 323e 3a20 2020 2020 t-tarZ <2>: │ │ │ │ │ +00042860: 2020 2020 2020 2020 286c 696e 6520 2034 (line 4 │ │ │ │ │ +00042870: 3529 0a2a 2064 6973 742d 7461 725a 203c 5).* dist-tarZ < │ │ │ │ │ +00042880: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +00042890: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +000428a0: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +000428b0: 2028 6c69 6e65 2020 3636 290a 2a20 6469 (line 66).* di │ │ │ │ │ +000428c0: 7374 2d74 6172 5a20 3c32 3e3a 2020 2020 st-tarZ <2>: │ │ │ │ │ 000428d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000428e0: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -000428f0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00042900: 3636 290a 2a20 6469 7374 2d78 7a3a 2020 66).* dist-xz: │ │ │ │ │ +000428e0: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ +000428f0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00042900: 2036 3629 0a2a 2064 6973 742d 787a 3a20 66).* dist-xz: │ │ │ │ │ 00042910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042920: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -00042930: 2054 7970 6573 206f 6620 4469 7374 7269 Types of Distri │ │ │ │ │ -00042940: 6275 7469 6f6e 732e 0a20 2020 2020 2020 butions.. │ │ │ │ │ +00042920: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ +00042930: 6520 5479 7065 7320 6f66 2044 6973 7472 e Types of Distr │ │ │ │ │ +00042940: 6962 7574 696f 6e73 2e0a 2020 2020 2020 ibutions.. │ │ │ │ │ 00042950: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042970: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042980: 2020 2020 2020 2028 6c69 6e65 2020 3339 (line 39 │ │ │ │ │ -00042990: 290a 2a20 6469 7374 2d7a 6970 3a20 2020 ).* dist-zip: │ │ │ │ │ +00042980: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ +00042990: 3929 0a2a 2064 6973 742d 7a69 703a 2020 9).* dist-zip: │ │ │ │ │ 000429a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000429b0: 2020 2020 2020 2020 2020 2054 6865 2054 The T │ │ │ │ │ -000429c0: 7970 6573 206f 6620 4469 7374 7269 6275 ypes of Distribu │ │ │ │ │ -000429d0: 7469 6f6e 732e 0a20 2020 2020 2020 2020 tions.. │ │ │ │ │ +000429b0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ +000429c0: 5479 7065 7320 6f66 2044 6973 7472 6962 Types of Distrib │ │ │ │ │ +000429d0: 7574 696f 6e73 2e0a 2020 2020 2020 2020 utions.. │ │ │ │ │ 000429e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000429f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042a10: 2020 2020 2028 6c69 6e65 2020 3432 290a (line 42). │ │ │ │ │ -00042a20: 2a20 6469 7374 2d7a 6970 203c 313e 3a20 * dist-zip <1>: │ │ │ │ │ +00042a10: 2020 2020 2020 286c 696e 6520 2034 3229 (line 42) │ │ │ │ │ +00042a20: 0a2a 2064 6973 742d 7a69 7020 3c31 3e3a .* dist-zip <1>: │ │ │ │ │ 00042a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042a40: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ -00042a50: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -00042a60: 696e 6520 2036 3329 0a2a 2064 6973 742d ine 63).* dist- │ │ │ │ │ -00042a70: 7a69 7020 3c32 3e3a 2020 2020 2020 2020 zip <2>: │ │ │ │ │ +00042a40: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +00042a50: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ +00042a60: 6c69 6e65 2020 3633 290a 2a20 6469 7374 line 63).* dist │ │ │ │ │ +00042a70: 2d7a 6970 203c 323e 3a20 2020 2020 2020 -zip <2>: │ │ │ │ │ 00042a80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042a90: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ -00042aa0: 2020 2020 2020 2028 6c69 6e65 2020 3633 (line 63 │ │ │ │ │ -00042ab0: 290a 2a20 6469 7374 6368 6563 6b3a 2020 ).* distcheck: │ │ │ │ │ +00042a90: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ +00042aa0: 2020 2020 2020 2020 286c 696e 6520 2036 (line 6 │ │ │ │ │ +00042ab0: 3329 0a2a 2064 6973 7463 6865 636b 3a20 3).* distcheck: │ │ │ │ │ 00042ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042ad0: 2020 2020 2020 2020 2020 2043 7265 6174 Creat │ │ │ │ │ -00042ae0: 696e 6720 616d 6865 6c6c 6f2e 2020 2020 ing amhello. │ │ │ │ │ -00042af0: 286c 696e 6520 2039 3929 0a2a 2064 6973 (line 99).* dis │ │ │ │ │ -00042b00: 7463 6865 636b 203c 313e 3a20 2020 2020 tcheck <1>: │ │ │ │ │ +00042ad0: 2020 2020 2020 2020 2020 2020 4372 6561 Crea │ │ │ │ │ +00042ae0: 7469 6e67 2061 6d68 656c 6c6f 2e20 2020 ting amhello. │ │ │ │ │ +00042af0: 2028 6c69 6e65 2020 3939 290a 2a20 6469 (line 99).* di │ │ │ │ │ +00042b00: 7374 6368 6563 6b20 3c31 3e3a 2020 2020 stcheck <1>: │ │ │ │ │ 00042b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042b20: 2020 2020 4368 6563 6b69 6e67 2074 6865 Checking the │ │ │ │ │ -00042b30: 2044 6973 7472 6962 7574 696f 6e2e 0a20 Distribution.. │ │ │ │ │ +00042b20: 2020 2020 2043 6865 636b 696e 6720 7468 Checking th │ │ │ │ │ +00042b30: 6520 4469 7374 7269 6275 7469 6f6e 2e0a e Distribution.. │ │ │ │ │ 00042b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042b60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042b70: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00042b80: 6e65 2020 2036 290a 2a20 6469 7374 6368 ne 6).* distch │ │ │ │ │ -00042b90: 6563 6b20 6265 7474 6572 2074 6861 6e20 eck better than │ │ │ │ │ -00042ba0: 6469 7374 3a20 2020 2020 2020 2020 2020 dist: │ │ │ │ │ -00042bb0: 2050 7265 7061 7269 6e67 2044 6973 7472 Preparing Distr │ │ │ │ │ -00042bc0: 6962 7574 696f 6e73 2e0a 2020 2020 2020 ibutions.. │ │ │ │ │ +00042b70: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00042b80: 696e 6520 2020 3629 0a2a 2064 6973 7463 ine 6).* distc │ │ │ │ │ +00042b90: 6865 636b 2062 6574 7465 7220 7468 616e heck better than │ │ │ │ │ +00042ba0: 2064 6973 743a 2020 2020 2020 2020 2020 dist: │ │ │ │ │ +00042bb0: 2020 5072 6570 6172 696e 6720 4469 7374 Preparing Dist │ │ │ │ │ +00042bc0: 7269 6275 7469 6f6e 732e 0a20 2020 2020 ributions.. │ │ │ │ │ 00042bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042be0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042c00: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -00042c10: 3029 0a2a 2064 6973 7463 6865 636b 2065 0).* distcheck e │ │ │ │ │ -00042c20: 7861 6d70 6c65 3a20 2020 2020 2020 2020 xample: │ │ │ │ │ -00042c30: 2020 2020 2020 2020 2020 2020 4372 6561 Crea │ │ │ │ │ -00042c40: 7469 6e67 2061 6d68 656c 6c6f 2e20 2020 ting amhello. │ │ │ │ │ -00042c50: 2028 6c69 6e65 2020 3939 290a 2a20 6469 (line 99).* di │ │ │ │ │ -00042c60: 7374 6368 6563 6b2d 686f 6f6b 3a20 2020 stcheck-hook: │ │ │ │ │ +00042c00: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00042c10: 3130 290a 2a20 6469 7374 6368 6563 6b20 10).* distcheck │ │ │ │ │ +00042c20: 6578 616d 706c 653a 2020 2020 2020 2020 example: │ │ │ │ │ +00042c30: 2020 2020 2020 2020 2020 2020 2043 7265 Cre │ │ │ │ │ +00042c40: 6174 696e 6720 616d 6865 6c6c 6f2e 2020 ating amhello. │ │ │ │ │ +00042c50: 2020 286c 696e 6520 2039 3929 0a2a 2064 (line 99).* d │ │ │ │ │ +00042c60: 6973 7463 6865 636b 2d68 6f6f 6b3a 2020 istcheck-hook: │ │ │ │ │ 00042c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042c80: 2020 2020 2043 6865 636b 696e 6720 7468 Checking th │ │ │ │ │ -00042c90: 6520 4469 7374 7269 6275 7469 6f6e 2e0a e Distribution.. │ │ │ │ │ -00042ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00042c80: 2020 2020 2020 4368 6563 6b69 6e67 2074 Checking t │ │ │ │ │ +00042c90: 6865 2044 6973 7472 6962 7574 696f 6e2e he Distribution. │ │ │ │ │ +00042ca0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00042cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042cd0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00042ce0: 696e 6520 2033 3329 0a2a 2064 6973 7463 ine 33).* distc │ │ │ │ │ -00042cf0: 6c65 616e 3a20 2020 2020 2020 2020 2020 lean: │ │ │ │ │ +00042cd0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00042ce0: 6c69 6e65 2020 3333 290a 2a20 6469 7374 line 33).* dist │ │ │ │ │ +00042cf0: 636c 6561 6e3a 2020 2020 2020 2020 2020 clean: │ │ │ │ │ 00042d00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042d10: 2020 5374 616e 6461 7264 2054 6172 6765 Standard Targe │ │ │ │ │ -00042d20: 7473 2e20 2020 2028 6c69 6e65 2020 3239 ts. (line 29 │ │ │ │ │ -00042d30: 290a 2a20 6469 7374 636c 6561 6e20 3c31 ).* distclean <1 │ │ │ │ │ -00042d40: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ -00042d50: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ -00042d60: 6469 6e67 2e20 2020 2020 2020 2020 2020 ding. │ │ │ │ │ -00042d70: 286c 696e 6520 2034 3129 0a2a 2064 6973 (line 41).* dis │ │ │ │ │ -00042d80: 7463 6c65 616e 203c 323e 3a20 2020 2020 tclean <2>: │ │ │ │ │ +00042d10: 2020 2053 7461 6e64 6172 6420 5461 7267 Standard Targ │ │ │ │ │ +00042d20: 6574 732e 2020 2020 286c 696e 6520 2032 ets. (line 2 │ │ │ │ │ +00042d30: 3929 0a2a 2064 6973 7463 6c65 616e 203c 9).* distclean < │ │ │ │ │ +00042d40: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +00042d50: 2020 2020 2020 2020 2020 2020 4578 7465 Exte │ │ │ │ │ +00042d60: 6e64 696e 672e 2020 2020 2020 2020 2020 nding. │ │ │ │ │ +00042d70: 2028 6c69 6e65 2020 3431 290a 2a20 6469 (line 41).* di │ │ │ │ │ +00042d80: 7374 636c 6561 6e20 3c32 3e3a 2020 2020 stclean <2>: │ │ │ │ │ 00042d90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042da0: 2020 2020 6469 7374 636c 6561 6e63 6865 distcleanche │ │ │ │ │ -00042db0: 636b 2e20 2020 2020 2028 6c69 6e65 2020 ck. (line │ │ │ │ │ -00042dc0: 2036 290a 2a20 6469 7374 636c 6561 6e2c 6).* distclean, │ │ │ │ │ -00042dd0: 2064 6961 676e 6f73 7469 633a 2020 2020 diagnostic: │ │ │ │ │ -00042de0: 2020 2020 2020 2020 2020 2020 2064 6973 dis │ │ │ │ │ -00042df0: 7463 6c65 616e 6368 6563 6b2e 2020 2020 tcleancheck. │ │ │ │ │ -00042e00: 2020 286c 696e 6520 2020 3629 0a2a 2064 (line 6).* d │ │ │ │ │ -00042e10: 6973 7463 6c65 616e 2d6c 6f63 616c 3a20 istclean-local: │ │ │ │ │ +00042da0: 2020 2020 2064 6973 7463 6c65 616e 6368 distcleanch │ │ │ │ │ +00042db0: 6563 6b2e 2020 2020 2020 286c 696e 6520 eck. (line │ │ │ │ │ +00042dc0: 2020 3629 0a2a 2064 6973 7463 6c65 616e 6).* distclean │ │ │ │ │ +00042dd0: 2c20 6469 6167 6e6f 7374 6963 3a20 2020 , diagnostic: │ │ │ │ │ +00042de0: 2020 2020 2020 2020 2020 2020 2020 6469 di │ │ │ │ │ +00042df0: 7374 636c 6561 6e63 6865 636b 2e20 2020 stcleancheck. │ │ │ │ │ +00042e00: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +00042e10: 6469 7374 636c 6561 6e2d 6c6f 6361 6c3a distclean-local: │ │ │ │ │ 00042e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042e30: 2020 2020 2020 436c 6561 6e2e 2020 2020 Clean. │ │ │ │ │ -00042e40: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00042e50: 2020 3135 290a 2a20 6469 7374 636c 6561 15).* distclea │ │ │ │ │ -00042e60: 6e2d 6c6f 6361 6c20 3c31 3e3a 2020 2020 n-local <1>: │ │ │ │ │ -00042e70: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ -00042e80: 7874 656e 6469 6e67 2e20 2020 2020 2020 xtending. │ │ │ │ │ -00042e90: 2020 2020 286c 696e 6520 2034 3129 0a2a (line 41).* │ │ │ │ │ -00042ea0: 2064 6973 7463 6c65 616e 6368 6563 6b3a distcleancheck: │ │ │ │ │ -00042eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042ec0: 2020 2020 2020 2020 4368 6563 6b69 6e67 Checking │ │ │ │ │ -00042ed0: 2074 6865 2044 6973 7472 6962 7574 696f the Distributio │ │ │ │ │ -00042ee0: 6e2e 0a20 2020 2020 2020 2020 2020 2020 n.. │ │ │ │ │ +00042e30: 2020 2020 2020 2043 6c65 616e 2e20 2020 Clean. │ │ │ │ │ +00042e40: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00042e50: 6520 2031 3529 0a2a 2064 6973 7463 6c65 e 15).* distcle │ │ │ │ │ +00042e60: 616e 2d6c 6f63 616c 203c 313e 3a20 2020 an-local <1>: │ │ │ │ │ +00042e70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00042e80: 4578 7465 6e64 696e 672e 2020 2020 2020 Extending. │ │ │ │ │ +00042e90: 2020 2020 2028 6c69 6e65 2020 3431 290a (line 41). │ │ │ │ │ +00042ea0: 2a20 6469 7374 636c 6561 6e63 6865 636b * distcleancheck │ │ │ │ │ +00042eb0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00042ec0: 2020 2020 2020 2020 2043 6865 636b 696e Checkin │ │ │ │ │ +00042ed0: 6720 7468 6520 4469 7374 7269 6275 7469 g the Distributi │ │ │ │ │ +00042ee0: 6f6e 2e0a 2020 2020 2020 2020 2020 2020 on.. │ │ │ │ │ 00042ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042f00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042f20: 2028 6c69 6e65 2020 3435 290a 2a20 6469 (line 45).* di │ │ │ │ │ -00042f30: 7374 636c 6561 6e63 6865 636b 203c 313e stcleancheck <1> │ │ │ │ │ -00042f40: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00042f50: 2020 2020 2064 6973 7463 6c65 616e 6368 distcleanch │ │ │ │ │ -00042f60: 6563 6b2e 2020 2020 2020 286c 696e 6520 eck. (line │ │ │ │ │ -00042f70: 2020 3629 0a2a 2064 6973 7464 6972 3a20 6).* distdir: │ │ │ │ │ +00042f20: 2020 286c 696e 6520 2034 3529 0a2a 2064 (line 45).* d │ │ │ │ │ +00042f30: 6973 7463 6c65 616e 6368 6563 6b20 3c31 istcleancheck <1 │ │ │ │ │ +00042f40: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +00042f50: 2020 2020 2020 6469 7374 636c 6561 6e63 distcleanc │ │ │ │ │ +00042f60: 6865 636b 2e20 2020 2020 2028 6c69 6e65 heck. (line │ │ │ │ │ +00042f70: 2020 2036 290a 2a20 6469 7374 6469 723a 6).* distdir: │ │ │ │ │ 00042f80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042f90: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ -00042fa0: 6972 642d 5061 7274 7920 4d61 6b65 6669 ird-Party Makefi │ │ │ │ │ -00042fb0: 6c65 732e 0a20 2020 2020 2020 2020 2020 les.. │ │ │ │ │ +00042f90: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ +00042fa0: 6869 7264 2d50 6172 7479 204d 616b 6566 hird-Party Makef │ │ │ │ │ +00042fb0: 696c 6573 2e0a 2020 2020 2020 2020 2020 iles.. │ │ │ │ │ 00042fc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00042fe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00042ff0: 2020 2028 6c69 6e65 2020 3235 290a 2a20 (line 25).* │ │ │ │ │ -00043000: 4469 7374 7269 6275 7469 6f6e 732c 2070 Distributions, p │ │ │ │ │ -00043010: 7265 7061 7261 7469 6f6e 3a20 2020 2020 reparation: │ │ │ │ │ -00043020: 2020 2020 2020 2050 7265 7061 7269 6e67 Preparing │ │ │ │ │ -00043030: 2044 6973 7472 6962 7574 696f 6e73 2e0a Distributions.. │ │ │ │ │ -00043040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00042ff0: 2020 2020 286c 696e 6520 2032 3529 0a2a (line 25).* │ │ │ │ │ +00043000: 2044 6973 7472 6962 7574 696f 6e73 2c20 Distributions, │ │ │ │ │ +00043010: 7072 6570 6172 6174 696f 6e3a 2020 2020 preparation: │ │ │ │ │ +00043020: 2020 2020 2020 2020 5072 6570 6172 696e Preparin │ │ │ │ │ +00043030: 6720 4469 7374 7269 6275 7469 6f6e 732e g Distributions. │ │ │ │ │ +00043040: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00043050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043070: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00043080: 696e 6520 2020 3629 0a2a 2064 6973 745f ine 6).* dist_ │ │ │ │ │ -00043090: 2061 6e64 206e 6f62 6173 655f 3a20 2020 and nobase_: │ │ │ │ │ +00043070: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00043080: 6c69 6e65 2020 2036 290a 2a20 6469 7374 line 6).* dist │ │ │ │ │ +00043090: 5f20 616e 6420 6e6f 6261 7365 5f3a 2020 _ and nobase_: │ │ │ │ │ 000430a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000430b0: 2020 416c 7465 726e 6174 6976 652e 2020 Alternative. │ │ │ │ │ -000430c0: 2020 2020 2020 2028 6c69 6e65 2020 3239 (line 29 │ │ │ │ │ -000430d0: 290a 2a20 6469 7374 5f20 616e 6420 6e6f ).* dist_ and no │ │ │ │ │ -000430e0: 7472 616e 735f 3a20 2020 2020 2020 2020 trans_: │ │ │ │ │ -000430f0: 2020 2020 2020 2020 2020 204d 616e 2050 Man P │ │ │ │ │ -00043100: 6167 6573 2e20 2020 2020 2020 2020 2020 ages. │ │ │ │ │ -00043110: 286c 696e 6520 2036 3329 0a2a 2044 4953 (line 63).* DIS │ │ │ │ │ -00043120: 545f 5355 4244 4952 532c 2065 7870 6c61 T_SUBDIRS, expla │ │ │ │ │ -00043130: 696e 6564 3a20 2020 2020 2020 2020 2020 ined: │ │ │ │ │ -00043140: 2020 2020 5355 4244 4952 5320 7673 2044 SUBDIRS vs D │ │ │ │ │ -00043150: 4953 545f 5355 4244 4952 532e 0a20 2020 IST_SUBDIRS.. │ │ │ │ │ +000430b0: 2020 2041 6c74 6572 6e61 7469 7665 2e20 Alternative. │ │ │ │ │ +000430c0: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +000430d0: 3929 0a2a 2064 6973 745f 2061 6e64 206e 9).* dist_ and n │ │ │ │ │ +000430e0: 6f74 7261 6e73 5f3a 2020 2020 2020 2020 otrans_: │ │ │ │ │ +000430f0: 2020 2020 2020 2020 2020 2020 4d61 6e20 Man │ │ │ │ │ +00043100: 5061 6765 732e 2020 2020 2020 2020 2020 Pages. │ │ │ │ │ +00043110: 2028 6c69 6e65 2020 3633 290a 2a20 4449 (line 63).* DI │ │ │ │ │ +00043120: 5354 5f53 5542 4449 5253 2c20 6578 706c ST_SUBDIRS, expl │ │ │ │ │ +00043130: 6169 6e65 643a 2020 2020 2020 2020 2020 ained: │ │ │ │ │ +00043140: 2020 2020 2053 5542 4449 5253 2076 7320 SUBDIRS vs │ │ │ │ │ +00043150: 4449 5354 5f53 5542 4449 5253 2e0a 2020 DIST_SUBDIRS.. │ │ │ │ │ 00043160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043190: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -000431a0: 2020 2036 290a 2a20 646d 616c 6c6f 632c 6).* dmalloc, │ │ │ │ │ -000431b0: 2073 7570 706f 7274 2066 6f72 3a20 2020 support for: │ │ │ │ │ -000431c0: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ -000431d0: 7562 6c69 6320 4d61 6372 6f73 2e20 2020 ublic Macros. │ │ │ │ │ -000431e0: 2020 2020 286c 696e 6520 3131 3929 0a2a (line 119).* │ │ │ │ │ -000431f0: 2064 7669 3a20 2020 2020 2020 2020 2020 dvi: │ │ │ │ │ +00043190: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +000431a0: 6520 2020 3629 0a2a 2064 6d61 6c6c 6f63 e 6).* dmalloc │ │ │ │ │ +000431b0: 2c20 7375 7070 6f72 7420 666f 723a 2020 , support for: │ │ │ │ │ +000431c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000431d0: 5075 626c 6963 204d 6163 726f 732e 2020 Public Macros. │ │ │ │ │ +000431e0: 2020 2020 2028 6c69 6e65 2031 3139 290a (line 119). │ │ │ │ │ +000431f0: 2a20 6476 693a 2020 2020 2020 2020 2020 * dvi: │ │ │ │ │ 00043200: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043210: 2020 2020 2020 2020 5465 7869 6e66 6f2e Texinfo. │ │ │ │ │ -00043220: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00043230: 6e65 2020 3139 290a 2a20 6476 6920 3c31 ne 19).* dvi <1 │ │ │ │ │ -00043240: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +00043210: 2020 2020 2020 2020 2054 6578 696e 666f Texinfo │ │ │ │ │ +00043220: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00043230: 696e 6520 2031 3929 0a2a 2064 7669 203c ine 19).* dvi < │ │ │ │ │ +00043240: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ 00043250: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043260: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ -00043270: 2020 2020 2020 286c 696e 6520 2034 3129 (line 41) │ │ │ │ │ -00043280: 0a2a 2044 5649 206f 7574 7075 7420 7573 .* DVI output us │ │ │ │ │ -00043290: 696e 6720 5465 7869 6e66 6f3a 2020 2020 ing Texinfo: │ │ │ │ │ -000432a0: 2020 2020 2020 2020 2020 5465 7869 6e66 Texinf │ │ │ │ │ -000432b0: 6f2e 2020 2020 2020 2020 2020 2020 2028 o. ( │ │ │ │ │ -000432c0: 6c69 6e65 2020 2036 290a 2a20 6476 692d line 6).* dvi- │ │ │ │ │ -000432d0: 6c6f 6361 6c3a 2020 2020 2020 2020 2020 local: │ │ │ │ │ +00043260: 2020 4578 7465 6e64 696e 672e 2020 2020 Extending. │ │ │ │ │ +00043270: 2020 2020 2020 2028 6c69 6e65 2020 3431 (line 41 │ │ │ │ │ +00043280: 290a 2a20 4456 4920 6f75 7470 7574 2075 ).* DVI output u │ │ │ │ │ +00043290: 7369 6e67 2054 6578 696e 666f 3a20 2020 sing Texinfo: │ │ │ │ │ +000432a0: 2020 2020 2020 2020 2020 2054 6578 696e Texin │ │ │ │ │ +000432b0: 666f 2e20 2020 2020 2020 2020 2020 2020 fo. │ │ │ │ │ +000432c0: 286c 696e 6520 2020 3629 0a2a 2064 7669 (line 6).* dvi │ │ │ │ │ +000432d0: 2d6c 6f63 616c 3a20 2020 2020 2020 2020 -local: │ │ │ │ │ 000432e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000432f0: 2020 2045 7874 656e 6469 6e67 2e20 2020 Extending. │ │ │ │ │ -00043300: 2020 2020 2020 2020 286c 696e 6520 2034 (line 4 │ │ │ │ │ -00043310: 3129 0a2a 2045 2d6d 6169 6c2c 2062 7567 1).* E-mail, bug │ │ │ │ │ -00043320: 2072 6570 6f72 7473 3a20 2020 2020 2020 reports: │ │ │ │ │ -00043330: 2020 2020 2020 2020 2020 2020 496e 7472 Intr │ │ │ │ │ -00043340: 6f64 7563 7469 6f6e 2e20 2020 2020 2020 oduction. │ │ │ │ │ -00043350: 2028 6c69 6e65 2020 3331 290a 2a20 4544 (line 31).* ED │ │ │ │ │ -00043360: 4954 494f 4e20 5465 7869 6e66 6f20 666c ITION Texinfo fl │ │ │ │ │ -00043370: 6167 3a20 2020 2020 2020 2020 2020 2020 ag: │ │ │ │ │ -00043380: 2020 2020 2054 6578 696e 666f 2e20 2020 Texinfo. │ │ │ │ │ -00043390: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -000433a0: 2032 3929 0a2a 2065 6c73 653a 2020 2020 29).* else: │ │ │ │ │ +000432f0: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ +00043300: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00043310: 3431 290a 2a20 452d 6d61 696c 2c20 6275 41).* E-mail, bu │ │ │ │ │ +00043320: 6720 7265 706f 7274 733a 2020 2020 2020 g reports: │ │ │ │ │ +00043330: 2020 2020 2020 2020 2020 2020 2049 6e74 Int │ │ │ │ │ +00043340: 726f 6475 6374 696f 6e2e 2020 2020 2020 roduction. │ │ │ │ │ +00043350: 2020 286c 696e 6520 2033 3129 0a2a 2045 (line 31).* E │ │ │ │ │ +00043360: 4449 5449 4f4e 2054 6578 696e 666f 2066 DITION Texinfo f │ │ │ │ │ +00043370: 6c61 673a 2020 2020 2020 2020 2020 2020 lag: │ │ │ │ │ +00043380: 2020 2020 2020 5465 7869 6e66 6f2e 2020 Texinfo. │ │ │ │ │ +00043390: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +000433a0: 2020 3239 290a 2a20 656c 7365 3a20 2020 29).* else: │ │ │ │ │ 000433b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000433c0: 2020 2020 2020 2020 2020 2020 2020 5573 Us │ │ │ │ │ -000433d0: 6167 6520 6f66 2043 6f6e 6469 7469 6f6e age of Condition │ │ │ │ │ -000433e0: 616c 732e 0a20 2020 2020 2020 2020 2020 als.. │ │ │ │ │ +000433c0: 2020 2020 2020 2020 2020 2020 2020 2055 U │ │ │ │ │ +000433d0: 7361 6765 206f 6620 436f 6e64 6974 696f sage of Conditio │ │ │ │ │ +000433e0: 6e61 6c73 2e0a 2020 2020 2020 2020 2020 nals.. │ │ │ │ │ 000433f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043420: 2020 2028 6c69 6e65 2020 3336 290a 2a20 (line 36).* │ │ │ │ │ -00043430: 456d 7074 7920 6c69 6272 6172 6965 733a Empty libraries: │ │ │ │ │ -00043440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043450: 2020 2020 2020 2041 204c 6962 7261 7279 A Library │ │ │ │ │ -00043460: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -00043470: 6520 2034 3829 0a2a 2045 6d70 7479 206c e 48).* Empty l │ │ │ │ │ -00043480: 6962 7261 7269 6573 2061 6e64 2024 284c ibraries and $(L │ │ │ │ │ -00043490: 4942 4f42 4a53 293a 2020 2020 2020 2020 IBOBJS): │ │ │ │ │ -000434a0: 4c49 424f 424a 532e 2020 2020 2020 2020 LIBOBJS. │ │ │ │ │ -000434b0: 2020 2020 2028 6c69 6e65 2020 3732 290a (line 72). │ │ │ │ │ -000434c0: 2a20 656d 7074 7920 5f53 4f55 5243 4553 * empty _SOURCES │ │ │ │ │ -000434d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000434e0: 2020 2020 2020 2020 2044 6566 6175 6c74 Default │ │ │ │ │ -000434f0: 205f 534f 5552 4345 532e 2020 2020 286c _SOURCES. (l │ │ │ │ │ -00043500: 696e 6520 2034 3429 0a2a 2065 6e64 6966 ine 44).* endif │ │ │ │ │ -00043510: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00043420: 2020 2020 286c 696e 6520 2033 3629 0a2a (line 36).* │ │ │ │ │ +00043430: 2045 6d70 7479 206c 6962 7261 7269 6573 Empty libraries │ │ │ │ │ +00043440: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00043450: 2020 2020 2020 2020 4120 4c69 6272 6172 A Librar │ │ │ │ │ +00043460: 792e 2020 2020 2020 2020 2020 2028 6c69 y. (li │ │ │ │ │ +00043470: 6e65 2020 3438 290a 2a20 456d 7074 7920 ne 48).* Empty │ │ │ │ │ +00043480: 6c69 6272 6172 6965 7320 616e 6420 2428 libraries and $( │ │ │ │ │ +00043490: 4c49 424f 424a 5329 3a20 2020 2020 2020 LIBOBJS): │ │ │ │ │ +000434a0: 204c 4942 4f42 4a53 2e20 2020 2020 2020 LIBOBJS. │ │ │ │ │ +000434b0: 2020 2020 2020 286c 696e 6520 2037 3229 (line 72) │ │ │ │ │ +000434c0: 0a2a 2065 6d70 7479 205f 534f 5552 4345 .* empty _SOURCE │ │ │ │ │ +000434d0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +000434e0: 2020 2020 2020 2020 2020 4465 6661 756c Defaul │ │ │ │ │ +000434f0: 7420 5f53 4f55 5243 4553 2e20 2020 2028 t _SOURCES. ( │ │ │ │ │ +00043500: 6c69 6e65 2020 3434 290a 2a20 656e 6469 line 44).* endi │ │ │ │ │ +00043510: 663a 2020 2020 2020 2020 2020 2020 2020 f: │ │ │ │ │ 00043520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043530: 2020 5573 6167 6520 6f66 2043 6f6e 6469 Usage of Condi │ │ │ │ │ -00043540: 7469 6f6e 616c 732e 0a20 2020 2020 2020 tionals.. │ │ │ │ │ +00043530: 2020 2055 7361 6765 206f 6620 436f 6e64 Usage of Cond │ │ │ │ │ +00043540: 6974 696f 6e61 6c73 2e0a 2020 2020 2020 itionals.. │ │ │ │ │ 00043550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043580: 2020 2020 2020 2028 6c69 6e65 2020 3336 (line 36 │ │ │ │ │ -00043590: 290a 2a20 4578 616d 706c 6520 636f 6e64 ).* Example cond │ │ │ │ │ -000435a0: 6974 696f 6e61 6c20 2d2d 656e 6162 6c65 itional --enable │ │ │ │ │ -000435b0: 2d64 6562 7567 3a20 2020 2055 7361 6765 -debug: Usage │ │ │ │ │ -000435c0: 206f 6620 436f 6e64 6974 696f 6e61 6c73 of Conditionals │ │ │ │ │ -000435d0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00043580: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ +00043590: 3629 0a2a 2045 7861 6d70 6c65 2063 6f6e 6).* Example con │ │ │ │ │ +000435a0: 6469 7469 6f6e 616c 202d 2d65 6e61 626c ditional --enabl │ │ │ │ │ +000435b0: 652d 6465 6275 673a 2020 2020 5573 6167 e-debug: Usag │ │ │ │ │ +000435c0: 6520 6f66 2043 6f6e 6469 7469 6f6e 616c e of Conditional │ │ │ │ │ +000435d0: 732e 0a20 2020 2020 2020 2020 2020 2020 s.. │ │ │ │ │ 000435e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000435f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043610: 286c 696e 6520 2032 3129 0a2a 2045 7861 (line 21).* Exa │ │ │ │ │ -00043620: 6d70 6c65 2063 6f6e 6469 7469 6f6e 616c mple conditional │ │ │ │ │ -00043630: 2041 435f 434f 4e46 4947 5f46 494c 4553 AC_CONFIG_FILES │ │ │ │ │ -00043640: 3a20 2020 5573 6167 6520 6f66 2043 6f6e : Usage of Con │ │ │ │ │ -00043650: 6469 7469 6f6e 616c 732e 0a20 2020 2020 ditionals.. │ │ │ │ │ +00043610: 2028 6c69 6e65 2020 3231 290a 2a20 4578 (line 21).* Ex │ │ │ │ │ +00043620: 616d 706c 6520 636f 6e64 6974 696f 6e61 ample conditiona │ │ │ │ │ +00043630: 6c20 4143 5f43 4f4e 4649 475f 4649 4c45 l AC_CONFIG_FILE │ │ │ │ │ +00043640: 533a 2020 2055 7361 6765 206f 6620 436f S: Usage of Co │ │ │ │ │ +00043650: 6e64 6974 696f 6e61 6c73 2e0a 2020 2020 nditionals.. │ │ │ │ │ 00043660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043690: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000436a0: 3739 290a 2a20 4578 616d 706c 6520 4865 79).* Example He │ │ │ │ │ -000436b0: 6c6c 6f20 576f 726c 643a 2020 2020 2020 llo World: │ │ │ │ │ -000436c0: 2020 2020 2020 2020 2020 2020 2048 656c Hel │ │ │ │ │ -000436d0: 6c6f 2057 6f72 6c64 2e20 2020 2020 2020 lo World. │ │ │ │ │ -000436e0: 2020 286c 696e 6520 2020 3629 0a2a 2045 (line 6).* E │ │ │ │ │ -000436f0: 7861 6d70 6c65 206f 6620 7265 6375 7273 xample of recurs │ │ │ │ │ -00043700: 6976 6520 6f70 6572 6174 696f 6e3a 2020 ive operation: │ │ │ │ │ -00043710: 2020 2020 2020 4765 6e65 7261 6c20 4f70 General Op │ │ │ │ │ -00043720: 6572 6174 696f 6e2e 2020 2028 6c69 6e65 eration. (line │ │ │ │ │ -00043730: 2020 3538 290a 2a20 4578 616d 706c 6520 58).* Example │ │ │ │ │ -00043740: 6f66 2073 6861 7265 6420 6c69 6272 6172 of shared librar │ │ │ │ │ -00043750: 6965 733a 2020 2020 2020 2020 2020 204c ies: L │ │ │ │ │ -00043760: 6962 746f 6f6c 204c 6962 7261 7269 6573 ibtool Libraries │ │ │ │ │ -00043770: 2e20 2020 286c 696e 6520 2020 3629 0a2a . (line 6).* │ │ │ │ │ -00043780: 2045 7861 6d70 6c65 2c20 4558 5452 415f Example, EXTRA_ │ │ │ │ │ -00043790: 5052 4f47 5241 4d53 3a20 2020 2020 2020 PROGRAMS: │ │ │ │ │ -000437a0: 2020 2020 2020 2020 556e 6966 6f72 6d2e Uniform. │ │ │ │ │ -000437b0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000437c0: 6e65 2020 3336 290a 2a20 4578 616d 706c ne 36).* Exampl │ │ │ │ │ -000437d0: 652c 2066 616c 7365 2061 6e64 2074 7275 e, false and tru │ │ │ │ │ -000437e0: 653a 2020 2020 2020 2020 2020 2020 2020 e: │ │ │ │ │ -000437f0: 2074 7275 652e 2020 2020 2020 2020 2020 true. │ │ │ │ │ -00043800: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00043810: 0a2a 2045 7861 6d70 6c65 2c20 6d69 7865 .* Example, mixe │ │ │ │ │ -00043820: 6420 6c61 6e67 7561 6765 3a20 2020 2020 d language: │ │ │ │ │ -00043830: 2020 2020 2020 2020 2020 4d69 7869 6e67 Mixing │ │ │ │ │ -00043840: 2046 6f72 7472 616e 2037 3720 5769 7468 Fortran 77 With │ │ │ │ │ -00043850: 2043 2061 6e64 2043 2b2b 2e0a 2020 2020 C and C++.. │ │ │ │ │ +00043690: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000436a0: 2037 3929 0a2a 2045 7861 6d70 6c65 2048 79).* Example H │ │ │ │ │ +000436b0: 656c 6c6f 2057 6f72 6c64 3a20 2020 2020 ello World: │ │ │ │ │ +000436c0: 2020 2020 2020 2020 2020 2020 2020 4865 He │ │ │ │ │ +000436d0: 6c6c 6f20 576f 726c 642e 2020 2020 2020 llo World. │ │ │ │ │ +000436e0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +000436f0: 4578 616d 706c 6520 6f66 2072 6563 7572 Example of recur │ │ │ │ │ +00043700: 7369 7665 206f 7065 7261 7469 6f6e 3a20 sive operation: │ │ │ │ │ +00043710: 2020 2020 2020 2047 656e 6572 616c 204f General O │ │ │ │ │ +00043720: 7065 7261 7469 6f6e 2e20 2020 286c 696e peration. (lin │ │ │ │ │ +00043730: 6520 2035 3829 0a2a 2045 7861 6d70 6c65 e 58).* Example │ │ │ │ │ +00043740: 206f 6620 7368 6172 6564 206c 6962 7261 of shared libra │ │ │ │ │ +00043750: 7269 6573 3a20 2020 2020 2020 2020 2020 ries: │ │ │ │ │ +00043760: 4c69 6274 6f6f 6c20 4c69 6272 6172 6965 Libtool Librarie │ │ │ │ │ +00043770: 732e 2020 2028 6c69 6e65 2020 2036 290a s. (line 6). │ │ │ │ │ +00043780: 2a20 4578 616d 706c 652c 2045 5854 5241 * Example, EXTRA │ │ │ │ │ +00043790: 5f50 524f 4752 414d 533a 2020 2020 2020 _PROGRAMS: │ │ │ │ │ +000437a0: 2020 2020 2020 2020 2055 6e69 666f 726d Uniform │ │ │ │ │ +000437b0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +000437c0: 696e 6520 2033 3629 0a2a 2045 7861 6d70 ine 36).* Examp │ │ │ │ │ +000437d0: 6c65 2c20 6661 6c73 6520 616e 6420 7472 le, false and tr │ │ │ │ │ +000437e0: 7565 3a20 2020 2020 2020 2020 2020 2020 ue: │ │ │ │ │ +000437f0: 2020 7472 7565 2e20 2020 2020 2020 2020 true. │ │ │ │ │ +00043800: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00043810: 290a 2a20 4578 616d 706c 652c 206d 6978 ).* Example, mix │ │ │ │ │ +00043820: 6564 206c 616e 6775 6167 653a 2020 2020 ed language: │ │ │ │ │ +00043830: 2020 2020 2020 2020 2020 204d 6978 696e Mixin │ │ │ │ │ +00043840: 6720 466f 7274 7261 6e20 3737 2057 6974 g Fortran 77 Wit │ │ │ │ │ +00043850: 6820 4320 616e 6420 432b 2b2e 0a20 2020 h C and C++.. │ │ │ │ │ 00043860: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043890: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -000438a0: 2033 3629 0a2a 2045 7865 6375 7461 626c 36).* Executabl │ │ │ │ │ -000438b0: 6520 6578 7465 6e73 696f 6e3a 2020 2020 e extension: │ │ │ │ │ -000438c0: 2020 2020 2020 2020 2020 2020 2020 4558 EX │ │ │ │ │ -000438d0: 4545 5854 2e20 2020 2020 2020 2020 2020 EEXT. │ │ │ │ │ -000438e0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -000438f0: 4578 6974 2073 7461 7475 7320 3737 2c20 Exit status 77, │ │ │ │ │ -00043900: 7370 6563 6961 6c20 696e 7465 7270 7265 special interpre │ │ │ │ │ -00043910: 7461 7469 6f6e 3a20 5369 6d70 6c65 2054 tation: Simple T │ │ │ │ │ -00043920: 6573 7473 2e20 2020 2020 2020 286c 696e ests. (lin │ │ │ │ │ -00043930: 6520 2032 3029 0a2a 2045 7869 7420 7374 e 20).* Exit st │ │ │ │ │ -00043940: 6174 7573 2039 392c 2073 7065 6369 616c atus 99, special │ │ │ │ │ -00043950: 2069 6e74 6572 7072 6574 6174 696f 6e3a interpretation: │ │ │ │ │ -00043960: 2053 696d 706c 6520 5465 7374 7320 7573 Simple Tests us │ │ │ │ │ -00043970: 696e 6720 7061 7261 6c6c 656c 2d74 6573 ing parallel-tes │ │ │ │ │ -00043980: 7473 2e0a 2020 2020 2020 2020 2020 2020 ts.. │ │ │ │ │ +00043890: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +000438a0: 2020 3336 290a 2a20 4578 6563 7574 6162 36).* Executab │ │ │ │ │ +000438b0: 6c65 2065 7874 656e 7369 6f6e 3a20 2020 le extension: │ │ │ │ │ +000438c0: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +000438d0: 5845 4558 542e 2020 2020 2020 2020 2020 XEEXT. │ │ │ │ │ +000438e0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +000438f0: 2045 7869 7420 7374 6174 7573 2037 372c Exit status 77, │ │ │ │ │ +00043900: 2073 7065 6369 616c 2069 6e74 6572 7072 special interpr │ │ │ │ │ +00043910: 6574 6174 696f 6e3a 2053 696d 706c 6520 etation: Simple │ │ │ │ │ +00043920: 5465 7374 732e 2020 2020 2020 2028 6c69 Tests. (li │ │ │ │ │ +00043930: 6e65 2020 3230 290a 2a20 4578 6974 2073 ne 20).* Exit s │ │ │ │ │ +00043940: 7461 7475 7320 3939 2c20 7370 6563 6961 tatus 99, specia │ │ │ │ │ +00043950: 6c20 696e 7465 7270 7265 7461 7469 6f6e l interpretation │ │ │ │ │ +00043960: 3a20 5369 6d70 6c65 2054 6573 7473 2075 : Simple Tests u │ │ │ │ │ +00043970: 7369 6e67 2070 6172 616c 6c65 6c2d 7465 sing parallel-te │ │ │ │ │ +00043980: 7374 732e 0a20 2020 2020 2020 2020 2020 sts.. │ │ │ │ │ 00043990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000439a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000439b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000439c0: 2020 286c 696e 6520 2037 3529 0a2a 2045 (line 75).* E │ │ │ │ │ -000439d0: 7870 6563 7465 6420 7465 7374 2066 6169 xpected test fai │ │ │ │ │ -000439e0: 6c75 7265 3a20 2020 2020 2020 2020 2020 lure: │ │ │ │ │ -000439f0: 2020 2020 2020 5369 6d70 6c65 2054 6573 Simple Tes │ │ │ │ │ -00043a00: 7473 2e20 2020 2020 2020 2028 6c69 6e65 ts. (line │ │ │ │ │ -00043a10: 2020 3531 290a 2a20 4578 7465 6e64 696e 51).* Extendin │ │ │ │ │ -00043a20: 6720 6163 6c6f 6361 6c3a 2020 2020 2020 g aclocal: │ │ │ │ │ -00043a30: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ -00043a40: 7874 656e 6469 6e67 2061 636c 6f63 616c xtending aclocal │ │ │ │ │ -00043a50: 2e20 2020 286c 696e 6520 2020 3629 0a2a . (line 6).* │ │ │ │ │ -00043a60: 2045 7874 656e 6469 6e67 206c 6973 7420 Extending list │ │ │ │ │ -00043a70: 6f66 2069 6e73 7461 6c6c 6174 696f 6e20 of installation │ │ │ │ │ -00043a80: 6469 7265 6374 6f72 6965 733a 2055 6e69 directories: Uni │ │ │ │ │ -00043a90: 666f 726d 2e20 2020 2020 2020 2028 6c69 form. (li │ │ │ │ │ -00043aa0: 6e65 2020 3536 290a 2a20 4578 7465 6e73 ne 56).* Extens │ │ │ │ │ -00043ab0: 696f 6e2c 2065 7865 6375 7461 626c 653a ion, executable: │ │ │ │ │ -00043ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043ad0: 2045 5845 4558 542e 2020 2020 2020 2020 EXEEXT. │ │ │ │ │ -00043ae0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00043af0: 0a2a 2045 7874 7261 2066 696c 6573 2064 .* Extra files d │ │ │ │ │ -00043b00: 6973 7472 6962 7574 6564 2077 6974 6820 istributed with │ │ │ │ │ -00043b10: 4175 746f 6d61 6b65 3a20 6175 746f 6d61 Automake: automa │ │ │ │ │ -00043b20: 6b65 2049 6e76 6f63 6174 696f 6e2e 2028 ke Invocation. ( │ │ │ │ │ -00043b30: 6c69 6e65 2020 3339 290a 2a20 4558 5452 line 39).* EXTR │ │ │ │ │ -00043b40: 415f 2c20 7072 6570 656e 6469 6e67 3a20 A_, prepending: │ │ │ │ │ +000439c0: 2020 2028 6c69 6e65 2020 3735 290a 2a20 (line 75).* │ │ │ │ │ +000439d0: 4578 7065 6374 6564 2074 6573 7420 6661 Expected test fa │ │ │ │ │ +000439e0: 696c 7572 653a 2020 2020 2020 2020 2020 ilure: │ │ │ │ │ +000439f0: 2020 2020 2020 2053 696d 706c 6520 5465 Simple Te │ │ │ │ │ +00043a00: 7374 732e 2020 2020 2020 2020 286c 696e sts. (lin │ │ │ │ │ +00043a10: 6520 2035 3129 0a2a 2045 7874 656e 6469 e 51).* Extendi │ │ │ │ │ +00043a20: 6e67 2061 636c 6f63 616c 3a20 2020 2020 ng aclocal: │ │ │ │ │ +00043a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00043a40: 4578 7465 6e64 696e 6720 6163 6c6f 6361 Extending acloca │ │ │ │ │ +00043a50: 6c2e 2020 2028 6c69 6e65 2020 2036 290a l. (line 6). │ │ │ │ │ +00043a60: 2a20 4578 7465 6e64 696e 6720 6c69 7374 * Extending list │ │ │ │ │ +00043a70: 206f 6620 696e 7374 616c 6c61 7469 6f6e of installation │ │ │ │ │ +00043a80: 2064 6972 6563 746f 7269 6573 3a20 556e directories: Un │ │ │ │ │ +00043a90: 6966 6f72 6d2e 2020 2020 2020 2020 286c iform. (l │ │ │ │ │ +00043aa0: 696e 6520 2035 3629 0a2a 2045 7874 656e ine 56).* Exten │ │ │ │ │ +00043ab0: 7369 6f6e 2c20 6578 6563 7574 6162 6c65 sion, executable │ │ │ │ │ +00043ac0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00043ad0: 2020 4558 4545 5854 2e20 2020 2020 2020 EXEEXT. │ │ │ │ │ +00043ae0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00043af0: 290a 2a20 4578 7472 6120 6669 6c65 7320 ).* Extra files │ │ │ │ │ +00043b00: 6469 7374 7269 6275 7465 6420 7769 7468 distributed with │ │ │ │ │ +00043b10: 2041 7574 6f6d 616b 653a 2061 7574 6f6d Automake: autom │ │ │ │ │ +00043b20: 616b 6520 496e 766f 6361 7469 6f6e 2e20 ake Invocation. │ │ │ │ │ +00043b30: 286c 696e 6520 2033 3929 0a2a 2045 5854 (line 39).* EXT │ │ │ │ │ +00043b40: 5241 5f2c 2070 7265 7065 6e64 696e 673a RA_, prepending: │ │ │ │ │ 00043b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043b60: 2020 2055 6e69 666f 726d 2e20 2020 2020 Uniform. │ │ │ │ │ -00043b70: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ -00043b80: 3929 0a2a 2045 5854 5241 5f50 524f 4752 9).* EXTRA_PROGR │ │ │ │ │ -00043b90: 414d 532c 2064 6566 696e 6564 3a20 2020 AMS, defined: │ │ │ │ │ -00043ba0: 2020 2020 2020 2020 2020 2020 556e 6966 Unif │ │ │ │ │ -00043bb0: 6f72 6d2e 2020 2020 2020 2020 2020 2020 orm. │ │ │ │ │ -00043bc0: 2028 6c69 6e65 2020 3336 290a 2a20 4558 (line 36).* EX │ │ │ │ │ -00043bd0: 5452 415f 5052 4f47 5241 4d53 2c20 6465 TRA_PROGRAMS, de │ │ │ │ │ -00043be0: 6669 6e65 6420 3c31 3e3a 2020 2020 2020 fined <1>: │ │ │ │ │ -00043bf0: 2020 2020 2043 6f6e 6469 7469 6f6e 616c Conditional │ │ │ │ │ -00043c00: 2050 726f 6772 616d 732e 0a20 2020 2020 Programs.. │ │ │ │ │ +00043b60: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ +00043b70: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00043b80: 3239 290a 2a20 4558 5452 415f 5052 4f47 29).* EXTRA_PROG │ │ │ │ │ +00043b90: 5241 4d53 2c20 6465 6669 6e65 643a 2020 RAMS, defined: │ │ │ │ │ +00043ba0: 2020 2020 2020 2020 2020 2020 2055 6e69 Uni │ │ │ │ │ +00043bb0: 666f 726d 2e20 2020 2020 2020 2020 2020 form. │ │ │ │ │ +00043bc0: 2020 286c 696e 6520 2033 3629 0a2a 2045 (line 36).* E │ │ │ │ │ +00043bd0: 5854 5241 5f50 524f 4752 414d 532c 2064 XTRA_PROGRAMS, d │ │ │ │ │ +00043be0: 6566 696e 6564 203c 313e 3a20 2020 2020 efined <1>: │ │ │ │ │ +00043bf0: 2020 2020 2020 436f 6e64 6974 696f 6e61 Conditiona │ │ │ │ │ +00043c00: 6c20 5072 6f67 7261 6d73 2e0a 2020 2020 l Programs.. │ │ │ │ │ 00043c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043c30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043c40: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00043c50: 3135 290a 2a20 4558 5452 415f 7072 6f67 15).* EXTRA_prog │ │ │ │ │ -00043c60: 5f53 4f55 5243 4553 2c20 6465 6669 6e65 _SOURCES, define │ │ │ │ │ -00043c70: 643a 2020 2020 2020 2020 2020 2043 6f6e d: Con │ │ │ │ │ -00043c80: 6469 7469 6f6e 616c 2053 6f75 7263 6573 ditional Sources │ │ │ │ │ -00043c90: 2e20 286c 696e 6520 2031 3829 0a2a 2066 . (line 18).* f │ │ │ │ │ -00043ca0: 616c 7365 2045 7861 6d70 6c65 3a20 2020 alse Example: │ │ │ │ │ +00043c40: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00043c50: 2031 3529 0a2a 2045 5854 5241 5f70 726f 15).* EXTRA_pro │ │ │ │ │ +00043c60: 675f 534f 5552 4345 532c 2064 6566 696e g_SOURCES, defin │ │ │ │ │ +00043c70: 6564 3a20 2020 2020 2020 2020 2020 436f ed: Co │ │ │ │ │ +00043c80: 6e64 6974 696f 6e61 6c20 536f 7572 6365 nditional Source │ │ │ │ │ +00043c90: 732e 2028 6c69 6e65 2020 3138 290a 2a20 s. (line 18).* │ │ │ │ │ +00043ca0: 6661 6c73 6520 4578 616d 706c 653a 2020 false Example: │ │ │ │ │ 00043cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043cc0: 2020 2020 2020 7472 7565 2e20 2020 2020 true. │ │ │ │ │ -00043cd0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00043ce0: 2020 2036 290a 2a20 4643 464c 4147 5320 6).* FCFLAGS │ │ │ │ │ -00043cf0: 616e 6420 414d 5f46 4346 4c41 4753 3a20 and AM_FCFLAGS: │ │ │ │ │ -00043d00: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ -00043d10: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ -00043d20: 6465 7269 6e67 2e0a 2020 2020 2020 2020 dering.. │ │ │ │ │ +00043cc0: 2020 2020 2020 2074 7275 652e 2020 2020 true. │ │ │ │ │ +00043cd0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00043ce0: 6520 2020 3629 0a2a 2046 4346 4c41 4753 e 6).* FCFLAGS │ │ │ │ │ +00043cf0: 2061 6e64 2041 4d5f 4643 464c 4147 533a and AM_FCFLAGS: │ │ │ │ │ +00043d00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00043d10: 466c 6167 2056 6172 6961 626c 6573 204f Flag Variables O │ │ │ │ │ +00043d20: 7264 6572 696e 672e 0a20 2020 2020 2020 rdering.. │ │ │ │ │ 00043d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043d50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043d60: 2020 2020 2020 286c 696e 6520 2032 3029 (line 20) │ │ │ │ │ -00043d70: 0a2a 2046 6561 7475 7265 7320 6f66 2074 .* Features of t │ │ │ │ │ -00043d80: 6865 2047 4e55 2042 7569 6c64 2053 7973 he GNU Build Sys │ │ │ │ │ -00043d90: 7465 6d3a 2020 2020 2020 5573 6520 4361 tem: Use Ca │ │ │ │ │ -00043da0: 7365 732e 2020 2020 2020 2020 2020 2028 ses. ( │ │ │ │ │ -00043db0: 6c69 6e65 2020 2036 290a 2a20 4646 4c41 line 6).* FFLA │ │ │ │ │ -00043dc0: 4753 2061 6e64 2041 4d5f 4646 4c41 4753 GS and AM_FFLAGS │ │ │ │ │ -00043dd0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00043de0: 2020 2046 6c61 6720 5661 7269 6162 6c65 Flag Variable │ │ │ │ │ -00043df0: 7320 4f72 6465 7269 6e67 2e0a 2020 2020 s Ordering.. │ │ │ │ │ +00043d60: 2020 2020 2020 2028 6c69 6e65 2020 3230 (line 20 │ │ │ │ │ +00043d70: 290a 2a20 4665 6174 7572 6573 206f 6620 ).* Features of │ │ │ │ │ +00043d80: 7468 6520 474e 5520 4275 696c 6420 5379 the GNU Build Sy │ │ │ │ │ +00043d90: 7374 656d 3a20 2020 2020 2055 7365 2043 stem: Use C │ │ │ │ │ +00043da0: 6173 6573 2e20 2020 2020 2020 2020 2020 ases. │ │ │ │ │ +00043db0: 286c 696e 6520 2020 3629 0a2a 2046 464c (line 6).* FFL │ │ │ │ │ +00043dc0: 4147 5320 616e 6420 414d 5f46 464c 4147 AGS and AM_FFLAG │ │ │ │ │ +00043dd0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ +00043de0: 2020 2020 466c 6167 2056 6172 6961 626c Flag Variabl │ │ │ │ │ +00043df0: 6573 204f 7264 6572 696e 672e 0a20 2020 es Ordering.. │ │ │ │ │ 00043e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043e30: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00043e40: 2032 3029 0a2a 2066 696c 6520 6e61 6d65 20).* file name │ │ │ │ │ -00043e50: 732c 206c 696d 6974 6174 696f 6e73 206f s, limitations o │ │ │ │ │ -00043e60: 6e3a 2020 2020 2020 2020 2020 2020 4c69 n: Li │ │ │ │ │ -00043e70: 6d69 7461 7469 6f6e 7320 6f6e 2046 696c mitations on Fil │ │ │ │ │ -00043e80: 6520 4e61 6d65 732e 0a20 2020 2020 2020 e Names.. │ │ │ │ │ +00043e30: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00043e40: 2020 3230 290a 2a20 6669 6c65 206e 616d 20).* file nam │ │ │ │ │ +00043e50: 6573 2c20 6c69 6d69 7461 7469 6f6e 7320 es, limitations │ │ │ │ │ +00043e60: 6f6e 3a20 2020 2020 2020 2020 2020 204c on: L │ │ │ │ │ +00043e70: 696d 6974 6174 696f 6e73 206f 6e20 4669 imitations on Fi │ │ │ │ │ +00043e80: 6c65 204e 616d 6573 2e0a 2020 2020 2020 le Names.. │ │ │ │ │ 00043e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00043eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00043ec0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00043ed0: 290a 2a20 6669 6c65 6e61 6d65 2d6c 656e ).* filename-len │ │ │ │ │ -00043ee0: 6774 682d 6d61 783d 3939 3a20 2020 2020 gth-max=99: │ │ │ │ │ -00043ef0: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00043f00: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00043f10: 286c 696e 6520 2036 3929 0a2a 2046 696c (line 69).* Fil │ │ │ │ │ -00043f20: 6573 2064 6973 7472 6962 7574 6564 2077 es distributed w │ │ │ │ │ -00043f30: 6974 6820 4175 746f 6d61 6b65 3a20 2020 ith Automake: │ │ │ │ │ -00043f40: 2020 2020 6175 746f 6d61 6b65 2049 6e76 automake Inv │ │ │ │ │ -00043f50: 6f63 6174 696f 6e2e 2028 6c69 6e65 2020 ocation. (line │ │ │ │ │ -00043f60: 3339 290a 2a20 4669 7273 7420 6c69 6e65 39).* First line │ │ │ │ │ -00043f70: 206f 6620 4d61 6b65 6669 6c65 2e61 6d3a of Makefile.am: │ │ │ │ │ -00043f80: 2020 2020 2020 2020 2020 2020 2047 656e Gen │ │ │ │ │ -00043f90: 6572 616c 204f 7065 7261 7469 6f6e 2e20 eral Operation. │ │ │ │ │ -00043fa0: 2020 286c 696e 6520 2037 3429 0a2a 2046 (line 74).* F │ │ │ │ │ -00043fb0: 6c61 6720 7661 7269 6162 6c65 732c 206f lag variables, o │ │ │ │ │ -00043fc0: 7264 6572 696e 673a 2020 2020 2020 2020 rdering: │ │ │ │ │ -00043fd0: 2020 2020 2020 466c 6167 2056 6172 6961 Flag Varia │ │ │ │ │ -00043fe0: 626c 6573 204f 7264 6572 696e 672e 0a20 bles Ordering.. │ │ │ │ │ +00043ec0: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00043ed0: 3629 0a2a 2066 696c 656e 616d 652d 6c65 6).* filename-le │ │ │ │ │ +00043ee0: 6e67 7468 2d6d 6178 3d39 393a 2020 2020 ngth-max=99: │ │ │ │ │ +00043ef0: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00043f00: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00043f10: 2028 6c69 6e65 2020 3639 290a 2a20 4669 (line 69).* Fi │ │ │ │ │ +00043f20: 6c65 7320 6469 7374 7269 6275 7465 6420 les distributed │ │ │ │ │ +00043f30: 7769 7468 2041 7574 6f6d 616b 653a 2020 with Automake: │ │ │ │ │ +00043f40: 2020 2020 2061 7574 6f6d 616b 6520 496e automake In │ │ │ │ │ +00043f50: 766f 6361 7469 6f6e 2e20 286c 696e 6520 vocation. (line │ │ │ │ │ +00043f60: 2033 3929 0a2a 2046 6972 7374 206c 696e 39).* First lin │ │ │ │ │ +00043f70: 6520 6f66 204d 616b 6566 696c 652e 616d e of Makefile.am │ │ │ │ │ +00043f80: 3a20 2020 2020 2020 2020 2020 2020 4765 : Ge │ │ │ │ │ +00043f90: 6e65 7261 6c20 4f70 6572 6174 696f 6e2e neral Operation. │ │ │ │ │ +00043fa0: 2020 2028 6c69 6e65 2020 3734 290a 2a20 (line 74).* │ │ │ │ │ +00043fb0: 466c 6167 2076 6172 6961 626c 6573 2c20 Flag variables, │ │ │ │ │ +00043fc0: 6f72 6465 7269 6e67 3a20 2020 2020 2020 ordering: │ │ │ │ │ +00043fd0: 2020 2020 2020 2046 6c61 6720 5661 7269 Flag Vari │ │ │ │ │ +00043fe0: 6162 6c65 7320 4f72 6465 7269 6e67 2e0a ables Ordering.. │ │ │ │ │ 00043ff0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044020: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00044030: 6e65 2020 2036 290a 2a20 466c 6167 2056 ne 6).* Flag V │ │ │ │ │ -00044040: 6172 6961 626c 6573 2c20 4f72 6465 7269 ariables, Orderi │ │ │ │ │ -00044050: 6e67 3a20 2020 2020 2020 2020 2020 2020 ng: │ │ │ │ │ -00044060: 2046 6c61 6720 5661 7269 6162 6c65 7320 Flag Variables │ │ │ │ │ -00044070: 4f72 6465 7269 6e67 2e0a 2020 2020 2020 Ordering.. │ │ │ │ │ +00044020: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00044030: 696e 6520 2020 3629 0a2a 2046 6c61 6720 ine 6).* Flag │ │ │ │ │ +00044040: 5661 7269 6162 6c65 732c 204f 7264 6572 Variables, Order │ │ │ │ │ +00044050: 696e 673a 2020 2020 2020 2020 2020 2020 ing: │ │ │ │ │ +00044060: 2020 466c 6167 2056 6172 6961 626c 6573 Flag Variables │ │ │ │ │ +00044070: 204f 7264 6572 696e 672e 0a20 2020 2020 Ordering.. │ │ │ │ │ 00044080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044090: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000440a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000440b0: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ -000440c0: 3029 0a2a 2046 4c49 4253 2c20 6465 6669 0).* FLIBS, defi │ │ │ │ │ -000440d0: 6e65 643a 2020 2020 2020 2020 2020 2020 ned: │ │ │ │ │ -000440e0: 2020 2020 2020 2020 2020 2020 4d69 7869 Mixi │ │ │ │ │ -000440f0: 6e67 2046 6f72 7472 616e 2037 3720 5769 ng Fortran 77 Wi │ │ │ │ │ -00044100: 7468 2043 2061 6e64 2043 2b2b 2e0a 2020 th C and C++.. │ │ │ │ │ +000440b0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +000440c0: 3230 290a 2a20 464c 4942 532c 2064 6566 20).* FLIBS, def │ │ │ │ │ +000440d0: 696e 6564 3a20 2020 2020 2020 2020 2020 ined: │ │ │ │ │ +000440e0: 2020 2020 2020 2020 2020 2020 204d 6978 Mix │ │ │ │ │ +000440f0: 696e 6720 466f 7274 7261 6e20 3737 2057 ing Fortran 77 W │ │ │ │ │ +00044100: 6974 6820 4320 616e 6420 432b 2b2e 0a20 ith C and C++.. │ │ │ │ │ 00044110: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044140: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00044150: 6520 2032 3129 0a2a 2066 6f72 6569 676e e 21).* foreign │ │ │ │ │ -00044160: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00044140: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00044150: 6e65 2020 3231 290a 2a20 666f 7265 6967 ne 21).* foreig │ │ │ │ │ +00044160: 6e3a 2020 2020 2020 2020 2020 2020 2020 n: │ │ │ │ │ 00044170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044180: 616d 6865 6c6c 6f27 7320 636f 6e66 6967 amhello's config │ │ │ │ │ -00044190: 7572 652e 6163 2053 6574 7570 2045 7870 ure.ac Setup Exp │ │ │ │ │ -000441a0: 6c61 696e 6564 2e0a 2020 2020 2020 2020 lained.. │ │ │ │ │ +00044180: 2061 6d68 656c 6c6f 2773 2063 6f6e 6669 amhello's confi │ │ │ │ │ +00044190: 6775 7265 2e61 6320 5365 7475 7020 4578 gure.ac Setup Ex │ │ │ │ │ +000441a0: 706c 6169 6e65 642e 0a20 2020 2020 2020 plained.. │ │ │ │ │ 000441b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000441c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000441d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000441e0: 2020 2020 2020 286c 696e 6520 2033 3829 (line 38) │ │ │ │ │ -000441f0: 0a2a 2066 6f72 6569 676e 203c 313e 3a20 .* foreign <1>: │ │ │ │ │ +000441e0: 2020 2020 2020 2028 6c69 6e65 2020 3338 (line 38 │ │ │ │ │ +000441f0: 290a 2a20 666f 7265 6967 6e20 3c31 3e3a ).* foreign <1>: │ │ │ │ │ 00044200: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044210: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ -00044220: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -00044230: 6c69 6e65 2020 3233 290a 2a20 666f 7265 line 23).* fore │ │ │ │ │ -00044240: 6967 6e20 7374 7269 6374 6e65 7373 3a20 ign strictness: │ │ │ │ │ +00044210: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ +00044220: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ +00044230: 286c 696e 6520 2032 3329 0a2a 2066 6f72 (line 23).* for │ │ │ │ │ +00044240: 6569 676e 2073 7472 6963 746e 6573 733a eign strictness: │ │ │ │ │ 00044250: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044260: 2020 2053 7472 6963 746e 6573 732e 2020 Strictness. │ │ │ │ │ -00044270: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -00044280: 3029 0a2a 2046 6f72 7472 616e 2037 3720 0).* Fortran 77 │ │ │ │ │ -00044290: 7375 7070 6f72 743a 2020 2020 2020 2020 support: │ │ │ │ │ -000442a0: 2020 2020 2020 2020 2020 2020 466f 7274 Fort │ │ │ │ │ -000442b0: 7261 6e20 3737 2053 7570 706f 7274 2e20 ran 77 Support. │ │ │ │ │ -000442c0: 2028 6c69 6e65 2020 2036 290a 2a20 466f (line 6).* Fo │ │ │ │ │ -000442d0: 7274 7261 6e20 3737 2c20 6d69 7869 6e67 rtran 77, mixing │ │ │ │ │ -000442e0: 2077 6974 6820 4320 616e 6420 432b 2b3a with C and C++: │ │ │ │ │ -000442f0: 2020 2020 204d 6978 696e 6720 466f 7274 Mixing Fort │ │ │ │ │ -00044300: 7261 6e20 3737 2057 6974 6820 4320 616e ran 77 With C an │ │ │ │ │ -00044310: 6420 432b 2b2e 0a20 2020 2020 2020 2020 d C++.. │ │ │ │ │ +00044260: 2020 2020 5374 7269 6374 6e65 7373 2e20 Strictness. │ │ │ │ │ +00044270: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00044280: 3130 290a 2a20 466f 7274 7261 6e20 3737 10).* Fortran 77 │ │ │ │ │ +00044290: 2073 7570 706f 7274 3a20 2020 2020 2020 support: │ │ │ │ │ +000442a0: 2020 2020 2020 2020 2020 2020 2046 6f72 For │ │ │ │ │ +000442b0: 7472 616e 2037 3720 5375 7070 6f72 742e tran 77 Support. │ │ │ │ │ +000442c0: 2020 286c 696e 6520 2020 3629 0a2a 2046 (line 6).* F │ │ │ │ │ +000442d0: 6f72 7472 616e 2037 372c 206d 6978 696e ortran 77, mixin │ │ │ │ │ +000442e0: 6720 7769 7468 2043 2061 6e64 2043 2b2b g with C and C++ │ │ │ │ │ +000442f0: 3a20 2020 2020 4d69 7869 6e67 2046 6f72 : Mixing For │ │ │ │ │ +00044300: 7472 616e 2037 3720 5769 7468 2043 2061 tran 77 With C a │ │ │ │ │ +00044310: 6e64 2043 2b2b 2e0a 2020 2020 2020 2020 nd C++.. │ │ │ │ │ 00044320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044350: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -00044360: 2a20 466f 7274 7261 6e20 3737 2c20 5072 * Fortran 77, Pr │ │ │ │ │ -00044370: 6570 726f 6365 7373 696e 673a 2020 2020 eprocessing: │ │ │ │ │ -00044380: 2020 2020 2020 2020 2050 7265 7072 6f63 Preproc │ │ │ │ │ -00044390: 6573 7369 6e67 2046 6f72 7472 616e 2037 essing Fortran 7 │ │ │ │ │ -000443a0: 372e 0a20 2020 2020 2020 2020 2020 2020 7.. │ │ │ │ │ +00044350: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +00044360: 0a2a 2046 6f72 7472 616e 2037 372c 2050 .* Fortran 77, P │ │ │ │ │ +00044370: 7265 7072 6f63 6573 7369 6e67 3a20 2020 reprocessing: │ │ │ │ │ +00044380: 2020 2020 2020 2020 2020 5072 6570 726f Prepro │ │ │ │ │ +00044390: 6365 7373 696e 6720 466f 7274 7261 6e20 cessing Fortran │ │ │ │ │ +000443a0: 3737 2e0a 2020 2020 2020 2020 2020 2020 77.. │ │ │ │ │ 000443b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000443c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000443d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000443e0: 2028 6c69 6e65 2020 2036 290a 2a20 466f (line 6).* Fo │ │ │ │ │ -000443f0: 7274 7261 6e20 3978 2073 7570 706f 7274 rtran 9x support │ │ │ │ │ -00044400: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00044410: 2020 2020 2046 6f72 7472 616e 2039 7820 Fortran 9x │ │ │ │ │ -00044420: 5375 7070 6f72 742e 2020 286c 696e 6520 Support. (line │ │ │ │ │ -00044430: 2020 3629 0a2a 2047 434a 464c 4147 5320 6).* GCJFLAGS │ │ │ │ │ -00044440: 616e 6420 414d 5f47 434a 464c 4147 533a and AM_GCJFLAGS: │ │ │ │ │ -00044450: 2020 2020 2020 2020 2020 2020 2020 466c Fl │ │ │ │ │ -00044460: 6167 2056 6172 6961 626c 6573 204f 7264 ag Variables Ord │ │ │ │ │ -00044470: 6572 696e 672e 0a20 2020 2020 2020 2020 ering.. │ │ │ │ │ +000443e0: 2020 286c 696e 6520 2020 3629 0a2a 2046 (line 6).* F │ │ │ │ │ +000443f0: 6f72 7472 616e 2039 7820 7375 7070 6f72 ortran 9x suppor │ │ │ │ │ +00044400: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ +00044410: 2020 2020 2020 466f 7274 7261 6e20 3978 Fortran 9x │ │ │ │ │ +00044420: 2053 7570 706f 7274 2e20 2028 6c69 6e65 Support. (line │ │ │ │ │ +00044430: 2020 2036 290a 2a20 4743 4a46 4c41 4753 6).* GCJFLAGS │ │ │ │ │ +00044440: 2061 6e64 2041 4d5f 4743 4a46 4c41 4753 and AM_GCJFLAGS │ │ │ │ │ +00044450: 3a20 2020 2020 2020 2020 2020 2020 2046 : F │ │ │ │ │ +00044460: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ +00044470: 6465 7269 6e67 2e0a 2020 2020 2020 2020 dering.. │ │ │ │ │ 00044480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000444a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000444b0: 2020 2020 2028 6c69 6e65 2020 3230 290a (line 20). │ │ │ │ │ -000444c0: 2a20 6765 6e65 7261 7465 6420 6669 6c65 * generated file │ │ │ │ │ -000444d0: 7320 616e 6420 4356 533a 2020 2020 2020 s and CVS: │ │ │ │ │ -000444e0: 2020 2020 2020 2020 2043 5653 2e20 2020 CVS. │ │ │ │ │ -000444f0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00044500: 696e 6520 2034 3929 0a2a 2067 656e 6572 ine 49).* gener │ │ │ │ │ -00044510: 6174 6564 2066 696c 6573 2c20 6469 7374 ated files, dist │ │ │ │ │ -00044520: 7269 6275 7465 643a 2020 2020 2020 2020 ributed: │ │ │ │ │ -00044530: 2020 4356 532e 2020 2020 2020 2020 2020 CVS. │ │ │ │ │ -00044540: 2020 2020 2020 2028 6c69 6e65 2020 2039 (line 9 │ │ │ │ │ -00044550: 290a 2a20 4765 7474 6578 7420 7375 7070 ).* Gettext supp │ │ │ │ │ -00044560: 6f72 743a 2020 2020 2020 2020 2020 2020 ort: │ │ │ │ │ -00044570: 2020 2020 2020 2020 2020 2067 6574 7465 gette │ │ │ │ │ -00044580: 7874 2e20 2020 2020 2020 2020 2020 2020 xt. │ │ │ │ │ -00044590: 286c 696e 6520 2020 3629 0a2a 2067 6974 (line 6).* git │ │ │ │ │ -000445a0: 2d64 6973 743a 2020 2020 2020 2020 2020 -dist: │ │ │ │ │ +000444b0: 2020 2020 2020 286c 696e 6520 2032 3029 (line 20) │ │ │ │ │ +000444c0: 0a2a 2067 656e 6572 6174 6564 2066 696c .* generated fil │ │ │ │ │ +000444d0: 6573 2061 6e64 2043 5653 3a20 2020 2020 es and CVS: │ │ │ │ │ +000444e0: 2020 2020 2020 2020 2020 4356 532e 2020 CVS. │ │ │ │ │ +000444f0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00044500: 6c69 6e65 2020 3439 290a 2a20 6765 6e65 line 49).* gene │ │ │ │ │ +00044510: 7261 7465 6420 6669 6c65 732c 2064 6973 rated files, dis │ │ │ │ │ +00044520: 7472 6962 7574 6564 3a20 2020 2020 2020 tributed: │ │ │ │ │ +00044530: 2020 2043 5653 2e20 2020 2020 2020 2020 CVS. │ │ │ │ │ +00044540: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00044550: 3929 0a2a 2047 6574 7465 7874 2073 7570 9).* Gettext sup │ │ │ │ │ +00044560: 706f 7274 3a20 2020 2020 2020 2020 2020 port: │ │ │ │ │ +00044570: 2020 2020 2020 2020 2020 2020 6765 7474 gett │ │ │ │ │ +00044580: 6578 742e 2020 2020 2020 2020 2020 2020 ext. │ │ │ │ │ +00044590: 2028 6c69 6e65 2020 2036 290a 2a20 6769 (line 6).* gi │ │ │ │ │ +000445a0: 742d 6469 7374 3a20 2020 2020 2020 2020 t-dist: │ │ │ │ │ 000445b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000445c0: 2020 2020 4765 6e65 7261 6c20 4f70 6572 General Oper │ │ │ │ │ -000445d0: 6174 696f 6e2e 2020 2028 6c69 6e65 2020 ation. (line │ │ │ │ │ -000445e0: 3132 290a 2a20 6769 742d 6469 7374 2c20 12).* git-dist, │ │ │ │ │ -000445f0: 6e6f 6e2d 7374 616e 6461 7264 2065 7861 non-standard exa │ │ │ │ │ -00044600: 6d70 6c65 3a20 2020 2020 2020 2047 656e mple: Gen │ │ │ │ │ -00044610: 6572 616c 204f 7065 7261 7469 6f6e 2e20 eral Operation. │ │ │ │ │ -00044620: 2020 286c 696e 6520 2031 3229 0a2a 2067 (line 12).* g │ │ │ │ │ -00044630: 6e69 7473 3a20 2020 2020 2020 2020 2020 nits: │ │ │ │ │ +000445c0: 2020 2020 2047 656e 6572 616c 204f 7065 General Ope │ │ │ │ │ +000445d0: 7261 7469 6f6e 2e20 2020 286c 696e 6520 ration. (line │ │ │ │ │ +000445e0: 2031 3229 0a2a 2067 6974 2d64 6973 742c 12).* git-dist, │ │ │ │ │ +000445f0: 206e 6f6e 2d73 7461 6e64 6172 6420 6578 non-standard ex │ │ │ │ │ +00044600: 616d 706c 653a 2020 2020 2020 2020 4765 ample: Ge │ │ │ │ │ +00044610: 6e65 7261 6c20 4f70 6572 6174 696f 6e2e neral Operation. │ │ │ │ │ +00044620: 2020 2028 6c69 6e65 2020 3132 290a 2a20 (line 12).* │ │ │ │ │ +00044630: 676e 6974 733a 2020 2020 2020 2020 2020 gnits: │ │ │ │ │ 00044640: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044650: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ -00044660: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00044670: 2020 3233 290a 2a20 676e 6974 7320 7374 23).* gnits st │ │ │ │ │ -00044680: 7269 6374 6e65 7373 3a20 2020 2020 2020 rictness: │ │ │ │ │ -00044690: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -000446a0: 7472 6963 746e 6573 732e 2020 2020 2020 trictness. │ │ │ │ │ -000446b0: 2020 2020 286c 696e 6520 2031 3029 0a2a (line 10).* │ │ │ │ │ -000446c0: 2067 6e75 3a20 2020 2020 2020 2020 2020 gnu: │ │ │ │ │ +00044650: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ +00044660: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00044670: 6520 2032 3329 0a2a 2067 6e69 7473 2073 e 23).* gnits s │ │ │ │ │ +00044680: 7472 6963 746e 6573 733a 2020 2020 2020 trictness: │ │ │ │ │ +00044690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000446a0: 5374 7269 6374 6e65 7373 2e20 2020 2020 Strictness. │ │ │ │ │ +000446b0: 2020 2020 2028 6c69 6e65 2020 3130 290a (line 10). │ │ │ │ │ +000446c0: 2a20 676e 753a 2020 2020 2020 2020 2020 * gnu: │ │ │ │ │ 000446d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000446e0: 2020 2020 2020 2020 4f70 7469 6f6e 732e Options. │ │ │ │ │ -000446f0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00044700: 6e65 2020 3233 290a 2a20 474e 5520 4275 ne 23).* GNU Bu │ │ │ │ │ -00044710: 696c 6420 5379 7374 656d 2c20 6261 7369 ild System, basi │ │ │ │ │ -00044720: 6373 3a20 2020 2020 2020 2020 2020 2020 cs: │ │ │ │ │ -00044730: 2042 6173 6963 2049 6e73 7461 6c6c 6174 Basic Installat │ │ │ │ │ -00044740: 696f 6e2e 2020 286c 696e 6520 2020 3629 ion. (line 6) │ │ │ │ │ -00044750: 0a2a 2047 4e55 2042 7569 6c64 2053 7973 .* GNU Build Sys │ │ │ │ │ -00044760: 7465 6d2c 2066 6561 7475 7265 733a 2020 tem, features: │ │ │ │ │ -00044770: 2020 2020 2020 2020 2020 5573 6520 4361 Use Ca │ │ │ │ │ -00044780: 7365 732e 2020 2020 2020 2020 2020 2028 ses. ( │ │ │ │ │ -00044790: 6c69 6e65 2020 2036 290a 2a20 474e 5520 line 6).* GNU │ │ │ │ │ -000447a0: 4275 696c 6420 5379 7374 656d 2c20 696e Build System, in │ │ │ │ │ -000447b0: 7472 6f64 7563 7469 6f6e 3a20 2020 2020 troduction: │ │ │ │ │ -000447c0: 2020 2047 4e55 2042 7569 6c64 2053 7973 GNU Build Sys │ │ │ │ │ -000447d0: 7465 6d2e 2020 2020 286c 696e 6520 2020 tem. (line │ │ │ │ │ -000447e0: 3629 0a2a 2047 4e55 2042 7569 6c64 2053 6).* GNU Build S │ │ │ │ │ -000447f0: 7973 7465 6d2c 2075 7365 2063 6173 6573 ystem, use cases │ │ │ │ │ -00044800: 3a20 2020 2020 2020 2020 2020 5573 6520 : Use │ │ │ │ │ -00044810: 4361 7365 732e 2020 2020 2020 2020 2020 Cases. │ │ │ │ │ -00044820: 2028 6c69 6e65 2020 2036 290a 2a20 474e (line 6).* GN │ │ │ │ │ -00044830: 5520 436f 6469 6e67 2053 7461 6e64 6172 U Coding Standar │ │ │ │ │ -00044840: 6473 3a20 2020 2020 2020 2020 2020 2020 ds: │ │ │ │ │ -00044850: 2020 2020 2047 4e55 2042 7569 6c64 2053 GNU Build S │ │ │ │ │ -00044860: 7973 7465 6d2e 2020 2020 286c 696e 6520 ystem. (line │ │ │ │ │ -00044870: 2032 3929 0a2a 2047 4e55 2047 6574 7465 29).* GNU Gette │ │ │ │ │ -00044880: 7874 2073 7570 706f 7274 3a20 2020 2020 xt support: │ │ │ │ │ -00044890: 2020 2020 2020 2020 2020 2020 2020 6765 ge │ │ │ │ │ -000448a0: 7474 6578 742e 2020 2020 2020 2020 2020 ttext. │ │ │ │ │ -000448b0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -000448c0: 474e 5520 6d61 6b65 2065 7874 656e 7369 GNU make extensi │ │ │ │ │ -000448d0: 6f6e 733a 2020 2020 2020 2020 2020 2020 ons: │ │ │ │ │ -000448e0: 2020 2020 2020 2047 656e 6572 616c 204f General O │ │ │ │ │ -000448f0: 7065 7261 7469 6f6e 2e20 2020 286c 696e peration. (lin │ │ │ │ │ -00044900: 6520 2032 3029 0a2a 2047 4e55 204d 616b e 20).* GNU Mak │ │ │ │ │ -00044910: 6566 696c 6520 7374 616e 6461 7264 733a efile standards: │ │ │ │ │ -00044920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044930: 496e 7472 6f64 7563 7469 6f6e 2e20 2020 Introduction. │ │ │ │ │ -00044940: 2020 2020 2028 6c69 6e65 2020 3132 290a (line 12). │ │ │ │ │ -00044950: 2a20 676e 7520 7374 7269 6374 6e65 7373 * gnu strictness │ │ │ │ │ -00044960: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00044970: 2020 2020 2020 2020 2053 7472 6963 746e Strictn │ │ │ │ │ -00044980: 6573 732e 2020 2020 2020 2020 2020 286c ess. (l │ │ │ │ │ -00044990: 696e 6520 2031 3029 0a2a 2047 4e55 6d61 ine 10).* GNUma │ │ │ │ │ -000449a0: 6b65 6669 6c65 2069 6e63 6c75 6469 6e67 kefile including │ │ │ │ │ -000449b0: 204d 616b 6566 696c 653a 2020 2020 2020 Makefile: │ │ │ │ │ -000449c0: 2020 5468 6972 642d 5061 7274 7920 4d61 Third-Party Ma │ │ │ │ │ -000449d0: 6b65 6669 6c65 732e 0a20 2020 2020 2020 kefiles.. │ │ │ │ │ +000446e0: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ +000446f0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00044700: 696e 6520 2032 3329 0a2a 2047 4e55 2042 ine 23).* GNU B │ │ │ │ │ +00044710: 7569 6c64 2053 7973 7465 6d2c 2062 6173 uild System, bas │ │ │ │ │ +00044720: 6963 733a 2020 2020 2020 2020 2020 2020 ics: │ │ │ │ │ +00044730: 2020 4261 7369 6320 496e 7374 616c 6c61 Basic Installa │ │ │ │ │ +00044740: 7469 6f6e 2e20 2028 6c69 6e65 2020 2036 tion. (line 6 │ │ │ │ │ +00044750: 290a 2a20 474e 5520 4275 696c 6420 5379 ).* GNU Build Sy │ │ │ │ │ +00044760: 7374 656d 2c20 6665 6174 7572 6573 3a20 stem, features: │ │ │ │ │ +00044770: 2020 2020 2020 2020 2020 2055 7365 2043 Use C │ │ │ │ │ +00044780: 6173 6573 2e20 2020 2020 2020 2020 2020 ases. │ │ │ │ │ +00044790: 286c 696e 6520 2020 3629 0a2a 2047 4e55 (line 6).* GNU │ │ │ │ │ +000447a0: 2042 7569 6c64 2053 7973 7465 6d2c 2069 Build System, i │ │ │ │ │ +000447b0: 6e74 726f 6475 6374 696f 6e3a 2020 2020 ntroduction: │ │ │ │ │ +000447c0: 2020 2020 474e 5520 4275 696c 6420 5379 GNU Build Sy │ │ │ │ │ +000447d0: 7374 656d 2e20 2020 2028 6c69 6e65 2020 stem. (line │ │ │ │ │ +000447e0: 2036 290a 2a20 474e 5520 4275 696c 6420 6).* GNU Build │ │ │ │ │ +000447f0: 5379 7374 656d 2c20 7573 6520 6361 7365 System, use case │ │ │ │ │ +00044800: 733a 2020 2020 2020 2020 2020 2055 7365 s: Use │ │ │ │ │ +00044810: 2043 6173 6573 2e20 2020 2020 2020 2020 Cases. │ │ │ │ │ +00044820: 2020 286c 696e 6520 2020 3629 0a2a 2047 (line 6).* G │ │ │ │ │ +00044830: 4e55 2043 6f64 696e 6720 5374 616e 6461 NU Coding Standa │ │ │ │ │ +00044840: 7264 733a 2020 2020 2020 2020 2020 2020 rds: │ │ │ │ │ +00044850: 2020 2020 2020 474e 5520 4275 696c 6420 GNU Build │ │ │ │ │ +00044860: 5379 7374 656d 2e20 2020 2028 6c69 6e65 System. (line │ │ │ │ │ +00044870: 2020 3239 290a 2a20 474e 5520 4765 7474 29).* GNU Gett │ │ │ │ │ +00044880: 6578 7420 7375 7070 6f72 743a 2020 2020 ext support: │ │ │ │ │ +00044890: 2020 2020 2020 2020 2020 2020 2020 2067 g │ │ │ │ │ +000448a0: 6574 7465 7874 2e20 2020 2020 2020 2020 ettext. │ │ │ │ │ +000448b0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +000448c0: 2047 4e55 206d 616b 6520 6578 7465 6e73 GNU make extens │ │ │ │ │ +000448d0: 696f 6e73 3a20 2020 2020 2020 2020 2020 ions: │ │ │ │ │ +000448e0: 2020 2020 2020 2020 4765 6e65 7261 6c20 General │ │ │ │ │ +000448f0: 4f70 6572 6174 696f 6e2e 2020 2028 6c69 Operation. (li │ │ │ │ │ +00044900: 6e65 2020 3230 290a 2a20 474e 5520 4d61 ne 20).* GNU Ma │ │ │ │ │ +00044910: 6b65 6669 6c65 2073 7461 6e64 6172 6473 kefile standards │ │ │ │ │ +00044920: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00044930: 2049 6e74 726f 6475 6374 696f 6e2e 2020 Introduction. │ │ │ │ │ +00044940: 2020 2020 2020 286c 696e 6520 2031 3229 (line 12) │ │ │ │ │ +00044950: 0a2a 2067 6e75 2073 7472 6963 746e 6573 .* gnu strictnes │ │ │ │ │ +00044960: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ +00044970: 2020 2020 2020 2020 2020 5374 7269 6374 Strict │ │ │ │ │ +00044980: 6e65 7373 2e20 2020 2020 2020 2020 2028 ness. ( │ │ │ │ │ +00044990: 6c69 6e65 2020 3130 290a 2a20 474e 556d line 10).* GNUm │ │ │ │ │ +000449a0: 616b 6566 696c 6520 696e 636c 7564 696e akefile includin │ │ │ │ │ +000449b0: 6720 4d61 6b65 6669 6c65 3a20 2020 2020 g Makefile: │ │ │ │ │ +000449c0: 2020 2054 6869 7264 2d50 6172 7479 204d Third-Party M │ │ │ │ │ +000449d0: 616b 6566 696c 6573 2e0a 2020 2020 2020 akefiles.. │ │ │ │ │ 000449e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000449f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044a10: 2020 2020 2020 2028 6c69 6e65 2031 3131 (line 111 │ │ │ │ │ -00044a20: 290a 2a20 6861 7264 2065 7272 6f72 3a20 ).* hard error: │ │ │ │ │ +00044a10: 2020 2020 2020 2020 286c 696e 6520 3131 (line 11 │ │ │ │ │ +00044a20: 3129 0a2a 2068 6172 6420 6572 726f 723a 1).* hard error: │ │ │ │ │ 00044a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044a40: 2020 2020 2020 2020 2020 2053 696d 706c Simpl │ │ │ │ │ -00044a50: 6520 5465 7374 7320 7573 696e 6720 7061 e Tests using pa │ │ │ │ │ -00044a60: 7261 6c6c 656c 2d74 6573 7473 2e0a 2020 rallel-tests.. │ │ │ │ │ +00044a40: 2020 2020 2020 2020 2020 2020 5369 6d70 Simp │ │ │ │ │ +00044a50: 6c65 2054 6573 7473 2075 7369 6e67 2070 le Tests using p │ │ │ │ │ +00044a60: 6172 616c 6c65 6c2d 7465 7374 732e 0a20 arallel-tests.. │ │ │ │ │ 00044a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044a80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044aa0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00044ab0: 6520 2037 3529 0a2a 2048 6561 6465 7220 e 75).* Header │ │ │ │ │ -00044ac0: 6669 6c65 7320 696e 205f 534f 5552 4345 files in _SOURCE │ │ │ │ │ -00044ad0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -00044ae0: 5072 6f67 7261 6d20 536f 7572 6365 732e Program Sources. │ │ │ │ │ -00044af0: 2020 2020 2028 6c69 6e65 2020 3339 290a (line 39). │ │ │ │ │ -00044b00: 2a20 4845 4144 4552 5320 7072 696d 6172 * HEADERS primar │ │ │ │ │ -00044b10: 792c 2064 6566 696e 6564 3a20 2020 2020 y, defined: │ │ │ │ │ -00044b20: 2020 2020 2020 2020 2048 6561 6465 7273 Headers │ │ │ │ │ -00044b30: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -00044b40: 696e 6520 2020 3629 0a2a 2048 4541 4445 ine 6).* HEADE │ │ │ │ │ -00044b50: 5253 2c20 696e 7374 616c 6c61 7469 6f6e RS, installation │ │ │ │ │ -00044b60: 2064 6972 6563 746f 7269 6573 3a20 2020 directories: │ │ │ │ │ -00044b70: 2020 4865 6164 6572 732e 2020 2020 2020 Headers. │ │ │ │ │ -00044b80: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00044b90: 290a 2a20 4865 6c6c 6f20 576f 726c 6420 ).* Hello World │ │ │ │ │ -00044ba0: 6578 616d 706c 653a 2020 2020 2020 2020 example: │ │ │ │ │ -00044bb0: 2020 2020 2020 2020 2020 2048 656c 6c6f Hello │ │ │ │ │ -00044bc0: 2057 6f72 6c64 2e20 2020 2020 2020 2020 World. │ │ │ │ │ -00044bd0: 286c 696e 6520 2020 3629 0a2a 2068 6f6f (line 6).* hoo │ │ │ │ │ -00044be0: 6b20 7461 7267 6574 733a 2020 2020 2020 k targets: │ │ │ │ │ +00044aa0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00044ab0: 6e65 2020 3735 290a 2a20 4865 6164 6572 ne 75).* Header │ │ │ │ │ +00044ac0: 2066 696c 6573 2069 6e20 5f53 4f55 5243 files in _SOURC │ │ │ │ │ +00044ad0: 4553 3a20 2020 2020 2020 2020 2020 2020 ES: │ │ │ │ │ +00044ae0: 2050 726f 6772 616d 2053 6f75 7263 6573 Program Sources │ │ │ │ │ +00044af0: 2e20 2020 2020 286c 696e 6520 2033 3929 . (line 39) │ │ │ │ │ +00044b00: 0a2a 2048 4541 4445 5253 2070 7269 6d61 .* HEADERS prima │ │ │ │ │ +00044b10: 7279 2c20 6465 6669 6e65 643a 2020 2020 ry, defined: │ │ │ │ │ +00044b20: 2020 2020 2020 2020 2020 4865 6164 6572 Header │ │ │ │ │ +00044b30: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ +00044b40: 6c69 6e65 2020 2036 290a 2a20 4845 4144 line 6).* HEAD │ │ │ │ │ +00044b50: 4552 532c 2069 6e73 7461 6c6c 6174 696f ERS, installatio │ │ │ │ │ +00044b60: 6e20 6469 7265 6374 6f72 6965 733a 2020 n directories: │ │ │ │ │ +00044b70: 2020 2048 6561 6465 7273 2e20 2020 2020 Headers. │ │ │ │ │ +00044b80: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00044b90: 3629 0a2a 2048 656c 6c6f 2057 6f72 6c64 6).* Hello World │ │ │ │ │ +00044ba0: 2065 7861 6d70 6c65 3a20 2020 2020 2020 example: │ │ │ │ │ +00044bb0: 2020 2020 2020 2020 2020 2020 4865 6c6c Hell │ │ │ │ │ +00044bc0: 6f20 576f 726c 642e 2020 2020 2020 2020 o World. │ │ │ │ │ +00044bd0: 2028 6c69 6e65 2020 2036 290a 2a20 686f (line 6).* ho │ │ │ │ │ +00044be0: 6f6b 2074 6172 6765 7473 3a20 2020 2020 ok targets: │ │ │ │ │ 00044bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044c00: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ -00044c10: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00044c20: 3636 290a 2a20 4850 2d55 5820 3130 2c20 66).* HP-UX 10, │ │ │ │ │ -00044c30: 6c65 7820 7072 6f62 6c65 6d73 3a20 2020 lex problems: │ │ │ │ │ -00044c40: 2020 2020 2020 2020 2020 2020 2050 7562 Pub │ │ │ │ │ -00044c50: 6c69 6320 4d61 6372 6f73 2e20 2020 2020 lic Macros. │ │ │ │ │ -00044c60: 2020 286c 696e 6520 2039 3929 0a2a 2068 (line 99).* h │ │ │ │ │ -00044c70: 746d 6c3a 2020 2020 2020 2020 2020 2020 tml: │ │ │ │ │ +00044c00: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ +00044c10: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00044c20: 2036 3629 0a2a 2048 502d 5558 2031 302c 66).* HP-UX 10, │ │ │ │ │ +00044c30: 206c 6578 2070 726f 626c 656d 733a 2020 lex problems: │ │ │ │ │ +00044c40: 2020 2020 2020 2020 2020 2020 2020 5075 Pu │ │ │ │ │ +00044c50: 626c 6963 204d 6163 726f 732e 2020 2020 blic Macros. │ │ │ │ │ +00044c60: 2020 2028 6c69 6e65 2020 3939 290a 2a20 (line 99).* │ │ │ │ │ +00044c70: 6874 6d6c 3a20 2020 2020 2020 2020 2020 html: │ │ │ │ │ 00044c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044c90: 2020 2020 2020 5465 7869 6e66 6f2e 2020 Texinfo. │ │ │ │ │ -00044ca0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00044cb0: 2020 3139 290a 2a20 6874 6d6c 203c 313e 19).* html <1> │ │ │ │ │ -00044cc0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00044cd0: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ -00044ce0: 7874 656e 6469 6e67 2e20 2020 2020 2020 xtending. │ │ │ │ │ -00044cf0: 2020 2020 286c 696e 6520 2034 3129 0a2a (line 41).* │ │ │ │ │ -00044d00: 2048 544d 4c20 6f75 7470 7574 2075 7369 HTML output usi │ │ │ │ │ -00044d10: 6e67 2054 6578 696e 666f 3a20 2020 2020 ng Texinfo: │ │ │ │ │ -00044d20: 2020 2020 2020 2020 5465 7869 6e66 6f2e Texinfo. │ │ │ │ │ -00044d30: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00044d40: 6e65 2020 2036 290a 2a20 6874 6d6c 2d6c ne 6).* html-l │ │ │ │ │ -00044d50: 6f63 616c 3a20 2020 2020 2020 2020 2020 ocal: │ │ │ │ │ +00044c90: 2020 2020 2020 2054 6578 696e 666f 2e20 Texinfo. │ │ │ │ │ +00044ca0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00044cb0: 6520 2031 3929 0a2a 2068 746d 6c20 3c31 e 19).* html <1 │ │ │ │ │ +00044cc0: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +00044cd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00044ce0: 4578 7465 6e64 696e 672e 2020 2020 2020 Extending. │ │ │ │ │ +00044cf0: 2020 2020 2028 6c69 6e65 2020 3431 290a (line 41). │ │ │ │ │ +00044d00: 2a20 4854 4d4c 206f 7574 7075 7420 7573 * HTML output us │ │ │ │ │ +00044d10: 696e 6720 5465 7869 6e66 6f3a 2020 2020 ing Texinfo: │ │ │ │ │ +00044d20: 2020 2020 2020 2020 2054 6578 696e 666f Texinfo │ │ │ │ │ +00044d30: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00044d40: 696e 6520 2020 3629 0a2a 2068 746d 6c2d ine 6).* html- │ │ │ │ │ +00044d50: 6c6f 6361 6c3a 2020 2020 2020 2020 2020 local: │ │ │ │ │ 00044d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044d70: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ -00044d80: 2020 2020 2020 286c 696e 6520 2034 3129 (line 41) │ │ │ │ │ -00044d90: 0a2a 2069 643a 2020 2020 2020 2020 2020 .* id: │ │ │ │ │ +00044d70: 2020 4578 7465 6e64 696e 672e 2020 2020 Extending. │ │ │ │ │ +00044d80: 2020 2020 2020 2028 6c69 6e65 2020 3431 (line 41 │ │ │ │ │ +00044d90: 290a 2a20 6964 3a20 2020 2020 2020 2020 ).* id: │ │ │ │ │ 00044da0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044db0: 2020 2020 2020 2020 2020 5461 6773 2e20 Tags. │ │ │ │ │ -00044dc0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00044dd0: 6c69 6e65 2020 3434 290a 2a20 6966 3a20 line 44).* if: │ │ │ │ │ +00044db0: 2020 2020 2020 2020 2020 2054 6167 732e Tags. │ │ │ │ │ +00044dc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00044dd0: 286c 696e 6520 2034 3429 0a2a 2069 663a (line 44).* if: │ │ │ │ │ 00044de0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044e00: 2020 2055 7361 6765 206f 6620 436f 6e64 Usage of Cond │ │ │ │ │ -00044e10: 6974 696f 6e61 6c73 2e0a 2020 2020 2020 itionals.. │ │ │ │ │ +00044e00: 2020 2020 5573 6167 6520 6f66 2043 6f6e Usage of Con │ │ │ │ │ +00044e10: 6469 7469 6f6e 616c 732e 0a20 2020 2020 ditionals.. │ │ │ │ │ 00044e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044e30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044e40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044e50: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ -00044e60: 3629 0a2a 2069 6e63 6c75 6465 3a20 2020 6).* include: │ │ │ │ │ +00044e50: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00044e60: 3336 290a 2a20 696e 636c 7564 653a 2020 36).* include: │ │ │ │ │ 00044e70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044e80: 2020 2020 2020 2020 2020 2020 4261 7369 Basi │ │ │ │ │ -00044e90: 6373 206f 6620 4469 7374 7269 6275 7469 cs of Distributi │ │ │ │ │ -00044ea0: 6f6e 2e0a 2020 2020 2020 2020 2020 2020 on.. │ │ │ │ │ +00044e80: 2020 2020 2020 2020 2020 2020 2042 6173 Bas │ │ │ │ │ +00044e90: 6963 7320 6f66 2044 6973 7472 6962 7574 ics of Distribut │ │ │ │ │ +00044ea0: 696f 6e2e 0a20 2020 2020 2020 2020 2020 ion.. │ │ │ │ │ 00044eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044ec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044ee0: 2020 286c 696e 6520 2031 3329 0a2a 2069 (line 13).* i │ │ │ │ │ -00044ef0: 6e63 6c75 6465 203c 313e 3a20 2020 2020 nclude <1>: │ │ │ │ │ +00044ee0: 2020 2028 6c69 6e65 2020 3133 290a 2a20 (line 13).* │ │ │ │ │ +00044ef0: 696e 636c 7564 6520 3c31 3e3a 2020 2020 include <1>: │ │ │ │ │ 00044f00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044f10: 2020 2020 2020 496e 636c 7564 652e 2020 Include. │ │ │ │ │ -00044f20: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00044f30: 2020 2036 290a 2a20 696e 636c 7564 652c 6).* include, │ │ │ │ │ -00044f40: 2064 6973 7472 6962 7574 696f 6e3a 2020 distribution: │ │ │ │ │ -00044f50: 2020 2020 2020 2020 2020 2020 2020 2042 B │ │ │ │ │ -00044f60: 6173 6963 7320 6f66 2044 6973 7472 6962 asics of Distrib │ │ │ │ │ -00044f70: 7574 696f 6e2e 0a20 2020 2020 2020 2020 ution.. │ │ │ │ │ +00044f10: 2020 2020 2020 2049 6e63 6c75 6465 2e20 Include. │ │ │ │ │ +00044f20: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00044f30: 6520 2020 3629 0a2a 2069 6e63 6c75 6465 e 6).* include │ │ │ │ │ +00044f40: 2c20 6469 7374 7269 6275 7469 6f6e 3a20 , distribution: │ │ │ │ │ +00044f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00044f60: 4261 7369 6373 206f 6620 4469 7374 7269 Basics of Distri │ │ │ │ │ +00044f70: 6275 7469 6f6e 2e0a 2020 2020 2020 2020 bution.. │ │ │ │ │ 00044f80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044f90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00044fa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00044fb0: 2020 2020 2028 6c69 6e65 2020 3133 290a (line 13). │ │ │ │ │ -00044fc0: 2a20 496e 636c 7564 696e 6720 4d61 6b65 * Including Make │ │ │ │ │ -00044fd0: 6669 6c65 2066 7261 676d 656e 743a 2020 file fragment: │ │ │ │ │ -00044fe0: 2020 2020 2020 2020 2049 6e63 6c75 6465 Include │ │ │ │ │ -00044ff0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -00045000: 696e 6520 2020 3629 0a2a 2069 6e64 656e ine 6).* inden │ │ │ │ │ -00045010: 7461 7469 6f6e 2069 6e20 4d61 6b65 6669 tation in Makefi │ │ │ │ │ -00045020: 6c65 2e61 6d3a 2020 2020 2020 2020 2020 le.am: │ │ │ │ │ -00045030: 2020 4765 6e65 7261 6c20 4f70 6572 6174 General Operat │ │ │ │ │ -00045040: 696f 6e2e 2020 2028 6c69 6e65 2020 3333 ion. (line 33 │ │ │ │ │ -00045050: 290a 2a20 696e 666f 3a20 2020 2020 2020 ).* info: │ │ │ │ │ +00044fb0: 2020 2020 2020 286c 696e 6520 2031 3329 (line 13) │ │ │ │ │ +00044fc0: 0a2a 2049 6e63 6c75 6469 6e67 204d 616b .* Including Mak │ │ │ │ │ +00044fd0: 6566 696c 6520 6672 6167 6d65 6e74 3a20 efile fragment: │ │ │ │ │ +00044fe0: 2020 2020 2020 2020 2020 496e 636c 7564 Includ │ │ │ │ │ +00044ff0: 652e 2020 2020 2020 2020 2020 2020 2028 e. ( │ │ │ │ │ +00045000: 6c69 6e65 2020 2036 290a 2a20 696e 6465 line 6).* inde │ │ │ │ │ +00045010: 6e74 6174 696f 6e20 696e 204d 616b 6566 ntation in Makef │ │ │ │ │ +00045020: 696c 652e 616d 3a20 2020 2020 2020 2020 ile.am: │ │ │ │ │ +00045030: 2020 2047 656e 6572 616c 204f 7065 7261 General Opera │ │ │ │ │ +00045040: 7469 6f6e 2e20 2020 286c 696e 6520 2033 tion. (line 3 │ │ │ │ │ +00045050: 3329 0a2a 2069 6e66 6f3a 2020 2020 2020 3).* info: │ │ │ │ │ 00045060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045070: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00045080: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00045090: 286c 696e 6520 3131 3029 0a2a 2069 6e66 (line 110).* inf │ │ │ │ │ -000450a0: 6f20 3c31 3e3a 2020 2020 2020 2020 2020 o <1>: │ │ │ │ │ +00045070: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00045080: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00045090: 2028 6c69 6e65 2031 3130 290a 2a20 696e (line 110).* in │ │ │ │ │ +000450a0: 666f 203c 313e 3a20 2020 2020 2020 2020 fo <1>: │ │ │ │ │ 000450b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000450c0: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ -000450d0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000450e0: 3431 290a 2a20 696e 666f 2d6c 6f63 616c 41).* info-local │ │ │ │ │ -000450f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00045100: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -00045110: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ -00045120: 2020 286c 696e 6520 2034 3129 0a2a 2069 (line 41).* i │ │ │ │ │ -00045130: 6e73 7461 6c6c 3a20 2020 2020 2020 2020 nstall: │ │ │ │ │ +000450c0: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ +000450d0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000450e0: 2034 3129 0a2a 2069 6e66 6f2d 6c6f 6361 41).* info-loca │ │ │ │ │ +000450f0: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ │ +00045100: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +00045110: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ +00045120: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ +00045130: 696e 7374 616c 6c3a 2020 2020 2020 2020 install: │ │ │ │ │ 00045140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045150: 2020 2020 2020 5374 616e 6461 7264 2054 Standard T │ │ │ │ │ -00045160: 6172 6765 7473 2e20 2020 2028 6c69 6e65 argets. (line │ │ │ │ │ -00045170: 2020 3138 290a 2a20 696e 7374 616c 6c20 18).* install │ │ │ │ │ -00045180: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ -00045190: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -000451a0: 6865 2054 776f 2050 6172 7473 206f 6620 he Two Parts of │ │ │ │ │ -000451b0: 496e 7374 616c 6c2e 0a20 2020 2020 2020 Install.. │ │ │ │ │ +00045150: 2020 2020 2020 2053 7461 6e64 6172 6420 Standard │ │ │ │ │ +00045160: 5461 7267 6574 732e 2020 2020 286c 696e Targets. (lin │ │ │ │ │ +00045170: 6520 2031 3829 0a2a 2069 6e73 7461 6c6c e 18).* install │ │ │ │ │ +00045180: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +00045190: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000451a0: 5468 6520 5477 6f20 5061 7274 7320 6f66 The Two Parts of │ │ │ │ │ +000451b0: 2049 6e73 7461 6c6c 2e0a 2020 2020 2020 Install.. │ │ │ │ │ 000451c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000451d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000451e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000451f0: 2020 2020 2020 2028 6c69 6e65 2020 3134 (line 14 │ │ │ │ │ -00045200: 290a 2a20 696e 7374 616c 6c20 3c32 3e3a ).* install <2>: │ │ │ │ │ -00045210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045220: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ -00045230: 6469 6e67 2e20 2020 2020 2020 2020 2020 ding. │ │ │ │ │ -00045240: 286c 696e 6520 2034 3129 0a2a 2049 6e73 (line 41).* Ins │ │ │ │ │ -00045250: 7461 6c6c 2068 6f6f 6b3a 2020 2020 2020 tall hook: │ │ │ │ │ +000451f0: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ +00045200: 3429 0a2a 2069 6e73 7461 6c6c 203c 323e 4).* install <2> │ │ │ │ │ +00045210: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00045220: 2020 2020 2020 2020 2020 2020 4578 7465 Exte │ │ │ │ │ +00045230: 6e64 696e 672e 2020 2020 2020 2020 2020 nding. │ │ │ │ │ +00045240: 2028 6c69 6e65 2020 3431 290a 2a20 496e (line 41).* In │ │ │ │ │ +00045250: 7374 616c 6c20 686f 6f6b 3a20 2020 2020 stall hook: │ │ │ │ │ 00045260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045270: 2020 2020 4578 7465 6e64 696e 6720 496e Extending In │ │ │ │ │ -00045280: 7374 616c 6c61 7469 6f6e 2e0a 2020 2020 stallation.. │ │ │ │ │ +00045270: 2020 2020 2045 7874 656e 6469 6e67 2049 Extending I │ │ │ │ │ +00045280: 6e73 7461 6c6c 6174 696f 6e2e 0a20 2020 nstallation.. │ │ │ │ │ 00045290: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000452a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000452b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000452c0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -000452d0: 2031 3529 0a2a 2049 6e73 7461 6c6c 2c20 15).* Install, │ │ │ │ │ -000452e0: 7477 6f20 7061 7274 7320 6f66 3a20 2020 two parts of: │ │ │ │ │ -000452f0: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ -00045300: 6520 5477 6f20 5061 7274 7320 6f66 2049 e Two Parts of I │ │ │ │ │ -00045310: 6e73 7461 6c6c 2e0a 2020 2020 2020 2020 nstall.. │ │ │ │ │ +000452c0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +000452d0: 2020 3135 290a 2a20 496e 7374 616c 6c2c 15).* Install, │ │ │ │ │ +000452e0: 2074 776f 2070 6172 7473 206f 663a 2020 two parts of: │ │ │ │ │ +000452f0: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ +00045300: 6865 2054 776f 2050 6172 7473 206f 6620 he Two Parts of │ │ │ │ │ +00045310: 496e 7374 616c 6c2e 0a20 2020 2020 2020 Install.. │ │ │ │ │ 00045320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045350: 2020 2020 2020 286c 696e 6520 2031 3429 (line 14) │ │ │ │ │ -00045360: 0a2a 2069 6e73 7461 6c6c 2d64 6174 613a .* install-data: │ │ │ │ │ -00045370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045380: 2020 2020 2020 2020 2020 5477 6f2d 5061 Two-Pa │ │ │ │ │ -00045390: 7274 2049 6e73 7461 6c6c 2e20 2020 2028 rt Install. ( │ │ │ │ │ -000453a0: 6c69 6e65 2020 3136 290a 2a20 696e 7374 line 16).* inst │ │ │ │ │ -000453b0: 616c 6c2d 6461 7461 203c 313e 3a20 2020 all-data <1>: │ │ │ │ │ +00045350: 2020 2020 2020 2028 6c69 6e65 2020 3134 (line 14 │ │ │ │ │ +00045360: 290a 2a20 696e 7374 616c 6c2d 6461 7461 ).* install-data │ │ │ │ │ +00045370: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00045380: 2020 2020 2020 2020 2020 2054 776f 2d50 Two-P │ │ │ │ │ +00045390: 6172 7420 496e 7374 616c 6c2e 2020 2020 art Install. │ │ │ │ │ +000453a0: 286c 696e 6520 2031 3629 0a2a 2069 6e73 (line 16).* ins │ │ │ │ │ +000453b0: 7461 6c6c 2d64 6174 6120 3c31 3e3a 2020 tall-data <1>: │ │ │ │ │ 000453c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000453d0: 2020 2054 6865 2054 776f 2050 6172 7473 The Two Parts │ │ │ │ │ -000453e0: 206f 6620 496e 7374 616c 6c2e 0a20 2020 of Install.. │ │ │ │ │ +000453d0: 2020 2020 5468 6520 5477 6f20 5061 7274 The Two Part │ │ │ │ │ +000453e0: 7320 6f66 2049 6e73 7461 6c6c 2e0a 2020 s of Install.. │ │ │ │ │ 000453f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045420: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00045430: 2020 3134 290a 2a20 696e 7374 616c 6c2d 14).* install- │ │ │ │ │ -00045440: 6461 7461 203c 323e 3a20 2020 2020 2020 data <2>: │ │ │ │ │ -00045450: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ -00045460: 7874 656e 6469 6e67 2e20 2020 2020 2020 xtending. │ │ │ │ │ -00045470: 2020 2020 286c 696e 6520 2034 3129 0a2a (line 41).* │ │ │ │ │ -00045480: 2069 6e73 7461 6c6c 2d64 6174 612d 686f install-data-ho │ │ │ │ │ -00045490: 6f6b 3a20 2020 2020 2020 2020 2020 2020 ok: │ │ │ │ │ -000454a0: 2020 2020 2020 2020 4578 7465 6e64 696e Extendin │ │ │ │ │ -000454b0: 672e 2020 2020 2020 2020 2020 2028 6c69 g. (li │ │ │ │ │ -000454c0: 6e65 2020 3636 290a 2a20 696e 7374 616c ne 66).* instal │ │ │ │ │ -000454d0: 6c2d 6461 7461 2d6c 6f63 616c 3a20 2020 l-data-local: │ │ │ │ │ +00045420: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00045430: 6520 2031 3429 0a2a 2069 6e73 7461 6c6c e 14).* install │ │ │ │ │ +00045440: 2d64 6174 6120 3c32 3e3a 2020 2020 2020 -data <2>: │ │ │ │ │ +00045450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00045460: 4578 7465 6e64 696e 672e 2020 2020 2020 Extending. │ │ │ │ │ +00045470: 2020 2020 2028 6c69 6e65 2020 3431 290a (line 41). │ │ │ │ │ +00045480: 2a20 696e 7374 616c 6c2d 6461 7461 2d68 * install-data-h │ │ │ │ │ +00045490: 6f6f 6b3a 2020 2020 2020 2020 2020 2020 ook: │ │ │ │ │ +000454a0: 2020 2020 2020 2020 2045 7874 656e 6469 Extendi │ │ │ │ │ +000454b0: 6e67 2e20 2020 2020 2020 2020 2020 286c ng. (l │ │ │ │ │ +000454c0: 696e 6520 2036 3629 0a2a 2069 6e73 7461 ine 66).* insta │ │ │ │ │ +000454d0: 6c6c 2d64 6174 612d 6c6f 6361 6c3a 2020 ll-data-local: │ │ │ │ │ 000454e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000454f0: 2045 7874 656e 6469 6e67 2049 6e73 7461 Extending Insta │ │ │ │ │ -00045500: 6c6c 6174 696f 6e2e 0a20 2020 2020 2020 llation.. │ │ │ │ │ +000454f0: 2020 4578 7465 6e64 696e 6720 496e 7374 Extending Inst │ │ │ │ │ +00045500: 616c 6c61 7469 6f6e 2e0a 2020 2020 2020 allation.. │ │ │ │ │ 00045510: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045530: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045540: 2020 2020 2020 2028 6c69 6e65 2020 2039 (line 9 │ │ │ │ │ -00045550: 290a 2a20 696e 7374 616c 6c2d 6461 7461 ).* install-data │ │ │ │ │ -00045560: 2d6c 6f63 616c 203c 313e 3a20 2020 2020 -local <1>: │ │ │ │ │ -00045570: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ -00045580: 6469 6e67 2e20 2020 2020 2020 2020 2020 ding. │ │ │ │ │ -00045590: 286c 696e 6520 2034 3129 0a2a 2069 6e73 (line 41).* ins │ │ │ │ │ -000455a0: 7461 6c6c 2d64 7669 3a20 2020 2020 2020 tall-dvi: │ │ │ │ │ +00045540: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00045550: 3929 0a2a 2069 6e73 7461 6c6c 2d64 6174 9).* install-dat │ │ │ │ │ +00045560: 612d 6c6f 6361 6c20 3c31 3e3a 2020 2020 a-local <1>: │ │ │ │ │ +00045570: 2020 2020 2020 2020 2020 2020 4578 7465 Exte │ │ │ │ │ +00045580: 6e64 696e 672e 2020 2020 2020 2020 2020 nding. │ │ │ │ │ +00045590: 2028 6c69 6e65 2020 3431 290a 2a20 696e (line 41).* in │ │ │ │ │ +000455a0: 7374 616c 6c2d 6476 693a 2020 2020 2020 stall-dvi: │ │ │ │ │ 000455b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000455c0: 2020 2020 5465 7869 6e66 6f2e 2020 2020 Texinfo. │ │ │ │ │ -000455d0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000455e0: 3139 290a 2a20 696e 7374 616c 6c2d 6476 19).* install-dv │ │ │ │ │ -000455f0: 6920 3c31 3e3a 2020 2020 2020 2020 2020 i <1>: │ │ │ │ │ -00045600: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -00045610: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ -00045620: 2020 286c 696e 6520 2034 3129 0a2a 2069 (line 41).* i │ │ │ │ │ -00045630: 6e73 7461 6c6c 2d64 7669 2d6c 6f63 616c nstall-dvi-local │ │ │ │ │ -00045640: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00045650: 2020 2020 2020 4578 7465 6e64 696e 672e Extending. │ │ │ │ │ -00045660: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00045670: 2020 3431 290a 2a20 696e 7374 616c 6c2d 41).* install- │ │ │ │ │ -00045680: 6578 6563 3a20 2020 2020 2020 2020 2020 exec: │ │ │ │ │ -00045690: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -000456a0: 776f 2d50 6172 7420 496e 7374 616c 6c2e wo-Part Install. │ │ │ │ │ -000456b0: 2020 2020 286c 696e 6520 2031 3629 0a2a (line 16).* │ │ │ │ │ -000456c0: 2069 6e73 7461 6c6c 2d65 7865 6320 3c31 install-exec <1 │ │ │ │ │ -000456d0: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ -000456e0: 2020 2020 2020 2020 5468 6520 5477 6f20 The Two │ │ │ │ │ -000456f0: 5061 7274 7320 6f66 2049 6e73 7461 6c6c Parts of Install │ │ │ │ │ -00045700: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +000455c0: 2020 2020 2054 6578 696e 666f 2e20 2020 Texinfo. │ │ │ │ │ +000455d0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000455e0: 2031 3929 0a2a 2069 6e73 7461 6c6c 2d64 19).* install-d │ │ │ │ │ +000455f0: 7669 203c 313e 3a20 2020 2020 2020 2020 vi <1>: │ │ │ │ │ +00045600: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +00045610: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ +00045620: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ +00045630: 696e 7374 616c 6c2d 6476 692d 6c6f 6361 install-dvi-loca │ │ │ │ │ +00045640: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ │ +00045650: 2020 2020 2020 2045 7874 656e 6469 6e67 Extending │ │ │ │ │ +00045660: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ +00045670: 6520 2034 3129 0a2a 2069 6e73 7461 6c6c e 41).* install │ │ │ │ │ +00045680: 2d65 7865 633a 2020 2020 2020 2020 2020 -exec: │ │ │ │ │ +00045690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000456a0: 5477 6f2d 5061 7274 2049 6e73 7461 6c6c Two-Part Install │ │ │ │ │ +000456b0: 2e20 2020 2028 6c69 6e65 2020 3136 290a . (line 16). │ │ │ │ │ +000456c0: 2a20 696e 7374 616c 6c2d 6578 6563 203c * install-exec < │ │ │ │ │ +000456d0: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +000456e0: 2020 2020 2020 2020 2054 6865 2054 776f The Two │ │ │ │ │ +000456f0: 2050 6172 7473 206f 6620 496e 7374 616c Parts of Instal │ │ │ │ │ +00045700: 6c2e 0a20 2020 2020 2020 2020 2020 2020 l.. │ │ │ │ │ 00045710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045720: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045730: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045740: 286c 696e 6520 2031 3429 0a2a 2069 6e73 (line 14).* ins │ │ │ │ │ -00045750: 7461 6c6c 2d65 7865 6320 3c32 3e3a 2020 tall-exec <2>: │ │ │ │ │ +00045740: 2028 6c69 6e65 2020 3134 290a 2a20 696e (line 14).* in │ │ │ │ │ +00045750: 7374 616c 6c2d 6578 6563 203c 323e 3a20 stall-exec <2>: │ │ │ │ │ 00045760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045770: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ -00045780: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00045790: 3431 290a 2a20 696e 7374 616c 6c2d 6578 41).* install-ex │ │ │ │ │ -000457a0: 6563 2d68 6f6f 6b3a 2020 2020 2020 2020 ec-hook: │ │ │ │ │ -000457b0: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -000457c0: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ -000457d0: 2020 286c 696e 6520 2036 3629 0a2a 2069 (line 66).* i │ │ │ │ │ -000457e0: 6e73 7461 6c6c 2d65 7865 632d 6c6f 6361 nstall-exec-loca │ │ │ │ │ -000457f0: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ │ -00045800: 2020 2020 2020 4578 7465 6e64 696e 6720 Extending │ │ │ │ │ -00045810: 496e 7374 616c 6c61 7469 6f6e 2e0a 2020 Installation.. │ │ │ │ │ +00045770: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ +00045780: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00045790: 2034 3129 0a2a 2069 6e73 7461 6c6c 2d65 41).* install-e │ │ │ │ │ +000457a0: 7865 632d 686f 6f6b 3a20 2020 2020 2020 xec-hook: │ │ │ │ │ +000457b0: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +000457c0: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ +000457d0: 2020 2028 6c69 6e65 2020 3636 290a 2a20 (line 66).* │ │ │ │ │ +000457e0: 696e 7374 616c 6c2d 6578 6563 2d6c 6f63 install-exec-loc │ │ │ │ │ +000457f0: 616c 3a20 2020 2020 2020 2020 2020 2020 al: │ │ │ │ │ +00045800: 2020 2020 2020 2045 7874 656e 6469 6e67 Extending │ │ │ │ │ +00045810: 2049 6e73 7461 6c6c 6174 696f 6e2e 0a20 Installation.. │ │ │ │ │ 00045820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045830: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045850: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00045860: 6520 2020 3929 0a2a 2069 6e73 7461 6c6c e 9).* install │ │ │ │ │ -00045870: 2d65 7865 632d 6c6f 6361 6c20 3c31 3e3a -exec-local <1>: │ │ │ │ │ -00045880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045890: 4578 7465 6e64 696e 672e 2020 2020 2020 Extending. │ │ │ │ │ -000458a0: 2020 2020 2028 6c69 6e65 2020 3431 290a (line 41). │ │ │ │ │ -000458b0: 2a20 696e 7374 616c 6c2d 6874 6d6c 3a20 * install-html: │ │ │ │ │ +00045850: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00045860: 6e65 2020 2039 290a 2a20 696e 7374 616c ne 9).* instal │ │ │ │ │ +00045870: 6c2d 6578 6563 2d6c 6f63 616c 203c 313e l-exec-local <1> │ │ │ │ │ +00045880: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00045890: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ +000458a0: 2020 2020 2020 286c 696e 6520 2034 3129 (line 41) │ │ │ │ │ +000458b0: 0a2a 2069 6e73 7461 6c6c 2d68 746d 6c3a .* install-html: │ │ │ │ │ 000458c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000458d0: 2020 2020 2020 2020 2054 6578 696e 666f Texinfo │ │ │ │ │ -000458e0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -000458f0: 696e 6520 2031 3929 0a2a 2069 6e73 7461 ine 19).* insta │ │ │ │ │ -00045900: 6c6c 2d68 746d 6c20 3c31 3e3a 2020 2020 ll-html <1>: │ │ │ │ │ +000458d0: 2020 2020 2020 2020 2020 5465 7869 6e66 Texinf │ │ │ │ │ +000458e0: 6f2e 2020 2020 2020 2020 2020 2020 2028 o. ( │ │ │ │ │ +000458f0: 6c69 6e65 2020 3139 290a 2a20 696e 7374 line 19).* inst │ │ │ │ │ +00045900: 616c 6c2d 6874 6d6c 203c 313e 3a20 2020 all-html <1>: │ │ │ │ │ 00045910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045920: 2020 4578 7465 6e64 696e 672e 2020 2020 Extending. │ │ │ │ │ -00045930: 2020 2020 2020 2028 6c69 6e65 2020 3431 (line 41 │ │ │ │ │ -00045940: 290a 2a20 696e 7374 616c 6c2d 6874 6d6c ).* install-html │ │ │ │ │ -00045950: 2d6c 6f63 616c 3a20 2020 2020 2020 2020 -local: │ │ │ │ │ -00045960: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ -00045970: 6469 6e67 2e20 2020 2020 2020 2020 2020 ding. │ │ │ │ │ -00045980: 286c 696e 6520 2034 3129 0a2a 2069 6e73 (line 41).* ins │ │ │ │ │ -00045990: 7461 6c6c 2d69 6e66 6f3a 2020 2020 2020 tall-info: │ │ │ │ │ +00045920: 2020 2045 7874 656e 6469 6e67 2e20 2020 Extending. │ │ │ │ │ +00045930: 2020 2020 2020 2020 286c 696e 6520 2034 (line 4 │ │ │ │ │ +00045940: 3129 0a2a 2069 6e73 7461 6c6c 2d68 746d 1).* install-htm │ │ │ │ │ +00045950: 6c2d 6c6f 6361 6c3a 2020 2020 2020 2020 l-local: │ │ │ │ │ +00045960: 2020 2020 2020 2020 2020 2020 4578 7465 Exte │ │ │ │ │ +00045970: 6e64 696e 672e 2020 2020 2020 2020 2020 nding. │ │ │ │ │ +00045980: 2028 6c69 6e65 2020 3431 290a 2a20 696e (line 41).* in │ │ │ │ │ +00045990: 7374 616c 6c2d 696e 666f 3a20 2020 2020 stall-info: │ │ │ │ │ 000459a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000459b0: 2020 2020 5465 7869 6e66 6f2e 2020 2020 Texinfo. │ │ │ │ │ -000459c0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000459d0: 3739 290a 2a20 696e 7374 616c 6c2d 696e 79).* install-in │ │ │ │ │ -000459e0: 666f 203c 313e 3a20 2020 2020 2020 2020 fo <1>: │ │ │ │ │ -000459f0: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ -00045a00: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ -00045a10: 2020 286c 696e 6520 3131 3029 0a2a 2069 (line 110).* i │ │ │ │ │ -00045a20: 6e73 7461 6c6c 2d69 6e66 6f20 3c32 3e3a nstall-info <2>: │ │ │ │ │ -00045a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045a40: 2020 2020 2020 4578 7465 6e64 696e 672e Extending. │ │ │ │ │ -00045a50: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00045a60: 2020 3431 290a 2a20 696e 7374 616c 6c2d 41).* install- │ │ │ │ │ -00045a70: 696e 666f 2074 6172 6765 743a 2020 2020 info target: │ │ │ │ │ -00045a80: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -00045a90: 6578 696e 666f 2e20 2020 2020 2020 2020 exinfo. │ │ │ │ │ -00045aa0: 2020 2020 286c 696e 6520 2037 3929 0a2a (line 79).* │ │ │ │ │ -00045ab0: 2069 6e73 7461 6c6c 2d69 6e66 6f2d 6c6f install-info-lo │ │ │ │ │ -00045ac0: 6361 6c3a 2020 2020 2020 2020 2020 2020 cal: │ │ │ │ │ -00045ad0: 2020 2020 2020 2020 4578 7465 6e64 696e Extendin │ │ │ │ │ -00045ae0: 672e 2020 2020 2020 2020 2020 2028 6c69 g. (li │ │ │ │ │ -00045af0: 6e65 2020 3431 290a 2a20 696e 7374 616c ne 41).* instal │ │ │ │ │ -00045b00: 6c2d 6d61 6e3a 2020 2020 2020 2020 2020 l-man: │ │ │ │ │ +000459b0: 2020 2020 2054 6578 696e 666f 2e20 2020 Texinfo. │ │ │ │ │ +000459c0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000459d0: 2037 3929 0a2a 2069 6e73 7461 6c6c 2d69 79).* install-i │ │ │ │ │ +000459e0: 6e66 6f20 3c31 3e3a 2020 2020 2020 2020 nfo <1>: │ │ │ │ │ +000459f0: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ +00045a00: 7469 6f6e 732e 2020 2020 2020 2020 2020 tions. │ │ │ │ │ +00045a10: 2020 2028 6c69 6e65 2031 3130 290a 2a20 (line 110).* │ │ │ │ │ +00045a20: 696e 7374 616c 6c2d 696e 666f 203c 323e install-info <2> │ │ │ │ │ +00045a30: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00045a40: 2020 2020 2020 2045 7874 656e 6469 6e67 Extending │ │ │ │ │ +00045a50: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ +00045a60: 6520 2034 3129 0a2a 2069 6e73 7461 6c6c e 41).* install │ │ │ │ │ +00045a70: 2d69 6e66 6f20 7461 7267 6574 3a20 2020 -info target: │ │ │ │ │ +00045a80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00045a90: 5465 7869 6e66 6f2e 2020 2020 2020 2020 Texinfo. │ │ │ │ │ +00045aa0: 2020 2020 2028 6c69 6e65 2020 3739 290a (line 79). │ │ │ │ │ +00045ab0: 2a20 696e 7374 616c 6c2d 696e 666f 2d6c * install-info-l │ │ │ │ │ +00045ac0: 6f63 616c 3a20 2020 2020 2020 2020 2020 ocal: │ │ │ │ │ +00045ad0: 2020 2020 2020 2020 2045 7874 656e 6469 Extendi │ │ │ │ │ +00045ae0: 6e67 2e20 2020 2020 2020 2020 2020 286c ng. (l │ │ │ │ │ +00045af0: 696e 6520 2034 3129 0a2a 2069 6e73 7461 ine 41).* insta │ │ │ │ │ +00045b00: 6c6c 2d6d 616e 3a20 2020 2020 2020 2020 ll-man: │ │ │ │ │ 00045b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045b20: 204d 616e 2050 6167 6573 2e20 2020 2020 Man Pages. │ │ │ │ │ -00045b30: 2020 2020 2020 286c 696e 6520 2033 3229 (line 32) │ │ │ │ │ -00045b40: 0a2a 2069 6e73 7461 6c6c 2d6d 616e 203c .* install-man < │ │ │ │ │ -00045b50: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ -00045b60: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ -00045b70: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -00045b80: 6c69 6e65 2031 3136 290a 2a20 696e 7374 line 116).* inst │ │ │ │ │ -00045b90: 616c 6c2d 6d61 6e20 7461 7267 6574 3a20 all-man target: │ │ │ │ │ +00045b20: 2020 4d61 6e20 5061 6765 732e 2020 2020 Man Pages. │ │ │ │ │ +00045b30: 2020 2020 2020 2028 6c69 6e65 2020 3332 (line 32 │ │ │ │ │ +00045b40: 290a 2a20 696e 7374 616c 6c2d 6d61 6e20 ).* install-man │ │ │ │ │ +00045b50: 3c31 3e3a 2020 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ +00045b60: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ +00045b70: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ +00045b80: 286c 696e 6520 3131 3629 0a2a 2069 6e73 (line 116).* ins │ │ │ │ │ +00045b90: 7461 6c6c 2d6d 616e 2074 6172 6765 743a tall-man target: │ │ │ │ │ 00045ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045bb0: 2020 204d 616e 2050 6167 6573 2e20 2020 Man Pages. │ │ │ │ │ -00045bc0: 2020 2020 2020 2020 286c 696e 6520 2033 (line 3 │ │ │ │ │ -00045bd0: 3229 0a2a 2069 6e73 7461 6c6c 2d70 6466 2).* install-pdf │ │ │ │ │ -00045be0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00045bf0: 2020 2020 2020 2020 2020 2020 5465 7869 Texi │ │ │ │ │ -00045c00: 6e66 6f2e 2020 2020 2020 2020 2020 2020 nfo. │ │ │ │ │ -00045c10: 2028 6c69 6e65 2020 3139 290a 2a20 696e (line 19).* in │ │ │ │ │ -00045c20: 7374 616c 6c2d 7064 6620 3c31 3e3a 2020 stall-pdf <1>: │ │ │ │ │ +00045bb0: 2020 2020 4d61 6e20 5061 6765 732e 2020 Man Pages. │ │ │ │ │ +00045bc0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00045bd0: 3332 290a 2a20 696e 7374 616c 6c2d 7064 32).* install-pd │ │ │ │ │ +00045be0: 663a 2020 2020 2020 2020 2020 2020 2020 f: │ │ │ │ │ +00045bf0: 2020 2020 2020 2020 2020 2020 2054 6578 Tex │ │ │ │ │ +00045c00: 696e 666f 2e20 2020 2020 2020 2020 2020 info. │ │ │ │ │ +00045c10: 2020 286c 696e 6520 2031 3929 0a2a 2069 (line 19).* i │ │ │ │ │ +00045c20: 6e73 7461 6c6c 2d70 6466 203c 313e 3a20 nstall-pdf <1>: │ │ │ │ │ 00045c30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045c40: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ -00045c50: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00045c60: 2034 3129 0a2a 2069 6e73 7461 6c6c 2d70 41).* install-p │ │ │ │ │ -00045c70: 6466 2d6c 6f63 616c 3a20 2020 2020 2020 df-local: │ │ │ │ │ -00045c80: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ -00045c90: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ -00045ca0: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ -00045cb0: 696e 7374 616c 6c2d 7073 3a20 2020 2020 install-ps: │ │ │ │ │ +00045c40: 2020 2020 2020 4578 7465 6e64 696e 672e Extending. │ │ │ │ │ +00045c50: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00045c60: 2020 3431 290a 2a20 696e 7374 616c 6c2d 41).* install- │ │ │ │ │ +00045c70: 7064 662d 6c6f 6361 6c3a 2020 2020 2020 pdf-local: │ │ │ │ │ +00045c80: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +00045c90: 7874 656e 6469 6e67 2e20 2020 2020 2020 xtending. │ │ │ │ │ +00045ca0: 2020 2020 286c 696e 6520 2034 3129 0a2a (line 41).* │ │ │ │ │ +00045cb0: 2069 6e73 7461 6c6c 2d70 733a 2020 2020 install-ps: │ │ │ │ │ 00045cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045cd0: 2020 2020 2020 2054 6578 696e 666f 2e20 Texinfo. │ │ │ │ │ -00045ce0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00045cf0: 6520 2031 3929 0a2a 2069 6e73 7461 6c6c e 19).* install │ │ │ │ │ -00045d00: 2d70 7320 3c31 3e3a 2020 2020 2020 2020 -ps <1>: │ │ │ │ │ +00045cd0: 2020 2020 2020 2020 5465 7869 6e66 6f2e Texinfo. │ │ │ │ │ +00045ce0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00045cf0: 6e65 2020 3139 290a 2a20 696e 7374 616c ne 19).* instal │ │ │ │ │ +00045d00: 6c2d 7073 203c 313e 3a20 2020 2020 2020 l-ps <1>: │ │ │ │ │ 00045d10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045d20: 4578 7465 6e64 696e 672e 2020 2020 2020 Extending. │ │ │ │ │ -00045d30: 2020 2020 2028 6c69 6e65 2020 3431 290a (line 41). │ │ │ │ │ -00045d40: 2a20 696e 7374 616c 6c2d 7073 2d6c 6f63 * install-ps-loc │ │ │ │ │ -00045d50: 616c 3a20 2020 2020 2020 2020 2020 2020 al: │ │ │ │ │ -00045d60: 2020 2020 2020 2020 2045 7874 656e 6469 Extendi │ │ │ │ │ -00045d70: 6e67 2e20 2020 2020 2020 2020 2020 286c ng. (l │ │ │ │ │ -00045d80: 696e 6520 2034 3129 0a2a 2069 6e73 7461 ine 41).* insta │ │ │ │ │ -00045d90: 6c6c 2d73 7472 6970 3a20 2020 2020 2020 ll-strip: │ │ │ │ │ +00045d20: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ +00045d30: 2020 2020 2020 286c 696e 6520 2034 3129 (line 41) │ │ │ │ │ +00045d40: 0a2a 2069 6e73 7461 6c6c 2d70 732d 6c6f .* install-ps-lo │ │ │ │ │ +00045d50: 6361 6c3a 2020 2020 2020 2020 2020 2020 cal: │ │ │ │ │ +00045d60: 2020 2020 2020 2020 2020 4578 7465 6e64 Extend │ │ │ │ │ +00045d70: 696e 672e 2020 2020 2020 2020 2020 2028 ing. ( │ │ │ │ │ +00045d80: 6c69 6e65 2020 3431 290a 2a20 696e 7374 line 41).* inst │ │ │ │ │ +00045d90: 616c 6c2d 7374 7269 703a 2020 2020 2020 all-strip: │ │ │ │ │ 00045da0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045db0: 2020 5374 616e 6461 7264 2054 6172 6765 Standard Targe │ │ │ │ │ -00045dc0: 7473 2e20 2020 2028 6c69 6e65 2020 3231 ts. (line 21 │ │ │ │ │ -00045dd0: 290a 2a20 696e 7374 616c 6c2d 7374 7269 ).* install-stri │ │ │ │ │ -00045de0: 7020 3c31 3e3a 2020 2020 2020 2020 2020 p <1>: │ │ │ │ │ -00045df0: 2020 2020 2020 2020 2020 2049 6e73 7461 Insta │ │ │ │ │ -00045e00: 6c6c 2052 756c 6573 2066 6f72 2074 6865 ll Rules for the │ │ │ │ │ -00045e10: 2055 7365 722e 0a20 2020 2020 2020 2020 User.. │ │ │ │ │ +00045db0: 2020 2053 7461 6e64 6172 6420 5461 7267 Standard Targ │ │ │ │ │ +00045dc0: 6574 732e 2020 2020 286c 696e 6520 2032 ets. (line 2 │ │ │ │ │ +00045dd0: 3129 0a2a 2069 6e73 7461 6c6c 2d73 7472 1).* install-str │ │ │ │ │ +00045de0: 6970 203c 313e 3a20 2020 2020 2020 2020 ip <1>: │ │ │ │ │ +00045df0: 2020 2020 2020 2020 2020 2020 496e 7374 Inst │ │ │ │ │ +00045e00: 616c 6c20 5275 6c65 7320 666f 7220 7468 all Rules for th │ │ │ │ │ +00045e10: 6520 5573 6572 2e0a 2020 2020 2020 2020 e User.. │ │ │ │ │ 00045e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045e30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00045e40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045e50: 2020 2020 2028 6c69 6e65 2020 2037 290a (line 7). │ │ │ │ │ -00045e60: 2a20 496e 7374 616c 6c61 7469 6f6e 2064 * Installation d │ │ │ │ │ -00045e70: 6972 6563 746f 7269 6573 2c20 6578 7465 irectories, exte │ │ │ │ │ -00045e80: 6e64 696e 6720 6c69 7374 3a20 556e 6966 nding list: Unif │ │ │ │ │ -00045e90: 6f72 6d2e 2020 2020 2020 2020 2020 286c orm. (l │ │ │ │ │ -00045ea0: 696e 6520 2035 3629 0a2a 2049 6e73 7461 ine 56).* Insta │ │ │ │ │ -00045eb0: 6c6c 6174 696f 6e20 7375 7070 6f72 743a llation support: │ │ │ │ │ -00045ec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045ed0: 2020 496e 7374 616c 6c2e 2020 2020 2020 Install. │ │ │ │ │ -00045ee0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00045ef0: 290a 2a20 496e 7374 616c 6c61 7469 6f6e ).* Installation │ │ │ │ │ -00045f00: 2c20 6261 7369 6373 3a20 2020 2020 2020 , basics: │ │ │ │ │ -00045f10: 2020 2020 2020 2020 2020 2042 6173 6963 Basic │ │ │ │ │ -00045f20: 2049 6e73 7461 6c6c 6174 696f 6e2e 2020 Installation. │ │ │ │ │ -00045f30: 286c 696e 6520 2020 3629 0a2a 2069 6e73 (line 6).* ins │ │ │ │ │ -00045f40: 7461 6c6c 6368 6563 6b3a 2020 2020 2020 tallcheck: │ │ │ │ │ +00045e50: 2020 2020 2020 286c 696e 6520 2020 3729 (line 7) │ │ │ │ │ +00045e60: 0a2a 2049 6e73 7461 6c6c 6174 696f 6e20 .* Installation │ │ │ │ │ +00045e70: 6469 7265 6374 6f72 6965 732c 2065 7874 directories, ext │ │ │ │ │ +00045e80: 656e 6469 6e67 206c 6973 743a 2055 6e69 ending list: Uni │ │ │ │ │ +00045e90: 666f 726d 2e20 2020 2020 2020 2020 2028 form. ( │ │ │ │ │ +00045ea0: 6c69 6e65 2020 3536 290a 2a20 496e 7374 line 56).* Inst │ │ │ │ │ +00045eb0: 616c 6c61 7469 6f6e 2073 7570 706f 7274 allation support │ │ │ │ │ +00045ec0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00045ed0: 2020 2049 6e73 7461 6c6c 2e20 2020 2020 Install. │ │ │ │ │ +00045ee0: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00045ef0: 3629 0a2a 2049 6e73 7461 6c6c 6174 696f 6).* Installatio │ │ │ │ │ +00045f00: 6e2c 2062 6173 6963 733a 2020 2020 2020 n, basics: │ │ │ │ │ +00045f10: 2020 2020 2020 2020 2020 2020 4261 7369 Basi │ │ │ │ │ +00045f20: 6320 496e 7374 616c 6c61 7469 6f6e 2e20 c Installation. │ │ │ │ │ +00045f30: 2028 6c69 6e65 2020 2036 290a 2a20 696e (line 6).* in │ │ │ │ │ +00045f40: 7374 616c 6c63 6865 636b 3a20 2020 2020 stallcheck: │ │ │ │ │ 00045f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00045f60: 2020 2020 5374 616e 6461 7264 2054 6172 Standard Tar │ │ │ │ │ -00045f70: 6765 7473 2e20 2020 2028 6c69 6e65 2020 gets. (line │ │ │ │ │ -00045f80: 3333 290a 2a20 696e 7374 616c 6c63 6865 33).* installche │ │ │ │ │ -00045f90: 636b 203c 313e 3a20 2020 2020 2020 2020 ck <1>: │ │ │ │ │ -00045fa0: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -00045fb0: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ -00045fc0: 2020 286c 696e 6520 2034 3129 0a2a 2069 (line 41).* i │ │ │ │ │ -00045fd0: 6e73 7461 6c6c 6368 6563 6b2d 6c6f 6361 nstallcheck-loca │ │ │ │ │ -00045fe0: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ │ -00045ff0: 2020 2020 2020 4578 7465 6e64 696e 672e Extending. │ │ │ │ │ -00046000: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00046010: 2020 3431 290a 2a20 696e 7374 616c 6c64 41).* installd │ │ │ │ │ -00046020: 6972 733a 2020 2020 2020 2020 2020 2020 irs: │ │ │ │ │ -00046030: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ │ -00046040: 6e73 7461 6c6c 2052 756c 6573 2066 6f72 nstall Rules for │ │ │ │ │ -00046050: 2074 6865 2055 7365 722e 0a20 2020 2020 the User.. │ │ │ │ │ +00045f60: 2020 2020 2053 7461 6e64 6172 6420 5461 Standard Ta │ │ │ │ │ +00045f70: 7267 6574 732e 2020 2020 286c 696e 6520 rgets. (line │ │ │ │ │ +00045f80: 2033 3329 0a2a 2069 6e73 7461 6c6c 6368 33).* installch │ │ │ │ │ +00045f90: 6563 6b20 3c31 3e3a 2020 2020 2020 2020 eck <1>: │ │ │ │ │ +00045fa0: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +00045fb0: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ +00045fc0: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ +00045fd0: 696e 7374 616c 6c63 6865 636b 2d6c 6f63 installcheck-loc │ │ │ │ │ +00045fe0: 616c 3a20 2020 2020 2020 2020 2020 2020 al: │ │ │ │ │ +00045ff0: 2020 2020 2020 2045 7874 656e 6469 6e67 Extending │ │ │ │ │ +00046000: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ +00046010: 6520 2034 3129 0a2a 2069 6e73 7461 6c6c e 41).* install │ │ │ │ │ +00046020: 6469 7273 3a20 2020 2020 2020 2020 2020 dirs: │ │ │ │ │ +00046030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00046040: 496e 7374 616c 6c20 5275 6c65 7320 666f Install Rules fo │ │ │ │ │ +00046050: 7220 7468 6520 5573 6572 2e0a 2020 2020 r the User.. │ │ │ │ │ 00046060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046090: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000460a0: 2037 290a 2a20 696e 7374 616c 6c64 6972 7).* installdir │ │ │ │ │ -000460b0: 7320 3c31 3e3a 2020 2020 2020 2020 2020 s <1>: │ │ │ │ │ -000460c0: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -000460d0: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ -000460e0: 2020 286c 696e 6520 2034 3129 0a2a 2069 (line 41).* i │ │ │ │ │ -000460f0: 6e73 7461 6c6c 6469 7273 2d6c 6f63 616c nstalldirs-local │ │ │ │ │ -00046100: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00046110: 2020 2020 2020 4578 7465 6e64 696e 672e Extending. │ │ │ │ │ -00046120: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00046130: 2020 3431 290a 2a20 496e 7374 616c 6c69 41).* Installi │ │ │ │ │ -00046140: 6e67 2068 6561 6465 7273 3a20 2020 2020 ng headers: │ │ │ │ │ -00046150: 2020 2020 2020 2020 2020 2020 2020 2048 H │ │ │ │ │ -00046160: 6561 6465 7273 2e20 2020 2020 2020 2020 eaders. │ │ │ │ │ -00046170: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00046180: 2049 6e73 7461 6c6c 696e 6720 7363 7269 Installing scri │ │ │ │ │ -00046190: 7074 733a 2020 2020 2020 2020 2020 2020 pts: │ │ │ │ │ -000461a0: 2020 2020 2020 2020 5363 7269 7074 732e Scripts. │ │ │ │ │ -000461b0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000461c0: 6e65 2020 2036 290a 2a20 696e 7374 616c ne 6).* instal │ │ │ │ │ -000461d0: 6c69 6e67 2076 6572 7369 6f6e 6564 2062 ling versioned b │ │ │ │ │ -000461e0: 696e 6172 6965 733a 2020 2020 2020 2020 inaries: │ │ │ │ │ -000461f0: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ -00046200: 2020 2020 2020 286c 696e 6520 2038 3629 (line 86) │ │ │ │ │ -00046210: 0a2a 2049 6e74 6572 6661 6369 6e67 2077 .* Interfacing w │ │ │ │ │ -00046220: 6974 6820 7468 6972 642d 7061 7274 7920 ith third-party │ │ │ │ │ -00046230: 7061 636b 6167 6573 3a20 5468 6972 642d packages: Third- │ │ │ │ │ -00046240: 5061 7274 7920 4d61 6b65 6669 6c65 732e Party Makefiles. │ │ │ │ │ -00046250: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00046090: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000460a0: 2020 3729 0a2a 2069 6e73 7461 6c6c 6469 7).* installdi │ │ │ │ │ +000460b0: 7273 203c 313e 3a20 2020 2020 2020 2020 rs <1>: │ │ │ │ │ +000460c0: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +000460d0: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ +000460e0: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ +000460f0: 696e 7374 616c 6c64 6972 732d 6c6f 6361 installdirs-loca │ │ │ │ │ +00046100: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ │ +00046110: 2020 2020 2020 2045 7874 656e 6469 6e67 Extending │ │ │ │ │ +00046120: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ +00046130: 6520 2034 3129 0a2a 2049 6e73 7461 6c6c e 41).* Install │ │ │ │ │ +00046140: 696e 6720 6865 6164 6572 733a 2020 2020 ing headers: │ │ │ │ │ +00046150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00046160: 4865 6164 6572 732e 2020 2020 2020 2020 Headers. │ │ │ │ │ +00046170: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00046180: 2a20 496e 7374 616c 6c69 6e67 2073 6372 * Installing scr │ │ │ │ │ +00046190: 6970 7473 3a20 2020 2020 2020 2020 2020 ipts: │ │ │ │ │ +000461a0: 2020 2020 2020 2020 2053 6372 6970 7473 Scripts │ │ │ │ │ +000461b0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +000461c0: 696e 6520 2020 3629 0a2a 2069 6e73 7461 ine 6).* insta │ │ │ │ │ +000461d0: 6c6c 696e 6720 7665 7273 696f 6e65 6420 lling versioned │ │ │ │ │ +000461e0: 6269 6e61 7269 6573 3a20 2020 2020 2020 binaries: │ │ │ │ │ +000461f0: 2020 4578 7465 6e64 696e 672e 2020 2020 Extending. │ │ │ │ │ +00046200: 2020 2020 2020 2028 6c69 6e65 2020 3836 (line 86 │ │ │ │ │ +00046210: 290a 2a20 496e 7465 7266 6163 696e 6720 ).* Interfacing │ │ │ │ │ +00046220: 7769 7468 2074 6869 7264 2d70 6172 7479 with third-party │ │ │ │ │ +00046230: 2070 6163 6b61 6765 733a 2054 6869 7264 packages: Third │ │ │ │ │ +00046240: 2d50 6172 7479 204d 616b 6566 696c 6573 -Party Makefiles │ │ │ │ │ +00046250: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 00046260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046270: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046280: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00046290: 6c69 6e65 2020 2036 290a 2a20 496e 766f line 6).* Invo │ │ │ │ │ -000462a0: 6361 7469 6f6e 206f 6620 6163 6c6f 6361 cation of acloca │ │ │ │ │ -000462b0: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ │ -000462c0: 2020 2061 636c 6f63 616c 2049 6e76 6f63 aclocal Invoc │ │ │ │ │ -000462d0: 6174 696f 6e2e 2020 286c 696e 6520 2020 ation. (line │ │ │ │ │ -000462e0: 3629 0a2a 2049 6e76 6f63 6174 696f 6e20 6).* Invocation │ │ │ │ │ -000462f0: 6f66 2061 7574 6f6d 616b 653a 2020 2020 of automake: │ │ │ │ │ -00046300: 2020 2020 2020 2020 2020 2020 6175 746f auto │ │ │ │ │ -00046310: 6d61 6b65 2049 6e76 6f63 6174 696f 6e2e make Invocation. │ │ │ │ │ -00046320: 2028 6c69 6e65 2020 2036 290a 2a20 496e (line 6).* In │ │ │ │ │ -00046330: 766f 6b69 6e67 2061 636c 6f63 616c 3a20 voking aclocal: │ │ │ │ │ +00046280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00046290: 286c 696e 6520 2020 3629 0a2a 2049 6e76 (line 6).* Inv │ │ │ │ │ +000462a0: 6f63 6174 696f 6e20 6f66 2061 636c 6f63 ocation of acloc │ │ │ │ │ +000462b0: 616c 3a20 2020 2020 2020 2020 2020 2020 al: │ │ │ │ │ +000462c0: 2020 2020 6163 6c6f 6361 6c20 496e 766f aclocal Invo │ │ │ │ │ +000462d0: 6361 7469 6f6e 2e20 2028 6c69 6e65 2020 cation. (line │ │ │ │ │ +000462e0: 2036 290a 2a20 496e 766f 6361 7469 6f6e 6).* Invocation │ │ │ │ │ +000462f0: 206f 6620 6175 746f 6d61 6b65 3a20 2020 of automake: │ │ │ │ │ +00046300: 2020 2020 2020 2020 2020 2020 2061 7574 aut │ │ │ │ │ +00046310: 6f6d 616b 6520 496e 766f 6361 7469 6f6e omake Invocation │ │ │ │ │ +00046320: 2e20 286c 696e 6520 2020 3629 0a2a 2049 . (line 6).* I │ │ │ │ │ +00046330: 6e76 6f6b 696e 6720 6163 6c6f 6361 6c3a nvoking aclocal: │ │ │ │ │ 00046340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046350: 2020 2020 2061 636c 6f63 616c 2049 6e76 aclocal Inv │ │ │ │ │ -00046360: 6f63 6174 696f 6e2e 2020 286c 696e 6520 ocation. (line │ │ │ │ │ -00046370: 2020 3629 0a2a 2049 6e76 6f6b 696e 6720 6).* Invoking │ │ │ │ │ -00046380: 6175 746f 6d61 6b65 3a20 2020 2020 2020 automake: │ │ │ │ │ -00046390: 2020 2020 2020 2020 2020 2020 2020 6175 au │ │ │ │ │ -000463a0: 746f 6d61 6b65 2049 6e76 6f63 6174 696f tomake Invocatio │ │ │ │ │ -000463b0: 6e2e 2028 6c69 6e65 2020 2036 290a 2a20 n. (line 6).* │ │ │ │ │ -000463c0: 4a41 5641 2070 7269 6d61 7279 2c20 6465 JAVA primary, de │ │ │ │ │ -000463d0: 6669 6e65 643a 2020 2020 2020 2020 2020 fined: │ │ │ │ │ -000463e0: 2020 2020 2020 204a 6176 612e 2020 2020 Java. │ │ │ │ │ -000463f0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00046400: 6520 2020 3629 0a2a 204a 4156 4120 7265 e 6).* JAVA re │ │ │ │ │ -00046410: 7374 7269 6374 696f 6e73 3a20 2020 2020 strictions: │ │ │ │ │ +00046350: 2020 2020 2020 6163 6c6f 6361 6c20 496e aclocal In │ │ │ │ │ +00046360: 766f 6361 7469 6f6e 2e20 2028 6c69 6e65 vocation. (line │ │ │ │ │ +00046370: 2020 2036 290a 2a20 496e 766f 6b69 6e67 6).* Invoking │ │ │ │ │ +00046380: 2061 7574 6f6d 616b 653a 2020 2020 2020 automake: │ │ │ │ │ +00046390: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +000463a0: 7574 6f6d 616b 6520 496e 766f 6361 7469 utomake Invocati │ │ │ │ │ +000463b0: 6f6e 2e20 286c 696e 6520 2020 3629 0a2a on. (line 6).* │ │ │ │ │ +000463c0: 204a 4156 4120 7072 696d 6172 792c 2064 JAVA primary, d │ │ │ │ │ +000463d0: 6566 696e 6564 3a20 2020 2020 2020 2020 efined: │ │ │ │ │ +000463e0: 2020 2020 2020 2020 4a61 7661 2e20 2020 Java. │ │ │ │ │ +000463f0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00046400: 6e65 2020 2036 290a 2a20 4a41 5641 2072 ne 6).* JAVA r │ │ │ │ │ +00046410: 6573 7472 6963 7469 6f6e 733a 2020 2020 estrictions: │ │ │ │ │ 00046420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046430: 4a61 7661 2e20 2020 2020 2020 2020 2020 Java. │ │ │ │ │ -00046440: 2020 2020 2028 6c69 6e65 2020 3235 290a (line 25). │ │ │ │ │ -00046450: 2a20 4a61 7661 2073 7570 706f 7274 2077 * Java support w │ │ │ │ │ -00046460: 6974 6820 6763 6a3a 2020 2020 2020 2020 ith gcj: │ │ │ │ │ -00046470: 2020 2020 2020 2020 204a 6176 6120 5375 Java Su │ │ │ │ │ -00046480: 7070 6f72 7420 7769 7468 2067 636a 2e0a pport with gcj.. │ │ │ │ │ -00046490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00046430: 204a 6176 612e 2020 2020 2020 2020 2020 Java. │ │ │ │ │ +00046440: 2020 2020 2020 286c 696e 6520 2032 3529 (line 25) │ │ │ │ │ +00046450: 0a2a 204a 6176 6120 7375 7070 6f72 7420 .* Java support │ │ │ │ │ +00046460: 7769 7468 2067 636a 3a20 2020 2020 2020 with gcj: │ │ │ │ │ +00046470: 2020 2020 2020 2020 2020 4a61 7661 2053 Java S │ │ │ │ │ +00046480: 7570 706f 7274 2077 6974 6820 6763 6a2e upport with gcj. │ │ │ │ │ +00046490: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 000464a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000464b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000464c0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -000464d0: 696e 6520 2020 3629 0a2a 204a 6176 6120 ine 6).* Java │ │ │ │ │ -000464e0: 746f 2062 7974 6563 6f64 652c 2063 6f6d to bytecode, com │ │ │ │ │ -000464f0: 7069 6c61 7469 6f6e 3a20 2020 2020 2020 pilation: │ │ │ │ │ -00046500: 2020 4a61 7661 2e20 2020 2020 2020 2020 Java. │ │ │ │ │ -00046510: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00046520: 290a 2a20 4a61 7661 2074 6f20 6e61 7469 ).* Java to nati │ │ │ │ │ -00046530: 7665 2063 6f64 652c 2063 6f6d 7069 6c61 ve code, compila │ │ │ │ │ -00046540: 7469 6f6e 3a20 2020 2020 204a 6176 6120 tion: Java │ │ │ │ │ -00046550: 5375 7070 6f72 7420 7769 7468 2067 636a Support with gcj │ │ │ │ │ -00046560: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +000464c0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +000464d0: 6c69 6e65 2020 2036 290a 2a20 4a61 7661 line 6).* Java │ │ │ │ │ +000464e0: 2074 6f20 6279 7465 636f 6465 2c20 636f to bytecode, co │ │ │ │ │ +000464f0: 6d70 696c 6174 696f 6e3a 2020 2020 2020 mpilation: │ │ │ │ │ +00046500: 2020 204a 6176 612e 2020 2020 2020 2020 Java. │ │ │ │ │ +00046510: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00046520: 3629 0a2a 204a 6176 6120 746f 206e 6174 6).* Java to nat │ │ │ │ │ +00046530: 6976 6520 636f 6465 2c20 636f 6d70 696c ive code, compil │ │ │ │ │ +00046540: 6174 696f 6e3a 2020 2020 2020 4a61 7661 ation: Java │ │ │ │ │ +00046550: 2053 7570 706f 7274 2077 6974 6820 6763 Support with gc │ │ │ │ │ +00046560: 6a2e 0a20 2020 2020 2020 2020 2020 2020 j.. │ │ │ │ │ 00046570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046580: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000465a0: 286c 696e 6520 2020 3629 0a2a 206c 617a (line 6).* laz │ │ │ │ │ -000465b0: 7920 7465 7374 2065 7865 6375 7469 6f6e y test execution │ │ │ │ │ -000465c0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000465d0: 2020 2020 5369 6d70 6c65 2054 6573 7473 Simple Tests │ │ │ │ │ -000465e0: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ -000465f0: 7465 7374 732e 0a20 2020 2020 2020 2020 tests.. │ │ │ │ │ +000465a0: 2028 6c69 6e65 2020 2036 290a 2a20 6c61 (line 6).* la │ │ │ │ │ +000465b0: 7a79 2074 6573 7420 6578 6563 7574 696f zy test executio │ │ │ │ │ +000465c0: 6e3a 2020 2020 2020 2020 2020 2020 2020 n: │ │ │ │ │ +000465d0: 2020 2020 2053 696d 706c 6520 5465 7374 Simple Test │ │ │ │ │ +000465e0: 7320 7573 696e 6720 7061 7261 6c6c 656c s using parallel │ │ │ │ │ +000465f0: 2d74 6573 7473 2e0a 2020 2020 2020 2020 -tests.. │ │ │ │ │ 00046600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046630: 2020 2020 2028 6c69 6e65 2031 3137 290a (line 117). │ │ │ │ │ -00046640: 2a20 4c44 4144 4420 616e 6420 2d6c 3a20 * LDADD and -l: │ │ │ │ │ +00046630: 2020 2020 2020 286c 696e 6520 3131 3729 (line 117) │ │ │ │ │ +00046640: 0a2a 204c 4441 4444 2061 6e64 202d 6c3a .* LDADD and -l: │ │ │ │ │ 00046650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046660: 2020 2020 2020 2020 204c 696e 6b69 6e67 Linking │ │ │ │ │ -00046670: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -00046680: 696e 6520 2037 3029 0a2a 204c 4446 4c41 ine 70).* LDFLA │ │ │ │ │ -00046690: 4753 2061 6e64 2041 4d5f 4c44 464c 4147 GS and AM_LDFLAG │ │ │ │ │ -000466a0: 533a 2020 2020 2020 2020 2020 2020 2020 S: │ │ │ │ │ -000466b0: 2020 466c 6167 2056 6172 6961 626c 6573 Flag Variables │ │ │ │ │ -000466c0: 204f 7264 6572 696e 672e 0a20 2020 2020 Ordering.. │ │ │ │ │ +00046660: 2020 2020 2020 2020 2020 4c69 6e6b 696e Linkin │ │ │ │ │ +00046670: 672e 2020 2020 2020 2020 2020 2020 2028 g. ( │ │ │ │ │ +00046680: 6c69 6e65 2020 3730 290a 2a20 4c44 464c line 70).* LDFL │ │ │ │ │ +00046690: 4147 5320 616e 6420 414d 5f4c 4446 4c41 AGS and AM_LDFLA │ │ │ │ │ +000466a0: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ +000466b0: 2020 2046 6c61 6720 5661 7269 6162 6c65 Flag Variable │ │ │ │ │ +000466c0: 7320 4f72 6465 7269 6e67 2e0a 2020 2020 s Ordering.. │ │ │ │ │ 000466d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000466e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000466f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046700: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00046710: 3230 290a 2a20 6c65 7820 7072 6f62 6c65 20).* lex proble │ │ │ │ │ -00046720: 6d73 2077 6974 6820 4850 2d55 5820 3130 ms with HP-UX 10 │ │ │ │ │ -00046730: 3a20 2020 2020 2020 2020 2020 2050 7562 : Pub │ │ │ │ │ -00046740: 6c69 6320 4d61 6372 6f73 2e20 2020 2020 lic Macros. │ │ │ │ │ -00046750: 2020 286c 696e 6520 2039 3929 0a2a 206c (line 99).* l │ │ │ │ │ -00046760: 6578 2c20 6d75 6c74 6970 6c65 206c 6578 ex, multiple lex │ │ │ │ │ -00046770: 6572 733a 2020 2020 2020 2020 2020 2020 ers: │ │ │ │ │ -00046780: 2020 2020 2020 5961 6363 2061 6e64 204c Yacc and L │ │ │ │ │ -00046790: 6578 2e20 2020 2020 2020 2028 6c69 6e65 ex. (line │ │ │ │ │ -000467a0: 2020 3634 290a 2a20 4c46 4c41 4753 2061 64).* LFLAGS a │ │ │ │ │ -000467b0: 6e64 2041 4d5f 4c46 4c41 4753 3a20 2020 nd AM_LFLAGS: │ │ │ │ │ -000467c0: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ -000467d0: 6c61 6720 5661 7269 6162 6c65 7320 4f72 lag Variables Or │ │ │ │ │ -000467e0: 6465 7269 6e67 2e0a 2020 2020 2020 2020 dering.. │ │ │ │ │ +00046700: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00046710: 2032 3029 0a2a 206c 6578 2070 726f 626c 20).* lex probl │ │ │ │ │ +00046720: 656d 7320 7769 7468 2048 502d 5558 2031 ems with HP-UX 1 │ │ │ │ │ +00046730: 303a 2020 2020 2020 2020 2020 2020 5075 0: Pu │ │ │ │ │ +00046740: 626c 6963 204d 6163 726f 732e 2020 2020 blic Macros. │ │ │ │ │ +00046750: 2020 2028 6c69 6e65 2020 3939 290a 2a20 (line 99).* │ │ │ │ │ +00046760: 6c65 782c 206d 756c 7469 706c 6520 6c65 lex, multiple le │ │ │ │ │ +00046770: 7865 7273 3a20 2020 2020 2020 2020 2020 xers: │ │ │ │ │ +00046780: 2020 2020 2020 2059 6163 6320 616e 6420 Yacc and │ │ │ │ │ +00046790: 4c65 782e 2020 2020 2020 2020 286c 696e Lex. (lin │ │ │ │ │ +000467a0: 6520 2036 3429 0a2a 204c 464c 4147 5320 e 64).* LFLAGS │ │ │ │ │ +000467b0: 616e 6420 414d 5f4c 464c 4147 533a 2020 and AM_LFLAGS: │ │ │ │ │ +000467c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000467d0: 466c 6167 2056 6172 6961 626c 6573 204f Flag Variables O │ │ │ │ │ +000467e0: 7264 6572 696e 672e 0a20 2020 2020 2020 rdering.. │ │ │ │ │ 000467f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046820: 2020 2020 2020 286c 696e 6520 2032 3029 (line 20) │ │ │ │ │ -00046830: 0a2a 206c 6962 6c74 646c 2c20 696e 7472 .* libltdl, intr │ │ │ │ │ -00046840: 6f64 7563 7469 6f6e 3a20 2020 2020 2020 oduction: │ │ │ │ │ -00046850: 2020 2020 2020 2020 2020 4c69 6274 6f6f Libtoo │ │ │ │ │ -00046860: 6c20 436f 6e63 6570 742e 2020 2020 2028 l Concept. ( │ │ │ │ │ -00046870: 6c69 6e65 2020 3239 290a 2a20 4c49 424f line 29).* LIBO │ │ │ │ │ -00046880: 424a 5320 616e 6420 616e 7369 326b 6e72 BJS and ansi2knr │ │ │ │ │ -00046890: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000468a0: 2020 2041 4e53 492e 2020 2020 2020 2020 ANSI. │ │ │ │ │ -000468b0: 2020 2020 2020 2020 286c 696e 6520 2035 (line 5 │ │ │ │ │ -000468c0: 3829 0a2a 204c 4942 4f42 4a53 2c20 616e 8).* LIBOBJS, an │ │ │ │ │ -000468d0: 6420 4c69 6274 6f6f 6c3a 2020 2020 2020 d Libtool: │ │ │ │ │ -000468e0: 2020 2020 2020 2020 2020 2020 4c54 4c49 LTLI │ │ │ │ │ -000468f0: 424f 424a 532e 2020 2020 2020 2020 2020 BOBJS. │ │ │ │ │ -00046900: 2028 6c69 6e65 2020 2036 290a 2a20 4c49 (line 6).* LI │ │ │ │ │ -00046910: 424f 424a 532c 2065 7861 6d70 6c65 3a20 BOBJS, example: │ │ │ │ │ +00046820: 2020 2020 2020 2028 6c69 6e65 2020 3230 (line 20 │ │ │ │ │ +00046830: 290a 2a20 6c69 626c 7464 6c2c 2069 6e74 ).* libltdl, int │ │ │ │ │ +00046840: 726f 6475 6374 696f 6e3a 2020 2020 2020 roduction: │ │ │ │ │ +00046850: 2020 2020 2020 2020 2020 204c 6962 746f Libto │ │ │ │ │ +00046860: 6f6c 2043 6f6e 6365 7074 2e20 2020 2020 ol Concept. │ │ │ │ │ +00046870: 286c 696e 6520 2032 3929 0a2a 204c 4942 (line 29).* LIB │ │ │ │ │ +00046880: 4f42 4a53 2061 6e64 2061 6e73 6932 6b6e OBJS and ansi2kn │ │ │ │ │ +00046890: 723a 2020 2020 2020 2020 2020 2020 2020 r: │ │ │ │ │ +000468a0: 2020 2020 414e 5349 2e20 2020 2020 2020 ANSI. │ │ │ │ │ +000468b0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +000468c0: 3538 290a 2a20 4c49 424f 424a 532c 2061 58).* LIBOBJS, a │ │ │ │ │ +000468d0: 6e64 204c 6962 746f 6f6c 3a20 2020 2020 nd Libtool: │ │ │ │ │ +000468e0: 2020 2020 2020 2020 2020 2020 204c 544c LTL │ │ │ │ │ +000468f0: 4942 4f42 4a53 2e20 2020 2020 2020 2020 IBOBJS. │ │ │ │ │ +00046900: 2020 286c 696e 6520 2020 3629 0a2a 204c (line 6).* L │ │ │ │ │ +00046910: 4942 4f42 4a53 2c20 6578 616d 706c 653a IBOBJS, example: │ │ │ │ │ 00046920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046930: 2020 2020 204c 4942 4f42 4a53 2e20 2020 LIBOBJS. │ │ │ │ │ -00046940: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00046950: 2020 3629 0a2a 204c 4942 4f42 4a53 2c20 6).* LIBOBJS, │ │ │ │ │ -00046960: 7370 6563 6961 6c20 6861 6e64 6c69 6e67 special handling │ │ │ │ │ -00046970: 3a20 2020 2020 2020 2020 2020 2020 4c49 : LI │ │ │ │ │ -00046980: 424f 424a 532e 2020 2020 2020 2020 2020 BOBJS. │ │ │ │ │ -00046990: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -000469a0: 4c49 4252 4152 4945 5320 7072 696d 6172 LIBRARIES primar │ │ │ │ │ -000469b0: 792c 2064 6566 696e 6564 3a20 2020 2020 y, defined: │ │ │ │ │ -000469c0: 2020 2020 2020 2041 204c 6962 7261 7279 A Library │ │ │ │ │ -000469d0: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -000469e0: 6520 2020 3629 0a2a 206c 6962 746f 6f6c e 6).* libtool │ │ │ │ │ -000469f0: 2063 6f6e 7665 6e69 656e 6365 206c 6962 convenience lib │ │ │ │ │ -00046a00: 7261 7269 6573 3a20 2020 2020 2020 2020 raries: │ │ │ │ │ -00046a10: 4c69 6274 6f6f 6c20 436f 6e76 656e 6965 Libtool Convenie │ │ │ │ │ -00046a20: 6e63 6520 4c69 6272 6172 6965 732e 0a20 nce Libraries.. │ │ │ │ │ +00046930: 2020 2020 2020 4c49 424f 424a 532e 2020 LIBOBJS. │ │ │ │ │ +00046940: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00046950: 2020 2036 290a 2a20 4c49 424f 424a 532c 6).* LIBOBJS, │ │ │ │ │ +00046960: 2073 7065 6369 616c 2068 616e 646c 696e special handlin │ │ │ │ │ +00046970: 673a 2020 2020 2020 2020 2020 2020 204c g: L │ │ │ │ │ +00046980: 4942 4f42 4a53 2e20 2020 2020 2020 2020 IBOBJS. │ │ │ │ │ +00046990: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +000469a0: 204c 4942 5241 5249 4553 2070 7269 6d61 LIBRARIES prima │ │ │ │ │ +000469b0: 7279 2c20 6465 6669 6e65 643a 2020 2020 ry, defined: │ │ │ │ │ +000469c0: 2020 2020 2020 2020 4120 4c69 6272 6172 A Librar │ │ │ │ │ +000469d0: 792e 2020 2020 2020 2020 2020 2028 6c69 y. (li │ │ │ │ │ +000469e0: 6e65 2020 2036 290a 2a20 6c69 6274 6f6f ne 6).* libtoo │ │ │ │ │ +000469f0: 6c20 636f 6e76 656e 6965 6e63 6520 6c69 l convenience li │ │ │ │ │ +00046a00: 6272 6172 6965 733a 2020 2020 2020 2020 braries: │ │ │ │ │ +00046a10: 204c 6962 746f 6f6c 2043 6f6e 7665 6e69 Libtool Conveni │ │ │ │ │ +00046a20: 656e 6365 204c 6962 7261 7269 6573 2e0a ence Libraries.. │ │ │ │ │ 00046a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046a40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046a50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046a60: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00046a70: 6e65 2020 2036 290a 2a20 6c69 6274 6f6f ne 6).* libtoo │ │ │ │ │ -00046a80: 6c20 6c69 6272 6172 6965 732c 2063 6f6e l libraries, con │ │ │ │ │ -00046a90: 6469 7469 6f6e 616c 3a20 2020 2020 2020 ditional: │ │ │ │ │ -00046aa0: 2043 6f6e 6469 7469 6f6e 616c 204c 6962 Conditional Lib │ │ │ │ │ -00046ab0: 746f 6f6c 204c 6962 7261 7269 6573 2e0a tool Libraries.. │ │ │ │ │ -00046ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00046a60: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00046a70: 696e 6520 2020 3629 0a2a 206c 6962 746f ine 6).* libto │ │ │ │ │ +00046a80: 6f6c 206c 6962 7261 7269 6573 2c20 636f ol libraries, co │ │ │ │ │ +00046a90: 6e64 6974 696f 6e61 6c3a 2020 2020 2020 nditional: │ │ │ │ │ +00046aa0: 2020 436f 6e64 6974 696f 6e61 6c20 4c69 Conditional Li │ │ │ │ │ +00046ab0: 6274 6f6f 6c20 4c69 6272 6172 6965 732e btool Libraries. │ │ │ │ │ +00046ac0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00046ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046ae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046af0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00046b00: 696e 6520 2020 3629 0a2a 206c 6962 746f ine 6).* libto │ │ │ │ │ -00046b10: 6f6c 206c 6962 7261 7279 2c20 6465 6669 ol library, defi │ │ │ │ │ -00046b20: 6e69 7469 6f6e 3a20 2020 2020 2020 2020 nition: │ │ │ │ │ -00046b30: 2020 4c69 6274 6f6f 6c20 436f 6e63 6570 Libtool Concep │ │ │ │ │ -00046b40: 742e 2020 2020 2028 6c69 6e65 2020 2036 t. (line 6 │ │ │ │ │ -00046b50: 290a 2a20 6c69 6274 6f6f 6c20 6d6f 6475 ).* libtool modu │ │ │ │ │ -00046b60: 6c65 733a 2020 2020 2020 2020 2020 2020 les: │ │ │ │ │ -00046b70: 2020 2020 2020 2020 2020 204c 6962 746f Libto │ │ │ │ │ -00046b80: 6f6c 204d 6f64 756c 6573 2e20 2020 2020 ol Modules. │ │ │ │ │ -00046b90: 286c 696e 6520 2020 3629 0a2a 204c 6962 (line 6).* Lib │ │ │ │ │ -00046ba0: 746f 6f6c 206d 6f64 756c 6573 2c20 6465 tool modules, de │ │ │ │ │ -00046bb0: 6661 756c 7420 736f 7572 6365 2065 7861 fault source exa │ │ │ │ │ -00046bc0: 6d70 6c65 3a20 4465 6661 756c 7420 5f53 mple: Default _S │ │ │ │ │ -00046bd0: 4f55 5243 4553 2e20 2028 6c69 6e65 2020 OURCES. (line │ │ │ │ │ -00046be0: 3338 290a 2a20 6c69 6274 6f6f 6c2c 2069 38).* libtool, i │ │ │ │ │ -00046bf0: 6e74 726f 6475 6374 696f 6e3a 2020 2020 ntroduction: │ │ │ │ │ -00046c00: 2020 2020 2020 2020 2020 2020 204c 6962 Lib │ │ │ │ │ -00046c10: 746f 6f6c 2043 6f6e 6365 7074 2e20 2020 tool Concept. │ │ │ │ │ -00046c20: 2020 286c 696e 6520 2020 3629 0a2a 204c (line 6).* L │ │ │ │ │ -00046c30: 4942 544f 4f4c 464c 4147 5320 616e 6420 IBTOOLFLAGS and │ │ │ │ │ -00046c40: 414d 5f4c 4942 544f 4f4c 464c 4147 533a AM_LIBTOOLFLAGS: │ │ │ │ │ -00046c50: 2020 2020 2020 466c 6167 2056 6172 6961 Flag Varia │ │ │ │ │ -00046c60: 626c 6573 204f 7264 6572 696e 672e 0a20 bles Ordering.. │ │ │ │ │ +00046af0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00046b00: 6c69 6e65 2020 2036 290a 2a20 6c69 6274 line 6).* libt │ │ │ │ │ +00046b10: 6f6f 6c20 6c69 6272 6172 792c 2064 6566 ool library, def │ │ │ │ │ +00046b20: 696e 6974 696f 6e3a 2020 2020 2020 2020 inition: │ │ │ │ │ +00046b30: 2020 204c 6962 746f 6f6c 2043 6f6e 6365 Libtool Conce │ │ │ │ │ +00046b40: 7074 2e20 2020 2020 286c 696e 6520 2020 pt. (line │ │ │ │ │ +00046b50: 3629 0a2a 206c 6962 746f 6f6c 206d 6f64 6).* libtool mod │ │ │ │ │ +00046b60: 756c 6573 3a20 2020 2020 2020 2020 2020 ules: │ │ │ │ │ +00046b70: 2020 2020 2020 2020 2020 2020 4c69 6274 Libt │ │ │ │ │ +00046b80: 6f6f 6c20 4d6f 6475 6c65 732e 2020 2020 ool Modules. │ │ │ │ │ +00046b90: 2028 6c69 6e65 2020 2036 290a 2a20 4c69 (line 6).* Li │ │ │ │ │ +00046ba0: 6274 6f6f 6c20 6d6f 6475 6c65 732c 2064 btool modules, d │ │ │ │ │ +00046bb0: 6566 6175 6c74 2073 6f75 7263 6520 6578 efault source ex │ │ │ │ │ +00046bc0: 616d 706c 653a 2044 6566 6175 6c74 205f ample: Default _ │ │ │ │ │ +00046bd0: 534f 5552 4345 532e 2020 286c 696e 6520 SOURCES. (line │ │ │ │ │ +00046be0: 2033 3829 0a2a 206c 6962 746f 6f6c 2c20 38).* libtool, │ │ │ │ │ +00046bf0: 696e 7472 6f64 7563 7469 6f6e 3a20 2020 introduction: │ │ │ │ │ +00046c00: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ │ +00046c10: 6274 6f6f 6c20 436f 6e63 6570 742e 2020 btool Concept. │ │ │ │ │ +00046c20: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +00046c30: 4c49 4254 4f4f 4c46 4c41 4753 2061 6e64 LIBTOOLFLAGS and │ │ │ │ │ +00046c40: 2041 4d5f 4c49 4254 4f4f 4c46 4c41 4753 AM_LIBTOOLFLAGS │ │ │ │ │ +00046c50: 3a20 2020 2020 2046 6c61 6720 5661 7269 : Flag Vari │ │ │ │ │ +00046c60: 6162 6c65 7320 4f72 6465 7269 6e67 2e0a ables Ordering.. │ │ │ │ │ 00046c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046c90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046ca0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00046cb0: 6e65 2020 3230 290a 2a20 6c69 6274 6f6f ne 20).* libtoo │ │ │ │ │ -00046cc0: 6c69 7a65 2061 6e64 2061 7574 6f72 6563 lize and autorec │ │ │ │ │ -00046cd0: 6f6e 663a 2020 2020 2020 2020 2020 2020 onf: │ │ │ │ │ -00046ce0: 2045 7272 6f72 2072 6571 7569 7265 6420 Error required │ │ │ │ │ -00046cf0: 6669 6c65 206c 746d 6169 6e2e 7368 206e file ltmain.sh n │ │ │ │ │ -00046d00: 6f74 2066 6f75 6e64 2e0a 2020 2020 2020 ot found.. │ │ │ │ │ +00046ca0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00046cb0: 696e 6520 2032 3029 0a2a 206c 6962 746f ine 20).* libto │ │ │ │ │ +00046cc0: 6f6c 697a 6520 616e 6420 6175 746f 7265 olize and autore │ │ │ │ │ +00046cd0: 636f 6e66 3a20 2020 2020 2020 2020 2020 conf: │ │ │ │ │ +00046ce0: 2020 4572 726f 7220 7265 7175 6972 6564 Error required │ │ │ │ │ +00046cf0: 2066 696c 6520 6c74 6d61 696e 2e73 6820 file ltmain.sh │ │ │ │ │ +00046d00: 6e6f 7420 666f 756e 642e 0a20 2020 2020 not found.. │ │ │ │ │ 00046d10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046d20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046d40: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ -00046d50: 3629 0a2a 206c 6962 746f 6f6c 697a 652c 6).* libtoolize, │ │ │ │ │ -00046d60: 206e 6f20 6c6f 6e67 6572 2072 756e 2062 no longer run b │ │ │ │ │ -00046d70: 7920 6175 746f 6d61 6b65 3a20 4572 726f y automake: Erro │ │ │ │ │ -00046d80: 7220 7265 7175 6972 6564 2066 696c 6520 r required file │ │ │ │ │ -00046d90: 6c74 6d61 696e 2e73 6820 6e6f 7420 666f ltmain.sh not fo │ │ │ │ │ -00046da0: 756e 642e 0a20 2020 2020 2020 2020 2020 und.. │ │ │ │ │ +00046d40: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00046d50: 2036 290a 2a20 6c69 6274 6f6f 6c69 7a65 6).* libtoolize │ │ │ │ │ +00046d60: 2c20 6e6f 206c 6f6e 6765 7220 7275 6e20 , no longer run │ │ │ │ │ +00046d70: 6279 2061 7574 6f6d 616b 653a 2045 7272 by automake: Err │ │ │ │ │ +00046d80: 6f72 2072 6571 7569 7265 6420 6669 6c65 or required file │ │ │ │ │ +00046d90: 206c 746d 6169 6e2e 7368 206e 6f74 2066 ltmain.sh not f │ │ │ │ │ +00046da0: 6f75 6e64 2e0a 2020 2020 2020 2020 2020 ound.. │ │ │ │ │ 00046db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046dc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046de0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -00046df0: 4c69 6d69 7461 7469 6f6e 7320 6f66 2061 Limitations of a │ │ │ │ │ -00046e00: 7574 6f6d 616b 6520 7061 7273 6572 3a20 utomake parser: │ │ │ │ │ -00046e10: 2020 2020 2020 2047 656e 6572 616c 204f General O │ │ │ │ │ -00046e20: 7065 7261 7469 6f6e 2e20 2020 286c 696e peration. (lin │ │ │ │ │ -00046e30: 6520 2033 3329 0a2a 204c 696e 6b69 6e67 e 33).* Linking │ │ │ │ │ -00046e40: 2046 6f72 7472 616e 2037 3720 7769 7468 Fortran 77 with │ │ │ │ │ -00046e50: 2043 2061 6e64 2043 2b2b 3a20 2020 2020 C and C++: │ │ │ │ │ -00046e60: 4d69 7869 6e67 2046 6f72 7472 616e 2037 Mixing Fortran 7 │ │ │ │ │ -00046e70: 3720 5769 7468 2043 2061 6e64 2043 2b2b 7 With C and C++ │ │ │ │ │ -00046e80: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00046de0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +00046df0: 204c 696d 6974 6174 696f 6e73 206f 6620 Limitations of │ │ │ │ │ +00046e00: 6175 746f 6d61 6b65 2070 6172 7365 723a automake parser: │ │ │ │ │ +00046e10: 2020 2020 2020 2020 4765 6e65 7261 6c20 General │ │ │ │ │ +00046e20: 4f70 6572 6174 696f 6e2e 2020 2028 6c69 Operation. (li │ │ │ │ │ +00046e30: 6e65 2020 3333 290a 2a20 4c69 6e6b 696e ne 33).* Linkin │ │ │ │ │ +00046e40: 6720 466f 7274 7261 6e20 3737 2077 6974 g Fortran 77 wit │ │ │ │ │ +00046e50: 6820 4320 616e 6420 432b 2b3a 2020 2020 h C and C++: │ │ │ │ │ +00046e60: 204d 6978 696e 6720 466f 7274 7261 6e20 Mixing Fortran │ │ │ │ │ +00046e70: 3737 2057 6974 6820 4320 616e 6420 432b 77 With C and C+ │ │ │ │ │ +00046e80: 2b2e 0a20 2020 2020 2020 2020 2020 2020 +.. │ │ │ │ │ 00046e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00046eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046ec0: 286c 696e 6520 2020 3629 0a2a 204c 4953 (line 6).* LIS │ │ │ │ │ -00046ed0: 5020 7072 696d 6172 792c 2064 6566 696e P primary, defin │ │ │ │ │ -00046ee0: 6564 3a20 2020 2020 2020 2020 2020 2020 ed: │ │ │ │ │ -00046ef0: 2020 2020 456d 6163 7320 4c69 7370 2e20 Emacs Lisp. │ │ │ │ │ -00046f00: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00046f10: 2036 290a 2a20 4c4e 5f53 2065 7861 6d70 6).* LN_S examp │ │ │ │ │ -00046f20: 6c65 3a20 2020 2020 2020 2020 2020 2020 le: │ │ │ │ │ -00046f30: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -00046f40: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ -00046f50: 2020 286c 696e 6520 2038 3629 0a2a 206c (line 86).* l │ │ │ │ │ -00046f60: 6f63 616c 2074 6172 6765 7473 3a20 2020 ocal targets: │ │ │ │ │ +00046ec0: 2028 6c69 6e65 2020 2036 290a 2a20 4c49 (line 6).* LI │ │ │ │ │ +00046ed0: 5350 2070 7269 6d61 7279 2c20 6465 6669 SP primary, defi │ │ │ │ │ +00046ee0: 6e65 643a 2020 2020 2020 2020 2020 2020 ned: │ │ │ │ │ +00046ef0: 2020 2020 2045 6d61 6373 204c 6973 702e Emacs Lisp. │ │ │ │ │ +00046f00: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00046f10: 2020 3629 0a2a 204c 4e5f 5320 6578 616d 6).* LN_S exam │ │ │ │ │ +00046f20: 706c 653a 2020 2020 2020 2020 2020 2020 ple: │ │ │ │ │ +00046f30: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +00046f40: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ +00046f50: 2020 2028 6c69 6e65 2020 3836 290a 2a20 (line 86).* │ │ │ │ │ +00046f60: 6c6f 6361 6c20 7461 7267 6574 733a 2020 local targets: │ │ │ │ │ 00046f70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00046f80: 2020 2020 2020 4578 7465 6e64 696e 672e Extending. │ │ │ │ │ -00046f90: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00046fa0: 2020 3337 290a 2a20 4c54 414c 4c4f 4341 37).* LTALLOCA │ │ │ │ │ -00046fb0: 2c20 7370 6563 6961 6c20 6861 6e64 6c69 , special handli │ │ │ │ │ -00046fc0: 6e67 3a20 2020 2020 2020 2020 2020 204c ng: L │ │ │ │ │ -00046fd0: 544c 4942 4f42 4a53 2e20 2020 2020 2020 TLIBOBJS. │ │ │ │ │ -00046fe0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00046ff0: 204c 544c 4942 4f42 4a53 2061 6e64 2061 LTLIBOBJS and a │ │ │ │ │ -00047000: 6e73 6932 6b6e 723a 2020 2020 2020 2020 nsi2knr: │ │ │ │ │ -00047010: 2020 2020 2020 2020 414e 5349 2e20 2020 ANSI. │ │ │ │ │ -00047020: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00047030: 6e65 2020 3538 290a 2a20 4c54 4c49 424f ne 58).* LTLIBO │ │ │ │ │ -00047040: 424a 532c 2073 7065 6369 616c 2068 616e BJS, special han │ │ │ │ │ -00047050: 646c 696e 673a 2020 2020 2020 2020 2020 dling: │ │ │ │ │ -00047060: 204c 544c 4942 4f42 4a53 2e20 2020 2020 LTLIBOBJS. │ │ │ │ │ -00047070: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00047080: 0a2a 204c 544c 4942 5241 5249 4553 2070 .* LTLIBRARIES p │ │ │ │ │ -00047090: 7269 6d61 7279 2c20 6465 6669 6e65 643a rimary, defined: │ │ │ │ │ -000470a0: 2020 2020 2020 2020 2020 4c69 6274 6f6f Libtoo │ │ │ │ │ -000470b0: 6c20 4c69 6272 6172 6965 732e 2020 2028 l Libraries. ( │ │ │ │ │ -000470c0: 6c69 6e65 2020 2036 290a 2a20 6c74 6d61 line 6).* ltma │ │ │ │ │ -000470d0: 696e 2e73 6820 6e6f 7420 666f 756e 643a in.sh not found: │ │ │ │ │ -000470e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000470f0: 2020 2045 7272 6f72 2072 6571 7569 7265 Error require │ │ │ │ │ -00047100: 6420 6669 6c65 206c 746d 6169 6e2e 7368 d file ltmain.sh │ │ │ │ │ -00047110: 206e 6f74 2066 6f75 6e64 2e0a 2020 2020 not found.. │ │ │ │ │ +00046f80: 2020 2020 2020 2045 7874 656e 6469 6e67 Extending │ │ │ │ │ +00046f90: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ +00046fa0: 6520 2033 3729 0a2a 204c 5441 4c4c 4f43 e 37).* LTALLOC │ │ │ │ │ +00046fb0: 412c 2073 7065 6369 616c 2068 616e 646c A, special handl │ │ │ │ │ +00046fc0: 696e 673a 2020 2020 2020 2020 2020 2020 ing: │ │ │ │ │ +00046fd0: 4c54 4c49 424f 424a 532e 2020 2020 2020 LTLIBOBJS. │ │ │ │ │ +00046fe0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00046ff0: 2a20 4c54 4c49 424f 424a 5320 616e 6420 * LTLIBOBJS and │ │ │ │ │ +00047000: 616e 7369 326b 6e72 3a20 2020 2020 2020 ansi2knr: │ │ │ │ │ +00047010: 2020 2020 2020 2020 2041 4e53 492e 2020 ANSI. │ │ │ │ │ +00047020: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00047030: 696e 6520 2035 3829 0a2a 204c 544c 4942 ine 58).* LTLIB │ │ │ │ │ +00047040: 4f42 4a53 2c20 7370 6563 6961 6c20 6861 OBJS, special ha │ │ │ │ │ +00047050: 6e64 6c69 6e67 3a20 2020 2020 2020 2020 ndling: │ │ │ │ │ +00047060: 2020 4c54 4c49 424f 424a 532e 2020 2020 LTLIBOBJS. │ │ │ │ │ +00047070: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00047080: 290a 2a20 4c54 4c49 4252 4152 4945 5320 ).* LTLIBRARIES │ │ │ │ │ +00047090: 7072 696d 6172 792c 2064 6566 696e 6564 primary, defined │ │ │ │ │ +000470a0: 3a20 2020 2020 2020 2020 204c 6962 746f : Libto │ │ │ │ │ +000470b0: 6f6c 204c 6962 7261 7269 6573 2e20 2020 ol Libraries. │ │ │ │ │ +000470c0: 286c 696e 6520 2020 3629 0a2a 206c 746d (line 6).* ltm │ │ │ │ │ +000470d0: 6169 6e2e 7368 206e 6f74 2066 6f75 6e64 ain.sh not found │ │ │ │ │ +000470e0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000470f0: 2020 2020 4572 726f 7220 7265 7175 6972 Error requir │ │ │ │ │ +00047100: 6564 2066 696c 6520 6c74 6d61 696e 2e73 ed file ltmain.s │ │ │ │ │ +00047110: 6820 6e6f 7420 666f 756e 642e 0a20 2020 h not found.. │ │ │ │ │ 00047120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047150: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00047160: 2020 3629 0a2a 206d 345f 696e 636c 7564 6).* m4_includ │ │ │ │ │ -00047170: 652c 2064 6973 7472 6962 7574 696f 6e3a e, distribution: │ │ │ │ │ -00047180: 2020 2020 2020 2020 2020 2020 2020 4261 Ba │ │ │ │ │ -00047190: 7369 6373 206f 6620 4469 7374 7269 6275 sics of Distribu │ │ │ │ │ -000471a0: 7469 6f6e 2e0a 2020 2020 2020 2020 2020 tion.. │ │ │ │ │ +00047150: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00047160: 2020 2036 290a 2a20 6d34 5f69 6e63 6c75 6).* m4_inclu │ │ │ │ │ +00047170: 6465 2c20 6469 7374 7269 6275 7469 6f6e de, distribution │ │ │ │ │ +00047180: 3a20 2020 2020 2020 2020 2020 2020 2042 : B │ │ │ │ │ +00047190: 6173 6963 7320 6f66 2044 6973 7472 6962 asics of Distrib │ │ │ │ │ +000471a0: 7574 696f 6e2e 0a20 2020 2020 2020 2020 ution.. │ │ │ │ │ 000471b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000471c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000471d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000471e0: 2020 2020 286c 696e 6520 2031 3329 0a2a (line 13).* │ │ │ │ │ -000471f0: 204d 6163 726f 2073 6561 7263 6820 7061 Macro search pa │ │ │ │ │ -00047200: 7468 3a20 2020 2020 2020 2020 2020 2020 th: │ │ │ │ │ -00047210: 2020 2020 2020 2020 4d61 6372 6f20 5365 Macro Se │ │ │ │ │ -00047220: 6172 6368 2050 6174 682e 2020 2028 6c69 arch Path. (li │ │ │ │ │ -00047230: 6e65 2020 2036 290a 2a20 6d61 6372 6f20 ne 6).* macro │ │ │ │ │ -00047240: 7365 7269 616c 206e 756d 6265 7273 3a20 serial numbers: │ │ │ │ │ +000471e0: 2020 2020 2028 6c69 6e65 2020 3133 290a (line 13). │ │ │ │ │ +000471f0: 2a20 4d61 6372 6f20 7365 6172 6368 2070 * Macro search p │ │ │ │ │ +00047200: 6174 683a 2020 2020 2020 2020 2020 2020 ath: │ │ │ │ │ +00047210: 2020 2020 2020 2020 204d 6163 726f 2053 Macro S │ │ │ │ │ +00047220: 6561 7263 6820 5061 7468 2e20 2020 286c earch Path. (l │ │ │ │ │ +00047230: 696e 6520 2020 3629 0a2a 206d 6163 726f ine 6).* macro │ │ │ │ │ +00047240: 2073 6572 6961 6c20 6e75 6d62 6572 733a serial numbers: │ │ │ │ │ 00047250: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047260: 2053 6572 6961 6c73 2e20 2020 2020 2020 Serials. │ │ │ │ │ -00047270: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00047280: 0a2a 204d 6163 726f 7320 4175 746f 6d61 .* Macros Automa │ │ │ │ │ -00047290: 6b65 2072 6563 6f67 6e69 7a65 733a 2020 ke recognizes: │ │ │ │ │ -000472a0: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ -000472b0: 616c 2e20 2020 2020 2020 2020 2020 2028 al. ( │ │ │ │ │ -000472c0: 6c69 6e65 2020 2036 290a 2a20 6d61 696e line 6).* main │ │ │ │ │ -000472d0: 7461 696e 6572 2d63 6c65 616e 2d6c 6f63 tainer-clean-loc │ │ │ │ │ -000472e0: 616c 3a20 2020 2020 2020 2020 2020 2020 al: │ │ │ │ │ -000472f0: 2020 2043 6c65 616e 2e20 2020 2020 2020 Clean. │ │ │ │ │ -00047300: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -00047310: 3529 0a2a 206d 616b 6520 6368 6563 6b3a 5).* make check: │ │ │ │ │ -00047320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047330: 2020 2020 2020 2020 2020 2020 5465 7374 Test │ │ │ │ │ -00047340: 732e 2020 2020 2020 2020 2020 2020 2020 s. │ │ │ │ │ -00047350: 2028 6c69 6e65 2020 2036 290a 2a20 6d61 (line 6).* ma │ │ │ │ │ -00047360: 6b65 2063 6c65 616e 2073 7570 706f 7274 ke clean support │ │ │ │ │ -00047370: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00047380: 2020 2020 2043 6c65 616e 2e20 2020 2020 Clean. │ │ │ │ │ -00047390: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -000473a0: 2020 3629 0a2a 206d 616b 6520 6469 7374 6).* make dist │ │ │ │ │ -000473b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000473c0: 2020 2020 2020 2020 2020 2020 2020 4261 Ba │ │ │ │ │ -000473d0: 7369 6373 206f 6620 4469 7374 7269 6275 sics of Distribu │ │ │ │ │ -000473e0: 7469 6f6e 2e0a 2020 2020 2020 2020 2020 tion.. │ │ │ │ │ +00047260: 2020 5365 7269 616c 732e 2020 2020 2020 Serials. │ │ │ │ │ +00047270: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00047280: 290a 2a20 4d61 6372 6f73 2041 7574 6f6d ).* Macros Autom │ │ │ │ │ +00047290: 616b 6520 7265 636f 676e 697a 6573 3a20 ake recognizes: │ │ │ │ │ +000472a0: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ +000472b0: 6e61 6c2e 2020 2020 2020 2020 2020 2020 nal. │ │ │ │ │ +000472c0: 286c 696e 6520 2020 3629 0a2a 206d 6169 (line 6).* mai │ │ │ │ │ +000472d0: 6e74 6169 6e65 722d 636c 6561 6e2d 6c6f ntainer-clean-lo │ │ │ │ │ +000472e0: 6361 6c3a 2020 2020 2020 2020 2020 2020 cal: │ │ │ │ │ +000472f0: 2020 2020 436c 6561 6e2e 2020 2020 2020 Clean. │ │ │ │ │ +00047300: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00047310: 3135 290a 2a20 6d61 6b65 2063 6865 636b 15).* make check │ │ │ │ │ +00047320: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00047330: 2020 2020 2020 2020 2020 2020 2054 6573 Tes │ │ │ │ │ +00047340: 7473 2e20 2020 2020 2020 2020 2020 2020 ts. │ │ │ │ │ +00047350: 2020 286c 696e 6520 2020 3629 0a2a 206d (line 6).* m │ │ │ │ │ +00047360: 616b 6520 636c 6561 6e20 7375 7070 6f72 ake clean suppor │ │ │ │ │ +00047370: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ +00047380: 2020 2020 2020 436c 6561 6e2e 2020 2020 Clean. │ │ │ │ │ +00047390: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +000473a0: 2020 2036 290a 2a20 6d61 6b65 2064 6973 6).* make dis │ │ │ │ │ +000473b0: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ +000473c0: 2020 2020 2020 2020 2020 2020 2020 2042 B │ │ │ │ │ +000473d0: 6173 6963 7320 6f66 2044 6973 7472 6962 asics of Distrib │ │ │ │ │ +000473e0: 7574 696f 6e2e 0a20 2020 2020 2020 2020 ution.. │ │ │ │ │ 000473f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047420: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00047430: 206d 616b 6520 6469 7374 6368 6563 6b3a make distcheck: │ │ │ │ │ -00047440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047450: 2020 2020 2020 2020 4368 6563 6b69 6e67 Checking │ │ │ │ │ -00047460: 2074 6865 2044 6973 7472 6962 7574 696f the Distributio │ │ │ │ │ -00047470: 6e2e 0a20 2020 2020 2020 2020 2020 2020 n.. │ │ │ │ │ +00047420: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00047430: 2a20 6d61 6b65 2064 6973 7463 6865 636b * make distcheck │ │ │ │ │ +00047440: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00047450: 2020 2020 2020 2020 2043 6865 636b 696e Checkin │ │ │ │ │ +00047460: 6720 7468 6520 4469 7374 7269 6275 7469 g the Distributi │ │ │ │ │ +00047470: 6f6e 2e0a 2020 2020 2020 2020 2020 2020 on.. │ │ │ │ │ 00047480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000474a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000474b0: 2028 6c69 6e65 2020 2036 290a 2a20 6d61 (line 6).* ma │ │ │ │ │ -000474c0: 6b65 2064 6973 7463 6c65 616e 2c20 6469 ke distclean, di │ │ │ │ │ -000474d0: 6167 6e6f 7374 6963 3a20 2020 2020 2020 agnostic: │ │ │ │ │ -000474e0: 2020 2020 2064 6973 7463 6c65 616e 6368 distcleanch │ │ │ │ │ -000474f0: 6563 6b2e 2020 2020 2020 286c 696e 6520 eck. (line │ │ │ │ │ -00047500: 2020 3629 0a2a 206d 616b 6520 6469 7374 6).* make dist │ │ │ │ │ -00047510: 636c 6561 6e63 6865 636b 3a20 2020 2020 cleancheck: │ │ │ │ │ -00047520: 2020 2020 2020 2020 2020 2020 2020 4368 Ch │ │ │ │ │ -00047530: 6563 6b69 6e67 2074 6865 2044 6973 7472 ecking the Distr │ │ │ │ │ -00047540: 6962 7574 696f 6e2e 0a20 2020 2020 2020 ibution.. │ │ │ │ │ +000474b0: 2020 286c 696e 6520 2020 3629 0a2a 206d (line 6).* m │ │ │ │ │ +000474c0: 616b 6520 6469 7374 636c 6561 6e2c 2064 ake distclean, d │ │ │ │ │ +000474d0: 6961 676e 6f73 7469 633a 2020 2020 2020 iagnostic: │ │ │ │ │ +000474e0: 2020 2020 2020 6469 7374 636c 6561 6e63 distcleanc │ │ │ │ │ +000474f0: 6865 636b 2e20 2020 2020 2028 6c69 6e65 heck. (line │ │ │ │ │ +00047500: 2020 2036 290a 2a20 6d61 6b65 2064 6973 6).* make dis │ │ │ │ │ +00047510: 7463 6c65 616e 6368 6563 6b3a 2020 2020 tcleancheck: │ │ │ │ │ +00047520: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ +00047530: 6865 636b 696e 6720 7468 6520 4469 7374 hecking the Dist │ │ │ │ │ +00047540: 7269 6275 7469 6f6e 2e0a 2020 2020 2020 ribution.. │ │ │ │ │ 00047550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047580: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00047590: 290a 2a20 6d61 6b65 2064 6973 7475 6e69 ).* make distuni │ │ │ │ │ -000475a0: 6e73 7461 6c6c 6368 6563 6b3a 2020 2020 nstallcheck: │ │ │ │ │ -000475b0: 2020 2020 2020 2020 2020 2043 6865 636b Check │ │ │ │ │ -000475c0: 696e 6720 7468 6520 4469 7374 7269 6275 ing the Distribu │ │ │ │ │ -000475d0: 7469 6f6e 2e0a 2020 2020 2020 2020 2020 tion.. │ │ │ │ │ +00047580: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00047590: 3629 0a2a 206d 616b 6520 6469 7374 756e 6).* make distun │ │ │ │ │ +000475a0: 696e 7374 616c 6c63 6865 636b 3a20 2020 installcheck: │ │ │ │ │ +000475b0: 2020 2020 2020 2020 2020 2020 4368 6563 Chec │ │ │ │ │ +000475c0: 6b69 6e67 2074 6865 2044 6973 7472 6962 king the Distrib │ │ │ │ │ +000475d0: 7574 696f 6e2e 0a20 2020 2020 2020 2020 ution.. │ │ │ │ │ 000475e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000475f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047610: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -00047620: 206d 616b 6520 696e 7374 616c 6c20 7375 make install su │ │ │ │ │ -00047630: 7070 6f72 743a 2020 2020 2020 2020 2020 pport: │ │ │ │ │ -00047640: 2020 2020 2020 2020 496e 7374 616c 6c2e Install. │ │ │ │ │ -00047650: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00047660: 6e65 2020 2036 290a 2a20 6d61 6b65 2069 ne 6).* make i │ │ │ │ │ -00047670: 6e73 7461 6c6c 6368 6563 6b2c 2074 6573 nstallcheck, tes │ │ │ │ │ -00047680: 7469 6e67 202d 2d68 656c 7020 616e 6420 ting --help and │ │ │ │ │ -00047690: 2d2d 7665 7273 696f 6e3a 204f 7074 696f --version: Optio │ │ │ │ │ -000476a0: 6e73 2e20 2020 286c 696e 6520 3135 3229 ns. (line 152) │ │ │ │ │ -000476b0: 0a2a 204d 616b 6520 7275 6c65 732c 206f .* Make rules, o │ │ │ │ │ -000476c0: 7665 7272 6964 696e 673a 2020 2020 2020 verriding: │ │ │ │ │ -000476d0: 2020 2020 2020 2020 2020 4765 6e65 7261 Genera │ │ │ │ │ -000476e0: 6c20 4f70 6572 6174 696f 6e2e 2020 2028 l Operation. ( │ │ │ │ │ -000476f0: 6c69 6e65 2020 3436 290a 2a20 4d61 6b65 line 46).* Make │ │ │ │ │ -00047700: 2074 6172 6765 7473 2c20 6f76 6572 7269 targets, overri │ │ │ │ │ -00047710: 6469 6e67 3a20 2020 2020 2020 2020 2020 ding: │ │ │ │ │ -00047720: 2020 2047 656e 6572 616c 204f 7065 7261 General Opera │ │ │ │ │ -00047730: 7469 6f6e 2e20 2020 286c 696e 6520 2034 tion. (line 4 │ │ │ │ │ -00047740: 3629 0a2a 204d 616b 6566 696c 6520 6672 6).* Makefile fr │ │ │ │ │ -00047750: 6167 6d65 6e74 2c20 696e 636c 7564 696e agment, includin │ │ │ │ │ -00047760: 673a 2020 2020 2020 2020 2020 496e 636c g: Incl │ │ │ │ │ -00047770: 7564 652e 2020 2020 2020 2020 2020 2020 ude. │ │ │ │ │ -00047780: 2028 6c69 6e65 2020 2036 290a 2a20 4d61 (line 6).* Ma │ │ │ │ │ -00047790: 6b65 6669 6c65 2e61 6d2c 2066 6972 7374 kefile.am, first │ │ │ │ │ -000477a0: 206c 696e 653a 2020 2020 2020 2020 2020 line: │ │ │ │ │ -000477b0: 2020 2020 2047 656e 6572 616c 204f 7065 General Ope │ │ │ │ │ -000477c0: 7261 7469 6f6e 2e20 2020 286c 696e 6520 ration. (line │ │ │ │ │ -000477d0: 2037 3429 0a2a 204d 616b 6566 696c 652e 74).* Makefile. │ │ │ │ │ -000477e0: 616d 2c20 4865 6c6c 6f20 576f 726c 643a am, Hello World: │ │ │ │ │ -000477f0: 2020 2020 2020 2020 2020 2020 2020 616d am │ │ │ │ │ -00047800: 6865 6c6c 6f27 7320 4d61 6b65 6669 6c65 hello's Makefile │ │ │ │ │ -00047810: 2e61 6d20 5365 7475 7020 4578 706c 6169 .am Setup Explai │ │ │ │ │ -00047820: 6e65 642e 0a20 2020 2020 2020 2020 2020 ned.. │ │ │ │ │ +00047610: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +00047620: 2a20 6d61 6b65 2069 6e73 7461 6c6c 2073 * make install s │ │ │ │ │ +00047630: 7570 706f 7274 3a20 2020 2020 2020 2020 upport: │ │ │ │ │ +00047640: 2020 2020 2020 2020 2049 6e73 7461 6c6c Install │ │ │ │ │ +00047650: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00047660: 696e 6520 2020 3629 0a2a 206d 616b 6520 ine 6).* make │ │ │ │ │ +00047670: 696e 7374 616c 6c63 6865 636b 2c20 7465 installcheck, te │ │ │ │ │ +00047680: 7374 696e 6720 2d2d 6865 6c70 2061 6e64 sting --help and │ │ │ │ │ +00047690: 202d 2d76 6572 7369 6f6e 3a20 4f70 7469 --version: Opti │ │ │ │ │ +000476a0: 6f6e 732e 2020 2028 6c69 6e65 2031 3532 ons. (line 152 │ │ │ │ │ +000476b0: 290a 2a20 4d61 6b65 2072 756c 6573 2c20 ).* Make rules, │ │ │ │ │ +000476c0: 6f76 6572 7269 6469 6e67 3a20 2020 2020 overriding: │ │ │ │ │ +000476d0: 2020 2020 2020 2020 2020 2047 656e 6572 Gener │ │ │ │ │ +000476e0: 616c 204f 7065 7261 7469 6f6e 2e20 2020 al Operation. │ │ │ │ │ +000476f0: 286c 696e 6520 2034 3629 0a2a 204d 616b (line 46).* Mak │ │ │ │ │ +00047700: 6520 7461 7267 6574 732c 206f 7665 7272 e targets, overr │ │ │ │ │ +00047710: 6964 696e 673a 2020 2020 2020 2020 2020 iding: │ │ │ │ │ +00047720: 2020 2020 4765 6e65 7261 6c20 4f70 6572 General Oper │ │ │ │ │ +00047730: 6174 696f 6e2e 2020 2028 6c69 6e65 2020 ation. (line │ │ │ │ │ +00047740: 3436 290a 2a20 4d61 6b65 6669 6c65 2066 46).* Makefile f │ │ │ │ │ +00047750: 7261 676d 656e 742c 2069 6e63 6c75 6469 ragment, includi │ │ │ │ │ +00047760: 6e67 3a20 2020 2020 2020 2020 2049 6e63 ng: Inc │ │ │ │ │ +00047770: 6c75 6465 2e20 2020 2020 2020 2020 2020 lude. │ │ │ │ │ +00047780: 2020 286c 696e 6520 2020 3629 0a2a 204d (line 6).* M │ │ │ │ │ +00047790: 616b 6566 696c 652e 616d 2c20 6669 7273 akefile.am, firs │ │ │ │ │ +000477a0: 7420 6c69 6e65 3a20 2020 2020 2020 2020 t line: │ │ │ │ │ +000477b0: 2020 2020 2020 4765 6e65 7261 6c20 4f70 General Op │ │ │ │ │ +000477c0: 6572 6174 696f 6e2e 2020 2028 6c69 6e65 eration. (line │ │ │ │ │ +000477d0: 2020 3734 290a 2a20 4d61 6b65 6669 6c65 74).* Makefile │ │ │ │ │ +000477e0: 2e61 6d2c 2048 656c 6c6f 2057 6f72 6c64 .am, Hello World │ │ │ │ │ +000477f0: 3a20 2020 2020 2020 2020 2020 2020 2061 : a │ │ │ │ │ +00047800: 6d68 656c 6c6f 2773 204d 616b 6566 696c mhello's Makefil │ │ │ │ │ +00047810: 652e 616d 2053 6574 7570 2045 7870 6c61 e.am Setup Expla │ │ │ │ │ +00047820: 696e 6564 2e0a 2020 2020 2020 2020 2020 ined.. │ │ │ │ │ 00047830: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047860: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -00047870: 4d61 6e20 7061 6765 2072 656e 616d 696e Man page renamin │ │ │ │ │ -00047880: 672c 2061 766f 6964 696e 673a 2020 2020 g, avoiding: │ │ │ │ │ -00047890: 2020 2020 2020 204d 616e 2050 6167 6573 Man Pages │ │ │ │ │ -000478a0: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -000478b0: 6520 2035 3429 0a2a 204d 414e 5320 7072 e 54).* MANS pr │ │ │ │ │ -000478c0: 696d 6172 792c 2064 6566 696e 6564 3a20 imary, defined: │ │ │ │ │ +00047860: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +00047870: 204d 616e 2070 6167 6520 7265 6e61 6d69 Man page renami │ │ │ │ │ +00047880: 6e67 2c20 6176 6f69 6469 6e67 3a20 2020 ng, avoiding: │ │ │ │ │ +00047890: 2020 2020 2020 2020 4d61 6e20 5061 6765 Man Page │ │ │ │ │ +000478a0: 732e 2020 2020 2020 2020 2020 2028 6c69 s. (li │ │ │ │ │ +000478b0: 6e65 2020 3534 290a 2a20 4d41 4e53 2070 ne 54).* MANS p │ │ │ │ │ +000478c0: 7269 6d61 7279 2c20 6465 6669 6e65 643a rimary, defined: │ │ │ │ │ 000478d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000478e0: 4d61 6e20 5061 6765 732e 2020 2020 2020 Man Pages. │ │ │ │ │ -000478f0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -00047900: 2a20 6d61 6e79 206f 7574 7075 7473 2c20 * many outputs, │ │ │ │ │ -00047910: 7275 6c65 7320 7769 7468 3a20 2020 2020 rules with: │ │ │ │ │ -00047920: 2020 2020 2020 2020 204d 756c 7469 706c Multipl │ │ │ │ │ -00047930: 6520 4f75 7470 7574 732e 2020 2020 286c e Outputs. (l │ │ │ │ │ -00047940: 696e 6520 2020 3629 0a2a 206d 6461 7465 ine 6).* mdate │ │ │ │ │ -00047950: 2d73 683a 2020 2020 2020 2020 2020 2020 -sh: │ │ │ │ │ +000478e0: 204d 616e 2050 6167 6573 2e20 2020 2020 Man Pages. │ │ │ │ │ +000478f0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +00047900: 0a2a 206d 616e 7920 6f75 7470 7574 732c .* many outputs, │ │ │ │ │ +00047910: 2072 756c 6573 2077 6974 683a 2020 2020 rules with: │ │ │ │ │ +00047920: 2020 2020 2020 2020 2020 4d75 6c74 6970 Multip │ │ │ │ │ +00047930: 6c65 204f 7574 7075 7473 2e20 2020 2028 le Outputs. ( │ │ │ │ │ +00047940: 6c69 6e65 2020 2036 290a 2a20 6d64 6174 line 6).* mdat │ │ │ │ │ +00047950: 652d 7368 3a20 2020 2020 2020 2020 2020 e-sh: │ │ │ │ │ 00047960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047970: 2020 5465 7869 6e66 6f2e 2020 2020 2020 Texinfo. │ │ │ │ │ -00047980: 2020 2020 2020 2028 6c69 6e65 2020 3239 (line 29 │ │ │ │ │ -00047990: 290a 2a20 4d69 6e47 5720 6372 6f73 732d ).* MinGW cross- │ │ │ │ │ -000479a0: 636f 6d70 696c 6174 696f 6e20 6578 616d compilation exam │ │ │ │ │ -000479b0: 706c 653a 2020 2020 2020 2043 726f 7373 ple: Cross │ │ │ │ │ -000479c0: 2d43 6f6d 7069 6c61 7469 6f6e 2e20 2020 -Compilation. │ │ │ │ │ -000479d0: 286c 696e 6520 2032 3529 0a2a 206d 6973 (line 25).* mis │ │ │ │ │ -000479e0: 7369 6e67 2c20 7075 7270 6f73 653a 2020 sing, purpose: │ │ │ │ │ +00047970: 2020 2054 6578 696e 666f 2e20 2020 2020 Texinfo. │ │ │ │ │ +00047980: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +00047990: 3929 0a2a 204d 696e 4757 2063 726f 7373 9).* MinGW cross │ │ │ │ │ +000479a0: 2d63 6f6d 7069 6c61 7469 6f6e 2065 7861 -compilation exa │ │ │ │ │ +000479b0: 6d70 6c65 3a20 2020 2020 2020 4372 6f73 mple: Cros │ │ │ │ │ +000479c0: 732d 436f 6d70 696c 6174 696f 6e2e 2020 s-Compilation. │ │ │ │ │ +000479d0: 2028 6c69 6e65 2020 3235 290a 2a20 6d69 (line 25).* mi │ │ │ │ │ +000479e0: 7373 696e 672c 2070 7572 706f 7365 3a20 ssing, purpose: │ │ │ │ │ 000479f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047a00: 2020 2020 6d61 696e 7461 696e 6572 2d6d maintainer-m │ │ │ │ │ -00047a10: 6f64 652e 2020 2020 2028 6c69 6e65 2020 ode. (line │ │ │ │ │ -00047a20: 2039 290a 2a20 4d69 7865 6420 6c61 6e67 9).* Mixed lang │ │ │ │ │ -00047a30: 7561 6765 2065 7861 6d70 6c65 3a20 2020 uage example: │ │ │ │ │ -00047a40: 2020 2020 2020 2020 2020 2020 204d 6978 Mix │ │ │ │ │ -00047a50: 696e 6720 466f 7274 7261 6e20 3737 2057 ing Fortran 77 W │ │ │ │ │ -00047a60: 6974 6820 4320 616e 6420 432b 2b2e 0a20 ith C and C++.. │ │ │ │ │ +00047a00: 2020 2020 206d 6169 6e74 6169 6e65 722d maintainer- │ │ │ │ │ +00047a10: 6d6f 6465 2e20 2020 2020 286c 696e 6520 mode. (line │ │ │ │ │ +00047a20: 2020 3929 0a2a 204d 6978 6564 206c 616e 9).* Mixed lan │ │ │ │ │ +00047a30: 6775 6167 6520 6578 616d 706c 653a 2020 guage example: │ │ │ │ │ +00047a40: 2020 2020 2020 2020 2020 2020 2020 4d69 Mi │ │ │ │ │ +00047a50: 7869 6e67 2046 6f72 7472 616e 2037 3720 xing Fortran 77 │ │ │ │ │ +00047a60: 5769 7468 2043 2061 6e64 2043 2b2b 2e0a With C and C++.. │ │ │ │ │ 00047a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047a80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047aa0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00047ab0: 6e65 2020 3336 290a 2a20 4d69 7869 6e67 ne 36).* Mixing │ │ │ │ │ -00047ac0: 2046 6f72 7472 616e 2037 3720 7769 7468 Fortran 77 with │ │ │ │ │ -00047ad0: 2043 2061 6e64 2043 2b2b 3a20 2020 2020 C and C++: │ │ │ │ │ -00047ae0: 204d 6978 696e 6720 466f 7274 7261 6e20 Mixing Fortran │ │ │ │ │ -00047af0: 3737 2057 6974 6820 4320 616e 6420 432b 77 With C and C+ │ │ │ │ │ -00047b00: 2b2e 0a20 2020 2020 2020 2020 2020 2020 +.. │ │ │ │ │ +00047aa0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00047ab0: 696e 6520 2033 3629 0a2a 204d 6978 696e ine 36).* Mixin │ │ │ │ │ +00047ac0: 6720 466f 7274 7261 6e20 3737 2077 6974 g Fortran 77 wit │ │ │ │ │ +00047ad0: 6820 4320 616e 6420 432b 2b3a 2020 2020 h C and C++: │ │ │ │ │ +00047ae0: 2020 4d69 7869 6e67 2046 6f72 7472 616e Mixing Fortran │ │ │ │ │ +00047af0: 2037 3720 5769 7468 2043 2061 6e64 2043 77 With C and C │ │ │ │ │ +00047b00: 2b2b 2e0a 2020 2020 2020 2020 2020 2020 ++.. │ │ │ │ │ 00047b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047b20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047b40: 2028 6c69 6e65 2020 2036 290a 2a20 4d69 (line 6).* Mi │ │ │ │ │ -00047b50: 7869 6e67 2046 6f72 7472 616e 2037 3720 xing Fortran 77 │ │ │ │ │ -00047b60: 7769 7468 2043 2061 6e64 2f6f 7220 432b with C and/or C+ │ │ │ │ │ -00047b70: 2b3a 2020 204d 6978 696e 6720 466f 7274 +: Mixing Fort │ │ │ │ │ -00047b80: 7261 6e20 3737 2057 6974 6820 4320 616e ran 77 With C an │ │ │ │ │ -00047b90: 6420 432b 2b2e 0a20 2020 2020 2020 2020 d C++.. │ │ │ │ │ +00047b40: 2020 286c 696e 6520 2020 3629 0a2a 204d (line 6).* M │ │ │ │ │ +00047b50: 6978 696e 6720 466f 7274 7261 6e20 3737 ixing Fortran 77 │ │ │ │ │ +00047b60: 2077 6974 6820 4320 616e 642f 6f72 2043 with C and/or C │ │ │ │ │ +00047b70: 2b2b 3a20 2020 4d69 7869 6e67 2046 6f72 ++: Mixing For │ │ │ │ │ +00047b80: 7472 616e 2037 3720 5769 7468 2043 2061 tran 77 With C a │ │ │ │ │ +00047b90: 6e64 2043 2b2b 2e0a 2020 2020 2020 2020 nd C++.. │ │ │ │ │ 00047ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00047bc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047bd0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -00047be0: 2a20 6d6b 6469 7220 2d70 2c20 6d61 6372 * mkdir -p, macr │ │ │ │ │ -00047bf0: 6f20 6368 6563 6b3a 2020 2020 2020 2020 o check: │ │ │ │ │ -00047c00: 2020 2020 2020 2020 204f 6273 6f6c 6574 Obsolet │ │ │ │ │ -00047c10: 6520 4d61 6372 6f73 2e20 2020 2020 286c e Macros. (l │ │ │ │ │ -00047c20: 696e 6520 2033 3429 0a2a 206d 6f64 756c ine 34).* modul │ │ │ │ │ -00047c30: 6573 2c20 6c69 6274 6f6f 6c3a 2020 2020 es, libtool: │ │ │ │ │ +00047bd0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +00047be0: 0a2a 206d 6b64 6972 202d 702c 206d 6163 .* mkdir -p, mac │ │ │ │ │ +00047bf0: 726f 2063 6865 636b 3a20 2020 2020 2020 ro check: │ │ │ │ │ +00047c00: 2020 2020 2020 2020 2020 4f62 736f 6c65 Obsole │ │ │ │ │ +00047c10: 7465 204d 6163 726f 732e 2020 2020 2028 te Macros. ( │ │ │ │ │ +00047c20: 6c69 6e65 2020 3334 290a 2a20 6d6f 6475 line 34).* modu │ │ │ │ │ +00047c30: 6c65 732c 206c 6962 746f 6f6c 3a20 2020 les, libtool: │ │ │ │ │ 00047c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047c50: 2020 4c69 6274 6f6f 6c20 4d6f 6475 6c65 Libtool Module │ │ │ │ │ -00047c60: 732e 2020 2020 2028 6c69 6e65 2020 2036 s. (line 6 │ │ │ │ │ -00047c70: 290a 2a20 6d6f 7374 6c79 636c 6561 6e3a ).* mostlyclean: │ │ │ │ │ -00047c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047c90: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ -00047ca0: 6469 6e67 2e20 2020 2020 2020 2020 2020 ding. │ │ │ │ │ -00047cb0: 286c 696e 6520 2034 3129 0a2a 206d 6f73 (line 41).* mos │ │ │ │ │ -00047cc0: 746c 7963 6c65 616e 2d6c 6f63 616c 3a20 tlyclean-local: │ │ │ │ │ +00047c50: 2020 204c 6962 746f 6f6c 204d 6f64 756c Libtool Modul │ │ │ │ │ +00047c60: 6573 2e20 2020 2020 286c 696e 6520 2020 es. (line │ │ │ │ │ +00047c70: 3629 0a2a 206d 6f73 746c 7963 6c65 616e 6).* mostlyclean │ │ │ │ │ +00047c80: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00047c90: 2020 2020 2020 2020 2020 2020 4578 7465 Exte │ │ │ │ │ +00047ca0: 6e64 696e 672e 2020 2020 2020 2020 2020 nding. │ │ │ │ │ +00047cb0: 2028 6c69 6e65 2020 3431 290a 2a20 6d6f (line 41).* mo │ │ │ │ │ +00047cc0: 7374 6c79 636c 6561 6e2d 6c6f 6361 6c3a stlyclean-local: │ │ │ │ │ 00047cd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047ce0: 2020 2020 436c 6561 6e2e 2020 2020 2020 Clean. │ │ │ │ │ -00047cf0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00047d00: 3135 290a 2a20 6d6f 7374 6c79 636c 6561 15).* mostlyclea │ │ │ │ │ -00047d10: 6e2d 6c6f 6361 6c20 3c31 3e3a 2020 2020 n-local <1>: │ │ │ │ │ -00047d20: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ -00047d30: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ -00047d40: 2020 286c 696e 6520 2034 3129 0a2a 206d (line 41).* m │ │ │ │ │ -00047d50: 756c 7469 706c 6520 636f 6e66 6967 7572 ultiple configur │ │ │ │ │ -00047d60: 6174 696f 6e73 2c20 6578 616d 706c 653a ations, example: │ │ │ │ │ -00047d70: 2020 2020 2020 5650 4154 4820 4275 696c VPATH Buil │ │ │ │ │ -00047d80: 6473 2e20 2020 2020 2020 2028 6c69 6e65 ds. (line │ │ │ │ │ -00047d90: 2020 3436 290a 2a20 4d75 6c74 6970 6c65 46).* Multiple │ │ │ │ │ -00047da0: 2063 6f6e 6669 6775 7265 2e61 6320 6669 configure.ac fi │ │ │ │ │ -00047db0: 6c65 733a 2020 2020 2020 2020 2020 2061 les: a │ │ │ │ │ -00047dc0: 7574 6f6d 616b 6520 496e 766f 6361 7469 utomake Invocati │ │ │ │ │ -00047dd0: 6f6e 2e20 286c 696e 6520 2020 3629 0a2a on. (line 6).* │ │ │ │ │ -00047de0: 204d 756c 7469 706c 6520 6c65 7820 6c65 Multiple lex le │ │ │ │ │ -00047df0: 7865 7273 3a20 2020 2020 2020 2020 2020 xers: │ │ │ │ │ -00047e00: 2020 2020 2020 2020 5961 6363 2061 6e64 Yacc and │ │ │ │ │ -00047e10: 204c 6578 2e20 2020 2020 2020 2028 6c69 Lex. (li │ │ │ │ │ -00047e20: 6e65 2020 3634 290a 2a20 6d75 6c74 6970 ne 64).* multip │ │ │ │ │ -00047e30: 6c65 206f 7574 7075 7473 2c20 7275 6c65 le outputs, rule │ │ │ │ │ -00047e40: 7320 7769 7468 3a20 2020 2020 2020 2020 s with: │ │ │ │ │ -00047e50: 204d 756c 7469 706c 6520 4f75 7470 7574 Multiple Output │ │ │ │ │ -00047e60: 732e 2020 2020 286c 696e 6520 2020 3629 s. (line 6) │ │ │ │ │ -00047e70: 0a2a 204d 756c 7469 706c 6520 7961 6363 .* Multiple yacc │ │ │ │ │ -00047e80: 2070 6172 7365 7273 3a20 2020 2020 2020 parsers: │ │ │ │ │ -00047e90: 2020 2020 2020 2020 2020 5961 6363 2061 Yacc a │ │ │ │ │ -00047ea0: 6e64 204c 6578 2e20 2020 2020 2020 2028 nd Lex. ( │ │ │ │ │ -00047eb0: 6c69 6e65 2020 3634 290a 2a20 4e65 7374 line 64).* Nest │ │ │ │ │ -00047ec0: 6564 2070 6163 6b61 6765 733a 2020 2020 ed packages: │ │ │ │ │ +00047ce0: 2020 2020 2043 6c65 616e 2e20 2020 2020 Clean. │ │ │ │ │ +00047cf0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00047d00: 2031 3529 0a2a 206d 6f73 746c 7963 6c65 15).* mostlycle │ │ │ │ │ +00047d10: 616e 2d6c 6f63 616c 203c 313e 3a20 2020 an-local <1>: │ │ │ │ │ +00047d20: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ +00047d30: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ +00047d40: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ +00047d50: 6d75 6c74 6970 6c65 2063 6f6e 6669 6775 multiple configu │ │ │ │ │ +00047d60: 7261 7469 6f6e 732c 2065 7861 6d70 6c65 rations, example │ │ │ │ │ +00047d70: 3a20 2020 2020 2056 5041 5448 2042 7569 : VPATH Bui │ │ │ │ │ +00047d80: 6c64 732e 2020 2020 2020 2020 286c 696e lds. (lin │ │ │ │ │ +00047d90: 6520 2034 3629 0a2a 204d 756c 7469 706c e 46).* Multipl │ │ │ │ │ +00047da0: 6520 636f 6e66 6967 7572 652e 6163 2066 e configure.ac f │ │ │ │ │ +00047db0: 696c 6573 3a20 2020 2020 2020 2020 2020 iles: │ │ │ │ │ +00047dc0: 6175 746f 6d61 6b65 2049 6e76 6f63 6174 automake Invocat │ │ │ │ │ +00047dd0: 696f 6e2e 2028 6c69 6e65 2020 2036 290a ion. (line 6). │ │ │ │ │ +00047de0: 2a20 4d75 6c74 6970 6c65 206c 6578 206c * Multiple lex l │ │ │ │ │ +00047df0: 6578 6572 733a 2020 2020 2020 2020 2020 exers: │ │ │ │ │ +00047e00: 2020 2020 2020 2020 2059 6163 6320 616e Yacc an │ │ │ │ │ +00047e10: 6420 4c65 782e 2020 2020 2020 2020 286c d Lex. (l │ │ │ │ │ +00047e20: 696e 6520 2036 3429 0a2a 206d 756c 7469 ine 64).* multi │ │ │ │ │ +00047e30: 706c 6520 6f75 7470 7574 732c 2072 756c ple outputs, rul │ │ │ │ │ +00047e40: 6573 2077 6974 683a 2020 2020 2020 2020 es with: │ │ │ │ │ +00047e50: 2020 4d75 6c74 6970 6c65 204f 7574 7075 Multiple Outpu │ │ │ │ │ +00047e60: 7473 2e20 2020 2028 6c69 6e65 2020 2036 ts. (line 6 │ │ │ │ │ +00047e70: 290a 2a20 4d75 6c74 6970 6c65 2079 6163 ).* Multiple yac │ │ │ │ │ +00047e80: 6320 7061 7273 6572 733a 2020 2020 2020 c parsers: │ │ │ │ │ +00047e90: 2020 2020 2020 2020 2020 2059 6163 6320 Yacc │ │ │ │ │ +00047ea0: 616e 6420 4c65 782e 2020 2020 2020 2020 and Lex. │ │ │ │ │ +00047eb0: 286c 696e 6520 2036 3429 0a2a 204e 6573 (line 64).* Nes │ │ │ │ │ +00047ec0: 7465 6420 7061 636b 6167 6573 3a20 2020 ted packages: │ │ │ │ │ 00047ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047ee0: 2020 204e 6573 7465 6420 5061 636b 6167 Nested Packag │ │ │ │ │ -00047ef0: 6573 2e20 2020 2020 286c 696e 6520 2020 es. (line │ │ │ │ │ -00047f00: 3629 0a2a 204e 6573 7469 6e67 2070 6163 6).* Nesting pac │ │ │ │ │ -00047f10: 6b61 6765 733a 2020 2020 2020 2020 2020 kages: │ │ │ │ │ -00047f20: 2020 2020 2020 2020 2020 2020 5375 6270 Subp │ │ │ │ │ -00047f30: 6163 6b61 6765 732e 2020 2020 2020 2020 ackages. │ │ │ │ │ -00047f40: 2028 6c69 6e65 2020 2036 290a 2a20 6e6f (line 6).* no │ │ │ │ │ -00047f50: 2d64 6566 696e 653a 2020 2020 2020 2020 -define: │ │ │ │ │ +00047ee0: 2020 2020 4e65 7374 6564 2050 6163 6b61 Nested Packa │ │ │ │ │ +00047ef0: 6765 732e 2020 2020 2028 6c69 6e65 2020 ges. (line │ │ │ │ │ +00047f00: 2036 290a 2a20 4e65 7374 696e 6720 7061 6).* Nesting pa │ │ │ │ │ +00047f10: 636b 6167 6573 3a20 2020 2020 2020 2020 ckages: │ │ │ │ │ +00047f20: 2020 2020 2020 2020 2020 2020 2053 7562 Sub │ │ │ │ │ +00047f30: 7061 636b 6167 6573 2e20 2020 2020 2020 packages. │ │ │ │ │ +00047f40: 2020 286c 696e 6520 2020 3629 0a2a 206e (line 6).* n │ │ │ │ │ +00047f50: 6f2d 6465 6669 6e65 3a20 2020 2020 2020 o-define: │ │ │ │ │ 00047f60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00047f70: 2020 2020 2050 7562 6c69 6320 4d61 6372 Public Macr │ │ │ │ │ -00047f80: 6f73 2e20 2020 2020 2020 286c 696e 6520 os. (line │ │ │ │ │ -00047f90: 2036 3029 0a2a 206e 6f2d 6465 6669 6e65 60).* no-define │ │ │ │ │ -00047fa0: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ -00047fb0: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ -00047fc0: 7469 6f6e 732e 2020 2020 2020 2020 2020 tions. │ │ │ │ │ -00047fd0: 2020 2028 6c69 6e65 2020 3738 290a 2a20 (line 78).* │ │ │ │ │ -00047fe0: 6e6f 2d64 6570 656e 6465 6e63 6965 733a no-dependencies: │ │ │ │ │ -00047ff0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048000: 2020 2020 2020 2044 6570 656e 6465 6e63 Dependenc │ │ │ │ │ -00048010: 6965 732e 2020 2020 2020 2020 286c 696e ies. (lin │ │ │ │ │ -00048020: 6520 2033 3329 0a2a 206e 6f2d 6465 7065 e 33).* no-depe │ │ │ │ │ -00048030: 6e64 656e 6369 6573 203c 313e 3a20 2020 ndencies <1>: │ │ │ │ │ +00047f70: 2020 2020 2020 5075 626c 6963 204d 6163 Public Mac │ │ │ │ │ +00047f80: 726f 732e 2020 2020 2020 2028 6c69 6e65 ros. (line │ │ │ │ │ +00047f90: 2020 3630 290a 2a20 6e6f 2d64 6566 696e 60).* no-defin │ │ │ │ │ +00047fa0: 6520 3c31 3e3a 2020 2020 2020 2020 2020 e <1>: │ │ │ │ │ +00047fb0: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +00047fc0: 7074 696f 6e73 2e20 2020 2020 2020 2020 ptions. │ │ │ │ │ +00047fd0: 2020 2020 286c 696e 6520 2037 3829 0a2a (line 78).* │ │ │ │ │ +00047fe0: 206e 6f2d 6465 7065 6e64 656e 6369 6573 no-dependencies │ │ │ │ │ +00047ff0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00048000: 2020 2020 2020 2020 4465 7065 6e64 656e Dependen │ │ │ │ │ +00048010: 6369 6573 2e20 2020 2020 2020 2028 6c69 cies. (li │ │ │ │ │ +00048020: 6e65 2020 3333 290a 2a20 6e6f 2d64 6570 ne 33).* no-dep │ │ │ │ │ +00048030: 656e 6465 6e63 6965 7320 3c31 3e3a 2020 endencies <1>: │ │ │ │ │ 00048040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048050: 4f70 7469 6f6e 732e 2020 2020 2020 2020 Options. │ │ │ │ │ -00048060: 2020 2020 2028 6c69 6e65 2020 3833 290a (line 83). │ │ │ │ │ -00048070: 2a20 6e6f 2d64 6973 743a 2020 2020 2020 * no-dist: │ │ │ │ │ +00048050: 204f 7074 696f 6e73 2e20 2020 2020 2020 Options. │ │ │ │ │ +00048060: 2020 2020 2020 286c 696e 6520 2038 3329 (line 83) │ │ │ │ │ +00048070: 0a2a 206e 6f2d 6469 7374 3a20 2020 2020 .* no-dist: │ │ │ │ │ 00048080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048090: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ -000480a0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -000480b0: 696e 6520 2039 3029 0a2a 206e 6f2d 6469 ine 90).* no-di │ │ │ │ │ -000480c0: 7374 2d67 7a69 703a 2020 2020 2020 2020 st-gzip: │ │ │ │ │ +00048090: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +000480a0: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ +000480b0: 6c69 6e65 2020 3930 290a 2a20 6e6f 2d64 line 90).* no-d │ │ │ │ │ +000480c0: 6973 742d 677a 6970 3a20 2020 2020 2020 ist-gzip: │ │ │ │ │ 000480d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000480e0: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ -000480f0: 2020 2020 2020 2028 6c69 6e65 2020 3934 (line 94 │ │ │ │ │ -00048100: 290a 2a20 6e6f 2d64 6973 742d 677a 6970 ).* no-dist-gzip │ │ │ │ │ -00048110: 203c 313e 3a20 2020 2020 2020 2020 2020 <1>: │ │ │ │ │ -00048120: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00048130: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00048140: 286c 696e 6520 2039 3429 0a2a 206e 6f2d (line 94).* no- │ │ │ │ │ -00048150: 6578 6565 7874 3a20 2020 2020 2020 2020 exeext: │ │ │ │ │ +000480e0: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ +000480f0: 2020 2020 2020 2020 286c 696e 6520 2039 (line 9 │ │ │ │ │ +00048100: 3429 0a2a 206e 6f2d 6469 7374 2d67 7a69 4).* no-dist-gzi │ │ │ │ │ +00048110: 7020 3c31 3e3a 2020 2020 2020 2020 2020 p <1>: │ │ │ │ │ +00048120: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00048130: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00048140: 2028 6c69 6e65 2020 3934 290a 2a20 6e6f (line 94).* no │ │ │ │ │ +00048150: 2d65 7865 6578 743a 2020 2020 2020 2020 -exeext: │ │ │ │ │ 00048160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048170: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -00048180: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00048190: 3937 290a 2a20 6e6f 2d69 6e73 7461 6c6c 97).* no-install │ │ │ │ │ -000481a0: 696e 666f 3a20 2020 2020 2020 2020 2020 info: │ │ │ │ │ -000481b0: 2020 2020 2020 2020 2020 2020 2054 6578 Tex │ │ │ │ │ -000481c0: 696e 666f 2e20 2020 2020 2020 2020 2020 info. │ │ │ │ │ -000481d0: 2020 286c 696e 6520 2037 3929 0a2a 206e (line 79).* n │ │ │ │ │ -000481e0: 6f2d 696e 7374 616c 6c69 6e66 6f20 3c31 o-installinfo <1 │ │ │ │ │ -000481f0: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ -00048200: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ -00048210: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00048220: 2031 3037 290a 2a20 6e6f 2d69 6e73 7461 107).* no-insta │ │ │ │ │ -00048230: 6c6c 696e 666f 206f 7074 696f 6e3a 2020 llinfo option: │ │ │ │ │ -00048240: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -00048250: 6578 696e 666f 2e20 2020 2020 2020 2020 exinfo. │ │ │ │ │ -00048260: 2020 2020 286c 696e 6520 2037 3929 0a2a (line 79).* │ │ │ │ │ -00048270: 206e 6f2d 696e 7374 616c 6c6d 616e 3a20 no-installman: │ │ │ │ │ +00048170: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ +00048180: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00048190: 2039 3729 0a2a 206e 6f2d 696e 7374 616c 97).* no-instal │ │ │ │ │ +000481a0: 6c69 6e66 6f3a 2020 2020 2020 2020 2020 linfo: │ │ │ │ │ +000481b0: 2020 2020 2020 2020 2020 2020 2020 5465 Te │ │ │ │ │ +000481c0: 7869 6e66 6f2e 2020 2020 2020 2020 2020 xinfo. │ │ │ │ │ +000481d0: 2020 2028 6c69 6e65 2020 3739 290a 2a20 (line 79).* │ │ │ │ │ +000481e0: 6e6f 2d69 6e73 7461 6c6c 696e 666f 203c no-installinfo < │ │ │ │ │ +000481f0: 313e 3a20 2020 2020 2020 2020 2020 2020 1>: │ │ │ │ │ +00048200: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ +00048210: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00048220: 6520 3130 3729 0a2a 206e 6f2d 696e 7374 e 107).* no-inst │ │ │ │ │ +00048230: 616c 6c69 6e66 6f20 6f70 7469 6f6e 3a20 allinfo option: │ │ │ │ │ +00048240: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00048250: 5465 7869 6e66 6f2e 2020 2020 2020 2020 Texinfo. │ │ │ │ │ +00048260: 2020 2020 2028 6c69 6e65 2020 3739 290a (line 79). │ │ │ │ │ +00048270: 2a20 6e6f 2d69 6e73 7461 6c6c 6d61 6e3a * no-installman: │ │ │ │ │ 00048280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048290: 2020 2020 2020 2020 4d61 6e20 5061 6765 Man Page │ │ │ │ │ -000482a0: 732e 2020 2020 2020 2020 2020 2028 6c69 s. (li │ │ │ │ │ -000482b0: 6e65 2020 3332 290a 2a20 6e6f 2d69 6e73 ne 32).* no-ins │ │ │ │ │ -000482c0: 7461 6c6c 6d61 6e20 3c31 3e3a 2020 2020 tallman <1>: │ │ │ │ │ +00048290: 2020 2020 2020 2020 204d 616e 2050 6167 Man Pag │ │ │ │ │ +000482a0: 6573 2e20 2020 2020 2020 2020 2020 286c es. (l │ │ │ │ │ +000482b0: 696e 6520 2033 3229 0a2a 206e 6f2d 696e ine 32).* no-in │ │ │ │ │ +000482c0: 7374 616c 6c6d 616e 203c 313e 3a20 2020 stallman <1>: │ │ │ │ │ 000482d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000482e0: 204f 7074 696f 6e73 2e20 2020 2020 2020 Options. │ │ │ │ │ -000482f0: 2020 2020 2020 286c 696e 6520 3131 3329 (line 113) │ │ │ │ │ -00048300: 0a2a 206e 6f2d 696e 7374 616c 6c6d 616e .* no-installman │ │ │ │ │ -00048310: 206f 7074 696f 6e3a 2020 2020 2020 2020 option: │ │ │ │ │ -00048320: 2020 2020 2020 2020 2020 4d61 6e20 5061 Man Pa │ │ │ │ │ -00048330: 6765 732e 2020 2020 2020 2020 2020 2028 ges. ( │ │ │ │ │ -00048340: 6c69 6e65 2020 3332 290a 2a20 6e6f 2d74 line 32).* no-t │ │ │ │ │ -00048350: 6578 696e 666f 2e74 6578 3a20 2020 2020 exinfo.tex: │ │ │ │ │ +000482e0: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ +000482f0: 2020 2020 2020 2028 6c69 6e65 2031 3133 (line 113 │ │ │ │ │ +00048300: 290a 2a20 6e6f 2d69 6e73 7461 6c6c 6d61 ).* no-installma │ │ │ │ │ +00048310: 6e20 6f70 7469 6f6e 3a20 2020 2020 2020 n option: │ │ │ │ │ +00048320: 2020 2020 2020 2020 2020 204d 616e 2050 Man P │ │ │ │ │ +00048330: 6167 6573 2e20 2020 2020 2020 2020 2020 ages. │ │ │ │ │ +00048340: 286c 696e 6520 2033 3229 0a2a 206e 6f2d (line 32).* no- │ │ │ │ │ +00048350: 7465 7869 6e66 6f2e 7465 783a 2020 2020 texinfo.tex: │ │ │ │ │ 00048360: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048370: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ -00048380: 2020 2020 2020 2020 286c 696e 6520 3132 (line 12 │ │ │ │ │ -00048390: 3329 0a2a 206e 6f62 6173 655f 2061 6e64 3).* nobase_ and │ │ │ │ │ -000483a0: 2064 6973 745f 206f 7220 6e6f 6469 7374 dist_ or nodist │ │ │ │ │ -000483b0: 5f3a 2020 2020 2020 2020 2020 416c 7465 _: Alte │ │ │ │ │ -000483c0: 726e 6174 6976 652e 2020 2020 2020 2020 rnative. │ │ │ │ │ -000483d0: 2028 6c69 6e65 2020 3239 290a 2a20 6e6f (line 29).* no │ │ │ │ │ -000483e0: 6261 7365 5f20 7072 6566 6978 3a20 2020 base_ prefix: │ │ │ │ │ +00048370: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ +00048380: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +00048390: 3233 290a 2a20 6e6f 6261 7365 5f20 616e 23).* nobase_ an │ │ │ │ │ +000483a0: 6420 6469 7374 5f20 6f72 206e 6f64 6973 d dist_ or nodis │ │ │ │ │ +000483b0: 745f 3a20 2020 2020 2020 2020 2041 6c74 t_: Alt │ │ │ │ │ +000483c0: 6572 6e61 7469 7665 2e20 2020 2020 2020 ernative. │ │ │ │ │ +000483d0: 2020 286c 696e 6520 2032 3929 0a2a 206e (line 29).* n │ │ │ │ │ +000483e0: 6f62 6173 655f 2070 7265 6669 783a 2020 obase_ prefix: │ │ │ │ │ 000483f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048400: 2020 2020 2041 6c74 6572 6e61 7469 7665 Alternative │ │ │ │ │ -00048410: 2e20 2020 2020 2020 2020 286c 696e 6520 . (line │ │ │ │ │ -00048420: 2032 3329 0a2a 206e 6f64 6973 745f 2061 23).* nodist_ a │ │ │ │ │ -00048430: 6e64 206e 6f62 6173 655f 3a20 2020 2020 nd nobase_: │ │ │ │ │ -00048440: 2020 2020 2020 2020 2020 2020 2020 416c Al │ │ │ │ │ -00048450: 7465 726e 6174 6976 652e 2020 2020 2020 ternative. │ │ │ │ │ -00048460: 2020 2028 6c69 6e65 2020 3239 290a 2a20 (line 29).* │ │ │ │ │ -00048470: 6e6f 6469 7374 5f20 616e 6420 6e6f 7472 nodist_ and notr │ │ │ │ │ -00048480: 616e 735f 3a20 2020 2020 2020 2020 2020 ans_: │ │ │ │ │ -00048490: 2020 2020 2020 204d 616e 2050 6167 6573 Man Pages │ │ │ │ │ -000484a0: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -000484b0: 6520 2036 3329 0a2a 206e 6f69 6e73 745f e 63).* noinst_ │ │ │ │ │ -000484c0: 2070 7269 6d61 7279 2070 7265 6669 782c primary prefix, │ │ │ │ │ -000484d0: 2064 6566 696e 6974 696f 6e3a 2020 2020 definition: │ │ │ │ │ -000484e0: 556e 6966 6f72 6d2e 2020 2020 2020 2020 Uniform. │ │ │ │ │ -000484f0: 2020 2020 2028 6c69 6e65 2020 3931 290a (line 91). │ │ │ │ │ -00048500: 2a20 4e6f 6e2d 474e 5520 7061 636b 6167 * Non-GNU packag │ │ │ │ │ -00048510: 6573 3a20 2020 2020 2020 2020 2020 2020 es: │ │ │ │ │ -00048520: 2020 2020 2020 2020 2053 7472 6963 746e Strictn │ │ │ │ │ -00048530: 6573 732e 2020 2020 2020 2020 2020 286c ess. (l │ │ │ │ │ -00048540: 696e 6520 2020 3629 0a2a 204e 6f6e 2d73 ine 6).* Non-s │ │ │ │ │ -00048550: 7461 6e64 6172 6420 7461 7267 6574 733a tandard targets: │ │ │ │ │ -00048560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048570: 2020 4765 6e65 7261 6c20 4f70 6572 6174 General Operat │ │ │ │ │ -00048580: 696f 6e2e 2020 2028 6c69 6e65 2020 3132 ion. (line 12 │ │ │ │ │ -00048590: 290a 2a20 6e6f 7374 6469 6e63 3a20 2020 ).* nostdinc: │ │ │ │ │ +00048400: 2020 2020 2020 416c 7465 726e 6174 6976 Alternativ │ │ │ │ │ +00048410: 652e 2020 2020 2020 2020 2028 6c69 6e65 e. (line │ │ │ │ │ +00048420: 2020 3233 290a 2a20 6e6f 6469 7374 5f20 23).* nodist_ │ │ │ │ │ +00048430: 616e 6420 6e6f 6261 7365 5f3a 2020 2020 and nobase_: │ │ │ │ │ +00048440: 2020 2020 2020 2020 2020 2020 2020 2041 A │ │ │ │ │ +00048450: 6c74 6572 6e61 7469 7665 2e20 2020 2020 lternative. │ │ │ │ │ +00048460: 2020 2020 286c 696e 6520 2032 3929 0a2a (line 29).* │ │ │ │ │ +00048470: 206e 6f64 6973 745f 2061 6e64 206e 6f74 nodist_ and not │ │ │ │ │ +00048480: 7261 6e73 5f3a 2020 2020 2020 2020 2020 rans_: │ │ │ │ │ +00048490: 2020 2020 2020 2020 4d61 6e20 5061 6765 Man Page │ │ │ │ │ +000484a0: 732e 2020 2020 2020 2020 2020 2028 6c69 s. (li │ │ │ │ │ +000484b0: 6e65 2020 3633 290a 2a20 6e6f 696e 7374 ne 63).* noinst │ │ │ │ │ +000484c0: 5f20 7072 696d 6172 7920 7072 6566 6978 _ primary prefix │ │ │ │ │ +000484d0: 2c20 6465 6669 6e69 7469 6f6e 3a20 2020 , definition: │ │ │ │ │ +000484e0: 2055 6e69 666f 726d 2e20 2020 2020 2020 Uniform. │ │ │ │ │ +000484f0: 2020 2020 2020 286c 696e 6520 2039 3129 (line 91) │ │ │ │ │ +00048500: 0a2a 204e 6f6e 2d47 4e55 2070 6163 6b61 .* Non-GNU packa │ │ │ │ │ +00048510: 6765 733a 2020 2020 2020 2020 2020 2020 ges: │ │ │ │ │ +00048520: 2020 2020 2020 2020 2020 5374 7269 6374 Strict │ │ │ │ │ +00048530: 6e65 7373 2e20 2020 2020 2020 2020 2028 ness. ( │ │ │ │ │ +00048540: 6c69 6e65 2020 2036 290a 2a20 4e6f 6e2d line 6).* Non- │ │ │ │ │ +00048550: 7374 616e 6461 7264 2074 6172 6765 7473 standard targets │ │ │ │ │ +00048560: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00048570: 2020 2047 656e 6572 616c 204f 7065 7261 General Opera │ │ │ │ │ +00048580: 7469 6f6e 2e20 2020 286c 696e 6520 2031 tion. (line 1 │ │ │ │ │ +00048590: 3229 0a2a 206e 6f73 7464 696e 633a 2020 2).* nostdinc: │ │ │ │ │ 000485a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000485b0: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -000485c0: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -000485d0: 286c 696e 6520 3131 3929 0a2a 206e 6f74 (line 119).* not │ │ │ │ │ -000485e0: 7261 6e73 5f20 616e 6420 6469 7374 5f20 rans_ and dist_ │ │ │ │ │ -000485f0: 6f72 206e 6f64 6973 745f 3a20 2020 2020 or nodist_: │ │ │ │ │ -00048600: 2020 2020 4d61 6e20 5061 6765 732e 2020 Man Pages. │ │ │ │ │ -00048610: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00048620: 3633 290a 2a20 6e6f 7472 616e 735f 2070 63).* notrans_ p │ │ │ │ │ -00048630: 7265 6669 783a 2020 2020 2020 2020 2020 refix: │ │ │ │ │ -00048640: 2020 2020 2020 2020 2020 2020 204d 616e Man │ │ │ │ │ -00048650: 2050 6167 6573 2e20 2020 2020 2020 2020 Pages. │ │ │ │ │ -00048660: 2020 286c 696e 6520 2035 3429 0a2a 204f (line 54).* O │ │ │ │ │ -00048670: 424a 4346 4c41 4753 2061 6e64 2041 4d5f BJCFLAGS and AM_ │ │ │ │ │ -00048680: 4f42 4a43 464c 4147 533a 2020 2020 2020 OBJCFLAGS: │ │ │ │ │ -00048690: 2020 2020 2020 466c 6167 2056 6172 6961 Flag Varia │ │ │ │ │ -000486a0: 626c 6573 204f 7264 6572 696e 672e 0a20 bles Ordering.. │ │ │ │ │ +000485b0: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +000485c0: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +000485d0: 2028 6c69 6e65 2031 3139 290a 2a20 6e6f (line 119).* no │ │ │ │ │ +000485e0: 7472 616e 735f 2061 6e64 2064 6973 745f trans_ and dist_ │ │ │ │ │ +000485f0: 206f 7220 6e6f 6469 7374 5f3a 2020 2020 or nodist_: │ │ │ │ │ +00048600: 2020 2020 204d 616e 2050 6167 6573 2e20 Man Pages. │ │ │ │ │ +00048610: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00048620: 2036 3329 0a2a 206e 6f74 7261 6e73 5f20 63).* notrans_ │ │ │ │ │ +00048630: 7072 6566 6978 3a20 2020 2020 2020 2020 prefix: │ │ │ │ │ +00048640: 2020 2020 2020 2020 2020 2020 2020 4d61 Ma │ │ │ │ │ +00048650: 6e20 5061 6765 732e 2020 2020 2020 2020 n Pages. │ │ │ │ │ +00048660: 2020 2028 6c69 6e65 2020 3534 290a 2a20 (line 54).* │ │ │ │ │ +00048670: 4f42 4a43 464c 4147 5320 616e 6420 414d OBJCFLAGS and AM │ │ │ │ │ +00048680: 5f4f 424a 4346 4c41 4753 3a20 2020 2020 _OBJCFLAGS: │ │ │ │ │ +00048690: 2020 2020 2020 2046 6c61 6720 5661 7269 Flag Vari │ │ │ │ │ +000486a0: 6162 6c65 7320 4f72 6465 7269 6e67 2e0a ables Ordering.. │ │ │ │ │ 000486b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000486c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000486d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000486e0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000486f0: 6e65 2020 3230 290a 2a20 4f62 6a65 6374 ne 20).* Object │ │ │ │ │ -00048700: 6976 6520 4320 7375 7070 6f72 743a 2020 ive C support: │ │ │ │ │ +000486e0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +000486f0: 696e 6520 2032 3029 0a2a 204f 626a 6563 ine 20).* Objec │ │ │ │ │ +00048700: 7469 7665 2043 2073 7570 706f 7274 3a20 tive C support: │ │ │ │ │ 00048710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048720: 204f 626a 6563 7469 7665 2043 2053 7570 Objective C Sup │ │ │ │ │ -00048730: 706f 7274 2e20 286c 696e 6520 2020 3629 port. (line 6) │ │ │ │ │ -00048740: 0a2a 204f 626a 6563 7473 2069 6e20 7375 .* Objects in su │ │ │ │ │ -00048750: 6264 6972 6563 746f 7279 3a20 2020 2020 bdirectory: │ │ │ │ │ -00048760: 2020 2020 2020 2020 2020 5072 6f67 7261 Progra │ │ │ │ │ -00048770: 6d20 616e 6420 4c69 6272 6172 7920 5661 m and Library Va │ │ │ │ │ -00048780: 7269 6162 6c65 732e 0a20 2020 2020 2020 riables.. │ │ │ │ │ +00048720: 2020 4f62 6a65 6374 6976 6520 4320 5375 Objective C Su │ │ │ │ │ +00048730: 7070 6f72 742e 2028 6c69 6e65 2020 2036 pport. (line 6 │ │ │ │ │ +00048740: 290a 2a20 4f62 6a65 6374 7320 696e 2073 ).* Objects in s │ │ │ │ │ +00048750: 7562 6469 7265 6374 6f72 793a 2020 2020 ubdirectory: │ │ │ │ │ +00048760: 2020 2020 2020 2020 2020 2050 726f 6772 Progr │ │ │ │ │ +00048770: 616d 2061 6e64 204c 6962 7261 7279 2056 am and Library V │ │ │ │ │ +00048780: 6172 6961 626c 6573 2e0a 2020 2020 2020 ariables.. │ │ │ │ │ 00048790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000487a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000487b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000487c0: 2020 2020 2020 2028 6c69 6e65 2020 3531 (line 51 │ │ │ │ │ -000487d0: 290a 2a20 6f62 736f 6c65 7465 206d 6163 ).* obsolete mac │ │ │ │ │ -000487e0: 726f 733a 2020 2020 2020 2020 2020 2020 ros: │ │ │ │ │ -000487f0: 2020 2020 2020 2020 2020 204f 6273 6f6c Obsol │ │ │ │ │ -00048800: 6574 6520 4d61 6372 6f73 2e20 2020 2020 ete Macros. │ │ │ │ │ -00048810: 286c 696e 6520 2020 3629 0a2a 206f 7074 (line 6).* opt │ │ │ │ │ -00048820: 696d 697a 6564 2062 7569 6c64 2c20 6578 imized build, ex │ │ │ │ │ -00048830: 616d 706c 653a 2020 2020 2020 2020 2020 ample: │ │ │ │ │ -00048840: 2020 2020 5650 4154 4820 4275 696c 6473 VPATH Builds │ │ │ │ │ -00048850: 2e20 2020 2020 2020 2028 6c69 6e65 2020 . (line │ │ │ │ │ -00048860: 3436 290a 2a20 4f70 7469 6f6e 2c20 2d2d 46).* Option, -- │ │ │ │ │ -00048870: 7761 726e 696e 6773 3d43 4154 4547 4f52 warnings=CATEGOR │ │ │ │ │ -00048880: 593a 2020 2020 2020 2020 2020 204f 7074 Y: Opt │ │ │ │ │ -00048890: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ -000488a0: 2020 286c 696e 6520 3233 3729 0a2a 204f (line 237).* O │ │ │ │ │ -000488b0: 7074 696f 6e2c 202d 5743 4154 4547 4f52 ption, -WCATEGOR │ │ │ │ │ -000488c0: 593a 2020 2020 2020 2020 2020 2020 2020 Y: │ │ │ │ │ -000488d0: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ -000488e0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -000488f0: 2032 3337 290a 2a20 4f70 7469 6f6e 2c20 237).* Option, │ │ │ │ │ -00048900: 616e 7369 326b 6e72 3a20 2020 2020 2020 ansi2knr: │ │ │ │ │ -00048910: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ -00048920: 7074 696f 6e73 2e20 2020 2020 2020 2020 ptions. │ │ │ │ │ -00048930: 2020 2020 286c 696e 6520 2032 3929 0a2a (line 29).* │ │ │ │ │ -00048940: 204f 7074 696f 6e2c 2063 6865 636b 2d6e Option, check-n │ │ │ │ │ -00048950: 6577 733a 2020 2020 2020 2020 2020 2020 ews: │ │ │ │ │ -00048960: 2020 2020 2020 2020 4f70 7469 6f6e 732e Options. │ │ │ │ │ -00048970: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00048980: 6e65 2020 3339 290a 2a20 4f70 7469 6f6e ne 39).* Option │ │ │ │ │ -00048990: 2c20 636f 6c6f 722d 7465 7374 733a 2020 , color-tests: │ │ │ │ │ +000487c0: 2020 2020 2020 2020 286c 696e 6520 2035 (line 5 │ │ │ │ │ +000487d0: 3129 0a2a 206f 6273 6f6c 6574 6520 6d61 1).* obsolete ma │ │ │ │ │ +000487e0: 6372 6f73 3a20 2020 2020 2020 2020 2020 cros: │ │ │ │ │ +000487f0: 2020 2020 2020 2020 2020 2020 4f62 736f Obso │ │ │ │ │ +00048800: 6c65 7465 204d 6163 726f 732e 2020 2020 lete Macros. │ │ │ │ │ +00048810: 2028 6c69 6e65 2020 2036 290a 2a20 6f70 (line 6).* op │ │ │ │ │ +00048820: 7469 6d69 7a65 6420 6275 696c 642c 2065 timized build, e │ │ │ │ │ +00048830: 7861 6d70 6c65 3a20 2020 2020 2020 2020 xample: │ │ │ │ │ +00048840: 2020 2020 2056 5041 5448 2042 7569 6c64 VPATH Build │ │ │ │ │ +00048850: 732e 2020 2020 2020 2020 286c 696e 6520 s. (line │ │ │ │ │ +00048860: 2034 3629 0a2a 204f 7074 696f 6e2c 202d 46).* Option, - │ │ │ │ │ +00048870: 2d77 6172 6e69 6e67 733d 4341 5445 474f -warnings=CATEGO │ │ │ │ │ +00048880: 5259 3a20 2020 2020 2020 2020 2020 4f70 RY: Op │ │ │ │ │ +00048890: 7469 6f6e 732e 2020 2020 2020 2020 2020 tions. │ │ │ │ │ +000488a0: 2020 2028 6c69 6e65 2032 3337 290a 2a20 (line 237).* │ │ │ │ │ +000488b0: 4f70 7469 6f6e 2c20 2d57 4341 5445 474f Option, -WCATEGO │ │ │ │ │ +000488c0: 5259 3a20 2020 2020 2020 2020 2020 2020 RY: │ │ │ │ │ +000488d0: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ +000488e0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +000488f0: 6520 3233 3729 0a2a 204f 7074 696f 6e2c e 237).* Option, │ │ │ │ │ +00048900: 2061 6e73 6932 6b6e 723a 2020 2020 2020 ansi2knr: │ │ │ │ │ +00048910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00048920: 4f70 7469 6f6e 732e 2020 2020 2020 2020 Options. │ │ │ │ │ +00048930: 2020 2020 2028 6c69 6e65 2020 3239 290a (line 29). │ │ │ │ │ +00048940: 2a20 4f70 7469 6f6e 2c20 6368 6563 6b2d * Option, check- │ │ │ │ │ +00048950: 6e65 7773 3a20 2020 2020 2020 2020 2020 news: │ │ │ │ │ +00048960: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ +00048970: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00048980: 696e 6520 2033 3929 0a2a 204f 7074 696f ine 39).* Optio │ │ │ │ │ +00048990: 6e2c 2063 6f6c 6f72 2d74 6573 7473 3a20 n, color-tests: │ │ │ │ │ 000489a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000489b0: 204f 7074 696f 6e73 2e20 2020 2020 2020 Options. │ │ │ │ │ -000489c0: 2020 2020 2020 286c 696e 6520 2034 3329 (line 43) │ │ │ │ │ -000489d0: 0a2a 204f 7074 696f 6e2c 2063 7967 6e75 .* Option, cygnu │ │ │ │ │ -000489e0: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ -000489f0: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ -00048a00: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -00048a10: 6c69 6e65 2020 3233 290a 2a20 4f70 7469 line 23).* Opti │ │ │ │ │ -00048a20: 6f6e 2c20 6465 6a61 676e 753a 2020 2020 on, dejagnu: │ │ │ │ │ +000489b0: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ +000489c0: 2020 2020 2020 2028 6c69 6e65 2020 3433 (line 43 │ │ │ │ │ +000489d0: 290a 2a20 4f70 7469 6f6e 2c20 6379 676e ).* Option, cygn │ │ │ │ │ +000489e0: 7573 3a20 2020 2020 2020 2020 2020 2020 us: │ │ │ │ │ +000489f0: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ +00048a00: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ +00048a10: 286c 696e 6520 2032 3329 0a2a 204f 7074 (line 23).* Opt │ │ │ │ │ +00048a20: 696f 6e2c 2064 656a 6167 6e75 3a20 2020 ion, dejagnu: │ │ │ │ │ 00048a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048a40: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ -00048a50: 2020 2020 2020 2020 286c 696e 6520 2034 (line 4 │ │ │ │ │ -00048a60: 3729 0a2a 204f 7074 696f 6e2c 2064 6973 7).* Option, dis │ │ │ │ │ -00048a70: 742d 627a 6970 323a 2020 2020 2020 2020 t-bzip2: │ │ │ │ │ -00048a80: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ -00048a90: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ -00048aa0: 2028 6c69 6e65 2020 3531 290a 2a20 4f70 (line 51).* Op │ │ │ │ │ -00048ab0: 7469 6f6e 2c20 6469 7374 2d6c 7a69 703a tion, dist-lzip: │ │ │ │ │ -00048ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048ad0: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ -00048ae0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00048af0: 2035 3429 0a2a 204f 7074 696f 6e2c 2064 54).* Option, d │ │ │ │ │ -00048b00: 6973 742d 6c7a 6d61 3a20 2020 2020 2020 ist-lzma: │ │ │ │ │ -00048b10: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ -00048b20: 7469 6f6e 732e 2020 2020 2020 2020 2020 tions. │ │ │ │ │ -00048b30: 2020 2028 6c69 6e65 2020 3537 290a 2a20 (line 57).* │ │ │ │ │ -00048b40: 4f70 7469 6f6e 2c20 6469 7374 2d73 6861 Option, dist-sha │ │ │ │ │ -00048b50: 723a 2020 2020 2020 2020 2020 2020 2020 r: │ │ │ │ │ -00048b60: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ -00048b70: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00048b80: 6520 2036 3029 0a2a 204f 7074 696f 6e2c e 60).* Option, │ │ │ │ │ -00048b90: 2064 6973 742d 7461 725a 3a20 2020 2020 dist-tarZ: │ │ │ │ │ +00048a40: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ +00048a50: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00048a60: 3437 290a 2a20 4f70 7469 6f6e 2c20 6469 47).* Option, di │ │ │ │ │ +00048a70: 7374 2d62 7a69 7032 3a20 2020 2020 2020 st-bzip2: │ │ │ │ │ +00048a80: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ +00048a90: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ +00048aa0: 2020 286c 696e 6520 2035 3129 0a2a 204f (line 51).* O │ │ │ │ │ +00048ab0: 7074 696f 6e2c 2064 6973 742d 6c7a 6970 ption, dist-lzip │ │ │ │ │ +00048ac0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00048ad0: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ +00048ae0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00048af0: 2020 3534 290a 2a20 4f70 7469 6f6e 2c20 54).* Option, │ │ │ │ │ +00048b00: 6469 7374 2d6c 7a6d 613a 2020 2020 2020 dist-lzma: │ │ │ │ │ +00048b10: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +00048b20: 7074 696f 6e73 2e20 2020 2020 2020 2020 ptions. │ │ │ │ │ +00048b30: 2020 2020 286c 696e 6520 2035 3729 0a2a (line 57).* │ │ │ │ │ +00048b40: 204f 7074 696f 6e2c 2064 6973 742d 7368 Option, dist-sh │ │ │ │ │ +00048b50: 6172 3a20 2020 2020 2020 2020 2020 2020 ar: │ │ │ │ │ +00048b60: 2020 2020 2020 2020 4f70 7469 6f6e 732e Options. │ │ │ │ │ +00048b70: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00048b80: 6e65 2020 3630 290a 2a20 4f70 7469 6f6e ne 60).* Option │ │ │ │ │ +00048b90: 2c20 6469 7374 2d74 6172 5a3a 2020 2020 , dist-tarZ: │ │ │ │ │ 00048ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048bb0: 4f70 7469 6f6e 732e 2020 2020 2020 2020 Options. │ │ │ │ │ -00048bc0: 2020 2020 2028 6c69 6e65 2020 3636 290a (line 66). │ │ │ │ │ -00048bd0: 2a20 4f70 7469 6f6e 2c20 6469 7374 2d7a * Option, dist-z │ │ │ │ │ -00048be0: 6970 3a20 2020 2020 2020 2020 2020 2020 ip: │ │ │ │ │ -00048bf0: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ -00048c00: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -00048c10: 696e 6520 2036 3329 0a2a 204f 7074 696f ine 63).* Optio │ │ │ │ │ -00048c20: 6e2c 2066 696c 656e 616d 652d 6c65 6e67 n, filename-leng │ │ │ │ │ -00048c30: 7468 2d6d 6178 3d39 393a 2020 2020 2020 th-max=99: │ │ │ │ │ -00048c40: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ -00048c50: 2020 2020 2020 2028 6c69 6e65 2020 3639 (line 69 │ │ │ │ │ -00048c60: 290a 2a20 4f70 7469 6f6e 2c20 666f 7265 ).* Option, fore │ │ │ │ │ -00048c70: 6967 6e3a 2020 2020 2020 2020 2020 2020 ign: │ │ │ │ │ -00048c80: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00048c90: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00048ca0: 286c 696e 6520 2032 3329 0a2a 204f 7074 (line 23).* Opt │ │ │ │ │ -00048cb0: 696f 6e2c 2067 6e69 7473 3a20 2020 2020 ion, gnits: │ │ │ │ │ +00048bb0: 204f 7074 696f 6e73 2e20 2020 2020 2020 Options. │ │ │ │ │ +00048bc0: 2020 2020 2020 286c 696e 6520 2036 3629 (line 66) │ │ │ │ │ +00048bd0: 0a2a 204f 7074 696f 6e2c 2064 6973 742d .* Option, dist- │ │ │ │ │ +00048be0: 7a69 703a 2020 2020 2020 2020 2020 2020 zip: │ │ │ │ │ +00048bf0: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +00048c00: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ +00048c10: 6c69 6e65 2020 3633 290a 2a20 4f70 7469 line 63).* Opti │ │ │ │ │ +00048c20: 6f6e 2c20 6669 6c65 6e61 6d65 2d6c 656e on, filename-len │ │ │ │ │ +00048c30: 6774 682d 6d61 783d 3939 3a20 2020 2020 gth-max=99: │ │ │ │ │ +00048c40: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ +00048c50: 2020 2020 2020 2020 286c 696e 6520 2036 (line 6 │ │ │ │ │ +00048c60: 3929 0a2a 204f 7074 696f 6e2c 2066 6f72 9).* Option, for │ │ │ │ │ +00048c70: 6569 676e 3a20 2020 2020 2020 2020 2020 eign: │ │ │ │ │ +00048c80: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00048c90: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00048ca0: 2028 6c69 6e65 2020 3233 290a 2a20 4f70 (line 23).* Op │ │ │ │ │ +00048cb0: 7469 6f6e 2c20 676e 6974 733a 2020 2020 tion, gnits: │ │ │ │ │ 00048cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048cd0: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -00048ce0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -00048cf0: 3233 290a 2a20 4f70 7469 6f6e 2c20 676e 23).* Option, gn │ │ │ │ │ -00048d00: 753a 2020 2020 2020 2020 2020 2020 2020 u: │ │ │ │ │ -00048d10: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ -00048d20: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ -00048d30: 2020 286c 696e 6520 2032 3329 0a2a 204f (line 23).* O │ │ │ │ │ -00048d40: 7074 696f 6e2c 206e 6f2d 6465 6669 6e65 ption, no-define │ │ │ │ │ -00048d50: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00048d60: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ -00048d70: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00048d80: 2020 3738 290a 2a20 4f70 7469 6f6e 2c20 78).* Option, │ │ │ │ │ -00048d90: 6e6f 2d64 6570 656e 6465 6e63 6965 733a no-dependencies: │ │ │ │ │ -00048da0: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ -00048db0: 7074 696f 6e73 2e20 2020 2020 2020 2020 ptions. │ │ │ │ │ -00048dc0: 2020 2020 286c 696e 6520 2038 3329 0a2a (line 83).* │ │ │ │ │ -00048dd0: 204f 7074 696f 6e2c 206e 6f2d 6469 7374 Option, no-dist │ │ │ │ │ -00048de0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00048df0: 2020 2020 2020 2020 4f70 7469 6f6e 732e Options. │ │ │ │ │ -00048e00: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00048e10: 6e65 2020 3930 290a 2a20 4f70 7469 6f6e ne 90).* Option │ │ │ │ │ -00048e20: 2c20 6e6f 2d64 6973 742d 677a 6970 3a20 , no-dist-gzip: │ │ │ │ │ +00048cd0: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ +00048ce0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00048cf0: 2032 3329 0a2a 204f 7074 696f 6e2c 2067 23).* Option, g │ │ │ │ │ +00048d00: 6e75 3a20 2020 2020 2020 2020 2020 2020 nu: │ │ │ │ │ +00048d10: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ +00048d20: 7469 6f6e 732e 2020 2020 2020 2020 2020 tions. │ │ │ │ │ +00048d30: 2020 2028 6c69 6e65 2020 3233 290a 2a20 (line 23).* │ │ │ │ │ +00048d40: 4f70 7469 6f6e 2c20 6e6f 2d64 6566 696e Option, no-defin │ │ │ │ │ +00048d50: 653a 2020 2020 2020 2020 2020 2020 2020 e: │ │ │ │ │ +00048d60: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ +00048d70: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00048d80: 6520 2037 3829 0a2a 204f 7074 696f 6e2c e 78).* Option, │ │ │ │ │ +00048d90: 206e 6f2d 6465 7065 6e64 656e 6369 6573 no-dependencies │ │ │ │ │ +00048da0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00048db0: 4f70 7469 6f6e 732e 2020 2020 2020 2020 Options. │ │ │ │ │ +00048dc0: 2020 2020 2028 6c69 6e65 2020 3833 290a (line 83). │ │ │ │ │ +00048dd0: 2a20 4f70 7469 6f6e 2c20 6e6f 2d64 6973 * Option, no-dis │ │ │ │ │ +00048de0: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ +00048df0: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ +00048e00: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00048e10: 696e 6520 2039 3029 0a2a 204f 7074 696f ine 90).* Optio │ │ │ │ │ +00048e20: 6e2c 206e 6f2d 6469 7374 2d67 7a69 703a n, no-dist-gzip: │ │ │ │ │ 00048e30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00048e40: 204f 7074 696f 6e73 2e20 2020 2020 2020 Options. │ │ │ │ │ -00048e50: 2020 2020 2020 286c 696e 6520 2039 3429 (line 94) │ │ │ │ │ -00048e60: 0a2a 204f 7074 696f 6e2c 206e 6f2d 6578 .* Option, no-ex │ │ │ │ │ -00048e70: 6565 7874 3a20 2020 2020 2020 2020 2020 eext: │ │ │ │ │ -00048e80: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ -00048e90: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ -00048ea0: 6c69 6e65 2020 3937 290a 2a20 4f70 7469 line 97).* Opti │ │ │ │ │ -00048eb0: 6f6e 2c20 6e6f 2d69 6e73 7461 6c6c 696e on, no-installin │ │ │ │ │ -00048ec0: 666f 3a20 2020 2020 2020 2020 2020 2020 fo: │ │ │ │ │ -00048ed0: 2020 2054 6578 696e 666f 2e20 2020 2020 Texinfo. │ │ │ │ │ -00048ee0: 2020 2020 2020 2020 286c 696e 6520 2037 (line 7 │ │ │ │ │ -00048ef0: 3929 0a2a 204f 7074 696f 6e2c 206e 6f2d 9).* Option, no- │ │ │ │ │ -00048f00: 696e 7374 616c 6c69 6e66 6f20 3c31 3e3a installinfo <1>: │ │ │ │ │ -00048f10: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ -00048f20: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ -00048f30: 2028 6c69 6e65 2031 3037 290a 2a20 4f70 (line 107).* Op │ │ │ │ │ -00048f40: 7469 6f6e 2c20 6e6f 2d69 6e73 7461 6c6c tion, no-install │ │ │ │ │ -00048f50: 6d61 6e3a 2020 2020 2020 2020 2020 2020 man: │ │ │ │ │ -00048f60: 2020 2020 204d 616e 2050 6167 6573 2e20 Man Pages. │ │ │ │ │ -00048f70: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00048f80: 2033 3229 0a2a 204f 7074 696f 6e2c 206e 32).* Option, n │ │ │ │ │ -00048f90: 6f2d 696e 7374 616c 6c6d 616e 203c 313e o-installman <1> │ │ │ │ │ -00048fa0: 3a20 2020 2020 2020 2020 2020 2020 4f70 : Op │ │ │ │ │ -00048fb0: 7469 6f6e 732e 2020 2020 2020 2020 2020 tions. │ │ │ │ │ -00048fc0: 2020 2028 6c69 6e65 2031 3133 290a 2a20 (line 113).* │ │ │ │ │ -00048fd0: 4f70 7469 6f6e 2c20 6e6f 2d74 6578 696e Option, no-texin │ │ │ │ │ -00048fe0: 666f 2e74 6578 3a20 2020 2020 2020 2020 fo.tex: │ │ │ │ │ -00048ff0: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ -00049000: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00049010: 6520 3132 3329 0a2a 204f 7074 696f 6e2c e 123).* Option, │ │ │ │ │ -00049020: 206e 6f73 7464 696e 633a 2020 2020 2020 nostdinc: │ │ │ │ │ +00048e40: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ +00048e50: 2020 2020 2020 2028 6c69 6e65 2020 3934 (line 94 │ │ │ │ │ +00048e60: 290a 2a20 4f70 7469 6f6e 2c20 6e6f 2d65 ).* Option, no-e │ │ │ │ │ +00048e70: 7865 6578 743a 2020 2020 2020 2020 2020 xeext: │ │ │ │ │ +00048e80: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ +00048e90: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ +00048ea0: 286c 696e 6520 2039 3729 0a2a 204f 7074 (line 97).* Opt │ │ │ │ │ +00048eb0: 696f 6e2c 206e 6f2d 696e 7374 616c 6c69 ion, no-installi │ │ │ │ │ +00048ec0: 6e66 6f3a 2020 2020 2020 2020 2020 2020 nfo: │ │ │ │ │ +00048ed0: 2020 2020 5465 7869 6e66 6f2e 2020 2020 Texinfo. │ │ │ │ │ +00048ee0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00048ef0: 3739 290a 2a20 4f70 7469 6f6e 2c20 6e6f 79).* Option, no │ │ │ │ │ +00048f00: 2d69 6e73 7461 6c6c 696e 666f 203c 313e -installinfo <1> │ │ │ │ │ +00048f10: 3a20 2020 2020 2020 2020 2020 204f 7074 : Opt │ │ │ │ │ +00048f20: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ +00048f30: 2020 286c 696e 6520 3130 3729 0a2a 204f (line 107).* O │ │ │ │ │ +00048f40: 7074 696f 6e2c 206e 6f2d 696e 7374 616c ption, no-instal │ │ │ │ │ +00048f50: 6c6d 616e 3a20 2020 2020 2020 2020 2020 lman: │ │ │ │ │ +00048f60: 2020 2020 2020 4d61 6e20 5061 6765 732e Man Pages. │ │ │ │ │ +00048f70: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00048f80: 2020 3332 290a 2a20 4f70 7469 6f6e 2c20 32).* Option, │ │ │ │ │ +00048f90: 6e6f 2d69 6e73 7461 6c6c 6d61 6e20 3c31 no-installman <1 │ │ │ │ │ +00048fa0: 3e3a 2020 2020 2020 2020 2020 2020 204f >: O │ │ │ │ │ +00048fb0: 7074 696f 6e73 2e20 2020 2020 2020 2020 ptions. │ │ │ │ │ +00048fc0: 2020 2020 286c 696e 6520 3131 3329 0a2a (line 113).* │ │ │ │ │ +00048fd0: 204f 7074 696f 6e2c 206e 6f2d 7465 7869 Option, no-texi │ │ │ │ │ +00048fe0: 6e66 6f2e 7465 783a 2020 2020 2020 2020 nfo.tex: │ │ │ │ │ +00048ff0: 2020 2020 2020 2020 4f70 7469 6f6e 732e Options. │ │ │ │ │ +00049000: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00049010: 6e65 2031 3233 290a 2a20 4f70 7469 6f6e ne 123).* Option │ │ │ │ │ +00049020: 2c20 6e6f 7374 6469 6e63 3a20 2020 2020 , nostdinc: │ │ │ │ │ 00049030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049040: 4f70 7469 6f6e 732e 2020 2020 2020 2020 Options. │ │ │ │ │ -00049050: 2020 2020 2028 6c69 6e65 2031 3139 290a (line 119). │ │ │ │ │ -00049060: 2a20 4f70 7469 6f6e 2c20 7061 7261 6c6c * Option, parall │ │ │ │ │ -00049070: 656c 2d74 6573 7473 3a20 2020 2020 2020 el-tests: │ │ │ │ │ -00049080: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ -00049090: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -000490a0: 696e 6520 3132 3729 0a2a 204f 7074 696f ine 127).* Optio │ │ │ │ │ -000490b0: 6e2c 2072 6561 646d 652d 616c 7068 613a n, readme-alpha: │ │ │ │ │ -000490c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000490d0: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ -000490e0: 2020 2020 2020 2028 6c69 6e65 2031 3331 (line 131 │ │ │ │ │ -000490f0: 290a 2a20 4f70 7469 6f6e 2c20 7369 6c65 ).* Option, sile │ │ │ │ │ -00049100: 6e74 2d72 756c 6573 3a20 2020 2020 2020 nt-rules: │ │ │ │ │ -00049110: 2020 2020 2020 2020 2020 204f 7074 696f Optio │ │ │ │ │ -00049120: 6e73 2e20 2020 2020 2020 2020 2020 2020 ns. │ │ │ │ │ -00049130: 286c 696e 6520 3134 3029 0a2a 204f 7074 (line 140).* Opt │ │ │ │ │ -00049140: 696f 6e2c 2074 6172 2d70 6178 3a20 2020 ion, tar-pax: │ │ │ │ │ +00049040: 204f 7074 696f 6e73 2e20 2020 2020 2020 Options. │ │ │ │ │ +00049050: 2020 2020 2020 286c 696e 6520 3131 3929 (line 119) │ │ │ │ │ +00049060: 0a2a 204f 7074 696f 6e2c 2070 6172 616c .* Option, paral │ │ │ │ │ +00049070: 6c65 6c2d 7465 7374 733a 2020 2020 2020 lel-tests: │ │ │ │ │ +00049080: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +00049090: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ +000490a0: 6c69 6e65 2031 3237 290a 2a20 4f70 7469 line 127).* Opti │ │ │ │ │ +000490b0: 6f6e 2c20 7265 6164 6d65 2d61 6c70 6861 on, readme-alpha │ │ │ │ │ +000490c0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000490d0: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ +000490e0: 2020 2020 2020 2020 286c 696e 6520 3133 (line 13 │ │ │ │ │ +000490f0: 3129 0a2a 204f 7074 696f 6e2c 2073 696c 1).* Option, sil │ │ │ │ │ +00049100: 656e 742d 7275 6c65 733a 2020 2020 2020 ent-rules: │ │ │ │ │ +00049110: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ +00049120: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ +00049130: 2028 6c69 6e65 2031 3430 290a 2a20 4f70 (line 140).* Op │ │ │ │ │ +00049140: 7469 6f6e 2c20 7461 722d 7061 783a 2020 tion, tar-pax: │ │ │ │ │ 00049150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049160: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ -00049170: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ -00049180: 3835 290a 2a20 4f70 7469 6f6e 2c20 7461 85).* Option, ta │ │ │ │ │ -00049190: 722d 7573 7461 723a 2020 2020 2020 2020 r-ustar: │ │ │ │ │ -000491a0: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ -000491b0: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ -000491c0: 2020 286c 696e 6520 3138 3529 0a2a 204f (line 185).* O │ │ │ │ │ -000491d0: 7074 696f 6e2c 2074 6172 2d76 373a 2020 ption, tar-v7: │ │ │ │ │ +00049160: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ +00049170: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00049180: 3138 3529 0a2a 204f 7074 696f 6e2c 2074 185).* Option, t │ │ │ │ │ +00049190: 6172 2d75 7374 6172 3a20 2020 2020 2020 ar-ustar: │ │ │ │ │ +000491a0: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ +000491b0: 7469 6f6e 732e 2020 2020 2020 2020 2020 tions. │ │ │ │ │ +000491c0: 2020 2028 6c69 6e65 2031 3835 290a 2a20 (line 185).* │ │ │ │ │ +000491d0: 4f70 7469 6f6e 2c20 7461 722d 7637 3a20 Option, tar-v7: │ │ │ │ │ 000491e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000491f0: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ -00049200: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00049210: 2031 3835 290a 2a20 4f70 7469 6f6e 2c20 185).* Option, │ │ │ │ │ -00049220: 5645 5253 494f 4e3a 2020 2020 2020 2020 VERSION: │ │ │ │ │ -00049230: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ -00049240: 7074 696f 6e73 2e20 2020 2020 2020 2020 ptions. │ │ │ │ │ -00049250: 2020 2020 286c 696e 6520 3233 3229 0a2a (line 232).* │ │ │ │ │ -00049260: 204f 7074 696f 6e2c 2077 6172 6e69 6e67 Option, warning │ │ │ │ │ -00049270: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ -00049280: 2020 2020 2020 2020 4f70 7469 6f6e 732e Options. │ │ │ │ │ -00049290: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000492a0: 6e65 2032 3337 290a 2a20 4f70 7469 6f6e ne 237).* Option │ │ │ │ │ -000492b0: 732c 2061 636c 6f63 616c 3a20 2020 2020 s, aclocal: │ │ │ │ │ +000491f0: 2020 2020 2020 204f 7074 696f 6e73 2e20 Options. │ │ │ │ │ +00049200: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00049210: 6520 3138 3529 0a2a 204f 7074 696f 6e2c e 185).* Option, │ │ │ │ │ +00049220: 2056 4552 5349 4f4e 3a20 2020 2020 2020 VERSION: │ │ │ │ │ +00049230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00049240: 4f70 7469 6f6e 732e 2020 2020 2020 2020 Options. │ │ │ │ │ +00049250: 2020 2020 2028 6c69 6e65 2032 3332 290a (line 232). │ │ │ │ │ +00049260: 2a20 4f70 7469 6f6e 2c20 7761 726e 696e * Option, warnin │ │ │ │ │ +00049270: 6773 3a20 2020 2020 2020 2020 2020 2020 gs: │ │ │ │ │ +00049280: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ +00049290: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +000492a0: 696e 6520 3233 3729 0a2a 204f 7074 696f ine 237).* Optio │ │ │ │ │ +000492b0: 6e73 2c20 6163 6c6f 6361 6c3a 2020 2020 ns, aclocal: │ │ │ │ │ 000492c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000492d0: 2061 636c 6f63 616c 204f 7074 696f 6e73 aclocal Options │ │ │ │ │ -000492e0: 2e20 2020 2020 286c 696e 6520 2020 3629 . (line 6) │ │ │ │ │ -000492f0: 0a2a 204f 7074 696f 6e73 2c20 6175 746f .* Options, auto │ │ │ │ │ -00049300: 6d61 6b65 3a20 2020 2020 2020 2020 2020 make: │ │ │ │ │ -00049310: 2020 2020 2020 2020 2020 6175 746f 6d61 automa │ │ │ │ │ -00049320: 6b65 2049 6e76 6f63 6174 696f 6e2e 2028 ke Invocation. ( │ │ │ │ │ -00049330: 6c69 6e65 2020 3337 290a 2a20 4f70 7469 line 37).* Opti │ │ │ │ │ -00049340: 6f6e 732c 2073 7464 2d6f 7074 696f 6e73 ons, std-options │ │ │ │ │ -00049350: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00049360: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ -00049370: 2020 2020 2020 2020 286c 696e 6520 3135 (line 15 │ │ │ │ │ -00049380: 3229 0a2a 204f 7074 696f 6e73 2c20 7375 2).* Options, su │ │ │ │ │ -00049390: 6264 6972 2d6f 626a 6563 7473 3a20 2020 bdir-objects: │ │ │ │ │ -000493a0: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ -000493b0: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ -000493c0: 2028 6c69 6e65 2031 3733 290a 2a20 4f72 (line 173).* Or │ │ │ │ │ -000493d0: 6465 7269 6e67 2066 6c61 6720 7661 7269 dering flag vari │ │ │ │ │ -000493e0: 6162 6c65 733a 2020 2020 2020 2020 2020 ables: │ │ │ │ │ -000493f0: 2020 2020 2046 6c61 6720 5661 7269 6162 Flag Variab │ │ │ │ │ -00049400: 6c65 7320 4f72 6465 7269 6e67 2e0a 2020 les Ordering.. │ │ │ │ │ +000492d0: 2020 6163 6c6f 6361 6c20 4f70 7469 6f6e aclocal Option │ │ │ │ │ +000492e0: 732e 2020 2020 2028 6c69 6e65 2020 2036 s. (line 6 │ │ │ │ │ +000492f0: 290a 2a20 4f70 7469 6f6e 732c 2061 7574 ).* Options, aut │ │ │ │ │ +00049300: 6f6d 616b 653a 2020 2020 2020 2020 2020 omake: │ │ │ │ │ +00049310: 2020 2020 2020 2020 2020 2061 7574 6f6d autom │ │ │ │ │ +00049320: 616b 6520 496e 766f 6361 7469 6f6e 2e20 ake Invocation. │ │ │ │ │ +00049330: 286c 696e 6520 2033 3729 0a2a 204f 7074 (line 37).* Opt │ │ │ │ │ +00049340: 696f 6e73 2c20 7374 642d 6f70 7469 6f6e ions, std-option │ │ │ │ │ +00049350: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ +00049360: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ +00049370: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +00049380: 3532 290a 2a20 4f70 7469 6f6e 732c 2073 52).* Options, s │ │ │ │ │ +00049390: 7562 6469 722d 6f62 6a65 6374 733a 2020 ubdir-objects: │ │ │ │ │ +000493a0: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ +000493b0: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ +000493c0: 2020 286c 696e 6520 3137 3329 0a2a 204f (line 173).* O │ │ │ │ │ +000493d0: 7264 6572 696e 6720 666c 6167 2076 6172 rdering flag var │ │ │ │ │ +000493e0: 6961 626c 6573 3a20 2020 2020 2020 2020 iables: │ │ │ │ │ +000493f0: 2020 2020 2020 466c 6167 2056 6172 6961 Flag Varia │ │ │ │ │ +00049400: 626c 6573 204f 7264 6572 696e 672e 0a20 bles Ordering.. │ │ │ │ │ 00049410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049430: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049440: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00049450: 6520 2020 3629 0a2a 204f 7665 7272 6964 e 6).* Overrid │ │ │ │ │ -00049460: 696e 6720 6d61 6b65 2072 756c 6573 3a20 ing make rules: │ │ │ │ │ +00049440: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00049450: 6e65 2020 2036 290a 2a20 4f76 6572 7269 ne 6).* Overri │ │ │ │ │ +00049460: 6469 6e67 206d 616b 6520 7275 6c65 733a ding make rules: │ │ │ │ │ 00049470: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049480: 4765 6e65 7261 6c20 4f70 6572 6174 696f General Operatio │ │ │ │ │ -00049490: 6e2e 2020 2028 6c69 6e65 2020 3436 290a n. (line 46). │ │ │ │ │ -000494a0: 2a20 4f76 6572 7269 6469 6e67 206d 616b * Overriding mak │ │ │ │ │ -000494b0: 6520 7461 7267 6574 733a 2020 2020 2020 e targets: │ │ │ │ │ -000494c0: 2020 2020 2020 2020 2047 656e 6572 616c General │ │ │ │ │ -000494d0: 204f 7065 7261 7469 6f6e 2e20 2020 286c Operation. (l │ │ │ │ │ -000494e0: 696e 6520 2034 3629 0a2a 204f 7665 7272 ine 46).* Overr │ │ │ │ │ -000494f0: 6964 696e 6720 6d61 6b65 2076 6172 6961 iding make varia │ │ │ │ │ -00049500: 626c 6573 3a20 2020 2020 2020 2020 2020 bles: │ │ │ │ │ -00049510: 2020 4765 6e65 7261 6c20 4f70 6572 6174 General Operat │ │ │ │ │ -00049520: 696f 6e2e 2020 2028 6c69 6e65 2020 3531 ion. (line 51 │ │ │ │ │ -00049530: 290a 2a20 6f76 6572 7269 6469 6e67 2072 ).* overriding r │ │ │ │ │ -00049540: 756c 6573 3a20 2020 2020 2020 2020 2020 ules: │ │ │ │ │ -00049550: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ -00049560: 6469 6e67 2e20 2020 2020 2020 2020 2020 ding. │ │ │ │ │ -00049570: 286c 696e 6520 2032 3629 0a2a 206f 7665 (line 26).* ove │ │ │ │ │ -00049580: 7272 6964 696e 6720 7365 6d61 6e74 6963 rriding semantic │ │ │ │ │ -00049590: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ -000495a0: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ -000495b0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -000495c0: 3236 290a 2a20 5041 434b 4147 452c 2064 26).* PACKAGE, d │ │ │ │ │ -000495d0: 6972 6563 746f 7279 3a20 2020 2020 2020 irectory: │ │ │ │ │ -000495e0: 2020 2020 2020 2020 2020 2020 2055 6e69 Uni │ │ │ │ │ -000495f0: 666f 726d 2e20 2020 2020 2020 2020 2020 form. │ │ │ │ │ -00049600: 2020 286c 696e 6520 2031 3929 0a2a 2050 (line 19).* P │ │ │ │ │ -00049610: 4143 4b41 4745 2c20 7072 6576 656e 7420 ACKAGE, prevent │ │ │ │ │ -00049620: 6465 6669 6e69 7469 6f6e 3a20 2020 2020 definition: │ │ │ │ │ -00049630: 2020 2020 2020 5075 626c 6963 204d 6163 Public Mac │ │ │ │ │ -00049640: 726f 732e 2020 2020 2020 2028 6c69 6e65 ros. (line │ │ │ │ │ -00049650: 2020 3630 290a 2a20 5061 636b 6167 6573 60).* Packages │ │ │ │ │ -00049660: 2c20 6e65 7374 6564 3a20 2020 2020 2020 , nested: │ │ │ │ │ -00049670: 2020 2020 2020 2020 2020 2020 2020 204e N │ │ │ │ │ -00049680: 6573 7465 6420 5061 636b 6167 6573 2e20 ested Packages. │ │ │ │ │ -00049690: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -000496a0: 2050 6163 6b61 6765 732c 2070 7265 7061 Packages, prepa │ │ │ │ │ -000496b0: 7261 7469 6f6e 3a20 2020 2020 2020 2020 ration: │ │ │ │ │ -000496c0: 2020 2020 2020 2020 5072 6570 6172 696e Preparin │ │ │ │ │ -000496d0: 6720 4469 7374 7269 6275 7469 6f6e 732e g Distributions. │ │ │ │ │ -000496e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00049480: 2047 656e 6572 616c 204f 7065 7261 7469 General Operati │ │ │ │ │ +00049490: 6f6e 2e20 2020 286c 696e 6520 2034 3629 on. (line 46) │ │ │ │ │ +000494a0: 0a2a 204f 7665 7272 6964 696e 6720 6d61 .* Overriding ma │ │ │ │ │ +000494b0: 6b65 2074 6172 6765 7473 3a20 2020 2020 ke targets: │ │ │ │ │ +000494c0: 2020 2020 2020 2020 2020 4765 6e65 7261 Genera │ │ │ │ │ +000494d0: 6c20 4f70 6572 6174 696f 6e2e 2020 2028 l Operation. ( │ │ │ │ │ +000494e0: 6c69 6e65 2020 3436 290a 2a20 4f76 6572 line 46).* Over │ │ │ │ │ +000494f0: 7269 6469 6e67 206d 616b 6520 7661 7269 riding make vari │ │ │ │ │ +00049500: 6162 6c65 733a 2020 2020 2020 2020 2020 ables: │ │ │ │ │ +00049510: 2020 2047 656e 6572 616c 204f 7065 7261 General Opera │ │ │ │ │ +00049520: 7469 6f6e 2e20 2020 286c 696e 6520 2035 tion. (line 5 │ │ │ │ │ +00049530: 3129 0a2a 206f 7665 7272 6964 696e 6720 1).* overriding │ │ │ │ │ +00049540: 7275 6c65 733a 2020 2020 2020 2020 2020 rules: │ │ │ │ │ +00049550: 2020 2020 2020 2020 2020 2020 4578 7465 Exte │ │ │ │ │ +00049560: 6e64 696e 672e 2020 2020 2020 2020 2020 nding. │ │ │ │ │ +00049570: 2028 6c69 6e65 2020 3236 290a 2a20 6f76 (line 26).* ov │ │ │ │ │ +00049580: 6572 7269 6469 6e67 2073 656d 616e 7469 erriding semanti │ │ │ │ │ +00049590: 6373 3a20 2020 2020 2020 2020 2020 2020 cs: │ │ │ │ │ +000495a0: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ +000495b0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000495c0: 2032 3629 0a2a 2050 4143 4b41 4745 2c20 26).* PACKAGE, │ │ │ │ │ +000495d0: 6469 7265 6374 6f72 793a 2020 2020 2020 directory: │ │ │ │ │ +000495e0: 2020 2020 2020 2020 2020 2020 2020 556e Un │ │ │ │ │ +000495f0: 6966 6f72 6d2e 2020 2020 2020 2020 2020 iform. │ │ │ │ │ +00049600: 2020 2028 6c69 6e65 2020 3139 290a 2a20 (line 19).* │ │ │ │ │ +00049610: 5041 434b 4147 452c 2070 7265 7665 6e74 PACKAGE, prevent │ │ │ │ │ +00049620: 2064 6566 696e 6974 696f 6e3a 2020 2020 definition: │ │ │ │ │ +00049630: 2020 2020 2020 2050 7562 6c69 6320 4d61 Public Ma │ │ │ │ │ +00049640: 6372 6f73 2e20 2020 2020 2020 286c 696e cros. (lin │ │ │ │ │ +00049650: 6520 2036 3029 0a2a 2050 6163 6b61 6765 e 60).* Package │ │ │ │ │ +00049660: 732c 206e 6573 7465 643a 2020 2020 2020 s, nested: │ │ │ │ │ +00049670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00049680: 4e65 7374 6564 2050 6163 6b61 6765 732e Nested Packages. │ │ │ │ │ +00049690: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +000496a0: 2a20 5061 636b 6167 6573 2c20 7072 6570 * Packages, prep │ │ │ │ │ +000496b0: 6172 6174 696f 6e3a 2020 2020 2020 2020 aration: │ │ │ │ │ +000496c0: 2020 2020 2020 2020 2050 7265 7061 7269 Prepari │ │ │ │ │ +000496d0: 6e67 2044 6973 7472 6962 7574 696f 6e73 ng Distributions │ │ │ │ │ +000496e0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 000496f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049710: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00049720: 6c69 6e65 2020 2036 290a 2a20 5061 7261 line 6).* Para │ │ │ │ │ -00049730: 6c6c 656c 2062 7569 6c64 2074 7265 6573 llel build trees │ │ │ │ │ -00049740: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00049750: 2020 2056 5041 5448 2042 7569 6c64 732e VPATH Builds. │ │ │ │ │ -00049760: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ -00049770: 3629 0a2a 2070 6172 616c 6c65 6c2d 7465 6).* parallel-te │ │ │ │ │ -00049780: 7374 733a 2020 2020 2020 2020 2020 2020 sts: │ │ │ │ │ -00049790: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ -000497a0: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ -000497b0: 2028 6c69 6e65 2031 3237 290a 2a20 7061 (line 127).* pa │ │ │ │ │ -000497c0: 7261 6c6c 656c 2d74 6573 7473 2c20 5573 rallel-tests, Us │ │ │ │ │ -000497d0: 696e 673a 2020 2020 2020 2020 2020 2020 ing: │ │ │ │ │ -000497e0: 2020 2020 2053 696d 706c 6520 5465 7374 Simple Test │ │ │ │ │ -000497f0: 7320 7573 696e 6720 7061 7261 6c6c 656c s using parallel │ │ │ │ │ -00049800: 2d74 6573 7473 2e0a 2020 2020 2020 2020 -tests.. │ │ │ │ │ +00049710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00049720: 286c 696e 6520 2020 3629 0a2a 2050 6172 (line 6).* Par │ │ │ │ │ +00049730: 616c 6c65 6c20 6275 696c 6420 7472 6565 allel build tree │ │ │ │ │ +00049740: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ +00049750: 2020 2020 5650 4154 4820 4275 696c 6473 VPATH Builds │ │ │ │ │ +00049760: 2e20 2020 2020 2020 2028 6c69 6e65 2020 . (line │ │ │ │ │ +00049770: 2036 290a 2a20 7061 7261 6c6c 656c 2d74 6).* parallel-t │ │ │ │ │ +00049780: 6573 7473 3a20 2020 2020 2020 2020 2020 ests: │ │ │ │ │ +00049790: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ +000497a0: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ +000497b0: 2020 286c 696e 6520 3132 3729 0a2a 2070 (line 127).* p │ │ │ │ │ +000497c0: 6172 616c 6c65 6c2d 7465 7374 732c 2055 arallel-tests, U │ │ │ │ │ +000497d0: 7369 6e67 3a20 2020 2020 2020 2020 2020 sing: │ │ │ │ │ +000497e0: 2020 2020 2020 5369 6d70 6c65 2054 6573 Simple Tes │ │ │ │ │ +000497f0: 7473 2075 7369 6e67 2070 6172 616c 6c65 ts using paralle │ │ │ │ │ +00049800: 6c2d 7465 7374 732e 0a20 2020 2020 2020 l-tests.. │ │ │ │ │ 00049810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049830: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049840: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -00049850: 0a2a 2050 6174 6820 7374 7269 7070 696e .* Path strippin │ │ │ │ │ -00049860: 672c 2061 766f 6964 696e 673a 2020 2020 g, avoiding: │ │ │ │ │ -00049870: 2020 2020 2020 2020 2020 416c 7465 726e Altern │ │ │ │ │ -00049880: 6174 6976 652e 2020 2020 2020 2020 2028 ative. ( │ │ │ │ │ -00049890: 6c69 6e65 2020 3233 290a 2a20 7061 7820 line 23).* pax │ │ │ │ │ -000498a0: 666f 726d 6174 3a20 2020 2020 2020 2020 format: │ │ │ │ │ +00049840: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +00049850: 290a 2a20 5061 7468 2073 7472 6970 7069 ).* Path strippi │ │ │ │ │ +00049860: 6e67 2c20 6176 6f69 6469 6e67 3a20 2020 ng, avoiding: │ │ │ │ │ +00049870: 2020 2020 2020 2020 2020 2041 6c74 6572 Alter │ │ │ │ │ +00049880: 6e61 7469 7665 2e20 2020 2020 2020 2020 native. │ │ │ │ │ +00049890: 286c 696e 6520 2032 3329 0a2a 2070 6178 (line 23).* pax │ │ │ │ │ +000498a0: 2066 6f72 6d61 743a 2020 2020 2020 2020 format: │ │ │ │ │ 000498b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000498c0: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ -000498d0: 2020 2020 2020 2020 286c 696e 6520 3138 (line 18 │ │ │ │ │ -000498e0: 3529 0a2a 2070 6466 3a20 2020 2020 2020 5).* pdf: │ │ │ │ │ +000498c0: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ +000498d0: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +000498e0: 3835 290a 2a20 7064 663a 2020 2020 2020 85).* pdf: │ │ │ │ │ 000498f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049900: 2020 2020 2020 2020 2020 2020 5465 7869 Texi │ │ │ │ │ -00049910: 6e66 6f2e 2020 2020 2020 2020 2020 2020 nfo. │ │ │ │ │ -00049920: 2028 6c69 6e65 2020 3139 290a 2a20 7064 (line 19).* pd │ │ │ │ │ -00049930: 6620 3c31 3e3a 2020 2020 2020 2020 2020 f <1>: │ │ │ │ │ +00049900: 2020 2020 2020 2020 2020 2020 2054 6578 Tex │ │ │ │ │ +00049910: 696e 666f 2e20 2020 2020 2020 2020 2020 info. │ │ │ │ │ +00049920: 2020 286c 696e 6520 2031 3929 0a2a 2070 (line 19).* p │ │ │ │ │ +00049930: 6466 203c 313e 3a20 2020 2020 2020 2020 df <1>: │ │ │ │ │ 00049940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049950: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ -00049960: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00049970: 2034 3129 0a2a 2050 4446 206f 7574 7075 41).* PDF outpu │ │ │ │ │ -00049980: 7420 7573 696e 6720 5465 7869 6e66 6f3a t using Texinfo: │ │ │ │ │ -00049990: 2020 2020 2020 2020 2020 2020 2020 5465 Te │ │ │ │ │ -000499a0: 7869 6e66 6f2e 2020 2020 2020 2020 2020 xinfo. │ │ │ │ │ -000499b0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -000499c0: 7064 662d 6c6f 6361 6c3a 2020 2020 2020 pdf-local: │ │ │ │ │ +00049950: 2020 2020 2020 4578 7465 6e64 696e 672e Extending. │ │ │ │ │ +00049960: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00049970: 2020 3431 290a 2a20 5044 4620 6f75 7470 41).* PDF outp │ │ │ │ │ +00049980: 7574 2075 7369 6e67 2054 6578 696e 666f ut using Texinfo │ │ │ │ │ +00049990: 3a20 2020 2020 2020 2020 2020 2020 2054 : T │ │ │ │ │ +000499a0: 6578 696e 666f 2e20 2020 2020 2020 2020 exinfo. │ │ │ │ │ +000499b0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +000499c0: 2070 6466 2d6c 6f63 616c 3a20 2020 2020 pdf-local: │ │ │ │ │ 000499d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000499e0: 2020 2020 2020 2045 7874 656e 6469 6e67 Extending │ │ │ │ │ -000499f0: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -00049a00: 6520 2034 3129 0a2a 2050 6572 2d6f 626a e 41).* Per-obj │ │ │ │ │ -00049a10: 6563 7420 666c 6167 732c 2065 6d75 6c61 ect flags, emula │ │ │ │ │ -00049a20: 7465 643a 2020 2020 2020 2020 2020 2020 ted: │ │ │ │ │ -00049a30: 5065 722d 4f62 6a65 6374 2046 6c61 6773 Per-Object Flags │ │ │ │ │ -00049a40: 2e20 2020 2028 6c69 6e65 2020 2036 290a . (line 6). │ │ │ │ │ -00049a50: 2a20 7065 722d 7461 7267 6574 2063 6f6d * per-target com │ │ │ │ │ -00049a60: 7069 6c61 7469 6f6e 2066 6c61 6773 2c20 pilation flags, │ │ │ │ │ -00049a70: 6465 6669 6e65 643a 2050 726f 6772 616d defined: Program │ │ │ │ │ -00049a80: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ -00049a90: 6961 626c 6573 2e0a 2020 2020 2020 2020 iables.. │ │ │ │ │ +000499e0: 2020 2020 2020 2020 4578 7465 6e64 696e Extendin │ │ │ │ │ +000499f0: 672e 2020 2020 2020 2020 2020 2028 6c69 g. (li │ │ │ │ │ +00049a00: 6e65 2020 3431 290a 2a20 5065 722d 6f62 ne 41).* Per-ob │ │ │ │ │ +00049a10: 6a65 6374 2066 6c61 6773 2c20 656d 756c ject flags, emul │ │ │ │ │ +00049a20: 6174 6564 3a20 2020 2020 2020 2020 2020 ated: │ │ │ │ │ +00049a30: 2050 6572 2d4f 626a 6563 7420 466c 6167 Per-Object Flag │ │ │ │ │ +00049a40: 732e 2020 2020 286c 696e 6520 2020 3629 s. (line 6) │ │ │ │ │ +00049a50: 0a2a 2070 6572 2d74 6172 6765 7420 636f .* per-target co │ │ │ │ │ +00049a60: 6d70 696c 6174 696f 6e20 666c 6167 732c mpilation flags, │ │ │ │ │ +00049a70: 2064 6566 696e 6564 3a20 5072 6f67 7261 defined: Progra │ │ │ │ │ +00049a80: 6d20 616e 6420 4c69 6272 6172 7920 5661 m and Library Va │ │ │ │ │ +00049a90: 7269 6162 6c65 732e 0a20 2020 2020 2020 riables.. │ │ │ │ │ 00049aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049ad0: 2020 2020 2020 286c 696e 6520 3138 3129 (line 181) │ │ │ │ │ -00049ae0: 0a2a 2070 6b67 6461 7461 6469 722c 2064 .* pkgdatadir, d │ │ │ │ │ -00049af0: 6566 696e 6564 3a20 2020 2020 2020 2020 efined: │ │ │ │ │ -00049b00: 2020 2020 2020 2020 2020 556e 6966 6f72 Unifor │ │ │ │ │ -00049b10: 6d2e 2020 2020 2020 2020 2020 2020 2028 m. ( │ │ │ │ │ -00049b20: 6c69 6e65 2020 3139 290a 2a20 706b 6769 line 19).* pkgi │ │ │ │ │ -00049b30: 6e63 6c75 6465 6469 722c 2064 6566 696e ncludedir, defin │ │ │ │ │ -00049b40: 6564 3a20 2020 2020 2020 2020 2020 2020 ed: │ │ │ │ │ -00049b50: 2020 2055 6e69 666f 726d 2e20 2020 2020 Uniform. │ │ │ │ │ -00049b60: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -00049b70: 3929 0a2a 2070 6b67 6c69 6264 6972 2c20 9).* pkglibdir, │ │ │ │ │ -00049b80: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ -00049b90: 2020 2020 2020 2020 2020 2020 556e 6966 Unif │ │ │ │ │ -00049ba0: 6f72 6d2e 2020 2020 2020 2020 2020 2020 orm. │ │ │ │ │ -00049bb0: 2028 6c69 6e65 2020 3139 290a 2a20 706b (line 19).* pk │ │ │ │ │ -00049bc0: 676c 6962 6578 6563 6469 722c 2064 6566 glibexecdir, def │ │ │ │ │ -00049bd0: 696e 6564 3a20 2020 2020 2020 2020 2020 ined: │ │ │ │ │ -00049be0: 2020 2020 2055 6e69 666f 726d 2e20 2020 Uniform. │ │ │ │ │ -00049bf0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00049c00: 2031 3929 0a2a 2050 4f53 4958 2074 6572 19).* POSIX ter │ │ │ │ │ -00049c10: 6d69 6f73 2068 6561 6465 7273 3a20 2020 mios headers: │ │ │ │ │ -00049c20: 2020 2020 2020 2020 2020 2020 2020 4f62 Ob │ │ │ │ │ -00049c30: 736f 6c65 7465 204d 6163 726f 732e 2020 solete Macros. │ │ │ │ │ -00049c40: 2020 2028 6c69 6e65 2020 3537 290a 2a20 (line 57).* │ │ │ │ │ -00049c50: 5072 6570 6172 696e 6720 6469 7374 7269 Preparing distri │ │ │ │ │ -00049c60: 6275 7469 6f6e 733a 2020 2020 2020 2020 butions: │ │ │ │ │ -00049c70: 2020 2020 2020 2050 7265 7061 7269 6e67 Preparing │ │ │ │ │ -00049c80: 2044 6973 7472 6962 7574 696f 6e73 2e0a Distributions.. │ │ │ │ │ -00049c90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00049ad0: 2020 2020 2020 2028 6c69 6e65 2031 3831 (line 181 │ │ │ │ │ +00049ae0: 290a 2a20 706b 6764 6174 6164 6972 2c20 ).* pkgdatadir, │ │ │ │ │ +00049af0: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ +00049b00: 2020 2020 2020 2020 2020 2055 6e69 666f Unifo │ │ │ │ │ +00049b10: 726d 2e20 2020 2020 2020 2020 2020 2020 rm. │ │ │ │ │ +00049b20: 286c 696e 6520 2031 3929 0a2a 2070 6b67 (line 19).* pkg │ │ │ │ │ +00049b30: 696e 636c 7564 6564 6972 2c20 6465 6669 includedir, defi │ │ │ │ │ +00049b40: 6e65 643a 2020 2020 2020 2020 2020 2020 ned: │ │ │ │ │ +00049b50: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ +00049b60: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +00049b70: 3139 290a 2a20 706b 676c 6962 6469 722c 19).* pkglibdir, │ │ │ │ │ +00049b80: 2064 6566 696e 6564 3a20 2020 2020 2020 defined: │ │ │ │ │ +00049b90: 2020 2020 2020 2020 2020 2020 2055 6e69 Uni │ │ │ │ │ +00049ba0: 666f 726d 2e20 2020 2020 2020 2020 2020 form. │ │ │ │ │ +00049bb0: 2020 286c 696e 6520 2031 3929 0a2a 2070 (line 19).* p │ │ │ │ │ +00049bc0: 6b67 6c69 6265 7865 6364 6972 2c20 6465 kglibexecdir, de │ │ │ │ │ +00049bd0: 6669 6e65 643a 2020 2020 2020 2020 2020 fined: │ │ │ │ │ +00049be0: 2020 2020 2020 556e 6966 6f72 6d2e 2020 Uniform. │ │ │ │ │ +00049bf0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00049c00: 2020 3139 290a 2a20 504f 5349 5820 7465 19).* POSIX te │ │ │ │ │ +00049c10: 726d 696f 7320 6865 6164 6572 733a 2020 rmios headers: │ │ │ │ │ +00049c20: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +00049c30: 6273 6f6c 6574 6520 4d61 6372 6f73 2e20 bsolete Macros. │ │ │ │ │ +00049c40: 2020 2020 286c 696e 6520 2035 3729 0a2a (line 57).* │ │ │ │ │ +00049c50: 2050 7265 7061 7269 6e67 2064 6973 7472 Preparing distr │ │ │ │ │ +00049c60: 6962 7574 696f 6e73 3a20 2020 2020 2020 ibutions: │ │ │ │ │ +00049c70: 2020 2020 2020 2020 5072 6570 6172 696e Preparin │ │ │ │ │ +00049c80: 6720 4469 7374 7269 6275 7469 6f6e 732e g Distributions. │ │ │ │ │ +00049c90: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00049ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049cc0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00049cd0: 696e 6520 2020 3629 0a2a 2050 7265 7072 ine 6).* Prepr │ │ │ │ │ -00049ce0: 6f63 6573 7369 6e67 2046 6f72 7472 616e ocessing Fortran │ │ │ │ │ -00049cf0: 2037 373a 2020 2020 2020 2020 2020 2020 77: │ │ │ │ │ -00049d00: 2020 5072 6570 726f 6365 7373 696e 6720 Preprocessing │ │ │ │ │ -00049d10: 466f 7274 7261 6e20 3737 2e0a 2020 2020 Fortran 77.. │ │ │ │ │ +00049cc0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00049cd0: 6c69 6e65 2020 2036 290a 2a20 5072 6570 line 6).* Prep │ │ │ │ │ +00049ce0: 726f 6365 7373 696e 6720 466f 7274 7261 rocessing Fortra │ │ │ │ │ +00049cf0: 6e20 3737 3a20 2020 2020 2020 2020 2020 n 77: │ │ │ │ │ +00049d00: 2020 2050 7265 7072 6f63 6573 7369 6e67 Preprocessing │ │ │ │ │ +00049d10: 2046 6f72 7472 616e 2037 372e 0a20 2020 Fortran 77.. │ │ │ │ │ 00049d20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00049d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00049d50: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00049d60: 2020 3629 0a2a 2050 7269 6d61 7279 2076 6).* Primary v │ │ │ │ │ -00049d70: 6172 6961 626c 652c 2044 4154 413a 2020 ariable, DATA: │ │ │ │ │ -00049d80: 2020 2020 2020 2020 2020 2020 2020 4461 Da │ │ │ │ │ -00049d90: 7461 2e20 2020 2020 2020 2020 2020 2020 ta. │ │ │ │ │ -00049da0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -00049db0: 5072 696d 6172 7920 7661 7269 6162 6c65 Primary variable │ │ │ │ │ -00049dc0: 2c20 6465 6669 6e65 643a 2020 2020 2020 , defined: │ │ │ │ │ -00049dd0: 2020 2020 2020 2055 6e69 666f 726d 2e20 Uniform. │ │ │ │ │ -00049de0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00049df0: 6520 2031 3129 0a2a 2050 7269 6d61 7279 e 11).* Primary │ │ │ │ │ -00049e00: 2076 6172 6961 626c 652c 2048 4541 4445 variable, HEADE │ │ │ │ │ -00049e10: 5253 3a20 2020 2020 2020 2020 2020 2020 RS: │ │ │ │ │ -00049e20: 4865 6164 6572 732e 2020 2020 2020 2020 Headers. │ │ │ │ │ -00049e30: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -00049e40: 2a20 5072 696d 6172 7920 7661 7269 6162 * Primary variab │ │ │ │ │ -00049e50: 6c65 2c20 4a41 5641 3a20 2020 2020 2020 le, JAVA: │ │ │ │ │ -00049e60: 2020 2020 2020 2020 204a 6176 612e 2020 Java. │ │ │ │ │ -00049e70: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00049e80: 696e 6520 2020 3629 0a2a 2050 7269 6d61 ine 6).* Prima │ │ │ │ │ -00049e90: 7279 2076 6172 6961 626c 652c 204c 4942 ry variable, LIB │ │ │ │ │ -00049ea0: 5241 5249 4553 3a20 2020 2020 2020 2020 RARIES: │ │ │ │ │ -00049eb0: 2020 4120 4c69 6272 6172 792e 2020 2020 A Library. │ │ │ │ │ -00049ec0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -00049ed0: 290a 2a20 5072 696d 6172 7920 7661 7269 ).* Primary vari │ │ │ │ │ -00049ee0: 6162 6c65 2c20 4c49 5350 3a20 2020 2020 able, LISP: │ │ │ │ │ -00049ef0: 2020 2020 2020 2020 2020 2045 6d61 6373 Emacs │ │ │ │ │ -00049f00: 204c 6973 702e 2020 2020 2020 2020 2020 Lisp. │ │ │ │ │ -00049f10: 286c 696e 6520 2020 3629 0a2a 2050 7269 (line 6).* Pri │ │ │ │ │ -00049f20: 6d61 7279 2076 6172 6961 626c 652c 204c mary variable, L │ │ │ │ │ -00049f30: 544c 4942 5241 5249 4553 3a20 2020 2020 TLIBRARIES: │ │ │ │ │ -00049f40: 2020 2020 4c69 6274 6f6f 6c20 4c69 6272 Libtool Libr │ │ │ │ │ -00049f50: 6172 6965 732e 2020 2028 6c69 6e65 2020 aries. (line │ │ │ │ │ -00049f60: 2036 290a 2a20 5072 696d 6172 7920 7661 6).* Primary va │ │ │ │ │ -00049f70: 7269 6162 6c65 2c20 4d41 4e53 3a20 2020 riable, MANS: │ │ │ │ │ -00049f80: 2020 2020 2020 2020 2020 2020 204d 616e Man │ │ │ │ │ -00049f90: 2050 6167 6573 2e20 2020 2020 2020 2020 Pages. │ │ │ │ │ -00049fa0: 2020 286c 696e 6520 2020 3629 0a2a 2050 (line 6).* P │ │ │ │ │ -00049fb0: 7269 6d61 7279 2076 6172 6961 626c 652c rimary variable, │ │ │ │ │ -00049fc0: 2050 524f 4752 414d 533a 2020 2020 2020 PROGRAMS: │ │ │ │ │ -00049fd0: 2020 2020 2020 556e 6966 6f72 6d2e 2020 Uniform. │ │ │ │ │ -00049fe0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00049ff0: 2020 3131 290a 2a20 5072 696d 6172 7920 11).* Primary │ │ │ │ │ -0004a000: 7661 7269 6162 6c65 2c20 5059 5448 4f4e variable, PYTHON │ │ │ │ │ -0004a010: 3a20 2020 2020 2020 2020 2020 2020 2050 : P │ │ │ │ │ -0004a020: 7974 686f 6e2e 2020 2020 2020 2020 2020 ython. │ │ │ │ │ -0004a030: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0004a040: 2050 7269 6d61 7279 2076 6172 6961 626c Primary variabl │ │ │ │ │ -0004a050: 652c 2053 4352 4950 5453 3a20 2020 2020 e, SCRIPTS: │ │ │ │ │ -0004a060: 2020 2020 2020 2020 5363 7269 7074 732e Scripts. │ │ │ │ │ -0004a070: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0004a080: 6e65 2020 2036 290a 2a20 5072 696d 6172 ne 6).* Primar │ │ │ │ │ -0004a090: 7920 7661 7269 6162 6c65 2c20 534f 5552 y variable, SOUR │ │ │ │ │ -0004a0a0: 4345 533a 2020 2020 2020 2020 2020 2020 CES: │ │ │ │ │ -0004a0b0: 2050 726f 6772 616d 2053 6f75 7263 6573 Program Sources │ │ │ │ │ -0004a0c0: 2e20 2020 2020 286c 696e 6520 2033 3229 . (line 32) │ │ │ │ │ -0004a0d0: 0a2a 2050 7269 6d61 7279 2076 6172 6961 .* Primary varia │ │ │ │ │ -0004a0e0: 626c 652c 2054 4558 494e 464f 533a 2020 ble, TEXINFOS: │ │ │ │ │ -0004a0f0: 2020 2020 2020 2020 2020 5465 7869 6e66 Texinf │ │ │ │ │ -0004a100: 6f2e 2020 2020 2020 2020 2020 2020 2028 o. ( │ │ │ │ │ -0004a110: 6c69 6e65 2020 2036 290a 2a20 5052 4f47 line 6).* PROG │ │ │ │ │ -0004a120: 5241 4d53 2070 7269 6d61 7279 2076 6172 RAMS primary var │ │ │ │ │ -0004a130: 6961 626c 653a 2020 2020 2020 2020 2020 iable: │ │ │ │ │ -0004a140: 2020 2055 6e69 666f 726d 2e20 2020 2020 Uniform. │ │ │ │ │ -0004a150: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -0004a160: 3129 0a2a 2050 726f 6772 616d 732c 2061 1).* Programs, a │ │ │ │ │ -0004a170: 7578 696c 6961 7279 3a20 2020 2020 2020 uxiliary: │ │ │ │ │ -0004a180: 2020 2020 2020 2020 2020 2020 4175 7869 Auxi │ │ │ │ │ -0004a190: 6c69 6172 7920 5072 6f67 7261 6d73 2e20 liary Programs. │ │ │ │ │ -0004a1a0: 2028 6c69 6e65 2020 2036 290a 2a20 5052 (line 6).* PR │ │ │ │ │ -0004a1b0: 4f47 5241 4d53 2c20 6269 6e64 6972 3a20 OGRAMS, bindir: │ │ │ │ │ +00049d50: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00049d60: 2020 2036 290a 2a20 5072 696d 6172 7920 6).* Primary │ │ │ │ │ +00049d70: 7661 7269 6162 6c65 2c20 4441 5441 3a20 variable, DATA: │ │ │ │ │ +00049d80: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ +00049d90: 6174 612e 2020 2020 2020 2020 2020 2020 ata. │ │ │ │ │ +00049da0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +00049db0: 2050 7269 6d61 7279 2076 6172 6961 626c Primary variabl │ │ │ │ │ +00049dc0: 652c 2064 6566 696e 6564 3a20 2020 2020 e, defined: │ │ │ │ │ +00049dd0: 2020 2020 2020 2020 556e 6966 6f72 6d2e Uniform. │ │ │ │ │ +00049de0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00049df0: 6e65 2020 3131 290a 2a20 5072 696d 6172 ne 11).* Primar │ │ │ │ │ +00049e00: 7920 7661 7269 6162 6c65 2c20 4845 4144 y variable, HEAD │ │ │ │ │ +00049e10: 4552 533a 2020 2020 2020 2020 2020 2020 ERS: │ │ │ │ │ +00049e20: 2048 6561 6465 7273 2e20 2020 2020 2020 Headers. │ │ │ │ │ +00049e30: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +00049e40: 0a2a 2050 7269 6d61 7279 2076 6172 6961 .* Primary varia │ │ │ │ │ +00049e50: 626c 652c 204a 4156 413a 2020 2020 2020 ble, JAVA: │ │ │ │ │ +00049e60: 2020 2020 2020 2020 2020 4a61 7661 2e20 Java. │ │ │ │ │ +00049e70: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00049e80: 6c69 6e65 2020 2036 290a 2a20 5072 696d line 6).* Prim │ │ │ │ │ +00049e90: 6172 7920 7661 7269 6162 6c65 2c20 4c49 ary variable, LI │ │ │ │ │ +00049ea0: 4252 4152 4945 533a 2020 2020 2020 2020 BRARIES: │ │ │ │ │ +00049eb0: 2020 2041 204c 6962 7261 7279 2e20 2020 A Library. │ │ │ │ │ +00049ec0: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +00049ed0: 3629 0a2a 2050 7269 6d61 7279 2076 6172 6).* Primary var │ │ │ │ │ +00049ee0: 6961 626c 652c 204c 4953 503a 2020 2020 iable, LISP: │ │ │ │ │ +00049ef0: 2020 2020 2020 2020 2020 2020 456d 6163 Emac │ │ │ │ │ +00049f00: 7320 4c69 7370 2e20 2020 2020 2020 2020 s Lisp. │ │ │ │ │ +00049f10: 2028 6c69 6e65 2020 2036 290a 2a20 5072 (line 6).* Pr │ │ │ │ │ +00049f20: 696d 6172 7920 7661 7269 6162 6c65 2c20 imary variable, │ │ │ │ │ +00049f30: 4c54 4c49 4252 4152 4945 533a 2020 2020 LTLIBRARIES: │ │ │ │ │ +00049f40: 2020 2020 204c 6962 746f 6f6c 204c 6962 Libtool Lib │ │ │ │ │ +00049f50: 7261 7269 6573 2e20 2020 286c 696e 6520 raries. (line │ │ │ │ │ +00049f60: 2020 3629 0a2a 2050 7269 6d61 7279 2076 6).* Primary v │ │ │ │ │ +00049f70: 6172 6961 626c 652c 204d 414e 533a 2020 ariable, MANS: │ │ │ │ │ +00049f80: 2020 2020 2020 2020 2020 2020 2020 4d61 Ma │ │ │ │ │ +00049f90: 6e20 5061 6765 732e 2020 2020 2020 2020 n Pages. │ │ │ │ │ +00049fa0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +00049fb0: 5072 696d 6172 7920 7661 7269 6162 6c65 Primary variable │ │ │ │ │ +00049fc0: 2c20 5052 4f47 5241 4d53 3a20 2020 2020 , PROGRAMS: │ │ │ │ │ +00049fd0: 2020 2020 2020 2055 6e69 666f 726d 2e20 Uniform. │ │ │ │ │ +00049fe0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00049ff0: 6520 2031 3129 0a2a 2050 7269 6d61 7279 e 11).* Primary │ │ │ │ │ +0004a000: 2076 6172 6961 626c 652c 2050 5954 484f variable, PYTHO │ │ │ │ │ +0004a010: 4e3a 2020 2020 2020 2020 2020 2020 2020 N: │ │ │ │ │ +0004a020: 5079 7468 6f6e 2e20 2020 2020 2020 2020 Python. │ │ │ │ │ +0004a030: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0004a040: 2a20 5072 696d 6172 7920 7661 7269 6162 * Primary variab │ │ │ │ │ +0004a050: 6c65 2c20 5343 5249 5054 533a 2020 2020 le, SCRIPTS: │ │ │ │ │ +0004a060: 2020 2020 2020 2020 2053 6372 6970 7473 Scripts │ │ │ │ │ +0004a070: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0004a080: 696e 6520 2020 3629 0a2a 2050 7269 6d61 ine 6).* Prima │ │ │ │ │ +0004a090: 7279 2076 6172 6961 626c 652c 2053 4f55 ry variable, SOU │ │ │ │ │ +0004a0a0: 5243 4553 3a20 2020 2020 2020 2020 2020 RCES: │ │ │ │ │ +0004a0b0: 2020 5072 6f67 7261 6d20 536f 7572 6365 Program Source │ │ │ │ │ +0004a0c0: 732e 2020 2020 2028 6c69 6e65 2020 3332 s. (line 32 │ │ │ │ │ +0004a0d0: 290a 2a20 5072 696d 6172 7920 7661 7269 ).* Primary vari │ │ │ │ │ +0004a0e0: 6162 6c65 2c20 5445 5849 4e46 4f53 3a20 able, TEXINFOS: │ │ │ │ │ +0004a0f0: 2020 2020 2020 2020 2020 2054 6578 696e Texin │ │ │ │ │ +0004a100: 666f 2e20 2020 2020 2020 2020 2020 2020 fo. │ │ │ │ │ +0004a110: 286c 696e 6520 2020 3629 0a2a 2050 524f (line 6).* PRO │ │ │ │ │ +0004a120: 4752 414d 5320 7072 696d 6172 7920 7661 GRAMS primary va │ │ │ │ │ +0004a130: 7269 6162 6c65 3a20 2020 2020 2020 2020 riable: │ │ │ │ │ +0004a140: 2020 2020 556e 6966 6f72 6d2e 2020 2020 Uniform. │ │ │ │ │ +0004a150: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0004a160: 3131 290a 2a20 5072 6f67 7261 6d73 2c20 11).* Programs, │ │ │ │ │ +0004a170: 6175 7869 6c69 6172 793a 2020 2020 2020 auxiliary: │ │ │ │ │ +0004a180: 2020 2020 2020 2020 2020 2020 2041 7578 Aux │ │ │ │ │ +0004a190: 696c 6961 7279 2050 726f 6772 616d 732e iliary Programs. │ │ │ │ │ +0004a1a0: 2020 286c 696e 6520 2020 3629 0a2a 2050 (line 6).* P │ │ │ │ │ +0004a1b0: 524f 4752 414d 532c 2062 696e 6469 723a ROGRAMS, bindir: │ │ │ │ │ 0004a1c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a1d0: 2020 2020 2050 726f 6772 616d 2053 6f75 Program Sou │ │ │ │ │ -0004a1e0: 7263 6573 2e20 2020 2020 286c 696e 6520 rces. (line │ │ │ │ │ -0004a1f0: 2020 3629 0a2a 2050 726f 6772 616d 732c 6).* Programs, │ │ │ │ │ -0004a200: 2063 6f6e 6469 7469 6f6e 616c 3a20 2020 conditional: │ │ │ │ │ -0004a210: 2020 2020 2020 2020 2020 2020 2020 436f Co │ │ │ │ │ -0004a220: 6e64 6974 696f 6e61 6c20 5072 6f67 7261 nditional Progra │ │ │ │ │ -0004a230: 6d73 2e0a 2020 2020 2020 2020 2020 2020 ms.. │ │ │ │ │ +0004a1d0: 2020 2020 2020 5072 6f67 7261 6d20 536f Program So │ │ │ │ │ +0004a1e0: 7572 6365 732e 2020 2020 2028 6c69 6e65 urces. (line │ │ │ │ │ +0004a1f0: 2020 2036 290a 2a20 5072 6f67 7261 6d73 6).* Programs │ │ │ │ │ +0004a200: 2c20 636f 6e64 6974 696f 6e61 6c3a 2020 , conditional: │ │ │ │ │ +0004a210: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ +0004a220: 6f6e 6469 7469 6f6e 616c 2050 726f 6772 onditional Progr │ │ │ │ │ +0004a230: 616d 732e 0a20 2020 2020 2020 2020 2020 ams.. │ │ │ │ │ 0004a240: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a250: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a270: 2020 286c 696e 6520 2020 3629 0a2a 2050 (line 6).* P │ │ │ │ │ -0004a280: 726f 6772 616d 732c 2072 656e 616d 696e rograms, renamin │ │ │ │ │ -0004a290: 6720 6475 7269 6e67 2069 6e73 7461 6c6c g during install │ │ │ │ │ -0004a2a0: 6174 696f 6e3a 2052 656e 616d 696e 672e ation: Renaming. │ │ │ │ │ -0004a2b0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0004a2c0: 2020 2036 290a 2a20 7072 6f67 5f4c 4441 6).* prog_LDA │ │ │ │ │ -0004a2d0: 4444 2c20 6465 6669 6e65 643a 2020 2020 DD, defined: │ │ │ │ │ -0004a2e0: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ │ -0004a2f0: 696e 6b69 6e67 2e20 2020 2020 2020 2020 inking. │ │ │ │ │ -0004a300: 2020 2020 286c 696e 6520 2031 3229 0a2a (line 12).* │ │ │ │ │ -0004a310: 2050 726f 7879 204d 616b 6566 696c 6520 Proxy Makefile │ │ │ │ │ -0004a320: 666f 7220 7468 6972 642d 7061 7274 7920 for third-party │ │ │ │ │ -0004a330: 7061 636b 6167 6573 3a20 5468 6972 642d packages: Third- │ │ │ │ │ -0004a340: 5061 7274 7920 4d61 6b65 6669 6c65 732e Party Makefiles. │ │ │ │ │ -0004a350: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0004a270: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ +0004a280: 5072 6f67 7261 6d73 2c20 7265 6e61 6d69 Programs, renami │ │ │ │ │ +0004a290: 6e67 2064 7572 696e 6720 696e 7374 616c ng during instal │ │ │ │ │ +0004a2a0: 6c61 7469 6f6e 3a20 5265 6e61 6d69 6e67 lation: Renaming │ │ │ │ │ +0004a2b0: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ +0004a2c0: 6520 2020 3629 0a2a 2070 726f 675f 4c44 e 6).* prog_LD │ │ │ │ │ +0004a2d0: 4144 442c 2064 6566 696e 6564 3a20 2020 ADD, defined: │ │ │ │ │ +0004a2e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0004a2f0: 4c69 6e6b 696e 672e 2020 2020 2020 2020 Linking. │ │ │ │ │ +0004a300: 2020 2020 2028 6c69 6e65 2020 3132 290a (line 12). │ │ │ │ │ +0004a310: 2a20 5072 6f78 7920 4d61 6b65 6669 6c65 * Proxy Makefile │ │ │ │ │ +0004a320: 2066 6f72 2074 6869 7264 2d70 6172 7479 for third-party │ │ │ │ │ +0004a330: 2070 6163 6b61 6765 733a 2054 6869 7264 packages: Third │ │ │ │ │ +0004a340: 2d50 6172 7479 204d 616b 6566 696c 6573 -Party Makefiles │ │ │ │ │ +0004a350: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 0004a360: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a380: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0004a390: 6c69 6e65 2031 3238 290a 2a20 7073 3a20 line 128).* ps: │ │ │ │ │ +0004a380: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0004a390: 286c 696e 6520 3132 3829 0a2a 2070 733a (line 128).* ps: │ │ │ │ │ 0004a3a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a3b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a3c0: 2020 2054 6578 696e 666f 2e20 2020 2020 Texinfo. │ │ │ │ │ -0004a3d0: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -0004a3e0: 3929 0a2a 2070 7320 3c31 3e3a 2020 2020 9).* ps <1>: │ │ │ │ │ +0004a3c0: 2020 2020 5465 7869 6e66 6f2e 2020 2020 Texinfo. │ │ │ │ │ +0004a3d0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0004a3e0: 3139 290a 2a20 7073 203c 313e 3a20 2020 19).* ps <1>: │ │ │ │ │ 0004a3f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a400: 2020 2020 2020 2020 2020 2020 4578 7465 Exte │ │ │ │ │ -0004a410: 6e64 696e 672e 2020 2020 2020 2020 2020 nding. │ │ │ │ │ -0004a420: 2028 6c69 6e65 2020 3431 290a 2a20 5053 (line 41).* PS │ │ │ │ │ -0004a430: 206f 7574 7075 7420 7573 696e 6720 5465 output using Te │ │ │ │ │ -0004a440: 7869 6e66 6f3a 2020 2020 2020 2020 2020 xinfo: │ │ │ │ │ -0004a450: 2020 2020 2054 6578 696e 666f 2e20 2020 Texinfo. │ │ │ │ │ -0004a460: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004a470: 2020 3629 0a2a 2070 732d 6c6f 6361 6c3a 6).* ps-local: │ │ │ │ │ -0004a480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a490: 2020 2020 2020 2020 2020 2020 2020 4578 Ex │ │ │ │ │ -0004a4a0: 7465 6e64 696e 672e 2020 2020 2020 2020 tending. │ │ │ │ │ -0004a4b0: 2020 2028 6c69 6e65 2020 3431 290a 2a20 (line 41).* │ │ │ │ │ -0004a4c0: 5059 5448 4f4e 2070 7269 6d61 7279 2c20 PYTHON primary, │ │ │ │ │ -0004a4d0: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ -0004a4e0: 2020 2020 2020 2050 7974 686f 6e2e 2020 Python. │ │ │ │ │ -0004a4f0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0004a500: 6520 2020 3629 0a2a 2052 6174 666f 7220 e 6).* Ratfor │ │ │ │ │ -0004a510: 7072 6f67 7261 6d73 3a20 2020 2020 2020 programs: │ │ │ │ │ +0004a400: 2020 2020 2020 2020 2020 2020 2045 7874 Ext │ │ │ │ │ +0004a410: 656e 6469 6e67 2e20 2020 2020 2020 2020 ending. │ │ │ │ │ +0004a420: 2020 286c 696e 6520 2034 3129 0a2a 2050 (line 41).* P │ │ │ │ │ +0004a430: 5320 6f75 7470 7574 2075 7369 6e67 2054 S output using T │ │ │ │ │ +0004a440: 6578 696e 666f 3a20 2020 2020 2020 2020 exinfo: │ │ │ │ │ +0004a450: 2020 2020 2020 5465 7869 6e66 6f2e 2020 Texinfo. │ │ │ │ │ +0004a460: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0004a470: 2020 2036 290a 2a20 7073 2d6c 6f63 616c 6).* ps-local │ │ │ │ │ +0004a480: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0004a490: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +0004a4a0: 7874 656e 6469 6e67 2e20 2020 2020 2020 xtending. │ │ │ │ │ +0004a4b0: 2020 2020 286c 696e 6520 2034 3129 0a2a (line 41).* │ │ │ │ │ +0004a4c0: 2050 5954 484f 4e20 7072 696d 6172 792c PYTHON primary, │ │ │ │ │ +0004a4d0: 2064 6566 696e 6564 3a20 2020 2020 2020 defined: │ │ │ │ │ +0004a4e0: 2020 2020 2020 2020 5079 7468 6f6e 2e20 Python. │ │ │ │ │ +0004a4f0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0004a500: 6e65 2020 2036 290a 2a20 5261 7466 6f72 ne 6).* Ratfor │ │ │ │ │ +0004a510: 2070 726f 6772 616d 733a 2020 2020 2020 programs: │ │ │ │ │ 0004a520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a530: 5072 6570 726f 6365 7373 696e 6720 466f Preprocessing Fo │ │ │ │ │ -0004a540: 7274 7261 6e20 3737 2e0a 2020 2020 2020 rtran 77.. │ │ │ │ │ +0004a530: 2050 7265 7072 6f63 6573 7369 6e67 2046 Preprocessing F │ │ │ │ │ +0004a540: 6f72 7472 616e 2037 372e 0a20 2020 2020 ortran 77.. │ │ │ │ │ 0004a550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a580: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ -0004a590: 3629 0a2a 2072 6561 642d 6f6e 6c79 2073 6).* read-only s │ │ │ │ │ -0004a5a0: 6f75 7263 6520 7472 6565 3a20 2020 2020 ource tree: │ │ │ │ │ -0004a5b0: 2020 2020 2020 2020 2020 2020 5650 4154 VPAT │ │ │ │ │ -0004a5c0: 4820 4275 696c 6473 2e20 2020 2020 2020 H Builds. │ │ │ │ │ -0004a5d0: 2028 6c69 6e65 2020 3839 290a 2a20 7265 (line 89).* re │ │ │ │ │ -0004a5e0: 6164 6d65 2d61 6c70 6861 3a20 2020 2020 adme-alpha: │ │ │ │ │ +0004a580: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0004a590: 2036 290a 2a20 7265 6164 2d6f 6e6c 7920 6).* read-only │ │ │ │ │ +0004a5a0: 736f 7572 6365 2074 7265 653a 2020 2020 source tree: │ │ │ │ │ +0004a5b0: 2020 2020 2020 2020 2020 2020 2056 5041 VPA │ │ │ │ │ +0004a5c0: 5448 2042 7569 6c64 732e 2020 2020 2020 TH Builds. │ │ │ │ │ +0004a5d0: 2020 286c 696e 6520 2038 3929 0a2a 2072 (line 89).* r │ │ │ │ │ +0004a5e0: 6561 646d 652d 616c 7068 613a 2020 2020 eadme-alpha: │ │ │ │ │ 0004a5f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a600: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ -0004a610: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004a620: 3133 3129 0a2a 2052 4541 444d 452d 616c 131).* README-al │ │ │ │ │ -0004a630: 7068 613a 2020 2020 2020 2020 2020 2020 pha: │ │ │ │ │ -0004a640: 2020 2020 2020 2020 2020 2020 2020 476e Gn │ │ │ │ │ -0004a650: 6974 732e 2020 2020 2020 2020 2020 2020 its. │ │ │ │ │ -0004a660: 2020 2028 6c69 6e65 2020 3432 290a 2a20 (line 42).* │ │ │ │ │ -0004a670: 7265 6275 696c 6420 7275 6c65 733a 2020 rebuild rules: │ │ │ │ │ +0004a600: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ +0004a610: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0004a620: 2031 3331 290a 2a20 5245 4144 4d45 2d61 131).* README-a │ │ │ │ │ +0004a630: 6c70 6861 3a20 2020 2020 2020 2020 2020 lpha: │ │ │ │ │ +0004a640: 2020 2020 2020 2020 2020 2020 2020 2047 G │ │ │ │ │ +0004a650: 6e69 7473 2e20 2020 2020 2020 2020 2020 nits. │ │ │ │ │ +0004a660: 2020 2020 286c 696e 6520 2034 3229 0a2a (line 42).* │ │ │ │ │ +0004a670: 2072 6562 7569 6c64 2072 756c 6573 3a20 rebuild rules: │ │ │ │ │ 0004a680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a690: 2020 2020 2020 2052 6562 7569 6c64 696e Rebuildin │ │ │ │ │ -0004a6a0: 672e 2020 2020 2020 2020 2020 286c 696e g. (lin │ │ │ │ │ -0004a6b0: 6520 2020 3629 0a2a 2072 6562 7569 6c64 e 6).* rebuild │ │ │ │ │ -0004a6c0: 2072 756c 6573 203c 313e 3a20 2020 2020 rules <1>: │ │ │ │ │ +0004a690: 2020 2020 2020 2020 5265 6275 696c 6469 Rebuildi │ │ │ │ │ +0004a6a0: 6e67 2e20 2020 2020 2020 2020 2028 6c69 ng. (li │ │ │ │ │ +0004a6b0: 6e65 2020 2036 290a 2a20 7265 6275 696c ne 6).* rebuil │ │ │ │ │ +0004a6c0: 6420 7275 6c65 7320 3c31 3e3a 2020 2020 d rules <1>: │ │ │ │ │ 0004a6d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a6e0: 4356 532e 2020 2020 2020 2020 2020 2020 CVS. │ │ │ │ │ -0004a6f0: 2020 2020 2028 6c69 6e65 2020 2039 290a (line 9). │ │ │ │ │ -0004a700: 2a20 7265 6368 6563 6b3a 2020 2020 2020 * recheck: │ │ │ │ │ +0004a6e0: 2043 5653 2e20 2020 2020 2020 2020 2020 CVS. │ │ │ │ │ +0004a6f0: 2020 2020 2020 286c 696e 6520 2020 3929 (line 9) │ │ │ │ │ +0004a700: 0a2a 2072 6563 6865 636b 3a20 2020 2020 .* recheck: │ │ │ │ │ 0004a710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a720: 2020 2020 2020 2020 2053 696d 706c 6520 Simple │ │ │ │ │ -0004a730: 5465 7374 7320 7573 696e 6720 7061 7261 Tests using para │ │ │ │ │ -0004a740: 6c6c 656c 2d74 6573 7473 2e0a 2020 2020 llel-tests.. │ │ │ │ │ +0004a720: 2020 2020 2020 2020 2020 5369 6d70 6c65 Simple │ │ │ │ │ +0004a730: 2054 6573 7473 2075 7369 6e67 2070 6172 Tests using par │ │ │ │ │ +0004a740: 616c 6c65 6c2d 7465 7374 732e 0a20 2020 allel-tests.. │ │ │ │ │ 0004a750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a770: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a780: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004a790: 3132 3929 0a2a 2052 6563 6f67 6e69 7a65 129).* Recognize │ │ │ │ │ -0004a7a0: 6420 6d61 6372 6f73 2062 7920 4175 746f d macros by Auto │ │ │ │ │ -0004a7b0: 6d61 6b65 3a20 2020 2020 2020 2020 4f70 make: Op │ │ │ │ │ -0004a7c0: 7469 6f6e 616c 2e20 2020 2020 2020 2020 tional. │ │ │ │ │ -0004a7d0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -0004a7e0: 5265 6375 7273 6976 6520 6f70 6572 6174 Recursive operat │ │ │ │ │ -0004a7f0: 696f 6e20 6f66 2041 7574 6f6d 616b 653a ion of Automake: │ │ │ │ │ -0004a800: 2020 2020 2020 2047 656e 6572 616c 204f General O │ │ │ │ │ -0004a810: 7065 7261 7469 6f6e 2e20 2020 286c 696e peration. (lin │ │ │ │ │ -0004a820: 6520 2035 3829 0a2a 2072 6563 7572 7369 e 58).* recursi │ │ │ │ │ -0004a830: 7665 2074 6172 6765 7473 2061 6e64 2074 ve targets and t │ │ │ │ │ -0004a840: 6869 7264 2d70 6172 7479 204d 616b 6566 hird-party Makef │ │ │ │ │ -0004a850: 696c 6573 3a20 5468 6972 642d 5061 7274 iles: Third-Part │ │ │ │ │ -0004a860: 7920 4d61 6b65 6669 6c65 732e 0a20 2020 y Makefiles.. │ │ │ │ │ +0004a780: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0004a790: 2031 3239 290a 2a20 5265 636f 676e 697a 129).* Recogniz │ │ │ │ │ +0004a7a0: 6564 206d 6163 726f 7320 6279 2041 7574 ed macros by Aut │ │ │ │ │ +0004a7b0: 6f6d 616b 653a 2020 2020 2020 2020 204f omake: O │ │ │ │ │ +0004a7c0: 7074 696f 6e61 6c2e 2020 2020 2020 2020 ptional. │ │ │ │ │ +0004a7d0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +0004a7e0: 2052 6563 7572 7369 7665 206f 7065 7261 Recursive opera │ │ │ │ │ +0004a7f0: 7469 6f6e 206f 6620 4175 746f 6d61 6b65 tion of Automake │ │ │ │ │ +0004a800: 3a20 2020 2020 2020 4765 6e65 7261 6c20 : General │ │ │ │ │ +0004a810: 4f70 6572 6174 696f 6e2e 2020 2028 6c69 Operation. (li │ │ │ │ │ +0004a820: 6e65 2020 3538 290a 2a20 7265 6375 7273 ne 58).* recurs │ │ │ │ │ +0004a830: 6976 6520 7461 7267 6574 7320 616e 6420 ive targets and │ │ │ │ │ +0004a840: 7468 6972 642d 7061 7274 7920 4d61 6b65 third-party Make │ │ │ │ │ +0004a850: 6669 6c65 733a 2054 6869 7264 2d50 6172 files: Third-Par │ │ │ │ │ +0004a860: 7479 204d 616b 6566 696c 6573 2e0a 2020 ty Makefiles.. │ │ │ │ │ 0004a870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004a890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a8a0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0004a8b0: 2020 3135 290a 2a20 7265 6765 7820 7061 15).* regex pa │ │ │ │ │ -0004a8c0: 636b 6167 653a 2020 2020 2020 2020 2020 ckage: │ │ │ │ │ -0004a8d0: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ -0004a8e0: 6273 6f6c 6574 6520 4d61 6372 6f73 2e20 bsolete Macros. │ │ │ │ │ -0004a8f0: 2020 2020 286c 696e 6520 2036 3429 0a2a (line 64).* │ │ │ │ │ -0004a900: 2052 656e 616d 696e 6720 7072 6f67 7261 Renaming progra │ │ │ │ │ -0004a910: 6d73 3a20 2020 2020 2020 2020 2020 2020 ms: │ │ │ │ │ -0004a920: 2020 2020 2020 2020 5265 6e61 6d69 6e67 Renaming │ │ │ │ │ -0004a930: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ │ -0004a940: 6e65 2020 2036 290a 2a20 5265 706f 7274 ne 6).* Report │ │ │ │ │ -0004a950: 696e 6720 6275 6773 3a20 2020 2020 2020 ing bugs: │ │ │ │ │ +0004a8a0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0004a8b0: 6520 2031 3529 0a2a 2072 6567 6578 2070 e 15).* regex p │ │ │ │ │ +0004a8c0: 6163 6b61 6765 3a20 2020 2020 2020 2020 ackage: │ │ │ │ │ +0004a8d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0004a8e0: 4f62 736f 6c65 7465 204d 6163 726f 732e Obsolete Macros. │ │ │ │ │ +0004a8f0: 2020 2020 2028 6c69 6e65 2020 3634 290a (line 64). │ │ │ │ │ +0004a900: 2a20 5265 6e61 6d69 6e67 2070 726f 6772 * Renaming progr │ │ │ │ │ +0004a910: 616d 733a 2020 2020 2020 2020 2020 2020 ams: │ │ │ │ │ +0004a920: 2020 2020 2020 2020 2052 656e 616d 696e Renamin │ │ │ │ │ +0004a930: 672e 2020 2020 2020 2020 2020 2020 286c g. (l │ │ │ │ │ +0004a940: 696e 6520 2020 3629 0a2a 2052 6570 6f72 ine 6).* Repor │ │ │ │ │ +0004a950: 7469 6e67 2062 7567 733a 2020 2020 2020 ting bugs: │ │ │ │ │ 0004a960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004a970: 2049 6e74 726f 6475 6374 696f 6e2e 2020 Introduction. │ │ │ │ │ -0004a980: 2020 2020 2020 286c 696e 6520 2033 3129 (line 31) │ │ │ │ │ -0004a990: 0a2a 2052 6571 7569 7265 6d65 6e74 7320 .* Requirements │ │ │ │ │ -0004a9a0: 6f66 2041 7574 6f6d 616b 653a 2020 2020 of Automake: │ │ │ │ │ -0004a9b0: 2020 2020 2020 2020 2020 5265 7175 6972 Requir │ │ │ │ │ -0004a9c0: 656d 656e 7473 2e20 2020 2020 2020 2028 ements. ( │ │ │ │ │ -0004a9d0: 6c69 6e65 2020 2036 290a 2a20 5265 7175 line 6).* Requ │ │ │ │ │ -0004a9e0: 6972 656d 656e 7473 2c20 4175 746f 6d61 irements, Automa │ │ │ │ │ -0004a9f0: 6b65 3a20 2020 2020 2020 2020 2020 2020 ke: │ │ │ │ │ -0004aa00: 2020 2049 6e74 726f 6475 6374 696f 6e2e Introduction. │ │ │ │ │ -0004aa10: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ -0004aa20: 3729 0a2a 2052 6573 7472 6963 7469 6f6e 7).* Restriction │ │ │ │ │ -0004aa30: 7320 666f 7220 4a41 5641 3a20 2020 2020 s for JAVA: │ │ │ │ │ -0004aa40: 2020 2020 2020 2020 2020 2020 4a61 7661 Java │ │ │ │ │ -0004aa50: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -0004aa60: 2028 6c69 6e65 2020 3235 290a 2a20 5246 (line 25).* RF │ │ │ │ │ -0004aa70: 4c41 4753 2061 6e64 2041 4d5f 5246 4c41 LAGS and AM_RFLA │ │ │ │ │ -0004aa80: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ -0004aa90: 2020 2020 2046 6c61 6720 5661 7269 6162 Flag Variab │ │ │ │ │ -0004aaa0: 6c65 7320 4f72 6465 7269 6e67 2e0a 2020 les Ordering.. │ │ │ │ │ +0004a970: 2020 496e 7472 6f64 7563 7469 6f6e 2e20 Introduction. │ │ │ │ │ +0004a980: 2020 2020 2020 2028 6c69 6e65 2020 3331 (line 31 │ │ │ │ │ +0004a990: 290a 2a20 5265 7175 6972 656d 656e 7473 ).* Requirements │ │ │ │ │ +0004a9a0: 206f 6620 4175 746f 6d61 6b65 3a20 2020 of Automake: │ │ │ │ │ +0004a9b0: 2020 2020 2020 2020 2020 2052 6571 7569 Requi │ │ │ │ │ +0004a9c0: 7265 6d65 6e74 732e 2020 2020 2020 2020 rements. │ │ │ │ │ +0004a9d0: 286c 696e 6520 2020 3629 0a2a 2052 6571 (line 6).* Req │ │ │ │ │ +0004a9e0: 7569 7265 6d65 6e74 732c 2041 7574 6f6d uirements, Autom │ │ │ │ │ +0004a9f0: 616b 653a 2020 2020 2020 2020 2020 2020 ake: │ │ │ │ │ +0004aa00: 2020 2020 496e 7472 6f64 7563 7469 6f6e Introduction │ │ │ │ │ +0004aa10: 2e20 2020 2020 2020 2028 6c69 6e65 2020 . (line │ │ │ │ │ +0004aa20: 3237 290a 2a20 5265 7374 7269 6374 696f 27).* Restrictio │ │ │ │ │ +0004aa30: 6e73 2066 6f72 204a 4156 413a 2020 2020 ns for JAVA: │ │ │ │ │ +0004aa40: 2020 2020 2020 2020 2020 2020 204a 6176 Jav │ │ │ │ │ +0004aa50: 612e 2020 2020 2020 2020 2020 2020 2020 a. │ │ │ │ │ +0004aa60: 2020 286c 696e 6520 2032 3529 0a2a 2052 (line 25).* R │ │ │ │ │ +0004aa70: 464c 4147 5320 616e 6420 414d 5f52 464c FLAGS and AM_RFL │ │ │ │ │ +0004aa80: 4147 533a 2020 2020 2020 2020 2020 2020 AGS: │ │ │ │ │ +0004aa90: 2020 2020 2020 466c 6167 2056 6172 6961 Flag Varia │ │ │ │ │ +0004aaa0: 626c 6573 204f 7264 6572 696e 672e 0a20 bles Ordering.. │ │ │ │ │ 0004aab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004aac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004aad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004aae0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0004aaf0: 6520 2032 3029 0a2a 2072 756c 6573 2077 e 20).* rules w │ │ │ │ │ -0004ab00: 6974 6820 6d75 6c74 6970 6c65 206f 7574 ith multiple out │ │ │ │ │ -0004ab10: 7075 7473 3a20 2020 2020 2020 2020 2020 puts: │ │ │ │ │ -0004ab20: 4d75 6c74 6970 6c65 204f 7574 7075 7473 Multiple Outputs │ │ │ │ │ -0004ab30: 2e20 2020 2028 6c69 6e65 2020 2036 290a . (line 6). │ │ │ │ │ -0004ab40: 2a20 7275 6c65 732c 2063 6f6e 666c 6963 * rules, conflic │ │ │ │ │ -0004ab50: 7469 6e67 3a20 2020 2020 2020 2020 2020 ting: │ │ │ │ │ -0004ab60: 2020 2020 2020 2020 2045 7874 656e 6469 Extendi │ │ │ │ │ -0004ab70: 6e67 2e20 2020 2020 2020 2020 2020 286c ng. (l │ │ │ │ │ -0004ab80: 696e 6520 2031 3429 0a2a 2072 756c 6573 ine 14).* rules │ │ │ │ │ -0004ab90: 2c20 6465 6275 6767 696e 673a 2020 2020 , debugging: │ │ │ │ │ +0004aae0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0004aaf0: 6e65 2020 3230 290a 2a20 7275 6c65 7320 ne 20).* rules │ │ │ │ │ +0004ab00: 7769 7468 206d 756c 7469 706c 6520 6f75 with multiple ou │ │ │ │ │ +0004ab10: 7470 7574 733a 2020 2020 2020 2020 2020 tputs: │ │ │ │ │ +0004ab20: 204d 756c 7469 706c 6520 4f75 7470 7574 Multiple Output │ │ │ │ │ +0004ab30: 732e 2020 2020 286c 696e 6520 2020 3629 s. (line 6) │ │ │ │ │ +0004ab40: 0a2a 2072 756c 6573 2c20 636f 6e66 6c69 .* rules, confli │ │ │ │ │ +0004ab50: 6374 696e 673a 2020 2020 2020 2020 2020 cting: │ │ │ │ │ +0004ab60: 2020 2020 2020 2020 2020 4578 7465 6e64 Extend │ │ │ │ │ +0004ab70: 696e 672e 2020 2020 2020 2020 2020 2028 ing. ( │ │ │ │ │ +0004ab80: 6c69 6e65 2020 3134 290a 2a20 7275 6c65 line 14).* rule │ │ │ │ │ +0004ab90: 732c 2064 6562 7567 6769 6e67 3a20 2020 s, debugging: │ │ │ │ │ 0004aba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004abb0: 2020 4465 6275 6767 696e 6720 4d61 6b65 Debugging Make │ │ │ │ │ -0004abc0: 2052 756c 6573 2e0a 2020 2020 2020 2020 Rules.. │ │ │ │ │ +0004abb0: 2020 2044 6562 7567 6769 6e67 204d 616b Debugging Mak │ │ │ │ │ +0004abc0: 6520 5275 6c65 732e 0a20 2020 2020 2020 e Rules.. │ │ │ │ │ 0004abd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004abe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004abf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004ac00: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0004ac10: 0a2a 2072 756c 6573 2c20 6f76 6572 7269 .* rules, overri │ │ │ │ │ -0004ac20: 6469 6e67 3a20 2020 2020 2020 2020 2020 ding: │ │ │ │ │ -0004ac30: 2020 2020 2020 2020 2020 4578 7465 6e64 Extend │ │ │ │ │ -0004ac40: 696e 672e 2020 2020 2020 2020 2020 2028 ing. ( │ │ │ │ │ -0004ac50: 6c69 6e65 2020 3236 290a 2a20 7278 2070 line 26).* rx p │ │ │ │ │ -0004ac60: 6163 6b61 6765 3a20 2020 2020 2020 2020 ackage: │ │ │ │ │ +0004ac00: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0004ac10: 290a 2a20 7275 6c65 732c 206f 7665 7272 ).* rules, overr │ │ │ │ │ +0004ac20: 6964 696e 673a 2020 2020 2020 2020 2020 iding: │ │ │ │ │ +0004ac30: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ +0004ac40: 6469 6e67 2e20 2020 2020 2020 2020 2020 ding. │ │ │ │ │ +0004ac50: 286c 696e 6520 2032 3629 0a2a 2072 7820 (line 26).* rx │ │ │ │ │ +0004ac60: 7061 636b 6167 653a 2020 2020 2020 2020 package: │ │ │ │ │ 0004ac70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004ac80: 2020 204f 6273 6f6c 6574 6520 4d61 6372 Obsolete Macr │ │ │ │ │ -0004ac90: 6f73 2e20 2020 2020 286c 696e 6520 2036 os. (line 6 │ │ │ │ │ -0004aca0: 3429 0a2a 2053 6361 6e6e 696e 6720 636f 4).* Scanning co │ │ │ │ │ -0004acb0: 6e66 6967 7572 652e 6163 3a20 2020 2020 nfigure.ac: │ │ │ │ │ -0004acc0: 2020 2020 2020 2020 2020 2020 636f 6e66 conf │ │ │ │ │ -0004acd0: 6967 7572 652e 2020 2020 2020 2020 2020 igure. │ │ │ │ │ -0004ace0: 2028 6c69 6e65 2020 2036 290a 2a20 5343 (line 6).* SC │ │ │ │ │ -0004acf0: 5249 5054 5320 7072 696d 6172 792c 2064 RIPTS primary, d │ │ │ │ │ -0004ad00: 6566 696e 6564 3a20 2020 2020 2020 2020 efined: │ │ │ │ │ -0004ad10: 2020 2020 2053 6372 6970 7473 2e20 2020 Scripts. │ │ │ │ │ -0004ad20: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004ad30: 2020 3629 0a2a 2053 4352 4950 5453 2c20 6).* SCRIPTS, │ │ │ │ │ -0004ad40: 696e 7374 616c 6c61 7469 6f6e 2064 6972 installation dir │ │ │ │ │ -0004ad50: 6563 746f 7269 6573 3a20 2020 2020 5363 ectories: Sc │ │ │ │ │ -0004ad60: 7269 7074 732e 2020 2020 2020 2020 2020 ripts. │ │ │ │ │ -0004ad70: 2020 2028 6c69 6e65 2020 3138 290a 2a20 (line 18).* │ │ │ │ │ -0004ad80: 5365 6c65 6374 696e 6720 7468 6520 6c69 Selecting the li │ │ │ │ │ -0004ad90: 6e6b 6572 2061 7574 6f6d 6174 6963 616c nker automatical │ │ │ │ │ -0004ada0: 6c79 3a20 2020 2048 6f77 2074 6865 204c ly: How the L │ │ │ │ │ -0004adb0: 696e 6b65 7220 6973 2043 686f 7365 6e2e inker is Chosen. │ │ │ │ │ -0004adc0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0004ac80: 2020 2020 4f62 736f 6c65 7465 204d 6163 Obsolete Mac │ │ │ │ │ +0004ac90: 726f 732e 2020 2020 2028 6c69 6e65 2020 ros. (line │ │ │ │ │ +0004aca0: 3634 290a 2a20 5363 616e 6e69 6e67 2063 64).* Scanning c │ │ │ │ │ +0004acb0: 6f6e 6669 6775 7265 2e61 633a 2020 2020 onfigure.ac: │ │ │ │ │ +0004acc0: 2020 2020 2020 2020 2020 2020 2063 6f6e con │ │ │ │ │ +0004acd0: 6669 6775 7265 2e20 2020 2020 2020 2020 figure. │ │ │ │ │ +0004ace0: 2020 286c 696e 6520 2020 3629 0a2a 2053 (line 6).* S │ │ │ │ │ +0004acf0: 4352 4950 5453 2070 7269 6d61 7279 2c20 CRIPTS primary, │ │ │ │ │ +0004ad00: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ +0004ad10: 2020 2020 2020 5363 7269 7074 732e 2020 Scripts. │ │ │ │ │ +0004ad20: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0004ad30: 2020 2036 290a 2a20 5343 5249 5054 532c 6).* SCRIPTS, │ │ │ │ │ +0004ad40: 2069 6e73 7461 6c6c 6174 696f 6e20 6469 installation di │ │ │ │ │ +0004ad50: 7265 6374 6f72 6965 733a 2020 2020 2053 rectories: S │ │ │ │ │ +0004ad60: 6372 6970 7473 2e20 2020 2020 2020 2020 cripts. │ │ │ │ │ +0004ad70: 2020 2020 286c 696e 6520 2031 3829 0a2a (line 18).* │ │ │ │ │ +0004ad80: 2053 656c 6563 7469 6e67 2074 6865 206c Selecting the l │ │ │ │ │ +0004ad90: 696e 6b65 7220 6175 746f 6d61 7469 6361 inker automatica │ │ │ │ │ +0004ada0: 6c6c 793a 2020 2020 486f 7720 7468 6520 lly: How the │ │ │ │ │ +0004adb0: 4c69 6e6b 6572 2069 7320 4368 6f73 656e Linker is Chosen │ │ │ │ │ +0004adc0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 0004add0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004ade0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004adf0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0004ae00: 6c69 6e65 2020 2036 290a 2a20 7365 7269 line 6).* seri │ │ │ │ │ -0004ae10: 616c 206e 756d 6265 7220 616e 6420 2d2d al number and -- │ │ │ │ │ -0004ae20: 696e 7374 616c 6c3a 2020 2020 2020 2020 install: │ │ │ │ │ -0004ae30: 2020 2061 636c 6f63 616c 204f 7074 696f aclocal Optio │ │ │ │ │ -0004ae40: 6e73 2e20 2020 2020 286c 696e 6520 2034 ns. (line 4 │ │ │ │ │ -0004ae50: 3229 0a2a 2073 6572 6961 6c20 6e75 6d62 2).* serial numb │ │ │ │ │ -0004ae60: 6572 7320 696e 206d 6163 726f 733a 2020 ers in macros: │ │ │ │ │ -0004ae70: 2020 2020 2020 2020 2020 2020 5365 7269 Seri │ │ │ │ │ -0004ae80: 616c 732e 2020 2020 2020 2020 2020 2020 als. │ │ │ │ │ -0004ae90: 2028 6c69 6e65 2020 2036 290a 2a20 5368 (line 6).* Sh │ │ │ │ │ -0004aea0: 6172 6564 206c 6962 7261 7269 6573 2c20 ared libraries, │ │ │ │ │ -0004aeb0: 7375 7070 6f72 7420 666f 723a 2020 2020 support for: │ │ │ │ │ -0004aec0: 2020 2020 2041 2053 6861 7265 6420 4c69 A Shared Li │ │ │ │ │ -0004aed0: 6272 6172 792e 2020 2020 286c 696e 6520 brary. (line │ │ │ │ │ -0004aee0: 2020 3629 0a2a 2053 696c 656e 6369 6e67 6).* Silencing │ │ │ │ │ -0004aef0: 206d 616b 653a 2020 2020 2020 2020 2020 make: │ │ │ │ │ -0004af00: 2020 2020 2020 2020 2020 2020 2020 5369 Si │ │ │ │ │ -0004af10: 6c65 6e63 696e 6720 4d61 6b65 2e20 2020 lencing Make. │ │ │ │ │ -0004af20: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -0004af30: 5369 6c65 6e74 206d 616b 653a 2020 2020 Silent make: │ │ │ │ │ +0004adf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0004ae00: 286c 696e 6520 2020 3629 0a2a 2073 6572 (line 6).* ser │ │ │ │ │ +0004ae10: 6961 6c20 6e75 6d62 6572 2061 6e64 202d ial number and - │ │ │ │ │ +0004ae20: 2d69 6e73 7461 6c6c 3a20 2020 2020 2020 -install: │ │ │ │ │ +0004ae30: 2020 2020 6163 6c6f 6361 6c20 4f70 7469 aclocal Opti │ │ │ │ │ +0004ae40: 6f6e 732e 2020 2020 2028 6c69 6e65 2020 ons. (line │ │ │ │ │ +0004ae50: 3432 290a 2a20 7365 7269 616c 206e 756d 42).* serial num │ │ │ │ │ +0004ae60: 6265 7273 2069 6e20 6d61 6372 6f73 3a20 bers in macros: │ │ │ │ │ +0004ae70: 2020 2020 2020 2020 2020 2020 2053 6572 Ser │ │ │ │ │ +0004ae80: 6961 6c73 2e20 2020 2020 2020 2020 2020 ials. │ │ │ │ │ +0004ae90: 2020 286c 696e 6520 2020 3629 0a2a 2053 (line 6).* S │ │ │ │ │ +0004aea0: 6861 7265 6420 6c69 6272 6172 6965 732c hared libraries, │ │ │ │ │ +0004aeb0: 2073 7570 706f 7274 2066 6f72 3a20 2020 support for: │ │ │ │ │ +0004aec0: 2020 2020 2020 4120 5368 6172 6564 204c A Shared L │ │ │ │ │ +0004aed0: 6962 7261 7279 2e20 2020 2028 6c69 6e65 ibrary. (line │ │ │ │ │ +0004aee0: 2020 2036 290a 2a20 5369 6c65 6e63 696e 6).* Silencin │ │ │ │ │ +0004aef0: 6720 6d61 6b65 3a20 2020 2020 2020 2020 g make: │ │ │ │ │ +0004af00: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ +0004af10: 696c 656e 6369 6e67 204d 616b 652e 2020 ilencing Make. │ │ │ │ │ +0004af20: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +0004af30: 2053 696c 656e 7420 6d61 6b65 3a20 2020 Silent make: │ │ │ │ │ 0004af40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004af50: 2020 2020 2020 2053 696c 656e 6369 6e67 Silencing │ │ │ │ │ -0004af60: 204d 616b 652e 2020 2020 2020 286c 696e Make. (lin │ │ │ │ │ -0004af70: 6520 2020 3629 0a2a 2053 696c 656e 7420 e 6).* Silent │ │ │ │ │ -0004af80: 6d61 6b65 2072 756c 6573 3a20 2020 2020 make rules: │ │ │ │ │ +0004af50: 2020 2020 2020 2020 5369 6c65 6e63 696e Silencin │ │ │ │ │ +0004af60: 6720 4d61 6b65 2e20 2020 2020 2028 6c69 g Make. (li │ │ │ │ │ +0004af70: 6e65 2020 2036 290a 2a20 5369 6c65 6e74 ne 6).* Silent │ │ │ │ │ +0004af80: 206d 616b 6520 7275 6c65 733a 2020 2020 make rules: │ │ │ │ │ 0004af90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004afa0: 5369 6c65 6e63 696e 6720 4d61 6b65 2e20 Silencing Make. │ │ │ │ │ -0004afb0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -0004afc0: 2a20 5369 6c65 6e74 2072 756c 6573 3a20 * Silent rules: │ │ │ │ │ +0004afa0: 2053 696c 656e 6369 6e67 204d 616b 652e Silencing Make. │ │ │ │ │ +0004afb0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +0004afc0: 0a2a 2053 696c 656e 7420 7275 6c65 733a .* Silent rules: │ │ │ │ │ 0004afd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004afe0: 2020 2020 2020 2020 2053 696c 656e 6369 Silenci │ │ │ │ │ -0004aff0: 6e67 204d 616b 652e 2020 2020 2020 286c ng Make. (l │ │ │ │ │ -0004b000: 696e 6520 2020 3629 0a2a 2073 696c 656e ine 6).* silen │ │ │ │ │ -0004b010: 742d 7275 6c65 733a 2020 2020 2020 2020 t-rules: │ │ │ │ │ +0004afe0: 2020 2020 2020 2020 2020 5369 6c65 6e63 Silenc │ │ │ │ │ +0004aff0: 696e 6720 4d61 6b65 2e20 2020 2020 2028 ing Make. ( │ │ │ │ │ +0004b000: 6c69 6e65 2020 2036 290a 2a20 7369 6c65 line 6).* sile │ │ │ │ │ +0004b010: 6e74 2d72 756c 6573 3a20 2020 2020 2020 nt-rules: │ │ │ │ │ 0004b020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b030: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ -0004b040: 2020 2020 2020 2028 6c69 6e65 2031 3430 (line 140 │ │ │ │ │ -0004b050: 290a 2a20 7369 6c65 6e74 2d72 756c 6573 ).* silent-rules │ │ │ │ │ -0004b060: 2061 6e64 206c 6962 746f 6f6c 3a20 2020 and libtool: │ │ │ │ │ -0004b070: 2020 2020 2020 2020 2020 2041 7574 6f6d Autom │ │ │ │ │ -0004b080: 616b 6520 7369 6c65 6e74 2d72 756c 6573 ake silent-rules │ │ │ │ │ -0004b090: 204f 7074 696f 6e2e 0a20 2020 2020 2020 Option.. │ │ │ │ │ +0004b030: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ +0004b040: 2020 2020 2020 2020 286c 696e 6520 3134 (line 14 │ │ │ │ │ +0004b050: 3029 0a2a 2073 696c 656e 742d 7275 6c65 0).* silent-rule │ │ │ │ │ +0004b060: 7320 616e 6420 6c69 6274 6f6f 6c3a 2020 s and libtool: │ │ │ │ │ +0004b070: 2020 2020 2020 2020 2020 2020 4175 746f Auto │ │ │ │ │ +0004b080: 6d61 6b65 2073 696c 656e 742d 7275 6c65 make silent-rule │ │ │ │ │ +0004b090: 7320 4f70 7469 6f6e 2e0a 2020 2020 2020 s Option.. │ │ │ │ │ 0004b0a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b0b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b0c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b0d0: 2020 2020 2020 2028 6c69 6e65 2020 3539 (line 59 │ │ │ │ │ -0004b0e0: 290a 2a20 7369 7465 2e65 7870 3a20 2020 ).* site.exp: │ │ │ │ │ +0004b0d0: 2020 2020 2020 2020 286c 696e 6520 2035 (line 5 │ │ │ │ │ +0004b0e0: 3929 0a2a 2073 6974 652e 6578 703a 2020 9).* site.exp: │ │ │ │ │ 0004b0f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b100: 2020 2020 2020 2020 2020 2044 656a 6147 DejaG │ │ │ │ │ -0004b110: 6e75 2054 6573 7473 2e20 2020 2020 2020 nu Tests. │ │ │ │ │ -0004b120: 286c 696e 6520 2032 3629 0a2a 2073 6f75 (line 26).* sou │ │ │ │ │ -0004b130: 7263 6520 7472 6565 2061 6e64 2062 7569 rce tree and bui │ │ │ │ │ -0004b140: 6c64 2074 7265 653a 2020 2020 2020 2020 ld tree: │ │ │ │ │ -0004b150: 2020 2020 5650 4154 4820 4275 696c 6473 VPATH Builds │ │ │ │ │ -0004b160: 2e20 2020 2020 2020 2028 6c69 6e65 2020 . (line │ │ │ │ │ -0004b170: 2036 290a 2a20 736f 7572 6365 2074 7265 6).* source tre │ │ │ │ │ -0004b180: 652c 2072 6561 642d 6f6e 6c79 3a20 2020 e, read-only: │ │ │ │ │ -0004b190: 2020 2020 2020 2020 2020 2020 2056 5041 VPA │ │ │ │ │ -0004b1a0: 5448 2042 7569 6c64 732e 2020 2020 2020 TH Builds. │ │ │ │ │ -0004b1b0: 2020 286c 696e 6520 2038 3929 0a2a 2053 (line 89).* S │ │ │ │ │ -0004b1c0: 4f55 5243 4553 2070 7269 6d61 7279 2c20 OURCES primary, │ │ │ │ │ -0004b1d0: 6465 6669 6e65 643a 2020 2020 2020 2020 defined: │ │ │ │ │ -0004b1e0: 2020 2020 2020 5072 6f67 7261 6d20 536f Program So │ │ │ │ │ -0004b1f0: 7572 6365 732e 2020 2020 2028 6c69 6e65 urces. (line │ │ │ │ │ -0004b200: 2020 3332 290a 2a20 5370 6563 6961 6c20 32).* Special │ │ │ │ │ -0004b210: 4175 746f 6d61 6b65 2063 6f6d 6d65 6e74 Automake comment │ │ │ │ │ -0004b220: 3a20 2020 2020 2020 2020 2020 2020 2047 : G │ │ │ │ │ -0004b230: 656e 6572 616c 204f 7065 7261 7469 6f6e eneral Operation │ │ │ │ │ -0004b240: 2e20 2020 286c 696e 6520 2036 3829 0a2a . (line 68).* │ │ │ │ │ -0004b250: 2053 7461 6765 6420 696e 7374 616c 6c61 Staged installa │ │ │ │ │ -0004b260: 7469 6f6e 3a20 2020 2020 2020 2020 2020 tion: │ │ │ │ │ -0004b270: 2020 2020 2020 2020 4445 5354 4449 522e DESTDIR. │ │ │ │ │ -0004b280: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0004b290: 6e65 2020 3134 290a 2a20 7374 642d 6f70 ne 14).* std-op │ │ │ │ │ -0004b2a0: 7469 6f6e 733a 2020 2020 2020 2020 2020 tions: │ │ │ │ │ +0004b100: 2020 2020 2020 2020 2020 2020 4465 6a61 Deja │ │ │ │ │ +0004b110: 476e 7520 5465 7374 732e 2020 2020 2020 Gnu Tests. │ │ │ │ │ +0004b120: 2028 6c69 6e65 2020 3236 290a 2a20 736f (line 26).* so │ │ │ │ │ +0004b130: 7572 6365 2074 7265 6520 616e 6420 6275 urce tree and bu │ │ │ │ │ +0004b140: 696c 6420 7472 6565 3a20 2020 2020 2020 ild tree: │ │ │ │ │ +0004b150: 2020 2020 2056 5041 5448 2042 7569 6c64 VPATH Build │ │ │ │ │ +0004b160: 732e 2020 2020 2020 2020 286c 696e 6520 s. (line │ │ │ │ │ +0004b170: 2020 3629 0a2a 2073 6f75 7263 6520 7472 6).* source tr │ │ │ │ │ +0004b180: 6565 2c20 7265 6164 2d6f 6e6c 793a 2020 ee, read-only: │ │ │ │ │ +0004b190: 2020 2020 2020 2020 2020 2020 2020 5650 VP │ │ │ │ │ +0004b1a0: 4154 4820 4275 696c 6473 2e20 2020 2020 ATH Builds. │ │ │ │ │ +0004b1b0: 2020 2028 6c69 6e65 2020 3839 290a 2a20 (line 89).* │ │ │ │ │ +0004b1c0: 534f 5552 4345 5320 7072 696d 6172 792c SOURCES primary, │ │ │ │ │ +0004b1d0: 2064 6566 696e 6564 3a20 2020 2020 2020 defined: │ │ │ │ │ +0004b1e0: 2020 2020 2020 2050 726f 6772 616d 2053 Program S │ │ │ │ │ +0004b1f0: 6f75 7263 6573 2e20 2020 2020 286c 696e ources. (lin │ │ │ │ │ +0004b200: 6520 2033 3229 0a2a 2053 7065 6369 616c e 32).* Special │ │ │ │ │ +0004b210: 2041 7574 6f6d 616b 6520 636f 6d6d 656e Automake commen │ │ │ │ │ +0004b220: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ +0004b230: 4765 6e65 7261 6c20 4f70 6572 6174 696f General Operatio │ │ │ │ │ +0004b240: 6e2e 2020 2028 6c69 6e65 2020 3638 290a n. (line 68). │ │ │ │ │ +0004b250: 2a20 5374 6167 6564 2069 6e73 7461 6c6c * Staged install │ │ │ │ │ +0004b260: 6174 696f 6e3a 2020 2020 2020 2020 2020 ation: │ │ │ │ │ +0004b270: 2020 2020 2020 2020 2044 4553 5444 4952 DESTDIR │ │ │ │ │ +0004b280: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0004b290: 696e 6520 2031 3429 0a2a 2073 7464 2d6f ine 14).* std-o │ │ │ │ │ +0004b2a0: 7074 696f 6e73 3a20 2020 2020 2020 2020 ptions: │ │ │ │ │ 0004b2b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b2c0: 204f 7074 696f 6e73 2e20 2020 2020 2020 Options. │ │ │ │ │ -0004b2d0: 2020 2020 2020 286c 696e 6520 3135 3229 (line 152) │ │ │ │ │ -0004b2e0: 0a2a 2053 7472 6963 746e 6573 732c 2063 .* Strictness, c │ │ │ │ │ -0004b2f0: 6f6d 6d61 6e64 206c 696e 653a 2020 2020 ommand line: │ │ │ │ │ -0004b300: 2020 2020 2020 2020 2020 6175 746f 6d61 automa │ │ │ │ │ -0004b310: 6b65 2049 6e76 6f63 6174 696f 6e2e 2028 ke Invocation. ( │ │ │ │ │ -0004b320: 6c69 6e65 2020 3337 290a 2a20 5374 7269 line 37).* Stri │ │ │ │ │ -0004b330: 6374 6e65 7373 2c20 6465 6669 6e65 643a ctness, defined: │ │ │ │ │ -0004b340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b350: 2020 2053 7472 6963 746e 6573 732e 2020 Strictness. │ │ │ │ │ -0004b360: 2020 2020 2020 2020 286c 696e 6520 2031 (line 1 │ │ │ │ │ -0004b370: 3029 0a2a 2053 7472 6963 746e 6573 732c 0).* Strictness, │ │ │ │ │ -0004b380: 2066 6f72 6569 676e 3a20 2020 2020 2020 foreign: │ │ │ │ │ -0004b390: 2020 2020 2020 2020 2020 2020 5374 7269 Stri │ │ │ │ │ -0004b3a0: 6374 6e65 7373 2e20 2020 2020 2020 2020 ctness. │ │ │ │ │ -0004b3b0: 2028 6c69 6e65 2020 3130 290a 2a20 5374 (line 10).* St │ │ │ │ │ -0004b3c0: 7269 6374 6e65 7373 2c20 676e 6974 733a rictness, gnits: │ │ │ │ │ -0004b3d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b3e0: 2020 2020 2053 7472 6963 746e 6573 732e Strictness. │ │ │ │ │ -0004b3f0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004b400: 2031 3029 0a2a 2053 7472 6963 746e 6573 10).* Strictnes │ │ │ │ │ -0004b410: 732c 2067 6e75 3a20 2020 2020 2020 2020 s, gnu: │ │ │ │ │ -0004b420: 2020 2020 2020 2020 2020 2020 2020 5374 St │ │ │ │ │ -0004b430: 7269 6374 6e65 7373 2e20 2020 2020 2020 rictness. │ │ │ │ │ -0004b440: 2020 2028 6c69 6e65 2020 3130 290a 2a20 (line 10).* │ │ │ │ │ -0004b450: 7375 2c20 6265 666f 7265 206d 616b 6520 su, before make │ │ │ │ │ -0004b460: 696e 7374 616c 6c3a 2020 2020 2020 2020 install: │ │ │ │ │ -0004b470: 2020 2020 2020 2042 6173 6963 2049 6e73 Basic Ins │ │ │ │ │ -0004b480: 7461 6c6c 6174 696f 6e2e 2020 286c 696e tallation. (lin │ │ │ │ │ -0004b490: 6520 2034 3929 0a2a 2073 7562 6469 722d e 49).* subdir- │ │ │ │ │ -0004b4a0: 6f62 6a65 6374 733a 2020 2020 2020 2020 objects: │ │ │ │ │ +0004b2c0: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ +0004b2d0: 2020 2020 2020 2028 6c69 6e65 2031 3532 (line 152 │ │ │ │ │ +0004b2e0: 290a 2a20 5374 7269 6374 6e65 7373 2c20 ).* Strictness, │ │ │ │ │ +0004b2f0: 636f 6d6d 616e 6420 6c69 6e65 3a20 2020 command line: │ │ │ │ │ +0004b300: 2020 2020 2020 2020 2020 2061 7574 6f6d autom │ │ │ │ │ +0004b310: 616b 6520 496e 766f 6361 7469 6f6e 2e20 ake Invocation. │ │ │ │ │ +0004b320: 286c 696e 6520 2033 3729 0a2a 2053 7472 (line 37).* Str │ │ │ │ │ +0004b330: 6963 746e 6573 732c 2064 6566 696e 6564 ictness, defined │ │ │ │ │ +0004b340: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0004b350: 2020 2020 5374 7269 6374 6e65 7373 2e20 Strictness. │ │ │ │ │ +0004b360: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0004b370: 3130 290a 2a20 5374 7269 6374 6e65 7373 10).* Strictness │ │ │ │ │ +0004b380: 2c20 666f 7265 6967 6e3a 2020 2020 2020 , foreign: │ │ │ │ │ +0004b390: 2020 2020 2020 2020 2020 2020 2053 7472 Str │ │ │ │ │ +0004b3a0: 6963 746e 6573 732e 2020 2020 2020 2020 ictness. │ │ │ │ │ +0004b3b0: 2020 286c 696e 6520 2031 3029 0a2a 2053 (line 10).* S │ │ │ │ │ +0004b3c0: 7472 6963 746e 6573 732c 2067 6e69 7473 trictness, gnits │ │ │ │ │ +0004b3d0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0004b3e0: 2020 2020 2020 5374 7269 6374 6e65 7373 Strictness │ │ │ │ │ +0004b3f0: 2e20 2020 2020 2020 2020 2028 6c69 6e65 . (line │ │ │ │ │ +0004b400: 2020 3130 290a 2a20 5374 7269 6374 6e65 10).* Strictne │ │ │ │ │ +0004b410: 7373 2c20 676e 753a 2020 2020 2020 2020 ss, gnu: │ │ │ │ │ +0004b420: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ +0004b430: 7472 6963 746e 6573 732e 2020 2020 2020 trictness. │ │ │ │ │ +0004b440: 2020 2020 286c 696e 6520 2031 3029 0a2a (line 10).* │ │ │ │ │ +0004b450: 2073 752c 2062 6566 6f72 6520 6d61 6b65 su, before make │ │ │ │ │ +0004b460: 2069 6e73 7461 6c6c 3a20 2020 2020 2020 install: │ │ │ │ │ +0004b470: 2020 2020 2020 2020 4261 7369 6320 496e Basic In │ │ │ │ │ +0004b480: 7374 616c 6c61 7469 6f6e 2e20 2028 6c69 stallation. (li │ │ │ │ │ +0004b490: 6e65 2020 3439 290a 2a20 7375 6264 6972 ne 49).* subdir │ │ │ │ │ +0004b4a0: 2d6f 626a 6563 7473 3a20 2020 2020 2020 -objects: │ │ │ │ │ 0004b4b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b4c0: 4f70 7469 6f6e 732e 2020 2020 2020 2020 Options. │ │ │ │ │ -0004b4d0: 2020 2020 2028 6c69 6e65 2031 3733 290a (line 173). │ │ │ │ │ -0004b4e0: 2a20 5375 6264 6972 6563 746f 7269 6573 * Subdirectories │ │ │ │ │ -0004b4f0: 2c20 6275 696c 6469 6e67 2063 6f6e 6469 , building condi │ │ │ │ │ -0004b500: 7469 6f6e 616c 6c79 3a20 436f 6e64 6974 tionally: Condit │ │ │ │ │ -0004b510: 696f 6e61 6c20 5375 6264 6972 6563 746f ional Subdirecto │ │ │ │ │ -0004b520: 7269 6573 2e0a 2020 2020 2020 2020 2020 ries.. │ │ │ │ │ +0004b4c0: 204f 7074 696f 6e73 2e20 2020 2020 2020 Options. │ │ │ │ │ +0004b4d0: 2020 2020 2020 286c 696e 6520 3137 3329 (line 173) │ │ │ │ │ +0004b4e0: 0a2a 2053 7562 6469 7265 6374 6f72 6965 .* Subdirectorie │ │ │ │ │ +0004b4f0: 732c 2062 7569 6c64 696e 6720 636f 6e64 s, building cond │ │ │ │ │ +0004b500: 6974 696f 6e61 6c6c 793a 2043 6f6e 6469 itionally: Condi │ │ │ │ │ +0004b510: 7469 6f6e 616c 2053 7562 6469 7265 6374 tional Subdirect │ │ │ │ │ +0004b520: 6f72 6965 732e 0a20 2020 2020 2020 2020 ories.. │ │ │ │ │ 0004b530: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b560: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0004b570: 2053 7562 6469 7265 6374 6f72 6965 732c Subdirectories, │ │ │ │ │ -0004b580: 2063 6f6e 6669 6775 7265 6420 636f 6e64 configured cond │ │ │ │ │ -0004b590: 6974 696f 6e61 6c6c 793a 2055 6e63 6f6e itionally: Uncon │ │ │ │ │ -0004b5a0: 6669 6775 7265 6420 5375 6264 6972 6563 figured Subdirec │ │ │ │ │ -0004b5b0: 746f 7269 6573 2e0a 2020 2020 2020 2020 tories.. │ │ │ │ │ +0004b560: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0004b570: 2a20 5375 6264 6972 6563 746f 7269 6573 * Subdirectories │ │ │ │ │ +0004b580: 2c20 636f 6e66 6967 7572 6564 2063 6f6e , configured con │ │ │ │ │ +0004b590: 6469 7469 6f6e 616c 6c79 3a20 556e 636f ditionally: Unco │ │ │ │ │ +0004b5a0: 6e66 6967 7572 6564 2053 7562 6469 7265 nfigured Subdire │ │ │ │ │ +0004b5b0: 6374 6f72 6965 732e 0a20 2020 2020 2020 ctories.. │ │ │ │ │ 0004b5c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b5d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b5e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b5f0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0004b600: 0a2a 2053 7562 6469 7265 6374 6f72 6965 .* Subdirectorie │ │ │ │ │ -0004b610: 732c 206e 6f74 2064 6973 7472 6962 7574 s, not distribut │ │ │ │ │ -0004b620: 6564 3a20 2020 2020 2020 556e 636f 6e66 ed: Unconf │ │ │ │ │ -0004b630: 6967 7572 6564 2053 7562 6469 7265 6374 igured Subdirect │ │ │ │ │ -0004b640: 6f72 6965 732e 0a20 2020 2020 2020 2020 ories.. │ │ │ │ │ +0004b5f0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0004b600: 290a 2a20 5375 6264 6972 6563 746f 7269 ).* Subdirectori │ │ │ │ │ +0004b610: 6573 2c20 6e6f 7420 6469 7374 7269 6275 es, not distribu │ │ │ │ │ +0004b620: 7465 643a 2020 2020 2020 2055 6e63 6f6e ted: Uncon │ │ │ │ │ +0004b630: 6669 6775 7265 6420 5375 6264 6972 6563 figured Subdirec │ │ │ │ │ +0004b640: 746f 7269 6573 2e0a 2020 2020 2020 2020 tories.. │ │ │ │ │ 0004b650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b680: 2020 2020 2028 6c69 6e65 2020 3535 290a (line 55). │ │ │ │ │ -0004b690: 2a20 5375 6264 6972 6563 746f 7279 2c20 * Subdirectory, │ │ │ │ │ -0004b6a0: 6f62 6a65 6374 7320 696e 3a20 2020 2020 objects in: │ │ │ │ │ -0004b6b0: 2020 2020 2020 2020 2050 726f 6772 616d Program │ │ │ │ │ -0004b6c0: 2061 6e64 204c 6962 7261 7279 2056 6172 and Library Var │ │ │ │ │ -0004b6d0: 6961 626c 6573 2e0a 2020 2020 2020 2020 iables.. │ │ │ │ │ +0004b680: 2020 2020 2020 286c 696e 6520 2035 3529 (line 55) │ │ │ │ │ +0004b690: 0a2a 2053 7562 6469 7265 6374 6f72 792c .* Subdirectory, │ │ │ │ │ +0004b6a0: 206f 626a 6563 7473 2069 6e3a 2020 2020 objects in: │ │ │ │ │ +0004b6b0: 2020 2020 2020 2020 2020 5072 6f67 7261 Progra │ │ │ │ │ +0004b6c0: 6d20 616e 6420 4c69 6272 6172 7920 5661 m and Library Va │ │ │ │ │ +0004b6d0: 7269 6162 6c65 732e 0a20 2020 2020 2020 riables.. │ │ │ │ │ 0004b6e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b6f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b710: 2020 2020 2020 286c 696e 6520 2035 3129 (line 51) │ │ │ │ │ -0004b720: 0a2a 2053 5542 4449 5253 2061 6e64 2041 .* SUBDIRS and A │ │ │ │ │ -0004b730: 435f 5355 4253 543a 2020 2020 2020 2020 C_SUBST: │ │ │ │ │ -0004b740: 2020 2020 2020 2020 2020 5375 6264 6972 Subdir │ │ │ │ │ -0004b750: 6563 746f 7269 6573 2077 6974 6820 4143 ectories with AC │ │ │ │ │ -0004b760: 5f53 5542 5354 2e0a 2020 2020 2020 2020 _SUBST.. │ │ │ │ │ +0004b710: 2020 2020 2020 2028 6c69 6e65 2020 3531 (line 51 │ │ │ │ │ +0004b720: 290a 2a20 5355 4244 4952 5320 616e 6420 ).* SUBDIRS and │ │ │ │ │ +0004b730: 4143 5f53 5542 5354 3a20 2020 2020 2020 AC_SUBST: │ │ │ │ │ +0004b740: 2020 2020 2020 2020 2020 2053 7562 6469 Subdi │ │ │ │ │ +0004b750: 7265 6374 6f72 6965 7320 7769 7468 2041 rectories with A │ │ │ │ │ +0004b760: 435f 5355 4253 542e 0a20 2020 2020 2020 C_SUBST.. │ │ │ │ │ 0004b770: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b7a0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0004b7b0: 0a2a 2053 5542 4449 5253 2061 6e64 2041 .* SUBDIRS and A │ │ │ │ │ -0004b7c0: 4d5f 434f 4e44 4954 494f 4e41 4c3a 2020 M_CONDITIONAL: │ │ │ │ │ -0004b7d0: 2020 2020 2020 2020 2020 5375 6264 6972 Subdir │ │ │ │ │ -0004b7e0: 6563 746f 7269 6573 2077 6974 6820 414d ectories with AM │ │ │ │ │ -0004b7f0: 5f43 4f4e 4449 5449 4f4e 414c 2e0a 2020 _CONDITIONAL.. │ │ │ │ │ +0004b7a0: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0004b7b0: 290a 2a20 5355 4244 4952 5320 616e 6420 ).* SUBDIRS and │ │ │ │ │ +0004b7c0: 414d 5f43 4f4e 4449 5449 4f4e 414c 3a20 AM_CONDITIONAL: │ │ │ │ │ +0004b7d0: 2020 2020 2020 2020 2020 2053 7562 6469 Subdi │ │ │ │ │ +0004b7e0: 7265 6374 6f72 6965 7320 7769 7468 2041 rectories with A │ │ │ │ │ +0004b7f0: 4d5f 434f 4e44 4954 494f 4e41 4c2e 0a20 M_CONDITIONAL.. │ │ │ │ │ 0004b800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b830: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0004b840: 6520 2020 3629 0a2a 2053 5542 4449 5253 e 6).* SUBDIRS │ │ │ │ │ -0004b850: 2c20 636f 6e64 6974 696f 6e61 6c3a 2020 , conditional: │ │ │ │ │ +0004b830: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0004b840: 6e65 2020 2036 290a 2a20 5355 4244 4952 ne 6).* SUBDIR │ │ │ │ │ +0004b850: 532c 2063 6f6e 6469 7469 6f6e 616c 3a20 S, conditional: │ │ │ │ │ 0004b860: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b870: 436f 6e64 6974 696f 6e61 6c20 5375 6264 Conditional Subd │ │ │ │ │ -0004b880: 6972 6563 746f 7269 6573 2e0a 2020 2020 irectories.. │ │ │ │ │ +0004b870: 2043 6f6e 6469 7469 6f6e 616c 2053 7562 Conditional Sub │ │ │ │ │ +0004b880: 6469 7265 6374 6f72 6965 732e 0a20 2020 directories.. │ │ │ │ │ 0004b890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b8a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004b8b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b8c0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004b8d0: 2020 3629 0a2a 2053 5542 4449 5253 2c20 6).* SUBDIRS, │ │ │ │ │ -0004b8e0: 6578 706c 6169 6e65 643a 2020 2020 2020 explained: │ │ │ │ │ -0004b8f0: 2020 2020 2020 2020 2020 2020 2020 5375 Su │ │ │ │ │ -0004b900: 6264 6972 6563 746f 7269 6573 2e20 2020 bdirectories. │ │ │ │ │ -0004b910: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -0004b920: 5375 6270 6163 6b61 6765 733a 2020 2020 Subpackages: │ │ │ │ │ +0004b8c0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0004b8d0: 2020 2036 290a 2a20 5355 4244 4952 532c 6).* SUBDIRS, │ │ │ │ │ +0004b8e0: 2065 7870 6c61 696e 6564 3a20 2020 2020 explained: │ │ │ │ │ +0004b8f0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ +0004b900: 7562 6469 7265 6374 6f72 6965 732e 2020 ubdirectories. │ │ │ │ │ +0004b910: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +0004b920: 2053 7562 7061 636b 6167 6573 3a20 2020 Subpackages: │ │ │ │ │ 0004b930: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b940: 2020 2020 2020 204e 6573 7465 6420 5061 Nested Pa │ │ │ │ │ -0004b950: 636b 6167 6573 2e20 2020 2020 286c 696e ckages. (lin │ │ │ │ │ -0004b960: 6520 2020 3629 0a2a 2053 7562 7061 636b e 6).* Subpack │ │ │ │ │ -0004b970: 6167 6573 203c 313e 3a20 2020 2020 2020 ages <1>: │ │ │ │ │ +0004b940: 2020 2020 2020 2020 4e65 7374 6564 2050 Nested P │ │ │ │ │ +0004b950: 6163 6b61 6765 732e 2020 2020 2028 6c69 ackages. (li │ │ │ │ │ +0004b960: 6e65 2020 2036 290a 2a20 5375 6270 6163 ne 6).* Subpac │ │ │ │ │ +0004b970: 6b61 6765 7320 3c31 3e3a 2020 2020 2020 kages <1>: │ │ │ │ │ 0004b980: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004b990: 5375 6270 6163 6b61 6765 732e 2020 2020 Subpackages. │ │ │ │ │ -0004b9a0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -0004b9b0: 2a20 7375 6666 6978 202e 6c61 2c20 6465 * suffix .la, de │ │ │ │ │ -0004b9c0: 6669 6e65 643a 2020 2020 2020 2020 2020 fined: │ │ │ │ │ -0004b9d0: 2020 2020 2020 2020 204c 6962 746f 6f6c Libtool │ │ │ │ │ -0004b9e0: 2043 6f6e 6365 7074 2e20 2020 2020 286c Concept. (l │ │ │ │ │ -0004b9f0: 696e 6520 2020 3629 0a2a 2073 7566 6669 ine 6).* suffi │ │ │ │ │ -0004ba00: 7820 2e6c 6f2c 2064 6566 696e 6564 3a20 x .lo, defined: │ │ │ │ │ +0004b990: 2053 7562 7061 636b 6167 6573 2e20 2020 Subpackages. │ │ │ │ │ +0004b9a0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +0004b9b0: 0a2a 2073 7566 6669 7820 2e6c 612c 2064 .* suffix .la, d │ │ │ │ │ +0004b9c0: 6566 696e 6564 3a20 2020 2020 2020 2020 efined: │ │ │ │ │ +0004b9d0: 2020 2020 2020 2020 2020 4c69 6274 6f6f Libtoo │ │ │ │ │ +0004b9e0: 6c20 436f 6e63 6570 742e 2020 2020 2028 l Concept. ( │ │ │ │ │ +0004b9f0: 6c69 6e65 2020 2036 290a 2a20 7375 6666 line 6).* suff │ │ │ │ │ +0004ba00: 6978 202e 6c6f 2c20 6465 6669 6e65 643a ix .lo, defined: │ │ │ │ │ 0004ba10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004ba20: 2020 4c69 6274 6f6f 6c20 436f 6e63 6570 Libtool Concep │ │ │ │ │ -0004ba30: 742e 2020 2020 2028 6c69 6e65 2020 3135 t. (line 15 │ │ │ │ │ -0004ba40: 290a 2a20 5355 4646 4958 4553 2c20 6164 ).* SUFFIXES, ad │ │ │ │ │ -0004ba50: 6469 6e67 3a20 2020 2020 2020 2020 2020 ding: │ │ │ │ │ -0004ba60: 2020 2020 2020 2020 2020 2053 7566 6669 Suffi │ │ │ │ │ -0004ba70: 7865 732e 2020 2020 2020 2020 2020 2020 xes. │ │ │ │ │ -0004ba80: 286c 696e 6520 2020 3629 0a2a 2053 7570 (line 6).* Sup │ │ │ │ │ -0004ba90: 706f 7274 2066 6f72 2043 2b2b 3a20 2020 port for C++: │ │ │ │ │ +0004ba20: 2020 204c 6962 746f 6f6c 2043 6f6e 6365 Libtool Conce │ │ │ │ │ +0004ba30: 7074 2e20 2020 2020 286c 696e 6520 2031 pt. (line 1 │ │ │ │ │ +0004ba40: 3529 0a2a 2053 5546 4649 5845 532c 2061 5).* SUFFIXES, a │ │ │ │ │ +0004ba50: 6464 696e 673a 2020 2020 2020 2020 2020 dding: │ │ │ │ │ +0004ba60: 2020 2020 2020 2020 2020 2020 5375 6666 Suff │ │ │ │ │ +0004ba70: 6978 6573 2e20 2020 2020 2020 2020 2020 ixes. │ │ │ │ │ +0004ba80: 2028 6c69 6e65 2020 2036 290a 2a20 5375 (line 6).* Su │ │ │ │ │ +0004ba90: 7070 6f72 7420 666f 7220 432b 2b3a 2020 pport for C++: │ │ │ │ │ 0004baa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004bab0: 2020 2020 432b 2b20 5375 7070 6f72 742e C++ Support. │ │ │ │ │ -0004bac0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0004bad0: 2036 290a 2a20 5375 7070 6f72 7420 666f 6).* Support fo │ │ │ │ │ -0004bae0: 7220 466f 7274 7261 6e20 3737 3a20 2020 r Fortran 77: │ │ │ │ │ -0004baf0: 2020 2020 2020 2020 2020 2020 2046 6f72 For │ │ │ │ │ -0004bb00: 7472 616e 2037 3720 5375 7070 6f72 742e tran 77 Support. │ │ │ │ │ -0004bb10: 2020 286c 696e 6520 2020 3629 0a2a 2053 (line 6).* S │ │ │ │ │ -0004bb20: 7570 706f 7274 2066 6f72 2046 6f72 7472 upport for Fortr │ │ │ │ │ -0004bb30: 616e 2039 783a 2020 2020 2020 2020 2020 an 9x: │ │ │ │ │ -0004bb40: 2020 2020 2020 466f 7274 7261 6e20 3978 Fortran 9x │ │ │ │ │ -0004bb50: 2053 7570 706f 7274 2e20 2028 6c69 6e65 Support. (line │ │ │ │ │ -0004bb60: 2020 2036 290a 2a20 5375 7070 6f72 7420 6).* Support │ │ │ │ │ -0004bb70: 666f 7220 474e 5520 4765 7474 6578 743a for GNU Gettext: │ │ │ │ │ -0004bb80: 2020 2020 2020 2020 2020 2020 2020 2067 g │ │ │ │ │ -0004bb90: 6574 7465 7874 2e20 2020 2020 2020 2020 ettext. │ │ │ │ │ -0004bba0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0004bbb0: 2053 7570 706f 7274 2066 6f72 204a 6176 Support for Jav │ │ │ │ │ -0004bbc0: 6120 7769 7468 2067 636a 3a20 2020 2020 a with gcj: │ │ │ │ │ -0004bbd0: 2020 2020 2020 2020 4a61 7661 2053 7570 Java Sup │ │ │ │ │ -0004bbe0: 706f 7274 2077 6974 6820 6763 6a2e 0a20 port with gcj.. │ │ │ │ │ +0004bab0: 2020 2020 2043 2b2b 2053 7570 706f 7274 C++ Support │ │ │ │ │ +0004bac0: 2e20 2020 2020 2020 2020 286c 696e 6520 . (line │ │ │ │ │ +0004bad0: 2020 3629 0a2a 2053 7570 706f 7274 2066 6).* Support f │ │ │ │ │ +0004bae0: 6f72 2046 6f72 7472 616e 2037 373a 2020 or Fortran 77: │ │ │ │ │ +0004baf0: 2020 2020 2020 2020 2020 2020 2020 466f Fo │ │ │ │ │ +0004bb00: 7274 7261 6e20 3737 2053 7570 706f 7274 rtran 77 Support │ │ │ │ │ +0004bb10: 2e20 2028 6c69 6e65 2020 2036 290a 2a20 . (line 6).* │ │ │ │ │ +0004bb20: 5375 7070 6f72 7420 666f 7220 466f 7274 Support for Fort │ │ │ │ │ +0004bb30: 7261 6e20 3978 3a20 2020 2020 2020 2020 ran 9x: │ │ │ │ │ +0004bb40: 2020 2020 2020 2046 6f72 7472 616e 2039 Fortran 9 │ │ │ │ │ +0004bb50: 7820 5375 7070 6f72 742e 2020 286c 696e x Support. (lin │ │ │ │ │ +0004bb60: 6520 2020 3629 0a2a 2053 7570 706f 7274 e 6).* Support │ │ │ │ │ +0004bb70: 2066 6f72 2047 4e55 2047 6574 7465 7874 for GNU Gettext │ │ │ │ │ +0004bb80: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0004bb90: 6765 7474 6578 742e 2020 2020 2020 2020 gettext. │ │ │ │ │ +0004bba0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0004bbb0: 2a20 5375 7070 6f72 7420 666f 7220 4a61 * Support for Ja │ │ │ │ │ +0004bbc0: 7661 2077 6974 6820 6763 6a3a 2020 2020 va with gcj: │ │ │ │ │ +0004bbd0: 2020 2020 2020 2020 204a 6176 6120 5375 Java Su │ │ │ │ │ +0004bbe0: 7070 6f72 7420 7769 7468 2067 636a 2e0a pport with gcj.. │ │ │ │ │ 0004bbf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004bc00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004bc10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004bc20: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0004bc30: 6e65 2020 2036 290a 2a20 5375 7070 6f72 ne 6).* Suppor │ │ │ │ │ -0004bc40: 7420 666f 7220 4f62 6a65 6374 6976 6520 t for Objective │ │ │ │ │ -0004bc50: 433a 2020 2020 2020 2020 2020 2020 2020 C: │ │ │ │ │ -0004bc60: 204f 626a 6563 7469 7665 2043 2053 7570 Objective C Sup │ │ │ │ │ -0004bc70: 706f 7274 2e20 286c 696e 6520 2020 3629 port. (line 6) │ │ │ │ │ -0004bc80: 0a2a 2053 7570 706f 7274 2066 6f72 2055 .* Support for U │ │ │ │ │ -0004bc90: 6e69 6669 6564 2050 6172 616c 6c65 6c20 nified Parallel │ │ │ │ │ -0004bca0: 433a 2020 2020 2020 2020 556e 6966 6965 C: Unifie │ │ │ │ │ -0004bcb0: 6420 5061 7261 6c6c 656c 2043 2053 7570 d Parallel C Sup │ │ │ │ │ -0004bcc0: 706f 7274 2e0a 2020 2020 2020 2020 2020 port.. │ │ │ │ │ +0004bc20: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0004bc30: 696e 6520 2020 3629 0a2a 2053 7570 706f ine 6).* Suppo │ │ │ │ │ +0004bc40: 7274 2066 6f72 204f 626a 6563 7469 7665 rt for Objective │ │ │ │ │ +0004bc50: 2043 3a20 2020 2020 2020 2020 2020 2020 C: │ │ │ │ │ +0004bc60: 2020 4f62 6a65 6374 6976 6520 4320 5375 Objective C Su │ │ │ │ │ +0004bc70: 7070 6f72 742e 2028 6c69 6e65 2020 2036 pport. (line 6 │ │ │ │ │ +0004bc80: 290a 2a20 5375 7070 6f72 7420 666f 7220 ).* Support for │ │ │ │ │ +0004bc90: 556e 6966 6965 6420 5061 7261 6c6c 656c Unified Parallel │ │ │ │ │ +0004bca0: 2043 3a20 2020 2020 2020 2055 6e69 6669 C: Unifi │ │ │ │ │ +0004bcb0: 6564 2050 6172 616c 6c65 6c20 4320 5375 ed Parallel C Su │ │ │ │ │ +0004bcc0: 7070 6f72 742e 0a20 2020 2020 2020 2020 pport.. │ │ │ │ │ 0004bcd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004bce0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004bcf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004bd00: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0004bd10: 2053 7570 706f 7274 2066 6f72 2056 616c Support for Val │ │ │ │ │ -0004bd20: 613a 2020 2020 2020 2020 2020 2020 2020 a: │ │ │ │ │ -0004bd30: 2020 2020 2020 2020 5661 6c61 2053 7570 Vala Sup │ │ │ │ │ -0004bd40: 706f 7274 2e20 2020 2020 2020 2028 6c69 port. (li │ │ │ │ │ -0004bd50: 6e65 2020 2036 290a 2a20 7461 6773 3a20 ne 6).* tags: │ │ │ │ │ +0004bd00: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0004bd10: 2a20 5375 7070 6f72 7420 666f 7220 5661 * Support for Va │ │ │ │ │ +0004bd20: 6c61 3a20 2020 2020 2020 2020 2020 2020 la: │ │ │ │ │ +0004bd30: 2020 2020 2020 2020 2056 616c 6120 5375 Vala Su │ │ │ │ │ +0004bd40: 7070 6f72 742e 2020 2020 2020 2020 286c pport. (l │ │ │ │ │ +0004bd50: 696e 6520 2020 3629 0a2a 2074 6167 733a ine 6).* tags: │ │ │ │ │ 0004bd60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004bd70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004bd80: 2054 6167 732e 2020 2020 2020 2020 2020 Tags. │ │ │ │ │ -0004bd90: 2020 2020 2020 286c 696e 6520 2020 3929 (line 9) │ │ │ │ │ -0004bda0: 0a2a 2054 4147 5320 7375 7070 6f72 743a .* TAGS support: │ │ │ │ │ -0004bdb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004bdc0: 2020 2020 2020 2020 2020 5461 6773 2e20 Tags. │ │ │ │ │ -0004bdd0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0004bde0: 6c69 6e65 2020 2036 290a 2a20 7461 7220 line 6).* tar │ │ │ │ │ -0004bdf0: 666f 726d 6174 733a 2020 2020 2020 2020 formats: │ │ │ │ │ +0004bd80: 2020 5461 6773 2e20 2020 2020 2020 2020 Tags. │ │ │ │ │ +0004bd90: 2020 2020 2020 2028 6c69 6e65 2020 2039 (line 9 │ │ │ │ │ +0004bda0: 290a 2a20 5441 4753 2073 7570 706f 7274 ).* TAGS support │ │ │ │ │ +0004bdb0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0004bdc0: 2020 2020 2020 2020 2020 2054 6167 732e Tags. │ │ │ │ │ +0004bdd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0004bde0: 286c 696e 6520 2020 3629 0a2a 2074 6172 (line 6).* tar │ │ │ │ │ +0004bdf0: 2066 6f72 6d61 7473 3a20 2020 2020 2020 formats: │ │ │ │ │ 0004be00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004be10: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ -0004be20: 2020 2020 2020 2020 286c 696e 6520 3138 (line 18 │ │ │ │ │ -0004be30: 3529 0a2a 2074 6172 2d70 6178 3a20 2020 5).* tar-pax: │ │ │ │ │ +0004be10: 2020 2020 4f70 7469 6f6e 732e 2020 2020 Options. │ │ │ │ │ +0004be20: 2020 2020 2020 2020 2028 6c69 6e65 2031 (line 1 │ │ │ │ │ +0004be30: 3835 290a 2a20 7461 722d 7061 783a 2020 85).* tar-pax: │ │ │ │ │ 0004be40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004be50: 2020 2020 2020 2020 2020 2020 4f70 7469 Opti │ │ │ │ │ -0004be60: 6f6e 732e 2020 2020 2020 2020 2020 2020 ons. │ │ │ │ │ -0004be70: 2028 6c69 6e65 2031 3835 290a 2a20 7461 (line 185).* ta │ │ │ │ │ -0004be80: 722d 7573 7461 723a 2020 2020 2020 2020 r-ustar: │ │ │ │ │ +0004be50: 2020 2020 2020 2020 2020 2020 204f 7074 Opt │ │ │ │ │ +0004be60: 696f 6e73 2e20 2020 2020 2020 2020 2020 ions. │ │ │ │ │ +0004be70: 2020 286c 696e 6520 3138 3529 0a2a 2074 (line 185).* t │ │ │ │ │ +0004be80: 6172 2d75 7374 6172 3a20 2020 2020 2020 ar-ustar: │ │ │ │ │ 0004be90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004bea0: 2020 2020 204f 7074 696f 6e73 2e20 2020 Options. │ │ │ │ │ -0004beb0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004bec0: 3138 3529 0a2a 2074 6172 2d76 373a 2020 185).* tar-v7: │ │ │ │ │ +0004bea0: 2020 2020 2020 4f70 7469 6f6e 732e 2020 Options. │ │ │ │ │ +0004beb0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0004bec0: 2031 3835 290a 2a20 7461 722d 7637 3a20 185).* tar-v7: │ │ │ │ │ 0004bed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004bee0: 2020 2020 2020 2020 2020 2020 2020 4f70 Op │ │ │ │ │ -0004bef0: 7469 6f6e 732e 2020 2020 2020 2020 2020 tions. │ │ │ │ │ -0004bf00: 2020 2028 6c69 6e65 2031 3835 290a 2a20 (line 185).* │ │ │ │ │ -0004bf10: 5461 7267 6574 2c20 696e 7374 616c 6c2d Target, install- │ │ │ │ │ -0004bf20: 696e 666f 3a20 2020 2020 2020 2020 2020 info: │ │ │ │ │ -0004bf30: 2020 2020 2020 2054 6578 696e 666f 2e20 Texinfo. │ │ │ │ │ -0004bf40: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -0004bf50: 6520 2037 3929 0a2a 2054 6172 6765 742c e 79).* Target, │ │ │ │ │ -0004bf60: 2069 6e73 7461 6c6c 2d6d 616e 3a20 2020 install-man: │ │ │ │ │ +0004bee0: 2020 2020 2020 2020 2020 2020 2020 204f O │ │ │ │ │ +0004bef0: 7074 696f 6e73 2e20 2020 2020 2020 2020 ptions. │ │ │ │ │ +0004bf00: 2020 2020 286c 696e 6520 3138 3529 0a2a (line 185).* │ │ │ │ │ +0004bf10: 2054 6172 6765 742c 2069 6e73 7461 6c6c Target, install │ │ │ │ │ +0004bf20: 2d69 6e66 6f3a 2020 2020 2020 2020 2020 -info: │ │ │ │ │ +0004bf30: 2020 2020 2020 2020 5465 7869 6e66 6f2e Texinfo. │ │ │ │ │ +0004bf40: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0004bf50: 6e65 2020 3739 290a 2a20 5461 7267 6574 ne 79).* Target │ │ │ │ │ +0004bf60: 2c20 696e 7374 616c 6c2d 6d61 6e3a 2020 , install-man: │ │ │ │ │ 0004bf70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004bf80: 4d61 6e20 5061 6765 732e 2020 2020 2020 Man Pages. │ │ │ │ │ -0004bf90: 2020 2020 2028 6c69 6e65 2020 3332 290a (line 32). │ │ │ │ │ -0004bfa0: 2a20 7465 726d 696f 7320 504f 5349 5820 * termios POSIX │ │ │ │ │ -0004bfb0: 6865 6164 6572 733a 2020 2020 2020 2020 headers: │ │ │ │ │ -0004bfc0: 2020 2020 2020 2020 204f 6273 6f6c 6574 Obsolet │ │ │ │ │ -0004bfd0: 6520 4d61 6372 6f73 2e20 2020 2020 286c e Macros. (l │ │ │ │ │ -0004bfe0: 696e 6520 2035 3729 0a2a 2054 6573 7420 ine 57).* Test │ │ │ │ │ -0004bff0: 7375 6974 6573 3a20 2020 2020 2020 2020 suites: │ │ │ │ │ +0004bf80: 204d 616e 2050 6167 6573 2e20 2020 2020 Man Pages. │ │ │ │ │ +0004bf90: 2020 2020 2020 286c 696e 6520 2033 3229 (line 32) │ │ │ │ │ +0004bfa0: 0a2a 2074 6572 6d69 6f73 2050 4f53 4958 .* termios POSIX │ │ │ │ │ +0004bfb0: 2068 6561 6465 7273 3a20 2020 2020 2020 headers: │ │ │ │ │ +0004bfc0: 2020 2020 2020 2020 2020 4f62 736f 6c65 Obsole │ │ │ │ │ +0004bfd0: 7465 204d 6163 726f 732e 2020 2020 2028 te Macros. ( │ │ │ │ │ +0004bfe0: 6c69 6e65 2020 3537 290a 2a20 5465 7374 line 57).* Test │ │ │ │ │ +0004bff0: 2073 7569 7465 733a 2020 2020 2020 2020 suites: │ │ │ │ │ 0004c000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c010: 2020 5465 7374 732e 2020 2020 2020 2020 Tests. │ │ │ │ │ -0004c020: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ -0004c030: 290a 2a20 5465 7374 732c 2065 7870 6563 ).* Tests, expec │ │ │ │ │ -0004c040: 7465 6420 6661 696c 7572 653a 2020 2020 ted failure: │ │ │ │ │ -0004c050: 2020 2020 2020 2020 2020 2053 696d 706c Simpl │ │ │ │ │ -0004c060: 6520 5465 7374 732e 2020 2020 2020 2020 e Tests. │ │ │ │ │ -0004c070: 286c 696e 6520 2035 3129 0a2a 2054 6578 (line 51).* Tex │ │ │ │ │ -0004c080: 696e 666f 2066 6c61 672c 2045 4449 5449 info flag, EDITI │ │ │ │ │ -0004c090: 4f4e 3a20 2020 2020 2020 2020 2020 2020 ON: │ │ │ │ │ -0004c0a0: 2020 2020 5465 7869 6e66 6f2e 2020 2020 Texinfo. │ │ │ │ │ -0004c0b0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0004c0c0: 3239 290a 2a20 5465 7869 6e66 6f20 666c 29).* Texinfo fl │ │ │ │ │ -0004c0d0: 6167 2c20 5550 4441 5445 443a 2020 2020 ag, UPDATED: │ │ │ │ │ -0004c0e0: 2020 2020 2020 2020 2020 2020 2054 6578 Tex │ │ │ │ │ -0004c0f0: 696e 666f 2e20 2020 2020 2020 2020 2020 info. │ │ │ │ │ -0004c100: 2020 286c 696e 6520 2032 3929 0a2a 2054 (line 29).* T │ │ │ │ │ -0004c110: 6578 696e 666f 2066 6c61 672c 2055 5044 exinfo flag, UPD │ │ │ │ │ -0004c120: 4154 4544 2d4d 4f4e 5448 3a20 2020 2020 ATED-MONTH: │ │ │ │ │ -0004c130: 2020 2020 2020 5465 7869 6e66 6f2e 2020 Texinfo. │ │ │ │ │ -0004c140: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0004c150: 2020 3239 290a 2a20 5465 7869 6e66 6f20 29).* Texinfo │ │ │ │ │ -0004c160: 666c 6167 2c20 5645 5253 494f 4e3a 2020 flag, VERSION: │ │ │ │ │ -0004c170: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -0004c180: 6578 696e 666f 2e20 2020 2020 2020 2020 exinfo. │ │ │ │ │ -0004c190: 2020 2020 286c 696e 6520 2032 3929 0a2a (line 29).* │ │ │ │ │ -0004c1a0: 2074 6578 696e 666f 2e74 6578 3a20 2020 texinfo.tex: │ │ │ │ │ +0004c010: 2020 2054 6573 7473 2e20 2020 2020 2020 Tests. │ │ │ │ │ +0004c020: 2020 2020 2020 2020 286c 696e 6520 2020 (line │ │ │ │ │ +0004c030: 3629 0a2a 2054 6573 7473 2c20 6578 7065 6).* Tests, expe │ │ │ │ │ +0004c040: 6374 6564 2066 6169 6c75 7265 3a20 2020 cted failure: │ │ │ │ │ +0004c050: 2020 2020 2020 2020 2020 2020 5369 6d70 Simp │ │ │ │ │ +0004c060: 6c65 2054 6573 7473 2e20 2020 2020 2020 le Tests. │ │ │ │ │ +0004c070: 2028 6c69 6e65 2020 3531 290a 2a20 5465 (line 51).* Te │ │ │ │ │ +0004c080: 7869 6e66 6f20 666c 6167 2c20 4544 4954 xinfo flag, EDIT │ │ │ │ │ +0004c090: 494f 4e3a 2020 2020 2020 2020 2020 2020 ION: │ │ │ │ │ +0004c0a0: 2020 2020 2054 6578 696e 666f 2e20 2020 Texinfo. │ │ │ │ │ +0004c0b0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0004c0c0: 2032 3929 0a2a 2054 6578 696e 666f 2066 29).* Texinfo f │ │ │ │ │ +0004c0d0: 6c61 672c 2055 5044 4154 4544 3a20 2020 lag, UPDATED: │ │ │ │ │ +0004c0e0: 2020 2020 2020 2020 2020 2020 2020 5465 Te │ │ │ │ │ +0004c0f0: 7869 6e66 6f2e 2020 2020 2020 2020 2020 xinfo. │ │ │ │ │ +0004c100: 2020 2028 6c69 6e65 2020 3239 290a 2a20 (line 29).* │ │ │ │ │ +0004c110: 5465 7869 6e66 6f20 666c 6167 2c20 5550 Texinfo flag, UP │ │ │ │ │ +0004c120: 4441 5445 442d 4d4f 4e54 483a 2020 2020 DATED-MONTH: │ │ │ │ │ +0004c130: 2020 2020 2020 2054 6578 696e 666f 2e20 Texinfo. │ │ │ │ │ +0004c140: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0004c150: 6520 2032 3929 0a2a 2054 6578 696e 666f e 29).* Texinfo │ │ │ │ │ +0004c160: 2066 6c61 672c 2056 4552 5349 4f4e 3a20 flag, VERSION: │ │ │ │ │ +0004c170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0004c180: 5465 7869 6e66 6f2e 2020 2020 2020 2020 Texinfo. │ │ │ │ │ +0004c190: 2020 2020 2028 6c69 6e65 2020 3239 290a (line 29). │ │ │ │ │ +0004c1a0: 2a20 7465 7869 6e66 6f2e 7465 783a 2020 * texinfo.tex: │ │ │ │ │ 0004c1b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c1c0: 2020 2020 2020 2020 5465 7869 6e66 6f2e Texinfo. │ │ │ │ │ -0004c1d0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0004c1e0: 6e65 2020 3634 290a 2a20 5445 5849 4e46 ne 64).* TEXINF │ │ │ │ │ -0004c1f0: 4f53 2070 7269 6d61 7279 2c20 6465 6669 OS primary, defi │ │ │ │ │ -0004c200: 6e65 643a 2020 2020 2020 2020 2020 2020 ned: │ │ │ │ │ -0004c210: 2054 6578 696e 666f 2e20 2020 2020 2020 Texinfo. │ │ │ │ │ -0004c220: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ -0004c230: 0a2a 2074 6869 7264 2d70 6172 7479 2066 .* third-party f │ │ │ │ │ -0004c240: 696c 6573 2061 6e64 2043 5653 3a20 2020 iles and CVS: │ │ │ │ │ -0004c250: 2020 2020 2020 2020 2020 4356 532e 2020 CVS. │ │ │ │ │ -0004c260: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -0004c270: 6c69 6e65 2031 3337 290a 2a20 5468 6972 line 137).* Thir │ │ │ │ │ -0004c280: 642d 7061 7274 7920 7061 636b 6167 6573 d-party packages │ │ │ │ │ -0004c290: 2c20 696e 7465 7266 6163 696e 6720 7769 , interfacing wi │ │ │ │ │ -0004c2a0: 7468 3a20 5468 6972 642d 5061 7274 7920 th: Third-Party │ │ │ │ │ -0004c2b0: 4d61 6b65 6669 6c65 732e 0a20 2020 2020 Makefiles.. │ │ │ │ │ +0004c1c0: 2020 2020 2020 2020 2054 6578 696e 666f Texinfo │ │ │ │ │ +0004c1d0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0004c1e0: 696e 6520 2036 3429 0a2a 2054 4558 494e ine 64).* TEXIN │ │ │ │ │ +0004c1f0: 464f 5320 7072 696d 6172 792c 2064 6566 FOS primary, def │ │ │ │ │ +0004c200: 696e 6564 3a20 2020 2020 2020 2020 2020 ined: │ │ │ │ │ +0004c210: 2020 5465 7869 6e66 6f2e 2020 2020 2020 Texinfo. │ │ │ │ │ +0004c220: 2020 2020 2020 2028 6c69 6e65 2020 2036 (line 6 │ │ │ │ │ +0004c230: 290a 2a20 7468 6972 642d 7061 7274 7920 ).* third-party │ │ │ │ │ +0004c240: 6669 6c65 7320 616e 6420 4356 533a 2020 files and CVS: │ │ │ │ │ +0004c250: 2020 2020 2020 2020 2020 2043 5653 2e20 CVS. │ │ │ │ │ +0004c260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0004c270: 286c 696e 6520 3133 3729 0a2a 2054 6869 (line 137).* Thi │ │ │ │ │ +0004c280: 7264 2d70 6172 7479 2070 6163 6b61 6765 rd-party package │ │ │ │ │ +0004c290: 732c 2069 6e74 6572 6661 6369 6e67 2077 s, interfacing w │ │ │ │ │ +0004c2a0: 6974 683a 2054 6869 7264 2d50 6172 7479 ith: Third-Party │ │ │ │ │ +0004c2b0: 204d 616b 6566 696c 6573 2e0a 2020 2020 Makefiles.. │ │ │ │ │ 0004c2c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c2d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c2e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c2f0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0004c300: 2036 290a 2a20 7469 6d65 7374 616d 7073 6).* timestamps │ │ │ │ │ -0004c310: 2061 6e64 2043 5653 3a20 2020 2020 2020 and CVS: │ │ │ │ │ -0004c320: 2020 2020 2020 2020 2020 2020 2043 5653 CVS │ │ │ │ │ -0004c330: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -0004c340: 2020 286c 696e 6520 2032 3829 0a2a 2054 (line 28).* T │ │ │ │ │ -0004c350: 7261 6e73 666f 726d 696e 6720 7072 6f67 ransforming prog │ │ │ │ │ -0004c360: 7261 6d20 6e61 6d65 733a 2020 2020 2020 ram names: │ │ │ │ │ -0004c370: 2020 2020 2020 5265 6e61 6d69 6e67 2e20 Renaming. │ │ │ │ │ -0004c380: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0004c390: 2020 2036 290a 2a20 7472 6565 732c 2073 6).* trees, s │ │ │ │ │ -0004c3a0: 6f75 7263 6520 7673 2e20 6275 696c 643a ource vs. build: │ │ │ │ │ -0004c3b0: 2020 2020 2020 2020 2020 2020 2020 2056 V │ │ │ │ │ -0004c3c0: 5041 5448 2042 7569 6c64 732e 2020 2020 PATH Builds. │ │ │ │ │ -0004c3d0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0004c3e0: 2074 7275 6520 4578 616d 706c 653a 2020 true Example: │ │ │ │ │ +0004c2f0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0004c300: 2020 3629 0a2a 2074 696d 6573 7461 6d70 6).* timestamp │ │ │ │ │ +0004c310: 7320 616e 6420 4356 533a 2020 2020 2020 s and CVS: │ │ │ │ │ +0004c320: 2020 2020 2020 2020 2020 2020 2020 4356 CV │ │ │ │ │ +0004c330: 532e 2020 2020 2020 2020 2020 2020 2020 S. │ │ │ │ │ +0004c340: 2020 2028 6c69 6e65 2020 3238 290a 2a20 (line 28).* │ │ │ │ │ +0004c350: 5472 616e 7366 6f72 6d69 6e67 2070 726f Transforming pro │ │ │ │ │ +0004c360: 6772 616d 206e 616d 6573 3a20 2020 2020 gram names: │ │ │ │ │ +0004c370: 2020 2020 2020 2052 656e 616d 696e 672e Renaming. │ │ │ │ │ +0004c380: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +0004c390: 6520 2020 3629 0a2a 2074 7265 6573 2c20 e 6).* trees, │ │ │ │ │ +0004c3a0: 736f 7572 6365 2076 732e 2062 7569 6c64 source vs. build │ │ │ │ │ +0004c3b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +0004c3c0: 5650 4154 4820 4275 696c 6473 2e20 2020 VPATH Builds. │ │ │ │ │ +0004c3d0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0004c3e0: 2a20 7472 7565 2045 7861 6d70 6c65 3a20 * true Example: │ │ │ │ │ 0004c3f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c400: 2020 2020 2020 2020 7472 7565 2e20 2020 true. │ │ │ │ │ -0004c410: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0004c420: 6e65 2020 2036 290a 2a20 756e 6465 7271 ne 6).* underq │ │ │ │ │ -0004c430: 756f 7465 6420 4143 5f44 4546 554e 3a20 uoted AC_DEFUN: │ │ │ │ │ +0004c400: 2020 2020 2020 2020 2074 7275 652e 2020 true. │ │ │ │ │ +0004c410: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +0004c420: 696e 6520 2020 3629 0a2a 2075 6e64 6572 ine 6).* under │ │ │ │ │ +0004c430: 7175 6f74 6564 2041 435f 4445 4655 4e3a quoted AC_DEFUN: │ │ │ │ │ 0004c440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c450: 2045 7874 656e 6469 6e67 2061 636c 6f63 Extending acloc │ │ │ │ │ -0004c460: 616c 2e20 2020 286c 696e 6520 2033 3629 al. (line 36) │ │ │ │ │ -0004c470: 0a2a 2055 6e69 6669 6564 2050 6172 616c .* Unified Paral │ │ │ │ │ -0004c480: 6c65 6c20 4320 7375 7070 6f72 743a 2020 lel C support: │ │ │ │ │ -0004c490: 2020 2020 2020 2020 2020 556e 6966 6965 Unifie │ │ │ │ │ -0004c4a0: 6420 5061 7261 6c6c 656c 2043 2053 7570 d Parallel C Sup │ │ │ │ │ -0004c4b0: 706f 7274 2e0a 2020 2020 2020 2020 2020 port.. │ │ │ │ │ +0004c450: 2020 4578 7465 6e64 696e 6720 6163 6c6f Extending aclo │ │ │ │ │ +0004c460: 6361 6c2e 2020 2028 6c69 6e65 2020 3336 cal. (line 36 │ │ │ │ │ +0004c470: 290a 2a20 556e 6966 6965 6420 5061 7261 ).* Unified Para │ │ │ │ │ +0004c480: 6c6c 656c 2043 2073 7570 706f 7274 3a20 llel C support: │ │ │ │ │ +0004c490: 2020 2020 2020 2020 2020 2055 6e69 6669 Unifi │ │ │ │ │ +0004c4a0: 6564 2050 6172 616c 6c65 6c20 4320 5375 ed Parallel C Su │ │ │ │ │ +0004c4b0: 7070 6f72 742e 0a20 2020 2020 2020 2020 pport.. │ │ │ │ │ 0004c4c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c4d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c4e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c4f0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ -0004c500: 2055 6e69 666f 726d 206e 616d 696e 6720 Uniform naming │ │ │ │ │ -0004c510: 7363 6865 6d65 3a20 2020 2020 2020 2020 scheme: │ │ │ │ │ -0004c520: 2020 2020 2020 2020 556e 6966 6f72 6d2e Uniform. │ │ │ │ │ -0004c530: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -0004c540: 6e65 2020 2036 290a 2a20 756e 696e 7374 ne 6).* uninst │ │ │ │ │ -0004c550: 616c 6c3a 2020 2020 2020 2020 2020 2020 all: │ │ │ │ │ +0004c4f0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ +0004c500: 2a20 556e 6966 6f72 6d20 6e61 6d69 6e67 * Uniform naming │ │ │ │ │ +0004c510: 2073 6368 656d 653a 2020 2020 2020 2020 scheme: │ │ │ │ │ +0004c520: 2020 2020 2020 2020 2055 6e69 666f 726d Uniform │ │ │ │ │ +0004c530: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +0004c540: 696e 6520 2020 3629 0a2a 2075 6e69 6e73 ine 6).* unins │ │ │ │ │ +0004c550: 7461 6c6c 3a20 2020 2020 2020 2020 2020 tall: │ │ │ │ │ 0004c560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c570: 2053 7461 6e64 6172 6420 5461 7267 6574 Standard Target │ │ │ │ │ -0004c580: 732e 2020 2020 286c 696e 6520 2032 3429 s. (line 24) │ │ │ │ │ -0004c590: 0a2a 2075 6e69 6e73 7461 6c6c 203c 313e .* uninstall <1> │ │ │ │ │ -0004c5a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0004c5b0: 2020 2020 2020 2020 2020 496e 7374 616c Instal │ │ │ │ │ -0004c5c0: 6c20 5275 6c65 7320 666f 7220 7468 6520 l Rules for the │ │ │ │ │ -0004c5d0: 5573 6572 2e0a 2020 2020 2020 2020 2020 User.. │ │ │ │ │ +0004c570: 2020 5374 616e 6461 7264 2054 6172 6765 Standard Targe │ │ │ │ │ +0004c580: 7473 2e20 2020 2028 6c69 6e65 2020 3234 ts. (line 24 │ │ │ │ │ +0004c590: 290a 2a20 756e 696e 7374 616c 6c20 3c31 ).* uninstall <1 │ │ │ │ │ +0004c5a0: 3e3a 2020 2020 2020 2020 2020 2020 2020 >: │ │ │ │ │ +0004c5b0: 2020 2020 2020 2020 2020 2049 6e73 7461 Insta │ │ │ │ │ +0004c5c0: 6c6c 2052 756c 6573 2066 6f72 2074 6865 ll Rules for the │ │ │ │ │ +0004c5d0: 2055 7365 722e 0a20 2020 2020 2020 2020 User.. │ │ │ │ │ 0004c5e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c5f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c610: 2020 2020 286c 696e 6520 2020 3729 0a2a (line 7).* │ │ │ │ │ -0004c620: 2075 6e69 6e73 7461 6c6c 203c 323e 3a20 uninstall <2>: │ │ │ │ │ +0004c610: 2020 2020 2028 6c69 6e65 2020 2037 290a (line 7). │ │ │ │ │ +0004c620: 2a20 756e 696e 7374 616c 6c20 3c32 3e3a * uninstall <2>: │ │ │ │ │ 0004c630: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c640: 2020 2020 2020 2020 4578 7465 6e64 696e Extendin │ │ │ │ │ -0004c650: 672e 2020 2020 2020 2020 2020 2028 6c69 g. (li │ │ │ │ │ -0004c660: 6e65 2020 3431 290a 2a20 756e 696e 7374 ne 41).* uninst │ │ │ │ │ -0004c670: 616c 6c2d 686f 6f6b 3a20 2020 2020 2020 all-hook: │ │ │ │ │ +0004c640: 2020 2020 2020 2020 2045 7874 656e 6469 Extendi │ │ │ │ │ +0004c650: 6e67 2e20 2020 2020 2020 2020 2020 286c ng. (l │ │ │ │ │ +0004c660: 696e 6520 2034 3129 0a2a 2075 6e69 6e73 ine 41).* unins │ │ │ │ │ +0004c670: 7461 6c6c 2d68 6f6f 6b3a 2020 2020 2020 tall-hook: │ │ │ │ │ 0004c680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c690: 2045 7874 656e 6469 6e67 2e20 2020 2020 Extending. │ │ │ │ │ -0004c6a0: 2020 2020 2020 286c 696e 6520 2036 3629 (line 66) │ │ │ │ │ -0004c6b0: 0a2a 2075 6e69 6e73 7461 6c6c 2d6c 6f63 .* uninstall-loc │ │ │ │ │ -0004c6c0: 616c 3a20 2020 2020 2020 2020 2020 2020 al: │ │ │ │ │ -0004c6d0: 2020 2020 2020 2020 2020 4578 7465 6e64 Extend │ │ │ │ │ -0004c6e0: 696e 672e 2020 2020 2020 2020 2020 2028 ing. ( │ │ │ │ │ -0004c6f0: 6c69 6e65 2020 3431 290a 2a20 556e 6974 line 41).* Unit │ │ │ │ │ -0004c700: 2074 6573 7473 3a20 2020 2020 2020 2020 tests: │ │ │ │ │ +0004c690: 2020 4578 7465 6e64 696e 672e 2020 2020 Extending. │ │ │ │ │ +0004c6a0: 2020 2020 2020 2028 6c69 6e65 2020 3636 (line 66 │ │ │ │ │ +0004c6b0: 290a 2a20 756e 696e 7374 616c 6c2d 6c6f ).* uninstall-lo │ │ │ │ │ +0004c6c0: 6361 6c3a 2020 2020 2020 2020 2020 2020 cal: │ │ │ │ │ +0004c6d0: 2020 2020 2020 2020 2020 2045 7874 656e Exten │ │ │ │ │ +0004c6e0: 6469 6e67 2e20 2020 2020 2020 2020 2020 ding. │ │ │ │ │ +0004c6f0: 286c 696e 6520 2034 3129 0a2a 2055 6e69 (line 41).* Uni │ │ │ │ │ +0004c700: 7420 7465 7374 733a 2020 2020 2020 2020 t tests: │ │ │ │ │ 0004c710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c720: 2020 2053 696d 706c 6520 5465 7374 7320 Simple Tests │ │ │ │ │ -0004c730: 7573 696e 6720 7061 7261 6c6c 656c 2d74 using parallel-t │ │ │ │ │ -0004c740: 6573 7473 2e0a 2020 2020 2020 2020 2020 ests.. │ │ │ │ │ +0004c720: 2020 2020 5369 6d70 6c65 2054 6573 7473 Simple Tests │ │ │ │ │ +0004c730: 2075 7369 6e67 2070 6172 616c 6c65 6c2d using parallel- │ │ │ │ │ +0004c740: 7465 7374 732e 0a20 2020 2020 2020 2020 tests.. │ │ │ │ │ 0004c750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c770: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c780: 2020 2020 286c 696e 6520 3135 3329 0a2a (line 153).* │ │ │ │ │ -0004c790: 2055 6e70 6163 6b69 6e67 3a20 2020 2020 Unpacking: │ │ │ │ │ +0004c780: 2020 2020 2028 6c69 6e65 2031 3533 290a (line 153). │ │ │ │ │ +0004c790: 2a20 556e 7061 636b 696e 673a 2020 2020 * Unpacking: │ │ │ │ │ 0004c7a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c7b0: 2020 2020 2020 2020 4261 7369 6320 496e Basic In │ │ │ │ │ -0004c7c0: 7374 616c 6c61 7469 6f6e 2e20 2028 6c69 stallation. (li │ │ │ │ │ -0004c7d0: 6e65 2020 3237 290a 2a20 5550 4346 4c41 ne 27).* UPCFLA │ │ │ │ │ -0004c7e0: 4753 2061 6e64 2041 4d5f 5550 4346 4c41 GS and AM_UPCFLA │ │ │ │ │ -0004c7f0: 4753 3a20 2020 2020 2020 2020 2020 2020 GS: │ │ │ │ │ -0004c800: 2046 6c61 6720 5661 7269 6162 6c65 7320 Flag Variables │ │ │ │ │ -0004c810: 4f72 6465 7269 6e67 2e0a 2020 2020 2020 Ordering.. │ │ │ │ │ +0004c7b0: 2020 2020 2020 2020 2042 6173 6963 2049 Basic I │ │ │ │ │ +0004c7c0: 6e73 7461 6c6c 6174 696f 6e2e 2020 286c nstallation. (l │ │ │ │ │ +0004c7d0: 696e 6520 2032 3729 0a2a 2055 5043 464c ine 27).* UPCFL │ │ │ │ │ +0004c7e0: 4147 5320 616e 6420 414d 5f55 5043 464c AGS and AM_UPCFL │ │ │ │ │ +0004c7f0: 4147 533a 2020 2020 2020 2020 2020 2020 AGS: │ │ │ │ │ +0004c800: 2020 466c 6167 2056 6172 6961 626c 6573 Flag Variables │ │ │ │ │ +0004c810: 204f 7264 6572 696e 672e 0a20 2020 2020 Ordering.. │ │ │ │ │ 0004c820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c830: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004c840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c850: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ -0004c860: 3029 0a2a 2055 5044 4154 4544 2054 6578 0).* UPDATED Tex │ │ │ │ │ -0004c870: 696e 666f 2066 6c61 673a 2020 2020 2020 info flag: │ │ │ │ │ -0004c880: 2020 2020 2020 2020 2020 2020 5465 7869 Texi │ │ │ │ │ -0004c890: 6e66 6f2e 2020 2020 2020 2020 2020 2020 nfo. │ │ │ │ │ -0004c8a0: 2028 6c69 6e65 2020 3239 290a 2a20 5550 (line 29).* UP │ │ │ │ │ -0004c8b0: 4441 5445 442d 4d4f 4e54 4820 5465 7869 DATED-MONTH Texi │ │ │ │ │ -0004c8c0: 6e66 6f20 666c 6167 3a20 2020 2020 2020 nfo flag: │ │ │ │ │ -0004c8d0: 2020 2020 2054 6578 696e 666f 2e20 2020 Texinfo. │ │ │ │ │ -0004c8e0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004c8f0: 2032 3929 0a2a 2055 7365 2043 6173 6573 29).* Use Cases │ │ │ │ │ -0004c900: 2066 6f72 2074 6865 2047 4e55 2042 7569 for the GNU Bui │ │ │ │ │ -0004c910: 6c64 2053 7973 7465 6d3a 2020 2020 5573 ld System: Us │ │ │ │ │ -0004c920: 6520 4361 7365 732e 2020 2020 2020 2020 e Cases. │ │ │ │ │ -0004c930: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -0004c940: 7573 6572 2076 6172 6961 626c 6573 3a20 user variables: │ │ │ │ │ +0004c850: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0004c860: 3230 290a 2a20 5550 4441 5445 4420 5465 20).* UPDATED Te │ │ │ │ │ +0004c870: 7869 6e66 6f20 666c 6167 3a20 2020 2020 xinfo flag: │ │ │ │ │ +0004c880: 2020 2020 2020 2020 2020 2020 2054 6578 Tex │ │ │ │ │ +0004c890: 696e 666f 2e20 2020 2020 2020 2020 2020 info. │ │ │ │ │ +0004c8a0: 2020 286c 696e 6520 2032 3929 0a2a 2055 (line 29).* U │ │ │ │ │ +0004c8b0: 5044 4154 4544 2d4d 4f4e 5448 2054 6578 PDATED-MONTH Tex │ │ │ │ │ +0004c8c0: 696e 666f 2066 6c61 673a 2020 2020 2020 info flag: │ │ │ │ │ +0004c8d0: 2020 2020 2020 5465 7869 6e66 6f2e 2020 Texinfo. │ │ │ │ │ +0004c8e0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0004c8f0: 2020 3239 290a 2a20 5573 6520 4361 7365 29).* Use Case │ │ │ │ │ +0004c900: 7320 666f 7220 7468 6520 474e 5520 4275 s for the GNU Bu │ │ │ │ │ +0004c910: 696c 6420 5379 7374 656d 3a20 2020 2055 ild System: U │ │ │ │ │ +0004c920: 7365 2043 6173 6573 2e20 2020 2020 2020 se Cases. │ │ │ │ │ +0004c930: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +0004c940: 2075 7365 7220 7661 7269 6162 6c65 733a user variables: │ │ │ │ │ 0004c950: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c960: 2020 2020 2020 2055 7365 7220 5661 7269 User Vari │ │ │ │ │ -0004c970: 6162 6c65 732e 2020 2020 2020 286c 696e ables. (lin │ │ │ │ │ -0004c980: 6520 2020 3629 0a2a 2055 7369 6e67 2061 e 6).* Using a │ │ │ │ │ -0004c990: 636c 6f63 616c 3a20 2020 2020 2020 2020 clocal: │ │ │ │ │ +0004c960: 2020 2020 2020 2020 5573 6572 2056 6172 User Var │ │ │ │ │ +0004c970: 6961 626c 6573 2e20 2020 2020 2028 6c69 iables. (li │ │ │ │ │ +0004c980: 6e65 2020 2036 290a 2a20 5573 696e 6720 ne 6).* Using │ │ │ │ │ +0004c990: 6163 6c6f 6361 6c3a 2020 2020 2020 2020 aclocal: │ │ │ │ │ 0004c9a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c9b0: 636f 6e66 6967 7572 652e 2020 2020 2020 configure. │ │ │ │ │ -0004c9c0: 2020 2020 2028 6c69 6e65 2020 2036 290a (line 6). │ │ │ │ │ -0004c9d0: 2a20 7573 7461 7220 666f 726d 6174 3a20 * ustar format: │ │ │ │ │ +0004c9b0: 2063 6f6e 6669 6775 7265 2e20 2020 2020 configure. │ │ │ │ │ +0004c9c0: 2020 2020 2020 286c 696e 6520 2020 3629 (line 6) │ │ │ │ │ +0004c9d0: 0a2a 2075 7374 6172 2066 6f72 6d61 743a .* ustar format: │ │ │ │ │ 0004c9e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004c9f0: 2020 2020 2020 2020 204f 7074 696f 6e73 Options │ │ │ │ │ -0004ca00: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -0004ca10: 696e 6520 3138 3529 0a2a 2076 3720 7461 ine 185).* v7 ta │ │ │ │ │ -0004ca20: 7220 666f 726d 6174 3a20 2020 2020 2020 r format: │ │ │ │ │ +0004c9f0: 2020 2020 2020 2020 2020 4f70 7469 6f6e Option │ │ │ │ │ +0004ca00: 732e 2020 2020 2020 2020 2020 2020 2028 s. ( │ │ │ │ │ +0004ca10: 6c69 6e65 2031 3835 290a 2a20 7637 2074 line 185).* v7 t │ │ │ │ │ +0004ca20: 6172 2066 6f72 6d61 743a 2020 2020 2020 ar format: │ │ │ │ │ 0004ca30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004ca40: 2020 4f70 7469 6f6e 732e 2020 2020 2020 Options. │ │ │ │ │ -0004ca50: 2020 2020 2020 2028 6c69 6e65 2031 3835 (line 185 │ │ │ │ │ -0004ca60: 290a 2a20 5661 6c61 2053 7570 706f 7274 ).* Vala Support │ │ │ │ │ -0004ca70: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -0004ca80: 2020 2020 2020 2020 2020 2056 616c 6120 Vala │ │ │ │ │ -0004ca90: 5375 7070 6f72 742e 2020 2020 2020 2020 Support. │ │ │ │ │ -0004caa0: 286c 696e 6520 2020 3629 0a2a 2076 6172 (line 6).* var │ │ │ │ │ -0004cab0: 6961 626c 6573 2c20 636f 6e66 6c69 6374 iables, conflict │ │ │ │ │ -0004cac0: 696e 673a 2020 2020 2020 2020 2020 2020 ing: │ │ │ │ │ -0004cad0: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ -0004cae0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0004caf0: 3134 290a 2a20 5661 7269 6162 6c65 732c 14).* Variables, │ │ │ │ │ -0004cb00: 206f 7665 7272 6964 696e 673a 2020 2020 overriding: │ │ │ │ │ -0004cb10: 2020 2020 2020 2020 2020 2020 2047 656e Gen │ │ │ │ │ -0004cb20: 6572 616c 204f 7065 7261 7469 6f6e 2e20 eral Operation. │ │ │ │ │ -0004cb30: 2020 286c 696e 6520 2035 3129 0a2a 2076 (line 51).* v │ │ │ │ │ -0004cb40: 6172 6961 626c 6573 2c20 7265 7365 7276 ariables, reserv │ │ │ │ │ -0004cb50: 6564 2066 6f72 2074 6865 2075 7365 723a ed for the user: │ │ │ │ │ -0004cb60: 2020 2020 2020 5573 6572 2056 6172 6961 User Varia │ │ │ │ │ -0004cb70: 626c 6573 2e20 2020 2020 2028 6c69 6e65 bles. (line │ │ │ │ │ -0004cb80: 2020 2036 290a 2a20 5645 5253 494f 4e20 6).* VERSION │ │ │ │ │ -0004cb90: 5465 7869 6e66 6f20 666c 6167 3a20 2020 Texinfo flag: │ │ │ │ │ -0004cba0: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -0004cbb0: 6578 696e 666f 2e20 2020 2020 2020 2020 exinfo. │ │ │ │ │ -0004cbc0: 2020 2020 286c 696e 6520 2032 3929 0a2a (line 29).* │ │ │ │ │ -0004cbd0: 2056 4552 5349 4f4e 2c20 7072 6576 656e VERSION, preven │ │ │ │ │ -0004cbe0: 7420 6465 6669 6e69 7469 6f6e 3a20 2020 t definition: │ │ │ │ │ -0004cbf0: 2020 2020 2020 2020 5075 626c 6963 204d Public M │ │ │ │ │ -0004cc00: 6163 726f 732e 2020 2020 2020 2028 6c69 acros. (li │ │ │ │ │ -0004cc10: 6e65 2020 3630 290a 2a20 7665 7273 696f ne 60).* versio │ │ │ │ │ -0004cc20: 6e2e 6d34 2c20 6578 616d 706c 653a 2020 n.m4, example: │ │ │ │ │ +0004ca40: 2020 204f 7074 696f 6e73 2e20 2020 2020 Options. │ │ │ │ │ +0004ca50: 2020 2020 2020 2020 286c 696e 6520 3138 (line 18 │ │ │ │ │ +0004ca60: 3529 0a2a 2056 616c 6120 5375 7070 6f72 5).* Vala Suppor │ │ │ │ │ +0004ca70: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ +0004ca80: 2020 2020 2020 2020 2020 2020 5661 6c61 Vala │ │ │ │ │ +0004ca90: 2053 7570 706f 7274 2e20 2020 2020 2020 Support. │ │ │ │ │ +0004caa0: 2028 6c69 6e65 2020 2036 290a 2a20 7661 (line 6).* va │ │ │ │ │ +0004cab0: 7269 6162 6c65 732c 2063 6f6e 666c 6963 riables, conflic │ │ │ │ │ +0004cac0: 7469 6e67 3a20 2020 2020 2020 2020 2020 ting: │ │ │ │ │ +0004cad0: 2020 2020 2045 7874 656e 6469 6e67 2e20 Extending. │ │ │ │ │ +0004cae0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0004caf0: 2031 3429 0a2a 2056 6172 6961 626c 6573 14).* Variables │ │ │ │ │ +0004cb00: 2c20 6f76 6572 7269 6469 6e67 3a20 2020 , overriding: │ │ │ │ │ +0004cb10: 2020 2020 2020 2020 2020 2020 2020 4765 Ge │ │ │ │ │ +0004cb20: 6e65 7261 6c20 4f70 6572 6174 696f 6e2e neral Operation. │ │ │ │ │ +0004cb30: 2020 2028 6c69 6e65 2020 3531 290a 2a20 (line 51).* │ │ │ │ │ +0004cb40: 7661 7269 6162 6c65 732c 2072 6573 6572 variables, reser │ │ │ │ │ +0004cb50: 7665 6420 666f 7220 7468 6520 7573 6572 ved for the user │ │ │ │ │ +0004cb60: 3a20 2020 2020 2055 7365 7220 5661 7269 : User Vari │ │ │ │ │ +0004cb70: 6162 6c65 732e 2020 2020 2020 286c 696e ables. (lin │ │ │ │ │ +0004cb80: 6520 2020 3629 0a2a 2056 4552 5349 4f4e e 6).* VERSION │ │ │ │ │ +0004cb90: 2054 6578 696e 666f 2066 6c61 673a 2020 Texinfo flag: │ │ │ │ │ +0004cba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0004cbb0: 5465 7869 6e66 6f2e 2020 2020 2020 2020 Texinfo. │ │ │ │ │ +0004cbc0: 2020 2020 2028 6c69 6e65 2020 3239 290a (line 29). │ │ │ │ │ +0004cbd0: 2a20 5645 5253 494f 4e2c 2070 7265 7665 * VERSION, preve │ │ │ │ │ +0004cbe0: 6e74 2064 6566 696e 6974 696f 6e3a 2020 nt definition: │ │ │ │ │ +0004cbf0: 2020 2020 2020 2020 2050 7562 6c69 6320 Public │ │ │ │ │ +0004cc00: 4d61 6372 6f73 2e20 2020 2020 2020 286c Macros. (l │ │ │ │ │ +0004cc10: 696e 6520 2036 3029 0a2a 2076 6572 7369 ine 60).* versi │ │ │ │ │ +0004cc20: 6f6e 2e6d 342c 2065 7861 6d70 6c65 3a20 on.m4, example: │ │ │ │ │ 0004cc30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004cc40: 2052 6562 7569 6c64 696e 672e 2020 2020 Rebuilding. │ │ │ │ │ -0004cc50: 2020 2020 2020 286c 696e 6520 2031 3929 (line 19) │ │ │ │ │ -0004cc60: 0a2a 2076 6572 7369 6f6e 2e73 682c 2065 .* version.sh, e │ │ │ │ │ -0004cc70: 7861 6d70 6c65 3a20 2020 2020 2020 2020 xample: │ │ │ │ │ -0004cc80: 2020 2020 2020 2020 2020 5265 6275 696c Rebuil │ │ │ │ │ -0004cc90: 6469 6e67 2e20 2020 2020 2020 2020 2028 ding. ( │ │ │ │ │ -0004cca0: 6c69 6e65 2020 3139 290a 2a20 7665 7273 line 19).* vers │ │ │ │ │ -0004ccb0: 696f 6e65 6420 6269 6e61 7269 6573 2c20 ioned binaries, │ │ │ │ │ -0004ccc0: 696e 7374 616c 6c69 6e67 3a20 2020 2020 installing: │ │ │ │ │ -0004ccd0: 2020 2045 7874 656e 6469 6e67 2e20 2020 Extending. │ │ │ │ │ -0004cce0: 2020 2020 2020 2020 286c 696e 6520 2038 (line 8 │ │ │ │ │ -0004ccf0: 3629 0a2a 2056 5041 5448 2062 7569 6c64 6).* VPATH build │ │ │ │ │ -0004cd00: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ │ -0004cd10: 2020 2020 2020 2020 2020 2020 5650 4154 VPAT │ │ │ │ │ -0004cd20: 4820 4275 696c 6473 2e20 2020 2020 2020 H Builds. │ │ │ │ │ -0004cd30: 2028 6c69 6e65 2020 2036 290a 2a20 7769 (line 6).* wi │ │ │ │ │ -0004cd40: 6c64 6361 7264 733a 2020 2020 2020 2020 ldcards: │ │ │ │ │ +0004cc40: 2020 5265 6275 696c 6469 6e67 2e20 2020 Rebuilding. │ │ │ │ │ +0004cc50: 2020 2020 2020 2028 6c69 6e65 2020 3139 (line 19 │ │ │ │ │ +0004cc60: 290a 2a20 7665 7273 696f 6e2e 7368 2c20 ).* version.sh, │ │ │ │ │ +0004cc70: 6578 616d 706c 653a 2020 2020 2020 2020 example: │ │ │ │ │ +0004cc80: 2020 2020 2020 2020 2020 2052 6562 7569 Rebui │ │ │ │ │ +0004cc90: 6c64 696e 672e 2020 2020 2020 2020 2020 lding. │ │ │ │ │ +0004cca0: 286c 696e 6520 2031 3929 0a2a 2076 6572 (line 19).* ver │ │ │ │ │ +0004ccb0: 7369 6f6e 6564 2062 696e 6172 6965 732c sioned binaries, │ │ │ │ │ +0004ccc0: 2069 6e73 7461 6c6c 696e 673a 2020 2020 installing: │ │ │ │ │ +0004ccd0: 2020 2020 4578 7465 6e64 696e 672e 2020 Extending. │ │ │ │ │ +0004cce0: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ +0004ccf0: 3836 290a 2a20 5650 4154 4820 6275 696c 86).* VPATH buil │ │ │ │ │ +0004cd00: 6473 3a20 2020 2020 2020 2020 2020 2020 ds: │ │ │ │ │ +0004cd10: 2020 2020 2020 2020 2020 2020 2056 5041 VPA │ │ │ │ │ +0004cd20: 5448 2042 7569 6c64 732e 2020 2020 2020 TH Builds. │ │ │ │ │ +0004cd30: 2020 286c 696e 6520 2020 3629 0a2a 2077 (line 6).* w │ │ │ │ │ +0004cd40: 696c 6463 6172 6473 3a20 2020 2020 2020 ildcards: │ │ │ │ │ 0004cd50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004cd60: 2020 2020 2057 696c 6463 6172 6473 2e20 Wildcards. │ │ │ │ │ -0004cd70: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -0004cd80: 2020 3629 0a2a 2057 696e 646f 7773 3a20 6).* Windows: │ │ │ │ │ +0004cd60: 2020 2020 2020 5769 6c64 6361 7264 732e Wildcards. │ │ │ │ │ +0004cd70: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +0004cd80: 2020 2036 290a 2a20 5769 6e64 6f77 733a 6).* Windows: │ │ │ │ │ 0004cd90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004cda0: 2020 2020 2020 2020 2020 2020 2020 4558 EX │ │ │ │ │ -0004cdb0: 4545 5854 2e20 2020 2020 2020 2020 2020 EEXT. │ │ │ │ │ -0004cdc0: 2020 2028 6c69 6e65 2020 2036 290a 2a20 (line 6).* │ │ │ │ │ -0004cdd0: 7961 6363 2c20 6d75 6c74 6970 6c65 2070 yacc, multiple p │ │ │ │ │ -0004cde0: 6172 7365 7273 3a20 2020 2020 2020 2020 arsers: │ │ │ │ │ -0004cdf0: 2020 2020 2020 2059 6163 6320 616e 6420 Yacc and │ │ │ │ │ -0004ce00: 4c65 782e 2020 2020 2020 2020 286c 696e Lex. (lin │ │ │ │ │ -0004ce10: 6520 2036 3429 0a2a 2059 464c 4147 5320 e 64).* YFLAGS │ │ │ │ │ -0004ce20: 616e 6420 414d 5f59 464c 4147 533a 2020 and AM_YFLAGS: │ │ │ │ │ +0004cda0: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +0004cdb0: 5845 4558 542e 2020 2020 2020 2020 2020 XEEXT. │ │ │ │ │ +0004cdc0: 2020 2020 286c 696e 6520 2020 3629 0a2a (line 6).* │ │ │ │ │ +0004cdd0: 2079 6163 632c 206d 756c 7469 706c 6520 yacc, multiple │ │ │ │ │ +0004cde0: 7061 7273 6572 733a 2020 2020 2020 2020 parsers: │ │ │ │ │ +0004cdf0: 2020 2020 2020 2020 5961 6363 2061 6e64 Yacc and │ │ │ │ │ +0004ce00: 204c 6578 2e20 2020 2020 2020 2028 6c69 Lex. (li │ │ │ │ │ +0004ce10: 6e65 2020 3634 290a 2a20 5946 4c41 4753 ne 64).* YFLAGS │ │ │ │ │ +0004ce20: 2061 6e64 2041 4d5f 5946 4c41 4753 3a20 and AM_YFLAGS: │ │ │ │ │ 0004ce30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004ce40: 466c 6167 2056 6172 6961 626c 6573 204f Flag Variables O │ │ │ │ │ -0004ce50: 7264 6572 696e 672e 0a20 2020 2020 2020 rdering.. │ │ │ │ │ +0004ce40: 2046 6c61 6720 5661 7269 6162 6c65 7320 Flag Variables │ │ │ │ │ +0004ce50: 4f72 6465 7269 6e67 2e0a 2020 2020 2020 Ordering.. │ │ │ │ │ 0004ce60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004ce70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0004ce80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004ce90: 2020 2020 2020 2028 6c69 6e65 2020 3230 (line 20 │ │ │ │ │ -0004cea0: 290a 2a20 796c 7772 6170 3a20 2020 2020 ).* ylwrap: │ │ │ │ │ +0004ce90: 2020 2020 2020 2020 286c 696e 6520 2032 (line 2 │ │ │ │ │ +0004cea0: 3029 0a2a 2079 6c77 7261 703a 2020 2020 0).* ylwrap: │ │ │ │ │ 0004ceb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004cec0: 2020 2020 2020 2020 2020 2059 6163 6320 Yacc │ │ │ │ │ -0004ced0: 616e 6420 4c65 782e 2020 2020 2020 2020 and Lex. │ │ │ │ │ -0004cee0: 286c 696e 6520 2036 3429 0a2a 207a 6172 (line 64).* zar │ │ │ │ │ -0004cef0: 646f 7a20 6578 616d 706c 653a 2020 2020 doz example: │ │ │ │ │ +0004cec0: 2020 2020 2020 2020 2020 2020 5961 6363 Yacc │ │ │ │ │ +0004ced0: 2061 6e64 204c 6578 2e20 2020 2020 2020 and Lex. │ │ │ │ │ +0004cee0: 2028 6c69 6e65 2020 3634 290a 2a20 7a61 (line 64).* za │ │ │ │ │ +0004cef0: 7264 6f7a 2065 7861 6d70 6c65 3a20 2020 rdoz example: │ │ │ │ │ 0004cf00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0004cf10: 2020 2020 436f 6d70 6c65 7465 2e20 2020 Complete. │ │ │ │ │ -0004cf20: 2020 2020 2020 2020 2028 6c69 6e65 2020 (line │ │ │ │ │ -0004cf30: 3335 290a 0a 35).. │ │ │ │ │ +0004cf10: 2020 2020 2043 6f6d 706c 6574 652e 2020 Complete. │ │ │ │ │ +0004cf20: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +0004cf30: 2033 3529 0a0a 35).. │ │ │ ├── ./usr/share/info/automake-1.11.info.gz │ │ │ │ ├── automake-1.11.info │ │ │ │ │ @@ -2,456 +2,456 @@ │ │ │ │ │ 00000010: 2d31 2e31 312e 696e 666f 2c20 7072 6f64 -1.11.info, prod │ │ │ │ │ 00000020: 7563 6564 2062 7920 6d61 6b65 696e 666f uced by makeinfo │ │ │ │ │ 00000030: 2076 6572 7369 6f6e 2036 2e37 2066 726f version 6.7 fro │ │ │ │ │ 00000040: 6d0a 6175 746f 6d61 6b65 2e74 6578 692e m.automake.texi. │ │ │ │ │ 00000050: 0a0a 5468 6973 206d 616e 7561 6c20 6973 ..This manual is │ │ │ │ │ 00000060: 2066 6f72 2047 4e55 2041 7574 6f6d 616b for GNU Automak │ │ │ │ │ 00000070: 6520 2876 6572 7369 6f6e 2031 2e31 312e e (version 1.11. │ │ │ │ │ -00000080: 362c 2031 3420 4a61 6e75 6172 7920 3230 6, 14 January 20 │ │ │ │ │ -00000090: 3234 292c 2061 0a70 726f 6772 616d 2074 24), a.program t │ │ │ │ │ -000000a0: 6861 7420 6372 6561 7465 7320 474e 5520 hat creates GNU │ │ │ │ │ -000000b0: 7374 616e 6461 7264 732d 636f 6d70 6c69 standards-compli │ │ │ │ │ -000000c0: 616e 7420 4d61 6b65 6669 6c65 7320 6672 ant Makefiles fr │ │ │ │ │ -000000d0: 6f6d 2074 656d 706c 6174 650a 6669 6c65 om template.file │ │ │ │ │ -000000e0: 732e 0a0a 2020 2043 6f70 7972 6967 6874 s... Copyright │ │ │ │ │ -000000f0: 2028 4329 2031 3939 352c 2031 3939 362c (C) 1995, 1996, │ │ │ │ │ -00000100: 2031 3939 372c 2031 3939 382c 2031 3939 1997, 1998, 199 │ │ │ │ │ -00000110: 392c 2032 3030 302c 2032 3030 312c 2032 9, 2000, 2001, 2 │ │ │ │ │ -00000120: 3030 322c 2032 3030 332c 0a32 3030 342c 002, 2003,.2004, │ │ │ │ │ -00000130: 2032 3030 352c 2032 3030 362c 2032 3030 2005, 2006, 200 │ │ │ │ │ -00000140: 372c 2032 3030 382c 2032 3030 392c 2032 7, 2008, 2009, 2 │ │ │ │ │ -00000150: 3031 302c 2032 3031 312c 2032 3031 3220 010, 2011, 2012 │ │ │ │ │ -00000160: 4672 6565 2053 6f66 7477 6172 650a 466f Free Software.Fo │ │ │ │ │ -00000170: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ -00000180: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ -00000190: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ -000001a0: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ -000001b0: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ -000001c0: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ -000001d0: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ -000001e0: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ -000001f0: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ -00000200: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ -00000210: 696f 6e20 312e 3320 6f72 2061 6e79 206c ion 1.3 or any l │ │ │ │ │ -00000220: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ -00000230: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ -00000240: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ -00000250: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ -00000260: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ -00000270: 6563 7469 6f6e 732c 2077 6974 6820 6e6f ections, with no │ │ │ │ │ -00000280: 2046 726f 6e74 2d43 6f76 6572 2074 6578 Front-Cover tex │ │ │ │ │ -00000290: 7473 2c0a 2020 2020 2061 6e64 2077 6974 ts,. and wit │ │ │ │ │ -000002a0: 6820 6e6f 2042 6163 6b2d 436f 7665 7220 h no Back-Cover │ │ │ │ │ -000002b0: 5465 7874 732e 2020 4120 636f 7079 206f Texts. A copy o │ │ │ │ │ -000002c0: 6620 7468 6520 6c69 6365 6e73 6520 6973 f the license is │ │ │ │ │ -000002d0: 2069 6e63 6c75 6465 6420 696e 0a20 2020 included in. │ │ │ │ │ -000002e0: 2020 7468 6520 7365 6374 696f 6e20 656e the section en │ │ │ │ │ -000002f0: 7469 746c 6564 2022 474e 5520 4672 6565 titled "GNU Free │ │ │ │ │ -00000300: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00000310: 6963 656e 7365 2e22 0a0a 494e 464f 2d44 icense."..INFO-D │ │ │ │ │ -00000320: 4952 2d53 4543 5449 4f4e 2053 6f66 7477 IR-SECTION Softw │ │ │ │ │ -00000330: 6172 6520 6465 7665 6c6f 706d 656e 740a are development. │ │ │ │ │ -00000340: 5354 4152 542d 494e 464f 2d44 4952 2d45 START-INFO-DIR-E │ │ │ │ │ -00000350: 4e54 5259 0a2a 2041 7574 6f6d 616b 653a NTRY.* Automake: │ │ │ │ │ -00000360: 2028 6175 746f 6d61 6b65 2d31 2e31 3129 (automake-1.11) │ │ │ │ │ -00000370: 2e20 2020 2020 2020 2020 4d61 6b69 6e67 . Making │ │ │ │ │ -00000380: 2047 4e55 2073 7461 6e64 6172 6473 2d63 GNU standards-c │ │ │ │ │ -00000390: 6f6d 706c 6961 6e74 204d 616b 6566 696c ompliant Makefil │ │ │ │ │ -000003a0: 6573 2e0a 454e 442d 494e 464f 2d44 4952 es..END-INFO-DIR │ │ │ │ │ -000003b0: 2d45 4e54 5259 0a0a 494e 464f 2d44 4952 -ENTRY..INFO-DIR │ │ │ │ │ -000003c0: 2d53 4543 5449 4f4e 2049 6e64 6976 6964 -SECTION Individ │ │ │ │ │ -000003d0: 7561 6c20 7574 696c 6974 6965 730a 5354 ual utilities.ST │ │ │ │ │ -000003e0: 4152 542d 494e 464f 2d44 4952 2d45 4e54 ART-INFO-DIR-ENT │ │ │ │ │ -000003f0: 5259 0a2a 2061 636c 6f63 616c 2d69 6e76 RY.* aclocal-inv │ │ │ │ │ -00000400: 6f63 6174 696f 6e3a 2028 6175 746f 6d61 ocation: (automa │ │ │ │ │ -00000410: 6b65 2d31 2e31 3129 6163 6c6f 6361 6c20 ke-1.11)aclocal │ │ │ │ │ -00000420: 496e 766f 6361 7469 6f6e 2e20 2047 656e Invocation. Gen │ │ │ │ │ -00000430: 6572 6174 696e 6720 6163 6c6f 6361 6c2e erating aclocal. │ │ │ │ │ -00000440: 6d34 2e0a 2a20 6175 746f 6d61 6b65 2d69 m4..* automake-i │ │ │ │ │ -00000450: 6e76 6f63 6174 696f 6e3a 2028 6175 746f nvocation: (auto │ │ │ │ │ -00000460: 6d61 6b65 2d31 2e31 3129 6175 746f 6d61 make-1.11)automa │ │ │ │ │ -00000470: 6b65 2049 6e76 6f63 6174 696f 6e2e 2047 ke Invocation. G │ │ │ │ │ -00000480: 656e 6572 6174 696e 6720 4d61 6b65 6669 enerating Makefi │ │ │ │ │ -00000490: 6c65 2e69 6e2e 0a45 4e44 2d49 4e46 4f2d le.in..END-INFO- │ │ │ │ │ -000004a0: 4449 522d 454e 5452 590a 0a1f 0a49 6e64 DIR-ENTRY....Ind │ │ │ │ │ -000004b0: 6972 6563 743a 0a61 7574 6f6d 616b 652d irect:.automake- │ │ │ │ │ -000004c0: 312e 3131 2e69 6e66 6f2d 313a 2031 3139 1.11.info-1: 119 │ │ │ │ │ -000004d0: 350a 6175 746f 6d61 6b65 2d31 2e31 312e 5.automake-1.11. │ │ │ │ │ -000004e0: 696e 666f 2d32 3a20 3330 3136 3239 0a1f info-2: 301629.. │ │ │ │ │ -000004f0: 0a54 6167 2054 6162 6c65 3a0a 2849 6e64 .Tag Table:.(Ind │ │ │ │ │ -00000500: 6972 6563 7429 0a4e 6f64 653a 2054 6f70 irect).Node: Top │ │ │ │ │ -00000510: 7f31 3139 350a 4e6f 6465 3a20 496e 7472 .1195.Node: Intr │ │ │ │ │ -00000520: 6f64 7563 7469 6f6e 7f31 3434 3933 0a52 oduction.14493.R │ │ │ │ │ -00000530: 6566 3a20 496e 7472 6f64 7563 7469 6f6e ef: Introduction │ │ │ │ │ -00000540: 2d46 6f6f 746e 6f74 652d 317f 3135 3934 -Footnote-1.1594 │ │ │ │ │ -00000550: 320a 5265 663a 2049 6e74 726f 6475 6374 2.Ref: Introduct │ │ │ │ │ -00000560: 696f 6e2d 466f 6f74 6e6f 7465 2d32 7f31 ion-Footnote-2.1 │ │ │ │ │ -00000570: 3630 3931 0a4e 6f64 653a 2041 7574 6f74 6091.Node: Autot │ │ │ │ │ -00000580: 6f6f 6c73 2049 6e74 726f 6475 6374 696f ools Introductio │ │ │ │ │ -00000590: 6e7f 3136 3334 380a 4e6f 6465 3a20 474e n.16348.Node: GN │ │ │ │ │ -000005a0: 5520 4275 696c 6420 5379 7374 656d 7f31 U Build System.1 │ │ │ │ │ -000005b0: 3737 3034 0a4e 6f64 653a 2055 7365 2043 7704.Node: Use C │ │ │ │ │ -000005c0: 6173 6573 7f32 3033 3733 0a4e 6f64 653a ases.20373.Node: │ │ │ │ │ -000005d0: 2042 6173 6963 2049 6e73 7461 6c6c 6174 Basic Installat │ │ │ │ │ -000005e0: 696f 6e7f 3232 3438 330a 4e6f 6465 3a20 ion.22483.Node: │ │ │ │ │ -000005f0: 5374 616e 6461 7264 2054 6172 6765 7473 Standard Targets │ │ │ │ │ -00000600: 7f32 3539 3534 0a4e 6f64 653a 2053 7461 .25954.Node: Sta │ │ │ │ │ -00000610: 6e64 6172 6420 4469 7265 6374 6f72 7920 ndard Directory │ │ │ │ │ -00000620: 5661 7269 6162 6c65 737f 3237 3434 340a Variables.27444. │ │ │ │ │ -00000630: 4e6f 6465 3a20 5374 616e 6461 7264 2043 Node: Standard C │ │ │ │ │ -00000640: 6f6e 6669 6775 7261 7469 6f6e 2056 6172 onfiguration Var │ │ │ │ │ -00000650: 6961 626c 6573 7f32 3931 3930 0a4e 6f64 iables.29190.Nod │ │ │ │ │ -00000660: 653a 2063 6f6e 6669 672e 7369 7465 7f33 e: config.site.3 │ │ │ │ │ -00000670: 3035 3036 0a4e 6f64 653a 2056 5041 5448 0506.Node: VPATH │ │ │ │ │ -00000680: 2042 7569 6c64 737f 3331 3839 330a 4e6f Builds.31893.No │ │ │ │ │ -00000690: 6465 3a20 5477 6f2d 5061 7274 2049 6e73 de: Two-Part Ins │ │ │ │ │ -000006a0: 7461 6c6c 7f33 3537 3832 0a4e 6f64 653a tall.35782.Node: │ │ │ │ │ -000006b0: 2043 726f 7373 2d43 6f6d 7069 6c61 7469 Cross-Compilati │ │ │ │ │ -000006c0: 6f6e 7f33 3831 3931 0a4e 6f64 653a 2052 on.38191.Node: R │ │ │ │ │ -000006d0: 656e 616d 696e 677f 3431 3038 370a 4e6f enaming.41087.No │ │ │ │ │ -000006e0: 6465 3a20 4445 5354 4449 527f 3432 3230 de: DESTDIR.4220 │ │ │ │ │ -000006f0: 380a 4e6f 6465 3a20 5072 6570 6172 696e 8.Node: Preparin │ │ │ │ │ -00000700: 6720 4469 7374 7269 6275 7469 6f6e 737f g Distributions. │ │ │ │ │ -00000710: 3434 3332 350a 4e6f 6465 3a20 4465 7065 44325.Node: Depe │ │ │ │ │ -00000720: 6e64 656e 6379 2054 7261 636b 696e 677f ndency Tracking. │ │ │ │ │ -00000730: 3436 3238 300a 4e6f 6465 3a20 4e65 7374 46280.Node: Nest │ │ │ │ │ -00000740: 6564 2050 6163 6b61 6765 737f 3438 3331 ed Packages.4831 │ │ │ │ │ -00000750: 340a 4e6f 6465 3a20 5768 7920 4175 746f 4.Node: Why Auto │ │ │ │ │ -00000760: 746f 6f6c 737f 3439 3830 390a 4e6f 6465 tools.49809.Node │ │ │ │ │ -00000770: 3a20 4865 6c6c 6f20 576f 726c 647f 3531 : Hello World.51 │ │ │ │ │ -00000780: 3433 340a 5265 663a 2061 6d68 656c 6c6f 434.Ref: amhello │ │ │ │ │ -00000790: 2045 7870 6c61 696e 6564 7f35 3138 3439 Explained.51849 │ │ │ │ │ -000007a0: 0a4e 6f64 653a 2043 7265 6174 696e 6720 .Node: Creating │ │ │ │ │ -000007b0: 616d 6865 6c6c 6f7f 3532 3031 370a 4e6f amhello.52017.No │ │ │ │ │ -000007c0: 6465 3a20 616d 6865 6c6c 6f27 7320 636f de: amhello's co │ │ │ │ │ -000007d0: 6e66 6967 7572 652e 6163 2053 6574 7570 nfigure.ac Setup │ │ │ │ │ -000007e0: 2045 7870 6c61 696e 6564 7f35 3731 3538 Explained.57158 │ │ │ │ │ -000007f0: 0a4e 6f64 653a 2061 6d68 656c 6c6f 2773 .Node: amhello's │ │ │ │ │ -00000800: 204d 616b 6566 696c 652e 616d 2053 6574 Makefile.am Set │ │ │ │ │ -00000810: 7570 2045 7870 6c61 696e 6564 7f36 3138 up Explained.618 │ │ │ │ │ -00000820: 3139 0a4e 6f64 653a 2047 656e 6572 616c 19.Node: General │ │ │ │ │ -00000830: 6974 6965 737f 3635 3331 380a 4e6f 6465 ities.65318.Node │ │ │ │ │ -00000840: 3a20 4765 6e65 7261 6c20 4f70 6572 6174 : General Operat │ │ │ │ │ -00000850: 696f 6e7f 3636 3031 370a 4e6f 6465 3a20 ion.66017.Node: │ │ │ │ │ -00000860: 5374 7269 6374 6e65 7373 7f36 3933 3330 Strictness.69330 │ │ │ │ │ -00000870: 0a4e 6f64 653a 2055 6e69 666f 726d 7f37 .Node: Uniform.7 │ │ │ │ │ -00000880: 3133 3132 0a4e 6f64 653a 204c 656e 6774 1312.Node: Lengt │ │ │ │ │ -00000890: 6820 4c69 6d69 7461 7469 6f6e 737f 3736 h Limitations.76 │ │ │ │ │ -000008a0: 3035 300a 4e6f 6465 3a20 4361 6e6f 6e69 050.Node: Canoni │ │ │ │ │ -000008b0: 6361 6c69 7a61 7469 6f6e 7f37 3833 3331 calization.78331 │ │ │ │ │ -000008c0: 0a4e 6f64 653a 2055 7365 7220 5661 7269 .Node: User Vari │ │ │ │ │ -000008d0: 6162 6c65 737f 3739 3338 300a 4e6f 6465 ables.79380.Node │ │ │ │ │ -000008e0: 3a20 4175 7869 6c69 6172 7920 5072 6f67 : Auxiliary Prog │ │ │ │ │ -000008f0: 7261 6d73 7f38 3038 3330 0a4e 6f64 653a rams.80830.Node: │ │ │ │ │ -00000900: 2045 7861 6d70 6c65 737f 3835 3434 340a Examples.85444. │ │ │ │ │ -00000910: 4e6f 6465 3a20 436f 6d70 6c65 7465 7f38 Node: Complete.8 │ │ │ │ │ -00000920: 3633 3135 0a4e 6f64 653a 2074 7275 657f 6315.Node: true. │ │ │ │ │ -00000930: 3838 3330 370a 4e6f 6465 3a20 6175 746f 88307.Node: auto │ │ │ │ │ -00000940: 6d61 6b65 2049 6e76 6f63 6174 696f 6e7f make Invocation. │ │ │ │ │ -00000950: 3930 3639 320a 5265 663a 2049 6e76 6f6b 90692.Ref: Invok │ │ │ │ │ -00000960: 696e 6720 6175 746f 6d61 6b65 7f39 3038 ing automake.908 │ │ │ │ │ -00000970: 3438 0a4e 6f64 653a 2063 6f6e 6669 6775 48.Node: configu │ │ │ │ │ -00000980: 7265 7f39 3831 3939 0a4e 6f64 653a 2052 re.98199.Node: R │ │ │ │ │ -00000990: 6571 7569 7265 6d65 6e74 737f 3939 3039 equirements.9909 │ │ │ │ │ -000009a0: 390a 4e6f 6465 3a20 4f70 7469 6f6e 616c 9.Node: Optional │ │ │ │ │ -000009b0: 7f31 3034 3037 350a 4e6f 6465 3a20 6163 .104075.Node: ac │ │ │ │ │ -000009c0: 6c6f 6361 6c20 496e 766f 6361 7469 6f6e local Invocation │ │ │ │ │ -000009d0: 7f31 3132 3930 310a 5265 663a 2049 6e76 .112901.Ref: Inv │ │ │ │ │ -000009e0: 6f6b 696e 6720 6163 6c6f 6361 6c7f 3131 oking aclocal.11 │ │ │ │ │ -000009f0: 3330 3637 0a4e 6f64 653a 2061 636c 6f63 3067.Node: acloc │ │ │ │ │ -00000a00: 616c 204f 7074 696f 6e73 7f31 3135 3937 al Options.11597 │ │ │ │ │ -00000a10: 380a 4e6f 6465 3a20 4d61 6372 6f20 5365 8.Node: Macro Se │ │ │ │ │ -00000a20: 6172 6368 2050 6174 687f 3131 3934 3734 arch Path.119474 │ │ │ │ │ -00000a30: 0a52 6566 3a20 4143 4c4f 4341 4c5f 5041 .Ref: ACLOCAL_PA │ │ │ │ │ -00000a40: 5448 7f31 3233 3539 340a 4e6f 6465 3a20 TH.123594.Node: │ │ │ │ │ -00000a50: 4578 7465 6e64 696e 6720 6163 6c6f 6361 Extending acloca │ │ │ │ │ -00000a60: 6c7f 3132 3530 3937 0a4e 6f64 653a 204c l.125097.Node: L │ │ │ │ │ -00000a70: 6f63 616c 204d 6163 726f 737f 3132 3837 ocal Macros.1287 │ │ │ │ │ -00000a80: 3031 0a4e 6f64 653a 2053 6572 6961 6c73 01.Node: Serials │ │ │ │ │ -00000a90: 7f31 3333 3230 380a 4e6f 6465 3a20 4675 .133208.Node: Fu │ │ │ │ │ -00000aa0: 7475 7265 206f 6620 6163 6c6f 6361 6c7f ture of aclocal. │ │ │ │ │ -00000ab0: 3133 3833 3333 0a4e 6f64 653a 204d 6163 138333.Node: Mac │ │ │ │ │ -00000ac0: 726f 737f 3134 3036 3131 0a4e 6f64 653a ros.140611.Node: │ │ │ │ │ -00000ad0: 2050 7562 6c69 6320 4d61 6372 6f73 7f31 Public Macros.1 │ │ │ │ │ -00000ae0: 3431 3134 360a 4e6f 6465 3a20 4f62 736f 41146.Node: Obso │ │ │ │ │ -00000af0: 6c65 7465 204d 6163 726f 737f 3134 3636 lete Macros.1466 │ │ │ │ │ -00000b00: 3030 0a4e 6f64 653a 2050 7269 7661 7465 00.Node: Private │ │ │ │ │ -00000b10: 204d 6163 726f 737f 3134 3939 3038 0a4e Macros.149908.N │ │ │ │ │ -00000b20: 6f64 653a 2044 6972 6563 746f 7269 6573 ode: Directories │ │ │ │ │ -00000b30: 7f31 3531 3331 350a 4e6f 6465 3a20 5375 .151315.Node: Su │ │ │ │ │ -00000b40: 6264 6972 6563 746f 7269 6573 7f31 3532 bdirectories.152 │ │ │ │ │ -00000b50: 3235 390a 4e6f 6465 3a20 436f 6e64 6974 259.Node: Condit │ │ │ │ │ -00000b60: 696f 6e61 6c20 5375 6264 6972 6563 746f ional Subdirecto │ │ │ │ │ -00000b70: 7269 6573 7f31 3534 3536 340a 4e6f 6465 ries.154564.Node │ │ │ │ │ -00000b80: 3a20 5355 4244 4952 5320 7673 2044 4953 : SUBDIRS vs DIS │ │ │ │ │ -00000b90: 545f 5355 4244 4952 537f 3135 3631 3635 T_SUBDIRS.156165 │ │ │ │ │ -00000ba0: 0a4e 6f64 653a 2053 7562 6469 7265 6374 .Node: Subdirect │ │ │ │ │ -00000bb0: 6f72 6965 7320 7769 7468 2041 4d5f 434f ories with AM_CO │ │ │ │ │ -00000bc0: 4e44 4954 494f 4e41 4c7f 3135 3737 3136 NDITIONAL.157716 │ │ │ │ │ -00000bd0: 0a4e 6f64 653a 2053 7562 6469 7265 6374 .Node: Subdirect │ │ │ │ │ -00000be0: 6f72 6965 7320 7769 7468 2041 435f 5355 ories with AC_SU │ │ │ │ │ -00000bf0: 4253 547f 3135 3838 3335 0a4e 6f64 653a BST.158835.Node: │ │ │ │ │ -00000c00: 2055 6e63 6f6e 6669 6775 7265 6420 5375 Unconfigured Su │ │ │ │ │ -00000c10: 6264 6972 6563 746f 7269 6573 7f31 3539 bdirectories.159 │ │ │ │ │ -00000c20: 3633 390a 4e6f 6465 3a20 416c 7465 726e 639.Node: Altern │ │ │ │ │ -00000c30: 6174 6976 657f 3136 3239 3431 0a52 6566 ative.162941.Ref │ │ │ │ │ -00000c40: 3a20 416c 7465 726e 6174 6976 652d 466f : Alternative-Fo │ │ │ │ │ -00000c50: 6f74 6e6f 7465 2d31 7f31 3635 3038 360a otnote-1.165086. │ │ │ │ │ -00000c60: 4e6f 6465 3a20 5375 6270 6163 6b61 6765 Node: Subpackage │ │ │ │ │ -00000c70: 737f 3136 3532 3131 0a4e 6f64 653a 2050 s.165211.Node: P │ │ │ │ │ -00000c80: 726f 6772 616d 737f 3136 3834 3133 0a4e rograms.168413.N │ │ │ │ │ -00000c90: 6f64 653a 2041 2050 726f 6772 616d 7f31 ode: A Program.1 │ │ │ │ │ -00000ca0: 3639 3938 360a 4e6f 6465 3a20 5072 6f67 69986.Node: Prog │ │ │ │ │ -00000cb0: 7261 6d20 536f 7572 6365 737f 3137 3037 ram Sources.1707 │ │ │ │ │ -00000cc0: 3134 0a4e 6f64 653a 204c 696e 6b69 6e67 14.Node: Linking │ │ │ │ │ -00000cd0: 7f31 3732 3533 300a 4e6f 6465 3a20 436f .172530.Node: Co │ │ │ │ │ -00000ce0: 6e64 6974 696f 6e61 6c20 536f 7572 6365 nditional Source │ │ │ │ │ -00000cf0: 737f 3137 3539 3930 0a4e 6f64 653a 2043 s.175990.Node: C │ │ │ │ │ -00000d00: 6f6e 6469 7469 6f6e 616c 2050 726f 6772 onditional Progr │ │ │ │ │ -00000d10: 616d 737f 3137 3838 3131 0a4e 6f64 653a ams.178811.Node: │ │ │ │ │ -00000d20: 2041 204c 6962 7261 7279 7f31 3830 3633 A Library.18063 │ │ │ │ │ -00000d30: 320a 4e6f 6465 3a20 4120 5368 6172 6564 2.Node: A Shared │ │ │ │ │ -00000d40: 204c 6962 7261 7279 7f31 3833 3138 360a Library.183186. │ │ │ │ │ -00000d50: 4e6f 6465 3a20 4c69 6274 6f6f 6c20 436f Node: Libtool Co │ │ │ │ │ -00000d60: 6e63 6570 747f 3138 3431 3933 0a4e 6f64 ncept.184193.Nod │ │ │ │ │ -00000d70: 653a 204c 6962 746f 6f6c 204c 6962 7261 e: Libtool Libra │ │ │ │ │ -00000d80: 7269 6573 7f31 3836 3235 340a 4e6f 6465 ries.186254.Node │ │ │ │ │ -00000d90: 3a20 436f 6e64 6974 696f 6e61 6c20 4c69 : Conditional Li │ │ │ │ │ -00000da0: 6274 6f6f 6c20 4c69 6272 6172 6965 737f btool Libraries. │ │ │ │ │ -00000db0: 3138 3739 3333 0a4e 6f64 653a 2043 6f6e 187933.Node: Con │ │ │ │ │ -00000dc0: 6469 7469 6f6e 616c 204c 6962 746f 6f6c ditional Libtool │ │ │ │ │ -00000dd0: 2053 6f75 7263 6573 7f31 3930 3330 310a Sources.190301. │ │ │ │ │ -00000de0: 4e6f 6465 3a20 4c69 6274 6f6f 6c20 436f Node: Libtool Co │ │ │ │ │ -00000df0: 6e76 656e 6965 6e63 6520 4c69 6272 6172 nvenience Librar │ │ │ │ │ -00000e00: 6965 737f 3139 3136 3435 0a4e 6f64 653a ies.191645.Node: │ │ │ │ │ -00000e10: 204c 6962 746f 6f6c 204d 6f64 756c 6573 Libtool Modules │ │ │ │ │ -00000e20: 7f31 3934 3937 350a 4e6f 6465 3a20 4c69 .194975.Node: Li │ │ │ │ │ -00000e30: 6274 6f6f 6c20 466c 6167 737f 3139 3632 btool Flags.1962 │ │ │ │ │ -00000e40: 3438 0a4e 6f64 653a 204c 544c 4942 4f42 48.Node: LTLIBOB │ │ │ │ │ -00000e50: 4a53 7f31 3938 3033 340a 4e6f 6465 3a20 JS.198034.Node: │ │ │ │ │ -00000e60: 4c69 6274 6f6f 6c20 4973 7375 6573 7f31 Libtool Issues.1 │ │ │ │ │ -00000e70: 3938 3633 300a 4e6f 6465 3a20 4572 726f 98630.Node: Erro │ │ │ │ │ -00000e80: 7220 7265 7175 6972 6564 2066 696c 6520 r required file │ │ │ │ │ -00000e90: 6c74 6d61 696e 2e73 6820 6e6f 7420 666f ltmain.sh not fo │ │ │ │ │ -00000ea0: 756e 647f 3139 3839 3734 0a4e 6f64 653a und.198974.Node: │ │ │ │ │ -00000eb0: 204f 626a 6563 7473 2063 7265 6174 6564 Objects created │ │ │ │ │ -00000ec0: 2062 6f74 6820 7769 7468 206c 6962 746f both with libto │ │ │ │ │ -00000ed0: 6f6c 2061 6e64 2077 6974 686f 7574 7f32 ol and without.2 │ │ │ │ │ -00000ee0: 3030 3134 330a 4e6f 6465 3a20 5072 6f67 00143.Node: Prog │ │ │ │ │ -00000ef0: 7261 6d20 616e 6420 4c69 6272 6172 7920 ram and Library │ │ │ │ │ -00000f00: 5661 7269 6162 6c65 737f 3230 3139 3834 Variables.201984 │ │ │ │ │ -00000f10: 0a52 6566 3a20 5072 6f67 7261 6d20 616e .Ref: Program an │ │ │ │ │ -00000f20: 6420 4c69 6272 6172 7920 5661 7269 6162 d Library Variab │ │ │ │ │ -00000f30: 6c65 732d 466f 6f74 6e6f 7465 2d31 7f32 les-Footnote-1.2 │ │ │ │ │ -00000f40: 3132 3930 390a 4e6f 6465 3a20 4465 6661 12909.Node: Defa │ │ │ │ │ -00000f50: 756c 7420 5f53 4f55 5243 4553 7f32 3132 ult _SOURCES.212 │ │ │ │ │ -00000f60: 3938 340a 4e6f 6465 3a20 4c49 424f 424a 984.Node: LIBOBJ │ │ │ │ │ -00000f70: 537f 3231 3533 3435 0a4e 6f64 653a 2050 S.215345.Node: P │ │ │ │ │ -00000f80: 726f 6772 616d 2056 6172 6961 626c 6573 rogram Variables │ │ │ │ │ -00000f90: 7f32 3230 3332 310a 4e6f 6465 3a20 5961 .220321.Node: Ya │ │ │ │ │ -00000fa0: 6363 2061 6e64 204c 6578 7f32 3233 3738 cc and Lex.22378 │ │ │ │ │ -00000fb0: 380a 5265 663a 2059 6163 6320 616e 6420 8.Ref: Yacc and │ │ │ │ │ -00000fc0: 4c65 782d 466f 6f74 6e6f 7465 2d31 7f32 Lex-Footnote-1.2 │ │ │ │ │ -00000fd0: 3238 3836 300a 4e6f 6465 3a20 432b 2b20 28860.Node: C++ │ │ │ │ │ -00000fe0: 5375 7070 6f72 747f 3232 3930 3838 0a4e Support.229088.N │ │ │ │ │ -00000ff0: 6f64 653a 204f 626a 6563 7469 7665 2043 ode: Objective C │ │ │ │ │ -00001000: 2053 7570 706f 7274 7f32 3239 3933 350a Support.229935. │ │ │ │ │ -00001010: 4e6f 6465 3a20 556e 6966 6965 6420 5061 Node: Unified Pa │ │ │ │ │ -00001020: 7261 6c6c 656c 2043 2053 7570 706f 7274 rallel C Support │ │ │ │ │ -00001030: 7f32 3330 3838 300a 4e6f 6465 3a20 4173 .230880.Node: As │ │ │ │ │ -00001040: 7365 6d62 6c79 2053 7570 706f 7274 7f32 sembly Support.2 │ │ │ │ │ -00001050: 3331 3834 310a 4e6f 6465 3a20 466f 7274 31841.Node: Fort │ │ │ │ │ -00001060: 7261 6e20 3737 2053 7570 706f 7274 7f32 ran 77 Support.2 │ │ │ │ │ -00001070: 3332 3932 360a 5265 663a 2046 6f72 7472 32926.Ref: Fortr │ │ │ │ │ -00001080: 616e 2037 3720 5375 7070 6f72 742d 466f an 77 Support-Fo │ │ │ │ │ -00001090: 6f74 6e6f 7465 2d31 7f32 3334 3536 340a otnote-1.234564. │ │ │ │ │ -000010a0: 4e6f 6465 3a20 5072 6570 726f 6365 7373 Node: Preprocess │ │ │ │ │ -000010b0: 696e 6720 466f 7274 7261 6e20 3737 7f32 ing Fortran 77.2 │ │ │ │ │ -000010c0: 3334 3736 370a 4e6f 6465 3a20 436f 6d70 34767.Node: Comp │ │ │ │ │ -000010d0: 696c 696e 6720 466f 7274 7261 6e20 3737 iling Fortran 77 │ │ │ │ │ -000010e0: 2046 696c 6573 7f32 3335 3334 380a 4e6f Files.235348.No │ │ │ │ │ -000010f0: 6465 3a20 4d69 7869 6e67 2046 6f72 7472 de: Mixing Fortr │ │ │ │ │ -00001100: 616e 2037 3720 5769 7468 2043 2061 6e64 an 77 With C and │ │ │ │ │ -00001110: 2043 2b2b 7f32 3335 3932 350a 5265 663a C++.235925.Ref: │ │ │ │ │ -00001120: 204d 6978 696e 6720 466f 7274 7261 6e20 Mixing Fortran │ │ │ │ │ -00001130: 3737 2057 6974 6820 4320 616e 6420 432b 77 With C and C+ │ │ │ │ │ -00001140: 2b2d 466f 6f74 6e6f 7465 2d31 7f32 3338 +-Footnote-1.238 │ │ │ │ │ -00001150: 3235 330a 4e6f 6465 3a20 486f 7720 7468 253.Node: How th │ │ │ │ │ -00001160: 6520 4c69 6e6b 6572 2069 7320 4368 6f73 e Linker is Chos │ │ │ │ │ -00001170: 656e 7f32 3338 3535 360a 4e6f 6465 3a20 en.238556.Node: │ │ │ │ │ -00001180: 466f 7274 7261 6e20 3978 2053 7570 706f Fortran 9x Suppo │ │ │ │ │ -00001190: 7274 7f32 3430 3030 330a 4e6f 6465 3a20 rt.240003.Node: │ │ │ │ │ -000011a0: 436f 6d70 696c 696e 6720 466f 7274 7261 Compiling Fortra │ │ │ │ │ -000011b0: 6e20 3978 2046 696c 6573 7f32 3431 3031 n 9x Files.24101 │ │ │ │ │ -000011c0: 360a 4e6f 6465 3a20 4a61 7661 2053 7570 6.Node: Java Sup │ │ │ │ │ -000011d0: 706f 7274 2077 6974 6820 6763 6a7f 3234 port with gcj.24 │ │ │ │ │ -000011e0: 3136 3035 0a4e 6f64 653a 2056 616c 6120 1605.Node: Vala │ │ │ │ │ -000011f0: 5375 7070 6f72 747f 3234 3239 3935 0a4e Support.242995.N │ │ │ │ │ -00001200: 6f64 653a 2053 7570 706f 7274 2066 6f72 ode: Support for │ │ │ │ │ -00001210: 204f 7468 6572 204c 616e 6775 6167 6573 Other Languages │ │ │ │ │ -00001220: 7f32 3434 3434 380a 4e6f 6465 3a20 414e .244448.Node: AN │ │ │ │ │ -00001230: 5349 7f32 3435 3130 360a 4e6f 6465 3a20 SI.245106.Node: │ │ │ │ │ -00001240: 4465 7065 6e64 656e 6369 6573 7f32 3438 Dependencies.248 │ │ │ │ │ -00001250: 3034 360a 4e6f 6465 3a20 4558 4545 5854 046.Node: EXEEXT │ │ │ │ │ -00001260: 7f32 3439 3830 390a 4e6f 6465 3a20 4f74 .249809.Node: Ot │ │ │ │ │ -00001270: 6865 7220 4f62 6a65 6374 737f 3235 3232 her Objects.2522 │ │ │ │ │ -00001280: 3739 0a4e 6f64 653a 2053 6372 6970 7473 79.Node: Scripts │ │ │ │ │ -00001290: 7f32 3532 3837 360a 4e6f 6465 3a20 4865 .252876.Node: He │ │ │ │ │ -000012a0: 6164 6572 737f 3235 3536 3230 0a4e 6f64 aders.255620.Nod │ │ │ │ │ -000012b0: 653a 2044 6174 617f 3235 3733 3438 0a4e e: Data.257348.N │ │ │ │ │ -000012c0: 6f64 653a 2053 6f75 7263 6573 7f32 3538 ode: Sources.258 │ │ │ │ │ -000012d0: 3031 300a 4e6f 6465 3a20 4275 696c 7420 010.Node: Built │ │ │ │ │ -000012e0: 536f 7572 6365 7320 4578 616d 706c 657f Sources Example. │ │ │ │ │ -000012f0: 3236 3037 3836 0a4e 6f64 653a 204f 7468 260786.Node: Oth │ │ │ │ │ -00001300: 6572 2047 4e55 2054 6f6f 6c73 7f32 3637 er GNU Tools.267 │ │ │ │ │ -00001310: 3730 310a 4e6f 6465 3a20 456d 6163 7320 701.Node: Emacs │ │ │ │ │ -00001320: 4c69 7370 7f32 3638 3233 310a 4e6f 6465 Lisp.268231.Node │ │ │ │ │ -00001330: 3a20 6765 7474 6578 747f 3237 3030 3630 : gettext.270060 │ │ │ │ │ -00001340: 0a4e 6f64 653a 204c 6962 746f 6f6c 7f32 .Node: Libtool.2 │ │ │ │ │ -00001350: 3730 3731 370a 4e6f 6465 3a20 4a61 7661 70717.Node: Java │ │ │ │ │ -00001360: 7f32 3730 3937 370a 4e6f 6465 3a20 5079 .270977.Node: Py │ │ │ │ │ -00001370: 7468 6f6e 7f32 3733 3339 310a 4e6f 6465 thon.273391.Node │ │ │ │ │ -00001380: 3a20 446f 6375 6d65 6e74 6174 696f 6e7f : Documentation. │ │ │ │ │ -00001390: 3237 3832 3436 0a4e 6f64 653a 2054 6578 278246.Node: Tex │ │ │ │ │ -000013a0: 696e 666f 7f32 3738 3535 350a 4e6f 6465 info.278555.Node │ │ │ │ │ -000013b0: 3a20 4d61 6e20 5061 6765 737f 3238 3439 : Man Pages.2849 │ │ │ │ │ -000013c0: 3438 0a4e 6f64 653a 2049 6e73 7461 6c6c 48.Node: Install │ │ │ │ │ -000013d0: 7f32 3837 3935 380a 4e6f 6465 3a20 4261 .287958.Node: Ba │ │ │ │ │ -000013e0: 7369 6373 206f 6620 496e 7374 616c 6c61 sics of Installa │ │ │ │ │ -000013f0: 7469 6f6e 7f32 3838 3636 330a 4e6f 6465 tion.288663.Node │ │ │ │ │ -00001400: 3a20 5468 6520 5477 6f20 5061 7274 7320 : The Two Parts │ │ │ │ │ -00001410: 6f66 2049 6e73 7461 6c6c 7f32 3930 3135 of Install.29015 │ │ │ │ │ -00001420: 380a 4e6f 6465 3a20 4578 7465 6e64 696e 8.Node: Extendin │ │ │ │ │ -00001430: 6720 496e 7374 616c 6c61 7469 6f6e 7f32 g Installation.2 │ │ │ │ │ -00001440: 3931 3538 320a 4e6f 6465 3a20 5374 6167 91582.Node: Stag │ │ │ │ │ -00001450: 6564 2049 6e73 7461 6c6c 737f 3239 3233 ed Installs.2923 │ │ │ │ │ -00001460: 3331 0a4e 6f64 653a 2049 6e73 7461 6c6c 31.Node: Install │ │ │ │ │ -00001470: 2052 756c 6573 2066 6f72 2074 6865 2055 Rules for the U │ │ │ │ │ -00001480: 7365 727f 3239 3336 3835 0a4e 6f64 653a ser.293685.Node: │ │ │ │ │ -00001490: 2043 6c65 616e 7f32 3934 3231 360a 4e6f Clean.294216.No │ │ │ │ │ -000014a0: 6465 3a20 4469 7374 7f32 3936 3239 370a de: Dist.296297. │ │ │ │ │ -000014b0: 4e6f 6465 3a20 4261 7369 6373 206f 6620 Node: Basics of │ │ │ │ │ -000014c0: 4469 7374 7269 6275 7469 6f6e 7f32 3936 Distribution.296 │ │ │ │ │ -000014d0: 3739 340a 4e6f 6465 3a20 4669 6e65 2d67 794.Node: Fine-g │ │ │ │ │ -000014e0: 7261 696e 6564 2044 6973 7472 6962 7574 rained Distribut │ │ │ │ │ -000014f0: 696f 6e20 436f 6e74 726f 6c7f 3239 3935 ion Control.2995 │ │ │ │ │ -00001500: 3232 0a4e 6f64 653a 2054 6865 2064 6973 22.Node: The dis │ │ │ │ │ -00001510: 7420 486f 6f6b 7f33 3031 3632 390a 4e6f t Hook.301629.No │ │ │ │ │ -00001520: 6465 3a20 4368 6563 6b69 6e67 2074 6865 de: Checking the │ │ │ │ │ -00001530: 2044 6973 7472 6962 7574 696f 6e7f 3330 Distribution.30 │ │ │ │ │ -00001540: 3334 3632 0a4e 6f64 653a 2054 6865 2054 3462.Node: The T │ │ │ │ │ -00001550: 7970 6573 206f 6620 4469 7374 7269 6275 ypes of Distribu │ │ │ │ │ -00001560: 7469 6f6e 737f 3330 3832 3737 0a4e 6f64 tions.308277.Nod │ │ │ │ │ -00001570: 653a 2054 6573 7473 7f33 3130 3234 340a e: Tests.310244. │ │ │ │ │ -00001580: 4e6f 6465 3a20 5369 6d70 6c65 2054 6573 Node: Simple Tes │ │ │ │ │ -00001590: 7473 7f33 3130 3736 360a 4e6f 6465 3a20 ts.310766.Node: │ │ │ │ │ -000015a0: 5369 6d70 6c65 2054 6573 7473 2075 7369 Simple Tests usi │ │ │ │ │ -000015b0: 6e67 2070 6172 616c 6c65 6c2d 7465 7374 ng parallel-test │ │ │ │ │ -000015c0: 737f 3331 3433 3133 0a4e 6f64 653a 2044 s.314313.Node: D │ │ │ │ │ -000015d0: 656a 6147 6e75 2054 6573 7473 7f33 3233 ejaGnu Tests.323 │ │ │ │ │ -000015e0: 3430 310a 4e6f 6465 3a20 496e 7374 616c 401.Node: Instal │ │ │ │ │ -000015f0: 6c20 5465 7374 737f 3332 3534 3935 0a4e l Tests.325495.N │ │ │ │ │ -00001600: 6f64 653a 2052 6562 7569 6c64 696e 677f ode: Rebuilding. │ │ │ │ │ -00001610: 3332 3538 3032 0a4e 6f64 653a 204f 7074 325802.Node: Opt │ │ │ │ │ -00001620: 696f 6e73 7f33 3239 3432 330a 5265 663a ions.329423.Ref: │ │ │ │ │ -00001630: 2074 6172 2d66 6f72 6d61 7473 7f33 3336 tar-formats.336 │ │ │ │ │ -00001640: 3531 320a 4e6f 6465 3a20 4d69 7363 656c 512.Node: Miscel │ │ │ │ │ -00001650: 6c61 6e65 6f75 737f 3333 3937 3539 0a4e laneous.339759.N │ │ │ │ │ -00001660: 6f64 653a 2054 6167 737f 3334 3031 3339 ode: Tags.340139 │ │ │ │ │ -00001670: 0a4e 6f64 653a 2053 7566 6669 7865 737f .Node: Suffixes. │ │ │ │ │ -00001680: 3334 3234 3335 0a4e 6f64 653a 204d 756c 342435.Node: Mul │ │ │ │ │ -00001690: 7469 6c69 6273 7f33 3434 3033 300a 4e6f tilibs.344030.No │ │ │ │ │ -000016a0: 6465 3a20 496e 636c 7564 657f 3334 3439 de: Include.3449 │ │ │ │ │ -000016b0: 3039 0a4e 6f64 653a 2043 6f6e 6469 7469 09.Node: Conditi │ │ │ │ │ -000016c0: 6f6e 616c 737f 3334 3538 3034 0a4e 6f64 onals.345804.Nod │ │ │ │ │ -000016d0: 653a 2055 7361 6765 206f 6620 436f 6e64 e: Usage of Cond │ │ │ │ │ -000016e0: 6974 696f 6e61 6c73 7f33 3436 3634 300a itionals.346640. │ │ │ │ │ -000016f0: 4e6f 6465 3a20 4c69 6d69 7473 206f 6620 Node: Limits of │ │ │ │ │ -00001700: 436f 6e64 6974 696f 6e61 6c73 7f33 3439 Conditionals.349 │ │ │ │ │ -00001710: 3837 330a 4e6f 6465 3a20 5369 6c65 6e63 873.Node: Silenc │ │ │ │ │ -00001720: 696e 6720 4d61 6b65 7f33 3531 3035 390a ing Make.351059. │ │ │ │ │ -00001730: 4e6f 6465 3a20 4d61 6b65 2076 6572 626f Node: Make verbo │ │ │ │ │ -00001740: 7369 7479 7f33 3531 3431 340a 5265 663a sity.351414.Ref: │ │ │ │ │ -00001750: 204d 616b 6520 7665 7262 6f73 6974 792d Make verbosity- │ │ │ │ │ -00001760: 466f 6f74 6e6f 7465 2d31 7f33 3532 3731 Footnote-1.35271 │ │ │ │ │ -00001770: 390a 4e6f 6465 3a20 5472 6963 6b73 2046 9.Node: Tricks F │ │ │ │ │ -00001780: 6f72 2053 696c 656e 6369 6e67 204d 616b or Silencing Mak │ │ │ │ │ -00001790: 657f 3335 3237 3933 0a4e 6f64 653a 2041 e.352793.Node: A │ │ │ │ │ -000017a0: 7574 6f6d 616b 6520 7369 6c65 6e74 2d72 utomake silent-r │ │ │ │ │ -000017b0: 756c 6573 204f 7074 696f 6e7f 3335 3531 ules Option.3551 │ │ │ │ │ -000017c0: 3937 0a4e 6f64 653a 2047 6e69 7473 7f33 97.Node: Gnits.3 │ │ │ │ │ -000017d0: 3632 3137 320a 4e6f 6465 3a20 4379 676e 62172.Node: Cygn │ │ │ │ │ -000017e0: 7573 7f33 3634 3438 320a 4e6f 6465 3a20 us.364482.Node: │ │ │ │ │ -000017f0: 4e6f 7420 456e 6f75 6768 7f33 3636 3435 Not Enough.36645 │ │ │ │ │ -00001800: 350a 4e6f 6465 3a20 4578 7465 6e64 696e 5.Node: Extendin │ │ │ │ │ -00001810: 677f 3336 3638 3938 0a4e 6f64 653a 2054 g.366898.Node: T │ │ │ │ │ -00001820: 6869 7264 2d50 6172 7479 204d 616b 6566 hird-Party Makef │ │ │ │ │ -00001830: 696c 6573 7f33 3731 3633 340a 4e6f 6465 iles.371634.Node │ │ │ │ │ -00001840: 3a20 4469 7374 7269 6275 7469 6e67 7f33 : Distributing.3 │ │ │ │ │ -00001850: 3738 3232 360a 4e6f 6465 3a20 4150 4920 78226.Node: API │ │ │ │ │ -00001860: 5665 7273 696f 6e69 6e67 7f33 3738 3836 Versioning.37886 │ │ │ │ │ -00001870: 380a 4e6f 6465 3a20 5570 6772 6164 696e 8.Node: Upgradin │ │ │ │ │ -00001880: 677f 3338 3135 3132 0a4e 6f64 653a 2046 g.381512.Node: F │ │ │ │ │ -00001890: 4151 7f33 3833 3436 360a 4e6f 6465 3a20 AQ.383466.Node: │ │ │ │ │ -000018a0: 4356 537f 3338 3435 3739 0a4e 6f64 653a CVS.384579.Node: │ │ │ │ │ -000018b0: 206d 6169 6e74 6169 6e65 722d 6d6f 6465 maintainer-mode │ │ │ │ │ -000018c0: 7f33 3931 3330 350a 4e6f 6465 3a20 5769 .391305.Node: Wi │ │ │ │ │ -000018d0: 6c64 6361 7264 737f 3339 3532 3336 0a4e ldcards.395236.N │ │ │ │ │ -000018e0: 6f64 653a 204c 696d 6974 6174 696f 6e73 ode: Limitations │ │ │ │ │ -000018f0: 206f 6e20 4669 6c65 204e 616d 6573 7f33 on File Names.3 │ │ │ │ │ -00001900: 3938 3531 360a 4e6f 6465 3a20 6469 7374 98516.Node: dist │ │ │ │ │ -00001910: 636c 6561 6e63 6865 636b 7f34 3031 3039 cleancheck.40109 │ │ │ │ │ -00001920: 300a 4e6f 6465 3a20 466c 6167 2056 6172 0.Node: Flag Var │ │ │ │ │ -00001930: 6961 626c 6573 204f 7264 6572 696e 677f iables Ordering. │ │ │ │ │ -00001940: 3430 3538 3834 0a4e 6f64 653a 2052 656e 405884.Node: Ren │ │ │ │ │ -00001950: 616d 6564 204f 626a 6563 7473 7f34 3133 amed Objects.413 │ │ │ │ │ -00001960: 3537 300a 4e6f 6465 3a20 5065 722d 4f62 570.Node: Per-Ob │ │ │ │ │ -00001970: 6a65 6374 2046 6c61 6773 7f34 3135 3131 ject Flags.41511 │ │ │ │ │ -00001980: 380a 4e6f 6465 3a20 4d75 6c74 6970 6c65 8.Node: Multiple │ │ │ │ │ -00001990: 204f 7574 7075 7473 7f34 3138 3032 300a Outputs.418020. │ │ │ │ │ -000019a0: 4e6f 6465 3a20 4861 7264 2d43 6f64 6564 Node: Hard-Coded │ │ │ │ │ -000019b0: 2049 6e73 7461 6c6c 2050 6174 6873 7f34 Install Paths.4 │ │ │ │ │ -000019c0: 3239 3631 380a 4e6f 6465 3a20 4465 6275 29618.Node: Debu │ │ │ │ │ -000019d0: 6767 696e 6720 4d61 6b65 2052 756c 6573 gging Make Rules │ │ │ │ │ -000019e0: 7f34 3334 3633 370a 5265 663a 2044 6562 .434637.Ref: Deb │ │ │ │ │ -000019f0: 7567 6769 6e67 204d 616b 6520 5275 6c65 ugging Make Rule │ │ │ │ │ -00001a00: 732d 466f 6f74 6e6f 7465 2d31 7f34 3336 s-Footnote-1.436 │ │ │ │ │ -00001a10: 3730 310a 4e6f 6465 3a20 5265 706f 7274 701.Node: Report │ │ │ │ │ -00001a20: 696e 6720 4275 6773 7f34 3336 3836 350a ing Bugs.436865. │ │ │ │ │ -00001a30: 4e6f 6465 3a20 4869 7374 6f72 797f 3433 Node: History.43 │ │ │ │ │ -00001a40: 3838 3039 0a4e 6f64 653a 2054 696d 656c 8809.Node: Timel │ │ │ │ │ -00001a50: 696e 657f 3433 3933 3739 0a4e 6f64 653a ine.439379.Node: │ │ │ │ │ -00001a60: 2044 6570 656e 6465 6e63 7920 5472 6163 Dependency Trac │ │ │ │ │ -00001a70: 6b69 6e67 2045 766f 6c75 7469 6f6e 7f34 king Evolution.4 │ │ │ │ │ -00001a80: 3730 3730 330a 4e6f 6465 3a20 4669 7273 70703.Node: Firs │ │ │ │ │ -00001a90: 7420 5461 6b65 206f 6e20 4465 7065 6e64 t Take on Depend │ │ │ │ │ -00001aa0: 656e 6369 6573 7f34 3731 3636 390a 4e6f encies.471669.No │ │ │ │ │ -00001ab0: 6465 3a20 4465 7065 6e64 656e 6369 6573 de: Dependencies │ │ │ │ │ -00001ac0: 2041 7320 5369 6465 2045 6666 6563 7473 As Side Effects │ │ │ │ │ -00001ad0: 7f34 3734 3333 300a 4e6f 6465 3a20 4465 .474330.Node: De │ │ │ │ │ -00001ae0: 7065 6e64 656e 6369 6573 2066 6f72 2074 pendencies for t │ │ │ │ │ -00001af0: 6865 2055 7365 727f 3437 3633 3932 0a4e he User.476392.N │ │ │ │ │ -00001b00: 6f64 653a 2054 6563 686e 6971 7565 7320 ode: Techniques │ │ │ │ │ -00001b10: 666f 7220 4465 7065 6e64 656e 6369 6573 for Dependencies │ │ │ │ │ -00001b20: 7f34 3831 3430 320a 4e6f 6465 3a20 5265 .481402.Node: Re │ │ │ │ │ -00001b30: 636f 6d6d 656e 6461 7469 6f6e 7320 666f commendations fo │ │ │ │ │ -00001b40: 7220 546f 6f6c 2057 7269 7465 7273 7f34 r Tool Writers.4 │ │ │ │ │ -00001b50: 3833 3035 380a 4e6f 6465 3a20 4675 7475 83058.Node: Futu │ │ │ │ │ -00001b60: 7265 2044 6972 6563 7469 6f6e 7320 666f re Directions fo │ │ │ │ │ -00001b70: 7220 4465 7065 6e64 656e 6369 6573 7f34 r Dependencies.4 │ │ │ │ │ -00001b80: 3833 3831 340a 4e6f 6465 3a20 5265 6c65 83814.Node: Rele │ │ │ │ │ -00001b90: 6173 6573 7f34 3834 3238 350a 4e6f 6465 ases.484285.Node │ │ │ │ │ -00001ba0: 3a20 436f 7079 696e 6720 5468 6973 204d : Copying This M │ │ │ │ │ -00001bb0: 616e 7561 6c7f 3438 3939 3734 0a4e 6f64 anual.489974.Nod │ │ │ │ │ -00001bc0: 653a 2047 4e55 2046 7265 6520 446f 6375 e: GNU Free Docu │ │ │ │ │ -00001bd0: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ │ -00001be0: 657f 3439 3032 3133 0a4e 6f64 653a 2049 e.490213.Node: I │ │ │ │ │ -00001bf0: 6e64 6963 6573 7f35 3135 3333 340a 4e6f ndices.515334.No │ │ │ │ │ -00001c00: 6465 3a20 4d61 6372 6f20 496e 6465 787f de: Macro Index. │ │ │ │ │ -00001c10: 3531 3536 3238 0a4e 6f64 653a 2056 6172 515628.Node: Var │ │ │ │ │ -00001c20: 6961 626c 6520 496e 6465 787f 3532 3137 iable Index.5217 │ │ │ │ │ -00001c30: 3833 0a4e 6f64 653a 2047 656e 6572 616c 83.Node: General │ │ │ │ │ -00001c40: 2049 6e64 6578 7f35 3530 3834 370a 1f0a Index.550847... │ │ │ │ │ -00001c50: 456e 6420 5461 6720 5461 626c 650a 0a1f End Tag Table... │ │ │ │ │ -00001c60: 0a4c 6f63 616c 2056 6172 6961 626c 6573 .Local Variables │ │ │ │ │ -00001c70: 3a0a 636f 6469 6e67 3a20 7574 662d 380a :.coding: utf-8. │ │ │ │ │ -00001c80: 456e 643a 0a End:. │ │ │ │ │ +00000080: 362c 2031 3620 4665 6272 7561 7279 2032 6, 16 February 2 │ │ │ │ │ +00000090: 3032 3529 2c20 610a 7072 6f67 7261 6d20 025), a.program │ │ │ │ │ +000000a0: 7468 6174 2063 7265 6174 6573 2047 4e55 that creates GNU │ │ │ │ │ +000000b0: 2073 7461 6e64 6172 6473 2d63 6f6d 706c standards-compl │ │ │ │ │ +000000c0: 6961 6e74 204d 616b 6566 696c 6573 2066 iant Makefiles f │ │ │ │ │ +000000d0: 726f 6d20 7465 6d70 6c61 7465 0a66 696c rom template.fil │ │ │ │ │ +000000e0: 6573 2e0a 0a20 2020 436f 7079 7269 6768 es... Copyrigh │ │ │ │ │ +000000f0: 7420 2843 2920 3139 3935 2c20 3139 3936 t (C) 1995, 1996 │ │ │ │ │ +00000100: 2c20 3139 3937 2c20 3139 3938 2c20 3139 , 1997, 1998, 19 │ │ │ │ │ +00000110: 3939 2c20 3230 3030 2c20 3230 3031 2c20 99, 2000, 2001, │ │ │ │ │ +00000120: 3230 3032 2c20 3230 3033 2c0a 3230 3034 2002, 2003,.2004 │ │ │ │ │ +00000130: 2c20 3230 3035 2c20 3230 3036 2c20 3230 , 2005, 2006, 20 │ │ │ │ │ +00000140: 3037 2c20 3230 3038 2c20 3230 3039 2c20 07, 2008, 2009, │ │ │ │ │ +00000150: 3230 3130 2c20 3230 3131 2c20 3230 3132 2010, 2011, 2012 │ │ │ │ │ +00000160: 2046 7265 6520 536f 6674 7761 7265 0a46 Free Software.F │ │ │ │ │ +00000170: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ +00000180: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ +00000190: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ +000001a0: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ +000001b0: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ +000001c0: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ +000001d0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ +000001e0: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ +000001f0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ +00000200: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ +00000210: 7369 6f6e 2031 2e33 206f 7220 616e 7920 sion 1.3 or any │ │ │ │ │ +00000220: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ +00000230: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ +00000240: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ +00000250: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ +00000260: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ +00000270: 5365 6374 696f 6e73 2c20 7769 7468 206e Sections, with n │ │ │ │ │ +00000280: 6f20 4672 6f6e 742d 436f 7665 7220 7465 o Front-Cover te │ │ │ │ │ +00000290: 7874 732c 0a20 2020 2020 616e 6420 7769 xts,. and wi │ │ │ │ │ +000002a0: 7468 206e 6f20 4261 636b 2d43 6f76 6572 th no Back-Cover │ │ │ │ │ +000002b0: 2054 6578 7473 2e20 2041 2063 6f70 7920 Texts. A copy │ │ │ │ │ +000002c0: 6f66 2074 6865 206c 6963 656e 7365 2069 of the license i │ │ │ │ │ +000002d0: 7320 696e 636c 7564 6564 2069 6e0a 2020 s included in. │ │ │ │ │ +000002e0: 2020 2074 6865 2073 6563 7469 6f6e 2065 the section e │ │ │ │ │ +000002f0: 6e74 6974 6c65 6420 2247 4e55 2046 7265 ntitled "GNU Fre │ │ │ │ │ +00000300: 6520 446f 6375 6d65 6e74 6174 696f 6e20 e Documentation │ │ │ │ │ +00000310: 4c69 6365 6e73 652e 220a 0a49 4e46 4f2d License."..INFO- │ │ │ │ │ +00000320: 4449 522d 5345 4354 494f 4e20 536f 6674 DIR-SECTION Soft │ │ │ │ │ +00000330: 7761 7265 2064 6576 656c 6f70 6d65 6e74 ware development │ │ │ │ │ +00000340: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000350: 454e 5452 590a 2a20 4175 746f 6d61 6b65 ENTRY.* Automake │ │ │ │ │ +00000360: 3a20 2861 7574 6f6d 616b 652d 312e 3131 : (automake-1.11 │ │ │ │ │ +00000370: 292e 2020 2020 2020 2020 204d 616b 696e ). Makin │ │ │ │ │ +00000380: 6720 474e 5520 7374 616e 6461 7264 732d g GNU standards- │ │ │ │ │ +00000390: 636f 6d70 6c69 616e 7420 4d61 6b65 6669 compliant Makefi │ │ │ │ │ +000003a0: 6c65 732e 0a45 4e44 2d49 4e46 4f2d 4449 les..END-INFO-DI │ │ │ │ │ +000003b0: 522d 454e 5452 590a 0a49 4e46 4f2d 4449 R-ENTRY..INFO-DI │ │ │ │ │ +000003c0: 522d 5345 4354 494f 4e20 496e 6469 7669 R-SECTION Indivi │ │ │ │ │ +000003d0: 6475 616c 2075 7469 6c69 7469 6573 0a53 dual utilities.S │ │ │ │ │ +000003e0: 5441 5254 2d49 4e46 4f2d 4449 522d 454e TART-INFO-DIR-EN │ │ │ │ │ +000003f0: 5452 590a 2a20 6163 6c6f 6361 6c2d 696e TRY.* aclocal-in │ │ │ │ │ +00000400: 766f 6361 7469 6f6e 3a20 2861 7574 6f6d vocation: (autom │ │ │ │ │ +00000410: 616b 652d 312e 3131 2961 636c 6f63 616c ake-1.11)aclocal │ │ │ │ │ +00000420: 2049 6e76 6f63 6174 696f 6e2e 2020 4765 Invocation. Ge │ │ │ │ │ +00000430: 6e65 7261 7469 6e67 2061 636c 6f63 616c nerating aclocal │ │ │ │ │ +00000440: 2e6d 342e 0a2a 2061 7574 6f6d 616b 652d .m4..* automake- │ │ │ │ │ +00000450: 696e 766f 6361 7469 6f6e 3a20 2861 7574 invocation: (aut │ │ │ │ │ +00000460: 6f6d 616b 652d 312e 3131 2961 7574 6f6d omake-1.11)autom │ │ │ │ │ +00000470: 616b 6520 496e 766f 6361 7469 6f6e 2e20 ake Invocation. │ │ │ │ │ +00000480: 4765 6e65 7261 7469 6e67 204d 616b 6566 Generating Makef │ │ │ │ │ +00000490: 696c 652e 696e 2e0a 454e 442d 494e 464f ile.in..END-INFO │ │ │ │ │ +000004a0: 2d44 4952 2d45 4e54 5259 0a0a 1f0a 496e -DIR-ENTRY....In │ │ │ │ │ +000004b0: 6469 7265 6374 3a0a 6175 746f 6d61 6b65 direct:.automake │ │ │ │ │ +000004c0: 2d31 2e31 312e 696e 666f 2d31 3a20 3131 -1.11.info-1: 11 │ │ │ │ │ +000004d0: 3936 0a61 7574 6f6d 616b 652d 312e 3131 96.automake-1.11 │ │ │ │ │ +000004e0: 2e69 6e66 6f2d 323a 2033 3031 3633 320a .info-2: 301632. │ │ │ │ │ +000004f0: 1f0a 5461 6720 5461 626c 653a 0a28 496e ..Tag Table:.(In │ │ │ │ │ +00000500: 6469 7265 6374 290a 4e6f 6465 3a20 546f direct).Node: To │ │ │ │ │ +00000510: 707f 3131 3936 0a4e 6f64 653a 2049 6e74 p.1196.Node: Int │ │ │ │ │ +00000520: 726f 6475 6374 696f 6e7f 3134 3439 350a roduction.14495. │ │ │ │ │ +00000530: 5265 663a 2049 6e74 726f 6475 6374 696f Ref: Introductio │ │ │ │ │ +00000540: 6e2d 466f 6f74 6e6f 7465 2d31 7f31 3539 n-Footnote-1.159 │ │ │ │ │ +00000550: 3434 0a52 6566 3a20 496e 7472 6f64 7563 44.Ref: Introduc │ │ │ │ │ +00000560: 7469 6f6e 2d46 6f6f 746e 6f74 652d 327f tion-Footnote-2. │ │ │ │ │ +00000570: 3136 3039 330a 4e6f 6465 3a20 4175 746f 16093.Node: Auto │ │ │ │ │ +00000580: 746f 6f6c 7320 496e 7472 6f64 7563 7469 tools Introducti │ │ │ │ │ +00000590: 6f6e 7f31 3633 3530 0a4e 6f64 653a 2047 on.16350.Node: G │ │ │ │ │ +000005a0: 4e55 2042 7569 6c64 2053 7973 7465 6d7f NU Build System. │ │ │ │ │ +000005b0: 3137 3730 360a 4e6f 6465 3a20 5573 6520 17706.Node: Use │ │ │ │ │ +000005c0: 4361 7365 737f 3230 3337 350a 4e6f 6465 Cases.20375.Node │ │ │ │ │ +000005d0: 3a20 4261 7369 6320 496e 7374 616c 6c61 : Basic Installa │ │ │ │ │ +000005e0: 7469 6f6e 7f32 3234 3835 0a4e 6f64 653a tion.22485.Node: │ │ │ │ │ +000005f0: 2053 7461 6e64 6172 6420 5461 7267 6574 Standard Target │ │ │ │ │ +00000600: 737f 3235 3935 360a 4e6f 6465 3a20 5374 s.25956.Node: St │ │ │ │ │ +00000610: 616e 6461 7264 2044 6972 6563 746f 7279 andard Directory │ │ │ │ │ +00000620: 2056 6172 6961 626c 6573 7f32 3734 3436 Variables.27446 │ │ │ │ │ +00000630: 0a4e 6f64 653a 2053 7461 6e64 6172 6420 .Node: Standard │ │ │ │ │ +00000640: 436f 6e66 6967 7572 6174 696f 6e20 5661 Configuration Va │ │ │ │ │ +00000650: 7269 6162 6c65 737f 3239 3139 320a 4e6f riables.29192.No │ │ │ │ │ +00000660: 6465 3a20 636f 6e66 6967 2e73 6974 657f de: config.site. │ │ │ │ │ +00000670: 3330 3530 380a 4e6f 6465 3a20 5650 4154 30508.Node: VPAT │ │ │ │ │ +00000680: 4820 4275 696c 6473 7f33 3138 3935 0a4e H Builds.31895.N │ │ │ │ │ +00000690: 6f64 653a 2054 776f 2d50 6172 7420 496e ode: Two-Part In │ │ │ │ │ +000006a0: 7374 616c 6c7f 3335 3738 340a 4e6f 6465 stall.35784.Node │ │ │ │ │ +000006b0: 3a20 4372 6f73 732d 436f 6d70 696c 6174 : Cross-Compilat │ │ │ │ │ +000006c0: 696f 6e7f 3338 3139 330a 4e6f 6465 3a20 ion.38193.Node: │ │ │ │ │ +000006d0: 5265 6e61 6d69 6e67 7f34 3130 3839 0a4e Renaming.41089.N │ │ │ │ │ +000006e0: 6f64 653a 2044 4553 5444 4952 7f34 3232 ode: DESTDIR.422 │ │ │ │ │ +000006f0: 3130 0a4e 6f64 653a 2050 7265 7061 7269 10.Node: Prepari │ │ │ │ │ +00000700: 6e67 2044 6973 7472 6962 7574 696f 6e73 ng Distributions │ │ │ │ │ +00000710: 7f34 3433 3237 0a4e 6f64 653a 2044 6570 .44327.Node: Dep │ │ │ │ │ +00000720: 656e 6465 6e63 7920 5472 6163 6b69 6e67 endency Tracking │ │ │ │ │ +00000730: 7f34 3632 3832 0a4e 6f64 653a 204e 6573 .46282.Node: Nes │ │ │ │ │ +00000740: 7465 6420 5061 636b 6167 6573 7f34 3833 ted Packages.483 │ │ │ │ │ +00000750: 3136 0a4e 6f64 653a 2057 6879 2041 7574 16.Node: Why Aut │ │ │ │ │ +00000760: 6f74 6f6f 6c73 7f34 3938 3131 0a4e 6f64 otools.49811.Nod │ │ │ │ │ +00000770: 653a 2048 656c 6c6f 2057 6f72 6c64 7f35 e: Hello World.5 │ │ │ │ │ +00000780: 3134 3336 0a52 6566 3a20 616d 6865 6c6c 1436.Ref: amhell │ │ │ │ │ +00000790: 6f20 4578 706c 6169 6e65 647f 3531 3835 o Explained.5185 │ │ │ │ │ +000007a0: 310a 4e6f 6465 3a20 4372 6561 7469 6e67 1.Node: Creating │ │ │ │ │ +000007b0: 2061 6d68 656c 6c6f 7f35 3230 3139 0a4e amhello.52019.N │ │ │ │ │ +000007c0: 6f64 653a 2061 6d68 656c 6c6f 2773 2063 ode: amhello's c │ │ │ │ │ +000007d0: 6f6e 6669 6775 7265 2e61 6320 5365 7475 onfigure.ac Setu │ │ │ │ │ +000007e0: 7020 4578 706c 6169 6e65 647f 3537 3136 p Explained.5716 │ │ │ │ │ +000007f0: 300a 4e6f 6465 3a20 616d 6865 6c6c 6f27 0.Node: amhello' │ │ │ │ │ +00000800: 7320 4d61 6b65 6669 6c65 2e61 6d20 5365 s Makefile.am Se │ │ │ │ │ +00000810: 7475 7020 4578 706c 6169 6e65 647f 3631 tup Explained.61 │ │ │ │ │ +00000820: 3832 310a 4e6f 6465 3a20 4765 6e65 7261 821.Node: Genera │ │ │ │ │ +00000830: 6c69 7469 6573 7f36 3533 3230 0a4e 6f64 lities.65320.Nod │ │ │ │ │ +00000840: 653a 2047 656e 6572 616c 204f 7065 7261 e: General Opera │ │ │ │ │ +00000850: 7469 6f6e 7f36 3630 3139 0a4e 6f64 653a tion.66019.Node: │ │ │ │ │ +00000860: 2053 7472 6963 746e 6573 737f 3639 3333 Strictness.6933 │ │ │ │ │ +00000870: 320a 4e6f 6465 3a20 556e 6966 6f72 6d7f 2.Node: Uniform. │ │ │ │ │ +00000880: 3731 3331 340a 4e6f 6465 3a20 4c65 6e67 71314.Node: Leng │ │ │ │ │ +00000890: 7468 204c 696d 6974 6174 696f 6e73 7f37 th Limitations.7 │ │ │ │ │ +000008a0: 3630 3532 0a4e 6f64 653a 2043 616e 6f6e 6052.Node: Canon │ │ │ │ │ +000008b0: 6963 616c 697a 6174 696f 6e7f 3738 3333 icalization.7833 │ │ │ │ │ +000008c0: 330a 4e6f 6465 3a20 5573 6572 2056 6172 3.Node: User Var │ │ │ │ │ +000008d0: 6961 626c 6573 7f37 3933 3832 0a4e 6f64 iables.79382.Nod │ │ │ │ │ +000008e0: 653a 2041 7578 696c 6961 7279 2050 726f e: Auxiliary Pro │ │ │ │ │ +000008f0: 6772 616d 737f 3830 3833 320a 4e6f 6465 grams.80832.Node │ │ │ │ │ +00000900: 3a20 4578 616d 706c 6573 7f38 3534 3436 : Examples.85446 │ │ │ │ │ +00000910: 0a4e 6f64 653a 2043 6f6d 706c 6574 657f .Node: Complete. │ │ │ │ │ +00000920: 3836 3331 370a 4e6f 6465 3a20 7472 7565 86317.Node: true │ │ │ │ │ +00000930: 7f38 3833 3039 0a4e 6f64 653a 2061 7574 .88309.Node: aut │ │ │ │ │ +00000940: 6f6d 616b 6520 496e 766f 6361 7469 6f6e omake Invocation │ │ │ │ │ +00000950: 7f39 3036 3934 0a52 6566 3a20 496e 766f .90694.Ref: Invo │ │ │ │ │ +00000960: 6b69 6e67 2061 7574 6f6d 616b 657f 3930 king automake.90 │ │ │ │ │ +00000970: 3835 300a 4e6f 6465 3a20 636f 6e66 6967 850.Node: config │ │ │ │ │ +00000980: 7572 657f 3938 3230 310a 4e6f 6465 3a20 ure.98201.Node: │ │ │ │ │ +00000990: 5265 7175 6972 656d 656e 7473 7f39 3931 Requirements.991 │ │ │ │ │ +000009a0: 3031 0a4e 6f64 653a 204f 7074 696f 6e61 01.Node: Optiona │ │ │ │ │ +000009b0: 6c7f 3130 3430 3737 0a4e 6f64 653a 2061 l.104077.Node: a │ │ │ │ │ +000009c0: 636c 6f63 616c 2049 6e76 6f63 6174 696f clocal Invocatio │ │ │ │ │ +000009d0: 6e7f 3131 3239 3033 0a52 6566 3a20 496e n.112903.Ref: In │ │ │ │ │ +000009e0: 766f 6b69 6e67 2061 636c 6f63 616c 7f31 voking aclocal.1 │ │ │ │ │ +000009f0: 3133 3036 390a 4e6f 6465 3a20 6163 6c6f 13069.Node: aclo │ │ │ │ │ +00000a00: 6361 6c20 4f70 7469 6f6e 737f 3131 3539 cal Options.1159 │ │ │ │ │ +00000a10: 3830 0a4e 6f64 653a 204d 6163 726f 2053 80.Node: Macro S │ │ │ │ │ +00000a20: 6561 7263 6820 5061 7468 7f31 3139 3437 earch Path.11947 │ │ │ │ │ +00000a30: 360a 5265 663a 2041 434c 4f43 414c 5f50 6.Ref: ACLOCAL_P │ │ │ │ │ +00000a40: 4154 487f 3132 3335 3936 0a4e 6f64 653a ATH.123596.Node: │ │ │ │ │ +00000a50: 2045 7874 656e 6469 6e67 2061 636c 6f63 Extending acloc │ │ │ │ │ +00000a60: 616c 7f31 3235 3039 390a 4e6f 6465 3a20 al.125099.Node: │ │ │ │ │ +00000a70: 4c6f 6361 6c20 4d61 6372 6f73 7f31 3238 Local Macros.128 │ │ │ │ │ +00000a80: 3730 330a 4e6f 6465 3a20 5365 7269 616c 703.Node: Serial │ │ │ │ │ +00000a90: 737f 3133 3332 3130 0a4e 6f64 653a 2046 s.133210.Node: F │ │ │ │ │ +00000aa0: 7574 7572 6520 6f66 2061 636c 6f63 616c uture of aclocal │ │ │ │ │ +00000ab0: 7f31 3338 3333 350a 4e6f 6465 3a20 4d61 .138335.Node: Ma │ │ │ │ │ +00000ac0: 6372 6f73 7f31 3430 3631 330a 4e6f 6465 cros.140613.Node │ │ │ │ │ +00000ad0: 3a20 5075 626c 6963 204d 6163 726f 737f : Public Macros. │ │ │ │ │ +00000ae0: 3134 3131 3438 0a4e 6f64 653a 204f 6273 141148.Node: Obs │ │ │ │ │ +00000af0: 6f6c 6574 6520 4d61 6372 6f73 7f31 3436 olete Macros.146 │ │ │ │ │ +00000b00: 3630 320a 4e6f 6465 3a20 5072 6976 6174 602.Node: Privat │ │ │ │ │ +00000b10: 6520 4d61 6372 6f73 7f31 3439 3931 300a e Macros.149910. │ │ │ │ │ +00000b20: 4e6f 6465 3a20 4469 7265 6374 6f72 6965 Node: Directorie │ │ │ │ │ +00000b30: 737f 3135 3133 3137 0a4e 6f64 653a 2053 s.151317.Node: S │ │ │ │ │ +00000b40: 7562 6469 7265 6374 6f72 6965 737f 3135 ubdirectories.15 │ │ │ │ │ +00000b50: 3232 3631 0a4e 6f64 653a 2043 6f6e 6469 2261.Node: Condi │ │ │ │ │ +00000b60: 7469 6f6e 616c 2053 7562 6469 7265 6374 tional Subdirect │ │ │ │ │ +00000b70: 6f72 6965 737f 3135 3435 3636 0a4e 6f64 ories.154566.Nod │ │ │ │ │ +00000b80: 653a 2053 5542 4449 5253 2076 7320 4449 e: SUBDIRS vs DI │ │ │ │ │ +00000b90: 5354 5f53 5542 4449 5253 7f31 3536 3136 ST_SUBDIRS.15616 │ │ │ │ │ +00000ba0: 370a 4e6f 6465 3a20 5375 6264 6972 6563 7.Node: Subdirec │ │ │ │ │ +00000bb0: 746f 7269 6573 2077 6974 6820 414d 5f43 tories with AM_C │ │ │ │ │ +00000bc0: 4f4e 4449 5449 4f4e 414c 7f31 3537 3731 ONDITIONAL.15771 │ │ │ │ │ +00000bd0: 380a 4e6f 6465 3a20 5375 6264 6972 6563 8.Node: Subdirec │ │ │ │ │ +00000be0: 746f 7269 6573 2077 6974 6820 4143 5f53 tories with AC_S │ │ │ │ │ +00000bf0: 5542 5354 7f31 3538 3833 370a 4e6f 6465 UBST.158837.Node │ │ │ │ │ +00000c00: 3a20 556e 636f 6e66 6967 7572 6564 2053 : Unconfigured S │ │ │ │ │ +00000c10: 7562 6469 7265 6374 6f72 6965 737f 3135 ubdirectories.15 │ │ │ │ │ +00000c20: 3936 3431 0a4e 6f64 653a 2041 6c74 6572 9641.Node: Alter │ │ │ │ │ +00000c30: 6e61 7469 7665 7f31 3632 3934 330a 5265 native.162943.Re │ │ │ │ │ +00000c40: 663a 2041 6c74 6572 6e61 7469 7665 2d46 f: Alternative-F │ │ │ │ │ +00000c50: 6f6f 746e 6f74 652d 317f 3136 3530 3838 ootnote-1.165088 │ │ │ │ │ +00000c60: 0a4e 6f64 653a 2053 7562 7061 636b 6167 .Node: Subpackag │ │ │ │ │ +00000c70: 6573 7f31 3635 3231 330a 4e6f 6465 3a20 es.165213.Node: │ │ │ │ │ +00000c80: 5072 6f67 7261 6d73 7f31 3638 3431 350a Programs.168415. │ │ │ │ │ +00000c90: 4e6f 6465 3a20 4120 5072 6f67 7261 6d7f Node: A Program. │ │ │ │ │ +00000ca0: 3136 3939 3838 0a4e 6f64 653a 2050 726f 169988.Node: Pro │ │ │ │ │ +00000cb0: 6772 616d 2053 6f75 7263 6573 7f31 3730 gram Sources.170 │ │ │ │ │ +00000cc0: 3731 360a 4e6f 6465 3a20 4c69 6e6b 696e 716.Node: Linkin │ │ │ │ │ +00000cd0: 677f 3137 3235 3332 0a4e 6f64 653a 2043 g.172532.Node: C │ │ │ │ │ +00000ce0: 6f6e 6469 7469 6f6e 616c 2053 6f75 7263 onditional Sourc │ │ │ │ │ +00000cf0: 6573 7f31 3735 3939 320a 4e6f 6465 3a20 es.175992.Node: │ │ │ │ │ +00000d00: 436f 6e64 6974 696f 6e61 6c20 5072 6f67 Conditional Prog │ │ │ │ │ +00000d10: 7261 6d73 7f31 3738 3831 330a 4e6f 6465 rams.178813.Node │ │ │ │ │ +00000d20: 3a20 4120 4c69 6272 6172 797f 3138 3036 : A Library.1806 │ │ │ │ │ +00000d30: 3334 0a4e 6f64 653a 2041 2053 6861 7265 34.Node: A Share │ │ │ │ │ +00000d40: 6420 4c69 6272 6172 797f 3138 3331 3838 d Library.183188 │ │ │ │ │ +00000d50: 0a4e 6f64 653a 204c 6962 746f 6f6c 2043 .Node: Libtool C │ │ │ │ │ +00000d60: 6f6e 6365 7074 7f31 3834 3139 350a 4e6f oncept.184195.No │ │ │ │ │ +00000d70: 6465 3a20 4c69 6274 6f6f 6c20 4c69 6272 de: Libtool Libr │ │ │ │ │ +00000d80: 6172 6965 737f 3138 3632 3536 0a4e 6f64 aries.186256.Nod │ │ │ │ │ +00000d90: 653a 2043 6f6e 6469 7469 6f6e 616c 204c e: Conditional L │ │ │ │ │ +00000da0: 6962 746f 6f6c 204c 6962 7261 7269 6573 ibtool Libraries │ │ │ │ │ +00000db0: 7f31 3837 3933 350a 4e6f 6465 3a20 436f .187935.Node: Co │ │ │ │ │ +00000dc0: 6e64 6974 696f 6e61 6c20 4c69 6274 6f6f nditional Libtoo │ │ │ │ │ +00000dd0: 6c20 536f 7572 6365 737f 3139 3033 3033 l Sources.190303 │ │ │ │ │ +00000de0: 0a4e 6f64 653a 204c 6962 746f 6f6c 2043 .Node: Libtool C │ │ │ │ │ +00000df0: 6f6e 7665 6e69 656e 6365 204c 6962 7261 onvenience Libra │ │ │ │ │ +00000e00: 7269 6573 7f31 3931 3634 370a 4e6f 6465 ries.191647.Node │ │ │ │ │ +00000e10: 3a20 4c69 6274 6f6f 6c20 4d6f 6475 6c65 : Libtool Module │ │ │ │ │ +00000e20: 737f 3139 3439 3737 0a4e 6f64 653a 204c s.194977.Node: L │ │ │ │ │ +00000e30: 6962 746f 6f6c 2046 6c61 6773 7f31 3936 ibtool Flags.196 │ │ │ │ │ +00000e40: 3235 300a 4e6f 6465 3a20 4c54 4c49 424f 250.Node: LTLIBO │ │ │ │ │ +00000e50: 424a 537f 3139 3830 3336 0a4e 6f64 653a BJS.198036.Node: │ │ │ │ │ +00000e60: 204c 6962 746f 6f6c 2049 7373 7565 737f Libtool Issues. │ │ │ │ │ +00000e70: 3139 3836 3332 0a4e 6f64 653a 2045 7272 198632.Node: Err │ │ │ │ │ +00000e80: 6f72 2072 6571 7569 7265 6420 6669 6c65 or required file │ │ │ │ │ +00000e90: 206c 746d 6169 6e2e 7368 206e 6f74 2066 ltmain.sh not f │ │ │ │ │ +00000ea0: 6f75 6e64 7f31 3938 3937 360a 4e6f 6465 ound.198976.Node │ │ │ │ │ +00000eb0: 3a20 4f62 6a65 6374 7320 6372 6561 7465 : Objects create │ │ │ │ │ +00000ec0: 6420 626f 7468 2077 6974 6820 6c69 6274 d both with libt │ │ │ │ │ +00000ed0: 6f6f 6c20 616e 6420 7769 7468 6f75 747f ool and without. │ │ │ │ │ +00000ee0: 3230 3031 3435 0a4e 6f64 653a 2050 726f 200145.Node: Pro │ │ │ │ │ +00000ef0: 6772 616d 2061 6e64 204c 6962 7261 7279 gram and Library │ │ │ │ │ +00000f00: 2056 6172 6961 626c 6573 7f32 3031 3938 Variables.20198 │ │ │ │ │ +00000f10: 360a 5265 663a 2050 726f 6772 616d 2061 6.Ref: Program a │ │ │ │ │ +00000f20: 6e64 204c 6962 7261 7279 2056 6172 6961 nd Library Varia │ │ │ │ │ +00000f30: 626c 6573 2d46 6f6f 746e 6f74 652d 317f bles-Footnote-1. │ │ │ │ │ +00000f40: 3231 3239 3131 0a4e 6f64 653a 2044 6566 212911.Node: Def │ │ │ │ │ +00000f50: 6175 6c74 205f 534f 5552 4345 537f 3231 ault _SOURCES.21 │ │ │ │ │ +00000f60: 3239 3836 0a4e 6f64 653a 204c 4942 4f42 2986.Node: LIBOB │ │ │ │ │ +00000f70: 4a53 7f32 3135 3334 370a 4e6f 6465 3a20 JS.215347.Node: │ │ │ │ │ +00000f80: 5072 6f67 7261 6d20 5661 7269 6162 6c65 Program Variable │ │ │ │ │ +00000f90: 737f 3232 3033 3233 0a4e 6f64 653a 2059 s.220323.Node: Y │ │ │ │ │ +00000fa0: 6163 6320 616e 6420 4c65 787f 3232 3337 acc and Lex.2237 │ │ │ │ │ +00000fb0: 3930 0a52 6566 3a20 5961 6363 2061 6e64 90.Ref: Yacc and │ │ │ │ │ +00000fc0: 204c 6578 2d46 6f6f 746e 6f74 652d 317f Lex-Footnote-1. │ │ │ │ │ +00000fd0: 3232 3838 3632 0a4e 6f64 653a 2043 2b2b 228862.Node: C++ │ │ │ │ │ +00000fe0: 2053 7570 706f 7274 7f32 3239 3039 300a Support.229090. │ │ │ │ │ +00000ff0: 4e6f 6465 3a20 4f62 6a65 6374 6976 6520 Node: Objective │ │ │ │ │ +00001000: 4320 5375 7070 6f72 747f 3232 3939 3337 C Support.229937 │ │ │ │ │ +00001010: 0a4e 6f64 653a 2055 6e69 6669 6564 2050 .Node: Unified P │ │ │ │ │ +00001020: 6172 616c 6c65 6c20 4320 5375 7070 6f72 arallel C Suppor │ │ │ │ │ +00001030: 747f 3233 3038 3832 0a4e 6f64 653a 2041 t.230882.Node: A │ │ │ │ │ +00001040: 7373 656d 626c 7920 5375 7070 6f72 747f ssembly Support. │ │ │ │ │ +00001050: 3233 3138 3433 0a4e 6f64 653a 2046 6f72 231843.Node: For │ │ │ │ │ +00001060: 7472 616e 2037 3720 5375 7070 6f72 747f tran 77 Support. │ │ │ │ │ +00001070: 3233 3239 3238 0a52 6566 3a20 466f 7274 232928.Ref: Fort │ │ │ │ │ +00001080: 7261 6e20 3737 2053 7570 706f 7274 2d46 ran 77 Support-F │ │ │ │ │ +00001090: 6f6f 746e 6f74 652d 317f 3233 3435 3636 ootnote-1.234566 │ │ │ │ │ +000010a0: 0a4e 6f64 653a 2050 7265 7072 6f63 6573 .Node: Preproces │ │ │ │ │ +000010b0: 7369 6e67 2046 6f72 7472 616e 2037 377f sing Fortran 77. │ │ │ │ │ +000010c0: 3233 3437 3639 0a4e 6f64 653a 2043 6f6d 234769.Node: Com │ │ │ │ │ +000010d0: 7069 6c69 6e67 2046 6f72 7472 616e 2037 piling Fortran 7 │ │ │ │ │ +000010e0: 3720 4669 6c65 737f 3233 3533 3530 0a4e 7 Files.235350.N │ │ │ │ │ +000010f0: 6f64 653a 204d 6978 696e 6720 466f 7274 ode: Mixing Fort │ │ │ │ │ +00001100: 7261 6e20 3737 2057 6974 6820 4320 616e ran 77 With C an │ │ │ │ │ +00001110: 6420 432b 2b7f 3233 3539 3237 0a52 6566 d C++.235927.Ref │ │ │ │ │ +00001120: 3a20 4d69 7869 6e67 2046 6f72 7472 616e : Mixing Fortran │ │ │ │ │ +00001130: 2037 3720 5769 7468 2043 2061 6e64 2043 77 With C and C │ │ │ │ │ +00001140: 2b2b 2d46 6f6f 746e 6f74 652d 317f 3233 ++-Footnote-1.23 │ │ │ │ │ +00001150: 3832 3535 0a4e 6f64 653a 2048 6f77 2074 8255.Node: How t │ │ │ │ │ +00001160: 6865 204c 696e 6b65 7220 6973 2043 686f he Linker is Cho │ │ │ │ │ +00001170: 7365 6e7f 3233 3835 3538 0a4e 6f64 653a sen.238558.Node: │ │ │ │ │ +00001180: 2046 6f72 7472 616e 2039 7820 5375 7070 Fortran 9x Supp │ │ │ │ │ +00001190: 6f72 747f 3234 3030 3035 0a4e 6f64 653a ort.240005.Node: │ │ │ │ │ +000011a0: 2043 6f6d 7069 6c69 6e67 2046 6f72 7472 Compiling Fortr │ │ │ │ │ +000011b0: 616e 2039 7820 4669 6c65 737f 3234 3130 an 9x Files.2410 │ │ │ │ │ +000011c0: 3138 0a4e 6f64 653a 204a 6176 6120 5375 18.Node: Java Su │ │ │ │ │ +000011d0: 7070 6f72 7420 7769 7468 2067 636a 7f32 pport with gcj.2 │ │ │ │ │ +000011e0: 3431 3630 370a 4e6f 6465 3a20 5661 6c61 41607.Node: Vala │ │ │ │ │ +000011f0: 2053 7570 706f 7274 7f32 3432 3939 370a Support.242997. │ │ │ │ │ +00001200: 4e6f 6465 3a20 5375 7070 6f72 7420 666f Node: Support fo │ │ │ │ │ +00001210: 7220 4f74 6865 7220 4c61 6e67 7561 6765 r Other Language │ │ │ │ │ +00001220: 737f 3234 3434 3530 0a4e 6f64 653a 2041 s.244450.Node: A │ │ │ │ │ +00001230: 4e53 497f 3234 3531 3038 0a4e 6f64 653a NSI.245108.Node: │ │ │ │ │ +00001240: 2044 6570 656e 6465 6e63 6965 737f 3234 Dependencies.24 │ │ │ │ │ +00001250: 3830 3438 0a4e 6f64 653a 2045 5845 4558 8048.Node: EXEEX │ │ │ │ │ +00001260: 547f 3234 3938 3131 0a4e 6f64 653a 204f T.249811.Node: O │ │ │ │ │ +00001270: 7468 6572 204f 626a 6563 7473 7f32 3532 ther Objects.252 │ │ │ │ │ +00001280: 3238 310a 4e6f 6465 3a20 5363 7269 7074 281.Node: Script │ │ │ │ │ +00001290: 737f 3235 3238 3738 0a4e 6f64 653a 2048 s.252878.Node: H │ │ │ │ │ +000012a0: 6561 6465 7273 7f32 3535 3632 320a 4e6f eaders.255622.No │ │ │ │ │ +000012b0: 6465 3a20 4461 7461 7f32 3537 3335 300a de: Data.257350. │ │ │ │ │ +000012c0: 4e6f 6465 3a20 536f 7572 6365 737f 3235 Node: Sources.25 │ │ │ │ │ +000012d0: 3830 3132 0a4e 6f64 653a 2042 7569 6c74 8012.Node: Built │ │ │ │ │ +000012e0: 2053 6f75 7263 6573 2045 7861 6d70 6c65 Sources Example │ │ │ │ │ +000012f0: 7f32 3630 3738 380a 4e6f 6465 3a20 4f74 .260788.Node: Ot │ │ │ │ │ +00001300: 6865 7220 474e 5520 546f 6f6c 737f 3236 her GNU Tools.26 │ │ │ │ │ +00001310: 3737 3033 0a4e 6f64 653a 2045 6d61 6373 7703.Node: Emacs │ │ │ │ │ +00001320: 204c 6973 707f 3236 3832 3333 0a4e 6f64 Lisp.268233.Nod │ │ │ │ │ +00001330: 653a 2067 6574 7465 7874 7f32 3730 3036 e: gettext.27006 │ │ │ │ │ +00001340: 320a 4e6f 6465 3a20 4c69 6274 6f6f 6c7f 2.Node: Libtool. │ │ │ │ │ +00001350: 3237 3037 3139 0a4e 6f64 653a 204a 6176 270719.Node: Jav │ │ │ │ │ +00001360: 617f 3237 3039 3739 0a4e 6f64 653a 2050 a.270979.Node: P │ │ │ │ │ +00001370: 7974 686f 6e7f 3237 3333 3933 0a4e 6f64 ython.273393.Nod │ │ │ │ │ +00001380: 653a 2044 6f63 756d 656e 7461 7469 6f6e e: Documentation │ │ │ │ │ +00001390: 7f32 3738 3234 380a 4e6f 6465 3a20 5465 .278248.Node: Te │ │ │ │ │ +000013a0: 7869 6e66 6f7f 3237 3835 3537 0a4e 6f64 xinfo.278557.Nod │ │ │ │ │ +000013b0: 653a 204d 616e 2050 6167 6573 7f32 3834 e: Man Pages.284 │ │ │ │ │ +000013c0: 3935 300a 4e6f 6465 3a20 496e 7374 616c 950.Node: Instal │ │ │ │ │ +000013d0: 6c7f 3238 3739 3630 0a4e 6f64 653a 2042 l.287960.Node: B │ │ │ │ │ +000013e0: 6173 6963 7320 6f66 2049 6e73 7461 6c6c asics of Install │ │ │ │ │ +000013f0: 6174 696f 6e7f 3238 3836 3635 0a4e 6f64 ation.288665.Nod │ │ │ │ │ +00001400: 653a 2054 6865 2054 776f 2050 6172 7473 e: The Two Parts │ │ │ │ │ +00001410: 206f 6620 496e 7374 616c 6c7f 3239 3031 of Install.2901 │ │ │ │ │ +00001420: 3630 0a4e 6f64 653a 2045 7874 656e 6469 60.Node: Extendi │ │ │ │ │ +00001430: 6e67 2049 6e73 7461 6c6c 6174 696f 6e7f ng Installation. │ │ │ │ │ +00001440: 3239 3135 3834 0a4e 6f64 653a 2053 7461 291584.Node: Sta │ │ │ │ │ +00001450: 6765 6420 496e 7374 616c 6c73 7f32 3932 ged Installs.292 │ │ │ │ │ +00001460: 3333 330a 4e6f 6465 3a20 496e 7374 616c 333.Node: Instal │ │ │ │ │ +00001470: 6c20 5275 6c65 7320 666f 7220 7468 6520 l Rules for the │ │ │ │ │ +00001480: 5573 6572 7f32 3933 3638 370a 4e6f 6465 User.293687.Node │ │ │ │ │ +00001490: 3a20 436c 6561 6e7f 3239 3432 3138 0a4e : Clean.294218.N │ │ │ │ │ +000014a0: 6f64 653a 2044 6973 747f 3239 3632 3939 ode: Dist.296299 │ │ │ │ │ +000014b0: 0a4e 6f64 653a 2042 6173 6963 7320 6f66 .Node: Basics of │ │ │ │ │ +000014c0: 2044 6973 7472 6962 7574 696f 6e7f 3239 Distribution.29 │ │ │ │ │ +000014d0: 3637 3936 0a4e 6f64 653a 2046 696e 652d 6796.Node: Fine- │ │ │ │ │ +000014e0: 6772 6169 6e65 6420 4469 7374 7269 6275 grained Distribu │ │ │ │ │ +000014f0: 7469 6f6e 2043 6f6e 7472 6f6c 7f32 3939 tion Control.299 │ │ │ │ │ +00001500: 3532 340a 4e6f 6465 3a20 5468 6520 6469 524.Node: The di │ │ │ │ │ +00001510: 7374 2048 6f6f 6b7f 3330 3136 3332 0a4e st Hook.301632.N │ │ │ │ │ +00001520: 6f64 653a 2043 6865 636b 696e 6720 7468 ode: Checking th │ │ │ │ │ +00001530: 6520 4469 7374 7269 6275 7469 6f6e 7f33 e Distribution.3 │ │ │ │ │ +00001540: 3033 3436 350a 4e6f 6465 3a20 5468 6520 03465.Node: The │ │ │ │ │ +00001550: 5479 7065 7320 6f66 2044 6973 7472 6962 Types of Distrib │ │ │ │ │ +00001560: 7574 696f 6e73 7f33 3038 3238 300a 4e6f utions.308280.No │ │ │ │ │ +00001570: 6465 3a20 5465 7374 737f 3331 3032 3437 de: Tests.310247 │ │ │ │ │ +00001580: 0a4e 6f64 653a 2053 696d 706c 6520 5465 .Node: Simple Te │ │ │ │ │ +00001590: 7374 737f 3331 3037 3639 0a4e 6f64 653a sts.310769.Node: │ │ │ │ │ +000015a0: 2053 696d 706c 6520 5465 7374 7320 7573 Simple Tests us │ │ │ │ │ +000015b0: 696e 6720 7061 7261 6c6c 656c 2d74 6573 ing parallel-tes │ │ │ │ │ +000015c0: 7473 7f33 3134 3331 360a 4e6f 6465 3a20 ts.314316.Node: │ │ │ │ │ +000015d0: 4465 6a61 476e 7520 5465 7374 737f 3332 DejaGnu Tests.32 │ │ │ │ │ +000015e0: 3334 3034 0a4e 6f64 653a 2049 6e73 7461 3404.Node: Insta │ │ │ │ │ +000015f0: 6c6c 2054 6573 7473 7f33 3235 3439 380a ll Tests.325498. │ │ │ │ │ +00001600: 4e6f 6465 3a20 5265 6275 696c 6469 6e67 Node: Rebuilding │ │ │ │ │ +00001610: 7f33 3235 3830 350a 4e6f 6465 3a20 4f70 .325805.Node: Op │ │ │ │ │ +00001620: 7469 6f6e 737f 3332 3934 3236 0a52 6566 tions.329426.Ref │ │ │ │ │ +00001630: 3a20 7461 722d 666f 726d 6174 737f 3333 : tar-formats.33 │ │ │ │ │ +00001640: 3635 3135 0a4e 6f64 653a 204d 6973 6365 6515.Node: Misce │ │ │ │ │ +00001650: 6c6c 616e 656f 7573 7f33 3339 3736 320a llaneous.339762. │ │ │ │ │ +00001660: 4e6f 6465 3a20 5461 6773 7f33 3430 3134 Node: Tags.34014 │ │ │ │ │ +00001670: 320a 4e6f 6465 3a20 5375 6666 6978 6573 2.Node: Suffixes │ │ │ │ │ +00001680: 7f33 3432 3433 380a 4e6f 6465 3a20 4d75 .342438.Node: Mu │ │ │ │ │ +00001690: 6c74 696c 6962 737f 3334 3430 3333 0a4e ltilibs.344033.N │ │ │ │ │ +000016a0: 6f64 653a 2049 6e63 6c75 6465 7f33 3434 ode: Include.344 │ │ │ │ │ +000016b0: 3931 320a 4e6f 6465 3a20 436f 6e64 6974 912.Node: Condit │ │ │ │ │ +000016c0: 696f 6e61 6c73 7f33 3435 3830 370a 4e6f ionals.345807.No │ │ │ │ │ +000016d0: 6465 3a20 5573 6167 6520 6f66 2043 6f6e de: Usage of Con │ │ │ │ │ +000016e0: 6469 7469 6f6e 616c 737f 3334 3636 3433 ditionals.346643 │ │ │ │ │ +000016f0: 0a4e 6f64 653a 204c 696d 6974 7320 6f66 .Node: Limits of │ │ │ │ │ +00001700: 2043 6f6e 6469 7469 6f6e 616c 737f 3334 Conditionals.34 │ │ │ │ │ +00001710: 3938 3736 0a4e 6f64 653a 2053 696c 656e 9876.Node: Silen │ │ │ │ │ +00001720: 6369 6e67 204d 616b 657f 3335 3130 3632 cing Make.351062 │ │ │ │ │ +00001730: 0a4e 6f64 653a 204d 616b 6520 7665 7262 .Node: Make verb │ │ │ │ │ +00001740: 6f73 6974 797f 3335 3134 3137 0a52 6566 osity.351417.Ref │ │ │ │ │ +00001750: 3a20 4d61 6b65 2076 6572 626f 7369 7479 : Make verbosity │ │ │ │ │ +00001760: 2d46 6f6f 746e 6f74 652d 317f 3335 3237 -Footnote-1.3527 │ │ │ │ │ +00001770: 3232 0a4e 6f64 653a 2054 7269 636b 7320 22.Node: Tricks │ │ │ │ │ +00001780: 466f 7220 5369 6c65 6e63 696e 6720 4d61 For Silencing Ma │ │ │ │ │ +00001790: 6b65 7f33 3532 3739 360a 4e6f 6465 3a20 ke.352796.Node: │ │ │ │ │ +000017a0: 4175 746f 6d61 6b65 2073 696c 656e 742d Automake silent- │ │ │ │ │ +000017b0: 7275 6c65 7320 4f70 7469 6f6e 7f33 3535 rules Option.355 │ │ │ │ │ +000017c0: 3230 300a 4e6f 6465 3a20 476e 6974 737f 200.Node: Gnits. │ │ │ │ │ +000017d0: 3336 3231 3735 0a4e 6f64 653a 2043 7967 362175.Node: Cyg │ │ │ │ │ +000017e0: 6e75 737f 3336 3434 3835 0a4e 6f64 653a nus.364485.Node: │ │ │ │ │ +000017f0: 204e 6f74 2045 6e6f 7567 687f 3336 3634 Not Enough.3664 │ │ │ │ │ +00001800: 3538 0a4e 6f64 653a 2045 7874 656e 6469 58.Node: Extendi │ │ │ │ │ +00001810: 6e67 7f33 3636 3930 310a 4e6f 6465 3a20 ng.366901.Node: │ │ │ │ │ +00001820: 5468 6972 642d 5061 7274 7920 4d61 6b65 Third-Party Make │ │ │ │ │ +00001830: 6669 6c65 737f 3337 3136 3337 0a4e 6f64 files.371637.Nod │ │ │ │ │ +00001840: 653a 2044 6973 7472 6962 7574 696e 677f e: Distributing. │ │ │ │ │ +00001850: 3337 3832 3239 0a4e 6f64 653a 2041 5049 378229.Node: API │ │ │ │ │ +00001860: 2056 6572 7369 6f6e 696e 677f 3337 3838 Versioning.3788 │ │ │ │ │ +00001870: 3731 0a4e 6f64 653a 2055 7067 7261 6469 71.Node: Upgradi │ │ │ │ │ +00001880: 6e67 7f33 3831 3531 350a 4e6f 6465 3a20 ng.381515.Node: │ │ │ │ │ +00001890: 4641 517f 3338 3334 3639 0a4e 6f64 653a FAQ.383469.Node: │ │ │ │ │ +000018a0: 2043 5653 7f33 3834 3538 320a 4e6f 6465 CVS.384582.Node │ │ │ │ │ +000018b0: 3a20 6d61 696e 7461 696e 6572 2d6d 6f64 : maintainer-mod │ │ │ │ │ +000018c0: 657f 3339 3133 3038 0a4e 6f64 653a 2057 e.391308.Node: W │ │ │ │ │ +000018d0: 696c 6463 6172 6473 7f33 3935 3233 390a ildcards.395239. │ │ │ │ │ +000018e0: 4e6f 6465 3a20 4c69 6d69 7461 7469 6f6e Node: Limitation │ │ │ │ │ +000018f0: 7320 6f6e 2046 696c 6520 4e61 6d65 737f s on File Names. │ │ │ │ │ +00001900: 3339 3835 3139 0a4e 6f64 653a 2064 6973 398519.Node: dis │ │ │ │ │ +00001910: 7463 6c65 616e 6368 6563 6b7f 3430 3130 tcleancheck.4010 │ │ │ │ │ +00001920: 3933 0a4e 6f64 653a 2046 6c61 6720 5661 93.Node: Flag Va │ │ │ │ │ +00001930: 7269 6162 6c65 7320 4f72 6465 7269 6e67 riables Ordering │ │ │ │ │ +00001940: 7f34 3035 3838 370a 4e6f 6465 3a20 5265 .405887.Node: Re │ │ │ │ │ +00001950: 6e61 6d65 6420 4f62 6a65 6374 737f 3431 named Objects.41 │ │ │ │ │ +00001960: 3335 3733 0a4e 6f64 653a 2050 6572 2d4f 3573.Node: Per-O │ │ │ │ │ +00001970: 626a 6563 7420 466c 6167 737f 3431 3531 bject Flags.4151 │ │ │ │ │ +00001980: 3231 0a4e 6f64 653a 204d 756c 7469 706c 21.Node: Multipl │ │ │ │ │ +00001990: 6520 4f75 7470 7574 737f 3431 3830 3233 e Outputs.418023 │ │ │ │ │ +000019a0: 0a4e 6f64 653a 2048 6172 642d 436f 6465 .Node: Hard-Code │ │ │ │ │ +000019b0: 6420 496e 7374 616c 6c20 5061 7468 737f d Install Paths. │ │ │ │ │ +000019c0: 3432 3936 3231 0a4e 6f64 653a 2044 6562 429621.Node: Deb │ │ │ │ │ +000019d0: 7567 6769 6e67 204d 616b 6520 5275 6c65 ugging Make Rule │ │ │ │ │ +000019e0: 737f 3433 3436 3430 0a52 6566 3a20 4465 s.434640.Ref: De │ │ │ │ │ +000019f0: 6275 6767 696e 6720 4d61 6b65 2052 756c bugging Make Rul │ │ │ │ │ +00001a00: 6573 2d46 6f6f 746e 6f74 652d 317f 3433 es-Footnote-1.43 │ │ │ │ │ +00001a10: 3637 3034 0a4e 6f64 653a 2052 6570 6f72 6704.Node: Repor │ │ │ │ │ +00001a20: 7469 6e67 2042 7567 737f 3433 3638 3638 ting Bugs.436868 │ │ │ │ │ +00001a30: 0a4e 6f64 653a 2048 6973 746f 7279 7f34 .Node: History.4 │ │ │ │ │ +00001a40: 3338 3831 320a 4e6f 6465 3a20 5469 6d65 38812.Node: Time │ │ │ │ │ +00001a50: 6c69 6e65 7f34 3339 3338 320a 4e6f 6465 line.439382.Node │ │ │ │ │ +00001a60: 3a20 4465 7065 6e64 656e 6379 2054 7261 : Dependency Tra │ │ │ │ │ +00001a70: 636b 696e 6720 4576 6f6c 7574 696f 6e7f cking Evolution. │ │ │ │ │ +00001a80: 3437 3037 3036 0a4e 6f64 653a 2046 6972 470706.Node: Fir │ │ │ │ │ +00001a90: 7374 2054 616b 6520 6f6e 2044 6570 656e st Take on Depen │ │ │ │ │ +00001aa0: 6465 6e63 6965 737f 3437 3136 3732 0a4e dencies.471672.N │ │ │ │ │ +00001ab0: 6f64 653a 2044 6570 656e 6465 6e63 6965 ode: Dependencie │ │ │ │ │ +00001ac0: 7320 4173 2053 6964 6520 4566 6665 6374 s As Side Effect │ │ │ │ │ +00001ad0: 737f 3437 3433 3333 0a4e 6f64 653a 2044 s.474333.Node: D │ │ │ │ │ +00001ae0: 6570 656e 6465 6e63 6965 7320 666f 7220 ependencies for │ │ │ │ │ +00001af0: 7468 6520 5573 6572 7f34 3736 3339 350a the User.476395. │ │ │ │ │ +00001b00: 4e6f 6465 3a20 5465 6368 6e69 7175 6573 Node: Techniques │ │ │ │ │ +00001b10: 2066 6f72 2044 6570 656e 6465 6e63 6965 for Dependencie │ │ │ │ │ +00001b20: 737f 3438 3134 3035 0a4e 6f64 653a 2052 s.481405.Node: R │ │ │ │ │ +00001b30: 6563 6f6d 6d65 6e64 6174 696f 6e73 2066 ecommendations f │ │ │ │ │ +00001b40: 6f72 2054 6f6f 6c20 5772 6974 6572 737f or Tool Writers. │ │ │ │ │ +00001b50: 3438 3330 3631 0a4e 6f64 653a 2046 7574 483061.Node: Fut │ │ │ │ │ +00001b60: 7572 6520 4469 7265 6374 696f 6e73 2066 ure Directions f │ │ │ │ │ +00001b70: 6f72 2044 6570 656e 6465 6e63 6965 737f or Dependencies. │ │ │ │ │ +00001b80: 3438 3338 3137 0a4e 6f64 653a 2052 656c 483817.Node: Rel │ │ │ │ │ +00001b90: 6561 7365 737f 3438 3432 3838 0a4e 6f64 eases.484288.Nod │ │ │ │ │ +00001ba0: 653a 2043 6f70 7969 6e67 2054 6869 7320 e: Copying This │ │ │ │ │ +00001bb0: 4d61 6e75 616c 7f34 3839 3937 370a 4e6f Manual.489977.No │ │ │ │ │ +00001bc0: 6465 3a20 474e 5520 4672 6565 2044 6f63 de: GNU Free Doc │ │ │ │ │ +00001bd0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +00001be0: 7365 7f34 3930 3231 360a 4e6f 6465 3a20 se.490216.Node: │ │ │ │ │ +00001bf0: 496e 6469 6365 737f 3531 3533 3337 0a4e Indices.515337.N │ │ │ │ │ +00001c00: 6f64 653a 204d 6163 726f 2049 6e64 6578 ode: Macro Index │ │ │ │ │ +00001c10: 7f35 3135 3633 310a 4e6f 6465 3a20 5661 .515631.Node: Va │ │ │ │ │ +00001c20: 7269 6162 6c65 2049 6e64 6578 7f35 3231 riable Index.521 │ │ │ │ │ +00001c30: 3738 360a 4e6f 6465 3a20 4765 6e65 7261 786.Node: Genera │ │ │ │ │ +00001c40: 6c20 496e 6465 787f 3535 3038 3530 0a1f l Index.550850.. │ │ │ │ │ +00001c50: 0a45 6e64 2054 6167 2054 6162 6c65 0a0a .End Tag Table.. │ │ │ │ │ +00001c60: 1f0a 4c6f 6361 6c20 5661 7269 6162 6c65 ..Local Variable │ │ │ │ │ +00001c70: 733a 0a63 6f64 696e 673a 2075 7466 2d38 s:.coding: utf-8 │ │ │ │ │ +00001c80: 0a45 6e64 3a0a .End:.