From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Steve Byrne Newsgroups: gmane.emacs.bugs Subject: bug#23016: 25.1; First proof reading of emacs/abbrevs.texi and lispref/abbrevs.texi Date: Mon, 14 Mar 2016 19:37:53 -0700 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 (Mac OS X Mail 9.2 \(3112\)) Content-Type: multipart/signed; boundary="Apple-Mail=_D8477462-82C1-483C-B565-619046DCA4BD"; protocol="application/pgp-signature"; micalg=pgp-sha1 X-Trace: ger.gmane.org 1458013829 21085 80.91.229.3 (15 Mar 2016 03:50:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 15 Mar 2016 03:50:29 +0000 (UTC) To: 23016@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Mar 15 04:50:14 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1affzp-00038e-0i for geb-bug-gnu-emacs@m.gmane.org; Tue, 15 Mar 2016 04:50:13 +0100 Original-Received: from localhost ([::1]:45277 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1affzo-0005CS-J2 for geb-bug-gnu-emacs@m.gmane.org; Mon, 14 Mar 2016 23:50:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37881) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1affzk-0005A6-Rj for bug-gnu-emacs@gnu.org; Mon, 14 Mar 2016 23:50:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1affze-0003GL-9N for bug-gnu-emacs@gnu.org; Mon, 14 Mar 2016 23:50:08 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51244) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1affze-0003GF-5a for bug-gnu-emacs@gnu.org; Mon, 14 Mar 2016 23:50:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1affzd-00023c-Uy for bug-gnu-emacs@gnu.org; Mon, 14 Mar 2016 23:50:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Steve Byrne Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 15 Mar 2016 03:50:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 23016 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.14580137767865 (code B ref -1); Tue, 15 Mar 2016 03:50:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 15 Mar 2016 03:49:36 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 X-Pgp-Agent: GPGMail 2.6b2 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-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 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:114926 Archived-At: --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--