Skip to content

Commit b9efc80

Browse files
authored
Merge pull request #1298 from zappolowski/update-dunstctl-manpage
Update dunstctl manpage
2 parents a2af4a8 + 1305961 commit b9efc80

File tree

1 file changed

+27
-7
lines changed

1 file changed

+27
-7
lines changed

docs/dunstctl.pod

+27-7
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
=head1 NAME
22

3-
dunstctl - Command line control utility for dunst, a customizable and lightweight notification-daemon
3+
dunstctl - Command line control utility for dunst, a customizable and
4+
lightweight notification-daemon
45

56
=head1 SYNOPSIS
67

@@ -34,13 +35,25 @@ currently open notifications.
3435
Returns the number of displayed, shown and waiting notifications. If no argument
3536
is provided, everything will be printed.
3637

38+
=item B<history>
39+
40+
Exports the history as JSON.
41+
42+
=item B<history-clear>
43+
44+
Deletes all notifications from the history.
45+
3746
=item B<history-pop> [ID]
3847

3948
Redisplay the notification that was most recently closed. This can be called
4049
multiple times to show older notifications, up to the history limit configured
4150
in dunst. You can optionally pass an ID to history-pop, in which case the
4251
notification with the given ID will be shown.
4352

53+
=item B<history-rm> ID
54+
55+
Removes the notification with the given ID from the history.
56+
4457
=item B<is-paused>
4558

4659
Check if dunst is currently running or paused. If dunst is paused notifications
@@ -54,24 +67,31 @@ See the is-paused command and the dunst man page for more information.
5467

5568
=item B<get-pause-level>
5669

57-
Get current dunst's pause level, where 0 is not paused and 100 is maximally paused.
70+
Get current dunst's pause level, where 0 is not paused and 100 is maximally
71+
paused.
5872

59-
This can be combined with notification's override_pause_level to selectively display specific notifications while paused.
73+
This can be combined with notification's override_pause_level to selectively
74+
display specific notifications while paused.
6075

6176
=item B<set-pause-level> [level]
6277

6378
Set the pause level, where 0 is not paused and 100 is maximally paused.
6479

65-
This can be combined with notification's override_pause_level to selectively display specific notifications while paused.
80+
This can be combined with notification's override_pause_level to selectively
81+
display specific notifications while paused.
82+
83+
=item B<rule> rule_name enable/disable/toggle
84+
85+
Enables, disables or toggles the rule identified by its name. This can be used
86+
to temporarily activate or deactivate specific rules.
6687

6788
=item B<debug>
6889

6990
Tries to contact dunst and checks for common faults between dunstctl and dunst.
70-
Useful if something isn't working
91+
Useful if something isn't working.
7192

7293
=item B<help>
7394

74-
Show all available commands with a brief description
95+
Show all available commands with a brief description.
7596

7697
=back
77-

0 commit comments

Comments
 (0)