
"us", which is short for "uqwk selector", is a simple program which
reads a summary file created by uqwk, organizes the article subjects
into threads, lets you browse through the newsgroups and threads picking
the ones you want, and writes a uqwk selection file.

The idea is that you create a summary file on the Unix host using "uqwk
-U...", download the summary file, use us to select the threads you
want, upload the selection file and feed it to "uqwk -E..." so uqwk only
packs the threads you want.

To unpack the tar file, do this:

	zcat us1.0.tar.Z | tar xvf -

If you wish to build the Unix version of us, type:

	make

If that doesn't work, you may have to edit the Makefile or the actual us
source code.

If you plan to run us on a DOS machine, just download the US.EXE file.
If you would like to port us to a different machine, please go right
ahead.  But do let me know about it.

To run us, type:

	us sumfile

where "sumfile" is the name of the summary file you created using "uqwk
-U".

us has two levels.  First you are presented with a list of newsgroups.
Type "h" to list the available commands.  To browse the threads for a
newsgroup, type "y".  You are now at the thread selection level.  The
prompt shows whether or not you have selected the current thread, the
number of articles in the thread, and the subject of the thread.  Again,
type "h" for a list of commands.

There are three ways to exit us, and you should understand the
differences between them:

If you exit with "q", us re-writes the summary file you specified on the
command line, including only the articles you selected.  The actual
article subjects are included, so you can use us on the file again if
you want to.

If you exit with "Q", us again re-writes the summary file with only the
articles you selected, but without the actual subjects.  This creates a
much shorter file, saving upload time, but making it impossible to put
the file through us again.  You should only do this if you are sure you
don't want to browse the file any more.

If you exit with "X", us does not re-write the summary file.  Any
selections you made are ignored.  You can do this if you want to start
over and abandon anything you've done.

us keeps track of which groups it thinks you are done browsing.  Note
that you can manually mark a group as done or not done.  When you leave
us, all information about which groups are done is lost.
_______________________________________________________________________

Steve Belczyk, steve1@genesis.nred.ma.us, seb3@gte.com.

Copyright (C) 1993 by Steve Belczyk.  Permission to use, copy, modify
and distribute this software and its documentation for any purpose and
without fee is hereby granted, provided that the above copyright notice
appear in all copies and that both that copyright notice and this per-
mission notice appear in supporting documentation.  This software is
provided "as is" without expressed or implied warranty.

Many thanks to Dick Grady, grady@world.std.com, for doing the DOS port.
