spec.stp

realview22.rar

  # [e-mail]>settings ; Select how to handle floating-point processing.
  fp_processing=K(default,\
                  softvfp,\
                  softvfp+vfp,\
                  softvfp+vfpv2,\
                  vfp,\
                  vfpv2,\
                  none,\
                  softfpa,\
                  fpa,\
                  vfpv1)0 \\ Floating point processing, (see --fpu)\
                        \K Use default for the specified processor, \
                     Use software FP library with pure-endian doubles, \
                     Use software FP library with pure-endian doubles + VFP hardware - architecture vfpv1, \
                     Use software FP library with pure-endian doubles + VFP hardware - architecture vfpv2, \
                     Selects hardware vfp - architecture vfpv2, \
                     Selects hardware vfpv2 - architecture vfpv2, \
                     Selects no FP option, \
                     DEPRECATED Use software FP library with mixed-endian doubles, \
                     DEPRECATED Selects hardware FPA, \
                     DEPRECATED Selects hardware vfpv1 - architecture vfpv1, \
                        \C (, \
                             --fpu softvfp, \
                             --fpu softvfp+vfp, \
                             --fpu softvfp+vfpv2, \
                             --fpu vfp, \
                             --fpu vfpv2, \
                             --fpu none, \
                             --fpu softfpa,--fpu fpa, --fpu vfpv1)

  # [e-mail]>settings ; These options control a variety of compiler features, including features
  # that make some checks more rigorous than usual. These additional checks 
  # can be an aid to portability and good coding practice. 
  {.Checking            \\ Controls rule checking during compilation
    # [e-mail]>settings ; Select flavor of C used.
    source_language=K(default,C90,CPlusPlus,ANSI,EmbeddedCPlusPlus,Strict)0 \\ Selects the source language used, (see --c90, --cpp) \
                        \K based on file extension, \
                        C (C90 ISO), \
                        C++ (ISO/IEC),\
                        DEPRECATED - use C (C90 ISO), \
                        DEPRECATED - use C++ (ISO/IEC), \
                        DEPRECATED - use the Strict_iso setting \
                        \C (,--c90,--cpp,-ansi,-cpp,-strict)

    # [e-mail]>settings ; Select strict.
    strict_iso=K(default,relaxed,strict,strictwarnings)0 \\ Selects strict ISO conformance, (see --no_strict, --strict, --strict_warnings) \
                        \K use the default value, \
                        Relaxed ISO standard conformance, \
                        Strict ISO standard conformance as errors, \
                        Strict ISO standard conformance as warnings \
                        \C (,--no_strict,--strict, --strict_warnings)

    # [e-mail]>settings ; Check for data flow anomalies. This will indicate when an
    # automatic variable could have been used before it has been assigned
    # a value. The check is pessimistic and will sometimes report an
    # anomaly where none exists.
    data_flow=K(disabled,enabled)0 \\ Check for data flow anomalies, (DEPRECATED see -fa) \
                        \C (,)

    # [e-mail]>settings ; Check for unused declarations, including those from standard headers.
    unused_declar=K(disabled,enabled)0 \\ Check for unused declarations, (DEPRECATED see -fv) \
                        \C (,)

    # [e-mail]>settings ; Enable all warnings normally suppressed by default with the exception of the
    # -fa, -fh, -fp and -fv checking options.
    enable_suppressed=K(disabled,enabled)0 \\ Enable all warnings normally suppressed by default, (DEPRECATED see -fx) \
                        \C (,)
  }

  # [e-mail]>settings ; Controls ARM Procedure Call Standard qualifiers
  {.APCS                \\ ARM Procedure Call Standard qualifiers
    # [e-mail]>settings ; Control whether software stack-checking is available in the
    # compiled code.
    stack_checking=K(default,disabled,enabled)0 \\ Use software stack-checking, (see --apcs) \
                        \K Use default, \
                           Force disabled, \
                           Force enabled \
                        \C (,--apcs $/noswstackcheck,--apcs $/swstackcheck)

    # [e-mail]>settings ; Control whether code is suitable for ARM/Thumb Interworking
    interworking=K(default,disabled,enabled)0 \\ Control ARM/Thumb interworking, (see --apcs) \
                        \K Use default, \
                           Force disabled, \
                           Force enabled \
                        \C (,--apcs $/nointerwork,--apcs $/interwork)

    # [e-mail]>settings ; 
    ropi=K(default,disabled,enabled)0 \\ Generate read-only position independent code, (see --apcs) \
                        \K Use default, \
                           Force disabled, \
                           Force enabled \
                        \C (, \
                             --apcs $/noropi, \
                             [$"Compilation.compiler"<2, --apcs $/ropi])

    # [e-mail]>settings ; 
    rwpi=K(default,disabled,enabled)0 \\ Generate read/write position independent code, (see --apcs) \
                        \K Use default, \
                           Force disabled, \
                           Force enabled \
                        \C (,--apcs $/norwpi,--apcs $/rwpi)
  }

  # [e-mail]>settings ; Alignment options
  {.Alignment           \\ Set alignment options \

    # [e-mail]>settings ; Specifies unaligned pointer support required.
    pointer_align=K(default,1,2,4,8)0 \\ Specifies unaligned pointer support required, (see --pointer_alignment) \
                        \C (, \
                             --pointer_alignment=1, \
                             --pointer_alignment=2, \
                             --pointer_alignment=4, \
                             --pointer_alignment=8)

    # [e-mail]>settings ; Specifies the minimal byte alignment for structs.
    struct_align=K(1,2,4,8)0 \\ Minimal byte alignment for structs, (DEPRECATED see -zas) \
                        \C (,,,)

  }

  # [e-mail]>settings ;
  {.Language        \\ Set Language options \

    # [e-mail]>settings ;
    dollar_signs=K(disabled,enabled)0     \\ Accept dollar signs in identifiers  \
            \C (,--dollar)

    # [e-mail]>settings ;
    alt_tokens=K(disabled,enabled)0       \\ Enable or disable recognition of alternative tokens  \
            \C (,--alternative_tokens)

    # [e-mail]>settings ;
    loose_implicit_cast=K(disabled,enabled)0       \\ Allow illegal implicit casts (see --loose_implicit_cast) \
            \C (,--loose_implicit_cast)

    # [e-mail]>settings ;
    multibyte_chars=K(disabled,enabled)0  \\ Enable or disable processing for multibyte character sequences \
            \C (,--multibyte_chars)

    # [e-mail]>settings ;
    multibyte_locale=S                    \\ Used with multibyte chars to set the locale \
            \C ?* --locale $VALUE

    # [e-mail]>settings ;
    gnu_mode=K(disabled,enabled)0  \\ Enable or disable GNU compilation mode (see --gnu) \
            \C (,--gnu)

    # [e-mail]>settings ;
    {.CPP           \\ Set C++ options \

      # [e-mail]>settings ;
      exceptions=K(default,disabled,enabled)0   \\ Enable or disable exception processing (see --exceptions, --no_exceptions) \
                \C (,--no_exceptions,--exceptions)

      # [e-mail]>settings ; 
      exceptions_unwind=K(default,disabled,enabled)0   \\ Enable or disable exception unwinding (see --exceptions_unwind, --no_exceptions_unwind) \
                \C (,\
                    [$"Compilation.Language.CPP.exceptions"==2, --no_exceptions_unwind], \
                    [$"Compilation.Language.CPP.exceptions"==2, --exceptions_unwind])

      # [e-mail]>settings ;
      force_new_nothrow=K(disabled,enabled)0   \\ Enable or disable force_new_nothrow on heap allocation exceptions (see --force_new_nothrow) \
                \C (,--force_new_nothrow)

      # [e-mail]>settings ;
      dll_vtbl=K(disabled,enabled)0   \\ dllexport a class definition \
                \C (,--dll_vtbl)

      # [e-mail]>settings ;
      implicit_include=K(disabled,enabled)0   \\ Control inclusion of source files as a way of finding template definitions \
                \C (,--implicit_include)

      # [e-mail]>settings ;
      pending_inst=S   \\ Specify the maximum instantiations of a given template \
                \C ?* --pending_instantiations=$VALUE

      # [e-mail]>settings ;
      qualifier_deduction=K(disabled,enabled)0   \\ Does non-standard template argument deduction occur on a qualified name \
                \C (,--nonstd_qualifier_deduction)

      # [e-mail]>settings ;
      rtti_support=K(disabled,enabled)0   \\ Enable or disable support for RunTime Type Information \
                \C (,--rtti)

      # [e-mail]>settings ;
      using_std=K(disabled,enabled)0   \\ Control implicit use of the std namespace \
                \C (,--using_std)

      # [e-mail]>settings ;
      old_special=K(disabled,enabled)0   \\ Enable or disable acceptance of old-style template specializations \
                \C (,--old_specializations)

      # [e-mail]>settings ;
      guiding_decls=K(disabled,enabled)0   \\ Enable recognition of "guiding declarations" of template functions \
                \C (,--guiding_decls)

      # [e-mail]>settings ;
      parse_templates=K(default,disabled,enabled)0   \\ Control the parsing of nonclass templates in their generic form \
                \C (, \
                     --no_parse_templates, \
                     --parse_templates)

      # [e-mail]>settings ;
      dep_name=K(default,disabled,enabled)0   \\ Control the separate lookup of names in templates at parse time and instantiation \
                \C (, \
                    --no_dep_name, \
                    [$"Compilation.Language.CPP.parse_templates"!=1, --dep_name])


      # [e-mail]>settings ;
      friend_injection=K(disabled,enabled)0   \\ Whether the name of a class/function declared in friend declarations is visible \
                \C (,--friend_injection)

    }

  }

}

# [e-mail]>settings ; Optimizations control how aggressively the compiler tries to improve
# the output machine code. Some optimizations will control what it can
# safely assume about the source code and some will control what kinds
# of optimizations it can use. Note that optimizations can make debugging
# much more difficult.
{.Optimization  \\ Control of optimizations
  # [e-mail]>settings ; Control how code is generated with respect to footprint and speed
  # of execution.
  speed_vs_space=K(default,speed,space)0 \\ Footprint and speed, (see -Otime, -Ospace) \
                        \K default - reduce image size,\
                           Reduce execution time (at expense of image size), \
                           Reduce image size (at expense of execution time) \
                        \C (,-Otime,-Ospace)

  # [e-mail]>settings ; Set level of optimization allowed when generating debug information
  debug_optimize=K(none,minimal,partial,full,maximum)0 \\ Debug optimizations, (see -O0, -O1, -O2, -O3) \
                        \K Default, \
                           Minimal (-O0), \
                           Restricted-Debug (-O1), \
                           Intermediate (-O2), \
                           Maximum (-O3) \
                        \C (,-O0,-O1,-O2,-O3)
                        
  # [e-mail]>settings ; Linker feedback to compiler for unused function elimination