automake.in

   1 #!@PERL@ -w
   2 # -*- perl -*-
   3 # @configure_input@
   4
   5 eval 'exec @PERL@ -S $0 ${1+"$@"}'
   6     if 0;
   7
   8 # automake - create Makefile.in from Makefile.am
   9 # Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002
  10 # Free Software Foundation, Inc.
  11
  12 # This program is free software; you can redistribute it and/or modify
  13 # it under the terms of the GNU General Public License as published by
  14 # the Free Software Foundation; either version 2, or (at your option)
  15 # any later version.
  16
  17 # This program is distributed in the hope that it will be useful,
  18 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 # GNU General Public License for more details.
  21
  22 # You should have received a copy of the GNU General Public License
  23 # along with this program; if not, write to the Free Software
  24 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  25 # 02111-1307, USA.
  26
  27 # Originally written by David Mackenzie <djm@gnu.ai.mit.edu>.
  28 # Perl reimplementation by Tom Tromey <tromey@redhat.com>.
  29
  30 package Language;
  31
  32 BEGIN
  33 {
  34   my $prefix = "@prefix@";
  35   my $perllibdir = $ENV{'perllibdir'} || "@datadir@/@PACKAGE@-@APIVERSION@";
  36   unshift @INC, "$perllibdir";
  37 }
  38
  39 use Automake::Struct;
  40 struct (# Short name of the language (c, f77...).
  41         'name' => "\$",
  42         # Nice name of the language (C, Fortran 77...).
  43         'Name' => "\$",
  44
  45         # List of configure variables which must be defined.
  46         'config_vars' => '@',
  47
  48         'ansi'    => "\$",
  49         # `pure' is `1' or `'.  A `pure' language is one where, if
  50         # all the files in a directory are of that language, then we
  51         # do not require the C compiler or any code to call it.
  52         'pure'   => "\$",
  53
  54         'autodep' => "\$",
  55
  56         # Name of the compiling variable (COMPILE).
  57         'compiler'  => "\$",
  58         # Content of the compiling variable.
  59         'compile'  => "\$",
  60         # Flag to require compilation without linking (-c).
  61         'compile_flag' => "\$",
  62         'extensions'      => '@',
  63         'flags' => "\$",
  64         # Should the flag be defined as a configure variable.
  65         # Defaults to true.  FIXME: this should go away once
  66         # we move to autoconf tracing.
  67         'define_flag' => "\$",
  68
  69         # The file to use when generating rules for this language.
  70         # The default is 'depend2'.
  71         'rule_file' => "\$",
  72
  73         # Name of the linking variable (LINK).
  74         'linker' => "\$",
  75         # Content of the linking variable.
  76         'link' => "\$",
  77
  78         # Name of the linker variable (LD).
  79         'lder' => "\$",
  80         # Content of the linker variable ($(CC)).
  81         'ld' => "\$",
  82
  83         # Flag to specify the output file (-o).
  84         'output_flag' => "\$",
  85         '_finish' => "\$",
  86
  87         # This is a subroutine which is called whenever we finally
  88         # determine the context in which a source file will be
  89         # compiled.
  90         '_target_hook' => "\$");
  91
  92
  93 sub finish ($)
  94 {
  95   my ($self) = @_;
  96   if (defined $self->_finish)
  97     {
  98       &{$self->_finish} ();
  99     }
 100 }
 101
 102 sub target_hook ($$$$)
 103 {
 104     my ($self) = @_;
 105     if (defined $self->_target_hook)
 106     {
 107         &{$self->_target_hook} (@_);
 108     }
 109 }
 110
 111 package Automake;
 112
 113 use strict 'vars', 'subs';
 114 use Automake::General;
 115 use Automake::XFile;
 116 use File::Basename;
 117 use Carp;
 118
 119 ## ----------- ##
 120 ## Constants.  ##
 121 ## ----------- ##
 122
 123 # Parameters set by configure.  Not to be changed.  NOTE: assign
 124 # VERSION as string so that eg version 0.30 will print correctly.
 125 my $VERSION = "@VERSION@";
 126 my $PACKAGE = "@PACKAGE@";
 127 my $prefix = "@prefix@";
 128 my $libdir = "@datadir@/@PACKAGE@-@APIVERSION@";
 129
 130 # String constants.
 131 my $IGNORE_PATTERN = '^\s*##([^#\n].*)?\n';
 132 my $WHITE_PATTERN = '^\s*$';
 133 my $COMMENT_PATTERN = '^#';
 134 my $TARGET_PATTERN='[$a-zA-Z_.@][-.a-zA-Z0-9_(){}/$+@]*';
 135 # A rule has three parts: a list of targets, a list of dependencies,
 136 # and optionally actions.
 137 my $RULE_PATTERN =
 138   "^($TARGET_PATTERN(?:(?:\\\\\n|\\s)+$TARGET_PATTERN)*) *:([^=].*|)\$";
 139
 140 my $SUFFIX_RULE_PATTERN = '^(\.[a-zA-Z0-9_(){}$+@]+)(\.[a-zA-Z0-9_(){}$+@]+)$';
 141 # Only recognize leading spaces, not leading tabs.  If we recognize
 142 # leading tabs here then we need to make the reader smarter, because
 143 # otherwise it will think rules like `foo=bar; \' are errors.
 144 my $MACRO_PATTERN = '^[A-Za-z0-9_@]+$';
 145 my $ASSIGNMENT_PATTERN = '^ *([^ \t=:+]*)\s*([:+]?)=\s*(.*)$';
 146 # This pattern recognizes a Gnits version id and sets $1 if the
 147 # release is an alpha release.  We also allow a suffix which can be
 148 # used to extend the version number with a "fork" identifier.
 149 my $GNITS_VERSION_PATTERN = '\d+\.\d+([a-z]|\.\d+)?(-[A-Za-z0-9]+)?';
 150 my $IF_PATTERN =          '^if\s+(!?)\s*([A-Za-z][A-Za-z0-9_]*)\s*(?:#.*)?$';
 151 my $ELSE_PATTERN =   '^else(?:\s+(!?)\s*([A-Za-z][A-Za-z0-9_]*))?\s*(?:#.*)?$';
 152 my $ENDIF_PATTERN = '^endif(?:\s+(!?)\s*([A-Za-z][A-Za-z0-9_]*))?\s*(?:#.*)?$';
 153 my $PATH_PATTERN='(\w|[/.-])+';
 154 # This will pass through anything not of the prescribed form.
 155 my $INCLUDE_PATTERN = ('^include\s+'
 156                        . '((\$\(top_srcdir\)/' . $PATH_PATTERN . ')'
 157                        . '|(\$\(srcdir\)/' . $PATH_PATTERN . ')'
 158                        . '|([^/\$]' . $PATH_PATTERN. '))\s*(#.*)?$');
 159
 160 # Some regular expressions.  One reason to put them here is that it
 161 # makes indentation work better in Emacs.
 162 my $AC_CONFIG_AUX_DIR_PATTERN = 'AC_CONFIG_AUX_DIR\(([^)]+)\)';
 163 my $AM_INIT_AUTOMAKE_PATTERN = 'AM_INIT_AUTOMAKE\([^,]*,([^,)]+)[,)]';
 164 my $AC_INIT_PATTERN = 'AC_INIT\([^,]*,([^,)]+)[,)]';
 165 my $AM_PACKAGE_VERSION_PATTERN = '^\s*\[?([^]\s]+)\]?\s*$';
 166
 167 # This handles substitution references like ${foo:.a=.b}.
 168 my $SUBST_REF_PATTERN = "^([^:]*):([^=]*)=(.*)\$";
 169
 170 # Note that there is no AC_PATH_TOOL.  But we don't really care.
 171 my $AC_CHECK_PATTERN = 'AC_(CHECK|PATH)_(PROG|PROGS|TOOL)\(\[?(\w+)';
 172 my $AM_MISSING_PATTERN = 'AM_MISSING_PROG\(\[?(\w+)';
 173 # Just check for alphanumeric in AC_SUBST.  If you do AC_SUBST(5),
 174 # then too bad.
 175 my $AC_SUBST_PATTERN = 'AC_SUBST\(\[?(\w+)';
 176 my $AM_CONDITIONAL_PATTERN = 'AM_CONDITIONAL\(\[?(\w+)';
 177 # Match `-d' as a command-line argument in a string.
 178 my $DASH_D_PATTERN = "(^|\\s)-d(\\s|\$)";
 179 # Directories installed during 'install-exec' phase.
 180 my $EXEC_DIR_PATTERN =
 181     '^(?:bin|sbin|libexec|sysconf|localstate|lib|pkglib|.*exec.*)$'; #'
 182
 183 # Constants to define the "strictness" level.
 184 use constant FOREIGN => 0;
 185 use constant GNU     => 1;
 186 use constant GNITS   => 2;
 187
 188 # Values for AC_CANONICAL_*
 189 use constant AC_CANONICAL_HOST   => 1;
 190 use constant AC_CANONICAL_SYSTEM => 2;
 191
 192 # Values indicating when something should be cleaned.  Right now we
 193 # only need to handle `mostly'- and `dist'-clean; add more as
 194 # required.
 195 use constant MOSTLY_CLEAN => 0;
 196 use constant DIST_CLEAN   => 1;
 197
 198 # Libtool files.
 199 my @libtool_files = qw(ltmain.sh config.guess config.sub);
 200 # ltconfig appears here for compatibility with old versions of libtool.
 201 my @libtool_sometimes = qw(ltconfig ltcf-c.sh ltcf-cxx.sh ltcf-gcj.sh);
 202
 203 # Commonly found files we look for and automatically include in
 204 # DISTFILES.
 205 my @common_files =
 206     (qw(ABOUT-GNU ABOUT-NLS AUTHORS BACKLOG COPYING COPYING.DOC COPYING.LIB
 207         ChangeLog INSTALL NEWS README THANKS TODO acinclude.m4
 208         ansi2knr.1 ansi2knr.c compile config.guess config.rpath config.sub
 209         configure configure.ac configure.in depcomp elisp-comp
 210         install-sh libversion.in mdate-sh missing mkinstalldirs
 211         py-compile texinfo.tex ylwrap),
 212      @libtool_files, @libtool_sometimes);
 213
 214 # Commonly used files we auto-include, but only sometimes.
 215 my @common_sometimes =
 216     qw(aclocal.m4 acconfig.h config.h.top config.h.bot stamp-vti);
 217
 218 # Standard directories from the GNU Coding Standards, and additional
 219 # pkg* directories from Automake.  Stored in a hash for fast member check.
 220 my %standard_prefix =
 221     map { $_ => 1 } (qw(bin data exec include info lib libexec lisp
 222                         localstate man man1 man2 man3 man4 man5 man6
 223                         man7 man8 man9 oldinclude pkgdatadir
 224                         pkgincludedir pkglibdir sbin sharedstate
 225                         sysconf));
 226
 227 # Copyright on generated Makefile.ins.
 228 my $gen_copyright = "\
 229 # Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002
 230 # Free Software Foundation, Inc.
 231 # This Makefile.in is free software; the Free Software Foundation
 232 # gives unlimited permission to copy and/or distribute it,
 233 # with or without modifications, as long as this notice is preserved.
 234
 235 # This program is distributed in the hope that it will be useful,
 236 # but WITHOUT ANY WARRANTY, to the extent permitted by law; without
 237 # even the implied warranty of MERCHANTABILITY or FITNESS FOR A
 238 # PARTICULAR PURPOSE.
 239 ";
 240
 241 # These constants are returned by lang_*_rewrite functions.
 242 # LANG_SUBDIR means that the resulting object file should be in a
 243 # subdir if the source file is.  In this case the file name cannot
 244 # have `..' components.
 245 my $LANG_IGNORE = 0;
 246 my $LANG_PROCESS = 1;
 247 my $LANG_SUBDIR = 2;
 248
 249 # These are used when keeping track of whether an object can be built
 250 # by two different paths.
 251 my $COMPILE_LIBTOOL = 1;
 252 my $COMPILE_ORDINARY = 2;
 253
 254 # Map from obsolete macros to hints for new macros.
 255 # If you change this, change the corresponding list in aclocal.in.
 256 # FIXME: should just put this into a single file.
 257 my %obsolete_macros =
 258     (
 259      'AC_FEATURE_CTYPE'         => "use `AC_HEADER_STDC'",
 260      'AC_FEATURE_ERRNO'         => "add `strerror' to `AC_REPLACE_FUNCS(...)'",
 261      'AC_FEATURE_EXIT'          => '',
 262      'AC_SYSTEM_HEADER'         => '',
 263
 264      # Note that we do not handle this one, because it is still run
 265      # from AM_CONFIG_HEADER.  So we deal with it specially in
 266      # &scan_autoconf_files.
 267      # 'AC_CONFIG_HEADER'       => "use `AM_CONFIG_HEADER'",
 268
 269      'fp_C_PROTOTYPES'          => "use `AM_C_PROTOTYPES'",
 270      'fp_PROG_CC_STDC'          => "use `AM_PROG_CC_STDC'",
 271      'fp_PROG_INSTALL'          => "use `AC_PROG_INSTALL'",
 272      'fp_WITH_DMALLOC'          => "use `AM_WITH_DMALLOC'",
 273      'fp_WITH_REGEX'            => "use `AM_WITH_REGEX'",
 274      'gm_PROG_LIBTOOL'          => "use `AM_PROG_LIBTOOL'",
 275      'jm_MAINTAINER_MODE'       => "use `AM_MAINTAINER_MODE'",
 276      'md_TYPE_PTRDIFF_T'        => "add `ptrdiff_t' to `AC_CHECK_TYPES(...)'",
 277      'ud_PATH_LISPDIR'          => "use `AM_PATH_LISPDIR'",
 278      'ud_GNU_GETTEXT'           => "use `AM_GNU_GETTEXT'",
 279
 280      # Now part of autoconf proper, under a different name.
 281      'fp_FUNC_FNMATCH'          => "use `AC_FUNC_FNMATCH'",
 282      'AM_SANITY_CHECK_CC'       => "automatically done by `AC_PROG_CC'",
 283      'AM_PROG_INSTALL'          => "use `AC_PROG_INSTALL'",
 284      'AM_EXEEXT'                => "automatically done by `AC_PROG_(CC|CXX|F77)'",
 285      'AM_CYGWIN32'              => "use `AC_CYGWIN'",
 286      'AM_MINGW32'               => "use `AC_MINGW32'",
 287      'AM_FUNC_MKTIME'           => "use `AC_FUNC_MKTIME'",
 288      );
 289
 290 # Regexp to match the above macros.
 291 my $obsolete_rx = '\b(' . join ('|', keys %obsolete_macros) . ')\b';
 292 \f
 293
 294
 295 ## ---------------------------------- ##
 296 ## Variables related to the options.  ##
 297 ## ---------------------------------- ##
 298
 299 # TRUE if we should always generate Makefile.in.
 300 my $force_generation = 1;
 301
 302 # Strictness level as set on command line.
 303 my $default_strictness = GNU;
 304
 305 # Name of strictness level, as set on command line.
 306 my $default_strictness_name = 'gnu';
 307
 308 # This is TRUE if automatic dependency generation code should be
 309 # included in generated Makefile.in.
 310 my $cmdline_use_dependencies = 1;
 311
 312 # This holds our (eventual) exit status.  We don't actually exit until
 313 # we have processed all input files.
 314 my $exit_status = 0;
 315
 316 # From the Perl manual.
 317 my $symlink_exists = (eval 'symlink ("", "");', $@ eq '');
 318
 319 # TRUE if missing standard files should be installed.
 320 my $add_missing = 0;
 321
 322 # TRUE if we should copy missing files; otherwise symlink if possible.
 323 my $copy_missing = 0;
 324
 325 # TRUE if we should always update files that we know about.
 326 my $force_missing = 0;
 327
 328
 329 ## ---------------------------------------- ##
 330 ## Variables filled during files scanning.  ##
 331 ## ---------------------------------------- ##
 332
 333 # Name of the top autoconf input: `configure.ac' or `configure.in'.
 334 my $configure_ac = '';
 335
 336 # Files found by scanning configure.ac for LIBOBJS.
 337 my %libsources = ();
 338
 339 # True if AM_C_PROTOTYPES appears in configure.ac.
 340 my $am_c_prototypes = 0;
 341
 342 # Names used in AC_CONFIG_HEADER call.
 343 my @config_headers = ();
 344 # Where AC_CONFIG_HEADER appears.
 345 my $config_header_location;
 346
 347 # Directory where output files go.  Actually, output files are
 348 # relative to this directory.
 349 my $output_directory;
 350
 351 # List of Makefile.am's to process, and their corresponding outputs.
 352 my @input_files = ();
 353 my %output_files = ();
 354
 355 # Complete list of Makefile.am's that exist.
 356 my @configure_input_files = ();
 357
 358 # List of files in AC_CONFIG_FILES/AC_OUTPUT without Makefile.am's,
 359 # and their outputs.
 360 my @other_input_files = ();
 361 # Where the last AC_CONFIG_FILES/AC_OUTPUT appears.
 362 my $ac_config_files_location;
 363
 364 # List of directories to search for configure-required files.  This
 365 # can be set by AC_CONFIG_AUX_DIR.
 366 my @config_aux_path = qw(. .. ../..);
 367 my $config_aux_dir = '';
 368 my $config_aux_dir_set_in_configure_in = 0;
 369
 370 # Whether AM_GNU_GETTEXT has been seen in configure.ac.
 371 my $seen_gettext = 0;
 372 # Where AM_GNU_GETTEXT appears.
 373 my $ac_gettext_location;
 374
 375 # TRUE if AC_PROG_LEX or AM_PROG_LEX were seen.
 376 my $seen_prog_lex = 0;
 377
 378 # TRUE if we've seen AC_CANONICAL_(HOST|SYSTEM).
 379 my $seen_canonical = 0;
 380 my $canonical_location;
 381
 382 # Where AC_PROG_LIBTOOL appears.
 383 my $seen_libtool;
 384
 385 # Where AM_MAINTAINER_MODE appears.
 386 my $seen_maint_mode;
 387
 388 # Actual version we've seen.
 389 my $package_version = '';
 390
 391 # Where version is defined.
 392 my $package_version_location;
 393
 394 # Where AM_PATH_LISPDIR appears.
 395 my $am_lispdir_location;
 396
 397 # Where AM_PATH_PYTHON appears.
 398 my $pythondir_location;
 399
 400 # TRUE if we've seen AC_ENABLE_MULTILIB.
 401 my $seen_multilib = 0;
 402
 403 # TRUE if we've seen AM_PROG_CC_C_O
 404 my $seen_cc_c_o = 0;
 405
 406 # Where AM_INIT_AUTOMAKE is called;
 407 my $seen_init_automake = 0;
 408
 409 # TRUE if we've seen AM_AUTOMAKE_VERSION.
 410 my $seen_automake_version = 0;
 411
 412 # Hash table of discovered configure substitutions.  Keys are names,
 413 # values are `FILE:LINE' strings which are used by error message
 414 # generation.
 415 my %configure_vars = ();
 416
 417 # This is used to keep track of which variable definitions we are
 418 # scanning.  It is only used in certain limited ways, but it has to be
 419 # global.  It is declared just for documentation purposes.
 420 my %vars_scanned = ();
 421
 422 # TRUE if --cygnus seen.
 423 my $cygnus_mode = 0;
 424
 425 # Hash table of AM_CONDITIONAL variables seen in configure.
 426 my %configure_cond = ();
 427
 428 # This maps extensions onto language names.
 429 my %extension_map = ();
 430
 431 # List of the DIST_COMMON files we discovered while reading
 432 # configure.in
 433 my $configure_dist_common = '';
 434
 435 # This maps languages names onto objects.
 436 my %languages = ();
 437
 438 # List of targets we must always output.
 439 # FIXME: Complete, and remove falsely required targets.
 440 my %required_targets =
 441   (
 442    'all'          => 1,
 443    'dvi'          => 1,
 444    'info'         => 1,
 445    'install-info' => 1,
 446    'install'      => 1,
 447    'install-data' => 1,
 448    'install-exec' => 1,
 449    'uninstall'    => 1,
 450
 451    # FIXME: Not required, temporary hacks.
 452    # Well, actually they are sort of required: the -recursive
 453    # targets will run them anyway...
 454    'dvi-am'          => 1,
 455    'info-am'         => 1,
 456    'install-data-am' => 1,
 457    'install-exec-am' => 1,
 458    'installcheck-am' => 1,
 459    'uninstall-am' => 1,
 460
 461    'install-man' => 1,
 462   );
 463
 464 # This is set to 1 when Automake needs to be run again.
 465 # (For instance, this happens when an auxiliary file such as
 466 # depcomp is added after the toplevel Makefile.in -- which
 467 # should distribute depcomp -- has been generated.)
 468 my $automake_needs_to_reprocess_all_files = 0;
 469
 470 # Options set via AM_INIT_AUTOMAKE.
 471 my $global_options = '';
 472
 473 \f
 474
 475 ################################################################
 476
 477 ## ------------------------------------------ ##
 478 ## Variables reset by &initialize_per_input.  ##
 479 ## ------------------------------------------ ##
 480
 481 # Basename and relative dir of the input file.
 482 my $am_file_name;
 483 my $am_relative_dir;
 484
 485 # Same but wrt Makefile.in.
 486 my $in_file_name;
 487 my $relative_dir;
 488
 489 # These two variables are used when generating each Makefile.in.
 490 # They hold the Makefile.in until it is ready to be printed.
 491 my $output_rules;
 492 my $output_vars;
 493 my $output_trailer;
 494 my $output_all;
 495 my $output_header;
 496
 497 # Suffixes found during a run.
 498 my @suffixes;
 499
 500 # Handling the variables.
 501 #
 502 # For a $VAR:
 503 # - $var_value{$VAR}{$COND} is its value associated to $COND,
 504 # - $var_location{$VAR} is where it was defined,
 505 # - $var_comment{$VAR} are the comments associated to it.
 506 # - $var_type{$VAR} is how it has been defined (`', `+', or `:'),
 507 # - $var_is_am{$VAR} is true if the variable is owned by Automake.
 508 my %var_value;
 509 my %var_location;
 510 my %var_comment;
 511 my %var_type;
 512 my %var_is_am;
 513
 514 # This holds a 1 if a particular variable was examined.
 515 my %content_seen;
 516
 517 # This holds the names which are targets.  These also appear in
 518 # %contents.
 519 my %targets;
 520
 521 # Same as %VAR_VALUE, but for targets.
 522 my %target_conditional;
 523
 524 # This is the conditional stack.
 525 my @cond_stack;
 526
 527 # This holds the set of included files.
 528 my @include_stack;
 529
 530 # This holds a list of directories which we must create at `dist'
 531 # time.  This is used in some strange scenarios involving weird
 532 # AC_OUTPUT commands.
 533 my %dist_dirs;
 534
 535 # List of dependencies for the obvious targets.
 536 my @all;
 537 my @check;
 538 my @check_tests;
 539
 540 # Holds the dependencies of targets which dependencies are factored.
 541 # Typically, `.PHONY' will appear in plenty of *.am files, but must
 542 # be output once.  Arguably all pure dependencies could be subject
 543 # to this factorization, but it is not unpleasant to have paragraphs
 544 # in Makefile: keeping related stuff altogether.
 545 my %dependencies;
 546
 547 # Holds the factored actions.  Tied to %DEPENDENCIES, i.e., filled
 548 # only when keys exists in %DEPENDENCIES.
 549 my %actions;
 550
 551 # A list of files deleted by `maintainer-clean'.
 552 my @maintainer_clean_files;
 553
 554 # Keys in this hash table are object files or other files in
 555 # subdirectories which need to be removed.  This only holds files
 556 # which are created by compilations.  The value in the hash indicates
 557 # when the file should be removed.
 558 my %compile_clean_files;
 559
 560 # Value of `$(SOURCES)', used by tags.am.
 561 my @sources;
 562 # Sources which go in the distribution.
 563 my @dist_sources;
 564
 565 # This hash maps object file names onto their corresponding source
 566 # file names.  This is used to ensure that each object is created
 567 # by a single source file.
 568 my %object_map;
 569
 570 # This hash maps object file names onto an integer value representing
 571 # whether this object has been built via ordinary compilation or
 572 # libtool compilation (the COMPILE_* constants).
 573 my %object_compilation_map;
 574
 575
 576 # This keeps track of the directories for which we've already
 577 # created `.dirstamp' code.
 578 my %directory_map;
 579
 580 # All .P files.
 581 my %dep_files;
 582
 583 # Strictness levels.
 584 my $strictness;
 585 my $strictness_name;
 586
 587 # Options from AUTOMAKE_OPTIONS.
 588 my %options;
 589
 590 # Whether or not dependencies are handled.  Can be further changed
 591 # in handle_options.
 592 my $use_dependencies;
 593
 594 # This is a list of all targets to run during "make dist".
 595 my @dist_targets;
 596
 597 # Keys in this hash are the basenames of files which must depend on
 598 # ansi2knr.  Values are either the empty string, or the directory in
 599 # which the ANSI source file appears; the directory must have a
 600 # trailing `/'.
 601 my %de_ansi_files;
 602
 603 # This maps the source extension of a suffix rule to its
 604 # corresponding output extension.
 605 # FIXME: because this hash maps one input extension to one output
 606 # extension, Automake cannot handle two suffix rules with the same
 607 # input extension.
 608 my %suffix_rules;
 609
 610 # This is the name of the redirect `all' target to use.
 611 my $all_target;
 612
 613 # This keeps track of which extensions we've seen (that we care
 614 # about).
 615 my %extension_seen;
 616
 617 # This is random scratch space for the language finish functions.
 618 # Don't randomly overwrite it; examine other uses of keys first.
 619 my %language_scratch;
 620
 621 # We keep track of which objects need special (per-executable)
 622 # handling on a per-language basis.
 623 my %lang_specific_files;
 624
 625 # This is set when `handle_dist' has finished.  Once this happens,
 626 # we should no longer push on dist_common.
 627 my $handle_dist_run;
 628
 629 # Used to store a set of linkers needed to generate the sources currently
 630 # under consideration.
 631 my %linkers_used;
 632
 633 # True if we need `LINK' defined.  This is a hack.
 634 my $need_link;
 635
 636 # This is the list of such variables to output.
 637 # FIXME: Might be useless actually.
 638 my @var_list;
 639
 640 # Was get_object_extension run?
 641 # FIXME: This is a hack. a better switch should be found.
 642 my $get_object_extension_was_run;
 643
 644 # Contains a stack of `from' parts of variable substitutions currently in
 645 # force.
 646 my @substfroms;
 647
 648 # Contains a stack of `to' parts of variable substitutions currently in
 649 # force.
 650 my @substtos;
 651
 652 # Associates a variable name, together with a list of substitutions to be
 653 # performed on it, with a number.  Used to provide unique names for generated
 654 # variables.
 655 my %substnums = ();
 656
 657 ## --------------------------------- ##
 658 ## Forward subroutine declarations.  ##
 659 ## --------------------------------- ##
 660 sub register_language (%);
 661 sub file_contents_internal ($$%);
 662 sub define_objects_from_sources ($$$$$$$);
 663
 664
 665 # &initialize_per_input ()
 666 # ------------------------
 667 # (Re)-Initialize per-Makefile.am variables.
 668 sub initialize_per_input ()
 669 {
 670     $am_file_name = '';
 671     $am_relative_dir = '';
 672
 673     $in_file_name = '';
 674     $relative_dir = '';
 675
 676     $output_rules = '';
 677     $output_vars = '';
 678     $output_trailer = '';
 679     $output_all = '';
 680     $output_header = '';
 681
 682     @suffixes = ();
 683
 684     %var_value = ();
 685     %var_location = ();
 686     %var_comment = ();
 687     %var_type = ();
 688     %var_is_am = ();
 689
 690     %content_seen = ();
 691
 692     %targets = ();
 693
 694     %target_conditional = ();
 695
 696     @cond_stack = ();
 697
 698     @include_stack = ();
 699
 700     %dist_dirs = ();
 701
 702     @all = ();
 703     @check = ();
 704     @check_tests = ();
 705
 706     %dependencies =
 707       (
 708        # Texinfoing.
 709        'dvi'      => [],
 710        'dvi-am'   => [],
 711        'info'     => [],
 712        'info-am'  => [],
 713
 714        # Installing/uninstalling.
 715        'install-data-am'      => [],
 716        'install-exec-am'      => [],
 717        'uninstall-am'         => [],
 718
 719        'install-man'          => [],
 720        'uninstall-man'        => [],
 721
 722        'install-info'         => [],
 723        'install-info-am'      => [],
 724        'uninstall-info'       => [],
 725
 726        'installcheck-am'      => [],
 727
 728        # Cleaning.
 729        'clean-am'             => [],
 730        'mostlyclean-am'       => [],
 731        'maintainer-clean-am'  => [],
 732        'distclean-am'         => [],
 733        'clean'                => [],
 734        'mostlyclean'          => [],
 735        'maintainer-clean'     => [],
 736        'distclean'            => [],
 737
 738        # Tarballing.
 739        'dist-all'             => [],
 740
 741        # Phoning.
 742        '.PHONY'               => []
 743       );
 744     %actions = ();
 745
 746     @maintainer_clean_files = ();
 747
 748     @sources = ();
 749     @dist_sources = ();
 750
 751     %object_map = ();
 752     %object_compilation_map = ();
 753
 754     %directory_map = ();
 755
 756     %dep_files = ();
 757
 758     $strictness = $default_strictness;
 759     $strictness_name = $default_strictness_name;
 760
 761     %options = ();
 762
 763     $use_dependencies = $cmdline_use_dependencies;
 764
 765     @dist_targets = ();
 766
 767     %de_ansi_files = ();
 768
 769     %suffix_rules = ();
 770
 771     $all_target = '';
 772
 773     %extension_seen = ();
 774
 775     %language_scratch = ();
 776
 777     %lang_specific_files = ();
 778
 779     $handle_dist_run = 0;
 780
 781     $need_link = 0;
 782
 783     @var_list = ();
 784
 785     $get_object_extension_was_run = 0;
 786
 787     %compile_clean_files = ();
 788 }
 789
 790
 791 ################################################################
 792
 793 # Initialize our list of languages that are internally supported.
 794
 795 # C.
 796 register_language ('name' => 'c',
 797                    'Name' => 'C',
 798                    'config_vars' => ['CC'],
 799                    'ansi' => 1,
 800                    'autodep' => '',
 801                    'flags' => 'CFLAGS',
 802                    'compiler' => 'COMPILE',
 803                    'compile' => '$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)',
 804                    'lder' => 'CCLD',
 805                    'ld' => '$(CC)',
 806                    'linker' => 'LINK',
 807                    'link' => '$(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) $(LDFLAGS) -o $@',
 808                    'compile_flag' => '-c',
 809                    'extensions' => ['.c'],
 810                    '_finish' => \&lang_c_finish);
 811
 812 # C++.
 813 register_language ('name' => 'cxx',
 814                    'Name' => 'C++',
 815                    'config_vars' => ['CXX'],
 816                    'linker' => 'CXXLINK',
 817                    'link' => '$(CXXLD) $(AM_CXXFLAGS) $(CXXFLAGS) $(AM_LDFLAGS) $(LDFLAGS) -o $@',
 818                    'autodep' => 'CXX',
 819                    'flags' => 'CXXFLAGS',
 820                    'compile' => '$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS)',
 821                    'compiler' => 'CXXCOMPILE',
 822                    'compile_flag' => '-c',
 823                    'output_flag' => '-o',
 824                    'lder' => 'CXXLD',
 825                    'ld' => '$(CXX)',
 826                    'pure' => 1,
 827                    'extensions' => ['.c++', '.cc', '.cpp', '.cxx', '.C']);
 828
 829 # Objective C.
 830 register_language ('name' => 'objc',
 831                    'Name' => 'Objective C',
 832                    'config_vars' => ['OBJC'],
 833                    'linker' => 'OBJCLINK',,
 834                    'link' => '$(OBJCLD) $(AM_OBJCFLAGS) $(OBJCFLAGS) $(AM_LDFLAGS) $(LDFLAGS) -o $@',
 835                    'autodep' => 'OBJC',
 836                    'flags' => 'OBJCFLAGS',
 837                    'compile' => '$(OBJC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_OBJCFLAGS) $(OBJCFLAGS)',
 838                    'compiler' => 'OBJCCOMPILE',
 839                    'compile_flag' => '-c',
 840                    'output_flag' => '-o',
 841                    'lder' => 'OBJCLD',
 842                    'ld' => '$(OBJC)',
 843                    'pure' => 1,
 844                    'extensions' => ['.m']);
 845
 846 # Headers.
 847 register_language ('name' => 'header',
 848                    'Name' => 'Header',
 849                    'extensions' => ['.h', '.H', '.hxx', '.h++', '.hh',
 850                                     '.hpp', '.inc'],
 851                    # Nothing to do.
 852                    '_finish' => sub { });
 853
 854 # Yacc (C & C++).
 855 register_language ('name' => 'yacc',
 856                    'Name' => 'Yacc',
 857                    'config_vars' => ['YACC'],
 858                    'flags' => 'YFLAGS',
 859                    'define_flag' => 0,
 860                    'compile' => '$(YACC) $(YFLAGS) $(AM_YFLAGS)',
 861                    'compiler' => 'YACCCOMPILE',
 862                    'extensions' => ['.y'],
 863                    'rule_file' => 'yacc',
 864                    '_finish' => \&lang_yacc_finish,
 865                    '_target_hook' => \&lang_yacc_target_hook);
 866 register_language ('name' => 'yaccxx',
 867                    'Name' => 'Yacc (C++)',
 868                    'config_vars' => ['YACC'],
 869                    'rule_file' => 'yacc',
 870                    'flags' => 'YFLAGS',
 871                    'define_flag' => 0,
 872                    'compiler' => 'YACCCOMPILE',
 873                    'compile' => '$(YACC) $(YFLAGS) $(AM_YFLAGS)',
 874                    'extensions' => ['.y++', '.yy', '.yxx', '.ypp'],
 875                    '_finish' => \&lang_yacc_finish,
 876                    '_target_hook' => \&lang_yacc_target_hook);
 877
 878 # Lex (C & C++).
 879 register_language ('name' => 'lex',
 880                    'Name' => 'Lex',
 881                    'config_vars' => ['LEX'],
 882                    'rule_file' => 'lex',
 883                    'flags' => 'LFLAGS',
 884                    'define_flag' => 0,
 885                    'compile' => '$(LEX) $(LFLAGS) $(AM_LFLAGS)',
 886                    'compiler' => 'LEXCOMPILE',
 887                    'extensions' => ['.l'],
 888                    '_finish' => \&lang_lex_finish);
 889 register_language ('name' => 'lexxx',
 890                    'Name' => 'Lex (C++)',
 891                    'config_vars' => ['LEX'],
 892                    'rule_file' => 'lex',
 893                    'flags' => 'LFLAGS',
 894                    'define_flag' => 0,
 895                    'compile' => '$(LEX) $(LFLAGS) $(AM_LFLAGS)',
 896                    'compiler' => 'LEXCOMPILE',
 897                    'extensions' => ['.l++', '.ll', '.lxx', '.lpp'],
 898                    '_finish' => \&lang_lex_finish);
 899
 900 # Assembler.
 901 register_language ('name' => 'asm',
 902                    'Name' => 'Assembler',
 903                    'config_vars' => ['CCAS', 'CCASFLAGS'],
 904
 905                    'flags' => 'CCASFLAGS',
 906                    # Users can set AM_ASFLAGS to includes DEFS, INCLUDES,
 907                    # or anything else required.  They can also set AS.
 908                    'compile' => '$(CCAS) $(AM_CCASFLAGS) $(CCASFLAGS)',
 909                    'compiler' => 'CCASCOMPILE',
 910                    'compile_flag' => '-c',
 911                    'extensions' => ['.s', '.S'],
 912
 913                    # With assembly we still use the C linker.
 914                    '_finish' => \&lang_c_finish);
 915
 916 # Fortran 77
 917 register_language ('name' => 'f77',
 918                    'Name' => 'Fortran 77',
 919                    'linker' => 'F77LINK',
 920                    'link' => '$(F77LD) $(AM_FFLAGS) $(FFLAGS) $(AM_LDFLAGS) $(LDFLAGS) -o $@',
 921                    'flags' => 'FFLAGS',
 922                    'compile' => '$(F77) $(AM_FFLAGS) $(FFLAGS)',
 923                    'compiler' => 'F77COMPILE',
 924                    'compile_flag' => '-c',
 925                    'output_flag' => '-o',
 926                    'lder' => 'F77LD',
 927                    'ld' => '$(F77)',
 928                    'pure' => 1,
 929                    'extensions' => ['.f', '.for', '.f90']);
 930
 931 # Preprocessed Fortran 77
 932 #
 933 # The current support for preprocessing Fortran 77 just involves
 934 # passing `$(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS)
 935 # $(CPPFLAGS)' as additional flags to the Fortran 77 compiler, since
 936 # this is how GNU Make does it; see the `GNU Make Manual, Edition 0.51
 937 # for `make' Version 3.76 Beta' (specifically, from info file
 938 # `(make)Catalogue of Rules').
 939 #
 940 # A better approach would be to write an Autoconf test
 941 # (i.e. AC_PROG_FPP) for a Fortran 77 preprocessor, because not all
 942 # Fortran 77 compilers know how to do preprocessing.  The Autoconf
 943 # macro AC_PROG_FPP should test the Fortran 77 compiler first for
 944 # preprocessing capabilities, and then fall back on cpp (if cpp were
 945 # available).
 946 register_language ('name' => 'ppf77',
 947                    'Name' => 'Preprocessed Fortran 77',
 948                    'config_vars' => ['F77'],
 949                    'linker' => 'F77LINK',
 950                    'link' => '$(F77LD) $(AM_FFLAGS) $(FFLAGS) $(AM_LDFLAGS) $(LDFLAGS) -o $@',
 951                    'lder' => 'F77LD',
 952                    'ld' => '$(F77)',
 953                    'flags' => 'FFLAGS',
 954                    'compiler' => 'PPF77COMPILE',
 955                    'compile' => '$(F77) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_FFLAGS) $(FFLAGS)',
 956                    'compile_flag' => '-c',
 957                    'output_flag' => '-o',
 958                    'pure' => 1,
 959                    'extensions' => ['.F']);
 960
 961 # Ratfor.
 962 register_language ('name' => 'ratfor',
 963                    'Name' => 'Ratfor',
 964                    'config_vars' => ['F77'],
 965                    'linker' => 'F77LINK',
 966                    'link' => '$(F77LD) $(AM_FFLAGS) $(FFLAGS) $(AM_LDFLAGS) $(LDFLAGS) -o $@',
 967                    'lder' => 'F77LD',
 968                    'ld' => '$(F77)',
 969                    'flags' => 'RFLAGS',
 970                    # FIXME also FFLAGS.
 971                    'compile' => '$(F77) $(AM_FFLAGS) $(FFLAGS) $(AM_RFLAGS) $(RFLAGS)',
 972                    'compiler' => 'RCOMPILE',
 973                    'compile_flag' => '-c',
 974                    'output_flag' => '-o',
 975                    'pure' => 1,
 976                    'extensions' => ['.r']);
 977
 978 # Java via gcj.
 979 register_language ('name' => 'java',
 980                    'Name' => 'Java',
 981                    'config_vars' => ['GCJ'],
 982                    'linker' => 'GCJLINK',
 983                    'link' => '$(GCJLD) $(AM_GCJFLAGS) $(GCJFLAGS) $(AM_LDFLAGS) $(LDFLAGS) -o $@',
 984                    'autodep' => 'GCJ',
 985                    'flags' => 'GCJFLAGS',
 986                    'compile' => '$(GCJ) $(AM_GCJFLAGS) $(GCJFLAGS)',
 987                    'compiler' => 'GCJCOMPILE',
 988                    'compile_flag' => '-c',
 989                    'output_flag' => '-o',
 990                    'lder' => 'GCJLD',
 991                    'ld' => '$(GCJ)',
 992                    'pure' => 1,
 993                    'extensions' => ['.java', '.class', '.zip', '.jar']);
 994
 995 ################################################################
 996
 997 # Parse command line.
 998 &parse_arguments;
 999
1000 # Do configure.ac scan only once.
1001 &scan_autoconf_files;
1002
1003 die "$me: no `Makefile.am' found or specified\n"
1004     if ! @input_files;
1005
1006 my $automake_has_run = 0;
1007
1008 do
1009 {
1010     if ($automake_has_run)
1011     {
1012         print "$me: processing Makefiles another time to fix them up.\n";
1013         &prog_error ("running more than two times should never be needed.")
1014             if $automake_has_run >= 2;
1015     }
1016     $automake_needs_to_reprocess_all_files = 0;
1017
1018     # Now do all the work on each file.
1019     # This guy must be local otherwise it's private to the loop.
1020     use vars '$am_file';
1021     local $am_file;
1022     foreach $am_file (@input_files)
1023     {
1024         if (! -f ($am_file . '.am'))
1025         {
1026             &am_error ("`" . $am_file . ".am' does not exist");
1027         }
1028         else
1029         {
1030             &generate_makefile ($output_files{$am_file}, $am_file);
1031         }
1032     }
1033     ++$automake_has_run;
1034 }
1035 while ($automake_needs_to_reprocess_all_files);
1036
1037 exit $exit_status;
1038
1039 # FIXME: This should be `my'ed next to its subs.
1040 use vars '%require_file_found';
1041
1042 ################################################################
1043
1044 # prog_error (@PRINT-ME)
1045 # ----------------------
1046 # Signal a programming error, display PRINT-ME, and exit 1.
1047 sub prog_error (@)
1048 {
1049     print STDERR "$me: programming error: @_\n";
1050     exit 1;
1051 }
1052
1053
1054 # subst ($TEXT)
1055 # -------------
1056 # Return a configure-style substitution using the indicated text.
1057 # We do this to avoid having the substitutions directly in automake.in;
1058 # when we do that they are sometimes removed and this causes confusion
1059 # and bugs.
1060 sub subst ($)
1061 {
1062     my ($text) = @_;
1063     return '@' . $text . '@';
1064 }
1065
1066 ################################################################
1067
1068
1069 # $BACKPATH
1070 # &backname ($REL-DIR)
1071 # --------------------
1072 # If I `cd $REL-DIR', then to come back, I should `cd $BACKPATH'.
1073 # For instance `src/foo' => `../..'.
1074 # Works with non strictly increasing paths, i.e., `src/../lib' => `..'.
1075 sub backname ($)
1076 {
1077     my ($file) = @_;
1078     my @res;
1079     foreach (split (/\//, $file))
1080     {
1081         next if $_ eq '.' || $_ eq '';
1082         if ($_ eq '..')
1083         {
1084             pop @res;
1085         }
1086         else
1087         {
1088             push (@res, '..');
1089         }
1090     }
1091     return join ('/', @res) || '.';
1092 }
1093
1094 ################################################################
1095
1096 # Pattern that matches all know input extensions (i.e. extensions used
1097 # by the languages supported by Automake).  Using this pattern
1098 # (instead of `\..*$') to match extensions allows Automake to support
1099 # dot-less extensions.
1100 my $KNOWN_EXTENSIONS_PATTERN = "";
1101 my @known_extensions_list = ();
1102
1103 # accept_extensions (@EXTS)
1104 # -------------------------
1105 # Update $KNOWN_EXTENSIONS_PATTERN to recognize the extensions
1106 # listed @EXTS.  Extensions should contain a dot if needed.
1107 sub accept_extensions (@)
1108 {
1109     push @known_extensions_list, @_;
1110     $KNOWN_EXTENSIONS_PATTERN =
1111         '(?:' . join ('|', map (quotemeta, @known_extensions_list)) . ')';
1112 }
1113
1114 # var_SUFFIXES_trigger ($TYPE, $VALUE)
1115 # ------------------------------------
1116 # This is called automagically by define_macro() when SUFFIXES
1117 # is defined ($TYPE eq '') or appended ($TYPE eq '+').
1118 # The work here needs to be performed as a side-effect of the
1119 # define_macro() call because SUFFIXES definitions impact
1120 # on $KNOWN_EXTENSIONS_PATTERN, and $KNOWN_EXTENSIONS_PATTERN
1121 # are used when parsing the input am file.
1122 sub var_SUFFIXES_trigger ($$)
1123 {
1124     my ($type, $value) = @_;
1125     accept_extensions (split (' ', $value));
1126 }
1127
1128 ################################################################
1129
1130 # Parse command line.
1131 sub parse_arguments ()
1132 {
1133     # Start off as gnu.
1134     &set_strictness ('gnu');
1135
1136     use Getopt::Long;
1137     Getopt::Long::config ("bundling", "pass_through");
1138     Getopt::Long::GetOptions
1139       (
1140        'version'        => \&version,
1141        'help'           => \&usage,
1142        'libdir:s'       => \$libdir,
1143        'gnu'            => sub { &set_strictness ('gnu'); },
1144        'gnits'          => sub { &set_strictness ('gnits'); },
1145        'cygnus'         => \$cygnus_mode,
1146        'foreign'        => sub { &set_strictness ('foreign'); },
1147        'include-deps'   => sub { $cmdline_use_dependencies = 1; },
1148        'i|ignore-deps'  => sub { $cmdline_use_dependencies = 0; },
1149        'no-force'       => sub { $force_generation = 0; },
1150        'f|force-missing'=> \$force_missing,
1151        'o|output-dir:s' => \$output_directory,
1152        'a|add-missing'  => \$add_missing,
1153        'c|copy'         => \$copy_missing,
1154        'v|verbose'      => \$verbose,
1155        'Werror'         => sub { $SIG{"__WARN__"} = sub { die $_[0] } },
1156        'Wno-error'      => sub { $SIG{"__WARN__"} = 'DEFAULT' }
1157       )
1158         or exit 1;
1159
1160     if (defined $output_directory)
1161     {
1162         print STDERR "$0: `--output-dir' is deprecated\n";
1163     }
1164     else
1165     {
1166         # In the next release we'll remove this entirely.
1167         $output_directory = '.';
1168     }
1169
1170     foreach my $arg (@ARGV)
1171     {
1172       if ($arg =~ /^-./)
1173         {
1174           print STDERR "$0: unrecognized option `$arg'\n";
1175           print STDERR "Try `$0 --help' for more information.\n";
1176           exit (1);
1177         }
1178
1179       # Handle $local:$input syntax.  Note that we only examine the
1180       # first ":" file to see if it is automake input; the rest are
1181       # just taken verbatim.  We still keep all the files around for
1182       # dependency checking, however.
1183       my ($local, $input, @rest) = split (/:/, $arg);
1184       if (! $input)
1185         {
1186           $input = $local;
1187         }
1188       else
1189         {
1190           # Strip .in; later on .am is tacked on.  That is how the
1191           # automake input file is found.  Maybe not the best way, but
1192           # it is easy to explain.
1193           $input =~ s/\.in$//
1194             or die "$me: invalid input file name `$arg'\n.";
1195         }
1196       push (@input_files, $input);
1197       $output_files{$input} = join (':', ($local, @rest));
1198     }
1199
1200     # Take global strictness from whatever we currently have set.
1201     $default_strictness = $strictness;
1202     $default_strictness_name = $strictness_name;
1203 }
1204
1205 ################################################################
1206
1207 # Generate a Makefile.in given the name of the corresponding Makefile and
1208 # the name of the file output by config.status.
1209 sub generate_makefile
1210 {
1211     my ($output, $makefile) = @_;
1212
1213     # Reset all the Makefile.am related variables.
1214     &initialize_per_input;
1215
1216     # Name of input file ("Makefile.am") and output file
1217     # ("Makefile.in").  These have no directory components.
1218     $am_file_name = basename ($makefile) . '.am';
1219     $in_file_name = basename ($makefile) . '.in';
1220
1221     # $OUTPUT is encoded.  If it contains a ":" then the first element
1222     # is the real output file, and all remaining elements are input
1223     # files.  We don't scan or otherwise deal with these input file,
1224     # other than to mark them as dependencies.  See
1225     # &scan_autoconf_files for details.
1226     my (@secondary_inputs);
1227     ($output, @secondary_inputs) = split (/:/, $output);
1228
1229     $relative_dir = dirname ($output);
1230     $am_relative_dir = dirname ($makefile);
1231
1232     &read_main_am_file ($makefile . '.am');
1233     if (&handle_options)
1234     {
1235         # Fatal error.  Just return, so we can continue with next file.
1236         return;
1237     }
1238
1239     # There are a few install-related variables that you should not define.
1240     foreach my $var ('PRE_INSTALL', 'POST_INSTALL', 'NORMAL_INSTALL')
1241     {
1242         if (variable_defined ($var) && !$var_is_am{$var})
1243         {
1244             macro_error ($var, "`$var' should not be defined");
1245         }
1246     }
1247
1248     &handle_libtool;
1249
1250     # At the toplevel directory, we might need config.guess, config.sub
1251     # or libtool scripts (ltconfig and ltmain.sh).
1252     if ($relative_dir eq '.')
1253     {
1254         # AC_CANONICAL_HOST and AC_CANONICAL_SYSTEM need config.guess and
1255         # config.sub.
1256         require_conf_file ($canonical_location, FOREIGN,
1257                            'config.guess', 'config.sub')
1258           if $seen_canonical;
1259     }
1260
1261     # We still need Makefile.in here, because sometimes the `dist'
1262     # target doesn't re-run automake.
1263     if ($am_relative_dir eq $relative_dir)
1264     {
1265         # Only distribute the files if they are in the same subdir as
1266         # the generated makefile.
1267         &push_dist_common ($in_file_name, $am_file_name);
1268     }
1269
1270     push (@sources, '$(SOURCES)')
1271         if variable_defined ('SOURCES');
1272
1273     # Must do this after reading .am file.  See read_main_am_file to
1274     # understand weird tricks we play there with variables.
1275     &define_variable ('subdir', $relative_dir);
1276
1277     # Check first, because we might modify some state.
1278     &check_cygnus;
1279     &check_gnu_standards;
1280     &check_gnits_standards;
1281
1282     &handle_configure ($output, $makefile, @secondary_inputs);
1283     &handle_gettext;
1284     &handle_libraries;
1285     &handle_ltlibraries;
1286     &handle_programs;
1287     &handle_scripts;
1288
1289     # This must run first so that the ANSI2KNR definition is generated
1290     # before it is used by the _.c rules.  We have to do this because
1291     # a variable which is used in a dependency must be defined before
1292     # the target, or else make won't properly see it.
1293     &handle_compile;
1294     # This must be run after all the sources are scanned.
1295     &handle_languages;
1296
1297     # Re-init SOURCES.  FIXME: other code shouldn't depend on this
1298     # (but currently does).
1299     macro_define ('SOURCES', 1, '', 'TRUE', "@sources", 'internal');
1300     define_pretty_variable ('DIST_SOURCES', '', @dist_sources);
1301
1302     &handle_multilib;
1303     &handle_texinfo;
1304     &handle_emacs_lisp;
1305     &handle_python;
1306     &handle_java;
1307     &handle_man_pages;
1308     &handle_data;
1309     &handle_headers;
1310     &handle_subdirs;
1311     &handle_tags;
1312     &handle_minor_options;
1313     &handle_tests;
1314
1315     # This must come after most other rules.
1316     &handle_dist ($makefile);
1317
1318     &handle_footer;
1319     &do_check_merge_target;
1320     &handle_all ($output);
1321
1322     # FIXME: Gross!
1323     if (variable_defined ('lib_LTLIBRARIES') &&
1324         variable_defined ('bin_PROGRAMS'))
1325     {
1326         $output_rules .= "install-binPROGRAMS: install-libLTLIBRARIES\n\n";
1327     }
1328
1329     &handle_installdirs;
1330     &handle_clean;
1331     &handle_factored_dependencies;
1332
1333     check_typos ();
1334
1335     if (! -d ($output_directory . '/' . $am_relative_dir))
1336     {
1337         mkdir ($output_directory . '/' . $am_relative_dir, 0755);
1338     }
1339
1340     my ($out_file) = $output_directory . '/' . $makefile . ".in";
1341     if (! $force_generation && -e $out_file)
1342     {
1343         my ($am_time) = (stat ($makefile . '.am'))[9];
1344         my ($in_time) = (stat ($out_file))[9];
1345         # FIXME: should cache these times.
1346         my ($conf_time) = (stat ($configure_ac))[9];
1347         # FIXME: how to do unsigned comparison?
1348         if ($am_time < $in_time || $am_time < $conf_time)
1349         {
1350             # No need to update.
1351             return;
1352         }
1353         if (-f 'aclocal.m4')
1354         {
1355             my ($acl_time) = (stat _)[9];
1356             return if ($am_time < $acl_time);
1357         }
1358     }
1359
1360     if (-e "$out_file")
1361     {
1362         unlink ($out_file)
1363             or die "$me: cannot remove $out_file: $!\n";
1364     }
1365     my $gm_file = new Automake::XFile "> $out_file";
1366     verbose "creating ", $makefile, ".in";
1367
1368     print $gm_file $output_vars;
1369     # We make sure that `all:' is the first target.
1370     print $gm_file $output_all;
1371     print $gm_file $output_header;
1372     print $gm_file $output_rules;
1373     print $gm_file $output_trailer;
1374 }
1375
1376 ################################################################
1377
1378 # A helper which handles the logic of requiring a version number in
1379 # AUTOMAKE_OPTIONS.  Return 1 on error, 0 on success.
1380 sub version_check ($$$$)
1381 {
1382     my ($rmajor, $rminor, $ralpha, $rfork) = ($1, $2, $3, $4);
1383
1384     prog_error ("version is incorrect: $VERSION")
1385         if $VERSION !~ /(\d+)\.(\d+)([a-z]?)-?([A-Za-z0-9]+)?/;
1386
1387     my ($tmajor, $tminor, $talpha, $tfork) = ($1, $2, $3, $4);
1388
1389     $rfork ||= '';
1390     $tfork ||= '';
1391
1392     my $rminorminor = 0;
1393     my $tminorminor = 0;
1394
1395     # Some versions were labelled like `1.4-p3a'.  This is the same as
1396     # an alpha release labelled `1.4.3a'.  However, a version like
1397     # `1.4g' is the same as `1.4.99g'.  Yes, this sucks.  Moral:
1398     # always listen to the users.
1399     if ($rfork =~ /p([0-9]+)([a-z]?)/)
1400     {
1401         $rminorminor = $1;
1402         # `1.4a-p3b' never existed.  But we'll accept it anyway.
1403         $ralpha = $ralpha || $2 || '';
1404         $rfork = '';
1405     }
1406     if ($tfork =~ /p([0-9]+)([a-z]?)/)
1407     {
1408         $tminorminor = $1;
1409         # `1.4a-p3b' never existed.  But we'll accept it anyway.
1410         $talpha = $talpha || $2 || '';
1411         $tfork = '';
1412     }
1413
1414     $rminorminor = 99 if $ralpha ne '' && $rminorminor == 0;
1415     $tminorminor = 99 if $talpha ne '' && $tminorminor == 0;
1416
1417     # 2.0 is better than 1.0.
1418     # 1.2 is better than 1.1.
1419     # 1.2a is better than 1.2.
1420     # If we require 3.4n-foo then we require something
1421     # >= 3.4n, with the `foo' fork identifier.
1422     # The $r* variables are what the user specified.
1423     # The $t* variables denote automake itself.
1424     if ($rmajor > $tmajor
1425         || ($rmajor == $tmajor && $rminor > $tminor)
1426         || ($rminor == $tminor && $rminor == $tminor
1427             && $rminorminor > $tminorminor)
1428         || ($rminor == $tminor && $rminor == $tminor
1429             && $rminorminor == $tminorminor
1430             && $ralpha gt $talpha)
1431         || ($rfork ne '' && $rfork ne $tfork))
1432     {
1433         return 1;
1434     }
1435
1436     return 0;
1437 }
1438
1439 # $BOOL
1440 # process_option_list ($CONFIG, @OPTIONS)
1441 # ------------------------------
1442 # Process a list of options.  Return 1 on error, 0 otherwise.
1443 # This is a helper for handle_options.  CONFIG is true if we're
1444 # handling global options.
1445 sub process_option_list
1446 {
1447     my ($config, @list) = @_;
1448     foreach (@list)
1449     {
1450         $options{$_} = 1;
1451         if ($_ eq 'gnits' || $_ eq 'gnu' || $_ eq 'foreign')
1452         {
1453             &set_strictness ($_);
1454         }
1455         elsif ($_ eq 'cygnus')
1456         {
1457             $cygnus_mode = 1;
1458         }
1459         elsif (/^(.*\/)?ansi2knr$/)
1460         {
1461             # An option like "../lib/ansi2knr" is allowed.  With no
1462             # path prefix, we assume the required programs are in this
1463             # directory.  We save the actual option for later.
1464             $options{'ansi2knr'} = $_;
1465         }
1466         elsif ($_ eq 'no-installman' || $_ eq 'no-installinfo'
1467                || $_ eq 'dist-shar' || $_ eq 'dist-zip'
1468                || $_ eq 'dist-tarZ' || $_ eq 'dist-bzip2'
1469                || $_ eq 'dejagnu' || $_ eq 'no-texinfo.tex'
1470                || $_ eq 'readme-alpha' || $_ eq 'check-news'
1471                || $_ eq 'subdir-objects' || $_ eq 'nostdinc'
1472                || $_ eq 'no-exeext' || $_ eq 'no-define')
1473         {
1474             # Explicitly recognize these.
1475         }
1476         elsif ($_ eq 'no-dependencies')
1477         {
1478             $use_dependencies = 0;
1479         }
1480         elsif (/(\d+)\.(\d+)([a-z]?)(-[A-Za-z0-9]+)?/)
1481         {
1482             # Got a version number.
1483             if (version_check ($1, $2, $3, $4))
1484             {
1485                 if ($config)
1486                 {
1487                     file_error ($seen_init_automake,
1488                                 "require version $_, but have $VERSION");
1489                     # Arrange to process this global option only once, otherwise
1490                     # the error message would be printed for each Makefile.
1491                     $global_options =~ s/(?:^| )$_(?: |$)/ /g;
1492                 }
1493                 else
1494                 {
1495                     macro_error ('AUTOMAKE_OPTIONS',
1496                                  "require version $_, but have $VERSION");
1497                 }
1498                 return 1;
1499             }
1500         }
1501         else
1502         {
1503             if ($config)
1504             {
1505                 file_error ($seen_init_automake,
1506                             "option `" . $_ . "\' not recognized");
1507             }
1508             else
1509             {
1510                 macro_error ('AUTOMAKE_OPTIONS',
1511                              "option `" . $_ . "\' not recognized");
1512             }
1513             return 1;
1514         }
1515     }
1516 }
1517
1518 # Handle AUTOMAKE_OPTIONS variable.  Return 1 on error, 0 otherwise.
1519 sub handle_options
1520 {
1521     # Process global options first so that more specific options can
1522     # override.
1523     if (&process_option_list (1, split (' ', $global_options)))
1524     {
1525         return 1;
1526     }
1527
1528     if (variable_defined ('AUTOMAKE_OPTIONS'))
1529     {
1530         if (&process_option_list (0, &variable_value_as_list_recursive ('AUTOMAKE_OPTIONS', '')))
1531         {
1532             return 1;
1533         }
1534     }
1535
1536     if ($strictness == GNITS)
1537     {
1538         $options{'readme-alpha'} = 1;
1539         $options{'check-news'} = 1;
1540     }
1541
1542     return 0;
1543 }
1544
1545
1546 # get_object_extension ($OUT)
1547 # ---------------------------
1548 # Return object extension.  Just once, put some code into the output.
1549 # OUT is the name of the output file
1550 sub get_object_extension
1551 {
1552     my ($out) = @_;
1553
1554     # Maybe require libtool library object files.
1555     my $extension = '.$(OBJEXT)';
1556     $extension = '.lo' if ($out =~ /\.la$/);
1557
1558     # Check for automatic de-ANSI-fication.
1559     $extension = '$U' . $extension
1560       if defined $options{'ansi2knr'};
1561
1562     $get_object_extension_was_run = 1;
1563
1564     return $extension;
1565 }
1566
1567
1568 # Call finish function for each language that was used.
1569 sub handle_languages
1570 {
1571     if ($use_dependencies)
1572     {
1573         # Include auto-dep code.  Don't include it if DEP_FILES would
1574         # be empty.
1575         if (&saw_sources_p (0) && keys %dep_files)
1576         {
1577             # Set location of depcomp.
1578             &define_variable ('depcomp', "\$(SHELL) $config_aux_dir/depcomp");
1579             &define_variable ('am__depfiles_maybe', 'depfiles');
1580
1581             require_conf_file ("$am_file.am", FOREIGN, 'depcomp');
1582
1583             my @deplist = sort keys %dep_files;
1584
1585             # We define this as a conditional variable because BSD
1586             # make can't handle backslashes for continuing comments on
1587             # the following line.
1588             define_pretty_variable ('DEP_FILES', 'AMDEP_TRUE', @deplist);
1589
1590             # Generate each `include' individually.  Irix 6 make will
1591             # not properly include several files resulting from a
1592             # variable expansion; generating many separate includes
1593             # seems safest.
1594             $output_rules .= "\n";
1595             foreach my $iter (@deplist)
1596             {
1597                 $output_rules .= (subst ('AMDEP_TRUE')
1598                                   . subst ('am__include')
1599                                   . ' '
1600                                   . subst ('am__quote')
1601                                   . $iter
1602                                   . subst ('am__quote')
1603                                   . "\n");
1604             }
1605
1606             # Compute the set of directories to remove in distclean-depend.
1607             my @depdirs = uniq (map { dirname ($_) } @deplist);
1608             $output_rules .= &file_contents ('depend',
1609                                              DEPDIRS => "@depdirs");
1610         }
1611     }
1612     else
1613     {
1614         &define_variable ('depcomp', '');
1615         &define_variable ('am__depfiles_maybe', '');
1616     }
1617
1618     my %done;
1619
1620     # Is the c linker needed?
1621     my $needs_c = 0;
1622     foreach my $ext (sort keys %extension_seen)
1623     {
1624         next unless $extension_map{$ext};
1625
1626         my $lang = $languages{$extension_map{$ext}};
1627
1628         my $rule_file = $lang->rule_file || 'depend2';
1629
1630         # Get information on $LANG.
1631         my $pfx = $lang->autodep;
1632         my $fpfx = ($pfx eq '') ? 'CC' : $pfx;
1633
1634         my $AMDEP = (($use_dependencies && $lang->autodep ne 'no')
1635                      ? 'AMDEP' : 'FALSE');
1636
1637         my %transform = ('EXT'     => $ext,
1638                          'PFX'     => $pfx,
1639                          'FPFX'    => $fpfx,
1640                          'LIBTOOL' => defined $seen_libtool,
1641                          'AMDEP'   => $AMDEP,
1642                          '-c'      => $lang->compile_flag || '',
1643                          'MORE-THAN-ONE'
1644                                    => (count_files_for_language ($lang->name) > 1));
1645
1646         # Generate the appropriate rules for this extension.
1647         if (($use_dependencies && $lang->autodep ne 'no')
1648             || defined $lang->compile)
1649         {
1650             # Some C compilers don't support -c -o.  Use it only if really
1651             # needed.
1652             my $output_flag = $lang->output_flag || '';
1653             $output_flag = '-o'
1654               if (! $output_flag
1655                   && $lang->flags eq 'CFLAGS'
1656                   && defined $options{'subdir-objects'});
1657
1658             # FIXME: this is a temporary hack to compute a possible
1659             # derived extension.  This is not used by depend2.am.
1660             (my $der_ext = $ext) =~ tr/yl/cc/;
1661
1662             # Another yacc/lex hack.
1663             my $destfile = '$*' . $der_ext;
1664
1665             $output_rules .=
1666               file_contents ($rule_file,
1667                              %transform,
1668                              'GENERIC'   => 1,
1669
1670                              'DERIVED-EXT' => $der_ext,
1671
1672                              # In this situation we know that the
1673                              # object is in this directory, so
1674                              # $(DEPDIR) is the correct location for
1675                              # dependencies.
1676                              'DEPBASE'   => '$(DEPDIR)/$*',
1677                              'BASE'      => '$*',
1678                              'SOURCE'    => '$<',
1679                              'OBJ'       => '$@',
1680                              'OBJOBJ'    => '$@',
1681                              'LTOBJ'     => '$@',
1682
1683                              'COMPILE'   => '$(' . $lang->compiler . ')',
1684                              'LTCOMPILE' => '$(LT' . $lang->compiler . ')',
1685                              '-o'        => $output_flag);
1686         }
1687
1688         # Now include code for each specially handled object with this
1689         # language.
1690         my %seen_files = ();
1691         foreach my $file (@{$lang_specific_files{$lang->name}})
1692         {
1693             my ($derived, $source, $obj, $myext) = split (' ', $file);
1694
1695             # For any specially-generated object, we must respect the
1696             # ansi2knr setting so that we don't inadvertently try to
1697             # use the default rule.
1698             if ($lang->ansi && defined $options{'ansi2knr'})
1699             {
1700                 $myext = '$U' . $myext;
1701             }
1702
1703             # We might see a given object twice, for instance if it is
1704             # used under different conditions.
1705             next if defined $seen_files{$obj};
1706             $seen_files{$obj} = 1;
1707
1708             my $flags = $lang->flags || '';
1709             my $val = "${derived}_${flags}";
1710
1711             prog_error ("found $lang->name in handle_languages, but compiler not defined")
1712                 unless defined $lang->compile;
1713
1714             (my $obj_compile = $lang->compile) =~ s/\(AM_$flags/\($val/;
1715             my $obj_ltcompile = '$(LIBTOOL) --mode=compile ' . $obj_compile;
1716
1717             # We _need_ `-o' for per object rules.
1718             my $output_flag = $lang->output_flag || '-o';
1719
1720             my $depbase = dirname ($obj);
1721             $depbase = ''
1722                 if $depbase eq '.';
1723             $depbase .= '/'
1724                 unless $depbase eq '';
1725             $depbase .= '$(DEPDIR)/' . basename ($obj);
1726
1727             # Generate a transform which will turn suffix targets in
1728             # depend2.am into real targets for the particular objects we
1729             # are building.
1730             $output_rules .=
1731               file_contents ($rule_file,
1732                              (%transform,
1733                               'GENERIC'   => 0,
1734
1735                               'DEPBASE'   => $depbase,
1736                               'BASE'      => $obj,
1737                               'SOURCE'    => $source,
1738                               # Use $myext and not `.o' here, in case
1739                               # we are actually building a new source
1740                               # file -- e.g. via yacc.
1741                               'OBJ'       => "$obj$myext",
1742                               'OBJOBJ'    => "$obj.obj",
1743                               'LTOBJ'     => "$obj.lo",
1744
1745                               'COMPILE'   => $obj_compile,
1746                               'LTCOMPILE' => $obj_ltcompile,
1747                               '-o'        => $output_flag));
1748         }
1749
1750         # The rest of the loop is done once per language.
1751         next if defined $done{$lang};
1752         $done{$lang} = 1;
1753
1754         # Load the language dependent Makefile chunks.
1755         my %lang = map { uc ($_) => 0 } keys %languages;
1756         $lang{uc ($lang->name)} = 1;
1757         $output_rules .= file_contents ('lang-compile', %transform, %lang);
1758
1759         # If the source to a program consists entirely of code from a
1760         # `pure' language, for instance C++ for Fortran 77, then we
1761         # don't need the C compiler code.  However if we run into
1762         # something unusual then we do generate the C code.  There are
1763         # probably corner cases here that do not work properly.
1764         # People linking Java code to Fortran code deserve pain.
1765         $needs_c ||= ! $lang->pure;
1766
1767         define_compiler_variable ($lang)
1768           if ($lang->compile);
1769
1770         define_linker_variable ($lang)
1771           if ($lang->link);
1772
1773         foreach my $var (@{$lang->config_vars})
1774           {
1775             am_error ($lang->Name
1776                       . " source seen but `$var' not defined in"
1777                       . " `$configure_ac'")
1778               if !exists $configure_vars{$var};
1779           }
1780
1781         # The compiler's flag must be a configure variable.
1782         define_configure_variable ($lang->flags)
1783             if defined $lang->flags && $lang->define_flag;
1784
1785         # Call the finisher.
1786         $lang->finish;
1787     }
1788
1789     # If the project is entirely C++ or entirely Fortran 77 (i.e., 1
1790     # suffix rule was learned), don't bother with the C stuff.  But if
1791     # anything else creeps in, then use it.
1792     $needs_c = 1
1793       if $need_link || scalar keys %suffix_rules > 1;
1794
1795     if ($needs_c)
1796       {
1797         if (! defined $done{$languages{'c'}})
1798           {
1799             &define_configure_variable ($languages{'c'}->flags);
1800             &define_compiler_variable ($languages{'c'});
1801           }
1802         define_linker_variable ($languages{'c'});
1803       }
1804 }
1805
1806 # Check to make sure a source defined in LIBOBJS is not explicitly
1807 # mentioned.  This is a separate function (as opposed to being inlined
1808 # in handle_source_transform) because it isn't always appropriate to
1809 # do this check.
1810 sub check_libobjs_sources
1811 {
1812     my ($one_file, $unxformed) = @_;
1813
1814     foreach my $prefix ('', 'EXTRA_', 'dist_', 'nodist_',
1815                         'dist_EXTRA_', 'nodist_EXTRA_')
1816     {
1817         my @files;
1818         if (variable_defined ($prefix . $one_file . '_SOURCES'))
1819         {
1820             @files = &variable_value_as_list_recursive (
1821                                 ($prefix . $one_file . '_SOURCES'),
1822                                 'all');
1823         }
1824         elsif ($prefix eq '')
1825         {
1826             @files = ($unxformed . '.c');
1827         }
1828         else
1829         {
1830             next;
1831         }
1832
1833         foreach my $file (@files)
1834         {
1835           macro_error ($prefix . $one_file . '_SOURCES',
1836                        "automatically discovered file `$file' should not be explicitly mentioned")
1837             if defined $libsources{$file};
1838         }
1839     }
1840 }
1841
1842
1843 # @OBJECTS
1844 # handle_single_transform_list ($VAR, $TOPPARENT, $DERIVED, $OBJ, @FILES)
1845 # -----------------------------------------------------------------------
1846 # Does much of the actual work for handle_source_transform.
1847 # Arguments are:
1848 #   $VAR is the name of the variable that the source filenames come from
1849 #   $TOPPARENT is the name of the _SOURCES variable which is being processed
1850 #   $DERIVED is the name of resulting executable or library
1851 #   $OBJ is the object extension (e.g., `$U.lo')
1852 #   @FILES is the list of source files to transform
1853 # Result is a list of the names of objects
1854 # %linkers_used will be updated with any linkers needed
1855 sub handle_single_transform_list ($$$$@)
1856 {
1857     my ($var, $topparent, $derived, $obj, @files) = @_;
1858     my @result = ();
1859     my $nonansi_obj = $obj;
1860     $nonansi_obj =~ s/\$U//g;
1861
1862     # Turn sources into objects.  We use a while loop like this
1863     # because we might add to @files in the loop.
1864     while (scalar @files > 0)
1865     {
1866         $_ = shift @files;
1867
1868         # Configure substitutions in _SOURCES variables are errors.
1869         if (/^\@.*\@$/)
1870         {
1871             macro_error ($var,
1872                          "`$var' includes configure substitution `$_', and is referred to from `$topparent': configure substitutions not allowed in _SOURCES variables");
1873             next;
1874         }
1875
1876         # If the source file is in a subdirectory then the `.o' is put
1877         # into the current directory, unless the subdir-objects option
1878         # is in effect.
1879
1880         # Split file name into base and extension.
1881         next if ! /^(?:(.*)\/)?([^\/]*)($KNOWN_EXTENSIONS_PATTERN)$/;
1882         my $full = $_;
1883         my $directory = $1 || '';
1884         my $base = $2;
1885         my $extension = $3;
1886
1887         # We must generate a rule for the object if it requires its own flags.
1888         my $renamed = 0;
1889         my ($linker, $object);
1890
1891         # This records whether we've seen a derived source file (eg,
1892         # yacc output).
1893         my $derived_source = 0;
1894
1895         # This holds the `aggregate context' of the file we are
1896         # currently examining.  If the file is compiled with
1897         # per-object flags, then it will be the name of the object.
1898         # Otherwise it will be `AM'.  This is used by the target hook
1899         # language function.
1900         my $aggregate = 'AM';
1901
1902         $extension = &derive_suffix ($extension, $nonansi_obj);
1903         my $lang;
1904         if ($extension_map{$extension} &&
1905             ($lang = $languages{$extension_map{$extension}}))
1906         {
1907             # Found the language, so see what it says.
1908             &saw_extension ($extension);
1909
1910             # Note: computed subr call.  The language rewrite function
1911             # should return one of the $LANG_* constants.  It could
1912             # also return a list whose first value is such a constant
1913             # and whose second value is a new source extension which
1914             # should be applied.  This means this particular language
1915             # generates another source file which we must then process
1916             # further.
1917             my $subr = 'lang_' . $lang->name . '_rewrite';
1918             my ($r, $source_extension)
1919                 = & $subr ($directory, $base, $extension);
1920             # Skip this entry if we were asked not to process it.
1921             next if $r == $LANG_IGNORE;
1922
1923             # Now extract linker and other info.
1924             $linker = $lang->linker;
1925
1926             my $this_obj_ext;
1927             if (defined $source_extension)
1928             {
1929                 $this_obj_ext = $source_extension;
1930                 $derived_source = 1;
1931             }
1932             elsif ($lang->ansi)
1933             {
1934                 $this_obj_ext = $obj;
1935             }
1936             else
1937             {
1938                 $this_obj_ext = $nonansi_obj;
1939             }
1940             $object = $base . $this_obj_ext;
1941
1942             if (defined $lang->flags
1943                 && variable_defined ($derived . '_' . $lang->flags))
1944             {
1945                 # We have a per-executable flag in effect for this
1946                 # object.  In this case we rewrite the object's
1947                 # name to ensure it is unique.  We also require
1948                 # the `compile' program to deal with compilers
1949                 # where `-c -o' does not work.
1950
1951                 # We choose the name `DERIVED_OBJECT' to ensure
1952                 # (1) uniqueness, and (2) continuity between
1953                 # invocations.  However, this will result in a
1954                 # name that is too long for losing systems, in
1955                 # some situations.  So we provide _SHORTNAME to
1956                 # override.
1957
1958                 my $dname = $derived;
1959                 if (variable_defined ($derived . '_SHORTNAME'))
1960                 {
1961                     # FIXME: should use the same conditional as
1962                     # the _SOURCES variable.  But this is really
1963                     # silly overkill -- nobody should have
1964                     # conditional shortnames.
1965                     $dname = &variable_value ($derived . '_SHORTNAME');
1966                 }
1967                 $object = $dname . '-' . $object;
1968
1969                 require_conf_file ("$am_file.am", FOREIGN, 'compile')
1970                     if $lang->name eq 'c';
1971
1972                 prog_error ("$lang->name flags defined without compiler")
1973                     if ! defined $lang->compile;
1974
1975                 $renamed = 1;
1976             }
1977
1978             # If rewrite said it was ok, put the object into a
1979             # subdir.
1980             if ($r == $LANG_SUBDIR && $directory ne '')
1981             {
1982                 $object = $directory . '/' . $object;
1983             }
1984
1985             # If doing dependency tracking, then we can't print
1986             # the rule.  If we have a subdir object, we need to
1987             # generate an explicit rule.  Actually, in any case
1988             # where the object is not in `.' we need a special
1989             # rule.  The per-object rules in this case are
1990             # generated later, by handle_languages.
1991             if ($renamed || $directory ne '')
1992             {
1993                 my $obj_sans_ext = substr ($object, 0,
1994                                            - length ($this_obj_ext));
1995                 my $val = ("$full $obj_sans_ext "
1996                            # Only use $this_obj_ext in the derived
1997                            # source case because in the other case we
1998                            # *don't* want $(OBJEXT) to appear here.
1999                            . ($derived_source ? $this_obj_ext : '.o'));
2000
2001                 # If we renamed the object then we want to use the
2002                 # per-executable flag name.  But if this is simply a
2003                 # subdir build then we still want to use the AM_ flag
2004                 # name.
2005                 if ($renamed)
2006                 {
2007                     $val = "$derived $val";
2008                     $aggregate = $derived;
2009                 }
2010                 else
2011                 {
2012                     $val = "AM $val";
2013                 }
2014
2015                 # Each item on this list is a string consisting of
2016                 # four space-separated values: the derived flag prefix
2017                 # (eg, for `foo_CFLAGS', it is `foo'), the name of the
2018                 # source file, the base name of the output file, and
2019                 # the extension for the object file.
2020                 push (@{$lang_specific_files{$lang->name}}, $val);
2021             }
2022         }
2023         elsif ($extension eq $nonansi_obj)
2024         {
2025             # This is probably the result of a direct suffix rule.
2026             # In this case we just accept the rewrite.
2027             $object = "$base$extension";
2028             $linker = '';
2029         }
2030         else
2031         {
2032             # No error message here.  Used to have one, but it was
2033             # very unpopular.
2034             # FIXME: we could potentially do more processing here,
2035             # perhaps treating the new extension as though it were a
2036             # new source extension (as above).  This would require
2037             # more restructuring than is appropriate right now.
2038             next;
2039         }
2040
2041         if (defined $object_map{$object})
2042         {
2043             if ($object_map{$object} ne $full)
2044             {
2045                 am_error ("object `$object' created by `$full' and `$object_map{$object}'");
2046             }
2047         }
2048
2049         my $comp_val = (($object =~ /\.lo$/)
2050                         ? $COMPILE_LIBTOOL : $COMPILE_ORDINARY);
2051         (my $comp_obj = $object) =~ s/\.lo$/.\$(OBJEXT)/;
2052         if (defined $object_compilation_map{$comp_obj}
2053             && $object_compilation_map{$comp_obj} != 0
2054             # Only see the error once.
2055             && ($object_compilation_map{$comp_obj}
2056                 != ($COMPILE_LIBTOOL | $COMPILE_ORDINARY))
2057             && $object_compilation_map{$comp_obj} != $comp_val)
2058         {
2059             am_error ("object `$object' created both with libtool and without");
2060         }
2061         $object_compilation_map{$comp_obj} |= $comp_val;
2062
2063         if (defined $lang)
2064         {
2065             # Let the language do some special magic if required.
2066             $lang->target_hook ($aggregate, $object, $full);
2067         }
2068
2069         if ($derived_source)
2070         {
2071             prog_error ("$lang->name has automatic dependency tracking")
2072                 if $lang->autodep ne 'no';
2073             # Make sure this new source file is handled next.  That will
2074             # make it appear to be at the right place in the list.
2075             unshift (@files, $object);
2076             # Distribute derived sources unless the source they are
2077             # derived from is not.
2078             &push_dist_common ($object)
2079                 unless ($topparent =~ /^(:?nobase_)?nodist_/);
2080             next;
2081         }
2082
2083         $linkers_used{$linker} = 1;
2084
2085         push (@result, $object);
2086
2087         if (! defined $object_map{$object})
2088         {
2089             my @dep_list = ();
2090             $object_map{$object} = $full;
2091
2092             # If file is in subdirectory, we need explicit
2093             # dependency.
2094             if ($directory ne '' || $renamed)
2095             {
2096                 push (@dep_list, $full);
2097             }
2098
2099             # If resulting object is in subdir, we need to make
2100             # sure the subdir exists at build time.
2101             if ($object =~ /\//)
2102             {
2103                 # FIXME: check that $DIRECTORY is somewhere in the
2104                 # project
2105
2106                 # For Java, the way we're handling it right now, a
2107                 # `..' component doesn't make sense.
2108                 if ($lang->name eq 'java' && $object =~ /(\/|^)\.\.\//)
2109                 {
2110                     am_error ("`$full' contains `..' component but should not");
2111                 }
2112
2113                 # Make sure object is removed by `make mostlyclean'.
2114                 $compile_clean_files{$object} = MOSTLY_CLEAN;
2115
2116                 push (@dep_list, require_build_directory ($directory));
2117
2118                 # If we're generating dependencies, we also want
2119                 # to make sure that the appropriate subdir of the
2120                 # .deps directory is created.
2121                 push (@dep_list,
2122                       require_build_directory ($directory . '/$(DEPDIR)'))
2123                     if $use_dependencies;
2124             }
2125
2126             &pretty_print_rule ($object . ':', "\t", @dep_list)
2127                 if scalar @dep_list > 0;
2128         }
2129
2130         # Transform .o or $o file into .P file (for automatic
2131         # dependency code).
2132         if ($lang && $lang->autodep ne 'no')
2133         {
2134             my $depfile = $object;
2135             $depfile =~ s/\.([^.]*)$/.P$1/;
2136             $depfile =~ s/\$\(OBJEXT\)$/o/;
2137             $dep_files{dirname ($depfile) . '/$(DEPDIR)/'
2138                            . basename ($depfile)} = 1;
2139         }
2140     }
2141
2142     return @result;
2143 }
2144
2145 # $BOOL
2146 # define_objects_from_sources ($VAR, $OBJVAR, $NODEFINE, $ONE_FILE,
2147 #                              $OBJ, $PARENT, $TOPPARENT)
2148 # ---------------------------------------------------------------------
2149 # Define an _OBJECTS variable for a _SOURCES variable (or subvariable)
2150 #
2151 # Arguments are:
2152 #   $VAR is the name of the _SOURCES variable
2153 #   $OBJVAR is the name of the _OBJECTS
2154 #   $NODEFINE is a boolean: if true, $OBJVAR will not be defined (but
2155 #   work done to determine the linker will be).
2156 #   $ONE_FILE is the canonical (transformed) name of object to build
2157 #   $OBJ is the object extension (ie either `.o' or `.lo').
2158 #   $PARENT is the variable in which $VAR is used, or $VAR if not applicable.
2159 #   $TOPPARENT is the _SOURCES variable being processed.
2160 #
2161 # Result is a boolean, true if a linker is needed to deal with the objects.
2162 #
2163 # %linkers_used, %vars_scanned, @substfroms and @substtos should be cleared
2164 # before use:
2165 #   %linkers_used variable will be set to contain the linkers desired.
2166 #   %vars_scanned will be used to check for recursive definitions.
2167 #   @substfroms and @substtos will be used to keep a stack of variable
2168 #   substitutions to be applied.
2169 #
2170 sub define_objects_from_sources ($$$$$$$)
2171 {
2172     my ($var, $objvar, $nodefine, $one_file, $obj, $parent, $topparent) = @_;
2173
2174     if (defined $vars_scanned{$var})
2175     {
2176         macro_error ($var, "variable `$var' recursively defined");
2177         return "";
2178     }
2179     $vars_scanned{$var} = 1;
2180
2181     my $needlinker = "";
2182     foreach my $cond (variable_conditions ($var))
2183     {
2184         my @result;
2185         foreach my $val (&variable_value_as_list ($var, $cond, $parent))
2186         {
2187             # If $val is a variable (i.e. ${foo} or $(bar), not a filename),
2188             # handle the sub variable recursively.
2189             if ($val =~ /^\$\{([^}]*)\}$/ || $val =~ /^\$\(([^)]*)\)$/)
2190             {
2191                 my $subvar = $1;
2192
2193                 # If the user uses a losing variable name, just ignore it.
2194                 # This isn't ideal, but people have requested it.
2195                 next if ($subvar =~ /\@.*\@/);
2196
2197                 # See if the variable is actually a substitution reference
2198                 my ($from, $to);
2199                 my @temp_list;
2200                 if ($subvar =~ /$SUBST_REF_PATTERN/o)
2201                 {
2202                     $subvar = $1;
2203                     $to = $3;
2204                     $from = quotemeta $2;
2205                 }
2206                 push @substfroms, $from;
2207                 push @substtos, $to;
2208
2209                 my $subobjvar = subobjname ($subvar);
2210                 push (@result, '$('. $subobjvar . ')');
2211
2212                 my $temp = define_objects_from_sources ($subvar, $subobjvar,
2213                                                         $nodefine, $one_file,
2214                                                         $obj, $var, $topparent);
2215                 $needlinker ||= $temp;
2216
2217                 pop @substfroms;
2218                 pop @substtos;
2219             }
2220             else # $var is a filename
2221             {
2222                 my $substnum=$#substfroms;
2223                 while ($substnum >= 0)
2224                 {
2225                     $val =~ s/$substfroms[$substnum]$/$substtos[$substnum]/
2226                         if defined $substfroms[$substnum];
2227                     $substnum -= 1;
2228                 }
2229
2230                 my (@transformed) =
2231                       &handle_single_transform_list ($var, $topparent, $one_file, $obj, $val);
2232                 push (@result, @transformed);
2233                 $needlinker = "true" if @transformed;
2234             }
2235         }
2236
2237         # Define _OBJECTS conditionally.
2238         define_pretty_variable ($objvar, $cond, (@result))
2239                 unless $nodefine;
2240     }
2241
2242     delete $vars_scanned{$var};
2243     return $needlinker;
2244 }
2245
2246
2247 # $OBJNAME
2248 # subobjname ($VARNAME)
2249 # ---------------------
2250 # Return a name for an object variable.
2251 #
2252 # Arguments are:
2253 #   $VARNAME is the name of the variable the object variable is being
2254 #   generated from.
2255 #
2256 # This function also looks at @substfroms and @substtos to determine any
2257 # substitutions to be performed on the object variable.
2258 #
2259 # The name returned is unique for the combination of $varname and
2260 # substitutions to be performed.
2261 sub subobjname ($)
2262 {
2263     my ($varname) = @_;
2264     my $key = $varname;
2265     my $substnum=$#substfroms;
2266     while ($substnum >= 0)
2267     {
2268         if (defined $substfroms[$substnum] &&
2269             ($substfroms[$substnum] || $substtos[$substnum]))
2270         {
2271             $key .= ":" . $substfroms[$substnum] . "=" . $substtos[$substnum];
2272         }
2273         $substnum -= 1;
2274     }
2275
2276     my $num = $substnums{$key};
2277     if (! $num)
2278     {
2279         $num = keys(%substnums) + 1;
2280         $substnums{$key} = $num;
2281     }
2282
2283     return "am__objects_$num";
2284 }
2285
2286
2287 # Handle SOURCE->OBJECT transform for one program or library.
2288 # Arguments are:
2289 #   canonical (transformed) name of object to build
2290 #   actual name of object to build
2291 #   object extension (ie either `.o' or `$o'.
2292 # Return result is name of linker variable that must be used.
2293 # Empty return means just use `LINK'.
2294 sub handle_source_transform
2295 {
2296     # one_file is canonical name.  unxformed is given name.  obj is
2297     # object extension.
2298     my ($one_file, $unxformed, $obj) = @_;
2299
2300     my ($linker) = '';
2301
2302     if (variable_defined ($one_file . "_OBJECTS"))
2303     {
2304         macro_error ($one_file . '_OBJECTS',
2305                      $one_file . '_OBJECTS', 'should not be defined');
2306         # No point in continuing.
2307         return;
2308     }
2309
2310     my %used_pfx = ();
2311     my $needlinker;
2312     %linkers_used = ();
2313     foreach my $prefix ('', 'EXTRA_', 'dist_', 'nodist_',
2314                         'dist_EXTRA_', 'nodist_EXTRA_')
2315     {
2316         my $var = $prefix . $one_file . "_SOURCES";
2317         next
2318           if !variable_defined ($var);
2319
2320         # We are going to define _OBJECTS variables using the prefix.
2321         # Then we glom them all together.  So we can't use the null
2322         # prefix here as we need it later.
2323         my $xpfx = ($prefix eq '') ? 'am_' : $prefix;
2324
2325         # Keep track of which prefixes we saw.
2326         $used_pfx{$xpfx} = 1
2327           unless $prefix =~ /EXTRA_/;
2328
2329         push @sources, "\$($var)";
2330         push @dist_sources, "\$($var)"
2331           unless $prefix =~ /^nodist_/;
2332
2333         @substfroms = ();
2334         @substtos = ();
2335         %vars_scanned = ();
2336         my $temp = define_objects_from_sources ($var,
2337                                                 $xpfx . $one_file . '_OBJECTS',
2338                                                 $prefix =~ /EXTRA_/,
2339                                                 $one_file, $obj, $var, $var);
2340         $needlinker ||= $temp;
2341     }
2342     if ($needlinker)
2343     {
2344         $linker ||= &resolve_linker (%linkers_used);
2345     }
2346
2347     my @keys = sort keys %used_pfx;
2348     if (scalar @keys == 0)
2349     {
2350         &define_variable ($one_file . "_SOURCES", $unxformed . ".c");
2351         push (@sources, $unxformed . '.c');
2352         push (@dist_sources, $unxformed . '.c');
2353
2354         %linkers_used = ();
2355         my (@result) =
2356           &handle_single_transform_list ($one_file . '_SOURCES',
2357                                          $one_file . '_SOURCES',
2358                                          $one_file, $obj,
2359                                          "$unxformed.c");
2360         $linker ||= &resolve_linker (%linkers_used);
2361         define_pretty_variable ($one_file . "_OBJECTS", '', @result)
2362     }
2363     else
2364     {
2365         grep ($_ = '$(' . $_ . $one_file . '_OBJECTS)', @keys);
2366         define_pretty_variable ($one_file . '_OBJECTS', '', @keys);
2367     }
2368
2369     # If we want to use `LINK' we must make sure it is defined.
2370     if ($linker eq '')
2371     {
2372         $need_link = 1;
2373     }
2374
2375     return $linker;
2376 }
2377
2378
2379 # handle_lib_objects ($XNAME, $VAR)
2380 # ---------------------------------
2381 # Special-case @ALLOCA@ and @LIBOBJS@ in _LDADD or _LIBADD variables.
2382 # Also, generate _DEPENDENCIES variable if appropriate.
2383 # Arguments are:
2384 #   transformed name of object being built, or empty string if no object
2385 #   name of _LDADD/_LIBADD-type variable to examine
2386 # Returns 1 if LIBOBJS seen, 0 otherwise.
2387 sub handle_lib_objects
2388 {
2389     my ($xname, $var) = @_;
2390
2391     prog_error ("handle_lib_objects: $var undefined")
2392         if ! variable_defined ($var);
2393
2394     my $ret = 0;
2395     foreach my $cond (variable_conditions_recursive ($var))
2396       {
2397         if (&handle_lib_objects_cond ($xname, $var, $cond))
2398           {
2399             $ret = 1;
2400           }
2401       }
2402     return $ret;
2403 }
2404
2405 # Subroutine of handle_lib_objects: handle a particular condition.
2406 sub handle_lib_objects_cond
2407 {
2408     my ($xname, $var, $cond) = @_;
2409
2410     # We recognize certain things that are commonly put in LIBADD or
2411     # LDADD.
2412     my @dep_list = ();
2413
2414     my $seen_libobjs = 0;
2415     my $flagvar = 0;
2416
2417     foreach my $lsearch (&variable_value_as_list_recursive ($var, $cond))
2418     {
2419         # Skip -lfoo and -Ldir; these are explicitly allowed.
2420         next if $lsearch =~ /^-[lL]/;
2421         if (! $flagvar && $lsearch =~ /^-/)
2422         {
2423             if ($var =~ /^(.*)LDADD$/)
2424             {
2425                 # Skip -dlopen and -dlpreopen; these are explicitly allowed.
2426                 next if $lsearch =~ /^-dl(pre)?open$/;
2427                 my $prefix = $1 || 'AM_';
2428                 macro_error ($var,
2429                              "linker flags such as `$lsearch' belong in `${prefix}LDFLAGS");
2430             }
2431             else
2432             {
2433                 $var =~ /^(.*)LIBADD$/;
2434                 # Only get this error once.
2435                 $flagvar = 1;
2436                 macro_error ($var,
2437                              "linker flags such as `$lsearch' belong in `${1}LDFLAGS");
2438             }
2439         }
2440
2441         # Assume we have a file of some sort, and push it onto the
2442         # dependency list.  Autoconf substitutions are not pushed;
2443         # rarely is a new dependency substituted into (eg) foo_LDADD
2444         # -- but "bad things (eg -lX11) are routinely substituted.
2445         # Note that LIBOBJS and ALLOCA are exceptions to this rule,
2446         # and handled specially below.
2447         push (@dep_list, $lsearch)
2448             unless $lsearch =~ /^\@.*\@$/;
2449
2450         # Automatically handle @LIBOBJS@ and @ALLOCA@.  Basically this
2451         # means adding entries to dep_files.
2452         if ($lsearch =~ /^\@(LT)?LIBOBJS\@$/)
2453         {
2454             my $lt = $1 ? $1 : '';
2455             my $myobjext = ($1 ? 'l' : '') . 'o';
2456
2457             push (@dep_list, $lsearch);
2458             $seen_libobjs = 1;
2459             if (! keys %libsources
2460                 && ! variable_defined ($lt . 'LIBOBJS'))
2461             {
2462                 macro_error ($var,
2463                              "\@$lt" . "LIBOBJS\@ seen but never set in `$configure_ac'");
2464             }
2465
2466             foreach my $iter (keys %libsources)
2467             {
2468                 if ($iter =~ /\.[cly]$/)
2469                 {
2470                     &saw_extension ($&);
2471                     &saw_extension ('.c');
2472                 }
2473
2474                 if ($iter =~ /\.h$/)
2475                 {
2476                     require_file_with_macro ($var, FOREIGN, $iter);
2477                 }
2478                 elsif ($iter ne 'alloca.c')
2479                 {
2480                     my $rewrite = $iter;
2481                     $rewrite =~ s/\.c$/.P$myobjext/;
2482                     $dep_files{'$(DEPDIR)/' . $rewrite} = 1;
2483                     $rewrite = "^" . quotemeta ($iter) . "\$";
2484                     # Only require the file if it is not a built source.
2485                     if (! variable_defined ('BUILT_SOURCES')
2486                         || ! grep (/$rewrite/,
2487                                    &variable_value_as_list_recursive (
2488                                         'BUILT_SOURCES', 'all')))
2489                     {
2490                         require_file_with_macro ($var, FOREIGN, $iter);
2491                     }
2492                 }
2493             }
2494         }
2495         elsif ($lsearch =~ /^\@(LT)?ALLOCA\@$/)
2496         {
2497             my $lt = $1 ? $1 : '';
2498             my $myobjext = ($1 ? 'l' : '') . 'o';
2499
2500             push (@dep_list, $lsearch);
2501             macro_error ($var,
2502                          "\@$lt" . "ALLOCA\@ seen but `AC_FUNC_ALLOCA' not in `$configure_ac'")
2503                 if ! defined $libsources{'alloca.c'};
2504             $dep_files{'$(DEPDIR)/alloca.P' . $myobjext} = 1;
2505             require_file_with_macro ($var, FOREIGN, 'alloca.c');
2506             &saw_extension ('c');
2507         }
2508     }
2509
2510     if ($xname ne '')
2511     {
2512         if (conditional_ambiguous_p ($xname . '_DEPENDENCIES', $cond) ne '')
2513         {
2514             # Note that we've examined this.
2515             &examine_variable ($xname . '_DEPENDENCIES');
2516         }
2517         else
2518         {
2519             define_pretty_variable ($xname . '_DEPENDENCIES', $cond,
2520                                     @dep_list);
2521         }
2522     }
2523
2524     return $seen_libobjs;
2525 }
2526
2527 # Canonicalize the input parameter
2528 sub canonicalize
2529 {
2530     my ($string) = @_;
2531     $string =~ tr/A-Za-z0-9_\@/_/c;
2532     return $string;
2533 }
2534
2535 # Canonicalize a name, and check to make sure the non-canonical name
2536 # is never used.  Returns canonical name.  Arguments are name and a
2537 # list of suffixes to check for.
2538 sub check_canonical_spelling
2539 {
2540     my ($name, @suffixes) = @_;
2541
2542     my $xname = &canonicalize ($name);
2543     if ($xname ne $name)
2544     {
2545         foreach my $xt (@suffixes)
2546         {
2547             macro_error ("$name$xt",
2548                          "invalid variable `$name$xt'; should be `$xname$xt'")
2549                 if variable_defined ("$name$xt");
2550         }
2551     }
2552
2553     return $xname;
2554 }
2555
2556
2557 # handle_compile ()
2558 # -----------------
2559 # Set up the compile suite.
2560 sub handle_compile ()
2561 {
2562     return
2563       unless $get_object_extension_was_run;
2564
2565     # Boilerplate.
2566     my $default_includes = '';
2567     if (! defined $options{'nostdinc'})
2568       {
2569         $default_includes = ' -I. -I$(srcdir)';
2570
2571         if (variable_defined ('CONFIG_HEADER'))
2572           {
2573             foreach my $hdr (split (' ', &variable_value ('CONFIG_HEADER')))
2574               {
2575                 $default_includes .= ' -I' . dirname ($hdr);
2576               }
2577           }
2578       }
2579
2580     my (@mostly_rms, @dist_rms);
2581     foreach my $item (sort keys %compile_clean_files)
2582     {
2583         if ($compile_clean_files{$item} == MOSTLY_CLEAN)
2584         {
2585             push (@mostly_rms, "\t-rm -f $item");
2586         }
2587         elsif ($compile_clean_files{$item} == DIST_CLEAN)
2588         {
2589             push (@dist_rms, "\t-rm -f $item");
2590         }
2591         else
2592         {
2593             prog_error ("invalid entry in \%compile_clean_files");
2594         }
2595     }
2596
2597     my ($coms, $vars, $rules) =
2598       &file_contents_internal (1, "$libdir/am/compile.am",
2599                                ('DEFAULT_INCLUDES' => $default_includes,
2600                                 'MOSTLYRMS' => join ("\n", @mostly_rms),
2601                                 'DISTRMS' => join ("\n", @dist_rms)));
2602     $output_vars .= $vars;
2603     $output_rules .= "$coms$rules";
2604
2605     # Check for automatic de-ANSI-fication.
2606     if (defined $options{'ansi2knr'})
2607       {
2608         if (! $am_c_prototypes)
2609           {
2610             macro_error ('AUTOMAKE_OPTIONS',
2611                          "option `ansi2knr' in use but `AM_C_PROTOTYPES' not in `$configure_ac'");
2612             &keyed_aclocal_warning ('AM_C_PROTOTYPES');
2613             # Only give this error once.
2614             $am_c_prototypes = 1;
2615           }
2616
2617         # topdir is where ansi2knr should be.
2618         if ($options{'ansi2knr'} eq 'ansi2knr')
2619           {
2620             # Only require ansi2knr files if they should appear in
2621             # this directory.
2622             require_file_with_macro ('AUTOMAKE_OPTIONS', FOREIGN,
2623                                      'ansi2knr.c', 'ansi2knr.1');
2624
2625             # ansi2knr needs to be built before subdirs, so unshift it.
2626             unshift (@all, '$(ANSI2KNR)');
2627           }
2628
2629         my $ansi2knr_dir = '';
2630         $ansi2knr_dir = dirname ($options{'ansi2knr'})
2631           if $options{'ansi2knr'} ne 'ansi2knr';
2632
2633         $output_rules .= &file_contents ('ansi2knr',
2634                                          ('ANSI2KNR-DIR' => $ansi2knr_dir));
2635
2636     }
2637 }
2638
2639 # handle_libtool ()
2640 # -----------------
2641 # Handle libtool rules.
2642 sub handle_libtool
2643 {
2644     return unless $seen_libtool;
2645
2646     # Libtool requires some files, but only at top level.
2647     require_conf_file ($seen_libtool, FOREIGN, @libtool_files)
2648         if $relative_dir eq '.';
2649
2650     # Output the libtool compilation rules.
2651     $output_rules .= &file_contents ('libtool');
2652 }
2653
2654 # handle_programs ()
2655 # ------------------
2656 # Handle C programs.
2657 sub handle_programs
2658 {
2659     my @proglist = &am_install_var ('progs', 'PROGRAMS',
2660                                     'bin', 'sbin', 'libexec', 'pkglib',
2661                                     'noinst', 'check');
2662     return if ! @proglist;
2663
2664     my $seen_libobjs = 0;
2665     foreach my $one_file (@proglist)
2666     {
2667         my $obj = &get_object_extension ($one_file);
2668
2669         # Canonicalize names and check for misspellings.
2670         my $xname = &check_canonical_spelling ($one_file, '_LDADD', '_LDFLAGS',
2671                                                '_SOURCES', '_OBJECTS',
2672                                                '_DEPENDENCIES');
2673
2674         my $linker = &handle_source_transform ($xname, $one_file, $obj);
2675
2676         my $xt = '';
2677         if (variable_defined ($xname . "_LDADD"))
2678         {
2679             if (&handle_lib_objects ($xname, $xname . '_LDADD'))
2680             {
2681                 $seen_libobjs = 1;
2682             }
2683             $xt = '_LDADD';
2684         }
2685         else
2686         {
2687             # User didn't define prog_LDADD override.  So do it.
2688             &define_variable ($xname . '_LDADD', '$(LDADD)');
2689
2690             # This does a bit too much work.  But we need it to
2691             # generate _DEPENDENCIES when appropriate.
2692             if (variable_defined ('LDADD'))
2693             {
2694                 if (&handle_lib_objects ($xname, 'LDADD'))
2695                 {
2696                     $seen_libobjs = 1;
2697                 }
2698             }
2699             elsif (! variable_defined ($xname . '_DEPENDENCIES'))
2700             {
2701                 &define_variable ($xname . '_DEPENDENCIES', '');
2702             }
2703             $xt = '_SOURCES'
2704         }
2705
2706         if (variable_defined ($xname . '_LIBADD'))
2707         {
2708             macro_error ($xname . '_LIBADD',
2709                          "use `" . $xname . "_LDADD', not `"
2710                          . $xname . "_LIBADD'");
2711         }
2712
2713         if (! variable_defined ($xname . '_LDFLAGS'))
2714         {
2715             # Define the prog_LDFLAGS variable.
2716             &define_variable ($xname . '_LDFLAGS', '');
2717         }
2718
2719         # Determine program to use for link.
2720         my $xlink;
2721         if (variable_defined ($xname . '_LINK'))
2722         {
2723             $xlink = $xname . '_LINK';
2724         }
2725         else
2726         {
2727             $xlink = $linker ? $linker : 'LINK';
2728         }
2729
2730         # If the resulting program lies into a subdirectory,
2731         # make sure this directory will exist.
2732         my $dirstamp = require_build_directory_maybe ($one_file);
2733
2734         # Don't add $(EXEEXT) if user already did.
2735         my $extension = ($one_file !~ /\$\(EXEEXT\)$/
2736                          ? "\$(EXEEXT)"
2737                          : '');
2738
2739         $output_rules .= &file_contents ('program',
2740                                          ('PROGRAM'  => $one_file,
2741                                           'XPROGRAM' => $xname,
2742                                           'XLINK'    => $xlink,
2743                                           'DIRSTAMP' => $dirstamp,
2744                                           'EXEEXT'   => $extension));
2745     }
2746
2747     if (variable_defined ('LDADD') && &handle_lib_objects ('', 'LDADD'))
2748     {
2749         $seen_libobjs = 1;
2750     }
2751
2752     if ($seen_libobjs)
2753     {
2754         foreach my $one_file (@proglist)
2755         {
2756             my $xname = &canonicalize ($one_file);
2757
2758             if (variable_defined ($xname . '_LDADD'))
2759             {
2760                 &check_libobjs_sources ($xname, $xname . '_LDADD');
2761             }
2762             elsif (variable_defined ('LDADD'))
2763             {
2764                 &check_libobjs_sources ($xname, 'LDADD');
2765             }
2766         }
2767     }
2768 }
2769
2770
2771 # handle_libraries ()
2772 # -------------------
2773 # Handle libraries.
2774 sub handle_libraries
2775 {
2776     my @liblist = &am_install_var ('libs', 'LIBRARIES',
2777                                    'lib', 'pkglib', 'noinst', 'check');
2778     return if ! @liblist;
2779
2780     my @prefix = am_primary_prefixes ('LIBRARIES', 0, 'lib', 'pkglib',
2781                                       'noinst', 'check');
2782     if (! defined $configure_vars{'RANLIB'}
2783         && @prefix)
2784       {
2785         macro_error ($prefix[0] . '_LIBRARIES',
2786                      "library used but `RANLIB' not defined in `$configure_ac'");
2787         # Only get this error once.  If this is ever printed, we have
2788         # a bug.
2789         $configure_vars{'RANLIB'} = 'BUG';
2790       }
2791
2792     my $seen_libobjs = 0;
2793     foreach my $onelib (@liblist)
2794     {
2795         # Check that the library fits the standard naming convention.
2796         if (basename ($onelib) !~ /^lib.*\.a/)
2797         {
2798             # FIXME should put line number here.  That means mapping
2799             # from library name back to variable name.
2800             &am_error ("`$onelib' is not a standard library name");
2801         }
2802
2803         my $obj = &get_object_extension ($onelib);
2804
2805         # Canonicalize names and check for misspellings.
2806         my $xlib = &check_canonical_spelling ($onelib, '_LIBADD', '_SOURCES',
2807                                               '_OBJECTS', '_DEPENDENCIES',
2808                                               '_AR');
2809
2810         if (! variable_defined ($xlib . '_AR'))
2811         {
2812             &define_variable ($xlib . '_AR', '$(AR) cru');
2813         }
2814
2815         if (variable_defined ($xlib . '_LIBADD'))
2816         {
2817             if (&handle_lib_objects ($xlib, $xlib . '_LIBADD'))
2818             {
2819                 $seen_libobjs = 1;
2820             }
2821         }
2822         else
2823         {
2824             # Generate support for conditional object inclusion in
2825             # libraries.
2826             &define_variable ($xlib . "_LIBADD", '');
2827         }
2828
2829         if (variable_defined ($xlib . '_LDADD'))
2830         {
2831             macro_error ($xlib . '_LDADD',
2832                          "use `" . $xlib . "_LIBADD', not `"
2833                          . $xlib . "_LDADD'");
2834         }
2835
2836         # Make sure we at look at this.
2837         &examine_variable ($xlib . '_DEPENDENCIES');
2838
2839         &handle_source_transform ($xlib, $onelib, $obj);
2840
2841         # If the resulting library lies into a subdirectory,
2842         # make sure this directory will exist.
2843         my $dirstamp = require_build_directory_maybe ($onelib);
2844
2845         $output_rules .= &file_contents ('library',
2846                                          ('LIBRARY'  => $onelib,
2847                                           'XLIBRARY' => $xlib,
2848                                           'DIRSTAMP' => $dirstamp));
2849     }
2850
2851     if ($seen_libobjs)
2852     {
2853         foreach my $onelib (@liblist)
2854         {
2855             my $xlib = &canonicalize ($onelib);
2856             if (variable_defined ($xlib . '_LIBADD'))
2857             {
2858                 &check_libobjs_sources ($xlib, $xlib . '_LIBADD');
2859             }
2860         }
2861     }
2862 }
2863
2864
2865 # handle_ltlibraries ()
2866 # ---------------------
2867 # Handle shared libraries.
2868 sub handle_ltlibraries
2869 {
2870     my @liblist = &am_install_var ('ltlib', 'LTLIBRARIES',
2871                                    'noinst', 'lib', 'pkglib', 'check');
2872     return if ! @liblist;
2873
2874     my %instdirs;
2875     my @prefix = am_primary_prefixes ('LTLIBRARIES', 0, 'lib', 'pkglib',
2876                                       'noinst', 'check');
2877
2878     foreach my $key (@prefix)
2879       {
2880         if (!$seen_libtool)
2881           {
2882             macro_error ($key . '_LTLIBRARIES',
2883                          "library used but `LIBTOOL' not defined in `$configure_ac'");
2884             # Only get this error once.  If this is ever printed,
2885             # we have a bug.
2886             $configure_vars{'LIBTOOL'} = 'BUG';
2887             $seen_libtool = $var_location{$key . '_LTLIBRARIES'};
2888           }
2889
2890         # Get the installation directory of each library.
2891         (my $dir = $key) =~ s/^nobase_//;
2892         for (variable_value_as_list_recursive ($key . '_LTLIBRARIES', 'all'))
2893           {
2894             if ($instdirs{$_})
2895               {
2896                 am_error ("`$_' is already going to be installed in `$instdirs{$_}'");
2897               }
2898             else
2899               {
2900                 $instdirs{$_} = $dir;
2901               }
2902           }
2903       }
2904
2905     my $seen_libobjs = 0;
2906     foreach my $onelib (@liblist)
2907     {
2908         my $obj = &get_object_extension ($onelib);
2909
2910         # Canonicalize names and check for misspellings.
2911         my $xlib = &check_canonical_spelling ($onelib, '_LIBADD', '_LDFLAGS',
2912                                               '_SOURCES', '_OBJECTS',
2913                                               '_DEPENDENCIES');
2914
2915         if (! variable_defined ($xlib . '_LDFLAGS'))
2916         {
2917             # Define the lib_LDFLAGS variable.
2918             &define_variable ($xlib . '_LDFLAGS', '');
2919         }
2920
2921         # Check that the library fits the standard naming convention.
2922         my $libname_rx = "^lib.*\.la";
2923         if ((variable_defined ($xlib . '_LDFLAGS')
2924              && grep (/-module/, &variable_value_as_list_recursive (
2925                                         $xlib . '_LDFLAGS', 'all')))
2926             || (variable_defined ('LDFLAGS')
2927                 && grep (/-module/, &variable_value_as_list_recursive (
2928                                         'LDFLAGS', 'all'))))
2929         {
2930                 # Relax name checking for libtool modules.
2931                 $libname_rx = "\.la";
2932         }
2933         if (basename ($onelib) !~ /$libname_rx$/)
2934         {
2935             # FIXME this should only be a warning for foreign packages
2936             # FIXME should put line number here.  That means mapping
2937             # from library name back to variable name.
2938             &am_error ("`$onelib' is not a standard libtool library name");
2939         }
2940
2941         if (variable_defined ($xlib . '_LIBADD'))
2942         {
2943             if (&handle_lib_objects ($xlib, $xlib . '_LIBADD'))
2944             {
2945                 $seen_libobjs = 1;
2946             }
2947         }
2948         else
2949         {
2950             # Generate support for conditional object inclusion in
2951             # libraries.
2952             &define_variable ($xlib . "_LIBADD", '');
2953         }
2954
2955         if (variable_defined ($xlib . '_LDADD'))
2956         {
2957             macro_error ($xlib . '_LDADD',
2958                          "use `" . $xlib . "_LIBADD', not `"
2959                          . $xlib . "_LDADD'");
2960         }
2961
2962         # Make sure we at look at this.
2963         &examine_variable ($xlib . '_DEPENDENCIES');
2964
2965         my $linker = &handle_source_transform ($xlib, $onelib, $obj);
2966
2967         # Determine program to use for link.
2968         my $xlink;
2969         if (variable_defined ($xlib . '_LINK'))
2970         {
2971             $xlink = $xlib . '_LINK';
2972         }
2973         else
2974         {
2975             $xlink = $linker ? $linker : 'LINK';
2976         }
2977
2978         my $rpath;
2979         if ($instdirs{$onelib} eq 'EXTRA'
2980             || $instdirs{$onelib} eq 'noinst'
2981             || $instdirs{$onelib} eq 'check')
2982         {
2983             # It's an EXTRA_ library, so we can't specify -rpath,
2984             # because we don't know where the library will end up.
2985             # The user probably knows, but generally speaking automake
2986             # doesn't -- and in fact configure could decide
2987             # dynamically between two different locations.
2988             $rpath = '';
2989         }
2990         else
2991         {
2992             $rpath = ('-rpath $(' . $instdirs{$onelib} . 'dir)');
2993         }
2994
2995         # If the resulting library lies into a subdirectory,
2996         # make sure this directory will exist.
2997         my $dirstamp = require_build_directory_maybe ($onelib);
2998
2999         $output_rules .= &file_contents ('ltlibrary',
3000                                          ('LTLIBRARY'  => $onelib,
3001                                           'XLTLIBRARY' => $xlib,
3002                                           'RPATH'      => $rpath,
3003                                           'XLINK'      => $xlink,
3004                                           'DIRSTAMP'   => $dirstamp));
3005     }
3006
3007     if ($seen_libobjs)
3008     {
3009         foreach my $onelib (@liblist)
3010         {
3011             my $xlib = &canonicalize ($onelib);
3012             if (variable_defined ($xlib . '_LIBADD'))
3013             {
3014                 &check_libobjs_sources ($xlib, $xlib . '_LIBADD');
3015             }
3016         }
3017     }
3018 }
3019
3020 # See if any _SOURCES variable were misspelled.  Also, make sure that
3021 # EXTRA_ variables don't contain configure substitutions.
3022 sub check_typos ()
3023 {
3024     foreach my $varname (keys %var_value)
3025     {
3026         foreach my $primary ('_SOURCES', '_LIBADD', '_LDADD', '_LDFLAGS',
3027                              '_DEPENDENCIES')
3028         {
3029           macro_error ($varname,
3030                        "invalid unused variable name: `$varname'")
3031             # Note that a configure variable is always legitimate.
3032             # It is natural to name such variables after the
3033             # primary, so we explicitly allow it.
3034             if $varname =~ /$primary$/ && ! $content_seen{$varname}
3035                 && ! exists $configure_vars{$varname};
3036         }
3037     }
3038 }
3039
3040
3041 # Handle scripts.
3042 sub handle_scripts
3043 {
3044     # NOTE we no longer automatically clean SCRIPTS, because it is
3045     # useful to sometimes distribute scripts verbatim.  This happens
3046     # eg in Automake itself.
3047     &am_install_var ('-candist', 'scripts', 'SCRIPTS',
3048                      'bin', 'sbin', 'libexec', 'pkgdata',
3049                      'noinst', 'check');
3050 }
3051
3052
3053 # ($OUTFILE, $VFILE, @CLEAN_FILES)
3054 # &scan_texinfo_file ($FILENAME)
3055 # ------------------------------
3056 # $OUTFILE is the name of the info file produced by $FILENAME.
3057 # $VFILE is the name of the version.texi file used (empty if none).
3058 # @CLEAN_FILES is the list of by products (indexes etc.)
3059 sub scan_texinfo_file
3060 {
3061     my ($filename) = @_;
3062
3063     # These are always created, no matter whether indexes are used or not.
3064     my @clean_suffixes = qw(aux dvi log ps toc
3065                             cp fn ky vr tp pg); # grep new.*index texinfo.tex
3066
3067     # There are predefined indexes which don't follow the regular rules.
3068     my %predefined_index = qw(c cps
3069                               f fns
3070                               k kys
3071                               v vrs
3072                               t tps
3073                               p pgs);
3074
3075     # There are commands which include a hidden index command.
3076     my %hidden_index = (tp => 'tps');
3077     $hidden_index{$_} = 'fns' foreach qw(fn un typefn typefun max spec
3078                                          op typeop method typemethod);
3079     $hidden_index{$_} = 'vrs' foreach qw(vr var typevr typevar opt cv
3080                                          ivar typeivar);
3081
3082     # Indexes stored into another one.  In this case, the *.??s file
3083     # is not created.
3084     my @syncodeindexes = ();
3085
3086     my $texi = new Automake::XFile "< $filename";
3087     verbose "reading $filename";
3088
3089     my ($outfile, $vfile);
3090     while ($_ = $texi->getline)
3091     {
3092       if (/^\@setfilename +(\S+)/)
3093       {
3094         $outfile = $1;
3095         if ($outfile =~ /\.(.+)$/ && $1 ne 'info')
3096           {
3097             file_error ("$filename:$.",
3098                         "output `$outfile' has unrecognized extension");
3099             return;
3100           }
3101       }
3102       # A "version.texi" file is actually any file whose name
3103       # matches "vers*.texi".
3104       elsif (/^\@include\s+(vers[^.]*\.texi)\s*$/)
3105       {
3106         $vfile = $1;
3107       }
3108
3109       # Try to find what are the indexes which are used.
3110
3111       # Creating a new category of index.
3112       elsif (/^\@def(code)?index (\w+)/)
3113       {
3114         push @clean_suffixes, $2;
3115       }
3116
3117       # Storing in a predefined index.
3118       elsif (/^\@([cfkvtp])index /)
3119       {
3120         push @clean_suffixes, $predefined_index{$1};
3121       }
3122       elsif (/^\@def(\w+) /)
3123       {
3124         push @clean_suffixes, $hidden_index{$1}
3125           if defined $hidden_index{$1};
3126       }
3127
3128       # Merging an index into an another.
3129       elsif (/^\@syn(code)?index (\w+) (\w+)/)
3130       {
3131         push @syncodeindexes, "$2s";
3132         push @clean_suffixes, "$3s";
3133       }
3134
3135     }
3136
3137     if ($outfile eq '')
3138       {
3139         &am_error ("`$filename' missing \@setfilename");
3140         return;
3141       }
3142
3143     my $infobase = basename ($filename);
3144     $infobase =~ s/\.te?xi(nfo)?$//;
3145     my %clean_files = map { +"$infobase.$_" => 1 } @clean_suffixes;
3146     grep { delete $clean_files{"$infobase.$_"} } @syncodeindexes;
3147     return ($outfile, $vfile, (sort keys %clean_files));
3148 }
3149
3150
3151 # ($DO-SOMETHING, $TEXICLEANS)
3152 # handle_texinfo_helper ()
3153 # ------------------------
3154 # Handle all Texinfo source; helper for handle_texinfo
3155 sub handle_texinfo_helper
3156 {
3157     macro_error ('TEXINFOS',
3158                  "`TEXINFOS' is an anachronism; use `info_TEXINFOS'")
3159         if variable_defined ('TEXINFOS');
3160     return (0, '') if (! variable_defined ('info_TEXINFOS')
3161                        && ! variable_defined ('html_TEXINFOS'));
3162
3163     if (variable_defined ('html_TEXINFOS'))
3164     {
3165         macro_error ('html_TEXINFOS',
3166                      "HTML generation not yet supported");
3167         return (0, '');
3168     }
3169
3170     my @texis = &variable_value_as_list_recursive ('info_TEXINFOS', 'all');
3171
3172     my (@info_deps_list, @dvis_list, @texi_deps);
3173     my %versions;
3174     my $done = 0;
3175     my @texi_cleans;
3176     my $canonical;
3177
3178     my %texi_suffixes;
3179     foreach my $info_cursor (@texis)
3180     {
3181         my $infobase = $info_cursor;
3182         $infobase =~ s/\.(txi|texinfo|texi)$//;
3183
3184         if ($infobase eq $info_cursor)
3185         {
3186             # FIXME: report line number.
3187             &am_error ("texinfo file `$info_cursor' has unrecognized extension");
3188             next;
3189         }
3190         $texi_suffixes{$1} = 1;
3191
3192         # If 'version.texi' is referenced by input file, then include
3193         # automatic versioning capability.
3194         my ($out_file, $vtexi, @clean_files) =
3195           &scan_texinfo_file ("$relative_dir/$info_cursor")
3196             or next;
3197         push (@texi_cleans, @clean_files);
3198
3199         if ($vtexi)
3200         {
3201             &am_error ("`$vtexi', included in `$info_cursor', also included in `$versions{$vtexi}'")
3202                 if (defined $versions{$vtexi});
3203             $versions{$vtexi} = $info_cursor;
3204
3205             # We number the stamp-vti files.  This is doable since the
3206             # actual names don't matter much.  We only number starting
3207             # with the second one, so that the common case looks nice.
3208             my $vti = ($done ? $done : 'vti');
3209             ++$done;
3210
3211             # This is ugly, but it is our historical practice.
3212             if ($config_aux_dir_set_in_configure_in)
3213             {
3214                 require_conf_file_with_macro ('info_TEXINFOS', FOREIGN,
3215                                               'mdate-sh');
3216             }
3217             else
3218             {
3219                 require_file_with_macro ('info_TEXINFOS', FOREIGN,
3220                                          'mdate-sh');
3221             }
3222
3223             my $conf_dir;
3224             if ($config_aux_dir_set_in_configure_in)
3225             {
3226                 $conf_dir = $config_aux_dir;
3227                 $conf_dir .= '/' unless $conf_dir =~ /\/$/;
3228             }
3229             else
3230             {
3231                 $conf_dir = '$(srcdir)/';
3232             }
3233             $output_rules .= &file_contents ('texi-vers',
3234                                              ('TEXI'  => $info_cursor,
3235                                               'VTI'   => $vti,
3236                                               'VTEXI' => $vtexi,
3237                                               'MDDIR' => $conf_dir));
3238         }
3239
3240         # If user specified file_TEXINFOS, then use that as explicit
3241         # dependency list.
3242         @texi_deps = ();
3243         push (@texi_deps, $info_cursor);
3244         # Prefix with $(srcdir) because some version of make won't
3245         # work if the target has it and the dependency doesn't.
3246         push (@texi_deps, '$(srcdir)/' . $vtexi) if $vtexi;
3247
3248         my $canonical = &canonicalize ($infobase);
3249         if (variable_defined ($canonical . "_TEXINFOS"))
3250         {
3251             push (@texi_deps, '$(' . $canonical . '_TEXINFOS)');
3252             &push_dist_common ('$(' . $canonical . '_TEXINFOS)');
3253         }
3254
3255         $output_rules .= ("\n" . $out_file . ": "
3256                           . "@texi_deps"
3257                           . "\n" . $infobase . ".dvi: "
3258                           . "@texi_deps"
3259                           . "\n");
3260
3261         push (@info_deps_list, $out_file);
3262         push (@dvis_list, $infobase . '.dvi');
3263     }
3264
3265     # Handle location of texinfo.tex.
3266     my $need_texi_file = 0;
3267     my $texinfodir;
3268     if ($cygnus_mode)
3269     {
3270         $texinfodir = '$(top_srcdir)/../texinfo';
3271         &define_variable ('TEXINFO_TEX', "$texinfodir/texinfo.tex");
3272     }
3273     elsif ($config_aux_dir_set_in_configure_in)
3274     {
3275         $texinfodir = $config_aux_dir;
3276         &define_variable ('TEXINFO_TEX', "$texinfodir/texinfo.tex");
3277         $need_texi_file = 2; # so that we require_conf_file later
3278     }
3279     elsif (variable_defined ('TEXINFO_TEX'))
3280     {
3281         # The user defined TEXINFO_TEX so assume he knows what he is
3282         # doing.
3283         $texinfodir = ('$(srcdir)/'
3284                        . dirname (&variable_value ('TEXINFO_TEX')));
3285     }
3286     else
3287     {
3288         $texinfodir = '$(srcdir)';
3289         $need_texi_file = 1;
3290     }
3291
3292     foreach my $txsfx (sort keys %texi_suffixes)
3293     {
3294         $output_rules .= &file_contents ('texibuild',
3295                                          ('TEXINFODIR' => $texinfodir,
3296                                           'SUFFIX'     => $txsfx));
3297     }
3298
3299     # The return value.
3300     my $texiclean = &pretty_print_internal ("", "\t  ", @texi_cleans);
3301
3302     push (@dist_targets, 'dist-info');
3303
3304     if (! defined $options{'no-installinfo'})
3305     {
3306         # Make sure documentation is made and installed first.  Use
3307         # $(INFO_DEPS), not 'info', because otherwise recursive makes
3308         # get run twice during "make all".
3309         unshift (@all, '$(INFO_DEPS)');
3310     }
3311
3312     &define_variable ("INFO_DEPS", "@info_deps_list");
3313     &define_variable ("DVIS", "@dvis_list");
3314     # This next isn't strictly needed now -- the places that look here
3315     # could easily be changed to look in info_TEXINFOS.  But this is
3316     # probably better, in case noinst_TEXINFOS is ever supported.
3317     &define_variable ("TEXINFOS", &variable_value ('info_TEXINFOS'));
3318
3319     # Do some error checking.  Note that this file is not required
3320     # when in Cygnus mode; instead we defined TEXINFO_TEX explicitly
3321     # up above.
3322     if ($need_texi_file && ! defined $options{'no-texinfo.tex'})
3323     {
3324         if ($need_texi_file > 1)
3325         {
3326             require_conf_file_with_macro ('info_TEXINFOS', FOREIGN,
3327                                           'texinfo.tex');
3328         }
3329         else
3330         {
3331             require_file_with_macro ('info_TEXINFOS', FOREIGN, 'texinfo.tex');
3332         }
3333     }
3334
3335     return (1, $texiclean);
3336 }
3337
3338 # handle_texinfo ()
3339 # -----------------
3340 # Handle all Texinfo source.
3341 sub handle_texinfo
3342 {
3343     my ($do_something, $texiclean) = handle_texinfo_helper ();
3344     $output_rules .=  &file_contents ('texinfos',
3345                                       ('TEXICLEAN' => $texiclean,
3346                                        'LOCAL-TEXIS' => $do_something));
3347 }
3348
3349 # Handle any man pages.
3350 sub handle_man_pages
3351 {
3352     macro_error ('MANS', "`MANS' is an anachronism; use `man_MANS'")
3353         if variable_defined ('MANS');
3354
3355     # Find all the sections in use.  We do this by first looking for
3356     # "standard" sections, and then looking for any additional
3357     # sections used in man_MANS.
3358     my (%sections, %vlist);
3359     # We handle nodist_ for uniformity.  man pages aren't distributed
3360     # by default so it isn't actually very important.
3361     foreach my $pfx ('', 'dist_', 'nodist_')
3362     {
3363         # Add more sections as needed.
3364         foreach my $section ('0'..'9', 'n', 'l')
3365         {
3366             if (variable_defined ($pfx . 'man' . $section . '_MANS'))
3367             {
3368                 $sections{$section} = 1;
3369                 $vlist{'$(' . $pfx . 'man' . $section . '_MANS)'} = 1;
3370
3371                 &push_dist_common ('$(' . $pfx . 'man' . $section . '_MANS)')
3372                     if $pfx eq 'dist_';
3373             }
3374         }
3375
3376         if (variable_defined ($pfx . 'man_MANS'))
3377         {
3378             $vlist{'$(' . $pfx . 'man_MANS)'} = 1;
3379             foreach (&variable_value_as_list_recursive ($pfx . 'man_MANS', 'all'))
3380             {
3381                 # A page like `foo.1c' goes into man1dir.
3382                 if (/\.([0-9a-z])([a-z]*)$/)
3383                 {
3384                     $sections{$1} = 1;
3385                 }
3386             }
3387
3388             &push_dist_common ('$(' . $pfx . 'man_MANS)')
3389                 if $pfx eq 'dist_';
3390         }
3391     }
3392
3393     return unless %sections;
3394
3395     # Now for each section, generate an install and unintall rule.
3396     # Sort sections so output is deterministic.
3397     foreach my $section (sort keys %sections)
3398     {
3399         $output_rules .= &file_contents ('mans', ('SECTION' => $section));
3400     }
3401
3402     my @mans = sort keys %vlist;
3403     $output_vars .= file_contents ('mans-vars',
3404                                    ('MANS' => "@mans"));
3405
3406     if (! defined $options{'no-installman'})
3407     {
3408         push (@all, '$(MANS)');
3409     }
3410 }
3411
3412 # Handle DATA variables.
3413 sub handle_data
3414 {
3415     &am_install_var ('-noextra', '-candist', 'data', 'DATA',
3416                      'data', 'sysconf', 'sharedstate', 'localstate',
3417                      'pkgdata', 'noinst', 'check');
3418 }
3419
3420 # Handle TAGS.
3421 sub handle_tags
3422 {
3423     my @tag_deps = ();
3424     if (variable_defined ('SUBDIRS'))
3425     {
3426         $output_rules .= ("tags-recursive:\n"
3427                           . "\tlist=\'\$(SUBDIRS)\'; for subdir in \$\$list; do \\\n"
3428                           # Never fail here if a subdir fails; it
3429                           # isn't important.
3430                           . "\t  test \"\$\$subdir\" = . || (cd \$\$subdir"
3431                           . " && \$(MAKE) \$(AM_MAKEFLAGS) tags); \\\n"
3432                           . "\tdone\n");
3433         push (@tag_deps, 'tags-recursive');
3434         &depend ('.PHONY', 'tags-recursive');
3435     }
3436
3437     if (&saw_sources_p (1)
3438         || variable_defined ('ETAGS_ARGS')
3439         || @tag_deps)
3440     {
3441         my @config;
3442         foreach my $spec (@config_headers)
3443         {
3444             my ($out, @ins) = split_config_file_spec ($spec);
3445             foreach my $in (@ins)
3446               {
3447                 # If the config header source is in this directory,
3448                 # require it.
3449                 push @config, basename ($in)
3450                   if $relative_dir eq dirname ($in);
3451               }
3452         }
3453         $output_rules .= &file_contents ('tags',
3454                                          ('CONFIG' => "@config",
3455                                           'DIRS'   => "@tag_deps"));
3456         &examine_variable ('TAGS_DEPENDENCIES');
3457     }
3458     elsif (variable_defined ('TAGS_DEPENDENCIES'))
3459     {
3460         macro_error ('TAGS_DEPENDENCIES',
3461                      "doesn't make sense to define `TAGS_DEPENDENCIES' without sources or `ETAGS_ARGS'");
3462     }
3463     else
3464     {
3465         # Every Makefile must define some sort of TAGS rule.
3466         # Otherwise, it would be possible for a top-level "make TAGS"
3467         # to fail because some subdirectory failed.
3468         $output_rules .= "tags: TAGS\nTAGS:\n\n";
3469     }
3470 }
3471
3472 # Handle multilib support.
3473 sub handle_multilib
3474 {
3475     if ($seen_multilib && $relative_dir eq '.')
3476     {
3477         $output_rules .= &file_contents ('multilib');
3478     }
3479 }
3480
3481
3482 # $BOOLEAN
3483 # &for_dist_common ($A, $B)
3484 # -------------------------
3485 # Subroutine for &handle_dist: sort files to dist.
3486 #
3487 # We put README first because it then becomes easier to make a
3488 # Usenet-compliant shar file (in these, README must be first).
3489 #
3490 # FIXME: do more ordering of files here.
3491 sub for_dist_common
3492 {
3493     return 0
3494         if $a eq $b;
3495     return -1
3496         if $a eq 'README';
3497     return 1
3498         if $b eq 'README';
3499     return $a cmp $b;
3500 }
3501
3502
3503 # handle_dist ($MAKEFILE)
3504 # -----------------------
3505 # Handle 'dist' target.
3506 sub handle_dist
3507 {
3508     my ($makefile) = @_;
3509
3510     # `make dist' isn't used in a Cygnus-style tree.
3511     # Omit the rules so that people don't try to use them.
3512     return if $cygnus_mode;
3513
3514     # Look for common files that should be included in distribution.
3515     # If the aux dir is set, and it does not have a Makefile.am, then
3516     # we check for these files there as well.
3517     my $check_aux = 0;
3518     my $auxdir = '';
3519     if ($relative_dir eq '.'
3520         && $config_aux_dir_set_in_configure_in)
3521     {
3522         ($auxdir = $config_aux_dir) =~ s,^\$\(top_srcdir\)/,,;
3523         if (! &is_make_dir ($auxdir))
3524         {
3525             $check_aux = 1;
3526         }
3527     }
3528     foreach my $cfile (@common_files)
3529     {
3530         if (-f ($relative_dir . "/" . $cfile)
3531             # The file might be absent, but if it can be built it's ok.
3532             || exists $targets{$cfile})
3533         {
3534             &push_dist_common ($cfile);
3535         }
3536
3537         # Don't use `elsif' here because a file might meaningfully
3538         # appear in both directories.
3539         if ($check_aux && -f ($auxdir . '/' . $cfile))
3540         {
3541             &push_dist_common ($auxdir . '/' . $cfile);
3542         }
3543     }
3544
3545     # We might copy elements from $configure_dist_common to
3546     # %dist_common if we think we need to.  If the file appears in our
3547     # directory, we would have discovered it already, so we don't
3548     # check that.  But if the file is in a subdir without a Makefile,
3549     # we want to distribute it here if we are doing `.'.  Ugly!
3550     if ($relative_dir eq '.')
3551     {
3552        foreach my $file (split (' ' , $configure_dist_common))
3553        {
3554            push_dist_common ($file)
3555              unless is_make_dir (dirname ($file));
3556        }
3557     }
3558
3559
3560
3561     # Files to distributed.  Don't use &variable_value_as_list_recursive
3562     # as it recursively expands `$(dist_pkgdata_DATA)' etc.
3563     check_variable_defined_unconditionally ('DIST_COMMON');
3564     my @dist_common = split (' ', variable_value ('DIST_COMMON', 'TRUE'));
3565     @dist_common = uniq (sort for_dist_common (@dist_common));
3566     pretty_print ('DIST_COMMON = ', "\t", @dist_common);
3567
3568     # Now that we've processed DIST_COMMON, disallow further attempts
3569     # to set it.
3570     $handle_dist_run = 1;
3571
3572     # Scan EXTRA_DIST to see if we need to distribute anything from a
3573     # subdir.  If so, add it to the list.  I didn't want to do this
3574     # originally, but there were so many requests that I finally
3575     # relented.
3576     if (variable_defined ('EXTRA_DIST'))
3577     {
3578         # FIXME: This should be fixed to work with conditionals.  That
3579         # will require only making the entries in %dist_dirs under the
3580         # appropriate condition.  This is meaningful if the nature of
3581         # the distribution should depend upon the configure options
3582         # used.
3583         foreach (&variable_value_as_list_recursive ('EXTRA_DIST', ''))
3584         {
3585             next if /^\@.*\@$/;
3586             next unless s,/+[^/]+$,,;
3587             $dist_dirs{$_} = 1
3588                 unless $_ eq '.';
3589         }
3590     }
3591
3592     # We have to check DIST_COMMON for extra directories in case the
3593     # user put a source used in AC_OUTPUT into a subdir.
3594     foreach (&variable_value_as_list_recursive ('DIST_COMMON', 'all'))
3595     {
3596         next if /^\@.*\@$/;
3597         next unless s,/+[^/]+$,,;
3598         $dist_dirs{$_} = 1
3599             unless $_ eq '.';
3600     }
3601
3602     # Rule to check whether a distribution is viable.
3603     my %transform = ('DISTCHECK-HOOK' => &target_defined ('distcheck-hook'),
3604                      'GETTEXT'        => $seen_gettext);
3605
3606     # Prepend $(distdir) to each directory given.
3607     my %rewritten = map { '$(distdir)/' . "$_" => 1 } keys %dist_dirs;
3608     $transform{'DISTDIRS'} = join (' ', sort keys %rewritten);
3609
3610     # If we have SUBDIRS, create all dist subdirectories and do
3611     # recursive build.
3612     if (variable_defined ('SUBDIRS'))
3613     {
3614         # If SUBDIRS is conditionally defined, then set DIST_SUBDIRS
3615         # to all possible directories, and use it.  If DIST_SUBDIRS is
3616         # defined, just use it.
3617         my $dist_subdir_name;
3618         # Note that we check DIST_SUBDIRS first on purpose.  At least
3619         # one project uses so many conditional subdirectories that
3620         # calling variable_conditionally_defined on SUBDIRS will cause
3621         # automake to grow to 150Mb.  Sigh.
3622         if (variable_defined ('DIST_SUBDIRS')
3623             || variable_conditionally_defined ('SUBDIRS'))
3624         {
3625             $dist_subdir_name = 'DIST_SUBDIRS';
3626             if (! variable_defined ('DIST_SUBDIRS'))
3627             {
3628                 define_pretty_variable
3629                   ('DIST_SUBDIRS', '',
3630                    uniq (&variable_value_as_list_recursive ('SUBDIRS', 'all')));
3631             }
3632         }
3633         else
3634         {
3635             $dist_subdir_name = 'SUBDIRS';
3636             # We always define this because that is what `distclean'
3637             # wants.
3638             define_pretty_variable ('DIST_SUBDIRS', '', '$(SUBDIRS)');
3639         }
3640
3641         $transform{'DIST_SUBDIR_NAME'} = $dist_subdir_name;
3642     }
3643
3644     # If the target `dist-hook' exists, make sure it is run.  This
3645     # allows users to do random weird things to the distribution
3646     # before it is packaged up.
3647     push (@dist_targets, 'dist-hook')
3648       if &target_defined ('dist-hook');
3649     $transform{'DIST-TARGETS'} = join(' ', @dist_targets);
3650
3651     # Defining $(DISTDIR).
3652     $transform{'DISTDIR'} = !variable_defined('distdir');
3653     $transform{'TOP_DISTDIR'} = backname ($relative_dir);
3654
3655     $output_rules .= &file_contents ('distdir', %transform);
3656 }
3657
3658
3659 # Handle subdirectories.
3660 sub handle_subdirs
3661 {
3662     return
3663       unless variable_defined ('SUBDIRS');
3664
3665     # Make sure each directory mentioned in SUBDIRS actually exists.
3666     foreach my $dir (&variable_value_as_list_recursive ('SUBDIRS', 'all'))
3667     {
3668         # Skip directories substituted by configure.
3669         next if $dir =~ /^\@.*\@$/;
3670
3671         if (! -d $am_relative_dir . '/' . $dir)
3672         {
3673             macro_error ('SUBDIRS',
3674                          "required directory $am_relative_dir/$dir does not exist");
3675             next;
3676         }
3677
3678         macro_error ('SUBDIRS', "directory should not contain `/'")
3679             if $dir =~ /\//;
3680     }
3681
3682     $output_rules .= &file_contents ('subdirs');
3683     variable_pretty_output ('RECURSIVE_TARGETS', 'TRUE');
3684 }
3685
3686
3687 # ($REGEN, @DEPENDENCIES)
3688 # &scan_aclocal_m4
3689 # ----------------
3690 # If aclocal.m4 creation is automated, return the list of its dependencies.
3691 sub scan_aclocal_m4
3692 {
3693     my $regen_aclocal = 0;
3694
3695     return (0, ())
3696       unless $relative_dir eq '.';
3697
3698     &examine_variable ('CONFIG_STATUS_DEPENDENCIES');
3699     &examine_variable ('CONFIGURE_DEPENDENCIES');
3700
3701     if (-f 'aclocal.m4')
3702     {
3703         &define_variable ("ACLOCAL_M4", '$(top_srcdir)/aclocal.m4');
3704         &push_dist_common ('aclocal.m4');
3705
3706         my $aclocal = new Automake::XFile "< aclocal.m4";
3707         my $line = $aclocal->getline;
3708         $regen_aclocal = $line =~ 'generated automatically by aclocal';
3709     }
3710
3711     my @ac_deps = ();
3712
3713     if (-f 'acinclude.m4')
3714     {
3715         $regen_aclocal = 1;
3716         push @ac_deps, 'acinclude.m4';
3717     }
3718
3719     if (variable_defined ('ACLOCAL_M4_SOURCES'))
3720     {
3721         push (@ac_deps, '$(ACLOCAL_M4_SOURCES)');
3722     }
3723     elsif (variable_defined ('ACLOCAL_AMFLAGS'))
3724     {
3725         # Scan all -I directories for m4 files.  These are our
3726         # dependencies.
3727         my $examine_next = 0;
3728         foreach my $amdir (&variable_value_as_list_recursive ('ACLOCAL_AMFLAGS', ''))
3729         {
3730             if ($examine_next)
3731             {
3732                 $examine_next = 0;
3733                 if ($amdir !~ /^\// && -d $amdir)
3734                 {
3735                     foreach my $ac_dep (&my_glob ($amdir . '/*.m4'))
3736                     {
3737                         $ac_dep =~ s/^\.\/+//;
3738                         push (@ac_deps, $ac_dep)
3739                           unless $ac_dep eq "aclocal.m4"
3740                             || $ac_dep eq "acinclude.m4";
3741                     }
3742                 }
3743             }
3744             elsif ($amdir eq '-I')
3745             {
3746                 $examine_next = 1;
3747             }
3748         }
3749     }
3750
3751     # Note that it might be possible that aclocal.m4 doesn't exist but
3752     # should be auto-generated.  This case probably isn't very
3753     # important.
3754
3755     return ($regen_aclocal, @ac_deps);
3756 }
3757
3758
3759 # @DEPENDENCY
3760 # &rewrite_inputs_into_dependencies ($ADD_SRCDIR, @INPUTS)
3761 # --------------------------------------------------------
3762 # Rewrite a list of input files into a form suitable to put on a
3763 # dependency list.  The idea is that if an input file has a directory
3764 # part the same as the current directory, then the directory part is
3765 # simply removed.  But if the directory part is different, then
3766 # $(top_srcdir) is prepended.  Among other things, this is used to
3767 # generate the dependency list for the output files generated by
3768 # AC_OUTPUT.  Consider what the dependencies should look like in this
3769 # case:
3770 #   AC_OUTPUT(src/out:src/in1:lib/in2)
3771 # The first argument, ADD_SRCDIR, is 1 if $(top_srcdir) should be added.
3772 # If 0 then files that require this addition will simply be ignored.
3773 sub rewrite_inputs_into_dependencies ($@)
3774 {
3775     my ($add_srcdir, @inputs) = @_;
3776     my @newinputs;
3777
3778     foreach my $single (@inputs)
3779     {
3780         if (dirname ($single) eq $relative_dir)
3781         {
3782             push (@newinputs, basename ($single));
3783         }
3784         elsif ($add_srcdir)
3785         {
3786             push (@newinputs, '$(top_srcdir)/' . $single);
3787         }
3788     }
3789
3790     return @newinputs;
3791 }
3792
3793 # Handle remaking and configure stuff.
3794 # We need the name of the input file, to do proper remaking rules.
3795 sub handle_configure
3796 {
3797     my ($local, $input, @secondary_inputs) = @_;
3798
3799     my $input_base = basename ($input);
3800     my $local_base = basename ($local);
3801
3802     my $amfile = $input_base . '.am';
3803     # We know we can always add '.in' because it really should be an
3804     # error if the .in was missing originally.
3805     my $infile = '$(srcdir)/' . $input_base . '.in';
3806     my $colon_infile = '';
3807     if ($local ne $input || @secondary_inputs)
3808     {
3809         $colon_infile = ':' . $input . '.in';
3810     }
3811     $colon_infile .= ':' . join (':', @secondary_inputs)
3812         if @secondary_inputs;
3813
3814     my @rewritten = rewrite_inputs_into_dependencies (1, @secondary_inputs);
3815
3816     my ($regen_aclocal_m4, @aclocal_m4_deps) = scan_aclocal_m4 ();
3817
3818     $output_rules .=
3819       &file_contents ('configure',
3820                       ('MAKEFILE'
3821                        => $local_base,
3822                        'MAKEFILE-DEPS'
3823                        => "@rewritten",
3824                        'CONFIG-MAKEFILE'
3825                        => ((($relative_dir eq '.') ? '$@' : '$(subdir)/$@')
3826                            . $colon_infile),
3827                        'MAKEFILE-IN'
3828                        => $infile,
3829                        'MAKEFILE-IN-DEPS'
3830                        => "@include_stack",
3831                        'MAKEFILE-AM'
3832                        => $amfile,
3833                        'STRICTNESS'
3834                        => $cygnus_mode ? 'cygnus' : $strictness_name,
3835                        'USE-DEPS'
3836                        => $cmdline_use_dependencies ? '' : ' --ignore-deps',
3837                        'MAKEFILE-AM-SOURCES'
3838                        =>  "$input$colon_infile",
3839                        'REGEN-ACLOCAL-M4'
3840                        => $regen_aclocal_m4,
3841                        'ACLOCAL_M4_DEPS'
3842                        => "@aclocal_m4_deps"));
3843
3844     if ($relative_dir eq '.')
3845     {
3846         &push_dist_common ('acconfig.h')
3847             if -f 'acconfig.h';
3848     }
3849
3850     # If we have a configure header, require it.
3851     my $hdr_index = 0;
3852     my @distclean_config;
3853     foreach my $spec (@config_headers)
3854       {
3855         $hdr_index += 1;
3856         # $CONFIG_H_PATH: config.h from top level.
3857         my ($config_h_path, @ins) = split_config_file_spec ($spec);
3858         my $config_h_dir = dirname ($config_h_path);
3859
3860         # If the header is in the current directory we want to build
3861         # the header here.  Otherwise, if we're at the topmost
3862         # directory and the header's directory doesn't have a
3863         # Makefile, then we also want to build the header.
3864         if ($relative_dir eq $config_h_dir
3865             || ($relative_dir eq '.' && ! &is_make_dir ($config_h_dir)))
3866         {
3867             my ($cn_sans_dir, $stamp_dir);
3868             if ($relative_dir eq $config_h_dir)
3869             {
3870                 $cn_sans_dir = basename ($config_h_path);
3871                 $stamp_dir = '';
3872             }
3873             else
3874             {
3875                 $cn_sans_dir = $config_h_path;
3876                 if ($config_h_dir eq '.')
3877                 {
3878                     $stamp_dir = '';
3879                 }
3880                 else
3881                 {
3882                     $stamp_dir = $config_h_dir . '/';
3883                 }
3884             }
3885
3886             # Compute relative path from directory holding output
3887             # header to directory holding input header.  FIXME:
3888             # doesn't handle case where we have multiple inputs.
3889             my $in0_sans_dir;
3890             if (dirname ($ins[0]) eq $relative_dir)
3891             {
3892                 $in0_sans_dir = basename ($ins[0]);
3893             }
3894             else
3895             {
3896                 $in0_sans_dir = backname ($relative_dir) . '/' . $ins[0];
3897             }
3898
3899             require_file ($config_header_location, FOREIGN, $in0_sans_dir);
3900
3901             # Header defined and in this directory.
3902             my @files;
3903             if (-f $config_h_path . '.top')
3904             {
3905                 push (@files, "$cn_sans_dir.top");
3906             }
3907             if (-f $config_h_path . '.bot')
3908             {
3909                 push (@files, "$cn_sans_dir.bot");
3910             }
3911
3912             push_dist_common (@files);
3913
3914             # For now, acconfig.h can only appear in the top srcdir.
3915             if (-f 'acconfig.h')
3916             {
3917                 push (@files, '$(top_srcdir)/acconfig.h');
3918             }
3919
3920             my $stamp = "${stamp_dir}stamp-h${hdr_index}";
3921             $output_rules .=
3922               file_contents ('remake-hdr',
3923                              ('FILES'         => "@files",
3924                               'CONFIG_H'      => $cn_sans_dir,
3925                               'CONFIG_HIN'    => $in0_sans_dir,
3926                               'CONFIG_H_PATH' => $config_h_path,
3927                               'STAMP'         => "$stamp"));
3928
3929             push @distclean_config, $cn_sans_dir;
3930         }
3931     }
3932
3933     $output_rules .= file_contents ('clean-hdr',
3934                                     ('FILES' => "@distclean_config"))
3935       if @distclean_config;
3936
3937     # Set location of mkinstalldirs.
3938     define_variable ('mkinstalldirs',
3939                      ('$(SHELL) ' . $config_aux_dir . '/mkinstalldirs'));
3940
3941     macro_error ('CONFIG_HEADER',
3942                  "`CONFIG_HEADER' is an anachronism; now determined from `$configure_ac'")
3943         if variable_defined ('CONFIG_HEADER');
3944
3945     my @config_h;
3946     foreach my $spec (@config_headers)
3947       {
3948         my ($out, @ins) = split_config_file_spec ($spec);
3949         # Generate CONFIG_HEADER define.
3950         if ($relative_dir eq dirname ($out))
3951         {
3952             push @config_h, basename ($out);
3953         }
3954         else
3955         {
3956             push @config_h, "\$(top_builddir)/$out";
3957         }
3958     }
3959     define_variable ("CONFIG_HEADER", "@config_h")
3960       if @config_h;
3961
3962     # Now look for other files in this directory which must be remade
3963     # by config.status, and generate rules for them.
3964     my @actual_other_files = ();
3965     foreach my $lfile (@other_input_files)
3966     {
3967         my $file;
3968         my @inputs;
3969         if ($lfile =~ /^([^:]*):(.*)$/)
3970         {
3971             # This is the ":" syntax of AC_OUTPUT.
3972             $file = $1;
3973             @inputs = split (':', $2);
3974         }
3975         else
3976         {
3977             # Normal usage.
3978             $file = $lfile;
3979             @inputs = $file . '.in';
3980         }
3981
3982         # Automake files should not be stored in here, but in %MAKE_LIST.
3983         prog_error ("$lfile in \@other_input_files")
3984           if -f $file . '.am';
3985
3986         my $local = basename ($file);
3987
3988         # Make sure the dist directory for each input file is created.
3989         # We only have to do this at the topmost level though.  This
3990         # is a bit ugly but it easier than spreading out the logic,
3991         # especially in cases like AC_OUTPUT(foo/out:bar/in), where
3992         # there is no Makefile in bar/.
3993         if ($relative_dir eq '.')
3994         {
3995             foreach (@inputs)
3996             {
3997                 $dist_dirs{dirname ($_)} = 1;
3998             }
3999         }
4000
4001         # We skip files that aren't in this directory.  However, if
4002         # the file's directory does not have a Makefile, and we are
4003         # currently doing `.', then we create a rule to rebuild the
4004         # file in the subdir.
4005         my $fd = dirname ($file);
4006         if ($fd ne $relative_dir)
4007         {
4008             if ($relative_dir eq '.' && ! &is_make_dir ($fd))
4009             {
4010                 $local = $file;
4011             }
4012             else
4013             {
4014                 next;
4015             }
4016         }
4017
4018         # Some users have been tempted to put `stamp-h' in the
4019         # AC_OUTPUT line.  This won't do the right thing, so we
4020         # explicitly fail here.
4021         if ($local eq 'stamp-h')
4022         {
4023             # FIXME: allow real filename.
4024             file_error ($ac_config_files_location,
4025                         'stamp-h should not appear in AC_OUTPUT');
4026             next;
4027         }
4028
4029         my @rewritten_inputs = rewrite_inputs_into_dependencies (1, @inputs);
4030         $output_rules .= ($local . ': '
4031                           . '$(top_builddir)/config.status '
4032                           . "@rewritten_inputs\n"
4033                           . "\t"
4034                           . 'cd $(top_builddir) && '
4035                           . '$(SHELL) ./config.status '
4036                           . ($relative_dir eq '.' ? '' : '$(subdir)/')
4037                           . '$@'
4038                           . "\n");
4039         push (@actual_other_files, $local);
4040
4041         # Require all input files.
4042         require_file ($ac_config_files_location, FOREIGN,
4043                       rewrite_inputs_into_dependencies (0, @inputs));
4044     }
4045
4046     # These files get removed by "make clean".
4047     define_pretty_variable ('CONFIG_CLEAN_FILES', '', @actual_other_files);
4048 }
4049
4050 # Handle C headers.
4051 sub handle_headers
4052 {
4053     my @r = &am_install_var ('-defaultdist', 'header', 'HEADERS', 'include',
4054                              'oldinclude', 'pkginclude',
4055                              'noinst', 'check');
4056     foreach (@r)
4057     {
4058         next unless /\..*$/;
4059         &saw_extension ($&);
4060     }
4061 }
4062
4063 sub handle_gettext
4064 {
4065     return if ! $seen_gettext || $relative_dir ne '.';
4066
4067     if (! variable_defined ('SUBDIRS'))
4068     {
4069         conf_error ("AM_GNU_GETTEXT used but SUBDIRS not defined");
4070         return;
4071     }
4072
4073     my @subdirs = &variable_value_as_list_recursive ('SUBDIRS', 'all');
4074     macro_error ('SUBDIRS',
4075                  "AM_GNU_GETTEXT used but `po' not in SUBDIRS")
4076         if ! grep ('po', @subdirs);
4077     macro_error ('SUBDIRS',
4078                  "AM_GNU_GETTEXT used but `intl' not in SUBDIRS")
4079         if ! grep ('intl', @subdirs);
4080
4081     require_file ($ac_gettext_location, GNU, 'ABOUT-NLS');
4082 }
4083
4084 # Handle footer elements.
4085 sub handle_footer
4086 {
4087     # NOTE don't use define_pretty_variable here, because
4088     # $contents{...} is already defined.
4089     $output_vars .= 'SOURCES = ' . variable_value ('SOURCES') . "\n\n"
4090       if variable_value ('SOURCES');
4091
4092
4093     target_error ('.SUFFIXES',
4094                   "use variable `SUFFIXES', not target `.SUFFIXES'")
4095       if target_defined ('.SUFFIXES');
4096
4097     # Note: AIX 4.1 /bin/make will fail if any suffix rule appears
4098     # before .SUFFIXES.  So we make sure that .SUFFIXES appears before
4099     # anything else, by sticking it right after the default: target.
4100     $output_header .= ".SUFFIXES:\n";
4101     if (@suffixes || variable_defined ('SUFFIXES'))
4102     {
4103         # Make sure suffixes has unique elements.  Sort them to ensure
4104         # the output remains consistent.  However, $(SUFFIXES) is
4105         # always at the start of the list, unsorted.  This is done
4106         # because make will choose rules depending on the ordering of
4107         # suffixes, and this lets the user have some control.  Push
4108         # actual suffixes, and not $(SUFFIXES).  Some versions of make
4109         # do not like variable substitutions on the .SUFFIXES line.
4110         my @user_suffixes = (variable_defined ('SUFFIXES')
4111                              ? &variable_value_as_list_recursive ('SUFFIXES', '')
4112                              : ());
4113
4114         my %suffixes = map { $_ => 1 } @suffixes;
4115         delete @suffixes{@user_suffixes};
4116
4117         $output_header .= (".SUFFIXES: "
4118                            . join (' ', @user_suffixes, sort keys %suffixes)
4119                            . "\n");
4120     }
4121
4122     $output_trailer .= file_contents ('footer');
4123 }
4124
4125 # Deal with installdirs target.
4126 sub handle_installdirs ()
4127 {
4128     $output_rules .=
4129       &file_contents ('install',
4130                       ('_am_installdirs'
4131                        => variable_value ('_am_installdirs') || '',
4132                        'installdirs-local'
4133                        => (target_defined ('installdirs-local')
4134                            ? ' installdirs-local' : '')));
4135 }
4136
4137
4138 # Deal with all and all-am.
4139 sub handle_all ($)
4140 {
4141     my ($makefile) = @_;
4142
4143     # Output `all-am'.
4144
4145     # Put this at the beginning for the sake of non-GNU makes.  This
4146     # is still wrong if these makes can run parallel jobs.  But it is
4147     # right enough.
4148     unshift (@all, basename ($makefile));
4149
4150     foreach my $spec (@config_headers)
4151       {
4152         my ($out, @ins) = split_config_file_spec ($spec);
4153         push (@all, basename ($out))
4154           if dirname ($out) eq $relative_dir;
4155       }
4156
4157     # Install `all' hooks.
4158     if (&target_defined ("all-local"))
4159     {
4160       push (@all, "all-local");
4161       &depend ('.PHONY', "all-local");
4162     }
4163
4164     &pretty_print_rule ("all-am:", "\t\t", @all);
4165     &depend ('.PHONY', 'all-am', 'all');
4166
4167
4168     # Output `all'.
4169
4170     my @local_headers = ();
4171     push @local_headers, '$(BUILT_SOURCES)'
4172       if variable_defined ('BUILT_SOURCES');
4173     foreach my $spec (@config_headers)
4174       {
4175         my ($out, @ins) = split_config_file_spec ($spec);
4176         push @local_headers, basename ($out)
4177           if dirname ($out) eq $relative_dir;
4178       }
4179
4180     if (@local_headers)
4181       {
4182         # We need to make sure config.h is built before we recurse.
4183         # We also want to make sure that built sources are built
4184         # before any ordinary `all' targets are run.  We can't do this
4185         # by changing the order of dependencies to the "all" because
4186         # that breaks when using parallel makes.  Instead we handle
4187         # things explicitly.
4188         $output_all .= ("all: @local_headers"
4189                         . "\n\t"
4190                         . '$(MAKE) $(AM_MAKEFLAGS) '
4191                         . (variable_defined ('SUBDIRS')
4192                            ? 'all-recursive' : 'all-am')
4193                         . "\n\n");
4194       }
4195     else
4196       {
4197         $output_all .= "all: " . (variable_defined ('SUBDIRS')
4198                                   ? 'all-recursive' : 'all-am') . "\n\n";
4199       }
4200 }
4201
4202
4203 # Handle check merge target specially.
4204 sub do_check_merge_target
4205 {
4206     if (&target_defined ('check-local'))
4207     {
4208         # User defined local form of target.  So include it.
4209         push (@check_tests, 'check-local');
4210         &depend ('.PHONY', 'check-local');
4211     }
4212
4213     # In --cygnus mode, check doesn't depend on all.
4214     if ($cygnus_mode)
4215     {
4216         # Just run the local check rules.
4217         &pretty_print_rule ('check-am:', "\t\t", @check);
4218     }
4219     else
4220     {
4221         # The check target must depend on the local equivalent of
4222         # `all', to ensure all the primary targets are built.  Then it
4223         # must build the local check rules.
4224         $output_rules .= "check-am: all-am\n";
4225         &pretty_print_rule ("\t\$(MAKE) \$(AM_MAKEFLAGS)", "\t  ",
4226                             @check)
4227             if @check;
4228     }
4229     &pretty_print_rule ("\t\$(MAKE) \$(AM_MAKEFLAGS)", "\t  ",
4230                         @check_tests)
4231         if @check_tests;
4232
4233     &depend ('.PHONY', 'check', 'check-am');
4234     $output_rules .= ("check: "
4235                       . (variable_defined ('SUBDIRS')
4236                          ? 'check-recursive' : 'check-am')
4237                       . "\n");
4238 }
4239
4240 # Handle all 'clean' targets.
4241 sub handle_clean
4242 {
4243     my %transform;
4244
4245     # Don't include `MAINTAINER'; it is handled specially below.
4246     foreach my $name ('MOSTLY', '', 'DIST')
4247     {
4248       $transform{"${name}CLEAN"} = variable_defined ("${name}CLEANFILES");
4249     }
4250
4251     # Built sources are automatically removed by maintainer-clean.
4252     push (@maintainer_clean_files, '$(BUILT_SOURCES)')
4253         if variable_defined ('BUILT_SOURCES');
4254     push (@maintainer_clean_files, '$(MAINTAINERCLEANFILES)')
4255         if variable_defined ('MAINTAINERCLEANFILES');
4256
4257     $output_rules .= &file_contents ('clean',
4258                                      (%transform,
4259                                       'MCFILES'
4260                                       # Join with no space to avoid
4261                                       # spurious `test -z' success at
4262                                       # runtime.
4263                                       => join ('', @maintainer_clean_files),
4264                                       'MFILES'
4265                                       # A space is required in the join here.
4266                                       => "@maintainer_clean_files"));
4267 }
4268
4269
4270 # &depend ($CATEGORY, @DEPENDENDEES)
4271 # ----------------------------------
4272 # The target $CATEGORY depends on @DEPENDENDEES.
4273 sub depend
4274 {
4275     my ($category, @dependendees) = @_;
4276     {
4277       push (@{$dependencies{$category}}, @dependendees);
4278     }
4279 }
4280
4281
4282 # &target_cmp ($A, $B)
4283 # --------------------
4284 # Subroutine for &handle_factored_dependencies to let `.PHONY' be last.
4285 sub target_cmp
4286 {
4287     return 0
4288         if $a eq $b;
4289     return -1
4290         if $b eq '.PHONY';
4291     return 1
4292         if $a eq '.PHONY';
4293     return $a cmp $b;
4294 }
4295
4296
4297 # &handle_factored_dependencies ()
4298 # --------------------------------
4299 # Handle everything related to gathered targets.
4300 sub handle_factored_dependencies
4301 {
4302     # Reject bad hooks.
4303     foreach my $utarg ('uninstall-data-local', 'uninstall-data-hook',
4304                        'uninstall-exec-local', 'uninstall-exec-hook')
4305     {
4306         if (&target_defined ($utarg))
4307         {
4308             my $x = $utarg;
4309             $x =~ s/(data|exec)-//;
4310             target_error ($utarg, "use `$x', not `$utarg'");
4311         }
4312     }
4313
4314     if (&target_defined ('install-local'))
4315     {
4316         target_error ('install-local',
4317                       "use `install-data-local' or `install-exec-local', "
4318                       . "not `install-local'");
4319     }
4320
4321     if (!defined $options{'no-installinfo'}
4322         && &target_defined ('install-info-local'))
4323     {
4324         target_error ('install-info-local',
4325                       "`install-info-local' target defined but "
4326                       . "`no-installinfo' option not in use");
4327     }
4328
4329     # Install the -local hooks.
4330     foreach (keys %dependencies)
4331     {
4332       # Hooks are installed on the -am targets.
4333       s/-am$// or next;
4334       if (&target_defined ("$_-local"))
4335         {
4336           depend ("$_-am", "$_-local");
4337           &depend ('.PHONY', "$_-local");
4338         }
4339     }
4340
4341     # Install the -hook hooks.
4342     # FIXME: Why not be as liberal as we are with -local hooks?
4343     foreach ('install-exec', 'install-data', 'uninstall')
4344     {
4345       if (&target_defined ("$_-hook"))
4346         {
4347           $actions{"$_-am"} .=
4348             ("\t\@\$(NORMAL_INSTALL)\n"
4349              . "\t" . '$(MAKE) $(AM_MAKEFLAGS) ' . "$_-hook\n");
4350         }
4351     }
4352
4353     # All the required targets are phony.
4354     depend ('.PHONY', keys %required_targets);
4355
4356     # Actually output gathered targets.
4357     foreach (sort target_cmp keys %dependencies)
4358     {
4359         # If there is nothing about this guy, skip it.
4360         next
4361           unless (@{$dependencies{$_}}
4362                   || $actions{$_}
4363                   || $required_targets{$_});
4364         &pretty_print_rule ("$_:", "\t",
4365                             uniq (sort @{$dependencies{$_}}));
4366         $output_rules .= $actions{$_}
4367           if defined $actions{$_};
4368         $output_rules .= "\n";
4369     }
4370 }
4371
4372
4373 # &handle_tests_dejagnu ()
4374 # ------------------------
4375 sub handle_tests_dejagnu
4376 {
4377     push (@check_tests, 'check-DEJAGNU');
4378     $output_rules .= file_contents ('dejagnu');
4379 }
4380
4381
4382 # Handle TESTS variable and other checks.
4383 sub handle_tests
4384 {
4385     if (defined $options{'dejagnu'})
4386     {
4387         &handle_tests_dejagnu;
4388     }
4389     else
4390     {
4391         foreach my $c ('DEJATOOL', 'RUNTEST', 'RUNTESTFLAGS')
4392         {
4393             macro_error ($c,
4394                          "`$c' defined but `dejagnu' not in `AUTOMAKE_OPTIONS'")
4395               if variable_defined ($c);
4396         }
4397     }
4398
4399     if (variable_defined ('TESTS'))
4400     {
4401         push (@check_tests, 'check-TESTS');
4402         $output_rules .= &file_contents ('check');
4403     }
4404 }
4405
4406 # Handle Emacs Lisp.
4407 sub handle_emacs_lisp
4408 {
4409     my @elfiles = &am_install_var ('-candist', 'lisp', 'LISP',
4410                                    'lisp', 'noinst');
4411
4412     return if ! @elfiles;
4413
4414     # Generate .elc files.
4415     my @elcfiles = map { $_ . 'c' } @elfiles;
4416     define_pretty_variable ('ELCFILES', '', @elcfiles);
4417
4418     push (@all, '$(ELCFILES)');
4419
4420     &am_error ("`lisp_LISP' defined but `AM_PATH_LISPDIR' not in `$configure_ac'")
4421       if ! $am_lispdir_location && variable_defined ('lisp_LISP');
4422
4423     require_conf_file ($am_lispdir_location, FOREIGN, 'elisp-comp');
4424     &define_variable ('elisp_comp', $config_aux_dir . '/elisp-comp');
4425 }
4426
4427 # Handle Python
4428 sub handle_python
4429 {
4430     my @pyfiles = &am_install_var ('-defaultdist', 'python', 'PYTHON',
4431                                    'python', 'noinst');
4432     return if ! @pyfiles;
4433
4434     # Found some python.
4435     &am_error ("`python_PYTHON' defined but `AM_PATH_PYTHON' not in `$configure_ac'")
4436         if ! $pythondir_location && variable_defined ('python_PYTHON');
4437
4438     require_conf_file ($pythondir_location, FOREIGN, 'py-compile');
4439     &define_variable ('py_compile', $config_aux_dir . '/py-compile');
4440 }
4441
4442 # Handle Java.
4443 sub handle_java
4444 {
4445     my @sourcelist = &am_install_var ('-candist',
4446                                       'java', 'JAVA',
4447                                       'java', 'noinst', 'check');
4448     return if ! @sourcelist;
4449
4450     my @prefix = am_primary_prefixes ('JAVA', 1,
4451                                       'java', 'noinst', 'check');
4452
4453     my $dir;
4454     foreach my $curs (@prefix)
4455       {
4456         next
4457           if $curs eq 'EXTRA';
4458
4459         macro_error ($curs . '_JAVA',
4460                      "multiple _JAVA primaries in use")
4461           if defined $dir;
4462         $dir = $curs;
4463       }
4464
4465
4466     push (@all, 'class' . $dir . '.stamp');
4467 }
4468
4469
4470 # Handle some of the minor options.
4471 sub handle_minor_options
4472 {
4473     if (defined $options{'readme-alpha'})
4474     {
4475         if ($relative_dir eq '.')
4476         {
4477             if ($package_version !~ /^$GNITS_VERSION_PATTERN$/)
4478             {
4479                 # FIXME: allow real filename.
4480                 file_error ($package_version_location,
4481                             "version `$package_version' doesn't follow Gnits standards");
4482             }
4483             elsif (defined $1 && -f 'README-alpha')
4484             {
4485                 # This means we have an alpha release.  See
4486                 # GNITS_VERSION_PATTERN for details.
4487                 require_file_with_macro ('AUTOMAKE_OPTIONS',
4488                                          FOREIGN, 'README-alpha');
4489             }
4490         }
4491     }
4492 }
4493
4494 ################################################################
4495
4496 # ($OUTPUT, @INPUTS)
4497 # &split_config_file_spec ($SPEC)
4498 # -------------------------------
4499 # Decode the Autoconf syntax for config files (files, headers, links
4500 # etc.).
4501 sub split_config_file_spec ($)
4502 {
4503   my ($spec) = @_;
4504   my ($output, @inputs) = split (/:/, $spec);
4505
4506   push @inputs, "$output.in"
4507     unless @inputs;
4508
4509   return ($output, @inputs);
4510 }
4511
4512
4513 my %make_list;
4514
4515 # &scan_autoconf_config_files ($CONFIG-FILES)
4516 # -------------------------------------------
4517 # Study $CONFIG-FILES which is the first argument to AC_CONFIG_FILES
4518 # (or AC_OUTPUT).
4519 sub scan_autoconf_config_files
4520 {
4521     my ($config_files) = @_;
4522     # Look at potential Makefile.am's.
4523     foreach (split ' ', $config_files)
4524     {
4525         # Must skip empty string for Perl 4.
4526         next if $_ eq "\\" || $_ eq '';
4527
4528         # Handle $local:$input syntax.  Note that we ignore
4529         # every input file past the first, though we keep
4530         # those around for later.
4531         my ($local, $input, @rest) = split (/:/);
4532         if (! $input)
4533         {
4534             $input = $local;
4535         }
4536         else
4537         {
4538             # FIXME: should be error if .in is missing.
4539             $input =~ s/\.in$//;
4540         }
4541
4542         if (-f $input . '.am')
4543         {
4544             # We have a file that automake should generate.
4545             $make_list{$input} = join (':', ($local, @rest));
4546         }
4547         else
4548         {
4549             # We have a file that automake should cause to be
4550             # rebuilt, but shouldn't generate itself.
4551             push (@other_input_files, $_);
4552         }
4553     }
4554 }
4555
4556
4557 # &scan_autoconf_traces ($FILENAME)
4558 # ---------------------------------
4559 # FIXME: For the time being, we don't care about the FILENAME.
4560 sub scan_autoconf_traces ($)
4561 {
4562   my ($filename) = @_;
4563
4564   my @traced = qw(AC_CANONICAL_HOST
4565                   AC_CANONICAL_SYSTEM
4566                   AC_CONFIG_AUX_DIR
4567                   AC_CONFIG_FILES
4568                   AC_INIT
4569                   AC_LIBSOURCE
4570                   AC_PROG_LEX
4571                   AC_PROG_LIBTOOL AM_PROG_LIBTOOL
4572                   AC_SUBST
4573                   AM_AUTOMAKE_VERSION
4574                   AM_CONDITIONAL
4575                   AM_CONFIG_HEADER
4576                   AM_C_PROTOTYPES
4577                   AM_GNU_GETTEXT
4578                   AM_INIT_AUTOMAKE
4579                   AM_MAINTAINER_MODE
4580                   AM_PATH_LISPDIR
4581                   AM_PATH_PYTHON
4582                   AM_PROG_CC_C_O);
4583
4584   my $traces = "$ENV{amtraces} ";
4585
4586   # Use a separator unlikely to be used, not `:', the default, which
4587   # has a precise meaning for AC_CONFIG_FILES and so on.
4588   $traces .= join (' ',
4589                    map { "--trace=$_" . ':\$f:\$l::\$n::\${::}%' } @traced);
4590
4591   my $tracefh = new Automake::XFile ("$traces |");
4592   verbose "reading $traces";
4593
4594   while ($_ = $tracefh->getline)
4595     {
4596       chomp;
4597       my ($here, @args) = split /::/;
4598       my $macro = $args[0];
4599
4600       # Alphabetical ordering please.
4601       if ($macro eq 'AC_CANONICAL_HOST')
4602         {
4603           if (! $seen_canonical)
4604             {
4605               $seen_canonical = AC_CANONICAL_HOST;
4606               $canonical_location = $here;
4607             };
4608         }
4609       elsif ($macro eq 'AC_CANONICAL_SYSTEM')
4610         {
4611           $seen_canonical = AC_CANONICAL_SYSTEM;
4612           $canonical_location = $here;
4613         }
4614       elsif ($macro eq 'AC_CONFIG_AUX_DIR')
4615         {
4616           @config_aux_path = $args[1];
4617           $config_aux_dir_set_in_configure_in = 1;
4618         }
4619       elsif ($macro eq 'AC_CONFIG_FILES')
4620         {
4621           # Look at potential Makefile.am's.
4622           $ac_config_files_location = $here;
4623           &scan_autoconf_config_files ($args[1]);
4624         }
4625       elsif ($macro eq 'AC_INIT')
4626         {
4627           if (defined $args[2])
4628             {
4629               $package_version = $args[2];
4630               $package_version_location = $here;
4631             }
4632         }
4633       elsif ($macro eq 'AC_LIBSOURCE')
4634         {
4635           $libsources{$args[1]} = $here;
4636         }
4637       elsif ($macro =~ /^A(C|M)_PROG_LIBTOOL$/)
4638         {
4639           $seen_libtool = $here;
4640         }
4641       elsif ($macro eq 'AC_PROG_LEX')
4642         {
4643           $seen_prog_lex = $here;
4644         }
4645       elsif ($macro eq 'AC_SUBST')
4646         {
4647           # Just check for alphanumeric in AC_SUBST.  If you do
4648           # AC_SUBST(5), then too bad.
4649           $configure_vars{$args[1]} = $here
4650             if $args[1] =~ /^\w+$/;
4651         }
4652       elsif ($macro eq 'AM_AUTOMAKE_VERSION')
4653         {
4654           file_error ($here,
4655                       "version mismatch.  This is Automake $VERSION,\n" .
4656                       "but the definition used by this AM_INIT_AUTOMAKE\n" .
4657                       "comes from Automake $args[1].  You should recreate\n" .
4658                       "aclocal.m4 with aclocal and run automake again.\n")
4659               if ($VERSION ne $args[1]);
4660
4661           $seen_automake_version = 1;
4662         }
4663       elsif ($macro eq 'AM_CONDITIONAL')
4664         {
4665           $configure_cond{$args[1]} = $here;
4666         }
4667       elsif ($macro eq 'AM_CONFIG_HEADER')
4668         {
4669           $config_header_location = $here;
4670           push @config_headers, split (' ', $args[1]);
4671         }
4672       elsif ($macro eq 'AM_C_PROTOTYPES')
4673         {
4674           $am_c_prototypes = $here;
4675         }
4676       elsif ($macro eq 'AM_GNU_GETTEXT')
4677         {
4678           $seen_gettext = $here;
4679           $ac_gettext_location = $here;
4680         }
4681       elsif ($macro eq 'AM_INIT_AUTOMAKE')
4682         {
4683           $seen_init_automake = $here;
4684           if (defined $args[2])
4685             {
4686               $package_version = $args[2];
4687               $package_version_location = $here;
4688             }
4689           elsif (defined $args[1])
4690             {
4691               $global_options = $args[1];
4692             }
4693         }
4694       elsif ($macro eq 'AM_MAINTAINER_MODE')
4695         {
4696           $seen_maint_mode = $here;
4697         }
4698       elsif ($macro eq 'AM_PATH_LISPDIR')
4699         {
4700           $am_lispdir_location = $here;
4701         }
4702       elsif ($macro eq 'AM_PATH_PYTHON')
4703         {
4704           $pythondir_location = $here;
4705         }
4706       elsif ($macro eq 'AM_PROG_CC_C_O')
4707         {
4708           $seen_cc_c_o = $here;
4709         }
4710    }
4711 }
4712
4713
4714 # &scan_one_autoconf_file ($FILENAME)
4715 # -----------------------------------
4716 # Scan one file for interesting things.  Subroutine of
4717 # &scan_autoconf_files.
4718 sub scan_one_autoconf_file
4719 {
4720     my ($filename) = @_;
4721
4722     # Some macros already provide the right traces to enable generic
4723     # code and specific arguments, instead of dedicated code.  But
4724     # currently we don't handle traces.  Rewrite these dedicated
4725     # macros handling into the generic macro invocation, and let our
4726     # generic case handle them.
4727
4728     my %generalize =
4729       (
4730        'AC_FUNC_ALLOCA'           => 'AC_LIBSOURCES([alloca.c])',
4731        'AC_FUNC_GETLOADAVG'       => 'AC_LIBSOURCES([getloadavg.c])',
4732        'AC_FUNC_MEMCMP'           => 'AC_LIBSOURCES([memcmp.c])',
4733        'AC_STRUCT_ST_BLOCKS'      => 'AC_LIBSOURCES([fileblocks.c])',
4734        'A[CM]_REPLACE_GNU_GETOPT' => 'AC_LIBSOURCES([getopt.c, getopt1.c])',
4735        'A[CM]_FUNC_STRTOD'        => 'AC_LIBSOURCES([strtod.c])',
4736        'AM_WITH_REGEX'      => 'AC_LIBSOURCES([rx.c, rx.h, regex.c, regex.h])',
4737        'AC_FUNC_MKTIME'           => 'AC_LIBSOURCES([mktime.c])',
4738        'A[CM]_FUNC_ERROR_AT_LINE' => 'AC_LIBSOURCES([error.c, error.h])',
4739        'A[CM]_FUNC_OBSTACK'       => 'AC_LIBSOURCES([obstack.c, obstack.h])',
4740       );
4741
4742     my $configfh = new Automake::XFile ("< $filename");
4743     verbose "reading $filename";
4744
4745     my ($in_ac_output, $in_ac_replace) = (0, 0);
4746     while ($_ = $configfh->getline)
4747     {
4748         # Remove comments from current line.
4749         s/\bdnl\b.*$//;
4750         s/\#.*$//;
4751
4752         # Skip macro definitions.  Otherwise we might be confused into
4753         # thinking that a macro that was only defined was actually
4754         # used.
4755         next if /AC_DEFUN/;
4756
4757         # Follow includes.  This is a weirdness commonly in use at
4758         # Cygnus and hopefully nowhere else.
4759         if (/sinclude\((.*)\)/ && -f $1)
4760         {
4761             # $_ being local, if we don't preserve it, when coming
4762             # back we will have $_ undefined, which is bad for the
4763             # the rest of this routine.
4764             my $underscore = $_;
4765             &scan_one_autoconf_file ($1);
4766             $_ = $underscore;
4767         }
4768
4769         for my $generalize (keys %generalize)
4770           {
4771             s/\b$generalize\b/$generalize{$generalize}/g;
4772           }
4773
4774
4775         my $here = "$filename:$.";
4776
4777         # Populate libobjs array.
4778         if (/LIBOBJS="(.*)\s+\$LIBOBJS"/
4779                || /LIBOBJS="\$LIBOBJS\s+(.*)"/)
4780         {
4781             foreach my $libobj_iter (split (' ', $1))
4782             {
4783                 if ($libobj_iter =~ /^(.*)\.o(bj)?$/
4784                     || $libobj_iter =~ /^(.*)\.\$ac_objext$/
4785                     || $libobj_iter =~ /^(.*)\.\$\{ac_objext\}$/)
4786                 {
4787                     $libsources{$1 . '.c'} = $here;
4788                 }
4789             }
4790         }
4791         elsif (/AC_LIBOBJ\(([^)]+)\)/)
4792         {
4793             $libsources{unquote_m4_arg ($1) . ".c"} = $here;
4794         }
4795         elsif (/AC_LIBSOURCE\(([^)]+)\)/)
4796         {
4797             $libsources{&unquote_m4_arg ($1)} = $here;
4798         }
4799         elsif (/AC_LIBSOURCES\(([^)]+)\)/)
4800         {
4801             foreach my $lc_iter (split (/[, ]+/, &unquote_m4_arg ($1)))
4802             {
4803                 $libsources{$lc_iter} = $here;
4804             }
4805         }
4806
4807         if (! $in_ac_replace && s/AC_REPLACE_FUNCS\s*\(\[?//)
4808         {
4809             $in_ac_replace = 1;
4810         }
4811         if ($in_ac_replace)
4812         {
4813             $in_ac_replace = 0 if s/[\]\)].*$//;
4814             # Remove trailing backslash.
4815             s/\\$//;
4816             foreach (split)
4817             {
4818                 # Need to skip empty elements for Perl 4.
4819                 next if $_ eq '';
4820                 $libsources{$_ . '.c'} = $here;
4821             }
4822         }
4823
4824         if (/$obsolete_rx/o)
4825         {
4826             my $hint = '';
4827             if ($obsolete_macros{$1} ne '')
4828             {
4829                 $hint = '; ' . $obsolete_macros{$1};
4830             }
4831             file_error ($here, "`$1' is obsolete$hint");
4832         }
4833
4834         # Process the AC_OUTPUT and AC_CONFIG_FILES macros.
4835         if (! $in_ac_output && s/(AC_(OUTPUT|CONFIG_FILES))\s*\(\[?//)
4836         {
4837             $in_ac_output = $1;
4838             $ac_config_files_location = $here;
4839         }
4840         if ($in_ac_output)
4841         {
4842             my $closing = 0;
4843             if (s/[\]\),].*$//)
4844             {
4845                 $in_ac_output = 0;
4846                 $closing = 1;
4847             }
4848
4849             # Look at potential Makefile.am's.
4850             &scan_autoconf_config_files ($_);
4851
4852             if ($closing
4853                 && scalar keys %make_list == 0
4854                 && @other_input_files == 0)
4855             {
4856                 file_error ($ac_config_files_location,
4857                             "no files mentioned in `$in_ac_output'");
4858                 exit 1;
4859             }
4860         }
4861
4862         if (/$AC_CONFIG_AUX_DIR_PATTERN/o)
4863         {
4864             @config_aux_path = &unquote_m4_arg ($1);
4865             $config_aux_dir_set_in_configure_in = $here;
4866         }
4867
4868         # Check for ansi2knr.
4869         $am_c_prototypes = $here if /AM_C_PROTOTYPES/;
4870
4871         # Check for `-c -o' code.
4872         $seen_cc_c_o = $here if /AM_PROG_CC_C_O/;
4873
4874         # Check for NLS support.
4875         if (/AM_GNU_GETTEXT/)
4876         {
4877             $seen_gettext = $here;
4878             $ac_gettext_location = $here;
4879         }
4880
4881         # Handle configuration headers.  A config header of `[$1]'
4882         # means we are actually scanning AM_CONFIG_HEADER from
4883         # aclocal.m4.  Same thing with a leading underscore.
4884         if (/(?<!_)A([CM])_CONFIG_HEADERS?\s*\((.*)\)/
4885             && $2 ne '[$1]')
4886         {
4887             file_error ($here,
4888                "`automake requires `AM_CONFIG_HEADER', not `AC_CONFIG_HEADER'")
4889               if $1 eq 'C';
4890
4891             $config_header_location = $here;
4892             push @config_headers, split (' ', unquote_m4_arg ($2));
4893         }
4894
4895         # Handle AC_CANONICAL_*.  Always allow upgrading to
4896         # AC_CANONICAL_SYSTEM, but never downgrading.
4897         if (/AC_CANONICAL_HOST/ || /AC_CYGWIN/ || /AC_EMXOS2/ || /AC_MINGW32/)
4898           {
4899             if (! $seen_canonical)
4900               {
4901                 $seen_canonical = AC_CANONICAL_HOST;
4902                 $canonical_location = $here;
4903               }
4904           }
4905         if (/AC_CANONICAL_SYSTEM/)
4906           {
4907             $seen_canonical = AC_CANONICAL_SYSTEM;
4908             $canonical_location = $here;
4909           }
4910
4911         # If using X, include some extra variable definitions.  NOTE
4912         # we don't want to force these into CFLAGS or anything,
4913         # because not all programs will necessarily use X.
4914         if (/AC_PATH_XTRA/)
4915           {
4916             foreach my $var (qw(X_CFLAGS X_LIBS X_EXTRA_LIBS X_PRE_LIBS))
4917               {
4918                 $configure_vars{$var} = $here;
4919               }
4920           }
4921
4922         # AM_INIT_AUTOMAKE with any number of argument
4923         if (/AM_INIT_AUTOMAKE/)
4924         {
4925             $seen_init_automake = $here;
4926         }
4927
4928         # AC_INIT or AM_INIT_AUTOMAKE with two arguments
4929         if (/$AC_INIT_PATTERN/o || /$AM_INIT_AUTOMAKE_PATTERN/o)
4930         {
4931             if ($1 =~ /$AM_PACKAGE_VERSION_PATTERN/o)
4932             {
4933                 $package_version = $1;
4934                 $package_version_location = $here;
4935             }
4936         }
4937
4938         # AM_INIT_AUTOMAKE with one argument.
4939         if (/AM_INIT_AUTOMAKE\(([^),]+)\)/)
4940         {
4941             $global_options = &unquote_m4_arg ($1);
4942         }
4943
4944         if (/AM_AUTOMAKE_VERSION\(([^)]+)\)/)
4945         {
4946             my $vers = &unquote_m4_arg ($1);
4947             file_error ($here,
4948                         "version mismatch.  This is Automake $VERSION, " .
4949                         "but $filename\nwas generated for Automake $vers.  " .
4950                         "You should recreate\n$filename with aclocal and " .
4951                         "run automake again.\n")
4952                     if ($VERSION ne $vers);
4953
4954             $seen_automake_version = 1;
4955         }
4956
4957         if (/AM_PROG_LEX/)
4958         {
4959             $configure_vars{'LEX'} = $here;
4960             $configure_vars{'LEX_OUTPUT_ROOT'} = $here;
4961             $configure_vars{'LEXLIB'} = $here;
4962             $seen_prog_lex = $here;
4963         }
4964         if (/AC_PROG_LEX/ && $filename =~ /configure\.(ac|in)$/)
4965         {
4966             $configure_vars{'LEX'} = $here;
4967             $configure_vars{'LEX_OUTPUT_ROOT'} = $here;
4968             $configure_vars{'LEXLIB'} = $here;
4969             $seen_prog_lex = $here;
4970             file_warning ($here,
4971                    "automake requires `AM_PROG_LEX', not `AC_PROG_LEX'");
4972         }
4973
4974         if (/AC_PROG_(F77|YACC|RANLIB|CC|CXXCPP|CXX|LEX|AWK|CPP|LN_S)/)
4975         {
4976             $configure_vars{$1} = $here;
4977         }
4978         if (/$AC_CHECK_PATTERN/o)
4979         {
4980             $configure_vars{$3} = $here;
4981         }
4982         if (/$AM_MISSING_PATTERN/o
4983             && $1 ne 'ACLOCAL'
4984             && $1 ne 'AUTOCONF'
4985             && $1 ne 'AUTOMAKE'
4986             && $1 ne 'AUTOHEADER'
4987             # AM_INIT_AUTOMAKE is AM_MISSING_PROG'ing MAKEINFO.  But
4988             # we handle it elsewhere.
4989             && $1 ne 'MAKEINFO')
4990         {
4991             $configure_vars{$1} = $here;
4992         }
4993
4994         # Explicitly avoid ANSI2KNR -- we AC_SUBST that in protos.m4,
4995         # but later define it elsewhere.  This is pretty hacky.  We
4996         # also explicitly avoid INSTALL_SCRIPT and some other
4997         # variables because they are defined in header-vars.am.
4998         # AMDEPBACKSLASH might be subst'd by `\', which certainly would
4999         # not be appreciated by Make.
5000         if (/$AC_SUBST_PATTERN/o
5001             && $1 ne 'ANSI2KNR'
5002             && $1 ne 'INSTALL_SCRIPT'
5003             && $1 ne 'INSTALL_DATA'
5004             && $1 ne 'AMDEPBACKSLASH')
5005         {
5006             $configure_vars{$1} = $here;
5007         }
5008
5009         if (/AM_MAINTAINER_MODE/)
5010         {
5011             $seen_maint_mode = $here;
5012             $configure_cond{'MAINTAINER_MODE'} = $here;
5013         }
5014
5015         $am_lispdir_location = $here if /AM_PATH_LISPDIR/;
5016
5017         if (/AM_PATH_PYTHON/)
5018           {
5019             $pythondir_location = $here;
5020             $configure_vars{'pythondir'} = $here;
5021             $configure_vars{'PYTHON'} = $here;
5022           }
5023
5024         if (/A(C|M)_PROG_LIBTOOL/)
5025         {
5026             # We're not ready for this yet.  People still use a
5027             # libtool with no AC_PROG_LIBTOOL.  Once that is the
5028             # dominant version we can reenable this code -- but next
5029             # time by mentioning the macro in %obsolete_macros, both
5030             # here and in aclocal.in.
5031
5032             # if (/AM_PROG_LIBTOOL/)
5033             # {
5034             #   file_warning ($here, "`AM_PROG_LIBTOOL' is obsolete, use `AC_PROG_LIBTOOL' instead");
5035             # }
5036             $seen_libtool = $here;
5037             $configure_vars{'LIBTOOL'} = $here;
5038             $configure_vars{'RANLIB'} = $here;
5039             $configure_vars{'CC'} = $here;
5040             # AC_PROG_LIBTOOL runs AC_CANONICAL_HOST.  Make sure we
5041             # never downgrade (if we've seen AC_CANONICAL_SYSTEM).
5042             $seen_canonical = AC_CANONICAL_HOST if ! $seen_canonical;
5043         }
5044
5045         $seen_multilib = $here if (/AM_ENABLE_MULTILIB/);
5046
5047         if (/$AM_CONDITIONAL_PATTERN/o)
5048         {
5049             $configure_cond{$1} = $here;
5050         }
5051
5052         # Check for Fortran 77 intrinsic and run-time libraries.
5053         if (/AC_F77_LIBRARY_LDFLAGS/)
5054         {
5055             $configure_vars{'FLIBS'} = $here;
5056         }
5057     }
5058 }
5059
5060
5061 # &scan_autoconf_files ()
5062 # -----------------------
5063 # Check whether we use `configure.ac' or `configure.in'.
5064 # Scan it (and possibly `aclocal.m4') for interesting things.
5065 # We must scan aclocal.m4 because there might be AC_SUBSTs and such there.
5066 sub scan_autoconf_files
5067 {
5068     # Reinitialize libsources here.  This isn't really necessary,
5069     # since we currently assume there is only one configure.ac.  But
5070     # that won't always be the case.
5071     %libsources = ();
5072
5073     $configure_ac = find_configure_ac;
5074     die "$me: `configure.ac' or `configure.in' is required\n"
5075         if !$configure_ac;
5076
5077     if (defined $ENV{'amtraces'})
5078     {
5079         print STDERR "$me: Autoconf traces is an experimental feature\n";
5080         print STDERR "$me: use at your own risks\n";
5081
5082         scan_autoconf_traces ($configure_ac);
5083     }
5084     else
5085       {
5086         scan_one_autoconf_file ($configure_ac);
5087         scan_one_autoconf_file ('aclocal.m4')
5088           if -f 'aclocal.m4';
5089       }
5090
5091     # Set input and output files if not specified by user.
5092     if (! @input_files)
5093     {
5094         @input_files = sort keys %make_list;
5095         %output_files = %make_list;
5096     }
5097
5098     @configure_input_files = sort keys %make_list;
5099
5100     conf_error ("`AM_INIT_AUTOMAKE' must be used")
5101         if ! $seen_init_automake;
5102
5103     if (! $seen_automake_version)
5104     {
5105         if (-f 'aclocal.m4')
5106         {
5107             file_error ($seen_init_automake || $me,
5108                         "your implementation of AM_INIT_AUTOMAKE comes from " .
5109                         "an\nold Automake version.  You should recreate " .
5110                         "aclocal.m4\nwith aclocal and run automake again.\n");
5111         }
5112         else
5113         {
5114             file_error ($seen_init_automake || $me,
5115                         "no proper implementation of AM_INIT_AUTOMAKE was " .
5116                         "found,\nprobably because aclocal.m4 is missing...\n" .
5117                         "You should run aclocal to create this file, then\n" .
5118                         "run automake again.\n");
5119         }
5120     }
5121
5122     # Look for some files we need.  Always check for these.  This
5123     # check must be done for every run, even those where we are only
5124     # looking at a subdir Makefile.  We must set relative_dir so that
5125     # the file-finding machinery works.
5126     # FIXME: Is this broken because it needs dynamic scopes.
5127     # My tests seems to show it's not the case.
5128     $relative_dir = '.';
5129     require_conf_file ($configure_ac, FOREIGN,
5130                        'install-sh', 'mkinstalldirs', 'missing');
5131     am_error ("`install.sh' is an anachronism; use `install-sh' instead")
5132         if -f $config_aux_path[0] . '/install.sh';
5133
5134     require_conf_file ($pythondir_location, FOREIGN, 'py-compile')
5135       if $pythondir_location;
5136
5137     # Preserve dist_common for later.
5138     $configure_dist_common = variable_value ('DIST_COMMON', 'TRUE') || '';
5139 }
5140
5141 ################################################################
5142
5143 # Set up for Cygnus mode.
5144 sub check_cygnus
5145 {
5146     return unless $cygnus_mode;
5147
5148     &set_strictness ('foreign');
5149     $options{'no-installinfo'} = 1;
5150     $options{'no-dependencies'} = 1;
5151     $use_dependencies = 0;
5152
5153     conf_error ("`AM_MAINTAINER_MODE' required when --cygnus specified")
5154       if !$seen_maint_mode;
5155 }
5156
5157 # Do any extra checking for GNU standards.
5158 sub check_gnu_standards
5159 {
5160     if ($relative_dir eq '.')
5161     {
5162         # In top level (or only) directory.
5163         require_file ("$am_file.am", GNU,
5164                       qw(INSTALL NEWS README COPYING AUTHORS ChangeLog));
5165     }
5166
5167     if ($strictness >= GNU
5168         && defined $options{'no-installman'})
5169     {
5170         macro_error ('AUTOMAKE_OPTIONS',
5171                      "option `no-installman' disallowed by GNU standards");
5172     }
5173
5174     if ($strictness >= GNU
5175         && defined $options{'no-installinfo'})
5176     {
5177         macro_error ('AUTOMAKE_OPTIONS',
5178                      "option `no-installinfo' disallowed by GNU standards");
5179     }
5180 }
5181
5182 # Do any extra checking for GNITS standards.
5183 sub check_gnits_standards
5184 {
5185     if ($relative_dir eq '.')
5186     {
5187         # In top level (or only) directory.
5188         require_file ("$am_file.am", GNITS, 'THANKS');
5189     }
5190 }
5191
5192 ################################################################
5193 #
5194 # Functions to handle files of each language.
5195
5196 # Each `lang_X_rewrite($DIRECTORY, $BASE, $EXT)' function follows a
5197 # simple formula: Return value is $LANG_SUBDIR if the resulting object
5198 # file should be in a subdir if the source file is, $LANG_PROCESS if
5199 # file is to be dealt with, $LANG_IGNORE otherwise.
5200
5201 # Much of the actual processing is handled in
5202 # handle_single_transform_list.  These functions exist so that
5203 # auxiliary information can be recorded for a later cleanup pass.
5204 # Note that the calls to these functions are computed, so don't bother
5205 # searching for their precise names in the source.
5206
5207 # This is just a convenience function that can be used to determine
5208 # when a subdir object should be used.
5209 sub lang_sub_obj
5210 {
5211     return defined $options{'subdir-objects'} ? $LANG_SUBDIR : $LANG_PROCESS;
5212 }
5213
5214 # Rewrite a single C source file.
5215 sub lang_c_rewrite
5216 {
5217     my ($directory, $base, $ext) = @_;
5218
5219     if (defined $options{'ansi2knr'} && $base =~ /_$/)
5220     {
5221         # FIXME: include line number in error.
5222         am_error ("C source file `$base.c' would be deleted by ansi2knr rules");
5223     }
5224
5225     my $r = $LANG_PROCESS;
5226     if (defined $options{'subdir-objects'})
5227     {
5228         $r = $LANG_SUBDIR;
5229         $base = $directory . '/' . $base
5230             unless $directory eq '.' || $directory eq '';
5231
5232         if (! $seen_cc_c_o)
5233         {
5234             # Only give error once.
5235             $seen_cc_c_o = 1;
5236             # FIXME: line number.
5237             am_error ("C objects in subdir but `AM_PROG_CC_C_O' not in `$configure_ac'");
5238         }
5239
5240         require_conf_file ("$am_file.am", FOREIGN, 'compile');
5241
5242         # In this case we already have the directory information, so
5243         # don't add it again.
5244         $de_ansi_files{$base} = '';
5245     }
5246     else
5247     {
5248         $de_ansi_files{$base} = (($directory eq '.' || $directory eq '')
5249                                  ? ''
5250                                  : "$directory/");
5251     }
5252
5253     return $r;
5254 }
5255
5256 # Rewrite a single C++ source file.
5257 sub lang_cxx_rewrite
5258 {
5259     return &lang_sub_obj;
5260 }
5261
5262 # Rewrite a single header file.
5263 sub lang_header_rewrite
5264 {
5265     # Header files are simply ignored.
5266     return $LANG_IGNORE;
5267 }
5268
5269 # Rewrite a single yacc file.
5270 sub lang_yacc_rewrite
5271 {
5272     my ($directory, $base, $ext) = @_;
5273
5274     my $r = &lang_sub_obj;
5275     (my $newext = $ext) =~ tr/y/c/;
5276     return ($r, $newext);
5277 }
5278
5279 # Rewrite a single yacc++ file.
5280 sub lang_yaccxx_rewrite
5281 {
5282     my ($directory, $base, $ext) = @_;
5283
5284     my $r = &lang_sub_obj;
5285     (my $newext = $ext) =~ tr/y/c/;
5286     return ($r, $newext);
5287 }
5288
5289 # Rewrite a single lex file.
5290 sub lang_lex_rewrite
5291 {
5292     my ($directory, $base, $ext) = @_;
5293
5294     my $r = &lang_sub_obj;
5295     (my $newext = $ext) =~ tr/l/c/;
5296     return ($r, $newext);
5297 }
5298
5299 # Rewrite a single lex++ file.
5300 sub lang_lexxx_rewrite
5301 {
5302     my ($directory, $base, $ext) = @_;
5303
5304     my $r = &lang_sub_obj;
5305     (my $newext = $ext) =~ tr/l/c/;
5306     return ($r, $newext);
5307 }
5308
5309 # Rewrite a single assembly file.
5310 sub lang_asm_rewrite
5311 {
5312     return &lang_sub_obj;
5313 }
5314
5315 # Rewrite a single Fortran 77 file.
5316 sub lang_f77_rewrite
5317 {
5318     return $LANG_PROCESS;
5319 }
5320
5321 # Rewrite a single preprocessed Fortran 77 file.
5322 sub lang_ppf77_rewrite
5323 {
5324     return $LANG_PROCESS;
5325 }
5326
5327 # Rewrite a single ratfor file.
5328 sub lang_ratfor_rewrite
5329 {
5330     return $LANG_PROCESS;
5331 }
5332
5333 # Rewrite a single Objective C file.
5334 sub lang_objc_rewrite
5335 {
5336     return &lang_sub_obj;
5337 }
5338
5339 # Rewrite a single Java file.
5340 sub lang_java_rewrite
5341 {
5342     return $LANG_SUBDIR;
5343 }
5344
5345 # The lang_X_finish functions are called after all source file
5346 # processing is done.  Each should handle defining rules for the
5347 # language, etc.  A finish function is only called if a source file of
5348 # the appropriate type has been seen.
5349
5350 sub lang_c_finish
5351 {
5352     # Push all libobjs files onto de_ansi_files.  We actually only
5353     # push files which exist in the current directory, and which are
5354     # genuine source files.
5355     foreach my $file (keys %libsources)
5356     {
5357         if ($file =~ /^(.*)\.[cly]$/ && -f "$relative_dir/$file")
5358         {
5359             $de_ansi_files{$1} = (($relative_dir eq '.' || $relative_dir eq '')
5360                                   ? ''
5361                                   : "$relative_dir/");
5362         }
5363     }
5364
5365     if (defined $options{'ansi2knr'} && keys %de_ansi_files)
5366     {
5367         # Make all _.c files depend on their corresponding .c files.
5368         my @objects;
5369         foreach my $base (sort keys %de_ansi_files)
5370         {
5371             # Each _.c file must depend on ansi2knr; otherwise it
5372             # might be used in a parallel build before it is built.
5373             # We need to support files in the srcdir and in the build
5374             # dir (because these files might be auto-generated.  But
5375             # we can't use $< -- some makes only define $< during a
5376             # suffix rule.
5377             my $ansfile = $de_ansi_files{$base} . $base . '.c';
5378             $output_rules .= ($base . "_.c: $ansfile \$(ANSI2KNR)\n\t"
5379                               . '$(CPP) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) '
5380                               . '`if test -f $(srcdir)/' . $ansfile
5381                               . '; then echo $(srcdir)/' . $ansfile
5382                               . '; else echo ' . $ansfile . '; fi` '
5383                               . "| sed 's/^# \\([0-9]\\)/#line \\1/' "
5384                               . '| $(ANSI2KNR) > ' . $base . "_.c"
5385                               # If ansi2knr fails then we shouldn't
5386                               # create the _.c file
5387                               . " || rm -f ${base}_.c\n");
5388             push (@objects, $base . '_.$(OBJEXT)');
5389             push (@objects, $base . '_.lo')
5390               if $seen_libtool;
5391         }
5392
5393         # Make all _.o (and _.lo) files depend on ansi2knr.
5394         # Use a sneaky little hack to make it print nicely.
5395         &pretty_print_rule ('', '', @objects, ':', '$(ANSI2KNR)');
5396     }
5397 }
5398
5399 # This is a yacc helper which is called whenever we have decided to
5400 # compile a yacc file.
5401 sub lang_yacc_target_hook
5402 {
5403     my ($self, $aggregate, $output, $input) = @_;
5404
5405     my $flag = $aggregate . "_YFLAGS";
5406     if ((variable_defined ($flag)
5407          && &variable_value ($flag) =~ /$DASH_D_PATTERN/o)
5408         || (variable_defined ('YFLAGS')
5409             && &variable_value ('YFLAGS') =~ /$DASH_D_PATTERN/o))
5410     {
5411         (my $output_base = $output) =~ s/$KNOWN_EXTENSIONS_PATTERN$//;
5412         my $header = $output_base . '.h';
5413
5414         # Found a `-d' that applies to the compilation of this file.
5415         # Add a dependency for the generated header file, and arrange
5416         # for that file to be included in the distribution.
5417         # FIXME: this fails for `nodist_*_SOURCES'.
5418         $output_rules .= "${header}: $output\n";
5419         &push_dist_common ($header);
5420         # If the files are built in the build directory, then we want
5421         # to remove them with `make clean'.  If they are in srcdir
5422         # they shouldn't be touched.  However, we can't determine this
5423         # statically, and the GNU rules say that yacc/lex output files
5424         # should be removed by maintainer-clean.  So that's what we
5425         # do.
5426         push (@maintainer_clean_files, $header);
5427     }
5428 }
5429
5430 # This is a helper for both lex and yacc.
5431 sub yacc_lex_finish_helper
5432 {
5433     return if defined $language_scratch{'lex-yacc-done'};
5434     $language_scratch{'lex-yacc-done'} = 1;
5435
5436     # If there is more than one distinct yacc (resp lex) source file
5437     # in a given directory, then the `ylwrap' program is required to
5438     # allow parallel builds to work correctly.  FIXME: for now, no
5439     # line number.
5440     require_conf_file ($configure_ac, FOREIGN, 'ylwrap');
5441     if ($config_aux_dir_set_in_configure_in)
5442     {
5443         &define_variable ('YLWRAP', $config_aux_dir . "/ylwrap");
5444     }
5445     else
5446     {
5447         &define_variable ('YLWRAP', '$(top_srcdir)/ylwrap');
5448     }
5449 }
5450
5451 sub lang_yacc_finish
5452 {
5453     return if defined $language_scratch{'yacc-done'};
5454     $language_scratch{'yacc-done'} = 1;
5455
5456     macro_error ('YACCFLAGS',
5457                  "`YACCFLAGS' obsolete; use `YFLAGS' instead")
5458       if variable_defined ('YACCFLAGS');
5459
5460     if (count_files_for_language ('yacc') > 1)
5461     {
5462         &yacc_lex_finish_helper;
5463     }
5464 }
5465
5466
5467 sub lang_lex_finish
5468 {
5469     return if defined $language_scratch{'lex-done'};
5470     $language_scratch{'lex-done'} = 1;
5471
5472     am_error ("lex source seen but `AM_PROG_LEX' not in `$configure_ac'")
5473       unless $seen_prog_lex;
5474
5475     if (count_files_for_language ('lex') > 1)
5476     {
5477         &yacc_lex_finish_helper;
5478     }
5479 }
5480
5481
5482 # Given a hash table of linker names, pick the name that has the most
5483 # precedence.  This is lame, but something has to have global
5484 # knowledge in order to eliminate the conflict.  Add more linkers as
5485 # required.
5486 sub resolve_linker
5487 {
5488     my (%linkers) = @_;
5489
5490     foreach my $l (qw(GCJLINK CXXLINK F77LINK OBJCLINK))
5491     {
5492         return $l if defined $linkers{$l};
5493     }
5494     return 'LINK';
5495 }
5496
5497 # Called to indicate that an extension was used.
5498 sub saw_extension
5499 {
5500     my ($ext) = @_;
5501     if (! defined $extension_seen{$ext})
5502     {
5503         $extension_seen{$ext} = 1;
5504     }
5505     else
5506     {
5507         ++$extension_seen{$ext};
5508     }
5509 }
5510
5511 # Return the number of files seen for a given language.  Knows about
5512 # special cases we care about.  FIXME: this is hideous.  We need
5513 # something that involves real language objects.  For instance yacc
5514 # and yaccxx could both derive from a common yacc class which would
5515 # know about the strange ylwrap requirement.  (Or better yet we could
5516 # just not support legacy yacc!)
5517 sub count_files_for_language
5518 {
5519     my ($name) = @_;
5520
5521     my @names;
5522     if ($name eq 'yacc' || $name eq 'yaccxx')
5523     {
5524         @names = ('yacc', 'yaccxx');
5525     }
5526     elsif ($name eq 'lex' || $name eq 'lexxx')
5527     {
5528         @names = ('lex', 'lexxx');
5529     }
5530     else
5531     {
5532         @names = ($name);
5533     }
5534
5535     my $r = 0;
5536     foreach $name (@names)
5537     {
5538         my $lang = $languages{$name};
5539         foreach my $ext (@{$lang->extensions})
5540         {
5541             $r += $extension_seen{$ext}
5542                 if defined $extension_seen{$ext};
5543         }
5544     }
5545
5546     return $r
5547 }
5548
5549 # Called to ask whether source files have been seen . If HEADERS is 1,
5550 # headers can be included.
5551 sub saw_sources_p
5552 {
5553     my ($headers) = @_;
5554
5555     # count all the sources
5556     my $count = 0;
5557     foreach my $val (values %extension_seen)
5558     {
5559         $count += $val;
5560     }
5561
5562     if (!$headers)
5563     {
5564         $count -= count_files_for_language ('header');
5565     }
5566
5567     return $count > 0;
5568 }
5569
5570
5571 # register_language (%ATTRIBUTE)
5572 # ------------------------------
5573 # Register a single language.
5574 # Each %ATTRIBUTE is of the form ATTRIBUTE => VALUE.
5575 sub register_language (%)
5576 {
5577     my (%option) = @_;
5578
5579     # Set the defaults.
5580     $option{'ansi'} = 0
5581       unless defined $option{'ansi'};
5582     $option{'autodep'} = 'no'
5583       unless defined $option{'autodep'};
5584     $option{'linker'} = ''
5585       unless defined $option{'linker'};
5586     $option{'define_flag'} = 1
5587       unless defined $option{'define_flag'};
5588
5589     my $lang = new Language (%option);
5590
5591     # Fill indexes.
5592     grep ($extension_map{$_} = $lang->name, @{$lang->extensions});
5593     $languages{$lang->name} = $lang;
5594
5595     # Update the pattern of known extensions.
5596     accept_extensions (@{$lang->extensions});
5597 }
5598
5599 # derive_suffix ($EXT, $OBJ)
5600 # --------------------------
5601 # This function is used to find a path from a user-specified suffix $EXT
5602 # to $OBJ or to some other suffix we recognize internally, eg `cc'.
5603 sub derive_suffix ($$)
5604 {
5605     my ($source_ext, $obj) = @_;
5606
5607     while (! $extension_map{$source_ext}
5608            && $source_ext ne $obj
5609            && defined $suffix_rules{$source_ext})
5610     {
5611         $source_ext = $suffix_rules{$source_ext};
5612     }
5613
5614     return $source_ext;
5615 }
5616
5617
5618 ################################################################
5619
5620 # Pretty-print something.  HEAD is what should be printed at the
5621 # beginning of the first line, FILL is what should be printed at the
5622 # beginning of every subsequent line.
5623 sub pretty_print_internal
5624 {
5625     my ($head, $fill, @values) = @_;
5626
5627     my $column = length ($head);
5628     my $result = $head;
5629
5630     # Fill length is number of characters.  However, each Tab
5631     # character counts for eight.  So we count the number of Tabs and
5632     # multiply by 7.
5633     my $fill_length = length ($fill);
5634     $fill_length += 7 * ($fill =~ tr/\t/\t/d);
5635
5636     foreach (@values)
5637     {
5638         # "71" because we also print a space.
5639         if ($column + length ($_) > 71)
5640         {
5641             $result .= " \\\n" . $fill;
5642             $column = $fill_length;
5643         }
5644         $result .= ' ' if $result =~ /\S\z/;
5645         $result .= $_;
5646         $column += length ($_) + 1;
5647     }
5648
5649     $result .= "\n";
5650     return $result;
5651 }
5652
5653 # Pretty-print something and append to output_vars.
5654 sub pretty_print
5655 {
5656     $output_vars .= &pretty_print_internal (@_);
5657 }
5658
5659 # Pretty-print something and append to output_rules.
5660 sub pretty_print_rule
5661 {
5662     $output_rules .= &pretty_print_internal (@_);
5663 }
5664
5665
5666 ################################################################
5667
5668
5669 # $STRING
5670 # &conditional_string(@COND-STACK)
5671 # --------------------------------
5672 # Build a string which denotes the conditional in @COND-STACK.  Some
5673 # simplifications are done: `TRUE' entries are elided, and any `FALSE'
5674 # entry results in a return of `FALSE'.
5675 sub conditional_string
5676 {
5677   my (@stack) = @_;
5678
5679   if (grep (/^FALSE$/, @stack))
5680     {
5681       return 'FALSE';
5682     }
5683   else
5684     {
5685       return join (' ', uniq sort grep (!/^TRUE$/, @stack));
5686     }
5687 }
5688
5689
5690 # $BOOLEAN
5691 # &conditional_true_when ($COND, $WHEN)
5692 # -------------------------------------
5693 # See if a conditional is true.  Both arguments are conditional
5694 # strings.  This returns true if the first conditional is true when
5695 # the second conditional is true.
5696 # For instance with $COND = `BAR FOO', and $WHEN = `BAR BAZ FOO',
5697 # obviously return 1, and 0 when, for instance, $WHEN = `FOO'.
5698 sub conditional_true_when ($$)
5699 {
5700     my ($cond, $when) = @_;
5701
5702     # Make a hash holding all the values from $WHEN.
5703     my %cond_vals = map { $_ => 1 } split (' ', $when);
5704
5705     # Check each component of $cond, which looks `COND1 COND2'.
5706     foreach my $comp (split (' ', $cond))
5707     {
5708         # TRUE is always true.
5709         next if $comp eq 'TRUE';
5710         return 0 if ! defined $cond_vals{$comp};
5711     }
5712
5713     return 1;
5714 }
5715
5716
5717 # $BOOLEAN
5718 # &conditional_is_redundant ($COND, @WHENS)
5719 # ----------------------------------------
5720 # Determine whether $COND is redundant with respect to @WHENS.
5721 #
5722 # Returns true if $COND is true for any of the conditions in @WHENS.
5723 #
5724 # If there are no @WHENS, then behave as if @WHENS contained a single empty
5725 # condition.
5726 sub conditional_is_redundant ($@)
5727 {
5728     my ($cond, @whens) = @_;
5729
5730     if (@whens == 0)
5731     {
5732         return 1 if conditional_true_when ($cond, "");
5733     }
5734     else
5735     {
5736         foreach my $when (@whens)
5737         {
5738             return 1 if conditional_true_when ($cond, $when);
5739         }
5740     }
5741
5742     return 0;
5743 }
5744
5745
5746 # $NEGATION
5747 # condition_negate ($COND)
5748 # ------------------------
5749 sub condition_negate ($)
5750 {
5751     my ($cond) = @_;
5752
5753     $cond =~ s/TRUE$/TRUEO/;
5754     $cond =~ s/FALSE$/TRUE/;
5755     $cond =~ s/TRUEO$/FALSE/;
5756
5757     return $cond;
5758 }
5759
5760
5761 # Compare condition names.
5762 # Issue them in alphabetical order, foo_TRUE before foo_FALSE.
5763 sub by_condition
5764 {
5765     # Be careful we might be comparing `' or `#'.
5766     $a =~ /^(.*)_(TRUE|FALSE)$/;
5767     my ($aname, $abool) = ($1 || '', $2 || '');
5768     $b =~ /^(.*)_(TRUE|FALSE)$/;
5769     my ($bname, $bbool) = ($1 || '', $2 || '');
5770     return ($aname cmp $bname
5771             # Don't bother with IFs, given that TRUE is after FALSE
5772             # just cmp in the reverse order.
5773             || $bbool cmp $abool
5774             # Just in case...
5775             || $a cmp $b);
5776 }
5777
5778
5779 # &make_condition (@CONDITIONS)
5780 # -----------------------------
5781 # Transform a list of conditions (themselves can be an internal list
5782 # of conditions, e.g., @CONDITIONS = ('cond1 cond2', 'cond3')) into a
5783 # Make conditional (a pattern for AC_SUBST).
5784 # Correctly returns the empty string when there are no conditions.
5785 sub make_condition
5786 {
5787     my $res = conditional_string (@_);
5788
5789     # There are no conditions.
5790     if ($res eq '')
5791       {
5792         # Nothing to do.
5793       }
5794     # It's impossible.
5795     elsif ($res eq 'FALSE')
5796       {
5797         $res = '#';
5798       }
5799     # Build it.
5800     else
5801       {
5802         $res = '@' . $res . '@';
5803         $res =~ s/ /@@/g;
5804       }
5805
5806     return $res;
5807 }
5808
5809
5810
5811 ## ------------------------------ ##
5812 ## Handling the condition stack.  ##
5813 ## ------------------------------ ##
5814
5815
5816 # $COND_STRING
5817 # cond_stack_if ($NEGATE, $COND, $WHERE)
5818 # --------------------------------------
5819 sub cond_stack_if ($$$)
5820 {
5821   my ($negate, $cond, $where) = @_;
5822
5823   file_error ($where, "$cond does not appear in AM_CONDITIONAL")
5824     if ! $configure_cond{$cond} && $cond !~ /^TRUE|FALSE$/;
5825
5826   $cond = "${cond}_TRUE"
5827     unless $cond =~ /^TRUE|FALSE$/;
5828   $cond = condition_negate ($cond)
5829     if $negate;
5830
5831   push (@cond_stack, $cond);
5832
5833   return conditional_string (@cond_stack);
5834 }
5835
5836
5837 # $COND_STRING
5838 # cond_stack_else ($NEGATE, $COND, $WHERE)
5839 # ----------------------------------------
5840 sub cond_stack_else ($$$)
5841 {
5842   my ($negate, $cond, $where) = @_;
5843
5844   if (! @cond_stack)
5845     {
5846       file_error ($where, "else without if");
5847       return;
5848     }
5849
5850   $cond_stack[$#cond_stack] = condition_negate ($cond_stack[$#cond_stack]);
5851
5852   # If $COND is given, check against it.
5853   if (defined $cond)
5854     {
5855       $cond = "${cond}_TRUE"
5856         unless $cond =~ /^TRUE|FALSE$/;
5857       $cond = condition_negate ($cond)
5858         if $negate;
5859
5860       file_error ($where,
5861                   "else reminder ($negate$cond) incompatible with "
5862                   . "current conditional: $cond_stack[$#cond_stack]")
5863         if $cond_stack[$#cond_stack] ne $cond;
5864     }
5865
5866   return conditional_string (@cond_stack);
5867 }
5868
5869
5870 # $COND_STRING
5871 # cond_stack_endif ($NEGATE, $COND, $WHERE)
5872 # -----------------------------------------
5873 sub cond_stack_endif ($$$)
5874 {
5875   my ($negate, $cond, $where) = @_;
5876   my $old_cond;
5877
5878   if (! @cond_stack)
5879     {
5880       file_error ($where, "endif without if: $negate$cond");
5881       return;
5882     }
5883
5884
5885   # If $COND is given, check against it.
5886   if (defined $cond)
5887     {
5888       $cond = "${cond}_TRUE"
5889         unless $cond =~ /^TRUE|FALSE$/;
5890       $cond = condition_negate ($cond)
5891         if $negate;
5892
5893       file_error ($where,
5894                   "endif reminder ($negate$cond) incompatible with "
5895                   . "current conditional: $cond_stack[$#cond_stack]")
5896         if $cond_stack[$#cond_stack] ne $cond;
5897     }
5898
5899   pop @cond_stack;
5900
5901   return conditional_string (@cond_stack);
5902 }
5903
5904
5905
5906
5907
5908 ## ------------------------ ##
5909 ## Handling the variables.  ##
5910 ## ------------------------ ##
5911
5912
5913 # check_ambiguous_conditional ($VAR, $COND)
5914 # -----------------------------------------
5915 # Check for an ambiguous conditional.  This is called when a variable
5916 # is being defined conditionally.  If we already know about a
5917 # definition that is true under the same conditions, then we have an
5918 # ambiguity.
5919 sub check_ambiguous_conditional ($$)
5920 {
5921     my ($var, $cond) = @_;
5922     my $message = conditional_ambiguous_p ($var, $cond);
5923     if ($message ne '')
5924     {
5925         macro_error ($var, $message);
5926         macro_dump ($var);
5927     }
5928 }
5929
5930 # $STRING
5931 # conditional_ambiguous_p ($VAR, $COND)
5932 # -------------------------------------
5933 # Check for an ambiguous conditional.  Return an error message if we
5934 # have one, the empty string otherwise.
5935 sub conditional_ambiguous_p ($$)
5936 {
5937     my ($var, $cond) = @_;
5938     foreach my $vcond (keys %{$var_value{$var}})
5939     {
5940        my $message;
5941        if ($vcond eq $cond)
5942        {
5943            return "$var multiply defined in condition $cond";
5944        }
5945        elsif (&conditional_true_when ($vcond, $cond))
5946        {
5947          return ("$var was already defined in condition $vcond, "
5948                  . "which implies condition $cond");
5949        }
5950        elsif (&conditional_true_when ($cond, $vcond))
5951        {
5952            return ("$var was already defined in condition $vcond, "
5953                    . "which is implied by condition $cond");
5954        }
5955    }
5956
5957     return '';
5958 }
5959
5960
5961 # &macro_define($VAR, $VAR_IS_AM, $TYPE, $COND, $VALUE, $WHERE)
5962 # -------------------------------------------------------------
5963 # The $VAR can go from Automake to user, but not the converse.
5964 sub macro_define ($$$$$$)
5965 {
5966   my ($var, $var_is_am, $type, $cond, $value, $where) = @_;
5967
5968   file_error ($where, "bad macro name `$var'")
5969     if $var !~ /$MACRO_PATTERN/o;
5970
5971   $cond ||= 'TRUE';
5972
5973   # An Automake variable must be consistently defined with the same
5974   # sign by Automake.  A user variable must be set by either `=' or
5975   # `:=', and later promoted to `+='.
5976   if ($var_is_am)
5977     {
5978       if (defined $var_type{$var} && $var_type{$var} ne $type)
5979         {
5980           file_error ($where,
5981                       ("$var was set with `$var_type{$var}=' "
5982                        . "and is now set with `$type='"));
5983         }
5984     }
5985   else
5986     {
5987       if (!defined $var_type{$var} && $type eq '+')
5988         {
5989           file_error ($where, "$var must be set with `=' before using `+='");
5990         }
5991     }
5992   $var_type{$var} = $type;
5993
5994   # When adding, since we rewrite, don't try to preserve the
5995   # Automake continuation backslashes.
5996   $value =~ s/\\$//mg
5997     if $type eq '+' && $var_is_am;
5998
5999   # Differentiate the first assignment (including with `+=').
6000   if ($type eq '+' && defined $var_value{$var}{$cond})
6001     {
6002       if (chomp $var_value{$var}{$cond})
6003         {
6004           # Insert a backslash before a trailing newline.
6005           $var_value{$var}{$cond} .= "\\\n";
6006         }
6007       elsif ($var_value{$var}{$cond})
6008         {
6009           # Insert a separator.
6010           $var_value{$var}{$cond} .= ' ';
6011         }
6012        $var_value{$var}{$cond} .= $value;
6013     }
6014   else
6015     {
6016       # The first assignment to a macro sets its location.  Ideally I
6017       # suppose we would associate line numbers with random bits of text.
6018       # FIXME: We sometimes redefine some variables, but we want to keep
6019       # the original location.  More subs are needed to handle
6020       # properly variables.  Once this done, remove this hack.
6021       $var_location{$var} = $where
6022         unless defined $var_location{$var};
6023
6024       # If Automake tries to override a value specified by the user,
6025       # just don't let it do.
6026       if (defined $var_value{$var}{$cond} && !$var_is_am{$var} && $var_is_am)
6027         {
6028           if ($verbose)
6029             {
6030               print STDERR "$me: refusing to override the user definition of:\n";
6031               macro_dump ($var);
6032               print STDERR "$me: with `$cond' => `$value'\n";
6033             }
6034         }
6035       else
6036         {
6037           # There must be no previous value unless the user is redefining
6038           # an Automake variable or an AC_SUBST variable.
6039           check_ambiguous_conditional ($var, $cond)
6040             unless ($var_is_am{$var} && !$var_is_am
6041                     || exists $configure_vars{$var});
6042
6043           $var_value{$var}{$cond} = $value;
6044         }
6045     }
6046
6047   # An Automake variable can be given to the user, but not the converse.
6048   if (! defined $var_is_am{$var} || !$var_is_am)
6049     {
6050       $var_is_am{$var} = $var_is_am;
6051     }
6052
6053   # Call var_VAR_trigger if it's defined.
6054   # This hook helps to update some internal state *while*
6055   # parsing the file.  For instance the handling of SUFFIXES
6056   # requires this (see var_SUFFIXES_trigger).
6057   my $var_trigger = "var_${var}_trigger";
6058   &$var_trigger($type, $value) if defined &$var_trigger;
6059 }
6060
6061
6062 # &macro_delete ($VAR, [@CONDS])
6063 # ------------------------------
6064 # Forget about $VAR under the conditions @CONDS, or completely if
6065 # @CONDS is empty.
6066 sub macro_delete ($@)
6067 {
6068   my ($var, @conds) = @_;
6069
6070   if (!@conds)
6071     {
6072       delete $var_value{$var};
6073       delete $var_location{$var};
6074       delete $var_is_am{$var};
6075       delete $var_comment{$var};
6076       delete $var_type{$var};
6077     }
6078   else
6079     {
6080       foreach my $cond (@conds)
6081         {
6082           delete $var_value{$var}{$cond};
6083         }
6084     }
6085 }
6086
6087
6088 # &macro_dump ($VAR)
6089 # ------------------
6090 sub macro_dump ($)
6091 {
6092   my ($var) = @_;
6093
6094   if (!exists $var_value{$var})
6095     {
6096       print STDERR "  $var does not exist\n";
6097     }
6098   else
6099     {
6100       my $var_is_am = $var_is_am{$var} ? "Automake" : "User";
6101       my $where = (defined $var_location{$var}
6102                    ? $var_location{$var} : "undefined");
6103       print STDERR "$var_comment{$var}"
6104         if defined $var_comment{$var};
6105       print STDERR "  $var ($var_is_am, where = $where) $var_type{$var}=\n";
6106       print STDERR "  {\n";
6107       foreach my $vcond (sort by_condition keys %{$var_value{$var}})
6108         {
6109           print STDERR "    $vcond => $var_value{$var}{$vcond}\n";
6110         }
6111       print STDERR "  }\n";
6112     }
6113 }
6114
6115
6116 # &macros_dump ()
6117 # ---------------
6118 sub macros_dump ()
6119 {
6120   my ($var) = @_;
6121
6122   print STDERR "%var_value =\n";
6123   print STDERR "{\n";
6124   foreach my $var (sort (keys %var_value))
6125     {
6126       macro_dump ($var);
6127     }
6128   print STDERR "}\n";
6129 }
6130
6131
6132 # $BOOLEAN
6133 # variable_defined ($VAR, [$COND])
6134 # ---------------------------------
6135 # See if a variable exists.  $VAR is the variable name, and $COND is
6136 # the condition which we should check.  If no condition is given, we
6137 # currently return true if the variable is defined under any
6138 # condition.
6139 sub variable_defined ($;$)
6140 {
6141     my ($var, $cond) = @_;
6142
6143     # Unfortunately we can't just check for $var_value{VAR}{COND}
6144     # as this would make perl create $condition{VAR}, which we
6145     # don't want.
6146     if (!exists $var_value{$var})
6147       {
6148         macro_error ($var, "`$var' is a target; expected a variable")
6149           if defined $targets{$var};
6150         # The variable is not defined
6151         return 0;
6152       }
6153
6154     # The variable is not defined for the given condition.
6155     return 0
6156       if $cond && !exists $var_value{$var}{$cond};
6157
6158     # Even a var_value examination is good enough for us.  FIXME:
6159     # really should maintain examined status on a per-condition basis.
6160     $content_seen{$var} = 1;
6161     return 1;
6162 }
6163
6164
6165 # $BOOLEAN
6166 # variable_assert ($VAR, $WHERE)
6167 # ------------------------------
6168 # Make sure a variable exists.  $VAR is the variable name, and $WHERE
6169 # is the name of a macro which refers to $VAR.
6170 sub variable_assert ($$)
6171 {
6172   my ($var, $where) = @_;
6173
6174   return 1
6175     if variable_defined $var;
6176
6177   macro_error ($where, "variable `$var' not defined");
6178
6179   return 0;
6180 }
6181
6182
6183 # Mark a variable as examined.
6184 sub examine_variable
6185 {
6186     my ($var) = @_;
6187     variable_defined ($var);
6188 }
6189
6190
6191 # &variable_conditions_recursive ($VAR)
6192 # -------------------------------------
6193 # Return the set of conditions for which a variable is defined.
6194
6195 # If the variable is not defined conditionally, and is not defined in
6196 # terms of any variables which are defined conditionally, then this
6197 # returns the empty list.
6198
6199 # If the variable is defined conditionally, but is not defined in
6200 # terms of any variables which are defined conditionally, then this
6201 # returns the list of conditions for which the variable is defined.
6202
6203 # If the variable is defined in terms of any variables which are
6204 # defined conditionally, then this returns a full set of permutations
6205 # of the subvariable conditions.  For example, if the variable is
6206 # defined in terms of a variable which is defined for COND_TRUE,
6207 # then this returns both COND_TRUE and COND_FALSE.  This is
6208 # because we will need to define the variable under both conditions.
6209 sub variable_conditions_recursive ($)
6210 {
6211     my ($var) = @_;
6212
6213     %vars_scanned = ();
6214
6215     my @new_conds = variable_conditions_recursive_sub ($var, '');
6216     # Now we want to return all permutations of the subvariable
6217     # conditions.
6218     my %allconds = ();
6219     foreach my $item (@new_conds)
6220     {
6221         foreach (split (' ', $item))
6222         {
6223             s/^(.*)_(TRUE|FALSE)$/$1_TRUE/;
6224             $allconds{$_} = 1;
6225         }
6226     }
6227     @new_conds = variable_conditions_permutations (sort keys %allconds);
6228
6229     my %uniqify;
6230     foreach my $cond (@new_conds)
6231     {
6232         my $reduce = variable_conditions_reduce (split (' ', $cond));
6233         next
6234             if $reduce eq 'FALSE';
6235         $uniqify{$cond} = 1;
6236     }
6237
6238     # Note we cannot just do `return sort keys %uniqify', because this
6239     # function is sometimes used in a scalar context.
6240     my @uniq_list = sort by_condition keys %uniqify;
6241     return @uniq_list;
6242 }
6243
6244
6245 # @CONDS
6246 # variable_conditions ($VAR)
6247 # --------------------------
6248 # Get the list of conditions that a variable is defined with, without
6249 # recursing through the conditions of any subvariables.
6250 # Argument is $VAR: the variable to get the conditions of.
6251 # Returns the list of conditions.
6252 sub variable_conditions ($)
6253 {
6254     my ($var) = @_;
6255     my @conds = keys %{$var_value{$var}};
6256     return sort by_condition @conds;
6257 }
6258
6259
6260 # $BOOLEAN
6261 # &variable_conditionally_defined ($VAR)
6262 # --------------------------------------
6263 sub variable_conditionally_defined ($)
6264 {
6265     my ($var) = @_;
6266     foreach my $cond (variable_conditions_recursive ($var))
6267       {
6268         return 1
6269           unless $cond =~ /^TRUE|FALSE$/;
6270       }
6271     return 0;
6272 }
6273
6274
6275
6276 # &variable_conditions_recursive_sub ($VAR, $PARENT)
6277 # -------------------------------------------------------
6278 # A subroutine of variable_conditions_recursive.  This returns all the
6279 # conditions of $VAR, including those of any sub-variables.
6280 sub variable_conditions_recursive_sub
6281 {
6282     my ($var, $parent) = @_;
6283     my @new_conds = ();
6284
6285     if (defined $vars_scanned{$var})
6286     {
6287         macro_error ($parent, "variable `$var' recursively defined");
6288         return ();
6289     }
6290     $vars_scanned{$var} = 1;
6291
6292     my @this_conds = ();
6293     # Examine every condition under which $VAR is defined.
6294     foreach my $vcond (keys %{$var_value{$var}})
6295     {
6296         push (@this_conds, $vcond);
6297
6298         # If $VAR references some other variable, then compute the
6299         # conditions for that subvariable.
6300         my @subvar_conds = ();
6301         foreach (split (' ', $var_value{$var}{$vcond}))
6302         {
6303             # If a comment seen, just leave.
6304             last if /^#/;
6305
6306             # Handle variable substitutions.
6307             if (/^\$\{(.*)\}$/ || /^\$\((.*)\)$/)
6308             {
6309                 my $varname = $1;
6310                 if ($varname =~ /$SUBST_REF_PATTERN/o)
6311                 {
6312                     $varname = $1;
6313                 }
6314
6315
6316                 # Here we compute all the conditions under which the
6317                 # subvariable is defined.  Then we go through and add
6318                 # $VCOND to each.
6319                 my @svc = variable_conditions_recursive_sub ($varname, $var);
6320                 foreach my $item (@svc)
6321                 {
6322                     my $val = conditional_string ($vcond, split (' ', $item));
6323                     $val ||= 'TRUE';
6324                     push (@subvar_conds, $val);
6325                 }
6326             }
6327         }
6328
6329         # If there are no conditional subvariables, then we want to
6330         # return this condition.  Otherwise, we want to return the
6331         # permutations of the subvariables, taking into account the
6332         # conditions of $VAR.
6333         if (! @subvar_conds)
6334         {
6335             push (@new_conds, $vcond);
6336         }
6337         else
6338         {
6339             push (@new_conds, variable_conditions_reduce (@subvar_conds));
6340         }
6341     }
6342
6343     # Unset our entry in vars_scanned.  We only care about recursive
6344     # definitions.
6345     delete $vars_scanned{$var};
6346
6347     # If we are being called on behalf of another variable, we need to
6348     # return all possible permutations of the conditions.  We have
6349     # already handled everything in @this_conds along with their
6350     # subvariables.  We now need to add any permutations that are not
6351     # in @this_conds.
6352     foreach my $this_cond (@this_conds)
6353     {
6354         my @perms =
6355             variable_conditions_permutations (split (' ', $this_cond));
6356         foreach my $perm (@perms)
6357         {
6358             my $ok = 1;
6359             foreach my $scan (@this_conds)
6360             {
6361                 if (&conditional_true_when ($perm, $scan)
6362                     || &conditional_true_when ($scan, $perm))
6363                 {
6364                     $ok = 0;
6365                     last;
6366                 }
6367             }
6368             next if ! $ok;
6369
6370             # This permutation was not already handled, and is valid
6371             # for the parents.
6372             push (@new_conds, $perm);
6373         }
6374     }
6375
6376     return @new_conds;
6377 }
6378
6379
6380 # Filter a list of conditionals so that only the exclusive ones are
6381 # retained.  For example, if both `COND1_TRUE COND2_TRUE' and
6382 # `COND1_TRUE' are in the list, discard the latter.
6383 # If the list is empty, return TRUE
6384 sub variable_conditions_reduce
6385 {
6386     my (@conds) = @_;
6387     my @ret = ();
6388     my $cond;
6389     while(@conds > 0)
6390     {
6391         $cond = shift(@conds);
6392
6393         # FALSE is absorbent.
6394         return 'FALSE'
6395           if $cond eq 'FALSE';
6396
6397         if (!conditional_is_redundant ($cond, @ret, @conds))
6398           {
6399             push (@ret, $cond);
6400           }
6401     }
6402
6403     return "TRUE" if @ret == 0;
6404     return @ret;
6405 }
6406
6407 # @CONDS
6408 # invert_conditions (@CONDS)
6409 # --------------------------
6410 # Invert a list of conditionals.  Returns a set of conditionals which
6411 # are never true for any of the input conditionals, and when taken
6412 # together with the input conditionals cover all possible cases.
6413 #
6414 # For example: invert_conditions("A_TRUE B_TRUE", "A_FALSE B_FALSE") will
6415 # return ("A_FALSE B_TRUE", "A_TRUE B_FALSE")
6416 sub invert_conditions
6417 {
6418     my (@conds) = @_;
6419
6420     my @notconds = ();
6421     foreach my $cond (@conds)
6422     {
6423         foreach my $perm (variable_conditions_permutations (split(' ', $cond)))
6424         {
6425             push @notconds, $perm
6426                     if ! conditional_is_redundant ($perm, @conds);
6427         }
6428     }
6429     return variable_conditions_reduce (@notconds);
6430 }
6431
6432 # Return a list of permutations of a conditional string.
6433 sub variable_conditions_permutations
6434 {
6435     my (@comps) = @_;
6436     return ()
6437         if ! @comps;
6438     my $comp = shift (@comps);
6439     return variable_conditions_permutations (@comps)
6440         if $comp eq '';
6441     my $neg = condition_negate ($comp);
6442
6443     my @ret;
6444     foreach my $sub (variable_conditions_permutations (@comps))
6445     {
6446         push (@ret, "$comp $sub");
6447         push (@ret, "$neg $sub");
6448     }
6449     if (! @ret)
6450     {
6451         push (@ret, $comp);
6452         push (@ret, $neg);
6453     }
6454     return @ret;
6455 }
6456
6457
6458 # $BOOL
6459 # &check_variable_defined_unconditionally($VAR, $PARENT)
6460 # ------------------------------------------------------
6461 # Warn if a variable is conditionally defined.  This is called if we
6462 # are using the value of a variable.
6463 sub check_variable_defined_unconditionally ($$)
6464 {
6465     my ($var, $parent) = @_;
6466     foreach my $cond (keys %{$var_value{$var}})
6467     {
6468         next
6469           if $cond =~ /^TRUE|FALSE$/;
6470
6471         if ($parent)
6472         {
6473             macro_error ($parent,
6474                          "warning: automake does not support conditional definition of $var in $parent");
6475         }
6476         else
6477         {
6478             macro_error ($parent,
6479                          "warning: automake does not support $var being defined conditionally");
6480         }
6481     }
6482 }
6483
6484
6485 # Get the TRUE value of a variable, warn if the variable is
6486 # conditionally defined.
6487 sub variable_value
6488 {
6489     my ($var) = @_;
6490     &check_variable_defined_unconditionally ($var);
6491     return $var_value{$var}{'TRUE'};
6492 }
6493
6494
6495 # @VALUES
6496 # &value_to_list ($VAR, $VAL, $COND)
6497 # ----------------------------------
6498 # Convert a variable value to a list, split as whitespace.  This will
6499 # recursively follow $(...) and ${...} inclusions.  It preserves @...@
6500 # substitutions.
6501 #
6502 # If COND is 'all', then all values under all conditions should be
6503 # returned; if COND is a particular condition (all conditions are
6504 # surrounded by @...@) then only the value for that condition should
6505 # be returned; otherwise, warn if VAR is conditionally defined.
6506 # SCANNED is a global hash listing whose keys are all the variables
6507 # already scanned; it is an error to rescan a variable.
6508 sub value_to_list ($$$)
6509 {
6510     my ($var, $val, $cond) = @_;
6511     my @result;
6512
6513     # Strip backslashes
6514     $val =~ s/\\(\n|$)/ /g;
6515
6516     foreach (split (' ', $val))
6517     {
6518         # If a comment seen, just leave.
6519         last if /^#/;
6520
6521         # Handle variable substitutions.
6522         if (/^\$\{([^}]*)\}$/ || /^\$\(([^)]*)\)$/)
6523         {
6524             my $varname = $1;
6525
6526             # If the user uses a losing variable name, just ignore it.
6527             # This isn't ideal, but people have requested it.
6528             next if ($varname =~ /\@.*\@/);
6529
6530             my ($from, $to);
6531             my @temp_list;
6532             if ($varname =~ /$SUBST_REF_PATTERN/o)
6533             {
6534                 $varname = $1;
6535                 $to = $3;
6536                 $from = quotemeta $2;
6537             }
6538
6539             # Find the value.
6540             @temp_list =
6541               variable_value_as_list_recursive_worker ($1, $cond, $var);
6542
6543             # Now rewrite the value if appropriate.
6544             if (defined $from)
6545             {
6546                 grep (s/$from$/$to/, @temp_list);
6547             }
6548
6549             push (@result, @temp_list);
6550         }
6551         else
6552         {
6553             push (@result, $_);
6554         }
6555     }
6556
6557     return @result;
6558 }
6559
6560
6561 # @VALUES
6562 # variable_value_as_list ($VAR, $COND, $PARENT)
6563 # ---------------------------------------------
6564 # Get the value of a variable given a specified condition. without
6565 # recursing through any subvariables.
6566 # Arguments are:
6567 #   $VAR    is the variable
6568 #   $COND   is the condition.  If this is not given, the value for the
6569 #           "TRUE" condition will be returned.
6570 #   $PARENT is the variable in which the variable is used: this is used
6571 #           only for error messages.
6572 # Returns the list of conditions.
6573 # For example, if A is defined as "foo $(B) bar", and B is defined as
6574 # "baz", this will return ("foo", "$(B)", "bar")
6575 sub variable_value_as_list
6576 {
6577     my ($var, $cond, $parent) = @_;
6578     my @result;
6579
6580     # Check defined
6581     return
6582       unless variable_assert $var, $parent;
6583
6584     # Get value for given condition
6585     $cond ||= 'TRUE';
6586     my $onceflag;
6587     foreach my $vcond (keys %{$var_value{$var}})
6588     {
6589         my $val = $var_value{$var}{$vcond};
6590
6591         if (&conditional_true_when ($vcond, $cond))
6592         {
6593             # Unless variable is not defined conditionally, there should only
6594             # be one value of $vcond true when $cond.
6595             &check_variable_defined_unconditionally ($var, $parent)
6596                     if $onceflag;
6597             $onceflag = 1;
6598
6599             # Strip backslashes
6600             $val =~ s/\\(\n|$)/ /g;
6601
6602             foreach (split (' ', $val))
6603             {
6604                 # If a comment seen, just leave.
6605                 last if /^#/;
6606
6607                 push (@result, $_);
6608             }
6609         }
6610     }
6611
6612     return @result;
6613 }
6614
6615
6616 # @VALUE
6617 # &variable_value_as_list_recursive_worker ($VAR, $COND, $PARENT)
6618 # ---------------------------------------------------------------
6619 # Return contents of VAR as a list, split on whitespace.  This will
6620 # recursively follow $(...) and ${...} inclusions.  It preserves @...@
6621 # substitutions.  If COND is 'all', then all values under all
6622 # conditions should be returned; if COND is a particular condition
6623 # (all conditions are surrounded by @...@) then only the value for
6624 # that condition should be returned; otherwise, warn if VAR is
6625 # conditionally defined.  If PARENT is specified, it is the name of
6626 # the including variable; this is only used for error reports.
6627 sub variable_value_as_list_recursive_worker ($$$)
6628 {
6629     my ($var, $cond, $parent) = @_;
6630     my @result = ();
6631
6632     return
6633       unless variable_assert $var, $parent;
6634
6635     if (defined $vars_scanned{$var})
6636     {
6637         # `vars_scanned' is a global we use to keep track of which
6638         # variables we've already examined.
6639         macro_error ($parent, "variable `$var' recursively defined");
6640     }
6641     elsif ($cond eq 'all')
6642     {
6643         $vars_scanned{$var} = 1;
6644         foreach my $vcond (keys %{$var_value{$var}})
6645         {
6646             my $val = $var_value{$var}{$vcond};
6647             push (@result, &value_to_list ($var, $val, $cond));
6648         }
6649     }
6650     else
6651     {
6652         $cond ||= 'TRUE';
6653         $vars_scanned{$var} = 1;
6654         my $onceflag;
6655         foreach my $vcond (keys %{$var_value{$var}})
6656         {
6657             my $val = $var_value{$var}{$vcond};
6658             if (&conditional_true_when ($vcond, $cond))
6659             {
6660                 # Warn if we have an ambiguity.  It's hard to know how
6661                 # to handle this case correctly.
6662                 &check_variable_defined_unconditionally ($var, $parent)
6663                     if $onceflag;
6664                 $onceflag = 1;
6665                 push (@result, &value_to_list ($var, $val, $cond));
6666             }
6667         }
6668     }
6669
6670     # Unset our entry in vars_scanned.  We only care about recursive
6671     # definitions.
6672     delete $vars_scanned{$var};
6673
6674     return @result;
6675 }
6676
6677
6678 # &variable_output ($VAR, [@CONDS])
6679 # ---------------------------------
6680 # Output all the values of $VAR is @COND is not specified, else only
6681 # that corresponding to @COND.
6682 sub variable_output ($@)
6683 {
6684   my ($var, @conds) = @_;
6685
6686   @conds = keys %{$var_value{$var}}
6687     unless @conds;
6688
6689   $output_vars .= $var_comment{$var}
6690     if defined $var_comment{$var};
6691
6692   foreach my $cond (sort by_condition @conds)
6693     {
6694       my $val = $var_value{$var}{$cond};
6695       my $equals = $var_type{$var} eq ':' ? ':=' : '=';
6696       my $output_var = "$var $equals $val";
6697       $output_var =~ s/^/make_condition ($cond)/meg;
6698       $output_vars .= $output_var . "\n";
6699     }
6700 }
6701
6702
6703 # &variable_pretty_output ($VAR, [@CONDS])
6704 # ----------------------------------------
6705 # Likewise, but pretty, i.e., we *split* the values at spaces.   Use only
6706 # with variables holding filenames.
6707 sub variable_pretty_output ($@)
6708 {
6709   my ($var, @conds) = @_;
6710
6711   @conds = keys %{$var_value{$var}}
6712     unless @conds;
6713
6714   $output_vars .= $var_comment{$var}
6715     if defined $var_comment{$var};
6716
6717   foreach my $cond (sort by_condition @conds)
6718     {
6719       my $val = $var_value{$var}{$cond};
6720       my $equals = $var_type{$var} eq ':' ? ':=' : '=';
6721       my $make_condition = make_condition ($cond);
6722       $output_vars .= pretty_print_internal ("$make_condition$var $equals",
6723                                              "$make_condition\t",
6724                                              split (' ' , $val));
6725     }
6726 }
6727
6728
6729 # &variable_value_as_list_recursive ($VAR, $COND, $PARENT)
6730 # --------------------------------------------------------
6731 # This is just a wrapper for variable_value_as_list_recursive_worker that
6732 # initializes the global hash `vars_scanned'.  This hash is used to
6733 # avoid infinite recursion.
6734 sub variable_value_as_list_recursive ($$@)
6735 {
6736     my ($var, $cond, $parent) = @_;
6737     %vars_scanned = ();
6738     return &variable_value_as_list_recursive_worker ($var, $cond, $parent);
6739 }
6740
6741
6742 # &define_pretty_variable ($VAR, $COND, @VALUE)
6743 # ---------------------------------------------
6744 # Like define_variable, but the value is a list, and the variable may
6745 # be defined conditionally.  The second argument is the conditional
6746 # under which the value should be defined; this should be the empty
6747 # string to define the variable unconditionally.  The third argument
6748 # is a list holding the values to use for the variable.  The value is
6749 # pretty printed in the output file.
6750 sub define_pretty_variable ($$@)
6751 {
6752     my ($var, $cond, @value) = @_;
6753
6754     # Beware that an empty $cond has a different semantics for
6755     # macro_define and variable_pretty_output.
6756     $cond ||= 'TRUE';
6757
6758     if (! variable_defined ($var, $cond))
6759     {
6760         macro_define ($var, 1, '', $cond, "@value", undef);
6761         variable_pretty_output ($var, $cond || 'TRUE');
6762         $content_seen{$var} = 1;
6763     }
6764 }
6765
6766
6767 # define_variable ($VAR, $VALUE)
6768 # ------------------------------
6769 # Define a new user variable VAR to VALUE, but only if not already defined.
6770 sub define_variable ($$)
6771 {
6772     my ($var, $value) = @_;
6773     define_pretty_variable ($var, 'TRUE', $value);
6774 }
6775
6776
6777 # Like define_variable, but define a variable to be the configure
6778 # substitution by the same name.
6779 sub define_configure_variable ($)
6780 {
6781     my ($var) = @_;
6782     if (! variable_defined ($var, 'TRUE'))
6783     {
6784         # A macro defined via configure is a `user' macro -- we should not
6785         # override it.
6786         macro_define ($var, 0, '', 'TRUE', subst $var, $configure_vars{$var});
6787         variable_pretty_output ($var, 'TRUE');
6788     }
6789 }
6790
6791
6792 # define_compiler_variable ($LANG)
6793 # --------------------------------
6794 # Define a compiler variable.  We also handle defining the `LT'
6795 # version of the command when using libtool.
6796 sub define_compiler_variable ($)
6797 {
6798     my ($lang) = @_;
6799
6800     my ($var, $value) = ($lang->compiler, $lang->compile);
6801     &define_variable ($var, $value);
6802     &define_variable ("LT$var", "\$(LIBTOOL) --mode=compile $value")
6803       if $seen_libtool;
6804 }
6805
6806
6807 # define_linker_variable ($LANG)
6808 # ------------------------------
6809 # Define linker variables.
6810 sub define_linker_variable ($)
6811 {
6812     my ($lang) = @_;
6813
6814     my ($var, $value) = ($lang->lder, $lang->ld);
6815     # CCLD = $(CC).
6816     &define_variable ($lang->lder, $lang->ld);
6817     # CCLINK = $(CCLD) blah blah...
6818     &define_variable ($lang->linker,
6819                       (($seen_libtool ? '$(LIBTOOL) --mode=link ' : '')
6820                        . $lang->link));
6821 }
6822
6823 ################################################################
6824
6825 ## ---------------- ##
6826 ## Handling rules.  ##
6827 ## ---------------- ##
6828
6829 # $BOOL
6830 # rule_define ($TARGET, $IS_AM, $COND, $WHERE)
6831 # --------------------------------------------
6832 # Define a new rule.  $TARGET is the rule name.  $IS_AM is a boolean
6833 # which is true if the new rule is defined by the user.  $COND is the
6834 # condition under which the rule is defined.  $WHERE is where the rule
6835 # is defined (file name or line number).  Returns true if it is ok to
6836 # define the rule, false otherwise.
6837 sub rule_define ($$$$)
6838 {
6839   my ($target, $rule_is_am, $cond, $where) = @_;
6840
6841   # For now `foo:' will override `foo$(EXEEXT):'.  This is temporary,
6842   # though, so we emit a warning.
6843   (my $noexe = $target) =~ s,\$\(EXEEXT\)$,,;
6844   if ($noexe ne $target && defined $targets{$noexe})
6845   {
6846       # The no-exeext option enables this feature.
6847       if (! defined $options{'no-exeext'})
6848       {
6849           macro_error ($noexe,
6850                        "deprecated feature: `$noexe' overrides `$noexe\$(EXEEXT)'\nchange your target to read `$noexe\$(EXEEXT)'");
6851       }
6852       # Don't define.
6853       return 0;
6854   }
6855
6856   if (defined $targets{$target}
6857       && ($cond
6858           ? ! defined $target_conditional{$target}
6859           : defined $target_conditional{$target}))
6860   {
6861       target_error ($target,
6862                     "$target defined both conditionally and unconditionally");
6863   }
6864
6865   # Value here doesn't matter; for targets we only note existence.
6866   $targets{$target} = $where;
6867   if ($cond)
6868   {
6869       if ($target_conditional{$target})
6870       {
6871           &check_ambiguous_conditional ($target, $cond);
6872       }
6873       $target_conditional{$target}{$cond} = $where;
6874   }
6875
6876   # Check the rule for being a suffix rule. If so, store in a hash.
6877   # Either it's a rule for two known extensions...
6878   if ($target =~ /^($KNOWN_EXTENSIONS_PATTERN)($KNOWN_EXTENSIONS_PATTERN)$/
6879   # ...or it's a rule with unknown extensions (.i.e, the rule looks like
6880   # `.foo.bar:' but `.foo' or `.bar' are not declared in SUFFIXES
6881   # and are not known language extensions).
6882   # Automake will complete SUFFIXES from @suffixes automatically
6883   # (see handle_footer).
6884       || ($target =~ /$SUFFIX_RULE_PATTERN/o && accept_extensions($1)))
6885   {
6886       my $internal_ext = $2;
6887
6888       # When tranforming sources to objects, Automake uses the
6889       # %suffix_rules to move from each source extension to
6890       # `.$(OBJEXT)', not to `.o' or `.obj'.  However some people
6891       # define suffix rules for `.o' or `.obj', so internally we will
6892       # consider these extensions equivalent to `.$(OBJEXT)'.  We
6893       # CANNOT rewrite the target (i.e., automagically replace `.o'
6894       # and `.obj' by `.$(OBJEXT)' in the output), or warn the user
6895       # that (s)he'd better use `.$(OBJEXT)', because Automake itself
6896       # output suffix rules for `.o' or `.obj'...
6897       $internal_ext = '.$(OBJEXT)' if ($2 eq '.o' || $2 eq '.obj');
6898
6899       $suffix_rules{$1} = $internal_ext;
6900       verbose "Sources ending in $1 become $2";
6901       push @suffixes, $1, $2;
6902   }
6903
6904   return 1;
6905 }
6906
6907
6908 # See if a target exists.
6909 sub target_defined
6910 {
6911     my ($target) = @_;
6912     return defined $targets{$target};
6913 }
6914
6915
6916 ################################################################
6917
6918 # &append_comments ($VARIABLE, $SPACING, $COMMENT)
6919 # ------------------------------------------------
6920 # Apped $COMMENT to the other comments for $VARIABLE, using
6921 # $SPACING as separator.
6922 sub append_comments ($$$)
6923 {
6924     my ($var, $spacing, $comment) = @_;
6925     $var_comment{$var} .= $spacing
6926         if (!defined $var_comment{$var} || $var_comment{$var} !~ /\n$/o);
6927     $var_comment{$var} .= $comment;
6928 }
6929
6930
6931 # &read_am_file ($AMFILE)
6932 # -----------------------
6933 # Read Makefile.am and set up %contents.  Simultaneously copy lines
6934 # from Makefile.am into $output_trailer or $output_vars as
6935 # appropriate.  NOTE we put rules in the trailer section.  We want
6936 # user rules to come after our generated stuff.
6937 sub read_am_file ($)
6938 {
6939     my ($amfile) = @_;
6940
6941     my $am_file = new Automake::XFile ("< $amfile");
6942     verbose "reading $amfile";
6943
6944     my $spacing = '';
6945     my $comment = '';
6946     my $blank = 0;
6947     my $saw_bk = 0;
6948
6949     while ($_ = $am_file->getline)
6950     {
6951         if (/$IGNORE_PATTERN/o)
6952         {
6953             # Merely delete comments beginning with two hashes.
6954         }
6955         elsif (/$WHITE_PATTERN/o)
6956         {
6957             file_error ("$amfile:$.",
6958                         "blank line following trailing backslash")
6959                 if $saw_bk;
6960             # Stick a single white line before the incoming macro or rule.
6961             $spacing = "\n";
6962             $blank = 1;
6963             # Flush all comments seen so far.
6964             if ($comment ne '')
6965             {
6966                 $output_vars .= $comment;
6967                 $comment = '';
6968             }
6969         }
6970         elsif (/$COMMENT_PATTERN/o)
6971         {
6972             # Stick comments before the incoming macro or rule.  Make
6973             # sure a blank line preceeds first block of comments.
6974             $spacing = "\n" unless $blank;
6975             $blank = 1;
6976             $comment .= $spacing . $_;
6977             $spacing = '';
6978         }
6979         else
6980         {
6981             last;
6982         }
6983         $saw_bk = /\\$/ && ! /$IGNORE_PATTERN/o;
6984     }
6985
6986     # We save the conditional stack on entry, and then check to make
6987     # sure it is the same on exit.  This lets us conditonally include
6988     # other files.
6989     my @saved_cond_stack = @cond_stack;
6990     my $cond = conditional_string (@cond_stack);
6991
6992     my $was_rule = 0;
6993     my $last_var_name = '';
6994     my $last_var_type = '';
6995     my $last_var_value = '';
6996     # FIXME: shouldn't use $_ in this loop; it is too big.
6997     while ($_)
6998     {
6999         my $here = "$amfile:$.";
7000
7001         # Make sure the line is \n-terminated.
7002         chomp;
7003         $_ .= "\n";
7004
7005         # Don't look at MAINTAINER_MODE_TRUE here.  That shouldn't be
7006         # used by users.  @MAINT@ is an anachronism now.
7007         $_ =~ s/\@MAINT\@//g
7008             unless $seen_maint_mode;
7009
7010         my $new_saw_bk = /\\$/ && ! /$IGNORE_PATTERN/o;
7011
7012         if (/$IGNORE_PATTERN/o)
7013         {
7014             # Merely delete comments beginning with two hashes.
7015         }
7016         elsif (/$WHITE_PATTERN/o)
7017         {
7018             # Stick a single white line before the incoming macro or rule.
7019             $spacing = "\n";
7020             file_error ($here, "blank line following trailing backslash")
7021                 if $saw_bk;
7022         }
7023         elsif (/$COMMENT_PATTERN/o)
7024         {
7025             # Stick comments before the incoming macro or rule.
7026             $comment .= $spacing . $_;
7027             $spacing = '';
7028             file_error ($here, "comment following trailing backslash")
7029                 if $saw_bk && $comment eq '';
7030         }
7031         elsif ($saw_bk)
7032         {
7033             if ($was_rule)
7034             {
7035                 $output_trailer .= &make_condition (@cond_stack);
7036                 $output_trailer .= $_;
7037             }
7038             else
7039             {
7040               $last_var_value .= ' '
7041                 unless $last_var_value =~ /\s$/;
7042               $last_var_value .= $_;
7043
7044               if (!/\\$/)
7045                 {
7046                   append_comments $last_var_name, $spacing, $comment;
7047                   $comment = $spacing = '';
7048                   macro_define ($last_var_name, 0,
7049                                 $last_var_type, $cond,
7050                                 $last_var_value, $here)
7051                     if $cond ne 'FALSE';
7052                   push (@var_list, $last_var_name);
7053                 }
7054             }
7055         }
7056
7057         elsif (/$IF_PATTERN/o)
7058           {
7059             $cond = cond_stack_if ($1, $2, $here);
7060           }
7061         elsif (/$ELSE_PATTERN/o)
7062           {
7063             $cond = cond_stack_else ($1, $2, $here);
7064           }
7065         elsif (/$ENDIF_PATTERN/o)
7066           {
7067             $cond = cond_stack_endif ($1, $2, $here);
7068           }
7069
7070         elsif (/$RULE_PATTERN/o)
7071         {
7072             # Found a rule.
7073             $was_rule = 1;
7074
7075             rule_define ($1, 0, $cond, $here);
7076
7077             $output_trailer .= $comment . $spacing;
7078             $output_trailer .= &make_condition (@cond_stack);
7079             $output_trailer .= $_;
7080             $comment = $spacing = '';
7081         }
7082         elsif (/$ASSIGNMENT_PATTERN/o)
7083         {
7084             # Found a macro definition.
7085             $was_rule = 0;
7086             $last_var_name = $1;
7087             $last_var_type = $2;
7088             $last_var_value = $3;
7089             if ($3 ne '' && substr ($3, -1) eq "\\")
7090             {
7091                 # We preserve the `\' because otherwise the long lines
7092                 # that are generated will be truncated by broken
7093                 # `sed's.
7094                 $last_var_value = $3 . "\n";
7095             }
7096
7097             if (!/\\$/)
7098               {
7099                 # FIXME: this doesn't always work correctly; it will
7100                 # group all comments for a given variable, no matter
7101                 # where defined.
7102                 # Accumulating variables must not be output.
7103                 append_comments $last_var_name, $spacing, $comment;
7104                 $comment = $spacing = '';
7105
7106                 macro_define ($last_var_name, 0,
7107                               $last_var_type, $cond,
7108                               $last_var_value, $here)
7109                   if $cond ne 'FALSE';
7110                 push (@var_list, $last_var_name);
7111               }
7112         }
7113         elsif (/$INCLUDE_PATTERN/o)
7114         {
7115             my $path = $1;
7116
7117             if ($path =~ s/^\$\(top_srcdir\)\///)
7118             {
7119                 push (@include_stack, "\$\(top_srcdir\)/$path");
7120             }
7121             else
7122             {
7123                 $path =~ s/\$\(srcdir\)\///;
7124                 push (@include_stack, "\$\(srcdir\)/$path");
7125                 $path = $relative_dir . "/" . $path;
7126             }
7127             &read_am_file ($path);
7128         }
7129         else
7130         {
7131             # This isn't an error; it is probably a continued rule.
7132             # In fact, this is what we assume.
7133             $was_rule = 1;
7134             $output_trailer .= $comment . $spacing;
7135             $output_trailer .= &make_condition  (@cond_stack);
7136             $output_trailer .= $_;
7137             $comment = $spacing = '';
7138             file_error ($here, "`#' comment at start of rule is unportable")
7139                 if $_ =~ /^\t\s*\#/;
7140         }
7141
7142         $saw_bk = $new_saw_bk;
7143         $_ = $am_file->getline;
7144     }
7145
7146     $output_trailer .= $comment;
7147
7148     if ("@saved_cond_stack" ne "@cond_stack")
7149     {
7150         if (@cond_stack)
7151         {
7152             &am_error ("unterminated conditionals: @cond_stack");
7153         }
7154         else
7155         {
7156             # FIXME: better error message here.
7157             &am_error ("conditionals not nested in include file");
7158         }
7159     }
7160 }
7161
7162
7163 # define_standard_variables ()
7164 # ----------------------------
7165 # A helper for read_main_am_file which initializes configure variables
7166 # and variables from header-vars.am.  This is a subr so we can call it
7167 # twice.
7168 sub define_standard_variables
7169 {
7170     my $saved_output_vars = $output_vars;
7171     my ($comments, undef, $rules) =
7172       file_contents_internal (1, "$libdir/am/header-vars.am");
7173
7174     # This will output the definitions in $output_vars, which we don't
7175     # want...
7176     foreach my $var (sort keys %configure_vars)
7177     {
7178         &define_configure_variable ($var);
7179         push (@var_list, $var);
7180     }
7181
7182     # ... hence, we restore $output_vars.
7183     $output_vars = $saved_output_vars . $comments . $rules;
7184 }
7185
7186 # Read main am file.
7187 sub read_main_am_file
7188 {
7189     my ($amfile) = @_;
7190
7191     # This supports the strange variable tricks we are about to play.
7192     if (scalar keys %var_value > 0)
7193       {
7194         macros_dump ();
7195         prog_error ("variable defined before read_main_am_file");
7196       }
7197
7198     # Generate copyright header for generated Makefile.in.
7199     # We do discard the output of predefined variables, handled below.
7200     $output_vars = ("# $in_file_name generated by automake "
7201                    . $VERSION . " from $am_file_name.\n");
7202     $output_vars .= '# ' . subst ('configure_input') . "\n";
7203     $output_vars .= $gen_copyright;
7204
7205     # We want to predefine as many variables as possible.  This lets
7206     # the user set them with `+=' in Makefile.am.  However, we don't
7207     # want these initial definitions to end up in the output quite
7208     # yet.  So we just load them, but output them later.
7209     &define_standard_variables;
7210
7211     # Read user file, which might override some of our values.
7212     &read_am_file ($amfile);
7213
7214     # Output all the Automake variables.  If the user changed one,
7215     # then it is now marked as owned by the user.
7216     foreach my $var (uniq @var_list)
7217     {
7218         # Don't process user variables.
7219         variable_output ($var)
7220           unless !$var_is_am{$var};
7221     }
7222
7223     # Now dump the user variables that were defined.  We do it in the same
7224     # order in which they were defined (skipping duplicates).
7225     foreach my $var (uniq @var_list)
7226     {
7227         # Don't process Automake variables.
7228         variable_output ($var)
7229           unless $var_is_am{$var};
7230     }
7231 }
7232
7233 ################################################################
7234
7235 # $FLATTENED
7236 # &flatten ($STRING)
7237 # ------------------
7238 # Flatten the $STRING and return the result.
7239 sub flatten
7240 {
7241   $_ = shift;
7242
7243   s/\\\n//somg;
7244   s/\s+/ /g;
7245   s/^ //;
7246   s/ $//;
7247
7248   return $_;
7249 }
7250
7251
7252 # @PARAGRAPHS
7253 # &make_paragraphs ($MAKEFILE, [%TRANSFORM])
7254 # ------------------------------------------
7255 # Load a $MAKEFILE, apply the %TRANSFORM, and return it as a list of
7256 # paragraphs.
7257 sub make_paragraphs ($%)
7258 {
7259     my ($file, %transform) = @_;
7260
7261     # Complete %transform with global options and make it a Perl
7262     # $command.
7263     my $command =
7264       "s/$IGNORE_PATTERN//gm;"
7265         . transform (%transform,
7266
7267                      'CYGNUS'          => $cygnus_mode,
7268                      'MAINTAINER-MODE'
7269                      => $seen_maint_mode ? subst ('MAINTAINER_MODE_TRUE') : '',
7270
7271                      'SHAR'        => $options{'dist-shar'} || 0,
7272                      'BZIP2'       => $options{'dist-bzip2'} || 0,
7273                      'ZIP'         => $options{'dist-zip'} || 0,
7274                      'COMPRESS'    => $options{'dist-tarZ'} || 0,
7275
7276                      'INSTALL-INFO' => !$options{'no-installinfo'},
7277                      'INSTALL-MAN'  => !$options{'no-installman'},
7278                      'CK-NEWS'      => $options{'check-news'} || 0,
7279
7280                      'SUBDIRS'      => variable_defined ('SUBDIRS'),
7281                      'TOPDIR'       => backname ($relative_dir),
7282                      'TOPDIR_P'     => $relative_dir eq '.',
7283                      'CONFIGURE-AC' => $configure_ac,
7284
7285                      'BUILD'    => $seen_canonical == AC_CANONICAL_SYSTEM,
7286                      'HOST'     => $seen_canonical,
7287                      'TARGET'   => $seen_canonical == AC_CANONICAL_SYSTEM,
7288
7289                      'LIBTOOL'      => defined $configure_vars{'LIBTOOL'})
7290           # We don't need more than two consecutive new-lines.
7291           . 's/\n{3,}/\n\n/g';
7292
7293     # Swallow the file and apply the COMMAND.
7294     my $fc_file = new Automake::XFile "< $file";
7295     # Looks stupid?
7296     verbose "reading $file";
7297     my $saved_dollar_slash = $/;
7298     undef $/;
7299     $_ = $fc_file->getline;
7300     $/ = $saved_dollar_slash;
7301     eval $command;
7302     $fc_file->close;
7303     my $content = $_;
7304
7305     # Split at unescaped new lines.
7306     my @lines = split (/(?<!\\)\n/, $content);
7307     my @res;
7308
7309     while (defined ($_ = shift @lines))
7310       {
7311         my $paragraph = "$_";
7312         # If we are a rule, eat as long as we start with a tab.
7313         if (/$RULE_PATTERN/smo)
7314           {
7315             while (defined ($_ = shift @lines) && $_ =~ /^\t/)
7316               {
7317                 $paragraph .= "\n$_";
7318               }
7319             unshift (@lines, $_);
7320           }
7321
7322         # If we are a comments, eat as much comments as you can.
7323         elsif (/$COMMENT_PATTERN/smo)
7324           {
7325             while (defined ($_ = shift @lines)
7326                    && $_ =~ /$COMMENT_PATTERN/smo)
7327               {
7328                 $paragraph .= "\n$_";
7329               }
7330             unshift (@lines, $_);
7331           }
7332
7333         push @res, $paragraph;
7334         $paragraph = '';
7335       }
7336
7337     return @res;
7338 }
7339
7340
7341
7342 # ($COMMENT, $VARIABLES, $RULES)
7343 # &file_contents_internal ($IS_AM, $FILE, [%TRANSFORM])
7344 # -----------------------------------------------------
7345 # Return contents of a file from $libdir/am, automatically skipping
7346 # macros or rules which are already known. $IS_AM iff the caller is
7347 # reading an Automake file (as opposed to the user's Makefile.am).
7348 sub file_contents_internal ($$%)
7349 {
7350     my ($is_am, $file, %transform) = @_;
7351
7352     my $result_vars = '';
7353     my $result_rules = '';
7354     my $comment = '';
7355     my $spacing = '';
7356
7357     # The following flags are used to track rules spanning across
7358     # multiple paragraphs.
7359     my $is_rule = 0;            # 1 if we are processing a rule.
7360     my $discard_rule = 0;       # 1 if the current rule should not be output.
7361
7362     # We save the conditional stack on entry, and then check to make
7363     # sure it is the same on exit.  This lets us conditonally include
7364     # other files.
7365     my @saved_cond_stack = @cond_stack;
7366     my $cond = conditional_string (@cond_stack);
7367
7368     foreach (make_paragraphs ($file, %transform))
7369     {
7370         # Sanity checks.
7371         file_error ($file, "blank line following trailing backslash:\n$_")
7372           if /\\$/;
7373         file_error ($file, "comment following trailing backslash:\n$_")
7374           if /\\#/;
7375
7376         if (/^$/)
7377         {
7378             $is_rule = 0;
7379             # Stick empty line before the incoming macro or rule.
7380             $spacing = "\n";
7381         }
7382         elsif (/$COMMENT_PATTERN/mso)
7383         {
7384             $is_rule = 0;
7385             # Stick comments before the incoming macro or rule.
7386             $comment = "$_\n";
7387         }
7388
7389         # Handle inclusion of other files.
7390         elsif (/$INCLUDE_PATTERN/o)
7391         {
7392             if ($cond ne 'FALSE')
7393               {
7394                 my $file = ($is_am ? "$libdir/am/" : '') . $1;
7395                 # N-ary `.=' fails.
7396                 my ($com, $vars, $rules)
7397                   = file_contents_internal ($is_am, $file, %transform);
7398                 $comment .= $com;
7399                 $result_vars .= $vars;
7400                 $result_rules .= $rules;
7401               }
7402         }
7403
7404         # Handling the conditionals.
7405         elsif (/$IF_PATTERN/o)
7406           {
7407             $cond = cond_stack_if ($1, $2, $file);
7408           }
7409         elsif (/$ELSE_PATTERN/o)
7410           {
7411             $cond = cond_stack_else ($1, $2, $file);
7412           }
7413         elsif (/$ENDIF_PATTERN/o)
7414           {
7415             $cond = cond_stack_endif ($1, $2, $file);
7416           }
7417
7418         # Handling rules.
7419         elsif (/$RULE_PATTERN/mso)
7420         {
7421           $is_rule = 1;
7422           $discard_rule = 0;
7423           # Separate relationship from optional actions: the first
7424           # `new-line tab" not preceded by backslash (continuation
7425           # line).
7426           # I'm quite shoked!  It seems that (\\\n|[^\n]) is not the
7427           # same as `([^\n]|\\\n)!!!  Don't swap it, it breaks.
7428           my $paragraph = $_;
7429           /^((?:\\\n|[^\n])*)(?:\n(\t.*))?$/som;
7430           my ($relationship, $actions) = ($1, $2 || '');
7431
7432           # Separate targets from dependencies: the first colon.
7433           $relationship =~ /^([^:]+\S+) *: *(.*)$/som;
7434           my ($targets, $dependencies) = ($1, $2);
7435           # Remove the escaped new lines.
7436           # I don't know why, but I have to use a tmp $flat_deps.
7437           my $flat_deps = &flatten ($dependencies);
7438           my @deps = split (' ', $flat_deps);
7439
7440           foreach (split (' ' , $targets))
7441             {
7442               # FIXME: We are not robust to people defining several targets
7443               # at once, only some of them being in %dependencies.  The
7444               # actions from the targets in %dependencies are usually generated
7445               # from the content of %actions, but if some targets in $targets
7446               # are not in %dependencies the ELSE branch will output
7447               # a rule for all $targets (i.e. the targets which are both
7448               # in %dependencies and $targets will have two rules).
7449
7450               # FIXME: The logic here is not able to output a
7451               # multi-paragraph rule several time (e.g. for each conditional
7452               # it is defined for) because it only knows the first paragraph.
7453
7454               # Output only if not in FALSE.
7455               if (defined $dependencies{$_}
7456                   && $cond ne 'FALSE')
7457                 {
7458                   &depend ($_, @deps);
7459                   $actions{$_} .= $actions;
7460                 }
7461               else
7462                 {
7463                   # Free-lance dependency.  Output the rule for all the
7464                   # targets instead of one by one.
7465
7466                   # Work out all the conditions for which the target hasn't
7467                   # been defined
7468                   my @undefined_conds;
7469                   if (defined $target_conditional{$targets})
7470                     {
7471                       my @defined_conds = keys %{$target_conditional{$targets}};
7472                       @undefined_conds = invert_conditions(@defined_conds);
7473                     }
7474                   else
7475                     {
7476                       if (defined $targets{$targets})
7477                         {
7478                           # No conditions for which target hasn't been defined
7479                           @undefined_conds = ();
7480                         }
7481                       else
7482                         {
7483                           # Target hasn't been defined for any conditions
7484                           @undefined_conds = ("");
7485                         }
7486                     }
7487
7488                   if ($cond ne 'FALSE')
7489                     {
7490                       for my $undefined_cond (@undefined_conds)
7491                       {
7492                           my $condparagraph = $paragraph;
7493                           $condparagraph =~ s/^/make_condition (@cond_stack, $undefined_cond)/gme;
7494                           if (rule_define ($targets, $is_am,
7495                                           "$cond $undefined_cond", $file))
7496                           {
7497                               $result_rules .=
7498                                   "$spacing$comment$condparagraph\n"
7499                           }
7500                           else
7501                           {
7502                               # Remember to discard next paragraphs
7503                               # if they belong to this rule.
7504                               $discard_rule = 1;
7505                           }
7506                       }
7507                       if ($#undefined_conds == -1)
7508                       {
7509                           # This target has already been defined, the rule
7510                           # has not been defined. Remember to discard next
7511                           # paragraphs if they belong to this rule.
7512                           $discard_rule = 1;
7513                       }
7514                     }
7515                   $comment = $spacing = '';
7516                   last;
7517                 }
7518             }
7519         }
7520
7521         elsif (/$ASSIGNMENT_PATTERN/mso)
7522         {
7523             my ($var, $type, $val) = ($1, $2, $3);
7524             file_error ($file, "macro `$var' with trailing backslash")
7525               if /\\$/;
7526
7527             $is_rule = 0;
7528
7529             # Accumulating variables must not be output.
7530             append_comments $var, $spacing, $comment;
7531             macro_define ($var, $is_am, $type, $cond, $val, $file)
7532               if $cond ne 'FALSE';
7533             push (@var_list, $var);
7534
7535             # If the user has set some variables we were in charge
7536             # of (which is detected by the first reading of
7537             # `header-vars.am'), we must not output them.
7538             $result_vars .= "$spacing$comment$_\n"
7539               if $type ne '+' && $var_is_am{$var} && $cond ne 'FALSE';
7540
7541             $comment = $spacing = '';
7542         }
7543         else
7544         {
7545             # This isn't an error; it is probably some tokens which
7546             # configure is supposed to replace, such as `@SET-MAKE@',
7547             # or some part of a rule cut by an if/endif.
7548             if ($cond ne 'FALSE' && ! ($is_rule && $discard_rule))
7549               {
7550                 s/^/make_condition (@cond_stack)/gme;
7551                 $result_rules .= "$spacing$comment$_\n";
7552               }
7553             $comment = $spacing = '';
7554         }
7555     }
7556
7557     if ("@saved_cond_stack" ne "@cond_stack")
7558     {
7559         if (@cond_stack)
7560         {
7561             &am_error ("unterminated conditionals: @cond_stack");
7562         }
7563         else
7564         {
7565             # FIXME: better error message here.
7566             &am_error ("conditionals not nested in include file");
7567         }
7568     }
7569
7570     return ($comment, $result_vars, $result_rules);
7571 }
7572
7573
7574 # $CONTENTS
7575 # &file_contents ($BASENAME, [%TRANSFORM])
7576 # ----------------------------------------
7577 # Return contents of a file from $libdir/am, automatically skipping
7578 # macros or rules which are already known.
7579 sub file_contents ($%)
7580 {
7581     my ($basename, %transform) = @_;
7582     my ($comments, $variables, $rules) =
7583       file_contents_internal (1, "$libdir/am/$basename.am", %transform);
7584     return "$comments$variables$rules";
7585 }
7586
7587
7588 # $REGEXP
7589 # &transform (%PAIRS)
7590 # -------------------
7591 # Foreach ($TOKEN, $VAL) in %PAIRS produce a replacement expression suitable
7592 # for file_contents which:
7593 #   - replaces %$TOKEN% with $VAL,
7594 #   - enables/disables ?$TOKEN? and ?!$TOKEN?,
7595 #   - replaces %?$TOKEN% with TRUE or FALSE.
7596 sub transform (%)
7597 {
7598     my (%pairs) = @_;
7599     my $result = '';
7600
7601     while (my ($token, $val) = each %pairs)
7602     {
7603         $result .= "s/\Q%$token%\E/\Q$val\E/gm;";
7604         if ($val)
7605         {
7606             $result .= "s/\Q?$token?\E//gm;s/^.*\Q?!$token?\E.*\\n//gm;";
7607             $result .= "s/\Q%?$token%\E/TRUE/gm;";
7608         }
7609         else
7610         {
7611             $result .= "s/\Q?!$token?\E//gm;s/^.*\Q?$token?\E.*\\n//gm;";
7612             $result .= "s/\Q%?$token%\E/FALSE/gm;";
7613         }
7614     }
7615
7616     return $result;
7617 }
7618
7619
7620 # &append_exeext ($MACRO)
7621 # -----------------------
7622 # Macro is an Automake magic macro which primary is PROGRAMS, e.g.
7623 # bin_PROGRAMS.  Make sure these programs have $(EXEEXT) appended.
7624 sub append_exeext ($)
7625 {
7626   my ($macro) = @_;
7627
7628   prog_error "append_exeext ($macro)"
7629     unless $macro =~ /_PROGRAMS$/;
7630
7631   my @conds = variable_conditions_recursive ($macro);
7632
7633   my @condvals;
7634   foreach my $cond (@conds)
7635     {
7636       my @one_binlist = ();
7637       my @condval = variable_value_as_list_recursive ($macro, $cond);
7638       foreach my $rcurs (@condval)
7639         {
7640           # Skip autoconf substs.  Also skip if the user
7641           # already applied $(EXEEXT).
7642           if ($rcurs =~ /^\@.*\@$/ || $rcurs =~ /\$\(EXEEXT\)$/)
7643             {
7644               push (@one_binlist, $rcurs);
7645             }
7646           else
7647             {
7648               push (@one_binlist, $rcurs . '$(EXEEXT)');
7649             }
7650         }
7651
7652       push (@condvals, $cond);
7653       push (@condvals, "@one_binlist");
7654     }
7655
7656   macro_delete ($macro);
7657   while (@condvals)
7658     {
7659       my $cond = shift (@condvals);
7660       my @val = split (' ', shift (@condvals));
7661       define_pretty_variable ($macro, $cond, @val);
7662     }
7663  }
7664
7665
7666 # @PREFIX
7667 # &am_primary_prefixes ($PRIMARY, $CAN_DIST, @PREFIXES)
7668 # -----------------------------------------------------
7669 # Find all variable prefixes that are used for install directories.  A
7670 # prefix `zar' qualifies iff:
7671 #
7672 # * `zardir' is a variable.
7673 # * `zar_PRIMARY' is a variable.
7674 #
7675 # As a side effect, it looks for misspellings.  It is an error to have
7676 # a variable ending in a "reserved" suffix whose prefix is unknown, eg
7677 # "bni_PROGRAMS".  However, unusual prefixes are allowed if a variable
7678 # of the same name (with "dir" appended) exists.  For instance, if the
7679 # variable "zardir" is defined, then "zar_PROGRAMS" becomes valid.
7680 # This is to provide a little extra flexibility in those cases which
7681 # need it.
7682 sub am_primary_prefixes ($$@)
7683 {
7684     my ($primary, $can_dist, @prefixes) = @_;
7685
7686     local $_;
7687     my %valid = map { $_ => 0 } @prefixes;
7688     $valid{'EXTRA'} = 0;
7689     foreach my $varname (keys %var_value)
7690     {
7691         # Automake is allowed to define variables that look like they
7692         # are magic variables, such as INSTALL_DATA.
7693         next
7694           if $var_is_am{$varname};
7695
7696         if ($varname =~ /^(nobase_)?(dist_|nodist_)?(.*)_$primary$/)
7697         {
7698             my ($base, $dist, $X) = ($1 || '', $2 || '', $3 || '');
7699             if ($dist ne '' && ! $can_dist)
7700             {
7701                 # Note that a configure variable is always legitimate.
7702                 # It is natural to name such variables after the
7703                 # primary, so we explicitly allow it.
7704                 macro_error ($varname,
7705                             "invalid variable `$varname': `dist' is forbidden")
7706                   if ! exists $configure_vars{$varname};
7707             }
7708             # A not-explicitely-allowed prefix X is allowed if Xdir
7709             # has been defined and X is not a standard prefix.
7710             elsif (! defined $valid{$X} && (! variable_defined ("${X}dir")
7711                                             || exists $standard_prefix{$X}))
7712             {
7713                 # Note that a configure variable is always legitimate.
7714                 # It is natural to name such variables after the
7715                 # primary, so we explicitly allow it.
7716                 macro_error ($varname, "invalid variable `$varname'")
7717                   if ! exists $configure_vars{$varname};
7718             }
7719             else
7720             {
7721                 # Ensure all extended prefixes are actually used.
7722                 $valid{"$base$dist$X"} = 1;
7723             }
7724         }
7725     }
7726
7727     # Return only those which are actually defined.
7728     return sort grep { variable_defined ($_ . '_' . $primary) } keys %valid;
7729 }
7730
7731
7732 # Handle `where_HOW' variable magic.  Does all lookups, generates
7733 # install code, and possibly generates code to define the primary
7734 # variable.  The first argument is the name of the .am file to munge,
7735 # the second argument is the primary variable (eg HEADERS), and all
7736 # subsequent arguments are possible installation locations.  Returns
7737 # list of all values of all _HOW targets.
7738 #
7739 # FIXME: this should be rewritten to be cleaner.  It should be broken
7740 # up into multiple functions.
7741 #
7742 # Usage is: am_install_var (OPTION..., file, HOW, where...)
7743 sub am_install_var
7744 {
7745     my (@args) = @_;
7746
7747     my $do_require = 1;
7748     my $can_dist = 0;
7749     my $default_dist = 0;
7750     while (@args)
7751     {
7752         if ($args[0] eq '-noextra')
7753         {
7754             $do_require = 0;
7755         }
7756         elsif ($args[0] eq '-candist')
7757         {
7758             $can_dist = 1;
7759         }
7760         elsif ($args[0] eq '-defaultdist')
7761         {
7762             $default_dist = 1;
7763             $can_dist = 1;
7764         }
7765         elsif ($args[0] !~ /^-/)
7766         {
7767             last;
7768         }
7769         shift (@args);
7770     }
7771
7772     my ($file, $primary, @prefix) = @args;
7773
7774     # Now that configure substitutions are allowed in where_HOW
7775     # variables, it is an error to actually define the primary.  We
7776     # allow `JAVA', as it is customarily used to mean the Java
7777     # interpreter.  This is but one of several Java hacks.  Similarly,
7778     # `PYTHON' is customarily used to mean the Python interpreter.
7779     macro_error ($primary, "`$primary' is an anachronism")
7780         if variable_defined ($primary)
7781             && ($primary ne 'JAVA' && $primary ne 'PYTHON');
7782
7783
7784     # Get the prefixes which are valid and actually used.
7785     @prefix = am_primary_prefixes ($primary, $can_dist, @prefix);
7786
7787     # If a primary includes a configure substitution, then the EXTRA_
7788     # form is required.  Otherwise we can't properly do our job.
7789     my $require_extra;
7790     my $warned_about_extra = 0;
7791
7792     my @used = ();
7793     my @result = ();
7794
7795     # True if the iteration is the first one.  Used for instance to
7796     # output parts of the associated file only once.
7797     my $first = 1;
7798     foreach my $X (@prefix)
7799     {
7800         my $nodir_name = $X;
7801         my $one_name = $X . '_' . $primary;
7802
7803         my $strip_subdir = 1;
7804         # If subdir prefix should be preserved, do so.
7805         if ($nodir_name =~ /^nobase_/)
7806           {
7807             $strip_subdir = 0;
7808             $nodir_name =~ s/^nobase_//;
7809           }
7810
7811         # If files should be distributed, do so.
7812         my $dist_p = 0;
7813         if ($can_dist)
7814           {
7815             $dist_p = (($default_dist && $nodir_name !~ /^nodist_/)
7816                        || (! $default_dist && $nodir_name =~ /^dist_/));
7817             $nodir_name =~ s/^(dist|nodist)_//;
7818           }
7819
7820         # Append actual contents of where_PRIMARY variable to
7821         # result.
7822         foreach my $rcurs (&variable_value_as_list_recursive ($one_name, 'all'))
7823           {
7824             # Skip configure substitutions.  Possibly bogus.
7825             if ($rcurs =~ /^\@.*\@$/)
7826               {
7827                 if ($nodir_name eq 'EXTRA')
7828                   {
7829                     if (! $warned_about_extra)
7830                       {
7831                         $warned_about_extra = 1;
7832                         macro_error ($one_name,
7833                                      "`$one_name' contains configure substitution, but shouldn't");
7834                       }
7835                   }
7836                 # Check here to make sure variables defined in
7837                 # configure.ac do not imply that EXTRA_PRIMARY
7838                 # must be defined.
7839                 elsif (! defined $configure_vars{$one_name})
7840                   {
7841                     $require_extra = $one_name
7842                       if $do_require;
7843                   }
7844
7845                 next;
7846               }
7847
7848             push (@result, $rcurs);
7849           }
7850
7851         # A blatant hack: we rewrite each _PROGRAMS primary to include
7852         # EXEEXT.
7853         append_exeext ($one_name)
7854           if $primary eq 'PROGRAMS';
7855
7856         # "EXTRA" shouldn't be used when generating clean targets,
7857         # all, or install targets.  We used to warn if EXTRA_FOO was
7858         # defined uselessly, but this was annoying.
7859         next
7860           if $nodir_name eq 'EXTRA';
7861
7862         if ($nodir_name eq 'check')
7863           {
7864             push (@check, '$(' . $one_name . ')');
7865           }
7866         else
7867           {
7868             push (@used, '$(' . $one_name . ')');
7869           }
7870
7871         # Is this to be installed?
7872         my $install_p = $nodir_name ne 'noinst' && $nodir_name ne 'check';
7873
7874         # If so, with install-exec? (or install-data?).
7875         my $exec_p = ($nodir_name =~ /$EXEC_DIR_PATTERN/o);
7876
7877         # Singular form of $PRIMARY.
7878         (my $one_primary = $primary) =~ s/S$//;
7879         $output_rules .= &file_contents ($file,
7880                                          ('FIRST' => $first,
7881
7882                                           'PRIMARY'     => $primary,
7883                                           'ONE_PRIMARY' => $one_primary,
7884                                           'DIR'         => $X,
7885                                           'NDIR'        => $nodir_name,
7886                                           'BASE'        => $strip_subdir,
7887
7888                                           'EXEC'    => $exec_p,
7889                                           'INSTALL' => $install_p,
7890                                           'DIST'    => $dist_p));
7891
7892         $first = 0;
7893     }
7894
7895     # The JAVA variable is used as the name of the Java interpreter.
7896     # The PYTHON variable is used as the name of the Python interpreter.
7897     if (@used && $primary ne 'JAVA' && $primary ne 'PYTHON')
7898     {
7899         # Define it.
7900         define_pretty_variable ($primary, '', @used);
7901         $output_vars .= "\n";
7902     }
7903
7904     if ($require_extra && ! variable_defined ('EXTRA_' . $primary))
7905     {
7906         macro_error ($require_extra,
7907                      "`$require_extra' contains configure substitution, but `EXTRA_$primary' not defined");
7908     }
7909
7910     # Push here because PRIMARY might be configure time determined.
7911     push (@all, '$(' . $primary . ')')
7912         if @used && $primary ne 'JAVA' && $primary ne 'PYTHON';
7913
7914     # Make the result unique.  This lets the user use conditionals in
7915     # a natural way, but still lets us program lazily -- we don't have
7916     # to worry about handling a particular object more than once.
7917     return uniq (sort @result);
7918 }
7919
7920
7921 ################################################################
7922
7923 # Each key in this hash is the name of a directory holding a
7924 # Makefile.in.  These variables are local to `is_make_dir'.
7925 my %make_dirs = ();
7926 my $make_dirs_set = 0;
7927
7928 sub is_make_dir
7929 {
7930     my ($dir) = @_;
7931     if (! $make_dirs_set)
7932     {
7933         foreach my $iter (@configure_input_files)
7934         {
7935             $make_dirs{dirname ($iter)} = 1;
7936         }
7937         # We also want to notice Makefile.in's.
7938         foreach my $iter (@other_input_files)
7939         {
7940             if ($iter =~ /Makefile\.in$/)
7941             {
7942                 $make_dirs{dirname ($iter)} = 1;
7943             }
7944         }
7945         $make_dirs_set = 1;
7946     }
7947     return defined $make_dirs{$dir};
7948 }
7949
7950 ################################################################
7951
7952 # This variable is local to the "require file" set of functions.
7953 my @require_file_paths = ();
7954
7955 # If a file name appears as a key in this hash, then it has already
7956 # been checked for.  This variable is local to the "require file"
7957 # functions.
7958 %require_file_found = ();
7959
7960
7961 # &maybe_push_required_file ($DIR, $FILE, $FULLFILE)
7962 # --------------------------------------------------
7963 # See if we want to push this file onto dist_common.  This function
7964 # encodes the rules for deciding when to do so.
7965 sub maybe_push_required_file
7966 {
7967     my ($dir, $file, $fullfile) = @_;
7968
7969     if ($dir eq $relative_dir)
7970     {
7971         push_dist_common ($file);
7972         return 1;
7973     }
7974     elsif ($relative_dir eq '.' && ! &is_make_dir ($dir))
7975     {
7976         # If we are doing the topmost directory, and the file is in a
7977         # subdir which does not have a Makefile, then we distribute it
7978         # here.
7979         push_dist_common ($fullfile);
7980         return 1;
7981     }
7982     return 0;
7983 }
7984
7985
7986 # &require_file_internal ($WHERE, $MYSTRICT, @FILES)
7987 # --------------------------------------------------
7988 # Verify that the file must exist in the current directory.
7989 # $MYSTRICT is the strictness level at which this file becomes required.
7990 #
7991 # Must set require_file_paths before calling this function.
7992 # require_file_paths is set to hold a single directory (the one in
7993 # which the first file was found) before return.
7994 sub require_file_internal ($$@)
7995 {
7996     my ($where, $mystrict, @files) = @_;
7997
7998     foreach my $file (@files)
7999     {
8000         my $fullfile;
8001         my $errdir;
8002         my $errfile;
8003         my $save_dir;
8004
8005         my $found_it = 0;
8006         my $dangling_sym = 0;
8007         foreach my $dir (@require_file_paths)
8008         {
8009             $fullfile = $dir . "/" . $file;
8010             $errdir = $dir unless $errdir;
8011
8012             # Use different name for "error filename".  Otherwise on
8013             # an error the bad file will be reported as eg
8014             # `../../install-sh' when using the default
8015             # config_aux_path.
8016             $errfile = $errdir . '/' . $file;
8017
8018             if (-l $fullfile && ! -f $fullfile)
8019             {
8020                 $dangling_sym = 1;
8021                 last;
8022             }
8023             elsif (-f $fullfile)
8024             {
8025                 $found_it = 1;
8026                 maybe_push_required_file ($dir, $file, $fullfile);
8027                 $save_dir = $dir;
8028                 last;
8029             }
8030         }
8031
8032         # `--force-missing' only has an effect if `--add-missing' is
8033         # specified.
8034         if ($found_it && (! $add_missing || ! $force_missing))
8035         {
8036             # Prune the path list.
8037             @require_file_paths = $save_dir;
8038         }
8039         else
8040         {
8041             # If we've already looked for it, we're done.  You might
8042             # wonder why we don't do this before searching for the
8043             # file.  If we do that, then something like
8044             # AC_OUTPUT(subdir/foo foo) will fail to put foo.in into
8045             # DIST_COMMON.
8046             if (! $found_it)
8047             {
8048                 next if defined $require_file_found{$file};
8049                 $require_file_found{$file} = 1;
8050             }
8051
8052             if ($strictness >= $mystrict)
8053             {
8054                 if ($dangling_sym && $add_missing)
8055                 {
8056                     unlink ($fullfile);
8057                 }
8058
8059                 my $trailer = '';
8060                 my $suppress = 0;
8061
8062                 # Only install missing files according to our desired
8063                 # strictness level.
8064                 my $message = "required file `$errfile' not found";
8065                 if ($add_missing)
8066                 {
8067                     $suppress = 1;
8068
8069                     if (-f ("$libdir/$file"))
8070                     {
8071                         # Install the missing file.  Symlink if we
8072                         # can, copy if we must.  Note: delete the file
8073                         # first, in case it is a dangling symlink.
8074                         $message = "installing `$errfile'";
8075                         # Windows Perl will hang if we try to delete a
8076                         # file that doesn't exist.
8077                         unlink ($errfile) if -f $errfile;
8078                         if ($symlink_exists && ! $copy_missing)
8079                         {
8080                             if (! symlink ("$libdir/$file", $errfile))
8081                             {
8082                                 $suppress = 0;
8083                                 $trailer = "; error while making link: $!";
8084                             }
8085                         }
8086                         elsif (system ('cp', "$libdir/$file", $errfile))
8087                         {
8088                             $suppress = 0;
8089                             $trailer = "\n    error while copying";
8090                         }
8091                     }
8092
8093                     if (! maybe_push_required_file (dirname ($errfile),
8094                                                     $file, $errfile))
8095                     {
8096                         if (! $found_it)
8097                         {
8098                             # We have added the file but could not push it
8099                             # into DIST_COMMON (probably because this is
8100                             # an auxiliary file and we are not processing
8101                             # the top level Makefile). This is unfortunate,
8102                             # since it means we are using a file which is not
8103                             # distributed!
8104
8105                             # Get Automake to be run again: on the second
8106                             # run the file will be found, and pushed into
8107                             # the toplevel DIST_COMMON automatically.
8108                             $automake_needs_to_reprocess_all_files = 1;
8109                         }
8110                     }
8111
8112                     # Prune the path list.
8113                     @require_file_paths = &dirname ($errfile);
8114                 }
8115
8116                 # If --force-missing was specified, and we have
8117                 # actually found the file, then do nothing.
8118                 next
8119                     if $found_it && $force_missing;
8120
8121                 if ($suppress)
8122                 {
8123                   file_warning ($where, "$message$trailer");
8124                 }
8125                 else
8126                 {
8127                   file_error ($where, "$message$trailer");
8128                 }
8129             }
8130         }
8131     }
8132 }
8133
8134 # &require_file ($WHERE, $MYSTRICT, @FILES)
8135 # -----------------------------------------
8136 sub require_file ($$@)
8137 {
8138     my ($where, $mystrict, @files) = @_;
8139     @require_file_paths = $relative_dir;
8140     require_file_internal ($where, $mystrict, @files);
8141 }
8142
8143 # &require_file_with_macro ($MACRO, $MYSTRICT, @FILES)
8144 # ----------------------------------------------------
8145 sub require_file_with_macro ($$@)
8146 {
8147     my ($macro, $mystrict, @files) = @_;
8148     require_file ($var_location{$macro}, $mystrict, @files);
8149 }
8150
8151
8152 # &require_conf_file ($WHERE, $MYSTRICT, @FILES)
8153 # ----------------------------------------------
8154 # Looks in configuration path, as specified by AC_CONFIG_AUX_DIR.
8155 sub require_conf_file ($$@)
8156 {
8157     my ($where, $mystrict, @files) = @_;
8158     @require_file_paths = @config_aux_path;
8159     require_file_internal ($where, $mystrict, @files);
8160     my $dir = $require_file_paths[0];
8161     @config_aux_path = @require_file_paths;
8162      # Avoid unsightly '/.'s.
8163     $config_aux_dir = '$(top_srcdir)' . ($dir eq '.' ? "" : "/$dir");
8164 }
8165
8166
8167 # &require_conf_file_with_macro ($MACRO, $MYSTRICT, @FILES)
8168 # ---------------------------------------------------------
8169 sub require_conf_file_with_macro ($$@)
8170 {
8171     my ($macro, $mystrict, @files) = @_;
8172     require_conf_file ($var_location{$macro}, $mystrict, @files);
8173 }
8174
8175 ################################################################
8176
8177 # &require_build_directory ($DIRECTORY)
8178 # ------------------------------------
8179 # Emit rules to create $DIRECTORY if needed, and return
8180 # the file that any target requiring this directory should be made
8181 # dependent upon.
8182 sub require_build_directory ($)
8183 {
8184     my $directory = shift;
8185     my $dirstamp = "$directory/.dirstamp";
8186
8187     # Don't emit the rule twice.
8188     if (! defined $directory_map{$directory})
8189     {
8190         $directory_map{$directory} = 1;
8191
8192         # Directory must be removed by `make distclean'.
8193         $compile_clean_files{$dirstamp} = DIST_CLEAN;
8194
8195         $output_rules .= ("$dirstamp:\n"
8196                           . "\t\@\$(mkinstalldirs) $directory\n"
8197                           . "\t\@: > $dirstamp\n");
8198     }
8199
8200     return $dirstamp;
8201 }
8202
8203 # &require_build_directory_maybe ($FILE)
8204 # --------------------------------------
8205 # If $FILE lies in a subdirectory, emit a rule to create this
8206 # directory and return the file that $FILE should be made
8207 # dependent upon.  Otherwise, just return the empty string.
8208 sub require_build_directory_maybe ($)
8209 {
8210     my $file = shift;
8211     my $directory = dirname ($file);
8212
8213     if ($directory ne '.')
8214     {
8215         return require_build_directory ($directory);
8216     }
8217     else
8218     {
8219         return '';
8220     }
8221 }
8222
8223 ################################################################
8224
8225 # Push a list of files onto dist_common.
8226 sub push_dist_common
8227 {
8228     prog_error ("push_dist_common run after handle_dist")
8229         if $handle_dist_run;
8230     macro_define ('DIST_COMMON', 1, '+', '', "@_", '');
8231 }
8232
8233
8234 # Set strictness.
8235 sub set_strictness
8236 {
8237     $strictness_name = $_[0];
8238     if ($strictness_name eq 'gnu')
8239     {
8240         $strictness = GNU;
8241     }
8242     elsif ($strictness_name eq 'gnits')
8243     {
8244         $strictness = GNITS;
8245     }
8246     elsif ($strictness_name eq 'foreign')
8247     {
8248         $strictness = FOREIGN;
8249     }
8250     else
8251     {
8252         die "$me: level `$strictness_name' not recognized\n";
8253     }
8254 }
8255
8256
8257 ################################################################
8258
8259 # Ensure a file exists.
8260 sub create
8261 {
8262     use IO::File;
8263     my ($file) = @_;
8264
8265     my $touch = new IO::File (">> $file");
8266     $touch->close;
8267 }
8268
8269
8270 # Glob something.  Do this to avoid indentation screwups everywhere we
8271 # want to glob.  Gross!
8272 sub my_glob
8273 {
8274     my ($pat) = @_;
8275     return <${pat}>;
8276 }
8277
8278 # Remove one level of brackets and strip leading spaces,
8279 # as does m4 to function arguments.
8280 sub unquote_m4_arg
8281 {
8282     $_ = shift;
8283     s/^\s*//;
8284
8285     my @letters = split //;
8286     my @result = ();
8287     my $depth = 0;
8288
8289     foreach (@letters)
8290     {
8291         if ($_ eq '[')
8292         {
8293             ++$depth;
8294             next if $depth == 1;
8295         }
8296         elsif ($_ eq ']')
8297         {
8298             --$depth;
8299             next if $depth == 0;
8300             # don't count orphan right brackets
8301             $depth = 0 if $depth < 0;
8302         }
8303         push @result, $_;
8304     }
8305     return join '', @result;
8306 }
8307
8308 ################################################################
8309
8310 # print_error ($LEADER, @ARGS)
8311 # ----------------------------
8312 # Do the work of printing the error message.  Join @ARGS with spaces,
8313 # then split at newlines and add $LEADER to each line.  Uses `warn' to
8314 # print message.  Set exit status.
8315 sub print_error
8316 {
8317     my ($leader, @args) = @_;
8318     my $text = "@args";
8319     @args = split ("\n", $text);
8320     $text = $leader . join ("\n" . $leader, @args) . "\n";
8321     warn $text;
8322     $exit_status = 1;
8323 }
8324
8325
8326 # Print an error message and set exit status.
8327 sub am_error (@)
8328 {
8329     print_error ("$me: ${am_file}.am: ", @_);
8330 }
8331
8332
8333 # &file_error ($FILE, @ARGS)
8334 # --------------------------
8335 sub file_error ($@)
8336 {
8337     my ($file, @args) = @_;
8338     print_error ("$file: ", @args);
8339 }
8340
8341
8342 # &macro_error ($MACRO, @ARGS)
8343 # ----------------------------
8344 # Report an error, @ARGS, about $MACRO.
8345 sub macro_error ($@)
8346 {
8347     my ($macro, @args) = @_;
8348     file_error ($var_location{$macro}, @args);
8349 }
8350
8351
8352 # &target_error ($TARGET, @ARGS)
8353 # ------------------------------
8354 # Report an error, @ARGS, about the rule $TARGET.
8355 sub target_error ($@)
8356 {
8357     my ($target, @args) = @_;
8358     file_error ($targets{$target}, @args);
8359 }
8360
8361
8362 # Like am_error, but while scanning configure.ac.
8363 sub conf_error
8364 {
8365     # FIXME: can run in subdirs.
8366     print_error ("$me: $configure_ac: ", @_);
8367 }
8368
8369 # &file_warning ($FILE, @ARGS)
8370 # ----------------------------
8371 # Warning message with line number referring to configure.ac.
8372 # Does not affect exit_status
8373 sub file_warning ($@)
8374 {
8375     my ($file, @args) = @_;
8376
8377     my $saved_exit_status = $exit_status;
8378     my $sig = $SIG{'__WARN__'};
8379     $SIG{'__WARN__'} = 'DEFAULT';
8380     file_error ($file, @args);
8381     $exit_status = $saved_exit_status;
8382     $SIG{'__WARN__'} = $sig;
8383 }
8384
8385 # Tell user where our aclocal.m4 is, but only once.
8386 sub keyed_aclocal_warning ($)
8387 {
8388     my ($key) = @_;
8389     warn "$me: macro `$key' can be generated by `aclocal'\n";
8390 }
8391
8392 # Print usage information.
8393 sub usage ()
8394 {
8395     print <<EOF;
8396 Usage: $0 [OPTION] ... [Makefile]...
8397
8398 Generate Makefile.in for configure from Makefile.am.
8399
8400 Operation modes:
8401       --help             print this help, then exit
8402       --version          print version number, then exit
8403   -v, --verbose          verbosely list files processed
8404       --no-force         only update Makefile.in's that are out of date
8405
8406 Dependency tracking:
8407   -i, --ignore-deps      disable dependency tracking code
8408       --include-deps     enable dependency tracking code
8409
8410 Flavors:
8411       --cygnus           assume program is part of Cygnus-style tree
8412       --foreign          set strictness to foreign
8413       --gnits            set strictness to gnits
8414       --gnu              set strictness to gnu
8415
8416 Library files:
8417   -a, --add-missing      add missing standard files to package
8418       --libdir=DIR       directory storing library files
8419   -c, --copy             with -a, copy missing files (default is symlink)
8420   -f, --force-missing    force update of standard files
8421 EOF
8422
8423     my ($last, @lcomm);
8424     $last = '';
8425     foreach my $iter (sort ((@common_files, @common_sometimes)))
8426     {
8427         push (@lcomm, $iter) unless $iter eq $last;
8428         $last = $iter;
8429     }
8430
8431     my @four;
8432     print "\nFiles which are automatically distributed, if found:\n";
8433     format USAGE_FORMAT =
8434   @<<<<<<<<<<<<<<<<   @<<<<<<<<<<<<<<<<   @<<<<<<<<<<<<<<<<   @<<<<<<<<<<<<<<<<
8435   $four[0],           $four[1],           $four[2],           $four[3]
8436 .
8437     $~ = "USAGE_FORMAT";
8438
8439     my $cols = 4;
8440     my $rows = int(@lcomm / $cols);
8441     my $rest = @lcomm % $cols;
8442
8443     if ($rest)
8444     {
8445         $rows++;
8446     }
8447     else
8448     {
8449         $rest = $cols;
8450     }
8451
8452     for (my $y = 0; $y < $rows; $y++)
8453     {
8454         @four = ("", "", "", "");
8455         for (my $x = 0; $x < $cols; $x++)
8456         {
8457             last if $y + 1 == $rows && $x == $rest;
8458
8459             my $idx = (($x > $rest)
8460                        ?  ($rows * $rest + ($rows - 1) * ($x - $rest))
8461                        : ($rows * $x));
8462
8463             $idx += $y;
8464             $four[$x] = $lcomm[$idx];
8465         }
8466         write;
8467     }
8468
8469     print "\nReport bugs to <bug-automake\@gnu.org>.\n";
8470
8471     exit 0;
8472 }
8473
8474
8475 # &version ()
8476 # -----------
8477 # Print version information
8478 sub version ()
8479 {
8480   print <<EOF;
8481 automake (GNU $PACKAGE) $VERSION
8482 Written by Tom Tromey <tromey\@redhat.com>.
8483
8484 Copyright 2002 Free Software Foundation, Inc.
8485 This is free software; see the source for copying conditions.  There is NO
8486 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
8487 EOF
8488   exit 0;
8489 }