From 794d68fe5de0932df3c29a3f8bc9ae0db2405da0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Luk=C3=A1=C5=A1=20Mand=C3=A1k?= <lukas.mandak@yandex.com>
Date: Mon, 22 Jun 2015 13:52:30 +0200
Subject: [PATCH] Added user documentation about bar refreshing.

---
 docs/configuration.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/docs/configuration.rst b/docs/configuration.rst
index b5a4d82..3cf3a95 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -367,3 +367,30 @@ Or make two modules look like one.
             hints = {"separator": False, "separator_block_width": 0},
             text = "Antidisestabli",
             color="#FF0000")
+
+.. _refresh:
+
+Refreshing the bar
+------------------
+
+The whole bar can be refreshed by sending SIGUSR1 signal to i3pystatus process.
+This feature is available only in standalone operation (:py:class:`.Status` was
+created with `standalone=True` parameter).
+
+To find the PID of the i3pystatus process look for the ``status_command`` you
+use in your i3 config file.
+If your `bar` section of i3 config looks like this
+
+    .. code::
+
+        bar {
+            status_command python ~/.config/i3/pystatus.py
+        }
+
+then you can refresh the bar by using the following command:
+
+    .. code:: bash
+
+        pkill -SIGUSR1 -f "python /home/user/.config/i3/pystatus.py"
+
+Note that the path must be expanded if using '~'.