WELCOME TO TURBO ASSEMBLER 1.0
------------------------------
This README file contains important, last minute information
about Turbo Assembler 1.0. The HELPME!.DOC file on the TURBO
ASSEMBLER/INSTALLATION disk also answers many common Technical
Support questions.
TABLE OF CONTENTS
-----------------
1. How to Get Help
2. Installation
3. Important Notes
4. Manual Additions and Corrections
5. Files on the Disks
1. HOW TO GET HELP
------------------
If you have any problems, please read this file, the HELPME!.DOC
file, and the Turbo Assembler manuals first. If you still have a
question and need assistance, help is available from the following
sources:
1. Type GO BOR on the CompuServe bulletin board system for
instant access to the Borland forums with their libraries of
technical information and answers to common questions.
If you are not a member of CompuServe, see the enclosed special
offer and write for full details on how to receive a free
IntroPak containing a $15 credit toward your first month's on-
line charges.
2. Check with your local software dealer or users' group.
3. Write to us at the following address:
Borland International
Turbo Assembler Technical Support
1800 Green Hills Road
P.O. Box 660001
Scotts Valley, CA 95066-0001
Please remember to include your serial number or we will be
unable to process your letter.
4. If you have an urgent problem that cannot wait and you have sent
in the license agreement from the front of your manual, you may
call the Borland Technical Support Department at (408) 438-5300.
Please have the following information ready before calling:
a. Product name and serial number on your original distribution
disk. Please have your serial number ready or we will be
unable to process your call.
b. Product version number. The version number for Turbo Assembler
is displayed when you run the program.
c. Computer brand, model, and the brands and model numbers of any
additional hardware.
d. Operating system and version number. (The version number can
be determined by typing VER at the MSDOS prompt.)
e. Contents of your AUTOEXEC.BAT file.
f. Contents of your CONFIG.SYS file.
2. INSTALLATION
---------------
This disk contains a program called INSTALL.EXE that will
assist you with the installation of Turbo Assembler 1.0. There
are two options for installation:
1. Hard Disk - This option allows you to pick the subdirectories
where the files will be loaded.
2. Floppy Disk - This option will install the files necessary to
use Turbo Assembler on a two-drive system. Be sure to have
four formatted disks ready before you start.
To start the installation, change your current drive to the one
that has the install program on it and type INSTALL. You will
be given instructions in a box at the bottom of the screen for
each prompt. For example, if you will be installing from drive
A:, type
A:
INSTALL
Before doing the installation, read the rest of this README
file to get further information about this release.
3. IMPORTANT NOTES
------------------
o Additional tips and answers to many common questions will be found
in the text file HELPME!.DOC, which has been installed to the same
location as this file (README). You can use the README.COM utility
to view the HELPME!.DOC file by giving the following command:
README HELPME!.DOC
o If you will be running INSTALL on a laptop or any other system
that uses an LCD display, you should set your system into
black-and-white mode before running INSTALL. You can do this from DOS
with the following command line:
mode bw80
or you can force INSTALL to come up in black and white mode by
using the /b switch:
install /b
o Changed Switches for OBJXREF:
The /O option (object files directory) has been changed to
the /D (directories) option. The switch now allows for
multiple search directories to be specified. The new syntax
follows:
OBJXREF /Ddir1[;dir2[;dir3]]
or
OBJXREF /Ddir1 [/Ddir2] [/Ddir3]
OBJXREF will search each of the directories in the specified
order for all object and library files. If no /D option is
used, only the current directory will be searched. However,
if a /D option is used, the current directory will NOT be
searched unless it is included in the directory list. For
example, to first search the BORLAND directory for files and
then search the current directory, you would type
OBJXREF /Dborland;.
If multiple search directories are specified and a file
matching the file specification is found, OBJXREF will
include the file as part of the cross-reference. OBJXREF will
only continue to search the other directories for the same
file specification if the file specification contains
wildcards.
A new option has been added to allow you to specify an output
file where OBJXREF will send any reports generated. The new
option is the /O option, and it has the following syntax:
OBJXREF myfile.obj /RU /Ofilename.ext
By default, all output is sent to the console.
o Turbo Linker (TLINK) Notes:
1) When linking with the /V option, TLINK will initialize all
segments. If you have a program that runs differently when
linked with debug information, you have an uninitialized
variable somewhere.
2) TLINK loads last any segments of class 'STACK' even if
they are part of DGROUP.
5. MANUAL ADDITIONS AND CORRECTIONS
-----------------------------------
Additions and corrections to the manual will be found in the text
file MANUAL.DOC, which has been installed to the same location as
this file (README). You can use the README.COM utility to view the
MANUAL.DOC file by giving the following command:
README MANUAL.DOC
6. FILES ON THE DISKS
-----------------------
TURBO ASSEMBLER/INSTALLATION
----------------------------
INSTALL EXE - Installation program
README COM - Reads this README
TASM EXE - Turbo Assembler
TCREF EXE - Turbo Assembler cross-reference utility
MAKE EXE - Program for managing projects
TLINK EXE - Borland Turbo Linker
TLIB EXE - Borland Turbo Librarian
OBJXREF COM - Object file cross-reference utility
GREP COM - Turbo GREP program
TOUCH COM - Program that updates a file's date and time
MANUAL DOC - Last-minute additions and corrections to the manual
HELPME! DOC - Text file with the answers to many common
questions. Please read HELPME!.DOC before
contacting Technical Support
README - This file
MMACROS ARC - MASM Mode Macros
BIOS.INC - Equates representing the BIOS services
DOS.INC - Equates representing the DOS services
KBD.INC - Equates representing the IBM PC keyboard keystrokes
MBIOS.MAC - Macros used to interface with the IBM PC BIOS. MASM Mode
MDOS.MAC - Macros to interface with DOS. MASM Mode
MMACROS.MAC - General macros. Masm Mode
TURBO DEBUGGER UTILITIES/EXAMPLES
-----------------------------------------
This diskette also contains files for use with the Turbo Debugger.
Please see the Turbo Debugger README and manuals for a complete
description of these files.
TDCONVRT EXE - Turbo Debugger utility
TDPACK EXE - Turbo Debugger utility
TDNMI COM - Turbo Debugger utility
UNPACK COM - Program to unpack the .ARC files
TDEXMPL ARC - Packed file that contains Turbo Debugger examples
TAEXMPL1 ARC - Ideal mode example and macros
BIOS.INC - Equates representing the BIOS services
BIOSMAC.DOC - Documentation for macros implemented in ?BIOS.MAC
DEMO1.BAT - Batch file to make Whereis.exe
DOS.INC - Equates representing the DOS services
DOSMAC.DOC - Documentation for macros implemented in ?DOS.MAC
IASCIIZS.ASM - Routine to display an ASCIIZ string
IBIOS.MAC - Ideal mode macros used to interface with the IBM PC BIOS
IBYTECPY.ASM - Routine that copies an array of bytes from one
location to another
IDELCHAR.ASM - Routine that deletes n characters from a
Pascal-style string starting at position i
IDOS.INC - Type declarations used to interface with DOS
IDOS.MAC - Macros to interface with DOS. Ideal Mode
IFINDBYT.ASM - Routine that searches an array of bytes looking for a
value; routine that returns the length of an ASCIIZ string.
IFINDFIL.ASM - Routine that does a recursive search of a hard disk
looking for a file
IFINDREP.ASM - Routine that searches through an array of bytes,
replacing all instances of a value with another value.
ILOCSTRG.ASM - Routine that searches through memory looking for the
nth Pascal-style string
IMACROS.MAC - General macros. Ideal Mode
IPARAM.ASM - Routines to return the # of command-line parameters and
the contents of an individual parameter
IPARSEFN.ASM - Routine that parses a file name into Drive,
Path, and File spec
ISKPWHIT.ASM - Routine to advance a pointer past any whitespace in
an array of bytes
IWHEREIS.ASM - Main module for Whereis program
IWHGLOBL.INC - Global declarations for Whereis
IWRITEPS.ASM - Routine to display a Pascal-style string
KBD.INC - Equates representing the IBM PC keyboard keystrokes
WHEREIS.DOC - Documentation for Whereis file locator program
WHEREIS.MAK - Make file for creating Whereis.exe using the Make utility
WHUSAGE.INC - Usage screen text
TAEXMPL2 ARC - Simplified (FILT) and standard segmentation (SHOW87)
examples
CONVERT1.INC - Converts from binary numbers to strings
CONVERT2.INC - Converts from floating point to integer numbers
DEMO3.BAT - Batch file to make Filt.exe text filter program
DEMO2.BAT - Batch file to build Show87
FILT.ASM - Text filter main file
FILT.DOC - Documentation file for Filt.exe text filter program
FILT.MAK - Make file for creating Filt.exe using the make utility
FILT.RSP - Linker response file for linking Filt.exe
GLOBALS.INC - Declares procedures and symbols needed by the modules
of FILT
OBYTEHI.ASM - Processes the current high byte value in AL
OBYTELOW.ASM - Processes the current low byte value in AL
OBYTENRM.ASM - Processes the current normal byte value in AL
OCMDNUM.ASM - Parses the command line
OERREXIT.ASM - Handles the printing of error messages
OFCREATE.ASM - Creates or truncates a file; the file is opened
for writing
OFILALOC.ASM - Allocates a read/write buffer
OFILCLOS.ASM - Closes a file
OFILEFIL.ASM - Fills a read buffer
OFILFREE.ASM - Deallocates a read/write buffer
OFILREAD.ASM - Reads from a file
OFILWRIT.ASM - Writes to a file
OFLFLUSH.ASM - Flushes the write buffer
OFOPENR.ASM - Opens a file for reading
OFOPENW.ASM - Opens a file for writing
OLOCASE.ASM - Routine converts a letter to lowercase
OPARSCMD.ASM - Parses the command line
OPRCBYTE.ASM - Processes a byte
OPROCDOC.ASM - Processes an entire document, one line at a time
OPROCLIN.ASM - Processes a line
OSETOPTN.ASM - Sets input buffer size; sets output buffer
size; sets the byte to end lines; clears all
tab stops; sets a tab stop; truncates lines to
a specified length; sets the left margin;
deletes the left margin; displays a help
message
OSPACES.ASM - Stores a specified number of spaces at
particular location
OSTORSPC.ASM - Stores any currently stored spaces
OSTORTAB.ASM - Stores a tab character if there are any spaces
to compress
OTABCLR.ASM - Clears all tab stops
OTABNEXT.ASM - Returns the number of spaces to the next tab stop
OTABRSET.ASM - Sets tap stops every eight columns
OTABSET.ASM - Sets a tap stop at a specified column location
OUPCASE.ASM - Routine converts a letter to uppercase
SHOW87.ASM - Standard Segmentation Demo Program
SHOW87.DOC - Documentation for Show87 8087 register display
program
VIDEO1.INC - Routines to display text and control the screen
VIDEO2.INC - Routines to display formatted text strings
CHAPXMPL ARC - Examples Programs from the Manual
Note: This file is not automatically unpacked when Turbo Assembler
is installed to a hard disk. To unpack these files you will
first need to switch to the drive and subdirectory containing
this file and then give the command
unpack /r chapxmpl
HELLO.ASM - Pg 9
HELLO2.ASM - Pg 13
HELLOPRN.ASM - Pg 15
REVERSE.ASM - Pg 16
ECHOCHAR.ASM - Pg 56
MODCHAR.ASM - Pg 80
DELAY.ASM - Pg 88
DSLYSTR.ASM - Pg 109
USE_ES.ASM - Pg 110
STDSEG.ASM - Pg 115
STRINGS.ASM - Pg 132
PRNTSTR.ASM - Pg 175
CNTWORDS.ASM - Pg 181
MAIN.ASM - Pg 208
SUB1.ASM - Pg 208
PLUSONE.C - Pg 285
PLUSONE.ASM - Pg 285
SQRETBLE.C - Pg 289
SQRTBLE2.C - Pg 289
STRINGUP.C - Pg 295
DOTOTAL.ASM - Pg 308
SHOWTOT.C - Pg 309
DOTOTAL2.ASM - Pg 309
TOGLFLAG.C - Pg 316
TOGFLAG.ASM - Pg 316
CALLCT.C - Pg 330
COUNT.ASM - Pg 330
COUNTLG.ASM - Pg 332
CALCAVG.C - Pg 337
AVERAGE.ASM - Pg 337
SAMPLE.PAS - Pg 347
ASMPROC.ASM - Pg 347
TSAMPLE.PAS - Pg 348
HEXTEST.PAS - Pg 361
HEXSTR.ASM - Pg 360
XCHANGE.PAS - Pg 363
XCHANGE.ASM - Pg 363
ENVTEST.PAS - Pg 366
ENVSTR.ASM - Pg 366
SCROLLH.PRO - Pg 391
SCROL.ASM - Pg 392
MYPROLOG.PRO - Pg 395
MYASM.ASM - Pg 395
ADDPRO.PRO - Pg 397
ADD.ASM - Pg 397
SHOWMESS.PRO - Pg 399
FROM_ASM.ASM - Pg 400
SHOWNEW.PRO - Pg 400
FROM_NEW.ASM - Pg 401
FUNC.PRO - Pg 402
IFUNC.ASM - Pg 402
MULT_C&D.ASM - Pg 475
PRIMES.ASM - Pg 526
MASEXMPL.ASM - Pg 555
IDLEXMPL.ASM - Pg 557