glsl/list: Note that exec_lists may not be realloc'd.
authorMatt Turner <mattst88@gmail.com>
Tue, 3 Feb 2015 01:23:25 +0000 (17:23 -0800)
committerMatt Turner <mattst88@gmail.com>
Tue, 3 Feb 2015 20:25:14 +0000 (12:25 -0800)
Reviewed-by: Kenneth Graunke <kenneth@whitecape.org>
src/glsl/list.h

index 85368a4e6c45784d37d3e4177f38f8fedd5e6b1e..ddb98f76f67f76364b252ed809de1c2fd07ba701 100644 (file)
  * Therefore, if \c head->next is \c NULL or \c tail_prev->prev is \c NULL,
  * the list is empty.
  *
+ * Do note that this means that the list nodes will contain pointers into the
+ * list structure itself and as a result you may not \c realloc() an  \c
+ * exec_list or any structure in which an \c exec_list is embedded.
+ *
  * To anyone familiar with "exec lists" on the Amiga, this structure should
  * be immediately recognizable.  See the following link for the original Amiga
  * operating system documentation on the subject.