Commit 1addff47 authored by Per Cederqvist's avatar Per Cederqvist

(Predefined Aux-Item Types): Added lots of things that aux-items can be set on:

	    cross-reference += letterbox
	    redirect += letterbox
	    x-face += letterbox, server
	    alternate-name += letterbox
	    mx-allow-filter += letterbox
	    mx-reject-forward += letterbox
	    allowed-content-type += letterbox, server
Updated the description of the allowed-content-type aux item.
parent b0c4a010
...@@ -2,7 +2,7 @@ ...@@ -2,7 +2,7 @@
@c @c
@c FIXME: Explain how the garb works with nice and keep-commented @c FIXME: Explain how the garb works with nice and keep-commented
@c @c
@c $Id: Protocol-A.texi,v 1.98 2000/09/03 19:53:14 ceder Exp $ @c $Id: Protocol-A.texi,v 1.99 2000/09/03 22:27:23 ceder Exp $
@c %**start of header @c %**start of header
@setfilename protocol-a.info @setfilename protocol-a.info
@settitle LysKOM Protocol A @settitle LysKOM Protocol A
...@@ -856,7 +856,7 @@ An item of this type will never be inherited, can always be deleted, is ...@@ -856,7 +856,7 @@ An item of this type will never be inherited, can always be deleted, is
never anonymous and is never secret. never anonymous and is never secret.
@item cross-reference [3] (text, conference) @item cross-reference [3] (text, conference, letterbox)
Data is a cross-reference to something else. The contents consist of a Data is a cross-reference to something else. The contents consist of a
letter, a number, and optionally a space and a descriptive text. The letter, a number, and optionally a space and a descriptive text. The
letter must be one letter must be one
...@@ -911,7 +911,7 @@ The hide-creator, secret and inherit bits are automatically cleared. ...@@ -911,7 +911,7 @@ The hide-creator, secret and inherit bits are automatically cleared.
Once created an item of this type cannot be deleted. Once created an item of this type cannot be deleted.
@item redirect [8] (conference) @item redirect [8] (conference, letterbox)
This item indicates that texts should not be sent to the conference, This item indicates that texts should not be sent to the conference,
but be directed to some other target instead. Clients should notify but be directed to some other target instead. Clients should notify
...@@ -931,7 +931,7 @@ secret bits are cleared automatically. Only one redirect can be ...@@ -931,7 +931,7 @@ secret bits are cleared automatically. Only one redirect can be
specified. specified.
@item x-face [9] (conference) @item x-face [9] (conference, letterbox, server)
Data is the face of the person in compface format. Cool, innit? Data is the face of the person in compface format. Cool, innit?
...@@ -940,7 +940,7 @@ a mailbox, the person attached to the mailbox. The hide-creator and ...@@ -940,7 +940,7 @@ a mailbox, the person attached to the mailbox. The hide-creator and
secret bits are cleared automatically. secret bits are cleared automatically.
@item alternate-name [10] (text, conference) @item alternate-name [10] (text, conference, letterbox)
Data is a string that the client may use as an alternate to the name of Data is a string that the client may use as an alternate to the name of
a conference or the subject of a text. Note that the server does not a conference or the subject of a text. Note that the server does not
...@@ -1107,13 +1107,13 @@ they appear in the message. ...@@ -1107,13 +1107,13 @@ they appear in the message.
Clients are encouraged to provide a command to display this information. Clients are encouraged to provide a command to display this information.
@item mx-allow-filter [25] (conference) @item mx-allow-filter [25] (conference, letterbox)
This aux-item has been declared obsolete. It was intended to supply This aux-item has been declared obsolete. It was intended to supply
the importer with information on how to filter incoming messages the importer with information on how to filter incoming messages
based on regular expressions matching header lines. based on regular expressions matching header lines.
@item mx-reject-forward [26] (conference) @item mx-reject-forward [26] (conference, letterbox)
This aux-item has been declared obsolete. It was intended This aux-item has been declared obsolete. It was intended
to supplement mx-allow-filter by telling where rejected mails should to supplement mx-allow-filter by telling where rejected mails should
...@@ -1167,22 +1167,26 @@ This is a recommendation only; it is up to the client that creates a new ...@@ -1167,22 +1167,26 @@ This is a recommendation only; it is up to the client that creates a new
person to also add him to the conferences that are specified via person to also add him to the conferences that are specified via
@code{recommended-conf}. @code{recommended-conf}.
@item allowed-content-type [30] (conference) @item allowed-content-type [30] (conference, letterbox, server)
@c FIXME: see comments to 5323623.
Data is a non-negative decimal priority number, followed by a space, Data is a non-negative decimal priority number, followed by a space,
followed by a LysKOM content type glob pattern. Clients should send followed by a LysKOM content type glob pattern. Clients should send
texts to a conference only if the content-type matches any of the texts to a conference only if the content-type matches any of the
allowed-content-type glob patterns. @code{allowed-content-type} glob patterns of that conference.
If the conference doesn't have any @code{allowed-content-type}, the
@code{allowed-content-type} items of the server should be used. If the
server also has no @code{allowed-content-type} aux-items, it should be
interpreted as if a single @code{allowed-content-type} aux-item with the
value @samp{1 text/plain} exists.
If there are allowed-content-type aux-items with different priority If there are @code{allowed-content-type} aux-items with different
numbers, it is a hint to the client about which content-type is most priority numbers, it is a hint to the client about which content-type is
desirable. Content-types that matches a lower priority number are most desirable. Content-types that matches a lower priority number are
preferred. preferred.
As an example, consider a conference with the following four As an example, consider a conference with the following four
allowed-content-type aux-items: @code{allowed-content-type} aux-items:
@example @example
1 text/plain 1 text/plain
...@@ -1191,14 +1195,11 @@ allowed-content-type aux-items: ...@@ -1191,14 +1195,11 @@ allowed-content-type aux-items:
3 text/* 3 text/*
@end example @end example
This means that text/plain is preferred, that x-kom/basic and This means that @samp{text/plain} is preferred, that @samp{x-kom/basic}
text/enriched can be used if there is a reason why text/plain is and @samp{text/enriched} can be used if there is a reason why
inadequate, and that any text type (such as text/html) is acceptable. @samp{text/plain} is inadequate, and that any text type (such as
Other content types, such as x-kom/user-area, should not be used. @samp{text/html}) is acceptable. Other content types, such as
@samp{x-kom/user-area}, should not be used.
If no allowed-content-type aux-item exists, it should be interpreted as
if a single allowed-content-type aux-item with the value @samp{1
text/plain} exists.
The server does not currently enforce the above restriction on the The server does not currently enforce the above restriction on the
content type of new texts. This mechanism is currently a hint to the content type of new texts. This mechanism is currently a hint to the
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment