Mention the non-macro helper functions in some demos

Author: adriweb

examples/fileio_factorize/src/main.c

@@ -12,7 +12,7 @@
 void prime_factors(unsigned int n);
 
 int primes[512];
-int total_primes = 0;
+unsigned int total_primes = 0;
 
 /* Main Function */
 void main(void) {
@@ -34,7 +34,7 @@ void main(void) {
 
     /* Create a list to store the primes */
     if (!total_primes) return;
-    list_out = ti_MallocList(total_primes);
+    list_out = ti_MallocList(total_primes); // Same as ti_AllocList(total_primes, malloc)
 
     /* Write out the list of primes */
     for (i=0; i<total_primes; i++) {

examples/fileio_os_vars/src/main.c

@@ -37,23 +37,23 @@ void main(void) {
     ti_SetVar(TI_REAL_TYPE, ti_A, &my_real);
 
     /* Store the equation "2+2" into the Y1 variable */
-    my_equ = ti_MallocEqu(3);
+    my_equ = ti_MallocEqu(3); // Same as ti_AllocEqu(3, malloc)
     my_equ->data[0] = '2';
     my_equ->data[1] = tAdd;
     my_equ->data[2] = '2';
     ti_SetVar(TI_EQU_TYPE, ti_Y1, my_equ);
     free(my_equ);
 
     /* Store the list {1.5,2.5,3.5} to L1 */
-    my_list = ti_MallocList(3);
+    my_list = ti_MallocList(3); // Same as ti_AllocList(3, malloc)
     my_list->items[0] = real_1_5;
     my_list->items[1] = real_2_5;
     my_list->items[2] = real_3_5;
     ti_SetVar(TI_REAL_LIST_TYPE, ti_L1, my_list);
     free(my_list);
 
     /* Store the matrix [[2.5,2.5]] to Ans */
-    my_matrix = ti_MallocMatrix(1,2);
+    my_matrix = ti_MallocMatrix(1,2); // Same as ti_AllocMatrix(1, 2, malloc)
     matrix_element(my_matrix, 0, 0) = real_2_5;
     matrix_element(my_matrix, 0, 1) = real_2_5;
     ti_SetVar(TI_MATRIX_TYPE, ti_Ans, my_matrix);

examples/gfx_rletsprite/src/main.c

@@ -98,7 +98,7 @@ void main(void) {
     gfx_TransparentSprite_NoClip(ubuntu_normal, xmin + w * 3 / 2, ymin + h * 3);
     gfx_ConvertToRLETSprite(ubuntu_normal, ubuntu_uninited);
     gfx_RLETSprite_NoClip(ubuntu_uninited, xmin + w * 5 / 2, ymin + h * 3);
-    ubuntu_malloc = gfx_ConvertMallocRLETSprite(ubuntu_normal);
+    ubuntu_malloc = gfx_ConvertMallocRLETSprite(ubuntu_normal); // Same as gfx_ConvertToNewRLETSprite(ubuntu_normal, malloc)
     gfx_RLETSprite_NoClip(ubuntu_malloc, xmin + w * 7 / 2, ymin + h * 3);
 
     /* Wait for a key to be pressed */

examples/gfx_sprite_compress/src/main.c

@@ -20,7 +20,7 @@ void main(void) {
     gfx_sprite_t *apple;
 
     /* Allocate space for the decompressed sprite */
-    apple = gfx_MallocSprite(apple_width, apple_height);
+    apple = gfx_MallocSprite(apple_width, apple_height); // Same as: gfx_AllocSprite(apple_width, apple_height, malloc)
 
     /* Decompress the sprite */
     dzx7_Standard(apple_compressed, apple); // or dzx7_Turbo

examples/gfx_tilemap_compress/src/main.c

@@ -45,7 +45,7 @@ void main(void) {
 
     /* Decompress the tiles */
     for (i = 0; i < sizeof(tileset_tiles)/sizeof(gfx_sprite_t*) ; i++) {
-        tmp_ptr = gfx_MallocSprite(TILE_WIDTH, TILE_HEIGHT);
+        tmp_ptr = gfx_MallocSprite(TILE_WIDTH, TILE_HEIGHT);  // Same as gfx_AllocSprite(TILE_WIDTH, TILE_HEIGHT, malloc)
         dzx7_Turbo(tileset_tiles_compressed[i], tmp_ptr); // or dzx7_Standard, but in this case we have a lot of tiles
         tileset_tiles[i] = tmp_ptr;
     }
@@ -73,7 +73,7 @@ void main(void) {
     gfx_SetPalette(tiles_gfx_pal, sizeof_tiles_gfx_pal, 0);
     gfx_SetColor(gfx_white);
 
-    /* Draw to buffer to avoid tearing */
+    /* Draw to buffer to avoid tearing. Note, this is the same as gfx_SetDraw(gfx_buffer) */
     gfx_SetDrawBuffer();
 
     /* Set monospace font with width of 8 */