From: Philipp Gesang <philipp.gesang@intra2net.com>
Date: Thu, 4 Apr 2019 15:23:08 +0000 (+0200)
Subject: document timefunc api
X-Git-Tag: v2.11~1^2~3
X-Git-Url: http://developer.intra2net.com/git/?p=libi2ncommon;a=commitdiff_plain;h=43f03a2909e59b87e575dc191aa71ba54b920201

document timefunc api
---

diff --git a/src/timefunc.cpp b/src/timefunc.cpp
index e41308f..0883055 100644
--- a/src/timefunc.cpp
+++ b/src/timefunc.cpp
@@ -1143,6 +1143,14 @@ namespace clock {
         return *this;
     }
 
+    /*
+     * @note    This operator is an up-assignment from a type containing less
+     *          information than the structure assigned from. Since the
+     *          operator can only be two valued we must normalize the remaining
+     *          fields to the default clock. When assigning from non-default
+     *          clocks, use the appropriate constructor and pass it the desired
+     *          id and variant so as to assign the result.
+     */
     Time &
     Time::operator= (struct timespec ts) NOEXCEPT
     {