PBXBUILD(1)                                           PBXBUILD(1)



NAME
       pbxbuild - build Project Builder projects

SYNOPSIS
       pbxbuild [ -activetarget ] [ -alltargets ] [ -target <tar-
       getname> ] [ -activebuildstyle  ]  [  -buildstyle  <build-
       stylename>"  ]  [ <buildaction> ] [ <variable>=<value> ] [
       -help ]
       pbxbuild -list

DESCRIPTION
       The pbxbuild command builds a target contained in  a  Pro-
       ject  Builder  project.   Run  pbxbuild from the directory
       containing your  project  (i.e.  the  <projectName>.pbproj
       directory).

       By  default,  pbxbuild  builds  the first target listed in
       your project, with no buildstyle.  Use the Project Builder
       IDE  to  change  the order of the targets in your project.
       The order of the targets is a property of the project and,
       as  such,  is  the same for all users of the project.  The
       active target and active buildstyle properties are set for
       each  user of the project and, as such, can vary from user
       to user.

       These are the options for pbxbuild

       -activetarget
              Builds the user's active target.

       -alltargets
              Build all the targets, in order, in the project.

       -target <targetname>
              Build the target specified by <targetname>.

       -activebuildstyle
              Use the user's active buildstyle when building  the
              target.

       -buildstyle <buildstylename>
              Use  the  buildstyle  specified by <buildstylename>
              when building the target.

       <buildaction>
              Specify a build action to perform  on  the  target.
              Build actions are:

              build  Build  the  target  in the builds root (SYM-
                     ROOT). This is the default build action.

              installsrc
                     Copy the source of the project to the source
                     root (SRCROOT).

              export Generate   build  files  and  a  pbxbuild.sh
                     script which can build the specified target.

              install
                     Build  the  target  and  install it into the
                     target's installation directory in the  dis-
                     tribution root (DSTROOT).

              clean  Remove build products and intermediate files
                     from the builds root (SYMROOT).

       <variable> = <value>
              Set the build variable to <variable> to <value>.

       -list  Lists the targets in the project. Does not initiate
              a build.


EXAMPLES
       pbxbuild clean install

              Cleans the build directory; then builds and install
              the first target in the project.

       pbxbuild -target  MyTarget  OBJROOT=/Build/MyProj/Obj.root
       SYMROOT=/Build/MyProj/Sym.root

              Builds the target MyTarget putting object (interme-
              diate) files in one directory and the  products  of
              the build in another directory.







Apple Computer, Inc.      February, 2001              PBXBUILD(1)