
 README
  for the alternative CLib/MacRT runtime library for MC680x0

  Created: February 8, 2006 5:37 PM EDST
  Revised: February 5, 2007 5:05 PM EDST

* * * * * * * * * *

  BE ADVISED
    The original version of the SANE library in this directory has not been
  explicitly expressed as "freeware".
    If you do not own Symantec C++ for Macintosh, you must delete "SANE.hqx".
    You are at YOUR OWN RISK in not doing so.

* * * * * * * * * *

    Primarily, this part of the MyCSeries package is intended to replace the
  obsolete THINK C MacTraps and ANSI libraries, so that Symantec C++ 7.0.5
  users don't have to stay in the dark when it comes to updating their software
  for newer versions of the MacOS Interface library and printf routines.
    The files in here can also be used to optimize the StdCLib and MacRuntime
  libraries for 68K users for people using MPW (smaller and faster).
    IMPORTANT: some object code has not been tested with MPW applications.
  If you experience problems with switching objects to these... then you may
  have to just switch back -- if you know what's wrong, send a detailed report.

    This is M68K only, and users compiling for PowerPC/Intel should be using
  MPW or Apple's XCode instead of trying to make use of CLib.  MyCSeries should
  (or eventually) be compatible with all of the mentioned architectures.

    If everything works out in running the MPW script, then you should be able
  to use Apple's StdCLib, MacRuntime and Interface libraries with Symantec C.
    The CLib.o library is no longer automatically built (use at your own risk).


    For MPW compiling for 68K with an FPU (or emulated), you may do:
      :MyCSeries:MacCSeries.o
      :MyCSeries:LibSubOver:FPLibLC040.o
      :MyCSeries:LibSubOver:StdCLib881.o
      MacRuntime.o
      IntEnv.far.o
      Interface.o

    For THINK Project files compiling for SANE (non-FPU):
      :MyCSeries:MacCSeries.o   (in a seperate segment)
      :MyCSeries:LibSubOver:CLibOver.a.o
      :MyCSeries:LibSubOver:MacRTLib.o
      :MyCSeries:LibSubOver:SubCLib.o
      :MyCSeries:LibSubOver:deccvtSANE.a.o
      Interface.o
      SANE

    For THINK Project files compiling for 68K with an FPU (or emulated):
      :MyCSeries:MacCSeries.o   (in a seperate segment)
      :MyCSeries:LibSubOver:CLibOver.a.o
      :MyCSeries:LibSubOver:MacRTLib.o
      :MyCSeries:LibSubOver:SubCLib881.o
      :MyCSeries:LibSubOver:FPLibLC040.o
      Interface.o


    For all projects with a MacOS Classic target must use Universal Interfaces
  version 3.4.2 or later to really do anything with Apple's later software....
  and you definitely can't use Universal Interfaces version 4 with 68K.


Disclaimer

  THIS SOFTWARE IS NOT COPYRIGHTED

   This source code is offered for use in the public domain.  You may use,
  modify or distribute it freely.

   This code is distributed in the hope that it will be useful but WITHOUT
  ANY WARRANTY.  ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY DISCLAIMED.
   This includes but is not limited to warranties of MERCHANTABILITY or
  FITNESS FOR A PARTICULAR PURPOSE.


To download MPW (which includes the latest Universal Interfaces compatible
    with MacOS Classic), go to:

  developer.apple.com
