3 # Name: wx-config{.in,}
4 # Purpose: wx configuration search and query tool {template,}
5 # Author: Ron <ron@debian.org>
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 ############################################################################
20 # Extra^2 debug mode, for if things ever get really weird.
21 [ -z "$WXDEBUG_X" ] || set -x
24 # On with some basic stuff, like the ability to die gracefully,
25 # and to tell people what we are about.
26 # ------------------------------------------------------------------
29 # Output a message to stderr.
30 decho
() { echo "$*" 1>&2; }
33 # Outputs a usage message to stderr and exits with _exitcode.
34 # Try to keep this to a single page (ie. < 25 lines). We can add
35 # alternate or interactive help targets if people want more detail.
37 # Exit codes are now subject to a more strict interpretation.
38 # wx-config should return 0 upon successful operation, 1 if the
39 # reqested operation could not be completed successfully, and 2
40 # if the requested operation is not supported by this version of
46 wx-config [--prefix[=DIR]] [--exec-prefix[=DIR]] [--release] [--version-full]
47 [--list] [--selected-config] [--host=HOST] [--toolkit=TOOLKIT]
48 [--universal[=yes|no]] [--unicode[=yes|no]] [--static[=yes|no]]
49 [--debug[=yes|no]] [--version[=VERSION]] [--basename] [--cc] [--cxx]
50 [--cppflags [base]] [--cxxflags [base]] [--cflags]
51 [--rescomp] [--linkdeps] [--ld] [--utility=UTIL]
52 [--libs [LIBS...]] [--optional-libs [LIBS...]]
54 wx-config returns information about the wxWidgets libraries available on
55 your system. It may be used to retrieve the information required to build
56 applications using these libraries using --cppflags, --cxxflags, --cflags,
57 and --libs options. And you may query the properties of this configuration
58 using --query-{host,toolkit,widgetset,chartype,debugtype,version,linkage}.
60 NOTE: Usage of --debug and --query-debugtype are only relevant if you
61 have any versions prior to 2.9 installed and use the --version option to
62 select an earlier version.
64 If multiple builds of wxWidgets are available, you can use the options
65 --prefix, --host, --toolkit, --unicode, --static, --universal or --version
66 to select from them. The --selected-config option shows the name of the
67 current configuration and --list shows available alternatives which match
68 specified criteria. The --utility option returns the correct version of
69 UTIL to use with the selected build. The --linkdeps option returns only
70 static libraries for your makefile link rule dependencies.
72 The LIBS arguments (comma or space separated) may be used to specify the
73 wxWidgets libraries that you wish to use. The "std" label may be used to
74 import all libraries that would be used by default if none were specified
75 explicitly, e.g. wx-config --libs core,base. The "all" label may be used
76 to import all libraries that have been compiled which are shown in the
77 list below. The --optional-libs parameter should be followed by a list
78 of libs that should be linked to, but only if they are available.
80 Available libraries in this build are:
88 # Unfussy people are the easiest to deal with, get them out of the way now.
89 [ $# -gt 0 ] || usage
1
92 # Contentious tools determined by configure.
96 # For the people who know what they want, or think they do:
97 # Divide the valid arguments into functional groups for later examination,
98 # then parse all command line arguments completely, deferring action on
99 # output options until all significant input has been processed and any
100 # decision about delegation has been taken.
102 # Note early, that '-' is a complete no-no for use in option names below.
103 # It totally falls apart as soon as it becomes part of a variable name.
104 # Use '_' instead, and by the magic of it all just being bits, you'll
105 # be able to use --my-option or --my_option from the command line at
106 # your discretion. They are synonymous as user input, but _ALWAYS_ use
107 # underscores for compound names in the code here, never a dash.
110 # The list of all options we recognise. If it is not in here, then
111 # it is not something we want to handle.
112 # ------------------------------------------------------------------
114 # Options that specify a distinct library build.
116 # Note also that order in this list is significant later on, as this sets
117 # the precedence with which we will try to gauge the similarity of other
118 # configs to this one. Options earlier in the list should be more crucial
119 # to match well than those that follow. Options specified by the user will
120 # always take precedence and are not subject to any partial ordering here.
121 wxconfig_schema
="host toolkit widgetset chartype debugtype flavour version linkage"
123 # Options that are expected to generate some output.
124 wxconfig_output_options
="prefix exec_prefix
126 release version version_full
128 cppflags cflags cxxflags
137 # Options that permit the user to supply hints that may affect the output.
138 # These options all accept arbitrary values, to interpret as they please.
139 wxconfig_input_options
="prefix exec_prefix utility $wxconfig_schema"
141 # Input options that accept only a yes or no argument.
143 # Notice that this includes "debug" but it is done only for compatibility, this
144 # options (i.e. --debug[=yes] or --debug=no) is completely ignored as there is
145 # no distinction between debug and release builds in wx any more
146 wxconfig_yesno_options
="universal unicode debug static"
148 # Boolean options that do something or not.
149 wxconfig_flag_options
="$wxconfig_yesno_options selected_config no_rpath inplace"
153 # Some simple sugar coating to keep things more readable below.
154 # --------------------------------------------------------------
156 # option_name _string
157 # Returns NAME if _string is of the form: --NAME[=...]
160 echo "$1" | sed 's/^--//;s/=.*//' | tr '-' '_'
163 # option_value _string
164 # Returns FOO if _string is of the form: --option=FOO
167 echo "$1" | sed 's/^[^=]*=//'
170 # match_field _value _list
171 # Returns true if _value is a field in _list
174 _match_field_match
="$1"
176 for _match_field_i
do
177 [ "x$_match_field_i" != "x$_match_field_match" ] || return 0
182 # remove_field _value _list
183 # Returns _list minus any field(s) that match _value.
189 if [ -n "$_remf_value" ]; then
191 [ "x$_remf_item" = "x$_remf_value" ] ||
192 _remf_list
="${_remf_list:+$_remf_list }$_remf_item"
200 # validate_arg _domain _set _name _value
201 # Boilerplate to validate an argument and initialise a pseudo-hash.
202 # This one is almost reduction into absurdity, and perhaps makes the
203 # precise action of the argument parser below just a little more
204 # obscure, but oh so neat and compact to use for multiple option
205 # groups. It expands to replace repetitive clauses of the form:
207 # i="$(option_name $arg)"
208 # if match_field "$i" $wxconfig_input_options; then
209 # input_options="${input_options:+$input_options }$i"
210 # eval "input_option_$i=$(option_value $arg)"
214 # with the one liners you see on the page below.
217 if match_field
"$3" `eval echo \"\\\$$1_$2_options\"`; then
218 eval "$2_options=\"\${$2_options:+\$$2_options }$3\""
219 eval "$2_option_$3=\"$4\""
225 # check_yesno_option _ynoption _option _yesval _noval
226 # This one might be made more generic and/or incorporated into
227 # validate_arg above at some later stage, but right now we just
228 # condition any specialist options into a generic one for later
229 # handling. Once they are sanity checked there is no difference
233 eval "case \${yesno_option_$1-\${flag_option_$1-unset}} in
235 y*|Y*) input_option_$2=\"$3\" ;;
236 n*|N*) input_option_$2=\"$4\" ;;
239 decho \" *** Error: Invalid request '--$1=\$yesno_option_$1'\"
240 decho \" Valid arguments for --$1 are: [ yes, no ]\"
249 MAC_FRAMEWORK_PREFIX
=
252 # Now we are ready to find out what the user wants from us.
253 # --------------------------------------------------------------
255 # With just a little more complexity here we could have shortest
256 # unique string matching for options, but that is probably overkill
257 # today, so let's just get the job done.
259 # The important thing now then is that we simply read all input from
260 # the user and don't try to act prematurely on partial information.
261 # --help or an illegal argument are the only shortcuts out of here
262 # at this point, otherwise, it's time to just shut up and listen for
272 _name
=`option_name $arg`
273 _value
=`option_value $arg`
274 if validate_arg wxconfig input
"$_name" "$_value" ||
275 validate_arg wxconfig yesno
"$_name" "$_value"
282 _name
=`echo $arg | sed 's/^--query-//'`
283 if match_field
"$_name" $wxconfig_schema
285 query_options
="${query_options:+$query_options }$_name"
291 _name
=`option_name $arg`
292 if validate_arg wxconfig flag
"$_name" yes ||
293 validate_arg wxconfig output
"$_name" yes
300 # We validate the parameters later ...
302 if [ "$_name" = "cxxflags" ] || [ "$_name" = "cppflags" ] || [ "$_name" = "cflags" ]; then
303 cxx_parameters
="${cxx_parameters:+$cxx_parameters }$arg"
304 elif [ "$_name" = "libs" ]; then
305 libs_parameters
="${libs_parameters:+$libs_parameters }$arg"
306 elif [ "$_name" = "optional_libs" ]; then
307 optional_libs_parameters
="${optional_libs_parameters:+$optional_libs_parameters }$arg"
309 # normally anything here are unattached arguments and signify an
310 # error but for compatibility with the 2.8 wx-config and,
311 # especially, configure scripts generated using 2.8 wxwin.m4 and
312 # hence doing `wx-config --version base,std`, we ignore anything
313 # following this option, just as 2.8 version used to do
314 if [ "$_name" != "version" ]; then
315 input_parameters
="${input_parameters:+$input_parameters }$arg"
321 decho
" *** Error: Unrecognised option: '$arg'"
322 decho
"Use wx-config --help for information on command line options."
326 # validate_arg only checks and decomposes form. Sanity check the yes/no
327 # options now too and push their respective mask values into place.
329 check_yesno_option universal widgetset univ
330 check_yesno_option unicode chartype unicode ansi
331 check_yesno_option static linkage static
332 check_yesno_option debug debugtype debug release
334 # Dump everything we just read in debug mode.
335 if [ -n "$WXDEBUG" ]; then
338 decho
" input parameters = $input_parameters"
339 decho
" libs parameters = $libs_parameters"
340 decho
" optional-libs parameters = $optional_libs_parameters"
341 decho
" input options = $input_options"
342 for i
in $input_options; do
343 decho
" $i = `eval echo \"\\\$input_option_$i\"`"
345 decho
" yes/no options = $yesno_options"
346 for y
in $yesno_options; do
347 decho
" $y = `eval echo \"\\\$yesno_option_$y\"`"
349 decho
" flag options = $flag_options"
350 for f
in $flag_options; do
351 decho
" $f = `eval echo \"\\\$flag_option_$f\"`"
353 decho
" output options = $output_options"
354 for o
in $output_options; do
355 decho
" $o = `eval echo \"\\\$output_option_$o\"`"
357 decho
" query options = $query_options"
363 # Everything came in as a legal argument then, let's put some of
364 # the pieces together with a little self knowledge to see what
366 # --------------------------------------------------------------
369 # Construct a config filename mask from a pseudo-hash of component variables.
370 # The optional argument is the prefix of the hash to use. If not specified
371 # this will return a mask derived from the command line options that were used.
374 [ $# -gt 0 ] || set m
376 case "$m_ourversion" in
381 # there is no 2.10 so currently everything else is <= 2.8
385 # 3.x and later "is29orlater" too
390 # use 2.8 or 2.9 version of the mask: the difference is the presence of
391 # debug type in pre-2.9
392 if [ $is29orlater = 1 ]; then
393 eval echo "\${$1_host:+\$$1_host-}\${$1_toolkit}\${$1_widgetset}-\${$1_chartype}\${$1_linkage:+-\$$1_linkage}-\${$1_version}\${$1_flavour}"
395 eval echo "\${$1_host:+\$$1_host-}\${$1_toolkit}\${$1_widgetset}-\${$1_chartype}-\${$1_debugtype}\${$1_linkage:+-\$$1_linkage}-\${$1_version}\${$1_flavour}"
399 # Returns true if this script is for a cross compiled config.
400 is_cross
() { [ "x@cross_compiling@" = "xyes" ]; }
403 # Determine the base directories we require.
404 prefix
=${input_option_prefix-${this_prefix:-@prefix@}}
405 exec_prefix
=${input_option_exec_prefix-${input_option_prefix-${this_exec_prefix:-@exec_prefix@}}}
406 wxconfdir
="@libdir@/wx/config"
408 installed_configs
=`cd "$wxconfdir" 2> /dev/null && ls | grep -v "^inplace-"`
410 is_cross
&& target
="@host_alias@"
412 # Define a pseudo-hash to contain the specification of this wx-config
413 # instance and its associated library.
414 this_host
="${target:+${target}}"
415 this_toolkit
="@TOOLKIT_DIR@@TOOLKIT_VERSION@"
416 this_widgetset
="@WIDGET_SET@"
417 this_chartype
="@WX_CHARTYPE@"
418 this_debugtype
="release"
419 this_flavour
="@WX_FLAVOUR@"
420 this_version
="@WX_RELEASE@"
421 this_linkage
=`[ "x@SHARED@" = "x1" ] || echo 'static'`
424 # Extract the user specification from the options parsed.
425 m_host
=${input_option_host:+"${input_option_host}-?"}
426 m_host
=${m_host:-$this_host}
427 m_toolkit
=${input_option_toolkit:-'[^-]+'}
428 m_widgetset
=${input_option_widgetset-'(univ)?'}
429 m_chartype
=${input_option_chartype:-'(unicode|ansi)'}
430 m_debugtype
=${input_option_debugtype:-'(debug|release)'}
431 m_flavour
=${input_option_flavour:+-$input_option_flavour}
432 m_flavour
=${m_flavour:-${input_option_flavour-'(-[^-]+)?'}}
433 m_version
=${input_option_version:-'[0-9]+\.[0-9]+'}
434 m_linkage
=${input_option_linkage-'?(static)?'}
436 # Test whether or not --version has been specified
438 # This must be done after getting the input options so get_mask works correctly
439 # since it is version-dependent
441 if [ -z "$input_option_version" ]; then
444 m_ourversion
=$m_version
447 this_config
=`get_mask this`
449 configmask
="^`get_mask`$"
452 # Dump the user specification in debug mode.
453 if [ -n "$WXDEBUG" ]; then
456 decho
" prefix = '$prefix'"
457 decho
" exec_prefix = '$exec_prefix'"
458 decho
" wxconfdir = '$wxconfdir'"
460 decho
" m_host = '$m_host'"
461 decho
" m_toolkit = '$m_toolkit'"
462 decho
" m_widgetset = '$m_widgetset'"
463 decho
" m_chartype = '$m_chartype'"
464 decho
" m_debugtype = '$m_debugtype'"
465 decho
" m_flavour = '$m_flavour'"
466 decho
" m_version = '$m_version'"
467 decho
" m_linkage = '$m_linkage'"
469 decho
" configmask = '$configmask'"
470 decho
" this config = '$this_config'"
477 # From here on, we'll need to be able to figure out a delegation target.
478 # -----------------------------------------------------------------------
480 # The rules for delegation are:
482 # 1. If the specification is so general that it matches the default config
483 # (ie. this one on a first pass), then the default config will be used
484 # even if other installed libs would also match the spec.
486 # 2. If the default config does not match, find a list of all installed
487 # libraries that do match.
488 # a. If that list is empty, the specification is incompatible
489 # with any installed lib. Warn and abort.
490 # b. If that list contains exactly one candidate. Delegate to
492 # c. If the list contains multiple candidates, pass on to step 3.
494 # 3. Attempt to discriminate among rival candidates by their similarity
495 # to the default configuration (ie. this one). If we can find a unique
496 # candidate in this way, delegate to it. If not, present a list of
497 # options to the user and request that they disambiguate it with one or
498 # more additional fields.
500 # To refine the specified pattern, we specialise each unbound field
501 # using the default value from this config file. If that results in
502 # no matches, we unbind it again and try the next field. If it still
503 # results in multiple matches we try binding the next field as well
504 # until a unique or null result again occurs.
506 # A more general way to look at this, is the feature specifiers are all
507 # modifiers of the wx-config you are calling. If you supply none, the
508 # default for that build configuration will be used. If you supply one
509 # or more that the default build cannot satisfy, it will try to find the
510 # config most like itself with the desired feature(s) enabled.
511 # The features configured into the first wx-config called will be taken
512 # as implicitly specified if it is necessary to disambiguate likely
513 # candidates from the information that was explicitly provided.
516 # But first, more sugar to keep what follows clear and legible.
517 # --------------------------------------------------------------
519 # find_eligible_delegates _mask
520 # Outputs all the config files installed which match the
521 # (extended regex) _mask passed as an argument.
522 find_eligible_delegates
() { echo "$installed_configs" | $EGREP "$1" 2> /dev
/null
; }
524 # user_mask_fits _config
525 # Returns true if the string _config satisfies the user specified mask.
526 user_mask_fits
() { echo "$1" | $EGREP "$configmask" > /dev
/null
2>&1; }
529 # Returns the number of IFS split fields in _word
530 count_fields
() { return $#; }
532 # count_delegates _mask
533 # Return the number of eligible config files that match _mask
534 count_delegates
() { count_fields
`find_eligible_delegates $1`; }
536 # is_set _variablename
537 # Returns true if $_variablename is initialised.
538 is_set
() { [ "x`eval echo \"\\\${$1-unset}\"`" != "xunset" ]; }
541 # true iff _cmd is false
542 not
() { if "$@"; then false
; else true
; fi; }
544 # do_find_best_delegate _unbound-options
545 # The real worker part of find_best_delegate below. Recurses though all
546 # unbound options binding them one at a time to the default derived from
547 # this file until a unique match is made or no alternatives remain that
548 # may be sensibly guessed at. It will preferentially bind the unspecified
549 # options in the order they are listed in wxconfig_schema. Using this
550 # partial ordering it should find the first match with the most significant
551 # similarity to this file that unambiguously meets the user specification.
552 # If such a match exists it will be output to stdout.
554 # Be careful if you modify this function. If the pruning logic is rendered
555 # inoperative it will simply recurse over every permutation in the search
556 # space, which may still appear to work, but add a couple more options (or
557 # explicitly specify a few less) and you may not live long enough to learn
558 # the result. WXDEBUG=findprogress is your friend here, it will show you
559 # how many nodes get searched before a result. If you start seeing
560 # increases in that number for the same input, check your work.
561 # Raising the number of discriminating options from 6 to 8 raised the worst
562 # case time for this to run (without pruning) from 3 to nearly 15 seconds
563 # and its downhill fast from here if we have to ride that boat.
564 # Early pruning still gets that down to under half a second (up from about
565 # .25), so we have some breathing space yet before a different search method
566 # will be called for, but let's not squander it.
567 do_find_best_delegate
()
570 if [ "x$WXDEBUG" = "xverbose" ]; then
571 _fbd_indent
="${_fbd_indent}. "
572 decho
" $_fbd_indent---> unbound options: $*"
577 if [ "x$WXDEBUG" = "xverbose" ]; then
578 decho
" ${_fbd_indent}binding '$i' with '`remove_field $i $*`' still free"
579 [ -z "$_pruned" ] || decho
" ${_fbd_indent} --- pruned: $_pruned ---"
586 if [ "x$WXDEBUG" = "xverbose" ]; then
587 decho
" ${_fbd_indent} checking: $_mask"
588 count_delegates
"$_mask"
589 decho
" $_fbd_indent $? eligible delegates"
590 for d
in `find_eligible_delegates "$_mask"`; do
591 decho
" ${_fbd_indent} $d"
595 count_delegates
"$_mask"
598 if [ $_still_eligible -eq 1 ]; then
599 echo `find_eligible_delegates "$_mask"`
603 [ "x$WXDEBUG" != "xfindprogress" ] || printf "." 1>&2
605 [ $_still_eligible -gt 1 ] && [ $# -gt 1 ] &&
606 do_find_best_delegate
`remove_field $i $*`
612 elif [ $# -gt 1 ]; then
614 if [ "x$WXDEBUG" = "xverbose" ]; then
615 decho
" ${_fbd_indent}pruning: $i"
616 _pruned
="${_pruned:+$_pruned }$i"
618 set `remove_field $i $*`
628 # A simple wrapper around do_find_best_delegate that first determines
629 # the unbound options (ie. the ones that the user did not explicitly
630 # declare a preference for on the command line)
633 for _fbdi
in $wxconfig_schema; do
634 is_set input_option_
$_fbdi ||
635 _unbound_options
="${_unbound_options:+$_unbound_options }$_fbdi"
637 do_find_best_delegate
$_unbound_options
641 # Legacy wx-config helpers.
642 # -------------------------
645 # Returns a mask in the format used by wx2.4.
648 [ $# -gt 0 ] || set m
649 eval [ "x\${$1_chartype}" != "xunicode" ] || _unicode_flag
=u
650 eval echo "wx\${$1_toolkit}${_unicode_flag}-\${$1_version}\${$1_host}-config"
653 # find_legacy_configs
654 # Returns a list of configs installed by wx2.4 releases.
655 find_legacy_configs
()
660 ls wx
*-2.4
-config | grep -v ^wxbase
661 ls wx
*-2.4
-config | grep ^wxbase
666 # find_best_legacy_config
667 # Returns the best legacy config for a given specification.
668 # This assumes no matching new style config has been found.
669 find_best_legacy_config
()
671 _legacy_configs
=`find_legacy_configs`
672 if [ -n "$_legacy_configs" ]; then
673 _legacy_mask
=`get_legacy_mask`
674 for d
in $_legacy_configs; do
675 if echo $d | $EGREP $_legacy_mask > /dev
/null
2>&1 ; then
686 # The only action we can perform authoritatively prior to delegation
687 # is to list all the possible delegates.
688 # --------------------------------------------------------------
691 [ -z "$WXDEBUG" ] || config_spec
=$configmask
693 # Next chance for another satisfied customer then
695 # If we want to get really polished here we can do plural checking,
696 # but we should probably leave that until the day we gettextise it.
697 if [ -n "$output_option_list" ]; then
699 _remains_in_prefix
=$installed_configs
700 _delegates
=`find_eligible_delegates $configmask`
701 _best_delegate
=`find_best_delegate`
703 if [ "x$WXDEBUG" = "xverbose" ]; then
705 decho
" all = $_remains_in_prefix"
706 decho
" matching = $_delegates"
707 decho
" best = $_best_delegate"
708 decho
" this = $this_config"
711 for d
in $_delegates; do
712 _remains_in_prefix
=`remove_field $d $_remains_in_prefix`
716 echo " Default config is $this_config"
719 if user_mask_fits
"$this_config" ; then
721 echo " Default config ${this_exec_prefix+in $this_exec_prefix }will be used for output"
723 if match_field
"$this_config" $_delegates ; then
724 _delegates
=`remove_field $this_config $_delegates`
726 echo " though it is not installed in: $prefix"
727 if [ -n "$_best_delegate" ] && [ "x$_best_delegate" != "x$this_config" ]; then
729 echo " Best alternate in $prefix:"
730 echo " $_best_delegate"
734 elif [ -n "$_best_delegate" ]; then
736 echo " Specification best match: $_best_delegate"
738 elif [ -z "$_delegates" ]; then
740 _last_chance
=`find_best_legacy_config`
741 if [ -n "$_last_chance" ]; then
743 echo " Specification matches legacy config: $_last_chance"
748 No config found to match: $config_spec
751 Please install the desired library build, or specify a different
752 prefix where it may be found. If the library is not installed
753 you may call its wx-config directly by specifying its full path.
760 echo " Specification was ambiguous. Use additional feature options"
761 echo " to choose between alternate matches."
764 _delegates
=`remove_field "$_best_delegate" $_delegates`
766 if [ -n "$_delegates" ]; then
768 echo " Alternate matches:"
769 for d
in $_delegates; do
773 if [ -n "$_remains_in_prefix" ]; then
775 echo " Also available in $prefix:"
776 for d
in $_remains_in_prefix; do
781 _legacy_configs
=`find_legacy_configs`
782 if [ -n "$_legacy_configs" ]; then
784 echo " Legacy configs available in $prefix:"
785 for d
in $_legacy_configs; do
786 echo " $d" | sed 's/-config$//'
796 # ... so if that wasn't what they wanted, then we need to know for
797 # certain, can this config satisfy the user specification?
798 # --------------------------------------------------------------
800 if not user_mask_fits
"$this_config" ; then
802 # No? Then let's see if it knows anybody who can.
803 # But first, just be sure someone hasn't typo'd us into a loop.
804 # In present day wx, correct delegation should never need more
805 # than one hop so this is trivial to detect.
807 if [ -n "$WXCONFIG_DELEGATED" ]; then
809 decho
" *** Error: Bad config delegation"
812 decho
" ($this_config) cannot satisfy:"
813 decho
" $config_spec"
814 decho
" Someone has been terribly careless."
819 count_delegates
"$configmask"
822 if [ -n "$WXDEBUG" ]; then
823 decho
" must delegate to an alternate config"
824 decho
" potential delegates ($_numdelegates):"
825 for i
in `find_eligible_delegates "$configmask"`; do
830 if [ $_numdelegates -eq 0 ]; then
832 _last_chance
=`find_best_legacy_config`
833 if [ -n "$_last_chance" ]; then
837 --prefix*|--exec-prefix*| \
838 --version|--release|--basename| \
839 --static|--libs|--gl_libs| \
840 --cppflags|--cflags|--cxxflags| \
842 --rezflags|--inplace)
843 _legacy_args
="$_legacy_args $arg"
846 --static|--static=y
*|--static=Y
*)
847 _legacy_args
="$_legacy_args --static"
852 if [ -n "$WXDEBUG" ]; then
853 decho
" found a suitable legacy delegate: $_last_chance"
854 decho
"--> $prefix/bin/$_last_chance $_legacy_args"
857 WXCONFIG_DELEGATED
=yes
858 export WXCONFIG_DELEGATED
859 $prefix/bin
/$_last_chance $_legacy_args
866 Warning: No config found to match: $config_spec
868 If you require this configuration, please install the desired
869 library build. If this is part of an automated configuration
870 test and no other errors occur, you may safely ignore it.
871 You may use wx-config --list to see all configs available in
876 # PIPEDREAM: from here we are actually just a teensy step
877 # from simply building the missing config for the user
878 # on the fly if this is an in tree wx-config.
884 if [ $_numdelegates -gt 1 ]; then
886 [ -z "$WXDEBUG" ] || decho
" must prune the list of eligible delegates"
888 best_delegate
=`find_best_delegate`
890 if [ -n "$best_delegate" ]; then
892 if [ -n "$WXDEBUG" ]; then
893 decho
" found a suitable delegate: $best_delegate"
894 decho
"--> $wxconfdir/$best_delegate $*"
897 WXCONFIG_DELEGATED
=yes
898 export WXCONFIG_DELEGATED
899 $wxconfdir/$best_delegate $
*
904 decho
" *** Error: Specification is ambiguous"
905 decho
" as $config_spec"
906 decho
" Use additional feature options to choose between:"
907 for i
in `find_eligible_delegates "$configmask"`; do
915 if [ -n "$WXDEBUG" ]; then
916 decho
" using the only suitable delegate"
917 decho
"--> $wxconfdir/`find_eligible_delegates $configmask` $*"
920 WXCONFIG_DELEGATED
=yes
921 export WXCONFIG_DELEGATED
922 $wxconfdir/`find_eligible_delegates $configmask` $
*
928 # If we are still here, then from now on we are responsible for
929 # all the user's needs. Time to rustle up some output for them.
930 # --------------------------------------------------------------
932 [ -z "$WXDEBUG" ] || decho
" using this config"
934 # If the user supplied a prefix, and the in tree config did not
935 # delegate out to anything in that prefix, then reset the build
936 # tree prefix to provide the correct output for using this
937 # uninstalled wx build. Or put more simply:
938 prefix
=${this_prefix-$prefix}
939 exec_prefix
=${this_exec_prefix-$exec_prefix}
941 includedir
="@includedir@"
945 # Trivial queries we can answer now.
946 [ -z "$output_option_prefix" ] || echo $prefix
947 [ -z "$output_option_exec_prefix" ] || echo $exec_prefix
948 [ -z "$output_option_release" ] || echo "@WX_RELEASE@"
949 [ -z "$output_option_version" ] || echo "@WX_VERSION@"
950 [ -z "$output_option_version_full" ] || echo "@WX_SUBVERSION@"
951 [ -z "$output_option_basename" ] || echo "@WX_LIBRARY_BASENAME_GUI@"
952 [ -z "$output_option_cc" ] || echo "@CC@"
953 [ -z "$output_option_cxx" ] || echo "@CXX@"
954 [ -z "$output_option_ld" ] || echo "@CXX@ -o"
955 [ -z "$flag_option_selected_config" ] || echo "$this_config"
957 for q
in $query_options; do
958 eval echo "\$this_$q"
961 # --rezflags is deprecated and disabled (2005/11/29)
962 if [ -n "$output_option_rezflags" ]; then
964 decho
"Warning: --rezflags, along with Mac OS classic resource building" \
965 "is deprecated. You should remove this from your Makefile and" \
966 "build .app bundles instead."
970 # The rest are going to need a little more work.
971 # --------------------------------------------------------------
973 is_monolithic
() { [ "x@MONOLITHIC@" = "x1" ]; }
974 is_static
() { [ -n "$this_linkage" ]; }
975 is_installed
() { [ -z "$this_prefix" ]; }
978 # Is the user after a support utility?
979 # If this is a cross build, we need to find and return a suitable
980 # native utility for the job, so we search:
982 # 1. local build dir (for native uninstalled builds only).
983 # 2. (optional) user supplied prefix.
984 # 3. configured install prefix.
985 # 4. environment $PATH.
987 # and if such a thing still cannot be found, exit signalling an error.
988 if [ -n "$input_option_utility" ]; then
990 # This is dumb, in tree binaries should be in a standard location
991 # like the libs, but work with what we've got for now.
992 is_cross
|| _util
="$exec_prefix/utils/$input_option_utility/$input_option_utility"
994 if not is_installed
&& [ -x "$_util" ]; then
995 is_static
|| _preload
="eval LD_LIBRARY_PATH=$exec_prefix/lib"
996 echo $_preload $_util
1001 _user_prefix
=${input_option_exec_prefix:-$input_option_prefix}
1003 for _util
in "${input_option_utility}-@WX_RELEASE@@WX_FLAVOUR@" \
1004 "${input_option_utility}-@WX_RELEASE@" \
1005 "${input_option_utility}"
1007 for p
in ${_user_prefix:+$_user_prefix/bin} $bindir $PATH; do
1009 [ -z "$WXDEBUG" ] || decho
" checking for: '$p/$_util'"
1011 if [ -x "$p/$_util" ]; then
1023 # Still here? Then get the options together for building an app.
1024 # ----------------------------------------------------------------
1026 # Additional configuration for individual library components.
1027 ldflags_gl
="@LDFLAGS_GL@"
1029 ldlibs_base
="@WXCONFIG_LIBS@"
1030 ldlibs_core
="@EXTRALIBS_GUI@"
1031 ldlibs_gl
="@OPENGL_LIBS@"
1032 ldlibs_html
="@EXTRALIBS_HTML@"
1033 ldlibs_xml
="@EXTRALIBS_XML@"
1034 ldlibs_adv
="@EXTRALIBS_SDL@"
1035 ldlibs_stc
="@EXTRALIBS_STC@"
1038 # Order the libraries passed to us correctly for static linking.
1040 # While the libraries order doesn't matter when linking dynamically, we must
1041 # put the libraries depending on other libraries in front of their dependencies
1042 # when linking statically or the dependencies wouldn't be resolved by the
1043 # standard UNIX linkers.
1048 # Distinguish between the libraries that may need to be moved to
1049 # the end of the list (because other ones may depend on them) and
1050 # those that can be output immediately because no other libraries
1053 base
|core
|html
|xml
|adv
) eval "use_$lib=1" ;;
1054 *) libs
="$libs $lib" ;;
1058 # Add the libraries that we postponed adding above.
1059 # Order of the checks here is important.
1060 [ -z "$use_html" ] || libs
="$libs html"
1061 [ -z "$use_adv" ] || libs
="$libs adv"
1062 [ -z "$use_core" ] || libs
="$libs core"
1063 [ -z "$use_xml" ] || libs
="$libs xml"
1064 [ -z "$use_base" ] || libs
="$libs base"
1066 # No need to order them.
1073 # lib_flags_for _liblist
1074 # This function returns a list of flags suitable to return with the
1075 # output of --libs for all of the libraries in _liblist. You can
1076 # add support for a new library by adding an entry for it in the
1077 # psuedo-hashes above if it requires additional linker options.
1080 [ -z "$WXDEBUG" ] || decho
" fetching lib flags for: '$*'"
1086 is_cross
&& _target
="-${target}"
1090 # We evidently can't trust people not to duplicate things in
1091 # configure, or to keep them in any sort of sane order overall,
1092 # so only add unique new fields here even if it takes us a while.
1093 # In the case of libs, we bubble any duplicates to the end,
1094 # because if multiple libs require it, static linking at least
1095 # will require it to come after all of them. So long as local
1096 # order is ok in configure then we should always be able to
1097 # massage a correct result here like this.
1099 # FIXME: ldlibs_core is totally bogus. Fix the duplication
1100 # there independently of this. This covers for it, but we
1101 # want to do this anyway because some libs may share common
1102 # deps without a common ancestor in wx. This is not a licence
1103 # for sloppy work elsewhere though and @GUI_TK_LIBRARY should
1106 for f
in `eval echo \"\\\$ldflags_$lib\"`; do
1107 match_field
"$f" $_all_ldflags || _all_ldflags
="$_all_ldflags $f"
1110 if match_field
"$lib" @STD_BASE_LIBS@
; then
1111 _libname
="@WX_LIBRARY_BASENAME_NOGUI@"
1113 _libname
="@WX_LIBRARY_BASENAME_GUI@"
1115 [ $lib = base
] || _libname
="${_libname}_$lib"
1116 _libname
="${_libname}-@WX_RELEASE@$_target"
1119 _wxlibs
="$_wxlibs ${libdir}/lib${_libname}.a"
1120 for f
in `eval echo \"\\\$ldlibs_$lib\"`; do
1122 # Only propagate duplicate -libraries to their latest
1123 # possible position. Do not eliminate any other
1124 # duplicates that might occur. They should be fixed
1125 # in configure long before they get here.
1126 # This started as a workaround for Mac -framework,
1127 # but it seems like a better policy in general, which
1128 # will let the more heinous bugs in configure shake out.
1129 # We should maybe filter *.a here too, but not unless
1132 -l*) _all_libs
="`remove_field $f $_all_libs` $f" ;;
1133 *) _all_libs
="$_all_libs $f" ;;
1138 _wxlibs
="$_wxlibs -l${_libname}"
1143 if [ -n "$WXDEBUG" ]; then
1144 decho
" retrieved: ldflags = $_all_ldflags"
1145 decho
" wxlibs = $_wxlibs"
1146 decho
" alllibs = $_all_libs"
1149 echo $_all_ldflags $_wxlibs $_all_libs
1152 # this is the strict subset of the above function which returns only the
1153 # (static) libraries themselves: this is used for linkdeps output which should
1154 # output the list of libraries the main program should depend on
1156 # of course, this duplication is bad but I'll leave to somebody else the care
1157 # of refactoring this as I don't see any way to do it - VZ.
1159 # This (and the other cruft to support it) should be removed with
1160 # reference to the FIXME above when configure stops piping us a slurry
1161 # of options that need to be decomposed again for most practical uses - RL.
1166 is_cross
&& _target
="-${target}"
1169 if match_field
"$lib" @STD_BASE_LIBS@
; then
1170 _libname
="@WX_LIBRARY_BASENAME_NOGUI@"
1172 _libname
="@WX_LIBRARY_BASENAME_GUI@"
1174 [ $lib = base
] || _libname
="${_libname}_$lib"
1175 _libname
="${_libname}-@WX_RELEASE@$_target"
1177 _wxlibs
="$_wxlibs ${libdir}/lib${_libname}.a"
1183 # Sanity check the list of libs the user provided us, if any.
1184 # --------------------------------------------------------------
1186 wx_libs
=`echo "$libs_parameters" | tr ',' ' '`
1187 wx_optional_libs
=`echo "$optional_libs_parameters" | tr ',' ' '`
1189 # Add the --optional-libs, if they've been compiled and aren't already added
1190 for i
in $wx_optional_libs; do
1191 if match_field
$i @BUILT_WX_LIBS@
; then
1192 if not match_field
$i $wx_libs; then
1193 wx_libs
="${wx_libs:+$wx_libs }$i"
1198 [ -z "$WXDEBUG" ] || decho
" user supplied libs: '$wx_libs'"
1200 # Assume we are using the GUI, unless --libs was specified with no GUI libs
1203 if is_monolithic
; then
1205 # Only add additional info if --libs was specified and not just --optional-libs
1206 if [ -n "$output_option_libs" ]; then
1207 # Core libs are already built into the blob.
1208 for i
in std @STD_GUI_LIBS@ @STD_BASE_LIBS@
; do
1209 wx_libs
=`remove_field $i $wx_libs`
1212 wx_libs
=`order_libs $wx_libs`
1213 wx_libs
="@WXCONFIG_LDFLAGS_GUI@ `lib_flags_for $wx_libs`"
1215 # We still need the core lib deps for a static build though
1217 link_deps
="${libdir}/libwx_@TOOLCHAIN_NAME@.a"
1218 wx_libs
="$wx_libs $link_deps $ldlibs_core $ldlibs_base"
1220 wx_libs
="$wx_libs -lwx_@TOOLCHAIN_NAME@"
1223 else # MONOLITHIC = 0
1225 # Import core libs by default, expand std if specified, or add base if omitted.
1226 if [ -n "$output_option_libs" ] && [ -z "$libs_parameters" ]; then
1227 wx_libs
="@STD_GUI_LIBS@ @STD_BASE_LIBS@"
1228 elif match_field all
$wx_libs; then
1229 wx_libs
="@BUILT_WX_LIBS@"
1230 elif match_field std
$wx_libs; then
1231 # Bubble any libs that were already specified to the end
1232 # of the list and ensure static linking order is retained.
1233 wx_libs
=`remove_field std $wx_libs`
1234 for i
in @STD_GUI_LIBS@ @STD_BASE_LIBS@
; do
1235 wx_libs
="`remove_field $i $wx_libs` $i"
1237 elif not match_field base
$wx_libs ; then
1238 # Only add base if --libs was specified and not just --optional-libs
1239 if [ -n "$output_option_libs" ]; then
1240 wx_libs
="$wx_libs base"
1244 if [ -n "$output_option_libs" ]; then
1246 for i
in $wx_libs ; do
1247 if match_field
"$i" @STD_GUI_LIBS@
; then
1248 _guildflags
="@WXCONFIG_LDFLAGS_GUI@"
1252 match_field
"$i" @STD_BASE_LIBS@
|| using_gui
=yes
1257 link_deps
=`link_deps_for $wx_libs`
1259 wx_libs
=`order_libs $wx_libs`
1260 wx_libs
="$_guildflags `lib_flags_for $wx_libs`"
1264 # If they explicitly set "--cxx(pp)flags base" then they don't want the GUI
1265 if [ "$cxx_parameters" = "base" ]; then
1270 if [ -n "$WXDEBUG" ]; then
1272 decho
" using libs: '$wx_libs'"
1273 decho
" using_gui = $using_gui"
1278 # Endgame. Nothing left to discover now.
1279 # --------------------------------------------------------------
1281 [ "$using_gui" = "yes" ] || _gui_cppflags
="-DwxUSE_GUI=0"
1283 if is_installed
; then
1284 _include_cppflags
="-I${includedir}/wx-@WX_RELEASE@@WX_FLAVOUR@"
1286 _include_cppflags
="-I${includedir}"
1289 _cppflags
=`echo "-I${libdir}/wx/include/@TOOLCHAIN_FULLNAME@" $_include_cppflags "@WXCONFIG_CPPFLAGS@" $_gui_cppflags`
1291 # now without further ado, we can answer these too.
1292 [ -z "$output_option_cppflags" ] || echo $_cppflags
1293 [ -z "$output_option_cflags" ] || echo $_cppflags "@WXCONFIG_CFLAGS@"
1294 [ -z "$output_option_cxxflags" ] || echo $_cppflags "@WXCONFIG_CXXFLAGS@"
1295 [ -z "$output_option_gl_libs" ] || echo `lib_flags_for gl`
1296 [ -z "$output_option_linkdeps" ] || echo $link_deps
1298 if [ -n "$output_option_libs" ]; then
1299 # if --libs [--optional-libs] then output the full linker information
1302 [ "x$libdir" = "x/usr/${target}/lib" ] ||
1303 [ "x$libdir" = "x/usr/lib" ] ||
1304 _ldflags
="-L$libdir"
1306 if [ -n "$MAC_FRAMEWORK" ]; then
1307 wx_libs
="-framework $MAC_FRAMEWORK"
1308 if [ -n "$MAC_FRAMEWORK_PREFIX" ]; then
1309 _ldflags
="-F$MAC_FRAMEWORK_PREFIX"
1315 is_installed
|| [ -n "$flag_option_no_rpath" ] || _rpath
="@WXCONFIG_RPATH@"
1317 echo $_ldflags "@WXCONFIG_LDFLAGS@" $_rpath $wx_libs "@DMALLOC_LIBS@"
1319 elif [ -n "$output_option_optional_libs" ]; then
1320 # if only --optional-libs then output just the libs
1326 # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
1328 # Beyond here reside only machine or tool specific workarounds
1329 # that require knowlege not obtainable prior to this comment.
1331 # Please. Avoid addding things here, wx-config should avoid
1332 # hard coding tool specific details. Do not use things here
1333 # as an example of other things that should be here, These
1334 # shouldn't be here either. This is a place of last resort
1335 # for interim workarounds. I can but stress as strongly as
1336 # the censor will allow, there are only bad examples of things
1337 # that belong at this level of abstraction to follow. It is
1338 # a limbo for glitches awaiting the Next Design Repair. Ok.
1340 # With that firmly in mind, our debut dilemma is:
1342 # Resource compilers. An elusive term that covers some pretty
1343 # dissimilar concepts on various platforms. The good news is,
1344 # each platform has only one definition of 'resource', compiled
1345 # or not, and so we can abstract that neatly to return a platform
1346 # specific invocation of the appropriate tool. The bad news is,
1347 # windres (at least) requires knowledge of the wx header files
1348 # location(s) that cannot be predicted reliably before the call to
1349 # wx-config is made. Currently for all known resource compilers,
1350 # we can simply return a command and some salient configuration
1351 # options in response to a request for --rescomp. So here we
1352 # top up the options for any tools that may require information
1353 # that was only just determined in the last few machine cycles,
1354 # then output the necessary incantation for the platform.
1356 # Most things should already be constant by the time configure
1357 # has run. Do not add anything here that is already known there.
1359 if [ -n "$output_option_rescomp" ]; then
1363 # Note that with late model windres, we could just insert
1364 # _include_cppflags here, but use the old notation for now
1365 # as it is more universally accepted.
1366 if is_installed
; then
1367 echo "@RESCOMP@ --include-dir" \
1368 "${includedir}/wx-@WX_RELEASE@@WX_FLAVOUR@" \
1369 "@WXCONFIG_RESFLAGS@"
1371 echo "@RESCOMP@ --include-dir ${includedir}" \
1372 "@WXCONFIG_RESFLAGS@"
1376 # neither rez not emxbind have any specific needs from
1377 # us, so just output what was determined by configure.
1379 echo @RESCOMP@ @WXCONFIG_RESFLAGS@
1386 # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
1388 # And so that's it, we're done. Have a nice build.