extend usage notes with a section on debugging.