[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Authoring_Library_Scripts.tex Authoring_Scripting_Tags.tex

[lira]

lira		Sat Aug 17 21:25:18 2013 EDT

  Modified files:              
    /loncom/html/adm/help/tex	Authoring_Library_Scripts.tex 
                             	Authoring_Scripting_Tags.tex 
  Log:
  adding more details on randmonlist
  
  
Index: loncom/html/adm/help/tex/Authoring_Library_Scripts.tex
diff -u loncom/html/adm/help/tex/Authoring_Library_Scripts.tex:1.1 loncom/html/adm/help/tex/Authoring_Library_Scripts.tex:1.2
--- loncom/html/adm/help/tex/Authoring_Library_Scripts.tex:1.1	Wed Aug 14 03:30:50 2013
+++ loncom/html/adm/help/tex/Authoring_Library_Scripts.tex	Sat Aug 17 21:25:18 2013
@@ -114,9 +114,11 @@
 < /part>
 \end{verbatim}
 
-Note: when using $<$randomlist$>$, always put the randomlist tag \textit{inside}
-the $<$part$>$ tag. If multiple $<$part$>$ tags are inside a $<$randomlist$>$, then
-the grading and course management will be more difficult.
+Note: when using $<$randomlist$>$ as shown above, all students will work
+every part of the problem, but the actual problem statements will be different. Another
+option is to wrap multiple $<$part$>$ tags but then not all students will work
+all parts unless the value of `show' equals the total parts wrapped. For more
+information see section \ref{Authoring_Scripting_Tags}.
 
 \null 
 \noindent \textbf{Viewing the text contents of a library script block}
Index: loncom/html/adm/help/tex/Authoring_Scripting_Tags.tex
diff -u loncom/html/adm/help/tex/Authoring_Scripting_Tags.tex:1.3 loncom/html/adm/help/tex/Authoring_Scripting_Tags.tex:1.4
--- loncom/html/adm/help/tex/Authoring_Scripting_Tags.tex:1.3	Thu Feb 24 22:30:49 2005
+++ loncom/html/adm/help/tex/Authoring_Scripting_Tags.tex	Sat Aug 17 21:25:18 2013
@@ -25,9 +25,17 @@
 \item \textbf{preduedate}\index{preduedate}: Everything inside the tag
 is skipped if the problem is after the due date. 
 \item \textbf{randomlist}\index{randomlist}: The enclosed tags are parsed
-in a stable random order. The optional attribute \textbf{show} restricts
+in a stable random order. The optional attribute \textbf{show=``N''} restricts
 the number of tags inside that are actually parsed to no more than
-\textbf{show}.
+\textbf{N}. N can equal the total tags inside. The randomlist tag can be used to randomize problem 
+parts by wrapping the $<$part$>$ tags with a randomlist tag. 
+\index{randomizing parts}Note that when randomlist wraps $<$part$>$ tags, that all
+students will work all parts only if \textbf{show=``N''} where N is the total number
+of parts wrapped. When N is less than the total number of parts wrapped, 
+there will be gaps in the assessment chart, and also in the table
+of submissions for each student, corresponding to those parts which are
+never available to that particular student. For more examples see section 
+\ref{Authoring_Library_Scripts}.
 \item \textbf{solved}\index{solved}: Everything inside the tag is skipped
 if the problem is {}``not solved''.
 \item \textbf{while}\index{while}: This implements a while loop. The required