$allowLessEfficient is now true by default, added more phpdoc to method