home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 240.img / TASM20-1.ZIP / MANUAL.ZIP / HELPME!.DOC < prev    next >
Encoding:
Text File  |  1990-05-07  |  10.7 KB  |  253 lines
  1.  
  2. TURBO ASSEMBLER 2.0: ANSWERS TO COMMON QUESTIONS
  3. ------------------------------------------------
  4.  
  5.   The following are tips, tricks, and hints you may find useful
  6.   when using Turbo Assembler.
  7.  
  8.  
  9.  Q. How do I install Turbo Assembler?
  10.  A. Run the INSTALL program from the TURBO ASSEMBLER/INSTALLATION
  11.     disk. To start the installation, change your current drive to
  12.     the one that has the install program on it and type INSTALL.
  13.     You will be given instructions in a box at the bottom of the
  14.     screen for each prompt. For example, if you will be
  15.     installing from drive A:, type
  16.  
  17.       A:
  18.       INSTALL
  19.  
  20.     At this point, the INSTALL program will appear with menu
  21.     selections and descriptions to guide you through the
  22.     installation process.
  23.  
  24.  Q. When should I use the different assembly modes TASM provides
  25.     for existing assembly programs?
  26.  A. Mode                   Conditions for Use
  27.     -------------------------------------------------------------
  28.     Normal(MASM)         - Program assembles under MASM 4.00 or
  29.                            MASM 5.00.
  30.     Quirks               - Program assembles under MASM 4.00 or
  31.                            MASM 5.00, but won't assemble under
  32.                            TASM without MASM51 or QUIRKS.
  33.     Masm51               - Program requires MASM 5.1 for assembly.
  34.     Masm51 and Quirks    - Program requires MASM 5.1 for
  35.                            assembly, but will not assemble
  36.                            under TASM with only the MASM51
  37.                            switch set.
  38.  
  39.  Q. Do I have to use MASM51 to assemble files written for MASM
  40.     5.1?
  41.  A. Most files will assemble even without using the MASM51
  42.     directive. However if your assembly code utilizes features
  43.     only found in MASM 5.1, you will need to use the MASM51 mode.
  44.     Check the table in the next Q&A to see which features of MASM51
  45.     emulation are enabled by combinations of MASM51 and QUIRKS
  46.     modes.
  47.  
  48.  Q. What items are controlled by the QUIRKS and MASM51 modes?
  49.  A. The following table lists what the various combinations of
  50.     QUIRKS and MASM51 modes do:
  51.  
  52.     Mode                   Operations
  53.     -------------------------------------------------------------
  54.     Quirks               - Allows FAR jumps to be generated as
  55.                            NEAR or SHORT if CS assumes agree.
  56.                          - Allows all instruction sizes to be
  57.                            determined in a binary operation solely
  58.                            by a register, if present.
  59.                          - Destroys OFFSET, segment override,
  60.                            etc., information on '=' or numeric 'EQU'
  61.                            assignments.
  62.                          - Forces EQU assignments to expressions
  63.                            that contain "PTR" or ":" to be text.
  64.  
  65.     Masm51               - Instr, Catstr, Substr, Sizestr, and
  66.                            "\" line continuation are all enabled.
  67.                          - EQU's to keywords are made TEXT
  68.                            instead of ALIASes.
  69.                          - Leading whitespace is not discarded
  70.                            on %textmacro in macro arguments.
  71.  
  72.     Masm51 and Quirks    - Everything listed under QUIRKS above.
  73.                          - Everything listed under MASM51 above.
  74.                          - @@, @F, and @B local labels are
  75.                            enabled.
  76.                          - Procedure names are PUBLIC'ed
  77.                            automatically in extended MODELs.
  78.                          - Near labels in PROCs are redefinable
  79.                            in other PROCs.
  80.                          - "::" operator is enabled to define
  81.                            symbols that can be reached outside of
  82.                            current proc.
  83.  
  84.     Masm51 and Ideal     - Ideal mode syntax and the Masm51 text
  85.                            macro directives are supported, i.e.,
  86.                            Instr, Catstr, Substr, and Sizestr.
  87.  
  88.   Q. When should I use the DOSSEG or .STACK directives?
  89.   A. When you're developing Turbo Assembler modules to link with
  90.      high-level languages like Turbo C++ and Turbo Pascal, you
  91.      don't need the DOSSEG or .STACK directives because these
  92.      compilers will handle segment-ordering and stack setup.
  93.      These directives define segment names and order that might
  94.      conflict with those used by the high-level language. You
  95.      only need, however, to define these once in any module of a
  96.      standalone assembler program. DOSSEG is only needed if you
  97.      want your segments to be ordered using Microsoft's
  98.      conventions. You can define your own segment-ordering by
  99.      ensuring that your segments are encountered by TLINK in the
  100.      order that you wish. See the TLINK section of the manual for
  101.      a full description of how this works.
  102.  
  103.   Q. What options should I use when I use Turbo Assembler to
  104.      assemble the files that came with the Microsoft C Compiler?
  105.   A. When assembling the assembly language modules provided with the
  106.      Microsoft compilers, make sure to use the MASM51 and QUIRKS
  107.      modes. For example,
  108.  
  109.        tasm /jmasm51 /jquirks filename
  110.  
  111.   Q. How do I create a .COM file?
  112.   A. Your assembler source should be assembled in the tiny model
  113.      (.MODEL TINY) and should include an ORG 100h following the
  114.      opening of the code segment, as shown below:
  115.  
  116.                 .MODEL  TINY
  117.                 .CODE
  118.                 ORG     100h
  119.         start:
  120.                 ....          ; body of program
  121.         END     start         ; defines the entry point as start
  122.  
  123.      Don't include a .STACK directive in a program designed to be
  124.      a .COM.
  125.  
  126.      TLINK will create a .COM file instead of an .EXE file if the /t
  127.      option is specified. For example,
  128.  
  129.         tlink /t SHOW87
  130.  
  131.      will create SHOW87.COM instead of SHOW87.EXE.
  132.  
  133.      There are certain limitations in converting an .EXE file to a
  134.      .COM file. These limitations are documented in the IBM Disk
  135.      Operating System manual under EXE2BIN.
  136.  
  137.   Q. How do I assemble multiple files with Turbo Assembler?
  138.   A. Turbo Assembler will assemble multiple files using wildcard
  139.      characters or separating them by the plus (+) character.
  140.      As an example, the following command line
  141.  
  142.        tasm filt + o*
  143.  
  144.      would assemble the file FILT.ASM, as well as all the .ASM
  145.      files beginning with the letter 'o'.
  146.  
  147.   Q. How can I assemble multiple files if they don't all use the
  148.      same command-line options?
  149.   A. Turbo Assembler uses the semicolon (;) character as a
  150.      command-line separator so that you can actually have
  151.      multiple assembler command lines on a single DOS command
  152.      line. As an example, the following command line
  153.  
  154.        tasm /zi filt; o*
  155.  
  156.      would assemble the file FILT.ASM with debug information
  157.      turned on, then assemble all the .ASM files beginning with
  158.      the letter 'o' without debug information.
  159.  
  160.   Q. Microsoft's Macro Assembler allows me to define environment
  161.      variables so I don't have to enter them on every command
  162.      line. Can I do this with Turbo Assembler as well?
  163.   A. No, but Turbo Assembler provides an even more flexible way
  164.      to eliminate typing in command-line options every time.
  165.      Whenever you run Turbo Assembler, it looks in the current
  166.      directory, then in the directory from which it was started
  167.      (DOS 3.x and greater) for a special file called TASM.CFG.
  168.      This file can contain anything that the command line
  169.      contains. This file is processed first and then the command
  170.      line so that the command-line options take priority over
  171.      those found in the TASM.CFG configuration file. If, for
  172.      instance, your command-line options are always
  173.  
  174.        /t /ml /zi /jJUMPS /jLOCALS
  175.  
  176.      you could create TASM.CFG file containing these lines
  177.  
  178.        /t
  179.        /ml
  180.        /zi
  181.        /jJUMPS
  182.        /jLOCALS
  183.  
  184.      Now, every time you run Turbo Assembler, those will be the
  185.      default options. This means that, if you need to, you can
  186.      have separate TASM.CFG files for each of your projects. If
  187.      you have multiple projects residing in a single subdirectory,
  188.      then you could create a separate configuration file for each
  189.      and use them as Turbo Assembler indirect command files.
  190.  
  191.   Q. What are Turbo Assembler indirect command files?
  192.   A. These are files that contain partial or complete Turbo
  193.      Assembler command lines and are preceded with an at-sign (@)
  194.      on the command line. For example, if you have a file named
  195.      "FILE.CMD" that contains the following,
  196.  
  197.        /t
  198.        /ml
  199.        /zi
  200.        /jJUMPS
  201.        /jLOCALS
  202.        file1 +
  203.        file2 +
  204.        file3 +
  205.        file4
  206.  
  207.      then you could use the command line
  208.  
  209.        tasm @FILE.CMD
  210.  
  211.      instead of the command line
  212.  
  213.        tasm /t /ml /zi /jJUMPS /jLOCALS file1+file2+file3+file4
  214.  
  215.      Note that the at-sign (@) is not actually part of the file's
  216.      name. In fact, if you name a file with an at-sign at the
  217.      beginning, Turbo Assembler will treat it as an indirect
  218.      command file.
  219.  
  220.   Q. I am linking my own assembly language functions with Turbo C.
  221.      Why does the linker report that all of my functions are
  222.      undefined?
  223.   A. Make sure you've put an underbar character (_) in front
  224.      of all assembly language function names to be called
  225.      by Turbo C. If you use simplified segmentation and include
  226.      the C language specifier on the .MODEL directive, Turbo
  227.      Assembler will pre-append the underbar automatically for you.
  228.      Your assembly language program should be assembled with Case
  229.      Sensitivity (/ML or /MX). See Chapter 7, "Interfacing
  230.      Turbo Assembler with Turbo C" in the Turbo Assembler User's
  231.      Guide for details.
  232.  
  233.   Q. Can I use the backslash (\) instead of the slash (/) as a
  234.      option specifier?
  235.   A. NO! Turbo Assembler (and MASM) will treat that as a file
  236.      that resides in the root directory of the default drive.
  237.      Since both assemblers treat the space character ( ) as a
  238.      comma (,) this could result in the loss of files. If you
  239.      accidentally gave this command line,
  240.  
  241.       tasm \zi prid&joy.asm
  242.  
  243.      Turbo Assembler (and MASM) would treat this command line as
  244.      instructions to assemble a file called ZI.ASM that can be
  245.      found in the root directory and create an output file in the
  246.      current directory called PRID&JOY.ASM. (Note that the
  247.      assemblers think the default extension for the object file
  248.      of .OBJ has been explicitly overridden to .ASM.) The file
  249.      PRID&JOY.ASM will either be overwritten with the object file
  250.      or deleted if the file \ZI.ASM can't be found and success-
  251.      fully assembled. In either case, the original contents of
  252.      PRID&JOY.ASM are now lost.
  253.