home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / bbsfm120.zip / BBSFMAN.PRO < prev    next >
Text File  |  1995-02-08  |  12KB  |  313 lines
  1. * Configuration file for the BBS File Manager program
  2.  
  3. * This file must be kept in the same subdirectory as the BBSFMAN.EXE
  4. * executable program (or BBSFMAN2.EXE for OS/2).  This file is read whenever
  5. * the BBSFMAN program is started.  Each statement is preceded by a comment
  6. * that describes what the statement is for.  Any statement comment that
  7. * begins with "!!!" *must* be modified in order for BBSFMAN to work properly.
  8. * Other statements are optional.
  9.  
  10. * All lines that begin with a "*" character are treated as a comment and are
  11. * ignored.
  12.  
  13.  
  14. * The following specifies the path that all other incompletely specified
  15. * paths are relative to.  This must come before the use of any relative
  16. * path usages.  It should end with a trailing '\'.
  17.  
  18. RELATIVE_PATH d:\max\
  19.  
  20.  
  21. * !!! There are two methods of defining your fileareas for BBSFMAN to use.
  22. * You must pick one and only one of these and the other should be commented
  23. * out.
  24. * 1) You can specify them here in the profile by using FILEAREA statements.
  25. *    Here's some example FILEAREA statements.  The format is:
  26. *    FILEAREA Fileareanumber Fileareapath Fileareadescription
  27. *
  28. * 2) For Maximus BBSs, you can just specify what your FILEAREA.CTL file is.
  29. *    BBSFMAN will read that and use this information.  Please see the
  30. *    complete documentation about possible support of other BBSs.
  31.  
  32. * !!!The following statements use method #1:
  33.  
  34. *FILEAREA 0 d:\max\files\uncheck Unchecked Uploads
  35. *FILEAREA 1 d:\max\files\games Game Programs
  36. *FILEAREA 2 d:\bbsfman\test1 This is a test area (test 1)
  37. *FILEAREA 3 d:\bbsfman\test2 This is a test area (test 2)
  38. *FILEAREA 99 d:\bbsfman\junk Junk filearea
  39.  
  40.  
  41. * !!!The following statement is to use method #2:
  42.  
  43. AREACTL d:\max\filearea.ctl
  44.  
  45.  
  46. * External program useage:  A number of statements use external programs
  47. * (viewers, archivers, etc.).  All these have a common method for specifying
  48. * parameters for them:
  49. *  - If you don't specify any of the following special parameters, the
  50. *    complete path/filename will automatically be appended to the external
  51. *    program call.
  52. *  - $D indicates append the disk at the current position.
  53. *  - $P indicates append the path at the current position.
  54. *  - $F indicates append the filename and extension at the current position.
  55. *  - $N indicates append the filename (no extenstion) at the current postion.
  56. *  - $E indicates append the file extension at the current position.
  57. *  - $O indicates do not append the path/filename automatically.  It is
  58. *    mainly useful in user defined functions.
  59.  
  60.  
  61. * !!!ARCHIVER is the name of your file archive manager (for example, SHEZ).
  62. * You may have to specify the full pathname to the program.
  63.  
  64. ARCHIVER c:\util\shez $p\$f
  65.  
  66.  
  67. * ARCHIVER_EXT is the file extensions you wish to use your archive
  68. * manager on.  All others will use your text editor.
  69.  
  70. ARCHIVER_EXT ZIP ZOO LZH ARC ARJ
  71.  
  72.  
  73. * !!!PICVIEWER is the name of the picture viewer you want to use to
  74. * view graphics files.  You may have to specify the full pathname
  75. * to the program.
  76.  
  77. PICVIEWER d:\pics\cshow $p\$f+
  78.  
  79.  
  80. * PICVIEWER_EXT is the file extensions you wish to use your picture
  81. * viewer on.
  82.  
  83. PICVIEWER_EXT GIF JPG BMP PCX TIF MCP PIC MAC
  84.  
  85.  
  86. * BROWSER is the text/hex file browser you wish to use to view raw file
  87. * data. You may have to specify the full pathname to the program.  Note in this
  88. * case the path/filename is appended automatically since no "$" parameter
  89. * is used.
  90.  
  91. BROWSER fv
  92.  
  93.  
  94. * EDITOR is the text editor you wish to use to view and edit various
  95. * files that are not compressed by an archive program.  You may have
  96. * to specify the full pathname to the program.
  97.  
  98. EDITOR t
  99.  
  100.  
  101. * GIF_TO_JPG is the name of the GIF to JPG converter you wish to use.
  102. * Note that the date of the output file will automatically be set to
  103. * that of the input file.
  104.  
  105. GIF_TO_JPG d:\pics\gif2jpg -j -a
  106.  
  107.  
  108. * JPG_TO_GIF is the name of the JPG to GIF converter you wish to use.
  109. * Note that the date of the output file will automatically be set to
  110. * that of the input file.
  111.  
  112. JPG_TO_GIF d:\pics\jpg2gif -a
  113. *JPG_TO_GIF d:\pics\alchemy -g
  114.  
  115.  
  116. * GIF_COMPRESS is the name of the GIF compressor you wish to use.
  117. * Note that the date of the output file will automatically be set to
  118. * that of the input file.
  119.  
  120. GIF_COMPRESS d:\pics\giflite -t -b -l
  121.  
  122.  
  123. * EQUATE_SIMILAR_EXT is a parameter that should have a value of "0" or "1".
  124. * It tells the program whether or not to treat all files that have an
  125. * extension contained in ARCHIVER_EXT or PICVIEWER_EXT as equivalent as
  126. * far as their description is concerned.  For example, if you have a file
  127. * called PANDA.GIF and a file called PANDA.JPG in a given subdirectory but
  128. * only PANDA.GIF has its description in the FILES.BBS file, then PANDA.JPG
  129. * will also be given the same description.  This feature is useful if you
  130. * compress your GIF files into JPG files.  There is then no need to copy the
  131. * description when you create the JPG file since the program will get it
  132. * automatically from the GIF file.  Similarly, this is useful with various
  133. * archive formats such as ZIP and ARJ.
  134.  
  135. EQUATE_SIMILAR_EXT 1
  136.  
  137.  
  138. * Many BBSs have a filearea where they put "garbage" files users upload.
  139. * These could be duplicate files users uploded with a different filename
  140. * or they could be files that don't meet the quality standards for the
  141. * BBS.  This program lets you deal with these files in a very automated
  142. * manner.  First, you must define one of your fileareas to be a "junk"
  143. * filearea.  You also must define the name of a text file that contains
  144. * a log of your user's uploads (the format of this files must be one
  145. * entry per line).  You must also define a file to be your JUNK.LOG file.
  146. * Here's how it all works:
  147. *  - Suppose a user uploads FOOBAR.GIF.  Hopefully, your BBS software would
  148. *    automatically record this in your upload log file.
  149. *  - When you look at FOOBAR.GIF you see it is a duplicate file.  You use
  150. *    the program's normal commands to move this file into your junk filearea.
  151. *  - Under the covers, BBSFMAN will automatically do the following:
  152. *    - Remove the description of FOOBAR.GIF from the FILES.BBS (nothing new
  153. *      here) of the filearea it was in.
  154. *    - Create a 0 length file in your junk filearea and add an entry into
  155. *      the FILES.BBS for the junk filearea.
  156. *    - Look in your upload log file and copy the line with this file to
  157. *      the JUNK.LOG file.  This allows you later to remove the upload credit
  158. *      for this user (if you so choose).
  159.  
  160. * Here's the definition of the three variables.  If you choose not to use
  161. * this function, make the junk filearea equal to -1 or comment out all the
  162. * variables.
  163.  
  164. JUNK_FILEAREA 99
  165. FN_UL_LOG     d:\max\ul.log
  166. FN_JUNK_LOG   d:\max\junk.log
  167.  
  168.  
  169. * The BACKUP_FILESBBS parameter determines whether or not BBSFMAN
  170. * makes a backup copy of your FILES.BBS file to FILES.BAK.  It does
  171. * this everytime you bring-up a new file directory display.  A "1"
  172. * means perform the automatic backup and a "0" means don't do it.
  173.  
  174. BACKUP_FILESBBS 1
  175.  
  176.  
  177. * The MAX_FILESBBS_LINE parameter determines the maximum permissible line
  178. * in FILES.BBS.  If you start with a FILES.BBS with a longer line than this,
  179. * BBSFMAN will abort at start-up.  If you try to create a line longer than
  180. * this from within BBSFMAN, it will automatically truncate it to this length.
  181. * This parameter must be less than or equal to 1000 and greater than 25.
  182.  
  183. MAX_FILESBBS_LINE 255
  184.  
  185.  
  186. * TOUCH_ON_MOVE parameter indicates whether or not a file that is moved to
  187. * a different directory should keep the original date ("0") or get the current
  188. * date ("1").
  189.  
  190. TOUCH_ON_MOVE 1
  191.  
  192.  
  193. * The SORT_ORDER is how directories are sorted on start-up.  This may be
  194. * one of the following:  "NAME", "EXT", "SIZE", "DATE".
  195.  
  196. SORT_ORDER date
  197.  
  198.  
  199. * The FN_PKUNZIP is the full path and filename for the PKUNZIP program.
  200. * It is necessary if you wish to automatically get descriptions from
  201. * FILE_ID.DIZ files.
  202.  
  203. FN_PKUNZIP c:\util\pkunzip
  204.  
  205.  
  206. * The FN_ARJ is the full path and filename for the ARJ program.
  207. * It is necessary if you wish to automatically get description from
  208. * FILE_ID.DIZ files.
  209.  
  210. FN_ARJ c:\util\arj
  211.  
  212.  
  213. * The FN_LHARC is the full path and filename for the LHARC program.
  214. * It is necessary if you wish to automatically get description from
  215. * FILE_ID.DIZ files.
  216.  
  217. FN_LHARC c:\util\lharc
  218.  
  219.  
  220. * The following are user-defined functions which you can execute by hitting
  221. * ALT+<number> key.  You can declare up to 10 user functions.  The format is:
  222. *
  223. * USER_FUNC_x "Description of func" program-name parameters
  224. *
  225. * where x is a number between 0 and 9.  "Description of func" must be inside
  226. * double-quotes and be less than 40 characters long.  The remainder is
  227. * the program-name and parameters and is in a similiar format to the
  228. * previous usages.
  229.  
  230. USER_FUNC_0 "Directory List"  DIR $D*.*
  231. USER_FUNC_1 "Search for similar files"  GSEE d:$N*.*
  232. USER_FUNC_2 "Search for similar files"  GSEE e:$N*.*
  233. USER_FUNC_3 "Directory List on File" FL
  234. USER_FUNC_4 "Directory Tree" FLTREE $O
  235. USER_FUNC_5 "Full-screen Directory" FL $P\*.*
  236. USER_FUNC_6 "Check Disk" CHKDSK $O
  237. USER_FUNC_7 "Alchemy JPG->GIF" ALCHEMY -g $N.$E
  238. USER_FUNC_8 "Unused" $O
  239. USER_FUNC_9 "MPEG Viewer" MPLAY
  240.  
  241.  
  242. * The following sections are used in creating an FILEIDEX.LST which is a
  243. * list of all files on your bulletin board.  Typically, you would call
  244. * this with a DOS BAT file (or OS/2 CMD file) to generate a new list once
  245. * a day.  You would probably also re-name it to whatever you want and put
  246. * in the appropriate file area and also ZIP it.
  247. *
  248. * The following is the filename of a file that will be placed at the top
  249. * of your FILEIDEX.LST file.  It typically would be the logo for your BBS
  250. * or any other descriptive info you want.
  251.  
  252. FILEIDEX_FN_HEADER d:\max\zip_cmnt.txt
  253.  
  254.  
  255. * The following are lists of fileareas to build a FILEIDEX.LST.  For
  256. * example, many BBSs have a list of files for their "normal" files and
  257. * another for their "adult" files.  The following sections allow you to
  258. * group various fileareas together and have BBSFMAN build an FILEIDEX.LST
  259. * for each of the groups.  When you execute the option of BBSFMAN to
  260. * build a filelist ("-L"), you can optionally specify a number for which
  261. * file grouping to build a list for.  For example, "-L3".  If you don't
  262. * specify the number, it will build a list for all areas.  The syntax for
  263. * the groupings is:
  264. *
  265. * FILEIDEX_GROUP_x file_area <file_area> ...
  266. *
  267. * where x is a number between 1 and 9 and file_area is a filearea number for
  268. * your BBS.
  269. *
  270.  
  271. FILEIDEX_GROUP_1 1 10 11 12 13 14 15 16 17 18 19 20 22 23 24 30 40 41 99
  272. FILEIDEX_GROUP_2 0 2 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 75 80 81
  273.  
  274.  
  275. * You can select colors for many aspects of the menus and popup windows
  276. * that are displayed by altering the color "number" in this section.
  277. * The color choices and their coresponding numbers are defined as follows:
  278. *
  279. *    BLACK = 0          * Foreground and background
  280. *    BLUE = 1           * Foreground and background
  281. *    GREEN = 2          * Foreground and background
  282. *    CYAN = 3           * Foreground and background
  283. *    RED = 4            * Foreground and background
  284. *    MAGENTA = 5        * Foreground and background
  285. *    BROWN = 6          * Foreground and background
  286. *    LIGHTGRAY = 7      * Foreground and background
  287. *    DARKGRAY = 8       * Foreground only
  288. *    LIGHTBLUE = 9      * Foreground only
  289. *    LIGHTGREEN = 10    * Foreground only
  290. *    LIGHTCYAN = 11     * Foreground only
  291. *    LIGHTRED = 12      * Foreground only
  292. *    LIGHTMAGENTA = 13  * Foreground only
  293. *    YELLOW = 14        * Foreground only
  294. *    WHITE = 15         * Foreground only
  295.  
  296. * Foreground color for active window
  297. COL_ACTIVE 15
  298.  
  299. * Foreground color for inactive window
  300. COL_INACTIVE 14
  301.  
  302. * Normal background color
  303. COL_BACKGROUND 1
  304.  
  305. * Foreground color for pop-up windows
  306. COL_POPUP_FORE 0
  307.  
  308. * Background color for pop-up windows
  309. COL_POPUP_BACK 3
  310.  
  311. * Reverse video color for pop-up windows
  312. COL_POPUP_REV 7
  313.