1 files changed, 260 insertions, 0 deletions
diff --git a/docs/reference/gtk/tmpl/gtkcalendar.sgml b/docs/reference/gtk/tmpl/gtkcalendar.sgml
new file mode 100644
index 0000000000..4ca84c2837
--- /dev/null
+++ b/docs/reference/gtk/tmpl/gtkcalendar.sgml
@@ -0,0 +1,260 @@
+<!-- ##### SECTION Title ##### -->
+GtkCalendar
+
+<!-- ##### SECTION Short_Description ##### -->
+display a calendar and/or allow the user to select a date.
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+#GtkCalendar is a widget that displays a calendar, one month at a time. 
+It can be created with gtk_calendar_new().
+</para>
+<para>
+The month and year currently displayed can be altered with 
+gtk_calendar_select_month(). The exact day can be selected from the displayed 
+month using gtk_calendar_select_day().
+</para>
+<para>
+FIXME: (check)To place a visual marker on a particular day, use
+gtk_calendar_mark_day() and to remove the marker, gtk_calendar_unmark_day().
+Alternative, all marks can be cleared with gtk_calendar_clear_marks().
+</para>
+<para>
+The way in which the calendar itself is displayed can be altered using
+gtk_calendar_display_options().
+</para>
+<para>
+The selected date can be retrieved from a #GtkCalendar using
+gtk_calendar_get_date().
+</para>
+<para>
+If performing many 'mark' operations, the calendar can be frozen to prevent
+flicker, using gtk_calendar_freeze(), and 'thawed' again using
+gtk_calendar_thaw().
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GtkCalendar ##### -->
+<para>
+<structfield>num_marked_dates</structfield> is an integer containing the
+number of days that have a mark over them.
+</para>
+<para>
+<structfield>marked_date</structfield> is an array containing the day numbers
+that currently have a mark over them.
+</para>
+<para>
+<structfield>month</structfield>, <structfield>year</structfield>, and 
+<structfield>selected_day</structfield> contain the currently visible month,
+year, and selected day respectively.
+</para>
+<para>
+All of these fields should be considered read only, and everything in this
+struct should only be modified using the functions provided below.
+</para>
+
+@widget: 
+@header_style: 
+@label_style: 
+@month: 
+@year: 
+@selected_day: 
+@day_month: 
+@day: 
+@num_marked_dates: 
+@marked_date: 
+@display_flags: 
+@marked_date_color: 
+@gc: 
+@xor_gc: 
+@focus_row: 
+@focus_col: 
+@highlight_row: 
+@highlight_col: 
+@private_data: 
+@grow_space: 
+
+<!-- ##### ENUM GtkCalendarDisplayOptions ##### -->
+<para>
+<informaltable pgwide=1 frame="none" role="enum">
+<tgroup cols="2"><colspec colwidth="*"><colspec colwidth="8*">
+<tbody>
+
+<row>
+<entry>GTK_CALENDAR_SHOW_HEADING</entry>
+<entry>Specifies that the month and year should be displayed.</entry>
+</row>
+<row>
+<entry>GTK_CALENDAR_SHOW_DAY_NAMES</entry>
+<entry>Specifies that three letter day descriptions should be present.</entry>
+</row>
+<row>
+<entry>GTK_CALENDAR_NO_MONTH_CHANGE</entry>
+<entry>Prevents the user from switching months with the calendar.</entry>
+</row>
+<row>
+<entry>GTK_CALENDAR_SHOW_WEEK_NUMBERS</entry>
+<entry>Displays each week numbers of the current year, down the left side of
+the calendar.</entry>
+</row>
+<row>
+<entry>GTK_CALENDAR_WEEK_START_MONDAY</entry>
+<entry>Starts the calendar week on Monday, instead of the default Sunday.</entry>
+</row>
+
+</tbody></tgroup></informaltable>
+</para>
+
+@GTK_CALENDAR_SHOW_HEADING: 
+@GTK_CALENDAR_SHOW_DAY_NAMES: 
+@GTK_CALENDAR_NO_MONTH_CHANGE: 
+@GTK_CALENDAR_SHOW_WEEK_NUMBERS: 
+@GTK_CALENDAR_WEEK_START_MONDAY: 
+
+<!-- ##### FUNCTION gtk_calendar_new ##### -->
+<para>
+Creates a new calendar. FIXME:default date.
+</para>
+
+@Returns: a #GtkCalendar.
+
+
+<!-- ##### FUNCTION gtk_calendar_select_month ##### -->
+<para>
+Shifts the calendar to a different month.
+</para>
+
+@calendar: a #GtkCalendar.
+@month: a month number.
+@year: the year the month is in.
+@Returns: FIXME.
+
+
+<!-- ##### FUNCTION gtk_calendar_select_day ##### -->
+<para>
+Selects a day from the current month.
+</para>
+
+@calendar: a #GtkCalendar.
+@day: the day number to select.
+
+
+<!-- ##### FUNCTION gtk_calendar_mark_day ##### -->
+<para>
+
+</para>
+
+@calendar: 
+@day: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_calendar_unmark_day ##### -->
+<para>
+
+</para>
+
+@calendar: 
+@day: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_calendar_clear_marks ##### -->
+<para>
+
+</para>
+
+@calendar: 
+
+
+<!-- ##### FUNCTION gtk_calendar_display_options ##### -->
+<para>
+
+</para>
+
+@calendar: 
+@flags: 
+
+
+<!-- ##### FUNCTION gtk_calendar_get_date ##### -->
+<para>
+
+</para>
+
+@calendar: 
+@year: 
+@month: 
+@day: 
+
+
+<!-- ##### FUNCTION gtk_calendar_freeze ##### -->
+<para>
+Locks the display of the calendar until it is thawed with gtk_calendar_thaw().
+</para>
+
+@calendar: a #GtkCalendar.
+
+
+<!-- ##### FUNCTION gtk_calendar_thaw ##### -->
+<para>
+Defrosts a calendar; all the changes made since the last
+gtk_calendar_freeze() are displayed.
+</para>
+
+@calendar: a #GtkCalendar.
+
+
+<!-- ##### SIGNAL GtkCalendar::month-changed ##### -->
+<para>
+Emitted when the user clicks a button to change the selected month on a
+calendar.
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::day-selected ##### -->
+<para>
+Emitted when the user selects a day.
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::day-selected-double-click ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::prev-month ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::next-month ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::prev-year ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::next-year ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+