;YOU MAY ADD COMMENTS to this file but the ORDER of uncommented lines ;must remain constant or your scan display will be fubar. ; ;also: lines used by MetalScan cannot contain comments. ; ;All lines are explained below - comment above the line it describes ; ;note: The less comments you have in this file, the faster MetalScan ;will start-up ; ; ;============================================================================ ;LINE# PURPOSE ;============================================================================ ; ; 1 header for File items - printed at the top of each file scan listing ; f1n1cez4#### DL Filename/Title Bytes Uploader z0q1n1 ; ; 2 FILE item string 1 with tokens that expand to attributes about the ; currently listed item ; c7{ItemNum %4d}{NEWFLAG}{M!UFDP c1%1.1s}c4{Dloads %2d} c2{Title %-22.22s 1} c6{Size %7.7s} c4Uploaded by: c2{POSTERHANDLE %-27.27s 0}q1 ; ; 3 FILE item string 2 with tokens expandable to attributes about the ; currently listed item - printed IMMEDIATELY after line 2 ; It is being used here to display the SHORT description of items ; cf:2{Info %s}:0q1n2 ; ; 4 POST item string 1 with tokens that expand to attributes about the ; currently listed item ; c7{ItemNum %4d} c6{PostDate %-7.7s 0}c5{Resps %4d}c7 {Title %-29.29s 1} c2{PosterHandle %.30s 0}q1n1 ; ; 5 POST item string 2 with tokens that expand to attributes about the ; currently listed item. Printed IMMEDIATELY after line 4. ; {COMMENT} ; ; 6 The command string (from BBSMENU) that you use to run MetalScan ; ie. my BBSMENU has "MSC |#2pfiles:MetalScan" therefore I use MSC ; on this line ; MSC ; ; 7 header for POST items - printed at the top of each post scan listing ; f1n1c6z4#### DateUp Resp Title/Description Poster z0q1n1 ; ; 8 Diagnostic error text ; ERROR: Cannot open file '%s' NOTIFY SYSOP!n1 ; ; 9 Diagnostic user error text for bad range entered ; n1Invalid range (%d here).n1 ; ; 10 Diagnostic user error text for improper item number ; Item %ld not foundn1 ; ; 11 Low memory error condition 1 (replace "OLDSCAN" with the command ; you have renamed CNet's SCAN to). ; Temporary memory shortage - please use the "OLDSCAN" functionn1 ; ; 12 Low memory error condition 2 (replace "OLDSCAN" with the command ; you have renamed CNet's SCAN to). ; n1Not enough free memory for MS-ItemScan to proceed (use "OLDSCAN") !n1 ; ; 13 linefeed printed when MetalScan is ran (printed before any other text) ; n1 ; ; 14 Diagnostic text for user error - if the same subboard is scanned twice ; without the RESET argument, this line is printed ; Current subboard already scanned - Add "RESET" to your Scan command to rescann1 ; ; 15 Printed if the NEW argument is used and is there are no new items in ; the current subboard ; No new itemsn1 ; ; 16 Printed if no items match the pattern or range the user has specified ; No matching Items.n1 ; ; 17 Printed if low memory conditions occur while range buffers are being ; set up. ; Not enough memory to process rangesn1 ; ; 18 Printed if [A]bort is entered at either the BROWSE or LASTITEM prompts ; [SKIP] ; ; 19 Printed if [Q]uit is entered at either the BROWSE or LASTITEM prompts ; ^C ; ; 20 User prompt after the last item in the current subboard is listed ; n1c6Last itemc4; [c1Qc4]c6uit here, c4[c6RETURNc4]=c6next subc4> c2 ; ; 21 Browse prompt - Printed when approximately (see line 10 description) ; one screenful of items have been displayed ; n1c6Subboardc4: c7{Subname %s}n1c4(c6Browse c4: [c1Qc4]c6uitc4, [c1Rc4]c6eadc4, [c1*c4|c1Mc4|c1Fc4]c6lagc4, c1#c4)> c2 ; ; 22 The number you have set for SHORT description lines in CNets config. ; BE AWARE that this is the number used to decide when the BROWSE ; prompt is displayed. if this number + THE NUMBER OF ; LINES PRINTED since the HEADER was last displayed equals the user's ; TERMLENGTH then the browse prompt is displayed ; 6 ; ; 23 This line is the text that is used to denote NEW RESPONSES and is ; what the NEWFLAG SLToken is replaced with ; c4*c2 ; ; 24 Printed if the current subboard is empty ; n1Subboard emptyn1 ; ; 25 a "0" on this line tells MetalScan not to put a blank line ; between file-type items and post-type items. A "1" causes ; MetalScan to skip a line. This is only of use where files ; and posts share the same subboard. 1 ; ; 26 The DATE line that is printed if the "dates" argument is specified ; when MetalScan is ran. ; c4 ------------------------------ c3%15.15sc4 ------------------------------q1n2 ; ; 27 The text displayed when an item is deemed already selected. n1{SELECTTITLE %s} already selected!n1 ; ; 28 The text displayed when an item is successfully selected n1{SELECTTITLE %s} selected!n1 ; ; 29 The title displayed when the select list is full and the user tries ; to select another item. n1No more selections allowed ({SELECTMAX %ld} max.)n1 ; ; 30 text printed when the TOTAL argument/option is used. n1c4=====================n1c6Total Size: {SELECTBYTES %s}q1n1 ; ; 31 The character/Command the user must use to SELECT items (usually *) ; and MAY be more than a single character if desired. The complete ; string must be entered by the user * ; ; 32 The text printed when a user uses the *C command to clear his select ; buffer. Select list cleared!n1 ; ; 33 1st text printed when an item is [R]ead. Default = f1 (clear screen). q1f1 ; ; 34 2nd text printed when an item is [R]ead. default = item number. z4Item :q1 {ItemNum %-32d} ; ; 35 3rd text printed during [R]ead. default = subboard name. z4Sub :q1 {SubName %s}n1 ; ; 36 4th text printed - default = item title/filename z4Title:q1 {Title %-32.32s 1} ; ; 37 5th text printed - default = item size, extended arg=0 means do not ; add "k" or "M". Leave size as is. Printed only if the item is a FILE! z4Size :q1 {Size %s 0}n1 ; ; 38 5th text printed z4From :q1 {PosterHandle %-32.32s 2} ; ; 39 7th text printed z4-To- :q1 {ToHandle %-32.32s 2} ; ; 40 8th text printed z4Date :q1 {PostDate %-32.32s 1} ; ; 41 9th text printed - only printed if item is a FILE! n1z4Info :q1c7 :2{Info %s}:0n1 ; ; 42 10th text printed ; ; 43 1st line printed in Responses header.. z4Resp :q1 {RespNumOf %-31.31s} ; ; 44 2nd line printed in responses header ; ; 45 line printed IMMEDIATELY before any/all message text c4-----------------------------------------------------------------------------c6n1 ; ; 46 line printed IMMEDIATELY after any/all message text ; ; 47 line printed IMMEDIATELY before the item/response HEADER q1n1z4 z0 ; ; END OF METALSCANTEXT ; ; ; ; ; ; ;========================================================================== ;regarding comments and cryptic lines: ;------------------------------------- ;line 5 can be used for whatever you want. Leave it blank or ;use the SLToken {COMMENT} if you don't wish to use it. It is printed ;after each ITEM text, meaning that is is printed immediately after line 4, ;so it may be used to display more information about the current post. ;note that line 5 is NOT printed for FILE items.. Line 3 serves that function ; ;a set of CURLY brackets with an invalid (not known) SLToken in them ;serves as a comment - try not to abuse this feature as I have here