1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-29 16:41:45 -08:00
Commit graph

1814 commits

Author SHA1 Message Date
Glenn Morris
b83798031c Doc updates re window-setup-hook
* lisp/startup.el (window-setup-hook): Doc fix.

* doc/lispref/display.texi (Window Systems): Remove window-setup-hook.

* doc/lispref/os.texi (Startup Summary, Init File):
Improve description of window-setup-hook.
(Terminal-Specific): Update window-setup-hook cross-reference.

* doc/lispref/hooks.texi (Standard Hooks):
Update window-setup-hook cross-reference.
2014-06-06 00:19:23 -07:00
Glenn Morris
137dcb47fb Document incompatible overlay priority change
* doc/lispref/display.texi (Overlay Properties): Update re priority. 

* etc/NEWS: Related edit.

Fixes: debbugs:17234
2014-06-05 23:45:16 -07:00
Paul Eggert
136c315e0b Spelling fixes. 2014-06-05 01:14:36 -07:00
Glenn Morris
e1b3f35f93 Some documentation for signing of packages
* doc/emacs/package.texi (Package Menu, Package Installation):
Mention signed packages.

* doc/lispref/package.texi (Package Archives): Mention signing packages.

* lisp/emacs-lisp/package.el (package-check-signature)
(package-unsigned-archives): Doc fixes.

* etc/NEWS: Related edits.
2014-06-04 23:15:44 -07:00
Glenn Morris
e9e341bb4b Doc updates re filter-buffer-substring
* lisp/simple.el (filter-buffer-substring-functions)
(filter-buffer-substring-function, buffer-substring-filters)
(filter-buffer-substring, buffer-substring--filter): Doc fixes.

* doc/lispref/text.texi (Buffer Contents):
Update for filter-buffer-substring changes.

* doc/lispref/hooks.texi: Remove old comment.

* etc/NEWS: Related markup.
2014-05-26 18:53:45 -07:00
Glenn Morris
4a12fa5c2e Doc updates re completion-in-region-function
* lisp/minibuffer.el (completion-in-region-functions, completion-in-region)
(completion--in-region): Doc fixes.

* doc/lispref/hooks.texi: Update comment.
2014-05-26 18:25:57 -07:00
Glenn Morris
e38a5ebe6b Doc updates re abbrev-expand-function
* doc/emacs/abbrevs.texi (Expanding Abbrevs): Update re abbrev-expand-function.

* doc/lispref/abbrevs.texi (Abbrev Expansion): Update for expand-abbrev changes.

* doc/lispref/functions.texi (Advising Functions): Standardize menu case.

* lisp/abbrev.el (abbrev-expand-functions, abbrev-expand-function)
(expand-abbrev, abbrev--default-expand): Doc fixes.
2014-05-26 18:09:45 -07:00
Eli Zaretskii
1e046d37a4 Fix bug #17511 with unclear documentation of line-move-ignore-invisible.
lisp/simple.el (line-move-ignore-invisible): Doc fix.

 doc/lispref/display.texi (Invisible Text): Clarify the description of
 line-move-ignore-invisible.
2014-05-17 11:58:17 +03:00
Stefan Monnier
5d03fb436f * lisp/emacs-lisp/nadvice.el: Support adding a given function multiple times.
(advice--member-p): If name is given, only compare the name.
(advice--remove-function): Don't stop at the first match.
(advice--normalize-place): New function.
(add-function, remove-function): Use it.
(advice--add-function): Pass the name, if any, to
advice--remove-function.
2014-05-10 16:07:01 -04:00
Paul Eggert
76377e4618 * internals.texi (C Dialect): New section.
(C Integer Types): Mention bool_bf.
2014-05-07 13:51:35 -07:00
Glenn Morris
551a89e12d Standardize case of "Front-Cover Texts" in texi file permissions notices.
Ref: http://lists.gnu.org/archive/html/bug-texinfo/2014-05/msg00015.html
2014-05-07 13:34:53 -04:00
Stefan Monnier
2785da249b * doc/lispref/processes.texi (Filter Functions, Sentinels):
Advertise add-function.
2014-04-29 00:14:27 -04:00
Stefan Monnier
4f5fa75591 * lisp/textmodes/rst.el (electric-pair-pairs): Declare.
(rst-mode): Set it.

Fixes: debbugs:17131
2014-04-28 11:04:49 -04:00
Eli Zaretskii
402a211fd3 Minor doc fix for string predicates.
doc/lispref/strings.texi (Text Comparison): Mention
 equal-including-properties for when text properties of the strings
 matter for comparison.
2014-04-24 18:11:04 +03:00
Eli Zaretskii
f982b37104 Minor fixes to the docs.
doc/emacs/buffers.texi (Uniquify): Clarify the default uniquification.
 doc/emacs/indent.texi (Tab Stops): Improve wording.
 doc/emacs/cmdargs.texi (General Variables): Improve docs of
 EMACSLOADPATH.  Index all the environment variables.
 (Misc Variables): Index all the environment variables.

 doc/lispref/text.texi (Registers): Document register-read-with-preview.
 doc/lispref/internals.texi (Building Emacs): Improve indexing.
2014-04-21 17:50:19 +03:00
Stefan Monnier
20fa59a004 * src/buffer.c (Foverlays_at): Add argument `sorted'.
* doc/lispref/display.texi (Overlay Properties): Reword the doc of `priority'.
(Finding Overlays): Document new arg of `overlays-at'.
* lisp/obsolete/lucid.el (extent-at):
* lisp/htmlfontify.el (hfy-overlay-props-at): Use the new `sorted' arg of
overlays-at.
(hfy-fontify-buffer): Remove unused var `orig-ovls'.
* lisp/ps-def.el (ps-generate-postscript-with-faces1): Use the new `sorted'
arg of overlays-at.  Use `invisible-p'.
2014-04-15 09:21:18 -04:00
Glenn Morris
50ea0f87d6 Minor doc updates related to dribble files
* doc/emacs/trouble.texi (Checklist):
* doc/lispref/os.texi (Recording Input): Dribble files may contain passwords.

* lisp/help.el (view-lossage): Doc tweak.

* src/keyboard.c (Fopen_dribble_file): Doc tweak.
2014-04-05 11:33:55 -07:00
Glenn Morris
8a1d24b11e Doc updates for buffer-stale-function now applying to file buffers too
* doc/emacs/arevert-xtra.texi (Supporting additional buffers):
* doc/lispref/backups.texi (Reverting):
Update for buffer-stale-function also applying to file-buffers.

* lisp/autorevert.el (auto-revert-buffers):
* lisp/files.el (buffer-stale--default-function)
(buffer-stale-function, revert-buffer--default): Doc tweaks.

* etc/NEWS: Related edits.
2014-04-03 22:09:35 -04:00
Glenn Morris
0360792967 Doc updates for default values of some -function vars no longer being nil
* doc/emacs/files.texi (Backup Names):
* doc/emacs/arevert-xtra.texi (Supporting additional buffers):
* doc/lispref/backups.texi (Making Backups, Reverting):
Update for default values of some -function vars no longer being nil.

* etc/NEWS: Related edits.
2014-04-03 21:49:28 -04:00
Eli Zaretskii
75b7e407e8 Improve doc of file-symlink-p per bug #17073.
doc/lispref/files.texi (Kinds of Files): Improve documentation of
 file-symlink-p.  Add cross-references.
2014-03-25 18:08:45 +02:00
Barry O'Reilly
37ea8275f7 Undo in region after markers in undo history relocated
* simple.el (primitive-undo): Only process marker adjustments
validated against their corresponding (TEXT . POS).  Issue warning
for lone marker adjustments in undo history.  (Bug#16818)
(undo-make-selective-list): Add marker adjustments to selective
undo list based on whether their corresponding (TEXT . POS) is in
the region.  Remove variable adjusted-markers, which was unused
and only non nil during undo-make-selective-list.
(undo-elt-in-region): Return nil when passed a marker adjustment
and explain in function doc.

Have (MARKER . ADJUSTMENT) undo records always be immediately
after their corresponding (TEXT . POS) record in undo list.
(Bug#16818)
* lisp.h (record-delete): New arg record_markers.
(record_marker_adjustment): No longer needed outside undo.c.
* insdel.c (adjust_markers_for_delete): Move calculation of marker
adjustments to undo.c's record_marker_adjustments.  Note that
fileio.c's decide_coding_unwind is another caller to
adjust_markers_for_delete.  Because it has undo list bound to t,
it does not rely on adjust_markers_for_delete to record marker
adjustments.
(del_range_2): Swap call to record_delete and
adjust_markers_for_delete so as undo marker adjustments are
recorded before current deletion's adjustments, as before.
(adjust_after_replace):
(replace_range): Pass value for new record_markers arg to
delete_record.
* undo.c (record_marker_adjustment): Renamed to
record_marker_adjustments and made static.
(record_delete): Check record_markers arg and call
record_marker_adjustments.
(record_change): Pass value for new record_markers arg to
delete_record.
(record_point): at_boundary calculation no longer needs to account
for marker adjustments.

* undo-tests.el (undo-test-marker-adjustment-nominal):
(undo-test-region-t-marker): New tests of marker adjustments.
(undo-test-marker-adjustment-moved):
(undo-test-region-mark-adjustment): New tests to demonstrate
bug#16818, which fail without the fix.

* markers.texi (Moving Marker Positions): The 2014-03-02 doc
change mentioning undo's inability to handle relocated markers no
longer applies.  See bug#16818.
* text.texi (Undo): Expand documentation of (TEXT . POS) and
(MARKER . ADJUSTMENT) undo elements.
2014-03-24 22:47:39 -04:00
Glenn Morris
4118be693d * lispref/commands.texi (Defining Commands): Tweak previous change. 2014-03-22 14:41:31 -07:00
Glenn Morris
eb6f0d5663 * lispref/commands.texi (Defining Commands): List interactive-only values. 2014-03-22 12:54:48 -07:00
Eli Zaretskii
4568178886 doc/lispref/functions.texi (Core Advising Primitives): Fix cross-reference in last change. 2014-03-22 10:35:03 +02:00
Stefan Monnier
0c0ec04163 * doc/lispref/functions.texi (Advising Functions): Explain a bit more how
arguments work.
(Advice combinators): New node.
(Core Advising Primitives): Use it.  Expand description of "depth".
(Advising Named Functions): Document limitation of advices on macros.
2014-03-21 17:47:52 -04:00
Martin Rudalics
21e18b30e2 Truly maximize w32 frames with odd fonts and some texi fixes.
* w32fns.c (w32_wnd_proc): For WM_WINDOWPOSCHANGING don't
constrain frame size in SW_SHOWMAXIMIZED case so we can truly
maximize a frame for odd default fonts.
* frames.texi (Size and Position): In `frame-resize-pixelwise'
description drop remark about frame maximization.
* windows.texi (Display Action Functions): Add description for
`display-buffer-no-window' and explain use of `allow-no-window'
alist entries.
2014-03-21 10:23:22 +01:00
Glenn Morris
9ee59bca7a * lispref/commands.texi (Defining Commands): Copyedit re `interactive-only'. 2014-03-21 00:06:55 -07:00
Paul Eggert
a2326811fc Backport doc fix from trunk.
* internals.texi (C Integer Types): Prefer 'false' and 'true'
to '0' and '1' for booleans.
2014-03-20 16:15:19 -07:00
Paul Eggert
c7dff2f665 * numbers.texi: Improve and clarify a bit, and fix some minor bugs.
Remove now-obsolete hypothetical note about negative division,
as the C standard has changed.
2014-03-19 14:21:01 -07:00
Paul Eggert
37ca907722 Fix porting inconsistency about rounding to even.
* doc/lispref/numbers.texi (Numeric Conversions, Rounding Operations):
Document that 'round' and 'fround' round to even.
* src/floatfns.c (emacs_rint) [!HAVE_RINT]: Round to even.
This way, the unusual !HAVE_RINT case acts like the usual
HAVE_RINT case, and we can fix the documentation accordingly.
2014-03-19 14:09:08 -07:00
Juanma Barranquero
6b88e570d8 Recommend not modifying :set's value arg in defcustom (bug#16755).
* doc/lispref/customize.texi (Variable Definitions):
* lisp/custom.el (defcustom): Recommend avoiding
  destructive modification of the value argument of :set.
2014-03-19 00:31:17 +01:00
Stefan Monnier
5fb6db0d69 * doc/lispref/modes.texi (Auto-Indentation): Mention electric-indent variables.
* doc/misc/cc-mode.texi (Indentation Commands): Remove C-j, since it's not
defined by CC-mode but globally.
(FAQ): Tweak text about RET and auto-indentation.
* doc/misc/vip.texi (Other Vi Commands): Adjust doc of C-j.
2014-03-18 17:14:36 -04:00
Juanma Barranquero
28a5172030 doc/lispref/functions.texi (Advising Named Functions): Fix reference. 2014-03-18 12:29:33 +01:00
Paul Eggert
1917cf46bb Improve documentation for integer and floating-point basics.
* numbers.texi (Numbers, Integer Basics, Float Basics):
Document the basics a bit more precisely.  Say more clearly
that Emacs floating-point numbers are IEEE doubles on all
current platforms.  Give more details about frexp.
Say more clearly that '1.' is an integer.
(Predicates on Numbers): Fix wholenump typo.
* objects.texi (Integer Type): Adjust to match numbers.texi.
2014-03-17 21:03:59 -07:00
Juanma Barranquero
53e84c5f28 doc/lispref/ChangeLog: Trivial fixes. 2014-03-18 04:22:59 +01:00
Stefan Monnier
6c187ef5a5 * doc/lispref/functions.texi (Advising Functions): Try and improve the text.
Add example use of advice-add.
(Core Advising Primitives): Rename.  Explain handling of interactive
specs, including advice-eval-interactive-spec.
(Advising Named Functions): Try and better explain the difference with
add-function.
(Porting old advices): New node.

Fixes: debbugs:16959
2014-03-17 21:51:12 -04:00
Paul Eggert
09b73f0820 Style fixes for floating-point doc.
* commands.texi, customize.texi, display.texi, elisp.texi, files.texi:
* frames.texi, hash.texi, internals.texi, keymaps.texi, lists.texi:
* minibuf.texi, nonascii.texi, numbers.texi, objects.texi, os.texi:
* processes.texi, streams.texi, strings.texi, text.texi:
* variables.texi, windows.texi:
Hyphenate "floating-point" iff it precedes a noun.
Reword to avoid nouns and hyphenation when that's easy.
Prefer "integer" to "integer number" and "is floating point"
to "is a floating point number".
Prefer "@minus{}" to "-" when it's a minus.
2014-03-17 18:19:03 -07:00
Martin Rudalics
b92631bf71 Fix behavior of with-temp-buffer-window (Bug#16816, Bug#17007).
* window.el (with-temp-buffer-window): Don't make BUFFER-OR-NAME
current (Bug#16816, Bug#17007).
(with-current-buffer-window): New macro doing the same as
`with-temp-buffer-window' but with BUFFER-OR-NAME current.
* help.el (help-print-return-message): Warn in doc-string to not
use this in `with-help-window'.
(describe-bindings-internal): Call `describe-buffer-bindings'
from within help buffer.  See Juanma's scenario in (Bug#16816).
(with-help-window): Update doc-string.
* dired.el (dired-mark-pop-up):
* files.el (save-buffers-kill-emacs):
* register.el (register-preview): Use `with-current-buffer-window'
instead of `with-temp-buffer-window'.
* display.texi (Temporary Displays): Rewrite descriptions of
`with-output-to-temp-buffer' and `with-temp-buffer-window'.
* help.texi (Help Functions): Rewrite description of
`with-help-window'.
2014-03-16 10:26:58 +01:00
Dmitry Gutov
480d4f5784 Update `blink-matching-paren' in the manual
* doc/emacs/programs.texi (Matching): Update WRT to the new
`blink-matchin-paren' behavior.

* doc/lispref/display.texi (Blinking): Update WRT to the new
`blink-matchin-paren' behavior.
2014-03-15 05:07:06 +02:00
Martin Rudalics
cfd5e825ae Document pixelwise frame resizing and fix related bug on Windows.
* w32term.c (x_set_window_size): When frame-resize-pixelwise is
nil, always resize character wise to avoid potential loss of the
mode line (Bug#16923 related).
* display.texi (Temporary Displays): Say that
with-temp-buffer-window makes its buffer current.
* frames.texi (Size and Position): Describe new option
`frame-resize-pixelwise'.  Rewrite descriptions of
`set-frame-size', `set-frame-height' and `set-frame-width'.
2014-03-14 11:38:46 +01:00
Juanma Barranquero
6ecdd988b1 doc/lispref/ChangeLog: Add bug reference. 2014-03-10 18:33:52 +01:00
Juanma Barranquero
8cf07e5a55 etc/ChangeLog: Add missing bug reference.
doc/emacs/ChangeLog, doc/lispref/ChangeLog, lisp/ChangeLog*: Fix typos.
2014-03-10 00:55:11 +01:00
Martin Rudalics
7e940b6546 Update docs for window dividers and `window-text-pixel-size'.
* xdisp.c (Fwindow_text_pixel_size): Adjust doc-string.
* elisp.texi (Top): Rename section "Width" to "Size of Displayed
Text".
* text.texi (Primitive Indent):
* strings.texi (String Basics):
* sequences.texi (Sequence Functions): Update references
accordingly.
* display.texi (Size of Displayed Text): Rename section from
"Width".  Add description for `window-text-pixel-size'.
(Window Dividers): Reword description of window dividers.
* frames.texi (Layout Parameters): Improve description of window
divider parameters.
* windows.texi (Window Sizes): Add descriptions of
`window-mode-line-height' and `window-header-line-height'.
(Coordinates and Windows): Mention window dividers.
2014-03-09 12:36:51 +01:00
Paul Eggert
1920914a09 Spelling and wording fixes. 2014-03-07 11:12:31 -08:00
Martin Rudalics
2c6053e838 Update docs for select-window and buffer-list-update-hook.
* buffer.c (Vbuffer_list_update_hook): Doc-string fix.
* window.c (Fselect_window): Explain NORECORD and
`buffer-list-update-hook' in doc-string.
* buffers.texi (The Buffer List): Rename node to Buffer List.
Describe `buffer-list-update-hook'.
* elisp.texi (Top): "The Buffer List" renamed to "Buffer List".
Add node for Window Dividers.
* hooks.texi (Standard Hooks): Add reference to
`buffer-list-update-hook'.
* windows.texi (Selecting Windows): Update description of
`select-window'.
2014-03-07 16:11:12 +01:00
Martin Rudalics
f2c5082b93 Add/update elisp texinfo for window-min-size and split-window.
* windows.texi (Window Sizes): Describe `window-min-size'.
(Splitting Windows): Update description of `split-window'.
2014-03-07 10:53:23 +01:00
Martin Rudalics
cac0a1d67e More window code related fixes and documentation changes.
* window.c (Fother_window_for_scrolling): Check that
Vother_window_scroll_buffer is a buffer.
* window.el (fit-frame-to-buffer, fit-frame-to-buffer-margins):
Fix doc-strings.
(fit-frame-to-buffer): New argument ONLY.  Remove dependency on
fit-frame-to-buffer variable.  Fix doc-string.
(fit-window-to-buffer): Set ONLY argument in call of
fit-frame-to-buffer.  Fix doc-string.
* frames.texi (Size and Position): Rewrite entries for
`fit-frame-to-buffer' and `fit-frame-to-buffer-margins'.  Add
description for `fit-frame-to-buffer-sizes'.
* windows.texi (Resizing Windows): Add descriptions for
pixelwise resizing.  Add entries for `window-resize-pixelwise'
and `fit-window-to-buffer-horizontally'.  Rewrite
`fit-window-to-buffer' entry.
2014-03-06 14:41:58 +01:00
Xue Fuqiao
7c45220b03 Doc fix.
* doc/lispref/internals.texi (Window Internals): Remove field
  `region_showing'.
2014-03-06 20:39:47 +08:00
Xue Fuqiao
37b2bf43a9 Comment 2014-03-06 18:53:26 +08:00
Glenn Morris
222426f694 * doc/lispref/searching.texi (Replacing Match): Remove incorrect return value
Fixes: debbugs:16942
2014-03-05 21:10:33 -05:00