[Exspiminator-commits] CVS: exspiminator/docs tutorial.html,1.6,1.7

[Nigel P. <nph...@us...>]

Update of /cvsroot/exspiminator/exspiminator/docs
In directory usw-pr-cvs1:/tmp/cvs-serv31425/docs

Modified Files:
	tutorial.html 
Log Message:
Document new assembler directives.

Index: tutorial.html
===================================================================
RCS file: /cvsroot/exspiminator/exspiminator/docs/tutorial.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -r1.6 -r1.7
*** tutorial.html	2001/11/19 16:17:49	1.6
--- tutorial.html	2001/11/20 12:00:10	1.7
***************
*** 6,10 ****
  <h1>Exspiminator tutorial</h1>
  
! <p>This is a tutorial on using the Exspiminator version 0.4; a (currently incomplete) PowerPC <A HREF="asm-tutorial.html">assembly language tutorial</A> is also provided.
  
  <h2>What's what</h2>
--- 6,10 ----
  <h1>Exspiminator tutorial</h1>
  
! <p>This is a tutorial on using the Exspiminator version 0.5; a (currently incomplete) PowerPC <A HREF="asm-tutorial.html">assembly language tutorial</A> is also provided.
  
  <h2>What's what</h2>
***************
*** 27,32 ****
  
  <p>The assembler is very simple and does not include all the features a production quality assembler would.
! In particular it does not support user-defined macros, assemble-time arithmetic, or assembler directives. For the basic features, read the source files given in the samples folder.  Read the <A HREF="release.html">release notes</A> for a full list of supported instructions, read the <A HREF="asm-tutorial.html">assembly tutorial</A> for an introduction to the lanuage, and refer to the <A HREF="bibliography.html">bibliography</A> for links to PowerPC assembly language reference works.
  
  <h3>IO and the simulated program</h3>
  
--- 27,45 ----
  
  <p>The assembler is very simple and does not include all the features a production quality assembler would.
! In particular it does not support user-defined macros, assemble-time arithmetic, or many assembler directives. For the basic features, read the source files given in the samples folder.  Read the <A HREF="release.html">release notes</A> for a full list of supported instructions, read the <A HREF="asm-tutorial.html">assembly tutorial</A> for an introduction to the lanuage, and refer to the <A HREF="bibliography.html">bibliography</A> for links to PowerPC assembly language reference works.
  
+ <h3>Assembler directives</h3>
+ 
+ <p>Support for assembler directives is modelled (loosely) on IBM's AIX assembler. Currently supported: 
+ <p>
+ <table border="1">
+ <tr><th>Directive<th>Function
+ <tr><td><code>.align <em>N</em></code><td>Aligns the current location counter (padding with zeros) until reaching a boundary given by <em>N</em>: 0 indicates byte alignment, 1 is halfword alignment, 2 is word alignment, and 3 is double word alignment.
+ <tr><td><code>.byte <em>N1, N2, [...] Nn</em></code><td>Stores the least significant byte of the given value(s) into the object code.
+ <tr><td><code>.long <em>N1, N2, [...] Nn</em></code><td>Stores the value(s) into the object code.
+ <tr><td><code>.short <em>N1, N2, [...] Nn</em></code><td>Stores the least significant half word of the given value(s) into the object code.
+ <tr><td><code>.space <em>N</em></code><td>Sets aside space in the object code by inserting <em>N</em> bytes of value 0.
+ </table>
+ 
  <h3>IO and the simulated program</h3>
  
***************
*** 44,51 ****
  read:
          li r3, 0          # address of string to prompt user, or 0 for none
! 	li r4, buffy      # address of buffer in which to store the input
! 	li r5, 20         # the length of the buffer, in bytes
! 	li r0, 2          # select input
! 	sc
  </pre>
  
--- 57,64 ----
  read:
          li r3, 0          # address of string to prompt user, or 0 for none
!         li r4, buffy      # address of buffer in which to store the input
!         li r5, 20         # the length of the buffer, in bytes
!         li r0, 2          # select input
!         sc
  </pre>