improve the documentation for bamsort
mark bamcollate as deprecated in the documentation
print warning message that bamcollate is deprecated when it is run