1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-05 19:31:02 -08:00
Commit graph

4437 commits

Author SHA1 Message Date
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
Paul Eggert
cefcfbcc1b Merge from gnulib.
This incorporates:
2014-03-26 strftime: wrap macros in "do {...} while(0)"
* lib/strftime.c, doc/misc/texinfo.tex: Update from gnulib.
2014-03-25 21:16:13 -07: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
Michael Albinus
39e98ed4ff * tramp.texi (Frequently Asked Questions): Add fish shell settings. 2014-03-24 09:09:42 +01: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
Glenn Morris
f167458b5e Tiny doc/misc edits
* doc/misc/ede.texi (ede-linux):
* doc/misc/vip.texi (New Bindings): Tiny copyedits.
2014-03-21 00:00:21 -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
Stefan Monnier
494ec1e71d * lisp/electric.el (electric-newline-and-maybe-indent): New command.
Bind it globally to C-j.
(electric-indent-mode): Don't mess with the global map any more.
Don't drop the post-self-insert-hook is some buffer is still using it.
* lisp/bindings.el (global-map): Remove C-j binding.

Fixes: debbugs:16770
2014-03-20 13:14:45 -04: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
David Engster
f6985e8156 Document new EDE features.
* ede.texi (ede-cpp-root): Document the :compile-command slot.
(ede-linux): Document new variables
`project-linux-build-directory-default' and
`project-linux-architecture-default'.
2014-03-18 22:12:42 +01:00
Juanma Barranquero
28a5172030 doc/lispref/functions.texi (Advising Named Functions): Fix reference. 2014-03-18 12:29:33 +01:00
David Engster
636fd6bc0e ede.texi: Remove documentation for features only in CEDET upstream.
* ede.texi (Project Local Variables): Remove reference to
`ede-java-root' and the example using it.
(Android projects, ede-java-root): Remove nodes since they are
only in CEDET upstream (Bug#17030).  All nodes updated.
2014-03-18 08:13:51 +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
7ea9a62b8e Update the missed spot
* doc/emacs/programs.texi (Matching): Update the missed spot.

Fixes: debbugs:17008
2014-03-16 04:42:15 +02:00
Dmitry Gutov
8ee5ffe5d6 * programs.texi (Matching): Use slightly more detailed description. 2014-03-16 01:53:22 +02: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
Paul Eggert
acc112c7a7 * mule.texi (International, Language Environments): Update
the list of language environments to what Emacs currently
supports.  Add the full list to the index.  Suggest C-h L for
details rather than trying to give very brief details here.
2014-03-12 22:27:28 -07:00
Glenn Morris
46e3f6b506 * doc/emacs/cmdargs.texi (General Variables): Don't mention INCPATH,
from the obsolete complete.el.
2014-03-12 17:00:36 -04:00
Glenn Morris
e51f0cb2a1 * doc/misc/eww.texi (History and Acknowledgments): Don't list everyone
who changed the code.

It was a nice gesture, but seems likely to just become a pain to keep
up-to-date.  Also not really needed, given ChangeLogs and VCS logs.
2014-03-12 16:57:34 -04:00
Glenn Morris
d29fbf47e4 Use @file for buffers, per the Texinfo manual
* doc/misc/ada-mode.texi, doc/misc/auth.texi, doc/misc/calc.texi:
* doc/misc/ebrowse.texi, doc/misc/efaq.texi, doc/misc/emacs-gnutls.texi:
* doc/misc/epa.texi, doc/misc/ert.texi, doc/misc/eshell.texi:
* doc/misc/eww.texi, doc/misc/flymake.texi, doc/misc/gnus.texi:
* doc/misc/info.texi, doc/misc/message.texi, doc/misc/mh-e.texi: 
* doc/misc/newsticker.texi, doc/misc/pcl-cvs.texi, doc/misc/rcirc.texi:
* doc/misc/sem-user.texi, doc/misc/smtpmail.texi, doc/misc/url.texi:
* doc/misc/viper.texi, doc/misc/wisent.texi, doc/misc/woman.texi: 
Use @file for buffers, per the Texinfo manual.
2014-03-12 16:52:34 -04:00
Glenn Morris
991f63c0f4 Fix ChangeLog typo 2014-03-12 16:47:03 -04:00
Glenn Morris
e2bd66b7a1 * doc/emacs/misc.texi (Saving Emacs Sessions): Make previous change
slightly less brief.
2014-03-12 00:26:07 -07:00
Paul Eggert
9cb1f379d1 * org.texi: Don't set txicodequoteundirected and txicodequotebacktick
so that the Org Manual's style for ` and ' in code is consistent
with the other Emacs manuals.  This affects PDF, not .info files.
2014-03-12 00:20:43 -07:00
Glenn Morris
464560055f Some doc edits related to desktop-restore-frames
* doc/emacs/misc.texi (Saving Emacs Sessions):
Be briefer about desktop's handling of frames.
The manual does not need to mention every option, nor should
it just repeat the doc-strings.

* lisp/desktop.el (desktop-restore-frames)
(desktop-restore-in-current-display, desktop-restore-forces-onscreen)
(desktop-restore-reuses-frames): Doc tweaks.

* etc/NEWS: Related edits.
2014-03-12 00:14:30 -07:00
Paul Eggert
7195b84120 * mule.texi (International Chars): Adjust C-u C-x = description.
Change it to match Emacs's current behavior.  Also, change the
example to use ê instead of À, as the isolated grave accent in the
latter's decomposition listing was confusingly transliterated to
left single quote in the PDF version of the manual.
2014-03-12 00:03:40 -07:00
Glenn Morris
e655facf8d * doc/misc/octave-mode.texi (Using Octave Mode): Remove outdated stuff
about RET and indentation.  E.g., octave-reindent-then-newline-and-indent
was removed three years ago.

When you delete commands, please use grep to check for references to them.
2014-03-11 23:52:54 -07:00
Glenn Morris
8a51e8e417 * emacs/indent.texi (Indent Convenience): Mention electric-indent-local-mode.
* lisp/electric.el (electric-indent-mode): Doc fix.

* etc/NEWS: Related markup.
2014-03-11 23:48:20 -07: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