man: Add initial sdsnew(3) manpage

2 files changed, 35 insertions, 0 deletions

diff --git a/docs/sds.rst b/docs/sds.rst
index 7dd17d0..095906f 100644
--- a/docs/sds.rst
+++ b/docs/sds.rst
@@ -6,3 +6,4 @@ sds
 Functions
 ---------
 
+:manpage:`sdsnew(3)`, :manpage:`sdsnewlen(3)`
diff --git a/docs/sdsnew.rst b/docs/sdsnew.rst
new file mode 100644
index 0000000..7217b2c
--- /dev/null
+++ b/docs/sdsnew.rst
@@ -0,0 +1,34 @@
+:orphan:
+
+sdsnew
+======
+
+Synopsis
+--------
+
+.. c:function:: #include <sds.h>
+
+.. c:function:: sds sdsnew(const char *init)
+                sds sdsnewlen(const void *init, size_t initlen)
+
+
+Description
+-----------
+
+The function :c:func:`sdsnew()` creates an SDS string from a C null terminated string.
+
+The function :c:func:`sdsnewlen()` is similar to :c:func:`sdsnew()` but
+instead of creating the string assuming that the input string is null
+terminated, it gets an additional length parameter. This way you can create a
+string from binary data.
+
+Return value
+------------
+
+Upon successful completion, these functions will allocate and return a new SDS
+string. If the allocation fails they will return :c:data:`NULL`.
+
+See also
+--------
+
+:manpage:`sds(3)`