Bump mce-dev version to 1.26.1

[mce-dev] fix license and website. Contributes to JB#33684

See merge request mer-core/mce-dev!10

debian/changelog

@@ -1,3 +1,22 @@
+mce-dev (1.26.1) unstable; urgency=low
+
+  * [mce-dev] fix url. Contributes to JB#33684
+
+ -- Simo Piiroinen <simo.piiroinen@jollamobile.com>  Tue, 25 Jun 2019 10:11:01 +0300
+
+mce-dev (1.26.0) unstable; urgency=low
+
+  * [mce] Add D-Bus constants for button backlight mode. JB#42094
+  * [mce] Add missing Doxygen group name tag
+
+ -- Simo Piiroinen <simo.piiroinen@jollamobile.com>  Tue, 20 Nov 2018 12:42:26 +0200
+
+mce-dev (1.25.0) unstable; urgency=low
+
+  * [mce] Add blanking pause related D-Bus constants. JB#41340
+
+ -- Simo Piiroinen <simo.piiroinen@jollamobile.com>  Tue, 20 Mar 2018 10:07:37 +0200
+
 mce-dev (1.24.0) unstable; urgency=low
 
   * [rpmbuild] Use _smp_mflags instead of jobs macro

include/mce/dbus-names.h

@@ -356,8 +356,20 @@
  *
  * @since mce 0.5
  *
- * If display is on and lockscreen is not active, normal blanking
- * timers are stopped for 60 seconds.
+ * Normal blanking timers are stopped for 60 seconds - under roughly
+ * the following conditions:
+ *
+ * - Display is already on and lockscreen is not active
+ *
+ * - Display is already on, lockscreen is active but
+ *   compositor has notified that user interaction is expected
+ *   and the blanking prevent request originates from the same
+ *   process that owns the topmost window on screen.
+ *
+ * The exact details are subject to change and clients showld
+ * track #MCE_PREVENT_BLANK_ALLOWED_SIG signals to know when
+ * making blank prevention calls are allowed/ignored (and query
+ * the initial state with #MCE_PREVENT_BLANK_ALLOWED_GET).
  *
  * To keep display from blanking for longer periods, the client
  * needs to re-issue this call every 60 seconds.
@@ -365,9 +377,15 @@
  * When application no longer wishes to keep display from blanking,
  * it should make a #MCE_CANCEL_PREVENT_BLANK_REQ method call.
  *
- * @note If client drops from the system bus, it is handled as if
- *       the client would have made a #MCE_CANCEL_PREVENT_BLANK_REQ
- *       call.
+ * @note If client drops from the system bus, or misses the 60 second
+ *       renew period, it is handled as if the client would have made
+ *       a #MCE_CANCEL_PREVENT_BLANK_REQ method call.
+ *
+ * @note Previously mce waited exactly 60 seconds for renew calls
+ *       which meant clients had to use shorter than 60 second
+ *       renew periods to avoid hiccups. Since mce >= 1.93.0
+ *       the hard limit is 65 seconds and thus clients can schedule
+ *       renewing to occur once / 60 seconds.
  */
 # define MCE_PREVENT_BLANK_REQ             "req_display_blanking_pause"
 
@@ -397,6 +415,26 @@
  */
 # define MCE_PREVENT_BLANK_SIG             "display_blanking_pause_ind"
 
+/** Query whether MCE_PREVENT_BLANK_REQ request can be made
+ *
+ * @since 1.93.0
+ *
+ * See #MCE_PREVENT_BLANK_REQ for details.
+ *
+ * @return boolean: true for allowed, false for not allowed
+ */
+# define MCE_PREVENT_BLANK_ALLOWED_GET     "get_display_blanking_pause_allowed"
+
+/** Notify change in whether MCE_PREVENT_BLANK_REQ request can be made
+ *
+ * @since 1.93.0
+ *
+ * See #MCE_PREVENT_BLANK_REQ for details.
+ *
+ * @param boolean: true for allowed, false for not allowed
+ */
+# define MCE_PREVENT_BLANK_ALLOWED_SIG     "display_blanking_pause_allowed_ind"
+
 /*@}*/
 
 /////////////////////////////////////////////////////////////////////////////
@@ -993,6 +1031,21 @@
  */
 # define MCE_BUTTON_BACKLIGHT_CHANGE_REQ   "req_button_backlight_change"
 
+/** Request button backlight mode change
+ *
+ * @since mce 1.98.0
+ *
+ * For use from the CSD application button backlight verification test.
+ *
+ * Allows bypassing of the button backlight policy and explicitly turn
+ * the backlight on or off.
+ *
+ * @param mode int32: #MCE_BUTTON_BACKLIGHT_MODE_OFF,
+ *                    #MCE_BUTTON_BACKLIGHT_MODE_ON, or
+ *                    #MCE_BUTTON_BACKLIGHT_MODE_POLICY
+ */
+# define MCE_BUTTON_BACKLIGHT_MODE_REQ     "req_button_backlight_mode"
+
 /** Indication for change of button backlight state
  *
  * @since mce 1.90.0

include/mce/mode-names.h

@@ -703,7 +703,7 @@
 
 /////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////
-/** TKLock status replies from SystemUI
+/** @name TKLock status replies from SystemUI
  *
  *@{
  */
@@ -736,4 +736,31 @@
 
 /*@}*/
 
+/////////////////////////////////////////////////////////////////////////////
+/////////////////////////////////////////////////////////////////////////////
+/** @name Button backlight operation modes
+ *
+ *@{
+ */
+
+/** Button backlight should be turned off
+ *
+ * @since mce 1.98.0
+ */
+#define MCE_BUTTON_BACKLIGHT_MODE_OFF    0
+
+/** Button backlight should be turned on
+ *
+ * @since mce 1.98.0
+ */
+#define MCE_BUTTON_BACKLIGHT_MODE_ON     1
+
+/** Button backlight should be turned on/off according to policy
+ *
+ * @since mce 1.98.0
+ */
+#define MCE_BUTTON_BACKLIGHT_MODE_POLICY 2
+
+/*@}*/
+
 #endif /* MCE_MODE_NAMES_H_ */

mce.pc

@@ -3,7 +3,7 @@ includedir=${prefix}/include
 
 Name: mce
 Description: Mode Control Entity
-Version: 1.24.0
+Version: 1.26.1
 Requires:
 Libs:
 Cflags: -I${includedir}

rpm/mce-headers.spec

@@ -1,10 +1,10 @@
 Name:       mce-headers
 Summary:    Development files for mce
-Version:    1.24.0
+Version:    1.26.1
 Release:    1
 Group:      Development/Libraries
 License:    LGPLv2
-URL:        https://github.com/nemomobile/mce-dev
+URL:        https://git.sailfishos.org/mer-core/mce-dev
 Source0:    %{name}-%{version}.tar.bz2
 BuildRequires:  doxygen