home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 181.img / TASM-101.ZIP / README < prev    next >
Text File  |  1989-05-02  |  20KB  |  517 lines
  1.                        WELCOME TO TURBO ASSEMBLER 1.01
  2.                        -------------------------------
  3.  
  4. This README file contains important, last minute information
  5. about Turbo Assembler 1.01. The HELPME!.DOC file on the TURBO
  6. ASSEMBLER/INSTALLATION disk also answers many common Technical
  7. Support questions.
  8.  
  9.  
  10. TABLE OF CONTENTS
  11. -----------------
  12.  
  13.   1. How to Get Help
  14.   2. Installation
  15.   3. Important Notes
  16.   4. New Features
  17.   5. Manual Additions and Corrections
  18.   6. Files on the Disks
  19.  
  20.  
  21. 1. HOW TO GET HELP
  22. ------------------
  23.  
  24.   If you have any problems, please read this file, the HELPME!.DOC
  25.   file, and the Turbo Assembler manuals first. If you still have a
  26.   question and need assistance, help is available from the following
  27.   sources:
  28.  
  29.   1. Type GO BOR on the CompuServe bulletin board system for
  30.      instant access to the Borland forums with their libraries of
  31.      technical information and answers to common questions.
  32.  
  33.      If you are not a member of CompuServe, see the enclosed special
  34.      offer, and write for full details on how to receive a free
  35.      IntroPak containing a $15 credit toward your first month's on-
  36.      line charges.
  37.  
  38.   2. Check with your local software dealer or users' group.
  39.  
  40.   3. Write to us at the following address:
  41.  
  42.      Borland International
  43.      Turbo Assembler Technical Support
  44.      1800 Green Hills Road
  45.      P.O. Box 660001
  46.      Scotts Valley, CA  95066-0001
  47.  
  48.      Please remember to include your serial number or we will be
  49.      unable to process your letter.
  50.  
  51.   4. If you have an urgent problem that cannot wait and you have sent
  52.      in the license agreement from the front of your manual, you may
  53.      call the Borland Technical Support Department at (408) 438-5300.
  54.      Please have the following information ready before calling:
  55.  
  56.      a. Product name and serial number on your original distribution
  57.         disk.  Please have your serial number ready or we will be
  58.         unable to process your call.
  59.  
  60.      b. Product version number. The version number for Turbo Assembler
  61.         is displayed when you run the program.
  62.  
  63.      c. Computer brand, model, and the brands and model numbers of any
  64.         additional hardware.
  65.  
  66.      d. Operating system and version number. (The version number can
  67.         be determined by typing VER at the MSDOS prompt.)
  68.  
  69.      e. Contents of your AUTOEXEC.BAT file.
  70.  
  71.      f. Contents of your CONFIG.SYS file.
  72.  
  73.  
  74. 2. INSTALLATION
  75. ---------------
  76.  
  77.   This disk contains a program called INSTALL.EXE that will
  78.   assist you with the installation of Turbo Assembler 1.01. There
  79.   are two options for installation:
  80.  
  81.   1. Hard Disk - This option allows you to pick the subdirectories
  82.      where the files will be loaded.
  83.  
  84.   2. Floppy Disk - This option will install the files necessary to
  85.      use Turbo Assembler on a two-drive system.  Be sure to have
  86.      four formatted disks ready before you start.
  87.  
  88.   To start the installation, change your current drive to the one
  89.   that has the install program on it and type INSTALL.  You will
  90.   be given instructions in a box at the bottom of the screen for
  91.   each prompt. For example, if you will be installing from drive
  92.   A:, type
  93.  
  94.     A:
  95.     INSTALL
  96.  
  97.   You should read the rest of this README file to get further
  98.   information about this release before you do the installation.
  99.  
  100.  
  101. 3. IMPORTANT NOTES
  102. ------------------
  103.  
  104.   o Additional tips and answers to many common questions will be found
  105.     in the text file HELPME!.DOC, which has been installed to the same
  106.     location as this file (README). You can use the README.COM utility
  107.     to view the HELPME!.DOC file by giving the following command:
  108.  
  109.       README HELPME!.DOC
  110.  
  111.   o If you will be running INSTALL on a laptop or any other system
  112.     that uses an LCD display, you should set your system into black
  113.     and white mode before running INSTALL. You can do this from DOS
  114.     with the following command line:
  115.  
  116.       mode bw80
  117.  
  118.     or, you can force INSTALL to come up in black and white mode by
  119.     using the /b switch:
  120.  
  121.       install /b
  122.  
  123.   o Changed Switches for OBJXREF:
  124.  
  125.     The /O option (object files directory) has been changed to
  126.     the /D (directories) option. The switch now allows for
  127.     multiple search directories to be specified. The new syntax
  128.     follows:
  129.  
  130.      OBJXREF /Ddir1[;dir2[;dir3]]
  131.  
  132.        or
  133.  
  134.      OBJXREF /Ddir1 [/Ddir2] [/Ddir3]
  135.  
  136.     OBJXREF will search each of the directories in the specified
  137.     order for all object and library files. If no /D option is
  138.     used, only the current directory will be searched. However,
  139.     if a /D option is used, the current directory will NOT be
  140.     searched unless it is included in the directory list. For
  141.     example, to first search the BORLAND directory for files and
  142.     then search the current directory, you would type
  143.  
  144.       OBJXREF /Dborland;.
  145.  
  146.     If multiple search directories are specified and a file
  147.     matching the file specification is found, OBJXREF will
  148.     include the file as part of the cross-reference. OBJXREF will
  149.     only continue to search the other directories for the same
  150.     file specification if the file specification contains
  151.     wildcards.
  152.  
  153.     A new option has been added to allow you to specify an output
  154.     file where OBJXREF will send any reports generated. The new
  155.     option is the /O option, and it has the following syntax:
  156.  
  157.       OBJXREF myfile.obj /RU /Ofilename.ext
  158.  
  159.     By default, all output is sent to the console.
  160.  
  161.   o Turbo Linker (TLINK) Notes:
  162.  
  163.     1) When linking with the /V option, TLINK will initialize all
  164.     segments. If you have a program that runs differently when
  165.     linked with debug information, you have an uninitialized
  166.     variable somewhere.
  167.  
  168.     2) TLINK loads last any segments of class 'STACK' even if
  169.     they are part of DGROUP.
  170.  
  171.  
  172.  
  173. 4.  NEW FEATURES
  174. ----------------
  175.  
  176.   o Listing files generated with /LA will now contain the mnemonics for
  177.     the opcodes inserted as a result of the use of high level language
  178.     directives. The listing is changed only for things that actually
  179.     generate code such as the first instruction of a PROC with arguments.
  180.     The listing of things such as .MODEL, .CODE, and other instructions
  181.     that do not actually generate any code will not be changed. /LA also
  182.     overrides other directives that turn off listing. If certain parts
  183.     of listing need to be supressed use /L instead of /LA.
  184.  
  185.   o If a string is defined with a DB instruction, and a comma is the
  186.     last thing on the line, a null byte will be assumed at the end of
  187.     the string. A warning will be generated. For example:
  188.  
  189.     db 'ABCDEF',
  190.  
  191.     will generate the following, with a warning "Trailing null assumed"
  192.  
  193.     41 42 43 44 45 46 00
  194.  
  195.   o If a structure instance does not have any initializer specified
  196.     the "Trailing null assumed" warning will be generated. No extra
  197.     zeros are placed in the emitted code.
  198.  
  199.   o Segment alignment and padding now match MASM.
  200.  
  201.   o Confusion about certain features of TYPE used in IDEAL
  202.     mode should be cleared up by the following addition to the
  203.     manual:
  204.  
  205.        Function  Returns a number indicating the size of a symbol
  206.                  (Masm mode), or returns the type of a  symbol 
  207.                  (Ideal mode)
  208.  
  209.        Mode      MASM, Ideal
  210.  
  211.        Syntax    Masm mode: TYPE <expression>
  212.                  Ideal mode:  TYPE <symbol>
  213.  
  214.        Remarks   Masm mode:
  215.                  (Keep discussion as exists now)
  216.  
  217.                  Ideal mode:
  218.                      TYPE is used to get the type of an
  219.                      existing symbol.  In Ideal mode, this
  220.                      operation can only be used where a type
  221.                      specifier is needed.
  222.  
  223.        Example   Masm mode:
  224.                      (Keep discussion as exists now)
  225.  
  226.                  Ideal mode:
  227.  
  228.                      ideal
  229.  
  230.                      ...
  231.  
  232.                      bvar    db 1    ;Byte storage.
  233.                      tempvr  dt ?    ;Scratch area.
  234.  
  235.                      ...
  236.  
  237.                      mov     [bvar],0 ;Clear byte variable.
  238.                      mov     [type bvar ptr tempvr],0
  239.                                       ;Clear scratch area of 
  240.                                       ;same size.
  241.                                       ;Equivalent to 'BYTE PTR'.
  242.  
  243.  
  244.   o TED.ASM from PCMAGNET will now assemble and link properly. Be
  245.     sure to use the /t switch with TLINK to produce a .COM file.
  246.  
  247.   o Existence of ">" character within a string passed to IFB macro
  248.     directive causes TASM 1.0 to report that extra characters are
  249.     on line. This will now be handled without an error if QUIRKS
  250.     directive is used. All characters past the embedded ">" will
  251.     be ignored.
  252.  
  253.   o Colons within label names passed to IFDEF macro directive
  254.     are now ignored if QUIRKS directive is used. All characters
  255.     past the colon are ignored.
  256.  
  257.   o In tiny model programs, all registers should be pointing to the
  258.     same DGROUP. If unwanted SS: overrides occur when referencing
  259.     variables in the DGROUP, use the statement ASSUME SS:NOTHING to
  260.     causes CS: overrides to be used.
  261.  
  262. 5. MANUAL ADDITIONS AND CORRECTIONS
  263. -----------------------------------
  264.  
  265.   Turbo Assembler User's Guide
  266.   ----------------------------
  267.  
  268.   For your convenience, many of the examples are provided on the dis-
  269.   tribution diskettes. Consult the files listed at the bottom of the
  270.   README file for their names and the page on which the example appears.
  271.  
  272.   Turbo Assembler Reference Guide
  273.   -------------------------------
  274.  
  275.   All references to P386P and P286P are incorrect. These do not exist.
  276.  
  277.   Please see pages 403 and 404 of the User's Guide for a discussion
  278.   of the following line-segment override directives:
  279.       SEGCS
  280.       SEGDS
  281.       SEGES
  282.       SEGSS
  283.  
  284.   Page
  285.  
  286.   53 - Add the % directive, which is a one-line macro that uses
  287.        all current text macros as possible arguments.
  288.  
  289.   74 - Change the number in the first bulleted item from
  290.        4,294,967,295 to 2,147,483,647.
  291.  
  292.   76 - The DISPLAY directive is available in both MASM and Ideal
  293.        modes.
  294.  
  295.        You may use the substitute operator inside a string passed
  296.        to the DISPLAY directive. For example,
  297.  
  298.          MAKE_DATA macro VALUE
  299.                    display "Initializing a byte to: &VALUE&"
  300.                    db VALUE
  301.                    endm
  302.  
  303.   77 - In DQ, change the numeric range in the first bulleted item
  304.        from -2^64+1 to 2^64-1.
  305.  
  306.   79 - The number in the first bulleted item on the page should
  307.        be 32,767, not 65,536.
  308.  
  309.  131 - Note that %NOTRUNC is the default mode when Turbo Assembler
  310.        starts assembling a file.
  311.  
  312.  151 - The example for the STRUC directive should have
  313.              MODEL SMALL
  314.        instead of the .MODEL SMALL.
  315.  
  316.  
  317. 6. FILES ON THE DISKS
  318. -----------------------
  319.  
  320.   TURBO ASSEMBLER/INSTALLATION
  321.   ----------------------------
  322.   INSTALL  EXE  -  Installation program
  323.   README   COM  -  Reads this README
  324.   TASM     EXE  -  Turbo Assembler
  325.   TCREF    EXE  -  Turbo Assembler cross-reference utility
  326.   MAKE     EXE  -  Program for managing projects
  327.   TLINK    EXE  -  Borland Turbo Linker
  328.   TLIB     EXE  -  Borland Turbo Librarian
  329.   OBJXREF  COM  -  Object file cross-reference utility
  330.   GREP     COM  -  Turbo GREP program
  331.   TOUCH    COM  -  Program that updates a file's date and time
  332.   HELPME!  DOC  -  Text file with the answers to many common
  333.                    questions. Please read HELPME!.DOC before
  334.                    contacting Technical Support
  335.   README        -  This file
  336.   MMACROS  ARC  -  MASM Mode Macros
  337.  
  338.     BIOS.INC    -  Equates representing the BIOS services
  339.     DOS.INC     -  Equates representing the DOS services
  340.     KBD.INC     -  Equates representing the IBM PC keyboard keystrokes
  341.     MBIOS.MAC   -  Macros used to interface with the IBM PC BIOS. MASM Mode
  342.     MDOS.MAC    -  Macros to interface with DOS. MASM Mode
  343.     MMACROS.MAC -  General macros. Masm Mode
  344.  
  345.   TURBO DEBUGGER UTILITIES/EXAMPLES
  346.   -----------------------------------------
  347.   This diskette also contains files for use with the Turbo Debugger.
  348.   Please see the Turbo Debugger README and manuals for a complete
  349.   description of these files.
  350.  
  351.   TDCONVRT EXE  -  Turbo Debugger utility
  352.   TDPACK   EXE  -  Turbo Debugger utility
  353.   TDNMI    COM  -  Turbo Debugger utility
  354.   UNPACK   COM  -  Program to unpack the .ARC files
  355.   TDEXMPL  ARC  -  Packed file that contains Turbo Debugger examples
  356.   TAEXMPL1 ARC  -  Ideal mode example and macros
  357.  
  358.     BIOS.INC     - Equates representing the BIOS services
  359.     BIOSMAC.DOC  - Documentation for macros implemented in ?BIOS.MAC
  360.     DEMO1.BAT    - Batch file to make Whereis.exe
  361.     DOS.INC      - Equates representing the DOS services
  362.     DOSMAC.DOC   - Documentation for macros implemented in ?DOS.MAC
  363.     IASCIIZS.ASM - Routine to display an ASCIIZ string
  364.     IBIOS.MAC    - Ideal mode macros used to interface with the IBM PC BIOS
  365.     IBYTECPY.ASM - Routine that copies an array of bytes from one
  366.                    location to another
  367.     IDELCHAR.ASM - Routine that deletes n characters from a
  368.                    Pascal-style string starting at position i
  369.     IDOS.INC     - Type declarations used to interface with DOS
  370.     IDOS.MAC     - Macros to interface with DOS. Ideal Mode
  371.     IFINDBYT.ASM - Routine that searches an array of bytes, looking for a
  372.                    value; routine that returns the length of an ASCIIZ string.
  373.     IFINDFIL.ASM - Routine that does a recursive search of a hard disk
  374.                    looking for a file
  375.     IFINDREP.ASM - Routine that searches through an array of bytes,
  376.                    replacing all instances of a value with another value.
  377.     ILOCSTRG.ASM - Routine that searches through memory looking for the
  378.                    nth Pascal-style string
  379.     IMACROS.MAC  - General macros. Ideal Mode
  380.     IPARAM.ASM   - Routines to return the # of command-line parameters and
  381.                    the contents of an individual parameter
  382.     IPARSEFN.ASM - Routine that parses a file name into Drive,
  383.                    Path, and File spec
  384.     ISKPWHIT.ASM - Routine to advance a pointer past any whitespace in
  385.                    an array of bytes
  386.     IWHEREIS.ASM - Main module for Whereis program
  387.     IWHGLOBL.INC - Global declarations for Whereis
  388.     IWRITEPS.ASM - Routine to display a Pascal-style string
  389.     KBD.INC      - Equates representing the IBM PC keyboard keystrokes
  390.     WHEREIS.DOC  - Documentation for Whereis file locator program
  391.     WHEREIS.MAK  - Make file for creating Whereis.exe using the Make utility
  392.     WHUSAGE.INC  - Usage screen text
  393.  
  394.   TAEXMPL2 ARC  -  Simplified (FILT) and standard segmentation (SHOW87)
  395.                    examples
  396.  
  397.     CONVERT1.INC - Converts from binary numbers to strings
  398.     CONVERT2.INC - Converts from floating point to integer numbers
  399.     DEMO3.BAT    - Batch file to make Filt.exe text filter program
  400.     DEMO2.BAT    - Batch file to build Show87
  401.     FILT.ASM     - Text filter main file
  402.     FILT.DOC     - Documentation file for Filt.exe text filter program
  403.     FILT.MAK     - Make file for creating Filt.exe using the make utility
  404.     FILT.RSP     - Linker response file for linking Filt.exe
  405.     GLOBALS.INC  - Declares procedures and symbols needed by the modules
  406.                    of FILT
  407.     OBYTEHI.ASM  - Processes the current high byte value in AL
  408.     OBYTELOW.ASM - Processes the current low byte value in AL
  409.     OBYTENRM.ASM - Processes the current normal byte value in AL
  410.     OCMDNUM.ASM  - Parses the command line
  411.     OERREXIT.ASM - Handles the printing of error messages
  412.     OFCREATE.ASM - Creates or truncates a file; the file is opened
  413.                    for writing
  414.     OFILALOC.ASM - Allocates a read/write buffer
  415.     OFILCLOS.ASM - Closes a file
  416.     OFILEFIL.ASM - Fills a read buffer
  417.     OFILFREE.ASM - Deallocates a read/write buffer
  418.     OFILREAD.ASM - Reads from a file
  419.     OFILWRIT.ASM - Writes to a file
  420.     OFLFLUSH.ASM - Flushes the write buffer
  421.     OFOPENR.ASM  - Opens a file for reading
  422.     OFOPENW.ASM  - Opens a file for writing
  423.     OLOCASE.ASM  - Routine converts a letter to lowercase
  424.     OPARSCMD.ASM - Parses the command line
  425.     OPRCBYTE.ASM - Processes a byte
  426.     OPROCDOC.ASM - Processes an entire document, one line at a time
  427.     OPROCLIN.ASM - Processes a line
  428.     OSETOPTN.ASM - Sets input buffer size; sets output buffer
  429.                    size; sets the byte to end lines; clears all
  430.                    tab stops; sets a tab stop; truncates lines to
  431.                    a specified length; sets the left margin;
  432.                    deletes the left margin; displays a help
  433.                    message
  434.     OSPACES.ASM  - Stores a specified number of spaces at
  435.                    particular location
  436.     OSTORSPC.ASM - Stores any currently stored spaces
  437.     OSTORTAB.ASM - Stores a tab character if there are any spaces
  438.                    to compress
  439.     OTABCLR.ASM  - Clears all tab stops
  440.     OTABNEXT.ASM - Returns the number of spaces to the next tab stop
  441.     OTABRSET.ASM - Sets tap stops every eight columns
  442.     OTABSET.ASM  - Sets a tap stop at a specified column location
  443.     OUPCASE.ASM  - Converts a letter to uppercase
  444.     SHOW87.ASM   - Standard Segmentation Demo Program
  445.     SHOW87.DOC   - Documentation for Show87 8087 register display
  446.                    program
  447.     VIDEO1.INC   - Routines to display text and control the screen
  448.     VIDEO2.INC   - Routines to display formatted text strings
  449.  
  450.   CHAPXMPL ARC  -  Example Programs from the Manual
  451.  
  452.      Note: This file is not automatically unpacked when Turbo Assembler
  453.            is installed to a hard disk. To unpack these files you will
  454.            first need to switch to the drive and subdirectory containing
  455.            this file and then give the command
  456.  
  457.            unpack /r chapxmpl
  458.  
  459.  
  460.     HELLO.ASM    - Pg   9
  461.     HELLO2.ASM   - Pg  13
  462.     HELLOPRN.ASM - Pg  15
  463.     REVERSE.ASM  - Pg  16
  464.     ECHOCHAR.ASM - Pg  55
  465.     MODCHAR.ASM  - Pg  80
  466.     DELAY.ASM    - Pg  88
  467.     DSLYSTR.ASM  - Pg 109
  468.     USE_ES.ASM   - Pg 110
  469.     STDSEG.ASM   - Pg 115
  470.     STRINGS.ASM  - Pg 132
  471.     PRNTSTR.ASM  - Pg 175
  472.     CNTWORDS.ASM - Pg 181
  473.     MAIN.ASM     - Pg 207
  474.     SUB1.ASM     - Pg 208
  475.     PLUSONE.C    - Pg 282
  476.     PLUSONE.ASM  - Pg 283
  477.     SQRETBLE.C   - Pg 287
  478.     SQRTBLE2.C   - Pg 287
  479.     STRINGUP.C   - Pg 293
  480.     DOTOTAL.ASM  - Pg 305
  481.     SHOWTOT.C    - Pg 306
  482.     DOTOTAL2.ASM - Pg 307
  483.     TOGLFLAG.C   - Pg 313
  484.     TOGFLAG.ASM  - Pg 313
  485.     CALLCT.C     - Pg 328
  486.     COUNT.ASM    - Pg 327
  487.     COUNTLG.ASM  - Pg 329
  488.     CALCAVG.C    - Pg 334
  489.     AVERAGE.ASM  - Pg 334
  490.     SAMPLE.PAS   - Pg 344
  491.     ASMPROC.ASM  - Pg 344
  492.     TSAMPLE.PAS  - Pg 345
  493.     HEXTEST.PAS  - Pg 358
  494.     HEXSTR.ASM   - Pg 357
  495.     XCHANGE.PAS  - Pg 361
  496.     XCHANGE.ASM  - Pg 360
  497.     ENVTEST.PAS  - Pg 364
  498.     ENVSTR.ASM   - Pg 362
  499.     SCROLLH.PRO  - Pg 387
  500.     SCROL.ASM    - Pg 388
  501.     MYPROLOG.PRO - Pg 391
  502.     MYASM.ASM    - Pg 391
  503.     ADDPRO.PRO   - Pg 393
  504.     ADD.ASM      - Pg 393
  505.     SHOWMESS.PRO - Pg 395
  506.     FROM_ASM.ASM - Pg 395
  507.     SHOWNEW.PRO  - Pg 396
  508.     FROM_NEW.ASM - Pg 396
  509.     FUNC.PRO     - Pg 398
  510.     IFUNC.ASM    - Pg 398
  511.     MULT_C&D.ASM - Pg 469
  512.     PRIMES.ASM   - Pg 521
  513.     MASEXMPL.ASM - Pg 548
  514.     IDLEXMPL.ASM - Pg 549
  515.  
  516.  
  517.