GNU bug report logs - #36417
[PATCH] Document bookmark annotations in Emacs Manual

Previous Next

Full log

View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: 36417 <at> debbugs.gnu.org
Subject: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual
Date: Fri, 28 Jun 2019 17:19:24 +0300

> From: Stefan Kangas <stefan <at> marxist.se>
> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.