Re: (no subject)

[Richard Stallman]

    But `enriched-translations' is defined in enriched.el with a
    def_const_.  This suggest (maybe misleadingly) that the value should
    not be messed with.

Thanks for noticing that.  Please fix that.

    There also is the problem that the text quoted above makes things look
    much simpler than they are.  If one wants to successfully add
    annotations for saving additional text properties, one will have to
    (at least) read through three docstrings, two of which are rather long
    and some parts of which assume at least some familiarity with Elisp
    and with the text/enriched standard.

Could you add xrefs in the doc string for enriched-translations to
point to the other two symbols whose doc strings people need to read?

It might be better to mention this somewhere other than the Emacs Manual,
but there is no logical other place to do it.  I think it is right for the
text in the Emacs manual to be brief and refer people to other sources.