home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / dwnsrt59.zip / DOWNSORT.CFG < prev    next >
Text File  |  1993-12-19  |  20KB  |  391 lines

  1. ;
  2. ;      ██▐███   █▐███  ██   ██ ██▐███ ██▐████  █▐███  ██▐███  ██▐████
  3. ;      ██   ██ ██   ██ ██   ██ ██  ██ ██      ██   ██ ██   ██   ▐██
  4. ;      ██   ██ ██   ██ ██ █ ██ ██  ██ ██▐████ ██   ██ ██▐███    ▐██
  5. ;      ██   ██ ██   ██ ██ █ ██ ██  ██      ██ ██   ██ ██ █      ▐██
  6. ;      ██▐███   █▐███   █▐███  ██  ██ ██▐████  █▐███  ██  ██    ▐██
  7. ;                                                                  (font 2)
  8. ;
  9. ;
  10. ; ▄▀▀▀▄ ▄▀▀▀▄ █▄  █ █▀▀▀▀ ▀█▀ ▄▀▀▀▄ █   █ █▀▀▀▄ ▄▀▀▀▄ ▀▀█▀▀ ▀█▀ ▄▀▀▀▄ █▄  █
  11. ; █     █   █ █▀█▄█ █▄▄    █  █  ▄▄ █   █ █▄▄▄▀ █▄▄▄█   █    █  █   █ █ ▀▄█
  12. ; ▀▄▄▄▀ ▀▄▄▄▀ █  ▀█ █     ▄█▄ ▀▄▄▄▀ ▀▄▄▄▀ █ ▀▄▄ █   █   █   ▄█▄ ▀▄▄▄▀ █   █
  13. ;                                                                  (font 1)
  14. ;
  15. ;
  16. ;                   █▀▀▀▀▀▀   █     █       █▀▀▀▀▀▀
  17. ;                   █▄▄▄▄▄▄   █▄    █▄      █▄▄▄▄▄▄
  18. ;                   ██        ██    ██      ██
  19. ;                   ██        ██    ██▄▄▄▄▄ ██▄▄▄▄▄
  20. ;                                                                  (font 3)
  21. ;                                            (font 4 is reverse video of 3)
  22. ;
  23. ;  ┌──────────────────────────────────────────────────────────────────────┐
  24. ;  │       Sample Configuration File for DOWNSORT by Rob Hamerling        │
  25. ;  └──────────────────────────────────────────────────────────────────────┘
  26. ;
  27. ;  Downsort allows you to make many lists in almost any combination in a
  28. ;  single run, especially for experienced jugglers with Maximus' key/locks!
  29. ;
  30. ;  In some occasions you might need a separate configuration file.
  31. ;  Downsort can be invoked with a commandline parameter specifying another
  32. ;  than the default configuration filename, for example:
  33. ;
  34. ;         DOWNSORT @AGROUP01.CFG
  35. ;
  36. ;  (the '@' prefix denotes that a configuration filespec is following)
  37. ;
  38. ;
  39. ;  Rules for parameter specifications in a configuration file:
  40. ;  ===========================================================
  41. ;   - Leading blanks are skipped.
  42. ;   - Lines with '%', '*' or ';' as first non-blank character are
  43. ;     considered to contain comments only and are skipped.
  44. ;   - Empty lines and lines with a valid keyword but without any
  45. ;     parameters, are also considered to be comment lines and are skipped
  46. ;   - Comments on parameter specification lines are not allowed.
  47. ;   - All parameters for a specific keyword should be on a single line.
  48. ;   - Of mutually exclusive values only the last will take effect.
  49. ;   - An asterisk (*) as parametervalue denotes default-value.
  50. ;   - Invalid or not-recognised parameters may be ignored without notice.
  51. ;
  52. ;  ───────────────────────────────────────────────────────────────────────
  53. ;  First the data (file-) collection specifications:
  54. ;  ───────────────────────────────────────────────────────────────────────
  55. ;
  56. ; AreaDat:     Complete file-specification of your 'AREA.DAT' file.
  57. ; -------      AREA.DAT is built by MAXIMUS' SILT(P) with -a or -x option.
  58. ;              The path is normally specified in MAX.CTL with the option
  59. ;              AreaDat in Session Section. With the AreaDat you may
  60. ;              specify any file that has the SILT(P)-format.
  61.  
  62.   AreaDat      area.dat
  63. * AreaDat      d:\lody\max\area.dat
  64.  
  65. ; AreaINclude  Select areas to be INCLUDED in the reports.
  66. ; AreaEXclude  Select areas to be EXCLUDED from the reports.
  67. ; -----------  Normally (by default) ALL area's will be included,
  68. ; 5.9          unless you use one or both of these keywords.
  69. ;              Specify 1..8 character strings to indicate which areas have
  70. ;              to be INcluded or EXcluded explicitly. The strings are used
  71. ;              as PREFIX: all areanames starting with the same characters
  72. ;              will be IN- or EXcluded. The selection is case-INsensitive.
  73. ; 5.9          You would normally use one of both keywords. However they
  74. ; 5.9          can be used simultaneously. But since the strings are used
  75. ; 5.9          as prefix this gives only meaningful results if the EXclude
  76. ; 5.9          strings are more selective than the INclude strings
  77. ; 5.9          (EXclude applies in that case only to INcluded area's!).
  78. ; 5.9          You may specify multiple strings on a line (separate the
  79. ; 5.9          strings with one or more blanks), and as many lines as
  80. ; 5.9          needed.
  81. ; 5.9          Example: Suppose your fileareas are named HC000 to HC999.
  82. ; 5.9          Then the specification below would select the files from
  83. ; 5.9          areas HC000 to HC039, but NOT those ending with a '9'.
  84.  
  85. * AreaINclude  hc00 hc01 hc02 hc03
  86. * AreaEXclude  hc009 hc019 hc029 hc039
  87.  
  88. ; FileEXclude  Select FILES to be EXCLUDED from the reports.
  89. ; -----------  Normally (by default) all files in all (selected) areas
  90. ; 5.9          will be included, unless you use this keyword.
  91. ; 5.9          Specify 8.3 filename.ext type of strings, wildcards are
  92. ; 5.9          allowed and honored, quotes are not needed.
  93. ; 5.9          The selection is case-INsensitive.
  94. ; 5.9          You may specify multiple filespecs on a line: separate
  95. ; 5.9          strings with one or more blanks and as many lines as needed.
  96. ; 5.9  ===>>   The first line contains the previously hardcoded excludes of
  97. ; 5.9  ===>>   Downsort versions before 5.9, it is strongly recommended to
  98. ; 5.9  ===>>   keep the first line active!
  99.  
  100.   FileExclude  FILES.*  *.BAK  SYSTEM*.?BS  DIR.?BS
  101.   FileExclude  00INDEX.*  WILDCAT.TXT
  102.  
  103. ;  ───────────────────────────────────────────────────────────────────────
  104. ;  Above parameters involve the data collection (selection) process,
  105. ;  below follow the report specifications.
  106. ;  First the global parameters that apply (mostly) to all reports:
  107. ;  ───────────────────────────────────────────────────────────────────────
  108.  
  109. ; AreaOrder    Order in which areas have to be sorted.
  110. ;              Selection can be: K[eep]    - Keep order of AREA.DAT
  111. ;                                A[lpha]   - Alphabetic order of areaname
  112. ;                                G[roup]   - Group order
  113. ;                                I[nclude] - order of areaINclude (above)
  114. ;              Specify one of these orders (first letter is sufficient).
  115. ;              'Group'-order is a special sorting sequence for area names
  116. ;              consisting of a group of letters followed by digits.
  117. ;              See the documentation for details.
  118. ;              Default: Group-order (also with invalid specifications)
  119.  
  120.   AreaOrder    GROUP
  121.  
  122. ;  Title:      Short string that will be displayed in BLOCK-characters
  123. ;  -----       on top of all FileLists (except BBS-list).
  124. ;              Not more than 20 characters are accepted as input.
  125. ;              If Title isn't specified, it will be DOWNSORT by default.
  126. ; 5.9          The following characters are supported in block-fonts:
  127. ; 5.9              UPPER case  A..Z
  128. ; 5.9              LOWER case  a..z  (but will be presented in UPPER case)
  129. ; 5.9              Digits 0..9
  130. ; 5.9              _  *  |  .  [  ]  (  )  /  \  -  and space
  131. ;              Not-supported characters are displayed as blank.
  132. ;              The '~'-character (tilde) represents a full width space,
  133. ;              the '`'-character (reverse quote) a half width space.
  134.  
  135.   Title        `DownSort
  136.  
  137. ; TitleFont    NOT SUPPORTED ANYMORE:  use individual specification on
  138. ; 5.9          xxxFileList line.
  139.  
  140. ;  PreTitle    Lines to be displayed immediately before the BLOCK-title.
  141. ;  --------    The lines will be copied asis, however leading blanks are
  142. ;              skipped, no wrapping or truncation will be applied for
  143. ;              'long' lines, '~' (tilde) characters are translated to
  144. ;              blanks. You may specify 20 PreTitle lines, excess is
  145. ;              ignored. Empty PreTitle lines are ignored and not counted.
  146. ;              There is no default PreTitle.
  147. ;              To create empty lines in your header specify a PreTitle
  148. ;              with a tilde.
  149.  
  150.   PreTitle     ~
  151.   PreTitle     ~~~~~~~<═════:═════ p r e - t i t l e ═════:═════>
  152.   PreTitle     ~
  153.  
  154. ;  SubTitle    Lines to be displayed immediately below the BLOCK-title.
  155. ;  --------    Maximum 20 SubTitles are accepted, and exactly the
  156. ;              same rules apply as for PreTitle.
  157. ;
  158.  
  159.   SubTitle     ~
  160.   SubTitle     ~~~~~~~<═════&═════ s u b - t i t l e ═════&═════>
  161.   SubTitle     ~  Overview of downloadable files on this magnificent Board
  162.   SubTitle     ~     Node number 9.999/99, modemspeeds: V.99/V.99bis
  163.   SubTitle     ~~~~~~~<═════════════════════════════════════════>
  164.   SubTitle     ~
  165.  
  166. ;  BottomLine  Lines to be displayed at the end of the filelist.
  167. ;  ----------  Maximum 20 BottomLines are accepted, and exactly the
  168. ;              same rules apply as for PreTitle and Subtitle.
  169. ;
  170.  
  171.   BottomLine   ~
  172.   BottomLine   ~~~~~~~<═══════ b o t t o m : t i t l e ═════════>
  173.   BottomLine   ~
  174.   BottomLine   ~~~~~~~<═══ How do you like DOWNSORT, folks? ════>
  175.   BottomLine   ~
  176.  
  177. ; MaxNewFiles  NOT SUPPORTED anymore. Specify maximum entries to be listed
  178. ; 5.9          for each lists individually on the appropriate xxxFileList
  179. ; 5.9          line.
  180.  
  181. ; NonDupEXT    Suppress reporting as 'duplicate' if 2 files with equal
  182. ; ---------    filenames but unequal extensions are defined as 'pair'.
  183. ;              The example specification below has the effect that files of
  184. ;              any pair "xyz.SDA" and "xyz.SDN"  ("xyz": any filename) will
  185. ;              not be listed in DupFileList.
  186. ;               -  Files with equal filename AND equal extension will
  187. ;                  still be reported as duplicate even when the extension
  188. ;                  is one of a 'NonDupEXT' pair!
  189. ;               -  Multiple extensions must be specified in as many pairs
  190. ;                  as can be formed (3 extension 3 pairs; 4 ext. 6 pairs;
  191. ;                  etc, e.g: for Nodelists:  DAT EXT  DAT IDX  EXT IDX).
  192. ; 5.9           You may specify multiple extension-pairs on a line
  193. ; 5.9           (separate the extensions with blanks), and as many lines
  194. ; 5.9           as needed.
  195. ;               Default: no suppression
  196.  
  197.   NonDupEXT    SDN SDA
  198.  
  199. ; OrphanDesc   Description text of Orphan files.
  200. ; NotFoundDesc Description text of files without description in FILES.BBS.
  201. ; ------------ The description will replace the default hard-coded text.
  202. ;              Up to 45 characters may be specified.
  203. ;              The '~' (tilde) character will not be translated here!
  204.  
  205.   OrphanDesc   ~~~~~ !!!! Orphelin !!!! ~~~~~
  206.   NotFoundDesc +++ Ce fichier défie toute description! +++
  207.  
  208.  
  209. ; OfflineDesc  When a filespecification is found in FILES.BBS but not
  210. ; -----------  in the corresponding download directory, this text replaces
  211. ;              the filesize and date (right aligned).
  212. ;              Up to 14 characters are accepted.
  213.  
  214.   OfflineDesc  -- archived --
  215.  
  216. ; AVAstrip     You may wish to strip off AVATAR graphics characters from
  217. ; --------     the contents of your FILES.BBS files.
  218. ;              Specify 'No' to deactivate stripping (default is 'Yes').
  219. ;              ==> Works ONLY for COMMENT LINES in ALL- and IPF-lists, and
  220. ;              remember: comments are only listed with KEEPSEQ (no sort).
  221.  
  222.   AVAstrip     Yes
  223.  
  224. ; ──────────────────────────────────────────────────────────────────────
  225. ; Above were the parameters with a global effect: applicable to all
  226. ; lists or to the execution mode of DOWNSORT.
  227. ; Below follow list-specific parameters, which might override some of
  228. ; the settings of the global parameters.
  229. ; Keep this sequence: first global, then specific parameters!
  230. ; ──────────────────────────────────────────────────────────────────────
  231. ;
  232. ; xxxFileList:  Create a File lists of type 'xxx' (1 list per keyword)
  233. ;
  234. ; xxx ───┐      ┌─ Twit
  235. ;              ├─ Disgrace          ┌─ FileName of the list
  236. ;   ┌── ORP     ├─ Limited           │  (without extension,
  237. ;   ┌── BBS     ├─ Normal            │  maximum 8 characters)
  238. ;   ┌── NEW     ├─ Worthy            │
  239. ;   ┌── ALL     ├─ Privil            │  ┌─ Additional options for
  240. ;   ┌── GBL     ├─ Fafored           │  │ each list individually:
  241. ;   ┌── DUP     ├─ Extra             │  │ -A     Alphabetic sort (name)
  242. ;   ┌── IPF     ├─ Clerk             │  │ -Cn    Cont.line indentation
  243. ;   ┌── IP2     ├─ Assistsysop       │  │ -D     Date sort (descending)
  244. ;   ┌── OK      ├─ Sysop             │  │ -F#    Font for titles (0..4)
  245. ;   ┌── EMI     ├─ Hidden            │  │ -G     Group sort NEW files
  246. ;   │           │                    │  │ -If    Imbed filespec
  247. ;   │           │                    │  │ -K     Keep FILES.BBS seq
  248. ;   │           │  ┌── userkeys      │  │ -L     Long line/list type
  249. ;   │           │  │   1..8          │  │ -T     Truncate file descript.
  250. ;   │           │  │   A..X          │  │ -W     Wrap file descriptions
  251. ;   │           │  │                 │  │ -X     eXclude priv. in headers
  252. ;   │           │  │       ┌─────────┘  │ nnn[P] entries limit: number
  253. ;   │           │  │       │            │        (P=Days|Weeks|Months)
  254. ;                                   
  255. ;  ═══─═══════  ═/════ ════════  ════════════════════════════════
  256. ;  xxxFileList  p/keys FileName  Option-1 Option-2 . . . Option-n
  257. ;
  258. ;  If just xxxFileList is specified, the Level by default will be SYSOP
  259. ;                                    and the filename will be DOWNSORT.
  260. ; 5.9  A single privilege letter (or the complete word) can be specified
  261. ; 5.9  ans for each privilege a separate list-file will be generated with
  262. ;      the following extension:
  263. ;         NewFileList:   N~p
  264. ;         AllFileList:   A~p
  265. ;         IpfFileList:   I~p
  266. ;         GblFileList:   G~p
  267. ;         OKFileList:    O~p
  268. ;         EmiFileList:   E~p
  269. ;      where 'p' is the (first) privilege character (of the word).
  270. ;
  271. ; 5.9  Behind the privilege indicator, optionally a slash followed by a
  272. ; 5.9  set of 'userkeys' may be specified. This will EXTEND the particular
  273. ; 5.9  list with files in areas with the corresponding locks.
  274. ; 5.9  These specifications in xxxFileList mimic a Maximus user class.
  275. ; 5.9  WARNING: Older versions of Downsort included locked area's, but
  276. ; 5.9           now these area's will be skipped, unless all keys are
  277. ; 5.9           specified on the xxxFileList line!
  278. ; 5.9  See for an explanation of 'locks' and 'keys' the MAXIMUS docs.
  279. ;
  280. ;  The default filename (DOWNSORT) for each list can be overridden
  281. ;  with the [optional] third parameter on the xxxFileList line.
  282. ;
  283. ;  The following parameters may [optionally] be specified (any sequence):
  284. ;
  285. ;     -A   Selects Alphabetic sort on filename
  286. ;     -D   Selects sort on Date/Time of the files
  287. ; 5.9 -G   Selects sort on filename in area-groups
  288. ; 5.9      (NEW- and ORP-FileLists only, in other files synonym of -A)
  289. ;     -K   Keep sequence of files in FILES.BBS
  290. ;          (ALL- and IPF-lists, and newly generated FILES.BBS files).
  291. ;
  292. ;     -T   Causes Truncation of long descriptions (to about 50 characters)
  293. ;          so that each file-entry takes not more than a single line.
  294. ;     -W   Causes Wrapping of long descriptions: the report will contain
  295. ;          as many lines as needed for the complete file description.
  296. ;
  297. ;     -Cn  Continuation Indentation of description: relative position
  298. ;          of description on second and following lines if WRAPPED
  299. ;          descriptions are used. 'n' will normally be the width of
  300. ;          a download counter field.
  301. ;          May be specified negative for left-indentation (e.d. -C-16)!
  302. ;
  303. ;     -X   eXclude privilege indications the list-headers.
  304. ;
  305. ;     -L   Long list format for some selected list types:
  306. ;           - OK-file: explicit filenames in stead of wildcards (PATH\*.*)
  307. ;           - FILFilePath: see below
  308. ;
  309. ;     -If  Imbed userfile (f = file-spec) just behind the block-title.
  310. ;          The file is included without any translation, so beware of
  311. ;          special characters and effects like formatting (word-wrap) in
  312. ;          the IPF- and IP2-list!
  313. ;          NOTEs: - does not apply to DUP- and ORP-FileLists
  314. ;                 - BBSFileList imbeds DOWNSORT.HDR and DOWNSORT.TRL
  315. ;
  316. ;     -F#  ListTitle font. Choose for 'n': 0, 1, 2, 3 or 4 (default is 3).
  317. ;          Valid numbers:   0 .. no block title at all!
  318. ;                           1 .. Simple font             (5x6 pattern)
  319. ;                           2 .. Pseudo-Stencil Font     (7x10 pattern)
  320. ;                           3 .. ROBoComputer Font       (7x8 pattern)
  321. ;                           4 .. Reversed Video RoboComp (7x8 pattern)
  322. ;          See some samples of the fonts in the top of this file.
  323. ; 5.9      WARNING: Fonts 2 and 4 may give 'truncated' characters with
  324. ; 5.9               short areanames in some lists.
  325. ;
  326. ;   nnn[P] Limit the number of file-entries to a maximum of 'nnn'.
  327. ;          If followed by Period-indicator ('D', 'W' or 'M') the list is
  328. ;          limited not by number, but by file-AGE in Days, Weeks or Months.
  329. ;          NOTEs: - the Period-letter does not apply to IPF-lists
  330. ;                 - 'nnn' denotes maximum number of files on a VIEW-page.
  331. ; 5.9             - ALL-lists can only be limited by period (not number).
  332. ;
  333. ;
  334. ;  NOTE: - For ORP-fileList specify '*' as privilege parameter
  335.  
  336.   AllFileList  */*    Down_AL1        -k -W          -c0  -IDownsort.Inc
  337. * AllFileList  */2    Down_AL2    2m  -a -w  -f4  -x
  338.   BBSFileList  s      Down_Bbs    3w  -a -w          -C6
  339. * DupFileList  s      Down_Dup
  340. * GblFileList  */*    Down_Gbl        -d -w          -c0  -IDownsort.Inc
  341. * IpfFileList  s      Down_Ipf  200   -a
  342. * Ip2FileList  s      Down_Ip2  200   -a
  343.   NewFileList  s/*    Down_N1     3w  -a -w
  344. * NewFileList  s/2    Down_N2     2m  -g -w  -f2  -x
  345. * EmiFileList  s      Down_Emi   15d  -a -w               -IDownsort.inc
  346. * OKFileList   s      Down_OKE                            -IDownsort.Mag
  347.   OrpFileList  *      Down_Orp        -g
  348.  
  349. ;  NOTE: The IPF-list has the format of an INPUT-file for the
  350. ;        Information Presentation Facility Compiler (IPFC).
  351. ;        It should be compiled as follows:
  352. ;             IPFC  DOWN_IPF.I~P  /INF
  353. ;        This will produce a file called DOWN_IPF.INF, which is ready
  354. ;        to be viewed with the command:
  355. ;             VIEW  DOWN_IPF
  356. ;        See the OS/2 Toolkit documentation for details of IPFC.
  357. ;        IPFC is not distributed with the DOWNSORT package!
  358.  
  359. ; ======================================================================
  360. ; FILFilePath  Specifications for the "FILES.BBS"-type of output.
  361. ; -----------  - First parameter is privilege selection flag. Specify '*'
  362. ;                to get all files, even the newly uploaded ones.
  363. ;              - Second parameter is [optional] specification of
  364. ;                destination directory of newly generated Files.BBS files.
  365. ;                Use the format:  drive:\directory\
  366. ;                If destination path is specified, the output filename will
  367. ;                be "FILES.ac", extension will be the first 3 characters of
  368. ;                areaname. However when 'long' areanames are present,
  369. ;                (more than 3 characters), all output-files will be called
  370. ;                "areaname.BBS".
  371. ;                If not specified the MAXIMUS path specification will be
  372. ;                used (ListFile parameter if used in Maximus' AREA.CTL
  373. ;                otherwise the Download directory).
  374. ;              - Many but not all flags as defined for the other lists
  375. ;                apply to the FILES.BBS-output of Downsort, for example:
  376. ;                 - TITLE is not applicable to FILES.BBS
  377. ;                 - file-description will be kept on a single line, not
  378. ;                   wrapped or truncated, and up to 2000 characters.
  379. ;                 - Entries can be sorted, but then you will loose your
  380. ;                   comments: -K (Keep Sequence and Comments) is default.
  381. ;                 - -L (LONG) means here: include file size and file date,
  382. ;                    (which should be used only once!).
  383. ;                 - Any Avatar codes will be kept unchanged.
  384.  
  385.   FILFilePath  s  filesbbs\      -k  -idownsort.inc
  386.  
  387. ;  ------------------------------------------------------------------------
  388. ;
  389. ; End of sample Downsort.Cfg as provided with the orginal Downsort package.
  390. ;
  391.