.\" '\" t
.\" ** The above line should force tbl to be a preprocessor **
.\" Man page for man
.\" 
.\" Copyright (C), 2006, Franklin PIAT
.\" 
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" beaglefs distribution.
.\" 
.\" Sat Nov  4 10:55:16 CET 2006  Franklin PIAT (fpiat@bigfoot.com)
.\" 
.\" .pc
.TH "gpg-zip" "1" "1.0" "Franklin PIAT" "User Commands"
.SH "NAME"
.LP 
gpg\-zip \- Encrypt / sign / decrypt files into an archive.
.SH "SYNOPSIS"
.LP 
\fBgpg\-zip\fR \fB\-e\fR | \fB\-\-encrypt\fR [\fB\-s\fR | \fB\-\-sign\fR]  \fIpathname\fR [\fIpathname ...\fR]
.br 
\fBgpg\-zip\fR \fB\-e\fR | \fB\-\-encrypt\fR [\fB\-c\fR | \fB\-\-symmetric\fR]  \fIpathname\fR [\fIpathname ...\fR]
.br 
\fBgpg\-zip\fR \fB\-d\fR | \fB\-\-decrypt\fR \fIfilename\fR
.br 
\fBgpg\-zip\fR \fB\-\-list\-archive\fR \fIfilename\fR
.br 
\fBgpg\-zip\fR \fB\-h\fR | \fB\-\-help\fR | \fB\-\-version\fR
.SH "DESCRIPTION"
.LP 
\fBgpg\-zip\fR creates and extracts a \fBPGP Zip\fR archive containing selected files and directories.
.br 
Despite the name, PGP Zip format is actually an OpenPGP\-wrapped \fBtar\fR file (reminder: gpg files are compressed by default)
.SH "OPTIONS"
.LP 
All options MUST appear before any \fIfilename\fR and \fIpathname\fR
.LP 
.SS "general options:"
.TP 
\-h   \-\-help
print help
.TP 
\-\-version
print version

.SS "GPG options:"
.TP 
\-r \fIname\fR, \-\-recipient \fIname\fR
Encrypt for user id \fIname\fR.

.TP 
\-c,   \-\-symmetric
Encrypt  with  a  symmetric  cipher  using  a passphrase (see gpg manpage).

.TP 
\-o \fIfilename\fR, \-\-output \fIfilename\fR
Write output to \fRfilename\fR.

.TP 
\-u \fIname\fR, \-\-local\-user \fIname\fR
Use \fIname\fR as the key to sign with.

.TP 
\-\-gpg \fIprogram\fR
Specify the openpgp program and path you want to use (default is gpg).

\fB\-\-gpg\-args ARGS\fR
You can specify some extra arguments for the tar program (embeded them in quotes if there are some spaces)

.SS "TAR options:"
.TP 
\-\-tar \fBprogram\fR
Specify the tar program you want to use (default is /bin/tar).

.TP 
\-\-tar\-args \fBtarargs\fR
You can specify some extra arguments for the tar program (embeded them in quotes if there are some spaces)

.PP 
.SH "AUTHORS"
.LP 
This manpage was originally written by Franklin PIAT
<fpiat@bigfoot.com>.
.SH "COMPATIBILITY"
gpg\-zip uses the same format as PGP's PGP Zip.

To be fully compatible with PGP itself, this must be a USTAR format tar file. Unclear on whether there is a distinction here between the GNU or POSIX variant of USTAR (if you use gnu's tar, consider using \-\-tar\-args "\-\-format=ustar").
.SH "SEE ALSO"
.LP 
gpg(1), tar(1)