Commit graph

5486 commits

Author SHA1 Message Date
Paul Eggert
dc152c54f4 Modernize usage of 'macOS' in doc and comments
Apple changed the spelling of its operating system again, to "macOS",
effective with macOS 10.12 Sierra (2016-09-20).  Change Emacs
documentation and comments to match this.  Stick with older OS
spellings ("OS X", "Mac OS X") when talking about older releases where
the older names are more correct.
2016-11-06 00:42:03 -07:00
Noam Postavsky
bb61e50533 * doc/lispref/loading.texi (Autoload): Better link (Bug#24845). 2016-11-05 10:12:03 -04:00
Eli Zaretskii
3ef86fd063 Clarify documentation of face attribute functions
* doc/lispref/display.texi (Attribute Functions): Make sure to
document that an omitted FRAME argument means the same as nil.
(Bug#24879)
2016-11-05 10:54:15 +02:00
Paul Eggert
acae275b27 ; Spelling fixes 2016-11-04 14:50:59 -07:00
Hong Xu
23570fd995 Clarify documentation of 'vc-responsible-backend' wrt symlinks
* lisp/vc/vc.el (vc-responsible-backend): Clarify that symlinks
are not resolved when the VC backend is reported.

* doc/lispref/files.texi (Truenames): Document
'vc-responsible-backend'.  (Bug#23436)
* doc/emacs/maintaining.texi (Version Control Systems): Fix a
typo.
2016-11-04 12:06:00 +02:00
Eli Zaretskii
bdc89eb4a6 Improve documentation of 'font-lock-remove-keywords'
* doc/lispref/modes.texi (Customizing Keywords): Clarify the
'keywords' argument of 'font-lock-remove-keywords'.  Suggested by
Hong Xu <hong@topbug.net>.  (Bug#24830)
2016-11-04 11:16:40 +02:00
Eli Zaretskii
4a0c590cbf Fix documentation of the command summary key
* doc/misc/info.texi (Help-^L, Help-Xref, Top): Emacs Info uses
'?' for the summary of commands, whereas the stand-alone reader
uses 'H'.  (Bug#24825)
2016-11-04 10:56:11 +02:00
Thomas Fitzsimmons
5043e0a7e0 Fix documentation for 'eudc-options-file'
* doc/misc/eudc.texi (The Server Hotlist): Update the default
value of 'eudc-options-file'.

Backport:

(cherry picked from commit 0575fd95d0)
2016-11-02 06:11:43 -04:00
Tibor Csögör
26038aa676 Fix documentation of 'eudc-inline-expansion-format'
* doc/misc/eudc.texi (Inline Query Expansion): Fix the default value of
'eudc-inline-expansion-format'. (Bug#24840)

Backport:

(cherry picked from commit 1fef1387c3)
2016-11-02 06:03:50 -04:00
Paul Eggert
6f1325ed92 electric-quote mode no longer worries about coding
* doc/emacs/text.texi (Quotation Marks), etc/NEWS: Document this.
* lisp/electric.el (electric--insertable-p): Remove.
All uses removed (Bug#24759).
2016-10-23 01:14:57 -07:00
Noam Postavsky
b2ba630739 Explain how to debug emacsclient lisp errors
* doc/lispref/debugging.texi (Error Debugging): Mention that
debug-on-signal is useful for getting backtraces from
emacsclient (Bug#24616).
2016-10-22 12:06:29 -04:00
Eli Zaretskii
8988327d54 Fix documentation of 'alist-get'
* doc/lispref/lists.texi (Association Lists): Fix the signature of
'alist-get'.  Fix the markup, the wording, and the punctuation in
the description. (Bug#24740)
2016-10-19 21:10:31 +03:00
Michael Albinus
6b9dee1ae6 Change Tramp version to "2.2.13.25.2"
* doc/misc/trampver.texi:
* lisp/net/trampver.el: Change version to "2.2.13.25.2".
2016-10-19 10:35:52 +02:00
Alan Mackenzie
4f406e9813 CC Mode manual: remove reference to former Emacs variable last-command-char
* doc/misc/cc-mode.texi (Hanging Semicolons and Commas): Replace reference to
variable last-command-char by one to macro c-last-command-char.
2016-10-09 13:42:57 +00:00
Eli Zaretskii
c03d44bb3d ; Fix last commit
* doc/lispref/functions.texi (Argument List): Restore the index
entry for 'wrong-number-of-arguments'.  (Bug#24222)
* doc/lispref/errors.texi: Fix cross-reference for
'wrong-number-of-arguments'.
2016-10-08 17:16:33 +03:00
Eli Zaretskii
d4be4f3f12 ; Fix indexing in lispref manual
* doc/lispref/functions.texi (Argument List): Remove the index
entry for 'wrong-number-of-arguments'.  (Bug#24222)
2016-10-08 17:01:54 +03:00
Wilfred Hughes
ed399f26fa ; Minor improvement in documentation of generators
* doc/lispref/control.texi (Generators): Add a 'require' to the
example code.  (Bug#24539)
2016-10-08 16:44:47 +03:00
Noam Postavsky
fb12af2084 ; Merge: some backports from master
Regression in Emacs 25.1
* "Don't require isearch-update before isearch-done"

This bug actually crashes in emacs-25
* "Avoid error in icalendar--read-element"

Doc fixes
* "Make a menu less ambiguous"
* "Doc fix for url-http"
2016-10-06 21:20:32 -04:00
Eli Zaretskii
c4a5e7e18d Improve documentation of 'menu-bar-open'
* lisp/term/w32-win.el (w32-menu-bar-open): Clarify that sometimes
two ESC keypresses are needed to exit the menu.

* doc/emacs/screen.texi (Menu Bar): Qualify the description of how
to exit menus.  (Bug#24596)
2016-10-06 21:46:48 +03:00
John Wiegley
4ef9ea2b2a
Add documentation note from Alex 2016-10-05 09:15:18 -07:00
Philippe Vaucher
f2144eef19 Restore 'command-debug-status' functionality
* src/callint.c (Fcall_interactively): Bind command-debug-status
to nil.  This restores functionality inadvertently removed in
Emacs 25.1.  (Bug#24555)

* lisp/subr.el (command-debug-status): Declare obsolete.

* doc/lispref/debugging.texi (Internals of Debugger): Document
that 'command-debug-status' is obsolete.
2016-10-04 17:34:51 +03:00
Katsumi Yamaoka
9fc81bcf74 * doc/misc/message.texi (Bcc Warning): Fix markup. 2016-10-03 03:03:40 +00:00
Katsumi Yamaoka
95baa25ff0 * doc/misc/message.texi (Bcc Warning):
Document mml-secure-safe-bcc-list.
2016-10-03 02:43:20 +00:00
Lars Ingebrigtsen
ace9d227dd Make a menu less ambiguous
* doc/emacs/custom.texi (Key Bindings): The Modifier Keys node
is about using modifier keys, not binding them (bug#10942).

(cherry picked from commit 214f85a0a6)
2016-10-02 12:27:33 -04:00
Paul Eggert
bbf1ffd7c7 Regexp Functions doc minor fixes
* doc/lispref/searching.texi (Regexp Functions):
Fix misspelling of “matching”.  Use @table for table.
Reformat code example to fit into info file width (Bug#17862).
2016-09-26 17:01:09 -07:00
Eli Zaretskii
9fc9988d4d Improve documentation of 'expand-abbrev' and wrapper hooks
* lisp/simple.el (filter-buffer-substring-functions)
(buffer-substring--filter): Add a link to 'with-wrapper-hook' as
the place to look for documentation of wrapper hooks.
* lisp/minibuffer.el (completion-in-region-functions)
(completion--in-region): Add a link to 'with-wrapper-hook' as the
place to look for documentation of wrapper hooks.
* lisp/abbrev.el (expand-abbrev, abbrev--default-expand): Clarify
the doc strings.  (Bug#24540)

* doc/lispref/text.texi (Buffer Contents): Mention
'with-wrapper-hook's doc string as the place to learn about that
obsolete facility.
2016-09-26 19:02:01 +03:00
Paul Eggert
9135bd7af7 Improve display of tex-verbatim and Info quoted
Problem reported by Glenn Morris (Bug#19889).
* doc/emacs/display.texi (Standard Faces):
* doc/lispref/display.texi (Basic Faces):
* etc/NEWS: Mention fixed-pitch-serif.
* lisp/faces.el (face-font-family-alternatives):
New family alias Monospace Serif.
(fixed-pitch-serif): New face, which uses the new family.
* lisp/info.el (Info-quoted):
* lisp/textmodes/tex-mode.el (tex-verbatim): Use the new face.
* test/lisp/legacy/font-parse-tests.el (font-parse-tests--data):
Add test case for Monospace Serif.

This is backport from master
(cherry picked from commit 36906806cc)
2016-09-23 16:55:52 +03:00
Lars Ingebrigtsen
e0dd65cd44 Document how to check for ImageMagick support
* doc/lispref/display.texi (ImageMagick Images): Say how to
check for ImageMagick support, which isn't quite obvious
(bug#20702).

This is backport from master
(cherry picked from commit faf07d6465)
2016-09-23 16:44:28 +03:00
Eli Zaretskii
0ae9a816b9 Document 'timerp'
* doc/lispref/os.texi (Timers): Document 'timerp'.  (Bug#24511)
Improve indexing.
2016-09-23 11:43:25 +03:00
Eli Zaretskii
2c72c46af1 Improve documentation of overlay priorities
* doc/lispref/display.texi (Overlay Properties): Minor copyedits.
By popular demand, mention the '(PRIMNARY . SECONDARY)' form of
overlay properties used for the region.  (Bug#20253)
2016-09-23 11:27:18 +03:00
Eli Zaretskii
1229cc4ae6 Document that desktop file overrides frame parameters
* doc/emacs/misc.texi (Saving Emacs Sessions):
* doc/emacs/frames.texi (Frame Parameters): Document that frame
parameters restored by desktop.el take precedence over the
customizations in the init file, and explain how to countermand
that.  For the details of the issue, see
http://lists.gnu.org/archive/html/emacs-devel/2016-09/msg00318.html.
2016-09-17 12:20:09 +03:00
Eli Zaretskii
0ad74106fa Update Antinews in ELisp manual
* doc/lispref/anti.texi (Antinews): Update for Emacs 25.1.
* doc/lispref/elisp.texi (Top): Update the main menu entry for
Antinews.
2016-09-14 17:20:24 +03:00
Martin Rudalics
0045998ac6 Fix cross reference in frames.texi
* doc/lispref/frames.texi (Minibuffers and Frames): Fix cross
reference.
2016-09-08 10:56:17 +02:00
immerrr
56bf7d7e27 Fix regexp-opt documentation (bug #17862)
* lisp/emacs-lisp/regexp-opt.el (regexp-opt):
* doc/lispref/searching.texi (Regexp Functions): Update PAREN doc.
2016-09-03 23:50:42 -04:00
Eli Zaretskii
80a7f8be7b Clarify documentation of precision in format specs
* doc/lispref/strings.texi (Formatting Strings): Be less
definitive wrt what precision means in format specs other than
floating-point, %s and %S.  (Bug#24314)
2016-08-26 22:13:34 +03:00
Eli Zaretskii
88a5052579 Improve and clarify documentation of subprocesses
* doc/lispref/processes.texi (Subprocess Creation, Shell Arguments):
Mention 'make-process' rather than 'start-process'.  Update wrt
standard destinations of standard output/error streams and due to
different formats of arguments accepted by 'make-process'.
(Processes): Mention process objects that represent connections.
(Synchronous Processes): Minor clarifications.
(Asynchronous Processes): Describe 'make-process' and
'make-pipe-process' before 'start-process'.  Update and expand the
documentation.
(Deleting Processes, Process Information, Input to Processes)
(Signals to Processes, Query Before Exit, Network): Update and
expand the documentation, especially wrt process objects that
represent connections.
(Output from Processes): Mention the possibility of separating
stderr via 'make-process'.
(Filter Functions): Mention that stderr by default arrives at the
filter function together with stdout.  (Bug#24287)

* src/process.c (Fprocess_id, Fprocess_command)
(Fprocess_contact, Fprocess_type, Fstop_process): Doc fixes for
process objects that represent connections.
2016-08-24 17:36:28 +03:00
Glenn Morris
66dea652ef ; * doc/lispref/windows.texi (Window Parameters): Grammar tweaks.
* etc/NEWS: Likewise.
2016-08-16 08:40:02 -07:00
Martin Rudalics
0cee66c3f1 Facultatively ignore margins when splitting and resizing windows (Bug#24193)
Provide a new window parameter 'min-margins' which allows to
ignore the actual widths of a window's margins when splitting or
resizing that window horizontally.  This should serve as a
workaround for handling the problems raised by Bug#24193.

* lisp/window.el (window--min-size-1): Handle new window
parameter 'min-margins'.
(split-window): Fix text of error messages.
* doc/lispref/windows.texi (Window Parameters): Describe new
parameter 'min-margins'.
2016-08-16 09:19:18 +02:00
Noam Postavsky
8342e7481a Document char-script-table's effect on word motion
* doc/lispref/positions.texi (Word Motion): Talk about
char-script-table (Bug #10494).
2016-08-13 10:10:57 -04:00
Eli Zaretskii
98b01dd1ef Clarify when 'cursor' property is in effect
* doc/lispref/text.texi (Special Properties): Minor copyedits.
(Bug#24179)
2016-08-11 23:01:53 +03:00
Eli Zaretskii
ccd0e92ecc * doc/lispref/text.texi (Change Hooks): Minor copyedits. 2016-08-10 20:12:55 +03:00
Eli Zaretskii
f785ff45d5 Clarify documentation of before/after-change-functions
* doc/lispref/text.texi (Change Hooks): Clarify that the hooks are
not called in balanced pairs.
2016-08-09 19:52:50 +03:00
Noam Postavsky
3c9cb57c6f Document use of vectors in keymaps
* doc/lispref/keymaps.texi (Format of Keymaps): Mention vector
format (Bug #14797).
2016-08-06 15:46:18 -04:00
John Wiegley
cd1b4d60ce Revert "Fix ses-delete-blanks to delete only blanks + documentation."
This reverts commit 3c97b0f758.
2016-08-02 11:43:07 -07:00
John Wiegley
f7ceb8e028 Revert "Fix English."
This reverts commit b275cc76f0.
2016-08-02 11:43:05 -07:00
Vincent Belaïche
b275cc76f0 Fix English.
* doc/misc/ses.texi (Nonrelocatable references): Fix grammatically
  incorrect English.
2016-07-29 13:47:57 +02:00
Vincent Belaïche
3c97b0f758 Fix ses-delete-blanks to delete only blanks + documentation.
* doc/misc/ses.texi (Quick Tutorial): Mention the '!'
'ses-range' modifier as an alternative to 'ses+'.
(Advanced Features): Add a refernce to node 'Nonrelocatable
references' concerning function 'ses-rename-cell'.
(Standard formula functions): Mention the '!' 'ses-range'
modifier as an alternative to 'ses-delete-blanks'.
(More on cell printing): Fix fallback printer
definition.  Minor editorial formatting changes.
(Nonrelocatable references): Document the use of
'ses-rename-cell' as a better way to make cell reference
non-relocatable.
(The data area): Document the presence of local printer
definitions in the data area.

* lisp/ses.el (ses-delete-blanks): Do not remove
*error*.  Any error in an argument should propagate into the
using formula rather than being silently hidden !
2016-07-29 13:44:14 +02:00
Noam Postavsky
272391f1d6 profiler: document prefix arg for tree expansion
* doc/lispref/debugging.texi (Profiling):
* lisp/profiler.el (profiler-report-toggle-entry): Document use of
prefix argument to expand whole call trees.
2016-07-28 20:02:42 -04:00
Noam Postavsky
b443c3c748 Fix comment in files-in-below-directory
* doc/lispintro/emacs-lisp-intro.texi (Files List): Comment should not
say append, since the code is adding to front of list (Bug #21589).
2016-07-28 19:53:58 -04:00
Noam Postavsky
9ba51edf62 Document buffer-swap-text+save-excursion interaction
* doc/lispref/buffers.texi (Swapping Text):
* src/buffer.c (Fbuffer_swap_text): Add warning about interaction of
`buffer-swap-text' and `save-excursion' (Bug #4655).
2016-07-14 20:01:39 -04:00