User's Manual for High-Performance File-Compression Program

			  LHarc Version 1.13c
				05/31/89


	   Copyright (c) Haruyasu Yoshizaki (Yoshi), 1988-89


(This manual is dramtically shortend, use it as an "emergency-manual"
if you recieived LHarc with no docs)

1. How to Use It:

   Just type "LHarc" to see a concise help screen of the program's
   command structure.


   Command-line synopsis:
   ======================

   LHarc [<command>] [{{/|-}{<switch>[-|+|2|<option>]}}...] <archive_name>
	 [{<drive_name>:}|{<home_directory_name>\}] [<path_name> ...]

   Only a single command can be specified on the command line, but a
   group of switches can be specified together after the '/' or '-'
   delimiter.  You may place switch(es) anywhere following the command.

   Hitting 'Ctrl-Break' or 'Ctrl-C' at any time will abort LHarc's
   current operation and return you to the DOS prompt.

   Commands:
   =========

   a (Add files to archive)

     LHarc a ARCHIVE.LZH file1.ext

	Adds 'file1.ext' to 'ARCHIVE.LZH'.  If 'ARCHIVE.LZH' does
	not exist, then LHarc will create it.  If a file with the
	name 'file1.ext' already exists in the archive, LHarc will
	replace it with the specified file.

   u (Update files to archive)

     LHarc u ARCHIVE.LZH file1.ext

	Adds 'file1.ext' to 'ARCHIVE.LZH', the same as with the 'a'
	command.  However, if 'file1.ext' already exists in the
	archive, LHarc will check its time stamp and will keep the
	newer one and ignore the older one.  (Use the /c switch to
	tell LHarc to skip this time-stamp comparison.)

   m (Move new files into archive)

     LHarc m ARCHIVE.LZH file1.ext

	is equivalent to

     LHarc u ARCHIVE.LZH file1.ext
     DEL file1.ext

	Beware the fact that the second line is implicit.  You might
	lose 'file1.ext' forever.

   f (Freshen files in archive)

     LHarc f ARCHIVE.LZH file1.ext

	Replaces 'file1.ext' in 'ARCHIVE.LZH' with the newer one
	only if a file with this name already exists in the archive.
	Otherwise, no action is taken.	(Use the /c switch to tell
	LHarc to skip this time-stamp comparison.)

   e or x (EXtract files from archive)

     LHarc e ARCHIVE.LZH d:\temp\

	Extracts all the files from 'ARCHIVE.LZH
	directory \temp\ on drive D:.  

     LHarc e ARCHIVE.LZH file1.ext

	Extracts only 'file1.ext' from 'ARCHIVE.LZH'.  If a file
	with the name 'file1.ext' exists in the home directory,
	LHarc will compare their time stamps and if the existing
	file is older, then LHarc will prompt you whether to
	overwrite it.  (Use the /c switch to tell LHarc to skip this
	time-stamp comparison.)


   p (disPlay files in archive)

     LHarc p ARCHIVE.LZH file1.ext

	Extracts 'file1.ext' from 'ARCHIVE.LZH' and redirects it to
	standard output.


   d (Delete files from archive)

     LHarc d ARCHIVE.LZH file1.ext

	Deletes 'file1.ext' from 'ARCHIVE.LZH'.

   l (List files in archive)

     LHarc l ARCHIVE.LZH

	Lists information about all the files in 'ARCHIVE.LZH':
	name, original size, stored size, etc. Each file takes one
	line of output.  A '+' before a file name indicates that a
	directory name is stored with the file name. 

   v (View list of files in archive)

     LHarc v ARCHIVE.LZH

	Lists information about all the files in 'ARCHIVE.LZH',
	except that each listing takes two lines: the first for the
	full path name and the second for the rest of the
	information.  

   t (Test integrity of archive)

     LHarc t ARCHIVE.LZH

	Tests the integrity of 'ARCHIVE.LZH' by running a CRC check
	on each file and comparing the result against the file's
	stored CRC value.


     LHarc ARCHIVE.LZH

	Acts exactly the same as the 'x' command.  This optional
	action is temporary.  Don't count on it in future versions.

   Switches:
   =========

   Specify switch(es) following the switch delimiter '/' or '-'.  If
   you want to specify more than one switch, type characters
   continuously without any intervening spaces, like "/rx-we:\work" or
   "/cxvless".	When the 'v' and 'w' switches are used with other
   switches, they must be specified at the end of a sequence, as shown
   in the above examples.

   You may place a '+' or '-' sign after switches, with the following
   meanings: '+' turns the switch on and '-' turns the switch off.
   The '2' creates a special option for the /r and /v switches (see
   below).  If you just specify /<switch> without '+' or '-', then
   <switch> will be toggled from 'on' to 'off' or vice versa, e.g., to
   override any switch set in an environment variable (see below).

   NOTE:  Use only lowercase letters for switches.  Capital letters
	  are reserved for future use.


     /x[-|+] (allow eXtended file names)

	By default, LHarc stores only the file names of archived
	files and disregards the names of the directory(s) in which
	they reside.  This switch tells LHarc to extend all file
	names with directory names and to extract archived files
	together with their stored directory names.


     /p[-|+] (distinguish full Path names)

	By default, LHarc disregards directory names when extracting
	files.	This switch tells LHarc to distinguish files by full
	path name during un-archiving.


     /c[-|+] (skip time-stamp Comparison)

     LHarc [e|f|u|x] /c ARCHIVE.LZH [file1.ext file2.ext ...]

	If a file with the same name is to be created, LHarc will
	default to comparing the time stamp of each pair of files,
	and so some files will be overwritten and some just ignored.
	This switch tells LHarc to overwrite any existing files with
	extracted ones with the same name.


     /m[-|+] (no Message for query)

     LHarc [<command>] /m ARCHIVE.LZH [file1.ext file2.ext ...]

	By default, before operations that alter files or
	directories, LHarc will query you with messages like
	"Overwrite? [Y/N]".  This switch suppresses these messages
	and tells LHarc to proceed as if "y" is typed in.


     /a[-|+] (allow any Attribute of files)

     LHarc a /a ARCHIVE.LZH file1.arc

	adds 'file1.arc' to 'ARCHIVE.LZH'.

	By default, LHarc will not archive files with the hidden,
	read-only or system attribute.	This switch tells LHarc
	also to archive files with these attributes.


     /r[-|+|2] (Recursively collect files)


     LHarc has three modes of collecting the files to be archived:

	(a) specified file(s):	/r-

	    LHarc a /r- ARCHIVE.LZH file1.ext [file2.ext ...]

		 Adds to 'ARCHIVE.LZH' only the specified files
		 (default mode).

	(b) across directories:  /r or /r+

	    LHarc a /r ARCHIVE.LZH *.c

		 Adds to 'ARCHIVE.LZH' all the files with
		 extension .C on the current drive, starting
		 from the current directory.  LHarc will store
		 all file names extended with directory names.
		 Use this switch to archive all versions of a
		 file or all files of a certain type.

	(c) specified directory(s):  /r2

	    LHarc a /r2 ARCHIVE.LZH \doc

		 Adds to 'ARCHIVE.LZH' all the files in the
		 directory specified by the path \doc and its
		 branches, similar to the Unix -r option.  Use
		 this switch to archive complete directories.

	The /r and /r2 switches set the /x switch simultaneously.
	You may have to toggle the /x switch off (with /x-) after
	using /r or /r2.  The /x- switch tells LHarc to disregard
	stored directory names.


     /w[-|+|<directory_name>] (set Working directory)

     LHarc a /w[d:\temp] ARCHIVE.LZH [file1.ext file2.ext ...]

	Creates all the temporary files for 'ARCHIVE.LZH' in the
	directory \temp\ on drive D:.  If no directory name is
	specified with this switch, then the current directory
	becomes the working directory and all the temporary files
	created in the process of archiving will reside in this
	directory and be deleted afterward.

     Use the /w switch when

	(1) you have no room in the directory where the archive is,
	    or
	(2) you want your work done silently and swiftly on a RAM
	    disk.

	This switch overrides the working directory that may be
	specified in an environment variable (see below).


     /v[-|+|2|<utility_name>] (View file by another utility)

     LHarc p /v ARCHIVE.LZH file1.ext

	Extracts 'file1.ext' from 'ARCHIVE.LZH' and invokes the
	default utility LESS for formatted display to standard
	output.

	LHarc first creates an un-archived file 'LHARC.TMP' and then
	invokes the specified utility, usually a page formatter like
	LIST.PRG or SEE.PRG.  

     /n[-|+] (No Indicator)

	Suppress progress display oooo... in the process of
	archiving and de-archiving.  The display is on the standard
	error stream so that the dsiplay is on even in the process
	of redirection.

     /t[-|+] (Time Stamp)

	Update the time stamps of Archive to the newest file in the
	archive, effective with switches (a,u,m,f,d).

     /l	     (Generate Larc-style-archive)

	The file is compressed without Huffman, the code will be about
        5% longer than a normal 1.13-archiv but the compression and 
 	decompression is much faster. This is the format used in PFXPAK.
	PFXPAK and Larclib are able to decode this type of files at a 
	rate of about 100KB per second.

     /o      (Generate LHarc 1.13-style-archvie)

	Using this switch tells LHarc to use compression-method used in 
	LHarc 1.13. Use this switch, if the archive may be extracted on
	other machines than atari st or ibm pc.

     /k      (Generate compatible headers)

	LHarc 2.x automatically generates an extended-header of size 
	Zero. Some versions of LHarc may not be able to extract files
	with extended headers. Using -ok will gernerate full compatible
	archives.

     /u     (Store without compression)

	The files are stored to the archiv without compression.
	

   Home directory name (drive name):
   =================================

   If you specify a home directory name, then LHarc will refer to that
   directory as if it is the current directory.  Specify a home
   directory name ending with either '\' or ':'.  All files will be
   archived without storing this directory name unless you also use the
   /r or /x switch.


   File name (path name):
   ======================

   The file names or path names of files to be archived must be
   specified or else LHarc will assume *.* with no directory names.
   The wildcards '*' and '?' behave exactly as in DOS.	You cannot use
   them to specify directories except with the /r2 switch, similar to
   the Unix -r option for cp, mv and rm.


2. Setting Switches in an Environment Variable

   You may set any of LHarc's default switches with the environment
   variable 'LHARC':

     SET LHARC=/we: /r2

	will set drive E: as the working directory and archive all
	files in directory mode.

   You may also specify LHarc's working directory with the environment
   variable 'TMP':

     SET TMP=E:

	but the /w switch will override this setting.


5. Result Codes

   LHarc returns the following result codes to the parent process:

	0   Normally finished.

	1   Process finished with nonexistent file names ignored
	    during archiving or CRC error occurred during
	    un-archiving.

	2   Process terminated by fatal error; no archive created
	    or files moved.

	3   Unable to write temporary files into the archive.  Work
	    file renamed to 'LHARC.)2(' and original archive
	    deleted.  Try renaming LHARC.)2( as your archive,
	    although it might be damaged.


6. Temporary Files

	LHARC.)1(   Original archive, renamed.
	LHARC.)2(   Work file used to create new archive.
	LHARC.TMP   Work file created for viewing by another utility.

   If a file with one of these file names already exists in the working
   directory, then the behavior of LHarc is unpredictable.

7. My Distribution Policy

   Under the following conditions, you may freely copy and distribute
   this software:

   1. Under all circumstances, "Copyright by Haruyasu Yoshizaki"
      must be attached to the copy.

   2. The manual LHarc.MAN or its hardcopy should go together with the
      software. (Not this short version!)

   3. You may modify the program, but in that case, you must distri-
      bute the complete source code for the program, including your
      specific contributions and you must make it clear that you
      have made such modifications.

   4. You must try to distribute the latest version available.

   5. I assume no warranty for any claim of damage you may sustain
      by using this software.

   6. I have no obligation to revise the program to correct any
      fault in this software.

   7. For any commercial use of this software, I add the following:

      a. The entire software made incorporating this program should
	 not be copy protected in the sense that the DISKCOPY
	 program of MS-DOS makes an imperfect copy.

      b. Every part of the package should print the name "LHarc" and
	 the copyright banner.

      c. The distribution policy of this software should be printed
	 either in the manual, in the package or on the disk label.

	 Comment:  If a commercial package or a shareware
		   product uses LHarc with self-extracting SFX
		   form for the distribution, then the Copy-
		   right statement must appear with SFX header.
		   I consider this as a claim of LHarc's Banner.