home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / UTILS / FINDER / FINDER.TXT < prev    next >
Encoding:
Text File  |  1994-03-19  |  14.1 KB  |  351 lines

  1.                               FINDER
  2.                            Version 2.0a
  3.                   Copyright (c) Tom Dolbilin 1994
  4.  
  5.  
  6. Introduction
  7. ============
  8.  
  9. FINDER is an application written for a Psion Series 3a pocket
  10. computer which allows the user to quickly start any application
  11. and switch between any running applications (or open files) in
  12. just two keystrokes. It may be used as an alternative to the
  13. (somewhat slow) System Screen. It may also be useful in the
  14. following cases:
  15.  
  16. 1.   If you do not already have a touch button assigned to a
  17.      particular application. There are only 14 touch button
  18.      combinations that you can use and it is hardly enough for all
  19.      applications you may have installed.
  20.  
  21. 2.   If you do have a touch button assigned but to an application
  22.      which uses multiple files (like Word, for example). Pressing
  23.      the button does not differentiate between the open files and
  24.      always brings you to the most recently used one.
  25.  
  26. FINDER is useful only if it is available at all times, i.e.,
  27. running constantly.
  28.  
  29.  
  30. System Requirements
  31. ===================
  32.  
  33. In order to run FINDER you need a Psion Series 3a pocket computer
  34. with at least 20K of disk space. When running, FINDER is consuming
  35. 17K while in the background and 26K while in the foreground.
  36.  
  37.  
  38. Installation/Removal
  39. ====================
  40.  
  41. Here are the files stored in FINDER.ZIP and where they should go:
  42.  
  43.      File (size)          Description          Target directory
  44.      -------------------------------------------------------------
  45.      FINDER.OPA (19463)   Main program file    \APP\
  46.      FINDER.HLP (6239)    Help file (optional) \APP\FINDER\
  47.      SYS$HELP.OPO (4157)  Help driver (optional)  \OPO\
  48.  
  49. The indicated directories can be created on any local drive
  50. (Internal, A or B). Install the icon for FINDER on the System
  51. Screen. When you first run FINDER, it creates a directory
  52. \APP\FINDER\ on the Internal drive (if it does not already exist)
  53. where it puts its initialization file FINDER.INI. The file is only
  54. a few bytes long and used to store your preferences. If you use
  55. the Run option, FINDER will create another file LIST.ODB in the
  56. same directory. This file is used to store the list of most
  57. recently run applications.
  58.  
  59. To remove FINDER from your system, delete all of the above files
  60. including FINDER.INI and its directory \APP\FINDER\. Remove the
  61. icon from the System Screen.
  62.  
  63. NOTE TO USERS OF PREVIOUS VSERIONS OF FINDER: It is recommended
  64. that you delete the old FINDER.INI file before running this
  65. version.
  66.  
  67.  
  68. Operation
  69. =========
  70.  
  71. When FINDER is running, it displays a list of all running
  72. applications, or tasks. The list can show an applicationÆs name
  73. and the file name of the used file (if there is one). Time and
  74. Calc are examples of applications that do not use files. Data,
  75. Word and Sheet are some of those that do. You can define the
  76. format in which each entry is displayed. It can be set under 'List
  77. options.'
  78.  
  79. Use the arrow keys to move the selector up or down. Most options
  80. in FINDER will affect the currently selected task. For example,
  81. selecting System and then pressing Enter will bring you to the
  82. System Screen.
  83.  
  84. You can assign shortcuts to any of the running applications for
  85. easier identification and switching. The shortcut is a case-
  86. sensitive letter or a number. For example, if you want to assign
  87. "a" to Agenda, first select it and then press "a." Now, whenever
  88. you are in FINDER, pressing "a" will switch to Agenda. Agenda is
  89. not a very good example because you could always press a system
  90. button instead. However, if you use a lot of third-party
  91. applications, this is the fastest way to switch between them. Note
  92. that a shortcut setting for an application is lost whenever that
  93. application quits. To remove a shortcut use Psion-M or Delete.
  94. Shift-Psion-M removes all the shortcuts currently assigned. You
  95. can assign shortcuts automatically using the AutoAssign option.
  96. FINDER will then assign them based on the first letter of each
  97. task. It first uses lowercase letter, then uppercase. If both are
  98. already in use, no shortcut is assigned.
  99.  
  100. Memory graph displays the curve of free system memory and used
  101. Internal disk space changing over time. Think of it as a sheet of
  102. paper scrolling to the left with the drawing needle located on the
  103. right edge. The area shaded with gray is the used memory. The
  104. darker shaded area below is the space on the Internal disk taken
  105. up by files.
  106.  
  107. The built-in Help facility provides the on-line Help on most
  108. features. If you see a "?" in the upper-right corner of a dialog
  109. box -- this means that you can press Help to get context-sensitive
  110. help on this particular dialog. There are a few things in Help
  111. that are not documented in this file so installing it at least
  112. initially is recommended. The Help system consists of two files:
  113. SYS$HELP.OPO and FINDER.HLP. These files are NOT required to run
  114. FINDER. SYS$HELP.OPO is a run-time library that is called by
  115. FINDER when you press the Help key. It displays the Help data
  116. stored in FINDER.HLP. The library is not proprietary and may be
  117. used by other programs. Updates to SYS$HELP.OPO may be available
  118. separately.
  119.  
  120. Pressing the Menu button brings up FINDER menu. The arrangement
  121. of the commands and their descriptions are listed in the
  122. following table.
  123.  
  124. RUN menu
  125.  
  126. Run                 Used to run ANY application that is not in
  127.                     ROM. The resulting dialog asks you to select
  128.                     an application to run. It can be any of the
  129.                     following types: APP, IMG, OPA, OPO, ALS or
  130.                     GRP. You will be subsequently prompted for a
  131.                     file name to open if the application requires
  132.                     it. If you select a GRP (group) file, another
  133.                     dialog box will list you the contents of the
  134.                     group file from where you can also select
  135.                     applications.
  136.  
  137. Run standard        Used to run the built-in applications stored
  138.                     in ROM. Again, if an application requires a
  139.                     file, you will have to enter a file name.
  140.  
  141. Select from list    This option lets you select from the list of 9
  142.                     most recent applications that have been run
  143.                     using the 2 options above.
  144.  
  145.  
  146. TASK menu
  147.  
  148. Switch to           Switches to the currently selected task. You
  149.                     can use the Enter key instead.
  150.  
  151. Rename              You can use this option to give a task a new
  152.                     name. A task name, like a file name, can be up
  153.                     to 8 characters long. It is not remembered
  154.                     after a task exits. Renaming a task has no
  155.                     relation to renaming a file stored on disk.
  156.  
  157. Close               Closing an application is equivalent to using
  158.                     Psion-X from within the application. The open
  159.                     file will be saved to disk before the
  160.                     application closes. Some applications that
  161.                     ignore this command can be killed using the
  162.                     following option.
  163.  
  164. Kill                Kills the currently selected task. It is
  165.                     potentially dangerous because the target
  166.                     application does not get a chance to save
  167.                     files.
  168.  
  169. Info                Displays information about the currently
  170.                     selected task. The task's name, ID, priority,
  171.                     lock status and memory consumption are shown.
  172.  
  173.  
  174. LIST menu
  175.  
  176. Update              Updates the list of running tasks. If the
  177.                     memory graph is on, the 'free memory' figure
  178.                     is also updated.
  179.  
  180. Options             Displays a dialog box where you can specify
  181.                     the way the task list looks and behaves.
  182.                     
  183.                     * QUICK ACCESS MODE is one of the following:
  184.                     Shortcut (when pressing letter keys assigns
  185.                     shortcuts to tasks to be used for switching
  186.                     between them) and Query first letter (when
  187.                     pressing a letter key jumps to the next line
  188.                     which starts with that letter)
  189.                     
  190.                     * SHORTCUT Case-sensitive option set to on
  191.                     makes FINDER to default all shortcuts to
  192.                     uppercase. Otherwise, FINDER distinguishes
  193.                     between upper and lower case.
  194.                     
  195.                     * SORT LIST sorts list alphabetically. The
  196.                     left column is sorted first, then the right
  197.                     column.
  198.                     
  199.                     * FORMAT lets you specify what should be
  200.                     displayed in the list and where. The format
  201.                     affects entries only for file-based
  202.                     applications. See on-line help for definitions
  203.                     of the used codes (you can get help directly
  204.                     from the dialog box).
  205.                     
  206.                     * FONT option lets you select which font,
  207.                     Swiss or Roman, to use for displaying the task
  208.                     list.
  209.                     
  210.                     * AUTOZOOM automatically scales the font size
  211.                     depending on the length of the list to fit as
  212.                     much of it on the screen as possible.
  213.  
  214.  
  215. SHORTCUT menu
  216.  
  217. Remove              Removes the shortcut if there is any from the
  218.                     currently selected task. You can also use the
  219.                     Delete key.
  220.  
  221. Remove all          Removes all the assigned shortcuts if there
  222.                     are any.
  223.  
  224. AutoAssign          Automatically assigns shortcuts to all tasks
  225.                     based on the first letter of the taskÆs name.
  226.  
  227.  
  228. SPECIAL menu
  229.  
  230. About               Displays the information about FINDER.
  231.  
  232. Set preferences     Here is where you set you preferences. All
  233.                     preferences are saved in FINDER.INI so that
  234.                     they are kept even if you exit and restart
  235.                     FINDER.
  236.                     
  237.                     * UPDATE LIST option sets whether the task
  238.                     list should be kept continually updated. If
  239.                     you turn this off, you still can update it
  240.                     manually with Psion-U. The list is not updated
  241.                     when FINDER is in the background. However, it
  242.                     is updated as soon as it comes to front or
  243.                     after you Kill or Rename a task.
  244.                     
  245.                     * UPDATE INTERVAL lets you set the amount of
  246.                     time after which the task list and/or the
  247.                     memory graph are updated
  248.                     
  249.                     * CTRL-SPACE ENABLED lets you set whether you
  250.                     want to use Ctrl-Space as a shortcut to switch
  251.                     to FINDER from another application (and thus
  252.                     saving a touch button for something else).
  253.                     There are a few notes to make about it. First,
  254.                     it will not work if you switch from FINDER and
  255.                     leave a menu, a dialog box or Help on screen.
  256.                     Secondly, it may be very slow to respond from
  257.                     the System Screen. Lastly, it is used in Sheet
  258.                     to select a row of cells, so if you need that
  259.                     feature you may consider disabling Ctrl-Space
  260.                     in FINDER.
  261.                     
  262.                     * PRIORITY setting affects the responsiveness
  263.                     of Ctrl-space from outside FINDER. While
  264.                     higher priority improves the responsiveness,
  265.                     it does NOT affect the performance of other
  266.                     applications.
  267.                     
  268.                     * SHOW MEMORY GRAPH option turns the memory
  269.                     graph on and off. If the memory graph is on,
  270.                     it is always updated every time the Update
  271.                     interval expires. When active, the graph uses
  272.                     6K of memory.
  273.                     
  274.                     * RENAME TASKS tells FINDER to rename all task
  275.                     names (as shown in Task Info) to the names of
  276.                     the files they are using. This option is
  277.                     provided for better compatibility with Macro
  278.                     programs.
  279.                     
  280.  
  281. Zoom in             Increases the font size
  282.  
  283. Zoom out            Decreases the font size
  284.  
  285. Exit                Exits FINDER
  286.  
  287.  
  288. Version history
  289. ===============
  290.  
  291. 1.0  Jan 12, 1994
  292.  
  293.  - The original public release
  294.  
  295.  
  296. 1.1  Jan 14, 1994
  297.  
  298.  - Application names have been replaced by names of open files
  299.      (where possible)
  300.  - Fixed bug in SYS$HELP.OPO which sometimes caused a scrolling
  301.      window to redraw incorrectly when Psion-Ctrl-arrow key
  302.      combination was pressed.
  303.  
  304.  
  305. 2.0  Mar 9, 1994  (Major upgrade)
  306.  
  307.  - Powerful Run feature
  308.  - List format feature
  309.  - Improved Memory graph
  310.  - Context-sensitive help
  311.  - Numerous other features
  312.  
  313.  
  314. 2.0a Mar 19, 1994
  315.  
  316.  - Bug fixed: an application launched from FINDER did not respond
  317.      to its assigned application button (if any). Also, OPA
  318.      applications did not get their proper icon in the status
  319.      window.
  320.  - Bug fixed: launching OPO's by using an alias for RunOPL caused
  321.      a soft-reset.
  322.  - SYS$SHLL is no longer renamed to SYSTEM if Rename Tasks option
  323.      is turned on.
  324.  - A few minor improvements
  325.  
  326.  
  327. Registration
  328. ============
  329.  
  330. FINDER is non-crippled shareware. If you like it you should
  331. consider registering it. The registration fee is US$15. It can be
  332. sent to the address below:
  333.  
  334.      Tom Dolbilin
  335.      3901 Farhills Drive
  336.      Champaign, IL  61821-9305
  337.      U.S.A.
  338.  
  339. Alternatively, you can register FINDER on CompuServe. GO SWREG,
  340. the registration ID is 1882.
  341.  
  342. Thank you for your consideration.
  343.  
  344.  
  345. Disclaimer
  346. ==========
  347.  
  348. The author of this software is not responsible for any damage due
  349. to use of this program. This software is provided without warranty
  350. of any kind.
  351.