From 9a474717b8a629fc96c85217290212dca4011f71 Mon Sep 17 00:00:00 2001
From: Pavel Březina <pbrezina@redhat.com>
Date: Fri, 20 Apr 2012 14:29:59 +0200
Subject: Talloc doc: when s == NULL in _append functions

---
 lib/talloc/talloc.h | 12 ++++++++++++
 1 file changed, 12 insertions(+)

(limited to 'lib')

diff --git a/lib/talloc/talloc.h b/lib/talloc/talloc.h
index ebd2ab5d0a..3e2e9ecc60 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.
-- 
cgit