[25768] in Source-Commits
/svn/athena r25220 - in trunk/athena/bin/discuss: debian mclient
daemon@ATHENA.MIT.EDU (Benjamin Kaduk)
Sun Jul 3 18:33:05 2011
Date: Sun, 3 Jul 2011 18:32:59 -0400
From: Benjamin Kaduk <kaduk@MIT.EDU>
Message-Id: <201107032232.p63MWxZH024513@drugstore.mit.edu>
To: source-commits@mit.edu
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Author: kaduk
Date: 2011-07-03 18:32:58 -0400 (Sun, 03 Jul 2011)
New Revision: 25220
Modified:
trunk/athena/bin/discuss/debian/changelog
trunk/athena/bin/discuss/mclient/mkds.8
trunk/athena/bin/discuss/mclient/rmds.8
Log:
In discuss:
* Flesh out mkds.8 and rmds.8 some more.
Modified: trunk/athena/bin/discuss/debian/changelog
===================================================================
--- trunk/athena/bin/discuss/debian/changelog 2011-07-03 04:26:20 UTC (rev 25219)
+++ trunk/athena/bin/discuss/debian/changelog 2011-07-03 22:32:58 UTC (rev 25220)
@@ -1,3 +1,9 @@
+debathena-discuss (10.0.13-0debathena2) unstable; urgency=low
+
+ * Flesh out mkds.8 and rmds.8 some more.
+
+ -- Benjamin Kaduk <kaduk@mit.edu> Sun, 03 Jul 2011 18:31:43 -0400
+
debathena-discuss (10.0.13-0debathena1) unstable; urgency=low
* Update our autogoo for the 21st century.
Modified: trunk/athena/bin/discuss/mclient/mkds.8
===================================================================
--- trunk/athena/bin/discuss/mclient/mkds.8 2011-07-03 04:26:20 UTC (rev 25219)
+++ trunk/athena/bin/discuss/mclient/mkds.8 2011-07-03 22:32:58 UTC (rev 25220)
@@ -11,34 +11,67 @@
.B mkds
.SH DESCRIPTION
.I mkds
-creates a discuss meeting on a specified discuss server, provided the user has permission to do so.
+creates a discuss meeting on a specified discuss server,
+provided the user has permission to do so.
.I mkds
will prompt for the server name, a directory where the meeting should
be stored, the long and short names of the meeting, and whether or not
-the meeting should be public. If the meeting can be successfully
-created, mkds will then prompt for a list of users who should have
-permission to create new transactions in the meeting, and will require
-the creator to enter the initial meeting transaction. Finally, mkds
-will ask whether or not the meeting should be announced.
+the meeting should be public.
+At this point, it attempts to contact the discuss daemon running on the
+discuss server, and an access checked is performed for meeting creation
+(the ``cacl'' file on the server lists authorized users).
+If the meeting can be successfully created and is not a public meeting,
+.I mkds
+will then prompt for a list of users who should have
+permission to create new transactions in the meeting.
+(The user who created the meeting will automatically be given
+chairman permissions.)
+.I mkds
+will then open an editor for
+the creator to enter the initial meeting transaction. Finally,
+.I mkds
+will ask whether or not the meeting should be announced
+(in the new_meetings meeting).
.I mkds
accepts no arguments.
+The meeting created by
+.I mkds
+is a pure discuss meeting in its original form. If it is intended
+to be used as a mail archive, a server maintainer will need to perform
+additional configuration to accept mail for the meeting's alias and
+run
+.I dsmail
+as appropriate.
+
+A meeting created with
+.I mkds
+can be removed with
+\fIrmds\fR.
+
+The cacl file has a similar format to that of a discuss meeting acl;
+the first line contains a number which is the number of entries on the
+acl.
+The subsequent lines contain a list of access bits, a colon,
+and the user they correspond to.
+However, unlike meeting acls, only the 'a' bit is relevant for
+meeting creation.
+
.SH FILES
.ta \w'/var/spool/discuss/cacl 'u
.br
~/.meetings Data file listing meetings that you attend.
.br
/var/spool/discuss/cacl The list of users (Kerberos principals) who
- can create meetings on the server
+ can create meetings on the server.
.SH AUTHORS
Robert French and Ken Raeburn, MIT Student Information Processing Board
.SH "SEE ALSO"
-.PP
-discuss(1)
+discuss(1), dsmail(1), rmds(8)
Modified: trunk/athena/bin/discuss/mclient/rmds.8
===================================================================
--- trunk/athena/bin/discuss/mclient/rmds.8 2011-07-03 04:26:20 UTC (rev 25219)
+++ trunk/athena/bin/discuss/mclient/rmds.8 2011-07-03 22:32:58 UTC (rev 25220)
@@ -4,7 +4,7 @@
.\"
.\"
.\"
-.TH RMDS 8 "16 October 2009" "MIT SIPB"
+.TH RMDS 8 "03 July 2011" "MIT SIPB"
.SH NAME
rmds \- Delete a discuss meeting
.SH SYNOPSIS
@@ -14,27 +14,24 @@
deletes a discuss meeting on a specified discuss server, provided the user has permission to do so.
.I rmds
-will prompt for the server name, a directory where the meeting should
-be stored and the short name of the meeting. The meeting will then be
-deleted, if the user has permission to do so.
+will prompt for the server name, a directory where the meeting
+is found, and the short name of the meeting. The meeting will then be
+deleted, if the user has permission to do so (by virtue of being
+a chairman of the meeting).
.I rmds
accepts no arguments.
.SH FILES
-.ta \w'/var/spool/discuss/cacl 'u
+.ta \w'~/.meetings 'u
.br
~/.meetings Data file listing meetings that you attend.
-.br
-/var/spool/discuss/cacl The list of users (Kerberos principals) who
- can delete meetings on the server
.SH AUTHORS
Robert French and Ken Raeburn, MIT Student Information Processing Board
.SH "SEE ALSO"
-.PP
-discuss(1)
+discuss(1), mkds(8)
