emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] master cee4128: Merge from origin/emacs-25


From: Glenn Morris
Subject: [Emacs-diffs] master cee4128: Merge from origin/emacs-25
Date: Fri, 28 Apr 2017 01:08:14 -0400 (EDT)

branch: master
commit cee4128135d0d9fd6032a0134b649d5fc81370c0
Merge: f0daad9 784602b
Author: Glenn Morris <address@hidden>
Commit: Glenn Morris <address@hidden>

    Merge from origin/emacs-25
    
    784602b1050 (origin/emacs-25) ; Add release notice
    3a34412caae (tag: emacs-25.2) Set Emacs version to 25.2 and update AU...
    56a4461a48d ; Move stray item from admin/notes/repo to CONTRIBUTE
    2b0d1118199 ; CONTRIBUTE: Remove stray header.
    f2ab09ec60d Fix a typo in indexing the user manual
    bc55a574235 * lisp/menu-bar.el (kill-this-buffer): Doc fix.  (Bug#26466)
    a6d50401b4b Document 'line-pixel-height'
    0c55cf43e61 * search.c (Fre_search_forward, Fre_search_backward): Imp...
    c7ed57eaef4 Mention that processes start in default-directory (Bug#18...
    856ec9ffa1f * src/xdisp.c (vmessage, message): Clarify commentary.
    849a0aaa1c9 Belated fixes for admin.el's M-x make-manuals-dist
    84938d79698 default-directory: Remark that it must be a directory name
    3f0d047d2eb Delete confuse statement in manual
    ee1bd94dd0c Improve packaging documentation
    fb18bff91f0 Expand manual section on quitting windows
    9a737079645 Fix docstring of dabbrev-abbrev-char-regexp
    afe8849bac1 * doc/misc/cl.texi (Iteration Clauses): Clarify example (...
    ada79442c07 ;* doc/misc/info.texi (Choose menu subtopic): Improve ind...
    d38fd9229c0 Narrow scope of modification hook renabling in org-src fo...
    e0e9db4c84a ; Spelling fix
    
    # Conflicts:
    #   README
    #   etc/AUTHORS
    #   etc/HISTORY
    #   lisp/ldefs-boot.el
---
 CONTRIBUTE                 |   6 +-
 ChangeLog.2                | 205 ++++++++++++++++++++++++++++++++++++++++++++-
 admin/admin.el             |   9 +-
 admin/notes/repo           |   7 --
 doc/emacs/cmdargs.texi     |   4 +-
 doc/lispref/display.texi   |   6 ++
 doc/lispref/package.texi   |  12 +--
 doc/lispref/processes.texi |  13 ++-
 doc/lispref/tips.texi      |  11 ++-
 doc/misc/cl.texi           |  16 +---
 doc/misc/info.texi         |   6 ++
 etc/HISTORY                |   2 +
 lisp/dabbrev.el            |  32 ++++---
 lisp/menu-bar.el           |   5 +-
 lisp/org/org-src.el        |  18 ++--
 lisp/subr.el               |   7 +-
 src/buffer.c               |   4 +-
 src/callproc.c             |   4 +
 src/search.c               |  52 +++++-------
 src/xdisp.c                |  10 ++-
 20 files changed, 328 insertions(+), 101 deletions(-)

diff --git a/CONTRIBUTE b/CONTRIBUTE
index 92a76d8..188ec86 100644
--- a/CONTRIBUTE
+++ b/CONTRIBUTE
@@ -209,7 +209,11 @@ reasons.  These should be marked by including something 
like "Do not
 merge to master" or anything that matches gitmerge-skip-regexp (see
 admin/gitmerge.el) in the commit message.
 
-** Other process information
+** GNU ELPA
+
+This repository does not contain the Emacs Lisp package archive
+(elpa.gnu.org).  See admin/notes/elpa for how to access the GNU ELPA
+repository.
 
 ** Emacs Mailing lists.
 
diff --git a/ChangeLog.2 b/ChangeLog.2
index c1e10b1..4b266e1 100644
--- a/ChangeLog.2
+++ b/ChangeLog.2
@@ -1,3 +1,206 @@
+2017-04-20  Nicolas Petton  <address@hidden>
+
+       * Version 25.2 released.
+
+2017-04-18  Eli Zaretskii  <address@hidden>
+
+       Fix a typo in indexing the user manual
+
+       * doc/emacs/cmdargs.texi (General Variables): Fix a horrible typo.
+
+2017-04-12  Eli Zaretskii  <address@hidden>
+
+       * lisp/menu-bar.el (kill-this-buffer): Doc fix.  (Bug#26466)
+
+2017-04-11  Eli Zaretskii  <address@hidden>
+
+       Document 'line-pixel-height'
+
+       * doc/lispref/display.texi (Size of Displayed Text): Document
+       line-pixel-height.  Suggested by Tak Kunihiro
+       <address@hidden>.  (Bug#26379)
+
+2017-04-07  Hong Xu  <address@hidden>
+
+       * src/search.c (Fre_search_forward, Fre_search_backward): Improve doc 
(Bug#25193).
+
+2017-04-07  Noam Postavsky  <address@hidden>
+
+       Mention that processes start in default-directory (Bug#18515)
+
+       * doc/lispref/processes.texi (Synchronous Processes):
+       (Asynchronous Processes):
+       * lisp/subr.el (start-process):
+       * src/callproc.c (call-process): Mention that the subprocess starts in
+       `default-directory' when local, suggest `start-file-process' and
+       `process-file' otherwise.
+
+2017-04-07  Noam Postavsky  <address@hidden>
+
+       * src/xdisp.c (vmessage, message): Clarify commentary.
+
+2017-04-02  Glenn Morris  <address@hidden>
+
+       Belated fixes for admin.el's M-x make-manuals-dist
+
+       * admin/admin.el (make-manuals-dist-output-variables): Additions.
+       (make-manuals-dist--1): Also copy docstyle.texi.
+
+2017-03-31  Tino Calancha  <address@hidden>
+
+       default-directory: Remark that it must be a directory name
+
+       * src/buffer.c (default-directory): Update docstring (Bug#26272).
+
+2017-03-31  Tino Calancha  <address@hidden>
+
+       Delete confuse statement in manual
+
+       * doc/misc/cl.texi (For Clauses): Delete confuse statement
+       and its example (Bug#23550).
+
+2017-03-31  Noam Postavsky  <address@hidden>
+
+       Improve packaging documentation
+
+       * doc/lispref/package.texi (Packaging Basics):
+       * doc/lispref/tips.texi (Library Headers): Clarify some header
+       formats, relation between file headers and package
+       attributes (Bug#13281).
+
+2017-03-27  Eric Abrahamsen  <address@hidden>
+
+       Expand manual section on quitting windows
+
+       * doc/lispref/windows.texi (Quitting Windows): Provide more
+         information about the elements of the quit-restore window parameter,
+         and how they affect the behavior of quit-restore-window.
+
+2017-03-26  Noam Postavsky  <address@hidden>
+
+       Fix docstring of dabbrev-abbrev-char-regexp
+
+       * lisp/dabbrev.el (dabbrev-abbrev-char-regexp): Using a value of nil
+       is equivalent to "\\sw\\|\\s_", and has no special behavior.  If the
+       previous character doesn't match, we search backwards for one that
+       does, not throw an error.  Replace Lisp example with C based one to
+       make it clear that "symbol" means a sequence of word and symbol
+       constituent characters, not a Lisp symbol (Bug#358).
+
+2017-03-26  Johan Claesson  <address@hidden>  (tiny change)
+
+       * doc/misc/cl.texi (Iteration Clauses): Clarify example (Bug#19515).
+
+2017-03-25  Eli Zaretskii  <address@hidden>
+
+       ;* doc/misc/info.texi (Choose menu subtopic): Improve indexing.  
(Bug#26236)
+
+2017-03-21  Noam Postavsky  <address@hidden>
+
+       Narrow scope of modification hook renabling in org-src fontification
+
+       Modification hooks should be enabled while modifying text in the
+       org-src temp buffer, but in 2017-01-29 "Call modification hooks in
+       org-src fontify buffers" the hooks were enabled also for modifications
+       to the original org buffer.  This causes fontification errors when
+       combined with certain packages, as reported in
+       http://lists.gnu.org/archive/html/emacs-orgmode/2017-03/msg00420.html.
+
+       * lisp/org/org-src.el (org-src-font-lock-fontify-block): Reduce scope
+       of inhibit-modification-hooks let-binding.
+
+2017-03-17  Eli Zaretskii  <address@hidden>
+
+       Improve documentation of interactive "r".
+
+       * doc/lispref/commands.texi (Interactive Codes): Mention that mark
+       must be set for "r" to work.
+
+2017-03-17  Thien-Thi Nguyen  <address@hidden>
+
+       Fix bug: Range-check integer ‘alpha’ frame parm value
+
+       Typo introduced 2013-04-01, "Prefer < to >
+       in range checks such as 0 <= i && i < N".
+
+       * src/frame.c (x_set_alpha): Use ‘ialpha’, not ‘alpha’.
+
+2017-03-17  Paul Eggert  <address@hidden>
+
+       * etc/PROBLEMS: Say that HP-UX cc doesn't work.
+
+2017-03-14  Eli Zaretskii  <address@hidden>
+
+       Fix duplicate wording in Emacs manual
+
+       * doc/emacs/programs.texi (Which Function): Delete duplicate
+       wording.  (Bug#26098)
+
+2017-03-14  Hong Xu  <address@hidden>
+
+       * lisp/paren.el (show-paren--default, show-paren-function): Add 
docstring.
+
+2017-03-13  Eli Zaretskii  <address@hidden>
+
+       Fix wording in Emacs manual
+
+       * doc/emacs/text.texi (Paragraphs): Fix a garbled sentence.
+       (Bug#26086)
+
+2017-03-11  Eli Zaretskii  <address@hidden>
+
+       Document how to customize input methods
+
+       * doc/emacs/mule.texi (Input Methods): Document how to customize
+       input methods.
+
+2017-03-11  Eli Zaretskii  <address@hidden>
+
+       * lisp/net/eww.el (eww-reload): Doc fix.  (Bug#25981)
+
+2017-03-06  Noam Postavsky  <address@hidden>
+
+       Fix warning message about native completion (Bug#25984)
+
+       * lisp/progmodes/python.el 
(python-shell-completion-native-turn-on-maybe):
+       The relevant variable is `python-shell-completion-native-enable'.
+
+2017-03-04  Eli Zaretskii  <address@hidden>
+
+       Clarify documentation of 'raise' and 'height' display specs
+
+       * doc/lispref/display.texi (Other Display Specs): Clarify the
+       effect of 'height' display spec on the following 'raise'.
+       (Bug#25824)
+
+2017-03-04  Eli Zaretskii  <address@hidden>
+
+       Mention problems with GPaste in PROBLEMS
+
+       * etc/PROBLEMS (GPaste): Mention the problem in yanking caused by
+       GPaste, and its solution.  (Bug#25902)
+
+2017-02-25  Eli Zaretskii  <address@hidden>
+
+       Fix doc strings in info.el
+
+       * lisp/info.el (Info-selection-hook, Info-mode-hook)
+       (Info-edit-mode-hook): Doc fixes.  (Bug#25794)
+
+2017-02-25  Eli Zaretskii  <address@hidden>
+
+       Fix doc string of 'posn-at-point'
+
+       * src/keyboard.c (Fposn_at_point): Clarify the doc string.
+       (Bug#25796)
+
+2017-02-24  Tino Calancha  <address@hidden>
+
+       Documentation fix in elisp reference manual
+
+       * doc/lispref/macros.texi (Defining Macros): Drop redundant mention
+       on 'declare' forms (Bug#25846).
+
 2017-02-18  Noam Postavsky  <address@hidden>
 
        * lisp/woman.el (woman): Fix docstring prefix arg description.
@@ -35641,7 +35844,7 @@
 
 This file records repository revisions from
 commit 9d56a21e6a696ad19ac65c4b405aeca44785884a (exclusive) to
-commit ec4226d81074751c105264a3a3383c48d0a05e41 (inclusive).
+commit 3a34412caae002accd0fc7a7fc0b718c2f34159b (inclusive).
 See ChangeLog.1 for earlier changes.
 
 ;; Local Variables:
diff --git a/admin/admin.el b/admin/admin.el
index 5428e3a..e81e7f1 100644
--- a/admin/admin.el
+++ b/admin/admin.el
@@ -655,7 +655,10 @@ style=\"text-align:left\">")
     ("@GZIP_PROG@" . "gzip")
     ("@INSTALL@" . "install -c")
     ("@INSTALL_DATA@" . "${INSTALL} -m 644")
-    ("@configure_input@" . ""))
+    ("@configure_input@" . "")
+    ("@AM_DEFAULT_VERBOSITY@" . "0")
+    ("@AM_V@" . "${V}")
+    ("@AM_DEFAULT_V@" . "${AM_DEFAULT_VERBOSITY}"))
   "Alist of (REGEXP . REPLACEMENT) pairs for `make-manuals-dist'.")
 
 (defun make-manuals-dist--1 (root type)
@@ -675,7 +678,9 @@ style=\"text-align:left\">")
        (delete-directory stem t))
     (make-directory stem)
     (copy-file "../doc/misc/texinfo.tex" stem)
-    (or (equal type "emacs") (copy-file "../doc/emacs/emacsver.texi" stem))
+    (unless (equal type "emacs")
+      (copy-file "../doc/emacs/emacsver.texi" stem)
+      (copy-file "../doc/emacs/docstyle.texi" stem))
     (dolist (file (directory-files (format "../doc/%s" type) t))
       (if (or (string-match-p "\\(\\.texi\\'\\|/README\\'\\)" file)
              (and (equal type "lispintro")
diff --git a/admin/notes/repo b/admin/notes/repo
index 3ab3da7..0da1e1e 100644
--- a/admin/notes/repo
+++ b/admin/notes/repo
@@ -1,12 +1,5 @@
 NOTES ON COMMITTING TO EMACS'S REPOSITORY    -*- outline -*-
 
-** elpa
-
-This branch does not contain a copy of Emacs, but of the Emacs Lisp
-package archive (elpa.gnu.org).  See admin/notes/elpa for further
-explanation, and the README file in the branch for usage
-instructions.
-
 * Install changes only on one branch, let them get merged elsewhere if needed.
 
 In particular, install bug-fixes only on the release branch (if there
diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi
index 6c39fe7..6f76ef3 100644
--- a/doc/emacs/cmdargs.texi
+++ b/doc/emacs/cmdargs.texi
@@ -470,11 +470,11 @@ bus as well as autolaunching the D-Bus session bus if not 
running yet.
 Directory for the architecture-independent files that come with Emacs.
 This is used to initialize the variable @code{data-directory}.
 @item EMACSDOC
-#vindex EMACSDOC, environment variable
address@hidden EMACSDOC, environment variable
 Directory for the documentation string file, which is used to
 initialize the Lisp variable @code{doc-directory}.
 @item EMACSLOADPATH
-#vindex EMACSLOADPATH, environment variable
address@hidden EMACSLOADPATH, environment variable
 A colon-separated list of address@hidden and below,
 whenever we say ``colon-separated list of directories'', it pertains
 to Unix and GNU/Linux systems.  On MS-DOS and MS-Windows, the
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 7a6a216..51e31aa 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -1974,6 +1974,12 @@ line, if present, in the return value.  If it is 
@code{t}, include the
 height of both, if present, in the return value.
 @end defun
 
address@hidden line-pixel-height
+This function returns the height in pixels of the line at point in the
+selected window.  The value includes the line spacing of the line
+(@pxref{Line Height}).
address@hidden defun
+
 
 @node Line Height
 @section Line Height
diff --git a/doc/lispref/package.texi b/doc/lispref/package.texi
index 1b37337..af05d1e 100644
--- a/doc/lispref/package.texi
+++ b/doc/lispref/package.texi
@@ -54,7 +54,8 @@ prefix used in the program (@pxref{Coding Conventions}).
 @item Version
 A version number, in a form that the function @code{version-to-list}
 understands (e.g., @samp{11.86}).  Each release of a package should be
-accompanied by an increase in the version number.
+accompanied by an increase in the version number so that it will be
+recognized as an upgrade by users querying the package archive.
 
 @item Brief description
 This is shown when the package is listed in the Package Menu.  It
@@ -71,8 +72,9 @@ once it is installed.
 A list of other packages (possibly including minimal acceptable
 version numbers) on which this package depends.  The list may be
 empty, meaning this package has no dependencies.  Otherwise,
-installing this package also automatically installs its dependencies;
-if any dependency cannot be found, the package cannot be installed.
+installing this package also automatically installs its dependencies,
+recursively; if any dependency cannot be found, the package cannot be
+installed.
 @end table
 
 @cindex content directory, package
@@ -212,8 +214,8 @@ subdirectories of the content directory.
   One of the files in the content directory must be named
 @address@hidden  It must contain a single Lisp form,
 consisting of a call to the function @code{define-package}, described
-below.  This defines the package's version, brief description, and
-requirements.
+below.  This defines the package's attributes: version, brief
+description, and requirements.
 
   For example, if we distribute version 1.3 of the superfrobnicator as
 a multi-file package, the tar file would be
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index 6308533..1d200ce 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -300,8 +300,11 @@ system, much like text written into a file.  @xref{Coding 
Systems}.
 @defun call-process program &optional infile destination display &rest args
 This function calls @var{program} and waits for it to finish.
 
-The current working directory of the subprocess is
address@hidden
+The current working directory of the subprocess is set to the current
+buffer's value of @code{default-directory} if that is local (as
+determined by @code{unhandled-file-name-directory}), or "~" otherwise.
+If you want to run a process in a remote directory use
address@hidden
 
 The standard input for the new process comes from file @var{infile} if
 @var{infile} is not @code{nil}, and from the null device otherwise.
@@ -683,6 +686,12 @@ created with @code{make-pipe-process}, described below.
 
 The original argument list, modified with the actual connection
 information, is available via the @code{process-contact} function.
+
+The current working directory of the subprocess is set to the current
+buffer's value of @code{default-directory} if that is local (as
+determined by `unhandled-file-name-directory'), or "~" otherwise.  If
+you want to run a process in a remote direcotry use
address@hidden
 @end defun
 
 @defun make-pipe-process &rest args
diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi
index 4e2a0fa..35abd8e 100644
--- a/doc/lispref/tips.texi
+++ b/doc/lispref/tips.texi
@@ -1046,12 +1046,15 @@ package manager both at download time (to ensure that a 
complete set
 of packages is downloaded) and at activation time (to ensure that a
 package is only activated if all its dependencies have been).
 
-Its format is a list of lists.  The @code{car} of each sub-list is the
-name of a package, as a symbol.  The @code{cadr} of each sub-list is
-the minimum acceptable version number, as a string.  For instance:
+Its format is a list of lists on a single line.  The @code{car} of
+each sub-list is the name of a package, as a symbol.  The @code{cadr}
+of each sub-list is the minimum acceptable version number, as a string
+that can be parse by @code{version-to-list}.  An entry that lacks a
+version (i.e., an entry which is just a symbol, or a sub-list of one
+element) is equivalent to entry with version "0".  For instance:
 
 @smallexample
-;; Package-Requires: ((gnus "1.0") (bubbles "2.7.2"))
+;; Package-Requires: ((gnus "1.0") (bubbles "2.7.2") cl-lib (seq))
 @end smallexample
 
 The package code automatically defines a package named @samp{emacs}
diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi
index 2339d57..33b4858 100644
--- a/doc/misc/cl.texi
+++ b/doc/misc/cl.texi
@@ -1976,18 +1976,6 @@ This clause iterates @var{var} over all the cons cells 
of @var{list}.
         @result{} ((1 2 3 4) (2 3 4) (3 4) (4))
 @end example
 
-With @code{by}, there is no real reason that the @code{on} expression
-must be a list.  For example:
-
address@hidden
-(cl-loop for x on first-animal by 'next-animal collect x)
address@hidden example
-
address@hidden
-where @code{(next-animal x)} takes an ``animal'' @var{x} and returns
-the next in the (assumed) sequence of animals, or @code{nil} if
address@hidden was the last animal in the sequence.
-
 @item for @var{var} in-ref @var{list} by @var{function}
 This is like a regular @code{in} clause, but @var{var} becomes
 a @code{setf}-able ``reference'' onto the elements of the list
@@ -2252,8 +2240,8 @@ were address@hidden, the loop returns @code{t}:
 
 @example
 (if (cl-loop for size in size-list always (> size 10))
-    (some-big-sizes)
-  (no-big-sizes))
+    (only-big-sizes)
+  (some-small-sizes))
 @end example
 
 @item never @var{condition}
diff --git a/doc/misc/info.texi b/doc/misc/info.texi
index 6f2e53a..3db8e8e 100644
--- a/doc/misc/info.texi
+++ b/doc/misc/info.texi
@@ -1108,6 +1108,7 @@ other file with @kbd{g(@var{filename})address@hidden
 @kindex 1 @r{through} 9 @r{(Info mode)}
 @findex Info-nth-menu-item
 @cindex select @var{n}'th menu item
address@hidden menu items, select by their numbers
   If you begrudge each character of type-in which your system requires,
 you might like to use the commands @kbd{1}, @kbd{2}, @kbd{3}, @kbd{4},
 @dots{}, @kbd{9}.  They are short for the @kbd{m} command together
@@ -1116,6 +1117,11 @@ in the current node's menu; @kbd{2} goes through the 
second item, etc.
 In the stand-alone reader, @kbd{0} goes through the last menu item;
 this is so you need not count how many entries are there.
 
address@hidden 3rd menu item
address@hidden third menu item
address@hidden 6th menu item
address@hidden sixth menu item
address@hidden star @samp{*} before menu item
   If your display supports multiple fonts, colors or underlining, and
 you are using Emacs's Info mode to read Info files, the third, sixth
 and ninth menu items have a @samp{*} that stands out, either in color
diff --git a/etc/HISTORY b/etc/HISTORY
index 43790bb..ad38b32 100644
--- a/etc/HISTORY
+++ b/etc/HISTORY
@@ -209,6 +209,8 @@ GNU Emacs 24.5 (2015-04-10) emacs-24.5
 
 GNU Emacs 25.1 (2016-09-16) emacs-25.1
 
+GNU Emacs 25.2 (2017-04-20) emacs-25.2
+
 
 ----------------------------------------------------------------------
 This file is part of GNU Emacs.
diff --git a/lisp/dabbrev.el b/lisp/dabbrev.el
index 3550d75..9c9dc8a 100644
--- a/lisp/dabbrev.el
+++ b/lisp/dabbrev.el
@@ -191,23 +191,21 @@ This variable has an effect only when the value of
 This regexp will be surrounded with \\\\( ... \\\\) when actually used.
 
 Set this variable to \"\\\\sw\" if you want ordinary words or
-\"\\\\sw\\\\|\\\\s_\" if you want symbols (including characters whose
-syntax is \"symbol\" as well as those whose syntax is \"word\".
-
-The value nil has a special meaning: the abbreviation is from point to
-previous word-start, but the search is for symbols.
-
-For instance, if you are programming in Lisp, `yes-or-no-p' is a symbol,
-while `yes', `or', `no' and `p' are considered words.  If this
-variable is nil, then expanding `yes-or-no-' looks for a symbol
-starting with or containing `no-'.  If you set this variable to
-\"\\\\sw\\\\|\\\\s_\", that expansion looks for a symbol starting with
-`yes-or-no-'.  Finally, if you set this variable to \"\\\\sw\", then
-expanding `yes-or-no-' signals an error because `-' is not part of a word;
-but expanding `yes-or-no' looks for a word starting with `no'.
-
-The recommended value is nil, which will make dabbrev default to
-using \"\\\\sw\\\\|\\\\s_\"."
+\"\\\\sw\\\\|\\\\s_\" if you want symbols (including characters
+whose syntax is \"symbol\" as well as those whose syntax is
+\"word\").  The abbreviation is from point to the start of the
+previous sequence of characters matching this variable.
+
+The default value of nil is equivalent to \"\\\\sw\\\\|\\\\s_\".
+
+For instance, suppose the current buffer is in `c-mode'.  If this
+variable is nil or \"\\\\sw\\\\|\\\\s_\", then expanding
+`debug_print_in_' looks for a symbol starting with
+`debug_print_in_'.  If you set this variable to \"\\\\sw\", that
+expansion looks for a word prefixed with `in_' (e.g., it would
+match `in_range', but not `in_close_range').  If expanding
+`debug_print_in' it would look for a word starting with
+`in' (e.g. `integer')."
   :type '(choice (const nil)
                 regexp)
   :group 'dabbrev)
diff --git a/lisp/menu-bar.el b/lisp/menu-bar.el
index 28464f1..719173c 100644
--- a/lisp/menu-bar.el
+++ b/lisp/menu-bar.el
@@ -1898,7 +1898,10 @@ updating the menu."
 (defun kill-this-buffer ()     ; for the menu bar
   "Kill the current buffer.
 When called in the minibuffer, get out of the minibuffer
-using `abort-recursive-edit'."
+using `abort-recursive-edit'.
+
+This command can be reliably invoked only from the menu bar,
+otherwise it could decide to silently do nothing."
   (interactive)
   (cond
    ;; Don't do anything when `menu-frame' is not alive or visible
diff --git a/lisp/org/org-src.el b/lisp/org/org-src.el
index caa6526..4eb8a53 100644
--- a/lisp/org/org-src.el
+++ b/lisp/org/org-src.el
@@ -919,15 +919,15 @@ fontification of code blocks see `org-src-fontify-block' 
and
             ;; from `jit-lock-function' (Bug#25132).
             (let ((inhibit-modification-hooks nil))
               (delete-region (point-min) (point-max))
-              (insert string " ") ;; so there's a final property change
-              (unless (eq major-mode lang-mode) (funcall lang-mode))
-              (org-font-lock-ensure)
-              (setq pos (point-min))
-              (while (setq next (next-single-property-change pos 'face))
-                (put-text-property
-                 (+ start (1- pos)) (1- (+ start next)) 'face
-                 (get-text-property pos 'face) org-buffer)
-                (setq pos next))))
+              (insert string " ")) ;; so there's a final property change
+            (unless (eq major-mode lang-mode) (funcall lang-mode))
+            (org-font-lock-ensure)
+            (setq pos (point-min))
+            (while (setq next (next-single-property-change pos 'face))
+              (put-text-property
+               (+ start (1- pos)) (1- (+ start next)) 'face
+               (get-text-property pos 'face) org-buffer)
+              (setq pos next)))
          (add-text-properties
           start end
           '(font-lock-fontified t fontified t font-lock-multiline t))
diff --git a/lisp/subr.el b/lisp/subr.el
index 1dd5d2f..02e7993 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -2077,7 +2077,12 @@ arguments PROGRAM-ARGS are strings to give program as 
arguments.
 
 If you want to separate standard output from standard error, use
 `make-process' or invoke the command through a shell and redirect
-one of them using the shell syntax."
+one of them using the shell syntax.
+
+The process runs in `default-directory' if that is local (as
+determined by `unhandled-file-name-directory'), or \"~\"
+otherwise.  If you want to run a process in a remote directory
+use `start-file-process'."
   (unless (fboundp 'make-process)
     (error "Emacs was compiled without subprocess support"))
   (apply #'make-process
diff --git a/src/buffer.c b/src/buffer.c
index ff4a500..33ffdf8 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5629,7 +5629,9 @@ visual lines rather than logical lines.  See the 
documentation of
   DEFVAR_PER_BUFFER ("default-directory", &BVAR (current_buffer, directory),
                     Qstringp,
                     doc: /* Name of default directory of current buffer.
-To interactively change the default directory, use command `cd'.  */);
+It should be a directory name (as opposed to a directory file-name).
+On GNU and Unix systems, directory names end in a slash `/'.
+To interactively change the default directory, use command `cd'. */);
 
   DEFVAR_PER_BUFFER ("auto-fill-function", &BVAR (current_buffer, 
auto_fill_function),
                     Qnil,
diff --git a/src/callproc.c b/src/callproc.c
index 792556c..e967e45 100644
--- a/src/callproc.c
+++ b/src/callproc.c
@@ -242,6 +242,10 @@ Otherwise it waits for PROGRAM to terminate
 and returns a numeric exit status or a signal description string.
 If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.
 
+The process runs in `default-directory' if that is local (as
+determined by `unhandled-file-name-directory'), or "~" otherwise.  If
+you want to run a process in a remote directory use `process-file'.
+
 usage: (call-process PROGRAM &optional INFILE DESTINATION DISPLAY &rest ARGS)  
*/)
   (ptrdiff_t nargs, Lisp_Object *args)
 {
diff --git a/src/search.c b/src/search.c
index c0deb57..f5f9e46 100644
--- a/src/search.c
+++ b/src/search.c
@@ -2228,26 +2228,12 @@ See also the functions `match-beginning', `match-end' 
and `replace-match'.  */)
 
 DEFUN ("re-search-backward", Fre_search_backward, Sre_search_backward, 1, 4,
        "sRE search backward: ",
-       doc: /* Search backward from point for match for regular expression 
REGEXP.
-Set point to the beginning of the occurrence found, and return point.
-An optional second argument bounds the search; it is a buffer position.
-  The match found must not begin before that position.  A value of nil
-  means search to the beginning of the accessible portion of the buffer.
-Optional third argument, if t, means if fail just return nil (no error).
-  If not nil and not t, position at limit of search and return nil.
-Optional fourth argument COUNT, if a positive number, means to search
-  for COUNT successive occurrences.  If COUNT is negative, search
-  forward, instead of backward, for -COUNT occurrences.  A value of
-  nil means the same as 1.
-With COUNT positive, the match found is the COUNTth to last one (or
-  last, if COUNT is 1 or nil) in the buffer located entirely before
-  the origin of the search; correspondingly with COUNT negative.
+       doc: /* Search backward from point for regular expression REGEXP.
+This function is almost identical to `re-search-forward', except that
+by default it searches backward instead of forward, and the sign of
+COUNT also indicates exactly the opposite searching direction.
 
-Search case-sensitivity is determined by the value of the variable
-`case-fold-search', which see.
-
-See also the functions `match-beginning', `match-end', `match-string',
-and `replace-match'.  */)
+See `re-search-forward' for details.  */)
   (Lisp_Object regexp, Lisp_Object bound, Lisp_Object noerror, Lisp_Object 
count)
 {
   return search_command (regexp, bound, noerror, count, -1, 1, 0);
@@ -2257,18 +2243,22 @@ DEFUN ("re-search-forward", Fre_search_forward, 
Sre_search_forward, 1, 4,
        "sRE search: ",
        doc: /* Search forward from point for regular expression REGEXP.
 Set point to the end of the occurrence found, and return point.
-An optional second argument bounds the search; it is a buffer position.
-  The match found must not end after that position.  A value of nil
-  means search to the end of the accessible portion of the buffer.
-Optional third argument, if t, means if fail just return nil (no error).
-  If not nil and not t, move to limit of search and return nil.
-Optional fourth argument COUNT, if a positive number, means to search
-  for COUNT successive occurrences.  If COUNT is negative, search
-  backward, instead of forward, for -COUNT occurrences.  A value of
-  nil means the same as 1.
-With COUNT positive, the match found is the COUNTth one (or first,
-  if COUNT is 1 or nil) in the buffer located entirely after the
-  origin of the search; correspondingly with COUNT negative.
+The optional second argument BOUND is a buffer position that bounds
+  the search.  The match found must not end after that position.  A
+  value of nil means search to the end of the accessible portion of
+  the buffer.
+The optional third argument NOERROR indicates how errors are handled
+  when the search fails.  If it is nil or omitted, emit an error; if
+  it is t, simply return nil and do nothing; if it is neither nil nor
+  t, move to the limit of search and return nil.
+The optional fourth argument COUNT is a number that indicates the
+  search direction and the number of occurrences to search for.  If it
+  is positive, search forward for COUNT successive occurrences; if it
+  is negative, search backward, instead of forward, for -COUNT
+  occurrences.  A value of nil means the same as 1.
+With COUNT positive/negative, the match found is the COUNTth/-COUNTth
+  one in the buffer located entirely after/before the origin of the
+  search.
 
 Search case-sensitivity is determined by the value of the variable
 `case-fold-search', which see.
diff --git a/src/xdisp.c b/src/xdisp.c
index 3e6a307..41458c3 100644
--- a/src/xdisp.c
+++ b/src/xdisp.c
@@ -10530,9 +10530,12 @@ message_with_string (const char *m, Lisp_Object 
string, bool log)
 /* Dump an informative message to the minibuf.  If M is 0, clear out
    any existing message, and let the mini-buffer text show through.
 
-   The message must be safe ASCII and the format must not contain ` or
-   '.  If your message and format do not fit into this category,
-   convert your arguments to Lisp objects and use Fmessage instead.  */
+   The message must be safe ASCII (because when Emacs is
+   non-interactive the message is sent straight to stderr without
+   encoding first) and the format must not contain ` or ' (because
+   this function does not account for `text-quoting-style').  If your
+   message and format do not fit into this category, convert your
+   arguments to Lisp objects and use Fmessage instead.  */
 
 static void ATTRIBUTE_FORMAT_PRINTF (1, 0)
 vmessage (const char *m, va_list ap)
@@ -10590,6 +10593,7 @@ vmessage (const char *m, va_list ap)
     }
 }
 
+/* See vmessage for restrictions on the text of the message.  */
 void
 message (const char *m, ...)
 {



reply via email to

[Prev in Thread] Current Thread [Next in Thread]