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

4422 commits

Author SHA1 Message Date
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
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
Martin Rudalics
e1a2cb1ce5 Various window code related fixes and documentation changes.
* dispnew.c (change_frame_size_1): Add new_lines instead of
new_height, the latter may be still zero if passed as such.
* window.c (Fwindow_pixel_height): Mention bottom divider in
doc-string.
* window.el (window-min-height, window-min-width): Rewrite
doc-strings.
(window-body-size): Add PIXELWISE argument to make it consistent
with its callees.
* display.texi (Window Dividers): New section.
* frames.texi (Layout Parameters): Add right-divider-width and
bottom-divider-width.
* windows.texi (Window Sizes): Redraw schematic and rewrite its
description.  Rewrite descriptions of `window-total-height',
`window-total-width', `window-total-size', `window-body-height',
`window-body-width' and `window-size-fixed'.  Add descriptions
for `window-pixel-height', `window-pixel-width',
`window-min-height' and `window-min-width'.  Remove description
of `window-size-fixed-p' moving part of it to that of
`window-size-fixed'.
(Resizing Windows): Mention dividers when talking about minimum
sizes.
2014-03-05 14:50:48 +01:00
Glenn Morris
47b73b35c1 Try to document some smie changes
* doc/lispref/modes.texi (SMIE Customization): New section.

* doc/lispref/elisp.texi (Top): Update detailed menu.

* etc/NEWS: Related edits.
2014-03-04 23:41:48 -08:00
Martin Rudalics
87132570ad Fix some window code related doc-string and info entries.
* window.el (window-in-direction): Fix doc-string.
* windows.texi (Windows and Frames): Add some missing &optional
designators.  Adjust description of window-in-direction.
2014-03-04 11:44:46 +01:00
Juanma Barranquero
c19ad068c5 doc/misc/*.texi: Fix typos and whitespace.
* doc/misc/ede.texi (Android projects):
* doc/misc/eieio.texi (Class Options, Making New Objects)
  (Method Invocation, CLOS compatibility):
* doc/misc/sem-user.texi (Tag Decoration Mode): Fix typos.

* doc/misc/gnus.texi:
* doc/misc/semantic.texi: Fix whitespace.
2014-03-03 18:15:42 +01:00
Paul Eggert
fbaddd63ab Spelling fixes. 2014-03-02 21:12:12 -08:00
Juanma Barranquero
35e951cd4b */ChangeLog: Trivial fixes. 2014-03-03 05:57:26 +01:00
Glenn Morris
7ebd57e9d6 Minor doc tweaks for display-*-width, height
* lisp/frame.el (display-pixel-height, display-pixel-width)
(display-mm-dimensions-alist, display-mm-height)
(display-mm-width): Doc tweaks.

* doc/lispref/frames.texi: Remove FIXME comments.  The x- versions of
these functions are internal details that do not need documenting.

* etc/NEWS: Related markup.
2014-03-02 17:00:27 -08:00
Barry O'Reilly
62d81bd7cb * markers.texi (Moving Marker Positions): Clarify guidance about
when to move markers and when to create a new one, as discussed at
http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16818#17
2014-03-02 12:49:02 -05:00
Xue Fuqiao
209fcf3d83 * doc/misc/sem-user.texi (Create System Databases): Markup fix. 2014-03-02 17:32:46 +08:00
Xue Fuqiao
308d541018 Document `rectangle-mark-mode'.
* doc/emacs/mark.texi (Mark):
* doc/emacs/killing.texi (Rectangles): Document `rectangle-mark-mode'.

* etc/NEWS: Related edit.
2014-03-02 16:54:32 +08:00
Glenn Morris
d2b94b157c Document zlib-decompress-region
* doc/lispref/text.texi (Decompression): New node.

* doc/lispref/elisp.texi (Top): Update detailed menu.

* etc/NEWS: Related markup.
2014-03-01 19:34:36 -08:00
Glenn Morris
3a6e15dd6f * doc/lispref/display.texi (Forcing Redisplay): Mention pre-redisplay-function.
* etc/NEWS: Related markup.
2014-02-28 18:54:08 -08:00
Glenn Morris
2501c91259 Some doc related to search-invisible and query replace
* doc/emacs/search.texi (Query Replace): Mention search-invisible.

* doc/emacs/text.texi (Outline Visibility): Mention search-invisible
also affects query-replace.

* lisp/isearch.el (search-invisible): Doc fix.

* etc/NEWS: Related markup.
2014-02-28 18:48:54 -08:00