[Exspiminator-commits] CVS: exspiminator/docs tutorial.html,1.6,1.7
Status: Alpha
Brought to you by:
nphillips
|
From: Nigel P. <nph...@us...> - 2001-11-20 12:00:13
|
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>
|