Koji Arai
jca02****@gmail*****
2008年 2月 21日 (木) 03:21:48 JST
Fork新井です。こんにちは。
先日、SuSE Linux の lha パッケージのメンテナであるらしいStanislav Brabecさんが
既存の英文マニュアルをパッチとして送ってくださいました。
ですが、それはGPLでライセンスされてました。私としてはできればMITやBSDのような
軽いライセンスが好みなのでライセンスを変更できないか原著者と話したのですが、
承諾されませんでした。
そこで、Stanislav さんが英文についてレビューしてくださるとのことなので、自分で一から
書いてStanislavさんに送りました。
・・・のですが Stanislav さんからその後音沙汰がありません。
このまま埋もれさせるのもいやなので思い切って衆目にさらしてみます。（といってもいきなり
リポジトリに入れる勇気はないのでメールです。）
本題ですが、どなたか下記マニュアルの英文や内容についてご意見あるかたいますか？
LHa for UNIX を Oldish compressor and archiver っとするのはあんまりなのかなあとか、
HISTORYの項は主観が入ってるかなあとかいろいろと不安があります。
英文を直接直してもよいし、日本語でのご意見でも問題ないのでなにか思うところがあるかたは
コメントください。
# ご存知の通り(?)、私は英作文は苦手です。(TOEIC は、300点台です。恥ずかしい)
本メールの添付ファイルには nroff 形式のファイルを付けています（マニュアル自体のライセン
スもこちらに明記してます。MITライセンスです）。
コメントがもらえやすいようにプレインテキストを以下に付けてますので、
こちらを参照して自由にご意見ください。
LHA(1) User Commands LHA(1)
NAME
LHa for UNIX - Oldish compressor and archiver.
SYNOPSIS
lha [-]command[options] [-options ...] archive_file.lzh [files...]
Create an archive
lha c archive_file.lzh files or directories.
Extract the archive
lha x archive_file.lzh [specific files]
List the archive
lha l archive_file.lzh [specific files]
or
lha archive_file.lzh [specific files]
DESCRIPTION
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.
COMMANDS
-c, -a Specified files are compressed and archived into an archive
file. When the directory path is specified, files under the
directory are archived recursively.
The -c command creates new archive. When the archive file
already exists, it is overwritten. The -a command creates new
archive or appends to existent archive.
-x, -e The -x command extracts uncompressed files from the archive
file. When the specific_files is specified, Only these files or
directories are extracted. The -e command is synonym of -x.
-l, -v The -l command lists the contents of archive to stdout. the -v
command is more verbosely command. The term of list is below.
PERMISSION
For the Unix specific archive, it is permission string
like ls(1). For the others, it is the string of OS type.
UID/GID
For the Unix specific archive, it is user-id and group-
id. For the others, it is space only.
PACKED The size of compressed file. it is shown by the -v com-
mand.
SIZE The original file size.
RATIO Compressed ratio (PACKED / SIZE * 100).
METHOD The string of the compressing method. it is shown by the
-v command.
-lh0- no compressed.
-lzs- 2k sliding dictionary (created by the LArc)
-lz4- no compressed. (created by the LArc)
-lz5- 4k sliding dictionary (created by the LArc)
-lh1- 4k sliding dictionary and dynamic Huffman encod-
ing.
-lh2- 8k sliding dictionary and dynamic Huffman encod-
ing.
-lh3- 8k sliding dictionary and static Huffman encod-
ing.
-lh4- 4k sliding dictionary and static Huffman encod-
ing.
-lh5- 8k sliding dictionary and static Huffman encod-
ing.
-lh6- 32k sliding dictionary and static Huffman encod-
ing.
-lh7- 64k sliding dictionary and static Huffman encod-
ing.
-lhd- directory
The LHa for Unix is able to create the methods -lh0-, -lh1-,
-lh5-, -lh6-, -lh7- and -lhd-.
CRC The CRC-16 code. It is shown by the -v command.
STAMP The timestamp of the file. It is shown the full-time for-
mat with the -v option.
LV The header level. It is shown by the -v option.
The level 0 and 1 are deprecated. The level 2 header is
widely used. The level 3 header is more improved, how-
ever, it is rarely used.
The LHa for Unix is able to create the 0, 1 and 2. (level
3 is readable)
NAME Filename or directory name.
-u, -m The -u command updates the archive. When the specified files
newer than the content of the archive, it is replaced. The -m
command always replace with the specified files.
-d The -d command delete the specified files from the archive.
-p The -p command print the content of the archived files to std-
out. Each contents are printed with filename as header string
like below.
::::::::
filename
::::::::
contents of the file.....
The header string is omitable by the -q option.
-t The -t command same as the -x command except to non-extract
actually. This command is used to check the archive file.
OPTIONS
-q[num]
The -q option specify the level of quiet mode. num is 0, 1, 2 or
nothing.
The -q0 option is default level. The -q1 option inhibit to show
the extracting indicator(progressing meter?). The -q2 option
inhibit to show the other output decoration. this option has the
effects of the -f option. The -q is same as -q2.
-v When listing with the -l or the -v command, the -v 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.
Special case, the -v command trailing two -v options like, lha
vvv archive_file.lzh show the header dump. This feature is for
debugging.
-n The -n option display the message instead of doing the command
action.
-f Force extraction. When the extract file is already exists, nor-
mally, lha ask the Overwriting, or Skipping or All files skip-
ping. This option always make to overwrite without the asking.
-t The -t 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 -e option, KANJI code in extracting
files are converted.
-o[5-7]
When archiving, the -o option specified the compressing method.
the -o5 means to use the -lh5- method. It is widely used and
default method. the -o6 and -o7 means to use the -lh6- and
-lh7- method. These methods reduced archive file more than the
-lh5- method. Just the -o means to use the -lh1- method.
It is possible to include some methods in an archive file.
-d When archiving, specified files are removed from the disk.
-i When extracting, ignore the directory path. extracting file is
put flatten on the current directory.
-z When archiving. no compress the specified file. (archive with
the -lh0- method)
-g When extracting, this option is nothing to do. this is histori-
cal 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.
-0, -1, -2
The -0, -1 and -2 option is specified the format of the header
version (called the header level).
-e When archiving, the -e option regard the coding of text as EUC-
JP and convert it to Shift_JIS. When extracting, convert from
Shift_JIS to EUC-JP.
-b When extracting, If it is possible, the MacBinary is inter-
preted. This option is experimental.
-w=dir When extracting, extract files are create in the dir directory.
equal mark is omittable like, -w dir.
-x=pattern
When archiving, exclude files matched the glob pattern pattern.
This option is able to specify any times in a command line.
equal mark is omittable like, -x pattern.
LONG OPTIONS
--archive-kanji-code={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.
The utf8 is possible to specify using iconv library.
--system-kanji-code={euc,sjis,utf8,cap,none}
This option specify the filename encoding on the filesystem.
Default is euc as EUC-JP.
The utf8 is possible to specify using iconv library.
--extract-broken-archive
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.
--convert-filename-case
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.
It was default behavior on the old version of the LHa for UNIX.
However, many software create the LZH archive with case-sensi-
tive filename even if it is a MS-DOS type archive. Therefore,
its behavior was deprecated as default.
--ignore-mac-files
When archiving, the Mac specific files are ignored.
This option is same as the `-x "._*" -x ".DS_Store" -x
"Icon\r"'.
--traditional
Turn on the compatible mode for the old version. For now, same
as the --convert-filename-case.
--help Show the briefly usage.
--version
Show the version string.
SEE ALSO
zip(1), unzip(1), gzip(1), gunzip(1), zcat(1)
AUTHORS
Koji Arai
HISTORY
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)
Haruyasu Yoshizaki developed the LZHUFF (it was experimental code with
the LZSS and the Huffman coding), and developed the LHarc version 1.00.
In 1989, the LHarc was ported on UNIX by Yoichi Tagawa.
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.
In 1991, Haruyasu Yoshizaki improved the LHx and renamed to the LHa,
and renamed again to the LHA.
In Japan, This version (LHA 2.10 - 2.13) was widely used on MS-DOS and
MS-Windows. Many software and many documents are distributed with this
archive format.
In 1992, It was ported on UNIX by Masaru Oki. It was called the LHa for
UNIX, and it was improved by Nobutaka Watazaki, Tsugio Okamoto and many
users.
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.
BUGS
The extracting code of the -lzs- method was broken. But it is not prob-
lem 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.
LHa for UNIX February 2008 LHA(1)
--
Koji Arai
-------------- next part --------------
テキスト形式以外の添付ファイルを保管しました...
ファイル名: lha.1.gz
型: application/x-gzip
サイズ: 4371 バイト
説明: 無し
下载