Added user documentation about bar refreshing.

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 '~'.