path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2011-01-13Fix permissionsHEADmasterSam Spilsbury19-0/+0
2010-12-10Add the ability to parse <shadow> and <padding> tags in <frame-style>Sam Spilsbury19-0/+0
2010-10-10[i18n] Updated German doc translationMario Bl├Ąttermann1-65/+391
2010-10-07[i18n] Added initial German doc translationMario Bl├Ąttermann2-1/+449
2008-10-23added missing @id on <book> top element.Frederic Peters1-1/+1
* doc/creating_themes/C/creating-metacity-themes.xml: added missing @id on <book> top element. svn path=/trunk/; revision=3998
2008-10-23renamed document to creating-metacity-themes to match other manuals usageFrederic Peters2-1/+1
* doc/creating_themes/ * doc/creating_themes/C/creating_metacity_themes.xml: renamed document to creating-metacity-themes to match other manuals usage of dashes. svn path=/trunk/; revision=3997
2008-10-22Fixed various tags to make this validate. Bug #557337:Murray Cumming1-10/+13
2008-10-22 Murray Cumming <> * doc/creating_themes/C/creating_metacity_themes.xml: Fixed various tags to make this validate. Bug #557337: svn path=/trunk/; revision=3978
2008-10-18Call GNOME_DOC_INIT() so we can use the gnome-doc-utils variables in ourMurray Cumming3-1/+308
2008-10-17 Murray Cumming <> * Call GNOME_DOC_INIT() so we can use the gnome-doc-utils variables in our * doc/ * doc/creating_themes/ * doc/creating_themes/C/creating_metacity_themes.xml: Added this new DocBook document, converted from the HTML here This will be installed for yelp and can be translated and hosted on svn path=/trunk/; revision=3964
2008-08-14new manual page. added new reference.Akira TAGOH2-1/+62
2008-08-14 Akira TAGOH <> * doc/man/metacity-message.1: new manual page. * doc/man/ added new reference. svn path=/trunk/; revision=3811
2007-04-04Fix lots of little issues with min/max constraints and size incrementElijah Newren1-7/+5
2004-04-04 Elijah Newren <newren gmail com> Fix lots of little issues with min/max constraints and size increment constraints. Fixes #329152, #418395, and possibly others. * src/window-props.c (meta_set_normal_hints): Do more checking to make sure application specified constraints are self-consistent, modifying the size_hints as necessary to achieve self-consistency. * src/constraints.c (setup_constraint_info): remove ugly copy-pasto, (constrain_size_increments): be careful that fixing violation of the constraints doesn't cause a violation of the minimum size constraints. * src/window.c (ensure_size_hints_satisfied): new function, (meta_window_unmaximize, meta_window_unmake_fullscreen): the saved_rect may no longer be valid (as in the case of #329152) so call ensure_size_hints_satisfied to fix it up. * doc/how-to-get-focus-right.txt: Some minor spacing and wording fixes completely unrelated to the rest of this commit svn path=/trunk/; revision=3155
2007-01-16fix silly thinko.Thomas James Alexander Thurman1-1/+1
* doc/compositor-control.txt: fix silly thinko. svn path=/trunk/; revision=3047
2007-01-16New file.Thomas James Alexander Thurman1-0/+46
* doc/compositor-control.txt: New file. svn path=/trunk/; revision=3043
2006-10-07described new theme format.Thomas James Alexander Thurman1-2/+87
* doc/theme-format.txt: described new theme format. * src/themes/Bright, src/themes/Crux: added version 2 themes.
2006-10-01Fix longstanding focus bug with mouse (not sloppy) focus mode with popupElijah Newren1-5/+10
2006-10-01 Elijah Newren <newren gmail com> Fix longstanding focus bug with mouse (not sloppy) focus mode with popup override-redirect windows, particularly mozilla and firefox's location bar autocompletion. #357695. * src/display.c (event_callback -- EnterNotify & LeaveNotify events): for mouse focus, defocus the focused window when the mouse enters the desktop window rather than when the mouse leaves the focused window. * doc/how-to-get-focus-right.txt: update for the slightly nuanced definition of mouse focus (people without a DESKTOP window like nautilus get sloppy focus behavior now)
2006-02-12Add a man page for metacity. Original version taken from Debian (writtenElijah Newren2-1/+61
2006-02-11 Elijah Newren <newren gmail com> Add a man page for metacity. Original version taken from Debian (written by Thom May and Akira Tagoh) and updated by Luke Morton and Philip O'Brien. Necessary auto-fu supplied by Philip O'Brien. Fixes #321279.
2005-11-21Oops, missed a couple cleanups in this documentationElijah Newren1-3/+4
2005-11-21It took me a little while to figure out how struts & workareas are updatedElijah Newren1-0/+53
2005-11-21 Elijah Newren <> * doc/strut-and-related-updating.txt: It took me a little while to figure out how struts & workareas are updated and to learn what all the related functions were used for so I thought I'd clean up my notes and make them available. This will probably be more useful now since regions and edges are also computed and stored at the some time as the workareas.
2005-11-19Merge of all the changes on the constraints_experiments branch. This isElijah Newren1-0/+283
2005-11-18 Elijah Newren <> Merge of all the changes on the constraints_experiments branch. This is just a summary, to get the full ChangeLog of those changes (approx. 2000 lines): cvs -q -z3 update -Pd -r constraints_experiments cvs -q -z3 diff -pu -r CONSTRAINTS_EXPERIMENTS_BRANCHPOINT ChangeLog Bugs fixed: unfiled - constraints.c is overly complicated[1] unfiled - constraints.c is not robust when all constraints cannot simultaneously be met (constraints need to be prioritized) unfiled - keep-titlebar-onscreen constraint is decoration unaware (since get_outermost_onscreen_positions() forgets to include decorations) unfiled - keyboard snap-moving and snap-resizing snap to hidden edges 109553 - gravity w/ simultaneous move & resize doesn't work 113601 - maximize vertical and horizontal should toggle and be constrained 122196 - windows show up under vertical panels 122670 - jerky/random resizing of window via keyboard[2] 124582 - keyboard and mouse snap-resizing and snap-moving erroneously moves the window multidimensionally 136307 - don't allow apps to resize themselves off the screen (*cough* filechooser *cough*) 142016, 143784 - windows should not span multiple xineramas unless placed there by the user 143145 - clamp new windows to screensize and force them onscreen, if they'll fit 144126 - Handle pathological strut lists sanely[3] 149867 - fixed aspect ratio windows are difficult to resize[4] 152898 - make screen edges consistent; allow easy slamming of windows into the left, right, and bottom edges of the screen too. 154706 - bouncing weirdness at screen edge with keyboard moving or resizing 156699 - avoid struts when placing windows, if possible (nasty a11y blocker) 302456 - dragging offscreen too restrictive 304857 - wireframe moving off the top of the screen is misleading 308521 - make uni-directional resizing easier with alt-middle-drag and prevent the occasional super annoying resize-the-wrong-side(s) behavior 312007 - snap-resize moves windows with a minimum size constraint 312104 - resizing the top of a window can cause the bottom to grow 319351 - don't instantly snap on mouse-move-snapping, remove braindeadedness of having order of releasing shift and releasing button press matter so much [1] fixed in my opinion, anyway. [2] Actually, it's not totally fixed--it's just annoying instead of almost completely unusable. Matthias had a suggestion that may fix the remainder of the problems (see [3] This bug was originally about not-quite-so-pathological cases but was left open for the worse cases. The code from the branch handles the remainder of the cases mentioned in this bug. [4] Actually, although it's far better there's still some minor issues left: a slight drift that's only noticeable after lots of resizing, and potential problems with partially onscreen constraints due to not clearing any fixed_directions flags (aspect ratio windows get resized in both directions and thus aren't fixed in one of them) New feature: 81704 - edge resistance for user move and resize operations; in particular 3 different kinds of resistance are implemented: Pixel-Distance: window movement is resisted when it aligns with an edge unless the movement is greater than a threshold number of pixels Timeout: window movement past an edge is prevented until a certain amount of time has elapsed during the operation since the first request to move it past that edge Keyboard-Buildup: when moving or resizing with the keyboard, once a window is aligned with a certain edge it cannot move past until the correct direction has been pressed enough times (e.g. 2 or 3 times) Major changes: - constraints.c has been rewritten; very few lines of code from the old version remain. There is a comment near the top of the function explaining the basics of how the new framework works. A more detailed explanation can be found in doc/how-constraints-works.txt - edge-resistance.[ch] are new files implementing edge-resistance. - boxes.[ch] are new files containing low-level error-prone functions used heavily in constraints.c and edge-resistance.c, among various places throughout the code. testboxes.c contains a thorough testsuite for the boxes.[ch] functions compiled into a program, testboxes. - meta_window_move_resize_internal() *must* be told the gravity of the associated operation (if it's just a move operation, the gravity will be ignored, but for resize and move+resize the correct value is needed) - the craziness of different values that meta_window_move_resize_internal() accepts has been documented in a large comment at the beginning of the function. It may be possible to clean this up some, but until then things will remain as they were before--caller beware. - screen and xinerama usable areas (i.e. places not covered by e.g. panels) are cached in the workspace now, as are the screen and xinerama edges. These get updated with the workarea in src/workspace.c:ensure_work_areas_validated()
2005-03-17add doc/code-overview.txt and doc/how-to-get-focus-right.txtLex Hider1-1/+2
2005-03-17 Lex Hider <> * doc/ (EXTRA_DIST): add doc/code-overview.txt and doc/how-to-get-focus-right.txt
2005-02-22Handle keynav vs. mousenav in mouse and sloppy focus modes. Fixes #167545.Elijah Newren1-5/+46
2005-02-21 Elijah Newren <> Handle keynav vs. mousenav in mouse and sloppy focus modes. Fixes #167545. * doc/how-to-get-focus-right.txt: Update due to this new method for handling keynav vs. mousenav, plus various other updates that I previously forgot. * src/display.h: (struct _MetaDisplay): add a mouse_mode boolean * src/display.c: (meta_display_open): initialize mouse_mode to true, (event_callback): have EnterNotify and LeaveNotify events set mouse_mode to true when focusing a window * src/keybindings.c: (process_tab_grab): set mouse_mode to false when using alt-tab/alt-esc, (do_choose_window): likewise, (do_handle_move_to_workspace): set mouse_mode to false on move-window-to-workspace-<n> keybindings * src/window.c (idle_calc_showing): if we're in keynav mode while using sloppy or mouse focus, use metacity_sentinel to avoid EnterNotify events being generated from events other than mouse movement. * src/workspace.c (meta_workspace_activate_with_focus): add a FIXME in a potentially duplicate section of code, (meta_workspace_focus_default_window): use the same focus choice as click-to-focus if in keynav mode.
2005-02-02Focus parents of dismissed transient windows in preference to the windowElijah Newren1-0/+8
2005-02-02 Elijah Newren <> Focus parents of dismissed transient windows in preference to the window that most recently had keyboard focus. Fixes #157360. * doc/how-to-get-focus-right.txt: Note the distinction between "most recently used window" and "most recent to have keyboard focus" that we are now making. * src/workspace.c: (focus_ancestor_or_mru_window): rename from meta_workspace_focus_mru_window, and first check whether we need to focus an ancestor window before looking for the mru window, (record_ancestor): helper function for focus_ancestor_or_mru_window, (meta_workspace_focus_default_window): update due to the function rename from meta_workspace_focus_mru_window to focus_ancestor_or_mru_window
2005-01-25Add man pages for metacity-window-demo and metacity-theme-viewer. ManElijah Newren5-0/+74
2005-01-25 Elijah Newren <> Add man pages for metacity-window-demo and metacity-theme-viewer. Man pages from Jose Moya, auto-fu from Dave Ahlswede. (#143513) * doc/man/metacity-theme-viewer.1: * doc/man/metacity-window-demo.1: New man pages * doc/man/ * doc/ * Make sure to install the man pages * doc/man/.cvsignore: Silence cvs
2005-01-09Don't focus the panel on click. Fixes #160470 (and 100470 and removes theElijah Newren1-4/+9
2005-01-09 Elijah Newren <> Don't focus the panel on click. Fixes #160470 (and 100470 and removes the need for the hack from 128200) * doc/how-to-get-focus-right.txt: Update section on focusing non-decorated windows (specifically, DOCKS and DESKTOPS) * src/display.c (event_callback): don't focus dock windows on click
2005-01-02Provide more documentation to make it easier for people to contribute toElijah Newren1-0/+185
2005-01-02 Elijah Newren <> Provide more documentation to make it easier for people to contribute to Metacity * HACKING: Add lots of information to extend this document: more on relevant standards and X properties, lots of information on debugging and testing, and add a list of some other important things to read; also move some information to src/code-overview.txt and organize this file into sections. * src/code-overview.txt: New file including some small parts from the old HACKING file and lots of new stuff. This file gives a brief overview of some of the bigger structures and files, with guides for a variety of task categories providing places to start looking in the code and things to look for.
2004-09-15Focus the no_focus_window if no suitable window is in the mru list (shouldElijah Newren1-4/+1
2004-09-15 Elijah Newren <> Focus the no_focus_window if no suitable window is in the mru list (should fix the almost contrived extra issue found in #147475) * doc/how-to-get-focus-right.txt: We no longer need to lie about only focusing panels upon explicit request. * src/workspace.c: (meta_workspace_focus_top_window): removed this function--it was more code than needed and was unreliable anyway, (meta_workspace_focus_mru_window): if a suitable window isn't in the mru list, focus the no_focus_window instead of calling focus_top_window.
2004-09-07Oops, panel and desktop can be focused by Ctrl-Alt-Tab tooElijah Newren1-5/+5
2004-09-07Add a new write-up on making window focus consistent (see #152004)Elijah Newren1-0/+199
2004-09-07 Elijah Newren <> Add a new write-up on making window focus consistent (see #152004) * doc/how-to-get-focus-right.txt: New document * rationales.txt: Remove references to focus bugs, instead point to doc/how-to-get-focus-right.txt
2003-02-17A small writeup on how to use dialogs in metacity. Approved by Havoc.Arvind Samptur2-1/+33
2002-12-23DTD fixesRoss Burton1-2/+2
2002-11-26and youGlynn Foster1-0/+2
2002-11-20add DTD for themes from Ross BurtonHavoc Pennington3-0/+520
2002-11-20 Havoc Pennington <> * doc/metacity-theme.dtd: add DTD for themes from Ross Burton * doc/ doc subdir * doc/theme-format.txt: move to doc subdir