From fce57fd26e20b1ffcccfd2fd4f62a2be0b5be93a Mon Sep 17 00:00:00 2001
From: Marina Glancy <marina@moodle.com>
Date: Tue, 7 Oct 2014 10:06:47 +0800
Subject: [PATCH] MDL-31936 workshop: version bump and @since phpdocs

---
 mod/workshop/lib.php                 | 6 ++++++
 mod/workshop/locallib.php            | 8 ++++++++
 mod/workshop/tests/generator/lib.php | 4 ++++
 mod/workshop/version.php             | 2 +-
 4 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/mod/workshop/lib.php b/mod/workshop/lib.php
index 1fbe1c45234..fda16618e93 100644
--- a/mod/workshop/lib.php
+++ b/mod/workshop/lib.php
@@ -1718,6 +1718,8 @@ function workshop_calendar_update(stdClass $workshop, $cmid) {
 /**
  * Extends the course reset form with workshop specific settings.
  *
+ * @since Moodle 2.6.6, 2.7.3
+ *
  * @param MoodleQuickForm $mform
  */
 function workshop_reset_course_form_definition($mform) {
@@ -1738,6 +1740,8 @@ function workshop_reset_course_form_definition($mform) {
 /**
  * Provides default values for the workshop settings in the course reset form.
  *
+ * @since Moodle 2.6.6, 2.7.3
+ *
  * @param stdClass $course The course to be reset.
  */
 function workshop_reset_course_form_defaults(stdClass $course) {
@@ -1754,6 +1758,8 @@ function workshop_reset_course_form_defaults(stdClass $course) {
 /**
  * Performs the reset of all workshop instances in the course.
  *
+ * @since Moodle 2.6.6, 2.7.3
+ *
  * @param stdClass $data The actual course reset settings.
  * @return array List of results, each being array[(string)component, (string)item, (string)error]
  */
diff --git a/mod/workshop/locallib.php b/mod/workshop/locallib.php
index 1a3a9e703e9..64bd6fb041b 100644
--- a/mod/workshop/locallib.php
+++ b/mod/workshop/locallib.php
@@ -2381,6 +2381,8 @@ class workshop {
     /**
      * Performs the reset of this workshop instance.
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param stdClass $data The actual course reset settings.
      * @return array List of results, each being array[(string)component, (string)item, (string)error]
      */
@@ -2705,6 +2707,8 @@ class workshop {
      * This includes assessments of example submissions as long as they are not
      * referential assessments.
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param stdClass $data The actual course reset settings.
      * @return bool|string True on success, error message otherwise.
      */
@@ -2728,6 +2732,8 @@ class workshop {
     /**
      * Removes all user data related to participants' submissions.
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param stdClass $data The actual course reset settings.
      * @return bool|string True on success, error message otherwise.
      */
@@ -2744,6 +2750,8 @@ class workshop {
 
     /**
      * Hard set the workshop phase to the setup one.
+     *
+     * @since Moodle 2.6.6, 2.7.3
      */
     protected function reset_phase() {
         global $DB;
diff --git a/mod/workshop/tests/generator/lib.php b/mod/workshop/tests/generator/lib.php
index 3774b8c96c9..aa413726823 100644
--- a/mod/workshop/tests/generator/lib.php
+++ b/mod/workshop/tests/generator/lib.php
@@ -101,6 +101,8 @@ class mod_workshop_generator extends testing_module_generator {
     /**
      * Generates a submission authored by the given user.
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param int $workshopid Workshop instance id.
      * @param int $authorid Author user id.
      * @param stdClass|array $options Optional explicit properties.
@@ -132,6 +134,8 @@ class mod_workshop_generator extends testing_module_generator {
     /**
      * Generates an allocation of the given submission for peer-assessment by the given user
      *
+     * @since Moodle 2.6.6, 2.7.3
+     *
      * @param int $submissionid Submission id.
      * @param int $reviewerid Reviewer's user id.
      * @param stdClass|array $options Optional explicit properties.
diff --git a/mod/workshop/version.php b/mod/workshop/version.php
index 1f556c9ea96..b477f2357a8 100644
--- a/mod/workshop/version.php
+++ b/mod/workshop/version.php
@@ -24,7 +24,7 @@
 
 defined('MOODLE_INTERNAL') || die();
 
-$plugin->version   = 2014051200;        // the current module version (YYYYMMDDXX)
+$plugin->version   = 2014051201;        // the current module version (YYYYMMDDXX)
 $plugin->requires  = 2014050800;        // requires this Moodle version
 $plugin->component = 'mod_workshop';    // full name of the plugin (used for diagnostics)
 $plugin->cron      = 60;                // give as a chance every minute