SHAPE_PATCH(1)						      General Commands Manual						    SHAPE_PATCH(1)

NAME

       shape_patch - shapeTools RMS generate patch file

SYNOPSIS

       shape patch OLDRELEASE=<name1> NEWRELEASE=<name2> [PATCHFILE=<filename>]

DESCRIPTION

       Shape  patch  generates	a patch file for updating $(OLDRELEASE) to $(NEWRELEASE). Both releases are identified by release names associated
       with the macros OLD-/NEWRELEASE on the command line. Valid release names are those generated by any of the shape_RMS (pre-)release building
       procedures  (see  shape_releas(1)).  Performing 'vl -all' with the release identification file as argument usually gives a good overview of
       existing release names.	Patch generation happens recursively over all subsystems being part of the current node. Hence,  triggering  shape
       patch from the top node of the central source repository creates a patch file for the whole system.

       The  output  of	shape patch is stored in a file named <name1>+2+<name2>.pat. When the PATCHFILE macro is set on the command line, $(PATCH-
       FILE) is taken as output file name instead.  Defining PATCHFILE=- on the command line causes the patch to be written  to  standard  output.
       Note:  For patches invoking multiple subsystems, $(PATCHFILE) should be set to an absolute pathname. If not, the patch generation procedure
       will leave an equally named patch file for each visited subsystem.

       The patch is constructed using the vdiff(1) command and can be applied to any installation of $(OLDRELEASE) by invoking patch(1).

INCONVENIENCES

       On System V machines, the generated patch file name will almost certainly exceed the 14 characters filename length limit.

SEE ALSO

       shape_releas(1), vdiff(1), patch(1)

FILES

       <name1>+2+<name2>.pat

29.9.119															    SHAPE_PATCH(1)