5. Uncompression

ebunzip (equivalent to ebzip --uncompress and ebzipinfo --uncompress) uncompresses a CD-ROM book compressed by ebzip.

5.1 Example of Uncompression
5.2 Options for Uncompression
5.3 Uncompress Compressed Book

5.1 Example of Uncompression

Uncompression procedure is closely similar to compression. Suppose that a compressed subbook resides under `/dict'. The book has the following files under `/dict'.

/dict/catalog /dict/language.ebz /dict/kanji/start.ebz /dict/english/start.ebz

Execute the following command to uncompress the book:

% cd /dict % ebunzip

This is equivalent to:

% ebunzip --output-directory /dict /dict

Uncompression may take a while. ebunzip outputs status messages during the uncompression like as follows:

==> uncompress /dict/kanji/start.ebz <== output to ./kanji/start.ebz 5.1% done (4194304 / 82460672 bytes) 10.2% done (8388608 / 82460672 bytes) 15.3% done (12582912 / 82460672 bytes) : (snip) completed (82460672 / 82460672 bytes) 25681439 -> 82460672 bytes

During the uncompression, ebunzip asks you whether an existed file may be overwritten or not:

==> uncompress /dict/kanji/start.ebz <== output to /dict/kanji/start the file already exists: /dict/kanji/start do you wish to overwrite (y or n)?

When the uncompression has done, the directory structure under `dict' is slightly changed.

/dict/catalog /dict/language /dict/kanji/start /dict/english/start

Uncompressed files change their file names; the suffix `.ebz' is removed from them.

5.2 Options for Uncompression

Most options have the same meanings at compression and uncompression.

When the `--keep' option is specified, ebunzip doesn't delete compressed files after uncompression.

Invoking ebunzip with the `--test' option, ebunzip doesn't write uncompressed data to acutual files. This option is usuful for checking validity of compressed files. See section 4.4 Test, for more details about the `--test' option.

When the `--subbook' and/or `--skip-content' options are specified, ebunzip only uncompresses files matched to the given condition only. See section 4.5 Partial Compression, for more details about these options.

When the `--force-overwrite' or `--no-overwrite' option is specified, ebunzip overwrites or skips files without confirmation for overwriting. See section 4.6 Overwrite Old Files, for more details about the `--force-overwrite' and `--no-overwrite' options.

ebunzip ignores the `--level' option. You don't have to specify the `--level' option at uncompression.

5.3 Uncompress Compressed Book

Also S-EBXA and EPWING define compression formats, and some CD-ROM books of S-EBXA and EPWING are compressed with the formats. However, their compression formats are different from that of ebzip.

ebzip (ebunzip) can also uncompress CD-ROM book compressed with the EPWING or S-EBXA compression fomrat, but it cannot compress book with the format.

When ebzip (ebunzip) has uncompressed S-EBXA's `START' file, EPWING's `HONMON2' file or EPWING's `HONMONS' file, it adds the suffix `.org' to the uncompressed file (e.g. `honmon2' -> `honmon2.org').