home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / crossasm / ps18a12.arc / A18.DOC < prev    next >
Text File  |  1987-03-15  |  38KB  |  1,100 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                              PseudoSam 18 Assembler Manual V1.2.02
  12.                              Copyright(c) 1986 PseudoCode
  13.  
  14.  
  15.  
  16.  
  17.  
  18. Disclaimer:
  19.  
  20.             PseudoSam 18 is distributed as is, with no guarantee that it
  21.             will work correctly in all situations.  In no event will the
  22.             Author be liable for any damages, including lost profits,
  23.             lost savings or other incidental or consequential damages
  24.             arising out of the use of or inability to use these
  25.             programs, even if the Author has been advised of the
  26.             possibility of such damages, or for any claim by any other
  27.             party.
  28.  
  29.             It is the users reponsibility to back up all important files!
  30.  
  31.             See copyright information in appendix B
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                          Table of Contents
  38.  
  39. Chapter 1  PseudoSam 18 assembler vs. the RCA assembler.
  40.  
  41. Chapter 2  Running the assembler program.
  42.  
  43. Chapter 3  Assembler statement syntax.
  44.  
  45. Chapter 4  Data types.
  46.  
  47. Chapter 5  Expressions.
  48.  
  49. Chapter 6  Assembler Directives.
  50.   (also known as assembler pseudo-opcodes, or pseudo-ops)
  51.  
  52. Appendix A      ASCII character set.
  53.  
  54. Appendix B      Copyright and registration information.
  55.  
  56. Appendix C      Description of Files.
  57.  
  58. Appendix D      Bug Reporting Procedure.
  59.  
  60. Appendix E      Using PseudoSam 18 on "Compatible" Systems.
  61.  
  62.  
  63.  
  64. Chapter 1 PseudoSam 18 assembler vs. the RCA assembler
  65.  
  66.      All PseudoSam(Pseudo brand Symbolic AsseMbler) assemblers conform to
  67.      a common syntax based on the UNIX system V assembler syntax. By
  68.      conforming to this Pseudo standard, conflicts with the manufacturers
  69.      syntax are created.  Below is a brief and incomplete list of those
  70.      conflicts.
  71.  
  72.       RCA format  level 1                 PseudoSam format
  73.  
  74. <identifier> equ <expression>         .equ <identifier> , <expression>
  75.  
  76. <identifier> set <expression>         .set <identifier> , <expression>
  77.  
  78. Has Macro capability                  No Macro capability at this time
  79.  
  80. ..coments are delimited by            ;coments are delimited by
  81. .. two periods                        ; a single semicolon
  82.  
  83.  
  84. * The difference between the RCA and the PseudoSam name
  85.   of an assembler directive can be circumvented by the .opdef
  86.   directive.
  87.  
  88.   example
  89.  
  90.    .opdef  eject,.eject      ;defines eject to be synonymous with .eject
  91.  
  92. *  A file syn.asm is distributed with the assembler with some useful
  93.    redefinitions.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104. Unix system V is a trademark of AT & T.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112. Chapter 2  Running the assembler program
  113.  
  114. 1.  Command line switch setting and source file specification.
  115.  
  116.      Assuming the user has an assembly language source file called foo.asm
  117.      type the following command:
  118.  
  119. a18 foo
  120.  
  121.      The assembler will assemble the program foo.asm using the default
  122.      assembler switch settings. the following files will be generated
  123.      by the assembler:
  124.  
  125.      foo.lst   ;assembled listing shown the code conversion and
  126.                ; any errors that where discover by the assembler.
  127.  
  128.      foo.obj   ;assembled object code in Motorola Hex format.
  129.  
  130. **  for a list of switch setting see the .command assembler directive
  131.     description in chapter 6.
  132.  
  133. *** The assembler uses the following temporary file names.
  134.  
  135.     z0z0z0z0.tmp
  136.     z1z1z1z1.tmp
  137.  
  138.     ANY files with these names will be DESTROYED by the
  139.     by the assembler.
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147. Chapter 3  Assembler statement syntax
  148.  
  149. 1. Assembler Statements
  150.  
  151.      Assembler statements contain from zero to 4 fields as shown in
  152.      following.
  153.  
  154. <label> <opcode> <expressions> <comment>
  155.  
  156.      All fields are optional, but they must be in this order.
  157.  
  158. A.   Labels (<label>) are symbolic names that are assigned the starting
  159.      address of any code generated by the opcode and or expressions
  160.      of the line containing the label declaration.(see section 2).
  161.  
  162. B.   Operation codes(<opcode>) tell the assembler what machine instruction
  163.      to generate, or what assembler control function to perform.
  164.      The operation code also tells the assembler what expressions are
  165.      required to complete the machine instruction or assembler directive.
  166.      (see chapter 6).
  167.  
  168. C.   Expression requirements are set by the opcode(see the microprocessor
  169.      manufacturers reference manual or the assembler directives chapter
  170.      for individual opcode requirements).(see chapter 5).
  171.  
  172. D.   Comments are notes written by the programmer to explain what the
  173.      program is trying to accomplish. Comments generate no code.
  174.      (see section 3).
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. 2.  Labels
  183.  
  184.      Labels can be unlimited in length, but only the first eight characters
  185.      are used to distinguish between them.  They must conform to the
  186.      following syntax.
  187.  
  188.      <label>  -> <identifier>':'
  189.  
  190.      <identifier> -> <alphabetic character> <identifier character string>
  191.  
  192.      <alphabetic character> -> character in the set ['A'..'Z', 'a'..'z', '.']
  193.  
  194.      <identifier character string> -> any sequence of characters from the
  195.                                       set ['A'..'Z','a'..'z', '.', '0'..'9']
  196.  
  197. example
  198. abc:                  ;label referred to as abc
  199. a c:                  ;not a valid label
  200.          foo:         ;label referred to as foo
  201. .123:                 ;label referred to as .123
  202.  
  203. * Case makes NO difference!
  204.  
  205. d:      ;is the same as
  206. D:
  207.  
  208.  
  209. 3.  Comments
  210.      Comments must start with a semi-colon ; and are terminated
  211.      by an end of line or file( <lf>(^J) or <sub>(^Z) ). An end
  212.      of line is inserted by typing the enter or return key by
  213.      most text editors.
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221. Chapter 4     Data types
  222.  
  223. 1.  Integers
  224.  
  225.     Integer constants can be specified in any of the following forms:
  226.  
  227. A.  Binary
  228.  
  229.     b'bb             ;bb=string of binary digits
  230.     B'bb
  231.  
  232. B.  Decimal
  233.  
  234.     ndd
  235.     d'dd             ;n=nozero decimal digit
  236.     D'dd             ;dd=string of decimal digits
  237.  
  238. C.  Octal
  239.  
  240.     0qq              ;qq=string of octal digits
  241.     o'qq
  242.     O'qq
  243.     q'qq
  244.     Q'qq
  245.  
  246. D.  Hexidecimal
  247.  
  248.     0x'hh            ;hh=string of hexidecimal digits
  249.     0X'hh
  250.     h'hh
  251.     H'hh
  252.     x'hh
  253.     X'hh
  254.  
  255.  
  256. Examples:
  257.  
  258.     077        ;octal number 77 = decimal 63
  259.     b'0101     ;binary number 101 = decimal 5
  260.     77         ;decimal number 77 = octal 115
  261.     h'ff       ;hexidecimal ff = decimal 255
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. 2.  Strings:
  269.  
  270.     Strings consist of a beginning quote " followed by any reasonable number
  271.     of characters followed by an ending quote ". Control characters and double
  272.     quotes " and backslash \ may not be used in strings directly.  These
  273.     special characters are included by using a special escape sequence which
  274.     the assembler translates into the appropriate ASCII code.
  275.  
  276. Note: Strings may not be used in expressions!
  277.       Although character constants may(see below).
  278.  
  279. Escape sequences
  280.   "\"" string containing "
  281.   "\\" string containing \
  282.   "\'" string containing '
  283.   "\0" string containing null
  284.   "\n" string containing linefeed
  285.   "\r" string containing carriage return
  286.   "\f" string containing formfeed
  287.   "\t" string containing horizontal tab
  288.   "\nnn" string containing the ASCII character who's code is o'nnn
  289.          (nnn are octal digits).
  290.   * see appendix A for ASCII codes.
  291.  
  292. 3.  Character Constants:
  293.  
  294.     Character constants consist of  a single quote ' followed by
  295.     a character or an escape sequence(see above) followed by a
  296.     single quote '.
  297.  
  298. example:
  299.    'A' = ASCII character value for the letter A = 65 (decimal);
  300.    '\''= ASCII character value for the character ' = 39 (decimal).
  301.  
  302. Character constants are treated as integers by the assembler and
  303. are valid where ever an integer value is valid.
  304.  
  305. example:
  306.    'A' + 1 = 66
  307.  
  308.   * see appendix A for ASCII codes.
  309.  
  310. 4.  Symbolic values
  311.  
  312.     Symbolic values are generally labels, but may be any identifier
  313.     assigned an integer value(using .set or .equ pseudo-ops).
  314.  
  315.     As a special case the symbol * when used as an operand in an
  316.     expression denotes the value of the location counter (the value
  317.     the program counter will have during operation) at the beginning
  318.     of the current line.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325. Chapter 5  Expressions
  326.  
  327.      All expressions evaluate to integer values modulo 65536(2^16) and are
  328.      written in infix notation(the way you normally write them).  Operators
  329.      provided are grouped below in order of precedence.
  330.  
  331. 1. (unary)
  332. ~           logical bit wise complement(not) of its operand(one's complement).
  333. -           arithemetic complement, or negation(two's complement).
  334.  
  335. 2. (binary)
  336. *           integer multiply (two's complement).
  337. /           integer divide   (two's complement).
  338. %           modulus          (result is always positive)
  339. >>          logical shift right (left operand shifted right operand times).
  340. <<          logical shift left (left operand shifted right operand times).
  341. ~           equivalent to  A or ( ~B ).
  342.  
  343. 3. (binary)
  344. |           logical bitwise or(inclusive-or) of two operands.
  345. ^           logical bitwise exclusive-or of two operands.
  346. &           logical bitwise and of two operands.
  347.  
  348. 4. (binary)
  349. +           addition (two's complement).
  350. -           subtraction (two's complement).
  351.  
  352.      Since this version does not generate relocatable code there exists only
  353.      one "type" of operand that can be in an expression.  So anything goes
  354.      except divide by 0(1 will be substituted ).
  355.  
  356. examples:
  357.     -1 = h'ffff  (two's complement notation).
  358.     -1 >> 8 = h'00ff
  359.     -1 << 8 = h'ff00
  360.     3 / 2 = 1
  361.     6 / 2 = 3
  362.     5 / 0 = 5
  363.     -2 / 1 = -2
  364.     -3 /-2 = 1
  365.     2 * -3 = -6
  366.     b'00 & b'11 = 0
  367.     b'11 & b'10 = 2
  368.     2 * b'01 & b'10 = 2
  369.     b'01 ^ b'11 = 2
  370.     b'01 | b'11 = 3
  371.  
  372. Notice that spaces are ignored in expressions.
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381. Chapter 6  Assembler Directives
  382.   (also known as assembler Pseudo-opcodes)
  383.  
  384.      The assembler recognizes the following directives:
  385.  
  386.       directive  section    description
  387.  
  388.       .command    1   ;set assembly options(similar to command line options).
  389.  
  390.       .org        2   ;set program origin.
  391.  
  392.       .equ        3   ;equate an identifier to an expression(permanent
  393.                       ; assignment).
  394.  
  395.       .set        4   ;equate and identifier to an expression(temporary
  396.                       ; assignment).
  397.  
  398.       .rs         5   ;reserve storage(memory) space.
  399.  
  400.       .db         6   ;define byte.
  401.  
  402.       .dw         7   ;define word(16 bit).
  403.  
  404.       .drw        8   ;define reversed word(16 bit).
  405.  
  406.       .eject      9   ;form feed in listing
  407.  
  408.       .page      10   ;align location counter on 256 byte memory
  409.                       ; page boundary.
  410.  
  411.       .end       11   ;end of program
  412.  
  413.       .opdef     12   ;equate an identifier with another identifier.
  414.  
  415.       .segment   13   ;define a memory segment.
  416.  
  417.       <segment name>
  418.                  14   ;select segment <segment name> as current segment.
  419.  
  420.       .null      15   ;this is a comment statement.
  421.  
  422.  
  423.  
  424.  
  425.  
  426. 1. .command    <optionlist>   ;allows the programmer to set option switches
  427.                               ;in the same manner as on the command line.
  428.                               ;(the command line is the line typed to run
  429.                               ; this program).
  430.  
  431. <optionlist> -> <option> ' ' <optionlist>
  432. <optionlist> ->
  433.  
  434. <option> -> '-'<available option>
  435. <option> -> '+'<available option>
  436.  
  437. <available option> -> 'a'<decimal number> ;Hex hode format.
  438.                                           ;1 => Intel Hex.
  439.                                           ;2 => Motorola 19 Hex.
  440.  
  441. <available option> -> 'w'<decimal number> ;page width in columns(characters).
  442.                                           ;(-,+ are ignored but one must be
  443.                                           ; there).
  444.  
  445. <available option> -> 'h'<decimal number> ;page height in lines.
  446.                                           ;(-,+ are ignored but one must be
  447.                                           ; there).
  448.  
  449. <available option> -> 'l'                 ;listing on(+) or off(-)
  450.                                           ;if set on command line it overrides
  451.                                           ;all listing controls in program.
  452.  
  453. <available option> -> 'm'<decimal number> ;Machine level.
  454.                                           ;1 => 1802.
  455.  
  456. <available option> -> 's'                 ;symbol listing on(+) or off(-).
  457.  
  458. <available option> -> 'o'                 ;selects single object module
  459.                                           ;file only(+), or multiple object
  460.                                           ;module files(-)(one for each
  461.                                           ;defined segment in the program).
  462.                                           ;ONLY active on command line!
  463.  
  464. <available option> -> 't'<drive>          ;specifies which drive to create
  465.                                           ;all temporary files on(-,+ are
  466.                                           ; ignored but one must be there).
  467.                                           ;ONLY active on command line!
  468.  
  469. <available option> -> 'p'<drive>          ;specifies which drive to create
  470.                                           ;the listing file on(-,+ are
  471.                                           ; ignored but one must be there).
  472.                                           ;ONLY active on command line!
  473.  
  474. <drive> -> <drive name>':'                ;e.g.  a:  b:  c:  d:
  475.  
  476.                            ;MS-DOS
  477. <drive name> -> 'a'        ;drive a --usually a floppy disk
  478. <drive name> -> 'b'        ;drive b --usually a second floppy disk
  479. <drive name> -> 'c'        ;drive c --usually a hard disk, but may
  480.                                       be a ram disk.
  481. <drive name> -> 'd'        ;drive d --usually a ram disk, but may
  482.                                       be a hard disk.
  483.  
  484. ** The default options are: -a2 -m1 -w132 -h66 +l +s +o
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492. 2. .org   <integer expression>    ;sets the assembler location counter
  493.                                   ;to the value of expression.
  494.                                   ;The expression MUST be evaluatable
  495.                                   ;on the first pass. NO FORWARD
  496.                                   ;REFERENCES!
  497.  
  498. 3. .equ  <identifier> ',' <integer expression>
  499.                                   ;gives identifier the value of the
  500.                                   ;integer expression.
  501.                                   ;<identifier> canNOT be redefined!
  502.                                   ;also forward references are allowed
  503.                                   ;as long as they are resolved by the
  504.                                   ;second pass.
  505.  
  506. 4. .set  <identifier> ',' <integer expression>
  507.                                   ;gives identifier the value of the
  508.                                   ;integer expression.
  509.                                   ;<identifier> CAN be redefined later
  510.                                   ; in the program!
  511.                                   ;also forward references are allowed
  512.                                   ;as long as they are resolved by the
  513.                                   ;second pass.
  514.  
  515. 5. .rs  <integer expression>      ;increments the location counter
  516.                                   ;by the value of <integer expresson>
  517.                                   ;effectively reserving that many bytes
  518.                                   ;of memory.
  519.  
  520. 6. .db  <expression-string list>
  521.  
  522. <expression-string list> -> <expression>','<expression-string list>
  523. <expression-string list> -> <string>','<expression-string list>
  524. <expression-string list> -> <expression>
  525. <expression-string list> -> <string>
  526.  
  527.                                   ;creates a byte in the machine code
  528.                                   ;for each <expression> in the list
  529.                                   ;and a byte for each ascii character
  530.                                   ;in the a string.
  531. 7. .dw  <expression list>
  532.  
  533. <expression list> -> <expression>','<expression list>
  534. <expression list> -> <expression>
  535.  
  536.                                   ;creates a word(16 bit) in the machine code
  537.                                   ;for each <expression> in the list.
  538.                                   ;MOST significant byte is stored at LOWER
  539.                                   ;address.
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546. 8. .drw  <expression list>
  547.  
  548. <expression list> -> <expression>','<expression list>
  549. <expression list> -> <expression>
  550.  
  551.                                   ;creates a word(16 bit) in the machine code
  552.                                   ;for each <expression> in the list.
  553.                                   ;LEAST significant byte is stored at LOWER
  554.                                   ;address.
  555.  
  556. 9. .eject                         ;causes a form-feed character to be
  557.                                   ;inserted in listing.(new listing page)
  558.  
  559. 10. .page                         ;increments location counter to next
  560.                                   ;256 byte page boundary.
  561.  
  562. 11. .end <integer expression>     ;signals the end of the source program.
  563.                                   ;the optional expression, if supplied,
  564.                                   ;specifies the start address of the
  565.                                   ;program, and is included in the
  566.                                   ;Motorola Hex object module output
  567.                                   ;of the active segment when the .end
  568.                                   ;was encountered.
  569.  
  570.  
  571. 12. .opdef  <identifier>,<identifier>
  572.                                   ;assigns the current definition of
  573.                                   ;the second <identifier> to the
  574.                                   ;first <identifier>.
  575.                                   ;useful for renaming opcodes and
  576.                                   ;pseudo-ops.
  577.  
  578. 13. .segment <identifier> ',' <integer expression>
  579.                                   ;defines a memory segment name.
  580.                                   ;used to separate memory allocation
  581.                                   ;and optionally generate seperate
  582.                                   ;object files.(see 'o' assembly
  583.                                   ;directive to activate).
  584.                                   ;(used to seperate RAM, ROM, or
  585.                                   ; ROMS)
  586.                                   ;the optional <integer expression> is
  587.                                   ;added to the location counter to
  588.                                   ;offset the load address supplied
  589.                                   ;in the object module. (does not
  590.                                   ;affect listings addresses!)
  591.                                   ;
  592.                                   ;note: .code is the predefined default
  593.                                   ;segment and cannot be redefined.
  594.  
  595. 14. <segment name>                ;selects the segment <segment name>
  596.                                   ;as the current memory segment.
  597.                                   ;The location old segment location counter
  598.                                   ;is saved and the previous value of the
  599.                                   ;newly selected segments location counter
  600.                                   ;is used(0 if not previously used).
  601.  
  602. 15.  .null                        ;directs the assembler to treat this
  603.                                   ;statement as a comment.  Useful to
  604.                                   ;nullify opcodes when used in conjunction
  605.                                   ;with the .opdef pseudo-op.
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613. Appendix   A      ASCII character set
  614.  
  615.  
  616.  
  617. dec oct hex char     dec oct hex char  dec oct hex char  dec oct hex char
  618.  
  619.   0 000  00 ^@ null   32 040  20 sp     64 100  40 @      96 140  60 `
  620.   1 001  01 ^A soh    33 041  21 !      65 101  41 A      97 141  61 a
  621.   2 002  02 ^B stx    34 042  22 "      66 102  42 B      98 142  62 b
  622.   3 003  03 ^C etx    35 043  23 #      67 103  43 C      99 143  63 c
  623.   4 004  04 ^D eot    36 044  24 $      68 104  44 D     100 144  64 d
  624.   5 005  05 ^E enq    37 045  25 %      69 105  45 E     101 145  65 e
  625.   6 006  06 ^F ack    38 046  26 &      70 106  46 F     102 146  66 f
  626.   7 007  07 ^G bel    39 047  27 '      71 107  47 G     103 147  67 g
  627.   8 010  08 ^H bs     40 050  28 (      72 110  48 H     104 150  68 h
  628.   9 011  09 ^I ht     41 051  29 )      73 111  49 I     105 151  69 i
  629.  10 012  0A ^J lf     42 052  2A *      74 112  4A J     106 152  6A j
  630.  11 013  0B ^K vt     43 053  2B +      75 113  4B K     107 153  6B k
  631.  12 014  0C ^L ff     44 054  2C ,      76 114  4C L     108 154  6C l
  632.  13 015  0D ^M cr     45 055  2D -      77 115  4D M     109 155  6D m
  633.  14 016  0E ^N so     46 056  2E .      78 116  4E N     110 156  6E n
  634.  15 017  0F ^O si     47 057  2F /      79 117  4F O     111 157  6F o
  635.  16 020  10 ^P dle    48 060  30 0      80 120  50 P     112 160  70 p
  636.  17 021  11 ^Q dc1    49 061  31 1      81 121  51 Q     113 161  71 q
  637.  18 022  12 ^R dc2    50 062  32 2      82 122  52 R     114 162  72 r
  638.  19 023  13 ^S dc3    51 063  33 3      83 123  53 S     115 163  73 s
  639.  20 024  14 ^T dc4    52 064  34 4      84 124  54 T     116 164  74 t
  640.  21 025  15 ^U nak    53 065  35 5      85 125  55 U     117 165  75 u
  641.  22 026  16 ^V syn    54 066  36 6      86 126  56 V     118 166  76 v
  642.  23 027  17 ^W etb    55 067  37 7      87 127  57 W     119 167  77 w
  643.  24 030  18 ^X can    56 070  38 8      88 130  58 X     120 170  78 x
  644.  25 031  19 ^Y em     57 071  39 9      89 131  59 Y     121 171  79 y
  645.  26 032  1A ^Z sub    58 072  3A :      90 132  5A Z     122 172  7A z
  646.  27 033  1B ^[ esc    59 073  3B ;      91 133  5B [     123 173  7B {
  647.  28 034  1C ^\ fs     60 074  3C <      92 134  5C \     124 174  7C |
  648.  29 035  1D ^] gs     61 075  3D =      93 135  5D ]     125 175  7D }
  649.  30 036  1E ^^ rs     62 076  3E >      94 136  5E ^     126 176  7E ~
  650.  31 037  1F ^_ us     63 077  3F ?      95 137  5F _     127 176  7F del
  651.  
  652.  ^ denotes control key simultaneous with character key.
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661. Appendix B       Copyright Information:
  662.  
  663.  
  664. Disclaimer:
  665.  
  666.             PseudoSam 18 is distributed as is, with no guarantee that it
  667.             will work correctly in all situations.  In no event will the
  668.             Author be liable for any damages, including lost profits,
  669.             lost savings or other incidental or consequential damages
  670.             arising out of the use of or inability to use these
  671.             programs, even if the Author has been advised of the
  672.             possibility of such damages, or for any claim by any other
  673.             party.
  674.  
  675. Copyright Information:
  676.  
  677.             The entire PseudoSam 18 distribution package, consisting of
  678.             the main program, documentation files, and various data and
  679.             utility files, is copyright (c) 1986, by PseudoCode.
  680.  
  681.             The author reserves the exclusive right to distribute this
  682.             package, or any part thereof, for profit.
  683.  
  684.             The name "PseudoSam (tm)", applied to an assembler
  685.             program, is a trade mark of the PseudoCode company.
  686.  
  687.             PseudoSam version 1.x.xx and various subsidiary files may be
  688.             copied freely by individuals for non-commercial purposes. It
  689.             is expected that those who find the package useful will
  690.             purchase the update service.
  691.             ONLY UNMODIFIED VERSIONS DISPLAYING THE AUTHORS COPYRIGHT
  692.             MAY BE COPIED.
  693.  
  694.             User groups and clubs are authorized to distribute PseudoSam
  695.             software under the following conditions:
  696.  
  697.             1.  No charge is made for the software or documentation.  A
  698.                 nominal distribution fee may be charged, provided that
  699.                 it is no more than $5 total.
  700.  
  701.             2.  Recipients are to be informed of the user-supported
  702.                 software concept, and encouraged to support it with
  703.                 their donations.
  704.  
  705.             3.  The program and documentation are not modified in ANY
  706.                 way, and are distributed together.
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.             Interested manufacturers please see the commercial registration
  714.             form that follows to license PseudoSam 18 for bundling with
  715.             MS-DOS based development systems.
  716.  
  717.             Distribution of PseudoSam 18 outside the United States is through
  718.             licensed distributors, on a royalty basis.  Interested
  719.             distributors are invited to contact PseudoCode.
  720.  
  721.  
  722.  
  723. Educational Use:
  724.  
  725.             Educational institutions are free to use this software
  726.             in their classes and are encouraged to distribute this
  727.             package to their students, however inorder to receive
  728.             periodic updates and technical assistance the appropriate
  729.             department must remit the license fee.  Also a staff
  730.             member must be assigned to clear all trouble reports before
  731.             forwarding them to PseudoCode.
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.         If you use this software, please help support it.  Your
  741.         support can take three forms:
  742.  
  743.         1. Become a registered user.  The suggested payment for
  744.            registration is $30($100 for complete family).
  745.  
  746.         2. Suggestions, comments, and bug reports.
  747.  
  748.         3. Spread the word.  Make copies for friends.  Write the editor
  749.            of your favorite computer magazine.  Astronomical advertising
  750.            costs are one big reason that commercial software is so over-
  751.            priced.  To continue offering PseudoSam 18 this way, we need
  752.            your help in letting other people know about PseudoSam 18.
  753.  
  754.         Those who make the $30 payment to become registered users
  755.         receive the following benefits:(order form on next page)
  756.  
  757.         1. One year of updates including any upgrades. This includes
  758.            at least one new version release even if it takes more than
  759.            one year.
  760.  
  761.         2. User support by mail.  Support is only available to registered
  762.            users.  The address for help is given below.
  763.  
  764.         3. Notices announcing the release of new products.
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.              Attention:BUGS             PseudoCode
  775.                                         P.O. Box 1423
  776.                                         Newport News, VA     23601
  777.  
  778.  
  779.  
  780.  
  781.  
  782.       ********ORDER FORM********
  783.  
  784.       Please add me to the list of registered PseudoSam 18 users, and send me
  785.       the most recent version. I understand that registration entitles me to
  786.       one year of free updates and new releases, or one free new version
  787.       release, whichever occurs last.
  788.  
  789.       Note that version 1.2.02 requires DOS 2 (or later) and 256K.
  790.  
  791.       Computer Model: ____________________________________
  792.  
  793.       Diskette format:            Total Memory: _______K
  794.                                      (256K required)
  795.          __ doubled sided/DOS 2
  796.  
  797.       Check one:
  798.              ___ I enclose a check for $30
  799.              (PseudoCode pays sales tax for VA orders)
  800.  
  801.       Where did you hear about PseudoSam 18? ________________________________
  802.  
  803.       Name:    _______________________________________________________
  804.  
  805.       Address: _______________________________________________________
  806.  
  807.       City, State, Zip: ______________________________________________
  808.  
  809.       ================================================================
  810.  
  811.            Send order form with check or money order payable to PseudoCode to:
  812.            (Qualified PO's will be billed.)
  813.  
  814.            Attention: Registration         PseudoCode
  815.                                            P.O. Box 1423
  816.                                            Newport News, VA     23601
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.       ********ORDER FORM********
  824.  
  825.       Please add me to the list of registered users of the complete
  826.       PseudoSam family of cross-assemblers. Send me the most recent
  827.       versions.  I understand that registration entitles me to
  828.       one year of free updates and new releases, or one free new
  829.       version release, whichever occurs last.
  830.  
  831.  
  832.       I note that version 1.2.02 requires DOS 2 (or later) and 256K.
  833.  
  834.       Computer Model: ____________________________________
  835.  
  836.       Diskette format:            Total Memory: _______K
  837.                                      (256K required)
  838.          __ single sided/DOS 2(360k)
  839.  
  840.       Check one:
  841.              ___ I enclose a check or money order for $100
  842.                  (shipping, handling, and Virginia sales tax for VA orders
  843.                   is paid by PseudoCode).
  844.  
  845.       Where did you hear about the PseudoSam family? ________________________
  846.  
  847.       Name:    _______________________________________________________
  848.  
  849.       Address: _______________________________________________________
  850.  
  851.       City, State, Zip: ______________________________________________
  852.  
  853.       ================================================================
  854.  
  855.            Send order form with check or money order payable to PseudoCode to:
  856.            (Qualified PO's will be billed.)
  857.  
  858.            Attention: Registration         PseudoCode
  859.                                            P.O. Box 1423
  860.                                            Newport News, VA     23601
  861.  
  862.  
  863.  
  864.  
  865.       ********Commercial Distribution Agreement********
  866.  
  867.       Please add me to the list of registered PseudoSam 18 distributors, and
  868.       send me the most recent version. I understand that registration entitles
  869.       me to distribute this package freely on an "as is" basis to purchasers
  870.       of my products. I further understand that I may not make a specific or
  871.       additional charge for this package. I may however advertise the package
  872.       as free software. I fully understand that the distributed software
  873.       must be clearly labeled as follows:
  874.  
  875.       Complementary Software
  876.       Distributed "AS IS"
  877.       PseudoCode
  878.       P.O. Box 1423
  879.       Newport News, VA 23601
  880.  
  881.  
  882.  
  883.       I understand that this agreement entitles me to one year of distribution
  884.       rights and free updates.
  885.  
  886.       Note that version 1.2.02 requires DOS 2 (or later) and 256K.
  887.  
  888.       Computer Model: ____________________________________
  889.  
  890.       Diskette format:            Total Memory: _______K
  891.                                      (256K required)
  892.          __ doubled sided/DOS 2
  893.  
  894.       Check one:
  895.              ___ I enclose a check for $30
  896.              (PseudoCode pays sales tax for VA orders)
  897.  
  898.       Where did you hear about PseudoSam 18? ________________________________
  899.  
  900.       Name:    _______________________________________________________
  901.  
  902.       Address: _______________________________________________________
  903.  
  904.       City, State, Zip: ______________________________________________
  905.  
  906.       Signature_______________________   Date_________________
  907.  
  908.       ================================================================
  909.  
  910.            Send order form with check or money order payable to PseudoCode to:
  911.            (Qualified PO's will be billed.)
  912.  
  913.            Attention: Registration         PseudoCode
  914.                                            P.O. Box 1423
  915.                                            Newport News, VA     23601
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.       ********Commercial Distribution Agreement********
  923.  
  924.  
  925.       Please add me to the list of registered PseudoSam distributors, and
  926.       send me the most recent version. I understand that registration entitles
  927.       me to distribute this package freely on an "as is" basis to purchasers
  928.       of my products. I further understand that I may not make a specific or
  929.       additional charge for this package. I may however advertise the package
  930.       as free software. I fully understand that the distributed software
  931.       must be clearly labeled as follows:
  932.  
  933.       Complementary Software
  934.       Distributed "AS IS"
  935.       PseudoCode
  936.       P.O. Box 1423
  937.       Newport News, VA 23601
  938.  
  939.  
  940.  
  941.       I understand that this agreement entitles me to one year of distribution
  942.       rights and free updates for the entire PseudoSam family of products.
  943.  
  944.  
  945.       I note that version 1.2.02 requires DOS 2 (or later) and 256K.
  946.  
  947.       Computer Model: ____________________________________
  948.  
  949.       Diskette format:            Total Memory: _______K
  950.                                      (256K required)
  951.          __ single sided/DOS 2(360k)
  952.  
  953.       Check one:
  954.              ___ I enclose a check or money order for $100
  955.                  (shipping, handling, and Virginia sales tax for VA orders
  956.                   is paid by PseudoCode).
  957.  
  958.       Where did you hear about the PseudoSam family? ________________________
  959.  
  960.       Name:    _______________________________________________________
  961.  
  962.       Address: _______________________________________________________
  963.  
  964.       City, State, Zip: ______________________________________________
  965.  
  966.       Signature_______________________   Date_________________
  967.  
  968.       ================================================================
  969.  
  970.            Send order form with check or money order payable to PseudoCode to:
  971.            (Qualified PO's will be billed.)
  972.  
  973.            Attention: Registration         PseudoCode
  974.                                            P.O. Box 1423
  975.                                            Newport News, VA     23601
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.       The PsuedoSam Family consists of the following cross-assemblers
  984.  
  985.        Name            Designed for         Available*   V1.1.00
  986.  
  987.        PseudoSam 48   ;Intel 8048 family.     Now
  988.        PseudoSam 51   ;Intel 8051 family.     Now
  989.        PsuedoSam 96   ;Intel 8096 family.     Now
  990.        PseudoSam 68   ;Motorola
  991.                       ;6800,01,02,03,08.      Now
  992.        PseudoSam 685  ;Motorola 6805.         Now
  993.        PsuedoSam 689  ;Motorola 6809.         Now
  994.        PseudoSam 65   ;6502.                  Now
  995.        PseudoSam 85   ;Intel 8080,8085.       Now
  996.        PseudoSam 80z  ;Zilog Z80, NSC800.     Now
  997.        PseudoSam 18   ;RCA 1802.              Now
  998.        PseudoSam 32   ;NSC 32000 Family.      Apr 87
  999.        PseudoSam 68k  ;Motorola 68000 family. May 87
  1000.  
  1001.    * PseudoCode reserves the right to change price and availability
  1002.      of any product without notice.
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012. Appendix C: Description of Files
  1013.  
  1014.       Your PseudoSam 18 distribution disk contains a number of files.  This
  1015.       appendix will give a brief statement of the purpose of each of the
  1016.       files.
  1017.  
  1018.       FILE           DESCRIPTION
  1019.       ----------------------------------------------------------------
  1020.       A18.COM         The PseudoSam 18 program.
  1021.       A18.DOC         This document.
  1022.       EXAMPLE.ASM     Sample source file.
  1023.       MNEMTEST.ASM    Mnemnonics test file.
  1024.       SYN.ASM         Useful mnemnonics redefinitions
  1025.       COMRCIAL.USE    Commercial distribution agreement.
  1026.  
  1027.       Occasionally, various other sample source files for PseudoSam 18 will be
  1028.       distributed.  These files will have extension ASM, and will be
  1029.       accompanied by a corresponding DOC file.
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039. Appendix D: Bug Reporting Procedure.
  1040.  
  1041.  
  1042.       Although each version of PseudoSam 18 is tested extensively prior
  1043.       to release, any program is bound to contain a few bugs.  It is
  1044.       the intention of PseudoCode to correct any genuine problem that
  1045.       is reported.
  1046.  
  1047.       If you think you have found a bug in PseudoSam 18, please take the time
  1048.       to report it for correction.  Although any report is helpful,
  1049.       correction of the problem will be easiest if you provide the
  1050.       following:
  1051.  
  1052.          1. The version of PseudoSam 18 you are using.  Your problem may have
  1053.             been fixed already.
  1054.  
  1055.          2. A brief description of the problem.
  1056.  
  1057.          3. A copy of the problem source file, preferably on a floppy disk.
  1058.             (The cost of floppies is so small($.29), they will not be
  1059.              returned and become the property of PseudoCode.)
  1060.  
  1061.             * It is NOT necessary to send a large program to demonstrate
  1062.               problem.  Please try to isolate the problem area, by
  1063.               writing a short sample program that demonstrates the bug.
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.              Attention:BUGS             PseudoCode
  1071.                                         P.O. Box 1423
  1072.                                         Newport News, VA     23601
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.       Appendix E   Using PseudoSam 18 on "Compatible" Systems.
  1081.  
  1082.       PseudoSam 18 was written specifically for the IBM PC, but should
  1083.       function normally on true "compatibles".
  1084.  
  1085.       Since PseudoSam 18 version 1.2.00 is a totally new program, little
  1086.       compatibility data is currently available.  If you are using (or
  1087.       are unable to use...) PseudoSam 18 on a non-IBM computer, please
  1088.       write with your experiences.  Does PseudoSam 18 work correctly on
  1089.       your system?  Are there specific problem areas?  Can they be worked
  1090.       around?
  1091.  
  1092.       The following systems are known to run PseudoSam 18 version 1.2.00
  1093.       successfully:
  1094.              IBM PC
  1095.              IBM XT
  1096.              IBM AT
  1097.              Sperry PC (all models).
  1098.              JDR Microdevices PC Clones.
  1099.  
  1100.