as: M68HC11-Directives

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