This repository is the offical place to hold all the source codes around the PC/GEOS graphical user interface and its sophisticated applications. It is the source to build SDK and release version of PC/GEOS. It is the place to collaborate on further developments.
The base of this repository is the source code used to build Breadbox Ensemble 4.13 reduced by some modules identified as critical in regard to the license choosen for the repository.
While now the WATCOM is used to compile the C parts, the full SDK is available for Windows and Linux.
The SDK requires "sed" (https://en.wikipedia.org/wiki/Sed) and "perl" (https://en.wikipedia.org/wiki/Perl) to be installed. Both are pre-installed in most Linux-distributions. Windows-users should install "sed" by adding the usr/bin of the official git distribution (https://git-scm.com) to the path (or Cygwin), and should use the perl-variant "Strawberry Perl" (http://strawberryperl.com/).
On Linux if you want to use swat for debugging with good system integration is is required to install xdotools package. It ensures swat receives the keyboard focus once needed.
C:\WATCOM-V2
WATCOM=c:\WATCOM-V2
BASEBOX=basebox
to use the advanced emulator backend from pcgeos-basebox if it is on the executable path, alternatively you may provide the full path to the executable as wellROOT_DIR
to the root of the checkoutLOCAL_ROOT
to a local working directory (can be empty at first, but should be under pcgeos
, so you can use it for development of your own apps as well)C:\WATCOM-V2\binnt
to your system path variableadd sed and perl to path variable - note the order to avoid loading the wrong Perl version. Example:
set WATCOM=c:\WATCOM-V2
set ROOT_DIR=C:\Geos\pcgeos
set LOCAL_ROOT=c:\Geos\pcgeos\Local
set BASEBOX=basebox
PATH %WATCOM%\binnt;%ROOT_DIR%\bin;C:\Geos\pcgeos-basebox\binnt;%PATH%;c:\Program Files\Git\usr\bin
Document is work in progress.... stay tuned!
Build pmake tool:
cd %ROOT_DIR%/Tools/pmake/pmake
wmake install
Build all the other SDK Tools:
cd %ROOT_DIR%/Installed/Tools
pmake install
Build all PC/GEOS (target) components:
cd %ROOT_DIR%/Installed
pmake
Build the target environment:
cd %ROOT_DIR%/Tools/build/product/bbxensem/Scripts
perl -I. buildbbx.pl
Launch the target environment in dosbox:
%ROOT_DIR%/bin/target
quit
at the "=>" prompt to detach the debugger and launch PC/GEOS stand-alonec
to launch with the debugger running in the background (slower)If you want to customize the target environment settings only for yourself, you should not change the file %ROOT_DIR%/bin/basebox.conf.
PC/GEOS comes with extensive technical documentation that describes tools, programming languages and API calls from the perspective of an SDK user. This documentation can be found in the TechDocs
folder and is available in Markdown format.
You can find a browseable, searchable version of the documentation here: https://bluewaysw.github.io/pcgeos/
We are on https://bluewaysw.slack.com/ for more efficient collaboration. Please register at https://blog.bluewaysw.de for MyGEOS and use the Slack section and receive access to our developer community. Welcome!