Eli Zaretskii [Thu, 22 Feb 2018 18:27:24 +0000 (20:27 +0200)]
Improvements in the Emacs manual
* doc/emacs/custom.texi (Customization Groups)
(Changing a Variable, Browsing Custom, Customizing Faces): Fix
markup of keys.
(Changing a Variable, Saving Customizations): Update the
description of buttons in the Custom buffer.
(Face Customization): More accurate description.
(Specific Customization, Examining, Locals): Add blank lines in
the @table. Reported by Michael Albinus <michael.albinus@gmx.de>
in emacs-manual-bugs@gnu.org.
* doc/misc/semantic.texi (Tools): Fix wording and grammar, and
remove a reference to "document-vars.el" which, in the Emacs
repository, is part of lisp/cedet/srecode/document.el.
Eli Zaretskii [Tue, 20 Feb 2018 19:13:29 +0000 (21:13 +0200)]
Improve the "Sending Mail" chapter of Emacs manual
* doc/emacs/sending.texi (Mail Format, Header Editing)
(Mail Aliases): Fix capitalization of mail headers.
(Mail Aliases): Use ~/.mailrc consistently.
(Mail Misc): More accurate description of disposition. Suggested
by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
Eli Zaretskii [Tue, 20 Feb 2018 04:22:57 +0000 (06:22 +0200)]
Fix documentation of 'flyspell-auto-correct-word'
* lisp/textmodes/flyspell.el (flyspell-get-word): Elaborate in the
doc string on how the function looks for the word to spell-check.
(flyspell-word, flyspell-auto-correct-word): Refer to
'flyspell-get-word' for details about finding the word.
(Bug#30462)
Eli Zaretskii [Mon, 19 Feb 2018 16:14:08 +0000 (18:14 +0200)]
More changes in the Emacs manuals
* doc/emacs/custom.texi (Customization Groups, Browsing Custom)
(Custom Themes, Keymaps, Prefix Keymaps, Modifier Keys)
(Function Keys, Named ASCII Chars, Mouse Buttons, Init Examples):
Fix punctuation. Suggested by Stefan Kamphausen
<stefan.kamphausen@acrolinx.com> in emacs-manual-bugs@gnu.org.
* doc/emacs/basic.texi (Arguments, Repeating): Avoid breaking
commands between lines. Reported by Wojciech Politarczyk
<w.politarczyk@gmail.com> in emacs-manual-bugs@gnu.org.
* doc/emacs/custom.texi (Init Rebinding): Move index entries about
rebinding keys from "Init File". (Bug#30528)
Eli Zaretskii [Sun, 18 Feb 2018 18:52:21 +0000 (20:52 +0200)]
More fixes in the Emacs manual
* doc/emacs/abbrevs.texi (Defining Abbrevs, Expanding Abbrevs)
(Editing Abbrevs, Saving Abbrevs): Insert blank lines between
@item's.
(Expanding Abbrevs): Add 'unexpand-abbrev' to the list of
commands. Suggested by Michael Albinus <michael.albinus@gmx.de>
in emacs-manual-bugs@gnu.org.
Eli Zaretskii [Sat, 17 Feb 2018 17:48:23 +0000 (19:48 +0200)]
More improvements in the Emacs manual
* doc/emacs/maintaining.texi (Xref Commands, Identifier Search)
(List Identifiers): Insert blank lines between @item's in a
@table.
(Etags Regexps): More accurate description of escape sequences.
(Select Tags Table): Prefer "~/emacs.d/init.el" to "~/.emacs".
Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
Eli Zaretskii [Sat, 17 Feb 2018 17:28:01 +0000 (19:28 +0200)]
Improve documentation of 'electric-pair-mode'
* lisp/elec-pair.el (electric-pair-mode):
* doc/emacs/programs.texi (Matching): Document the operation of
electric-pair-mode when there's an active region. (Bug#30502)
Eli Zaretskii [Sat, 17 Feb 2018 08:28:29 +0000 (10:28 +0200)]
Minor change in Emacs manual's VC chapter
* doc/emacs/maintaining.texi (Log Buffer): Mention the "Summary"
header. Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
Noam Postavsky [Fri, 16 Feb 2018 03:13:51 +0000 (22:13 -0500)]
Avoid memory corruption with specpdl overflow + edebug (Bug#30481)
If grow_specpdl fails due to outgrowing max_specpdl_size, it will
signal an error *before* growing the specpdl array. Therefore, when
handling the signal, specpdl_ptr points past the end of the specpdl
array and any further use of of specpdl before unwinding (e.g., if
edebug binds signal-hook-function) will cause memory corruption.
* src/eval.c (signal_or_quit): Don't call `signal-hook-function' if
the specpdl_ptr is already past the end of the specpdl array.
* test/src/eval-tests.el (eval-tests--exceed-specbind-limit)
(eval-exceed-specbind-with-signal-hook): New test & helper function.
Eli Zaretskii [Fri, 16 Feb 2018 21:37:38 +0000 (23:37 +0200)]
More fixes for the Emacs manual
* doc/emacs/vc1-xtra.texi (Customizing VC): Update the list of
backends.
* doc/emacs/maintaining.texi (Version Control): Add SRC to the
list of VCS. Remove the description of vc-state-refresh.
(Version Control Systems): Update the description of CVS.
(VC Change Log): Amend the list of VCS that don't support
vc0print-root-log.
(VCS Changesets, VCS Repositories, Advanced C-x v v)
(VC Change Log): Mention SRC with RCS where appropriate.
(VC Directory Commands): More accurate description of
vc-dir-hide-up-to-date. Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
Eli Zaretskii [Fri, 16 Feb 2018 10:46:32 +0000 (12:46 +0200)]
Improve the MS-Windows appendix of the Emacs manual
* doc/emacs/msdos.texi (Windows Startup): Describe the pinned
shortcuts for starting Emacs.
(Text and Binary): Minor wording changes.
(Windows Files): Mention 'read-file-name-completion-ignore-case'.
(ls in Lisp): Update the list of supported 'ls' switches.
Document 'ls-lisp-use-string-collate' and
'ls-lisp-UCA-like-collation'.
(Windows HOME): Mention warnings displayed at startup when
deprecated locations of HOME and/or deprecated names for init
files are used.
(Windows Keyboard): Mention delete-selection-mode.
Eli Zaretskii [Thu, 15 Feb 2018 18:38:13 +0000 (20:38 +0200)]
More improvements for the Emacs manual
* doc/emacs/programs.texi (Basic Indent, Comment Commands): Fix
typos.
* doc/emacs/text.texi (TeX Print, HTML Mode, Enriched Faces): Fix
typos.
* doc/emacs/help.texi (Help Files): Improve @uref usage. Reported
by Stefan Kamphausen <stefan.kamphausen@acrolinx.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/fortran-xtra.texi (ForIndent Commands): Fix a typo.
(ForIndent Commands, Fortran Columns): Add empty lines between
@items in a @table.
(ForIndent Cont, ForIndent Num, Fortran Columns): Mention
'column-number-indicator-zero-based'.
(ForIndent Vars): Fix a typo.
(Fortran Comments): Fix punctuation.
(ForIndent Cont, Fortran Autofill): Fix markup of keyboard input.
* doc/emacs/programs.texi (Comments): Fix a typo.
(Comment Commands): More accurate description of the commands.
(Options for Comments): Don't mention "hook".
(Man Page): Prefer "M-x man" if available.
(Hideshow): Fix the command key sequence.
(Semantic): Update supported languages.
(Semantic, Hungry Delete, Other C Commands): Fix markup of
commands.
(Misc for Programs): Fix a typo.
(Electric C, Hungry Delete): More accurate description of
mode-line lighters of CC submodes.
(Asm Mode): Add empty lines between @items in a @table.
* doc/emacs/programs.texi (Program Modes): Add a few more modes.
Reported by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
* doc/emacs/msdos.texi (Windows Misc): A minor rewording.
Suggested by Isaac Carter <icarter1391@gmail.com> in
emacs-manual-bugs@gnu.org.
Eli Zaretskii [Wed, 14 Feb 2018 19:00:59 +0000 (21:00 +0200)]
Another set of changes for the manual
* doc/emacs/programs.texi (Program Indent): Add a cross-reference
to elisp's description of 'pp'.
(Program Modes): Add a few more programming modes. Add index
entries.
(Basic Indent, Multi-line Indent, C Indent, Comment Commands)
(Manipulating Comments): Fix markup of keyboard commands.
* doc/emacs/search.texi (Regexps): Add an example with non-ASCII
characters. Suggested by Michael Albinus <michael.albinus@gmx.de>
in emacs-manual-bugs@gnu.org.
* doc/lispref/display.texi (Display Tables): Fix the description
of the 5th extra slot of the display table. (Bug#13473)
Michael Albinus [Wed, 14 Feb 2018 08:28:33 +0000 (09:28 +0100)]
Improvements on tramp.texi
* doc/misc/tramp.texi: Use Tramp version in title. Further
improvements on user option indexing. Finish command examples
with @key{RET} where appropriate.
(Remote processes): Use 'M-&' for invocation of async shell.
(Frequently Asked Questions): Add example with simplified syntax.
Eli Zaretskii [Tue, 13 Feb 2018 17:12:37 +0000 (19:12 +0200)]
More changes in the Emacs manual
* doc/emacs/search.texi (Regexp Backslash): Say that
symbol-constituent characters are determined by the syntax table.
(Lax Search): Fix example of case-insensitive search. Fix a
typo.
(Unconditional Replace): Improve wording.
(Regexp Replace): More consistent wording. Reported by Michael
Albinus <michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
* doc/emacs/msdos.texi (Windows HOME): Avoid enumerating all the
Windows versions. Reported by Isaac Carter
<icarter1391@gmail.com> in emacs-manual-bugs@gnu.org.
Eli Zaretskii [Tue, 13 Feb 2018 05:59:26 +0000 (07:59 +0200)]
Minor change in the Emacs manual
* doc/emacs/building.texi (Lisp Libraries): Explain why nil in
load-path is not a good idea. Suggested by James Yoo
<james.yoo@gmail.com> in emacs-manual-bugs@gnu.org.
* doc/misc/tramp.texi (Remote processes): Index the
tramp-remote-process-environment description. Clarify the effects of
let-binding process-environment and the motivation for that behavior.
Juri Linkov [Mon, 12 Feb 2018 21:39:28 +0000 (23:39 +0200)]
* lisp/progmodes/grep.el (grep-num-matches-found): New variable.
(grep-mode-line-matches): New defconst.
(grep-mode-font-lock-keywords): Update the regexp for “Grep finished”
to include the number of matches found.
(grep-process-setup): Set grep-num-matches-found to 0.
(grep-exit-message): New function with body moved from lambda
in grep-process-setup. Use grep-num-matches-found to return
the number of matches found.
(grep-filter): Increment grep-num-matches-found.
(grep-mode): Set compilation-mode-line-errors to grep-mode-line-matches.
(Bug#30397, bug#14017)
Eli Zaretskii [Mon, 12 Feb 2018 18:02:36 +0000 (20:02 +0200)]
Avoid aborts in cm.c due to too small TTY frame
* src/frame.c (frame_windows_min_size): Limit TTY frames to a
minimum height large enough to allow for a menu bar, the mode
line, one text line and one echo-area line. This avoids aborts in
cm.c:cmcheckmagic. (Bug#30320)
Eli Zaretskii [Mon, 12 Feb 2018 17:52:48 +0000 (19:52 +0200)]
Another set of improvements in the Emacs manual
* doc/emacs/msdos-xtra.texi (MS-DOS Keyboard):
* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/mark.texi (Using Region):
* doc/emacs/frames.texi (Menu Mouse Clicks):
* doc/emacs/macos.texi (Mac / GNUstep Basics): Fix spelling of
keys. Reported by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
* doc/emacs/glossary.texi (Glossary): Document that "c.f." is a
misspelling. Reported by Robert Pluim <rpluim@gmail.com>.
Various minor wording improvements. Suggested by Toon Claes
<toon@iotcl.com> in emacs-manual-bugs@gnu.org.
More minor changes. Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
* doc/emacs/basic.texi (Moving Point): Move the description of the
bidi-related effects of the arrow keys from here ...
* doc/emacs/mule.texi (Bidirectional Editing): ... to here.
Explain the behavior of arrow keys between paragraphs.
Eli Zaretskii [Sun, 11 Feb 2018 17:59:00 +0000 (19:59 +0200)]
Improve documentation of desktop restoring
* doc/emacs/misc.texi (Saving Emacs Sessions): Document
'desktop-auto-save-timeout', 'desktop-load-locked-desktop', and
how to restore desktop in daemon mode. (Bug#30421)
Eli Zaretskii [Sun, 11 Feb 2018 16:19:25 +0000 (18:19 +0200)]
Improve the Emacs manual's chapter "Frames"
* doc/emacs/frames.texi (Creating Frames): Add a cross-reference
to where frame visibility is described.
(Word and Line Mouse): Clarify wording.
(Scroll Bars): Qualify scroll-bar behavior. Reported by Dmitry
Gutov <dgutov@yandex.ru> in emacs-manual-bugs@gnu.org.
Eli Zaretskii [Sat, 10 Feb 2018 17:21:42 +0000 (19:21 +0200)]
Improve Emacs user manual in fixit.texi
* doc/emacs/fixit.texi (Undo): Clarify inaccurate description of
repeated undo.
(Transpose): Describe explicitly what happens at EOL.
(Spelling): Use "spell-checking" consistently. Clarify wording.
Suggested by Toon Claes <toon@iotcl.com> in
emacs-manual-bugs@gnu.org.
Eli Zaretskii [Sat, 10 Feb 2018 07:51:00 +0000 (09:51 +0200)]
Avoid printing garbled error message from image.el
* lisp/image.el (image--get-imagemagick-and-warn): Don't use
apostrophe in the error message, as that message is shown from a
unibyte buffer, and will run afoul of the default style of showing
quote characters. (Bug#30405)
Eli Zaretskii [Fri, 9 Feb 2018 16:18:04 +0000 (18:18 +0200)]
Minor improvements in package.texi
* doc/emacs/package.texi (Package Menu): Minor wording change.
(Package Installation): Use HTTPS. A better @xref to GnuPG
manual. Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
Eli Zaretskii [Fri, 9 Feb 2018 13:32:48 +0000 (15:32 +0200)]
Minor improvement in Emacs user manual
* doc/emacs/files.texi (Directories): Document that
'directory-free-space-program' and 'directory-free-space-args' are
only for local filesystems. Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
Eli Zaretskii [Fri, 9 Feb 2018 10:08:19 +0000 (12:08 +0200)]
More changes in the Emacs manual
* doc/emacs/fixit.texi (Undo): Mention 'revert-buffer'.
(Fixing Case): Fix punctuation.
(Spelling): Fix a typo. Suggested by Toon Claes <toon@iotcl.com>
in emacs-manual-bugs@gnu.org.
* doc/emacs/modes.texi (Major Modes): Break a long sentence into
2. Reported by Stefan Kamphausen <stefan.kamphausen@acrolinx.com>
in emacs-manual-bugs@gnu.org.
* doc/emacs/indent.texi (Just Spaces): Yet another minor
rewording.
* doc/emacs/building.texi (Watch Expressions): Improve wording.
(Multithreaded Debugging): Spell "tool bar" as 2 words. Reported
by Alberto Sartori <alberto.sartori@sissa.it> in
emacs-manual-bugs@gnu.org.
(Grep Searching): Mention the effect of
'compilation-mode-line-errors'. (Bug#30397)
* doc/emacs/basic.texi (Moving Point): Minor reformatting and
rewording of what <LEFT> and <RIGHT> do.
Noam Postavsky [Tue, 6 Feb 2018 18:17:07 +0000 (13:17 -0500)]
Mention that shell quoting of % on w32 may fail (Bug#19350)
* doc/lispref/os.texi (Security Considerations): Mention that quoting
of '%' assumes no '^' in variable names.
* test/lisp/subr-tests.el (shell-quote-argument-%-on-w32): New test,
demonstrating what doesn't work.
* doc/emacs/macos.texi (Mac OS / GNUstep): Sayu "NeXT Inc."
Reported by Cena Mayo <cenazoic@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/screen.texi (Screen): More accurate wording.
Suggested by Miloš Polakovič <milos@alphamail.org> in
emacs-manual-bugs@gnu.org.
* doc/emacs/indent.texi (Just Spaces): Minor wording change.
Suggested by David Bonnafous <dbonnafo@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/text.texi (TeX Mode, TeX Editing): Improve and
simplify wording. Suggested by root@vxid.pw <root@vxid.pw> in
emacs-manual-bugs@gnu.org.
* doc/emacs/cmdargs.texi (Window Size X): Minor wording change.
* doc/emacs/display.texi (Highlight Interactively): Fill text.
(Optional Mode Line): Fix typos. Suggested by Alberto Sartori
<alberto.sartori@sissa.it> in emacs-manual-bugs@gnu.org.
* doc/emacs/files.texi (Directories, Comparing Files, Diff Mode)
(Remote Files, File Names, Visiting, Backup Deletion)
(Customize Save, Interlocking): Improve wording and accuracy of
the text.
* doc/emacs/maintaining.texi (VC With A Merging VCS): Don't say
"his".
* doc/emacs/arevert-xtra.texi (Auto Reverting Dired): Minor
wording changes.
(Supporting additional buffers): Moved to ...
* doc/lispref/backups.texi (Reverting): ... here.
* doc/emacs/emacs.texi (Top): Remove "Supporting additional
buffers" from master menu.
* doc/emacs/files.texi (Reverting): Mention use of file
notifications. Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
* doc/emacs/rmail.texi (Rmail Motion): Clarify what '-' does to
'M-s'. Suggested by Arthur Milchior <arthur@milchior.fr> in
emacs-manual-bugs@gnu.org.
* doc/emacs/cmdargs.texi (Initial Options): Capitalize "Emacs".
(Action Arguments): Fix a typo.
(Emacs Invocation): Replace em-dash with a comma. Suggested by
Justin Heyes-Jones <justinhj@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/m-x.texi (M-x): Add an example. Suggested by Alberto
Sartori <alberto.sartori@sissa.it> in emacs-manual-bugs@gnu.org.
* doc/emacs/calendar.texi (Calendar/Diary, Calendar Unit Motion):
Minor wording changes.
Eli Zaretskii [Sun, 4 Feb 2018 20:15:05 +0000 (22:15 +0200)]
Yet another round of fixing the Emacs manual
* doc/emacs/cmdargs.texi (Action Arguments): Rearrange text
describing what happens when Emacs is invoked with several file
arguments. Suggested by Grant Rettke <gcr@wisdomandwonder.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/xresources.texi (GTK styles):
* doc/emacs/mini.texi (Passwords):
* doc/emacs/frames.texi (Scroll Bars): Use "cannot" instead of
"can not".
* doc/emacs/macos.texi (Mac / GNUstep Basics): Clarify the effect
of ns-right-alternate-modifier when its value is 'none'.
Suggested by Wanderson Ferreira <iagwanderson@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/calendar.texi (Importing Diary, Appointments): Now
sub-sections of Diary.
* doc/emacs/emacs.texi (Top):
* doc/emacs/calendar.texi (Diary): Adjust menus to the above
change. Suggested by Isaac Carter <icarter1391@gmail.com> in
emacs-manual-bugs@gnu.org.
Fix deferred display of async shell-command buffers
* lisp/simple.el (shell-command): Display async shell buffer on
process output for every, not just first, command invocation. Check
buffer liveness, not name, before displaying. (bug#30213, bug#30280)
Eli Zaretskii [Sat, 3 Feb 2018 11:50:38 +0000 (13:50 +0200)]
Yest another round of manual copyedits
* doc/emacs/fixit.texi (Transpose, Spelling): Minor stylistic
changes. Suggested by myq larson <myqlarson@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/calendar.texi (Appointments, Time Intervals): Mention
relevant Org features. Suggested by Alex Branham
<alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.
* doc/emacs/dired.texi (Operating on Files)
(Shell Commands in Dired, Image-Dired): Minor stylistic edits.
Suggested by Francis Wright <f.j.wright@live.co.uk> in
emacs-manual-bugs@gnu.org.
* doc/emacs/commands.texi (User Input): Explain "C-M-a".
Suggested by Martin Luethi <martin.luethi@geo.uzh.ch> in
emacs-manual-bugs@gnu.org.
Noam Postavsky [Fri, 2 Feb 2018 02:12:09 +0000 (21:12 -0500)]
; Avoid process kill query during term tests
* test/lisp/term-tests.el (term-test-screen-from-input): Just unset
the process query-on-exit flag to rather than trying to end the
process before the end of test (which is generally unreliable).
Eli Zaretskii [Fri, 2 Feb 2018 15:41:38 +0000 (17:41 +0200)]
Another round of manual fixups
* doc/emacs/killing.texi (Killing by Lines): Clarify wording.
Reported by David Bonnafous <dbonnafo@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/windows.texi (Other Window): Improve wording.
Reported by Rasmus Sjostrom <ras.sjostrom@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/display.texi (Display Custom): Mention that line
numbers are not displayed in the minibuffer and tooltips.
* doc/emacs/mini.texi (Basic Minibuffer): Improve wording.
* doc/emacs/regs.texi (Registers): More comma removal. Suggested
by "root@vxid.pw root@vxid.pw" <root@vxid.pw> in
emacs-manual-bugs@gnu.org.
* doc/emacs/display.texi (Auto Scrolling): Fix a typo. Reported
by Kevin Foley <kfoley15@gmail.com> in emacs-manual-bugs@gnu.org.
* doc/emacs/display.texi (Scrolling): Fix grammar.
(Horizontal Scrolling): Mention reasonable limits for hscroll-step
float values. Suggested by Jerome Truong <jerometruong@gmail.com>
in emacs-manual-bugs@gnu.org.
* doc/emacs/mini.texi (Minibuffer Edit): Add a missing comma.
* doc/emacs/basic.texi (Position Info, Arguments, Repeating):
Remove redundant commas. Suggested by oldgaro
<oldgaro@protonmail.com> in emacs-manual-bugs@gnu.org.
* doc/emacs/kmacro.texi (Save Keyboard Macro): Clarify wording.
Suggested by clemens.radermacher@posteo.de in
emacs-manual-bugs@gnu.org.
* doc/emacs/building.texi (Compilation Mode): Improve and simplify
wording. Suggested by drone <yoorobot@gmail.com> in
emacs-manual-bugs@gnu.org.
* doc/emacs/dired.texi (Dired Enter): Clarify wording.
(Dired Deletion): Fix a typo.
(Marks vs Flags): Mention that M-DEL in Dired asks for the mark
character. Fix typos.
* doc/emacs/basic.texi (Moving Point, Erasing, Basic Undo)
(Arguments): Some additional information about keys. Reported by
Francis Wright <f.j.wright@live.co.uk> in
emacs-manual-bugs@gnu.org.