Calmira LFN
======================================================================

Calmira is a Windows 95 user interface for Windows 3.1.  It's a fully
integrated environment for managing your files and programs, and is
designed to run smoothly on 386 and 486 computers.
Calmira LFN is a variant of Calmira with some extra features and has
experimental support for Windows 95 Long File Names (LFNs) that allows
up to 255 characters in file names and 260 (Calmira LFN supports only
up to 255 due to Delphi 1 string type limitation) characters in path.
Calmira LFN interface is also intended to look a bit more like Windows
98, with personalized folder icons and a My documents shortcut.


Features
========
 - Mulptiple user profiles allowing seperate settings for each user
 - An Explorer to navigate your disk and manage files
 - Long FileNames (LFNs) experimental support
 - Support for 4DOS file descriptions for those who perfer them to
   long filenames
 - Desktop and file based shortcuts to any object or URL
 - Support for personalized icons for folders
 - Taskbar with versatile Start Menu, nested to any level
 - Wastepaper bin to store deleted files and folders
 - Hundreds of easily accessible options and settings
 - 80 page on-line manual containing all the help you'll need
 - A "My documents" special shortcut in Desktop (like in Win98)


System requirements
===================
 - 386 processor or higher
 - Microsoft Windows 3.1 or Windows for Workgroups 3.11
 - DosLFN for long filenames support
 - At least 4 MB of memory, 8 MB recommended
 - A graphics card that can display 16 colors (256 or higher
   recommended) in a minimum resolution of 640x480
 - A mouse


Installation
============
Calmira LFN comes with an installer. Simply run CALLFNIN.EXE and
follow the instructions on the screen.
If you downloaded the zipped version simply unzip it to an empty
folder anywhere in your hard disk.
In both cases you can make Calmira LFN your shell by editing the
System.ini file located in the Windows folder, changing this line:
  shell=????????? (default is progman.exe)
to
  shell=_Path_to_the_folder_CalmiraLFN_is_installed_\Calmira.exe
You may want to backup the command line of your previows shell to
revert back to it if necessary.


Upgrading
=========
Choose to keep CALMIRA.INI and START.INI
If you downloaded the zipped version simply extract to the
folder Calmira is installed not overwritting CALMIRA.INI
and START.INI.
In both cases erase the following lines from Calmira.ini:
  Calmira32=????
  DateLastRun=????
To Calmira LFN detect it is the first time it is runs and
install the included "Calmira LFN Blue (HiColor)" color
scheme.


Major issues
============
 - If you find a major bug please contact me.


Version history
===============
Calmira LFN 3.3
----------------------
 - Fixed bug that made Calmira LFN crash after creating/renaming for the
   second time, by putting the LFN related functions in a separated DLL.
   This DLL will be copied to the Windows Sytem folder so another utilities
   might share the LFN capabilities.
 - Updated help files (a little).
Calmira LFN 3.3 Beta 4
----------------------
 - File names are now convertd form the OEM character set (MS-DOS one
   to Windows Ansi ones, so non standard ASCII characters ( and so
   on) should now work fine with LFNs, as long as Windows Codepage is
   set to the same codepage that DOSLFN is using (they both default to 
   DOS codepage anyway... very few people have this misconfiguration, if
   this is your case check the windows codepage through Windows Setup
   under DOS - SETUP.EXE under Windows dir - and the DOSLFN startup line
   in your autoexec.bat);
 - Fixed a bug in the file properties page that might not show version
   information for some files with LFNs enabled;
Calmira LFN 3.3 Beta 3
----------------------
 - "My documents" can now be hidden (another tab in "Desktop
   Properties" page;
 - Done a workarround for the bug in "Desktop Properties", where
   the 2 wallpaper settings that were in drop down lists were being 
   lost: it is aDelphi VCL bug - it is not able to sucessfull save/
   restore the selected icon in drop down lists that cannot be edited,
   the workarround saves your selection each time you change an option,
   and use the saved version when applying. If you change back the tab
   to Wallpapers one you won't see the options: the two fields will be
   blank, but do not worry, your selections are saved and they will be
   applied;
 - Another RLE image that can be used as a startup logo included (Windows
   ME style);
 - Bug in FFileExists and FDirectoryExists that were raising an exception
   during startups (previous versions the exception was comented, now it
   is fixed so it will only be raised when needed).
Calmira LFN 3.3 Beta 2 
----------------------
 - First version with a installer;
 - Personalized shutdown screen bitmap (Windows 98 style)
   included;
 - Personalized RLE image that can be used as a startup logo
   included (Same as the original, except that it is now
   written 'Calmira LFN' instead of 'Calmira II');
 - Added the environment varialble %PERSONALFOLDER% that
   contains the path of the folder pointed by "My documents"
   special shortcut; The start menu included with the installer
   has an icon for "My documents" within the "Documents" root
   item using this varible;
 - A bug in size reporting that appeard in Beta 1 is now fixed;
 - It is not necessary to manually set the ReadOnly or System
   attribute to specify a personalized icon for a folder, the
   ReadOnly attribute is automatically set. ReadOnly is prefered
   to System attribute because most MS-DOS and Windows programs
   do not show system files by default;
 - It is not necessary to manually refresh the folder window 
   when specifying a personalized icon, it is done automatically;
 - Desktop now behave more like Windows 95 ones: icons shade
   (if shading is enabled) and if you press the left mouse
   button and drag a focus rect will appear (but it still
   won't select anything - just to see);
 - Multiple Explorer windows can be opened;
 - Browsing folders in the same icon now works more like Win95;
   Folders only share a window when the folder was opened from
   that window. Opening anything by double clicking a shortcut
   will bring a new window.
 - Includes an additional color scheme
Calmira LFN 3.3 Beta 1 
----------------------
 - This is the first version that calls itself Calmira LFN; 
 - Most bitmaps (including those in splash screen) and some
   text are now personalized; 
 - Changed "My Documents" icon so now it is same the Win98 one; 
 - Fixed several bugs in the new open dialog. 
Test version number two
-----------------------
 - Now "Open with" and "Inspect" work correctly; 
 - Seems that the copying and moving issue disappeard since I
   rewrote two low level file routines (LFileOpen and 
   LFileCreate); 
 - Modifications in hints. 
Test version number one
-----------------------
 - Long File Names experimental support - chrashes when renaming
   directories with LFNs enabled for the second time, no unicode
   tables and Copiying and Moving simply destroy every data you
   try to copy/move; 
 - Experimental support for personalized icons for folders (with
   a "Customize" tab in folder's properties): Works perfectly
   except that you have to manually set ReadOnly or System
   attributes for the icon to show. You also have to refresh
   manually the file list; 
 - A nice extra tab in "Desktop properties" dialog for changing
   the wallpaper; 
 - Another tab in "Desktop properties" dialog for changing
   system icons; 
 - A "My documents" special shortcut in Desktop (like in Win98); 
 - A somewhat buggy open dialog: You have to answer no when it
   asks if you wan't to overwrite the file to open it (???), but
   displays LFNs; 
 - There are still no personalized help files, bitmaps and still
   no personalized name (the program still calls itself Calmira
   II 3.3); 
 - "Open with" and "Inspect" don't work correctly.


Contacts
========


Email : alexanrsousa@netscape.net
Web   : http://www.geocities.com/alexanrsousa
