Fix small missing pieces of documentation

3 files changed, 4 insertions, 1 deletions

diff --git a/src/libical/icalcomponent.h b/src/libical/icalcomponent.h
index 66b4526f..73b3c1a6 100644
--- a/src/libical/icalcomponent.h
+++ b/src/libical/icalcomponent.h
@@ -285,7 +285,7 @@ LIBICAL_ICAL_EXPORT void icalcomponent_foreach_recurrence(icalcomponent *comp,
  */
 LIBICAL_ICAL_EXPORT void icalcomponent_normalize(icalcomponent *comp);
 
-/*
+/**
  * Computes the datetime corresponding to the specified @p icalproperty and @p icalcomponent.
  * If the property is a DATE-TIME with a TZID parameter and a corresponding VTIMEZONE
  * is present in the component, the returned component will already be in the correct
diff --git a/src/libical/icalparser.h b/src/libical/icalparser.h
index 1c0571b9..8d684c07 100644
--- a/src/libical/icalparser.h
+++ b/src/libical/icalparser.h
@@ -318,6 +318,7 @@ LIBICAL_ICAL_EXPORT icalcomponent *icalparser_parse_string(const char *str);
 
 /**
  * @brief Given a line generator function, returns a single iCal content line.
+ * @return A pointer to a single line of data or `NULL` if it reached
  *  end of file reading from the @a line_gen_func. Note that the pointer
  *  returned is owned by libical and must not be `free()`d by the user.
  * @param parser The parser object to use
diff --git a/src/libical/icalperiod.h b/src/libical/icalperiod.h
index 5c62ebc6..6f2be741 100644
--- a/src/libical/icalperiod.h
+++ b/src/libical/icalperiod.h
@@ -148,6 +148,7 @@ LIBICAL_ICAL_EXPORT struct icalperiodtype icalperiodtype_null_period(void);
 
 /**
  * Checks if a given ::icalperiodtype is a null period.
+ * @param p The time period to check
  * @return 1 if @a p is a null period, 0 otherwise
  * @sa icalperiodtype_null_period()
  *
@@ -164,6 +165,7 @@ LIBICAL_ICAL_EXPORT int icalperiodtype_is_null_period(struct icalperiodtype p);
 
 /**
  * Checks if a given ::icalperiodtype is a valid period.
+ * @param p The time period to check
  * @return 1 if @a p is a valid period, 0 otherwise
  *
  * ### Usage