Add man pages, readme, and nonnull attributes and fix documentation typos

Signed-off-by: Mattias Andrée <maandree@kth.se>

1 files changed, 58 insertions, 0 deletions

diff --git a/libar2_version_to_string_proper.3 b/libar2_version_to_string_proper.3
new file mode 100644
index 0000000..4d7d115
--- /dev/null
+++ b/libar2_version_to_string_proper.3
@@ -0,0 +1,58 @@
+.TH LIBAR2_VERSION_TO_STRING_PROPER 7 LIBAR2
+.SH NAME
+libar2_version_to_string_proper - Convert an Argon2 version number to a string with a dot
+
+.SH SYNOPSIS
+.nf
+#include <libar2.h>
+
+enum libar2_argon2_version {
+    LIBAR2_ARGON2_VERSION_10 = 0x10,
+    LIBAR2_ARGON2_VERSION_13 = 0x13
+};
+
+const char *libar2_version_to_string_proper(enum libar2_argon2_version \fIversion\fP);
+.fi
+.PP
+Link with
+.IR -lar2 .
+
+.SH DESCRIPTION
+The
+.BR libar2_version_to_string_proper ()
+function returns a statically allocated string that
+represents the value of the
+.I version
+parameter, which shall represent a version of the
+Argon2 family. The returned string will contain
+a dot
+.RB ( . );
+for example \(dq1.3\(dq for
+.IR LIBAR2_ARGON2_VERSION_13 .
+
+.SH RETURN VALUES
+The
+.BR libar2_version_to_string_proper ()
+function returns a statically allocated string
+as described in the
+.B DESCRIPTION
+section upon successful completion. On error,
+.I NULL
+is returned and
+.I errno
+is set to describe the error.
+
+.SH ERRORS
+The
+.BR libar2_version_to_string_proper ()
+function will fail if:
+.TP
+.B EINVAL
+.I version
+is not a supported version of Argon2.
+
+.SH SEE ALSO
+.BR libar2 (7),
+.BR libar2_version_to_string (3),
+.BR libar2_string_to_version (3),
+.BR libar2_latest_argon2_version (3)