From 9eb6eca2fc3579e5a046c3f002410260ed701ccd Mon Sep 17 00:00:00 2001
From: Lena <126529524+acuteenvy@users.noreply.github.com>
Date: Wed, 2 Aug 2023 19:18:14 +0200
Subject: [PATCH] polybar, polybar-msg: add page (#10446)

---
 pages/common/polybar-msg.md | 33 +++++++++++++++++++++++++++++++++
 pages/common/polybar.md     | 16 ++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 pages/common/polybar-msg.md
 create mode 100644 pages/common/polybar.md

diff --git a/pages/common/polybar-msg.md b/pages/common/polybar-msg.md
new file mode 100644
index 000000000..a9b7a6056
--- /dev/null
+++ b/pages/common/polybar-msg.md
@@ -0,0 +1,33 @@
+# polybar-msg
+
+> Control `polybar` using inter-process-messaging (IPC).
+> Note: IPC is disabled by default and can be enabled by setting `enable-ipc = true` in the Polybar config.
+> More information: <https://polybar.rtfd.io/en/stable/user/ipc.html>.
+
+- Quit the bar:
+
+`polybar-msg cmd quit`
+
+- Restart the bar in-place:
+
+`polybar-msg cmd restart`
+
+- Hide the bar (does nothing if the bar is already hidden):
+
+`polybar-msg cmd hide`
+
+- Show the bar again (does nothing if the bar is not hidden):
+
+`polybar-msg cmd show`
+
+- Toggle between hidden/visible:
+
+`polybar-msg cmd toggle`
+
+- Execute a module action (the data string is optional):
+
+`polybar-msg action "#{{module_name}}.{{action_name}}.{{data_string}}"`
+
+- Only send messages to a specific Polybar instance (all instances by default):
+
+`polybar-msg -p {{pid}} {{cmd|action}} {{payload}}`
diff --git a/pages/common/polybar.md b/pages/common/polybar.md
new file mode 100644
index 000000000..cb3c00fbb
--- /dev/null
+++ b/pages/common/polybar.md
@@ -0,0 +1,16 @@
+# polybar
+
+> A fast and easy-to-use status bar.
+> More information: <https://github.com/polybar/polybar/wiki>.
+
+- Start Polybar (the bar name is optional if only one bar is defined in the config):
+
+`polybar {{bar_name}}`
+
+- Start Polybar with the specified config:
+
+`polybar --config={{path/to/config.ini}} {{bar_name}}`
+
+- Start Polybar and reload the bar when the config file is modified:
+
+`polybar --reload {{bar_name}}`