revert to default behaviour and add new option to enable appending
update documentation to reflect the changes