updated README description and examples to include new `filename` parameter.