DOC : improved add_label_near

 - added some in-line comments to explain what is going on