rez(1)                                                     rez(1)



     NAME
          rez - compile resources

     SYNOPSIS
          rez [option]...  [resource-description-file]...

     DESCRIPTION
          rez creates a resource file according to a textual series of
          statements in the resource-description language developed
          for Macintosh resources.  The resource-description language
          is described in an appendix of A/UX Toolbox.

          The resource-description-file parameter represents the names
          of one or more files containing resource descriptions.  If
          no filenames are specified, rez accepts keyboard input.

          The data used to build the resource file can come directly
          from one or more resource-description files, from other text
          files (through #include and read directives in the
          resource-description file), and from other resource files
          (through the include directive in the resource-description
          file).  The type declarations for standard Macintosh
          resources are contained in the files types.r and systypes.r
          located in the directory /mac/lib/rincludes.

          rez includes macro processing, full expression evaluation,
          built-in functions, and system variables.

          rez never sends output to standard output.  By default, rez
          writes to a file named rez.Out in the current directory.
          You can specify a different output file with the -o option.

          If no errors or warnings are detected, rez runs silently.
          Errors and warnings are written to standard error.

          rez returns one of the following status values.

               0    No errors

               1    Error in parameters

               2    Syntax error in file

               3    I/O or program error

          You may specify one or more of the following options.

          -align[word|longword]
               Align resources along word or longword boundaries.
               This may allow the Resource Manager to load these
               resources faster.  The -align option is ignored when
               the -a option is in effect.



     April, 1990                                                     1

     rez(1)                                                     rez(1)



          -a[ppend]
               Output from rez is appended to the output file instead
               of replacing the output file.

                  Note:  rez overwrites any existing resource of
                  the same type and ID without a warning message.
                  rez cannot append resources to a resource file in
                  which the Read Only bit is set.  Also, rez cannot
                  replace a resource file that has a protection bit
                  set.  See also the -ov option below.


          -c[reator] creator-expr
               Set the creator of the output file.  (The default value
               is ????.)

          -d[efine] macro[=data]
               Define the macro variable macro to have the value data.
               If data is omitted, then macro is set to the null
               string (this still means that macro is defined).  The
               -d option is the same as writing

                  #define macro [data]

               at the beginning of the input.

          -ipathname(s)
               Search the specified pathnames for include files.  You
               may specify more than one pathname.  The paths are
               searched in the order they appear in the command line.

               To reach the include files provided with the A/UX Tool-
               box, use this pathname

                  rez -i /:mac:lib:rincludes


          -o output-file
               Place the output in output-file.  Specify the name of
               the associated data file; rez automatically affixes a
               percent sign (%) to the name of the header file con-
               taining the resources.  The default output file is
               rez.Out.

          -ov  Override the protected bit when replacing resources
               with the -a option.

          -p[rogress]
               Write version and progress information to diagnostic
               output.

          -rd  Suppress warning messages if a resource type is rede-



     2                                                     April, 1990

     rez(1)                                                     rez(1)



               clared.

          -ro  Set the mapReadOnly flag in the resource map.

          -s pathname(s)
               Search the specified pathnames for resource include
               files.

          -t[ype] type-expr
               Set the type of the output file.  The default value is
               APPL.

          -u[ndef] macro
               Undefine the macro variable macro.  This is the same as
               writing

                  #undef macro

               at the beginning of the input.  It is meaningful to un-
               define the preset macro variables only.  (See Appendix
               C of the document A/UX Toolbox for a description of
               macro variables.)

     EXAMPLES
          rez -i /:mac:lib:rincludes sample.r -o sample

          generates a resource file for sample, based on the descrip-
          tions in sample.r and the include files in the directory
          /mac/lib/rincludes.  Place the output in an AppleDouble
          header file named %sample.

     FILES
          /mac/bin/rez

     SEE ALSO
          derez(1).

     NOTES
          This command is not supported in 24-bit mode and must be run
          from the command line while logged into the Macintosh en-
          vironment with the 32-bit session type.














     April, 1990                                                     3