haa cleanup

diff --git a/sdlhaa/debian/changelog b/sdlhaa/debian/changelog
index 92068c2..bbe58cc 100644 (file)
--- a/sdlhaa/debian/changelog
+++ b/sdlhaa/debian/changelog
@@ -1,10 +1,11 @@
 sdlhaa (1.1.0) unstable; urgency=low
 
-  * Added new HAA_SetVideoMode call; removed buggy automatic
+  * Added new HAA_SetVideoMode call; removed dangerous automatic
     fullscreen sync.
+  * Fixed issue with loss of focus in fullscreen apps.
   * Fixed Z Rotation.
 
- -- Javier S. Pedro <maemo@javispedro.com>  Mon, 29 Mar 2010 17:59:06 +0200
+ -- Javier S. Pedro <maemo@javispedro.com>  Mon, 29 Mar 2010 21:14:33 +0200
 
 sdlhaa (1.0.0) unstable; urgency=low
 

diff --git a/sdlhaa/src/SDL_haa.h b/sdlhaa/src/SDL_haa.h
index db9c5d2..7cc6217 100644 (file)
--- a/sdlhaa/src/SDL_haa.h
+++ b/sdlhaa/src/SDL_haa.h
@@ -60,7 +60,9 @@ typedef enum HAA_Actor_Pending {
        HAA_PENDING_EVERYTHING          = 0xFFU
 } HAA_Actor_Pending;
 
+/** A Hildon Animation Actor. */
 typedef struct HAA_Actor {
+       /** The associated SDL surface; you can render to it. */
        SDL_Surface * surface;
        Uint8 pending;
        Uint8 visible, opacity, gravity;
@@ -91,6 +93,7 @@ extern DECLSPEC int SDLCALL HAA_FilterEvent(const SDL_Event *event);
 
 /** Call after calling SDL_SetVideoMode() if you have any actors created
   * to ensure they're visible in the new window.
+  * If you have no actors, it does nothing.
   * @return 0 if everything went OK.
   */
 extern DECLSPEC int SDLCALL HAA_SetVideoMode(void);
@@ -106,6 +109,7 @@ extern DECLSPEC int SDLCALL HAA_SetVideoMode(void);
 extern DECLSPEC HAA_Actor* SDLCALL HAA_CreateActor(Uint32 flags,
        int width, int height, int bitsPerPixel);
 
+/** Frees an animation actor and associated surface. */
 extern DECLSPEC void SDLCALL HAA_FreeActor(HAA_Actor* actor);
 
 /** Flushes any pending position, scale, orientation, etc. changes. */