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

5530 commits

Author SHA1 Message Date
Eli Zaretskii
7e02a477bb Index byte-compile-debug
* doc/lispref/compile.texi (Compilation Functions): Index
byte-compile-debug.
2017-01-31 22:36:02 +02:00
Philipp Stephani
7c1e598a05 Document `byte-compile-debug' in the ELisp manual
* doc/lispref/compile.texi: Document variable `byte-compile-debug'.
2017-01-31 21:10:03 +01:00
Eli Zaretskii
b3139da077 ; Fix last change in doc/lispref/strings.texi
* doc/lispref/strings.texi (Formatting Strings): One more
clarification to the last change.  (Bug#25557)
2017-01-28 11:14:28 +02:00
Eli Zaretskii
c331f393c1 Improve documentation of 'format' conversions
* src/editfns.c (Fformat): More accurate description of %g and
effects of the various flags on it.  More accurate description of
integer conversions.

* doc/lispref/strings.texi (Formatting Strings): More accurate
description of %g and effects of the various flags on it.  More
accurate description of integer conversions.  (Bug#25557)
2017-01-28 10:30:17 +02:00
Vladimir Panteleev
9f52f67a96 Remove stale functions from ert manual
* doc/misc/ert.texi (Useful Techniques when Writing Tests):
Replace ert--mismatch references with its cl-lib replacement,
cl-mismatch.

Copyright-paperwork-exempt: yes
2017-01-27 11:49:42 +02:00
Eli Zaretskii
c416b141dd Fix a typo in Eshell manual
* doc/misc/eshell.texi (History): Fix a typo.  Reported by Mak
Kolybabi <mak@kolybabi.com>.
2017-01-27 11:42:59 +02:00
Eli Zaretskii
954e9e983b Improve documentation of hooks related to saving buffers
* lisp/files.el (write-file-functions, write-contents-functions)
(before-save-hook, after-save-hook): Note that these are only used
by save-buffer.

* doc/lispref/backups.texi (Auto-Saving):
* doc/lispref/files.texi (Saving Buffers): Mention that
save-related hooks are not run by auto-saving.  (Bug#25460)
2017-01-20 10:57:14 +02:00
Eli Zaretskii
9fcab85efd Improve documentation of auto-save-visited-file-name
* doc/emacs/files.texi (Auto Save Files): Mention subtle
differences between saving the buffer and auto-saving with
auto-save-visited-file-name set non-nil.  (Bug#25478)
2017-01-20 10:34:15 +02:00
Eli Zaretskii
42eae54207 Improve documentation of dabbrevs
* doc/emacs/abbrevs.texi (Dynamic Abbrevs): Add a cross reference
to "Dabbrev Customization".
(Dabbrev Customization): More details about the default value of
dabbrev-abbrev-char-regexp and use cases when it might not be good
enough.  (Bug#25432)
2017-01-13 11:12:27 +02:00
Eli Zaretskii
0e35405a92 Improve documentation of coding-systems
* doc/lispref/nonascii.texi (Coding System Basics): Mention
'prefer-utf-8'.  Index it and 'undecided'.
(Encoding and I/O): Fix a typo.
(User-Chosen Coding Systems): Improve the documentation of
ACCEPT-DEFAULT-P argument to select-safe-coding-system.  Document
select-safe-coding-system-function.
(Specifying Coding Systems): Document coding-system-require-warning.
2017-01-10 20:02:37 +02:00
Noam Postavsky
a2a2073933 Clarify major mode switching
* doc/emacs/modes.texi (Major Modes):
* doc/lispref/modes.texi (Modes, Major Modes): Explictly say that each
buffer has exactly one major mode and can't be "turned off", only
switched away from (Bug#25357).
2017-01-07 09:30:00 -05:00
Paul Eggert
2e2a806803 Fix copyright years by hand
These are dates that admin/update-copyright did not update, or
updated incorrectly.
2017-01-01 04:01:41 +00:00
Paul Eggert
5badc81c1c Update copyright year to 2017
Run admin/update-copyright.
2016-12-31 19:42:26 -08:00
Eli Zaretskii
697167b543 ; Improve wording of previous change in variables.texi
* doc/lispref/variables.texi (Default Value): Improve wording of
last change.
2016-12-27 09:10:30 +02:00
Eli Zaretskii
d7973e808d Document 'default-toplevel-value' and 'set-default-toplevel-value'
* doc/lispref/variables.texi (Default Value): Document
'default-toplevel-value' and 'set-default-toplevel-value'.
2016-12-26 19:10:49 +02:00
Philipp Stephani
f69bd7954f Clarify usage of 'ediff-cleanup-hook' (Bug#24675)
* doc/misc/ediff.texi (Hooks): Clarify usage of 'ediff-cleanup-hook'
2016-12-23 19:28:40 +01:00
Philipp Stephani
c04ac8a319 Document that variable binding order is unspecified
* doc/lispref/variables.texi (Local Variables):
* cl.texi (Modify Macros): Document that binding order in 'let' and
'cl-letf' is unspecified.
2016-12-23 17:28:37 +01:00
Eli Zaretskii
4179238fa8 Improve documentation of 'w32-scroll-lock-modifier'
* doc/emacs/msdos.texi (Windows Keyboard): Document how to set up
w32-scroll-lock-modifier so that Scroll Lock toggles the LED.

* src/w32fns.c (syms_of_w32fns) <w32-scroll-lock-modifier>: Doc
fix.  (Bug#25204)
2016-12-19 20:00:09 +02:00
Eli Zaretskii
9adb101353 Document 'describe-fontset'
* doc/emacs/mule.texi (Fontsets): Document 'describe-fontset'.
(Bug#25216)
2016-12-19 19:57:22 +02:00
Michael Albinus
467768f64e Fix Bug#25162
* doc/emacs/files.texi (Reverting): Document
auto-revert-remote-files and auto-revert-verbose.

* lisp/autorevert.el (auto-revert-verbose, auto-revert-mode)
(auto-revert-tail-mode, global-auto-revert-mode): Fix docstring.
2016-12-11 10:50:17 +01:00
Eli Zaretskii
c20035cd2b ; * doc/emacs/programs.texi (Man Page): Fix last change. 2016-12-02 11:14:11 +02:00
Eli Zaretskii
93d8346288 Improve indexing of 'man'
* doc/emacs/programs.texi (Man Page): Index 'man', not
'manual-entry', as the latter is an alias for the former.
Suggested by Hong Xu <hong@topbug.net>.  (Bug#25033)
2016-12-02 11:10:04 +02:00
Martin Rudalics
d31298d8af Fix documentation of `window-combination-resize'
* src/window.c (Vwindow_combination_resize): Fix doc-string.
* doc/lispref/windows.texi (Recombining Windows): Fix
documentation of `window-combination-resize'.
2016-12-01 10:51:11 +01:00
Bogdan Creanga
2086f4c0c6 Typo fixes in elisp manual
* doc/lispref/sequences.texi: Add missing '4' in result (Bug#25047).
* doc/lispref/strings.texi (Text Comparison): Avoid duplicate
definitions of 'string-prefix-p' and 'string-suffix-p'.
* doc/lispref/symbols.texi (Definitions): Pluralize 'definitions'.

Copyright-paperwork-exempt: yes
2016-11-29 19:07:15 +09:00
Eli Zaretskii
5878abf87b Fix 'expand-file-name' during startup on MS-Windows
* src/w32.c (w32_init_file_name_codepage): New function, resets
file_name_codepage and w32_ansi_code_page to undo the values
recorded during dumping.
(codepage_for_filenames): Fix an embarrassing typo.  Ignore the
cached value of file-name encoding if it is nil, i.e. not
initialized yet.  Actually cache the last used file-name encoding
to avoid calling APIs when not necessary.

* src/w32.h (w32_init_file_name_codepage): Add prototype.

* src/w32term.c (syms_of_w32term): Set the value of
w32_unicode_filenames according to the OS version.  This avoids
resetting it during startup, which then causes temacs to run with
the incorrect value.

* src/emacs.c (main): Call w32_init_file_name_codepage early
during the startup.

* src/fileio.c (Fexpand_file_name) [WINDOWSNT]: Update 'newdir'
after converting $HOME to a UTF-8 string, so that 'newdirlim' is
consistent with it.  (Bug#25038)

* lisp/international/mule-cmds.el (set-locale-environment): Set
'default-file-name-coding-system' to the ANSI codepage even in
non-interactive sessions.

* lisp/files.el (directory-abbrev-alist, abbreviated-home-dir):
Doc fix.
(abbreviate-file-name): Decode 'abbreviated-home-dir' if it is a
unibyte string.

* doc/lispref/files.texi (Directory Names): Index
'directory-abbrev-alist'.
2016-11-28 17:43:25 +02:00
Hong Xu
2e361c74ad Minor copyedits of electric-pair-mode
* doc/emacs/programs.texi (Matching): Add index entries.  Fix
typos.  (Bug#25012)

Copyright-paperwork-exempt: yes
2016-11-24 21:22:47 +02:00
Eli Zaretskii
7499ee8d01 ; Minor copyedit in the Emacs manual
* doc/emacs/maintaining.texi (Select Tags Table): Remove text that
is no longer pertinent.  (The "explained above" part was moved to
another place in the manual a long time ago.)
2016-11-24 19:37:38 +02:00
Eli Zaretskii
45b652b627 Fix documentation of 'invocation-directory'
* doc/lispref/os.texi (System Environment): Fix wording of the
description of 'invocation-directory'.  (Bug#24999)
2016-11-24 19:22:21 +02:00
Tino Calancha
3138598dd8 Update format-time-string documentation
* doc/lispref/os.texi (Time Parsing):
Document %F, %g, %G, %u and %V.
2016-11-20 15:35:41 +09:00
Eli Zaretskii
36bafc9cee Improve documentation of functions that accept time values
* doc/lispref/os.texi (Time Calculations): Mention the meaning of
'nil' or a scalar number as the time-value argument.  Add a
cross-reference to 'float-time' for computing a time difference as
a scalar number of seconds.

* src/editfns.c (Fformat_time_string, Ftime_less_p)
(Ftime_subtract, Ftime_add, Fdecode_time, Fcurrent_time_string)
(Fcurrent_time_zone): Mention in the doc strings the meaning of
nil argument and the fact that a time value can be a scalar number
of seconds since the epoch.
(Ftime_subtract): Mention 'float-time'.
2016-11-18 13:02:34 +02:00
Glenn Morris
1fc101b0c4 Don't confuse how Texinfo outputs @var with the input
* doc/emacs/rmail.texi (Movemail):
* doc/lispref/control.texi (Pattern matching case statement):
* doc/lispref/frames.texi (Size and Position):
* doc/lispref/processes.texi (Asynchronous Processes):
* doc/lispref/text.texi (Document Object Model):
* doc/lispref/windows.texi (Coordinates and Windows):
Do not upper-case the argument of @var.
2016-11-15 19:18:28 -05:00
Glenn Morris
91aa5d1923 * doc/lispref/display.texi (Scroll Bars):
* doc/lispref/frames.texi (Size and Position):
* doc/lispref/windows.texi (Window Sizes): Fix arglist typos.
2016-11-15 19:07:36 -05:00
Glenn Morris
f758fcdb12 * doc/emacs/cmdargs.texi (Initial Options): Copyedit for --daemon. 2016-11-15 18:53:25 -05:00
Eli Zaretskii
9ad2ae7757 Fix Outline command names
* doc/emacs/text.texi (Foldout): Use the outline-* names instead
of the obsolete aliases.  (Bug#24890)
2016-11-12 21:40:33 +02:00
Alan Mackenzie
db0b58da1d Correct the statement about programming modes always running prog-mode-hook.
doc/emacs/modes.texi (Major Modes): Amend the statement about programming
modes running prog-mode-hook to say that it applies to many (not all) such
modes, and specifying exactly which modes.
2016-11-10 21:22:05 +00:00
Eli Zaretskii
78aece497c Improve documentation of 'occur'
* doc/emacs/search.texi (Other Repeating Search): Clarify how to
use Occur with search strings from last Isearch.  (Bug#24890)
2016-11-10 18:25:21 +02:00
Eli Zaretskii
8da810f91b Don't refer to obsolete FEATURE-unload-hook
* doc/lispref/tips.texi (Coding Conventions): Refer to
FEATURE-unload-function rather than its obsolete variant
FEATURE-unload-hook.  (Bug#24890)
2016-11-07 19:39:54 +02:00
Eli Zaretskii
4f478ca04b Improve documentation of dabbrevs
* lisp/dabbrev.el (dabbrev-expand): Doc fix.  (Bug#24890)

* doc/emacs/abbrevs.texi (Dynamic Abbrevs): Mention
'dabbrev-check-all-buffers', 'dabbrev-check-other-buffers', and
'dabbrev-ignored-buffer-names' and their purpose.  (Bug#24890)
2016-11-07 19:34:51 +02:00
Eli Zaretskii
3b199f7c77 Improve documentation of some Help commands
* doc/emacs/help.texi (Help Mode): Fix mistake in key sequences.
Mention the 'l' and 'r' keys.
(Misc Help): Mention that 'C-h m' describes key bindings.
(Bug#24890)
2016-11-07 18:57:28 +02:00
Eli Zaretskii
93d3a0e302 Fix documentation of yes-or-no prompts
* doc/emacs/mini.texi (Yes or No Prompts): Fix mistakes in key
sequences.  (Bug#24890)
2016-11-07 18:47:39 +02:00
Eli Zaretskii
af04919fc5 Fix documentation of partial completion style
* doc/emacs/mini.texi (Completion Styles): Fix the description of
the wildcard '*'.  (Bug#24890)
2016-11-07 18:44:17 +02:00
Eli Zaretskii
ed80184d0c Fix documentation of the mode line on emacsclient frames
* doc/emacs/screen.texi (Mode Line): Document the '@' indicator on
emacsclient frames.
2016-11-07 18:23:54 +02:00
Eli Zaretskii
e6be8557d5 Fix description of 'C-z' in User manual
* doc/emacs/entering.texi (Exiting): 'C-z' is bound to
'suspend-frame'.  (Bug#24890)
2016-11-07 18:00:19 +02:00
Eli Zaretskii
16f700702c Improve and clarify documentation of Outline Mode
* doc/emacs/text.texi (Outline Visibility): Use the outline-*
names instead of the obsolete aliases.  (Bug#24890)

* lisp/outline.el (outline-hide-sublevels, outline-hide-other)
(outline-hide-body): Doc fixes.  (Bug#24890)
2016-11-07 17:55:42 +02:00
Paul Eggert
dc152c54f4 Modernize usage of 'macOS' in doc and comments
Apple changed the spelling of its operating system again, to "macOS",
effective with macOS 10.12 Sierra (2016-09-20).  Change Emacs
documentation and comments to match this.  Stick with older OS
spellings ("OS X", "Mac OS X") when talking about older releases where
the older names are more correct.
2016-11-06 00:42:03 -07:00
Noam Postavsky
bb61e50533 * doc/lispref/loading.texi (Autoload): Better link (Bug#24845). 2016-11-05 10:12:03 -04:00
Eli Zaretskii
3ef86fd063 Clarify documentation of face attribute functions
* doc/lispref/display.texi (Attribute Functions): Make sure to
document that an omitted FRAME argument means the same as nil.
(Bug#24879)
2016-11-05 10:54:15 +02:00
Paul Eggert
acae275b27 ; Spelling fixes 2016-11-04 14:50:59 -07:00
Hong Xu
23570fd995 Clarify documentation of 'vc-responsible-backend' wrt symlinks
* lisp/vc/vc.el (vc-responsible-backend): Clarify that symlinks
are not resolved when the VC backend is reported.

* doc/lispref/files.texi (Truenames): Document
'vc-responsible-backend'.  (Bug#23436)
* doc/emacs/maintaining.texi (Version Control Systems): Fix a
typo.
2016-11-04 12:06:00 +02:00
Eli Zaretskii
bdc89eb4a6 Improve documentation of 'font-lock-remove-keywords'
* doc/lispref/modes.texi (Customizing Keywords): Clarify the
'keywords' argument of 'font-lock-remove-keywords'.  Suggested by
Hong Xu <hong@topbug.net>.  (Bug#24830)
2016-11-04 11:16:40 +02:00