Updated comments; starting to implement priority protection but backed everything out but some changes to comments

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@4510 42af7a65-404d-4744-a932-0658087f49c3

1 files changed, 15 insertions, 6 deletions

diff --git a/nuttx/lib/semaphore/sem_init.c b/nuttx/lib/semaphore/sem_init.c
index f90cc5470..ea1c6e84e 100644
--- a/nuttx/lib/semaphore/sem_init.c
+++ b/nuttx/lib/semaphore/sem_init.c
@@ -1,8 +1,8 @@
 /****************************************************************************
  * lib/sem/sem_init.c
  *
- *   Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Copyright (C) 2007-2009, 2011-2012 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -93,15 +93,24 @@
  *
  ****************************************************************************/
 
-int sem_init (FAR sem_t *sem, int pshared, unsigned int value)
+int sem_init(FAR sem_t *sem, int pshared, unsigned int value)
 {
+  /* Verify that a semaphore was provided and the count is within the valid
+   * range.
+   */
+
   if (sem && value <= SEM_VALUE_MAX)
     {
+      /* Initialize the seamphore count */
+
       sem->semcount     = (int16_t)value;
+
+      /* Initialize to support priority inheritance */
+
 #ifdef CONFIG_PRIORITY_INHERITANCE
-#if CONFIG_SEM_PREALLOCHOLDERS > 0
+#  if CONFIG_SEM_PREALLOCHOLDERS > 0
       sem->hlist.flink  = NULL;
-#endif
+#  endif
       sem->hlist.holder = NULL;
       sem->hlist.counts = 0;
 #endif
@@ -110,6 +119,6 @@ int sem_init (FAR sem_t *sem, int pshared, unsigned int value)
   else
     {
       set_errno(EINVAL);
-	  return ERROR;
+      return ERROR;
     }
 }