LWTools: docs/manual/x670.html annotate

annotate docs/manual/x670.html @ 508:10f62dc61a75

Fix bad usage of sprintf() Usage of sprintf() to append to a string in the form of sprintf(buf, "%s...", buf...) is undefined, regardless whether it worked on a lot of older systems. It was always a bad idea and it now breaks on current glibc and gcc development environments. The moral: if any of your code uses sprintf() in a way similar to the above, fix it. It may not fail in a benign way.

author	William Astle <lost@l-w.ca>
date	Sun, 10 May 2020 22:38:24 -0600
parents	52af0aa54fe5
children	1faf14de9d04

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 Modes and Pragmas</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="Object Files and Sections"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	17 HREF="x606.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="Convenience Instructions"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	20 HREF="x816.html"></HEAD
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="x606.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
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	62 HREF="x816.html"
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="AEN670"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	77 >3.10. Assembler Modes and Pragmas</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 >There are a number of options that affect the way assembly is performed.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	81 Some of these options can only be specified on the command line because
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	82 they determine something absolute about the assembly process. These include
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	83 such things as the output target. Other things may be switchable during
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	84 the assembly process. These are known as pragmas and are, by definition,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	85 not portable between assemblers.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	86 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	87 >LWASM supports a number of pragmas that affect code generation or
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	88 otherwise affect the behaviour of the assembler. These may be specified by
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	89 way of a command line option or by assembler directives. The directives
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	90 are as follows.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	91 ><P
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 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	94 CLASS="VARIABLELIST"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	95 ><DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	96 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	97 >PRAGMA <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	98 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	99 >pragma[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	100 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	101 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	102 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	103 >Specifies that the assembler should bring into force all <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	104 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	105 >pragma</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	106 >s
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	107 specified. Any unrecognized pragma will cause an assembly error. The new
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	108 pragmas will take effect immediately. This directive should be used when
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	109 the program will assemble incorrectly if the pragma is ignored or not supported.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	110 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	111 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	112 >*PRAGMA <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	113 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	114 >pragma[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	115 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	116 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	117 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	118 >This is identical to the PRAGMA directive except no error will occur with
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	119 unrecognized or unsupported pragmas. This directive, by virtue of starting
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	120 with a comment character, will also be ignored by assemblers that do not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	121 support this directive. Use this variation if the pragma is not required
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	122 for correct functioning of the code.</P
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 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	125 >*PRAGMAPUSH <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	126 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	127 >pragma[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	128 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	129 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	130 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	131 >This directive saves the current state of the specified pragma(s) for later retrieval. See discussion below for more information.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	132 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	133 >This directive will not throw any errors for any reason.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	134 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	135 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	136 >*PRAGMAPOP <CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	137 CLASS="PARAMETER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	138 >pragma[,...]</CODE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	139 ></DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	140 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	141 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	142 >This directive restores the previously saved state of the specified pragma(s). See discussion below for more information.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	143 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	144 >This directive will not throw any errors for any reason.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	145 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	146 ></DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	147 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	148 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	149 >Each pragma supported has a positive version and a negative version.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	150 The positive version enables the pragma while the negative version disables
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	151 it. The negatitve version is simply the positive version with "no" prefixed
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	152 to it. For instance, "pragma" vs. "nopragma". When only one version is
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	153 listed below, its opposite can be obtained by prepending "no" if it is not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	154 present or removing "no" from the beginning if it is present.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	155 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	156 >Pragmas are not case sensitive.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	157 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	158 ></P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	159 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	160 CLASS="VARIABLELIST"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	161 ><DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	162 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	163 >6800compat</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	164 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	165 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	166 >When in force, this pragma enables recognition of various
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	167 compatibility instructions useful when assembling 6800 code. These
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	168 compatibility instructions are assembled into equivalent 6809 instructions.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	169 This mode also includes several analogous instructions which are not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	170 strictly 6800 instructions but allow the similar style to be applied to 6809
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	171 specific features.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	172 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	173 >Technically, a compliant 6809 assembler must recognize these
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	174 instructions by default since Motorola advertised the 6809 as being source
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	175 compatible with the 6800. However, most source code does not require this
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	176 compatibility and LWASM itself did not support these instructions prior to
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	177 version 4.11 so this mode is disabled by default.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	178 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	179 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	180 >6809</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	181 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	182 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	183 >This pragma allows you to mark a section of code as 6809-only. In ths mode,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	184 the assembler will throw an error if any 6309 instructions are used.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	185 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	186 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	187 >6309</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 >This pragma enables the use of 6309 instructions and disables any 6809 specific
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	191 instructions. It also changes the cycle count listing output (if selected)
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	192 to display 6309 timings.</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 >6809conv, 6309conv</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	196 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	197 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	198 >These pragmas enable convenience instructions extending the 6809 and 6309
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	199 instruction sets respectively. For more information, see
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	200 <A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	201 HREF="x816.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	202 >Section 3.11</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	203 >.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	204 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	205 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	206 >index0tonone</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	207 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	208 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	209 >When in force, this pragma enables an optimization affecting indexed addressing
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	210 modes. When the offset expression in an indexed mode evaluates to zero but is
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	211 not explicity written as 0, this will replace the operand with the equivalent
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	212 no offset mode, thus creating slightly faster code. Because of the advantages
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	213 of this optimization, it is enabled by default.</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 >cescapes</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	217 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	218 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	219 >This pragma will cause strings in the FCC, FCS, and FCN pseudo operations to
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	220 have C-style escape sequences interpreted. The one departure from the official
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	221 spec is that unrecognized escape sequences will return either the character
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	222 immediately following the backslash or some undefined value. Do not rely
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	223 on the behaviour of undefined escape sequences.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	224 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	225 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	226 >importundefexport</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	227 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	228 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	229 >This pragma is only valid for targets that support external references. When
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	230 in force, it will cause the EXPORT directive to act as IMPORT if the symbol
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	231 to be exported is not defined. This is provided for compatibility with the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	232 output of gcc6809 and should not be used in hand written code. Because of
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	233 the confusion this pragma can cause, it is disabled by default.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	234 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	235 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	236 >undefextern</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	237 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	238 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	239 >This pragma is only valid for targets that support external references. When in
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	240 force, if the assembler sees an undefined symbol on the second pass, it will
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	241 automatically define it as an external symbol. This automatic definition will
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	242 apply for the remainder of the assembly process, even if the pragma is
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	243 subsequently turned off. Because this behaviour would be potentially surprising,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	244 this pragma defaults to off.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	245 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	246 >The primary use for this pragma is for projects that share a large number of
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	247 symbols between source files. In such cases, it is impractical to enumerate
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	248 all the external references in every source file. This allows the assembler
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	249 and linker to do the heavy lifting while not preventing a particular source
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	250 module from defining a local symbol of the same name as an external symbol
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	251 if it does not need the external symbol. (This pragma will not cause an
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	252 automatic external definition if there is already a locally defined symbol.)</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	253 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	254 >This pragma will often be specified on the command line for large projects.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	255 However, depending on the specific dynamics of the project, it may be sufficient
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	256 for one or two files to use this pragma internally.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	257 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	258 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	259 >export</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	260 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	261 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	262 >This pragma causes all symbols to be added to the export list
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	263 automatically. This is useful when a large number of symbols need to be
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	264 exported but you do not wish to include an EXPORT directive for all of them.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	265 This is often useful on the command line but might be useful even inline
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	266 with the PRAGMA directive if a large number of symbols in a row are to be
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	267 exported.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	268 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	269 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	270 >dollarlocal</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	271 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	272 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	273 >When set, a "$" in a symbol makes it local. When not set, "$" does not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	274 cause a symbol to be local. It is set by default except when using the OS9
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	275 target.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	276 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	277 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	278 >dollarnotlocal</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	279 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	280 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	281 > This is the same as the "dollarlocal" pragma except its sense is
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	282 reversed. That is, "dollarlocal" and "nodollarnotlocal" are equivalent and
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	283 "nodollarlocal" and "dollarnotlocal" are equivalent. </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	284 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	285 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	286 >pcaspcr</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	287 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	288 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	289 > Normally, LWASM makes a distinction between PC and PCR in program
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	290 counter relative addressing. In particular, the use of PC means an absolute
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	291 offset from PC while PCR causes the assembler to calculate the offset to the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	292 specified operand and use that as the offset from PC. By setting this
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	293 pragma, you can have PC treated the same as PCR. </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	294 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	295 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	296 >shadow</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	297 ><DD
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 >When this pragma is in effect, it becomes possible to define a macro
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	300 that matches an internal operation code. Thus, it makes it possible to
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	301 redefine either CPU instructions or pseudo operations. Because this feature
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	302 is of dubious utility, it is disabled by default.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	303 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	304 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	305 >nolist</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	306 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	307 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	308 >Lines where this pragma is in effect will not appear in the assembly
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	309 listing. Also, any symbols defined under this pragma will not show up in
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	310 the symbol list. This is most useful in include files to avoid spamming the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	311 assembly listing with dozens, hundreds, or thousands of irrelevant
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	312 symbols.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	313 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	314 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	315 >autobranchlength</DT
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 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	318 >One of the perennial annoyances for 6809 programmers is that the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	319 mneumonics for the short and long branch instructions are different (bxx vs.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	320 lbxx), which is at odds with the rest of the instruction set. This pragma
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	321 is a solution to those annoying byte overflow errors that short branch
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	322 instructions tend to aquire.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	323 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	324 >When this pragma is in effect, which is not the default, whenever any
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	325 relative branch instruction is used, its size will be automatically
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	326 determined based on the actual distance to the destination. In other words,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	327 one can write code with long or short branches everywhere and the assembler
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	328 will choose a size for the branch.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	329 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	330 >Also, while this pragma is in effect, the > and < symbols can be used
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	331 to force the branch size, analogous to their use for other instructions with
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	332 < forcing 8 bit offsets and > forcing 16 bit offets.</P
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 >Because this pragma leads to source that is incompatible with other
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	335 assemblers, it is strongly recommended that it be invoked using the PRAGMA
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	336 directive within the source code rather than on the command line or via the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	337 *PRAGMA directive. This way, an error will be raised if someone tries to
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	338 assemble the code under a different assembler.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	339 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	340 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	341 >nosymbolcase, symbolnocase</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	342 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	343 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	344 >Any symbol defined while this pragma is in force will be treated as
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	345 case insensitive, regardless whether the pragma is in force when the symbol
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	346 is referenced.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	347 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	348 >It is important to note that this pragma will not work as expected in
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	349 all cases when using the object file assembly target. It is intended for
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	350 use only when the assembler will be producing the final binary.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	351 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	352 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	353 >condundefzero</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	354 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	355 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	356 >This pragma will cause the assembler to change the way it handles
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	357 symbols in conditional expressions. Ordinarily, any symbol that is not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	358 defined prior to the conditional will throw an undefined symbol error. With
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	359 this pragma in effect, symbols that are not yet defined at the point the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	360 conditional is encountered will be treated as zero.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	361 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	362 >This is not the default because it encourages poor code design. One
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	363 should use the "IFDEF" or "IFNDEF" conditionals to test for the presence of
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	364 a symbol.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	365 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	366 >It is important to note that if a symbol is defined but it does not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	367 yet evaluate to a constant value at the point where the conditional appears,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	368 the assembler will still complain about a non constant condition.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	369 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	370 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	371 >forwardrefmax</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	372 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	373 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	374 >This pragma will disable forward reference optimization completely.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	375 Ordinarily, LWASM will attempt to select the shortest possible addressing
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	376 mode for forward references. However, in many source files, especially
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	377 those not using the PCR relative addressing modes, this optimization is
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	378 pointless since the assembler will almost certainly settle on a 16 bit
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	379 offset or address. If all variables in the direct page are defined before
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	380 the main body of the code, the benefit of forward reference optimization
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	381 almost certainly vanishes completely. However, the cost of doing that
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	382 optimization remains and can result in a very long assembly time.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	383 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	384 >Enabling this pragma will cause all forward references to use the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	385 maximum offset or address size, much the same has EDTASM and other pure
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	386 two pass assemblers do. The side effect is that all line lengths and
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	387 symbol values are fully resolved after the initial parsing pass and the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	388 amount of work to resolve everything becomes almost nil.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	389 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	390 >While this pragma can be applied selectively to sections of source
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	391 code (use *PRAGMA if doing so and compatibility with other assemblers
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	392 is desired), it is likely more useful when provided as a command line
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	393 pragma.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	394 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	395 >It should be noted that the presence or absence of this pragma
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	396 will not change the correctness of the generated code unless cycle counts
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	397 or byte counts are critical (which they usually are not). It also will
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	398 not override the operand size override prefixes (< and >). It only
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	399 applies when the assembler is left to guess what the operand size is.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	400 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	401 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	402 >operandsizewarning</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	403 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	404 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	405 >Enabling this pragma will cause LWASM to show a warning when it
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	406 detects that a smaller addressing mode could be used for an instruction.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	407 This is particularly useful for finding places where long branches are used
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	408 where short branches could be used instead. It will also show the warnings
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	409 for indexing offsets (regardless of whether the operand size is
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	410 forced).</P
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 >As of LWASM 4.16, no other checks are performed.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	413 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	414 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	415 >qrts</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	416 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	417 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	418 > Enables the use of the ?RTS branch target. ?RTS is implemented to maintain
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	419 compatibility with the MACRO-80c assembler. It works by searching backward
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	420 in the code for an RTS instruction. If none is found, it inverts the branch
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	421 logic and inserts an RTS following the branch instruction. Below you can
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	422 see how a BMI (2B xx) has been assembled as a BPL *+1 (2A 01) to skip over an
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	423 inserted RTS (39).</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	424 ><PRE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	425 CLASS="PROGRAMLISTING"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	426 >1D1E 7D1D1D TST WHICH1
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	427 1D21 2A0139 BMI ?RTS
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	428 1D24 BD1D65 JSR INV</PRE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	429 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	430 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	431 >m80ext</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	432 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	433 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	434 > This pragma (along with pragma qrts) enables some uncommon behaviors to
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	435 accomodate The Micro Works MACRO-80c assembler from 1982. This assembler
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	436 was used by a number of notable TRS-80 Color Computer applications and the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	437 goal of this pragma is to allow them to build identical binaries from
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	438 unmodified, vintage source code.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	439 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	440 > In m80ext mode, the handling of the "END" pseudo-op changes when used inside
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	441 an include file. Instead of terminating all assembly, it merely stops
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	442 processing of the current include file (this behavior matches the original
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	443 Motorola 6809 assembler). In addition, loading an ASCII value with a single
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	444 quote (e.g., LDA #'N) is extended to 16-bit registers (e.g., LDD #'NO).
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	445 LWASM normally supports this via double quote and that is the proper use in
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	446 modern code. Finally, the FCC pseudo-op is extended to handle FCB-like
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	447 behavior after the closing delimiter:</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	448 ><PRE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	449 CLASS="PROGRAMLISTING"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	450 > FCC "Greetings from 1982",13,0</PRE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	451 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	452 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	453 >testmode</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	454 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	455 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	456 > This pragma is intended for internal testing purposes. In testmode, the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	457 assembler searches for a specially-formatted comment starting with a
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	458 semicolon followed by a period. Immediately afterward are a list of hex
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	459 bytes that the assembler is expected to generate. Likewise, if the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	460 assembler is expected to throw an error or warning on a given line, you can
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	461 check by specifying "E:" followed by the error number. In this case the
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	462 error is ignored and the assembler continues ignoring the line in question. </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	463 ><PRE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	464 CLASS="PROGRAMLISTING"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	465 >1D1E 7D1D1D TST WHICH1 ;.7d1d1d
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	466 1D21 2A0139 BMI ?RTS ;.2a0139
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	467 1D24 1D24 FDB * ;.1d24
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	468 1D26 xyz INV ;.E:32 (Error 32 is "Bad opcode")</PRE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	469 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	470 ><DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	471 >emuext</DT
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	472 ><DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	473 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	474 > This pragma enables two instructions useful when running code in compatible
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	475 emulators. Break breaks into the debugger. Log writes printf-style
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	476 output to the debug window </P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	477 ><PRE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	478 CLASS="PROGRAMLISTING"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	479 > LOG ; log output
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	480 FDB FSTR ; pointer to format string
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	481 FDB PX1 ; 16 bit pointer to 16 bit value
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	482 FDB PY1 ; 16 bit pointer to 8 bit value (see format string!)
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	483 FDB PX2 ; 16 bit pointer to 16 bit value
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	484 FDB PY2 ; 16 bit pointer to 8 bit value
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	485 ; execution continues here ...
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	486 RTS
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	487
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	488 ; format string
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	489 FSTR FCC "%hu,%hhu - %hu,%hhu"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	490 FCB 10,0</PRE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	491 ></DD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	492 ></DL
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	493 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	494 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	495 >As a convenience, each input file has a pragma state stack. This
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	496 allows, through the use of PRAGMAPUSH and PRAGMAPOP, a file to change a
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	497 pragma state and then restore it to the precise state it had previously.
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	498 If, at the end of an input file, all pragma states have not been popped,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	499 they will be removed from the stack. Thus, it is critical to employ
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	500 *PRAGMAPOP correctly. Because each input file has its own pragma stack,
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	501 using PRAGMAPUSH in one file and PRAGMAPOP in another file will not
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	502 work.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	503 ><P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	504 >Pragma stacks are more useful in include files, in particular in
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	505 conjunction with the nolist pragma. One can push the state of the nolist
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	506 pragma, engage the nolist pragma, and then pop the state of the nolist
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	507 pragma at the end of the include file. This will cause the entire include
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	508 file to operate under the nolist pragma. However, if the file is included
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	509 while nolist is already engaged, it will not undo that state.</P
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	510 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	511 ><DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	512 CLASS="NAVFOOTER"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	513 ><HR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	514 ALIGN="LEFT"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	515 WIDTH="100%"><TABLE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	516 SUMMARY="Footer navigation table"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	517 WIDTH="100%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	518 BORDER="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	519 CELLPADDING="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	520 CELLSPACING="0"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	521 ><TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	522 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	523 WIDTH="33%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	524 ALIGN="left"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	525 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	526 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	527 HREF="x606.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	528 ACCESSKEY="P"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	529 >Prev</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	530 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	531 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	532 WIDTH="34%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	533 ALIGN="center"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	534 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	535 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	536 HREF="index.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	537 ACCESSKEY="H"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	538 >Home</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	539 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	540 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	541 WIDTH="33%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	542 ALIGN="right"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	543 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	544 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	545 HREF="x816.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	546 ACCESSKEY="N"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	547 >Next</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	548 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	549 ></TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	550 ><TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	551 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	552 WIDTH="33%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	553 ALIGN="left"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	554 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	555 >Object Files and Sections</TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	556 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	557 WIDTH="34%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	558 ALIGN="center"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	559 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	560 ><A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	561 HREF="c62.html"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	562 ACCESSKEY="U"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	563 >Up</A
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	564 ></TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	565 ><TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	566 WIDTH="33%"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	567 ALIGN="right"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	568 VALIGN="top"
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	569 >Convenience Instructions</TD
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	570 ></TR
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	571 ></TABLE
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	572 ></DIV
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	573 ></BODY
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	574 ></HTML
52af0aa54fe5 Update html and pdf documentation in preparation for release William Astle <lost@l-w.ca> parents: diff changeset	575 >

Mercurial > hg > index.cgi

annotate docs/manual/x670.html @ 508:10f62dc61a75