← Back to branch summary

~clint-fewbar/ubuntu/precise/erlang/merge-15b

« back to all changes in this revision

Viewing changes to lib/compiler/doc/src/compile.xml

  • Committer: Package Import Robot
  • Author(s): Sergei Golovan
  • Date: 2011-12-15 19:20:10 UTC
  • mfrom: (1.1.18) (3.5.15 sid)
  • mto: (3.5.16 sid)
  • mto: This revision was merged to the branch mainline in revision 33.
  • Revision ID: package-import@ubuntu.com-20111215192010-jnxcfe3tbrpp0big
Tags: 1:15.b-dfsg-1
* New upstream release.
* Upload to experimental because this release breaks external drivers
  API along with ABI, so several applications are to be fixed.
* Removed SSL patch because the old SSL implementation is removed from
  the upstream distribution.
* Removed never used patch which added native code to erlang beam files.
* Removed the erlang-docbuilder binary package because the docbuilder
  application was dropped by upstream.
* Documented dropping ${erlang-docbuilder:Depends} substvar in
  erlang-depends(1) manpage.
* Made erlang-base and erlang-base-hipe provide virtual package
  erlang-abi-15.b (the number means the first erlang version, which
  provides current ABI).

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/compiler/doc/src/compile.xml
4
4
<erlref>
5
5
  <header>
6
6
    <copyright>
7
 
      <year>1996</year><year>2010</year>
 
7
      <year>1996</year><year>2011</year>
8
8
      <holder>Ericsson AB. All Rights Reserved.</holder>
9
9
    </copyright>
10
10
    <legalnotice>
68
68
          to be an error if the module name in the source code is
69
69
          not the same as the basename of the output file.</p>
70
70
 
71
 
        <p>Here follows first all elements of <c>Options</c> that in
 
71
        <p><marker id="type-option"/>Here follows first all elements of <c>Options</c> that in
72
72
          some way control the behavior of the compiler.</p>
73
73
        <taglist>
74
74
          <tag><c>basic_validation</c></tag>
164
164
              for details.</p>
165
165
          </item>
166
166
 
 
167
          <tag><c>makedep</c></tag>
 
168
          <item>
 
169
            <p>Produce a Makefile rule to track headers dependencies.
 
170
              No object file is produced.
 
171
            </p>
 
172
            <p>By default, this rule is written to
 
173
              <c><![CDATA[<File>.Pbeam]]></c>. However, if the option
 
174
                <c>binary</c> is set, nothing is written and the rule is
 
175
                returned in <c>Binary</c>.
 
176
            </p>
 
177
            <p>For instance, if one has the following module:
 
178
            </p>
 
179
            <code>
 
180
-module(module).
 
181
 
 
182
-include_lib("eunit/include/eunit.hrl").
 
183
-include("header.hrl").
 
184
            </code>
 
185
            <p>Here is the Makefile rule generated by this option:
 
186
            </p>
 
187
            <code>
 
188
module.beam: module.erl \
 
189
  /usr/local/lib/erlang/lib/eunit/include/eunit.hrl \
 
190
  header.hrl
 
191
            </code>
 
192
          </item>
 
193
 
 
194
          <tag><c>{makedep_output, Output}</c></tag>
 
195
          <item>
 
196
            <p>Write generated rule(s) to <c>Output</c> instead of the
 
197
              default <c><![CDATA[<File>.Pbeam]]></c>. <c>Output</c>
 
198
              can be a filename or an <c>io_device()</c>. To write to
 
199
              stdout, use <c>standard_io</c>. However if <c>binary</c>
 
200
              is set, nothing is written to <c>Output</c> and the
 
201
              result is returned to the caller with
 
202
              <c>{ok, ModuleName, Binary}</c>.
 
203
            </p>
 
204
          </item>
 
205
 
 
206
          <tag><c>{makedep_target, Target}</c></tag>
 
207
          <item>
 
208
            <p>Change the name of the rule emitted to <c>Target</c>.
 
209
            </p>
 
210
          </item>
 
211
 
 
212
          <tag><c>makedep_quote_target</c></tag>
 
213
          <item>
 
214
            <p>Characters in <c>Target</c> special to make(1) are quoted.
 
215
            </p>
 
216
          </item>
 
217
 
 
218
          <tag><c>makedep_add_missing</c></tag>
 
219
          <item>
 
220
            <p>Consider missing headers as generated files and add them to the
 
221
              dependencies.
 
222
            </p>
 
223
          </item>
 
224
 
 
225
          <tag><c>makedep_phony</c></tag>
 
226
          <item>
 
227
            <p>Add a phony target for each dependency.
 
228
            </p>
 
229
          </item>
 
230
 
167
231
          <tag><c>'P'</c></tag>
168
232
          <item>
169
233
            <p>Produces a listing of the parsed code after preprocessing
331
395
          <code>-compile({no_auto_import,[error/1]}).</code>
332
396
          </item>
333
397
 
 
398
          <tag><c>no_line_info</c></tag>
 
399
 
 
400
          <item>
 
401
            <p>Omit line number information in order to produce a slightly
 
402
              smaller output file.
 
403
            </p>
 
404
          </item>
 
405
 
334
406
        </taglist>
335
407
 
336
408
        <p>If warnings are turned on (the <c>report_warnings</c> option