From 2fb08fe46c6de08fa199d6db89991a2f8399a55b Mon Sep 17 00:00:00 2001
From: Nick Mathewson <nickm@torproject.org>
Date: Fri, 15 Oct 2004 03:55:02 +0000
Subject: [PATCH] add documentation for smartlist_join_strings

svn:r2524
---
 src/common/util.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/common/util.c b/src/common/util.c
index f99e29df2e..613998eb8e 100644
--- a/src/common/util.c
+++ b/src/common/util.c
@@ -609,6 +609,11 @@ int smartlist_split_string(smartlist_t *sl, const char *str, const char *sep,
   return n;
 }
 
+/** Allocate and return a new string containing the concatenation of
+ * the elements of <b>sl</b>, in order, separated by <b>join</b>.  If
+ * <b>terminate</b> is true, also terminate the string with <b>join</b>.
+ * Requires that every element of <b>sl</b> is NUL-terminated string.
+ */
 char *smartlist_join_strings(smartlist_t *sl, const char *join, int terminate)
 {
   int i;