From 81d3a025256f2634a51a226df28ae40fafb50de6 Mon Sep 17 00:00:00 2001 From: Johannes Löthberg Date: Sun, 18 Jan 2015 21:24:08 +0100 Subject: man: Add initial sdsnew(3) manpage --- Makefile | 2 +- docs/sds.rst | 1 + docs/sdsnew.rst | 34 ++++++++++++++++++++++++++++++++++ 3 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 docs/sdsnew.rst diff --git a/Makefile b/Makefile index 2582aa9..cf14213 100644 --- a/Makefile +++ b/Makefile @@ -3,7 +3,7 @@ CC = clang SOURCES = src/twbctf.c src/sds.c HEADERS = src/twbctf.h src/sds.h -MANPAGES = docs/sds.3 +MANPAGES = docs/sds.3 docs/sdsnew.3 all: sds-test $(MANPAGES) 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 + +.. 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)` -- cgit v1.2.3-54-g00ecf