Ratings of Options | |
Man Page |
The C++support Confusion Reduction Board assigns a rating to each command line option to help consumers select options appropriate for scripts, Makefiles, and cross-platform use. The rating system is based upon the motion picture rating system in the United States. Here are the approximate criteria for the ratings:
KCC is a highly portable C++ implementation which uses many different vendors' C compilers, linkers and other tools. Some applications benefit from specialized and non-portable features of these tools. So KAI C++ includes options that directly control its lower level components. Using these increases your risk of unintentionally interfering with the KCC implementation, or of accidentally activating a different feature when your script moves to some other (or later) KAI C++ port.
G Basic options that are fully portable. PG Options that provide more flexibility and do not introduce much risk. Check for platform-specificity. R These options provide even more flexibility, but introduce significant risk. X Unsupported option; Use only as directed by KAI's c++support staff.
When you write KCC command lines into makefiles or scripts, the Confusion Reduction Board recommends using the --uncomfortably_long form of any option that does not have a "G" rating. Most vendors' toolkits evolve and add new command line syntax with each release. KCC reserves the -s ingle letter and -abbrev iated option syntax for immediate access to important platform-specific options, even if it collides with prior KCC versions.