From: Amos Jeffries <squid3@treenet.co.nz>
Date: Mon, 15 Sep 2008 07:56:11 +0000 (+1200)
Subject: various MemBuf documentation
X-Git-Tag: SQUID_3_1_0_1~49^2~41
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8fbd839c68dc2da72103475f9691732a56ef5901;p=thirdparty%2Fsquid.git

various MemBuf documentation
---

diff --git a/src/MemBuf.cc b/src/MemBuf.cc
index b08cb7d8a7..d5b253c503 100644
--- a/src/MemBuf.cc
+++ b/src/MemBuf.cc
@@ -226,11 +226,14 @@ void MemBuf::consume(mb_size_t shiftSize)
     PROF_stop(MemBuf_consume);
 }
 
-// calls memcpy, appends exactly size bytes, extends buffer if needed
+/**
+ * calls memcpy, appends exactly size bytes,
+ * extends buffer or creates buffer if needed.
+ */
 void MemBuf::append(const char *newContent, mb_size_t sz)
 {
     assert(sz >= 0);
-    assert(buf);
+    assert(buf || (0==capacity && 0==size));
     assert(!stolen); /* not frozen */
 
     PROF_start(MemBuf_append);
@@ -247,7 +250,7 @@ void MemBuf::append(const char *newContent, mb_size_t sz)
     PROF_stop(MemBuf_append);
 }
 
-// updates content size after external append
+/// updates content size after external append
 void MemBuf::appended(mb_size_t sz)
 {
     assert(size + sz <= capacity);