From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bookmark structure Date: Fri, 4 Apr 2008 17:02:44 -0700 Message-ID: <000d01c896b0$6044c7f0$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1207353825 28080 80.91.229.12 (5 Apr 2008 00:03:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 5 Apr 2008 00:03:45 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 05 02:04:17 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JhvtE-0004eL-Qs for geb-bug-gnu-emacs@m.gmane.org; Sat, 05 Apr 2008 02:04:13 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Jhvsb-0003kN-Uw for geb-bug-gnu-emacs@m.gmane.org; Fri, 04 Apr 2008 20:03:34 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JhvsW-0003kI-Uz for bug-gnu-emacs@gnu.org; Fri, 04 Apr 2008 20:03:28 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JhvsV-0003k6-0T for bug-gnu-emacs@gnu.org; Fri, 04 Apr 2008 20:03:28 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JhvsU-0003k3-Sl for bug-gnu-emacs@gnu.org; Fri, 04 Apr 2008 20:03:26 -0400 Original-Received: from agminet01.oracle.com ([141.146.126.228]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JhvsU-00030Z-Go for bug-gnu-emacs@gnu.org; Fri, 04 Apr 2008 20:03:26 -0400 Original-Received: from agmgw2.us.oracle.com (agmgw2.us.oracle.com [152.68.180.213]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m3503NwE008221 for ; Fri, 4 Apr 2008 19:03:23 -0500 Original-Received: from acsmt351.oracle.com (acsmt351.oracle.com [141.146.40.151]) by agmgw2.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m34H1bjR024473 for ; Fri, 4 Apr 2008 18:03:23 -0600 Original-Received: from inet-141-146-46-1.oracle.com by acsmt351.oracle.com with ESMTP id 3639698711207353756; Fri, 04 Apr 2008 17:02:36 -0700 Original-Received: from dradamslap1 (/141.144.72.121) by bhmail.oracle.com (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 04 Apr 2008 17:02:36 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AciWsF/glYMedXFUSkOa1mhoY2kflg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3198 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:17802 Archived-At: The doc string of bookmark-alist says each entry has this form: (NAME (filename . FILE) (front-context-string . FRONT-STR) (rear-context-string . REAR-STR) (position . POS) (info-node . POS) (annotation . ANNOTATION)) There should not be two occurrences of POS, unless they always have the same value. The doc string says that info-node is optional, but it doesn't say that annotation is optional. And the syntax description doesn't reflect the fact that these are optional (no brackets). The comments in the code, on the other hand, say that this is the(new) structure: ;; (bookmark-name ((filename . FILENAME) ;; (front-context-string . string-in-front) ;; (rear-context-string . string-behind) ;; (position . POINT) ;; (annotation . annotation) ;; (whatever . VALUE) ;; ... ;; )) bookmark-name, string-in-front, string-behind, and the second occurrence of annotation here should be uppercase here. Compared to the doc string, there is an additional level of parens here for the body, info-node is missing, and additional kinds of entries (whatever . VALUE)..., are acceptable. The two descriptions should be similar. It seems that neither is quite correct. The doc string is missing a level of parens, at least. In GNU Emacs 22.2.1 (i386-mingw-nt5.1.2600) of 2008-03-26 on RELEASE Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4)'