Git commit 30a40423cc9337857c949ec2586c368a0e43b965 by David Jarvie. Committed on 07/01/2026 at 17:34. Pushed by djarvie into branch 'master'.
Document notification inhibition override M +- -- doc/editwindow.png M +24 -13 doc/index.docbook https://invent.kde.org/pim/kalarm/-/commit/30a40423cc9337857c949ec2586c368a0e43b965 diff --git a/doc/editwindow.png b/doc/editwindow.png index b8c528f29..51dbeaccb 100644 Binary files a/doc/editwindow.png and b/doc/editwindow.png differ diff --git a/doc/index.docbook b/doc/index.docbook index 304e3db14..71282730e 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -39,8 +39,8 @@ <!-- Don't change format of date and version of the documentation --> -<date>2026-1-6</date> -<releaseinfo>3.12.0 (KDE Gear 25.12)</releaseinfo> +<date>2026-1-7</date> +<releaseinfo>3.13.0 (KDE Gear 26.04)</releaseinfo> <abstract> <para>&kalarm; is a personal alarm message, command and email scheduler by &kde;.</para> @@ -364,7 +364,7 @@ various sources:</para> <itemizedlist> <listitem> <para>To preset the alarm's date in the -<link linkend="alarm-edit-dlg">Alarm Edit dialog</link>, +<link linkend="alarm-edit-dlg-time">Alarm Edit dialog</link>, <mousebutton>right</mousebutton> click on the desired date in the alarm date selector (see <link linkend="datepicker">Filtering the Alarm List by Date</link>) and select the appropriate alarm type from the context @@ -1611,7 +1611,7 @@ change the deferred time or to cancel the deferral.</para> </sect2> -<sect2> +<sect2 id="alarm-edit-dlg-time"> <title>Time</title> <para>In the <guilabel>Time</guilabel> group box, select either</para> @@ -1691,7 +1691,7 @@ than the recurrence or sub-repetition interval.</para> </sect2> -<sect2> +<sect2 id="alarm-edit-dlg-cancel"> <title>Cancelation</title> <para>The late-cancelation options determine how an alarm is treated @@ -1731,7 +1731,7 @@ showing at the expiry of the late-cancelation time.</para> </sect2> -<sect2> +<sect2 id="alarm-edit-dlg-recur"> <title>Recurrence</title> <para>Specify whether or how the alarm should be repeated using the @@ -1953,7 +1953,7 @@ cancelled.</para></note> </sect3> </sect2> -<sect2> +<sect2 id="alarm-edit-dlg-other"> <title>Other Controls</title> <para>If the system configuration allows multiple alarms to wake the @@ -1970,6 +1970,15 @@ whether you will be prompted for confirmation when you close the alarm message window. This may be used as a safeguard against accidental acknowledgment of alarms.</para> +<para>Display alarms are normally suspended while notifications are +inhibited for the desktop, and do not display on top of full screen +applications. To override these restrictions and always display the +alarm if at all possible, select the +<guilabel>Never inhibit alarms</guilabel> check box. Note that the +ability to display messages over full screen applications may depend +on your window manager, and currently only the X11 windowing system +allows this.</para> + <para>Select <guilabel>Show in &korganizer;</guilabel> to add the alarm to &korganizer;'s active calendar, where it will appear as an event without an alarm. This option allows you to track alarms in @@ -2008,9 +2017,11 @@ depending on the option chosen in the display options are described below.</para> <para>If you inhibit notifications for the desktop, the execution of -display alarms will be suspended until notifications are re-enabled. -Note that this applies to all display alarms, regardless of whether -they are displayed in windows or as notifications.</para> +display alarms will be suspended until notifications are re-enabled, +except for alarms which you have specified in the <link +linkend="alarm-edit-dlg-other">Alarm Edit dialog</link> should never be +inhibited. Note that this applies to all display alarms, regardless +of whether they are displayed in windows or as notifications.</para> <para>Note that on a single screen system, the window manager may inhibit notifications while any application is running full screen, @@ -2036,7 +2047,7 @@ time, and the window title is <quote>Reminder</quote>.)</para> <para>Alarm message windows remain visible until you acknowledge them, unless <guilabel>Auto-close window after late-cancelation time</guilabel> was checked in the <link -linkend="alarm-edit-dlg">Alarm Edit dialog</link>. In the case of a +linkend="alarm-edit-dlg-cancel">Alarm Edit dialog</link>. In the case of a recurring alarm, if an unacknowledged message window remains from a previous occurrence of the alarm, the existing window is simply popped up when the alarm recurs. This avoids having to acknowledge multiple @@ -2549,7 +2560,7 @@ possibilities:</para> (<literal>cap_wake_alarm</literal>) capability, any number of alarms can be set to wake from suspend. In this case, wake from suspend is configured for each individual alarm in the -<link linkend="alarm-edit-dlg">Alarm Edit dialog</link> using its +<link linkend="alarm-edit-dlg-other">Alarm Edit dialog</link> using its <guilabel>Wake from suspend</guilabel> option.</para> <para>You can configure how long before the alarm to wake from suspend, @@ -2838,7 +2849,7 @@ such alarms will be output at the earliest opportunity during the options let you define your working hours, needed when the <guilabel>Only during working hours</guilabel> option is selected for a recurrence in the -<link linkend="alarm-edit-dlg">Alarm Edit dialog</link>.</para> +<link linkend="alarm-edit-dlg-recur">Alarm Edit dialog</link>.</para> <itemizedlist> <listitem><para>Check each day which is a working day.</para>
