tidy up comments to clarify lib