Node:add-comment, Next:, Previous:sub-recipient, Up:Protocol Requests


add-comment [32] (1) Recommended


        add-comment [32] (( text-no     :       Text-No;
                            comment-to  :       Text-No ))
                -> ( );

Add a comment link between the text comment-to and the text text-no (text-no becomes a comment to the text comment-to). This call is used to add comment links after a text has been created. The normal procedure for creating comments is to add a comm-to element to the text's misc-info list when the text is created (see The Misc-Info List).

Example: 

        1 26 1
        =1 2 22 12 17 6 97 4 197 1 5 4 256 1 0 *
        1 26 2
        =1 49 49 18 17 6 97 4 197 1 5 1 52 1 2 { 0 2 6 1 }
        1 32 2 1
        =1
        1 26 1
        =1 2 22 12 17 6 97 4 197 1 5 4 256 1 1 { 3 2 }
        1 26 2
        =1 49 49 18 17 6 97 4 197 1 5 1 52 1
           4 { 0 2 6 1 2 1 9 19 52 18 17 6 97 4 197 1 }

In this example, text number two is added as a comment to text number one. The change is reflected in the Misc-Info List of the texts.

Error codes

login-first
Login required before issuing this call.
index-out-of-range
The texts text-no and comment-to are identical. The error-status is text-no.
no-such-text
The text text-no of comment-to are undefined.
comment-limit
The text comment-to already has the maximum number of comments.
already-comment
The text text-no is already a comment of comment-to.
already-footnote
The text text-no is already a footnote of comment-to, and a text cannot be both a comment and a footnote to the same text.