home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PILOT / database / JFILE / JFILE.TXT < prev    next >
Encoding:
Text File  |  1997-08-04  |  9.7 KB  |  250 lines
  1. *********        Quick Documentation For JFile 1.6b          ***********
  2.  
  3. !!!!!!!!IMPORTANT NOTES!!!!!!!
  4.  
  5. - JFile users can install this program right over top of the older one.  
  6.  
  7. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  8.  
  9.  
  10. *****    CHANGES section moved to the bottom of this file   *******
  11.  
  12. Features:
  13.  
  14. - Filtering of records
  15. - Sorting on secondary and tertiary sort fields
  16. - Forward and reverse sorting by field (when tapping column heading twice)
  17. - Columnal formatting when viewing a database
  18. - Cut/Paste between fields
  19. - Local find function in the database view
  20. - Columnal formatting in the database view
  21.  
  22. Limitations:
  23.  
  24. - 30 databases (2 in the unregistered version)
  25. - field names can be no longer than 20 characters
  26. - 20 fields per databases
  27. - 500 characters per field of data
  28.  
  29.  
  30. *****************************     USAGE      *******************************
  31.  
  32. *****  Viewing LONG fields:
  33.     
  34.     If you have a lot of data in one field (more than 200 characters
  35. usually), and it spills of the screen, you will need to drag the cursor 
  36. down the the field (ie. selecting the text) to scroll to the remainder of 
  37. the data in that field.  This may be modified in the future for easier
  38. usage of long data fields.
  39.  
  40. *****  Creating A New Database:
  41.  
  42.     To create a new database, tap the 'New DB' button.  Enter the 
  43. name of the database, and a minimum of 1 field name.  Then tap the 'Create'
  44. button.  You're done... you have a new Database ready add records to.
  45.  
  46. *****  Viewing A Database:
  47.     
  48.     While on the main view screen, tap on the title of the database
  49. you would like to view.  A new screen comes up, with the title indicating
  50. which database you are in.  For a new database you will see only the
  51. column/field headings.  To add a record to your database...
  52.  
  53. *****  Adding Records To A Database:
  54.  
  55.     While viewing a database, tap the 'Add' button.  You will be 
  56. presented with a form showing the field names, and space to enter your
  57. data.  When through editing your data, tap 'Done' to save the changes,
  58. 'Cancel' to cancel them, and 'Del' if you wish to delete the record 
  59. from the database.
  60.  
  61. *****  Sorting a Database:
  62.  
  63.     While viewing a database, you can tap on any of the column 
  64. headings to sort the database by that particular column/field.  Tapping
  65. the same column heading again will sort the database in the reverse order.  
  66. Columns of all INTEGER values will sort properly.  
  67.  
  68.     A new menu option to sort the database with secondary and tertiary
  69. sort fields is now available.
  70.  
  71.  
  72. *****  Horizontal Scrolling
  73.  
  74.     Horizontal scroll buttons added to the database view.  The first
  75. column is a non-scrollable column (as this has been most requested to keep
  76. this as a 'base' column) and any other visible column will now scroll
  77. left and right through the available fields.
  78.  
  79. *****  Field name modification
  80.     
  81.     You can now change the names of fields after the database has been created.
  82.     
  83.     You can also add fields to the end of the field list, and delete fields from
  84. the database.  
  85.  
  86. NOTE HOWEVER: that deleted fields will be replaced by the field that 
  87. followed it.  Ie:
  88.  
  89. Previous fields:
  90. Name:
  91. Address:
  92. Phone:
  93.  
  94. You can then remove Address: and replace with Phone: but you will LOSE you old 3rd
  95. field (Phone) and Phone data will actually be Address data already entered.  This is
  96. a bit complex... so for now it is best to stay away from field deletion unless you
  97. have no data in the database as yet, or understand how the deletion works.  In essence
  98. you are replacing the Address: field name with Phone: field name, and removing the Phone:
  99. field... no data transfer is done, just the field name change, and the removal of the 
  100. third field completely.
  101.  
  102. *****  Changing the Columns Format:
  103.  
  104.     While editing a record, you can use the Menu to increase or 
  105. decrease the amount of space allotted to the data fields.
  106.  
  107.     Likewise, in the database view, selecting the menu item
  108. 'Column Formatting' will take you to a setup screen to determine how you would
  109. like to view the database.  You have up to 20 columns to display your data
  110. in.  Each field (1-20) gets its own column.  You can set the number of columns
  111. you would like to see on the main database screen, as well as the width of 
  112. each column.  For instance, say you have the following fields:
  113.     State Name:    (field 1)
  114.     State Bird:    (field 2)
  115.     State Cap.:    (field 3)
  116.     State Flower:  (field 4)
  117. But only wanted to view the State Name and flower in the main screen.  You would
  118. then choose 0 widths for columns 2 and 3, and appropriate widths for columns 1 and
  119. 4.  You have up to 160 pixel width to work with so an possibility is:
  120.     Column 1 Width: 90
  121.     Column 2 Width:  0
  122.     Column 3 Width:  0
  123.     Column 4 Width: 70
  124. This will show 90 pixels for the state name, and 70 pixels for the state flower.
  125.  
  126. ********************************************************************************
  127.  
  128. Changes Since 1.6a:
  129. - Fixed a number of problems dealing with older Pilot sorting with JFile
  130.  
  131. Changes Since 1.6:
  132. - Quick fix of the error resulting from a Hardware 'UP' button press
  133.     when already at the top of the database list
  134.  
  135. Changes Since 1.5b:
  136. - Major fixes/changes to the handling of long field records - 
  137.     scrollers (onscreen and button) should work properly now
  138. - Fixed Up/Down hardward scroller buttons in Main database view
  139. - Fixed a problem dealing with installing JFile after a hard reset
  140.     of the pilot - which would sometimes cause JFile to produce
  141.     an error.
  142.  
  143. Changes Since 1.5:
  144. - Speeds up redraws and sorts that was heavily reduced in version 1.5
  145. - Eliminates the bug when doing multiple field sorts
  146. - Other smaller bug fixes
  147.  
  148. Changes Since 1.4a:
  149. - Fixed a bug that caused a conflict with SelectHack (!)
  150. - Max field length increased to 500 characters per field 
  151. - Again had to correct the alarm bug when viewing a database and alarm triggers
  152.     on a 1000 or 5000 series model
  153. - Fixed bug in Find dialog where a garbage characters might show up
  154.  
  155. Changes Since 1.4:
  156. - Bug fix, corrected the fatal error on longer fields in the edit record screen
  157.  
  158. Changes Since 1.3:
  159. - JFile will now return you to the database or item you were currently viewing
  160.     when you last exited the application 
  161. - Space and backspace graffiti characters now simulate the left/right scroll
  162.     arrows while viewing a database
  163. - Added command shortcuts for Filter, Sort, and Show All
  164. - Add a checkbox on Find & Filter to ONLY find/filter those records with 
  165.     fields BEGINNING with the find/filter string
  166. - Added Goto top and bottom of the database menu items (with command shortcuts)
  167. - Added menu item to jump ahead or backward a specific number of records for
  168.     quicker navigation in longer databases
  169. - Hardware up/down scroll buttons on MAIN screen now scroll a full
  170.     screen of db's at a time
  171. - Fixed problems when editing a record, longer fields would not scroll properly
  172.  
  173.  
  174. Changes Since 1.2:
  175. - Added next/previous graffiti strokes to the record view to easily 
  176.     move between fields without extra tapping
  177. - Added next/previous field menu items and 'Commands' also for
  178.     easier movement between fields
  179. - In the show all databases view - the database names are sorted alphabetically
  180. - Switching apps while modifying a record will now save the modifications
  181.     made
  182. - Bug fix: Fatal error if an alarm comes up while viewing a database fixed
  183.  
  184. Changes Since 1.1b:
  185. - Added 'Please Wait' blinking message for longer sorts/finds/filters
  186. - Focus set to initial fields on most dialogs
  187. - Auto capitalization on initial field focus
  188. - Filter function added
  189. - Fields with integers and text interspersed now properly sort as text fields
  190.     ie. you can sort by date if in the form year/month/day
  191. - Adding sorting by secondary and tertiary sort fields
  192. - Find and filter work on individual fields if desired
  193.  
  194. Changes Since 1.1a:
  195.  
  196. - This is a small bug fix release
  197. - Numerous uncommon bugs fixed
  198.  
  199. Changes Since 1.1:
  200.  
  201. - Fixed errant Find function
  202.  
  203. Changes Since 1.0 beta-4:
  204.  
  205. - Ability to have record and database deletion confirmation as an option
  206. - Ability to backup databases on a per-database basis
  207. - The inverted screen bug should no longer be seen
  208. - Screen clutter removed on some of the tables
  209. - Current record position is now remembered if you edit a record and
  210.     return to the database view
  211. - A BIG speedup when viewing databases - especially larger ones
  212. - Numerous other smaller fixes and additions
  213.  
  214. Changes Since 1.0 beta-3:
  215.  
  216. - Name change for the app 
  217. - Left/right scroll buttons on record view form to go through the records
  218.     sequentially
  219. - Hardware scroll buttons now scroll full pages at a time
  220.     Pen tap scroll buttons still function as line at a time scrolling
  221. - Beta-4 should not have problems handling older beta database
  222. - Delete record toggle button added to database view
  223. - Horizontal scrollers reposition to top of screen 
  224. - Bug fixes include:
  225.     - more fixes on the app-switching problems while editing a record, or
  226.         creating/editing a new database
  227.     - numerous other smaller bug fixes
  228.  
  229. Changes Since 1.0 beta-2:
  230.  
  231. - Quick fix to the NewDB button followed by cancel = ERROR... this is fixed now
  232.  
  233. Changes Since 1.0 beta-1:
  234.  
  235. - Added left/right scroll buttons to the show database form
  236. - Up to 20 fields now available
  237. - Up to 200 characters of data per field now allowed
  238. - Sorting on all INTEGER fields allowed 
  239. - Local find function no longer depends on upper/lower case
  240. - Field name modification/deletion/addition added 
  241. - Graffiti state indicator added to 'Find' dialog
  242. - Bug fixes include: 
  243.     - the UUUUU lines that sometimes appeared when switch apps fixed
  244.     - error when switching apps from edit record view after deleting a
  245.         field fixed
  246.     - ghost characters left over when trying to remove a line of data 
  247.         fixed
  248.     - many other misc fixes (spelling errors, new buttons etc)
  249.  
  250.