X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/d669c2415958a769d9565ffd20f3fa2f23eddf77..2d0c2e79c27e46a238cf44562fb98c99e65d79b4:/wx-config.in diff --git a/wx-config.in b/wx-config.in index 601f173a50..fc4c904912 100755 --- a/wx-config.in +++ b/wx-config.in @@ -1,58 +1,934 @@ #!/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 +############################################################################ -prefix=@prefix@ -exec_prefix=@exec_prefix@ -exec_prefix_set=no -usage="\ -Usage: wx-config [--prefix[=DIR]] [--exec-prefix[=DIR]] [--version] [--libs] [--cflags]" +# Start with some basic stuff, like the ability to die gracefully, +# and to tell people what we are about. +# ------------------------------------------------------------------ -if test $# -eq 0; then - echo "${usage}" 1>&2 - exit 1 -fi +# decho _message +# Output a message to stderr. +decho() { echo "$*" 1>&2; } -while test $# -gt 0; do - case "$1" in - -*=*) optarg=`echo "$1" | sed 's/[-_a-zA-Z0-9]*=//'` ;; - *) optarg= ;; - esac +# usage _exitcode +# Outputs a usage message to stderr and exits with _exitcode. +# Try to keep this to a single page. We can add alternate help +# targets if people want more detail from interactive help. +usage() +{ + cat 1>&2 <&2 - exit 1 - ;; + # FIXME Surely we can validate the parameters too ... + input_parameters="${input_parameters:+$input_parameters }$arg" + continue + ;; esac - shift + decho " *** Error: Unrecognised option: '$arg'" + decho "Use wx-config --help for information on command line options." + exit 1 done +# validate_arg only checks and decomposes form. Sanity check the yes/no +# options now too and push their respective mask values into place. + +check_yesno_option universal widgetset univ +check_yesno_option unicode chartype unicode ansi +check_yesno_option debug debugtype debug release +check_yesno_option static linkage '-static' + + +# Dump everything we just read in debug mode. +if [ -n "$WXDEBUG" ]; then + + decho + decho " input parameters = $input_parameters" + decho " input options = $input_options" + for i in $input_options; do + decho " $i = $(eval echo \"\$input_option_$i\")" + done + decho " yes/no options = $yesno_options" + for y in $yesno_options; do + decho " $y = $(eval echo \"\$yesno_option_$y\")" + done + decho " flag options = $flag_options" + for f in $flag_options; do + decho " $f = $(eval echo \"\$flag_option_$f\")" + done + decho " output options = $output_options" + for o in $output_options; do + decho " $o = $(eval echo \"\$output_option_$o\")" + done + +fi + + + +# Everything came in as a legal argument then, lets put some of +# the pieces together with a little self knowledge to see what +# we should do next. +# -------------------------------------------------------------- + +# get_mask [ _hash ] +# Construct a config filename mask from a psuedo-hash of component variables. +# The optional argument is the prefix of the hash to use. If not specified +# this will return a mask derived from the command line options that were used. +get_mask() +{ + [ $# -gt 0 ] || set m + eval echo "\${$1_host}\${$1_toolkit}\${$1_widgetset}-\${$1_chartype}-\${$1_debugtype}\${$1_linkage}-\${$1_version}\${$1_flavour}" +} + + +# Determine the base directories we require. +prefix=${input_option_prefix-${this_prefix:-@prefix@}} +exec_prefix=${input_option_exec_prefix-${input_option_prefix-${this_exec_prefix:-@exec_prefix@}}} +wxconfdir="@libdir@/wx/config" + +installed_configs=$( cd "$wxconfdir" 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 +} + + +# 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 + echo " all = $_remains_in_prefix" + echo " matching = $_delegates" + echo " best = $_best_delegate" + echo " 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 + + 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 + + else + echo " Specification was ambiguous. Use additional feature options" + echo " to choose between alternate matches." + fi + + [ -z "$_best_delegate" ] || _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 + + 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 + cat 1>&2 <<-EOF + + No config found to match: $config_spec + in $wxconfdir + Please install the desired library build, or use --list + without any feature specifiers to see all available configs. + + 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 + + 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 " Specification was ambiguous." + 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@" + + +# 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, and base if it was omitted. + if [ -z "$wx_libs" ]; then + wx_libs="@CORE_GUI_LIBS@ @CORE_BASE_LIBS@" + elif ! match_field base $wx_libs ; then + wx_libs="$wx_libs base" + fi + + # Expand the magic library 'std' to the default set. + # Only add those not already specified to future-proof + # against changes to std which would otherwise break + # people's builds. + if match_field std $wx_libs; then + wx_libs=$(remove_field std $wx_libs) + for i in @CORE_GUI_LIBS@ @CORE_BASE_LIBS@; do + match_field "$i" $wx_libs || wx_libs="$wx_libs $i" + done + 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 + +