From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#36417: [PATCH] Document bookmark annotations in Emacs Manual Date: Fri, 28 Jun 2019 21:39:32 +0300 Message-ID: <83mui1h7vf.fsf@gnu.org> References: <83y31lhjwz.fsf@gnu.org> <93a1eeb8-568b-4ecc-9d38-37ac23545977@default> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="266012"; mail-complaints-to="usenet@blaine.gmane.org" Cc: stefan@marxist.se, 36417@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jun 28 20:40:32 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 1hgvnT-0016lx-5Z for geb-bug-gnu-emacs@m.gmane.org; Fri, 28 Jun 2019 20:40:31 +0200 Original-Received: from localhost ([::1]:35414 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hgvnH-0005ea-Sh for geb-bug-gnu-emacs@m.gmane.org; Fri, 28 Jun 2019 14:40:19 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38650) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hgvn3-0005ZU-38 for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 14:40:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hgvn0-0002BE-VE for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 14:40:05 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57659) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hgvn0-0002Am-R2 for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 14:40:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hgvn0-0003a2-ME for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 14:40:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 28 Jun 2019 18:40: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.156174719313740 (code B ref 36417); Fri, 28 Jun 2019 18:40:02 +0000 Original-Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 18:39:53 +0000 Original-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 Original-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 Original-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 Original-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 In-reply-to: <93a1eeb8-568b-4ecc-9d38-37ac23545977@default> (message from Drew Adams on Fri, 28 Jun 2019 09:07:23 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:161754 Archived-At: > 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.