home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d02xx / d0230.lha / FileIt / manual < prev    next >
Text File  |  1989-07-22  |  9KB  |  201 lines
  1.                                     File-It
  2.  
  3.                                   User Manual
  4.  
  5.                                     J Davis
  6.  
  7.                                     1987/88
  8.  
  9. Introduction
  10.  
  11. File-It is designed to allow the user to store information on a computer much
  12. as you would store information in a real life card file. 
  13. It is designed to allow great flexibility in searching the database, at some
  14. expense in speed of searching.  It also allows great freedom in the on-screen
  15. layout of a 'card', and can output these 'cards' in a form suitable for
  16. printing or for use within other programs. The program is designed to be user
  17. friendly and therefore used intuitively; this document serves only to clarify
  18. various points and to act as a tutorial.
  19.  
  20. Getting Started
  21.  
  22. After starting the program you will be presented with a menu inviting you to
  23. either quit, create or use. 
  24. Throughout this package you make selections from menus by typing the first
  25. letter of an option, followed by [RETURN] to activate your choice. If you make
  26. a typing mistake, you can delete characters using the DEL key.
  27.  
  28. The QUIT option will exit you immediately back out of the package.
  29.  
  30. The USE option will allow you to work on an already existing database. When
  31. prompted, enter the name you gave the database. As before, if you make a
  32. mistake you can delete characters using the DEL key. When you hit
  33. [RETURN] the database will be loaded and you will enter the main screen.
  34.  
  35. The CREATE option is used to create a new database. You will be prompted to
  36. enter the name for the database. 
  37. This may be any valid pathname of up to 30 characters, but it must NOT specify
  38. an extension ( that is, a part beginning with a '.' ) as File-It provides
  39. its own extensions to identify its files.  
  40. Having done this the screen will clear and you will be asked to specify the
  41. name for the first field in the database record structure, or to just hit
  42. [RETURN] if you have finished specifiying all the fields. 
  43. A record may contain upto 25 fields and each field has an eight character
  44. fieldname associated with it. If you specify all 25 fields, the program will
  45. automatically take it that you have finished specifiying the record
  46. structure.  
  47. Having specified the field's name, you will be invited to move to the position
  48. of the first corner of the field on-screen, using the cursor keys, and to
  49. press [RETURN] when you are in the right place. 
  50. You will the be asked to similarly indicate the second corner for the field.
  51.  
  52. All fields are defined in terms of an on-screen box that they will appear in.
  53. The maximum size of one field is 300 characters, and if you try to specify a
  54. field bigger than this, or if you specify a field so small that it could hold
  55. no data, then you will be asked to re-specify the corners of the field. 
  56.  
  57. Otherwise the field will be displayed on-screen as it will appear, and you
  58. will be asked to confirm that the field is correct. 
  59. If you answer NO then the field will be discarded and you will be returned to
  60. the stage asking for the field-name. 
  61. If you answer YES then the field will be added to the database and you will
  62. move onto the next field, again asking you to specify the field's name.  You
  63. will keep repeating this sequence until either the card is full ( that is you
  64. have specified all 25 possible fields ) or you press [ENTER] to indicate that
  65. you have finished. The database will then be created and you will move into
  66. the main screen. 
  67.  
  68. The Main Screen
  69.  
  70. The main screen is divided into three areas.  
  71. At the top of the screen is the card display area. This always displays the
  72. current card, unless the database is empty.  
  73. Immediately beneath this is the status line. This shows what the number of
  74. the current record is, what database level you're on, how many records there
  75. are in the current level and how many records there are in the total
  76. database.  
  77. Beneath this is the command window where menus are displayed.  The first menu
  78. you will see is one which allows you to choose from the various 'core'
  79. options.  
  80.  
  81. QUIT :this will save your database and exit the program.  
  82.  
  83. MODIFY : this allows you to alter the contents of the current card. The card
  84. will be displayed highlighted on-screen, and you will see a menu showing the
  85. name of the current field, together with the options PREVIOUS, allowing you
  86. to move to the previous field, NEXT, which moves you to the next field, DONE,
  87. which saves the changes you've made and returns you to the main menu, and
  88. EDIT which allows you to edit the current field on-screen.  
  89.  
  90. When you choose the EDIT option, the cursor will move to the first character
  91. of the field, and you will be able to edit that field. Note that you will not
  92. be able to move outside the limits of the field.  You use the cursor keys to
  93. move anywhere within the field, and backspace to move backward within the
  94. field. Anything else you enter will be added into the field.
  95.  
  96. DELETE    : This will delete the current record from the database.
  97.  
  98. ADD :this allows you to add new records to the database. A blank record will
  99. be created, and you will enter the MODIFY menu so as to enter text into it.
  100. When you exit back to the main menu, the record will be added, and it will
  101. become the current record.  
  102. Note that the database may contain at most 1000 records, and you will not be
  103. able to add any records once it is full, without first deleting some to make
  104. room.  Note also that any added records are added to all database levels
  105. unconditionally, up to the current level, even if it does NOT match the
  106. current selection criterion.
  107.  
  108. NEXT :this move you forward through the database, moving to the next record
  109. on the current selection level. If you go past the end of all the records,
  110. then you will move back to the first record.
  111.  
  112. PREVIOUS : this is as for NEXT, but moving backwards.
  113.  
  114. FIRST : this moves you directly to the first record in the current selection
  115. level.
  116.  
  117. LAST :this moves you directly to the last record in the current level.
  118.  
  119. OUTPUT : this prints all the records in the current level to disc in a form
  120. suitable for printing or use in other programs. You will be asked for a name
  121. for the print file. ( if you specify prt: then output will be directly to the
  122. printer. )
  123.  
  124. SELECT : this allows you to place into a new database level only those
  125. records in the current selection level which match in a specified field on a
  126. given pattern.  The match is on blank separated words in the given field. You
  127. will be asked to enter the name of the field to match on, and then the
  128. pattern to search for.  
  129. The pattern is any sequence of characters, without spaces. In the pattern the
  130. characters '*' and '?' have a special meaning. '?' means match any single
  131. character and may appear anywhere in the pattern. '*' means match any
  132. sequence of characters and may only be the first and/or last character in the
  133. pattern.  
  134. There is a maximum of 25 levels within the database, and if all these levels
  135. are full, or if the resulting level would be empty, then the select operation
  136. is abandoned and you return to the current level unchanged.  Otherwise the
  137. resulting level becomes the current level.
  138.  
  139. NOTE ... the search is NOT case-sensitive.
  140.  
  141. EXCLUDE :this is similar to SELECT, but it places into the new level those
  142. records which do NOT match.
  143.  
  144. INCLUDE : this places into the new level all the records in the current
  145. level, plus all the records in the global level ( level 1 ) for which there
  146. is a match.
  147.  
  148. HISTORY : this displays the record of the operations so far executed to reach
  149. the current level.
  150.  
  151. BACK :this moves you back up a level, undoing the last select,include or
  152. exclude.
  153.  
  154. TOPLEVEL : this moves you directly back to the global level ( level 1 ),
  155. undoing ALL selects, includes, or excludes.
  156.  
  157. Throughout the program any error messages or other special messages will be
  158. displayed on the status line. When you have read the message press [RETURN] to
  159. continue.
  160.  
  161. Some examples of searching a database.
  162.  
  163. suppose we have a database with the fields
  164.     SNAME    ( people's surname )    
  165.     HOBBIES    ( their hobbies )
  166.     GNAMES    ( their given names )    
  167. and     CITY    ( the city they live in )
  168.  
  169. 1. using select with a field-name of SNAME and a pattern of JONES would place
  170. into the new level all the records for people whose surname was Jones.
  171.  
  172. 2. using exclude with a field-name of SNAME and a pattern of JONES would
  173. place into the new level all the records for people whose surname wasn't
  174. Jones.
  175.  
  176. 3. selecting on SNAME with a pattern of A* would yield all those records for
  177. people whose surname began with A.
  178.  
  179. 4. selecting on SNAME with a pattern of *S would give all the records for
  180. people whose surname ended in S.
  181.  
  182. 5. selecting on SNAME with a pattern of SA?S would give all the records where
  183. the surname began with SA, the third letter could be anything, and the last
  184. letter was S. eg SAMS, SAWS etc.
  185.  
  186. 6.  selecting on SNAME with a pattern of JONES and then selecting again on
  187. CITY with a pattern of WELLINGTON would give us all the records for JONES'
  188. living in WELLINGTON.
  189.  
  190. 7. selecting on HOBBIES with a pattern of SURFING and then including on
  191. HOBBIES with a pattern of of MOTOR-RACING would give us all the records for
  192. people who's hobbies include surfing and/or motor-racing.
  193.  
  194. 8. carrying out 6 and then including on SNAME with a pattern of DAVIS would
  195. give us all the records for people where EITHER they were called JONES and
  196. they lived in wellington, OR their name was DAVIS.
  197.  
  198. As you can see, by compounding the select, include and exclude operations,
  199. powerful queries can be built up.
  200.         
  201.