1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-04 11:00:45 -08:00
Commit graph

5437 commits

Author SHA1 Message Date
Noam Postavsky
9ba51edf62 Document buffer-swap-text+save-excursion interaction
* doc/lispref/buffers.texi (Swapping Text):
* src/buffer.c (Fbuffer_swap_text): Add warning about interaction of
`buffer-swap-text' and `save-excursion' (Bug #4655).
2016-07-14 20:01:39 -04:00
Paul Eggert
90f21696fe ; Spelling fixes 2016-07-13 12:23:54 +02:00
Stephen Berman
069fc05bd5 Improve documentation of search functions
Make the documentation of the search functions more accurate,
complete, and uniform; in particular, extend the description of
the effect when the 'count' parameter is a negative number to all
of these functions.

* src/search.c (Fsearch_backward, Fsearch_forward)
(Fre_search_backward, Fre_search_forward)
(Fposix_search_backward, Fposix_search_forward):
* lisp/isearch.el (word-search-backward, word-search-forward)
(word-search-backward-lax, word-search-forward-lax): Improve doc
strings as described above.

* doc/lispref/searching.texi (String Search, Regexp Search)
(POSIX Regexps): Use 'count' instead of 'repeat' as the name of
the fourth parameter of the *-search-{forward,backward} functions
and improve documentation as described above.
2016-07-12 22:11:22 +02:00
Eli Zaretskii
f6246717d1 Add "New in Emacs 25" section to the FAQ
* doc/misc/efaq.texi (Latest version of Emacs): Update for later
versions.
(New in Emacs 25): New node.
(Status of Emacs): Add it to the menu.
2016-07-12 09:30:55 +03:00
Eli Zaretskii
4069b716ad Update ELisp manual to match 'string-collate-equalp' doc string
* doc/lispref/strings.texi (Text Comparison): Remove reference to
sorting from the description of 'string-collate-equalp'.  (Bug#23902)
2016-07-10 17:34:34 +03:00
Noam Postavsky
178b2f5909 Note combine-and-quote-strings doesn't shell quote
* doc/lispref/processes.texi (Shell Arguments):
* lisp/subr.el (combine-and-quote-strings): Add a note that
combine-and-quote-strings doesn't protect arguments against shell
evaluation (Bug #20333).
2016-07-03 15:05:20 -04:00
Noam Postavsky
dec7567560 Explain when package-initialize isn't called
* doc/lispref/os.texi (Startup Summary): Explain that package-initialize
is not called when options -q, -Q, or --batch were passed (Bug #19151).
2016-07-03 09:19:23 -04:00
Eli Zaretskii
38f4b8ea61 Clarify the documentation of back-references in replacements
* doc/emacs/search.texi (Regexp Replace): Clarify that \D starts
with \1, not \0.

* lisp/replace.el (query-replace-regexp)
(query-replace-regexp-eval, replace-regexp): Doc fix (Bug#23884)
2016-07-02 18:03:09 +03:00
Noam Postavsky
850ba444a7 Clarify lexical binding with symbol args behavior
* doc/lispref/variables.texi (Lexical Binding): Clarify that symbol
arguments always refer to dynamic values (Bug #23781).  Remove mention
of obsolete restriction regarding lexical binding for defun and
defmacro, this no longer applies since 61b108cc 2012-05-29 "*
lisp/emacs-lisp/byte-run.el (defmacro, defun): Move from C...".
2016-07-01 00:02:48 -04:00
Noam Postavsky
6192b6c3a4 Document more details of package activation
* doc/emacs/package.texi (Package Installation): Explain that package
activation adds to load-path (Bug #21704).
2016-06-27 23:02:52 -04:00
Noam Postavsky
f2536958ec Update docs for `customize-mode'
* lisp/cus-edit.el (customize-mode): This function works with both major
and minor modes, make docstring and prompt reflect that (Bug #23649).

* doc/lispref/modes.texi (Derived Modes): Remove note about
customize-mode being experimental; it has been around since Emacs
22 (Bug #11299).

Co-authored-by: Drew Adams <drew.adams@oracle.com>
2016-06-25 13:12:11 -04:00
Eli Zaretskii
4395aaacd4 Fix documentation of 'assoc-string' and 'compare-strings'
* src/minibuf.c (Fassoc_string): Clarify how CASE-FOLD affects the
string comparison.  (Bug#23833)
* src/fns.c (Fcompare_strings): Fix the description of how
IGNORE-CASE affects the comparison.

* doc/lispref/strings.texi (Text Comparison): Clarify how
CASE-FOLD affects the string comparison in 'assoc-string'.  Fix
the description of how IGNORE-CASE affects the comparison in
'compare-strings'.
2016-06-23 18:09:14 +03:00
Eli Zaretskii
4793f5fc41 Clarify documentation of 'line-spacing' and 'line-height'
* doc/lispref/display.texi (Line Height): Clarify how the line
height is determined via variables and text properties.  (Bug#23806)
2016-06-21 17:20:09 +03:00
Noam Postavsky
d1efbafdf2 Fix documentation of completion functions
So that the described behavior matches the code (and docstrings).

* doc/lispref/minibuf.texi (Basic Completion): Symbol keys of hash table
collections are used like string keys, not ignored (Bug #10416).
2016-06-18 14:59:23 -04:00
Eli Zaretskii
65c96cc025 Clarify documentation of 'font-lock-maximum-decoration'
* doc/emacs/display.texi (Font Lock): Explain how to make the
customization of 'font-lock-maximum-decoration' effective for an
existing buffer.  (Bug#23783)
2016-06-18 12:50:57 +03:00
Glenn Morris
2ad3d0182d * doc/misc/cl.texi (Usage): Add some more details. 2016-06-17 12:55:06 -04:00
Stephen Berman
d308aa1eee Minor grammar fix (bug#23746)
* doc/lispref/processes.texi (Synchronous Processes):
Another minor grammar fix (bug#23746).
2016-06-13 18:20:43 +02:00
Stephen Berman
20de6679b0 Doc fixes for grammar and typos (bug#23746)
* doc/emacs/files.texi (Customize Save):
* doc/emacs/frames.texi (Window Dividers):
* doc/emacs/misc.texi (Printing):
* doc/lispref/compile.texi (Compiler Errors):
* doc/lispref/keymaps.texi (Changing Key Bindings):
* doc/lispref/loading.texi (Named Features):
* doc/lispref/markers.texi (Marker Insertion Types):
* doc/lispref/modes.texi (Mode Hooks):
* doc/lispref/text.texi (Undo):
* src/floatfns.c (Fldexp):
* src/xfaces.c (syms_of_xfaces):
Minor doc fixes for grammar and typos (bug#23746).
2016-06-13 18:08:22 +02:00
Eli Zaretskii
a67a4e598d * doc/lispref/processes.texi (Process Buffers): Minor rewording. (Bug#23446) 2016-06-13 18:00:34 +03:00
Eli Zaretskii
27f440e295 Add cross-reference to ELisp manual
* doc/lispref/commands.texi (Classifying Events): Add
cross-reference to "Motion Events".  (Bug#23756)
2016-06-13 17:25:08 +03:00
Glenn Morris
1f85b7ca03 Doc fixes re alist-get. (Bug#23548)
* lisp/subr.el (alist-get): Doc fix.
* doc/lispref/lists.texi (Association Lists): Improve alist-get.
; * etc/NEWS: Related edit.
2016-06-07 19:59:37 -04:00
Tino Calancha
601b9b2acd * doc/misc/cl.texi (Mapping over Sequences): Fix cl-notevery. 2016-06-07 13:46:33 -04:00
Glenn Morris
a7a22442a4 * doc/misc/smtpmail.texi (Encryption): Fix 2012-12-22 typo. 2016-05-31 14:58:05 -04:00
Bill Wohler
50caae30b0 Release MH-E manual version 8.6
* doc/misc/mh-e.texi (VERSION, EDITION, UPDATED, UPDATE-MONTH):
Update for release 8.6.
2016-05-30 16:15:32 -07:00
Mike Kupfer
602bb40029 Update MH-E's documentation about HTML renderers
* doc/misc/mh-e.texi (HTML): Remove the footnote with the minimum Gnus
version (we are no longer trying to support multiple Emacs
releases). Sort the table of HTML renderers by name (the previous
ordering was based on a 10-year-old survey). Add shr and gnus-w3m to
the table. Remove the entry for w3 (no longer available).  Update
existing entries so that they are more consistent about what features
are discussed, and to reflect recent testing (Debian 8). Small tweaks
to existing text.
2016-05-30 16:13:10 -07:00
Dmitry Gutov
89018f003a Fx the we->the typo
* doc/emacs/trouble.texi (Sending Patches):
Fix the typo (bug#23657).
2016-05-30 17:51:41 +03:00
Paul Eggert
42275df3df * doc/misc/texinfo.tex: Revert previous change (Bug#23611). 2016-05-25 10:39:34 -07:00
Glenn Morris
4efb3e8169 * doc/emacs/files.texi (Comparing Files):
* doc/emacs/trouble.texi (Sending Patches): Fix external xrefs.
2016-05-24 14:58:27 -04:00
Glenn Morris
b995d1edf4 * doc/misc/eww.texi (Advanced): Fix xref. 2016-05-24 14:37:54 -04:00
Eli Zaretskii
2e589c0042 Fix cross-references between manuals
* doc/misc/viper.texi (Viper Specials):
* doc/misc/url.texi (Tramp):
* doc/misc/sem-user.texi (Smart Jump):
* doc/lispintro/emacs-lisp-intro.texi (Finding More):
* doc/misc/efaq.texi (Replacing text across multiple files): Fix
cross-references between manuals.  (Bug#23612)
* doc/lispintro/emacs-lisp-intro.texi (etags): Node deleted: no
longer relevant to Emacs Lisp programming.
2016-05-24 21:24:45 +03:00
Glenn Morris
f3d2dedeba * doc/misc/vhdl-mode.texi (Sample Init File): Rename node to avoid ".". 2016-05-24 13:26:04 -04:00
Eli Zaretskii
c45d9f61f7 Improve documentation of 'server-name'
* doc/emacs/misc.texi (Emacs Server): Fix example of setting
'server-name'.  Mention how to do that with daemon sessions.
(Bug#23576)
2016-05-18 22:50:45 +03:00
Juri Linkov
1fe1e0a8e7 * lisp/char-fold.el: Rename from character-fold.el.
* lisp/replace.el (replace-char-fold): Rename from replace-character-fold.
* test/automated/char-fold-tests.el: Rename from character-fold-tests.el.
http://lists.gnu.org/archive/html/emacs-devel/2015-12/msg00529.html
2016-05-17 23:55:38 +03:00
Paul Eggert
9c2a1a264c * doc/misc/texinfo.tex: Sync from gnulib. 2016-05-13 07:41:47 -07:00
Paul Eggert
b479deadf4 * doc/misc/emacs-mime.texi (time-date): Document now-builtins better. 2016-05-08 11:50:19 -07:00
Eli Zaretskii
4ffec91aa1 Document automatic adjustment of process' logical window dimensions
* doc/lispref/processes.texi (Process Buffers): Document
'set-process-window-size' and
'window-adjust-process-window-size-function'.

* etc/NEWS: Mention the new functionality and variable.

* src/process.c (Fset_process_window_size): Improve the doc string.
2016-05-07 12:16:27 +03:00
Paul Eggert
50650cb688 Doc fixes for fclist and grep
A newline is needed between two fc-list calls.
egrep and fgrep have been withdrawn from POSIX,
so document grep -E and grep -F instead.
2016-05-05 12:50:01 -07:00
Paul Eggert
5e814e02f0 Minor doc fixes for quoting
* doc/lispref/control.texi (Signaling Errors):
* doc/lispref/display.texi (Displaying Messages):
Don’t say that formats “generate”.  Try to word more clearly.
* etc/NEWS: Coalesce near-duplicate entries.
2016-05-05 06:40:12 -07:00
Dmitry Gutov
6428aa044a Use grep-find-ignored-directories instead of vc-directory-exclusion-list
* lisp/dired-aux.el (dired-do-find-regexp):
Use grep-find-ignored-directories instead of
vc-directory-exclusion-list.  The result should be functionally
similar (the former uses the latter as the default value), but it
should be more consistent and appropriate WRT user
customizations.
(dired-do-find-regexp-and-replace): Update the docstring.

* lisp/dired.el: Update the corresponding autoloads.

* doc/emacs/dired.texi (Operating on Files): Update the
documentation accordingly.
2016-05-04 01:02:43 +03:00
Lars Ingebrigtsen
93703c547a (Common Keywords): Correct what missing :group means
* doc/lispref/customize.texi (Common Keywords): Correct what
missing :group means.
2016-05-03 19:06:36 +02:00
Eli Zaretskii
79e58003aa Improve documentation of Dired's 'A' and 'Q' commands
* lisp/dired-aux.el (dired-do-find-regexp)
(dired-do-find-regexp-and-replace): Mention
'grep-find-ignored-files' and 'vc-directory-exclusion-list', and
also the fact that REGEXP should be palatable by Grep.  (Bug#23426)
* lisp/dired.el: Update the corresponding autoload forms.

* doc/emacs/dired.texi (Operating on Files): Mention
'grep-find-ignored-files' and 'vc-directory-exclusion-list'.
(Bug#23429)
2016-05-03 19:14:31 +03:00
Paul Eggert
2ea2a2f1a5 Doc fixes for quoting
* doc/emacs/text.texi, doc/lispintro/emacs-lisp-intro.texi:
* doc/lispref/control.texi, doc/lispref/display.texi:
* doc/lispref/help.texi, doc/lispref/strings.texi, lisp/subr.el:
* src/callint.c, src/doprnt.c, src/editfns.c:
Document quoting a bit more systematically.
Problem reported by Alan Mackenzie (Bug#23425).
2016-05-03 08:03:04 -07:00
Lars Ingebrigtsen
805204f3ef Mention what a missing :group does
* doc/lispref/customize.texi (Common Keywords): Document that
a missing :group reuses the group from the preceding item (bug#21601).
2016-05-03 00:03:20 +02:00
Paul Eggert
03750c0035 * doc/misc/texinfo.tex: Sync from gnulib. 2016-05-01 17:59:04 -07:00
Michael Albinus
8aa41477ba tramp.texi: Revert last change due to backward compatibility
(cherry picked from commit 910f9a0a93)
2016-05-01 19:27:17 +02:00
Lars Ingebrigtsen
6b39501612 Mention with-silent-modifications in the lispref manual
* doc/lispref/text.texi (Changing Properties): Document
with-silent-modifications (bug#21171).

(cherry picked from commit fcd0d854ee)
2016-05-01 19:27:16 +02:00
Lars Ingebrigtsen
7b7b4c2101 Document mode mode line variables
* doc/lispref/modes.texi (Mode Line Variables): Document
`mode-line-front-space, `mode-line-misc-info',
`mode-line-end-spaces' (bug#21014).

(cherry picked from commit bf7a630b0a)
2016-05-01 19:27:15 +02:00
Lars Ingebrigtsen
7907b82297 Add a cross ref to Optional Mode Line
* doc/lispref/modes.texi (Mode Line Variables): Add a cross
reference to the Emacs mode line node that explains things
like `display-time-string' (bug#21002).

(cherry picked from commit a3151a2878)
2016-05-01 19:27:15 +02:00
Lars Ingebrigtsen
818fb69bd2 Extremely minor doc fix in Choosing Window
* doc/lispref/windows.texi (Choosing Window): There's only one
action alist, I think (bug#20158).

(cherry picked from commit 6c7e7f421d)
2016-05-01 19:27:14 +02:00
Lars Ingebrigtsen
2abc85e41e Transform mentions of eval-after-load' to with-eval-after-load'
* doc/lispref/loading.texi (Hooks for Loading): Update text to
not mention `eval-after-load' (bug#20038).

(cherry picked from commit 9392193be5)
2016-05-01 19:27:14 +02:00