MDL-18111 improving file api comments and docs, fixing license header

lib/file/file_exceptions.php

@@ -1,4 +1,28 @@
-<?php  //$Id$
+<?php
+
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+/**
+ * File handling related exceptions.
+ *
+ * @package    moodlecore
+ * @subpackage file
+ * @copyright  2008 Petr Skoda (http://skodak.org)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
 
 /**
  * Basic file related exception class
@@ -10,7 +34,7 @@ function __construct($errorcode, $a=NULL, $debuginfo=null) {
 }
 
 /**
- * Table does not exist problem exception
+ * Can not create file exception
  */
 class stored_file_creation_exception extends file_exception {
     function __construct($contextid, $filearea, $itemid, $filepath, $filename, $debuginfo=null) {
@@ -25,7 +49,7 @@ function __construct($contextid, $filearea, $itemid, $filepath, $filename, $debu
 }
 
 /**
- * Table does not exist problem exception
+ * No file access excetion.
  */
 class file_access_exception extends file_exception {
     function __construct($debuginfo=null) {
@@ -34,7 +58,7 @@ function __construct($debuginfo=null) {
 }
 
 /**
- * Hash file content problem
+ * Hash file content problem exception.
  */
 class file_pool_content_exception extends file_exception {
     function __construct($contenthash, $debuginfo=null) {

lib/filelib.php

@@ -20,8 +20,8 @@
  *
  * @package    moodlecore
  * @subpackage file
- * @license    http://www.gnu.org/copyleft/gpl.html GNU Public License
  * @copyright  1999 onwards Martin Dougiamas (http://dougiamas.com)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  */
 
 /** @var string unique string constant. */

lib/packer/file_archive.php

@@ -1,4 +1,29 @@
-<?php  //$Id$
+<?php
+
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+
+/**
+ * Abstraction of general file archives.
+ *
+ * @package    moodlecore
+ * @subpackage file-packer
+ * @copyright  2008 Petr Skoda (http://skodak.org)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
 
 abstract class file_archive implements Iterator {
 

lib/packer/file_packer.php

@@ -1,4 +1,29 @@
-<?php  //$Id$
+<?php
+
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+
+/**
+ * Abstraction of general file packer.
+ *
+ * @package    moodlecore
+ * @subpackage file-packer
+ * @copyright  2008 Petr Skoda (http://skodak.org)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
 
 /**
  * Abstract class for archiving of files.

lib/packer/zip_archive.php

@@ -1,4 +1,29 @@
-<?php  //$Id$
+<?php
+
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+
+/**
+ * Implementation of zip file archive.
+ *
+ * @package    moodlecore
+ * @subpackage file-packer
+ * @copyright  2008 Petr Skoda (http://skodak.org)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
 
 require_once("$CFG->libdir/packer/file_archive.php");
 

lib/packer/zip_packer.php

@@ -1,4 +1,29 @@
-<?php  //$Id$
+<?php
+
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+
+/**
+ * Implementation of zip packer.
+ *
+ * @package    moodlecore
+ * @subpackage file-packer
+ * @copyright  2008 Petr Skoda (http://skodak.org)
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
 
 require_once("$CFG->libdir/packer/file_packer.php");
 require_once("$CFG->libdir/packer/zip_archive.php");