> a list of handles/artists which exist on the Axes which can be used to generate entries for the resulting legend.

There is no hedging needed. The function always works, it just doesn't always return all of the artists that have been added to the axes. I do go on to mention that not all artists can be drawn in a legend, and ideally would keep the two paragraphs separate.

Do you still want me to do this?