<html><head><title>par</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >
</head>
<body class='pod'>
<!--
generated by Pod::Simple::HTML v3.01,
using Pod::Simple::PullParser v2.02,
under Perl v5.008002 at Thu Aug 5 13:56:18 2004 GMT.
If you want to change this HTML document, you probably shouldn't do that
by changing it directly. Instead, see about changing the calling options
to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
then reconverting this document from the Pod source.
When in doubt, email the author of Pod::Simple::HTML for advice.
See 'perldoc Pod::Simple::HTML' for more info.
-->
<!-- start doc -->
<a name='___top' class='dummyTopAnchor' ></a>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>
<p>par - create a Perl archive of files</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>
<p><b>par</b> [-s submitter] [-STBqvz] file [files...]</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>
<p><b>par</b> creates a Perl archive of the <i>files</i> on the command line.
The Perl archive is a Perl script,
and executing it will recreate the <i>files</i>.
If any of the <i>files</i> include a path,
directories in that path will also be recreated.
If any of the <i>files</i> is a directory,
the contents of that directory will be archived.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="OPTIONS"
>OPTIONS</a></h1>
<p><b>par</b> automatically determines if files are text or binary unless <b>-B</b> or <b>-T</b> is used.</p>
<dl>
<dt><a name="-B"
>-B</a></dt><p class="pad"></p>
<dd>All files are binary.
Encode files with <b>uuencode</b>.
<b>uudecode</b> will be required to recover the files.</dd><p class="pad"></p>
<dt><a name="-S"
>-S</a></dt><p class="pad"></p>
<dd>Read standard input for files,
one file per line,
as though they were included on the command line.
For example:</dd><p class="pad"></p>
<pre lang='und' xml:lang='und'> find . -name 'chapter[1-9].txt' -print | par -S > story.par</pre>
<dt><a name="-T"
>-T</a></dt><p class="pad"></p>
<dd>All files are text. No encoding necessary.</dd><p class="pad"></p>
<dt><a name="-s_submitter"
>-s submitter</a></dt><p class="pad"></p>
<dd>Use <i>submitter</i> for the email address included in the <b>par</b> header.</dd><p class="pad"></p>
<dt><a name="-q"
>-q</a></dt><p class="pad"></p>
<dd>Shhh!</dd><p class="pad"></p>
<dt><a name="-v"
>-v</a></dt><p class="pad"></p>
<dd>Print version info and exit.</dd><p class="pad"></p>
<dt><a name="-z"
>-z</a></dt><p class="pad"></p>
<dd>Mimic <b>shar</b>. Create a shell archive instead of a Perl archive.</dd><p class="pad"></p>
</dl>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="NOTES"
>NOTES</a></h1>
<p>Renaming or linking <b>par</b> to <code lang='und' xml:lang='und'>shar</code> will cause it to create shell scripts:</p>
<pre lang='und' xml:lang='und'> ln par shar
shar moogle.txt > moogle.shar</pre>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SEE_ALSO"
>SEE ALSO</a></h1>
<p><b>shar</b>, <b>unpar</b>, <b>uuencode</b></p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="AUTHOR"
>AUTHOR</a></h1>
<p>Tim Gim Yee | tgy@chocobo.org | I want a moogle stuffy!</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="COPYRIGHT"
>COPYRIGHT</a></h1>
<p>Copyright (c) 1999 Moogle Stuffy Software. All rights reserved.</p>
<p>You may play with this software in accordance with the Perl Artistic License.</p>
<!-- end doc -->
</body></html>