new version 1.5.2 for morefiles

[wxWidgets.git] / src / mac / morefile / Optimization.h

diff --git a/src/mac/morefile/Optimization.h b/src/mac/morefile/Optimization.h
new file mode 100644 (file)
index 0000000..d2673f9
--- /dev/null
+++ b/src/mac/morefile/Optimization.h
@@ -0,0 +1,109 @@
+/*
+       File:           Optimization.h
+
+       Contains:       Defines that let you make MoreFiles code more efficient.
+
+       Version:        MoreFiles
+
+       Copyright:      © 1992-2001 by Apple Computer, Inc., all rights reserved.
+
+       You may incorporate this sample code into your applications without
+       restriction, though the sample code has been provided "AS IS" and the
+       responsibility for its operation is 100% yours.  However, what you are
+       not permitted to do is to redistribute the source as "DSC Sample Code"
+       after having made changes. If you're going to re-distribute the source,
+       we require that you make it clear in the source that the code was
+       descended from Apple Sample Code, but that you've made changes.
+
+       File Ownership:
+
+               DRI:                            Apple Macintosh Developer Technical Support
+
+               Other Contact:          Apple Macintosh Developer Technical Support
+                                                       <http://developer.apple.com/bugreporter/>
+
+               Technology:                     DTS Sample Code
+
+       Writers:
+
+               (JL)    Jim Luther
+
+       Change History (most recent first):
+
+                <1>      2/7/01        JL              first checked in
+*/
+
+/*
+       The Optimization changes to MoreFiles source and header files, along with
+       this file and OptimizationEnd.h, let you optimize the code produced
+       by MoreFiles in several ways.
+       
+       1 -- MoreFiles contains extra code so that many routines can run under
+       Mac OS systems back to System 6. If your program requires a specific
+       version of Mac OS and your program checks for that version before
+       calling MoreFiles routines, then you can remove a lot of compatibility
+       code by defining one of the following to 1:
+       
+               __MACOSSEVENFIVEONEORLATER      // assume Mac OS 7.5.1 or later
+               __MACOSSEVENFIVEORLATER         // assume Mac OS 7.5 or later
+               __MACOSSEVENORLATER                     // assume Mac OS 7.0 or later
+       
+       If you're compiling 68K code, the default is to include all compatibility code.
+       If you're compiling PowerPC code (TARGET_RT_MAC_CFM), the default is __MACOSSEVENORLATER
+       If you're compiling for Carbon code (TARGET_API_MAC_CARBON), the default is __MACOSSEVENFIVEONEORLATER
+       
+       2 -- You may disable Pascal calling conventions in all MoreFiles routines
+       except for system callbacks that require Pascal calling conventions.
+       This will make 68K C programs both smaller and faster. 
+       (PowerPC compilers ignore pascal calling conventions.)
+       Just define __WANTPASCALELIMINATION to be 1 to turn this optimization on
+       when building MoreFiles for use from C programs (you'll need to keep
+       Pascal calling conventions when linking MoreFiles routines with Pascal
+       programs).
+       
+       3 -- If Metrowerks compiler is used, "#pragma internal on" may help produce
+       better code. However, this option can also cause problems if you're
+       trying to build MoreFiles as a shared library, so it is by default not used.
+       Just define __USEPRAGMAINTERNAL to be 1 to turn this optimization on.
+       
+       Original changes supplied by Fabrizio Oddone
+*/
+
+#include <ConditionalMacros.h>
+
+// if we're compiling for Carbon, then we're running on Mac OS 8.1 or later
+#ifndef __MACOSSEVENFIVEONEORLATER
+       #define __MACOSSEVENFIVEONEORLATER TARGET_API_MAC_CARBON
+#endif
+
+#ifndef __MACOSSEVENFIVEORLATER
+       #define __MACOSSEVENFIVEORLATER __MACOSSEVENFIVEONEORLATER
+#endif
+
+#ifndef __MACOSSEVENORLATER
+       #if TARGET_RT_MAC_CFM
+               #define __MACOSSEVENORLATER 1
+       #else
+               #define __MACOSSEVENORLATER __MACOSSEVENFIVEORLATER
+       #endif
+#endif
+
+
+#ifndef        __WANTPASCALELIMINATION
+       #define __WANTPASCALELIMINATION 0
+#endif
+
+#if    __WANTPASCALELIMINATION
+       #define pascal  
+#endif
+
+
+#ifndef __USEPRAGMAINTERNAL
+       #define __USEPRAGMAINTERNAL     0
+#endif
+
+#if    __USEPRAGMAINTERNAL
+       #if defined(__MWERKS__)
+               #pragma internal on
+       #endif
+#endif