[mod] do not use exceptions for normal behaviour
[mod] explicit failure in constructor
[doc] enhance documentation