Subject: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual

From: Eli Zaretskii <[email-masked]>
Date: Fri, 28 Jun 2019 17:19:24 +0300

> From: Stefan Kangas <[email-masked]>
> Date: Fri, 28 Jun 2019 13:51:27 +0200
> 
> +@vindex bookmark-use-annotations
> +@vindex bookmark-automatically-show-annotations

How about "@cindex bookmark annotations" as well?

> +  If you set the variable @code{bookmark-use-annotations} to t,
                                                                ^
@code{t}

> +setting a bookmark will query for an annotation.  The annotation will
> +be automatically shown when you jump to that bookmark.

Please explain what does "show" mean in this context.

> +@code{bookmark-automatically-show-annotations} to nil.
                                                     ^^^
@code{nil}

Btw, what is the use case for using annotations but not showing them?
If that use case is not important enough, perhaps we shouldn't mention
the second option.

Thanks.