home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsr / sorter10 / README
Text File  |  1992-11-30  |  3KB  |  73 lines
  1. ==========================================================
  2. Freeware
  3. Data Files Sorter for Psion 3.
  4. Version 1.00, December 92
  5.  
  6. by Tal Dayan
  7. tal@netcom.com
  8.  
  9.  
  10. By now, I have my new Psion 3 for more than a week and am realy impressed
  11. with it (external) design and  its operating system and
  12. applications. To learn its programming environment and to 
  13. sort my phone book, I have written Sorter which its sorting core
  14. is based on the example in the Programmer's Manual
  15.  
  16. Sorter is a Psion 3 application to sort data files (such as phone books).
  17. It sorts the records by the value of their first field (which in
  18. the case of a phone book, contains the Name field). Case differences
  19. are ignored.  
  20.  
  21. To install Sorter, 
  22.    1. copy the file sorter.app to the applications directory \app
  23.    2. Install it using the <Psion>-I key in the System screen.
  24.       This will add the Sorter icon to the icon list and below it
  25.       you wil see the list of avialable data files (same list as
  26.       in the Data icon)
  27.       
  28. Run sorter in the same way that you run Data (for example,
  29. point on one of its files and press Enter). Sorter will first 
  30. check if they file is already sorted (usefull for Flash SSD) and if
  31. not will sort it.  
  32.  
  33. If you want to compile Sorter, copy sorter.opl to \opl and sorter.pic 
  34. (an icon)to \opd and compile sorter.opl.  
  35. If you want to run it as .opo program
  36. (rather than .opa), comment out the 'app' section in the begining of the
  37. file and compile it.  The code in open:() procedure suppose to handle the
  38. case where the command line parameters cmd$() does not exist (in this
  39. case, it opens a dialog box and enables to select a file).
  40.  
  41.  
  42. Notes
  43.    1. Sorter will refuse to sort a file activated with the <psion>-n (New)
  44.       function as the file does not exists.
  45.       
  46.    2. If the file to be sorted is opened by another application, Sorter
  47.       will show a message and will refuse to sort it.  To sort the
  48.       file, close the application first.
  49.       
  50.    3. Sorter is Freeware and is supplied AS IS.  
  51.       I have checked with with several data files and trust it
  52.       enough to sort my own phone book.  Before using it the first
  53.       time, have a backup of any important data).
  54.       
  55.    4. Any comments (including sppellling ;-) )  are welcomed.    
  56.    
  57.    5. When sorting, the amount of data written to the disk is of the
  58.       same size as the original (and the sorted) file.  On ramdisk
  59.       that's not a problem as the old area is reclaimed automatically
  60.       (no need to Compress after the sorting) when the file is closed.
  61.       On a Flash SSD (which I don't have [yet]) the memory is reclaimed
  62.       only when the drive is formatted, and thus, if the file size is N
  63.       bytes, after the sort you will have less N bytes free.  If an
  64.       already sorted file is sorted again, Sorter detects it and does
  65.       not sort.
  66.  
  67. Tal 
  68.  
  69. tal@netcom.com
  70.  
  71. ==========================================================
  72.  
  73.