diff options
author | Glenn Morris <rgm@gnu.org> | 2017-04-27 22:03:56 -0700 |
---|---|---|
committer | Glenn Morris <rgm@gnu.org> | 2017-04-27 22:03:56 -0700 |
commit | cee4128135d0d9fd6032a0134b649d5fc81370c0 (patch) | |
tree | e62e97cbe32f4ca4f9540fe528dac0394702efdf /doc/lispref | |
parent | f0daad9adc5b8fd19f60f89e96b286a78f7162b3 (diff) | |
parent | 784602b10506c50075aa9463891a47380ebea55f (diff) | |
download | emacs-cee4128135d0d9fd6032a0134b649d5fc81370c0.tar.gz |
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
Diffstat (limited to 'doc/lispref')
-rw-r--r-- | doc/lispref/display.texi | 6 | ||||
-rw-r--r-- | doc/lispref/package.texi | 12 | ||||
-rw-r--r-- | doc/lispref/processes.texi | 13 | ||||
-rw-r--r-- | doc/lispref/tips.texi | 11 |
4 files changed, 31 insertions, 11 deletions
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 7a6a21649e4..51e31aa273f 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 +@defun 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}). +@end defun + @node Line Height @section Line Height diff --git a/doc/lispref/package.texi b/doc/lispref/package.texi index 1b37337c15b..af05d1ef58c 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 @file{@var{name}-pkg.el}. 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 630853384e8..1d200ce1362 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 -@code{default-directory}. +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 +@code{process-file}. 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 +@code{start-file-process}. @end defun @defun make-pipe-process &rest args diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi index 4e2a0fad1fa..35abd8e79db 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} |