home *** CD-ROM | disk | FTP | other *** search
/ Eagles Nest BBS 8 / Eagles_Nest_Mac_Collection_Disc_8.TOAST / Developer Tools⁄Additions / MacUserProj / MacUser Projects / May / Readme < prev   
Encoding:
Text File  |  1990-05-02  |  3.8 KB  |  92 lines  |  [TEXT/KAHL]

  1.     Read this file before trying to compile miniGenericApp.
  2.     
  3.     
  4.     Just when you thought it was easy to program in THINK C -- not 
  5.     all THINK C's are created equally. As a matter of fact, they're
  6.     all different in subtle ways. Read On.
  7.     
  8.     Version 4.0 of THINK C supports the so-called "ANSI" standard
  9.     definition of the C language. Previous versions of the 
  10.     Compiler don't. Therefore, header files and libraries that 
  11.     existed in earlier versions of Lightspeed don't exist anymore. 
  12.     The obvious advantage to this is that it's easier to write 
  13.     portable code, i.e., code that will compile and run on non-
  14.     THINK C compilers that also support ANSI.The major disadvantage 
  15.     is that you need to make slight changes to source of Generic App
  16.     depending on whether you're using Version 2, 3, or 4 of the 
  17.     compiler.
  18.  
  19.  
  20.     Thus header file names changed between versions. Also, beginning with
  21.     version 3.0, a slick, new feature called MacHeaders was introduced.
  22.     When the MacHeaders option is selected, the compiler uses a binary file
  23.     that describes all about Mac related data types, meaning that you
  24.     don't have to include those manager header files that define fundamental 
  25.     Mac data structures like Event Records, WindowRecords, and the lot.
  26.     
  27.     Also between version 2 and 3, Multifinder became functional.So version
  28.     3 supports Multifinder while version 2 doesn't. There really are a lot of 
  29.     changes between the three versions.
  30.     
  31.     Because I want you folks out there to have running versions 
  32.     of Generic App, no matter what version of the compiler that 
  33.     you happen to own, I've devised a strategy that should allow everyone
  34.     to use Generic (for the time being--I want you all to upgrade if you're         going to continue with us and use the code examples. These three parts of       Generic will be the only code that's written with this accomodation.             (BTW, Symantec isn't paying me a commission for my one-man upgrade             promotion but,
  35.     perhaps they ought to offer a discount to my MacUser readers!)
  36.     
  37.     Here's how you get Generic to work on your compiler:
  38.     
  39.     First: Find out what version of THINK C that you're running.
  40.     
  41.     Next, there are three project files, one for version 2, 3, and 4 of
  42.     THINK C. You use the one that's appropriate for your compiler. Then,
  43.     we'll let the preprocessor to fixup the code for you through the
  44.     use of a defined constant. This constant is in the file "Version.h" so
  45.     open that file right now. It's in the miniGenAppHdr folder, with all
  46.     the other header files.
  47.     
  48.     Step-by-step, here's what you do:
  49.     
  50.         For those of you who are running THINK C version 4.0:
  51.         
  52.             0. Open project file miniGenAppπ-v4.0
  53.             1. change #undef V4 to #define V4 in Version.h.
  54.             2. make sure that you undefine V3 and V2.
  55.             3. Rename the resource file miniGenAppπ.rsrc
  56.                 to miniGenAppπ-v4.0.rsrc
  57.             4. Bring the Project "Up to Date"
  58.                 
  59.         For those of you running version THINK C 3.01:
  60.         
  61.             0. Open project file miniGenAppπ-v3.01
  62.             1. change #undef V3 to #define V3 in Version.h
  63.             2. make sure that you undefine V2 and V4.
  64.             3. Rename the resource file miniGenAppπ.rsrc
  65.                 to miniGenAppπ-v3.01.rsrc
  66.             4. Bring the Project "Up to Date"
  67.  
  68.         For those of you running versions Lightspeed 2.13 or 2.15:
  69.         
  70.             0. Open project file miniGenAppπ-v2.13
  71.             1. change #undef V2 to #define V2 in Version.h
  72.             2. make sure that you undefine V3 and V4.
  73.             3. Rename the resource file miniGenAppπ.rsrc
  74.                 to miniGenAppπ-v2.13.rsrc
  75.             4. Run the project
  76.             
  77.         For those of you running anything else:
  78.         
  79.             1. Isn't it time that you catch up with the rest of us?
  80.                 
  81.                 
  82.         After we finish Generic App, all examples will
  83.         be in THINK 4.0, period. There are a few
  84.         good reasons for this, and you'll discover them
  85.         as we get there. So please, anyone who is not
  86.         using the latest version of the compiler,
  87.         may we suggest that you THINK about upgrading?
  88.                 
  89.  
  90.         All the best,
  91.         
  92.         kwgm