.TH LHA "1" "February 2008" "LHa for UNIX" "User Commands"
.SH NAME
-LHa for UNIX \- Oldish compressor and archiver.
+LHa for UNIX \- Traditional compressor and archiver.
.SH SYNOPSIS
The LHa for UNIX is an archiver and compressor using the LZSS and the Huffman encoding compression algorithm.
It is possible to create the archive file called the "LZH" file, and possible to extract it.
-It is possible to extract the self-extracting archive file called the SFX file. (It is mainly created on the MS-DOS and the MS-Windows), but impossible to create it.
+It is possible to extract the self-extracting archive file called the SFX file (mainly created on the MS-DOS and the MS-Windows), but impossible to create it.
.SH COMMANDS
.TP
\fB\-l\fR, \fB\-v\fR
-The \fB\-l\fR command lists the contents of archive to stdout. the \fB\-v\fR command is more verbosely command.
+The \fB\-l\fR command lists the contents of archive to stdout. The \fB\-v\fR command is more verbosely command.
The term of list is below.
.RS
.TP
PERMISSION
-For the Unix specific archive, it is permission string like ls(1).
+For the Unix specific archive, it is permission string like \fBls\fR(1).
For the others, it is the string of OS type.
.TP
UID/GID
The level 0 and 1 are deprecated. The level 2 header is widely used.
The level 3 header is more improved, however, it is rarely used.
-The LHa for Unix is able to create the 0, 1 and 2. (level 3 is readable)
+The LHa for Unix is able to create the 0, 1 and 2. (Level 3 is readable.)
.TP
NAME
.RE
.TP
-\fB\-u\fR, \fB\-m\fR
-The \fB\-u\fR command updates the archive. When the specified files newer than the content of the archive, it is replaced.
-The \fB\-m\fR command always replace with the specified files.
+\fB\-u\fR
+The \fB\-u\fR command updates the archive. When the specified files are newer than the content of the archive, they are replaced.
+The \fB\-a\fR command always replace with the specified files.
+
+.TP
+\fB\-m\fR
+The \fB\-m\fR command moves specified files into the archive.
+It is same as the \fB\-ad\fR (\fB\-a\fR command and \fB\-d\fR option).
.TP
\fB\-d\fR
::::::::
contents of the file.....
-The header string is omitable by the \fB\-q\fR option.
+If you wish to non-display the header string, use with the \fB\-q\fR option.
.TP
\fB\-t\fR
-The \fB\-t\fR command same as the \fB\-x\fR command except to non-extract actually.
+The \fB\-t\fR command is the same as the \fB\-x\fR command except to non-extract actually.
This command is used to check the archive file.
.SH OPTIONS
.TP
\fB\-q\fR[\fInum\fR]
-The \fB\-q\fR option specify the level of quiet mode. \fInum\fR is 0, 1, 2 or nothing.
+The \fB\-q\fR option specifies the level of quiet mode. \fInum\fR is 0, 1, 2 or nothing.
The \fB\-q\fR0 option is default level.
-The \fB\-q\fR1 option inhibit to show the extracting indicator(progressing meter?).
-The \fB\-q\fR2 option inhibit to show the other output decoration. this option has the effects of the \fB\-f\fR option.
+The \fB\-q\fR1 option inhibits the extracting indicator (progress bar).
+The \fB\-q\fR2 option inhibits other output decoration. this option has the effects of the \fB\-f\fR option.
The \fB\-q\fR is same as \fB\-q\fR2.
.TP
\fB\-v\fR
When listing with the \fB\-l\fR or the \fB\-v\fR command, the \fB\-v\fR option lists more verbosely.
-Each elements are listed one file per two line. The first line show the filename, following line show other elements added the timestamp (full-time format) and the header level.
+Elements are listed one file per two lines. The first line shows the filename, following line shows other elements and the timestamp (full-time format) and the header level.
-Special case, the \fB\-v\fR command trailing two \fB\-v\fR options like,
+In special case, the \fB\-v\fR command trailing two \fB\-v\fR options like,
lha vvv archive_file.lzh
-show the header dump. This feature is for debugging.
+shows the header dump. This is a debugging feature.
.TP
\fB\-n\fR
-The \fB\-n\fR option display the message instead of doing the command action.
+The \fB\-n\fR option displays the message instead of doing the command action.
.TP
\fB\-f\fR
-Force extraction. When the extract file is already exists,
-normally, lha ask the Overwriting, or Skipping or All files skipping.
-This option always make to overwrite without the asking.
+Force extraction. When extracted file already exists,
+normally, lha asks for the Overwriting, or Skipping or All files skipping.
+This option forces overwrite without asking.
.TP
\fB\-t\fR
-The \fB\-t\fR option treats extracting files as text file.
-CR codes on the end of each lines are removed. (convert DOS format text to UNIX format text)
-With the \fB\-e\fR option, KANJI code in extracting files are converted.
+The \fB\-t\fR option treats archiving or extracting files as text files.
+When extracting, CR codes on the end of each lines are removed. (convert DOS format text to UNIX format text)
+When archiving, oppositely, CR codes append on the end of each lines. (convert UNIX format text to DOS format text)
+With the \fB\-e\fR option, KANJI code are converted as well.
.TP
\fB\-o\fR[5\-7]
-When archiving, the \fB\-o\fR option specified the compressing method.
+When archiving, the \fB\-o\fR option specifies the compressing method.
the \fB\-o\fR5 means to use the \-lh5\- method. It is widely used and default method.
the \fB\-o\fR6 and \fB\-o\fR7 means to use the \-lh6\- and \-lh7\- method.
These methods reduced archive file more than the \-lh5\- method.
.TP
\fB\-z\fR
-When archiving. no compress the specified file. (archive with the \-lh0\- method)
+When archiving, do not compress the specified file. (archive with the \-lh0\- method)
.TP
\fB\-g\fR
-When extracting, this option is nothing to do. this is historical reason.
+When extracting, this option does nothing. It exists for historical reason.
-When archiving, this option is archived with general (obsolete) header format.
-It is used the level 0 header, filename is uppercased in archive, no saved the Unix specific elements such as permission, user-id and so on.
+When archiving with this option, archive with general (obsolete) header format.
+It uses the level 0 header, filename is uppercased in the archive,Unix specific elements such as permission, user-id and so on are not saved.
.TP
\fB\-0\fR, \fB\-1\fR, \fB\-2\fR
-The \-0, \-1 and \-2 option is specified the format of the header version (called the header level).
+The \-0, \-1 and \-2 option specifies the version of the format header (called the header level).
.TP
\fB\-e\fR
\fB\-w\fR=\fIdir\fR
When extracting, extract files are create in the \fIdir\fR directory.
-equal mark is omittable like, \-w dir.
+An equal mark is omittable like, \-w dir.
.TP
\fB\-x\fR=\fIpattern\fR
When archiving, exclude files matched the glob pattern \fIpattern\fR.
-This option is able to specify any times in a command line.
+It is possible to use this option anywhere in the command line.
-equal mark is omittable like, \-x pattern.
+An equal mark is omittable like, \-x pattern.
.SH LONG OPTIONS
.TP
\fB\-\-archive\-kanji\-code\fR={euc,sjis,utf8,cap,none}
-On LZH file, specifying the filename encoding in archive is not ruled.
-However, In Japan, Shift_JIS is defacto standard, so the LHa for UNIX is saved with Shift_JIS. this option is able to change it.
+Specifies the multi-byte encoding of the archived pathname.
+
+Default is sjis as Shift_JIS.
-The utf8 is possible to specify using iconv library.
+On LZH file, the encoding of pathname in archive is not ruled.
+However, In Japan, Shift_JIS (exactly Windows-31J) is defacto standard.
.TP
\fB\-\-system\-kanji\-code\fR={euc,sjis,utf8,cap,none}
-This option specify the filename encoding on the filesystem.
+This option specifies the encoding of the pathname on the filesystem.
Default is euc as EUC-JP.
-The utf8 is possible to specify using iconv library.
-
.TP
\fB\-\-extract\-broken\-archive\fR
-When extracting, If CRC error is occurred and its archive is created by old version of LHa for UNIX, this option may be last resort.
+If CRC error occurrs when extracting, and its archive is created by old version of LHa for UNIX, this option may be last resort.
.TP
\fB\-\-convert\-filename\-case\fR
When extracting, the archive format is MS-DOS or Generic, and the
-whole of the filename (and directory name) is uppercase, extracted
-filename make to be small capital.
+whole filename (and directory name) is uppercase, extracted
+filename will be in lowercase.
It was default behavior on the old version of the LHa for UNIX.
However, many software create the LZH archive with case-sensitive filename even if it is a MS-DOS type archive.
Therefore, its behavior was deprecated as default.
.TP
+\fB\-\-timestamp\-archive\fR
+When archiving or deleting, the archive timestamp reset most recent timestamp in the archive contents.
+
+.TP
\fB\-\-ignore\-mac\-files\fR
When archiving, the Mac specific files are ignored.
Show the version string.
.SH SEE ALSO
-zip(1), unzip(1), gzip(1), gunzip(1), zcat(1)
+\fBzip\fR(1), \fBunzip\fR(1), \fBgzip\fR(1), \fBgunzip\fR(1), \fBzcat\fR(1)
-.SH AUTHORS
-Koji Arai
+.SH AUTHOR
+Koji Arai <arai@users.sourceforge.jp>
.SH HISTORY
-In 1988, Haruhiko Okumura developed the LZARI. it was experimental implementation used the LZSS and the arithmetic coding.
+In 1988, Haruhiko Okumura developed the LZARI. It was experimental implementation used the LZSS and the arithmetic coding.
Kazuhiko Miki developed the LArc. (it was used the \-lzs\- method)
Haruhiko Okumura and Haruyasu Yoshizaki improved the algorithm of the LHarc.
In 1990, the LHx 2.00 which is the LHarc improvement was implemented by Haruyasu Yoshizaki.
-
-The ar002 was implemented by Haruhiko Okumura. It is distributed as the Public Domain Software (the ar002.exe is the SFX file).
-
-http://oku.edu.mie-u.ac.jp/~okumura/compression/ar002.exe.
-
-Note that it has security problems CVE-2006-4335, 4337 and 4338.
+The ar002 was implemented by Haruhiko Okumura. It is distributed as the Public Domain Software.
In 1991, Haruyasu Yoshizaki improved the LHx and renamed to the LHa, and renamed again to the LHA.
The LHa for UNIX was used to exchange files for MS-DOS world, and its source codes might be used interestingly and implement another LZH archiver.
However, its license is vague. so it is not recognized as the Open Source Software defined by the Open Source Initiative.
-
-.SH BUGS
-
-The extracting code of the \-lzs\- method was broken. But it is not problem that is not used for long time.
-
-The LHa for UNIX expects the sorted contents by filename in the LZH archive (like the LHarc), but the LHA (for MS-DOS) does not.