Node:mark-as-unread, Next:set-read-ranges, Previous:get-membership, Up:Protocol Requests

mark-as-unread [109] (11) Recommended

        mark-as-unread [109] (( conference : Conf-No;
                                text       : Local-Text-No ))
                -> ( );

Marks text text in conference number conference as not read for the current user. This call updates the membership record for the user. It can be used to undo the effect of mark-as-read.

Example:

        1 9 6 7
        =1 20 32 11 17 6 96 3 198 1 7 1 241 0 *
        1 78 7
        =1 13HInlägg }t mig 00001000 241 1
        1 27 7 241
        =1
        1 9 6 7
        =1 20 32 11 17 6 96 3 198 1 7 1 240 0 *

This example shows person 6 marking local text number 241 in conference 7 as not read. In the first query-read-texts-old call the person has read local text 241, and nothing higher. The mark-as-read call is reflected in the second query-read-texts-old call, where the user is seen to have read text 240 in conference 7, but nothing higher.

To mark a global text number as not read it is necessary to translate it into local text numbers by looking at the misc-info list in the Text-Stat and calling mark-as-read once for each recipient.

Attempts to mark a deleted text as unread will appear to succeed, but might have no effect, since the server will automatically mark them as read, sooner or later.

Error codes

login-first

Login required before issuing this call.

undefined-conference

The conference conference does not exist or is secret.

conference-zero

conference is zero.

not-member

The person logged on is not a member of conference conference.

no-such-local-text

text is not, and has never been, a local text number in conference. The error argument contains the invalid number.

local-text-zero

text is zero.