wx-config.in

   1 #!/bin/sh
   2 #
   3 # Name:        wx-config{.in,}
   4 # Purpose:     wx configuration search and query tool {template,}
   5 # Author:      Ron <ron@debian.org>
   6 # Modified by:
   7 # Created:     8/9/2004
   8 # RCS-ID:      $Id$
   9 # Copyright:   (c) 2004 Ron <ron@debian.org>
  10 #              Essentially a fresh start this time around, but for maximum
  11 #              compatibility basic code was taken from, and heavy reference
  12 #              made to, the previously unattributed wx-config from cvs.
  13 #              All the usual suspects contributed to the dicussion that led
  14 #              to this new work and likewise to the ideas and content in the
  15 #              original (which was probably influenced by gtk), among them:
  16 #              Robert Roebling, Vadim Zeitlin, Vaclav Slavik, Robin Dunn
  17 # Licence:     wxWindows licence
  18 ############################################################################
  19
  20
  21 # Start with some basic stuff, like the ability to die gracefully,
  22 # and to tell people what we are about.
  23 # ------------------------------------------------------------------
  24
  25 # decho _message
  26 # Output a message to stderr.
  27 decho() { echo "$*" 1>&2; }
  28
  29 # usage _exitcode
  30 # Outputs a usage message to stderr and exits with _exitcode.
  31 # Try to keep this to a single page.  We can add alternate help
  32 # targets if people want more detail from interactive help.
  33 usage()
  34 {
  35     cat 1>&2 <<EOF
  36
  37  wx-config [--prefix[=DIR]] [--exec-prefix[=DIR]] [--release] [--version-full]
  38            [--list] [--host=HOST] [--toolkit=TOOLKIT] [--universal[=yes|no]]
  39            [--unicode[=yes|no]] [--debug[=yes|no]] [--static[=yes|no]]
  40            [--version[=VERSION]] [--basename] [--cppflags] [--cflags]
  41            [--cxxflags] [--rezflags] [--libs] [--cc] [--cxx] [--ld] [LIB ...]
  42
  43    wx-config returns  information about  the wxWidgets libraries available
  44    on your system.  It may be used to retrieve the information you require
  45    to build applications using these libraries.
  46
  47     If alternative builds of wxWidgets exist on the system, you can use the
  48   options:  --prefix,  --host,  --toolkit,  --unicode,  --debug,  --static,
  49   --version and --universal, to select from them.  Use the --list option to
  50   show alternatives available which match specified criteria.   The unicode,
  51   debug, and universal options  take an  optional yes or no  argument, while
  52   host and version accept posix extended regex.
  53
  54     Optional LIB arguments (comma or space separated) may be used to specify
  55   the wxWidgets libraries that  you wish  to use.  The magic "std" label may
  56   be used to import all libraries that would be used by default if none were
  57   specified explicitly.  eg. wx-config --libs core,base.
  58
  59 EOF
  60
  61     exit $1
  62 }
  63
  64 # Unfussy people are the easiest to deal with, get them out of the way now.
  65 [ $# -gt 0 ] || usage 1
  66
  67
  68
  69 # For the people who know what they want, or think they do:
  70 # Divide the valid arguments into functional groups for later examination,
  71 # then parse all command line arguments completely, deferring action on
  72 # output options until all significant input has been processed and any
  73 # decision about delegation has been taken.
  74
  75 # Note early, that '-' is a complete no-no for use in option names below.
  76 # It totally falls apart as soon as it becomes part of a variable name.
  77 # Use '_' instead, and by the magic of it all just being bits, you'll
  78 # be able to use --my-option or --my_option from the command line at
  79 # your discretion.  They are synonymous as user input, but _ALWAYS_ use
  80 # underscores for compound names in the code here, never a dash.
  81
  82
  83 # The list of all options we recognise.  If it is not in here, then
  84 # it is not something we want to handle.
  85 # ------------------------------------------------------------------
  86
  87 # Options that specify a distinct library build.
  88 #
  89 # Note also that order in this list is significant later on, as this sets
  90 # the precedence with which we will try to gauge the similarity of other
  91 # configs to this one.  Options earlier in the list should be more crucial
  92 # to match well than those that follow.  Options specified by the user will
  93 # always take precedence and are not subject to any partial ordering here.
  94 wxconfig_schema="host toolkit widgetset chartype debugtype flavour version linkage"
  95
  96 # Options that are expected to generate some output.
  97 wxconfig_output_options="prefix exec_prefix                     \
  98                          list                                   \
  99                          release version version_full           \
 100                          basename                               \
 101                          cppflags cflags cxxflags               \
 102                          rezflags                               \
 103                          libs                                   \
 104                          cc cxx ld                              \
 105                          gl_libs"
 106
 107 # Options that permit the user to supply hints that may affect the output.
 108 # These options all accept arbitrary values, to interpret as they please.
 109 wxconfig_input_options="prefix exec_prefix $wxconfig_schema"
 110
 111 # Input options that accept only a yes or no argument.
 112 wxconfig_yesno_options="universal unicode debug static"
 113
 114 # Boolean options that do something or not.
 115 wxconfig_flag_options="$wxconfig_yesno_options inplace"
 116
 117
 118
 119 # Some simple sugar coating to keep things more readable below.
 120 # --------------------------------------------------------------
 121
 122 # option_name _string
 123 # Returns NAME if _string is of the form: --NAME[=...]
 124 option_name()
 125 {
 126     _option_name_temp=${1%%=*}
 127     echo "${_option_name_temp#--}" | tr '-' '_'
 128 }
 129
 130 # option_value _string
 131 # Returns FOO if _string is of the form: --option=FOO
 132 option_value()
 133 {
 134     echo "${1#*=}"
 135 }
 136
 137 # match_field _value _list
 138 # Returns true if _value is a field in _list
 139 match_field()
 140 {
 141     _match_field_match="$1"
 142     shift
 143     for _match_field_i; do
 144         [ "x$_match_field_i" != "x$_match_field_match" ] || return 0
 145     done
 146     false
 147 }
 148
 149 # remove_field _value _list
 150 # Returns _list minus any field(s) that match _value.
 151 remove_field()
 152 {
 153     _remf_value="$1"
 154     _remf_list=''
 155     shift
 156     if [ -n "$_remf_value" ]; then
 157         for _remf_item; do
 158             [ "x$_remf_item" = "x$_remf_value" ] ||                 \
 159                 _remf_list="${_remf_list:+$_remf_list }$_remf_item"
 160         done
 161         echo "$_remf_list"
 162     else
 163         echo $*
 164     fi
 165 }
 166
 167 # validate_arg _domain _set _name _value
 168 # Boilerplate to validate an argument and initialise a psuedo-hash.
 169 # This one is almost reduction into absurdity, and perhaps makes the
 170 # precise action of the argument parser below just a little more
 171 # obscure, but oh so neat and compact to use for multiple option
 172 # groups.  It expands to replace repetitive clauses of the form:
 173 #
 174 #        i="$(option_name $arg)"
 175 #        if match_field "$i" $wxconfig_input_options; then
 176 #            input_options="${input_options:+$input_options }$i"
 177 #            eval "input_option_$i=$(option_value $arg)"
 178 #            continue
 179 #        fi
 180 #
 181 # with the one liners you see on the page below.
 182 validate_arg()
 183 {
 184     if match_field "$3" $(eval echo \"\$$1_$2_options\"); then
 185         eval "$2_options=\"\${$2_options:+\$$2_options }$3\""
 186         eval "$2_option_$3=\"$4\""
 187         return
 188     fi
 189     false
 190 }
 191
 192 # check_yesno_option _ynoption _option _yesval _noval
 193 # This one might be made more generic and/or incorporated into
 194 # validate_arg above at some later stage, but right now we just
 195 # condition any specialist options into a generic one for later
 196 # handling.  Once they are sanity checked there is no difference
 197 # in any case.
 198 check_yesno_option()
 199 {
 200     eval "case \${yesno_option_$1-\${flag_option_$1-unset}} in              \
 201             unset)                          ;;                              \
 202             y*|Y*)  input_option_$2=\"$3\"  ;;                              \
 203             n*|N*)  input_option_$2=\"$4\"  ;;                              \
 204             *)                                                              \
 205                 decho;                                                      \
 206                 decho \" *** Error: Invalid request '--$1=\$yesno_option_$1'\"; \
 207                 decho \" Valid arguments for --$1 are: [ yes, no ]\";       \
 208                 decho;                                                      \
 209                 exit 1                      ;;                              \
 210          esac"
 211 }
 212
 213
 214
 215 # Now we are ready to find out what the user wants from us.
 216 # --------------------------------------------------------------
 217
 218 # With just a little more complexity here we could have shortest
 219 # unique string matching for options, but that is probably overkill
 220 # today, so lets just get the job done.
 221 #
 222 # The important thing now then is that we simply read all input from
 223 # the user and don't try to act prematurely on partial information.
 224 # --help or an illegal argument are the only shortcuts out of here
 225 # at this point, otherwise, it's time to just shut up and listen for
 226 # a moment.
 227
 228 for arg; do
 229   case "$arg" in
 230     --help|-h)
 231         usage
 232         ;;
 233
 234     --*=*)
 235         _name=$(option_name $arg)
 236         _value=$(option_value $arg)
 237         if validate_arg wxconfig input "$_name" "$_value"       \
 238         || validate_arg wxconfig yesno "$_name" "$_value";      \
 239         then
 240             continue
 241         fi
 242         ;;
 243
 244     --*)
 245         _name=$(option_name $arg)
 246         if validate_arg wxconfig flag   "$_name" yes            \
 247         || validate_arg wxconfig output "$_name" yes;
 248         then
 249             continue
 250         fi
 251         ;;
 252
 253     *)
 254         # FIXME Surely we can validate the parameters too ...
 255         input_parameters="${input_parameters:+$input_parameters }$arg"
 256         continue
 257         ;;
 258   esac
 259   decho "  *** Error: Unrecognised option: '$arg'"
 260   decho "Use wx-config --help for information on command line options."
 261   exit 1
 262 done
 263
 264 # validate_arg only checks and decomposes form.  Sanity check the yes/no
 265 # options now too and push their respective mask values into place.
 266
 267 check_yesno_option universal widgetset univ
 268 check_yesno_option unicode chartype unicode ansi
 269 check_yesno_option debug debugtype debug release
 270 check_yesno_option static linkage '-static'
 271
 272
 273 # Dump everything we just read in debug mode.
 274 if [ -n "$WXDEBUG" ]; then
 275
 276     decho
 277     decho "  input parameters  = $input_parameters"
 278     decho "  input options     = $input_options"
 279     for i in $input_options; do
 280         decho "    $i = $(eval echo \"\$input_option_$i\")"
 281     done
 282     decho "  yes/no options    = $yesno_options"
 283     for y in $yesno_options; do
 284         decho "    $y = $(eval echo \"\$yesno_option_$y\")"
 285     done
 286     decho "  flag options      = $flag_options"
 287     for f in $flag_options; do
 288         decho "    $f = $(eval echo \"\$flag_option_$f\")"
 289     done
 290     decho "  output options    = $output_options"
 291     for o in $output_options; do
 292         decho "    $o = $(eval echo \"\$output_option_$o\")"
 293     done
 294
 295 fi
 296
 297
 298
 299 # Everything came in as a legal argument then, lets put some of
 300 # the pieces together with a little self knowledge to see what
 301 # we should do next.
 302 # --------------------------------------------------------------
 303
 304 # get_mask [ _hash ]
 305 # Construct a config filename mask from a psuedo-hash of component variables.
 306 # The optional argument is the prefix of the hash to use.  If not specified
 307 # this will return a mask derived from the command line options that were used.
 308 get_mask()
 309 {
 310     [ $# -gt 0 ] || set m
 311     eval echo "\${$1_host}\${$1_toolkit}\${$1_widgetset}-\${$1_chartype}-\${$1_debugtype}\${$1_linkage}-\${$1_version}\${$1_flavour}"
 312 }
 313
 314
 315 # Determine the base directories we require.
 316 prefix=${input_option_prefix-${this_prefix:-@prefix@}}
 317 exec_prefix=${input_option_exec_prefix-${input_option_prefix-${this_exec_prefix:-@exec_prefix@}}}
 318 wxconfdir="@libdir@/wx/config"
 319
 320 installed_configs=$( cd "$wxconfdir" 2> /dev/null && ls | grep -v "^inplace-" )
 321
 322 target="@host_alias@"
 323
 324 # Define a pseudo-hash to contain the specification of this wx-config
 325 # instance and its associated library.
 326 this_host="${target:+${target}-}"
 327 this_toolkit="@TOOLKIT_DIR@@TOOLKIT_VERSION@"
 328 this_widgetset="@WIDGET_SET@"
 329 this_chartype="@WX_CHARTYPE@"
 330 this_debugtype="@WX_DEBUGTYPE@"
 331 this_flavour="@WX_FLAVOUR@"
 332 this_version="@WX_RELEASE@"
 333 this_linkage=$( [ @SHARED@ -eq 1 ] || echo '-static' )
 334
 335 this_config=$(get_mask this)
 336
 337 # Extract the user specification from the options parsed.
 338 m_host=${input_option_host:+${input_option_host}-?}
 339 m_host=${m_host:-${input_option_host-$this_host}}
 340 m_toolkit=${input_option_toolkit:-[^-]+}
 341 m_widgetset=${input_option_widgetset-(univ)?}
 342 m_chartype=${input_option_chartype:-(unicode|ansi)}
 343 m_debugtype=${input_option_debugtype:-(debug|release)}
 344 m_flavour=${input_option_flavour:+-$input_option_flavour}
 345 m_flavour=${m_flavour:-${input_option_flavour-(-[^-]+)?}}
 346 m_version=${input_option_version:-[0-9]+\.[0-9]+}
 347 m_linkage=${input_option_linkage-(-static)?}
 348
 349 configmask="^$(get_mask)$"
 350
 351
 352 # Dump the user specification in debug mode.
 353 if [ -n "$WXDEBUG" ]; then
 354
 355     decho
 356     decho "  prefix       = '$prefix'"
 357     decho "  exec_prefix  = '$exec_prefix'"
 358     decho "  wxconfdir    = '$wxconfdir'"
 359
 360     decho "  m_host       = '$m_host'"
 361     decho "  m_toolkit    = '$m_toolkit'"
 362     decho "  m_widgetset  = '$m_widgetset'"
 363     decho "  m_chartype   = '$m_chartype'"
 364     decho "  m_debugtype  = '$m_debugtype'"
 365     decho "  m_flavour    = '$m_flavour'"
 366     decho "  m_version    = '$m_version'"
 367     decho "  m_linkage    = '$m_linkage'"
 368
 369     decho "  configmask   = '$configmask'"
 370     decho "  this config  = '$this_config'"
 371     decho
 372
 373 fi
 374
 375
 376
 377 # From here on, we'll need to be able to figure out a delegation target.
 378 # -----------------------------------------------------------------------
 379
 380 # The rules for delegation are:
 381 #
 382 # 1. If the specification is so general that it matches the default config
 383 #    (ie. this one on a first pass), then the default config will be used
 384 #    even if other installed libs would also match the spec.
 385 #
 386 # 2. If the default config does not match, find a list of all installed
 387 #    libraries that do match.
 388 #       a. If that list is empty, the specification is incompatible
 389 #          with any installed lib.  Warn and abort.
 390 #       b. If that list contains exactly one candidate.  Delegate to
 391 #          that candidate.
 392 #       c. If the list contains multiple candidates, pass on to step 3.
 393 #
 394 # 3. Attempt to discriminate among rival candidates by their similarity
 395 #    to the default configuration (ie. this one).  If we can find a unique
 396 #    candidate in this way, delegate to it.  If not, present a list of
 397 #    options to the user and request that they disambiguate it with one or
 398 #    more additional fields.
 399 #
 400 #    To refine the specified pattern, we specialise each unbound field
 401 #    using the default value from this config file.  If that results in
 402 #    no matches, we unbind it again and try the next field.  If it still
 403 #    results in multiple matches we try binding the next field as well
 404 #    until a unique or null result again occurs.
 405 #
 406 # A more general way to look at this, is the feature specifiers are all
 407 # modifiers of the wx-config you are calling.  If you supply none, the
 408 # default for that build configuration will be used.  If you supply one
 409 # or more that the default build cannot satisfy, it will try to find the
 410 # config most like itself with the desired feature(s) enabled.
 411 # The features configured into the first wx-config called will be taken
 412 # as implicitly specified if it is necessary to disambiguate likely
 413 # candidates from the information that was explicitly provided.
 414
 415
 416 # But first, more sugar to keep what follows clear and legible.
 417 # --------------------------------------------------------------
 418
 419 # find_eligible_delegates _mask
 420 # Outputs all the config files installed which match the
 421 # (extended regex) _mask passed as an argument.
 422 find_eligible_delegates() { echo "$installed_configs" | grep -E "$1" 2> /dev/null; }
 423
 424 # user_mask_fits _config
 425 # Returns true if the string _config satisfies the user specified mask.
 426 user_mask_fits()          { echo "$1" | grep -E "$configmask" > /dev/null 2>&1; }
 427
 428 # count_fields _word
 429 # Returns the number of IFS split fields in _word
 430 count_fields()      { return $#; }
 431
 432 # count_delegates _mask
 433 # Return the number of eligible config files that match _mask
 434 count_delegates()   { count_fields $(find_eligible_delegates $1); }
 435
 436 # is_set _variablename
 437 # Returns true if $_variablename is initialised.
 438 is_set()            { [ "x$(eval echo \"\${$1-unset}\")" != "xunset" ]; }
 439
 440 # do_find_best_delegate _unbound-options
 441 # The real worker part of find_best_delegate below.  Recurses though all
 442 # unbound options binding them one at a time to the default derived from
 443 # this file until a unique match is made or no alternatives remain that
 444 # may be sensibly guessed at.  It will preferentially bind the unspecified
 445 # options in the order they are listed in wxconfig_schema.  Using this
 446 # partial ordering it should find the first match with the most significant
 447 # similarity to this file that unambiguously meets the user specification.
 448 # If such a match exists it will be output to stdout.
 449 #
 450 # Be careful if you modify this function.  If the pruning logic is rendered
 451 # inoperative it will simply recurse over every permutation in the search
 452 # space, which may still appear to work, but add a couple more options (or
 453 # explicitly specify a few less) and you may not live long enough to learn
 454 # the result.  WXDEBUG=findprogress is your friend here, it will show you
 455 # how many nodes get searched before a result.  If you start seeing
 456 # increases in that number for the same input, check your work.
 457 # Raising the number of discriminating options from 6 to 8 raised the worst
 458 # case time for this to run (without pruning) from 3 to nearly 15 seconds
 459 # and its downhill fast from here if we have to ride that boat.
 460 # Early pruning still gets that down to under half a second (up from about
 461 # .25), so we have some breathing space yet before a different search method
 462 # will be called for, but lets not squander it.
 463 do_find_best_delegate()
 464 {
 465   (
 466     if [ "x$WXDEBUG" = "xverbose" ]; then
 467         _fbd_indent="${_fbd_indent}. "
 468         decho "  $_fbd_indent---> unbound options: $*"
 469     fi
 470
 471     for i; do
 472
 473         if [ "x$WXDEBUG" = "xverbose" ]; then
 474             decho "  ${_fbd_indent}binding '$i' with '$(remove_field $i $*)' still free"
 475             [ -z "$_pruned" ] || decho "  ${_fbd_indent}  --- pruned: $_pruned ---"
 476         fi
 477
 478         if (
 479             eval m_$i=\$this_$i
 480             _mask="^$(get_mask)$"
 481
 482             if [ "x$WXDEBUG" = "xverbose" ]; then
 483                 decho "  ${_fbd_indent}  checking: $_mask"
 484                 count_delegates "$_mask"
 485                 decho "  $_fbd_indent  $? eligible delegates"
 486                 for d in $(find_eligible_delegates "$_mask"); do
 487                     decho "  ${_fbd_indent}    $d"
 488                 done
 489             fi
 490
 491             count_delegates "$_mask"
 492             _still_eligible=$?
 493
 494             if [ $_still_eligible -eq 1 ]; then
 495                 echo $(find_eligible_delegates "$_mask")
 496                 return
 497             fi
 498
 499             [ "x$WXDEBUG" != "xfindprogress" ] || printf "." 1>&2
 500
 501             [ $_still_eligible -gt 1 ] && [ $# -gt 1 ] &&       \
 502             do_find_best_delegate $(remove_field $i $*)
 503            );
 504         then
 505
 506             return
 507
 508         elif [ $# -gt 1 ]; then
 509
 510             if [ "x$WXDEBUG" = "xverbose" ]; then
 511                 decho "  ${_fbd_indent}pruning: $i"
 512                 _pruned="${_pruned:+$_pruned }$i"
 513             fi
 514             set $(remove_field $i $*)
 515
 516         fi
 517
 518     done
 519     false
 520   )
 521 }
 522
 523 # find_best_delegate
 524 # A simple wrapper around do_find_best_delegate that first determines
 525 # the unbound options (ie. the ones that the user did not explicitly
 526 # declare a preference for on the command line)
 527 find_best_delegate()
 528 {
 529     for _fbdi in $wxconfig_schema; do
 530         is_set input_option_$_fbdi ||                                       \
 531             _unbound_options="${_unbound_options:+$_unbound_options }$_fbdi"
 532     done
 533     do_find_best_delegate $_unbound_options
 534 }
 535
 536
 537 # Legacy wx-config helpers.
 538 # -------------------------
 539
 540 # get_legacy_mask
 541 # Returns a mask in the format used by wx2.4.
 542 get_legacy_mask()
 543 {
 544     [ $# -gt 0 ] || set m
 545     eval [ "x\${$1_chartype}" != "xunicode" ] || _unicode_flag=u
 546     eval [ "x\${$1_debugtype}" != "xdebug" ] || _debug_flag=d
 547     eval echo "wx\${$1_toolkit}${_unicode_flag}${_debug_flag}-\${$1_version}\${$1_host}-config"
 548 }
 549
 550 # find_legacy_configs
 551 # Returns a list of configs installed by wx2.4 releases.
 552 find_legacy_configs()
 553 {
 554     cd "$prefix/bin" 2> /dev/null &&            \
 555         ls wx*-2.4-config | grep -v ^wxbase;    \
 556         ls wx*-2.4-config | grep ^wxbase
 557 }
 558
 559 # find_best_legacy_config
 560 # Returns the best legacy config for a given specification.
 561 # This assumes no matching new style config has been found.
 562 find_best_legacy_config()
 563 {
 564     _legacy_configs=$(find_legacy_configs)
 565     if [ -n "$_legacy_configs" ]; then
 566         _legacy_mask=$(get_legacy_mask)
 567         for d in $_legacy_configs; do
 568             if echo $d | grep -E $_legacy_mask > /dev/null 2>&1 ; then
 569                 echo "$d"
 570                 return
 571             fi
 572         done
 573     fi
 574     false
 575 }
 576
 577
 578
 579 # The only action we can perform authoritatively prior to delegation
 580 # is to list all the possible delegates.
 581 # --------------------------------------------------------------
 582
 583 config_spec="$0 $*"
 584 [ -z "$WXDEBUG" ] || config_spec=$configmask
 585
 586 # Next chance for another satisfied customer then
 587 #
 588 # If we want to get really polished here we can do plural checking,
 589 # but we should probably leave that until the day we gettextise it.
 590 if [ -n "$output_option_list" ]; then
 591
 592     _remains_in_prefix=$installed_configs
 593     _delegates=$(find_eligible_delegates $configmask)
 594     _best_delegate=$(find_best_delegate)
 595
 596     if [ "x$WXDEBUG" = "xverbose" ]; then
 597         decho
 598         decho " all      = $_remains_in_prefix"
 599         decho " matching = $_delegates"
 600         decho " best     = $_best_delegate"
 601         decho " this     = $this_config"
 602     fi
 603
 604     for d in $_delegates; do
 605         _remains_in_prefix=$(remove_field $d $_remains_in_prefix)
 606     done
 607
 608     echo
 609     echo "    Default config is $this_config"
 610     echo
 611
 612     if user_mask_fits "$this_config" ; then
 613
 614         echo "  Default config ${this_exec_prefix+in $this_exec_prefix }will be used for output"
 615
 616         if match_field "$this_config" $_delegates ; then
 617             _delegates=$(remove_field $this_config $_delegates)
 618         else
 619             echo "  though it is not installed in: $prefix"
 620             if [ -n "$_best_delegate" ] && [ "x$_best_delegate" != "x$this_config" ]; then
 621                 echo
 622                 echo "  Best alternate in $prefix:"
 623                 echo "    $_best_delegate"
 624             fi
 625         fi
 626
 627     elif [ -n "$_best_delegate" ]; then
 628
 629         echo "  Specification best match: $_best_delegate"
 630
 631     elif [ -z "$_delegates" ]; then
 632
 633         _last_chance=$(find_best_legacy_config)
 634         if [ -n "$_last_chance" ]; then
 635
 636             echo "  Specification matches legacy config: $_last_chance"
 637
 638         else
 639
 640             cat <<-EOF
 641           No config found to match: $config_spec
 642           in $wxconfdir
 643
 644           Please install the desired library build, or specify a different
 645           prefix where it may be found.  If the library is not installed
 646           you may call its wx-config directly by specifying its full path.
 647
 648         EOF
 649
 650         fi
 651
 652     else
 653         echo " Specification was ambiguous.  Use additional feature options"
 654         echo " to choose between alternate matches."
 655     fi
 656
 657     _delegates=$(remove_field "$_best_delegate" $_delegates)
 658
 659     if [ -n "$_delegates" ]; then
 660         echo
 661         echo "  Alternate matches:"
 662         for d in $_delegates; do
 663             echo "    $d"
 664         done
 665     fi
 666     if [ -n "$_remains_in_prefix" ]; then
 667         echo
 668         echo "  Also available in $prefix:"
 669         for d in $_remains_in_prefix; do
 670             echo "    $d"
 671         done
 672     fi
 673
 674     _legacy_configs=$(find_legacy_configs)
 675     if [ -n "$_legacy_configs" ]; then
 676         echo
 677         echo "  Legacy configs available in $prefix:"
 678         for d in $_legacy_configs; do
 679             echo "    ${d%-config}"
 680         done
 681     fi
 682
 683     echo
 684     exit
 685 fi
 686
 687
 688
 689 # ... so if that wasn't what they wanted, then we need to know for
 690 # certain, can this config satisfy the user specification?
 691 # --------------------------------------------------------------
 692
 693 if ! user_mask_fits "$this_config" ; then
 694
 695     # No?  Then lets see if it knows anybody who can.
 696     # But first, just be sure someone hasn't typo'd us into a loop.
 697     # In present day wx, correct delegation should never need more
 698     # than one hop so this is trivial to detect.
 699
 700     if [ -n "$WXCONFIG_DELEGATED" ]; then
 701         decho
 702         decho " *** Error: Bad config delegation"
 703         decho
 704         decho " to: $0"
 705         decho " ($this_config) cannot satisfy:"
 706         decho " $config_spec"
 707         decho " Someone has been terribly careless."
 708         decho
 709         exit 1
 710     fi
 711
 712     count_delegates "$configmask"
 713     _numdelegates=$?
 714
 715     if [ -n "$WXDEBUG" ]; then
 716         decho "  must delegate to an alternate config"
 717         decho "  potential delegates ($_numdelegates):"
 718         for i in $(find_eligible_delegates "$configmask"); do
 719             decho "    $i"
 720         done
 721     fi
 722
 723     if [ $_numdelegates -eq 0 ]; then
 724
 725         _last_chance=$(find_best_legacy_config)
 726         if [ -n "$_last_chance" ]; then
 727
 728             if [ -n "$WXDEBUG" ]; then
 729                 decho "  found a suitable legacy delegate: $_last_chance"
 730                 decho "--> $prefix/bin/$_last_chance $*"
 731             fi
 732
 733             export WXCONFIG_DELEGATED=yes
 734             $prefix/bin/$_last_chance $*
 735             exit
 736
 737         else
 738
 739             cat 1>&2 <<-EOF
 740
 741           Warning: No config found to match: $config_spec
 742                    in $wxconfdir
 743           If you require this configuration, please install the desired
 744           library build.  If this is part of an automated configuration
 745           test and no other errors occur, you may safely ignore it.
 746           You may use wx-config --list to see all configs available in
 747           the default prefix.
 748
 749         EOF
 750
 751             # PIPEDREAM:  This will probably give Vadim an aneurysm if I
 752             # mention it out of context, but from here we are actually
 753             # just a teensy step from simply building the missing config
 754             # for the user on the fly if this is an in tree wx-config.
 755
 756             exit 1
 757         fi
 758     fi
 759
 760     if [ $_numdelegates -gt 1 ]; then
 761
 762         [ -z "$WXDEBUG" ] || decho "  must prune the list of eligible delegates"
 763
 764         best_delegate=$(find_best_delegate)
 765
 766         if [ -n "$best_delegate" ]; then
 767
 768             if [ -n "$WXDEBUG" ]; then
 769                 decho "  found a suitable delegate: $best_delegate"
 770                 decho "--> $wxconfdir/$best_delegate $*"
 771             fi
 772
 773             export WXCONFIG_DELEGATED=yes
 774             $wxconfdir/$best_delegate $*
 775             exit
 776         fi
 777
 778         decho
 779         decho " *** Error: Specification is ambiguous"
 780         decho "            as $config_spec"
 781         decho " Use additional feature options to choose between:"
 782         for i in $(find_eligible_delegates "$configmask"); do
 783             decho "  $i"
 784         done
 785         decho
 786
 787         exit 1
 788     fi
 789
 790     if [ -n "$WXDEBUG" ]; then
 791         decho "  using the only suitable delegate"
 792         decho "--> $wxconfdir/$(find_eligible_delegates $configmask) $*"
 793     fi
 794
 795     export WXCONFIG_DELEGATED=yes
 796     $wxconfdir/$(find_eligible_delegates $configmask) $*
 797     exit
 798 fi
 799
 800
 801
 802 # If we are still here, then from now on we are responsible for
 803 # all the user's needs.  Time to rustle up some output for them.
 804 # --------------------------------------------------------------
 805
 806 [ -z "$WXDEBUG" ] || decho "  using this config"
 807
 808 # If the user supplied a prefix, and the in tree config did not
 809 # delegate out to anything in that prefix, then reset the build
 810 # tree prefix to provide the correct output for using this
 811 # uninstalled wx build.  Or put more simply:
 812 prefix=${this_prefix-$prefix}
 813 exec_prefix=${this_exec_prefix-$exec_prefix}
 814
 815 includedir="@includedir@"
 816 libdir="@libdir@"
 817
 818 # Trivial queries we can answer now.
 819 [ -z "$output_option_prefix"       ] || echo $prefix
 820 [ -z "$output_option_exec_prefix"  ] || echo $exec_prefix
 821 [ -z "$output_option_release"      ] || echo "@WX_RELEASE@"
 822 [ -z "$output_option_version"      ] || echo "@WX_VERSION@"
 823 [ -z "$output_option_version_full" ] || echo "@WX_SUBVERSION@"
 824 [ -z "$output_option_basename"     ] || echo "@WX_LIBRARY_BASENAME_GUI@"
 825 [ -z "$output_option_rezflags"     ] || echo $(eval echo @MACRESWXCONFIG@)
 826 [ -z "$output_option_cc"           ] || echo "@CC@"
 827 [ -z "$output_option_cxx"          ] || echo "@CXX@"
 828 [ -z "$output_option_ld"           ] || echo "@EXE_LINKER@"
 829
 830
 831 # The rest are going to need a little more work.
 832 # --------------------------------------------------------------
 833
 834 is_cross()      { [ "x@cross_compiling@" = "xyes" ]; }
 835 is_monolithic() { [ @MONOLITHIC@ -eq 1 ]; }
 836
 837
 838 # Additional configuration for individual library components.
 839 ldflags_gl="@LDFLAGS_GL@"
 840
 841 ldlibs_base="@WXCONFIG_EXTRALIBS@"
 842 ldlibs_core="@EXTRALIBS_GUI@"
 843 ldlibs_gl="@OPENGL_LIBS@"
 844 ldlibs_html="@EXTRALIBS_HTML@"
 845 ldlibs_xml="@EXTRALIBS_XML@"
 846 ldlibs_odbc="@EXTRALIBS_ODBC@"
 847 ldlibs_adv="@EXTRALIBS_SDL@"
 848
 849
 850 # lib_flags_for _liblist
 851 # This function returns a list of flags suitable to return with the
 852 # output of --libs for all of the libraries in _liblist.  You can
 853 # add support for a new library by adding an entry for it in the
 854 # psuedo-hashes above if it requires additional linker options.
 855 lib_flags_for()
 856 {
 857     [ -z "$WXDEBUG" ] || decho "  fetching lib flags for: '$*'"
 858
 859     _all_ldflags=''
 860     _all_libs=''
 861     _wxlibs=''
 862
 863     ! is_cross || _target="-${target}"
 864
 865     for lib; do
 866
 867         # We evidently can't trust people not to duplicate things in
 868         # configure, or to keep them in any sort of sane order overall,
 869         # so only add unique new fields here even if it takes us a while.
 870         # In the case of libs, we bubble any duplicates to the end,
 871         # because if multiple libs require it, static linking at least
 872         # will require it to come after all of them.  So long as local
 873         # order is ok in configure then we should always be able to
 874         # massage a correct result here like this.
 875         #
 876         # FIXME: ldlibs_core is totally bogus.  Fix the duplication
 877         # there independently of this.  This covers for it, but we
 878         # want to do this anyway because some libs may share common
 879         # deps without a common ancestor in wx.  This is not a licence
 880         # for sloppy work elsewhere though and @GUI_TK_LIBRARY should
 881         # be fixed.
 882
 883         for f in $(eval echo \"\$ldflags_$lib\"); do
 884             match_field "$f" $_all_ldflags || _all_ldflags="$_all_ldflags $f"
 885         done
 886
 887         if match_field "$lib" @CORE_BASE_LIBS@ ; then
 888             _libname="@WX_LIBRARY_BASENAME_NOGUI@"
 889         else
 890             _libname="@WX_LIBRARY_BASENAME_GUI@"
 891         fi
 892         [ $lib = base ] || _libname="${_libname}_$lib"
 893         _libname="${_libname}-@WX_RELEASE@$_target"
 894
 895         if [ "x$this_linkage" = "x-static" ]; then
 896             _wxlibs="$_wxlibs ${libdir}/lib${_libname}.a"
 897             for f in $(eval echo \"\$ldlibs_$lib\"); do
 898                 _all_libs="$(remove_field $f $_all_libs) $f"
 899             done
 900         else
 901             _wxlibs="$_wxlibs -l${_libname}"
 902         fi
 903
 904     done
 905
 906     if [ -n "$WXDEBUG" ]; then
 907         decho "  retrieved: ldflags = $_all_ldflags"
 908         decho "             wxlibs  = $_wxlibs"
 909         decho "             alllibs = $_all_libs"
 910     fi
 911
 912     echo $_all_ldflags $_wxlibs $_all_libs
 913 }
 914
 915
 916 # Sanity check the list of libs the user provided us, if any.
 917 # --------------------------------------------------------------
 918
 919 wx_libs=$(echo "$input_parameters" | tr ',' ' ')
 920
 921 [ -z "$WXDEBUG" ] || decho "  user supplied libs: '$wx_libs'"
 922
 923 if is_monolithic; then
 924
 925     # Core libs are already built into the blob.
 926     for i in std @CORE_GUI_LIBS@ @CORE_BASE_LIBS@; do
 927         wx_libs=$(remove_field $i $wx_libs)
 928     done
 929
 930     wx_libs="@WXCONFIG_LDFLAGS_GUI@ @WXCONFIG_RPATH@ $(lib_flags_for $wx_libs)"
 931
 932     # We still need the core lib deps for a static build though
 933     if [ "x$this_linkage" = "x-static" ]; then
 934         wx_libs="$wx_libs ${libdir}/libwx_@TOOLCHAIN_NAME@.a $ldlibs_core @LIBS@"
 935     else
 936         wx_libs="$wx_libs -lwx_@TOOLCHAIN_NAME@"
 937     fi
 938
 939     using_gui=yes
 940
 941 else    # MONOLITHIC = 0
 942
 943     # Import everything by default, and base if it was omitted.
 944     if [ -z "$wx_libs" ]; then
 945         wx_libs="@CORE_GUI_LIBS@ @CORE_BASE_LIBS@"
 946     elif ! match_field base $wx_libs ; then
 947         wx_libs="$wx_libs base"
 948     fi
 949
 950     # Expand the magic library 'std' to the default set.
 951     # Only add those not already specified to future-proof
 952     # against changes to std which would otherwise break
 953     # people's builds.
 954     if match_field std $wx_libs; then
 955         wx_libs=$(remove_field std $wx_libs)
 956         for i in @CORE_GUI_LIBS@ @CORE_BASE_LIBS@; do
 957             match_field "$i" $wx_libs || wx_libs="$wx_libs $i"
 958         done
 959     fi
 960
 961     using_gui=no
 962     for i in $wx_libs ; do
 963         if match_field "$i" @CORE_GUI_LIBS@ ; then
 964             _guildflags="@WXCONFIG_LDFLAGS_GUI@"
 965             using_gui=yes
 966             break
 967         fi
 968         match_field "$i" @CORE_BASE_LIBS@ || using_gui=yes
 969     done
 970
 971     wx_libs="$_guildflags @WXCONFIG_RPATH@ $(lib_flags_for $wx_libs)"
 972 fi
 973
 974
 975 if [ -n "$WXDEBUG" ]; then
 976     decho
 977     decho "  using libs: '$wx_libs'"
 978     decho "  using_gui = $using_gui"
 979     decho
 980 fi
 981
 982
 983 # Endgame.  Nothing left to discover now.
 984 # --------------------------------------------------------------
 985
 986 [ -n "$this_linkage"   ] || _static_cppflags="@TOOLCHAIN_DLL_DEFS@"
 987 [ "$using_gui" = "yes" ] || _gui_cppflags="-DwxUSE_GUI=0"
 988
 989 if [ -n "$this_prefix" ]; then
 990     _include_cppflags="-I${includedir} -I${prefix}/contrib/include"
 991 else
 992     _include_cppflags="-I${includedir}/wx-@WX_RELEASE@@WX_FLAVOUR@"
 993 fi
 994
 995 _cppflags=$(echo "-I${libdir}/wx/include/@TOOLCHAIN_FULLNAME@" $_include_cppflags "@WXDEBUG_DEFINE@" "@TOOLCHAIN_DEFS@" $_static_cppflags $_gui_cppflags "@WXCONFIG_INCLUDE@" "@WX_LARGEFILE_FLAGS@" "@GCC_PRAGMA_FLAGS@")
 996
 997 # now without further ado, we can answer these too.
 998 [ -z "$output_option_cppflags" ] || echo $_cppflags
 999 [ -z "$output_option_cflags"   ] || echo $_cppflags "@CODE_GEN_FLAGS@"
1000 [ -z "$output_option_cxxflags" ] || echo $_cppflags "@CODE_GEN_FLAGS@" "@CODE_GEN_FLAGS_CXX@"
1001 [ -z "$output_option_gl_libs"  ] || echo $(lib_flags_for gl)
1002
1003 if [ -n "$output_option_libs" ]; then
1004
1005     is_cross && [ "x$libdir" = "x/usr/${target}/lib" ]                      \
1006     || [ "x$libdir" = "x/usr/lib" ]                                         \
1007     || _ldflags="-L$libdir"
1008
1009     echo $_ldflags "@LDFLAGS@" $wx_libs "@DMALLOC_LIBS@"
1010 fi
1011
1012 # And so that's it, we're done.  Have a nice build.
1013
1014 exit 0
1015
1016