home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / dwnsrt63.zip / DOWNSORT.CFG < prev    next >
Text File  |  1996-12-19  |  30KB  |  549 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. ;  ┌╦══╦┐    ┌╦  ╦┐ ┌╦══╦┐ ┌╦═╦═╦┐ ┌╦══╦┐ ┌╦══╦┐ ┌╦    ┌╦╦╦┐ ┌╦══╦┐ ┌╦══╦┐
  25. ;  │╠═╦╩┘ ┌┐ │╠══╣│ │╠══╣│ │║ ║ ║│ │╠═    │╠═╦╩┘ │║      ║   │║  ║│ │║ ═╦┐
  26. ;  └╩ ╚═┘ └┘ └╩  ╩┘ └╩  ╩┘ └╩   ╩┘ └╩══╩┘ └╩ ╚═┘ └╩═╩┘ └╩╩╩┘ └╩  ╩┘ └╩══╩┘
  27. ;                                                                  (font 5)
  28. ;
  29. ;        *******  Sample Configuration File for DOWNSORT  *******
  30. ;
  31. ;    DOWNSORT is designed to make many lists in almost any combination
  32. ;    in a single run with different groups of file areas.
  33. ;
  34. ; ┌──────────────────────────────────────────────────────────────────────┐
  35. ; │  This configuration file may look complicated for first time users.  │
  36. ; │  But Downsort needs no parameters for a default ALLFILES list!!!     │
  37. ; │  Just run DOWNSORT, and read chapter 'Quick Start' in Downsort.Doc!  │
  38. ; └──────────────────────────────────────────────────────────────────────┘
  39. ;
  40. ;  Rules for parameter specifications in a configuration file:
  41. ;  ──────────────────────────────────────────────────────────
  42. ;   - Lines are free format: leading and spacing blanks are ignored, but
  43. ;   - All parameters for a specific keyword should be on a single line.
  44. ;   - For unsupported keyword a warning message is generated.
  45. ;   - Of mutually exclusive options only the last will take effect.
  46. ;   - Invalid or not-recognised parameters may be ignored without notice.
  47. ;   - Empty lines or lines with '%', '*' or ';' as first non-blank character
  48. ;     are considered to contain comments only and are ignored.
  49. ;   - Lines with a valid keyword but without any parameter, are handled as
  50. ;     comment lines and are ignored.
  51. ;
  52. ;    Downsort can be invoked with a commandline parameter specifying another
  53. ;    than the default configuration filename 'Downsort.Cfg', for example:
  54. ;         DOWNSORT @SPECIAL.CFG
  55. ;    (the '@' prefix denotes that a configuration filespec is following)
  56. ;
  57. ; ────────────────────────────────────────────────────────────────────────
  58. ;
  59. ;    RegName  The name for which you registered, enclosed in double quotes.
  60. ;    -------  Unregistered use of Downsort is permitted for up to 30 days.
  61. ;             See the file 'Register.Txt' for how to register.
  62.  
  63.   RegName     "Rob Hamerling"
  64.  
  65. ; ─────────────────────────────────────────────────────────
  66. ;  First the specifications for the data collection phase
  67. ; ─────────────────────────────────────────────────────────
  68. ;
  69. ; FareaDat     Complete file-specification of your 'FAREA.DAT' file.
  70. ; --------     FAREA.DAT is built by Maximus' SILT[P] (-a, -af or -x option).
  71. ;6.3           Default: FAREA.DAT in current directory, or otherwise in
  72. ;6.3                    MAXIMUS base directory (environment var. 'Maximus').
  73.  
  74. ; FareaDat     d:\max\farea.dat
  75.  
  76. ; FileEXclude  Select FILES to be excluded from all(!) lists.
  77. ; -----------  By default all files in all (selected) areas will be
  78. ;              included, unless you use this keyword.
  79. ;              Specify 8.3 filename.ext type of strings, wildcards are
  80. ;              allowed and honored. Don't specify quotes.
  81. ;              The selection is case-insensitive and is independent of area.
  82. ;              You may specify multiple filespecs on a line, separated
  83. ;              by one or more blanks, and as many lines as needed.
  84.  
  85.   FileExclude  FILES.*    *.BAK        SYSTEM*.?BS   DIR.?BS
  86.   FileExclude  00INDEX.*  WILDCAT.TXT  DESCRIPT.ION  TEST
  87.  
  88. ; CDROM        Areas that are located on CDROM can be handled differently
  89. ; -----        than areas on other media. A Filearea must have been
  90. ;6.3           specified for Maximus with "Type CD" to be recognised
  91. ;6.3           as such by Downsort.
  92. ;6.3           One of two values is accepted:
  93. ;6.3             NoScan  - No directory-scan will be performed, but the
  94. ;6.3                       filenames and the description in Files.Bbs will
  95. ;6.3                       be included in the lists.
  96. ;6.3                       If Files.Bbs contains filesize and filedate AND
  97. ;6.3                       the area is also specified with "Type CD DateList"
  98. ;6.3                       then the specified values will be used.
  99. ;6.3                       Otherwise the file is reported as 'offline',
  100. ;6.3                       filedate will be '01 Jan 1980' and filesize 0.
  101. ;6.3             NoList  - CDROM-areas will be completely ignored.
  102. ;6.3
  103. ;6.3           Default: no special handling of CDROM-areas.
  104.  
  105. ; CDROM  NoScan
  106.  
  107. ; AreaGroup    Defines a logical name for a group of fileareas.
  108. ; ---------    AreaGroups are used to build lists for groups of fileareas.
  109. ;              With AreaINclude and or AreaEXclude keywords following this
  110. ;              AreaGroup keyword, the collection of areas for this group
  111. ;              is defined. The groups are independent: areas may be member
  112. ;              of more than one group, other areas may not be in any group.
  113. ;              A new AreaGroup keyword closes the previous.
  114. ;              During data collection only the required areas are scanned.
  115. ;              WARNING: If at least one list doesn't specify an areagroup,
  116. ;                       file info of ALL area's is collected, which may
  117. ;                       significantly downgrade the performance of Downsort,
  118. ;                       especially when CDROM drives are involved!
  119. ;              NOTE: Areagroups are only meaningful in combination with a
  120. ;                    '-S' specification on an xxxFileList line (see below)!
  121.  
  122. ; AreaINclude  Select areas to be INCLUDED in the group.
  123. ; AreaEXclude  Select areas to be EXCLUDED from the group.
  124. ; -----------  Character strings define which filedivisions and/or
  125. ;              fileareas have to be INcluded in or EXcluded from the group.
  126. ;              The strings are used as PREFIX. All areanames that start with
  127. ;              the specified string are considered 'matching' the
  128. ;              specification. The FULLY QUALIFIED areanames (including
  129. ;              FileDivision prefixes!) are considered.
  130. ;              You may specify multiple strings on a line, separated by one
  131. ;              or more blanks, and as many lines as needed. AreaINclude
  132. ;              and AreaEXclude keywords may appear in any sequence in
  133. ;              an AreaGroup. All comparisons are case-INsensitive.
  134. ;
  135. ;              The following rules determine which areas will be member of
  136. ;              an AreaGroup:
  137. ;              - If only areaINclude is specified for a group, then ONLY
  138. ;                the areas of which the name matches with any areaINclude
  139. ;                string will be member of this group.
  140. ;              - If only areaEXclude is used for a group then ALL(!) areas
  141. ;                will be included EXCEPT those areas of which the name
  142. ;                matches with any areaEXclude string.
  143. ;              - If both areaINclude and areaEXclude are specified for a
  144. ;                group, then all areaINcludes precede any areaEXclude.
  145. ;              - If neither areaINclude nor areaEXclude is specified
  146. ;                then the group is empty.
  147.  
  148. ;              Hints for the use of AreaGroups:
  149. ;              - If you don't use areaINclude, you probably want to
  150. ;                areaEXclude 'Sysop', 'Upload', 'Inbound', etc.
  151. ;                More genarally: remember to areaEXclude those areas that
  152. ;                you normally won't show to all of your users!
  153. ;              - You would normally use one of both keywords. Using them
  154. ;                both is only meaningful if the areaEXclude strings are
  155. ;                more restrictive (longer) then the areaINclude strings.
  156. ;                See for an example the AreaGroup 'HOB' below:
  157. ;                Suppose you have fileareas named HC000 to HC999
  158. ;                in a filedivision Hob (denoting the HOBBES CDROM),
  159. ;                then the group HOB would select the files from
  160. ;                areas HC000 to HC039, but NOT those ending with a '9'.
  161. ;6.3           - 'CDROM NoList' has precedence of AreaInclude!
  162.  
  163.   AreaGroup  OS2
  164.      AreaINclude  OS2. FW.
  165.   AreaGroup  nonOS2
  166.      AreaEXclude  OS2. FW. SYSOP. UPLOAD INBOUND
  167.   AreaGroup  HOB
  168.      AreaINclude  Hob.hc00  Hob.hc01  Hob.hc02  Hob.hc03
  169.      AreaEXclude  Hob.hc009 Hob.hc019 Hob.hc029 Hob.hc039
  170.  
  171.  
  172. ;  ───────────────────────────────────────────────────────────────────────
  173. ;  Above parameters involve the data collection (selection) process,
  174. ;  below follow the report specifications.
  175. ;  First the common parameters that apply to all lists (if applicable).
  176. ;  ───────────────────────────────────────────────────────────────────────
  177. ;  Title:      Short string that will be displayed in BLOCK-characters
  178. ;    ---       on top of NEW, TOP, IPF, IPN, GBL and ALL, but not in
  179. ;              BBS, ORP, DUP, USR and FILES.BBS.
  180. ;              An unlimited number of 'Title'-lines may be specified.
  181. ;              If Title isn't specified, no blocktitles will appear.
  182. ;              The following characters are supported in block-fonts:
  183. ;                  UPPER case  A..Z
  184. ;                  LOWER case  a..z  (but will be presented in UPPER case)
  185. ;                  Digits 0..9
  186. ;                  _  *  |  .  :  [  ]  (  )  /  \  -  and space
  187. ;              Not-supported characters are replaced by a blank.
  188. ;              The '`'-character (reverse quote) is translated into a half
  189. ;              width space, the '~'-character into a full width space.
  190.  
  191.   Title        ~DownSort
  192.   Title        ~~~from
  193.   Title        ~Holland
  194.  
  195. ;  PreTitle    Lines to be displayed immediately before the BLOCK-title.
  196. ;  --------    The lines will be copied as is. However leading blanks will
  197. ;              be skipped, no wrapping or truncation will be applied for
  198. ;              'long' lines. '~' (tilde) characters are translated to
  199. ;              blanks. You may specify an unlimited number of PreTitle lines.
  200. ;              Empty PreTitle lines are ignored. There is no default PreTitle.
  201. ;              To create empty lines in your header specify a PreTitle
  202. ;              with a tilde.
  203.  
  204.   PreTitle     ~
  205.   PreTitle     ~~~~~~~<─────────── p r e - t i t l e ────────────>
  206.   PreTitle     ~
  207.  
  208. ;  SubTitle    Lines to be displayed below the BLOCK-title.
  209. ;  --------    Exactly the same rules apply as for PreTitle.
  210. ;              If an include file is specified on the xxxFileList line, then
  211. ;              this is inserted between block title and subtitle!
  212.  
  213.   SubTitle     ~
  214.   SubTitle     ~~~~~~~<─────────── s u b - t i t l e ────────────>
  215.   SubTitle     ~  Overview of downloadable files on this magnificent Board
  216.   SubTitle     ~     Node number 9.999/99, modemspeeds: V.99/V.99bis
  217.   SubTitle     ~~~~~~~<──────────────────────────────────────────>
  218.   SubTitle     ~
  219.  
  220. ;  BottomLine  Lines to be displayed at the end of the filelist.
  221. ;  ----------  Exactly the same rules apply as for PreTitle and Subtitle.
  222. ;
  223.  
  224.   BottomLine   ~
  225.   BottomLine   ~~~~~~<──── How do you like DOWNSORT, folks? ────>
  226.   BottomLine   ~
  227.  
  228. ; DupNameSize  Indicates the number of characters of the fileNAME that are
  229. ; -----------  maximally to be compared to consider a name 'duplicate'.
  230. ;              Allows version numbers to be detected, for example:
  231. ;              with "DupNameSize 6" DWNSRT61.ZIP and DWNSRT62.ZIP will
  232. ;              appear as duplicates in the DupFileList report.
  233. ;              Default: 8
  234.  
  235.   DupNameSize  8
  236.  
  237. ; NonDupEXT    Suppress reporting as 'duplicate' if 2 files with equal
  238. ; ---------    filenames but unequal extensions are defined as 'pair'.
  239. ;              The example specification below has the effect that files of
  240. ;              any pair "xyz.SDA" and "xyz.SDN"  ("xyz": any filename) will
  241. ;              not be listed in DupFileList.
  242. ;               -  Files with equal filename AND equal extension will
  243. ;                  still be reported as duplicate even when the extension
  244. ;                  is one of a 'NonDupEXT' pair!
  245. ;               -  Multiple extensions must be specified in as many pairs
  246. ;                  as can be formed (3 extension 3 pairs; 4 ext. 6 pairs;
  247. ;                  etc, e.g: for Nodelists:  DAT EXT  DAT IDX  EXT IDX).
  248. ;              You may specify multiple extension-pairs on a line
  249. ;              (separate the extensions with blanks), and as many lines
  250. ;              as needed.
  251. ;              Default: no suppression
  252.  
  253.   NonDupEXT    SDN SDA
  254.  
  255. ; OrphanDesc   Description text of 'orphan' (file without entry in FILES.BBS)
  256. ; NotFoundDesc Description text of file without description in FILES.BBS.
  257. ; ------------ The description will replace the default text.
  258. ;              Up to 45 characters may be specified.
  259.  
  260. ; OrphanDesc   ********  Orphan  *********
  261. ; NotFoundDesc *** Missing description ***
  262.  
  263. ; OfflineDesc  When a filespecification is found in FILES.BBS but the file
  264. ; -----------  is not found in the corresponding download directory, this
  265. ;              text replaces the filesize and date (right aligned).
  266. ;              Up to 14 characters are accepted.
  267.  
  268. ; OfflineDesc  [-archived-]
  269.  
  270. ; DIZimport    Import a file-description from the file File_Id.Diz in
  271. ; ---------    an archive. This will become the description in ALL output.
  272. ;6.3             No     - No import, leave descr. asis (even when missing!)
  273. ;6.3             Yes    - Import only when no description in Files.Bbs
  274. ;6.3             Force  - Import always: substitute existing description
  275. ;6.3             nn     - Numeric value for the length of the existing
  276. ;6.3                      description to force import of File_Id.Diz
  277. ;6.3                      (if length smaller than nn then force import)
  278. ;6.3           Default: No
  279.  
  280. ; DIZimport    No
  281.  
  282. ; CompressCfg  Filespec of configuration file for archive utilities.
  283. ; -----------  It is the same as used by Maximus and Squish for archiver
  284. ;6.3           specifications. A copy from Maximus 3.01 is provided.
  285. ;6.3           The file is only needed with DIZimport activity.
  286. ;6.3           See Maximus or Squish documentation for specification details.
  287. ;6.3           Default: Compress.Cfg in current directory, or otherwise in
  288. ;6.3                    MAXIMUS base directory (environment var. 'Maximus').
  289.  
  290. ; CompressCfg  Compress.cfg
  291.  
  292. ; AVAstrip     You may wish to strip off AVATAR graphics characters from
  293. ; --------     the contents of your FILES.BBS files.
  294. ;              Specify 'No' to deactivate stripping (default is 'Yes').
  295. ;              ==> Works ONLY for COMMENT lines in ALL- and IPF-lists.
  296. ;                  remember: comments are only listed with KEEPSEQ.
  297.  
  298. ; AVAstrip     Yes
  299.  
  300. ; HighASCII    Downsort generates some high-ASCII characters in its titles
  301. ; --------     and headers. Specify 'No' if you don't want these. Special
  302. ;6.3           characters will then be substituted by a low-ASCII equivalent.
  303. ;6.3           Note: Applies only to text generated by Downsort,
  304. ;6.3                 not to file-descriptions, included files, etc..
  305. ;6.3           Default: Yes
  306.  
  307. ; HighASCII    Yes
  308.  
  309. ; AreaOrder    Order in which areas have to be sorted in the lists.
  310. ;              Selection can be: A[lpha]   - Alphabetic order of areaname
  311. ;                                G[roup]   - Group (FileDivision) order
  312. ;                                I[nclude] - order of areaINclude
  313. ;                                K[eep]    - Keep order of FAREA.DAT
  314. ;              Specify one of these type (first letter is sufficient).
  315. ;              Where areanames are involved in sorts, the sequence will be
  316. ;              according to AreaOrder. With 'Group' the areas will be sorted
  317. ;              alphabetically in sequence of the fully qualified areaname,
  318. ;              (including division prefixes), with 'Alpha' areas will be
  319. ;              in sequence of the unqualified areaname (ignoring divisions).
  320. ;              'Group' and 'Keep' will make division boundaries visible.
  321. ;              Note: 'Include' uses the AreaInclude specifications, which
  322. ;              are prefixes. Areas matching the same AreaInclude string
  323. ;              will be sorted in 'Keep' sequence.
  324. ;              Default: Group
  325.  
  326. ; AreaOrder    Group
  327.  
  328. ; ───────────────────────────────────────────────────────────────────────────
  329. ; Above were the parameters common to most lists.
  330. ; Below follow list-specific parameters, which might override some of
  331. ; the settings of the common parameters.
  332. ; Keep this sequence: first common, then specific parameters!
  333. ; ───────────────────────────────────────────────────────────────────────────
  334. ;
  335. ; xxxFileList:  Create a File lists of type 'xxx' (1 list per keyword)
  336. ;
  337. ; xxx ────┐          ┌── Specification of output
  338. ;                   │
  339. ;    ┌── BBS         │        ┌── Additional options for
  340. ;    ┌── ALL         │        │   each list individually:
  341. ;    ┌── GBL         │        │
  342. ;    ┌── NEW         │        │
  343. ;6.3 ┌── HTM         │        │
  344. ;6.3 ┌── HTN         │        │ -A     Alphabetic sort on filename
  345. ;    ┌── IPF         │        │ -Cn    Continuation-line indent
  346. ;    ┌── IPN         │        │ -D     Date sort (descending)
  347. ;    ┌── TOP         │        │ -F#    Font number for BLOCK title (1..5)
  348. ;    ┌── USR         │        │ -G     Group (division) sort
  349. ;    ┌── ORP         │        │ -If    Imbed filespec
  350. ;    ┌── OK          │        │ -K     Keep original FILES.BBS sequence
  351. ;    ┌── DUP         │        │ -O     Orphans to be reported / adopted
  352. ;    │               │        │ -R     Remove 'not-found' file descriptions
  353. ;    │               │        │ -Sg    Select areagroup 'g'
  354. ;6.3 │               │        │ -T[n]  Truncate file descriptions
  355. ;    │               │        │ -Um    USRmodel logical name selection
  356. ;6.3 │               │        │ -W[n]  Wrap file descriptions
  357. ;    │               │        │ -X     eXclude display of ACS in headers
  358. ;    │               │        │ nnn[P] entries limit: number or period
  359. ;    │               │        │        ('P' = Days | Weeks | Months)
  360. ;                           
  361. ;   ═══─═══════  ════════  ════════════════════════════════
  362. ;   xxxFileList  PathSpec [Option-1] [Option-2] . . . [Option-n]
  363. ;
  364. ;      The output 'PathSpec' is mandatory for each list.
  365. ;
  366. ;  The following options may be specified (in any sequence):
  367. ;     -A   sort files Alphabetically on filename (within area)
  368. ;     -D   sort files on Date/time of the files
  369. ;     -G   sort files on Group (division) name
  370. ;     -K   Keep sequence of files as they appear in FILES.BBS.
  371. ;          Note: not all sorts apply to all list types (but most do)
  372. ;
  373. ;     -Cn  Continuation Indentation of description: relative position
  374. ;          of description on second and following lines if wrapped
  375. ;          descriptions are used. 'n' will normally be the width of
  376. ;          a download counter field.
  377. ;          May be specified negative for left-indentation (e.g. -C-16)!
  378. ;
  379. ;     -F#  BLOCK title font. Choose for '#' a number from 1 to 5.
  380. ;          Valid numbers:   1 .. Simple font             (5x6 pattern)
  381. ;                           2 .. Pseudo-Stencil Font     (7x10 pattern)
  382. ;                           3 .. ROBoComputer Font       (7x8 pattern)
  383. ;                           4 .. Reversed Video RoboComp (7x8 pattern)
  384. ;                           5 .. Wide open font          (7x6 pattern)
  385. ;          See some samples of the fonts in the top of this file.
  386. ;          Default font is 3, which is hard coded in some parts of the lists.
  387. ;          By specification of '-F' or 'F0', you may suppress block titles
  388. ;          (maybe also on places where you still want 'm, experiment!).
  389. ;
  390. ;     -If  Imbed userfile ('f' is file-spec) immediately following the
  391. ;          block-title (if any). The contents of the file is included without
  392. ;          any translation, so beware of special characters and effects like
  393. ;          formatting (word-wrap) especially in IPF- and HTML-lists!
  394. ;          NOTEs: - does not apply to lists of 'Sysop'-type (like DUP, ORP)
  395. ;                 - BBSFileList imbeds always DOWNSORT.HDR and DOWNSORT.TRL
  396. ;
  397. ;     -O   Orphans to be reported in xxxFileList or adopted in FILES.BBS.
  398. ;          Definition: 'Orphans' are files in a download directory that
  399. ;          have no entry in the corresponding FILES.BBS.
  400. ;          The entries will get the 'OrphanDesc' and will be reported in any
  401. ;          xxxFileList when the flag -O is specified. But it has effect only
  402. ;          when also an ORPFileList is requested!
  403. ;          Default: orphans will NOT be listed or adopted.
  404. ;
  405. ;     -R   Remove 'offline' file-entries.
  406. ;          Definition: 'Offline' files have an entry in FILES.BBS, but are
  407. ;          not in the download directory of the corresponding area.
  408. ;          These files will be listed with 'offline' in the size/date field.
  409. ;          When you specify '-R' the file will not appear in the list, and
  410. ;          when specified on xxxFilePath, it will be removed from Files.Bbs.
  411. ;          Default: list and do not remove 'offline' file entries.
  412. ;
  413. ;     -Sg  Select AreaGroup for the list. 'g' should be a name defined with
  414. ;          AreaGroup keyword. The list will only contain areas of the
  415. ;          specified group. If the specified group is not defined the list
  416. ;          will be empty. If no group is selected the list will contain ALL
  417. ;          areas.
  418. ;          Default: Include all areas.
  419. ;
  420. ;     -T[n] Causes Truncation of long descriptions so that linelength will
  421. ;          not be exceeded and each file-entry will take just a single line.
  422. ;     -W[n] Causes Wrapping of long descriptions: the report will contain
  423. ;          as many lines as needed for the complete file description.
  424. ;6.3       Both -T and -W may be followed by a number to specify the required
  425. ;6.3       linelength (minimum 69, maximum 2000, default 79).
  426. ;6.3       Don't specify higher than (default) 255 for IPF- and IPNFilelist
  427. ;6.3       Does not apply to HTM- and HTNFileList.
  428. ;
  429. ;     -Um  USRmodel-name to be selected for USRFileList.
  430. ;          'm' should be the name of one of the specified USRmodel statements.
  431. ;          Default: nothing (no list generated).
  432. ;
  433. ;     -X   eXclude ACS reporting the area-headers.
  434. ;
  435. ;   nnn[P] Limit the number of file-entries to a maximum of 'nnn'.
  436. ;          If followed by Period-indicator ('D', 'W' or 'M') the list is
  437. ;          limited not by number, but by file-AGE in Days, Weeks or Months.
  438. ;          NOTEs: - the Period-letter does not apply to IPF-lists
  439. ;                 - ALL-lists can only be limited by period (not by number).
  440. ;                 - 'nnn' denotes maximum number of files on a VIEW-page.
  441.  
  442. ; AllFileList  Allfiles.Lst
  443. ; AllFileList  list\Allfiles.new   2m -a -w -f5 -x           -IDownsort.Inc
  444. ; AllFileList  list\Allfiles.hob      -k -W         -sHOB    -IDownsort.Inc
  445. ; AllFileList  list\Allfiles.dos      -k -W         -snonOS2 -IDownsort.Inc
  446. ; BBSFileList  list\Bulletin.bbs   3w -d -w     -x
  447. ; GblFileList  list\GblFiles.psq      -a -w   -c6            -IDownsort.Inc
  448. ; HTMFileList  list1\HTMfiles.htm     -a -w         -sOS2
  449. ; HTNFileList  list2\HTNfiles.htm 200 -k -w         -sOS2
  450. ; IpfFileList  list\Allfiles.Ipf  200 -k -w         -sOS2
  451. ; IpnFileList  list\Newfiles.Ipf   6w -g    -f1     -sOS2
  452. ; NewFileList  list\Newfiles.psq   2m -g -t -f2 -x -t -l1000
  453. ; TopFileList  list\TOPfiles.psq   30 -a -w
  454. ; DupFileList  list\Dupes.psq
  455. ; OKFileList   list\Okfile.psq                               -iDownsort.mag
  456. ; OrpFileList  list\Orphans.psq       -g
  457.  
  458. ;  NOTE: The IPF-list has the format of an INPUT-file for the Information
  459. ;        Presentation Facility Compiler (IPFC).
  460. ;        It should be compiled with:  "IPFC  Allfiles.IPF  /INF".
  461. ;        This will produce a file called Allfiles.INF, which is ready
  462. ;        to be viewed with the command:   VIEW  Allfiles
  463. ;        Note: For copyright reasons the IPFC compiler is not distributed
  464. ;              with DOWNSORT. It can be obtained with the IBM program
  465. ;              development toolkit for OS/2, and is part of many OS/2
  466. ;              compilers.
  467.  
  468. ; ───────────────────────────────────────────────────────────────────────────
  469. ; USRFileList   Create a list of 'user format' lines with file information.
  470. ; -----------   It is designed to build batch-files for file maintenance.
  471. ;               The format of each line is a variable string. It is given a
  472. ;               name with the USRmodel keyword. The corresponding format is
  473. ;               the line immediately following the name (use no space-lines!).
  474. ;               The format-string may contain symbolic variables that will be
  475. ;               replaced by the actual value of file- or area-information
  476. ;               as follows:
  477. ;                %$ - ACS (Access Control String) of file area
  478. ;                %2 - duplicate file flag: '2' if duplicate file, '1' if not
  479. ;                %A - Areaname (fully qualified including division prefixes)
  480. ;                %C - file Creation date (fixed 8 characters)
  481. ;                %D - most recent of lastwrite and creation Date of file
  482. ;                %F - Filename.ext
  483. ;                %H - File-age in days
  484. ;                %N - Download count (from [nnn] in FILES.BBS file-desc)
  485. ;                %P - Path specification of the file's download directory
  486. ;                %S - file Size
  487. ;                %U - Unqualified areaname (without division prefix)
  488. ;                %W - file lastWrite date
  489. ;                %Z - file lastaccess date
  490. ;               Notes: - unknown symbolic variables are not substituted
  491. ;                      - to obtain '%' on the outputline specify: '%%'
  492.  
  493. ;               A number of example statements as suggestions:
  494. ;               - The first USRmodel builds a batch file (REXX) to move
  495. ;                 Fernwood files from their original directory to a directory
  496. ;                 with areaname as the subdirectory-name of G:\Fernwood\.
  497. ;               - The second model will erase files older than 2 years but
  498. ;                 only when downloaded less than 5 times.
  499. ;               - The third model is a specification for a 'long' OKfile.
  500. ;               - The fourth model contains all symbolic variables
  501. ;                 supported by Downsort for USRFileList.
  502.  
  503.   USRmodel move
  504. move '%P%F G:\Fernwood\%U\'
  505.   USRmodel old
  506. if %H > 730 & %N < 5 then  erase '%P%F'   /* check filedate: %D */
  507.   USRmodel ok
  508. @%F %P%F
  509.   USRmodel all
  510. %%$=%$ %%2=%2 %%A=%A %%C=%C %%D=%D %%F=%F %%H=%H %%N=%N %%P=%P %%S=%S %%U=%U %%W=%W %%Z=%Z
  511.  
  512. ;  USRFileList  list2\usrlist1.cmd  -G  -Umove  -sOS2    -Idownsort.rex
  513. ;  USRFileList  list2\usrlist2.cmd  -G  -Uold            -Idownsort.rex
  514. ;  USRFileList  list2\usrlist3.OK   -a  -Uok
  515. ;  USRFileList  list2\usrlist4.all  -G  -Uall   -sOS2
  516.  
  517. ; ─────────────────────────────────────────────────────────────────────────
  518. ;  Below follow the specifications for manipulating/rebuilding FILES.BBS
  519. ; ─────────────────────────────────────────────────────────────────────────
  520. ; FILFilePath  - First parameter is [optional] PATH-specification of
  521. ; -----------    destination directory of generated 'FILES.BBS' files.
  522. ;                Use for the pathspec the format:  drive:\path\
  523. ;                If pathspec is specified the output-files will be called
  524. ;                "areaname.BBS" (any filedivision prefix removed). Long
  525. ;                areanames will be truncated to the first 8 characters.
  526. ;                If pathspec not specified the MAXIMUS path specification
  527. ;                will be used (FileList parameter if used in Maximus'
  528. ;                FAREA.CTL, or otherwise the Download directory).
  529. ;              - Many but not all flags as defined for the other lists
  530. ;                apply to the FILES.BBS-output of Downsort, for example:
  531. ;                 - File-descriptions will be wrapped or truncated to
  532. ;                   lines with a maximum length of 1024 characters.
  533. ;                   Default: Wrap
  534. ;                 - Title specifications are ignored.
  535. ;                 - Entries can be sorted, but then you will loose your
  536. ;                   comments: -K (Keep sequence and comments!) is default.
  537. ;                 - Avatar codes will not be touched.
  538. ;              - When using group selection ('-Sg') and multiple FILFilePaths,
  539. ;                beware not to overwrite previous output (e.g. define and
  540. ;                use mutually exclusive groups, such as the OS2 and nonOS2
  541. ;                example above).
  542.  
  543. ;  FILFilePath   list3\   -a    -R
  544.  
  545. ; ────────────────────────────────────────────────────────────────────────
  546. ;
  547. ; End of sample Downsort.Cfg as provided with the orginal Downsort package.
  548. ;
  549.