--- loncom/html/adm/help/tex/Authoring_Library_Scripts.tex	2013/08/14 03:30:50	1.1
+++ loncom/html/adm/help/tex/Authoring_Library_Scripts.tex	2013/08/17 21:25:18	1.2
@@ -114,9 +114,11 @@ hold the all content that would normally
 < /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}