08-09-1996

                      SunSoft C: C Compiler README
=============================================================================

Introduction:
------------

Usage Tracking

Usage tracking provides a way for Sun Developer Products to
collect information about how developers use its compilers and
tools. This information can then be used to improve future
revisions of the products.

Usage tracking is implemented in the Alpha and Beta releases of
the cc, CC, f77, and pc compilers, and the lint tool. It will not
be implemented in the final release of these products. Users can
turn off all usage tracking with an environment variable.

This information is collected:

  - System and operating system information, such as that obtained with
    "uname -a"
  - Compiler and lint options used

No file names, directory names, or macros are collected. For example,
if a user issues this command:

   cc -DMACRO -L/directory1 -I/directory2 -Xa -O hello.c

this information is collected:

   cc -D -L -I -Xa -O

Each time a compiler or tool is invoked, the options used are logged in
the file /tmp/.UT.<program>.<user>. The log file is sent to
Developer Products if the file exceeds 10 Kbytes or is
over 24 hours old.

Users can modify usage tracking with these environment variables:

  Variable              Description
  --------              -----------
  UT_LOG_MAX_LENGTH     Change the maximum size in bytes of the log file
  UT_LOG_MAX_AGE        Change the maximum age in seconds of the log file
  UT_LOG_DIRECTORY      Change the default directory of the log file
  UT_NO_USAGE_TRACKING  Turn off usage tracking
 
Examples of use:

If UT_NO_USAGE_TRACKING is defined with the value "cc:f77", usage
tracking is turned off for cc and f77.  If UT_NO_USAGE_TRACKING is
defined with the value "1" or defined with no value, usage tracking
is turned off for all programs. 
__________________________________________________________________________

Table of Contents:

          A. New Features
          B. Changes to Features 
          C. Software Incompatibilities
          D. Current Software Bugs
          E. Fixed Software Bugs
          F. Documentation Errata ___________________________________________________________________________
A. New Features

	Option changes have been made for this release that now allow all flags on
        all platforms. For those platforms where a flag is not valid, the flag
        will be quietly accepted. No warning will be given. -flags will only
        show the valid flags for the particular platform. The options
        chapter of the C 4.2 User's Guide provides a generic description
        of this behavior.

	New options added to this release include:

		-errchk=<l>	Check portability to environment for which the 
		(lint)		size of long integers and pointers is 64 bits.

		-fprecision=<p>	Initializes the rounding precision mode bits in
		(Intel)		the floating-point control word.

		-xlic_lib_=<l>	Link in the SunSoft supplied licensed libraries.
 		(SPARC, Intel)

		-xcrossfile	Enables cross file inlining.
		(SPARC)

		-xpentium	Generate code for the pentium processor
		(Intel)
	
____________________________________________________________________________
B. Changes to Features

          The following options, previously SPARC only, are now
          available on Intel and PowerPC:
                -fround, -fsimple, -ftrap, -xprofile=tcov, -xspace,
                -xunroll=n

          The following options, previously SPARC only, are now
          available in restricted form on Intel and PowerPC:
                 -xtarget=
                           Intel accepts: generic, native, 386,
                                          486, pentium, pentium_pro
                         PowerPC accepts: generic, native
                 -xarch=
                           Intel accepts: generic, 386, pentium_pro
                         PowerPC accepts: generic, ppc, ppc_nofma
                 -xchip=
                           Intel accepts: generic, 386, 486, pentium,
                                          pentium_pro
                         PowerPC accepts: generic

____________________________________________________________________________
D. Current Software Bugs

No new information for this release.

____________________________________________________________________________
E. Fixed Software Bugs

Bug ID   Category    Synopsis
------   --------    --------

No new information for this release.


____________________________________________________________________________
F. Documentation Errata

No new information for this release.

____________________________________________________________________________
