diff --git a/devel/scheme/buffer/buffer-api.en.tm b/devel/scheme/buffer/buffer-api.en.tm index 13e3eb5..42c0639 100644 --- a/devel/scheme/buffer/buffer-api.en.tm +++ b/devel/scheme/buffer/buffer-api.en.tm @@ -71,20 +71,116 @@ + <\explain> + )> + + )> + <|explain> + Set the contents of the buffer to the rich tree + , get the rich contents of . + + + <\explain> + )> + + )> + <|explain> + Set the main body of the buffer to the tree , + get the main body of . + + + <\explain> + )> + + )> + <|explain> + Set the master of the buffer to , + get the master of . The master of a buffer + should again be a buffer. Usually, the master of a buffer is the buffer + itself. Otherwise, the buffer will behave similarly as its master in some + respects. For instance, if a buffer admits + as its master, then a hyperlink to will + point to and not to . + + + <\explain> + )> + + )> + <|explain> + Set the title of the buffer to the string , + get the title of . The title is for instance + used as the title for the window. + + + <\explain> + )> + + )> + <|explain> + Set the title of the buffer to the string , + get the title of . The title is for instance + used as the title for the window. + + + <\explain> + )> + + )> + <|explain> + Return the time when the buffer was visited or saved last. + + + <\explain> + )> + + )> + <|explain> + The predicate check whether the buffer + was modified since the last time it was saved. The routine + can be used in order to pretend that + thebuffer was saved, without actually saving it. This + can for instance be useful if no worthwhile changes occurred in the + buffer since the genuine last save. + + + Buffers inside usually correspond to actual files on disk or + elsewhere. When changes occur on either side ( when editing the + buffer, or modifying the file on disk using an external program), the + following routines can be used in order to synchronize the buffer inside + with its corresponding file on disk. + <\explain> )> <|explain> Retrieve the buffer from disk (or elsewhere). Returns - on error and otherwise. + on error and otherwise. The format being used for + loading files is chosen as a function of the extension of . <\explain> )> <|explain> Save the buffer to disk (or elsewhere). Returns on - error and otherwise. + error and otherwise. The format being used for saving files is + chosen as a function of the extension of . + + + <\explain> + + )> + <|explain> + Import the buffer from , using the format + . Returns on error and otherwise. <\explain>