From: Heiko Voigt Date: Thu, 29 Mar 2012 07:21:22 +0000 (+0200) Subject: string-list: document that string_list_insert() inserts unique strings X-Git-Tag: v1.7.9.6~2 X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=b8939b2b3abaa99c18bf57251cd2828b89ac38c5;p=git.git string-list: document that string_list_insert() inserts unique strings Signed-off-by: Heiko Voigt Signed-off-by: Junio C Hamano --- diff --git a/Documentation/technical/api-string-list.txt b/Documentation/technical/api-string-list.txt index ce24eb96f..5a0c14fce 100644 --- a/Documentation/technical/api-string-list.txt +++ b/Documentation/technical/api-string-list.txt @@ -83,7 +83,9 @@ Functions Insert a new element to the string_list. The returned pointer can be handy if you want to write something to the `util` pointer of the - string_list_item containing the just added string. + string_list_item containing the just added string. If the given + string already exists the insertion will be skipped and the + pointer to the existing item returned. + Since this function uses xrealloc() (which die()s if it fails) if the list needs to grow, it is safe not to check the pointer. I.e. you may