as: Org

1 
1 7.65 '.org NEW-LC , FILL'
1 =========================
1 
1 Advance the location counter of the current section to NEW-LC.  NEW-LC
1 is either an absolute expression or an expression with the same section
1 as the current subsection.  That is, you can't use '.org' to cross
1 sections: if NEW-LC has the wrong section, the '.org' directive is
1 ignored.  To be compatible with former assemblers, if the section of
1 NEW-LC is absolute, 'as' issues a warning, then pretends the section of
1 NEW-LC is the same as the current subsection.
1 
1    '.org' may only increase the location counter, or leave it unchanged;
1 you cannot use '.org' to move the location counter backwards.
1 
1    Because 'as' tries to assemble programs in one pass, NEW-LC may not
1 be undefined.  If you really detest this restriction we eagerly await a
1 chance to share your improved assembler.
1 
1    Beware that the origin is relative to the start of the section, not
1 to the start of the subsection.  This is compatible with other people's
1 assemblers.
1 
1    When the location counter (of the current subsection) is advanced,
1 the intervening bytes are filled with FILL which should be an absolute
1 expression.  If the comma and FILL are omitted, FILL defaults to zero.
1