changed paces function name & added documentation