return value added
doc for function related to SAM files