#!/bin/sh # # Name: wx-config{.in,} # Purpose: wx configuration search and query tool {template,} # Author: Ron # Modified by: # Created: 8/9/2004 # RCS-ID: $Id$ # Copyright: (c) 2004 Ron # Essentially a fresh start this time around, but for maximum # compatibility basic code was taken from, and heavy reference # made to, the previously unattributed wx-config from cvs. # All the usual suspects contributed to the dicussion that led # to this new work and likewise to the ideas and content in the # original (which was probably influenced by gtk), among them: # Robert Roebling, Vadim Zeitlin, Vaclav Slavik, Robin Dunn # Licence: wxWindows licence ############################################################################ # Start with some basic stuff, like the ability to die gracefully, # and to tell people what we are about. # ------------------------------------------------------------------ # decho _message # Output a message to stderr. decho() { echo "$*" 1>&2; } # usage _exitcode # Outputs a usage message to stderr and exits with _exitcode. # Try to keep this to a single page (ie. < 25 lines). We can add # alternate or interactive help targets if people want more detail. # # Exit codes are now subject to a more strict interpretation. # wx-config should return 0 upon successful operation, 1 if the # reqested operation could not be completed successfully, and 2 # if the requested operation is not supported by this version of # wx-config. usage() { cat 1>&2 < /dev/null && ls | grep -v "^inplace-" ) target="@host_alias@" # Define a pseudo-hash to contain the specification of this wx-config # instance and its associated library. this_host="${target:+${target}-}" this_toolkit="@TOOLKIT_DIR@@TOOLKIT_VERSION@" this_widgetset="@WIDGET_SET@" this_chartype="@WX_CHARTYPE@" this_debugtype="@WX_DEBUGTYPE@" this_flavour="@WX_FLAVOUR@" this_version="@WX_RELEASE@" this_linkage=$( [ @SHARED@ -eq 1 ] || echo '-static' ) this_config=$(get_mask this) # Extract the user specification from the options parsed. m_host=${input_option_host:+${input_option_host}-?} m_host=${m_host:-${input_option_host-$this_host}} m_toolkit=${input_option_toolkit:-[^-]+} m_widgetset=${input_option_widgetset-(univ)?} m_chartype=${input_option_chartype:-(unicode|ansi)} m_debugtype=${input_option_debugtype:-(debug|release)} m_flavour=${input_option_flavour:+-$input_option_flavour} m_flavour=${m_flavour:-${input_option_flavour-(-[^-]+)?}} m_version=${input_option_version:-[0-9]+\.[0-9]+} m_linkage=${input_option_linkage-(-static)?} configmask="^$(get_mask)$" # Dump the user specification in debug mode. if [ -n "$WXDEBUG" ]; then decho decho " prefix = '$prefix'" decho " exec_prefix = '$exec_prefix'" decho " wxconfdir = '$wxconfdir'" decho " m_host = '$m_host'" decho " m_toolkit = '$m_toolkit'" decho " m_widgetset = '$m_widgetset'" decho " m_chartype = '$m_chartype'" decho " m_debugtype = '$m_debugtype'" decho " m_flavour = '$m_flavour'" decho " m_version = '$m_version'" decho " m_linkage = '$m_linkage'" decho " configmask = '$configmask'" decho " this config = '$this_config'" decho fi # From here on, we'll need to be able to figure out a delegation target. # ----------------------------------------------------------------------- # The rules for delegation are: # # 1. If the specification is so general that it matches the default config # (ie. this one on a first pass), then the default config will be used # even if other installed libs would also match the spec. # # 2. If the default config does not match, find a list of all installed # libraries that do match. # a. If that list is empty, the specification is incompatible # with any installed lib. Warn and abort. # b. If that list contains exactly one candidate. Delegate to # that candidate. # c. If the list contains multiple candidates, pass on to step 3. # # 3. Attempt to discriminate among rival candidates by their similarity # to the default configuration (ie. this one). If we can find a unique # candidate in this way, delegate to it. If not, present a list of # options to the user and request that they disambiguate it with one or # more additional fields. # # To refine the specified pattern, we specialise each unbound field # using the default value from this config file. If that results in # no matches, we unbind it again and try the next field. If it still # results in multiple matches we try binding the next field as well # until a unique or null result again occurs. # # A more general way to look at this, is the feature specifiers are all # modifiers of the wx-config you are calling. If you supply none, the # default for that build configuration will be used. If you supply one # or more that the default build cannot satisfy, it will try to find the # config most like itself with the desired feature(s) enabled. # The features configured into the first wx-config called will be taken # as implicitly specified if it is necessary to disambiguate likely # candidates from the information that was explicitly provided. # But first, more sugar to keep what follows clear and legible. # -------------------------------------------------------------- # find_eligible_delegates _mask # Outputs all the config files installed which match the # (extended regex) _mask passed as an argument. find_eligible_delegates() { echo "$installed_configs" | grep -E "$1" 2> /dev/null; } # user_mask_fits _config # Returns true if the string _config satisfies the user specified mask. user_mask_fits() { echo "$1" | grep -E "$configmask" > /dev/null 2>&1; } # count_fields _word # Returns the number of IFS split fields in _word count_fields() { return $#; } # count_delegates _mask # Return the number of eligible config files that match _mask count_delegates() { count_fields $(find_eligible_delegates $1); } # is_set _variablename # Returns true if $_variablename is initialised. is_set() { [ "x$(eval echo \"\${$1-unset}\")" != "xunset" ]; } # do_find_best_delegate _unbound-options # The real worker part of find_best_delegate below. Recurses though all # unbound options binding them one at a time to the default derived from # this file until a unique match is made or no alternatives remain that # may be sensibly guessed at. It will preferentially bind the unspecified # options in the order they are listed in wxconfig_schema. Using this # partial ordering it should find the first match with the most significant # similarity to this file that unambiguously meets the user specification. # If such a match exists it will be output to stdout. # # Be careful if you modify this function. If the pruning logic is rendered # inoperative it will simply recurse over every permutation in the search # space, which may still appear to work, but add a couple more options (or # explicitly specify a few less) and you may not live long enough to learn # the result. WXDEBUG=findprogress is your friend here, it will show you # how many nodes get searched before a result. If you start seeing # increases in that number for the same input, check your work. # Raising the number of discriminating options from 6 to 8 raised the worst # case time for this to run (without pruning) from 3 to nearly 15 seconds # and its downhill fast from here if we have to ride that boat. # Early pruning still gets that down to under half a second (up from about # .25), so we have some breathing space yet before a different search method # will be called for, but lets not squander it. do_find_best_delegate() { ( if [ "x$WXDEBUG" = "xverbose" ]; then _fbd_indent="${_fbd_indent}. " decho " $_fbd_indent---> unbound options: $*" fi for i; do if [ "x$WXDEBUG" = "xverbose" ]; then decho " ${_fbd_indent}binding '$i' with '$(remove_field $i $*)' still free" [ -z "$_pruned" ] || decho " ${_fbd_indent} --- pruned: $_pruned ---" fi if ( eval m_$i=\$this_$i _mask="^$(get_mask)$" if [ "x$WXDEBUG" = "xverbose" ]; then decho " ${_fbd_indent} checking: $_mask" count_delegates "$_mask" decho " $_fbd_indent $? eligible delegates" for d in $(find_eligible_delegates "$_mask"); do decho " ${_fbd_indent} $d" done fi count_delegates "$_mask" _still_eligible=$? if [ $_still_eligible -eq 1 ]; then echo $(find_eligible_delegates "$_mask") return fi [ "x$WXDEBUG" != "xfindprogress" ] || printf "." 1>&2 [ $_still_eligible -gt 1 ] && [ $# -gt 1 ] && \ do_find_best_delegate $(remove_field $i $*) ); then return elif [ $# -gt 1 ]; then if [ "x$WXDEBUG" = "xverbose" ]; then decho " ${_fbd_indent}pruning: $i" _pruned="${_pruned:+$_pruned }$i" fi set $(remove_field $i $*) fi done false ) } # find_best_delegate # A simple wrapper around do_find_best_delegate that first determines # the unbound options (ie. the ones that the user did not explicitly # declare a preference for on the command line) find_best_delegate() { for _fbdi in $wxconfig_schema; do is_set input_option_$_fbdi || \ _unbound_options="${_unbound_options:+$_unbound_options }$_fbdi" done do_find_best_delegate $_unbound_options } # Legacy wx-config helpers. # ------------------------- # get_legacy_mask # Returns a mask in the format used by wx2.4. get_legacy_mask() { [ $# -gt 0 ] || set m eval [ "x\${$1_chartype}" != "xunicode" ] || _unicode_flag=u eval [ "x\${$1_debugtype}" != "xdebug" ] || _debug_flag=d eval echo "wx\${$1_toolkit}${_unicode_flag}${_debug_flag}-\${$1_version}\${$1_host}-config" } # find_legacy_configs # Returns a list of configs installed by wx2.4 releases. find_legacy_configs() { cd "$prefix/bin" 2> /dev/null && \ ls wx*-2.4-config | grep -v ^wxbase; \ ls wx*-2.4-config | grep ^wxbase } # find_best_legacy_config # Returns the best legacy config for a given specification. # This assumes no matching new style config has been found. find_best_legacy_config() { _legacy_configs=$(find_legacy_configs) if [ -n "$_legacy_configs" ]; then _legacy_mask=$(get_legacy_mask) for d in $_legacy_configs; do if echo $d | grep -E $_legacy_mask > /dev/null 2>&1 ; then echo "$d" return fi done fi false } # The only action we can perform authoritatively prior to delegation # is to list all the possible delegates. # -------------------------------------------------------------- config_spec="$0 $*" [ -z "$WXDEBUG" ] || config_spec=$configmask # Next chance for another satisfied customer then # # If we want to get really polished here we can do plural checking, # but we should probably leave that until the day we gettextise it. if [ -n "$output_option_list" ]; then _remains_in_prefix=$installed_configs _delegates=$(find_eligible_delegates $configmask) _best_delegate=$(find_best_delegate) if [ "x$WXDEBUG" = "xverbose" ]; then decho decho " all = $_remains_in_prefix" decho " matching = $_delegates" decho " best = $_best_delegate" decho " this = $this_config" fi for d in $_delegates; do _remains_in_prefix=$(remove_field $d $_remains_in_prefix) done echo echo " Default config is $this_config" echo if user_mask_fits "$this_config" ; then echo " Default config ${this_exec_prefix+in $this_exec_prefix }will be used for output" if match_field "$this_config" $_delegates ; then _delegates=$(remove_field $this_config $_delegates) else echo " though it is not installed in: $prefix" if [ -n "$_best_delegate" ] && [ "x$_best_delegate" != "x$this_config" ]; then echo echo " Best alternate in $prefix:" echo " $_best_delegate" fi fi elif [ -n "$_best_delegate" ]; then echo " Specification best match: $_best_delegate" elif [ -z "$_delegates" ]; then _last_chance=$(find_best_legacy_config) if [ -n "$_last_chance" ]; then echo " Specification matches legacy config: $_last_chance" else cat <<-EOF No config found to match: $config_spec in $wxconfdir Please install the desired library build, or specify a different prefix where it may be found. If the library is not installed you may call its wx-config directly by specifying its full path. EOF fi else echo " Specification was ambiguous. Use additional feature options" echo " to choose between alternate matches." fi _delegates=$(remove_field "$_best_delegate" $_delegates) if [ -n "$_delegates" ]; then echo echo " Alternate matches:" for d in $_delegates; do echo " $d" done fi if [ -n "$_remains_in_prefix" ]; then echo echo " Also available in $prefix:" for d in $_remains_in_prefix; do echo " $d" done fi _legacy_configs=$(find_legacy_configs) if [ -n "$_legacy_configs" ]; then echo echo " Legacy configs available in $prefix:" for d in $_legacy_configs; do echo " ${d%-config}" done fi echo exit fi # ... so if that wasn't what they wanted, then we need to know for # certain, can this config satisfy the user specification? # -------------------------------------------------------------- if ! user_mask_fits "$this_config" ; then # No? Then lets see if it knows anybody who can. # But first, just be sure someone hasn't typo'd us into a loop. # In present day wx, correct delegation should never need more # than one hop so this is trivial to detect. if [ -n "$WXCONFIG_DELEGATED" ]; then decho decho " *** Error: Bad config delegation" decho decho " to: $0" decho " ($this_config) cannot satisfy:" decho " $config_spec" decho " Someone has been terribly careless." decho exit 1 fi count_delegates "$configmask" _numdelegates=$? if [ -n "$WXDEBUG" ]; then decho " must delegate to an alternate config" decho " potential delegates ($_numdelegates):" for i in $(find_eligible_delegates "$configmask"); do decho " $i" done fi if [ $_numdelegates -eq 0 ]; then _last_chance=$(find_best_legacy_config) if [ -n "$_last_chance" ]; then for arg; do case "$arg" in --prefix*|--exec-prefix*| \ --version|--release|--basename| \ --static|--libs|--gl_libs| \ --cppflags|--cflags|--cxxflags| \ --cc|--cxx|--ld| \ --rezflags|--inplace) _legacy_args="$_legacy_args $arg" ;; --static|--static=y*|--static=Y*) _legacy_args="$_legacy_args --static" ;; esac done if [ -n "$WXDEBUG" ]; then decho " found a suitable legacy delegate: $_last_chance" decho "--> $prefix/bin/$_last_chance $_legacy_args" fi export WXCONFIG_DELEGATED=yes $prefix/bin/$_last_chance $_legacy_args exit else cat 1>&2 <<-EOF Warning: No config found to match: $config_spec in $wxconfdir If you require this configuration, please install the desired library build. If this is part of an automated configuration test and no other errors occur, you may safely ignore it. You may use wx-config --list to see all configs available in the default prefix. EOF # PIPEDREAM: This will probably give Vadim an aneurysm if I # mention it out of context, but from here we are actually # just a teensy step from simply building the missing config # for the user on the fly if this is an in tree wx-config. exit 1 fi fi if [ $_numdelegates -gt 1 ]; then [ -z "$WXDEBUG" ] || decho " must prune the list of eligible delegates" best_delegate=$(find_best_delegate) if [ -n "$best_delegate" ]; then if [ -n "$WXDEBUG" ]; then decho " found a suitable delegate: $best_delegate" decho "--> $wxconfdir/$best_delegate $*" fi export WXCONFIG_DELEGATED=yes $wxconfdir/$best_delegate $* exit fi decho decho " *** Error: Specification is ambiguous" decho " as $config_spec" decho " Use additional feature options to choose between:" for i in $(find_eligible_delegates "$configmask"); do decho " $i" done decho exit 1 fi if [ -n "$WXDEBUG" ]; then decho " using the only suitable delegate" decho "--> $wxconfdir/$(find_eligible_delegates $configmask) $*" fi export WXCONFIG_DELEGATED=yes $wxconfdir/$(find_eligible_delegates $configmask) $* exit fi # If we are still here, then from now on we are responsible for # all the user's needs. Time to rustle up some output for them. # -------------------------------------------------------------- [ -z "$WXDEBUG" ] || decho " using this config" # If the user supplied a prefix, and the in tree config did not # delegate out to anything in that prefix, then reset the build # tree prefix to provide the correct output for using this # uninstalled wx build. Or put more simply: prefix=${this_prefix-$prefix} exec_prefix=${this_exec_prefix-$exec_prefix} includedir="@includedir@" libdir="@libdir@" # Trivial queries we can answer now. [ -z "$output_option_prefix" ] || echo $prefix [ -z "$output_option_exec_prefix" ] || echo $exec_prefix [ -z "$output_option_release" ] || echo "@WX_RELEASE@" [ -z "$output_option_version" ] || echo "@WX_VERSION@" [ -z "$output_option_version_full" ] || echo "@WX_SUBVERSION@" [ -z "$output_option_basename" ] || echo "@WX_LIBRARY_BASENAME_GUI@" [ -z "$output_option_rezflags" ] || echo $(eval echo "@MACRESWXCONFIG@") [ -z "$output_option_cc" ] || echo "@CC@" [ -z "$output_option_cxx" ] || echo "@CXX@" [ -z "$output_option_ld" ] || echo "@EXE_LINKER@" [ -z "$input_option_utility" ] || echo "${input_option_utility}-@WX_RELEASE@@WX_FLAVOUR@" # The rest are going to need a little more work. # -------------------------------------------------------------- is_cross() { [ "x@cross_compiling@" = "xyes" ]; } is_monolithic() { [ @MONOLITHIC@ -eq 1 ]; } # Additional configuration for individual library components. ldflags_gl="@LDFLAGS_GL@" ldlibs_base="@WXCONFIG_EXTRALIBS@" ldlibs_core="@EXTRALIBS_GUI@" ldlibs_gl="@OPENGL_LIBS@" ldlibs_html="@EXTRALIBS_HTML@" ldlibs_xml="@EXTRALIBS_XML@" ldlibs_odbc="@EXTRALIBS_ODBC@" ldlibs_adv="@EXTRALIBS_SDL@" # lib_flags_for _liblist # This function returns a list of flags suitable to return with the # output of --libs for all of the libraries in _liblist. You can # add support for a new library by adding an entry for it in the # psuedo-hashes above if it requires additional linker options. lib_flags_for() { [ -z "$WXDEBUG" ] || decho " fetching lib flags for: '$*'" _all_ldflags='' _all_libs='' _wxlibs='' ! is_cross || _target="-${target}" for lib; do # We evidently can't trust people not to duplicate things in # configure, or to keep them in any sort of sane order overall, # so only add unique new fields here even if it takes us a while. # In the case of libs, we bubble any duplicates to the end, # because if multiple libs require it, static linking at least # will require it to come after all of them. So long as local # order is ok in configure then we should always be able to # massage a correct result here like this. # # FIXME: ldlibs_core is totally bogus. Fix the duplication # there independently of this. This covers for it, but we # want to do this anyway because some libs may share common # deps without a common ancestor in wx. This is not a licence # for sloppy work elsewhere though and @GUI_TK_LIBRARY should # be fixed. for f in $(eval echo \"\$ldflags_$lib\"); do match_field "$f" $_all_ldflags || _all_ldflags="$_all_ldflags $f" done if match_field "$lib" @CORE_BASE_LIBS@ ; then _libname="@WX_LIBRARY_BASENAME_NOGUI@" else _libname="@WX_LIBRARY_BASENAME_GUI@" fi [ $lib = base ] || _libname="${_libname}_$lib" _libname="${_libname}-@WX_RELEASE@$_target" if [ "x$this_linkage" = "x-static" ]; then _wxlibs="$_wxlibs ${libdir}/lib${_libname}.a" for f in $(eval echo \"\$ldlibs_$lib\"); do _all_libs="$(remove_field $f $_all_libs) $f" done else _wxlibs="$_wxlibs -l${_libname}" fi done if [ -n "$WXDEBUG" ]; then decho " retrieved: ldflags = $_all_ldflags" decho " wxlibs = $_wxlibs" decho " alllibs = $_all_libs" fi echo $_all_ldflags $_wxlibs $_all_libs } # Sanity check the list of libs the user provided us, if any. # -------------------------------------------------------------- wx_libs=$(echo "$input_parameters" | tr ',' ' ') [ -z "$WXDEBUG" ] || decho " user supplied libs: '$wx_libs'" if is_monolithic; then # Core libs are already built into the blob. for i in std @CORE_GUI_LIBS@ @CORE_BASE_LIBS@; do wx_libs=$(remove_field $i $wx_libs) done wx_libs="@WXCONFIG_LDFLAGS_GUI@ @WXCONFIG_RPATH@ $(lib_flags_for $wx_libs)" # We still need the core lib deps for a static build though if [ "x$this_linkage" = "x-static" ]; then wx_libs="$wx_libs ${libdir}/libwx_@TOOLCHAIN_NAME@.a $ldlibs_core @LIBS@" else wx_libs="$wx_libs -lwx_@TOOLCHAIN_NAME@" fi using_gui=yes else # MONOLITHIC = 0 # Import everything by default, expand std if specified, or add base if omitted. if [ -z "$wx_libs" ]; then wx_libs="@CORE_GUI_LIBS@ @CORE_BASE_LIBS@" elif match_field std $wx_libs; then # Bubble any libs that were already specified to the end # of the list and ensure static linking order is retained. wx_libs=$(remove_field std $wx_libs) for i in @CORE_GUI_LIBS@ @CORE_BASE_LIBS@; do wx_libs="$(remove_field $i $wx_libs) $i" done elif ! match_field base $wx_libs ; then wx_libs="$wx_libs base" fi using_gui=no for i in $wx_libs ; do if match_field "$i" @CORE_GUI_LIBS@ ; then _guildflags="@WXCONFIG_LDFLAGS_GUI@" using_gui=yes break fi match_field "$i" @CORE_BASE_LIBS@ || using_gui=yes done wx_libs="$_guildflags @WXCONFIG_RPATH@ $(lib_flags_for $wx_libs)" fi if [ -n "$WXDEBUG" ]; then decho decho " using libs: '$wx_libs'" decho " using_gui = $using_gui" decho fi # Endgame. Nothing left to discover now. # -------------------------------------------------------------- [ -n "$this_linkage" ] || _static_cppflags="@TOOLCHAIN_DLL_DEFS@" [ "$using_gui" = "yes" ] || _gui_cppflags="-DwxUSE_GUI=0" if [ -n "$this_prefix" ]; then _include_cppflags="-I${includedir} -I${prefix}/contrib/include" else _include_cppflags="-I${includedir}/wx-@WX_RELEASE@@WX_FLAVOUR@" fi _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@") # now without further ado, we can answer these too. [ -z "$output_option_cppflags" ] || echo $_cppflags [ -z "$output_option_cflags" ] || echo $_cppflags "@CODE_GEN_FLAGS@" [ -z "$output_option_cxxflags" ] || echo $_cppflags "@CODE_GEN_FLAGS@" "@CODE_GEN_FLAGS_CXX@" [ -z "$output_option_gl_libs" ] || echo $(lib_flags_for gl) if [ -n "$output_option_libs" ]; then is_cross && [ "x$libdir" = "x/usr/${target}/lib" ] \ || [ "x$libdir" = "x/usr/lib" ] \ || _ldflags="-L$libdir" echo $_ldflags "@LDFLAGS@" $wx_libs "@DMALLOC_LIBS@" fi # And so that's it, we're done. Have a nice build. exit 0