1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-03-13 10:20:59 -07:00
Commit graph

5549 commits

Author SHA1 Message Date
Eli Zaretskii
f2ab09ec60 Fix a typo in indexing the user manual
* doc/emacs/cmdargs.texi (General Variables): Fix a horrible typo.
2017-04-18 19:33:08 +03:00
Eli Zaretskii
a6d50401b4 Document 'line-pixel-height'
* doc/lispref/display.texi (Size of Displayed Text): Document
line-pixel-height.  Suggested by Tak Kunihiro
<tkk@misasa.okayama-u.ac.jp>.  (Bug#26379)
2017-04-11 12:40:37 +03:00
Noam Postavsky
c7ed57eaef Mention that processes start in default-directory (Bug#18515)
* doc/lispref/processes.texi (Synchronous Processes):
(Asynchronous Processes):
* lisp/subr.el (start-process):
* src/callproc.c (call-process): Mention that the subprocess starts in
`default-directory' when local, suggest `start-file-process' and
`process-file' otherwise.
2017-04-06 18:50:54 -04:00
Tino Calancha
3f0d047d2e Delete confuse statement in manual
* doc/misc/cl.texi (For Clauses): Delete confuse statement
and its example (Bug#23550).
2017-03-31 17:17:07 +09:00
Noam Postavsky
ee1bd94dd0 Improve packaging documentation
* doc/lispref/package.texi (Packaging Basics):
* doc/lispref/tips.texi (Library Headers): Clarify some header
formats, relation between file headers and package
attributes (Bug#13281).
2017-03-30 20:46:51 -04:00
Eric Abrahamsen
fb18bff91f Expand manual section on quitting windows
* doc/lispref/windows.texi (Quitting Windows): Provide more
  information about the elements of the quit-restore window parameter,
  and how they affect the behavior of quit-restore-window.
2017-03-26 16:37:01 -07:00
Johan Claesson
afe8849bac * doc/misc/cl.texi (Iteration Clauses): Clarify example (Bug#19515).
Copyright-paperwork-exempt: yes
2017-03-26 09:14:15 -04:00
Eli Zaretskii
ada79442c0 ;* doc/misc/info.texi (Choose menu subtopic): Improve indexing. (Bug#26236) 2017-03-25 10:46:59 +03:00
Eli Zaretskii
d71e071fcc Improve documentation of interactive "r".
* doc/lispref/commands.texi (Interactive Codes): Mention that mark
must be set for "r" to work.
2017-03-17 21:10:17 +02:00
Eli Zaretskii
1925dd9a03 Fix duplicate wording in Emacs manual
* doc/emacs/programs.texi (Which Function): Delete duplicate
wording.  (Bug#26098)
2017-03-14 20:27:08 +02:00
Eli Zaretskii
2d671fda52 Fix wording in Emacs manual
* doc/emacs/text.texi (Paragraphs): Fix a garbled sentence.
(Bug#26086)
2017-03-13 22:31:33 +02:00
Eli Zaretskii
a8766a2888 Document how to customize input methods
* doc/emacs/mule.texi (Input Methods): Document how to customize
input methods.
2017-03-11 17:56:15 +02:00
Eli Zaretskii
a314c1ff05 Clarify documentation of 'raise' and 'height' display specs
* doc/lispref/display.texi (Other Display Specs): Clarify the
effect of 'height' display spec on the following 'raise'.
(Bug#25824)
2017-03-04 17:58:03 +02:00
Tino Calancha
0d5957ec6f Documentation fix in elisp reference manual
* doc/lispref/macros.texi (Defining Macros): Drop redundant mention
on 'declare' forms (Bug#25846).
2017-02-24 10:21:31 +09:00
Eli Zaretskii
2b774fa873 Mention "editor" in Emacs man page header
* doc/man/emacs.1.in: Mention "editor" in the header line.
(Bug#25771, Bug#25779)
2017-02-18 13:32:45 +02:00
Stefan Monnier
5c3105e55b * doc/lispref/modes.texi (Derived Modes): Make example more idiomatic 2017-02-13 02:29:01 -05:00
Eli Zaretskii
4c51ef4e80 Clarify what is the "cursor"
* doc/lispref/windows.texi (Window Point): Clarify the notion of
"cursor".
2017-02-12 17:56:14 +02:00
Eli Zaretskii
38fc456d27 Fix a typo in ada-mode manual
* doc/misc/ada-mode.texi (Project file variables): Add a missing
right bracket.  Reported by Jean-Christophe Helary
<jean.christophe.helary@gmail.com>.
2017-02-07 18:29:02 +02:00
Eli Zaretskii
a541c21e86 Clarify documentation of 'bufferpos-to-filepos' and 'filepos-to-bufferpos'
* doc/lispref/nonascii.texi (Text Representations): Clarify that
'exact' value of QUALITY argument to 'bufferpos-to-filepos' and
'filepos-to-bufferpos' can lead to expensive and slow processing.

* lisp/international/mule-util.el (filepos-to-bufferpos)
(bufferpos-to-filepos): Doc fix.  (Bug#25626)
2017-02-05 21:50:49 +02:00
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