From 43f03a2909e59b87e575dc191aa71ba54b920201 Mon Sep 17 00:00:00 2001
From: Philipp Gesang <philipp.gesang@intra2net.com>
Date: Thu, 4 Apr 2019 17:23:08 +0200
Subject: [PATCH] document timefunc api

---
 src/timefunc.cpp |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)

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
     {
-- 
1.7.1