In Russian   IMach   Author   CreateSFX  

E-mail     Last modified - Feb 3, 2005

                 CreateSFX: Mini SFX-archiver

                     Version 0.2 beta free

                          ReadMe file

                                            Devoted to my
                                            loving Lino.
Contents
========

1. Introduction

1.1. Requirements
1.2. Technical parameters
1.3. Software license
1.4. Disclaimer
1.5. Third party components
1.6. Technical support
1.7. Contact information
1.8. Acknowledgements

2. Installation

3. Instruction on running the program

3.1. Starting from context menu
3.2. Starting from command line

4. Guidelines for use the program

5. Uninstallation

Appendix 1. Terms

Appendix 2. Known issues

Appendix 3. What's new


1. Introduction
===============

You are welcome! My name is Raul Shakirov. I've created this
program in a couple of days as a gift to sister Fessalonikia from
Novo-Tikhvin women's monastery (Ekaterinburg, www.sestry.ru).
I hope it will help all other peoples who need create most
compact archives and do not have enough time to install and study
complex archivers. Get simplicity!

The program creates self-extracting archives which do not require for
archiver to be unpacked. These archives generally can save space when
packing files and folders containing more then 30 Kbytes of data,
especially for folders with great number of Microsoft Office
documents, where compression ratio may be up to 10x.

The program is based on source code of archiver MsCab 0.63,
written by Mateusz Brzostek (www.mscab.prv.pl).


1.1. Requirements
-----------------

- 100% IBM-compatible computer.
- Graphic display.
- Microsoft Windows 9x/Me/2000/XP/2003.
- 32M of RAM memory (recommended).
- 150K of HDD space for the software.


1.2. Technical parameters
-------------------------
- Minimal size of archive (self-extracting module)       23K
- Maximal size of archive                            near 2G
- Maximal size of file in archive                    near 2G
- Number of files and folders in archive      not restricted
- Long file and folder names (up to 255 chars)           Yes
- UNICODE file and folder names (up to 32767 chars)       No
- Folder structure                                       Yes
- Creation of solid archives                             Yes
- Creation of empty folders                              Yes
- Creation of multi-volume archives                       No*
- Encryption of archives                                  No*
- Format of archive                                MsCab SFX

* Scheduled for implementation


1.3. Software license
---------------------

The following copyright statement describes authorship of
the software.

(C) Copyright 2005 by Raul N. Shakirov, IMach of RAS (UB).

Author ensures that he has secured all necessary consents
and approvals to use third party intellectual property
rights for this software.

Author confirms that the original code of program does not
contain parts, which are intended for the purposes, others
than central purpose announced in the software documentation.

Permission has been granted to use, copy and distribute this
software without fee, including commercial applications,
provided that this notice is present in user-accessible
supporting documentation.

This does not affect your ownership of the derived work
itself, and the intent is to assure proper credit for the
author of this software, not to interfere with your
productive use of this software. "Derived works" includes
all programs that utilize this software. Credit must be
given in user-accessible documentation.


1.4. Disclaimer
---------------

THIS SOFTWARE IS PROVIDED "AS IS". NO WARRANTY OF ANY KIND
IS EXPRESSED OR IMPLIED. YOU USE AT YOUR OWN RISK. THE
AUTHOR WILL NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF
PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING
THIS SOFTWARE.


1.5. Third party components
---------------------------

Author have used the following third party sources and components:

1) Microsoft(R) Visual C++ 6.0 Compiler (Enterprise Edition),
   Licensed to Institute of Engineering Science of RAS (UB).

2) Archiver MsCab 0.63 from Mateusz Brzostek
   http://www.mscab.prv.pl
   Public available source.


1.6. Technical support
----------------------

Updates are available at http://www.imach.uran.ru/creatsfx

Please, send your comments and bug reports to author of
the program.


1.7. Contact information
------------------------

Author: Dr. Raul N. Shakirov,
Institute of Engineering Science, Russian Ac. of Sci. (UB),
34 Komsomolskaya str., Ekaterinburg, 620219, Russia.

Phone: 7 (343) 375-35-80
Email: raul@imach.uran.ru


1.8. Acknowledgements
---------------------

Thanks to Mateusz Brzostek, author of best written C code which
I've ever seen in the world.


2. Installation
===============

Program is distributed as setup program InstallCreateSFX.exe.

To install run InstallCreateSFX.exe and follow instructions of
the setup program. Setup program will write program CreateSFX.exe
to SendTo folder of the current user profile.

NOTE:   If previously installed version of CreateSFX.exe is
        running, close it with "x" button before installing
        the new one.


3. Instruction on running the program
=====================================

Program is designed to provide for maximum simplicity in use,
so you can start it from context menu of Windows Explorer using
several mouse clicks.


3.1. Starting from context menu
-------------------------------

Archive is created as the follows:
1. Point to either folder with files or separate file,
   press right mouse button to show context menu.
2. Select in context menu item "SendTo".
3. Select in pop-up menu item "CreateSFX.exe".

Program runs in console window containing progress messages
also can show pop-up confirmation and error messages.

On completion look in the current folder for executable file
"folder or file name.exe". The file can be unpacked on any
computer working under either 32-bit Microsoft Windows operation
system or its proper emulator. To unpack, just start archive,
then press button "..." right to filed "Extract to", select
folder to extract files, press OK and again OK


3.2. Starting from command line
-------------------------------

To start program from command line, copy it from folder SendTo
to Windows system folder or to any other folder on program search
path.

CreateSFX file                  Compress file to SFX archive

CreateSFX folder                Compress folder to SFX archive

Also CreateSFX understands command line of MsCab 0.63 (in fact,
CreateSFX contains the entire MsCab code as an integral part).


4. Guidelines for use the program
=================================

Program is effective on files and folders containing more then
30 Kbytes of data, especially on folders with great number of
Microsoft Office documents, where compression ratio may be up
to 10x.

To unpack SFX archive you must have computer with either 32-bit
Microsoft Windows operation system ot its proper emulator.


5. Uninstallation
=================

To uninstall the program, do the following:

- If program CreateSFX is running, close it with "x" button.

- Run setup program InstallCreateSFX.exe.

- Press Ctrl-Insert to copy full name of SendTo folder
  to Clipboard.

- Press Cancel to close setup program.

- Select Start-Run.

- Press Shift-Insert to paste full name of SendTo folder
  from Clipboard.

- Press OK to open SendTo folder.

- Delete file CreateSFX.exe


Appendix 1. Terms
=================

SFX     Self-extracting archive


Appendix 2. Known issues
========================

- Windows NT4 do not call CreateSFX.exe for folders.


Appendix 3. What's new
======================

Jan 31, 2005 - Release 0.1 and 0.2 beta free

- Add support for empty folders.