Node:Document Edition History, Next:Index, Previous:Protocol Version History, Up:Top
mx-refuse-import [35]. See Aux-Item Types.
New types: Read-Range and Membership (the old
Membership was renamed to Membership-10).
See Membership Information.
Stats and Stats-Description. See Statistics.
Static-Server-Info. See Server Information.
FLOAT. See Simple Data Types.
Status change: The query-read-texts-10 and
get-membership-10 requests are now obsolete. The
set-keep-commented request is now recommended.
New calls:
query-read-texts
get-membership
mark-as-unread
set-read-ranges
get-stats-description
get-stats
get-boottime-info
first-unused-conf-no
first-unused-text-no
find-next-conf-no
find-previous-conf-no
get-scheduling
set-scheduling
set-connection-time-format
local-to-global-reverse
map-created-texts-reverse
New error codes: invalid-range,
invalid-range-list, priority-denied,
weight-denied, weight-zero,
undefined-measurement and bad-bool.
New async messages:
Protocol change: Renamed the reserved1 bit of
Membership-Type to passive-message-invert.
See Membership Information. This affects
async-send-message and send-message.
The following requests can no longer be used until you have logged in:
get-last-text, find-next-text-no and
find-previous-text-no.
You can now modify the type of a recipient with the
add-recipient call if you are the supervisor of either the
author, recipient or sender. The check used to be more restrictive.
Aux-item tags 10200-10299 are now reserved for private test use. See Client-Specific Aux-Item Types.
The following asynchronous messages are also sent to recipients of
texts linked to the relevant text via comment or footnote links:
async-new-text-old, async-deleted-text,
async-new-text, async-new-recipient and
async-sub-recipient.
Two requests can now return more error codes than they used to:
add-comment
already-comment and already-footnote.
add-footnote
already-comment.
The field later-texts-exists in Text-Mapping has been
renamed to more-texts-exists, as this name is more meaningful
for the new requests local-to-global-reverse and
map-created-texts-reverse.
Fixed errors: The description of the error
index-out-of-range was wrong for
add-footnote,missing for create-person-old,
create-person, create-conf-old,
create-conf and create-text-old, and incomplete
for create-text.
async-leave-conf is not sent when the person is deleted,
so don't say that it is.
The documentation for no-of-created-texts in the Person structure
was wrong. See Person.
The documentation for the privilege bits create-conf and
create-pers stated that they are by default on. In fact, they
are by default ignored, but off. See Security.
The example for re-z-lookup was wrong.
An example for lookup-z-name was wrong.
Protocol change: Added a new "language" value to the common block of the user area. See The User Area.
New aux-items: world-readable [34]. See Aux-Item Types.
elisp-client-read-faq [10000] and
elisp-client-rejected-recommendation [10001].
See Some Client-specific Aux-Item Types.
Modified aux-item: send-comments-to [33] may now also
contain an optional recipient type. See Aux-Item Types.
Previously undocumented stuff: The rules for when a membership is visible are now documented. See Membership visibility.
Documented the unread-is-secret flag of Person.
See Personal-Flags.
The documentation for get-person-stat-old
was
improved.
The Message-ID of exported texts is now documented. See Message-ID.
A client should offer to add the author as a recipient of a text he is creating if he isn't a member of any of the recipients. See Recipients of comments.
There should be no linefeed after the last line of a text. See LysKOM Content Types. See Reformattable Text (text/x-kom-basic).
Added a recommendation for how groups of Misc-Info items should
be sorted. See Order of misc-info groups.
Editorial changes: Several spelling errors, typos, et c were fixed.
Distributed with lyskomd 2.0.7.
query-read-texts-10 and get-membership-10 were
wrong. The idle-time field is only affected by the
user-active request, not by all activity (see Session Information).
Protocol change: Expanded the documentation of
super-conf. See Conference Status Types. Simplified the
rules for super-conf; a setting of 0 no longer means anything.
A new section contains a summary of how a client should decide where
to send a comment, and it contains the new rules. Recipients of comments. Most clients already implemented the new rules; the old
rules were overly complex.
New aux-item: send-comments-to [33].
Modified aux-item: faq-text [14] may now be set on a
letterbox.
Previously undocumented stuff: Expanded the documentation of
permitted-submitters. See set-permitted-submitters.
Clarify that a person is a supervisor of himself, except for the
set-supervisor call; see Conferences.
Document the change-name privilege bit; see Security.
Document that last-login is also updated on logout;
see Person Status Types.
Clarify that the address part of redirect [8] is a conference
number.
Compatibility info: Mention that the elisp client used to enter
texts as x-kom/text instead of text/x-kom-basic.
Administrativia: Updated "Future changes" (see Future changes), and mention that we now use Bugzilla to keep track of bugs and feature requests.
Editorial changes: Added some of Texinfo markup and cross references. Several spelling errors, typos, et c were fixed.
Distributed with lyskomd 2.0.6.
old-pwd argument
to set-passwd. The content-type x-kom/basic was renamed
to text/x-kom-basic.
Previously undocumented stuff: Documented several previously
undocumented aspects of the protocol: the hello string used during
connection establishment, the items-to-delete and
items-to-add arguments of modify-system-info, the
type argument of add-member (including the fact that the
invitation membership flag is automatically set in some
circumstances), that a client can issue many requests at once (and
that the replies are sent back in order).
New stuff: Registered the "rkom" user-area block.
New aux-items: The following predefined aux-items were added:
canonical-name [31], mx-list-name [32]
mx-mime-belongs-to [10100], mx-mime-part-in [10101],
mx-mime-misc [10102], mx-envelope-sender [10103] and
mx-mime-file-name [10104]. Those aux-items with a number higher
than 10000 were previously documented in this document, but they now
have the status of predefined aux-items.
Editorial changes: Lots of editorial changes needed to publish an
online version on the web at
http://www.lysator.liu.se/lyskom/protocol/. Many minor syntax
errors corrected, and much missing Texinfo markup added. The document
now makes heavy use of Texinfo macros. Due to bugs in the current
version of texinfo.tex this file cannot currently be typeset
using TeX. (All bugs are reported to the Texinfo maintainers.)
get-membership-old, get-membership-10 and login used to
take an argument of type BITSTRING(a-single-field). The
type has now been changed to BOOL instead, to simplify the
description. The encoding of the protocol is unchanged.
The indices are now joined into a single index. More terms have been added to it. Many sections of text were moved around to make it easier to find information. Some non-normative information was moved to appendices. Removed a few non-normative empty sections.
This edition was published on the web; no lyskomd release was imminent
when the edition was finished. Future editions will also be published
on the web; most of them will likely be published at the same time as
a lyskomd release is made. They will continue to be included in the
lyskomd releases.
allowed-content-type and
recommended-conf aux-items were added. The
mx-allow-filter and mx-reject-forward aux-items are marked
obsolete. Text regarding mail import was improved, based on actual
experience in writing an email importer. Reserved a range of aux-items
for komimportmail. Several minor corrections and clarifications made.
Distributed with lyskomd 2.0.4.
sub-comment was incorrectly marked obsolete. This has been
corrected. Regexps are case sensitive. The Info-Type enumeration was
introduced in the description of the protocol. (Previous versions of
the protocol had broken definitions of add-recipient,
async-new-recipient and async-sub-recipient.) Distributed
with lyskomd 2.0.1.
sub-comment call as
obsolete, and stated that regexp lookup was case insensitive. Both
statements were wrong, and has since been fixed.