Preferences.... should be in a file called .prefs in the same directory as NewsBe.
EMAIL=fred@bloggs.isp.co.uk
REALNAME=Fred Bloggs
EXPIRESAFTER=3
ARTICLEWINDOW=YES
ARTICLEWINFONTSIZE=14
CYRILLIC=NO
HEADERS=SHORT
AUTOEXPIRE=NO
.

EMAIL and REALNAME should be fairly obvious and have to present.

EXPIRESAFTER is the number of days for which newsgroup articles are keep when you choose the Expire News option from the group maintenance menu. This option has to be present.

ARTICLEWINDOW=YES. This option will make NewsBe open an Article Window on start up. The other option is ARTICLEWINDOW=NO. This preference is optional and will default to NO if left out.

ARTICLEWINFONTSIZE=14 sets the font size in the Article window. This is optional too and will use the default plain font size.

CYRILLIC=YES will do a KOI8R conversion on all the articles you read, this is there for testing, if it doesn't work then if someone would point be to a UTF-8 cyrillic font, I'd be very greatful. It's optional and defaults to NO.

HEADERS=SHORT will reduce headers down to Subject, From and Newsgroup where applicable. The other option at the moment is HEADERS=FULL. This option is again optional, and will default to FULL.

AUTOEXPIRE=YES will expire news messages older than EXPIRESAFTER days automatically on exiting NewsBe, this preference is optional and defaults to AUTOEXPIRE=NO

Subscriptions should be in a file called .subs in the same directory as NewsBe.
news.demon.co.uk
 comp.sys.be.misc -1 y
 alt.babylon5.uk -1 y
nntp.futurenet.co.uk
 pcplus.beos -1 y
.

the format is a line with a news server name followed by several lines with newsgroups on them. with a FULL STOP on a seperate line at the end, this is very important mmmokay. The format for the newsgroup lines is...
1) a space.
2) the newsgroup name
3) a space.
4) The highest numbered article in that newsgroup.
5) a space.
6) 'y' or 'n' indicating if posting to that group is allowed (not actually used yet).

if 4) is negative then it attempts to download the last x articles, the number
you get will depend on the number of articles actually available.

Both files must end with newline fullstop newline

.filters is used to filter files, this isn't restricted to news, you can filter any files you wish, just don't expect NwsBe to do anything with them. The good news is that it will work sensibly with e-Mail, it will mark them as read if you read them, or use one of the Group/Thread Read functions, and reply, and forward also work, not that theres any difference between them. New Article still assumes you want to send a new news article, it's still best to use a proper mail client for that sort of thing, and it won't thread them, or sort them, actually I'm not sure about the sort, unread mail does have a tendancy to be a the bottm of the pile, but its not deliberate.

The file format is simple, one line with a name for the filter, its uses this in the group selection pane, and one line for the filter to go with that name and the traditional . on a line by its own to mark the end of file. Don't worry about word wrapping, it'll still work as long as you don't press return.

For those that just want to do easy filters, just use the BeOS find dialog to make a search for the files you want, then change the search to a "search by formula", and just copy the resulting formula to the .filters file.

For the more adventurous souls amongst us he format for the filter is the same format the BeOS API BQuery Class uses, guess how I did it :) A description can be found in the BeBook, try using...

file:///boot/beos/documentation/Be%20Book/The%20Storage%20Kit/Query.html#29556:Zhead3:ZConstructingZaZPredicate

That should be all on one line if you've got word wrap on. Or look up the BeBook online. it should all be familiar to C/C++ programmers, with a bit of wildcarding thrown in.

There's an example file as always, that has filters for unread mail and out going news articles.

I'f you're really brave you'll want to test the secure server support. The format for this is really simple too, each server has 3 lines, the server name, the username, then the password checkout the example file.