3a_asm: FEATURE/FIX: proper line numbers on parsing error

[calu.git] / 2_isa / callingconv.tex

diff --git a/2_isa/callingconv.tex b/2_isa/callingconv.tex
index 37e85dc29871614ad4bb6eeadd2159eebbea59f9..951ef0beec7fc9a4288017aa7eb4e7057c36cbcc 100644 (file)
--- a/2_isa/callingconv.tex
+++ b/2_isa/callingconv.tex
@@ -5,7 +5,7 @@ Programs and functions implementing this instruction set, should implement the f
 \begin{table}[ht]
        \centering
        \begin{tabular}{|c|c|c|} \hline
-               register & saved by & usage  \\ \hline
+               \textbf{register} & \textbf{saved by} & \textbf{usage} \\ \hline
                r0       & caller   & return \\ \hline
                r1       & caller   & first parameter \\ \hline
                r2       & caller   & second parameter \\ \hline
@@ -47,24 +47,38 @@ a signed displacement.
 r1, 0x20-8(r3)} is a valid instruction
 \end{itemize}
 
-\subsubsection{Directives}
+\subsection{Directives}
 In order to gain extra comfort, several directives are interpreted by the
 assembler, a list is given in table~\ref{tab:asmdirs}.
 \begin{table}[ht]
        \centering
        \begin{tabular}{|l|p{10cm}|} \hline
-               Name & Description \\ \hline
+               \textbf{Name} & \textbf{Description} \\ \hline
                \texttt{.data} & subsequent data is desired for the data memory\\ \hline
                \texttt{.text} & subsequent code is desired for the instruction memory\\ \hline
                \verb+.include "file.s"+ & include a further file \\ \hline
-               \texttt{.define <name> <value>} & define a constant. Note that a define
-               isn't equal to a label\\ \hline
+               \texttt{.org \textit{addr}} & move \textit{forward} to a specific
+               address in data or instruction memory, depending on the current
+               section \\ \hline
+
+               \texttt{.fill \textit{repeat}, \textit{value}} & place a
+               32 bit value \texttt{\textit{repeat}}-times, while
+               \texttt{\textit{repeat}} is optional.
+
+               When one parameter is given, the value is placed at the current address.
+               Note that a given value will be rounded up to a full byte, e.g.
+               \texttt{0x123} occupy two bytes.
+
+               When two parameters are given, the first equals \texttt{\textit{repeat}}
+               and the second corresponds to \texttt{\textit{value}} \\ \hline
+
+               \texttt{.define \textit{name}, \textit{value}} & define a constant. Note
+               that a define isn't equal to a label\\ \hline
+
                \texttt{label: <instr/data>} & label an instruction or data. The label
                can be used as an alias for the address of this instruction in the
                instruction memory or as a reference in the data memory, depending on
                the current section\\ \hline
-               %TODO: those are maybe handy: .fill(
-               %http://www.myri.com/scs/L3/doc/as_7.html#SEC85)
        \end{tabular}
        \caption{supported directives by the assembler}
        \label{tab:asmdirs}