1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-24 13:32:41 -08:00
Commit graph

5452 commits

Author SHA1 Message Date
Eli Zaretskii
80a7f8be7b Clarify documentation of precision in format specs
* doc/lispref/strings.texi (Formatting Strings): Be less
definitive wrt what precision means in format specs other than
floating-point, %s and %S.  (Bug#24314)
2016-08-26 22:13:34 +03:00
Eli Zaretskii
88a5052579 Improve and clarify documentation of subprocesses
* doc/lispref/processes.texi (Subprocess Creation, Shell Arguments):
Mention 'make-process' rather than 'start-process'.  Update wrt
standard destinations of standard output/error streams and due to
different formats of arguments accepted by 'make-process'.
(Processes): Mention process objects that represent connections.
(Synchronous Processes): Minor clarifications.
(Asynchronous Processes): Describe 'make-process' and
'make-pipe-process' before 'start-process'.  Update and expand the
documentation.
(Deleting Processes, Process Information, Input to Processes)
(Signals to Processes, Query Before Exit, Network): Update and
expand the documentation, especially wrt process objects that
represent connections.
(Output from Processes): Mention the possibility of separating
stderr via 'make-process'.
(Filter Functions): Mention that stderr by default arrives at the
filter function together with stdout.  (Bug#24287)

* src/process.c (Fprocess_id, Fprocess_command)
(Fprocess_contact, Fprocess_type, Fstop_process): Doc fixes for
process objects that represent connections.
2016-08-24 17:36:28 +03:00
Glenn Morris
66dea652ef ; * doc/lispref/windows.texi (Window Parameters): Grammar tweaks.
* etc/NEWS: Likewise.
2016-08-16 08:40:02 -07:00
Martin Rudalics
0cee66c3f1 Facultatively ignore margins when splitting and resizing windows (Bug#24193)
Provide a new window parameter 'min-margins' which allows to
ignore the actual widths of a window's margins when splitting or
resizing that window horizontally.  This should serve as a
workaround for handling the problems raised by Bug#24193.

* lisp/window.el (window--min-size-1): Handle new window
parameter 'min-margins'.
(split-window): Fix text of error messages.
* doc/lispref/windows.texi (Window Parameters): Describe new
parameter 'min-margins'.
2016-08-16 09:19:18 +02:00
Noam Postavsky
8342e7481a Document char-script-table's effect on word motion
* doc/lispref/positions.texi (Word Motion): Talk about
char-script-table (Bug #10494).
2016-08-13 10:10:57 -04:00
Eli Zaretskii
98b01dd1ef Clarify when 'cursor' property is in effect
* doc/lispref/text.texi (Special Properties): Minor copyedits.
(Bug#24179)
2016-08-11 23:01:53 +03:00
Eli Zaretskii
ccd0e92ecc * doc/lispref/text.texi (Change Hooks): Minor copyedits. 2016-08-10 20:12:55 +03:00
Eli Zaretskii
f785ff45d5 Clarify documentation of before/after-change-functions
* doc/lispref/text.texi (Change Hooks): Clarify that the hooks are
not called in balanced pairs.
2016-08-09 19:52:50 +03:00
Noam Postavsky
3c9cb57c6f Document use of vectors in keymaps
* doc/lispref/keymaps.texi (Format of Keymaps): Mention vector
format (Bug #14797).
2016-08-06 15:46:18 -04:00
John Wiegley
cd1b4d60ce Revert "Fix ses-delete-blanks to delete only blanks + documentation."
This reverts commit 3c97b0f758.
2016-08-02 11:43:07 -07:00
John Wiegley
f7ceb8e028 Revert "Fix English."
This reverts commit b275cc76f0.
2016-08-02 11:43:05 -07:00
Vincent Belaïche
b275cc76f0 Fix English.
* doc/misc/ses.texi (Nonrelocatable references): Fix grammatically
  incorrect English.
2016-07-29 13:47:57 +02:00
Vincent Belaïche
3c97b0f758 Fix ses-delete-blanks to delete only blanks + documentation.
* doc/misc/ses.texi (Quick Tutorial): Mention the '!'
'ses-range' modifier as an alternative to 'ses+'.
(Advanced Features): Add a refernce to node 'Nonrelocatable
references' concerning function 'ses-rename-cell'.
(Standard formula functions): Mention the '!' 'ses-range'
modifier as an alternative to 'ses-delete-blanks'.
(More on cell printing): Fix fallback printer
definition.  Minor editorial formatting changes.
(Nonrelocatable references): Document the use of
'ses-rename-cell' as a better way to make cell reference
non-relocatable.
(The data area): Document the presence of local printer
definitions in the data area.

* lisp/ses.el (ses-delete-blanks): Do not remove
*error*.  Any error in an argument should propagate into the
using formula rather than being silently hidden !
2016-07-29 13:44:14 +02:00
Noam Postavsky
272391f1d6 profiler: document prefix arg for tree expansion
* doc/lispref/debugging.texi (Profiling):
* lisp/profiler.el (profiler-report-toggle-entry): Document use of
prefix argument to expand whole call trees.
2016-07-28 20:02:42 -04:00
Noam Postavsky
b443c3c748 Fix comment in files-in-below-directory
* doc/lispintro/emacs-lisp-intro.texi (Files List): Comment should not
say append, since the code is adding to front of list (Bug #21589).
2016-07-28 19:53:58 -04:00
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