[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-24 r117434: Second attempt to fix some doc-strings i
From: |
Martin Rudalics |
Subject: |
[Emacs-diffs] emacs-24 r117434: Second attempt to fix some doc-strings in window.c. |
Date: |
Sat, 09 Aug 2014 11:13:12 +0000 |
User-agent: |
Bazaar (2.6b2) |
------------------------------------------------------------
revno: 117434
revision-id: address@hidden
parent: address@hidden
committer: martin rudalics <address@hidden>
branch nick: emacs-24
timestamp: Sat 2014-08-09 13:12:45 +0200
message:
Second attempt to fix some doc-strings in window.c.
* window.c (Fwindow_new_total, Fwindow_new_normal)
(Fwindow_new_pixel, Fset_window_new_pixel)
(Fset_window_new_total, Fset_window_new_normal): Second attempt
to fix the doc-strings of these functions. See:
http://lists.gnu.org/archive/html/bug-gnu-emacs/2014-08/msg00287.html
modified:
src/ChangeLog changelog-20091113204419-o5vbwnq5f7feedwu-1438
src/window.c window.c-20091113204419-o5vbwnq5f7feedwu-231
=== modified file 'src/ChangeLog'
--- a/src/ChangeLog 2014-08-08 09:52:59 +0000
+++ b/src/ChangeLog 2014-08-09 11:12:45 +0000
@@ -1,3 +1,11 @@
+2014-08-09 Martin Rudalics <address@hidden>
+
+ * window.c (Fwindow_new_total, Fwindow_new_normal)
+ (Fwindow_new_pixel, Fset_window_new_pixel)
+ (Fset_window_new_total, Fset_window_new_normal): Second attempt
+ to fix the doc-strings of these functions. See:
+ http://lists.gnu.org/archive/html/bug-gnu-emacs/2014-08/msg00287.html
+
2014-08-08 Martin Rudalics <address@hidden>
* window.c (Fwindow_valid_p): Fix doc-string (Bug#18194).
=== modified file 'src/window.c'
--- a/src/window.c 2014-08-08 09:52:59 +0000
+++ b/src/window.c 2014-08-09 11:12:45 +0000
@@ -794,8 +794,10 @@
doc: /* Return the new total size of window WINDOW.
WINDOW must be a valid window and defaults to the selected one.
-The new total size of WINDOW (see `window-total-size') is that set by
-the last call of `set-window-new-total' for WINDOW. */)
+The new total size of WINDOW is the value set by the last call of
+`set-window-new-total' for WINDOW. If it is valid, it will be shortly
+installed as WINDOW's total height (see `window-total-height') or total
+width (see `window-total-width'). */)
(Lisp_Object window)
{
return decode_valid_window (window)->new_total;
@@ -834,8 +836,9 @@
doc: /* Return new normal size of window WINDOW.
WINDOW must be a valid window and defaults to the selected one.
-The new normal size of WINDOW (see `window-normal-size') is that set by
-the last call of `set-window-new-normal' for WINDOW. */)
+The new normal size of WINDOW is the value set by the last call of
+`set-window-new-normal' for WINDOW. If valid, it will be shortly
+installed as WINDOW's normal size (see `window-normal-size'). */)
(Lisp_Object window)
{
return decode_valid_window (window)->new_normal;
@@ -846,9 +849,9 @@
WINDOW must be a valid window and defaults to the selected one.
The new pixel size of WINDOW is the value set by the last call of
-`set-window-new-pixel' for WINDOW. If set correctly, it gets eventually
-installed by the function `window-resize-apply' and will be returned by
-the functions `window-pixel-height' or `window-pixel-width'. */)
+`set-window-new-pixel' for WINDOW. If it is valid, it will be shortly
+installed as WINDOW's pixel height (see `window-pixel-height') or pixel
+width (see `window-pixel-width'). */)
(Lisp_Object window)
{
return decode_valid_window (window)->new_pixel;
@@ -3744,9 +3747,9 @@
Optional argument ADD non-nil means add SIZE to the new pixel size of
WINDOW and return the sum.
-The new pixel size of WINDOW is used by `window-resize-apply' and, if
-that function succeeds, will be subsequently returned by the functions
-`window-pixel-height' and `window-pixel-width'.
+The new pixel size of WINDOW, if valid, will be shortly installed as
+WINDOW's pixel height (see `window-pixel-height') or pixel width (see
+`window-pixel-width').
Note: This function does not operate on any child windows of WINDOW. */)
(Lisp_Object window, Lisp_Object size, Lisp_Object add)
@@ -3772,8 +3775,9 @@
Optional argument ADD non-nil means add SIZE to the new total size of
WINDOW and return the sum.
-The new total size of WINDOW is used by `window-resize-apply-total' and,
-after calling that function, will be returned by `window-total-size'.
+The new total size of WINDOW, if valid, will be shortly installed as
+WINDOW's total height (see `window-total-height') or total width (see
+`window-total-width').
Note: This function does not operate on any child windows of WINDOW. */)
(Lisp_Object window, Lisp_Object size, Lisp_Object add)
@@ -3794,9 +3798,8 @@
WINDOW must be a valid window and defaults to the selected one.
Return SIZE.
-The new normal size of WINDOW is used by `window-resize-apply' and, if
-that function succeeds, will be subsequently returned by the function
-`window-normal-size'.
+The new normal size of WINDOW, if valid, will be shortly installed as
+WINDOW's normal size (see `window-normal-size').
Note: This function does not operate on any child windows of WINDOW. */)
(Lisp_Object window, Lisp_Object size)
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-24 r117434: Second attempt to fix some doc-strings in window.c.,
Martin Rudalics <=