#!/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 ############################################################################ # We expect a posix shell, so if this is a Bourne shell, # and apparently a few still exist, try for bash or ksh. if [ ~ = '~' ] then if (bash -c echo) >/dev/null 2>&1 then exec bash "$0" "$@" fi if (ksh -c echo) >/dev/null 2>&1 then exec ksh "$0" "$@" fi echo "$0: this script requires bash or ksh" exit 1 fi # On 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=$( [ "x@SHARED@" = "x1" ] || 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" && { ls wx*-2.4-config | grep -v ^wxbase ls wx*-2.4-config | grep ^wxbase } ) 2> /dev/null } # 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 # silently exit with error: we shouldn't give any messages here as # we may be called from a configure script where this would really # mess things up 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@" bindir="@bindir@" # 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@" # The rest are going to need a little more work. # -------------------------------------------------------------- is_cross() { [ "x@cross_compiling@" = "xyes" ]; } is_monolithic() { [ "x@MONOLITHIC@" = "x1" ]; } is_static() { [ -n "$this_linkage" ]; } is_installed() { [ -z "$this_prefix" ]; } # Is the user after a support utility? # If this is a cross build, we need to find and return a suitable # native utility for the job, so we search: # # 1. local build dir (for native uninstalled builds only). # 2. (optional) user supplied prefix. # 3. configured install prefix. # 4. environment $PATH. # # and if such a thing still cannot be found, exit signalling an error. if [ -n "$input_option_utility" ]; then # This is dumb, in tree binaries should be in a standard location # like the libs, but work with what we've got for now. is_cross || _util="$exec_prefix/utils/$input_option_utility/$input_option_utility" if ! is_installed && [ -x "$_util" ]; then is_static || _preload="eval LD_LIBRARY_PATH=$exec_prefix/lib" echo $_preload $_util exit fi IFS=':' _user_prefix=${input_option_exec_prefix:-$input_option_prefix} for _util in "${input_option_utility}-@WX_RELEASE@@WX_FLAVOUR@" \ "${input_option_utility}-@WX_RELEASE@" \ "${input_option_utility}" do for p in ${_user_prefix:+$_user_prefix/bin} $bindir $PATH; do [ -z "$WXDEBUG" ] || decho " checking for: '$p/$_util'" if [ -x "$p/$_util" ]; then echo "$p/$_util" exit fi done done exit 1 fi # Still here? Then get the options together for building an app. # ---------------------------------------------------------------- # 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 is_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 } # this is the strict subset of the above function which returns only the # (static) libraries themselves: this is used for linkdeps output which should # output the list of libraries the main program should depend on # # of course, this duplication is bad but I'll leave to somebody else the care # of refactoring this as I don't see any way to do it link_deps_for() { _wxlibs='' is_cross && _target="-${target}" for lib; do 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" _wxlibs="$_wxlibs ${libdir}/lib${_libname}.a" done echo $_wxlibs } # 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@ $(lib_flags_for $wx_libs)" # We still need the core lib deps for a static build though if is_static; then link_deps="${libdir}/libwx_@TOOLCHAIN_NAME@.a" wx_libs="$wx_libs $link_deps $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 if is_static; then link_deps=$(link_deps_for $wx_libs) fi wx_libs="$_guildflags $(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. # -------------------------------------------------------------- [ "$using_gui" = "yes" ] || _gui_cppflags="-DwxUSE_GUI=0" if is_installed; then _include_cppflags="-I${includedir}/wx-@WX_RELEASE@@WX_FLAVOUR@" else _include_cppflags="-I${includedir} -I${prefix}/contrib/include" fi _cppflags=$(echo "-I${libdir}/wx/include/@TOOLCHAIN_FULLNAME@" $_include_cppflags "@WXDEBUG_DEFINE@" "@TOOLCHAIN_DEFS@" "@TOOLCHAIN_DLL_DEFS@" $_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) [ -z "$output_option_linkdeps" ] || echo $link_deps if [ -n "$output_option_libs" ]; then is_cross && [ "x$libdir" = "x/usr/${target}/lib" ] || [ "x$libdir" = "x/usr/lib" ] || _ldflags="-L$libdir" is_installed || [ -n "$flag_option_no_rpath" ] || _rpath="@WXCONFIG_RPATH@" echo $_ldflags "@LDFLAGS@" $_rpath $wx_libs "@DMALLOC_LIBS@" fi # And so that's it, we're done. Have a nice build. exit 0