ftp.whtech.com/ftp.whtech.com.tar/ftp.whtech.com/Geneve/mdos/80column_funnelweb/util.txt

Text File | 2006-10-19 | 9KB | 315 lines

.LM 8;RM 72;CE 3
FUNNELWEB Vn 4.40 UTILITIES
---------------------------
.FI

Utility files of various origins
are included on the FUNNELWEB
distribution disk(s).  Files LGEN/S
(for generating templates for XB
programs like LOAD) and LDSR/S for
use with LowLoad from Vn 4.0 are
not included as not a single
comment has been received
concerning their existence or use,
but are still available on request.
This file contains notes on the
following programs
.CE 10

1  CF/CG
2  CP
3  FSAVE
4  LDFW
5  UL
6  CT8K/O
7  LH
8  XB4THLD


(1) Configuration CF
~~~ ~~~~~~~~~~~~~ ~~

CF/CG is used to customize LOAD,
UTIL1/FW and various User List
files to your preference in the
run-time setup of FUNNELWEB.  The
program makes extensive use of
windowed displays and context
sensitive help screens.  The
editing process is tree structured
and is easy to follow along to any
particular item.  Help screens are
often available with a press of "?"
<fctn-I>.  You save system
configuration details for re-use in
data files of which SYSCON is an
example.  CF loads as an Option 2
program file from FUNNELWEB, which
is used as a source of default data
but the program in memory is NOT
altered.  Remember to use Install
before exit and RELOAD to check
your handiwork as the FUNNELWEB
in memory is NOT altered in the
configuration process.


(2) c-Compiler interface CP
~~~ ~~~~~~~~~~~~~~~~~~~~ ~~

Clint Pulley's Vn 4.0 c99 compiler
files C99C/D/E may be loaded
directly as Option 3 program files.
File CP brings user convenience in
working with c99 closer to
FUNNELWEB standards.  Instead of
loading c99 directly, load CP as a
Option 3 program file, and it will
then load C99C/D/E from the same
disk drive.  The return from c99
reloads FW from either the set
pathname or the E/A side boot drive
and preserves the mailbox filename.
If no filename was initially
present, the c99 source code
filename is installed.  See also
FWDOC/SCLL for details of
ScriptLoad which will be found very
handy in assembling and/or loading
the collection of Object files
which usually make up a c99
program.


(3) Save utility FSAVE
~~~ ~~~~~~~~~~~~ ~~~~~

The E/A SAVE utility loads as
absolute code in low memory.
FUNNELWEB is compatible with SAVE,
but does take up its own 6K share
of high memory, so the FSAVE
utility has been prepared to allow
SAVEing of object files loaded by
FUNNELWEB, including into low
memory.  Refer to the E/A manual
for general information.

FSAVE loads as absolute code
overlaying the FUNNELWEB (UL)
system area.  The start and first
executable instruction in your own
code should be DEFed with SFIRST
and the last address DEFed by
SLAST.  Select entry point SAVE and
enter the filename to which your
program is to be SAVEd in E/A
compatible memory image format.

If the Loader has placed files so
that SFIRST is in hi-mem and SLAST
is in low memory, FSAVE will SAVE
high memory from SFIRST to the
FFAHM indicated by the Loader at
UTLTAB+2 and then proceed to SAVE
low memory from >2676 (above the
E/A utilities) to the FFALM.  The
utilities are not included so that
the files will remain compatible
with FUNNELWEB if reloaded under a
different module.

When used with Low-Loaded (Opt 6)
files, FSAVE saves its first module
from low-mem from SFIRST to the top
of lo-mem, nominally >3FFA (at
UTLTAB+4), and then from hi-mem
from >A000 to SLAST.  If SFIRST and
SLAST both point to the same
segment the SAVE is normal.  The
MBSAVE entry adjusts the hi-mem
start to >A050 above the Mailbox.
Use E/A SAVE for addresses in the
>6000 to >8000 cartridge space.

The MEMSAV entry point allows
direct entry of hex address limits
for the memory block to be SAVEd.
The second entry is the address of
the last word (inclusive) to be
saved.  MEMSAV ignores SFIRST and
SLAST but these must have been
DEFed, perhaps by a dummy object
file, for correct LOAD/RUN
operation.

FSAVE indicates the actual length
of the memory block saved in each
file in the second word of the
header block, to a maximum of >1FFA
in each file.  The TI E/A SAVE
utility, amongst its other little
foibles, adds a further 6 bytes to
this count, but the program file
loader in the E/A module believes
the byte count in the header.  In
normal usage the extra 6 bytes,
falsely indicated by E/A SAVE, as
read in from VDP to CPU RAM do not
cause any problems.  FSAVE files
will of course not cause any
problems unless perhaps a loader
incompatible with E/A is used.

File FWSAVE for cassette or long
file saves has been removed from
the package as no comments were
ever received concerning its use. A
revised version which works with Vn
4.3x exists and is available on
request.


(4) Basic loader LDFW
~~~ ~~~~~~~~~~~~ ~~~~

LDFW is an auxiliary load program
in the form of an autostarting
relocatable object file which may
be executed from E/A, Minimem
Basics by CALL LOAD(".."), Myarc
XBII by CALL LR(".."), E/A Load &
Run, or most other object file
loaders such as come with Myarc or
Corcomp disk controllers.  It may
be kept in Minimem cartridge RAM if
you follow the MM instructions for
forcing it to load there.  The RUN
name is LDFW.  It offers choice of
several pathnames or entry of
floppy disk numbers.

The information supplied by the
user to LDFW is used only to locate
the FW/UTIL1 file and does not
reconfigure this file in any way.
Incidentally, CALL LOAD will not
work from E/A or MiniMem Basic if
you have a Horizon style RAMdisk in
your system with LOAD configured as
a call name.


(5) User List UL
~~~ ~~~~~~~~~ ~~

Writing in of the 8 user selectable
options is done with the CF/CG
installer program.  If a hard
pathname load is chosen CONFIG will
remind you that only the file-name
or further pathname should be
entered.  There is no entry
corresponding to "9 <CRT ROM> 0"
which looks for a cartridge ROM
header at >6000 and "9" executes
the first program listed there and
"0" the second.  This may be handy
for owners of Vn 2.2 consoles who
have disk controllers that will
load FUNNELWEB.

Remember that UL is a normally
executing Option 2 Program file and
different UL files can be chained
by specifying them in a UL type of
file.  UL is coded to be fully
position independent.  Just
remember to avoid file name
clashes.  File D1 is a UL type file
collecting various disk utilities
together for Opt 3.


(6) Cartridge RAM loader CT8K/O
~~~ ~~~~~~~~~~~~~~~~~~~~ ~~~~~~

Object file CT8K/O is used to store
FUNNELWEB in >6000 - >8000
cartridge RAM, if present, so that
it comes up as a selection after
the title screen (not on V2.2
consoles or in the presence of
Myarc 128k OS).  The code produced
is ROMable.  Load FUNNELWEB, make
sure the character set of your
choice is loaded, and then load
CT8K/O as a Utility Load / Run
option.  FUNNELWEB is loaded into
hi-mem on selection as for FW.


(7) Assembly line locator LH
~~~ ~~~~~~~~~~~~~~~~~~~~~ ~~

LINEHUNTER is one of our working
tools now made available for
FUNNELWEB users, though it could
well stand comparison with many
commercial programs on its own. If
you write substantial assembly
programs you will be aware of the
problems in tracking down assembly
errors through multiple Copy files.
Printing of List files is fine, but
impractical for the home computer
user.  It is a dual-mode program
which will also execute outside the
FUNNELWEB environment.

Give LINEHUNTER the name of your
master source file and a line
number and it will locate and
display the line itself, and the
line number in, and the name of the
file in which it is located.  It
will conduct a similar search for a
source code label if one is entered
instead of a number.  If <space> is
pressed string search is enabled in
the Operand field of valid
assembler source lines, for
tracking down where labels are
used.  The search starts
automatically when 4 digits of line
number or 6 characters of label
have been entered, or else with the
<enter> key.  Pressing <ctrl-A>
resumes the search process and
<ctrl-C> terminates the search.
Exit from the program is by the
<ctrl-=> key.

Fastest searching is done when all
copy directives are located in a
separate short file, as LINEHUNTER
does not have to examine each line
in COPY files for further COPY
directives.


(8) XB FORTH Loader  XB4THLD
~~~ ~~~~~~~~~~~~~~~  ~~~~~~~

This program allows the standard TI
FORTH disk to be loaded by TI XB.
It works only with the XB and E/A
modules, and its primary use would
be from the XB User List.


ÇåÇ⌐åïÉòƒ╒╒╒╒╒╒╒╒╒╒╒Çïáááááááááááááááááááááá