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 11:52:42 -0700 (PDT) Message-ID: <079f4f36-497b-4580-905f-3acb2eb89f3e@default> References: <> <<83y31lhjwz.fsf@gnu.org>> <> <<93a1eeb8-568b-4ecc-9d38-37ac23545977@default>> <<83mui1h7vf.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="117959"; mail-complaints-to="usenet@blaine.gmane.org" Cc: stefan@marxist.se, 36417@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jun 28 21:10:00 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 1hgwFy-000UTB-6R for geb-bug-gnu-emacs@m.gmane.org; Fri, 28 Jun 2019 21:09:58 +0200 Original-Received: from localhost ([::1]:35618 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hgwFv-0000RJ-Ei for geb-bug-gnu-emacs@m.gmane.org; Fri, 28 Jun 2019 15:09:55 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41492) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hgvzc-00060J-CH for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 14:53:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hgvza-0006Ev-0b for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 14:53:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57679) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hgvzZ-0006El-Ss for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 14:53:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hgvzZ-0003yr-Pp for bug-gnu-emacs@gnu.org; Fri, 28 Jun 2019 14:53:01 -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 18:53:01 +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.156174797615290 (code B ref 36417); Fri, 28 Jun 2019 18:53:01 +0000 Original-Received: (at 36417) by debbugs.gnu.org; 28 Jun 2019 18:52:56 +0000 Original-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 Original-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 Original-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== Original-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 Original-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 Original-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 Original-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 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)] 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-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:161757 Archived-At: > > > > 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.