EU-Commander Files

EU-Commander README                                    23-Oct-2014
==================================================================

DISTRIBUTIONS:
--------------
There are two packages (distributions) available :
     1. 'source' : The required packages have to be installed
                   already
     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:
----------
I only program and check on Windows and Linux.
!!! I don't have any experience with MAC or other OSs !!!

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')

    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.11
	Tkhtml 2.0
	csv 0.7   (within 'tcllib 1.10')
	tar 0.4   (within 'tcllib 1.10')
	ico 1.0.3 (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 !)
	tkdnd 2.6 (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 'win_packages' (for Windows) or 'unx_packages' (for Linux)
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 is a date string (when pressing a day)
  or an empty string ('Close').
- The output of icon_select.tcl is the filename of an icon
  (when doubleclicking an icon) or an empty string ('EXIT').

(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')