]> git.eshelyaron.com Git - emacs.git/log
emacs.git
6 years agoMark keys consistently in manuals
Michael Albinus [Mon, 26 Feb 2018 12:53:37 +0000 (13:53 +0100)]
Mark keys consistently in manuals

* doc/emacs/killing.texi:
* doc/lispintro/emacs-lisp-intro.texi:
* doc/misc/calc.texi:
* doc/misc/cc-mode.texi:
* doc/misc/dired-x.texi:
* doc/misc/ede.texi:
* doc/misc/edt.texi:
* doc/misc/efaq.texi:
* doc/misc/erc.texi:
* doc/misc/eshell.texi:
* doc/misc/gnus-faq.texi:
* doc/misc/gnus-news.texi:
* doc/misc/idlwave.texi:
* doc/misc/ido.texi:
* doc/misc/mairix-el.texi:
* doc/misc/message.texi:
* doc/misc/mh-e.texi:
* doc/misc/newsticker.texi:
* doc/misc/org.texi:
* doc/misc/pcl-cvs.texi:
* doc/misc/ses.texi:
* doc/misc/sieve.texi:
* doc/misc/smtpmail.texi:
* doc/misc/speedbar.texi:
* doc/misc/srecode.texi:
* doc/misc/vhdl-mode.texi:
* doc/misc/vip.texi:
* doc/misc/viper.texi: Mark keys consistently.

6 years agoRemove @key{} markups from @kindex entries in manuals
Michael Albinus [Mon, 26 Feb 2018 08:24:39 +0000 (09:24 +0100)]
Remove @key{} markups from @kindex entries in manuals

* doc/emacs/basic.texi:
* doc/emacs/buffers.texi:
* doc/emacs/building.texi:
* doc/emacs/calendar.texi:
* doc/emacs/custom.texi:
* doc/emacs/dired.texi:
* doc/emacs/display.texi:
* doc/emacs/files.texi:
* doc/emacs/frames.texi:
* doc/emacs/help.texi:
* doc/emacs/indent.texi:
* doc/emacs/killing.texi:
* doc/emacs/kmacro.texi:
* doc/emacs/mark.texi:
* doc/emacs/mini.texi:
* doc/emacs/misc.texi:
* doc/emacs/modes.texi:
* doc/emacs/msdos-xtra.texi:
* doc/emacs/msdos.texi:
* doc/emacs/mule.texi:
* doc/emacs/picture-xtra.texi:
* doc/emacs/programs.texi:
* doc/emacs/regs.texi:
* doc/emacs/rmail.texi:
* doc/emacs/screen.texi:
* doc/emacs/search.texi:
* doc/emacs/sending.texi:
* doc/emacs/text.texi:
* doc/emacs/trouble.texi:
* doc/misc/calc.texi:
* doc/misc/cc-mode.texi:
* doc/misc/ediff.texi:
* doc/misc/ert.texi:
* doc/misc/eww.texi:
* doc/misc/forms.texi:
* doc/misc/gnus.texi:
* doc/misc/idlwave.texi:
* doc/misc/info.texi:
* doc/misc/message.texi:
* doc/misc/mh-e.texi:
* doc/misc/newsticker.texi:
* doc/misc/org.texi:
* doc/misc/pcl-cvs.texi:
* doc/misc/rcirc.texi:
* doc/misc/reftex.texi:
* doc/misc/sc.texi:
* doc/misc/sieve.texi:
* doc/misc/vhdl-mode.texi:
* doc/misc/vip.texi:
* doc/misc/viper.texi:
* doc/misc/woman.texi: Remove @key{} markups from @kindex entries.

6 years ago* doc/emacs/display.texi (Standard Faces): Fix markup of index entry.
Eli Zaretskii [Sun, 25 Feb 2018 15:52:15 +0000 (17:52 +0200)]
* doc/emacs/display.texi (Standard Faces): Fix markup of index entry.

6 years agoFix @kindex entries in manuals
Michael Albinus [Sun, 25 Feb 2018 15:29:39 +0000 (16:29 +0100)]
Fix @kindex entries in manuals

* doc/emacs/basic.texi:
* doc/emacs/buffers.texi:
* doc/emacs/building.texi:
* doc/emacs/calendar.texi:
* doc/emacs/custom.texi:
* doc/emacs/dired.texi:
* doc/emacs/display.texi:
* doc/emacs/files.texi:
* doc/emacs/frames.texi:
* doc/emacs/help.texi:
* doc/emacs/indent.texi:
* doc/emacs/killing.texi:
* doc/emacs/kmacro.texi:
* doc/emacs/mark.texi:
* doc/emacs/mini.texi:
* doc/emacs/misc.texi:
* doc/emacs/modes.texi:
* doc/emacs/msdos-xtra.texi:
* doc/emacs/msdos.texi:
* doc/emacs/mule.texi:
* doc/emacs/picture-xtra.texi:
* doc/emacs/programs.texi:
* doc/emacs/regs.texi:
* doc/emacs/rmail.texi:
* doc/emacs/screen.texi:
* doc/emacs/search.texi:
* doc/emacs/sending.texi:
* doc/emacs/text.texi:
* doc/emacs/trouble.texi:
* doc/lispref/files.texi:
* doc/misc/calc.texi:
* doc/misc/cc-mode.texi:
* doc/misc/ediff.texi:
* doc/misc/epa.texi:
* doc/misc/ert.texi:
* doc/misc/eww.texi:
* doc/misc/forms.texi:
* doc/misc/gnus.texi:
* doc/misc/info.texi:
* doc/misc/mairix-el.texi:
* doc/misc/message.texi:
* doc/misc/mh-e.texi:
* doc/misc/newsticker.texi:
* doc/misc/org.texi:
* doc/misc/pcl-cvs.texi:
* doc/misc/rcirc.texi:
* doc/misc/sc.texi:
* doc/misc/sieve.texi:
* doc/misc/vhdl-mode.texi:
* doc/misc/vip.texi:
* doc/misc/viper.texi:
* doc/misc/woman.texi: Fix @kindex entries.  Mark keys consistently.

6 years agoFix @cindex entries in manuals
Michael Albinus [Sat, 24 Feb 2018 19:52:21 +0000 (20:52 +0100)]
Fix @cindex entries in manuals

* doc/emacs/custom.texi:
* doc/emacs/dired.texi:
* doc/emacs/display.texi:
* doc/emacs/files.texi:
* doc/emacs/frames.texi:
* doc/emacs/killing.texi:
* doc/emacs/maintaining.texi:
* doc/emacs/misc.texi:
* doc/emacs/msdos-xtra.texi:
* doc/emacs/msdos.texi:
* doc/emacs/search.texi:
* doc/emacs/text.texi:
* doc/emacs/trouble.texi:
* doc/lispintro/emacs-lisp-intro.texi:
* doc/lispref/strings.texi:
* doc/lispref/text.texi:
* doc/misc/cc-mode.texi:
* doc/misc/efaq.texi:
* doc/misc/eieio.texi:
* doc/misc/emacs-mime.texi:
* doc/misc/gnus.texi:
* doc/misc/htmlfontify.texi:
* doc/misc/idlwave.texi:
* doc/misc/message.texi:
* doc/misc/mh-e.texi:
* doc/misc/sem-user.texi:
* doc/misc/ses.texi:
* doc/misc/tramp.texi:
* doc/misc/vhdl-mode.texi: Fix @cindex entries.

6 years agoMerge branch 'emacs-26' of git.sv.gnu.org:/srv/git/emacs into emacs-26
Michael Albinus [Sat, 24 Feb 2018 19:48:21 +0000 (20:48 +0100)]
Merge branch 'emacs-26' of git.sv.gnu.org:/srv/git/emacs into emacs-26

6 years agoFix @cindex entries in org.texi
Michael Albinus [Sat, 24 Feb 2018 19:40:39 +0000 (20:40 +0100)]
Fix @cindex entries in org.texi

* doc/misc/org.texi: Fix @cindex entries.  Use consistently
@code{} for keywords.

6 years agoDocument reserved keys
Eli Zaretskii [Sat, 24 Feb 2018 17:39:16 +0000 (19:39 +0200)]
Document reserved keys

* doc/emacs/custom.texi (Key Bindings): Mention keys reserved for
users.  (Bug#30530)

6 years ago* doc/misc/ebrowse.texi: Use @key{} for keys.
Michael Albinus [Sat, 24 Feb 2018 16:56:43 +0000 (17:56 +0100)]
* doc/misc/ebrowse.texi: Use @key{} for keys.

6 years ago; * doc/emacs/xresources.texi (Table of Resources): Fix last change.
Eli Zaretskii [Sat, 24 Feb 2018 16:07:28 +0000 (18:07 +0200)]
; * doc/emacs/xresources.texi (Table of Resources): Fix last change.

6 years ago* src/keyboard.c (syms_of_keyboard): Doc fix. (Bug#30588)
Eli Zaretskii [Sat, 24 Feb 2018 09:30:02 +0000 (11:30 +0200)]
* src/keyboard.c (syms_of_keyboard): Doc fix.  (Bug#30588)

6 years agoImprove documentation of X resources
Eli Zaretskii [Sat, 24 Feb 2018 09:14:10 +0000 (11:14 +0200)]
Improve documentation of X resources

* doc/emacs/xresources.texi (Table of Resources): Add menu-related
resources.  Add cross-references to "GTK Resources".

6 years ago; Use @minus for negative numbers in some texi files
Glenn Morris [Fri, 23 Feb 2018 21:00:44 +0000 (16:00 -0500)]
; Use @minus for negative numbers in some texi files

6 years ago* lisp/international/mule.el (keyboard-coding-system): Doc fix.
Glenn Morris [Fri, 23 Feb 2018 20:41:29 +0000 (15:41 -0500)]
* lisp/international/mule.el (keyboard-coding-system): Doc fix.

Since multi-tty, this is always set.

6 years agoMinor doc fixes, mostly for timestamp issues
Paul Eggert [Fri, 23 Feb 2018 19:51:31 +0000 (11:51 -0800)]
Minor doc fixes, mostly for timestamp issues

6 years ago* doc/emacs/mini.texi (Completion Styles): Improve indexing.
Eli Zaretskii [Fri, 23 Feb 2018 15:39:23 +0000 (17:39 +0200)]
* doc/emacs/mini.texi (Completion Styles): Improve indexing.

6 years agoFix @findex and @vindex entries in manuals
Michael Albinus [Fri, 23 Feb 2018 14:30:19 +0000 (15:30 +0100)]
Fix @findex and @vindex entries in manuals

* doc/emacs/building.texi:
* doc/emacs/calendar.texi:
* doc/emacs/cmdargs.texi:
* doc/emacs/mini.texi:
* doc/emacs/misc.texi:
* doc/emacs/trouble.texi:
* doc/emacs/windows.texi:
* doc/lispintro/emacs-lisp-intro.texi:
* doc/lispref/edebug.texi:
* doc/lispref/frames.texi:
* doc/lispref/os.texi:
* doc/lispref/windows.texi:
* doc/misc/cc-mode.texi:
* doc/misc/dired-x.texi:
* doc/misc/ediff.texi:
* doc/misc/mh-e.texi:
* doc/misc/pcl-cvs.texi:
* doc/misc/reftex.texi:
* doc/misc/sc.texi:
* doc/misc/vhdl-mode.texi:
* doc/misc/viper.texi: Fix @findex and @vindex entries.

6 years agoDocument, in the Elisp manual, how to get a character's raw syntax descriptor
Alan Mackenzie [Thu, 22 Feb 2018 18:21:47 +0000 (18:21 +0000)]
Document, in the Elisp manual, how to get a character's raw syntax descriptor

* doc/lispref/syntax.texi (Syntax Table internals): mention the use of `aref'
to get a character's raw syntax descriptor.

6 years agoImprovements in the Emacs manual
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.

6 years agoTiny doc/misc markup fixes
Glenn Morris [Thu, 22 Feb 2018 17:42:13 +0000 (12:42 -0500)]
Tiny doc/misc markup fixes

* doc/misc/ediff.texi (Patch and Diff Programs):
* doc/misc/viper.texi (File and Buffer Handling): Fix markup typos.

6 years agoSkip mouse-face overlap check when mouse-face is hidden (Bug#30519)
Martin Rudalics [Thu, 22 Feb 2018 07:50:47 +0000 (08:50 +0100)]
Skip mouse-face overlap check when mouse-face is hidden (Bug#30519)

* src/xdisp.c (note_mouse_highlight): Skip check whether
mouse-face highlighting overlay overlaps other mouse-face
overlays when mouse-face highlighting is hidden (Bug#30519).

6 years agoFix capitalization of "Mail-Followup-To"
Eli Zaretskii [Thu, 22 Feb 2018 07:37:00 +0000 (09:37 +0200)]
Fix capitalization of "Mail-Followup-To"

* doc/emacs/sending.texi (Header Editing, Mail Headers):
Standardize on "Mail-Followup-To" as the capitalization.

6 years ago* lisp/progmodes/grep.el (grep-compute-defaults):
Juri Linkov [Wed, 21 Feb 2018 20:30:29 +0000 (22:30 +0200)]
* lisp/progmodes/grep.el (grep-compute-defaults):

Add grep-use-null-filename-separator to grep-host-defaults-alist.
(Bug#30559)

6 years agoSemantic manual fixes
Charles A. Roelli [Wed, 21 Feb 2018 19:13:01 +0000 (20:13 +0100)]
Semantic manual fixes

* 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.

6 years agoMore improvements in the Emacs manual
Eli Zaretskii [Wed, 21 Feb 2018 18:32:11 +0000 (20:32 +0200)]
More improvements in the Emacs manual

* doc/emacs/help.texi (Misc Help):
* doc/emacs/m-x.texi (M-x):
* doc/emacs/mini.texi (Minibuffer File, Repetition): Prevent
breaking of command sequences between lines.  Reported by Wojciech
Politarczyk <w.politarczyk@gmail.com> in emacs-manual-bugs@gnu.org.

* doc/emacs/sending.texi (Header Editing): Fix capitalization.

6 years ago* doc/misc/viper.texi (File and Buffer Handling): Add missing '@'
tino calancha [Wed, 21 Feb 2018 10:41:16 +0000 (19:41 +0900)]
* doc/misc/viper.texi (File and Buffer Handling): Add missing '@'

6 years agoFix documentation of 'x-underline-at-descent-line'
Eli Zaretskii [Wed, 21 Feb 2018 04:20:58 +0000 (06:20 +0200)]
Fix documentation of 'x-underline-at-descent-line'

* doc/emacs/display.texi (Display Custom):
* src/nsterm.m (syms_of_nsterm):
* src/xterm.c (syms_of_xterm):
* src/w32term.c (syms_of_w32term): Mention the effect of
'line-spacing' on the underline position.  (Bug#30553)

6 years ago* lisp/textmodes/flyspell.el (flyspell-get-word): Doc fix.
Glenn Morris [Wed, 21 Feb 2018 01:31:30 +0000 (20:31 -0500)]
* lisp/textmodes/flyspell.el (flyspell-get-word): Doc fix.

6 years agoCorrect variable markup in manuals
Robert Pluim [Tue, 20 Feb 2018 19:15:19 +0000 (21:15 +0200)]
Correct variable markup in manuals

* doc/lispref/minibuf.texi (Completion in Buffers): Fix markup.
* doc/lispref/text.texi (Filling): Likewise.
* doc/misc/dired-x.texi (Advanced Mark Commands): Likewise.
* doc/misc/epa.texi (Encrypting/decrypting gpg files): Likewise.
(Encrypting/decrypting gpg files): Likewise.
* doc/misc/tramp.texi (External methods): Likewise.
(Default Method): Likewise.
* doc/misc/viper.texi (Editing in Insert State): Likewise.
(File and Buffer Handling): Likewise.
* doc/misc/gnus.texi (Mail Source Customization): Likewise.
* doc/misc/url.texi (Customization): Likewise.  Note obsolete
status of url-temporary-directory.

6 years agoImprove the "Sending Mail" chapter of Emacs manual
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.

6 years agoFix documentation of 'flyspell-auto-correct-word'
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)

6 years ago* doc/emacs/misc.texi (Saving Emacs Sessions): Fix markup.
Robert Pluim [Mon, 19 Feb 2018 16:16:15 +0000 (18:16 +0200)]
* doc/emacs/misc.texi (Saving Emacs Sessions): Fix markup.

6 years agoMore changes in the Emacs manuals
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)

6 years agoMore fixes in the Emacs manual
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.

6 years ago* src/data.c (Faref): Fix a typo in the doc string. (Bug#30510)
Eli Zaretskii [Sun, 18 Feb 2018 16:36:11 +0000 (18:36 +0200)]
* src/data.c (Faref): Fix a typo in the doc string.  (Bug#30510)

6 years agoMinor edit in tramp.texi
Michael Albinus [Sun, 18 Feb 2018 09:52:30 +0000 (10:52 +0100)]
Minor edit in tramp.texi

* doc/misc/tramp.texi (Remote shell setup, Windows setup hints):
Improve @cindex entries.

6 years ago; Fix oversight from last commit
Michael Albinus [Sat, 17 Feb 2018 18:43:13 +0000 (19:43 +0100)]
; Fix oversight from last commit

* doc/emacs/maintaining.texi (Select Tags Table): Use proper
"~/.emacs.d" directory.

6 years ago; * doc/emacs/maintaining.texi: Fix two typos.
Eli Zaretskii [Sat, 17 Feb 2018 17:52:50 +0000 (19:52 +0200)]
; * doc/emacs/maintaining.texi: Fix two typos.

6 years agoMore improvements in the Emacs manual
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.

6 years agoImprove documentation of 'electric-pair-mode'
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)

6 years ago; Spelling and grammar fixes.
Paul Eggert [Sat, 17 Feb 2018 17:16:44 +0000 (09:16 -0800)]
; Spelling and grammar fixes.

6 years ago; * lisp/textmodes/flyspell.el (flyspell-auto-correct-word): Fix a typo.
Eli Zaretskii [Sat, 17 Feb 2018 16:12:23 +0000 (18:12 +0200)]
; * lisp/textmodes/flyspell.el (flyspell-auto-correct-word): Fix a typo.

6 years agolisp/vc/: documentation fixes
Charles A. Roelli [Sat, 17 Feb 2018 15:49:02 +0000 (16:49 +0100)]
lisp/vc/: documentation fixes

* lisp/vc/vc.el (vc-region-history): Clarify documentation.
* lisp/vc/add-log.el (change-log-get-method-definition):
Indent documentation.

6 years agoDocument 'desktop-files-not-to-save'
Robert Pluim [Sat, 17 Feb 2018 11:01:19 +0000 (13:01 +0200)]
Document 'desktop-files-not-to-save'

* doc/emacs/misc.texi (Saving Emacs Sessions): Add description
of 'desktop-files-not-to-save'.

* lisp/desktop.el (desktop-files-not-to-save): Explain that
the default value excludes buffers visiting remote files.

6 years agoImprove documentation of Profiling features
Eli Zaretskii [Sat, 17 Feb 2018 09:59:36 +0000 (11:59 +0200)]
Improve documentation of Profiling features

* doc/lispref/debugging.texi (Profiling): Improve the description
of elp.el.  Improve wording of the rest of the section.  (Bug#30491)

* lisp/emacs-lisp/elp.el (elp-instrument-list): Make the
interactive invocation work.  Doc fix.

6 years agoImprove indexing of "performance" in ELisp manual
Eli Zaretskii [Sat, 17 Feb 2018 09:16:35 +0000 (11:16 +0200)]
Improve indexing of "performance" in ELisp manual

* doc/lispref/debugging.texi (Profiling):
* doc/lispref/edebug.texi (Coverage Testing): Improve indexing of
features useful for performance analysis.  (Bug#30490)

6 years agoMinor change in Emacs manual's VC chapter
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.

6 years agoAvoid memory corruption with specpdl overflow + edebug (Bug#30481)
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.

6 years agoDocument comment-fill-column in the manual (Bug#11636)
Noam Postavsky [Wed, 14 Feb 2018 03:10:03 +0000 (22:10 -0500)]
Document comment-fill-column in the manual (Bug#11636)

* doc/emacs/programs.texi (Comment Commands)
(Options for Comments): Mention comment-fill-column.

6 years ago* doc/emacs/dired.texi (Marks vs Flags): Copyedits.
Glenn Morris [Sat, 17 Feb 2018 01:03:13 +0000 (17:03 -0800)]
* doc/emacs/dired.texi (Marks vs Flags): Copyedits.

6 years ago; Fix doc typos related to indefinite articles
Glenn Morris [Fri, 16 Feb 2018 22:33:57 +0000 (17:33 -0500)]
; Fix doc typos related to indefinite articles

6 years agoMerge branch 'emacs-26' of git.savannah.gnu.org:/srv/git/emacs into emacs-26
Eli Zaretskii [Fri, 16 Feb 2018 21:38:32 +0000 (23:38 +0200)]
Merge branch 'emacs-26' of git.savannah.gnu.org:/srv/git/emacs into emacs-26

6 years agoMore fixes for the Emacs manual
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.

6 years ago; Fix doc typos related to indefinite articles
Glenn Morris [Fri, 16 Feb 2018 21:33:36 +0000 (16:33 -0500)]
; Fix doc typos related to indefinite articles

6 years ago; Fix doc typos related to indefinite articles
Glenn Morris [Fri, 16 Feb 2018 20:16:15 +0000 (15:16 -0500)]
; Fix doc typos related to indefinite articles

6 years ago; Fix doc typos related to indefinite articles
Glenn Morris [Fri, 16 Feb 2018 19:11:51 +0000 (14:11 -0500)]
; Fix doc typos related to indefinite articles

6 years ago; * lisp/vc/vc-git.el (vc-git--program-version): Fix last change.
Eli Zaretskii [Fri, 16 Feb 2018 17:20:29 +0000 (19:20 +0200)]
; * lisp/vc/vc-git.el (vc-git--program-version): Fix last change.

6 years agoMake 'byte-compile-error-on-warn' a safe file variable
Robert Cochran [Fri, 16 Feb 2018 15:51:06 +0000 (17:51 +0200)]
Make 'byte-compile-error-on-warn' a safe file variable

* lisp/emacs-lisp/bytecomp.el (byte-compile-error-on-warn): Mark
as a safe local variable for boolean values.

6 years ago; * lisp/textmodes/flyspell.el (flyspell-auto-correct-word): Fix last change.
Eli Zaretskii [Fri, 16 Feb 2018 14:30:02 +0000 (16:30 +0200)]
; * lisp/textmodes/flyspell.el (flyspell-auto-correct-word): Fix last change.

6 years agoFix the doc string of flyspell-auto-correct-word
Eli Zaretskii [Fri, 16 Feb 2018 14:23:43 +0000 (16:23 +0200)]
Fix the doc string of flyspell-auto-correct-word

* lisp/textmodes/flyspell.el (flyspell-auto-correct-word): Doc
fix.  (Bug#30462)

6 years agoImprove the MS-Windows appendix of the Emacs manual
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.

6 years agoFix 'vc-git--program-version'
Eli Zaretskii [Fri, 16 Feb 2018 09:30:29 +0000 (11:30 +0200)]
Fix 'vc-git--program-version'

* lisp/vc/vc-git.el (vc-git--program-version): Fix the function to
work with Git for Windows.

6 years agoFix typos and wording in the Emacs manual
Eli Zaretskii [Fri, 16 Feb 2018 09:12:50 +0000 (11:12 +0200)]
Fix typos and wording in the Emacs manual

* doc/emacs/dired.texi (Marks vs Flags, Hiding Subdirectories):
* doc/emacs/maintaining.texi (Tag Syntax):
* doc/emacs/building.texi (Commands of GUD, Threads Buffer)
(Lisp Libraries):
* doc/emacs/windows.texi (Temporary Displays): Fix typos.
* doc/emacs/files.texi (Backup Copying): Fix wording.  Reported by
Stefan Kamphausen <stefan.kamphausen@acrolinx.com> in
emacs-manual-bugs@gnu.org.

6 years ago* doc/emacs/programs.texi (Semantic): Order programming languages.
Michael Albinus [Fri, 16 Feb 2018 08:53:30 +0000 (09:53 +0100)]
* doc/emacs/programs.texi (Semantic): Order programming languages.

6 years agoMore improvements for the Emacs manual
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.

6 years agoMinor wording change in Emacs manual
Eli Zaretskii [Wed, 14 Feb 2018 19:12:49 +0000 (21:12 +0200)]
Minor wording change in Emacs manual

* doc/emacs/killing.texi (Accumulating Text): Fix spelling.
Reported by lyr3 <lyr3@protonmail.com> in
emacs-manual-bugs@gnu.org.

6 years agoAnother set of changes for the manual
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)

* doc/emacs/regs.texi (Registers): Simplify wording.

* doc/emacs/custom.texi (Init Non-ASCII): Remove outdated text
about perils of encoded keyboard input.

6 years agoImprovements on tramp.texi
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.

6 years agoTramp minor doc fixes
Paul Eggert [Tue, 13 Feb 2018 22:52:20 +0000 (14:52 -0800)]
Tramp minor doc fixes

* doc/misc/tramp.texi (Remote processes): Spelling fix and minor
wording improvement.

6 years agoMore changes in the Emacs manual
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.

6 years ago* lisp/vc/vc.el (vc-deduce-backend): Use ignore-errors.
Andreas Schwab [Tue, 13 Feb 2018 13:05:20 +0000 (14:05 +0100)]
* lisp/vc/vc.el (vc-deduce-backend): Use ignore-errors.

6 years agoDon't signal error in vc-deduce-backend
Andreas Schwab [Tue, 13 Feb 2018 11:13:27 +0000 (12:13 +0100)]
Don't signal error in vc-deduce-backend

* lisp/vc/vc.el (vc-deduce-backend): Return nil if
vc-responsible-backend signals an error.

6 years ago* doc/misc/tramp.texi: Index more user options.
Michael Albinus [Tue, 13 Feb 2018 07:35:50 +0000 (08:35 +0100)]
* doc/misc/tramp.texi: Index more user options.

6 years agoMinor change in the Emacs manual
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.

6 years agoNEWS update about 'string-trim'
Eli Zaretskii [Tue, 13 Feb 2018 05:49:30 +0000 (07:49 +0200)]
NEWS update about 'string-trim'

* etc/NEWS: Mention changes in string-trim family of functions.
(Bug#30442)

6 years agoClarify TRAMP process-environment interaction (Bug#30419)
Noam Postavsky [Sun, 11 Feb 2018 14:20:29 +0000 (09:20 -0500)]
Clarify TRAMP process-environment interaction (Bug#30419)

* 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.

6 years ago* lisp/progmodes/grep.el (grep-num-matches-found): New variable.
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)

6 years agoAvoid aborts in cm.c due to too small TTY frame
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)

6 years agoAnother set of improvements in the Emacs manual
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/cmdargs.texi (Title X): Improve wording.

* doc/emacs/building.texi (Grep Searching, Compilation): Avoid
passive tense.

* 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.

6 years agoFix help in mode-line-mode-menu
Michael Albinus [Mon, 12 Feb 2018 10:10:17 +0000 (11:10 +0100)]
Fix help in mode-line-mode-menu

* lisp/bindings.el (mode-line-mode-menu) [auto-revert-tail-mode]:
Fix help string.

6 years agoImprove documentation of desktop restoring
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)

6 years agoImprove the Emacs manual's chapter "Frames"
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.

6 years agoFix unbound mm-uu-entry in mm-uu
Andreas Schwab [Sat, 10 Feb 2018 22:55:48 +0000 (23:55 +0100)]
Fix unbound mm-uu-entry in mm-uu

* lisp/gnus/mm-uu.el (mm-uu-dissect): Rename entry to mm-uu-entry.

6 years agoImprove Emacs user manual in fixit.texi
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.

6 years agoAnother minor change in the manual
Eli Zaretskii [Sat, 10 Feb 2018 11:23:22 +0000 (13:23 +0200)]
Another minor change in the manual

* doc/emacs/glossary.texi (Glossary): Add popular Latin
abbreviations, such as "e.g.".

6 years agoMore minor changes in the Emacs manual
Eli Zaretskii [Sat, 10 Feb 2018 09:19:43 +0000 (11:19 +0200)]
More minor changes in the Emacs manual

* doc/emacs/xresources.texi (GTK resources):
* doc/emacs/trouble.texi (Contributing):
* doc/emacs/frames.texi (Fonts): Use HTTPS URLs instead of HTTP.

* doc/emacs/docstyle.texi: Add a few @hyphenation directives,
based on reports in emacs-manual-bugs@gnu.org about incorrect
hyphenation.

6 years agoAvoid printing garbled error message from image.el
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)

6 years agoDoc string fix in latin-alt.el
Eli Zaretskii [Fri, 9 Feb 2018 16:22:07 +0000 (18:22 +0200)]
Doc string fix in latin-alt.el

* lisp/leim/quail/latin-alt.el ("dutch"): Doc fix.  Reported by
Robert Pluim <rpluim@gmail.com>.

6 years agoMinor improvements in package.texi
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.

6 years agoMinor improvement in Emacs user manual
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.

6 years ago* doc/lispref/anti.texi (Antinews): Replace 25.2 with 25.3.
Michael Albinus [Fri, 9 Feb 2018 12:04:12 +0000 (13:04 +0100)]
* doc/lispref/anti.texi (Antinews): Replace 25.2 with 25.3.

6 years agoImprove documentation of mini-window resizing
Eli Zaretskii [Fri, 9 Feb 2018 10:28:59 +0000 (12:28 +0200)]
Improve documentation of mini-window resizing

* doc/lispref/minibuf.texi (Minibuffer Windows): Mention
'message-truncate-lines' for preventing resizing of minibuffer
windows.  (Bug#19045)
(Minibuffer Misc): Remove redundant description of
'max-mini-window-height'.
* doc/lispref/display.texi (Echo Area Customization): Adjust
cross-reference.

6 years agoMore changes in the Emacs manual
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.

6 years agoClarify that text-quoting-style doesn't affect *Info* (Bug#24519)
Noam Postavsky [Fri, 9 Feb 2018 01:18:44 +0000 (20:18 -0500)]
Clarify that text-quoting-style doesn't affect *Info* (Bug#24519)

* src/doc.c (syms_of_doc) <text-quoting-style>: Clarify that info
manual display is unaffected.

6 years agoMention that shell quoting of % on w32 may fail (Bug#19350)
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.

6 years agoFix --no-build-details for w32 and macOS
Noam Postavsky [Tue, 6 Feb 2018 17:20:37 +0000 (12:20 -0500)]
Fix --no-build-details for w32 and macOS

* src/w32term.c (w32_initialize_display_info): Handle nil system-name.
* lisp/term/ns-win.el (window-system-initialization): Don't pass nil
to `x-open-connection'.

6 years ago* doc/lispref/anti.texi (Antinews): Add some more antinews.
Paul Eggert [Thu, 8 Feb 2018 23:58:05 +0000 (15:58 -0800)]
* doc/lispref/anti.texi (Antinews): Add some more antinews.

6 years agoFix crashes when run with --no-build-details
Paul Eggert [Tue, 6 Feb 2018 23:25:45 +0000 (15:25 -0800)]
Fix crashes when run with --no-build-details

* src/xrdb.c (get_environ_db):
* src/xterm.c (same_x_server, x_term_init):
Don’t assume Fsystem_name returns a string.

6 years agoMore changes for the manual
Eli Zaretskii [Thu, 8 Feb 2018 16:24:16 +0000 (18:24 +0200)]
More changes for the manual

* doc/emacs/anti.texi (Antinews): Replace 25.2 with 25.3.
Reported by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.

* doc/emacs/custom.texi (Function Keys): Improve wording.
Suggested by clemens.radermacher@posteo.de in
emacs-manual-bugs@gnu.org.

* doc/emacs/misc.texi (History References): Improve punctuation.
(Terminal emulator): Fix a typo.
(Term Mode): Remove redundant repeated text.
(Invoking emacsclient): Improve wording.  Suggested by Alberto
Sartori <alberto.sartori@sissa.it> in emacs-manual-bugs@gnu.org.

* doc/emacs/files.texi (Visiting): Fix last change.

6 years agoDoc fixes for process functions (Bug#30349)
Noam Postavsky [Tue, 6 Feb 2018 00:36:27 +0000 (19:36 -0500)]
Doc fixes for process functions (Bug#30349)

* doc/lispref/processes.texi (Asynchronous Processes): Explain what
the 'stopped' state means for a pipe process.
* src/process.c (Fmake_process, Fmake_pipe_process)
(Fmake_serial_process, Fmake_network_process):
* lisp/subr.el (start-process):
* lisp/net/tls.el (open-tls-stream):
* lisp/net/starttls.el (starttls-open-stream):
* lisp/net/gnutls.el (open-gnutls-stream): Remove meaningless phrase
"specify an output stream" phrase from docstring.