The C++SUPPORT Seal of Approval 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:

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.
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.

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. 


Copyright © 1998-1999. All rights reserved.

E-Mail KAI Technical Support   E-Mail KAI   Contact KAI   

This file last updated on 12 January 1999.