srd: last public/private fix, and docs for all publis functions.