Welcome to SBTools:

SBTools is a set of ObjectPAL utilities used as a model for demonstrating
many interesting ObjectPAL techniques.  By themselves they provide a 
simple means of documenting an application, but their main purpose
is to demonstrate ObjectPAL techniques that may be useful in a variety
of situations.  The following README text briefly describes the main 
functionality of each of the programs to help get you started.


SBDoc'it
========
SBDocIt is a table documentation utility.  It's main purpose is to allow
the developer / user a means for displaying the following information about
a table or group of tables:
	Field structure
	Referential Integrity Relationships
	Passwords
	Table properties (particularly physical record size)
	Secondary index names and structures
	Validity checks
	Table lookup definitions

Tables are listed from the current working directory when the program is
invoked.  All aliases will be listed under the 'Path:' drop down edit box.
To select a different directory to choose from, select a different
alias or type in the full path.  As soon as the field is exited, the new
tables will be listed.  (Both the table list and chosen list are reset when
a new path is chosen.)

To select a table:
          double click the mouse on the desired table
          press the space bar while highlighting the desired table
          push the arrow button while highlighting the desired table

Moving the mouse pointer over a button will provide help for that button
in the lower left corner of the screen.

To document the chosen tables, press the Doc'It button.  Each table will be
listed at the bottom of the screen as it is documented and a message will
display at the end to signify completion.

To display the information to the screen, select the desired table from the
chosen list by highlighting it and then press the 'Browse TblDoc' button.
This will move you to page 2 of the form which will display a bank of 5
radiobuttons.  Select the button matching the desired information to
display and press the 'Return' button to return to page 1.

To print the information in report format to the screen or printer do
the following:
		Select File | PrinterSetup from the main menu to
		select your printer.

		Select Scr | Prn for screen or printer

		Press the appropriate button for printing

		Select the report(s) and print method by which to
		print (Reports may be printed one table per page
		or as much as possible on a page.)


SBCodeview
==========
SBCodeview is a code documentation and delivering tool.  It is meant to
give the developer / user a way to:
	print code listings for any forms, libraries, or scripts
	select which methods to print for an object
	deliver forms/libraries

Forms, libraries, and scripts are listed from the current working directory
when the program is invoked.  All aliases will be listed under the 'Path:'
drop down edit box.  To select a different directory to choose from,
select a different alias or type in the full path.  Press the 'refresh list'
button to have the new forms, libraries, and scripts listed.  (Both the form
list and chosen list are reset when a new path is chosen.)

To select an object (form, library, or script):
          double click the mouse on the desired object
          press the space bar while highlighting the desired object
          push the arrow button while highlighting the desired object

Moving the mouse pointer over a button will provide help for that button
in the lower left corner of the screen.

Press the first button of the first row (will say 'Generate code listing to
a table ...') to send all code for the chosen objects to a table.

The second and third buttons of the first row ('Print Setup' & 'Browse Source')
will work with the data generated with the 'Generate code listing to a table'
button.

'Print Setup' allows the user to choose which methods will print.

'Browse Source' allows the user to see a listing of each object that has code
for a selected object and which methods within that object have code.  By
selecting the desired method from this page, another page will appear
displaying the actual code for the selected method for the selected object
for the selected form/library/script.


Press the first button of the second row (will say 'Generate code listing
to a file ...') to send all code for the chosen objects to a file.  A dialog
box will first appear to ask for a name of a file to write to.  The default
file name is SRCCODE.TXT.

The 'View Source' button will attempt to load the last file written to into
the Window's Notepad program assuming that the file is not too large.  If
it fails, simply use your favorite text editor to view.


The 'Deliver' button allows the user a way to batch deliver all selected
forms and libraries in a directory at once.

To print the information in report format to the screen or printer do
the following:
		Select File | PrinterSetup from the main menu to
		select your printer.

		Select Scr | Prn for screen or printer

		Press the appropriate button for printing



====================================================================

These forms are provided in source format so feel free to SBCodeview
each of them to look at the techniques used in each and make any
modifications that you wish.  The main purpose of these forms is
educational, and as such, require that you use them at your own risk.

We hope that you find them useful as utilities used in everyday
development, as well as, a learning tool demonstrating many interesting
ObjectPAL techniques.

Sincerely,
Softbite International

