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
 
  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
 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
 
  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
 
 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
 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
 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.
 
 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
 
  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.
 
 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
 
 
 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
 
 
 b) Cygwin
 


@@ -55,18 +55,39 @@ b) Cygwin
 
 c) Other compilers
 
 
 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.
 
 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
 ------------------------
 
 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
 ----------------------------
 
  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/
 
 
 * 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.