From unknown Fri Jun 20 07:28:13 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#4188: 23.1; doc strings in bookmark.el Reply-To: "Drew Adams" , 4188@debbugs.gnu.org Resent-From: "Drew Adams" Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Thu, 20 Aug 2009 19:51:13 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: report 4188 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12507206343532 (code B ref -1); Thu, 20 Aug 2009 19:51:13 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 19 Aug 2009 22:23:54 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.5 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7JMNqHm003529 for ; Wed, 19 Aug 2009 15:23:53 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MdtZP-0005sB-SX for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2009 18:23:51 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MdtZL-0005qE-4n for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2009 18:23:51 -0400 Received: from [199.232.76.173] (port=42254 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MdtZK-0005q5-S1 for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2009 18:23:46 -0400 Received: from rcsinet11.oracle.com ([148.87.113.123]:56394 helo=rgminet11.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MdtZK-0007De-HJ for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2009 18:23:46 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rgminet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7JMNwDb011028 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 19 Aug 2009 22:23:59 GMT Received: from abhmt004.oracle.com (abhmt004.oracle.com [141.146.116.13]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7JMOQZj016587 for ; Wed, 19 Aug 2009 22:24:26 GMT Received: from dradamslap1 (/141.144.160.29) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 19 Aug 2009 15:23:40 -0700 From: "Drew Adams" To: Date: Wed, 19 Aug 2009 15:23:50 -0700 Message-ID: <93AC19018012425A8D3A6E2163301F3A@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcohG7njvcs8ZKqjRUCAPo/2AOYL9Q== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: abhmt004.oracle.com [141.146.116.13] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090207.4A8C7B6D.0136:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) 1. The function doc strings need to describe the arguments. For example, these functions (at least) should say, "BOOKMARK is a bookmark name or a bookmark record." bookmark-get-bookmark, bookmark-get-bookmark-record, bookmark-prop-get, bookmark-prop-set, bookmark-get-handler, bookmark--jump-via, bookmark-jump-noselect. This is particularly important because some functions expect that their bookmark argument be a bookmark name, others expect that it be a bookmark record, and still others allow either. 2. Some functions (e.g. bookmark--jump-via) are missing doc strings altogether. In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)' From rgm@gnu.org Tue Sep 1 17:19:49 2009 Received: (at control) by emacsbugs.donarmstrong.com; 2 Sep 2009 00:19:50 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-4.7 required=4.0 tests=AWL,ONEWORD,X_DEBBUGS_NO_ACK autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n820JmgD027563 for ; Tue, 1 Sep 2009 17:19:49 -0700 Received: from rgm by fencepost.gnu.org with local (Exim 4.67) (envelope-from ) id 1MidZj-00057T-Pj; Tue, 01 Sep 2009 20:19:47 -0400 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <19101.47651.751304.471008@fencepost.gnu.org> Date: Tue, 1 Sep 2009 20:19:47 -0400 From: Glenn Morris To: control Subject: control X-Attribution: GM X-Mailer: VM (www.wonderworks.com/vm), GNU Emacs (www.gnu.org/software/emacs) X-Hue: red X-Ran: 3H"a9#$t4]il Subject: bug#4188 closed by Karl Fogel (Fixed "doc strings in bookmark.el") Message-ID: References: <87y6nqmxk0.fsf@red-bean.com> <93AC19018012425A8D3A6E2163301F3A@us.oracle.com> X-Emacs-PR-Message: they-closed 4188 X-Emacs-PR-Package: emacs Reply-To: 4188@debbugs.gnu.org Date: Mon, 05 Oct 2009 01:45:08 +0000 Content-Type: multipart/mixed; boundary="----------=_1254707109-8745-1" This is a multi-part message in MIME format... ------------=_1254707109-8745-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This is an automatic notification regarding your bug report which was filed against the emacs package: #4188: 23.1; doc strings in bookmark.el It has been closed by Karl Fogel . Their explanation is attached below along with your original report. If this explanation is unsatisfactory and you have not received a better one in a separate message then please contact Karl Fogel by replying to this email. --=20 4188: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D4188 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1254707109-8745-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 4188-close) by emacsbugs.donarmstrong.com; 5 Oct 2009 01:36:34 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.0 required=4.0 tests=AWL autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from sanpietro.red-bean.com (Debian-exim@sanpietro.red-bean.com [66.146.206.141]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n951aWNI007803 for <4188-close@emacsbugs.donarmstrong.com>; Sun, 4 Oct 2009 18:36:33 -0700 Received: from localhost ([127.0.0.1]:36736 helo=floss ident=kfogel) by sanpietro.red-bean.com with esmtp (Exim 4.69) (envelope-from ) id 1MucV6-0002Py-2a for 4188-close@emacsbugs.donarmstrong.com; Sun, 04 Oct 2009 20:36:32 -0500 From: Karl Fogel To: 4188-close@debbugs.gnu.org Subject: Fixed "doc strings in bookmark.el" Reply-To: Karl Fogel Date: Sun, 04 Oct 2009 21:36:31 -0400 Message-ID: <87y6nqmxk0.fsf@red-bean.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii fixed -- Thanks for the report. Fix committed: $ cvs ci -F msg lisp/bookmark.el lisp/ChangeLog /sources/emacs/emacs/lisp/bookmark.el,v <-- lisp/bookmark.el new revision: 1.128; previous revision: 1.127 /sources/emacs/emacs/lisp/ChangeLog,v <-- lisp/ChangeLog new revision: 1.16354; previous revision: 1.16353 Mailing notification to emacs-diffs@gnu.org... sent. $ ------------=_1254707109-8745-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 19 Aug 2009 22:23:54 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-2.5 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7JMNqHm003529 for ; Wed, 19 Aug 2009 15:23:53 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MdtZP-0005sB-SX for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2009 18:23:51 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MdtZL-0005qE-4n for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2009 18:23:51 -0400 Received: from [199.232.76.173] (port=42254 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MdtZK-0005q5-S1 for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2009 18:23:46 -0400 Received: from rcsinet11.oracle.com ([148.87.113.123]:56394 helo=rgminet11.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MdtZK-0007De-HJ for bug-gnu-emacs@gnu.org; Wed, 19 Aug 2009 18:23:46 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rgminet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7JMNwDb011028 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 19 Aug 2009 22:23:59 GMT Received: from abhmt004.oracle.com (abhmt004.oracle.com [141.146.116.13]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n7JMOQZj016587 for ; Wed, 19 Aug 2009 22:24:26 GMT Received: from dradamslap1 (/141.144.160.29) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 19 Aug 2009 15:23:40 -0700 From: "Drew Adams" To: Subject: 23.1; doc strings in bookmark.el Date: Wed, 19 Aug 2009 15:23:50 -0700 Message-ID: <93AC19018012425A8D3A6E2163301F3A@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcohG7njvcs8ZKqjRUCAPo/2AOYL9Q== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: abhmt004.oracle.com [141.146.116.13] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090207.4A8C7B6D.0136:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) 1. The function doc strings need to describe the arguments. For example, these functions (at least) should say, "BOOKMARK is a bookmark name or a bookmark record." bookmark-get-bookmark, bookmark-get-bookmark-record, bookmark-prop-get, bookmark-prop-set, bookmark-get-handler, bookmark--jump-via, bookmark-jump-noselect. This is particularly important because some functions expect that their bookmark argument be a bookmark name, others expect that it be a bookmark record, and still others allow either. 2. Some functions (e.g. bookmark--jump-via) are missing doc strings altogether. In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)' ------------=_1254707109-8745-1-- From unknown Fri Jun 20 07:28:13 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: owner@emacsbugs.donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: Thierry Volpiatto Subject: bug#4296 closed by Karl Fogel (Fixed "doc strings in bookmark.el") Message-ID: References: <87y6nqmxk0.fsf@red-bean.com> <8763c4xw7i.fsf@tux.homenetwork> X-Emacs-PR-Message: they-closed 4296 X-Emacs-PR-Package: emacs Reply-To: 4296@debbugs.gnu.org Date: Mon, 05 Oct 2009 01:45:10 +0000 Content-Type: multipart/mixed; boundary="----------=_1254707110-8745-3" This is a multi-part message in MIME format... ------------=_1254707110-8745-3 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This is an automatic notification regarding your bug report which was filed against the emacs package: #4188: 23.1; Change bookmark comments to docstring. It has been closed by Karl Fogel . Their explanation is attached below along with your original report. If this explanation is unsatisfactory and you have not received a better one in a separate message then please contact Karl Fogel by replying to this email. --=20 4188: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D4188 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1254707110-8745-3 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 4188-close) by emacsbugs.donarmstrong.com; 5 Oct 2009 01:36:34 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.0 required=4.0 tests=AWL autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from sanpietro.red-bean.com (Debian-exim@sanpietro.red-bean.com [66.146.206.141]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n951aWNI007803 for <4188-close@emacsbugs.donarmstrong.com>; Sun, 4 Oct 2009 18:36:33 -0700 Received: from localhost ([127.0.0.1]:36736 helo=floss ident=kfogel) by sanpietro.red-bean.com with esmtp (Exim 4.69) (envelope-from ) id 1MucV6-0002Py-2a for 4188-close@emacsbugs.donarmstrong.com; Sun, 04 Oct 2009 20:36:32 -0500 From: Karl Fogel To: 4188-close@debbugs.gnu.org Subject: Fixed "doc strings in bookmark.el" Reply-To: Karl Fogel Date: Sun, 04 Oct 2009 21:36:31 -0400 Message-ID: <87y6nqmxk0.fsf@red-bean.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii fixed -- Thanks for the report. Fix committed: $ cvs ci -F msg lisp/bookmark.el lisp/ChangeLog /sources/emacs/emacs/lisp/bookmark.el,v <-- lisp/bookmark.el new revision: 1.128; previous revision: 1.127 /sources/emacs/emacs/lisp/ChangeLog,v <-- lisp/ChangeLog new revision: 1.16354; previous revision: 1.16353 Mailing notification to emacs-diffs@gnu.org... sent. $ ------------=_1254707110-8745-3 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 31 Aug 2009 07:52:08 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-3.0 required=4.0 tests=AWL,FOURLA autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n7V7q578027558 for ; Mon, 31 Aug 2009 00:52:07 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mi1gL-0006F1-LQ for bug-gnu-emacs@gnu.org; Mon, 31 Aug 2009 03:52:05 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Mi1gG-0006C1-AB for bug-gnu-emacs@gnu.org; Mon, 31 Aug 2009 03:52:04 -0400 Received: from [199.232.76.173] (port=33529 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mi1gG-0006By-6R for bug-gnu-emacs@gnu.org; Mon, 31 Aug 2009 03:52:00 -0400 Received: from mx20.gnu.org ([199.232.41.8]:1455) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Mi1gF-0006wE-HM for bug-gnu-emacs@gnu.org; Mon, 31 Aug 2009 03:51:59 -0400 Received: from mail-ew0-f211.google.com ([209.85.219.211]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Mi1gD-0006co-IZ for bug-gnu-emacs@gnu.org; Mon, 31 Aug 2009 03:51:57 -0400 Received: by ewy7 with SMTP id 7so3654336ewy.31 for ; Mon, 31 Aug 2009 00:51:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:subject:organization :face:date:message-id:user-agent:mime-version:content-type; bh=yUoKTfhIDX0QOMsJIfUDPM31Bnpp2cjl8Z80dbGeEd8=; b=NGOKNxvJxyyUj5VG4gkzyh63Baf0kKHH4HINq/RhgcHDds6HrovjutaeAB55LEhSrG IXelq3xqPgmWqNTxe636UCTT1roHvU9WeD8VxBL/pwypGqnFpI2Cbrhnw0zrgcL/FWMa YnmQZ2pYLLERpZGZlHQWP/2WBKdhO+XsV2aW0= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:subject:organization:face:date:message-id:user-agent :mime-version:content-type; b=us/0afnAZJ0iMaB1Dd9wGkrWjKR5RUWekenlqQlCZqeWLJC6o8VkQJrqF3LHhJw5rO laqOMehF0F0sSMQaQgrQTwTNGLk8t0b7XLeWFVK+PR255lxaFCCYCz+jq2NeOmfd2dzM YeH50vw8rRecW6+EfLOF8kmddjWb0d23FkDNA= Received: by 10.211.172.8 with SMTP id z8mr4870670ebo.92.1251705115478; Mon, 31 Aug 2009 00:51:55 -0700 (PDT) Received: from tux.homenetwork (17.78.88-79.rev.gaoland.net [79.88.78.17]) by mx.google.com with ESMTPS id 23sm151431eya.14.2009.08.31.00.51.53 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 31 Aug 2009 00:51:54 -0700 (PDT) From: Thierry Volpiatto To: bug-gnu-emacs@gnu.org Subject: 23.1; Change bookmark comments to docstring. Organization: ThierryVolpiatto Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAElBMVEUHAwNfJRBVTESlTym0 RB/OwKFivhZqAAAACXBIWXMAAAsSAAALEgHS3X78AAAACXZwQWcAAAAwAAAAMADO7oxXAAABeElE QVQ4y3VTW47CMAyMwwUyTfYfUvG/wfC/ET4B0t7/KmsHurRgXFVVPRm/xglhsRj2+npW98G3+Amp tS5BXxl3SqzcXGRuEyf7n5lPA9jXetNPRhE7EJkzfz8YWnIgBSwW95TK4H79/t4GINKNADWj4PgA DiJX/ZxFDzDXeb4oYMw7kNUvyMzcaj3ioICG4hCKEShkPpwQ49Q05nnkGAQLDFDdExjm0qpowBYA Wi61bDlFU1GW0WbY2dSJYX5ZD2S0AiZL+rPyE19TpMzP2IvNWly+NkuWNgD4pO2oL73IQXoSyVX2 NHna7tgadWRXoCdvf2guqEcvGHqZwE520iRD0/QCYiiTE+U21w1Qxvg6iSp9fbIiDCnSAelDkCVF Vn+HekqXzRybwJ40xF4DMRG6SWGK9G1lYzHSxLYEm05GWbpJCB6A9tb9A3BGn2XdwJbS/WuInj74 4QNF8sVFdP3vl+5tgYp4Ev7fyrfFMkXgElDgV4uV/w8TWEeLCIGJ/AAAACV0RVh0Y3JlYXRlLWRh dGUAMjAwOC0wNS0zMVQyMjoxNDoyMiswMjowMM7uH/IAAAARdEVYdGpwZWc6Y29sb3JzcGFjZQAy LHVVnwAAACB0RVh0anBlZzpzYW1wbGluZy1mYWN0b3IAMngyLDF4MSwxeDFJ+qa0AAAAJXRFWHRt b2RpZnktZGF0ZQAyMDA3LTEwLTI4VDE3OjA4OjQ4KzAxOjAwhqNSRgAAAABJRU5ErkJggg== Date: Mon, 31 Aug 2009 09:45:53 +0200 Message-ID: <8763c4xw7i.fsf@tux.homenetwork> User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/23.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Detected-Operating-System: by mx20.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) Please write in English if possible, because the Emacs maintainers usually do not have translators to read other languages for them. Your bug report will be posted to the bug-gnu-emacs@gnu.org mailing list, and to the gnu.emacs.bug news group. Please describe exactly what actions triggered the bug and the precise symptoms of the bug: Hi, many functions in bookmark.el have comments instead of docstring, could you please fix that. e.g ,---- | (defun bookmark-maybe-sort-alist () | ;;Return the bookmark-alist for display. If the bookmark-sort-flag | ;;is non-nil, then return a sorted copy of the alist. `---- If Emacs crashed, and you have the Emacs process in the gdb debugger, please include the output from the following gdb commands: `bt full' and `xbacktrace'. If you would like to further debug the crash, please read the file /usr/share/emacs/23.1/etc/DEBUG for instructions. In GNU Emacs 23.1.1 (i686-pc-linux-gnu, GTK+ Version 2.16.5) of 2009-07-31 on tux Windowing system distributor `The X.Org Foundation', version 11.0.10503000 configured using `configure '--prefix=/usr' '--build=i686-pc-linux-gnu' '--host=i686-pc-linux-gnu' '--mandir=/usr/share/man' '--infodir=/usr/share/info' '--datadir=/usr/share' '--sysconfdir=/etc' '--localstatedir=/var/lib' '--program-suffix=-emacs-23' '--infodir=/usr/share/info/emacs-23' '--with-sound' '--with-x' '--without-toolkit-scroll-bars' '--with-gif' '--with-jpeg' '--with-png' '--with-rsvg' '--with-tiff' '--with-xpm' '--with-xft' '--without-libotf' '--without-m17n-flt' '--with-x-toolkit=gtk' '--without-hesiod' '--without-kerberos' '--without-kerberos5' '--with-gpm' '--with-dbus' 'build_alias=i686-pc-linux-gnu' 'host_alias=i686-pc-linux-gnu' 'CFLAGS=-march=i686 -pipe -O2' 'LDFLAGS=-Wl,-O1'' Important settings: value of $LC_ALL: fr_FR.UTF-8 value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: fr_FR.UTF-8 value of $XMODIFIERS: nil locale-coding-system: utf-8-unix default-enable-multibyte-characters: t Major mode: Lisp Interaction Minor modes in effect: eldoc-mode: t icomplete-mode: t icicle-mode: t delete-selection-mode: t minibuffer-depth-indicate-mode: t auto-image-file-mode: t shell-dirtrack-mode: t partial-completion-mode: t show-paren-mode: t display-battery-mode: t display-time-mode: t diff-auto-refine-mode: t outline-minor-mode: t recentf-mode: t savehist-mode: t desktop-save-mode: t tooltip-mode: t mouse-wheel-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent input: SPC t o SPC C-M-` C-M-y . C-c C-c C-x C-s C-x C-& a q a g C-c I & M f M p & a g C M-p M-p M-p M-p M-p M-p M-p y a b y u g L y C-x C-& C-x r l C-g C-x r l C-o o C-g C-x C-& t t q M-x s e n d C-g a p b b u u g g C-g M-x s u b m i C-g a p b u u g g C-g M-x r e p o r t Recent messages: Load: 1 file. Region is from 67 to 327 Quit Region is from 67 to 327 [2 times] Quit Computing completion candidates... Computing completion candidates... [2 times] Computing completion candidates... -- A + Thierry Volpiatto Location: Saint-Cyr-Sur-Mer - France ------------=_1254707110-8745-3-- From unknown Fri Jun 20 07:28:13 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#4188: marked as done (23.1; doc strings in bookmark.el) Reply-To: "Drew Adams" , 4188@debbugs.gnu.org Resent-From: "Drew Adams" Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Sat, 10 Oct 2009 18:25:05 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: followup 4188 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12551987823344 (code B ref -1); Sat, 10 Oct 2009 18:25:05 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 10 Oct 2009 18:19:42 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-3.9 required=4.0 tests=AWL,HAS_BUG_NUMBER autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9AIJe3j003341 for ; Sat, 10 Oct 2009 11:19:42 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MwgXc-0003GB-EF for bug-gnu-emacs@gnu.org; Sat, 10 Oct 2009 14:19:40 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MwgXX-0003Bw-TQ for bug-gnu-emacs@gnu.org; Sat, 10 Oct 2009 14:19:39 -0400 Received: from [199.232.76.173] (port=45177 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MwgXX-0003Bt-Md for bug-gnu-emacs@gnu.org; Sat, 10 Oct 2009 14:19:35 -0400 Received: from rcsinet12.oracle.com ([148.87.113.124]:52192 helo=rgminet12.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MwgXX-0004sj-8R for bug-gnu-emacs@gnu.org; Sat, 10 Oct 2009 14:19:35 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rgminet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9AIJBIB006674 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 10 Oct 2009 18:19:12 GMT Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n9AHkIL8016567; Sat, 10 Oct 2009 18:20:24 GMT Received: from abhmt015.oracle.com by acsmt358.oracle.com with ESMTP id 20332062151255198734; Sat, 10 Oct 2009 13:18:54 -0500 Received: from dradamslap1 (/24.5.184.158) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 10 Oct 2009 11:18:54 -0700 From: "Drew Adams" To: "'Karl Fogel'" , References: <87y6nqmxk0.fsf@red-bean.com><93AC19018012425A8D3A6E2163301F3A@us.oracle.com> Date: Sat, 10 Oct 2009 11:17:55 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcpFXd51RvyrScilQzCVwXe9elUGNQEd46dQ In-Reply-To: X-MIMEOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: acsmt355.oracle.com [141.146.40.155] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090205.4AD0D032.00A2:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) >> 2. Some functions (e.g. bookmark--jump-via) are missing doc strings >> altogether. There are still some things that need doc strings. `bookmark-current-buffer', for instance. The doc strings of other functions (e.g. `bookmark-yank-word' need to refer to this buffer, but they cannot refer to it by name, since `buffer-current-buffer' has no doc string. From unknown Fri Jun 20 07:28:13 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#4188: marked as done (23.1; doc strings in bookmark.el) Reply-To: Karl Fogel , 4188@debbugs.gnu.org Resent-From: Karl Fogel Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Sat, 10 Oct 2009 22:05:05 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: followup 4188 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12552117092271 (code B ref -1); Sat, 10 Oct 2009 22:05:05 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 10 Oct 2009 21:55:09 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=-1.4 required=4.0 tests=AWL,HAS_BUG_NUMBER autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n9ALt7Nb002192 for ; Sat, 10 Oct 2009 14:55:09 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mwju7-0003n0-Ef for bug-gnu-emacs@gnu.org; Sat, 10 Oct 2009 17:55:07 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Mwju2-0003eD-WF for bug-gnu-emacs@gnu.org; Sat, 10 Oct 2009 17:55:07 -0400 Received: from [199.232.76.173] (port=54745 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mwju2-0003e6-P1 for bug-gnu-emacs@gnu.org; Sat, 10 Oct 2009 17:55:02 -0400 Received: from sanpietro.red-bean.com ([66.146.206.141]:48396) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Mwju2-0002D8-DZ for bug-gnu-emacs@gnu.org; Sat, 10 Oct 2009 17:55:02 -0400 Received: from localhost ([127.0.0.1]:45419 helo=floss ident=kfogel) by sanpietro.red-bean.com with esmtp (Exim 4.69) (envelope-from ) id 1Mwju1-0006d6-KZ; Sat, 10 Oct 2009 16:55:01 -0500 From: Karl Fogel To: "Drew Adams" Cc: References: <87y6nqmxk0.fsf@red-bean.com> <93AC19018012425A8D3A6E2163301F3A@us.oracle.com> Date: Sat, 10 Oct 2009 17:55:01 -0400 In-Reply-To: (Drew Adams's message of "Sat, 10 Oct 2009 11:17:55 -0700") Message-ID: <87aazy7w3u.fsf@red-bean.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) "Drew Adams" writes: >>> 2. Some functions (e.g. bookmark--jump-via) are missing doc strings >>> altogether. > > There are still some things that need doc strings. > > `bookmark-current-buffer', for instance. The doc strings of other > functions (e.g. `bookmark-yank-word' need to refer to this buffer, but > they cannot refer to it by name, since `buffer-current-buffer' has no > doc string. Oops, sorry, missed the variables. Fixed in these two revs: $ cvs ci -F msg lisp/bookmark.el lisp/ChangeLog /sources/emacs/emacs/lisp/bookmark.el,v <-- lisp/bookmark.el new revision: 1.135; previous revision: 1.134 /sources/emacs/emacs/lisp/ChangeLog,v <-- lisp/ChangeLog new revision: 1.16400; previous revision: 1.16399 Mailing notification to emacs-diffs@gnu.org... sent. $ cvs ci -F msg lisp/bookmark.el lisp/ChangeLog /sources/emacs/emacs/lisp/bookmark.el,v <-- lisp/bookmark.el new revision: 1.136; previous revision: 1.135 /sources/emacs/emacs/lisp/ChangeLog,v <-- lisp/ChangeLog new revision: 1.16401; previous revision: 1.16400 Mailing notification to emacs-diffs@gnu.org... sent. $