ceec2216bd
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
|
||
|---|---|---|
| art | ||
| build | ||
| contrib | ||
| debian | ||
| demos | ||
| distrib | ||
| docs | ||
| include | ||
| lib | ||
| locale | ||
| misc | ||
| samples | ||
| src | ||
| tests | ||
| utils | ||
| wxPython | ||
| .cvsignore | ||
| acinclude.m4 | ||
| aclocal.m4 | ||
| autoconf_inc.m4 | ||
| autogen.sh | ||
| BuildCVS.txt | ||
| config.guess | ||
| config.sub | ||
| configure | ||
| configure.in | ||
| descrip.mms | ||
| difflast.pl | ||
| install-sh | ||
| make-deb | ||
| Makefile.in | ||
| mkinstalldirs | ||
| regen | ||
| setup.h_vms | ||
| setup.h.in | ||
| version-script.in | ||
| wx-config-inplace.in | ||
| wx-config.in | ||
| wxBase.spec | ||
| wxGTK.spec | ||
| wxMGL.spec | ||
| wxMotif.spec | ||
| wxwin.m4 | ||
| wxWINE.spec | ||
| wxX11.spec | ||
wxWidgets 2.5.2 --------------- *** Please note that this is an UNSTABLE DEVELOPMENT SNAPSHOT. *** Unless you need the new features and bug fixes, you may wish to *** use the official 2.4.x stable series. You are still encouraged *** to try the releases from 2.5.x branch, of course, and unstable *** doesn't mean that they crash all the time -- just that the API *** may change in backwards incompatible way. If this doesn't frighten *** you, do try this release and please let us know what you think! Welcome to wxWidgets, a sophisticated cross-platform C++ framework for writing advanced GUI applications using (where possible) the native controls. In addition to common and advanced GUI facilities such as frames, scrolling windows, toolbars, tree controls, icons, device contexts, printing, splitter windows and so on, there are wrappers for common file operations, and facilities for writing TCP/IP applications, thread handling, and more. Where certain features are not available on a platform, such as MDI and tree controls on Unix, they are emulated. A detailed 1800-page reference manual is supplied in HTML, PDF and Windows Help form: see the docs hierarchy. For a quick start, point your Web browser at docs/html/index.htm for a list of important documents and samples. Changes in this release ----------------------- Please see changes.txt for details. Platforms supported ------------------- wxWidgets currently supports the following platforms: - Windows 95/98/ME, Windows NT, Windows 2000, Windows XP, Pocket PC - Most Unix variants with GTK+ 1 and GTK+ 2 - Most Unix variants with X11 (beta) - Most Unix variants with Motif/Lesstif - MacOS 9.x and 10.x using Carbon (10.3 and above preferred) - MacOS 10.x using Cocoa (beta) - OS/2 (beta) Most popular C++ compilers are supported; see the install.txt file for each platform (available via docs/html/index.htm) for details. See also http://www.wxwidgets.org/platform.htm. Files ----- The distribution is available in archive formats appropriate to the target system. See the download pages for details. Installation ------------ wxWidgets 2 needs to be compiled before you can test out the samples or write your own applications. For installation information, please see the install.txt file in the individual directories: docs/msw docs/gtk docs/motif docs/mac docs/x11 docs/mgl docs/os2 Licence information ------------------- For licensing information, please see the files: docs/preamble.txt docs/licence.txt docs/licendoc.txt docs/gpl.txt docs/lgpl.txt Although this may seem complex, it is there to allow authors of proprietary/commercial applications to use wxWidgets in addition to those writing GPL'ed applications. In summary, the licence is LGPL plus a clause allowing unrestricted distribution of application binaries. To answer a FAQ, you don't have to distribute any source if you wish to write commercial applications using wxWidgets. However, if you distribute wxGTK or wxMotif (with Lesstif) version of your application, don't forget that it is linked against GTK+ (or Lesstif) which is covered by LGPL *without* exception notice. Under Linux systems your app is probably linked against LGPL glibc as well. Please read carefully LGPL, section 6. which describes conditions for distribution of closed source applications linked against LGPL library. Basically you should link dynamically and include source code of LGPL libraries with your product (unless it is already present in user's system - like glibc usually is). If compiled with --enable-odbc (Unix only), wxWidgets library will contain iODBC library which is covered by LGPL. If you use TIFF image handler, please see src/tiff/COPYRIGHT for libtiff licence details. If you use JPEG image handler, documentation for your program should contain following sentence: "This software is based in part on the work of the Independent JPEG Group". See src/jpeg/README for details. If you use wxRegEx class on a system without native regular expressions support (i.e. MS Windows), see src/regex/COPYRIGHT file for Henry Spencer's regular expression library copyright. If you use wxXML classes or XRC, see src/expat/COPYING for licence details. Documentation ------------- See docs/html/index.htm for an HTML index of the major documents. See docs/changes.txt for a summary of changes to wxWidgets 2. See docs/tech for an archive of technical notes. The wxWidgets bug database can be browsed at: http://sourceforge.net/bugs/?group_id=9863 The Windows help files are located in docs/winhelp. The PDF help files are located in docs/pdf. Further information ------------------- The wxWidgets Web site is located at: http://www.wxwidgets.org The main wxWidgets ftp site is at: ftp://biolpc22.york.ac.uk/pub A wxWidgets CD-ROM with the latest distribution plus an HTML front-end and hundreds of MB of compilers, utilities and other material may be ordered from the CD-ROM page: see the wxWidgets web site. Have fun! The wxWidgets Team, May 2004