home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #3.1 / RBBSIABOX31.cdr / medi / masm4.doc < prev    next >
Text File  |  1986-03-19  |  3KB  |  77 lines
  1.       MASM.DOC                       Release 1                      1/31/86
  2.  
  3.           The purpose of this document is to try to accumulate comments 
  4.       pertaining to the Microsoft Macro Assembler version 4.0 documentation 
  5.       that appear to be confusing, misleading, or difficult to reconcile 
  6.       with experience with the assembler.  
  7.  
  8.           If you are a user of the product and can add to this compilation, 
  9.       please leave messages.  Hopefully Microsoft will comment on our 
  10.       findings and perhaps use them to update the manual for future 
  11.       releases.
  12.  
  13.                                                      Eric Cohane 75206,1117
  14.  
  15.       =====================================================================
  16.  
  17.       USER'S GUIDE
  18.       ------------
  19.  
  20.       Chapter 2 -- MASM: A Macro Assembler
  21.  
  22.       Page 21 Note at top of page -- "C" is a valid option.
  23.  
  24.  
  25.       Chapter 3 -- LINK: A Linker
  26.  
  27.       Page 48 -- Next to last paragraph, line 6 -- "If you type the comma 
  28.       after . . . "  Should "comma" be "semicolon"?
  29.  
  30.       Page 49 -- Paragraph describing example 1 -- ". . . LINK searches the 
  31.       the library "file.lib" . . ." should refer to library "routine.lib".
  32.  
  33.       Page 54 -- Listing at top of page -- In addresses of Publics by 
  34.       Value, should not "FAC" have address 0173:0035 rather than 0000:0035?
  35.  
  36.  
  37.       REFERENCE MANUAL
  38.       ----------------
  39.  
  40.       General -- The term "keyword" is not defined.  On page 19 a reference 
  41.       is made to the "COMMENT keyword" implying that "COMMENT" is a 
  42.       RESERVED word (which it is, in Table 2.2).  On page 39, however, 
  43.       reference is made to the "keyword NOTHING", yet "NOTHING" does not
  44.       appear in the reserved word list (Table 2.2).  The boldfacing further
  45.       implies reserved word status.
  46.  
  47.  
  48.       Chapter 2 -- Elements of the Assembler
  49.  
  50.       Page 18 -- At top of page, third dot -- If the last statement in the
  51.       file is the END statement, it must be followed by a carriage return
  52.       or the assembler does not recognize its presence.
  53.  
  54.  
  55.       Chapter 3 -- Program Structure
  56.  
  57.       Page 33 -- EXAMPLE -- This example uses the NAMEs module_1 and
  58.       module_2; however, the NAME directive is unique only to 6 characters.
  59.       Thus it would appear that the modules will be non-unique to the
  60.       linker since the "_1" and "_2" that distinguish them are beyond the
  61.       sixth character position.
  62.  
  63.       Page 35 -- END directive.  "The optional expression defines . . ."
  64.       The word "optional" here is quite misleading as 'expression' must be
  65.       used in single-module programs as well as in the main module of
  66.       multi-module programs.  (The NOTE on following page affirms.)
  67.  
  68.  
  69.       Chapter 5 -- Operands and Expressions
  70.  
  71.       Page 73 -- last paragraph -- "BD register" should read "BP register".
  72.  
  73.       Page 80 -- EXAMPLES -- First example comment contains 17 bits.
  74.  
  75.       Page 81 -- Table 5.4 -- In each case (0FFFh) is given.  Suggest
  76.       (0FFFFh) as correct value.
  77.