From: davidsen@crdos1.crd.ge.COM (Wm E Davidsen Jr) Newsgroups: alt.sources Subject: shar2 man pages Message-ID: <2242@crdos1.crd.ge.COM> 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 wht@n4hgf.gatech.edu. 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:MAILER-DAEMON@gatech.edu Subject: Returned mail: Service unavailable To: davidsen ----- Transcript of session follows ----- >>> HELO gatech.edu <<< 553 gatech.edu I refuse to talk to myself 554 ... 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: davidsen@crdos1.crd.ge.com 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: davidsen@crdos1.crd.ge.com To: wht@n4hgf.gatech.edu 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, (davidsen@sixhub.uucp). 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 (davidsen@crdos1.crd.GE.COM -or- uunet!crdgw1!crdos1!davidsen) "Stupidity, like virtue, is its own reward" -me --- End of forwarded message from anonymous -- bill davidsen (davidsen@crdos1.crd.GE.COM -or- uunet!crdgw1!crdos1!davidsen) "Stupidity, like virtue, is its own reward" -me