The UX2 Developers Build System for OS/2
------------------------------------------
Assuming you have the ux2bs_inst.cmd script already, edit
the drive letters at the top to reflect your drives where (osrt)
OS/2 is installed and where you want to install (uxrt) the Unix 
environment. UX2 installs many directories in root so be forwarned.
A seperate partition or drive is highly recommended.

It will create these in your (uxrt) root directory:

   bin/                        
   boot/                       
   dev/                         
   emx/
   etc/                         
   home/                        
   install/                     
   lib/  
   ports/                       
   proc/                       
   root/                       
   sbin/                        
   tmp/                        
   usr/                        
   var/ 
   XFree86/                        

If any of the above directories exist rename them or delete them.


Prerequisites
--------------------------------------------------
None except a clean environment (config.sys) devoid of all Unix
environmental settings including EMX. The following is however 
highly recommended.

Replace (%uxrt%) with your drive letter.

LIBPATH=%uxrt%\emx\dll;%uxrt%\emx\lib;%uxrt%\lib;%uxrt%\usr\lib;%uxrt%\usr\local\lib;%uxrt%\XFree86\lib;%LIBPATH%
SET PATH=%uxrt%\emx\bin;%uxrt%\bin;%uxrt%\usr\bin;%uxrt%\usr\local\bin;%uxrt%\sbin;%uxrt%\usr\sbin;%uxrt%\XFree86\bin;%PATH%
SET HELP=%uxrt%\emx\help;
SET BOOKSHELF=%uxrt%\emx\book;
SET USE_HOSTS_FIRST=1
SET HELPNDX=emxbook.ndx+emxdev.ndx+emxlib.ndx+emxgnu.ndx+emxbsd.ndx
SET EMXBOOK=emxdev.inf+emxlib.inf+emxgnu.inf+emxbsd.inf
SET INFOPATH=%uxrt%/emx/info;%uxrt%/usr/info;%uxrt%/usr/local/info
SET X11ROOT=%uxrt%
DEVICE=%uxrt%\XFree86\lib\xf86sup.sys
SET XSERVER=%uxrt%/XFree86/bin/XFree86.exe
SET DISPLAY=%hostname%:0.0
SET USER=root
SET LOGNAME=root
SET TERM=ansi-color-3
SET TERMCAP=%uxrt%/etc/termcap
SET HOME=%uxrt%\root

This will provide seamless operation between UX2, XFree86, 
and the OS/2 Desktop including 3rd party applications like Python.


Install
-----------------------------------------------------
Edit the drive letters at the top of the script to reflect your drives
where (osrt) OS/2 is installed and where you want to install (uxrt) the 
Unix environment. Then run ux2bs_inst. It will download and install the
required packages and build several libraries before finishing up with
Perl. Two shell desktop icons will be made. The UX2BS Shell which is the
default gcc-2.8.1 environment. The GCC-3.2.1 Shell is set up for the 
GCC-3.2.1 environment. 


User-defined Enviroment settings
------------------------------------------------------
User defined env settings can be added to etc\ux2_local which is system
wide. Specific GCC-3.2.1 settings can be added to etc\gcc_local. The system 
is designed to be used with the desktop shells. The ux2 environment can be 
used at anytime by a regular OS/2 window by calling \sbin\ux2_env first. 
Using GCC-3.2.1 REQUIRES the desktop shell as the specific settings are 
defined in the shell itself. 


Updates
------------------------------------------------------
Your Build System can be updated at anytime with the latest changes by
running ux2bs_update in the default shell. The ports tree can also be made 
current by running ports_update.


Using the Ports tree
-------------------------------------------------------
What is the ports tree you ask? Rooted in the FreeBSD tradition it allows 
the developer, hobbyist or anyone for that matter to build his/her own ports
from source with a single command. The ports are named by directories so
cd to \ports\gmp for example. Do a 'clean' to ensure the old workdir is removed
and to build the port just run 'build gmp'. What it does is check for the 
existance of the source in your local \install\archives. If it does not exist
it downloads it, extracts it, builds and installs it. It's really that simple.
You can do a 'clean' afterwards to remove the workdir. As of this writing we 
have four working ports in the tree. Perl, gmp, gnugdbm, and gnuufc. 


Reinstalls
--------------------------------------------------------
If you should ever decide to reinstall the UX2BS for any reason,
delete everything *except* \install\archives. This will save you
the expense of redownloading it again. The install script checks 
for the existance of it and will continue the install. As of this
writing there is no way to fully refresh it automatically. Running 
baseline_fixup will however keep the misc and test directories 
current so you will have to maintain the other subdirectories 
yourself which seldom change. 


Websites and Mailists
-------------------------------------------------------- 
UnixOS2.org         http://unixos2.org/
UX2 Build System    http://os2ports.com/sections/ux2bs	
 
UX2BS Mailing List  http://os2ports.com/mailman/listinfo/ux2bs
OS2-Unix Developers List    majordomo@mail.warpix.org


 Enjoy!
 
The UnixOS2.org Team