Makefile.preamble

   1 ###############################################################################
   2 #  Makefile.preamble
   3 #  Copyright 1997, Apple Computer, Inc.
   4 #
   5 #  Use this makefile for configuring the standard application makefiles
   6 #  associated with ProjectBuilder. It is included before the main makefile.
   7 #  In Makefile.preamble you set attributes for a project, so they are available
   8 #  to the project's makefiles.  In contrast, you typically write additional rules or
   9 #  override built-in behavior in the Makefile.postamble.
  10 #
  11 #  Each directory in a project tree (main project plus subprojects) should
  12 #  have its own Makefile.preamble and Makefile.postamble.
  13 ###############################################################################
  14 #
  15 # Before the main makefile is included for this project, you may set:
  16 #
  17 #    MAKEFILEDIR: Directory in which to find $(MAKEFILE)
  18 #    MAKEFILE: Top level mechanism Makefile (e.g., app.make, bundle.make)
  19
  20 # Compiler/linker flags added to the defaults:  The OTHER_* variables will be
  21 # inherited by all nested sub-projects, but the LOCAL_ versions of the same
  22 # variables will not.  Put your -I, -D, -U, and -L flags in ProjectBuilder's
  23 # Build Attributes inspector if at all possible.  To override the default flags
  24 # that get passed to ${CC} (e.g. change -O to -O2), see Makefile.postamble.  The
  25 # variables below are *inputs* to the build process and distinct from the override
  26 # settings done (less often) in the Makefile.postamble.
  27 #
  28 #    OTHER_CFLAGS, LOCAL_CFLAGS:  additional flags to pass to the compiler
  29 #       Note that $(OTHER_CFLAGS) and $(LOCAL_CFLAGS) are used for .h, ...c, .m,
  30 #       .cc, .cxx, .C, and .M files.  There is no need to respecify the
  31 #       flags in OTHER_MFLAGS, etc.
  32 #    OTHER_MFLAGS, LOCAL_MFLAGS:  additional flags for .m files
  33 #    OTHER_CCFLAGS, LOCAL_CCFLAGS:  additional flags for .cc, .cxx, and ...C files
  34 #    OTHER_MMFLAGS, LOCAL_MMFLAGS:  additional flags for .mm and .M files
  35 #    OTHER_PRECOMPFLAGS, LOCAL_PRECOMPFLAGS:  additional flags used when
  36 #       precompiling header files
  37 #    OTHER_LDFLAGS, LOCAL_LDFLAGS:  additional flags passed to ld and libtool
  38 #    OTHER_PSWFLAGS, LOCAL_PSWFLAGS:  additional flags passed to pswrap
  39 #    OTHER_RPCFLAGS, LOCAL_RPCFLAGS:  additional flags passed to rpcgen
  40 #    OTHER_YFLAGS, LOCAL_YFLAGS:  additional flags passed to yacc
  41 #    OTHER_LFLAGS, LOCAL_LFLAGS:  additional flags passed to lex
  42
  43 OTHER_CFLAGS = -Wno-precomp
  44
  45 # These variables provide hooks enabling you to add behavior at almost every
  46 # stage of the make:
  47 #
  48 #    BEFORE_PREBUILD: targets to build before installing headers for a subproject
  49 #    AFTER_PREBUILD: targets to build after installing headers for a subproject
  50 #    BEFORE_BUILD_RECURSION: targets to make before building subprojects
  51 #    BEFORE_BUILD: targets to make before a build, but after subprojects
  52 #    AFTER_BUILD: targets to make after a build
  53 #
  54 #    BEFORE_INSTALL: targets to build before installing the product
  55 #    AFTER_INSTALL: targets to build after installing the product
  56 #    BEFORE_POSTINSTALL: targets to build before postinstalling every subproject
  57 #    AFTER_POSTINSTALL: targts to build after postinstalling every subproject
  58 #
  59 #    BEFORE_INSTALLHDRS: targets to build before installing headers for a
  60 #         subproject
  61 #    AFTER_INSTALLHDRS: targets to build after installing headers for a subproject
  62 #    BEFORE_INSTALLSRC: targets to build before installing source for a subproject
  63 #    AFTER_INSTALLSRC: targets to build after installing source for a subproject
  64 #
  65 #    BEFORE_DEPEND: targets to build before building dependencies for a
  66 #         subproject
  67 #    AFTER_DEPEND: targets to build after building dependencies for a
  68 #         subproject
  69 #
  70 #    AUTOMATIC_DEPENDENCY_INFO: if YES, then the dependency file is
  71 #         updated every time the project is built.  If NO, the dependency
  72 #         file is only built when the depend target is invoked.
  73
  74 # Framework-related variables:
  75 #    FRAMEWORK_DLL_INSTALLDIR:  On Windows platforms, this variable indicates
  76 #       where to put the framework's DLL.  This variable defaults to
  77 #       $(INSTALLDIR)/../Executables
  78
  79 # Library-related variables:
  80 #    PUBLIC_HEADER_DIR:  Determines where public exported header files
  81 #       should be installed.  Do not include $(DSTROOT) in this value --
  82 #       it is prefixed automatically.
  83 #    PRIVATE_HEADER_DIR:  Determines where private exported header files
  84 #       should be installed.  Do not include $(DSTROOT) in this value --
  85 #       it is prefixed automatically.
  86 #    LIBRARY_STYLE:  This may be either STATIC or DYNAMIC, and determines
  87 #       whether the libraries produced are statically linked when they
  88 #       are used or if they are dynamically loadable. <<default?>>
  89 #    LIBRARY_DLL_INSTALLDIR:  On Windows platforms, this variable indicates
  90 #       where to put the library's DLL.  This variable defaults to
  91 #       $(INSTALLDIR)/../Executables
  92 #
  93 #    INSTALL_AS_USER: owner of the intalled products (default root)
  94 #    INSTALL_AS_GROUP: group of the installed products (default wheel)
  95 #    INSTALL_PERMISSION: permissions of the installed product (default o+rX)
  96 #
  97 #    OTHER_RECURSIVE_VARIABLES: The names of variables which you want to be
  98 #       passed on the command line to recursive invocations of make.  Note that
  99 #       the values in OTHER_*FLAGS are inherited by subprojects automatically --
 100 #       you do not have to (and shouldn't) add OTHER_*FLAGS to
 101 #       OTHER_RECURSIVE_VARIABLES.
 102
 103 # Additional headers to export beyond those in the PB.project:
 104 #    OTHER_PUBLIC_HEADERS
 105 #    OTHER_PROJECT_HEADERS
 106 #    OTHER_PRIVATE_HEADERS
 107
 108 # Additional files for the project's product: <<path relative to proj?>>
 109 #    OTHER_RESOURCES: (non-localized) resources for this project
 110 #    OTHER_OFILES: relocatables to be linked into this project
 111 #    OTHER_LIBS: more libraries to link against
 112 #    OTHER_PRODUCT_DEPENDS: other dependencies of this project
 113 #    OTHER_SOURCEFILES: other source files maintained by .pre/postamble
 114 #    OTHER_GARBAGE: additional files to be removed by `make clean'
 115
 116 # Set this to YES if you don't want a final libtool call for a library/framework.
 117 #    BUILD_OFILES_LIST_ONLY
 118
 119 # To include a version string, project source must exist in a directory named
 120 # $(NAME).%d[.%d][.%d] and the following line must be uncommented.
 121 # OTHER_GENERATED_OFILES = $(VERS_OFILE)
 122
 123 # This definition will suppress stripping of debug symbols when an executable
 124 # is installed.  By default it is YES.
 125 # STRIP_ON_INSTALL = NO