clean up of memory debugging macros and chanegs to compile with CW7 (patch 548408)

[wxWidgets.git] / docs / univ / readme.txt

diff --git a/docs/univ/readme.txt b/docs/univ/readme.txt
index ada0d1ac2469237063322d5d59aa3f1caa3d80d2..13a67654692cc8c66fefc6e057cac5e5caad3a6b 100644 (file)
--- a/docs/univ/readme.txt
+++ b/docs/univ/readme.txt
@@ -1,10 +1,10 @@
-                             wxUniversal README
-                             ==================
+                              wxUniversal README
+                              ==================
 
  Welcome to wxUniversal!
 
  Acknowledgements: wxUniversal wouldn't have been written without the
-generuous support of SciTech Software. Many thanks to Kendall Benett and
+generous support of SciTech Software. Many thanks to Kendall Bennett and
 Tom Ryan!
 
 0. Introduction
@@ -13,29 +13,29 @@ Tom Ryan!
  wxUniversal is a port of wxWindows which implements the various GUI controls
 by drawing them itself (using low level wxWindows classes). Please see
 
-                    http://www.wxwindows.org/wxuniv.htm
+                     http://www.wxwindows.org/wxuniv.htm
 
 for more details about it.
 
  The advantage of wxUniversal is that you have precise control over the
-controls appearance (it is not always possible to change all aspects of the
+controls' appearance (it is not always possible to change all aspects of the
 native controls) and the theme support: the same program may be changed to
-look completely differently  without changing a single line of its code but
+look completely differently without changing a single line of its code but
 just changing the theme.
 
  Another advantage is that it makes writing ports of wxWindows for other
 platforms (such as OS/2, BeOS or QNX) much simpler, so it is of special
-interest to the people interested in porting wxWindows to another platform.
+interest to people interested in porting wxWindows to another platform.
 
- However, wxUniversal doesn't have the 100% native look and feel unlike the
+ However, wxUniversal doesn't have a 100% native look and feel unlike the
 other wxWindows ports - this is the price to pay for the extra flexibility.
 
-1. Requirments and supported platforms
---------------------------------------
+1. Requirements and supported platforms
+---------------------------------------
 
  wxUniversal is used together with another wxWindows port which provides the
-"low level classes" mentioned above. Currently it can be built either with
-wxMSW or wxGTK. In any case, you should download the sources for the
+"low level classes" mentioned above. Currently it can be built with wxMSW,
+wxGTK or wxX11. In any case, you should download the sources for the
 appropriate toolkit in addition to wxUniversal - in fact, you should download
 them first and then unpack wxUniversal in the same directory.
 
@@ -47,7 +47,7 @@ toolkit.
 
 a) Using Visual C++ 6.0
 
-   Simply open the src/wxUniv.dsw file in MSDEV and build it.
+   Simply open the src/wxUniv.dsw file in DevStudio and build it.
 
 b) Cygwin
 
@@ -55,18 +55,39 @@ b) Cygwin
 
 c) Other compilers
 
-   Unfortunately we don't have the makefiles for any other compilers yet.
+   Unfortunately we don't have makefiles for any other compilers yet.
 Please contact us if you would like to help us with creating one for the
 compiler you use.
 
+Note that you can use the wxUniversal classes, wxMSW and MicroWindows (from
+Century Software) to build a different variant of wxUniversal than that
+documented here. Please see docs/univ/readme.txt for further information.
+
 3. Installing under Unix
 ------------------------
 
-Please refer to the installation instructions for wxGTK. The only change for
-wxUniversal is that you must add "--enable-univ" switch to the configure
-command line.
+Please refer to the installation instructions for wxGTK or wxX11. The only
+change for wxUniversal is that you must add "--enable-universal" switch to
+the configure command line and for wxX11 even this is unnecessary, i.e. it
+is enabled by default.
+
+4. Running wxUniv programs
+--------------------------
+
+wxUniv programs all honour the standard option "--theme" which allows to
+specify the theme to be used by name. Currently there are the following
+themes:
+
+a) win32 -- Windows 95 look and feel
+b) metal -- based on win32 but with gradient backgrounds
+c) gtk   -- GTK+ 1.x standard look and feel
 
-4. Documentation and support
+Thus, to launch a program using gtk theme you may do "./program --theme=gtk".
+
+It is also possible to change the default theme for all wxUniv applications
+at once by setting the environment variable WXTHEME to the theme name.
+
+5. Documentation and support
 ----------------------------
 
  Please note that wxUniversal is not as mature as the other wxWindows ports
@@ -87,12 +108,11 @@ itself, namely:
 * WWW page: http://www.wxwindows.org/
 
 
- Hope you will find wxUniversal useful!
-
-                                                                Vadim Zeitlin
+ Hope you find wxUniversal useful!
 
+                                                                 Vadim Zeitlin
 
-This file is accurate for the version 2.3.2 of wxUniversal. It was last
-modified on Dec 11, 2001.
 
+This file is accurate for the version 2.3.3 of wxUniversal. It was last
+modified on Apr 15, 2002.