src/engine/SCons/Tool/as.xml

   1 <!--
   2 __COPYRIGHT__
   3
   4 This file is processed by the bin/SConsDoc.py module.
   5 See its __doc__ string for a discussion of the format.
   6 -->
   7 <tool name="as">
   8 <summary>
   9 Sets construction variables for the &as; assembler.
  10 </summary>
  11 <sets>
  12 AS
  13 ASFLAGS
  14 ASCOM
  15 ASPPFLAGS
  16 ASPPCOM
  17 </sets>
  18 <uses>
  19 CC
  20 CPPFLAGS
  21 _CPPDEFFLAGS
  22 _CPPINCFLAGS
  23 </uses>
  24 </tool>
  25
  26 <cvar name="AS">
  27 <summary>
  28 The assembler.
  29 </summary>
  30 </cvar>
  31
  32 <cvar name="ASCOM">
  33 <summary>
  34 The command line used to generate an object file
  35 from an assembly-language source file.
  36 </summary>
  37 </cvar>
  38
  39 <cvar name="ASCOMSTR">
  40 <summary>
  41 The string displayed when an object file
  42 is generated from an assembly-language source file.
  43 If this is not set, then &cv-link-ASCOM; (the command line) is displayed.
  44
  45 <example>
  46 env = Environment(ASCOMSTR = "Assembling $TARGET")
  47 </example>
  48 </summary>
  49 </cvar>
  50
  51 <cvar name="ASFLAGS">
  52 <summary>
  53 General options passed to the assembler.
  54 </summary>
  55 </cvar>
  56
  57 <cvar name="ASPPCOM">
  58 <summary>
  59 The command line used to assemble an assembly-language
  60 source file into an object file
  61 after first running the file through the C preprocessor.
  62 Any options specified
  63 in the &cv-link-ASFLAGS; and &cv-link-CPPFLAGS; construction variables
  64 are included on this command line.
  65 </summary>
  66 </cvar>
  67
  68 <cvar name="ASPPCOMSTR">
  69 <summary>
  70 The string displayed when an object file
  71 is generated from an assembly-language source file
  72 after first running the file through the C preprocessor.
  73 If this is not set, then &cv-link-ASPPCOM; (the command line) is displayed.
  74
  75 <example>
  76 env = Environment(ASPPCOMSTR = "Assembling $TARGET")
  77 </example>
  78 </summary>
  79 </cvar>
  80
  81 <cvar name="ASPPFLAGS">
  82 <summary>
  83 General options when an assembling an assembly-language
  84 source file into an object file
  85 after first running the file through the C preprocessor.
  86 The default is to use the value of &cv-link-ASFLAGS;.
  87 </summary>
  88 </cvar>