as: M68HC11-Directives

1 
1 9.24.4 Assembler Directives
1 ---------------------------
1 
1 The 68HC11 and 68HC12 version of 'as' have the following specific
1 assembler directives:
1 
1 '.relax'
1      The relax directive is used by the 'GNU Compiler' to emit a
1      specific relocation to mark a group of instructions for linker
1      relaxation.  The sequence of instructions within the group must be
1      known to the linker so that relaxation can be performed.
1 
1 '.mode [mshort|mlong|mshort-double|mlong-double]'
1      This directive specifies the ABI. It overrides the '-mshort',
1      '-mlong', '-mshort-double' and '-mlong-double' options.
1 
1 '.far SYMBOL'
1      This directive marks the symbol as a 'far' symbol meaning that it
1      uses a 'call/rtc' calling convention as opposed to 'jsr/rts'.
1      During a final link, the linker will identify references to the
1      'far' symbol and will verify the proper calling convention.
1 
1 '.interrupt SYMBOL'
1      This directive marks the symbol as an interrupt entry point.  This
1      information is then used by the debugger to correctly unwind the
1      frame across interrupts.
1 
1 '.xrefb SYMBOL'
1      This directive is defined for compatibility with the 'Specification
1      for Motorola 8 and 16-Bit Assembly Language Input Standard' and is
1      ignored.
1