Babeltrace 2 C API documentation

NoteThe Babeltrace 2 C API documentation is not ready yet.