home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / crossasm / ps68a12.zip / A68.DOC < prev    next >
Text File  |  1987-03-15  |  38KB  |  1,103 lines

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