The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

par - create a Perl archive of files

SYNOPSIS

par [-s submitter] [-STBqvz] file [files...]

DESCRIPTION

par creates a Perl archive of the files on the command line. The Perl archive is a Perl script, and executing it will recreate the files. If any of the files include a path, directories in that path will also be recreated. If any of the files is a directory, the contents of that directory will be archived.

OPTIONS

par automatically determines if files are text or binary unless -B or -T is used.

-B

All files are binary. Encode files with uuencode. uudecode will be required to recover the files.

-S

Read standard input for files, one file per line, as though they were included on the command line. For example:

    find . -name 'chapter[1-9].txt' -print | par -S > story.par
-T

All files are text. No encoding necessary.

-s submitter

Use submitter for the email address included in the par header.

-q

Shhh!

-v

Print version info and exit.

-z

Mimic shar. Create a shell archive instead of a Perl archive.

NOTES

Renaming or linking par to shar will cause it to create shell scripts:

    ln par shar
    shar moogle.txt > moogle.shar

SEE ALSO

shar, unpar, uuencode

AUTHOR

This implementation of par was written by Tim Gim Yee, tim.gim.yee@gmail.com.

COPYRIGHT and LICENSE

This program is copyright (c) Tim Gim Yee 1999.

This program is free and open software. You may use, modify, distribute, and sell this program (and any modified variants) in any way you wish, provided you do not restrict others from doing the same.