mako, makoctl, makoctl-{mode, dismiss, invoke}: add page (#19165)

Co-authored-by: Dylan <[email protected]>
Co-authored-by: Lena Pastwa <[email protected]>
Co-authored-by: Managor <[email protected]>

Author: 4 people

pages/linux/mako.md

@@ -0,0 +1,29 @@
+# mako
+
+> Notification daemon for Wayland compositors.
+> Can be controlled with `makoctl`.
+> More information: <https://manned.org/mako>.
+
+- Start the `mako` notification daemon:
+
+`mako`
+
+- Start with a custom configuration file:
+
+`mako {{[-c|--config]}} {{path/to/config}}`
+
+- Set maximum number of visible notifications:
+
+`mako --max-visible {{5}}`
+
+- Set default timeout in milliseconds (0 to disable):
+
+`mako --default-timeout {{2000}}`
+
+- Group notifications by application name:
+
+`mako --group-by {{app_name}}`
+
+- Display help:
+
+`mako {{[-h|--help]}}`

pages/linux/makoctl-dismiss.md

@@ -0,0 +1,24 @@
+# makoctl dismiss
+
+> Dismiss notifications in `mako`.
+> More information: <https://manned.org/makoctl>.
+
+- Dismiss the most recent notification:
+
+`makoctl dismiss`
+
+- Dismiss a specific notification by ID:
+
+`makoctl dismiss -n {{notification_id}}`
+
+- Dismiss all notifications:
+
+`makoctl dismiss {{[-a|--all]}}`
+
+- Dismiss all notifications in the first group:
+
+`makoctl dismiss {{[-g|--group]}}`
+
+- Dismiss without adding to history:
+
+`makoctl dismiss {{[-h|--no-history]}}`

pages/linux/makoctl-invoke.md

@@ -0,0 +1,12 @@
+# makoctl invoke
+
+> Invoke actions on notifications in `mako`.
+> More information: <https://manned.org/makoctl>.
+
+- Invoke the default action on the most recent notification:
+
+`makoctl invoke`
+
+- Invoke a specific action on a notification (if not specified, default is used):
+
+`makoctl invoke -n {{notification_id}} {{action_name}}`

pages/linux/makoctl-mode.md

@@ -0,0 +1,25 @@
+# makoctl mode
+
+> Manage notification modes in `mako`.
+> Modes can be used to change notification behavior (e.g., do-not-disturb).
+> More information: <https://manned.org/makoctl>.
+
+- List all currently active modes:
+
+`makoctl mode`
+
+- Add a mode:
+
+`makoctl mode -a {{do-not-disturb}}`
+
+- Remove a mode:
+
+`makoctl mode -r {{do-not-disturb}}`
+
+- Toggle a mode (add if absent, remove if present):
+
+`makoctl mode -t {{do-not-disturb}}`
+
+- Set specific modes, replacing all current modes:
+
+`makoctl mode -s {{mode1 mode2 ...}}`

pages/linux/makoctl.md

@@ -0,0 +1,25 @@
+# makoctl
+
+> Control the `mako` notification daemon.
+> Some subcommands such as `dismiss`, `invoke`, and `mode` have their own usage documentation.
+> More information: <https://manned.org/makoctl>.
+
+- List all current notifications:
+
+`makoctl list`
+
+- List notification history:
+
+`makoctl history`
+
+- Reload the configuration file:
+
+`makoctl reload`
+
+- Restore the most recently expired notification from history:
+
+`makoctl restore`
+
+- Display help:
+
+`makoctl help`