Centralized marking of month items. We now have a little utility function

Centralized marking of month items.  We now have a little utility
function to colorify the days in a month item that have events
scheduled for them.  This is currently used by the year view and
the go-to dialog.  Fixed buglets here and there.

1998-08-29  Federico Mena Quintero  <federico@nuclecu.unam.mx>

	* mark.[ch]: New files with utility functions to mark calendars
	with their events.

	* mark.c (mark_month_item): New public function to mark a month
	item with events.
	(unmark_month_item): New public function to unmark all the days in
	a month item to their default appearance.

	* year-view.c (year_view_set): Use the new unmark_month_item() and
	mark_month_item() to mark the months with events.

	* goto.c (update): New function that updates the calendar in the
	Go-to dialog by marking the days.

	* timeutil.c (time_year_begin): Modified to take a time_t value.
	(time_year_end): Likewise.
	(time_month_begin): Actually implemented this function, which was
	in the header file but not here.
	(time_days_in_month): New public function that returns the number
	of days in a month.

	* Makefile.am (gnomecal_SOURCES): Added mark.[ch] to the sources.

	* year-view.c (unmark_days): Use unmark_month_item().

	* gncal-full-day.c (gncal_full_day_destroy): Fixed crash when
	destroying the full day view.  The full day's destroy method is
	unusual in that it destroys the list of child widgets itself, as
	it does not have a remove method, so it needs to reset the list to
	NULL.

svn path=/trunk/; revision=351

1 files changed, 29 insertions, 8 deletions

diff --git a/calendar/timeutil.h b/calendar/timeutil.h
index 73b521cc20..ac006012ac 100644
--- a/calendar/timeutil.h
+++ b/calendar/timeutil.h
@@ -20,7 +20,7 @@ int    get_time_t_hour          (time_t t);
 int    isodiff_to_secs          (char *str);
 char   *isodiff_from_secs       (int secs);
 
-time_t time_add_minutes  (time_t time, int minutes);
+time_t time_add_minutes (time_t time, int minutes);
 time_t time_add_day (time_t time, int days);
 time_t time_add_week (time_t time, int weeks);
 time_t time_add_month (time_t time, int months);
@@ -33,19 +33,40 @@ time_t time_add_year (time_t time, int years);
  */
 char *format_simple_hour (int hour, int use_am_pm);
 
-/* Converts the specified date to a time_t at the start of the specified day */
+/* Returns the number of days in the specified month.  Years are full years (starting from year 1).
+ * Months are in [0, 11].
+ */
+int time_days_in_month (int year, int month);
+
+/* Converts the specified date to a time_t at the start of the specified day.  Years are full years
+ * (starting from year 1).  Months are in [0, 11].  Days are 1-based.
+ */
 time_t time_from_day (int year, int month, int day);
 
 time_t time_start_of_day (time_t t);
 time_t time_end_of_day   (time_t t);
 time_t time_day_hour     (time_t t, int hour);
-time_t time_year_begin   (int    year);
-time_t time_year_end     (int    year);
-time_t time_week_begin   (time_t t);
-time_t parse_date        (char *str);
-time_t time_month_begin  (time_t t);
-time_t time_month_end    (time_t t);
 
+/* These two functions take a time value and return the beginning or end of the corresponding year,
+ * respectively.
+ */
+time_t time_year_begin (time_t t);
+time_t time_year_end (time_t t);
+
+/* These two functions take a time value and return the beginning or end of the corresponding month,
+ * respectively.
+ */
+time_t time_month_begin (time_t t);
+time_t time_month_end (time_t t);
+
+/* These functions take a time value and return the beginning or end of the corresponding week,
+ * respectively.
+ */
+time_t time_week_begin (time_t t);
+time_t time_week_end (time_t t);
+
+time_t parse_date (char *str);
 void print_time_t (time_t t);
 
+
 #endif