VNC for EPOC
------------

This SIS file has been produced from a slightly modified version 
of the publicly available Java VNC client.  It installs directly to 
the apps folder, and all functionality is accessible from the VNC 
interface.

Version 4 adds:

	- support for the Sony Ericsson P800

	- Removed button bar.  All items are now available from the menu

	- Altered the way the memory allocation occurs.  It should now 
	  be possible to connect to servers with high screen resolutions
	  as long as raw encoding is NOT used. (Default is hextile anyway)

	- Added an interface to add/mod/del saved host entries

	- Saved host entries now save password information as well

	- cawt.jar file now included in the nokia installation

	- 'Scratch pad' available on the P800.  This enables text entry via 
	  hand writing recognition.  To activate, push the smart button on 
	  the p800 forwards or backwards.  The scratch pad will appear.  Write
	  your text, press ok and it will be copied to the VNC server at the 
	  current cursor position.


Version 3 adds:

	- Change to the way the buttons are used on the R6 version (Nokia)
	  which makes it more usable

	- Status pane is turned off on R6 by default to give a larger screen 
	  area

	- The button are can be hidden before connecting, in the options screen

	- The saved hosts pull down list has been modified, and now reads from 
	  the vnchosts.txt file as before, but also writes to this file when any
	  new host is used,- so it builds up a hosts list for you.

	- Every effort has been made to make the screen size as large as possible
	  given the restrictions of java programming on the nokia.


Version 2 adds:

	- Removed the port field - the host field now requires an 
	  entry of <host>:<port>

	- Any port under 10 is considered to be a VNC display number,
	  (and thus has 5900 added to it to produce the real IP port)
	  Any port over 10 is treated as a real IP port number

	- Added a saved hosts list.  These reside in the file
	  \System\Apps\Vnc\vnchosts.txt and should be <host>:<port>
	  one per line.  This file must be manually edited, it is
	  not automatically updated

	- Scroll bars have been added, which means that the CTRL-SPACE
	  sequence should not be needed.  This option can be turned off 
 	  in the options page, but this causes problems on R6 as you then 
	  can't move around the full screen.

	- EPOC R6 is supported, unfortunately with a different SIS file.
	  This adds functionality for the R6 menus and programmable keys


Latest version has been tested on a Psion Netbook, the Nokia 9210 and the 
Sony Ericsson p800



Previous version has been reported as working on the Revo, 5mx and Series 7.  
It also works sucessfully on the psion emulator, as supplied with the SDK.

Remember though, it is a Java application and therefore requires the 
Java Virtual Machine to be loaded onto the machine.  This comes pre-installed
on some models, not others.  The error message obtained when running 
VNC without the JVM is something like 'information not found'

FILES IN KIT
------------

	vnc-psion.sis	For psions! (EPOC R5)
	vnc-nokia.sis	For Nokia!  (EPOC R6)
	vnc-p800.sis	For P800!   (EPOC R7)

	redirect-nokia.sis	Application for use on Nokia for troubleshooting
	redirect-p800.sis	Application for use on P800 for troubleshooting


TROUBLESHOOTING
----------------

1.  If you are using a Nokia or P800, try using the redirect application to direct 
    java output to a file.  This will give a reason for the failure

2.  If you are using a Psion, java output will log to \logs\java\java.txt.  This file 
    will contain a reason for the failure

3.  Send me an e-mail!


FAQ
---

I have had questions about the port field - basically, the port is 
the tcp/ip port that the vnc server is listening on.  Vnc calls this 
a 'display number'.  Vnc display number 0 is tcp/ip port 5900, vnc display
number 1 is tcp/ip port 5901 etc.  The port field needs the tcp/ip 
port, NOT the vnc display number.  It is done this way because we 
frequently run VNC on non standard ports, and so use tcp/ip numbering 
in preference to vnc numbering.  The default port used by the standard 
vnc server installation is 5900 - so use this number unless you have 
changed the server configuration in any way.



INFO
-----

Any comments or questions, please e-mail me:  steve.allam@imhotek.com


REGISTER
--------

To register as a user, please send a mail to epocvnc@imhotek.com.  The 
only details I would like is what psion you are using, and your e-mail 
address.  I will *NOT* be using these details for anything other than 
letting you know of version changes, and a knowledge of what you are 
using allows me to verify that updates work on all platforms.

Note:  This kit is available on the Imhotek web-site: 

	http://www.imhotek.com/downloads/


LICENSE
-------

This product is based on the freely available VNC product, which can 
be downloaded from:

	http://www.uk.research.att.com

It is distributed under the GNU General Public License, which can be 
seen at:

	http://www.uk.research.att.com/vnc/gpl.html


You are free to download it, use it, and redistribute it under the terms
 of the GNU Public Licence. 
