split-window documentation

split-window documentation

[Matthias]

Hi,

I have written a function to setup a window configuration I find
useful. But when working in a terminal with a small text height, the
function `split-window' may return the following error:

 Window height 3 too small (after splitting)

This feature is not documented in the elisp manual nor the doc spec of
`split-window'. May one give me some information so that I can add
some test in my function?

Here is the function (any comment welcome):

(defun alt-setup-configuration ()
  (interactive)
  (if (window-configuration-p (car (get-register ?1)))
      (jump-to-register ?1)
    (when (not (one-window-p t))
      (delete-other-windows (get-largest-window)))
    (let ((window1 (selected-window))
          (window2 (split-window nil 28))
          (window3 (split-window nil 34 t)))
      (save-excursion
        (diary)
        (when (not (gnus-alive-p))
          (gnus))
        (list-buffers t))
      (set-window-buffer window1 "*Group*")
      (set-window-buffer window2 "*Buffer List*")
      (set-window-point window2 (point-min))
      (set-window-buffer window3 "*Fancy Diary Entries*")
      (window-configuration-to-register ?1))))

Thank you for your help,
-- 
Matthias

Re: split-window documentation

[David Vanderschel]

"Matthias" <cimosque@free.fr> wrote in message
news:yg7iscuvqqr.fsf@fermat.math.uvsq.fr...
> function `split-window' may return the following error:

>  Window height 3 too small (after splitting)

> This feature is not documented in the elisp manual nor the doc spec of
> `split-window'. May one give me some information so that I can add
> some test in my function?

It is hardly surprising that there should be such a
limit.  Since you now know emacs' low limit on window
height and how the split-window function behaves, I
should think that you could avoid the error by
checking your situation using function window-height.

Regards,
  David V.

PS - Interestingly, by adjusting the size of my frame,
I can persuade emacs to display a window in a single
line.  It gives up the echo/minibuffer line first,
then the mode line - but it still works!

Re: split-window documentation

[Matthias]

"David Vanderschel" <DJV4@Austin.RR.com> wrote:

> (...) Since you now know emacs' low limit on window height

No, I don't know. This is exactly what I am asking for! Is there a
variable which fix this limit?
-- 
Matthias

Re: split-window documentation

[Kevin Rodgers]

Matthias wrote:
 > "David Vanderschel" <DJV4@Austin.RR.com> wrote:
 >>(...) Since you now know emacs' low limit on window height
 >
 > No, I don't know. This is exactly what I am asking for! Is there a
 > variable which fix this limit?

window-min-height

-- 
Kevin Rodgers