Re: lispref/text.texi "Saving Properties"

[Richard Stallman]

It is good, for the part of the job it does; but the text needs
more change in order to read as a unit.

For instance, the Format Conversion feature uses annotations just like
write-region-annotate-functions.  So the text of the two parts of the
node needs some additional reworking to operate as a whole.  This text

    @item
    By returning a list of annotations.  This is a list of elements of the
    form @code{(@var{position} . @var{string})}, where @var{position} is an
    integer specifying the relative position in the text to be written, and
    @var{string} is the annotation to add there.  The list must be sorted in
    order of position when @var{to-fn} returns it.

    When @code{write-region} actually writes the text from the buffer to the
    file, it intermixes the specified annotations at the corresponding
    positions.  All this takes place without modifying the buffer.

becomes redundant with part of the new text which also defines
annotations; there should be just one definition.

Please read thru the whole text of that node again, looking for other ways
to make it read more naturally as a unified whole.