1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-11 02:10:35 -08:00
Commit graph

6391 commits

Author SHA1 Message Date
Paul Eggert
8a73b80aa4 Minor doc fixes, mostly for timestamp issues 2018-02-23 11:52:18 -08:00
Eli Zaretskii
361a8b908b * doc/emacs/mini.texi (Completion Styles): Improve indexing. 2018-02-23 17:39:23 +02:00
Michael Albinus
2dc24d5536 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.
2018-02-23 15:30:19 +01:00
Alan Mackenzie
76f5242838 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.
2018-02-22 18:25:13 +00:00
Eli Zaretskii
5fb29578de 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.
2018-02-22 20:27:24 +02:00
Glenn Morris
de17b8e5f0 Tiny doc/misc markup fixes
* doc/misc/ediff.texi (Patch and Diff Programs):
* doc/misc/viper.texi (File and Buffer Handling): Fix markup typos.
2018-02-22 12:42:13 -05:00
Eli Zaretskii
a6d8f2ba02 Fix capitalization of "Mail-Followup-To"
* doc/emacs/sending.texi (Header Editing, Mail Headers):
Standardize on "Mail-Followup-To" as the capitalization.
2018-02-22 09:37:00 +02:00
Charles A. Roelli
3a26c8a0cd 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.
2018-02-21 20:13:01 +01:00
Eli Zaretskii
106a9f60ae 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.
2018-02-21 20:32:11 +02:00
tino calancha
244db85d73 * doc/misc/viper.texi (File and Buffer Handling): Add missing '@' 2018-02-21 19:41:20 +09:00
Eli Zaretskii
f0d6a16d74 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)
2018-02-21 06:20:58 +02:00
Robert Pluim
05214c65a3 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.
2018-02-20 21:15:19 +02:00
Eli Zaretskii
355c644cc2 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.
2018-02-20 21:13:29 +02:00
Robert Pluim
a8c843478c * doc/emacs/misc.texi (Saving Emacs Sessions): Fix markup. 2018-02-19 18:16:15 +02:00
Eli Zaretskii
275e735dc3 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)
2018-02-19 18:14:08 +02:00
Eli Zaretskii
d962be5a56 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.
2018-02-18 20:52:21 +02:00
Michael Albinus
36e729f06c Minor edit in tramp.texi
* doc/misc/tramp.texi (Remote shell setup, Windows setup hints):
Improve @cindex entries.
2018-02-18 10:52:30 +01:00
Michael Albinus
6537f996c1 ; Fix oversight from last commit
* doc/emacs/maintaining.texi (Select Tags Table): Use proper
"~/.emacs.d" directory.
2018-02-17 19:43:13 +01:00
Eli Zaretskii
eb94588e3c ; * doc/emacs/maintaining.texi: Fix two typos. 2018-02-17 19:52:50 +02:00
Eli Zaretskii
258135ff5d 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.
2018-02-17 19:48:23 +02:00
Eli Zaretskii
f138bca8ca 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)
2018-02-17 19:28:01 +02:00
Paul Eggert
f74ab96483 ; Spelling and grammar fixes. 2018-02-17 09:17:28 -08:00
Robert Pluim
f21f8e6135 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.
2018-02-17 13:01:19 +02:00
Eli Zaretskii
d8917eba1c 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.
2018-02-17 11:59:36 +02:00
Eli Zaretskii
b228839af1 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)
2018-02-17 11:16:35 +02:00
Eli Zaretskii
ab67b3e44b 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.
2018-02-17 10:28:29 +02:00
Noam Postavsky
593bbdaf0b Document comment-fill-column in the manual (Bug#11636)
* doc/emacs/programs.texi (Comment Commands)
(Options for Comments): Mention comment-fill-column.
2018-02-16 22:13:34 -05:00
Glenn Morris
bd4cc8d564 * doc/emacs/dired.texi (Marks vs Flags): Copyedits. 2018-02-16 17:03:13 -08:00
Glenn Morris
69107f347b ; Fix doc typos related to indefinite articles 2018-02-16 17:33:57 -05:00
Eli Zaretskii
aaad1e62f3 Merge branch 'emacs-26' of git.savannah.gnu.org:/srv/git/emacs into emacs-26 2018-02-16 23:38:32 +02:00
Eli Zaretskii
5906418b5b 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.
2018-02-16 23:37:38 +02:00
Glenn Morris
35e5c57db3 ; Fix doc typos related to indefinite articles 2018-02-16 14:11:51 -05:00
Eli Zaretskii
e9c7ddc64b 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.
2018-02-16 12:46:32 +02:00
Eli Zaretskii
63c93f7ecd 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.
2018-02-16 11:12:50 +02:00
Michael Albinus
42f15b05ba * doc/emacs/programs.texi (Semantic): Order programming languages. 2018-02-16 09:53:30 +01:00
Eli Zaretskii
b46be29424 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.
2018-02-15 20:38:13 +02:00
Eli Zaretskii
874c0edf30 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.
2018-02-14 21:12:49 +02:00
Eli Zaretskii
53511f9147 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.
2018-02-14 21:00:59 +02:00
Michael Albinus
78426b84e8 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.
2018-02-14 09:28:33 +01:00
Paul Eggert
0dca618075 Tramp minor doc fixes
* doc/misc/tramp.texi (Remote processes): Spelling fix and minor
wording improvement.
2018-02-13 14:52:44 -08:00
Eli Zaretskii
333d6f4d99 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.
2018-02-13 19:12:37 +02:00
Michael Albinus
f568c916b6 * doc/misc/tramp.texi: Index more user options. 2018-02-13 08:35:50 +01:00
Eli Zaretskii
92ca881dc8 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.
2018-02-13 07:59:26 +02:00
Noam Postavsky
96b6e243ec 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.
2018-02-12 19:25:09 -05:00
Eli Zaretskii
26f64410fd 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.
2018-02-12 19:52:48 +02:00
Eli Zaretskii
f8a493c800 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)
2018-02-11 19:59:00 +02:00
Eli Zaretskii
10637af91a 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.
2018-02-11 18:19:25 +02:00
Eli Zaretskii
cb2487b173 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.
2018-02-10 19:21:42 +02:00
Eli Zaretskii
66e9527b9a Another minor change in the manual
* doc/emacs/glossary.texi (Glossary): Add popular Latin
abbreviations, such as "e.g.".
2018-02-10 13:23:22 +02:00
Eli Zaretskii
6a1c03d65b 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.
2018-02-10 11:19:43 +02:00