From unknown Sat Jun 21 05:15:08 2025 X-Loop: help-debbugs@gnu.org Subject: bug#33443: 26; Doc of Edit Abbrevs mode Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 20 Nov 2018 16:55:04 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 33443 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 33443@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.15427328671991 (code B ref -1); Tue, 20 Nov 2018 16:55:04 +0000 Received: (at submit) by debbugs.gnu.org; 20 Nov 2018 16:54:27 +0000 Received: from localhost ([127.0.0.1]:35442 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gP9I9-0000Vp-VC for submit@debbugs.gnu.org; Tue, 20 Nov 2018 11:54:27 -0500 Received: from eggs.gnu.org ([208.118.235.92]:52103) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gP9I7-0000U8-F6 for submit@debbugs.gnu.org; Tue, 20 Nov 2018 11:54:24 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gP9I0-0001K4-UJ for submit@debbugs.gnu.org; Tue, 20 Nov 2018 11:54:18 -0500 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 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:43177) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gP9Hz-0001JN-T8 for submit@debbugs.gnu.org; Tue, 20 Nov 2018 11:54:16 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:33456) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gP9Hz-0004ZF-0y for bug-gnu-emacs@gnu.org; Tue, 20 Nov 2018 11:54:15 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gP9Hv-0001Fu-Ql for bug-gnu-emacs@gnu.org; Tue, 20 Nov 2018 11:54:14 -0500 Received: from userp2120.oracle.com ([156.151.31.85]:46392) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gP9Hv-0001Eo-FN for bug-gnu-emacs@gnu.org; Tue, 20 Nov 2018 11:54:11 -0500 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id wAKGs4mA076785 for ; Tue, 20 Nov 2018 16:54:10 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=UqpsgTToci2fxCx/C4+lqQRfZhOaYZV08YT3mydygCI=; b=sKtcbvQkZwu/CMysO/gzKX6UAiO1brQNIUJSDgqyQG7U7+svNTeAUoTdoDrZ2SLz+PsR 3PelKSZT71NDnDEZpR7TMFKOZA71tcmvsQ0Si97ys9bUrnDp2QJGdNJAvRIvn71y3KGr 5WJf+kf2zykAE75g/jF1L2NAf1Vr4l+2fOH5sMk/8i3yW6Otx69oKQ5i/TZb6u81eddP iihutbzFgW1Lya5B0sL+QSdjNCYS4OoS3GnVTYP88lSpzBZQvpm7YWmriQRHoITn/A9E 77Y8S2pdeqRxQk+KnwF6T3R4cXciTo79M70b8+EtT3JAUMXFxngT+uNNo8mxk29l+NDc Nw== Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp2120.oracle.com with ESMTP id 2ntbmqn0p7-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 20 Nov 2018 16:54:10 +0000 Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id wAKGs9LJ009521 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 20 Nov 2018 16:54:09 GMT Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id wAKGs9vm022697 for ; Tue, 20 Nov 2018 16:54:09 GMT MIME-Version: 1.0 Message-ID: Date: Tue, 20 Nov 2018 08:54:08 -0800 (PST) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4771.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9082 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 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-1811200150 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) 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: -5.0 (-----) In `edit-abbrevs-mode' I hit `C-h m' to find out about the mode, what I'm seeing in the buffer, and what I can do with it. This is all I get, which I feel is not very useful: Edit-Abbrevs mode defined in `abbrev.el' (`edit-abbrevs-mode'): Major mode for editing the list of abbrev definitions. This mode runs the hook `edit-abbrevs-mode-hook', as the final or penultim= ate step during initialization. key binding --- ------- C-c Prefix Command C-x Prefix Command C-c C-c edit-abbrevs-redefine C-x C-s abbrev-edit-save-buffer C-x C-w abbrev-edit-save-to-file [One of those help lines is 82 chars long, BTW.] You have to roam around in the source file a bit to find out what you're looking at and what you can do with it. In particular, the doc of `edit-abbrevs' tells you what you're looking at and what you can do with what you're looking at. It is... a buffer containing a list of abbrev definitions with point located in the abbrev table of current buffer. You can edit them and type C-c C-c to redefine abbrevs according to your editing. Buffer contains a header line for each abbrev table, which is the abbrev table name in parentheses. This is followed by one line per abbrev in that table: NAME USECOUNT EXPANSION HOOK where NAME and EXPANSION are strings with quotes, USECOUNT is an integer, and HOOK is any valid function or may be omitted (it is usually omitted). This description is pretty summary, lacking explanation about abbrevs, but it is certainly better than what `edit-abbrevs-mode' tells you. ("Current buffer" is wrong here, BTW, as what is meant by it is not the buffer of buffer *Abbrevs* but the buffer that you came from to create buffer *Abbrevs*.) You can get to an Edit-Abbrev mode buffer in several ways. Once you are there `C-h m' should tell you what it is and what you can do with it. Similarly, the doc in the Emacs manual (node `Abbrev Concepts' is not very helpful. It tells you how you can use (expand) an existing abbrev, but it says nothing about how to create an abbrev, for instance. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From unknown Sat Jun 21 05:15:08 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Drew Adams Subject: bug#33443: closed (Re: bug#33443: 26; Doc of Edit Abbrevs mode) Message-ID: References: <83y39kf62c.fsf@gnu.org> X-Gnu-PR-Message: they-closed 33443 X-Gnu-PR-Package: emacs Reply-To: 33443@debbugs.gnu.org Date: Fri, 23 Nov 2018 10:22:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1542968522-22566-1" This is a multi-part message in MIME format... ------------=_1542968522-22566-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #33443: 26; Doc of Edit Abbrevs mode which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 33443@debbugs.gnu.org. --=20 33443: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D33443 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1542968522-22566-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 33443-done) by debbugs.gnu.org; 23 Nov 2018 10:21:21 +0000 Received: from localhost ([127.0.0.1]:43024 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gQ8aO-0005r7-Vz for submit@debbugs.gnu.org; Fri, 23 Nov 2018 05:21:21 -0500 Received: from eggs.gnu.org ([208.118.235.92]:39668) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gQ8aO-0005qw-2o for 33443-done@debbugs.gnu.org; Fri, 23 Nov 2018 05:21:20 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gQ8a7-00040t-QV for 33443-done@debbugs.gnu.org; Fri, 23 Nov 2018 05:21:10 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=BAYES_05 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:44014) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gQ8a7-00040T-ND; Fri, 23 Nov 2018 05:21:03 -0500 Received: from [176.228.60.248] (port=3330 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gQ8a7-0006gj-1B; Fri, 23 Nov 2018 05:21:03 -0500 Date: Fri, 23 Nov 2018 12:20:59 +0200 Message-Id: <83y39kf62c.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: (message from Drew Adams on Tue, 20 Nov 2018 08:54:08 -0800 (PST)) Subject: Re: bug#33443: 26; Doc of Edit Abbrevs mode References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 33443-done Cc: 33443-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: -6.0 (------) > Date: Tue, 20 Nov 2018 08:54:08 -0800 (PST) > From: Drew Adams > > Edit-Abbrevs mode defined in `abbrev.el' (`edit-abbrevs-mode'): > Major mode for editing the list of abbrev definitions. > > This mode runs the hook `edit-abbrevs-mode-hook', as the final or penultimate step > during initialization. > > key binding > --- ------- > > C-c Prefix Command > C-x Prefix Command > > C-c C-c edit-abbrevs-redefine > > C-x C-s abbrev-edit-save-buffer > C-x C-w abbrev-edit-save-to-file > > [One of those help lines is 82 chars long, BTW.] Yes. > You have to roam around in the source file a bit to find out what you're > looking at and what you can do with it. In particular, the doc of > `edit-abbrevs' tells you what you're looking at and what you can do with > what you're looking at. It is... I added to the doc string of 'edit-abbrevs-mode' a reference to 'edit-abbrevs', where this stuff is described. This mode is specifically designed for editing in such a buffer, so I see no need to repeat the documentation there, as users are unlikely to turn that mode by themselves. > ("Current buffer" is wrong here, BTW, as what is meant > by it is not the buffer of buffer *Abbrevs* but the > buffer that you came from to create buffer *Abbrevs*.) No, "current buffer" is not wrong, since the editing buffer is prepared for editing abbrevs of the buffer that is current when the function is invoked. > Similarly, the doc in the Emacs manual (node `Abbrev Concepts' is not > very helpful. It tells you how you can use (expand) an existing abbrev, > but it says nothing about how to create an abbrev, for instance. "Abbrev Concepts" is not where this is described. Please read the following sections. Thanks. ------------=_1542968522-22566-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 20 Nov 2018 16:54:27 +0000 Received: from localhost ([127.0.0.1]:35442 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gP9I9-0000Vp-VC for submit@debbugs.gnu.org; Tue, 20 Nov 2018 11:54:27 -0500 Received: from eggs.gnu.org ([208.118.235.92]:52103) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gP9I7-0000U8-F6 for submit@debbugs.gnu.org; Tue, 20 Nov 2018 11:54:24 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gP9I0-0001K4-UJ for submit@debbugs.gnu.org; Tue, 20 Nov 2018 11:54:18 -0500 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 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:43177) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gP9Hz-0001JN-T8 for submit@debbugs.gnu.org; Tue, 20 Nov 2018 11:54:16 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:33456) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gP9Hz-0004ZF-0y for bug-gnu-emacs@gnu.org; Tue, 20 Nov 2018 11:54:15 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gP9Hv-0001Fu-Ql for bug-gnu-emacs@gnu.org; Tue, 20 Nov 2018 11:54:14 -0500 Received: from userp2120.oracle.com ([156.151.31.85]:46392) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gP9Hv-0001Eo-FN for bug-gnu-emacs@gnu.org; Tue, 20 Nov 2018 11:54:11 -0500 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id wAKGs4mA076785 for ; Tue, 20 Nov 2018 16:54:10 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=UqpsgTToci2fxCx/C4+lqQRfZhOaYZV08YT3mydygCI=; b=sKtcbvQkZwu/CMysO/gzKX6UAiO1brQNIUJSDgqyQG7U7+svNTeAUoTdoDrZ2SLz+PsR 3PelKSZT71NDnDEZpR7TMFKOZA71tcmvsQ0Si97ys9bUrnDp2QJGdNJAvRIvn71y3KGr 5WJf+kf2zykAE75g/jF1L2NAf1Vr4l+2fOH5sMk/8i3yW6Otx69oKQ5i/TZb6u81eddP iihutbzFgW1Lya5B0sL+QSdjNCYS4OoS3GnVTYP88lSpzBZQvpm7YWmriQRHoITn/A9E 77Y8S2pdeqRxQk+KnwF6T3R4cXciTo79M70b8+EtT3JAUMXFxngT+uNNo8mxk29l+NDc Nw== Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp2120.oracle.com with ESMTP id 2ntbmqn0p7-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 20 Nov 2018 16:54:10 +0000 Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id wAKGs9LJ009521 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 20 Nov 2018 16:54:09 GMT Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id wAKGs9vm022697 for ; Tue, 20 Nov 2018 16:54:09 GMT MIME-Version: 1.0 Message-ID: Date: Tue, 20 Nov 2018 08:54:08 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 26; Doc of Edit Abbrevs mode X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4771.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9082 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 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-1811200150 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) 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: -5.0 (-----) In `edit-abbrevs-mode' I hit `C-h m' to find out about the mode, what I'm seeing in the buffer, and what I can do with it. This is all I get, which I feel is not very useful: Edit-Abbrevs mode defined in `abbrev.el' (`edit-abbrevs-mode'): Major mode for editing the list of abbrev definitions. This mode runs the hook `edit-abbrevs-mode-hook', as the final or penultim= ate step during initialization. key binding --- ------- C-c Prefix Command C-x Prefix Command C-c C-c edit-abbrevs-redefine C-x C-s abbrev-edit-save-buffer C-x C-w abbrev-edit-save-to-file [One of those help lines is 82 chars long, BTW.] You have to roam around in the source file a bit to find out what you're looking at and what you can do with it. In particular, the doc of `edit-abbrevs' tells you what you're looking at and what you can do with what you're looking at. It is... a buffer containing a list of abbrev definitions with point located in the abbrev table of current buffer. You can edit them and type C-c C-c to redefine abbrevs according to your editing. Buffer contains a header line for each abbrev table, which is the abbrev table name in parentheses. This is followed by one line per abbrev in that table: NAME USECOUNT EXPANSION HOOK where NAME and EXPANSION are strings with quotes, USECOUNT is an integer, and HOOK is any valid function or may be omitted (it is usually omitted). This description is pretty summary, lacking explanation about abbrevs, but it is certainly better than what `edit-abbrevs-mode' tells you. ("Current buffer" is wrong here, BTW, as what is meant by it is not the buffer of buffer *Abbrevs* but the buffer that you came from to create buffer *Abbrevs*.) You can get to an Edit-Abbrev mode buffer in several ways. Once you are there `C-h m' should tell you what it is and what you can do with it. Similarly, the doc in the Emacs manual (node `Abbrev Concepts' is not very helpful. It tells you how you can use (expand) an existing abbrev, but it says nothing about how to create an abbrev, for instance. In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.16299 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' ------------=_1542968522-22566-1--