EU-Commander Files

EU-Commander README                                    13-May-2013
==================================================================

DISTRIBUTIONS:
--------------
There are two packages (distributions) available :
     1. 'source' : The required packages have to be installed
                   already
		   ('gzip.exe' and 'tar.exe' with the required
		   DLLs for Windows are also included
     2. 'with_packages' : The additional packages (for a standard
                   Tcl/Tk installation) are placed in the
                   'packages' subdirectory of this distribution.

     For both distributions :
		   'gzip.exe' and 'tar.exe' with the required
		   DLLs for Windows are also included within the
		   'packages' subdiretories.

PLATFORMS:
----------
In the last few years I only developed under Windows and didn't
check if the EU-Commander still works under Linux.

Sorry for that !

!!! And I don't have any experience with MAC or other OS's !!!

INSTALLATION:
-------------
!!! Starting with V 0.101 the gnutils 'gzip.exe' and 'tar.exe'
    are included in the 'packages' subdirectory
    ('libiconv-2.dll' and 'libintl-2.dll' belong to 'tar.exe')
    => point 2 is not necessary anymore !!!

    You can get the 'gnutils' at 'http://gnuwin32.sourceforge.net'

     1. Install Tcl/Tk >= 8.4 (for your platform).
     2. only Windows ! : Install the 'gnutils' and add the path to
        'gzip.exe' etc. to the 'PATH' variable.
        (If this is already done, the Commander will use this files)
     3. Extract 'eu-comm??.tar.gz' in any directory.
     4. Execute 'eu-comm.tcl' (wish eu-comm.tcl &).

For a short help just open the 'Help' notebook page or use the
context sensitive help (press F1).

The 'Web Site'@sourceforge is in progress !

REQUIRED (USED) PACKAGES:
-------------------------
	BWidget 1.9.6
	Img 1.3
	Tktable 2.9
	Tkhtml 2.0
	csv 0.7   (within 'tcllib 1.10')
	tar 0.4   (within 'tcllib 1.10')
	ico 1.0.2 (within 'tklib 0.4', ! only for Windows !)
	dde 1.4.0 (within 'tklib 0.4', ! only for Windows !)
	twapi 3.1.17 (only for Windows !)
	registry 1.3.0 (only for Windows !)

	ftp 2.4.8

	(vfs)
	(vfs::tar)
	(Thread)

If you have a standard Tcl/Tk installation and you want to run
the EU-Commander e.g. from an USB stick, just create a directory
called 'packages' within the installation directory and copy the
above packages to this subdirectory or use the 'with_packages'
distribution.

(also see the 'Web Site' -> 'General notes (hints)').

OWN MODULES:
------------
If you want to create own additional modules for the EU-Commander
there's an example script within the 'addons/template' subdirectory.

ADDITIONAL TOOLS:
-----------------
'calendar.tcl' is called when pressing the date in the status bar.
'icon_select.tcl' is used to select an icon for an application in
the applications bar.

These tools can easily be used in other programs :
- The output of calendar.tcl (when pressing a day) is a date
  string or an empty string.
- The output of icon_select.tcl (when doubleclicking an icon)
  is the file name of that icon or an empty string when exit the
  program without icon selection.

(Please see the headers in the code)

IMPORTANT (for Windows):
------------------------
Working with Samba shares :
There is a bug in Tcl getting the correct file permissions from
a samba share !

-> The EU-Commander is not checking whether files/directories are
   readable/writable !
-> it's possible that there will be error messages from Tcl !!
   (as soon as there is a bug fix I will add the checks again !)



That's it.

Stefan

I hope the EU-Commander is a little help.

(Thanks for your feedback -> 'sourceforge.net')