Customizing Goby

Window Manager

Emacs 22 has functionality to co-exist with any Window Manager. Thus, Goby works well without heavy customization. The followings are actions to be expected:

The frame “*goby*” in Edit mode should just-fit with the screen:

On the top, the title bar is displayed.
Minibuffer is also displayed.
Decorations of right and left edges are hidden and Emacs’s fringes are displayed.

In View mode, the frame should be white/black as follows:

The title bar is hidden because the frame goes up.
Minibuffer and mode-line are hidden since the frame is enlarged.
Both fringes become white/black.

If Goby does not work as explained above,you should customize the following variables.

If the title bar of the frame “*goby*” is not displayed, specify the pixel number of the title bar to move down.

(setq goby-window-manager-top-position 16) ;; Its default is 0

If modeline is not hidden in View mode, increase the line number to enlarge:

(setq goby-window-manager-bottom-margin 7) ;; Its default is  5

If the first line is hidden in View mode, set the following variable to zero (or proper number) o move down.

(setq goby-window-manager-view-top-position 0) ;; Its default is -22

For MacOS X, an appropriate minus value would be good.

(setq goby-window-manager-view-top-position -15) ;; Its default is -22

Tab

If you want to customize size and color, set goby-tab-spec. Its default value is as follows:

(setq goby-tab-spec
      '((0 6 "gray25"  "gray50")
        (1 5 "#004080" "#007080")
        (2 4 "#006080" "#009080")
        (3 3 "#008080" "#00b080")))

The format is as follows:

The first number is the number of TAB characters
The second number is font size (percentage to the screen height)
The third is color
The fouth is color of item signs.

For the line which has more TAB characters than the maximum number specified in goby-tab-spec, the last entry is used.

Theme

Goby provides two themes: ’light and ’dark. The default theme is ’light. If you want to use ’dark, configure as follows:

(setq goby-theme 'dark)

Hook

Goby provides the following five hooks:

goby-decorate-initial-frame-hook: A hook to be called when a Goby frame is created.
goby-view-mode-enter-hook: A hook to be called when entering View mode.
goby-view-mode-enter-hook2: A hook to be called when entering View mode.
goby-view-mode-exit-hook: A hook to be called when exiting View mode.
goby-view-mode-exit-hook2: A hook to be called when exiting View mode.