SQLUG

comp003.gif - 2467 Bytes

The Scottish QL & Linux User Group


Turbo Program Suite

Introduction

Introduction

TURBO is a system for compiling SuperBASIC programs into fast machine code. It even speeds up fast SMSQ/E S*BASIC programs.

The TURBO Package consists of the compiler itself and a set of associated programs. The files are held in six groups of zipped files.

TRBOPnn.zip - the compiler itself
TRBOTnn.zip - the files for Turbo TK Code
TRBOXnn.zip - the associated programs (set 1)
TRBOMnn.zip - the manuals
TRBOSnn.zip - the source code
TPTRPnn.zip - the associated programs (set 2)

In the file names "nn" is the version number of the file. This starts at 01 and is increased by one each time it is updated. Since it is quite possible that some of the zipped file have more updates than others the most recent values of "nn" may not be the same for all files.

THE COMPILER ITSELF

The programs inside trbop13_zip are:

PARSER_TASK produces intermediate code
CODEGEN_TASK produces the compiled program
UTILITY_TASK contains a configurator for the TK_CODE
T_CONFIG_DATA together with . .
T_CONFIG_LOAD . . set Standard Config blocks in a compiled program CHANGES_TXT details the changes in each version

The files inside Trbot08_zip are:

TURBO_TK_CODE the full set of Turbo TK Code extras
TURBO_SMS_CODE the subset for SMSQ/E
TURBO_REM_CODE the subset for inclusion in compiled tasks
TURBOBASE_ASM the source code
UTILITY_TASK contains a configurator for TK Code

THE ASSOCIATED PROGRAMS (SET 1)trbox06_zip

These associated programs are not essential for compilation, but include files both of use and of interest. They are:

TASCOM3.00 Each of these can turn . .
TASCOM3.01 . . an executable task . .
TASCOM3.10 . . into a SuperBASIC . .
TASCOM3.11 . . Keyword
DATA_SPACE_TASK To change a task's dataspace
LIBRARY_MANAGER To extract routines from . .
TURBO_TK_DEMOS . . A set of useful procedures and functions
MAKE_MODULES Splits a SuperBASIC program into modules
ADJ_DS To change a task's stack and data space.

THE MANUALS Trbom10_zip

The manuals consist of two groups. A member of the first group contains the instructions on how to use a program in the TURBO Package. A member of the second group contains interesting, but not essential, information.

Group 1

TURBOTOC_TXT The Table Of Contents of the main manual for TURBO
TURBOS1_TXT The first of four Sections of the main manual
TURBOS2_TXT The second of four Sections of the main manual
TURBOS3_TXT The third of four Sections of the main manual
TURBOS4_TXT The last of the four Sections of the main manual
TURBOTK_TXT Details the extensions in TURBO_TK_CODE
UTILITY_TXT Manual for UTILITY_TASK
T_CONFIG_TXT Manual for T_CONFIG_DATA and T_CONFIG_LOAD
TASCOM_TXT Manual for TASCOM
TURBODEM_TXT Describes the contents of TURBO_TK_DEMOS

Group 2

TURBOREF_TXT Error Messages and TURBO_TK_CODE commands in alphabetical order.
LINKLOAD_TXT Examples on how to use LINK_LOAD
INTFILE_TXT Simon Goodwin's explanation of the intermediate code produced by PARSER_TASK for CODEGEN_TASK
TURBOREP_TXT A Report by Simon Goodwin underlying TURBO's design

THE ASSOCIATED PROGRAMS (SET 2)

The files in the latest version of the complete system, called TurboPTR, for the writing of programs intended to be run under the Pointer Environment which can also be compiled by TURBO. Anyone interested is encouraged to read the file called TurboPTR_overview in TurboPTR in the previous page which leads into an explanation of the other 52 or so files involved.

THE SOURCE CODE

It is good practice to make available the source code for programs which are freely available. The source code is useful for two things; it can help a user understand how the system works; it can also allow a user to put forward detailed suggestions for correction or improvement. The source code will be found inside the file trbos15_zip

HOW TO GET STARTED WITH TURBO

It is recommended that a first-time user look at the first two files listed in Group 1 of the manuals. There should be enough information there to start compiling simple programs.

Back

Meetings
Members
Magazine
Articles
Programs