Help files for specifying category within GIFT file. MDL-4163

diff --git a/lang/en_utf8/help/quiz/formatgift.html b/lang/en_utf8/help/quiz/formatgift.html
index 4669d35e3e796169c30be93ed05e96cb04ff4442..f4ce96775c88305252543b69b28b0169f4511231 100644 (file)
--- a/lang/en_utf8/help/quiz/formatgift.html
+++ b/lang/en_utf8/help/quiz/formatgift.html
@@ -214,6 +214,29 @@
      }</pre>
     <p>When the question is processed, the backslash is removed and is not saved in Moodle.</p>
 
+<h3>Specifying Categories</h3>
+
+<p>It is possible to change the category into which the questions are added within the GIFT file. 
+You can change the category as many times as you wish within the file. All questions after the modifier 
+up to the next modifier or the end of the file will be added to the specified category. Up to the first
+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:
+
+<pre>
+$CATEGORY: tom/dick/harry
+</pre>
+
+or simply
+
+<pre>
+$CATEGORY: mycategory
+</pre>
+
+...the first example specifies a path of nested categories. In this cae the questions will go into <i>harry</i>. The 
+categories are created if they do not exist.</p>
+
 <p><u>Other Options:</u><br />
     Short Answer questions can be made case sensitive by changing &quot;0&quot; to &quot;1&quot; in the following line:<br />
     <tt>$question-&gt;usecase = 0;  // Ignore case</tt></p>

diff --git a/lang/en_utf8/help/quiz/importcategory.html b/lang/en_utf8/help/quiz/importcategory.html
new file mode 100644 (file)
index 0000000..542be7a
--- /dev/null
+++ b/lang/en_utf8/help/quiz/importcategory.html
@@ -0,0 +1,14 @@
+<p align="center"><b>Import Category</b></p>
+
+<p>The <b>Category:</b> drop-down is used to select the
+category into which the imported questions
+will go.</p>
+
+<p>Some import formats (GIFT and XML Format) permit the category
+to be specified inside the import file. In order for this to
+happen the <b>from file</b> box must be ticked. If it is not,
+the questions will go into the selected category regardless
+of any instructions in the file.</p>
+
+<p>When categories are specified inside an import file, if they
+do not exist they will be created.</p>