home *** CD-ROM | disk | FTP | other *** search
/ Rat's Nest 2 / ratsnest2.iso / os2 / bbs / ffd4.lzh / READ.ME < prev   
Encoding:
Text File  |  1994-11-28  |  7.2 KB  |  211 lines
  1.  
  2.  
  3. Public Beta Version #4 of
  4.  
  5. fixfdir/2 - the ultimate filedir util for BBBS.
  6.  
  7. -----------------------------------------------
  8.  
  9.  
  10. This is a program for generating a graphic representation of the
  11. directory structure in a File/4 BBBS system.
  12.  
  13. ffd also includes a util which checks for the existance of all of the
  14. directories specified in the filedir.
  15.  
  16.  
  17. Files included in this archive:
  18.  
  19. ffd.exe     : OS/2 executable
  20. ffd-dll.exe : OS/2 executable (requires GCC/2 dll's)
  21. ffd-d.exe   : DOS executable
  22. read.me     : Useful information (this file)
  23. file_id.diz : File description In Zip
  24.  
  25.  
  26. ===============================================
  27.  
  28. APPLICATION EXAMPLES:
  29.  
  30. One smart application of ffd is to make it a 'part' of BBBS's File/4 system.
  31. With the help of ffd and a couple of scripts, you can issue a command
  32. ie. TREE from any file-dir when online in the BBBS and a full tree-structure
  33. from current file-dir will be shown.
  34.  
  35. like this:
  36.  
  37. (19:02) file:/os2> tree
  38. ROADMAP generated by fixfdir/2, beta #4, copyright (c) 9490.64 Stig Johansen
  39. /os2
  40. |- 4os2                                 4OS2 command interpreter
  41. |- com                                  Communications programs
  42. |  |- offl                              Offliners for OS/2
  43. |  |- prog                              Communication programs
  44. |  |- prot                              Communication protocols
  45. |  `- util                              Communication utils
  46. |- disk                                 Disk and file utilities
  47. |- misc                                 General programs
  48. |  `- pgp                               PGP w/utilities
  49. |- rexx                                 REXX command language
  50. |- screen                               Display drivers and utils
  51. `- virus                                Virusscanners etc.
  52. (19:02) file:/os2>
  53.  
  54.  
  55. And here's the way to do it:
  56. 1. Put the command TREE into your error.bz and make it spawn the file TREE.
  57.    Compile the error.bz file. :)
  58. 2. Make the file tree.bz and compile it.
  59.  
  60.  
  61.  
  62. Sample error.bz:
  63. -------------------------------------------------
  64. function main($com,$tomenu)
  65. {
  66. /* tomenu: 1=read, 2=main, 3=util, 4=file, 5=chat, 128=join_no_access,
  67.    129=file_cd_no_access */
  68.  
  69.   switch ($tomenu) {
  70.     case 1:
  71.     case 2:
  72.     case 3:
  73.     case 4: {
  74.         switch (parsecom("CLS/SDate/HIPPO$/FG/CG/TREE",$com)) {
  75.             case 1: { printf("\e[2J"); break; }
  76.             case 2: { spawn("sdate"); break; }
  77.             case 3: { spawn("hippo$"); break; }
  78.             case 4: { spawn("fg"); break; }
  79.             case 5: { spawn("cg"); break; }
  80.             case 6: { if ($tomenu==4) spawn("tree"); break; }
  81.             case 255: { printf("%s\"%s\".\n",$bv_txt[23],$com); break; }
  82.         }
  83.         break;
  84.     }
  85.     case 128: { printf("%s\n",$bv_txt[22]); break; }
  86.     case 129: { printf($bv_txt[629]); break; }
  87.     default: printf("%s\"%s\".\n",$bv_txt[23],$com);
  88.   }
  89.   $bv_comstring="";
  90. }
  91. -------------------------------------------------
  92.  
  93.  
  94.  
  95. Sample tree.bz:
  96. (Note: this requires \bbs\$bin\ffd.exe and the \bbs\$data\ directory)
  97. -------------------------------------------------
  98. function main() {
  99.     var $file,$command;
  100.  
  101.     $file = sprintf("$data\\tree.%u",$bv_nodenumber);
  102.     $command = sprintf("$bin\\ffd -Adr%s -f%s filedirg.000",$file,$bv_crrdir);    system($command,0);
  103.     showfile($file);
  104.     remove($file);
  105. }
  106. -------------------------------------------------
  107.  
  108.  
  109. PROGRAM EXAMPLES:
  110.  
  111. Example 1:
  112.  
  113.     ffd -drc:\file\roadmap c:\bbs\filedirg.000
  114.  
  115. Will make a text roadmap with descriptions to the file c:\file\roadmap
  116. based on the filedir contained in the file c:\bbs\filedirg.000.
  117. Sample output:
  118.  
  119. ROADMAP generated by fixfdir/2, beta #4, copyright (c) 9490.64 Stig Johansen
  120. /
  121. |- bbbs                                 The ultimate system!
  122. |  |- 08a                               BBBS 0.8a program files
  123. |  |- util                              Utilities for BBBS
  124. |  |- bz                                Scripts for BBBS
  125. |  `- beta                              Utilities out for beta-testing.
  126. |- os2                                  OS/2 related programs
  127. |  |- 4os2                              4OS2 command interpreter
  128. |  |- com                               Communications programs
  129. |  |  |- offl                           Offliners for OS/2
  130. |  |  |- prog                           Communication programs
  131. |  |  |- prot                           Communication protocols
  132. |  |  `- util                           Communication utils
  133. |  |- disk                              Disk and file utilities
  134. |  |- misc                              General programs
  135. |  |  `- pgp                            PGP w/utilities
  136. |  |- rexx                              REXX command language
  137. |  |- screen                            Display drivers and utils
  138. |  `- virus                             Virusscanners etc.
  139. `- win                                  Windows 3.x files
  140.  
  141.  
  142. Example 2:
  143.  
  144.     ffd -drc:\file\dos\roadmap. -f/os2 c:\bbs\filedirg.000
  145.  
  146. Will make a text roadmap with descriptions to the file c:\file\dos\roadmap based
  147. on the filedir contained in the file c:\bbs\filedirg.000, BUT it will only
  148. show the structure FROM /os2 and out.
  149. Sample output:
  150.  
  151. ROADMAP generated by fixfdir/2, beta #4, copyright (c) 9490.64 Stig Johansen
  152. /os2
  153. |- 4os2                                 4OS2 command interpreter
  154. |- com                                  Communications programs
  155. |  |- offl                              Offliners for OS/2
  156. |  |- prog                              Communication programs
  157. |  |- prot                              Communication protocols
  158. |  `- util                              Communication utils
  159. |- disk                                 Disk and file utilities
  160. |- misc                                 General programs
  161. |  `- pgp                               PGP w/utilities
  162. |- rexx                                 REXX command language
  163. |- screen                               Display drivers and utils
  164. `- virus                                Virusscanners etc.
  165.  
  166.  
  167. Versions:
  168.  
  169.     9490.64 Beta #4
  170.             Added "startdir" -f option
  171.             Added support for multiline descriptions
  172.             Added ANSI colors -A option
  173.             Fixed a bug with descriptions
  174.             Fixed a bug (foobar output when not giving filename)
  175.     9490.15 Third beta
  176.             Added support for descriptions
  177.             Added support for private dir's
  178.     9489.86 Second beta of course
  179.             First beta turned out to be a memory Hog!
  180.             Fixed the DOS version
  181.     9489.59 First beta of new version
  182.             Added ROADMAP function
  183.             Added Yes/No function
  184.     9467.61 First version
  185.  
  186.  
  187.  
  188. Author: Stig Johansen
  189.         Karusveien 15
  190.         N-1481 Hagan
  191.         Norway
  192.  
  193. BBBSnet: Stig Johansen@47:1000/101
  194. FidoNet: Stig Johansen@2:210/20
  195. SigNet : Stig Johansen@27:1347/106
  196. Skynet : Stig Johansen@47:300/110
  197. Internet : Stig.Johansen@f20.n210.z2.fidonet.org
  198.  
  199. Or in the bbbs.talk (Norwegian) or bbbs.util (English) conference in
  200. the BBBSnet.
  201.  
  202. Greetings goes to:
  203.  
  204.     * Rune for helping me (more like delaying me ;)
  205.     * Tor Arne for great ideas
  206.     * Torfinn Nome for finding a bug.
  207.  
  208. Copyright notices:
  209.  
  210. * BBBS is Copyright 1990,1992-1994, Kim Heino and Tapani T. Salmi.
  211.