From: Pavel Březina <pbrezina@redhat.com>
Date: Fri, 20 Apr 2012 12:29:59 +0000 (+0200)
Subject: Talloc doc: when s == NULL in _append functions
X-Git-Tag: samba-4.0.0alpha20~119
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9a474717b8a629fc96c85217290212dca4011f71;p=thirdparty%2Fsamba.git

Talloc doc: when s == NULL in _append functions
---

diff --git a/lib/talloc/talloc.h b/lib/talloc/talloc.h
index ebd2ab5d0a4..3e2e9ecc60d 100644
--- a/lib/talloc/talloc.h
+++ b/lib/talloc/talloc.h
@@ -1311,6 +1311,8 @@ char *talloc_strdup(const void *t, const char *p);
  *      talloc_set_name_const(ptr, ptr)
  * @endcode
  *
+ * If <code>s == NULL</code> then new context is created.
+ *
  * @param[in]  s        The destination to append to.
  *
  * @param[in]  a        The string you want to append.
@@ -1344,6 +1346,8 @@ char *talloc_strdup_append(char *s, const char *a);
  *      printf("%s\n", buf); // hello (buf = "hello\0world, hello")
  * @endcode
  *
+ * If <code>s == NULL</code> then new context is created.
+ *
  * @param[in]  s        The destination buffer to append to.
  *
  * @param[in]  a        The string you want to append.
@@ -1391,6 +1395,8 @@ char *talloc_strndup(const void *t, const char *p, size_t n);
  *      talloc_set_name_const(ptr, ptr)
  * @endcode
  *
+ * If <code>s == NULL</code> then new context is created.
+ *
  * @param[in]  s        The destination string to append to.
  *
  * @param[in]  a        The source string you want to append.
@@ -1427,6 +1433,8 @@ char *talloc_strndup_append(char *s, const char *a, size_t n);
  *      printf("%s\n", buf); // hello (buf = "hello\0world, hello")
  * @endcode
  *
+ * If <code>s == NULL</code> then new context is created.
+ *
  * @param[in]  s        The destination buffer to append to.
  *
  * @param[in]  a        The source string you want to append.
@@ -1533,6 +1541,8 @@ char *talloc_asprintf(const void *t, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3)
  *      talloc_set_name_const(ptr, ptr)
  * @endcode
  *
+ * If <code>s == NULL</code> then new context is created.
+ *
  * @param[in]  s        The string to append to.
  *
  * @param[in]  fmt      The format string.
@@ -1565,6 +1575,8 @@ char *talloc_asprintf_append(char *s, const char *fmt, ...) PRINTF_ATTRIBUTE(2,3
  *      printf("%s\n", buf); // hello (buf = "hello\0world, hello")
  * @endcode
  *
+ * If <code>s == NULL</code> then new context is created.
+ *
  * @param[in]  s        The string to append to
  *
  * @param[in]  fmt      The format string.