This commit also add more information within the example section of the c api and take into account the PR review of #61.