summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorOwen W. Taylor <otaylor@fishsoup.net>2014-09-27 16:47:27 +0300
committerAlberts Muktupāvels <alberts.muktupavels@gmail.com>2014-09-27 16:47:27 +0300
commitd5f905db37560669ad62032fa4c21fd0412ffbf6 (patch)
tree5827b9c243dbd007d82ae4ad83c7a0fa2a7d82f4 /doc
parent6ab5aa932870bac6447e08630c6de03da4febbbb (diff)
downloadmetacity-d5f905db37560669ad62032fa4c21fd0412ffbf6.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 NOTE: Patch copied from mutter and adapted for metacity.
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 bacc6e44..54138e65 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
======================================