Source Code 1992 March/Source_Code_CD-ROM_Walnut_Creek_March_1992.iso/usenet/altsrcs/1/1303

Internet Message Format | 1990-12-28 | 7.1 KB

From: [e-mail] (Wm E Davidsen Jr)
Newsgroups: alt.sources
Subject: shar2 man pages
Message-ID: <[e-mail]>
Date: 10 May 90 11:50:52 GMT


  Here are the man pages for shar2. I have tried to send them to the
author of shar3, but his mailer doesn't like him as
[e-mail]. Here they are, perhaps he will modify them for
shar3, and if not they are still a lot better than no man pages at all.

[ this is the rejection notice ]

--- Forwarded mail from anonymous

>From anonymous Wed May  9 13:06:13 1990
Date: Wed, 9 May 90 13:05:18 EDT
>From: exos:[e-mail]
Subject: Returned mail: Service unavailable
To: davidsen

   ----- Transcript of session follows -----
>>> HELO gatech.edu
<<< 553 gatech.edu I refuse to talk to myself
554 <[e-mail]>... Service unavailable: Bad file number

   ----- Unsent message follows -----
Received: from CRDGW1.GE.COM by gatech.edu (5.58/GATECH-8.6)
    id AA14023 for ; Wed, 9 May 90 12:59:27 EDT
Received:  by crdgw1.ge.com (5.57/Ultrix-3.0 1.67)
     id AA06324; Wed, 9 May 90 12:57:20 EDT
Received: by crdos1 id <6484C6D370@crdos1>;
       Wed,  9 May 90 12:59:27 EDT
Message-Id: <6484C6D370@crdos1>
Reply-To: [e-mail]
Organization: GE Corporate R&D Center
Date: Wed, 9 May 90 12:59:23 EDT
X-Mailer: Mail User's Shell (6.5 4/17/89)
>From: [e-mail]
To: [e-mail]
Subject: Man pages for shar2

  Sorry these are delayed, I didn't have them on sixhub. You can add
info on your new stuff and send it out with the next update to
alt.sources.

#!/bin/sh
# shar:    Shell Archiver  (v1.27)
#
#    Run the following text with /bin/sh to create:
#      shar2.1
#      unshar.1
#
echo "x - extracting shar2.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > shar2.1 &&
X'\" must be run through 'tbl' as well as nroff
X.TH SHAR2 1 local
X.SH NAME
Xshar2 - create shell archives
X.SH SYNOPSIS
Xshar2 [ options ] files
X.SH DESCRIPTION
Xshar2 creates "shell archives" (or shar files) which are in text format
Xand can be mailed. These files may be unpacked later by executing them
Xwith /bin/sh.
X.SS Options
X.TS
Xtab(;);
Xlb lw(50).
X-v;T{
Xverbose. This option causes a running commentary as the archive is
Xcreated, and another as it is unpacked. This option does not control the
Xerror messages, only the informational messages.
XT}
X
X-s;T{
Xsum. The files are tested with the \fIsum\fR command for damage in
Xtransit. Errors are reported.
XT}
X
X-x;T{
Xdon't overwrite existing files. The unpack will check for an existing
Xfile before unpacking a given file from the archive.
XT}
X
X-b;T{
Xbinary. This option causes all files to be treated as binary files, and
Xthe files are changed to text using \fIuuencode\fR. Commands are
Xembedded in the output files to change use uudecode and recreate the
Xbinary files.
XT}
X
X-M;T{
Xmixed text and binary.  This option causes each file to be
Xexamined to determine if it is text or data.  Binary files will be
Xprocessed using uuencode.
XT}
X
X-D;T{
Xgive detail of archive. The date, user, and working directory are added
Xto the archive as comments.
XT}
X
X-c;T{
Xproduce cut line. This option causes a line saying "cut\ here" to be
Xplaced at the start of each output file. This is for sites not offering
Xthe \fIunshar\fR command or shell script.
XT}
X
X-f;T{
Xfilename only. By default the entire path name is used as given on the
Xcommand line. This option causes only the file names to be used, which
Xis useful when building a shar from several directories, or another
Xdirectory.
XT}
X
X-dXXX;T{
Xchange delimiter to XXX. The default delimiter is SHAR_EOF, placed at
Xthe end of each file. This option is left for historical reasons, to
Xamuse those who want their shar files to be personalized.
XT}
X
X-o\fIfile\fR;T{
Xoutput filename. The file \fIfile\fR is used for output instead of the
Xstandard output. This option is required to use the \fB-l\fR (limit
Xfilesize) option.
XT}
X
X-l\fInum\fR;T{
Xfile size limit. The output files created by \fIshar2\fR will be smaller
Xthan \fInum\fRk in length. The \fB-o\fR option must be used to specify
Xan output filename, and the digits 00 through 99 will be appended to
Xform a series of output filenames. Informative messages and sequence
Xchecking are included.
XT}
X.TE
X.SH EXAMPLES
X'\"  examples use spaces, not tabs
X  shar2 *.c > cprog.shar        # all C prog sources
X  shar2 -v *.[ch] > cprog.shar  # verbose, .c and .h files
X  shar2 -b -l28 -oarc.sh *.arc  # all binary .arc files, into
X                                # files arc.sh01 thru arc.shNN
X  shar2 -f /lcl/src/u*.c > u.sh    # use only the filenames
X.SH WARNINGS
XUse of the \fB-s\fR, \fB-b\fR, and \fB-M\fR options will slow the
Xarchive process considerably, depending on the number of files.
X.SH FILES
XTemp files ._temp_ and ._seq_ are created and delted as needed.
X.SH SEE ALSO
Xunshar or unshar.sh.
X.SH DIAGNOSTICS
XError messages for missing or unaccessable files.
X.SH LIMITATIONS
XDoes not chase directory names, limited to the number of names on a
Xcommand line. Uses the \fIfile\fR command to determine file type, may be
Xaffected by its limitations. The -D option calls the \fIdate\fR,
X\fIwho\ am\ i\fR, and \fIpwd\fR commands, and will produce garbage if
Xthey are not present.
X.sp
XRequires the \fIuudecode\fR program to unpack binary files. On some
Xsystems, such as Sun, this program requires world write on the current
Xdirectory.
X.sp
XThe first file archived may not have a name starting with a hyphen, and
Xif the file type is being set manually (-p) no file may be named
X\fB-t\fR or \fB-b\fR. Option parsing should be done with getopt.
X.SH AUTHOR
XBill Davidsen, ([e-mail]).
X.SH COPYRIGHT
XCopyright 1988 by Bill Davidsen. This program and documentation may be
Xused by any person for any purpose.
SHAR_EOF
chmod 0666 shar2.1 || echo "restore of shar2.1 fails"
echo "x - extracting unshar.1 (Text)"
sed 's/^X//' << 'SHAR_EOF' > unshar.1 &&
X'\" xxx
X.TH UNSHAR 1 local
X'\" Heading: name(sect)    center (paren)    name(sect)
X.SH NAME
Xunshar - unpack a shar file
X.SH SYNOPSIS
Xunshar file [ file [ file ] ]
X.SH DESCRIPTION
Xunshar scans mail messages looking for the start of a shell archive. It
Xthen passes the archive through a copy of the shell to unpack it. It
Xwill accept multiple files.
X.SH EXAMPLES
X  unshar msg4
X  unshar msg4.*
X.SH WARNINGS
XIf a line in the introduction starts with a ':' or '#' unshar will
Xbecome confused.
X.SH FILES
X.SH SEE ALSO
Xshar, shar2.
X.SH DIAGNOSTICS
XAny message from the shell may be displayed.
X.SH LIMITATIONS
XProblems will occur if the shar file does not end with an exit command.
X.SH AUTHOR
XBill Davidsen (davidsen@sixhub)
X.SH COPYRIGHT
XCopyright 1988 by Bill Davidsen. This program may be used by any person
Xfor any purpose.
SHAR_EOF
chmod 0666 unshar.1 || echo "restore of unshar.1 fails"
exit 0

--
bill davidsen    ([e-mail] -or- uunet!crdgw1!crdos1!davidsen)
            "Stupidity, like virtue, is its own reward" -me


--- End of forwarded message from anonymous


--
bill davidsen    ([e-mail] -or- uunet!crdgw1!crdos1!davidsen)
            "Stupidity, like virtue, is its own reward" -me