Bouchnic truedot rebase

This is a rebase of gh-804.

I also add the comment in that PR in the sparse documentations.