1666f58bc6
Since OS X 10.12 it has been named macOS so it makes sense to reference it in documentation as such, even when it sometimes refers to older versions which were called (Mac) OS X.
124 lines
4.3 KiB
Plaintext
124 lines
4.3 KiB
Plaintext
wxBase README
|
|
=============
|
|
|
|
NB: this file applies to wxBase library only. If you are using a GUI version
|
|
of wxWidgets, please refer to the documentation in the appropriate
|
|
subdirectory (msw, gtk, motif &c).
|
|
|
|
|
|
Welcome to wxBase!
|
|
|
|
0. Introduction
|
|
---------------
|
|
|
|
wxBase is the library providing most of the non-GUI classes of the wxWidgets
|
|
cross-platform C++ framework. wxBase has some generic classes such as yet
|
|
another C++ string class, typesafe dynamic arrays, hashes and lists and, more
|
|
excitingly, wxDateTime -- a very flexible and powerful class for manipulating
|
|
the dates in the range of 580 million years with up to millisecond precision.
|
|
Another useful class not present in the standard C++ library is wxRegEx which
|
|
allows you to use regular expressions for string matching and replacing.
|
|
|
|
There are also classes for writing portable programs in C++ painlessly which
|
|
encapsulate things like files (and their names), directories, processes,
|
|
threads, sockets and much more. Some of the other utility classes allow you to
|
|
parse the command line, limit the number of instances of your program
|
|
executing simultaneously (portably!) and so on.
|
|
|
|
|
|
1. Requirements and supported platforms
|
|
--------------------------------------
|
|
|
|
wxBase can be compiled and used under Win32, mostly any modern Unix system
|
|
(including macOS), VMS and BeOS (this release couldn't be tested under
|
|
these platforms so you might encounter some problems but they should be easy
|
|
to solve -- please contact us in this case!)
|
|
|
|
It is written without using any modern C++ features (such as templates,
|
|
exceptions, namespaces) for maximal portability and so you shouldn't have
|
|
problems compiling it with any C++ compiler at all. However, we only provide
|
|
the project files for Microsoft Visual C++ 6.0 and make files for Borland C++
|
|
for Win32 (any contributions are welcome!) -- but our Unix makefiles should
|
|
work with any compiler.
|
|
|
|
|
|
2. Installing under Win32
|
|
-------------------------
|
|
|
|
Please note that wxBase can be compiled in different configurations under
|
|
Win32: as a static or shared library, in debug or release mode and in ANSI
|
|
or Unicode mode for a total of 8 possibilities.
|
|
|
|
a) Using Visual C++ 6.0
|
|
|
|
Simply open the build/msw/wx_base.dsp file in MSDEV and build it. When it is
|
|
done you can also open samples/console/console.dsp project and build it as
|
|
well.
|
|
|
|
b) Cygwin
|
|
|
|
Please refer to the Unix section below.
|
|
|
|
Note that gcc's precompiled headers do not work on current versions of
|
|
Cygwin. If your version of Cygwin is affected you will need to use the
|
|
--disable-precomp-headers configure option.
|
|
|
|
c) Borland
|
|
|
|
Please refer to the docs/msw/install.md. The console sample compiles and
|
|
runs but does not pass all tests.
|
|
|
|
d) Other compilers
|
|
|
|
Unfortunately we don't have the makefiles for any other compilers yet.
|
|
Please contact us if you would like to help us with creating one for the
|
|
compiler you use.
|
|
|
|
|
|
3. Installing under Unix/BeOS
|
|
-----------------------------
|
|
|
|
Please note that GNU make may be required to build wxBase, please use it if
|
|
you get any errors from the native Unix make.
|
|
|
|
The recommended way to build wxBase is:
|
|
|
|
% cd ..../wxWidgets
|
|
% mkdir base-release # or any other directory of your liking
|
|
% cd base-release
|
|
% ../configure --disable-gui
|
|
# ignore the error messages about missing samples
|
|
% make
|
|
% make install
|
|
|
|
You can also do:
|
|
|
|
% mkdir base-debug
|
|
% cd base-debug
|
|
% ../configure --disable-gui --enable-debug
|
|
% make
|
|
|
|
To build the sample then cd to samples/console and make there.
|
|
|
|
|
|
4. Documentation and support
|
|
----------------------------
|
|
|
|
The console sample provided with this distribution tests most (but not all)
|
|
wxBase classes. It doesn't do anything useful per itself but you may want to
|
|
look at its code to see examples of usage of the class you are interested in.
|
|
|
|
There is no separate documentation for wxBase, please refer to wxWidgets
|
|
documentation instead.
|
|
|
|
Support for wxBase is available from the same places as for wxWidgets itself,
|
|
namely:
|
|
|
|
* Website: https://www.wxwidgets.org/
|
|
* Mailing Lists: https://www.wxwidgets.org/support/mailing-lists/
|
|
|
|
|
|
Hope you will find wxBase useful!
|
|
|
|
Vadim Zeitlin
|