Doc: Syntax fixes for man pages

Hyphens used as minus signs must be escaped, and names in the NAME section must
not contain spaces.

Signed-off-by: Christian Kastner <debian@kvr.at>
Signed-off-by: David Howells <dhowells@redhat.com>
TEST: Allow skipping of tests requiring root

This way, test failures in environments where root privileges aren't
available can be avoided.

For example, Debian build daemons check the build result by running the test
suite with a non-root account after the build has completed, and any single
failure is treated as a total build failure. This is why tests were disabled
entirely until this patch was included in the Debian package.

Signed-off-by: Christian Kastner <debian@kvr.at>
Signed-off-by: David Howells <dhowells@redhat.com>
TEST: Allow skipping tests requiring installation

This is useful for running tests exlusively against the build result.

Modifing PATH and LD_LIBRARY_PATH is sufficient for most test cases, but in the
case of tests for the request2 and prequest2 subcommands, the kernel looks
for /sbin/request-key. Testing the build result would therefore require
installing it, but this is not always desirable, for example on build daemons.

Signed-off-by: Christian Kastner <debian@kvr.at>
Signed-off-by: David Howells <dhowells@redhat.com>
LIB: #include sys/types.h in keyutils.h to bring in missing types

sys/types.h needs to be #included from keyutils.h as it uses size_t, uid_t and
gid_t which are otherwise undefined.

Reported-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: David Howells <dhowells@redhat.com>