Here are some notes you might want to put in the documentation under the appropriate sections:


* If you are compiling a program under Microsoft Visual C and you are using the graphics library, you will have to call a function right after the MAIN function. This function is END_OF_MAIN. This is for allegro to use as a macro to avoid using the WinMain entry point.

eg

SUB MAIN
   SCREEN 13
   PSET (1,1),4

   SCREEN -1
END MAIN
END_OF_MAIN

And thats it


* Windows console applications will close straight away after the program is finished is run in a window. To view the application after it's finished, call a fullscreen command prompt, and run the app from there. DJGPP doesn't have this problem when run under a window in Windows.


* For programs that use the graphics library, after calling STD_Initialize, call allegro_init as well. Fortunately, this shut's down automatically when the program closes, so there no need to shut it down manually.


* For programs that use the graphics library, MAKE SURE you call SCREEN -1 at the end of the program. This basically free's the memory used by the graphics library. Calling it isn't necessary, but i'd recommend freeing the memory allocated (which can be quite big) before the program exits.