1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-28 07:45:00 +00:00
Commit Graph

5464 Commits

Author SHA1 Message Date
Katsumi Yamaoka
9fc81bcf74 * doc/misc/message.texi (Bcc Warning): Fix markup. 2016-10-03 03:03:40 +00:00
Katsumi Yamaoka
95baa25ff0 * doc/misc/message.texi (Bcc Warning):
Document mml-secure-safe-bcc-list.
2016-10-03 02:43:20 +00:00
Paul Eggert
bbf1ffd7c7 Regexp Functions doc minor fixes
* doc/lispref/searching.texi (Regexp Functions):
Fix misspelling of “matching”.  Use @table for table.
Reformat code example to fit into info file width (Bug#17862).
2016-09-26 17:01:09 -07:00
Eli Zaretskii
9fc9988d4d Improve documentation of 'expand-abbrev' and wrapper hooks
* lisp/simple.el (filter-buffer-substring-functions)
(buffer-substring--filter): Add a link to 'with-wrapper-hook' as
the place to look for documentation of wrapper hooks.
* lisp/minibuffer.el (completion-in-region-functions)
(completion--in-region): Add a link to 'with-wrapper-hook' as the
place to look for documentation of wrapper hooks.
* lisp/abbrev.el (expand-abbrev, abbrev--default-expand): Clarify
the doc strings.  (Bug#24540)

* doc/lispref/text.texi (Buffer Contents): Mention
'with-wrapper-hook's doc string as the place to learn about that
obsolete facility.
2016-09-26 19:02:01 +03:00
Paul Eggert
9135bd7af7 Improve display of tex-verbatim and Info quoted
Problem reported by Glenn Morris (Bug#19889).
* doc/emacs/display.texi (Standard Faces):
* doc/lispref/display.texi (Basic Faces):
* etc/NEWS: Mention fixed-pitch-serif.
* lisp/faces.el (face-font-family-alternatives):
New family alias Monospace Serif.
(fixed-pitch-serif): New face, which uses the new family.
* lisp/info.el (Info-quoted):
* lisp/textmodes/tex-mode.el (tex-verbatim): Use the new face.
* test/lisp/legacy/font-parse-tests.el (font-parse-tests--data):
Add test case for Monospace Serif.

This is backport from master
(cherry picked from commit 36906806cc)
2016-09-23 16:55:52 +03:00
Lars Ingebrigtsen
e0dd65cd44 Document how to check for ImageMagick support
* doc/lispref/display.texi (ImageMagick Images): Say how to
check for ImageMagick support, which isn't quite obvious
(bug#20702).

This is backport from master
(cherry picked from commit faf07d6465)
2016-09-23 16:44:28 +03:00
Eli Zaretskii
0ae9a816b9 Document 'timerp'
* doc/lispref/os.texi (Timers): Document 'timerp'.  (Bug#24511)
Improve indexing.
2016-09-23 11:43:25 +03:00
Eli Zaretskii
2c72c46af1 Improve documentation of overlay priorities
* doc/lispref/display.texi (Overlay Properties): Minor copyedits.
By popular demand, mention the '(PRIMNARY . SECONDARY)' form of
overlay properties used for the region.  (Bug#20253)
2016-09-23 11:27:18 +03:00
Eli Zaretskii
1229cc4ae6 Document that desktop file overrides frame parameters
* doc/emacs/misc.texi (Saving Emacs Sessions):
* doc/emacs/frames.texi (Frame Parameters): Document that frame
parameters restored by desktop.el take precedence over the
customizations in the init file, and explain how to countermand
that.  For the details of the issue, see
http://lists.gnu.org/archive/html/emacs-devel/2016-09/msg00318.html.
2016-09-17 12:20:09 +03:00
Eli Zaretskii
0ad74106fa Update Antinews in ELisp manual
* doc/lispref/anti.texi (Antinews): Update for Emacs 25.1.
* doc/lispref/elisp.texi (Top): Update the main menu entry for
Antinews.
2016-09-14 17:20:24 +03:00
Martin Rudalics
0045998ac6 Fix cross reference in frames.texi
* doc/lispref/frames.texi (Minibuffers and Frames): Fix cross
reference.
2016-09-08 10:56:17 +02:00
immerrr
56bf7d7e27 Fix regexp-opt documentation (bug #17862)
* lisp/emacs-lisp/regexp-opt.el (regexp-opt):
* doc/lispref/searching.texi (Regexp Functions): Update PAREN doc.
2016-09-03 23:50:42 -04:00
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