diff --git a/src/gswe-moment.c b/src/gswe-moment.c index 117a54c..bf277cf 100644 --- a/src/gswe-moment.c +++ b/src/gswe-moment.c @@ -212,13 +212,13 @@ gswe_moment_set_timestamp(GsweMoment *moment, GsweTimestamp *timestamp) /** * gswe_moment_get_timestamp: - * @moment: The GsweMoment object of which you requent its timestamp object + * @moment: a GsweMoment object * - * Get the timestamp object of the given GsweMoment. The moment object holds a - * reference to this object, so if you need the timestamp object after moment - * is disposed, call g_object_ref() on it! + * Gets the #GsweTimestamp object associated with @moment * - * Returns: a #GsweTimestamp object assigned to the given moment + * Returns: (transfer none): the GsweTimestamp object associated with @moment. + * The returned object is used by @moment exclusively. If you need it even + * after @moment is destroyed, call g_object_ref() on it. */ GsweTimestamp * gswe_moment_get_timestamp(GsweMoment *moment) diff --git a/src/gswe-moment.h b/src/gswe-moment.h index 2af90fe..1f5dcac 100644 --- a/src/gswe-moment.h +++ b/src/gswe-moment.h @@ -188,6 +188,7 @@ GType gswe_moment_get_type(void); GsweMoment *gswe_moment_new(void); GsweMoment *gswe_moment_new_full(GsweTimestamp *timestamp, gdouble longitude, gdouble latitude, gdouble altitude, GsweHouseSystem house_system); void gswe_moment_set_timestamp(GsweMoment *moment, GsweTimestamp *timestamp); +GsweTimestamp *gswe_moment_get_timestamp(GsweMoment *moment); GList *gswe_moment_get_house_cusps(GsweMoment *moment, GError **err); gint gswe_moment_get_house(GsweMoment *moment, gdouble position, GError **err); gboolean gswe_moment_has_planet(GsweMoment *moment, GswePlanet planet);