
Readme for Dirlot 0.9.2
=======================
The file provides you with some introductory information 
about the Dirlot utility.
--------------------------------------------------------------------------------


Content
-------
1) Description
2) System Requirements
3) Installation
4) License
5) What is new?
6) Distribution Package Content
7) Localization
8) Bug Reports
9) Known Problems
10) Contact Information
--------------------------------------------------------------------------------


1) Description
--------------
The utility shows relative size of all elements (both files and directories) 
in a directory on disk using columnar diagram. It allows you to quickly 
estimate how many space a file or subdirectory occupies on parent directory 
and how space is distributed among the directory's elements. 
You can also change parent directory, view files' metadata 
(creation date etc), select sort order and scale of diagram columns.
--------------------------------------------------------------------------------


2) System requirements 
----------------------
The utility depends badly on presence and version of the 
Microsoft Internet Explorer (IE). If you use IE 5.1 (or lesser) 
then some problems may arise relating to the utulity's localization. 
(If you do not use localization feature the utulity works well even when 
IE 5.0 is installed). 

Therefore I urge you to install or update your version of Internet Explorer. 
You can take it at no cost from the Microsift's website:

http://www.microsoft.com/windows/ie/default.asp.
--------------------------------------------------------------------------------


3) Installation
---------------
The Dirlot is distributed without a dedicated install/uninstall utility. 
In order to setup Dirlot follow the steps below:

1) Unpack the downloaded file in a directory on your hard disk. (I advise you 
to create the 'Dirlot' subdirectory in the 'Program Files' directory and unpack 
the file in created directory).

2) If you wish, move one of the localization files from the 'locals' subdirectory 
in just the directory where you've unpacked the downloaded file and where 
the utulity is currently. (You can also do this later.)

3) To run the utility click or double click (depends on your desktop settings) 
on the dirlot.hta file in Windows Explorer.
--------------------------------------------------------------------------------


4) License
----------
I, Olexandr Lykho, author of Dirlot utility (software), allow you:
1) use the software on the computer you are working at
2) distribute compressed file (archive) the software is placed in.

If you have not explicit written permissions from author, I prohibit you:
1) charge or/and collect any payments for using of the software
2) distribute any changed versions of the software.

The software is distributed AS IS without guaranties of any kinds.

I allow you to distribute the software provided that you 
strictly adhere conditions of this license.
--------------------------------------------------------------------------------


5) What is new?
---------------
Fixed	the problem with the 'System Volume Information' directory. 
	The exceptions when accesing proptected elements are catched.
Fixed 	bug with restoring the directory from the last session.
Fixed	Dirlot can also restore displaying of a file (not only directories). 
Added	Dirlot can take also path to a file as argument of command line (not only 
	directories).
Added	When the link of the currently displayed element is clicked the view 
	updates.
Added 	readme.txt and readme.ua.txt files.
Added	Italian localization file.
Changed	Flat scroller. Scroller is not shown if there is enough place in the 
	window.
Added	Links to the Dirlots home pages.
--------------------------------------------------------------------------------


6) Distribution Package Content
-------------------------------
The following is the content of distribution archive.

ico	
	dirlot.ico	Dirlot's icon (displayed at its left top corner).
locals			Localization files.
	locUA.dat	Ukrainian localization file.
	locEN.dat	English localization file. Mostly for translators.
	locIT.dat	Italian localization file. Thank you, Francesco!

dirlot.hta		Dirlot's executable.
readme.txt		This file.
readme.ua.txt		Ukrainian readme file.

After first start Dirlot also creates the dirlot.dat file where it stores its 
last session parameters.
--------------------------------------------------------------------------------


7) Localization
---------------
Dirlot supports localization so you'll be able to make it speaking your 
native language. In order to localize Dirlot, put one of the localization files
from the 'locals' directory in the same directory the 'dirlot.hta' file is. 
There should be only one such file at a time.

You can also create localization file for your native language. For this, just 
translate content of the 'locEN.dat' file replacing the text values after 
the '=' sign and then save your translation using the name with the 'EN' letters 
substituted by your language identifier. For example, for german translation 
use the name 'locGE.dat'.

If you've made localization for one of the langauges for which Dirlot still has 
no localization file, please send your localization file to me. You can find 
my email in the Contact Information section of the file. 
--------------------------------------------------------------------------------


8) Bug Reports
--------------
The version of Dirlot is released for testing and trial purposes.

If you will find some bugs in the program please be so kind to inform me 
about them. Thus you will help me to make Dirlot better. Include in your 
message the information about: 
1) error conditions (exact error message, error code, line and char)
2) your system (version nombers of Dirlot, Windows, Internet Explorer, WSH).

You can find my email in the Contact Information section of the file. 
--------------------------------------------------------------------------------


9) Known Problems
-----------------
1) If the starting path is gotten in the form with short names 
(e.g. C:\Progra~1\), then the directories in the path are displayed using 
the short form until user goes beyond the path. That is, when she or he will go 
to the root directory or to another drive.

Workaround Use long names as value of command line path attribute.


2) The comboboxes 'Scale' and  'Relative to' are displayed incorrectly when 
you use localization feature if the Internet Explorer 5.1 (or below) is 
installed. The text of last options in these comboboxes are wrong also.

Workaround Use Internet Explorer 5.5 or next versions.

	
3) The wait cursor (clepsydra) keeps diplaying after the size data are read 
from root directory and diagram is shown until the mouse position will be 
changed.

Workaround Unknown.


4) Norton Antivirus displays the malicious script warning when you try 
to start Dirlot.

Workaround Perhaps, the suggestion below will help you:

"If you have the latest version of Norton Antivirus installed and have 
'Script Blocking' enabled, you may get an alert message about a possibly 
malicious script. This happens because the script accesses your folders 
in order to check their names and move files. Just select 
"Authorize this script" from the Action list, 
and the message will go away forever."
 
I don't use Norton Antyvirus currently, but I guess it could be good suggestion. 
Please try it out and inform me about results.

- or -

You might decide do not use so faulty software as Norton Antivirus.


All your suggestions regarding of how to eliminate those problems 
will be appreciated.
--------------------------------------------------------------------------------


10) Contact Information
-----------------------
Author:	Olexandr Lykho
Email:	les2@ua.fm
Web: 	http://soft.km.ua/soft/dirlot/

I like to hear from you even if all you have to say is that you love Dirlot 
or you hate it. So do not hesitate whether to write to me.

If you are going to write me about some bugs you've found 
please follow the guidelines in the Bug Reports section of the file.

==============================
End of Readme for Dirlot 0.9.2