home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / S3ACOLL2 / S3ACOLL2.TXT < prev   
Encoding:
Text File  |  1996-09-01  |  9.5 KB  |  298 lines
  1. S3A COLLECTION MANAGER V1.2
  2. ---------------------------
  3.  
  4. Copyright F A Richey 1996
  5.  
  6. INTRODUCTION
  7.  
  8. Installation
  9.  
  10. To install the program simply:
  11.  
  12. 1.   Put S3ACOLL2.APP in your \APP\ directory
  13.  
  14. 2.   If you want to use the optional On-Line Help (Highly 
  15. recommended) put the file S3ACOLLH.OVL into an \APP\S3ACOLL\ 
  16. directory.
  17.  
  18. 3.   If you want to use the optional Print option put the file 
  19. S3ACOLLP.OVL into the \APP\S3ACOLL\ directory and the file 
  20. S3APRINT.DYL into an \OPD\ directory.  Note that this file is 
  21. common to all my programs, so if you have more than one of them you 
  22. only need one copy of this file.
  23.  
  24. 4.   Install (PSION-I) 
  25.  
  26. The program will create an \S3ACOLL\ directory on the internal drive 
  27. for storage of data files. Configuration (and registration) files will be 
  28. put into the \OPD\ directory of your default drive under the program 
  29. name.
  30.  
  31. The unregistered version of this shareware program will allow you just 
  32. 10 Entries/Collection, and 3 Categories to see the capabilities of the 
  33. program.  Following registration you will be allowed 300 
  34. Entries/Collection and 25 for each of the 2 Categories.
  35.  
  36.  
  37. Using the Program
  38.  
  39. Working through the <Menu> commands will show you the capabilities 
  40. of the program, but to get the best out of it, the following description 
  41. takes you through the basic functions and explains some of the finer 
  42. details of operation.
  43.  
  44. Tutorial:
  45.  
  46. There are 2 ways to run this tutorial.  You can either work through it 
  47. from the start, to generate some data files, or you can skip Part 1 and  
  48. use the example files contained in DATA.ZIP.  If you use these files, 
  49. put them into a data directory called \S3ACOLL\ on the Internal Drive 
  50. or a RAM SSD.  Then jump to Part 2 of the tutorial.
  51.  
  52. PART 1 - Generating data files.
  53.  
  54. To start the program, highlight 'Collect' under the Icon.  Now press 
  55. <PSION-N> (New File) to start a new collection (Alternatively, you 
  56. could just press <Enter> and accept 'Collect' as the filename).  For the 
  57. purposes of this tutorial, use 'Records' and if you don't use 'Collect', 
  58. then use the Internal Drive or a RAM SSD as the drive.  The data files 
  59. are saved very regularly, so you should not put them onto a Flash SSD. 
  60. After working through the 'nag screens', select a more descriptive title 
  61. such as 'Record Collection' and go into the main screen.  Next define 
  62. the Titles you want for the various fields.  For the purposes of the 
  63. tutorial, type in 'Title' and 'Artist' as the Names, 'Type' and 'Size' as the 
  64. Categories and 'Cost' and 'Value' as the Values.    Note that you can 
  65. change these later using <PSION-Q>, (Set Preferences) and select 
  66. 'Define Titles'.  
  67.  
  68. We now need to generate some Categories, so press <PSION-SHIFT-J> 
  69. (New Type) and add 'CD'.  Then repeat for 'Vinyl' and 'Cassette'.  Now 
  70. press <PSION-SHIFT-I> (New Size) and enter 'Single' and then again 
  71. for 'Album'.
  72.  
  73. We are now ready to enter some real data.  To do this, either use the 
  74. Menus, <PSION-E> or just press <Enter>.  Just fill in an example 
  75. record, selecting an appropriate set of Names, Categories and Values.  
  76. Then add a few more, making sure you have a good mix of categories.  
  77. Don't worry if the fields overlap on the screen, we will sort that out 
  78. later.  Note that in V1.1, you can select 'New' as a category and it will 
  79. allow you to generate a new category in the middle of entering the data.
  80.  
  81. Now use the same steps to generate a new collection using <PSION-N>, 
  82. and this time use 'Books' as a title, and 'Title' and 'Author' as names,  
  83. 'Group' and 'Type' as Categories and, as before, 'Cost' and 'Value' as the 
  84. Value titles.  For the 'Group' categories use 'Detective', 'Thriller' and 
  85. 'Sci-Fi' and for 'Type', just use 'Hardback' and 'Paperback'.   Finally 
  86. enter some representative books.  Again, don't worry about any overlaps 
  87. in the screen display.
  88.  
  89. This completes the generation of the data files.
  90.  
  91. PART 2 - Screen Configuration.
  92.  
  93. Note:  This Part demonstrates how to configure the default screen 
  94. display to your requirement. For those who used the example data files, 
  95. these have already been configured, but you may wish to follow through 
  96. the tutorial anyway.
  97.  
  98. First, select the 'Records' Group, from the System Screen.  Now go to 
  99. 'Set Preferences' <PSION-Q> and 'Screen Display'.  For the purposes of 
  100. the demo select 'Yes' to all the fields except 'Value', and make sure the 
  101. 'Reset to Defaults' is set to <No>.  (Note the pixel scale at the top of the 
  102. screen to show you what the numbers mean).  Now press <Enter>.  
  103.  
  104. In the second screen set the following:
  105.  
  106.     Date Position        -        10
  107.     Title Position       -         90
  108.     Title Length         -         20
  109.     Artist Position     -     230
  110.     Artist Length       -        20
  111.  
  112. In the third screen set the following:
  113.  
  114.     Type Position       -      320
  115.     Type Length        -          10
  116.     Size Position       -        380
  117.     Size Length         -          10
  118.  
  119. and in the last screen set:
  120.  
  121.     Cost Position         -      400
  122.     Cost Title Position -     440
  123.     Decimal Places       -          2
  124.  
  125. This sets up the screen as shown in the example data file.  In your case, 
  126. you may still have overlaps, in which case you can adjust the settings 
  127. accordingly.  Just remember that you cannot have anything less than 10 
  128. pixels from the left of the screen, so that there is room for the screen 
  129. arrows, and that the total width of the screen is 480 pixels (unless you 
  130. have a Status Window, in which case it is 416 or 448 pixels).
  131.  
  132. In this case, we are probably also interested in the total value of the 
  133. collection, so use the 'Set Preferences' <PSION-Q> option and 'Total 
  134. Window' to select 'Cost'.  Also, it might be useful to have the display 
  135. grouped by Artist, so use the 'Sort By' option <PSION-S> to sort by 
  136. Artist.
  137.  
  138. Now select the 'Books' group, either from the System screen, the menu 
  139. option, <PSION-O>, or just the right cursor arrow.
  140.  
  141. Now repeat the operation, using <Psion-Q> and the 'Screen Display.  
  142. Set:
  143.  
  144.     Date    <No>
  145.     Title     <Yes>
  146.     Author    <Yes>
  147.     Group    <Yes>
  148.     Type    <Yes>
  149.     Cost    <No>
  150.     Value    <No>
  151.  
  152. In the second screen:
  153.  
  154.     Title Position           10
  155.     Title Length             20
  156.     Author Position      170
  157.     Author Length         20
  158.  
  159. and in the third screen:
  160.  
  161.     Group Position     330
  162.     Group Length         10
  163.     Type Position       400
  164.     Type Length           10
  165.  
  166. and this sets up the 'Books' screen display.
  167.  
  168. Other Options that can be configured are the Font Type (through 'Set 
  169. Preferences'), the Font Size <PSION-Z>, the Status Window <CTRL-
  170. MENU> and the 'Date Format' (again through 'Set Preferences').   Note 
  171. that each of these settings are saved with the Group, so they are unique 
  172. to that collection.
  173.  
  174. PART 3 - Menu options:
  175.  
  176. To see the rest of the programs capabilities, just work through the 
  177. MENUs.
  178.  
  179. FILE
  180.  
  181. New Collection
  182. Open Collection
  183. Save Collection As
  184. Delete Collection
  185. Rename Title
  186.  
  187. These functions are self-explanatory.  However, it does bring up the 
  188. important note that you cannot change the filename of a collection from 
  189. the system screen, as there are a number of other files which need to be 
  190. renamed.  The procedure to be used is to 'Save Collection As', using the 
  191. new name, and then 'Delete' the original Group.  Note as well, that the 
  192. left and right arrows will cycle between multiple collections.
  193.  
  194. EDIT
  195.  
  196. Enter Item
  197. Update Item
  198. Delete Item
  199. Move Item Down
  200. Sort Items By..
  201. Edit Memo
  202.  
  203. Again, these are self explanatory, although you should note that 
  204. <ENTER>, <TAB> and <Delete> have the same effect as the first 3 
  205. functions.  Also, the 'Move Item Down' option will only be there if the 
  206. sort option is set to 'None'.  Also, to preempt the next obvious question, 
  207. I did not implement a 'Move Up' option, as all you need to do is select 
  208. the entry above and use 'Move Down' !  The Edit Memo function is the 
  209. same as the one in Agenda.
  210.  
  211. SEARCH
  212.  
  213. Find Text
  214. Find Next Text
  215. Find Date
  216. Find Next Date
  217.  
  218. These options simply do a text search on the 2 'Names' fields, or a date 
  219. search, to find an entry.
  220.  
  221. CATEGORIES
  222.  
  223. New...
  224. Update...
  225. Delete...
  226. New...
  227. Update...
  228. Delete...
  229. Set Filter
  230.  
  231. The first 6 options are self-explanatory.  To see the filter in operation, 
  232. use <PSION-T> and set an appropriate set of categories.  The screen 
  233. will then display just those entries matching the categories.
  234.  
  235. This also  demonstrates the basic difference between the apparently 
  236. similar  'Name'  and  'Category' fields.   The 'Name' fields are free text 
  237. and are searched via the 'Find' option.  The 'Categories' are pre-defined 
  238. and used by the Filter.  You need to decide how you are going to use the 
  239. program before you decide which parameters should be defined as 
  240. 'Categories' and which should be 'Names'.
  241.  
  242. SPECIAL
  243.  
  244. Set Preferences
  245.  
  246.     Define Titles
  247.     Date Format
  248.     Font
  249.     Screen Display
  250.     Total Window
  251.     Entry/Update Dialogs
  252.     Printer Configuration
  253.     Preference Repeat
  254.  
  255.     Most of these have been used already.  'The Printer 
  256. Configuration' allows you to select Parallel, Serial or File, 
  257. the 'Entry/Update Dialogs' allow you to decide if you want all 
  258. fields presented, or just those on the display and 
  259. the 'Preference Repeat' option decides if you keep returning to 
  260. the 'Set preferences' menu.
  261.  
  262. Register Program
  263. Print Setup
  264. Print Preview
  265. Print Details
  266. Zoom
  267. Exit
  268.  
  269. All self explanatory, although the 'Print Setup' includes an extra dialog 
  270. to specify which fields are printed.
  271.  
  272. HELP
  273.  
  274. About
  275. Help
  276.  
  277. And these.
  278.  
  279. Hope all that makes sense.  Any comments on the program (and this 
  280. tutorial), gratefully received.
  281.  
  282. Cheers
  283.  
  284. Al
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.