Configure.pl

   1 #! perl
   2
   3 # Copyright (C) 2001-2008, The Perl Foundation.
   4 # $Id$
   5
   6 use 5.008;
   7 use strict;
   8 use warnings;
   9 use lib 'lib';
  10
  11 use Parrot::Configure;
  12 use Parrot::Configure::Options qw( process_options );
  13 use Parrot::Configure::Options::Test;
  14 use Parrot::Configure::Options::Test::Prepare qw(
  15     get_preconfiguration_tests
  16     get_postconfiguration_tests
  17 );
  18 use Parrot::Configure::Messages qw(
  19     print_introduction
  20     print_conclusion
  21 );
  22 use Parrot::Configure::Step::List qw( get_steps_list );
  23 use Parrot::Revision;
  24
  25 $| = 1;    # $OUTPUT_AUTOFLUSH = 1;
  26
  27 # Install Option text was taken from:
  28 #
  29 # autoconf (GNU Autoconf) 2.59
  30 # Written by David J. MacKenzie and Akim Demaille.
  31 #
  32 # Copyright (C) 2003 Free Software Foundation, Inc.
  33 # This is free software; see the source for copying conditions.  There is NO
  34 # warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  35
  36 # from Parrot::Configure::Options
  37 my $args = process_options(
  38     {
  39         mode => 'configure',
  40         argv => [@ARGV],
  41     }
  42 );
  43 exit(1) unless defined $args;
  44
  45 my $opttest = Parrot::Configure::Options::Test->new($args);
  46
  47 # configuration tests will only be run if you requested them
  48 # as command-line option
  49 $opttest->run_configure_tests( get_preconfiguration_tests() );
  50
  51 my $parrot_version = $Parrot::Configure::Options::Conf::parrot_version;
  52
  53 # from Parrot::Configure::Messages
  54 print_introduction($parrot_version);
  55
  56 # Update revision number if needed
  57 Parrot::Revision::update();
  58
  59 my $conf = Parrot::Configure->new();
  60
  61 # from Parrot::Configure::Step::List
  62 $conf->add_steps( get_steps_list() );
  63
  64 # from Parrot::Configure::Data
  65 $conf->options->set( %{$args} );
  66
  67 # Log files created by Configure.pl in MANIFEST.configure.generated
  68 $conf->{active_configuration} = 1;
  69
  70 # Run the actual steps from Parrot::Configure
  71 $conf->runsteps or exit(1);
  72
  73 # build tests will only be run if you requested them
  74 # as command-line option
  75 $opttest->run_build_tests( get_postconfiguration_tests() );
  76
  77 my $make = $conf->data->get('make');
  78 # from Parrot::Configure::Messages
  79 ( print_conclusion( $conf, $make ) ) ? exit 0 : exit 1;
  80
  81 ################### DOCUMENTATION ###################
  82
  83 =head1 NAME
  84
  85 Configure.pl - Parrot's Configuration Script
  86
  87 =head1 SYNOPSIS
  88
  89     % perl Configure.pl [options]
  90
  91 =head1 DESCRIPTION
  92
  93 This is Parrot's configuration program. It should be run to create
  94 the necessary system-specific files before building Parrot.
  95
  96 =head2 Command-line Options
  97
  98 General Options
  99
 100 =over
 101
 102 =item C<--help>
 103
 104 Prints out a description of the options and exits.
 105
 106 =item C<--version>
 107
 108 Prints out the version number of Configure.pl and exits.
 109
 110 =item C<--verbose>
 111
 112 Tells Configure.pl to output extra information about the configuration data it
 113 is setting.
 114
 115 =item C<--verbose=2>
 116
 117 Tells Configure.pl to output information about i<every> setting added or
 118 changed.
 119
 120 =item C<--verbose-step={N|regex}>
 121
 122 Run C<--verbose=2> for step number C<N> or matching description.
 123
 124 =item C<--fatal>
 125
 126 Tells Configure.pl to halt completely if any configuration step fails.
 127
 128 =item C<--fatal-step={init::alpha,inter::beta,auto::gamma}>
 129
 130 Tells Configure.pl to halt completely if any configuration step in
 131 comma-delimited string individually fails.
 132
 133 =item C<--nomanicheck>
 134
 135 Tells Configure.pl not to run the MANIFEST check.
 136
 137 =item C<--prefix>
 138
 139 Sets the location where parrot will be installed.
 140
 141 =item C<--languages="list of languages">
 142
 143 Specify a list of languages to process (space separated.)
 144 Used in combination with C<--step=gen::languages> to regenerate makefiles.
 145
 146 =item C<--ask>
 147
 148 This turns on the user prompts.
 149
 150 =item C<--test>
 151
 152 Run certain tests along with F<Configure.pl>:
 153
 154 =over 4
 155
 156 =item C<--test=configure>
 157
 158 Run tests found in F<t/configure/> I<before> beginning configuration.  These
 159 tests demonstrate that Parrot's configuration tools will work properly once
 160 configuration has begun.
 161
 162 =item C<--test=build>
 163
 164 Run tests found in F<t/postconfigure/>, F<t/tools/pmc2cutils/>,
 165 F<t/tools/ops2cutils/> and F<t/tools/ops2pmutils/> I<after> configuration has
 166 completed.  These tests demonstrate (a) that certain of Parrot's configuration
 167 tools are working properly post-configuration; and (b) that certain of
 168 Parrot's build tools will work properly once you call F<make>.
 169
 170 =item C<--test>
 171
 172 Run the tests described in C<--test=configure>, conduct configuration, then
 173 run the tests described in C<--test=build>.
 174
 175 =back
 176
 177 =back
 178
 179 Compile Options
 180
 181 =over
 182
 183 =item C<--debugging=0>
 184
 185 Debugging is turned on by default. Use this to disable it.
 186
 187 =item C<--parrot_is_shared>
 188
 189 Link parrot dynamically.
 190
 191 =item C<--m=32>
 192
 193 Create a 32-bit executable on 64-architectures like x86_64. This
 194 option appends -m32 to compiler and linker programs and does
 195 s/lib64/lib/g on link flags.
 196
 197 This option is experimental. See F<config/init/defaults.pm> for more.
 198
 199 =item C<--profile>
 200
 201 Turn on profiled compile (gcc only for now)
 202
 203 =item C<--cage>
 204
 205 [CAGE] compile includes many additional warnings
 206
 207 =item C<--optimize>
 208
 209 Add perl5's $Config{optimize} to the compiler flags.
 210
 211 =item C<--optimize=flags>
 212
 213 Add C<flags> to the compiler flags.
 214
 215 =item C<--inline>
 216
 217 Tell Configure that the compiler supports C<inline>.
 218
 219 =item C<--cc=(compiler)>
 220
 221 Specify which compiler to use.
 222
 223 =item C<--ccflags=(flags)>
 224
 225 Use the given compiler flags.
 226
 227 =item C<--ccwarn=(flags)>
 228
 229 Use the given compiler warning flags.
 230
 231 =item C<--cxx=(compiler)>
 232
 233 Specify which C++ compiler to use (for ICU).
 234
 235 =item C<--libs=(libs)>
 236
 237 Use the given libraries.
 238
 239 =item C<--link=(linker)>
 240
 241 Specify which linker to use.
 242
 243 =item C<--linkflags=(flags)>
 244
 245 Use the given linker flags
 246
 247 =item C<--ld=(linker)>
 248
 249 Specify which loader to use for shared libraries.
 250
 251 =item C<--ldflags=(flags)>
 252
 253 Use the given loader flags for shared libraries
 254
 255 =item C<--lex=(lexer)>
 256
 257 Specify which lexer to use.
 258
 259 =item C<--yacc=(parser)>
 260
 261 Specify which parser to use.
 262
 263 =item C<--define=val1[,val2]>
 264
 265 Generate "#define PARROT_DEF_VAL1 1" ... entries in has_header.h. Currently
 266 needed to use inet_aton for systems that lack inet_pton:
 267
 268   --define=inet_aton
 269
 270 =back
 271
 272 Parrot Options
 273
 274 =over
 275
 276 =item C<--intval=(type)>
 277
 278 Use the given type for C<INTVAL>.
 279
 280 =item C<--floatval=(type)>
 281
 282 Use the given type for C<FLOATVAL>.
 283
 284 =item C<--opcode=(type)>
 285
 286 Use the given type for opcodes.
 287
 288 =item C<--ops=(files)>
 289
 290 Use the given ops files.
 291
 292 =item C<--pmc=(files)>
 293
 294 Use the given PMC files.
 295
 296 =item C<--cgoto=0>
 297
 298 Don't build cgoto core. This is recommended when you are short of memory.
 299
 300 =item C<--jitcapable>
 301
 302 Use JIT system.
 303
 304 =item C<--execcapable>
 305
 306 Use JIT to emit a native executable.
 307
 308 =item C<--gc=(type)>
 309
 310 Determine the type of garbage collection. The value for C<type> should be one
 311 of: C<gc>, C<libc>, C<malloc> or C<malloc-trace>. The default is C<gc>.
 312
 313 =back
 314
 315 International Components For Unicode (ICU) Options
 316
 317 =over
 318
 319 =item C<--icu-config=/path/to/icu-config>
 320
 321 Use the specified icu-config script to determine the necessary ICU options.
 322
 323 Use --icu-config=none to disable the autodetect feature. Parrot will then be
 324 build without ICU.
 325
 326 B<Note:> If you specify another ICU option than --icu-config, the autodetection
 327 functionality will be disabled.
 328
 329 =item C<--icushared=(linkeroption)>
 330
 331 Linker command to link against ICU library.
 332
 333 E.g.
 334
 335    --icushared='-L /opt/openoffice/program -licudata -licuuc'
 336
 337 (The libs in openoffice are actually version 2.2 and do not work)
 338
 339 =item C<--icuheaders=(header_dir)>
 340
 341 Location of ICU header files without the /unicode suffix.
 342
 343 E.g.
 344
 345 --icuheaders='/home/lt/icu/'
 346
 347 =back
 348
 349 Other Options
 350
 351 =over
 352
 353 =item C<--maintainer>
 354
 355 Use this option if you want imcc's parser and lexer files to be generated.
 356 Needs a working parser and lexer.
 357
 358 =item C<--miniparrot>
 359
 360 Build parrot assuming only pure ANSI C is available.
 361
 362 =back
 363
 364 =head1 SEE ALSO
 365
 366 F<config/init/data.pl>, F<lib/Parrot/Configure/RunSteps.pm>,
 367 F<lib/Parrot/Configure/Step.pm>, F<docs/configuration.pod>
 368
 369 =cut
 370
 371 # Local Variables:
 372 #   mode: cperl
 373 #   cperl-indent-level: 4
 374 #   fill-column: 100
 375 # End:
 376 # vim: expandtab shiftwidth=4:
 377