.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: shape_tar.1[6.0] Fri Jun 25 17:01:48 1993 andy@cs.tu-berlin.de frozen $
..
.TH "SHAPE_TAR" 1 "" \n(dy.\n(mo.\n(yr
.SH NAME
shape_tar \- shapeTools RMS bundle up subsystem in a tar or shar archive
.SH SYNOPSIS
.ta 2c
\fB
shape tar	[VERSIONS=<version_selection_rule>] [ARCHIVE=<filename>]
.sp
shape shar	[VERSIONS=<version_selection_rule>] [ARCHIVE=<filename>]\fP
.sp
.SH DESCRIPTION
\fIShape tar\fP and \fIshape shar\fP create a tar or
a shar archive containing all source components of the current node in
the system tree. All source components listed in the \fICOMPONENTS\fP
macro in the Makefile and the release identification file
(\fIVERSIONFILE\fP) are written to the archive. 
Components of subsystems are \fInot\fP included in the archive file.
.PP
The \fIVERSIONS\fP macro may be set to specify a version
selection rule to be active during archive file creation. Default is
\fImost_recent\fP, selecting the most recent version of each
component. See shape_stdrul(7) or the $(SHAPELIBPATH)/stdrules for other
possible settings. You may also use self defined version selection
rules as VERSIONS.
.PP
\fIARCHIVE\fP is the base name of the file where the output shall be
written to. Default is \fI$(SUBSYSTEMNAME)\fP. The output file gets the
filename extension \fI.tar\fP (resp. \fI.shar\fP).
When ARCHIVE=\- is given, data will be written to standard output.
.SH SEE ALSO
shape_RMS(1), shape_stdrul(7)
.SH FILES
$(SUBSYSTEMNAME).tar
$(SUBSYSTEMNAME).shar