Commit graph

6579 commits

Author SHA1 Message Date
Glenn Morris
d74261fb74 * doc/lispref/windows.texi (Selecting Windows): Fix a typo. 2018-12-11 14:17:56 +08:00
Charles A. Roelli
4a6cf41144 * doc/lispref/internals.texi (Writing Emacs Primitives): Fix grammar. 2018-12-11 14:17:56 +08:00
Alan Mackenzie
590166c829 Firm up documentation of generalized variables
* doc/lispref/variables.texi (Generalized Variables)
(Setting Generalized Variables): Define a generalized variable as something
setf can write to.  Remove the insinuation that hackers have poor memories.
State explicitly that the list of GVs given is complete.  Remove the
suggestion that `setf' has superseded, or is in the process of superseding,
`setq'.  Make minor corrections to the English.
2018-12-11 14:17:53 +08:00
Eli Zaretskii
36a0cfe805 Improve documentation of Auto-Revert mode
* doc/emacs/files.texi (Reverting): Mention that Aut-Revert
applies to Dired buffers as well.  Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
2018-12-11 14:17:53 +08:00
Eli Zaretskii
19ed17602e Improvements in dired.texi
* doc/emacs/dired.texi (Dired): Mention that Dired works with
remote directories.
(Dired Enter): ls-lisp is used on some remote systems as well.
(Dired Navigation): Mention and index the command names.
(Dired Deletion): Document the 'always' value of
dired-recursive-deletes.  Mention the alternative deletion method.
(Marks vs Flags): Fix spelling of Auto-Revert mode.  Document what
marking does on a subdirectory header line.
(Operating on Files): Document that 'Z' uses gzip or compress.
(Comparison in Dired): Mention ediff-files.
(Misc Dired Features): Fix a typo.  Suggested by Michael Albinus
<michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
2018-12-11 14:17:53 +08:00
Paul Eggert
d219c99fc6 Autoupdate from Gnulib 2018-12-11 14:17:53 +08:00
Nick Helm
06a984e14e Improve documentation of 'with-help-window'
* doc/lispref/help.texi (Help Functions): Change variable name
to 'buffer-or-name'.

* lisp/help.el (with-help-window): Change variable name to
'buffer-or-name' and rewrite the doc string, adding reference
to 'help-window-setup'.  (Bug#30792)
2018-12-11 14:17:52 +08:00
Eli Zaretskii
a5db603125 Minor improvements in building.texi
* doc/emacs/building.texi (Compilation Shell): Mention that this
section is for local compilation buffers.
(Compilation, Compilation Mode): Mention that 'g' is bound to
'recompile' in compilation buffers.
(Grep Searching): Add a cross-reference to "Compilation Mode".
Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
2018-12-11 14:17:52 +08:00
Eli Zaretskii
15d031ea3f * doc/emacs/building.texi (Starting GUD): Mention 'guiler'. 2018-12-11 14:17:52 +08:00
Eli Zaretskii
abe37f8438 Yet more proofreading of the Emacs manual
* doc/emacs/building.texi (Compilation, Grep Searching)
(Debuggers, GUD Customization, Source Buffers)
(Breakpoints Buffer, Threads Buffer): Minor fixes and updates.
Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
2018-12-11 14:17:52 +08:00
Paul Eggert
73f9e1d167 * doc/emacs/rmail.texi: Fix broken link. 2018-12-11 14:17:52 +08:00
Paul Eggert
1ac09583c0 Fix recently-added POP doc glitch
* doc/emacs/rmail.texi (Remote Mailboxes):
POP3 → POP, when talking about POP in general.
2018-12-11 14:17:52 +08:00
Eli Zaretskii
367ff818b4 More proofreading of the Emacs manual
* doc/emacs/macos.texi (Mac / GNUstep Basics): Fix typos.  Improve
indexing.
(Mac / GNUstep Basics, Mac / GNUstep Customization)
(Mac / GNUstep Events): Improve indexing.

* doc/emacs/rmail.texi (Rmail): Mention Gnus.
(Rmail Basics, Rmail Scrolling): Improve cross-references and
indexing.
(Rmail Motion): Minor improvements.
(Rmail Inbox): Remove outdated text about Babyl format.
(Rmail Files): Formatting changes.  Comment out
set-rmail-inbox-list in the table of commands, as it is commented
out in the text that follows.
(Rmail Output, Rmail Labels, Rmail Reply, Rmail Make Summary):
Minor copyedits.
(Rmail Summary Edit): Document
rmail-summary-scroll-between-messages.
(Rmail Editing): Improve indexing.
(Movemail): Fix typos.
(Remote Mailboxes): Use "POP3" rather than "POP".
2018-12-11 14:17:52 +08:00
Simen Heggestøyl
9c19d2d674 Fix typo in the Emacs manual's VC chapter
* doc/emacs/maintaining.texi (VC Directory Buffer): Fix a typo.
2018-12-11 14:17:51 +08:00
Radon Rosborough
31b6fa0a49 Various follow-ups for early init file changes
* doc/emacs/custom.texi (Early Init File): Add more details about
which variables must be set in the early init file rather than the
regular init file.  See
https://lists.nongnu.org/archive/html/bug-gnu-emacs/2018-02/msg00827.html

* lisp/emacs-lisp/package.el (package-enable-at-startup): Update
docstring to note that packages are now made available before loading
the init file, rather than afterwards.  See
https://lists.gnu.org/archive/html/emacs-devel/2018-02/msg00632.html
(package-load-list): Refer to "making available" rather than "loading"
for packages.  See
https://lists.gnu.org/archive/html/emacs-devel/2018-02/msg00298.html

* lisp/startup.el (command-line): Call `custom-reevaluate-setting' on
predefined variables before loading the early init file and before
`package-initialize' is called.  This prevents
`Info-default-directory-list' from being unbound when
`package-initialize' tries to access it during startup.  See
https://lists.gnu.org/archive/html/emacs-devel/2018-02/msg00545.html

* lisp/emacs-lisp/package.el (package-initialize): Issue a warning
if called twice.
See: https://lists.gnu.org/archive/html/emacs-devel/2018-02/msg00626.html
     https://lists.gnu.org/archive/html/emacs-devel/2018-03/msg00301.html
2018-12-11 14:17:51 +08:00
Noam Postavsky
e907e4a341 Improve word motion docs (Bug#30815)
* doc/lispref/positions.texi (Word Motion): Fix reference to
`char-script-table'.
* lisp/simple.el (backward-word):
* src/syntax.c (forward-word): Mention `char-script-table' and add
link to the 'Word Motion' manual section.
2018-12-11 14:17:51 +08:00
Michael Albinus
57200d8619 Replace "carriage-return" by "carriage return" in manuals
* doc/emacs/msdos.texi:
* doc/emacs/mule.texi:
* doc/emacs/screen.texi:
* doc/lispref/nonascii.texi:
* doc/misc/calc.texi: Replace "carriage-return" by "carriage
return".  Suggested by Richard Stallman <rms@gnu.org> in
emacs-manual-bugs@gnu.org.
2018-12-11 14:17:30 +08:00
Eli Zaretskii
8ea5938a56 Minor copyedits in mule.texi
* doc/emacs/mule.texi (Recognize Coding, Fontsets): Minor changes
in wording.  Suggested by Richard Stallman <rms@gnu.org> in
emacs-manual-bugs@gnu.org.
2018-12-11 14:17:30 +08:00
Glenn Morris
29b717073a Doc fixes re obsolete items
* doc/emacs/mini.texi (Completion Commands): Small update re mouse.
* doc/misc/htmlfontify.texi (Customization): Replace obsolete alias.
2018-12-11 14:17:30 +08:00
Eli Zaretskii
a8e5163dcb Minor changes in mule.texi
* doc/emacs/mule.texi (International, Coding Systems)
(Bidirectional Editing): Minor wording changes and typo fixes.
Suggested by Michael Albinus <michael.albinus@gmx.de> in
emacs-manual-bugs@gnu.org.
2018-12-11 14:15:04 +08:00
Glenn Morris
b92cf0902f Stop mentioning options.el in doc
* doc/misc/calc.texi (Customizing Embedded Mode):
Remove mentions of the obsolete (since 22.1) options.el.
* lisp/progmodes/meta-mode.el: Comment fix.
2018-12-11 14:15:04 +08:00
Eli Zaretskii
2fe4ae766f Fix last change in Xref documentation
* doc/emacs/maintaining.texi (Looking Up Identifiers): More
accurate wording for the description of xref-etags-mode.
2018-12-11 14:15:04 +08:00
Eli Zaretskii
066e71dcbb More changes in the Emacs manual
* doc/emacs/text.texi (Words, Foldout, Table Conversion): Clarify
text.  Reported by Gijs Hillenius <gijs@hillenius.net> in
emacs-manual-bugs@gnu.org.

* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/msdos-xtra.texi (MS-DOS Keyboard):
* doc/emacs/macos.texi (Mac / GNUstep Basics):
* doc/emacs/glossary.texi (Glossary):
* doc/emacs/custom.texi (Function Keys, Init Syntax):
* doc/emacs/commands.texi (User Input):
* doc/emacs/basic.texi (Arguments): Fix capitalization of "Meta".
* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/dired.texi (Dired Updating):
* doc/emacs/custom.texi (Init Rebinding): Fix misuses of @key.
Suggested by Richard Stallman <rms@gnu.org>.
2018-12-11 14:15:04 +08:00
Eli Zaretskii
7f35e7dd65 Improve documentation of Xref
* doc/emacs/maintaining.texi (Looking Up Identifiers): Document
xref-etags-mode.
2018-12-11 14:15:04 +08:00
Charles A. Roelli
ad8d136989 Allow toggling Grep command abbreviation, and rename related symbols
* lisp/progmodes/grep.el (grep-find-hide): Rename 'grep-find-hide'
to 'grep-find-abbreviate'.
(grep-find-hide-properties): Rename to
'grep-find-abbreviate-properties'.
(grep-mode-font-lock-keywords): Even when 'grep-find-abbreviate'
is nil, fontify the verbose command options with property
'abbreviated-command', so that the toggling command can later find
these parts without refontifying.
(grep-find-show): Rename to 'grep-find-toggle-abbreviation',
simplify the code, and permit toggling the hidden command options.
(grep-mode-map): Add a menu-bar item and new separator for
'grep-find-toggle-abbreviation', and fix the incumbent separators
in the "Grep" menu-bar, of which only one was showing before this
commit, even though two were specified.
* etc/NEWS (grep):
* doc/emacs/building.texi (Grep Searching): Document these
changes, and mention 'grep-find-toggle-abbreviation'.
2018-12-11 14:15:03 +08:00
Charles A. Roelli
1731947df5 Document 'transpose-sentences' and 'transpose-paragraphs'
* doc/emacs/fixit.texi (Transpose): Add documentation and index
entries for 'transpose-sentences' and 'transpose-paragraphs'
(Bug#30343 in passing).
2018-12-11 14:15:03 +08:00
Charles A. Roelli
5276bca8f2 Make transpose-regions interactive (Bug#30343)
* doc/emacs/fixit.texi (Transpose): Mention and explain the new
command.
* editfns.c (Ftranspose_regions): Add an interactive calling
specification, and add documentation for it.
2018-12-11 14:15:03 +08:00
Charles A. Roelli
c8d9b5d0f0 Unify documentation on 'save-some-buffers'
* doc/emacs/files.texi (Save Commands): Include some more keys
that can be used in 'save-some-buffers'.

* lisp/files.el (save-some-buffers): Include the same keys as
above, and document all missing ones.
2018-12-11 14:15:03 +08:00
Charles A. Roelli
46738e3765 Improve SVG documentation
* doc/lispref/display.texi (ImageMagick Images): Remove an
outdated comment that references a fixed bug.
(SVG Images): Fix grammar, and call functions functions (there are
no commands in lisp/svg.el).
2018-12-11 14:15:03 +08:00
Eli Zaretskii
e2694303fe Document the "URL" keyword in library headers
* doc/lispref/tips.texi (Library Headers): "URL" is an alias for
"Homepage".  Suggested by Peter Oliver <p.d.oliver@mavit.org.uk>.
(Bug#30571)
2018-12-11 14:15:03 +08:00
Eli Zaretskii
f3b9db19f1 Improve support for desktop restoration in daemon mode
* lisp/server.el (server-after-make-frame-hook): New hook.
(server-execute): Call it after creating a new frame or before
switching to a buffer shown in a client frame.  (Bug#30421)

* doc/emacs/misc.texi (Saving Emacs Sessions): Adjust advice for
restoring desktop in daemon mode to the new hook.
* doc/lispref/frames.texi (Creating Frames, Standard Hooks):
Document server-after-make-frame-hook.

* etc/NEWS: Mention server-after-make-frame-hook.
2018-12-11 14:15:03 +08:00
Paul Eggert
0160cc564b Avoid losing info when formatting integers
* doc/lispref/numbers.texi (Integer Basics): Clarify that
out-of-range integers are treated as floating point only when the
integers are decimal.
* etc/NEWS: Mention changes.
* src/editfns.c (styled_format): Use %.0f when formatting %d or %i
values outside machine integer range, to avoid losing info.
Signal an error for %o or %x values that are too large to be
formatted, to avoid losing info.
2018-12-11 14:14:02 +08:00
Juri Linkov
c69a17d62d * lisp/isearch.el (search-exit-option): Add option 'append'.
(isearch-pre-command-hook): Use it.

* doc/emacs/search.texi: Replace search-exit-option option nil with append.

https://lists.gnu.org/archive/html/emacs-devel/2018-03/msg00202.html
2018-12-11 14:14:01 +08:00
Charles A. Roelli
de2b09f7ae Add to "Completion Commands" Info node
* doc/emacs/mini.texi (Completion Commands): Mention other keys
for 'next-completion' and 'previous-completion', and explain 'q'
and 'z' which are relatively new additions.
2018-12-11 14:14:01 +08:00
Glenn Morris
850e683ef5 ; Tiny fix for recent doc change 2018-12-11 14:14:01 +08:00
Michael Albinus
7a082db357 Minor change in the manual
* doc/emacs/display.texi (Useless Whitespace):
Don't upcase "TAB" and "SPC" when alluding to characters.
2018-12-11 14:14:01 +08:00
Eli Zaretskii
1d6e5622c2 More minor changes in the manual
* doc/emacs/display.texi (Useless Whitespace): Don't upcase "TAB"
and "SPC" when alluding to characters.  Suggested by Richard
Stallman <rms@gnu.org>.

* doc/emacs/buffers.texi (Misc Buffer): Clarify what "read-only"
means for buffers.
(Buffers): Define and describe "buffer contents".  Suggested by
Richard Stallman <rms@gnu.org>.  (Bug#30685)
2018-12-11 14:14:01 +08:00
Michael Albinus
f8efd236ff Add OpenDocument formats to Tramp file archives
* doc/misc/tramp.texi (Archive file names):
* lisp/net/tramp-archive.el (tramp-archive-suffixes):
Add OpenDocument formats.
2018-12-11 14:14:01 +08:00
Paul Eggert
eeda1f8250 Update from Gnulib
This includes:
2018-03-07 maint: write-file-hooks -> before-save-hook
2018-03-05 binary-io: pacify gcc -Wunused-parameter
2018-03-05 fflush: adjust to glibc 2.28 libio.h removal
* build-aux/config.guess, build-aux/config.sub:
* build-aux/gitlog-to-changelog, build-aux/install-sh:
* build-aux/move-if-change, build-aux/update-copyright:
* doc/misc/texinfo.tex, lib/binary-io.h, lib/fpending.c:
* lib/stdio-impl.h: Copy from Gnulib.
2018-12-11 14:14:01 +08:00
Glenn Morris
d2d8012b92 Replace some obsolete aliases in documentation
* doc/misc/efaq-w32.texi (Incoming mail with Rmail):
* doc/misc/speedbar.texi (Major Display Modes):
* lisp/mh-e/mh-folder.el (mh-restore-desktop-buffer):
Doc fixes re obsolete aliases.
; * lisp/autoinsert.el (auto-insert):
; * lisp/ffap.el (ffap-newfile-prompt):
; * lisp/woman.el (woman-insert-file-contents): Comment fixes.
2018-12-11 14:14:01 +08:00
Eli Zaretskii
bb63387315 Minor improvements in manuals
* doc/lispref/variables.texi (Local Variables): Make more clear
that local bindings of 'let' are in effect only within the body.
Suggested by Marcin Borkowski <mbork@mbork.pl>, see
https://lists.gnu.org/archive/html/emacs-devel/2018-03/msg00217.html
for the details.

* doc/emacs/programs.texi (Matching): Fix a typo.  Reported by
Alex Branham <alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.
Improve indexing.
2018-12-11 14:14:01 +08:00
Eli Zaretskii
7ec13d7fea Minor copyedits in display.texi
* doc/emacs/display.texi (Highlight Interactively)
(Useless Whitespace, Line Truncation, Visual Line Mode): Minor
changes of wording and typo corrections.  Suggested by Michael
Albinus <michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
2018-12-11 14:14:01 +08:00
Glenn Morris
5c6f7b34a6 Replace some obsolete aliases in documentation
* doc/emacs/text.texi (Nroff Mode):
* doc/misc/efaq.texi (How to add fonts):
* lisp/gnus/nnheader.el (nnheader-insert-file-contents):
* lisp/progmodes/pascal.el (pascal-outline-mode):
Doc fixes re obsolete aliases.
; * src/frame.c (do_switch_frame): Comment.
2018-12-11 14:14:00 +08:00
Eli Zaretskii
0ed901f3b2 More minor changes in the Glossary of the Emacs manual
* doc/emacs/glossary.texi (Glossary): Improve cross-references for
modifier keys.  Fix typos.  Suggested by Gijs Hillenius
<gijs@hillenius.net> in emacs-manual-bugs@gnu.org.
2018-12-11 14:14:00 +08:00
Eli Zaretskii
02bc779494 Minor fix in Emacs manual's Glossary
* doc/emacs/glossary.texi (Glossary): Fix outdated text about
primary selection.  Reported by Gijs Hillenius
<gijs@hillenius.net> in emacs-manual-bugs@gnu.org.
2018-12-11 14:09:22 +08:00
Paul Eggert
0e10b6fce7 Spelling fixes (Bug#10068)
* lisp/gnus/gnus-score.el (gnus-score-find-favorite-words):
Rename from gnus-score-find-favourite-words.
* lisp/hfy-cmap.el (hfy-fallback-color-map)
(hfy-rgb-txt-color-map, hfy-fallback-color-values):
* lisp/htmlfontify.el (hfy-color-vals, hfy-color):
Rename from names that used 'colour' instead of 'color'.
2018-03-04 17:39:53 -08:00
Paul Eggert
bd6c1976fb Merge from origin/emacs-26
f2caf08ca6 ; Spelling fixes
f0e5f220b6 * lisp/progmodes/grep.el (zrgrep):
a0f71260f8 Minor copyedits in doc/emacs/text.texi
adfe2f580f Remove outdated comment in syntax.el
b80e15b6a6 Prevent Flyspell from changing unrelated words
e385599457 Avoid errors in flymake in builds --without-x
d691e30cb0 More improvements of the Emacs manual
2018-03-04 17:16:39 -08:00
Paul Eggert
f2caf08ca6 ; Spelling fixes 2018-03-04 17:10:34 -08:00
Bill Wohler
a56a3fc684 Add missing findex entries for recently removed kindex entries
* doc/misc/mh-e.texi:
2018-03-03 15:57:57 -08:00
Juri Linkov
90ca83d4bf * lisp/isearch.el (search-exit-option): Add options ‘shift-move’ and ‘move’.
Change type from ‘boolean’ to ‘choice’.  Extend docstring.
(isearch-pre-move-point): New variable.
(isearch-pre-command-hook, isearch-post-command-hook):
Handle search-exit-option for values ‘move’ and ‘shift-move’.

* doc/emacs/search.texi (Not Exiting Isearch): Document new
values ‘shift-move’ and ‘move’ of search-exit-option.

https://lists.gnu.org/archive/html/emacs-devel/2018-03/msg00013.html
2018-03-04 00:33:30 +02:00