Today: Beautification of the Preferences dialog. Made the menus more

Today:  Beautification of the Preferences dialog.  Made the menus more consistent
with the rest of GNOME.  Started work on the meat of the month view.  Minor fixups
on some of the other views.

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

	* prop.c (build_two_radio_group): Doh.  Set the state of the radio
	buttons properly.

	* month-view.c (month_view_time_format_changed): New public
	function that notifies the month view of a time format change.

	* gnome-cal.c (gnome_calendar_time_format_changed): New public
	function that notifies the calendar of a time format change.

	* main.c (time_format_changed): Use gnome_calendar_time_format_changed().

	* month-view.c (month_view_update): New public function to update
	the month view when an event changes.  This is still unfinished.
	(month_view_set): New public function to set the month in the
	month view.

	* gnome-cal.c (gnome_calendar_direction): Add case for month view.
	(gnome_calendar_set_view): Likewise.
	(gnome_calendar_update_all): Likewise.

	* timeutil.c (time_add_week): Implemented the time_add_week()
	function, which was on the header file.
	(time_add_month): Added public month-adding routine.

	* gnome-cal.c (gnome_calendar_get_current_view_name): Add case for
	month view.
	(gnome_calendar_goto): Likewise, and set the time on the month view.

	* month-view.c (month_view_new): Now it takes the calendar plus
	the time_t representing the month.

	* gnome-month-item.h: Added documentation on the object arguments
	for the month item.

	* month-view.c (month_view_init): Added a month/year heading to
	the month view.

	* TODO: Updated the TODO list a bit.

	* main.c (gnome_cal_file_menu): The preferences menu option should
	go in the File menu.
	(gnome_cal_edit_menu): Added stock pixmaps to the menu items.
	(gnome_cal_menu): Renamed the Calendar menu to Edit.
	(gnome_cal_help_menu): Use "About Gnomecal", not just "About".

	* prop.c (hour_activated): Notify the property box that it has changed.

svn path=/trunk/; revision=337

1 files changed, 21 insertions, 0 deletions

diff --git a/calendar/gui/gnome-month-item.h b/calendar/gui/gnome-month-item.h
index b1b11f9d01..03ba0c84a7 100644
--- a/calendar/gui/gnome-month-item.h
+++ b/calendar/gui/gnome-month-item.h
@@ -46,6 +46,27 @@ typedef enum {
 	GNOME_MONTH_ITEM_LAST       = 147	/* total number of items */
 } GnomeMonthItemChild;
 
+/* The MonthItem canvas item defines a simple monthly calendar.  It is made out of a number of
+ * canvas items, which can be accessed using the functions provided.  The monthly calendar is
+ * anchored with respect to a point.  The following arguments are available:
+ *
+ * name			type		read/write	description
+ * ------------------------------------------------------------------------------------------
+ * year			uint		RW		Full year (1-9999)
+ * month		uint		RW		Number of month (0-11)
+ * x			double		RW		X position of anchor point
+ * y			double		RW		Y position of anchor point
+ * width		double		RW		Width of calendar in canvas units
+ * height		double		RW		Height of calendar in canvas units
+ * anchor		GtkAnchorType	RW		Anchor side for calendar
+ * head_padding		double		RW		Padding inside heading boxes
+ * day_padding		double		RW		Padding inside day boxes
+ * day_names		char **		R		Array of strings corresponding to the day names (sun-sat)
+ * heading_height	double		RW		Height of headings bar in canvas units
+ * heading_anchor	GtkAnchorType	RW		Anchor side for headings inside heading boxes
+ * day_anchor		GtkAnchorType	RW		Anchor side for day numbers inside day boxes
+ * start_on_monday	boolean		RW		Specifies whether the week starts on Monday or Sunday
+ */
 
 #define GNOME_TYPE_MONTH_ITEM            (gnome_month_item_get_type ())
 #define GNOME_MONTH_ITEM(obj)            (GTK_CHECK_CAST ((obj), GNOME_TYPE_MONTH_ITEM, GnomeMonthItem))