Give the question bank code sensible PHPdocumentor package names.

question/format/blackboard/format.php

@@ -10,7 +10,10 @@
 ////////////////////////////////////////////////////////////////////////////
 
 // Based on default.php, included by ../import.php
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 require_once ("$CFG->libdir/xmlize.php");
 require_once ("$CFG->libdir/tcpdf/html_entity_decode_php4.php");
 

question/format/blackboard_6/format.php

@@ -9,7 +9,10 @@
 ////////////////////////////////////////////////////////////////////////////
 
 // Based on default.php, included by ../import.php
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 require_once ("$CFG->libdir/xmlize.php");
 
 class qformat_blackboard_6 extends qformat_default {

question/format/coursetestmanager/format.php

@@ -6,6 +6,11 @@
 ////////////////////////////////////////////////////////////////////
 
 // Based on format.php, included by ../../import.php
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
+
 require_once($CFG->dirroot.'/lib/uploadlib.php');
 
 class qformat_coursetestmanager extends qformat_default {

question/format/examview/format.php

@@ -1,6 +1,10 @@
 <?php // $Id$
 
 // Based on default.php, included by ../import.php
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 
 require_once("$CFG->libdir/xmlize.php");
 

question/format/gift/format.php

@@ -31,7 +31,10 @@
 // and others. Paul Tsuchido Shew wrote this filter in December 2003.
 //////////////////////////////////////////////////////////////////////////
 // Based on default.php, included by ../import.php
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 class qformat_gift extends qformat_default {
 
     function provide_import() {

question/format/hotpot/format.php

@@ -8,6 +8,10 @@
 ////////////////////////////////////////////////////////////////////////////
 
 // Based on default.php, included by ../import.php
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 
 class qformat_hotpot extends qformat_default {
 

question/format/learnwise/format.php

@@ -5,6 +5,10 @@
 // deductions are currently simply found by dividing the award for the incorrect 
 // answer by the total number of options
 // Based on format.php, included by ../../import.php
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 
 class qformat_learnwise extends qformat_default {
 

question/format/missingword/format.php

@@ -25,7 +25,10 @@
 ////////////////////////////////////////////////////////////////////////////
 
 // Based on format.php, included by ../../import.php
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 class qformat_missingword extends qformat_default {
 
     function provide_import() {

question/format/multianswer/format.php

@@ -8,7 +8,10 @@
 ////////////////////////////////////////////////////////////////////////////
 
 // Based on format.php, included by ../../import.php
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 class qformat_multianswer extends qformat_default {
 
     function provide_import() {

question/format/qti2/custommediafilter.php

@@ -3,7 +3,10 @@
 // note: modified from the original filter/mediaplugin/filter.php
 
 // given a href for a movie or sound file, it returns an appropriate tag
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 function custom_mediaplugin_filter($text, $width = null, $height = null) {
     global $CFG;
     if (is_null($width) || $width == 0) {

question/format/qti2/format.php

@@ -8,7 +8,10 @@ require_once("$CFG->dirroot/question/format/qti2/qt_common.php");
 ////////////////////////////////////////////////////////////////////////////
 
 // Based on format.php, included by ../../import.php
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 define('CLOZE_TRAILING_TEXT_ID', 9999999);
 
 class qformat_qti2 extends qformat_default {

question/format/qti2/qt_common.php

@@ -12,7 +12,9 @@
  * @param int courseid
  * @return array containing filenames
  * @calledfrom type/<typename>/editquestion.php 
- */
+ * @package questionbank
+ * @subpackage importexport
+*/
 function get_course_media_files($courseid) 
 {
 // this code lifted from mod/quiz/question.php and modified

question/format/webct/format.php

@@ -27,6 +27,10 @@
 ///////////////////////////////////////////////////////////////////////////
 
 // Based on format.php, included by ../../import.php
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 
 function unhtmlentities($string){
     $search = array ("'<script[?>]*?>.*?</script>'si",  // remove javascript

question/format/xhtml/format.php

@@ -1,6 +1,9 @@
 <?php 
 // Based on default.php, included by ../import.php
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 class qformat_xhtml extends qformat_default {
 
     function provide_export() {

question/format/xml/format.php

@@ -5,7 +5,10 @@
 //
 //////////////////////////////////////////////////////////////////////////
 // Based on default.php, included by ../import.php
-
+/**
+ * @package questionbank
+ * @subpackage importexport
+ */
 require_once( "$CFG->libdir/xmlize.php" );
 
 class qformat_xml extends qformat_default {

question/type/shortanswer/questiontype.php

@@ -10,6 +10,10 @@
 /// This class contains some special features in order to make the
 /// question type embeddable within a multianswer (cloze) question
 ///
+/**
+* @package questionbank
+* @subpackage questiontypes
+*/
 require_once("$CFG->dirroot/question/type/questiontype.php");
 
 class question_shortanswer_qtype extends default_questiontype {

question/type/truefalse/questiontype.php

@@ -5,6 +5,10 @@
 /////////////////
 
 /// QUESTION TYPE CLASS //////////////////
+/**
+* @package questionbank
+* @subpackage questiontypes
+*/
 class question_truefalse_qtype extends default_questiontype {
 
     function name() {