
        VNC Viewer for OS/2 PM - beta release 0.07

_What is VNC
    
    VNC stands for Virtual Network Computing, developed by ORL.
    
        Jan. 1999, ORL has been acquired by AT&T to form AT&T
	Laboratories Cambridge.

    See  VNC site <http://www.uk.research.att.com/vnc/> for details.

_VNC Viewer for OS/2 PM

    There are two VNC viewer's for OS/2, XFree86/2 version and Java    
    Version. X version requires X server, and Java version requires a 
    lot of memory (resource monitor says it eat up  over 10MB of memory).

    VNC viewer is orginally, thin client.  X/Java version is   FAT 
    client for my environment. So I start porting VNC viewer for native 
    PM. It requires no additional programs (but  requires TCP /IP, of 
    course), and eat up less memory (so  start up faster).

_Current Status

    This is new beta version (beta 0.07) of PM VNC viewer.  I appended
    some requested features.

    New features:

        Appended '-passwd password-file' option.  If VNC viewer can
        access password file of the VNC server, this option specifies
        use password from given file, not from password dialog.  If you
        use this viewer with Xvnc server for OS/2, this option gives no
        passwd dailog to connect to local Xvnc server.

        Appended '-keymap keymap-file' option.  Keymap-file defines
	maps between scan key code and VNC's key code (X's keysymdef).
	With this mapping, you can send different key code for Right/
	Left Shift/Control keys, or keypad keys usually not
        distinguished.  Also, you can send NLS keys with this mapping.
	
	    But, except Xvnc server, such NLS key will ignored by
	    server side.

    Fixes:

        When keyboard focus changed, VNC viewer adjust Shift, Ctrl, Alt
	state to current state.  This fixes a problem CTRL stay pressed
	when CTRL-ESC to change active window.  But this fix send another
	key event to remote desktop, this may cause problem on some
        remote applications.

        Also there is a problem on mouse button release.  If you hold
        down mouse button and release it outside window, then no mouse
	release was send to remote desktop, and remote application think
	mouse button is still pressed.  Now viewer capture mouse on
        button down and watches button release.

    I hope this will be last beta.  If no trouble found with this
    version, it becomes first offical release.

_Download and Installation

    Download from 
    
        <http://www.sra.co.jp/people/akira/os2/vnc-pm/index.html>

    and unzip zip file. Zip file contains all sources and 
    executable. 

        This program was written for EMX/GCC.  You need EMX runtime 
	(0.9c or later) to run this program.

    To use executable, copy 'vncview.exe' to a directory in a 
    PATH,  and type

        vncview
          or
        vncview host:display

    After beta 0.06, I changes structure of INI file (VNCVIEW.INI). If
    you've using older version(<= 0.05), please delete old VNCVIEW.INI
    before invoke new version.

    Of course, you need to setup VNC server before you start VNC
    viewer.  VNC servers are available on many platforms.  See

        VNC site <http://www.uk.research.att.com/vnc/>

    for details.

_Copyright and Lincece

                VNC Viewer for OS/2 PM

    Copyright (C) 1999, Software Research Associates, Inc.

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    VNC viwer for OS/2 PM also contains code from ORL's VNC and X.

    From VNC    Copyright (C) 1997, 1998 Olivetti & Oracle Research Laboratory

        rfbproto.h
        vncauth.c   patched by me.
        vncauth.h
        d3des.c     patched version of D3DES (V5.09) by Richard Outerbridge
        d3des.h     patched version of D3DES (V5.09) by Richard Outerbridge
        pmvnc.ico   converted from Windows Version
        pmvnc.ptr   converted from Windows Version

    From X11    Copyright (c) 1987, 1994  X Consortium

        keysymdef.h             

_Contact

    Please send bug reports, fixes, suggetions to <akira@sra.co.jp>.

