Home » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199508.adf » !Internet » StarterPak/!Newsbase/Docs/General

StarterPak/!Newsbase/Docs/General

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 » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199508.adf » !Internet
Filename: StarterPak/!Newsbase/Docs/General
Read OK:
File size: 1A6F bytes
Load address: 0000
Exec address: 0000
File contents
Here are some very general notes on how some parts of Newsbase work.

When debatching a file, newsbase first attempts to recognise the type of
batch file by scanning it for valid separators. These consist of lines
beginning with:

#! rmail                mail
^A                      mail (control-A)
From                    mail (including trailing space)
#! rnews                news

If a separator is not found on the first line of the file, newsbase will
'rewind' to the beginning of the file, after attempting recognition. If no
valid separators are found, newsbase tries to guess the batch type by
presence of "Newsgroups:" headers, etc. Headerless parts of the file will be
saved to the groups "Email.postmaster" or "junk" depending on how newsbase
finally recognises it.

From Newsbase 0.43, articles are held in the directory:
group.name.~x.~xN
where N is (article number DIV 75) MOD 75
This now permits many articles to be held without creating an unmanagably
deep directory structure.

(0.52f onwards:) To prevent excessive directory creation, articles which are
either locked, or have an Expires header, are moved back to the
general-purpose directory, group.name.~x.~x, during expiry. This should
avoid the presence of many specifically-numbered directories containing very
few articles. "clari.*" groups are treated differently here; as all articles
have expires headers, this part of the rule is not applied.

Article numbers are assigned for valid groups as soon as the
Newsgroups: line has been decoded. A "Xref:" header line is then inserted
into the article buffer, allowing clients to mark crossposts as read in all
the crossposted groups. Saving then follows the pregenerated group/number
list (allowing up to 10 groups).

From Newsbase 0.23, the "Supersedes:" header is respected, and a superceded
article is deleted (if not locked).

The "Expires:" header is handled by encoding the expiry date within a
file's datastamp for articles which require it (the high byte of the 5-byte
datestamp is set to &FF as a flag; the remaining 4 bytes contain the
expiry date as a 1-word integer in the form CEYRMNDY. Files encoded this
way have an apparent datestamp, to the filing system, sometime in the
year 2247).

Expire code is called on a per-group basis, to simplify index update.
Expired article numbers are added to a delete buffer and are removed from
the group index when the buffer fills or a different group is referenced.

The delete buffer is 512 articles deep (ie, 512 deletions before an index
rewrite is required).

When delete buffer is filled, or a deletion for a different group arrives, the
index is updated to remove entries for deleted articles.

Polling is disabled during an index update; an hourglass is displayed while
this occurs. With a medium-speed hard disk and around 1000 index
entries, an index update generally takes around 2-5 seconds.

Article request by message ID is not currently supported as the lookup is 
quite slow (the index file must be scanned).

Index files are held in each group's "root directory", eg
news:rec.audio.~index.

The index file format is fixed-length 200-byte records, one record per article.
The record format is:
bytes 0-3 : article number
bytes 4-7 : record type

For compatibility with old index files, record types >100 are taken as being
type 0 (some versions of newsbase stored the article date in this field).

record type 0:
bytes 8-11: article date (format CEYRMNDY)
bytes 12-19: reserved for extra information.
bytes 20-n: "Message-ID" field, from article header, null-terminated
bytes n-m : "From" field.
bytes m-199 : "Subject field.

record type 1:
bytes 8-11: article date (format CEYRMNDY)
bytes 12-19: reserved for extra information.
bytes 20-n: "Message-ID" field, from article header, null-terminated
bytes n-m : "From" field.
bytes m-o : "Subject field.
bytes o-199: "References" field.

record type 2:
bytes 8-19: unused
bytes 20-199: "References" field.

Fields may be truncated if they do not fit within the record space available.
If no message ID is available in the article header, it is replaced with
"<0>", in accordance with RFC977.

Criteria for design of record structure-
 1. Must be easy to access, and fast to add and remove records, even from
    BASIC. Fixed record size avoids doing any significant processing.
 2. Article information is destinied to be passed to a client program via wimp
    messages. The "Article info" message passes the following information:
    article number, from, and subject. The maximum amount of data
    that can be passed in a wimp message is about 230 bytes.


This scheme works well with small numbers of newsgroups (150 tested but more
should scale fairly linearly) and, with the new directory structure of
Newsbase 0.43, more than 2000 articles per group. Better memory management
will be needed within NewsBase to deal with many more groups, but that is an
internal implementation issue. See the file "Tuning" for information on how
to tailor newsbase for larger newsfeeds.


The from and subject strings returned by "ListArticles" are length limited
and intended for display (in article catalogues) only. Use the fields
directly from the article headers for generating replies, etc.

References headers stored in the index file are limited to 200 characters
max. If a references list is longer than this, newsbase will attempt to
store it intelligently by omitting references from the middle of the list so
as to preserve information about the original and most recent parent
articles. This should permit adequate threading of articles.

The pathname returned by "article get" should be used once and not stored
across calls to Wimp_Poll. It is possible for article files to move without
notification (generally only at debatch or expiry time)

"Article delete" is included to complete the command set, but should
probably not be used in a multiple-reader environment. It will not be
effective against locked articles. One situation where the function might
be useful is to delete personal email - in this situation, deletion will
always be permitted. For other groups, deletion may be disabled as a
newsbase configuration option.

It is the responsibility of the newsbase client to track which articles and
groups a reader is interested in, or has read.

"Article lock" prevents an article from being deleted or expired, regardless
of expiry date.

Mail batches are mistakenly split on lines starting "From ". The extra bit
of message is saved to Email.postmaster (problem mail) with a suitable
subject (no recipient?) rather than into a group "Email" as currently.
Using the ka9q transport, this is only seen with POP (SMTP alters these
lines to ">From "). This can be avoided by using ^A or "#! rmail" separators.
00000000  48 65 72 65 20 61 72 65  20 73 6f 6d 65 20 76 65  |Here are some ve|
00000010  72 79 20 67 65 6e 65 72  61 6c 20 6e 6f 74 65 73  |ry general notes|
00000020  20 6f 6e 20 68 6f 77 20  73 6f 6d 65 20 70 61 72  | on how some par|
00000030  74 73 20 6f 66 20 4e 65  77 73 62 61 73 65 20 77  |ts of Newsbase w|
00000040  6f 72 6b 2e 0a 0a 57 68  65 6e 20 64 65 62 61 74  |ork...When debat|
00000050  63 68 69 6e 67 20 61 20  66 69 6c 65 2c 20 6e 65  |ching a file, ne|
00000060  77 73 62 61 73 65 20 66  69 72 73 74 20 61 74 74  |wsbase first att|
00000070  65 6d 70 74 73 20 74 6f  20 72 65 63 6f 67 6e 69  |empts to recogni|
00000080  73 65 20 74 68 65 20 74  79 70 65 20 6f 66 0a 62  |se the type of.b|
00000090  61 74 63 68 20 66 69 6c  65 20 62 79 20 73 63 61  |atch file by sca|
000000a0  6e 6e 69 6e 67 20 69 74  20 66 6f 72 20 76 61 6c  |nning it for val|
000000b0  69 64 20 73 65 70 61 72  61 74 6f 72 73 2e 20 54  |id separators. T|
000000c0  68 65 73 65 20 63 6f 6e  73 69 73 74 20 6f 66 20  |hese consist of |
000000d0  6c 69 6e 65 73 0a 62 65  67 69 6e 6e 69 6e 67 20  |lines.beginning |
000000e0  77 69 74 68 3a 0a 0a 23  21 20 72 6d 61 69 6c 20  |with:..#! rmail |
000000f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 6d  |               m|
00000100  61 69 6c 0a 5e 41 20 20  20 20 20 20 20 20 20 20  |ail.^A          |
00000110  20 20 20 20 20 20 20 20  20 20 20 20 6d 61 69 6c  |            mail|
00000120  20 28 63 6f 6e 74 72 6f  6c 2d 41 29 0a 46 72 6f  | (control-A).Fro|
00000130  6d 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |m               |
00000140  20 20 20 20 20 6d 61 69  6c 20 28 69 6e 63 6c 75  |     mail (inclu|
00000150  64 69 6e 67 20 74 72 61  69 6c 69 6e 67 20 73 70  |ding trailing sp|
00000160  61 63 65 29 0a 23 21 20  72 6e 65 77 73 20 20 20  |ace).#! rnews   |
00000170  20 20 20 20 20 20 20 20  20 20 20 20 20 6e 65 77  |             new|
00000180  73 0a 0a 49 66 20 61 20  73 65 70 61 72 61 74 6f  |s..If a separato|
00000190  72 20 69 73 20 6e 6f 74  20 66 6f 75 6e 64 20 6f  |r is not found o|
000001a0  6e 20 74 68 65 20 66 69  72 73 74 20 6c 69 6e 65  |n the first line|
000001b0  20 6f 66 20 74 68 65 20  66 69 6c 65 2c 20 6e 65  | of the file, ne|
000001c0  77 73 62 61 73 65 20 77  69 6c 6c 0a 27 72 65 77  |wsbase will.'rew|
000001d0  69 6e 64 27 20 74 6f 20  74 68 65 20 62 65 67 69  |ind' to the begi|
000001e0  6e 6e 69 6e 67 20 6f 66  20 74 68 65 20 66 69 6c  |nning of the fil|
000001f0  65 2c 20 61 66 74 65 72  20 61 74 74 65 6d 70 74  |e, after attempt|
00000200  69 6e 67 20 72 65 63 6f  67 6e 69 74 69 6f 6e 2e  |ing recognition.|
00000210  20 49 66 20 6e 6f 0a 76  61 6c 69 64 20 73 65 70  | If no.valid sep|
00000220  61 72 61 74 6f 72 73 20  61 72 65 20 66 6f 75 6e  |arators are foun|
00000230  64 2c 20 6e 65 77 73 62  61 73 65 20 74 72 69 65  |d, newsbase trie|
00000240  73 20 74 6f 20 67 75 65  73 73 20 74 68 65 20 62  |s to guess the b|
00000250  61 74 63 68 20 74 79 70  65 20 62 79 0a 70 72 65  |atch type by.pre|
00000260  73 65 6e 63 65 20 6f 66  20 22 4e 65 77 73 67 72  |sence of "Newsgr|
00000270  6f 75 70 73 3a 22 20 68  65 61 64 65 72 73 2c 20  |oups:" headers, |
00000280  65 74 63 2e 20 48 65 61  64 65 72 6c 65 73 73 20  |etc. Headerless |
00000290  70 61 72 74 73 20 6f 66  20 74 68 65 20 66 69 6c  |parts of the fil|
000002a0  65 20 77 69 6c 6c 20 62  65 0a 73 61 76 65 64 20  |e will be.saved |
000002b0  74 6f 20 74 68 65 20 67  72 6f 75 70 73 20 22 45  |to the groups "E|
000002c0  6d 61 69 6c 2e 70 6f 73  74 6d 61 73 74 65 72 22  |mail.postmaster"|
000002d0  20 6f 72 20 22 6a 75 6e  6b 22 20 64 65 70 65 6e  | or "junk" depen|
000002e0  64 69 6e 67 20 6f 6e 20  68 6f 77 20 6e 65 77 73  |ding on how news|
000002f0  62 61 73 65 0a 66 69 6e  61 6c 6c 79 20 72 65 63  |base.finally rec|
00000300  6f 67 6e 69 73 65 73 20  69 74 2e 0a 0a 46 72 6f  |ognises it...Fro|
00000310  6d 20 4e 65 77 73 62 61  73 65 20 30 2e 34 33 2c  |m Newsbase 0.43,|
00000320  20 61 72 74 69 63 6c 65  73 20 61 72 65 20 68 65  | articles are he|
00000330  6c 64 20 69 6e 20 74 68  65 20 64 69 72 65 63 74  |ld in the direct|
00000340  6f 72 79 3a 0a 67 72 6f  75 70 2e 6e 61 6d 65 2e  |ory:.group.name.|
00000350  7e 78 2e 7e 78 4e 0a 77  68 65 72 65 20 4e 20 69  |~x.~xN.where N i|
00000360  73 20 28 61 72 74 69 63  6c 65 20 6e 75 6d 62 65  |s (article numbe|
00000370  72 20 44 49 56 20 37 35  29 20 4d 4f 44 20 37 35  |r DIV 75) MOD 75|
00000380  0a 54 68 69 73 20 6e 6f  77 20 70 65 72 6d 69 74  |.This now permit|
00000390  73 20 6d 61 6e 79 20 61  72 74 69 63 6c 65 73 20  |s many articles |
000003a0  74 6f 20 62 65 20 68 65  6c 64 20 77 69 74 68 6f  |to be held witho|
000003b0  75 74 20 63 72 65 61 74  69 6e 67 20 61 6e 20 75  |ut creating an u|
000003c0  6e 6d 61 6e 61 67 61 62  6c 79 0a 64 65 65 70 20  |nmanagably.deep |
000003d0  64 69 72 65 63 74 6f 72  79 20 73 74 72 75 63 74  |directory struct|
000003e0  75 72 65 2e 0a 0a 28 30  2e 35 32 66 20 6f 6e 77  |ure...(0.52f onw|
000003f0  61 72 64 73 3a 29 20 54  6f 20 70 72 65 76 65 6e  |ards:) To preven|
00000400  74 20 65 78 63 65 73 73  69 76 65 20 64 69 72 65  |t excessive dire|
00000410  63 74 6f 72 79 20 63 72  65 61 74 69 6f 6e 2c 20  |ctory creation, |
00000420  61 72 74 69 63 6c 65 73  20 77 68 69 63 68 20 61  |articles which a|
00000430  72 65 0a 65 69 74 68 65  72 20 6c 6f 63 6b 65 64  |re.either locked|
00000440  2c 20 6f 72 20 68 61 76  65 20 61 6e 20 45 78 70  |, or have an Exp|
00000450  69 72 65 73 20 68 65 61  64 65 72 2c 20 61 72 65  |ires header, are|
00000460  20 6d 6f 76 65 64 20 62  61 63 6b 20 74 6f 20 74  | moved back to t|
00000470  68 65 0a 67 65 6e 65 72  61 6c 2d 70 75 72 70 6f  |he.general-purpo|
00000480  73 65 20 64 69 72 65 63  74 6f 72 79 2c 20 67 72  |se directory, gr|
00000490  6f 75 70 2e 6e 61 6d 65  2e 7e 78 2e 7e 78 2c 20  |oup.name.~x.~x, |
000004a0  64 75 72 69 6e 67 20 65  78 70 69 72 79 2e 20 54  |during expiry. T|
000004b0  68 69 73 20 73 68 6f 75  6c 64 0a 61 76 6f 69 64  |his should.avoid|
000004c0  20 74 68 65 20 70 72 65  73 65 6e 63 65 20 6f 66  | the presence of|
000004d0  20 6d 61 6e 79 20 73 70  65 63 69 66 69 63 61 6c  | many specifical|
000004e0  6c 79 2d 6e 75 6d 62 65  72 65 64 20 64 69 72 65  |ly-numbered dire|
000004f0  63 74 6f 72 69 65 73 20  63 6f 6e 74 61 69 6e 69  |ctories containi|
00000500  6e 67 20 76 65 72 79 0a  66 65 77 20 61 72 74 69  |ng very.few arti|
00000510  63 6c 65 73 2e 20 22 63  6c 61 72 69 2e 2a 22 20  |cles. "clari.*" |
00000520  67 72 6f 75 70 73 20 61  72 65 20 74 72 65 61 74  |groups are treat|
00000530  65 64 20 64 69 66 66 65  72 65 6e 74 6c 79 20 68  |ed differently h|
00000540  65 72 65 3b 20 61 73 20  61 6c 6c 20 61 72 74 69  |ere; as all arti|
00000550  63 6c 65 73 0a 68 61 76  65 20 65 78 70 69 72 65  |cles.have expire|
00000560  73 20 68 65 61 64 65 72  73 2c 20 74 68 69 73 20  |s headers, this |
00000570  70 61 72 74 20 6f 66 20  74 68 65 20 72 75 6c 65  |part of the rule|
00000580  20 69 73 20 6e 6f 74 20  61 70 70 6c 69 65 64 2e  | is not applied.|
00000590  0a 0a 41 72 74 69 63 6c  65 20 6e 75 6d 62 65 72  |..Article number|
000005a0  73 20 61 72 65 20 61 73  73 69 67 6e 65 64 20 66  |s are assigned f|
000005b0  6f 72 20 76 61 6c 69 64  20 67 72 6f 75 70 73 20  |or valid groups |
000005c0  61 73 20 73 6f 6f 6e 20  61 73 20 74 68 65 0a 4e  |as soon as the.N|
000005d0  65 77 73 67 72 6f 75 70  73 3a 20 6c 69 6e 65 20  |ewsgroups: line |
000005e0  68 61 73 20 62 65 65 6e  20 64 65 63 6f 64 65 64  |has been decoded|
000005f0  2e 20 41 20 22 58 72 65  66 3a 22 20 68 65 61 64  |. A "Xref:" head|
00000600  65 72 20 6c 69 6e 65 20  69 73 20 74 68 65 6e 20  |er line is then |
00000610  69 6e 73 65 72 74 65 64  0a 69 6e 74 6f 20 74 68  |inserted.into th|
00000620  65 20 61 72 74 69 63 6c  65 20 62 75 66 66 65 72  |e article buffer|
00000630  2c 20 61 6c 6c 6f 77 69  6e 67 20 63 6c 69 65 6e  |, allowing clien|
00000640  74 73 20 74 6f 20 6d 61  72 6b 20 63 72 6f 73 73  |ts to mark cross|
00000650  70 6f 73 74 73 20 61 73  20 72 65 61 64 20 69 6e  |posts as read in|
00000660  20 61 6c 6c 0a 74 68 65  20 63 72 6f 73 73 70 6f  | all.the crosspo|
00000670  73 74 65 64 20 67 72 6f  75 70 73 2e 20 53 61 76  |sted groups. Sav|
00000680  69 6e 67 20 74 68 65 6e  20 66 6f 6c 6c 6f 77 73  |ing then follows|
00000690  20 74 68 65 20 70 72 65  67 65 6e 65 72 61 74 65  | the pregenerate|
000006a0  64 20 67 72 6f 75 70 2f  6e 75 6d 62 65 72 0a 6c  |d group/number.l|
000006b0  69 73 74 20 28 61 6c 6c  6f 77 69 6e 67 20 75 70  |ist (allowing up|
000006c0  20 74 6f 20 31 30 20 67  72 6f 75 70 73 29 2e 0a  | to 10 groups)..|
000006d0  0a 46 72 6f 6d 20 4e 65  77 73 62 61 73 65 20 30  |.From Newsbase 0|
000006e0  2e 32 33 2c 20 74 68 65  20 22 53 75 70 65 72 73  |.23, the "Supers|
000006f0  65 64 65 73 3a 22 20 68  65 61 64 65 72 20 69 73  |edes:" header is|
00000700  20 72 65 73 70 65 63 74  65 64 2c 20 61 6e 64 20  | respected, and |
00000710  61 20 73 75 70 65 72 63  65 64 65 64 0a 61 72 74  |a superceded.art|
00000720  69 63 6c 65 20 69 73 20  64 65 6c 65 74 65 64 20  |icle is deleted |
00000730  28 69 66 20 6e 6f 74 20  6c 6f 63 6b 65 64 29 2e  |(if not locked).|
00000740  0a 0a 54 68 65 20 22 45  78 70 69 72 65 73 3a 22  |..The "Expires:"|
00000750  20 68 65 61 64 65 72 20  69 73 20 68 61 6e 64 6c  | header is handl|
00000760  65 64 20 62 79 20 65 6e  63 6f 64 69 6e 67 20 74  |ed by encoding t|
00000770  68 65 20 65 78 70 69 72  79 20 64 61 74 65 20 77  |he expiry date w|
00000780  69 74 68 69 6e 20 61 0a  66 69 6c 65 27 73 20 64  |ithin a.file's d|
00000790  61 74 61 73 74 61 6d 70  20 66 6f 72 20 61 72 74  |atastamp for art|
000007a0  69 63 6c 65 73 20 77 68  69 63 68 20 72 65 71 75  |icles which requ|
000007b0  69 72 65 20 69 74 20 28  74 68 65 20 68 69 67 68  |ire it (the high|
000007c0  20 62 79 74 65 20 6f 66  20 74 68 65 20 35 2d 62  | byte of the 5-b|
000007d0  79 74 65 0a 64 61 74 65  73 74 61 6d 70 20 69 73  |yte.datestamp is|
000007e0  20 73 65 74 20 74 6f 20  26 46 46 20 61 73 20 61  | set to &FF as a|
000007f0  20 66 6c 61 67 3b 20 74  68 65 20 72 65 6d 61 69  | flag; the remai|
00000800  6e 69 6e 67 20 34 20 62  79 74 65 73 20 63 6f 6e  |ning 4 bytes con|
00000810  74 61 69 6e 20 74 68 65  0a 65 78 70 69 72 79 20  |tain the.expiry |
00000820  64 61 74 65 20 61 73 20  61 20 31 2d 77 6f 72 64  |date as a 1-word|
00000830  20 69 6e 74 65 67 65 72  20 69 6e 20 74 68 65 20  | integer in the |
00000840  66 6f 72 6d 20 43 45 59  52 4d 4e 44 59 2e 20 46  |form CEYRMNDY. F|
00000850  69 6c 65 73 20 65 6e 63  6f 64 65 64 20 74 68 69  |iles encoded thi|
00000860  73 0a 77 61 79 20 68 61  76 65 20 61 6e 20 61 70  |s.way have an ap|
00000870  70 61 72 65 6e 74 20 64  61 74 65 73 74 61 6d 70  |parent datestamp|
00000880  2c 20 74 6f 20 74 68 65  20 66 69 6c 69 6e 67 20  |, to the filing |
00000890  73 79 73 74 65 6d 2c 20  73 6f 6d 65 74 69 6d 65  |system, sometime|
000008a0  20 69 6e 20 74 68 65 0a  79 65 61 72 20 32 32 34  | in the.year 224|
000008b0  37 29 2e 0a 0a 45 78 70  69 72 65 20 63 6f 64 65  |7)...Expire code|
000008c0  20 69 73 20 63 61 6c 6c  65 64 20 6f 6e 20 61 20  | is called on a |
000008d0  70 65 72 2d 67 72 6f 75  70 20 62 61 73 69 73 2c  |per-group basis,|
000008e0  20 74 6f 20 73 69 6d 70  6c 69 66 79 20 69 6e 64  | to simplify ind|
000008f0  65 78 20 75 70 64 61 74  65 2e 0a 45 78 70 69 72  |ex update..Expir|
00000900  65 64 20 61 72 74 69 63  6c 65 20 6e 75 6d 62 65  |ed article numbe|
00000910  72 73 20 61 72 65 20 61  64 64 65 64 20 74 6f 20  |rs are added to |
00000920  61 20 64 65 6c 65 74 65  20 62 75 66 66 65 72 20  |a delete buffer |
00000930  61 6e 64 20 61 72 65 20  72 65 6d 6f 76 65 64 20  |and are removed |
00000940  66 72 6f 6d 0a 74 68 65  20 67 72 6f 75 70 20 69  |from.the group i|
00000950  6e 64 65 78 20 77 68 65  6e 20 74 68 65 20 62 75  |ndex when the bu|
00000960  66 66 65 72 20 66 69 6c  6c 73 20 6f 72 20 61 20  |ffer fills or a |
00000970  64 69 66 66 65 72 65 6e  74 20 67 72 6f 75 70 20  |different group |
00000980  69 73 20 72 65 66 65 72  65 6e 63 65 64 2e 0a 0a  |is referenced...|
00000990  54 68 65 20 64 65 6c 65  74 65 20 62 75 66 66 65  |The delete buffe|
000009a0  72 20 69 73 20 35 31 32  20 61 72 74 69 63 6c 65  |r is 512 article|
000009b0  73 20 64 65 65 70 20 28  69 65 2c 20 35 31 32 20  |s deep (ie, 512 |
000009c0  64 65 6c 65 74 69 6f 6e  73 20 62 65 66 6f 72 65  |deletions before|
000009d0  20 61 6e 20 69 6e 64 65  78 0a 72 65 77 72 69 74  | an index.rewrit|
000009e0  65 20 69 73 20 72 65 71  75 69 72 65 64 29 2e 0a  |e is required)..|
000009f0  0a 57 68 65 6e 20 64 65  6c 65 74 65 20 62 75 66  |.When delete buf|
00000a00  66 65 72 20 69 73 20 66  69 6c 6c 65 64 2c 20 6f  |fer is filled, o|
00000a10  72 20 61 20 64 65 6c 65  74 69 6f 6e 20 66 6f 72  |r a deletion for|
00000a20  20 61 20 64 69 66 66 65  72 65 6e 74 20 67 72 6f  | a different gro|
00000a30  75 70 20 61 72 72 69 76  65 73 2c 20 74 68 65 0a  |up arrives, the.|
00000a40  69 6e 64 65 78 20 69 73  20 75 70 64 61 74 65 64  |index is updated|
00000a50  20 74 6f 20 72 65 6d 6f  76 65 20 65 6e 74 72 69  | to remove entri|
00000a60  65 73 20 66 6f 72 20 64  65 6c 65 74 65 64 20 61  |es for deleted a|
00000a70  72 74 69 63 6c 65 73 2e  0a 0a 50 6f 6c 6c 69 6e  |rticles...Pollin|
00000a80  67 20 69 73 20 64 69 73  61 62 6c 65 64 20 64 75  |g is disabled du|
00000a90  72 69 6e 67 20 61 6e 20  69 6e 64 65 78 20 75 70  |ring an index up|
00000aa0  64 61 74 65 3b 20 61 6e  20 68 6f 75 72 67 6c 61  |date; an hourgla|
00000ab0  73 73 20 69 73 20 64 69  73 70 6c 61 79 65 64 20  |ss is displayed |
00000ac0  77 68 69 6c 65 0a 74 68  69 73 20 6f 63 63 75 72  |while.this occur|
00000ad0  73 2e 20 57 69 74 68 20  61 20 6d 65 64 69 75 6d  |s. With a medium|
00000ae0  2d 73 70 65 65 64 20 68  61 72 64 20 64 69 73 6b  |-speed hard disk|
00000af0  20 61 6e 64 20 61 72 6f  75 6e 64 20 31 30 30 30  | and around 1000|
00000b00  20 69 6e 64 65 78 0a 65  6e 74 72 69 65 73 2c 20  | index.entries, |
00000b10  61 6e 20 69 6e 64 65 78  20 75 70 64 61 74 65 20  |an index update |
00000b20  67 65 6e 65 72 61 6c 6c  79 20 74 61 6b 65 73 20  |generally takes |
00000b30  61 72 6f 75 6e 64 20 32  2d 35 20 73 65 63 6f 6e  |around 2-5 secon|
00000b40  64 73 2e 0a 0a 41 72 74  69 63 6c 65 20 72 65 71  |ds...Article req|
00000b50  75 65 73 74 20 62 79 20  6d 65 73 73 61 67 65 20  |uest by message |
00000b60  49 44 20 69 73 20 6e 6f  74 20 63 75 72 72 65 6e  |ID is not curren|
00000b70  74 6c 79 20 73 75 70 70  6f 72 74 65 64 20 61 73  |tly supported as|
00000b80  20 74 68 65 20 6c 6f 6f  6b 75 70 20 69 73 20 0a  | the lookup is .|
00000b90  71 75 69 74 65 20 73 6c  6f 77 20 28 74 68 65 20  |quite slow (the |
00000ba0  69 6e 64 65 78 20 66 69  6c 65 20 6d 75 73 74 20  |index file must |
00000bb0  62 65 20 73 63 61 6e 6e  65 64 29 2e 0a 0a 49 6e  |be scanned)...In|
00000bc0  64 65 78 20 66 69 6c 65  73 20 61 72 65 20 68 65  |dex files are he|
00000bd0  6c 64 20 69 6e 20 65 61  63 68 20 67 72 6f 75 70  |ld in each group|
00000be0  27 73 20 22 72 6f 6f 74  20 64 69 72 65 63 74 6f  |'s "root directo|
00000bf0  72 79 22 2c 20 65 67 0a  6e 65 77 73 3a 72 65 63  |ry", eg.news:rec|
00000c00  2e 61 75 64 69 6f 2e 7e  69 6e 64 65 78 2e 0a 0a  |.audio.~index...|
00000c10  54 68 65 20 69 6e 64 65  78 20 66 69 6c 65 20 66  |The index file f|
00000c20  6f 72 6d 61 74 20 69 73  20 66 69 78 65 64 2d 6c  |ormat is fixed-l|
00000c30  65 6e 67 74 68 20 32 30  30 2d 62 79 74 65 20 72  |ength 200-byte r|
00000c40  65 63 6f 72 64 73 2c 20  6f 6e 65 20 72 65 63 6f  |ecords, one reco|
00000c50  72 64 20 70 65 72 20 61  72 74 69 63 6c 65 2e 0a  |rd per article..|
00000c60  54 68 65 20 72 65 63 6f  72 64 20 66 6f 72 6d 61  |The record forma|
00000c70  74 20 69 73 3a 0a 62 79  74 65 73 20 30 2d 33 20  |t is:.bytes 0-3 |
00000c80  3a 20 61 72 74 69 63 6c  65 20 6e 75 6d 62 65 72  |: article number|
00000c90  0a 62 79 74 65 73 20 34  2d 37 20 3a 20 72 65 63  |.bytes 4-7 : rec|
00000ca0  6f 72 64 20 74 79 70 65  0a 0a 46 6f 72 20 63 6f  |ord type..For co|
00000cb0  6d 70 61 74 69 62 69 6c  69 74 79 20 77 69 74 68  |mpatibility with|
00000cc0  20 6f 6c 64 20 69 6e 64  65 78 20 66 69 6c 65 73  | old index files|
00000cd0  2c 20 72 65 63 6f 72 64  20 74 79 70 65 73 20 3e  |, record types >|
00000ce0  31 30 30 20 61 72 65 20  74 61 6b 65 6e 20 61 73  |100 are taken as|
00000cf0  20 62 65 69 6e 67 0a 74  79 70 65 20 30 20 28 73  | being.type 0 (s|
00000d00  6f 6d 65 20 76 65 72 73  69 6f 6e 73 20 6f 66 20  |ome versions of |
00000d10  6e 65 77 73 62 61 73 65  20 73 74 6f 72 65 64 20  |newsbase stored |
00000d20  74 68 65 20 61 72 74 69  63 6c 65 20 64 61 74 65  |the article date|
00000d30  20 69 6e 20 74 68 69 73  20 66 69 65 6c 64 29 2e  | in this field).|
00000d40  0a 0a 72 65 63 6f 72 64  20 74 79 70 65 20 30 3a  |..record type 0:|
00000d50  0a 62 79 74 65 73 20 38  2d 31 31 3a 20 61 72 74  |.bytes 8-11: art|
00000d60  69 63 6c 65 20 64 61 74  65 20 28 66 6f 72 6d 61  |icle date (forma|
00000d70  74 20 43 45 59 52 4d 4e  44 59 29 0a 62 79 74 65  |t CEYRMNDY).byte|
00000d80  73 20 31 32 2d 31 39 3a  20 72 65 73 65 72 76 65  |s 12-19: reserve|
00000d90  64 20 66 6f 72 20 65 78  74 72 61 20 69 6e 66 6f  |d for extra info|
00000da0  72 6d 61 74 69 6f 6e 2e  0a 62 79 74 65 73 20 32  |rmation..bytes 2|
00000db0  30 2d 6e 3a 20 22 4d 65  73 73 61 67 65 2d 49 44  |0-n: "Message-ID|
00000dc0  22 20 66 69 65 6c 64 2c  20 66 72 6f 6d 20 61 72  |" field, from ar|
00000dd0  74 69 63 6c 65 20 68 65  61 64 65 72 2c 20 6e 75  |ticle header, nu|
00000de0  6c 6c 2d 74 65 72 6d 69  6e 61 74 65 64 0a 62 79  |ll-terminated.by|
00000df0  74 65 73 20 6e 2d 6d 20  3a 20 22 46 72 6f 6d 22  |tes n-m : "From"|
00000e00  20 66 69 65 6c 64 2e 0a  62 79 74 65 73 20 6d 2d  | field..bytes m-|
00000e10  31 39 39 20 3a 20 22 53  75 62 6a 65 63 74 20 66  |199 : "Subject f|
00000e20  69 65 6c 64 2e 0a 0a 72  65 63 6f 72 64 20 74 79  |ield...record ty|
00000e30  70 65 20 31 3a 0a 62 79  74 65 73 20 38 2d 31 31  |pe 1:.bytes 8-11|
00000e40  3a 20 61 72 74 69 63 6c  65 20 64 61 74 65 20 28  |: article date (|
00000e50  66 6f 72 6d 61 74 20 43  45 59 52 4d 4e 44 59 29  |format CEYRMNDY)|
00000e60  0a 62 79 74 65 73 20 31  32 2d 31 39 3a 20 72 65  |.bytes 12-19: re|
00000e70  73 65 72 76 65 64 20 66  6f 72 20 65 78 74 72 61  |served for extra|
00000e80  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 2e 0a 62 79  | information..by|
00000e90  74 65 73 20 32 30 2d 6e  3a 20 22 4d 65 73 73 61  |tes 20-n: "Messa|
00000ea0  67 65 2d 49 44 22 20 66  69 65 6c 64 2c 20 66 72  |ge-ID" field, fr|
00000eb0  6f 6d 20 61 72 74 69 63  6c 65 20 68 65 61 64 65  |om article heade|
00000ec0  72 2c 20 6e 75 6c 6c 2d  74 65 72 6d 69 6e 61 74  |r, null-terminat|
00000ed0  65 64 0a 62 79 74 65 73  20 6e 2d 6d 20 3a 20 22  |ed.bytes n-m : "|
00000ee0  46 72 6f 6d 22 20 66 69  65 6c 64 2e 0a 62 79 74  |From" field..byt|
00000ef0  65 73 20 6d 2d 6f 20 3a  20 22 53 75 62 6a 65 63  |es m-o : "Subjec|
00000f00  74 20 66 69 65 6c 64 2e  0a 62 79 74 65 73 20 6f  |t field..bytes o|
00000f10  2d 31 39 39 3a 20 22 52  65 66 65 72 65 6e 63 65  |-199: "Reference|
00000f20  73 22 20 66 69 65 6c 64  2e 0a 0a 72 65 63 6f 72  |s" field...recor|
00000f30  64 20 74 79 70 65 20 32  3a 0a 62 79 74 65 73 20  |d type 2:.bytes |
00000f40  38 2d 31 39 3a 20 75 6e  75 73 65 64 0a 62 79 74  |8-19: unused.byt|
00000f50  65 73 20 32 30 2d 31 39  39 3a 20 22 52 65 66 65  |es 20-199: "Refe|
00000f60  72 65 6e 63 65 73 22 20  66 69 65 6c 64 2e 0a 0a  |rences" field...|
00000f70  46 69 65 6c 64 73 20 6d  61 79 20 62 65 20 74 72  |Fields may be tr|
00000f80  75 6e 63 61 74 65 64 20  69 66 20 74 68 65 79 20  |uncated if they |
00000f90  64 6f 20 6e 6f 74 20 66  69 74 20 77 69 74 68 69  |do not fit withi|
00000fa0  6e 20 74 68 65 20 72 65  63 6f 72 64 20 73 70 61  |n the record spa|
00000fb0  63 65 20 61 76 61 69 6c  61 62 6c 65 2e 0a 49 66  |ce available..If|
00000fc0  20 6e 6f 20 6d 65 73 73  61 67 65 20 49 44 20 69  | no message ID i|
00000fd0  73 20 61 76 61 69 6c 61  62 6c 65 20 69 6e 20 74  |s available in t|
00000fe0  68 65 20 61 72 74 69 63  6c 65 20 68 65 61 64 65  |he article heade|
00000ff0  72 2c 20 69 74 20 69 73  20 72 65 70 6c 61 63 65  |r, it is replace|
00001000  64 20 77 69 74 68 0a 22  3c 30 3e 22 2c 20 69 6e  |d with."<0>", in|
00001010  20 61 63 63 6f 72 64 61  6e 63 65 20 77 69 74 68  | accordance with|
00001020  20 52 46 43 39 37 37 2e  0a 0a 43 72 69 74 65 72  | RFC977...Criter|
00001030  69 61 20 66 6f 72 20 64  65 73 69 67 6e 20 6f 66  |ia for design of|
00001040  20 72 65 63 6f 72 64 20  73 74 72 75 63 74 75 72  | record structur|
00001050  65 2d 0a 20 31 2e 20 4d  75 73 74 20 62 65 20 65  |e-. 1. Must be e|
00001060  61 73 79 20 74 6f 20 61  63 63 65 73 73 2c 20 61  |asy to access, a|
00001070  6e 64 20 66 61 73 74 20  74 6f 20 61 64 64 20 61  |nd fast to add a|
00001080  6e 64 20 72 65 6d 6f 76  65 20 72 65 63 6f 72 64  |nd remove record|
00001090  73 2c 20 65 76 65 6e 20  66 72 6f 6d 0a 20 20 20  |s, even from.   |
000010a0  20 42 41 53 49 43 2e 20  46 69 78 65 64 20 72 65  | BASIC. Fixed re|
000010b0  63 6f 72 64 20 73 69 7a  65 20 61 76 6f 69 64 73  |cord size avoids|
000010c0  20 64 6f 69 6e 67 20 61  6e 79 20 73 69 67 6e 69  | doing any signi|
000010d0  66 69 63 61 6e 74 20 70  72 6f 63 65 73 73 69 6e  |ficant processin|
000010e0  67 2e 0a 20 32 2e 20 41  72 74 69 63 6c 65 20 69  |g.. 2. Article i|
000010f0  6e 66 6f 72 6d 61 74 69  6f 6e 20 69 73 20 64 65  |nformation is de|
00001100  73 74 69 6e 69 65 64 20  74 6f 20 62 65 20 70 61  |stinied to be pa|
00001110  73 73 65 64 20 74 6f 20  61 20 63 6c 69 65 6e 74  |ssed to a client|
00001120  20 70 72 6f 67 72 61 6d  20 76 69 61 20 77 69 6d  | program via wim|
00001130  70 0a 20 20 20 20 6d 65  73 73 61 67 65 73 2e 20  |p.    messages. |
00001140  54 68 65 20 22 41 72 74  69 63 6c 65 20 69 6e 66  |The "Article inf|
00001150  6f 22 20 6d 65 73 73 61  67 65 20 70 61 73 73 65  |o" message passe|
00001160  73 20 74 68 65 20 66 6f  6c 6c 6f 77 69 6e 67 20  |s the following |
00001170  69 6e 66 6f 72 6d 61 74  69 6f 6e 3a 0a 20 20 20  |information:.   |
00001180  20 61 72 74 69 63 6c 65  20 6e 75 6d 62 65 72 2c  | article number,|
00001190  20 66 72 6f 6d 2c 20 61  6e 64 20 73 75 62 6a 65  | from, and subje|
000011a0  63 74 2e 20 54 68 65 20  6d 61 78 69 6d 75 6d 20  |ct. The maximum |
000011b0  61 6d 6f 75 6e 74 20 6f  66 20 64 61 74 61 0a 20  |amount of data. |
000011c0  20 20 20 74 68 61 74 20  63 61 6e 20 62 65 20 70  |   that can be p|
000011d0  61 73 73 65 64 20 69 6e  20 61 20 77 69 6d 70 20  |assed in a wimp |
000011e0  6d 65 73 73 61 67 65 20  69 73 20 61 62 6f 75 74  |message is about|
000011f0  20 32 33 30 20 62 79 74  65 73 2e 0a 0a 0a 54 68  | 230 bytes....Th|
00001200  69 73 20 73 63 68 65 6d  65 20 77 6f 72 6b 73 20  |is scheme works |
00001210  77 65 6c 6c 20 77 69 74  68 20 73 6d 61 6c 6c 20  |well with small |
00001220  6e 75 6d 62 65 72 73 20  6f 66 20 6e 65 77 73 67  |numbers of newsg|
00001230  72 6f 75 70 73 20 28 31  35 30 20 74 65 73 74 65  |roups (150 teste|
00001240  64 20 62 75 74 20 6d 6f  72 65 0a 73 68 6f 75 6c  |d but more.shoul|
00001250  64 20 73 63 61 6c 65 20  66 61 69 72 6c 79 20 6c  |d scale fairly l|
00001260  69 6e 65 61 72 6c 79 29  20 61 6e 64 2c 20 77 69  |inearly) and, wi|
00001270  74 68 20 74 68 65 20 6e  65 77 20 64 69 72 65 63  |th the new direc|
00001280  74 6f 72 79 20 73 74 72  75 63 74 75 72 65 20 6f  |tory structure o|
00001290  66 0a 4e 65 77 73 62 61  73 65 20 30 2e 34 33 2c  |f.Newsbase 0.43,|
000012a0  20 6d 6f 72 65 20 74 68  61 6e 20 32 30 30 30 20  | more than 2000 |
000012b0  61 72 74 69 63 6c 65 73  20 70 65 72 20 67 72 6f  |articles per gro|
000012c0  75 70 2e 20 42 65 74 74  65 72 20 6d 65 6d 6f 72  |up. Better memor|
000012d0  79 20 6d 61 6e 61 67 65  6d 65 6e 74 0a 77 69 6c  |y management.wil|
000012e0  6c 20 62 65 20 6e 65 65  64 65 64 20 77 69 74 68  |l be needed with|
000012f0  69 6e 20 4e 65 77 73 42  61 73 65 20 74 6f 20 64  |in NewsBase to d|
00001300  65 61 6c 20 77 69 74 68  20 6d 61 6e 79 20 6d 6f  |eal with many mo|
00001310  72 65 20 67 72 6f 75 70  73 2c 20 62 75 74 20 74  |re groups, but t|
00001320  68 61 74 20 69 73 20 61  6e 0a 69 6e 74 65 72 6e  |hat is an.intern|
00001330  61 6c 20 69 6d 70 6c 65  6d 65 6e 74 61 74 69 6f  |al implementatio|
00001340  6e 20 69 73 73 75 65 2e  20 53 65 65 20 74 68 65  |n issue. See the|
00001350  20 66 69 6c 65 20 22 54  75 6e 69 6e 67 22 20 66  | file "Tuning" f|
00001360  6f 72 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 20 6f  |or information o|
00001370  6e 20 68 6f 77 0a 74 6f  20 74 61 69 6c 6f 72 20  |n how.to tailor |
00001380  6e 65 77 73 62 61 73 65  20 66 6f 72 20 6c 61 72  |newsbase for lar|
00001390  67 65 72 20 6e 65 77 73  66 65 65 64 73 2e 0a 0a  |ger newsfeeds...|
000013a0  0a 54 68 65 20 66 72 6f  6d 20 61 6e 64 20 73 75  |.The from and su|
000013b0  62 6a 65 63 74 20 73 74  72 69 6e 67 73 20 72 65  |bject strings re|
000013c0  74 75 72 6e 65 64 20 62  79 20 22 4c 69 73 74 41  |turned by "ListA|
000013d0  72 74 69 63 6c 65 73 22  20 61 72 65 20 6c 65 6e  |rticles" are len|
000013e0  67 74 68 20 6c 69 6d 69  74 65 64 0a 61 6e 64 20  |gth limited.and |
000013f0  69 6e 74 65 6e 64 65 64  20 66 6f 72 20 64 69 73  |intended for dis|
00001400  70 6c 61 79 20 28 69 6e  20 61 72 74 69 63 6c 65  |play (in article|
00001410  20 63 61 74 61 6c 6f 67  75 65 73 29 20 6f 6e 6c  | catalogues) onl|
00001420  79 2e 20 55 73 65 20 74  68 65 20 66 69 65 6c 64  |y. Use the field|
00001430  73 0a 64 69 72 65 63 74  6c 79 20 66 72 6f 6d 20  |s.directly from |
00001440  74 68 65 20 61 72 74 69  63 6c 65 20 68 65 61 64  |the article head|
00001450  65 72 73 20 66 6f 72 20  67 65 6e 65 72 61 74 69  |ers for generati|
00001460  6e 67 20 72 65 70 6c 69  65 73 2c 20 65 74 63 2e  |ng replies, etc.|
00001470  0a 0a 52 65 66 65 72 65  6e 63 65 73 20 68 65 61  |..References hea|
00001480  64 65 72 73 20 73 74 6f  72 65 64 20 69 6e 20 74  |ders stored in t|
00001490  68 65 20 69 6e 64 65 78  20 66 69 6c 65 20 61 72  |he index file ar|
000014a0  65 20 6c 69 6d 69 74 65  64 20 74 6f 20 32 30 30  |e limited to 200|
000014b0  20 63 68 61 72 61 63 74  65 72 73 0a 6d 61 78 2e  | characters.max.|
000014c0  20 49 66 20 61 20 72 65  66 65 72 65 6e 63 65 73  | If a references|
000014d0  20 6c 69 73 74 20 69 73  20 6c 6f 6e 67 65 72 20  | list is longer |
000014e0  74 68 61 6e 20 74 68 69  73 2c 20 6e 65 77 73 62  |than this, newsb|
000014f0  61 73 65 20 77 69 6c 6c  20 61 74 74 65 6d 70 74  |ase will attempt|
00001500  20 74 6f 0a 73 74 6f 72  65 20 69 74 20 69 6e 74  | to.store it int|
00001510  65 6c 6c 69 67 65 6e 74  6c 79 20 62 79 20 6f 6d  |elligently by om|
00001520  69 74 74 69 6e 67 20 72  65 66 65 72 65 6e 63 65  |itting reference|
00001530  73 20 66 72 6f 6d 20 74  68 65 20 6d 69 64 64 6c  |s from the middl|
00001540  65 20 6f 66 20 74 68 65  20 6c 69 73 74 20 73 6f  |e of the list so|
00001550  0a 61 73 20 74 6f 20 70  72 65 73 65 72 76 65 20  |.as to preserve |
00001560  69 6e 66 6f 72 6d 61 74  69 6f 6e 20 61 62 6f 75  |information abou|
00001570  74 20 74 68 65 20 6f 72  69 67 69 6e 61 6c 20 61  |t the original a|
00001580  6e 64 20 6d 6f 73 74 20  72 65 63 65 6e 74 20 70  |nd most recent p|
00001590  61 72 65 6e 74 0a 61 72  74 69 63 6c 65 73 2e 20  |arent.articles. |
000015a0  54 68 69 73 20 73 68 6f  75 6c 64 20 70 65 72 6d  |This should perm|
000015b0  69 74 20 61 64 65 71 75  61 74 65 20 74 68 72 65  |it adequate thre|
000015c0  61 64 69 6e 67 20 6f 66  20 61 72 74 69 63 6c 65  |ading of article|
000015d0  73 2e 0a 0a 54 68 65 20  70 61 74 68 6e 61 6d 65  |s...The pathname|
000015e0  20 72 65 74 75 72 6e 65  64 20 62 79 20 22 61 72  | returned by "ar|
000015f0  74 69 63 6c 65 20 67 65  74 22 20 73 68 6f 75 6c  |ticle get" shoul|
00001600  64 20 62 65 20 75 73 65  64 20 6f 6e 63 65 20 61  |d be used once a|
00001610  6e 64 20 6e 6f 74 20 73  74 6f 72 65 64 0a 61 63  |nd not stored.ac|
00001620  72 6f 73 73 20 63 61 6c  6c 73 20 74 6f 20 57 69  |ross calls to Wi|
00001630  6d 70 5f 50 6f 6c 6c 2e  20 49 74 20 69 73 20 70  |mp_Poll. It is p|
00001640  6f 73 73 69 62 6c 65 20  66 6f 72 20 61 72 74 69  |ossible for arti|
00001650  63 6c 65 20 66 69 6c 65  73 20 74 6f 20 6d 6f 76  |cle files to mov|
00001660  65 20 77 69 74 68 6f 75  74 0a 6e 6f 74 69 66 69  |e without.notifi|
00001670  63 61 74 69 6f 6e 20 28  67 65 6e 65 72 61 6c 6c  |cation (generall|
00001680  79 20 6f 6e 6c 79 20 61  74 20 64 65 62 61 74 63  |y only at debatc|
00001690  68 20 6f 72 20 65 78 70  69 72 79 20 74 69 6d 65  |h or expiry time|
000016a0  29 0a 0a 22 41 72 74 69  63 6c 65 20 64 65 6c 65  |).."Article dele|
000016b0  74 65 22 20 69 73 20 69  6e 63 6c 75 64 65 64 20  |te" is included |
000016c0  74 6f 20 63 6f 6d 70 6c  65 74 65 20 74 68 65 20  |to complete the |
000016d0  63 6f 6d 6d 61 6e 64 20  73 65 74 2c 20 62 75 74  |command set, but|
000016e0  20 73 68 6f 75 6c 64 0a  70 72 6f 62 61 62 6c 79  | should.probably|
000016f0  20 6e 6f 74 20 62 65 20  75 73 65 64 20 69 6e 20  | not be used in |
00001700  61 20 6d 75 6c 74 69 70  6c 65 2d 72 65 61 64 65  |a multiple-reade|
00001710  72 20 65 6e 76 69 72 6f  6e 6d 65 6e 74 2e 20 49  |r environment. I|
00001720  74 20 77 69 6c 6c 20 6e  6f 74 20 62 65 0a 65 66  |t will not be.ef|
00001730  66 65 63 74 69 76 65 20  61 67 61 69 6e 73 74 20  |fective against |
00001740  6c 6f 63 6b 65 64 20 61  72 74 69 63 6c 65 73 2e  |locked articles.|
00001750  20 4f 6e 65 20 73 69 74  75 61 74 69 6f 6e 20 77  | One situation w|
00001760  68 65 72 65 20 74 68 65  20 66 75 6e 63 74 69 6f  |here the functio|
00001770  6e 20 6d 69 67 68 74 0a  62 65 20 75 73 65 66 75  |n might.be usefu|
00001780  6c 20 69 73 20 74 6f 20  64 65 6c 65 74 65 20 70  |l is to delete p|
00001790  65 72 73 6f 6e 61 6c 20  65 6d 61 69 6c 20 2d 20  |ersonal email - |
000017a0  69 6e 20 74 68 69 73 20  73 69 74 75 61 74 69 6f  |in this situatio|
000017b0  6e 2c 20 64 65 6c 65 74  69 6f 6e 20 77 69 6c 6c  |n, deletion will|
000017c0  0a 61 6c 77 61 79 73 20  62 65 20 70 65 72 6d 69  |.always be permi|
000017d0  74 74 65 64 2e 20 46 6f  72 20 6f 74 68 65 72 20  |tted. For other |
000017e0  67 72 6f 75 70 73 2c 20  64 65 6c 65 74 69 6f 6e  |groups, deletion|
000017f0  20 6d 61 79 20 62 65 20  64 69 73 61 62 6c 65 64  | may be disabled|
00001800  20 61 73 20 61 0a 6e 65  77 73 62 61 73 65 20 63  | as a.newsbase c|
00001810  6f 6e 66 69 67 75 72 61  74 69 6f 6e 20 6f 70 74  |onfiguration opt|
00001820  69 6f 6e 2e 0a 0a 49 74  20 69 73 20 74 68 65 20  |ion...It is the |
00001830  72 65 73 70 6f 6e 73 69  62 69 6c 69 74 79 20 6f  |responsibility o|
00001840  66 20 74 68 65 20 6e 65  77 73 62 61 73 65 20 63  |f the newsbase c|
00001850  6c 69 65 6e 74 20 74 6f  20 74 72 61 63 6b 20 77  |lient to track w|
00001860  68 69 63 68 20 61 72 74  69 63 6c 65 73 20 61 6e  |hich articles an|
00001870  64 0a 67 72 6f 75 70 73  20 61 20 72 65 61 64 65  |d.groups a reade|
00001880  72 20 69 73 20 69 6e 74  65 72 65 73 74 65 64 20  |r is interested |
00001890  69 6e 2c 20 6f 72 20 68  61 73 20 72 65 61 64 2e  |in, or has read.|
000018a0  0a 0a 22 41 72 74 69 63  6c 65 20 6c 6f 63 6b 22  |.."Article lock"|
000018b0  20 70 72 65 76 65 6e 74  73 20 61 6e 20 61 72 74  | prevents an art|
000018c0  69 63 6c 65 20 66 72 6f  6d 20 62 65 69 6e 67 20  |icle from being |
000018d0  64 65 6c 65 74 65 64 20  6f 72 20 65 78 70 69 72  |deleted or expir|
000018e0  65 64 2c 20 72 65 67 61  72 64 6c 65 73 73 0a 6f  |ed, regardless.o|
000018f0  66 20 65 78 70 69 72 79  20 64 61 74 65 2e 0a 0a  |f expiry date...|
00001900  4d 61 69 6c 20 62 61 74  63 68 65 73 20 61 72 65  |Mail batches are|
00001910  20 6d 69 73 74 61 6b 65  6e 6c 79 20 73 70 6c 69  | mistakenly spli|
00001920  74 20 6f 6e 20 6c 69 6e  65 73 20 73 74 61 72 74  |t on lines start|
00001930  69 6e 67 20 22 46 72 6f  6d 20 22 2e 20 54 68 65  |ing "From ". The|
00001940  20 65 78 74 72 61 20 62  69 74 0a 6f 66 20 6d 65  | extra bit.of me|
00001950  73 73 61 67 65 20 69 73  20 73 61 76 65 64 20 74  |ssage is saved t|
00001960  6f 20 45 6d 61 69 6c 2e  70 6f 73 74 6d 61 73 74  |o Email.postmast|
00001970  65 72 20 28 70 72 6f 62  6c 65 6d 20 6d 61 69 6c  |er (problem mail|
00001980  29 20 77 69 74 68 20 61  20 73 75 69 74 61 62 6c  |) with a suitabl|
00001990  65 0a 73 75 62 6a 65 63  74 20 28 6e 6f 20 72 65  |e.subject (no re|
000019a0  63 69 70 69 65 6e 74 3f  29 20 72 61 74 68 65 72  |cipient?) rather|
000019b0  20 74 68 61 6e 20 69 6e  74 6f 20 61 20 67 72 6f  | than into a gro|
000019c0  75 70 20 22 45 6d 61 69  6c 22 20 61 73 20 63 75  |up "Email" as cu|
000019d0  72 72 65 6e 74 6c 79 2e  0a 55 73 69 6e 67 20 74  |rrently..Using t|
000019e0  68 65 20 6b 61 39 71 20  74 72 61 6e 73 70 6f 72  |he ka9q transpor|
000019f0  74 2c 20 74 68 69 73 20  69 73 20 6f 6e 6c 79 20  |t, this is only |
00001a00  73 65 65 6e 20 77 69 74  68 20 50 4f 50 20 28 53  |seen with POP (S|
00001a10  4d 54 50 20 61 6c 74 65  72 73 20 74 68 65 73 65  |MTP alters these|
00001a20  0a 6c 69 6e 65 73 20 74  6f 20 22 3e 46 72 6f 6d  |.lines to ">From|
00001a30  20 22 29 2e 20 54 68 69  73 20 63 61 6e 20 62 65  | "). This can be|
00001a40  20 61 76 6f 69 64 65 64  20 62 79 20 75 73 69 6e  | avoided by usin|
00001a50  67 20 5e 41 20 6f 72 20  22 23 21 20 72 6d 61 69  |g ^A or "#! rmai|
00001a60  6c 22 20 73 65 70 61 72  61 74 6f 72 73 2e 0a     |l" separators..|
00001a6f