home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / fms1105.zip / fms.INF (.txt) < prev    next >
OS/2 Help File  |  1994-04-10  |  43KB  |  566 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Preface ΓòÉΓòÉΓòÉ
  3.  
  4. Preface
  5.  
  6. Hello people, 
  7.  
  8. this is the second version of this usefull program. There are a lot of changes, 
  9. but only a few are visible, because I work a lot to optimize the code. 
  10.  
  11. Read at least the What's New section of this manual. 
  12.  
  13. I spent about 140 hours to develop this program (in about five months), I try 
  14. to make it as OS/2 as possible, without make it big, slow and hard to use. 
  15.  
  16. I request a little registration fee, 10$, please send it to me if you use the 
  17. program. 
  18. The only difference in the registered version is the absence of the initial 
  19. wait dialog box. 
  20.  
  21. At today I received no registrations, and only a couple of comment messages. I 
  22. hope this will change... 
  23.  
  24.  
  25. ΓòÉΓòÉΓòÉ 2. What FMS do ? ΓòÉΓòÉΓòÉ
  26.  
  27. What FMS do ?
  28.  
  29. I have a little Maximus BBS and I love OS/2, so I'm trying to delete all DOS 
  30. programs from my hard disk. Some time ago I decided to trash my old MFM and 
  31. write something to manage the files.bbs and the file areas. 
  32.  
  33. FMS is a simple files manager for Maximus (really all files.bbs based systems 
  34. can use it). 
  35.  
  36. It do all you can expect from that kind of software: moving, renaming, changing 
  37. descriptions etc. 
  38.  
  39. This is a list of the key features: 
  40.  
  41. * drag and drop enabled ! 
  42. * full multithread 
  43. * support for multiple Filearea.Ctl 
  44. * global search around all areas 
  45. * global dupelist 
  46. * direct manipulation of files reported from search or dupelist 
  47. * copy and move files from areas and to other drop enabled applications (eg 
  48. Workplace) 
  49. * direct files rename and delete 
  50. * direct description change 
  51. * touch of files date 
  52. * abandon, adopt 
  53. * view and manipulate LZH,ZIP,ARJ,ARC and ZOO archives (ask for others if you 
  54. want it) 
  55. * associations to external programs (like GIF viewer) 
  56. * generate "full files list" and "new files list" 
  57. * sort containers in various order 
  58. * update description with GIF,TIFF or JPG info on request 
  59. * get descriptions directly from FILE_ID.DIZ (if present) 
  60. * optimized to be fast and light for use on both little and big BBS 
  61. * will grow version by version in feature, stability and usability 
  62.  
  63.  
  64. ΓòÉΓòÉΓòÉ 3. Installation and configuration ΓòÉΓòÉΓòÉ
  65.  
  66. Installation and configuration
  67.  
  68. If you have an old version of FMS installed you can simply copy the .EXE and 
  69. .INF over the old one and run FMS. 
  70. It's necessary to check all the options in the settings notebook. Check and 
  71. fill all the options, expecially the archives one. 
  72.  
  73. For new user: install FMS is very simple. 
  74.  
  75. You should only move FMS.EXE into the directory you want and (optionally) 
  76. create an icon to run it in the workplace. 
  77.  
  78. Now run FMS, an empty windows will open, click rigth mouse button on it and 
  79. select Options. 
  80.  
  81. You will see a configuration notebook. In the first page there is a list of all 
  82. FILEAREA.CTL associated to FMS. 
  83. It is empty, so press the Add button and choose your FILEAREA.CTL file. 
  84.  
  85. Added all FILEAREA.CTL to the list close the notebook and after that close also 
  86. FMS. 
  87.  
  88. Run again FMS, it should now show all your file areas in the MAIN FOLDER (the 
  89. first window it open). 
  90.  
  91. Now you can configure all the other options. 
  92.  
  93. Confirmations 
  94.  
  95. Layout 
  96.  
  97. Tuning 
  98.  
  99. Archivers 
  100.  
  101. Associations 
  102.  
  103. Utilities 
  104.  
  105. Files List 
  106.  
  107. Registration 
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ 3.1. Confirmations ΓòÉΓòÉΓòÉ
  111.  
  112. Confirm update on exit 
  113.  
  114. If you check this option FMS will prompt you when exiting from an AREA FOLDER 
  115. asking a confirmation for all the changes done in the area. 
  116.  
  117. If you confirm FMS will delete all files flagged as deleted (red), rename all 
  118. files flagged as renamed (blue), update the files.bbs rewriting it on the disk. 
  119.  
  120. If you don't confirm FMS will not rewrite files.bbs on disk and will note 
  121. delete and rename files you deleted or renamed in the area. FMS will instead 
  122. delete all files dropped on the area (green). 
  123.  
  124. Confirm rename on copy 
  125.  
  126. When FMS move or copy a file it check if a file with the same name still exists 
  127. on the target directory. If it exists FMS rename the old one with a .OLD 
  128. extension. 
  129.  
  130. If you check this option FMS will prompt you before renaming the target file. 
  131. Othewise the rename is automatic. 
  132.  
  133.  
  134. ΓòÉΓòÉΓòÉ 3.2. Layout ΓòÉΓòÉΓòÉ
  135.  
  136. Auto save position 
  137.  
  138. If you check this option FMS will automatically save the window position, 
  139. colors and fonts when closing it. 
  140.  
  141. FMS remember theese information for each kind of windows it open, and for the 
  142. AREA FOLDER it remember this information on an order basis. So you can have 
  143. more AREA FOLDER opened in different positions. 
  144.  
  145. Hide Comments 
  146.  
  147. When checked FMS will not display the comments in the AREA FOLDER. 
  148.  
  149. Attention: the comments are still in the container, you can view the comments 
  150. selecting Hide/Comments from the context menu of the folder. Any sort will 
  151. affect the hided comments lines too !! 
  152.  
  153. Container Titles 
  154.  
  155. If you want see container titles check this options, otherwise uncheck it. 
  156.  
  157. Split Bar 
  158.  
  159. In the AREA FOLDER you can have a split bar before the description field. Check 
  160. this option if you want it. 
  161.  
  162. The position of the split-bar is saved with all other attributes with Save 
  163. Position (or when auto save position is in effect). 
  164.  
  165. Status Bar 
  166.  
  167. Check this option if you want a status bar displayed on bottom of the files 
  168. container. 
  169.  
  170. The status bar has the format: 
  171.  
  172.  F:[free space] T:[total files/space] S:[selected files/space] O:[orphan 
  173. files/space] D:[deleted files/space] M:[missed files] 
  174.  
  175. Text Emphasis 
  176.  
  177. If you check this option FMS will highlight the files in the area container 
  178. with text emphasis. 
  179. Orphan files are underlined, deleted ones are strikeouted. 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 3.3. Tuning ΓòÉΓòÉΓòÉ
  183.  
  184. Faster Dupelist 
  185.  
  186. If you check this option FMS will use more memory during the dupelist data 
  187. collection. It will be more quick, but it will eat a lot of memory. Experiment 
  188. the option and choose the one giving you the best results. 
  189.  
  190. RGB color in container 
  191.  
  192. Check this option if you are using the OS/2 2.11 (service pack 6200). 
  193.  
  194. If FMS don't highlight the files with colors in the area container (red for 
  195. deleted etc.) you should try to change this option. 
  196.  
  197.  
  198. ΓòÉΓòÉΓòÉ 3.4. Archivers ΓòÉΓòÉΓòÉ
  199.  
  200. Archivers 
  201.  
  202. Actually FMS can manage five kind of archives: ZIP, LZH, ARJ, ZOO and ARC. 
  203.  
  204. FMS is able to list the contents of theese archives without external program 
  205. support, but using external program you can also see the contents of the files 
  206. in the archive, add files to archives, delete fiels from archives, and check 
  207. archives integrity. 
  208.  
  209. FMS is not an archive manager, you can register FM/2 if you need such a 
  210. software, but I develop some archive support because it is a need when managing 
  211. file areas of the BBS. 
  212.  
  213. In this notebook page you can change the association between archives and 
  214. external programs, and choose the right parameters for each external program. 
  215.  
  216. Beware, you MUST choose parameters to avoid any prompt and override (replace) 
  217. any files. 
  218.  
  219. You can also choose in which directory FMS must write its temporary files. 
  220.  
  221. ATTENTION: FMS will erase all the contents of such a directory and remove it 
  222. when exit. 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 3.5. Associations ΓòÉΓòÉΓòÉ
  226.  
  227. Associations 
  228.  
  229. Here you can associate a file extension with a program. 
  230. When you select a file from one of FMS containers, it will use that program to 
  231. display/run/manage it. 
  232.  
  233. You can change the program name, the parameters and the working directory for 
  234. each extension, but you can change the extension filed itself. 
  235.  
  236. To add a new extension you should editing the extension filed, and after press 
  237. the Add button. 
  238. Now you can change the parameters. 
  239.  
  240. The first of the associations is used also for all the unlinked extensions, I 
  241. use e.exe or listpm.exe to manage unexpected extensions. 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ 3.6. Utilities ΓòÉΓòÉΓòÉ
  245.  
  246. Utilities 
  247.  
  248. You can tell FMS to run an FB utility (or other similar programs) on exit. 
  249.  
  250.  
  251. ΓòÉΓòÉΓòÉ 3.7. File lists ΓòÉΓòÉΓòÉ
  252.  
  253. File lists 
  254.  
  255. FMS is able to produce a simple (for now) file list. Really two, one total and 
  256. one for new files. 
  257.  
  258. You can here specify the header file (used in both news and total list), the 
  259. name of the two lists, the number of days to consider a file new, the width of 
  260. the list (commonly 80). 
  261.  
  262. You can also exclude file areas by Access keyword. In the rigth listbox there 
  263. are all the Access key you used, you can choos one or more of theese to exclude 
  264. areas from the lists. 
  265.  
  266. In the left listbox there are all the file areas, the excluded are 
  267. automatically selected as you select the associated Acces key in the rigth. 
  268.  
  269. The left list is for view only (for now). 
  270.  
  271. You can check the box on the bottom rigth to define if FMS should include 
  272. comments in the list. When you ask to include comments FMS turn off the sort of 
  273. the area files. 
  274.  
  275. You can also include missed files in the list. 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 3.8. Registration ΓòÉΓòÉΓòÉ
  279.  
  280. Registration 
  281.  
  282. Here you can simply insert your registration key. 
  283.  
  284. Type it exactly, it's case sensitive. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 4. Using FMS ΓòÉΓòÉΓòÉ
  288.  
  289. Using FMS
  290.  
  291. I hope you will use FMS easily, because it look and feel exactly as Workplace 
  292. do. 
  293. But there are some things you will found strange, as the rename or others. 
  294.  
  295. When FMS start it open a windows, really a container, containing all the file 
  296. areas. 
  297.  
  298. You can see it as icons, names or details, and here you have a context menu 
  299. with some options: 
  300.  
  301.    o View: it simple change the mode MFS show you the area list. 
  302.  
  303.    o Find: you can find text in yours file areas. The find is ever a separate 
  304.      thread, when done you will have a container (File Basket) with all files 
  305.      founded in all areas. You can also manipulate the founded files directly 
  306.      in the File Basket (rename, orphan/adopt, delete, change descriptions, 
  307.      touch, etc). 
  308.  
  309.    o Dupelist: you can find all the dupes in your file areas. The find is done 
  310.      in three way, as you choose: total match of file name, no extension match 
  311.      or partial match. As in the previous option you can manipulate directly 
  312.      the result of the dupe search. Both Search and Dupelist thread run at low 
  313.      priority to avoid system hang. 
  314.  
  315.    o Arrange: arrange the container in the icon view. 
  316.  
  317.    o Save positions: save the positions of the windows and its presentation 
  318.      attribute (fonts, colors). 
  319.  
  320.    o Sort by: the container is sorted by area tag, but you can sort it in 
  321.      FILEAREA.CTL or description order. 
  322.  
  323.    o Options: start the options notebook. 
  324.  
  325.    o Edit files.bbs: you can edit directly (e.exe) the files.bbs file 
  326.      (sometimes this can be usefull). 
  327.  
  328.    o Write filelist: write the file lists as you specify in the notebook. (You 
  329.      can also obtain the filelist launching FMS with the -L parameter. Using -L 
  330.      FMS will start, generate the lists, exit, so you can use it in a batch). 
  331.  
  332.    o Info: show the about dialog. The release number is in this dialog, please 
  333.      take note of it when reporting bugs. 
  334.  
  335. Double clicking an area will open the Area Container. 
  336.  
  337. This container show you the file list. 
  338. The file name are painted in different color: 
  339.  
  340. Black: normal listed file 
  341. Red: deleted file (they will really deleted when you close the Area Container) 
  342. Violet: orphan file 
  343. Light grey: comments 
  344. Dark grey: missed file (description withouth file) 
  345. Blue: renamed file 
  346.  
  347. Colors really show the file status. Some status is proritary about other, so a 
  348. file deleted and orphan will be displayed in red. 
  349.  
  350. To edit a file description you can use the standard OS/2 key/mouse combination 
  351. (normally Alt+left mouse button). To terminate the editing you can click 
  352. outside the edit box or simply press return. 
  353.  
  354. To rename a file use the same tecnique on the name field and change it. The 
  355. file will be really renamed when you will close the Area Container. 
  356.  
  357. You can select as many file you want, when you click right button FMS activate 
  358. a context menu. The context menu contains many commands. The commands apply to 
  359. the record of the container under the mouse at click time. 
  360. If the record under mouse is in selected status the command will apply to all 
  361. the selected record in the container, otherwise only this record is affected. 
  362.  
  363. The command available in the context menu are: 
  364.  
  365.    o Add comment: add a line of comment after the record under mouse. 
  366.  
  367.    o Delete/Undelete file: delete or undelete (set/unchek delete flag) the 
  368.      record under mouse (or all selected record). The records will be really 
  369.      deleted when you close the container. 
  370.  
  371.    o Abandon/Adopt file: abandon or adopt the records. As for the delete 
  372.      command this is a flip/flop command. Apply two time the command to the 
  373.      same file leave its status invariate. Orphan a comment will delete it from 
  374.      the files.bbs. 
  375.  
  376.    o Move (top/bottom): this command will move the record(s) to the top or the 
  377.      bottom of the list. 
  378.  
  379.    o Touch: touch the date of the record(s). Both update and create dates are 
  380.      updated. 
  381.  
  382.    o Get info (pic): put a simple info in the description from the GIF,TIFF or 
  383.      JPG file selected. It's an experimental command, if you like it I can 
  384.      extend it. 
  385.  
  386.    o Get info (file_id.diz): put the text found in file_id.diz into 
  387.      description, if file_id.diz exists int he archive. 
  388.  
  389.    o Save positions: same as in the Main Container. 
  390.  
  391.    o Sort by: sort the list in various kind. The list will be saved in the 
  392.      order you see it when closing the container. 
  393.  
  394.    o Hide/Show: hide or show comments, orphan files or missed files. The hide 
  395.      do not affect the save or the sort of the list. 
  396.  
  397.    o Select(all,none,by status, by word):Select files. The selection is 
  398.      additive. Try it. 
  399.  
  400.    o Info: info dialog 
  401.  
  402. In the File Basket (the container you obtain after a Search or a Dupelist) are 
  403. available some of the commands of the Area Container, and also an Export List 
  404. On File options to save the list on a temp file. 
  405. The Boost Priority option can be usefull if there is some program in the system 
  406. sucking all the CPU resources. You can Boost the dupelist or Find task with 
  407. this option. But beware if you need this there is some WRONG task runnig on 
  408. your system. 
  409.  
  410.  
  411. ΓòÉΓòÉΓòÉ 4.1. Keys ΓòÉΓòÉΓòÉ
  412.  
  413. Keys
  414.  
  415. I changed some keys functionality in the direct edit of OS/2. 
  416.  
  417. When editing you can update the field simply pressing return (instead of 
  418. finding the mouse and click outside the edit box), also you can use arrow up 
  419. and down keys to update the box and go to edit the next (or previous) record. 
  420. Beware, there is a bug, if you go beyond the last record visible the container 
  421. will not automatically scroll. 
  422.  
  423. F3 always close the current window. 
  424. When in the file list F2 (or Ins) start the editor. F4 (or Del) delete del file 
  425. (or selected files). 
  426.  
  427. When the focus is in the Main Container you can start Search with Ctrl-F and 
  428. Dupelist with Ctrl-D. 
  429.  
  430. More keys can be activated, please query for it, I'm a mouse maniac...... 
  431.  
  432.  
  433. ΓòÉΓòÉΓòÉ 5. Known problems and bugs ΓòÉΓòÉΓòÉ
  434.  
  435. Known problems and bugs
  436.  
  437. Actually FMS don't check for free space before move or copy files. I will fix 
  438. that as I will receive at least ONE registration. 
  439.  
  440. Please report others problems, bugs or suggestions to: 
  441.  
  442. Mario Pacchiarotti 
  443. Fido: 2:335/320 Internet: mc8872@mclink.it 
  444.  
  445.  
  446. ΓòÉΓòÉΓòÉ 6. What's new ? ΓòÉΓòÉΓòÉ
  447.  
  448. What's new ?
  449.  
  450. From version 1.078 
  451.  
  452. * Now FMS update immediatly the field width after editing description. 
  453.  
  454. * Two additional sort view added to file container: Description and Extension 
  455.  
  456. * Added Sort capability to archives container 
  457.  
  458. * One new sort view in the main container: Description 
  459.  
  460. * FMS is now able to unarc files from archives 
  461.  
  462. * Added abitity to get file description from FILE_ID.DIZ 
  463.  
  464. * FMS is now optimized for memory allocation (it use less memory) 
  465.  
  466. * FMS is now faster filling container (really) 
  467.  
  468. * FMS now use threads for about all the secondary functions 
  469.  
  470. * Added a simple status bar to file containers, with various infos 
  471.  
  472. * Automatically run FB or others utilities on exit (on request) 
  473.  
  474. * Optionally include missed files and comments in total file list 
  475.  
  476. * Optimized execution of updates from file basket (really) 
  477.  
  478. * FMS is now able to delete, and add files from/to archives 
  479.  
  480. * FMS is now able to test archives 
  481.  
  482. * Added a select function in the files container. You can select by flags or by 
  483. word (like a find). 
  484.  
  485. * You can optionally use a text emphasis to highlight the status of files. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 7. Development team ΓòÉΓòÉΓòÉ
  489.  
  490. Development team
  491.  
  492. I'm the biggest of the two ! 
  493.  
  494.  
  495. ΓòÉΓòÉΓòÉ 8. Disclaimer ΓòÉΓòÉΓòÉ
  496.  
  497. Disclaimer
  498.  
  499. FMS is supplied as it is. The author disclaims all warranties, expressed or 
  500. implied, including, without limitation, the warranties of merchantability and 
  501. of fitness for any purpose. The author assumes no liability for damages, direct 
  502. or consequential, which may result from the use of FMS. 
  503.  
  504. FMS is a "shareware program" and is provided at no charge to the user for 
  505. evaluation. Feel free to share it with your friends, but please do not give it 
  506. away altered or as part of another system. 
  507. The essence of "user-supported" software is to provide personal computer users 
  508. with quality software without high prices, and yet to provide incentive for 
  509. programmers to continue to develop new products. 
  510.  
  511. FMS package, all programs, the documentation and support files are copyrighted 
  512. 1994 by Mario Pacchiarotti. 
  513. All rights are reserved.  You may copy this package for backup purposes. You 
  514. may also copy and share unmodified copies of the whole package, providing that 
  515. the copyright notice is reproduced and included on all copies. 
  516.  
  517. You may not sell the product for a fee and/or distribute the product along with 
  518. other products without written permission,  nor may you modify or remove the 
  519. Copyright Notices from the programs or the documentation files. 
  520. User clubs, if they are NOT commercial, are allowed to ask a small amount of 
  521. money for distribution and storage when they want to share this package amongst 
  522. their members. 
  523.  
  524. It is forbidden to modify, adapt, translate, reverse engineer, decompile and/or 
  525. disassemble the software in the FMS package. 
  526. Patching the medium at places that carry the software is seen as a program 
  527. change and is also forbidden. 
  528.  
  529.  
  530. ΓòÉΓòÉΓòÉ 9. How to register ΓòÉΓòÉΓòÉ
  531.  
  532. How to register
  533.  
  534. FMS is not freeware, nor PD, it's Shareware. 
  535.  
  536. Surely you know what Shareware is, so I will not bore you explaining it. 
  537.  
  538. If you use FMS you must register it. 
  539.  
  540. I choose to require a minimal registration fee. FMS price is ten dollars, so 
  541. you have no excuses to avoid registration. 
  542.  
  543. To register send me $10 or about equivalent money in your currency to: 
  544.  
  545. Mario Pacchiarotti 
  546. Via Campania, 10 
  547. 00040 Cecchina (Albano) RM 
  548. ITALIA 
  549.  
  550. You can send money, postal check, international check, or other collectable 
  551. credit title. Sorry no credit cards. 
  552.  
  553. When registering please specify your e-mail address (fido or internet). 
  554.  
  555. You will receive the registration key to avoid initial wait dialog box. 
  556.  
  557. This is the only difference from unregistered to registered version. 
  558. The about dialog will wait more any day you use FMS, so you will not bored in 
  559. the initial days when testing it. 
  560.  
  561. You can write me to: 
  562.  
  563. Fidonet: 2:335/320 
  564. Internet: mc8872@mclink.it 
  565.  
  566.