bug#7834: 24.0.50; doc of `put-image'

[Lars Magne Ingebrigtsen]

"Drew Adams" <drew.adams@oracle.com> writes:

> 1. The doc should mention the `put-image' property, which is the only
> way for you to recognize such an overlay AFAICT.

I've now done this.

> 2. Why not have `put-image' return the overlay itself?  That would
> simplify code such as that of `image-dired-dired-toggle-marked-thumbs',
> which, just after calling `put-image', tries to examine all overlays at
> point just to find the right one - the one with a `put-image' property.

That's a good idea.  Stefan, however, is really against primarily
side-effect-ey functions returning usable values, so we should check
with him first.

Stefan?

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/