OS/2 Shareware BBS: 2 BBS

home *** CD-ROM | disk | FTP | other *** search

/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / dwnsrt61.zip / DOWNSORT.CFG < prev next >

Wrap

Text File | 1995-08-25 | 26KB | 479 lines

; ; ██▐███ █▐███ ██ ██ ██▐███ ██▐████ █▐███ ██▐███ ██▐████ ; ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ▐██ ; ██ ██ ██ ██ ██ █ ██ ██ ██ ██▐████ ██ ██ ██▐███ ▐██ ; ██ ██ ██ ██ ██ █ ██ ██ ██ ██ ██ ██ ██ █ ▐██ ; ██▐███ █▐███ █▐███ ██ ██ ██▐████ █▐███ ██ ██ ▐██ ; (font 2) ; ; ; ▄▀▀▀▄ ▄▀▀▀▄ █▄ █ █▀▀▀▀ ▀█▀ ▄▀▀▀▄ █ █ █▀▀▀▄ ▄▀▀▀▄ ▀▀█▀▀ ▀█▀ ▄▀▀▀▄ █▄ █ ; █ █ █ █▀█▄█ █▄▄ █ █ ▄▄ █ █ █▄▄▄▀ █▄▄▄█ █ █ █ █ █ ▀▄█ ; ▀▄▄▄▀ ▀▄▄▄▀ █ ▀█ █ ▄█▄ ▀▄▄▄▀ ▀▄▄▄▀ █ ▀▄▄ █ █ █ ▄█▄ ▀▄▄▄▀ █ █ ; (font 1) ; ; ; █▀▀▀▀▀▀ █ █ █▀▀▀▀▀▀ ; █▄▄▄▄▄▄ █▄ █▄ █▄▄▄▄▄▄ ; ██ ██ ██ ██ ; ██ ██ ██▄▄▄▄▄ ██▄▄▄▄▄ ; (font 3) ; (font 4 is reverse video of 3) ; ; ┌──────────────────────────────────────────────────────────────────────┐ ; │ Sample Configuration File for DOWNSORT by Rob Hamerling │ ; └──────────────────────────────────────────────────────────────────────┘ ; ; Downsort is designed to make many lists in almost any combination ; in a single run (with privilege, key/lock and areagroup selections). ; ; Downsort can be invoked with a commandline parameter specifying another ; than the default configuration filename, for example: ; ; DOWNSORT @SPECIAL.CFG ; ; (the '@' prefix denotes that a configuration filespec is following) ; ; ; Rules for parameter specifications in a configuration file: ; =========================================================== ; - Leading blanks and empty lines are skipped. ; - Lines with '%', '*' or ';' as first non-blank character are ; considered to contain comments only and are skipped. ; - Lines with a valid keyword but without any parameters, are also ; considered to be comment lines and are skipped. ; - Comments on parameter specification lines are not allowed. ; - All parameters for a specific keyword should be on a single line. ; - Of mutually exclusive values only the last will take effect. ; - An asterisk (*) as parametervalue denotes default-value. ; - Invalid or not-recognised parameters may be ignored without notice. ; ; ─────────────────────────────────────────────────────────────────────── ; First the specifications for the data collection phase ; ─────────────────────────────────────────────────────────────────────── ; ; AreaDat: Complete file-specification of your 'AREA.DAT' file. ; ------- AREA.DAT is built by MAXIMUS' SILT(P) with -a or -x option. ;6.1 Users of Maximus version 3.00 should generated the version 2 ;6.1 compatible AREA.DAT file with the SILT[P] option -2a !!! AreaDat d:\maximus\area.dat ; AreaDat g:\lody\max\area.dat ; AreaGroup Defines the logical name of a group of areas for a list. ; --------- AreaINclude and or areaEXclude statements following this ; AreaGroup statement define the collection of area's for this ; group (see AreaINclude and areaEXclude keywords). ; A new AreaGroup closes the previous. ; During data collection only required areas are processed. ; Some directions on the use of AreaGroups: ; - The groups are independent: areas may be member of more ; than one group, other areas may not be in any group. ; - Groups without any areaIN/EXcludes will include all areas. ; - If at least one list doesn't specify an areagroup file info ; of all area's is collected (but always listed). ; - The examples give you just an idea how to handle groups, ; the doc-file gives you more details. ; AreaINclude Select areas to be INCLUDED in the group. ; AreaEXclude Select areas to be EXCLUDED from the group. ; ----------- Normally (by default) ALL area's will be included, ; unless you use one or both of these keywords. ; Specify 1..8 character strings to indicate which areas have ; to be INcluded or EXcluded explicitly. The strings are used ; as PREFIX: all areanames starting with the same characters ; will be IN- or EXcluded. The selection is case-insensitive. ; You would normally use one of both keywords. However they ; can be used simultaneously. But since the strings are used ; as prefix this gives only meaningful results if the EXclude ; strings are more selective than the INclude strings: ; EXclude applies in that case only to INcluded area's! ; You may specify multiple strings on a line (separate the ; strings with one or more blanks), and as many lines as ; needed. ; Example: Suppose you have fileareas named HC000 to HC999. ; Then the group HOBBES below would select the files from ; areas HC000 to HC039, but NOT those ending with a '9'. ; AreaGroup Locked ; AreaINclude 2 AreaGroup Fernwood AreaINclude FA FB FC FD FE FF FG F1 F2 F3 F4 F5 F6 F7 F8 F9 ; AreaGroup DOS ; AreaEXclude HC F1 F2 F3 F4 F5 F6 F7 F8 F9 FA FB FC FD FE FF FG AreaGroup LOC AreaINclude M ; AreaGroup OS2 ; AreaINclude O I ; AreaGroup HOBBES ; AreaINclude hc00 hc01 hc02 hc03 ; AreaEXclude hc009 hc019 hc029 hc039 ; AreaGroup SDS ; AreaINclude SDS ; AreaGroup NONSDS ; AreaEXclude SDS ; FileEXclude Select FILES to be excluded from ALL(!) lists. ; ----------- By default all files in all (selected) areas will be ; consifdered for inclusion, unless you use this keyword. ; Specify 8.3 filename.ext type of strings, wildcards are ; allowed and honored, don't use quotes. ; The selection is case-insensitive and is independent of area. ; You may specify multiple filespecs on a line. Separate the ; strings with one or more blanks. Use as many lines as needed. FileExclude FILES.* *.BAK SYSTEM*.?BS DIR.?BS FileExclude 00INDEX.* WILDCAT.TXT DESCRIPT.ION TEST ; ─────────────────────────────────────────────────────────────────────── ; Above parameters involve the data collection (selection) process, ; below follow the report specifications. ; Firstly the global parameters that apply (mostly) to all reports: ; ─────────────────────────────────────────────────────────────────────── ; AreaOrder Order in which areas have to be sorted. ; Selection can be: K[eep] - Keep order of AREA.DAT ; A[lpha] - Alphabetic order of areaname ; G[roup] - Group order ; I[nclude] - order of areaINclude (above) ; Specify one of these orders (first letter is sufficient). ; 'Group'-order is a special sorting sequence for area names ; consisting of a group of letters followed by digits. ; See the documentation for details. ; Default: Group-order (also with invalid specifications) AreaOrder Group ; Title: Short string that will be displayed in BLOCK-characters ; ----- on top of all FileLists (except BBS-list). ; Not more than 20 characters are accepted as input. ;6.1 If Title isn't specified, no blocktitle will appear. ;6.1 An unlimited number of 'Title'-lines may be specified. ; The following characters are supported in block-fonts: ; UPPER case A..Z ; LOWER case a..z (but will be presented in UPPER case) ; Digits 0..9 ; _ * | . [ ] ( ) / \ - and space ; Not-supported characters are displayed as blank. ;6.1 The '`'-character (reverse quote) is translated into a half ;6.1 width space, the '~'-character into a full width space. ;6.1 Don't use imbedded '~'-characters in the tille when ;6.1 generating IPF/IP2-Filelists!! Title ~DownSort~ Title ~~~from~~~~ Title ~Holland~~ ; PreTitle Lines to be displayed immediately before the BLOCK-title. ; -------- The lines will be copied as is. However leading blanks will ; be skipped, no wrapping or truncation will be applied for ; 'long' lines. '~' (tilde) characters are translated to ; blanks. You may specify an unlimited number of PreTitle ; lines. Empty PreTitle lines are ignored and not counted. ; There is no default PreTitle. ; To create empty lines in your header specify a PreTitle ; with a tilde. PreTitle ~ PreTitle ~~~~~~~<═════:═════ p r e - t i t l e ═════:═════> PreTitle ~ ; SubTitle Lines to be displayed immediately below the BLOCK-title. ; -------- Exactly the same rules apply as for PreTitle. ; SubTitle ~ SubTitle ~~~~~~~<═════&═════ s u b - t i t l e ═════&═════> SubTitle ~ Overview of downloadable files on this magnificent Board SubTitle ~ Node number 9.999/99, modemspeeds: V.99/V.99bis SubTitle ~~~~~~~<═════════════════════════════════════════> SubTitle ~ ; BottomLine Lines to be displayed at the end of the filelist. ; ---------- Exactly the same rules apply as for PreTitle and Subtitle. ; BottomLine ~ BottomLine ~~~~~~~<═══════ b o t t o m : t i t l e ═════════> BottomLine ~ BottomLine ~~~~~~~<═══ How do you like DOWNSORT, folks? ════> BottomLine ~ ; DupNameSize Indicates the number of characters of the fileNAME that are ; ----------- maximally to be compared to consider a name 'duplicate'. ; Allows version numbers to be detected, for example: ; with "DupNameSize 6" DWNSRT59.ZIP and DWNSRT60.ZIP will ; appear as duplicates in the DupFileList report. ; Default: 8 (full filename compare). DupNameSize 8 ; NonDupEXT Suppress reporting as 'duplicate' if 2 files with equal ; --------- filenames but unequal extensions are defined as 'pair'. ; The example specification below has the effect that files of ; any pair "xyz.SDA" and "xyz.SDN" ("xyz": any filename) will ; not be listed in DupFileList. ; - Files with equal filename AND equal extension will ; still be reported as duplicate even when the extension ; is one of a 'NonDupEXT' pair! ; - Multiple extensions must be specified in as many pairs ; as can be formed (3 extension 3 pairs; 4 ext. 6 pairs; ; etc, e.g: for Nodelists: DAT EXT DAT IDX EXT IDX). ; You may specify multiple extension-pairs on a line ; (separate the extensions with blanks), and as many lines ; as needed. ; Default: no suppression NonDupEXT SDN SDA ; OrphanDesc Description text of 'orphan' (file without entry in FILES.BBS) ; NotFoundDesc Description text of files without description in FILES.BBS. ; ------------ The description will replace the default hard-coded text. ; Up to 45 characters may be specified. ; The '~' (tilde) character will not be translated here! OrphanDesc ~~~~~ !!!! Orphelin !!!! ~~~~~ NotFoundDesc ~~~ Ce fichier défie toute description! ; OfflineDesc When a filespecification is found in FILES.BBS but not ; ----------- in the corresponding download directory, this text replaces ; the filesize and date (right aligned). ; Up to 14 characters are accepted. OfflineDesc -- archived -- ; AVAstrip You may wish to strip off AVATAR graphics characters from ; -------- the contents of your FILES.BBS files. ; Specify 'No' to deactivate stripping (default is 'Yes'). ; ==> Works ONLY for COMMENT LINES in ALL- and IPF-lists, and ; remember: comments are only listed with KEEPSEQ (no sort). AVAstrip Yes ; ────────────────────────────────────────────────────────────────────── ; Above were the parameters with a global effect: applicable to all ; lists or to the execution mode of DOWNSORT. ; Below follow list-specific parameters, which might override some of ; the settings of the global parameters. ; Keep this sequence: first global, then specific parameters! ; ────────────────────────────────────────────────────────────────────── ; ; xxxFileList: Create a File lists of type 'xxx' (1 list per keyword) ; ; xxx ───┐ ┌─ Twit ; ├─ Disgrace ┌─ PathSpec of the output file ; ┌── ORP ├─ Limited │ ; ┌── BBS ├─ Normal │ ; ┌── NEW ├─ Worthy │ ┌── Additional options for ; ┌── ALL ├─ Privil │ │ each list individually: ; ┌── GBL ├─ Favored │ │ ; ┌── DUP ├─ Extra │ │ -A Alphabetic sort (filename) ; ┌── IPF ├─ Clerk │ │ -Cn Continuation-line indent ; ┌── IP2 ├─ Assistsysop │ │ -D Date sort (descending) ; ┌── OK ├─ Sysop │ │ -F# Font for titles (0..4) ; ┌── EMI ├─ Hidden │ │ -G Group sort (areanames) ; │ │ │ │ -If Imbed filespec ; │ │ │ │ -K Keep FILES.BBS seq ; │ │ │ │ -L Long line/list type ;6.1│ │ │ │ -O Orphan adoption request ; │ │ ┌── userkeys │ │ -R Remove 'not-found' entries ; │ │ │ 1..8, A..X │ │ -Sg Select AreaGroup ; │ │ │ │ │ -T Truncate file descript. ;6.1│ │ │ │ │ -Um USRmodel name ; │ │ │ │ │ -W Wrap file descriptions ; │ │ │ │ │ -X eXclude priv. in headers ; │ │ │ ┌─────────┘ │ nnn[P] entries limit: number ; │ │ │ │ │ (P=Days|Weeks|Months) ; ; ═══─═══════ ═/════ ════════ ════════════════════════════════ ; xxxFileList p/keys PathSpec Option-1 Option-2 . . . Option-n ; ; A single privilege letter (or the complete word) can be specified. ; The privilege indication may be followed by slash and a string of ; 'userkeys' may be specified. This mimics a Maximus user class and ; will open the list for areas with the corresponding locks. ; WARNING: Versions of Downsort before 5.9 included locked area's, but ; now these area's will be skipped, unless all keys are ; specified on the xxxFileList line! ; For an explanation of 'locks' and 'keys' see the MAXIMUS docs. ; If no privilege/key is specified, the default level is SYSOP with ; no userkeys. ; ; The default filename (DOWNSORT) for each list should be overwritten ; with the second parameter on the xxxFileList line. Failing to do so ; will result in a single outputfile that has overwritten all other ; lists of this and previous runs of Downsort. ; ; The following flags may be specified (in any sequence): ; -A Sort Alphabetically on filename ; -D Sort on Date/time of the files ; -G Sort on on area-Group name ; -K Keep sequence of files as they appear in FILES.BBS. ; Note: not all sorts apply to all list types (but most do) ; ; -Cn Continuation Indentation of description: relative position ; of description on second and following lines if WRAPPED ; descriptions are used. 'n' will normally be the width of ; a download counter field. ; May be specified negative for left-indentation (e.d. -C-16)! ; ; -F# ListTitle font. Choose for 'n': 0, 1, 2, 3 or 4 (default is 3). ; Valid numbers: 0 .. suppress generation of block title! ; 1 .. Simple font (5x6 pattern) ; 2 .. Pseudo-Stencil Font (7x10 pattern) ; 3 .. ROBoComputer Font (7x8 pattern) ; 4 .. Reversed Video RoboComp (7x8 pattern) ; See some samples of the fonts in the top of this file. ; Font 3 is hard coded in headers with only short areanames. ; ; -If Imbed userfile ('f' is file-spec) immediately following the ; block-title. The contents of the file is included without any ; translation, so beware of special characters and effects like ; formatting (word-wrap) especially in the IPF- and IP2-list! ; NOTEs: - does not apply to DUP- and ORP-FileLists ; - BBSFileLists imbed always DOWNSORT.HDR and DOWNSORT.TRL ; ; -L Long list format for some selected list types: ; - OK-file: explicit filenames in stead of wildcards (PATH\*.*) ; - FILFilePath: see (almost) at the end of this file. ; ; -R Remove 'offline' file-entries from FILES.BBS only! ; Other lists will have these files reported as 'offline', but ; next time you run Downsort they will have disappeared of course. ; So you have one chance to recover these entries (manually!). ; ; -Sg Select AreaGroup for list ('g' is a name defined with AreaGroup ; keyword). The list will only contain areas of the specified group. ; If no selection is specified, all areas within privilege will be ; included. ; ; -T Causes Truncation of long descriptions (to about 50 characters) ; so that each file-entry takes not more than a single line. ; -W Causes Wrapping of long descriptions: the report will contain ; as many lines as needed for the complete file description. ; ; 6.1 -Um USRmodel-name to be selected for report (USRFileList only). ; 6.1 'm' is the name of one of the specified USRmodel statements. ; ; -X eXclude privilege indications the list-headers. ; ; nnn[P] Limit the number of file-entries to a maximum of 'nnn'. ; If followed by Period-indicator ('D', 'W' or 'M') the list is ; limited not by number, but by file-AGE in Days, Weeks or Months. ; NOTEs: - the Period-letter does not apply to IPF-lists ; - 'nnn' denotes maximum number of files on a VIEW-page. ; - ALL-lists can only be limited by period (not number). AllFileList */* list\Allfiles.psq -a -W -IDownsort.Inc ; AllFileList */* list\Allfiles.hob -k -W -sHOBBES -IDownsort.Inc ; AllFileList */* list\Allfiles.fw -f1 -a -W -sFernwood -IDownsort.Inc ; AllFileList */* list\Allfiles.dos -k -W -sDOS -IDownsort.Inc ; AllFileList */2 list\Allfile2.psq 2m -a -w -f4 -x -c ; BBSFileList */* list\Bulletin.psq 3w -d -w -x ; GblFileList */* list\GblFiles.psq -a -w -c6 -IDownsort.Inc ; IpfFileList */* list\Allfiles.IPF 200 -a ; Ip2FileList */* list\Allfiles.IP2 200 -k -f4 -sfernwood ; Ip2FileList */* list\Allfiles.IP2 200 -k -f1 NewFileList */2 list\Newfile2.psq 2m -g -w -f2 -x ; EmiFileList */* list\Newfiles.emi 15d -a -w -IDownsort.inc ; DupFileList */* list\Dupfiles.psq ; DupFileList */* list\Dupfiles.grp -g ; OKFileList */* list\OKFILE.psq -g -IDownsort.Mag ; OKFileList */* list\OKFILE.FWa -a -l ; OrpFileList */* list\Orphans.psq -g -sfernwood ; NOTE: The IPF-list has the format of an INPUT-file for the ; Information Presentation Facility Compiler (IPFC). ; It should be compiled as follows: ; IPFC Allfiles.IP2 /INF ; This will produce a file called Allfiles.INF, which is ready ; to be viewed with the command: ; VIEW Allfiles ; The IPFC program is not distributed with the DOWNSORT package! ; ────────────────────────────────────────────────────────────────────── ; Below follow the specifications for manipulating/rebuilding FILES.BBS ; ────────────────────────────────────────────────────────────────────── ; FILFilePath - First parameter is [optional] specification of ; ----------- destination directory of newly generated 'FILES.BBS' files. ; Use the format: drive:\path\ ; The output-files will be called "areaname.BBS". ; If not specified the MAXIMUS path specification will be ; used (ListFile parameter if used in Maximus' AREA.CTL ; otherwise the Download directory). ; - Many but not all flags as defined for the other lists ; apply to the FILES.BBS-output of Downsort, for example: ; - TITLE is not applicable to FILES.BBS ; - file-description will be kept on a single line, not ; wrapped or truncated, and up to about 2000 characters. ; - Entries can be sorted, but then you will loose your ; comments: -K (Keep Sequence and Comments) is default. ; - -L (LONG) means here: include file size and file date, ; (which should be used only once per FILES.BBS!). ; - Avatar codes will always remain unchanged. ; - -R will REMOVE file entries in FILES.BBS if the file ; it describes could not be located by Downsort. ; - When using -Sg and multiple FILFilePaths, beware not to ; overwrite previous output (e.g. define and use mutually ; exclusive groups, such as the SDS and NONSDS example above). ; - There is no privilege/key selection applicable! FILFilePath -a -R -O -idownsort.inc ; ────────────────────────────────────────────────────────────────────── ; USRFileList Builds a list of 'free format' lines with file information. ; It is designed to build a batch-file for file maintenance. ; 6.1 The format of each line is a variable string. It is given a ; 6.1 name on the USRmodel line. The corresponding format is ; 6.1 literally the line following the USRmodel name specification. ; The format-string may contain a number of symbolic variables ; that will be replaced by the actual value of file- or ; area-information as follows: ; 6.1 %$ - privilege class of file (single letter) ; %2 - duplicate file flag: '2' if duplicate file, '1' if not. ; %A - Areaname ; %C - file Creation date (fixed 8 characters) ; %D - most recent of lastwrite and creation Date of file ; %F - Filename.ext ; %H - File-age in days ; %L - Lock-string of (file-)area ; 6.1 %N - Download count (from [nnn] in FILES.BBS file-desc) ; %P - Path specification of the file's download directory ; %S - file Size ; %W - file lastWrite date (fixed 8 characters) ; 6.1 %Z - file lastAccess date (fixed 8 characters) ; Notes: - unknown symbolic variables are copied asis. ; - to obtain '%' on the outputline specify: '%%' ; ; A number of example statements as suggestions: ; - The first example builds a batch file (REXX) to move ; Fernwood files from their original directory to a directory ; with areaname as the subdirectory-name in G:\Fernwood\. ; 6.1 - The second sample will erase files older than 2 years but ; 6.1 only when downloaded not more than 5 times ; - The third is a substitution for a 'long' OKfile. ; - The fourth USRmodel is all symbolic variables supported by ; Downsort for USRFileList. USRmodel move move '%P%F G:\Fernwood\%A\' USRmodel old if %H > 730 && %N < 5 then erase '%P%F' /* filedate: %D */ USRmodel ok @%F %P%F USRmodel all %%$=%$ %%2=%2 %%A=%A %%C=%C %%D=%D %%F=%F %%H=%H %%L=%L %%N=%N %%P=%P %%S=%S %%W=%W %%Z=%Z ; USRFileList */* list\usrlist1.cmd -G -Umove -Idownsort.rex ; USRFileList */* list\usrlist2.cmd -G -Uold -Idownsort.rex ; USRFileList */* list\usrlist3.cmd -a -Uok -sLOC -Idownsort.rex ; USRFileList */* list\usrlist4.cmd -G -Uall -sFernwood -Idownsort.rex ; ------------------------------------------------------------------------ ; ; End of sample Downsort.Cfg as provided with the orginal Downsort package. ;