comparison doc/pseudo ops.txt @ 96:7fbccdd1defb

Added doc subdirectory to distribution
author lost
date Sat, 17 Jan 2009 07:09:02 +0000
parents
children
comparison
equal deleted inserted replaced
95:f3497072ac44 96:7fbccdd1defb
1 The following pseudo operations are understood by LWASM.
2
3 SECTION <name>
4
5 This introduces a section called <name>. This is only valid if assembling to
6 an object file. Only one section can be open at any given time. Sections
7 may be ended with ENDSECTION. Only one section can be open at any given
8 time. A subsequent SECTION directive will end the previous section. It is
9 important to note that an end of file does not close the currently open
10 section. There cannot be a symbol on a SECTION line.
11
12 ENDSECTION
13
14 Specifies the end of a section. This is optional. There cannot be a symbol
15 on an ENDSECTION line.
16
17 ORG <addr>
18
19 Specifies the assembly address. For the raw target, this is advisory and
20 only affects the addresses of symbols. For the object file target, this can
21 only appear outside of all sections. For the DECB target, each ORG statement
22 after which any output is generated will generate a segment in the output
23 file. <addr> must be completely resolved during pass 1 of the assembly
24 process and thus may not refer to forward references or external symbols, or
25 other symbols that refer to such.
26
27 <symbol> EQU <value>
28
29 Makes <symbol> equivalent to <value>. <value> may be an external reference
30 in which case any references to <symbol> will also be external references.
31
32 EXPORT <symbol>[ as <name>]
33
34 Marks previously defined <symbol> for export. If <name> is specified, it
35 will be exported as <name>. <symbol> must not be an external reference and
36 must be defined before EXPORT.
37
38 EXTERN <symbol>[ as <name>]
39 IMPORT <symbol>[ as <name>]
40
41 Marks <symbol> as an external reference. If <name> is specified, <name> is
42 the local name the symbol is references as in this assembly file while
43 <symbol> is the actual symbol to be referenced externally.
44
45 END [<addr>]
46
47 Marks the end of the assembly process. Immediately terminates assembly
48 without processing any other lines in this file or any others. It is
49 optional. <addr> is only allowed for the DECB target in which case it
50 specifies the execution address. If it is not specified, the address
51 defaults to 0.