From a9b4e0d10f691a7ca5b1105993917b3cb0112ff1 Mon Sep 17 00:00:00 2001 From: Gergely Polonkai Date: Wed, 11 Sep 2013 03:28:15 +0200 Subject: [PATCH] Added gswe_moment_get_timestamp() to the API. --- src/gswe-moment.c | 10 +++++----- src/gswe-moment.h | 1 + 2 files changed, 6 insertions(+), 5 deletions(-) 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);