home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 10 / ioProg_10.iso / soft / masm / ml612.exe / README.TXT < prev    next >
Encoding:
Text File  |  1997-08-27  |  32.9 KB  |  876 lines

  1.  
  2.                    README.TXT File
  3.  
  4.            Release Notes for the Microsoft(R) MASM
  5.         Professional Development System, Version 6.12
  6.  
  7.      (C) Copyright 1997, Microsoft Corporation.  All rights reserved.
  8.                       
  9.      This document contains release notes for the Microsoft MASM 
  10.      Professional Development System, version 6.12. The information in 
  11.      this document and in the Microsoft Advisor (Online Help) is more 
  12.      up-to-date than the manuals.
  13.  
  14.      The printed documentation for MASM 6.11 has not changed from MASM 
  15.      6.10. MASM 6.12 is being released as a patch for users of MASM 6.11.
  16.      The MASM 6.11 installation disks provide several important files that 
  17.      include new or updated information for this release. They are:
  18.  
  19.      README.TXT =====> Contains patch installation instructions, 
  20.                documentation errors, system requirements, information 
  21.                and tips on using MASM 6.1x, and known assembler bugs.
  22.  
  23.      CV.TXT =========> Contains release notes for Microsoft CodeView(TM).
  24.  
  25.      ERRMSG.TXT =====> Contains updated information on 32-bit Linker errors,
  26.                ML error messages, and Microsoft DOSXNT MS-DOS 
  27.                Extender error messages.
  28.  
  29.      SAMPLES.TXT ====> Contains information about MASM samples for MS-DOS 
  30.                and Microsoft Windows 3.1.
  31.  
  32.      NTSAMPLE.TXT ===> Contains information about MASM samples for 
  33.                Microsoft Windows NT.
  34.  
  35.      SUPPORT.TXT ====> Contains updated Microsoft Product Support policies.
  36.   
  37.      Information on new Intel processor instructions can be found in the 
  38.      following locations:
  39.  
  40.      Intel(R) Pentium(TM) ====> In PENTIUM.TXT installed with MASM 6.11
  41.  
  42.      Intel(R) MMX(TM) ========> On the World Wide Web at: 
  43.                     www.intel.com/drg/mmx/manuals/prm/prm.htm
  44.  
  45. ======================< README.TXT Table of Contents >=====================
  46.  
  47.      Part 1: Patch Installation
  48.      --------------------------
  49.  
  50.      Part 2: Documentation Errors
  51.      ----------------------------
  52.  
  53.      Part 3: System Requirements
  54.      ---------------------------
  55.  
  56.      Part 4: Tips for Using MASM 6.1x
  57.      --------------------------------
  58.          - ALIAS directive
  59.          - Assembling Files Generated by Compiler
  60.          - Building 32-Bit Applications
  61.            - 32-Bit Linking
  62.            - GROUP Directive and Flat-Model Programming
  63.            - Structure Packing Issues for Mixed Language Programming
  64.            - /WIN32 Switch for H2INC
  65.          - CD-ROM Not a Valid Target
  66.          - CMP Instruction Encoding
  67.          - Debugging MASM Applications under Visual C++, 32-Bit 
  68.            Edition, or Fortran PowerStation, 32-Bit Edition      
  69.          - INVOKE Command
  70.          - Multi-File Assembly with MASM.EXE
  71.          - NMAKE and NMAKER
  72.          - Response Files
  73.          - SAMPLES.TXT and NTSAMPLE.TXT
  74.          - Using MASM 6.x Structures
  75.          - Visual C++ 1.0/Fortran PowerStation 1.0 Compatibility
  76.          - Working with MASM 5.1 Code
  77.          - Working With Microsoft BASIC Far Strings
  78.          - .FPO directive new to MASM 6.11a
  79.  
  80.      Part 5: Known Assembler Bugs
  81.      ----------------------------
  82.          - Expression Order in High-Level Conditionals
  83.          - Hexadecimal Constants
  84.          - Initializing Nested Structures
  85.          - Span-Dependent Expressions used in Macros
  86.          - Span-Dependent Equates in Macros and EXTERNDEF ABS
  87.          - Span-Dependent Text Equates
  88.          - STRUCT and RECORD Initialization
  89.  
  90.      Part 6: What Has Been Fixed in 6.11d?
  91.      -------------------------------------
  92.  
  93.      Part 7: What Has Been Fixed in 6.12?
  94.      -------------------------------------
  95.  
  96.      Part 8: What Has Been Added in 6.12?
  97.      -------------------------------------
  98.  
  99.  
  100. ====================< Part 1: Patch Installation >=========================
  101.  
  102.      1. Make backup copies of the files affected by the patch.  These 
  103.     files are all in the MASM bin directory (for example, 
  104.     C:\MASM611\BIN).  The following files will be affected:
  105.  
  106.     ML.EXE
  107.     ML.ERR
  108.     H2INC.EXE
  109.     H2INC.ERR
  110.  
  111.      2. Change to your MASM 6.11 root directory.  For example:
  112.  
  113.     C:
  114.     CD \MASM611
  115.  
  116.      3. Copy the patch files to your MASM 6.11 root directory.  
  117.     The patch files are:
  118.  
  119.     PATCH.EXE
  120.     PATCH.RTD
  121.     PATCH.RTP
  122.  
  123.      4. Run the patch program by typing:
  124.  
  125.            PATCH
  126.  
  127.     The patch program indicates its actions as it runs.  When the 
  128.     patch has been successfully completed, you can delete the patch 
  129.     files.
  130.  
  131.      5. Copy H2INC.EXE and H2INC.ERR from the patch diskette to your 
  132.     \masm611\bin directory. 
  133.  
  134.      If you have problems installing this patch: 
  135.  
  136.      - Check that you have all three patch files: 
  137.        PATCH.EXE, PATCH.RTP, and PATCH.RTD.
  138.  
  139.      - Make sure you have the correct version of the files to be updated.  
  140.        This patch will only patch files from MASM 6.11, 6.11a, or 6.11d.
  141.  
  142.      If, after checking these possibilities, you still have problems, 
  143.      please contact Microsoft Product Support.
  144.  
  145.  
  146. ====================< Part 2: Documentation Errors >=======================
  147.  
  148.      Environment and Tools, Page xxiii: Microsoft Support Services
  149.      -------------------------------------------------------------
  150.      Microsoft Support Services information has been updated. See
  151.      SUPPORT.TXT, in the directory in which you installed MASM, for
  152.      the most current Microsoft support information and policies.
  153.      
  154.      
  155.      Environment and Tools, Page 582: LIB Command Line Sample
  156.      --------------------------------------------------------
  157.      The following example, as it appears on page 582, is incorrect:
  158.  
  159.         LIB FIRST +SECOND, , THIRD
  160.  
  161.      Instead, it should read:
  162.  
  163.         LIB THIRD +FIRST +SECOND
  164.  
  165.      
  166.      Environment and Tools, Page 649, 651: _syscall and __syscall
  167.      ------------------------------------------------------------
  168.      The H2INC documentation on pages 649 and 651 lists _syscall and
  169.      __syscall as C keywords recognized by H2INC. These are not recognized,
  170.      and should be removed.
  171.  
  172.      
  173.      Environment and Tools, Page 819: Error Message A2156
  174.      ----------------------------------------------------
  175.      The value range given for the first parameter of the PAGE directive
  176.      is incorrect; "...either 0 or a value in the range of 10-255" should
  177.      read "...either 0 or a value in the range of 14-255."
  178.      
  179.      
  180.      Reference, Page 12: ML Command-line Options /Cu and /Cx
  181.      -------------------------------------------------------
  182.      /Cu is not the default command-line option, but is indicated as such
  183.      in the MASM 6.10 Reference. Instead, /Cx should be indicated as the 
  184.      default.
  185.      
  186.      
  187.      Reference, Page 98: LEA is no longer optimized
  188.      ----------------------------------------------
  189.      The MASM 6.10 Reference indicates that the LEA instruction is
  190.      encoded as a MOV when the source operand is a direct memory address.
  191.  
  192.      In response to programmer requests, MASM 6.1x no longer performs this 
  193.      optimization automatically.  The optimization can be performed by 
  194.      using the OPATTR operator, as shown in the following macro:
  195.  
  196.       MOVLEA MACRO Dest, Symbol
  197.       IF (OPATTR(Symbol)) AND 08h
  198.            MOV Dest, OFFSET Symbol
  199.       ELSE
  200.            LEA Dest, Symbol
  201.       ENDIF
  202.       ENDM
  203.  
  204.      
  205.      Programmer's Guide, Page 156: Using an Emulator Library
  206.      -------------------------------------------------------
  207.      The sample code demonstrating floating-point instructions served
  208.      by an emulator contains the directive .STARTUP. This directive
  209.      should be removed.
  210.  
  211.      
  212.      Programmer's Guide, Page 202: User-Defined Epilogues & Prologues
  213.      ----------------------------------------------------------------
  214.      The documentation for user-defined epilogue and prologue code reads
  215.      "Your macro function must return the parmbytes parameter."  It
  216.      should read "...the localbytes parameter."
  217.  
  218.      
  219.      Programmer's Guide, Page 323: The C++/MASM Interface
  220.      ----------------------------------------------------
  221.      The second sentence in the third paragraph reads: "The linkage 
  222.      specification applies only to called routines, not to external
  223.      variables." It should read "The linkage specification applies to
  224.      called routines and external variables." The last sentence in the
  225.      same paragraph should be removed.
  226.      
  227.  
  228.      Help for Runtime Error R6921
  229.      ----------------------------
  230.      The on-line help for runtime error R6921 reads "...Possibly the
  231.      CONFIG.SYS file contained a line such as DEVICE=C:\OS\MM386.EXE..."
  232.      The file name should read "C:\DOS\EMM386.EXE".
  233.  
  234.  
  235. =================< Part 3: MASM 6.12 System Requirements >=================
  236.  
  237.      The following are system requirements for Microsoft MASM 6.12:
  238.  
  239.      - Personal computer using a 386 or higher processor running Windows 95, 
  240.        or Windows NT version 3.1 or later.
  241.      - 4 MB of available memory.
  242.      - Hard disk with 10 MB available space.
  243.      - One 3.5" high-density (1.44 MB) disk drive (3.5" low-density (720K) 
  244.        or 5.25" high-density (1.2 MB) disks available separately with 
  245.        coupon enclosed).
  246.  
  247.      To target Windows 3.1, you need one of the following:
  248.  
  249.      - Microsoft Windows Software Development Kit (SDK) 3.1.
  250.      - Microsoft Visual C++ Development System, Standard or Professional 
  251.        Edition.
  252.  
  253.      To target Windows NT, you need one of the following:
  254.  
  255.      - Microsoft Windows NT Software Development Kit (SDK).
  256.      - Microsoft Visual C++ Development System, 32-Bit Edition.
  257.  
  258.  
  259. ====================< Part 4: Tips for Using MASM 6.1x >===================
  260.      
  261.      ALIAS directive
  262.      ---------------
  263.      The ALIAS directive is not included in the printed documentation
  264.      for MASM 6.10. The ALIAS directive can be used for creating 
  265.      libraries that allow the linker (LINK) to map an old function to 
  266.      a new function. 
  267.  
  268.      Syntax:    ALIAS  <alias> = <actual-name>
  269.  
  270.      where alias is the alternate or alias name, and actual-name is
  271.      the actual name of the function or procedure. The angle brackets
  272.      are required.
  273.  
  274.  
  275.      Assembling Files Generated by Compilers
  276.      ---------------------------------------
  277.      Many compilers support assembly-language output.  If you experience
  278.      difficulty assembling the output of such compilers, you may need to
  279.      assemble using the /Zm option.  In some cases (for example, if the
  280.      compiler inserts nondelimited comments or page numbers) it may be 
  281.      necessary to edit the assembly-language output by hand.
  282.  
  283.  
  284.      Building 32-bit Applications
  285.      ----------------------------
  286.      Following are a number of items you should keep in mind when
  287.      building 32-bit applications with MASM 6.1x. Examples of how to 
  288.      create 32-bit applications can be found in the \SAMPLES\NTSAMPLE 
  289.      subdirectory of the directory in which you installed MASM.
  290.  
  291.       32-bit Linking
  292.       --------------
  293.       When you are creating a 32-bit application, you must link 
  294.       separately with a 32-bit linker. To prepare your object files 
  295.       for 32-bit linking, assemble using the following switches:
  296.       
  297.       - /c (assembles without linking)
  298.       - /coff (causes object files to be created in Windows NT-
  299.         compatible common object file format)
  300.         
  301.       After assembling, link with your 32-bit linker. Refer to the 
  302.       documentation included with your particular 32-bit linker for 
  303.       specific information and instructions. In addition, the sample
  304.       Windows NT applications in \SAMPLES\NTSAMPLE demonstrate the use 
  305.       of /c, /coff, and a 32-bit linker.
  306.  
  307.       GROUP Directive and Flat-Model Programming
  308.       ------------------------------------------
  309.       The GROUP directive has no effect when used in 32-bit flat-model
  310.       programming. It is recommended that you not use the GROUP 
  311.       directive when programming in flat model. Using the GROUP 
  312.       directive with /coff will result in an error.
  313.  
  314.       Structure Packing Issues for Mixed Language Programming
  315.       -------------------------------------------------------
  316.       Microsoft MASM uses /Zp1 as it's default setting for structure 
  317.       packing. This means that structures are not packed. Other 
  318.       languages may use other default settings for packing. For 
  319.       example, Microsoft C/C++ compilers prior to Visual C++ 32-bit 
  320.       edition use /Zp2; Visual C++ 32-bit edition uses /Zp8 as the 
  321.       default. Modules built using different structure packing may not 
  322.       be able to share structure data items, so care must be taken 
  323.       when using structures in mixed language programs.
  324.  
  325.       The packing size is a maximum, not a fixed, packing value. This 
  326.       means that a member must have a size equal to or larger than the 
  327.       packing limit before any packing is done. 
  328.  
  329.       /WIN32 Switch for H2INC
  330.       -----------------------
  331.       Use the /WIN32 switch with H2INC to convert C header files to 
  332.       NT-compatible MASM include files. When you use the /WIN32 switch,
  333.       C int data types are converted to the 4-byte assembler equivalent
  334.       DWORD (signed int data types are converted to SDWORD). Without 
  335.       the /WIN32 switch, H2INC converts int data types to 2-byte WORD 
  336.       (and signed int data types to SWORD).
  337.  
  338.     
  339.      CD-ROM Not a Valid Target
  340.      -------------------------
  341.      A CD-ROM drive is not a valid installation target for MASM 6.11. Setup
  342.      may incorrectly list a CD-ROM drive on the target drive list. 
  343.  
  344.  
  345.      CMP Instruction Encoding
  346.      ------------------------
  347.      MASM 6.1x uses a different encoding for the CMP <reg8>,<reg8> 
  348.      instruction than MASM 6.0 did.  There is no difference in length or 
  349.      processor timing.
  350.  
  351.      
  352.      Debugging MASM Applications under Visual C++, 32-bit Edition, 
  353.      or Fortran PowerStation, 32-bit Edition
  354.      -------------------------------------------------------------
  355.      When debugging a pure MASM application under the 32-bit editions of
  356.      Visual C++ or Fortran PowerStation, you must link in the library 
  357.      file (.LIB) provided with these high-level languages (LIBC.LIB in 
  358.      Visual C++, LIBF.LIB with Fortran PowerStation). If you do not use 
  359.      the .LIB file included in the high-level language, you will receive 
  360.      an "Access Violation" error message when you attempt to run a MASM 
  361.      application in either the 32-bit Visual C++ or 32-bit Fortran 
  362.      PowerStation integrated development environment.
  363.      
  364.      
  365.      INVOKE Command
  366.      --------------
  367.      The MASM 6.x INVOKE command does not support transferring control
  368.      between 16-bit and 32-bit code segments. When the assembler
  369.      encounters an INVOKE command in a 16-bit segment, it assumes
  370.      that the procedure being invoked is also in a 16-bit segment. If
  371.      the assembler encounters an INVOKE in a 32-bit segment, it assumes
  372.      that the invoked procedure is also in a 32-bit segment.
  373.  
  374.      To avoid this problem, push the necessary parameters on the stack
  375.      and make the appropriate call instead of using INVOKE.
  376.  
  377.  
  378.      Multi-File Assembly with MASM.EXE
  379.      ---------------------------------
  380.      When assembling multiple files with MASM.EXE, you must terminate the
  381.      command-line with a semicolon or a comma (for example, MASM *.asm;). 
  382.      Failure to do this may cause the program to appear to hang if you are 
  383.      running Microsoft Windows NT. If this does occur, you can terminate 
  384.      the program with Ctrl+C.
  385.      
  386.  
  387.      NMAKE and NMAKER
  388.      ----------------
  389.      MASM 6.11 includes two versions of the NMAKE project management 
  390.      utility.  NMAKER.EXE is a real-mode version of the utility.  
  391.      NMAKE.EXE is a driver program that loads the MS-DOS extender 
  392.      DOSXNT into memory first, and then runs NMAKER.EXE.  Using the NMAKE.EXE 
  393.      driver will result in faster build times.  Some development tools 
  394.      from other manufacturers may be incompatible with NMAKE.EXE.  If you 
  395.      encounter incompatibilities, use NMAKER.EXE instead.
  396.  
  397.  
  398.      Response Files
  399.      --------------
  400.      Information on response files is not included in the MASM 6.10 manuals;
  401.      however, this information can be found in "ML Command Line Options" 
  402.      in Help.
  403.      
  404.      
  405.      SAMPLES.TXT and NTSAMPLE.TXT
  406.      ----------------------------
  407.      SAMPLES.TXT contains information about the MASM samples for 
  408.      MS-DOS/Windows; NTSAMPLE.TXT contains information about the 
  409.      samples given for MASM for Windows NT. Both files include 
  410.      information about additional tools you may need to build some 
  411.      of the samples. If you choose to install the sample code during the 
  412.      setup process, both SAMPLES.TXT and NTSAMPLE.TXT are included. 
  413.      SAMPLES.TXT can be found in the \MASM611\SAMPLES subdirectory;
  414.      NTSAMPLE.TXT can be found in the \MASM611\SAMPLES\NTSAMPLE
  415.      subdirectory.
  416.  
  417.  
  418.      Using MASM 6.x Structures
  419.      -------------------------
  420.      MASM 6.x supports a more powerful syntax for structure definition 
  421.      and usage than previous versions of MASM.  This more powerful 
  422.      syntax is enabled by default.  To use the older syntax, issue 
  423.      the OPTION OLDSTRUCTS directive (see Appendix A of the MASM
  424.      Programmer's Guide for more information).
  425.  
  426.      NOTE: If you use nested structures, you must use the new MASM 6.x syntax.
  427.      If you use nested structures, the OPTION OLDSTRUCTS directive will
  428.      be ignored for the nested structure. 
  429.  
  430.  
  431.      Visual C++ 1.0/Fortran PowerStation 1.0 Compatibility
  432.      -----------------------------------------------------
  433.      There are specific steps you must take to use MASM 6.1x with 
  434.      Microsoft Visual C++ 1.0 or Microsoft Fortran PowerStation 1.0.  
  435.      If you want to do mixed language programming with these products, it 
  436.      is recommended that:
  437.  
  438.      - You install Visual C++/Fortran PowerStation and MASM 6.1x in 
  439.        separate sub-directories.
  440.  
  441.      - You place \MSVC\BIN or \F32\BIN (your Visual C++ or Fortran 
  442.        PowerStation sub-directory) first on your path statement before 
  443.        \MASM611\BIN (your MASM 6.11 sub-directory).
  444.  
  445.      - You use NMAKE.EXE from MASM 6.11.  You can do this using various
  446.        methods, such as moving or renaming NMAKE.EXE installed in \MSVC
  447.        or \F32 thus causing the system to continue searching your path 
  448.        and use the NMAKE.EXE in \MASM611.
  449.  
  450.      Optionally, for MASM 6.1x/Visual C++ mixed programming, you may
  451.      use NMAKER.EXE which is installed with both products.
  452.  
  453.      When using the LINK utility included with Visual C++ 1.0, you may 
  454.      encounter one or both of the following warnings:
  455.  
  456.       LINK : warning L4017: /r : unrecognized option name; option 
  457.                      ignored
  458.       CVPACK : warning CK4007 : unrecognized option /x; option 
  459.                     ignored
  460.      
  461.      These warnings do not affect the resulting program and should be
  462.      ignored.
  463.      
  464.  
  465.      Working with MASM 5.1 Code
  466.      --------------------------
  467.      MASM 6.x offers major advances over previous versions of MASM.
  468.      Some of these improvements require changes that make MASM 5.1
  469.      source code incompatible with MASM 6.x. To provide compatibility
  470.      with code written for MASM 5.1, MASM 6.x allows you to access
  471.      MASM 5.1 compatibility code in three ways:
  472.      
  473.      - By using the conversion driver MASM.EXE. MASM.EXE converts
  474.        your existing command-line options to the new syntax, adds
  475.        the compatibility option /Zm, and invokes ML.EXE.
  476.       
  477.      - By using ML.EXE with the /Zm option. You also need to
  478.        convert command-line options to the new syntax.
  479.       
  480.      - By placing the statement OPTION M510 at the beginning of
  481.        each file. You also need to convert command-line options
  482.        to the new syntax.
  483.         
  484.      In most cases, using the /Zm option or OPTION M510 will be the best
  485.      solution for assembling existing code. If you prefer to modify your
  486.      code so it can be assembled without /Zm or OPTION M510, do the
  487.      following:
  488.      
  489.      1. Add the appropriate OPTION directives to your code.
  490.  
  491.     - Always add the following:
  492.  
  493.       OPTION OLDSTRUCTS ; Supports old-style structures
  494.       OPTION OLDMACROS  ; Supports old-style macros
  495.       OPTION DOTNAME    ; Supports naming identifiers with
  496.                 ; a leading dot [.]
  497.  
  498.     - If your code does not specify the .386 or .386P directive, add
  499.       the following:
  500.  
  501.       OPTION EXPR16     ; Use 16-bit precision in expressions
  502.  
  503.     - If your code does not contain a .MODEL directive, add the
  504.       following:
  505.  
  506.       OPTION OFFSET:SEGMENT ; Specifies that the OFFSET operator
  507.                 ; defaults to segment-relative rather
  508.                 ; than group-relative
  509.  
  510.     - If your code does not contain a .MODEL directive or if the
  511.       .MODEL directive does not specify a language, add the following:
  512.  
  513.       OPTION NOSCOPED       ; Makes code labels global rather than
  514.                 ; local to the procedure in which they
  515.                 ; appear
  516.       OPTION PROC:PRIVATE   ; Makes code labels defined with PROC
  517.                 ; local unless specified otherwise
  518.  
  519.      2. Once your code assembles with the OPTION directives, remove each 
  520.     OPTION directive, one at a time, and reassemble the code after you 
  521.     remove each one.
  522.  
  523.     Usually, it is best to remove the OPTION directives in the 
  524.     opposite order in which you added them. In some cases, you may 
  525.     decide that you prefer the MASM 5.x compatibility behavior 
  526.     instead of the new MASM 6.x behavior. When this is true, do not 
  527.     remove the corresponding OPTION statement from your code. 
  528.     
  529.      For more information on assembling MASM 5.1 code, see Appendix A 
  530.      of the MASM Programmer's Guide.
  531.  
  532.      
  533.      Working With Microsoft BASIC Far Strings
  534.      ----------------------------------------
  535.      The BASIC runtime function StringAssign does not correctly handle
  536.      strings of zero length.  Instead of calling StringAssign to convert
  537.      a zero-length string, simply return a near pointer to a doubleword 
  538.      with the value 0.
  539.  
  540.  
  541.      .FPO Directive
  542.      --------------
  543.  
  544.      FPO stands for Frame Pointer Omission. The .FPO directive is a feature 
  545.      added to MASM386 5.10.NT that controls the emission of debug records 
  546.      to the .debug$F segment or section of the object file. These records 
  547.      are the same records that the Microsoft Visual C++ 1.10 or Microsoft 
  548.      Fortran PowerStation compilers emit when they perform frame pointer 
  549.      elimination under /Oy and /Ox optimization control, respectively. 
  550.      Unlike the compiler, MASM never performs any such optimization. it 
  551.      simply passes on the information supplied by the programmer within 
  552.      this directive to the object file.
  553.  
  554.      The .FPO directive does not have to be used in order to debug assembly 
  555.      programs under the Microsoft Visual C++ 1.10 or Microsoft Fortran 
  556.      PowerStation debuggers whether they are stand alone Windows NT
  557.      applications or mixed language C\Assembly or Fortran\Assembly Windows 
  558.      NT applications. This directive has been implemented to provide better 
  559.      backward compatibility with assembly code written for MASM386 5.10.NT, 
  560.      which is provided with the Windows NT DDK.
  561.  
  562.      The FPO directive should only be used on naked procedures or those 
  563.      procedures not declared with proto and called with invoke. Also you do 
  564.      not need to use the .FPO directive to debug naked procedures or on 
  565.      procedures that use proto and invoke. 
  566.  
  567.  
  568.      The following 6 parameters are used within the directive as follows. 
  569.  
  570.      .FPO (  number of bytes in a procedures local variables divided by 4, 
  571.          number of bytes in a procedures parameters divided by 4,
  572.          number of bytes in a procedure prologue,
  573.          number of registers saved by a procedures prologue,
  574.          If EBP is allocated,
  575.          Frame Type )            
  576.  
  577.  
  578.     Parameters                                      Range 
  579.     ----------                                      -----
  580.     number of bytes in local variables / 4          >= 0
  581.     number of bytes in parameters / 4               0 - 65535
  582.     number of bytes in the procedure prologue       0 - 255
  583.     number of registers saved                       0 - 7
  584.     If EBP is allocated                             0 = false, 1 = true
  585.     Frame Type                                      0 - 2
  586.  
  587.     The valid values for the Frame Type parameter above are 
  588.  
  589.     FRAME_FPO   0
  590.     FRAME_TRAP  1
  591.     FRAME_TSS   2
  592.  
  593.     The C compiler only generates entries with FRAME_FPO. The other two 
  594.     types are used inside the Windows NT kernel to all stack traces 
  595.     across trap and tss frames that can appear in ring 0 code.
  596.  
  597.     Example Usages:
  598.  
  599.     1) 
  600.     aproc proc
  601.  
  602.         .FPO ( 0, 0, 0, 0, 0, 0 )       ; all params are zero. 
  603.         ret
  604.  
  605.     aproc endp
  606.  
  607.     2)                      
  608.     .code
  609.         push    +000000001h             
  610.         call    aproc
  611.         add     esp, 04h
  612.         ret             
  613.  
  614.     aproc proc
  615.         
  616.         push    ebp
  617.         mov     ebp, esp
  618.  
  619.         .FPO ( 0, 1, 3, 1, 1, 0 )       ; 0 = no locals
  620.                         ; 1 = 4 byte param \ 4
  621.                         ; 3 = bytes in procedure prologue
  622.                         ; 1 = one register saved in prologue
  623.                         ; 1 = if EBP was allocated
  624.                         ; 0 = frame type of FPO
  625.  
  626.         mov     eax, dword ptr [ebp+8]  ; move the passed param to EAX.
  627.  
  628.         leave   
  629.         ret     00h
  630.  
  631.     aproc endp
  632.  
  633.  
  634.     See ERRMSG.TXT for a list of possible error messages that you may
  635.     encounter when you use the .FPO directive.   
  636.  
  637.  
  638. ======================< Part 5: Known Assembler Bugs >=====================
  639.  
  640.      Expression Order in High-Level Conditionals
  641.      -------------------------------------------
  642.      Comparisons in high-level conditionals cannot begin with a literal.
  643.      For instance, this comparison causes an error:
  644.  
  645.       .IF 1 == AX
  646.  
  647.      but this works properly:
  648.  
  649.       .IF AX == 1
  650.  
  651.  
  652.      Hexadecimal Constants
  653.      ---------------------
  654.      In some instances, ML might not generate the appropriate error
  655.      message if it encounters a hexadecimal constant that does not have
  656.      an appending "h". The following will help to ensure that hexadecimal 
  657.      constants are properly represented:
  658.  
  659.      - Make sure that all hexadecimal constants have an appending "h".
  660.      - Begin all hexadecimal constants with the numeral 0. This ensures
  661.        that the compiler will generate the appropriate error message
  662.        if it encounters a hexadecimal constant that does not end in "h".
  663.  
  664.      
  665.      Initializing Nested Structures ? 
  666.      ------------------------------
  667.      If one structure is nested within another, the inner structure's
  668.      initializer list must either be empty or include a comma between
  669.      every field.  For example, the structure INFO declared on page 123 
  670.      of the Programmer's Guide contains a structure of type DISKDRIVES,
  671.      which in turn contains three BYTE fields.  An object of type INFO
  672.      could be initialized as:
  673.  
  674.       Info1 INFO { , , , , { }}      ; Inner initializer list is blank
  675.  
  676.      or as:
  677.  
  678.       Info1 INFO { , , , , {1, 2, }} ; Commas for all three fields
  679.  
  680.      but not as:
  681.  
  682.       Info1 INFO { , , , , {1, 2 }}  ; Error: missing last comma
  683.      
  684.       
  685.      Span-Dependent Expressions used in Macros
  686.      -----------------------------------------
  687.      MASM 6.1x evaluates macro expressions only on the first pass of 
  688.      assembly, but code and data are reevaluated on subsequent passes.
  689.      Because of this, macro expressions which depend on the span between
  690.      two addresses may not evaluate correctly. For instance, the
  691.      following code will not evaluate correctly:
  692.  
  693.       Label1:
  694.            JMP Label2
  695.       Label2:
  696.  
  697.       REPEAT Label2 - Label1  ; Evaluates incorrectly
  698.            INC AX
  699.       END
  700.  
  701.      View the listing file to determine if a questionable macro expression
  702.      was evaluated as desired.
  703.  
  704.  
  705.      Span-Dependent Equates in Macros and EXTERNDEF ABS
  706.      --------------------------------------------------
  707.      The ABS operator causes an identifier to be exported as a relocatable
  708.      unsized constant (see Programmer's Guide page 220).  If ABS is used
  709.      with EXTERNDEF within a macro, and the constant being exported
  710.      depends on the difference between two addresses, the constant may not
  711.      be exported correctly.  In some cases, the listing file will show the
  712.      correct value, but the value in the resulting .obj will be incorrect.
  713.      For instance, the following code will not evaluate correctly:
  714.  
  715.       EXTERNDEF TableSize:ABS  ; Will not be exported correctly
  716.  
  717.       MAKETABLE MACRO
  718.       Table1 LABEL BYTE
  719.            DB 0, 1, 2
  720.       TableSize EQU $-Table1
  721.       ENDM
  722.  
  723.       SEG1 SEGMENT
  724.       MAKETABLE
  725.       SEG1 ENDS
  726.  
  727.      To avoid this problem, either use the 'PUBLIC' directive in place of 
  728.      'EXTERNDEF', or put a label before the equate, within the macro.
  729.  
  730.  
  731.      Span-Dependent Text Equates
  732.      ---------------------------
  733.      The TEXTEQU operator is evaluated on the first assembly pass.  If
  734.      TEXTEQU is used with an expression that depends on the difference
  735.      between two addresses, the resulting constant may be incorrect.
  736.      For instance, the following code will not evaluate correctly:
  737.  
  738.       Label1:
  739.            JMP Label2
  740.       Label2:
  741.       WrongNum TEXTEQU %Label2-Label1 ; WrongNum will be incorrect
  742.  
  743.  
  744.      STRUCT and RECORD Initialization
  745.      --------------------------------
  746.      If a STRUCT containing a UNION is initialized incorrectly, it is
  747.      possible that the compiler might not generate an appropriate error.
  748.      If the UNION contains a RECORD, the STRUCT is initialized to the
  749.      default value for the original UNION.
  750.      
  751.  
  752.      EQU Redefinition
  753.      ----------------
  754.  
  755.      EQU can be redefined when a text macro is used, the following example
  756.      illustrates this known bug.
  757.  
  758.      a EQU <T>
  759.      a EQU <U>   ; This second occurrence should generate an error "A2005: 
  760.          ; symbol redefinition" because once "a" is defined as a 
  761.          ; text macro it cannot be redefined to be a different kind 
  762.          ; of symbol.
  763.  
  764.      y EQU y     ; This statement is syntactically correct, but any attempt  
  765.          ; to use "y" and you'll receive "error A2123: text macro 
  766.          ; nesting level too deep".
  767.  
  768.  
  769. =================< Part 6: What Has Been Fixed in 6.11d? >=================
  770.  
  771.      - The opcode generated for the FSETPM instruction has been 
  772.        corrected.
  773.  
  774.      - Errors when using the ALIAS directive and creating COFF object 
  775.        files have been fixed. 
  776.  
  777.      - Errors when using the ORG directive to back patch the code being 
  778.        generated in a COFF object file have been fixed.
  779.  
  780.      - The extra byte in the listing file for instructions using 32-bit
  781.        addressing modes has been removed.
  782.  
  783.      - Unresolved externals that could occur when a symbol appeared more
  784.        than once in EXTERNDEF directives have been fixed.
  785.  
  786.      - You can now step through code in include files when building COFF
  787.        object files.
  788.  
  789.      - Various Access Violations when generating COFF object files (/coff)
  790.        have been fixed.
  791.  
  792.  
  793. ================< Part 7: What Has Been Fixed in 6.12? >===================
  794.  
  795.      - Various Access Violations when generating CodeView debug information 
  796.        (/Zi) have been fixed.
  797.  
  798.      - Errors when specifying an entry point with the END directive and 
  799.        creating COFF object files have been fixed. 
  800.  
  801.      - Various structure packing inconsistencies when compared to the 
  802.        Microsoft C/C++ compilers have been corrected. MASM 6.12 should now 
  803.        pack structures the same as the Microsoft C/C++ compiler when using 
  804.        the same packing options.
  805.  
  806.  
  807. ================< Part 8: What Has Been Added in 6.12? >===================
  808.  
  809.   .586 and .586P Directives in MASM 6.11
  810.   --------------------------------------
  811.   The .586 directive enables assembly of non-privileged instructions 
  812.   available for the Pentium processor. The .586P directive enables 
  813.   privileged instructions in addition to the non-privileged instructions
  814.   for the Pentium.
  815.  
  816.   The following example demonstrates implementation of the .586 directive.
  817.      
  818.   .586
  819.   .model flat, C
  820.  
  821.   .data
  822.   ; .586  gives 110100111111y = 0D3Fh
  823.   ; .586p gives 110110111111y = 0DBFh
  824.   var1 dw @cpu
  825.  
  826.   IF  @Cpu AND 0100000y
  827.       %echo Pentium instructions enabled.
  828.   ELSE
  829.       %echo Pentium instructions Not enabled.
  830.   ENDIF
  831.  
  832.   end
  833.  
  834.   .686 and .686P Directives in MASM 6.12
  835.   --------------------------------------
  836.   The .686 directive enables assembly of non-privileged instructions 
  837.   available for the Pentium Pro processor. The .686P directive enables 
  838.   privileged instructions in addition to the non-privileged instructions
  839.   for the Pentium Pro.
  840.  
  841.   The following example demonstrates implementation of the .686 directive.
  842.      
  843.   .686
  844.   .model flat, C
  845.  
  846.   .data
  847.   ; .686  gives 110101111111y = 0D7Fh
  848.   ; .686p gives 110111111111y = 0DFFh
  849.   var1 dw @cpu
  850.  
  851.   IF  @Cpu AND 1000000y
  852.       %echo Pentium Pro instructions enabled.
  853.   ELSE
  854.       %echo Pentium Pro instructions Not enabled.
  855.   ENDIF
  856.  
  857.   end
  858.  
  859.   .MMX Directive in MASM 6.12
  860.   ---------------------------------------------------------------------
  861.   The .MMX directive enables assembly of MMX instructions.  Users can
  862.   check to see that @Version is 612 or higher to tell if the version
  863.   of MASM being used supports the .MMX directive and MMX instructions.
  864.  
  865.   The following example demonstrates the use of the .MMX directive.
  866.      
  867.   .586
  868.   .MMX
  869.   .model flat, C
  870.  
  871.   .code
  872.       ;; MMX opcodes can be assembled
  873.  
  874.   end
  875.  
  876.