Improve PHP doc comments.

diff --git a/lib/tablelib.php b/lib/tablelib.php
index 4fd85b7b58981b1dbc1a8b8f7369d2bf445680a3..01c881fdb5fc5514f9e0e6b9bbeb221fb6d53c9c 100644 (file)
--- a/lib/tablelib.php
+++ b/lib/tablelib.php
@@ -153,9 +153,13 @@ class flexible_table {
     }
 
     /**
-     * Sets the given $column index to true in $this->column_suppress.
-     * @param integer $column
-     * @return void
+     * I think that what this method does is set the column so that if the same data appears in 
+     * consecutive rows, then it is not repeated.
+     * 
+     * For example, in the quiz overview report, the fullname column is set to be suppressed, so
+     * that when one student has made multiple attempts, their name is only printed in the row
+     * for their first attempt.
+     * @param integer $column the index of a column.
      */
     function column_suppress($column) {
         if(isset($this->column_suppress[$column])) {