[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Author_LON-CAPA_Introduction.tex
lira
lira at source.lon-capa.org
Sat Aug 17 21:37:44 EDT 2013
lira Sun Aug 18 01:37:44 2013 EDT
Modified files:
/loncom/html/adm/help/tex Author_LON-CAPA_Introduction.tex
Log:
clarifying xml comments appear in html source
Index: loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex
diff -u loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex:1.6 loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex:1.7
--- loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex:1.6 Wed Aug 14 03:33:06 2013
+++ loncom/html/adm/help/tex/Author_LON-CAPA_Introduction.tex Sun Aug 18 01:37:44 2013
@@ -55,5 +55,9 @@
Commenting you xml and scripts is important for both you and other users. Commenting within a loncapa/perl script
is denoted with a \#. This can be entered anwhere in a line and the remainder of the line will be ignored when
-parsing. Problems are coded in xml. Comments in xml are of the format \texttt{<!-- comment -->}.\index{comment markers}
+parsing. Problems are coded in xml. Comments in xml are of the format \texttt{<!-- comment -->}.
+\index{comment markers}However, it is important to know that the XML comments
+propagate through to the rendered web page viewed by students while the perl comments
+within the script are not. Hence, writing solution hints within XML comments is
+discouraged for obvious reasons.
More information about the LON-CAPA-cvs
mailing list