evolution-data-server r9148 - in trunk/calendar: . libecal

[abharath svn gnome org]

Author: abharath
Date: Sun Jul 20 18:59:02 2008
New Revision: 9148
URL: http://svn.gnome.org/viewvc/evolution-data-server?rev=9148&view=rev

Log:
Committing on behalf of Paul Bolle  <pebolle tiscali nl>

2008-07-21  Paul Bolle  <pebolle tiscali nl>

       ** Fix for bug #543066

       * libecal/e-cal-util.c: (e_cal_util_parse_ics_string),
       (e_cal_util_parse_ics_file): Make the documentation reflect that these
       functions either return a new icalcomponent or NULL.



Modified:
   trunk/calendar/ChangeLog
   trunk/calendar/libecal/e-cal-util.c

Modified: trunk/calendar/libecal/e-cal-util.c
==============================================================================
--- trunk/calendar/libecal/e-cal-util.c	(original)
+++ trunk/calendar/libecal/e-cal-util.c	Sun Jul 20 18:59:02 2008
@@ -156,12 +156,13 @@
  * e_cal_util_parse_ics_string:
  * @string: iCalendar string to be parsed.
  *
- * Parses an iCalendar stirng and returns an #icalcomponent representing that
- * string. Note that this function deals with multiple VCALENDAR's in the
+ * Parses an iCalendar string and returns a new #icalcomponent representing
+ * that string. Note that this function deals with multiple VCALENDAR's in the
  * string, something that Mozilla used to do and which libical does not
  * support.
  *
- * Return value: an #icalcomponent.
+ * Return value: a newly created #icalcomponent or NULL if the string isn't a
+ * valid iCalendar string.
  */
 icalcomponent *
 e_cal_util_parse_ics_string (const char *string)
@@ -221,9 +222,10 @@
  * @filename: Name of the file to be parsed.
  *
  * Parses the given file, and, if it contains a valid iCalendar object,
- * parse it and return a corresponding #icalcomponent.
+ * parse it and return a new #icalcomponent.
  *
- * Return value: an #icalcomponent.
+ * Return value: a newly created #icalcomponent or NULL if the file doesn't
+ * contain a valid iCalendar object.
  */
 icalcomponent *
 e_cal_util_parse_ics_file (const char *filename)