[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110891: Document fit-frame-to-buffer

[Glenn Morris]

------------------------------------------------------------
revno: 110891
committer: Glenn Morris <address@hidden>
branch nick: emacs-24
timestamp: Fri 2012-11-16 20:33:26 -0500
message:
  Document fit-frame-to-buffer
  
  * doc/lispref/frames.texi (Size and Position): Add fit-frame-to-buffer 
command.
  * doc/lispref/windows.texi (Resizing Windows): Add fit-frame-to-buffer option.
  (Window Sizes): Add vindex for window-min-height, window-min-width.
  
  * etc/NEWS: Related markup.
modified:
  doc/lispref/ChangeLog
  doc/lispref/frames.texi
  doc/lispref/windows.texi
  etc/NEWS

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-11-16 10:29:48 +0000
+++ b/doc/lispref/ChangeLog     2012-11-17 01:33:26 +0000
@@ -1,3 +1,9 @@
+2012-11-17  Glenn Morris  <address@hidden>
+
+       * frames.texi (Size and Position): Add fit-frame-to-buffer command.
+       * windows.texi (Resizing Windows): Add fit-frame-to-buffer option.
+       (Window Sizes): Add vindex for window-min-height, window-min-width.
+
 2012-11-16  Martin Rudalics  <address@hidden>
 
        * windows.texi (Choosing Window): Rewrite description of

=== modified file 'doc/lispref/frames.texi'
--- a/doc/lispref/frames.texi   2012-11-05 14:30:58 +0000
+++ b/doc/lispref/frames.texi   2012-11-17 01:33:26 +0000
@@ -1113,6 +1113,21 @@
 @code{set-frame-height}.
 @end defun
 
address@hidden FIXME?  Belongs more in Emacs manual than here?
address@hidden But eg fit-window-to-buffer is in this manual.
address@hidden Command fit-frame-to-buffer &optional frame max-height min-height
+This command adjusts the height of @var{frame} (the default is the
+selected frame) to fit its contents.  The optional arguments
address@hidden and @var{min-height} specify the maximum and minimum
+new frame heights, respectively.
+
address@hidden fit-frame-to-buffer-bottom-margin
+The default minimum height corresponds to @code{window-min-height}.
+The default maximum height is the screen height below the current top
+position of the frame, minus any margin specified by the option
address@hidden
address@hidden deffn
+
 @node Geometry
 @subsection Geometry
 

=== modified file 'doc/lispref/windows.texi'
--- a/doc/lispref/windows.texi  2012-11-16 10:29:48 +0000
+++ b/doc/lispref/windows.texi  2012-11-17 01:33:26 +0000
@@ -490,6 +490,8 @@
 aliases are considered obsolete and will be removed in the future.
 
 @cindex fixed-size window
address@hidden window-min-height
address@hidden window-min-width
   Commands that change the size of windows (@pxref{Resizing Windows}),
 or split them (@pxref{Splitting Windows}), obey the variables
 @code{window-min-height} and @code{window-min-width}, which specify
@@ -633,6 +635,10 @@
 If the optional argument @var{override} is address@hidden, this
 function ignores any size restrictions imposed by
 @code{window-min-height} and @code{window-min-width}.
+
address@hidden fit-frame-to-buffer
+If the option @code{fit-frame-to-buffer} is address@hidden, this
+command may resize the frame to fit its contents.
 @end deffn
 
 @deffn Command shrink-window-if-larger-than-buffer &optional window

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-11-16 08:31:20 +0000
+++ b/etc/NEWS  2012-11-17 01:33:26 +0000
@@ -848,12 +848,15 @@
 
 *** New macro `with-temp-buffer-window'.
 
+---
 *** `temp-buffer-resize-mode' no longer resizes windows that have been
 reused.
 
++++
 *** New command `fit-frame-to-buffer' adjusts the frame height to
 fit the contents.
 
++++
 *** The command `fit-window-to-buffer' can adjust the frame height
 if the new option `fit-frame-to-buffer' is non-nil.