TRITON for BlitzBasic2

                converted by Philipp Lonke 12.05.1995

                         All rights reserved

    Triton is (c) by Stefan Zeiger, triton.bb2 is (c) by Ph.Lonke

______________________________________________________________________

NOTICE:

The source code is provided "as is". So I am not responsable for
anything that happens when you use it.

The source code is freely distribuable, as long as it stays together
with the original Triton archive. Whatsoever the BlitzBasic2 source
code is copyrighted by Ph. Lonke and may *not* be modified in any way.

----------------------------------------------------------------------

Contents
                1. Introduction
                2. How to install "triton.bb2"
                3. How to use triton in BB2
                4. The future?
                5. Contact


                           1. Introduction

When Stefan started programming his "triton.library", he asked me to
be a beta-tester of it. I agreed although I didn't use any programming
language of the amiga... I thought it was kind of silly to betatest a
library without being able to program. So I recently found "my"
language: BlitzBasic2  -  but there was no way to use Triton in
BlitzBasic :( 

Finally I decided to do it by myself. This package is the result. In
fact, in just contains the *complete* convertion of all Constants and
structs ('newtypes' in BB2-jargon). And it also includes a bugfix of
amigalibs.res.

There will be more, but I wanted to put the BB2 files in this release,
so it is not complete, but useable.

                   2. How to install "triton.bb2"?

First of all you have to convert the file "triton/programmer/fd/
tritonlib_fd" by "FDConvert". Follow the instructions of this
program!

FDConv should be found in your "BBTools/" directory.

Ok, now, "triton.bb2" comes in to files, one is plain ASCII
(triton.asc) , the other is the pretokenised BB2 source (triton.bb2) .
Start BB2 then load "triton.bb2" and check, that in compiler options
the file "blitzlibs:amigalibs.res" is loaded resident!!

Then select "Create resident" [Amiga ; ] and save the file to 
"blitzlibs:triton.res"

Whenever you want to use triton, insert in the compiler options menu
"blitzlibs:triton.res". You mustn't include "amigalibs.res" because
that will end in a clash of residents - remember, that triton.res
includes amigalibs.res!

                     3. How to use Triton in BB2?

Just take a look at the User-/Programmer's guide. In the next release,
I will add some demo sources which I couldn't do yet, due to a lack of
time...

                            4. The future?

In the next release, I hope I will add the translation of all macros
that make the use of Triton easier. Also there will be some demo
sources. If you have good luck, you will also see a GUIBuilder *ONLY*
for BB2 ... But exspecially this last feature is science fiction right
now ;))

5. Contact

If you want to contact me for writing nice mails or sending some demo
source or whatever you want, you reach me...


   ... via eMail: phips@scout.rhein-main.de

   ... via Snail: Philipp Lonke
                  Rosengartenstraße 10
                  63755 Alzenau
                  Germany