--- loncom/html/adm/help/tex/Authoring_Scripting_Tags.tex	2005/02/24 22:30:49	1.3
+++ loncom/html/adm/help/tex/Authoring_Scripting_Tags.tex	2013/08/17 21:25:18	1.4
@@ -25,9 +25,17 @@ the tag is skipped if the problem is bef
 \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