Added comment to assist debugging.

git-svn-id: https://svn.code.sf.net/p/freertos/code/trunk@719 1d2547de-c912-0410-9cb9-b8ca96c0e9e2

diff --git a/Source/list.c b/Source/list.c
index fe61f05dc2d0979b9b65d6211bf155dd31b41459..5d1fa6dced6fea1f29bcfd52318455e2c007278d 100644 (file)
--- a/Source/list.c
+++ b/Source/list.c
@@ -129,6 +129,22 @@ portTickType xValueOfInsertion;
        }\r
        else\r
        {\r
+               /* *** NOTE ***********************************************************\r
+               If you find your application is crashing here then likely causes are:\r
+                       1) Stack overflow - \r
+                          see http://www.freertos.org/Stacks-and-stack-overflow-checking.html\r
+                       2) Incorrect interrupt priority assignment, especially on Cortex M3 \r
+                          parts where numerically high priority values denote low actual \r
+                          interrupt priories, which can seem counter intuitive.  See \r
+                          configMAX_SYSCALL_INTERRUPT_PRIORITY on http://www.freertos.org/a00110.html\r
+                       3) Calling an API function from within a critical section or when\r
+                          the scheduler is suspended.\r
+                       4) Using a queue or semaphore before it has been initialised or\r
+                          before the scheduler has been started (are interrupts firing\r
+                          before vTaskStartScheduler() has been called?).\r
+               See http://www.freertos.org/FAQHelp.html for more tips. \r
+               **********************************************************************/\r
+               \r
                for( pxIterator = ( xListItem * ) &( pxList->xListEnd ); pxIterator->pxNext->xItemValue <= xValueOfInsertion; pxIterator = pxIterator->pxNext )\r
                {\r
                        /* There is nothing to do here, we are just iterating to the\r