From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual Date: Fri, 28 Jun 2019 09:01:20 -0700 (PDT) Message-ID: <7a905121-f6ff-429c-b781-7ff38863aa30@default> References: <> <<83y31lhjwz.fsf@gnu.org>> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="173021"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 36417@debbugs.gnu.org To: Eli Zaretskii , Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jun 28 18:11:45 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hgtTV-000iub-A2 for geb-bug-gnu-emacs@m.gmane.org; Fri, 28 Jun 2019 18:11:45 +0200 Original-Received: from localhost ([::1]:33854 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hgtTU-0007Gk-3i for geb-bug-gnu-emacs@m.gmane.org; Fri, 28 Jun 2019 12:11:44 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34259) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hgtKC-00025Q-8p for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 12:02:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hgtKB-00072S-2m for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 12:02:08 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57545) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hgtK6-0006yK-Qj for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 12:02:06 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hgtK6-0005Zl-Ln for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 12:02:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 28 Jun 2019 16:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 36417 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 36417-submit@debbugs.gnu.org id=B36417.156173769321374 (code B ref 36417); Fri, 28 Jun 2019 16:02:02 +0000 Original-Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 16:01:33 +0000 Original-Received: from localhost ([127.0.0.1]:42856 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgtJc-0005Yg-NL for submit@debbugs.gnu.org; Fri, 28 Jun 2019 12:01:32 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:56288) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgtJb-0005YR-7K for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 12:01:31 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5SFxEP7187515; Fri, 28 Jun 2019 16:01:24 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=vz5VAavJWidGxKUulTwXKD5qtoXzv3RXtJX9X3UMx5g=; b=yDetl6nUHtHaMWg7Hc4gYI1zxFiMFxy0lfW8TFz/thaYN9QnuY81vMzvI1Ry+j4qaeN+ 0eBXgTeUMv4XCOFf4D1TiTjR8o92qhODXi/fW8aZ06pgzKhyBHYjUjw5ThTvrpjvaai1 gZIuRe26P+9niHHjQBajbRyf+rhf65pQD9TC9kBX4EcW/09Cw/A7t66qNXNBspoxlzjI SiqfdoV3WuwVEYBoNspwCb8Cp+5G9eJ1LJIaP7pke6U3zcQ9JIh5ZDngylR2xVuw2rCS 9KBFmJ7pXLQsHsAG8/AGR6dAiQRAKQgRb0/fGbMA5IOxNmW8I23xGi6zC5nvfrzRt4VF 0A== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by userp2130.oracle.com with ESMTP id 2t9brtpg3t-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 28 Jun 2019 16:01:23 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5SG0qmm173861; Fri, 28 Jun 2019 16:01:23 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserp3020.oracle.com with ESMTP id 2t9p6vywmh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 28 Jun 2019 16:01:23 +0000 Original-Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x5SG1Lu6026761; Fri, 28 Jun 2019 16:01:22 GMT In-Reply-To: <<83y31lhjwz.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4861.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9302 signatures=668688 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1906280184 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9302 signatures=668688 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1906280184 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:161742 Archived-At: > 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. Showing a bookmark's annotation means displaying it (in its own buffer). Option `bookmark-automatically-show-annotations' is about _automatically_ showing annotations whenever bookmarks are jumped to. If it is nil then a bookmark's annotation is shown (displayed) only on demand. Option `bookmark-use-annotations" non-nil means that a buffer is opened for you to add an annotation, if none exists, or edit an existing annotation, whenever a bookmark is set. One is about showing annotations when bookmarks are jumped to. The other is about editing (and creating) annotations whenever bookmarks are set (created or updated). It is true that the doc string for `bookmark-use-annotations' mistakenly currently says `saving' instead of `setting'. That, at least, should be corrected.