From: Jelte Jansen <jelte@isc.org>
Date: Wed, 25 Jul 2012 09:47:54 +0000 (+0200)
Subject: [2148] update doxygen for constructor
X-Git-Tag: trac2351_base~157^2~8
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6f60dbc93743cb7f2f245ebc7d69bb31dec11bcf;p=thirdparty%2Fkea.git

[2148] update doxygen for constructor
---

diff --git a/src/lib/dns/labelsequence.h b/src/lib/dns/labelsequence.h
index ca30c46e78..b81116e145 100644
--- a/src/lib/dns/labelsequence.h
+++ b/src/lib/dns/labelsequence.h
@@ -92,6 +92,18 @@ public:
     /// labelsequence into the given external buffer, which is subsequently
     /// extendable by calling extend()
     ///
+    /// The data is placed into the given buffer as follows:
+    /// - binary sequence of name data, starting at position 0,
+    ///   length determined by source LabelSequence
+    /// - offsets, starting at position Name::MAX_WIRE, length
+    ///   determined by source LabelSequence
+    /// The offsets are updated to be correct for the potentially partial
+    /// name data (as stripLeft() and stripRight may have been called on
+    /// the source LabelSequence).
+    ///
+    /// \note The given buf MUST remain in scope during the lifetime of
+    /// the LabelSequence created here.
+    ///
     /// \param src LabelSequence to copy the initial data from
     /// \param buf external buffer to store this labelsequence's data in
     LabelSequence(const LabelSequence& src, uint8_t buf[MAX_SERIALIZED_LENGTH]);