summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorOwen W. Taylor <otaylor@fishsoup.net>2009-08-20 15:54:11 -0400
committerOwen W. Taylor <otaylor@fishsoup.net>2010-04-13 14:10:54 -0400
commit1d7476a7257e9c41e5649160859ba98247af92d9 (patch)
tree1a337528d84ce0bf94b63ad51e34aec5e585007f /doc
parente8e78ebfdd000ad85b0ec269b1a3420586750523 (diff)
downloadmutter-1d7476a7257e9c41e5649160859ba98247af92d9.tar.gz
Allow a theme to specify ellipsize width for a title
It's nice to indicate when a title is truncated with an ellipsis. Because themes may draw a title multiple times to draw a shadow, or may include the window icon within the title area, we can't determine the proper ellipsization width automatically, so add an optional attribute to the <title/> element "ellipsize_width" which, if set, is the width to ellipsize at. This is only enabled if a theme version of 3.1 is required. When it's not set, we keep the old behavior of just letting the title be clipped with a hard edge. https://bugzilla.gnome.org/show_bug.cgi?id=591842
Diffstat (limited to 'doc')
-rw-r--r--doc/theme-format.txt4
1 files changed, 4 insertions, 0 deletions
diff --git a/doc/theme-format.txt b/doc/theme-format.txt
index cefc31627..b23e6acdb 100644
--- a/doc/theme-format.txt
+++ b/doc/theme-format.txt
@@ -32,6 +32,10 @@ Additional predefined variables are added for positioning expressions:
frame_y_center: the Y center of the entire frame, with respect to the
piece currently being drawn.
+The <title/> element now supports an "ellipsize_width" attribute. When
+specified, this gives a width at which to ellipsize the title. If not
+specified, the title will simply be clipped to the title area.
+
New Features in Theme Format Version 3
======================================