home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / filpg104 / filprog.doc next >
Text File  |  1994-01-29  |  9KB  |  226 lines
  1.  
  2.  
  3. FILPROG : - .FIL File gemmed editor © Paul Baker
  4. ------------------------------------------------
  5.  
  6. The Program and Resource contained in this archive are © Paul Baker.
  7.  
  8.  ======================================================================
  9. |Disclaimer:                                                           |
  10. |I can not be held responsible for any damage to software or hardware  |
  11. |whether caused directly or indirectly by this program , you use this  |
  12. |program entirely at your own risk.                                    |
  13.  ======================================================================
  14.  
  15. Sorry people , it probibly won't work on a Falcon.
  16.  
  17. FILPROG.PRG and FILPROG.RSC need to be in the MAIN BBS FOLDER.
  18.  
  19. WHAT IS FILPROG
  20. ---------------
  21.  
  22. FILPROG is a fully Gemmed program which will let you do the Majority of
  23. the sysop file functions that Turbo V2 let's you do.
  24.  
  25. These include.
  26.  
  27. 1) Move files from one area to another
  28. 2) Delete Files from .FIL's
  29. 3) Renumber the .FIL entries so they have consecutive numbers.
  30. 4) Edit the majority of the information in a .FIL entry for a chosen file.
  31. 5) Create/Delete and Move Download Areas.
  32.  
  33. Moving Files
  34. ------------
  35. Choose which area you wish to examine by clicking on the Area name on the
  36. right hand side of the screen , if you don't see the area you want to change
  37. on screen then use the up and down arrows to scroll through the available
  38. entries.
  39.  
  40. The entries in the .FIL will then appear , you can scroll up and down the list
  41. using the arrows , you can limit which files are shown by using the mask
  42. feature [See Using the MASK].
  43.  
  44. By clicking on the name of a file , that file is marked and becomes
  45. highlighted , clicking on it again will unmark the file, files with
  46. a Black box next to the name are off-line files.
  47.  
  48. By Clicking on ALL the files currently shown on screen will be batch
  49. marked , by clicking on CLEAR the files shown on screen will be UNmarked.
  50.  
  51. TOP will take to back to the top of the .FIL entries and the arrows to
  52. the right hand side will move you up and down the .FIL entires.
  53.  
  54. After you are sure you have marked all the files you wish to move you then
  55. click on MOVE , you will be asked to click on the area you wish to move the
  56. marked files to , do this and you will be asked to confirm your choice ,
  57. if you click YES then the files and .FIL entries will be moved to this
  58. area.
  59.  
  60. When you click YES the following processes will occour.
  61.  
  62.       [Skip this if you aren't interested in how the program works]
  63.  
  64. 1. If the destination download folder doesn't exist on the partition that
  65.    the program resides on already then it is created.
  66.    (The Program assumes that the BBS folder exists already)
  67.  
  68. 2. If there is not enough room to create the destination folder then the
  69.    destination partition is changed to the partition with the most space.
  70.  
  71. 3. The destination folder is checked and if a file with the same name
  72.    already exists in that folder then the move is aborted for that file.
  73.  
  74. 4. The old copy of the file isn't deleted until the new copy has been
  75.    fully saved in the new folder.
  76.  
  77. 5. If there is not enough room on the partition for step 4, then the
  78.    memory buffer is checked , if it is large enough then the file is held
  79.    in memory whilst the old file is deleted and the one held in memory
  80.    is then saved.
  81.  
  82. 6. If there is not enough memory AND not enough disk space to do either of
  83.    4 or 5, then a scan for the partition with the most space is made
  84.    and if there is enough room the file is moved into this partition.
  85.  
  86. 7. If there is not enough room on the partition with the most space for
  87.    step 6 then the move is aborted for THAT file.
  88.  
  89. The program has been written this way to minimise the chance of files
  90. going missing during the move operation.
  91.  
  92. Once the move has been completed FILPROG will display the .FIL entries
  93. from the top entry again.
  94.  
  95. There is a temporary .FIL area that FILCHECK creates itself , it also
  96. automatically creates the neccesary folders when you run it , you can use
  97. this to hold files you are undecided about.
  98.  
  99.  
  100. Using the MASK
  101. --------------
  102.  
  103. You can limit the files you wish to be displayed by clicking on the SET MASK
  104. button , changing the details in the Mask menu and clicking on the USE MASK
  105. button when you exit back to the main menu.
  106.  
  107. The changes you make to the mask details will only be 'saved' if you hit
  108. OK , hitting CANCEL restores the previous settings.
  109.  
  110. Note: Hitting ESCAPE will clear most imputs in the Mask menu.
  111.  
  112. Wildcards are Fully supported in the filename box (*?)
  113.  
  114. Above the Upload date are < = > , these specify if you want to list files
  115. who's upload dates are earlier,equal or later than the date entered ,
  116. clicking on the symbol you want to use will highlight it.
  117.  
  118. The above also applies to the < = > above the access level.
  119.  
  120. There are now two ways of turning off the above two options , either clear
  121. the access level and/or date by using <escape> or click on the currently
  122. highlighted symbol to turn all that group off , Filprog will then ignore
  123. that mask option whilst scanning.
  124.  
  125. Clicking on the OFFLINE button will only show files marked as Offline in
  126. the .FIL file.
  127.  
  128. Clicking on the FREE button will only show files marked as Free Downloads
  129. in the .FIL file.
  130.  
  131. The description line will make Filprog scan the descriptions in the .FIL
  132. file for descriptions with matching text in them, it is NOT case sensitive.
  133.  
  134. Delete Files.
  135. -------------
  136. Follow the steps on marking files to move and click on DELETE when you have
  137. marked all the files you wish deleted.
  138.  
  139. You will then be asked to confirm the deletion of the files , clicking on
  140. YES will then delete the .FIL entries marked and any of the marked files
  141. that aren't off-line will be deleted.
  142.  
  143. The .FIL will then be re-displayed.
  144.  
  145. Renumber
  146. --------
  147. Clicking on Renumber will make FILPROG ask you to confirm the renumbering
  148. , clicking on YES will then renumber ALL the .FIL's so the entries all have
  149. consecutive numbers, if the BBS's next file number changes the new number
  150. is written into the CONFIG.DAT.
  151.  
  152. Editing .FIL entries
  153. --------------------
  154. Once you have chosen the File area you wish to look at and edit , by
  155. clicking on the DESCRIPTION of a file shown on screen a second Dialogue
  156. box will appear containing the following information.
  157.  
  158. Name, Uploader, Access Level , Rating , Description , Flags (Offline. Free
  159. , Deleted) and file size in K.
  160.  
  161. You can change all the details shown apart from the Offline and Deleted
  162. Flags.
  163.  
  164. If you change the filename , FILPROG will check to see if a file of the same
  165. name already exists in the current files folder , if it does then it will
  166. return with an error and return to the edit screen showing the original
  167. filename.
  168.  
  169. Highlighting Touch Upload date will make the Upload date of that file the
  170. same as the current date.
  171.  
  172. Clicking on OK will update the entries and rename the file if you
  173. do so , CANCEL will abort.
  174.  
  175. The format of the Description shown is not the format that will be stored
  176. in the .FIL entry , the .FIL has 5 x 80 characters , the .RSC can only
  177. display 60 characters a line , so the text is formatted from the .FIL to
  178. fit into the .RSC and when re-saved it is formatted back.
  179. If you use more than 400 characters FILPROG will warn you and return to
  180. the edit screen so you can edit the description.
  181.  
  182. Create / Delete , Swap File areas
  183. ---------------------------------
  184.  
  185. By Clicking on the EDIT Button above the File Areas you are taken to a second
  186. screen , this will show all the available file areas and give you the option
  187. of 3 buttons.
  188.  
  189. Create
  190. ------
  191.  
  192. This let's you enter the name of a new File Area , it won't let you exceed
  193. the 20 Download area limit.
  194.  
  195. Delete
  196. ------
  197.  
  198. This will delete each highlited area , it asks your permission to do so
  199. for each area it finds highlited.
  200.  
  201. it then deletes the .FIL file and removes all the EMPTY download area Folders
  202. , it WILL NOT delete any folders with files in them , this is to allow you
  203. to recover the files if you make an error or if you decide to keep the
  204. files elsewhere.
  205.  
  206. Otherwise you have to remove the files and folders yourself from the desktop
  207. or the Dos shell.
  208.  
  209. Swap
  210. ----
  211.  
  212. By highliting TWO areas and hitting SWAP these areas will change places.
  213.  
  214. ----------------------------------------------------------------------------
  215. |DON'T FORGET TO CHANGE YOUR FILES.TXT AND OTHER TEXT FILES IF YOU USE THIS|
  216. |FEATURE.                                                                  |
  217. ----------------------------------------------------------------------------
  218.  
  219. That's about it for now , I hope you find this useful , if you have any
  220. problems you can contact me at any of the following addresses.
  221.  
  222.    100:1011/0 , 90:102/140 , 51:502/100 2:245/108 , mettav.royle.org
  223.  
  224. Paul Baker.
  225.  
  226.