Split a frame or window into some windows according to a layout recipe. ; Example code ;; Layout function ; -> three pane layout. (setq wm ; <-- window management object (wlf:layout '(| (:left-size-ratio 0.3) folder (- (:upper-max-size 15) summary message)) '((:name folder :buffer "folder buffer") (:name summary :buffer "summary buffer") (:name message :buffer "message buffer") ))) ;; Window controlling (wlf:show wm 'summary) (wlf:hide wm 'summary) (wlf:toggle wm 'summary) (wlf:select wm 'summary) (wlf:toggle-maximize wm 'summary) ;; Window updating (wlf:refresh wm) (wlf:reset-window-sizes wm) (wlf:reset-init wm) ;; Accessing a buffer (wlf:get-buffer wm 'summary) -> <#buffer object> (wlf:set-buffer wm 'summary "*scratch*") ;; Accessing a window (wlf:get-window wm 'summary) ;; Layout hook (defun wlf:test-hook (wset) (message "HOOK : %s" wset)) (wlf:layout-hook-add wm 'wlf:test-hook) (wlf:layout-hook-remove wm 'wlf:test-hook) ; `wlf:layout' function * Layout recipe: ( (split type) (split option) (left window name or recipe) (right window name or recipe) ) - : split vertically | : split horizontally split option (the prefix 'left' can be replaced by 'right', 'upper' and 'lower'.) :left-size (column or row number) window size :left-max-size (column or row number) if window size is larger than this value, the window is shrunken. :left-size-ratio (0.0 - 1.0) window size ratio. the size of the other side is the rest. Note: The split option can be omitted. The size parameters, :size, :max-size and :size-ratio, are mutually exclusive. The size of a window is related with one of the other side window. So, if both side windows set size parameters, the window size may not be adjusted as you write. * Window options: :name [*] the window name. :buffer a buffer name or a buffer object to show the window. If nil or omitted, the current buffer remains. If symbol, it is evaluated as a global variable. :default-hide (t/nil) if t, the window is hided initially. (default: nil) :fix-size (t/nil) if t, when the windows are laid out again, the window size is remained. (default: nil) * subwindow-p option: If this option is not nil, this function splits the windows within the current window. If this option is nil or omitted, this function uses the entire space of the current frame. Because some user actions and complicated window layouts may cause unexpected split behaviors, it is easy to use the entire space of a frame. * Return value (Window management object): You should not access the management object directly, because it is not intended direct access. You can make some management objects to switch the window layout. * Layout hook After splitting windows, registered hook are called with one argument, the window management object.