Hello,

Sorry for my bzr-naivety. So, here is an updated patch relative to the
last revision.

I have inflated the scanty docstring with additional and hopefully
sufficient explanations.

   Vincent.