home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsf / jbtr424a / JBTREE.TXT < prev   
Text File  |  1995-04-23  |  24KB  |  526 lines
  1.                                 JBTree
  2.                             Version 4.2.4
  3.                            (c)JBSoft 1992-5
  4.  
  5. This is a program which displays the directories and files on any disk
  6. (internal or external). It shows the current directory and other
  7. directories at the same level, plus any directories immediately
  8. subordinate to the directory on which the cursor is on. It also
  9. displays the files in the current directory - the date will take the
  10. same format as that set in the Time application. The program is free
  11. for your use but I retain all copyright on the code (where applicable
  12. - some of the Pack information was provided by Wolfgang Schirmer and
  13. Matthew Millar - thanks).
  14.  
  15.  
  16. N.B. If you can't be bothered to plough through this document please
  17.      note that Copy, Move etc. only work after you have Marked the
  18.      file using the Space Bar or the Enter key. Also, for
  19.      installation, please read that section or you'll be sorry <g>!
  20.  
  21. Background
  22. ----------
  23. This utility was first started in the days of the Series 3 but I only
  24. got it to a reasonable state on the appearance of the Series 3a. It
  25. has been translated, and therefore will only run in its present state,
  26. on an S3a although I suspect it could be adapted to compile and run on
  27. an S3 with some compromises. There are some limitations which I
  28. suspect you will discover as you use it.
  29.  
  30. Manual and Usage
  31. ----------------
  32. This is work in progress (I suppose, as I keep changing it) and so it
  33. comes without a proper manual (it's also got fairly complex and I
  34. don't really have the time to write a proper one). This document is
  35. getting close to turning into a manual as I expand on it. Help is
  36. available on the HELP key at most times and, as with most OPL
  37. programs, you can escape using Psion-Esc or Psion-X at almost any
  38. time.
  39.  
  40. The history information (which used to appear at the end of this text
  41. file has been moved to a new file called JBTHISTR.TXT as it was
  42. getting rather large.
  43.  
  44. Installation
  45. ------------
  46. The files listed below should be part of the JBTree ZIP file:-
  47.  
  48.         JBTREE.OPA - The main part of the program
  49.           JBTL.DBF - Install if Launch is to be installed
  50.         JBTREE.DBF - Data file required for View/Run options
  51.            JBT.DBF - My example file of JBTREE.DBF (included as part
  52.                      of the explanation - should not be installed
  53.         JBTREE.TXT - This file/manual
  54.  
  55. Copy JBTREE.OPA to any directory (normally \APP\ but this is not
  56. mandatory) and install it in the usual way using Psion-I. If you
  57. require to view files using their native application then the file
  58. JBTREE.DBF should also be placed in the \APP\ directory. When JBTree
  59. is first run the file is moved to a sub-directory off the directory
  60. JBTree is installed in called \JBTREE\ (e.g. \APP\JBTREE\).
  61.  
  62. This sub-directory drive for the configuration files can be chosen
  63. and, if the JBTREE directory does not exist, then a dialog to choose
  64. the drive will be given. The directory should be created automatically
  65. - if not, it is permissible to generate it manually. Please note that
  66.  
  67. if the parent directory (normally \APP\) does not exist then this
  68. automatic installation may fail.
  69.  
  70. If you are updating your version then you will have to manually move
  71. the configuration files to the appropriate directory. The program
  72. looks for these files in a directory off the directory that JBTREE.OPA
  73. is in (i.e. if JBTree is in \JBT\ then the configuration files MUST be
  74. in the directory path \JBT\JBTREE. This path can, however, be on a
  75. different drive to that of the OPA file.
  76.  
  77. There has been one instance of the directory not being created of
  78. which I am aware although this problem was not repeatable.
  79.  
  80. If you require the Launch menu then JBTL.DBF should also be placed in
  81. the \APP\ directory. This will be moved to the appropriate directory
  82. by the main program when it is first started.
  83.  
  84. N.B. Care should be taken when upgrading the program - no datafiles
  85.      will be overwritten if they already exist in the \JBTREE\
  86.      directory when the program is started. If you wish to upgrade (or
  87.      replace) the datafiles then the original datafiles in the
  88.      \JBTREE\ directory must be deleted first or the files concerned
  89.      manually transferred to this directory.
  90.  
  91.      JBTL.OPO which was required for version 4 and 4.1 is not now
  92.      needed and will be automatically deleted when JBTree is first
  93.      run.
  94.  
  95. Starting the program
  96. --------------------
  97. To start the program place the cursor on the JBTree word and press
  98. Enter to start the program.
  99.  
  100. After starting the program you are prompted for a Drive - if the 3-
  101. Link is active then, before the drive menu is accessed, a choice of
  102. Local or Remote is given. Remote means drives on the remote computer.
  103. If the drive you wish to access is not shown on the menu then press
  104. Esc and you can then select almost any drive (including the ROM) with
  105. the dialog displayed at this point.
  106.  
  107. N.B. If the letter keys (e.g.'F') do not appear to work or do not work
  108.      as expected, check that you do not have CAPS LOCK on. The S3a is
  109.      case sensitive on the keys checking. Unfortunately, unlike the
  110.      good old Organiser II, it does not appear possible to alter the
  111.      state of the CAPS LOCK from within the program using OPL so
  112.      please be sure that this is switched off whilst using the
  113.      program.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. Keys Used
  134. =========
  135.  
  136.                            General
  137.                            -------
  138.                             : Up
  139.                            : Down
  140.                         PgUp: Page Up
  141.                        PgDn: Page Down
  142.                  Ctrl-Psion-Up/Home: 1st Dir
  143.                 Ctrl-Psion-Down/End: Last Dir
  144.                     Tab: Files/Dir switch
  145.                   Diamond: Files/Dir switch
  146.                     Psion-J: Info (About)
  147.                         Psion-S: Sort
  148.                #(character key): Goto dir/file
  149.                 Psion-Shift-C: JBTree Config
  150.                  Psion-Shift-F: View Config
  151.               Psion-U: Update Directories/Files
  152.                      Psion-F: Pack Info
  153.                Shift-Psion-L: Launch sub-menu
  154.                         Psion-X: Exit
  155.  
  156.                       In Directory Tree
  157.                       -----------------
  158.                     Psion-D: Change Drive
  159.                          : Sub-Dir
  160.                           : Up-Dir
  161.                       Psion-+: Add Dir
  162.                       Psion--: Del Dir
  163.                      Psion-C: Copy Dirs
  164.                      Psion-M: Move Dirs
  165.                      Psion-R: Rename Dir
  166.                  Psion-Shift-D: Delete Dirs
  167.                    Psion-L: Look for File
  168.                      Psion-A: Look again
  169.                Ctrl-A/B/M: Quick drive change
  170.  
  171.                         In Files List
  172.                         -------------
  173.                  Psion-I: Toggle Files Info
  174.                    Psion-T: Mark All Files
  175.                Psion-Shift-T: Unmark All Files
  176.                    Space: Mark file toggle
  177.                 <CR>: Mark toggle + Move down
  178.                        Psion-D: Delete
  179.                         Psion-C: Copy
  180.                Psion-(Shift)M: Move (& Rename)
  181.                        Psion-R: Rename
  182.                 Psion-Shift-R: Copy & Rename
  183.                   Psion-A: File Attributes
  184.                         Psion-N: Info
  185.        Psion-(Shift)V/Psion-H: View file(in Word)/Hex
  186.  
  187.  
  188. Moving Around
  189. -------------
  190. Use the cursor keys in the normal way. To go to a sub-directory use the
  191. right arrow key, to go to the parent directory above the present one use
  192. the left arrow key. To flip between the Directory list and the Files list
  193. use Tab or the Diamond key. If in the Files list then Escape will also take
  194. you to the Directory list. To change the drive use Psion-D whilst in the
  195. directory list. An alternative, if just the local drives are required, is
  196. to use Ctrl-A -B or -M. This bypasses the dialogs and so speeds up the
  197. selection a little.
  198.  
  199. It is possible to jump to a directory or file within the current list by
  200. using 'c' where