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

			      wxUniversal README
			      ==================

 Welcome to wxUniversal!

 Acknowledgements: wxUniversal wouldn't have been written without the
generous support of SciTech Software. Many thanks to Kendall Benett and
Tom Ryan!

0. Introduction
---------------

 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

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
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
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 people interested in porting wxWindows to another platform.

 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. 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
appropriate toolkit in addition to wxUniversal - in fact, you should download
them first and then unpack wxUniversal in the same directory.

 The requirments for wxUniversal are the same as for the underlying low level
toolkit.

2. Installing under Win32
-------------------------

a) Using Visual C++ 6.0

   Simply open the src/wxUniv.dsw file in DevStudio and build it.

b) Cygwin

   Please refer to the Unix section below

c) Other compilers

   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.

4. Documentation and support
----------------------------

 Please note that wxUniversal is not as mature as the other wxWindows ports
and is currently officially in alpha stage. In particular, it is not really
intended for the end users but rather for developers at the current stage and
this is why we don't provide any binaries for it.

 There is no separate documentation for wxUniversal, please refer to wxWindows
documentation instead.

 Support for wxUniversal is available from the same places as for wxWindows
itself, namely:

* Usenet newsgroup comp.soft-sys.wxwindows

* Mailing lists: see http://lists.wxwindows.org/ for more information

* WWW page: http://www.wxwindows.org/


 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.
Commit	Line	Data
2bcdcf7e VZ	1	wxUniversal README
	2	==================
	3
	4	Welcome to wxUniversal!
	5
	6	Acknowledgements: wxUniversal wouldn't have been written without the
b59da6c2	7	generous support of SciTech Software. Many thanks to Kendall Benett and
2bcdcf7e VZ	8	Tom Ryan!
	9
	10	0. Introduction
	11	---------------
	12
	13	wxUniversal is a port of wxWindows which implements the various GUI controls
	14	by drawing them itself (using low level wxWindows classes). Please see
	15
	16	http://www.wxwindows.org/wxuniv.htm
	17
	18	for more details about it.
	19
	20	The advantage of wxUniversal is that you have precise control over the
b59da6c2	21	controls' appearance (it is not always possible to change all aspects of the
2bcdcf7e	22	native controls) and the theme support: the same program may be changed to
b59da6c2	23	look completely differently without changing a single line of its code but
2bcdcf7e VZ	24	just changing the theme.
	25
	26	Another advantage is that it makes writing ports of wxWindows for other
	27	platforms (such as OS/2, BeOS or QNX) much simpler, so it is of special
b59da6c2	28	interest to people interested in porting wxWindows to another platform.
2bcdcf7e	29
b59da6c2	30	However, wxUniversal doesn't have a 100% native look and feel unlike the
2bcdcf7e VZ	31	other wxWindows ports - this is the price to pay for the extra flexibility.
2bcdcf7e VZ	32
b59da6c2 JS	33	1. Requirements and supported platforms
b59da6c2 JS	34	---------------------------------------
2bcdcf7e VZ	35
	36	wxUniversal is used together with another wxWindows port which provides the
	37	"low level classes" mentioned above. Currently it can be built either with
	38	wxMSW or wxGTK. In any case, you should download the sources for the
	39	appropriate toolkit in addition to wxUniversal - in fact, you should download
	40	them first and then unpack wxUniversal in the same directory.
	41
	42	The requirments for wxUniversal are the same as for the underlying low level
	43	toolkit.
	44
	45	2. Installing under Win32
	46	-------------------------
	47
	48	a) Using Visual C++ 6.0
	49
b59da6c2	50	Simply open the src/wxUniv.dsw file in DevStudio and build it.
2bcdcf7e VZ	51
	52	b) Cygwin
	53
	54	Please refer to the Unix section below
	55
	56	c) Other compilers
	57
b59da6c2	58	Unfortunately we don't have makefiles for any other compilers yet.
2bcdcf7e VZ	59	Please contact us if you would like to help us with creating one for the
	60	compiler you use.
	61
b59da6c2 JS	62	Note that you can use the wxUniversal classes, wxMSW and MicroWindows (from
	63	Century Software) to build a different variant of wxUniversal than that
	64	documented here. Please see docs/univ/readme.txt for further information.
	65
2bcdcf7e VZ	66	3. Installing under Unix
	67	------------------------
	68
	69	Please refer to the installation instructions for wxGTK. The only change for
	70	wxUniversal is that you must add "--enable-univ" switch to the configure
	71	command line.
	72
	73	4. Documentation and support
	74	----------------------------
	75
	76	Please note that wxUniversal is not as mature as the other wxWindows ports
	77	and is currently officially in alpha stage. In particular, it is not really
	78	intended for the end users but rather for developers at the current stage and
	79	this is why we don't provide any binaries for it.
	80
	81	There is no separate documentation for wxUniversal, please refer to wxWindows
	82	documentation instead.
	83
	84	Support for wxUniversal is available from the same places as for wxWindows
	85	itself, namely:
	86
	87	* Usenet newsgroup comp.soft-sys.wxwindows
	88
	89	* Mailing lists: see http://lists.wxwindows.org/ for more information
	90
	91	* WWW page: http://www.wxwindows.org/
	92
	93
b59da6c2	94	Hope you find wxUniversal useful!
2bcdcf7e VZ	95
	96	Vadim Zeitlin
	97
	98
	99	This file is accurate for the version 2.3.2 of wxUniversal. It was last
	100	modified on Dec 11, 2001.
	101
	102