summaryrefslogtreecommitdiff
path: root/doc/theme-format.txt
diff options
context:
space:
mode:
authorOwen W. Taylor <[email protected]>2014-09-27 16:47:27 +0300
committerVictor Kareh <[email protected]>2018-08-28 09:38:37 -0400
commita47f178df47ae26bf080b5c4f34762102c58085e (patch)
tree10de970315f7f835c2bac590c4e2a18150b24409 /doc/theme-format.txt
parent728f0022b1b5b75a289abf8f3acec43378c06d92 (diff)
downloadmarco-a47f178df47ae26bf080b5c4f34762102c58085e.tar.bz2
marco-a47f178df47ae26bf080b5c4f34762102c58085e.tar.xz
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/theme-format.txt')
-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 95191edd..bd6004d4 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
======================================