wxWidgets/build/bakefiles/config.bkl

372 lines
12 KiB
Plaintext
Raw Normal View History

<?xml version="1.0" ?>
<!-- $Id$ -->
<makefile>
<set var="BUILDING_LIB" overwrite="0">0</set>
<option name="SHARED">
<values>0,1</values>
<values-description>,DLL</values-description>
<default-value>0</default-value>
<description>
What type of library to build?
</description>
</option>
<option name="WXUNIV">
<values>0,1</values>
<values-description>,Universal</values-description>
<default-value>0</default-value>
<description>
Build wxUniversal instead of native port?
</description>
</option>
<option name="UNICODE">
<values>0,1</values>
<values-description>,Unicode</values-description>
<default-value>0</default-value>
<description>
Compile Unicode build of wxWidgets?
</description>
</option>
<if cond="FORMAT!='autoconf' and FORMAT!='watcom'">
<option name="MSLU">
<values>0,1</values>
<default-value>0</default-value>
<description>
Use MSLU library when building Unicode version.
</description>
</option>
</if>
<if cond="FORMAT=='autoconf' or FORMAT=='watcom'">
<set var="MSLU">0</set>
</if>
<option name="BUILD">
<values>debug,release</values>
<values-description>Debug,Release</values-description>
<default-value>debug</default-value>
<description>
Type of compiled binaries
</description>
</option>
<option name="DEBUG_INFO">
<values>0,1,default</values>
<default-value>default</default-value>
<description>
Should debugging info be included in the executables? The default value
"default" means that debug info will be included if BUILD=debug
and not included if BUILD=release.
</description>
</option>
<option name="DEBUG_FLAG">
<values>0,1,default</values>
<default-value>default</default-value>
<description>
Should __WXDEBUG__ be defined? The default value "default" means that it will
be defined if BUILD=debug and not defined if BUILD=release.
</description>
</option>
<if cond="FORMAT=='msvc'">
<option name="DEBUG_RUNTIME_LIBS">
<values>0,1,default</values>
<default-value>default</default-value>
<description>
Should link against debug RTL (msvcrtd.dll) or release (msvcrt.dll)?
Acts according to DEBUG_INFO by default.
</description>
</option>
</if>
<if cond="FORMAT!='msvc'">
<set var="DEBUG_RUNTIME_LIBS">default</set>
</if>
<set var="MONOLITHIC_DEFAULT">
<if cond="FORMAT=='watcom'">1</if>
<if cond="FORMAT!='watcom'">0</if>
</set>
<option name="MONOLITHIC">
<values>0,1</values>
<values-description>Multilib,Monolithic</values-description>
<default-value>$(MONOLITHIC_DEFAULT)</default-value>
<description>
Multiple libraries or single huge monolithic one?
</description>
</option>
<if cond="FORMAT=='autoconf'"> <!-- FIXME - temporary -->
<option name="USE_PLUGINS">
<values>0,1</values>
<default-value>1</default-value>
<description>
Build parts of the library as dynamically loadable plugins
(only supported in multilib build)?
</description>
</option>
</if>
<if cond="FORMAT!='autoconf'">
<set var="USE_PLUGINS">0</set> <!-- FIXME - temporary -->
</if>
<option name="USE_GUI">
<values>0,1</values>
<values-description>Base,GUI</values-description>
<default-value>1</default-value>
<description>
Build GUI libraries?
</description>
</option>
<option name="USE_HTML">
<values>0,1</values>
<default-value>1</default-value>
<description>
Build wxHTML library (USE_GUI must be 1)?
</description>
</option>
<option name="USE_XRC">
<values>0,1</values>
<default-value>1</default-value>
<description>
Build wxXRC library (USE_GUI must be 1)?
</description>
</option>
<option name="USE_OPENGL">
<values>0,1</values>
<default-value>0</default-value>
<description>
Build OpenGL canvas library (USE_GUI must be 1)?
</description>
</option>
<option name="USE_ODBC">
<values>0,1</values>
<default-value>0</default-value>
<description>
Build ODBC database classes (USE_GUI must be 1)?
</description>
</option>
<option name="USE_EXCEPTIONS">
<values>0,1</values>
<default-value>1</default-value>
<description>
Enable exceptions in compiled code.
</description>
</option>
<option name="OFFICIAL_BUILD">
<values>0,1</values>
<default-value>0</default-value>
<description>
Is this official build by wxWidgets developers?
</description>
</option>
<option name="VENDOR">
<default-value>custom</default-value>
<description>
Use this to name your customized DLLs differently
</description>
</option>
<!-- These basically do what vendor does in the places it didn't. -->
<!-- They should all be unified under some suitable descriptor -->
<option name="WX_FLAVOUR">
<default-value></default-value>
</option>
<option name="WX_LIB_FLAVOUR">
<default-value></default-value>
</option>
<option name="CFG">
<default-value></default-value>
<description>
Name of your custom configuration. This affects directory
where object files are stored as well as the location of
compiled .lib files and setup.h under the lib/ toplevel directory.
</description>
</option>
<!-- unit tests support: -->
<option name="CPPUNIT_CFLAGS">
<default-value></default-value>
<description>
Compiler flags needed to compile test suite in tests directory. If you want
to run the tests, set it so that the compiler can find CppUnit headers.
</description>
</option>
<option name="CPPUNIT_LIBS">
<default-value></default-value>
<description>
Linker flags needed to link test suite in tests directory. If you want
to run the tests, include CppUnit library here.
</description>
</option>
<!-- ================================================================== -->
<!-- Autoconf -->
<!-- ================================================================== -->
<if cond="FORMAT=='autoconf'">
<option name="DEREZ"/>
<option name="TOOLKIT"/>
<option name="TOOLKIT_LOWERCASE"/>
<option name="TOOLKIT_VERSION"/>
<option name="TOOLCHAIN_NAME"/>
wx-config2.6 Designed to be resiliant against future cut and paste coders. Any gnarly parts are black boxed away nicely to avoid accidents and have integrated debugging support for trivial sanity checking in the event of modification or trouble. In this way the major operations are all cleanly separated making any or all of them simply extensible, or replaceable in the face of future needs. Functions now all have api descriptions. If you rely on a function to act in some way, please document it to safeguard yourself against inadvertant interface changes by others. Everything now runs top top to bottom, we don't try to output things as fast as we can read them anymore, instead we read everything in, sort over it just once without the need for 'just in case' temp's, and then output whatever we were asked for only when we are sure we have the correct answer. Almost all key data aims to be constant past the point of its initialisation so side effect creep and trouble with half (re)initialised data should be significantly reduced in future. In almost every case it is easy and clean to simply delay initialisation until all required input channels have been emptied. If you like, think of it as mostly being one big constructor, with a little destructor at the end which outputs what you requested. At core, it is simply a generated config file -- with some user friendly logic for extracting its data and finding related files. Removed references to --gl-libs in --help. It still exists, but if its deprecated, no need to fill space in a compact help summary. It will remain documented (as deprecated) in the man page. Removed references to arcane order rules for arguments. Those limitations don't exist anymore, though the options are backward compatible in all other respects from the user pov. Removed references to --inplace, it doesn't need to be in the summary help either. It also is still accepted as an option, but there is no value in passing it, an uninstalled wx-config will automatically behave correctly. When you need --inplace, it will supply that behaviour for you (but there is no harm in typing it your self in that case). If you do type it when you don't need it, bad things will probably happen just like they always would have. Along with items above, generally compressed --help text to fit on even a traditional sized terminal without the need for paging. If we want more detailed help built in, it should be broken into separate pages, and this would be a trivial extension. Command line input is now controlled by a small generic parser. You define what options you want and what groups you want them in by initialising them as lists. It runs over all the input and fills corresponding psuedo-hashes from it for you to use as you please later. Added a validator for it to check yes/no options. Use posix extended regex instead of gnu 'basic' regex extensions, grep -E is portable, if gmake is not a requirement, we surely can't push gnu grep on people. Made --list more user friendly. It will now always list the current wx-config if it matches the feature spec, though it will warn if that config is not in the specified --prefix. Alternate configs that match (if any) are listed separately. An unqualified call to wx-config --list will always return (at least) the config that was called. We can never have a 'hanging' wx-config shell with no real implementation to back it up anymore so we can always return a sensible result for the user. A wx-config anywhere can list (and hence use) the configs installed in any (other) prefix. Delegation. Too big a topic to remark on in depth here, see the code for a fuller description. With everything being nicely constant and aligned to the respective library build, then aside from delegation, wx-config really is _just_ a config file (albeit with a layer of logic around the constants), and each wx-config carries a set of defaults which match perfectly the library build that it was generated with. If you choose a set of features that it can match, it will answer all your queries for them, if it cannot, it will seek to delegate to the config that is most like itself, but which can supply all the features you specified. This should be completely compatible with any set of options that returned a sensible result previously, and produce a sensible result in many cases where previously the collating order of your locale or the nuances of your filesystem operations would decide which library it thought you wanted. Sort duplicates out of the list of libraries and trickle shared dependencies down the list to properly support static builds. Added the inplace-config tweak for use in the build tree. This works like any other config, except it presets the default prefix to point at the build dir instead of the configured prefix that will become the default if this build is installed. It provides the behaviour of --inplace when $build_dir/wx-config is called without also specifying a different --{exec-,}prefix or any feature flags that it is incompatible with. In that event, it will try to delegate as per the normal rules. The inplace wrapper is not installed with the primary config which cleanly disables it for system installs. It will be invalidated if the build (or source) dir is moved, but will be revalidated if the build tree is subseqently updated with ./config.status --recheck && config.status (which it probably would need to be to build anyway for other reasons at present too) Enabled full support for static builds again, promoted --static to a full feature option. Fixed --ld to return something for them too. Added --flavour, similar to the existing --vendor, but for autoconf builds. These will probably want to be streamlined further. Broadened the use of release and flavour labels to support better concurrent installs. Fix bit rot in make-dist due to new/deleted files. Whittled down the number of obsolete and duplicated substitution variables in configure.in, and lowercased some variables we no longer export for substitution. Use the autoconf macros to generate files where we want them instead of making them someplace and then moving them all about. Remove extra files and symlinks added for the two part wx-config version. Removed the debian -contrib packages. We'll use multi-lib support to manage them from now on and indiviual libs can be split out along functional lines if required. This means the retained contribs will now get __WXDEBUG__ versions packaged too. Removed conflicts from almost packages except i18n and wxPython. All packages now either update or install alongside any existing ones. Added support for flavoured debs as well. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@29241 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2004-09-21 13:16:29 -04:00
<option name="TOOLCHAIN_FULLNAME"/>
<option name="EXTRALIBS"/>
<option name="EXTRALIBS_XML"/>
<option name="EXTRALIBS_HTML"/>
<option name="EXTRALIBS_ODBC"/>
<option name="EXTRALIBS_GUI"/>
<option name="EXTRALIBS_OPENGL"/>
<option name="EXTRALIBS_SDL"/>
<option name="EXTRALIBS_GNOMEPRINT"/>
<option name="HOST_SUFFIX"/>
<option name="SAMPLES_RPATH_FLAG"/>
<option name="SAMPLES_RPATH_POSTLINK"/>
<set var="TOP_SRCDIR">$(top_srcdir)/</set>
<set var="RUNTIME_LIBS">dynamic</set>
<set var="WXTOPDIR"/> <!-- to be overriden on bakefile cmd line -->
<option name="WITH_PLUGIN_SDL">
<values>0,1</values>
</option>
</if>
<!-- ================================================================== -->
<!-- windows compilers -->
<!-- ================================================================== -->
<if cond="FORMAT!='autoconf'">
<option name="RUNTIME_LIBS">
<values>dynamic,static</values>
<default-value>dynamic</default-value>
<description>
Version of C runtime library to use. You can change this to
static if SHARED=0, but it is highly recommended to not do
it if SHARED=1 unless you know what you are doing.
</description>
</option>
<set var="WXTOPDIR"/> <!-- to be overriden on bakefile cmd line -->
<set var="TOOLKIT" overwrite="0">
<if cond="FORMAT!='msevc4prj'">MSW</if>
<if cond="FORMAT=='msevc4prj'">WINCE</if>
</set>
<set var="TOOLKIT_LOWERCASE">$(TOOLKIT.lower())</set>
<set var="TOOLKIT_VERSION"/>
<set var="HOST_SUFFIX"/>
<set var="EXTRACFLAGS"/>
<set var="EXTRALIBS"/>
<set var="EXTRALIBS_XML"/>
<set var="EXTRALIBS_HTML"/>
<set var="EXTRALIBS_ODBC"/>
<set var="EXTRALIBS_GUI"/>
<set var="EXTRALIBS_OPENGL">
<if cond="COMPILER=='wat'">opengl32.lib glu32.lib</if>
<if cond="COMPILER in ['vc','evc']">opengl32.lib glu32.lib</if>
<if cond="COMPILER=='gcc'">-lopengl32 -lglu32</if>
</set>
<set var="EXTRALIBS_SDL"/>
<set var="EXTRALIBS_GNOMEPRINT"/>
<set var="WITH_PLUGIN_SDL">0</set>
<set var="SRCDIR">
<if cond="BUILDING_LIB=='1'">..$(DIRSEP)..</if>
<if cond="BUILDING_LIB=='0'">.</if>
</set>
<set var="TOP_SRCDIR">$(SRCDIR)/$(WXTOPDIR)</set>
</if>
<if cond="FORMAT=='mingw'">
<option name="GCC_VERSION">
<values>3,2.95</values>
<default-value>3</default-value>
<description>
Set the version of your Mingw installation here.
"3" ...... this is for Mingw 2.0 or newer (comes with gcc3)
"2.95" ... for Mingw 1.1 or any of the older versions
</description>
</option>
<set var="GCCFLAGS">
<if cond="GCC_VERSION=='2.95'">-fvtable-thunks</if>
</set>
<set var="EXTRACFLAGS">$(GCCFLAGS) -DHAVE_W32API_H</set>
</if>
<if cond="FORMAT=='cbuilderx'">
<set var="EXTRACFLAGS">
<if cond="COMPILER=='gcc'">-DHAVE_W32API_H</if>
</set>
</if>
<!-- ================================================================== -->
<!-- Project files - hardcode some defaults -->
<!-- ================================================================== -->
<if cond="FORMAT_SUPPORTS_CONDITIONS=='0'">
<set var="RUNTIME_LIBS">dynamic</set>
<set var="OFFICIAL_BUILD">0</set>
<set var="USE_HTML">1</set>
<set var="USE_XRC">1</set>
<set var="USE_OPENGL">1</set>
<set var="USE_ODBC">1</set>
<set var="MONOLITHIC">0</set>
<set var="USE_GUI">1</set>
<set var="USE_EXCEPTIONS">1</set>
<set var="DEBUG_INFO">default</set>
<set var="DEBUG_FLAG">default</set>
<set var="MSLU">0</set>
</if>
<!-- FIXME:
C++BuilderX supports only wxMSW, monolithic (sic!) static build
and the project can't be put into build/msw and store objects in
build/msw/something. This *must* be fixed! -->
<if cond="FORMAT=='cbuilderx'">
<set var="WXUNIV">0</set>
<set var="MONOLITHIC">1</set>
<set var="SRCDIR">.</set>
<set var="TOP_SRCDIR">$(SRCDIR)/$(WXTOPDIR)</set>
<set var="SHARED">0</set>
</if>
<!-- DigitalMars make is braindead, it doesn't have conditional
processing: -->
<if cond="FORMAT=='dmars'">
<set var="RUNTIME_LIBS">static</set>
<set var="BUILD">debug</set>
<set var="SHARED">0</set>
<set var="WXUNIV">0</set>
<set var="UNICODE">0</set>
<!-- Free version does not distribute OpenGL,
in commercial distribution better use dmars_smake format -->
<set var="USE_OPENGL">0</set>
</if>
<!-- No need for wxUniv on embedded devices (yet): -->
<if cond="FORMAT=='msevc4prj'">
<set var="WXUNIV">0</set>
<set var="UNICODE">1</set>
<set var="MONOLITHIC">1</set> <!-- sic! -->
</if>
</makefile>