home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / dove0793.zip / NEWSSCAN.CFG < prev    next >
Text File  |  1993-07-30  |  20KB  |  425 lines
  1. ; Sample NewsScan.Cfg file
  2. ;
  3. ; NOTE: Minimal support for users of the KA9Q (NET.EXE) program is now
  4. ;       included in NewsScan.  See the keywords starting with "KA9Q".
  5. ; NOTE: The MaxGroups keyword is no longer needed nor supported in this file.
  6. ; NOTE: Leaving the UseNet "Path:" line in scanned messages is no longer the
  7. ;       default.  See comments on the "KeepPath" line below.
  8. ;
  9. ; PLEASE NOTE: If you have used earlier (beta test) versions of NewsScan, note
  10. ; carefully the usage of the TimeZone and TimeOffset words, since you may need
  11. ; to change these!  Also, there are now maximum field lengths for newsgroup
  12. ; names and file paths, although I'd be real surprised if that causes a problem
  13. ; for anyone.  Also, THE MAXIMUM MESSAGE LENGTH THAT NEWSSCAN WILL PROCESS IS
  14. ; 12K!  Most Fidonet compatible BBS's will not let you enter a message anywhere
  15. ; near this long, but some message editors might.  NewsScan will skip any
  16. ; messages that are too long.  You can blame this limitation on the geniuses
  17. ; that decreed that Fidonet messages could have control information at both the
  18. ; top and bottom of the message, since it means that the entire message must
  19. ; fit in memory.
  20. ;
  21. ; Although this file uses many of the same tokens as DoveMail, it is NOT the
  22. ; same.  You CANNOT use a DoveMail.Cfg file with NewsScan.
  23. ;
  24. ; The first lines deal with your log file.  If you use a Binkley/Opus/Maximus
  25. ; format log file, and would like NewsScan to indicate when it runs and also
  26. ; place error information in the log file, then place the full path and
  27. ; filespec of your log file here.  If you comment this line out, NewsScan won't
  28. ; try to use a log file.
  29. ;
  30. LogFile C:\Bbs\Bbs.Log
  31. ;
  32. ;
  33. ;
  34. ;
  35. ; The next line is only for the use of those in non-English-speaking areas
  36. ; where you would like the three character abbreviations for the months of the
  37. ; year to be different than the English ones.  Note that this affects many
  38. ; different aspects of how NewsScan operates (including how it deciphers and
  39. ; creates the date field in messages it exports) so you probably shouldn't
  40. ; change it unless you use the same abbreviations consistently.  PLEASE NOTE:
  41. ; The string must be EXACTLY 36 characters long and must contain no spaces, or
  42. ; it will be rejected!  I really VERY STRONGLY advise against using this
  43. ; feature, especially if you are connected to UseNet or the Internet, but you
  44. ; have the ability to change the string if you must...
  45. ;
  46. ; MonthString JanFebMarAprMayJunJulAugSepOctNovDec
  47. ;
  48. ;
  49. ;
  50. ;
  51. ; Now, some information about your system:
  52. ;
  53. ;
  54. ; This is your UUCP format address, as is placed in messages exported from
  55. ; your system.  In NewsScan this is used in several of the messages header
  56. ; lines in exported messages.  This line must be EXACTLY the same in both
  57. ; NewsToss and NewsScan for Path line dupe checking to work properly.  This
  58. ; address, should NOT contain exclamation marks (!) since these are used as
  59. ; address delimiters.  If you don't have a registed UUCP sitename but are in
  60. ; Fidonet, you'll probably use the [p#.]f#.n#.z#.fidonet.org format, like
  61. ; this:
  62. ;
  63. Alias f8.n154.z1.fidonet.org
  64. ;
  65. ; If you have a registered name, you might use it instead, like this:
  66. ;
  67. ;Alias stjhmc.fidonet.org
  68. ;
  69. ;
  70. ;
  71. ;
  72. ; The above Alias will always be used in the "Relay-Version" line of created
  73. ; messages (don't worry about this too much because the "Relay-Version" line
  74. ; is changed by every system a message passes through), and unless you specify
  75. ; otherwise, it will also be used in the following three places:
  76. ; 1) In the "From" line of messages (i.e. From: user.name@alias)
  77. ; 2) In the "Message-ID" line of outgoing messages
  78. ; 3) In the "Path" line of outgoing messages (note the caution on this
  79. ;    one as stated above under the "Alias" keyword).
  80. ; You can explicitly change any of these to use an alias other than the
  81. ; default, if you have special circumstances that require it, but you should
  82. ; NOT do this unless you absolutely have to and know what you are doing!  If
  83. ; you don't need to do this, just leave the following lines commented out:
  84. ;
  85. ; FromAlias nbytes.myamiga.mixcom.com
  86. ; MsgIDAlias nbytes
  87. ; PathAlias nbytes
  88. ;
  89. ; Additional notes on "PathAlias":  If you don't use it at all, or use it as
  90. ; shown above, only the system name will be placed in the Path line.  However,
  91. ; in most cases you'll also want the user name as the originator of the message
  92. ; on the path line, in which case you can use one of the following special
  93. ; variations of the PathAlias line:
  94. ; 1) If you use "PathAlias !" (single exclamation point only), then the USER
  95. ;    NAME (with periods substituted for spaces) will be placed in the PATH.
  96. ;    This is probably what you want to use if you are also running DoveMail
  97. ; 2) If you use "PathAlias !!" (double exclamation point), then the default
  98. ;    Alias AND the user name will be used (system.alias!john.doe)
  99. ; 3) You can also specify a PathAlias and append an exclamation point to
  100. ;    specify an alias and that the user name should be used.  For example,
  101. ;    if you use "PathAlias nbytes!" then your path line would be of the form
  102. ;    "Path: nbytes!john.doe"
  103. ; You should probably use either a PathAlias line of the form shown in #2 or
  104. ; #3 if you are NOT running DoveMail, but rather sending the output of
  105. ; NewsScan directly to your newsfeed.
  106. ;
  107. ;
  108. ;
  109. ;
  110. ; This is the text that goes into the "Organization" line of messages leaving
  111. ; your system.  You could just say something like "No organization" but you
  112. ; could also put in the name of your BBS.  You WILL incur the wrath of many
  113. ; if you try to put a "cute" saying or some such nonsense here.  If you don't
  114. ; want an "Organization" line in your messages, just leave this commented out.
  115. ;
  116. Organization Northern Bytes BBS - Sault Ste. Marie, MI U.S.A.
  117. ;
  118. ;
  119. ;
  120. ;
  121. ; Previous versions of NewsScan would always place a "Relay-Version" line as
  122. ; the first line of the message header.  It now appears that such a line is no
  123. ; longer required, so NewsScan will NOT place a "Relay-Version" line in
  124. ; exported messages UNLESS you uncomment the following line:
  125. ;
  126. ;UseRelay
  127. ;
  128. ;
  129. ;
  130. ;
  131. ; When you (or a user of your BBS) is REPLYING to a message, if your BBS or
  132. ; message editor properly supports reply linking in the message header, you
  133. ; can place the character string "%R" (without the quotes) on a line by
  134. ; itself.  If this reply macro is the ONLY thing on the line (*WITH NO
  135. ; PRECEDING SPACES OR TABS*), it will be expanded to a string of the
  136. ; following format:
  137. ;
  138. ;      In article <message-ID> dated <date>, <user> wrote:
  139. ;
  140. ; The <message-ID>, <date> and <user> fields will be taken from the
  141. ; "Message-ID", "Date:" and "From:" lines of the message being replied to.
  142. ; You can change the text that will be used, or disable the reply macro
  143. ; entirely, by uncommenting the ReplyBanner statement.  If you don't want
  144. ; reply macro expansion, just use the ReplyBanner keyword alone, like this:
  145. ;
  146. ;ReplyBanner
  147. ;
  148. ; However, if you want to change the text of the message associated with the
  149. ; %R character string, you can do something like this:
  150. ;
  151. ; ReplyBanner Message %m from %f, posted on %d, stated the following:
  152. ;
  153. ; In the above line, %m, will be expanded to the Message-ID of the message
  154. ; being replied to, %f will be expanded to the contents of the "From:" field,
  155. ; and %d to the contents of the "Date:" field of the message being replied to.
  156. ; PLEASE... Resist the urge to replace the standard message with something
  157. ; "cutesy" or sarcastic... your users will thank you (since they will take the
  158. ; heat if you change this to something provocative).  Remember, the %d, %f,
  159. ; and %m macros only work in this file and MUST BE IN LOWERCASE.  The %r
  160. ; (which is replaceed by the above banner message or the default message) goes
  161. ; in the message as entered on your system, on a line by itself, and it is case
  162. ; insensitive.  If you don't quite understand all this now, just leave it
  163. ; all commented out and you'll be fine.
  164. ;
  165. ;
  166. ;
  167. ;
  168. ; This is the file name of the single newsgroup file that is created by
  169. ; NewsScan, which is then used as input to DoveMail.  If you are feeding it
  170. ; to DoveMail, you should probably put it in your inbound files area with
  171. ; a *.PKU extension (Note: I suggest 7FFFFFFF.PKU since DovePack will never
  172. ; create a packet with this name).  On the other hand, if you are a leaf node
  173. ; and just want to send this to your feed, then just give the path to your
  174. ; outbound area followed by an appropriately-named *.UUT file, like this:
  175. ;
  176. OutFile C:\Opus\Outbound\009a0009.UUT
  177. ;
  178. ; NOTE: If you are using the KA9Q mode (see below), the OutFile line is
  179. ; irrelevent and may be left commented out (it will be ignored in KA9Q mode).
  180. ;
  181. ;
  182. ;
  183. ;
  184. ; The next two items deal with how the date and time string will look in
  185. ; messages exported from your system.  If you want to use local time, then
  186. ; uncomment TimeZone and use the abbreviation (usually three characters long)
  187. ; for the time zone you are in (this will be appended to the date/time field
  188. ; of all messages exported from your system), and also use "TimeOffset 0"
  189. ; (this is very important if you have set the TZ environment variable from
  190. ; within your batch file).  However, the preferable methodis to leave TimeZone
  191. ; commented out (in which case the default "GMT" will be used) and to use
  192. ; TimeOffset to indicate the difference in *MINUTES* between your Time Zone
  193. ; and Greenwich Mean Time.  The reason for using minutes rather that hours is
  194. ; so that users living in places like Newfoundland (which have times that are
  195. ; not offset from GMT by an even hour amount) can be accommodated.  TimeOffset
  196. ; will accept zero and negative numbers for those living on or east of the
  197. ; Greenwich Meridian.  In North America, the following values for TimeOffset
  198. ; will be typical:
  199. ;
  200. ;     Time Zone    During Standard Time Use:    During Daylight Time Use:
  201. ;     ---------    ------------------------     ------------------------
  202. ;     Newfoundland            210                          150
  203. ;     Atlantic                240                          180
  204. ;     Eastern                 300                          240
  205. ;     Central                 360                          300
  206. ;     Mountain                420                          360
  207. ;     Pacific                 480                          420
  208. ;     Alaska                  540                          480
  209. ;     Hawaii                  600                          540
  210. ;
  211. ; If you leave both TimeZone and TimeOffset, commented out, the defaults used
  212. ; will be "GMT" and zero, respectively, which is probably NOT what you want
  213. ; unless you live on the Greenwich Meridian!  Exception: If you have set the
  214. ; TZ environment variable in your batch file (to something like EDT04... note
  215. ; that the numeric part MUST start at the fourth character position!) and you
  216. ; leave TimeOffset commented out, NewsScan will try to calculate the offset
  217. ; from the environment variable.  If you want to use the TZ environment
  218. ; variable, leave both of the keywords below commented out.  If using the
  219. ; environment variable doesn't work properly, uncomment and use TimeOffset
  220. ; here.  Note that the TimeOffset keyword is also used in NewsToss.Cfg and
  221. ; usually should be set to the same value in both files.
  222. ;
  223. ;TimeZone EST
  224. TimeOffset 300
  225. ;
  226. ;
  227. ;
  228. ;
  229. ; NewsScan uses the same scheme of "high water marks" as most echomail
  230. ; processors.  It uses the normal set unless you specify that you want to
  231. ; use the "alternate" set of high water marks by uncommenting the following
  232. ; line:
  233. ;
  234. ;AltHiWater
  235. ;
  236. ;
  237. ;
  238. ;
  239. ; NewsScan normally assumes that the messages it exports will NOT contain a
  240. ; tear line, SEEN-BY's, Path line, etc.  If, due to software limitations you
  241. ; MUST create messages that have such lines, uncomment the following line and
  242. ; it will look for the last tear line in the message and strip everything
  243. ; following it before exporting the message.
  244. ;
  245. ;StripTear
  246. ;
  247. ;
  248. ;
  249. ;
  250. ; When NewsScan exports a message, it also writes some of the UseNet header
  251. ; lines back to the original message (these are used in reply linking).  It
  252. ; will write a UseNet format "Subject: " line to the body of the message IF
  253. ; the message is a reply to another message and the Subject line is too long
  254. ; to fit in the Fidonet message header.  However, you can force it to ALWAYS
  255. ; write the UseNet format Subject line to the body of the message by
  256. ; uncommenting the following line (Note: this is provided for compatibility
  257. ; with NewsToss.  If you uncomment this line in NewsToss.Cfg, uncomment it
  258. ; here as well).
  259. ;
  260. ;KeepSubject
  261. ;
  262. ;
  263. ;
  264. ;
  265. ; When NewsScan exports a message, it will NOT write the UseNet format
  266. ; "Path: " line back to the original message unless the following line is
  267. ; uncommented (this is also provided for compatibility with NewsToss.  If
  268. ; you uncomment this line in NewsToss.Cfg, uncomment it here as well).
  269. ; Should you be doing something as foolish as trying to convert newsgroups
  270. ; to echomail, leave this commented out or your echomail processor may
  271. ; complain that there is a PATH line but no SEEN-BY lines!
  272. ;
  273. ;KeepPath
  274. ;
  275. ;
  276. ;
  277. ;
  278. ; Normally NewsScan will "throw away" any control or high bit characters it
  279. ; finds in a message, because they aren't allowed in UseNet newsgroups.  The
  280. ; following line, if uncommented, will disable the removal of control and high
  281. ; bit characters, but you should NOT do this except in VERY unusual situations.
  282. ;
  283. ;NoStrip
  284. ;
  285. ;
  286. ;
  287. ;
  288. ;
  289. ; When NewsScan exports a message that apparently did not originate on
  290. ; your system, it will include a "Sender" line in the exported message.
  291. ; If necessary, you can prevent this from happening by uncommenting the
  292. ; following line.  You should probably always uncomment the following
  293. ; if using the "KA9Q" option below.
  294. ;
  295. ;NoSender
  296. ;
  297. ;
  298. ;
  299. ;
  300. ; NewsScan always places a batched newsgroup header line (consisting of
  301. ; the string "#! rnews <message length>") at the start of each message.
  302. ; If you are doing some unusual processing and do not require this header,
  303. ; uncomment the following line.  DO NOT DO THIS unless you know what you
  304. ; are doing, since the header IS necessary in most applications.
  305. ;
  306. ;Nornews
  307. ;
  308. ;
  309. ;
  310. ;
  311. ; The following three lines are special for those using the KA9Q program and
  312. ; obtaining news from an NNTP news server that does not allow posting.  The
  313. ; first modifies the behaviour of NewsScan to do the following: 1) Omit the
  314. ; "#! rnews" line on outgoing messages,  2) Output each message as a separate
  315. ; file in the specified mail queue directory, using the filename <sequence
  316. ; number>.txt, where the sequence number is obtained from the file
  317. ; SEQUENCE.SEQ in the same directory, 3) Create a *.WRK file for each
  318. ; message in the mail queue directory, 4) Use CRLF's instead of LF's as line
  319. ; terminators in eack message.  If you use this line, you _MUST_ also use
  320. ; the "KA9QMailOut" and "KA9QNewsOut" lines (see below).
  321. ;
  322. ;KA9Q C:\KA9Q\SPOOL\MQUEUE\
  323. ;
  324. ;
  325. ;
  326. ;
  327. ; The idea behind the KA9Q Keyword is that exported messages are MAILED to a
  328. ; server at a site that can accept news articles (that already contain a
  329. ; valid "Newsgroups:" line) via mail and automatically post them to news.
  330. ; This allows you to receive mail from any NNTP news server (even one that
  331. ; does not allow posting) yet still be able to send outgoing messages to the
  332. ; newsgroups.  In order to do this, NewsScan requires two piece of
  333. ; information.  The first is the actual mail address of a server that can
  334. ; accept a news message via mail and automatically place it into news.  The
  335. ; sample line below contains the actual address of one such server (valid as
  336. ; of July, 1993).  For those familiar with the KA9Q *.WRK file format, this
  337. ; is what will go on the third line of the *.WRK file for each outgoing
  338. ; message.
  339. ;
  340. ;KA9QNewsOut mail2news@news.demon.co.uk
  341. ;
  342. ;
  343. ;
  344. ;
  345. ; The other piece of information required by the KA9Q support routine is the
  346. ; address of a "smart" mailer, or the actual address you want KA9Q's SMTP to
  347. ; connect to when sending news.  Generally, this will be either the portion
  348. ; of the address used for the "KA9QNewsOut" keyword that FOLLOWS the "@"
  349. ; symbol (e.g. "news.demon.co.uk" following the above example) OR the name;
  350. ; of a smart host nearer to you.  Again following the above example, if you
  351. ; live in the United States, for example, it would be preferable to send
  352. ; your mail to a smart host nearby and let it forward your mail to the U.K.
  353. ; via a high speed link.  The example below uses merit.edu as the place to
  354. ; which your outgoing mail is sent; from there it would be forwarded to the
  355. ; address specified in the "KA9QNewsOut" line.  For those familiar with the
  356. ; KA9Q *.WRK file format, this is what will go on the first line of the
  357. ; *.WRK file for each outgoing message.
  358. ;
  359. ;KA9QMailOut merit.edu
  360. ;
  361. ;
  362. ;
  363. ;
  364. ; This is the maximum message length that NewsScan will process.  This defaults
  365. ; to 12288, however, if NewsToss locks up when tossing long messages you may
  366. ; need to reduce this slightly.  Note that this implies that any messages
  367. ; longer than the set length will not be exported from your system.  Please
  368. ; note that the message length limitation is required due to the fact that
  369. ; Fidonet format messages may contain control information at the bottom of the
  370. ; message, and therefore the entire message must be read into memory, and the
  371. ; compiler limits the amount of string space available.  If anyone finds this
  372. ; length limitation truly objectionable, I am open to offers to purchase a
  373. ; better compiler for use in this project!
  374. ;
  375. MaxLength 12288
  376. ;
  377. ;
  378. ;
  379. ;
  380. ; These are the actual newsgroup names, followed (on the same line) by one or
  381. ; more space characters and then the complete path to the message area.  Please
  382. ; note that this section is NOT in the same format as is used by DoveMail.
  383. ; Also, each newsgroup must be EXPLICITLY specified, the use of the ".all"
  384. ; wildcard is not allowed.  Note that there are a couple of length limitations
  385. ; that must be observed:  The maximum permissible newsgroup name length is 64
  386. ; characters, and the maximum path length is 32 characters (if you have an
  387. ; entry that's too long, it will be truncated to the maximum length).  If this
  388. ; causes anyone a real problem, please let me know.  Finally, don't put blank
  389. ; or comment lines between "Begin_Newsgroups" and "End".
  390. ;
  391. Begin_Newsgroups
  392.   alt.dcom.telecom D:\MSG\ATELECOM
  393.   alt.folklore.computers D:\MSG\FOLKLORE
  394.   rec.video.cable-tv D:\MSG\RV_CABLE
  395. End
  396. ;
  397. ;
  398. ;
  399. ;
  400. ; The following are signature filenames (without paths, maximum twelve
  401. ; characters), followed by the user name with which the file name is
  402. ; associated.  You may associate more than one user name with the same
  403. ; filename, but do not list a user name more than once.  The way this works is
  404. ; that if the "From" field of a message being scanned contains a user name
  405. ; that is found in the list below, then the text of the associated signature
  406. ; file is appended to the text.  The user name must match exactly, except that
  407. ; capitalization is not considered.  The specified signature file will be
  408. ; searched for FIRST in the same directory as the message being scanned, and
  409. ; SECOND in the "current" directory (the one that NewsScan is running in).
  410. ; This lets you use special signature files in specific newsgroups, and/or a
  411. ; default signature file for all (other) newsgroups.  If the signature file is
  412. ; not found in either directory, the message will be scanned out without any
  413. ; special treatment (and without the signature being added).  Do NOT specify a
  414. ; drive or path with the signature filename, and do not use tab characters to
  415. ; separate the filenames from the user names (use spaces only).  The signature
  416. ; file MUST be in a VERY specific format - see the NEWSSCAN.DOC file and the
  417. ; SAMPLE.SIG file included in the distribution archive.  Comment this section
  418. ; out if you do not wish to use signature files.  And, don't put blank or
  419. ; comment lines between "Begin_Sigfiles" and "End".
  420. ;
  421. Begin_Sigfiles
  422.   smith.sig   John Smith
  423.   sample.sig  Alfred Neuman
  424. End
  425.