--- loncom/html/adm/help/tex/Authoring_Structure_Tags.tex 2003/06/10 19:29:26 1.1 +++ loncom/html/adm/help/tex/Authoring_Structure_Tags.tex 2005/02/24 22:34:31 1.2 @@ -4,10 +4,10 @@ These tags give the problem a structure of data and giving the student messages. \begin{itemize} -\item \textbf{problem}\index{problem}: Must be the first tag in the file, -this tag sets up the header of the webpage and generates the submit -buttons, it also handles due dates properly. -\item \textbf{part}\index{part}: Must be below \textbf{problem} if it is +\item \textbf{problem}\index{problem}: This must be the first tag in the file. +This tag sets up the header of the webpage and generates the submit +buttons. It also handles due dates properly. +\item \textbf{part}\index{part}: This must be below \textbf{problem} if it is going to be used. It does many of the same tasks as \textbf{problem}, but allows multiple separate problems to exist in a single file. \item \textbf{startouttext\index{startouttext}} and \textbf{endouttext}\index{endouttext}: @@ -15,8 +15,8 @@ These tags are somewhat special. They mu occur in pairs. Their use is to mark up the problem so the web editor knows what sections should be edited in a plain text block on the web. -\item \textbf{comment}\index{comment}: Allows one to comment out sections +\item \textbf{comment}\index{comment}: This tag allows one to comment out sections of code in a balanced manner, or to provide a comment description -of how a problem works. Only shows up for the edit target, stripped +of how a problem works. It only shows up for the edit target, stripped out for all other targets. \end{itemize}