diff --git a/libs/temporal/temporal/timeline.h b/libs/temporal/temporal/timeline.h
index 66b94b9554..77ef258ea1 100644
--- a/libs/temporal/temporal/timeline.h
+++ b/libs/temporal/temporal/timeline.h
@@ -142,18 +142,19 @@ class LIBTEMPORAL_API timepos_t : public int62_t  {
 	 * explicit methods with clear semantics.
 	*/
 
-	/* computes the distance between this timepos_t and @param p
+	/** Compute the distance between this timepos_t and @param p
 	 * such that: this + distance = p
 	 *
 	 * This means that if @param p is later than this, distance is positive;
 	 * if @param p is earlier than this, distance is negative.
-
+	 *
 	 * Note that the return value is a timecnt_t whose position member
 	 * is equal to the value of this. That means if the distance uses
 	 * musical time value, the distance may not have constant value
 	 * at other positions on the timeline.
-	*/
-
+	 *
+	 * @return this - @param p
+	 */
 	timecnt_t distance (timepos_t const & p) const;
 
 	/* computes a new position value that is @param d earlier than this */