home *** CD-ROM | disk | FTP | other *** search
/ PC Open 48 / pcopen48.iso / Internet / SbNewsRobot / DATA.2 / newsbot.doc < prev    next >
Encoding:
Text File  |  2000-10-09  |  69.0 KB  |  1,312 lines

  1. SBNews: News Robot Utility 
  2.  
  3. (C) Scott M Baker, smbaker@sb-software.comor smbaker@primenet.com
  4. -------------------------------------------------------------------------------
  5.  
  6. I variously refer to this program under the names "NewsBot" and "SBNews" 
  7. throughout the document. You can for the most part consider them to be the 
  8. same. Eventually, I plan on including extra utilities in this package, "SBNews" 
  9. will be the name of the full package and "NewsBot" will be the name of the News 
  10. Robot utility within the package. 
  11.  
  12. The SBNews online help is usually more specific and up-to-date if you are 
  13. looking for information on a specific command or feature. This document should 
  14. be considered more of an installation and setup guide. 
  15. -------------------------------------------------------------------------------
  16.  
  17. Table of Contents 
  18.  
  19.     * Purpose 
  20.     * General Information 
  21.           * System Requirements 
  22.           * Distribution Information 
  23.           * Features 
  24.           * Files Included 
  25.     * Installation 
  26.     * Command Line Parameters 
  27.     * JPEG Viewer 
  28.     * Configuration 
  29.           * Appearance 
  30.           * Host Name 
  31.           * Download Path 
  32.           * Path Expansion 
  33.           * Miscellaneous 
  34.           * Lockout Lists 
  35.           * Authentication 
  36.           * Acceptable File Masks 
  37.           * Duplicate Checking 
  38.           * AutoSave 
  39.           * Auto Encryption 
  40.           * Files.BBS Generation 
  41.     * Statistics 
  42.     * Coord: The Newsbot Coordinator 
  43.     * Acknowledgements 
  44.     * Registration 
  45.     * How to Contact the Author 
  46.     * Revision History 
  47. -------------------------------------------------------------------------------
  48.  
  49. Purpose: 
  50.  
  51. The purpose of this program is to automatically downloadand uudecode files from 
  52. newsgroups via a winsockconnection. If you've found this program, then you 
  53. probably know what this means, so I won't go into detail. Newsbot will attempt 
  54. to piece together multi-part files. Both uuencodeand mime base-64 formats are 
  55. supported, although piecing together of multiple files works best with 
  56. uuencoded data. 
  57.  
  58. If you're new to binary newsgroups, then here are a few G-rated newsgroups that 
  59. you might wish to try: 
  60.  
  61. alt.binaries.pictures.astro
  62. alt.binaries.pictures.animals 
  63. alt.binaries.pictures.cartoons 
  64. alt.binaries.pictures.fractals 
  65.  
  66. There are a wealth of adult-oriented newsgroups, but I'm not going to list them 
  67. in this document. 
  68.  
  69. I have included a sample file, SAMPLE_G.TXT, which includes a listing of binary 
  70. newsgroups. There are no descriptions, but you can probably find out from the 
  71. newsgroup name what subject matter the newsgroup deals with. Newsbot will 
  72. download a newsrcfile for you automatically the first time you connect to your 
  73. news server. You can access the newsrc file by using the <Add> button and 
  74. selecting <Browse>.
  75.  
  76. Newsbot is primarilly intended for automatic unattended download. Newsbot can 
  77. be used to gain a large number of files with little or no user intervention, 
  78. allowing the user to spend most of his/her time viewing the files. 
  79. Nevertheless, there are several manual features supported to give the user 
  80. control and status information, such as thumbnails displayed during download, 
  81. anti-SPAM controls, and the ability to manually select headers to filter out 
  82. unwanted mail. 
  83. -------------------------------------------------------------------------------
  84.  
  85. Requirements: 
  86.  
  87.     * Windows 3.1 or greater 
  88.     * Winsock connection capability (i.e. SLIP or PPP) 
  89.  
  90. Distribution: 
  91.  
  92.     * 16-bit (Windows 3.1) Version: SBNEWSxx.ZIP (xx denotes version number) 
  93.     * 32-bit (Windows 95) Version: SBN32_xx.ZIP (xx denotes version number 
  94.  
  95. Features: 
  96.  
  97.     * Unattended download - do other work (or go out to lunch) while downloads 
  98.       and uudecoding are all processed for you! 
  99.     * Automatic HTTP address logging -- NewsBot will keep track of any HTTP 
  100.       URL's that were found while downloading addresses. These will be saved to 
  101.       a convenient HTM file, HTTPGRAB.HTM. 
  102.     * Built in JPEG viewer. Allows you to see postage-stamp size images of the 
  103.       files you are downloading in progress. 
  104.     * Delete/View previously downloaded JPEG files. 
  105.     * Comprehensive logging capabilities - save the subject and from 
  106.       information for files that you might want to follow up on later. 
  107.     * Dupe Checkers -- avoid downloading the same files multiple times. 
  108.     * Auto-Encryption -- can be set to automatically encrypt files when saving 
  109.       to disk to keep their contents private. 
  110.     * Automatic FILES.BBS generation for sysops 
  111.     * Eliminate advertisements/SPAM with the Maximum XRef Limit (see 
  112.       preferences) and the XRef Lockout Filter (see lockout lists) 
  113.  
  114. Files Included: 
  115.  
  116.     * NEWSBOT.EXE: Executable; what you need to run to get the program to work. 
  117.     * NEWSBOT.HTM: Documentation in HTML format (read with your browser) 
  118.     * NEWSBOT.DOC: Documentation in plain-ASCII format (read with any plain 
  119.       ascii text editor) 
  120.     * BWCC.DLL (16-bit) or BWCC32.DLL (32-bit): Borlands Custom-Control DLL 
  121.       library; used to support Newsbot's grey dialog boxes. 
  122.     * FILE_ID.DIZ: Brief description file; useful for bbs distribution 
  123.     * SAMPLE_G.TXT: Plain-ASCII listing of binary newsgroups 
  124.     * REGISTER.HTM: Registration info in HTML format 
  125.     * REGISTER.DOC: Registration info in plain-ASCII format 
  126.     * README.1ST: General information on documentation & archives 
  127.     * ENCRYPT.EXE: Standalone utility, Used to encrypt files on disk 
  128.     * DECRYPT.EXE: Standalone utility, Used to decrypt files on disk 
  129.     * COORD.EXE: (32-bit version only) Used to coordinate multiple Newsbot 
  130.       applications running concurrently 
  131. -------------------------------------------------------------------------------
  132.  
  133. Installing and Using the Program: 
  134.  
  135. Here are some very quick notes on installing and using Newsbot: 
  136.  
  137. Installation: 
  138.  
  139.    1. Unzip the distribution archive into the (temporary) directory of your 
  140.       choice. 
  141.    2. Run the file SETUP.EXE -- this is an automatic InstallShield setup 
  142.       program and will copy all files and do everything else necessary to get 
  143.       the program installed for you. 
  144.  
  145. Running: 
  146.  
  147.    1. Run NEWSBOT.EXE -- this can be done in various ways - from the Win-95 
  148.       command prompt, the Windows Explorer (and/or file manager), the Windows 
  149.       Run Program command, etc. 
  150.    2. On your first session, you'll be prompted for a "News Host Name". This is 
  151.       the name of your news host, and should be given to you by your ISP 
  152.       (internet service provider). 
  153.    3. On your first session, you'll be prompted for a "download path". This is 
  154.       the path where you want the files you download to be placed. 
  155.    4. Once NewsBot is loaded, you'll want to add some newsgroups. This is done 
  156.       with the "Add" button. You'll need to know the names of the groups you 
  157.       want; you might want to consult SAMPLE_G.TXT for some sample newsgroup 
  158.       names. 
  159.    5. Press the "CONNECT" button to start everything. All else should be mostly 
  160.       automatic from here on. Feel free to tinker around with the menu items 
  161. -------------------------------------------------------------------------------
  162.  
  163. Command Line Parameters 
  164.  
  165.     * "-i INI_FILE_NAME". Sets the name of the INI file to use. By default, 
  166.       newsbot uses the file newsbot.ini in your windows directory. Specifying a 
  167.       filename here will cause newsbot to use the file under that name in 
  168.       newsbot's home directory. For example "Newsbot -i news1.ini" would use 
  169.       the filename "news1.ini" in newsbot's home directory. 
  170.     * "-auto". Will automatically begin downloading news articles as soon as 
  171.       newsbot has loaded. Note: For unregistered users, about screen will still 
  172.       be displayed! 
  173.     * "-autoexit". Automatically exits SBNews after all groups have been 
  174.       received. 
  175.     * "-noabout". Omits display of the about dialog on startup of Newsbot. 
  176.       Note: Only supported in registered version! 
  177.     * "-autorestart". Automatically restarts after all groups have been 
  178.       received. Note: Incompatible with -autoexit and -autocat 
  179.     * "-autocat". Generates image catalogs in each group after all groups have 
  180.       been received. 
  181.     * "-minimize". This will cause SBNews to be minimized on startup 
  182.     * "-autoshrink". Automatically causes SBNews to be shrunk down to the 
  183.       taskbar on startup. This is equivalent to using the 
  184.       File:Shrink-to-Taskbar pull-down menu option. 
  185.  
  186. How to use command line parameters:
  187.  
  188. You can enter command line parameters in several different ways. Here are some 
  189. popular methods:
  190.  
  191.     * SBNews Defaults: In SBNews, click the pull-down menu "Configure" and the 
  192.       item "Default Command Line Switches". This will present you with a 
  193.       listing of the most popular command line switches, and you can 
  194.       check/uncheck them to select the default behavior, and SBNews will act as 
  195.       if the appropriate options were given on the command line. 
  196.     * Win-95 Start Menu: If SBNews has been configured onto the Win-95 Start 
  197.       Menu (the install program does this by default), then you can set command 
  198.       line options there. Click the 'start' button, then select 'Settings' and 
  199.       'Taskbar'. On the taskbar settings dialog, select the 'Start Menu 
  200.       Programs' tab, and then the 'Advanced' button. This will bring up an 
  201.       explorer-type window which has all of your start menu programs on it. On 
  202.       the left-hand tree display, navigate to the SBNews folder. Once you've 
  203.       done this, the right hand panel will show the items in the SBNews folder 
  204.       (Documentation, help, readme, and sbnews). Right-Click the one that says 
  205.       "SBNews" and then follow the instructions for Win-95 shortcut below. [I 
  206.       know, this is all very complicated, but that's microsofts fault, not 
  207.       mine]
  208.     * Win-95 Shortcut: Right click on the shortcut and select 'properties'. 
  209.       Click the 'Shortcut' tab on the properties dialog. Then find the edit 
  210.       field that says 'Target'. You can enter any command line parameters here 
  211.       -- for example "c:\program files\sbnews\sbnew.exe -autoexit -autocat". 
  212.     * Win-95 MS-DOS Prompt: You can type a full command line into the MS-DOS 
  213.       prompt, with command line options and all. (Assuming you know how to use 
  214.       the MS-DOS Prompt, this should be simple for you -- otherwise you should 
  215.       probably choose one of the other methods)
  216.     * Win-95 Start:Run Menu: If you use the Windows-95 'Run' command on the 
  217.       start menu, then you can enter command line options right after the 
  218.       executable file name.
  219. -------------------------------------------------------------------------------
  220.  
  221. Jpeg Viewer 
  222.  
  223. SBNews has a built in Jpeg viewer for viewing JPEG files offline. The JPEG 
  224. viewer can be operated in several ways: 
  225.  
  226.    1. By double-clicking on a [RECEIVED] entry in Newsbot's log window 
  227.    2. By single-clicking on one of the preview pictures on the right hand side 
  228.       of Newsbot's main window. 
  229.    3. By using the FILE:VIEW JPEG option from Newsbot's pulldown menu. 
  230.  
  231. Once loaded, the JPEG viewer window will display the JPG file selected and 
  232. include a listing of filenames and directories on the left-hand side of the 
  233. window. This listing is provided to let you easilly select other files to view. 
  234. Double clicking on a directory in the directory list will change to that 
  235. directory and double clicking on a filename in the file list will display that 
  236. file. The CHDIR and VIEW buttons perform the same functions, respectively. 
  237.  
  238. The "<" and ">" buttons will view the immediately previous and next files in 
  239. the currently selected directory. You may use these to rapidly view a list of 
  240. files that were downloaded overnight for example. The ">" button will activate 
  241. a slideshow of the current directory. Each file will be displayed, there will 
  242. be a slight delay, and the next file will be displayed. 
  243.  
  244. The FILE menu of the viewer has several options: 
  245.  
  246.     * Open File: Allows you to open a new file using the windows common-dialog 
  247.       open method. 
  248.     * Delete File: Deletes the current file that you are viewing. 
  249.     * Save as BMP: Saves the current image as a BMP image, which may later be 
  250.       used as windows wallpaper, for example. 
  251.     * Set as Wallpaper: Saves the current file as a BMP and tells window to use 
  252.       it was wallpaper. 
  253.  
  254. The SlideShow menu has a few options as well: 
  255.  
  256.     * Start/Stop: Starts and stops the slideshow, equivalent to the ">" button. 
  257.     * Set Interval: Sets the amount of delay between slideshow pictures. 
  258.     * "Normal Mode": Images will be displayed in the jpeg viewers window. 
  259.     * "Wallpaper Mode": Images will also be set as WallPaper. This sort-of 
  260.       turns your entire desktop into a slideshow display. You can minimize the 
  261.       JPEG viewer window and continue to do work while images display in the 
  262.       background as wallpaper. 
  263. -------------------------------------------------------------------------------
  264.  
  265. Configuration 
  266.  
  267. Appearance: 
  268.  
  269. Newsbot has several different main window styles. You may select whichever 
  270. style appeals to you most, they all convey more or less the same information: 
  271.  
  272.     * Small: Designed to display as much information as possible in a small 
  273.       footprint. The "file log" is unavailable, but all other information in 
  274.       present. 
  275.     * Large: Default configuration for systems with 800x600 resolution or 
  276.       above. 
  277.     * Windows-95 Tabbed: Same footprint as the small dialog, but uses a tab 
  278.       control to select different panels of information. Somewhat less 
  279.       cluttered, but you will need to use the tab between the information you 
  280.       want to see. Large current/previous thumbnails. 
  281.  
  282. Host Name: 
  283.  
  284. The host name is the name of the nntp host which NewsBot will connect to. If 
  285. you don't already know this, then you may wish to contact your Internet Service 
  286. Provider (ISP) or check an existing news program on your system for the name. 
  287.  
  288. Download Path: 
  289.  
  290. The base path where downloaded files will be placed. If you enable any of the 
  291. download path expansion (see misc. preferences), then files may be downloaded 
  292. into sub-directories of this base path. 
  293.  
  294. Path Expansion: 
  295.  
  296. By default, all files will be downloaded into the download directory that you 
  297. have specified. However, this can lead to confusion, since you will not know 
  298. which files came from which newsgroups. Thus, there are several "path 
  299. expansion" options that will create a sub-directory tree for the individual 
  300. groups. The options are: 
  301.  
  302.     * None: All files go into the same subdirectory 
  303.     * Group Number: Files are placed in numerical directories, according to 
  304.       their order in your newsgroup list. 
  305.     * Expanded Group Name: Each field of the Newsgroup name is made into a 
  306.       subdirectory name. For example, "alt.binaries.pictures.misc" would become 
  307.       "alt\binaries\pictures\misc". This option is useful for Windows-3.1 
  308.       systems, since subdirectory names may only be a short length. 
  309.     * Full Group Name: The entire Newsgroup name is used as one big 
  310.       subdirectory name. This is only available in Windows-95 with long 
  311.       filename support. 
  312. ┌──────────────────┬─────────────────────────────────────────┐
  313. │Path Expansion Exa│Resultant Path es.pictures.misc)         │
  314. │Path Exp Setting  │                                         │
  315. ├──────────────────┼─────────────────────────────────────────┤
  316. │None              │c:\download\                             │
  317. ├──────────────────┼─────────────────────────────────────────┤
  318. │Group Number      │c:\download\group1\                      │
  319. ├──────────────────┼─────────────────────────────────────────┤
  320. │Exp Group Name    │c:\download\alt\binaries\pictures\misc\  │
  321. ├──────────────────┼─────────────────────────────────────────┤
  322. │Full Group Name   │c:\download\alt.binaries.pictures.misc\  │
  323. └──────────────────┴─────────────────────────────────────────┘
  324.  
  325. For the "group name" options, you may wish to trim repetitive prefixes from the 
  326. front of the path name. For example, there's no need to include 
  327. "alt.binaries.pictures" in the beginning of each pathname -- it just leads to 
  328. wasted space. The Path Prefix Removal box is used for this purpose. Any 
  329. string(s) that you enter in this box will be removed from the front of the 
  330. newsgroup name before the path is generated. 
  331.  
  332. Miscellaneous Preferences: 
  333.  
  334. Miscellaneous preference options are located under the Configure menu under the 
  335. heading Preferences. 
  336.  
  337.     * Logging: Logging options control the creation of the newsbot.log file. 
  338.       The log may be useful so that you have more information about the files 
  339.       that you have downloaded. The log filename is "newsMMDD.log", where MM is 
  340.       the current month and DD is the current day. For example, the log for 
  341.       June 6 would be saved in "news0606.log". The log is plain-ascii and may 
  342.       be viewed with any text editor, or by using the dos "type" command. 
  343.     * Log Enabled: if checked, then a log file will be written. Otherwise, no 
  344.       log will be written. 
  345.           * From user name: records the name of the person who posted the 
  346.             message 
  347.           * Subject: records the subject line of the message 
  348.           * Comments: records the first few non-file lines of the message. 
  349.             Useful if the sender has prefaced the message with some explanation 
  350.             of it's content. 
  351.           * Too Small: Messages that are below the minimum message line limit 
  352.             (see below). 
  353.           * Too Long: Messages that are above the maximum message line limit 
  354.             (see below). 
  355.           * Dupe File: Files caught by the dupe-file checker. 
  356.           * Dupe Subject: Messages caught by the dupe-subject checker. 
  357.           * Mime Headers: Really just debugging info for me.... 
  358.           * Delete old Logs: If checked, then any log files not equal to the 
  359.             current date will be deleted when newsbot is run. This minimizes 
  360.     * Case Conversion: These options will convert the case of the filename to a 
  361.       uniform format. Due to limitations in the 16-bit application model, 
  362.       filenames will probably be always upper case in the 16-bit executable. 
  363.           * None: Leave filename case as it appears over the modem. 
  364.           * Lower: Convert all filenames to lower case. 
  365.           * Upper: Convert all filenames to upper case. 
  366.     * Disconnect/Reconnect: The disconnect/reconnect system will automatically 
  367.       disconnect and reconnect the current nntp session in order to abort a 
  368.       message that is being transmitted. This is used to save time, rather than 
  369.       downloading entire messages which are not stored on disk. If you disable 
  370.       disconnect/reconnect, then Newsbot will receive the entire message, 
  371.       although the message will not be written to disk. You may toggle 
  372.       disconnect/reconnect on or off for several subcases: 
  373.           * No-Data: Messages with more non-encoded lines than the no-data 
  374.             threshold set below. 
  375.           * Dupe-File: Files caught by the dupe-file checker (not relevent to 
  376.             the dupe-subject checker, as the dupe-subject checker won't 
  377.             download the message in the first place) 
  378.           * No-Mask: Files which do not match an acceptable file mask. 
  379.           * Current-Delete: Files which were deleted during transfer by a user 
  380.             request. 
  381.           * Lockout-File: Files whose names are matched by the lockout filename 
  382.             system. 
  383.           * Lockout-XRef: Messages where a string in the XRef field matches the 
  384.             lockout-xref system. 
  385.           * Lockout-Host: Messages where the NNTP-Posting-Host name matches the 
  386.             lockout-host system. 
  387.  
  388.       Note: Sometimes the Disconnect/Reconnect options may cause your news 
  389.       server to record an excessive load. This is because Newsbot will 
  390.       disconnect the connection, but your news server may continue to keep the 
  391.       connection open for a short period of time. Thus, the news server may 
  392.       think that you are using more connections than you really are. This 
  393.       situation is unlikely, but if it does present a problem, then you may 
  394.       wish to disable the disconnect/reconnect options. 
  395.     * Message Line Limits: Newsbot can limit which messages are downloaded 
  396.       based on the length (number of lines) of the message. 
  397.           * Minimum Lines: Messages with fewer than the specified number of 
  398.             lines will not be downloaded. The rationale is that small messages 
  399.             do not contain any useful information (pictures are big!) and some 
  400.             efficiency may be obtained by not downloading them. 
  401.           * Maximum Lines: Messages with greater than the specified number of 
  402.             lines will not be downloaded. The rationale is that really huge 
  403.             messages are a waste of time. It's usually the case of someone who 
  404.             scanned in a picture at too fine a resolution. 
  405.           * "No Data" Threshold: This specifies the number of lines that can be 
  406.             in a message when no attached files (eg images) can be found before 
  407.             the message is skipped. For example, if 500 lines are scanned, and 
  408.             no attached image is present, then the message is probably grunged, 
  409.             a misplaced part of a multipart encode, or some other useless data. 
  410.     * Maximum XRef Limit: Many people have complained about an excess of 
  411.       off-topic advertisement messages (i.e. SPAM) being present in the 
  412.       newsgroups. This option is designed in an attempt to avoid these 
  413.       advertisements. Typically, advertisers will post their messages to a 
  414.       large number of newsgroups, and thus the XREF list for the article will 
  415.       have many entries. Newsbot can be set to filter messages with too many 
  416.       XREF's out. The default is set at 999 which effectively disables XREF 
  417.       filtering. You can enable XREF filtering by entering a lower number here 
  418.       (10 is a good place to start). 
  419.     * Preload XRef hdrs: By default, the "lockout XRef" and "Maximum XRef 
  420.       Limit" systems do not filter out an invalid message until the download 
  421.       has begun. This is because the XREF line is not transmitted until the 
  422.       message is sent. However, you can tell Newsbot to download all the XREF 
  423.       headers ahead of time, before any messages are downloaded. Thus, Newsbot 
  424.       will know the XRef information ahead of time and can avoid the unwanted 
  425.       messages entirely. However, XRef information is somewhat bulky, and does 
  426.       require a fair amount of time to download the headers. Thus, there is a 
  427.       trade-off involved. Feel free to experiment. 
  428.  
  429. Lockout Lists: 
  430.  
  431. The lockout lists are used to lock out messages that contain certain text 
  432. strings. For example, you may not wish to download messages written by a 
  433. certain person, or messages whose title contains a certain string. There are 
  434. several types of lockout lists supported: 
  435.  
  436.     * Lockout Poster (i.e. Author): Applies to the "From:" line of the nntp 
  437.       message. Use this if you wish not to receive messages from a specific 
  438.       person. 
  439.     * Lockout Subject: Applies to the "Subject:" line of the news message. This 
  440.       is useful if there are certain keywords which you want to lockout if they 
  441.       are present in the subject field. 
  442.     * Lockout FileName: Prevents specific filenames from being downloaded. You 
  443.       can type a specific filename or a wildcard specification to lockout a 
  444.       group of files. 
  445.     * Lockout Host: Checks the "NNTP-Posting-Host" field of the news message. 
  446.       This is useful to eliminate posts from a specific news server. Many 
  447.       obnoxious posters will alter their email name in the from field, making 
  448.       them impossible to lockout by normal means. However, the news server 
  449.       usually will put it's correct host name in the "NNTP-Posting-Host". Thus, 
  450.       this field may be used to weed out the obnoxious poster. However, be 
  451.       warned that locking out a NNTP-Posting-Host will lockout all users who 
  452.       post from that host! 
  453.     * Lockout XRef: Checks the "XRef " field of the news message. The XRef 
  454.       field contains a list of other newsgroups that the message is 
  455.       cross-posted in. Sometimes a person will post a message into several 
  456.       groups at once -- this is called crossposting. Sometimes an obnoxious 
  457.       poster will cross-post their messages into groups that they don't belong 
  458.       in. 
  459.  
  460. All lockout lists are case insensitive (i.e. capitalization does not matter). 
  461. All lockout lists support wildcard characters, * and ?. "*" is interpreted as 
  462. "any sequence of zero or more characters" and "?" is interpreted as "any single 
  463. character". Here are a few sample wildcard strings: 
  464.  
  465.     * (Lockout-Poster) "joe@fubar.com" would refuse any messages from 
  466.       joe@fubar.com 
  467.     * (Lockout-Poster) "*@foobar.com" would refuse messages from ANYONE at 
  468.       fubar.com 
  469.     * (Lockout-Poster) "joe@*" would refuse messages from "joe" no matter where 
  470.       he posts from 
  471.     * (Lockout-Filename) "*.zip" would refuse any file that had an extention of 
  472.       ZIP 
  473.     * (Lockout-Filename) "fastcash*.*" would refuse any file which had 
  474.       "fastcash" as the first 8 characters. 
  475.     * (Lockout-Filename) "index-?.jpg" would refuse any file which had 
  476.       "index-", exactly one more character, and then ".jpg" as an extention. 
  477.     * (Lockout-Host) "news.somehost.com" would refuse any messages posted on 
  478.       "news.somehost.com" 
  479.     * (Lockout-XRef) "alt.binaries.pictures.erotica" would refuse any messages 
  480.       that are cross-posted into "alt.binaries.pictures.erotica" 
  481.  
  482. The is an additional toggle which lets you toggle between an "exact match" and 
  483. "match any position in text". 
  484.  
  485.     * Exact-Match: The search pattern must match all of the text exactly; There 
  486.       can be no leading or trailing characters. For example, "abc" would not 
  487.       match "abcd" or "xabc". 
  488.     * Match-Any-Position: The search pattern can match any position in the 
  489.       text. There can be leading or trailing characters. For example, "abc" 
  490.       would match "abcd" and "xabc". 
  491.  
  492. There is a TEST button on the lockout dialog which will let you enter a string 
  493. and see if it matches anything. This is useful if your a little confused about 
  494. the wildcard strings and want to make sure what you entered does actually do 
  495. what you think it should. 
  496.  
  497. Note #1: The "NNTP-Posting-Host" and "XRef" lines of a message are not normally 
  498. displayed by SBNews, so you might be wondering where to get the information to 
  499. type into those lockout lists. If you notice a particularly annoying message, 
  500. you can use the Headersbutton to bring up a header listing for the group, then 
  501. use the Readbutton to display the full text of the annoying message. Inside the 
  502. read screen will be a header listing where you can find NNTP-Posting-Host and 
  503. XRef fields. 
  504.  
  505. Note #2: Some lockout settings, such as Lockout Poster and Lockout Subject can 
  506. be determined before the message is downloaded. Thus, Newsbot will bypass the 
  507. message completely. Others, such as Lockout File, Lockout Host, and Lockout 
  508. XRef, can not be determined until the message has begun to be received. Thus, 
  509. Newsbot must start receiving the message and then abort the message while the 
  510. download is in progress. 
  511.  
  512. Authentication: 
  513.  
  514. The authentication options are used for news servers which require a user name 
  515. and password to access the newsgroups. If your news server does not require a 
  516. name and password, then you should leave this option alone. Authentication is 
  517. located under the Configure menu. 
  518.  
  519. Acceptable File Masks: 
  520.  
  521. Newsbot allows you to specify which types of files will be downloaded. 
  522. Specifying "*.*" will enable any file to be downloaded, and this is the 
  523. default. For example, if you only wanted to receive images, then you may wish 
  524. to remove *.* and add in *.gif and *.jpg. If you only wanted archives, add in 
  525. *.zip. etc. 
  526.  
  527. Dupe Checking: 
  528.  
  529. Two different types of dupe checking are supported. They may be used 
  530. independantly, or you can use both of them at the same time if you wish. By 
  531. default, the dupe checkers maintain a list of approximately the most recent 
  532. 2048 messages received. 
  533.  
  534.     * Subject Dupe Checker: Remembers duplicates by keeping track of the 
  535.       subject of the message. Normally, the Dupe-Subject checker should be used 
  536.       with the "Consider 'From'" setting checked as enabled. Thus, if the same 
  537.       person posts multiple messages with the same subject, the message will be 
  538.       flagged as a dupe. This is useful for preventing download of crossposted 
  539.       messages (i.e. identical messages posted in multiple groups) 
  540.     * Filename Dupe Checker: Remembers duplicates by keeping track of the names 
  541.       of the files that were downloaded. This is very effective at weeding out 
  542.       dupes, but has the side effect of sometimes deleting messages that are 
  543.       not really duplicates. For example, there are a lot of files name "1.JPG" 
  544.       out there! 
  545.  
  546. Both of the two above mentioned dupe checkers have some options that control 
  547. their behaviour: 
  548.  
  549.     * Reject Duplicates: If checked, then dupe checking will be performed as 
  550.       stated above. If not checked, then no dupe checking will be performed. 
  551.     * Save dupe list: If checked, then dupe information will be saved from 
  552.       session to session. If not checked, then dupe information will only be 
  553.       kept for the current session. 
  554.     * Items to Keep: This is the number of items to "remember" for the dupe 
  555.       checker. A bigger number here will remember more messages (or files), but 
  556.       will also require more memory and/or disk space to hold to dupe checker 
  557.       information. 
  558.     * Consider "From": If enabled, requires the from fields of two messages to 
  559.       be identical for the files to be considered duplicates. A good idea for 
  560.       the dupe subject checker, but probably not advisable for the dupe file 
  561.       checker. 
  562.     * Consider "Lines": If enabled, requires the number of lines of two 
  563.       messages to be within a 10% tolerance for the messages to be considered 
  564.       duplicates. For multi-part files, only the first message is considered. 
  565.  
  566. AutoSave: 
  567.  
  568. Automatic save is used to automatically save the current state of Newsbot 
  569. periodically during operation. This is useful since if Newsbot crashes, Newsbot 
  570. will be able to start back up at the correct position in the newsgroups and 
  571. with all of your dupe checking and lockout information enabled. There are two 
  572. types of autosave: 
  573.  
  574.     * AutoSave Pointers: Saves message pointers. These pointers tell newsbot 
  575.       your current position in the newsgroups, i.e. how many messages you have 
  576.       already seen in each groups. 
  577.     * AutoSave Everything: This saves all state information, including the dupe 
  578.       checkers (assuming the dupe checkers have saving enabled), HTTP grabber, 
  579.       lockout lists, messages pointers, etc. 
  580.  
  581. Auto-Encryption: 
  582.  
  583. Auto-Encryption is intended to keep files that you download "private". This is 
  584. primarily in case you are downloading sensitive information that you don't want 
  585. unauthorized people to be able to access. If Auto-Encryption is enabled, then 
  586. files will be encrypted with a key that you specify. Only those persons who 
  587. have this key will be able to retrieve the information in these files. 
  588.  
  589. Note #1: Be careful when you pick an encryption key. If you forget what you 
  590. picked, then there is no way to "find out" what it was. Case is important, so 
  591. make sure you know what parts (if any) are capitolized. Longer encryption keys 
  592. do offer better protection. However, my algorithm is by no means perfect, and 
  593. someone with enough time and computing power could undoubtably crack the code. 
  594.  
  595. Note #2: Encrypted files cannot be "read" by another other programs until they 
  596. are decrpyted in some manner! No other program except Newsbot and it's 
  597. associated utilities can deal with files encrypted in this manner. 
  598.  
  599. There are two ways to retrieve (or "decrypt") encrypted files: 
  600.  
  601.     * With the built-in jpeg viewer. The built in jpeg viewer will 
  602.       automatically detect encrypted files and prompt you for the decryption 
  603.       key if necessary. 
  604.     * With decrypt.exe. Decrypt.exe (and for that matter, Encrypt.exe) are 
  605.       standalone utilities that you can use to encrypt and/or decrypt a series 
  606.       of files. Once decrypted with decrypt.exe, a file may be read by any 
  607.       other program. To decrypt files, use a command line similar to the 
  608.       following: 
  609.  
  610.                        decrypt key filename.ext 
  611.  
  612.       Where "key" is the decrpytion key and "filename.ext" is the filename that 
  613.       you want decrypted. You may use wildcards in the filename and decrypt.exe 
  614.       will decryypt all files matching the specification. Decrypt.exe will not 
  615.       "mess up" unencrypted files, nor will it improperly decrypt a file if an 
  616.       improper key is supplied. 
  617.  
  618.       Decrypt.exe and Encrypt.exe have some additional options. Run the program 
  619.       without any command line parameters to get a list of applicable options. 
  620.  
  621. FILES.BBS Generation 
  622.  
  623. FILES.BBS files are used by bulletin board systems to catalog files in download 
  624. directories. If you're the sysop of a bbs, then you may find the automatic 
  625. FILES.BBS generation useful. Otherwise, it probably won't be of much interest 
  626. to you. 
  627.  
  628. Newsbot can create a variety of different FILES.BBS styles; You may select 
  629. whichever one works best with your bbs. If none of them do, then you can 
  630. probably find a conversion or import program for your bbs software which will 
  631. do the trick. The various styles are listed in the listbox. Selecting "none" 
  632. will disable files.bbs generation. 
  633.  
  634. By default, Newsbot will generate a FILES.BBS file in each directory that files 
  635. are downloaded into. The FILES.BBS file will be "appended", not "overwritten". 
  636. You may specify an alternate filename if you wish. If you include a 
  637. drive/directory in the filename, then all groups will be listed in one big 
  638. file. 
  639.  
  640. The "Convert to 8.3" option will put standard DOS 8.3 (filename.ext) filenames 
  641. in the FILES.BBS rather than the Windows-95 long filenames. For example, 
  642. "longname.jpg" would be entered as "longna~1.jpg". This may be useful for bbs 
  643. programs which do not understand long filenames. 
  644. -------------------------------------------------------------------------------
  645.  
  646. Statistical Options 
  647.  
  648. There are a variety of options listed under the statistics menu item. Most of 
  649. these simply return information that SBNews has collected while processing 
  650. newsgroups. 
  651.  
  652.     * Similar NewsGroups: Newsgroup headers contain an "Xref:" line which lists 
  653.       other newsgroups to which a specific article has been posted. Many times, 
  654.       a poster will "cross-post" an article to multiple groups which share the 
  655.       same interests. The Similar Newsgroups list will display all of the 
  656.       accumulated Xref's for the current area. 
  657.     * HTTP Grabber: The HTTP Grabber automatically keeps a list of any WWW 
  658.       addresses that are found in the text and/or subject lines of downloaded 
  659.       messages. In addition, a HTML file called HTTPGRAB.HTM will be written to 
  660.       the newsbot directory. You may load this file with your WWW browser and 
  661.       look up any references that SBNews found. 
  662.     * Dupe File List: The list that the dupe-checker keeps in memory to catch 
  663.       dupe files. 
  664.     * Dupe Subject List: The list that the dupe-checker keeps in memory to 
  665.       catch duplicate subject lines. 
  666.     * Latency: A measurement of how long it takes your news server to respond 
  667.       to a command message. Times listed are in milliseconds (1 second = 1000 
  668.       milliseconds). Slower or highly-used servers will have greater latency 
  669.       times, whereas faster servers will have low latency times. If you are 
  670.       using other Internet applications at the same time as NewsBot, then the 
  671.       latency figure may rise. 
  672. -------------------------------------------------------------------------------
  673.  
  674. Coord: The Newsbot Coordinator 
  675.  
  676. Coord.Exe (only available in 32-bit version) may be used to synchronize the 
  677. dupe-checking capabilities of multiple news robots. Running multiple Newsbots 
  678. at the same time may allow you to better utilize some of the slower news 
  679. servers out there. To do this, you must run COORD.EXE before loading any 
  680. instances of Newsbot. 
  681.  
  682. Some notes about using Coord: 
  683.  
  684.     * Coord should be considered EXTREMELY BETA. It seems to be working for 
  685.       most of our testers, but there hasn't been time to conduct widespread 
  686.       testing at this time. 
  687.     * Make sure you run it before loading any newsbots. 
  688.     * Coord is used to run multiple newsbots at a time -- if you only want to 
  689.       run one newsbot, then don't bother with it! 
  690.     * Coord has it's own preferences for the dupe checkers -- you might want to 
  691.       be sure to set them to what you want. 
  692.     * Dupe Checking Statistics in Newsbot will be unavailable while running 
  693.       coord (use coord's dupe statistics instead) 
  694. -------------------------------------------------------------------------------
  695.  
  696. Acknowledgements 
  697.  
  698. I would like to thank the following people for their help, support, or 
  699. contributions to SBNews/Newsbot: 
  700.  
  701.     * The many people who've helped me beta-test! 
  702.     * The Independent JPEG Group 
  703.     * The ISO Jpeg Standards Committee 
  704.     * Brian Kantor & Phil Lapsley (RFC977) 
  705.     * S. Barber (NNTP Extensions document) 
  706.     * The Papa winsock site 
  707.     * The Tucows winsock site 
  708.     * Lars Magne Ingebrigtsen, "Notes on News" 
  709. -------------------------------------------------------------------------------
  710.  
  711. Registration 
  712.  
  713. SBNews/Newsbot is a shareware program and as such, you are only granted the 
  714. right to operate it for a limited time to evaluate it's performance. Continued 
  715. usage requires registration in the amount of $19.95. 
  716.  
  717. Registration may be performed online at 
  718. http://www.newsrobot.com/credit/credit.html
  719.  
  720. For information on registration, please see REGISTER.DOC (or REGISTER.HTM). 
  721. -------------------------------------------------------------------------------
  722.  
  723. Contacting Me 
  724.  
  725. US-Mail: 
  726.  
  727. Scott M. Baker
  728. 2241 W Labriego 
  729. Tucson, Az 85741
  730. United States of America 
  731.  
  732. Email: 
  733.  
  734. smbaker@sb-software.com
  735. smbaker@primenet.com
  736.  
  737. My Homepage: 
  738.  
  739. http://www.newsrobot.com Primary site for SBNews: News Robot
  740. http://www.sb-software.com Generic site for all of my 'SB' products
  741.  
  742. Find the latest SBNews/Newsbot at this address: 
  743.  
  744. http://www.newsrobot.com/sbnews/sbnews.html
  745.  
  746. Find the latest SBJV at this address: 
  747.  
  748. http://www.newsrobot.com/sbjv/sbjv.html
  749. -------------------------------------------------------------------------------
  750.  
  751. Revision History 
  752.  
  753.     * Version 1.0 
  754.           * Initial public release 
  755.     * Version 1.1 
  756.           * Added about dialog and shareware delay 
  757.           * Cleaned up (shrunk) main screen and reorganized information 
  758.           * Added context-sensitive hint text at bottom 
  759.           * Fixed problem with message pointers not being recorded properly 
  760.     * Version 1.2 
  761.           * Added JPG viewer window (supported in 800x600 or above only) 
  762.           * Probably fixed a nasty stack overflow (Runtime Error 202) bug that 
  763.             was causing trouble with new users. 
  764.     * Version 1.3 
  765.           * Made JPEG viewer more crash resistant 
  766.           * Increased JPEG viewer read buffer to deal better with images with 
  767.             large headers 
  768.           * Added a title to the main window 
  769.           * Finished registration code system 
  770.     * Version 1.4 
  771.           * Added icon 
  772.     * Version 1.5 
  773.           * Made sure to free gensock.dll on exit 
  774.           * Added Configure:Preferences dialog, many new preference options 
  775.     * Version 1.6 
  776.           * Raised counter-over threshold from 250 to 1000 
  777.           * Set update timer at 100ms instead of 250ms 
  778.           * Added Lockout Poster system 
  779.           * Revamped dupe checker for better reliability 
  780.           * Added similar newsgroups list 
  781.           * Raised maximum number of newsgroups from 32 to 128 
  782.           * Added view and delete options to current and previous menus 
  783.           * Fixed problem with crashes on high-ascii characters in lockout 
  784.             poster list 
  785.           * Fixed possible bug with long header lines 
  786.           * Now handles nonexistant newsgroups without halting 
  787.     * Version 1.7 
  788.           * Shareware delay now increments by 1 every day Newsbot is used 
  789.           * Newsbot now stops loading groups from INI file when first blank 
  790.             entry is found (speedup?) 
  791.           * Revamped the dupe message checker (again!) 
  792.           * Fixed bug which was causing unnecessary JPEG error 117 
  793.           * Fixed problem with decoding lines that started with a double period 
  794.     * Version 1.8 
  795.           * Added message when old BWCC found 
  796.     * Version 1.9 
  797.           * Change "about" menu to "file" menu 
  798.           * Added open jpeg viewer option to file menu 
  799.           * Prevented crash if 0 messages in a group 
  800.           * Added HTTP URL Grabber 
  801.           * Fixed problem with long subject/from lines (i.e. >256 chars) 
  802.           * Double clicking on the log will bring up a viewer 
  803.           * Made sure files are written to proper directory 
  804.           * All uudecode filenames are normalized to lower case 
  805.           * Added dupe file checker 
  806.           * Revamped dupe subject checker (again!) 
  807.     * Version 2.0 
  808.           * Added authentication support (AUTHINFO Original) 
  809.           * Ability to deal with SOME mime messages 
  810.           * Added acceptable file mask dialog 
  811.           * 32-bit version available 
  812.           * Incorporated gensock code into SBNews; Gensock.DLL no longer 
  813.             needed. 
  814.           * Fixed memory leak in jpeg viewer 
  815.           * Used suballocater to deal with strman hash table nodes 
  816.           * Added "add" and "refresh" options to similar groups dialog 
  817.     * Version 2.1 
  818.           * Spiffed up Jpeg viewer window 
  819.           * Fixed up error handling on JPEG decoding routines 
  820.           * Fixed possible error with "Null" strings 
  821.     * Version 2.2 
  822.           * Fixed problems with palette in 256 color mode 
  823.           * More tolerant of uuencoded lines with extra characters 
  824.           * Made small version of window even smaller 
  825.           * Dupe File, Delete Current, and No Mask signals will now 
  826.             disconnect/reconnect the session to keep from having to download 
  827.             entire message. 
  828.           * Several user-friendliness improvements 
  829.           * Included SAMPLE_G.TXT, a list of binary picture newsgroups 
  830.           * Added "-i [INIFILENAME]" command line parameter 
  831.           * Added Save as BMP option to JPEG viewer 
  832.           * Added Set Wallpaper option to JPEG viewer 
  833.           * Added normal vs Wallpaper mode toggle to JPEG viewer slideshow 
  834.           * If you drag & drop a JPG file into newsbot's main window, then 
  835.             Newsbot will launch a Jpeg viewer window to view the file. 
  836.           * Moved dupe checker preferences to their own menu item 
  837.           * Added "Items to keep" settings for dupe checkers 
  838.           * Fixed major distribution problem in hash function 
  839.           * Added Blank option to Current/Previous menus to blank out the 
  840.             current picture 
  841.           * Viewer enable defaulted to active 
  842.           * Fixed problem with long pathnames in jpeg viewer 
  843.           * Fallback when improper BWCC.DLL loaded 
  844.     * Version 2.3 
  845.           * Fixed GPF on loadup of nonregistered users 
  846.     * Version 2.4 
  847.           * Fixed problem with invalid (missing?) dates causing GPF 
  848.           * Made mime filename guesser stop at punctuation (except _ -) 
  849.           * Added color options to Jpeg viewer 
  850.           * Automatic restart after communications errors 
  851.           * Added automatic start command line option -auto 
  852.           * Added about box disable command line option -noabout 
  853.           * Fixed possible GDI leak in small viewer windows 
  854.           * Added wildcard (* and ?) support to lockout poster list 
  855.           * Cached hostname/ip address for reconnect 
  856.           * Added table of contents to documentation 
  857.           * Included seperate register.htm / register.doc 
  858.           * Automatic disconnect when all groups finished 
  859.           * Added Exit menu item to file menu 
  860.     * Version 2.5 
  861.           * Fixed GPF when lockout poster list empty 
  862.     * Version 3.0 
  863.           * Major redisign of internal header listing 
  864.                 * Use linked list instead of array 
  865.                 * Use hash table while downloading rather than linear search 
  866.                 * Modification to header sort methods 
  867.                 * Store from & subject in hash table 
  868.                 * MSGID only stored for duration of current message; Needed to 
  869.                   save wasted memory. 
  870.           * Major redesign of dupe checker routines 
  871.                 * Store from & subject lines in same hash table as header 
  872.                   listing to reduce memory requirements. 
  873.                 * Allow FROM and LINES fields to be included in comparison. 
  874.                 * FROM and LINES fields remembered and saved to disk 
  875.           * Addition of [Headers] button to group list: Manually configure 
  876.             header table 
  877.           * Added Received File statistics to statistics menu 
  878.           * Added Font configuration to config menu 
  879.           * Added help text for menu options 
  880.           * Added FROM and LINES toggles to dupe file checker 
  881.           * Added LINES toggle to dupe subject checker; Made FROM toggle-able 
  882.           * Revamped re search engine to support more than 4000 re nodes. 
  883.           * Added Lockout-Subject and Lockout-Filename 
  884.           * Made lockouts so they can be restricted to specific groups 
  885.           * Revamped dupe checker dialog to include edit and find/findnext 
  886.             features 
  887.           * Added stateset system to RE checker to improve speed in RE 
  888.             matchings 
  889.           * Log files now include date in filename to make deleting old logs 
  890.             easier 
  891.           * Delete old logs option added; Defaulted to on; gets rid of previous 
  892.             day(s) log files. 
  893.           * Added delete button to jpeg viewer to speed up deleting. 
  894.           * Added horizontal scrollbars to main dialog list boxes 
  895.           * Added autosave configuration 
  896.           * Added Save Preferences command 
  897.           * Rewrote ctime function to tolerate bad dates 
  898.           * Added Auto-Encryption to downloader 
  899.           * Added Auto-Decryption to viewer 
  900.           * Added Encrypt.exe and Decrypt.exe 
  901.           * Added additional file formats to fullscreen jpeg viewer 
  902.     * Version 3.1 
  903.           * Bug Fix: Major problem with Jump-To button 
  904.           * Bug Fix: Re-statesets (i.e. Lockout system) had a bogus quicksort. 
  905.             Fix should run faster & use less memory. 
  906.           * Jpeg Viewer: Added scaledown capability to TGA/BMP formats 
  907.           * Jpeg Viewer: Index window 
  908.           * Jpeg Viewer: Added stretch-to-fit option 
  909.           * Set maximum headers per group to 8000 
  910.           * Fixed infinite loop on nonexistant newsgroups 
  911.           * Fixed crash in ctime with bad dates 
  912.           * Fixed bug with shareware delay not working (Arrgghhh!) 
  913.           * Fixed gif/bmp/tga support crashing big viewer in 256-color mode 
  914.     * Version 3.2 
  915.           * Fixed thumbnail viewers not working properly in 256-color mode 
  916.     * Version 3.3 
  917.           * Fixed scrollbars in full screen jpeg viewer 
  918.           * Increased maximum number of newsgroups from 128 to 512 
  919.           * Made "Path Expansion" a seperate menu option 
  920.           * Added "full name" path expansion for win-95 users 
  921.           * Added Path Prefix elimination to path expansion options 
  922.           * Added READ and LOCKOUT buttons to header list 
  923.           * Better mime filename guessing 
  924.           * Auto append .JPG or .GIF to mime images if extention missing 
  925.           * Fixed uudecode filename routines to handle quoted strings 
  926.           * Re-aligned log listbox in large screen version 
  927.           * Added categorization system to jpeg viewer 
  928.           * Toggles for categorization and directory panes 
  929.           * Added horizontal scrollbars to header listing 
  930.           * 32-bit version: Changed header listbot to a ListView control 
  931.           * Added lines field to header listing 
  932.           * Fixed problem with jview colormodes not being saved properly 
  933.           * Fixed memory leak in re stateset routines (eg lockout system) 
  934.           * Minor speedup to re search routines 
  935.           * Enabled current/previous viewers in 16-bit version 
  936.           * Truncated subdirectory names to 8 chars in 16-bit version 
  937.           * Added confirmation options to JPeg viewer 
  938.           * JView file list reflects deleted files 
  939.           * Added tabbed windows-95 main dialog option 
  940.           * Added Configuration:Appearance option to set main dialog style 
  941.           * Replaced line count by progress bar in 32-bit version 
  942.           * Fixed GPF when "%" character in header 
  943.           * Added Latency/Throughput statistics 
  944.     * Version 3.4 
  945.           * Fixed problem of .DOC file not being updated in previous release 
  946.           * Added Menu to header dialog 
  947.           * Added selection functions to header dialog menu 
  948.           * Possible fix for Coord problems under NT 4.0 (maybe 3.5 too!) 
  949.           * Turned on 32-bit packing in 32-bit versions 
  950.           * Fixed abort problem in unregistered about dialog 
  951.           * Added 5-minute timeout to NNTP routines 
  952.           * Fixed message reader so it can handle passworded sessions 
  953.           * Added stretch to min(Window,Fullsize) option to jpeg viewer 
  954.           * Added center option to jpeg viewer 
  955.           * Made Jpeg picture viewer background gray 
  956.           * Eliminated flicker when resizing JPeg viewer 
  957.           * Spiffed up appearance of Jpeg and Index windows with gray 
  958.             background 
  959.           * Eliminated auto-generation of header log 
  960.           * Added save header log option to header dialog 
  961.           * Added file marking options to jpeg viewer 
  962.           * Added "only display marked files" option to slideshow 
  963.           * Made move and delete handle marked batches of files 
  964.           * Moved several of newsbots error messages to the resource file 
  965.           * Allow 224 in place of 221; Fix for microsoft nntp server 
  966.           * Send "mode reader" in response to a 200 or 201 message (only send 
  967.             once!) 
  968.           * Msg reader now has a window for header lines to be displayed 
  969.           * Added Pointers button to let user change message pointer 
  970.     * Version 3.5 
  971.           * Fixed the "fix" I put in for "mode reader" in version 3.4 
  972.     * Version 3.6 
  973.           * Fixed problem with jpeg viewer delete button causing crash 
  974.           * Added "-autoexit" command line option 
  975.           * Added lockout host and lockout xref menu options 
  976.           * Made Strman's Enumerate function not recalculate list if no changes 
  977.           * Added too many xref limit to miscpref 
  978.           * Added preload xref to miscpref 
  979.           * Added Next and Previous menu items to Jpeg viewer menu 
  980.           * Added keyboard shortcuts for next and previous items in Jpeg viewer 
  981.           * Fixed tabbing problems in jpeg viewer somewhat 
  982.           * Mouse click+drag can be used to scroll images in hpeg viewer 
  983.           * Fixed JPeg viewer categorization pane getting messed up when window 
  984.             resize 
  985.           * Improved GrayStatic control; Eliminated unneccessary repaint of 
  986.             full control 
  987.           * Fixed wrong date being written to files.bbs file 
  988.     * Version 4.0 
  989.           * Added automatic lookahead to Jpeg viewer 
  990.           * Maybe fixed a memory leak while viewing GIF/BMP files 
  991.           * Newsbot will now load minimized if set by shortcut, etc. 
  992.           * A port number may now be specified in the nntp host name (i.e. 
  993.             news.foo.com:119) 
  994.           * Set literal strings in code segment option in 16-bit version (save 
  995.             dseg space) 
  996.           * Added print command to jpeg viewer 
  997.           * Added generate catalogs command to jpeg viewer 
  998.           * Added context sensitive help to several dialog boxes 
  999.           * Fixed minor tab-order problem in main window 
  1000.           * Added splitter to Jpeg Window to allow resizing of file/dir pane 
  1001.           * Added horizontal scrollbars to Jpeg Window file/dir pane 
  1002.           * Raised maximum number of Jpeg categories to 75 
  1003.           * Categorization pane will automatically go multi-column if necessary 
  1004.           * Added temporary checkbox to lockout list edit 
  1005.           * Stretched thumbnails to fill entire thumbnail window 
  1006.           * Centered thumbnails 
  1007.           * Fixed problem with large jpeg's not being displayed in thumbnail 
  1008.             viewer 
  1009.           * Fixed keyboard navigation in header window 
  1010.           * Header download now shows on progress bar 
  1011.           * Fixed protection violation when blank space is first character on 
  1012.             line 
  1013.     * Version 4.1 
  1014.           * May have fixed problem with 'Lockout Posting Host' causing crashes 
  1015.           * Reduced memory requirements of 'Preload XRef Headers' 
  1016.           * Fixed goof-up if path prefix removal removes entire group name 
  1017.           * Added 'Lockout Any Header' 
  1018.           * Added 'Lockout Organization' 
  1019.           * Added -autocat command line switch 
  1020.           * Added 'Default Command Line Switch' settings to configure menu 
  1021.           * Added 'Catalog All Groups' command to file menu 
  1022.           * Added timeout settings to configuration menu 
  1023.           * Changed JView path storage to use a variable rather than system 
  1024.             wide cwd so one JView window won't interfere with another's path 
  1025.           * JView windows opened on a specific filename will now automatically 
  1026.             switch to that directory 
  1027.           * Spiffed up jpeg viewer File:Open dialog 
  1028.           * Fixed help file problem if program not loaded from directory with 
  1029.             help file 
  1030.     * Version 4.2 
  1031.           * Fixed problem with lockout-any causing GPF on long header lines 
  1032.           * Added confirm delete toggle to Configure:Preferences dialog 
  1033.           * Added hotkeys for "Current" menu 
  1034.           * Added delete indicator to thumbnail preview 
  1035.           * Fixed problems with 16-bit version not working in Windows-3.1 
  1036.           * Spiffed up overwrite messagebox in jpeg viewer 
  1037.     * Version 4.3 
  1038.           * Added join directory command to jpeg viewer 
  1039.           * Jpeg viewer can now load bitmaps with less than 256 colors 
  1040.           * Raised Re-Stateset stack size from 2048 elements to 4096 elements 
  1041.           * Added "require file mask in subject" toggle to acceptable file 
  1042.             masks 
  1043.           * Fixed problem in RE search engine that had to do with high-ascii 
  1044.             characters 
  1045.           * Credit card registration now supported on web site 
  1046.             http://www.newsrobot.com/ 
  1047.           * Web site moved from Primenet to Simplenet 
  1048.           * Added additional information to jpeg viewer overwrite messagebox 
  1049.           * Fixed problem with "Maintain NewsRc" switch not working properly 
  1050.           * Fixed bug with "Preload XRef Headers" missing the first newsgroup 
  1051.             in each xref 
  1052.           * Improved subject line filename guesser 
  1053.           * Eliminated mime header information from status display 
  1054.     * Version 4.4 
  1055.           * May have fixed bug in files.bbs support if date not available. 
  1056.           * Fixed padding in catalog generation (wasn't doing anything) 
  1057.           * Added padding=4 to catalog generation 
  1058.           * Added quality setting to catalog generation 
  1059.           * Added additional error checking to blend name on generate catalogs 
  1060.             dialog 
  1061.           * Added voice registration nag 
  1062.           * Added promote group and demote group commands 
  1063.           * Added zoom command to jpeg viewer 
  1064.           * Fixed jpeg viewer zoom ratio changing as picture is panned/scrolled 
  1065.           * Fixed problem with "no mask in subject" not rejecting messages 
  1066.           * Switched from polling to async select on nntp data read. Should 
  1067.             improve performance. 
  1068.           * Used async winsock connect rather than blocking to reduce freezing 
  1069.             problem on bad connections. 
  1070.           * Added plugin support (see SBPLUGxx.ZIP for details) 
  1071.           * Added Decrpyt and Encrypt menu commands to jpeg viewer 
  1072.           * Fixed help in Win-3.1 version 
  1073.           * Image viewer support for .FTS/.FITS telescope image files 
  1074.           * Added option to force sending of authentication data at logon. 
  1075.             Default to True. 
  1076.           * Fixed bug with spaces not supported in download path 
  1077.     * Version 4.5 
  1078.           * Error checking on MSGID's longer than 256 chars 
  1079.           * Fixed incorrect winsock error messages being emitted 
  1080.           * Error checking on excessively long log lines 
  1081.           * Got rid of those "invalid mark xx" and "xx bytes before marker" 
  1082.             errors 
  1083.           * Reworked disconnect code to be a bit more forceful 
  1084.           * Added minimum free disk space check 
  1085.           * Added check for blank key enter in decryption dialog 
  1086.           * Don't automatically send auth name/pword unless user has enetered 
  1087.             one 
  1088.           * Hide password in authentication dialog 
  1089.           * Hide password in connection status log 
  1090.     * Version 4.6 
  1091.           * Fixed up autoscan hard drive to work with win95 long filenames 
  1092.           * Convert all filenames in dupe file list to lower case 
  1093.           * Added status info for autoscan hard drive 
  1094.           * Fixed bug with premature ending GIF files causing system crash 
  1095.           * Minor changes to socket code in hopes of dealing with some CPU 
  1096.             usage issues 
  1097.           * Switched to newer version of BC++ (5.0) 
  1098.           * Fixed problem with about box not going away if register on opening 
  1099.             screen 
  1100.           * Added button to reg screen to load browser with SBNews address 
  1101.           * Maybe fixed a problem with errors occurring while disconnecting 
  1102.           * Possibly fixed a problem with lockout-any and/or lockout-xref 
  1103.           * Updated copyright date to include 1997 
  1104.     * Version 4.7 
  1105.           * Fixed problem with header listview not sorting, adjusting column 
  1106.             width, etc. 
  1107.           * Fixed embarrassing typo on registration page 
  1108.     * Version 4.8 
  1109.           * Added shrink-to-taskbar command 
  1110.           * Fixed a long-unnoticed misspelling of "previous file incomplete" 
  1111.           * Jpeg Viewer - added more information to duplicate overwrite dialog 
  1112.           * Jpeg Viewer - treat .jpe and .jpeg files as .jpg files 
  1113.           * Fixed problem with Blank/Delete not updating thumbnails immediately 
  1114.           * Ugly workaround for the disappearing newsgroup list problem in 
  1115.             Win-95 tabbed mode 
  1116.           * Log and Status lists now only scroll if the last item is hilighted 
  1117.           * Increased number of items in Log and Status lists 
  1118.           * Jpeg Viewer - Added sort button to categorization list 
  1119.           * Added documentation commands to help menu 
  1120.           * Added registration nag to status line 
  1121.           * Worked on the 10036 error in Win-3.1 versions 
  1122.           * Jpeg Viewer - fixed print command 
  1123.           * Jpeg Viewer - fixed problem with really big and really small images 
  1124.             causing crashes 
  1125.           * Added hotkey for delete-previous (shift-Del) 
  1126.           * Added -autorestart command line switch 
  1127.           * Added NoSpam.Htm; Document on avoiding SPAM 
  1128.           * Added Top10Reg.Htm; Document on top 10 reasons to register 
  1129.     * Version 4.9 
  1130.           * Widened msgnum: and total-msgs: fields to handle 7-digit numbers 
  1131.           * Fixed catalog generator in 16-bit version 
  1132.           * Fixed problem with using the <Delete> button on groups before 
  1133.             current group 
  1134.           * Added randomize to jpeg window 
  1135.           * Fixed off behavior with authinfo confused messages 
  1136.           * Made thumbnail viewers recognize .jpe and .jpeg files 
  1137.           * Added graceful disconnect command 
  1138.           * Finally fixed the WSAECONNRESET problem with win3.1 version (I 
  1139.             Hope!) 
  1140.     * Version 5.0 
  1141.           * Disabled processing of CMYK jpegs as they were causing 
  1142.             unpredictable crashes 
  1143.           * Added delete incomplete toggle 
  1144.           * Defaulted "consider lines" in dupe file checker to off since it 
  1145.             confuses most people 
  1146.     * Version 5.1 
  1147.           * I accidentally made registration code case sensitive in 4.9; This 
  1148.             ought to fix it. 
  1149.           * Viewer: Made index window responsive to marks 
  1150.           * Added httpgrabber toggle to httpgrabber window since excessive 
  1151.             spamming has made it nearly useless 
  1152.           * Fixed case sensitivity on command line options 
  1153.           * Fixed crash with GIF files that were chopped short 
  1154.           * Robustized newsrc code 
  1155.           * Fixed problem with excessively long newsgroup names causing crash 
  1156.           * Fixed possible problem with GetWindowPos() API call 
  1157.           * Switched to multithread library 
  1158.           * Used _beginthread instead of CreateThread on jpeg viewer threads 
  1159.           * Fixed problem with possible double exit on autoexit command 
  1160.           * Added search specified to browse newsgroups dialog 
  1161.           * Fixed error message when cancel hit on restore-from-taskbar 
  1162.     * Version 5.2 
  1163.           * Added search keywords 
  1164.           * Added filenames to current: and previous: displays 
  1165.           * Plugin reject wasn't working; I fixed it 
  1166.           * Added lockout buttons next to kill buttons 
  1167.           * Added command to header list to not display locked out entries 
  1168.           * Fixed problem with minimum free disk space check not working in all 
  1169.             cases 
  1170.     * Version 5.3 
  1171.           * Fixed lockout subject and/or file causing GPFs 
  1172.           * Increased RE stack max size from 4096 to 16384 -- support for more 
  1173.             lockouts 
  1174.           * Increased maximum messages per group from 8000 to 32000 in 32-bit 
  1175.             version 
  1176.           * Added nntp-posting-host to message info dialog 
  1177.           * Added lockout posting host to lockout current/previous 
  1178.           * Removed paths of incoming files to prevent decoding initialization 
  1179.             error 
  1180.           * Made lockout current/previous refuse to display "null" 
  1181.           * Added "temporary" flag to lockout current/previous 
  1182.           * Added promote and demote buttons to jview categorization 
  1183.           * Fixed GPF when status message sent before main window open 
  1184.           * Fixed problem with dupe checker purges when items_to_keep set less 
  1185.             than or equal to 0 
  1186.     * Version 5.4 
  1187.           * Added preload posting host preference
  1188.           * Modernized lockout dialog in headers listing 
  1189.           * Got rid of box saying you can't delete a group when you only have 
  1190.             one group 
  1191.           * Added lockout button to received file listing 
  1192.           * Added right-click menus to current/previous images 
  1193.           * Added right-click menu to log listing 
  1194.           * Jpeg Viewer: Added Go-To Menu 
  1195.           * Jpeg Viewer: Added Move-To Menu 
  1196.           * Eliminated memory leak in browse dialog 
  1197.           * Fixed problem with lockout any causing trouble 
  1198.     * Version 5.5 
  1199.           * Updated FAQ to reflect Decode Initialization Errors in root 
  1200.             directory 
  1201.           * Updated download path dialog to reflect above 
  1202.           * Made encryption key fields auto-scroll 
  1203.           * Fixed a problem with unresponsiveness in the user interface 
  1204.           * Added timestamping to diagnostic log output 
  1205.           * Added checkbox to about dialog to disable it (registered users!) 
  1206.           * Added escape character to lockout strings 
  1207.           * Detailed help on lockout wildcards 
  1208.           * 32-bit version includes InstallShield setup program 
  1209.           * Fixed problem with "match any position" in lockout:filename 
  1210.           * Fixed lockout button locking out wrong picture in Tabbed view 
  1211.           * Added note for diagnostic log enable on startup 
  1212.     * Version 5.6 
  1213.           * Fixed install program for 32-bit Win-95 installation (OCX errors) 
  1214.     * Version 5.7 
  1215.           * Fixed "jump-to" on the first newsgroup in the list. 
  1216.           * Minor revisions to close socket code 
  1217.     * Version 5.8 
  1218.           * Added Refresh button to browse dialog 
  1219.           * Raised registration fee from $15.00 to $19.95 
  1220.           * Added date field to win95 header listing 
  1221.           * Added color settings for date & lines fields to color prefs 
  1222.     * Version 5.9 
  1223.           * Emergency release to handle bug with newsrc download causing crash 
  1224.     * Version 6.0 
  1225.           * Usually, I only update the major revision number (i.e. left hand 
  1226.             digit in the version) for major changes, but we ran out of 
  1227.             right-hand digits!
  1228.           * New website for SB-Software: www.sb-software.com
  1229.           * Added max consecutive disconnect option to Config:Preferences 
  1230.           * viewer: Added refresh button 
  1231.           * viewer: Added "order by" submenu 
  1232.           * viewer: Added "titles above" checkbox to catlog generation dialog 
  1233.           * Fixed a few viewer crash problems 
  1234.           * Added command line option -minimize to cause SBNews to be minimized 
  1235.             on startup 
  1236.     * Version 6.1 
  1237.           * Robustized bmp viewer 
  1238.           * Fixed support for encrypted hmp and gif 
  1239.           * Raised default max-consec-disconnect to 100 
  1240.     * Version 6.2
  1241.           * Fixed improper colors in some dialogs under win98 
  1242.           * Made fields in pointers dialog wider 
  1243.           * Added boss key 
  1244.           * Added -autoshrink command line option 
  1245.           * Fixed problem with header list accept/reject not working properly 
  1246.     * Version 6.3
  1247.           * Fixed problem with encrypt/decrypt commands causing crash 
  1248.           * Fixed kernel32 crash when system date excessively out-of-bounds 
  1249.           * Added novice instructions 
  1250.           * Speeded up browse dialog refresh time 
  1251.           * Added count fields to browse dialog (for debugging -- no real 
  1252.             practical purpose) 
  1253.           * Added update button to browse dialog and stopped automatic update 
  1254.             when search spec changed 
  1255.     * Version 6.4
  1256.           * Added sort newsgroups command 
  1257.           * Fixed .jpeg and .jpe files not being displayed in thumbnails 
  1258.           * Added rename command to viewer 
  1259.           * Added delete to recycle bin command to viewer 
  1260.           * Fixed delete group and reconnect GPF 
  1261.           * Added info on newsrc to FAQ 
  1262.     * Version 6.5
  1263.           * Fixed newsrc problem in 16-bit version 
  1264.           * Modifications to registration system 
  1265.           * Misc cosmetic fixes 
  1266.       Version 7.0
  1267.           * Major rework of header download system 
  1268.           * More robust 
  1269.           * Support XOVER as a fallback if XHDR fails 
  1270.           * Toggle in Config:MiscPref to use XOVER as default 
  1271.           * Fix problems with "socket closed by server" 
  1272.           * Auto-reconnect on closed socket 
  1273.           * Should now work reliably w/ demonews.mindspring.com 
  1274.           * Reorganization of config pull-down menu 
  1275.           * Split miscpref/limits 
  1276.           * Added force-numeric-order option to Configure:Preferences 
  1277.           * Modified newsrc stuff 
  1278.     * Version 7.1
  1279.           * Fixed problems with shrink-to-taskbar accepting keys after cancel 
  1280.           * Fixes to files.bbs system 
  1281.           * Better error recovery on 500 errors 
  1282.           * In particular, error "501 Header not in index" will recover 
  1283.             correctly 
  1284.           * Added menu option to enable previous/next viewers 
  1285.           * Added delay for cable modem users 
  1286.     * Version 7.2
  1287.           * Raised max newsgroups in 32bit version to 2048 
  1288.           * Fixed low message pointer when using graceful exit 
  1289.           * Modifications to encryption package 
  1290.           * Added more info to decode init fail error 
  1291.           * Y2K compliancy -- fixed problem with NEWGROUPS command 
  1292.           * Fixed possible buffer overrun in LockedOut_XRef 
  1293.           * Added buffer overrun check to TNews::RejMessage 
  1294.           * Added extra buffer room in StoreHeaderXRef 
  1295.     * Version 7.3
  1296.           * Fix crash when viewing very small files (1x1, 0x0, etc) 
  1297.           * Added additional asserts to TNewsIo::ArticleReady, AskForMessage, 
  1298.             and NextMessage 
  1299.           * Guarded possible overflow in copy of MsgId in TNewsIo::ArticleReady 
  1300.           * Fix excessive memory use in lockout tests by freeing the statesets 
  1301.             in an re-matcher if more than 2048 exist. 
  1302.           * Fix possible buffer overrun in jpeg error routines 
  1303.           * Raise state stack limit from 16K to 64K 
  1304.     * Version 7.4
  1305.           * Corrected spelling mistakes 
  1306.           * Minor redesign of large GUI -- eliminated groupboxes to make more 
  1307.             room in listboxes 
  1308.           * Removed two status messages: "-- unexpected close" and "-- socket 
  1309.             closed by server". They were redundant and used up status window 
  1310.             space 
  1311.  
  1312.