Improve documentation of which IR free routines to call

In the wake of recent user confusion, we improve the docs for when to call instr_destroy() vs instr_free().