documentation incomplete?

Hello,

Debian ships a GNUTLS pdf book in the package gnutls-doc.

In the foreword it says it aims to be self-contained.

I tried to implement gnutls in a program based on the manual (as
opposed to ripping a working code from another program as suggested in
some places on the net).

This was a terrible experience.

There is not much in the way of explanation of most return values that
contain any complex information, and the examples are grossly
incomplete.

First off I tried the example with anonymous authentication which of
course does not work. A notice that even services that do not require
client authentication (such as most https servers) typically don't
support anonymous authentication either would be quite helpful in the
manual. That client example is kind of useless because you need to
build a matching server to run it which is not included.

Second comes x509 client which should work in normal environments.

This somewhat differs for version 2 and 3 of the docs.

The v2 docs have a client with authentication and no verification and
a client with verification only, the v3 a client with both and a
separate verification function.