Index: trunk/MagicSoft/Mars/datacenter/scripts/runstar
===================================================================
--- trunk/MagicSoft/Mars/datacenter/scripts/runstar	(revision 7426)
+++ trunk/MagicSoft/Mars/datacenter/scripts/runstar	(revision 7460)
@@ -20,9 +20,19 @@
 #   Author(s): Daniela Dorner  08/2004 <mailto:dorner@astro.uni-wuerzburg.de>
 #
-#   Copyright: MAGIC Software Development, 2000-2004
+#   Copyright: MAGIC Software Development, 2000-2006
 #
 #
 # ========================================================================
 #
+# This script is launching star for sequence.
+# 
+# In the case of star only one sequence is processed. Despite of 
+# that the structure of the script is such, that also more sequences could
+# be processed. The restriction to one sequence has been made, as star
+# takes some time. There's one todo file per sequence. 
+# First the script searches for a todo file. Then star is run for the 
+# sequence from this todo file. 
+#
+# the star.rc files are taken from the mars directory
 #
 
@@ -53,4 +63,5 @@
 cd $mars
 
+# check if getting of list is already running
 date > $lockpath/lock-getting-star-list.txt >> $scriptlog 2>&1
 checklock0=$?
@@ -64,4 +75,5 @@
 esac
 
+# finding todo file
 echo "checking if other todo-files are there" >> $scriptlog 2>&1
 if  ls $todofile-[1-9]*.txt >> $scriptlog 2>&1
@@ -81,9 +93,8 @@
 rm -v $lockpath/lock-getting-star-list.txt >> $scriptlog 2>&1
 
+# choosing todo file
 nr=bla
 echo "finding the right todo-file" >> $scriptlog 2>&1
 todofiles=`ls $listpath/ToDo-$table-$column-*`
-
-#echo "todofiles: "${todofiles[@]} >> $scriptlog 2>&1
 
 for todofile in ${todofiles[@]}
@@ -114,6 +125,6 @@
 
 
+# retrieve sequence from todo file
 sequences=(`cat $todofile`)
-
 if [ "$sequences" = "" ]
 then 
@@ -125,6 +136,6 @@
 fi
 
+# run star for sequence
 echo "sequences: "${sequences[@]} >> $scriptlog 2>&1
-
 for sequence in ${sequences[@]}
 do