|
[
Permalink
| « Hide
]
Penny Leach added a comment - 08/Sep/08 07:11 PM
starting point: http://paste.dollyfish.net.nz/92a184
For phpdoc, use a short description and a long description.
<?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/>. /** * This is a one-line short description of the file * * You can have a rather longer description of the file as well, * if you like, and it can span multiple lines. * * @package moodlecore * @copyright 2008 Kim Bloggs * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ See also: http://docs.moodle.org/en/Development:Coding_style#Files BTW... have we already switched to GPL v3? I really didn't know! Shouldn't it include also MD global copyright, perhaps below the "This file is part of Moodle - http://moodle.org/
Ciao We hadn't switched to GPL v3 yet, but it's been discussed a long time ago and now is a good time to do it.
http://www.gnu.org/licenses/quick-guide-gplv3.html About my "global" copyright I think it just confuses things to have two copyrights on every file. As long as there is one person and it's GPL then it's good for us all. It's good to have lots of different people owning lots of different files (because the chances of Moodle ever leaving GPL become close to zero). Closing as dupe of MDL-19235
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||