Comments.html 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- This file documents the GNU Assembler "as".
  4. Copyright (C) 1991-2017 Free Software Foundation, Inc.
  5. Permission is granted to copy, distribute and/or modify this document
  6. under the terms of the GNU Free Documentation License, Version 1.3
  7. or any later version published by the Free Software Foundation;
  8. with no Invariant Sections, with no Front-Cover Texts, and with no
  9. Back-Cover Texts. A copy of the license is included in the
  10. section entitled "GNU Free Documentation License".
  11. -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: Comments</title>
  15. <meta name="description" content="Using as: Comments">
  16. <meta name="keywords" content="Using as: Comments">
  17. <meta name="resource-type" content="document">
  18. <meta name="distribution" content="global">
  19. <meta name="Generator" content="makeinfo">
  20. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  21. <link href="index.html#Top" rel="start" title="Top">
  22. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="Syntax.html#Syntax" rel="up" title="Syntax">
  25. <link href="Symbol-Intro.html#Symbol-Intro" rel="next" title="Symbol Intro">
  26. <link href="Whitespace.html#Whitespace" rel="prev" title="Whitespace">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.smallquotation {font-size: smaller}
  31. div.display {margin-left: 3.2em}
  32. div.example {margin-left: 3.2em}
  33. div.indentedblock {margin-left: 3.2em}
  34. div.lisp {margin-left: 3.2em}
  35. div.smalldisplay {margin-left: 3.2em}
  36. div.smallexample {margin-left: 3.2em}
  37. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  38. div.smalllisp {margin-left: 3.2em}
  39. kbd {font-style:oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. pre.smalldisplay {font-family: inherit; font-size: smaller}
  45. pre.smallexample {font-size: smaller}
  46. pre.smallformat {font-family: inherit; font-size: smaller}
  47. pre.smalllisp {font-size: smaller}
  48. span.nocodebreak {white-space:nowrap}
  49. span.nolinebreak {white-space:nowrap}
  50. span.roman {font-family:serif; font-weight:normal}
  51. span.sansserif {font-family:sans-serif; font-weight:normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  57. <a name="Comments"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="Symbol-Intro.html#Symbol-Intro" accesskey="n" rel="next">Symbol Intro</a>, Previous: <a href="Whitespace.html#Whitespace" accesskey="p" rel="prev">Whitespace</a>, Up: <a href="Syntax.html#Syntax" accesskey="u" rel="up">Syntax</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  61. </div>
  62. <hr>
  63. <a name="Comments-1"></a>
  64. <h3 class="section">3.3 Comments</h3>
  65. <a name="index-comments"></a>
  66. <p>There are two ways of rendering comments to <code>as</code>. In both
  67. cases the comment is equivalent to one space.
  68. </p>
  69. <p>Anything from &lsquo;<samp>/*</samp>&rsquo; through the next &lsquo;<samp>*/</samp>&rsquo; is a comment.
  70. This means you may not nest these comments.
  71. </p>
  72. <div class="smallexample">
  73. <pre class="smallexample">/*
  74. The only way to include a newline ('\n') in a comment
  75. is to use this sort of comment.
  76. */
  77. /* This sort of comment does not nest. */
  78. </pre></div>
  79. <a name="index-line-comment-character"></a>
  80. <p>Anything from a <em>line comment</em> character up to the next newline is
  81. considered a comment and is ignored. The line comment character is target
  82. specific, and some targets multiple comment characters. Some targets also have
  83. line comment characters that only work if they are the first character on a
  84. line. Some targets use a sequence of two characters to introduce a line
  85. comment. Some targets can also change their line comment characters depending
  86. upon command line options that have been used. For more details see the
  87. <em>Syntax</em> section in the documentation for individual targets.
  88. </p>
  89. <p>If the line comment character is the hash sign (&lsquo;<samp>#</samp>&rsquo;) then it still has the
  90. special ability to enable and disable preprocessing (see <a href="Preprocessing.html#Preprocessing">Preprocessing</a>) and
  91. to specify logical line numbers:
  92. </p>
  93. <a name="index-_0023"></a>
  94. <a name="index-lines-starting-with-_0023"></a>
  95. <a name="index-logical-line-numbers"></a>
  96. <p>To be compatible with past assemblers, lines that begin with &lsquo;<samp>#</samp>&rsquo; have a
  97. special interpretation. Following the &lsquo;<samp>#</samp>&rsquo; should be an absolute
  98. expression (see <a href="Expressions.html#Expressions">Expressions</a>): the logical line number of the <em>next</em>
  99. line. Then a string (see <a href="Strings.html#Strings">Strings</a>) is allowed: if present it is a
  100. new logical file name. The rest of the line, if any, should be whitespace.
  101. </p>
  102. <p>If the first non-whitespace characters on the line are not numeric,
  103. the line is ignored. (Just like a comment.)
  104. </p>
  105. <div class="smallexample">
  106. <pre class="smallexample"> # This is an ordinary comment.
  107. # 42-6 &quot;new_file_name&quot; # New logical file name
  108. # This is logical line # 36.
  109. </pre></div>
  110. <p>This feature is deprecated, and may disappear from future versions
  111. of <code>as</code>.
  112. </p>
  113. <hr>
  114. <div class="header">
  115. <p>
  116. Next: <a href="Symbol-Intro.html#Symbol-Intro" accesskey="n" rel="next">Symbol Intro</a>, Previous: <a href="Whitespace.html#Whitespace" accesskey="p" rel="prev">Whitespace</a>, Up: <a href="Syntax.html#Syntax" accesskey="u" rel="up">Syntax</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  117. </div>
  118. </body>
  119. </html>