as: Comments
1
1 3.3 Comments
1 ============
1
1 There are two ways of rendering comments to 'as'. In both cases the
1 comment is equivalent to one space.
1
1 Anything from '/*' through the next '*/' is a comment. This means
1 you may not nest these comments.
1
1 /*
1 The only way to include a newline ('\n') in a comment
1 is to use this sort of comment.
1 */
1
1 /* This sort of comment does not nest. */
1
1 Anything from a "line comment" character up to the next newline is
1 considered a comment and is ignored. The line comment character is
1 target specific, and some targets multiple comment characters. Some
1 targets also have line comment characters that only work if they are the
1 first character on a line. Some targets use a sequence of two
1 characters to introduce a line comment. Some targets can also change
1 their line comment characters depending upon command line options that
1 have been used. For more details see the _Syntax_ section in the
1 documentation for individual targets.
1
1 If the line comment character is the hash sign ('#') then it still
1 Preprocessing::) and to specify logical line numbers:
1
1 To be compatible with past assemblers, lines that begin with '#' have
1 a special interpretation. Following the '#' should be an absolute
1 expression (⇒Expressions): the logical line number of the _next_
1 line. Then a string (⇒Strings Strings.) is allowed: if present it
1 is a new logical file name. The rest of the line, if any, should be
1 whitespace.
1
1 If the first non-whitespace characters on the line are not numeric,
1 the line is ignored. (Just like a comment.)
1
1 # This is an ordinary comment.
1 # 42-6 "new_file_name" # New logical file name
1 # This is logical line # 36.
1 This feature is deprecated, and may disappear from future versions of
1 'as'.
1