generic versions of build() methods
minor documentation/tool update