X-Finder R.10 for Connectivity Pack Ver 1
Gaku Nakagawa (Ran M. R.)
E-mail: RXF10242@nifty.ne.jp


[1] Introduction

This program X-Finder R.10 (CP1) is a port of X-Finder R.10
"magic utility for the HP100/200LX" to the HP Connectivity Pack
platform.

Since the connectivity pack does not support task switching,
commands related to EXM programs do not work.

Since running X-Finder on the Connectivity Pack often leads to
insufficient memory, MaxDOS is recommended. Load MaxDOS before
'launcher.com' in app200.bat and release MaxDOS after it.


[2] Set up

Original X-Finder package FINDER.ZIP is needed. User's guide,
Help file and Icons in FINDER.ZIP should be used.

For the setup of remote link, please refer to the User's Guide
of the server program.

This package xfcp.lzh contains following files.

xfcp	.txt	User's guide (this file)
xfcp	.exe	Program
finder	.env	Environmental file
palmtop^.lzh	Palmtop screen file
setup	.bat	setup batch file
app200	.bat	my batch file to launch the Connectivity
		pack (for reference)
xfcpj	.lzh	Original documentation in Japanese
xfcps	.lzh	Source code of the program


1. Decompress FINDER.ZIP
2. Decompress XFCP.ZIP into the same directory. Some files are
   overwritten.
3. Run SETUP.BAT in the same directory

   Notes:
   o LHA.EXE should be in a directory defined by PATH
     command in AUTOEXEC.BAT.
   o SETUP will do the followings:
     - Create a directory C:\FINDER\
     - Copy XFCP.EXE, FINDER.ENV, FINDER.HLP, ICON.LZH and
       ICONFLD.LZH to C:\FINDER\
     - Create a directory C:\FINDER\PALMTOP^\
     - Decompress PALMTOP^.LZH into C:\FINDER\PALMTOP^

4. Edit FINDER.ENV in C:\FINDER\ to define the editor you like
   to use. Editor setting is in the first part of FINDER.ENV.
   The default setting of the bundled environmental file is to
   use Vz Editor.

5. Add XFCP.EXE to AppManager of the Connectivity Pack.

Remark: Please refer to FINENV.TXT for the syntax of the
        environmental file, when you change the settings.


[3] Changes from EXM program onto the Connectivity Pack

Nemunemu and others reported in Section 8 of FHPPC forum
how to make EXE for Connectivity Pack from EXM program.
This report inspired me to build a Connectivity Pack
version of X-Finder.

Simply replacing m_alloc( with malloc( and m_free( with free(,
with DOS call changed to system(, worked fine.

The garbage on the screen after DOS call was cleaned by the
initialization with int86(0x10.

Waiting for a keystroke on the connectivity Pack needs an entry
of 'exit' to the prompt.

Writing directly to V-RAM for a display of graphics such as
icons does not work on the Connectivity Pack and thus replaces
with routines with int86(0x5f.

The most difficult and mysterious problem was the {Shift},
{Ctrl} and {Alt} key, which produced strange character input
within DOS calls of X-Finder.  This problem was solved by
calling m_fini(.

This solution would disable the {Alt} key to pop up the menu
bar.  Thus X-Finder now checks the {Alt} keystoke and send
the {Menu} keycode instead.

{Zoom} is implemented as {Ctrl+Space}.


[4] My PC environment

Fujitsu FM-V BIBLO/NC (Pentium100MHz)
Windows95 OSR2
HP Connectivity Pack



Note:
  This document was translated from Japanese by Toshiki Sasabe
  (toshiki@j.email.ne.jp).  The translator does not guarantee
  that the translation is free from errors. Use it at your own
  risk. In case of doubt, please refer to the original
  XFCP.TXT, which is also included in this package.
