home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1998 February / PCOnline_02_1998.iso / filesbbs / dos / fcfg401x.exe / README.DOC < prev    next >
Encoding:
Text File  |  1996-03-27  |  6.3 KB  |  142 lines
  1. This is 'Readme' file for FileCFG. It contains brief installation notes
  2. and a quick rundown of all major features. Online help is available within
  3. the program by pressing F1 at any time. This help is context-sensitive and
  4. should be able to give you an idea of how to get things done with FileCFG.
  5.  
  6. What is it?
  7. ===========
  8.  
  9. FileCFG is the most comprehensive file and message area and group desktop
  10. managing utility for ProBoard. I can say that without the slightest
  11. exaggeration and you can convince yourself with a quick glance at all the
  12. features it offers.
  13.  
  14. Most Sysops want full control of their BBS'. ProCFG's handling of areas
  15. and group arrangements leaves a lot to be desired. If you add an area,
  16. there is no easy way to move it to another position at a later time short
  17. of re-writing it in the new place. FileCFG is designed to overcome this
  18. and many more limitations. It is inteded as a full replacement to the
  19. equivalent functions in ProCFG.
  20.  
  21. FileCFG also offers some advanced features to make your life easier, such
  22. as in-place group selection which lets you select the group for the area
  23. from a list of all available groups. This beats the heck out of having to
  24. remember all those numbers. It also keeps track of the group numbers and
  25. can update the areas whenever you add or delete groups so your group
  26. designations always stay the same regardless of the number of the group
  27. itself. It can also keep track and synchronize the reply area number for
  28. the message areas so that it is always right.
  29.  
  30. FileCFG lets you insert, delete, re-arrage, move, and sort groups and
  31. areas, as well as performing global changes on a range of records.
  32. Everything is editable, even some fields that are not present in ProCFG
  33. itself. The editing is done in an arguable more user-friendly way where
  34. you can pick up your selections from dialog boxes instead of just typing
  35. them in.
  36.  
  37. FileCFG has also text searching and record jump capabilities to make your
  38. life easier when you are trying to find a particular record.
  39.  
  40. FileCFG supports external programs definable by the user as well as some
  41. hard-coded operations, such as reindexing the bases. It also supports
  42. control files for batch processing.
  43.  
  44. FileCFG comes with full context-sensitive hint status lines and help
  45. system to make your life even easier.
  46.  
  47. FileCFG also supports the FA_nnn.CTL mechanism for specifying multiple
  48. directories per file area. It will keep track and update the file names
  49. for all control files whenever necessary, thus eliminating the need for
  50. you to do that.
  51.  
  52. FileCFG will swap itself completely out of memory (leaving only 240 bytes)
  53. whenever an external operation is performed. This enables you to run all
  54. kinds of programs from within it. The external programs' menu items are
  55. completely customizable, right down to the hotkey definition.
  56.  
  57. FileCFG can also be obtained in its overlaid version which will run in
  58. more retricted memory environment.
  59.  
  60. The best of all: it is totally FREE! FileCFG is distributed under the
  61. terms and conditions of the GNU General Public License. You should have
  62. recieved a copy of it in the archive (see the file 'Copying.Doc').
  63.  
  64. Installation
  65. ============
  66.  
  67. To install FileCFG, follow these simple steps:
  68.  
  69.     (1) Unpack the archive in any directory of your choosing. The only
  70.         files you absolutely need from it, are FileCFG.Exe and FileCFG.Hlp
  71.         which should both be placed in the same directory.
  72.  
  73.     (2) Make sure you have the PROBOARD environment variable set to point
  74.         to your BBS' system directory (consult the ProBoard manuals for
  75.         the proper installation of this variable).
  76.  
  77.     (3) Fire up FileCFG to test it out. It should come up and display an
  78.         About dialog box with the version number. That's all for the
  79.         initial setup. You can also make backups of the following files in
  80.         the ProBoard's system directory:
  81.  
  82.                 FILECFG.PRO and FGROUPS.PB
  83.                 MESSAGES.PB and MGROUPS.PB
  84.  
  85.         Copy those files to a safe location before you experiment with the
  86.         program. FileCFG makes heavy use of those files and even though it
  87.         does create backups, it is still a good idea to do this yourself.
  88.  
  89. External Program Support
  90. ========================
  91. If you want to take advantage of the external program support, you will
  92. need to create a SILICON.INI file in the ProBoard system directory. This
  93. is a plain text file. You may already have it if you are using mail-x,
  94. Signette or any other of the products that support it. This file is shared
  95. by several programs to store some of their parameters in it. When you load
  96. the file in the editor (not a word-processor, but an editor, like Edit or
  97. Boxer, or QEdit), create a section called FileCFG and add the entries for
  98. the menus. Below is a sample of the complete setup that I have on my system:
  99.  
  100.                 ; this is a comment
  101.                 [FileCFG]
  102.                 ; this is the first item on the File menu
  103.                 ; Note how you have to specify the complete command
  104.                 ;
  105.                 Allfix=D:\SBIN\ALLFIX\ASETUP.EXE
  106.                 ;
  107.                 ; This is the menu item that will be displayed
  108.                 ; Note the '~l~', theis make 'L' the hotkey
  109.                 ;
  110.                 AllfixMenu=A~l~lfix setup
  111.                 ;
  112.                 ; The format of the rest follows the one above
  113.                 ; Make sure you specify the complete filenames
  114.                 ; for the programs. You cannot use any command
  115.                 ; line switches in those lines.
  116.                 ;
  117.                 FileMgr=D:\SBIN\FEBBS\FEBBS.EXE
  118.                 FileMenu=File area ~m~anager
  119.                 AMU=D:\SBIN\AMU\AMUCFG.EXE
  120.                 AMUmenu=AMU ~c~onfiguration
  121.                 InterEcho=D:\IM\IESETUP.EXE
  122.                 IEmenu=InterEcho ~s~etup
  123.                 BlueWave=D:\SBIN\BWAVE\BWSETUP.EXE
  124.                 BWmenu=~B~lueWave setup
  125.  
  126. You will have to use the predefined keywords that appear to the left of
  127. the equal signs, but the rest is up to you. You might choose to use
  128. different programs altogether. Note that you cannot specify any
  129. command-line options for those programs. If you require this, refer to the
  130. section on 'Control Files for Batch Processing'. FileCFG will check for
  131. the existence of the programs and if it cannot find them, the menu items
  132. will be disabled.
  133.  
  134. Control Files for Batch Processing
  135. ==================================
  136. You can choose to run a couple of programs in a batch. To do this, create
  137. smple text files called FILEUTIL.CTL and MESGUTIL.CTL in the same
  138. directory where FileCFG is. These can be run from the menus. Refer to the
  139. samples included for explanation of the format. Here you can specify all
  140. necessary parameters.
  141.  
  142.