update description
output list if format exists
new readme for v1.x