home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 240.img / TASM20-1.ZIP / README < prev    next >
Text File  |  1990-05-07  |  19KB  |  466 lines
  1.             WELCOME TO TURBO ASSEMBLER VERSION 2.0
  2.             --------------------------------------
  3.  
  4.   This README file contains important information about Turbo
  5.   Assembler Version 2.0. For the latest information about
  6.   Turbo Assembler 2.0, the accompanying programs, and the manual,
  7.   read this file in its entirety. The UPDATE.DOC file contains
  8.   information on the new features in Turbo Assembler version 2.0.
  9.   The HELPME!.DOC file answers many common Technical Support
  10.   questions.
  11.  
  12.  
  13. TABLE OF CONTENTS
  14. -----------------
  15. 1.  How to Get Help
  16. 2.  Installation
  17. 3.  Important Notes
  18. 4.  Files on the Disks
  19.  
  20.  
  21. 1.  HOW TO GET HELP
  22. -------------------
  23.  
  24.   If you have any problems, please read this file, HELPME!.DOC,
  25.   UPDATE.DOC, and the Turbo Assembler manuals first. If you still
  26.   have a question and need assistance, help is available from the
  27.   following 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
  34.      special offer, and write for full details on how to receive
  35.      a free IntroPak containing a $15 credit toward your first
  36.      month's online 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
  52.      sent in the license agreement, you may call the Borland
  53.      Technical Support Department at (408) 438-5300 Monday through
  54.      Friday between the hours of 6 a.m. and 5 p.m. Pacific Time.
  55.      Please have the following information ready before calling:
  56.  
  57.      a. Product name and serial number on your original
  58.         distribution disk. Please have your serial number ready
  59.         or we will be unable to process your call.
  60.  
  61.      b. Product version number. The version number for Turbo
  62.         Assembler is displayed when you run the program.
  63.  
  64.      c. Computer brand, model, and the brands and model numbers
  65.         of any additional hardware.
  66.  
  67.      d. Operating system and version number. (The version number
  68.         can be determined by typing VER at the DOS prompt.)
  69.  
  70.      e. Contents of your AUTOEXEC.BAT and CONFIG.SYS files.
  71.  
  72.  
  73. 2.  INSTALLATION
  74. ----------------
  75.  
  76.   You should read the rest of this README file to get further
  77.   information about this release before you do the installation.
  78.  
  79.   The Turbo Assembler/INSTALLATION disk contains a program called
  80.   INSTALL.EXE that will assist you with the installation of Turbo
  81.   Assembler 2.0.
  82.  
  83.   To start the installation, change your current drive to the one
  84.   that has the install program on it and type INSTALL. You will
  85.   be given instructions in a box at the bottom of the screen for
  86.   each prompt. For example, if you will be installing from drive
  87.   A:, type
  88.  
  89.     A: <Enter>
  90.     INSTALL <Enter>
  91.  
  92.   If you have difficulty reading the text displayed by the INSTALL
  93.   program, use the /B command-line parameter to force it to use
  94.   black and white colors:
  95.  
  96.     a:install /B      - Forces INSTALL into BW80 mode
  97.  
  98.   Specifying the /B parameter may be necessary if you are using an
  99.   LCD screen or a system that has a color graphics adapter and a
  100.   monochrome or composite monitor.
  101.  
  102.   Notes for installation:
  103.  
  104.     INSTALL copies all Turbo Assembler files onto your hard disk
  105.     and puts them into subdirectories. The default subdirectories
  106.     are
  107.  
  108.       Turbo Assembler Directory:                   C:\TASM
  109.       Examples Subdirectory:                       C:\TASM
  110.  
  111.   By default, all files from the distribution disks are placed in
  112.   the Turbo Assembler Directory. If you would rather separate the
  113.   examples programs into their own subdirectory, edit the default
  114.   example files path before selecting START INSTALLATION.
  115.  
  116.   The Turbo Assembler distribution disks contain several files
  117.   with a .ZIP file extension: TASM.ZIP, MANUAL.ZIP, etc. These
  118.   files contain one or more other files that have been compressed
  119.   and placed inside an archive. You can de-archive them yourself
  120.   by using the UNZIP.EXE utility. For example,
  121.  
  122.     unzip /o tasm
  123.  
  124.   unpacks all the files stored in the TASM.ZIP archive into the
  125.   current directory.
  126.  
  127.   INSTALL gives you a choice of copying the .ZIP files intact or
  128.   de-archiving and copying all the individual files onto your hard
  129.   disk during the installation process.
  130.  
  131.  
  132. 3.  IMPORTANT NOTES
  133. -------------------
  134.  
  135. o Updated QUIRKS mode list
  136.  
  137.     The following apply to QUIRKS mode:
  138.     1)  NEAR or SHORT jumps are generated even if FAR is specified,
  139.         if source and destination segments are the same.
  140.     2)  Type checking for some two-argument instructions is disabled,
  141.         for example, MOV ES,BYTEPTR is allowed.
  142.     3)  Forces an EQU to an expression with PTR in it to be a text
  143.         macro.
  144.     4)  Forces an EQU to an expression with : in it to be a
  145.         text macro. 
  146.     5)  Forces an EQU to an expression with OFFSET in it to be a text
  147.         macro. 
  148.     6)  Forces SHL operator to lose track of sign info.
  149.     7)  Forces numeric equates (= or numeric EQU) to lose complex
  150.         expression information such as segment, fixup type.
  151.     8)  Reduces priority of GLOBAL, UNION keywords so that they may
  152.         be overridden.
  153.     9)  Causes warning instead of error to be generated if the second
  154.         argument is missing in a two-argument instruction.
  155.     10) Allows REPT without argument to be interpreted as REPT 0.
  156.     11) Disables test for extra stuff on line after IF conditional.
  157.  
  158.     The following apply to QUIRKS with MASM51:
  159.     1)  @@, @F, and @B are enabled.
  160.     2)  Trailing language ID after NEAR or FAR in procedure
  161.         declaration is allowed.
  162.     3)  All procedure symbols are published globally.
  163.     4)  :: label definitions are allowed.
  164.  
  165.  
  166. o MASM compatibility pass
  167.  
  168.     Using TASM's /m command-line switch will generate a MASM-style
  169.     second pass (compatibility pass) when the following
  170.     constructions are present:
  171.  
  172.       o IF1 and IF2 directives
  173.       o .ERR1 and .ERR2 directives
  174.       o ELSEIF1 and ELSEIF2 directives
  175.       o Forward references with IFDEF or IFNDEF
  176.       o Forward references with the .TYPE operator
  177.       o Recursively defined numbers (FOO=FOO+1)
  178.       o Forward-referenced or recursively defined text macros 
  179.           (FOO CATSTR FOO,<1>) 
  180.       o Forward referenced macros
  181.  
  182.     The execution of the compatibility pass effectively disables
  183.     the advantages associated with Turbo Assembler's multiple pass
  184.     capabilities.
  185.  
  186.  
  187. o Updated example files
  188.  
  189.     The WHEREIS example file has been updated to reflect some of
  190.     the new TASM 2.0 features. In addition, IWHGLOBL.INC and
  191.     IWHEREIS.ASM in TAEXMPL1.ZIP and GLOBALS.INC in TAEXMPL2.ZIP
  192.     have been changed to remove the warning message "Global type
  193.     doesn't match symbol type."
  194.  
  195.  
  196. o SMART/NOSMART directives
  197.  
  198.     One of the optimizations that TASM 2.0 performs is to change
  199.     FAR calls to an address in the same segment into a PUSH CS
  200.     followed by a CALL NEAR.  Any FAR procedures that have an
  201.     EXTRN definition declared inside a segment are considered to
  202.     be in that segment, and TASM will generate the PUSH CS, CALL
  203.     NEAR instructions for them.  To avoid this, put a procedure's
  204.     EXTRN definition inside of a segment only if the procedure
  205.     is actually in that segment, or put NOSMART and SMART
  206.     directives around calls to the procedure in that segment.
  207.  
  208.  
  209. o Turbo Assembler 2.0 Reference Guide corrections
  210.  
  211.     P. 187  In the section titled "Examples," make the following
  212.     changes:
  213.  
  214.       prog.exe: myprog.asm prog2.asm include\stdio.inc
  215.       tasm /t myprog.asm   # Recompile myprog using Turbo Assembler
  216.       tasm /t prog2.asm # Recompile prog2 using Turbo Assembler
  217.       tlink myprog prog2, prog
  218.  
  219.         Here are some better examples:
  220.  
  221.         prog.exe: myprog.obj prog2.obj
  222.         tlink myprog prog2, prog
  223.  
  224.         myprog.obj: myprog.asm include\stdio.inc
  225.         tasm myprog.asm
  226.  
  227.         prog2.obj: prog2.asm include\stdio.inc
  228.         tasm prog2.asm
  229.  
  230. P. 196  The directives in Table D.1 should be uppercase.
  231.  
  232. P. 212  Ignore the second paragraph under the section "Turbo Link";
  233.         TASM does not call TLINK.
  234.  
  235.  
  236. 4.  FILES ON THE DISK
  237. ---------------------
  238.  
  239.   TURBO ASSEMBLER/INSTALLATION
  240.   ----------------------------
  241.   INSTALL  EXE  -  Turbo Assembler installation program
  242.   README   COM  -  Reads this README
  243.   UNZIP    EXE  -  Program to unzip the .ZIP files
  244.   TASM     ZIP  -  Turbo Assembler 2.0 and Utilities
  245.     TASM     EXE  -  Turbo Assembler 2.0
  246.     TLINK    EXE  -  Borland Turbo Linker
  247.     MAKE     EXE  -  Program for managing projects
  248.     GREP     COM  -  Turbo GREP program
  249.     TCREF    EXE  -  Turbo Assembler cross-reference utility
  250.     OBJXREF  COM  -  Object file cross-reference utility
  251.     TOUCH    COM  -  Program that updates a file's date and time
  252.     TLIB     EXE  -  Borland Turbo Librarian
  253.  
  254.   MANUAL   ZIP  -  Turbo Assembler 2.0 Documentation files.
  255.     UPDATE   DOC  -  Complete description of new TASM 2.0 features
  256.     UTIL     DOC  -  Updated information on the TASM 2.0 utilities
  257.     HELPME!  DOC  -  Text file with the answers to many common
  258.                      questions. Please read HELPME!.DOC before
  259.                      contacting Technical Support
  260.     BASIC    DOC  -  Interfacing Turbo Assembler with Turbo Basic
  261.     PROLOG   DOC  -  Interfacing Turbo Assembler with Turbo Prolog
  262.  
  263.   MMACROS  ZIP  -  MASM Mode Macros
  264.     BIOS     INC  -  Equates representing the BIOS services
  265.     DOS      INC  -  Equates representing the DOS services
  266.     KBD      INC  -  Equates representing the IBM PC keyboard keystrokes
  267.     MBIOS    MAC  -  Macros used to interface with the IBM PC BIOS. 
  268.                      MASM Mode
  269.     MDOS     MAC  -  Macros to interface with DOS. MASM Mode
  270.     MMACROS  MAC  -  General macros. MASM Mode
  271.  
  272.   README        -  This file
  273.  
  274.  
  275.   TURBO ASSEMBLER/EXAMPLES
  276.   ------------------------
  277.   TAEXMPL1 ZIP  -  Ideal mode example and macros
  278.     BIOS     INC  -  Equates representing the BIOS services
  279.     BIOSMAC  DOC  -  Documentation for macros implemented in ?BIOS.MAC
  280.     DEMO1    BAT  -  Batch file to make Whereis.exe
  281.     DOS      INC  -  Equates representing the DOS services
  282.     DOSMAC   DOC  -  Documentation for macros implemented in ?DOS.MAC
  283.     IASCIIZS ASM  -  Routine to display an ASCIIZ string
  284.     IBIOS    MAC  -  Ideal mode macros used to interface with the 
  285.                      IBM PC BIOS
  286.     IBYTECPY ASM  -  Routine that copies an array of bytes from one
  287.                      location to another
  288.     IDELCHAR ASM  -  Routine that deletes n characters from a
  289.                      Pascal-style string starting at position i
  290.     IDOS     INC  -  Type declarations used to interface with DOS
  291.     IDOS     MAC  -  Macros to interface with DOS. Ideal Mode
  292.     IEXECDOS ASM  -  Routines to handle calling DOS to perform a
  293.                      command on a file
  294.     IFINDBYT ASM  -  Routine that searches an array of bytes, looking
  295.                      for a value; routine that returns the length of
  296.                      an ASCIIZ string.
  297.     IFINDFIL ASM  -  Routine that does a recursive search of a hard disk
  298.                      looking for a file
  299.     IFINDREP ASM  -  Routine that searches through an array of
  300.                      bytes, replacing all instances of a value
  301.                      with another value.
  302.     ILOCSTRG ASM  -  Routine that searches through memory looking
  303.                      for the nth Pascal-style string
  304.     IMACROS  MAC  -  General macros. Ideal Mode
  305.     IPARAM   ASM  -  Routines to return the # of command-line
  306.                      parameters and the contents of an individual
  307.                      parameter
  308.     IPARSEFN ASM  -  Routine that parses a file name into Drive,
  309.                      Path, and File spec
  310.     ISKPWHIT ASM  -  Routine to advance a pointer past any whitespace
  311.                      in an array of bytes
  312.     IWHEREIS ASM  -  Main module for Whereis program
  313.     IWHGLOBL INC  -  Global declarations for Whereis
  314.     IWRITEPS ASM  -  Routine to display a Pascal-style string
  315.     KBD      INC  -  Equates representing the IBM PC keyboard keystrokes
  316.     WHEREIS  DOC  -  Documentation for Whereis file locator program
  317.     WHEREIS  MAK  -  Make file for creating Whereis.exe using the Make
  318.                      utility
  319.     WHUSAGE  INC  -  Usage screen text
  320.  
  321.   TAEXMPL2 ZIP  -  FILT and standard segmentation (SHOW87) examples
  322.     CONVERT1 INC  -  Converts from binary numbers to strings
  323.     CONVERT2 INC  -  Converts from floating point to integer numbers
  324.     DEMO3    BAT  -  Batch file to make Filt.exe text filter program
  325.     DEMO2    BAT  -  Batch file to build Show87
  326.     FILT     ASM  -  Text filter main file
  327.     FILT     DOC  -  Documentation file for Filt.exe text filter
  328.                      program
  329.     FILT     MAK  -  Make file for creating Filt.exe using the
  330.                      make utility
  331.     FILT     RSP  -  Linker response file for linking Filt.exe
  332.     GLOBALS  INC  -  Declares procedures and symbols needed by
  333.                      the modules of FILT
  334.     OBYTEHI  ASM  -  Processes the current high byte value in AL
  335.     OBYTELOW ASM  -  Processes the current low byte value in AL
  336.     OBYTENRM ASM  -  Processes the current normal byte value in AL
  337.     OCMDNUM  ASM  -  Parses the command line
  338.     OERREXIT ASM  -  Handles the printing of error messages
  339.     OFCREATE ASM  -  Creates or truncates a file; the file is opened
  340.                      for writing
  341.     OFILALOC ASM  -  Allocates a read/write buffer
  342.     OFILCLOS ASM  -  Closes a file
  343.     OFILEFIL ASM  -  Fills a read buffer
  344.     OFILFREE ASM  -  Deallocates a read/write buffer
  345.     OFILREAD ASM  -  Reads from a file
  346.     OFILWRIT ASM  -  Writes to a file
  347.     OFLFLUSH ASM  -  Flushes the write buffer
  348.     OFOPENR  ASM  -  Opens a file for reading
  349.     OFOPENW  ASM  -  Opens a file for writing
  350.     OLOCASE  ASM  -  Routine converts a letter to lowercase
  351.     OPARSCMD ASM  -  Parses the command line
  352.     OPRCBYTE ASM  -  Processes a byte
  353.     OPROCDOC ASM  -  Processes an entire document, one line at a time
  354.     OPROCLIN ASM  -  Processes a line
  355.     OSETOPTN ASM  -  Sets options for FILT
  356.     OSPACES  ASM  -  Stores a specified number of spaces at
  357.                      particular location
  358.     OSTORSPC ASM  -  Stores any currently stored spaces
  359.     OSTORTAB ASM  -  Stores a tab character if there are any spaces
  360.                      to compress
  361.     OTABCLR  ASM  -  Clears all tab stops
  362.     OTABNEXT ASM  -  Returns the number of spaces to the next tab stop
  363.     OTABRSET ASM  -  Sets tab stops every eight columns
  364.     OTABSET  ASM  -  Sets a tab stop at a specified column location
  365.     OUPCASE  ASM  -  Converts a letter to uppercase
  366.     SHOW87   ASM  -  Standard Segmentation Demo Program
  367.     SHOW87   DOC  -  Documentation for Show87 8087 register display
  368.                      program
  369.     VIDEO1   INC  -  Routines to display text and control the screen
  370.     VIDEO2   INC  -  Routines to display formatted text strings
  371.  
  372.   CHAPXMPL ZIP  -  Example Programs from the Manual
  373.  
  374.      Note: This file is not automatically unzipped when Turbo Assembler
  375.            is installed to a hard disk. To unzip these files you
  376.            will first need to switch to the drive and
  377.            subdirectory containing this file and then give the
  378.            command
  379.  
  380.            unzip /o chapxmpl
  381.  
  382.     Example         Pre-2.0 Doc        2.0 Doc
  383.     
  384.     HELLO    ASM  -  Pg   9             Pg   11
  385.     HELLO2   ASM  -  Pg  13             Pg   15
  386.     HELLOPRN ASM  -  Pg  15             Pg   17
  387.     REVERSE  ASM  -  Pg  16             Pg   18
  388.     ECHOCHAR ASM  -  Pg  55             Pg   72
  389.     MODCHAR  ASM  -  Pg  80             Pg   78
  390.     DELAY    ASM  -  Pg  88             Pg   87
  391.     DSLYSTR  ASM  -  Pg 109             Pg  105
  392.     USE_ES   ASM  -  Pg 110             Pg  107
  393.     STDSEG   ASM  -  Pg 115             Pg  111
  394.     STRINGS  ASM  -  Pg 132             Pg  127
  395.     PRNTSTR  ASM  -  Pg 175             Pg  163
  396.     CNTWORDS ASM  -  Pg 181             Pg  168
  397.     MAIN     ASM  -  Pg 207             Pg  191
  398.     SUB1     ASM  -  Pg 208             Pg  191
  399.     PLUSONE  C    -  Pg 282             Pg  262
  400.     SQRETBLE C    -  Pg 287             Pg  266
  401.     SQRTBLE2 C    -  Pg 287             Pg  266
  402.     STRINGUP C    -  Pg 293             Pg  271
  403.     DOTOTAL  ASM  -  Pg 305             Pg  283
  404.     SHOWTOT  C    -  Pg 306             Pg  284
  405.     DOTOTAL2 ASM  -  Pg 307             Pg  285
  406.     TOGLFLAG C    -  Pg 313             Pg  290
  407.     TOGFLAG  ASM  -  Pg 313             Pg  290
  408.     COUNT    ASM  -  Pg 327             Pg  304
  409.     CALLCT   C    -  Pg 328             Pg  305
  410.     COUNTLG  ASM  -  Pg 329             Pg  305
  411.     CALCAVG  C    -  Pg 334             Pg  311
  412.     AVERAGE  ASM  -  Pg 334             Pg  312
  413.     SAMPLE   PAS  -  Pg 344             Pg  322
  414.     ASMPROC  ASM  -  Pg 344             Pg  322
  415.     TSAMPLE  PAS  -  Pg 345             Pg  323
  416.     HEXSTR   ASM  -  Pg 357             Pg  334
  417.     HEXTEST  PAS  -  Pg 358             Pg  336
  418.     XCHANGE  ASM  -  Pg 360             Pg  337
  419.     XCHANGE  PAS  -  Pg 361             Pg  338
  420.     ENVSTR   ASM  -  Pg 362             Pg  340
  421.     ENVTEST  PAS  -  Pg 364             Pg  342
  422.     SCROLLH  PRO  -  Pg 387             see Prolog.doc
  423.     SCROL    ASM  -  Pg 388             see Prolog.doc
  424.     MYPROLOG PRO  -  Pg 391             see Prolog.doc
  425.     MYASM    ASM  -  Pg 391             see Prolog.doc
  426.     ADDPRO   PRO  -  Pg 393             see Prolog.doc
  427.     ADD      ASM  -  Pg 393             see Prolog.doc
  428.     SHOWMESS PRO  -  Pg 395             see Prolog.doc
  429.     FROM_ASM ASM  -  Pg 395             see Prolog.doc
  430.     SHOWNEW  PRO  -  Pg 396             see Prolog.doc
  431.     FROM_NEW ASM  -  Pg 396             see Prolog.doc
  432.     FUNC     PRO  -  Pg 398             see Prolog.doc
  433.     IFUNC    ASM  -  Pg 398             see Prolog.doc
  434.     MULT_C&D ASM  -  Pg 469             Pg  404
  435.     PRIMES   ASM  -  Pg 521             Pg  449
  436.     MASEXMPL ASM  -  Pg 548             Pg  476
  437.     IDLEXMPL ASM  -  Pg 549             Pg  477
  438.  
  439.   THELP    ZIP  -  Turbo Help files for Turbo Assembler 2.0
  440.     THELP    COM  -  Borland Turbo Help
  441.     TASM     TAH  -  Turbo Assembler Help text file
  442.     THELP    DOC  -  Information about THELP.COM
  443.  
  444.   TFEXMPL2 ZIP  -  Turbo Profiler example files
  445.     PRIME0   C
  446.     PRIME0   EXE
  447.     PRIME1   C
  448.     PRIME1   EXE
  449.     PRIME2   C
  450.     PRIME2   EXE
  451.     PRIME3   C
  452.     PRIME3   EXE
  453.     PRIME4   C
  454.     PRIME4   EXE
  455.     PRIME5   C
  456.     PRIME5   EXE
  457.     PRIME6   C
  458.     PRIME6   EXE
  459.  
  460.   TFHELP   ZIP  -  Turbo Help file for Turbo Profiler 1.0
  461.     TFHELP   TFH
  462.  
  463.  
  464. NOTE: If you have the 3.5" version of Turbo Assembler, you can
  465.       find all files on one disk.
  466.