# 173@prset.hlp>settings ; 
message=S               \\ Any messages to emit when running \
                        \C ?* $<SPC=$VALUE>

# 174@prset.hlp>settings ; The files list the main output file from the command. If
# the command produces more than one output file, only list one
# of them below. Use multiple files only if you want the command
# run once to produce each file. Use a fake filename (one that is
# not produced) if you want this command to run every time (but
# see also pre-link and post-link).
files=LF                \\ Files to process with command (one per) \
                        \C ?* $<OBJ=$VALUE>

# 175@prset.hlp>settings ; Depends_on lists files that are used as inputs to building
# the output file(s). The date/time of these files will be
# compared against the output file to determine if it should
# be rebuilt (if any depends_on file is newer, it will be
# rebuilt).
depends_on=LF   \\ List of files that are dependents \
                        \C ?* $<SRC=$VALUE>

# 176@prset.hlp>settings ; Command is the host command (or commands) to run to produce
# the output file or behavior. You can use various macros "$(name)"
# in the command. The common macros are "$@" for the output file,
# "$?" is list of depends_on files that are newer. Commands
# that use shell commands (e.g. echo and for) should be preceded 
# by a "+" (plus sign). A preceding "@" (at sign) will prevent
# echoing of the command before running it. So, "@+echo foo"
# will just write "foo" on the output.
command=LS              \\ Command to run including all arguments \
                        \C ?* $<EXE=$VALUE>

# 177@prset.hlp>settings ; Use_as determines when and how the output files should be
# rebuilt. A link_dependent means that this output will be
# checked (against its depends_on files) for rebuild whenever
# you build. Link_input indicates that the output file is
# an input to the linker (and object file or equivalent).
# Named target means that the output file is only checked if
# some other file depends on it or it is named in a build.
# This latter case is used when the output file is a .h or
# .c/.asm file that is used as input for a COMPILE/ASSEMBLE
# group as well as when it is input to another CUSTOM group
# (so you can chain build custom files).
use_as=K(link_dependent,link_input,named_target,post_link)0 \
                           \\ Form of output of this command \
                           \K Will be checked for build each time, \
                              Will be used as input to linker (object), \
                              Is only a target in makefile, \
                              Will be built after link \
                           \C $<PRV=$VALUE>

# 46@prset.hlp>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

# 47@prset.hlp>settings ; Removes this group from the build.
disable=B0              \\ Removes this compile group from build \
                        \C (,$<DIS=1>)

# 53@prset.hlp>settings ; The Sources folder contains the files to compile for this group.
{.Sources               \\ List of source files
  # 54@prset.hlp>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>
}
# 48@prset.hlp>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">)

# 49@prset.hlp>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

# 50@prset.hlp>settings ; Extra-args is used to add special compiler switches not controlled
# below.
extra_args=S    \\ Any extra compiler arguments to use \
                        \C ?* $VALUE

# 51@prset.hlp>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

# 52@prset.hlp>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>

# 55@prset.hlp>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
  # 56@prset.hlp>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>

  # 57@prset.hlp>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 \
                        \C (,-fk)

  # 58@prset.hlp>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

  # 59@prset.hlp>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
}

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

  # 62@prset.hlp>settings ; When creating a listing file, list expanded source as seen by the 
  # compiler after preprocessing.
  source_expans=K(disabled,enabled)1 \\ List expanded source (see -list -fu) \
                        \C ([$"Listings.interlist",-fu],)

  # 63@prset.hlp>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 (see -list -fi, fj) \
                        \C (,[$"Listings.interlist",-fi], \
                             [$"Listings.interlist",-fj], \
                             [$"Listings.interlist",-fi -fj])

  # 64@prset.hlp>settings ; Optional file name for error output.
  error_file=F          \\ Error listing flename \
                        \C ?* -errors $VALUE
}

# 65@prset.hlp>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
  # 66@prset.hlp>settings ; Turn various warning messages on or off.
  # The default behavior may depend upon the source language (flavor of C used) 
  # that is specified to the compiler.
  {.Warning             \\ Control of warning messages ( -W and associated options)
    # 67@prset.hlp>settings ; Suppress all warnings. If one or more letters follow the option,
    # only warnings controlled by those letters are suppressed.
    suppress_warnings=K(disabled,enabled)0 \\ Suppress all warnings (see -W) \
                        \C (,-W)

    # 68@prset.hlp>settings ; Report warning "Use of = in a condition context".
    equal_sign_use=K(default,disabled,enabled)0 \\ Warn about use of equal-sign (see -Wa,-W+a) \
                        \K Use default value, \
                           Force disabled, \
                           Force enabled \
                        \C (,-Wa,-W+a)

    # 69@prset.hlp>settings ; Report warning "ANSI C forbids bit field type 抰ype