Node:mark-text, Next:, Previous:get-client-version, Up:Protocol Requests


mark-text [72] (4) Recommended


        mark-text [72] (( text      :   Text-No;
                          mark-type :   INT8 ))
                -> ( );

This call associates the mark mark-type with the text text. The list of marks set by a person can be retrieved using the get-marks call.

Currently, servers do not associate any particular meaning to the different types of marks, but that may change in the future. Currently, servers should not delete texts that have marks, except by user request.

Example: 

        1 23
        =1 0 *
        2 72 110 230
        =2
        3 23
        =3 1 { 110 230 }

This example shows how a person with no marks set sets mark 230 on text number 110. The calls to get-marks show the effect of the call.

Error codes

login-first
Login required before issuing this call.
no-such-text
The text text does not exists or is secret.
permission-denied
No read access to text text.
undefined-person
The person currently logged in does not exist (can't happen error.)
mark-limit
Already the maximum number of marks on text text.