Commit graph

5497 commits

Author SHA1 Message Date
Eli Zaretskii
9ad2ae7757 Fix Outline command names
* doc/emacs/text.texi (Foldout): Use the outline-* names instead
of the obsolete aliases.  (Bug#24890)
2016-11-12 21:40:33 +02:00
Alan Mackenzie
db0b58da1d Correct the statement about programming modes always running prog-mode-hook.
doc/emacs/modes.texi (Major Modes): Amend the statement about programming
modes running prog-mode-hook to say that it applies to many (not all) such
modes, and specifying exactly which modes.
2016-11-10 21:22:05 +00:00
Eli Zaretskii
78aece497c Improve documentation of 'occur'
* doc/emacs/search.texi (Other Repeating Search): Clarify how to
use Occur with search strings from last Isearch.  (Bug#24890)
2016-11-10 18:25:21 +02:00
Eli Zaretskii
8da810f91b Don't refer to obsolete FEATURE-unload-hook
* doc/lispref/tips.texi (Coding Conventions): Refer to
FEATURE-unload-function rather than its obsolete variant
FEATURE-unload-hook.  (Bug#24890)
2016-11-07 19:39:54 +02:00
Eli Zaretskii
4f478ca04b Improve documentation of dabbrevs
* lisp/dabbrev.el (dabbrev-expand): Doc fix.  (Bug#24890)

* doc/emacs/abbrevs.texi (Dynamic Abbrevs): Mention
'dabbrev-check-all-buffers', 'dabbrev-check-other-buffers', and
'dabbrev-ignored-buffer-names' and their purpose.  (Bug#24890)
2016-11-07 19:34:51 +02:00
Eli Zaretskii
3b199f7c77 Improve documentation of some Help commands
* doc/emacs/help.texi (Help Mode): Fix mistake in key sequences.
Mention the 'l' and 'r' keys.
(Misc Help): Mention that 'C-h m' describes key bindings.
(Bug#24890)
2016-11-07 18:57:28 +02:00
Eli Zaretskii
93d3a0e302 Fix documentation of yes-or-no prompts
* doc/emacs/mini.texi (Yes or No Prompts): Fix mistakes in key
sequences.  (Bug#24890)
2016-11-07 18:47:39 +02:00
Eli Zaretskii
af04919fc5 Fix documentation of partial completion style
* doc/emacs/mini.texi (Completion Styles): Fix the description of
the wildcard '*'.  (Bug#24890)
2016-11-07 18:44:17 +02:00
Eli Zaretskii
ed80184d0c Fix documentation of the mode line on emacsclient frames
* doc/emacs/screen.texi (Mode Line): Document the '@' indicator on
emacsclient frames.
2016-11-07 18:23:54 +02:00
Eli Zaretskii
e6be8557d5 Fix description of 'C-z' in User manual
* doc/emacs/entering.texi (Exiting): 'C-z' is bound to
'suspend-frame'.  (Bug#24890)
2016-11-07 18:00:19 +02:00
Eli Zaretskii
16f700702c Improve and clarify documentation of Outline Mode
* doc/emacs/text.texi (Outline Visibility): Use the outline-*
names instead of the obsolete aliases.  (Bug#24890)

* lisp/outline.el (outline-hide-sublevels, outline-hide-other)
(outline-hide-body): Doc fixes.  (Bug#24890)
2016-11-07 17:55:42 +02:00
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