[moira.git] / man / mailmaint.1

.TH MAILMAINT 1 "28 Jan 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
mailmaint \- maintain mailing lists for a user
.SH SYNOPSIS
.B mailmaint
.SH DESCRIPTION
.I maintmaint
allows a user to examine public mailing lists and add or
remove him/herself from such lists.  It does this using Moira, the Athena
Service Management System.
.PP
When started, it will display a menu with the following options:
.in +5
.nf
1. Show all mailing lists.
2. Get all members of a mailing list.
3. Display lists of which you are a member.
4. Show description of list.
5. Add yourself to a mailing list.
6. Delete yourself from a mailing list.
.in -5
.fi
.PP
The first option will display all mailing lists that are not
explicitly hidden.  The second option will display the members of a
named list.  The third will display the names of the lists you belong
to.  The next option will give a description of any list that you
name.
.PP
The next two options allow you to add or delete yourself to or from
public mailing lists.  If the person creating a mailing list has not
made it public, you will not be allowed to change it.  Even if it is
public, you can only add or delete yourself, you cannot affect the
others on the list.  For other list operations (which are only allowed
to the administrators of a list), see 
.I listmaint(1).
.SH MENU OPERATION
Each of the menus presented works in the same way:  A list of possible
choices is presented, each preceded by a number.  The title of the
function is displayed at the top of the screen, centered, and the
current choice is highlighted.  To make a choice, press the number of
the choice, which will then be highlighted.  To confirm this
choice, press the return key.
.PP
There will usually be a 
.I Quit
option and a 
.I Return to previous level
option available in each menu.  The exception to this is during mailing
list creation; a type for the list must be selected from a menu.
Typing the interrupt character (normally CTRL-C) or the return key
during a database access or while being prompted for a menu
selection will act the same as a
.I Quit.
Typing the interrupt character
during a text input will cancel the operation and return to
the most recent menu.
.PP
If information is needed that cannot be entered via a menu (e.g. a
description of the mailing list's purpose and/or use), the user will be
prompted for such information.
.SH ENVIRONMENT
.TP
KRBTKFILE
path name of your Kerberos ticket.  Moira decides who you are and what you
can do based on your Kerberos tickets, and nothing else.
.TP
TERMCAP
information about the capabilities of the terminal and how to use them.
.SH SEE ALSO
listmaint(1)
.SH AUTHOR
Peter J. Levine, MIT Project Athena
Commit	Line	Data
0aa1c878	1	.TH MAILMAINT 1 "28 Jan 1988" "Project Athena"
	2	\" RCSID: $Header$
	3	.SH NAME
	4	mailmaint \- maintain mailing lists for a user
	5	.SH SYNOPSIS
	6	.B mailmaint
	7	.SH DESCRIPTION
9ed9ebb0	8	.I maintmaint
9ed9ebb0	9	allows a user to examine public mailing lists and add or
b865dabe	10	remove him/herself from such lists. It does this using Moira, the Athena
9b00693b	11	Service Management System.
0aa1c878	12	.PP
	13	When started, it will display a menu with the following options:
	14	.in +5
	15	.nf
	16	1. Show all mailing lists.
	17	2. Get all members of a mailing list.
	18	3. Display lists of which you are a member.
	19	4. Show description of list.
	20	5. Add yourself to a mailing list.
	21	6. Delete yourself from a mailing list.
	22	.in -5
	23	.fi
	24	.PP
9b00693b	25	The first option will display all mailing lists that are not
0aa1c878	26	explicitly hidden. The second option will display the members of a
	27	named list. The third will display the names of the lists you belong
	28	to. The next option will give a description of any list that you
	29	name.
	30	.PP
	31	The next two options allow you to add or delete yourself to or from
	32	public mailing lists. If the person creating a mailing list has not
	33	made it public, you will not be allowed to change it. Even if it is
	34	public, you can only add or delete yourself, you cannot affect the
	35	others on the list. For other list operations (which are only allowed
	36	to the administrators of a list), see
	37	.I listmaint(1).
	38	.SH MENU OPERATION
	39	Each of the menus presented works in the same way: A list of possible
	40	choices is presented, each preceded by a number. The title of the
	41	function is displayed at the top of the screen, centered, and the
	42	current choice is highlighted. To make a choice, press the number of
	43	the choice, which will then be highlighted. To confirm this
	44	choice, press the return key.
	45	.PP
	46	There will usually be a
	47	.I Quit
	48	option and a
	49	.I Return to previous level
	50	option available in each menu. The exception to this is during mailing
	51	list creation; a type for the list must be selected from a menu.
	52	Typing the interrupt character (normally CTRL-C) or the return key
	53	during a database access or while being prompted for a menu
	54	selection will act the same as a
	55	.I Quit.
	56	Typing the interrupt character
	57	during a text input will cancel the operation and return to
	58	the most recent menu.
	59	.PP
	60	If information is needed that cannot be entered via a menu (e.g. a
	61	description of the mailing list's purpose and/or use), the user will be
	62	prompted for such information.
	63	.SH ENVIRONMENT
	64	.TP
	65	KRBTKFILE
b865dabe	66	path name of your Kerberos ticket. Moira decides who you are and what you
0aa1c878	67	can do based on your Kerberos tickets, and nothing else.
	68	.TP
	69	TERMCAP
	70	information about the capabilities of the terminal and how to use them.
	71	.SH SEE ALSO
	72	listmaint(1)
	73	.SH AUTHOR
	74	Peter J. Levine, MIT Project Athena