Home » Archimedes archive » Acorn User » AU 1997-04 B.adf » PD » PDScheme/Newshound/NewsHound/Docs/ConfigFile
PDScheme/Newshound/NewsHound/Docs/ConfigFile
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
Tape/disk: | Home » Archimedes archive » Acorn User » AU 1997-04 B.adf » PD |
Filename: | PDScheme/Newshound/NewsHound/Docs/ConfigFile |
Read OK: | ✔ |
File size: | 0791 bytes |
Load address: | 0000 |
Exec address: | 0000 |
File contents
Other details ~~~~~~~~~~~~~ The files in !NewsHound.Config have the following purpose: i) Config This is the global configuration file, and contains the nickname (the 3 letters preceding 'Group' from genGroup) of the default newsserver. It also includes the time that message id's are held in the Id History. This is to stop duplicate messages been downloaded - a value around 14 days is normally okay, although slightly longer is better. The number of times to retry, and the delay inbetween them, should the server be busy, is also specified in here. ii) xxxGroup This is the file that contains all the data about the 'xxx' newserver, like its hostname name, and all the newsgroups that are fetched from it. Normally, you don't need to manually edit this - it's all done from newsbase. If you have access to more than one newsserver, you can create more of these files, and can select the news servers from the 'Start Fetch' menu in newshound. iii) GlobalRule This contains a list of statements that allow NewsHound to decide whether to completely ignore an article, download only the header, or download the whole article. This file can be editted manually - do not remove the lines beginning with $'s. It is also modified by the addgroup program. You can use this file to automatically select interesting articles out of groups that are downloaded header only. For example, if I wanted to download all the articles by 'John' in csa.misc, I'd add a line like this: comp.sys.acorn.misc * *John* * * art [group name subject From Bytes Lines Amount] just after the '$ exceptions:' line in !NewsHound.Config.GlobalRule. You can also adjust the maximum size of article that is fetched complete, by changing the line after '$ max articlesize'. Any articles that are bigger than this (100k by default) will only have their headers downloaded, unless you specify otherwise.
00000000 4f 74 68 65 72 20 64 65 74 61 69 6c 73 0a 7e 7e |Other details.~~| 00000010 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 68 65 |~~~~~~~~~~~..The| 00000020 20 66 69 6c 65 73 20 69 6e 20 21 4e 65 77 73 48 | files in !NewsH| 00000030 6f 75 6e 64 2e 43 6f 6e 66 69 67 20 68 61 76 65 |ound.Config have| 00000040 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 | the following p| 00000050 75 72 70 6f 73 65 3a 0a 0a 69 29 20 43 6f 6e 66 |urpose:..i) Conf| 00000060 69 67 0a 0a 20 20 54 68 69 73 20 69 73 20 74 68 |ig.. This is th| 00000070 65 20 67 6c 6f 62 61 6c 20 63 6f 6e 66 69 67 75 |e global configu| 00000080 72 61 74 69 6f 6e 20 66 69 6c 65 2c 20 61 6e 64 |ration file, and| 00000090 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 6e 69 | contains the ni| 000000a0 63 6b 6e 61 6d 65 0a 20 20 28 74 68 65 20 33 20 |ckname. (the 3 | 000000b0 6c 65 74 74 65 72 73 20 70 72 65 63 65 64 69 6e |letters precedin| 000000c0 67 20 27 47 72 6f 75 70 27 20 66 72 6f 6d 20 67 |g 'Group' from g| 000000d0 65 6e 47 72 6f 75 70 29 20 6f 66 20 74 68 65 20 |enGroup) of the | 000000e0 64 65 66 61 75 6c 74 20 6e 65 77 73 73 65 72 76 |default newsserv| 000000f0 65 72 2e 0a 20 20 49 74 20 61 6c 73 6f 20 69 6e |er.. It also in| 00000100 63 6c 75 64 65 73 20 74 68 65 20 74 69 6d 65 20 |cludes the time | 00000110 74 68 61 74 20 6d 65 73 73 61 67 65 20 69 64 27 |that message id'| 00000120 73 20 61 72 65 20 68 65 6c 64 20 69 6e 20 74 68 |s are held in th| 00000130 65 20 49 64 0a 20 20 48 69 73 74 6f 72 79 2e 20 |e Id. History. | 00000140 54 68 69 73 20 69 73 20 74 6f 20 73 74 6f 70 20 |This is to stop | 00000150 64 75 70 6c 69 63 61 74 65 20 6d 65 73 73 61 67 |duplicate messag| 00000160 65 73 20 62 65 65 6e 20 64 6f 77 6e 6c 6f 61 64 |es been download| 00000170 65 64 20 2d 0a 20 20 61 20 76 61 6c 75 65 20 61 |ed -. a value a| 00000180 72 6f 75 6e 64 20 31 34 20 64 61 79 73 20 69 73 |round 14 days is| 00000190 20 6e 6f 72 6d 61 6c 6c 79 20 6f 6b 61 79 2c 20 | normally okay, | 000001a0 61 6c 74 68 6f 75 67 68 20 73 6c 69 67 68 74 6c |although slightl| 000001b0 79 20 6c 6f 6e 67 65 72 20 69 73 0a 20 20 62 65 |y longer is. be| 000001c0 74 74 65 72 2e 20 54 68 65 20 6e 75 6d 62 65 72 |tter. The number| 000001d0 20 6f 66 20 74 69 6d 65 73 20 74 6f 20 72 65 74 | of times to ret| 000001e0 72 79 2c 20 61 6e 64 20 74 68 65 20 64 65 6c 61 |ry, and the dela| 000001f0 79 20 69 6e 62 65 74 77 65 65 6e 20 74 68 65 6d |y inbetween them| 00000200 2c 20 73 68 6f 75 6c 64 0a 20 20 74 68 65 20 73 |, should. the s| 00000210 65 72 76 65 72 20 62 65 20 62 75 73 79 2c 20 69 |erver be busy, i| 00000220 73 20 61 6c 73 6f 20 73 70 65 63 69 66 69 65 64 |s also specified| 00000230 20 69 6e 20 68 65 72 65 2e 0a 0a 69 69 29 20 78 | in here...ii) x| 00000240 78 78 47 72 6f 75 70 0a 0a 20 20 54 68 69 73 20 |xxGroup.. This | 00000250 69 73 20 74 68 65 20 66 69 6c 65 20 74 68 61 74 |is the file that| 00000260 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 74 68 | contains all th| 00000270 65 20 64 61 74 61 20 61 62 6f 75 74 20 74 68 65 |e data about the| 00000280 20 27 78 78 78 27 20 6e 65 77 73 65 72 76 65 72 | 'xxx' newserver| 00000290 2c 0a 20 20 6c 69 6b 65 20 69 74 73 20 68 6f 73 |,. like its hos| 000002a0 74 6e 61 6d 65 20 6e 61 6d 65 2c 20 61 6e 64 20 |tname name, and | 000002b0 61 6c 6c 20 74 68 65 20 6e 65 77 73 67 72 6f 75 |all the newsgrou| 000002c0 70 73 20 74 68 61 74 20 61 72 65 20 66 65 74 63 |ps that are fetc| 000002d0 68 65 64 20 66 72 6f 6d 0a 20 20 69 74 2e 20 4e |hed from. it. N| 000002e0 6f 72 6d 61 6c 6c 79 2c 20 79 6f 75 20 64 6f 6e |ormally, you don| 000002f0 27 74 20 6e 65 65 64 20 74 6f 20 6d 61 6e 75 61 |'t need to manua| 00000300 6c 6c 79 20 65 64 69 74 20 74 68 69 73 20 2d 20 |lly edit this - | 00000310 69 74 27 73 20 61 6c 6c 20 64 6f 6e 65 20 66 72 |it's all done fr| 00000320 6f 6d 0a 20 20 6e 65 77 73 62 61 73 65 2e 0a 20 |om. newsbase.. | 00000330 20 49 66 20 79 6f 75 20 68 61 76 65 20 61 63 63 | If you have acc| 00000340 65 73 73 20 74 6f 20 6d 6f 72 65 20 74 68 61 6e |ess to more than| 00000350 20 6f 6e 65 20 6e 65 77 73 73 65 72 76 65 72 2c | one newsserver,| 00000360 20 79 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20 | you can create | 00000370 6d 6f 72 65 0a 20 20 6f 66 20 74 68 65 73 65 20 |more. of these | 00000380 66 69 6c 65 73 2c 20 61 6e 64 20 63 61 6e 20 73 |files, and can s| 00000390 65 6c 65 63 74 20 74 68 65 20 6e 65 77 73 20 73 |elect the news s| 000003a0 65 72 76 65 72 73 20 66 72 6f 6d 20 74 68 65 0a |ervers from the.| 000003b0 20 20 27 53 74 61 72 74 20 46 65 74 63 68 27 20 | 'Start Fetch' | 000003c0 6d 65 6e 75 20 69 6e 20 6e 65 77 73 68 6f 75 6e |menu in newshoun| 000003d0 64 2e 0a 0a 69 69 69 29 20 47 6c 6f 62 61 6c 52 |d...iii) GlobalR| 000003e0 75 6c 65 0a 0a 20 20 54 68 69 73 20 63 6f 6e 74 |ule.. This cont| 000003f0 61 69 6e 73 20 61 20 6c 69 73 74 20 6f 66 20 73 |ains a list of s| 00000400 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20 61 |tatements that a| 00000410 6c 6c 6f 77 20 4e 65 77 73 48 6f 75 6e 64 20 74 |llow NewsHound t| 00000420 6f 20 64 65 63 69 64 65 20 77 68 65 74 68 65 72 |o decide whether| 00000430 0a 20 20 74 6f 20 63 6f 6d 70 6c 65 74 65 6c 79 |. to completely| 00000440 20 69 67 6e 6f 72 65 20 61 6e 20 61 72 74 69 63 | ignore an artic| 00000450 6c 65 2c 20 64 6f 77 6e 6c 6f 61 64 20 6f 6e 6c |le, download onl| 00000460 79 20 74 68 65 20 68 65 61 64 65 72 2c 20 6f 72 |y the header, or| 00000470 20 64 6f 77 6e 6c 6f 61 64 0a 20 20 74 68 65 20 | download. the | 00000480 77 68 6f 6c 65 20 61 72 74 69 63 6c 65 2e 20 54 |whole article. T| 00000490 68 69 73 20 66 69 6c 65 20 63 61 6e 20 62 65 20 |his file can be | 000004a0 65 64 69 74 74 65 64 20 6d 61 6e 75 61 6c 6c 79 |editted manually| 000004b0 20 2d 20 64 6f 20 6e 6f 74 20 72 65 6d 6f 76 65 | - do not remove| 000004c0 0a 20 20 74 68 65 20 6c 69 6e 65 73 20 62 65 67 |. the lines beg| 000004d0 69 6e 6e 69 6e 67 20 77 69 74 68 20 24 27 73 2e |inning with $'s.| 000004e0 20 49 74 20 69 73 20 61 6c 73 6f 20 6d 6f 64 69 | It is also modi| 000004f0 66 69 65 64 20 62 79 20 74 68 65 20 61 64 64 67 |fied by the addg| 00000500 72 6f 75 70 0a 20 20 70 72 6f 67 72 61 6d 2e 0a |roup. program..| 00000510 20 20 59 6f 75 20 63 61 6e 20 75 73 65 20 74 68 | You can use th| 00000520 69 73 20 66 69 6c 65 20 74 6f 20 61 75 74 6f 6d |is file to autom| 00000530 61 74 69 63 61 6c 6c 79 20 73 65 6c 65 63 74 20 |atically select | 00000540 69 6e 74 65 72 65 73 74 69 6e 67 20 61 72 74 69 |interesting arti| 00000550 63 6c 65 73 0a 20 20 6f 75 74 20 6f 66 20 67 72 |cles. out of gr| 00000560 6f 75 70 73 20 74 68 61 74 20 61 72 65 20 64 6f |oups that are do| 00000570 77 6e 6c 6f 61 64 65 64 20 68 65 61 64 65 72 20 |wnloaded header | 00000580 6f 6e 6c 79 2e 0a 20 20 46 6f 72 20 65 78 61 6d |only.. For exam| 00000590 70 6c 65 2c 20 69 66 20 49 20 77 61 6e 74 65 64 |ple, if I wanted| 000005a0 20 74 6f 20 64 6f 77 6e 6c 6f 61 64 20 61 6c 6c | to download all| 000005b0 20 74 68 65 20 61 72 74 69 63 6c 65 73 20 62 79 | the articles by| 000005c0 20 27 4a 6f 68 6e 27 20 69 6e 0a 20 20 63 73 61 | 'John' in. csa| 000005d0 2e 6d 69 73 63 2c 20 49 27 64 20 61 64 64 20 61 |.misc, I'd add a| 000005e0 20 6c 69 6e 65 20 6c 69 6b 65 20 74 68 69 73 3a | line like this:| 000005f0 0a 0a 63 6f 6d 70 2e 73 79 73 2e 61 63 6f 72 6e |..comp.sys.acorn| 00000600 2e 6d 69 73 63 09 2a 09 2a 4a 6f 68 6e 2a 09 2a |.misc.*.*John*.*| 00000610 09 2a 09 61 72 74 0a 5b 67 72 6f 75 70 20 6e 61 |.*.art.[group na| 00000620 6d 65 09 09 73 75 62 6a 65 63 74 09 46 72 6f 6d |me..subject.From| 00000630 09 42 79 74 65 73 09 4c 69 6e 65 73 09 41 6d 6f |.Bytes.Lines.Amo| 00000640 75 6e 74 5d 0a 0a 20 20 6a 75 73 74 20 61 66 74 |unt].. just aft| 00000650 65 72 20 74 68 65 20 27 24 20 65 78 63 65 70 74 |er the '$ except| 00000660 69 6f 6e 73 3a 27 20 6c 69 6e 65 20 69 6e 20 21 |ions:' line in !| 00000670 4e 65 77 73 48 6f 75 6e 64 2e 43 6f 6e 66 69 67 |NewsHound.Config| 00000680 2e 47 6c 6f 62 61 6c 52 75 6c 65 2e 0a 0a 20 20 |.GlobalRule... | 00000690 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 61 64 6a |You can also adj| 000006a0 75 73 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 |ust the maximum | 000006b0 73 69 7a 65 20 6f 66 20 61 72 74 69 63 6c 65 20 |size of article | 000006c0 74 68 61 74 20 69 73 20 66 65 74 63 68 65 64 0a |that is fetched.| 000006d0 20 20 63 6f 6d 70 6c 65 74 65 2c 20 62 79 20 63 | complete, by c| 000006e0 68 61 6e 67 69 6e 67 20 74 68 65 20 6c 69 6e 65 |hanging the line| 000006f0 20 61 66 74 65 72 20 27 24 20 6d 61 78 20 61 72 | after '$ max ar| 00000700 74 69 63 6c 65 73 69 7a 65 27 2e 20 41 6e 79 20 |ticlesize'. Any | 00000710 61 72 74 69 63 6c 65 73 0a 20 20 74 68 61 74 20 |articles. that | 00000720 61 72 65 20 62 69 67 67 65 72 20 74 68 61 6e 20 |are bigger than | 00000730 74 68 69 73 20 28 31 30 30 6b 20 62 79 20 64 65 |this (100k by de| 00000740 66 61 75 6c 74 29 20 77 69 6c 6c 20 6f 6e 6c 79 |fault) will only| 00000750 20 68 61 76 65 20 74 68 65 69 72 0a 20 20 68 65 | have their. he| 00000760 61 64 65 72 73 20 64 6f 77 6e 6c 6f 61 64 65 64 |aders downloaded| 00000770 2c 20 75 6e 6c 65 73 73 20 79 6f 75 20 73 70 65 |, unless you spe| 00000780 63 69 66 79 20 6f 74 68 65 72 77 69 73 65 2e 0a |cify otherwise..| 00000790 0a |.| 00000791