From 953c76d6217af928a956388c58a40b1ae756bc39 Mon Sep 17 00:00:00 2001
From: thepurpleblob <thepurpleblob>
Date: Fri, 1 Dec 2006 16:21:29 +0000
Subject: [PATCH] Added or improved help re. category switching in import files

---
 lang/en_utf8/help/quiz/formatgift.html |  2 +-
 lang/en_utf8/help/quiz/formatxml.html  | 19 +++++++++++++++++++
 lang/en_utf8/help/quiz/import.html     |  1 +
 3 files changed, 21 insertions(+), 1 deletion(-)
 create mode 100644 lang/en_utf8/help/quiz/formatxml.html

diff --git a/lang/en_utf8/help/quiz/formatgift.html b/lang/en_utf8/help/quiz/formatgift.html
index f4ce96775c..3b566cc144 100644
--- a/lang/en_utf8/help/quiz/formatgift.html
+++ b/lang/en_utf8/help/quiz/formatgift.html
@@ -222,7 +222,7 @@ up to the next modifier or the end of the file will be added to the specified ca
 category modifier the category specified on the import screen will be used. Note that for this to work
 the <b>from file:</b> box must be ticked on the import screen.</p>
 
-<p>To include a category modifier include a line like this:
+<p>To include a category modifier include a line like this (with a blank line before and after):
 
 <pre>
 $CATEGORY: tom/dick/harry
diff --git a/lang/en_utf8/help/quiz/formatxml.html b/lang/en_utf8/help/quiz/formatxml.html
new file mode 100644
index 0000000000..e609c0781f
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formatxml.html
@@ -0,0 +1,19 @@
+<p align="center"><b>Importing "Moodle XML" format files</b></p>
+
+<h3>Category Switching</h3>
+<p>You can insert a special dummy question into the XML file to specify
+the category path into which the following questions will be inserted.
+If the category or categories do not exist they will be created. Note that
+the <b>from file:</b> option must be ticked on the option page or this code
+will be ignored completely. You can switch categories in the xml file as often as you
+wish.</p>
+
+<p>An example of the format is as follows:</p>
+
+<pre>
+&lt;question type="category"&gt;
+    &lt;category&gt;
+        tom/dick/harry
+    &lt;/category&gt;
+&lt;/question&gt;
+</pre>
diff --git a/lang/en_utf8/help/quiz/import.html b/lang/en_utf8/help/quiz/import.html
index 9773cdd5a7..46b6420985 100644
--- a/lang/en_utf8/help/quiz/import.html
+++ b/lang/en_utf8/help/quiz/import.html
@@ -166,6 +166,7 @@ exported in the same format. The format is straightforward and is best demonstra
 by exporting a category in the Moodle XML format. The XML format is capabable of 
 importing image files.
 </p>
+<p align="right"><a href="help.php?file=formatxml.html&module=quiz">More info about the "Moodle XML" format</a></p>
 </ul>
 
 <p>More formats are yet to come, including WebCT, IMS QTI and whatever else
-- 
2.39.5