Changes from R.9
================

Using the X-Finder's built-in editor, you can press {Enter} at
the underscored line, or simply pressing {A} to {N}, 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: Using an Environmental file of R.9</A>
<A HREF="#B">B: Changes in key assignment</A>
<A HREF="#C">C: Display order and spacing of items</A>
<A HREF="#D">D: X-Finder's built-in text viewer and HELP</A>
<A HREF="#E">E: Icons</A>
<A HREF="#F">F: Virtual names</A>
<A HREF="#G">G: XFE and other files for X-Finder specific commands</A>
<A HREF="#H">H: Synchronized copy/delete operation</A>
<A HREF="#I">I: Command to set screen mode</A>
<A HREF="#J">J: Power management</A>
<A HREF="#K">K: Environment file</A>
<A HREF="#L">L: Simplification and scraps</A>

<A HREF="#M">M: Changes from X-Finder R.8</A>
<A HREF="#N">N: Changes from X-Finder R.7</A>

<A HREF="FINDER.TXT">- Read X-Finder 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: Using an Environmental file of R.9

Roughly speaking, following four items are necessary.

1. Add EXM path

#Default path for EXM
%b	c:\bin

2, Switch off the sorting on the Palmtop screen

#Sort
%s	0001
#	|||+-Directory sort         0:Off  1:Name  2:Type  3:Size  4:Date
#	||+--Directory sort order:  0:Incremental 1:Decremental
#	|+---Palmtop sort           0:Off  1:Name  2:Type  3:Size  4:Date
#	+----Palmtop sort order:    0:Incremental 1:Decremental

3 Set the X-Finder's internal viewer

#Viewer setting (le, lex, vvc, miel, view, pn200, list etc)
%v	,/"	,$v					#XF Viewer

4. If you are using ME or LE, change to normal macros

#Editor setting (me, vz, mini, PalEdit, flexpad, ted etc)
%e	,r	,$x me;$m {Alt+F}o{Bs}{Paste}{Enter};$c	#Memo Express

The above 4 items are minimum condition to start using R.10.
For details, read the other part of this document.

Additionally, following lines should replace the related part
in the environment file, to eliminate the error some people
encountered while using the built-in PIM applications or EXM
programs as associated to file extension.

.icn	,fst	,cp 001 %c %p %a0
	,fsc	,cp 001 %c %p %g0
	,r	,$c %p%c;$x iconedit;$m {Menu}fo{Paste}
	,tq	,$c %p%c;$m {xa400(More)}{f3}{Alt+I}{Paste}{x1700}{Esc}{f3}{f10}	#Select Icon

.ipd	,r	,$c %p%c;$x ip;$m {Esc}{Esc}{Esc}{Ctrl+E}		#IP
.fit	,r	,$c %p%c;$x fit;$m {Esc}{Esc}{Esc}{F9}{Paste}{Enter}	#FIT
.tdb	,r	,$c %p%c;$x todo;$m {Esc}{Esc}{Esc}{F9}{Paste}{Enter}	#ToDo
.mdb	,r	,%c %p%c;$x pjt2;$m {Esc}{Esc}{Esc}{Menu}fo{Paste}{Enter} #PJT2
.adb	,r	,$c %p%c;$m {xb000(ApptBook)}{Esc}{Esc}{Esc}{Alt+F}o{Paste}{Enter}
.pdb	,r	,$c %p%c;$m {xb400(PhoneBook)}{Esc}{Esc}{Esc}{F9}{Paste}{Enter}
.gdb	,r	,$c %p%c;$m {xba00(DataBase)}{Esc}{Esc}{Esc}{F9}{Paste}{Enter}
.ndb	,r	,$c %p%c;$m {xbe00(NoteTaker)}{Esc}{Esc}{Esc}{F9}{Paste}{Enter}

.xfj	,j/	,%x			#Jump
.xfk	,e/	,%x			#Run by KeyCode
.xfl	,/	,$x %x			#Run EXM
.xfn	,	,			#Do nothing


<A NAME="B">B: Changes in key assignment</A>

{Shift+,}	Edit virtual path name
{-}		Symbolic link

Since {Ctrl+-} key in the previous version collided with the
keystroke of buddy, it was changed to {-}.


<A NAME="C">C: Display order and spacing of items</A>

o Display order of items can now be changed.

  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.

  If you want to use the old display order as it is, set the
  sorting order you used and press
    {Shift+*}{Shift+.}{Enter}

  You need to switch off the sorting on the Palmtop screen in
  the environmental file.  (This procedure marks all the files
  and changes the display order of all the files.)

  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 Spacing file can now be created

  Now an easy keystrokes of
    {Menu}ES
  will create a spacing file. The created spacing files can be
  moved to any places by using the display order function.


<A NAME="D">D: X-Finder's built-in text viewer and HELP</A>

o X-Finder's built-in text viewer

  Syntax:
  $v <file name>

  Pressing a start key for MemoExpress (ME.EXM) while using
  the XF built-in editor will put the file name onto the
  Editbox.

o HELP is now displayed

  {F1} will now display HELP screen of X-Finder. Move around
  with arrow keys.

  The initialize now takes two keystrokes of {F1}{F1} (push
  {F1} within the internal viewer).

  If you are using Buddy, press {F1}{F2}{F1}, or press {F1},
  pause for a while and then press {F1} again.


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

  A large number of icons can be displayed now.  The icon with
  the same file name within the same directory is no more
  displayed.

o Icon for compressed icon

  ICN.ICN is displayed as an icon for a compressed icon.

o Improved word wrapping for icon display mode

  In the old versions, a virtual name of 'five men in a boat'
  was displayed as:
	five
	 men
	 in
  Now from R.10, it will be displayed as:
	five men
	  in a
	  boat

o Removed a bug that the directory icon (c:\icon, for example)
  is not displayed initially.

  Reinitialization was necessary in the old version to display
  the directory icons.  This bug was removed.  The '\'
  character at the end of a directory is no more necessary.

#Icon Directory
%i	icon

#Folder Icon Directory
%f	iconfld


<A NAME="F">F: Virtual names</A>

o Virtual name can now specify the icon

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

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 Removed the bug that ';' character cannot be included in a
  virtual file name.


<A NAME="G">G: XFE and other files for X-Finder specific commands</A>

o multiline statement in XFD and XFE file

  More than one lines can be used for more than one
  statements. '#' starts a comment line. Switches are
  initialized for each lines. You need to specify in each
  lines.  The maximum size is approximately 3000 bytes.

  Example: Change directory of the left to C:\ and the right
           to A:\ (<RamDisk Flash Disk>)
    \'<,a:\
    \'<,c:\

o XFK files can now accept incremental search.

  The first 4 characters of a filename are used for an
  incremental search and the last 4 characters are used for
  keycode description for its start key.

  Example: ApptBook
    APPTB000.XFK
    ^^^^

o Drag-and-drop style procedure for XFM files

  .XFM file now accepts drag and drop style handling.

  1. Mark D:\BIN\CCMADE.ICN.
  2. Move to 'HP200LX Icon Editor' on the Palmtop screen
     (bundled in this package).
  3. Press {Enter} to pull up an dialog. Press {Enter} again
     to start editing D:\BIN\CCMADE.ICN by HP200LX Icon Editor.

  ICN200LX.XFM (HP200LX Icon Editor) contains the following
  line:
    D:\BIN\ICN200LX.EXE %p%c

o Timestamps are now displayed for the XF? files within an
  archive.


<A NAME="H">H: Synchronized copy/delete operation</A>

If you conduct synchronized copy with file deletion, the file
deleted at the source will be automatically deleted at the
destination.  When this function is used for the backup of
files in the 100/200LX, the files on the Server becomes the
exact copy of the files on the 100/200LX.  The backup command
bundled with R.10 utilized this synchronized copy/deletion.

  cp	Copy
    Syntax: cp @#$ filename source destination
    @=0 Copy	@=1 Move	@=2 Synchronize
    #=0 File	#=1 Directory
    $=0 Update	$=1 Overwrite

Example: Back up RAM Disk to A:\CDRV (RamDisk Backup to Flash)
  cp 210 . C:\ A:\CDRV
     ^
Note: Please be careful not to use this function incorrectly,
      since this would cause an unwanted deletion of files you
      need.(An incorrect path will cause this problem).


<A NAME="I">I: Command to set screen mode</A>

$w <digits>

$w	01020
#	||||+-Left window		0:Icon 1:List 2:Detail
#	|||+--Right window		0:Icon 1:List 2:Detail
#	||+---Palmtop screen		0:Icon 1:List 2:Detail
#	|+----Directory screen mode	0:Full 1:Split
#	+-----Palmtop screen mode	0:Full 1:Split

The parameter is the same digit defined to the '%w' in the
environment file.


<A NAME="J">J: Power management</A>

If you use DataComm, Filer, or other system manager
applications which uses serial port, while powered by an AC
adapter, the power management of the 100/200LX will go wrong.
The serial port will be switched on and can never switched off.

X-Finder now automatically modifies the power management,
switches off the serial port when the machined is powered by
the batteries.

X-Finder now displays the battery voltage.


<A NAME="K">K: Environment file</A>

o Definition of directory paths

  If no full path is available for a directory path, it is now
  regarded as a relative path from the directory, where the
  environment file is placed. For example, if c:\finder
  contains finder.env, the description 'icon' is regarded as
  'c:\finder\icon'.

o c:\finder and a:\finder are added for a directory to hold
  finder.env.

  c:\finder and a:\finder are added to the previous c:\_dat
  and a:\_dat.

  The search order is c:\finder -> c:_dat -> a:\finder ->
  a:_dat.

o switches

  ',' now works as separator for the prefixing switches, as
  well as '||'. For example the following three lines has
  exactly the same meaning of'Assign 200 KB, run mem and wait
  for any key'.
    200k,mem
    mem|200k
    200k||mem

o New switches for 'valid on the Palmtop'

  'p' is introduced as a switch for specifying validity on the
  palmtop.

  The following configuration will run a batch file only on
  Palmtop directory (or the directory containing '^') and open
  it with an editor on the other directories.

  .bat	,	,%c %k				#bat
  	,p	,%c

o Switch 'u' is revived

  u	open the file on the cursor position, even if there are
	marked files

  =c	,u	,$m {F2}


o Date format can now be selected from 4 types

  mm/dd/yy, dd/mm/yy, dd.mm.yy is added.

  Setting of the date format is defined within '%y' in the
  environmental file.

  #Show disk space and date
  %y	00
  #	|+-Shown disk space: 0: No, 1: Yes
  #	+--Date format: 0:yy-mm-dd 1:mm/dd/yy 2:dd/mm/yy 3:dd.mm.yy

o A default EXM path can now be defined, to be used to run a
  unregistered EXM program with '$x' command and filename
  without full path.

  In previous versions, the setting of 'run.exe' was used,
  when the full path is not available.  Now the defined path
  is used.

  Write the path after '%b' to set it to the default.  Only
  one path can be defined.

  #Default path for EXM
  %b	c:\bin


<A NAME="L">L: Simplification and scraps</A>

o Command for LE and ME are removed

  Special commands for LE and ME are removed.  Normal macros
  should be used to run LE and ME, as you will find samples in
  the FINDER.ENV,

o Cut and paste of files are simplified

  'Cut & paste' and 'copy & paste' are simplified.  The usage
  is the same but the styles are changed.

o {Menu}P (Path) is now removed

  {Menu}P (Path) function is removed. Use {F5}(Goto), select
  by arrow keys and {Shift+Esc} or {Shift+Bs} instead.

o Free memory area is increases

  Now we have additional 1 kilobyte of free memory.


<A NAME="M">M: Changes from X-Finder R.8</A>

(1) New features in R.9

o Palmtop definition
  The palmtop definition is changed. Please transfer to the
  new format, according to the setup in the user's guide of
  X-Finder.

o Synchronization of virtual names
  Virtual names now synchronize with copy, move and delete
  actions.

o Icon launcher
  The full path containing '^' character will be displayed in
  the same manner as in the Palmtop screen. To use this
  feature as an icon launcher, make a directory with a full
  path containing '^' and place a symbolic link file on the
  Palmtop.




o launching EXM programs which are not pre-registered
  $x command can launch EXM programs, which are not registered
  to apname.lst nor moreexm.ini.  "run.exe" is no more needed.

  Non-registered EXM program should be specified in full path.
  (Do not forget the extension '.EXM').  Switch '1' suppresses
  the clear-screen action.

  Example: Launch C:\BIN\FSEARCH.EXM
  $x C:\BIN\FSEARCH.EXM

  Example: Launch C:\BIN\LFTREE.EXM in overlapping screen.
  $x C:\BIN\LFTREE.EXM|1

o _.XFN
  The file _.XFN is now handled as hidden file.

(2) Usages

{Shift+Esc}		Go to the previous path
{Shift+BackSpace}	Go to the previous path

When you use symbolic link and move to a new path, it was
difficult to go back to the previous path.  Now you can move
back easily with these key strokes.

(3) Environment File

I forget to document this change in X-Finder R.8.

#add to .lzh
%c	,192+l	,#lha u -zicn -zxf? -amx
		                  ^
	                           change 'n' to '?'.

If you would like to use the environmental file of X-Finder
R.8, you should modify the following items.

o Items to be deleted
  "#Keycode for MemoExpress or Memo Editor" should be deleted
  as it is now unified with the viewer setting.

  "#Keycode for starting LogExpress" should be deleted as it
  is now unified with the editor setting.

o Execution by matched extension
  Execution by matched extension for EXM program should use $x
  command with a  full path file name (with a extension) as a
  parameter.

  .exm	,q	,$x %p%c			#run exm

  You can run non-registered EXM programs from its link file
  placed on the Palmtop, for example.


<A NAME="N">N: Changes from X-Finder R.7</A>

(1) New Features in R.8

o Split screen
  {Shift+Tab} toggles Full/Split screen. {Tab} moves the
  cursor to the opposite window.

o New format for Palmtop screen
  Additional to the old format, where commands and directories
  are written in the environmental file, a new definition
  method is introduced. Now a directory or an archive contains
  symbolic link files and command files to define the Palmtop.

  This method enables easy modification of the Palmtop screen
  by creating directory link files, in the same manner as
  copying a file.

  Following files should be placed on the Palmtop
  .xfd	Symbolic link file for a directory or an archive
  .xff	Symbolic link file for a file
  .xfe	Command file
  .xfm	Command file (with confirmation)

  The first line in command file .xfe and .xfm is handled as a
  command. It is different from a batch file (.bat) as
  X-Finder specific switches and macro can be used.  (Switches
  and macros can be used also in .xfd files)

  If you want to use X-Finder specific switched in the
  command, you add them after the command with '|' as a
  separator, or add them before the command with '||' as a
  separator.

  Example: Reserve 200KB, run MEM and wait for any key stroke.
  mem|200k
    or
  200k||mem

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

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

  If you do not like to have a lot of small files for the
  Palmtop (as they tend to eat up the limited disk space),
  then you can store them in a archive file.  In that case,
  you should specify this archive file, instead of directory,
  as your "Palmtop path" setting.

o Virtual name

  Now virtual long name can be added also to a current path
  name, such as A:\BIN.  A virtual path name starting with '.'
  will be centered.

o Archive file
  A _.XFN file or icon file is now stored in uncompressed
  format automatically,when added to .zip or .arj.

  Addition to .lzh archive is now faster, with the use of a
  response file.

  Virtual name can be edited also within an archive.

o Switches

  New switches are as follows:

   %	Valid only with split screen
   >	Valid on the right-hand window
   \'	change directory of the opposite window as specified
	in the command
   \<	change current directory to the left window path
   =	stuff the command into the clipboard and run

  \',c:\
  This line with open RamDisk on the opposite path.

  \'<,a:\;c:\
  This line changed directories of the both windows (right and
  left) as specified.

  =,D:\_SYS\TOPCARD.PCX
  Move to the specified file (in full path).

  =,!D:\_SYS\TOPCARD.PCX
  Move to the specified file (full path) and run the program
  associated with the extension.

  Following switches are now obsolete:

  Switch 'u' (Expand the file at the cursor position even if
  there are marked items) is not obsolete. Other than the
  execution with filename/extension matches, the default is
  now to expand the file at the cursor position even in there
  are marked items. Switches 'f' or 'm' will override this
  default.

o Macros

  New macros are as follows:

o Macros

  New macros are as follows:

   %m	Path name of the opposite window	c:\other\
   %n	Path name of the opposite window (no	c:\other
	trailing '\')
   %z0	Environment File 		     c:\_dat\finder.env
   %z1	Palmtop file 			     c:\_dat\finder.xpt
   %@	Content of file

(2) Usage
  {Tab}		Switch to alternate screen or move to the other
		window
  {Shift+Tab}	Toggle the screen mode between full and split.
  {Ctrl+Tab}	Toggle display of hidden files
  {Shift++}(%)	Make a copy with a new name.
  {F6}{Tab}	Make a copy with a new name.

  {=}		Set the opposite window to the current path.
  {Shift+=}(~)	Exchange the left and right windows.
  {,}		Edit virtual name
  {Ctrl}	Conduct incremental search for a string
  		beginning with a numeral.

  {Esc} or {Bs} does not lead from the root directory to the
  Palmtop. Press {0} instead.

  {2}, {7}, {8} and {9} no more works as moving to a drive.
  They are now definable keys.

(3) Environment file

  If you use the environment file of X-Finder R.1 to R.7, the
  following modification is necessary.

  Obsolete item is as follows:

  #Double click setting (%b)
  This item is no more supported and should be deleted.

  Changed items are as follows:

  #Sort
   %s	0001
   #	|||+-Directory sort 0:Off 1:Name 2:Type 3:Size 4:Date
   #	||+--Directory sort order 0:Incremental 1:decremental
   #	|+---Palmtop sort   0:Off 1:Name 2:Type 3:Size 4:Date
   #	+----Palmtop sort order   0:Incremental 1:decremental

  New numbers are assigned to specify the sorting method.
  Sorting method for the Palmtop screen is now independently
  specified.

  #Icon/List/Detail mode and Full/Split screen
  %w	01020
  #	||||+-Left window		0:Icon 1:List 2:Detail
  #	|||+--Right window		0:Icon 1:List 2:Detail
  #	||+---Palmtop			0:Icon 1:List 2:Detail
  #	|+----Screen mode 		0:Full 1:Split
  #	+-----Palmtop screen mode	0:Full 1:Split

  Now X-Finder can start with split screen.  Display mode for
  opposite path and the Palmtop can be specified separately.

  New Items are as follows:

  #Palmtop path
  %z	c:\palmtop

  Old palmtop format is deleted from the environment file.
  After you change the setting, decompress palmtop.lzh into
  c:\palmtop.

  Delete "#Use ZCOPY.COM" item.
  #Use ZCOPY.COM
  %z	1

