improve document for {func}
more tests