spec.stp

realview22.rar

                              Will be used as input to linker (object), \
                              Is only a target in makefile, \
                              Will be built after link \
                           \C $<PRV=$VALUE>

# [e-mail]>settings ; The COMPILE group contains the C and C++ sources to be compiled in the
# project. The default build (COMPILE=default) contains the normal build
# rules for all sources. If some sources need to be compiled differently,
# a new COMPILE group can be created that contains these alternate
# rules.
[TEMPLATE=COMPILE] \\ Defines compilation rules \
                        \C -c $$SRC $$FLG -o $$OBJ

# [e-mail]>settings ; Removes this group from the build.
disable=B0              \\ Removes this compile group from build \
                        \C (,$<DIS=1>)

# [e-mail]>settings ; The Sources folder contains the files to compile for this group.
{.Sources               \\ List of source files
  # [e-mail]>settings ; The file list contains the list of sources to compile with for this
  # compile group. These should only be C and C++ sources.
  files=LF(Sources [*.c;*.cpp],$CWD) \\ Source files to compile \
                           \C{*} ? $<SRC=$VALUE>
}
# [e-mail]>settings ; The obj-location field contains information on where the object files
# should be placed relative to the sources. The default is to put the
# objects in the base directory of the project. An alternate is to put
# them in a subdirectory of the base. Another alternate is to put them
# in the same location as the sources or a sub-directory of the sources.
# If a sub-directory is chosen, the obj_sub name is used; if not given,
# "objects" is used. The source directory choice will use the same
# directory as each source or a sub-directory of that source if obj_sub
# is filled in. The sub-directories will be automatically created.
obj_location=K(local,sub_dir,same_as_source)0 \\ Where to put object files \
                        \K In project base directory,\
                           In obj_sub directory from base,\
                           In source directory \
                        \C (,$<OBJ=[$"obj_sub",$"obj_sub",objects]>\
                             ,$<OBJ=$$SPA/$"obj_sub">)

# [e-mail]>settings ; If the obj-location is selected as sub_dir, this specifies the name
# of the sub-directory.
obj_sub=D               \\ Sub-directory name for output (if not local) \
                        \C

# [e-mail]>settings ; Extra-args is used to add special compiler switches not controlled
# below.
extra_args=S    \\ Any extra compiler arguments to use \
                        \C ?* $VALUE

# [e-mail]>settings ; Extra arguments can be included in a file which is used as input
# to the command-line
file_args=F             \\ File containing additional arguments \
                        \C ?* --via $VALUE

# [e-mail]>settings ; The tool directory specified in the project or tool location file
# will be used to find the compiler. The name of the compiler is
# given in the tool location file. If you want to use a different
# location or name, you can set tool_path here.
tool_path=F(EXE)        \\ Pathname of compiler if different than tools \
                        \C ? $<EXE=$VALUE>

# [e-mail]>settings ; Preprocessor switches control the operation of the compiler when
# processing "#if" and "#include" directives. These can be used to control
# exactly how the source is compiled and where headers come from.
{.Preprocessor  \\ Preprocessor switches
  # [e-mail]>settings ; The include list contains the directories to search for include files
  # when compiling. The default is "." for quoted includes and the tool
  # path for <> includes.
  include=LD    \\ Include paths to search \
                        \C ?* -I$VALUE $<PRV=-I$VALUE>

  # [e-mail]>settings ;
  system_include=LD     \\ Include paths to search, ignore the built-in headers \
                        \C ?* -J$VALUE $<PRV=-J$VALUE>

  # [e-mail]>settings ;
  preprocess_only=B0     \\ Request preprocessing only \
            \C (,-E)

  # [e-mail]>settings ;
  keep_comments=B0       \\ Keep comments in pre-processed output (use with -E) \
            \C (,-C)

  # [e-mail]>settings ; The include rules specify whether to use Berkeley or Kernighan &
  # Ritchie search rules to locate included files.
  include_rules=K(Berkeley,Kernighan_and_Ritchie)0 \\ Search rules to use for includes (see --kandr_include) \
                        \C (,--kandr_include)

  # [e-mail]>settings ;
  include_paths=K(Standard,Same)0  \\ Setting to the Same treats both types of include identically (see --sys_include)\
            \C (,--sys_include)

  # [e-mail]>settings ; Defines symbol as a preprocessor macro, as if the following were at
  # the head of the source file:  #define symbol
  define=LS             \\ Define macro name as name or name=value \
                        \C ?* -D$VALUE

  # [e-mail]>settings ; Undefines symbol, as if the following were at the head of the source
  # file:  #undef symbol
  undefine=LS   \\ UnDefine macro names \
                        \C ?* -U$VALUE

  # [e-mail]>settings ;
  preinclude=S    \\ Include the source code of the indicated file at the beginning of the compilation \
            \C ?* --preinclude $VALUE

  # [e-mail]>settings ;
  {.Precompiled Headers    \\ Set precompiled header switches

    # [e-mail]>settings ;
    pch=K(disabled,enabled)0   \\ Automatically use and/or create a precompiled header file \
              \C (,--pch)

    # [e-mail]>settings ;
    create_pch=S    \\ Create a precompiled header file with the specified name \
              \C ?* --create_pch $VALUE

    # [e-mail]>settings ;
    use_pch=S    \\ Use a precompiled header file with the specified name \
              \C ?* --use_pch $VALUE

    # [e-mail]>settings ;
    pch_dir=S    \\ The directory in which to search and/or create a precompiled header file \
              \C ?* --pch_dir $VALUE

    # [e-mail]>settings ;
    pch_messages=K(disabled,enabled)0   \\ Control the display of a message indicating the use of a precompile header \
              \C (,--pch_messages)

    # [e-mail]>settings ;
    pch_verbose=K(disabled,enabled)0   \\ Display a message for each precompiled header file that could not be used \
              \C (,--pch_verbose)
  }

}

# [e-mail]>settings ; The listing switches control what kinds of output listings are created
# by the compiler or assembler.
{.Listings              \\ Listing controls
  # [e-mail]>settings ; Create a listing file. It will contain source interleaved with warning & 
  # error messages.
  interlist=K(disabled,enabled)0 \\ Create a listing file (DEPRECATED see --list)\
                        \C (,)

  # [e-mail]>settings ;
  listing=K(disabled,enabled)0   \\ Request listing output (see --list)\
            \C (,--list)

  # [e-mail]>settings ; When creating a listing file, list expanded source as seen by the 
  # compiler after preprocessing.
  source_expans=K(disabled,enabled)0 \\ List expanded source (DEPRECATED see --list -fu) \
                        \C (,)

  # [e-mail]>settings ; When creating a listing file, list the lines from include files.
  list_includes=K(none,local,global,local_and_global)0 \\ List include files (DEPRECATED see --list -fi, fj) \
                        \C (,,,)

  # [e-mail]>settings ; Optional file name for error output.
  error_file=F          \\ Error listing filename \
                        \C ?* --errors $VALUE
}

# [e-mail]>settings ; Error and Warning messages can be set for different levels of 
# information to be shown during compilation.
# The default behavior may depend upon the source language (flavor of C used)
# that is specified to the compiler.
{.Messages              \\ Control of errors/warnings and error-detection
  # [e-mail]>settings ;
  suppress_all=K(disabled,enabled)0 \\ Suppress all diagnostics \
            \C (,-W)

  # [e-mail]>settings ;
  suppress=S         \\ Suppress all diagnostic with the specified tags (comma-separated list)  \
            \C ?* --diag_suppress $VALUE

  # [e-mail]>settings ;
  remark=S           \\ Set diagnostic with the specified tags (comma-separated list) to a remark severity \
            \C ?* --diag_remark $VALUE

  # [e-mail]>settings ;
  warning=S          \\ Set diagnostic with the specified tags (comma-separated list) to a warning severity \
            \C ?* --diag_warning $VALUE

  # [e-mail]>settings ;
  error=S            \\ Set diagnostic with the specified tags (comma-separated list) to an error severity \
            \C ?* --diag_error $VALUE

  # [e-mail]>settings ;
  brief=K(disabled,enabled)0         \\ Enable or disable a mode in which a shorter form of diagnostic output is used \
            \C (,--brief_diagnostics)

  # [e-mail]>settings ;
  wrap=K(disabled,enabled)0          \\ Enable or disable a mode in which lengthy diagnostic output is wrapped \
            \C (,--wrap_diagnostics)
}

# [e-mail]>settings ; Compilation settings allow control of various compiler actions. Most of
# these will not need to be changed for normal development.
{.Compilation   \\ Control of compilation
  # [e-mail]>settings ; Select which compiler to use.
  compiler=K(ARM_C,Thumb_C,ARM_Cpp,Thumb_Cpp)0 \\ Select which compiler to use \
                        \C ($<SPC=0>,$<SPC=1> --thumb,$<SPC=2>,$<SPC=3> --thumb)

  # [e-mail]>settings ;
  checkonly=B0              \\ If set to true then only syntax checking occurs and no code is generated \
            \C (,--no_code_gen)

  # [e-mail]>settings ; Set endianness (byte sex) assumption for processor.
  endianness=K(default,big,little)0 \\ Select endianness, (see --bigend, --littleend) \
                        \C (,--bigend,--littleend)

  # [e-mail]>settings ; Produce information for debugging.
  generate_debug=K(default,disabled,enabled)0 \\ Generate debug information, (see -g, --no_debug) \
                        \C (,--no_debug,-g)

  # [e-mail]>settings ;
  supress_macro=K(default,disabled,enabled)0   \\ Suppress the inclusion of macros in debug data, (see --debug_macros, --no_debug_macros)  \
            \K Default, \
               Debug macros, \
               No debug macros \
            \C (,--debug_macro,--no_debug_macro)

  # [e-mail]>settings ; Format for debug information tables.
  debug_format=K(dwarf2)0 \\ Debug information table format, (see --dwarf2) \
                        \K Dwarf2 debug format \
                        \C (--dwarf2)

  # [e-mail]>settings ; Generate one ELF section per function.
  ELF_section_per_fn=K(disabled,enabled)0 \\ One ELF section per function, (see --split_sections) \
                        \C (,--split_sections)

  # [e-mail]>settings ; Determine how chars to be treated.
  # The default behavior may depend upon the source language (flavor of C used)
  # that is specified to the compiler.
  char=K(default,signed,unsigned)0 \\ Char handling, (see --signed_chars, --unsigned_chars) \
                        \K Use default value, \
                           Force signed, \
                           Force unsigned \
                        \C (,--signed_chars,--unsigned_chars)

  # [e-mail]>settings ; Treat enumerations as signed integers.
  enums_as_ints=K(disabled,enabled)0 \\ Treat enumerations as signed ints, (see --enum_is_int) \
                        \C (,--enum_is_int)