This file describes the installation of wxWindows 1.61b under
VMS from the 'ready to use' ZIP-file (wxvmsrdy.zip).

//////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////
Installing on VMS
//////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////

General
-------
This port of wxWindows 1.61b is for the DEC C++ compiler on VMS 
for ALPHA and VAX. I'm using an ALPHA, so I cannot guarantee for 
no problems on a VAX, but if there are problems, they will be 
minor ones (mostly with include files etc.).

This port is not a complete one, but all graphical features work.
Timer works. Most other things work. 
The toolbar works fine. All(!) samples (except the IPC one) work.
Things which do not work: IPC (not yet because I don't have sockets),
PROLOGIO and most other utilities (I'm working on this) and the 
contrib stuff.

Most problems occur because of the directory structure and
filenaming of VMS. Beside this, some system dependent headerfiles
of UNIX are not present under VMS.

The directory structure is the same as under UNIX.

Be warned: The DEC C++ compiler is very slow. On a VAXstation 3100 the
compilation time is about 24 hours (!!!). It also needs much much 
memory (surely you have to raise your pagefile size ;-).

Files
-----
The files in this archive are READY TO USE!!!
I have only included the files which work under VMS and left
off the MSW files!
Maybe you have to do a textfile-conversion from DOS/UNIX to VMS.

Environment
-----------
!!!!! IMPORTANT !!!!!
Under all circumstances you should make the following definition
in your 'login.com' file:

$ make == "mms/descrip=makefile.vms/macro=(ALPHA=1,WXDIR=[hammes.wxw161)"

Without this, nothing works :-)
Instead of ALPHA=1 you can use VAX=1 if you are on a VAX.
The WXDIR should point to the directory of wxWindows and you MUST omit the
trailing ']' !!! Replace the string 'hammes.wxw161' with the correct one
for your system.

In $(WXDIR).src] we have the two files 'makevms.env' and 'motif.opt'. 
They define options and locations of directories and libraries. 
Edit them for your system. For the first try no editing is necessary.
'makevms.env' will be included in the makefiles so you need to
define the things only once.

Makefiles
---------
I have included makefiles with the name 'makefile.vms' in several directories. 
If you have defined the above symbol 'make' and have 'mms' installed on
your system you need only to type 'make' as in UNIX.

N.b.: Instead of having makefiles in [.src.x] AND [.src.base] we only have
      one makefile in [.src.x] which makes the whole library.

You can look at the makefiles and build similar ones for other libraries and
for executables.

Compiling
---------
If everything goes right, you have only to type 'make' in the 
top wxWindows directory and then go to sleep or something else. 
This global make-command will build the wxWindows library, 
the toolbar library, the wxstring library and all sample programs.

As stated above this will take a lot of time (1-2 days :-() for
compiling all components). On an ALPHA it will be somewhat
faster.

VMS port was done by Stefan Hammes (stefan.hammes@urz.uni-heidelberg.de).
In the source code I have marked my changes and additions with 'steve'
for the old changes and 'steve161' for the newest changes.

If you have problems, please send an E-mail to me. I wish you success,

Stefan Hammes



-----------------------------------------------------------------
-----------------------------------------------------------------
-----------------------------------------------------------------
-----------------------------------------------------------------
original readme.txt



wxWindows 1.61 beta (b)
-----------------------

March 8th, 1995
---------------

DOS distribution
----------------

dos/install.txt		; Installation notes
dos/wx161_1.zip		; Main distribution: zip one of two
dos/wx161_2.zip		; Main distribution: zip two of two

dos/wx161hlp.zip	; Documentation in WinHelp format
dos/wx161ps.zip		; Documentation in PostScript format
dos/wx161xlp.zip	; Documentation in wxHelp format

itsybits.cc		; Patch: copy to contrib/itsybits for Borland compilation
lex_yy.c, y_tab.c	; For DOS comilation, eliminates the need to
			; install FLEX/YACC: copy to utils/prologio/src.
UNIX distribution
-----------------

unix/install.txt	; Installation notes
unix/wxinstal		; (Incomplete) installation script
unix/wx161.tgz		; Main distribution
unix/wx161_hlp.tgz	; Documentation in WinHelp format
unix/wx161_ps.tgz	; Documentation in PostScript format
unix/wx161_xlp.tgz	; Documentation in wxHelp format

This is essentially beta (a) with a few minor modifications, mostly
bug fixes for Borland compilation. I've started splitting the
documentation from the main distribution so you don't need to download
it all.

Many things are not yet completed, such as the wxinstal script;
so please unarchive the files yourself before running
wxinstal since it doesn't know about the new file names.

WinSock support has yet to be added - maybe in a couple of weeks. Also
coming up in the *next* release are contributed enhancements for static
items in panels, a virtual listbox, and X canvas optimisations.

PLEASE NOTE that you may not need to download this beta
if you have beta (a) installed successfully. It doesn't add
anything radically new.

Sorry, there is currently no patch file to upgrade from an earlier
version.

Regards,

Julian