Home » Archimedes archive » Acorn User » AU 1996-12 A.adf » Specials » PD/PDscheme/!NewsFind/!Help

PD/PDscheme/!NewsFind/!Help

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 1996-12 A.adf » Specials
Filename: PD/PDscheme/!NewsFind/!Help
Read OK:
File size: 08A4 bytes
Load address: 0000
Exec address: 0000
File contents
________________________________________________________________________

Program Name:   NewsFind
Purpose:        Newsbase search engine
Author:         Tony Houghton
Version:        0.01 (alpha)
________________________________________________________________________

Contact details:

Tony Houghton
271 Upper Weston Lane
Southampton
SO19 9HY
mailto:tonyh@tcp.co.uk
URL:http://www.tcp.co.uk/~tonyh/
________________________________________________________________________

NewsFind is an 'applet' for searching for patterns in messages stored by
Newsbase. Matching articles are copied to a folder so that they can be
read by TTFN or Messenger. NewsFind makes use of overview files to speed
up searching, so you need to use Newsbase 0.55 or later and ensure that
this feature is switched on.

When you choose a group to search you can either pick it from the menu
or type it. You can also type a hierarchy, using a trailing *, eg
"comp.sys.acorn.*" to search all the groups within Newsbase beginning
with comp.sys.acorn.

You can either confine a search to the contents of a specific header in
each article or search the whole body, including headers. The range of
headers available is restricted to those consistently available in
overview files, for speed of searching.

Messages are searched on a line by line basis, and matching patterns
apply to whole lines. This means that if you want to search for "Tony
Houghton" anywhere in a header or article you must wildcard the Match
expression with "*Tony Houghton*" instead of just typing "Tony
Houghton". A '#' character in the expression matches any one character,
and a '*' matches 0 or more. The end condition of a *-wildcard is either
the end of a line (if the * is at the end of the expression) or the
sequence that matches what follows the * in the expression. You can
search for * or # characters specifically contained in messages by
escaping them in the expression with a backslash ('\').

The Choices dialogue box allows you to choose a folder to copy matching
articles to, set a log file where brief details of each search are written,
and to set a user. Setting a user allows that user's email to be searched.
NewsFind does not support passwords.
00000000  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
00000040  5f 5f 5f 5f 5f 5f 5f 5f  0a 0a 50 72 6f 67 72 61  |________..Progra|
00000050  6d 20 4e 61 6d 65 3a 20  20 20 4e 65 77 73 46 69  |m Name:   NewsFi|
00000060  6e 64 0a 50 75 72 70 6f  73 65 3a 20 20 20 20 20  |nd.Purpose:     |
00000070  20 20 20 4e 65 77 73 62  61 73 65 20 73 65 61 72  |   Newsbase sear|
00000080  63 68 20 65 6e 67 69 6e  65 0a 41 75 74 68 6f 72  |ch engine.Author|
00000090  3a 20 20 20 20 20 20 20  20 20 54 6f 6e 79 20 48  |:         Tony H|
000000a0  6f 75 67 68 74 6f 6e 0a  56 65 72 73 69 6f 6e 3a  |oughton.Version:|
000000b0  20 20 20 20 20 20 20 20  30 2e 30 31 20 28 61 6c  |        0.01 (al|
000000c0  70 68 61 29 0a 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |pha).___________|
000000d0  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
00000100  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 0a 0a 43  |_____________..C|
00000110  6f 6e 74 61 63 74 20 64  65 74 61 69 6c 73 3a 0a  |ontact details:.|
00000120  0a 54 6f 6e 79 20 48 6f  75 67 68 74 6f 6e 0a 32  |.Tony Houghton.2|
00000130  37 31 20 55 70 70 65 72  20 57 65 73 74 6f 6e 20  |71 Upper Weston |
00000140  4c 61 6e 65 0a 53 6f 75  74 68 61 6d 70 74 6f 6e  |Lane.Southampton|
00000150  0a 53 4f 31 39 20 39 48  59 0a 6d 61 69 6c 74 6f  |.SO19 9HY.mailto|
00000160  3a 74 6f 6e 79 68 40 74  63 70 2e 63 6f 2e 75 6b  |:tonyh@tcp.co.uk|
00000170  0a 55 52 4c 3a 68 74 74  70 3a 2f 2f 77 77 77 2e  |.URL:http://www.|
00000180  74 63 70 2e 63 6f 2e 75  6b 2f 7e 74 6f 6e 79 68  |tcp.co.uk/~tonyh|
00000190  2f 0a 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |/.______________|
000001a0  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
000001d0  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 0a 0a 4e 65 77 73  |__________..News|
000001e0  46 69 6e 64 20 69 73 20  61 6e 20 27 61 70 70 6c  |Find is an 'appl|
000001f0  65 74 27 20 66 6f 72 20  73 65 61 72 63 68 69 6e  |et' for searchin|
00000200  67 20 66 6f 72 20 70 61  74 74 65 72 6e 73 20 69  |g for patterns i|
00000210  6e 20 6d 65 73 73 61 67  65 73 20 73 74 6f 72 65  |n messages store|
00000220  64 20 62 79 0a 4e 65 77  73 62 61 73 65 2e 20 4d  |d by.Newsbase. M|
00000230  61 74 63 68 69 6e 67 20  61 72 74 69 63 6c 65 73  |atching articles|
00000240  20 61 72 65 20 63 6f 70  69 65 64 20 74 6f 20 61  | are copied to a|
00000250  20 66 6f 6c 64 65 72 20  73 6f 20 74 68 61 74 20  | folder so that |
00000260  74 68 65 79 20 63 61 6e  20 62 65 0a 72 65 61 64  |they can be.read|
00000270  20 62 79 20 54 54 46 4e  20 6f 72 20 4d 65 73 73  | by TTFN or Mess|
00000280  65 6e 67 65 72 2e 20 4e  65 77 73 46 69 6e 64 20  |enger. NewsFind |
00000290  6d 61 6b 65 73 20 75 73  65 20 6f 66 20 6f 76 65  |makes use of ove|
000002a0  72 76 69 65 77 20 66 69  6c 65 73 20 74 6f 20 73  |rview files to s|
000002b0  70 65 65 64 0a 75 70 20  73 65 61 72 63 68 69 6e  |peed.up searchin|
000002c0  67 2c 20 73 6f 20 79 6f  75 20 6e 65 65 64 20 74  |g, so you need t|
000002d0  6f 20 75 73 65 20 4e 65  77 73 62 61 73 65 20 30  |o use Newsbase 0|
000002e0  2e 35 35 20 6f 72 20 6c  61 74 65 72 20 61 6e 64  |.55 or later and|
000002f0  20 65 6e 73 75 72 65 20  74 68 61 74 0a 74 68 69  | ensure that.thi|
00000300  73 20 66 65 61 74 75 72  65 20 69 73 20 73 77 69  |s feature is swi|
00000310  74 63 68 65 64 20 6f 6e  2e 0a 0a 57 68 65 6e 20  |tched on...When |
00000320  79 6f 75 20 63 68 6f 6f  73 65 20 61 20 67 72 6f  |you choose a gro|
00000330  75 70 20 74 6f 20 73 65  61 72 63 68 20 79 6f 75  |up to search you|
00000340  20 63 61 6e 20 65 69 74  68 65 72 20 70 69 63 6b  | can either pick|
00000350  20 69 74 20 66 72 6f 6d  20 74 68 65 20 6d 65 6e  | it from the men|
00000360  75 0a 6f 72 20 74 79 70  65 20 69 74 2e 20 59 6f  |u.or type it. Yo|
00000370  75 20 63 61 6e 20 61 6c  73 6f 20 74 79 70 65 20  |u can also type |
00000380  61 20 68 69 65 72 61 72  63 68 79 2c 20 75 73 69  |a hierarchy, usi|
00000390  6e 67 20 61 20 74 72 61  69 6c 69 6e 67 20 2a 2c  |ng a trailing *,|
000003a0  20 65 67 0a 22 63 6f 6d  70 2e 73 79 73 2e 61 63  | eg."comp.sys.ac|
000003b0  6f 72 6e 2e 2a 22 20 74  6f 20 73 65 61 72 63 68  |orn.*" to search|
000003c0  20 61 6c 6c 20 74 68 65  20 67 72 6f 75 70 73 20  | all the groups |
000003d0  77 69 74 68 69 6e 20 4e  65 77 73 62 61 73 65 20  |within Newsbase |
000003e0  62 65 67 69 6e 6e 69 6e  67 0a 77 69 74 68 20 63  |beginning.with c|
000003f0  6f 6d 70 2e 73 79 73 2e  61 63 6f 72 6e 2e 0a 0a  |omp.sys.acorn...|
00000400  59 6f 75 20 63 61 6e 20  65 69 74 68 65 72 20 63  |You can either c|
00000410  6f 6e 66 69 6e 65 20 61  20 73 65 61 72 63 68 20  |onfine a search |
00000420  74 6f 20 74 68 65 20 63  6f 6e 74 65 6e 74 73 20  |to the contents |
00000430  6f 66 20 61 20 73 70 65  63 69 66 69 63 20 68 65  |of a specific he|
00000440  61 64 65 72 20 69 6e 0a  65 61 63 68 20 61 72 74  |ader in.each art|
00000450  69 63 6c 65 20 6f 72 20  73 65 61 72 63 68 20 74  |icle or search t|
00000460  68 65 20 77 68 6f 6c 65  20 62 6f 64 79 2c 20 69  |he whole body, i|
00000470  6e 63 6c 75 64 69 6e 67  20 68 65 61 64 65 72 73  |ncluding headers|
00000480  2e 20 54 68 65 20 72 61  6e 67 65 20 6f 66 0a 68  |. The range of.h|
00000490  65 61 64 65 72 73 20 61  76 61 69 6c 61 62 6c 65  |eaders available|
000004a0  20 69 73 20 72 65 73 74  72 69 63 74 65 64 20 74  | is restricted t|
000004b0  6f 20 74 68 6f 73 65 20  63 6f 6e 73 69 73 74 65  |o those consiste|
000004c0  6e 74 6c 79 20 61 76 61  69 6c 61 62 6c 65 20 69  |ntly available i|
000004d0  6e 0a 6f 76 65 72 76 69  65 77 20 66 69 6c 65 73  |n.overview files|
000004e0  2c 20 66 6f 72 20 73 70  65 65 64 20 6f 66 20 73  |, for speed of s|
000004f0  65 61 72 63 68 69 6e 67  2e 0a 0a 4d 65 73 73 61  |earching...Messa|
00000500  67 65 73 20 61 72 65 20  73 65 61 72 63 68 65 64  |ges are searched|
00000510  20 6f 6e 20 61 20 6c 69  6e 65 20 62 79 20 6c 69  | on a line by li|
00000520  6e 65 20 62 61 73 69 73  2c 20 61 6e 64 20 6d 61  |ne basis, and ma|
00000530  74 63 68 69 6e 67 20 70  61 74 74 65 72 6e 73 0a  |tching patterns.|
00000540  61 70 70 6c 79 20 74 6f  20 77 68 6f 6c 65 20 6c  |apply to whole l|
00000550  69 6e 65 73 2e 20 54 68  69 73 20 6d 65 61 6e 73  |ines. This means|
00000560  20 74 68 61 74 20 69 66  20 79 6f 75 20 77 61 6e  | that if you wan|
00000570  74 20 74 6f 20 73 65 61  72 63 68 20 66 6f 72 20  |t to search for |
00000580  22 54 6f 6e 79 0a 48 6f  75 67 68 74 6f 6e 22 20  |"Tony.Houghton" |
00000590  61 6e 79 77 68 65 72 65  20 69 6e 20 61 20 68 65  |anywhere in a he|
000005a0  61 64 65 72 20 6f 72 20  61 72 74 69 63 6c 65 20  |ader or article |
000005b0  79 6f 75 20 6d 75 73 74  20 77 69 6c 64 63 61 72  |you must wildcar|
000005c0  64 20 74 68 65 20 4d 61  74 63 68 0a 65 78 70 72  |d the Match.expr|
000005d0  65 73 73 69 6f 6e 20 77  69 74 68 20 22 2a 54 6f  |ession with "*To|
000005e0  6e 79 20 48 6f 75 67 68  74 6f 6e 2a 22 20 69 6e  |ny Houghton*" in|
000005f0  73 74 65 61 64 20 6f 66  20 6a 75 73 74 20 74 79  |stead of just ty|
00000600  70 69 6e 67 20 22 54 6f  6e 79 0a 48 6f 75 67 68  |ping "Tony.Hough|
00000610  74 6f 6e 22 2e 20 41 20  27 23 27 20 63 68 61 72  |ton". A '#' char|
00000620  61 63 74 65 72 20 69 6e  20 74 68 65 20 65 78 70  |acter in the exp|
00000630  72 65 73 73 69 6f 6e 20  6d 61 74 63 68 65 73 20  |ression matches |
00000640  61 6e 79 20 6f 6e 65 20  63 68 61 72 61 63 74 65  |any one characte|
00000650  72 2c 0a 61 6e 64 20 61  20 27 2a 27 20 6d 61 74  |r,.and a '*' mat|
00000660  63 68 65 73 20 30 20 6f  72 20 6d 6f 72 65 2e 20  |ches 0 or more. |
00000670  54 68 65 20 65 6e 64 20  63 6f 6e 64 69 74 69 6f  |The end conditio|
00000680  6e 20 6f 66 20 61 20 2a  2d 77 69 6c 64 63 61 72  |n of a *-wildcar|
00000690  64 20 69 73 20 65 69 74  68 65 72 0a 74 68 65 20  |d is either.the |
000006a0  65 6e 64 20 6f 66 20 61  20 6c 69 6e 65 20 28 69  |end of a line (i|
000006b0  66 20 74 68 65 20 2a 20  69 73 20 61 74 20 74 68  |f the * is at th|
000006c0  65 20 65 6e 64 20 6f 66  20 74 68 65 20 65 78 70  |e end of the exp|
000006d0  72 65 73 73 69 6f 6e 29  20 6f 72 20 74 68 65 0a  |ression) or the.|
000006e0  73 65 71 75 65 6e 63 65  20 74 68 61 74 20 6d 61  |sequence that ma|
000006f0  74 63 68 65 73 20 77 68  61 74 20 66 6f 6c 6c 6f  |tches what follo|
00000700  77 73 20 74 68 65 20 2a  20 69 6e 20 74 68 65 20  |ws the * in the |
00000710  65 78 70 72 65 73 73 69  6f 6e 2e 20 59 6f 75 20  |expression. You |
00000720  63 61 6e 0a 73 65 61 72  63 68 20 66 6f 72 20 2a  |can.search for *|
00000730  20 6f 72 20 23 20 63 68  61 72 61 63 74 65 72 73  | or # characters|
00000740  20 73 70 65 63 69 66 69  63 61 6c 6c 79 20 63 6f  | specifically co|
00000750  6e 74 61 69 6e 65 64 20  69 6e 20 6d 65 73 73 61  |ntained in messa|
00000760  67 65 73 20 62 79 0a 65  73 63 61 70 69 6e 67 20  |ges by.escaping |
00000770  74 68 65 6d 20 69 6e 20  74 68 65 20 65 78 70 72  |them in the expr|
00000780  65 73 73 69 6f 6e 20 77  69 74 68 20 61 20 62 61  |ession with a ba|
00000790  63 6b 73 6c 61 73 68 20  28 27 5c 27 29 2e 0a 0a  |ckslash ('\')...|
000007a0  54 68 65 20 43 68 6f 69  63 65 73 20 64 69 61 6c  |The Choices dial|
000007b0  6f 67 75 65 20 62 6f 78  20 61 6c 6c 6f 77 73 20  |ogue box allows |
000007c0  79 6f 75 20 74 6f 20 63  68 6f 6f 73 65 20 61 20  |you to choose a |
000007d0  66 6f 6c 64 65 72 20 74  6f 20 63 6f 70 79 20 6d  |folder to copy m|
000007e0  61 74 63 68 69 6e 67 0a  61 72 74 69 63 6c 65 73  |atching.articles|
000007f0  20 74 6f 2c 20 73 65 74  20 61 20 6c 6f 67 20 66  | to, set a log f|
00000800  69 6c 65 20 77 68 65 72  65 20 62 72 69 65 66 20  |ile where brief |
00000810  64 65 74 61 69 6c 73 20  6f 66 20 65 61 63 68 20  |details of each |
00000820  73 65 61 72 63 68 20 61  72 65 20 77 72 69 74 74  |search are writt|
00000830  65 6e 2c 0a 61 6e 64 20  74 6f 20 73 65 74 20 61  |en,.and to set a|
00000840  20 75 73 65 72 2e 20 53  65 74 74 69 6e 67 20 61  | user. Setting a|
00000850  20 75 73 65 72 20 61 6c  6c 6f 77 73 20 74 68 61  | user allows tha|
00000860  74 20 75 73 65 72 27 73  20 65 6d 61 69 6c 20 74  |t user's email t|
00000870  6f 20 62 65 20 73 65 61  72 63 68 65 64 2e 0a 4e  |o be searched..N|
00000880  65 77 73 46 69 6e 64 20  64 6f 65 73 20 6e 6f 74  |ewsFind does not|
00000890  20 73 75 70 70 6f 72 74  20 70 61 73 73 77 6f 72  | support passwor|
000008a0  64 73 2e 0a                                       |ds..|
000008a4