rez(1)                                                     rez(1)



NAME
     rez - compiles Macintosh resource files from source code

SYNOPSIS
     rez [-a] [-align word-type] [-c reator]
     [-d macro-assignment]...  [-i include-dir]...
     [-o output-file] [-ov] [-p] [-rd] [-ro]
     [-s res-include-dir]...  [-t type] [-u macro]
     [resource-description-file]...

ARGUMENTS
     -align word
     -align longword
          Align resources along word or longword boundaries.
          This alignment may allow the Resource Manager to load
          these resources more quickly.  The -align option is
          ignored when the -a option is in effect.

     -a   Appends the output from rez to the output file instead
          of replacing the output file.

     -c0creator
          Specifies the creator attribute for the compiled
          resource file.

     -d macro-assignment
          Declares a macro and its value in the form

             macro=value

          This assignment is equivalent to the following form of
          preprocessor request:

             #define macro  [value]

          If value is omitted, then macro is set to the null
          string.  (The macro is still considered to be defined.)

     -i include-dir
          Searches the specified directory for include files.
          The system searches directories according to the order
          of appearance of any number of -i options in the
          command line.  To reach the include files provided with
          the A/UX Toolbox, use this command:  (Note that colons
          replace slashes to indicate subdirectories.)

             rez -i /:mac:lib:rincludes

     -o output-file
          Places the output in the file specified by output-file.
          Specifies the name of the associated data file; rez
          automatically appends a percent sign (%) to the name of



January 1992                                                    1

rez(1)                                                     rez(1)



          the header file containing the resources.  The default
          output file is rez.Out.

     -ov  Overrides the protection bit when resources are
          replaced and the -a option is in effect.

     -p   Writes version and progress information to diagnostic
          output.

     -rd  Suppresses warning messages if a resource type is
          redeclared.

     resource-description-file
          Specifies files containing (source code) resource
          descriptions.  If you don't specify any filenames, rez
          accepts keyboard input.

     -ro  Sets the mapReadOnly flag in the resource map.

     -s res-include-dir
          Searches the specified directories for resource include
          files.  (Also see the description of the -i option
          earlier in this list.)

     -t type
          Specifies the type attribute of the compiled resource
          file.  The default value is APPL.

     -u[ndef] macro
          Undefines the macro variable macro.  Using this option
          is equivalent to entering the following preprocessor
          request:

             #undef macro

          It is meaningful to undefine only the preset macro
          variables.  (See Appendix C of ``A/UX Toolbox:
          Macintosh ROM Interface'' for a description of macro
          variables.)

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 Appendix C, "Resource Compiler and
     Decompiler," of ``A/UX Toolbox: Macintosh ROM Interface''.

     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).



2                                                    January 1992

rez(1)                                                     rez(1)



     The type declarations for standard Macintosh resources are
     contained in the files types.r and systypes.r, located in
     the directory /mac/lib/rincludes.

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

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

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


EXAMPLES
     The following example is based on the descriptions in
     sample.r and the include files in the directory
     /mac/lib/rincludes.  It generates a resource file for
     %sample and places the output in an AppleDouble header file
     named sample:

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


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

     The rez command returns one of these status values:

     0    No errors

     1    Error in parameters

     2    Syntax error in file

     3    I/O or program error

LIMITATIONS
     This command is not supported in 24-bit mode. You must run
     rez from the command line while logged in with a 32-bit
     Macintosh session type.






January 1992                                                    3

rez(1)                                                     rez(1)



FILES
     /mac/bin/rez
          Executable file

SEE ALSO
     derez(1), setfile(1)

















































4                                                    January 1992