From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 08:54:30 2019 Received: (at submit) by debbugs.gnu.org; 28 Jun 2019 12:54:30 +0000 Received: from localhost ([127.0.0.1]:40530 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgqOb-00020k-Vs for submit@debbugs.gnu.org; Fri, 28 Jun 2019 08:54:30 -0400 Received: from lists.gnu.org ([209.51.188.17]:45969) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgqOX-00020b-PR for submit@debbugs.gnu.org; Fri, 28 Jun 2019 08:54:28 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:45124) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hgqOV-0005Mh-QD for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 08:54:25 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hgqOU-0006n6-KI for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 08:54:23 -0400 Received: from mail-wr1-f41.google.com ([209.85.221.41]:44910) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hgqOU-0006lF-DN for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 08:54:22 -0400 Received: by mail-wr1-f41.google.com with SMTP id r16so4318637wrl.11 for ; Fri, 28 Jun 2019 05:54:20 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=Sb6MvnOgCpAM9gog2RafsVGRGLuxHlo4Zm/kVFMrtnk=; b=uSey2znXexIDh+1YXe1Llru70tMzda6JckYNg3f+hSDLpRoohhyVbLyNbhIxZ4T49L hrzttYwfS8SFsAvYdKyf0smggwMGre83BFCDSzo3JVMP3byLrmAuen5kqgVMRDrGQgAL zqykzIcC/kz8Xi8OB/9i4W4hP9Z7D+We06xYQK+BqxB+8pnMfaY7ZPjsCk3U+dfPGatm 1yQArs6lkrifRk7qx0/CbfsIS7S2Oltn6XxnXA46O1sN7KHW7z3LMERctuRnM7fU7mt1 0yMIBh1nsK51DCaf7j6w4ZPzYKZnyG2K3vYecmVShKUS4RdErSLEHsujqZ52ovGrN9Le WaxQ== X-Gm-Message-State: APjAAAXwGgtCTeEKVyRI3ZnAu0odEPAHkfqAzXdvQvrCdCDMtLHO/jcy O11uz3n9FNF70kh/l6c1tUt5ccKE4uywk3JLwcwOAqX1 X-Google-Smtp-Source: APXvYqz1AErcFFN3joWrTBGIdq4+vQnUj4MVJNYVMThAF9s01HOviaHOR7L6e3bNpZCmbg0LJlgwexX2SHaLAh/LX9M= X-Received: by 2002:a5d:4810:: with SMTP id l16mr7107581wrq.48.1561722698661; Fri, 28 Jun 2019 04:51:38 -0700 (PDT) MIME-Version: 1.0 From: Stefan Kangas Date: Fri, 28 Jun 2019 13:51:27 +0200 Message-ID: Subject: [PATCH] Document bookmark annotations in Emacs Manual To: bug-gnu-emacs@gnu.org Content-Type: multipart/mixed; boundary="000000000000b123c3058c60e607" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.221.41 X-Spam-Score: -0.8 (/) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.8 (-) --000000000000b123c3058c60e607 Content-Type: text/plain; charset="UTF-8" bookmark.el has a useful feature to set and show annotations. This is unfortunately not very well documented in the Emacs manual. Please find attached a patch that attempts to document this feature. Thanks, Stefan Kangas --000000000000b123c3058c60e607 Content-Type: text/x-patch; charset="US-ASCII"; name="0001-Document-bookmark-annotations-in-Emacs-Manual.patch" Content-Disposition: attachment; filename="0001-Document-bookmark-annotations-in-Emacs-Manual.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_jxg1c4290 RnJvbSBkMTNjMzU1ZWI3ZDFjYzM0NWFlOTUzYWI5ZGFlZmQ4MWYxMmM4MDE4IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBGcmksIDI4IEp1biAyMDE5IDEzOjQwOjM3ICswMjAwClN1YmplY3Q6IFtQQVRDSF0g RG9jdW1lbnQgYm9va21hcmsgYW5ub3RhdGlvbnMgaW4gRW1hY3MgTWFudWFsCgoqIGRvYy9lbWFj cy9yZWdzLnRleGkgKEJvb2ttYXJrcyk6IERvY3VtZW50IGFubm90YXRpb25zLgoqIGxpc3AvYm9v a21hcmsuZWwgKGJvb2ttYXJrLXVzZS1hbm5vdGF0aW9ucyk6IENsYXJpZnkgZG9jc3RyaW5nLgot LS0KIGRvYy9lbWFjcy9yZWdzLnRleGkgfCA4ICsrKysrKysrCiBsaXNwL2Jvb2ttYXJrLmVsICAg IHwgNSArLS0tLQogMiBmaWxlcyBjaGFuZ2VkLCA5IGluc2VydGlvbnMoKyksIDQgZGVsZXRpb25z KC0pCgpkaWZmIC0tZ2l0IGEvZG9jL2VtYWNzL3JlZ3MudGV4aSBiL2RvYy9lbWFjcy9yZWdzLnRl eGkKaW5kZXggMzcwMjY5NDY0Ny4uNmE1ODQwMzhlZCAxMDA2NDQKLS0tIGEvZG9jL2VtYWNzL3Jl Z3MudGV4aQorKysgYi9kb2MvZW1hY3MvcmVncy50ZXhpCkBAIC0zNTksNiArMzU5LDE0IEBAIEJv b2ttYXJrcwogICBUaGUgdmFyaWFibGUgQGNvZGV7Ym9va21hcmstZGVmYXVsdC1maWxlfSBzcGVj aWZpZXMgdGhlIGZpbGUgaW4KIHdoaWNoIHRvIHNhdmUgYm9va21hcmtzIGJ5IGRlZmF1bHQuCiAK K0B2aW5kZXggYm9va21hcmstdXNlLWFubm90YXRpb25zCitAdmluZGV4IGJvb2ttYXJrLWF1dG9t YXRpY2FsbHktc2hvdy1hbm5vdGF0aW9ucworICBJZiB5b3Ugc2V0IHRoZSB2YXJpYWJsZSBAY29k ZXtib29rbWFyay11c2UtYW5ub3RhdGlvbnN9IHRvIHQsCitzZXR0aW5nIGEgYm9va21hcmsgd2ls bCBxdWVyeSBmb3IgYW4gYW5ub3RhdGlvbi4gIFRoZSBhbm5vdGF0aW9uIHdpbGwKK2JlIGF1dG9t YXRpY2FsbHkgc2hvd24gd2hlbiB5b3UganVtcCB0byB0aGF0IGJvb2ttYXJrLiAgSWYgeW91IHdh bnQgdG8KK3VzZSBhbm5vdGF0aW9ucyBidXQgbm90IHNob3cgdGhlbSBhdXRvbWF0aWNhbGx5LCB5 b3UgY2FuIHNldAorQGNvZGV7Ym9va21hcmstYXV0b21hdGljYWxseS1zaG93LWFubm90YXRpb25z fSB0byBuaWwuCisKIEB2aW5kZXggYm9va21hcmstc2VhcmNoLXNpemUKICAgQm9va21hcmsgcG9z aXRpb24gdmFsdWVzIGFyZSBzYXZlZCB3aXRoIHN1cnJvdW5kaW5nIGNvbnRleHQsIHNvIHRoYXQK IEBjb2Rle2Jvb2ttYXJrLWp1bXB9IGNhbiBmaW5kIHRoZSBwcm9wZXIgcG9zaXRpb24gZXZlbiBp ZiB0aGUgZmlsZSBpcwpkaWZmIC0tZ2l0IGEvbGlzcC9ib29rbWFyay5lbCBiL2xpc3AvYm9va21h cmsuZWwKaW5kZXggMzgxYjkxMjk0NC4uNjhiNzYyZGRkNiAxMDA2NDQKLS0tIGEvbGlzcC9ib29r bWFyay5lbAorKysgYi9saXNwL2Jvb2ttYXJrLmVsCkBAIC0zNiw5ICszNiw2IEBACiAKIDs7OyBN aXNjIGNvbW1lbnRzOgogOzsKLTs7IElmIHZhcmlhYmxlIGJvb2ttYXJrLXVzZS1hbm5vdGF0aW9u cyBpcyBub24tbmlsLCBhbiBhbm5vdGF0aW9uIGlzCi07OyBxdWVyaWVkIGZvciB3aGVuIHNldHRp bmcgYSBib29rbWFyay4KLTs7CiA7OyBUaGUgYm9va21hcmsgbGlzdCBpcyBzb3J0ZWQgbGV4aWNh bGx5IGJ5IGRlZmF1bHQsIGJ1dCB5b3UgY2FuIHR1cm4KIDs7IHRoaXMgb2ZmIGJ5IHNldHRpbmcg Ym9va21hcmstc29ydC1mbGFnIHRvIG5pbC4gIElmIGl0IGlzIG5pbCwgdGhlbgogOzsgdGhlIGxp c3Qgd2lsbCBiZSBwcmVzZW50ZWQgaW4gdGhlIG9yZGVyIGl0IGlzIHJlY29yZGVkCkBAIC01Miw3 ICs0OSw3IEBAIGJvb2ttYXJrCiAKIAogKGRlZmN1c3RvbSBib29rbWFyay11c2UtYW5ub3RhdGlv bnMgbmlsCi0gICJJZiBub24tbmlsLCBzYXZpbmcgYSBib29rbWFyayBxdWVyaWVzIGZvciBhbiBh bm5vdGF0aW9uIGluIGEgYnVmZmVyLiIKKyAgIklmIG5vbi1uaWwsIHNldHRpbmcgYSBib29rbWFy ayBxdWVyaWVzIGZvciBhbiBhbm5vdGF0aW9uIGluIGEgYnVmZmVyLiIKICAgOnR5cGUgJ2Jvb2xl YW4pCiAKIAotLSAKMi4xMS4wCgo= --000000000000b123c3058c60e607-- From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 10:20:09 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 14:20:09 +0000 Received: from localhost ([127.0.0.1]:42733 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgrjV-0004dR-HW for submit@debbugs.gnu.org; Fri, 28 Jun 2019 10:20:09 -0400 Received: from eggs.gnu.org ([209.51.188.92]:32946) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgrjT-0004d6-EL for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 10:20:08 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:56155) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hgrjN-00084e-Rd; Fri, 28 Jun 2019 10:20:01 -0400 Received: from [176.228.60.248] (port=4326 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hgrjK-0007XW-C6; Fri, 28 Jun 2019 10:20:01 -0400 Date: Fri, 28 Jun 2019 17:19:24 +0300 Message-Id: <83y31lhjwz.fsf@gnu.org> From: Eli Zaretskii To: Stefan Kangas In-reply-to: (message from Stefan Kangas on Fri, 28 Jun 2019 13:51:27 +0200) Subject: Re: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36417 Cc: 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Stefan Kangas > 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. From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 11:13:53 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 15:13:53 +0000 Received: from localhost ([127.0.0.1]:42806 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgsZU-0008QY-RR for submit@debbugs.gnu.org; Fri, 28 Jun 2019 11:13:53 -0400 Received: from mail-wm1-f48.google.com ([209.85.128.48]:37286) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgsZS-0008QI-OQ for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 11:13:51 -0400 Received: by mail-wm1-f48.google.com with SMTP id f17so9319506wme.2 for <36417@debbugs.gnu.org>; Fri, 28 Jun 2019 08:13:50 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=gYovZ+aNfREAsMeWf9Js+lFC/ahts2lbRMS5mf+ICNM=; b=PUsDjQw9e4zxt6/KDSGgfZbL7sV4XbW2EiwBWkdFISNEI//PndRHmZchyWc4/92VW0 qzb69StjZRKLIxHzDod9IoVOkPWlBvn29UP52yxJvUWyJz74yn07nBHkJGH2bIGAq5aF EzGPzZwiAhCGXGCAAfyWFYGr+6QPIVc+kG2tEA4OAZpNGfe8pbtJ7aPL5XNr1Q/LhQVu 3IC42tvj01FIqjo3WGNk3tUfFuJ4IbV11FcOp71GGXdc+F6oe5JBg4QblCw+0ierm6AV sciZXiMIh/OSjN9PPwJT3M1sUyEA7G2XiF0r1Tl2B+rEC1X9PW+nxk/AIJhPGGQVWgHp mD0Q== X-Gm-Message-State: APjAAAU3d0a1qfuTO3E8/DNSb/+4Ag6uI4VVvAJnx10fkExVnZZYOq2Y BgImYEORpNqF6nYna/AnrfhCWr+WsX4Xj3AqsDM= X-Google-Smtp-Source: APXvYqymbEQAxA/iMjN/yODtmPqHL8DjNQpCkXGY52wzRlmE8Khs5P+SMOTjWhpjj08TZnyp8C85fDO9GO7hE1G2Ekw= X-Received: by 2002:a1c:f515:: with SMTP id t21mr8065886wmh.39.1561734824984; Fri, 28 Jun 2019 08:13:44 -0700 (PDT) MIME-Version: 1.0 References: <83y31lhjwz.fsf@gnu.org> In-Reply-To: <83y31lhjwz.fsf@gnu.org> From: Stefan Kangas Date: Fri, 28 Jun 2019 17:13:33 +0200 Message-ID: Subject: Re: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual To: Eli Zaretskii Content-Type: multipart/mixed; boundary="0000000000007a4296058c63b9ef" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 36417 Cc: 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) --0000000000007a4296058c63b9ef Content-Type: text/plain; charset="UTF-8" Eli Zaretskii writes: > > +@vindex bookmark-use-annotations > > +@vindex bookmark-automatically-show-annotations > > How about "@cindex bookmark annotations" as well? Done. > > + If you set the variable @code{bookmark-use-annotations} to t, > ^ > @code{t} Done. Would we also want to do this change while we're at it, or is it ok as is? - If you set the variable @code{bookmark-save-flag} to 1, each command + If you set the variable @code{bookmark-save-flag} to @code{1}, each command > > +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. Done. Let me know if it's not clear enough. > 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. Good point. I don't think it's a very important use case, so I removed it. Thank you for reviewing; sorry about the basic mistakes. Please find attached an updated patch. Thanks, Stefan Kangas --0000000000007a4296058c63b9ef Content-Type: text/x-patch; charset="US-ASCII"; name="0001-Document-bookmark-annotations-in-Emacs-Manual.patch" Content-Disposition: attachment; filename="0001-Document-bookmark-annotations-in-Emacs-Manual.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_jxg8jxyx0 RnJvbSAyNTFkNGIzZGU5OTRhNGQ5YTU1ZTJlYzk0YTNjOTk0NWQ0Mjk3ZDM4IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBGcmksIDI4IEp1biAyMDE5IDEzOjQwOjM3ICswMjAwClN1YmplY3Q6IFtQQVRDSF0g RG9jdW1lbnQgYm9va21hcmsgYW5ub3RhdGlvbnMgaW4gRW1hY3MgTWFudWFsCgoqIGRvYy9lbWFj cy9yZWdzLnRleGkgKEJvb2ttYXJrcyk6IERvY3VtZW50IGFubm90YXRpb25zLgoqIGxpc3AvYm9v a21hcmsuZWwgKGJvb2ttYXJrLXVzZS1hbm5vdGF0aW9ucyk6IENsYXJpZnkgZG9jc3RyaW5nLgot LS0KIGRvYy9lbWFjcy9yZWdzLnRleGkgfCA3ICsrKysrKysKIGxpc3AvYm9va21hcmsuZWwgICAg fCA1ICstLS0tCiAyIGZpbGVzIGNoYW5nZWQsIDggaW5zZXJ0aW9ucygrKSwgNCBkZWxldGlvbnMo LSkKCmRpZmYgLS1naXQgYS9kb2MvZW1hY3MvcmVncy50ZXhpIGIvZG9jL2VtYWNzL3JlZ3MudGV4 aQppbmRleCAzNzAyNjk0NjQ3Li4xYzhlMzM4ZTY1IDEwMDY0NAotLS0gYS9kb2MvZW1hY3MvcmVn cy50ZXhpCisrKyBiL2RvYy9lbWFjcy9yZWdzLnRleGkKQEAgLTM1OSw2ICszNTksMTMgQEAgQm9v a21hcmtzCiAgIFRoZSB2YXJpYWJsZSBAY29kZXtib29rbWFyay1kZWZhdWx0LWZpbGV9IHNwZWNp ZmllcyB0aGUgZmlsZSBpbgogd2hpY2ggdG8gc2F2ZSBib29rbWFya3MgYnkgZGVmYXVsdC4KIAor QHZpbmRleCBib29rbWFyay11c2UtYW5ub3RhdGlvbnMKK0BjaW5kZXggYm9va21hcmsgYW5ub3Rh dGlvbnMKKyAgSWYgeW91IHNldCB0aGUgdmFyaWFibGUgQGNvZGV7Ym9va21hcmstdXNlLWFubm90 YXRpb25zfSB0byBAY29kZXt0fSwKK3NldHRpbmcgYSBib29rbWFyayB3aWxsIHF1ZXJ5IGZvciBh biBhbm5vdGF0aW9uLiAgVGhlIGFubm90YXRpb24gd2lsbAorYmUgYXV0b21hdGljYWxseSBzaG93 biBpbiBhIHNlcGFyYXRlIHdpbmRvdyB3aGVuIHlvdSBqdW1wIHRvIGEKK2Jvb2ttYXJrLgorCiBA dmluZGV4IGJvb2ttYXJrLXNlYXJjaC1zaXplCiAgIEJvb2ttYXJrIHBvc2l0aW9uIHZhbHVlcyBh cmUgc2F2ZWQgd2l0aCBzdXJyb3VuZGluZyBjb250ZXh0LCBzbyB0aGF0CiBAY29kZXtib29rbWFy ay1qdW1wfSBjYW4gZmluZCB0aGUgcHJvcGVyIHBvc2l0aW9uIGV2ZW4gaWYgdGhlIGZpbGUgaXMK ZGlmZiAtLWdpdCBhL2xpc3AvYm9va21hcmsuZWwgYi9saXNwL2Jvb2ttYXJrLmVsCmluZGV4IDlh M2EyYTNiZGYuLmJiZWYwYTkyN2QgMTAwNjQ0Ci0tLSBhL2xpc3AvYm9va21hcmsuZWwKKysrIGIv bGlzcC9ib29rbWFyay5lbApAQCAtMzYsOSArMzYsNiBAQAogCiA7OzsgTWlzYyBjb21tZW50czoK IDs7Ci07OyBJZiB2YXJpYWJsZSBib29rbWFyay11c2UtYW5ub3RhdGlvbnMgaXMgbm9uLW5pbCwg YW4gYW5ub3RhdGlvbiBpcwotOzsgcXVlcmllZCBmb3Igd2hlbiBzZXR0aW5nIGEgYm9va21hcmsu Ci07OwogOzsgVGhlIGJvb2ttYXJrIGxpc3QgaXMgc29ydGVkIGxleGljYWxseSBieSBkZWZhdWx0 LCBidXQgeW91IGNhbiB0dXJuCiA7OyB0aGlzIG9mZiBieSBzZXR0aW5nIGJvb2ttYXJrLXNvcnQt ZmxhZyB0byBuaWwuICBJZiBpdCBpcyBuaWwsIHRoZW4KIDs7IHRoZSBsaXN0IHdpbGwgYmUgcHJl c2VudGVkIGluIHRoZSBvcmRlciBpdCBpcyByZWNvcmRlZApAQCAtNTIsNyArNDksNyBAQCBib29r bWFyawogCiAKIChkZWZjdXN0b20gYm9va21hcmstdXNlLWFubm90YXRpb25zIG5pbAotICAiSWYg bm9uLW5pbCwgc2F2aW5nIGEgYm9va21hcmsgcXVlcmllcyBmb3IgYW4gYW5ub3RhdGlvbiBpbiBh IGJ1ZmZlci4iCisgICJJZiBub24tbmlsLCBzZXR0aW5nIGEgYm9va21hcmsgcXVlcmllcyBmb3Ig YW4gYW5ub3RhdGlvbiBpbiBhIGJ1ZmZlci4iCiAgIDp0eXBlICdib29sZWFuCiAgIDpncm91cCAn Ym9va21hcmspCiAKLS0gCjIuMTEuMAoK --0000000000007a4296058c63b9ef-- From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 11:19:20 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 15:19:20 +0000 Received: from localhost ([127.0.0.1]:42815 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgsek-0002HL-Vl for submit@debbugs.gnu.org; Fri, 28 Jun 2019 11:19:19 -0400 Received: from mail-wm1-f54.google.com ([209.85.128.54]:40865) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgsei-0002H3-E2 for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 11:19:16 -0400 Received: by mail-wm1-f54.google.com with SMTP id v19so9339198wmj.5 for <36417@debbugs.gnu.org>; Fri, 28 Jun 2019 08:19:16 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=j3A+/+q2ZZmOqX75SliyF55F8o8Bli3ezoNn7B96P/0=; b=QFpHDL6B3q0S+Gmrj1S4aKUoEeCPYPoQ+Y2qOM55TwhK6yTjX7ZWWwb/PmJ8NViwxP GEuXBr7KNKTkEav+2nSmsxmOGpT2M/zDTMmkiN/qP1BrtI83NY8CS6ZHYYGx8i/1o+hg U7vPfigNynIBDRtTk+0xsd27ifN9OOXDqmeyRUyCQVpWaw56qWWgOP91EHRDu5Wu5fmU 2kN6R+xn/2kZMAGZDdTpGFz/mJ9YhIaOfN63Pkl/o/v0QZQJdJCm0y6S9Qeu5K+pIhdc SlYweXMTFl+k2gzr4fb+YMjEdxUrkhYcfJcHiOe+zZ2V1nFOH8BiMxRZQpXNENUZ4PuN m1cQ== X-Gm-Message-State: APjAAAW6KkAf8SrLNRbx7KIiCeUMZa4e5AX4M7gG8LmWpARa6gBnGcH4 RQA1B7QOZBcpiWKlkA1a7OhhIgAYGIvULcYNM8eh0A== X-Google-Smtp-Source: APXvYqzPbM1m70tWBkQX1c2oy2DRUFppImnAUIXgUrx+wexyFc5hd/gboj/pD1TTdkhGhpUmaqvlfZarAXwGWvJflyg= X-Received: by 2002:a1c:f515:: with SMTP id t21mr8082042wmh.39.1561735149967; Fri, 28 Jun 2019 08:19:09 -0700 (PDT) MIME-Version: 1.0 References: <83y31lhjwz.fsf@gnu.org> In-Reply-To: From: Stefan Kangas Date: Fri, 28 Jun 2019 17:18:58 +0200 Message-ID: Subject: Re: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual To: Eli Zaretskii Content-Type: multipart/mixed; boundary="000000000000d90af8058c63ccb7" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 36417 Cc: 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) --000000000000d90af8058c63ccb7 Content-Type: text/plain; charset="UTF-8" I've attached a new version with hopefully slightly clearer wording. Thanks, Stefan Kangas --000000000000d90af8058c63ccb7 Content-Type: text/x-patch; charset="US-ASCII"; name="0001-Document-bookmark-annotations-in-Emacs-Manual-3.patch" Content-Disposition: attachment; filename="0001-Document-bookmark-annotations-in-Emacs-Manual-3.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_jxg8re710 RnJvbSBhYTExMTUyMDIzNDY1NzJmNzIwZWVkZDM4ZTE0N2NkNWE0OGFjN2Y4IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5rYW5nYXNAZ21haWwuY29t PgpEYXRlOiBGcmksIDI4IEp1biAyMDE5IDEzOjQwOjM3ICswMjAwClN1YmplY3Q6IFtQQVRDSF0g RG9jdW1lbnQgYm9va21hcmsgYW5ub3RhdGlvbnMgaW4gRW1hY3MgTWFudWFsCgoqIGRvYy9lbWFj cy9yZWdzLnRleGkgKEJvb2ttYXJrcyk6IERvY3VtZW50IGFubm90YXRpb25zLgoqIGxpc3AvYm9v a21hcmsuZWwgKGJvb2ttYXJrLXVzZS1hbm5vdGF0aW9ucyk6IENsYXJpZnkgZG9jc3RyaW5nLgot LS0KIGRvYy9lbWFjcy9yZWdzLnRleGkgfCA3ICsrKysrKysKIGxpc3AvYm9va21hcmsuZWwgICAg fCA1ICstLS0tCiAyIGZpbGVzIGNoYW5nZWQsIDggaW5zZXJ0aW9ucygrKSwgNCBkZWxldGlvbnMo LSkKCmRpZmYgLS1naXQgYS9kb2MvZW1hY3MvcmVncy50ZXhpIGIvZG9jL2VtYWNzL3JlZ3MudGV4 aQppbmRleCAzNzAyNjk0NjQ3Li42OGE4MjQ1YjM0IDEwMDY0NAotLS0gYS9kb2MvZW1hY3MvcmVn cy50ZXhpCisrKyBiL2RvYy9lbWFjcy9yZWdzLnRleGkKQEAgLTM1OSw2ICszNTksMTMgQEAgQm9v a21hcmtzCiAgIFRoZSB2YXJpYWJsZSBAY29kZXtib29rbWFyay1kZWZhdWx0LWZpbGV9IHNwZWNp ZmllcyB0aGUgZmlsZSBpbgogd2hpY2ggdG8gc2F2ZSBib29rbWFya3MgYnkgZGVmYXVsdC4KIAor QHZpbmRleCBib29rbWFyay11c2UtYW5ub3RhdGlvbnMKK0BjaW5kZXggYm9va21hcmsgYW5ub3Rh dGlvbnMKKyAgSWYgeW91IHNldCB0aGUgdmFyaWFibGUgQGNvZGV7Ym9va21hcmstdXNlLWFubm90 YXRpb25zfSB0byBAY29kZXt0fSwKK3NldHRpbmcgYSBib29rbWFyayB3aWxsIHF1ZXJ5IGZvciBh biBhbm5vdGF0aW9uLiAgSWYgYSBib29rbWFyayBoYXMgYW4KK2Fubm90YXRpb24sIGl0IGlzIGF1 dG9tYXRpY2FsbHkgc2hvd24gaW4gYSBzZXBhcmF0ZSB3aW5kb3cgd2hlbiB5b3UKK2p1bXAgdG8g dGhlIGJvb2ttYXJrLgorCiBAdmluZGV4IGJvb2ttYXJrLXNlYXJjaC1zaXplCiAgIEJvb2ttYXJr IHBvc2l0aW9uIHZhbHVlcyBhcmUgc2F2ZWQgd2l0aCBzdXJyb3VuZGluZyBjb250ZXh0LCBzbyB0 aGF0CiBAY29kZXtib29rbWFyay1qdW1wfSBjYW4gZmluZCB0aGUgcHJvcGVyIHBvc2l0aW9uIGV2 ZW4gaWYgdGhlIGZpbGUgaXMKZGlmZiAtLWdpdCBhL2xpc3AvYm9va21hcmsuZWwgYi9saXNwL2Jv b2ttYXJrLmVsCmluZGV4IDlhM2EyYTNiZGYuLmJiZWYwYTkyN2QgMTAwNjQ0Ci0tLSBhL2xpc3Av Ym9va21hcmsuZWwKKysrIGIvbGlzcC9ib29rbWFyay5lbApAQCAtMzYsOSArMzYsNiBAQAogCiA7 OzsgTWlzYyBjb21tZW50czoKIDs7Ci07OyBJZiB2YXJpYWJsZSBib29rbWFyay11c2UtYW5ub3Rh dGlvbnMgaXMgbm9uLW5pbCwgYW4gYW5ub3RhdGlvbiBpcwotOzsgcXVlcmllZCBmb3Igd2hlbiBz ZXR0aW5nIGEgYm9va21hcmsuCi07OwogOzsgVGhlIGJvb2ttYXJrIGxpc3QgaXMgc29ydGVkIGxl eGljYWxseSBieSBkZWZhdWx0LCBidXQgeW91IGNhbiB0dXJuCiA7OyB0aGlzIG9mZiBieSBzZXR0 aW5nIGJvb2ttYXJrLXNvcnQtZmxhZyB0byBuaWwuICBJZiBpdCBpcyBuaWwsIHRoZW4KIDs7IHRo ZSBsaXN0IHdpbGwgYmUgcHJlc2VudGVkIGluIHRoZSBvcmRlciBpdCBpcyByZWNvcmRlZApAQCAt NTIsNyArNDksNyBAQCBib29rbWFyawogCiAKIChkZWZjdXN0b20gYm9va21hcmstdXNlLWFubm90 YXRpb25zIG5pbAotICAiSWYgbm9uLW5pbCwgc2F2aW5nIGEgYm9va21hcmsgcXVlcmllcyBmb3Ig YW4gYW5ub3RhdGlvbiBpbiBhIGJ1ZmZlci4iCisgICJJZiBub24tbmlsLCBzZXR0aW5nIGEgYm9v a21hcmsgcXVlcmllcyBmb3IgYW4gYW5ub3RhdGlvbiBpbiBhIGJ1ZmZlci4iCiAgIDp0eXBlICdi b29sZWFuCiAgIDpncm91cCAnYm9va21hcmspCiAKLS0gCjIuMTEuMAoK --000000000000d90af8058c63ccb7-- From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 12:01:33 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 16:01:33 +0000 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 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 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== 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 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 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 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 MIME-Version: 1.0 Message-ID: <7a905121-f6ff-429c-b781-7ff38863aa30@default> Date: Fri, 28 Jun 2019 09:01:20 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Stefan Kangas Subject: RE: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual References: <> <<83y31lhjwz.fsf@gnu.org>> 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)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable 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-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36417 Cc: 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > 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. From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 12:07:35 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 16:07:35 +0000 Received: from localhost ([127.0.0.1]:42865 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgtPT-0005oo-FV for submit@debbugs.gnu.org; Fri, 28 Jun 2019 12:07:35 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:53452) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgtPR-0005oN-Et for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 12:07:34 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5SG4Kn2001831; Fri, 28 Jun 2019 16:07:26 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=/VDxo+9rLQuIX7JlndCPE9Daq8oW6hwdFVpK62NI4tU=; b=NN/UvQ9jgkV8tBm1o8K1P9GdLEZkkH3p78ECV9F8oDn2arYbzGKV0xblyijnykWhvXpd Y5kqK9+A5P+32lY0/Z/PejjgGl986NrzHYlw4nQBJnNKUGAODKuEt2pdk/1RSkyjQ9A8 ezODkTlTDINY/LEaJxsuH6zlNNduL/9ja05KwBS41DZooVOLnuGfSiQG9MXGXz8CqjEB jxU2afE/0g4PeOH/RnKRG/JiIIPtcjOyzv/e+sO324RkzYX+6HDcmENw5N7gfVzNGYbF flV1eSJ7zZ3EpiLqTmzBwHMBlcvwADISDUbnlzDqnO1z3Qu3/DSzArl6An0DSBwSyVl1 +A== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2120.oracle.com with ESMTP id 2t9cyqxd8p-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 28 Jun 2019 16:07:26 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5SG61ne178994; Fri, 28 Jun 2019 16:07:26 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3030.oracle.com with ESMTP id 2t99f5nsxa-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 28 Jun 2019 16:07:26 +0000 Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x5SG7O8e010585; Fri, 28 Jun 2019 16:07:25 GMT MIME-Version: 1.0 Message-ID: <93a1eeb8-568b-4ecc-9d38-37ac23545977@default> Date: Fri, 28 Jun 2019 09:07:23 -0700 (PDT) From: Drew Adams To: Stefan Kangas , Eli Zaretskii Subject: RE: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual References: <83y31lhjwz.fsf@gnu.org> In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4861.0 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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-1906280185 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=1015 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-1906280185 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36417 Cc: 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > > 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. >=20 > Good point. I don't think it's a very important use case, so I > removed it. It should not be removed. Many users like to have an annotation-edit/create buffer displayed whenever they set (create or update) a bookmark. Many other users do not want this behavior, but prefer to add or edit an annotation only on demand. This option is at least as important as the other one. In both cases a user can prefer to only deal with annotations on demand - not have them popped up in their face. But for users who do want them in their face, they can want that for setting or for jumping, or for both. From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 14:37:45 2019 Received: (at 36417-done) by debbugs.gnu.org; 28 Jun 2019 18:37:45 +0000 Received: from localhost ([127.0.0.1]:42964 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgvkm-0003VP-UA for submit@debbugs.gnu.org; Fri, 28 Jun 2019 14:37:45 -0400 Received: from eggs.gnu.org ([209.51.188.92]:60675) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgvkl-0003VC-Gj for 36417-done@debbugs.gnu.org; Fri, 28 Jun 2019 14:37:43 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:32965) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hgvkf-0008Vc-KI; Fri, 28 Jun 2019 14:37:38 -0400 Received: from [176.228.60.248] (port=4106 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hgvkf-0004bV-41; Fri, 28 Jun 2019 14:37:37 -0400 Date: Fri, 28 Jun 2019 21:37:25 +0300 Message-Id: <83o92hh7yy.fsf@gnu.org> From: Eli Zaretskii To: Stefan Kangas In-reply-to: (message from Stefan Kangas on Fri, 28 Jun 2019 17:18:58 +0200) Subject: Re: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual References: <83y31lhjwz.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36417-done Cc: 36417-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Stefan Kangas > Date: Fri, 28 Jun 2019 17:18:58 +0200 > Cc: 36417@debbugs.gnu.org > > I've attached a new version with hopefully slightly clearer wording. Thanks, pushed. > > > + If you set the variable @code{bookmark-use-annotations} to t, > > ^ > > @code{t} > > Done. Would we also want to do this change while we're at it, or is > it ok as is? > > - If you set the variable @code{bookmark-save-flag} to 1, each command > + If you set the variable @code{bookmark-save-flag} to @code{1}, each command There's no need, as 1 always stands for itself. > sorry about the basic mistakes No need to apologize; thanks for working on this. From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 14:39:53 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 18:39:53 +0000 Received: from localhost ([127.0.0.1]:42970 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgvmo-0003ZV-BY for submit@debbugs.gnu.org; Fri, 28 Jun 2019 14:39:53 -0400 Received: from eggs.gnu.org ([209.51.188.92]:60995) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgvmm-0003ZG-Sj for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 14:39:49 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:32988) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hgvmh-0001ra-Ab; Fri, 28 Jun 2019 14:39:43 -0400 Received: from [176.228.60.248] (port=4234 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hgvmg-0004iw-Ms; Fri, 28 Jun 2019 14:39:43 -0400 Date: Fri, 28 Jun 2019 21:39:32 +0300 Message-Id: <83mui1h7vf.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <93a1eeb8-568b-4ecc-9d38-37ac23545977@default> (message from Drew Adams on Fri, 28 Jun 2019 09:07:23 -0700 (PDT)) Subject: Re: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual References: <83y31lhjwz.fsf@gnu.org> <93a1eeb8-568b-4ecc-9d38-37ac23545977@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36417 Cc: stefan@marxist.se, 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Fri, 28 Jun 2019 09:07:23 -0700 (PDT) > From: Drew Adams > Cc: 36417@debbugs.gnu.org > > > > 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. > > > > Good point. I don't think it's a very important use case, so I > > removed it. > > It should not be removed. We didn't remove the variable, we just avoided documenting it in the manual. Not every option of every package is documented in the Emacs manual. If you think bookmark.el warrants a more detailed documentation, please consider writing a separate Texinfo manual for it, as we have for many other packages. From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 14:52:56 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 18:52:56 +0000 Received: from localhost ([127.0.0.1]:42990 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgvzT-0003yY-Ov for submit@debbugs.gnu.org; Fri, 28 Jun 2019 14:52:56 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:36890) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgvzQ-0003yE-Rl for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 14:52:54 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5SImuxM125200; Fri, 28 Jun 2019 18:52:46 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=IUTs86ZKAC5v2dvePGJ6uple8R9FlIkKRMr3kNr0CXU=; b=Kdm4lm5A/sQLqqUb+B5JF1b30zie+sC+sOfLnj9QmvY8qZ72ZJ4b+5UzID+qG1/Nh7rz 64LbNhXeI9N5vUJjPJR3k1CJIlCe4O5MP4FTulUT97zaCkA7Q43X8ZI3aexTa8HszlL8 dozCG7FuX70SH+aNop5orDLVyreA4ph24Ok0pPtsZ4WXnNBS3t9DCJj/U27YAI6zk+7F CtYPeUl1Hih89v7Ec/2Ah3wMoNXKPuz0WdMfIebKOPUR0J0ZwJJxrNHDmF9dH7z4421N ZmWxoPm1fUtNCGG44HtDUoA/+kBV4c0do3SfkYJzi9AOOKVu8hYdGCocBDrwIG/myrvx Bg== Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by userp2120.oracle.com with ESMTP id 2t9cyqy1gw-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 28 Jun 2019 18:52:46 +0000 Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5SIpcvk118258; Fri, 28 Jun 2019 18:52:45 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3030.oracle.com with ESMTP id 2t9acdynne-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 28 Jun 2019 18:52:45 +0000 Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x5SIqhU0001712; Fri, 28 Jun 2019 18:52:43 GMT MIME-Version: 1.0 Message-ID: <079f4f36-497b-4580-905f-3acb2eb89f3e@default> Date: Fri, 28 Jun 2019 11:52:42 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual References: <> <<83y31lhjwz.fsf@gnu.org>> <> <<93a1eeb8-568b-4ecc-9d38-37ac23545977@default>> <<83mui1h7vf.fsf@gnu.org>> In-Reply-To: <<83mui1h7vf.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)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable 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-1906280212 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=1015 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-1906280213 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36417 Cc: stefan@marxist.se, 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > > > > Btw, what is the use case for using annotations but not showing the= m? > > > > If that use case is not important enough, perhaps we shouldn't ment= ion > > > > the second option. > > > > > > Good point. I don't think it's a very important use case, so I > > > removed it. > > > > It should not be removed. >=20 > We didn't remove the variable, we just avoided documenting it in the > manual. =20 Yes, I realized that. And that was perhaps based on Stefan's saying he doesn't think it's a very important use case. I pointed out that it is just as important as using the other option. > Not every option of every package is documented in the Emacs > manual. No, of course not. You always say that, as if someone claimed the contrary. No one has _ever_ done so, as far I know. > If you think bookmark.el warrants a more detailed > documentation, please consider writing a separate Texinfo manual for > it, as we have for many other packages. That's reading a lot into my reply. I was setting the record straight wrt what these variables are for, and pointing out that neither is more important than the other. You can document them both in the manual or remove them both from the manual, as far as I'm concerned. You can document only one of them, but there is not special reason (IMHO) to choose this one or that one. From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 15:45:22 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 19:45:22 +0000 Received: from localhost ([127.0.0.1]:43053 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgwoE-000844-Id for submit@debbugs.gnu.org; Fri, 28 Jun 2019 15:45:22 -0400 Received: from eggs.gnu.org ([209.51.188.92]:56695) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgwoC-00083o-D9 for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 15:45:21 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:34182) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hgwo6-0000lI-24; Fri, 28 Jun 2019 15:45:14 -0400 Received: from [176.228.60.248] (port=4215 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hgwo4-0001jK-QQ; Fri, 28 Jun 2019 15:45:13 -0400 Date: Fri, 28 Jun 2019 22:45:02 +0300 Message-Id: <83k1d5h4u9.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <079f4f36-497b-4580-905f-3acb2eb89f3e@default> (message from Drew Adams on Fri, 28 Jun 2019 11:52:42 -0700 (PDT)) Subject: Re: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual References: <> <<83y31lhjwz.fsf@gnu.org>> <> <<93a1eeb8-568b-4ecc-9d38-37ac23545977@default>> <<83mui1h7vf.fsf@gnu.org>> <079f4f36-497b-4580-905f-3acb2eb89f3e@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36417 Cc: stefan@marxist.se, 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Fri, 28 Jun 2019 11:52:42 -0700 (PDT) > From: Drew Adams > Cc: stefan@marxist.se, 36417@debbugs.gnu.org > > > > > > 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. > > > > > > > > Good point. I don't think it's a very important use case, so I > > > > removed it. > > > > > > It should not be removed. > > > > We didn't remove the variable, we just avoided documenting it in the > > manual. > > Yes, I realized that. And that was perhaps based on > Stefan's saying he doesn't think it's a very important > use case. He said that in response to my question, which I asked because I also didn't see that as too important. > I pointed out that it is just as important as using > the other option. You are in minority here. From debbugs-submit-bounces@debbugs.gnu.org Fri Jun 28 18:26:57 2019 Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 22:26:57 +0000 Received: from localhost ([127.0.0.1]:43146 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgzKa-0006Vd-QY for submit@debbugs.gnu.org; Fri, 28 Jun 2019 18:26:57 -0400 Received: from aserp2120.oracle.com ([141.146.126.78]:57648) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hgzKZ-0006VQ-MF for 36417@debbugs.gnu.org; Fri, 28 Jun 2019 18:26:56 -0400 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5SMO3Vd184096; Fri, 28 Jun 2019 22:26:48 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=E9RBSD7fODsjnWw7+OgA0B5eB6qDfJ4BSN5FhuvKIYg=; b=ScvGfZYpVpSJVExnN6q8OUIdz8Uik3rGmRl+V+K37uPez4AYT37L8ba6VsPhUYh3BJzR oJKurfLKrPlpTV7pn1gKfTZl+6LWQ+tBfGp4dSIyMyy7SFl2UDNkyexiRq7p+/9dbPpk x0oLFzvHetrhYf6azJ7kKAPO3vlmrWbxwjn8zMFC6L+D6GyLpdZWm46uDLZhv5EU225S SCy7z2gzbR8gVH47Ifg1/0XiXpVTBzTEKvmqL1E5cHv1EBFdVrVl+lPB8snXp+Ab2kZr DtmFXc3zxDUjTaCZ57VMBJENvuSxUIPv+n4fCH0Qy6bawJJr1KeOdWmx0RcEL5cBs0qq Zw== Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 2t9c9q7qhq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 28 Jun 2019 22:26:48 +0000 Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x5SMPYZh090188; Fri, 28 Jun 2019 22:26:48 GMT Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userp3020.oracle.com with ESMTP id 2tat7e652a-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 28 Jun 2019 22:26:47 +0000 Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x5SMQiFU031477; Fri, 28 Jun 2019 22:26:44 GMT MIME-Version: 1.0 Message-ID: <6c30be13-4435-465f-8954-15142f1e4327@default> Date: Fri, 28 Jun 2019 15:26:43 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual References: <<>> <<<83y31lhjwz.fsf@gnu.org>>> <<>> <<<93a1eeb8-568b-4ecc-9d38-37ac23545977@default>>> <<<83mui1h7vf.fsf@gnu.org>>> <<079f4f36-497b-4580-905f-3acb2eb89f3e@default>> <<83k1d5h4u9.fsf@gnu.org>> In-Reply-To: <<83k1d5h4u9.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)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable 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-1906280256 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=1015 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-1906280257 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36417 Cc: stefan@marxist.se, 36417@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > > > We didn't remove the variable, we just avoided > > > documenting it in the manual. > > > > Yes, I realized that. And that was perhaps based on > > Stefan's saying he doesn't think it's a very important > > use case. >=20 > He said that in response to my question, which I asked > because I also didn't see that as too important. Seriously? It doesn't seem like you even knew what it was for. You asked, "What is the use case for using annotations but not showing them?" I had to point out that (1) "using" is a misnomer for _setting_ (creating, editing), and (2) "using" an annotation _does_ also show it. The actions take place at different times. The annotation is shown in both cases. So your question made no sense: there is no "using" an annotation without showing it. You can't go by the words "use" and "show" in the two variable names. I imagine a real question behind what you asked might be, "What is the use case for the "*-use-*" variable?". I answered that. > > I pointed out that it is just as important as using > > the other option. >=20 > You are in minority here. Whoop-dee-doo! From unknown Mon Aug 18 15:38:38 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 27 Jul 2019 11:24:07 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator