User's Guide: X-Finder R.10
Gaku Nakagawa (Ran M. R.)
E-mail: RXF10242@nifty.ne.jp

Using the X-Finder's built-in editor, you can press {Enter} at
the underscored line, or simply pressing {A} to {P}, to jump to
the selected subhead. {Backspace} will cancel the {Enter} key
and returns to the original position.  {0} returns to the menu.<BR>


<A NAME="0"></A>
<A HREF="#A">A: Features</A>
<A HREF="#B">B: Set up</A>
<A HREF="#C">C: Basic Usage</A>
<A HREF="#D">D: Virtual Name (File description)</A>
<A HREF="#E">E: Icons</A>
<A HREF="#F">F: Archive</A>
<A HREF="#G">G: Symbolic link (Alias or Shortcut)</A>
<A HREF="#H">H: Palmtop</A>
<A HREF="#I">I: Built-in text viewer</A>
<A HREF="#J">J: Remote Link</A>
<A HREF="#K">K: Working with the clipboard</A>
<A HREF="#L">L: The whole disk search and file trees display</A>
<A HREF="#M">M: Others</A>
<A HREF="#N">N: Disclaimer of warranty</A>
<A HREF="#O">O: Copyright and distribution policy</A>
<A HREF="#P">P: Literature</A>


<A HREF="WHATSNEW.TXT">- Read What's New (Changes)
<A HREF="PAWMICN.DOC">- Read the PAWmTOP Icon User's Guide
<A HREF="FINENV.TXT">- Read the Guide to X-Finder Environmental File
<A HREF="FINHIS.TXT">- Read the Revision History of X-Finder


<A NAME="A">A: Features</A>

X-Finder is a magical utility program.  You can use it for the
following purposes:
- file manager,
- archive utility
- remote link software
- program launcher
- icon viewer
- text viewer

X-Finder can handle approximately 250 items in split screens.

- X-Finder supports split screens
- is an EXM program (system manager compliant program).
- supports symbolic links (shortcuts, alias)
- uses a Wastebasket for file deletion.
- provides an Icon Menu similar to the built-in AppManager.
- assigns virtual names to files and other items.
- assigns and execute various commands according to marked/
  unmarked status and Shift and/or Ctrl key status.
- treats archives in *.lzh, *.zip and *.arj format as a
  subdirectory.
- can be used as a built-in AppManager, by addition of commands
  to its Palmtop screen.
- can copy a file name or other strings to the clipboard.
- can stuff the key buffer with a string or keystrokes.
- can terminate other tasks.
- support randomized execution.

Feature of X-Finders Remote Link function
- can supply power to serial port only when the remote link is
  in progress.
- switches off the serial port power after the completion of
  a remote link, even when the palmtop is running on an AC
  adapter.
- support Remote Accelerator function (executes programs on a
  remote server).
- does not provide compatibility with the remote link function
  of the built-in Filer application.
- does not support communication over IR port nor modems.


<A NAME="B">B: Set up</A>

You can find the setup information of the remote link function
in the user's guide of X-Finder Server program.  X-Finder
Server R.4 or later is required.

Notes on Transfer mode: 'Wide' and 'Narrow' are the new names
replacing 'Turbo' and 'Normal' respectively in the previous
versions..

X-Finder Server program can be found in the following
archives:
  For IBM PC Compatibles: XFS.LZH
  For SHARP X680x0:       XFS68.LZH9
  For NEC PC-98:          XFS98.LZH

This package (FINDER.ZIP) contains the following files:

WHATSNEW.TXT	Changes from previous version
PAWMICN.DOC	Guide to PAWmTOP Icons (Paw's Icon Collection)
FINDER.TXT	User's guide to X-Finder
FINENV.TXT	User's guide to the environmental file of
		X-Finder
FINHIS.TXT	Revision history of X-Finder
FINDER.HLP	X-Finder HELP file
FINDER.EXM	Executable of X-Finder
FINDER.ENV	Environmental file for X-Finder
FINDER.ICN	Icon for X-Finder
ICON.LZH	File icons (PAWmTOP Icons)
ICONFLD.LZH	Folder icons (PAWmTOP Icons)
PALMTOP^.LZH	Palmtop definition file for X-Finder
SETUP.BAT	Setup file for X-Finder
_.XFN		Virtual name description file
FINDERJ.LZH	Original documentation in Japanese
FINDERS.LZH	Source code of the program

   These files are listed by virtual names (descriptions),
   such as 'User's Guide',  when seen within X-Finder.

1. Decompress FINDER.ZIP into any directory and run SETUP.BAT
   as follows:
      SETUP C

   You need LHA.EXE for the setup. Place it in a directory
   defined by PATH command in your AUTOEXEC.BAT.

   When you like to install X-Finder to A: drive, you can run
   SETUP as follows:
      SETUP A

   Entering 'SETUP C' will start following actions:
    - Create directory C:\FINDER\
    - Copy FINDER.EXM, FINDER.ENV, FINDER.HLP, ICON.LZH and
      ICONFLD.LZH to C:\FINDER\
    - Create directory C:\FINDER\PALMTOP^\
    - Decompress PALMTOP^.LZH into C:\FINDER\PALMTOP^

2. Edit FINDER.ENV in C:\FINDER\ to set your editor. Setting
   of editor is in the first part of FINDER.ENV.

   Default setting in the environmental file bundled with the
   program use built-in MEMO Editor.

3. Add C:\FINDER\FINDER.EXM to AppManager or to MoreEXM.

   Recommended start key is {Alt+F8}. When you use EXkey to
   assign a key to {Alt+?}, add {Ctrl} at the end, for
   example:
      {Filer}={Alt+8}{Ctrl}

   o How to add X-Finder to AppManager
     1) Press {More}(&...) to start AppManager.
     2) Press {F2}(Add) to start 'Add an Application' screen.
     3) Enter 'X-Finder' to Name box and press {Enter}.
     4) Enter 'C:\FINDER\FINDER.EXM' to Path box and press
        {Enter}.
     5) Press {F4}(SetKey) to go to 'Key Assignment' screen.
     6) Press down {Alt} and press {F8} simultaneously to set
        the start key.
     7) Press {F10} to complete.

   o Add X-Finder to MoreEXM
     Using SMMx, you can add with the same procedures.  You
     need to mark the checkbox at [ ]To MoreEXM.ini.

Contents of the environmental file is described in FINENV.TXT.
Please refer to this document, when you change the settings.

<A HREF="FINENV.TXT">==> User's guide to the environmental file of X-Finder</A>


<A NAME="C">C: Usage</A>

If there are marked item(s), press the key and select [OK]
to the dialogbox.  A double click (to press the same key twice)
also works.

{Menu}{Q}
	Quit X-Finder
{Arrow key}
	Move the cursor
{Shift+Arrow key}
	Mark the item and move the cursor
{Fn+Up}(Pg Up)
	Move backward by one page
{Fn+Down}(Pg Dn)
	Move forward by one page
{Ctrl+Up}
	Go to the top item
{Ctrl+Down}
	Go to the bottom item
{F1}
        Show HELP pages.  Press {F1} again to display the
        version and author of X-Finder and initialize.  Press
        this key twice, when an icon is added or changed.
{F2}
	Copy files or directories
{F3}
	Move files or directories
{F4}
	Set a filter for item names to display
{F5}
	Go to the specified path.  If the directory does not
	exist, it will be created.
{F6}
	Rename the item. {Tab} will create a copy with a new
	name.
{F7}
	Edit the environmental file and initialize X-Finder.
{F8}
	Display a file content.
{F9}
	Edit a file.
{F10}
	Enter a command and run.
{0}
	Go to the Palmtop screen.
{1}
	Go to drive A.
{3}
	Go to drive C.
{4}
	Go to drive D.
{5}
	Go to drive E.
{6}
	Go to drive F.
{Del}
	Move the items to Wastebasket.
{Shift+Del}
	Delete the items completely.
{\}
	Go to the root directory.
{Shift+\}(|)
	Write back to an archive
{Esc}
{BackSpace}
	Go to the parent directory
{Shift+Esc}
{Shift+BackSpace}
	Go to the previous path
{Space}
	Mark an item (or unmark a marked item) at the cursor
	position and move the cursor to the next position.
{Shift+Space}
	Switch the display style to/from virtual file names
	(file description).
{Fn+Space}(Zoom)
	Switch between icon, list and detail display.
{Tab}
	Switch to alternate screen (in full screen mode) or
	move to the other window (in split screen mode).
{Shift+Tab}
	Toggle the screen mode between full and split.
{Ctrl+Tab}
	Toggle display of hidden files
{Shift+,}
	Edit virtual name
{=}
	Set the opposite window to the current path.
{Shift+=}(~)
	Exchange the left and right windows.
{+}
	Edit the attributes and the time stamp of the file.
{Shift++}(%)
	Make a copy with a new name.
{/}
	Clear all the marks.
{Shift+/}(})
	Toggle to show/hide disk space.
{*}
	Reverse the marks on all the files. (Remove the mark
	from all the marked files and add a mark to all the
	unmarked files).
{Shift+*}(")
	Reverse the marks on all the items.
{-}
	Create symbolic link file
{Fn+Left}(Home)
	Clear the marks, if any.  Mark all the files, if there
	are no marks.
{Fn+Right}(End)
	Reverse the marks on all the files.
{Fn+.}(Cut)
	Set the item(s) to CUT mode.  The items set in CUT
	mode are grayed out.
{Fn+=}(Copy)
	Set the item(s) to COPY mode.
{Fn++}(Paste)
        Move (in 'cut' mode) or copy (in 'copy' mode) the
        items.
{.}
	Conduct an incremental search for the extension
{Shift+.}(`)
	Change display order
{Ctrl}
	Conduct incremental search for a string beginning with
	a numeral.
{Enter}
        Change drive, if the cursor points to a disk
        drive. Change directory, if the cursor is on a
        directory.  You can move into an archive file with an
        extension of .lzh, .zip or .arj.

	If the cursor is on a file, check the file name and
	extension and conduct an action specified in the
	environmental file.
{Shift+Enter}
	If there are marked items, randomize the order of
	execution before conducting an action specified in the
	environment file for a matched filename or file
	extension.
{Menu}
	Activate the pull-down menu.
{Alphabetical character}
	Start an incremental search, if the key mode is set to
	incremental search mode.  Run a pre-defined command,
	if the key mode is command mode.
{Shift + Alphabetical character}
	Start an incremental search, if the key mode is set to
	command mode. Run a pre-defined command, if the key
	mode is incremental search mode.

o {Cut}, {Copy} and {Paste} keys can be used as if the text
  file of other application is another screen carrying files
  and directories.

o {Shift+Function key} is used for running predefined commands.

During the incremental search, key strokes introduce the
following actions.

{Alphabetical character}
	Start an incremental search, if the key mode is set to
	incremental search mode.  Run a pre-defined command,
	if the key mode is command mode.
{Shift+Alphabetical character}
	Start an incremental search, if the key mode is set to
	command mode. Run a pre-defined command, if the key
	mode is incremental search mode.
{Numeral}
	Conduct an incremental search.
{BackSpace}
	Move back by one character and conduct an incremental
	search.
{Up}
	Go to the previous position matching the search string.
{Down}
	Go to the next position matching the search string.
{Space}
	Mark the file at current cursor position and go to the
	next position matching the search string.
{Esc}
	Exit the incremental search mode.
{Other key}
	Exit the incremental search mode and conduct the
	function of that key stroke.

o Pull down menu

Pressing {Menu} key will open the pull-down menu.


o Key definition

The bundled environment file defines DOS applications to
{Shift+Application Key}:

{Shift+Filer}	Launch Filmtn (File Maintenance)
{Shift+Appt}	View the file at cursor position with LEX.
{Shift+Phone}	Run KTX.EXE.
{Shift+Memo}	Edit the file at cursor position with the Vz
		Editor
{Shift+Quicken}	View the file at cursor position with MIEL.
{Shift+123}	View the file at cursor position with VVC.
{Shift+Calc}	View the file at cursor position with Jupiter.
{Shift+More}	Run K-Launcher.

The bundled environment file defines various filer functions
to {Shift+Alphabetical character} key.  {Shift} key is not
needed, if the key mode is in command mode.

{Shift+A}	Change file attribute
{Shift+C}	Copy an item
{Shift+D}	Delete an item
{Shift+E}	Edit a file
{Shift+F}	Set filter
{Shift+G}	Exchange the two (left and right) windows
{Shift+H}	Enter DOS command to run
{Shift+I}	Make ISH encoded file
{Shift+J}	Pull down Path menu
{Shift+K}	Create directory
{Shift+L}	Change current drive
{Shift+M}	Move an item
{Shift+N}	Rename an item
{Shift+O}	Refresh screen
{Shift+P}	Compress file
{Shift+Q}	Quit
{Shift+R}	Rename an item
{Shift+S}	Pull down Sort menu
{Shift+U}	Extract (unpack) a file
{Shift+V}	View a file
{Shift+W}	Write back to an archive
{Shift+X}	Enter DOS command to execute
{Shift+Y}	Change the wild card
{Shift+Z}	Use DIET to compress a file on a cursor
		position

The bundled environment file defines short-cuts or switch-over
to other EXM programs to {Ctrl+Alphabetical character} key.

{Ctrl+A}	Mark all the items
{Ctrl+C}	{Copy}
{Ctrl+E}	The item on a cursor position is handed over to
		LogExpress.
{Ctrl+F}	The item on a cursor position is handed over to
		Lx-Filer
{Ctrl+R}	Run refresh (for MoreEXM).
{Ctrl+V}	{Paste}
{Ctrl+X}	{Cut}

The bundled environment file assigns directory changes to
{Numeral} keys (2, 7, 8, 9).

{2}	Toggle split/full screen
{7}	Move to drive G:
{8}	Switch the display style to/from virtual file names
{9}	Switch between icon, list and detail display.

The bundled environment file assigns remote drives to
{Shift+Numeral} keys.

{Shift+1}	Remote drive A
{Shift+2}	Remote drive B
{Shift+3}	Remote drive C
{Shift+4}	Remote drive D
{Shift+5}	Remote drive E
{Shift+6}	Remote drive F
{Shift+7}	Remote drive G
{Shift+8}	Remote drive H
{Shift+9}	Remote drive I


<A NAME="D">D: Virtual Name (File description)</A>

X-Finder can give a name (30 characters maximum) to a file or
a directory.

24 characters (8 character x 3 lines) are displayed in Icon
mode, 30 characters in Detail mode and 12 characters in List
mode.

Press {,} to edit the virtual name. {Shift+.}(`) to edit the
virtual path name.

Press {,} to delete the virtual name and press {Enter} to
remove the virtual name.

You can also directly write a file '_.XFN', which contains a
table of real names and virtual names, and place it in the
directory or the archive, which holds the files.  Use '.' as
the real name for a virtual path.

You can also directly write a file '_.XFN', which contains a
table of real names and virtual names, and place it in the
directory or the archive, which holds the files.  Use '.' as
the real name for a virtual path.

_.XFN in a archive should be in uncompressed format. Simply
copying an _.XFN file to an archive within X-Finder will
automatically add it in uncompressed format.

The file _.XFN in the archive of X-Finder has the following
lines.

. .X-Finder
WHATSNEW.TXT What's New X-Finder (Changes)
PAWMICN.DOC PAWmTOP Icon Guide
FINDER.TXT X-Finder User's Guide
FINENV.TXT X-Finder Guide Env file
FINHIS.TXT X-Finder History
FINDER.HLP X-Finder HELP File
FINDER.EXM X-Finder Program
FINDER.ENV X-Finder Env File
FINDER.ICN X-Finder Icon
ICON.LZH File Icon
ICONFLD.LZH Folder Icon
PALMTOP^.LZH X-Finder Palmtop
FINDERS.LZH X-Finder Source Code
FINDERJ.LZH Original Japanese Document

o Icon assignment within virtual names

  You can add an icon description to a virtual name separated
  by '#'.  This character '#' is not displayed as the virtual
  name.

  For example, 'Flash Disk#flash.dsk' specifies the icon
  FLASH.ICN or DSK.ICN.

o Centered display

  If the virtual path name start with '.'character, the virtual
  name is centered when displayed in detail mode.

o Directory command

1. A command can be added to a virtual path name, separated by
   '#'.  This command is run when {ESC} or {Bs} key is pressed.

   Example:  {ESC} or {Bs} returns to the palmtop screen
     More...#\,/
     |       |
     |       +-- command to run when {ESC} or {Bs} is
     |           pressed
     +-- Virtual path name

       Note: '/' is a shorthand for '/Palmtop'

2. By further adding '#', you can specify the command to run
   after changing the directory to the specified path.

     Palmtop##$w 01020
     |        |
     |        +-- command to run
     +-- Virtual path name

   This command can be specified together with the command to
   run by {Esc} or {Bs} key.

   Syntax: (virtual path name)#(Command 1)#(Command 2)
       command 1: command to run by {Esc} or {Bs} key
       command 2: command to run after changing to the
                  specified directory

o Tips for virtual names

Mr. Ron introduced the following tips in FHPPC forum.  Usage of
X-Finder as a mail viewer:

Recently I have changed my mail client from D-Mail to POSTMAN
(included in the Tools of Mr. Satoru Sato).  Since POSTMAN
stores each mail messages in separate files, X-Finder can be
used as a simple mail viewer by extracting 'Subject:' lines
with GREP and writing the result to _.xfn.  X-finder displays
the list of the message titles.

|  YGREP -o -U Subject: *.* >$$$.DAT
|  SED -e "s/:Subject:/ /g" <$$$.dat >_.xfn
|  ECHO _.xfn _. >>_.xfn
|  del $$$.dat

Add this batch file to Special Menu of X-Finder, run it in the
directory where the mail files are stored, and then your
X-Finder magically transforms itself to a mail viewer.
(Excess 'Subject' strings are deleted by SED).

I am satisfied with its high speed in viewing and deleting,
with an advantage of an EXM program that it is easy to copy
and paste to other applications. I will stay with it for some
time, although 'reply' is not implemented yet.

... a bit eccentric usage, I suppose.  Sorry for any confusion.

> If the title of each text files can be viewed as their long
> file names, you may want to use it as an idea processor.

Inspired by this comment, I created another one.

-TITLE.bat-
|YGREP -o -U ^ *.* >$$$.dat
|SED -e "s/:/ /g" <$$$.dat >_.xfn
|del $$$.dat

This batch file extract a long file name from the first line
of each text file.  (Do not attempt to use it in a directory
with a lot of batch files, since it only confuses you).

I am storing text data in one directory and thus apply this
method in that directory.  It is not as useful as a dedicated
idea processor, but as good as similar macro of Vz Editor.


<A NAME="E">E: Icons</A>

X-Finder can use icons used by AppManager and SMMx.

o Rules for icon selection for files and directories

  Rule 1: If the file is icon file, the the icon is displayed.

  Rule 2: If not, search for '(file name without extension).ICN'
  in the directory or archive specified in the environmental
  file.  If found, use it for display.

  Rule 3: If none is found,  search for '(file extension).ICN'
  in the directory or archive specified in the environmental
  file.  If found, use it for display.

  Rule 4:  If none is found by the previous rules, search for
  'file.icn'(in case of a file) or  'folder.icn' (in case of a
  directory or a disk) in the directory or archive specified in
  the environmental file.  If found, use it for display.

  For example a file named 'finder.doc' will start the search
  for finder.icn -> doc.icn -> file.icn in this order, and uses
  the one found first.

  'View Up' icon is viewup.icn.

Have fun with a lot of icons!

Remark:
  If you added an icon, press {F1} key to initialize X-Finder.
  X-Finder reads the icon file names during its initialization
  to enable fast display of icons.

o Creating an icon

Following examples illustrate how to add doc.icn to X-Finder.

- Browse through icons.  It is easy, since X-Finder displays
  icon images for each icon files.

- Select your favorite icon.  Press {F6} and rename its file
  name to 'doc.icn'.

- Mark 'doc.icn', go to 'c:\finder\icon.lzh' and press {F2}
  (copy) key.

- Press {F1} twice for setting up this icon for files 'doc.*'
  and '*.doc'.

  Note: Pressing {F1} key twice refreshes the icon filename
        data in X-Finder.

Default set up procedure will place icons for files and volume
labels in one of the followings:
	c:\finder\icon\
	c:\finder\icon.lzh
	c:\finder\icon.zip

Icons for folders and disks are placed in one of the
followings:
	c:\finder\iconfld\
	c:\finder\iconfld.lzh
	c:\finder\iconfld.zip

Remarks:
- Put icon file in an archive as uncompressed format. Normal
  copying on X-Finder automatically adds an icon file to an
  archive in uncompressed format.
- If Buddy is resident, double click on {F1} will pulls up
  HELP screen of buddy.  Press {F1} key twice with interval,
  or press other key between two keystrokes (for example,
  {F1}{F2}{F1}), to reinitialize X-Finder.

o Recommended Icon collections

  If you are a member of NIFTY, you can download the following
  collections of the icons created for use with X-Finder by
  HAo, Paw and EASY+(PLUS). Practical and enjoyable.
    FHPPC LIB10 #814 ZAUICN  .LZH
    FHPPC LIB10 #803 PAWXFICN.LZH
    FHPPC LIB10 #786 PAWICN2.LZH
    FHPPC LIB10 #772 PAWICN.LZH
    FHPPC LIB10 #684 HAO_ICN4.LZH
    FHPPC LIB10 #651 HAO_ICN3.LZH


<A NAME="F">F: Archive</A>

Archive files with the extension of .lzh, .zip and .arj can be
used pretty much the same way as directories.

Move the cursor to an archive and press {Enter}. You will see a
list of files contained in the archive, just the same way as
you see files contained in a directory.

The listed files in an archive can be handled in approximately
same manner as files in a directory.

X-Finder can handle an archive within an archive within an
archive within...

The bundled environment file support a 'quick extraction' from
an archive with {Shift+Enter} key. 'Quick extraction' can be
used also for an archive with a directory structure.

Limitations:
- File attributes cannot be changed within archive.
- Archives with a directory structure is not supported.
- If you changed an archive within other archive, or an
  archive on a remote drive, move to the parent level with
  {Esc} or {BackSpace} and write back to an archive on the
  parent level.

  From an archive within an archive within an archive, you can
  update the root archive by moving back to the root by {\} or
  pressing {Shift+\}(|) (write back to an archive) key.

o Tips for archive usage

  Files, which has a good compression rate and is not
  frequently changed, would be better to be put into an
  archive. Extraction time is not a big problem if you use a
  high-speedextractor such as lhe. (I renames lhe.com to
  lha.com and places it in the same directory as lha.exe, to
  automatically use lhe to extract and lha to compress)

  *.mid files, played with lxmidi, or *.bmp image files are
  such files better put into a compressed format.  Software
  documents or similar documents are also in this category.

  Note:  You can gain almost nothing, if you have already
         compressed the whole disk.

Make an efficient use of limited disk space through file
compression!


<A NAME="G">G: Symbolic link (Alias or Shortcut)</A>

You can use a symbolic link, when you refer to a file from two
or more directories, for example from a work directory and a
hobby directory.

Mark an item you want to refer to, move to a directory you
want to place the link and press {-}.  This will create a link
file.

A symbolic link file has an extension of .xff for a file or
.xfd for a directory or an archive.

If there is no marked item, then a link is created for the item
at the current cursor position.

The format of a link file is simple. It contains the full path
of the item it links to.

{F9} (Edit) key with a cursor on a symbolic link to a file does
not edit the link file, but the file it links to. You can edit
the link file itself by pressing {Shift+F9}{Paste}. (Thanks to
Mr.Aleph Zero for this tip).  The link file pointing to a
directory can be edited by {F9} (Edit).


<A NAME="H">H: Palmtop</A>

The system displays the 'Palmtop' screen, when it starts up
X-Finder, (similar to Windows starting with 'Desktop' screen).

A directory or an archive can be assigned as the Palmtop
screen, to place directory link files and command files.

Create a symbolic link file and place it on the Palmtop screen
in the same manner as copying files.

Files useful on the Palmtop and their extensions:

.xfd	symbolic link file for a directory or archive
.xff	symbolic link file for a file
.xfe	command file
.xfm	command file (with conform)

.xfk	launching a built-in application
.xfl	launching an EXM program
.xfn	spacing file
.bat	batch file

  Command files (.xfe and .xfm) simply contain commands to run.
  For adding X-Finder specific switches to commands, add them
  after the command with '|' or add them before the command
  with ',' or '||'.  For example, "assign 200 KB of memory,
  run 'mem' command and wait for any key" can be defined as
  follows:
    mem|200k
    200k,mem
    200k||mem

  These command files are different from .bat files in the
  ability to use X-Finder specific switches and macros.

  Switches and macros can be used also with .xfd link files.

  To make a symbolic link file to a:\log, mark a:\log, move to
  the Palmtop and press {-} key.

  To make a symbolic link file to a drive, use any editor to
  write the path to the drive to a file and save it with the
  extension of .xfd.

  Drag-and-drop style usage can be done to .xfm command files,

  .xfk, as defined in the environmental file, launches built-in
  applications by keycode. The last 4 characters of the file
  name defines the start key in hexadecimal notation.  Since
  the file content is ignored, 0 byte file can be used.

  .xfl, as defined in the environmental file, launches EXM
  programs by name. The EXM program with the same file name
  will be launched.  Since the file content is ignored, 0 byte
  file can be used.

  .xfn file is a spacing file created by keystrokes {Menu} E S.
  The environmental file defined this file extension as 'Do
  Nothing'.

  .bat is a DOS batch file. The bundled environment file makes
  batch files on the Palmtop run immediately.

  If you are conscious of the disk space and do not want to
  create a lot of small-sized files, you can put your Palmtop
  files in an archive.  All you have to do is to assign the
  Palmtop path (in the environment file) to the archive file.

o Setting the display order of the items

  The procedure is as follows:
    1) Mark the item you want to move.
    2) Move the cursor to the position you want to move it to.
    3) Press {Shift+.}(`) Then the [Order] dialogbox will be
       shown.
    4) Press {Enter} to move the item.

  Although the procedure is the same as copy or move, there are
  limitations:
    1) It does not work on remote drives (for security).
    2) It does not work in archives, since the speed would
       not be practically fast.
    3) It is slow, when you have large number of
       subdirectories, such as in the root directory.
    4) Sorting should be switched off to make the display order
       to take effect.

  To set the display orders, X-Finder does not directly rewrite
  the directory sectors, as some other filer programs do, but
  rather moves the items to a temporary directory and moves
  back in the new order.

  First the marked items are moved to \XF0.$ in the same drive
  and other items are moved to \XF1.$. Then the items are moved
  back to the original directory in the specified order.

  If an error message of 'Cannot Order' is displayed during the
  operation, you can recover by moving the items in \XF0.$ and
  \XF1.$ back to the original directory.

o How to make spacing

  You can now easily make spacing between icons by:
    {Menu}ES

  The created spacing files can be moved to any places by
  using the display order function.


<A NAME="I">I: Built-in text viewer</A>

Keystrokes and function

{Up Arrow}
{\}
	Scroll back by one line
{Down Arrow}
{Tab}
	Scroll forward by one line
{Left Arrow}
{F2}
	Go to the previous page
{Right Arrow}
{F3}
	Go to the next page
{Enter}
	Jump by hyperlink
{Bs}
{Space}
	Go back to the previous document
{Esc}
{/}
	Quit the viewer
{F1}
	Initialize X-Finder
{F5}
{Fn+=}(Copy)
	Copy 2 KB from the first line on the display to the
	clipboard.
{F6}
	Change to next font available on System Manager and
	DOS.
{F7}
	Go to the top of the current document
{F8}
	Go to the bottom of the current document
{F9}
	Go to the previous anchor tag
{F10}
	Go to the next anchor tag
{Alphanumeric character}
	Link to the specified place within the current
	document, using the character as a key.


o Setting for hyperlink

  Hyperlink is the function to enable the cross reference by
  jumping between referred places with related document
  information, such as HTML used for the web browsers, HELP
  files of HP-LX and Windows, hypercards for Mac and others.

  Link to other document is specified by:
      <A HREF="Filename">anchored text</A>

  Link to a specified place within the same document is written
  as:
      <A HREF="#keyword">anchored text</A>
  where the target of link is specified by:
      <A NAME="keyword">anchored text</A>

  Link to a specified place in other document is:
      <A HREF="Filename#Keyword">anchored text</A>
  where the target of link is specified by:
      <A NAME="keyword">anchored text</A>

  The link description should be the first part of a line, with
  no leading spaces.

  The lines with link description displays only the anchored
  text and do not display the anchor tags such as '<A HREF...',
  nor the words after '</A>'.

  The tags used for link description are subset of HTML. Since
  the <BR> at the end of a line is not displayed, you can
  write a text good for both the X-Finder built-in viewer and
  a Web browser.

  The default path for a filename is the directory or archive,
  where the currently displayed file is located.

o Parameter for running the built-in editor

  The basic syntax is:
    $v (filename)

  The switch of the X-Finder built-in editor specifies the line
  number of the first line to display.
    $v finder.hlp|12
  will display from the 12th line of finder.hlp.


<A NAME="J">J: Remote Link</A>

If you find the remote link failed, press {Alt} to abort the
link.

'*' in front of a drive name is a mark for a remote drive. The
disk on the server is read or written.

The remote link function of X-Finder is not on the operating
system level.  The files on the server cannot be accessed by
applications other than X-Finder on the HP-LX side.

However, an application other than X-Finder can edit a copy of
the file, created on a local Wastebasket (a temporary file
directory), and copy the modified file back to the original
location.  This is the same method used for a file contained
in an archive.

'*' in front of a command is a mark for a remote command. The
command is run on the server. For example
   *dir
will run directory listing command on the server.

Create a temporary directory (c:\lxtemp in the bundled
environment file) on the server, before you run a remote
command. Establishing a remote link and selecting [Remote
Temp] on the Palmtop screen will automatically create this
directory.

A remote command cannot read nor write a local file on the
HP-LX.  Use 'cp' (copy command) to copy a file to the server,
run a command and copy the necessary files back to the HP-LX,
thus making the server a remote accelerator.

X-Finder support the data copy within the server.  The data is
not transferred to X-Finder, but copied on the server itself.

o Remote settings

  baud-	Set up for serial port speed
     115200	115200bps for normal and double speed
     38400	38400bps for normal and double speed
     x2.27	38400bps for 36 MHz crystal

  mode	Data transfer mode
    Wide	Data are transferred through data lines
    		and acknowledged through control lines
    Narrow	Data are transferred and acknowledged
    		through data lines
    X1		Data are transferred and acknowledged
    		through control lines

  Narrow mode needs twice the transfer time of the Wide mode.
  It should be used only if the Wide mode does not work.  The
  transfer speed of X1 mode depends on CPU power. I found It
  needs 1.5 times of 115200bps Wide mode, with a double speed
  HP-LX.

  Note: Wide and Narrow is new names for Turbo and Normal
        respectively.

o Halfrate
  Marking a checkbox of 'Halfrate' enables data transfer with
  a server with baud rates different from HP-LX, such as 8 MHz
  PC from NEC.  It takes twice the time.  It does not work with
  X1 mode.


<A NAME="K">K: Working with the clipboard</A>

o Writing to the clipboard

  The full path of an item on the cursor position is copied to
  the clipboard.  You can use the full path of the file by
  {Paste} key within other application.

  While using the built-in viewer of X-Finder, the full path of
  the file you are viewing is copied to the clipboard.
  Pressing {F5} will copy 2 KB from the first line on the
  display to the clipboard.

  Note: If you launch MemoExpress with a hot key, the name of
	the item is in the edit box.

o Reading from the clipboard

  X-finder reads the contents of the clipboard when it is
  activated and reacts according to the following rules.

  (1) If a full path name is found at the beginning of a line
      contained in the clipboard, X-Finder searches for that
      path and places the cursor on the file.  Not only the
      first line, but also the second line or after can
      contain the path name.

      Example: To hand a file name from LF over to X-Finder,
	press {Copy}{Start key of X-Finder}

  (2) If a full path name, prefixed by '!', is found at the
      beginning of a line contained in the clipboard, X-Finder
      opens that file by an associated application defined by
      its file extension. (The second line or after can be
      used).

  (3) If a command, prefixed by '`', is found at the
      beginning of a line contained in the clipboard, X-Finder
      runs that command. (The second line or after can be
      used).

  Rules (1) and (3) can be used simultaneously.

  This feature can be utilized to use ToDo.exm, FIT.exm
  (created by Fia) or with leaF.exm (created by guel) as
  a launcher.

  If you define '`'+command or '!'+file in a cell of ToDo, you
  can launch a command or open a file by {Copy}{Start key of
  X-Finder}.  You may want to use exkey to assign a single
  keystroke for it:
    <ToDo>
    {Filer}={Copy}{Alt+F8}{Ctrl}

  Within an edit mode of Todo, fit or leaF, press {Paste} to
  write an full path of a file selected (and automatically
  copied to the clipboard) in X-Finder.

  The command or file name can be placed on the second line or
  later.  Thus you can add command title to the first line to
  be better organized.


<A NAME="L">L: The whole disk search and file trees display</A>

X-Finder does not have capability to search through all the
files on a disk, nor capability to display files in tree
structure. However you can use applications such as 'FSEARCH'
and 'WhereIs' for a file search, or 'LF-Tree' for a tree
display.

o For FSEARCH
  Use LFKEY to register the start key of X-Finder to FSEARCH.

  Under JKIT, EXkey has a capability of conditional
  substitution according to the current task name. In this
  case add the following setup:
    <FSEARCH>
    {Filer}={Copy}{Alt+F8}{Ctrl}

o For WhereIs
  Select a file with WhereIs and press {Cut}{X-Finder start
  key} to point to the file on X-Finder.

  If you are using JKIT, EXkey has a capability of conditional
  substitution according to the current task name. In this
  case you may want to add the following lines to your EXkey
  setup:
    <WhereIs>
    {Filer}={Copy}{Alt+F8}{Ctrl}

o for LF-Tree
  Using LFKEY, add the start key of X-Finder to LF-Tree.

  Alternative it to use EXkey under JKIT with conditional
  substitution according to the current task name:
    <LFTREE>
    {Filer}={Copy}{Alt+F8}{Ctrl}

Note: For details, please refer to the documentation of
      WhereIs, FSEARCH, LF-Tree and EXkey.

<A NAME="M">M: Others</A>

Press {Alt} key to interrupt an action such as copying,
deleting or running of marked files.

The cursor can be moved to the vacant place next to the last
item.  This feature enables opening marked files with {Enter}
key, even in a directory with a subdirectories only.  Even if
the cursor is on a directory or an archive, {Shift}+{Enter} or
{Ctrl}+{Enter} will run a command for the marked files.


<A NAME="N">N: Disclaimer of warranty</A>

This software is created with an intent that it should work
correctly.  However no warranty is made for its correct
function.  Its author and its distributor disclaim any
responsibility for the damages, which may be caused by the
usage of, or inability to use, this software. The user should
use it at his/her own risk.

If you have any comments, you can post a message in room 7 in
FHPPC forum, or room 18 in FSHARP forum, on NIFTY. You can
also send a mail message.  Your comment is always and highly
welcome.


<A NAME="O">O: Copyright and distribution policy</A>

This software is a copyrighted freeware.  Distribution is
permitted under the condition that the documentation is
distributed together.

The copyrights of the icons included in ICON.LZH and
ICONFLD.LZH and the document PAWMICN.DOC are owned by Mr.
Paw.

Modification and redistribution of this software is permitted
under the conditions that it is done with a good intention and
that it should not prohibit further modification nor
redistribution.  No prior permission from the original author
is required, however notification to the author is required.

Source code is included in this distribution.


<A NAME="P">P: Literature</A>

"EXM keishiki puroguramingu nyuumon" (Introduction to the
EXM format programming),
"System Manager API Database",
"C Gengo Puroguramingu Ressun (Nyuumon hen)" (C Programming
Lessons - Elementary course),
"DOS/V BIOS to C Gengo" (DOS/V BIOS and C),
"Shiken ni Deru X1" (X1 you will meet in your exam),
"L-os Angeles REFARENCE MANUAL",
"X1 Heiwa Kenkyujo" (X1 Peace Laboratory),
"AYA Ka Ru To" (AYA Carte)


		200LX(double speed, 6MB) + SanDisk(40MB)

Cheers!		RXF10242@nifty.ne.jp  Gaku Nakagawa (Ran M. R.)


Note:
  This document is 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
  FINDER.TXT, which is also included in this package
