Node:add-footnote, Next:, Previous:get-info-old, Up:Protocol Requests



add-footnote [37] (1) Recommended


        add-footnote [37] (( text-no    :       Text-No;
                             footnote-to:       Text-No ))
                -> ( );

Add a footnote link between the text footnote-to and the text text-no (text-no becomes a footnote to the text footnote-to). This call is used to add footnote links after a text has been created. Only the author of both texts is allowed to add the footnote link.

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 37 2 1
        =1
        1 26 1
        =1 2 22 12 17 6 97 4 197 1 5 4 256 1 1 { 5 2 }
        1 26 2
        =1 49 49 18 17 6 97 4 197 1 5 1 52 1
           4 { 0 2 6 1 4 1 9 19 52 18 17 6 97 4 197 1 }

In this example, text number two is added as a footnote 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.
no-such-text
The text text-no or footnote-to does not exist or is secret.
index-out-of-range
The text-no and footnote-to arguments are equal, and the server does not support texts that are footnotes to themselves.
not-author
Not author of footnote-to.
footnote-limit
Text footnote-to already has the maximum number of footnotes.
already-footnote
Text text-no is already a footnote to footnote-to.
already-comment
Text text-no is already a comment to footnote-to, and a text cannot be both a comment and a footnote to the same text.