Commit graph

2138 commits

Author SHA1 Message Date
Martin Rudalics
8d4500087f Fix some issues in the emacs/lispref manuals
* doc/emacs/basic.texi (Continuation Lines):
* doc/emacs/building.texi (GDB User Interface Layout):
* doc/emacs/dired.texi (Misc Dired Features):
* doc/emacs/maintaining.texi (Identifier Search):
* doc/emacs/mark.texi (Using Region):
* doc/emacs/misc.texi (Document View, DocView Conversion):
* doc/emacs/modes.texi (Major Modes):
* doc/emacs/mule.texi (Input Methods, Unibyte Mode):
* doc/emacs/sending.texi (Mail Methods): Replace @code by
@kbd.
* doc/emacs/frames.texi (Text-Only Mouse):
* doc/lispref/maps.texi (Standard Keymaps): Replace @kbd by
@key.
* doc/lispref/compile.texi (Compiler Errors): Write
non-@code{nil} instead of non-nil.
* doc/lispref/debugging.texi (Internals of Debugger):
'backtrace' is not a command.  'debugger-stack-frame-as-list'
is an option.
* doc/lispref/display.texi (Size of Displayed Text):
'window-lines-pixel-dimensions' has a last argument 'left'.
* doc/lispref/display.texi (Attribute Functions):
'set-face-underline' and 'set-face-inverse-video' are
commands.
(Tooltips): 'tooltip-frame-parameters' is an option.
(Bidirectional Display): 'bidi-paragraph-direction' is an
option.
* doc/lispref/frames.texi (Cursor Parameters): 'cursor-type'
is an option.
(Input Focus): Argument FRAME of 'x-focus-frame' is not
optional.
(Child Frames): Both arguments of 'frame-ancestor-p' are
non-optional.  'iconify-child-frame' is an option.
* doc/lispref/os.texi (Killing Emacs):
'kill-emacs-query-functions' is an option.
* doc/lispref/windows.texi (Mouse Window Auto-selection):
'mouse-autoselect-window' is an option.
2018-01-28 19:27:39 +01:00
Eli Zaretskii
194ded5990 Fix multiple spaces in Emacs manual
* doc/emacs/search.texi (Lax Search): Fix multiple consecutive
spaces in printed manual.
2018-01-28 19:29:07 +02:00
Eli Zaretskii
231474fb76 Adjudicate comments to "International" chapter of Emacs manual
* doc/emacs/mule.texi (International Chars)
(Language Environments, Input Methods, Defining Fontsets)
(Modifying Fontsets): Minor wording changes and typo fixes.
Reported by Francis Wright <f.j.wright@live.co.uk> in
emacs-manual-bugs@gnu.org.
2018-01-28 19:14:14 +02:00
Eli Zaretskii
e1a44033a8 Minor changes in the Emacs manual
* doc/emacs/search.texi (Search Customizations): Minor wording
change.
* doc/emacs/files.texi (Customize Save): Add a cross-reference
for batch mode.
2018-01-27 14:06:02 +02:00
Eli Zaretskii
372fda682a Improve the "Files" chapter of the Emacs manual
* doc/emacs/files.texi (File Shadowing): Rearrange text to explain
the notion of shadowing before describing the commands.  Suggested
by Will Korteland <emacs-devel@korte.land> in
emacs-manual-bugs@gnu.org.
2018-01-27 13:17:24 +02:00
Eli Zaretskii
9afc86d1fa Improve the "Search" chapter of the Emacs manual
* doc/emacs/search.texi (Regexps, Regexp Backslash): Improve and
clarify wording.
(Search Customizations): Fix a typo.  Reported by Will Korteland
<emacs-devel@korte.land> in emacs-manual-bugs@gnu.org.
2018-01-27 12:53:29 +02:00
Eli Zaretskii
5a1ee67ae1 Another minor copyedit in the manual's "Scroll Bars"
* doc/emacs/frames.texi (Scroll Bars): Mention that up/down and
left/right buttons may be absent from the toolkit scroll bars.
Reported by Robert Pluim <rpluim@gmail.com> in
emacs-manual-bugs@gnu.org.
2018-01-26 15:48:30 +02:00
Eli Zaretskii
5699a824f0 Minor rewording in Emacs manual's "Help Mode" node
* doc/emacs/help.texi (Help Mode): Minor rewording of description
of 'help-follow-symbol'.  Suggested by Richard Stallman
<rms@gnu.org> in emacs-manual-bugs@gnu.org.
2018-01-26 11:43:05 +02:00
Eli Zaretskii
f35ff0156e Fixes for Emacs manual in frames.texi
* doc/emacs/frames.texi (Scroll Bars, Mouse Commands)
(Window Dividers): Minor clarifications and spelling/markup
changes.  Suggested by Robert Pluim <rpluim@gmail.com> in
emacs-manual-bugs@gnu.org.
2018-01-26 11:25:24 +02:00
Eli Zaretskii
6b01b9475d Minor improvement in section "Pages" of the usere manual
* doc/emacs/text.texi (Pages): Improve wording.  Suggested by Will
Korteland <emacs-devel@korte.land> in emacs-manual-bugs@gnu.org.
2018-01-21 19:55:46 +02:00
Eli Zaretskii
e8c8bd3de2 Minor improvements in user manual
* doc/emacs/trouble.texi (Emergency Escape, Contributing): Clarify
text.  Suggested by Jonathan Kyle Mitchell <kyle@jonathanmitchell.org>
in emacs-manual-bugs@gnu.org
2018-01-21 19:45:14 +02:00
Eli Zaretskii
26b8b92e63 Improve the "Mark" chapter of the user manual
* doc/emacs/mark.texi (Setting Mark, Marking Objects): Improve and
clarify wording.  Suggested by John Cummings <john@rootabega.net>
in emacs-manual-bugs@gnu.org.
2018-01-21 19:36:57 +02:00
Eli Zaretskii
759569fe40 Improve the "Buffers" chapter of the user manual
* doc/emacs/buffers.texi (Several Buffers): Correct description of
prefix arguments.  Clarify "bury".
(Buffer Menus): Clarify wording.  Reported by John Cummings
<john@rootabega.net> in emacs-manual-bugs@gnu.org.
2018-01-21 19:27:37 +02:00
Eli Zaretskii
854a1c0a61 Improve "Buffers" in the user manual
Suggested by John Cummings <john@rootabega.net> in
emacs-manual-bugs@gnu.org:
* doc/emacs/buffers.texi (Select Buffer): Add cross-references to
"Windows" and "Frames".
(Misc Buffer, Kill Buffer): Use BUFFER consistently in commands
that accept buffer names.
(Select Buffer): Improve description of "M-g M-g".  Improve
wording.
(Misc Buffer, Kill Buffer): Improve wording.
(Kill Buffer): Fix the response required by kill-some-buffers.
Mention customizable options that control what clean-buffer-list
does.
(Several Buffers): More detail about
'Buffer-menu-unmark-all-buffers'.
2018-01-20 21:37:30 +02:00
Eli Zaretskii
cfc94fd245 Don't mention 'vc-stay-local' in the user manual
* doc/emacs/vc1-xtra.texi (CVS Options):
* doc/emacs/maintaining.texi (VC Directory Buffer): Remove
references to 'vc-stay-local', which no longer exists.
(Bug#30138)
2018-01-20 14:44:01 +02:00
Eli Zaretskii
8ce430bb50 Fix a typo in calendar.texi
* doc/emacs/calendar.texi (Writing Calendar Files): Capitalize
"Filofax".  Reported by Will Korteland <emacs-devel@korte.land>
in emacs-manual-bugs@gnu.org.
2018-01-20 10:56:15 +02:00
Eli Zaretskii
bb748b3640 Minor improvement in wording of the Emacs manual
* doc/emacs/killing.texi (CUA Bindings): Improve wording.
Suggested by Will Korteland <emacs-devel@korte.land> in
emacs-manual-bugs@gnu.org.
2018-01-20 10:52:06 +02:00
Eli Zaretskii
7f48a11216 Improve the Emacs manual as suggested in emacs-manual-bugs
* doc/emacs/killing.texi (Deletion and Killing): Add
cross-reference to "Kill Ring".
* doc/emacs/help.texi (Help Mode, Package Keywords): Improve
wording.  Suggested by Will Korteland <emacs-devel@korte.land> in
emacs-manual-bugs@gnu.org.
2018-01-19 21:18:03 +02:00
Eli Zaretskii
a502ee9dc4 ; * doc/emacs/misc.texi (Amusements): Really add "games" to the section name. 2018-01-13 11:47:17 +02:00
Eli Zaretskii
106bf8adc3 Improve the Emacs manual's "Misc" node
* doc/emacs/misc.texi (Gnus): A more descriptive section name.
(Invoking emacsclient): Mention how to avoid errors when there's
no Emacs server.
(EWW, Embedded WebKit Widgets): Now subsections under
"Hyperlinking and Web Navigation Features".
(Amusements): Add "games" to the section name.  Suggested by Alex
Branham <alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.

* doc/emacs/emacs.texi (Top): Adjust the top-level menus to the
above changes.

* doc/lispref/os.texi (Security Considerations): Fix typos.
2018-01-13 11:45:04 +02:00
Eli Zaretskii
bd2a2a1e84 Improve documentation of etags
* doc/emacs/maintaining.texi (Tag Syntax, Create Tags Table):
Improve documentation of etags options and of source language
detection.
2018-01-11 19:44:29 +02:00
Eli Zaretskii
f8a07fa6b1 Improve documentation of 'gdb-many-windows'
* doc/emacs/building.texi (GDB User Interface Layout): Add advice
for using a separate frame for 'gdb-many-windows'.
2018-01-05 17:05:42 +02:00
Paul Eggert
63b04c11d5 Fix copyright years by hand
These are dates that admin/update-copyright did not update, or
updated incorrectly.
2018-01-01 01:02:09 -08:00
Paul Eggert
5c7dd8a783 Update copyright year to 2018
Run admin/update-copyright.
2018-01-01 00:57:59 -08:00
Eli Zaretskii
acd289c5a4 Fix problems with indexing in User manual
* doc/emacs/basic.texi (Continuation Lines, Inserting Text)
(Moving Point):
* doc/emacs/help.texi (Help Echo, Package Keywords, Help Mode):
* doc/emacs/trouble.texi (Quitting):
* doc/emacs/mark.texi (Setting Mark, Disabled Transient Mark):
* doc/emacs/custom.texi (Modifier Keys, Init Examples)
(Creating Custom Themes):
* doc/emacs/programs.texi (Program Modes, Expressions, Hideshow)
(Basic Indent, Info Lookup, Symbol Completion):
* doc/emacs/screen.texi (Echo Area):
* doc/emacs/xresources.texi (Table of Resources, GTK Names in Emacs):
* doc/emacs/display.texi (Line Truncation, Cursor Display):
* doc/emacs/files.texi (File Names, Backup, File Archives):
* doc/emacs/dired.texi (Operating on Files, Dired Enter):
* doc/emacs/commands.texi (User Input):
* doc/emacs/mule.texi (International, Unibyte Mode)
(International Chars):
* doc/emacs/vc1-xtra.texi (RCS and SCCS, Version Headers)
(CVS Options):
* doc/emacs/modes.texi (Major Modes, Minor Modes):
* doc/emacs/indent.texi (Just Spaces):
* doc/emacs/frames.texi (Mouse Avoidance, Mode Line Mouse)
(Frame Commands):
* doc/emacs/cmdargs.texi (Initial Options):
* doc/emacs/abbrevs.texi (Dabbrev Customization):
* doc/emacs/mini.texi (Completion Example, Completion Commands):
* doc/emacs/calendar.texi (Writing Calendar Files, Calendar Unit Motion)
(From Other Calendar):
* doc/emacs/regs.texi (Text Registers, Bookmarks):
* doc/emacs/buffers.texi (Several Buffers, Select Buffer):
* doc/emacs/maintaining.texi (Xref Commands):
* doc/emacs/windows.texi (Pop Up Window):
* doc/emacs/text.texi (Text, Org Mode):
* doc/emacs/killing.texi (Other Kill Commands):
* doc/emacs/misc.texi (Document View, Gnus Group Buffer)
(Gnus Summary Buffer, Shell Mode):
* doc/emacs/cal-xtra.texi (Sexp Diary Entries): Remove or reword
redundant identical index entries.
* doc/emacs/custom.texi (Mouse Buttons)
* doc/emacs/files.texi (Reverting): Fix hyphenation.
* doc/emacs/emacs.texi (Top): Improve wording of Index menu items.
* doc/emacs/files.texi (File Conveniences):
* doc/emacs/programs.texi (MixedCase Words): Make entries that
belong to Concept Index be indexed with @cindex.  (Bug#29888)
2017-12-29 18:04:57 +02:00
Eli Zaretskii
5b38406491 Fix documentation of delsel and of killing text
* doc/emacs/killing.texi (Appending Kills): Make sure the text
with 2 spaces is not broken between 2 lines.
* doc/emacs/mark.texi (Using Region): Remove the sentence about
delsel mode that describes behavior which exists even without
delsel mode turned on.  Suggested by Petteri Hintsanen
<petterih@iki.fi> in emacs-manual-bugs@gnu.org.

* lisp/delsel.el (delete-selection-mode): Doc fix.
2017-12-27 20:23:10 +02:00
Eli Zaretskii
2ebc8dc3b6 Fix curved quotes in printed manual
* doc/emacs/text.texi (Quotation Marks): Fix curved quote
characters in the printed version of the manual.
2017-12-26 22:43:32 +02:00
Eli Zaretskii
13c59d0a83 More improvements for text.texi
* doc/emacs/text.texi (Outline Motion): Avoid unneeded
repetition.  Suggested by Petteri Hintsanen <petterih@iki.fi> in
emacs-manual-bugs@gnu.org.
2017-12-25 21:49:37 +02:00
Eli Zaretskii
7850b7620e Adjudicate review comments for the "Text" chapter of user manual
* doc/emacs/text.texi (Text): Rearrange text for clarity.  Add
cross-reference to the Org manual.  Make the cross-reference to
Outline Mode appear in online manuals as well (the conditional was
a forgotten remnant from time immemoriam).
(Paragraphs): Add a note that 'paragraph-start' and
'paragraph-separate' should not be anchored.
(Auto Fill): Remove redundant text.  Suggested by Petteri
Hintsanen <petterih@iki.fi> in emacs-manual-bugs@gnu.org.
2017-12-24 20:47:06 +02:00
Glenn Morris
b07b56a351 Avoid some overfull lines in PDF manual
* doc/emacs/display.texi (Display Custom):
* doc/emacs/search.texi (Other Repeating Search):
* doc/emacs/text.texi (Quotation Marks): Avoid overfull lines.
2017-12-22 16:24:24 -05:00
Glenn Morris
6b3118f025 * doc/emacs/arevert-xtra.texi (Auto Reverting the Buffer Menu):
Fix ref.
2017-12-22 16:22:13 -05:00
Eli Zaretskii
90ca37feed Fix documentation of 'mouse-drag-and-drop-region' and friends
* doc/emacs/frames.texi (Drag and Drop): Index
'mouse-drag-and-drop-region-cut-when-buffers-differ',
'mouse-drag-and-drop-region-show-tooltip', and
'mouse-drag-and-drop-region-show-cursor'.

* etc/NEWS: Fix the format of the related entries.
2017-12-22 11:19:56 +02:00
Tak Kunihiro
a0e3b06725 Document 'mouse-drag-and-drop-region' options and mention them in NEWS
* doc/emacs/frames.texi (Drag and Drop):
* etc/NEWS (times): Document options for
'mouse-drag-and-drop-region' and mention them in NEWS.
2017-12-22 09:39:07 +01:00
Martin Rudalics
164e84c977 Fix uses of 'nil' and 'non-nil' in manuals and a few more minor issues
* doc/emacs/building.texi (Grep Searching): Fix doc of
'grep-save-buffers'.
(Drag and Drop): Reorder paragraphs.  Fix doc of
'mouse-drag-and-drop-region'.
* doc/emacs/frames.texi (Word and Line Mouse):
* doc/emacs/search.texi (Other Repeating Search):
* doc/lispref/compile.texi (Compilation Functions):
* doc/lispref/files.texi (Directory Names):
* doc/lispref/functions.texi (Advising Named Functions):
* doc/lispref/keymaps.texi (Controlling Active Maps):
* doc/lispref/lists.texi (Association Lists):
* doc/lispref/windows.texi (Quitting Windows): Fix uses of
'non-nil' and 'nil'.
2017-12-22 09:20:41 +01:00
Eli Zaretskii
12ad276d15 Improve documentation of TERM environment variable
* doc/emacs/trouble.texi (Checklist):
* doc/emacs/building.texi (Compilation Shell):
* doc/emacs/misc.texi (Shell Options): Improve indexing of TERM.
* doc/emacs/building.texi (Compilation Shell): Mention
'comint-terminfo-terminal' in conjunction with the TERM value.
2017-12-15 11:45:22 +02:00
Allen Li
8ed529f0f3 Add option to configure comint TERM
* lisp/comint.el (comint-terminfo-terminal): New defcustom.
(comint-term-environment): New function for setting terminal options
(comint-exec-1): Use comint-term-environment.  (Bug#29583)
* lisp/progmodes/compile.el (compilation-start): Use comint-term-environment.

* etc/NEWS:
* doc/emacs/misc.texi (Shell Options): Document the new option.
2017-12-15 11:30:25 +02:00
Eli Zaretskii
90e20804f5 Improve documentation of 'save-abbrevs'.
* doc/emacs/abbrevs.texi (Saving Abbrevs): Document the 'silently'
value of 'save-abbrevs'.  Suggested by Alex Branham
<alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.
2017-12-09 13:43:29 +02:00
Eli Zaretskii
14f0230a48 Improve documentation of Dired
* doc/emacs/dired.texi (Dired): Mention that the Dired buffer can
be made modifiable in Wdired.  Suggested by Alex Branham
<alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.
2017-12-09 13:29:11 +02:00
Eli Zaretskii
77cf972592 Improve documentation of buffer-list commands and features
* doc/emacs/buffers.texi (List Buffers): Add a cross-reference to
"Several Buffers", to establish a relation between the two
sections.
(Buffer Menus): Expand on customizability of alternative buffer
menu offered by bs.el.  Mention IBuffer.
Suggested by Alex Branham <alex.branham@gmail.com> in
emacs-manual-bugs@gnu.org.
2017-12-02 12:56:45 +02:00
Glenn Morris
7e61e74da7 * doc/emacs/mule.texi (Output Coding): Clarify sendmail coding. 2017-12-01 19:59:11 -05:00
Eli Zaretskii
9292276a44 Fix a typo in the Emacs manual
* doc/emacs/abbrevs.texi (Abbrev Concepts): Fix a typo.  Reported
by clemens.radermacher@posteo.de in emacs-manual-bugs@gnu.org.
2017-12-01 10:26:58 +02:00
Eli Zaretskii
42509c0649 Improve the documentation of 'table-insert-sequence'
* doc/emacs/text.texi (Table Misc): Fix the description of
'table-insert-sequence'.  Reported by jack <jackh@gmx.co.uk> in
emacs-manual-bugs@gnu.org.
2017-12-01 10:20:47 +02:00
Paul Eggert
a89f0b6f33 maint: shorten https://lists.gnu.org/archive/html/... links 2017-11-25 22:48:12 -08:00
Eli Zaretskii
8a2b204e64 Improve discoverability of 'read-buffer-completion-ignore-case'
* lisp/window.el (switch-to-buffer)
(switch-to-buffer-other-window, switch-to-buffer-other-frame):
Mention 'read-buffer' in the doc string.  (Bug#29389)

* doc/emacs/buffers.texi (Select Buffer): Add a cross-reference to
where 'read-buffer-completion-ignore-case' is documented.
2017-11-24 15:58:00 +02:00
Glenn Morris
8e40429c96 ; Fix some doc typos 2017-11-22 17:52:11 -05:00
Eli Zaretskii
603a0716a8 Improve the documentation of M-n for entering file names
* lisp/files.el (find-file, find-file-other-window)
(find-file-other-frame): Mention file-name-at-point-functions in
the doc string.  Reported by Florian Weimer <fw@deneb.enyo.de> in
http://lists.gnu.org/archive/html/emacs-devel/2017-11/msg00224.html.

* doc/emacs/mini.texi (Minibuffer History): Document
file-name-at-point-functions and its effect on M-n when typing
file names in the minibuffer.
* doc/emacs/files.texi (File Names):
* doc/emacs/mini.texi (Minibuffer File): Add a cross-reference to
"Minibuffer History", where special features of M-n regarding
files are described.
2017-11-11 13:48:37 +02:00
João Távora
e950f329c0 New xref-quit-and-goto-xref command bound to TAB (bug#28814)
This is like xref-goto-xref, but quits the *xref* window just before
the user jump to ref.

* lisp/progmodes/xref.el (xref--show-location): Handle 'quit
value for SELECT.
(xref-goto-xref): Take optional QUIT arg.
(xref-quit-and-goto-xref): New command.
(xref--xref-buffer-mode-map): Bind "Q" and "TAB" to
xref-quit-and-goto-xref.

* doc/emacs/maintaining.texi (Xref Commands): Describe new bindings in
*xref*.

* etc/NEWS (Xref): Describe new binding.
2017-11-03 16:13:39 +00:00
Charles A. Roelli
460fe4a1bc ; Doc fixes
* lisp/progmodes/xref.el (xref-file-location)
(xref-backend-apropos):
* etc/NEWS (Lisp Changes in Emacs 26.1):
* doc/emacs/msdos.texi (Windows Keyboard):
* lisp/vc/vc.el (vc-print-branch-log):
* src/buffer.c (word-wrap): Doc additions and fixes.
2017-10-31 22:01:34 +01:00
Eli Zaretskii
68182a4710 Make manuals and NEWS consistent
* etc/NEWS: Fix markings on several entries, and rearrange others
as needed.

* doc/emacs/programs.texi (Hideshow): Document the new
outline-like bindings.
* doc/emacs/search.texi (Query Replace): Document 'u' and 'U'.
2017-10-28 13:29:29 +03:00
Paul Eggert
5d51403ceb ; Typo fixes, mostly repeated words 2017-10-09 22:55:06 -07:00