strarray: deprecate git_strarray_copy

We should not be in the business of copying strings around for users.
We either return a strarray that can be freed, or we take one (and do
not mutate it).

1 files changed, 12 insertions, 0 deletions

diff --git a/include/git2/deprecated.h b/include/git2/deprecated.h
index 5f020b399..ffef14597 100644
--- a/include/git2/deprecated.h
+++ b/include/git2/deprecated.h
@@ -535,6 +535,18 @@ typedef int GIT_CALLBACK(git_headlist_cb)(git_remote_head *rhead, void *payload)
 /**@{*/
 
 /**
+ * Copy a string array object from source to target.
+ *
+ * This function is deprecated, but there is no plan to remove this
+ * function at this time.
+ *
+ * @param tgt target
+ * @param src source
+ * @return 0 on success, < 0 on allocation failure
+ */
+GIT_EXTERN(int) git_strarray_copy(git_strarray *tgt, const git_strarray *src);
+
+/**
  * Free the memory referred to by the git_strarray.  This is an alias of
  * `git_strarray_dispose` and is preserved for backward compatibility.
  *