From unknown Thu Aug 14 21:46:01 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#23016 <23016@debbugs.gnu.org> To: bug#23016 <23016@debbugs.gnu.org> Subject: Status: 25.1; First proof reading of emacs/abbrevs.texi and lispref/abbrevs.texi Reply-To: bug#23016 <23016@debbugs.gnu.org> Date: Fri, 15 Aug 2025 04:46:01 +0000 retitle 23016 25.1; First proof reading of emacs/abbrevs.texi and lispref/a= bbrevs.texi reassign 23016 emacs submitter 23016 Steve Byrne severity 23016 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Mon Mar 14 23:49:36 2016 Received: (at submit) by debbugs.gnu.org; 15 Mar 2016 03:49:36 +0000 Received: from localhost ([127.0.0.1]:48371 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1affzD-00022n-OY for submit@debbugs.gnu.org; Mon, 14 Mar 2016 23:49:36 -0400 Received: from eggs.gnu.org ([208.118.235.92]:52291) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1afet5-0000Bp-Ky for submit@debbugs.gnu.org; Mon, 14 Mar 2016 22:39:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1afesy-0000MH-Qa for submit@debbugs.gnu.org; Mon, 14 Mar 2016 22:39:06 -0400 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,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:49101) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1afesy-0000M8-NH for submit@debbugs.gnu.org; Mon, 14 Mar 2016 22:39:04 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:43257) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1afesx-0000Yc-8g for bug-gnu-emacs@gnu.org; Mon, 14 Mar 2016 22:39:04 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1afesu-0000JI-0g for bug-gnu-emacs@gnu.org; Mon, 14 Mar 2016 22:39:03 -0400 Received: from resqmta-po-02v.sys.comcast.net ([96.114.154.161]:48483) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1afest-0000Fw-Pw for bug-gnu-emacs@gnu.org; Mon, 14 Mar 2016 22:38:59 -0400 Received: from resomta-po-19v.sys.comcast.net ([96.114.154.243]) by resqmta-po-02v.sys.comcast.net with comcast id W2du1s0035FMDhs012duBk; Tue, 15 Mar 2016 02:37:54 +0000 Received: from [10.19.1.34] ([73.11.84.182]) by resomta-po-19v.sys.comcast.net with comcast id W2dt1s00K3w1rT5012duJY; Tue, 15 Mar 2016 02:37:54 +0000 From: Steve Byrne X-Pgp-Agent: GPGMail 2.6b2 Content-Type: multipart/signed; boundary="Apple-Mail=_D8477462-82C1-483C-B565-619046DCA4BD"; protocol="application/pgp-signature"; micalg=pgp-sha1 Subject: 25.1; First proof reading of emacs/abbrevs.texi and lispref/abbrevs.texi Date: Mon, 14 Mar 2016 19:37:53 -0700 Message-Id: To: bug-gnu-emacs@gnu.org Mime-Version: 1.0 (Mac OS X Mail 9.2 \(3112\)) X-Mailer: Apple Mail (2.3112) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net; s=q20140121; t=1458009474; bh=nOXEPmf4nVKCOtDA51aPB4aciHkzSRJ044O7QYRTtBU=; h=Received:Received:From:Content-Type:Subject:Date:Message-Id:To: Mime-Version; b=bcLp6HIjCUO8y8PVzM/iEIEedVbAOfxJq7KFRGurfn2hdBNn+s01xPjXCM+U31POD ozT95PCE9CFMMb98RuGKeXKw7l5DOT45mZliZRkp8Aw+w8H51I7m9lg+BMRHmdEveK Bd4YkpvYoVC0rbYlDsy67y2I9A01xdPZUJktN7wMRceR40CFmrB9w9/WlUYZdVArsh Et27gmUl+oaJu7hHyhTe9ve/CaYfCVV+AVRSba/qdrM3JfFDB7AEoF9jpR84aqaV3V m674Fun88Aw2RFpUb4LEQ9aCULFwbzAsj8DciJtIYvh3RFOHTWadVjm6p2OHrD6gTq ZRiMOxg6G6a3A== X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Mon, 14 Mar 2016 23:49:34 -0400 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 (-----) --Apple-Mail=_D8477462-82C1-483C-B565-619046DCA4BD Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=us-ascii My first cut at proofing. I hope it will be ok that I hand-crafted this = email message; M-x report-emacs-bug wanted to use a mail program that = isn't present on OS X ;) $ git diff -p sbb-initial sbb-first-changes diff --git a/admin/release-process b/admin/release-process index f378662..72129bf 100644 --- a/admin/release-process +++ b/admin/release-process @@ -238,7 +238,7 @@ TUTORIAL.zh ** Check the manual. -abbrevs.texi +abbrevs.texi Steve Byrne ack.texi anti.texi arevert-xtra.texi @@ -293,7 +293,7 @@ xresources.texi ** Check the Lisp manual. -abbrevs.texi +abbrevs.texi Steve Byrne anti.texi back.texi backups.texi diff --git a/doc/emacs/abbrevs.texi b/doc/emacs/abbrevs.texi index e0441a1..7fba728 100644 --- a/doc/emacs/abbrevs.texi +++ b/doc/emacs/abbrevs.texi @@ -414,7 +414,6 @@ case while searching for expansions (@pxref{Lax = Search}). @emph{of the dynamic abbrev you are expanding}, by converting the expansion to that case pattern. -@vindex dabbrev-case-fold-search The variable @code{dabbrev-case-replace} controls whether to preserve the case pattern of the dynamic abbrev. If it is @code{t}, the dynamic abbrev's case pattern is preserved in most cases; if it is @@ -432,12 +431,13 @@ copies the expansion verbatim including its case = pattern. @vindex dabbrev-abbrev-char-regexp The variable @code{dabbrev-abbrev-char-regexp}, if non-@code{nil}, -controls which characters are considered part of a word, for dynamic = expansion -purposes. The regular expression must match just one character, never -two or more. The same regular expression also determines which -characters are part of an expansion. The value @code{nil} has a = special -meaning: dynamic abbrevs are made of word characters, but expansions = are -made of word and symbol characters. +controls which characters are considered part of a word, for dynamic +expansion purposes. The regular expression must match just one +character, never two or more. The same regular expression also +determines which characters are part of an expansion. The value +@code{nil} (the default value) has a special meaning: dynamic abbrevs +are made of word characters, but expansions are made of word and +symbol characters. @vindex dabbrev-abbrev-skip-leading-regexp In shell scripts and makefiles, a variable name is sometimes prefixed @@ -445,4 +445,4 @@ with @samp{$} and sometimes not. Major modes for = this kind of text can customize dynamic abbrev expansion to handle optional prefixes by = setting the variable @code{dabbrev-abbrev-skip-leading-regexp}. Its value should be a regular expression that matches the optional prefix that -dynamic abbrev expression should ignore. +dynamic abbrev expression should ignore. Its default value is = @code{nil}. diff --git a/doc/lispref/abbrevs.texi b/doc/lispref/abbrevs.texi index 5f5a395..769ff03 100644 --- a/doc/lispref/abbrevs.texi +++ b/doc/lispref/abbrevs.texi @@ -198,7 +198,8 @@ abbrevs in a file automatically, under the control = of variables described here. @defopt abbrev-file-name -This is the default file name for reading and saving abbrevs. +This is the default file name for reading and saving abbrevs. Its = default +value is @file{~/.emacs.d/abbrev_defs}. @end defopt @defun quietly-read-abbrev-file &optional filename @@ -216,7 +217,7 @@ A non-@code{nil} value for @code{save-abbrevs} means = that Emacs should offer to save abbrevs (if any have changed) when files are saved. If the value is @code{silently}, Emacs saves the abbrevs without asking the user. @code{abbrev-file-name} specifies the file to save the -abbrevs in. +abbrevs in. Its default value is @code{t}. @end defopt @defvar abbrevs-changed @@ -283,6 +284,8 @@ be the name by which this abbrev was found (a = string); it is used to figure out whether to adjust the capitalization of the expansion. The function returns @code{abbrev} if the abbrev was successfully inserted. +@c [sbb] what does it retrurn if name is not found? nil? +@c [sbb] what happens if start is defined but ent is not? (Text should = say) @end defun @deffn Command abbrev-prefix-mark &optional arg @@ -298,7 +301,7 @@ next abbrev to be expanded. The actual expansion = removes the hyphen. @end deffn @defopt abbrev-all-caps -When this is set non-@code{nil}, an abbrev entered entirely in upper +When this is set to non-@code{nil}, an abbrev entered entirely in upper case is expanded using all upper case. Otherwise, an abbrev entered entirely in upper case is expanded by capitalizing each word of the expansion. @@ -331,6 +334,8 @@ Abbrevs, emacs, The GNU Emacs Manual}). This is the location of the most recent abbrev expanded. This contains information left by @code{expand-abbrev} for the sake of the @code{unexpand-abbrev} command. +@c when is it cleared? Should we state that? Presumably its initial = value is +@c nil, should that be stated as well? @end defvar @defvar last-abbrev-text @@ -389,6 +394,8 @@ global table. The value of this buffer-local variable is the (mode-specific) abbreviation table of the current buffer. It can also be a list of such tables. +@c [sbb] Should we explain in a little more detail this list of abbrev = tables +@c [sbb] idea? Such as precedence among the tables for identical = abbrevs? @end defvar @defvar abbrev-minor-mode-table-alist @@ -397,6 +404,8 @@ The value of this variable is a list of elements of = the form of a variable: if the variable is bound to a non-@code{nil} value, then the @var{abbrev-table} is active, otherwise it is ignored. @var{abbrev-table} can also be a list of abbrev tables. +@c [sbb] Should we explain in a little more detail this list of abbrev = tables +@c [sbb] idea? Such as precedence among the tables for identical = abbrevs? @end defvar @defvar fundamental-mode-abbrev-table @@ -498,6 +507,7 @@ non-word syntax. @item :parents This property holds a list of tables from which to inherit other abbrevs. +@c [sbb] Should talk about precedence among the tables here. @item :abbrev-table-modiff This property holds a counter incremented each time a new abbrev is --Apple-Mail=_D8477462-82C1-483C-B565-619046DCA4BD Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=signature.asc Content-Type: application/pgp-signature; name=signature.asc Content-Description: Message signed with OpenPGP using GPGMail -----BEGIN PGP SIGNATURE----- Comment: GPGTools - http://gpgtools.org iEYEARECAAYFAlbndYEACgkQmwLalbCxG6R8ZACeJUyBtIGWmZpSbXCwicO06MWH 69AAn1L/BT8VOEqqjPY3NX3hDEjdv657 =YTpv -----END PGP SIGNATURE----- --Apple-Mail=_D8477462-82C1-483C-B565-619046DCA4BD-- From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 16 13:18:23 2016 Received: (at 23016) by debbugs.gnu.org; 16 Mar 2016 17:18:23 +0000 Received: from localhost ([127.0.0.1]:50403 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1agF5T-0004Ji-Ly for submit@debbugs.gnu.org; Wed, 16 Mar 2016 13:18:23 -0400 Received: from eggs.gnu.org ([208.118.235.92]:44203) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1agF5R-0004JW-QW for 23016@debbugs.gnu.org; Wed, 16 Mar 2016 13:18:22 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1agF5J-00014h-UL for 23016@debbugs.gnu.org; Wed, 16 Mar 2016 13:18:16 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_20,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:37053) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1agF5J-00014c-Qs; Wed, 16 Mar 2016 13:18:13 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1428 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1agF5J-0002sw-2c; Wed, 16 Mar 2016 13:18:13 -0400 Date: Wed, 16 Mar 2016 19:17:52 +0200 Message-Id: <83lh5i9wan.fsf@gnu.org> From: Eli Zaretskii To: Steve Byrne In-reply-to: (message from Steve Byrne on Mon, 14 Mar 2016 19:37:53 -0700) Subject: Re: bug#23016: 25.1; First proof reading of emacs/abbrevs.texi and lispref/abbrevs.texi 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: 23016 Cc: 23016@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: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > From: Steve Byrne > Date: Mon, 14 Mar 2016 19:37:53 -0700 > > My first cut at proofing. I hope it will be ok that I hand-crafted this email message; M-x report-emacs-bug wanted to use a mail program that isn't present on OS X ;) Thanks, I will deal with this in a couple of days. For the future, I think it would be best if you reported the problems and their suggested solutions in plain English, not as patches, since you don't have copyright assignment on file for Emacs, so we are limited in how many of your patches we will be able to apply. From debbugs-submit-bounces@debbugs.gnu.org Sat Mar 19 07:27:10 2016 Received: (at 23016-done) by debbugs.gnu.org; 19 Mar 2016 11:27:10 +0000 Received: from localhost ([127.0.0.1]:53216 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ahF2E-00078r-EY for submit@debbugs.gnu.org; Sat, 19 Mar 2016 07:27:10 -0400 Received: from eggs.gnu.org ([208.118.235.92]:53659) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ahF2C-00078f-SK for 23016-done@debbugs.gnu.org; Sat, 19 Mar 2016 07:27:09 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ahF24-00043k-FB for 23016-done@debbugs.gnu.org; Sat, 19 Mar 2016 07:27:03 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:52764) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ahF24-00043g-C7; Sat, 19 Mar 2016 07:27:00 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3475 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1ahF23-00050u-Ol; Sat, 19 Mar 2016 07:27:00 -0400 Date: Sat, 19 Mar 2016 13:26:31 +0200 Message-Id: <83h9g2909k.fsf@gnu.org> From: Eli Zaretskii To: sbb@penguinis.org In-reply-to: <83lh5i9wan.fsf@gnu.org> (message from Eli Zaretskii on Wed, 16 Mar 2016 19:17:52 +0200) Subject: Re: bug#23016: 25.1; First proof reading of emacs/abbrevs.texi and lispref/abbrevs.texi References: <83lh5i9wan.fsf@gnu.org> 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: 23016-done Cc: 23016-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: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Wed, 16 Mar 2016 19:17:52 +0200 > From: Eli Zaretskii > Cc: 23016@debbugs.gnu.org > > > From: Steve Byrne > > Date: Mon, 14 Mar 2016 19:37:53 -0700 > > > > My first cut at proofing. I hope it will be ok that I hand-crafted this email message; M-x report-emacs-bug wanted to use a mail program that isn't present on OS X ;) > > Thanks, I will deal with this in a couple of days. Done, thanks. I decided not to expand the documentation of the variables that are not user options, but don't let this discourage you from raising similar issues in the future, as the decisions there might well be different. From unknown Thu Aug 14 21:46:01 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 17 Apr 2016 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator