mutter/README

289 lines
11 KiB
Plaintext
Raw Normal View History

2001-07-25 01:43:41 -04:00
Metacity is not a meta-City as in an urban center, but rather
Meta-ness as in the state of being meta. i.e. metacity : meta as
opacity : opaque. Also it may have something to do with the Meta key
on UNIX keyboards.
The first release of Metacity was version 2.3. Metacity has no need for
2001-07-25 01:43:41 -04:00
your petty hangups about version numbers.
2001-07-28 02:11:15 -04:00
COMPILING METACITY
===
You need GTK+ 2.0, ideally the latest in the 2.0.x series. For
multihead/Xinerama support to work, you need GTK+ 2.1.x or 2.2. For
startup notification to work you need libstartup-notification at
http://www.freedesktop.org/software/startup-notification/ or on the
GNOME ftp site. You also need GConf 1.2 (though it would be easy to
remove that dependency in a custom hacked metacity, if you wanted).
2001-07-28 02:11:15 -04:00
REPORTING BUGS AND SUBMITTING PATCHES
===
Report new bugs on http://bugzilla.gnome.org.
2001-07-28 02:11:15 -04:00
Feel free to send patches too; Metacity is relatively small and
simple, so if you find a bug or want to add a feature it should be
pretty easy. Send me mail, or put the patch in bugzilla.
2001-07-28 02:11:15 -04:00
2001-07-28 02:35:19 -04:00
See the HACKING file for some notes on hacking Metacity.
2001-07-25 01:43:41 -04:00
METACITY FEATURES
===
- Boring window manager for the adult in you. Many window managers
are like Marshmallow Froot Loops; Metacity is like Cheerios.
- Uses GTK+ 2.0 for drawing window frames. This means colors, fonts,
etc. come from GTK+ theme.
- Has a simple theme system and a couple of extra themes come with it.
Change themes via gconf-editor or gconftool:
gconftool-2 --type=string --set /apps/metacity/general/theme Crux
gconftool-2 --type=string --set /apps/metacity/general/theme Gorilla
gconftool-2 --type=string --set /apps/metacity/general/theme Atlanta
gconftool-2 --type=string --set /apps/metacity/general/theme Bright
See theme-format.txt for docs on the theme format. Use
metacity-theme-viewer to preview themes.
- Change number of workspaces via gconf-editor or gconftool:
gconftool-2 --type=int --set /apps/metacity/general/num_workspaces 5
Can also change workspaces from GNOME 2 pager.
- Change focus mode:
gconftool-2 --type=string --set /apps/metacity/general/focus_mode mouse
gconftool-2 --type=string --set /apps/metacity/general/focus_mode sloppy
gconftool-2 --type=string --set /apps/metacity/general/focus_mode click
2001-07-25 01:43:41 -04:00
- Global keybinding defaults:
Alt-Tab forward cycle window focus
Alt-Shift-Tab backward cycle focus
Alt-Ctrl-Tab forward cycle focus among panels
Alt-Ctrl-Shift-Tab backward cycle focus among panels
Alt-Escape cycle window focus without a popup thingy
Ctrl-Alt-Left Arrow previous workspace
Ctrl-Alt-Right Arrow next workspace
Ctrl-Alt-D minimize/unminimize all, to show desktop
2001-07-25 01:43:41 -04:00
Change keybindings for example:
unst gconftool-2 --type=string --set /apps/metacity/global_keybindings/switch_to_workspace_1 '<Alt>F1'
See metacity.schemas for available bindings.
2001-07-25 01:43:41 -04:00
- Window keybindings:
2001-07-25 01:43:41 -04:00
Alt-space window menu
Mnemonics work in the menu. That is, Alt-space then underlined
letter in the menu item works.
Choose Move from menu, and arrow keys to move the window.
2001-07-25 23:14:45 -04:00
2001-07-25 01:43:41 -04:00
While moving, hold down Control to move slower, and
Shift to snap to edges.
2001-07-25 23:14:45 -04:00
2001-07-25 01:43:41 -04:00
Choose Resize from menu, and nothing happens yet, but
eventually I might implement something.
2001-07-25 01:43:41 -04:00
Keybindings for things like maximize window, etc. can be bound,
but don't exist by default. See metacity.schemas.
2001-07-25 01:43:41 -04:00
- Window mouse bindings:
Clicking anywhere on frame with button 1 will raise/focus window
If you click a window control, such as the close button, then the
control will activate on button release if you are still over it
on release (as with most GUI toolkits)
If you click and drag borders with button 1 it resizes the window
If you click and drag the titlebar with button 1 it moves the
window.
If you click anywhere on the frame with button 3 it shows the
window menu.
If you hold down Super (windows key) and click inside a window, it
will move the window (buttons 1 and 2) or show menu (button 3).
Or you can configure a different modifier for this.
2001-07-25 01:43:41 -04:00
2001-07-28 01:37:57 -04:00
If you pick up a window with button 1 and then switch workspaces
the window will come with you to the new workspace, this is
2001-07-25 01:43:41 -04:00
a feature copied from Enlightenment.
2001-07-26 01:10:01 -04:00
If you hold down Shift while moving a window, the window snaps
to edges of other windows and the screen.
2001-07-25 01:43:41 -04:00
- Session management:
2001-07-28 02:11:15 -04:00
Metacity connects to the session manager and will set itself up to
be respawned. It theoretically restores sizes/positions/workspace
for session-aware applications.
2001-07-25 01:43:41 -04:00
- Metacity implements much of the new window manager spec from
freedesktop.org, and much of the ICCCM. But then there are
parts of each that it doesn't implement, just because I haven't
yet.
2001-07-25 23:14:45 -04:00
- Uses Pango to render text, so has cool i18n capabilities.
Supports UTF-8 window titles and such.
- There are simple animations for actions such as minimization,
to help users see what is happening. Should probably
have a few more of these and make them nicer.
- if you have the proper X setup, set the GDK_USE_XFT=1
environment variable to get antialiased window titles.
- considers the panel when placing windows and maximizing
them.
- handles the window manager selection from the ICCCM. Will exit if
another WM claims it, and can claim it from another WM if you pass
the --replace argument. So if you're running another
ICCCM-compliant WM, you can run "metacity --replace" to replace it
with Metacity.
- does basic colormap handling
2001-07-25 01:43:41 -04:00
METACITY BUGS, NON-FEATURES, AND CAVEATS
===
- You need an EWMH-spec compliant pager/tasklist to be able
to navigate graphically; this does NOT include GNOME 1.x,
but should include GNOME 2 and KDE 3.
2001-07-25 01:43:41 -04:00
- doesn't do WM_COLORMAPS from the ICCCM, may matter on some really
old obscure hardware with some really obscure apps.
2001-07-25 01:43:41 -04:00
2001-07-28 02:11:15 -04:00
- There are probably other ICCCM-compliance issues.
- The first-fit algorithm for placement isn't very clever.
2001-07-25 01:43:41 -04:00
2001-07-25 23:14:45 -04:00
- Should Metacity support flipping in right-to-left locales?
I don't know what window managers look like in a right-to-left
locale. I assume the window titles should be right-justified;
should the window controls also be flipped?
2001-07-25 01:43:41 -04:00
FAQ
===
Q: Will you add my feature?
2001-07-25 23:14:45 -04:00
A: If it makes sense to turn on unconditionally,
2001-07-25 01:43:41 -04:00
or is genuinely a harmless preference that I would not
2001-07-25 23:14:45 -04:00
be embarrassed to put in a simple, uncluttered, user-friendly
configuration dialog.
If the only rationale for your feature is that other window
managers have it, or that you are personally used to it, or something
like that, then I will not be impressed. Metacity is firmly in the
"choose good defaults" camp rather than the "offer 6 equally broken
ways to do it, and let the user pick one" camp.
2001-07-25 01:43:41 -04:00
2001-07-25 23:14:45 -04:00
This is part of a "no crackrock" policy, despite some exceptions
2001-07-25 01:43:41 -04:00
I'm mildly embarrassed about. For example, multiple workspaces
probably constitute crackrock, they confuse most users
and really are not that useful if you have a decent tasklist and
so on. But I am too used to them to turn them off.
Or alternatively iconification/tasklist is crack, and workspaces/pager
are good. But having both is certainly a bit wrong.
Sloppy focus is probably crackrock too.
2001-07-25 01:43:41 -04:00
But don't think unlimited crack is OK just because I slipped up a
2001-07-25 23:14:45 -04:00
little. No slippery slope here.
Don't let this discourage patches and fixes - I love those. ;-)
Just be prepared to hear the above objections if your patch
adds some crack-ridden configuration option.
2001-07-25 01:43:41 -04:00
http://pobox.com/~hp/free-software-ui.html
2001-07-25 01:43:41 -04:00
Q: Will Metacity be part of GNOME?
A: Many people are now asking for this, though it was not the original
plan - Metacity started out as sort of an experiment.
2001-07-25 23:14:45 -04:00
A decision hasn't really been made but the issue will probably
be raised shortly after the GNOME 2 release.
2001-07-25 01:43:41 -04:00
2001-07-30 23:59:55 -04:00
Q: Is Metacity a Red Hat project?
A: Metacity is in no way funded, endorsed, or encouraged by Red Hat,
Inc. - I'm guessing Red Hat would not consider "insufficient number
of window managers for Linux" an urgent problem. Just a wild guess
though.
2001-07-28 01:37:57 -04:00
Q: Why does Metacity remember the workspace/position of some apps
but not others?
A: Metacity only stores sizes/positions for apps that are session
managed. As far as I can determine, there is no way to attempt
to remember workspace/position for non-session-aware apps without
causing a lot of weird effects.
The reason is that you don't know which non-SM-aware apps were
launched by the session. When you initially log in, Metacity sees a
bunch of new windows appear. But it can't distinguish between
windows that were stored in your session, or windows you just
launched after logging in. If Metacity tried to guess that a window
2001-07-28 02:11:15 -04:00
was from the session, it could e.g. end up maximizing a dialog, or
put a window you just launched on another desktop or in a weird
2001-07-28 01:37:57 -04:00
place. And in fact I see a lot of bugs like this in window managers
that try to handle non-session-aware apps.
However, for session-aware apps, Metacity can tell that the
application instance is from the session and thus restore it
reliably, assuming the app properly restores the windows it had
open on session save.
So the correct way to fix the situation is to make apps
session-aware. libSM has come with X for years, it's very
standardized, it's shared by GNOME and KDE - even twm is
session-aware. So anyone who won't take a patch to add SM is more
archaic than twm - and you should flame them. ;-)
Docs on session management:
ftp://ftp.x.org/pub/R6.4/xc/doc/hardcopy/SM/xsmp.PS.gz
ftp://ftp.x.org:21/pub/R6.4/xc/doc/hardcopy/SM/SMlib.PS.gz
2001-07-28 02:11:15 -04:00
See also the ICCCM section on SM. For GNOME apps, use the
GnomeClient object. For a simple example of using libSM directly,
twm/session.c in the twm source code is pretty easy to understand.
2001-07-28 01:37:57 -04:00
Q: How about adding viewports in addition to workspaces?
A: I could conceivably be convinced to use viewports _instead_ of
workspaces, though currently I'm not thinking that. But I don't
think it makes any sense to have both; it's just confusing. They
are functionally equivalent.
You may think this means that you won't have certain keybindings,
or something like that. This is a misconception. The only
_fundamental_ difference between viewports and workspaces is that
with viewports, windows can "overlap" and appear partially on
one and partially on another. All other differences that
traditionally exist in other window managers are accidental -
the features commonly associated with viewports can be implemented
for workspaces, and vice versa.
So I don't want to have two kinds of
workspace/desktop/viewport/whatever, but I'm willing to add
features traditionally associated with either kind if those
features make sense.
2001-07-25 01:43:41 -04:00
Q: Did you spend a lot of time on this?
A: Originally the answer was no. Sadly the answer is now yes.
2001-07-25 01:43:41 -04:00
Q: How can you claim that you are anti-crack, while still
writing a window manager?
A: I have no comment on that.