Integrate remarks from Nicolas Boverie
Integrate Pierre-Yves Le Morvan comments in document
Update PDF version
Merge branch 'api'