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