LWTools: docs/manual/x261.html annotate

annotate docs/manual/x261.html @ 577:e49d24f4a9a5

Correct bug in the object file output code leading to stack corruption It turns out leaving a pointer to a stack allocated temporary in a persistent data structure is not conducive to correct program operation. Undo the export check setup in the object file output sequence so a pointer to stack allocated memory is not left hanging when the function returns. This seems to correct at least one mysterious crash bug, and possibly others. Thanks to Boisy Pitre for reporting the crash bug that led to this discovery, as well as a previous crash bug that likely has the same root cause. Additional thanks to Ciaran Anscomb whose debugger wielding wizardry revealed the exact location of this particular bit of unbrilliance.

author	William Astle <lost@l-w.ca>
date	Sat, 03 Aug 2024 14:30:06 -0600
parents	fc072f6cde09
children

rev	line source
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	2 <HTML
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	3 ><HEAD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	4 ><TITLE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	5 >Assembler Directives</TITLE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	6 ><META
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	7 NAME="GENERATOR"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	9 REL="HOME"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	10 TITLE="LW Tool Chain"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	11 HREF="index.html"><LINK
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	12 REL="UP"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	13 TITLE="LWASM"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	14 HREF="c62.html"><LINK
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	15 REL="PREVIOUS"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	16 TITLE="Numbers and Expressions"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	17 HREF="x253.html"><LINK
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	18 REL="NEXT"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	19 TITLE="Macros"
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	20 HREF="x568.html"></HEAD
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	21 ><BODY
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	22 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	23 BGCOLOR="#FFFFFF"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	24 TEXT="#000000"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	25 LINK="#0000FF"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	26 VLINK="#840084"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	27 ALINK="#0000FF"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	28 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	29 CLASS="NAVHEADER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	30 ><TABLE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	31 SUMMARY="Header navigation table"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	32 WIDTH="100%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	33 BORDER="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	34 CELLPADDING="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	35 CELLSPACING="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	36 ><TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	37 ><TH
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	38 COLSPAN="3"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	39 ALIGN="center"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	40 >LW Tool Chain</TH
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	41 ></TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	42 ><TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	43 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	44 WIDTH="10%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	45 ALIGN="left"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	46 VALIGN="bottom"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	47 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	48 HREF="x253.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	49 ACCESSKEY="P"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	50 >Prev</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	51 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	52 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	53 WIDTH="80%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	54 ALIGN="center"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	55 VALIGN="bottom"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	56 >Chapter 3. LWASM</TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	57 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	58 WIDTH="10%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	59 ALIGN="right"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	60 VALIGN="bottom"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	61 ><A
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	62 HREF="x568.html"
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	63 ACCESSKEY="N"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	64 >Next</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	65 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	66 ></TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	67 ></TABLE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	68 ><HR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	69 ALIGN="LEFT"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	70 WIDTH="100%"></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	71 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	72 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	73 ><H1
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	74 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	75 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	76 NAME="AEN261"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	77 >3.6. Assembler Directives</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	78 ></H1
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	79 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	80 >Various directives can be used to control the behaviour of the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	81 assembler or to include non-code/data in the resulting output. Those directives
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	82 that are not described in detail in other sections of this document are
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	83 described below.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	84 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	85 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	86 ><H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	87 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	88 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	89 NAME="AEN264"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	90 >3.6.1. Data Directives</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	91 ></H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	92 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	93 ></P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	94 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	95 CLASS="VARIABLELIST"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	96 ><DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	97 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	98 >FCB <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	99 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	100 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	101 >, .DB <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	102 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	103 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	104 >, .BYTE <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	105 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	106 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	107 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	108 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	109 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	110 >Include one or more constant bytes (separated by commas) in the output.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	111 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	112 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	113 >FDB <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	114 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	115 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	116 >, .DW <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	117 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	118 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	119 >, .WORD <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	120 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	121 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	122 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	123 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	124 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	125 >Include one or more words (separated by commas) in the output.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	126 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	127 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	128 >FQB <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	129 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	130 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	131 >, .QUAD <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	132 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	133 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	134 >, .4BYTE <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	135 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	136 >expr[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	137 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	138 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	139 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	140 >Include one or more double words (separated by commas) in the output.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	141 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	142 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	143 >FCC <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	144 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	145 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	146 >, .ASCII <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	147 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	148 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	149 >, .STR <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	150 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	151 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	152 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	153 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	154 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	155 >Include a string of text in the output. The first character of the operand
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	156 is the delimiter which must appear as the last character and cannot appear
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	157 within the string. The string is included with no modifications></P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	158 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	159 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	160 >FCN <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	161 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	162 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	163 >, .ASCIZ <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	164 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	165 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	166 >, .STRZ <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	167 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	168 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	169 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	170 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	171 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	172 >Include a NUL terminated string of text in the output. The first character of
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	173 the operand is the delimiter which must appear as the last character and
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	174 cannot appear within the string. A NUL byte is automatically appended to
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	175 the string.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	176 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	177 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	178 >FCS <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	179 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	180 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	181 >, .ASCIS <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	182 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	183 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	184 >, .STRS <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	185 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	186 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	187 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	188 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	189 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	190 >Include a string of text in the output with bit 7 of the final byte set. The
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	191 first character of the operand is the delimiter which must appear as the last
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	192 character and cannot appear within the string.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	193 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	194 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	195 >ZMB <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	196 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	197 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	198 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	199 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	200 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	201 >Include a number of NUL bytes in the output. The number must be fully resolvable
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	202 during pass 1 of assembly so no forward or external references are permitted.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	203 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	204 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	205 >ZMD <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	206 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	207 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	208 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	209 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	210 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	211 >Include a number of zero words in the output. The number must be fully
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	212 resolvable during pass 1 of assembly so no forward or external references are
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	213 permitted.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	214 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	215 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	216 >ZMQ <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	217 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	218 >expr<CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	219 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	220 ></CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	221 ></CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	222 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	223 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	224 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	225 >Include a number of zero double-words in the output. The number must be fully
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	226 resolvable during pass 1 of assembly so no forward or external references are
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	227 permitted.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	228 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	229 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	230 >RMB <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	231 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	232 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	233 >, .BLKB <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	234 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	235 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	236 >, .DS <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	237 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	238 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	239 >, .RS <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	240 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	241 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	242 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	243 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	244 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	245 >Reserve a number of bytes in the output. The number must be fully resolvable
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	246 during pass 1 of assembly so no forward or external references are permitted.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	247 The value of the bytes is undefined.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	248 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	249 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	250 >RMD <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	251 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	252 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	253 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	254 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	255 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	256 >Reserve a number of words in the output. The number must be fully
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	257 resolvable during pass 1 of assembly so no forward or external references are
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	258 permitted. The value of the words is undefined.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	259 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	260 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	261 >RMQ <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	262 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	263 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	264 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	265 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	266 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	267 >Reserve a number of double-words in the output. The number must be fully
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	268 resolvable during pass 1 of assembly so no forward or external references are
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	269 permitted. The value of the double-words is undefined.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	270 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	271 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	272 >INCLUDEBIN <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	273 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	274 >filename</CODE
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	275 >[,<CODE
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	276 CLASS="PARAMETER"
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	277 >start</CODE
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	278 >[,<CODE
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	279 CLASS="PARAMETER"
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	280 >length</CODE
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	281 >]]</DT
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	282 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	283 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	284 >Treat the contents of <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	285 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	286 >filename</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	287 > as a string of bytes to
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	288 be included literally at the current assembly point. This has the same effect
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	289 as converting the file contents to a series of FCB statements and including
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	290 those at the current assembly point.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	291 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	292 > If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	293 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	294 >filename</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	295 > beings with a /, the file name
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	296 will be taken as absolute. Otherwise, the current directory will be
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	297 searched followed by the search path in the order specified.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	298 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	299 > Please note that absolute path detection including drive letters will
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	300 not function correctly on Windows platforms. Non-absolute inclusion will
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	301 work, however.</P
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	302 ><P
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	303 > The optional <CODE
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	304 CLASS="PARAMETER"
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	305 >start</CODE
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	306 > parameter allows you to set
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	307 the byte offset to start reading from the binary file. Positive values are
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	308 from the beginning of the file, negative values are from the end of the file.</P
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	309 ><P
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	310 > The optional <CODE
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	311 CLASS="PARAMETER"
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	312 >length</CODE
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	313 > parameter allows you to set
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	314 the number of bytes read from the binary file. If missing, then the file is
fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	315 read to the end.</P
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	316 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	317 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	318 >FILL <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	319 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	320 >byte</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	321 >,<CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	322 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	323 >size</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	324 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	325 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	326 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	327 >Insert <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	328 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	329 >size</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	330 > bytes of <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	331 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	332 >byte</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	333 >.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	334 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	335 ></DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	336 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	337 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	338 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	339 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	340 ><H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	341 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	342 ><A
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	343 NAME="AEN381"
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	344 >3.6.2. Address Definition</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	345 ></H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	346 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	347 >The directives in this section all control the addresses of symbols
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	348 or the assembly process itself.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	349 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	350 ></P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	351 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	352 CLASS="VARIABLELIST"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	353 ><DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	354 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	355 >ORG <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	356 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	357 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	358 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	359 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	360 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	361 >Set the assembly address. The address must be fully resolvable on the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	362 first pass so no external or forward references are permitted. ORG is not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	363 permitted within sections when outputting to object files. For target formats
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	364 that include address information (decb, hex, srec, and ihex), an ORG
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	365 directive will re-start the address sequence within the output. When using
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	366 the raw target format, ORG is used only to determine the addresses of symbols.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	367 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	368 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	369 >REORG</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	370 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	371 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	372 >Sets the assembly address to the value it had immediately prior to the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	373 previous ORG statement. It is used to continue assembly after some
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	374 specification that required an additional ORG. This directive is primarily
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	375 intended for MACRO-80c compatibility. Consider using alternatives in
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	376 modern code.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	377 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	378 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	379 ><CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	380 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	381 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	382 > EQU <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	383 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	384 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	385 >, <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	386 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	387 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	388 > = <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	389 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	390 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	391 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	392 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	393 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	394 >Define the value of <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	395 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	396 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	397 > to be <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	398 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	399 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	400 >.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	401 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	402 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	403 ><CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	404 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	405 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	406 > SET <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	407 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	408 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	409 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	410 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	411 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	412 >Define the value of <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	413 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	414 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	415 > to be <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	416 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	417 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	418 >.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	419 Unlike EQU, SET permits symbols to be defined multiple times as long as SET
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	420 is used for all instances. Use of the symbol before the first SET statement
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	421 that sets its value is undefined.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	422 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	423 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	424 >SETDP <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	425 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	426 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	427 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	428 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	429 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	430 >Inform the assembler that it can assume the DP register contains
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	431 <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	432 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	433 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	434 >. This directive is only advice to the assembler
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	435 to determine whether an address is in the direct page and has no effect
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	436 on the contents of the DP register. The value must be fully resolved during
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	437 the first assembly pass because it affects the sizes of subsequent instructions.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	438 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	439 >This directive has no effect in the object file target.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	440 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	441 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	442 >ALIGN <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	443 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	444 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	445 >[,<CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	446 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	447 >value</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	448 >]</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	449 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	450 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	451 >Force the current assembly address to be a multiple of
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	452 <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	453 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	454 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	455 >. If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	456 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	457 >value</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	458 > is not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	459 specified, a series of NUL bytes is output to force the alignment, if
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	460 required. Otherwise, the low order 8 bits of <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	461 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	462 >value</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	463 >
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	464 will be used as the fill. The alignment value must be fully resolved on the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	465 first pass because it affects the addresses of subsquent instructions.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	466 However, <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	467 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	468 >value</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	469 > may include forward references; as
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	470 long as it resolves to a constant for the second pass, the value will be
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	471 accepted.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	472 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	473 >Unless <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	474 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	475 >value</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	476 > is specified as something like $12,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	477 this directive is not suitable for inclusion in the middle of actual code.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	478 The default padding value is $00 which is intended to be used within data
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	479 blocks. </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	480 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	481 ></DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	482 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	483 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	484 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	485 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	486 ><H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	487 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	488 ><A
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	489 NAME="AEN432"
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	490 >3.6.3. Conditional Assembly</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	491 ></H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	492 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	493 >Portions of the source code can be excluded or included based on conditions
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	494 known at assembly time. Conditionals can be nested arbitrarily deeply. The
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	495 directives associated with conditional assembly are described in this section.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	496 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	497 >All conditionals must be fully bracketed. That is, every conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	498 statement must eventually be followed by an ENDC at the same level of nesting.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	499 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	500 >Conditional expressions are only evaluated on the first assembly pass.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	501 It is not possible to game the assembly process by having a conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	502 change its value between assembly passes. Due to the underlying architecture
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	503 of LWASM, there is no possible utility to IFP1 and IFP2, nor can they, as of LWASM 3.0, actually
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	504 be implemented meaningfully. Thus there is not and never will
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	505 be any equivalent of IFP1 or IFP2 as provided by other assemblers. Use of those opcodes
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	506 will throw a warning and be ignored.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	507 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	508 >It is important to note that if a conditional does not resolve to a constant
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	509 during the first parsing pass, an error will be thrown. This is unavoidable because the assembler
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	510 must make a decision about which source to include and which source to exclude at this stage.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	511 Thus, expressions that work normally elsewhere will not work for conditions.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	512 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	513 ></P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	514 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	515 CLASS="VARIABLELIST"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	516 ><DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	517 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	518 >IFEQ <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	519 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	520 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	521 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	522 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	523 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	524 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	525 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	526 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	527 > evaluates to zero, the conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	528 will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	529 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	530 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	531 >IFNE <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	532 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	533 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	534 >, IF <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	535 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	536 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	537 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	538 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	539 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	540 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	541 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	542 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	543 > evaluates to a non-zero value, the conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	544 will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	545 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	546 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	547 >IFGT <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	548 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	549 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	550 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	551 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	552 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	553 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	554 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	555 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	556 > evaluates to a value greater than zero, the conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	557 will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	558 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	559 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	560 >IFGE <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	561 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	562 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	563 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	564 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	565 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	566 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	567 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	568 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	569 > evaluates to a value greater than or equal to zero, the conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	570 will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	571 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	572 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	573 >IFLT <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	574 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	575 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	576 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	577 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	578 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	579 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	580 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	581 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	582 > evaluates to a value less than zero, the conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	583 will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	584 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	585 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	586 >IFLE <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	587 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	588 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	589 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	590 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	591 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	592 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	593 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	594 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	595 > evaluates to a value less than or equal to zero , the conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	596 will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	597 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	598 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	599 >IFDEF <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	600 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	601 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	602 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	603 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	604 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	605 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	606 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	607 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	608 > is defined at this point in the assembly
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	609 process, the conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	610 will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	611 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	612 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	613 >IFPRAGMA <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	614 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	615 >pragma</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	616 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	617 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	618 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	619 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	620 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	621 >pragma</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	622 > is in effect, the condition will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	623 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	624 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	625 >IFNDEF <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	626 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	627 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	628 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	629 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	630 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	631 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	632 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	633 >sym</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	634 > is not defined at this point in the assembly
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	635 process, the conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	636 will be considered true.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	637 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	638 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	639 >ELSE</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	640 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	641 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	642 >If the preceding conditional at the same level of nesting was false, the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	643 statements following will be assembled. If the preceding conditional at
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	644 the same level was true, the statements following will not be assembled.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	645 Note that the preceding conditional might have been another ELSE statement
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	646 although this behaviour is not guaranteed to be supported in future versions
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	647 of LWASM.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	648 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	649 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	650 >ENDC</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	651 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	652 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	653 >This directive marks the end of a conditional construct. Every conditional
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	654 construct must end with an ENDC directive.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	655 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	656 ></DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	657 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	658 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	659 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	660 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	661 ><H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	662 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	663 ><A
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	664 NAME="AEN503"
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	665 >3.6.4. OS9 Target Directives</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	666 ></H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	667 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	668 >This section includes directives that apply solely to the OS9
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	669 target.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	670 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	671 ></P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	672 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	673 CLASS="VARIABLELIST"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	674 ><DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	675 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	676 >OS9 <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	677 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	678 >syscall</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	679 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	680 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	681 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	682 > This directive generates a call to the specified system call. <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	683 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	684 >syscall</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	685 > may be an arbitrary expression. </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	686 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	687 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	688 >MOD <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	689 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	690 >size</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	691 >,<CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	692 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	693 >name</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	694 >,<CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	695 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	696 >type</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	697 >,<CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	698 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	699 >flags</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	700 >,<CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	701 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	702 >execoff</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	703 >,<CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	704 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	705 >datasize</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	706 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	707 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	708 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	709 > This tells LWASM that the beginning of the actual module is here. It will
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	710 generate a module header based on the parameters specified. It will also
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	711 begin calcuating the module CRC. </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	712 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	713 > The precise meaning of the various parameters is beyond the scope of this
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	714 document since it is not a tutorial on OS9 module programming. </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	715 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	716 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	717 >EMOD</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	718 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	719 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	720 > This marks the end of a module and causes LWASM to emit the calculated CRC
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	721 for the module. </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	722 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	723 ></DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	724 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	725 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	726 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	727 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	728 ><H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	729 CLASS="SECTION"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	730 ><A
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	731 NAME="AEN528"
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	732 >3.6.5. Miscelaneous Directives</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	733 ></H2
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	734 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	735 >This section includes directives that do not fit into the other
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	736 categories.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	737 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	738 ></P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	739 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	740 CLASS="VARIABLELIST"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	741 ><DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	742 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	743 >INCLUDE <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	744 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	745 >filename</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	746 >, USE <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	747 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	748 >filename</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	749 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	750 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	751 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	752 > Include the contents of <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	753 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	754 >filename</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	755 > at
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	756 this point in the assembly as though it were a part of the file currently
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	757 being processed. Note that if whitespace appears in the name of the file,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	758 you must enclose <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	759 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	760 >filename</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	761 > in quotes.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	762 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	763 >Note that the USE variation is provided only for compatibility with other
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	764 assemblers. It is recommended to use the INCLUDE variation.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	765 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	766 >If <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	767 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	768 >filename</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	769 > begins with a "/", it is
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	770 interpreted as an absolute path. If it does not, the search path will be used
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	771 to find the file. First, the directory containing the file that contains this
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	772 directive. (Includes within an included file are relative to the included file,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	773 not the file that included it.) If the file is not found there, the include path
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	774 is searched. If it is still not found, an error will be thrown. Note that the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	775 current directory as understood by your shell or operating system is not searched.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	776 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	777 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	778 >END <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	779 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	780 >[expr]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	781 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	782 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	783 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	784 >This directive causes the assembler to stop assembling immediately as though
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	785 it ran out of input. For the DECB target only, <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	786 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	787 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	788 >
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	789 can be used to set the execution address of the resulting binary. For all
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	790 other targets, specifying <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	791 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	792 >expr</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	793 > will cause an error.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	794 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	795 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	796 >ERROR <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	797 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	798 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	799 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	800 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	801 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	802 >Causes a custom error message to be printed at this line. This will cause
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	803 assembly to fail. This directive is most useful inside conditional constructs
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	804 to cause assembly to fail if some condition that is known bad happens. Everything
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	805 from the directive to the end of the line is considered the error message.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	806 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	807 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	808 >WARNING <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	809 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	810 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	811 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	812 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	813 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	814 >Causes a custom warning message to be printed at this line. This will not cause
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	815 assembly to fail. This directive is most useful inside conditional constructs
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	816 or include files to alert the programmer to a deprecated feature being used
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	817 or some other condition that may cause trouble later, but which may, in fact,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	818 not cause any trouble.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	819 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	820 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	821 >.MODULE <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	822 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	823 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	824 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	825 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	826 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	827 >This directive is ignored for most output targets. If the output target
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	828 supports encoding a module name into it, <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	829 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	830 >string</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	831 >
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	832 will be used as the module name.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	833 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	834 >As of version 3.0, no supported output targets support this directive.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	835 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	836 ></DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	837 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	838 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	839 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	840 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	841 CLASS="NAVFOOTER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	842 ><HR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	843 ALIGN="LEFT"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	844 WIDTH="100%"><TABLE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	845 SUMMARY="Footer navigation table"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	846 WIDTH="100%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	847 BORDER="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	848 CELLPADDING="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	849 CELLSPACING="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	850 ><TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	851 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	852 WIDTH="33%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	853 ALIGN="left"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	854 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	855 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	856 HREF="x253.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	857 ACCESSKEY="P"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	858 >Prev</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	859 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	860 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	861 WIDTH="34%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	862 ALIGN="center"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	863 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	864 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	865 HREF="index.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	866 ACCESSKEY="H"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	867 >Home</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	868 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	869 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	870 WIDTH="33%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	871 ALIGN="right"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	872 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	873 ><A
565 fc072f6cde09 Update documentation to reflect includebin offset/length feature William Astle <lost@l-w.ca> parents: 489 diff changeset	874 HREF="x568.html"
489 52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	875 ACCESSKEY="N"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	876 >Next</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	877 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	878 ></TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	879 ><TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	880 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	881 WIDTH="33%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	882 ALIGN="left"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	883 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	884 >Numbers and Expressions</TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	885 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	886 WIDTH="34%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	887 ALIGN="center"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	888 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	889 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	890 HREF="c62.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	891 ACCESSKEY="U"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	892 >Up</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	893 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	894 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	895 WIDTH="33%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	896 ALIGN="right"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	897 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	898 >Macros</TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	899 ></TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	900 ></TABLE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	901 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	902 ></BODY
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	903 ></HTML
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	904 >

Mercurial > hg > index.cgi

annotate docs/manual/x261.html @ 577:e49d24f4a9a5