--- 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	2017/01/19 21:12:45	1.6
@@ -13,6 +13,8 @@ definitions for new tags.
 set to {}``loncapa/perl'' the enclosed data is a Perl script which
 is evaluated inside the Perl safe space. The return value of the script
 is ignored. 
+Without a \textbf{type} attribute or with the \texttt{text/javascript} value,
+the script is considered to be Javascript, and will be executed as such by the web browser.
 \item \textbf{scriptlib}\index{scriptlib}: The enclosed filename contains
 Perl code to run in the safe space.
 \item \textbf{block}\index{block}: This has a required argument \textbf{condition}
@@ -25,9 +27,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 Authoring
+Library Files 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