.TH sll 1 
.SH Name
sll \- search through the list of mailing lists
.SH Syntax
.B
sll [
.PN listfile
]
.SH Summary
.PN SLL 
accesses a database containing information on numerous electronic
mailing lists.  It provides a full-screen interactive user interface.
.SH Options
.TP
.PN listfile
Use the specified file as the list-of-lists database.  This may be
useful if the database is not found in the default location or
if you have a subset of the lists in a seperate file.  Sub-lists
can be generated by the 
.PN grep 
command, as each list entry is on a seperate line.
.SH Description
There are two primary screens in 
.PN SLL:
The search criteria screen and the list-display screen.
 
The search criteria screen is where you specify what lists to
look at in the list-display screens.  There are three fields
that you may search on:  Category, Title, and Description.
The tab key is used to move between fields and enter is used
to perform the search.  Note that searches on the title field
actually search on the descriptive title, not the official
list title.
 
If the search matches more than 100 lists, the program will
ask the user if he wishes to continue the search.
 
The list display screen is used to view the list information and
mark interesting lists.  The menu provides options that act on the
marked lists.  The options are:
.TP
Subscribe
Invoke 
.PN mail 
and send a message to the subscribe address.
The program will try to determine your real name and then prompt
for verification or correction.  The message will have the subject
line and body of the message stating "SUB listname username."
.TP
Un-subscribe
Invoke 
.PN mail 
and send a message with the subject line and body saying:  "SIGNOFF listname."
.TP
Save to file
Prompts for a filename and then saves the marked lists in a format
that is similar to that of the list display screen.  Seperate lists
are seperated by a ^L character (form-feed) on an otherwise blank line.
.TP
Mark all
Marks all the lists that matched the previous search.
.TP
Unmark all
Unmarks all the lists that are marked.
.SH Limitations
SLL uses the curses windowing packge, and therefore, must know what
type of terminal you are using in order to display properly on your
screen.  If you seem to have problems with the display, you should
make sure to set the variable
.PN term 
to the proper value.
 
In order to avoid accidentally subscribing to hundreds of mailing lists
at once, 
.PN SLL 
only allows you to subscribe to a maximum of 20 lists at a time.
 
Subscriptions cause mail to be sent to the return path that
your mail system automatically generates.  If this address is not
properly generated, you will not be able to use the subscription feature
of this program.
 
The un-subscribe feature will only work if the return path that is generated
matches the one that the subscription was created with.  This means that you
may be required to use the same workstation to cancel a subscription as you
used to create it.  The name of the machine can usually be determined by
looking at the "To:" line in the header of any message sent to you from the
mailing list.
.SH Files
.TP 35
.PN /usr/local/doc/list-of-lists
Default list-of-lists database
.TP
.PN /tmp/pfcXXXXXX
Temporary files (XXXXXX is the PID)
This file is a subset of the regular file.
.SH Author
.PN SLL 
was written by Preston Crow, a graduate student in Computer Science at
Dartmouth College.
.SH Bugs
It appears that there is some problem with using curses in an xterm
window.  You may find that you need to set the 
.PN term 
environment variable to vt100.
 
Please send notification of bugs or comments to:  
.PN Lists@Dartmouth.Edu
.SH Restrictions
Copyright 1992 by the trustees of Dartmouth College. 
All rights reserved.
 
Permission to use, copy, modify and distribute these programs and
their documentation for any purpose and without fee is hereby
granted, provided that this copyright notice and permission
appear on all copies and supporting documentation.  The name of the
Trustees of Dartmouth College may not be used in advertising or
publicity relating to distribution of these programs without
specific prior permission.  Neither the Trustees of Dartmouth
College nor the author make representations about the suitability
of this software for any purpose.  It is provided "as is" without
expressed or implied warranty.