Bump 3.25.1 release

NEWS

@@ -1,3 +1,6 @@
+Major changes in 3.25.1:
+* Add developer documentation
+
 Major changes in 3.24.1:
 * Added logging capabilities
 * Fix a lot of issues in Week view

configure.ac

@@ -6,7 +6,7 @@ dnl Define Versioning Information
 dnl ***********************************************************************
 m4_define([calendar_major_version],[3])
 m4_define([calendar_minor_version],[25])
-m4_define([calendar_micro_version],[0])
+m4_define([calendar_micro_version],[1])
 m4_define([calendar_version],[calendar_major_version.calendar_minor_version.calendar_micro_version])
 m4_define([calendar_interface_age],[0])
 m4_define([calendar_bugreport_url],

data/appdata/org.gnome.Calendar.appdata.xml.in

@@ -42,6 +42,19 @@
   <project_group>GNOME</project_group>
 
   <releases>
+    <release date="2017-03-20" version="3.24.1">
+      <description>
+        <p>
+          The GNOME Calendar team is proud to announce the 3.25.1 release of
+          GNOME Calendar, the first release in the next (3.26) unstable series.
+          This release contains most of the changes that landed for 3.24.1, plus
+          a few translation changes.
+        </p>
+        <p>This release also updates translations.</p>
+        <p>Thanks to all the contributors that worked on GNOME Calendar!</p>
+      </description>
+    </release>
+
     <release date="2017-03-20" version="3.24.1">
       <description>
         <p>

doc/reference/gnome-calendar-decl-list.txt

@@ -499,6 +499,7 @@ gcal_week_grid_add_event
 gcal_week_grid_remove_event
 gcal_week_grid_get_children_by_uuid
 gcal_week_grid_clear_marks
+gcal_week_grid_set_date
 GcalWeekGrid
 </SECTION>
 
@@ -513,6 +514,7 @@ gcal_week_header_remove_event
 gcal_week_header_get_children_by_uuid
 gcal_week_header_get_sidebar_size_group
 gcal_week_header_clear_marks
+gcal_week_header_set_date
 GcalWeekHeader
 </SECTION>
 

doc/reference/gnome-calendar-decl.txt

@@ -764,6 +764,11 @@ struct _GcalViewInterface
                                                         icaltimetype *start_span,
                                                         icaltimetype *end_span);
 
+  icaltimetype*  (*get_date)                           (GcalView     *view);
+
+  void           (*set_date)                           (GcalView     *view,
+                                                        icaltimetype *date);
+
   /* Marks related API */
   void           (*clear_marks)                        (GcalView    *view);
 
@@ -1164,7 +1169,7 @@ GtkPopover            *popover
 <FUNCTION>
 <NAME>uri_get_fields</NAME>
 <RETURNS>gboolean         </RETURNS>
-const gchar           *uri, gchar                **schema, gchar                **host, gchar                **path
+const gchar           *uri, gchar                **schema, gchar                **host, gchar                **path, gboolean              *is_file
 </FUNCTION>
 <FUNCTION>
 <NAME>get_source_parent_name_color</NAME>
@@ -1739,7 +1744,7 @@ void
 </STRUCT>
 <MACRO>
 <NAME>GCAL_ENABLE_TRACE</NAME>
-# define GCAL_ENABLE_TRACE 1
+# define GCAL_ENABLE_TRACE 0
 </MACRO>
 <MACRO>
 <NAME>GCAL_LOG_LEVEL_TRACE</NAME>
@@ -2210,6 +2215,11 @@ GcalWeekGrid       *self, const gchar        *uid
 <RETURNS>void                  </RETURNS>
 GcalWeekGrid       *self
 </FUNCTION>
+<FUNCTION>
+<NAME>gcal_week_grid_set_date</NAME>
+<RETURNS>void                  </RETURNS>
+GcalWeekGrid       *self, icaltimetype       *date
+</FUNCTION>
 <STRUCT>
 <NAME>GcalWeekGrid</NAME>
 </STRUCT>
@@ -2279,6 +2289,11 @@ GcalWeekHeader     *self
 <RETURNS>void                  </RETURNS>
 GcalWeekHeader     *self
 </FUNCTION>
+<FUNCTION>
+<NAME>gcal_week_header_set_date</NAME>
+<RETURNS>void                  </RETURNS>
+GcalWeekHeader     *self, icaltimetype       *date
+</FUNCTION>
 <STRUCT>
 <NAME>GcalWeekHeader</NAME>
 </STRUCT>

doc/reference/gnome-calendar-undocumented.txt

@@ -1,7 +1,7 @@
 60% symbol docs coverage.
 324 symbols documented.
-108 symbols incomplete.
+107 symbols incomplete.
-216 not documented.
+214 not documented.
 
 
 ALIGNED (<parameters>)
@@ -92,8 +92,8 @@ build_component_from_details (summary, initial_date, final_date)
 calendar_get_resource
 e_cal_data_model_remove_client (data_model)
 e_cal_data_model_subscriber_component_added (comp)
-e_strftime_fix_am_pm (str, tm, fmt, max)
+e_strftime_fix_am_pm (max, fmt, tm, str)
-e_utf8_strftime_fix_am_pm (fmt, max, str, tm)
+e_utf8_strftime_fix_am_pm (max, str, tm, fmt)
 fix_popover_menu_icons (popover)
 free_row_data (Returns)
 gcal_application_get_manager (<parameters>)
@@ -134,12 +134,12 @@ gcal_event_widget_set_date_start (date_start)
 gcal_event_widget_set_has_reminders (<parameters>)
 gcal_event_widget_set_read_only (<parameters>)
 gcal_log_init
-gcal_manager_add_source (backend, name)
+gcal_manager_add_source (name, backend)
 gcal_manager_get_default_source
 gcal_manager_get_events (range_end, range_start)
 gcal_manager_get_goa_client (manager)
 gcal_manager_get_shell_search_events (manager)
-gcal_manager_query_client_data (field, source, manager)
+gcal_manager_query_client_data (manager, field, source)
 gcal_manager_set_search_subscriber (manager)
 gcal_manager_set_shell_search_subscriber (manager)
 gcal_manager_set_subscriber (manager)
@@ -168,10 +168,8 @@ gcal_time_selector_get_time (<parameters>)
 gcal_time_selector_new
 gcal_time_selector_set_time (<parameters>)
 gcal_time_selector_set_time_format (<parameters>)
-gcal_view_get_date (<parameters>)
 gcal_view_get_final_date
 gcal_view_get_initial_date
-gcal_view_set_date (<parameters>)
 gcal_week_grid_add_event (<parameters>)
 gcal_week_grid_clear_marks (<parameters>)
 gcal_week_grid_get_children_by_uuid (<parameters>)
@@ -202,6 +200,7 @@ remove_button_clicked (Returns)
 remove_source (Returns)
 undo_remove_action (Returns)
 update_view (Returns)
+uri_get_fields (is_file)
 view_changed (object, pspec, user_data)
 
 css-code:Long_Description

doc/reference/gnome-calendar-unused.txt

@@ -1,3 +1,5 @@
+gcal_week_grid_set_date
+gcal_week_header_set_date
 e_cal_data_model_submit_thread_job(description, alert_ident, alert_arg_0)
 e_cal_data_model_subscriber_component_added(icalcomp)
 fix_popover_menu_icons(window)

doc/reference/gnome-calendar.args

@@ -398,31 +398,11 @@
 <DEFAULT></DEFAULT>
 </ARG>
 
-<ARG>
-<NAME>GcalWeekGrid::active-date</NAME>
-<TYPE>icaltimetype*</TYPE>
-<RANGE></RANGE>
-<FLAGS>rwx</FLAGS>
-<NICK>Date</NICK>
-<BLURB>The active selected date.</BLURB>
-<DEFAULT></DEFAULT>
-</ARG>
-
-<ARG>
-<NAME>GcalWeekHeader::active-date</NAME>
-<TYPE>icaltimetype*</TYPE>
-<RANGE></RANGE>
-<FLAGS>rwx</FLAGS>
-<NICK>Date</NICK>
-<BLURB>The active selected date.</BLURB>
-<DEFAULT></DEFAULT>
-</ARG>
-
 <ARG>
 <NAME>GcalWindow::active-date</NAME>
 <TYPE>icaltimetype*</TYPE>
 <RANGE></RANGE>
-<FLAGS>rwx</FLAGS>
+<FLAGS>rw</FLAGS>
 <NICK>Date</NICK>
 <BLURB>The active/selected date.</BLURB>
 <DEFAULT></DEFAULT>