Re: [AD] Problem with remove_mouse() and video bitmaps.

[Peter Wang <tjaden@xxxxxxxxxx>]

On 2005-12-29, Andrei Ellman <ae-a-alleg@xxxxxxxxxx> wrote:
> Peter Wang wrote:
> >
> >Just to be sure, calling show_mouse(NULL); before destroying the video
> >bitmap had no negative side effects, correct?
> 
> That is correct. Adding show_mouse(NULL) also solved the problem that 
> was reported on the other machine failing to change the resolution back, 
> so it looks like the documentation needs to be changed.

How's this?  The text goes in the entry for show_mouse:

--- docs/src/allegro._tx	(revision 5645)
+++ docs/src/allegro._tx	(local)
@@ -2860,6 +2860,10 @@
    pointer whenever you draw onto the screen. This is not needed if you are
    using a hardware cursor.
 
+   Note: you must not be showing a mouse pointer on a bitmap at the time that
+   the bitmap is destroyed with destroy_bitmap(). This does not apply to
+   `screen' since you never destroy `screen' with destroy_bitmap().
+
 @@void @scare_mouse();
 @xref unscare_mouse, scare_mouse_area, show_mouse
 @shortdesc Helper for hiding the mouse pointer before drawing.