From e90aa50001b8014497651628666455ab5c12c7b0 Mon Sep 17 00:00:00 2001
From: Federico Mena Quintero <federico@helixcode.com>
Date: Tue, 19 Dec 2000 18:13:34 +0000
Subject: Added proper dependency lists to the gtk-doc mess.

2000-12-19  Federico Mena Quintero  <federico@helixcode.com>

	Added proper dependency lists to the gtk-doc mess.

	* calendar/cal-client/Makefile.am (TARGET_DIR): Removed unused
	variable.
	(SOURCE_FILES): New variable with the list of source files we
	depend on.
	(IGNORED_SOURCE_HEADERS): New variable with the headers we ignore
	for the gtkdoc-scan phase.
	(scan_generated):
	(tmpl_dependencies):
	(tmpl_sources):
	(tmpl_generated);
	(sgml_dependencies):
	(sgml_generated): Lists of stuff that is generated and that other
	stuff depends on.
	(all): Added the $(sgml_generated) as the final target.
	(install-data-local): Added an installation hook; gtk-doc seems to
	want some of its generated files to be installed.

	* calendar/cal-client/evolution-cal-client-sections.txt: Updated.

	* calendar/cal-util/Makefile.am: Made the same changes as for
	calendar/cal-client/Makefile.am.

	* calendar/cal-util/evolution-cal-util-sections.txt: Updated.

	* Makefile.am (local_entities): Added alarm-generation.sgml.
	(all): Made the main target be the html/index.html.

svn path=/trunk/; revision=7084
---
 .../calendar/cal-util/tmpl/cal-component.sgml      | 189 ++++++++++-------
 doc/devel/calendar/cal-util/tmpl/cal-recur.sgml    |  52 +----
 doc/devel/calendar/cal-util/tmpl/cal-util.sgml     |  14 --
 .../cal-util/tmpl/evolution-cal-util-unused.sgml   | 231 +++++++++++++++++++++
 doc/devel/calendar/cal-util/tmpl/timeutil.sgml     |  84 --------
 5 files changed, 351 insertions(+), 219 deletions(-)

(limited to 'doc/devel/calendar/cal-util/tmpl')

diff --git a/doc/devel/calendar/cal-util/tmpl/cal-component.sgml b/doc/devel/calendar/cal-util/tmpl/cal-component.sgml
index 56a04b02a0..c429e22a9c 100644
--- a/doc/devel/calendar/cal-util/tmpl/cal-component.sgml
+++ b/doc/devel/calendar/cal-util/tmpl/cal-component.sgml
@@ -85,7 +85,6 @@ RFC 2445 iCalendar component object.
 
 @CAL_COMPONENT_NO_TYPE: Returned from cal_component_get_vtype() to
   indicate an uninitialized #CalComponent object.
-
 @CAL_COMPONENT_EVENT: Indicates a VEVENT component.
 @CAL_COMPONENT_TODO: Indicates a VTODO component.
 @CAL_COMPONENT_JOURNAL: Indicates a VJOURNAL component.
@@ -126,11 +125,9 @@ RFC 2445 iCalendar component object.
 
 @CAL_COMPONENT_CLASS_NONE: Indicates that no access classification has
     been set for the corresponding component.
-
 @CAL_COMPONENT_CLASS_PUBLIC: Public access.
 @CAL_COMPONENT_CLASS_PRIVATE: Private access.
 @CAL_COMPONENT_CLASS_CONFIDENTIAL: Confidential access.
-
 @CAL_COMPONENT_CLASS_UNKNOWN: Unknown access classification value,
   used when &libical; returns something #CalComponent does not know
   about.
@@ -148,7 +145,6 @@ RFC 2445 iCalendar component object.
 
 @CAL_COMPONENT_PERIOD_DATETIME: Indicates that the period is specified
   by starting and ending date/time values.
-
 @CAL_COMPONENT_PERIOD_DURATION: Indicates that the period is specified
   as a starding date/time and a duration value.
 
@@ -175,18 +171,6 @@ RFC 2445 iCalendar component object.
 @CAL_COMPONENT_TRANSP_OPAQUE: 
 @CAL_COMPONENT_TRANSP_UNKNOWN: 
 
-<!-- ##### STRUCT CalComponentAlarm ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### STRUCT CalComponentPrivate ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### FUNCTION cal_component_gen_uid ##### -->
 <para>
 
@@ -482,6 +466,15 @@ RFC 2445 iCalendar component object.
 @exdate_list: 
 
 
+<!-- ##### FUNCTION cal_component_has_exdates ##### -->
+<para>
+
+</para>
+
+@comp: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cal_component_get_exrule_list ##### -->
 <para>
 
@@ -491,6 +484,15 @@ RFC 2445 iCalendar component object.
 @recur_list: 
 
 
+<!-- ##### FUNCTION cal_component_get_exrule_property_list ##### -->
+<para>
+
+</para>
+
+@comp: 
+@recur_list: 
+
+
 <!-- ##### FUNCTION cal_component_set_exrule_list ##### -->
 <para>
 
@@ -500,6 +502,24 @@ RFC 2445 iCalendar component object.
 @recur_list: 
 
 
+<!-- ##### FUNCTION cal_component_has_exrules ##### -->
+<para>
+
+</para>
+
+@comp: 
+@Returns: 
+
+
+<!-- ##### FUNCTION cal_component_has_exceptions ##### -->
+<para>
+
+</para>
+
+@comp: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cal_component_get_geo ##### -->
 <para>
 
@@ -608,7 +628,7 @@ RFC 2445 iCalendar component object.
 @recur_list: 
 
 
-<!-- ##### FUNCTION cal_component_set_rrule_list ##### -->
+<!-- ##### FUNCTION cal_component_get_rrule_property_list ##### -->
 <para>
 
 </para>
@@ -617,121 +637,121 @@ RFC 2445 iCalendar component object.
 @recur_list: 
 
 
-<!-- ##### FUNCTION cal_component_has_rrules ##### -->
+<!-- ##### FUNCTION cal_component_set_rrule_list ##### -->
 <para>
 
 </para>
 
 @comp: 
-@Returns: 
+@recur_list: 
 
 
-<!-- ##### FUNCTION cal_component_get_sequence ##### -->
+<!-- ##### FUNCTION cal_component_has_rrules ##### -->
 <para>
 
 </para>
 
 @comp: 
-@sequence: 
+@Returns: 
 
 
-<!-- ##### FUNCTION cal_component_set_sequence ##### -->
+<!-- ##### FUNCTION cal_component_has_recurrences ##### -->
 <para>
 
 </para>
 
 @comp: 
-@sequence: 
+@Returns: 
 
 
-<!-- ##### FUNCTION cal_component_get_summary ##### -->
+<!-- ##### FUNCTION cal_component_get_sequence ##### -->
 <para>
 
 </para>
 
 @comp: 
-@summary: 
+@sequence: 
 
 
-<!-- ##### FUNCTION cal_component_set_summary ##### -->
+<!-- ##### FUNCTION cal_component_set_sequence ##### -->
 <para>
 
 </para>
 
 @comp: 
-@summary: 
+@sequence: 
 
 
-<!-- ##### FUNCTION cal_component_get_transparency ##### -->
+<!-- ##### FUNCTION cal_component_get_status ##### -->
 <para>
 
 </para>
 
 @comp: 
-@transp: 
+@status: 
 
 
-<!-- ##### FUNCTION cal_component_set_transparency ##### -->
+<!-- ##### FUNCTION cal_component_set_status ##### -->
 <para>
 
 </para>
 
 @comp: 
-@transp: 
+@status: 
 
 
-<!-- ##### FUNCTION cal_component_get_url ##### -->
+<!-- ##### FUNCTION cal_component_get_summary ##### -->
 <para>
 
 </para>
 
 @comp: 
-@url: 
+@summary: 
 
 
-<!-- ##### FUNCTION cal_component_set_url ##### -->
+<!-- ##### FUNCTION cal_component_set_summary ##### -->
 <para>
 
 </para>
 
 @comp: 
-@url: 
+@summary: 
 
 
-<!-- ##### FUNCTION cal_component_get_pilot_id ##### -->
+<!-- ##### FUNCTION cal_component_get_transparency ##### -->
 <para>
 
 </para>
 
 @comp: 
-@pilot_id: 
+@transp: 
 
 
-<!-- ##### FUNCTION cal_component_set_pilot_id ##### -->
+<!-- ##### FUNCTION cal_component_set_transparency ##### -->
 <para>
 
 </para>
 
 @comp: 
-@pilot_id: 
+@transp: 
 
 
-<!-- ##### FUNCTION cal_component_get_pilot_status ##### -->
+<!-- ##### FUNCTION cal_component_get_url ##### -->
 <para>
 
 </para>
 
 @comp: 
-@pilot_status: 
+@url: 
 
 
-<!-- ##### FUNCTION cal_component_set_pilot_status ##### -->
+<!-- ##### FUNCTION cal_component_set_url ##### -->
 <para>
 
 </para>
 
 @comp: 
-@pilot_status: 
+@url: 
 
 
 <!-- ##### FUNCTION cal_component_free_categories_list ##### -->
@@ -822,41 +842,62 @@ RFC 2445 iCalendar component object.
 @text_list: 
 
 
-<!-- ##### ENUM CalComponentAlarmAction ##### -->
+<!-- ##### STRUCT CalComponentAlarm ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF CalAlarmInstance ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF CalComponentAlarms ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM CalAlarmAction ##### -->
 <para>
 
 </para>
 
-@CAL_COMPONENT_ALARM_NONE: 
-@CAL_COMPONENT_ALARM_AUDIO: 
-@CAL_COMPONENT_ALARM_DISPLAY: 
-@CAL_COMPONENT_ALARM_EMAIL: 
-@CAL_COMPONENT_ALARM_PROCEDURE: 
-@CAL_COMPONENT_ALARM_UNKNOWN: 
+@CAL_ALARM_NONE: 
+@CAL_ALARM_AUDIO: 
+@CAL_ALARM_DISPLAY: 
+@CAL_ALARM_EMAIL: 
+@CAL_ALARM_PROCEDURE: 
+@CAL_ALARM_UNKNOWN: 
 
-<!-- ##### ENUM CalComponentAlarmTriggerType ##### -->
+<!-- ##### ENUM CalAlarmTriggerType ##### -->
 <para>
 
 </para>
 
-@CAL_COMPONENT_ALARM_TRIGGER_RELATIVE: 
-@CAL_COMPONENT_ALARM_TRIGGER_ABSOLUTE: 
+@CAL_ALARM_TRIGGER_NONE: 
+@CAL_ALARM_TRIGGER_RELATIVE_START: 
+@CAL_ALARM_TRIGGER_RELATIVE_END: 
+@CAL_ALARM_TRIGGER_ABSOLUTE: 
 
-<!-- ##### ENUM CalComponentAlarmTriggerRelated ##### -->
+<!-- ##### TYPEDEF CalAlarmTrigger ##### -->
 <para>
 
 </para>
 
-@CAL_COMPONENT_ALARM_TRIGGER_RELATED_START: 
-@CAL_COMPONENT_ALARM_TRIGGER_RELATED_END: 
 
-<!-- ##### TYPEDEF CalComponentAlarmTrigger ##### -->
+<!-- ##### FUNCTION cal_component_has_alarms ##### -->
 <para>
 
 </para>
 
+@comp: 
+@Returns: 
+
 
-<!-- ##### FUNCTION cal_component_get_first_alarm ##### -->
+<!-- ##### FUNCTION cal_component_get_alarm_uids ##### -->
 <para>
 
 </para>
@@ -865,12 +906,13 @@ RFC 2445 iCalendar component object.
 @Returns: 
 
 
-<!-- ##### FUNCTION cal_component_get_next_alarm ##### -->
+<!-- ##### FUNCTION cal_component_get_alarm ##### -->
 <para>
 
 </para>
 
 @comp: 
+@auid: 
 @Returns: 
 
 
@@ -882,16 +924,24 @@ RFC 2445 iCalendar component object.
 @alarm: 
 
 
-<!-- ##### FUNCTION cal_component_alarm_get_action ##### -->
+<!-- ##### FUNCTION cal_component_alarms_free ##### -->
+<para>
+
+</para>
+
+@alarms: 
+
+
+<!-- ##### FUNCTION cal_component_alarm_get_uid ##### -->
 <para>
 
 </para>
 
 @alarm: 
-@action: 
+@Returns: 
 
 
-<!-- ##### FUNCTION cal_component_alarm_set_action ##### -->
+<!-- ##### FUNCTION cal_component_alarm_get_action ##### -->
 <para>
 
 </para>
@@ -900,16 +950,16 @@ RFC 2445 iCalendar component object.
 @action: 
 
 
-<!-- ##### FUNCTION cal_component_alarm_get_trigger ##### -->
+<!-- ##### FUNCTION cal_component_alarm_set_action ##### -->
 <para>
 
 </para>
 
 @alarm: 
-@trigger: 
+@action: 
 
 
-<!-- ##### FUNCTION cal_component_alarm_set_trigger ##### -->
+<!-- ##### FUNCTION cal_component_alarm_get_trigger ##### -->
 <para>
 
 </para>
@@ -918,17 +968,12 @@ RFC 2445 iCalendar component object.
 @trigger: 
 
 
-<!-- ##### FUNCTION cal_component_alarm_free_trigger ##### -->
+<!-- ##### FUNCTION cal_component_alarm_set_trigger ##### -->
 <para>
 
 </para>
 
+@alarm: 
 @trigger: 
 
 
-<!--
-Local variables:
-mode: sgml
-sgml-parent-document: ("../../../evolution-devel-guide.sgml" "book" "refsect2" "")
-End:
--->
diff --git a/doc/devel/calendar/cal-util/tmpl/cal-recur.sgml b/doc/devel/calendar/cal-util/tmpl/cal-recur.sgml
index 703f8b2b85..092b547809 100644
--- a/doc/devel/calendar/cal-util/tmpl/cal-recur.sgml
+++ b/doc/devel/calendar/cal-util/tmpl/cal-recur.sgml
@@ -14,37 +14,6 @@ cal-recur
 
 </para>
 
-<!-- ##### ENUM CalRecurType ##### -->
-<para>
-
-</para>
-
-@CAL_RECUR_YEARLY: 
-@CAL_RECUR_MONTHLY: 
-@CAL_RECUR_WEEKLY: 
-@CAL_RECUR_DAILY: 
-@CAL_RECUR_HOURLY: 
-@CAL_RECUR_MINUTELY: 
-@CAL_RECUR_SECONDLY: 
-
-<!-- ##### TYPEDEF CalRecurrence ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### STRUCT CalObjTime ##### -->
-<para>
-
-</para>
-
-@year: 
-@month: 
-@day: 
-@hour: 
-@minute: 
-@second: 
-
 <!-- ##### USER_FUNCTION CalRecurInstanceFn ##### -->
 <para>
 
@@ -52,9 +21,11 @@ cal-recur
 
 @comp: 
 @instance_start: 
-@instace_end: 
+@instance_end: 
 @data: 
 @Returns: 
+<!-- # Unused Parameters # -->
+@instace_end: 
 
 
 <!-- ##### FUNCTION cal_recur_generate_instances ##### -->
@@ -69,20 +40,3 @@ cal-recur
 @cb_data: 
 
 
-<!-- ##### FUNCTION cal_recur_from_icalrecurrencetype ##### -->
-<para>
-
-</para>
-
-@ir: 
-@Returns: 
-
-
-<!-- ##### FUNCTION cal_recur_free ##### -->
-<para>
-
-</para>
-
-@r: 
-
-
diff --git a/doc/devel/calendar/cal-util/tmpl/cal-util.sgml b/doc/devel/calendar/cal-util/tmpl/cal-util.sgml
index bc349a377f..ccd35fac2e 100644
--- a/doc/devel/calendar/cal-util/tmpl/cal-util.sgml
+++ b/doc/devel/calendar/cal-util/tmpl/cal-util.sgml
@@ -28,20 +28,6 @@ Miscellaneous utilities
 @list: 
 
 
-<!-- ##### TYPEDEF CalAlarmInstance ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION cal_alarm_instance_list_free ##### -->
-<para>
-
-</para>
-
-@list: 
-
-
 <!-- ##### ENUM CalObjType ##### -->
 <para>
 
diff --git a/doc/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml b/doc/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml
index e69de29bb2..f2c70d526d 100644
--- a/doc/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml
+++ b/doc/devel/calendar/cal-util/tmpl/evolution-cal-util-unused.sgml
@@ -0,0 +1,231 @@
+<!-- ##### ENUM CalComponentAlarmTriggerRelated ##### -->
+<para>
+
+</para>
+
+@CAL_COMPONENT_ALARM_TRIGGER_RELATED_START: 
+@CAL_COMPONENT_ALARM_TRIGGER_RELATED_END: 
+
+<!-- ##### FUNCTION cal_recur_free ##### -->
+<para>
+
+</para>
+
+@r: 
+
+<!-- ##### ENUM CalRecurType ##### -->
+<para>
+
+</para>
+
+@CAL_RECUR_YEARLY: 
+@CAL_RECUR_MONTHLY: 
+@CAL_RECUR_WEEKLY: 
+@CAL_RECUR_DAILY: 
+@CAL_RECUR_HOURLY: 
+@CAL_RECUR_MINUTELY: 
+@CAL_RECUR_SECONDLY: 
+
+<!-- ##### TYPEDEF CalComponentAlarmTrigger ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION cal_component_get_pilot_id ##### -->
+<para>
+
+</para>
+
+@comp: 
+@pilot_id: 
+
+<!-- ##### FUNCTION get_time_t_hour ##### -->
+<para>
+
+</para>
+
+@t: 
+@Returns: 
+
+<!-- ##### FUNCTION cal_component_alarm_free_trigger ##### -->
+<para>
+
+</para>
+
+@trigger: 
+
+
+<!--
+Local variables:
+mode: sgml
+sgml-parent-document: ("../../../evolution-devel-guide.sgml" "book" "refsect2" "")
+End:
+-->
+
+<!-- ##### FUNCTION time_day_hour ##### -->
+<para>
+
+</para>
+
+@t: 
+@hour: 
+@Returns: 
+
+<!-- ##### FUNCTION time_from_isodate ##### -->
+<para>
+
+</para>
+
+@str: 
+@Returns: 
+
+<!-- ##### FUNCTION cal_component_get_pilot_status ##### -->
+<para>
+
+</para>
+
+@comp: 
+@pilot_status: 
+
+<!-- ##### STRUCT CalObjTime ##### -->
+<para>
+
+</para>
+
+@year: 
+@month: 
+@day: 
+@hour: 
+@minute: 
+@second: 
+
+<!-- ##### STRUCT CalComponentPrivate ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM CalComponentAlarmTriggerType ##### -->
+<para>
+
+</para>
+
+@CAL_COMPONENT_ALARM_TRIGGER_RELATIVE: 
+@CAL_COMPONENT_ALARM_TRIGGER_ABSOLUTE: 
+
+<!-- ##### FUNCTION cal_recur_from_icalrecurrencetype ##### -->
+<para>
+
+</para>
+
+@ir: 
+@Returns: 
+
+<!-- ##### FUNCTION cal_alarm_instance_list_free ##### -->
+<para>
+
+</para>
+
+@list: 
+
+<!-- ##### FUNCTION isodiff_to_secs ##### -->
+<para>
+
+</para>
+
+@str: 
+@Returns: 
+
+<!-- ##### FUNCTION cal_component_get_first_alarm ##### -->
+<para>
+
+</para>
+
+@comp: 
+@Returns: 
+
+<!-- ##### TYPEDEF CalRecurrence ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION time_from_icaltimetype ##### -->
+<para>
+
+</para>
+
+@itt: 
+@Returns: 
+
+<!-- ##### FUNCTION cal_component_get_next_alarm ##### -->
+<para>
+
+</para>
+
+@comp: 
+@Returns: 
+
+<!-- ##### ENUM CalComponentAlarmAction ##### -->
+<para>
+
+</para>
+
+@CAL_COMPONENT_ALARM_NONE: 
+@CAL_COMPONENT_ALARM_AUDIO: 
+@CAL_COMPONENT_ALARM_DISPLAY: 
+@CAL_COMPONENT_ALARM_EMAIL: 
+@CAL_COMPONENT_ALARM_PROCEDURE: 
+@CAL_COMPONENT_ALARM_UNKNOWN: 
+
+<!-- ##### FUNCTION time_from_start_duration ##### -->
+<para>
+
+</para>
+
+@start: 
+@duration: 
+@Returns: 
+
+<!-- ##### FUNCTION cal_component_set_pilot_id ##### -->
+<para>
+
+</para>
+
+@comp: 
+@pilot_id: 
+
+<!-- ##### FUNCTION isodiff_from_secs ##### -->
+<para>
+
+</para>
+
+@secs: 
+@Returns: 
+
+<!-- ##### FUNCTION format_simple_hour ##### -->
+<para>
+
+</para>
+
+@hour: 
+@use_am_pm: 
+@Returns: 
+
+<!-- ##### FUNCTION cal_component_set_pilot_status ##### -->
+<para>
+
+</para>
+
+@comp: 
+@pilot_status: 
+
+<!-- ##### FUNCTION parse_date ##### -->
+<para>
+
+</para>
+
+@str: 
+@Returns: 
+
diff --git a/doc/devel/calendar/cal-util/tmpl/timeutil.sgml b/doc/devel/calendar/cal-util/tmpl/timeutil.sgml
index 3b62fbba3f..2b197ad685 100644
--- a/doc/devel/calendar/cal-util/tmpl/timeutil.sgml
+++ b/doc/devel/calendar/cal-util/tmpl/timeutil.sgml
@@ -14,34 +14,6 @@ timeutil
 
 </para>
 
-<!-- ##### FUNCTION time_from_icaltimetype ##### -->
-<para>
-
-</para>
-
-@itt: 
-@Returns: 
-
-
-<!-- ##### FUNCTION time_from_isodate ##### -->
-<para>
-
-</para>
-
-@str: 
-@Returns: 
-
-
-<!-- ##### FUNCTION time_from_start_duration ##### -->
-<para>
-
-</para>
-
-@start: 
-@duration: 
-@Returns: 
-
-
 <!-- ##### FUNCTION isodate_from_time_t ##### -->
 <para>
 
@@ -51,33 +23,6 @@ timeutil
 @Returns: 
 
 
-<!-- ##### FUNCTION get_time_t_hour ##### -->
-<para>
-
-</para>
-
-@t: 
-@Returns: 
-
-
-<!-- ##### FUNCTION isodiff_to_secs ##### -->
-<para>
-
-</para>
-
-@str: 
-@Returns: 
-
-
-<!-- ##### FUNCTION isodiff_from_secs ##### -->
-<para>
-
-</para>
-
-@secs: 
-@Returns: 
-
-
 <!-- ##### FUNCTION time_add_minutes ##### -->
 <para>
 
@@ -128,16 +73,6 @@ timeutil
 @Returns: 
 
 
-<!-- ##### FUNCTION format_simple_hour ##### -->
-<para>
-
-</para>
-
-@hour: 
-@use_am_pm: 
-@Returns: 
-
-
 <!-- ##### FUNCTION time_days_in_month ##### -->
 <para>
 
@@ -159,16 +94,6 @@ timeutil
 @Returns: 
 
 
-<!-- ##### FUNCTION time_day_hour ##### -->
-<para>
-
-</para>
-
-@t: 
-@hour: 
-@Returns: 
-
-
 <!-- ##### FUNCTION time_year_begin ##### -->
 <para>
 
@@ -241,15 +166,6 @@ timeutil
 @Returns: 
 
 
-<!-- ##### FUNCTION parse_date ##### -->
-<para>
-
-</para>
-
-@str: 
-@Returns: 
-
-
 <!-- ##### FUNCTION print_time_t ##### -->
 <para>
 
-- 
cgit v1.2.3