add i3 v4.5

[i3/i3.github.io] / docs / i3bar-protocol.html

diff --git a/docs/i3bar-protocol.html b/docs/i3bar-protocol.html
index b2fd9f444ef5fd4caadf452545491ecdca082474..222543fed00ba229db2d47c55d5e4b6ec50cbb46 100644 (file)
--- a/docs/i3bar-protocol.html
+++ b/docs/i3bar-protocol.html
@@ -230,6 +230,10 @@ min_width
         will be padded to the left and/or the right side, according to the <tt>align</tt>\r
         key. This is useful when you want to prevent the whole status line to shift\r
         when value take more or less space between each iteration.\r
+        The value can also be a string. In this case, the width of the text given\r
+        by <tt>min_width</tt> determines the minimum width of the block. This is useful\r
+        when you want to set a sensible minimum width regardless of which font you\r
+        are using, and at what particular size.\r
 </p>\r
 </dd>\r
 <dt class="hdlist1">\r
@@ -264,6 +268,28 @@ urgent
         space (for non-root users). The presentation of urgency is up to i3bar.\r
 </p>\r
 </dd>\r
+<dt class="hdlist1">\r
+separator\r
+</dt>\r
+<dd>\r
+<p>\r
+        A boolean which specifies whether a separator line should be drawn\r
+        after this block. The default is true, meaning the separator line will\r
+        be drawn. Note that if you disable the separator line, there will still\r
+        be a gap after the block, unless you also use <tt>separator_block_width</tt>.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+separator_block_width\r
+</dt>\r
+<dd>\r
+<p>\r
+        The amount of pixels to leave blank after the block. In the middle of\r
+        this gap, a separator line will be drawn unless <tt>separator</tt> is\r
+        disabled. Normally, you want to set this to an odd value (the default\r
+        is 9 pixels), since the separator line is drawn in the middle.\r
+</p>\r
+</dd>\r
 </dl></div>\r
 <div class="paragraph"><p>If you want to put in your own entries into a block, prefix the key with an\r
 underscore (_). i3bar will ignore all keys it doesn’t understand, and prefixing\r
@@ -277,6 +303,16 @@ of the i3bar protocol.</p></div>
  "_ethernet_vendor": "Intel"\r
 }</tt></pre>\r
 </div></div>\r
+<div class="paragraph"><p>In the following example, the longest (widest) possible value of the block is\r
+used to set the minimum width:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>{\r
+ "full_text": "CPU 4%",\r
+ "min_width": "CPU 100%",\r
+ "align": "left"\r
+}</tt></pre>\r
+</div></div>\r
 <div class="paragraph"><p>An example of a block which uses all possible entries follows:</p></div>\r
 <div class="paragraph"><p><strong>Example</strong>:</p></div>\r
 <div class="listingblock">\r
@@ -289,7 +325,9 @@ of the i3bar protocol.</p></div>
  "align": "right",\r
  "urgent": false,\r
  "name": "ethernet",\r
- "instance": "eth0"\r
+ "instance": "eth0",\r
+ "separator": true,\r
+ "separator_block_width": 9\r
 }</tt></pre>\r
 </div></div>\r
 </div>\r